diff --git a/third_party/googleapis/.bazelrc b/third_party/googleapis/.bazelrc index bd7573426..db6c4f65e 100644 --- a/third_party/googleapis/.bazelrc +++ b/third_party/googleapis/.bazelrc @@ -1,2 +1,7 @@ # To make proto_library rules to include source info in the descriptor build --protocopt=--include_source_info + +# This is to avoid JVM SIGBUS crashes on highly parallel builds, +# see https://github.com/bazelbuild/bazel/issues/3236 for more details +build --enable_platform_specific_config +build:linux --sandbox_tmpfs_path=/tmp \ No newline at end of file diff --git a/third_party/googleapis/.circleci/config.yml b/third_party/googleapis/.circleci/config.yml index 2ea704fc3..a17328bfd 100644 --- a/third_party/googleapis/.circleci/config.yml +++ b/third_party/googleapis/.circleci/config.yml @@ -24,12 +24,18 @@ jobs: mkdir /tmp/reports export RUNNING_IN_ARTMAN_DOCKER=True smoketest_artman.py --root-dir=/var/code/googleapis/ --log=/tmp/reports/smoketest.log + - run: + name: Archive artifacts + command: | + mkdir /var/code/googleapis-tgz + tar cfz /var/code/googleapis-tgz/googleapis.tar.gz /var/code/googleapis + when: always - store_test_results: path: /tmp/reports - store_artifacts: path: /tmp/reports - store_artifacts: - path: /var/code/googleapis + path: /var/code/googleapis-tgz working_directory: /var/code/googleapis/ workflows: @@ -39,4 +45,5 @@ workflows: - smoke-all: filters: branches: - only: master + only: + - master diff --git a/third_party/googleapis/.kokoro/.bazelrc b/third_party/googleapis/.kokoro/.bazelrc new file mode 100644 index 000000000..37ad7713a --- /dev/null +++ b/third_party/googleapis/.kokoro/.bazelrc @@ -0,0 +1,2 @@ +build --extra_toolchains=@gapic_generator_python//:pyenv3_toolchain --define=gapic_gen_python=3.6 +test --extra_toolchains=@gapic_generator_python//:pyenv3_toolchain --define=gapic_gen_python=3.6 diff --git a/third_party/googleapis/.kokoro/build.sh b/third_party/googleapis/.kokoro/build.sh new file mode 100755 index 000000000..fe41332f4 --- /dev/null +++ b/third_party/googleapis/.kokoro/build.sh @@ -0,0 +1,15 @@ +#!/bin/bash + +set -e + +cd ${KOKORO_ARTIFACTS_DIR}/github/googleapis +cp .kokoro/.bazelrc $HOME/.bazelrc + +# shellcheck source=/dev/null +source .kokoro/setup.sh + +# +# Run build and tests +# +${BAZEL} --output_user_root=${BAZEL_ROOT} build --keep_going //... +${BAZEL} --output_user_root=${BAZEL_ROOT} test --flaky_test_attempts=3 --keep_going //... diff --git a/third_party/googleapis/.kokoro/continuous.cfg b/third_party/googleapis/.kokoro/continuous.cfg new file mode 100644 index 000000000..19a1c5163 --- /dev/null +++ b/third_party/googleapis/.kokoro/continuous.cfg @@ -0,0 +1,3 @@ +# Format: //devtools/kokoro/config/proto/build.proto + +build_file: "googleapis/.kokoro/build.sh" diff --git a/third_party/googleapis/.kokoro/presubmit.cfg b/third_party/googleapis/.kokoro/presubmit.cfg new file mode 100644 index 000000000..19a1c5163 --- /dev/null +++ b/third_party/googleapis/.kokoro/presubmit.cfg @@ -0,0 +1,3 @@ +# Format: //devtools/kokoro/config/proto/build.proto + +build_file: "googleapis/.kokoro/build.sh" diff --git a/third_party/googleapis/.kokoro/setup.sh b/third_party/googleapis/.kokoro/setup.sh new file mode 100644 index 000000000..26607b4f3 --- /dev/null +++ b/third_party/googleapis/.kokoro/setup.sh @@ -0,0 +1,19 @@ +#!/bin/bash + +set -e + +# +# Install bazel +# +mkdir ${KOKORO_ROOT}/tools +cd ${KOKORO_ROOT}/tools +curl -L https://github.com/bazelbuild/bazel/releases/download/3.0.0/bazel-3.0.0-linux-x86_64 -o bazel +chmod +x bazel +mkdir bazel_root +cd - + +# gapic-generator-python requires python 3.6+ +pyenv global 3.6.1 + +BAZEL=${KOKORO_ROOT}/tools/bazel +BAZEL_ROOT=${KOKORO_ROOT}/tools/bazel_root diff --git a/third_party/googleapis/BUILD.bazel b/third_party/googleapis/BUILD.bazel index c93a75378..1bc525514 100644 --- a/third_party/googleapis/BUILD.bazel +++ b/third_party/googleapis/BUILD.bazel @@ -1,129 +1,6 @@ load("@bazel_tools//tools/build_defs/pkg:pkg.bzl", "pkg_tar") -# Target used by Cloud Build to build GAPIC libraries. -# To find all available rules, use: -# $ grep -Er '\-(java|go|php)"' -pkg_tar( - name = 'gapic-cloud-build', - deps = [ - '//google/api/expr/v1alpha1:gapi-cloud-cel-v1alpha1-go', - '//google/api/expr/v1alpha1:google-cloud-cel-v1alpha1-java', - '//google/bigtable/admin/v2:gapi-cloud-bigtableadmin-v2-go', - '//google/bigtable/admin/v2:google-cloud-bigtable-admin-v2-java', - '//google/bigtable/v2:gapi-cloud-bigtable-v2-go', - '//google/bigtable/v2:google-cloud-bigtable-v2-java', - '//google/cloud/asset/v1beta1:gapi-cloud-asset-v1beta1-go', - '//google/cloud/asset/v1beta1:google-cloud-asset-v1beta1-java', - '//google/cloud/automl/v1beta1:gapi-cloud-automl-v1beta1-go', - '//google/cloud/automl/v1beta1:google-cloud-automl-v1beta1-java', - '//google/cloud/bigquery/datatransfer/v1:gapi-cloud-bigquerydatatransfer-v1-go', - '//google/cloud/bigquery/datatransfer/v1:google-cloud-bigquerydatatransfer-v1-java', - '//google/cloud/bigquery/storage/v1beta1:gapi-cloud-bigquerystorage-v1-go', - '//google/cloud/bigquery/storage/v1beta1:google-cloud-bigquerystorage-v1-java', - '//google/cloud/dataproc/v1beta2:gapi-cloud-dataproc-v1beta2-go', - '//google/cloud/dataproc/v1beta2:google-cloud-dataproc-v1beta2-java', - '//google/cloud/dataproc/v1:gapi-cloud-dataproc-v1-go', - '//google/cloud/dataproc/v1:google-cloud-dataproc-v1-java', - '//google/cloud/dialogflow/v2beta1:gapi-cloud-dialogflow-v2beta1-go', - '//google/cloud/dialogflow/v2beta1:google-cloud-dialogflow-v2beta1-java', - '//google/cloud/dialogflow/v2:gapi-cloud-dialogflow-v2-go', - '//google/cloud/dialogflow/v2:google-cloud-dialogflow-v2-java', - '//google/cloud/dialogflow/v2:google-cloud-dialogflow-v2-php', - '//google/cloud/iot/v1:gapi-cloud-iot-v1-go', - '//google/cloud/iot/v1:google-cloud-iot-v1-java', - '//google/cloud/kms/v1:gapi-cloud-kms-v1-go', - '//google/cloud/kms/v1:google-cloud-kms-v1-java', - '//google/cloud/language/v1beta2:gapi-cloud-language-v1beta2-go', - '//google/cloud/language/v1beta2:google-cloud-language-v1beta2-java', - '//google/cloud/language/v1:gapi-cloud-language-v1-go', - '//google/cloud/language/v1:google-cloud-language-v1-java', - '//google/cloud/language/v1:google-cloud-language-v1-php', - '//google/cloud/oslogin/v1beta:gapi-cloud-oslogin-v1beta-go', - '//google/cloud/oslogin/v1beta:google-cloud-oslogin-v1beta-java', - '//google/cloud/oslogin/v1:gapi-cloud-oslogin-v1-go', - '//google/cloud/oslogin/v1:google-cloud-oslogin-v1-java', - '//google/cloud/redis/v1beta1:gapi-cloud-redis-v1beta1-go', - '//google/cloud/redis/v1beta1:google-cloud-redis-v1beta1-java', - '//google/cloud/redis/v1:gapi-cloud-redis-v1-go', - '//google/cloud/redis/v1:google-cloud-redis-v1-java', - '//google/cloud/scheduler/v1beta1:gapi-cloud-scheduler-v1beta1-go', - '//google/cloud/scheduler/v1beta1:google-cloud-scheduler-v1beta1-java', - '//google/cloud/securitycenter/v1beta1:gapi-cloud-securitycenter-v1beta1-go', - '//google/cloud/securitycenter/v1beta1:google-cloud-securitycenter-v1beta1-java', - '//google/cloud/speech/v1:gapi-cloud-speech-v1-go', - '//google/cloud/speech/v1:google-cloud-speech-v1-java', - '//google/cloud/speech/v1p1beta1:gapi-cloud-speech-v1p1beta1-go', - '//google/cloud/speech/v1p1beta1:google-cloud-speech-v1p1beta1-java', - '//google/cloud/tasks/v2beta2:gapi-cloud-tasks-v2beta2-go', - '//google/cloud/tasks/v2beta2:google-cloud-tasks-v2beta2-java', - '//google/cloud/tasks/v2beta3:gapi-cloud-tasks-v2beta3-go', - '//google/cloud/tasks/v2beta3:google-cloud-tasks-v2beta3-java', - '//google/cloud/texttospeech/v1beta1:gapi-cloud-texttospeech-v1beta1-go', - '//google/cloud/texttospeech/v1beta1:google-cloud-texttospeech-v1beta1-java', - '//google/cloud/texttospeech/v1:gapi-cloud-texttospeech-v1-go', - '//google/cloud/texttospeech/v1:google-cloud-texttospeech-v1-java', - '//google/cloud/videointelligence/v1beta1:gapi-cloud-video-intelligence-v1beta1-go', - '//google/cloud/videointelligence/v1beta1:google-cloud-video-intelligence-v1beta1-java', - '//google/cloud/videointelligence/v1beta2:gapi-cloud-video-intelligence-v1beta2-go', - '//google/cloud/videointelligence/v1beta2:google-cloud-video-intelligence-v1beta2-java', - '//google/cloud/videointelligence/v1:gapi-cloud-video-intelligence-v1-go', - '//google/cloud/videointelligence/v1:google-cloud-video-intelligence-v1-java', - '//google/cloud/videointelligence/v1p1beta1:gapi-cloud-video-intelligence-v1p1beta1-go', - '//google/cloud/videointelligence/v1p1beta1:google-cloud-video-intelligence-v1p1beta1-java', - '//google/cloud/videointelligence/v1p2beta1:gapi-cloud-video-intelligence-v1p2beta1-go', - '//google/cloud/videointelligence/v1p2beta1:google-cloud-video-intelligence-v1p2beta1-java', - '//google/cloud/videointelligence/v1p3beta1:gapi-cloud-video-intelligence-v1p3beta1-go', - '//google/cloud/vision/v1:gapi-cloud-vision-v1-go', - '//google/cloud/vision/v1:google-cloud-vision-v1-java', - '//google/cloud/vision/v1p1beta1:gapi-cloud-vision-v1p1beta1-go', - '//google/cloud/vision/v1p1beta1:google-cloud-vision-v1p1beta1-java', - '//google/cloud/vision/v1p2beta1:gapi-cloud-vision-v1p2beta1-go', - '//google/cloud/vision/v1p2beta1:google-cloud-vision-v1p2beta1-java', - '//google/cloud/vision/v1p3beta1:gapi-cloud-vision-v1p3beta1-go', - '//google/cloud/vision/v1p3beta1:google-cloud-vision-v1p3beta1-java', - '//google/cloud/vision/v1p4beta1:gapi-cloud-vision-v1p4beta1-go', - '//google/cloud/vision/v1p4beta1:google-cloud-vision-v1p4beta1-java', - '//google/cloud/websecurityscanner/v1alpha:gapi-cloud-websecurityscanner-v1alpha-go', - '//google/cloud/websecurityscanner/v1alpha:google-cloud-websecurityscanner-v1alpha-java', - '//google/container/v1:gapi-cloud-container-v1-go', - '//google/container/v1:google-cloud-container-v1-java', - '//google/datastore/v1:gapi-cloud-datastore-v1-go', - '//google/datastore/v1:google-cloud-datastore-v1-java', - '//google/devtools/clouddebugger/v2:gapi-cloud-debugger-v2-go', - '//google/devtools/clouddebugger/v2:google-cloud-debugger-v2-java', - '//google/devtools/clouderrorreporting/v1beta1:gapi-cloud-error-reporting-v1beta1-go', - '//google/devtools/clouderrorreporting/v1beta1:google-cloud-error-reporting-v1beta1-java', - '//google/devtools/cloudtrace/v1:gapi-cloud-trace-v1-go', - '//google/devtools/cloudtrace/v1:google-cloud-trace-v1-java', - '//google/devtools/cloudtrace/v2:gapi-cloud-trace-v2-go', - '//google/devtools/cloudtrace/v2:google-cloud-trace-v2-java', - '//google/devtools/containeranalysis/v1beta1:gapi-cloud-containeranalysis-v1-go', - '//google/devtools/containeranalysis/v1beta1:google-cloud-containeranalysis-v1-java', - '//google/devtools/source/v1:gapi-cloud-source-v1-go', - '//google/example/library/v1:gapi-cloud-library-v1-go', - '//google/example/library/v1:google-cloud-library-v1-java', - '//google/firestore/v1beta1:gapi-cloud-firestore-v1beta1-go', - '//google/firestore/v1beta1:google-cloud-firestore-v1beta1-java', - '//google/iam/admin/v1:gapi-cloud-iam-admin-v1-go', - '//google/iam/credentials/v1:gapi-cloud-iamcredentials-v1-go', - '//google/iam/credentials/v1:google-cloud-iamcredentials-v1-java', - '//google/iam/v1:gapi-cloud-iam-v1-go', - '//google/iam/v1/logging:gapi-cloud-iam-admin-go', - '//google/logging/v2:gapi-cloud-logging-v2-go', - '//google/logging/v2:google-cloud-logging-v2-java', - '//google/longrunning:gapi-cloud-longrunning-go', - '//google/monitoring/v3:gapi-cloud-monitoring-v3-go', - '//google/monitoring/v3:google-cloud-monitoring-v3-java', - '//google/privacy/dlp/v2:gapi-cloud-dlp-v2-go', - '//google/privacy/dlp/v2:google-cloud-dlp-v2-java', - '//google/pubsub/v1:gapi-cloud-pubsub-v1-go', - '//google/pubsub/v1:google-cloud-pubsub-v1-java', - '//google/pubsub/v1:google-cloud-pubsub-v1-php', - '//google/spanner/admin/database/v1:gapi-cloud-spanner-admin-database-v1-go', - '//google/spanner/admin/database/v1:google-cloud-spanner-admin-database-v1-java', - '//google/spanner/admin/instance/v1:gapi-cloud-spanner-admin-instance-v1-go', - '//google/spanner/admin/instance/v1:google-cloud-spanner-admin-instance-v1-java', - '//google/spanner/v1:gapi-cloud-spanner-v1-go', - '//google/spanner/v1:google-cloud-spanner-v1-java', - ] +alias( + name = "build_gen", + actual = "@com_google_api_codegen//rules_gapic/bazel:build_file_generator", ) diff --git a/third_party/googleapis/README.md b/third_party/googleapis/README.md index 3e5a4cdd7..6ba73116d 100644 --- a/third_party/googleapis/README.md +++ b/third_party/googleapis/README.md @@ -11,7 +11,7 @@ libraries, documentation, and other artifacts. ### Bazel The recommended way to build the API client libraries is through -[Bazel](https://bazel.build/) >= 0.23.0. +[Bazel](https://bazel.build/) >= 2.0.0. First, [install bazel](https://docs.bazel.build/versions/master/install.html). @@ -39,7 +39,7 @@ To build the Java package for one library: bazel build //google/example/library/v1:google-cloud-library-v1-java ``` -Bazel packages exist in all the libraries for Java and Go. +Bazel packages exist in all the libraries for Java, Go, Python, Ruby, Node.js, PHP and C#. ### Artman diff --git a/third_party/googleapis/WORKSPACE b/third_party/googleapis/WORKSPACE index d4239160d..a5387b785 100644 --- a/third_party/googleapis/WORKSPACE +++ b/third_party/googleapis/WORKSPACE @@ -11,39 +11,127 @@ load("//:repository_rules.bzl", "switched_rules_by_language") switched_rules_by_language( name = "com_google_googleapis_imports", cc = True, + csharp = True, gapic = True, go = True, grpc = True, java = True, nodejs = True, php = True, + python = True, + ruby = True, ) +# Protobuf depends on very old version of bazel_skylib (forward compatible with the new one). +# Importing older version of bazel_skylib first (this is one of the things that protobuf_deps() call +# below will do) breaks the grpc repositories, so importing the proper version explicitly before +# everything else. +http_archive( + name = "bazel_skylib", + urls = ["https://github.com/bazelbuild/bazel-skylib/releases/download/0.9.0/bazel_skylib-0.9.0.tar.gz"], +) + +# Python rules should go early in the dependencies list, otherwise a wrong +# version of the library will be selected as a transitive dependency of gRPC. +http_archive( + name = "rules_python", + url = "https://github.com/bazelbuild/rules_python/archive/748aa53d7701e71101dfd15d800e100f6ff8e5d1.zip", + strip_prefix = "rules_python-748aa53d7701e71101dfd15d800e100f6ff8e5d1" +) + +http_archive( + name = "com_google_protobuf", + strip_prefix = "protobuf-fe1790ca0df67173702f70d5646b82f48f412b99", # this is 3.11.2 + urls = ["https://github.com/protocolbuffers/protobuf/archive/fe1790ca0df67173702f70d5646b82f48f412b99.zip"], +) + +load("@com_google_protobuf//:protobuf_deps.bzl", "protobuf_deps") + +protobuf_deps() + +http_archive( + name = "rules_proto", + sha256 = "602e7161d9195e50246177e7c55b2f39950a9cf7366f74ed5f22fd45750cd208", + strip_prefix = "rules_proto-97d8af4dc474595af3900dd85cb3a29ad28cc313", + urls = [ + "https://mirror.bazel.build/github.com/bazelbuild/rules_proto/archive/97d8af4dc474595af3900dd85cb3a29ad28cc313.tar.gz", + "https://github.com/bazelbuild/rules_proto/archive/97d8af4dc474595af3900dd85cb3a29ad28cc313.tar.gz", + ], +) + +load("@rules_proto//proto:repositories.bzl", "rules_proto_dependencies", "rules_proto_toolchains") + +rules_proto_dependencies() + +rules_proto_toolchains() + # Note gapic-generator contains java-specific and common code, that is why it is imported in common # section http_archive( name = "com_google_api_codegen", - strip_prefix = "gapic-generator-c075bbe8eff3a1094a03cd77474d8dbcb010f954", - urls = ["https://github.com/googleapis/gapic-generator/archive/c075bbe8eff3a1094a03cd77474d8dbcb010f954.zip"], + strip_prefix = "gapic-generator-acd31461ee04391df79ae8a33f793569791aa1a0", + urls = ["https://github.com/googleapis/gapic-generator/archive/acd31461ee04391df79ae8a33f793569791aa1a0.zip"], +) + +# rules_go (support Golang under bazel) +# This is not in the Go section because we override the same, older dependency brought in by gRPC. +# TODO(ndietz): move this back to the Go section if gRPC is updated per https://github.com/grpc/grpc/issues/22172 +http_archive( + name = "io_bazel_rules_go", + sha256 = "e6a6c016b0663e06fa5fccf1cd8152eab8aa8180c583ec20c872f4f9953a7ac5", + url = "https://github.com/bazelbuild/rules_go/releases/download/v0.22.1/rules_go-v0.22.1.tar.gz", ) +load("@io_bazel_rules_go//go:deps.bzl", "go_register_toolchains", "go_rules_dependencies") + +go_rules_dependencies() + +go_register_toolchains() + ############################################################################## -# Java +# C++ ############################################################################## - -# java_gapic artifacts runtime dependencies (gax-java) -# -# Keeping it here to see how this goes (what will be more maintainable: direct import of gax or via -# gapic-generator). +# C++ must go before everything else, since the key dependencies (protobuf and gRPC) +# are C++ repositories and they have the highest chance to have the correct versions of the +# transitive dependencies (for those dependencies which are shared by many other repositories +# imported in this workspace). # -#load("@com_google_api_codegen//rules_gapic/java:java_gapic_repositories.bzl", "java_gapic_repositories") -# -#java_gapic_repositories() +# Note, even though protobuf and gRPC are mostly written in C++, they are used to generate stuff +# for most of the other languages as well, so they can be considered as the core cross-language +# dependencies. + +http_archive( + name = "com_github_grpc_grpc", + strip_prefix = "grpc-8347f4753568b5b66e49111c60ae2841278d3f33", # this is 1.25.0 with fixes + urls = ["https://github.com/grpc/grpc/archive/8347f4753568b5b66e49111c60ae2841278d3f33.zip"], +) + +load("@com_github_grpc_grpc//bazel:grpc_deps.bzl", "grpc_deps") + +grpc_deps() + +load("@upb//bazel:repository_defs.bzl", "bazel_version_repository") + +bazel_version_repository( + name = "bazel_version", +) + +load("@build_bazel_rules_apple//apple:repositories.bzl", "apple_rules_dependencies") + +apple_rules_dependencies() + +load("@build_bazel_apple_support//lib:repositories.bzl", "apple_support_dependencies") + +apple_support_dependencies() + +############################################################################## +# Java +############################################################################## http_archive( name = "com_google_api_gax_java", - strip_prefix = "gax-java-6b170195c18e0d8abc8385ef063d6da9773f87de", - urls = ["https://github.com/googleapis/gax-java/archive/6b170195c18e0d8abc8385ef063d6da9773f87de.zip"], + strip_prefix = "gax-java-730046855da122b26adbaa3fcf535becd8afa292", # 1.55.0 with fixes + urls = ["https://github.com/googleapis/gax-java/archive/730046855da122b26adbaa3fcf535becd8afa292.zip"], ) load("@com_google_api_gax_java//:repository_rules.bzl", "com_google_api_gax_java_properties") @@ -57,6 +145,10 @@ load("@com_google_api_gax_java//:repositories.bzl", "com_google_api_gax_java_rep com_google_api_gax_java_repositories() +load("@io_grpc_grpc_java//:repositories.bzl", "grpc_java_repositories") + +grpc_java_repositories() + # gapic-generator transitive # (goes AFTER java-gax, since both java gax and gapic-generator are written in java and may conflict) load("@com_google_api_codegen//:repository_rules.bzl", "com_google_api_codegen_properties") @@ -68,6 +160,12 @@ com_google_api_codegen_properties( load("@com_google_api_codegen//:repositories.bzl", "com_google_api_codegen_repositories") +http_archive( + name = "com_google_protoc_java_resource_names_plugin", + strip_prefix = "protoc-java-resource-names-plugin-64dafb71ea9a385a8da89989f0b9dab925bf4610", + urls = ["https://github.com/googleapis/protoc-java-resource-names-plugin/archive/64dafb71ea9a385a8da89989f0b9dab925bf4610.zip"], +) + com_google_api_codegen_repositories() # protoc-java-resource-names-plugin (loaded in com_google_api_codegen_repositories()) @@ -77,68 +175,84 @@ load( "com_google_protoc_java_resource_names_plugin_repositories", ) -com_google_protoc_java_resource_names_plugin_repositories(omit_com_google_protobuf = True) +com_google_protoc_java_resource_names_plugin_repositories() ############################################################################## -# Go +# Python ############################################################################## +load("@com_google_api_codegen//rules_gapic/python:py_gapic_repositories.bzl", "py_gapic_repositories") + +py_gapic_repositories() -# rules_go (support Golang under bazel) http_archive( - name = "io_bazel_rules_go", - sha256 = "a82a352bffae6bee4e95f68a8d80a70e87f42c4741e6a448bec11998fcc82329", - url = "https://github.com/bazelbuild/rules_go/releases/download/0.18.5/rules_go-0.18.5.tar.gz", + name = "protoc_docs_plugin", + strip_prefix = "protoc-docs-plugin-b2502d56b5ec2d47e063976da773206af295362d", + urls = ["https://github.com/googleapis/protoc-docs-plugin/archive/b2502d56b5ec2d47e063976da773206af295362d.zip"], ) -load("@io_bazel_rules_go//go:deps.bzl", "go_rules_dependencies", "go_register_toolchains") +load( + "@protoc_docs_plugin//:repositories.bzl", + "protoc_docs_plugin_register_toolchains", + "protoc_docs_plugin_repositories", +) -go_rules_dependencies() +protoc_docs_plugin_repositories() -go_register_toolchains() +protoc_docs_plugin_register_toolchains() -# bazel-gazelle (support Golang under bazel) +load("@rules_python//python:repositories.bzl", "py_repositories") +py_repositories() + +load("@rules_python//python:pip.bzl", "pip_repositories") +pip_repositories() + +# Change upstream repository once PR is merged http_archive( - name = "bazel_gazelle", - strip_prefix = "bazel-gazelle-0.17.0", - urls = ["https://github.com/bazelbuild/bazel-gazelle/archive/0.17.0.zip"], + name = "gapic_generator_python", + urls = ["https://github.com/googleapis/gapic-generator-python/archive/2d332245b0a7b38f0770a051ed6ed0e631fc9296.zip"], + strip_prefix = "gapic-generator-python-2d332245b0a7b38f0770a051ed6ed0e631fc9296", ) -load("@bazel_gazelle//:deps.bzl", "gazelle_dependencies") +load("@gapic_generator_python//:repositories.bzl", + "gapic_generator_python", + "gapic_generator_register_toolchains" +) -gazelle_dependencies() +gapic_generator_python() -# go_gapic artifacts runtime dependencies (gax-go) -load("@com_google_api_codegen//rules_gapic/go:go_gapic_repositories.bzl", "go_gapic_repositories") +gapic_generator_register_toolchains() -go_gapic_repositories() +load("@gapic_generator_python_pip_deps//:requirements.bzl", "pip_install") + +pip_install() ############################################################################## -# C++ +# Go ############################################################################## +# bazel-gazelle (support Golang under bazel) http_archive( - name = "com_google_gapic_generator_cpp", - strip_prefix = "gapic-generator-cpp-2d9229952b649e53b2e986f5a3031d0d374af9e1", - urls = ["https://github.com/googleapis/gapic-generator-cpp/archive/2d9229952b649e53b2e986f5a3031d0d374af9e1.zip"], + name = "bazel_gazelle", + urls = ["https://github.com/bazelbuild/bazel-gazelle/releases/download/v0.20.0/bazel-gazelle-v0.20.0.tar.gz"], ) -load( - "@com_google_gapic_generator_cpp//gax:repositories.bzl", - "com_google_gapic_generator_cpp_gax_repositories", -) +load("@bazel_gazelle//:deps.bzl", "gazelle_dependencies") -com_google_gapic_generator_cpp_gax_repositories() +gazelle_dependencies() -load("@com_github_grpc_grpc//bazel:grpc_deps.bzl", "grpc_deps") +http_archive( + name = "com_googleapis_gapic_generator_go", + strip_prefix = "gapic-generator-go-0.13.3", + urls = ["https://github.com/googleapis/gapic-generator-go/archive/v0.13.3.tar.gz"], +) -grpc_deps() +load("@com_googleapis_gapic_generator_go//:repositories.bzl", "com_googleapis_gapic_generator_go_repositories") -load( - "@com_google_gapic_generator_cpp//:repositories.bzl", - "com_google_gapic_generator_cpp_repositories", -) +com_googleapis_gapic_generator_go_repositories() -com_google_gapic_generator_cpp_repositories() +load("@com_googleapis_gapic_generator_go//rules_go_gapic:go_gapic_repositories.bzl", "go_gapic_repositories") + +go_gapic_repositories() ############################################################################## # PHP @@ -148,7 +262,9 @@ load("@com_google_api_codegen//rules_gapic/php:php_gapic_repositories.bzl", "php php( name = "php", - version = "7.1.30", + prebuilt_phps = ["@com_google_api_codegen//rules_gapic/php:resources/php-7.1.30_linux_x86_64.tar.gz"], + strip_prefix = "php-7.1.30", + urls = ["https://www.php.net/distributions/php-7.1.30.tar.gz"], ) php_gapic_repositories() diff --git a/third_party/googleapis/google/actions/type/BUILD.bazel b/third_party/googleapis/google/actions/type/BUILD.bazel new file mode 100644 index 000000000..d865c47c4 --- /dev/null +++ b/third_party/googleapis/google/actions/type/BUILD.bazel @@ -0,0 +1,167 @@ +load("@rules_proto//proto:defs.bzl", "proto_library") + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") + +proto_library( + name = "date_range_proto", + srcs = ["date_range.proto"], + deps = [ + "//google/type:date_proto", + ], +) + +proto_library( + name = "datetime_range_proto", + srcs = ["datetime_range.proto"], + deps = [ + "//google/type:datetime_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_proto_library", +) + +java_proto_library( + name = "type_java_proto", + deps = [ + ":date_range_proto", + ":datetime_range_proto", + ], +) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_proto_library", +) + +go_proto_library( + name = "date_range_go_proto", + importpath = "google.golang.org/genproto/googleapis/type/date_range", + protos = [ + ":date_range_proto", + ], + deps = ["//google/type:date_go_proto"], +) + + +go_proto_library( + name = "datetime_range_go_proto", + importpath = "google.golang.org/genproto/googleapis/type/datetime_range", + protos = [ + ":datetime_range_proto", + ], + deps = ["//google/type:datetime_go_proto"], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "py_proto_library", +) + +py_proto_library( + name = "date_range_py_proto", + deps = [":date_range_proto"], +) + +py_proto_library( + name = "datetime_range_py_proto", + deps = [":datetime_range_proto"], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_proto_library", +) + +php_proto_library( + name = "date_range_php_proto", + deps = [":date_range_proto"], +) + +php_proto_library( + name = "datetime_range_php_proto", + deps = [":datetime_range_proto"], +) + +############################################################################## +# Node.js +############################################################################## + + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_proto_library", +) + +ruby_proto_library( + name = "date_range_ruby_proto", + deps = [":date_range_proto"], +) + +ruby_proto_library( + name = "datetime_range_ruby_proto", + deps = [":datetime_range_proto"], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_proto_library", +) + +csharp_proto_library( + name = "date_range_csharp_proto", + deps = [":date_range_proto"], +) + +csharp_proto_library( + name = "datetime_range_csharp_proto", + deps = [":datetime_range_proto"], +) + +############################################################################## +# C++ +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "cc_proto_library", +) + +cc_proto_library( + name = "date_range_cc_proto", + deps = [ + ":date_range_proto", + ], +) + +cc_proto_library( + name = "datetime_range_cc_proto", + deps = [ + ":datetime_range_proto", + ], +) diff --git a/third_party/googleapis/google/actions/type/date_range.proto b/third_party/googleapis/google/actions/type/date_range.proto new file mode 100644 index 000000000..20860f47c --- /dev/null +++ b/third_party/googleapis/google/actions/type/date_range.proto @@ -0,0 +1,81 @@ +// Copyright 2019 Google LLC. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// + +syntax = "proto3"; + +package google.actions.type; + +import "google/type/date.proto"; + +option go_package = "google.golang.org/genproto/googleapis/type/date_range;date_range"; +option java_multiple_files = true; +option java_outer_classname = "DateRangeProto"; +option java_package = "com.google.actions.type"; +option objc_class_prefix = "AOGTP"; + +// Represents a range based on whole or partial calendar dates, e.g. the +// duration of a hotel reservation or the Common Era. This can represent: +// +// * A range between full dates, e.g. the duration of a hotel reservation +// * A range between years, e.g. a historical era +// * A range between year/month dates, e.g. the duration of a job on a resume +// * A range beginning in a year, e.g. the Common Era +// * A range ending on a specific date, e.g. the period of time before an event +// +// While [google.type.Date][google.type.Date] allows zero years, DateRange does not. Year must +// always be non-zero. +// +// End cannot be chronologically before start. For example, if start has year +// 2000, end cannot have year 1999. +// +// When both set, start and end must have exactly the same precision. That is, +// they must have the same fields populated with non-zero values. For example, +// if start specifies only year and month, then end must also specify only year +// and month (but not day). +// +// The date range is inclusive. That is, the dates specified by start and end +// are part of the date range. For example, the date January 1, 2000 falls +// within any date with start or end equal to January 1, 2000. When determining +// whether a date is inside a date range, the date should only be compared to +// start and end when those values are set. +// +// When a date and date range are specified to different degrees of precision, +// the rules for evaluating whether that date is inside the date range are as +// follows: +// +// * When comparing the date to the start of the date range, unspecified months +// should be replaced with 1, and unspecified days should be replaced with 1. +// For example, the year 2000 is within the date range with start equal to +// January 1, 2000 and no end. And the date January 1, 2000 is within the +// date range with start equal to the year 2000 and no end. +// +// * When comparing the date to the end of the date range, unspecified months +// should be replaced with 12, and unspecified days should be replaced with +// the last valid day for the month/year. For example, the year 2000 is +// within the date range with start equal to January 1, 1999 and end equal to +// December 31, 2000. And the date December 31, 2001 is within the date range +// with start equal to the year 2000 and end equal to the year 2001. +// +// The semantics of start and end are the same as those of [google.type.Date][google.type.Date], +// except that year must always be non-zero in DateRange. +message DateRange { + // Date at which the date range begins. If unset, the date range has no + // beginning bound. + google.type.Date start = 1; + + // Date at which the date range ends. If unset, the date range has no ending + // bound. + google.type.Date end = 2; +} diff --git a/third_party/googleapis/google/actions/type/datetime_range.proto b/third_party/googleapis/google/actions/type/datetime_range.proto new file mode 100644 index 000000000..6702c2bc4 --- /dev/null +++ b/third_party/googleapis/google/actions/type/datetime_range.proto @@ -0,0 +1,66 @@ +// Copyright 2019 Google LLC. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// + +syntax = "proto3"; + +package google.actions.type; + +import "google/type/datetime.proto"; + +option go_package = "google.golang.org/genproto/googleapis/type/date_time_range;date_time_range"; +option java_multiple_files = true; +option java_outer_classname = "DateTimeRangeProto"; +option java_package = "com.google.actions.type"; +option objc_class_prefix = "AOGTP"; + +// Represents a date and time range. This can represent: +// +// * A range between points in time with time zone or offset, e.g. the duration +// of a flight which starts in the "America/New_York" time zone and ends in +// the "Australia/Sydney" time zone +// * A range between points in time without time zone/offset info, e.g. an +// appointment in local time +// * A range starting at a specific date and time, e.g. the range of time which +// can be measured in milliseconds since the Unix epoch (period starting with +// 1970-01-01T00:00:00Z) +// * A range ending at a specific date and time, e.g. range of time before +// a deadline +// +// When considering whether a DateTime falls within a DateTimeRange, the start +// of the range is inclusive and the end is exclusive. +// +// While [google.type.DateTime][google.type.DateTime] allows zero years, DateTimeRange does not. +// Year must always be non-zero. +// +// When both start and end are set, either both or neither must have a +// time_offset. When set, time_offset can be specified by either utc_offset or +// time_zone and must match for start and end, that is if start has utc_offset +// set then end must also have utc_offset set. The values of utc_offset or +// time_zone need not be the same for start and end. +// +// When both start and end are set, start must be chronologically less than or +// equal to end. When start and end are equal, the range is empty. +// +// The semantics of start and end are the same as those of +// [google.type.DateTime][google.type.DateTime]. +message DateTimeRange { + // DateTime at which the date range begins. If unset, the range has no + // beginning bound. + google.type.DateTime start = 1; + + // DateTime at which the date range ends. If unset, the range has no ending + // bound. + google.type.DateTime end = 2; +} diff --git a/third_party/googleapis/google/actions/type/type_aog.yaml b/third_party/googleapis/google/actions/type/type_aog.yaml new file mode 100644 index 000000000..9d284e121 --- /dev/null +++ b/third_party/googleapis/google/actions/type/type_aog.yaml @@ -0,0 +1,21 @@ +type: google.api.Service +config_version: 1 +name: type.aog.googleapis.com +title: Common Actions on Google Types + +types: +- name: google.actions.type.DateRange +- name: google.actions.type.DateTimeRange + +documentation: + summary: Defines common types for Actions on Google APIs. + overview: |- + This package contains definitions of common types for Actions on Google + APIs, which are used in addition to the common Google API types in the + google.type package. These types are not versioned, and must go through + extensive review before being created. + + Like the types in google.type, all types defined in this package are + suitable for different APIs to exchange data, and will never break binary + compatibility. They should have design quality comparable to major + programming languages like Java and C#. diff --git a/third_party/googleapis/google/ads/admob/BUILD.bazel b/third_party/googleapis/google/ads/admob/BUILD.bazel new file mode 100644 index 000000000..a87c57fec --- /dev/null +++ b/third_party/googleapis/google/ads/admob/BUILD.bazel @@ -0,0 +1 @@ +exports_files(glob(["*.yaml"])) diff --git a/third_party/googleapis/google/ads/admob/admob_v1.yaml b/third_party/googleapis/google/ads/admob/admob_v1.yaml new file mode 100644 index 000000000..120576d26 --- /dev/null +++ b/third_party/googleapis/google/ads/admob/admob_v1.yaml @@ -0,0 +1,36 @@ +type: google.api.Service +config_version: 3 +name: admob.googleapis.com +title: AdMob API + +apis: +- name: google.ads.admob.v1.AdMobApi + +documentation: + summary: The Google AdMob API lets you programmatically get reports on earnings. + +authentication: + rules: + - selector: 'google.ads.admob.v1.AdMobApi.GetPublisherAccount' + oauth: + canonical_scopes: https://www.googleapis.com/auth/admob.report + - selector: 'google.ads.admob.v1.AdMobApi.ListPublisherAccounts' + oauth: + canonical_scopes: https://www.googleapis.com/auth/admob.report + - selector: 'google.ads.admob.v1.AdMobApi.GenerateMediationReport' + oauth: + canonical_scopes: https://www.googleapis.com/auth/admob.report + - selector: 'google.ads.admob.v1.AdMobApi.GenerateNetworkReport' + oauth: + canonical_scopes: https://www.googleapis.com/auth/admob.report + +backend: + rules: + - selector: 'google.ads.admob.v1.AdMobApi.GetPublisherAccount' + deadline: 5.0 + - selector: 'google.ads.admob.v1.AdMobApi.ListPublisherAccounts' + deadline: 10.0 + - selector: 'google.ads.admob.v1.AdMobApi.GenerateMediationReport' + deadline: 60.0 + - selector: 'google.ads.admob.v1.AdMobApi.GenerateNetworkReport' + deadline: 60.0 diff --git a/third_party/googleapis/google/ads/admob/artman_admob_v1.yaml b/third_party/googleapis/google/ads/admob/artman_admob_v1.yaml new file mode 100644 index 000000000..f733a8806 --- /dev/null +++ b/third_party/googleapis/google/ads/admob/artman_admob_v1.yaml @@ -0,0 +1,34 @@ +common: + api_name: admob + api_version: v1 + organization_name: ads + proto_deps: + - name: google-common-protos + src_proto_paths: + - . + service_yaml: admob_v1.yaml + gapic_yaml: v1/admob_gapic.yaml +artifacts: +- name: gapic_config + type: GAPIC_CONFIG +- name: java_gapic + type: GAPIC + language: JAVA +- name: python_gapic + type: GAPIC + language: PYTHON +- name: nodejs_gapic + type: GAPIC + language: NODEJS +- name: php_gapic + type: GAPIC + language: PHP +- name: go_gapic + type: GAPIC + language: GO +- name: ruby_gapic + type: GAPIC + language: RUBY +- name: csharp_gapic + type: GAPIC + language: CSHARP diff --git a/third_party/googleapis/google/ads/admob/v1/BUILD.bazel b/third_party/googleapis/google/ads/admob/v1/BUILD.bazel new file mode 100644 index 000000000..00b36f06f --- /dev/null +++ b/third_party/googleapis/google/ads/admob/v1/BUILD.bazel @@ -0,0 +1,356 @@ +# This file was automatically generated by BuildFileGenerator + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") +load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") + +proto_library( + name = "admob_proto", + srcs = [ + "admob_api.proto", + "admob_resources.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/type:date_proto", + ], +) + +proto_library_with_info( + name = "admob_proto_with_info", + deps = [ + ":admob_proto", + "//google/cloud:common_resources_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", + "java_proto_library", +) + +java_proto_library( + name = "admob_java_proto", + deps = [":admob_proto"], +) + +java_grpc_library( + name = "admob_java_grpc", + srcs = [":admob_proto"], + deps = [":admob_java_proto"], +) + +java_gapic_library( + name = "admob_java_gapic", + src = ":admob_proto_with_info", + gapic_yaml = "admob_gapic.yaml", + package = "google.ads.admob.v1", + service_yaml = "//google/ads/admob:admob_v1.yaml", + test_deps = [ + ":admob_java_grpc", + ], + deps = [ + ":admob_java_proto", + ], +) + +java_gapic_test( + name = "admob_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.ads.admob.v1.AdMobApiClientTest", + ], + runtime_deps = [":admob_java_gapic_test"], +) + +# Open Source Packages +java_gapic_assembly_gradle_pkg( + name = "google-cloud-ads-admob-v1-java", + deps = [ + ":admob_java_gapic", + ":admob_java_grpc", + ":admob_java_proto", + ":admob_proto", + ], +) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", + "go_proto_library", + "go_test", +) + +go_proto_library( + name = "admob_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/ads/admob/v1", + protos = [":admob_proto"], + deps = [ + "//google/api:annotations_go_proto", + "//google/type:date_go_proto", + ], +) + +go_gapic_library( + name = "admob_go_gapic", + srcs = [":admob_proto_with_info"], + grpc_service_config = "", + importpath = "cloud.google.com/go/ads/admob/apiv1;admob", + service_yaml = "//google/ads/admob:admob_v1.yaml", + deps = [ + ":admob_go_proto", + ], +) + +go_test( + name = "admob_go_gapic_test", + srcs = [":admob_go_gapic_srcjar_test"], + embed = [":admob_go_gapic"], + importpath = "cloud.google.com/go/ads/admob/apiv1", +) + +# Open Source Packages +go_gapic_assembly_pkg( + name = "gapi-cloud-ads-admob-v1-go", + deps = [ + ":admob_go_gapic", + ":admob_go_gapic_srcjar-test.srcjar", + ":admob_go_proto", + ], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "admob_moved_proto", + srcs = [":admob_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/type:date_proto", + ], +) + +py_proto_library( + name = "admob_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":admob_moved_proto"], +) + +py_grpc_library( + name = "admob_py_grpc", + srcs = [":admob_moved_proto"], + deps = [":admob_py_proto"], +) + +py_gapic_library( + name = "admob_py_gapic", + src = ":admob_proto_with_info", + gapic_yaml = "admob_gapic.yaml", + package = "google.ads.admob.v1", + service_yaml = "//google/ads/admob:admob_v1.yaml", + deps = [ + ":admob_py_grpc", + ":admob_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "ads-admob-v1-py", + deps = [ + ":admob_py_gapic", + ":admob_py_grpc", + ":admob_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "admob_php_proto", + deps = [":admob_proto"], +) + +php_grpc_library( + name = "admob_php_grpc", + srcs = [":admob_proto"], + deps = [":admob_php_proto"], +) + +php_gapic_library( + name = "admob_php_gapic", + src = ":admob_proto_with_info", + gapic_yaml = "admob_gapic.yaml", + package = "google.ads.admob.v1", + service_yaml = "//google/ads/admob:admob_v1.yaml", + deps = [ + ":admob_php_grpc", + ":admob_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-ads-admob-v1-php", + deps = [ + ":admob_php_gapic", + ":admob_php_grpc", + ":admob_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "admob_nodejs_gapic", + src = ":admob_proto_with_info", + gapic_yaml = "admob_gapic.yaml", + package = "google.ads.admob.v1", + service_yaml = "//google/ads/admob:admob_v1.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "ads-admob-v1-nodejs", + deps = [ + ":admob_nodejs_gapic", + ":admob_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "admob_ruby_proto", + deps = [":admob_proto"], +) + +ruby_grpc_library( + name = "admob_ruby_grpc", + srcs = [":admob_proto"], + deps = [":admob_ruby_proto"], +) + +ruby_gapic_library( + name = "admob_ruby_gapic", + src = ":admob_proto_with_info", + gapic_yaml = "admob_gapic.yaml", + package = "google.ads.admob.v1", + service_yaml = "//google/ads/admob:admob_v1.yaml", + deps = [ + ":admob_ruby_grpc", + ":admob_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-ads-admob-v1-ruby", + deps = [ + ":admob_ruby_gapic", + ":admob_ruby_grpc", + ":admob_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "admob_csharp_proto", + deps = [":admob_proto"], +) + +csharp_grpc_library( + name = "admob_csharp_grpc", + srcs = [":admob_proto"], + deps = [":admob_csharp_proto"], +) + +csharp_gapic_library( + name = "admob_csharp_gapic", + src = ":admob_proto_with_info", + gapic_yaml = "admob_gapic.yaml", + package = "google.ads.admob.v1", + service_yaml = "//google/ads/admob:admob_v1.yaml", + deps = [ + ":admob_csharp_grpc", + ":admob_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-ads-admob-v1-csharp", + deps = [ + ":admob_csharp_gapic", + ":admob_csharp_grpc", + ":admob_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/ads/admob/v1/admob_api.proto b/third_party/googleapis/google/ads/admob/v1/admob_api.proto new file mode 100644 index 000000000..12486651a --- /dev/null +++ b/third_party/googleapis/google/ads/admob/v1/admob_api.proto @@ -0,0 +1,221 @@ +// Copyright 2019 Google LLC. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// + +syntax = "proto3"; + +package google.ads.admob.v1; + +import "google/ads/admob/v1/admob_resources.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; + +option go_package = "google.golang.org/genproto/googleapis/ads/admob/v1;admob"; +option java_outer_classname = "AdMobApiProto"; +option java_package = "com.google.ads.admob.v1"; + +// The AdMob API allows AdMob publishers to access their account settings and +// generate reports. +service AdMobApi { + option (google.api.default_host) = "admob.googleapis.com"; + + // Gets information about the specified AdMob publisher account. + rpc GetPublisherAccount(GetPublisherAccountRequest) + returns (PublisherAccount) { + option (google.api.http) = { + get: "/v1/{name=accounts/*}" + }; + } + + // Lists the AdMob publisher account accessible with the client credential. + // Currently, all credentials have access to at most one AdMob account. + rpc ListPublisherAccounts(ListPublisherAccountsRequest) + returns (ListPublisherAccountsResponse) { + option (google.api.http) = { + get: "/v1/accounts" + }; + } + + // Generates an AdMob Network report based on the provided report + // specification. + rpc GenerateNetworkReport(GenerateNetworkReportRequest) + returns (stream GenerateNetworkReportResponse) { + option (google.api.http) = { + post: "/v1/{parent=accounts/*}/networkReport:generate" + body: "*" + }; + } + + // Generates an AdMob Mediation report based on the provided report + // specification. + rpc GenerateMediationReport(GenerateMediationReportRequest) + returns (stream GenerateMediationReportResponse) { + option (google.api.http) = { + post: "/v1/{parent=accounts/*}/mediationReport:generate" + body: "*" + }; + } +} + +// Request to retrieve the specified publisher account. +message GetPublisherAccountRequest { + // Resource name of the publisher account to retrieve. + // Example: accounts/pub-9876543210987654 + string name = 1; +} + +// Request to retrieve the AdMob publisher account accessible with the client +// credential. Currently all credentials have access to at most 1 account. +message ListPublisherAccountsRequest { + // Maximum number of accounts to return. + int32 page_size = 1; + + // The value returned by the last `ListPublisherAccountsResponse`; indicates + // that this is a continuation of a prior `ListPublisherAccounts` call, and + // that the system should return the next page of data. + string page_token = 2; +} + +// Response for the publisher account list request. +message ListPublisherAccountsResponse { + // Publisher that the client credentials can access. + repeated PublisherAccount account = 1; + + // If not empty, indicates that there might be more accounts for the request; + // you must pass this value in a new `ListPublisherAccountsRequest`. + string next_page_token = 2; +} + +// Request to generate an AdMob Mediation report. +message GenerateMediationReportRequest { + // Resource name of the account to generate the report for. + // Example: accounts/pub-9876543210987654 + string parent = 1; + + // Network report specification. + MediationReportSpec report_spec = 2; +} + +// The streaming response for the AdMob Mediation report where the first +// response contains the report header, then a stream of row responses, and +// finally a footer as the last response message. +// +// For example: +// +// [{ +// "header": { +// "date_range": { +// "start_date": {"year": 2018, "month": 9, "day": 1}, +// "end_date": {"year": 2018, "month": 9, "day": 30} +// } +// "localization_settings": { +// "currency_code": "USD", +// "language_code": "en-US" +// } +// } +// }, +// { +// "row": { +// "dimension_values": { +// "DATE": {"value": "20180918"}, +// "APP": { +// "value": "ca-app-pub-8123415297019784~1001342552", +// "display_label": "My app name!" +// } +// }, +// "metric_values": { +// "ESTIMATED_EARNINGS": {"decimal_value": "1324746"} +// } +// } +// }, +// { +// "footer": {"matching_row_count": 1} +// }] +message GenerateMediationReportResponse { + // Each stream response message contains one type of payload. + oneof payload { + // Report generation settings that describes the report contents, such as + // the report date range and localization settings. + ReportHeader header = 1; + + // Actual report data. + ReportRow row = 2; + + // Additional information about the generated report, such as warnings about + // the data. + ReportFooter footer = 3; + } +} + +// Request to generate an AdMob Network report. +message GenerateNetworkReportRequest { + // Resource name of the account to generate the report for. + // Example: accounts/pub-9876543210987654 + string parent = 1; + + // Network report specification. + NetworkReportSpec report_spec = 2; +} + +// The streaming response for the AdMob Network report where the first response +// contains the report header, then a stream of row responses, and finally a +// footer as the last response message. +// +// For example: +// +// [{ +// "header": { +// "dateRange": { +// "startDate": {"year": 2018, "month": 9, "day": 1}, +// "endDate": {"year": 2018, "month": 9, "day": 30} +// } +// "localizationSettings": { +// "currencyCode": "USD", +// "languageCode": "en-US" +// } +// } +// }, +// { +// "row": { +// "dimensionValues": { +// "DATE": {"value": "20180918"}, +// "APP": { +// "value": "ca-app-pub-8123415297019784~1001342552", +// displayLabel: "My app name!" +// } +// }, +// "metricValues": { +// "ESTIMATED_EARNINGS": {"microsValue": 6500000} +// } +// } +// }, +// ... +// { +// "footer": {"matchingRowCount": 5} +// }] +message GenerateNetworkReportResponse { + // Each stream response message contains one type of payload. + oneof payload { + // Report generation settings that describes the report contents, such as + // the report date range and localization settings. + ReportHeader header = 1; + + // Actual report data. + ReportRow row = 2; + + // Additional information about the generated report, such as warnings about + // the data. + ReportFooter footer = 3; + } +} diff --git a/third_party/googleapis/google/ads/admob/v1/admob_gapic.yaml b/third_party/googleapis/google/ads/admob/v1/admob_gapic.yaml new file mode 100644 index 000000000..042e2f728 --- /dev/null +++ b/third_party/googleapis/google/ads/admob/v1/admob_gapic.yaml @@ -0,0 +1,150 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 1.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.ads.admob.v1 + python: + package_name: google.cloud.ads.admob_v1.gapic + go: + package_name: cloud.google.com/go/ads/admob/apiv1 + csharp: + package_name: Google.Ads.Admob.V1 + ruby: + package_name: Google::Cloud::Ads::Admob::V1 + php: + package_name: Google\Cloud\Ads\Admob\V1 + nodejs: + package_name: admob.v1 +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.ads.admob.v1.AdMobApi + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: + - name_pattern: accounts/{account} + entity_name: account + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - DEADLINE_EXCEEDED + - UNAVAILABLE + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # + # name - The simple name of the method. + # + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce method + # overloads which allow a client to directly pass request message fields as + # method parameters. This information may or may not be used, depending on + # the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request message. + # + # required_fields - Fields that are always required for a request to be + # valid. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a paging + # list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It defines + # which fields match the paging pattern in the request. The request consists + # of a page_size_field and a token_field. The page_size_field is the name of + # the optional field specifying the maximum number of elements to be + # returned in the response. The token_field is the name of the field in the + # request containing the page token. + # The response specifies response information of the list method. It defines + # which fields match the paging pattern in the response. The response + # consists of a token_field and a resources_field. The token_field is the + # name of the field in the response containing the next page token. The + # resources_field is the name of the field in the response containing the + # list of resources belonging to the page. + # + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: GetPublisherAccount + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: account + timeout_millis: 60000 + - name: ListPublisherAccounts + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: account + retry_codes_name: idempotent + retry_params_name: default + timeout_millis: 60000 + - name: GenerateNetworkReport + flattening: + groups: + - parameters: + - parent + - report_spec + required_fields: + - parent + - report_spec + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: account + timeout_millis: 60000 + - name: GenerateMediationReport + flattening: + groups: + - parameters: + - parent + - report_spec + required_fields: + - parent + - report_spec + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: account + timeout_millis: 60000 diff --git a/third_party/googleapis/google/ads/admob/v1/admob_resources.proto b/third_party/googleapis/google/ads/admob/v1/admob_resources.proto new file mode 100644 index 000000000..200bb3208 --- /dev/null +++ b/third_party/googleapis/google/ads/admob/v1/admob_resources.proto @@ -0,0 +1,567 @@ +// Copyright 2019 Google LLC. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// + +syntax = "proto3"; + +package google.ads.admob.v1; + +import "google/type/date.proto"; + +option go_package = "google.golang.org/genproto/googleapis/ads/admob/v1;admob"; +option java_outer_classname = "AdMobResourceProto"; +option java_package = "com.google.ads.admob.v1"; + +// A publisher account contains information relevant to the use of this API, +// such as the time zone used for the reports. +message PublisherAccount { + // Resource name of this account. + // Format is accounts/{publisher_id}. + string name = 1; + + // The unique ID by which this publisher account can be identified + // in the API requests (for example, pub-1234567890). + string publisher_id = 2; + + // The time zone that is used in reports that are generated for this account. + // The value is a time-zone ID as specified by the CLDR project, + // for example, "America/Los_Angeles". + string reporting_time_zone = 3; + + // Currency code of the earning-related metrics, which is the 3-letter code + // defined in ISO 4217. The daily average rate is used for the currency + // conversion. + string currency_code = 4; +} + +// The specification for generating an AdMob Network report. +// For example, the specification to get clicks and estimated earnings for only +// the 'US' and 'CN' countries can look like the following example: +// +// { +// 'date_range': { +// 'start_date': {'year': 2018, 'month': 9, 'day': 1}, +// 'end_date': {'year': 2018, 'month': 9, 'day': 30} +// }, +// 'dimensions': ['DATE', 'APP', 'COUNTRY'], +// 'metrics': ['CLICKS', 'ESTIMATED_EARNINGS'], +// 'dimension_filters': [ +// { +// 'dimension': 'COUNTRY', +// 'matches_any': {'values': [{'value': 'US', 'value': 'CN'}]} +// } +// ], +// 'sort_conditions': [ +// {'dimension':'APP', order: 'ASCENDING'}, +// {'metric':'CLICKS', order: 'DESCENDING'} +// ], +// 'localization_settings': { +// 'currency_code': 'USD', +// 'language_code': 'en-US' +// } +// } +// +// For a better understanding, you can treat the preceding specification like +// the following pseudo SQL: +// +// SELECT DATE, APP, COUNTRY, CLICKS, ESTIMATED_EARNINGS +// FROM NETWORK_REPORT +// WHERE DATE >= '2018-09-01' AND DATE <= '2018-09-30' +// AND COUNTRY IN ('US', 'CN') +// GROUP BY DATE, APP, COUNTRY +// ORDER BY APP ASC, CLICKS DESC; +message NetworkReportSpec { + // Describes which report rows to match based on their dimension values. + message DimensionFilter { + // Applies the filter criterion to the specified dimension. + Dimension dimension = 1; + + // Filter operator to be applied. + oneof operator { + // Matches a row if its value for the specified dimension is in one of the + // values specified in this condition. + StringList matches_any = 2; + } + } + + // Sorting direction to be applied on a dimension or a metric. + message SortCondition { + // Identifies which values to sort on. + oneof sort_on { + // Sort by the specified dimension. + Dimension dimension = 1; + + // Sort by the specified metric. + Metric metric = 2; + } + + // Sorting order of the dimension or metric. + SortOrder order = 3; + } + + // The dimensions of the network report. Dimensions are data attributes to + // break down or refine the quantitative measurements (metrics) by certain + // attributes, such as the ad format or the platform an ad was viewed on. + enum Dimension { + // Default value for an unset field. Do not use. + DIMENSION_UNSPECIFIED = 0; + + // A date in the YYYY-MM-DD format (for example, "2018-12-21"). Requests can + // specify at most one time dimension. + DATE = 1; + + // A month in the YYYY-MM format (for example, "2018-12"). Requests can + // specify at most one time dimension. + MONTH = 2; + + // The date of the first day of a week in the YYYY-MM-DD format + // (for example, "2018-12-21"). Requests can specify at most one time + // dimension. + WEEK = 3; + + // The unique ID of the ad unit (for example, "ca-app-pub-1234/1234"). + // If AD_UNIT dimension is specified, then APP is included automatically. + AD_UNIT = 4; + + // The unique ID of the mobile application (for example, + // "ca-app-pub-1234~1234"). + APP = 5; + + // CLDR country code of the place where the ad views/clicks occur (for + // example, "US" or "FR"). This is a geography dimension. + COUNTRY = 7; + + // Format of the ad unit (for example, "banner", "native"), an ad delivery + // dimension. + FORMAT = 8; + + // Mobile OS platform of the app (for example, "Android" or "iOS"). + PLATFORM = 9; + } + + // The metrics of the network report. Metrics are quantitative measurements + // indicating how the publisher business is performing. They are aggregated + // from the individual ad events and grouped by the report dimensions. The + // metric value is either integer, or decimal (without rounding). + enum Metric { + // Default value for an unset field. Do not use. + METRIC_UNSPECIFIED = 0; + + // The number of ad requests. The value is an integer. + AD_REQUESTS = 1; + + // The number of times a user clicks an ad. The value is an integer. + CLICKS = 2; + + // The estimated earnings of the AdMob publisher. The currency unit (USD, + // EUR, or other) of the earning metrics are determined by the localization + // setting for currency. The amount is in micros. For example, $6.50 would + // be represented as 6500000. + ESTIMATED_EARNINGS = 3; + + // The total number of ads shown to users. The value is an integer. + IMPRESSIONS = 4; + + // The ratio of clicks over impressions. The value is a double precision + // (approximate) decimal value. + IMPRESSION_CTR = 5; + + // The estimated earnings per thousand ad impressions. The value is in + // micros. For example, $1.03 would be represented as 1030000. + IMPRESSION_RPM = 6; + + // The number of times ads are returned in response to a request. The value + // is an integer. + MATCHED_REQUESTS = 7; + + // The ratio of matched ad requests over the total ad requests. The value is + // a double precision (approximate) decimal value. + MATCH_RATE = 8; + + // The ratio of ads that are displayed over ads that are returned, defined + // as impressions / matched requests. The value is a double precision + // (approximate) decimal value. + SHOW_RATE = 9; + } + + // The date range for which the report is generated. + DateRange date_range = 1; + + // List of dimensions of the report. The value combination of these dimensions + // determines the row of the report. If no dimensions are specified, the + // report returns a single row of requested metrics for the entire account. + repeated Dimension dimensions = 2; + + // List of metrics of the report. A report must specify at least one metric. + repeated Metric metrics = 3; + + // Describes which report rows to match based on their dimension values. + repeated DimensionFilter dimension_filters = 4; + + // Describes the sorting of report rows. The order of the condition in the + // list defines its precedence; the earlier the condition, the higher its + // precedence. If no sort conditions are specified, the row ordering is + // undefined. + repeated SortCondition sort_conditions = 5; + + // Localization settings of the report. + LocalizationSettings localization_settings = 6; + + // Maximum number of report data rows to return. If the value is not set, the + // API returns as many rows as possible, up to 100000. Acceptable values are + // 1-100000, inclusive. Any other values are treated as 100000. + int32 max_report_rows = 7; +} + +// The specification for generating an AdMob Mediation report. +// For example, the specification to get observed ECPM sliced by ad source and +// app for the 'US' and 'CN' countries can look like the following example: +// +// { +// "date_range": { +// "start_date": {"year": 2018, "month": 9, "day": 1}, +// "end_date": {"year": 2018, "month": 9, "day": 30} +// }, +// "dimensions": ["AD_SOURCE", "APP", "COUNTRY"], +// "metrics": ["OBSERVED_ECPM"], +// "dimension_filters": [ +// { +// "dimension": "COUNTRY", +// "matches_any": {"values": [{"value": "US", "value": "CN"}]} +// } +// ], +// "sort_conditions": [ +// {"dimension":"APP", order: "ASCENDING"} +// ], +// "localization_settings": { +// "currency_code": "USD", +// "language_code": "en-US" +// } +// } +// +// For a better understanding, you can treat the preceding specification like +// the following pseudo SQL: +// +// SELECT AD_SOURCE, APP, COUNTRY, OBSERVED_ECPM +// FROM MEDIATION_REPORT +// WHERE DATE >= '2018-09-01' AND DATE <= '2018-09-30' +// AND COUNTRY IN ('US', 'CN') +// GROUP BY AD_SOURCE, APP, COUNTRY +// ORDER BY APP ASC; +message MediationReportSpec { + // Describes which report rows to match based on their dimension values. + message DimensionFilter { + // Applies the filter criterion to the specified dimension. + Dimension dimension = 1; + + // Filter operator to be applied. + oneof operator { + // Matches a row if its value for the specified dimension is in one of the + // values specified in this condition. + StringList matches_any = 2; + } + } + + // Sorting direction to be applied on a dimension or a metric. + message SortCondition { + // Identifies which values to sort on. + oneof sort_on { + // Sort by the specified dimension. + Dimension dimension = 1; + + // Sort by the specified metric. + Metric metric = 2; + } + + // Sorting order of the dimension or metric. + SortOrder order = 3; + } + + // The dimensions of the mediation report. Dimensions are data attributes to + // break down or refine the quantitative measurements (metrics) by certain + // attributes, such as the ad format or the platform an ad was viewed on. + enum Dimension { + // Default value for an unset field. Do not use. + DIMENSION_UNSPECIFIED = 0; + + // A date in the YYYY-MM-DD format (for example, "2018-12-21"). Requests can + // specify at most one time dimension. + DATE = 1; + + // A month in the YYYY-MM format (for example, "2018-12"). Requests can + // specify at most one time dimension. + MONTH = 2; + + // The date of the first day of a week in the YYYY-MM-DD format + // (for example, "2018-12-21"). Requests can specify at most one time + // dimension. + WEEK = 3; + + // The unique ID of the ad source (for example, "5450213213286189855" and + // "AdMob Network" as label value). + AD_SOURCE = 4; + + // The unique ID of the ad source instance (for example, + // "ca-app-pub-1234#5678" and "AdMob (default)" as label value). + // Warning: The dimension is incompatible with ESTIMATED_EARNINGS and + // OBSERVED_ECPM metrics. + AD_SOURCE_INSTANCE = 5; + + // The unique ID of the ad unit (for example, "ca-app-pub-1234/8790"). + // If AD_UNIT dimension is specified, then APP is included automatically. + AD_UNIT = 6; + + // The unique ID of the mobile application (for example, + // "ca-app-pub-1234~1234"). + APP = 7; + + // The unique ID of the mediation group (for example, + // "ca-app-pub-1234:mg:1234" and "AdMob (default)" as label value). + // Warning: The dimension is incompatible with ESTIMATED_EARNINGS and + // OBSERVED_ECPM metrics. + MEDIATION_GROUP = 11; + + // CLDR country code of the place where the ad views/clicks occur (for + // example, "US" or "FR"). This is a geography dimension. + COUNTRY = 8; + + // Format of the ad unit (for example, "banner", "native"), an ad delivery + // dimension. + FORMAT = 9; + + // Mobile OS platform of the app (for example, "Android" or "iOS"). + PLATFORM = 10; + } + + // The metrics of the mediation report. Metrics are quantitative measurements + // indicating how the publisher business is performing. They are aggregated + // from the individual ad events and grouped by the report dimensions. The + // metric value is either integer, or decimal (without rounding). + enum Metric { + // Default value for an unset field. Do not use. + METRIC_UNSPECIFIED = 0; + + // The number of requests. The value is an integer. + AD_REQUESTS = 1; + + // The number of times a user clicks an ad. The value is an integer. + CLICKS = 2; + + // The estimated earnings of the AdMob publisher. The currency unit (USD, + // EUR, or other) of the earning metrics are determined by the localization + // setting for currency. The amount is in micros. For example, $6.50 would + // be represented as 6500000. + // Warning: The metric is incompatible with AD_SOURCE_INSTANCE and + // MEDIATION_GROUP dimensions. + ESTIMATED_EARNINGS = 3; + + // The total number of ads shown to users. The value is an integer. + IMPRESSIONS = 4; + + // The ratio of clicks over impressions. The value is a double precision + // (approximate) decimal value. + IMPRESSION_CTR = 5; + + // The number of times ads are returned in response to a request. The value + // is an integer. + MATCHED_REQUESTS = 6; + + // The ratio of matched ad requests over the total ad requests. The value is + // a double precision (approximate) decimal value. + MATCH_RATE = 7; + + // The third-party ad network's estimated average eCPM. The currency unit + // (USD, EUR, or other) of the earning metrics are determined by the + // localization setting for currency. The amount is in micros. For example, + // $2.30 would be represented as 2300000. + // Warning: The metric is incompatible with AD_SOURCE_INSTANCE and + // MEDIATION_GROUP dimensions. + OBSERVED_ECPM = 8; + } + + // The date range for which the report is generated. + DateRange date_range = 1; + + // List of dimensions of the report. The value combination of these dimensions + // determines the row of the report. If no dimensions are specified, the + // report returns a single row of requested metrics for the entire account. + repeated Dimension dimensions = 2; + + // List of metrics of the report. A report must specify at least one metric. + repeated Metric metrics = 3; + + // Describes which report rows to match based on their dimension values. + repeated DimensionFilter dimension_filters = 4; + + // Describes the sorting of report rows. The order of the condition in the + // list defines its precedence; the earlier the condition, the higher its + // precedence. If no sort conditions are specified, the row ordering is + // undefined. + repeated SortCondition sort_conditions = 5; + + // Localization settings of the report. + LocalizationSettings localization_settings = 6; + + // Maximum number of report data rows to return. If the value is not set, the + // API returns as many rows as possible, up to 100000. Acceptable values are + // 1-100000, inclusive. Any other values are treated as 100000. + int32 max_report_rows = 7; +} + +// A row of the returning report. +message ReportRow { + // Representation of a dimension value. + message DimensionValue { + // Dimension value in the format specified in the report's spec Dimension + // enum. + string value = 1; + + // The localized string representation of the value. If unspecified, the + // display label should be derived from the value. + string display_label = 2; + } + + // Representation of a metric value. + message MetricValue { + // Metric value in the format specified in the report's spec Metric enum + // name. + oneof value { + // Metric integer value. + int64 integer_value = 1; + + // Double precision (approximate) decimal values. Rates are from 0 to 1. + double double_value = 2; + + // Amount in micros. One million is equivalent to one unit. Currency value + // is in the unit (USD, EUR or other) specified by the request. + // For example, $6.50 whould be represented as 6500000 micros. + int64 micros_value = 3; + } + } + + // Map of dimension values in a row, with keys as enum name of the dimensions. + map dimension_values = 1; + + // Map of metric values in a row, with keys as enum name of the metrics. If + // a metric being requested has no value returned, the map will not include + // it. + map metric_values = 2; +} + +// Warnings associated with generation of the report. +message ReportWarning { + // Warning type. + enum Type { + // Default value for an unset field. Do not use. + TYPE_UNSPECIFIED = 0; + + // Some data in this report is aggregated based on a time zone different + // from the requested time zone. This could happen if a local time-zone + // report has the start time before the last time this time zone changed. + // The description field will contain the date of the last time zone + // change. + DATA_BEFORE_ACCOUNT_TIMEZONE_CHANGE = 1; + + // There is an unusual delay in processing the source data for the + // requested date range. The report results might be less up to date than + // usual. AdMob is aware of the issue and is actively working to resolve + // it. + DATA_DELAYED = 2; + + // Warnings that are exposed without a specific type. Useful when new + // warning types are added but the API is not changed yet. + OTHER = 3; + + // The currency being requested is not the account currency. The earning + // metrics will be based on the requested currency, and thus not a good + // estimation of the final payment anymore, due to the currency rate + // fluctuation. + REPORT_CURRENCY_NOT_ACCOUNT_CURRENCY = 4; + } + + // Type of the warning. + Type type = 1; + + // Describes the details of the warning message, in English. + string description = 2; +} + +// Groups data helps to treat the generated report. Always sent as a first +// message in the stream response. +message ReportHeader { + // The date range for which the report is generated. This is identical to the + // range specified in the report request. + DateRange date_range = 1; + + // Localization settings of the report. This is identical to the settings + // in the report request. + LocalizationSettings localization_settings = 2; + + // The report time zone. The value is a time-zone ID as specified by the CLDR + // project, for example, "America/Los_Angeles". + string reporting_time_zone = 3; +} + +// Groups data available after report generation, for example, warnings and row +// counts. Always sent as the last message in the stream response. +message ReportFooter { + // Warnings associated with generation of the report. + repeated ReportWarning warnings = 1; + + // Total number of rows that did match the request. + int64 matching_row_count = 2; +} + +// Specification of a single date range. Both dates are inclusive. +message DateRange { + // Start date of the date range, inclusive. Must be less than or equal to the + // end date. + google.type.Date start_date = 1; + + // End date of the date range, inclusive. Must be greater than or equal to the + // start date. + google.type.Date end_date = 2; +} + +// Localization settings for reports, such as currency and language. It affects +// how metrics are calculated. +message LocalizationSettings { + // Currency code of the earning related metrics, which is the 3-letter code + // defined in ISO 4217. The daily average rate is used for the currency + // conversion. Defaults to the account currency code if unspecified. + string currency_code = 1; + + // Language used for any localized text, such as some dimension value display + // labels. The language tag defined in the IETF BCP47. Defaults to 'en-US' if + // unspecified. + string language_code = 2; +} + +// List of string values. +message StringList { + // The string values. + repeated string values = 1; +} + +// The sorting order. +enum SortOrder { + // Default value for an unset field. Do not use. + SORT_ORDER_UNSPECIFIED = 0; + + // Sort dimension value or metric value in ascending order. + ASCENDING = 1; + + // Sort dimension value or metric value in descending order. + DESCENDING = 2; +} diff --git a/third_party/googleapis/google/ads/googleads/base.yaml b/third_party/googleapis/google/ads/googleads/base.yaml deleted file mode 100644 index a18b0c0df..000000000 --- a/third_party/googleapis/google/ads/googleads/base.yaml +++ /dev/null @@ -1,276 +0,0 @@ -type: google.api.Service -config_version: 3 -name: googleads.googleapis.com -title: Google Ads API - -apis: -- name: google.ads.googleads.v0.services.AccountBudgetProposalService -- name: google.ads.googleads.v0.services.AccountBudgetService -- name: google.ads.googleads.v0.services.AdGroupAdService -- name: google.ads.googleads.v0.services.AdGroupAudienceViewService -- name: google.ads.googleads.v0.services.AdGroupBidModifierService -- name: google.ads.googleads.v0.services.AdGroupCriterionService -- name: google.ads.googleads.v0.services.AdGroupFeedService -- name: google.ads.googleads.v0.services.AdGroupService -- name: google.ads.googleads.v0.services.AgeRangeViewService -- name: google.ads.googleads.v0.services.BiddingStrategyService -- name: google.ads.googleads.v0.services.BillingSetupService -- name: google.ads.googleads.v0.services.CampaignAudienceViewService -- name: google.ads.googleads.v0.services.CampaignBidModifierService -- name: google.ads.googleads.v0.services.CampaignBudgetService -- name: google.ads.googleads.v0.services.CampaignCriterionService -- name: google.ads.googleads.v0.services.CampaignFeedService -- name: google.ads.googleads.v0.services.CampaignGroupService -- name: google.ads.googleads.v0.services.CampaignService -- name: google.ads.googleads.v0.services.CampaignSharedSetService -- name: google.ads.googleads.v0.services.CarrierConstantService -- name: google.ads.googleads.v0.services.ChangeStatusService -- name: google.ads.googleads.v0.services.ConversionActionService -- name: google.ads.googleads.v0.services.CustomerClientLinkService -- name: google.ads.googleads.v0.services.CustomerClientService -- name: google.ads.googleads.v0.services.CustomerFeedService -- name: google.ads.googleads.v0.services.CustomerManagerLinkService -- name: google.ads.googleads.v0.services.CustomerService -- name: google.ads.googleads.v0.services.DisplayKeywordViewService -- name: google.ads.googleads.v0.services.FeedItemService -- name: google.ads.googleads.v0.services.FeedMappingService -- name: google.ads.googleads.v0.services.FeedService -- name: google.ads.googleads.v0.services.GenderViewService -- name: google.ads.googleads.v0.services.GeoTargetConstantService -- name: google.ads.googleads.v0.services.GoogleAdsFieldService -- name: google.ads.googleads.v0.services.SharedCriterionService -- name: google.ads.googleads.v0.services.SharedSetService -- name: google.ads.googleads.v0.services.UserListService -- name: google.ads.googleads.v0.services.GoogleAdsService -- name: google.ads.googleads.v0.services.HotelGroupViewService -- name: google.ads.googleads.v0.services.HotelPerformanceViewService -- name: google.ads.googleads.v0.services.KeywordPlanAdGroupService -- name: google.ads.googleads.v0.services.KeywordPlanCampaignService -- name: google.ads.googleads.v0.services.KeywordPlanIdeaService -- name: google.ads.googleads.v0.services.KeywordPlanKeywordService -- name: google.ads.googleads.v0.services.KeywordPlanNegativeKeywordService -- name: google.ads.googleads.v0.services.KeywordPlanService -- name: google.ads.googleads.v0.services.KeywordViewService -- name: google.ads.googleads.v0.services.LanguageConstantService -- name: google.ads.googleads.v0.services.ManagedPlacementViewService -- name: google.ads.googleads.v0.services.MediaFileService -- name: google.ads.googleads.v0.services.ParentalStatusViewService -- name: google.ads.googleads.v0.services.PaymentsAccountService -- name: google.ads.googleads.v0.services.ProductGroupViewService -- name: google.ads.googleads.v0.services.RecommendationService -- name: google.ads.googleads.v0.services.SearchTermViewService -- name: google.ads.googleads.v0.services.TopicConstantService -- name: google.ads.googleads.v0.services.TopicViewService -- name: google.ads.googleads.v0.services.UserInterestService -- name: google.ads.googleads.v0.services.VideoService - -types: -- name: google.ads.googleads.v0.errors.GoogleAdsFailure - -documentation: - summary: |- - Manage your AdWords accounts, campaigns, and reports with this REST-based - API. - overview: |- - # This warning always fires when the last path segment of packages is not - - # the version - -backend: - rules: - - selector: google.ads.googleads.v0.services.AccountBudgetProposalService.GetAccountBudgetProposal - deadline: 60.0 - - selector: google.ads.googleads.v0.services.AccountBudgetProposalService.MutateAccountBudgetProposal - deadline: 60.0 - - selector: google.ads.googleads.v0.services.AccountBudgetService.GetAccountBudget - deadline: 60.0 - - selector: google.ads.googleads.v0.services.AdGroupAdService.GetAdGroupAd - deadline: 60.0 - - selector: google.ads.googleads.v0.services.AdGroupAdService.MutateAdGroupAds - deadline: 60.0 - - selector: google.ads.googleads.v0.services.AdGroupAudienceViewService.GetAdGroupAudienceView - deadline: 60.0 - - selector: google.ads.googleads.v0.services.AdGroupBidModifierService.GetAdGroupBidModifier - deadline: 60.0 - - selector: google.ads.googleads.v0.services.AdGroupBidModifierService.MutateAdGroupBidModifiers - deadline: 60.0 - - selector: google.ads.googleads.v0.services.AdGroupCriterionService.GetAdGroupCriterion - deadline: 60.0 - - selector: google.ads.googleads.v0.services.AdGroupCriterionService.MutateAdGroupCriteria - deadline: 60.0 - - selector: google.ads.googleads.v0.services.AdGroupFeedService.GetAdGroupFeed - deadline: 60.0 - - selector: google.ads.googleads.v0.services.AdGroupFeedService.MutateAdGroupFeeds - deadline: 60.0 - - selector: google.ads.googleads.v0.services.AdGroupService.GetAdGroup - deadline: 60.0 - - selector: google.ads.googleads.v0.services.AdGroupService.MutateAdGroups - deadline: 60.0 - - selector: google.ads.googleads.v0.services.AgeRangeViewService.GetAgeRangeView - deadline: 60.0 - - selector: google.ads.googleads.v0.services.BiddingStrategyService.GetBiddingStrategy - deadline: 60.0 - - selector: google.ads.googleads.v0.services.BiddingStrategyService.MutateBiddingStrategies - deadline: 60.0 - - selector: google.ads.googleads.v0.services.BillingSetupService.GetBillingSetup - deadline: 60.0 - - selector: google.ads.googleads.v0.services.BillingSetupService.MutateBillingSetup - deadline: 60.0 - - selector: google.ads.googleads.v0.services.CampaignAudienceViewService.GetCampaignAudienceView - deadline: 60.0 - - selector: google.ads.googleads.v0.services.CampaignBidModifierService.GetCampaignBidModifier - deadline: 60.0 - - selector: google.ads.googleads.v0.services.CampaignBidModifierService.MutateCampaignBidModifiers - deadline: 60.0 - - selector: google.ads.googleads.v0.services.CampaignBudgetService.GetCampaignBudget - deadline: 60.0 - - selector: google.ads.googleads.v0.services.CampaignBudgetService.MutateCampaignBudgets - deadline: 60.0 - - selector: google.ads.googleads.v0.services.CampaignCriterionService.GetCampaignCriterion - deadline: 60.0 - - selector: google.ads.googleads.v0.services.CampaignCriterionService.MutateCampaignCriteria - deadline: 60.0 - - selector: google.ads.googleads.v0.services.CampaignFeedService.GetCampaignFeed - deadline: 60.0 - - selector: google.ads.googleads.v0.services.CampaignFeedService.MutateCampaignFeeds - deadline: 60.0 - - selector: google.ads.googleads.v0.services.CampaignGroupService.GetCampaignGroup - deadline: 60.0 - - selector: google.ads.googleads.v0.services.CampaignGroupService.MutateCampaignGroups - deadline: 60.0 - - selector: google.ads.googleads.v0.services.CampaignService.GetCampaign - deadline: 60.0 - - selector: google.ads.googleads.v0.services.CampaignService.MutateCampaigns - deadline: 60.0 - - selector: google.ads.googleads.v0.services.CampaignSharedSetService.GetCampaignSharedSet - deadline: 60.0 - - selector: google.ads.googleads.v0.services.CampaignSharedSetService.MutateCampaignSharedSets - deadline: 60.0 - - selector: google.ads.googleads.v0.services.CarrierConstantService.GetCarrierConstant - deadline: 60.0 - - selector: google.ads.googleads.v0.services.ChangeStatusService.GetChangeStatus - deadline: 60.0 - - selector: google.ads.googleads.v0.services.ConversionActionService.GetConversionAction - deadline: 60.0 - - selector: google.ads.googleads.v0.services.ConversionActionService.MutateConversionActions - deadline: 60.0 - - selector: google.ads.googleads.v0.services.CustomerClientLinkService.GetCustomerClientLink - deadline: 60.0 - - selector: google.ads.googleads.v0.services.CustomerClientService.GetCustomerClient - deadline: 60.0 - - selector: google.ads.googleads.v0.services.CustomerFeedService.GetCustomerFeed - deadline: 60.0 - - selector: google.ads.googleads.v0.services.CustomerFeedService.MutateCustomerFeeds - deadline: 60.0 - - selector: google.ads.googleads.v0.services.CustomerManagerLinkService.GetCustomerManagerLink - deadline: 60.0 - - selector: google.ads.googleads.v0.services.CustomerService.GetCustomer - deadline: 60.0 - - selector: google.ads.googleads.v0.services.CustomerService.MutateCustomer - deadline: 60.0 - - selector: google.ads.googleads.v0.services.CustomerService.ListAccessibleCustomers - deadline: 60.0 - - selector: google.ads.googleads.v0.services.CustomerService.CreateCustomerClient - deadline: 60.0 - - selector: google.ads.googleads.v0.services.DisplayKeywordViewService.GetDisplayKeywordView - deadline: 60.0 - - selector: google.ads.googleads.v0.services.FeedItemService.GetFeedItem - deadline: 60.0 - - selector: google.ads.googleads.v0.services.FeedItemService.MutateFeedItems - deadline: 60.0 - - selector: google.ads.googleads.v0.services.FeedMappingService.GetFeedMapping - deadline: 60.0 - - selector: google.ads.googleads.v0.services.FeedMappingService.MutateFeedMappings - deadline: 60.0 - - selector: google.ads.googleads.v0.services.FeedService.GetFeed - deadline: 60.0 - - selector: google.ads.googleads.v0.services.FeedService.MutateFeeds - deadline: 60.0 - - selector: google.ads.googleads.v0.services.GenderViewService.GetGenderView - deadline: 60.0 - - selector: google.ads.googleads.v0.services.GeoTargetConstantService.GetGeoTargetConstant - deadline: 60.0 - - selector: google.ads.googleads.v0.services.GeoTargetConstantService.SuggestGeoTargetConstants - deadline: 60.0 - - selector: google.ads.googleads.v0.services.GoogleAdsFieldService.GetGoogleAdsField - deadline: 600.0 - - selector: google.ads.googleads.v0.services.GoogleAdsFieldService.SearchGoogleAdsFields - deadline: 600.0 - - selector: google.ads.googleads.v0.services.SharedCriterionService.GetSharedCriterion - deadline: 60.0 - - selector: google.ads.googleads.v0.services.SharedCriterionService.MutateSharedCriteria - deadline: 60.0 - - selector: google.ads.googleads.v0.services.SharedSetService.GetSharedSet - deadline: 60.0 - - selector: google.ads.googleads.v0.services.SharedSetService.MutateSharedSets - deadline: 60.0 - - selector: google.ads.googleads.v0.services.UserListService.GetUserList - deadline: 60.0 - - selector: google.ads.googleads.v0.services.UserListService.MutateUserLists - deadline: 60.0 - - selector: google.ads.googleads.v0.services.GoogleAdsService.Search - deadline: 600.0 - - selector: google.ads.googleads.v0.services.GoogleAdsService.Mutate - deadline: 600.0 - - selector: google.ads.googleads.v0.services.HotelGroupViewService.GetHotelGroupView - deadline: 60.0 - - selector: google.ads.googleads.v0.services.HotelPerformanceViewService.GetHotelPerformanceView - deadline: 60.0 - - selector: google.ads.googleads.v0.services.KeywordPlanAdGroupService.GetKeywordPlanAdGroup - deadline: 60.0 - - selector: google.ads.googleads.v0.services.KeywordPlanAdGroupService.MutateKeywordPlanAdGroups - deadline: 60.0 - - selector: google.ads.googleads.v0.services.KeywordPlanCampaignService.GetKeywordPlanCampaign - deadline: 60.0 - - selector: google.ads.googleads.v0.services.KeywordPlanCampaignService.MutateKeywordPlanCampaigns - deadline: 60.0 - - selector: google.ads.googleads.v0.services.KeywordPlanIdeaService.GenerateKeywordIdeas - deadline: 600.0 - - selector: google.ads.googleads.v0.services.KeywordPlanKeywordService.GetKeywordPlanKeyword - deadline: 60.0 - - selector: google.ads.googleads.v0.services.KeywordPlanKeywordService.MutateKeywordPlanKeywords - deadline: 60.0 - - selector: google.ads.googleads.v0.services.KeywordPlanNegativeKeywordService.GetKeywordPlanNegativeKeyword - deadline: 60.0 - - selector: google.ads.googleads.v0.services.KeywordPlanNegativeKeywordService.MutateKeywordPlanNegativeKeywords - deadline: 60.0 - - selector: google.ads.googleads.v0.services.KeywordPlanService.GetKeywordPlan - deadline: 60.0 - - selector: google.ads.googleads.v0.services.KeywordPlanService.MutateKeywordPlans - deadline: 60.0 - - selector: google.ads.googleads.v0.services.KeywordPlanService.GenerateForecastMetrics - deadline: 600.0 - - selector: google.ads.googleads.v0.services.KeywordPlanService.GenerateHistoricalMetrics - deadline: 600.0 - - selector: google.ads.googleads.v0.services.KeywordViewService.GetKeywordView - deadline: 60.0 - - selector: google.ads.googleads.v0.services.LanguageConstantService.GetLanguageConstant - deadline: 60.0 - - selector: google.ads.googleads.v0.services.ManagedPlacementViewService.GetManagedPlacementView - deadline: 60.0 - - selector: google.ads.googleads.v0.services.MediaFileService.GetMediaFile - deadline: 60.0 - - selector: google.ads.googleads.v0.services.MediaFileService.MutateMediaFiles - deadline: 60.0 - - selector: google.ads.googleads.v0.services.ParentalStatusViewService.GetParentalStatusView - deadline: 60.0 - - selector: google.ads.googleads.v0.services.PaymentsAccountService.ListPaymentsAccounts - deadline: 60.0 - - selector: google.ads.googleads.v0.services.ProductGroupViewService.GetProductGroupView - deadline: 60.0 - - selector: google.ads.googleads.v0.services.RecommendationService.GetRecommendation - deadline: 600.0 - - selector: google.ads.googleads.v0.services.RecommendationService.ApplyRecommendation - deadline: 600.0 - - selector: google.ads.googleads.v0.services.RecommendationService.DismissRecommendation - deadline: 600.0 - - selector: google.ads.googleads.v0.services.SearchTermViewService.GetSearchTermView - deadline: 60.0 - - selector: google.ads.googleads.v0.services.TopicConstantService.GetTopicConstant - deadline: 60.0 - - selector: google.ads.googleads.v0.services.TopicViewService.GetTopicView - deadline: 60.0 - - selector: google.ads.googleads.v0.services.UserInterestService.GetUserInterest - deadline: 60.0 - - selector: google.ads.googleads.v0.services.VideoService.GetVideo - deadline: 60.0 diff --git a/third_party/googleapis/google/ads/googleads/v1/common/ad_asset.proto b/third_party/googleapis/google/ads/googleads/v1/common/ad_asset.proto index 0b919064a..e2c41757d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/ad_asset.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/ad_asset.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,15 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.common; import "google/ads/googleads/v1/enums/served_asset_field_type.proto"; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; @@ -41,8 +40,7 @@ message AdTextAsset { // within this field. Multiple assets can be pinned to the same field. An // asset that is unpinned or pinned to a different field will not serve in a // field where some other asset has been pinned. - google.ads.googleads.v1.enums.ServedAssetFieldTypeEnum.ServedAssetFieldType - pinned_field = 2; + google.ads.googleads.v1.enums.ServedAssetFieldTypeEnum.ServedAssetFieldType pinned_field = 2; } // An image asset used inside an ad. diff --git a/third_party/googleapis/google/ads/googleads/v1/common/ad_type_infos.proto b/third_party/googleapis/google/ads/googleads/v1/common/ad_type_infos.proto index 2bf23d5c3..44b563760 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/ad_type_infos.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/ad_type_infos.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -23,8 +22,8 @@ import "google/ads/googleads/v1/enums/display_ad_format_setting.proto"; import "google/ads/googleads/v1/enums/display_upload_product_type.proto"; import "google/ads/googleads/v1/enums/legacy_app_install_ad_app_store.proto"; import "google/ads/googleads/v1/enums/mime_type.proto"; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; @@ -116,8 +115,7 @@ message CallOnlyAdInfo { // The call conversion behavior of this call only ad. It can use its own call // conversion setting, inherit the account level setting, or be disabled. - google.ads.googleads.v1.enums.CallConversionReportingStateEnum - .CallConversionReportingState conversion_reporting_state = 10; + google.ads.googleads.v1.enums.CallConversionReportingStateEnum.CallConversionReportingState conversion_reporting_state = 10; } // An expanded dynamic search ad. @@ -127,13 +125,19 @@ message ExpandedDynamicSearchAdInfo { } // A hotel ad. -message HotelAdInfo {} +message HotelAdInfo { + +} // A Smart Shopping ad. -message ShoppingSmartAdInfo {} +message ShoppingSmartAdInfo { + +} // A standard Shopping ad. -message ShoppingProductAdInfo {} +message ShoppingProductAdInfo { + +} // A Shopping Comparison Listing ad. message ShoppingComparisonListingAdInfo { @@ -274,11 +278,15 @@ message ImageAdInfo { // Representation of video bumper in-stream ad format (very short in-stream // non-skippable video ad). -message VideoBumperInStreamAdInfo {} +message VideoBumperInStreamAdInfo { + +} // Representation of video non-skippable in-stream ad format (15 second // in-stream non-skippable video ad). -message VideoNonSkippableInStreamAdInfo {} +message VideoNonSkippableInStreamAdInfo { + +} // Representation of video TrueView in-stream ad format (ad shown during video // playback, often at beginning, which displays a skip button a few seconds into @@ -404,8 +412,7 @@ message LegacyResponsiveDisplayAdInfo { google.protobuf.StringValue square_marketing_image = 12; // Specifies which format the ad will be served in. Default is ALL_FORMATS. - google.ads.googleads.v1.enums.DisplayAdFormatSettingEnum - .DisplayAdFormatSetting format_setting = 13; + google.ads.googleads.v1.enums.DisplayAdFormatSettingEnum.DisplayAdFormatSetting format_setting = 13; // Prefix before price. E.g. 'as low as'. google.protobuf.StringValue price_prefix = 14; @@ -465,8 +472,7 @@ message LegacyAppInstallAdInfo { google.protobuf.StringValue app_id = 1; // The app store the mobile app is available in. - google.ads.googleads.v1.enums.LegacyAppInstallAdAppStoreEnum - .LegacyAppInstallAdAppStore app_store = 2; + google.ads.googleads.v1.enums.LegacyAppInstallAdAppStoreEnum.LegacyAppInstallAdAppStore app_store = 2; // The headline of the ad. google.protobuf.StringValue headline = 3; @@ -513,7 +519,7 @@ message ResponsiveDisplayAdInfo { // least 1 and max 5 headlines can be specified. repeated AdTextAsset descriptions = 7; - // Optional YouTube vidoes for the ad. A maximum of 5 videos can be specified. + // Optional YouTube videos for the ad. A maximum of 5 videos can be specified. repeated AdVideoAsset youtube_videos = 8; // The advertiser/brand name. Maximum display width is 25. @@ -547,8 +553,7 @@ message ResponsiveDisplayAdInfo { google.protobuf.StringValue promo_text = 15; // Specifies which format the ad will be served in. Default is ALL_FORMATS. - google.ads.googleads.v1.enums.DisplayAdFormatSettingEnum - .DisplayAdFormatSetting format_setting = 16; + google.ads.googleads.v1.enums.DisplayAdFormatSettingEnum.DisplayAdFormatSetting format_setting = 16; } // A generic type of display ad. The exact ad format is controlled by the @@ -556,8 +561,7 @@ message ResponsiveDisplayAdInfo { // need to be included with the ad. message DisplayUploadAdInfo { // The product type of this ad. See comments on the enum for details. - google.ads.googleads.v1.enums.DisplayUploadProductTypeEnum - .DisplayUploadProductType display_upload_product_type = 1; + google.ads.googleads.v1.enums.DisplayUploadProductTypeEnum.DisplayUploadProductType display_upload_product_type = 1; // The asset data that makes up the ad. oneof media_asset { diff --git a/third_party/googleapis/google/ads/googleads/v1/common/asset_types.proto b/third_party/googleapis/google/ads/googleads/v1/common/asset_types.proto index 7127dfbee..948a7d071 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/asset_types.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/asset_types.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,15 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.common; import "google/ads/googleads/v1/enums/mime_type.proto"; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; diff --git a/third_party/googleapis/google/ads/googleads/v1/common/bidding.proto b/third_party/googleapis/google/ads/googleads/v1/common/bidding.proto index d6b9f18f3..3d00cbacf 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/bidding.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/bidding.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,8 @@ package google.ads.googleads.v1.common; import "google/ads/googleads/v1/enums/page_one_promoted_strategy_goal.proto"; import "google/ads/googleads/v1/enums/target_impression_share_location.proto"; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; @@ -46,7 +45,9 @@ message Commission { // An automated bidding strategy that raises bids for clicks // that seem more likely to lead to a conversion and lowers // them for clicks where they seem less likely. -message EnhancedCpc {} +message EnhancedCpc { + +} // Manual click-based bidding where user pays per click. message ManualCpc { @@ -55,14 +56,20 @@ message ManualCpc { } // Manual impression-based bidding where user pays per thousand impressions. -message ManualCpm {} +message ManualCpm { + +} // View based bidding where user pays per video view. -message ManualCpv {} +message ManualCpv { + +} // An automated bidding strategy that sets bids to help get the most conversions // for your campaign while spending your budget. -message MaximizeConversions {} +message MaximizeConversions { + +} // An automated bidding strategy which tries to maximize conversion value // given a daily budget. @@ -77,11 +84,11 @@ message MaximizeConversionValue { // An automated bidding strategy which sets CPC bids to target impressions on // page one, or page one promoted slots on google.com. +// This strategy is deprecated. message PageOnePromoted { // The strategy goal of where impressions are desired to be shown on // search result pages. - google.ads.googleads.v1.enums.PageOnePromotedStrategyGoalEnum - .PageOnePromotedStrategyGoal strategy_goal = 1; + google.ads.googleads.v1.enums.PageOnePromotedStrategyGoalEnum.PageOnePromotedStrategyGoal strategy_goal = 1; // Maximum bid limit that can be set by the bid strategy. // The limit applies to all keywords managed by the strategy. @@ -126,7 +133,9 @@ message TargetCpa { // Target CPM (cost per thousand impressions) is an automated bidding strategy // that sets bids to optimize performance given the target CPM you set. -message TargetCpm {} +message TargetCpm { + +} // An automated bidding strategy that sets bids so that a certain percentage of // search ads are shown at the top of the first page (or other targeted @@ -134,8 +143,7 @@ message TargetCpm {} // Next Id = 4 message TargetImpressionShare { // The targeted location on the search results page. - google.ads.googleads.v1.enums.TargetImpressionShareLocationEnum - .TargetImpressionShareLocation location = 1; + google.ads.googleads.v1.enums.TargetImpressionShareLocationEnum.TargetImpressionShareLocation location = 1; // The desired fraction of ads to be shown in the targeted location in micros. // E.g. 1% equals 10,000. @@ -149,6 +157,7 @@ message TargetImpressionShare { // An automated bidding strategy that sets bids based on the target fraction of // auctions where the advertiser should outrank a specific competitor. +// This strategy is deprecated. message TargetOutrankShare { // The target fraction of auctions where the advertiser should outrank the // competitor. diff --git a/third_party/googleapis/google/ads/googleads/v1/common/click_location.proto b/third_party/googleapis/google/ads/googleads/v1/common/click_location.proto index 39076fd57..2e86246e5 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/click_location.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/click_location.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.common; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; diff --git a/third_party/googleapis/google/ads/googleads/v1/common/criteria.proto b/third_party/googleapis/google/ads/googleads/v1/common/criteria.proto index 1ae53f31d..29e8c0238 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/criteria.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/criteria.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -41,8 +40,8 @@ import "google/ads/googleads/v1/enums/product_type_level.proto"; import "google/ads/googleads/v1/enums/proximity_radius_units.proto"; import "google/ads/googleads/v1/enums/webpage_condition_operand.proto"; import "google/ads/googleads/v1/enums/webpage_condition_operator.proto"; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; @@ -61,8 +60,7 @@ message KeywordInfo { google.protobuf.StringValue text = 1; // The match type of the keyword. - google.ads.googleads.v1.enums.KeywordMatchTypeEnum.KeywordMatchType - match_type = 2; + google.ads.googleads.v1.enums.KeywordMatchTypeEnum.KeywordMatchType match_type = 2; } // A placement criterion. This can be used to modify bids for sites when @@ -89,10 +87,10 @@ message MobileApplicationInfo { // corresponding platform. // For iOS, this native identifier is the 9 digit string that appears at the // end of an App Store URL (e.g., "476943146" for "Flood-It! 2" whose App - // Store link is http://itunes.apple.com/us/app/flood-it!-2/id476943146). + // Store link is "http://itunes.apple.com/us/app/flood-it!-2/id476943146"). // For Android, this native identifier is the application's package name // (e.g., "com.labpixies.colordrips" for "Color Drips" given Google Play link - // https://play.google.com/store/apps/details?id=com.labpixies.colordrips). + // "https://play.google.com/store/apps/details?id=com.labpixies.colordrips"). // A well formed app id for Google Ads API would thus be "1-476943146" for iOS // and "2-com.labpixies.colordrips" for Android. // This field is required and must be set in CREATE operations. @@ -117,8 +115,7 @@ message DeviceInfo { // A preferred content criterion. message PreferredContentInfo { // Type of the preferred content. - google.ads.googleads.v1.enums.PreferredContentTypeEnum.PreferredContentType - type = 2; + google.ads.googleads.v1.enums.PreferredContentTypeEnum.PreferredContentType type = 2; } // A listing group criterion. @@ -231,8 +228,7 @@ message ListingCustomAttributeInfo { google.protobuf.StringValue value = 1; // Indicates the index of the custom attribute. - google.ads.googleads.v1.enums.ListingCustomAttributeIndexEnum - .ListingCustomAttributeIndex index = 2; + google.ads.googleads.v1.enums.ListingCustomAttributeIndexEnum.ListingCustomAttributeIndex index = 2; } // Bidding category of a product offer. @@ -240,7 +236,7 @@ message ProductBiddingCategoryInfo { // ID of the product bidding category. // // This ID is equivalent to the google_product_category ID as described in - // this article: https://support.google.com/merchants/answer/6324436. + // this article: https://support.google.com/merchants/answer/6324436 google.protobuf.Int64Value id = 1; // Two-letter upper-case country code of the product bidding category. It must @@ -248,8 +244,7 @@ message ProductBiddingCategoryInfo { google.protobuf.StringValue country_code = 2; // Level of the product bidding category. - google.ads.googleads.v1.enums.ProductBiddingCategoryLevelEnum - .ProductBiddingCategoryLevel level = 3; + google.ads.googleads.v1.enums.ProductBiddingCategoryLevelEnum.ProductBiddingCategoryLevel level = 3; } // Locality of a product offer. @@ -261,15 +256,13 @@ message ProductChannelInfo { // Availability of a product offer. message ProductChannelExclusivityInfo { // Value of the availability. - google.ads.googleads.v1.enums.ProductChannelExclusivityEnum - .ProductChannelExclusivity channel_exclusivity = 1; + google.ads.googleads.v1.enums.ProductChannelExclusivityEnum.ProductChannelExclusivity channel_exclusivity = 1; } // Condition of a product offer. message ProductConditionInfo { // Value of the condition. - google.ads.googleads.v1.enums.ProductConditionEnum.ProductCondition - condition = 1; + google.ads.googleads.v1.enums.ProductConditionEnum.ProductCondition condition = 1; } // Item id of a product offer. @@ -288,13 +281,14 @@ message ProductTypeInfo { } // Unknown listing dimension. -message UnknownListingDimensionInfo {} +message UnknownListingDimensionInfo { + +} // Criterion for hotel date selection (default dates vs. user selected). message HotelDateSelectionTypeInfo { // Type of the hotel date selection - google.ads.googleads.v1.enums.HotelDateSelectionTypeEnum - .HotelDateSelectionType type = 1; + google.ads.googleads.v1.enums.HotelDateSelectionTypeEnum.HotelDateSelectionType type = 1; } // Criterion for number of days prior to the stay the booking is being made. @@ -389,8 +383,7 @@ message IncomeRangeInfo { // A parental status criterion. message ParentalStatusInfo { // Type of the parental status. - google.ads.googleads.v1.enums.ParentalStatusTypeEnum.ParentalStatusType type = - 1; + google.ads.googleads.v1.enums.ParentalStatusTypeEnum.ParentalStatusType type = 1; } // A YouTube Video criterion. @@ -428,8 +421,7 @@ message ProximityInfo { google.protobuf.DoubleValue radius = 2; // The unit of measurement of the radius. Default is KILOMETERS. - google.ads.googleads.v1.enums.ProximityRadiusUnitsEnum.ProximityRadiusUnits - radius_units = 3; + google.ads.googleads.v1.enums.ProximityRadiusUnitsEnum.ProximityRadiusUnits radius_units = 3; // Full address. AddressInfo address = 4; @@ -540,13 +532,10 @@ message WebpageInfo { // Logical expression for targeting webpages of an advertiser's website. message WebpageConditionInfo { // Operand of webpage targeting condition. - google.ads.googleads.v1.enums.WebpageConditionOperandEnum - .WebpageConditionOperand operand = 1; + google.ads.googleads.v1.enums.WebpageConditionOperandEnum.WebpageConditionOperand operand = 1; // Operator of webpage targeting condition. - google.ads.googleads.v1.enums.WebpageConditionOperatorEnum - .WebpageConditionOperator - operator = 2; + google.ads.googleads.v1.enums.WebpageConditionOperatorEnum.WebpageConditionOperator operator = 2; // Argument of webpage targeting condition. google.protobuf.StringValue argument = 3; @@ -561,8 +550,7 @@ message OperatingSystemVersionInfo { // An app payment model criterion. message AppPaymentModelInfo { // Type of the app payment model. - google.ads.googleads.v1.enums.AppPaymentModelTypeEnum.AppPaymentModelType - type = 1; + google.ads.googleads.v1.enums.AppPaymentModelTypeEnum.AppPaymentModelType type = 1; } // A mobile device criterion. @@ -601,6 +589,5 @@ message LocationGroupInfo { // Unit of the radius, miles and meters supported currently. // This is required and must be set in CREATE operations. - google.ads.googleads.v1.enums.LocationGroupRadiusUnitsEnum - .LocationGroupRadiusUnits radius_units = 4; + google.ads.googleads.v1.enums.LocationGroupRadiusUnitsEnum.LocationGroupRadiusUnits radius_units = 4; } diff --git a/third_party/googleapis/google/ads/googleads/v1/common/criterion_category_availability.proto b/third_party/googleapis/google/ads/googleads/v1/common/criterion_category_availability.proto index 1b87d016b..28624e025 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/criterion_category_availability.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/criterion_category_availability.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -21,8 +20,8 @@ import "google/ads/googleads/v1/enums/advertising_channel_sub_type.proto"; import "google/ads/googleads/v1/enums/advertising_channel_type.proto"; import "google/ads/googleads/v1/enums/criterion_category_channel_availability_mode.proto"; import "google/ads/googleads/v1/enums/criterion_category_locale_availability_mode.proto"; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; @@ -53,16 +52,13 @@ message CriterionCategoryChannelAvailability { // CHANNEL_TYPE_AND_SUBTYPES (advertising_channel_type, // advertising_channel_sub_type, and include_default_channel_sub_type will all // be set). - google.ads.googleads.v1.enums.CriterionCategoryChannelAvailabilityModeEnum - .CriterionCategoryChannelAvailabilityMode availability_mode = 1; + google.ads.googleads.v1.enums.CriterionCategoryChannelAvailabilityModeEnum.CriterionCategoryChannelAvailabilityMode availability_mode = 1; // Channel type the category is available to. - google.ads.googleads.v1.enums.AdvertisingChannelTypeEnum - .AdvertisingChannelType advertising_channel_type = 2; + google.ads.googleads.v1.enums.AdvertisingChannelTypeEnum.AdvertisingChannelType advertising_channel_type = 2; // Channel subtypes under the channel type the category is available to. - repeated google.ads.googleads.v1.enums.AdvertisingChannelSubTypeEnum - .AdvertisingChannelSubType advertising_channel_sub_type = 3; + repeated google.ads.googleads.v1.enums.AdvertisingChannelSubTypeEnum.AdvertisingChannelSubType advertising_channel_sub_type = 3; // Whether default channel sub type is included. For example, // advertising_channel_type being DISPLAY and include_default_channel_sub_type @@ -77,8 +73,7 @@ message CriterionCategoryLocaleAvailability { // language will be empty), COUNTRY (only country will be set), LANGUAGE (only // language wil be set), COUNTRY_AND_LANGUAGE (both country and language will // be set). - google.ads.googleads.v1.enums.CriterionCategoryLocaleAvailabilityModeEnum - .CriterionCategoryLocaleAvailabilityMode availability_mode = 1; + google.ads.googleads.v1.enums.CriterionCategoryLocaleAvailabilityModeEnum.CriterionCategoryLocaleAvailabilityMode availability_mode = 1; // Code of the country. google.protobuf.StringValue country_code = 2; diff --git a/third_party/googleapis/google/ads/googleads/v1/common/custom_parameter.proto b/third_party/googleapis/google/ads/googleads/v1/common/custom_parameter.proto index 4fc8d0e6c..e2df7c6d4 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/custom_parameter.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/custom_parameter.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.common; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; diff --git a/third_party/googleapis/google/ads/googleads/v1/common/dates.proto b/third_party/googleapis/google/ads/googleads/v1/common/dates.proto index ecc33db4e..4d6415f05 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/dates.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/dates.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.common; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; @@ -33,9 +32,9 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Common"; // A date range. message DateRange { - // The start date, in yyyy-mm-dd format. + // The start date, in yyyy-mm-dd format. This date is inclusive. google.protobuf.StringValue start_date = 1; - // The end date, in yyyy-mm-dd format. + // The end date, in yyyy-mm-dd format. This date is inclusive. google.protobuf.StringValue end_date = 2; } diff --git a/third_party/googleapis/google/ads/googleads/v1/common/explorer_auto_optimizer_setting.proto b/third_party/googleapis/google/ads/googleads/v1/common/explorer_auto_optimizer_setting.proto index a8fcd1bf4..f3a314dab 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/explorer_auto_optimizer_setting.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/explorer_auto_optimizer_setting.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.common; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; @@ -31,9 +30,9 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Common"; // Proto file describing ExplorerAutoOptimizerSetting -// Settings for the -// -// Display Campaign Optimizer, initially termed "Explorer". +// Settings for the Display Campaign Optimizer, initially named "Explorer". +// Learn more about +// [automatic targeting](https://support.google.com/google-ads/answer/190596). message ExplorerAutoOptimizerSetting { // Indicates whether the optimizer is turned on. google.protobuf.BoolValue opt_in = 1; diff --git a/third_party/googleapis/google/ads/googleads/v1/common/extensions.proto b/third_party/googleapis/google/ads/googleads/v1/common/extensions.proto index becf03434..b9f6f31d4 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/extensions.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/extensions.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -26,8 +25,8 @@ import "google/ads/googleads/v1/enums/price_extension_price_unit.proto"; import "google/ads/googleads/v1/enums/price_extension_type.proto"; import "google/ads/googleads/v1/enums/promotion_extension_discount_modifier.proto"; import "google/ads/googleads/v1/enums/promotion_extension_occasion.proto"; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; @@ -100,8 +99,7 @@ message CallFeedItem { // Enum value that indicates whether this call extension uses its own call // conversion setting (or just have call conversion disabled), or following // the account level setting. - google.ads.googleads.v1.enums.CallConversionReportingStateEnum - .CallConversionReportingState call_conversion_reporting_state = 6; + google.ads.googleads.v1.enums.CallConversionReportingStateEnum.CallConversionReportingState call_conversion_reporting_state = 6; } // Represents a callout extension. @@ -196,12 +194,10 @@ message TextMessageFeedItem { // Represents a Price extension. message PriceFeedItem { // Price extension type of this extension. - google.ads.googleads.v1.enums.PriceExtensionTypeEnum.PriceExtensionType type = - 1; + google.ads.googleads.v1.enums.PriceExtensionTypeEnum.PriceExtensionType type = 1; // Price qualifier for all offers of this price extension. - google.ads.googleads.v1.enums.PriceExtensionPriceQualifierEnum - .PriceExtensionPriceQualifier price_qualifier = 2; + google.ads.googleads.v1.enums.PriceExtensionPriceQualifierEnum.PriceExtensionPriceQualifier price_qualifier = 2; // Tracking URL template for all offers of this price extension. google.protobuf.StringValue tracking_url_template = 3; @@ -229,8 +225,7 @@ message PriceOffer { Money price = 3; // Price unit for this offer. - google.ads.googleads.v1.enums.PriceExtensionPriceUnitEnum - .PriceExtensionPriceUnit unit = 4; + google.ads.googleads.v1.enums.PriceExtensionPriceUnitEnum.PriceExtensionPriceUnit unit = 4; // A list of possible final URLs after all cross domain redirects. repeated google.protobuf.StringValue final_urls = 5; @@ -246,8 +241,7 @@ message PromotionFeedItem { google.protobuf.StringValue promotion_target = 1; // Enum that modifies the qualification of the discount. - google.ads.googleads.v1.enums.PromotionExtensionDiscountModifierEnum - .PromotionExtensionDiscountModifier discount_modifier = 2; + google.ads.googleads.v1.enums.PromotionExtensionDiscountModifierEnum.PromotionExtensionDiscountModifier discount_modifier = 2; // Start date of when the promotion is eligible to be redeemed. google.protobuf.StringValue promotion_start_date = 7; @@ -258,8 +252,7 @@ message PromotionFeedItem { // The occasion the promotion was intended for. // If an occasion is set, the redemption window will need to fall within // the date range associated with the occasion. - google.ads.googleads.v1.enums.PromotionExtensionOccasionEnum - .PromotionExtensionOccasion occasion = 9; + google.ads.googleads.v1.enums.PromotionExtensionOccasionEnum.PromotionExtensionOccasion occasion = 9; // A list of possible final URLs after all cross domain redirects. // This field is required. diff --git a/third_party/googleapis/google/ads/googleads/v1/common/feed_common.proto b/third_party/googleapis/google/ads/googleads/v1/common/feed_common.proto index 8b67f2b3a..3a4dd3263 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/feed_common.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/feed_common.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.common; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; diff --git a/third_party/googleapis/google/ads/googleads/v1/common/final_app_url.proto b/third_party/googleapis/google/ads/googleads/v1/common/final_app_url.proto index 9c6375a50..169afff7f 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/final_app_url.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/final_app_url.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,15 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.common; import "google/ads/googleads/v1/enums/app_url_operating_system_type.proto"; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; @@ -35,8 +34,7 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Common"; // A URL for deep linking into an app for the given operating system. message FinalAppUrl { // The operating system targeted by this URL. Required. - google.ads.googleads.v1.enums.AppUrlOperatingSystemTypeEnum - .AppUrlOperatingSystemType os_type = 1; + google.ads.googleads.v1.enums.AppUrlOperatingSystemTypeEnum.AppUrlOperatingSystemType os_type = 1; // The app deep link URL. Deep links specify a location in an app that // corresponds to the content you'd like to show, and should be of the form diff --git a/third_party/googleapis/google/ads/googleads/v1/common/frequency_cap.proto b/third_party/googleapis/google/ads/googleads/v1/common/frequency_cap.proto index 4d877e9f9..aaef68d67 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/frequency_cap.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/frequency_cap.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,8 +19,8 @@ package google.ads.googleads.v1.common; import "google/ads/googleads/v1/enums/frequency_cap_event_type.proto"; import "google/ads/googleads/v1/enums/frequency_cap_level.proto"; import "google/ads/googleads/v1/enums/frequency_cap_time_unit.proto"; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; @@ -50,16 +49,13 @@ message FrequencyCapEntry { message FrequencyCapKey { // The level on which the cap is to be applied (e.g. ad group ad, ad group). // The cap is applied to all the entities of this level. - google.ads.googleads.v1.enums.FrequencyCapLevelEnum.FrequencyCapLevel level = - 1; + google.ads.googleads.v1.enums.FrequencyCapLevelEnum.FrequencyCapLevel level = 1; // The type of event that the cap applies to (e.g. impression). - google.ads.googleads.v1.enums.FrequencyCapEventTypeEnum.FrequencyCapEventType - event_type = 3; + google.ads.googleads.v1.enums.FrequencyCapEventTypeEnum.FrequencyCapEventType event_type = 3; // Unit of time the cap is defined at (e.g. day, week). - google.ads.googleads.v1.enums.FrequencyCapTimeUnitEnum.FrequencyCapTimeUnit - time_unit = 2; + google.ads.googleads.v1.enums.FrequencyCapTimeUnitEnum.FrequencyCapTimeUnit time_unit = 2; // Number of time units the cap lasts. google.protobuf.Int32Value time_length = 4; diff --git a/third_party/googleapis/google/ads/googleads/v1/common/keyword_plan_common.proto b/third_party/googleapis/google/ads/googleads/v1/common/keyword_plan_common.proto index 15e989995..5afc324cf 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/keyword_plan_common.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/keyword_plan_common.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,15 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.common; import "google/ads/googleads/v1/enums/keyword_plan_competition_level.proto"; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; @@ -38,6 +37,5 @@ message KeywordPlanHistoricalMetrics { google.protobuf.Int64Value avg_monthly_searches = 1; // The competition level for the query. - google.ads.googleads.v1.enums.KeywordPlanCompetitionLevelEnum - .KeywordPlanCompetitionLevel competition = 2; + google.ads.googleads.v1.enums.KeywordPlanCompetitionLevelEnum.KeywordPlanCompetitionLevel competition = 2; } diff --git a/third_party/googleapis/google/ads/googleads/v1/common/matching_function.proto b/third_party/googleapis/google/ads/googleads/v1/common/matching_function.proto index c79d5e0aa..4ba7f5151 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/matching_function.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/matching_function.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,8 @@ package google.ads.googleads.v1.common; import "google/ads/googleads/v1/enums/matching_function_context_type.proto"; import "google/ads/googleads/v1/enums/matching_function_operator.proto"; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; @@ -40,15 +39,15 @@ message MatchingFunction { // String representation of the Function. // // Examples: - // 1) IDENTITY(true) or IDENTITY(false). All or none feed items serve. - // 2) EQUALS(CONTEXT.DEVICE,"Mobile") - // 3) IN(FEED_ITEM_ID,{1000001,1000002,1000003}) - // 4) CONTAINS_ANY(FeedAttribute[12345678,0],{"Mars cruise","Venus cruise"}) - // 5) AND(IN(FEED_ITEM_ID,{10001,10002}),EQUALS(CONTEXT.DEVICE,"Mobile")) - // See // - // https: - // //developers.google.com/adwords/api/docs/guides/feed-matching-functions + // 1. IDENTITY(true) or IDENTITY(false). All or no feed items served. + // 2. EQUALS(CONTEXT.DEVICE,"Mobile") + // 3. IN(FEED_ITEM_ID,{1000001,1000002,1000003}) + // 4. CONTAINS_ANY(FeedAttribute[12345678,0],{"Mars cruise","Venus cruise"}) + // 5. AND(IN(FEED_ITEM_ID,{10001,10002}),EQUALS(CONTEXT.DEVICE,"Mobile")) + // + // For more details, visit + // https://developers.google.com/adwords/api/docs/guides/feed-matching-functions // // Note that because multiple strings may represent the same underlying // function (whitespace and single versus double quotation marks, for @@ -57,9 +56,7 @@ message MatchingFunction { google.protobuf.StringValue function_string = 1; // Operator for a function. - google.ads.googleads.v1.enums.MatchingFunctionOperatorEnum - .MatchingFunctionOperator - operator = 4; + google.ads.googleads.v1.enums.MatchingFunctionOperatorEnum.MatchingFunctionOperator operator = 4; // The operands on the left hand side of the equation. This is also the // operand to be used for single operand expressions such as NOT. @@ -109,8 +106,7 @@ message Operand { // An operand in a function referring to a value in the request context. message RequestContextOperand { // Type of value to be referred in the request context. - google.ads.googleads.v1.enums.MatchingFunctionContextTypeEnum - .MatchingFunctionContextType context_type = 1; + google.ads.googleads.v1.enums.MatchingFunctionContextTypeEnum.MatchingFunctionContextType context_type = 1; } // Different operands that can be used in a matching function. Required. diff --git a/third_party/googleapis/google/ads/googleads/v1/common/metrics.proto b/third_party/googleapis/google/ads/googleads/v1/common/metrics.proto index 139e77a46..9cb045165 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/metrics.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/metrics.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,8 @@ package google.ads.googleads.v1.common; import "google/ads/googleads/v1/enums/interaction_event_type.proto"; import "google/ads/googleads/v1/enums/quality_score_bucket.proto"; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; @@ -94,8 +93,7 @@ message Metrics { // The value of all conversions from interactions divided by the total number // of interactions. - google.protobuf.DoubleValue - all_conversions_from_interactions_value_per_interaction = 67; + google.protobuf.DoubleValue all_conversions_from_interactions_value_per_interaction = 67; // The number of times people clicked a link to view a store's menu after // clicking an ad. @@ -232,8 +230,7 @@ message Metrics { // The value of conversions from interactions divided by the number of ad // interactions. This only includes conversion actions which // include_in_conversions_metric attribute is set to true. - google.protobuf.DoubleValue - conversions_from_interactions_value_per_interaction = 72; + google.protobuf.DoubleValue conversions_from_interactions_value_per_interaction = 72; // The number of conversions. This only includes conversion actions which // include_in_conversions_metric attribute is set to true. @@ -254,8 +251,7 @@ message Metrics { // The cost of ad interactions divided by current model attributed // conversions. This only includes conversion actions which // include_in_conversions_metric attribute is set to true. - google.protobuf.DoubleValue cost_per_current_model_attributed_conversion = - 106; + google.protobuf.DoubleValue cost_per_current_model_attributed_conversion = 106; // Conversions from when a customer clicks on a Google Ads ad on one device, // then converts on a different device or browser. @@ -275,15 +271,12 @@ message Metrics { // number of ad interactions (such as clicks for text ads or views for video // ads). This only includes conversion actions which // include_in_conversions_metric attribute is set to true. - google.protobuf.DoubleValue - current_model_attributed_conversions_from_interactions_rate = 102; + google.protobuf.DoubleValue current_model_attributed_conversions_from_interactions_rate = 102; // The value of current model attributed conversions from interactions divided // by the number of ad interactions. This only includes conversion actions // which include_in_conversions_metric attribute is set to true. - google.protobuf.DoubleValue - current_model_attributed_conversions_from_interactions_value_per_interaction = - 103; + google.protobuf.DoubleValue current_model_attributed_conversions_from_interactions_value_per_interaction = 103; // The total value of current model attributed conversions. This only includes // conversion actions which include_in_conversions_metric attribute is set to @@ -293,8 +286,7 @@ message Metrics { // The value of current model attributed conversions divided by the cost of ad // interactions. This only includes conversion actions which // include_in_conversions_metric attribute is set to true. - google.protobuf.DoubleValue - current_model_attributed_conversions_value_per_cost = 105; + google.protobuf.DoubleValue current_model_attributed_conversions_value_per_cost = 105; // How often people engage with your ad after it's shown to them. This is the // number of ad expansions divided by the number of times your ad is shown. @@ -309,19 +301,16 @@ message Metrics { google.protobuf.DoubleValue hotel_average_lead_value_micros = 75; // The creative historical quality score. - google.ads.googleads.v1.enums.QualityScoreBucketEnum.QualityScoreBucket - historical_creative_quality_score = 80; + google.ads.googleads.v1.enums.QualityScoreBucketEnum.QualityScoreBucket historical_creative_quality_score = 80; // The quality of historical landing page experience. - google.ads.googleads.v1.enums.QualityScoreBucketEnum.QualityScoreBucket - historical_landing_page_quality_score = 81; + google.ads.googleads.v1.enums.QualityScoreBucketEnum.QualityScoreBucket historical_landing_page_quality_score = 81; // The historical quality score. google.protobuf.Int64Value historical_quality_score = 82; // The historical search predicted click through rate (CTR). - google.ads.googleads.v1.enums.QualityScoreBucketEnum.QualityScoreBucket - historical_search_predicted_ctr = 83; + google.ads.googleads.v1.enums.QualityScoreBucketEnum.QualityScoreBucket historical_search_predicted_ctr = 83; // The number of times the ad was forwarded to someone else as a message. google.protobuf.Int64Value gmail_forwards = 85; @@ -357,8 +346,7 @@ message Metrics { google.protobuf.Int64Value interactions = 39; // The types of payable and free interactions. - repeated google.ads.googleads.v1.enums.InteractionEventTypeEnum - .InteractionEventType interaction_event_types = 100; + repeated google.ads.googleads.v1.enums.InteractionEventTypeEnum.InteractionEventType interaction_event_types = 100; // The percentage of clicks filtered out of your total number of clicks // (filtered + non-filtered clicks) during the reporting period. @@ -418,16 +406,15 @@ message Metrics { // The percentage of the customer's Shopping or Search ad impressions that are // shown in the most prominent Shopping position. See - // this Merchant - // Center article for details. Any value below 0.1 is reported as 0.0999. + // https://support.google.com/google-ads/answer/7501826 + // for details. Any value below 0.1 is reported as 0.0999. google.protobuf.DoubleValue search_absolute_top_impression_share = 78; // The number estimating how often your ad wasn't the very first ad above the // organic search results due to a low budget. Note: Search // budget lost absolute top impression share is reported in the range of 0 to // 0.9. Any value above 0.9 is reported as 0.9001. - google.protobuf.DoubleValue search_budget_lost_absolute_top_impression_share = - 88; + google.protobuf.DoubleValue search_budget_lost_absolute_top_impression_share = 88; // The estimated percent of times that your ad was eligible to show on the // Search Network but didn't because your budget was too low. Note: Search @@ -465,8 +452,7 @@ message Metrics { // organic search results due to poor Ad Rank. // Note: Search rank lost absolute top impression share is reported in the // range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. - google.protobuf.DoubleValue search_rank_lost_absolute_top_impression_share = - 90; + google.protobuf.DoubleValue search_rank_lost_absolute_top_impression_share = 90; // The estimated percentage of impressions on the Search Network // that your ads didn't receive due to poor Ad Rank. @@ -497,8 +483,7 @@ message Metrics { // The percentage of ad clicks to Accelerated Mobile Pages (AMP) landing pages // that reach a valid AMP page. - google.protobuf.DoubleValue valid_accelerated_mobile_pages_clicks_percentage = - 108; + google.protobuf.DoubleValue valid_accelerated_mobile_pages_clicks_percentage = 108; // The value of all conversions divided by the number of all conversions. google.protobuf.DoubleValue value_per_all_conversions = 52; @@ -511,8 +496,7 @@ message Metrics { // The value of current model attributed conversions divided by the number of // the conversions. This only includes conversion actions which // include_in_conversions_metric attribute is set to true. - google.protobuf.DoubleValue value_per_current_model_attributed_conversion = - 94; + google.protobuf.DoubleValue value_per_current_model_attributed_conversion = 94; // Percentage of impressions where the viewer watched all of your video. google.protobuf.DoubleValue video_quartile_100_rate = 54; diff --git a/third_party/googleapis/google/ads/googleads/v1/common/policy.proto b/third_party/googleapis/google/ads/googleads/v1/common/policy.proto index 5fbbb2991..34699ef10 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/policy.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/policy.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,8 +19,8 @@ package google.ads.googleads.v1.common; import "google/ads/googleads/v1/enums/policy_topic_entry_type.proto"; import "google/ads/googleads/v1/enums/policy_topic_evidence_destination_mismatch_url_type.proto"; import "google/ads/googleads/v1/enums/policy_topic_evidence_destination_not_working_device.proto"; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; @@ -90,8 +89,7 @@ message PolicyTopicEntry { google.protobuf.StringValue topic = 1; // Describes the negative or positive effect this policy will have on serving. - google.ads.googleads.v1.enums.PolicyTopicEntryTypeEnum.PolicyTopicEntryType - type = 2; + google.ads.googleads.v1.enums.PolicyTopicEntryTypeEnum.PolicyTopicEntryType type = 2; // Additional information that explains policy finding // (e.g. the brand name for a trademark finding). @@ -129,9 +127,7 @@ message PolicyTopicEvidence { // Evidence of mismatches between the URLs of a resource. message DestinationMismatch { // The set of URLs that did not match each other. - repeated google.ads.googleads.v1.enums - .PolicyTopicEvidenceDestinationMismatchUrlTypeEnum - .PolicyTopicEvidenceDestinationMismatchUrlType url_types = 1; + repeated google.ads.googleads.v1.enums.PolicyTopicEvidenceDestinationMismatchUrlTypeEnum.PolicyTopicEvidenceDestinationMismatchUrlType url_types = 1; } // Evidence details when the destination is returning an HTTP error @@ -141,9 +137,7 @@ message PolicyTopicEvidence { google.protobuf.StringValue expanded_url = 3; // The type of device that failed to load the URL. - google.ads.googleads.v1.enums - .PolicyTopicEvidenceDestinationNotWorkingDeviceEnum - .PolicyTopicEvidenceDestinationNotWorkingDevice device = 4; + google.ads.googleads.v1.enums.PolicyTopicEvidenceDestinationNotWorkingDeviceEnum.PolicyTopicEvidenceDestinationNotWorkingDevice device = 4; // The time the URL was last checked. // The format is "YYYY-MM-DD HH:MM:SS". @@ -192,7 +186,9 @@ message PolicyTopicConstraint { // Indicates that a policy topic was constrained due to disapproval of the // website for reseller purposes. - message ResellerConstraint {} + message ResellerConstraint { + + } // Indicates that a resource's ability to serve in a particular country is // constrained. diff --git a/third_party/googleapis/google/ads/googleads/v1/common/real_time_bidding_setting.proto b/third_party/googleapis/google/ads/googleads/v1/common/real_time_bidding_setting.proto index 58118f0c9..089add795 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/real_time_bidding_setting.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/real_time_bidding_setting.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.common; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; diff --git a/third_party/googleapis/google/ads/googleads/v1/common/segments.proto b/third_party/googleapis/google/ads/googleads/v1/common/segments.proto index 2b07813da..2f3d30d6c 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/segments.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/segments.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -37,8 +36,8 @@ import "google/ads/googleads/v1/enums/product_condition.proto"; import "google/ads/googleads/v1/enums/search_engine_results_page_type.proto"; import "google/ads/googleads/v1/enums/search_term_match_type.proto"; import "google/ads/googleads/v1/enums/slot.proto"; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; @@ -54,8 +53,7 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Common"; // Segment only fields. message Segments { // Ad network type. - google.ads.googleads.v1.enums.AdNetworkTypeEnum.AdNetworkType - ad_network_type = 3; + google.ads.googleads.v1.enums.AdNetworkTypeEnum.AdNetworkType ad_network_type = 3; // Click type. google.ads.googleads.v1.enums.ClickTypeEnum.ClickType click_type = 26; @@ -64,8 +62,7 @@ message Segments { google.protobuf.StringValue conversion_action = 52; // Conversion action category. - google.ads.googleads.v1.enums.ConversionActionCategoryEnum - .ConversionActionCategory conversion_action_category = 53; + google.ads.googleads.v1.enums.ConversionActionCategoryEnum.ConversionActionCategory conversion_action_category = 53; // Conversion action name. google.protobuf.StringValue conversion_action_name = 54; @@ -78,18 +75,15 @@ message Segments { google.protobuf.BoolValue conversion_adjustment = 27; // Conversion attribution event type. - google.ads.googleads.v1.enums.ConversionAttributionEventTypeEnum - .ConversionAttributionEventType conversion_attribution_event_type = 2; + google.ads.googleads.v1.enums.ConversionAttributionEventTypeEnum.ConversionAttributionEventType conversion_attribution_event_type = 2; // An enum value representing the number of days between the impression and // the conversion. - google.ads.googleads.v1.enums.ConversionLagBucketEnum.ConversionLagBucket - conversion_lag_bucket = 50; + google.ads.googleads.v1.enums.ConversionLagBucketEnum.ConversionLagBucket conversion_lag_bucket = 50; // An enum value representing the number of days between the impression and // the conversion or between the impression and adjustments to the conversion. - google.ads.googleads.v1.enums.ConversionOrAdjustmentLagBucketEnum - .ConversionOrAdjustmentLagBucket conversion_or_adjustment_lag_bucket = 51; + google.ads.googleads.v1.enums.ConversionOrAdjustmentLagBucketEnum.ConversionOrAdjustmentLagBucket conversion_or_adjustment_lag_bucket = 51; // Date to which metrics apply. // yyyy-MM-dd format, e.g., 2018-04-17. @@ -102,8 +96,7 @@ message Segments { google.ads.googleads.v1.enums.DeviceEnum.Device device = 1; // External conversion source. - google.ads.googleads.v1.enums.ExternalConversionSourceEnum - .ExternalConversionSource external_conversion_source = 55; + google.ads.googleads.v1.enums.ExternalConversionSourceEnum.ExternalConversionSource external_conversion_source = 55; // Resource name of the geo target constant that represents an airport. google.protobuf.StringValue geo_target_airport = 65; @@ -146,8 +139,7 @@ message Segments { google.protobuf.StringValue hotel_check_in_date = 8; // Hotel check-in day of week. - google.ads.googleads.v1.enums.DayOfWeekEnum.DayOfWeek - hotel_check_in_day_of_week = 9; + google.ads.googleads.v1.enums.DayOfWeekEnum.DayOfWeek hotel_check_in_day_of_week = 9; // Hotel city. google.protobuf.StringValue hotel_city = 10; @@ -159,8 +151,7 @@ message Segments { google.protobuf.StringValue hotel_country = 12; // Hotel date selection type. - google.ads.googleads.v1.enums.HotelDateSelectionTypeEnum - .HotelDateSelectionType hotel_date_selection_type = 13; + google.ads.googleads.v1.enums.HotelDateSelectionTypeEnum.HotelDateSelectionType hotel_date_selection_type = 13; // Hotel length of stay. google.protobuf.Int32Value hotel_length_of_stay = 14; @@ -169,8 +160,7 @@ message Segments { google.protobuf.StringValue hotel_rate_rule_id = 73; // Hotel rate type. - google.ads.googleads.v1.enums.HotelRateTypeEnum.HotelRateType - hotel_rate_type = 74; + google.ads.googleads.v1.enums.HotelRateTypeEnum.HotelRateType hotel_rate_type = 74; // Hotel state. google.protobuf.StringValue hotel_state = 15; @@ -197,8 +187,7 @@ message Segments { google.protobuf.StringValue partner_hotel_id = 19; // Placeholder type. This is only used with feed item metrics. - google.ads.googleads.v1.enums.PlaceholderTypeEnum.PlaceholderType - placeholder_type = 20; + google.ads.googleads.v1.enums.PlaceholderTypeEnum.PlaceholderType placeholder_type = 20; // Aggregator ID of the product. google.protobuf.UInt64Value product_aggregator_id = 28; @@ -222,16 +211,13 @@ message Segments { google.protobuf.StringValue product_brand = 29; // Channel of the product. - google.ads.googleads.v1.enums.ProductChannelEnum.ProductChannel - product_channel = 30; + google.ads.googleads.v1.enums.ProductChannelEnum.ProductChannel product_channel = 30; // Channel exclusivity of the product. - google.ads.googleads.v1.enums.ProductChannelExclusivityEnum - .ProductChannelExclusivity product_channel_exclusivity = 31; + google.ads.googleads.v1.enums.ProductChannelExclusivityEnum.ProductChannelExclusivity product_channel_exclusivity = 31; // Condition of the product. - google.ads.googleads.v1.enums.ProductConditionEnum.ProductCondition - product_condition = 32; + google.ads.googleads.v1.enums.ProductConditionEnum.ProductCondition product_condition = 32; // Resource name of the geo target constant for the country of sale of the // product. @@ -288,12 +274,10 @@ message Segments { google.protobuf.StringValue quarter = 21; // Type of the search engine results page. - google.ads.googleads.v1.enums.SearchEngineResultsPageTypeEnum - .SearchEngineResultsPageType search_engine_results_page_type = 70; + google.ads.googleads.v1.enums.SearchEngineResultsPageTypeEnum.SearchEngineResultsPageType search_engine_results_page_type = 70; // Match type of the keyword that triggered the ad, including variants. - google.ads.googleads.v1.enums.SearchTermMatchTypeEnum.SearchTermMatchType - search_term_match_type = 22; + google.ads.googleads.v1.enums.SearchTermMatchTypeEnum.SearchTermMatchType search_term_match_type = 22; // Position of the ad. google.ads.googleads.v1.enums.SlotEnum.Slot slot = 23; diff --git a/third_party/googleapis/google/ads/googleads/v1/common/simulation.proto b/third_party/googleapis/google/ads/googleads/v1/common/simulation.proto index b56c58633..3d7b829ee 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/simulation.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/simulation.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.common; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; @@ -61,9 +60,11 @@ message BidModifierSimulationPoint { google.protobuf.DoubleValue bid_modifier = 1; // Projected number of biddable conversions. + // Only search advertising channel type supports this field. google.protobuf.DoubleValue biddable_conversions = 2; // Projected total value of biddable conversions. + // Only search advertising channel type supports this field. google.protobuf.DoubleValue biddable_conversions_value = 3; // Projected number of clicks. @@ -76,12 +77,15 @@ message BidModifierSimulationPoint { google.protobuf.Int64Value impressions = 6; // Projected number of top slot impressions. + // Only search advertising channel type supports this field. google.protobuf.Int64Value top_slot_impressions = 7; // Projected number of biddable conversions for the parent resource. + // Only search advertising channel type supports this field. google.protobuf.DoubleValue parent_biddable_conversions = 8; // Projected total value of biddable conversions for the parent resource. + // Only search advertising channel type supports this field. google.protobuf.DoubleValue parent_biddable_conversions_value = 9; // Projected number of clicks for the parent resource. @@ -94,6 +98,7 @@ message BidModifierSimulationPoint { google.protobuf.Int64Value parent_impressions = 12; // Projected number of top slot impressions for the parent resource. + // Only search advertising channel type supports this field. google.protobuf.Int64Value parent_top_slot_impressions = 13; } @@ -118,7 +123,7 @@ message CpcBidSimulationPoint { google.protobuf.Int64Value impressions = 6; // Projected number of top slot impressions. - // Display network does not support this field at the ad group level. + // Only search advertising channel type supports this field. google.protobuf.Int64Value top_slot_impressions = 7; } @@ -155,6 +160,6 @@ message TargetCpaSimulationPoint { google.protobuf.Int64Value impressions = 6; // Projected number of top slot impressions. - // Display network does not support this field at the ad group level. + // Only search advertising channel type supports this field. google.protobuf.Int64Value top_slot_impressions = 7; } diff --git a/third_party/googleapis/google/ads/googleads/v1/common/tag_snippet.proto b/third_party/googleapis/google/ads/googleads/v1/common/tag_snippet.proto index 4d7912063..ff1533d33 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/tag_snippet.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/tag_snippet.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,8 @@ package google.ads.googleads.v1.common; import "google/ads/googleads/v1/enums/tracking_code_page_format.proto"; import "google/ads/googleads/v1/enums/tracking_code_type.proto"; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; @@ -40,8 +39,7 @@ message TagSnippet { // The format of the web page where the tracking tag and snippet will be // installed, e.g. HTML. - google.ads.googleads.v1.enums.TrackingCodePageFormatEnum - .TrackingCodePageFormat page_format = 2; + google.ads.googleads.v1.enums.TrackingCodePageFormatEnum.TrackingCodePageFormat page_format = 2; // The site tag that adds visitors to your basic remarketing lists and sets // new cookies on your domain. diff --git a/third_party/googleapis/google/ads/googleads/v1/common/targeting_setting.proto b/third_party/googleapis/google/ads/googleads/v1/common/targeting_setting.proto index fd794ec57..8a8ed29d7 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/targeting_setting.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/targeting_setting.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,15 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.common; import "google/ads/googleads/v1/enums/targeting_dimension.proto"; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; @@ -32,9 +31,9 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Common"; // Proto file describing TargetingSetting -// Settings for the -// -// targeting related features, at Campaign and AdGroup level. +// Settings for the targeting-related features, at the campaign and ad group +// levels. For more details about the targeting setting, visit +// https://support.google.com/google-ads/answer/7365594 message TargetingSetting { // The per-targeting-dimension setting to restrict the reach of your campaign // or ad group. @@ -44,14 +43,13 @@ message TargetingSetting { // The list of per-targeting-dimension targeting settings. message TargetRestriction { // The targeting dimension that these settings apply to. - google.ads.googleads.v1.enums.TargetingDimensionEnum.TargetingDimension - targeting_dimension = 1; + google.ads.googleads.v1.enums.TargetingDimensionEnum.TargetingDimension targeting_dimension = 1; // Indicates whether to restrict your ads to show only for the criteria you // have selected for this targeting_dimension, or to target all values for // this targeting_dimension and show ads based on your targeting in other - // TargetingDimensions. A value of 'true' means that these criteria will only - // apply bid modifiers, and not affect targeting. A value of 'false' means + // TargetingDimensions. A value of `true` means that these criteria will only + // apply bid modifiers, and not affect targeting. A value of `false` means // that these criteria will restrict targeting as well as applying bid // modifiers. google.protobuf.BoolValue bid_only = 2; diff --git a/third_party/googleapis/google/ads/googleads/v1/common/text_label.proto b/third_party/googleapis/google/ads/googleads/v1/common/text_label.proto index f5cd3f7be..017988a88 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/text_label.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/text_label.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.common; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; diff --git a/third_party/googleapis/google/ads/googleads/v1/common/url_collection.proto b/third_party/googleapis/google/ads/googleads/v1/common/url_collection.proto index 622fdc3b7..8be5ff27e 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/url_collection.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/url_collection.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.common; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; diff --git a/third_party/googleapis/google/ads/googleads/v1/common/user_lists.proto b/third_party/googleapis/google/ads/googleads/v1/common/user_lists.proto index 96e6d70fa..f38c8a085 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/user_lists.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/user_lists.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -26,8 +25,8 @@ import "google/ads/googleads/v1/enums/user_list_number_rule_item_operator.proto" import "google/ads/googleads/v1/enums/user_list_prepopulation_status.proto"; import "google/ads/googleads/v1/enums/user_list_rule_type.proto"; import "google/ads/googleads/v1/enums/user_list_string_rule_item_operator.proto"; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Common"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/common;common"; @@ -64,13 +63,11 @@ message CrmBasedUserListInfo { // Matching key type of the list. // Mixed data types are not allowed on the same list. // This field is required for an ADD operation. - google.ads.googleads.v1.enums.CustomerMatchUploadKeyTypeEnum - .CustomerMatchUploadKeyType upload_key_type = 2; + google.ads.googleads.v1.enums.CustomerMatchUploadKeyTypeEnum.CustomerMatchUploadKeyType upload_key_type = 2; // Data source of the list. Default value is FIRST_PARTY. // Only whitelisted customers can create third-party sourced CRM lists. - google.ads.googleads.v1.enums.UserListCrmDataSourceTypeEnum - .UserListCrmDataSourceType data_source_type = 3; + google.ads.googleads.v1.enums.UserListCrmDataSourceTypeEnum.UserListCrmDataSourceType data_source_type = 3; } // A client defined rule based on custom parameters sent by web sites or @@ -84,8 +81,7 @@ message UserListRuleInfo { // // Currently AND of ORs (conjunctive normal form) is only supported for // ExpressionRuleUserList. - google.ads.googleads.v1.enums.UserListRuleTypeEnum.UserListRuleType - rule_type = 1; + google.ads.googleads.v1.enums.UserListRuleTypeEnum.UserListRuleType rule_type = 1; // List of rule item groups that defines this rule. // Rule item groups are grouped together based on rule_type. @@ -98,7 +94,7 @@ message UserListRuleItemGroupInfo { repeated UserListRuleItemInfo rule_items = 1; } -// An atomic rule fragment. +// An atomic rule item. message UserListRuleItemInfo { // Rule variable name. It should match the corresponding key name fired // by the pixel. @@ -110,27 +106,25 @@ message UserListRuleItemInfo { // This field must be populated when creating a new rule item. google.protobuf.StringValue name = 1; - // An atomic rule fragment. + // An atomic rule item. oneof rule_item { - // An atomic rule fragment composed of a number operation. + // An atomic rule item composed of a number operation. UserListNumberRuleItemInfo number_rule_item = 2; - // An atomic rule fragment composed of a string operation. + // An atomic rule item composed of a string operation. UserListStringRuleItemInfo string_rule_item = 3; - // An atomic rule fragment composed of a date operation. + // An atomic rule item composed of a date operation. UserListDateRuleItemInfo date_rule_item = 4; } } -// A rule item composed of date operation. +// A rule item composed of a date operation. message UserListDateRuleItemInfo { // Date comparison operator. // This field is required and must be populated when creating new date // rule item. - google.ads.googleads.v1.enums.UserListDateRuleItemOperatorEnum - .UserListDateRuleItemOperator - operator = 1; + google.ads.googleads.v1.enums.UserListDateRuleItemOperatorEnum.UserListDateRuleItemOperator operator = 1; // String representing date value to be compared with the rule variable. // Supported date format is YYYY-MM-DD. @@ -143,14 +137,12 @@ message UserListDateRuleItemInfo { google.protobuf.Int64Value offset_in_days = 3; } -// A rule item composed of number operation. +// A rule item composed of a number operation. message UserListNumberRuleItemInfo { // Number comparison operator. // This field is required and must be populated when creating a new number // rule item. - google.ads.googleads.v1.enums.UserListNumberRuleItemOperatorEnum - .UserListNumberRuleItemOperator - operator = 1; + google.ads.googleads.v1.enums.UserListNumberRuleItemOperatorEnum.UserListNumberRuleItemOperator operator = 1; // Number value to be compared with the variable. // This field is required and must be populated when creating a new number @@ -158,14 +150,12 @@ message UserListNumberRuleItemInfo { google.protobuf.DoubleValue value = 2; } -// A rule item fragment composed of date operation. +// A rule item composed of a string operation. message UserListStringRuleItemInfo { // String comparison operator. // This field is required and must be populated when creating a new string // rule item. - google.ads.googleads.v1.enums.UserListStringRuleItemOperatorEnum - .UserListStringRuleItemOperator - operator = 1; + google.ads.googleads.v1.enums.UserListStringRuleItemOperatorEnum.UserListStringRuleItemOperator operator = 1; // The right hand side of the string rule item. For URLs or referrer URLs, // the value can not contain illegal URL chars such as newlines, quotes, @@ -191,8 +181,7 @@ message CombinedRuleUserListInfo { // Operator to connect the two operands. // // Required for creating a combined rule user list. - google.ads.googleads.v1.enums.UserListCombinedRuleOperatorEnum - .UserListCombinedRuleOperator rule_operator = 3; + google.ads.googleads.v1.enums.UserListCombinedRuleOperatorEnum.UserListCombinedRuleOperator rule_operator = 3; } // Visitors of a page during specific dates. @@ -236,8 +225,7 @@ message RuleBasedUserListInfo { // list's membership duration and the date when the remarketing tag is added. // The status will be updated to FINISHED once request is processed, or FAILED // if the request fails. - google.ads.googleads.v1.enums.UserListPrepopulationStatusEnum - .UserListPrepopulationStatus prepopulation_status = 1; + google.ads.googleads.v1.enums.UserListPrepopulationStatusEnum.UserListPrepopulationStatus prepopulation_status = 1; // Subtypes of rule based user lists. oneof rule_based_user_list { @@ -273,9 +261,7 @@ message LogicalUserListInfo { // list of user lists as operands. message UserListLogicalRuleInfo { // The logical operator of the rule. - google.ads.googleads.v1.enums.UserListLogicalRuleOperatorEnum - .UserListLogicalRuleOperator - operator = 1; + google.ads.googleads.v1.enums.UserListLogicalRuleOperatorEnum.UserListLogicalRuleOperator operator = 1; // The list of operands of the rule. repeated LogicalUserListOperandInfo rule_operands = 2; diff --git a/third_party/googleapis/google/ads/googleads/v1/common/value.proto b/third_party/googleapis/google/ads/googleads/v1/common/value.proto index b37dfb15c..9341788ae 100644 --- a/third_party/googleapis/google/ads/googleads/v1/common/value.proto +++ b/third_party/googleapis/google/ads/googleads/v1/common/value.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/access_reason.proto b/third_party/googleapis/google/ads/googleads/v1/enums/access_reason.proto index 08add76c4..39256c284 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/access_reason.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/access_reason.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -53,4 +52,6 @@ message AccessReasonEnum { // The resource is accessible to the user. AFFILIATED = 6; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/account_budget_proposal_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/account_budget_proposal_status.proto index f2532fe7e..2b678f99a 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/account_budget_proposal_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/account_budget_proposal_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -59,4 +58,6 @@ message AccountBudgetProposalStatusEnum { // acceptance email. REJECTED = 6; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/account_budget_proposal_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/account_budget_proposal_type.proto index 61ff472da..bf6bf185a 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/account_budget_proposal_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/account_budget_proposal_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -52,4 +51,6 @@ message AccountBudgetProposalTypeEnum { // Identifies a request to remove a budget that hasn't started yet. REMOVE = 5; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/account_budget_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/account_budget_status.proto index 391c7ccdb..afc3faa48 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/account_budget_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/account_budget_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -49,4 +48,6 @@ message AccountBudgetStatusEnum { // The account budget has been cancelled by the user. CANCELLED = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/ad_customizer_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v1/enums/ad_customizer_placeholder_field.proto index fc8fbae7d..38a8bde6e 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/ad_customizer_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/ad_customizer_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -52,4 +51,6 @@ message AdCustomizerPlaceholderFieldEnum { // Data Type: STRING. String value to be inserted. STRING = 5; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/ad_group_ad_rotation_mode.proto b/third_party/googleapis/google/ads/googleads/v1/enums/ad_group_ad_rotation_mode.proto index 59763e9c2..8b112c7f4 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/ad_group_ad_rotation_mode.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/ad_group_ad_rotation_mode.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -49,4 +48,6 @@ message AdGroupAdRotationModeEnum { // Rotate evenly forever. ROTATE_FOREVER = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/ad_group_ad_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/ad_group_ad_status.proto index cadf1a399..ab170bd3b 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/ad_group_ad_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/ad_group_ad_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -51,4 +50,6 @@ message AdGroupAdStatusEnum { // The ad group ad is removed. REMOVED = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/ad_group_criterion_approval_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/ad_group_criterion_approval_status.proto index 9e79e540d..fd0bc6717 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/ad_group_criterion_approval_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/ad_group_criterion_approval_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -52,4 +51,6 @@ message AdGroupCriterionApprovalStatusEnum { // Under review. UNDER_REVIEW = 5; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/ad_group_criterion_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/ad_group_criterion_status.proto index 2d43b8615..f9c0f2043 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/ad_group_criterion_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/ad_group_criterion_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -51,4 +50,6 @@ message AdGroupCriterionStatusEnum { // The ad group criterion is removed. REMOVED = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/ad_group_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/ad_group_status.proto index 9103e23ba..79de69f3a 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/ad_group_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/ad_group_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -51,4 +50,6 @@ message AdGroupStatusEnum { // The ad group is removed. REMOVED = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/ad_group_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/ad_group_type.proto index 3802f1285..f6e03dd2f 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/ad_group_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/ad_group_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -80,4 +79,6 @@ message AdGroupTypeEnum { // The type for ad groups in Shopping Comparison Listing campaigns. SHOPPING_COMPARISON_LISTING_ADS = 14; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/ad_network_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/ad_network_type.proto index 803104d14..64c77cfb5 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/ad_network_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/ad_network_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -58,4 +57,6 @@ message AdNetworkTypeEnum { // Cross-network. MIXED = 7; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/ad_serving_optimization_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/ad_serving_optimization_status.proto index 6e3f50c5e..1668b0431 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/ad_serving_optimization_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/ad_serving_optimization_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -60,4 +59,6 @@ message AdServingOptimizationStatusEnum { // Ad serving optimization status is not available. UNAVAILABLE = 6; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/ad_strength.proto b/third_party/googleapis/google/ads/googleads/v1/enums/ad_strength.proto index fdc944c1c..cbd7aa470 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/ad_strength.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/ad_strength.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -58,4 +57,6 @@ message AdStrengthEnum { // Excellent strength. EXCELLENT = 7; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/ad_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/ad_type.proto index 52c1bc30b..9dd1c9c4e 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/ad_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/ad_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -100,4 +99,6 @@ message AdTypeEnum { // The ad is a Shopping Comparison Listing ad. SHOPPING_COMPARISON_LISTING_AD = 24; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/advertising_channel_sub_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/advertising_channel_sub_type.proto index 5ca28b98e..5cd4f2b80 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/advertising_channel_sub_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/advertising_channel_sub_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -83,4 +82,6 @@ message AdvertisingChannelSubTypeEnum { // Shopping Comparison Listing campaigns. SHOPPING_COMPARISON_LISTING_ADS = 15; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/advertising_channel_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/advertising_channel_type.proto index 25cf0bf9b..3145bd879 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/advertising_channel_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/advertising_channel_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -60,4 +59,6 @@ message AdvertisingChannelTypeEnum { // across multiple channels. MULTI_CHANNEL = 7; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/affiliate_location_feed_relationship_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/affiliate_location_feed_relationship_type.proto index 06ca33eb9..206078dc4 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/affiliate_location_feed_relationship_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/affiliate_location_feed_relationship_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -44,4 +43,6 @@ message AffiliateLocationFeedRelationshipTypeEnum { // General retailer relationship. GENERAL_RETAILER = 2; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/affiliate_location_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v1/enums/affiliate_location_placeholder_field.proto index 8c2ed679f..edcb3268a 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/affiliate_location_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/affiliate_location_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -73,4 +72,6 @@ message AffiliateLocationPlaceholderFieldEnum { // Data Type: STRING. Name of the chain. CHAIN_NAME = 12; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/age_range_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/age_range_type.proto index 2937e8235..ba6f73e48 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/age_range_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/age_range_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -61,4 +60,6 @@ message AgeRangeTypeEnum { // Undetermined age range. AGE_RANGE_UNDETERMINED = 503999; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/app_campaign_app_store.proto b/third_party/googleapis/google/ads/googleads/v1/enums/app_campaign_app_store.proto index 802ad127c..343a9cba2 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/app_campaign_app_store.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/app_campaign_app_store.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message AppCampaignAppStoreEnum { // Google play. GOOGLE_APP_STORE = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/app_campaign_bidding_strategy_goal_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/app_campaign_bidding_strategy_goal_type.proto index b88c58203..e5358b5f7 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/app_campaign_bidding_strategy_goal_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/app_campaign_bidding_strategy_goal_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -60,4 +59,6 @@ message AppCampaignBiddingStrategyGoalTypeEnum { // spend. OPTIMIZE_RETURN_ON_ADVERTISING_SPEND = 5; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/app_payment_model_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/app_payment_model_type.proto index cee3fad31..416128804 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/app_payment_model_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/app_payment_model_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -43,4 +42,6 @@ message AppPaymentModelTypeEnum { // Represents paid-for apps. PAID = 30; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/app_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v1/enums/app_placeholder_field.proto index e9fa23316..062eb538f 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/app_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/app_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -71,4 +70,6 @@ message AppPlaceholderFieldEnum { // parallel tracking. FINAL_URL_SUFFIX = 9; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/app_store.proto b/third_party/googleapis/google/ads/googleads/v1/enums/app_store.proto index 7b37b6c16..007510b3b 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/app_store.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/app_store.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message AppStoreEnum { // Google Play. GOOGLE_PLAY = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/app_url_operating_system_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/app_url_operating_system_type.proto index 8b047775f..cf5ceb50d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/app_url_operating_system_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/app_url_operating_system_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message AppUrlOperatingSystemTypeEnum { // The Android operating system. ANDROID = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/asset_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/asset_type.proto index 836b5a8ff..cf6bad492 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/asset_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/asset_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -52,4 +51,6 @@ message AssetTypeEnum { // Text asset. TEXT = 5; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/attribution_model.proto b/third_party/googleapis/google/ads/googleads/v1/enums/attribution_model.proto index 21d8cb43a..56944070d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/attribution_model.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/attribution_model.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -68,4 +67,6 @@ message AttributionModelEnum { // distribution of credit among clicks using Google Search attribution. GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN = 106; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/bid_modifier_source.proto b/third_party/googleapis/google/ads/googleads/v1/enums/bid_modifier_source.proto index 7c6c1551b..c7d9e96eb 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/bid_modifier_source.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/bid_modifier_source.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -47,4 +46,6 @@ message BidModifierSourceEnum { // The bid modifier is specified (overridden) at the ad group level. AD_GROUP = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/bidding_source.proto b/third_party/googleapis/google/ads/googleads/v1/enums/bidding_source.proto index f0bc2719a..ce355e3ec 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/bidding_source.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/bidding_source.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -51,4 +50,6 @@ message BiddingSourceEnum { // The bid or target is defined on the ad group criterion. AD_GROUP_CRITERION = 7; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/bidding_strategy_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/bidding_strategy_status.proto index cd7a79112..fa0fc0bfa 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/bidding_strategy_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/bidding_strategy_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -48,4 +47,6 @@ message BiddingStrategyStatusEnum { // The bidding strategy is removed. REMOVED = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/bidding_strategy_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/bidding_strategy_type.proto index b63fa045c..598f8be77 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/bidding_strategy_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/bidding_strategy_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -69,6 +68,7 @@ message BiddingStrategyTypeEnum { // Page-One Promoted bidding scheme, which sets max cpc bids to // target impressions on page one or page one promoted slots on google.com. + // This enum value is deprecated. PAGE_ONE_PROMOTED = 5; // Percent Cpc is bidding strategy where bids are a fraction of the @@ -93,6 +93,7 @@ message BiddingStrategyTypeEnum { // Target Outrank Share is an automated bidding strategy that sets bids // based on the target fraction of auctions where the advertiser // should outrank a specific competitor. + // This enum value is deprecated. TARGET_OUTRANK_SHARE = 7; // Target ROAS is an automated bidding strategy @@ -104,4 +105,6 @@ message BiddingStrategyTypeEnum { // to help get as many clicks as possible within your budget. TARGET_SPEND = 9; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/billing_setup_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/billing_setup_status.proto index f7ff5820c..251ffbebe 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/billing_setup_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/billing_setup_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -54,4 +53,6 @@ message BillingSetupStatusEnum { // The billing setup was cancelled by the user prior to approval. CANCELLED = 5; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/brand_safety_suitability.proto b/third_party/googleapis/google/ads/googleads/v1/enums/brand_safety_suitability.proto index e3d4a8ad2..cf5bb8d2f 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/brand_safety_suitability.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/brand_safety_suitability.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -69,4 +68,6 @@ message BrandSafetySuitabilityEnum { // Google video partners. LIMITED_INVENTORY = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/budget_delivery_method.proto b/third_party/googleapis/google/ads/googleads/v1/enums/budget_delivery_method.proto index 5a0a869e6..fd6ddb7c0 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/budget_delivery_method.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/budget_delivery_method.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -49,4 +48,6 @@ message BudgetDeliveryMethodEnum { // and ads will serve as fast as possible. ACCELERATED = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/budget_period.proto b/third_party/googleapis/google/ads/googleads/v1/enums/budget_period.proto index 0182d7419..eeb1779d7 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/budget_period.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/budget_period.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -49,4 +48,6 @@ message BudgetPeriodEnum { // Fixed daily budget. FIXED_DAILY = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/budget_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/budget_status.proto index 25f09a1d5..b32db5630 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/budget_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/budget_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message BudgetStatusEnum { // Budget is removed. REMOVED = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/budget_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/budget_type.proto index 93b690212..4335a6efd 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/budget_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/budget_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -62,4 +61,6 @@ message BudgetTypeEnum { // BiddingStrategyType.TARGET_CPA and PaymentMode.CONVERSIONS. FIXED_CPA = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/call_conversion_reporting_state.proto b/third_party/googleapis/google/ads/googleads/v1/enums/call_conversion_reporting_state.proto index 8d54ac5e4..3c9a0876b 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/call_conversion_reporting_state.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/call_conversion_reporting_state.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -52,4 +51,6 @@ message CallConversionReportingStateEnum { // (call only ads/call extensions) level. USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/call_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v1/enums/call_placeholder_field.proto index 90e211ea4..7fa76f554 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/call_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/call_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -62,4 +61,6 @@ message CallPlaceholderFieldEnum { // USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION. CONVERSION_REPORTING_STATE = 6; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/callout_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v1/enums/callout_placeholder_field.proto index 5ad14dd18..95f3c4469 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/callout_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/callout_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -43,4 +42,6 @@ message CalloutPlaceholderFieldEnum { // Data Type: STRING. Callout text. CALLOUT_TEXT = 2; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/campaign_criterion_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/campaign_criterion_status.proto index c3fe9dc22..2e9007690 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/campaign_criterion_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/campaign_criterion_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/campaign_draft_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/campaign_draft_status.proto index 3602b5b8b..0a91cdc8a 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/campaign_draft_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/campaign_draft_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/campaign_experiment_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/campaign_experiment_status.proto index 0dc848323..ddcfd117e 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/campaign_experiment_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/campaign_experiment_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/campaign_experiment_traffic_split_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/campaign_experiment_traffic_split_type.proto index 7711d0dfb..3ae8019f9 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/campaign_experiment_traffic_split_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/campaign_experiment_traffic_split_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/campaign_experiment_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/campaign_experiment_type.proto index c547a395d..041fb6df0 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/campaign_experiment_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/campaign_experiment_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -55,4 +54,6 @@ message CampaignExperimentTypeEnum { // from the BASE campaign to this experiment campaign. EXPERIMENT = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/campaign_serving_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/campaign_serving_status.proto index 625195bac..4cdb491b4 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/campaign_serving_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/campaign_serving_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -57,4 +56,6 @@ message CampaignServingStatusEnum { // Suspended. SUSPENDED = 6; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/campaign_shared_set_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/campaign_shared_set_status.proto index cbb2d4aff..8fd1e9778 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/campaign_shared_set_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/campaign_shared_set_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message CampaignSharedSetStatusEnum { // The campaign shared set is removed and can no longer be used. REMOVED = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/campaign_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/campaign_status.proto index cdec3f5ba..e4d64c086 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/campaign_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/campaign_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -49,4 +48,6 @@ message CampaignStatusEnum { // Campaign has been removed. REMOVED = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/change_status_operation.proto b/third_party/googleapis/google/ads/googleads/v1/enums/change_status_operation.proto index b6b045f84..2265bcf3e 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/change_status_operation.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/change_status_operation.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -50,4 +49,6 @@ message ChangeStatusOperationEnum { // The resource was removed. REMOVED = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/change_status_resource_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/change_status_resource_type.proto index 1eeee0328..1cccab74d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/change_status_resource_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/change_status_resource_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -72,4 +71,6 @@ message ChangeStatusResourceTypeEnum { // An AdGroupBidModifier resource change. AD_GROUP_BID_MODIFIER = 13; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/click_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/click_type.proto index 2722fa36c..89ea837a0 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/click_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/click_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -199,4 +198,6 @@ message ClickTypeEnum { // Shopping - Comparison Listing. SHOPPING_COMPARISON_LISTING = 56; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/content_label_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/content_label_type.proto index df2437060..36b77a6c7 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/content_label_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/content_label_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -85,4 +84,6 @@ message ContentLabelTypeEnum { // Live streaming video. LIVE_STREAMING_VIDEO = 16; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/conversion_action_category.proto b/third_party/googleapis/google/ads/googleads/v1/enums/conversion_action_category.proto index b12de553c..fabe144c6 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/conversion_action_category.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/conversion_action_category.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -57,4 +56,6 @@ message ConversionActionCategoryEnum { // Software download action (as for an app). DOWNLOAD = 7; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/conversion_action_counting_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/conversion_action_counting_type.proto index ed4b54f27..6b010ad0e 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/conversion_action_counting_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/conversion_action_counting_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -48,4 +47,6 @@ message ConversionActionCountingTypeEnum { // Count all conversions per click. MANY_PER_CLICK = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/conversion_action_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/conversion_action_status.proto index 576762b72..128a469cb 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/conversion_action_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/conversion_action_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -50,4 +49,6 @@ message ConversionActionStatusEnum { // appear in the UI. HIDDEN = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/conversion_action_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/conversion_action_type.proto index bc59c5c24..371950eb3 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/conversion_action_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/conversion_action_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -69,4 +68,6 @@ message ConversionActionTypeEnum { // number from an advertiser's website. WEBSITE_CALL = 9; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/conversion_adjustment_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/conversion_adjustment_type.proto index 76f6632d1..928696718 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/conversion_adjustment_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/conversion_adjustment_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -48,4 +47,6 @@ message ConversionAdjustmentTypeEnum { // Changes the value of a conversion. RESTATEMENT = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/conversion_attribution_event_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/conversion_attribution_event_type.proto index d8646edf6..f4f713fa3 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/conversion_attribution_event_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/conversion_attribution_event_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -44,4 +43,6 @@ message ConversionAttributionEventTypeEnum { // The conversion is attributed to an interaction. INTERACTION = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/conversion_lag_bucket.proto b/third_party/googleapis/google/ads/googleads/v1/enums/conversion_lag_bucket.proto index cd68a9945..06e9d35c4 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/conversion_lag_bucket.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/conversion_lag_bucket.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -113,4 +112,6 @@ message ConversionLagBucketEnum { // 90 days is not. SIXTY_TO_NINETY_DAYS = 20; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/conversion_or_adjustment_lag_bucket.proto b/third_party/googleapis/google/ads/googleads/v1/enums/conversion_or_adjustment_lag_bucket.proto index fbe31e145..890dc832f 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/conversion_or_adjustment_lag_bucket.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/conversion_or_adjustment_lag_bucket.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -202,4 +201,6 @@ message ConversionOrAdjustmentLagBucketEnum { // conversion adjustment lag bucket was available in Google Ads. ADJUSTMENT_UNKNOWN = 42; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/criterion_category_channel_availability_mode.proto b/third_party/googleapis/google/ads/googleads/v1/enums/criterion_category_channel_availability_mode.proto index f03422800..f036a8cd6 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/criterion_category_channel_availability_mode.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/criterion_category_channel_availability_mode.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -54,4 +53,6 @@ message CriterionCategoryChannelAvailabilityModeEnum { // subtype(s). CHANNEL_TYPE_AND_SUBSET_SUBTYPES = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/criterion_category_locale_availability_mode.proto b/third_party/googleapis/google/ads/googleads/v1/enums/criterion_category_locale_availability_mode.proto index 8016d5127..48137d584 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/criterion_category_locale_availability_mode.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/criterion_category_locale_availability_mode.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -30,7 +29,7 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Enums"; // Proto file describing the criterion category locale availability mode. -// Describes locale availabilty mode for a criterion availability - whether +// Describes locale availability mode for a criterion availability - whether // it's available globally, or a particular country with all languages, or a // particular language with all countries, or a country-language pair. message CriterionCategoryLocaleAvailabilityModeEnum { @@ -57,4 +56,6 @@ message CriterionCategoryLocaleAvailabilityModeEnum { // pairs. COUNTRY_AND_LANGUAGE = 5; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/criterion_system_serving_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/criterion_system_serving_status.proto index 24572d233..8bfd8094b 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/criterion_system_serving_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/criterion_system_serving_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message CriterionSystemServingStatusEnum { // Low search volume. RARELY_SERVED = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/criterion_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/criterion_type.proto index b01cb67cf..0cf61f790 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/criterion_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/criterion_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -130,4 +129,6 @@ message CriterionTypeEnum { // Location group. LOCATION_GROUP = 31; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/custom_interest_member_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/custom_interest_member_type.proto index dda2be01a..70c0d1f55 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/custom_interest_member_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/custom_interest_member_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message CustomInterestMemberTypeEnum { // Custom interest member type URL. URL = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/custom_interest_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/custom_interest_status.proto index aa3d18db0..9b870a52b 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/custom_interest_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/custom_interest_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -47,4 +46,6 @@ message CustomInterestStatusEnum { // targeting. REMOVED = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/custom_interest_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/custom_interest_type.proto index 8f7799599..800526bd6 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/custom_interest_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/custom_interest_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message CustomInterestTypeEnum { // Allows advertisers to define custom intent audience lists. CUSTOM_INTENT = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/custom_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v1/enums/custom_placeholder_field.proto index 2316153fd..2b82bde2a 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/custom_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/custom_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -125,4 +124,6 @@ message CustomPlaceholderFieldEnum { // Data Type: INT64. iOS app store ID. IOS_APP_STORE_ID = 21; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/customer_match_upload_key_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/customer_match_upload_key_type.proto index 656f144c3..192a23c30 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/customer_match_upload_key_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/customer_match_upload_key_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -49,4 +48,6 @@ message CustomerMatchUploadKeyTypeEnum { // Members are matched from mobile advertising ids. MOBILE_ADVERTISING_ID = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/customer_pay_per_conversion_eligibility_failure_reason.proto b/third_party/googleapis/google/ads/googleads/v1/enums/customer_pay_per_conversion_eligibility_failure_reason.proto index 55062cbd1..8dc3426ab 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/customer_pay_per_conversion_eligibility_failure_reason.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/customer_pay_per_conversion_eligibility_failure_reason.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -64,4 +63,6 @@ message CustomerPayPerConversionEligibilityFailureReasonEnum { // Customer is not eligible due to other reasons. OTHER = 8; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/data_driven_model_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/data_driven_model_status.proto index dea3f238a..ad89884dc 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/data_driven_model_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/data_driven_model_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -58,4 +57,6 @@ message DataDrivenModelStatusEnum { // period. NEVER_GENERATED = 5; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/day_of_week.proto b/third_party/googleapis/google/ads/googleads/v1/enums/day_of_week.proto index 6a43f0798..8a7ab98cc 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/day_of_week.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/day_of_week.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -61,4 +60,6 @@ message DayOfWeekEnum { // Sunday. SUNDAY = 8; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/device.proto b/third_party/googleapis/google/ads/googleads/v1/enums/device.proto index 21e4d9575..2bf7a317c 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/device.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/device.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -55,4 +54,6 @@ message DeviceEnum { // Other device types. OTHER = 5; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/display_ad_format_setting.proto b/third_party/googleapis/google/ads/googleads/v1/enums/display_ad_format_setting.proto index feb9bde52..51cbc70df 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/display_ad_format_setting.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/display_ad_format_setting.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -50,4 +49,6 @@ message DisplayAdFormatSettingEnum { // and not by Google. NATIVE = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/display_upload_product_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/display_upload_product_type.proto index 858b1b434..96b69ef11 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/display_upload_product_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/display_upload_product_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -93,4 +92,6 @@ message DisplayUploadProductTypeEnum { // used in a hotel campaign. DYNAMIC_HTML5_HOTEL_AD = 11; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/dsa_page_feed_criterion_field.proto b/third_party/googleapis/google/ads/googleads/v1/enums/dsa_page_feed_criterion_field.proto index ad8b424e9..4079b129d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/dsa_page_feed_criterion_field.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/dsa_page_feed_criterion_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -47,4 +46,6 @@ message DsaPageFeedCriterionFieldEnum { // your page feed. LABEL = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/education_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v1/enums/education_placeholder_field.proto index 164ad8beb..d0f07843e 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/education_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/education_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -107,4 +106,6 @@ message EducationPlaceholderFieldEnum { // Data Type: INT64. iOS app store ID. IOS_APP_STORE_ID = 18; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/extension_setting_device.proto b/third_party/googleapis/google/ads/googleads/v1/enums/extension_setting_device.proto index e0084aae1..c6099574a 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/extension_setting_device.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/extension_setting_device.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -48,4 +47,6 @@ message ExtensionSettingDeviceEnum { // desktop devices. DESKTOP = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/extension_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/extension_type.proto index 8a47b2e7c..577cd5d9c 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/extension_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/extension_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -77,4 +76,6 @@ message ExtensionTypeEnum { // Affiliate location. AFFILIATE_LOCATION = 13; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/external_conversion_source.proto b/third_party/googleapis/google/ads/googleads/v1/enums/external_conversion_source.proto index dfdbd9286..3a4e92f78 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/external_conversion_source.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/external_conversion_source.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -126,4 +125,6 @@ message ExternalConversionSourceEnum { // uploads. Displayed in Google Ads UI as 'Store sales (direct)'. STORE_SALES_DIRECT = 22; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/feed_attribute_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/feed_attribute_type.proto index 46ef8cc6d..b45bde76b 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/feed_attribute_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/feed_attribute_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -79,4 +78,6 @@ message FeedAttributeTypeEnum { // Price. PRICE = 14; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/feed_item_quality_approval_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/feed_item_quality_approval_status.proto index ad547474e..d0cc2a77c 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/feed_item_quality_approval_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/feed_item_quality_approval_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -48,4 +47,6 @@ message FeedItemQualityApprovalStatusEnum { // the quality_disapproval_reasons field. DISAPPROVED = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/feed_item_quality_disapproval_reason.proto b/third_party/googleapis/google/ads/googleads/v1/enums/feed_item_quality_disapproval_reason.proto index e9745025c..598bf2723 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/feed_item_quality_disapproval_reason.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/feed_item_quality_disapproval_reason.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -95,4 +94,6 @@ message FeedItemQualityDisapprovalReasonEnum { // Structured snippet contain promotional text. STRUCTURED_SNIPPETS_HAS_PROMOTIONAL_TEXT = 19; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/feed_item_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/feed_item_status.proto index 9a4c41766..5477853e6 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/feed_item_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/feed_item_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message FeedItemStatusEnum { // Feed item has been removed. REMOVED = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/feed_item_target_device.proto b/third_party/googleapis/google/ads/googleads/v1/enums/feed_item_target_device.proto index 8eb86f6eb..e4ac3f6d6 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/feed_item_target_device.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/feed_item_target_device.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -44,4 +43,6 @@ message FeedItemTargetDeviceEnum { // Mobile. MOBILE = 2; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/feed_item_target_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/feed_item_target_type.proto index f68c169c3..acfa62c2c 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/feed_item_target_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/feed_item_target_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -49,4 +48,6 @@ message FeedItemTargetTypeEnum { // Feed item targets a criterion. CRITERION = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/feed_item_validation_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/feed_item_validation_status.proto index 56fc06249..a18ea9bd9 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/feed_item_validation_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/feed_item_validation_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -49,4 +48,6 @@ message FeedItemValidationStatusEnum { // Feed item is semantically well-formed. VALID = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/feed_link_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/feed_link_status.proto index 242f3cf2f..4e76f2ddd 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/feed_link_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/feed_link_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message FeedLinkStatusEnum { // Feed link has been removed. REMOVED = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/feed_mapping_criterion_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/feed_mapping_criterion_type.proto index 949dd8d75..5358cfb13 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/feed_mapping_criterion_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/feed_mapping_criterion_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message FeedMappingCriterionTypeEnum { // Allows url targeting for your dynamic search ads within a page feed. DSA_PAGE_FEED = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/feed_mapping_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/feed_mapping_status.proto index fe31a4005..f2244d444 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/feed_mapping_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/feed_mapping_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message FeedMappingStatusEnum { // Feed mapping has been removed. REMOVED = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/feed_origin.proto b/third_party/googleapis/google/ads/googleads/v1/enums/feed_origin.proto index 3371b1753..7d0479fe7 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/feed_origin.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/feed_origin.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -49,4 +48,6 @@ message FeedOriginEnum { // for the placeholder type of the feed. GOOGLE = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/feed_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/feed_status.proto index 25444e88c..0f66cb0bf 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/feed_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/feed_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message FeedStatusEnum { // Feed has been removed. REMOVED = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/flight_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v1/enums/flight_placeholder_field.proto index 410bd521e..4d8a3bf43 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/flight_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/flight_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -114,4 +113,6 @@ message FlightPlaceholderFieldEnum { // Data Type: INT64. iOS app store ID. IOS_APP_STORE_ID = 18; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/frequency_cap_event_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/frequency_cap_event_type.proto index 538e4aed8..5f9548a5a 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/frequency_cap_event_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/frequency_cap_event_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message FrequencyCapEventTypeEnum { // The cap applies on video ad views. VIDEO_VIEW = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/frequency_cap_level.proto b/third_party/googleapis/google/ads/googleads/v1/enums/frequency_cap_level.proto index 48a166b61..9a6c043e6 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/frequency_cap_level.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/frequency_cap_level.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -50,4 +49,6 @@ message FrequencyCapLevelEnum { // The cap is applied at the campaign level. CAMPAIGN = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/frequency_cap_time_unit.proto b/third_party/googleapis/google/ads/googleads/v1/enums/frequency_cap_time_unit.proto index d67532882..53da73c04 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/frequency_cap_time_unit.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/frequency_cap_time_unit.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -49,4 +48,6 @@ message FrequencyCapTimeUnitEnum { // The cap would define limit per one month. MONTH = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/gender_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/gender_type.proto index 0782bc10c..794094e11 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/gender_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/gender_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -49,4 +48,6 @@ message GenderTypeEnum { // Undetermined gender. UNDETERMINED = 20; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/geo_target_constant_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/geo_target_constant_status.proto index 415cff4e4..8352ed14d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/geo_target_constant_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/geo_target_constant_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -48,4 +47,6 @@ message GeoTargetConstantStatusEnum { // The geo target constant is obsolete and will be removed. REMOVAL_PLANNED = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/geo_targeting_restriction.proto b/third_party/googleapis/google/ads/googleads/v1/enums/geo_targeting_restriction.proto index 9407898d3..4b1c89d75 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/geo_targeting_restriction.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/geo_targeting_restriction.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -45,4 +44,6 @@ message GeoTargetingRestrictionEnum { // the user. LOCATION_OF_PRESENCE = 2; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/geo_targeting_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/geo_targeting_type.proto index bfb00f014..7b6233c80 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/geo_targeting_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/geo_targeting_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message GeoTargetingTypeEnum { // Location of the user issuing the query. LOCATION_OF_PRESENCE = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/google_ads_field_category.proto b/third_party/googleapis/google/ads/googleads/v1/enums/google_ads_field_category.proto index b12096dcc..9e9253cb5 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/google_ads_field_category.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/google_ads_field_category.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -57,4 +56,6 @@ message GoogleAdsFieldCategoryEnum { // search queries. METRIC = 6; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/google_ads_field_data_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/google_ads_field_data_type.proto index d84d34aa7..d588805fd 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/google_ads_field_data_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/google_ads_field_data_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -98,4 +97,6 @@ message GoogleAdsFieldDataTypeEnum { // Applicable operators: =, !=, <, >, <=, >=, BETWEEN, IN, NOT IN UINT64 = 12; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/hotel_date_selection_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/hotel_date_selection_type.proto index 321668ade..581d0d2c8 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/hotel_date_selection_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/hotel_date_selection_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message HotelDateSelectionTypeEnum { // Dates selected by the user. USER_SELECTED = 51; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/hotel_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v1/enums/hotel_placeholder_field.proto index 9a9a2f553..6a5ae437a 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/hotel_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/hotel_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -120,4 +119,6 @@ message HotelPlaceholderFieldEnum { // Data Type: INT64. iOS app store ID. IOS_APP_STORE_ID = 21; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/hotel_rate_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/hotel_rate_type.proto index 6a1525230..c9446c012 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/hotel_rate_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/hotel_rate_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -48,9 +47,9 @@ message HotelRateTypeEnum { // A membership program rate is available and satisfies basic requirements // like having a public rate available. UI treatment will strikethrough the - // public rate and indicate that a discount is available to the user. See + // public rate and indicate that a discount is available to the user. For + // more on Qualified Rates, visit // https://developers.google.com/hotels/hotel-ads/dev-guide/qualified-rates - // for more information. QUALIFIED_RATE = 4; // Rates available to users that satisfy some eligibility criteria. e.g. diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/income_range_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/income_range_type.proto index 8539677ab..11b8a4dfe 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/income_range_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/income_range_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -61,4 +60,6 @@ message IncomeRangeTypeEnum { // Undetermined income range. INCOME_RANGE_UNDETERMINED = 510000; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/interaction_event_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/interaction_event_type.proto index 2326c7722..8a1a5f3fe 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/interaction_event_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/interaction_event_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -58,4 +57,6 @@ message InteractionEventTypeEnum { // These are simply other (ad) conversions. NONE = 5; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/interaction_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/interaction_type.proto index d6a805833..2162b8b7c 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/interaction_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/interaction_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -43,4 +42,6 @@ message InteractionTypeEnum { // Calls. CALLS = 8000; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/job_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v1/enums/job_placeholder_field.proto index c619ba958..b09443cbf 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/job_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/job_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -111,4 +110,6 @@ message JobPlaceholderFieldEnum { // Data Type: INT64. iOS app store ID. IOS_APP_STORE_ID = 19; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/keyword_match_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/keyword_match_type.proto index 923f465ac..a9f0760da 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/keyword_match_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/keyword_match_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -49,4 +48,6 @@ message KeywordMatchTypeEnum { // Broad match. BROAD = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/keyword_plan_competition_level.proto b/third_party/googleapis/google/ads/googleads/v1/enums/keyword_plan_competition_level.proto index 598ec7c18..ff157550b 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/keyword_plan_competition_level.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/keyword_plan_competition_level.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -53,4 +52,6 @@ message KeywordPlanCompetitionLevelEnum { // High competition. HIGH = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/keyword_plan_forecast_interval.proto b/third_party/googleapis/google/ads/googleads/v1/enums/keyword_plan_forecast_interval.proto index 2dcc6bad7..8e667c4bb 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/keyword_plan_forecast_interval.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/keyword_plan_forecast_interval.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -52,4 +51,6 @@ message KeywordPlanForecastIntervalEnum { // The next quarter date range for keyword plan. NEXT_QUARTER = 5; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/keyword_plan_network.proto b/third_party/googleapis/google/ads/googleads/v1/enums/keyword_plan_network.proto index e43ba8c50..25cf4530d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/keyword_plan_network.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/keyword_plan_network.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message KeywordPlanNetworkEnum { // Google Search + Search partners. GOOGLE_SEARCH_AND_PARTNERS = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/label_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/label_status.proto index b675846d4..156b1787f 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/label_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/label_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -44,4 +43,6 @@ message LabelStatusEnum { // Label is removed. REMOVED = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/legacy_app_install_ad_app_store.proto b/third_party/googleapis/google/ads/googleads/v1/enums/legacy_app_install_ad_app_store.proto index 9d7dc2b44..3188cafbc 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/legacy_app_install_ad_app_store.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/legacy_app_install_ad_app_store.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -55,4 +54,6 @@ message LegacyAppInstallAdAppStoreEnum { // The app is hosted in a Chinese app store. CN_APP_STORE = 6; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/listing_custom_attribute_index.proto b/third_party/googleapis/google/ads/googleads/v1/enums/listing_custom_attribute_index.proto index 9ca9134d5..10b9071c5 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/listing_custom_attribute_index.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/listing_custom_attribute_index.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -55,4 +54,6 @@ message ListingCustomAttributeIndexEnum { // Fifth listing custom attribute. INDEX4 = 11; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/listing_group_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/listing_group_type.proto index 4ac77989a..450d67c51 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/listing_group_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/listing_group_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -48,4 +47,6 @@ message ListingGroupTypeEnum { // Listing group unit that defines a bid. UNIT = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/local_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v1/enums/local_placeholder_field.proto index 8fae98efd..4724500fd 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/local_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/local_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -115,4 +114,6 @@ message LocalPlaceholderFieldEnum { // Data Type: INT64. iOS app store ID. IOS_APP_STORE_ID = 20; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/location_extension_targeting_criterion_field.proto b/third_party/googleapis/google/ads/googleads/v1/enums/location_extension_targeting_criterion_field.proto index ed4ccb5c5..3831d3b70 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/location_extension_targeting_criterion_field.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/location_extension_targeting_criterion_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -58,4 +57,6 @@ message LocationExtensionTargetingCriterionFieldEnum { // Data Type: STRING. Country code of the business address. COUNTRY_CODE = 7; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/location_group_radius_units.proto b/third_party/googleapis/google/ads/googleads/v1/enums/location_group_radius_units.proto index 797e7f2f8..34becc481 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/location_group_radius_units.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/location_group_radius_units.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message LocationGroupRadiusUnitsEnum { // Miles MILES = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/location_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v1/enums/location_placeholder_field.proto index 64c5dcae2..28883dd77 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/location_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/location_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -64,4 +63,6 @@ message LocationPlaceholderFieldEnum { // Data Type: STRING. Phone number of the business. PHONE_NUMBER = 9; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/manager_link_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/manager_link_status.proto index b3e317147..65d1e3436 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/manager_link_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/manager_link_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -55,4 +54,6 @@ message ManagerLinkStatusEnum { // canceled it. CANCELED = 6; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/matching_function_context_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/matching_function_context_type.proto index 4cf2ce4d8..050542bf5 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/matching_function_context_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/matching_function_context_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message MatchingFunctionContextTypeEnum { // The device being used (possible values are 'Desktop' or 'Mobile'). DEVICE_NAME = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/matching_function_operator.proto b/third_party/googleapis/google/ads/googleads/v1/enums/matching_function_operator.proto index d3de57117..5f34c241d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/matching_function_operator.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/matching_function_operator.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -61,4 +60,6 @@ message MatchingFunctionOperatorEnum { // ConstantOperands. CONTAINS_ANY = 6; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/media_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/media_type.proto index 182a88aef..68fc3bbd4 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/media_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/media_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -60,4 +59,6 @@ message MediaTypeEnum { // Animated image, such as animated GIF. DYNAMIC_IMAGE = 7; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/merchant_center_link_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/merchant_center_link_status.proto index 0d8b4b304..72ef1be52 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/merchant_center_link_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/merchant_center_link_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -49,4 +48,6 @@ message MerchantCenterLinkStatusEnum { // owner and hasn't been confirmed by the customer. PENDING = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/message_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v1/enums/message_placeholder_field.proto index 0d91c7871..888e2586a 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/message_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/message_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -57,4 +56,6 @@ message MessagePlaceholderFieldEnum { // messaging apps when they tap to send you a message. MESSAGE_TEXT = 6; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/mime_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/mime_type.proto index 86b088055..e15a53e2b 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/mime_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/mime_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -78,4 +77,6 @@ message MimeTypeEnum { // MIME type of application/x-html5-ad-zip. HTML5_AD_ZIP = 13; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/minute_of_hour.proto b/third_party/googleapis/google/ads/googleads/v1/enums/minute_of_hour.proto index 443daadeb..99ff09972 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/minute_of_hour.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/minute_of_hour.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -52,4 +51,6 @@ message MinuteOfHourEnum { // Forty-five minutes past the hour. FORTY_FIVE = 5; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/mobile_device_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/mobile_device_type.proto index c4ebc9bfd..ef37bbf7d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/mobile_device_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/mobile_device_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message MobileDeviceTypeEnum { // Tablets. TABLET = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/month_of_year.proto b/third_party/googleapis/google/ads/googleads/v1/enums/month_of_year.proto index 35a53068c..8ec281765 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/month_of_year.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/month_of_year.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -76,4 +75,6 @@ message MonthOfYearEnum { // December. DECEMBER = 13; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/mutate_job_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/mutate_job_status.proto index ec3010ae4..42fcf140f 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/mutate_job_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/mutate_job_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -49,4 +48,6 @@ message MutateJobStatusEnum { // The job is done. DONE = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/negative_geo_target_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/negative_geo_target_type.proto index 92ea054f2..73ef5dddc 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/negative_geo_target_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/negative_geo_target_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -42,10 +41,16 @@ message NegativeGeoTargetTypeEnum { // Specifies that a user is excluded from seeing the ad if they // are in, or show interest in, advertiser's excluded locations. + // DONT_CARE is removed in V2, use PRESENCE_OR_INTEREST + // instead. DONT_CARE = 2; // Specifies that a user is excluded from seeing the ad if they // are in advertiser's excluded locations. + // LOCATION_OF_PRESENCE is removed in V2, use PRESENCE + // instead. LOCATION_OF_PRESENCE = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/operating_system_version_operator_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/operating_system_version_operator_type.proto index 2cfa2e83b..9b909796c 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/operating_system_version_operator_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/operating_system_version_operator_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message OperatingSystemVersionOperatorTypeEnum { // Greater than or equals to the specified version. GREATER_THAN_EQUALS_TO = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/page_one_promoted_strategy_goal.proto b/third_party/googleapis/google/ads/googleads/v1/enums/page_one_promoted_strategy_goal.proto index a51fa76a8..a2263fce9 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/page_one_promoted_strategy_goal.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/page_one_promoted_strategy_goal.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -47,4 +46,6 @@ message PageOnePromotedStrategyGoalEnum { // Top slots of the first page on google.com. FIRST_PAGE_PROMOTED = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/parental_status_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/parental_status_type.proto index de8998a6e..14a5b8973 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/parental_status_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/parental_status_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -49,4 +48,6 @@ message ParentalStatusTypeEnum { // Undetermined parental status. UNDETERMINED = 302; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/payment_mode.proto b/third_party/googleapis/google/ads/googleads/v1/enums/payment_mode.proto index 3c7727247..2bbac0ca0 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/payment_mode.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/payment_mode.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -55,4 +54,6 @@ message PaymentModeEnum { // mode. See Customer.eligibility_failure_reasons for details. CONVERSIONS = 6; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/placeholder_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/placeholder_type.proto index e848c4219..64e3925c4 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/placeholder_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/placeholder_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -117,4 +116,6 @@ message PlaceholderTypeEnum { // Indicates that this feed is for job dynamic remarketing. DYNAMIC_JOB = 20; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/placement_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/placement_type.proto index b507b3361..e55e670cf 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/placement_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/placement_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -55,4 +54,6 @@ message PlacementTypeEnum { // YouTube channels(e.g. 'youtube.com::L8ZULXASCc1I_oaOT0NaOQ'). YOUTUBE_CHANNEL = 6; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/policy_approval_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/policy_approval_status.proto index 1eb7515f5..5d93b9bb5 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/policy_approval_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/policy_approval_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -57,4 +56,6 @@ message PolicyApprovalStatusEnum { // searching for information about the targeted countries. AREA_OF_INTEREST_ONLY = 5; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/policy_review_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/policy_review_status.proto index 1fbb5042c..6646f95ce 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/policy_review_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/policy_review_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -52,4 +51,6 @@ message PolicyReviewStatusEnum { // been appealed. UNDER_APPEAL = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/policy_topic_entry_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/policy_topic_entry_type.proto index 623b8571e..409f7694e 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/policy_topic_entry_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/policy_topic_entry_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -62,4 +61,6 @@ message PolicyTopicEntryTypeEnum { // through area of interest. AREA_OF_INTEREST_ONLY = 7; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/policy_topic_evidence_destination_mismatch_url_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/policy_topic_evidence_destination_mismatch_url_type.proto index f6796924e..38a736e0c 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/policy_topic_evidence_destination_mismatch_url_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/policy_topic_evidence_destination_mismatch_url_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -58,4 +57,6 @@ message PolicyTopicEvidenceDestinationMismatchUrlTypeEnum { // The tracking url template, with substituted mobile url. MOBILE_TRACKING_URL = 6; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/policy_topic_evidence_destination_not_working_device.proto b/third_party/googleapis/google/ads/googleads/v1/enums/policy_topic_evidence_destination_not_working_device.proto index 6a2da5fd2..45680b06a 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/policy_topic_evidence_destination_not_working_device.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/policy_topic_evidence_destination_not_working_device.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -53,4 +52,6 @@ message PolicyTopicEvidenceDestinationNotWorkingDeviceEnum { // Landing page doesn't work on iOS device. IOS = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/positive_geo_target_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/positive_geo_target_type.proto index 4143674be..2985300f1 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/positive_geo_target_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/positive_geo_target_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -42,14 +41,22 @@ message PositiveGeoTargetTypeEnum { // Specifies that an ad is triggered if the user is in, // or shows interest in, advertiser's targeted locations. + // DONT_CARE is removed in V2, use PRESENCE_OR_INTEREST + // instead. DONT_CARE = 2; // Specifies that an ad is triggered if the user // searches for advertiser's targeted locations. + // AREA_OF_INTEREST is removed in V2, use + // SEARCH_INTEREST instead. AREA_OF_INTEREST = 3; // Specifies that an ad is triggered if the user is in // or regularly in advertiser's targeted locations. + // LOCATION_OF_PRESENCE is removed in V2, use PRESENCE + // instead. LOCATION_OF_PRESENCE = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/preferred_content_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/preferred_content_type.proto index 8831ea124..596814a45 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/preferred_content_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/preferred_content_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -43,4 +42,6 @@ message PreferredContentTypeEnum { // Represents top content on YouTube. YOUTUBE_TOP_CONTENT = 400; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/price_extension_price_qualifier.proto b/third_party/googleapis/google/ads/googleads/v1/enums/price_extension_price_qualifier.proto index 9a3e87666..d618c0e9c 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/price_extension_price_qualifier.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/price_extension_price_qualifier.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -49,4 +48,6 @@ message PriceExtensionPriceQualifierEnum { // 'Average' qualifier for the price. AVERAGE = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/price_extension_price_unit.proto b/third_party/googleapis/google/ads/googleads/v1/enums/price_extension_price_unit.proto index 865b5a4e4..6a2ad6809 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/price_extension_price_unit.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/price_extension_price_unit.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -58,4 +57,6 @@ message PriceExtensionPriceUnitEnum { // Per night. PER_NIGHT = 7; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/price_extension_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/price_extension_type.proto index a3edef132..8ab826a23 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/price_extension_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/price_extension_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -67,4 +66,6 @@ message PriceExtensionTypeEnum { // The type for showing a collection of related service tiers. SERVICE_TIERS = 10; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/price_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v1/enums/price_placeholder_field.proto index 14e966056..8e8745c26 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/price_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/price_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -236,4 +235,6 @@ message PricePlaceholderFieldEnum { // using Upgraded URLs. ITEM_8_FINAL_MOBILE_URLS = 805; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/product_bidding_category_level.proto b/third_party/googleapis/google/ads/googleads/v1/enums/product_bidding_category_level.proto index 4a35b986a..c25bd075a 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/product_bidding_category_level.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/product_bidding_category_level.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -53,4 +52,6 @@ message ProductBiddingCategoryLevelEnum { // Level 5. LEVEL5 = 6; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/product_bidding_category_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/product_bidding_category_status.proto index 5edc363e8..d58b1737d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/product_bidding_category_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/product_bidding_category_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message ProductBiddingCategoryStatusEnum { // The category is obsolete. Used only for reporting purposes. OBSOLETE = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/product_channel.proto b/third_party/googleapis/google/ads/googleads/v1/enums/product_channel.proto index d4436556d..d8d46c70c 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/product_channel.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/product_channel.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message ProductChannelEnum { // The item is sold in local stores. LOCAL = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/product_channel_exclusivity.proto b/third_party/googleapis/google/ads/googleads/v1/enums/product_channel_exclusivity.proto index 839f3aabd..49fedc58f 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/product_channel_exclusivity.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/product_channel_exclusivity.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -48,4 +47,6 @@ message ProductChannelExclusivityEnum { // it is available for purchase in both ShoppingProductChannels. MULTI_CHANNEL = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/product_condition.proto b/third_party/googleapis/google/ads/googleads/v1/enums/product_condition.proto index 14cf0560f..b1e819ac3 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/product_condition.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/product_condition.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -49,4 +48,6 @@ message ProductConditionEnum { // The product condition is used. USED = 5; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/product_type_level.proto b/third_party/googleapis/google/ads/googleads/v1/enums/product_type_level.proto index 7857e18aa..516dfd925 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/product_type_level.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/product_type_level.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -55,4 +54,6 @@ message ProductTypeLevelEnum { // Level 5. LEVEL5 = 11; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/promotion_extension_discount_modifier.proto b/third_party/googleapis/google/ads/googleads/v1/enums/promotion_extension_discount_modifier.proto index 5eaef320c..defbb5ec0 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/promotion_extension_discount_modifier.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/promotion_extension_discount_modifier.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -44,4 +43,6 @@ message PromotionExtensionDiscountModifierEnum { // 'Up to'. UP_TO = 2; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/promotion_extension_occasion.proto b/third_party/googleapis/google/ads/googleads/v1/enums/promotion_extension_occasion.proto index 824cabde2..9db26de35 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/promotion_extension_occasion.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/promotion_extension_occasion.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -153,4 +152,6 @@ message PromotionExtensionOccasionEnum { // Available in Japanese: Year-end Gift. YEAR_END_GIFT = 38; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/promotion_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v1/enums/promotion_placeholder_field.proto index dd9f0d1f3..3304235c9 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/promotion_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/promotion_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -91,4 +90,6 @@ message PromotionPlaceholderFieldEnum { // tracking. FINAL_URL_SUFFIX = 15; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/proximity_radius_units.proto b/third_party/googleapis/google/ads/googleads/v1/enums/proximity_radius_units.proto index cd6433e31..f61b8b6e1 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/proximity_radius_units.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/proximity_radius_units.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message ProximityRadiusUnitsEnum { // Kilometers KILOMETERS = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/quality_score_bucket.proto b/third_party/googleapis/google/ads/googleads/v1/enums/quality_score_bucket.proto index 397fd222a..01e9c46c0 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/quality_score_bucket.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/quality_score_bucket.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -49,4 +48,6 @@ message QualityScoreBucketEnum { // Quality of the creative is above average. ABOVE_AVERAGE = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/real_estate_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v1/enums/real_estate_placeholder_field.proto index 0d157abe1..1cddf8c90 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/real_estate_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/real_estate_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -111,4 +110,6 @@ message RealEstatePlaceholderFieldEnum { // Data Type: INT64. iOS app store ID. IOS_APP_STORE_ID = 19; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/recommendation_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/recommendation_type.proto index 6c3d2e381..3695e1e6f 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/recommendation_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/recommendation_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -88,4 +87,6 @@ message RecommendationTypeEnum { // budget. MOVE_UNUSED_BUDGET = 15; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/search_engine_results_page_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/search_engine_results_page_type.proto index 61bc78ddf..7d802d588 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/search_engine_results_page_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/search_engine_results_page_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -50,4 +49,6 @@ message SearchEngineResultsPageTypeEnum { // page. ADS_AND_ORGANIC = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/search_term_match_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/search_term_match_type.proto index ccaff2e6b..76e3630d7 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/search_term_match_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/search_term_match_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -55,4 +54,6 @@ message SearchTermMatchTypeEnum { // Phrase match (close variant). NEAR_PHRASE = 6; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/search_term_targeting_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/search_term_targeting_status.proto index ac482c3fd..4f1727d56 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/search_term_targeting_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/search_term_targeting_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -54,4 +53,6 @@ message SearchTermTargetingStatusEnum { // Search term is neither targeted nor excluded. NONE = 5; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/served_asset_field_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/served_asset_field_type.proto index c1d2ee9b8..ff366869d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/served_asset_field_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/served_asset_field_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -57,4 +56,6 @@ message ServedAssetFieldTypeEnum { // The asset is used in description 2. DESCRIPTION_2 = 6; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/shared_set_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/shared_set_status.proto index 42b90ea8f..285fa42f5 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/shared_set_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/shared_set_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message SharedSetStatusEnum { // The shared set is removed and can no longer be used. REMOVED = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/shared_set_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/shared_set_type.proto index 61f8aafaa..01e7565ed 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/shared_set_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/shared_set_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message SharedSetTypeEnum { // A set of placements that can be excluded from targeting. NEGATIVE_PLACEMENTS = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/simulation_modification_method.proto b/third_party/googleapis/google/ads/googleads/v1/enums/simulation_modification_method.proto index 308e6b29f..3e660cac2 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/simulation_modification_method.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/simulation_modification_method.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -50,4 +49,6 @@ message SimulationModificationMethodEnum { // do not include these resources. DEFAULT = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/simulation_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/simulation_type.proto index d0d7bcb4d..4be3e3080 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/simulation_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/simulation_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -52,4 +51,6 @@ message SimulationTypeEnum { // The simulation is for a bid modifier. BID_MODIFIER = 5; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/sitelink_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v1/enums/sitelink_placeholder_field.proto index 644464bb8..1715712ed 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/sitelink_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/sitelink_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -65,4 +64,6 @@ message SitelinkPlaceholderFieldEnum { // tracking. FINAL_URL_SUFFIX = 8; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/slot.proto b/third_party/googleapis/google/ads/googleads/v1/enums/slot.proto index a2a1fff27..045d55973 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/slot.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/slot.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -61,4 +60,6 @@ message SlotEnum { // Cross-network. MIXED = 8; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/spending_limit_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/spending_limit_type.proto index 5d36236a6..8e32a7c7a 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/spending_limit_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/spending_limit_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -44,4 +43,6 @@ message SpendingLimitTypeEnum { // Infinite, indicates unlimited spending power. INFINITE = 2; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/structured_snippet_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v1/enums/structured_snippet_placeholder_field.proto index 4ed19963d..48c345a1c 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/structured_snippet_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/structured_snippet_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -41,10 +40,9 @@ message StructuredSnippetPlaceholderFieldEnum { UNKNOWN = 1; // Data Type: STRING. The category of snippet of your products/services. - // Must match one of the predefined structured snippets headers exactly. - // See - // https://developers.google.com/adwords/api - // /docs/appendix/structured-snippet-headers + // Must match exactly one of the predefined structured snippets headers. + // For a list, visit + // https://developers.google.com/adwords/api/docs/appendix/structured-snippet-headers HEADER = 2; // Data Type: STRING_LIST. Text values that describe your products/services. @@ -52,4 +50,6 @@ message StructuredSnippetPlaceholderFieldEnum { // permitted. A snippet can be at most 25 characters. SNIPPETS = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/system_managed_entity_source.proto b/third_party/googleapis/google/ads/googleads/v1/enums/system_managed_entity_source.proto index 36732a588..bf42a3019 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/system_managed_entity_source.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/system_managed_entity_source.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -43,4 +42,6 @@ message SystemManagedResourceSourceEnum { // Generated ad variations experiment ad. AD_VARIATIONS = 2; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/target_cpa_opt_in_recommendation_goal.proto b/third_party/googleapis/google/ads/googleads/v1/enums/target_cpa_opt_in_recommendation_goal.proto index 6c3506a60..2e5e4a50f 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/target_cpa_opt_in_recommendation_goal.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/target_cpa_opt_in_recommendation_goal.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -53,4 +52,6 @@ message TargetCpaOptInRecommendationGoalEnum { // to, yet lower than, the actual CPA (computed for past 28 days). CLOSEST_CPA = 5; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/target_impression_share_location.proto b/third_party/googleapis/google/ads/googleads/v1/enums/target_impression_share_location.proto index f29cd4394..dd2f28f4d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/target_impression_share_location.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/target_impression_share_location.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -51,4 +50,6 @@ message TargetImpressionShareLocationEnum { // Top slot in the top box of ads. ABSOLUTE_TOP_OF_PAGE = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/targeting_dimension.proto b/third_party/googleapis/google/ads/googleads/v1/enums/targeting_dimension.proto index 5263e2cef..a7b709c91 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/targeting_dimension.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/targeting_dimension.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -70,4 +69,6 @@ message TargetingDimensionEnum { // Criteria for income range targeting. INCOME_RANGE = 9; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/time_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/time_type.proto index fa462f1f9..19fb4924e 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/time_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/time_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -47,4 +46,6 @@ message TimeTypeEnum { // An infinite point in the future. FOREVER = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/tracking_code_page_format.proto b/third_party/googleapis/google/ads/googleads/v1/enums/tracking_code_page_format.proto index 8991c7c9f..0012373bf 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/tracking_code_page_format.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/tracking_code_page_format.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message TrackingCodePageFormatEnum { // Google AMP page format. AMP = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/tracking_code_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/tracking_code_type.proto index af214ec10..0507fd826 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/tracking_code_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/tracking_code_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -51,4 +50,6 @@ message TrackingCodeTypeEnum { // function which fires the tag. CLICK_TO_CALL = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/travel_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v1/enums/travel_placeholder_field.proto index 708f063f6..21f6b36f3 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/travel_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/travel_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -124,4 +123,6 @@ message TravelPlaceholderFieldEnum { // Data Type: INT64. iOS app store ID. IOS_APP_STORE_ID = 21; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/user_interest_taxonomy_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/user_interest_taxonomy_type.proto index b66e485fd..2f72b03c3 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/user_interest_taxonomy_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/user_interest_taxonomy_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -55,4 +54,6 @@ message UserInterestTaxonomyTypeEnum { // User interest criteria for new smart phone users. NEW_SMART_PHONE_USER = 6; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_access_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_access_status.proto index 3ee9c9138..10d94962a 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_access_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_access_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message UserListAccessStatusEnum { // The access is disabled. DISABLED = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_closing_reason.proto b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_closing_reason.proto index 9e9293a86..f99ccd9c7 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_closing_reason.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_closing_reason.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -44,4 +43,6 @@ message UserListClosingReasonEnum { // The userlist was closed because of not being used for over one year. UNUSED = 2; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_combined_rule_operator.proto b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_combined_rule_operator.proto index a3699f81f..90690f11b 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_combined_rule_operator.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_combined_rule_operator.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -44,4 +43,6 @@ message UserListCombinedRuleOperatorEnum { // A AND NOT B. AND_NOT = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_crm_data_source_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_crm_data_source_type.proto index cdaf25341..05dd3ee21 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_crm_data_source_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_crm_data_source_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -47,4 +46,6 @@ message UserListCrmDataSourceTypeEnum { // The uploaded data is from a third-party voter file. THIRD_PARTY_VOTER_FILE = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_date_rule_item_operator.proto b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_date_rule_item_operator.proto index 043b55be3..0b4772094 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_date_rule_item_operator.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_date_rule_item_operator.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -50,4 +49,6 @@ message UserListDateRuleItemOperatorEnum { // After. AFTER = 5; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_logical_rule_operator.proto b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_logical_rule_operator.proto index c08003d32..a30710abc 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_logical_rule_operator.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_logical_rule_operator.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -47,4 +46,6 @@ message UserListLogicalRuleOperatorEnum { // Not - none of the operands. NONE = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_membership_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_membership_status.proto index 6b6001b13..82c16775e 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_membership_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_membership_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -48,4 +47,6 @@ message UserListMembershipStatusEnum { // Closed status - No new members being added. Cannot be used for targeting. CLOSED = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_number_rule_item_operator.proto b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_number_rule_item_operator.proto index 3b91468ac..f579f4006 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_number_rule_item_operator.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_number_rule_item_operator.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -56,4 +55,6 @@ message UserListNumberRuleItemOperatorEnum { // Less than or equal. LESS_THAN_OR_EQUAL = 7; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_prepopulation_status.proto b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_prepopulation_status.proto index 290e6f8a8..27432c9a2 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_prepopulation_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_prepopulation_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -47,4 +46,6 @@ message UserListPrepopulationStatusEnum { // Prepopulation failed. FAILED = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_rule_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_rule_type.proto index 6444d4d97..19b818a5b 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_rule_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_rule_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -44,4 +43,6 @@ message UserListRuleTypeEnum { // Disjunctive normal form. OR_OF_ANDS = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_size_range.proto b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_size_range.proto index 03d663fdb..41d65d58a 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_size_range.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_size_range.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -88,4 +87,6 @@ message UserListSizeRangeEnum { // User list has over 50 million users. OVER_FIFTY_MILLION = 17; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_string_rule_item_operator.proto b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_string_rule_item_operator.proto index e6d16c11a..8e2c9450c 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_string_rule_item_operator.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_string_rule_item_operator.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -62,4 +61,6 @@ message UserListStringRuleItemOperatorEnum { // Not ends with. NOT_ENDS_WITH = 9; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_type.proto b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_type.proto index ba9f95b00..a1bbd2811 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/user_list_type.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/user_list_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -59,4 +58,6 @@ message UserListTypeEnum { // emails or other formats. CRM_BASED = 7; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/vanity_pharma_display_url_mode.proto b/third_party/googleapis/google/ads/googleads/v1/enums/vanity_pharma_display_url_mode.proto index 46d4ec076..d007b0f89 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/vanity_pharma_display_url_mode.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/vanity_pharma_display_url_mode.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message VanityPharmaDisplayUrlModeEnum { // Replace vanity pharma URL with description of the website. WEBSITE_DESCRIPTION = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/vanity_pharma_text.proto b/third_party/googleapis/google/ads/googleads/v1/enums/vanity_pharma_text.proto index bcddf820d..4291acb1b 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/vanity_pharma_text.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/vanity_pharma_text.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -83,4 +82,6 @@ message VanityPharmaTextEnum { // vacunas con receta). PRESCRIPTION_VACCINE_WEBSITE_ES = 13; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/webpage_condition_operand.proto b/third_party/googleapis/google/ads/googleads/v1/enums/webpage_condition_operand.proto index 8910e27e0..bb305773f 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/webpage_condition_operand.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/webpage_condition_operand.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -55,4 +54,6 @@ message WebpageConditionOperandEnum { // Operand denoting a webpage custom label targeting condition. CUSTOM_LABEL = 6; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/enums/webpage_condition_operator.proto b/third_party/googleapis/google/ads/googleads/v1/enums/webpage_condition_operator.proto index 41a70fb50..7758ae6ea 100644 --- a/third_party/googleapis/google/ads/googleads/v1/enums/webpage_condition_operator.proto +++ b/third_party/googleapis/google/ads/googleads/v1/enums/webpage_condition_operator.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -47,4 +46,6 @@ message WebpageConditionOperatorEnum { // The argument web condition is part of the compared web condition. CONTAINS = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/account_budget_proposal_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/account_budget_proposal_error.proto index 9d7ff7b80..01f09b366 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/account_budget_proposal_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/account_budget_proposal_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -110,4 +109,6 @@ message AccountBudgetProposalErrorEnum { // Mutates are not allowed for the given billing setup. INVALID_BILLING_SETUP = 23; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/ad_customizer_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/ad_customizer_error.proto index 6b0bfc910..0cb4f1e59 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/ad_customizer_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/ad_customizer_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -55,4 +54,6 @@ message AdCustomizerErrorEnum { // A user list referenced in an IF function does not exist. UNKNOWN_USER_LIST = 6; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/ad_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/ad_error.proto index 3fa72c514..2265c5e24 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/ad_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/ad_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -450,4 +449,6 @@ message AdErrorEnum { // The display upload product type is not supported in this campaign. PRODUCT_TYPE_NOT_SUPPORTED_IN_THIS_CAMPAIGN = 133; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/ad_group_ad_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/ad_group_ad_error.proto index 5e60f6310..235499d60 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/ad_group_ad_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/ad_group_ad_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -66,4 +65,6 @@ message AdGroupAdErrorEnum { // An ad may only be modified once per call RESOURCE_REFERENCED_IN_MULTIPLE_OPS = 9; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/ad_group_bid_modifier_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/ad_group_bid_modifier_error.proto index 19a30b48b..fb5293466 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/ad_group_bid_modifier_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/ad_group_bid_modifier_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -47,4 +46,6 @@ message AdGroupBidModifierErrorEnum { // campaign is opted out of the same criterion. CANNOT_OVERRIDE_OPTED_OUT_CAMPAIGN_CRITERION_BID_MODIFIER = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/ad_group_criterion_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/ad_group_criterion_error.proto index 151d3f6f6..a759627bb 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/ad_group_criterion_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/ad_group_criterion_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -161,4 +160,6 @@ message AdGroupCriterionErrorEnum { // Listing group in an ADD operation specifies a non temporary criterion id. LISTING_GROUP_ADD_MAY_ONLY_USE_TEMP_ID = 47; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/ad_group_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/ad_group_error.proto index d755ca67f..58b3df6dd 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/ad_group_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/ad_group_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -79,4 +78,6 @@ message AdGroupErrorEnum { // campaigns that have DynamicSearchAdsSetting attached. CANNOT_ADD_ADGROUP_OF_TYPE_DSA_TO_CAMPAIGN_WITHOUT_DSA_SETTING = 14; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/ad_group_feed_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/ad_group_feed_error.proto index 85781dff8..93c7f22a0 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/ad_group_feed_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/ad_group_feed_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -63,4 +62,6 @@ message AdGroupFeedErrorEnum { // CustomerFeed for the specified feed. NO_EXISTING_LOCATION_CUSTOMER_FEED = 8; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/ad_parameter_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/ad_parameter_error.proto index f4eeac966..64b72ddfb 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/ad_parameter_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/ad_parameter_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message AdParameterErrorEnum { // The insertion text is invalid. INVALID_INSERTION_TEXT_FORMAT = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/ad_sharing_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/ad_sharing_error.proto index 8e0c66ac3..7b5566693 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/ad_sharing_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/ad_sharing_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -50,4 +49,6 @@ message AdSharingErrorEnum { // Cannot add AdGroupAd on inactive Ad. CANNOT_SHARE_INACTIVE_AD = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/adx_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/adx_error.proto index ee1613044..5f80474f0 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/adx_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/adx_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -43,4 +42,6 @@ message AdxErrorEnum { // Attempt to use non-AdX feature by AdX customer. UNSUPPORTED_FEATURE = 2; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/asset_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/asset_error.proto index dcdb4deeb..cd456f202 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/asset_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/asset_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -57,4 +56,6 @@ message AssetErrorEnum { // represents the same content. CANNOT_MODIFY_ASSET_NAME = 6; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/authentication_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/authentication_error.proto index 093322abb..9a45e4b9f 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/authentication_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/authentication_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -99,4 +98,6 @@ message AuthenticationErrorEnum { // Google account at https://landing.google.com/advancedprotection. ADVANCED_PROTECTION_NOT_ENROLLED = 24; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/authorization_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/authorization_error.proto index 8eecb446a..d8ddf1fe1 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/authorization_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/authorization_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -41,10 +40,9 @@ message AuthorizationErrorEnum { UNKNOWN = 1; // User doesn't have permission to access customer. Note: If you're - // accessing a client customer, the manager's customer id must be set in the - // 'login-customer-id' header. See - // https://developers.google.com/google-ads/api/docs/concepts/ - // call-structure#login-customer-id + // accessing a client customer, the manager's customer ID must be set in the + // `login-customer-id` header. Learn more at + // https://developers.google.com/google-ads/api/docs/concepts/call-structure#cid USER_PERMISSION_DENIED = 2; // The developer token is not whitelisted. @@ -78,4 +76,6 @@ message AuthorizationErrorEnum { // only be used with test accounts. DEVELOPER_TOKEN_NOT_APPROVED = 10; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/bidding_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/bidding_error.proto index 84789fe55..58f1b6fda 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/bidding_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/bidding_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -70,8 +69,7 @@ message BiddingErrorEnum { // Cannot target content network only as campaign uses Page One Promoted // bidding strategy. - CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_CAMPAIGN_LEVEL_POP_BIDDING_STRATEGY = - 23; + CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_CAMPAIGN_LEVEL_POP_BIDDING_STRATEGY = 23; // Budget Optimizer and Target Spend bidding strategies are not supported // for campaigns with AdSchedule targeting. @@ -115,4 +113,6 @@ message BiddingErrorEnum { // The field is not compatible with the bidding strategy type. NOT_COMPATIBLE_WITH_BIDDING_STRATEGY_TYPE = 36; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/bidding_strategy_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/bidding_strategy_error.proto index 8489fb4fa..ce7c1256c 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/bidding_strategy_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/bidding_strategy_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -57,4 +56,6 @@ message BiddingStrategyErrorEnum { // strategy goal type. INCOMPATIBLE_BIDDING_STRATEGY_AND_BIDDING_STRATEGY_GOAL_TYPE = 6; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/billing_setup_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/billing_setup_error.proto index 4298be4c3..bdcc616cf 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/billing_setup_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/billing_setup_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -40,61 +39,63 @@ message BillingSetupErrorEnum { // The received error code is not known in this version. UNKNOWN = 1; - // Cannot use both an existing Payments account and a new Payments account - // when setting up billing. + // Cannot specify both an existing payments account and a new payments + // account when setting up billing. CANNOT_USE_EXISTING_AND_NEW_ACCOUNT = 2; - // Cannot cancel an APPROVED billing setup whose start time has passed. + // Cannot cancel an approved billing setup whose start time has passed. CANNOT_REMOVE_STARTED_BILLING_SETUP = 3; - // Cannot perform a Change of Bill-To (CBT) to the same Payments account. + // Cannot perform a Change of Bill-To (CBT) to the same payments account. CANNOT_CHANGE_BILLING_TO_SAME_PAYMENTS_ACCOUNT = 4; - // Billing Setups can only be used by customers with ENABLED or DRAFT + // Billing setups can only be used by customers with ENABLED or DRAFT // status. BILLING_SETUP_NOT_PERMITTED_FOR_CUSTOMER_STATUS = 5; - // Billing Setups must either include a correctly formatted existing - // Payments account id, or a non-empty new Payments account name. + // Billing setups must either include a correctly formatted existing + // payments account id, or a non-empty new payments account name. INVALID_PAYMENTS_ACCOUNT = 6; // Only billable and third-party customers can create billing setups. BILLING_SETUP_NOT_PERMITTED_FOR_CUSTOMER_CATEGORY = 7; - // Billing Setup creations can only use NOW for start time type. + // Billing setup creations can only use NOW for start time type. INVALID_START_TIME_TYPE = 8; - // Billing Setups can only be created for a third-party customer if they do + // Billing setups can only be created for a third-party customer if they do // not already have a setup. THIRD_PARTY_ALREADY_HAS_BILLING = 9; - // Billing Setups cannot be created if there is already a pending billing in - // progress, ie. a billing known to Payments. + // Billing setups cannot be created if there is already a pending billing in + // progress. BILLING_SETUP_IN_PROGRESS = 10; - // Billing Setups can only be created by customers who have permission to + // Billing setups can only be created by customers who have permission to // setup billings. Users can contact a representative for help setting up // permissions. NO_SIGNUP_PERMISSION = 11; - // Billing Setups cannot be created if there is already a future-approved + // Billing setups cannot be created if there is already a future-approved // billing. CHANGE_OF_BILL_TO_IN_PROGRESS = 12; - // Billing Setup creation failed because Payments could not find the - // requested Payments profile. + // Requested payments profile not found. PAYMENTS_PROFILE_NOT_FOUND = 13; - // Billing Setup creation failed because Payments could not find the - // requested Payments account. + // Requested payments account not found. PAYMENTS_ACCOUNT_NOT_FOUND = 14; - // Billing Setup creation failed because Payments considers requested - // Payments profile ineligible. + // Billing setup creation failed because the payments profile is ineligible. PAYMENTS_PROFILE_INELIGIBLE = 15; - // Billing Setup creation failed because Payments considers requested - // Payments account ineligible. + // Billing setup creation failed because the payments account is ineligible. PAYMENTS_ACCOUNT_INELIGIBLE = 16; + + // Billing setup creation failed because the payments profile needs internal + // approval. + CUSTOMER_NEEDS_INTERNAL_APPROVAL = 17; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/campaign_budget_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/campaign_budget_error.proto index b4faaf74f..4793c3672 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/campaign_budget_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/campaign_budget_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -90,4 +89,6 @@ message CampaignBudgetErrorEnum { // A money amount was not a multiple of a minimum unit. NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT = 16; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/campaign_criterion_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/campaign_criterion_error.proto index 98a955f2d..9e37d29e9 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/campaign_criterion_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/campaign_criterion_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -77,4 +76,6 @@ message CampaignCriterionErrorEnum { // Negative criteria are immutable, so updates are not allowed. CANNOT_UPDATE_NEGATIVE_CRITERION = 12; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/campaign_draft_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/campaign_draft_error.proto index 0835a9d58..e39988ca5 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/campaign_draft_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/campaign_draft_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/campaign_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/campaign_error.proto index 16c759fb6..3128993f6 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/campaign_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/campaign_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -82,11 +81,11 @@ message CampaignErrorEnum { // Given status is invalid. INVALID_AD_SERVING_OPTIMIZATION_STATUS = 15; - // Error in the campaign level tracking url. + // Error in the campaign level tracking URL. INVALID_TRACKING_URL = 16; - // Cannot set both tracking url template and tracking setting. An user has - // to clear legacy tracking setting in order to add tracking url template. + // Cannot set both tracking URL template and tracking setting. A user has + // to clear legacy tracking setting in order to add tracking URL template. CANNOT_SET_BOTH_TRACKING_URL_TEMPLATE_AND_TRACKING_SETTING = 17; // The maximum number of impressions for Frequency Cap should be an integer @@ -171,4 +170,6 @@ message CampaignErrorEnum { // Comparison Listing Ads. MERCHANT_NOT_ALLOWED_FOR_COMPARISON_LISTING_ADS = 43; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/campaign_experiment_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/campaign_experiment_error.proto index c2f38cf3e..94737a9f5 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/campaign_experiment_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/campaign_experiment_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/campaign_feed_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/campaign_feed_error.proto index a918de901..7940d209e 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/campaign_feed_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/campaign_feed_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -59,4 +58,6 @@ message CampaignFeedErrorEnum { // Feed mapping for this placeholder type does not exist. MISSING_FEEDMAPPING_FOR_PLACEHOLDER_TYPE = 8; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/campaign_shared_set_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/campaign_shared_set_error.proto index f6572032a..99261b050 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/campaign_shared_set_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/campaign_shared_set_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -43,4 +42,6 @@ message CampaignSharedSetErrorEnum { // The shared set belongs to another customer and permission isn't granted. SHARED_SET_ACCESS_DENIED = 2; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/change_status_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/change_status_error.proto index 9c76488f6..4fe6010db 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/change_status_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/change_status_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -43,4 +42,6 @@ message ChangeStatusErrorEnum { // The requested start date is too old. START_DATE_TOO_OLD = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/collection_size_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/collection_size_error.proto index ea8746124..343d62a5a 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/collection_size_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/collection_size_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message CollectionSizeErrorEnum { // Too many. TOO_MANY = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/context_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/context_error.proto index 49a4fccbd..80a5492c5 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/context_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/context_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message ContextErrorEnum { // The operation is not allowed for removed resources. OPERATION_NOT_PERMITTED_FOR_REMOVED_RESOURCE = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/conversion_action_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/conversion_action_error.proto index f35075317..a29021592 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/conversion_action_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/conversion_action_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -71,4 +70,6 @@ message ConversionActionErrorEnum { // added. DATA_DRIVEN_MODEL_UNKNOWN = 9; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/conversion_adjustment_upload_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/conversion_adjustment_upload_error.proto index 1de28be1c..0f9b17baa 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/conversion_adjustment_upload_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/conversion_adjustment_upload_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -73,7 +72,8 @@ message ConversionAdjustmentUploadErrorEnum { // Restatements cannot be reported for a conversion action that always uses // the default value. - CANNOT_RESTATE_CONVERSION_ACTION_THAT_ALWAYS_USES_DEFAULT_CONVERSION_VALUE = - 10; + CANNOT_RESTATE_CONVERSION_ACTION_THAT_ALWAYS_USES_DEFAULT_CONVERSION_VALUE = 10; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/conversion_upload_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/conversion_upload_error.proto index 8d8f53382..112b80a2c 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/conversion_upload_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/conversion_upload_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -56,7 +55,7 @@ message ConversionUploadErrorEnum { EXPIRED_GCLID = 5; // The click associated with the given gclid occurred too recently. Please - // try uploading again after 24 hours have passed since the click occurred. + // try uploading again after 6 hours have passed since the click occurred. TOO_RECENT_GCLID = 6; // The click associated with the given gclid could not be found in the @@ -83,15 +82,13 @@ message ConversionUploadErrorEnum { // The specified conversion action does not use an external attribution // model, but external_attribution_data was set. - EXTERNAL_ATTRIBUTION_DATA_SET_FOR_NON_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION = - 12; + EXTERNAL_ATTRIBUTION_DATA_SET_FOR_NON_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION = 12; // The specified conversion action uses an external attribution model, but // external_attribution_data or one of its contained fields was not set. // Both external_attribution_credit and external_attribution_model must be // set for externally attributed conversion actions. - EXTERNAL_ATTRIBUTION_DATA_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION = - 13; + EXTERNAL_ATTRIBUTION_DATA_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION = 13; // Order IDs are not supported for conversion actions which use an external // attribution model. @@ -105,7 +102,7 @@ message ConversionUploadErrorEnum { // conversion action combination. DUPLICATE_ORDER_ID = 16; - // The call occurred too recently. Please try uploading again after 24 hours + // The call occurred too recently. Please try uploading again after 6 hours // have passed since the call occurred. TOO_RECENT_CALL = 17; @@ -128,4 +125,6 @@ message ConversionUploadErrorEnum { // number "6502531234". UNPARSEABLE_CALLERS_PHONE_NUMBER = 22; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/country_code_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/country_code_error.proto index 18122a07c..5f9445211 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/country_code_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/country_code_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -43,4 +42,6 @@ message CountryCodeErrorEnum { // The country code is invalid. INVALID_COUNTRY_CODE = 2; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/criterion_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/criterion_error.proto index a471293af..97a052af8 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/criterion_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/criterion_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -365,4 +364,6 @@ message CriterionErrorEnum { // A webpage criterion cannot be added to a non-DSA ad group. WEBPAGE_CRITERION_NOT_SUPPORTED_ON_NON_DSA_AD_GROUP = 95; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/custom_interest_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/custom_interest_error.proto index 61664befc..2a5310bd1 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/custom_interest_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/custom_interest_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -62,4 +61,6 @@ message CustomInterestErrorEnum { // Cannot mutate custom interest type. CANNOT_CHANGE_TYPE = 8; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/customer_client_link_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/customer_client_link_error.proto index 8c360ab56..6a0d5ac50 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/customer_client_link_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/customer_client_link_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -61,4 +60,6 @@ message CustomerClientLinkErrorEnum { // Parent manager account has the maximum number of linked accounts. CUSTOMER_HAS_TOO_MANY_ACCOUNTS_AT_MANAGER = 8; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/customer_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/customer_error.proto index f694c8877..2069e71a6 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/customer_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/customer_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -47,4 +46,6 @@ message CustomerErrorEnum { // CustomerService cannot get a customer that has not been fully set up. ACCOUNT_NOT_SET_UP = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/customer_feed_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/customer_feed_error.proto index aaefc25ea..68d7df5fa 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/customer_feed_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/customer_feed_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -62,4 +61,6 @@ message CustomerFeedErrorEnum { // Placeholder not allowed at the account level. PLACEHOLDER_TYPE_NOT_ALLOWED_ON_CUSTOMER_FEED = 8; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/customer_manager_link_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/customer_manager_link_error.proto index bb8487ce2..9a3e5c556 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/customer_manager_link_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/customer_manager_link_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -67,4 +66,6 @@ message CustomerManagerLinkErrorEnum { // duplicate children. DUPLICATE_CHILD_FOUND = 9; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/database_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/database_error.proto index 18438fa9a..d1369ca19 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/database_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/database_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -44,4 +43,6 @@ message DatabaseErrorEnum { // Please retry the request. CONCURRENT_MODIFICATION = 2; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/date_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/date_error.proto index a7848ffdd..981b88234 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/date_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/date_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -70,4 +69,6 @@ message DateErrorEnum { // Both dates in range are null. DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL = 10; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/date_range_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/date_range_error.proto index 96b91891b..fbedd34ff 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/date_range_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/date_range_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -55,4 +54,6 @@ message DateRangeErrorEnum { // Trying to change start date on a resource that has started. CANNOT_MODIFY_START_DATE_IF_ALREADY_STARTED = 6; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/distinct_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/distinct_error.proto index d715d500a..6cd6df6d7 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/distinct_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/distinct_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message DistinctErrorEnum { // Duplicate type. DUPLICATE_TYPE = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/enum_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/enum_error.proto index 650d39811..80099f0ae 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/enum_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/enum_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -43,4 +42,6 @@ message EnumErrorEnum { // The enum value is not permitted. ENUM_VALUE_NOT_PERMITTED = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/errors.proto b/third_party/googleapis/google/ads/googleads/v1/errors/errors.proto index 34aa4e188..256a6d683 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/errors.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/errors.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -121,8 +120,8 @@ import "google/ads/googleads/v1/errors/string_length_error.proto"; import "google/ads/googleads/v1/errors/url_field_error.proto"; import "google/ads/googleads/v1/errors/user_list_error.proto"; import "google/ads/googleads/v1/errors/youtube_video_registration_error.proto"; -import "google/api/annotations.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Errors"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/errors;errors"; @@ -211,8 +210,7 @@ message ErrorCode { AuthenticationErrorEnum.AuthenticationError authentication_error = 17; // Indicates failure to properly authenticate user. - AdGroupCriterionErrorEnum.AdGroupCriterionError ad_group_criterion_error = - 18; + AdGroupCriterionErrorEnum.AdGroupCriterionError ad_group_criterion_error = 18; // The reasons for the ad customizer error AdCustomizerErrorEnum.AdCustomizerError ad_customizer_error = 19; @@ -233,8 +231,7 @@ message ErrorCode { BiddingErrorEnum.BiddingError bidding_error = 26; // The reasons for the campaign criterion error - CampaignCriterionErrorEnum.CampaignCriterionError campaign_criterion_error = - 29; + CampaignCriterionErrorEnum.CampaignCriterionError campaign_criterion_error = 29; // The reasons for the collection size error CollectionSizeErrorEnum.CollectionSizeError collection_size_error = 31; @@ -258,8 +255,7 @@ message ErrorCode { DistinctErrorEnum.DistinctError distinct_error = 35; // The reasons for the feed attribute reference error - FeedAttributeReferenceErrorEnum.FeedAttributeReferenceError - feed_attribute_reference_error = 36; + FeedAttributeReferenceErrorEnum.FeedAttributeReferenceError feed_attribute_reference_error = 36; // The reasons for the function error FunctionErrorEnum.FunctionError function_error = 37; @@ -289,8 +285,7 @@ message ErrorCode { MultiplierErrorEnum.MultiplierError multiplier_error = 44; // The reasons for the new resource creation error - NewResourceCreationErrorEnum.NewResourceCreationError - new_resource_creation_error = 45; + NewResourceCreationErrorEnum.NewResourceCreationError new_resource_creation_error = 45; // The reasons for the not empty error NotEmptyErrorEnum.NotEmptyError not_empty_error = 46; @@ -320,24 +315,19 @@ message ErrorCode { StringLengthErrorEnum.StringLengthError string_length_error = 54; // The reasons for the operation access denied error - OperationAccessDeniedErrorEnum.OperationAccessDeniedError - operation_access_denied_error = 55; + OperationAccessDeniedErrorEnum.OperationAccessDeniedError operation_access_denied_error = 55; // The reasons for the resource access denied error - ResourceAccessDeniedErrorEnum.ResourceAccessDeniedError - resource_access_denied_error = 56; + ResourceAccessDeniedErrorEnum.ResourceAccessDeniedError resource_access_denied_error = 56; // The reasons for the resource count limit exceeded error - ResourceCountLimitExceededErrorEnum.ResourceCountLimitExceededError - resource_count_limit_exceeded_error = 57; + ResourceCountLimitExceededErrorEnum.ResourceCountLimitExceededError resource_count_limit_exceeded_error = 57; // The reasons for YouTube video registration errors. - YoutubeVideoRegistrationErrorEnum.YoutubeVideoRegistrationError - youtube_video_registration_error = 117; + YoutubeVideoRegistrationErrorEnum.YoutubeVideoRegistrationError youtube_video_registration_error = 117; // The reasons for the ad group bid modifier error - AdGroupBidModifierErrorEnum.AdGroupBidModifierError - ad_group_bid_modifier_error = 59; + AdGroupBidModifierErrorEnum.AdGroupBidModifierError ad_group_bid_modifier_error = 59; // The reasons for the context error ContextErrorEnum.ContextError context_error = 60; @@ -352,20 +342,16 @@ message ErrorCode { SharedCriterionErrorEnum.SharedCriterionError shared_criterion_error = 63; // The reasons for the campaign shared set error - CampaignSharedSetErrorEnum.CampaignSharedSetError - campaign_shared_set_error = 64; + CampaignSharedSetErrorEnum.CampaignSharedSetError campaign_shared_set_error = 64; // The reasons for the conversion action error - ConversionActionErrorEnum.ConversionActionError conversion_action_error = - 65; + ConversionActionErrorEnum.ConversionActionError conversion_action_error = 65; // The reasons for the conversion adjustment upload error - ConversionAdjustmentUploadErrorEnum.ConversionAdjustmentUploadError - conversion_adjustment_upload_error = 115; + ConversionAdjustmentUploadErrorEnum.ConversionAdjustmentUploadError conversion_adjustment_upload_error = 115; // The reasons for the conversion upload error - ConversionUploadErrorEnum.ConversionUploadError conversion_upload_error = - 111; + ConversionUploadErrorEnum.ConversionUploadError conversion_upload_error = 111; // The reasons for the header error. HeaderErrorEnum.HeaderError header_error = 66; @@ -383,27 +369,22 @@ message ErrorCode { KeywordPlanErrorEnum.KeywordPlanError keyword_plan_error = 71; // The reason for keyword plan campaign error. - KeywordPlanCampaignErrorEnum.KeywordPlanCampaignError - keyword_plan_campaign_error = 72; + KeywordPlanCampaignErrorEnum.KeywordPlanCampaignError keyword_plan_campaign_error = 72; // The reason for keyword plan negative keyword error. - KeywordPlanNegativeKeywordErrorEnum.KeywordPlanNegativeKeywordError - keyword_plan_negative_keyword_error = 73; + KeywordPlanNegativeKeywordErrorEnum.KeywordPlanNegativeKeywordError keyword_plan_negative_keyword_error = 73; // The reason for keyword plan ad group error. - KeywordPlanAdGroupErrorEnum.KeywordPlanAdGroupError - keyword_plan_ad_group_error = 74; + KeywordPlanAdGroupErrorEnum.KeywordPlanAdGroupError keyword_plan_ad_group_error = 74; // The reason for keyword plan keyword error. - KeywordPlanKeywordErrorEnum.KeywordPlanKeywordError - keyword_plan_keyword_error = 75; + KeywordPlanKeywordErrorEnum.KeywordPlanKeywordError keyword_plan_keyword_error = 75; // The reason for keyword idea error. KeywordPlanIdeaErrorEnum.KeywordPlanIdeaError keyword_plan_idea_error = 76; // The reasons for account budget proposal errors. - AccountBudgetProposalErrorEnum.AccountBudgetProposalError - account_budget_proposal_error = 77; + AccountBudgetProposalErrorEnum.AccountBudgetProposalError account_budget_proposal_error = 77; // The reasons for the user list error UserListErrorEnum.UserListError user_list_error = 78; @@ -415,8 +396,7 @@ message ErrorCode { FeedErrorEnum.FeedError feed_error = 80; // The reasons for the geo target constant suggestion error. - GeoTargetConstantSuggestionErrorEnum.GeoTargetConstantSuggestionError - geo_target_constant_suggestion_error = 81; + GeoTargetConstantSuggestionErrorEnum.GeoTargetConstantSuggestionError geo_target_constant_suggestion_error = 81; // The reasons for the campaign draft error CampaignDraftErrorEnum.CampaignDraftError campaign_draft_error = 82; @@ -431,12 +411,10 @@ message ErrorCode { BillingSetupErrorEnum.BillingSetupError billing_setup_error = 87; // The reasons for the customer client link error - CustomerClientLinkErrorEnum.CustomerClientLinkError - customer_client_link_error = 88; + CustomerClientLinkErrorEnum.CustomerClientLinkError customer_client_link_error = 88; // The reasons for the customer manager link error - CustomerManagerLinkErrorEnum.CustomerManagerLinkError - customer_manager_link_error = 91; + CustomerManagerLinkErrorEnum.CustomerManagerLinkError customer_manager_link_error = 91; // The reasons for the feed mapping error FeedMappingErrorEnum.FeedMappingError feed_mapping_error = 92; @@ -457,19 +435,16 @@ message ErrorCode { CampaignExperimentErrorEnum.CampaignExperimentError campaign_experiment_error = 98; // The reasons for the extension feed item error - ExtensionFeedItemErrorEnum.ExtensionFeedItemError - extension_feed_item_error = 100; + ExtensionFeedItemErrorEnum.ExtensionFeedItemError extension_feed_item_error = 100; // The reasons for the ad parameter error AdParameterErrorEnum.AdParameterError ad_parameter_error = 101; // The reasons for the feed item validation error - FeedItemValidationErrorEnum.FeedItemValidationError - feed_item_validation_error = 102; + FeedItemValidationErrorEnum.FeedItemValidationError feed_item_validation_error = 102; // The reasons for the extension setting error - ExtensionSettingErrorEnum.ExtensionSettingError extension_setting_error = - 103; + ExtensionSettingErrorEnum.ExtensionSettingError extension_setting_error = 103; // The reasons for the feed item target error FeedItemTargetErrorEnum.FeedItemTargetError feed_item_target_error = 104; @@ -484,8 +459,7 @@ message ErrorCode { PartialFailureErrorEnum.PartialFailureError partial_failure_error = 112; // The reasons for the policy validation parameter error - PolicyValidationParameterErrorEnum.PolicyValidationParameterError - policy_validation_parameter_error = 114; + PolicyValidationParameterErrorEnum.PolicyValidationParameterError policy_validation_parameter_error = 114; // The reasons for the size limit error SizeLimitErrorEnum.SizeLimitError size_limit_error = 118; @@ -551,6 +525,5 @@ message PolicyFindingDetails { // The list of policy topics for the resource. Contains the PROHIBITED or // FULLY_LIMITED policy topic entries that prevented the resource from being // saved (among any other entries the resource may also have). - repeated google.ads.googleads.v1.common.PolicyTopicEntry - policy_topic_entries = 1; + repeated google.ads.googleads.v1.common.PolicyTopicEntry policy_topic_entries = 1; } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/extension_feed_item_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/extension_feed_item_error.proto index 9ab38917f..39f285ecf 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/extension_feed_item_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/extension_feed_item_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -184,4 +183,6 @@ message ExtensionFeedItemErrorEnum { // This field has too many decimal places specified. TOO_MANY_DECIMAL_PLACES_SPECIFIED = 44; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/extension_setting_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/extension_setting_error.proto index 2883c1a09..cefdbb99f 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/extension_setting_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/extension_setting_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -253,4 +252,6 @@ message ExtensionSettingErrorEnum { // name in the update mask. EXTENSION_SETTING_UPDATE_IS_A_NOOP = 67; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/feed_attribute_reference_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/feed_attribute_reference_error.proto index e3be51cee..b140e848e 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/feed_attribute_reference_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/feed_attribute_reference_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -49,4 +48,6 @@ message FeedAttributeReferenceErrorEnum { // There is no feed attribute in an enabled feed with the given name. INVALID_FEED_ATTRIBUTE_NAME = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/feed_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/feed_error.proto index d58b2e251..3420c63be 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/feed_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/feed_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -101,4 +100,6 @@ message FeedErrorEnum { // There is already a feed with the given system feed generation data. DUPLICATE_SYSTEM_FEED = 21; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/feed_item_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/feed_item_error.proto index d2e1d43a2..70af9a105 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/feed_item_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/feed_item_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -67,4 +66,6 @@ message FeedItemErrorEnum { // The feed attribute value is too large. SIZE_TOO_LARGE_FOR_MULTI_VALUE_ATTRIBUTE = 10; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/feed_item_target_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/feed_item_target_error.proto index ae72ec2a5..ad1e0c55a 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/feed_item_target_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/feed_item_target_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -60,4 +59,6 @@ message FeedItemTargetErrorEnum { // group target. CANNOT_HAVE_ENABLED_CAMPAIGN_AND_ENABLED_AD_GROUP_TARGETS = 7; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/feed_item_validation_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/feed_item_validation_error.proto index c8d2eb965..f7a9966fe 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/feed_item_validation_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/feed_item_validation_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -343,4 +342,6 @@ message FeedItemValidationErrorEnum { // Longitude value is missing. MISSING_LONGITUDE_VALUE = 96; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/feed_mapping_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/feed_mapping_error.proto index 7084bd5fd..d5505eaa0 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/feed_mapping_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/feed_mapping_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -93,4 +92,6 @@ message FeedMappingErrorEnum { // with the given type. INVALID_PLACEHOLDER_TYPE_FOR_SYSTEM_GENERATED_FEED_TYPE = 18; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/field_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/field_error.proto index 5d60fdfd7..e39986881 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/field_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/field_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -61,4 +60,6 @@ message FieldErrorEnum { // The field's value is on a blacklist for this field. BLACKLISTED_VALUE = 8; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/field_mask_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/field_mask_error.proto index e07334b16..520c9f287 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/field_mask_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/field_mask_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -54,4 +53,6 @@ message FieldMaskErrorEnum { // all the subfields of the invalid field. FIELD_HAS_SUBFIELDS = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/function_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/function_error.proto index 4d726d5b5..0d6763fb7 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/function_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/function_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -89,4 +88,6 @@ message FunctionErrorEnum { // Invalid attribute name. INVALID_ATTRIBUTE_NAME = 17; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/function_parsing_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/function_parsing_error.proto index ad3e1fc0f..1361fe202 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/function_parsing_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/function_parsing_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -73,4 +72,6 @@ message FunctionParsingErrorEnum { // Function had too many operands. TOO_MANY_OPERANDS = 12; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/geo_target_constant_suggestion_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/geo_target_constant_suggestion_error.proto index 5af9e7408..6219dd305 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/geo_target_constant_suggestion_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/geo_target_constant_suggestion_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -52,4 +51,6 @@ message GeoTargetConstantSuggestionErrorEnum { // the request. REQUEST_PARAMETERS_UNSET = 5; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/header_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/header_error.proto index a3c7e5a7f..bbc789473 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/header_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/header_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -43,4 +42,6 @@ message HeaderErrorEnum { // The login customer id could not be validated. INVALID_LOGIN_CUSTOMER_ID = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/id_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/id_error.proto index 2a5a4e7f5..a940e35ee 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/id_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/id_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -43,4 +42,6 @@ message IdErrorEnum { // Id not found NOT_FOUND = 2; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/image_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/image_error.proto index d58e7da83..bb4486177 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/image_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/image_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -152,4 +151,6 @@ message ImageErrorEnum { // There was a problem reading the image file. PROBLEM_READING_FILE = 38; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/internal_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/internal_error.proto index ae89eaf9a..26552666e 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/internal_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/internal_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -43,12 +42,14 @@ message InternalErrorEnum { // Google Ads API encountered unexpected internal error. INTERNAL_ERROR = 2; - // The intended error code doesn't exist in any API version. This will be - // fixed by adding a new error code as soon as possible. + // The intended error code doesn't exist in specified API version. It will + // be released in a future API version. ERROR_CODE_NOT_PUBLISHED = 3; // Google Ads API encountered an unexpected transient error. The user // should retry their request in these cases. TRANSIENT_ERROR = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/keyword_plan_ad_group_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/keyword_plan_ad_group_error.proto index 1bf241a6f..5e7ef2290 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/keyword_plan_ad_group_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/keyword_plan_ad_group_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -49,4 +48,6 @@ message KeywordPlanAdGroupErrorEnum { // AdGroup name or other keyword plan AdGroup name in the request. DUPLICATE_NAME = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/keyword_plan_campaign_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/keyword_plan_campaign_error.proto index a91299d66..ab0820988 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/keyword_plan_campaign_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/keyword_plan_campaign_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -58,4 +57,6 @@ message KeywordPlanCampaignErrorEnum { // The number of geo targets in the keyword plan campaign exceeds limits. MAX_GEOS_EXCEEDED = 6; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/keyword_plan_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/keyword_plan_error.proto index 7031f745d..1db1eff68 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/keyword_plan_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/keyword_plan_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -87,4 +86,6 @@ message KeywordPlanErrorEnum { // The plan's name is invalid. INVALID_NAME = 16; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/keyword_plan_idea_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/keyword_plan_idea_error.proto index 351eae94e..3a0a235f5 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/keyword_plan_idea_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/keyword_plan_idea_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message KeywordPlanIdeaErrorEnum { // The input has an invalid value. INVALID_VALUE = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/keyword_plan_keyword_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/keyword_plan_keyword_error.proto index 85afa96e2..f36cbcdb1 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/keyword_plan_keyword_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/keyword_plan_keyword_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -61,4 +60,6 @@ message KeywordPlanKeywordErrorEnum { // Keyword or negative keyword has invalid text. INVALID_KEYWORD_TEXT = 7; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/keyword_plan_negative_keyword_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/keyword_plan_negative_keyword_error.proto index 840b2d6d4..6e66cc406 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/keyword_plan_negative_keyword_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/keyword_plan_negative_keyword_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -42,4 +41,6 @@ message KeywordPlanNegativeKeywordErrorEnum { // The received error code is not known in this version. UNKNOWN = 1; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/label_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/label_error.proto index 9085f847b..0053452b1 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/label_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/label_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -69,4 +68,6 @@ message LabelErrorEnum { // resource. CANNOT_ATTACH_NON_MANAGER_LABEL_TO_CUSTOMER = 10; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/language_code_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/language_code_error.proto index fb861c621..73a427576 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/language_code_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/language_code_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message LanguageCodeErrorEnum { // The language is not allowed to use. INVALID_LANGUAGE_CODE = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/list_operation_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/list_operation_error.proto index 3525c7fe8..abf58a4bd 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/list_operation_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/list_operation_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message ListOperationErrorEnum { // Duplicate or identical value is sent in multiple list operations. DUPLICATE_VALUES = 8; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/manager_link_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/manager_link_error.proto index 67494823a..bc7d418f7 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/manager_link_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/manager_link_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/media_bundle_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/media_bundle_error.proto index e04d3e8a9..e31218f1f 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/media_bundle_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/media_bundle_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -106,4 +105,6 @@ message MediaBundleErrorEnum { // Custom exits not allowed in HTML5 entry. CUSTOM_EXIT_NOT_ALLOWED = 24; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/media_file_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/media_file_error.proto index ed906596c..4c082004e 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/media_file_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/media_file_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -109,4 +108,6 @@ message MediaFileErrorEnum { // The YouTube video ID is syntactically valid but the video was not found. YOU_TUBE_VIDEO_NOT_FOUND = 24; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/media_upload_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/media_upload_error.proto index 66edf6197..2474d6707 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/media_upload_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/media_upload_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -52,4 +51,6 @@ message MediaUploadErrorEnum { // The image or media bundle format is not allowed. FORMAT_NOT_ALLOWED = 5; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/multiplier_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/multiplier_error.proto index 845e71c1b..bc006fecf 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/multiplier_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/multiplier_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -77,4 +76,6 @@ message MultiplierErrorEnum { // Multiplier type (cpc vs. cpm) needs to match campaign's bidding strategy MULTIPLIER_AND_BIDDING_STRATEGY_TYPE_MISMATCH = 13; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/mutate_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/mutate_error.proto index 42f828faa..a0b346b1c 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/mutate_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/mutate_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -59,4 +58,6 @@ message MutateErrorEnum { // The resource being created already exists. RESOURCE_ALREADY_EXISTS = 11; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/mutate_job_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/mutate_job_error.proto index 14ef13771..55cb37e19 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/mutate_job_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/mutate_job_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -56,4 +55,6 @@ message MutateJobErrorEnum { // The page size for ListMutateJobResults was invalid. INVALID_PAGE_SIZE = 6; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/new_resource_creation_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/new_resource_creation_error.proto index 216c86711..68ebec486 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/new_resource_creation_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/new_resource_creation_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -50,4 +49,6 @@ message NewResourceCreationErrorEnum { // validation will be done for this child resource. TEMP_ID_RESOURCE_HAD_ERRORS = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/not_empty_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/not_empty_error.proto index c87622e3c..7381108d8 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/not_empty_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/not_empty_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -43,4 +42,6 @@ message NotEmptyErrorEnum { // Empty list. EMPTY_LIST = 2; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/not_whitelisted_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/not_whitelisted_error.proto index 256efb2b9..e8062ee80 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/not_whitelisted_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/not_whitelisted_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/null_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/null_error.proto index 2c70a688d..889abec16 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/null_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/null_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -43,4 +42,6 @@ message NullErrorEnum { // Specified list/container must not contain any null elements NULL_CONTENT = 2; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/operation_access_denied_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/operation_access_denied_error.proto index 329e87767..66d162468 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/operation_access_denied_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/operation_access_denied_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -70,4 +69,6 @@ message OperationAccessDeniedErrorEnum { // The mutate is not allowed for this customer. MUTATE_NOT_PERMITTED_FOR_CUSTOMER = 11; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/operator_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/operator_error.proto index 2d037a492..9833d7dfd 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/operator_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/operator_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -43,4 +42,6 @@ message OperatorErrorEnum { // Operator not supported. OPERATOR_NOT_SUPPORTED = 2; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/partial_failure_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/partial_failure_error.proto index ca61292a8..9d1707c6d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/partial_failure_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/partial_failure_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -44,4 +43,6 @@ message PartialFailureErrorEnum { // This method requires this field be set to true. PARTIAL_FAILURE_MODE_REQUIRED = 2; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/policy_finding_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/policy_finding_error.proto index ea5710d48..d62fea7f2 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/policy_finding_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/policy_finding_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -47,4 +46,6 @@ message PolicyFindingErrorEnum { // The given policy topic does not exist. POLICY_TOPIC_NOT_FOUND = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/policy_validation_parameter_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/policy_validation_parameter_error.proto index 3bb919ee9..3caba8e7d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/policy_validation_parameter_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/policy_validation_parameter_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -48,7 +47,8 @@ message PolicyValidationParameterErrorEnum { // Cannot set ignorable policy topics and exempt policy violation keys in // the same policy violation parameter. - CANNOT_SET_BOTH_IGNORABLE_POLICY_TOPICS_AND_EXEMPT_POLICY_VIOLATION_KEYS = - 4; + CANNOT_SET_BOTH_IGNORABLE_POLICY_TOPICS_AND_EXEMPT_POLICY_VIOLATION_KEYS = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/policy_violation_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/policy_violation_error.proto index 2b112ffdb..b2ae65b6f 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/policy_violation_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/policy_violation_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -43,4 +42,6 @@ message PolicyViolationErrorEnum { // A policy was violated. See PolicyViolationDetails for more detail. POLICY_ERROR = 2; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/query_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/query_error.proto index 35b080fbd..0cdbd8b23 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/query_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/query_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -210,4 +209,6 @@ message QueryErrorEnum { // account. REQUESTED_METRICS_FOR_MANAGER = 59; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/quota_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/quota_error.proto index 71943834a..4eb84001f 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/quota_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/quota_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -49,4 +48,6 @@ message QuotaErrorEnum { // Too many requests in a short amount of time. RESOURCE_TEMPORARILY_EXHAUSTED = 4; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/range_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/range_error.proto index affa14d97..966be9339 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/range_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/range_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message RangeErrorEnum { // Too high. TOO_HIGH = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/recommendation_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/recommendation_error.proto index 20294dfc9..046c610e3 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/recommendation_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/recommendation_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -86,4 +85,6 @@ message RecommendationErrorEnum { // The recommendation apply request was malformed and invalid. INVALID_APPLY_REQUEST = 15; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/region_code_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/region_code_error.proto index 712b66215..edae214c8 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/region_code_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/region_code_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -43,4 +42,6 @@ message RegionCodeErrorEnum { // Invalid region code. INVALID_REGION_CODE = 2; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/request_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/request_error.proto index 50f103973..5d6d1648d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/request_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/request_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -97,4 +96,6 @@ message RequestErrorEnum { // page_token is set in the validate only request VALIDATE_ONLY_REQUEST_HAS_PAGE_TOKEN = 21; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/resource_access_denied_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/resource_access_denied_error.proto index 0cf38bdb0..f51b5cf02 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/resource_access_denied_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/resource_access_denied_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -43,4 +42,6 @@ message ResourceAccessDeniedErrorEnum { // User did not have write access. WRITE_ACCESS_DENIED = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/resource_count_limit_exceeded_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/resource_count_limit_exceeded_error.proto index 9a6365699..ae487eaf3 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/resource_count_limit_exceeded_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/resource_count_limit_exceeded_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -84,4 +83,6 @@ message ResourceCountLimitExceededErrorEnum { // that can be returned. RESPONSE_ROW_LIMIT_EXCEEDED = 9; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/setting_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/setting_error.proto index 23ae8e0c7..4956bfdaf 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/setting_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/setting_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -55,14 +54,12 @@ message SettingErrorEnum { // set any of the Demographic CriterionTypeGroups (AGE_RANGE, GENDER, // PARENT, INCOME_RANGE) to false (it's okay to not set them at all, in // which case the system will set them to true automatically). - TARGETING_SETTING_DEMOGRAPHIC_CRITERION_TYPE_GROUPS_MUST_BE_SET_TO_TARGET_ALL = - 6; + TARGETING_SETTING_DEMOGRAPHIC_CRITERION_TYPE_GROUPS_MUST_BE_SET_TO_TARGET_ALL = 6; // TargetingSetting cannot change any of // the Demographic CriterionTypeGroups (AGE_RANGE, GENDER, PARENT, // INCOME_RANGE) from true to false. - TARGETING_SETTING_CANNOT_CHANGE_TARGET_ALL_TO_FALSE_FOR_DEMOGRAPHIC_CRITERION_TYPE_GROUP = - 7; + TARGETING_SETTING_CANNOT_CHANGE_TARGET_ALL_TO_FALSE_FOR_DEMOGRAPHIC_CRITERION_TYPE_GROUP = 7; // At least one feed id should be present. DYNAMIC_SEARCH_ADS_SETTING_AT_LEAST_ONE_FEED_ID_MUST_BE_PRESENT = 8; @@ -103,4 +100,6 @@ message SettingErrorEnum { // Too many exclamation marks in universal app campaign ad text ideas. TOO_MANY_EXCLAMATION_MARKS = 19; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/shared_criterion_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/shared_criterion_error.proto index a63ab665e..ea6af8562 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/shared_criterion_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/shared_criterion_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -43,4 +42,6 @@ message SharedCriterionErrorEnum { // The criterion is not appropriate for the shared set type. CRITERION_TYPE_NOT_ALLOWED_FOR_SHARED_SET_TYPE = 2; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/shared_set_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/shared_set_error.proto index 530753bfd..8c8f7214c 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/shared_set_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/shared_set_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -52,4 +51,6 @@ message SharedSetErrorEnum { // The shared set cannot be removed because it is in use. SHARED_SET_IN_USE = 5; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/size_limit_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/size_limit_error.proto index bf192be97..5d0bcce80 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/size_limit_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/size_limit_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message SizeLimitErrorEnum { // The number of entries in the response exceeds the system limit. RESPONSE_SIZE_LIMIT_EXCEEDED = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/string_format_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/string_format_error.proto index 1e05d7b72..ef8f0b6b8 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/string_format_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/string_format_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message StringFormatErrorEnum { // The input string value is invalid for the associated field. INVALID_FORMAT = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/string_length_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/string_length_error.proto index fba2e6eae..8f3219693 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/string_length_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/string_length_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message StringLengthErrorEnum { // Too long. TOO_LONG = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/url_field_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/url_field_error.proto index f1d7203d8..84116b9aa 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/url_field_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/url_field_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -211,4 +210,6 @@ message UrlFieldErrorEnum { // Custom parameter value cannot be null. NULL_CUSTOM_PARAMETER_VALUE = 57; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/user_list_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/user_list_error.proto index 7b3acb470..9f3b18881 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/user_list_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/user_list_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -125,4 +124,6 @@ message UserListErrorEnum { // types of lists in its rules. CAN_NOT_MIX_CRM_BASED_IN_LOGICAL_LIST_WITH_OTHER_LISTS = 36; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/errors/youtube_video_registration_error.proto b/third_party/googleapis/google/ads/googleads/v1/errors/youtube_video_registration_error.proto index 1f50b2d9f..747780b7e 100644 --- a/third_party/googleapis/google/ads/googleads/v1/errors/youtube_video_registration_error.proto +++ b/third_party/googleapis/google/ads/googleads/v1/errors/youtube_video_registration_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -46,4 +45,6 @@ message YoutubeVideoRegistrationErrorEnum { // Video to be registered is not accessible (e.g. private). VIDEO_NOT_ACCESSIBLE = 3; } + + } diff --git a/third_party/googleapis/google/ads/googleads/v1/googleads_gapic.yaml b/third_party/googleapis/google/ads/googleads/v1/googleads_gapic.yaml new file mode 100644 index 000000000..86047019d --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v1/googleads_gapic.yaml @@ -0,0 +1,17 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 2.0.0 +language_settings: + csharp: + package_name: Google.Ads.GoogleAds.V1.Services + go: + package_name: google.golang.org/google/ads/googleads/v1/services + java: + package_name: com.google.ads.googleads.v1.services + nodejs: + package_name: v1.services + php: + package_name: Google\Ads\Googleads\V1\Services + python: + package_name: google.ads.googleads_v1.gapic.services + ruby: + package_name: Google::Ads::Googleads::V1::Services diff --git a/third_party/googleapis/google/ads/googleads/v1/googleads_grpc_service_config.json b/third_party/googleapis/google/ads/googleads/v1/googleads_grpc_service_config.json new file mode 100644 index 000000000..d3a6a57d0 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v1/googleads_grpc_service_config.json @@ -0,0 +1,118 @@ +{ + "methodConfig": [ + { + "name": [ + { "service": "google.ads.googleads.v1.services.AccountBudgetProposalService" }, + { "service": "google.ads.googleads.v1.services.AccountBudgetService" }, + { "service": "google.ads.googleads.v1.services.AdGroupAdLabelService" }, + { "service": "google.ads.googleads.v1.services.AdGroupAdService" }, + { "service": "google.ads.googleads.v1.services.AdGroupAudienceViewService" }, + { "service": "google.ads.googleads.v1.services.AdGroupBidModifierService" }, + { "service": "google.ads.googleads.v1.services.AdGroupCriterionLabelService" }, + { "service": "google.ads.googleads.v1.services.AdGroupCriterionService" }, + { "service": "google.ads.googleads.v1.services.AdGroupCriterionSimulationService" }, + { "service": "google.ads.googleads.v1.services.AdGroupExtensionSettingService" }, + { "service": "google.ads.googleads.v1.services.AdGroupFeedService" }, + { "service": "google.ads.googleads.v1.services.AdGroupLabelService" }, + { "service": "google.ads.googleads.v1.services.AdGroupService" }, + { "service": "google.ads.googleads.v1.services.AdGroupSimulationService" }, + { "service": "google.ads.googleads.v1.services.AdParameterService" }, + { "service": "google.ads.googleads.v1.services.AdScheduleViewService" }, + { "service": "google.ads.googleads.v1.services.AgeRangeViewService" }, + { "service": "google.ads.googleads.v1.services.AssetService" }, + { "service": "google.ads.googleads.v1.services.BiddingStrategyService" }, + { "service": "google.ads.googleads.v1.services.BillingSetupService" }, + { "service": "google.ads.googleads.v1.services.CampaignAudienceViewService" }, + { "service": "google.ads.googleads.v1.services.CampaignBidModifierService" }, + { "service": "google.ads.googleads.v1.services.CampaignBudgetService" }, + { "service": "google.ads.googleads.v1.services.CampaignCriterionService" }, + { "service": "google.ads.googleads.v1.services.CampaignCriterionSimulationService" }, + { "service": "google.ads.googleads.v1.services.CampaignDraftService" }, + { "service": "google.ads.googleads.v1.services.CampaignExperimentService" }, + { "service": "google.ads.googleads.v1.services.CampaignExtensionSettingService" }, + { "service": "google.ads.googleads.v1.services.CampaignFeedService" }, + { "service": "google.ads.googleads.v1.services.CampaignLabelService" }, + { "service": "google.ads.googleads.v1.services.CampaignService" }, + { "service": "google.ads.googleads.v1.services.CampaignSharedSetService" }, + { "service": "google.ads.googleads.v1.services.CarrierConstantService" }, + { "service": "google.ads.googleads.v1.services.ChangeStatusService" }, + { "service": "google.ads.googleads.v1.services.ClickViewService" }, + { "service": "google.ads.googleads.v1.services.ConversionActionService" }, + { "service": "google.ads.googleads.v1.services.ConversionAdjustmentUploadService" }, + { "service": "google.ads.googleads.v1.services.ConversionUploadService" }, + { "service": "google.ads.googleads.v1.services.CustomInterestService" }, + { "service": "google.ads.googleads.v1.services.CustomerClientLinkService" }, + { "service": "google.ads.googleads.v1.services.CustomerClientService" }, + { "service": "google.ads.googleads.v1.services.CustomerExtensionSettingService" }, + { "service": "google.ads.googleads.v1.services.CustomerFeedService" }, + { "service": "google.ads.googleads.v1.services.CustomerLabelService" }, + { "service": "google.ads.googleads.v1.services.CustomerManagerLinkService" }, + { "service": "google.ads.googleads.v1.services.CustomerNegativeCriterionService" }, + { "service": "google.ads.googleads.v1.services.CustomerService" }, + { "service": "google.ads.googleads.v1.services.DetailPlacementViewService" }, + { "service": "google.ads.googleads.v1.services.DisplayKeywordViewService" }, + { "service": "google.ads.googleads.v1.services.DomainCategoryService" }, + { "service": "google.ads.googleads.v1.services.DynamicSearchAdsSearchTermViewService" }, + { "service": "google.ads.googleads.v1.services.ExpandedLandingPageViewService" }, + { "service": "google.ads.googleads.v1.services.ExtensionFeedItemService" }, + { "service": "google.ads.googleads.v1.services.FeedItemService" }, + { "service": "google.ads.googleads.v1.services.FeedItemTargetService" }, + { "service": "google.ads.googleads.v1.services.FeedMappingService" }, + { "service": "google.ads.googleads.v1.services.FeedPlaceholderViewService" }, + { "service": "google.ads.googleads.v1.services.FeedService" }, + { "service": "google.ads.googleads.v1.services.GenderViewService" }, + { "service": "google.ads.googleads.v1.services.GeographicViewService" }, + { "service": "google.ads.googleads.v1.services.GeoTargetConstantService" }, + { "service": "google.ads.googleads.v1.services.GoogleAdsFieldService" }, + { "service": "google.ads.googleads.v1.services.GoogleAdsService" }, + { "service": "google.ads.googleads.v1.services.GroupPlacementViewService" }, + { "service": "google.ads.googleads.v1.services.HotelGroupViewService" }, + { "service": "google.ads.googleads.v1.services.HotelPerformanceViewService" }, + { "service": "google.ads.googleads.v1.services.KeywordPlanAdGroupService" }, + { "service": "google.ads.googleads.v1.services.KeywordPlanCampaignService" }, + { "service": "google.ads.googleads.v1.services.KeywordPlanIdeaService" }, + { "service": "google.ads.googleads.v1.services.KeywordPlanKeywordService" }, + { "service": "google.ads.googleads.v1.services.KeywordPlanNegativeKeywordService" }, + { "service": "google.ads.googleads.v1.services.KeywordPlanService" }, + { "service": "google.ads.googleads.v1.services.KeywordViewService" }, + { "service": "google.ads.googleads.v1.services.LabelService" }, + { "service": "google.ads.googleads.v1.services.LandingPageViewService" }, + { "service": "google.ads.googleads.v1.services.LanguageConstantService" }, + { "service": "google.ads.googleads.v1.services.LocationViewService" }, + { "service": "google.ads.googleads.v1.services.ManagedPlacementViewService" }, + { "service": "google.ads.googleads.v1.services.MediaFileService" }, + { "service": "google.ads.googleads.v1.services.MerchantCenterLinkService" }, + { "service": "google.ads.googleads.v1.services.MobileAppCategoryConstantService" }, + { "service": "google.ads.googleads.v1.services.MobileDeviceConstantService" }, + { "service": "google.ads.googleads.v1.services.MutateJobService" }, + { "service": "google.ads.googleads.v1.services.OperatingSystemVersionConstantService" }, + { "service": "google.ads.googleads.v1.services.PaidOrganicSearchTermViewService" }, + { "service": "google.ads.googleads.v1.services.ParentalStatusViewService" }, + { "service": "google.ads.googleads.v1.services.PaymentsAccountService" }, + { "service": "google.ads.googleads.v1.services.ProductBiddingCategoryConstantService" }, + { "service": "google.ads.googleads.v1.services.ProductGroupViewService" }, + { "service": "google.ads.googleads.v1.services.RecommendationService" }, + { "service": "google.ads.googleads.v1.services.RemarketingActionService" }, + { "service": "google.ads.googleads.v1.services.SearchTermViewService" }, + { "service": "google.ads.googleads.v1.services.SharedCriterionService" }, + { "service": "google.ads.googleads.v1.services.SharedSetService" }, + { "service": "google.ads.googleads.v1.services.ShoppingPerformanceViewService" }, + { "service": "google.ads.googleads.v1.services.TopicConstantService" }, + { "service": "google.ads.googleads.v1.services.TopicViewService" }, + { "service": "google.ads.googleads.v1.services.UserInterestService" }, + { "service": "google.ads.googleads.v1.services.UserListService" }, + { "service": "google.ads.googleads.v1.services.VideoService" } + ], + "timeout": "3600s", + "retryPolicy": { + "initialBackoff": "5s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/ads/googleads/v1/googleads_v1.yaml b/third_party/googleapis/google/ads/googleads/v1/googleads_v1.yaml new file mode 100644 index 000000000..f05885e26 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v1/googleads_v1.yaml @@ -0,0 +1,444 @@ +type: google.api.Service +config_version: 3 +name: googleads.googleapis.com +title: Google Ads API + +apis: +- name: google.ads.googleads.v1.services.AccountBudgetProposalService +- name: google.ads.googleads.v1.services.AccountBudgetService +- name: google.ads.googleads.v1.services.AdGroupAdLabelService +- name: google.ads.googleads.v1.services.AdGroupAdService +- name: google.ads.googleads.v1.services.AdGroupAudienceViewService +- name: google.ads.googleads.v1.services.AdGroupBidModifierService +- name: google.ads.googleads.v1.services.AdGroupCriterionLabelService +- name: google.ads.googleads.v1.services.AdGroupCriterionService +- name: google.ads.googleads.v1.services.AdGroupCriterionSimulationService +- name: google.ads.googleads.v1.services.AdGroupExtensionSettingService +- name: google.ads.googleads.v1.services.AdGroupFeedService +- name: google.ads.googleads.v1.services.AdGroupLabelService +- name: google.ads.googleads.v1.services.AdGroupService +- name: google.ads.googleads.v1.services.AdGroupSimulationService +- name: google.ads.googleads.v1.services.AdParameterService +- name: google.ads.googleads.v1.services.AdScheduleViewService +- name: google.ads.googleads.v1.services.AgeRangeViewService +- name: google.ads.googleads.v1.services.AssetService +- name: google.ads.googleads.v1.services.BiddingStrategyService +- name: google.ads.googleads.v1.services.BillingSetupService +- name: google.ads.googleads.v1.services.CampaignAudienceViewService +- name: google.ads.googleads.v1.services.CampaignBidModifierService +- name: google.ads.googleads.v1.services.CampaignBudgetService +- name: google.ads.googleads.v1.services.CampaignCriterionService +- name: google.ads.googleads.v1.services.CampaignCriterionSimulationService +- name: google.ads.googleads.v1.services.CampaignDraftService +- name: google.ads.googleads.v1.services.CampaignExperimentService +- name: google.ads.googleads.v1.services.CampaignExtensionSettingService +- name: google.ads.googleads.v1.services.CampaignFeedService +- name: google.ads.googleads.v1.services.CampaignLabelService +- name: google.ads.googleads.v1.services.CampaignService +- name: google.ads.googleads.v1.services.CampaignSharedSetService +- name: google.ads.googleads.v1.services.CarrierConstantService +- name: google.ads.googleads.v1.services.ChangeStatusService +- name: google.ads.googleads.v1.services.ClickViewService +- name: google.ads.googleads.v1.services.ConversionActionService +- name: google.ads.googleads.v1.services.ConversionAdjustmentUploadService +- name: google.ads.googleads.v1.services.ConversionUploadService +- name: google.ads.googleads.v1.services.CustomInterestService +- name: google.ads.googleads.v1.services.CustomerClientLinkService +- name: google.ads.googleads.v1.services.CustomerClientService +- name: google.ads.googleads.v1.services.CustomerExtensionSettingService +- name: google.ads.googleads.v1.services.CustomerFeedService +- name: google.ads.googleads.v1.services.CustomerLabelService +- name: google.ads.googleads.v1.services.CustomerManagerLinkService +- name: google.ads.googleads.v1.services.CustomerNegativeCriterionService +- name: google.ads.googleads.v1.services.CustomerService +- name: google.ads.googleads.v1.services.DetailPlacementViewService +- name: google.ads.googleads.v1.services.DisplayKeywordViewService +- name: google.ads.googleads.v1.services.DomainCategoryService +- name: google.ads.googleads.v1.services.DynamicSearchAdsSearchTermViewService +- name: google.ads.googleads.v1.services.ExpandedLandingPageViewService +- name: google.ads.googleads.v1.services.ExtensionFeedItemService +- name: google.ads.googleads.v1.services.FeedItemService +- name: google.ads.googleads.v1.services.FeedItemTargetService +- name: google.ads.googleads.v1.services.FeedMappingService +- name: google.ads.googleads.v1.services.FeedPlaceholderViewService +- name: google.ads.googleads.v1.services.FeedService +- name: google.ads.googleads.v1.services.GenderViewService +- name: google.ads.googleads.v1.services.GeoTargetConstantService +- name: google.ads.googleads.v1.services.GeographicViewService +- name: google.ads.googleads.v1.services.GoogleAdsFieldService +- name: google.ads.googleads.v1.services.GoogleAdsService +- name: google.ads.googleads.v1.services.GroupPlacementViewService +- name: google.ads.googleads.v1.services.HotelGroupViewService +- name: google.ads.googleads.v1.services.HotelPerformanceViewService +- name: google.ads.googleads.v1.services.KeywordPlanAdGroupService +- name: google.ads.googleads.v1.services.KeywordPlanCampaignService +- name: google.ads.googleads.v1.services.KeywordPlanIdeaService +- name: google.ads.googleads.v1.services.KeywordPlanKeywordService +- name: google.ads.googleads.v1.services.KeywordPlanNegativeKeywordService +- name: google.ads.googleads.v1.services.KeywordPlanService +- name: google.ads.googleads.v1.services.KeywordViewService +- name: google.ads.googleads.v1.services.LabelService +- name: google.ads.googleads.v1.services.LandingPageViewService +- name: google.ads.googleads.v1.services.LanguageConstantService +- name: google.ads.googleads.v1.services.LocationViewService +- name: google.ads.googleads.v1.services.ManagedPlacementViewService +- name: google.ads.googleads.v1.services.MediaFileService +- name: google.ads.googleads.v1.services.MerchantCenterLinkService +- name: google.ads.googleads.v1.services.MobileAppCategoryConstantService +- name: google.ads.googleads.v1.services.MobileDeviceConstantService +- name: google.ads.googleads.v1.services.MutateJobService +- name: google.ads.googleads.v1.services.OperatingSystemVersionConstantService +- name: google.ads.googleads.v1.services.PaidOrganicSearchTermViewService +- name: google.ads.googleads.v1.services.ParentalStatusViewService +- name: google.ads.googleads.v1.services.PaymentsAccountService +- name: google.ads.googleads.v1.services.ProductBiddingCategoryConstantService +- name: google.ads.googleads.v1.services.ProductGroupViewService +- name: google.ads.googleads.v1.services.RecommendationService +- name: google.ads.googleads.v1.services.RemarketingActionService +- name: google.ads.googleads.v1.services.SearchTermViewService +- name: google.ads.googleads.v1.services.SharedCriterionService +- name: google.ads.googleads.v1.services.SharedSetService +- name: google.ads.googleads.v1.services.ShoppingPerformanceViewService +- name: google.ads.googleads.v1.services.TopicConstantService +- name: google.ads.googleads.v1.services.TopicViewService +- name: google.ads.googleads.v1.services.UserInterestService +- name: google.ads.googleads.v1.services.UserListService +- name: google.ads.googleads.v1.services.VideoService + +types: +- name: google.ads.googleads.v1.errors.GoogleAdsFailure +- name: google.ads.googleads.v1.resources.MutateJob.MutateJobMetadata +- name: google.ads.googleads.v1.services.CreateCampaignExperimentMetadata + +documentation: + summary: |- + Manage your AdWords accounts, campaigns, and reports with this REST-based + API. + overview: |- + # This warning always fires when the last path segment of packages is not + + # the version + +backend: + rules: + - selector: google.ads.googleads.v1.services.AccountBudgetProposalService.GetAccountBudgetProposal + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AccountBudgetProposalService.MutateAccountBudgetProposal + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AccountBudgetService.GetAccountBudget + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AdGroupAdLabelService.GetAdGroupAdLabel + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AdGroupAdLabelService.MutateAdGroupAdLabels + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AdGroupAdService.GetAdGroupAd + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AdGroupAdService.MutateAdGroupAds + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AdGroupAudienceViewService.GetAdGroupAudienceView + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AdGroupBidModifierService.GetAdGroupBidModifier + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AdGroupBidModifierService.MutateAdGroupBidModifiers + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AdGroupCriterionLabelService.GetAdGroupCriterionLabel + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AdGroupCriterionLabelService.MutateAdGroupCriterionLabels + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AdGroupCriterionService.GetAdGroupCriterion + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AdGroupCriterionService.MutateAdGroupCriteria + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AdGroupCriterionSimulationService.GetAdGroupCriterionSimulation + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AdGroupExtensionSettingService.GetAdGroupExtensionSetting + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AdGroupExtensionSettingService.MutateAdGroupExtensionSettings + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AdGroupFeedService.GetAdGroupFeed + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AdGroupFeedService.MutateAdGroupFeeds + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AdGroupLabelService.GetAdGroupLabel + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AdGroupLabelService.MutateAdGroupLabels + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AdGroupService.GetAdGroup + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AdGroupService.MutateAdGroups + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AdGroupSimulationService.GetAdGroupSimulation + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AdParameterService.GetAdParameter + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AdParameterService.MutateAdParameters + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AdScheduleViewService.GetAdScheduleView + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AgeRangeViewService.GetAgeRangeView + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AssetService.GetAsset + deadline: 60.0 + - selector: google.ads.googleads.v1.services.AssetService.MutateAssets + deadline: 60.0 + - selector: google.ads.googleads.v1.services.BiddingStrategyService.GetBiddingStrategy + deadline: 60.0 + - selector: google.ads.googleads.v1.services.BiddingStrategyService.MutateBiddingStrategies + deadline: 60.0 + - selector: google.ads.googleads.v1.services.BillingSetupService.GetBillingSetup + deadline: 60.0 + - selector: google.ads.googleads.v1.services.BillingSetupService.MutateBillingSetup + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CampaignAudienceViewService.GetCampaignAudienceView + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CampaignBidModifierService.GetCampaignBidModifier + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CampaignBidModifierService.MutateCampaignBidModifiers + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CampaignBudgetService.GetCampaignBudget + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CampaignBudgetService.MutateCampaignBudgets + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CampaignCriterionService.GetCampaignCriterion + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CampaignCriterionService.MutateCampaignCriteria + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CampaignCriterionSimulationService.GetCampaignCriterionSimulation + deadline: 60.0 + - selector: 'google.ads.googleads.v1.services.CampaignDraftService.*' + deadline: 60.0 + - selector: 'google.ads.googleads.v1.services.CampaignExperimentService.*' + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CampaignExtensionSettingService.GetCampaignExtensionSetting + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CampaignExtensionSettingService.MutateCampaignExtensionSettings + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CampaignFeedService.GetCampaignFeed + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CampaignFeedService.MutateCampaignFeeds + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CampaignLabelService.GetCampaignLabel + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CampaignLabelService.MutateCampaignLabels + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CampaignService.GetCampaign + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CampaignService.MutateCampaigns + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CampaignSharedSetService.GetCampaignSharedSet + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CampaignSharedSetService.MutateCampaignSharedSets + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CarrierConstantService.GetCarrierConstant + deadline: 60.0 + - selector: google.ads.googleads.v1.services.ChangeStatusService.GetChangeStatus + deadline: 60.0 + - selector: google.ads.googleads.v1.services.ClickViewService.GetClickView + deadline: 60.0 + - selector: google.ads.googleads.v1.services.ConversionActionService.GetConversionAction + deadline: 60.0 + - selector: google.ads.googleads.v1.services.ConversionActionService.MutateConversionActions + deadline: 60.0 + - selector: google.ads.googleads.v1.services.ConversionAdjustmentUploadService.UploadConversionAdjustments + deadline: 60.0 + - selector: google.ads.googleads.v1.services.ConversionUploadService.UploadCallConversions + deadline: 60.0 + - selector: google.ads.googleads.v1.services.ConversionUploadService.UploadClickConversions + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CustomInterestService.GetCustomInterest + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CustomInterestService.MutateCustomInterests + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CustomerClientLinkService.GetCustomerClientLink + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CustomerClientLinkService.MutateCustomerClientLink + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CustomerClientService.GetCustomerClient + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CustomerExtensionSettingService.GetCustomerExtensionSetting + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CustomerExtensionSettingService.MutateCustomerExtensionSettings + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CustomerFeedService.GetCustomerFeed + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CustomerFeedService.MutateCustomerFeeds + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CustomerLabelService.GetCustomerLabel + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CustomerLabelService.MutateCustomerLabels + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CustomerManagerLinkService.GetCustomerManagerLink + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CustomerManagerLinkService.MutateCustomerManagerLink + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CustomerNegativeCriterionService.GetCustomerNegativeCriterion + deadline: 60.0 + - selector: google.ads.googleads.v1.services.CustomerNegativeCriterionService.MutateCustomerNegativeCriteria + deadline: 60.0 + - selector: 'google.ads.googleads.v1.services.CustomerService.*' + deadline: 60.0 + - selector: google.ads.googleads.v1.services.DetailPlacementViewService.GetDetailPlacementView + deadline: 60.0 + - selector: google.ads.googleads.v1.services.DisplayKeywordViewService.GetDisplayKeywordView + deadline: 60.0 + - selector: google.ads.googleads.v1.services.DomainCategoryService.GetDomainCategory + deadline: 60.0 + - selector: google.ads.googleads.v1.services.DynamicSearchAdsSearchTermViewService.GetDynamicSearchAdsSearchTermView + deadline: 60.0 + - selector: google.ads.googleads.v1.services.ExpandedLandingPageViewService.GetExpandedLandingPageView + deadline: 60.0 + - selector: google.ads.googleads.v1.services.ExtensionFeedItemService.GetExtensionFeedItem + deadline: 60.0 + - selector: google.ads.googleads.v1.services.ExtensionFeedItemService.MutateExtensionFeedItems + deadline: 60.0 + - selector: google.ads.googleads.v1.services.FeedItemService.GetFeedItem + deadline: 60.0 + - selector: google.ads.googleads.v1.services.FeedItemService.MutateFeedItems + deadline: 60.0 + - selector: google.ads.googleads.v1.services.FeedItemTargetService.GetFeedItemTarget + deadline: 60.0 + - selector: google.ads.googleads.v1.services.FeedItemTargetService.MutateFeedItemTargets + deadline: 60.0 + - selector: google.ads.googleads.v1.services.FeedMappingService.GetFeedMapping + deadline: 60.0 + - selector: google.ads.googleads.v1.services.FeedMappingService.MutateFeedMappings + deadline: 60.0 + - selector: google.ads.googleads.v1.services.FeedPlaceholderViewService.GetFeedPlaceholderView + deadline: 60.0 + - selector: google.ads.googleads.v1.services.FeedService.GetFeed + deadline: 60.0 + - selector: google.ads.googleads.v1.services.FeedService.MutateFeeds + deadline: 60.0 + - selector: google.ads.googleads.v1.services.GenderViewService.GetGenderView + deadline: 60.0 + - selector: google.ads.googleads.v1.services.GeoTargetConstantService.GetGeoTargetConstant + deadline: 60.0 + - selector: google.ads.googleads.v1.services.GeoTargetConstantService.SuggestGeoTargetConstants + deadline: 60.0 + - selector: google.ads.googleads.v1.services.GeographicViewService.GetGeographicView + deadline: 60.0 + - selector: google.ads.googleads.v1.services.GoogleAdsFieldService.GetGoogleAdsField + deadline: 600.0 + - selector: google.ads.googleads.v1.services.GoogleAdsFieldService.SearchGoogleAdsFields + deadline: 600.0 + - selector: google.ads.googleads.v1.services.GoogleAdsService.Mutate + deadline: 600.0 + - selector: google.ads.googleads.v1.services.GoogleAdsService.Search + deadline: 3600.0 + - selector: google.ads.googleads.v1.services.GroupPlacementViewService.GetGroupPlacementView + deadline: 60.0 + - selector: google.ads.googleads.v1.services.HotelGroupViewService.GetHotelGroupView + deadline: 60.0 + - selector: google.ads.googleads.v1.services.HotelPerformanceViewService.GetHotelPerformanceView + deadline: 60.0 + - selector: google.ads.googleads.v1.services.KeywordPlanAdGroupService.GetKeywordPlanAdGroup + deadline: 60.0 + - selector: google.ads.googleads.v1.services.KeywordPlanAdGroupService.MutateKeywordPlanAdGroups + deadline: 60.0 + - selector: google.ads.googleads.v1.services.KeywordPlanCampaignService.GetKeywordPlanCampaign + deadline: 60.0 + - selector: google.ads.googleads.v1.services.KeywordPlanCampaignService.MutateKeywordPlanCampaigns + deadline: 60.0 + - selector: google.ads.googleads.v1.services.KeywordPlanIdeaService.GenerateKeywordIdeas + deadline: 600.0 + - selector: google.ads.googleads.v1.services.KeywordPlanKeywordService.GetKeywordPlanKeyword + deadline: 60.0 + - selector: google.ads.googleads.v1.services.KeywordPlanKeywordService.MutateKeywordPlanKeywords + deadline: 60.0 + - selector: google.ads.googleads.v1.services.KeywordPlanNegativeKeywordService.GetKeywordPlanNegativeKeyword + deadline: 60.0 + - selector: google.ads.googleads.v1.services.KeywordPlanNegativeKeywordService.MutateKeywordPlanNegativeKeywords + deadline: 60.0 + - selector: google.ads.googleads.v1.services.KeywordPlanService.GenerateForecastMetrics + deadline: 600.0 + - selector: google.ads.googleads.v1.services.KeywordPlanService.GenerateHistoricalMetrics + deadline: 600.0 + - selector: google.ads.googleads.v1.services.KeywordPlanService.GetKeywordPlan + deadline: 60.0 + - selector: google.ads.googleads.v1.services.KeywordPlanService.MutateKeywordPlans + deadline: 60.0 + - selector: google.ads.googleads.v1.services.KeywordViewService.GetKeywordView + deadline: 60.0 + - selector: google.ads.googleads.v1.services.LabelService.GetLabel + deadline: 60.0 + - selector: google.ads.googleads.v1.services.LabelService.MutateLabels + deadline: 60.0 + - selector: google.ads.googleads.v1.services.LandingPageViewService.GetLandingPageView + deadline: 60.0 + - selector: google.ads.googleads.v1.services.LanguageConstantService.GetLanguageConstant + deadline: 60.0 + - selector: google.ads.googleads.v1.services.LocationViewService.GetLocationView + deadline: 60.0 + - selector: google.ads.googleads.v1.services.ManagedPlacementViewService.GetManagedPlacementView + deadline: 60.0 + - selector: google.ads.googleads.v1.services.MediaFileService.GetMediaFile + deadline: 60.0 + - selector: google.ads.googleads.v1.services.MediaFileService.MutateMediaFiles + deadline: 60.0 + - selector: 'google.ads.googleads.v1.services.MerchantCenterLinkService.*' + deadline: 60.0 + - selector: google.ads.googleads.v1.services.MobileAppCategoryConstantService.GetMobileAppCategoryConstant + deadline: 60.0 + - selector: google.ads.googleads.v1.services.MobileDeviceConstantService.GetMobileDeviceConstant + deadline: 60.0 + - selector: 'google.ads.googleads.v1.services.MutateJobService.*' + deadline: 60.0 + - selector: google.ads.googleads.v1.services.OperatingSystemVersionConstantService.GetOperatingSystemVersionConstant + deadline: 60.0 + - selector: google.ads.googleads.v1.services.PaidOrganicSearchTermViewService.GetPaidOrganicSearchTermView + deadline: 60.0 + - selector: google.ads.googleads.v1.services.ParentalStatusViewService.GetParentalStatusView + deadline: 60.0 + - selector: google.ads.googleads.v1.services.PaymentsAccountService.ListPaymentsAccounts + deadline: 60.0 + - selector: google.ads.googleads.v1.services.ProductBiddingCategoryConstantService.GetProductBiddingCategoryConstant + deadline: 60.0 + - selector: google.ads.googleads.v1.services.ProductGroupViewService.GetProductGroupView + deadline: 60.0 + - selector: 'google.ads.googleads.v1.services.RecommendationService.*' + deadline: 600.0 + - selector: google.ads.googleads.v1.services.RemarketingActionService.GetRemarketingAction + deadline: 60.0 + - selector: google.ads.googleads.v1.services.RemarketingActionService.MutateRemarketingActions + deadline: 60.0 + - selector: google.ads.googleads.v1.services.SearchTermViewService.GetSearchTermView + deadline: 60.0 + - selector: google.ads.googleads.v1.services.SharedCriterionService.GetSharedCriterion + deadline: 60.0 + - selector: google.ads.googleads.v1.services.SharedCriterionService.MutateSharedCriteria + deadline: 60.0 + - selector: google.ads.googleads.v1.services.SharedSetService.GetSharedSet + deadline: 60.0 + - selector: google.ads.googleads.v1.services.SharedSetService.MutateSharedSets + deadline: 60.0 + - selector: google.ads.googleads.v1.services.ShoppingPerformanceViewService.GetShoppingPerformanceView + deadline: 60.0 + - selector: google.ads.googleads.v1.services.TopicConstantService.GetTopicConstant + deadline: 60.0 + - selector: google.ads.googleads.v1.services.TopicViewService.GetTopicView + deadline: 60.0 + - selector: google.ads.googleads.v1.services.UserInterestService.GetUserInterest + deadline: 60.0 + - selector: google.ads.googleads.v1.services.UserListService.GetUserList + deadline: 60.0 + - selector: google.ads.googleads.v1.services.UserListService.MutateUserLists + deadline: 60.0 + - selector: google.ads.googleads.v1.services.VideoService.GetVideo + deadline: 60.0 + - selector: 'google.longrunning.Operations.*' + deadline: 60.0 + +http: + rules: + - selector: google.longrunning.Operations.CancelOperation + post: '/v1/{name=customers/*/operations/*}:cancel' + body: '*' + - selector: google.longrunning.Operations.DeleteOperation + delete: '/v1/{name=customers/*/operations/*}' + - selector: google.longrunning.Operations.GetOperation + get: '/v1/{name=customers/*/operations/*}' + - selector: google.longrunning.Operations.ListOperations + get: '/v1/{name=customers/*/operations}' + - selector: google.longrunning.Operations.WaitOperation + post: '/v1/{name=customers/*/operations/*}:wait' + body: '*' diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/account_budget.proto b/third_party/googleapis/google/ads/googleads/v1/resources/account_budget.proto index 55125e2d0..9ea08f6f2 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/account_budget.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/account_budget.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -21,8 +20,10 @@ import "google/ads/googleads/v1/enums/account_budget_proposal_type.proto"; import "google/ads/googleads/v1/enums/account_budget_status.proto"; import "google/ads/googleads/v1/enums/spending_limit_type.proto"; import "google/ads/googleads/v1/enums/time_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -52,122 +53,137 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // adjustments. Adjustments create differences between the 'approved' and // 'adjusted' fields, which would otherwise be identical. message AccountBudget { + option (google.api.resource) = { + type: "googleads.googleapis.com/AccountBudget" + pattern: "customers/{customer}/accountBudgets/{account_budget}" + }; + // A pending proposal associated with the enclosing account-level budget, // if applicable. message PendingAccountBudgetProposal { - // The resource name of the proposal. + // Output only. The resource name of the proposal. // AccountBudgetProposal resource names have the form: // - // // `customers/{customer_id}/accountBudgetProposals/{account_budget_proposal_id}` - google.protobuf.StringValue account_budget_proposal = 1; - - // The type of this proposal, e.g. END to end the budget associated + google.protobuf.StringValue account_budget_proposal = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AccountBudgetProposal" + } + ]; + + // Output only. The type of this proposal, e.g. END to end the budget associated // with this proposal. - google.ads.googleads.v1.enums.AccountBudgetProposalTypeEnum - .AccountBudgetProposalType proposal_type = 2; + google.ads.googleads.v1.enums.AccountBudgetProposalTypeEnum.AccountBudgetProposalType proposal_type = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The name to assign to the account-level budget. - google.protobuf.StringValue name = 3; + // Output only. The name to assign to the account-level budget. + google.protobuf.StringValue name = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The start time in yyyy-MM-dd HH:mm:ss format. - google.protobuf.StringValue start_date_time = 4; + // Output only. The start time in yyyy-MM-dd HH:mm:ss format. + google.protobuf.StringValue start_date_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // A purchase order number is a value that helps users reference this budget + // Output only. A purchase order number is a value that helps users reference this budget // in their monthly invoices. - google.protobuf.StringValue purchase_order_number = 9; + google.protobuf.StringValue purchase_order_number = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Notes associated with this budget. - google.protobuf.StringValue notes = 10; + // Output only. Notes associated with this budget. + google.protobuf.StringValue notes = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The time when this account-level budget proposal was created. + // Output only. The time when this account-level budget proposal was created. // Formatted as yyyy-MM-dd HH:mm:ss. - google.protobuf.StringValue creation_date_time = 11; + google.protobuf.StringValue creation_date_time = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; // The end time of the account-level budget. oneof end_time { - // The end time in yyyy-MM-dd HH:mm:ss format. - google.protobuf.StringValue end_date_time = 5; + // Output only. The end time in yyyy-MM-dd HH:mm:ss format. + google.protobuf.StringValue end_date_time = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The end time as a well-defined type, e.g. FOREVER. - google.ads.googleads.v1.enums.TimeTypeEnum.TimeType end_time_type = 6; + // Output only. The end time as a well-defined type, e.g. FOREVER. + google.ads.googleads.v1.enums.TimeTypeEnum.TimeType end_time_type = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The spending limit. oneof spending_limit { - // The spending limit in micros. One million is equivalent to + // Output only. The spending limit in micros. One million is equivalent to // one unit. - google.protobuf.Int64Value spending_limit_micros = 7; + google.protobuf.Int64Value spending_limit_micros = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The spending limit as a well-defined type, e.g. INFINITE. - google.ads.googleads.v1.enums.SpendingLimitTypeEnum.SpendingLimitType - spending_limit_type = 8; + // Output only. The spending limit as a well-defined type, e.g. INFINITE. + google.ads.googleads.v1.enums.SpendingLimitTypeEnum.SpendingLimitType spending_limit_type = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; } } - // The resource name of the account-level budget. + // Output only. The resource name of the account-level budget. // AccountBudget resource names have the form: // // `customers/{customer_id}/accountBudgets/{account_budget_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AccountBudget" + } + ]; - // The ID of the account-level budget. - google.protobuf.Int64Value id = 2; + // Output only. The ID of the account-level budget. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The resource name of the billing setup associated with this account-level + // Output only. The resource name of the billing setup associated with this account-level // budget. BillingSetup resource names have the form: // // `customers/{customer_id}/billingSetups/{billing_setup_id}` - google.protobuf.StringValue billing_setup = 3; + google.protobuf.StringValue billing_setup = 3 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/BillingSetup" + } + ]; - // The status of this account-level budget. - google.ads.googleads.v1.enums.AccountBudgetStatusEnum.AccountBudgetStatus - status = 4; + // Output only. The status of this account-level budget. + google.ads.googleads.v1.enums.AccountBudgetStatusEnum.AccountBudgetStatus status = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The name of the account-level budget. - google.protobuf.StringValue name = 5; + // Output only. The name of the account-level budget. + google.protobuf.StringValue name = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The proposed start time of the account-level budget in + // Output only. The proposed start time of the account-level budget in // yyyy-MM-dd HH:mm:ss format. If a start time type of NOW was proposed, // this is the time of request. - google.protobuf.StringValue proposed_start_date_time = 6; + google.protobuf.StringValue proposed_start_date_time = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The approved start time of the account-level budget in yyyy-MM-dd HH:mm:ss + // Output only. The approved start time of the account-level budget in yyyy-MM-dd HH:mm:ss // format. // // For example, if a new budget is approved after the proposed start time, // the approved start time is the time of approval. - google.protobuf.StringValue approved_start_date_time = 7; + google.protobuf.StringValue approved_start_date_time = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The total adjustments amount. + // Output only. The total adjustments amount. // // An example of an adjustment is courtesy credits. - google.protobuf.Int64Value total_adjustments_micros = 18; + google.protobuf.Int64Value total_adjustments_micros = 18 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The value of Ads that have been served, in micros. + // Output only. The value of Ads that have been served, in micros. // // This includes overdelivery costs, in which case a credit might be // automatically applied to the budget (see total_adjustments_micros). - google.protobuf.Int64Value amount_served_micros = 19; + google.protobuf.Int64Value amount_served_micros = 19 [(google.api.field_behavior) = OUTPUT_ONLY]; - // A purchase order number is a value that helps users reference this budget + // Output only. A purchase order number is a value that helps users reference this budget // in their monthly invoices. - google.protobuf.StringValue purchase_order_number = 20; + google.protobuf.StringValue purchase_order_number = 20 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Notes associated with the budget. - google.protobuf.StringValue notes = 21; + // Output only. Notes associated with the budget. + google.protobuf.StringValue notes = 21 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The pending proposal to modify this budget, if applicable. - PendingAccountBudgetProposal pending_proposal = 22; + // Output only. The pending proposal to modify this budget, if applicable. + PendingAccountBudgetProposal pending_proposal = 22 [(google.api.field_behavior) = OUTPUT_ONLY]; // The proposed end time of the account-level budget. oneof proposed_end_time { - // The proposed end time in yyyy-MM-dd HH:mm:ss format. - google.protobuf.StringValue proposed_end_date_time = 8; + // Output only. The proposed end time in yyyy-MM-dd HH:mm:ss format. + google.protobuf.StringValue proposed_end_date_time = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The proposed end time as a well-defined type, e.g. FOREVER. - google.ads.googleads.v1.enums.TimeTypeEnum.TimeType proposed_end_time_type = - 9; + // Output only. The proposed end time as a well-defined type, e.g. FOREVER. + google.ads.googleads.v1.enums.TimeTypeEnum.TimeType proposed_end_time_type = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The approved end time of the account-level budget. @@ -175,23 +191,21 @@ message AccountBudget { // For example, if a budget's end time is updated and the proposal is approved // after the proposed end time, the approved end time is the time of approval. oneof approved_end_time { - // The approved end time in yyyy-MM-dd HH:mm:ss format. - google.protobuf.StringValue approved_end_date_time = 10; + // Output only. The approved end time in yyyy-MM-dd HH:mm:ss format. + google.protobuf.StringValue approved_end_date_time = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The approved end time as a well-defined type, e.g. FOREVER. - google.ads.googleads.v1.enums.TimeTypeEnum.TimeType approved_end_time_type = - 11; + // Output only. The approved end time as a well-defined type, e.g. FOREVER. + google.ads.googleads.v1.enums.TimeTypeEnum.TimeType approved_end_time_type = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The proposed spending limit. oneof proposed_spending_limit { - // The proposed spending limit in micros. One million is equivalent to + // Output only. The proposed spending limit in micros. One million is equivalent to // one unit. - google.protobuf.Int64Value proposed_spending_limit_micros = 12; + google.protobuf.Int64Value proposed_spending_limit_micros = 12 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The proposed spending limit as a well-defined type, e.g. INFINITE. - google.ads.googleads.v1.enums.SpendingLimitTypeEnum.SpendingLimitType - proposed_spending_limit_type = 13; + // Output only. The proposed spending limit as a well-defined type, e.g. INFINITE. + google.ads.googleads.v1.enums.SpendingLimitTypeEnum.SpendingLimitType proposed_spending_limit_type = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The approved spending limit. @@ -200,16 +214,15 @@ message AccountBudget { // proposed spending limit at the time the proposal is approved, the approved // spending limit is set to the amount already spent. oneof approved_spending_limit { - // The approved spending limit in micros. One million is equivalent to + // Output only. The approved spending limit in micros. One million is equivalent to // one unit. This will only be populated if the proposed spending limit // is finite, and will always be greater than or equal to the // proposed spending limit. - google.protobuf.Int64Value approved_spending_limit_micros = 14; + google.protobuf.Int64Value approved_spending_limit_micros = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The approved spending limit as a well-defined type, e.g. INFINITE. This + // Output only. The approved spending limit as a well-defined type, e.g. INFINITE. This // will only be populated if the approved spending limit is INFINITE. - google.ads.googleads.v1.enums.SpendingLimitTypeEnum.SpendingLimitType - approved_spending_limit_type = 15; + google.ads.googleads.v1.enums.SpendingLimitTypeEnum.SpendingLimitType approved_spending_limit_type = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The spending limit after adjustments have been applied. Adjustments are @@ -217,7 +230,7 @@ message AccountBudget { // // This value has the final say on how much the account is allowed to spend. oneof adjusted_spending_limit { - // The adjusted spending limit in micros. One million is equivalent to + // Output only. The adjusted spending limit in micros. One million is equivalent to // one unit. // // If the approved spending limit is finite, the adjusted @@ -229,13 +242,12 @@ message AccountBudget { // // For example, a debit adjustment reduces how much the account is // allowed to spend. - google.protobuf.Int64Value adjusted_spending_limit_micros = 16; + google.protobuf.Int64Value adjusted_spending_limit_micros = 16 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The adjusted spending limit as a well-defined type, e.g. INFINITE. + // Output only. The adjusted spending limit as a well-defined type, e.g. INFINITE. // This will only be populated if the adjusted spending limit is INFINITE, // which is guaranteed to be true if the approved spending limit is // INFINITE. - google.ads.googleads.v1.enums.SpendingLimitTypeEnum.SpendingLimitType - adjusted_spending_limit_type = 17; + google.ads.googleads.v1.enums.SpendingLimitTypeEnum.SpendingLimitType adjusted_spending_limit_type = 17 [(google.api.field_behavior) = OUTPUT_ONLY]; } } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/account_budget_proposal.proto b/third_party/googleapis/google/ads/googleads/v1/resources/account_budget_proposal.proto index 00a9f4265..3fbfd50ff 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/account_budget_proposal.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/account_budget_proposal.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -21,8 +20,10 @@ import "google/ads/googleads/v1/enums/account_budget_proposal_status.proto"; import "google/ads/googleads/v1/enums/account_budget_proposal_type.proto"; import "google/ads/googleads/v1/enums/spending_limit_type.proto"; import "google/ads/googleads/v1/enums/time_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -45,104 +46,116 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // Please note that the proposal type (proposal_type) changes which fields are // required and which must remain empty. message AccountBudgetProposal { - // The resource name of the proposal. + option (google.api.resource) = { + type: "googleads.googleapis.com/AccountBudgetProposal" + pattern: "customers/{customer}/accountBudgetProposals/{account_budget_proposal}" + }; + + // Immutable. The resource name of the proposal. // AccountBudgetProposal resource names have the form: // - // // `customers/{customer_id}/accountBudgetProposals/{account_budget_proposal_id}` - string resource_name = 1; - - // The ID of the proposal. - google.protobuf.Int64Value id = 14; - - // The resource name of the billing setup associated with this proposal. - google.protobuf.StringValue billing_setup = 2; - - // The resource name of the account-level budget associated with this + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AccountBudgetProposal" + } + ]; + + // Output only. The ID of the proposal. + google.protobuf.Int64Value id = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. The resource name of the billing setup associated with this proposal. + google.protobuf.StringValue billing_setup = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/BillingSetup" + } + ]; + + // Immutable. The resource name of the account-level budget associated with this // proposal. - google.protobuf.StringValue account_budget = 3; - - // The type of this proposal, e.g. END to end the budget associated with this + google.protobuf.StringValue account_budget = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AccountBudget" + } + ]; + + // Immutable. The type of this proposal, e.g. END to end the budget associated with this // proposal. - google.ads.googleads.v1.enums.AccountBudgetProposalTypeEnum - .AccountBudgetProposalType proposal_type = 4; + google.ads.googleads.v1.enums.AccountBudgetProposalTypeEnum.AccountBudgetProposalType proposal_type = 4 [(google.api.field_behavior) = IMMUTABLE]; - // The status of this proposal. + // Output only. The status of this proposal. // When a new proposal is created, the status defaults to PENDING. - google.ads.googleads.v1.enums.AccountBudgetProposalStatusEnum - .AccountBudgetProposalStatus status = 15; + google.ads.googleads.v1.enums.AccountBudgetProposalStatusEnum.AccountBudgetProposalStatus status = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The name to assign to the account-level budget. - google.protobuf.StringValue proposed_name = 5; + // Immutable. The name to assign to the account-level budget. + google.protobuf.StringValue proposed_name = 5 [(google.api.field_behavior) = IMMUTABLE]; - // The approved start date time in yyyy-mm-dd hh:mm:ss format. - google.protobuf.StringValue approved_start_date_time = 20; + // Output only. The approved start date time in yyyy-mm-dd hh:mm:ss format. + google.protobuf.StringValue approved_start_date_time = 20 [(google.api.field_behavior) = OUTPUT_ONLY]; - // A purchase order number is a value that enables the user to help them + // Immutable. A purchase order number is a value that enables the user to help them // reference this budget in their monthly invoices. - google.protobuf.StringValue proposed_purchase_order_number = 12; + google.protobuf.StringValue proposed_purchase_order_number = 12 [(google.api.field_behavior) = IMMUTABLE]; - // Notes associated with this budget. - google.protobuf.StringValue proposed_notes = 13; + // Immutable. Notes associated with this budget. + google.protobuf.StringValue proposed_notes = 13 [(google.api.field_behavior) = IMMUTABLE]; - // The date time when this account-level budget proposal was created, which is + // Output only. The date time when this account-level budget proposal was created, which is // not the same as its approval date time, if applicable. - google.protobuf.StringValue creation_date_time = 16; + google.protobuf.StringValue creation_date_time = 16 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The date time when this account-level budget was approved, if applicable. - google.protobuf.StringValue approval_date_time = 17; + // Output only. The date time when this account-level budget was approved, if applicable. + google.protobuf.StringValue approval_date_time = 17 [(google.api.field_behavior) = OUTPUT_ONLY]; // The proposed start date time of the account-level budget, which cannot be // in the past. oneof proposed_start_time { - // The proposed start date time in yyyy-mm-dd hh:mm:ss format. - google.protobuf.StringValue proposed_start_date_time = 18; + // Immutable. The proposed start date time in yyyy-mm-dd hh:mm:ss format. + google.protobuf.StringValue proposed_start_date_time = 18 [(google.api.field_behavior) = IMMUTABLE]; - // The proposed start date time as a well-defined type, e.g. NOW. - google.ads.googleads.v1.enums.TimeTypeEnum.TimeType - proposed_start_time_type = 7; + // Immutable. The proposed start date time as a well-defined type, e.g. NOW. + google.ads.googleads.v1.enums.TimeTypeEnum.TimeType proposed_start_time_type = 7 [(google.api.field_behavior) = IMMUTABLE]; } // The proposed end date time of the account-level budget, which cannot be in // the past. oneof proposed_end_time { - // The proposed end date time in yyyy-mm-dd hh:mm:ss format. - google.protobuf.StringValue proposed_end_date_time = 19; + // Immutable. The proposed end date time in yyyy-mm-dd hh:mm:ss format. + google.protobuf.StringValue proposed_end_date_time = 19 [(google.api.field_behavior) = IMMUTABLE]; - // The proposed end date time as a well-defined type, e.g. FOREVER. - google.ads.googleads.v1.enums.TimeTypeEnum.TimeType proposed_end_time_type = - 9; + // Immutable. The proposed end date time as a well-defined type, e.g. FOREVER. + google.ads.googleads.v1.enums.TimeTypeEnum.TimeType proposed_end_time_type = 9 [(google.api.field_behavior) = IMMUTABLE]; } // The approved end date time of the account-level budget. oneof approved_end_time { - // The approved end date time in yyyy-mm-dd hh:mm:ss format. - google.protobuf.StringValue approved_end_date_time = 21; + // Output only. The approved end date time in yyyy-mm-dd hh:mm:ss format. + google.protobuf.StringValue approved_end_date_time = 21 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The approved end date time as a well-defined type, e.g. FOREVER. - google.ads.googleads.v1.enums.TimeTypeEnum.TimeType approved_end_time_type = - 22; + // Output only. The approved end date time as a well-defined type, e.g. FOREVER. + google.ads.googleads.v1.enums.TimeTypeEnum.TimeType approved_end_time_type = 22 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The proposed spending limit. oneof proposed_spending_limit { - // The proposed spending limit in micros. One million is equivalent to + // Immutable. The proposed spending limit in micros. One million is equivalent to // one unit. - google.protobuf.Int64Value proposed_spending_limit_micros = 10; + google.protobuf.Int64Value proposed_spending_limit_micros = 10 [(google.api.field_behavior) = IMMUTABLE]; - // The proposed spending limit as a well-defined type, e.g. INFINITE. - google.ads.googleads.v1.enums.SpendingLimitTypeEnum.SpendingLimitType - proposed_spending_limit_type = 11; + // Immutable. The proposed spending limit as a well-defined type, e.g. INFINITE. + google.ads.googleads.v1.enums.SpendingLimitTypeEnum.SpendingLimitType proposed_spending_limit_type = 11 [(google.api.field_behavior) = IMMUTABLE]; } // The approved spending limit. oneof approved_spending_limit { - // The approved spending limit in micros. One million is equivalent to + // Output only. The approved spending limit in micros. One million is equivalent to // one unit. - google.protobuf.Int64Value approved_spending_limit_micros = 23; + google.protobuf.Int64Value approved_spending_limit_micros = 23 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The approved spending limit as a well-defined type, e.g. INFINITE. - google.ads.googleads.v1.enums.SpendingLimitTypeEnum.SpendingLimitType - approved_spending_limit_type = 24; + // Output only. The approved spending limit as a well-defined type, e.g. INFINITE. + google.ads.googleads.v1.enums.SpendingLimitTypeEnum.SpendingLimitType approved_spending_limit_type = 24 [(google.api.field_behavior) = OUTPUT_ONLY]; } } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/ad.proto b/third_party/googleapis/google/ads/googleads/v1/resources/ad.proto index d89cd11e8..8a54706d7 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/ad.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/ad.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -24,8 +23,9 @@ import "google/ads/googleads/v1/common/url_collection.proto"; import "google/ads/googleads/v1/enums/ad_type.proto"; import "google/ads/googleads/v1/enums/device.proto"; import "google/ads/googleads/v1/enums/system_managed_entity_source.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -40,8 +40,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // An ad. message Ad { - // The ID of the ad. - google.protobuf.Int64Value id = 1; + // Output only. The ID of the ad. + google.protobuf.Int64Value id = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // The list of possible final URLs after all cross-domain redirects for the // ad. @@ -60,20 +60,19 @@ message Ad { // The list of mappings that can be used to substitute custom parameter tags // in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`. - repeated google.ads.googleads.v1.common.CustomParameter - url_custom_parameters = 10; + repeated google.ads.googleads.v1.common.CustomParameter url_custom_parameters = 10; // The URL that appears in the ad description for some ad formats. google.protobuf.StringValue display_url = 4; - // The type of ad. - google.ads.googleads.v1.enums.AdTypeEnum.AdType type = 5; + // Output only. The type of ad. + google.ads.googleads.v1.enums.AdTypeEnum.AdType type = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Indicates if this ad was automatically added by Google Ads and not by a + // Output only. Indicates if this ad was automatically added by Google Ads and not by a // user. For example, this could happen when ads are automatically created as // suggestions for new ads based on knowledge of how existing ads are // performing. - google.protobuf.BoolValue added_by_google_ads = 19; + google.protobuf.BoolValue added_by_google_ads = 19 [(google.api.field_behavior) = OUTPUT_ONLY]; // The device preference for the ad. You can only specify a preference for // mobile devices. When this preference is set the ad will be preferred over @@ -87,14 +86,13 @@ message Ad { // can be referenced from other fields in the ad. repeated google.ads.googleads.v1.common.UrlCollection url_collections = 26; - // The name of the ad. This is only used to be able to identify the ad. It + // Immutable. The name of the ad. This is only used to be able to identify the ad. It // does not need to be unique and does not affect the served ad. - google.protobuf.StringValue name = 23; + google.protobuf.StringValue name = 23 [(google.api.field_behavior) = IMMUTABLE]; - // If this ad is system managed, then this field will indicate the source. + // Output only. If this ad is system managed, then this field will indicate the source. // This field is read-only. - google.ads.googleads.v1.enums.SystemManagedResourceSourceEnum - .SystemManagedResourceSource system_managed_resource_source = 27; + google.ads.googleads.v1.enums.SystemManagedResourceSourceEnum.SystemManagedResourceSource system_managed_resource_source = 27 [(google.api.field_behavior) = OUTPUT_ONLY]; // Details pertinent to the ad type. Exactly one value must be set. oneof ad_data { @@ -112,8 +110,7 @@ message Ad { // auto-generated at serving time according to domain name specific // information provided by `dynamic_search_ads_setting` linked at the // campaign level. - google.ads.googleads.v1.common.ExpandedDynamicSearchAdInfo - expanded_dynamic_search_ad = 14; + google.ads.googleads.v1.common.ExpandedDynamicSearchAdInfo expanded_dynamic_search_ad = 14; // Details pertaining to a hotel ad. google.ads.googleads.v1.common.HotelAdInfo hotel_ad = 15; @@ -122,8 +119,7 @@ message Ad { google.ads.googleads.v1.common.ShoppingSmartAdInfo shopping_smart_ad = 17; // Details pertaining to a Shopping product ad. - google.ads.googleads.v1.common.ShoppingProductAdInfo shopping_product_ad = - 18; + google.ads.googleads.v1.common.ShoppingProductAdInfo shopping_product_ad = 18; // Details pertaining to a Gmail ad. google.ads.googleads.v1.common.GmailAdInfo gmail_ad = 21; @@ -135,23 +131,19 @@ message Ad { google.ads.googleads.v1.common.VideoAdInfo video_ad = 24; // Details pertaining to a responsive search ad. - google.ads.googleads.v1.common.ResponsiveSearchAdInfo responsive_search_ad = - 25; + google.ads.googleads.v1.common.ResponsiveSearchAdInfo responsive_search_ad = 25; // Details pertaining to a legacy responsive display ad. - google.ads.googleads.v1.common.LegacyResponsiveDisplayAdInfo - legacy_responsive_display_ad = 28; + google.ads.googleads.v1.common.LegacyResponsiveDisplayAdInfo legacy_responsive_display_ad = 28; // Details pertaining to an app ad. google.ads.googleads.v1.common.AppAdInfo app_ad = 29; - // Details pertaining to a legacy app install ad. - google.ads.googleads.v1.common.LegacyAppInstallAdInfo - legacy_app_install_ad = 30; + // Immutable. Details pertaining to a legacy app install ad. + google.ads.googleads.v1.common.LegacyAppInstallAdInfo legacy_app_install_ad = 30 [(google.api.field_behavior) = IMMUTABLE]; // Details pertaining to a responsive display ad. - google.ads.googleads.v1.common.ResponsiveDisplayAdInfo - responsive_display_ad = 31; + google.ads.googleads.v1.common.ResponsiveDisplayAdInfo responsive_display_ad = 31; // Details pertaining to a display upload ad. google.ads.googleads.v1.common.DisplayUploadAdInfo display_upload_ad = 33; @@ -160,7 +152,6 @@ message Ad { google.ads.googleads.v1.common.AppEngagementAdInfo app_engagement_ad = 34; // Details pertaining to a Shopping Comparison Listing ad. - google.ads.googleads.v1.common.ShoppingComparisonListingAdInfo - shopping_comparison_listing_ad = 36; + google.ads.googleads.v1.common.ShoppingComparisonListingAdInfo shopping_comparison_listing_ad = 36; } } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/ad_group.proto b/third_party/googleapis/google/ads/googleads/v1/resources/ad_group.proto index c4ad34b33..6975139f8 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/ad_group.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/ad_group.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -25,8 +24,10 @@ import "google/ads/googleads/v1/enums/ad_group_status.proto"; import "google/ads/googleads/v1/enums/ad_group_type.proto"; import "google/ads/googleads/v1/enums/bidding_source.proto"; import "google/ads/googleads/v1/enums/targeting_dimension.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -41,14 +42,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // An ad group. message AdGroup { - // The resource name of the ad group. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroup" + pattern: "customers/{customer}/adGroups/{ad_group}" + }; + + // Immutable. The resource name of the ad group. // Ad group resource names have the form: // // `customers/{customer_id}/adGroups/{ad_group_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; - // The ID of the ad group. - google.protobuf.Int64Value id = 3; + // Output only. The ID of the ad group. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // The name of the ad group. // @@ -64,32 +75,40 @@ message AdGroup { // The status of the ad group. google.ads.googleads.v1.enums.AdGroupStatusEnum.AdGroupStatus status = 5; - // The type of the ad group. - google.ads.googleads.v1.enums.AdGroupTypeEnum.AdGroupType type = 12; + // Immutable. The type of the ad group. + google.ads.googleads.v1.enums.AdGroupTypeEnum.AdGroupType type = 12 [(google.api.field_behavior) = IMMUTABLE]; // The ad rotation mode of the ad group. - google.ads.googleads.v1.enums.AdGroupAdRotationModeEnum.AdGroupAdRotationMode - ad_rotation_mode = 22; + google.ads.googleads.v1.enums.AdGroupAdRotationModeEnum.AdGroupAdRotationMode ad_rotation_mode = 22; - // For draft or experiment ad groups, this field is the resource name of the + // Output only. For draft or experiment ad groups, this field is the resource name of the // base ad group from which this ad group was created. If a draft or // experiment ad group does not have a base ad group, then this field is null. // // For base ad groups, this field equals the ad group resource name. // // This field is read-only. - google.protobuf.StringValue base_ad_group = 18; + google.protobuf.StringValue base_ad_group = 18 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; // The URL template for constructing a tracking URL. google.protobuf.StringValue tracking_url_template = 13; // The list of mappings used to substitute custom parameter tags in a // `tracking_url_template`, `final_urls`, or `mobile_final_urls`. - repeated google.ads.googleads.v1.common.CustomParameter - url_custom_parameters = 6; + repeated google.ads.googleads.v1.common.CustomParameter url_custom_parameters = 6; - // The campaign to which the ad group belongs. - google.protobuf.StringValue campaign = 10; + // Immutable. The campaign to which the ad group belongs. + google.protobuf.StringValue campaign = 10 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; // The maximum CPC (cost-per-click) bid. google.protobuf.Int64Value cpc_bid_micros = 14; @@ -100,8 +119,8 @@ message AdGroup { // The target CPA (cost-per-acquisition). google.protobuf.Int64Value target_cpa_micros = 27; - // The CPV (cost-per-view) bid. - google.protobuf.Int64Value cpv_bid_micros = 17; + // Output only. The CPV (cost-per-view) bid. + google.protobuf.Int64Value cpv_bid_micros = 17 [(google.api.field_behavior) = OUTPUT_ONLY]; // Average amount in micros that the advertiser is willing to pay for every // thousand times the ad is shown. @@ -119,14 +138,12 @@ message AdGroup { google.protobuf.Int64Value percent_cpc_bid_micros = 20; // Settings for the Display Campaign Optimizer, initially termed "Explorer". - google.ads.googleads.v1.common.ExplorerAutoOptimizerSetting - explorer_auto_optimizer_setting = 21; + google.ads.googleads.v1.common.ExplorerAutoOptimizerSetting explorer_auto_optimizer_setting = 21; // Allows advertisers to specify a targeting dimension on which to place // absolute bids. This is only applicable for campaigns that target only the // display network and not search. - google.ads.googleads.v1.enums.TargetingDimensionEnum.TargetingDimension - display_custom_bid_dimension = 23; + google.ads.googleads.v1.enums.TargetingDimensionEnum.TargetingDimension display_custom_bid_dimension = 23; // URL template for appending params to Final URL. google.protobuf.StringValue final_url_suffix = 24; @@ -134,21 +151,19 @@ message AdGroup { // Setting for targeting related features. google.ads.googleads.v1.common.TargetingSetting targeting_setting = 25; - // The effective target CPA (cost-per-acquisition). + // Output only. The effective target CPA (cost-per-acquisition). // This field is read-only. - google.protobuf.Int64Value effective_target_cpa_micros = 28; + google.protobuf.Int64Value effective_target_cpa_micros = 28 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Source of the effective target CPA. + // Output only. Source of the effective target CPA. // This field is read-only. - google.ads.googleads.v1.enums.BiddingSourceEnum.BiddingSource - effective_target_cpa_source = 29; + google.ads.googleads.v1.enums.BiddingSourceEnum.BiddingSource effective_target_cpa_source = 29 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The effective target ROAS (return-on-ad-spend). + // Output only. The effective target ROAS (return-on-ad-spend). // This field is read-only. - google.protobuf.DoubleValue effective_target_roas = 31; + google.protobuf.DoubleValue effective_target_roas = 31 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Source of the effective target ROAS. + // Output only. Source of the effective target ROAS. // This field is read-only. - google.ads.googleads.v1.enums.BiddingSourceEnum.BiddingSource - effective_target_roas_source = 32; + google.ads.googleads.v1.enums.BiddingSourceEnum.BiddingSource effective_target_roas_source = 32 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_ad.proto b/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_ad.proto index 67b7886f6..8d01e7013 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_ad.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_ad.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -23,8 +22,10 @@ import "google/ads/googleads/v1/enums/ad_strength.proto"; import "google/ads/googleads/v1/enums/policy_approval_status.proto"; import "google/ads/googleads/v1/enums/policy_review_status.proto"; import "google/ads/googleads/v1/resources/ad.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -39,40 +40,52 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // An ad group ad. message AdGroupAd { - // The resource name of the ad. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupAd" + pattern: "customers/{customer}/adGroupAds/{ad_group_ad}" + }; + + // Immutable. The resource name of the ad. // Ad group ad resource names have the form: // // `customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAd" + } + ]; // The status of the ad. google.ads.googleads.v1.enums.AdGroupAdStatusEnum.AdGroupAdStatus status = 3; - // The ad group to which the ad belongs. - google.protobuf.StringValue ad_group = 4; + // Immutable. The ad group to which the ad belongs. + google.protobuf.StringValue ad_group = 4 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; - // The ad. - Ad ad = 5; + // Immutable. The ad. + Ad ad = 5 [(google.api.field_behavior) = IMMUTABLE]; - // Policy information for the ad. - AdGroupAdPolicySummary policy_summary = 6; + // Output only. Policy information for the ad. + AdGroupAdPolicySummary policy_summary = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Overall ad strength for this ad group ad. - google.ads.googleads.v1.enums.AdStrengthEnum.AdStrength ad_strength = 7; + // Output only. Overall ad strength for this ad group ad. + google.ads.googleads.v1.enums.AdStrengthEnum.AdStrength ad_strength = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Contains policy information for an ad. message AdGroupAdPolicySummary { - // The list of policy findings for this ad. - repeated google.ads.googleads.v1.common.PolicyTopicEntry - policy_topic_entries = 1; + // Output only. The list of policy findings for this ad. + repeated google.ads.googleads.v1.common.PolicyTopicEntry policy_topic_entries = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Where in the review process this ad is. - google.ads.googleads.v1.enums.PolicyReviewStatusEnum.PolicyReviewStatus - review_status = 2; + // Output only. Where in the review process this ad is. + google.ads.googleads.v1.enums.PolicyReviewStatusEnum.PolicyReviewStatus review_status = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The overall approval status of this ad, calculated based on the status of + // Output only. The overall approval status of this ad, calculated based on the status of // its individual policy topic entries. - google.ads.googleads.v1.enums.PolicyApprovalStatusEnum.PolicyApprovalStatus - approval_status = 3; + google.ads.googleads.v1.enums.PolicyApprovalStatusEnum.PolicyApprovalStatus approval_status = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_ad_label.proto b/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_ad_label.proto index aaecc193f..b1be0c131 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_ad_label.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_ad_label.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,15 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -33,14 +34,34 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A relationship between an ad group ad and a label. message AdGroupAdLabel { - // The resource name of the ad group ad label. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupAdLabel" + pattern: "customers/{customer}/adGroupAdLabels/{ad_group_ad_label}" + }; + + // Immutable. The resource name of the ad group ad label. // Ad group ad label resource names have the form: // `customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAdLabel" + } + ]; - // The ad group ad to which the label is attached. - google.protobuf.StringValue ad_group_ad = 2; + // Immutable. The ad group ad to which the label is attached. + google.protobuf.StringValue ad_group_ad = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAd" + } + ]; - // The label assigned to the ad group ad. - google.protobuf.StringValue label = 3; + // Immutable. The label assigned to the ad group ad. + google.protobuf.StringValue label = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Label" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_audience_view.proto b/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_audience_view.proto index 6a7e7af98..5d8e6a611 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_audience_view.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_audience_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; @@ -35,9 +36,19 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // Network and YouTube Network ads, and remarketing lists for search ads (RLSA), // aggregated at the audience level. message AdGroupAudienceView { - // The resource name of the ad group audience view. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupAudienceView" + pattern: "customers/{customer}/adGroupAudienceViews/{ad_group_audience_view}" + }; + + // Output only. The resource name of the ad group audience view. // Ad group audience view resource names have the form: // // `customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAudienceView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_bid_modifier.proto b/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_bid_modifier.proto index 152c3dfa0..7de5203c7 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_bid_modifier.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_bid_modifier.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/common/criteria.proto"; import "google/ads/googleads/v1/enums/bid_modifier_source.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -35,57 +36,73 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // Represents an ad group bid modifier. message AdGroupBidModifier { - // The resource name of the ad group bid modifier. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupBidModifier" + pattern: "customers/{customer}/adGroupBidModifiers/{ad_group_bid_modifier}" + }; + + // Immutable. The resource name of the ad group bid modifier. // Ad group bid modifier resource names have the form: // // `customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}` - string resource_name = 1; - - // The ad group to which this criterion belongs. - google.protobuf.StringValue ad_group = 2; - - // The ID of the criterion to bid modify. + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupBidModifier" + } + ]; + + // Immutable. The ad group to which this criterion belongs. + google.protobuf.StringValue ad_group = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; + + // Output only. The ID of the criterion to bid modify. // // This field is ignored for mutates. - google.protobuf.Int64Value criterion_id = 3; + google.protobuf.Int64Value criterion_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // The modifier for the bid when the criterion matches. The modifier must be // in the range: 0.1 - 10.0. The range is 1.0 - 6.0 for PreferredContent. // Use 0 to opt out of a Device type. google.protobuf.DoubleValue bid_modifier = 4; - // The base ad group from which this draft/trial adgroup bid modifier was + // Output only. The base ad group from which this draft/trial adgroup bid modifier was // created. If ad_group is a base ad group then this field will be equal to // ad_group. If the ad group was created in the draft or trial and has no // corresponding base ad group, then this field will be null. // This field is readonly. - google.protobuf.StringValue base_ad_group = 9; + google.protobuf.StringValue base_ad_group = 9 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; - // Bid modifier source. - google.ads.googleads.v1.enums.BidModifierSourceEnum.BidModifierSource - bid_modifier_source = 10; + // Output only. Bid modifier source. + google.ads.googleads.v1.enums.BidModifierSourceEnum.BidModifierSource bid_modifier_source = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; // The criterion of this ad group bid modifier. oneof criterion { - // Criterion for hotel date selection (default dates vs. user selected). - google.ads.googleads.v1.common.HotelDateSelectionTypeInfo - hotel_date_selection_type = 5; + // Immutable. Criterion for hotel date selection (default dates vs. user selected). + google.ads.googleads.v1.common.HotelDateSelectionTypeInfo hotel_date_selection_type = 5 [(google.api.field_behavior) = IMMUTABLE]; - // Criterion for number of days prior to the stay the booking is being made. - google.ads.googleads.v1.common.HotelAdvanceBookingWindowInfo - hotel_advance_booking_window = 6; + // Immutable. Criterion for number of days prior to the stay the booking is being made. + google.ads.googleads.v1.common.HotelAdvanceBookingWindowInfo hotel_advance_booking_window = 6 [(google.api.field_behavior) = IMMUTABLE]; - // Criterion for length of hotel stay in nights. - google.ads.googleads.v1.common.HotelLengthOfStayInfo hotel_length_of_stay = - 7; + // Immutable. Criterion for length of hotel stay in nights. + google.ads.googleads.v1.common.HotelLengthOfStayInfo hotel_length_of_stay = 7 [(google.api.field_behavior) = IMMUTABLE]; - // Criterion for day of the week the booking is for. - google.ads.googleads.v1.common.HotelCheckInDayInfo hotel_check_in_day = 8; + // Immutable. Criterion for day of the week the booking is for. + google.ads.googleads.v1.common.HotelCheckInDayInfo hotel_check_in_day = 8 [(google.api.field_behavior) = IMMUTABLE]; - // A device criterion. - google.ads.googleads.v1.common.DeviceInfo device = 11; + // Immutable. A device criterion. + google.ads.googleads.v1.common.DeviceInfo device = 11 [(google.api.field_behavior) = IMMUTABLE]; - // A preferred content criterion. - google.ads.googleads.v1.common.PreferredContentInfo preferred_content = 12; + // Immutable. A preferred content criterion. + google.ads.googleads.v1.common.PreferredContentInfo preferred_content = 12 [(google.api.field_behavior) = IMMUTABLE]; } } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_criterion.proto b/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_criterion.proto index 10ef22aba..28a967409 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_criterion.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_criterion.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -25,8 +24,10 @@ import "google/ads/googleads/v1/enums/bidding_source.proto"; import "google/ads/googleads/v1/enums/criterion_system_serving_status.proto"; import "google/ads/googleads/v1/enums/criterion_type.proto"; import "google/ads/googleads/v1/enums/quality_score_bucket.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -41,87 +42,96 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // An ad group criterion. message AdGroupCriterion { + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupCriterion" + pattern: "customers/{customer}/adGroupCriteria/{ad_group_criterion}" + }; + // A container for ad group criterion quality information. message QualityInfo { - // The quality score. + // Output only. The quality score. // // This field may not be populated if Google does not have enough // information to determine a value. - google.protobuf.Int32Value quality_score = 1; + google.protobuf.Int32Value quality_score = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The performance of the ad compared to other advertisers. - google.ads.googleads.v1.enums.QualityScoreBucketEnum.QualityScoreBucket - creative_quality_score = 2; + // Output only. The performance of the ad compared to other advertisers. + google.ads.googleads.v1.enums.QualityScoreBucketEnum.QualityScoreBucket creative_quality_score = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The quality score of the landing page. - google.ads.googleads.v1.enums.QualityScoreBucketEnum.QualityScoreBucket - post_click_quality_score = 3; + // Output only. The quality score of the landing page. + google.ads.googleads.v1.enums.QualityScoreBucketEnum.QualityScoreBucket post_click_quality_score = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The click-through rate compared to that of other advertisers. - google.ads.googleads.v1.enums.QualityScoreBucketEnum.QualityScoreBucket - search_predicted_ctr = 4; + // Output only. The click-through rate compared to that of other advertisers. + google.ads.googleads.v1.enums.QualityScoreBucketEnum.QualityScoreBucket search_predicted_ctr = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Estimates for criterion bids at various positions. message PositionEstimates { - // The estimate of the CPC bid required for ad to be shown on first + // Output only. The estimate of the CPC bid required for ad to be shown on first // page of search results. - google.protobuf.Int64Value first_page_cpc_micros = 1; + google.protobuf.Int64Value first_page_cpc_micros = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The estimate of the CPC bid required for ad to be displayed in first + // Output only. The estimate of the CPC bid required for ad to be displayed in first // position, at the top of the first page of search results. - google.protobuf.Int64Value first_position_cpc_micros = 2; + google.protobuf.Int64Value first_position_cpc_micros = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The estimate of the CPC bid required for ad to be displayed at the top + // Output only. The estimate of the CPC bid required for ad to be displayed at the top // of the first page of search results. - google.protobuf.Int64Value top_of_page_cpc_micros = 3; + google.protobuf.Int64Value top_of_page_cpc_micros = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Estimate of how many clicks per week you might get by changing your + // Output only. Estimate of how many clicks per week you might get by changing your // keyword bid to the value in first_position_cpc_micros. - google.protobuf.Int64Value estimated_add_clicks_at_first_position_cpc = 4; + google.protobuf.Int64Value estimated_add_clicks_at_first_position_cpc = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Estimate of how your cost per week might change when changing your + // Output only. Estimate of how your cost per week might change when changing your // keyword bid to the value in first_position_cpc_micros. - google.protobuf.Int64Value estimated_add_cost_at_first_position_cpc = 5; + google.protobuf.Int64Value estimated_add_cost_at_first_position_cpc = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; } - // The resource name of the ad group criterion. + // Immutable. The resource name of the ad group criterion. // Ad group criterion resource names have the form: // // `customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}` - string resource_name = 1; - - // The ID of the criterion. + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterion" + } + ]; + + // Output only. The ID of the criterion. // // This field is ignored for mutates. - google.protobuf.Int64Value criterion_id = 26; + google.protobuf.Int64Value criterion_id = 26 [(google.api.field_behavior) = OUTPUT_ONLY]; // The status of the criterion. - google.ads.googleads.v1.enums.AdGroupCriterionStatusEnum - .AdGroupCriterionStatus status = 3; + google.ads.googleads.v1.enums.AdGroupCriterionStatusEnum.AdGroupCriterionStatus status = 3; - // Information regarding the quality of the criterion. - QualityInfo quality_info = 4; + // Output only. Information regarding the quality of the criterion. + QualityInfo quality_info = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The ad group to which the criterion belongs. - google.protobuf.StringValue ad_group = 5; + // Immutable. The ad group to which the criterion belongs. + google.protobuf.StringValue ad_group = 5 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; - // The type of the criterion. - google.ads.googleads.v1.enums.CriterionTypeEnum.CriterionType type = 25; + // Output only. The type of the criterion. + google.ads.googleads.v1.enums.CriterionTypeEnum.CriterionType type = 25 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Whether to target (`false`) or exclude (`true`) the criterion. + // Immutable. Whether to target (`false`) or exclude (`true`) the criterion. // // This field is immutable. To switch a criterion from positive to negative, // remove then re-add it. - google.protobuf.BoolValue negative = 31; + google.protobuf.BoolValue negative = 31 [(google.api.field_behavior) = IMMUTABLE]; - // Serving status of the criterion. - google.ads.googleads.v1.enums.CriterionSystemServingStatusEnum - .CriterionSystemServingStatus system_serving_status = 52; + // Output only. Serving status of the criterion. + google.ads.googleads.v1.enums.CriterionSystemServingStatusEnum.CriterionSystemServingStatus system_serving_status = 52 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Approval status of the criterion. - google.ads.googleads.v1.enums.AdGroupCriterionApprovalStatusEnum - .AdGroupCriterionApprovalStatus approval_status = 53; + // Output only. Approval status of the criterion. + google.ads.googleads.v1.enums.AdGroupCriterionApprovalStatusEnum.AdGroupCriterionApprovalStatus approval_status = 53 [(google.api.field_behavior) = OUTPUT_ONLY]; // The modifier for the bid when the criterion matches. The modifier must be // in the range: 0.1 - 10.0. Most targetable criteria types support modifiers. @@ -141,36 +151,32 @@ message AdGroupCriterion { // value stored here is 1,000,000 * [fraction]. google.protobuf.Int64Value percent_cpc_bid_micros = 33; - // The effective CPC (cost-per-click) bid. - google.protobuf.Int64Value effective_cpc_bid_micros = 18; + // Output only. The effective CPC (cost-per-click) bid. + google.protobuf.Int64Value effective_cpc_bid_micros = 18 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The effective CPM (cost-per-thousand viewable impressions) bid. - google.protobuf.Int64Value effective_cpm_bid_micros = 19; + // Output only. The effective CPM (cost-per-thousand viewable impressions) bid. + google.protobuf.Int64Value effective_cpm_bid_micros = 19 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The effective CPV (cost-per-view) bid. - google.protobuf.Int64Value effective_cpv_bid_micros = 20; + // Output only. The effective CPV (cost-per-view) bid. + google.protobuf.Int64Value effective_cpv_bid_micros = 20 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The effective Percent CPC bid amount. - google.protobuf.Int64Value effective_percent_cpc_bid_micros = 34; + // Output only. The effective Percent CPC bid amount. + google.protobuf.Int64Value effective_percent_cpc_bid_micros = 34 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Source of the effective CPC bid. - google.ads.googleads.v1.enums.BiddingSourceEnum.BiddingSource - effective_cpc_bid_source = 21; + // Output only. Source of the effective CPC bid. + google.ads.googleads.v1.enums.BiddingSourceEnum.BiddingSource effective_cpc_bid_source = 21 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Source of the effective CPM bid. - google.ads.googleads.v1.enums.BiddingSourceEnum.BiddingSource - effective_cpm_bid_source = 22; + // Output only. Source of the effective CPM bid. + google.ads.googleads.v1.enums.BiddingSourceEnum.BiddingSource effective_cpm_bid_source = 22 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Source of the effective CPV bid. - google.ads.googleads.v1.enums.BiddingSourceEnum.BiddingSource - effective_cpv_bid_source = 23; + // Output only. Source of the effective CPV bid. + google.ads.googleads.v1.enums.BiddingSourceEnum.BiddingSource effective_cpv_bid_source = 23 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Source of the effective Percent CPC bid. - google.ads.googleads.v1.enums.BiddingSourceEnum.BiddingSource - effective_percent_cpc_bid_source = 35; + // Output only. Source of the effective Percent CPC bid. + google.ads.googleads.v1.enums.BiddingSourceEnum.BiddingSource effective_percent_cpc_bid_source = 35 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Estimates for criterion bids at various positions. - PositionEstimates position_estimates = 10; + // Output only. Estimates for criterion bids at various positions. + PositionEstimates position_estimates = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; // The list of possible final URLs after all cross-domain redirects for the // ad. @@ -187,67 +193,64 @@ message AdGroupCriterion { // The list of mappings used to substitute custom parameter tags in a // `tracking_url_template`, `final_urls`, or `mobile_final_urls`. - repeated google.ads.googleads.v1.common.CustomParameter - url_custom_parameters = 14; + repeated google.ads.googleads.v1.common.CustomParameter url_custom_parameters = 14; // The ad group criterion. // // Exactly one must be set. oneof criterion { - // Keyword. - google.ads.googleads.v1.common.KeywordInfo keyword = 27; + // Immutable. Keyword. + google.ads.googleads.v1.common.KeywordInfo keyword = 27 [(google.api.field_behavior) = IMMUTABLE]; - // Placement. - google.ads.googleads.v1.common.PlacementInfo placement = 28; + // Immutable. Placement. + google.ads.googleads.v1.common.PlacementInfo placement = 28 [(google.api.field_behavior) = IMMUTABLE]; - // Mobile app category. - google.ads.googleads.v1.common.MobileAppCategoryInfo mobile_app_category = - 29; + // Immutable. Mobile app category. + google.ads.googleads.v1.common.MobileAppCategoryInfo mobile_app_category = 29 [(google.api.field_behavior) = IMMUTABLE]; - // Mobile application. - google.ads.googleads.v1.common.MobileApplicationInfo mobile_application = - 30; + // Immutable. Mobile application. + google.ads.googleads.v1.common.MobileApplicationInfo mobile_application = 30 [(google.api.field_behavior) = IMMUTABLE]; - // Listing group. - google.ads.googleads.v1.common.ListingGroupInfo listing_group = 32; + // Immutable. Listing group. + google.ads.googleads.v1.common.ListingGroupInfo listing_group = 32 [(google.api.field_behavior) = IMMUTABLE]; - // Age range. - google.ads.googleads.v1.common.AgeRangeInfo age_range = 36; + // Immutable. Age range. + google.ads.googleads.v1.common.AgeRangeInfo age_range = 36 [(google.api.field_behavior) = IMMUTABLE]; - // Gender. - google.ads.googleads.v1.common.GenderInfo gender = 37; + // Immutable. Gender. + google.ads.googleads.v1.common.GenderInfo gender = 37 [(google.api.field_behavior) = IMMUTABLE]; - // Income range. - google.ads.googleads.v1.common.IncomeRangeInfo income_range = 38; + // Immutable. Income range. + google.ads.googleads.v1.common.IncomeRangeInfo income_range = 38 [(google.api.field_behavior) = IMMUTABLE]; - // Parental status. - google.ads.googleads.v1.common.ParentalStatusInfo parental_status = 39; + // Immutable. Parental status. + google.ads.googleads.v1.common.ParentalStatusInfo parental_status = 39 [(google.api.field_behavior) = IMMUTABLE]; - // User List. - google.ads.googleads.v1.common.UserListInfo user_list = 42; + // Immutable. User List. + google.ads.googleads.v1.common.UserListInfo user_list = 42 [(google.api.field_behavior) = IMMUTABLE]; - // YouTube Video. - google.ads.googleads.v1.common.YouTubeVideoInfo youtube_video = 40; + // Immutable. YouTube Video. + google.ads.googleads.v1.common.YouTubeVideoInfo youtube_video = 40 [(google.api.field_behavior) = IMMUTABLE]; - // YouTube Channel. - google.ads.googleads.v1.common.YouTubeChannelInfo youtube_channel = 41; + // Immutable. YouTube Channel. + google.ads.googleads.v1.common.YouTubeChannelInfo youtube_channel = 41 [(google.api.field_behavior) = IMMUTABLE]; - // Topic. - google.ads.googleads.v1.common.TopicInfo topic = 43; + // Immutable. Topic. + google.ads.googleads.v1.common.TopicInfo topic = 43 [(google.api.field_behavior) = IMMUTABLE]; - // User Interest. - google.ads.googleads.v1.common.UserInterestInfo user_interest = 45; + // Immutable. User Interest. + google.ads.googleads.v1.common.UserInterestInfo user_interest = 45 [(google.api.field_behavior) = IMMUTABLE]; - // Webpage - google.ads.googleads.v1.common.WebpageInfo webpage = 46; + // Immutable. Webpage + google.ads.googleads.v1.common.WebpageInfo webpage = 46 [(google.api.field_behavior) = IMMUTABLE]; - // App Payment Model. - google.ads.googleads.v1.common.AppPaymentModelInfo app_payment_model = 47; + // Immutable. App Payment Model. + google.ads.googleads.v1.common.AppPaymentModelInfo app_payment_model = 47 [(google.api.field_behavior) = IMMUTABLE]; - // Custom Affinity. - google.ads.googleads.v1.common.CustomAffinityInfo custom_affinity = 48; + // Immutable. Custom Affinity. + google.ads.googleads.v1.common.CustomAffinityInfo custom_affinity = 48 [(google.api.field_behavior) = IMMUTABLE]; - // Custom Intent. - google.ads.googleads.v1.common.CustomIntentInfo custom_intent = 49; + // Immutable. Custom Intent. + google.ads.googleads.v1.common.CustomIntentInfo custom_intent = 49 [(google.api.field_behavior) = IMMUTABLE]; } } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_criterion_label.proto b/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_criterion_label.proto index 121f6772d..6d5bc87ad 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_criterion_label.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_criterion_label.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,15 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -33,15 +34,34 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A relationship between an ad group criterion and a label. message AdGroupCriterionLabel { - // The resource name of the ad group criterion label. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupCriterionLabel" + pattern: "customers/{customer}/adGroupCriterionLabels/{ad_group_criterion_label}" + }; + + // Immutable. The resource name of the ad group criterion label. // Ad group criterion label resource names have the form: - // // `customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterionLabel" + } + ]; - // The ad group criterion to which the label is attached. - google.protobuf.StringValue ad_group_criterion = 2; + // Immutable. The ad group criterion to which the label is attached. + google.protobuf.StringValue ad_group_criterion = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterion" + } + ]; - // The label assigned to the ad group criterion. - google.protobuf.StringValue label = 3; + // Immutable. The label assigned to the ad group criterion. + google.protobuf.StringValue label = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Label" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_criterion_simulation.proto b/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_criterion_simulation.proto index e846e635a..c014d2764 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_criterion_simulation.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_criterion_simulation.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,8 +19,10 @@ package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/common/simulation.proto"; import "google/ads/googleads/v1/enums/simulation_modification_method.proto"; import "google/ads/googleads/v1/enums/simulation_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -38,38 +39,47 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // channel type, criterion type, simulation type, and simulation modification // method are detailed below respectively. // -// SEARCH KEYWORD CPC_BID UNIFORM +// 1. DISPLAY - KEYWORD - CPC_BID - UNIFORM +// 2. SEARCH - KEYWORD - CPC_BID - UNIFORM +// 3. SHOPPING - LISTING_GROUP - CPC_BID - UNIFORM message AdGroupCriterionSimulation { - // The resource name of the ad group criterion simulation. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupCriterionSimulation" + pattern: "customers/{customer}/adGroupCriterionSimulations/{ad_group_criterion_simulation}" + }; + + // Output only. The resource name of the ad group criterion simulation. // Ad group criterion simulation resource names have the form: // - // // `customers/{customer_id}/adGroupCriterionSimulations/{ad_group_id}~{criterion_id}~{type}~{modification_method}~{start_date}~{end_date}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterionSimulation" + } + ]; - // AdGroup ID of the simulation. - google.protobuf.Int64Value ad_group_id = 2; + // Output only. AdGroup ID of the simulation. + google.protobuf.Int64Value ad_group_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Criterion ID of the simulation. - google.protobuf.Int64Value criterion_id = 3; + // Output only. Criterion ID of the simulation. + google.protobuf.Int64Value criterion_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The field that the simulation modifies. - google.ads.googleads.v1.enums.SimulationTypeEnum.SimulationType type = 4; + // Output only. The field that the simulation modifies. + google.ads.googleads.v1.enums.SimulationTypeEnum.SimulationType type = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // How the simulation modifies the field. - google.ads.googleads.v1.enums.SimulationModificationMethodEnum - .SimulationModificationMethod modification_method = 5; + // Output only. How the simulation modifies the field. + google.ads.googleads.v1.enums.SimulationModificationMethodEnum.SimulationModificationMethod modification_method = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // First day on which the simulation is based, in YYYY-MM-DD format. - google.protobuf.StringValue start_date = 6; + // Output only. First day on which the simulation is based, in YYYY-MM-DD format. + google.protobuf.StringValue start_date = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Last day on which the simulation is based, in YYYY-MM-DD format. - google.protobuf.StringValue end_date = 7; + // Output only. Last day on which the simulation is based, in YYYY-MM-DD format. + google.protobuf.StringValue end_date = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; // List of simulation points. oneof point_list { - // Simulation points if the simulation type is CPC_BID. - google.ads.googleads.v1.common.CpcBidSimulationPointList - cpc_bid_point_list = 8; + // Output only. Simulation points if the simulation type is CPC_BID. + google.ads.googleads.v1.common.CpcBidSimulationPointList cpc_bid_point_list = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; } } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_extension_setting.proto b/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_extension_setting.proto index fef67a91c..fba1f6b0c 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_extension_setting.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_extension_setting.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/extension_setting_device.proto"; import "google/ads/googleads/v1/enums/extension_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -35,31 +36,45 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // An ad group extension setting. message AdGroupExtensionSetting { - // The resource name of the ad group extension setting. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupExtensionSetting" + pattern: "customers/{customer}/adGroupExtensionSettings/{ad_group_extension_setting}" + }; + + // Immutable. The resource name of the ad group extension setting. // AdGroupExtensionSetting resource names have the form: // - // // `customers/{customer_id}/adGroupExtensionSettings/{ad_group_id}~{extension_type}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupExtensionSetting" + } + ]; - // The extension type of the ad group extension setting. - google.ads.googleads.v1.enums.ExtensionTypeEnum.ExtensionType extension_type = - 2; + // Immutable. The extension type of the ad group extension setting. + google.ads.googleads.v1.enums.ExtensionTypeEnum.ExtensionType extension_type = 2 [(google.api.field_behavior) = IMMUTABLE]; - // The resource name of the ad group. The linked extension feed items will + // Immutable. The resource name of the ad group. The linked extension feed items will // serve under this ad group. // AdGroup resource names have the form: // // `customers/{customer_id}/adGroups/{ad_group_id}` - google.protobuf.StringValue ad_group = 3; + google.protobuf.StringValue ad_group = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; // The resource names of the extension feed items to serve under the ad group. // ExtensionFeedItem resource names have the form: // // `customers/{customer_id}/extensionFeedItems/{feed_item_id}` - repeated google.protobuf.StringValue extension_feed_items = 4; + repeated google.protobuf.StringValue extension_feed_items = 4 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/ExtensionFeedItem" + }]; // The device for which the extensions will serve. Optional. - google.ads.googleads.v1.enums.ExtensionSettingDeviceEnum - .ExtensionSettingDevice device = 5; + google.ads.googleads.v1.enums.ExtensionSettingDeviceEnum.ExtensionSettingDevice device = 5; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_feed.proto b/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_feed.proto index e1f1601fd..982f0cd9e 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_feed.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_feed.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,8 +19,10 @@ package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/common/matching_function.proto"; import "google/ads/googleads/v1/enums/feed_link_status.proto"; import "google/ads/googleads/v1/enums/placeholder_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -36,29 +37,48 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // An ad group feed. message AdGroupFeed { - // The resource name of the ad group feed. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupFeed" + pattern: "customers/{customer}/adGroupFeeds/{ad_group_feed}" + }; + + // Immutable. The resource name of the ad group feed. // Ad group feed resource names have the form: // // `customers/{customer_id}/adGroupFeeds/{ad_group_id}~{feed_id} - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupFeed" + } + ]; - // The feed being linked to the ad group. - google.protobuf.StringValue feed = 2; + // Immutable. The feed being linked to the ad group. + google.protobuf.StringValue feed = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; - // The ad group being linked to the feed. - google.protobuf.StringValue ad_group = 3; + // Immutable. The ad group being linked to the feed. + google.protobuf.StringValue ad_group = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; // Indicates which placeholder types the feed may populate under the connected // ad group. Required. - repeated google.ads.googleads.v1.enums.PlaceholderTypeEnum.PlaceholderType - placeholder_types = 4; + repeated google.ads.googleads.v1.enums.PlaceholderTypeEnum.PlaceholderType placeholder_types = 4; // Matching function associated with the AdGroupFeed. // The matching function is used to filter the set of feed items selected. // Required. google.ads.googleads.v1.common.MatchingFunction matching_function = 5; - // Status of the ad group feed. + // Output only. Status of the ad group feed. // This field is read-only. - google.ads.googleads.v1.enums.FeedLinkStatusEnum.FeedLinkStatus status = 6; + google.ads.googleads.v1.enums.FeedLinkStatusEnum.FeedLinkStatus status = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_label.proto b/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_label.proto index db9f20d4e..932351f59 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_label.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_label.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,15 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -33,14 +34,34 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A relationship between an ad group and a label. message AdGroupLabel { - // The resource name of the ad group label. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupLabel" + pattern: "customers/{customer}/adGroupLabels/{ad_group_label}" + }; + + // Immutable. The resource name of the ad group label. // Ad group label resource names have the form: // `customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupLabel" + } + ]; - // The ad group to which the label is attached. - google.protobuf.StringValue ad_group = 2; + // Immutable. The ad group to which the label is attached. + google.protobuf.StringValue ad_group = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; - // The label assigned to the ad group. - google.protobuf.StringValue label = 3; + // Immutable. The label assigned to the ad group. + google.protobuf.StringValue label = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Label" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_simulation.proto b/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_simulation.proto index 303b30e37..9f1035d46 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_simulation.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/ad_group_simulation.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,8 +19,10 @@ package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/common/simulation.proto"; import "google/ads/googleads/v1/enums/simulation_modification_method.proto"; import "google/ads/googleads/v1/enums/simulation_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -38,50 +39,55 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // channel type, simulation type and simulation modification method is // detailed below respectively. // -// SEARCH CPC_BID DEFAULT -// SEARCH CPC_BID UNIFORM -// SEARCH TARGET_CPA UNIFORM -// DISPLAY CPC_BID DEFAULT -// DISPLAY CPC_BID UNIFORM -// DISPLAY TARGET_CPA UNIFORM -// VIDEO CPV_BID DEFAULT -// VIDEO CPV_BID UNIFORM +// 1. SEARCH - CPC_BID - DEFAULT +// 2. SEARCH - CPC_BID - UNIFORM +// 3. SEARCH - TARGET_CPA - UNIFORM +// 4. DISPLAY - CPC_BID - DEFAULT +// 5. DISPLAY - CPC_BID - UNIFORM +// 6. DISPLAY - TARGET_CPA - UNIFORM +// 7. VIDEO - CPV_BID - DEFAULT +// 8. VIDEO - CPV_BID - UNIFORM message AdGroupSimulation { - // The resource name of the ad group simulation. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupSimulation" + pattern: "customers/{customer}/adGroupSimulations/{ad_group_simulation}" + }; + + // Output only. The resource name of the ad group simulation. // Ad group simulation resource names have the form: // - // // `customers/{customer_id}/adGroupSimulations/{ad_group_id}~{type}~{modification_method}~{start_date}~{end_date}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupSimulation" + } + ]; - // Ad group id of the simulation. - google.protobuf.Int64Value ad_group_id = 2; + // Output only. Ad group id of the simulation. + google.protobuf.Int64Value ad_group_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The field that the simulation modifies. - google.ads.googleads.v1.enums.SimulationTypeEnum.SimulationType type = 3; + // Output only. The field that the simulation modifies. + google.ads.googleads.v1.enums.SimulationTypeEnum.SimulationType type = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // How the simulation modifies the field. - google.ads.googleads.v1.enums.SimulationModificationMethodEnum - .SimulationModificationMethod modification_method = 4; + // Output only. How the simulation modifies the field. + google.ads.googleads.v1.enums.SimulationModificationMethodEnum.SimulationModificationMethod modification_method = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // First day on which the simulation is based, in YYYY-MM-DD format. - google.protobuf.StringValue start_date = 5; + // Output only. First day on which the simulation is based, in YYYY-MM-DD format. + google.protobuf.StringValue start_date = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Last day on which the simulation is based, in YYYY-MM-DD format - google.protobuf.StringValue end_date = 6; + // Output only. Last day on which the simulation is based, in YYYY-MM-DD format + google.protobuf.StringValue end_date = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; // List of simulation points. oneof point_list { - // Simulation points if the simulation type is CPC_BID. - google.ads.googleads.v1.common.CpcBidSimulationPointList - cpc_bid_point_list = 8; + // Output only. Simulation points if the simulation type is CPC_BID. + google.ads.googleads.v1.common.CpcBidSimulationPointList cpc_bid_point_list = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Simulation points if the simulation type is CPV_BID. - google.ads.googleads.v1.common.CpvBidSimulationPointList - cpv_bid_point_list = 10; + // Output only. Simulation points if the simulation type is CPV_BID. + google.ads.googleads.v1.common.CpvBidSimulationPointList cpv_bid_point_list = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Simulation points if the simulation type is TARGET_CPA. - google.ads.googleads.v1.common.TargetCpaSimulationPointList - target_cpa_point_list = 9; + // Output only. Simulation points if the simulation type is TARGET_CPA. + google.ads.googleads.v1.common.TargetCpaSimulationPointList target_cpa_point_list = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; } } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/ad_parameter.proto b/third_party/googleapis/google/ads/googleads/v1/resources/ad_parameter.proto index 6c53fe38a..17d25c085 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/ad_parameter.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/ad_parameter.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,15 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -38,18 +39,32 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // In the ad the parameters are referenced by a placeholder of the form // "{param#:value}". E.g. "{param1:$17}" message AdParameter { - // The resource name of the ad parameter. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdParameter" + pattern: "customers/{customer}/adParameters/{ad_parameter}" + }; + + // Immutable. The resource name of the ad parameter. // Ad parameter resource names have the form: // - // // `customers/{customer_id}/adParameters/{ad_group_id}~{criterion_id}~{parameter_index}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdParameter" + } + ]; - // The ad group criterion that this ad parameter belongs to. - google.protobuf.StringValue ad_group_criterion = 2; + // Immutable. The ad group criterion that this ad parameter belongs to. + google.protobuf.StringValue ad_group_criterion = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterion" + } + ]; - // The unique index of this ad parameter. Must be either 1 or 2. - google.protobuf.Int64Value parameter_index = 3; + // Immutable. The unique index of this ad parameter. Must be either 1 or 2. + google.protobuf.Int64Value parameter_index = 3 [(google.api.field_behavior) = IMMUTABLE]; // Numeric value to insert into the ad text. The following restrictions // apply: diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/ad_schedule_view.proto b/third_party/googleapis/google/ads/googleads/v1/resources/ad_schedule_view.proto index 80fbeda47..a7828292b 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/ad_schedule_view.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/ad_schedule_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; @@ -33,9 +34,19 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // An ad schedule view summarizes the performance of campaigns by // AdSchedule criteria. message AdScheduleView { - // The resource name of the ad schedule view. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdScheduleView" + pattern: "customers/{customer}/adScheduleViews/{ad_schedule_view}" + }; + + // Output only. The resource name of the ad schedule view. // AdSchedule view resource names have the form: // // `customers/{customer_id}/adScheduleViews/{campaign_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdScheduleView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/age_range_view.proto b/third_party/googleapis/google/ads/googleads/v1/resources/age_range_view.proto index da1e80850..cc0b8392d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/age_range_view.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/age_range_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; @@ -32,9 +33,19 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // An age range view. message AgeRangeView { - // The resource name of the age range view. + option (google.api.resource) = { + type: "googleads.googleapis.com/AgeRangeView" + pattern: "customers/{customer}/ageRangeViews/{age_range_view}" + }; + + // Output only. The resource name of the age range view. // Age range view resource names have the form: // // `customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AgeRangeView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/asset.proto b/third_party/googleapis/google/ads/googleads/v1/resources/asset.proto index d30514a65..052aba2e6 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/asset.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/asset.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/common/asset_types.proto"; import "google/ads/googleads/v1/enums/asset_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -36,33 +37,43 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // Asset is a part of an ad which can be shared across multiple ads. // It can be an image (ImageAsset), a video (YoutubeVideoAsset), etc. message Asset { - // The resource name of the asset. + option (google.api.resource) = { + type: "googleads.googleapis.com/Asset" + pattern: "customers/{customer}/assets/{asset}" + }; + + // Immutable. The resource name of the asset. // Asset resource names have the form: // // `customers/{customer_id}/assets/{asset_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Asset" + } + ]; - // The ID of the asset. - google.protobuf.Int64Value id = 2; + // Output only. The ID of the asset. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; // Optional name of the asset. google.protobuf.StringValue name = 3; - // Type of the asset. - google.ads.googleads.v1.enums.AssetTypeEnum.AssetType type = 4; + // Output only. Type of the asset. + google.ads.googleads.v1.enums.AssetTypeEnum.AssetType type = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; // The specific type of the asset. oneof asset_data { - // A YouTube video asset. - google.ads.googleads.v1.common.YoutubeVideoAsset youtube_video_asset = 5; + // Immutable. A YouTube video asset. + google.ads.googleads.v1.common.YoutubeVideoAsset youtube_video_asset = 5 [(google.api.field_behavior) = IMMUTABLE]; - // A media bundle asset. - google.ads.googleads.v1.common.MediaBundleAsset media_bundle_asset = 6; + // Immutable. A media bundle asset. + google.ads.googleads.v1.common.MediaBundleAsset media_bundle_asset = 6 [(google.api.field_behavior) = IMMUTABLE]; - // An image asset. - google.ads.googleads.v1.common.ImageAsset image_asset = 7; + // Output only. An image asset. + google.ads.googleads.v1.common.ImageAsset image_asset = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; - // A text asset. - google.ads.googleads.v1.common.TextAsset text_asset = 8; + // Output only. A text asset. + google.ads.googleads.v1.common.TextAsset text_asset = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; } } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/bidding_strategy.proto b/third_party/googleapis/google/ads/googleads/v1/resources/bidding_strategy.proto index 774a6a6e3..2ce35b417 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/bidding_strategy.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/bidding_strategy.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,8 +19,10 @@ package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/common/bidding.proto"; import "google/ads/googleads/v1/enums/bidding_strategy_status.proto"; import "google/ads/googleads/v1/enums/bidding_strategy_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -36,14 +37,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A bidding strategy. message BiddingStrategy { - // The resource name of the bidding strategy. + option (google.api.resource) = { + type: "googleads.googleapis.com/BiddingStrategy" + pattern: "customers/{customer}/biddingStrategies/{bidding_strategy}" + }; + + // Immutable. The resource name of the bidding strategy. // Bidding strategy resource names have the form: // // `customers/{customer_id}/biddingStrategies/{bidding_strategy_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/BiddingStrategy" + } + ]; - // The ID of the bidding strategy. - google.protobuf.Int64Value id = 3; + // Output only. The ID of the bidding strategy. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // The name of the bidding strategy. // All bidding strategies within an account must be named distinctly. @@ -52,28 +63,26 @@ message BiddingStrategy { // in UTF-8 bytes, (trimmed). google.protobuf.StringValue name = 4; - // The status of the bidding strategy. + // Output only. The status of the bidding strategy. // // This field is read-only. - google.ads.googleads.v1.enums.BiddingStrategyStatusEnum.BiddingStrategyStatus - status = 15; + google.ads.googleads.v1.enums.BiddingStrategyStatusEnum.BiddingStrategyStatus status = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The type of the bidding strategy. + // Output only. The type of the bidding strategy. // Create a bidding strategy by setting the bidding scheme. // // This field is read-only. - google.ads.googleads.v1.enums.BiddingStrategyTypeEnum.BiddingStrategyType - type = 5; + google.ads.googleads.v1.enums.BiddingStrategyTypeEnum.BiddingStrategyType type = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The number of campaigns attached to this bidding strategy. + // Output only. The number of campaigns attached to this bidding strategy. // // This field is read-only. - google.protobuf.Int64Value campaign_count = 13; + google.protobuf.Int64Value campaign_count = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The number of non-removed campaigns attached to this bidding strategy. + // Output only. The number of non-removed campaigns attached to this bidding strategy. // // This field is read-only. - google.protobuf.Int64Value non_removed_campaign_count = 14; + google.protobuf.Int64Value non_removed_campaign_count = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; // The bidding scheme. // @@ -86,6 +95,10 @@ message BiddingStrategy { // A bidding strategy that sets max CPC bids to target impressions on // page one or page one promoted slots on google.com. + // This field is deprecated. Creating a new bidding strategy with this + // field or attaching bidding strategies with this field to a campaign will + // fail. Mutates to strategies that already have this scheme populated are + // allowed. google.ads.googleads.v1.common.PageOnePromoted page_one_promoted = 8; // A bidding strategy that sets bids to help get as many conversions as @@ -94,11 +107,14 @@ message BiddingStrategy { // A bidding strategy that automatically optimizes towards a desired // percentage of impressions. - google.ads.googleads.v1.common.TargetImpressionShare - target_impression_share = 48; + google.ads.googleads.v1.common.TargetImpressionShare target_impression_share = 48; // A bidding strategy that sets bids based on the target fraction of // auctions where the advertiser should outrank a specific competitor. + // This field is deprecated. Creating a new bidding strategy with this + // field or attaching bidding strategies with this field to a campaign will + // fail. Mutates to strategies that already have this scheme populated are + // allowed. google.ads.googleads.v1.common.TargetOutrankShare target_outrank_share = 10; // A bidding strategy that helps you maximize revenue while averaging a diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/billing_setup.proto b/third_party/googleapis/google/ads/googleads/v1/resources/billing_setup.proto index 143ee2892..efaa11d4c 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/billing_setup.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/billing_setup.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/billing_setup_status.proto"; import "google/ads/googleads/v1/enums/time_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -33,69 +34,82 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // Proto file describing the BillingSetup resource. -// A billing setup across Ads and Payments systems; an association between a -// Payments account and an advertiser. A billing setup is specific to one -// advertiser. +// A billing setup, which associates a payments account and an advertiser. A +// billing setup is specific to one advertiser. message BillingSetup { - // Container of Payments account information for this billing. + option (google.api.resource) = { + type: "googleads.googleapis.com/BillingSetup" + pattern: "customers/{customer}/billingSetups/{billing_setup}" + }; + + // Container of payments account information for this billing. message PaymentsAccountInfo { - // A 16 digit id used to identify the Payments account associated with the + // Output only. A 16 digit id used to identify the payments account associated with the // billing setup. // // This must be passed as a string with dashes, e.g. "1234-5678-9012-3456". - google.protobuf.StringValue payments_account_id = 1; + google.protobuf.StringValue payments_account_id = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The name of the Payments account associated with the billing setup. + // Immutable. The name of the payments account associated with the billing setup. // - // This enables the user to specify a meaningful name for a Payments account + // This enables the user to specify a meaningful name for a payments account // to aid in reconciling monthly invoices. // // This name will be printed in the monthly invoices. - google.protobuf.StringValue payments_account_name = 2; + google.protobuf.StringValue payments_account_name = 2 [(google.api.field_behavior) = IMMUTABLE]; - // A 12 digit id used to identify the Payments profile associated with the + // Immutable. A 12 digit id used to identify the payments profile associated with the // billing setup. // // This must be passed in as a string with dashes, e.g. "1234-5678-9012". - google.protobuf.StringValue payments_profile_id = 3; + google.protobuf.StringValue payments_profile_id = 3 [(google.api.field_behavior) = IMMUTABLE]; - // The name of the Payments profile associated with the billing setup. - google.protobuf.StringValue payments_profile_name = 4; + // Output only. The name of the payments profile associated with the billing setup. + google.protobuf.StringValue payments_profile_name = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // A secondary payments profile id present in uncommon situations, e.g. + // Output only. A secondary payments profile id present in uncommon situations, e.g. // when a sequential liability agreement has been arranged. - google.protobuf.StringValue secondary_payments_profile_id = 5; + google.protobuf.StringValue secondary_payments_profile_id = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; } - // The resource name of the billing setup. + // Immutable. The resource name of the billing setup. // BillingSetup resource names have the form: // // `customers/{customer_id}/billingSetups/{billing_setup_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/BillingSetup" + } + ]; - // The ID of the billing setup. - google.protobuf.Int64Value id = 2; + // Output only. The ID of the billing setup. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The status of the billing setup. - google.ads.googleads.v1.enums.BillingSetupStatusEnum.BillingSetupStatus - status = 3; + // Output only. The status of the billing setup. + google.ads.googleads.v1.enums.BillingSetupStatusEnum.BillingSetupStatus status = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The resource name of the Payments account associated with this billing + // Immutable. The resource name of the payments account associated with this billing // setup. Payments resource names have the form: // // `customers/{customer_id}/paymentsAccounts/{payments_account_id}` - // When setting up billing, this is used to signup with an existing Payments + // When setting up billing, this is used to signup with an existing payments // account (and then payments_account_info should not be set). // When getting a billing setup, this and payments_account_info will be // populated. - google.protobuf.StringValue payments_account = 11; - - // The Payments account information associated with this billing setup. - // When setting up billing, this is used to signup with a new Payments account + google.protobuf.StringValue payments_account = 11 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/PaymentsAccount" + } + ]; + + // Immutable. The payments account information associated with this billing setup. + // When setting up billing, this is used to signup with a new payments account // (and then payments_account should not be set). // When getting a billing setup, this and payments_account will be // populated. - PaymentsAccountInfo payments_account_info = 12; + PaymentsAccountInfo payments_account_info = 12 [(google.api.field_behavior) = IMMUTABLE]; // When creating a new billing setup, this is when the setup should take // effect. NOW is the only acceptable start time if the customer doesn't have @@ -105,21 +119,21 @@ message BillingSetup { // However, if the setup was approved (see status) after the requested start // time, then this is the approval time. oneof start_time { - // The start date time in yyyy-MM-dd or yyyy-MM-dd HH:mm:ss format. Only a + // Immutable. The start date time in yyyy-MM-dd or yyyy-MM-dd HH:mm:ss format. Only a // future time is allowed. - google.protobuf.StringValue start_date_time = 9; + google.protobuf.StringValue start_date_time = 9 [(google.api.field_behavior) = IMMUTABLE]; - // The start time as a type. Only NOW is allowed. - google.ads.googleads.v1.enums.TimeTypeEnum.TimeType start_time_type = 10; + // Immutable. The start time as a type. Only NOW is allowed. + google.ads.googleads.v1.enums.TimeTypeEnum.TimeType start_time_type = 10 [(google.api.field_behavior) = IMMUTABLE]; } // When the billing setup ends / ended. This is either FOREVER or the start // time of the next scheduled billing setup. oneof end_time { - // The end date time in yyyy-MM-dd or yyyy-MM-dd HH:mm:ss format. - google.protobuf.StringValue end_date_time = 13; + // Output only. The end date time in yyyy-MM-dd or yyyy-MM-dd HH:mm:ss format. + google.protobuf.StringValue end_date_time = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The end time as a type. The only possible value is FOREVER. - google.ads.googleads.v1.enums.TimeTypeEnum.TimeType end_time_type = 14; + // Output only. The end time as a type. The only possible value is FOREVER. + google.ads.googleads.v1.enums.TimeTypeEnum.TimeType end_time_type = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; } } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/campaign.proto b/third_party/googleapis/google/ads/googleads/v1/resources/campaign.proto index 4eeb48747..0f3ba2ada 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/campaign.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/campaign.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -37,6 +36,8 @@ import "google/ads/googleads/v1/enums/payment_mode.proto"; import "google/ads/googleads/v1/enums/positive_geo_target_type.proto"; import "google/ads/googleads/v1/enums/vanity_pharma_display_url_mode.proto"; import "google/ads/googleads/v1/enums/vanity_pharma_text.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -53,6 +54,11 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A campaign. message Campaign { + option (google.api.resource) = { + type: "googleads.googleapis.com/Campaign" + pattern: "customers/{customer}/campaigns/{campaign}" + }; + // The network settings for the campaign. message NetworkSettings { // Whether ads will be served with google.com search results. @@ -73,18 +79,21 @@ message Campaign { // Campaign-level settings for hotel ads. message HotelSettingInfo { - // The linked Hotel Center account. - google.protobuf.Int64Value hotel_center_id = 1; + // Immutable. The linked Hotel Center account. + google.protobuf.Int64Value hotel_center_id = 1 [(google.api.field_behavior) = IMMUTABLE]; } - // Describes how unbranded pharma ads will be displayed. - message VanityPharma { - // The display mode for vanity pharma URLs. - google.ads.googleads.v1.enums.VanityPharmaDisplayUrlModeEnum.VanityPharmaDisplayUrlMode vanity_pharma_display_url_mode = 1; + // Campaign-level settings for App Campaigns. + message AppCampaignSetting { + // Represents the goal which the bidding strategy of this app campaign + // should optimize towards. + google.ads.googleads.v1.enums.AppCampaignBiddingStrategyGoalTypeEnum.AppCampaignBiddingStrategyGoalType bidding_strategy_goal_type = 1; - // The text that will be displayed in display URL of the text ad when - // website description is the selected display mode for vanity pharma URLs. - google.ads.googleads.v1.enums.VanityPharmaTextEnum.VanityPharmaText vanity_pharma_text = 2; + // Immutable. A string that uniquely identifies a mobile application. + google.protobuf.StringValue app_id = 2 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. The application store that distributes this specific app. + google.ads.googleads.v1.enums.AppCampaignAppStoreEnum.AppCampaignAppStore app_store = 3 [(google.api.field_behavior) = IMMUTABLE]; } // The setting for controlling Dynamic Search Ads (DSA). @@ -99,24 +108,39 @@ message Campaign { // Whether the campaign uses advertiser supplied URLs exclusively. google.protobuf.BoolValue use_supplied_urls_only = 3; - // The list of page feeds associated with the campaign. - repeated google.protobuf.StringValue feeds = 5; + // Output only. The list of page feeds associated with the campaign. + repeated google.protobuf.StringValue feeds = 5 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; + } + + // Describes how unbranded pharma ads will be displayed. + message VanityPharma { + // The display mode for vanity pharma URLs. + google.ads.googleads.v1.enums.VanityPharmaDisplayUrlModeEnum.VanityPharmaDisplayUrlMode vanity_pharma_display_url_mode = 1; + + // The text that will be displayed in display URL of the text ad when + // website description is the selected display mode for vanity pharma URLs. + google.ads.googleads.v1.enums.VanityPharmaTextEnum.VanityPharmaText vanity_pharma_text = 2; } // The setting for Shopping campaigns. Defines the universe of products that // can be advertised by the campaign, and how this campaign interacts with // other Shopping campaigns. message ShoppingSetting { - // ID of the Merchant Center account. + // Immutable. ID of the Merchant Center account. // This field is required for create operations. This field is immutable for // Shopping campaigns. - google.protobuf.Int64Value merchant_id = 1; + google.protobuf.Int64Value merchant_id = 1 [(google.api.field_behavior) = IMMUTABLE]; - // Sales country of products to include in the campaign. + // Immutable. Sales country of products to include in the campaign. // This field is required for Shopping campaigns. This field is immutable. // This field is optional for non-Shopping campaigns, but it must be equal // to 'ZZ' if set. - google.protobuf.StringValue sales_country = 2; + google.protobuf.StringValue sales_country = 2 [(google.api.field_behavior) = IMMUTABLE]; // Priority of the campaign. Campaigns with numerically higher priorities // take precedence over those with lower priorities. @@ -130,30 +154,10 @@ message Campaign { google.protobuf.BoolValue enable_local = 4; } - // Campaign level settings for tracking information. + // Campaign-level settings for tracking information. message TrackingSetting { - // The url used for dynamic tracking. - google.protobuf.StringValue tracking_url = 1; - } - - // Selective optimization setting for this campaign, which includes a set of - // conversion actions to optimize this campaign towards. - message SelectiveOptimization { - // The selected set of conversion actions for optimizing this campaign. - repeated google.protobuf.StringValue conversion_actions = 1; - } - - // Campaign level settings for App Campaigns. - message AppCampaignSetting { - // Represents the goal which the bidding strategy of this app campaign - // should optimize towards. - google.ads.googleads.v1.enums.AppCampaignBiddingStrategyGoalTypeEnum.AppCampaignBiddingStrategyGoalType bidding_strategy_goal_type = 1; - - // A string that uniquely identifies a mobile application. - google.protobuf.StringValue app_id = 2; - - // The application store that distributes this specific app. - google.ads.googleads.v1.enums.AppCampaignAppStoreEnum.AppCampaignAppStore app_store = 3; + // Output only. The url used for dynamic tracking. + google.protobuf.StringValue tracking_url = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Represents a collection of settings related to ads geotargeting. @@ -165,14 +169,28 @@ message Campaign { google.ads.googleads.v1.enums.NegativeGeoTargetTypeEnum.NegativeGeoTargetType negative_geo_target_type = 2; } - // The resource name of the campaign. + // Selective optimization setting for this campaign, which includes a set of + // conversion actions to optimize this campaign towards. + message SelectiveOptimization { + // The selected set of conversion actions for optimizing this campaign. + repeated google.protobuf.StringValue conversion_actions = 1 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/ConversionAction" + }]; + } + + // Immutable. The resource name of the campaign. // Campaign resource names have the form: // // `customers/{customer_id}/campaigns/{campaign_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; - // The ID of the campaign. - google.protobuf.Int64Value id = 3; + // Output only. The ID of the campaign. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // The name of the campaign. // @@ -188,13 +206,13 @@ message Campaign { // When a new campaign is added, the status defaults to ENABLED. google.ads.googleads.v1.enums.CampaignStatusEnum.CampaignStatus status = 5; - // The ad serving status of the campaign. - google.ads.googleads.v1.enums.CampaignServingStatusEnum.CampaignServingStatus serving_status = 21; + // Output only. The ad serving status of the campaign. + google.ads.googleads.v1.enums.CampaignServingStatusEnum.CampaignServingStatus serving_status = 21 [(google.api.field_behavior) = OUTPUT_ONLY]; // The ad serving optimization status of the campaign. google.ads.googleads.v1.enums.AdServingOptimizationStatusEnum.AdServingOptimizationStatus ad_serving_optimization_status = 8; - // The primary serving target for ads within the campaign. + // Immutable. The primary serving target for ads within the campaign. // The targeting options can be refined in `network_settings`. // // This field is required and should not be empty when creating new @@ -202,14 +220,14 @@ message Campaign { // // Can be set only when creating campaigns. // After the campaign is created, the field can not be changed. - google.ads.googleads.v1.enums.AdvertisingChannelTypeEnum.AdvertisingChannelType advertising_channel_type = 9; + google.ads.googleads.v1.enums.AdvertisingChannelTypeEnum.AdvertisingChannelType advertising_channel_type = 9 [(google.api.field_behavior) = IMMUTABLE]; - // Optional refinement to `advertising_channel_type`. + // Immutable. Optional refinement to `advertising_channel_type`. // Must be a valid sub-type of the parent channel type. // // Can be set only when creating campaigns. // After campaign is created, the field can not be changed. - google.ads.googleads.v1.enums.AdvertisingChannelSubTypeEnum.AdvertisingChannelSubType advertising_channel_sub_type = 10; + google.ads.googleads.v1.enums.AdvertisingChannelSubTypeEnum.AdvertisingChannelSubType advertising_channel_sub_type = 10 [(google.api.field_behavior) = IMMUTABLE]; // The URL template for constructing a tracking URL. google.protobuf.StringValue tracking_url_template = 11; @@ -225,8 +243,8 @@ message Campaign { // The network settings for the campaign. NetworkSettings network_settings = 14; - // The hotel setting for the campaign. - HotelSettingInfo hotel_setting = 32; + // Immutable. The hotel setting for the campaign. + HotelSettingInfo hotel_setting = 32 [(google.api.field_behavior) = IMMUTABLE]; // The setting for controlling Dynamic Search Ads (DSA). DynamicSearchAdsSetting dynamic_search_ads_setting = 33; @@ -243,29 +261,41 @@ message Campaign { // The setting related to App Campaign. AppCampaignSetting app_campaign_setting = 51; - // The resource names of labels attached to this campaign. - repeated google.protobuf.StringValue labels = 53; + // Output only. The resource names of labels attached to this campaign. + repeated google.protobuf.StringValue labels = 53 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignLabel" + } + ]; - // The type of campaign: normal, draft, or experiment. - google.ads.googleads.v1.enums.CampaignExperimentTypeEnum.CampaignExperimentType experiment_type = 17; + // Output only. The type of campaign: normal, draft, or experiment. + google.ads.googleads.v1.enums.CampaignExperimentTypeEnum.CampaignExperimentType experiment_type = 17 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The resource name of the base campaign of a draft or experiment campaign. + // Output only. The resource name of the base campaign of a draft or experiment campaign. // For base campaigns, this is equal to `resource_name`. // // This field is read-only. - google.protobuf.StringValue base_campaign = 28; + google.protobuf.StringValue base_campaign = 28 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; // The budget of the campaign. - google.protobuf.StringValue campaign_budget = 6; + google.protobuf.StringValue campaign_budget = 6 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignBudget" + }]; - // The type of bidding strategy. + // Output only. The type of bidding strategy. // // A bidding strategy can be created by setting either the bidding scheme to // create a standard bidding strategy or the `bidding_strategy` field to // create a portfolio bidding strategy. // // This field is read-only. - google.ads.googleads.v1.enums.BiddingStrategyTypeEnum.BiddingStrategyType bidding_strategy_type = 22; + google.ads.googleads.v1.enums.BiddingStrategyTypeEnum.BiddingStrategyType bidding_strategy_type = 22 [(google.api.field_behavior) = OUTPUT_ONLY]; // The date when campaign started. // @@ -284,8 +314,8 @@ message Campaign { // A list that limits how often each user will see this campaign's ads. repeated google.ads.googleads.v1.common.FrequencyCapEntry frequency_caps = 40; - // 3-Tier Brand Safety setting for the campaign. - google.ads.googleads.v1.enums.BrandSafetySuitabilityEnum.BrandSafetySuitability video_brand_safety_suitability = 42; + // Output only. 3-Tier Brand Safety setting for the campaign. + google.ads.googleads.v1.enums.BrandSafetySuitabilityEnum.BrandSafetySuitability video_brand_safety_suitability = 42 [(google.api.field_behavior) = OUTPUT_ONLY]; // Describes how unbranded pharma ads will be displayed. VanityPharma vanity_pharma = 44; @@ -294,8 +324,8 @@ message Campaign { // conversion actions to optimize this campaign towards. SelectiveOptimization selective_optimization = 45; - // Campaign level settings for tracking information. - TrackingSetting tracking_setting = 46; + // Output only. Campaign-level settings for tracking information. + TrackingSetting tracking_setting = 46 [(google.api.field_behavior) = OUTPUT_ONLY]; // Payment mode for the campaign. google.ads.googleads.v1.enums.PaymentModeEnum.PaymentMode payment_mode = 52; @@ -306,7 +336,9 @@ message Campaign { // standard, that is embedded into the campaign. oneof campaign_bidding_strategy { // Portfolio bidding strategy used by campaign. - google.protobuf.StringValue bidding_strategy = 23; + google.protobuf.StringValue bidding_strategy = 23 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/BiddingStrategy" + }]; // Commission is an automatic bidding strategy in which the advertiser pays // a certain portion of the conversion value. @@ -321,8 +353,8 @@ message Campaign { // impressions. google.ads.googleads.v1.common.ManualCpm manual_cpm = 25; - // A bidding strategy that pays a configurable amount per video view. - google.ads.googleads.v1.common.ManualCpv manual_cpv = 37; + // Output only. A bidding strategy that pays a configurable amount per video view. + google.ads.googleads.v1.common.ManualCpv manual_cpv = 37 [(google.api.field_behavior) = OUTPUT_ONLY]; // Standard Maximize Conversions bidding strategy that automatically // maximizes number of conversions given a daily budget. diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/campaign_audience_view.proto b/third_party/googleapis/google/ads/googleads/v1/resources/campaign_audience_view.proto index 431db796f..ba3cf6d76 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/campaign_audience_view.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/campaign_audience_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; @@ -36,10 +37,19 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // aggregated by campaign and audience criterion. This view only includes // audiences attached at the campaign level. message CampaignAudienceView { - // The resource name of the campaign audience view. + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignAudienceView" + pattern: "customers/{customer}/campaignAudienceViews/{campaign_audience_view}" + }; + + // Output only. The resource name of the campaign audience view. // Campaign audience view resource names have the form: // - // // `customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignAudienceView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/campaign_bid_modifier.proto b/third_party/googleapis/google/ads/googleads/v1/resources/campaign_bid_modifier.proto index 6dfbb9eca..1bbbe87b7 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/campaign_bid_modifier.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/campaign_bid_modifier.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,15 +11,16 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/common/criteria.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -34,26 +35,41 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // Represents a bid-modifiable only criterion at the campaign level. message CampaignBidModifier { - // The resource name of the campaign bid modifier. + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignBidModifier" + pattern: "customers/{customer}/campaignBidModifiers/{campaign_bid_modifier}" + }; + + // Immutable. The resource name of the campaign bid modifier. // Campaign bid modifier resource names have the form: // // `customers/{customer_id}/campaignBidModifiers/{campaign_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignBidModifier" + } + ]; - // The campaign to which this criterion belongs. - google.protobuf.StringValue campaign = 2; + // Output only. The campaign to which this criterion belongs. + google.protobuf.StringValue campaign = 2 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; - // The ID of the criterion to bid modify. + // Output only. The ID of the criterion to bid modify. // // This field is ignored for mutates. - google.protobuf.Int64Value criterion_id = 3; + google.protobuf.Int64Value criterion_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // The modifier for the bid when the criterion matches. google.protobuf.DoubleValue bid_modifier = 4; // The criterion of this campaign bid modifier. oneof criterion { - // Criterion for interaction type. Only supported for search campaigns. - google.ads.googleads.v1.common.InteractionTypeInfo interaction_type = 5; + // Immutable. Criterion for interaction type. Only supported for search campaigns. + google.ads.googleads.v1.common.InteractionTypeInfo interaction_type = 5 [(google.api.field_behavior) = IMMUTABLE]; } } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/campaign_budget.proto b/third_party/googleapis/google/ads/googleads/v1/resources/campaign_budget.proto index 48555f962..df1aaa4a2 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/campaign_budget.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/campaign_budget.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -21,8 +20,10 @@ import "google/ads/googleads/v1/enums/budget_delivery_method.proto"; import "google/ads/googleads/v1/enums/budget_period.proto"; import "google/ads/googleads/v1/enums/budget_status.proto"; import "google/ads/googleads/v1/enums/budget_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -37,19 +38,29 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A campaign budget. message CampaignBudget { - // The resource name of the campaign budget. + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignBudget" + pattern: "customers/{customer}/campaignBudgets/{campaign_budget}" + }; + + // Immutable. The resource name of the campaign budget. // Campaign budget resource names have the form: // // `customers/{customer_id}/campaignBudgets/{budget_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignBudget" + } + ]; - // The ID of the campaign budget. + // Output only. The ID of the campaign budget. // // A campaign budget is created using the CampaignBudgetService create // operation and is assigned a budget ID. A budget ID can be shared across // different campaigns; the system will then allocate the campaign budget // among different campaigns to get optimum results. - google.protobuf.Int64Value id = 3; + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // The name of the campaign budget. // @@ -72,15 +83,14 @@ message CampaignBudget { // currency unit. google.protobuf.Int64Value total_amount_micros = 10; - // The status of this campaign budget. This field is read-only. - google.ads.googleads.v1.enums.BudgetStatusEnum.BudgetStatus status = 6; + // Output only. The status of this campaign budget. This field is read-only. + google.ads.googleads.v1.enums.BudgetStatusEnum.BudgetStatus status = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; // The delivery method that determines the rate at which the campaign budget // is spent. // // Defaults to STANDARD if unspecified in a create operation. - google.ads.googleads.v1.enums.BudgetDeliveryMethodEnum.BudgetDeliveryMethod - delivery_method = 7; + google.ads.googleads.v1.enums.BudgetDeliveryMethodEnum.BudgetDeliveryMethod delivery_method = 7; // Specifies whether the budget is explicitly shared. Defaults to true if // unspecified in a create operation. @@ -99,53 +109,49 @@ message CampaignBudget { // A shared campaign budget can never become non-shared. google.protobuf.BoolValue explicitly_shared = 8; - // The number of campaigns actively using the budget. + // Output only. The number of campaigns actively using the budget. // // This field is read-only. - google.protobuf.Int64Value reference_count = 9; + google.protobuf.Int64Value reference_count = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Indicates whether there is a recommended budget for this campaign budget. + // Output only. Indicates whether there is a recommended budget for this campaign budget. // // This field is read-only. - google.protobuf.BoolValue has_recommended_budget = 11; + google.protobuf.BoolValue has_recommended_budget = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The recommended budget amount. If no recommendation is available, this will + // Output only. The recommended budget amount. If no recommendation is available, this will // be set to the budget amount. // Amount is specified in micros, where one million is equivalent to one // currency unit. // // This field is read-only. - google.protobuf.Int64Value recommended_budget_amount_micros = 12; + google.protobuf.Int64Value recommended_budget_amount_micros = 12 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Period over which to spend the budget. Defaults to DAILY if not specified. - google.ads.googleads.v1.enums.BudgetPeriodEnum.BudgetPeriod period = 13; + // Immutable. Period over which to spend the budget. Defaults to DAILY if not specified. + google.ads.googleads.v1.enums.BudgetPeriodEnum.BudgetPeriod period = 13 [(google.api.field_behavior) = IMMUTABLE]; - // The estimated change in weekly clicks if the recommended budget is applied. + // Output only. The estimated change in weekly clicks if the recommended budget is applied. // // This field is read-only. - google.protobuf.Int64Value recommended_budget_estimated_change_weekly_clicks = - 14; + google.protobuf.Int64Value recommended_budget_estimated_change_weekly_clicks = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The estimated change in weekly cost in micros if the recommended budget is + // Output only. The estimated change in weekly cost in micros if the recommended budget is // applied. One million is equivalent to one currency unit. // // This field is read-only. - google.protobuf.Int64Value - recommended_budget_estimated_change_weekly_cost_micros = 15; + google.protobuf.Int64Value recommended_budget_estimated_change_weekly_cost_micros = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The estimated change in weekly interactions if the recommended budget is + // Output only. The estimated change in weekly interactions if the recommended budget is // applied. // // This field is read-only. - google.protobuf.Int64Value - recommended_budget_estimated_change_weekly_interactions = 16; + google.protobuf.Int64Value recommended_budget_estimated_change_weekly_interactions = 16 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The estimated change in weekly views if the recommended budget is applied. + // Output only. The estimated change in weekly views if the recommended budget is applied. // // This field is read-only. - google.protobuf.Int64Value recommended_budget_estimated_change_weekly_views = - 17; + google.protobuf.Int64Value recommended_budget_estimated_change_weekly_views = 17 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The type of the campaign budget. - google.ads.googleads.v1.enums.BudgetTypeEnum.BudgetType type = 18; + // Immutable. The type of the campaign budget. + google.ads.googleads.v1.enums.BudgetTypeEnum.BudgetType type = 18 [(google.api.field_behavior) = IMMUTABLE]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/campaign_criterion.proto b/third_party/googleapis/google/ads/googleads/v1/resources/campaign_criterion.proto index 8c959400f..4e9230035 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/campaign_criterion.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/campaign_criterion.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,8 +19,10 @@ package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/common/criteria.proto"; import "google/ads/googleads/v1/enums/campaign_criterion_status.proto"; import "google/ads/googleads/v1/enums/criterion_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -36,118 +37,129 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A campaign criterion. message CampaignCriterion { - // The resource name of the campaign criterion. + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignCriterion" + pattern: "customers/{customer}/campaignCriteria/{campaign_criterion}" + }; + + // Immutable. The resource name of the campaign criterion. // Campaign criterion resource names have the form: // // `customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}` - string resource_name = 1; - - // The campaign to which the criterion belongs. - google.protobuf.StringValue campaign = 4; - - // The ID of the criterion. + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignCriterion" + } + ]; + + // Immutable. The campaign to which the criterion belongs. + google.protobuf.StringValue campaign = 4 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; + + // Output only. The ID of the criterion. // // This field is ignored during mutate. - google.protobuf.Int64Value criterion_id = 5; + google.protobuf.Int64Value criterion_id = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; // The modifier for the bids when the criterion matches. The modifier must be // in the range: 0.1 - 10.0. Most targetable criteria types support modifiers. // Use 0 to opt out of a Device type. google.protobuf.FloatValue bid_modifier = 14; - // Whether to target (`false`) or exclude (`true`) the criterion. - google.protobuf.BoolValue negative = 7; + // Immutable. Whether to target (`false`) or exclude (`true`) the criterion. + google.protobuf.BoolValue negative = 7 [(google.api.field_behavior) = IMMUTABLE]; - // The type of the criterion. - google.ads.googleads.v1.enums.CriterionTypeEnum.CriterionType type = 6; + // Output only. The type of the criterion. + google.ads.googleads.v1.enums.CriterionTypeEnum.CriterionType type = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; // The status of the criterion. - google.ads.googleads.v1.enums.CampaignCriterionStatusEnum - .CampaignCriterionStatus status = 35; + google.ads.googleads.v1.enums.CampaignCriterionStatusEnum.CampaignCriterionStatus status = 35; // The campaign criterion. // // Exactly one must be set. oneof criterion { - // Keyword. - google.ads.googleads.v1.common.KeywordInfo keyword = 8; + // Immutable. Keyword. + google.ads.googleads.v1.common.KeywordInfo keyword = 8 [(google.api.field_behavior) = IMMUTABLE]; - // Placement. - google.ads.googleads.v1.common.PlacementInfo placement = 9; + // Immutable. Placement. + google.ads.googleads.v1.common.PlacementInfo placement = 9 [(google.api.field_behavior) = IMMUTABLE]; - // Mobile app category. - google.ads.googleads.v1.common.MobileAppCategoryInfo mobile_app_category = - 10; + // Immutable. Mobile app category. + google.ads.googleads.v1.common.MobileAppCategoryInfo mobile_app_category = 10 [(google.api.field_behavior) = IMMUTABLE]; - // Mobile application. - google.ads.googleads.v1.common.MobileApplicationInfo mobile_application = - 11; + // Immutable. Mobile application. + google.ads.googleads.v1.common.MobileApplicationInfo mobile_application = 11 [(google.api.field_behavior) = IMMUTABLE]; - // Location. - google.ads.googleads.v1.common.LocationInfo location = 12; + // Immutable. Location. + google.ads.googleads.v1.common.LocationInfo location = 12 [(google.api.field_behavior) = IMMUTABLE]; - // Device. - google.ads.googleads.v1.common.DeviceInfo device = 13; + // Immutable. Device. + google.ads.googleads.v1.common.DeviceInfo device = 13 [(google.api.field_behavior) = IMMUTABLE]; - // Ad Schedule. - google.ads.googleads.v1.common.AdScheduleInfo ad_schedule = 15; + // Immutable. Ad Schedule. + google.ads.googleads.v1.common.AdScheduleInfo ad_schedule = 15 [(google.api.field_behavior) = IMMUTABLE]; - // Age range. - google.ads.googleads.v1.common.AgeRangeInfo age_range = 16; + // Immutable. Age range. + google.ads.googleads.v1.common.AgeRangeInfo age_range = 16 [(google.api.field_behavior) = IMMUTABLE]; - // Gender. - google.ads.googleads.v1.common.GenderInfo gender = 17; + // Immutable. Gender. + google.ads.googleads.v1.common.GenderInfo gender = 17 [(google.api.field_behavior) = IMMUTABLE]; - // Income range. - google.ads.googleads.v1.common.IncomeRangeInfo income_range = 18; + // Immutable. Income range. + google.ads.googleads.v1.common.IncomeRangeInfo income_range = 18 [(google.api.field_behavior) = IMMUTABLE]; - // Parental status. - google.ads.googleads.v1.common.ParentalStatusInfo parental_status = 19; + // Immutable. Parental status. + google.ads.googleads.v1.common.ParentalStatusInfo parental_status = 19 [(google.api.field_behavior) = IMMUTABLE]; - // User List. - google.ads.googleads.v1.common.UserListInfo user_list = 22; + // Immutable. User List. + google.ads.googleads.v1.common.UserListInfo user_list = 22 [(google.api.field_behavior) = IMMUTABLE]; - // YouTube Video. - google.ads.googleads.v1.common.YouTubeVideoInfo youtube_video = 20; + // Immutable. YouTube Video. + google.ads.googleads.v1.common.YouTubeVideoInfo youtube_video = 20 [(google.api.field_behavior) = IMMUTABLE]; - // YouTube Channel. - google.ads.googleads.v1.common.YouTubeChannelInfo youtube_channel = 21; + // Immutable. YouTube Channel. + google.ads.googleads.v1.common.YouTubeChannelInfo youtube_channel = 21 [(google.api.field_behavior) = IMMUTABLE]; - // Proximity. - google.ads.googleads.v1.common.ProximityInfo proximity = 23; + // Immutable. Proximity. + google.ads.googleads.v1.common.ProximityInfo proximity = 23 [(google.api.field_behavior) = IMMUTABLE]; - // Topic. - google.ads.googleads.v1.common.TopicInfo topic = 24; + // Immutable. Topic. + google.ads.googleads.v1.common.TopicInfo topic = 24 [(google.api.field_behavior) = IMMUTABLE]; - // Listing scope. - google.ads.googleads.v1.common.ListingScopeInfo listing_scope = 25; + // Immutable. Listing scope. + google.ads.googleads.v1.common.ListingScopeInfo listing_scope = 25 [(google.api.field_behavior) = IMMUTABLE]; - // Language. - google.ads.googleads.v1.common.LanguageInfo language = 26; + // Immutable. Language. + google.ads.googleads.v1.common.LanguageInfo language = 26 [(google.api.field_behavior) = IMMUTABLE]; - // IpBlock. - google.ads.googleads.v1.common.IpBlockInfo ip_block = 27; + // Immutable. IpBlock. + google.ads.googleads.v1.common.IpBlockInfo ip_block = 27 [(google.api.field_behavior) = IMMUTABLE]; - // ContentLabel. - google.ads.googleads.v1.common.ContentLabelInfo content_label = 28; + // Immutable. ContentLabel. + google.ads.googleads.v1.common.ContentLabelInfo content_label = 28 [(google.api.field_behavior) = IMMUTABLE]; - // Carrier. - google.ads.googleads.v1.common.CarrierInfo carrier = 29; + // Immutable. Carrier. + google.ads.googleads.v1.common.CarrierInfo carrier = 29 [(google.api.field_behavior) = IMMUTABLE]; - // User Interest. - google.ads.googleads.v1.common.UserInterestInfo user_interest = 30; + // Immutable. User Interest. + google.ads.googleads.v1.common.UserInterestInfo user_interest = 30 [(google.api.field_behavior) = IMMUTABLE]; - // Webpage. - google.ads.googleads.v1.common.WebpageInfo webpage = 31; + // Immutable. Webpage. + google.ads.googleads.v1.common.WebpageInfo webpage = 31 [(google.api.field_behavior) = IMMUTABLE]; - // Operating system version. - google.ads.googleads.v1.common.OperatingSystemVersionInfo - operating_system_version = 32; + // Immutable. Operating system version. + google.ads.googleads.v1.common.OperatingSystemVersionInfo operating_system_version = 32 [(google.api.field_behavior) = IMMUTABLE]; - // Mobile Device. - google.ads.googleads.v1.common.MobileDeviceInfo mobile_device = 33; + // Immutable. Mobile Device. + google.ads.googleads.v1.common.MobileDeviceInfo mobile_device = 33 [(google.api.field_behavior) = IMMUTABLE]; - // Location Group - google.ads.googleads.v1.common.LocationGroupInfo location_group = 34; + // Immutable. Location Group + google.ads.googleads.v1.common.LocationGroupInfo location_group = 34 [(google.api.field_behavior) = IMMUTABLE]; } } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/campaign_criterion_simulation.proto b/third_party/googleapis/google/ads/googleads/v1/resources/campaign_criterion_simulation.proto index d85140b0f..451fcf83c 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/campaign_criterion_simulation.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/campaign_criterion_simulation.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,8 +19,10 @@ package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/common/simulation.proto"; import "google/ads/googleads/v1/enums/simulation_modification_method.proto"; import "google/ads/googleads/v1/enums/simulation_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -38,39 +39,47 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // channel type, criterion ids, simulation type and simulation modification // method is detailed below respectively. // -// SEARCH 30000,30001,30002 BID_MODIFIER UNIFORM -// DISPLAY 30001 BID_MODIFIER UNIFORM +// 1. SEARCH - 30000,30001,30002 - BID_MODIFIER - UNIFORM +// 2. SHOPPING - 30000,30001,30002 - BID_MODIFIER - UNIFORM +// 3. DISPLAY - 30001 - BID_MODIFIER - UNIFORM message CampaignCriterionSimulation { - // The resource name of the campaign criterion simulation. + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignCriterionSimulation" + pattern: "customers/{customer}/campaignCriterionSimulations/{campaign_criterion_simulation}" + }; + + // Output only. The resource name of the campaign criterion simulation. // Campaign criterion simulation resource names have the form: // - // // `customers/{customer_id}/campaignCriterionSimulations/{campaign_id}~{criterion_id}~{type}~{modification_method}~{start_date}~{end_date}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignCriterionSimulation" + } + ]; - // Campaign ID of the simulation. - google.protobuf.Int64Value campaign_id = 2; + // Output only. Campaign ID of the simulation. + google.protobuf.Int64Value campaign_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Criterion ID of the simulation. - google.protobuf.Int64Value criterion_id = 3; + // Output only. Criterion ID of the simulation. + google.protobuf.Int64Value criterion_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The field that the simulation modifies. - google.ads.googleads.v1.enums.SimulationTypeEnum.SimulationType type = 4; + // Output only. The field that the simulation modifies. + google.ads.googleads.v1.enums.SimulationTypeEnum.SimulationType type = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // How the simulation modifies the field. - google.ads.googleads.v1.enums.SimulationModificationMethodEnum - .SimulationModificationMethod modification_method = 5; + // Output only. How the simulation modifies the field. + google.ads.googleads.v1.enums.SimulationModificationMethodEnum.SimulationModificationMethod modification_method = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // First day on which the simulation is based, in YYYY-MM-DD format. - google.protobuf.StringValue start_date = 6; + // Output only. First day on which the simulation is based, in YYYY-MM-DD format. + google.protobuf.StringValue start_date = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Last day on which the simulation is based, in YYYY-MM-DD format. - google.protobuf.StringValue end_date = 7; + // Output only. Last day on which the simulation is based, in YYYY-MM-DD format. + google.protobuf.StringValue end_date = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; // List of simulation points. oneof point_list { - // Simulation points if the simulation type is BID_MODIFIER. - google.ads.googleads.v1.common.BidModifierSimulationPointList - bid_modifier_point_list = 8; + // Output only. Simulation points if the simulation type is BID_MODIFIER. + google.ads.googleads.v1.common.BidModifierSimulationPointList bid_modifier_point_list = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; } } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/campaign_draft.proto b/third_party/googleapis/google/ads/googleads/v1/resources/campaign_draft.proto index 3ad444338..f09c2e9ba 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/campaign_draft.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/campaign_draft.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/campaign_draft_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -34,19 +35,34 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A campaign draft. message CampaignDraft { - // The resource name of the campaign draft. + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignDraft" + pattern: "customers/{customer}/campaignDrafts/{campaign_draft}" + }; + + // Immutable. The resource name of the campaign draft. // Campaign draft resource names have the form: // // `customers/{customer_id}/campaignDrafts/{base_campaign_id}~{draft_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignDraft" + } + ]; - // The ID of the draft. + // Output only. The ID of the draft. // // This field is read-only. - google.protobuf.Int64Value draft_id = 2; + google.protobuf.Int64Value draft_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The base campaign to which the draft belongs. - google.protobuf.StringValue base_campaign = 3; + // Immutable. The base campaign to which the draft belongs. + google.protobuf.StringValue base_campaign = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; // The name of the campaign draft. // @@ -57,22 +73,27 @@ message CampaignDraft { // (code point 0xA) or carriage return (code point 0xD) characters. google.protobuf.StringValue name = 4; - // Resource name of the Campaign that results from overlaying the draft + // Output only. Resource name of the Campaign that results from overlaying the draft // changes onto the base campaign. // // This field is read-only. - google.protobuf.StringValue draft_campaign = 5; + google.protobuf.StringValue draft_campaign = 5 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; - // The status of the campaign draft. This field is read-only. + // Output only. The status of the campaign draft. This field is read-only. // // When a new campaign draft is added, the status defaults to PROPOSED. - google.ads.googleads.v1.enums.CampaignDraftStatusEnum.CampaignDraftStatus status = 6; + google.ads.googleads.v1.enums.CampaignDraftStatusEnum.CampaignDraftStatus status = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Whether there is an experiment based on this draft currently serving. - google.protobuf.BoolValue has_experiment_running = 7; + // Output only. Whether there is an experiment based on this draft currently serving. + google.protobuf.BoolValue has_experiment_running = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The resource name of the long-running operation that can be used to poll + // Output only. The resource name of the long-running operation that can be used to poll // for completion of draft promotion. This is only set if the draft promotion // is in progress or finished. - google.protobuf.StringValue long_running_operation = 8; + google.protobuf.StringValue long_running_operation = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/campaign_experiment.proto b/third_party/googleapis/google/ads/googleads/v1/resources/campaign_experiment.proto index 336999b31..6b62d7631 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/campaign_experiment.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/campaign_experiment.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,8 @@ package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/campaign_experiment_status.proto"; import "google/ads/googleads/v1/enums/campaign_experiment_traffic_split_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -36,19 +37,34 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // An A/B experiment that compares the performance of the base campaign // (the control) and a variation of that campaign (the experiment). message CampaignExperiment { - // The resource name of the campaign experiment. + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignExperiment" + pattern: "customers/{customer}/campaignExperiments/{campaign_experiment}" + }; + + // Immutable. The resource name of the campaign experiment. // Campaign experiment resource names have the form: // // `customers/{customer_id}/campaignExperiments/{campaign_experiment_id}` - string resource_name = 1; - - // The ID of the campaign experiment. + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignExperiment" + } + ]; + + // Output only. The ID of the campaign experiment. // // This field is read-only. - google.protobuf.Int64Value id = 2; + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The campaign draft with staged changes to the base campaign. - google.protobuf.StringValue campaign_draft = 3; + // Immutable. The campaign draft with staged changes to the base campaign. + google.protobuf.StringValue campaign_draft = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignDraft" + } + ]; // The name of the campaign experiment. // @@ -63,24 +79,29 @@ message CampaignExperiment { // The description of the experiment. google.protobuf.StringValue description = 5; - // Share of traffic directed to experiment as a percent (must be between 1 and + // Immutable. Share of traffic directed to experiment as a percent (must be between 1 and // 99 inclusive. Base campaign receives the remainder of the traffic // (100 - traffic_split_percent). Required for create. - google.protobuf.Int64Value traffic_split_percent = 6; + google.protobuf.Int64Value traffic_split_percent = 6 [(google.api.field_behavior) = IMMUTABLE]; - // Determines the behavior of the traffic split. - google.ads.googleads.v1.enums.CampaignExperimentTrafficSplitTypeEnum.CampaignExperimentTrafficSplitType traffic_split_type = 7; + // Immutable. Determines the behavior of the traffic split. + google.ads.googleads.v1.enums.CampaignExperimentTrafficSplitTypeEnum.CampaignExperimentTrafficSplitType traffic_split_type = 7 [(google.api.field_behavior) = IMMUTABLE]; - // The experiment campaign, as opposed to the base campaign. - google.protobuf.StringValue experiment_campaign = 8; + // Output only. The experiment campaign, as opposed to the base campaign. + google.protobuf.StringValue experiment_campaign = 8 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; - // The status of the campaign experiment. This field is read-only. - google.ads.googleads.v1.enums.CampaignExperimentStatusEnum.CampaignExperimentStatus status = 9; + // Output only. The status of the campaign experiment. This field is read-only. + google.ads.googleads.v1.enums.CampaignExperimentStatusEnum.CampaignExperimentStatus status = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The resource name of the long-running operation that can be used to poll + // Output only. The resource name of the long-running operation that can be used to poll // for completion of experiment create or promote. The most recent long // running operation is returned. - google.protobuf.StringValue long_running_operation = 10; + google.protobuf.StringValue long_running_operation = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; // Date when the campaign experiment starts. By default, the experiment starts // now or on the campaign's start date, whichever is later. If this field is diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/campaign_extension_setting.proto b/third_party/googleapis/google/ads/googleads/v1/resources/campaign_extension_setting.proto index e225959cf..d8abea21d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/campaign_extension_setting.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/campaign_extension_setting.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/extension_setting_device.proto"; import "google/ads/googleads/v1/enums/extension_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -35,31 +36,45 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A campaign extension setting. message CampaignExtensionSetting { - // The resource name of the campaign extension setting. + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignExtensionSetting" + pattern: "customers/{customer}/campaignExtensionSettings/{campaign_extension_setting}" + }; + + // Immutable. The resource name of the campaign extension setting. // CampaignExtensionSetting resource names have the form: // - // // `customers/{customer_id}/campaignExtensionSettings/{campaign_id}~{extension_type}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignExtensionSetting" + } + ]; - // The extension type of the customer extension setting. - google.ads.googleads.v1.enums.ExtensionTypeEnum.ExtensionType extension_type = - 2; + // Immutable. The extension type of the customer extension setting. + google.ads.googleads.v1.enums.ExtensionTypeEnum.ExtensionType extension_type = 2 [(google.api.field_behavior) = IMMUTABLE]; - // The resource name of the campaign. The linked extension feed items will + // Immutable. The resource name of the campaign. The linked extension feed items will // serve under this campaign. // Campaign resource names have the form: // // `customers/{customer_id}/campaigns/{campaign_id}` - google.protobuf.StringValue campaign = 3; + google.protobuf.StringValue campaign = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; // The resource names of the extension feed items to serve under the campaign. // ExtensionFeedItem resource names have the form: // // `customers/{customer_id}/extensionFeedItems/{feed_item_id}` - repeated google.protobuf.StringValue extension_feed_items = 4; + repeated google.protobuf.StringValue extension_feed_items = 4 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/ExtensionFeedItem" + }]; // The device for which the extensions will serve. Optional. - google.ads.googleads.v1.enums.ExtensionSettingDeviceEnum - .ExtensionSettingDevice device = 5; + google.ads.googleads.v1.enums.ExtensionSettingDeviceEnum.ExtensionSettingDevice device = 5; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/campaign_feed.proto b/third_party/googleapis/google/ads/googleads/v1/resources/campaign_feed.proto index 234beb3ff..b33eb9d59 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/campaign_feed.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/campaign_feed.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,8 +19,10 @@ package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/common/matching_function.proto"; import "google/ads/googleads/v1/enums/feed_link_status.proto"; import "google/ads/googleads/v1/enums/placeholder_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -36,29 +37,48 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A campaign feed. message CampaignFeed { - // The resource name of the campaign feed. + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignFeed" + pattern: "customers/{customer}/campaignFeeds/{campaign_feed}" + }; + + // Immutable. The resource name of the campaign feed. // Campaign feed resource names have the form: // // `customers/{customer_id}/campaignFeeds/{campaign_id}~{feed_id} - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignFeed" + } + ]; - // The feed to which the CampaignFeed belongs. - google.protobuf.StringValue feed = 2; + // Immutable. The feed to which the CampaignFeed belongs. + google.protobuf.StringValue feed = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; - // The campaign to which the CampaignFeed belongs. - google.protobuf.StringValue campaign = 3; + // Immutable. The campaign to which the CampaignFeed belongs. + google.protobuf.StringValue campaign = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; // Indicates which placeholder types the feed may populate under the connected // campaign. Required. - repeated google.ads.googleads.v1.enums.PlaceholderTypeEnum.PlaceholderType - placeholder_types = 4; + repeated google.ads.googleads.v1.enums.PlaceholderTypeEnum.PlaceholderType placeholder_types = 4; // Matching function associated with the CampaignFeed. // The matching function is used to filter the set of feed items selected. // Required. google.ads.googleads.v1.common.MatchingFunction matching_function = 5; - // Status of the campaign feed. + // Output only. Status of the campaign feed. // This field is read-only. - google.ads.googleads.v1.enums.FeedLinkStatusEnum.FeedLinkStatus status = 6; + google.ads.googleads.v1.enums.FeedLinkStatusEnum.FeedLinkStatus status = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/campaign_label.proto b/third_party/googleapis/google/ads/googleads/v1/resources/campaign_label.proto index 00aa7dba2..8d189691c 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/campaign_label.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/campaign_label.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,15 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -33,14 +34,34 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // Represents a relationship between a campaign and a label. message CampaignLabel { - // Name of the resource. + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignLabel" + pattern: "customers/{customer}/campaignLabels/{campaign_label}" + }; + + // Immutable. Name of the resource. // Campaign label resource names have the form: // `customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignLabel" + } + ]; - // The campaign to which the label is attached. - google.protobuf.StringValue campaign = 2; + // Immutable. The campaign to which the label is attached. + google.protobuf.StringValue campaign = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; - // The label assigned to the campaign. - google.protobuf.StringValue label = 3; + // Immutable. The label assigned to the campaign. + google.protobuf.StringValue label = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Label" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/campaign_shared_set.proto b/third_party/googleapis/google/ads/googleads/v1/resources/campaign_shared_set.proto index 80b829912..a7961a451 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/campaign_shared_set.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/campaign_shared_set.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,15 +11,16 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/campaign_shared_set_status.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -35,24 +36,43 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // CampaignSharedSets are used for managing the shared sets associated with a // campaign. message CampaignSharedSet { - // The resource name of the campaign shared set. + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignSharedSet" + pattern: "customers/{customer}/campaignSharedSets/{campaign_shared_set}" + }; + + // Immutable. The resource name of the campaign shared set. // Campaign shared set resource names have the form: // // `customers/{customer_id}/campaignSharedSets/{campaign_id}~{shared_set_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignSharedSet" + } + ]; - // The campaign to which the campaign shared set belongs. - google.protobuf.StringValue campaign = 3; + // Immutable. The campaign to which the campaign shared set belongs. + google.protobuf.StringValue campaign = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; - // The shared set associated with the campaign. This may be a negative keyword + // Immutable. The shared set associated with the campaign. This may be a negative keyword // shared set of another customer. This customer should be a manager of the // other customer, otherwise the campaign shared set will exist but have no // serving effect. Only negative keyword shared sets can be associated with // Shopping campaigns. Only negative placement shared sets can be associated // with Display mobile app campaigns. - google.protobuf.StringValue shared_set = 4; + google.protobuf.StringValue shared_set = 4 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/SharedSet" + } + ]; - // The status of this campaign shared set. Read only. - google.ads.googleads.v1.enums.CampaignSharedSetStatusEnum - .CampaignSharedSetStatus status = 2; + // Output only. The status of this campaign shared set. Read only. + google.ads.googleads.v1.enums.CampaignSharedSetStatusEnum.CampaignSharedSetStatus status = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/carrier_constant.proto b/third_party/googleapis/google/ads/googleads/v1/resources/carrier_constant.proto index 944a60bb3..93f1d087d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/carrier_constant.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/carrier_constant.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,15 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -33,19 +34,29 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A carrier criterion that can be used in campaign targeting. message CarrierConstant { - // The resource name of the carrier criterion. + option (google.api.resource) = { + type: "googleads.googleapis.com/CarrierConstant" + pattern: "carrierConstants/{carrier_constant}" + }; + + // Output only. The resource name of the carrier criterion. // Carrier criterion resource names have the form: // // `carrierConstants/{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CarrierConstant" + } + ]; - // The ID of the carrier criterion. - google.protobuf.Int64Value id = 2; + // Output only. The ID of the carrier criterion. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The full name of the carrier in English. - google.protobuf.StringValue name = 3; + // Output only. The full name of the carrier in English. + google.protobuf.StringValue name = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The country code of the country where the carrier is located, e.g., "AR", + // Output only. The country code of the country where the carrier is located, e.g., "AR", // "FR", etc. - google.protobuf.StringValue country_code = 4; + google.protobuf.StringValue country_code = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/change_status.proto b/third_party/googleapis/google/ads/googleads/v1/resources/change_status.proto index 22b759d1c..0c9ac1305 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/change_status.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/change_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/change_status_operation.proto"; import "google/ads/googleads/v1/enums/change_status_resource_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -35,52 +36,110 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // Describes the status of returned resource. message ChangeStatus { - // The resource name of the change status. + option (google.api.resource) = { + type: "googleads.googleapis.com/ChangeStatus" + pattern: "customers/{customer}/changeStatus/{change_status}" + }; + + // Output only. The resource name of the change status. // Change status resource names have the form: // // `customers/{customer_id}/changeStatus/{change_status_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ChangeStatus" + } + ]; - // Time at which the most recent change has occurred on this resource. - google.protobuf.StringValue last_change_date_time = 3; + // Output only. Time at which the most recent change has occurred on this resource. + google.protobuf.StringValue last_change_date_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Represents the type of the changed resource. This dictates what fields + // Output only. Represents the type of the changed resource. This dictates what fields // will be set. For example, for AD_GROUP, campaign and ad_group fields will // be set. - google.ads.googleads.v1.enums.ChangeStatusResourceTypeEnum - .ChangeStatusResourceType resource_type = 4; - - // The Campaign affected by this change. - google.protobuf.StringValue campaign = 5; - - // The AdGroup affected by this change. - google.protobuf.StringValue ad_group = 6; - - // Represents the status of the changed resource. - google.ads.googleads.v1.enums.ChangeStatusOperationEnum.ChangeStatusOperation - resource_status = 8; - - // The AdGroupAd affected by this change. - google.protobuf.StringValue ad_group_ad = 9; - - // The AdGroupCriterion affected by this change. - google.protobuf.StringValue ad_group_criterion = 10; - - // The CampaignCriterion affected by this change. - google.protobuf.StringValue campaign_criterion = 11; - - // The Feed affected by this change. - google.protobuf.StringValue feed = 12; - - // The FeedItem affected by this change. - google.protobuf.StringValue feed_item = 13; - - // The AdGroupFeed affected by this change. - google.protobuf.StringValue ad_group_feed = 14; - - // The CampaignFeed affected by this change. - google.protobuf.StringValue campaign_feed = 15; - - // The AdGroupBidModifier affected by this change. - google.protobuf.StringValue ad_group_bid_modifier = 16; + google.ads.googleads.v1.enums.ChangeStatusResourceTypeEnum.ChangeStatusResourceType resource_type = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The Campaign affected by this change. + google.protobuf.StringValue campaign = 5 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; + + // Output only. The AdGroup affected by this change. + google.protobuf.StringValue ad_group = 6 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; + + // Output only. Represents the status of the changed resource. + google.ads.googleads.v1.enums.ChangeStatusOperationEnum.ChangeStatusOperation resource_status = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The AdGroupAd affected by this change. + google.protobuf.StringValue ad_group_ad = 9 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAd" + } + ]; + + // Output only. The AdGroupCriterion affected by this change. + google.protobuf.StringValue ad_group_criterion = 10 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterion" + } + ]; + + // Output only. The CampaignCriterion affected by this change. + google.protobuf.StringValue campaign_criterion = 11 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignCriterion" + } + ]; + + // Output only. The Feed affected by this change. + google.protobuf.StringValue feed = 12 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; + + // Output only. The FeedItem affected by this change. + google.protobuf.StringValue feed_item = 13 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedItem" + } + ]; + + // Output only. The AdGroupFeed affected by this change. + google.protobuf.StringValue ad_group_feed = 14 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupFeed" + } + ]; + + // Output only. The CampaignFeed affected by this change. + google.protobuf.StringValue campaign_feed = 15 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignFeed" + } + ]; + + // Output only. The AdGroupBidModifier affected by this change. + google.protobuf.StringValue ad_group_bid_modifier = 16 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupBidModifier" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/click_view.proto b/third_party/googleapis/google/ads/googleads/v1/resources/click_view.proto index f7e5912bb..693108552 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/click_view.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/click_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,15 +11,16 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/common/click_location.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -35,24 +36,37 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A click view with metrics aggregated at each click level, including both // valid and invalid clicks. For non-Search campaigns, metrics.clicks // represents the number of valid and invalid interactions. +// Queries including ClickView must have a filter limiting the results to one +// day and can be requested for dates back to 90 days before the time of the +// request. message ClickView { - // The resource name of the click view. + option (google.api.resource) = { + type: "googleads.googleapis.com/ClickView" + pattern: "customers/{customer}/clickViews/{click_view}" + }; + + // Output only. The resource name of the click view. // Click view resource names have the form: // // `customers/{customer_id}/clickViews/{date (yyyy-MM-dd)}~{gclid}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ClickView" + } + ]; - // The Google Click ID. - google.protobuf.StringValue gclid = 2; + // Output only. The Google Click ID. + google.protobuf.StringValue gclid = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The location criteria matching the area of interest associated with the + // Output only. The location criteria matching the area of interest associated with the // impression. - google.ads.googleads.v1.common.ClickLocation area_of_interest = 3; + google.ads.googleads.v1.common.ClickLocation area_of_interest = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The location criteria matching the location of presence associated with the + // Output only. The location criteria matching the location of presence associated with the // impression. - google.ads.googleads.v1.common.ClickLocation location_of_presence = 4; + google.ads.googleads.v1.common.ClickLocation location_of_presence = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Page number in search results where the ad was shown. - google.protobuf.Int64Value page_number = 5; + // Output only. Page number in search results where the ad was shown. + google.protobuf.Int64Value page_number = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/conversion_action.proto b/third_party/googleapis/google/ads/googleads/v1/resources/conversion_action.proto index 0918eefb0..e780394d1 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/conversion_action.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/conversion_action.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -24,8 +23,10 @@ import "google/ads/googleads/v1/enums/conversion_action_counting_type.proto"; import "google/ads/googleads/v1/enums/conversion_action_status.proto"; import "google/ads/googleads/v1/enums/conversion_action_type.proto"; import "google/ads/googleads/v1/enums/data_driven_model_status.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -40,16 +41,19 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A conversion action. message ConversionAction { + option (google.api.resource) = { + type: "googleads.googleapis.com/ConversionAction" + pattern: "customers/{customer}/conversionActions/{conversion_action}" + }; + // Settings related to this conversion action's attribution model. message AttributionModelSettings { // The attribution model type of this conversion action. - google.ads.googleads.v1.enums.AttributionModelEnum.AttributionModel - attribution_model = 1; + google.ads.googleads.v1.enums.AttributionModelEnum.AttributionModel attribution_model = 1; - // The status of the data-driven attribution model for the conversion + // Output only. The status of the data-driven attribution model for the conversion // action. - google.ads.googleads.v1.enums.DataDrivenModelStatusEnum - .DataDrivenModelStatus data_driven_model_status = 2; + google.ads.googleads.v1.enums.DataDrivenModelStatusEnum.DataDrivenModelStatus data_driven_model_status = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Settings related to the value for conversion events associated with this @@ -71,14 +75,19 @@ message ConversionAction { google.protobuf.BoolValue always_use_default_value = 3; } - // The resource name of the conversion action. + // Immutable. The resource name of the conversion action. // Conversion action resource names have the form: // // `customers/{customer_id}/conversionActions/{conversion_action_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ConversionAction" + } + ]; - // The ID of the conversion action. - google.protobuf.Int64Value id = 2; + // Output only. The ID of the conversion action. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; // The name of the conversion action. // @@ -87,20 +96,17 @@ message ConversionAction { google.protobuf.StringValue name = 3; // The status of this conversion action for conversion event accrual. - google.ads.googleads.v1.enums.ConversionActionStatusEnum - .ConversionActionStatus status = 4; + google.ads.googleads.v1.enums.ConversionActionStatusEnum.ConversionActionStatus status = 4; - // The type of this conversion action. - google.ads.googleads.v1.enums.ConversionActionTypeEnum.ConversionActionType - type = 5; + // Immutable. The type of this conversion action. + google.ads.googleads.v1.enums.ConversionActionTypeEnum.ConversionActionType type = 5 [(google.api.field_behavior) = IMMUTABLE]; // The category of conversions reported for this conversion action. - google.ads.googleads.v1.enums.ConversionActionCategoryEnum - .ConversionActionCategory category = 6; + google.ads.googleads.v1.enums.ConversionActionCategoryEnum.ConversionActionCategory category = 6; - // The resource name of the conversion action owner customer, or null if this + // Output only. The resource name of the conversion action owner customer, or null if this // is a system-defined conversion action. - google.protobuf.StringValue owner_customer = 7; + google.protobuf.StringValue owner_customer = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; // Whether this conversion action should be included in the "conversions" // metric. @@ -119,14 +125,13 @@ message ConversionAction { ValueSettings value_settings = 11; // How to count conversion events for the conversion action. - google.ads.googleads.v1.enums.ConversionActionCountingTypeEnum - .ConversionActionCountingType counting_type = 12; + google.ads.googleads.v1.enums.ConversionActionCountingTypeEnum.ConversionActionCountingType counting_type = 12; // Settings related to this conversion action's attribution model. AttributionModelSettings attribution_model_settings = 13; - // The snippets used for tracking conversions. - repeated google.ads.googleads.v1.common.TagSnippet tag_snippets = 14; + // Output only. The snippets used for tracking conversions. + repeated google.ads.googleads.v1.common.TagSnippet tag_snippets = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; // The phone call duration in seconds after which a conversion should be // reported for this conversion action. diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/custom_interest.proto b/third_party/googleapis/google/ads/googleads/v1/resources/custom_interest.proto index 933513df4..d0c9488a4 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/custom_interest.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/custom_interest.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,8 +19,10 @@ package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/custom_interest_member_type.proto"; import "google/ads/googleads/v1/enums/custom_interest_status.proto"; import "google/ads/googleads/v1/enums/custom_interest_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -36,19 +37,28 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A custom interest. This is a list of users by interest. message CustomInterest { - // The resource name of the custom interest. + option (google.api.resource) = { + type: "googleads.googleapis.com/CustomInterest" + pattern: "customers/{customer}/customInterests/{custom_interest}" + }; + + // Immutable. The resource name of the custom interest. // Custom interest resource names have the form: // // `customers/{customer_id}/customInterests/{custom_interest_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomInterest" + } + ]; - // Id of the custom interest. - google.protobuf.Int64Value id = 2; + // Output only. Id of the custom interest. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; // Status of this custom interest. Indicates whether the custom interest is // enabled or removed. - google.ads.googleads.v1.enums.CustomInterestStatusEnum.CustomInterestStatus - status = 3; + google.ads.googleads.v1.enums.CustomInterestStatusEnum.CustomInterestStatus status = 3; // Name of the custom interest. It should be unique across the same custom // affinity audience. @@ -57,8 +67,7 @@ message CustomInterest { // Type of the custom interest, CUSTOM_AFFINITY or CUSTOM_INTENT. // By default the type is set to CUSTOM_AFFINITY. - google.ads.googleads.v1.enums.CustomInterestTypeEnum.CustomInterestType type = - 5; + google.ads.googleads.v1.enums.CustomInterestTypeEnum.CustomInterestType type = 5; // Description of this custom interest audience. google.protobuf.StringValue description = 6; @@ -73,8 +82,7 @@ message CustomInterest { // It is immutable, that is, it can only be created or removed but not changed. message CustomInterestMember { // The type of custom interest member, KEYWORD or URL. - google.ads.googleads.v1.enums.CustomInterestMemberTypeEnum - .CustomInterestMemberType member_type = 1; + google.ads.googleads.v1.enums.CustomInterestMemberTypeEnum.CustomInterestMemberType member_type = 1; // Keyword text when member_type is KEYWORD or URL string when // member_type is URL. diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/customer.proto b/third_party/googleapis/google/ads/googleads/v1/resources/customer.proto index e03a0d9f9..daf474365 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/customer.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/customer.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,15 +11,16 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/customer_pay_per_conversion_eligibility_failure_reason.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -34,25 +35,35 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A customer. message Customer { - // The resource name of the customer. + option (google.api.resource) = { + type: "googleads.googleapis.com/Customer" + pattern: "customers/{customer}" + }; + + // Immutable. The resource name of the customer. // Customer resource names have the form: // // `customers/{customer_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Customer" + } + ]; - // The ID of the customer. - google.protobuf.Int64Value id = 3; + // Output only. The ID of the customer. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // Optional, non-unique descriptive name of the customer. google.protobuf.StringValue descriptive_name = 4; - // The currency in which the account operates. + // Immutable. The currency in which the account operates. // A subset of the currency codes from the ISO 4217 standard is // supported. - google.protobuf.StringValue currency_code = 5; + google.protobuf.StringValue currency_code = 5 [(google.api.field_behavior) = IMMUTABLE]; - // The local timezone ID of the customer. - google.protobuf.StringValue time_zone = 6; + // Immutable. The local timezone ID of the customer. + google.protobuf.StringValue time_zone = 6 [(google.api.field_behavior) = IMMUTABLE]; // The URL template for constructing a tracking URL out of parameters. google.protobuf.StringValue tracking_url_template = 7; @@ -63,32 +74,29 @@ message Customer { // Whether auto-tagging is enabled for the customer. google.protobuf.BoolValue auto_tagging_enabled = 8; - // Whether the Customer has a Partners program badge. If the Customer is not + // Output only. Whether the Customer has a Partners program badge. If the Customer is not // associated with the Partners program, this will be false. For more // information, see https://support.google.com/partners/answer/3125774. - google.protobuf.BoolValue has_partners_badge = 9; + google.protobuf.BoolValue has_partners_badge = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Whether the customer is a manager. - google.protobuf.BoolValue manager = 12; + // Output only. Whether the customer is a manager. + google.protobuf.BoolValue manager = 12 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Whether the customer is a test account. - google.protobuf.BoolValue test_account = 13; + // Output only. Whether the customer is a test account. + google.protobuf.BoolValue test_account = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; // Call reporting setting for a customer. CallReportingSetting call_reporting_setting = 10; - // Conversion tracking setting for a customer. - ConversionTrackingSetting conversion_tracking_setting = 14; + // Output only. Conversion tracking setting for a customer. + ConversionTrackingSetting conversion_tracking_setting = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Remarketing setting for a customer. - RemarketingSetting remarketing_setting = 15; + // Output only. Remarketing setting for a customer. + RemarketingSetting remarketing_setting = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Reasons why the customer is not eligible to use PaymentMode.CONVERSIONS. If + // Output only. Reasons why the customer is not eligible to use PaymentMode.CONVERSIONS. If // the list is empty, the customer is eligible. This field is read-only. - repeated google.ads.googleads.v1.enums - .CustomerPayPerConversionEligibilityFailureReasonEnum - .CustomerPayPerConversionEligibilityFailureReason - pay_per_conversion_eligibility_failure_reasons = 16; + repeated google.ads.googleads.v1.enums.CustomerPayPerConversionEligibilityFailureReasonEnum.CustomerPayPerConversionEligibilityFailureReason pay_per_conversion_eligibility_failure_reasons = 16 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Call reporting setting for a customer. @@ -103,26 +111,28 @@ message CallReportingSetting { // Customer-level call conversion action to attribute a call conversion to. // If not set a default conversion action is used. Only in effect when // call_conversion_reporting_enabled is set to true. - google.protobuf.StringValue call_conversion_action = 9; + google.protobuf.StringValue call_conversion_action = 9 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/ConversionAction" + }]; } // A collection of customer-wide settings related to Google Ads Conversion // Tracking. message ConversionTrackingSetting { - // The conversion tracking id used for this account. This id is automatically + // Output only. The conversion tracking id used for this account. This id is automatically // assigned after any conversion tracking feature is used. If the customer // doesn't use conversion tracking, this is 0. This field is read-only. - google.protobuf.Int64Value conversion_tracking_id = 1; + google.protobuf.Int64Value conversion_tracking_id = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The conversion tracking id of the customer's manager. This is set when the + // Output only. The conversion tracking id of the customer's manager. This is set when the // customer is opted into cross account conversion tracking, and it overrides // conversion_tracking_id. This field can only be managed through the Google // Ads UI. This field is read-only. - google.protobuf.Int64Value cross_account_conversion_tracking_id = 2; + google.protobuf.Int64Value cross_account_conversion_tracking_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Remarketing setting for a customer. message RemarketingSetting { - // The Google global site tag. - google.protobuf.StringValue google_global_site_tag = 1; + // Output only. The Google global site tag. + google.protobuf.StringValue google_global_site_tag = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/customer_client.proto b/third_party/googleapis/google/ads/googleads/v1/resources/customer_client.proto index fd47f7848..1c4a4645b 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/customer_client.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/customer_client.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,15 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -35,22 +36,31 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // exist for manager customers. All direct and indirect client customers are // included, as well as the manager itself. message CustomerClient { - // The resource name of the customer client. + option (google.api.resource) = { + type: "googleads.googleapis.com/CustomerClient" + pattern: "customers/{customer}/customerClients/{customer_client}" + }; + + // Output only. The resource name of the customer client. // CustomerClient resource names have the form: // `customers/{customer_id}/customerClients/{client_customer_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerClient" + } + ]; - // The resource name of the client-customer which is linked to + // Output only. The resource name of the client-customer which is linked to // the given customer. Read only. - google.protobuf.StringValue client_customer = 3; + google.protobuf.StringValue client_customer = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Specifies whether this is a hidden account. Learn more about hidden - // accounts here. Read - // only. - google.protobuf.BoolValue hidden = 4; + // Output only. Specifies whether this is a + // [hidden account](https://support.google.com/google-ads/answer/7519830). + // Read only. + google.protobuf.BoolValue hidden = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Distance between given customer and client. For self link, the level value + // Output only. Distance between given customer and client. For self link, the level value // will be 0. Read only. - google.protobuf.Int64Value level = 5; + google.protobuf.Int64Value level = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/customer_client_link.proto b/third_party/googleapis/google/ads/googleads/v1/resources/customer_client_link.proto index e6c188a07..4b0e266de 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/customer_client_link.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/customer_client_link.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,15 +11,16 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/manager_link_status.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -34,21 +35,29 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // Represents customer client link relationship. message CustomerClientLink { - // Name of the resource. + option (google.api.resource) = { + type: "googleads.googleapis.com/CustomerClientLink" + pattern: "customers/{customer}/customerClientLinks/{customer_client_link}" + }; + + // Immutable. Name of the resource. // CustomerClientLink resource names have the form: - // // `customers/{customer_id}/customerClientLinks/{client_customer_id}~{manager_link_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerClientLink" + } + ]; - // The client customer linked to this customer. - google.protobuf.StringValue client_customer = 3; + // Immutable. The client customer linked to this customer. + google.protobuf.StringValue client_customer = 3 [(google.api.field_behavior) = IMMUTABLE]; - // This is uniquely identifies a customer client link. Read only. - google.protobuf.Int64Value manager_link_id = 4; + // Output only. This is uniquely identifies a customer client link. Read only. + google.protobuf.Int64Value manager_link_id = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; // This is the status of the link between client and manager. - google.ads.googleads.v1.enums.ManagerLinkStatusEnum.ManagerLinkStatus status = - 5; + google.ads.googleads.v1.enums.ManagerLinkStatusEnum.ManagerLinkStatus status = 5; // The visibility of the link. Users can choose whether or not to see hidden // links in the AdWords UI. diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/customer_extension_setting.proto b/third_party/googleapis/google/ads/googleads/v1/resources/customer_extension_setting.proto index 4ef620bc1..6de1674c1 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/customer_extension_setting.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/customer_extension_setting.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/extension_setting_device.proto"; import "google/ads/googleads/v1/enums/extension_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -35,23 +36,33 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A customer extension setting. message CustomerExtensionSetting { - // The resource name of the customer extension setting. + option (google.api.resource) = { + type: "googleads.googleapis.com/CustomerExtensionSetting" + pattern: "customers/{customer}/customerExtensionSettings/{customer_extension_setting}" + }; + + // Immutable. The resource name of the customer extension setting. // CustomerExtensionSetting resource names have the form: // // `customers/{customer_id}/customerExtensionSettings/{extension_type}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerExtensionSetting" + } + ]; - // The extension type of the customer extension setting. - google.ads.googleads.v1.enums.ExtensionTypeEnum.ExtensionType extension_type = - 2; + // Immutable. The extension type of the customer extension setting. + google.ads.googleads.v1.enums.ExtensionTypeEnum.ExtensionType extension_type = 2 [(google.api.field_behavior) = IMMUTABLE]; // The resource names of the extension feed items to serve under the customer. // ExtensionFeedItem resource names have the form: // // `customers/{customer_id}/extensionFeedItems/{feed_item_id}` - repeated google.protobuf.StringValue extension_feed_items = 3; + repeated google.protobuf.StringValue extension_feed_items = 3 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/ExtensionFeedItem" + }]; // The device for which the extensions will serve. Optional. - google.ads.googleads.v1.enums.ExtensionSettingDeviceEnum - .ExtensionSettingDevice device = 4; + google.ads.googleads.v1.enums.ExtensionSettingDeviceEnum.ExtensionSettingDevice device = 4; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/customer_feed.proto b/third_party/googleapis/google/ads/googleads/v1/resources/customer_feed.proto index a81cfa479..dd7ceaf02 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/customer_feed.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/customer_feed.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,8 +19,10 @@ package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/common/matching_function.proto"; import "google/ads/googleads/v1/enums/feed_link_status.proto"; import "google/ads/googleads/v1/enums/placeholder_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -36,26 +37,40 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A customer feed. message CustomerFeed { - // The resource name of the customer feed. + option (google.api.resource) = { + type: "googleads.googleapis.com/CustomerFeed" + pattern: "customers/{customer}/customerFeeds/{customer_feed}" + }; + + // Immutable. The resource name of the customer feed. // Customer feed resource names have the form: // // `customers/{customer_id}/customerFeeds/{feed_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerFeed" + } + ]; - // The feed being linked to the customer. - google.protobuf.StringValue feed = 2; + // Immutable. The feed being linked to the customer. + google.protobuf.StringValue feed = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; // Indicates which placeholder types the feed may populate under the connected // customer. Required. - repeated google.ads.googleads.v1.enums.PlaceholderTypeEnum.PlaceholderType - placeholder_types = 3; + repeated google.ads.googleads.v1.enums.PlaceholderTypeEnum.PlaceholderType placeholder_types = 3; // Matching function associated with the CustomerFeed. // The matching function is used to filter the set of feed items selected. // Required. google.ads.googleads.v1.common.MatchingFunction matching_function = 4; - // Status of the customer feed. + // Output only. Status of the customer feed. // This field is read-only. - google.ads.googleads.v1.enums.FeedLinkStatusEnum.FeedLinkStatus status = 5; + google.ads.googleads.v1.enums.FeedLinkStatusEnum.FeedLinkStatus status = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/customer_label.proto b/third_party/googleapis/google/ads/googleads/v1/resources/customer_label.proto index 28c994e1c..f9a9e243f 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/customer_label.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/customer_label.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,15 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -35,18 +36,28 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // not have access to all the labels attached to it. Additional CustomerLabels // may be returned by increasing permissions with login-customer-id. message CustomerLabel { - // Name of the resource. + option (google.api.resource) = { + type: "googleads.googleapis.com/CustomerLabel" + pattern: "customers/{customer}/customerLabels/{customer_label}" + }; + + // Immutable. Name of the resource. // Customer label resource names have the form: // `customers/{customer_id}/customerLabels/{label_id}` - string resource_name = 1; - - // The resource name of the customer to which the label is attached. + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerLabel" + } + ]; + + // Output only. The resource name of the customer to which the label is attached. // Read only. - google.protobuf.StringValue customer = 2; + google.protobuf.StringValue customer = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The resource name of the label assigned to the customer. + // Output only. The resource name of the label assigned to the customer. // // Note: the Customer ID portion of the label resource name is not // validated when creating a new CustomerLabel. - google.protobuf.StringValue label = 3; + google.protobuf.StringValue label = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/customer_manager_link.proto b/third_party/googleapis/google/ads/googleads/v1/resources/customer_manager_link.proto index d6f406c78..e2f82d673 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/customer_manager_link.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/customer_manager_link.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,15 +11,16 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/manager_link_status.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -34,19 +35,27 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // Represents customer-manager link relationship. message CustomerManagerLink { - // Name of the resource. + option (google.api.resource) = { + type: "googleads.googleapis.com/CustomerManagerLink" + pattern: "customers/{customer}/customerManagerLinks/{customer_manager_link}" + }; + + // Immutable. Name of the resource. // CustomerManagerLink resource names have the form: - // // `customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerManagerLink" + } + ]; - // The manager customer linked to the customer. - google.protobuf.StringValue manager_customer = 3; + // Output only. The manager customer linked to the customer. + google.protobuf.StringValue manager_customer = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // ID of the customer-manager link. This field is read only. - google.protobuf.Int64Value manager_link_id = 4; + // Output only. ID of the customer-manager link. This field is read only. + google.protobuf.Int64Value manager_link_id = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; // Status of the link between the customer and the manager. - google.ads.googleads.v1.enums.ManagerLinkStatusEnum.ManagerLinkStatus status = - 5; + google.ads.googleads.v1.enums.ManagerLinkStatusEnum.ManagerLinkStatus status = 5; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/customer_negative_criterion.proto b/third_party/googleapis/google/ads/googleads/v1/resources/customer_negative_criterion.proto index 20af93ed1..a033ffacd 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/customer_negative_criterion.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/customer_negative_criterion.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/common/criteria.proto"; import "google/ads/googleads/v1/enums/criterion_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -35,39 +36,48 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A negative criterion for exclusions at the customer level. message CustomerNegativeCriterion { - // The resource name of the customer negative criterion. + option (google.api.resource) = { + type: "googleads.googleapis.com/CustomerNegativeCriterion" + pattern: "customers/{customer}/customerNegativeCriteria/{customer_negative_criterion}" + }; + + // Immutable. The resource name of the customer negative criterion. // Customer negative criterion resource names have the form: // // `customers/{customer_id}/customerNegativeCriteria/{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerNegativeCriterion" + } + ]; - // The ID of the criterion. - google.protobuf.Int64Value id = 2; + // Output only. The ID of the criterion. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The type of the criterion. - google.ads.googleads.v1.enums.CriterionTypeEnum.CriterionType type = 3; + // Output only. The type of the criterion. + google.ads.googleads.v1.enums.CriterionTypeEnum.CriterionType type = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // The customer negative criterion. // // Exactly one must be set. oneof criterion { - // ContentLabel. - google.ads.googleads.v1.common.ContentLabelInfo content_label = 4; + // Immutable. ContentLabel. + google.ads.googleads.v1.common.ContentLabelInfo content_label = 4 [(google.api.field_behavior) = IMMUTABLE]; - // MobileApplication. - google.ads.googleads.v1.common.MobileApplicationInfo mobile_application = 5; + // Immutable. MobileApplication. + google.ads.googleads.v1.common.MobileApplicationInfo mobile_application = 5 [(google.api.field_behavior) = IMMUTABLE]; - // MobileAppCategory. - google.ads.googleads.v1.common.MobileAppCategoryInfo mobile_app_category = - 6; + // Immutable. MobileAppCategory. + google.ads.googleads.v1.common.MobileAppCategoryInfo mobile_app_category = 6 [(google.api.field_behavior) = IMMUTABLE]; - // Placement. - google.ads.googleads.v1.common.PlacementInfo placement = 7; + // Immutable. Placement. + google.ads.googleads.v1.common.PlacementInfo placement = 7 [(google.api.field_behavior) = IMMUTABLE]; - // YouTube Video. - google.ads.googleads.v1.common.YouTubeVideoInfo youtube_video = 8; + // Immutable. YouTube Video. + google.ads.googleads.v1.common.YouTubeVideoInfo youtube_video = 8 [(google.api.field_behavior) = IMMUTABLE]; - // YouTube Channel. - google.ads.googleads.v1.common.YouTubeChannelInfo youtube_channel = 9; + // Immutable. YouTube Channel. + google.ads.googleads.v1.common.YouTubeChannelInfo youtube_channel = 9 [(google.api.field_behavior) = IMMUTABLE]; } } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/detail_placement_view.proto b/third_party/googleapis/google/ads/googleads/v1/resources/detail_placement_view.proto index 1007504c3..93337976f 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/detail_placement_view.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/detail_placement_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,15 +11,16 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/placement_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -34,30 +35,38 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A view with metrics aggregated by ad group and URL or YouTube video. message DetailPlacementView { - // The resource name of the detail placement view. + option (google.api.resource) = { + type: "googleads.googleapis.com/DetailPlacementView" + pattern: "customers/{customer}/detailPlacementViews/{detail_placement_view}" + }; + + // Output only. The resource name of the detail placement view. // Detail placement view resource names have the form: // - // // `customers/{customer_id}/detailPlacementViews/{ad_group_id}~{base64_placement}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DetailPlacementView" + } + ]; - // The automatic placement string at detail level, e. g. website URL, mobile + // Output only. The automatic placement string at detail level, e. g. website URL, mobile // application ID, or a YouTube video ID. - google.protobuf.StringValue placement = 2; + google.protobuf.StringValue placement = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The display name is URL name for websites, YouTube video name for YouTube + // Output only. The display name is URL name for websites, YouTube video name for YouTube // videos, and translated mobile app name for mobile apps. - google.protobuf.StringValue display_name = 3; + google.protobuf.StringValue display_name = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // URL of the group placement, e.g. domain, link to the mobile application in + // Output only. URL of the group placement, e.g. domain, link to the mobile application in // app store, or a YouTube channel URL. - google.protobuf.StringValue group_placement_target_url = 4; + google.protobuf.StringValue group_placement_target_url = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // URL of the placement, e.g. website, link to the mobile application in app + // Output only. URL of the placement, e.g. website, link to the mobile application in app // store, or a YouTube video URL. - google.protobuf.StringValue target_url = 5; + google.protobuf.StringValue target_url = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Type of the placement, e.g. Website, YouTube Video, and Mobile Application. - google.ads.googleads.v1.enums.PlacementTypeEnum.PlacementType placement_type = - 6; + // Output only. Type of the placement, e.g. Website, YouTube Video, and Mobile Application. + google.ads.googleads.v1.enums.PlacementTypeEnum.PlacementType placement_type = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/display_keyword_view.proto b/third_party/googleapis/google/ads/googleads/v1/resources/display_keyword_view.proto index 98c6c6f57..d65b7a55c 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/display_keyword_view.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/display_keyword_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; @@ -32,9 +33,19 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A display keyword view. message DisplayKeywordView { - // The resource name of the display keyword view. + option (google.api.resource) = { + type: "googleads.googleapis.com/DisplayKeywordView" + pattern: "customers/{customer}/displayKeywordViews/{display_keyword_view}" + }; + + // Output only. The resource name of the display keyword view. // Display Keyword view resource names have the form: // // `customers/{customer_id}/displayKeywordViews/{ad_group_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DisplayKeywordView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/domain_category.proto b/third_party/googleapis/google/ads/googleads/v1/resources/domain_category.proto index 0cd40addc..1abb8f65d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/domain_category.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/domain_category.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,15 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -36,41 +37,55 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // the domain. The categories can be targeted using WebpageConditionInfo. // See: https://support.google.com/google-ads/answer/2471185 message DomainCategory { - // The resource name of the domain category. + option (google.api.resource) = { + type: "googleads.googleapis.com/DomainCategory" + pattern: "customers/{customer}/domainCategories/{domain_category}" + }; + + // Output only. The resource name of the domain category. // Domain category resource names have the form: // - // // `customers/{customer_id}/domainCategories/{campaign_id}~{category_base64}~{language_code}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DomainCategory" + } + ]; - // The campaign this category is recommended for. - google.protobuf.StringValue campaign = 2; + // Output only. The campaign this category is recommended for. + google.protobuf.StringValue campaign = 2 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; - // Recommended category for the website domain. e.g. if you have a website + // Output only. Recommended category for the website domain. e.g. if you have a website // about electronics, the categories could be "cameras", "televisions", etc. - google.protobuf.StringValue category = 3; + google.protobuf.StringValue category = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The language code specifying the language of the website. e.g. "en" for + // Output only. The language code specifying the language of the website. e.g. "en" for // English. The language can be specified in the DynamicSearchAdsSetting // required for dynamic search ads. This is the language of the pages from // your website that you want Google Ads to find, create ads for, // and match searches with. - google.protobuf.StringValue language_code = 4; + google.protobuf.StringValue language_code = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The domain for the website. The domain can be specified in the + // Output only. The domain for the website. The domain can be specified in the // DynamicSearchAdsSetting required for dynamic search ads. - google.protobuf.StringValue domain = 5; + google.protobuf.StringValue domain = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Fraction of pages on your site that this category matches. - google.protobuf.DoubleValue coverage_fraction = 6; + // Output only. Fraction of pages on your site that this category matches. + google.protobuf.DoubleValue coverage_fraction = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The position of this category in the set of categories. Lower numbers + // Output only. The position of this category in the set of categories. Lower numbers // indicate a better match for the domain. null indicates not recommended. - google.protobuf.Int64Value category_rank = 7; + google.protobuf.Int64Value category_rank = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Indicates whether this category has sub-categories. - google.protobuf.BoolValue has_children = 8; + // Output only. Indicates whether this category has sub-categories. + google.protobuf.BoolValue has_children = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The recommended cost per click for the category. - google.protobuf.Int64Value recommended_cpc_bid_micros = 9; + // Output only. The recommended cost per click for the category. + google.protobuf.Int64Value recommended_cpc_bid_micros = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/dynamic_search_ads_search_term_view.proto b/third_party/googleapis/google/ads/googleads/v1/resources/dynamic_search_ads_search_term_view.proto index 3332eb188..7e041685d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/dynamic_search_ads_search_term_view.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/dynamic_search_ads_search_term_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,15 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -33,30 +34,39 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A dynamic search ads search term view. message DynamicSearchAdsSearchTermView { - // The resource name of the dynamic search ads search term view. + option (google.api.resource) = { + type: "googleads.googleapis.com/DynamicSearchAdsSearchTermView" + pattern: "customers/{customer}/dynamicSearchAdsSearchTermViews/{dynamic_search_ads_search_term_view}" + }; + + // Output only. The resource name of the dynamic search ads search term view. // Dynamic search ads search term view resource names have the form: // - // // `customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fp}~{headline_fp}~{landing_page_fp}~{page_url_fp}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DynamicSearchAdsSearchTermView" + } + ]; - // Search term + // Output only. Search term // // This field is read-only. - google.protobuf.StringValue search_term = 2; + google.protobuf.StringValue search_term = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The dynamically generated headline of the Dynamic Search Ad. + // Output only. The dynamically generated headline of the Dynamic Search Ad. // // This field is read-only. - google.protobuf.StringValue headline = 3; + google.protobuf.StringValue headline = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The dynamically selected landing page URL of the impression. + // Output only. The dynamically selected landing page URL of the impression. // // This field is read-only. - google.protobuf.StringValue landing_page = 4; + google.protobuf.StringValue landing_page = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The URL of page feed item served for the impression. + // Output only. The URL of page feed item served for the impression. // // This field is read-only. - google.protobuf.StringValue page_url = 5; + google.protobuf.StringValue page_url = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/expanded_landing_page_view.proto b/third_party/googleapis/google/ads/googleads/v1/resources/expanded_landing_page_view.proto index 72115b4f8..a272c724a 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/expanded_landing_page_view.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/expanded_landing_page_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,15 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -34,13 +35,22 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A landing page view with metrics aggregated at the expanded final URL // level. message ExpandedLandingPageView { - // The resource name of the expanded landing page view. + option (google.api.resource) = { + type: "googleads.googleapis.com/ExpandedLandingPageView" + pattern: "customers/{customer}/expandedLandingPageViews/{expanded_landing_page_view}" + }; + + // Output only. The resource name of the expanded landing page view. // Expanded landing page view resource names have the form: // - // // `customers/{customer_id}/expandedLandingPageViews/{expanded_final_url_fingerprint}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ExpandedLandingPageView" + } + ]; - // The final URL that clicks are directed to. - google.protobuf.StringValue expanded_final_url = 2; + // Output only. The final URL that clicks are directed to. + google.protobuf.StringValue expanded_final_url = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/extension_feed_item.proto b/third_party/googleapis/google/ads/googleads/v1/resources/extension_feed_item.proto index 6dd6e2dca..92f705f64 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/extension_feed_item.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/extension_feed_item.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -22,8 +21,10 @@ import "google/ads/googleads/v1/common/extensions.proto"; import "google/ads/googleads/v1/enums/extension_type.proto"; import "google/ads/googleads/v1/enums/feed_item_status.proto"; import "google/ads/googleads/v1/enums/feed_item_target_device.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -38,24 +39,34 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // An extension feed item. message ExtensionFeedItem { - // The resource name of the extension feed item. + option (google.api.resource) = { + type: "googleads.googleapis.com/ExtensionFeedItem" + pattern: "customers/{customer}/extensionFeedItems/{extension_feed_item}" + }; + + // Immutable. The resource name of the extension feed item. // Extension feed item resource names have the form: // // `customers/{customer_id}/extensionFeedItems/{feed_item_id}` - string resource_name = 1; - - // The extension type of the extension feed item. + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ExtensionFeedItem" + } + ]; + + // Output only. The extension type of the extension feed item. // This field is read-only. - google.ads.googleads.v1.enums.ExtensionTypeEnum.ExtensionType extension_type = - 13; + google.ads.googleads.v1.enums.ExtensionTypeEnum.ExtensionType extension_type = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Start time in which this feed item is effective and can begin serving. + // Start time in which this feed item is effective and can begin serving. The + // time is in the customer's time zone. // The format is "YYYY-MM-DD HH:MM:SS". // Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30" google.protobuf.StringValue start_date_time = 5; // End time in which this feed item is no longer effective and will stop - // serving. + // serving. The time is in the customer's time zone. // The format is "YYYY-MM-DD HH:MM:SS". // Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30" google.protobuf.StringValue end_date_time = 6; @@ -66,15 +77,16 @@ message ExtensionFeedItem { repeated google.ads.googleads.v1.common.AdScheduleInfo ad_schedules = 16; // The targeted device. - google.ads.googleads.v1.enums.FeedItemTargetDeviceEnum.FeedItemTargetDevice - device = 17; + google.ads.googleads.v1.enums.FeedItemTargetDeviceEnum.FeedItemTargetDevice device = 17; // The targeted geo target constant. - google.protobuf.StringValue targeted_geo_target_constant = 20; + google.protobuf.StringValue targeted_geo_target_constant = 20 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/GeoTargetConstant" + }]; - // Status of the feed item. + // Output only. Status of the feed item. // This field is read-only. - google.ads.googleads.v1.enums.FeedItemStatusEnum.FeedItemStatus status = 4; + google.ads.googleads.v1.enums.FeedItemStatusEnum.FeedItemStatus status = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; // Extension type. oneof extension { @@ -82,8 +94,7 @@ message ExtensionFeedItem { google.ads.googleads.v1.common.SitelinkFeedItem sitelink_feed_item = 2; // Structured snippet extension. - google.ads.googleads.v1.common.StructuredSnippetFeedItem - structured_snippet_feed_item = 3; + google.ads.googleads.v1.common.StructuredSnippetFeedItem structured_snippet_feed_item = 3; // App extension. google.ads.googleads.v1.common.AppFeedItem app_feed_item = 7; @@ -95,8 +106,7 @@ message ExtensionFeedItem { google.ads.googleads.v1.common.CalloutFeedItem callout_feed_item = 9; // Text message extension. - google.ads.googleads.v1.common.TextMessageFeedItem text_message_feed_item = - 10; + google.ads.googleads.v1.common.TextMessageFeedItem text_message_feed_item = 10; // Price extension. google.ads.googleads.v1.common.PriceFeedItem price_feed_item = 11; @@ -104,24 +114,27 @@ message ExtensionFeedItem { // Promotion extension. google.ads.googleads.v1.common.PromotionFeedItem promotion_feed_item = 12; - // Location extension. Locations are synced from a GMB account into a feed. + // Output only. Location extension. Locations are synced from a GMB account into a feed. // This field is read-only. - google.ads.googleads.v1.common.LocationFeedItem location_feed_item = 14; + google.ads.googleads.v1.common.LocationFeedItem location_feed_item = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Affiliate location extension. Feed locations are populated by Google Ads + // Output only. Affiliate location extension. Feed locations are populated by Google Ads // based on a chain ID. // This field is read-only. - google.ads.googleads.v1.common.AffiliateLocationFeedItem - affiliate_location_feed_item = 15; + google.ads.googleads.v1.common.AffiliateLocationFeedItem affiliate_location_feed_item = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Targeting at either the campaign or ad group level. Feed items that target // a campaign or ad group will only serve with that resource. oneof serving_resource_targeting { // The targeted campaign. - google.protobuf.StringValue targeted_campaign = 18; + google.protobuf.StringValue targeted_campaign = 18 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + }]; // The targeted ad group. - google.protobuf.StringValue targeted_ad_group = 19; + google.protobuf.StringValue targeted_ad_group = 19 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + }]; } } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/feed.proto b/third_party/googleapis/google/ads/googleads/v1/resources/feed.proto index 2df4a00d5..e88f1e9d3 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/feed.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/feed.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -21,8 +20,10 @@ import "google/ads/googleads/v1/enums/affiliate_location_feed_relationship_type. import "google/ads/googleads/v1/enums/feed_attribute_type.proto"; import "google/ads/googleads/v1/enums/feed_origin.proto"; import "google/ads/googleads/v1/enums/feed_status.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -37,6 +38,11 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A feed. message Feed { + option (google.api.resource) = { + type: "googleads.googleapis.com/Feed" + pattern: "customers/{customer}/feeds/{feed}" + }; + // Data used to configure a location feed populated from Google My Business // Locations. message PlacesLocationFeedData { @@ -52,10 +58,10 @@ message Feed { google.protobuf.StringValue http_authorization_header = 3; } - // Required authentication token (from OAuth API) for the email. + // Immutable. Required authentication token (from OAuth API) for the email. // This field can only be specified in a create request. All its subfields // are not selectable. - OAuthInfo oauth_info = 1; + OAuthInfo oauth_info = 1 [(google.api.field_behavior) = IMMUTABLE]; // Email address of a Google My Business account or email address of a // manager of the Google My Business account. Required. @@ -93,24 +99,30 @@ message Feed { repeated google.protobuf.Int64Value chain_ids = 1; // The relationship the chains have with the advertiser. - google.ads.googleads.v1.enums.AffiliateLocationFeedRelationshipTypeEnum - .AffiliateLocationFeedRelationshipType relationship_type = 2; + google.ads.googleads.v1.enums.AffiliateLocationFeedRelationshipTypeEnum.AffiliateLocationFeedRelationshipType relationship_type = 2; } - // The resource name of the feed. + // Immutable. The resource name of the feed. // Feed resource names have the form: // // `customers/{customer_id}/feeds/{feed_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; - // The ID of the feed. + // Output only. The ID of the feed. // This field is read-only. - google.protobuf.Int64Value id = 2; + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Name of the feed. Required. - google.protobuf.StringValue name = 3; + // Immutable. Name of the feed. Required. + google.protobuf.StringValue name = 3 [(google.api.field_behavior) = IMMUTABLE]; - // The Feed's attributes. Required on CREATE. + // The Feed's attributes. Required on CREATE, unless + // system_feed_generation_data is provided, in which case Google Ads will + // update the feed with the correct attributes. // Disallowed on UPDATE. Use attribute_operations to add new attributes. repeated FeedAttribute attributes = 4; @@ -118,12 +130,12 @@ message Feed { // be added, not removed. repeated FeedAttributeOperation attribute_operations = 9; - // Specifies who manages the FeedAttributes for the Feed. - google.ads.googleads.v1.enums.FeedOriginEnum.FeedOrigin origin = 5; + // Immutable. Specifies who manages the FeedAttributes for the Feed. + google.ads.googleads.v1.enums.FeedOriginEnum.FeedOrigin origin = 5 [(google.api.field_behavior) = IMMUTABLE]; - // Status of the feed. + // Output only. Status of the feed. // This field is read-only. - google.ads.googleads.v1.enums.FeedStatusEnum.FeedStatus status = 8; + google.ads.googleads.v1.enums.FeedStatusEnum.FeedStatus status = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; // The system data for the Feed. This data specifies information for // generating the feed items of the system generated feed. @@ -150,8 +162,7 @@ message FeedAttribute { google.protobuf.StringValue name = 2; // Data type for feed attribute. Required. - google.ads.googleads.v1.enums.FeedAttributeTypeEnum.FeedAttributeType type = - 3; + google.ads.googleads.v1.enums.FeedAttributeTypeEnum.FeedAttributeType type = 3; // Indicates that data corresponding to this attribute is part of a // FeedItem's unique key. It defaults to false if it is unspecified. Note @@ -174,9 +185,9 @@ message FeedAttributeOperation { ADD = 2; } - // Type of list operation to perform. - Operator operator = 1; + // Output only. Type of list operation to perform. + Operator operator = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The feed attribute being added to the list. - FeedAttribute value = 2; + // Output only. The feed attribute being added to the list. + FeedAttribute value = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/feed_item.proto b/third_party/googleapis/google/ads/googleads/v1/resources/feed_item.proto index d0885daca..9d6be40a7 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/feed_item.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/feed_item.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -28,8 +27,10 @@ import "google/ads/googleads/v1/enums/geo_targeting_restriction.proto"; import "google/ads/googleads/v1/enums/policy_approval_status.proto"; import "google/ads/googleads/v1/enums/policy_review_status.proto"; import "google/ads/googleads/v1/errors/feed_item_validation_error.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -44,25 +45,41 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A feed item. message FeedItem { - // The resource name of the feed item. + option (google.api.resource) = { + type: "googleads.googleapis.com/FeedItem" + pattern: "customers/{customer}/feedItems/{feed_item}" + }; + + // Immutable. The resource name of the feed item. // Feed item resource names have the form: // // `customers/{customer_id}/feedItems/{feed_id}~{feed_item_id}` - string resource_name = 1; - - // The feed to which this feed item belongs. - google.protobuf.StringValue feed = 2; - - // The ID of this feed item. - google.protobuf.Int64Value id = 3; - - // Start time in which this feed item is effective and can begin serving. + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedItem" + } + ]; + + // Immutable. The feed to which this feed item belongs. + google.protobuf.StringValue feed = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; + + // Output only. The ID of this feed item. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Start time in which this feed item is effective and can begin serving. The + // time is in the customer's time zone. // The format is "YYYY-MM-DD HH:MM:SS". // Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30" google.protobuf.StringValue start_date_time = 4; // End time in which this feed item is no longer effective and will stop - // serving. + // serving. The time is in the customer's time zone. // The format is "YYYY-MM-DD HH:MM:SS". // Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30" google.protobuf.StringValue end_date_time = 5; @@ -72,25 +89,23 @@ message FeedItem { // Geo targeting restriction specifies the type of location that can be used // for targeting. - google.ads.googleads.v1.enums.GeoTargetingRestrictionEnum - .GeoTargetingRestriction geo_targeting_restriction = 7; + google.ads.googleads.v1.enums.GeoTargetingRestrictionEnum.GeoTargetingRestriction geo_targeting_restriction = 7; // The list of mappings used to substitute custom parameter tags in a // `tracking_url_template`, `final_urls`, or `mobile_final_urls`. - repeated google.ads.googleads.v1.common.CustomParameter - url_custom_parameters = 8; + repeated google.ads.googleads.v1.common.CustomParameter url_custom_parameters = 8; - // Status of the feed item. + // Output only. Status of the feed item. // This field is read-only. - google.ads.googleads.v1.enums.FeedItemStatusEnum.FeedItemStatus status = 9; + google.ads.googleads.v1.enums.FeedItemStatusEnum.FeedItemStatus status = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; - // List of info about a feed item's validation and approval state for active + // Output only. List of info about a feed item's validation and approval state for active // feed mappings. There will be an entry in the list for each type of feed // mapping associated with the feed, e.g. a feed with a sitelink and a call // feed mapping would cause every feed item associated with that feed to have // an entry in this list for both sitelink and call. // This field is read-only. - repeated FeedItemPlaceholderPolicyInfo policy_infos = 10; + repeated FeedItemPlaceholderPolicyInfo policy_infos = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; } // A feed item attribute value. @@ -109,8 +124,8 @@ message FeedItemAttributeValue { // String value. Should be set if feed_attribute_id refers to a feed attribute // of type STRING, URL or DATE_TIME. // For STRING the maximum length is 1500 characters. For URL the maximum - // length is 2076 characters. For DATE_TIME the format of the string must - // be the same as start and end time for the feed item. + // length is 2076 characters. For DATE_TIME the string must be in the format + // "YYYYMMDD HHMMSS". google.protobuf.StringValue string_value = 4; // Double value. Should be set if feed_attribute_id refers to a feed attribute @@ -148,59 +163,52 @@ message FeedItemAttributeValue { // Policy, validation, and quality approval info for a feed item for the // specified placeholder type. message FeedItemPlaceholderPolicyInfo { - // The placeholder type. - google.protobuf.Int32Value placeholder_type = 1; + // Output only. The placeholder type. + google.protobuf.Int32Value placeholder_type = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The FeedMapping that contains the placeholder type. - google.protobuf.StringValue feed_mapping_resource_name = 2; + // Output only. The FeedMapping that contains the placeholder type. + google.protobuf.StringValue feed_mapping_resource_name = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Where the placeholder type is in the review process. - google.ads.googleads.v1.enums.PolicyReviewStatusEnum.PolicyReviewStatus - review_status = 3; + // Output only. Where the placeholder type is in the review process. + google.ads.googleads.v1.enums.PolicyReviewStatusEnum.PolicyReviewStatus review_status = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The overall approval status of the placeholder type, calculated based on + // Output only. The overall approval status of the placeholder type, calculated based on // the status of its individual policy topic entries. - google.ads.googleads.v1.enums.PolicyApprovalStatusEnum.PolicyApprovalStatus - approval_status = 4; + google.ads.googleads.v1.enums.PolicyApprovalStatusEnum.PolicyApprovalStatus approval_status = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The list of policy findings for the placeholder type. - repeated google.ads.googleads.v1.common.PolicyTopicEntry - policy_topic_entries = 5; + // Output only. The list of policy findings for the placeholder type. + repeated google.ads.googleads.v1.common.PolicyTopicEntry policy_topic_entries = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The validation status of the palceholder type. - google.ads.googleads.v1.enums.FeedItemValidationStatusEnum - .FeedItemValidationStatus validation_status = 6; + // Output only. The validation status of the palceholder type. + google.ads.googleads.v1.enums.FeedItemValidationStatusEnum.FeedItemValidationStatus validation_status = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // List of placeholder type validation errors. - repeated FeedItemValidationError validation_errors = 7; + // Output only. List of placeholder type validation errors. + repeated FeedItemValidationError validation_errors = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Placeholder type quality evaluation approval status. - google.ads.googleads.v1.enums.FeedItemQualityApprovalStatusEnum - .FeedItemQualityApprovalStatus quality_approval_status = 8; + // Output only. Placeholder type quality evaluation approval status. + google.ads.googleads.v1.enums.FeedItemQualityApprovalStatusEnum.FeedItemQualityApprovalStatus quality_approval_status = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; - // List of placeholder type quality evaluation disapproval reasons. - repeated google.ads.googleads.v1.enums.FeedItemQualityDisapprovalReasonEnum - .FeedItemQualityDisapprovalReason quality_disapproval_reasons = 9; + // Output only. List of placeholder type quality evaluation disapproval reasons. + repeated google.ads.googleads.v1.enums.FeedItemQualityDisapprovalReasonEnum.FeedItemQualityDisapprovalReason quality_disapproval_reasons = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Stores a validation error and the set of offending feed attributes which // together are responsible for causing a feed item validation error. message FeedItemValidationError { - // Error code indicating what validation error was triggered. The description + // Output only. Error code indicating what validation error was triggered. The description // of the error can be found in the 'description' field. - google.ads.googleads.v1.errors.FeedItemValidationErrorEnum - .FeedItemValidationError validation_error = 1; + google.ads.googleads.v1.errors.FeedItemValidationErrorEnum.FeedItemValidationError validation_error = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The description of the validation error. - google.protobuf.StringValue description = 2; + // Output only. The description of the validation error. + google.protobuf.StringValue description = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Set of feed attributes in the feed item flagged during validation. If + // Output only. Set of feed attributes in the feed item flagged during validation. If // empty, no specific feed attributes can be associated with the error // (e.g. error across the entire feed item). - repeated google.protobuf.Int64Value feed_attribute_ids = 3; + repeated google.protobuf.Int64Value feed_attribute_ids = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Any extra information related to this error which is not captured by + // Output only. Any extra information related to this error which is not captured by // validation_error and feed_attribute_id (e.g. placeholder field IDs when // feed_attribute_id is not mapped). Note that extra_info is not localized. - google.protobuf.StringValue extra_info = 5; + google.protobuf.StringValue extra_info = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/feed_item_target.proto b/third_party/googleapis/google/ads/googleads/v1/resources/feed_item_target.proto index cbff9f828..a11376bc9 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/feed_item_target.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/feed_item_target.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,8 +19,10 @@ package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/common/criteria.proto"; import "google/ads/googleads/v1/enums/feed_item_target_device.proto"; import "google/ads/googleads/v1/enums/feed_item_target_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -36,41 +37,68 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A feed item target. message FeedItemTarget { - // The resource name of the feed item target. + option (google.api.resource) = { + type: "googleads.googleapis.com/FeedItemTarget" + pattern: "customers/{customer}/feedItemTargets/{feed_item_target}" + }; + + // Immutable. The resource name of the feed item target. // Feed item target resource names have the form: - // // `customers/{customer_id}/feedItemTargets/{feed_id}~{feed_item_id}~{feed_item_target_type}~{feed_item_target_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedItemTarget" + } + ]; - // The feed item to which this feed item target belongs. - google.protobuf.StringValue feed_item = 2; + // Immutable. The feed item to which this feed item target belongs. + google.protobuf.StringValue feed_item = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedItem" + } + ]; - // The target type of this feed item target. This field is read-only. - google.ads.googleads.v1.enums.FeedItemTargetTypeEnum.FeedItemTargetType - feed_item_target_type = 3; + // Output only. The target type of this feed item target. This field is read-only. + google.ads.googleads.v1.enums.FeedItemTargetTypeEnum.FeedItemTargetType feed_item_target_type = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The ID of the targeted resource. This field is read-only. - google.protobuf.Int64Value feed_item_target_id = 6; + // Output only. The ID of the targeted resource. This field is read-only. + google.protobuf.Int64Value feed_item_target_id = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; // The targeted resource. oneof target { - // The targeted campaign. - google.protobuf.StringValue campaign = 4; + // Immutable. The targeted campaign. + google.protobuf.StringValue campaign = 4 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; - // The targeted ad group. - google.protobuf.StringValue ad_group = 5; + // Immutable. The targeted ad group. + google.protobuf.StringValue ad_group = 5 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; - // The targeted keyword. - google.ads.googleads.v1.common.KeywordInfo keyword = 7; + // Immutable. The targeted keyword. + google.ads.googleads.v1.common.KeywordInfo keyword = 7 [(google.api.field_behavior) = IMMUTABLE]; - // The targeted geo target constant resource name. - google.protobuf.StringValue geo_target_constant = 8; + // Immutable. The targeted geo target constant resource name. + google.protobuf.StringValue geo_target_constant = 8 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GeoTargetConstant" + } + ]; - // The targeted device. - google.ads.googleads.v1.enums.FeedItemTargetDeviceEnum.FeedItemTargetDevice - device = 9; + // Immutable. The targeted device. + google.ads.googleads.v1.enums.FeedItemTargetDeviceEnum.FeedItemTargetDevice device = 9 [(google.api.field_behavior) = IMMUTABLE]; - // The targeted schedule. - google.ads.googleads.v1.common.AdScheduleInfo ad_schedule = 10; + // Immutable. The targeted schedule. + google.ads.googleads.v1.common.AdScheduleInfo ad_schedule = 10 [(google.api.field_behavior) = IMMUTABLE]; } } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/feed_mapping.proto b/third_party/googleapis/google/ads/googleads/v1/resources/feed_mapping.proto index 57292cf96..966ba7ecd 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/feed_mapping.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/feed_mapping.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -41,8 +40,10 @@ import "google/ads/googleads/v1/enums/real_estate_placeholder_field.proto"; import "google/ads/googleads/v1/enums/sitelink_placeholder_field.proto"; import "google/ads/googleads/v1/enums/structured_snippet_placeholder_field.proto"; import "google/ads/googleads/v1/enums/travel_placeholder_field.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -57,139 +58,129 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A feed mapping. message FeedMapping { - // The resource name of the feed mapping. + option (google.api.resource) = { + type: "googleads.googleapis.com/FeedMapping" + pattern: "customers/{customer}/feedMappings/{feed_mapping}" + }; + + // Immutable. The resource name of the feed mapping. // Feed mapping resource names have the form: // // `customers/{customer_id}/feedMappings/{feed_id}~{feed_mapping_id}` - string resource_name = 1; - - // The feed of this feed mapping. - google.protobuf.StringValue feed = 2; - - // Feed attributes to field mappings. These mappings are a one-to-many + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedMapping" + } + ]; + + // Immutable. The feed of this feed mapping. + google.protobuf.StringValue feed = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; + + // Immutable. Feed attributes to field mappings. These mappings are a one-to-many // relationship meaning that 1 feed attribute can be used to populate // multiple placeholder fields, but 1 placeholder field can only draw // data from 1 feed attribute. Ad Customizer is an exception, 1 placeholder // field can be mapped to multiple feed attributes. Required. - repeated AttributeFieldMapping attribute_field_mappings = 5; + repeated AttributeFieldMapping attribute_field_mappings = 5 [(google.api.field_behavior) = IMMUTABLE]; - // Status of the feed mapping. + // Output only. Status of the feed mapping. // This field is read-only. - google.ads.googleads.v1.enums.FeedMappingStatusEnum.FeedMappingStatus status = - 6; + google.ads.googleads.v1.enums.FeedMappingStatusEnum.FeedMappingStatus status = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; // Feed mapping target. Can be either a placeholder or a criterion. For a // given feed, the active FeedMappings must have unique targets. Required. oneof target { - // The placeholder type of this mapping (i.e., if the mapping maps feed + // Immutable. The placeholder type of this mapping (i.e., if the mapping maps feed // attributes to placeholder fields). - google.ads.googleads.v1.enums.PlaceholderTypeEnum.PlaceholderType - placeholder_type = 3; + google.ads.googleads.v1.enums.PlaceholderTypeEnum.PlaceholderType placeholder_type = 3 [(google.api.field_behavior) = IMMUTABLE]; - // The criterion type of this mapping (i.e., if the mapping maps feed + // Immutable. The criterion type of this mapping (i.e., if the mapping maps feed // attributes to criterion fields). - google.ads.googleads.v1.enums.FeedMappingCriterionTypeEnum - .FeedMappingCriterionType criterion_type = 4; + google.ads.googleads.v1.enums.FeedMappingCriterionTypeEnum.FeedMappingCriterionType criterion_type = 4 [(google.api.field_behavior) = IMMUTABLE]; } } // Maps from feed attribute id to a placeholder or criterion field id. message AttributeFieldMapping { - // Feed attribute from which to map. - google.protobuf.Int64Value feed_attribute_id = 1; + // Immutable. Feed attribute from which to map. + google.protobuf.Int64Value feed_attribute_id = 1 [(google.api.field_behavior) = IMMUTABLE]; - // The placeholder field ID. If a placeholder field enum is not published in + // Output only. The placeholder field ID. If a placeholder field enum is not published in // the current API version, then this field will be populated and the field // oneof will be empty. // This field is read-only. - google.protobuf.Int64Value field_id = 2; + google.protobuf.Int64Value field_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; // Placeholder or criterion field to be populated using data from // the above feed attribute. Required. oneof field { - // Sitelink Placeholder Fields. - google.ads.googleads.v1.enums.SitelinkPlaceholderFieldEnum - .SitelinkPlaceholderField sitelink_field = 3; - - // Call Placeholder Fields. - google.ads.googleads.v1.enums.CallPlaceholderFieldEnum.CallPlaceholderField - call_field = 4; - - // App Placeholder Fields. - google.ads.googleads.v1.enums.AppPlaceholderFieldEnum.AppPlaceholderField - app_field = 5; - - // Location Placeholder Fields. This field is read-only. - google.ads.googleads.v1.enums.LocationPlaceholderFieldEnum - .LocationPlaceholderField location_field = 6; - - // Affiliate Location Placeholder Fields. This field is read-only. - google.ads.googleads.v1.enums.AffiliateLocationPlaceholderFieldEnum - .AffiliateLocationPlaceholderField affiliate_location_field = 7; - - // Callout Placeholder Fields. - google.ads.googleads.v1.enums.CalloutPlaceholderFieldEnum - .CalloutPlaceholderField callout_field = 8; - - // Structured Snippet Placeholder Fields. - google.ads.googleads.v1.enums.StructuredSnippetPlaceholderFieldEnum - .StructuredSnippetPlaceholderField structured_snippet_field = 9; - - // Message Placeholder Fields. - google.ads.googleads.v1.enums.MessagePlaceholderFieldEnum - .MessagePlaceholderField message_field = 10; - - // Price Placeholder Fields. - google.ads.googleads.v1.enums.PricePlaceholderFieldEnum - .PricePlaceholderField price_field = 11; - - // Promotion Placeholder Fields. - google.ads.googleads.v1.enums.PromotionPlaceholderFieldEnum - .PromotionPlaceholderField promotion_field = 12; - - // Ad Customizer Placeholder Fields - google.ads.googleads.v1.enums.AdCustomizerPlaceholderFieldEnum - .AdCustomizerPlaceholderField ad_customizer_field = 13; - - // Dynamic Search Ad Page Feed Fields. - google.ads.googleads.v1.enums.DsaPageFeedCriterionFieldEnum - .DsaPageFeedCriterionField dsa_page_feed_field = 14; - - // Location Target Fields. - google.ads.googleads.v1.enums.LocationExtensionTargetingCriterionFieldEnum - .LocationExtensionTargetingCriterionField - location_extension_targeting_field = 15; - - // Education Placeholder Fields - google.ads.googleads.v1.enums.EducationPlaceholderFieldEnum - .EducationPlaceholderField education_field = 16; - - // Flight Placeholder Fields - google.ads.googleads.v1.enums.FlightPlaceholderFieldEnum - .FlightPlaceholderField flight_field = 17; - - // Custom Placeholder Fields - google.ads.googleads.v1.enums.CustomPlaceholderFieldEnum - .CustomPlaceholderField custom_field = 18; - - // Hotel Placeholder Fields - google.ads.googleads.v1.enums.HotelPlaceholderFieldEnum - .HotelPlaceholderField hotel_field = 19; - - // Real Estate Placeholder Fields - google.ads.googleads.v1.enums.RealEstatePlaceholderFieldEnum - .RealEstatePlaceholderField real_estate_field = 20; - - // Travel Placeholder Fields - google.ads.googleads.v1.enums.TravelPlaceholderFieldEnum - .TravelPlaceholderField travel_field = 21; - - // Local Placeholder Fields - google.ads.googleads.v1.enums.LocalPlaceholderFieldEnum - .LocalPlaceholderField local_field = 22; - - // Job Placeholder Fields - google.ads.googleads.v1.enums.JobPlaceholderFieldEnum.JobPlaceholderField - job_field = 23; + // Immutable. Sitelink Placeholder Fields. + google.ads.googleads.v1.enums.SitelinkPlaceholderFieldEnum.SitelinkPlaceholderField sitelink_field = 3 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Call Placeholder Fields. + google.ads.googleads.v1.enums.CallPlaceholderFieldEnum.CallPlaceholderField call_field = 4 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. App Placeholder Fields. + google.ads.googleads.v1.enums.AppPlaceholderFieldEnum.AppPlaceholderField app_field = 5 [(google.api.field_behavior) = IMMUTABLE]; + + // Output only. Location Placeholder Fields. This field is read-only. + google.ads.googleads.v1.enums.LocationPlaceholderFieldEnum.LocationPlaceholderField location_field = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Affiliate Location Placeholder Fields. This field is read-only. + google.ads.googleads.v1.enums.AffiliateLocationPlaceholderFieldEnum.AffiliateLocationPlaceholderField affiliate_location_field = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. Callout Placeholder Fields. + google.ads.googleads.v1.enums.CalloutPlaceholderFieldEnum.CalloutPlaceholderField callout_field = 8 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Structured Snippet Placeholder Fields. + google.ads.googleads.v1.enums.StructuredSnippetPlaceholderFieldEnum.StructuredSnippetPlaceholderField structured_snippet_field = 9 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Message Placeholder Fields. + google.ads.googleads.v1.enums.MessagePlaceholderFieldEnum.MessagePlaceholderField message_field = 10 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Price Placeholder Fields. + google.ads.googleads.v1.enums.PricePlaceholderFieldEnum.PricePlaceholderField price_field = 11 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Promotion Placeholder Fields. + google.ads.googleads.v1.enums.PromotionPlaceholderFieldEnum.PromotionPlaceholderField promotion_field = 12 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Ad Customizer Placeholder Fields + google.ads.googleads.v1.enums.AdCustomizerPlaceholderFieldEnum.AdCustomizerPlaceholderField ad_customizer_field = 13 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Dynamic Search Ad Page Feed Fields. + google.ads.googleads.v1.enums.DsaPageFeedCriterionFieldEnum.DsaPageFeedCriterionField dsa_page_feed_field = 14 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Location Target Fields. + google.ads.googleads.v1.enums.LocationExtensionTargetingCriterionFieldEnum.LocationExtensionTargetingCriterionField location_extension_targeting_field = 15 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Education Placeholder Fields + google.ads.googleads.v1.enums.EducationPlaceholderFieldEnum.EducationPlaceholderField education_field = 16 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Flight Placeholder Fields + google.ads.googleads.v1.enums.FlightPlaceholderFieldEnum.FlightPlaceholderField flight_field = 17 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Custom Placeholder Fields + google.ads.googleads.v1.enums.CustomPlaceholderFieldEnum.CustomPlaceholderField custom_field = 18 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Hotel Placeholder Fields + google.ads.googleads.v1.enums.HotelPlaceholderFieldEnum.HotelPlaceholderField hotel_field = 19 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Real Estate Placeholder Fields + google.ads.googleads.v1.enums.RealEstatePlaceholderFieldEnum.RealEstatePlaceholderField real_estate_field = 20 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Travel Placeholder Fields + google.ads.googleads.v1.enums.TravelPlaceholderFieldEnum.TravelPlaceholderField travel_field = 21 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Local Placeholder Fields + google.ads.googleads.v1.enums.LocalPlaceholderFieldEnum.LocalPlaceholderField local_field = 22 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Job Placeholder Fields + google.ads.googleads.v1.enums.JobPlaceholderFieldEnum.JobPlaceholderField job_field = 23 [(google.api.field_behavior) = IMMUTABLE]; } } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/feed_placeholder_view.proto b/third_party/googleapis/google/ads/googleads/v1/resources/feed_placeholder_view.proto index 0b03a8834..1e6f17a05 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/feed_placeholder_view.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/feed_placeholder_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/placeholder_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; @@ -33,13 +34,22 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A feed placeholder view. message FeedPlaceholderView { - // The resource name of the feed placeholder view. + option (google.api.resource) = { + type: "googleads.googleapis.com/FeedPlaceholderView" + pattern: "customers/{customer}/feedPlaceholderViews/{feed_placeholder_view}" + }; + + // Output only. The resource name of the feed placeholder view. // Feed placeholder view resource names have the form: // // `customers/{customer_id}/feedPlaceholderViews/{placeholder_type}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedPlaceholderView" + } + ]; - // The placeholder type of the feed placeholder view. - google.ads.googleads.v1.enums.PlaceholderTypeEnum.PlaceholderType - placeholder_type = 2; + // Output only. The placeholder type of the feed placeholder view. + google.ads.googleads.v1.enums.PlaceholderTypeEnum.PlaceholderType placeholder_type = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/gender_view.proto b/third_party/googleapis/google/ads/googleads/v1/resources/gender_view.proto index dac1df670..482286d1d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/gender_view.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/gender_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; @@ -32,9 +33,19 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A gender view. message GenderView { - // The resource name of the gender view. + option (google.api.resource) = { + type: "googleads.googleapis.com/GenderView" + pattern: "customers/{customer}/genderViews/{gender_view}" + }; + + // Output only. The resource name of the gender view. // Gender view resource names have the form: // // `customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GenderView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/geo_target_constant.proto b/third_party/googleapis/google/ads/googleads/v1/resources/geo_target_constant.proto index e89d7e99f..6da966027 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/geo_target_constant.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/geo_target_constant.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,15 +11,16 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/geo_target_constant_status.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -34,29 +35,38 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A geo target constant. message GeoTargetConstant { - // The resource name of the geo target constant. + option (google.api.resource) = { + type: "googleads.googleapis.com/GeoTargetConstant" + pattern: "geoTargetConstants/{geo_target_constant}" + }; + + // Output only. The resource name of the geo target constant. // Geo target constant resource names have the form: // // `geoTargetConstants/{geo_target_constant_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GeoTargetConstant" + } + ]; - // The ID of the geo target constant. - google.protobuf.Int64Value id = 3; + // Output only. The ID of the geo target constant. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Geo target constant English name. - google.protobuf.StringValue name = 4; + // Output only. Geo target constant English name. + google.protobuf.StringValue name = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The ISO-3166-1 alpha-2 country code that is associated with the target. - google.protobuf.StringValue country_code = 5; + // Output only. The ISO-3166-1 alpha-2 country code that is associated with the target. + google.protobuf.StringValue country_code = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Geo target constant target type. - google.protobuf.StringValue target_type = 6; + // Output only. Geo target constant target type. + google.protobuf.StringValue target_type = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Geo target constant status. - google.ads.googleads.v1.enums.GeoTargetConstantStatusEnum - .GeoTargetConstantStatus status = 7; + // Output only. Geo target constant status. + google.ads.googleads.v1.enums.GeoTargetConstantStatusEnum.GeoTargetConstantStatus status = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The fully qualified English name, consisting of the target's name and that + // Output only. The fully qualified English name, consisting of the target's name and that // of its parent and country. - google.protobuf.StringValue canonical_name = 8; + google.protobuf.StringValue canonical_name = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/geographic_view.proto b/third_party/googleapis/google/ads/googleads/v1/resources/geographic_view.proto index 9514db058..35edaa2d7 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/geographic_view.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/geographic_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,15 +11,16 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/geo_targeting_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -39,17 +40,30 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // the user or an area of interest. If other segment fields are used, you may // get more than one row per country. message GeographicView { - // The resource name of the geographic view. + option (google.api.resource) = { + type: "googleads.googleapis.com/GeographicView" + pattern: "customers/{customer}/geographicViews/{geographic_view}" + }; + + // Output only. The resource name of the geographic view. // Geographic view resource names have the form: // - // // `customers/{customer_id}/geographicViews/{country_criterion_id}~{location_type}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GeographicView" + } + ]; - // CriterionId for the geo target for a country. - google.protobuf.StringValue country_geo_target_constant = 2; + // Output only. CriterionId for the geo target for a country. + google.protobuf.StringValue country_geo_target_constant = 2 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GeoTargetConstant" + } + ]; - // Type of the geo targeting of the campaign. - google.ads.googleads.v1.enums.GeoTargetingTypeEnum.GeoTargetingType - location_type = 3; + // Output only. Type of the geo targeting of the campaign. + google.ads.googleads.v1.enums.GeoTargetingTypeEnum.GeoTargetingType location_type = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/google_ads_field.proto b/third_party/googleapis/google/ads/googleads/v1/resources/google_ads_field.proto index bb7fe280e..27c2d9e7e 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/google_ads_field.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/google_ads_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/google_ads_field_category.proto"; import "google/ads/googleads/v1/enums/google_ads_field_data_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -35,52 +36,61 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A field or resource (artifact) used by GoogleAdsService. message GoogleAdsField { - // The resource name of the artifact. + option (google.api.resource) = { + type: "googleads.googleapis.com/GoogleAdsField" + pattern: "googleAdsFields/{google_ads_field}" + }; + + // Output only. The resource name of the artifact. // Artifact resource names have the form: // // `googleAdsFields/{name}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GoogleAdsField" + } + ]; - // The name of the artifact. - google.protobuf.StringValue name = 2; + // Output only. The name of the artifact. + google.protobuf.StringValue name = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The category of the artifact. - google.ads.googleads.v1.enums.GoogleAdsFieldCategoryEnum - .GoogleAdsFieldCategory category = 3; + // Output only. The category of the artifact. + google.ads.googleads.v1.enums.GoogleAdsFieldCategoryEnum.GoogleAdsFieldCategory category = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Whether the artifact can be used in a SELECT clause in search + // Output only. Whether the artifact can be used in a SELECT clause in search // queries. - google.protobuf.BoolValue selectable = 4; + google.protobuf.BoolValue selectable = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Whether the artifact can be used in a WHERE clause in search + // Output only. Whether the artifact can be used in a WHERE clause in search // queries. - google.protobuf.BoolValue filterable = 5; + google.protobuf.BoolValue filterable = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Whether the artifact can be used in a ORDER BY clause in search + // Output only. Whether the artifact can be used in a ORDER BY clause in search // queries. - google.protobuf.BoolValue sortable = 6; + google.protobuf.BoolValue sortable = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The names of all resources, segments, and metrics that are selectable with + // Output only. The names of all resources, segments, and metrics that are selectable with // the described artifact. - repeated google.protobuf.StringValue selectable_with = 7; + repeated google.protobuf.StringValue selectable_with = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The names of all resources that are selectable with the described + // Output only. The names of all resources that are selectable with the described // artifact. Fields from these resources do not segment metrics when included // in search queries. // // This field is only set for artifacts whose category is RESOURCE. - repeated google.protobuf.StringValue attribute_resources = 8; + repeated google.protobuf.StringValue attribute_resources = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; - // At and beyond version V1 this field lists the names of all metrics that are + // Output only. At and beyond version V1 this field lists the names of all metrics that are // selectable with the described artifact when it is used in the FROM clause. // It is only set for artifacts whose category is RESOURCE. // // Before version V1 this field lists the names of all metrics that are // selectable with the described artifact. It is only set for artifacts whose // category is either RESOURCE or SEGMENT - repeated google.protobuf.StringValue metrics = 9; + repeated google.protobuf.StringValue metrics = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; - // At and beyond version V1 this field lists the names of all artifacts, + // Output only. At and beyond version V1 this field lists the names of all artifacts, // whether a segment or another resource, that segment metrics when included // in search queries and when the described artifact is used in the FROM // clause. It is only set for artifacts whose category is RESOURCE. @@ -89,21 +99,20 @@ message GoogleAdsField { // segment or another resource, that segment metrics when included in search // queries. It is only set for artifacts of category RESOURCE, SEGMENT or // METRIC. - repeated google.protobuf.StringValue segments = 10; + repeated google.protobuf.StringValue segments = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Values the artifact can assume if it is a field of type ENUM. + // Output only. Values the artifact can assume if it is a field of type ENUM. // // This field is only set for artifacts of category SEGMENT or ATTRIBUTE. - repeated google.protobuf.StringValue enum_values = 11; + repeated google.protobuf.StringValue enum_values = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; - // This field determines the operators that can be used with the artifact + // Output only. This field determines the operators that can be used with the artifact // in WHERE clauses. - google.ads.googleads.v1.enums.GoogleAdsFieldDataTypeEnum - .GoogleAdsFieldDataType data_type = 12; + google.ads.googleads.v1.enums.GoogleAdsFieldDataTypeEnum.GoogleAdsFieldDataType data_type = 12 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The URL of proto describing the artifact's data type. - google.protobuf.StringValue type_url = 13; + // Output only. The URL of proto describing the artifact's data type. + google.protobuf.StringValue type_url = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Whether the field artifact is repeated. - google.protobuf.BoolValue is_repeated = 14; + // Output only. Whether the field artifact is repeated. + google.protobuf.BoolValue is_repeated = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/group_placement_view.proto b/third_party/googleapis/google/ads/googleads/v1/resources/group_placement_view.proto index 1eb44e618..229467961 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/group_placement_view.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/group_placement_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,15 +11,16 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/placement_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -34,25 +35,33 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A group placement view. message GroupPlacementView { - // The resource name of the group placement view. + option (google.api.resource) = { + type: "googleads.googleapis.com/GroupPlacementView" + pattern: "customers/{customer}/groupPlacementViews/{group_placement_view}" + }; + + // Output only. The resource name of the group placement view. // Group placement view resource names have the form: // - // // `customers/{customer_id}/groupPlacementViews/{ad_group_id}~{base64_placement}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GroupPlacementView" + } + ]; - // The automatic placement string at group level, e. g. web domain, mobile + // Output only. The automatic placement string at group level, e. g. web domain, mobile // app ID, or a YouTube channel ID. - google.protobuf.StringValue placement = 2; + google.protobuf.StringValue placement = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Domain name for websites and YouTube channel name for YouTube channels. - google.protobuf.StringValue display_name = 3; + // Output only. Domain name for websites and YouTube channel name for YouTube channels. + google.protobuf.StringValue display_name = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // URL of the group placement, e.g. domain, link to the mobile application in + // Output only. URL of the group placement, e.g. domain, link to the mobile application in // app store, or a YouTube channel URL. - google.protobuf.StringValue target_url = 4; + google.protobuf.StringValue target_url = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Type of the placement, e.g. Website, YouTube Channel, Mobile Application. - google.ads.googleads.v1.enums.PlacementTypeEnum.PlacementType placement_type = - 5; + // Output only. Type of the placement, e.g. Website, YouTube Channel, Mobile Application. + google.ads.googleads.v1.enums.PlacementTypeEnum.PlacementType placement_type = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/hotel_group_view.proto b/third_party/googleapis/google/ads/googleads/v1/resources/hotel_group_view.proto index 5384add73..ff0b5ada3 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/hotel_group_view.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/hotel_group_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; @@ -32,9 +33,19 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A hotel group view. message HotelGroupView { - // The resource name of the hotel group view. + option (google.api.resource) = { + type: "googleads.googleapis.com/HotelGroupView" + pattern: "customers/{customer}/hotelGroupViews/{hotel_group_view}" + }; + + // Output only. The resource name of the hotel group view. // Hotel Group view resource names have the form: // // `customers/{customer_id}/hotelGroupViews/{ad_group_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/HotelGroupView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/hotel_performance_view.proto b/third_party/googleapis/google/ads/googleads/v1/resources/hotel_performance_view.proto index 3a815fd92..961e55cee 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/hotel_performance_view.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/hotel_performance_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; @@ -32,9 +33,19 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A hotel performance view. message HotelPerformanceView { - // The resource name of the hotel performance view. + option (google.api.resource) = { + type: "googleads.googleapis.com/HotelPerformanceView" + pattern: "customers/{customer}/hotelPerformanceView" + }; + + // Output only. The resource name of the hotel performance view. // Hotel performance view resource names have the form: // // `customers/{customer_id}/hotelPerformanceView` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/HotelPerformanceView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/keyword_plan.proto b/third_party/googleapis/google/ads/googleads/v1/resources/keyword_plan.proto index fd2d38f9f..19cbac4f3 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/keyword_plan.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/keyword_plan.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/common/dates.proto"; import "google/ads/googleads/v1/enums/keyword_plan_forecast_interval.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -37,14 +38,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // Max number of saved keyword plans: 10000. // It's possible to remove plans if limit is reached. message KeywordPlan { - // The resource name of the Keyword Planner plan. + option (google.api.resource) = { + type: "googleads.googleapis.com/KeywordPlan" + pattern: "customers/{customer}/keywordPlans/{keyword_plan}" + }; + + // Immutable. The resource name of the Keyword Planner plan. // KeywordPlan resource names have the form: // // `customers/{customer_id}/keywordPlans/{kp_plan_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlan" + } + ]; - // The ID of the keyword plan. - google.protobuf.Int64Value id = 2; + // Output only. The ID of the keyword plan. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; // The name of the keyword plan. // @@ -61,12 +72,12 @@ message KeywordPlanForecastPeriod { // Required. The date used for forecasting the Plan. oneof interval { // A future date range relative to the current date used for forecasting. - google.ads.googleads.v1.enums.KeywordPlanForecastIntervalEnum - .KeywordPlanForecastInterval date_interval = 1; + google.ads.googleads.v1.enums.KeywordPlanForecastIntervalEnum.KeywordPlanForecastInterval date_interval = 1; // The custom date range used for forecasting. // The start and end dates must be in the future. Otherwise, an error will // be returned when the forecasting action is performed. + // The start and end dates are inclusive. google.ads.googleads.v1.common.DateRange date_range = 2; } } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/keyword_plan_ad_group.proto b/third_party/googleapis/google/ads/googleads/v1/resources/keyword_plan_ad_group.proto index c3d31c8b3..25bd7eeb6 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/keyword_plan_ad_group.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/keyword_plan_ad_group.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,15 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -34,17 +35,29 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A Keyword Planner ad group. // Max number of keyword plan ad groups per plan: 200. message KeywordPlanAdGroup { - // The resource name of the Keyword Planner ad group. + option (google.api.resource) = { + type: "googleads.googleapis.com/KeywordPlanAdGroup" + pattern: "customers/{customer}/keywordPlanAdGroups/{keyword_plan_ad_group}" + }; + + // Immutable. The resource name of the Keyword Planner ad group. // KeywordPlanAdGroup resource names have the form: // // `customers/{customer_id}/keywordPlanAdGroups/{kp_ad_group_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanAdGroup" + } + ]; // The keyword plan campaign to which this ad group belongs. - google.protobuf.StringValue keyword_plan_campaign = 2; + google.protobuf.StringValue keyword_plan_campaign = 2 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanCampaign" + }]; - // The ID of the keyword plan ad group. - google.protobuf.Int64Value id = 3; + // Output only. The ID of the keyword plan ad group. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // The name of the keyword plan ad group. // diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/keyword_plan_campaign.proto b/third_party/googleapis/google/ads/googleads/v1/resources/keyword_plan_campaign.proto index 8e26b57cf..2f6bb8a5f 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/keyword_plan_campaign.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/keyword_plan_campaign.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,15 +11,16 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/keyword_plan_network.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -35,17 +36,29 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A Keyword Plan campaign. // Max number of keyword plan campaigns per plan allowed: 1. message KeywordPlanCampaign { - // The resource name of the Keyword Plan campaign. + option (google.api.resource) = { + type: "googleads.googleapis.com/KeywordPlanCampaign" + pattern: "customers/{customer}/keywordPlanCampaigns/{keyword_plan_campaign}" + }; + + // Immutable. The resource name of the Keyword Plan campaign. // KeywordPlanCampaign resource names have the form: // // `customers/{customer_id}/keywordPlanCampaigns/{kp_campaign_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanCampaign" + } + ]; // The keyword plan this campaign belongs to. - google.protobuf.StringValue keyword_plan = 2; + google.protobuf.StringValue keyword_plan = 2 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlan" + }]; - // The ID of the Keyword Plan campaign. - google.protobuf.Int64Value id = 3; + // Output only. The ID of the Keyword Plan campaign. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // The name of the Keyword Plan campaign. // @@ -55,14 +68,15 @@ message KeywordPlanCampaign { // The languages targeted for the Keyword Plan campaign. // Max allowed: 1. - repeated google.protobuf.StringValue language_constants = 5; + repeated google.protobuf.StringValue language_constants = 5 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/LanguageConstant" + }]; // Targeting network. // // This field is required and should not be empty when creating Keyword Plan // campaigns. - google.ads.googleads.v1.enums.KeywordPlanNetworkEnum.KeywordPlanNetwork - keyword_plan_network = 6; + google.ads.googleads.v1.enums.KeywordPlanNetworkEnum.KeywordPlanNetwork keyword_plan_network = 6; // A default max cpc bid in micros, and in the account currency, for all ad // groups under the campaign. @@ -80,5 +94,7 @@ message KeywordPlanCampaign { // Next ID: 3 message KeywordPlanGeoTarget { // Required. The resource name of the geo target. - google.protobuf.StringValue geo_target_constant = 1; + google.protobuf.StringValue geo_target_constant = 1 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/GeoTargetConstant" + }]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/keyword_plan_keyword.proto b/third_party/googleapis/google/ads/googleads/v1/resources/keyword_plan_keyword.proto index 6e969a7b6..db80508db 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/keyword_plan_keyword.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/keyword_plan_keyword.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,15 +11,16 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/keyword_match_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -35,24 +36,35 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A Keyword Plan ad group keyword. // Max number of keyword plan keywords per plan: 2500. message KeywordPlanKeyword { - // The resource name of the Keyword Plan ad group keyword. + option (google.api.resource) = { + type: "googleads.googleapis.com/KeywordPlanKeyword" + pattern: "customers/{customer}/keywordPlanKeywords/{keyword_plan_keyword}" + }; + + // Immutable. The resource name of the Keyword Plan ad group keyword. // KeywordPlanKeyword resource names have the form: // // `customers/{customer_id}/keywordPlanKeywords/{kp_ad_group_keyword_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanKeyword" + } + ]; // The Keyword Plan ad group to which this keyword belongs. - google.protobuf.StringValue keyword_plan_ad_group = 2; + google.protobuf.StringValue keyword_plan_ad_group = 2 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanAdGroup" + }]; - // The ID of the Keyword Plan keyword. - google.protobuf.Int64Value id = 3; + // Output only. The ID of the Keyword Plan keyword. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // The keyword text. google.protobuf.StringValue text = 4; // The keyword match type. - google.ads.googleads.v1.enums.KeywordMatchTypeEnum.KeywordMatchType - match_type = 5; + google.ads.googleads.v1.enums.KeywordMatchTypeEnum.KeywordMatchType match_type = 5; // A keyword level max cpc bid in micros, in the account currency, that // overrides the keyword plan ad group cpc bid. diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/keyword_plan_negative_keyword.proto b/third_party/googleapis/google/ads/googleads/v1/resources/keyword_plan_negative_keyword.proto index 546dd4546..e63beb463 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/keyword_plan_negative_keyword.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/keyword_plan_negative_keyword.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,15 +11,16 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/keyword_match_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -35,23 +36,33 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A Keyword Plan negative keyword. // Max number of keyword plan negative keywords per plan: 1000. message KeywordPlanNegativeKeyword { - // The resource name of the Keyword Plan negative keyword. + option (google.api.resource) = { + type: "googleads.googleapis.com/KeywordPlanNegativeKeyword" + pattern: "customers/{customer}/keywordPlanNegativeKeywords/{keyword_plan_negative_keyword}" + }; + + // Immutable. The resource name of the Keyword Plan negative keyword. // KeywordPlanNegativeKeyword resource names have the form: // - // // `customers/{customer_id}/keywordPlanNegativeKeywords/{kp_negative_keyword_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanNegativeKeyword" + } + ]; // The Keyword Plan campaign to which this negative keyword belongs. - google.protobuf.StringValue keyword_plan_campaign = 2; + google.protobuf.StringValue keyword_plan_campaign = 2 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanCampaign" + }]; - // The ID of the Keyword Plan negative keyword. - google.protobuf.Int64Value id = 3; + // Output only. The ID of the Keyword Plan negative keyword. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // The keyword text. google.protobuf.StringValue text = 4; // The keyword match type. - google.ads.googleads.v1.enums.KeywordMatchTypeEnum.KeywordMatchType - match_type = 5; + google.ads.googleads.v1.enums.KeywordMatchTypeEnum.KeywordMatchType match_type = 5; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/keyword_view.proto b/third_party/googleapis/google/ads/googleads/v1/resources/keyword_view.proto index 90fba7058..f0d885036 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/keyword_view.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/keyword_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; @@ -32,9 +33,19 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A keyword view. message KeywordView { - // The resource name of the keyword view. + option (google.api.resource) = { + type: "googleads.googleapis.com/KeywordView" + pattern: "customers/{customer}/keywordViews/{keyword_view}" + }; + + // Output only. The resource name of the keyword view. // Keyword view resource names have the form: // // `customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/label.proto b/third_party/googleapis/google/ads/googleads/v1/resources/label.proto index aa30abe0a..8202a65f0 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/label.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/label.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/common/text_label.proto"; import "google/ads/googleads/v1/enums/label_status.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -33,13 +34,23 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A label. message Label { - // Name of the resource. + option (google.api.resource) = { + type: "googleads.googleapis.com/Label" + pattern: "customers/{customer}/labels/{label}" + }; + + // Immutable. Name of the resource. // Label resource names have the form: // `customers/{customer_id}/labels/{label_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Label" + } + ]; - // Id of the label. Read only. - google.protobuf.Int64Value id = 2; + // Output only. Id of the label. Read only. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; // The name of the label. // @@ -48,8 +59,8 @@ message Label { // The length of this string should be between 1 and 80, inclusive. google.protobuf.StringValue name = 3; - // Status of the label. Read only. - google.ads.googleads.v1.enums.LabelStatusEnum.LabelStatus status = 4; + // Output only. Status of the label. Read only. + google.ads.googleads.v1.enums.LabelStatusEnum.LabelStatus status = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; // A type of label displaying text on a colored background. google.ads.googleads.v1.common.TextLabel text_label = 5; diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/landing_page_view.proto b/third_party/googleapis/google/ads/googleads/v1/resources/landing_page_view.proto index f2aa756c0..093b64b10 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/landing_page_view.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/landing_page_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,15 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -34,13 +35,22 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A landing page view with metrics aggregated at the unexpanded final URL // level. message LandingPageView { - // The resource name of the landing page view. + option (google.api.resource) = { + type: "googleads.googleapis.com/LandingPageView" + pattern: "customers/{customer}/landingPageViews/{landing_page_view}" + }; + + // Output only. The resource name of the landing page view. // Landing page view resource names have the form: // - // // `customers/{customer_id}/landingPageViews/{unexpanded_final_url_fingerprint}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/LandingPageView" + } + ]; - // The advertiser-specified final URL. - google.protobuf.StringValue unexpanded_final_url = 2; + // Output only. The advertiser-specified final URL. + google.protobuf.StringValue unexpanded_final_url = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/language_constant.proto b/third_party/googleapis/google/ads/googleads/v1/resources/language_constant.proto index 77c7a2db3..9a797e040 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/language_constant.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/language_constant.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,15 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -33,22 +34,32 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A language. message LanguageConstant { - // The resource name of the language constant. + option (google.api.resource) = { + type: "googleads.googleapis.com/LanguageConstant" + pattern: "languageConstants/{language_constant}" + }; + + // Output only. The resource name of the language constant. // Language constant resource names have the form: // // `languageConstants/{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/LanguageConstant" + } + ]; - // The ID of the language constant. - google.protobuf.Int64Value id = 2; + // Output only. The ID of the language constant. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The language code, e.g. "en_US", "en_AU", "es", "fr", etc. - google.protobuf.StringValue code = 3; + // Output only. The language code, e.g. "en_US", "en_AU", "es", "fr", etc. + google.protobuf.StringValue code = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The full name of the language in English, e.g., "English (US)", "Spanish", + // Output only. The full name of the language in English, e.g., "English (US)", "Spanish", // etc. - google.protobuf.StringValue name = 4; + google.protobuf.StringValue name = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Whether the language is targetable. - google.protobuf.BoolValue targetable = 5; + // Output only. Whether the language is targetable. + google.protobuf.BoolValue targetable = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/location_view.proto b/third_party/googleapis/google/ads/googleads/v1/resources/location_view.proto index 68d43e6de..9e872128b 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/location_view.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/location_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; @@ -33,9 +34,19 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A location view summarizes the performance of campaigns by // Location criteria. message LocationView { - // The resource name of the location view. + option (google.api.resource) = { + type: "googleads.googleapis.com/LocationView" + pattern: "customers/{customer}/locationViews/{location_view}" + }; + + // Output only. The resource name of the location view. // Location view resource names have the form: // // `customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/LocationView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/managed_placement_view.proto b/third_party/googleapis/google/ads/googleads/v1/resources/managed_placement_view.proto index 4e6b4ab4a..c9addb1ee 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/managed_placement_view.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/managed_placement_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; @@ -32,10 +33,19 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A managed placement view. message ManagedPlacementView { - // The resource name of the Managed Placement view. + option (google.api.resource) = { + type: "googleads.googleapis.com/ManagedPlacementView" + pattern: "customers/{customer}/managedPlacementViews/{managed_placement_view}" + }; + + // Output only. The resource name of the Managed Placement view. // Managed placement view resource names have the form: // - // // `customers/{customer_id}/managedPlacementViews/{ad_group_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ManagedPlacementView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/media_file.proto b/third_party/googleapis/google/ads/googleads/v1/resources/media_file.proto index 5002b006c..ed1133fe9 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/media_file.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/media_file.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/media_type.proto"; import "google/ads/googleads/v1/enums/mime_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -35,80 +36,90 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A media file. message MediaFile { - // The resource name of the media file. + option (google.api.resource) = { + type: "googleads.googleapis.com/MediaFile" + pattern: "customers/{customer}/mediaFiles/{media_file}" + }; + + // Immutable. The resource name of the media file. // Media file resource names have the form: // // `customers/{customer_id}/mediaFiles/{media_file_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MediaFile" + } + ]; - // The ID of the media file. - google.protobuf.Int64Value id = 2; + // Output only. The ID of the media file. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Type of the media file. - google.ads.googleads.v1.enums.MediaTypeEnum.MediaType type = 5; + // Immutable. Type of the media file. + google.ads.googleads.v1.enums.MediaTypeEnum.MediaType type = 5 [(google.api.field_behavior) = IMMUTABLE]; - // The mime type of the media file. - google.ads.googleads.v1.enums.MimeTypeEnum.MimeType mime_type = 6; + // Output only. The mime type of the media file. + google.ads.googleads.v1.enums.MimeTypeEnum.MimeType mime_type = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The URL of where the original media file was downloaded from (or a file - // name). - google.protobuf.StringValue source_url = 7; + // Immutable. The URL of where the original media file was downloaded from (or a file + // name). Only used for media of type AUDIO and IMAGE. + google.protobuf.StringValue source_url = 7 [(google.api.field_behavior) = IMMUTABLE]; - // The name of the media file. The name can be used by clients to help + // Immutable. The name of the media file. The name can be used by clients to help // identify previously uploaded media. - google.protobuf.StringValue name = 8; + google.protobuf.StringValue name = 8 [(google.api.field_behavior) = IMMUTABLE]; - // The size of the media file in bytes. - google.protobuf.Int64Value file_size = 9; + // Output only. The size of the media file in bytes. + google.protobuf.Int64Value file_size = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; // The specific type of the media file. oneof mediatype { - // Encapsulates an Image. - MediaImage image = 3; + // Immutable. Encapsulates an Image. + MediaImage image = 3 [(google.api.field_behavior) = IMMUTABLE]; - // A ZIP archive media the content of which contains HTML5 assets. - MediaBundle media_bundle = 4; + // Immutable. A ZIP archive media the content of which contains HTML5 assets. + MediaBundle media_bundle = 4 [(google.api.field_behavior) = IMMUTABLE]; - // Encapsulates an Audio. - MediaAudio audio = 10; + // Output only. Encapsulates an Audio. + MediaAudio audio = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Encapsulates a Video. - MediaVideo video = 11; + // Immutable. Encapsulates a Video. + MediaVideo video = 11 [(google.api.field_behavior) = IMMUTABLE]; } } // Encapsulates an Image. message MediaImage { - // Raw image data. - google.protobuf.BytesValue data = 1; + // Immutable. Raw image data. + google.protobuf.BytesValue data = 1 [(google.api.field_behavior) = IMMUTABLE]; } // Represents a ZIP archive media the content of which contains HTML5 assets. message MediaBundle { - // Raw zipped data. - google.protobuf.BytesValue data = 1; + // Immutable. Raw zipped data. + google.protobuf.BytesValue data = 1 [(google.api.field_behavior) = IMMUTABLE]; } // Encapsulates an Audio. message MediaAudio { - // The duration of the Audio in milliseconds. - google.protobuf.Int64Value ad_duration_millis = 1; + // Output only. The duration of the Audio in milliseconds. + google.protobuf.Int64Value ad_duration_millis = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Encapsulates a Video. message MediaVideo { - // The duration of the Video in milliseconds. - google.protobuf.Int64Value ad_duration_millis = 1; + // Output only. The duration of the Video in milliseconds. + google.protobuf.Int64Value ad_duration_millis = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The YouTube video ID (as seen in YouTube URLs). - google.protobuf.StringValue youtube_video_id = 2; + // Immutable. The YouTube video ID (as seen in YouTube URLs). + google.protobuf.StringValue youtube_video_id = 2 [(google.api.field_behavior) = IMMUTABLE]; - // The Advertising Digital Identification code for this video, as defined by + // Output only. The Advertising Digital Identification code for this video, as defined by // the American Association of Advertising Agencies, used mainly for // television commercials. - google.protobuf.StringValue advertising_id_code = 3; + google.protobuf.StringValue advertising_id_code = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The Industry Standard Commercial Identifier code for this video, used + // Output only. The Industry Standard Commercial Identifier code for this video, used // mainly for television commercials. - google.protobuf.StringValue isci_code = 4; + google.protobuf.StringValue isci_code = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/merchant_center_link.proto b/third_party/googleapis/google/ads/googleads/v1/resources/merchant_center_link.proto index 55100b262..b860df139 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/merchant_center_link.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/merchant_center_link.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,15 +11,16 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/merchant_center_link_status.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -35,21 +36,30 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A data sharing connection, proposed or in use, // between a Google Ads Customer and a Merchant Center account. message MerchantCenterLink { - // The resource name of the merchant center link. + option (google.api.resource) = { + type: "googleads.googleapis.com/MerchantCenterLink" + pattern: "customers/{customer}/merchantCenterLinks/{merchant_center_link}" + }; + + // Immutable. The resource name of the merchant center link. // Merchant center link resource names have the form: // // `customers/{customer_id}/merchantCenterLinks/{merchant_center_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MerchantCenterLink" + } + ]; - // The ID of the Merchant Center account. + // Output only. The ID of the Merchant Center account. // This field is readonly. - google.protobuf.Int64Value id = 3; + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The name of the Merchant Center account. + // Output only. The name of the Merchant Center account. // This field is readonly. - google.protobuf.StringValue merchant_center_account_name = 4; + google.protobuf.StringValue merchant_center_account_name = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; // The status of the link. - google.ads.googleads.v1.enums.MerchantCenterLinkStatusEnum - .MerchantCenterLinkStatus status = 5; + google.ads.googleads.v1.enums.MerchantCenterLinkStatusEnum.MerchantCenterLinkStatus status = 5; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/mobile_app_category_constant.proto b/third_party/googleapis/google/ads/googleads/v1/resources/mobile_app_category_constant.proto index f859dc04f..a645d9a52 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/mobile_app_category_constant.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/mobile_app_category_constant.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,15 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -33,15 +34,25 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A mobile application category constant. message MobileAppCategoryConstant { - // The resource name of the mobile app category constant. + option (google.api.resource) = { + type: "googleads.googleapis.com/MobileAppCategoryConstant" + pattern: "mobileAppCategoryConstants/{mobile_app_category_constant}" + }; + + // Output only. The resource name of the mobile app category constant. // Mobile app category constant resource names have the form: // // `mobileAppCategoryConstants/{mobile_app_category_id}` - string resource_name = 1; - - // The ID of the mobile app category constant. - google.protobuf.Int32Value id = 2; - - // Mobile app category name. - google.protobuf.StringValue name = 3; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MobileAppCategoryConstant" + } + ]; + + // Output only. The ID of the mobile app category constant. + google.protobuf.Int32Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Mobile app category name. + google.protobuf.StringValue name = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/mobile_device_constant.proto b/third_party/googleapis/google/ads/googleads/v1/resources/mobile_device_constant.proto index b68852cef..47e8558ac 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/mobile_device_constant.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/mobile_device_constant.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,15 +11,16 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/mobile_device_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -34,24 +35,34 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A mobile device constant. message MobileDeviceConstant { - // The resource name of the mobile device constant. + option (google.api.resource) = { + type: "googleads.googleapis.com/MobileDeviceConstant" + pattern: "mobileDeviceConstants/{mobile_device_constant}" + }; + + // Output only. The resource name of the mobile device constant. // Mobile device constant resource names have the form: // // `mobileDeviceConstants/{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MobileDeviceConstant" + } + ]; - // The ID of the mobile device constant. - google.protobuf.Int64Value id = 2; + // Output only. The ID of the mobile device constant. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The name of the mobile device. - google.protobuf.StringValue name = 3; + // Output only. The name of the mobile device. + google.protobuf.StringValue name = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The manufacturer of the mobile device. - google.protobuf.StringValue manufacturer_name = 4; + // Output only. The manufacturer of the mobile device. + google.protobuf.StringValue manufacturer_name = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The operating system of the mobile device. - google.protobuf.StringValue operating_system_name = 5; + // Output only. The operating system of the mobile device. + google.protobuf.StringValue operating_system_name = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The type of mobile device. - google.ads.googleads.v1.enums.MobileDeviceTypeEnum.MobileDeviceType type = 6; + // Output only. The type of mobile device. + google.ads.googleads.v1.enums.MobileDeviceTypeEnum.MobileDeviceType type = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/mutate_job.proto b/third_party/googleapis/google/ads/googleads/v1/resources/mutate_job.proto index 038ca8ba7..12ce38714 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/mutate_job.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/mutate_job.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,15 +11,16 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/mutate_job_status.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -33,52 +34,62 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // Proto file describing the mutate job resource. // A list of mutates being processed asynchronously. The mutates are uploaded -// by the user. The mutates themselves aren’t readable and the results of the +// by the user. The mutates themselves aren't readable and the results of the // job can only be read using MutateJobService.ListMutateJobResults. message MutateJob { + option (google.api.resource) = { + type: "googleads.googleapis.com/MutateJob" + pattern: "customers/{customer}/mutateJobs/{mutate_job}" + }; + // Additional information about the mutate job. This message is also used as // metadata returned in mutate job Long Running Operations. message MutateJobMetadata { - // The time when this mutate job was created. + // Output only. The time when this mutate job was created. // Formatted as yyyy-mm-dd hh:mm:ss. Example: "2018-03-05 09:15:00" - google.protobuf.StringValue creation_date_time = 1; + google.protobuf.StringValue creation_date_time = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The time when this mutate job was completed. + // Output only. The time when this mutate job was completed. // Formatted as yyyy-MM-dd HH:mm:ss. Example: "2018-03-05 09:16:00" - google.protobuf.StringValue completion_date_time = 2; + google.protobuf.StringValue completion_date_time = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The fraction (between 0.0 and 1.0) of mutates that have been processed. + // Output only. The fraction (between 0.0 and 1.0) of mutates that have been processed. // This is empty if the job hasn't started running yet. - google.protobuf.DoubleValue estimated_completion_ratio = 3; + google.protobuf.DoubleValue estimated_completion_ratio = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The number of mutate operations in the mutate job. - google.protobuf.Int64Value operation_count = 4; + // Output only. The number of mutate operations in the mutate job. + google.protobuf.Int64Value operation_count = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The number of mutate operations executed by the mutate job. + // Output only. The number of mutate operations executed by the mutate job. // Present only if the job has started running. - google.protobuf.Int64Value executed_operation_count = 5; + google.protobuf.Int64Value executed_operation_count = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; } - // The resource name of the mutate job. + // Immutable. The resource name of the mutate job. // Mutate job resource names have the form: // // `customers/{customer_id}/mutateJobs/{mutate_job_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MutateJob" + } + ]; - // ID of this mutate job. - google.protobuf.Int64Value id = 2; + // Output only. ID of this mutate job. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The next sequence token to use when adding operations. Only set when the + // Output only. The next sequence token to use when adding operations. Only set when the // mutate job status is PENDING. - google.protobuf.StringValue next_add_sequence_token = 3; + google.protobuf.StringValue next_add_sequence_token = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Contains additional information about this mutate job. - MutateJobMetadata metadata = 4; + // Output only. Contains additional information about this mutate job. + MutateJobMetadata metadata = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Status of this mutate job. - google.ads.googleads.v1.enums.MutateJobStatusEnum.MutateJobStatus status = 5; + // Output only. Status of this mutate job. + google.ads.googleads.v1.enums.MutateJobStatusEnum.MutateJobStatus status = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The resource name of the long-running operation that can be used to poll + // Output only. The resource name of the long-running operation that can be used to poll // for completion. Only set when the mutate job status is RUNNING or DONE. - google.protobuf.StringValue long_running_operation = 6; + google.protobuf.StringValue long_running_operation = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/operating_system_version_constant.proto b/third_party/googleapis/google/ads/googleads/v1/resources/operating_system_version_constant.proto index 29c61b1e0..e81cd8630 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/operating_system_version_constant.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/operating_system_version_constant.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,15 +11,16 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/enums/operating_system_version_operator_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -33,32 +34,38 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // Proto file describing the operating system version constant resource. // A mobile operating system version or a range of versions, depending on -// 'operator_type'. The complete list of available mobile platforms is available -// - // here - repeated google.protobuf.StringValue path = 4; + // "Pets & Animals/Pets/Dogs" category. List of available topic categories at + // https://developers.google.com/adwords/api/docs/appendix/verticals + repeated google.protobuf.StringValue path = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/topic_view.proto b/third_party/googleapis/google/ads/googleads/v1/resources/topic_view.proto index 4a0a016a3..e7b8c3e15 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/topic_view.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/topic_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; @@ -32,9 +33,19 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A topic view. message TopicView { - // The resource name of the topic view. + option (google.api.resource) = { + type: "googleads.googleapis.com/TopicView" + pattern: "customers/{customer}/topicViews/{topic_view}" + }; + + // Output only. The resource name of the topic view. // Topic view resource names have the form: // // `customers/{customer_id}/topicViews/{ad_group_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/TopicView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/user_interest.proto b/third_party/googleapis/google/ads/googleads/v1/resources/user_interest.proto index 61f8847f0..2ab92157d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/user_interest.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/user_interest.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.resources; import "google/ads/googleads/v1/common/criterion_category_availability.proto"; import "google/ads/googleads/v1/enums/user_interest_taxonomy_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -35,29 +36,42 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A user interest: a particular interest-based vertical to be targeted. message UserInterest { - // The resource name of the user interest. + option (google.api.resource) = { + type: "googleads.googleapis.com/UserInterest" + pattern: "customers/{customer}/userInterests/{user_interest}" + }; + + // Output only. The resource name of the user interest. // User interest resource names have the form: // // `customers/{customer_id}/userInterests/{user_interest_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/UserInterest" + } + ]; - // Taxonomy type of the user interest. - google.ads.googleads.v1.enums.UserInterestTaxonomyTypeEnum - .UserInterestTaxonomyType taxonomy_type = 2; + // Output only. Taxonomy type of the user interest. + google.ads.googleads.v1.enums.UserInterestTaxonomyTypeEnum.UserInterestTaxonomyType taxonomy_type = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The ID of the user interest. - google.protobuf.Int64Value user_interest_id = 3; + // Output only. The ID of the user interest. + google.protobuf.Int64Value user_interest_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The name of the user interest. - google.protobuf.StringValue name = 4; + // Output only. The name of the user interest. + google.protobuf.StringValue name = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The parent of the user interest. - google.protobuf.StringValue user_interest_parent = 5; + // Output only. The parent of the user interest. + google.protobuf.StringValue user_interest_parent = 5 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/UserInterest" + } + ]; - // True if the user interest is launched to all channels and locales. - google.protobuf.BoolValue launched_to_all = 6; + // Output only. True if the user interest is launched to all channels and locales. + google.protobuf.BoolValue launched_to_all = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Availability information of the user interest. - repeated google.ads.googleads.v1.common.CriterionCategoryAvailability - availabilities = 7; + // Output only. Availability information of the user interest. + repeated google.ads.googleads.v1.common.CriterionCategoryAvailability availabilities = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/user_list.proto b/third_party/googleapis/google/ads/googleads/v1/resources/user_list.proto index 6fa7ce782..e9c6538ca 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/user_list.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/user_list.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -24,8 +23,10 @@ import "google/ads/googleads/v1/enums/user_list_closing_reason.proto"; import "google/ads/googleads/v1/enums/user_list_membership_status.proto"; import "google/ads/googleads/v1/enums/user_list_size_range.proto"; import "google/ads/googleads/v1/enums/user_list_type.proto"; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -40,21 +41,31 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A user list. This is a list of users a customer may target. message UserList { - // The resource name of the user list. + option (google.api.resource) = { + type: "googleads.googleapis.com/UserList" + pattern: "customers/{customer}/userLists/{user_list}" + }; + + // Immutable. The resource name of the user list. // User list resource names have the form: // // `customers/{customer_id}/userLists/{user_list_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/UserList" + } + ]; - // Id of the user list. - google.protobuf.Int64Value id = 2; + // Output only. Id of the user list. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // A flag that indicates if a user may edit a list. Depends on the list + // Output only. A flag that indicates if a user may edit a list. Depends on the list // ownership and list type. For example, external remarketing user lists are // not editable. // // This field is read-only. - google.protobuf.BoolValue read_only = 3; + google.protobuf.BoolValue read_only = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // Name of this user list. Depending on its access_reason, the user list name // may not be unique (e.g. if access_reason=SHARED) @@ -66,8 +77,7 @@ message UserList { // Membership status of this user list. Indicates whether a user list is open // or active. Only open user lists can accumulate more users and can be // targeted to. - google.ads.googleads.v1.enums.UserListMembershipStatusEnum - .UserListMembershipStatus membership_status = 6; + google.ads.googleads.v1.enums.UserListMembershipStatusEnum.UserListMembershipStatus membership_status = 6; // An ID from external system. It is used by user list sellers to correlate // IDs on their systems. @@ -81,80 +91,73 @@ message UserList { // It'll be ignored for logical_user_list. google.protobuf.Int64Value membership_life_span = 8; - // Estimated number of users in this user list, on the Google Display Network. + // Output only. Estimated number of users in this user list, on the Google Display Network. // This value is null if the number of users has not yet been determined. // // This field is read-only. - google.protobuf.Int64Value size_for_display = 9; + google.protobuf.Int64Value size_for_display = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Size range in terms of number of users of the UserList, on the Google + // Output only. Size range in terms of number of users of the UserList, on the Google // Display Network. // // This field is read-only. - google.ads.googleads.v1.enums.UserListSizeRangeEnum.UserListSizeRange - size_range_for_display = 10; + google.ads.googleads.v1.enums.UserListSizeRangeEnum.UserListSizeRange size_range_for_display = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Estimated number of users in this user list in the google.com domain. + // Output only. Estimated number of users in this user list in the google.com domain. // These are the users available for targeting in Search campaigns. // This value is null if the number of users has not yet been determined. // // This field is read-only. - google.protobuf.Int64Value size_for_search = 11; + google.protobuf.Int64Value size_for_search = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Size range in terms of number of users of the UserList, for Search ads. + // Output only. Size range in terms of number of users of the UserList, for Search ads. // // This field is read-only. - google.ads.googleads.v1.enums.UserListSizeRangeEnum.UserListSizeRange - size_range_for_search = 12; + google.ads.googleads.v1.enums.UserListSizeRangeEnum.UserListSizeRange size_range_for_search = 12 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Type of this list. + // Output only. Type of this list. // // This field is read-only. - google.ads.googleads.v1.enums.UserListTypeEnum.UserListType type = 13; + google.ads.googleads.v1.enums.UserListTypeEnum.UserListType type = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; // Indicating the reason why this user list membership status is closed. It is // only populated on lists that were automatically closed due to inactivity, // and will be cleared once the list membership status becomes open. - google.ads.googleads.v1.enums.UserListClosingReasonEnum.UserListClosingReason - closing_reason = 14; + google.ads.googleads.v1.enums.UserListClosingReasonEnum.UserListClosingReason closing_reason = 14; - // Indicates the reason this account has been granted access to the list. + // Output only. Indicates the reason this account has been granted access to the list. // The reason can be SHARED, OWNED, LICENSED or SUBSCRIBED. // // This field is read-only. - google.ads.googleads.v1.enums.AccessReasonEnum.AccessReason access_reason = - 15; + google.ads.googleads.v1.enums.AccessReasonEnum.AccessReason access_reason = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; // Indicates if this share is still enabled. When a UserList is shared with // the user this field is set to ENABLED. Later the userList owner can decide // to revoke the share and make it DISABLED. // The default value of this field is set to ENABLED. - google.ads.googleads.v1.enums.UserListAccessStatusEnum.UserListAccessStatus - account_user_list_status = 16; + google.ads.googleads.v1.enums.UserListAccessStatusEnum.UserListAccessStatus account_user_list_status = 16; // Indicates if this user list is eligible for Google Search Network. google.protobuf.BoolValue eligible_for_search = 17; - // Indicates this user list is eligible for Google Display Network. + // Output only. Indicates this user list is eligible for Google Display Network. // // This field is read-only. - google.protobuf.BoolValue eligible_for_display = 18; + google.protobuf.BoolValue eligible_for_display = 18 [(google.api.field_behavior) = OUTPUT_ONLY]; // The user list. // // Exactly one must be set. oneof user_list { // User list of CRM users provided by the advertiser. - google.ads.googleads.v1.common.CrmBasedUserListInfo crm_based_user_list = - 19; + google.ads.googleads.v1.common.CrmBasedUserListInfo crm_based_user_list = 19; - // User list which are similar to users from another UserList. + // Output only. User list which are similar to users from another UserList. // These lists are readonly and automatically created by google. - google.ads.googleads.v1.common.SimilarUserListInfo similar_user_list = 20; + google.ads.googleads.v1.common.SimilarUserListInfo similar_user_list = 20 [(google.api.field_behavior) = OUTPUT_ONLY]; // User list generated by a rule. - google.ads.googleads.v1.common.RuleBasedUserListInfo rule_based_user_list = - 21; + google.ads.googleads.v1.common.RuleBasedUserListInfo rule_based_user_list = 21; // User list that is a custom combination of user lists and user interests. google.ads.googleads.v1.common.LogicalUserListInfo logical_user_list = 22; diff --git a/third_party/googleapis/google/ads/googleads/v1/resources/video.proto b/third_party/googleapis/google/ads/googleads/v1/resources/video.proto index 1a75018d6..1201fd7d3 100644 --- a/third_party/googleapis/google/ads/googleads/v1/resources/video.proto +++ b/third_party/googleapis/google/ads/googleads/v1/resources/video.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,15 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.resources; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Resources"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/resources;resources"; @@ -33,21 +34,31 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Resources"; // A video. message Video { - // The resource name of the video. + option (google.api.resource) = { + type: "googleads.googleapis.com/Video" + pattern: "customers/{customer}/videos/{video}" + }; + + // Output only. The resource name of the video. // Video resource names have the form: // // `customers/{customer_id}/videos/{video_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Video" + } + ]; - // The ID of the video. - google.protobuf.StringValue id = 2; + // Output only. The ID of the video. + google.protobuf.StringValue id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The owner channel id of the video. - google.protobuf.StringValue channel_id = 3; + // Output only. The owner channel id of the video. + google.protobuf.StringValue channel_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The duration of the video in milliseconds. - google.protobuf.Int64Value duration_millis = 4; + // Output only. The duration of the video in milliseconds. + google.protobuf.Int64Value duration_millis = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The title of the video. - google.protobuf.StringValue title = 5; + // Output only. The title of the video. + google.protobuf.StringValue title = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/account_budget_proposal_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/account_budget_proposal_service.proto index 288cb317b..db5e82fea 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/account_budget_proposal_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/account_budget_proposal_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/account_budget_proposal.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -38,7 +40,8 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // existing one. // // Reads for account-level budgets managed by these proposals will be -// supported in a future version. Please use BudgetOrderService until then: +// supported in a future version. Until then, please use the +// BudgetOrderService from the AdWords API. Learn more at // https://developers.google.com/adwords/api/docs/guides/budget-order // // Mutates: @@ -46,40 +49,47 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // UPDATE operations aren't supported. // The REMOVE operation cancels a pending proposal. service AccountBudgetProposalService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns an account-level budget proposal in full detail. - rpc GetAccountBudgetProposal(GetAccountBudgetProposalRequest) - returns (google.ads.googleads.v1.resources.AccountBudgetProposal) { + rpc GetAccountBudgetProposal(GetAccountBudgetProposalRequest) returns (google.ads.googleads.v1.resources.AccountBudgetProposal) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/accountBudgetProposals/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes account budget proposals. Operation statuses // are returned. - rpc MutateAccountBudgetProposal(MutateAccountBudgetProposalRequest) - returns (MutateAccountBudgetProposalResponse) { + rpc MutateAccountBudgetProposal(MutateAccountBudgetProposalRequest) returns (MutateAccountBudgetProposalResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/accountBudgetProposals:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operation"; } } // Request message for // [AccountBudgetProposalService.GetAccountBudgetProposal][google.ads.googleads.v1.services.AccountBudgetProposalService.GetAccountBudgetProposal]. message GetAccountBudgetProposalRequest { - // The resource name of the account-level budget proposal to fetch. - string resource_name = 1; + // Required. The resource name of the account-level budget proposal to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AccountBudgetProposal" + } + ]; } // Request message for // [AccountBudgetProposalService.MutateAccountBudgetProposal][google.ads.googleads.v1.services.AccountBudgetProposalService.MutateAccountBudgetProposal]. message MutateAccountBudgetProposalRequest { - // The ID of the customer. - string customer_id = 1; + // Required. The ID of the customer. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The operation to perform on an individual account-level budget proposal. - AccountBudgetProposalOperation operation = 2; + // Required. The operation to perform on an individual account-level budget proposal. + AccountBudgetProposalOperation operation = 2 [(google.api.field_behavior) = REQUIRED]; // If true, the request is validated but not executed. Only errors are // returned, not results. @@ -108,7 +118,6 @@ message AccountBudgetProposalOperation { // Remove operation: A resource name for the removed proposal is expected, // in this format: // - // // `customers/{customer_id}/accountBudgetProposals/{account_budget_proposal_id}` // A request may be cancelled iff it is pending. string remove = 1; diff --git a/third_party/googleapis/google/ads/googleads/v1/services/account_budget_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/account_budget_service.proto index b8c3adb55..5148e8a2e 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/account_budget_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/account_budget_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/account_budget.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -35,18 +37,25 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // // Account-level budgets are mutated by creating proposal resources. service AccountBudgetService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns an account-level budget in full detail. - rpc GetAccountBudget(GetAccountBudgetRequest) - returns (google.ads.googleads.v1.resources.AccountBudget) { + rpc GetAccountBudget(GetAccountBudgetRequest) returns (google.ads.googleads.v1.resources.AccountBudget) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/accountBudgets/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for // [AccountBudgetService.GetAccountBudget][google.ads.googleads.v1.services.AccountBudgetService.GetAccountBudget]. message GetAccountBudgetRequest { - // The resource name of the account-level budget to fetch. - string resource_name = 1; + // Required. The resource name of the account-level budget to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AccountBudget" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/ad_group_ad_label_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/ad_group_ad_label_service.proto index 1d2458203..8f6970c03 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/ad_group_ad_label_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/ad_group_ad_label_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,7 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/ad_group_ad_label.proto"; import "google/api/annotations.proto"; -import "google/protobuf/wrappers.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -35,40 +36,45 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage labels on ad group ads. service AdGroupAdLabelService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested ad group ad label in full detail. - rpc GetAdGroupAdLabel(GetAdGroupAdLabelRequest) - returns (google.ads.googleads.v1.resources.AdGroupAdLabel) { + rpc GetAdGroupAdLabel(GetAdGroupAdLabelRequest) returns (google.ads.googleads.v1.resources.AdGroupAdLabel) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/adGroupAdLabels/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates and removes ad group ad labels. // Operation statuses are returned. - rpc MutateAdGroupAdLabels(MutateAdGroupAdLabelsRequest) - returns (MutateAdGroupAdLabelsResponse) { + rpc MutateAdGroupAdLabels(MutateAdGroupAdLabelsRequest) returns (MutateAdGroupAdLabelsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/adGroupAdLabels:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [AdGroupAdLabelService.GetAdGroupAdLabel][google.ads.googleads.v1.services.AdGroupAdLabelService.GetAdGroupAdLabel]. +// Request message for [AdGroupAdLabelService.GetAdGroupAdLabel][google.ads.googleads.v1.services.AdGroupAdLabelService.GetAdGroupAdLabel]. message GetAdGroupAdLabelRequest { - // The resource name of the ad group ad label to fetch. - string resource_name = 1; + // Required. The resource name of the ad group ad label to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAdLabel" + } + ]; } -// Request message for -// [AdGroupAdLabelService.MutateAdGroupAdLabels][google.ads.googleads.v1.services.AdGroupAdLabelService.MutateAdGroupAdLabels]. +// Request message for [AdGroupAdLabelService.MutateAdGroupAdLabels][google.ads.googleads.v1.services.AdGroupAdLabelService.MutateAdGroupAdLabels]. message MutateAdGroupAdLabelsRequest { - // ID of the customer whose ad group ad labels are being modified. - string customer_id = 1; + // Required. ID of the customer whose ad group ad labels are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on ad group ad labels. - repeated AdGroupAdLabelOperation operations = 2; + // Required. The list of operations to perform on ad group ad labels. + repeated AdGroupAdLabelOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/ad_group_ad_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/ad_group_ad_service.proto index 93c441133..d82723cb7 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/ad_group_ad_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/ad_group_ad_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,8 +19,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/common/policy.proto"; import "google/ads/googleads/v1/resources/ad_group_ad.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -37,39 +38,44 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage ads in an ad group. service AdGroupAdService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested ad in full detail. - rpc GetAdGroupAd(GetAdGroupAdRequest) - returns (google.ads.googleads.v1.resources.AdGroupAd) { + rpc GetAdGroupAd(GetAdGroupAdRequest) returns (google.ads.googleads.v1.resources.AdGroupAd) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/adGroupAds/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes ads. Operation statuses are returned. - rpc MutateAdGroupAds(MutateAdGroupAdsRequest) - returns (MutateAdGroupAdsResponse) { + rpc MutateAdGroupAds(MutateAdGroupAdsRequest) returns (MutateAdGroupAdsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/adGroupAds:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [AdGroupAdService.GetAdGroupAd][google.ads.googleads.v1.services.AdGroupAdService.GetAdGroupAd]. +// Request message for [AdGroupAdService.GetAdGroupAd][google.ads.googleads.v1.services.AdGroupAdService.GetAdGroupAd]. message GetAdGroupAdRequest { - // The resource name of the ad to fetch. - string resource_name = 1; + // Required. The resource name of the ad to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAd" + } + ]; } -// Request message for -// [AdGroupAdService.MutateAdGroupAds][google.ads.googleads.v1.services.AdGroupAdService.MutateAdGroupAds]. +// Request message for [AdGroupAdService.MutateAdGroupAds][google.ads.googleads.v1.services.AdGroupAdService.MutateAdGroupAds]. message MutateAdGroupAdsRequest { - // The ID of the customer whose ads are being modified. - string customer_id = 1; + // Required. The ID of the customer whose ads are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual ads. - repeated AdGroupAdOperation operations = 2; + // Required. The list of operations to perform on individual ads. + repeated AdGroupAdOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried @@ -88,8 +94,7 @@ message AdGroupAdOperation { google.protobuf.FieldMask update_mask = 4; // Configuration for how policies are validated. - google.ads.googleads.v1.common.PolicyValidationParameter - policy_validation_parameter = 5; + google.ads.googleads.v1.common.PolicyValidationParameter policy_validation_parameter = 5; // The mutate operation. oneof operation { diff --git a/third_party/googleapis/google/ads/googleads/v1/services/ad_group_audience_view_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/ad_group_audience_view_service.proto index 213e6374b..6dfb2edde 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/ad_group_audience_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/ad_group_audience_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/ad_group_audience_view.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,17 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage ad group audience views. service AdGroupAudienceViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested ad group audience view in full detail. - rpc GetAdGroupAudienceView(GetAdGroupAudienceViewRequest) - returns (google.ads.googleads.v1.resources.AdGroupAudienceView) { + rpc GetAdGroupAudienceView(GetAdGroupAudienceViewRequest) returns (google.ads.googleads.v1.resources.AdGroupAudienceView) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/adGroupAudienceViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [AdGroupAudienceViewService.GetAdGoupAudienceView][]. message GetAdGroupAudienceViewRequest { - // The resource name of the ad group audience view to fetch. - string resource_name = 1; + // Required. The resource name of the ad group audience view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAudienceView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/ad_group_bid_modifier_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/ad_group_bid_modifier_service.proto index db02be227..d26b7b37c 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/ad_group_bid_modifier_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/ad_group_bid_modifier_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/ad_group_bid_modifier.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -36,40 +37,45 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage ad group bid modifiers. service AdGroupBidModifierService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested ad group bid modifier in full detail. - rpc GetAdGroupBidModifier(GetAdGroupBidModifierRequest) - returns (google.ads.googleads.v1.resources.AdGroupBidModifier) { + rpc GetAdGroupBidModifier(GetAdGroupBidModifierRequest) returns (google.ads.googleads.v1.resources.AdGroupBidModifier) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/adGroupBidModifiers/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes ad group bid modifiers. // Operation statuses are returned. - rpc MutateAdGroupBidModifiers(MutateAdGroupBidModifiersRequest) - returns (MutateAdGroupBidModifiersResponse) { + rpc MutateAdGroupBidModifiers(MutateAdGroupBidModifiersRequest) returns (MutateAdGroupBidModifiersResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/adGroupBidModifiers:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [AdGroupBidModifierService.GetAdGroupBidModifier][google.ads.googleads.v1.services.AdGroupBidModifierService.GetAdGroupBidModifier]. +// Request message for [AdGroupBidModifierService.GetAdGroupBidModifier][google.ads.googleads.v1.services.AdGroupBidModifierService.GetAdGroupBidModifier]. message GetAdGroupBidModifierRequest { - // The resource name of the ad group bid modifier to fetch. - string resource_name = 1; + // Required. The resource name of the ad group bid modifier to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupBidModifier" + } + ]; } -// Request message for -// [AdGroupBidModifierService.MutateAdGroupBidModifiers][google.ads.googleads.v1.services.AdGroupBidModifierService.MutateAdGroupBidModifiers]. +// Request message for [AdGroupBidModifierService.MutateAdGroupBidModifiers][google.ads.googleads.v1.services.AdGroupBidModifierService.MutateAdGroupBidModifiers]. message MutateAdGroupBidModifiersRequest { - // ID of the customer whose ad group bid modifiers are being modified. - string customer_id = 1; + // Required. ID of the customer whose ad group bid modifiers are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual ad group bid modifiers. - repeated AdGroupBidModifierOperation operations = 2; + // Required. The list of operations to perform on individual ad group bid modifiers. + repeated AdGroupBidModifierOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried @@ -100,7 +106,6 @@ message AdGroupBidModifierOperation { // Remove operation: A resource name for the removed ad group bid modifier // is expected, in this format: // - // // `customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}` string remove = 3; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/ad_group_criterion_label_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/ad_group_criterion_label_service.proto index e3ba75b10..584938396 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/ad_group_criterion_label_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/ad_group_criterion_label_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,7 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/ad_group_criterion_label.proto"; import "google/api/annotations.proto"; -import "google/protobuf/wrappers.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -35,40 +36,47 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage labels on ad group criteria. service AdGroupCriterionLabelService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested ad group criterion label in full detail. - rpc GetAdGroupCriterionLabel(GetAdGroupCriterionLabelRequest) - returns (google.ads.googleads.v1.resources.AdGroupCriterionLabel) { + rpc GetAdGroupCriterionLabel(GetAdGroupCriterionLabelRequest) returns (google.ads.googleads.v1.resources.AdGroupCriterionLabel) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/adGroupCriterionLabels/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates and removes ad group criterion labels. // Operation statuses are returned. - rpc MutateAdGroupCriterionLabels(MutateAdGroupCriterionLabelsRequest) - returns (MutateAdGroupCriterionLabelsResponse) { + rpc MutateAdGroupCriterionLabels(MutateAdGroupCriterionLabelsRequest) returns (MutateAdGroupCriterionLabelsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/adGroupCriterionLabels:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for // [AdGroupCriterionLabelService.GetAdGroupCriterionLabel][google.ads.googleads.v1.services.AdGroupCriterionLabelService.GetAdGroupCriterionLabel]. message GetAdGroupCriterionLabelRequest { - // The resource name of the ad group criterion label to fetch. - string resource_name = 1; + // Required. The resource name of the ad group criterion label to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterionLabel" + } + ]; } // Request message for // [AdGroupCriterionLabelService.MutateAdGroupCriterionLabels][google.ads.googleads.v1.services.AdGroupCriterionLabelService.MutateAdGroupCriterionLabels]. message MutateAdGroupCriterionLabelsRequest { - // ID of the customer whose ad group criterion labels are being modified. - string customer_id = 1; + // Required. ID of the customer whose ad group criterion labels are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on ad group criterion labels. - repeated AdGroupCriterionLabelOperation operations = 2; + // Required. The list of operations to perform on ad group criterion labels. + repeated AdGroupCriterionLabelOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried @@ -92,7 +100,6 @@ message AdGroupCriterionLabelOperation { // Remove operation: A resource name for the ad group criterion label // being removed, in this format: // - // // `customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}` string remove = 2; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/ad_group_criterion_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/ad_group_criterion_service.proto index 3a3a2ff4c..94590dad4 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/ad_group_criterion_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/ad_group_criterion_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,8 +19,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/common/policy.proto"; import "google/ads/googleads/v1/resources/ad_group_criterion.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -37,39 +38,44 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage ad group criteria. service AdGroupCriterionService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested criterion in full detail. - rpc GetAdGroupCriterion(GetAdGroupCriterionRequest) - returns (google.ads.googleads.v1.resources.AdGroupCriterion) { + rpc GetAdGroupCriterion(GetAdGroupCriterionRequest) returns (google.ads.googleads.v1.resources.AdGroupCriterion) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/adGroupCriteria/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes criteria. Operation statuses are returned. - rpc MutateAdGroupCriteria(MutateAdGroupCriteriaRequest) - returns (MutateAdGroupCriteriaResponse) { + rpc MutateAdGroupCriteria(MutateAdGroupCriteriaRequest) returns (MutateAdGroupCriteriaResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/adGroupCriteria:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [AdGroupCriterionService.GetAdGroupCriterion][google.ads.googleads.v1.services.AdGroupCriterionService.GetAdGroupCriterion]. +// Request message for [AdGroupCriterionService.GetAdGroupCriterion][google.ads.googleads.v1.services.AdGroupCriterionService.GetAdGroupCriterion]. message GetAdGroupCriterionRequest { - // The resource name of the criterion to fetch. - string resource_name = 1; + // Required. The resource name of the criterion to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterion" + } + ]; } -// Request message for -// [AdGroupCriterionService.MutateAdGroupCriteria][google.ads.googleads.v1.services.AdGroupCriterionService.MutateAdGroupCriteria]. +// Request message for [AdGroupCriterionService.MutateAdGroupCriteria][google.ads.googleads.v1.services.AdGroupCriterionService.MutateAdGroupCriteria]. message MutateAdGroupCriteriaRequest { - // ID of the customer whose criteria are being modified. - string customer_id = 1; + // Required. ID of the customer whose criteria are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual criteria. - repeated AdGroupCriterionOperation operations = 2; + // Required. The list of operations to perform on individual criteria. + repeated AdGroupCriterionOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried @@ -96,8 +102,7 @@ message AdGroupCriterionOperation { // to serve. They may begin serving at a later time due to a change in // policies, re-review of the resource, or a change in advertiser // certificates. - repeated google.ads.googleads.v1.common.PolicyViolationKey - exempt_policy_violation_keys = 5; + repeated google.ads.googleads.v1.common.PolicyViolationKey exempt_policy_violation_keys = 5; // The mutate operation. oneof operation { diff --git a/third_party/googleapis/google/ads/googleads/v1/services/ad_group_criterion_simulation_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/ad_group_criterion_simulation_service.proto index e51aeb1d4..392e80dab 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/ad_group_criterion_simulation_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/ad_group_criterion_simulation_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/ad_group_criterion_simulation.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,25 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch ad group criterion simulations. service AdGroupCriterionSimulationService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested ad group criterion simulation in full detail. - rpc GetAdGroupCriterionSimulation(GetAdGroupCriterionSimulationRequest) - returns (google.ads.googleads.v1.resources.AdGroupCriterionSimulation) { + rpc GetAdGroupCriterionSimulation(GetAdGroupCriterionSimulationRequest) returns (google.ads.googleads.v1.resources.AdGroupCriterionSimulation) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/adGroupCriterionSimulations/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for // [AdGroupCriterionSimulationService.GetAdGroupCriterionSimulation][google.ads.googleads.v1.services.AdGroupCriterionSimulationService.GetAdGroupCriterionSimulation]. message GetAdGroupCriterionSimulationRequest { - // The resource name of the ad group criterion simulation to fetch. - string resource_name = 1; + // Required. The resource name of the ad group criterion simulation to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterionSimulation" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/ad_group_extension_setting_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/ad_group_extension_setting_service.proto index b7496dd8b..cc9e22afb 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/ad_group_extension_setting_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/ad_group_extension_setting_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/ad_group_extension_setting.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -36,42 +37,49 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage ad group extension settings. service AdGroupExtensionSettingService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested ad group extension setting in full detail. - rpc GetAdGroupExtensionSetting(GetAdGroupExtensionSettingRequest) - returns (google.ads.googleads.v1.resources.AdGroupExtensionSetting) { + rpc GetAdGroupExtensionSetting(GetAdGroupExtensionSettingRequest) returns (google.ads.googleads.v1.resources.AdGroupExtensionSetting) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/adGroupExtensionSettings/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes ad group extension settings. Operation // statuses are returned. - rpc MutateAdGroupExtensionSettings(MutateAdGroupExtensionSettingsRequest) - returns (MutateAdGroupExtensionSettingsResponse) { + rpc MutateAdGroupExtensionSettings(MutateAdGroupExtensionSettingsRequest) returns (MutateAdGroupExtensionSettingsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/adGroupExtensionSettings:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for // [AdGroupExtensionSettingService.GetAdGroupExtensionSetting][google.ads.googleads.v1.services.AdGroupExtensionSettingService.GetAdGroupExtensionSetting]. message GetAdGroupExtensionSettingRequest { - // The resource name of the ad group extension setting to fetch. - string resource_name = 1; + // Required. The resource name of the ad group extension setting to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupExtensionSetting" + } + ]; } // Request message for // [AdGroupExtensionSettingService.MutateAdGroupExtensionSettings][google.ads.googleads.v1.services.AdGroupExtensionSettingService.MutateAdGroupExtensionSettings]. message MutateAdGroupExtensionSettingsRequest { - // The ID of the customer whose ad group extension settings are being + // Required. The ID of the customer whose ad group extension settings are being // modified. - string customer_id = 1; + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual ad group extension + // Required. The list of operations to perform on individual ad group extension // settings. - repeated AdGroupExtensionSettingOperation operations = 2; + repeated AdGroupExtensionSettingOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried @@ -102,7 +110,6 @@ message AdGroupExtensionSettingOperation { // Remove operation: A resource name for the removed ad group extension // setting is expected, in this format: // - // // `customers/{customer_id}/adGroupExtensionSettings/{ad_group_id}~{extension_type}` string remove = 3; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/ad_group_feed_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/ad_group_feed_service.proto index 5780852bd..eae9ae2cd 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/ad_group_feed_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/ad_group_feed_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/ad_group_feed.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -36,40 +37,45 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage ad group feeds. service AdGroupFeedService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested ad group feed in full detail. - rpc GetAdGroupFeed(GetAdGroupFeedRequest) - returns (google.ads.googleads.v1.resources.AdGroupFeed) { + rpc GetAdGroupFeed(GetAdGroupFeedRequest) returns (google.ads.googleads.v1.resources.AdGroupFeed) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/adGroupFeeds/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes ad group feeds. Operation statuses are // returned. - rpc MutateAdGroupFeeds(MutateAdGroupFeedsRequest) - returns (MutateAdGroupFeedsResponse) { + rpc MutateAdGroupFeeds(MutateAdGroupFeedsRequest) returns (MutateAdGroupFeedsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/adGroupFeeds:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [AdGroupFeedService.GetAdGroupFeed][google.ads.googleads.v1.services.AdGroupFeedService.GetAdGroupFeed]. +// Request message for [AdGroupFeedService.GetAdGroupFeed][google.ads.googleads.v1.services.AdGroupFeedService.GetAdGroupFeed]. message GetAdGroupFeedRequest { - // The resource name of the ad group feed to fetch. - string resource_name = 1; + // Required. The resource name of the ad group feed to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupFeed" + } + ]; } -// Request message for -// [AdGroupFeedService.MutateAdGroupFeeds][google.ads.googleads.v1.services.AdGroupFeedService.MutateAdGroupFeeds]. +// Request message for [AdGroupFeedService.MutateAdGroupFeeds][google.ads.googleads.v1.services.AdGroupFeedService.MutateAdGroupFeeds]. message MutateAdGroupFeedsRequest { - // The ID of the customer whose ad group feeds are being modified. - string customer_id = 1; + // Required. The ID of the customer whose ad group feeds are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual ad group feeds. - repeated AdGroupFeedOperation operations = 2; + // Required. The list of operations to perform on individual ad group feeds. + repeated AdGroupFeedOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/ad_group_label_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/ad_group_label_service.proto index c6c71ef62..50581bbc3 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/ad_group_label_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/ad_group_label_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,7 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/ad_group_label.proto"; import "google/api/annotations.proto"; -import "google/protobuf/wrappers.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -35,40 +36,45 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage labels on ad groups. service AdGroupLabelService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested ad group label in full detail. - rpc GetAdGroupLabel(GetAdGroupLabelRequest) - returns (google.ads.googleads.v1.resources.AdGroupLabel) { + rpc GetAdGroupLabel(GetAdGroupLabelRequest) returns (google.ads.googleads.v1.resources.AdGroupLabel) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/adGroupLabels/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates and removes ad group labels. // Operation statuses are returned. - rpc MutateAdGroupLabels(MutateAdGroupLabelsRequest) - returns (MutateAdGroupLabelsResponse) { + rpc MutateAdGroupLabels(MutateAdGroupLabelsRequest) returns (MutateAdGroupLabelsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/adGroupLabels:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [AdGroupLabelService.GetAdGroupLabel][google.ads.googleads.v1.services.AdGroupLabelService.GetAdGroupLabel]. +// Request message for [AdGroupLabelService.GetAdGroupLabel][google.ads.googleads.v1.services.AdGroupLabelService.GetAdGroupLabel]. message GetAdGroupLabelRequest { - // The resource name of the ad group label to fetch. - string resource_name = 1; + // Required. The resource name of the ad group label to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupLabel" + } + ]; } -// Request message for -// [AdGroupLabelService.MutateAdGroupLabels][google.ads.googleads.v1.services.AdGroupLabelService.MutateAdGroupLabels]. +// Request message for [AdGroupLabelService.MutateAdGroupLabels][google.ads.googleads.v1.services.AdGroupLabelService.MutateAdGroupLabels]. message MutateAdGroupLabelsRequest { - // ID of the customer whose ad group labels are being modified. - string customer_id = 1; + // Required. ID of the customer whose ad group labels are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on ad group labels. - repeated AdGroupLabelOperation operations = 2; + // Required. The list of operations to perform on ad group labels. + repeated AdGroupLabelOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/ad_group_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/ad_group_service.proto index 4ec9aaa0f..9da36c765 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/ad_group_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/ad_group_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/ad_group.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -36,12 +37,14 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage ad groups. service AdGroupService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested ad group in full detail. - rpc GetAdGroup(GetAdGroupRequest) - returns (google.ads.googleads.v1.resources.AdGroup) { + rpc GetAdGroup(GetAdGroupRequest) returns (google.ads.googleads.v1.resources.AdGroup) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/adGroups/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes ad groups. Operation statuses are returned. @@ -50,24 +53,28 @@ service AdGroupService { post: "/v1/customers/{customer_id=*}/adGroups:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [AdGroupService.GetAdGroup][google.ads.googleads.v1.services.AdGroupService.GetAdGroup]. +// Request message for [AdGroupService.GetAdGroup][google.ads.googleads.v1.services.AdGroupService.GetAdGroup]. message GetAdGroupRequest { - // The resource name of the ad group to fetch. - string resource_name = 1; + // Required. The resource name of the ad group to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; } -// Request message for -// [AdGroupService.MutateAdGroups][google.ads.googleads.v1.services.AdGroupService.MutateAdGroups]. +// Request message for [AdGroupService.MutateAdGroups][google.ads.googleads.v1.services.AdGroupService.MutateAdGroups]. message MutateAdGroupsRequest { - // The ID of the customer whose ad groups are being modified. - string customer_id = 1; + // Required. The ID of the customer whose ad groups are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual ad groups. - repeated AdGroupOperation operations = 2; + // Required. The list of operations to perform on individual ad groups. + repeated AdGroupOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/ad_group_simulation_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/ad_group_simulation_service.proto index b178f2e70..916ce3032 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/ad_group_simulation_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/ad_group_simulation_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/ad_group_simulation.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch ad group simulations. service AdGroupSimulationService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested ad group simulation in full detail. - rpc GetAdGroupSimulation(GetAdGroupSimulationRequest) - returns (google.ads.googleads.v1.resources.AdGroupSimulation) { + rpc GetAdGroupSimulation(GetAdGroupSimulationRequest) returns (google.ads.googleads.v1.resources.AdGroupSimulation) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/adGroupSimulations/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [AdGroupSimulationService.GetAdGroupSimulation][google.ads.googleads.v1.services.AdGroupSimulationService.GetAdGroupSimulation]. +// Request message for [AdGroupSimulationService.GetAdGroupSimulation][google.ads.googleads.v1.services.AdGroupSimulationService.GetAdGroupSimulation]. message GetAdGroupSimulationRequest { - // The resource name of the ad group simulation to fetch. - string resource_name = 1; + // Required. The resource name of the ad group simulation to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupSimulation" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/ad_parameter_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/ad_parameter_service.proto index 34055da79..a5f500e92 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/ad_parameter_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/ad_parameter_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/ad_parameter.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -36,40 +37,45 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage ad parameters. service AdParameterService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested ad parameter in full detail. - rpc GetAdParameter(GetAdParameterRequest) - returns (google.ads.googleads.v1.resources.AdParameter) { + rpc GetAdParameter(GetAdParameterRequest) returns (google.ads.googleads.v1.resources.AdParameter) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/adParameters/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes ad parameters. Operation statuses are // returned. - rpc MutateAdParameters(MutateAdParametersRequest) - returns (MutateAdParametersResponse) { + rpc MutateAdParameters(MutateAdParametersRequest) returns (MutateAdParametersResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/adParameters:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [AdParameterService.GetAdParameter][google.ads.googleads.v1.services.AdParameterService.GetAdParameter] +// Request message for [AdParameterService.GetAdParameter][google.ads.googleads.v1.services.AdParameterService.GetAdParameter] message GetAdParameterRequest { - // The resource name of the ad parameter to fetch. - string resource_name = 1; + // Required. The resource name of the ad parameter to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdParameter" + } + ]; } -// Request message for -// [AdParameterService.MutateAdParameters][google.ads.googleads.v1.services.AdParameterService.MutateAdParameters] +// Request message for [AdParameterService.MutateAdParameters][google.ads.googleads.v1.services.AdParameterService.MutateAdParameters] message MutateAdParametersRequest { - // The ID of the customer whose ad parameters are being modified. - string customer_id = 1; + // Required. The ID of the customer whose ad parameters are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual ad parameters. - repeated AdParameterOperation operations = 2; + // Required. The list of operations to perform on individual ad parameters. + repeated AdParameterOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried @@ -99,7 +105,6 @@ message AdParameterOperation { // Remove operation: A resource name for the ad parameter to remove is // expected in this format: // - // // `customers/{customer_id}/adParameters/{ad_group_id}~{criterion_id}~{parameter_index}` string remove = 3; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/ad_schedule_view_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/ad_schedule_view_service.proto index 68ad7a99f..12786018c 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/ad_schedule_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/ad_schedule_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/ad_schedule_view.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch ad schedule views. service AdScheduleViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested ad schedule view in full detail. - rpc GetAdScheduleView(GetAdScheduleViewRequest) - returns (google.ads.googleads.v1.resources.AdScheduleView) { + rpc GetAdScheduleView(GetAdScheduleViewRequest) returns (google.ads.googleads.v1.resources.AdScheduleView) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/adScheduleViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [AdScheduleViewService.GetAdScheduleView][google.ads.googleads.v1.services.AdScheduleViewService.GetAdScheduleView]. +// Request message for [AdScheduleViewService.GetAdScheduleView][google.ads.googleads.v1.services.AdScheduleViewService.GetAdScheduleView]. message GetAdScheduleViewRequest { - // The resource name of the ad schedule view to fetch. - string resource_name = 1; + // Required. The resource name of the ad schedule view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdScheduleView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/age_range_view_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/age_range_view_service.proto index 3b895b801..9df60b5b3 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/age_range_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/age_range_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/age_range_view.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage age range views. service AgeRangeViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested age range view in full detail. - rpc GetAgeRangeView(GetAgeRangeViewRequest) - returns (google.ads.googleads.v1.resources.AgeRangeView) { + rpc GetAgeRangeView(GetAgeRangeViewRequest) returns (google.ads.googleads.v1.resources.AgeRangeView) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/ageRangeViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [AgeRangeViewService.GetAgeRangeView][google.ads.googleads.v1.services.AgeRangeViewService.GetAgeRangeView]. +// Request message for [AgeRangeViewService.GetAgeRangeView][google.ads.googleads.v1.services.AgeRangeViewService.GetAgeRangeView]. message GetAgeRangeViewRequest { - // The resource name of the age range view to fetch. - string resource_name = 1; + // Required. The resource name of the age range view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AgeRangeView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/asset_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/asset_service.proto index 92c0017b9..4c6a79e0d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/asset_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/asset_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/asset.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -35,12 +37,14 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // YoutubeVideoAsset, MediaBundleAsset and ImageAsset. TextAsset should be // created with Ad inline. service AssetService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested asset in full detail. - rpc GetAsset(GetAssetRequest) - returns (google.ads.googleads.v1.resources.Asset) { + rpc GetAsset(GetAssetRequest) returns (google.ads.googleads.v1.resources.Asset) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/assets/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates assets. Operation statuses are returned. @@ -49,29 +53,33 @@ service AssetService { post: "/v1/customers/{customer_id=*}/assets:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [AssetService.GetAsset][google.ads.googleads.v1.services.AssetService.GetAsset] +// Request message for [AssetService.GetAsset][google.ads.googleads.v1.services.AssetService.GetAsset] message GetAssetRequest { - // The resource name of the asset to fetch. - string resource_name = 1; + // Required. The resource name of the asset to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Asset" + } + ]; } -// Request message for -// [AssetService.MutateAssets][google.ads.googleads.v1.services.AssetService.MutateAssets] +// Request message for [AssetService.MutateAssets][google.ads.googleads.v1.services.AssetService.MutateAssets] message MutateAssetsRequest { - // The ID of the customer whose assets are being modified. - string customer_id = 1; + // Required. The ID of the customer whose assets are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual assets. - repeated AssetOperation operations = 2; + // Required. The list of operations to perform on individual assets. + repeated AssetOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; } // A single operation to create an asset. Supported asset types are -// YoutubeVideoAsset, MediaBundleAsset and ImageAsset. TextAsset should be -// created with Ad inline. +// YoutubeVideoAsset, MediaBundleAsset, ImageAsset, and LeadFormAsset. TextAsset +// should be created with Ad inline. message AssetOperation { // The mutate operation. oneof operation { diff --git a/third_party/googleapis/google/ads/googleads/v1/services/bidding_strategy_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/bidding_strategy_service.proto index 196a19f47..a7ebf6f92 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/bidding_strategy_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/bidding_strategy_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/bidding_strategy.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -36,40 +37,45 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage bidding strategies. service BiddingStrategyService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested bidding strategy in full detail. - rpc GetBiddingStrategy(GetBiddingStrategyRequest) - returns (google.ads.googleads.v1.resources.BiddingStrategy) { + rpc GetBiddingStrategy(GetBiddingStrategyRequest) returns (google.ads.googleads.v1.resources.BiddingStrategy) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/biddingStrategies/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes bidding strategies. Operation statuses are // returned. - rpc MutateBiddingStrategies(MutateBiddingStrategiesRequest) - returns (MutateBiddingStrategiesResponse) { + rpc MutateBiddingStrategies(MutateBiddingStrategiesRequest) returns (MutateBiddingStrategiesResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/biddingStrategies:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [BiddingStrategyService.GetBiddingStrategy][google.ads.googleads.v1.services.BiddingStrategyService.GetBiddingStrategy]. +// Request message for [BiddingStrategyService.GetBiddingStrategy][google.ads.googleads.v1.services.BiddingStrategyService.GetBiddingStrategy]. message GetBiddingStrategyRequest { - // The resource name of the bidding strategy to fetch. - string resource_name = 1; + // Required. The resource name of the bidding strategy to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/BiddingStrategy" + } + ]; } -// Request message for -// [BiddingStrategyService.MutateBiddingStrategies][google.ads.googleads.v1.services.BiddingStrategyService.MutateBiddingStrategies]. +// Request message for [BiddingStrategyService.MutateBiddingStrategies][google.ads.googleads.v1.services.BiddingStrategyService.MutateBiddingStrategies]. message MutateBiddingStrategiesRequest { - // The ID of the customer whose bidding strategies are being modified. - string customer_id = 1; + // Required. The ID of the customer whose bidding strategies are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual bidding strategies. - repeated BiddingStrategyOperation operations = 2; + // Required. The list of operations to perform on individual bidding strategies. + repeated BiddingStrategyOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/billing_setup_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/billing_setup_service.proto index 46653674a..dfb9b8dd0 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/billing_setup_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/billing_setup_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/billing_setup.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,46 +35,53 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // A service for designating the business entity responsible for accrued costs. // -// A billing setup is associated with a Payments account. Billing-related -// activity for all billing setups associated with a particular Payments account +// A billing setup is associated with a payments account. Billing-related +// activity for all billing setups associated with a particular payments account // will appear on a single invoice generated monthly. // // Mutates: // The REMOVE operation cancels a pending billing setup. // The CREATE operation creates a new billing setup. service BillingSetupService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns a billing setup. - rpc GetBillingSetup(GetBillingSetupRequest) - returns (google.ads.googleads.v1.resources.BillingSetup) { + rpc GetBillingSetup(GetBillingSetupRequest) returns (google.ads.googleads.v1.resources.BillingSetup) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/billingSetups/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates a billing setup, or cancels an existing billing setup. - rpc MutateBillingSetup(MutateBillingSetupRequest) - returns (MutateBillingSetupResponse) { + rpc MutateBillingSetup(MutateBillingSetupRequest) returns (MutateBillingSetupResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/billingSetups:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operation"; } } // Request message for // [BillingSetupService.GetBillingSetup][google.ads.googleads.v1.services.BillingSetupService.GetBillingSetup]. message GetBillingSetupRequest { - // The resource name of the billing setup to fetch. - string resource_name = 1; + // Required. The resource name of the billing setup to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/BillingSetup" + } + ]; } // Request message for billing setup mutate operations. message MutateBillingSetupRequest { - // Id of the customer to apply the billing setup mutate operation to. - string customer_id = 1; + // Required. Id of the customer to apply the billing setup mutate operation to. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The operation to perform. - BillingSetupOperation operation = 2; + // Required. The operation to perform. + BillingSetupOperation operation = 2 [(google.api.field_behavior) = REQUIRED]; } // A single operation on a billing setup, which describes the cancellation of an diff --git a/third_party/googleapis/google/ads/googleads/v1/services/campaign_audience_view_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/campaign_audience_view_service.proto index fc59212a7..56583654a 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/campaign_audience_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/campaign_audience_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/campaign_audience_view.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage campaign audience views. service CampaignAudienceViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested campaign audience view in full detail. - rpc GetCampaignAudienceView(GetCampaignAudienceViewRequest) - returns (google.ads.googleads.v1.resources.CampaignAudienceView) { + rpc GetCampaignAudienceView(GetCampaignAudienceViewRequest) returns (google.ads.googleads.v1.resources.CampaignAudienceView) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/campaignAudienceViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [CampaignAudienceViewService.GetCampaignAudienceView][google.ads.googleads.v1.services.CampaignAudienceViewService.GetCampaignAudienceView]. +// Request message for [CampaignAudienceViewService.GetCampaignAudienceView][google.ads.googleads.v1.services.CampaignAudienceViewService.GetCampaignAudienceView]. message GetCampaignAudienceViewRequest { - // The resource name of the campaign audience view to fetch. - string resource_name = 1; + // Required. The resource name of the campaign audience view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignAudienceView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/campaign_bid_modifier_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/campaign_bid_modifier_service.proto index c5c374d9a..0ea62c2a2 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/campaign_bid_modifier_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/campaign_bid_modifier_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/campaign_bid_modifier.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -36,39 +37,45 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage campaign bid modifiers. service CampaignBidModifierService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested campaign bid modifier in full detail. - rpc GetCampaignBidModifier(GetCampaignBidModifierRequest) - returns (google.ads.googleads.v1.resources.CampaignBidModifier) { + rpc GetCampaignBidModifier(GetCampaignBidModifierRequest) returns (google.ads.googleads.v1.resources.CampaignBidModifier) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/campaignBidModifiers/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes campaign bid modifiers. // Operation statuses are returned. - rpc MutateCampaignBidModifiers(MutateCampaignBidModifiersRequest) - returns (MutateCampaignBidModifiersResponse) { + rpc MutateCampaignBidModifiers(MutateCampaignBidModifiersRequest) returns (MutateCampaignBidModifiersResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/campaignBidModifiers:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [CampaignBidModifierService.GetCampaignBidModifier][google.ads.googleads.v1.services.CampaignBidModifierService.GetCampaignBidModifier]. +// Request message for [CampaignBidModifierService.GetCampaignBidModifier][google.ads.googleads.v1.services.CampaignBidModifierService.GetCampaignBidModifier]. message GetCampaignBidModifierRequest { - // The resource name of the campaign bid modifier to fetch. - string resource_name = 1; + // Required. The resource name of the campaign bid modifier to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignBidModifier" + } + ]; } // Request message for [CampaignBidModifierService.MutateCampaignBidModifier][]. message MutateCampaignBidModifiersRequest { - // ID of the customer whose campaign bid modifiers are being modified. - string customer_id = 1; + // Required. ID of the customer whose campaign bid modifiers are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual campaign bid modifiers. - repeated CampaignBidModifierOperation operations = 2; + // Required. The list of operations to perform on individual campaign bid modifiers. + repeated CampaignBidModifierOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried @@ -99,7 +106,6 @@ message CampaignBidModifierOperation { // Remove operation: A resource name for the removed campaign bid modifier // is expected, in this format: // - // // `customers/{customer_id}/CampaignBidModifiers/{campaign_id}~{criterion_id}` string remove = 3; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/campaign_budget_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/campaign_budget_service.proto index 720e1d533..6ba0345db 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/campaign_budget_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/campaign_budget_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/campaign_budget.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -36,40 +37,45 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage campaign budgets. service CampaignBudgetService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested Campaign Budget in full detail. - rpc GetCampaignBudget(GetCampaignBudgetRequest) - returns (google.ads.googleads.v1.resources.CampaignBudget) { + rpc GetCampaignBudget(GetCampaignBudgetRequest) returns (google.ads.googleads.v1.resources.CampaignBudget) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/campaignBudgets/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes campaign budgets. Operation statuses are // returned. - rpc MutateCampaignBudgets(MutateCampaignBudgetsRequest) - returns (MutateCampaignBudgetsResponse) { + rpc MutateCampaignBudgets(MutateCampaignBudgetsRequest) returns (MutateCampaignBudgetsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/campaignBudgets:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [CampaignBudgetService.GetCampaignBudget][google.ads.googleads.v1.services.CampaignBudgetService.GetCampaignBudget]. +// Request message for [CampaignBudgetService.GetCampaignBudget][google.ads.googleads.v1.services.CampaignBudgetService.GetCampaignBudget]. message GetCampaignBudgetRequest { - // The resource name of the campaign budget to fetch. - string resource_name = 1; + // Required. The resource name of the campaign budget to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignBudget" + } + ]; } -// Request message for -// [CampaignBudgetService.MutateCampaignBudgets][google.ads.googleads.v1.services.CampaignBudgetService.MutateCampaignBudgets]. +// Request message for [CampaignBudgetService.MutateCampaignBudgets][google.ads.googleads.v1.services.CampaignBudgetService.MutateCampaignBudgets]. message MutateCampaignBudgetsRequest { - // The ID of the customer whose campaign budgets are being modified. - string customer_id = 1; + // Required. The ID of the customer whose campaign budgets are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual campaign budgets. - repeated CampaignBudgetOperation operations = 2; + // Required. The list of operations to perform on individual campaign budgets. + repeated CampaignBudgetOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/campaign_criterion_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/campaign_criterion_service.proto index 5e2edec7b..bd6122d5f 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/campaign_criterion_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/campaign_criterion_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/campaign_criterion.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -36,39 +37,44 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage campaign criteria. service CampaignCriterionService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested criterion in full detail. - rpc GetCampaignCriterion(GetCampaignCriterionRequest) - returns (google.ads.googleads.v1.resources.CampaignCriterion) { + rpc GetCampaignCriterion(GetCampaignCriterionRequest) returns (google.ads.googleads.v1.resources.CampaignCriterion) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/campaignCriteria/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes criteria. Operation statuses are returned. - rpc MutateCampaignCriteria(MutateCampaignCriteriaRequest) - returns (MutateCampaignCriteriaResponse) { + rpc MutateCampaignCriteria(MutateCampaignCriteriaRequest) returns (MutateCampaignCriteriaResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/campaignCriteria:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [CampaignCriterionService.GetCampaignCriterion][google.ads.googleads.v1.services.CampaignCriterionService.GetCampaignCriterion]. +// Request message for [CampaignCriterionService.GetCampaignCriterion][google.ads.googleads.v1.services.CampaignCriterionService.GetCampaignCriterion]. message GetCampaignCriterionRequest { - // The resource name of the criterion to fetch. - string resource_name = 1; + // Required. The resource name of the criterion to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignCriterion" + } + ]; } -// Request message for -// [CampaignCriterionService.MutateCampaignCriteria][google.ads.googleads.v1.services.CampaignCriterionService.MutateCampaignCriteria]. +// Request message for [CampaignCriterionService.MutateCampaignCriteria][google.ads.googleads.v1.services.CampaignCriterionService.MutateCampaignCriteria]. message MutateCampaignCriteriaRequest { - // The ID of the customer whose criteria are being modified. - string customer_id = 1; + // Required. The ID of the customer whose criteria are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual criteria. - repeated CampaignCriterionOperation operations = 2; + // Required. The list of operations to perform on individual criteria. + repeated CampaignCriterionOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/campaign_criterion_simulation_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/campaign_criterion_simulation_service.proto index 55f39bf94..02627ebb5 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/campaign_criterion_simulation_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/campaign_criterion_simulation_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/campaign_criterion_simulation.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,25 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch campaign criterion simulations. service CampaignCriterionSimulationService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested campaign criterion simulation in full detail. - rpc GetCampaignCriterionSimulation(GetCampaignCriterionSimulationRequest) - returns (google.ads.googleads.v1.resources.CampaignCriterionSimulation) { + rpc GetCampaignCriterionSimulation(GetCampaignCriterionSimulationRequest) returns (google.ads.googleads.v1.resources.CampaignCriterionSimulation) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/campaignCriterionSimulations/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for // [CampaignCriterionSimulationService.GetCampaignCriterionSimulation][google.ads.googleads.v1.services.CampaignCriterionSimulationService.GetCampaignCriterionSimulation]. message GetCampaignCriterionSimulationRequest { - // The resource name of the campaign criterion simulation to fetch. - string resource_name = 1; + // Required. The resource name of the campaign criterion simulation to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignCriterionSimulation" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/campaign_draft_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/campaign_draft_service.proto index f075b42bd..4ff909a0d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/campaign_draft_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/campaign_draft_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,11 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/campaign_draft.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/longrunning/operations.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -37,11 +38,14 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage campaign drafts. service CampaignDraftService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested campaign draft in full detail. rpc GetCampaignDraft(GetCampaignDraftRequest) returns (google.ads.googleads.v1.resources.CampaignDraft) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/campaignDrafts/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes campaign drafts. Operation statuses are @@ -51,6 +55,7 @@ service CampaignDraftService { post: "/v1/customers/{customer_id=*}/campaignDrafts:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } // Promotes the changes in a draft back to the base campaign. @@ -67,6 +72,11 @@ service CampaignDraftService { post: "/v1/{campaign_draft=customers/*/campaignDrafts/*}:promote" body: "*" }; + option (google.api.method_signature) = "campaign_draft"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "google.protobuf.Empty" + }; } // Returns all errors that occurred during CampaignDraft promote. Throws an @@ -76,22 +86,28 @@ service CampaignDraftService { option (google.api.http) = { get: "/v1/{resource_name=customers/*/campaignDrafts/*}:listAsyncErrors" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [CampaignDraftService.GetCampaignDraft][google.ads.googleads.v1.services.CampaignDraftService.GetCampaignDraft]. message GetCampaignDraftRequest { - // The resource name of the campaign draft to fetch. - string resource_name = 1; + // Required. The resource name of the campaign draft to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignDraft" + } + ]; } // Request message for [CampaignDraftService.MutateCampaignDrafts][google.ads.googleads.v1.services.CampaignDraftService.MutateCampaignDrafts]. message MutateCampaignDraftsRequest { - // The ID of the customer whose campaign drafts are being modified. - string customer_id = 1; + // Required. The ID of the customer whose campaign drafts are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual campaign drafts. - repeated CampaignDraftOperation operations = 2; + // Required. The list of operations to perform on individual campaign drafts. + repeated CampaignDraftOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried @@ -106,8 +122,8 @@ message MutateCampaignDraftsRequest { // Request message for [CampaignDraftService.PromoteCampaignDraft][google.ads.googleads.v1.services.CampaignDraftService.PromoteCampaignDraft]. message PromoteCampaignDraftRequest { - // The resource name of the campaign draft to promote. - string campaign_draft = 1; + // Required. The resource name of the campaign draft to promote. + string campaign_draft = 1 [(google.api.field_behavior) = REQUIRED]; } // A single operation (create, update, remove) on a campaign draft. @@ -153,8 +169,13 @@ message MutateCampaignDraftResult { // Request message for [CampaignDraftService.ListCampaignDraftAsyncErrors][google.ads.googleads.v1.services.CampaignDraftService.ListCampaignDraftAsyncErrors]. message ListCampaignDraftAsyncErrorsRequest { - // The name of the campaign draft from which to retrieve the async errors. - string resource_name = 1; + // Required. The name of the campaign draft from which to retrieve the async errors. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignDraft" + } + ]; // Token of the page to retrieve. If not specified, the first // page of results will be returned. Use the value obtained from diff --git a/third_party/googleapis/google/ads/googleads/v1/services/campaign_experiment_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/campaign_experiment_service.proto index 2d0e5c1d3..b02873441 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/campaign_experiment_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/campaign_experiment_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,10 +18,12 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/campaign_experiment.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/longrunning/operations.proto"; import "google/protobuf/empty.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -47,11 +48,14 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // A campaign experiment is created from a draft of changes to the base campaign // and will be a snapshot of changes in the draft at the time of creation. service CampaignExperimentService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested campaign experiment in full detail. rpc GetCampaignExperiment(GetCampaignExperimentRequest) returns (google.ads.googleads.v1.resources.CampaignExperiment) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/campaignExperiments/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates a campaign experiment based on a campaign draft. The draft campaign @@ -69,6 +73,11 @@ service CampaignExperimentService { post: "/v1/customers/{customer_id=*}/campaignExperiments:create" body: "*" }; + option (google.api.method_signature) = "customer_id,campaign_experiment"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "google.ads.googleads.v1.services.CreateCampaignExperimentMetadata" + }; } // Updates campaign experiments. Operation statuses are returned. @@ -77,6 +86,7 @@ service CampaignExperimentService { post: "/v1/customers/{customer_id=*}/campaignExperiments:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } // Graduates a campaign experiment to a full campaign. The base and experiment @@ -86,6 +96,7 @@ service CampaignExperimentService { post: "/v1/{campaign_experiment=customers/*/campaignExperiments/*}:graduate" body: "*" }; + option (google.api.method_signature) = "campaign_experiment,campaign_budget"; } // Promotes the changes in a experiment campaign back to the base campaign. @@ -99,6 +110,11 @@ service CampaignExperimentService { post: "/v1/{campaign_experiment=customers/*/campaignExperiments/*}:promote" body: "*" }; + option (google.api.method_signature) = "campaign_experiment"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "google.protobuf.Empty" + }; } // Immediately ends a campaign experiment, changing the experiment's scheduled @@ -109,6 +125,7 @@ service CampaignExperimentService { post: "/v1/{campaign_experiment=customers/*/campaignExperiments/*}:end" body: "*" }; + option (google.api.method_signature) = "campaign_experiment"; } // Returns all errors that occurred during CampaignExperiment create or @@ -118,22 +135,28 @@ service CampaignExperimentService { option (google.api.http) = { get: "/v1/{resource_name=customers/*/campaignExperiments/*}:listAsyncErrors" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [CampaignExperimentService.GetCampaignExperiment][google.ads.googleads.v1.services.CampaignExperimentService.GetCampaignExperiment]. message GetCampaignExperimentRequest { - // The resource name of the campaign experiment to fetch. - string resource_name = 1; + // Required. The resource name of the campaign experiment to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignExperiment" + } + ]; } // Request message for [CampaignExperimentService.MutateCampaignExperiments][google.ads.googleads.v1.services.CampaignExperimentService.MutateCampaignExperiments]. message MutateCampaignExperimentsRequest { - // The ID of the customer whose campaign experiments are being modified. - string customer_id = 1; + // Required. The ID of the customer whose campaign experiments are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual campaign experiments. - repeated CampaignExperimentOperation operations = 2; + // Required. The list of operations to perform on individual campaign experiments. + repeated CampaignExperimentOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried @@ -185,11 +208,11 @@ message MutateCampaignExperimentResult { // Request message for [CampaignExperimentService.CreateCampaignExperiment][google.ads.googleads.v1.services.CampaignExperimentService.CreateCampaignExperiment]. message CreateCampaignExperimentRequest { - // The ID of the customer whose campaign experiment is being created. - string customer_id = 1; + // Required. The ID of the customer whose campaign experiment is being created. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The campaign experiment to be created. - google.ads.googleads.v1.resources.CampaignExperiment campaign_experiment = 2; + // Required. The campaign experiment to be created. + google.ads.googleads.v1.resources.CampaignExperiment campaign_experiment = 2 [(google.api.field_behavior) = REQUIRED]; // If true, the request is validated but not executed. Only errors are // returned, not results. @@ -205,12 +228,12 @@ message CreateCampaignExperimentMetadata { // Request message for [CampaignExperimentService.GraduateCampaignExperiment][google.ads.googleads.v1.services.CampaignExperimentService.GraduateCampaignExperiment]. message GraduateCampaignExperimentRequest { - // The resource name of the campaign experiment to graduate. - string campaign_experiment = 1; + // Required. The resource name of the campaign experiment to graduate. + string campaign_experiment = 1 [(google.api.field_behavior) = REQUIRED]; - // Resource name of the budget to attach to the campaign graduated from the + // Required. Resource name of the budget to attach to the campaign graduated from the // experiment. - string campaign_budget = 2; + string campaign_budget = 2 [(google.api.field_behavior) = REQUIRED]; } // Response message for campaign experiment graduate. @@ -222,22 +245,27 @@ message GraduateCampaignExperimentResponse { // Request message for [CampaignExperimentService.PromoteCampaignExperiment][google.ads.googleads.v1.services.CampaignExperimentService.PromoteCampaignExperiment]. message PromoteCampaignExperimentRequest { - // The resource name of the campaign experiment to promote. - string campaign_experiment = 1; + // Required. The resource name of the campaign experiment to promote. + string campaign_experiment = 1 [(google.api.field_behavior) = REQUIRED]; } // Request message for [CampaignExperimentService.EndCampaignExperiment][google.ads.googleads.v1.services.CampaignExperimentService.EndCampaignExperiment]. message EndCampaignExperimentRequest { - // The resource name of the campaign experiment to end. - string campaign_experiment = 1; + // Required. The resource name of the campaign experiment to end. + string campaign_experiment = 1 [(google.api.field_behavior) = REQUIRED]; } // Request message for // [CampaignExperimentService.ListCampaignExperimentAsyncErrors][google.ads.googleads.v1.services.CampaignExperimentService.ListCampaignExperimentAsyncErrors]. message ListCampaignExperimentAsyncErrorsRequest { - // The name of the campaign experiment from which to retrieve the async + // Required. The name of the campaign experiment from which to retrieve the async // errors. - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignExperiment" + } + ]; // Token of the page to retrieve. If not specified, the first // page of results will be returned. Use the value obtained from diff --git a/third_party/googleapis/google/ads/googleads/v1/services/campaign_extension_setting_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/campaign_extension_setting_service.proto index db4ff15c7..269ea15ec 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/campaign_extension_setting_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/campaign_extension_setting_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/campaign_extension_setting.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -36,42 +37,49 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage campaign extension settings. service CampaignExtensionSettingService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested campaign extension setting in full detail. - rpc GetCampaignExtensionSetting(GetCampaignExtensionSettingRequest) - returns (google.ads.googleads.v1.resources.CampaignExtensionSetting) { + rpc GetCampaignExtensionSetting(GetCampaignExtensionSettingRequest) returns (google.ads.googleads.v1.resources.CampaignExtensionSetting) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/campaignExtensionSettings/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes campaign extension settings. Operation // statuses are returned. - rpc MutateCampaignExtensionSettings(MutateCampaignExtensionSettingsRequest) - returns (MutateCampaignExtensionSettingsResponse) { + rpc MutateCampaignExtensionSettings(MutateCampaignExtensionSettingsRequest) returns (MutateCampaignExtensionSettingsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/campaignExtensionSettings:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for // [CampaignExtensionSettingService.GetCampaignExtensionSetting][google.ads.googleads.v1.services.CampaignExtensionSettingService.GetCampaignExtensionSetting]. message GetCampaignExtensionSettingRequest { - // The resource name of the campaign extension setting to fetch. - string resource_name = 1; + // Required. The resource name of the campaign extension setting to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignExtensionSetting" + } + ]; } // Request message for // [CampaignExtensionSettingService.MutateCampaignExtensionSettings][google.ads.googleads.v1.services.CampaignExtensionSettingService.MutateCampaignExtensionSettings]. message MutateCampaignExtensionSettingsRequest { - // The ID of the customer whose campaign extension settings are being + // Required. The ID of the customer whose campaign extension settings are being // modified. - string customer_id = 1; + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual campaign extension + // Required. The list of operations to perform on individual campaign extension // settings. - repeated CampaignExtensionSettingOperation operations = 2; + repeated CampaignExtensionSettingOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried @@ -102,7 +110,6 @@ message CampaignExtensionSettingOperation { // Remove operation: A resource name for the removed campaign extension // setting is expected, in this format: // - // // `customers/{customer_id}/campaignExtensionSettings/{campaign_id}~{extension_type}` string remove = 3; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/campaign_feed_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/campaign_feed_service.proto index 26c55adc2..8db7ecb5b 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/campaign_feed_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/campaign_feed_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/campaign_feed.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -36,40 +37,45 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage campaign feeds. service CampaignFeedService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested campaign feed in full detail. - rpc GetCampaignFeed(GetCampaignFeedRequest) - returns (google.ads.googleads.v1.resources.CampaignFeed) { + rpc GetCampaignFeed(GetCampaignFeedRequest) returns (google.ads.googleads.v1.resources.CampaignFeed) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/campaignFeeds/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes campaign feeds. Operation statuses are // returned. - rpc MutateCampaignFeeds(MutateCampaignFeedsRequest) - returns (MutateCampaignFeedsResponse) { + rpc MutateCampaignFeeds(MutateCampaignFeedsRequest) returns (MutateCampaignFeedsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/campaignFeeds:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [CampaignFeedService.GetCampaignFeed][google.ads.googleads.v1.services.CampaignFeedService.GetCampaignFeed]. +// Request message for [CampaignFeedService.GetCampaignFeed][google.ads.googleads.v1.services.CampaignFeedService.GetCampaignFeed]. message GetCampaignFeedRequest { - // The resource name of the campaign feed to fetch. - string resource_name = 1; + // Required. The resource name of the campaign feed to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignFeed" + } + ]; } -// Request message for -// [CampaignFeedService.MutateCampaignFeeds][google.ads.googleads.v1.services.CampaignFeedService.MutateCampaignFeeds]. +// Request message for [CampaignFeedService.MutateCampaignFeeds][google.ads.googleads.v1.services.CampaignFeedService.MutateCampaignFeeds]. message MutateCampaignFeedsRequest { - // The ID of the customer whose campaign feeds are being modified. - string customer_id = 1; + // Required. The ID of the customer whose campaign feeds are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual campaign feeds. - repeated CampaignFeedOperation operations = 2; + // Required. The list of operations to perform on individual campaign feeds. + repeated CampaignFeedOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/campaign_label_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/campaign_label_service.proto index 56df99167..8bebec481 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/campaign_label_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/campaign_label_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,7 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/campaign_label.proto"; import "google/api/annotations.proto"; -import "google/protobuf/wrappers.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -35,40 +36,45 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage labels on campaigns. service CampaignLabelService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested campaign-label relationship in full detail. - rpc GetCampaignLabel(GetCampaignLabelRequest) - returns (google.ads.googleads.v1.resources.CampaignLabel) { + rpc GetCampaignLabel(GetCampaignLabelRequest) returns (google.ads.googleads.v1.resources.CampaignLabel) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/campaignLabels/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates and removes campaign-label relationships. // Operation statuses are returned. - rpc MutateCampaignLabels(MutateCampaignLabelsRequest) - returns (MutateCampaignLabelsResponse) { + rpc MutateCampaignLabels(MutateCampaignLabelsRequest) returns (MutateCampaignLabelsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/campaignLabels:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [CampaignLabelService.GetCampaignLabel][google.ads.googleads.v1.services.CampaignLabelService.GetCampaignLabel]. +// Request message for [CampaignLabelService.GetCampaignLabel][google.ads.googleads.v1.services.CampaignLabelService.GetCampaignLabel]. message GetCampaignLabelRequest { - // The resource name of the campaign-label relationship to fetch. - string resource_name = 1; + // Required. The resource name of the campaign-label relationship to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignLabel" + } + ]; } -// Request message for -// [CampaignLabelService.MutateCampaignLabels][google.ads.googleads.v1.services.CampaignLabelService.MutateCampaignLabels]. +// Request message for [CampaignLabelService.MutateCampaignLabels][google.ads.googleads.v1.services.CampaignLabelService.MutateCampaignLabels]. message MutateCampaignLabelsRequest { - // ID of the customer whose campaign-label relationships are being modified. - string customer_id = 1; + // Required. ID of the customer whose campaign-label relationships are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on campaign-label relationships. - repeated CampaignLabelOperation operations = 2; + // Required. The list of operations to perform on campaign-label relationships. + repeated CampaignLabelOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/campaign_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/campaign_service.proto index 542c0bc7b..d73d7de49 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/campaign_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/campaign_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/campaign.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -36,39 +37,44 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage campaigns. service CampaignService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested campaign in full detail. - rpc GetCampaign(GetCampaignRequest) - returns (google.ads.googleads.v1.resources.Campaign) { + rpc GetCampaign(GetCampaignRequest) returns (google.ads.googleads.v1.resources.Campaign) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/campaigns/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes campaigns. Operation statuses are returned. - rpc MutateCampaigns(MutateCampaignsRequest) - returns (MutateCampaignsResponse) { + rpc MutateCampaigns(MutateCampaignsRequest) returns (MutateCampaignsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/campaigns:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [CampaignService.GetCampaign][google.ads.googleads.v1.services.CampaignService.GetCampaign]. +// Request message for [CampaignService.GetCampaign][google.ads.googleads.v1.services.CampaignService.GetCampaign]. message GetCampaignRequest { - // The resource name of the campaign to fetch. - string resource_name = 1; + // Required. The resource name of the campaign to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; } -// Request message for -// [CampaignService.MutateCampaigns][google.ads.googleads.v1.services.CampaignService.MutateCampaigns]. +// Request message for [CampaignService.MutateCampaigns][google.ads.googleads.v1.services.CampaignService.MutateCampaigns]. message MutateCampaignsRequest { - // The ID of the customer whose campaigns are being modified. - string customer_id = 1; + // Required. The ID of the customer whose campaigns are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual campaigns. - repeated CampaignOperation operations = 2; + // Required. The list of operations to perform on individual campaigns. + repeated CampaignOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/campaign_shared_set_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/campaign_shared_set_service.proto index acc9a9afe..3c3a7f224 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/campaign_shared_set_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/campaign_shared_set_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,7 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/campaign_shared_set.proto"; import "google/api/annotations.proto"; -import "google/protobuf/wrappers.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -35,39 +36,44 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage campaign shared sets. service CampaignSharedSetService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested campaign shared set in full detail. - rpc GetCampaignSharedSet(GetCampaignSharedSetRequest) - returns (google.ads.googleads.v1.resources.CampaignSharedSet) { + rpc GetCampaignSharedSet(GetCampaignSharedSetRequest) returns (google.ads.googleads.v1.resources.CampaignSharedSet) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/campaignSharedSets/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates or removes campaign shared sets. Operation statuses are returned. - rpc MutateCampaignSharedSets(MutateCampaignSharedSetsRequest) - returns (MutateCampaignSharedSetsResponse) { + rpc MutateCampaignSharedSets(MutateCampaignSharedSetsRequest) returns (MutateCampaignSharedSetsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/campaignSharedSets:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [CampaignSharedSetService.GetCampaignSharedSet][google.ads.googleads.v1.services.CampaignSharedSetService.GetCampaignSharedSet]. +// Request message for [CampaignSharedSetService.GetCampaignSharedSet][google.ads.googleads.v1.services.CampaignSharedSetService.GetCampaignSharedSet]. message GetCampaignSharedSetRequest { - // The resource name of the campaign shared set to fetch. - string resource_name = 1; + // Required. The resource name of the campaign shared set to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignSharedSet" + } + ]; } -// Request message for -// [CampaignSharedSetService.MutateCampaignSharedSets][google.ads.googleads.v1.services.CampaignSharedSetService.MutateCampaignSharedSets]. +// Request message for [CampaignSharedSetService.MutateCampaignSharedSets][google.ads.googleads.v1.services.CampaignSharedSetService.MutateCampaignSharedSets]. message MutateCampaignSharedSetsRequest { - // The ID of the customer whose campaign shared sets are being modified. - string customer_id = 1; + // Required. The ID of the customer whose campaign shared sets are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual campaign shared sets. - repeated CampaignSharedSetOperation operations = 2; + // Required. The list of operations to perform on individual campaign shared sets. + repeated CampaignSharedSetOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried @@ -91,7 +97,6 @@ message CampaignSharedSetOperation { // Remove operation: A resource name for the removed campaign shared set is // expected, in this format: // - // // `customers/{customer_id}/campaignSharedSets/{campaign_id}~{shared_set_id}` string remove = 3; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/carrier_constant_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/carrier_constant_service.proto index 10aa6ad86..deff08a42 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/carrier_constant_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/carrier_constant_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/carrier_constant.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch carrier constants. service CarrierConstantService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested carrier constant in full detail. - rpc GetCarrierConstant(GetCarrierConstantRequest) - returns (google.ads.googleads.v1.resources.CarrierConstant) { + rpc GetCarrierConstant(GetCarrierConstantRequest) returns (google.ads.googleads.v1.resources.CarrierConstant) { option (google.api.http) = { get: "/v1/{resource_name=carrierConstants/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [CarrierConstantService.GetCarrierConstant][google.ads.googleads.v1.services.CarrierConstantService.GetCarrierConstant]. +// Request message for [CarrierConstantService.GetCarrierConstant][google.ads.googleads.v1.services.CarrierConstantService.GetCarrierConstant]. message GetCarrierConstantRequest { - // Resource name of the carrier constant to fetch. - string resource_name = 1; + // Required. Resource name of the carrier constant to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CarrierConstant" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/change_status_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/change_status_service.proto index 42534f27d..f28795a87 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/change_status_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/change_status_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/change_status.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch change statuses. service ChangeStatusService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested change status in full detail. - rpc GetChangeStatus(GetChangeStatusRequest) - returns (google.ads.googleads.v1.resources.ChangeStatus) { + rpc GetChangeStatus(GetChangeStatusRequest) returns (google.ads.googleads.v1.resources.ChangeStatus) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/changeStatus/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// '[ChangeStatusService.GetChangeStatus][google.ads.googleads.v1.services.ChangeStatusService.GetChangeStatus]'. +// Request message for '[ChangeStatusService.GetChangeStatus][google.ads.googleads.v1.services.ChangeStatusService.GetChangeStatus]'. message GetChangeStatusRequest { - // The resource name of the change status to fetch. - string resource_name = 1; + // Required. The resource name of the change status to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ChangeStatus" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/click_view_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/click_view_service.proto index 4ba02a293..1dcf615cd 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/click_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/click_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/click_view.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch click views. service ClickViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested click view in full detail. - rpc GetClickView(GetClickViewRequest) - returns (google.ads.googleads.v1.resources.ClickView) { + rpc GetClickView(GetClickViewRequest) returns (google.ads.googleads.v1.resources.ClickView) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/clickViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [ClickViewService.GetClickView][google.ads.googleads.v1.services.ClickViewService.GetClickView]. +// Request message for [ClickViewService.GetClickView][google.ads.googleads.v1.services.ClickViewService.GetClickView]. message GetClickViewRequest { - // The resource name of the click view to fetch. - string resource_name = 1; + // Required. The resource name of the click view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ClickView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/conversion_action_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/conversion_action_service.proto index a7ac01ff0..428dd62e3 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/conversion_action_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/conversion_action_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/conversion_action.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -36,40 +37,45 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage conversion actions. service ConversionActionService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested conversion action. - rpc GetConversionAction(GetConversionActionRequest) - returns (google.ads.googleads.v1.resources.ConversionAction) { + rpc GetConversionAction(GetConversionActionRequest) returns (google.ads.googleads.v1.resources.ConversionAction) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/conversionActions/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates or removes conversion actions. Operation statuses are // returned. - rpc MutateConversionActions(MutateConversionActionsRequest) - returns (MutateConversionActionsResponse) { + rpc MutateConversionActions(MutateConversionActionsRequest) returns (MutateConversionActionsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/conversionActions:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [ConversionActionService.GetConversionAction][google.ads.googleads.v1.services.ConversionActionService.GetConversionAction]. +// Request message for [ConversionActionService.GetConversionAction][google.ads.googleads.v1.services.ConversionActionService.GetConversionAction]. message GetConversionActionRequest { - // The resource name of the conversion action to fetch. - string resource_name = 1; + // Required. The resource name of the conversion action to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ConversionAction" + } + ]; } -// Request message for -// [ConversionActionService.MutateConversionActions][google.ads.googleads.v1.services.ConversionActionService.MutateConversionActions]. +// Request message for [ConversionActionService.MutateConversionActions][google.ads.googleads.v1.services.ConversionActionService.MutateConversionActions]. message MutateConversionActionsRequest { - // The ID of the customer whose conversion actions are being modified. - string customer_id = 1; + // Required. The ID of the customer whose conversion actions are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual conversion actions. - repeated ConversionActionOperation operations = 2; + // Required. The list of operations to perform on individual conversion actions. + repeated ConversionActionOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried @@ -105,8 +111,7 @@ message ConversionActionOperation { } } -// Response message for -// [ConversionActionService.MutateConversionActions][google.ads.googleads.v1.services.ConversionActionService.MutateConversionActions]. +// Response message for [ConversionActionService.MutateConversionActions][google.ads.googleads.v1.services.ConversionActionService.MutateConversionActions]. message MutateConversionActionsResponse { // Errors that pertain to operation failures in the partial failure mode. // Returned only when partial_failure = true and all errors occur inside the diff --git a/third_party/googleapis/google/ads/googleads/v1/services/conversion_adjustment_upload_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/conversion_adjustment_upload_service.proto index 70b0a2d7c..f54aceb0f 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/conversion_adjustment_upload_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/conversion_adjustment_upload_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,8 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/enums/conversion_adjustment_type.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; @@ -33,24 +34,26 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to upload conversion adjustments. service ConversionAdjustmentUploadService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Processes the given conversion adjustments. - rpc UploadConversionAdjustments(UploadConversionAdjustmentsRequest) - returns (UploadConversionAdjustmentsResponse) { + rpc UploadConversionAdjustments(UploadConversionAdjustmentsRequest) returns (UploadConversionAdjustmentsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}:uploadConversionAdjustments" body: "*" }; + option (google.api.method_signature) = "customer_id,conversion_adjustments"; } } // Request message for // [ConversionAdjustmentUploadService.UploadConversionAdjustments][google.ads.googleads.v1.services.ConversionAdjustmentUploadService.UploadConversionAdjustments]. message UploadConversionAdjustmentsRequest { - // The ID of the customer performing the upload. - string customer_id = 1; + // Required. The ID of the customer performing the upload. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The conversion adjustments that are being uploaded. - repeated ConversionAdjustment conversion_adjustments = 2; + // Required. The conversion adjustments that are being uploaded. + repeated ConversionAdjustment conversion_adjustments = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried out @@ -92,8 +95,7 @@ message ConversionAdjustment { google.protobuf.StringValue adjustment_date_time = 4; // The adjustment type. - google.ads.googleads.v1.enums.ConversionAdjustmentTypeEnum - .ConversionAdjustmentType adjustment_type = 5; + google.ads.googleads.v1.enums.ConversionAdjustmentTypeEnum.ConversionAdjustmentType adjustment_type = 5; // Information needed to restate the conversion's value. // Required for restatements. Should not be supplied for retractions. An error @@ -151,8 +153,7 @@ message ConversionAdjustmentResult { google.protobuf.StringValue adjustment_date_time = 4; // The adjustment type. - google.ads.googleads.v1.enums.ConversionAdjustmentTypeEnum - .ConversionAdjustmentType adjustment_type = 5; + google.ads.googleads.v1.enums.ConversionAdjustmentTypeEnum.ConversionAdjustmentType adjustment_type = 5; // Identifies the conversion that was adjusted. oneof conversion_identifier { diff --git a/third_party/googleapis/google/ads/googleads/v1/services/conversion_upload_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/conversion_upload_service.proto index f3d316379..4d7da51f0 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/conversion_upload_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/conversion_upload_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v1.services; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; @@ -32,33 +33,34 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to upload conversions. service ConversionUploadService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Processes the given click conversions. - rpc UploadClickConversions(UploadClickConversionsRequest) - returns (UploadClickConversionsResponse) { + rpc UploadClickConversions(UploadClickConversionsRequest) returns (UploadClickConversionsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}:uploadClickConversions" body: "*" }; + option (google.api.method_signature) = "customer_id,conversions"; } // Processes the given call conversions. - rpc UploadCallConversions(UploadCallConversionsRequest) - returns (UploadCallConversionsResponse) { + rpc UploadCallConversions(UploadCallConversionsRequest) returns (UploadCallConversionsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}:uploadCallConversions" body: "*" }; + option (google.api.method_signature) = "customer_id,conversions"; } } -// Request message for -// [ConversionUploadService.UploadClickConversions][google.ads.googleads.v1.services.ConversionUploadService.UploadClickConversions]. +// Request message for [ConversionUploadService.UploadClickConversions][google.ads.googleads.v1.services.ConversionUploadService.UploadClickConversions]. message UploadClickConversionsRequest { - // The ID of the customer performing the upload. - string customer_id = 1; + // Required. The ID of the customer performing the upload. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The conversions that are being uploaded. - repeated ClickConversion conversions = 2; + // Required. The conversions that are being uploaded. + repeated ClickConversion conversions = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried @@ -71,8 +73,7 @@ message UploadClickConversionsRequest { bool validate_only = 4; } -// Response message for -// [ConversionUploadService.UploadClickConversions][google.ads.googleads.v1.services.ConversionUploadService.UploadClickConversions]. +// Response message for [ConversionUploadService.UploadClickConversions][google.ads.googleads.v1.services.ConversionUploadService.UploadClickConversions]. message UploadClickConversionsResponse { // Errors that pertain to conversion failures in the partial failure mode. // Returned when all errors occur inside the conversions. If any errors occur @@ -85,14 +86,13 @@ message UploadClickConversionsResponse { repeated ClickConversionResult results = 2; } -// Request message for -// [ConversionUploadService.UploadCallConversions][google.ads.googleads.v1.services.ConversionUploadService.UploadCallConversions]. +// Request message for [ConversionUploadService.UploadCallConversions][google.ads.googleads.v1.services.ConversionUploadService.UploadCallConversions]. message UploadCallConversionsRequest { - // The ID of the customer performing the upload. - string customer_id = 1; + // Required. The ID of the customer performing the upload. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The conversions that are being uploaded. - repeated CallConversion conversions = 2; + // Required. The conversions that are being uploaded. + repeated CallConversion conversions = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried @@ -105,8 +105,7 @@ message UploadCallConversionsRequest { bool validate_only = 4; } -// Response message for -// [ConversionUploadService.UploadCallConversions][google.ads.googleads.v1.services.ConversionUploadService.UploadCallConversions]. +// Response message for [ConversionUploadService.UploadCallConversions][google.ads.googleads.v1.services.ConversionUploadService.UploadCallConversions]. message UploadCallConversionsResponse { // Errors that pertain to conversion failures in the partial failure mode. // Returned when all errors occur inside the conversions. If any errors occur diff --git a/third_party/googleapis/google/ads/googleads/v1/services/custom_interest_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/custom_interest_service.proto index 4dfc1638a..59bc67f2e 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/custom_interest_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/custom_interest_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/custom_interest.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -35,39 +36,44 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage custom interests. service CustomInterestService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested custom interest in full detail. - rpc GetCustomInterest(GetCustomInterestRequest) - returns (google.ads.googleads.v1.resources.CustomInterest) { + rpc GetCustomInterest(GetCustomInterestRequest) returns (google.ads.googleads.v1.resources.CustomInterest) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/customInterests/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates or updates custom interests. Operation statuses are returned. - rpc MutateCustomInterests(MutateCustomInterestsRequest) - returns (MutateCustomInterestsResponse) { + rpc MutateCustomInterests(MutateCustomInterestsRequest) returns (MutateCustomInterestsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/customInterests:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [CustomInterestService.GetCustomInterest][google.ads.googleads.v1.services.CustomInterestService.GetCustomInterest]. +// Request message for [CustomInterestService.GetCustomInterest][google.ads.googleads.v1.services.CustomInterestService.GetCustomInterest]. message GetCustomInterestRequest { - // The resource name of the custom interest to fetch. - string resource_name = 1; + // Required. The resource name of the custom interest to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomInterest" + } + ]; } -// Request message for -// [CustomInterestService.MutateCustomInterests][google.ads.googleads.v1.services.CustomInterestService.MutateCustomInterests]. +// Request message for [CustomInterestService.MutateCustomInterests][google.ads.googleads.v1.services.CustomInterestService.MutateCustomInterests]. message MutateCustomInterestsRequest { - // The ID of the customer whose custom interests are being modified. - string customer_id = 1; + // Required. The ID of the customer whose custom interests are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual custom interests. - repeated CustomInterestOperation operations = 2; + // Required. The list of operations to perform on individual custom interests. + repeated CustomInterestOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, the request is validated but not executed. Only errors are // returned, not results. diff --git a/third_party/googleapis/google/ads/googleads/v1/services/customer_client_link_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/customer_client_link_service.proto index c98e43914..d5898fbeb 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/customer_client_link_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/customer_client_link_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/customer_client_link.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,39 +34,44 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage customer client links. service CustomerClientLinkService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested CustomerClientLink in full detail. - rpc GetCustomerClientLink(GetCustomerClientLinkRequest) - returns (google.ads.googleads.v1.resources.CustomerClientLink) { + rpc GetCustomerClientLink(GetCustomerClientLinkRequest) returns (google.ads.googleads.v1.resources.CustomerClientLink) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/customerClientLinks/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates or updates a customer client link. Operation statuses are returned. - rpc MutateCustomerClientLink(MutateCustomerClientLinkRequest) - returns (MutateCustomerClientLinkResponse) { + rpc MutateCustomerClientLink(MutateCustomerClientLinkRequest) returns (MutateCustomerClientLinkResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/customerClientLinks:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operation"; } } -// Request message for -// [CustomerClientLinkService.GetCustomerClientLink][google.ads.googleads.v1.services.CustomerClientLinkService.GetCustomerClientLink]. +// Request message for [CustomerClientLinkService.GetCustomerClientLink][google.ads.googleads.v1.services.CustomerClientLinkService.GetCustomerClientLink]. message GetCustomerClientLinkRequest { - // The resource name of the customer client link to fetch. - string resource_name = 1; + // Required. The resource name of the customer client link to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerClientLink" + } + ]; } -// Request message for -// [CustomerClientLinkService.MutateCustomerClientLink][google.ads.googleads.v1.services.CustomerClientLinkService.MutateCustomerClientLink]. +// Request message for [CustomerClientLinkService.MutateCustomerClientLink][google.ads.googleads.v1.services.CustomerClientLinkService.MutateCustomerClientLink]. message MutateCustomerClientLinkRequest { - // The ID of the customer whose customer link are being modified. - string customer_id = 1; + // Required. The ID of the customer whose customer link are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The operation to perform on the individual CustomerClientLink. - CustomerClientLinkOperation operation = 2; + // Required. The operation to perform on the individual CustomerClientLink. + CustomerClientLinkOperation operation = 2 [(google.api.field_behavior) = REQUIRED]; } // A single operation (create, update) on a CustomerClientLink. diff --git a/third_party/googleapis/google/ads/googleads/v1/services/customer_client_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/customer_client_service.proto index 1dd809305..ed5e3e36f 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/customer_client_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/customer_client_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/customer_client.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to get clients in a customer's hierarchy. service CustomerClientService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested client in full detail. - rpc GetCustomerClient(GetCustomerClientRequest) - returns (google.ads.googleads.v1.resources.CustomerClient) { + rpc GetCustomerClient(GetCustomerClientRequest) returns (google.ads.googleads.v1.resources.CustomerClient) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/customerClients/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [CustomerClientService.GetCustomerClient][google.ads.googleads.v1.services.CustomerClientService.GetCustomerClient]. +// Request message for [CustomerClientService.GetCustomerClient][google.ads.googleads.v1.services.CustomerClientService.GetCustomerClient]. message GetCustomerClientRequest { - // The resource name of the client to fetch. - string resource_name = 1; + // Required. The resource name of the client to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerClient" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/customer_extension_setting_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/customer_extension_setting_service.proto index 9ec4974cd..1e58b5809 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/customer_extension_setting_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/customer_extension_setting_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/customer_extension_setting.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -36,42 +37,49 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage customer extension settings. service CustomerExtensionSettingService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested customer extension setting in full detail. - rpc GetCustomerExtensionSetting(GetCustomerExtensionSettingRequest) - returns (google.ads.googleads.v1.resources.CustomerExtensionSetting) { + rpc GetCustomerExtensionSetting(GetCustomerExtensionSettingRequest) returns (google.ads.googleads.v1.resources.CustomerExtensionSetting) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/customerExtensionSettings/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes customer extension settings. Operation // statuses are returned. - rpc MutateCustomerExtensionSettings(MutateCustomerExtensionSettingsRequest) - returns (MutateCustomerExtensionSettingsResponse) { + rpc MutateCustomerExtensionSettings(MutateCustomerExtensionSettingsRequest) returns (MutateCustomerExtensionSettingsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/customerExtensionSettings:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for // [CustomerExtensionSettingService.GetCustomerExtensionSetting][google.ads.googleads.v1.services.CustomerExtensionSettingService.GetCustomerExtensionSetting]. message GetCustomerExtensionSettingRequest { - // The resource name of the customer extension setting to fetch. - string resource_name = 1; + // Required. The resource name of the customer extension setting to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerExtensionSetting" + } + ]; } // Request message for // [CustomerExtensionSettingService.MutateCustomerExtensionSettings][google.ads.googleads.v1.services.CustomerExtensionSettingService.MutateCustomerExtensionSettings]. message MutateCustomerExtensionSettingsRequest { - // The ID of the customer whose customer extension settings are being + // Required. The ID of the customer whose customer extension settings are being // modified. - string customer_id = 1; + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual customer extension + // Required. The list of operations to perform on individual customer extension // settings. - repeated CustomerExtensionSettingOperation operations = 2; + repeated CustomerExtensionSettingOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/customer_feed_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/customer_feed_service.proto index 2fecf58e7..3c94faa77 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/customer_feed_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/customer_feed_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/customer_feed.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -36,40 +37,45 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage customer feeds. service CustomerFeedService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested customer feed in full detail. - rpc GetCustomerFeed(GetCustomerFeedRequest) - returns (google.ads.googleads.v1.resources.CustomerFeed) { + rpc GetCustomerFeed(GetCustomerFeedRequest) returns (google.ads.googleads.v1.resources.CustomerFeed) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/customerFeeds/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes customer feeds. Operation statuses are // returned. - rpc MutateCustomerFeeds(MutateCustomerFeedsRequest) - returns (MutateCustomerFeedsResponse) { + rpc MutateCustomerFeeds(MutateCustomerFeedsRequest) returns (MutateCustomerFeedsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/customerFeeds:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [CustomerFeedService.GetCustomerFeed][google.ads.googleads.v1.services.CustomerFeedService.GetCustomerFeed]. +// Request message for [CustomerFeedService.GetCustomerFeed][google.ads.googleads.v1.services.CustomerFeedService.GetCustomerFeed]. message GetCustomerFeedRequest { - // The resource name of the customer feed to fetch. - string resource_name = 1; + // Required. The resource name of the customer feed to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerFeed" + } + ]; } -// Request message for -// [CustomerFeedService.MutateCustomerFeeds][google.ads.googleads.v1.services.CustomerFeedService.MutateCustomerFeeds]. +// Request message for [CustomerFeedService.MutateCustomerFeeds][google.ads.googleads.v1.services.CustomerFeedService.MutateCustomerFeeds]. message MutateCustomerFeedsRequest { - // The ID of the customer whose customer feeds are being modified. - string customer_id = 1; + // Required. The ID of the customer whose customer feeds are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual customer feeds. - repeated CustomerFeedOperation operations = 2; + // Required. The list of operations to perform on individual customer feeds. + repeated CustomerFeedOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/customer_label_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/customer_label_service.proto index e9780aee4..8513c8043 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/customer_label_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/customer_label_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,7 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/customer_label.proto"; import "google/api/annotations.proto"; -import "google/protobuf/wrappers.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -35,40 +36,45 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage labels on customers. service CustomerLabelService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested customer-label relationship in full detail. - rpc GetCustomerLabel(GetCustomerLabelRequest) - returns (google.ads.googleads.v1.resources.CustomerLabel) { + rpc GetCustomerLabel(GetCustomerLabelRequest) returns (google.ads.googleads.v1.resources.CustomerLabel) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/customerLabels/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates and removes customer-label relationships. // Operation statuses are returned. - rpc MutateCustomerLabels(MutateCustomerLabelsRequest) - returns (MutateCustomerLabelsResponse) { + rpc MutateCustomerLabels(MutateCustomerLabelsRequest) returns (MutateCustomerLabelsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/customerLabels:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [CustomerLabelService.GetCustomerLabel][google.ads.googleads.v1.services.CustomerLabelService.GetCustomerLabel]. +// Request message for [CustomerLabelService.GetCustomerLabel][google.ads.googleads.v1.services.CustomerLabelService.GetCustomerLabel]. message GetCustomerLabelRequest { - // The resource name of the customer-label relationship to fetch. - string resource_name = 1; + // Required. The resource name of the customer-label relationship to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerLabel" + } + ]; } -// Request message for -// [CustomerLabelService.MutateCustomerLabels][google.ads.googleads.v1.services.CustomerLabelService.MutateCustomerLabels]. +// Request message for [CustomerLabelService.MutateCustomerLabels][google.ads.googleads.v1.services.CustomerLabelService.MutateCustomerLabels]. message MutateCustomerLabelsRequest { - // ID of the customer whose customer-label relationships are being modified. - string customer_id = 1; + // Required. ID of the customer whose customer-label relationships are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on customer-label relationships. - repeated CustomerLabelOperation operations = 2; + // Required. The list of operations to perform on customer-label relationships. + repeated CustomerLabelOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/customer_manager_link_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/customer_manager_link_service.proto index 0992880fd..7f1050d7f 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/customer_manager_link_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/customer_manager_link_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/customer_manager_link.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -32,39 +34,44 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage customer-manager links. service CustomerManagerLinkService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested CustomerManagerLink in full detail. - rpc GetCustomerManagerLink(GetCustomerManagerLinkRequest) - returns (google.ads.googleads.v1.resources.CustomerManagerLink) { + rpc GetCustomerManagerLink(GetCustomerManagerLinkRequest) returns (google.ads.googleads.v1.resources.CustomerManagerLink) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/customerManagerLinks/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates or updates customer manager links. Operation statuses are returned. - rpc MutateCustomerManagerLink(MutateCustomerManagerLinkRequest) - returns (MutateCustomerManagerLinkResponse) { + rpc MutateCustomerManagerLink(MutateCustomerManagerLinkRequest) returns (MutateCustomerManagerLinkResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/customerManagerLinks:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [CustomerManagerLinkService.GetCustomerManagerLink][google.ads.googleads.v1.services.CustomerManagerLinkService.GetCustomerManagerLink]. +// Request message for [CustomerManagerLinkService.GetCustomerManagerLink][google.ads.googleads.v1.services.CustomerManagerLinkService.GetCustomerManagerLink]. message GetCustomerManagerLinkRequest { - // The resource name of the CustomerManagerLink to fetch. - string resource_name = 1; + // Required. The resource name of the CustomerManagerLink to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerManagerLink" + } + ]; } -// Request message for -// [CustomerManagerLinkService.MutateCustomerManagerLink][google.ads.googleads.v1.services.CustomerManagerLinkService.MutateCustomerManagerLink]. +// Request message for [CustomerManagerLinkService.MutateCustomerManagerLink][google.ads.googleads.v1.services.CustomerManagerLinkService.MutateCustomerManagerLink]. message MutateCustomerManagerLinkRequest { - // The ID of the customer whose customer manager links are being modified. - string customer_id = 1; + // Required. The ID of the customer whose customer manager links are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual customer manager links. - repeated CustomerManagerLinkOperation operations = 2; + // Required. The list of operations to perform on individual customer manager links. + repeated CustomerManagerLinkOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; } // Updates the status of a CustomerManagerLink. diff --git a/third_party/googleapis/google/ads/googleads/v1/services/customer_negative_criterion_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/customer_negative_criterion_service.proto index bdcdc044c..939b8392a 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/customer_negative_criterion_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/customer_negative_criterion_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,7 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/customer_negative_criterion.proto"; import "google/api/annotations.proto"; -import "google/protobuf/wrappers.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -35,39 +36,46 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage customer negative criteria. service CustomerNegativeCriterionService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested criterion in full detail. - rpc GetCustomerNegativeCriterion(GetCustomerNegativeCriterionRequest) - returns (google.ads.googleads.v1.resources.CustomerNegativeCriterion) { + rpc GetCustomerNegativeCriterion(GetCustomerNegativeCriterionRequest) returns (google.ads.googleads.v1.resources.CustomerNegativeCriterion) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/customerNegativeCriteria/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates or removes criteria. Operation statuses are returned. - rpc MutateCustomerNegativeCriteria(MutateCustomerNegativeCriteriaRequest) - returns (MutateCustomerNegativeCriteriaResponse) { + rpc MutateCustomerNegativeCriteria(MutateCustomerNegativeCriteriaRequest) returns (MutateCustomerNegativeCriteriaResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/customerNegativeCriteria:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for // [CustomerNegativeCriterionService.GetCustomerNegativeCriterion][google.ads.googleads.v1.services.CustomerNegativeCriterionService.GetCustomerNegativeCriterion]. message GetCustomerNegativeCriterionRequest { - // The resource name of the criterion to fetch. - string resource_name = 1; + // Required. The resource name of the criterion to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerNegativeCriterion" + } + ]; } // Request message for // [CustomerNegativeCriterionService.MutateCustomerNegativeCriteria][google.ads.googleads.v1.services.CustomerNegativeCriterionService.MutateCustomerNegativeCriteria]. message MutateCustomerNegativeCriteriaRequest { - // The ID of the customer whose criteria are being modified. - string customer_id = 1; + // Required. The ID of the customer whose criteria are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual criteria. - repeated CustomerNegativeCriterionOperation operations = 2; + // Required. The list of operations to perform on individual criteria. + repeated CustomerNegativeCriterionOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/customer_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/customer_service.proto index 1fcfea14f..9b2eb12d0 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/customer_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/customer_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/customer.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/protobuf/wrappers.proto"; @@ -35,12 +37,14 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage customers. service CustomerService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested customer in full detail. - rpc GetCustomer(GetCustomerRequest) - returns (google.ads.googleads.v1.resources.Customer) { + rpc GetCustomer(GetCustomerRequest) returns (google.ads.googleads.v1.resources.Customer) { option (google.api.http) = { get: "/v1/{resource_name=customers/*}" }; + option (google.api.method_signature) = "resource_name"; } // Updates a customer. Operation statuses are returned. @@ -49,57 +53,59 @@ service CustomerService { post: "/v1/customers/{customer_id=*}:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operation"; } // Returns resource names of customers directly accessible by the // user authenticating the call. - rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) - returns (ListAccessibleCustomersResponse) { + rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) returns (ListAccessibleCustomersResponse) { option (google.api.http) = { get: "/v1/customers:listAccessibleCustomers" }; } // Creates a new client under manager. The new client customer is returned. - rpc CreateCustomerClient(CreateCustomerClientRequest) - returns (CreateCustomerClientResponse) { + rpc CreateCustomerClient(CreateCustomerClientRequest) returns (CreateCustomerClientResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}:createCustomerClient" body: "*" }; + option (google.api.method_signature) = "customer_id,customer_client"; } } -// Request message for -// [CustomerService.GetCustomer][google.ads.googleads.v1.services.CustomerService.GetCustomer]. +// Request message for [CustomerService.GetCustomer][google.ads.googleads.v1.services.CustomerService.GetCustomer]. message GetCustomerRequest { - // The resource name of the customer to fetch. - string resource_name = 1; + // Required. The resource name of the customer to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Customer" + } + ]; } -// Request message for -// [CustomerService.MutateCustomer][google.ads.googleads.v1.services.CustomerService.MutateCustomer]. +// Request message for [CustomerService.MutateCustomer][google.ads.googleads.v1.services.CustomerService.MutateCustomer]. message MutateCustomerRequest { - // The ID of the customer being modified. - string customer_id = 1; + // Required. The ID of the customer being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The operation to perform on the customer - CustomerOperation operation = 4; + // Required. The operation to perform on the customer + CustomerOperation operation = 4 [(google.api.field_behavior) = REQUIRED]; // If true, the request is validated but not executed. Only errors are // returned, not results. bool validate_only = 5; } -// Request message for -// [CustomerService.CreateCustomerClient][google.ads.googleads.v1.services.CustomerService.CreateCustomerClient]. +// Request message for [CustomerService.CreateCustomerClient][google.ads.googleads.v1.services.CustomerService.CreateCustomerClient]. message CreateCustomerClientRequest { - // The ID of the Manager under whom client customer is being created. - string customer_id = 1; + // Required. The ID of the Manager under whom client customer is being created. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The new client customer to create. The resource name on this customer + // Required. The new client customer to create. The resource name on this customer // will be ignored. - google.ads.googleads.v1.resources.Customer customer_client = 2; + google.ads.googleads.v1.resources.Customer customer_client = 2 [(google.api.field_behavior) = REQUIRED]; } // A single update on a customer. @@ -129,12 +135,12 @@ message MutateCustomerResult { string resource_name = 1; } -// Request message for -// [CustomerService.ListAccessibleCustomers][google.ads.googleads.v1.services.CustomerService.ListAccessibleCustomers]. -message ListAccessibleCustomersRequest {} +// Request message for [CustomerService.ListAccessibleCustomers][google.ads.googleads.v1.services.CustomerService.ListAccessibleCustomers]. +message ListAccessibleCustomersRequest { + +} -// Response message for -// [CustomerService.ListAccessibleCustomers][google.ads.googleads.v1.services.CustomerService.ListAccessibleCustomers]. +// Response message for [CustomerService.ListAccessibleCustomers][google.ads.googleads.v1.services.CustomerService.ListAccessibleCustomers]. message ListAccessibleCustomersResponse { // Resource name of customers directly accessible by the // user authenticating the call. diff --git a/third_party/googleapis/google/ads/googleads/v1/services/detail_placement_view_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/detail_placement_view_service.proto index 6c1d44ea8..ae057813c 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/detail_placement_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/detail_placement_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/detail_placement_view.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch Detail Placement views. service DetailPlacementViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested Detail Placement view in full detail. - rpc GetDetailPlacementView(GetDetailPlacementViewRequest) - returns (google.ads.googleads.v1.resources.DetailPlacementView) { + rpc GetDetailPlacementView(GetDetailPlacementViewRequest) returns (google.ads.googleads.v1.resources.DetailPlacementView) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/detailPlacementViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [DetailPlacementViewService.GetDetailPlacementView][google.ads.googleads.v1.services.DetailPlacementViewService.GetDetailPlacementView]. +// Request message for [DetailPlacementViewService.GetDetailPlacementView][google.ads.googleads.v1.services.DetailPlacementViewService.GetDetailPlacementView]. message GetDetailPlacementViewRequest { - // The resource name of the Detail Placement view to fetch. - string resource_name = 1; + // Required. The resource name of the Detail Placement view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DetailPlacementView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/display_keyword_view_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/display_keyword_view_service.proto index 7052cec34..177c2a366 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/display_keyword_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/display_keyword_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/display_keyword_view.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage display keyword views. service DisplayKeywordViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested display keyword view in full detail. - rpc GetDisplayKeywordView(GetDisplayKeywordViewRequest) - returns (google.ads.googleads.v1.resources.DisplayKeywordView) { + rpc GetDisplayKeywordView(GetDisplayKeywordViewRequest) returns (google.ads.googleads.v1.resources.DisplayKeywordView) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/displayKeywordViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [DisplayKeywordViewService.GetDisplayKeywordView][google.ads.googleads.v1.services.DisplayKeywordViewService.GetDisplayKeywordView]. +// Request message for [DisplayKeywordViewService.GetDisplayKeywordView][google.ads.googleads.v1.services.DisplayKeywordViewService.GetDisplayKeywordView]. message GetDisplayKeywordViewRequest { - // The resource name of the display keyword view to fetch. - string resource_name = 1; + // Required. The resource name of the display keyword view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DisplayKeywordView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/domain_category_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/domain_category_service.proto index 046117896..afdfb057d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/domain_category_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/domain_category_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/domain_category.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,25 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch domain categories. service DomainCategoryService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested domain category. - rpc GetDomainCategory(GetDomainCategoryRequest) - returns (google.ads.googleads.v1.resources.DomainCategory) { + rpc GetDomainCategory(GetDomainCategoryRequest) returns (google.ads.googleads.v1.resources.DomainCategory) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/domainCategories/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for // [DomainCategoryService.GetDomainCategory][google.ads.googleads.v1.services.DomainCategoryService.GetDomainCategory]. message GetDomainCategoryRequest { - // Resource name of the domain category to fetch. - string resource_name = 1; + // Required. Resource name of the domain category to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DomainCategory" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/dynamic_search_ads_search_term_view_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/dynamic_search_ads_search_term_view_service.proto index 2a1642a98..607ebf46e 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/dynamic_search_ads_search_term_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/dynamic_search_ads_search_term_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/dynamic_search_ads_search_term_view.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,20 +35,25 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch dynamic search ads views. service DynamicSearchAdsSearchTermViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested dynamic search ads search term view in full detail. - rpc GetDynamicSearchAdsSearchTermView( - GetDynamicSearchAdsSearchTermViewRequest) - returns ( - google.ads.googleads.v1.resources.DynamicSearchAdsSearchTermView) { + rpc GetDynamicSearchAdsSearchTermView(GetDynamicSearchAdsSearchTermViewRequest) returns (google.ads.googleads.v1.resources.DynamicSearchAdsSearchTermView) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/dynamicSearchAdsSearchTermViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for // [DynamicSearchAdsSearchTermViewService.GetDynamicSearchAdsSearchTermView][google.ads.googleads.v1.services.DynamicSearchAdsSearchTermViewService.GetDynamicSearchAdsSearchTermView]. message GetDynamicSearchAdsSearchTermViewRequest { - // The resource name of the dynamic search ads search term view to fetch. - string resource_name = 1; + // Required. The resource name of the dynamic search ads search term view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DynamicSearchAdsSearchTermView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/expanded_landing_page_view_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/expanded_landing_page_view_service.proto index d3950d83c..7d15ecb94 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/expanded_landing_page_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/expanded_landing_page_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,7 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/expanded_landing_page_view.proto"; import "google/api/annotations.proto"; -import "google/protobuf/wrappers.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -34,18 +35,25 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch expanded landing page views. service ExpandedLandingPageViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested expanded landing page view in full detail. - rpc GetExpandedLandingPageView(GetExpandedLandingPageViewRequest) - returns (google.ads.googleads.v1.resources.ExpandedLandingPageView) { + rpc GetExpandedLandingPageView(GetExpandedLandingPageViewRequest) returns (google.ads.googleads.v1.resources.ExpandedLandingPageView) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/expandedLandingPageViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for // [ExpandedLandingPageViewService.GetExpandedLandingPageView][google.ads.googleads.v1.services.ExpandedLandingPageViewService.GetExpandedLandingPageView]. message GetExpandedLandingPageViewRequest { - // The resource name of the expanded landing page view to fetch. - string resource_name = 1; + // Required. The resource name of the expanded landing page view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ExpandedLandingPageView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/extension_feed_item_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/extension_feed_item_service.proto index 6dc3b2ed1..c988e2f65 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/extension_feed_item_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/extension_feed_item_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/extension_feed_item.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -35,41 +36,46 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage extension feed items. service ExtensionFeedItemService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested extension feed item in full detail. - rpc GetExtensionFeedItem(GetExtensionFeedItemRequest) - returns (google.ads.googleads.v1.resources.ExtensionFeedItem) { + rpc GetExtensionFeedItem(GetExtensionFeedItemRequest) returns (google.ads.googleads.v1.resources.ExtensionFeedItem) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/extensionFeedItems/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes extension feed items. Operation // statuses are returned. - rpc MutateExtensionFeedItems(MutateExtensionFeedItemsRequest) - returns (MutateExtensionFeedItemsResponse) { + rpc MutateExtensionFeedItems(MutateExtensionFeedItemsRequest) returns (MutateExtensionFeedItemsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/extensionFeedItems:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [ExtensionFeedItemService.GetExtensionFeedItem][google.ads.googleads.v1.services.ExtensionFeedItemService.GetExtensionFeedItem]. +// Request message for [ExtensionFeedItemService.GetExtensionFeedItem][google.ads.googleads.v1.services.ExtensionFeedItemService.GetExtensionFeedItem]. message GetExtensionFeedItemRequest { - // The resource name of the extension feed item to fetch. - string resource_name = 1; + // Required. The resource name of the extension feed item to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ExtensionFeedItem" + } + ]; } -// Request message for -// [ExtensionFeedItemService.MutateExtensionFeedItems][google.ads.googleads.v1.services.ExtensionFeedItemService.MutateExtensionFeedItems]. +// Request message for [ExtensionFeedItemService.MutateExtensionFeedItems][google.ads.googleads.v1.services.ExtensionFeedItemService.MutateExtensionFeedItems]. message MutateExtensionFeedItemsRequest { - // The ID of the customer whose extension feed items are being + // Required. The ID of the customer whose extension feed items are being // modified. - string customer_id = 1; + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual extension feed items. - repeated ExtensionFeedItemOperation operations = 2; + // Required. The list of operations to perform on individual extension feed items. + repeated ExtensionFeedItemOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, the request is validated but not executed. Only errors are // returned, not results. diff --git a/third_party/googleapis/google/ads/googleads/v1/services/feed_item_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/feed_item_service.proto index e293f8ded..d476026d4 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/feed_item_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/feed_item_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/feed_item.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -36,40 +37,45 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage feed items. service FeedItemService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested feed item in full detail. - rpc GetFeedItem(GetFeedItemRequest) - returns (google.ads.googleads.v1.resources.FeedItem) { + rpc GetFeedItem(GetFeedItemRequest) returns (google.ads.googleads.v1.resources.FeedItem) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/feedItems/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes feed items. Operation statuses are // returned. - rpc MutateFeedItems(MutateFeedItemsRequest) - returns (MutateFeedItemsResponse) { + rpc MutateFeedItems(MutateFeedItemsRequest) returns (MutateFeedItemsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/feedItems:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [FeedItemService.GetFeedItem][google.ads.googleads.v1.services.FeedItemService.GetFeedItem]. +// Request message for [FeedItemService.GetFeedItem][google.ads.googleads.v1.services.FeedItemService.GetFeedItem]. message GetFeedItemRequest { - // The resource name of the feed item to fetch. - string resource_name = 1; + // Required. The resource name of the feed item to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedItem" + } + ]; } -// Request message for -// [FeedItemService.MutateFeedItems][google.ads.googleads.v1.services.FeedItemService.MutateFeedItems]. +// Request message for [FeedItemService.MutateFeedItems][google.ads.googleads.v1.services.FeedItemService.MutateFeedItems]. message MutateFeedItemsRequest { - // The ID of the customer whose feed items are being modified. - string customer_id = 1; + // Required. The ID of the customer whose feed items are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual feed items. - repeated FeedItemOperation operations = 2; + // Required. The list of operations to perform on individual feed items. + repeated FeedItemOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/feed_item_target_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/feed_item_target_service.proto index f710b0109..5f0953f10 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/feed_item_target_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/feed_item_target_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/feed_item_target.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,39 +35,44 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage feed item targets. service FeedItemTargetService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested feed item targets in full detail. - rpc GetFeedItemTarget(GetFeedItemTargetRequest) - returns (google.ads.googleads.v1.resources.FeedItemTarget) { + rpc GetFeedItemTarget(GetFeedItemTargetRequest) returns (google.ads.googleads.v1.resources.FeedItemTarget) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/feedItemTargets/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates or removes feed item targets. Operation statuses are returned. - rpc MutateFeedItemTargets(MutateFeedItemTargetsRequest) - returns (MutateFeedItemTargetsResponse) { + rpc MutateFeedItemTargets(MutateFeedItemTargetsRequest) returns (MutateFeedItemTargetsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/feedItemTargets:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [FeedItemTargetService.GetFeedItemTarget][google.ads.googleads.v1.services.FeedItemTargetService.GetFeedItemTarget]. +// Request message for [FeedItemTargetService.GetFeedItemTarget][google.ads.googleads.v1.services.FeedItemTargetService.GetFeedItemTarget]. message GetFeedItemTargetRequest { - // The resource name of the feed item targets to fetch. - string resource_name = 1; + // Required. The resource name of the feed item targets to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedItemTarget" + } + ]; } -// Request message for -// [FeedItemTargetService.MutateFeedItemTargets][google.ads.googleads.v1.services.FeedItemTargetService.MutateFeedItemTargets]. +// Request message for [FeedItemTargetService.MutateFeedItemTargets][google.ads.googleads.v1.services.FeedItemTargetService.MutateFeedItemTargets]. message MutateFeedItemTargetsRequest { - // The ID of the customer whose feed item targets are being modified. - string customer_id = 1; + // Required. The ID of the customer whose feed item targets are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual feed item targets. - repeated FeedItemTargetOperation operations = 2; + // Required. The list of operations to perform on individual feed item targets. + repeated FeedItemTargetOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; } // A single operation (create, remove) on an feed item target. @@ -79,7 +86,6 @@ message FeedItemTargetOperation { // Remove operation: A resource name for the removed feed item target is // expected, in this format: // - // // `customers/{customer_id}/feedItemTargets/{feed_id}~{feed_item_id}~{feed_item_target_type}~{feed_item_target_id}` string remove = 2; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/feed_mapping_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/feed_mapping_service.proto index 2e85a6005..39ee2c519 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/feed_mapping_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/feed_mapping_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,7 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/feed_mapping.proto"; import "google/api/annotations.proto"; -import "google/protobuf/wrappers.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -35,40 +36,45 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage feed mappings. service FeedMappingService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested feed mapping in full detail. - rpc GetFeedMapping(GetFeedMappingRequest) - returns (google.ads.googleads.v1.resources.FeedMapping) { + rpc GetFeedMapping(GetFeedMappingRequest) returns (google.ads.googleads.v1.resources.FeedMapping) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/feedMappings/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates or removes feed mappings. Operation statuses are // returned. - rpc MutateFeedMappings(MutateFeedMappingsRequest) - returns (MutateFeedMappingsResponse) { + rpc MutateFeedMappings(MutateFeedMappingsRequest) returns (MutateFeedMappingsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/feedMappings:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [FeedMappingService.GetFeedMapping][google.ads.googleads.v1.services.FeedMappingService.GetFeedMapping]. +// Request message for [FeedMappingService.GetFeedMapping][google.ads.googleads.v1.services.FeedMappingService.GetFeedMapping]. message GetFeedMappingRequest { - // The resource name of the feed mapping to fetch. - string resource_name = 1; + // Required. The resource name of the feed mapping to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedMapping" + } + ]; } -// Request message for -// [FeedMappingService.MutateFeedMappings][google.ads.googleads.v1.services.FeedMappingService.MutateFeedMappings]. +// Request message for [FeedMappingService.MutateFeedMappings][google.ads.googleads.v1.services.FeedMappingService.MutateFeedMappings]. message MutateFeedMappingsRequest { - // The ID of the customer whose feed mappings are being modified. - string customer_id = 1; + // Required. The ID of the customer whose feed mappings are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual feed mappings. - repeated FeedMappingOperation operations = 2; + // Required. The list of operations to perform on individual feed mappings. + repeated FeedMappingOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/feed_placeholder_view_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/feed_placeholder_view_service.proto index 6430fd9ee..2eec7014a 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/feed_placeholder_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/feed_placeholder_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/feed_placeholder_view.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch feed placeholder views. service FeedPlaceholderViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested feed placeholder view in full detail. - rpc GetFeedPlaceholderView(GetFeedPlaceholderViewRequest) - returns (google.ads.googleads.v1.resources.FeedPlaceholderView) { + rpc GetFeedPlaceholderView(GetFeedPlaceholderViewRequest) returns (google.ads.googleads.v1.resources.FeedPlaceholderView) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/feedPlaceholderViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [FeedPlaceholderViewService.GetFeedPlaceholderView][google.ads.googleads.v1.services.FeedPlaceholderViewService.GetFeedPlaceholderView]. +// Request message for [FeedPlaceholderViewService.GetFeedPlaceholderView][google.ads.googleads.v1.services.FeedPlaceholderViewService.GetFeedPlaceholderView]. message GetFeedPlaceholderViewRequest { - // The resource name of the feed placeholder view to fetch. - string resource_name = 1; + // Required. The resource name of the feed placeholder view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedPlaceholderView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/feed_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/feed_service.proto index a3964a64f..0de0bb37a 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/feed_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/feed_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/feed.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -36,11 +37,14 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage feeds. service FeedService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested feed in full detail. rpc GetFeed(GetFeedRequest) returns (google.ads.googleads.v1.resources.Feed) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/feeds/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes feeds. Operation statuses are @@ -50,24 +54,28 @@ service FeedService { post: "/v1/customers/{customer_id=*}/feeds:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [FeedService.GetFeed][google.ads.googleads.v1.services.FeedService.GetFeed]. +// Request message for [FeedService.GetFeed][google.ads.googleads.v1.services.FeedService.GetFeed]. message GetFeedRequest { - // The resource name of the feed to fetch. - string resource_name = 1; + // Required. The resource name of the feed to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; } -// Request message for -// [FeedService.MutateFeeds][google.ads.googleads.v1.services.FeedService.MutateFeeds]. +// Request message for [FeedService.MutateFeeds][google.ads.googleads.v1.services.FeedService.MutateFeeds]. message MutateFeedsRequest { - // The ID of the customer whose feeds are being modified. - string customer_id = 1; + // Required. The ID of the customer whose feeds are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual feeds. - repeated FeedOperation operations = 2; + // Required. The list of operations to perform on individual feeds. + repeated FeedOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/gender_view_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/gender_view_service.proto index 51c08635a..fc6b3db21 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/gender_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/gender_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/gender_view.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage gender views. service GenderViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested gender view in full detail. - rpc GetGenderView(GetGenderViewRequest) - returns (google.ads.googleads.v1.resources.GenderView) { + rpc GetGenderView(GetGenderViewRequest) returns (google.ads.googleads.v1.resources.GenderView) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/genderViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [GenderViewService.GetGenderView][google.ads.googleads.v1.services.GenderViewService.GetGenderView]. +// Request message for [GenderViewService.GetGenderView][google.ads.googleads.v1.services.GenderViewService.GetGenderView]. message GetGenderViewRequest { - // The resource name of the gender view to fetch. - string resource_name = 1; + // Required. The resource name of the gender view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GenderView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/geo_target_constant_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/geo_target_constant_service.proto index ce79e7ad1..f403dec83 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/geo_target_constant_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/geo_target_constant_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/geo_target_constant.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -34,17 +36,18 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch geo target constants. service GeoTargetConstantService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested geo target constant in full detail. - rpc GetGeoTargetConstant(GetGeoTargetConstantRequest) - returns (google.ads.googleads.v1.resources.GeoTargetConstant) { + rpc GetGeoTargetConstant(GetGeoTargetConstantRequest) returns (google.ads.googleads.v1.resources.GeoTargetConstant) { option (google.api.http) = { get: "/v1/{resource_name=geoTargetConstants/*}" }; + option (google.api.method_signature) = "resource_name"; } // Returns GeoTargetConstant suggestions by location name or by resource name. - rpc SuggestGeoTargetConstants(SuggestGeoTargetConstantsRequest) - returns (SuggestGeoTargetConstantsResponse) { + rpc SuggestGeoTargetConstants(SuggestGeoTargetConstantsRequest) returns (SuggestGeoTargetConstantsResponse) { option (google.api.http) = { post: "/v1/geoTargetConstants:suggest" body: "*" @@ -52,11 +55,15 @@ service GeoTargetConstantService { } } -// Request message for -// [GeoTargetConstantService.GetGeoTargetConstant][google.ads.googleads.v1.services.GeoTargetConstantService.GetGeoTargetConstant]. +// Request message for [GeoTargetConstantService.GetGeoTargetConstant][google.ads.googleads.v1.services.GeoTargetConstantService.GetGeoTargetConstant]. message GetGeoTargetConstantRequest { - // The resource name of the geo target constant to fetch. - string resource_name = 1; + // Required. The resource name of the geo target constant to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GeoTargetConstant" + } + ]; } // Request message for @@ -92,8 +99,7 @@ message SuggestGeoTargetConstantsRequest { } } -// Response message for -// [GeoTargetConstantService.SuggestGeoTargetConstants][google.ads.googleads.v1.services.GeoTargetConstantService.SuggestGeoTargetConstants] +// Response message for [GeoTargetConstantService.SuggestGeoTargetConstants][google.ads.googleads.v1.services.GeoTargetConstantService.SuggestGeoTargetConstants] message SuggestGeoTargetConstantsResponse { // Geo target constant suggestions. repeated GeoTargetConstantSuggestion geo_target_constant_suggestions = 1; @@ -119,6 +125,5 @@ message GeoTargetConstantSuggestion { google.ads.googleads.v1.resources.GeoTargetConstant geo_target_constant = 4; // The list of parents of the geo target constant. - repeated google.ads.googleads.v1.resources.GeoTargetConstant - geo_target_constant_parents = 5; + repeated google.ads.googleads.v1.resources.GeoTargetConstant geo_target_constant_parents = 5; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/geographic_view_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/geographic_view_service.proto index f30ab4287..ef25b2bd6 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/geographic_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/geographic_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/geographic_view.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage geographic views. service GeographicViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested geographic view in full detail. - rpc GetGeographicView(GetGeographicViewRequest) - returns (google.ads.googleads.v1.resources.GeographicView) { + rpc GetGeographicView(GetGeographicViewRequest) returns (google.ads.googleads.v1.resources.GeographicView) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/geographicViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [GeographicViewService.GetGeographicView][google.ads.googleads.v1.services.GeographicViewService.GetGeographicView]. +// Request message for [GeographicViewService.GetGeographicView][google.ads.googleads.v1.services.GeographicViewService.GetGeographicView]. message GetGeographicViewRequest { - // The resource name of the geographic view to fetch. - string resource_name = 1; + // Required. The resource name of the geographic view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GeographicView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/google_ads_field_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/google_ads_field_service.proto index 1bf9a6159..8a8c5cc68 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/google_ads_field_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/google_ads_field_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/google_ads_field.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,36 +35,41 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch Google Ads API fields. service GoogleAdsFieldService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns just the requested field. - rpc GetGoogleAdsField(GetGoogleAdsFieldRequest) - returns (google.ads.googleads.v1.resources.GoogleAdsField) { + rpc GetGoogleAdsField(GetGoogleAdsFieldRequest) returns (google.ads.googleads.v1.resources.GoogleAdsField) { option (google.api.http) = { get: "/v1/{resource_name=googleAdsFields/*}" }; + option (google.api.method_signature) = "resource_name"; } // Returns all fields that match the search query. - rpc SearchGoogleAdsFields(SearchGoogleAdsFieldsRequest) - returns (SearchGoogleAdsFieldsResponse) { + rpc SearchGoogleAdsFields(SearchGoogleAdsFieldsRequest) returns (SearchGoogleAdsFieldsResponse) { option (google.api.http) = { post: "/v1/googleAdsFields:search" body: "*" }; + option (google.api.method_signature) = "query"; } } -// Request message for -// [GoogleAdsFieldService.GetGoogleAdsField][google.ads.googleads.v1.services.GoogleAdsFieldService.GetGoogleAdsField]. +// Request message for [GoogleAdsFieldService.GetGoogleAdsField][google.ads.googleads.v1.services.GoogleAdsFieldService.GetGoogleAdsField]. message GetGoogleAdsFieldRequest { - // The resource name of the field to get. - string resource_name = 1; + // Required. The resource name of the field to get. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GoogleAdsField" + } + ]; } -// Request message for -// [GoogleAdsFieldService.SearchGoogleAdsFields][google.ads.googleads.v1.services.GoogleAdsFieldService.SearchGoogleAdsFields]. +// Request message for [GoogleAdsFieldService.SearchGoogleAdsFields][google.ads.googleads.v1.services.GoogleAdsFieldService.SearchGoogleAdsFields]. message SearchGoogleAdsFieldsRequest { - // The query string. - string query = 1; + // Required. The query string. + string query = 1 [(google.api.field_behavior) = REQUIRED]; // Token of the page to retrieve. If not specified, the first page of // results will be returned. Use the value obtained from `next_page_token` @@ -75,8 +82,7 @@ message SearchGoogleAdsFieldsRequest { int32 page_size = 3; } -// Response message for -// [GoogleAdsFieldService.SearchGoogleAdsFields][google.ads.googleads.v1.services.GoogleAdsFieldService.SearchGoogleAdsFields]. +// Response message for [GoogleAdsFieldService.SearchGoogleAdsFields][google.ads.googleads.v1.services.GoogleAdsFieldService.SearchGoogleAdsFields]. message SearchGoogleAdsFieldsResponse { // The list of fields that matched the query. repeated google.ads.googleads.v1.resources.GoogleAdsField results = 1; diff --git a/third_party/googleapis/google/ads/googleads/v1/services/google_ads_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/google_ads_service.proto index 92cc352e8..6aefc793f 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/google_ads_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/google_ads_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -152,6 +151,8 @@ import "google/ads/googleads/v1/services/shared_criterion_service.proto"; import "google/ads/googleads/v1/services/shared_set_service.proto"; import "google/ads/googleads/v1/services/user_list_service.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; @@ -168,12 +169,15 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch data and metrics across resources. service GoogleAdsService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns all rows that match the search query. rpc Search(SearchGoogleAdsRequest) returns (SearchGoogleAdsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/googleAds:search" body: "*" }; + option (google.api.method_signature) = "customer_id,query"; } // Creates, updates, or removes resources. This method supports atomic @@ -183,9 +187,10 @@ service GoogleAdsService { // // This method is essentially a wrapper around a series of mutate methods. The // only features it offers over calling those methods directly are: + // // - Atomic transactions // - Temp resource names (described below) - // - Somewhat reduced latency over making a series of mutate calls. + // - Somewhat reduced latency over making a series of mutate calls // // Note: Only resources that support atomic transactions are included, so this // method can't replace all calls to individual services. @@ -201,15 +206,16 @@ service GoogleAdsService { // // Temp resource names are a special type of resource name used to create a // resource and reference that resource in the same request. For example, if a - // campaign budget is created with 'resource_name' equal to - // 'customers/123/campaignBudgets/-1', that resource name can be reused in - // the 'Campaign.budget' field in the same request. That way, the two + // campaign budget is created with `resource_name` equal to + // `customers/123/campaignBudgets/-1`, that resource name can be reused in + // the `Campaign.budget` field in the same request. That way, the two // resources are created and linked atomically. // // To create a temp resource name, put a negative number in the part of the // name that the server would normally allocate. // // Note: + // // - Resources must be created with a temp name before the name can be reused. // For example, the previous CampaignBudget+Campaign example would fail if // the mutate order was reversed. @@ -230,17 +236,17 @@ service GoogleAdsService { post: "/v1/customers/{customer_id=*}/googleAds:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,mutate_operations"; } } -// Request message for -// [GoogleAdsService.Search][google.ads.googleads.v1.services.GoogleAdsService.Search]. +// Request message for [GoogleAdsService.Search][google.ads.googleads.v1.services.GoogleAdsService.Search]. message SearchGoogleAdsRequest { - // The ID of the customer being queried. - string customer_id = 1; + // Required. The ID of the customer being queried. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The query string. - string query = 2; + // Required. The query string. + string query = 2 [(google.api.field_behavior) = REQUIRED]; // Token of the page to retrieve. If not specified, the first // page of results will be returned. Use the value obtained from @@ -257,8 +263,7 @@ message SearchGoogleAdsRequest { bool validate_only = 5; } -// Response message for -// [GoogleAdsService.Search][google.ads.googleads.v1.services.GoogleAdsService.Search]. +// Response message for [GoogleAdsService.Search][google.ads.googleads.v1.services.GoogleAdsService.Search]. message SearchGoogleAdsResponse { // The list of rows that matched the query. repeated GoogleAdsRow results = 1; @@ -283,8 +288,7 @@ message GoogleAdsRow { google.ads.googleads.v1.resources.AccountBudget account_budget = 42; // The account budget proposal referenced in the query. - google.ads.googleads.v1.resources.AccountBudgetProposal - account_budget_proposal = 43; + google.ads.googleads.v1.resources.AccountBudgetProposal account_budget_proposal = 43; // The ad group referenced in the query. google.ads.googleads.v1.resources.AdGroup ad_group = 3; @@ -296,27 +300,22 @@ message GoogleAdsRow { google.ads.googleads.v1.resources.AdGroupAdLabel ad_group_ad_label = 120; // The ad group audience view referenced in the query. - google.ads.googleads.v1.resources.AdGroupAudienceView ad_group_audience_view = - 57; + google.ads.googleads.v1.resources.AdGroupAudienceView ad_group_audience_view = 57; // The bid modifier referenced in the query. - google.ads.googleads.v1.resources.AdGroupBidModifier ad_group_bid_modifier = - 24; + google.ads.googleads.v1.resources.AdGroupBidModifier ad_group_bid_modifier = 24; // The criterion referenced in the query. google.ads.googleads.v1.resources.AdGroupCriterion ad_group_criterion = 17; // The ad group criterion label referenced in the query. - google.ads.googleads.v1.resources.AdGroupCriterionLabel - ad_group_criterion_label = 121; + google.ads.googleads.v1.resources.AdGroupCriterionLabel ad_group_criterion_label = 121; // The ad group criterion simulation referenced in the query. - google.ads.googleads.v1.resources.AdGroupCriterionSimulation - ad_group_criterion_simulation = 110; + google.ads.googleads.v1.resources.AdGroupCriterionSimulation ad_group_criterion_simulation = 110; // The ad group extension setting referenced in the query. - google.ads.googleads.v1.resources.AdGroupExtensionSetting - ad_group_extension_setting = 112; + google.ads.googleads.v1.resources.AdGroupExtensionSetting ad_group_extension_setting = 112; // The ad group feed referenced in the query. google.ads.googleads.v1.resources.AdGroupFeed ad_group_feed = 67; @@ -355,19 +354,16 @@ message GoogleAdsRow { google.ads.googleads.v1.resources.Campaign campaign = 2; // The campaign audience view referenced in the query. - google.ads.googleads.v1.resources.CampaignAudienceView - campaign_audience_view = 69; + google.ads.googleads.v1.resources.CampaignAudienceView campaign_audience_view = 69; // The campaign bid modifier referenced in the query. - google.ads.googleads.v1.resources.CampaignBidModifier campaign_bid_modifier = - 26; + google.ads.googleads.v1.resources.CampaignBidModifier campaign_bid_modifier = 26; // The campaign criterion referenced in the query. google.ads.googleads.v1.resources.CampaignCriterion campaign_criterion = 20; // The campaign criterion simulation referenced in the query. - google.ads.googleads.v1.resources.CampaignCriterionSimulation - campaign_criterion_simulation = 111; + google.ads.googleads.v1.resources.CampaignCriterionSimulation campaign_criterion_simulation = 111; // The campaign draft referenced in the query. google.ads.googleads.v1.resources.CampaignDraft campaign_draft = 49; @@ -376,8 +372,7 @@ message GoogleAdsRow { google.ads.googleads.v1.resources.CampaignExperiment campaign_experiment = 84; // The campaign extension setting referenced in the query. - google.ads.googleads.v1.resources.CampaignExtensionSetting - campaign_extension_setting = 113; + google.ads.googleads.v1.resources.CampaignExtensionSetting campaign_extension_setting = 113; // The campaign feed referenced in the query. google.ads.googleads.v1.resources.CampaignFeed campaign_feed = 63; @@ -407,19 +402,16 @@ message GoogleAdsRow { google.ads.googleads.v1.resources.Customer customer = 1; // The CustomerManagerLink referenced in the query. - google.ads.googleads.v1.resources.CustomerManagerLink customer_manager_link = - 61; + google.ads.googleads.v1.resources.CustomerManagerLink customer_manager_link = 61; // The CustomerClientLink referenced in the query. - google.ads.googleads.v1.resources.CustomerClientLink customer_client_link = - 62; + google.ads.googleads.v1.resources.CustomerClientLink customer_client_link = 62; // The CustomerClient referenced in the query. google.ads.googleads.v1.resources.CustomerClient customer_client = 70; // The customer extension setting referenced in the query. - google.ads.googleads.v1.resources.CustomerExtensionSetting - customer_extension_setting = 114; + google.ads.googleads.v1.resources.CustomerExtensionSetting customer_extension_setting = 114; // The customer feed referenced in the query. google.ads.googleads.v1.resources.CustomerFeed customer_feed = 64; @@ -428,24 +420,19 @@ message GoogleAdsRow { google.ads.googleads.v1.resources.CustomerLabel customer_label = 124; // The customer negative criterion referenced in the query. - google.ads.googleads.v1.resources.CustomerNegativeCriterion - customer_negative_criterion = 88; + google.ads.googleads.v1.resources.CustomerNegativeCriterion customer_negative_criterion = 88; // The detail placement view referenced in the query. - google.ads.googleads.v1.resources.DetailPlacementView detail_placement_view = - 118; + google.ads.googleads.v1.resources.DetailPlacementView detail_placement_view = 118; // The display keyword view referenced in the query. - google.ads.googleads.v1.resources.DisplayKeywordView display_keyword_view = - 47; + google.ads.googleads.v1.resources.DisplayKeywordView display_keyword_view = 47; // The dynamic search ads search term view referenced in the query. - google.ads.googleads.v1.resources.DynamicSearchAdsSearchTermView - dynamic_search_ads_search_term_view = 106; + google.ads.googleads.v1.resources.DynamicSearchAdsSearchTermView dynamic_search_ads_search_term_view = 106; // The expanded landing page view referenced in the query. - google.ads.googleads.v1.resources.ExpandedLandingPageView - expanded_landing_page_view = 128; + google.ads.googleads.v1.resources.ExpandedLandingPageView expanded_landing_page_view = 128; // The extension feed item referenced in the query. google.ads.googleads.v1.resources.ExtensionFeedItem extension_feed_item = 85; @@ -463,8 +450,7 @@ message GoogleAdsRow { google.ads.googleads.v1.resources.FeedMapping feed_mapping = 58; // The feed placeholder view referenced in the query. - google.ads.googleads.v1.resources.FeedPlaceholderView feed_placeholder_view = - 97; + google.ads.googleads.v1.resources.FeedPlaceholderView feed_placeholder_view = 97; // The gender view referenced in the query. google.ads.googleads.v1.resources.GenderView gender_view = 40; @@ -476,15 +462,13 @@ message GoogleAdsRow { google.ads.googleads.v1.resources.GeographicView geographic_view = 125; // The group placement view referenced in the query. - google.ads.googleads.v1.resources.GroupPlacementView group_placement_view = - 119; + google.ads.googleads.v1.resources.GroupPlacementView group_placement_view = 119; // The hotel group view referenced in the query. google.ads.googleads.v1.resources.HotelGroupView hotel_group_view = 51; // The hotel performance view referenced in the query. - google.ads.googleads.v1.resources.HotelPerformanceView - hotel_performance_view = 71; + google.ads.googleads.v1.resources.HotelPerformanceView hotel_performance_view = 71; // The keyword view referenced in the query. google.ads.googleads.v1.resources.KeywordView keyword_view = 21; @@ -493,20 +477,16 @@ message GoogleAdsRow { google.ads.googleads.v1.resources.KeywordPlan keyword_plan = 32; // The keyword plan campaign referenced in the query. - google.ads.googleads.v1.resources.KeywordPlanCampaign keyword_plan_campaign = - 33; + google.ads.googleads.v1.resources.KeywordPlanCampaign keyword_plan_campaign = 33; // The keyword plan negative keyword referenced in the query. - google.ads.googleads.v1.resources.KeywordPlanNegativeKeyword - keyword_plan_negative_keyword = 34; + google.ads.googleads.v1.resources.KeywordPlanNegativeKeyword keyword_plan_negative_keyword = 34; // The keyword plan ad group referenced in the query. - google.ads.googleads.v1.resources.KeywordPlanAdGroup keyword_plan_ad_group = - 35; + google.ads.googleads.v1.resources.KeywordPlanAdGroup keyword_plan_ad_group = 35; // The keyword plan keyword referenced in the query. - google.ads.googleads.v1.resources.KeywordPlanKeyword keyword_plan_keyword = - 36; + google.ads.googleads.v1.resources.KeywordPlanKeyword keyword_plan_keyword = 36; // The label referenced in the query. google.ads.googleads.v1.resources.Label label = 52; @@ -521,38 +501,31 @@ message GoogleAdsRow { google.ads.googleads.v1.resources.LocationView location_view = 123; // The managed placement view referenced in the query. - google.ads.googleads.v1.resources.ManagedPlacementView - managed_placement_view = 53; + google.ads.googleads.v1.resources.ManagedPlacementView managed_placement_view = 53; // The media file referenced in the query. google.ads.googleads.v1.resources.MediaFile media_file = 90; // The mobile app category constant referenced in the query. - google.ads.googleads.v1.resources.MobileAppCategoryConstant - mobile_app_category_constant = 87; + google.ads.googleads.v1.resources.MobileAppCategoryConstant mobile_app_category_constant = 87; // The mobile device constant referenced in the query. - google.ads.googleads.v1.resources.MobileDeviceConstant - mobile_device_constant = 98; + google.ads.googleads.v1.resources.MobileDeviceConstant mobile_device_constant = 98; // The mutate job referenced in the query. google.ads.googleads.v1.resources.MutateJob mutate_job = 127; // The operating system version constant referenced in the query. - google.ads.googleads.v1.resources.OperatingSystemVersionConstant - operating_system_version_constant = 86; + google.ads.googleads.v1.resources.OperatingSystemVersionConstant operating_system_version_constant = 86; // The paid organic search term view referenced in the query. - google.ads.googleads.v1.resources.PaidOrganicSearchTermView - paid_organic_search_term_view = 129; + google.ads.googleads.v1.resources.PaidOrganicSearchTermView paid_organic_search_term_view = 129; // The parental status view referenced in the query. - google.ads.googleads.v1.resources.ParentalStatusView parental_status_view = - 45; + google.ads.googleads.v1.resources.ParentalStatusView parental_status_view = 45; // The Product Bidding Category referenced in the query. - google.ads.googleads.v1.resources.ProductBiddingCategoryConstant - product_bidding_category_constant = 109; + google.ads.googleads.v1.resources.ProductBiddingCategoryConstant product_bidding_category_constant = 109; // The product group view referenced in the query. google.ads.googleads.v1.resources.ProductGroupView product_group_view = 54; @@ -570,8 +543,7 @@ message GoogleAdsRow { google.ads.googleads.v1.resources.SharedSet shared_set = 27; // The shopping performance view referenced in the query. - google.ads.googleads.v1.resources.ShoppingPerformanceView - shopping_performance_view = 117; + google.ads.googleads.v1.resources.ShoppingPerformanceView shopping_performance_view = 117; // The topic view referenced in the query. google.ads.googleads.v1.resources.TopicView topic_view = 44; @@ -598,14 +570,13 @@ message GoogleAdsRow { google.ads.googleads.v1.common.Segments segments = 102; } -// Request message for -// [GoogleAdsService.Mutate][google.ads.googleads.v1.services.GoogleAdsService.Mutate]. +// Request message for [GoogleAdsService.Mutate][google.ads.googleads.v1.services.GoogleAdsService.Mutate]. message MutateGoogleAdsRequest { - // The ID of the customer whose resources are being modified. - string customer_id = 1; + // Required. The ID of the customer whose resources are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual resources. - repeated MutateOperation mutate_operations = 2; + // Required. The list of operations to perform on individual resources. + repeated MutateOperation mutate_operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried @@ -618,12 +589,11 @@ message MutateGoogleAdsRequest { bool validate_only = 4; } -// Response message for -// [GoogleAdsService.Mutate][google.ads.googleads.v1.services.GoogleAdsService.Mutate]. +// Response message for [GoogleAdsService.Mutate][google.ads.googleads.v1.services.GoogleAdsService.Mutate]. message MutateGoogleAdsResponse { // Errors that pertain to operation failures in the partial failure mode. // Returned only when partial_failure = true and all errors occur inside the - // operations. If any errors occur outside the operations (e.g. auth errors), + // operations. If any errors occur outside the operations (e.g., auth errors), // we return an RPC level error. google.rpc.Status partial_failure_error = 3; @@ -714,8 +684,7 @@ message MutateOperation { CustomerLabelOperation customer_label_operation = 32; // A customer negative criterion mutate operation. - CustomerNegativeCriterionOperation customer_negative_criterion_operation = - 34; + CustomerNegativeCriterionOperation customer_negative_criterion_operation = 34; // A customer mutate operation. CustomerOperation customer_operation = 35; @@ -757,7 +726,7 @@ message MutateOperation { // Response message for the resource mutate. message MutateOperationResponse { - // The mutate response + // The mutate response. oneof response { // The result for the ad group ad label mutate. MutateAdGroupAdLabelResult ad_group_ad_label_result = 17; @@ -838,8 +807,7 @@ message MutateOperationResponse { MutateCustomerLabelResult customer_label_result = 32; // The result for the customer negative criterion mutate. - MutateCustomerNegativeCriteriaResult customer_negative_criterion_result = - 34; + MutateCustomerNegativeCriteriaResult customer_negative_criterion_result = 34; // The result for the customer mutate. MutateCustomerResult customer_result = 35; diff --git a/third_party/googleapis/google/ads/googleads/v1/services/group_placement_view_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/group_placement_view_service.proto index f6071e887..e5fb3a0bd 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/group_placement_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/group_placement_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/group_placement_view.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch Group Placement views. service GroupPlacementViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested Group Placement view in full detail. - rpc GetGroupPlacementView(GetGroupPlacementViewRequest) - returns (google.ads.googleads.v1.resources.GroupPlacementView) { + rpc GetGroupPlacementView(GetGroupPlacementViewRequest) returns (google.ads.googleads.v1.resources.GroupPlacementView) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/groupPlacementViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [GroupPlacementViewService.GetGroupPlacementView][google.ads.googleads.v1.services.GroupPlacementViewService.GetGroupPlacementView]. +// Request message for [GroupPlacementViewService.GetGroupPlacementView][google.ads.googleads.v1.services.GroupPlacementViewService.GetGroupPlacementView]. message GetGroupPlacementViewRequest { - // The resource name of the Group Placement view to fetch. - string resource_name = 1; + // Required. The resource name of the Group Placement view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GroupPlacementView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/hotel_group_view_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/hotel_group_view_service.proto index 745035c36..a2b9f3d61 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/hotel_group_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/hotel_group_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/hotel_group_view.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage Hotel Group Views. service HotelGroupViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested Hotel Group View in full detail. - rpc GetHotelGroupView(GetHotelGroupViewRequest) - returns (google.ads.googleads.v1.resources.HotelGroupView) { + rpc GetHotelGroupView(GetHotelGroupViewRequest) returns (google.ads.googleads.v1.resources.HotelGroupView) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/hotelGroupViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [HotelGroupViewService.GetHotelGroupView][google.ads.googleads.v1.services.HotelGroupViewService.GetHotelGroupView]. +// Request message for [HotelGroupViewService.GetHotelGroupView][google.ads.googleads.v1.services.HotelGroupViewService.GetHotelGroupView]. message GetHotelGroupViewRequest { - // Resource name of the Hotel Group View to fetch. - string resource_name = 1; + // Required. Resource name of the Hotel Group View to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/HotelGroupView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/hotel_performance_view_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/hotel_performance_view_service.proto index 08344d7ec..0eaa5f956 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/hotel_performance_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/hotel_performance_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/hotel_performance_view.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage Hotel Performance Views. service HotelPerformanceViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested Hotel Performance View in full detail. - rpc GetHotelPerformanceView(GetHotelPerformanceViewRequest) - returns (google.ads.googleads.v1.resources.HotelPerformanceView) { + rpc GetHotelPerformanceView(GetHotelPerformanceViewRequest) returns (google.ads.googleads.v1.resources.HotelPerformanceView) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/hotelPerformanceView}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [HotelPerformanceViewService.GetHotelPerformanceView][google.ads.googleads.v1.services.HotelPerformanceViewService.GetHotelPerformanceView]. +// Request message for [HotelPerformanceViewService.GetHotelPerformanceView][google.ads.googleads.v1.services.HotelPerformanceViewService.GetHotelPerformanceView]. message GetHotelPerformanceViewRequest { - // Resource name of the Hotel Performance View to fetch. - string resource_name = 1; + // Required. Resource name of the Hotel Performance View to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/HotelPerformanceView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/keyword_plan_ad_group_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/keyword_plan_ad_group_service.proto index b40a603b6..fcdb02d73 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/keyword_plan_ad_group_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/keyword_plan_ad_group_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/keyword_plan_ad_group.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -36,40 +37,45 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage Keyword Plan ad groups. service KeywordPlanAdGroupService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested Keyword Plan ad group in full detail. - rpc GetKeywordPlanAdGroup(GetKeywordPlanAdGroupRequest) - returns (google.ads.googleads.v1.resources.KeywordPlanAdGroup) { + rpc GetKeywordPlanAdGroup(GetKeywordPlanAdGroupRequest) returns (google.ads.googleads.v1.resources.KeywordPlanAdGroup) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/keywordPlanAdGroups/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes Keyword Plan ad groups. Operation statuses are // returned. - rpc MutateKeywordPlanAdGroups(MutateKeywordPlanAdGroupsRequest) - returns (MutateKeywordPlanAdGroupsResponse) { + rpc MutateKeywordPlanAdGroups(MutateKeywordPlanAdGroupsRequest) returns (MutateKeywordPlanAdGroupsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/keywordPlanAdGroups:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [KeywordPlanAdGroupService.GetKeywordPlanAdGroup][google.ads.googleads.v1.services.KeywordPlanAdGroupService.GetKeywordPlanAdGroup]. +// Request message for [KeywordPlanAdGroupService.GetKeywordPlanAdGroup][google.ads.googleads.v1.services.KeywordPlanAdGroupService.GetKeywordPlanAdGroup]. message GetKeywordPlanAdGroupRequest { - // The resource name of the Keyword Plan ad group to fetch. - string resource_name = 1; + // Required. The resource name of the Keyword Plan ad group to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanAdGroup" + } + ]; } -// Request message for -// [KeywordPlanAdGroupService.MutateKeywordPlanAdGroups][google.ads.googleads.v1.services.KeywordPlanAdGroupService.MutateKeywordPlanAdGroups]. +// Request message for [KeywordPlanAdGroupService.MutateKeywordPlanAdGroups][google.ads.googleads.v1.services.KeywordPlanAdGroupService.MutateKeywordPlanAdGroups]. message MutateKeywordPlanAdGroupsRequest { - // The ID of the customer whose Keyword Plan ad groups are being modified. - string customer_id = 1; + // Required. The ID of the customer whose Keyword Plan ad groups are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual Keyword Plan ad groups. - repeated KeywordPlanAdGroupOperation operations = 2; + // Required. The list of operations to perform on individual Keyword Plan ad groups. + repeated KeywordPlanAdGroupOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/keyword_plan_campaign_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/keyword_plan_campaign_service.proto index bb1e301ab..0d111dfc2 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/keyword_plan_campaign_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/keyword_plan_campaign_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/keyword_plan_campaign.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -36,40 +37,46 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage Keyword Plan campaigns. service KeywordPlanCampaignService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested Keyword Plan campaign in full detail. - rpc GetKeywordPlanCampaign(GetKeywordPlanCampaignRequest) - returns (google.ads.googleads.v1.resources.KeywordPlanCampaign) { + rpc GetKeywordPlanCampaign(GetKeywordPlanCampaignRequest) returns (google.ads.googleads.v1.resources.KeywordPlanCampaign) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/keywordPlanCampaigns/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes Keyword Plan campaigns. Operation statuses are // returned. - rpc MutateKeywordPlanCampaigns(MutateKeywordPlanCampaignsRequest) - returns (MutateKeywordPlanCampaignsResponse) { + rpc MutateKeywordPlanCampaigns(MutateKeywordPlanCampaignsRequest) returns (MutateKeywordPlanCampaignsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/keywordPlanCampaigns:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [KeywordPlanCampaignService.GetKeywordPlanCampaign][google.ads.googleads.v1.services.KeywordPlanCampaignService.GetKeywordPlanCampaign]. +// Request message for [KeywordPlanCampaignService.GetKeywordPlanCampaign][google.ads.googleads.v1.services.KeywordPlanCampaignService.GetKeywordPlanCampaign]. message GetKeywordPlanCampaignRequest { - // The resource name of the Keyword Plan campaign to fetch. - string resource_name = 1; + // Required. The resource name of the Keyword Plan campaign to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanCampaign" + } + ]; } // Request message for // [KeywordPlanCampaignService.MutateKeywordPlanCampaigns][google.ads.googleads.v1.services.KeywordPlanCampaignService.MutateKeywordPlanCampaigns]. message MutateKeywordPlanCampaignsRequest { - // The ID of the customer whose Keyword Plan campaigns are being modified. - string customer_id = 1; + // Required. The ID of the customer whose Keyword Plan campaigns are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual Keyword Plan campaigns. - repeated KeywordPlanCampaignOperation operations = 2; + // Required. The list of operations to perform on individual Keyword Plan campaigns. + repeated KeywordPlanCampaignOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/keyword_plan_idea_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/keyword_plan_idea_service.proto index f009288c1..2e9beedfe 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/keyword_plan_idea_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/keyword_plan_idea_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,7 +19,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/common/keyword_plan_common.proto"; import "google/ads/googleads/v1/enums/keyword_plan_network.proto"; import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; import "google/protobuf/wrappers.proto"; +import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -35,9 +36,10 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to generate keyword ideas. service KeywordPlanIdeaService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns a list of keyword ideas. - rpc GenerateKeywordIdeas(GenerateKeywordIdeasRequest) - returns (GenerateKeywordIdeaResponse) { + rpc GenerateKeywordIdeas(GenerateKeywordIdeasRequest) returns (GenerateKeywordIdeaResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}:generateKeywordIdeas" body: "*" @@ -50,17 +52,16 @@ message GenerateKeywordIdeasRequest { // The ID of the customer with the recommendation. string customer_id = 1; - // The resource name of the language to target. + // Required. The resource name of the language to target. // Required - google.protobuf.StringValue language = 7; + google.protobuf.StringValue language = 7 [(google.api.field_behavior) = REQUIRED]; // The resource names of the location to target. // Max 10 repeated google.protobuf.StringValue geo_target_constants = 8; // Targeting network. - google.ads.googleads.v1.enums.KeywordPlanNetworkEnum.KeywordPlanNetwork - keyword_plan_network = 9; + google.ads.googleads.v1.enums.KeywordPlanNetworkEnum.KeywordPlanNetwork keyword_plan_network = 9; // The type of seed to generate keyword ideas. oneof seed { @@ -112,6 +113,5 @@ message GenerateKeywordIdeaResult { google.protobuf.StringValue text = 2; // The historical metrics for the keyword - google.ads.googleads.v1.common.KeywordPlanHistoricalMetrics - keyword_idea_metrics = 3; + google.ads.googleads.v1.common.KeywordPlanHistoricalMetrics keyword_idea_metrics = 3; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/keyword_plan_keyword_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/keyword_plan_keyword_service.proto index 63b0ced19..0c0dcdca5 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/keyword_plan_keyword_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/keyword_plan_keyword_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/keyword_plan_keyword.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -36,40 +37,45 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage Keyword Plan ad group keywords. service KeywordPlanKeywordService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested Keyword Plan keyword in full detail. - rpc GetKeywordPlanKeyword(GetKeywordPlanKeywordRequest) - returns (google.ads.googleads.v1.resources.KeywordPlanKeyword) { + rpc GetKeywordPlanKeyword(GetKeywordPlanKeywordRequest) returns (google.ads.googleads.v1.resources.KeywordPlanKeyword) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/keywordPlanKeywords/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes Keyword Plan keywords. Operation statuses are // returned. - rpc MutateKeywordPlanKeywords(MutateKeywordPlanKeywordsRequest) - returns (MutateKeywordPlanKeywordsResponse) { + rpc MutateKeywordPlanKeywords(MutateKeywordPlanKeywordsRequest) returns (MutateKeywordPlanKeywordsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/keywordPlanKeywords:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [KeywordPlanKeywordService.GetKeywordPlanKeyword][google.ads.googleads.v1.services.KeywordPlanKeywordService.GetKeywordPlanKeyword]. +// Request message for [KeywordPlanKeywordService.GetKeywordPlanKeyword][google.ads.googleads.v1.services.KeywordPlanKeywordService.GetKeywordPlanKeyword]. message GetKeywordPlanKeywordRequest { - // The resource name of the ad group keyword to fetch. - string resource_name = 1; + // Required. The resource name of the ad group keyword to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanKeyword" + } + ]; } -// Request message for -// [KeywordPlanKeywordService.MutateKeywordPlanKeywords][google.ads.googleads.v1.services.KeywordPlanKeywordService.MutateKeywordPlanKeywords]. +// Request message for [KeywordPlanKeywordService.MutateKeywordPlanKeywords][google.ads.googleads.v1.services.KeywordPlanKeywordService.MutateKeywordPlanKeywords]. message MutateKeywordPlanKeywordsRequest { - // The ID of the customer whose Keyword Plan keywords are being modified. - string customer_id = 1; + // Required. The ID of the customer whose Keyword Plan keywords are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual Keyword Plan keywords. - repeated KeywordPlanKeywordOperation operations = 2; + // Required. The list of operations to perform on individual Keyword Plan keywords. + repeated KeywordPlanKeywordOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/keyword_plan_negative_keyword_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/keyword_plan_negative_keyword_service.proto index baa1fe248..6ffc716e2 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/keyword_plan_negative_keyword_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/keyword_plan_negative_keyword_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/keyword_plan_negative_keyword.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -36,42 +37,48 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage Keyword Plan negative keywords. service KeywordPlanNegativeKeywordService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested plan in full detail. - rpc GetKeywordPlanNegativeKeyword(GetKeywordPlanNegativeKeywordRequest) - returns (google.ads.googleads.v1.resources.KeywordPlanNegativeKeyword) { + rpc GetKeywordPlanNegativeKeyword(GetKeywordPlanNegativeKeywordRequest) returns (google.ads.googleads.v1.resources.KeywordPlanNegativeKeyword) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/keywordPlanNegativeKeywords/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes Keyword Plan negative keywords. Operation // statuses are returned. - rpc MutateKeywordPlanNegativeKeywords( - MutateKeywordPlanNegativeKeywordsRequest) - returns (MutateKeywordPlanNegativeKeywordsResponse) { + rpc MutateKeywordPlanNegativeKeywords(MutateKeywordPlanNegativeKeywordsRequest) returns (MutateKeywordPlanNegativeKeywordsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/keywordPlanNegativeKeywords:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for // [KeywordPlanNegativeKeywordService.GetKeywordPlanNegativeKeyword][google.ads.googleads.v1.services.KeywordPlanNegativeKeywordService.GetKeywordPlanNegativeKeyword]. message GetKeywordPlanNegativeKeywordRequest { - // The resource name of the plan to fetch. - string resource_name = 1; + // Required. The resource name of the plan to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanNegativeKeyword" + } + ]; } // Request message for // [KeywordPlanNegativeKeywordService.MutateKeywordPlanNegativeKeywords][google.ads.googleads.v1.services.KeywordPlanNegativeKeywordService.MutateKeywordPlanNegativeKeywords]. message MutateKeywordPlanNegativeKeywordsRequest { - // The ID of the customer whose negative keywords are being modified. - string customer_id = 1; + // Required. The ID of the customer whose negative keywords are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual Keyword Plan negative + // Required. The list of operations to perform on individual Keyword Plan negative // keywords. - repeated KeywordPlanNegativeKeywordOperation operations = 2; + repeated KeywordPlanNegativeKeywordOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried @@ -104,7 +111,6 @@ message KeywordPlanNegativeKeywordOperation { // Remove operation: A resource name for the removed Keyword Plan negative // keywords expected in this format: // - // // `customers/{customer_id}/keywordPlanNegativeKeywords/{kp_negative_keyword_id}` string remove = 3; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/keyword_plan_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/keyword_plan_service.proto index eb5b31619..9f27a3be5 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/keyword_plan_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/keyword_plan_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/common/keyword_plan_common.proto"; import "google/ads/googleads/v1/resources/keyword_plan.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; @@ -37,58 +39,63 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage keyword plans. service KeywordPlanService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested plan in full detail. - rpc GetKeywordPlan(GetKeywordPlanRequest) - returns (google.ads.googleads.v1.resources.KeywordPlan) { + rpc GetKeywordPlan(GetKeywordPlanRequest) returns (google.ads.googleads.v1.resources.KeywordPlan) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/keywordPlans/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes keyword plans. Operation statuses are // returned. - rpc MutateKeywordPlans(MutateKeywordPlansRequest) - returns (MutateKeywordPlansResponse) { + rpc MutateKeywordPlans(MutateKeywordPlansRequest) returns (MutateKeywordPlansResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/keywordPlans:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } // Returns the requested Keyword Plan forecasts. - rpc GenerateForecastMetrics(GenerateForecastMetricsRequest) - returns (GenerateForecastMetricsResponse) { + rpc GenerateForecastMetrics(GenerateForecastMetricsRequest) returns (GenerateForecastMetricsResponse) { option (google.api.http) = { post: "/v1/{keyword_plan=customers/*/keywordPlans/*}:generateForecastMetrics" body: "*" }; + option (google.api.method_signature) = "keyword_plan"; } // Returns the requested Keyword Plan historical metrics. - rpc GenerateHistoricalMetrics(GenerateHistoricalMetricsRequest) - returns (GenerateHistoricalMetricsResponse) { + rpc GenerateHistoricalMetrics(GenerateHistoricalMetricsRequest) returns (GenerateHistoricalMetricsResponse) { option (google.api.http) = { post: "/v1/{keyword_plan=customers/*/keywordPlans/*}:generateHistoricalMetrics" body: "*" }; + option (google.api.method_signature) = "keyword_plan"; } } -// Request message for -// [KeywordPlanService.GetKeywordPlan][google.ads.googleads.v1.services.KeywordPlanService.GetKeywordPlan]. +// Request message for [KeywordPlanService.GetKeywordPlan][google.ads.googleads.v1.services.KeywordPlanService.GetKeywordPlan]. message GetKeywordPlanRequest { - // The resource name of the plan to fetch. - string resource_name = 1; + // Required. The resource name of the plan to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlan" + } + ]; } -// Request message for -// [KeywordPlanService.MutateKeywordPlans][google.ads.googleads.v1.services.KeywordPlanService.MutateKeywordPlans]. +// Request message for [KeywordPlanService.MutateKeywordPlans][google.ads.googleads.v1.services.KeywordPlanService.MutateKeywordPlans]. message MutateKeywordPlansRequest { - // The ID of the customer whose keyword plans are being modified. - string customer_id = 1; + // Required. The ID of the customer whose keyword plans are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual keyword plans. - repeated KeywordPlanOperation operations = 2; + // Required. The list of operations to perform on individual keyword plans. + repeated KeywordPlanOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried @@ -142,15 +149,13 @@ message MutateKeywordPlansResult { string resource_name = 1; } -// Request message for -// [KeywordPlanService.GenerateForecastMetrics][google.ads.googleads.v1.services.KeywordPlanService.GenerateForecastMetrics]. +// Request message for [KeywordPlanService.GenerateForecastMetrics][google.ads.googleads.v1.services.KeywordPlanService.GenerateForecastMetrics]. message GenerateForecastMetricsRequest { - // The resource name of the keyword plan to be forecasted. - string keyword_plan = 1; + // Required. The resource name of the keyword plan to be forecasted. + string keyword_plan = 1 [(google.api.field_behavior) = REQUIRED]; } -// Response message for -// [KeywordPlanService.GenerateForecastMetrics][google.ads.googleads.v1.services.KeywordPlanService.GenerateForecastMetrics]. +// Response message for [KeywordPlanService.GenerateForecastMetrics][google.ads.googleads.v1.services.KeywordPlanService.GenerateForecastMetrics]. message GenerateForecastMetricsResponse { // List of campaign forecasts. // One maximum. @@ -189,7 +194,6 @@ message KeywordPlanAdGroupForecast { message KeywordPlanKeywordForecast { // The resource name of the Keyword Plan keyword related to the forecast. // - // // `customers/{customer_id}/keywordPlanAdGroupKeywords/{keyword_plan_ad_group_keyword_id}` google.protobuf.StringValue keyword_plan_ad_group_keyword = 1; @@ -215,16 +219,14 @@ message ForecastMetrics { google.protobuf.Int64Value cost_micros = 6; } -// Request message for -// [KeywordPlanService.GenerateHistoricalMetrics][google.ads.googleads.v1.services.KeywordPlanService.GenerateHistoricalMetrics]. +// Request message for [KeywordPlanService.GenerateHistoricalMetrics][google.ads.googleads.v1.services.KeywordPlanService.GenerateHistoricalMetrics]. message GenerateHistoricalMetricsRequest { - // The resource name of the keyword plan of which historical metrics are + // Required. The resource name of the keyword plan of which historical metrics are // requested. - string keyword_plan = 1; + string keyword_plan = 1 [(google.api.field_behavior) = REQUIRED]; } -// Response message for -// [KeywordPlanService.GenerateHistoricalMetrics][google.ads.googleads.v1.services.KeywordPlanService.GenerateHistoricalMetrics]. +// Response message for [KeywordPlanService.GenerateHistoricalMetrics][google.ads.googleads.v1.services.KeywordPlanService.GenerateHistoricalMetrics]. message GenerateHistoricalMetricsResponse { // List of keyword historical metrics. repeated KeywordPlanKeywordHistoricalMetrics metrics = 1; @@ -243,6 +245,5 @@ message KeywordPlanKeywordHistoricalMetrics { // The historical metrics for the query associated with one or more // ad_group_keywords in the plan. - google.ads.googleads.v1.common.KeywordPlanHistoricalMetrics keyword_metrics = - 2; + google.ads.googleads.v1.common.KeywordPlanHistoricalMetrics keyword_metrics = 2; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/keyword_view_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/keyword_view_service.proto index 820341126..313fefc1e 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/keyword_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/keyword_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/keyword_view.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage keyword views. service KeywordViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested keyword view in full detail. - rpc GetKeywordView(GetKeywordViewRequest) - returns (google.ads.googleads.v1.resources.KeywordView) { + rpc GetKeywordView(GetKeywordViewRequest) returns (google.ads.googleads.v1.resources.KeywordView) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/keywordViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [KeywordViewService.GetKeywordView][google.ads.googleads.v1.services.KeywordViewService.GetKeywordView]. +// Request message for [KeywordViewService.GetKeywordView][google.ads.googleads.v1.services.KeywordViewService.GetKeywordView]. message GetKeywordViewRequest { - // The resource name of the keyword view to fetch. - string resource_name = 1; + // Required. The resource name of the keyword view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/label_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/label_service.proto index f5f6f8782..d56c619f3 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/label_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/label_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/label.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -34,12 +35,14 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage labels. service LabelService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested label in full detail. - rpc GetLabel(GetLabelRequest) - returns (google.ads.googleads.v1.resources.Label) { + rpc GetLabel(GetLabelRequest) returns (google.ads.googleads.v1.resources.Label) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/labels/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes labels. Operation statuses are returned. @@ -48,24 +51,28 @@ service LabelService { post: "/v1/customers/{customer_id=*}/labels:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [LabelService.GetLabel][google.ads.googleads.v1.services.LabelService.GetLabel]. +// Request message for [LabelService.GetLabel][google.ads.googleads.v1.services.LabelService.GetLabel]. message GetLabelRequest { - // The resource name of the label to fetch. - string resource_name = 1; + // Required. The resource name of the label to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Label" + } + ]; } -// Request message for -// [LabelService.MutateLabels][google.ads.googleads.v1.services.LabelService.MutateLabels]. +// Request message for [LabelService.MutateLabels][google.ads.googleads.v1.services.LabelService.MutateLabels]. message MutateLabelsRequest { - // ID of the customer whose labels are being modified. - string customer_id = 1; + // Required. ID of the customer whose labels are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on labels. - repeated LabelOperation operations = 2; + // Required. The list of operations to perform on labels. + repeated LabelOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/landing_page_view_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/landing_page_view_service.proto index 0d703e826..e4fadcb00 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/landing_page_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/landing_page_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,7 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/landing_page_view.proto"; import "google/api/annotations.proto"; -import "google/protobuf/wrappers.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -34,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch landing page views. service LandingPageViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested landing page view in full detail. - rpc GetLandingPageView(GetLandingPageViewRequest) - returns (google.ads.googleads.v1.resources.LandingPageView) { + rpc GetLandingPageView(GetLandingPageViewRequest) returns (google.ads.googleads.v1.resources.LandingPageView) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/landingPageViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [LandingPageViewService.GetLandingPageView][google.ads.googleads.v1.services.LandingPageViewService.GetLandingPageView]. +// Request message for [LandingPageViewService.GetLandingPageView][google.ads.googleads.v1.services.LandingPageViewService.GetLandingPageView]. message GetLandingPageViewRequest { - // The resource name of the landing page view to fetch. - string resource_name = 1; + // Required. The resource name of the landing page view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/LandingPageView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/language_constant_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/language_constant_service.proto index cdd76ea75..c9b3f4fbd 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/language_constant_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/language_constant_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/language_constant.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch language constants. service LanguageConstantService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested language constant. - rpc GetLanguageConstant(GetLanguageConstantRequest) - returns (google.ads.googleads.v1.resources.LanguageConstant) { + rpc GetLanguageConstant(GetLanguageConstantRequest) returns (google.ads.googleads.v1.resources.LanguageConstant) { option (google.api.http) = { get: "/v1/{resource_name=languageConstants/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [LanguageConstantService.GetLanguageConstant][google.ads.googleads.v1.services.LanguageConstantService.GetLanguageConstant]. +// Request message for [LanguageConstantService.GetLanguageConstant][google.ads.googleads.v1.services.LanguageConstantService.GetLanguageConstant]. message GetLanguageConstantRequest { - // Resource name of the language constant to fetch. - string resource_name = 1; + // Required. Resource name of the language constant to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/LanguageConstant" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/location_view_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/location_view_service.proto index a7eae73bc..1ac910f46 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/location_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/location_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/location_view.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch location views. service LocationViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested location view in full detail. - rpc GetLocationView(GetLocationViewRequest) - returns (google.ads.googleads.v1.resources.LocationView) { + rpc GetLocationView(GetLocationViewRequest) returns (google.ads.googleads.v1.resources.LocationView) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/locationViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [LocationViewService.GetLocationView][google.ads.googleads.v1.services.LocationViewService.GetLocationView]. +// Request message for [LocationViewService.GetLocationView][google.ads.googleads.v1.services.LocationViewService.GetLocationView]. message GetLocationViewRequest { - // The resource name of the location view to fetch. - string resource_name = 1; + // Required. The resource name of the location view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/LocationView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/managed_placement_view_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/managed_placement_view_service.proto index 49aef4d50..00f743a37 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/managed_placement_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/managed_placement_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/managed_placement_view.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage Managed Placement views. service ManagedPlacementViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested Managed Placement view in full detail. - rpc GetManagedPlacementView(GetManagedPlacementViewRequest) - returns (google.ads.googleads.v1.resources.ManagedPlacementView) { + rpc GetManagedPlacementView(GetManagedPlacementViewRequest) returns (google.ads.googleads.v1.resources.ManagedPlacementView) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/managedPlacementViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [ManagedPlacementViewService.GetManagedPlacementView][google.ads.googleads.v1.services.ManagedPlacementViewService.GetManagedPlacementView]. +// Request message for [ManagedPlacementViewService.GetManagedPlacementView][google.ads.googleads.v1.services.ManagedPlacementViewService.GetManagedPlacementView]. message GetManagedPlacementViewRequest { - // The resource name of the Managed Placement View to fetch. - string resource_name = 1; + // Required. The resource name of the Managed Placement View to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ManagedPlacementView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/media_file_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/media_file_service.proto index a34073fa2..ee41ffb62 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/media_file_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/media_file_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,7 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/media_file.proto"; import "google/api/annotations.proto"; -import "google/protobuf/wrappers.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -35,39 +36,44 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage media files. service MediaFileService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested media file in full detail. - rpc GetMediaFile(GetMediaFileRequest) - returns (google.ads.googleads.v1.resources.MediaFile) { + rpc GetMediaFile(GetMediaFileRequest) returns (google.ads.googleads.v1.resources.MediaFile) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/mediaFiles/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates media files. Operation statuses are returned. - rpc MutateMediaFiles(MutateMediaFilesRequest) - returns (MutateMediaFilesResponse) { + rpc MutateMediaFiles(MutateMediaFilesRequest) returns (MutateMediaFilesResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/mediaFiles:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [MediaFileService.GetMediaFile][google.ads.googleads.v1.services.MediaFileService.GetMediaFile] +// Request message for [MediaFileService.GetMediaFile][google.ads.googleads.v1.services.MediaFileService.GetMediaFile] message GetMediaFileRequest { - // The resource name of the media file to fetch. - string resource_name = 1; + // Required. The resource name of the media file to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MediaFile" + } + ]; } -// Request message for -// [MediaFileService.MutateMediaFiles][google.ads.googleads.v1.services.MediaFileService.MutateMediaFiles] +// Request message for [MediaFileService.MutateMediaFiles][google.ads.googleads.v1.services.MediaFileService.MutateMediaFiles] message MutateMediaFilesRequest { - // The ID of the customer whose media files are being modified. - string customer_id = 1; + // Required. The ID of the customer whose media files are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual media file. - repeated MediaFileOperation operations = 2; + // Required. The list of operations to perform on individual media file. + repeated MediaFileOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/merchant_center_link_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/merchant_center_link_service.proto index 10ea4dbd9..9eaceb7a3 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/merchant_center_link_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/merchant_center_link_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/merchant_center_link.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -35,63 +37,65 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // This service allows management of links between Google Ads and Google // Merchant Center. service MerchantCenterLinkService { - // Returns Merchant Center links available tor this customer. - rpc ListMerchantCenterLinks(ListMerchantCenterLinksRequest) - returns (ListMerchantCenterLinksResponse) { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns Merchant Center links available for this customer. + rpc ListMerchantCenterLinks(ListMerchantCenterLinksRequest) returns (ListMerchantCenterLinksResponse) { option (google.api.http) = { get: "/v1/customers/{customer_id=*}/merchantCenterLinks" }; + option (google.api.method_signature) = "customer_id"; } // Returns the Merchant Center link in full detail. - rpc GetMerchantCenterLink(GetMerchantCenterLinkRequest) - returns (google.ads.googleads.v1.resources.MerchantCenterLink) { + rpc GetMerchantCenterLink(GetMerchantCenterLinkRequest) returns (google.ads.googleads.v1.resources.MerchantCenterLink) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/merchantCenterLinks/*}" }; + option (google.api.method_signature) = "resource_name"; } // Updates status or removes a Merchant Center link. - rpc MutateMerchantCenterLink(MutateMerchantCenterLinkRequest) - returns (MutateMerchantCenterLinkResponse) { + rpc MutateMerchantCenterLink(MutateMerchantCenterLinkRequest) returns (MutateMerchantCenterLinkResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/merchantCenterLinks:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operation"; } } -// Request message for -// [MerchantCenterLinkService.ListMerchantCenterLinks][google.ads.googleads.v1.services.MerchantCenterLinkService.ListMerchantCenterLinks]. +// Request message for [MerchantCenterLinkService.ListMerchantCenterLinks][google.ads.googleads.v1.services.MerchantCenterLinkService.ListMerchantCenterLinks]. message ListMerchantCenterLinksRequest { - // The ID of the customer onto which to apply the Merchant Center link list + // Required. The ID of the customer onto which to apply the Merchant Center link list // operation. - string customer_id = 1; + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; } -// Response message for -// [MerchantCenterLinkService.ListMerchantCenterLinks][google.ads.googleads.v1.services.MerchantCenterLinkService.ListMerchantCenterLinks]. +// Response message for [MerchantCenterLinkService.ListMerchantCenterLinks][google.ads.googleads.v1.services.MerchantCenterLinkService.ListMerchantCenterLinks]. message ListMerchantCenterLinksResponse { // Merchant Center links available for the requested customer - repeated google.ads.googleads.v1.resources.MerchantCenterLink - merchant_center_links = 1; + repeated google.ads.googleads.v1.resources.MerchantCenterLink merchant_center_links = 1; } -// Request message for -// [MerchantCenterLinkService.GetMerchantCenterLink][google.ads.googleads.v1.services.MerchantCenterLinkService.GetMerchantCenterLink]. +// Request message for [MerchantCenterLinkService.GetMerchantCenterLink][google.ads.googleads.v1.services.MerchantCenterLinkService.GetMerchantCenterLink]. message GetMerchantCenterLinkRequest { - // Resource name of the Merchant Center link. - string resource_name = 1; + // Required. Resource name of the Merchant Center link. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MerchantCenterLink" + } + ]; } -// Request message for -// [MerchantCenterLinkService.MutateMerchantCenterLink][google.ads.googleads.v1.services.MerchantCenterLinkService.MutateMerchantCenterLink]. +// Request message for [MerchantCenterLinkService.MutateMerchantCenterLink][google.ads.googleads.v1.services.MerchantCenterLinkService.MutateMerchantCenterLink]. message MutateMerchantCenterLinkRequest { - // The ID of the customer being modified. - string customer_id = 1; + // Required. The ID of the customer being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The operation to perform on the link - MerchantCenterLinkOperation operation = 2; + // Required. The operation to perform on the link + MerchantCenterLinkOperation operation = 2 [(google.api.field_behavior) = REQUIRED]; } // A single update on a Merchant Center link. diff --git a/third_party/googleapis/google/ads/googleads/v1/services/mobile_app_category_constant_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/mobile_app_category_constant_service.proto index 3cfae7aec..f5d1e1b71 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/mobile_app_category_constant_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/mobile_app_category_constant_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/mobile_app_category_constant.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -31,18 +33,25 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch mobile app category constants. service MobileAppCategoryConstantService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested mobile app category constant. - rpc GetMobileAppCategoryConstant(GetMobileAppCategoryConstantRequest) - returns (google.ads.googleads.v1.resources.MobileAppCategoryConstant) { + rpc GetMobileAppCategoryConstant(GetMobileAppCategoryConstantRequest) returns (google.ads.googleads.v1.resources.MobileAppCategoryConstant) { option (google.api.http) = { get: "/v1/{resource_name=mobileAppCategoryConstants/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for // [MobileAppCategoryConstantService.GetMobileAppCategoryConstant][google.ads.googleads.v1.services.MobileAppCategoryConstantService.GetMobileAppCategoryConstant]. message GetMobileAppCategoryConstantRequest { - // Resource name of the mobile app category constant to fetch. - string resource_name = 1; + // Required. Resource name of the mobile app category constant to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MobileAppCategoryConstant" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/mobile_device_constant_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/mobile_device_constant_service.proto index e269b404c..0e2aa8d49 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/mobile_device_constant_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/mobile_device_constant_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/mobile_device_constant.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch mobile device constants. service MobileDeviceConstantService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested mobile device constant in full detail. - rpc GetMobileDeviceConstant(GetMobileDeviceConstantRequest) - returns (google.ads.googleads.v1.resources.MobileDeviceConstant) { + rpc GetMobileDeviceConstant(GetMobileDeviceConstantRequest) returns (google.ads.googleads.v1.resources.MobileDeviceConstant) { option (google.api.http) = { get: "/v1/{resource_name=mobileDeviceConstants/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [MobileDeviceConstantService.GetMobileDeviceConstant][google.ads.googleads.v1.services.MobileDeviceConstantService.GetMobileDeviceConstant]. +// Request message for [MobileDeviceConstantService.GetMobileDeviceConstant][google.ads.googleads.v1.services.MobileDeviceConstantService.GetMobileDeviceConstant]. message GetMobileDeviceConstantRequest { - // Resource name of the mobile device to fetch. - string resource_name = 1; + // Required. Resource name of the mobile device to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MobileDeviceConstant" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/mutate_job_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/mutate_job_service.proto index 06dd654e7..28a49451d 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/mutate_job_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/mutate_job_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/mutate_job.proto"; import "google/ads/googleads/v1/services/google_ads_service.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/longrunning/operations.proto"; import "google/rpc/status.proto"; @@ -36,30 +38,32 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage mutate jobs. service MutateJobService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Creates a mutate job. - rpc CreateMutateJob(CreateMutateJobRequest) - returns (CreateMutateJobResponse) { + rpc CreateMutateJob(CreateMutateJobRequest) returns (CreateMutateJobResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/mutateJobs:create" body: "*" }; + option (google.api.method_signature) = "customer_id"; } // Returns the mutate job. - rpc GetMutateJob(GetMutateJobRequest) - returns (google.ads.googleads.v1.resources.MutateJob) { + rpc GetMutateJob(GetMutateJobRequest) returns (google.ads.googleads.v1.resources.MutateJob) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/mutateJobs/*}" }; + option (google.api.method_signature) = "resource_name"; } // Returns the results of the mutate job. The job must be done. // Supports standard list paging. - rpc ListMutateJobResults(ListMutateJobResultsRequest) - returns (ListMutateJobResultsResponse) { + rpc ListMutateJobResults(ListMutateJobResultsRequest) returns (ListMutateJobResultsResponse) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/mutateJobs/*}:listResults" }; + option (google.api.method_signature) = "resource_name"; } // Runs the mutate job. @@ -72,22 +76,28 @@ service MutateJobService { post: "/v1/{resource_name=customers/*/mutateJobs/*}:run" body: "*" }; + option (google.api.method_signature) = "resource_name"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "google.ads.googleads.v1.resources.MutateJob.MutateJobMetadata" + }; } // Add operations to the mutate job. - rpc AddMutateJobOperations(AddMutateJobOperationsRequest) - returns (AddMutateJobOperationsResponse) { + rpc AddMutateJobOperations(AddMutateJobOperationsRequest) returns (AddMutateJobOperationsResponse) { option (google.api.http) = { post: "/v1/{resource_name=customers/*/mutateJobs/*}:addOperations" body: "*" }; + option (google.api.method_signature) = "resource_name,sequence_token,mutate_operations"; + option (google.api.method_signature) = "resource_name,mutate_operations"; } } // Request message for [MutateJobService.CreateMutateJobRequest][] message CreateMutateJobRequest { - // The ID of the customer for which to create a mutate job. - string customer_id = 1; + // Required. The ID of the customer for which to create a mutate job. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; } // Response message for [MutateJobService.CreateMutateJobResponse][] @@ -96,25 +106,37 @@ message CreateMutateJobResponse { string resource_name = 1; } -// Request message for -// [MutateJobService.GetMutateJob][google.ads.googleads.v1.services.MutateJobService.GetMutateJob] +// Request message for [MutateJobService.GetMutateJob][google.ads.googleads.v1.services.MutateJobService.GetMutateJob] message GetMutateJobRequest { - // The resource name of the MutateJob to get. - string resource_name = 1; + // Required. The resource name of the MutateJob to get. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MutateJob" + } + ]; } -// Request message for -// [MutateJobService.RunMutateJob][google.ads.googleads.v1.services.MutateJobService.RunMutateJob] +// Request message for [MutateJobService.RunMutateJob][google.ads.googleads.v1.services.MutateJobService.RunMutateJob] message RunMutateJobRequest { - // The resource name of the MutateJob to run. - string resource_name = 1; + // Required. The resource name of the MutateJob to run. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MutateJob" + } + ]; } -// Request message for -// [MutateJobService.AddMutateJobOperations][google.ads.googleads.v1.services.MutateJobService.AddMutateJobOperations] +// Request message for [MutateJobService.AddMutateJobOperations][google.ads.googleads.v1.services.MutateJobService.AddMutateJobOperations] message AddMutateJobOperationsRequest { - // The resource name of the MutateJob. - string resource_name = 1; + // Required. The resource name of the MutateJob. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MutateJob" + } + ]; // A token used to enforce sequencing. // @@ -124,7 +146,7 @@ message AddMutateJobOperationsRequest { // response. string sequence_token = 2; - // The list of mutates being added. + // Required. The list of mutates being added. // // Operations can use negative integers as temp ids to signify dependencies // between entities created in this MutateJob. For example, a customer with @@ -133,11 +155,10 @@ message AddMutateJobOperationsRequest { // explicitly set to "customers/1234/campaigns/-1", and creating an ad group // in the second operation with the campaign field also set to // "customers/1234/campaigns/-1". - repeated MutateOperation mutate_operations = 3; + repeated MutateOperation mutate_operations = 3 [(google.api.field_behavior) = REQUIRED]; } -// Response message for -// [MutateJobService.AddMutateJobOperations][google.ads.googleads.v1.services.MutateJobService.AddMutateJobOperations] +// Response message for [MutateJobService.AddMutateJobOperations][google.ads.googleads.v1.services.MutateJobService.AddMutateJobOperations] message AddMutateJobOperationsResponse { // The total number of operations added so far for this job. int64 total_operations = 1; @@ -148,11 +169,15 @@ message AddMutateJobOperationsResponse { string next_sequence_token = 2; } -// Request message for -// [MutateJobService.ListMutateJobResults][google.ads.googleads.v1.services.MutateJobService.ListMutateJobResults]. +// Request message for [MutateJobService.ListMutateJobResults][google.ads.googleads.v1.services.MutateJobService.ListMutateJobResults]. message ListMutateJobResultsRequest { - // The resource name of the MutateJob whose results are being listed. - string resource_name = 1; + // Required. The resource name of the MutateJob whose results are being listed. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MutateJob" + } + ]; // Token of the page to retrieve. If not specified, the first // page of results will be returned. Use the value obtained from @@ -166,8 +191,7 @@ message ListMutateJobResultsRequest { int32 page_size = 3; } -// Response message for -// [MutateJobService.ListMutateJobResults][google.ads.googleads.v1.services.MutateJobService.ListMutateJobResults]. +// Response message for [MutateJobService.ListMutateJobResults][google.ads.googleads.v1.services.MutateJobService.ListMutateJobResults]. message ListMutateJobResultsResponse { // The list of rows that matched the query. repeated MutateJobResult results = 1; diff --git a/third_party/googleapis/google/ads/googleads/v1/services/operating_system_version_constant_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/operating_system_version_constant_service.proto index 66c447fab..78b4f5297 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/operating_system_version_constant_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/operating_system_version_constant_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/operating_system_version_constant.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,20 +35,25 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch Operating System Version constants. service OperatingSystemVersionConstantService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested OS version constant in full detail. - rpc GetOperatingSystemVersionConstant( - GetOperatingSystemVersionConstantRequest) - returns ( - google.ads.googleads.v1.resources.OperatingSystemVersionConstant) { + rpc GetOperatingSystemVersionConstant(GetOperatingSystemVersionConstantRequest) returns (google.ads.googleads.v1.resources.OperatingSystemVersionConstant) { option (google.api.http) = { get: "/v1/{resource_name=operatingSystemVersionConstants/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for // [OperatingSystemVersionConstantService.GetOperatingSystemVersionConstant][google.ads.googleads.v1.services.OperatingSystemVersionConstantService.GetOperatingSystemVersionConstant]. message GetOperatingSystemVersionConstantRequest { - // Resource name of the OS version to fetch. - string resource_name = 1; + // Required. Resource name of the OS version to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/OperatingSystemVersionConstant" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/paid_organic_search_term_view_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/paid_organic_search_term_view_service.proto index 420cc8309..8f3175839 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/paid_organic_search_term_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/paid_organic_search_term_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/paid_organic_search_term_view.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,25 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch paid organic search term views. service PaidOrganicSearchTermViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested paid organic search term view in full detail. - rpc GetPaidOrganicSearchTermView(GetPaidOrganicSearchTermViewRequest) - returns (google.ads.googleads.v1.resources.PaidOrganicSearchTermView) { + rpc GetPaidOrganicSearchTermView(GetPaidOrganicSearchTermViewRequest) returns (google.ads.googleads.v1.resources.PaidOrganicSearchTermView) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/paidOrganicSearchTermViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for // [PaidOrganicSearchTermViewService.GetPaidOrganicSearchTermView][google.ads.googleads.v1.services.PaidOrganicSearchTermViewService.GetPaidOrganicSearchTermView]. message GetPaidOrganicSearchTermViewRequest { - // The resource name of the paid organic search term view to fetch. - string resource_name = 1; + // Required. The resource name of the paid organic search term view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/PaidOrganicSearchTermView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/parental_status_view_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/parental_status_view_service.proto index 0e4e97ea5..047ace092 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/parental_status_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/parental_status_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/parental_status_view.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage parental status views. service ParentalStatusViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested parental status view in full detail. - rpc GetParentalStatusView(GetParentalStatusViewRequest) - returns (google.ads.googleads.v1.resources.ParentalStatusView) { + rpc GetParentalStatusView(GetParentalStatusViewRequest) returns (google.ads.googleads.v1.resources.ParentalStatusView) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/parentalStatusViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [ParentalStatusViewService.GetParentalStatusView][google.ads.googleads.v1.services.ParentalStatusViewService.GetParentalStatusView]. +// Request message for [ParentalStatusViewService.GetParentalStatusView][google.ads.googleads.v1.services.ParentalStatusViewService.GetParentalStatusView]. message GetParentalStatusViewRequest { - // The resource name of the parental status view to fetch. - string resource_name = 1; + // Required. The resource name of the parental status view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ParentalStatusView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/payments_account_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/payments_account_service.proto index 6633099a8..e2d540779 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/payments_account_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/payments_account_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,8 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/payments_account.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -29,32 +30,32 @@ option objc_class_prefix = "GAA"; option php_namespace = "Google\\Ads\\GoogleAds\\V1\\Services"; option ruby_package = "Google::Ads::GoogleAds::V1::Services"; -// Proto file describing the Payments account service. +// Proto file describing the payments account service. -// Service to provide Payments accounts that can be used to set up consolidated +// Service to provide payments accounts that can be used to set up consolidated // billing. service PaymentsAccountService { - // Returns all Payments accounts associated with all managers + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns all payments accounts associated with all managers // between the login customer ID and specified serving customer in the // hierarchy, inclusive. - rpc ListPaymentsAccounts(ListPaymentsAccountsRequest) - returns (ListPaymentsAccountsResponse) { + rpc ListPaymentsAccounts(ListPaymentsAccountsRequest) returns (ListPaymentsAccountsResponse) { option (google.api.http) = { get: "/v1/customers/{customer_id=*}/paymentsAccounts" }; + option (google.api.method_signature) = "customer_id"; } } -// Request message for fetching all accessible Payments accounts. +// Request message for fetching all accessible payments accounts. message ListPaymentsAccountsRequest { - // The ID of the customer to apply the PaymentsAccount list operation to. - string customer_id = 1; + // Required. The ID of the customer to apply the PaymentsAccount list operation to. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; } -// Response message for -// [PaymentsAccountService.ListPaymentsAccounts][google.ads.googleads.v1.services.PaymentsAccountService.ListPaymentsAccounts]. +// Response message for [PaymentsAccountService.ListPaymentsAccounts][google.ads.googleads.v1.services.PaymentsAccountService.ListPaymentsAccounts]. message ListPaymentsAccountsResponse { - // The list of accessible Payments accounts. - repeated google.ads.googleads.v1.resources.PaymentsAccount payments_accounts = - 1; + // The list of accessible payments accounts. + repeated google.ads.googleads.v1.resources.PaymentsAccount payments_accounts = 1; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/product_bidding_category_constant_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/product_bidding_category_constant_service.proto index f51258df1..6adcc3ab6 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/product_bidding_category_constant_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/product_bidding_category_constant_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/product_bidding_category_constant.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,20 +35,25 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch Product Bidding Categories. service ProductBiddingCategoryConstantService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested Product Bidding Category in full detail. - rpc GetProductBiddingCategoryConstant( - GetProductBiddingCategoryConstantRequest) - returns ( - google.ads.googleads.v1.resources.ProductBiddingCategoryConstant) { + rpc GetProductBiddingCategoryConstant(GetProductBiddingCategoryConstantRequest) returns (google.ads.googleads.v1.resources.ProductBiddingCategoryConstant) { option (google.api.http) = { get: "/v1/{resource_name=productBiddingCategoryConstants/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for // [ProductBiddingCategoryService.GetProductBiddingCategory][]. message GetProductBiddingCategoryConstantRequest { - // Resource name of the Product Bidding Category to fetch. - string resource_name = 1; + // Required. Resource name of the Product Bidding Category to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ProductBiddingCategoryConstant" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/product_group_view_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/product_group_view_service.proto index 041afda91..c76997857 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/product_group_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/product_group_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/product_group_view.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage product group views. service ProductGroupViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested product group view in full detail. - rpc GetProductGroupView(GetProductGroupViewRequest) - returns (google.ads.googleads.v1.resources.ProductGroupView) { + rpc GetProductGroupView(GetProductGroupViewRequest) returns (google.ads.googleads.v1.resources.ProductGroupView) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/productGroupViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [ProductGroupViewService.GetProductGroupView][google.ads.googleads.v1.services.ProductGroupViewService.GetProductGroupView]. +// Request message for [ProductGroupViewService.GetProductGroupView][google.ads.googleads.v1.services.ProductGroupViewService.GetProductGroupView]. message GetProductGroupViewRequest { - // The resource name of the product group view to fetch. - string resource_name = 1; + // Required. The resource name of the product group view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ProductGroupView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/recommendation_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/recommendation_service.proto index b94934cab..676bc332e 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/recommendation_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/recommendation_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -22,6 +21,9 @@ import "google/ads/googleads/v1/enums/keyword_match_type.proto"; import "google/ads/googleads/v1/resources/ad.proto"; import "google/ads/googleads/v1/resources/recommendation.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; @@ -38,50 +40,55 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage recommendations. service RecommendationService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested recommendation in full detail. - rpc GetRecommendation(GetRecommendationRequest) - returns (google.ads.googleads.v1.resources.Recommendation) { + rpc GetRecommendation(GetRecommendationRequest) returns (google.ads.googleads.v1.resources.Recommendation) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/recommendations/*}" }; + option (google.api.method_signature) = "resource_name"; } // Applies given recommendations with corresponding apply parameters. - rpc ApplyRecommendation(ApplyRecommendationRequest) - returns (ApplyRecommendationResponse) { + rpc ApplyRecommendation(ApplyRecommendationRequest) returns (ApplyRecommendationResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/recommendations:apply" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } // Dismisses given recommendations. - rpc DismissRecommendation(DismissRecommendationRequest) - returns (DismissRecommendationResponse) { + rpc DismissRecommendation(DismissRecommendationRequest) returns (DismissRecommendationResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/recommendations:dismiss" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [RecommendationService.GetRecommendation][google.ads.googleads.v1.services.RecommendationService.GetRecommendation]. +// Request message for [RecommendationService.GetRecommendation][google.ads.googleads.v1.services.RecommendationService.GetRecommendation]. message GetRecommendationRequest { - // The resource name of the recommendation to fetch. - string resource_name = 1; + // Required. The resource name of the recommendation to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Recommendation" + } + ]; } -// Request message for -// [RecommendationService.ApplyRecommendation][google.ads.googleads.v1.services.RecommendationService.ApplyRecommendation]. +// Request message for [RecommendationService.ApplyRecommendation][google.ads.googleads.v1.services.RecommendationService.ApplyRecommendation]. message ApplyRecommendationRequest { - // The ID of the customer with the recommendation. - string customer_id = 1; + // Required. The ID of the customer with the recommendation. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to apply recommendations. + // Required. The list of operations to apply recommendations. // If partial_failure=false all recommendations should be of the same type // There is a limit of 100 operations per request. - repeated ApplyRecommendationOperation operations = 2; + repeated ApplyRecommendationOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, operations will be carried @@ -113,8 +120,7 @@ message ApplyRecommendationOperation { google.protobuf.StringValue ad_group = 1; // The match type of the keyword. This is a required field. - google.ads.googleads.v1.enums.KeywordMatchTypeEnum.KeywordMatchType - match_type = 2; + google.ads.googleads.v1.enums.KeywordMatchTypeEnum.KeywordMatchType match_type = 2; // Optional, CPC bid to set for the keyword. If not set, keyword will use // bid based on bidding strategy used by target ad group. @@ -134,8 +140,7 @@ message ApplyRecommendationOperation { // Parameters to use when applying callout extension recommendation. message CalloutExtensionParameters { // Callout extensions to be added. This is a required field. - repeated google.ads.googleads.v1.common.CalloutFeedItem callout_extensions = - 1; + repeated google.ads.googleads.v1.common.CalloutFeedItem callout_extensions = 1; } // Parameters to use when applying call extension recommendation. @@ -147,8 +152,7 @@ message ApplyRecommendationOperation { // Parameters to use when applying sitelink extension recommendation. message SitelinkExtensionParameters { // Sitelink extensions to be added. This is a required field. - repeated google.ads.googleads.v1.common.SitelinkFeedItem - sitelink_extensions = 1; + repeated google.ads.googleads.v1.common.SitelinkFeedItem sitelink_extensions = 1; } // Parameters to use when applying move unused budget recommendation. @@ -191,8 +195,7 @@ message ApplyRecommendationOperation { } } -// Response message for -// [RecommendationService.ApplyRecommendation][google.ads.googleads.v1.services.RecommendationService.ApplyRecommendation]. +// Response message for [RecommendationService.ApplyRecommendation][google.ads.googleads.v1.services.RecommendationService.ApplyRecommendation]. message ApplyRecommendationResponse { // Results of operations to apply recommendations. repeated ApplyRecommendationResult results = 1; @@ -210,8 +213,7 @@ message ApplyRecommendationResult { string resource_name = 1; } -// Request message for -// [RecommendationService.DismissRecommendation][google.ads.googleads.v1.services.RecommendationService.DismissRecommendation]. +// Request message for [RecommendationService.DismissRecommendation][google.ads.googleads.v1.services.RecommendationService.DismissRecommendation]. message DismissRecommendationRequest { // Operation to dismiss a single recommendation identified by resource_name. message DismissRecommendationOperation { @@ -219,13 +221,13 @@ message DismissRecommendationRequest { string resource_name = 1; } - // The ID of the customer with the recommendation. - string customer_id = 1; + // Required. The ID of the customer with the recommendation. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to dismiss recommendations. + // Required. The list of operations to dismiss recommendations. // If partial_failure=false all recommendations should be of the same type // There is a limit of 100 operations per request. - repeated DismissRecommendationOperation operations = 3; + repeated DismissRecommendationOperation operations = 3 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, operations will be carried in a @@ -234,8 +236,7 @@ message DismissRecommendationRequest { bool partial_failure = 2; } -// Response message for -// [RecommendationService.DismissRecommendation][google.ads.googleads.v1.services.RecommendationService.DismissRecommendation]. +// Response message for [RecommendationService.DismissRecommendation][google.ads.googleads.v1.services.RecommendationService.DismissRecommendation]. message DismissRecommendationResponse { // The result of dismissing a recommendation. message DismissRecommendationResult { diff --git a/third_party/googleapis/google/ads/googleads/v1/services/remarketing_action_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/remarketing_action_service.proto index fcd4119d1..e9c102a35 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/remarketing_action_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/remarketing_action_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/remarketing_action.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -36,39 +37,44 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage remarketing actions. service RemarketingActionService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested remarketing action in full detail. - rpc GetRemarketingAction(GetRemarketingActionRequest) - returns (google.ads.googleads.v1.resources.RemarketingAction) { + rpc GetRemarketingAction(GetRemarketingActionRequest) returns (google.ads.googleads.v1.resources.RemarketingAction) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/remarketingActions/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates or updates remarketing actions. Operation statuses are returned. - rpc MutateRemarketingActions(MutateRemarketingActionsRequest) - returns (MutateRemarketingActionsResponse) { + rpc MutateRemarketingActions(MutateRemarketingActionsRequest) returns (MutateRemarketingActionsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/remarketingActions:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [RemarketingActionService.GetRemarketingAction][google.ads.googleads.v1.services.RemarketingActionService.GetRemarketingAction]. +// Request message for [RemarketingActionService.GetRemarketingAction][google.ads.googleads.v1.services.RemarketingActionService.GetRemarketingAction]. message GetRemarketingActionRequest { - // The resource name of the remarketing action to fetch. - string resource_name = 1; + // Required. The resource name of the remarketing action to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/RemarketingAction" + } + ]; } -// Request message for -// [RemarketingActionService.MutateRemarketingActions][google.ads.googleads.v1.services.RemarketingActionService.MutateRemarketingActions]. +// Request message for [RemarketingActionService.MutateRemarketingActions][google.ads.googleads.v1.services.RemarketingActionService.MutateRemarketingActions]. message MutateRemarketingActionsRequest { - // The ID of the customer whose remarketing actions are being modified. - string customer_id = 1; + // Required. The ID of the customer whose remarketing actions are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual remarketing actions. - repeated RemarketingActionOperation operations = 2; + // Required. The list of operations to perform on individual remarketing actions. + repeated RemarketingActionOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/search_term_view_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/search_term_view_service.proto index 947faab8b..b32c4b0d2 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/search_term_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/search_term_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/search_term_view.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage search term views. service SearchTermViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the attributes of the requested search term view. - rpc GetSearchTermView(GetSearchTermViewRequest) - returns (google.ads.googleads.v1.resources.SearchTermView) { + rpc GetSearchTermView(GetSearchTermViewRequest) returns (google.ads.googleads.v1.resources.SearchTermView) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/searchTermViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [SearchTermViewService.GetSearchTermView][google.ads.googleads.v1.services.SearchTermViewService.GetSearchTermView]. +// Request message for [SearchTermViewService.GetSearchTermView][google.ads.googleads.v1.services.SearchTermViewService.GetSearchTermView]. message GetSearchTermViewRequest { - // The resource name of the search term view to fetch. - string resource_name = 1; + // Required. The resource name of the search term view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/SearchTermView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/shared_criterion_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/shared_criterion_service.proto index 2ef8b122f..39558b446 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/shared_criterion_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/shared_criterion_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,7 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/shared_criterion.proto"; import "google/api/annotations.proto"; -import "google/protobuf/wrappers.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -35,39 +36,44 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage shared criteria. service SharedCriterionService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested shared criterion in full detail. - rpc GetSharedCriterion(GetSharedCriterionRequest) - returns (google.ads.googleads.v1.resources.SharedCriterion) { + rpc GetSharedCriterion(GetSharedCriterionRequest) returns (google.ads.googleads.v1.resources.SharedCriterion) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/sharedCriteria/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates or removes shared criteria. Operation statuses are returned. - rpc MutateSharedCriteria(MutateSharedCriteriaRequest) - returns (MutateSharedCriteriaResponse) { + rpc MutateSharedCriteria(MutateSharedCriteriaRequest) returns (MutateSharedCriteriaResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/sharedCriteria:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [SharedCriterionService.GetSharedCriterion][google.ads.googleads.v1.services.SharedCriterionService.GetSharedCriterion]. +// Request message for [SharedCriterionService.GetSharedCriterion][google.ads.googleads.v1.services.SharedCriterionService.GetSharedCriterion]. message GetSharedCriterionRequest { - // The resource name of the shared criterion to fetch. - string resource_name = 1; + // Required. The resource name of the shared criterion to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/SharedCriterion" + } + ]; } -// Request message for -// [SharedCriterionService.MutateSharedCriteria][google.ads.googleads.v1.services.SharedCriterionService.MutateSharedCriteria]. +// Request message for [SharedCriterionService.MutateSharedCriteria][google.ads.googleads.v1.services.SharedCriterionService.MutateSharedCriteria]. message MutateSharedCriteriaRequest { - // The ID of the customer whose shared criteria are being modified. - string customer_id = 1; + // Required. The ID of the customer whose shared criteria are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual shared criteria. - repeated SharedCriterionOperation operations = 2; + // Required. The list of operations to perform on individual shared criteria. + repeated SharedCriterionOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/shared_set_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/shared_set_service.proto index 54d9bda7b..a5b869069 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/shared_set_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/shared_set_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/shared_set.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -36,39 +37,44 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage shared sets. service SharedSetService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested shared set in full detail. - rpc GetSharedSet(GetSharedSetRequest) - returns (google.ads.googleads.v1.resources.SharedSet) { + rpc GetSharedSet(GetSharedSetRequest) returns (google.ads.googleads.v1.resources.SharedSet) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/sharedSets/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes shared sets. Operation statuses are returned. - rpc MutateSharedSets(MutateSharedSetsRequest) - returns (MutateSharedSetsResponse) { + rpc MutateSharedSets(MutateSharedSetsRequest) returns (MutateSharedSetsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/sharedSets:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [SharedSetService.GetSharedSet][google.ads.googleads.v1.services.SharedSetService.GetSharedSet]. +// Request message for [SharedSetService.GetSharedSet][google.ads.googleads.v1.services.SharedSetService.GetSharedSet]. message GetSharedSetRequest { - // The resource name of the shared set to fetch. - string resource_name = 1; + // Required. The resource name of the shared set to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/SharedSet" + } + ]; } -// Request message for -// [SharedSetService.MutateSharedSets][google.ads.googleads.v1.services.SharedSetService.MutateSharedSets]. +// Request message for [SharedSetService.MutateSharedSets][google.ads.googleads.v1.services.SharedSetService.MutateSharedSets]. message MutateSharedSetsRequest { - // The ID of the customer whose shared sets are being modified. - string customer_id = 1; + // Required. The ID of the customer whose shared sets are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual shared sets. - repeated SharedSetOperation operations = 2; + // Required. The list of operations to perform on individual shared sets. + repeated SharedSetOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/shopping_performance_view_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/shopping_performance_view_service.proto index 22b4633f2..490386ec2 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/shopping_performance_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/shopping_performance_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/shopping_performance_view.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,25 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch Shopping performance views. service ShoppingPerformanceViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested Shopping performance view in full detail. - rpc GetShoppingPerformanceView(GetShoppingPerformanceViewRequest) - returns (google.ads.googleads.v1.resources.ShoppingPerformanceView) { + rpc GetShoppingPerformanceView(GetShoppingPerformanceViewRequest) returns (google.ads.googleads.v1.resources.ShoppingPerformanceView) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/shoppingPerformanceView}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for // [ShoppingPerformanceViewService.GetShoppingPerformanceView][google.ads.googleads.v1.services.ShoppingPerformanceViewService.GetShoppingPerformanceView]. message GetShoppingPerformanceViewRequest { - // The resource name of the Shopping performance view to fetch. - string resource_name = 1; + // Required. The resource name of the Shopping performance view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ShoppingPerformanceView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/topic_constant_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/topic_constant_service.proto index 3211fcfd9..f4710f38b 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/topic_constant_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/topic_constant_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/topic_constant.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch topic constants. service TopicConstantService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested topic constant in full detail. - rpc GetTopicConstant(GetTopicConstantRequest) - returns (google.ads.googleads.v1.resources.TopicConstant) { + rpc GetTopicConstant(GetTopicConstantRequest) returns (google.ads.googleads.v1.resources.TopicConstant) { option (google.api.http) = { get: "/v1/{resource_name=topicConstants/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [TopicConstantService.GetTopicConstant][google.ads.googleads.v1.services.TopicConstantService.GetTopicConstant]. +// Request message for [TopicConstantService.GetTopicConstant][google.ads.googleads.v1.services.TopicConstantService.GetTopicConstant]. message GetTopicConstantRequest { - // Resource name of the Topic to fetch. - string resource_name = 1; + // Required. Resource name of the Topic to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/TopicConstant" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/topic_view_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/topic_view_service.proto index dad38e45b..9bedae696 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/topic_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/topic_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/topic_view.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage topic views. service TopicViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested topic view in full detail. - rpc GetTopicView(GetTopicViewRequest) - returns (google.ads.googleads.v1.resources.TopicView) { + rpc GetTopicView(GetTopicViewRequest) returns (google.ads.googleads.v1.resources.TopicView) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/topicViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [TopicViewService.GetTopicView][google.ads.googleads.v1.services.TopicViewService.GetTopicView]. +// Request message for [TopicViewService.GetTopicView][google.ads.googleads.v1.services.TopicViewService.GetTopicView]. message GetTopicViewRequest { - // The resource name of the topic view to fetch. - string resource_name = 1; + // Required. The resource name of the topic view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/TopicView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/user_interest_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/user_interest_service.proto index 56dba8c7d..12360c74c 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/user_interest_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/user_interest_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/user_interest.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to fetch Google Ads User Interest. service UserInterestService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested user interest in full detail - rpc GetUserInterest(GetUserInterestRequest) - returns (google.ads.googleads.v1.resources.UserInterest) { + rpc GetUserInterest(GetUserInterestRequest) returns (google.ads.googleads.v1.resources.UserInterest) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/userInterests/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [UserInterestService.GetUserInterest][google.ads.googleads.v1.services.UserInterestService.GetUserInterest]. +// Request message for [UserInterestService.GetUserInterest][google.ads.googleads.v1.services.UserInterestService.GetUserInterest]. message GetUserInterestRequest { - // Resource name of the UserInterest to fetch. - string resource_name = 1; + // Required. Resource name of the UserInterest to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/UserInterest" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v1/services/user_list_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/user_list_service.proto index 2af44cdad..3f1524585 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/user_list_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/user_list_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/user_list.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; @@ -36,39 +37,44 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage user lists. service UserListService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested user list. - rpc GetUserList(GetUserListRequest) - returns (google.ads.googleads.v1.resources.UserList) { + rpc GetUserList(GetUserListRequest) returns (google.ads.googleads.v1.resources.UserList) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/userLists/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates or updates user lists. Operation statuses are returned. - rpc MutateUserLists(MutateUserListsRequest) - returns (MutateUserListsResponse) { + rpc MutateUserLists(MutateUserListsRequest) returns (MutateUserListsResponse) { option (google.api.http) = { post: "/v1/customers/{customer_id=*}/userLists:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } -// Request message for -// [UserListService.GetUserList][google.ads.googleads.v1.services.UserListService.GetUserList]. +// Request message for [UserListService.GetUserList][google.ads.googleads.v1.services.UserListService.GetUserList]. message GetUserListRequest { - // The resource name of the user list to fetch. - string resource_name = 1; + // Required. The resource name of the user list to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/UserList" + } + ]; } -// Request message for -// [UserListService.MutateUserLists][google.ads.googleads.v1.services.UserListService.MutateUserLists]. +// Request message for [UserListService.MutateUserLists][google.ads.googleads.v1.services.UserListService.MutateUserLists]. message MutateUserListsRequest { - // The ID of the customer whose user lists are being modified. - string customer_id = 1; + // Required. The ID of the customer whose user lists are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual user lists. - repeated UserListOperation operations = 2; + // Required. The list of operations to perform on individual user lists. + repeated UserListOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v1/services/video_service.proto b/third_party/googleapis/google/ads/googleads/v1/services/video_service.proto index 5c03a6a47..b278f5e6b 100644 --- a/third_party/googleapis/google/ads/googleads/v1/services/video_service.proto +++ b/third_party/googleapis/google/ads/googleads/v1/services/video_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,9 @@ package google.ads.googleads.v1.services; import "google/ads/googleads/v1/resources/video.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V1.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v1/services;services"; @@ -33,18 +35,24 @@ option ruby_package = "Google::Ads::GoogleAds::V1::Services"; // Service to manage videos. service VideoService { + option (google.api.default_host) = "googleads.googleapis.com"; + // Returns the requested video in full detail. - rpc GetVideo(GetVideoRequest) - returns (google.ads.googleads.v1.resources.Video) { + rpc GetVideo(GetVideoRequest) returns (google.ads.googleads.v1.resources.Video) { option (google.api.http) = { get: "/v1/{resource_name=customers/*/videos/*}" }; + option (google.api.method_signature) = "resource_name"; } } -// Request message for -// [VideoService.GetVideo][google.ads.googleads.v1.services.VideoService.GetVideo]. +// Request message for [VideoService.GetVideo][google.ads.googleads.v1.services.VideoService.GetVideo]. message GetVideoRequest { - // The resource name of the video to fetch. - string resource_name = 1; + // Required. The resource name of the video to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Video" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/common/ad_asset.proto b/third_party/googleapis/google/ads/googleads/v2/common/ad_asset.proto index 0ca6d0ace..529437adb 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/ad_asset.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/ad_asset.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/common/ad_type_infos.proto b/third_party/googleapis/google/ads/googleads/v2/common/ad_type_infos.proto index e9953a80e..2cbf7325d 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/ad_type_infos.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/ad_type_infos.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -123,6 +122,9 @@ message CallOnlyAdInfo { message ExpandedDynamicSearchAdInfo { // The description of the ad. google.protobuf.StringValue description = 1; + + // The second description of the ad. + google.protobuf.StringValue description2 = 2; } // A hotel ad. @@ -522,7 +524,7 @@ message ResponsiveDisplayAdInfo { // least 1 and max 5 headlines can be specified. repeated AdTextAsset descriptions = 7; - // Optional YouTube vidoes for the ad. A maximum of 5 videos can be specified. + // Optional YouTube videos for the ad. A maximum of 5 videos can be specified. repeated AdVideoAsset youtube_videos = 8; // The advertiser/brand name. Maximum display width is 25. diff --git a/third_party/googleapis/google/ads/googleads/v2/common/asset_types.proto b/third_party/googleapis/google/ads/googleads/v2/common/asset_types.proto index 09060d766..62aea928e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/asset_types.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/asset_types.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/common/bidding.proto b/third_party/googleapis/google/ads/googleads/v2/common/bidding.proto index 016e3f3c7..a3633c633 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/bidding.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/bidding.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/common/click_location.proto b/third_party/googleapis/google/ads/googleads/v2/common/click_location.proto index 79888b52c..b4e2f1b96 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/click_location.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/click_location.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/common/criteria.proto b/third_party/googleapis/google/ads/googleads/v2/common/criteria.proto index b7ac1cca3..2e6ac5b24 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/criteria.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/criteria.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -88,10 +87,10 @@ message MobileApplicationInfo { // corresponding platform. // For iOS, this native identifier is the 9 digit string that appears at the // end of an App Store URL (e.g., "476943146" for "Flood-It! 2" whose App - // Store link is http://itunes.apple.com/us/app/flood-it!-2/id476943146). + // Store link is "http://itunes.apple.com/us/app/flood-it!-2/id476943146"). // For Android, this native identifier is the application's package name // (e.g., "com.labpixies.colordrips" for "Color Drips" given Google Play link - // https://play.google.com/store/apps/details?id=com.labpixies.colordrips). + // "https://play.google.com/store/apps/details?id=com.labpixies.colordrips"). // A well formed app id for Google Ads API would thus be "1-476943146" for iOS // and "2-com.labpixies.colordrips" for Android. // This field is required and must be set in CREATE operations. @@ -237,7 +236,7 @@ message ProductBiddingCategoryInfo { // ID of the product bidding category. // // This ID is equivalent to the google_product_category ID as described in - // this article: https://support.google.com/merchants/answer/6324436. + // this article: https://support.google.com/merchants/answer/6324436 google.protobuf.Int64Value id = 1; // Two-letter upper-case country code of the product bidding category. It must diff --git a/third_party/googleapis/google/ads/googleads/v2/common/criterion_category_availability.proto b/third_party/googleapis/google/ads/googleads/v2/common/criterion_category_availability.proto index f067d48c6..6f39b0fb1 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/criterion_category_availability.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/criterion_category_availability.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/common/custom_parameter.proto b/third_party/googleapis/google/ads/googleads/v2/common/custom_parameter.proto index 9634fe593..ae2e9b4b2 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/custom_parameter.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/custom_parameter.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/common/dates.proto b/third_party/googleapis/google/ads/googleads/v2/common/dates.proto index 6ead41507..02e82df22 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/dates.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/dates.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/common/explorer_auto_optimizer_setting.proto b/third_party/googleapis/google/ads/googleads/v2/common/explorer_auto_optimizer_setting.proto index c106ea66f..7fe154cd8 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/explorer_auto_optimizer_setting.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/explorer_auto_optimizer_setting.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/common/extensions.proto b/third_party/googleapis/google/ads/googleads/v2/common/extensions.proto index 9576eda73..9c5e91569 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/extensions.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/extensions.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -345,3 +344,14 @@ message SitelinkFeedItem { // parallel tracking. google.protobuf.StringValue final_url_suffix = 8; } + +// Represents a hotel callout extension. +message HotelCalloutFeedItem { + // The callout text. + // The length of this string should be between 1 and 25, inclusive. + google.protobuf.StringValue text = 1; + + // The language of the hotel callout text. + // IETF BCP 47 compliant language code. + google.protobuf.StringValue language_code = 2; +} diff --git a/third_party/googleapis/google/ads/googleads/v2/common/feed_common.proto b/third_party/googleapis/google/ads/googleads/v2/common/feed_common.proto index 39590d92d..f759bf5d2 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/feed_common.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/feed_common.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/common/final_app_url.proto b/third_party/googleapis/google/ads/googleads/v2/common/final_app_url.proto index 236570085..573ce3972 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/final_app_url.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/final_app_url.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/common/frequency_cap.proto b/third_party/googleapis/google/ads/googleads/v2/common/frequency_cap.proto index 9d0f575ae..f170f51f6 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/frequency_cap.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/frequency_cap.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/common/keyword_plan_common.proto b/third_party/googleapis/google/ads/googleads/v2/common/keyword_plan_common.proto index 9543c582c..4134367cf 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/keyword_plan_common.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/keyword_plan_common.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/common/matching_function.proto b/third_party/googleapis/google/ads/googleads/v2/common/matching_function.proto index 1596c7f38..ef0b3dad6 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/matching_function.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/matching_function.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/common/metrics.proto b/third_party/googleapis/google/ads/googleads/v2/common/metrics.proto index 55a8a5cd1..8040b8e67 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/metrics.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/metrics.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -294,6 +293,10 @@ message Metrics { // Average lead value of hotel. google.protobuf.DoubleValue hotel_average_lead_value_micros = 75; + // The average price difference between the price offered by reporting hotel + // advertiser and the cheapest price offered by the competing advertiser. + google.protobuf.DoubleValue hotel_price_difference_percentage = 129; + // The creative historical quality score. google.ads.googleads.v2.enums.QualityScoreBucketEnum.QualityScoreBucket historical_creative_quality_score = 80; @@ -410,7 +413,7 @@ message Metrics { // The percentage of the customer's Shopping or Search ad impressions that are // shown in the most prominent Shopping position. See - // [this article](https://support.google.com/google-ads/answer/7501826) + // https://support.google.com/google-ads/answer/7501826 // for details. Any value below 0.1 is reported as 0.0999. google.protobuf.DoubleValue search_absolute_top_impression_share = 78; diff --git a/third_party/googleapis/google/ads/googleads/v2/common/policy.proto b/third_party/googleapis/google/ads/googleads/v2/common/policy.proto index d96446823..2e8ea35dc 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/policy.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/policy.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/common/real_time_bidding_setting.proto b/third_party/googleapis/google/ads/googleads/v2/common/real_time_bidding_setting.proto index 2869d1eb6..356ecfc71 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/real_time_bidding_setting.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/real_time_bidding_setting.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/common/segments.proto b/third_party/googleapis/google/ads/googleads/v2/common/segments.proto index 8f3761a88..54d141d5a 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/segments.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/segments.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -28,6 +27,7 @@ import "google/ads/googleads/v2/enums/day_of_week.proto"; import "google/ads/googleads/v2/enums/device.proto"; import "google/ads/googleads/v2/enums/external_conversion_source.proto"; import "google/ads/googleads/v2/enums/hotel_date_selection_type.proto"; +import "google/ads/googleads/v2/enums/hotel_price_bucket.proto"; import "google/ads/googleads/v2/enums/hotel_rate_type.proto"; import "google/ads/googleads/v2/enums/month_of_year.proto"; import "google/ads/googleads/v2/enums/placeholder_type.proto"; @@ -169,6 +169,9 @@ message Segments { // Hotel rate type. google.ads.googleads.v2.enums.HotelRateTypeEnum.HotelRateType hotel_rate_type = 74; + // Hotel price bucket. + google.ads.googleads.v2.enums.HotelPriceBucketEnum.HotelPriceBucket hotel_price_bucket = 78; + // Hotel state. google.protobuf.StringValue hotel_state = 15; diff --git a/third_party/googleapis/google/ads/googleads/v2/common/simulation.proto b/third_party/googleapis/google/ads/googleads/v2/common/simulation.proto index 69a140104..2b1827898 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/simulation.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/simulation.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/common/tag_snippet.proto b/third_party/googleapis/google/ads/googleads/v2/common/tag_snippet.proto index 7631d762d..3a7d47f0d 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/tag_snippet.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/tag_snippet.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/common/targeting_setting.proto b/third_party/googleapis/google/ads/googleads/v2/common/targeting_setting.proto index a6a55d821..fceab364e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/targeting_setting.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/targeting_setting.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/common/text_label.proto b/third_party/googleapis/google/ads/googleads/v2/common/text_label.proto index 6c091fd5d..53e17e6e4 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/text_label.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/text_label.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/common/url_collection.proto b/third_party/googleapis/google/ads/googleads/v2/common/url_collection.proto index c7bc7a314..fff0df712 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/url_collection.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/url_collection.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/common/user_lists.proto b/third_party/googleapis/google/ads/googleads/v2/common/user_lists.proto index 6e204016b..a99e78593 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/user_lists.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/user_lists.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -95,7 +94,7 @@ message UserListRuleItemGroupInfo { repeated UserListRuleItemInfo rule_items = 1; } -// An atomic rule fragment. +// An atomic rule item. message UserListRuleItemInfo { // Rule variable name. It should match the corresponding key name fired // by the pixel. @@ -107,20 +106,20 @@ message UserListRuleItemInfo { // This field must be populated when creating a new rule item. google.protobuf.StringValue name = 1; - // An atomic rule fragment. + // An atomic rule item. oneof rule_item { - // An atomic rule fragment composed of a number operation. + // An atomic rule item composed of a number operation. UserListNumberRuleItemInfo number_rule_item = 2; - // An atomic rule fragment composed of a string operation. + // An atomic rule item composed of a string operation. UserListStringRuleItemInfo string_rule_item = 3; - // An atomic rule fragment composed of a date operation. + // An atomic rule item composed of a date operation. UserListDateRuleItemInfo date_rule_item = 4; } } -// A rule item composed of date operation. +// A rule item composed of a date operation. message UserListDateRuleItemInfo { // Date comparison operator. // This field is required and must be populated when creating new date @@ -138,7 +137,7 @@ message UserListDateRuleItemInfo { google.protobuf.Int64Value offset_in_days = 3; } -// A rule item composed of number operation. +// A rule item composed of a number operation. message UserListNumberRuleItemInfo { // Number comparison operator. // This field is required and must be populated when creating a new number @@ -151,7 +150,7 @@ message UserListNumberRuleItemInfo { google.protobuf.DoubleValue value = 2; } -// A rule item fragment composed of date operation. +// A rule item composed of a string operation. message UserListStringRuleItemInfo { // String comparison operator. // This field is required and must be populated when creating a new string diff --git a/third_party/googleapis/google/ads/googleads/v2/common/value.proto b/third_party/googleapis/google/ads/googleads/v2/common/value.proto index d899fd675..0642c9228 100644 --- a/third_party/googleapis/google/ads/googleads/v2/common/value.proto +++ b/third_party/googleapis/google/ads/googleads/v2/common/value.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/access_reason.proto b/third_party/googleapis/google/ads/googleads/v2/enums/access_reason.proto index 01f7773b1..3c456389e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/access_reason.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/access_reason.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/access_role.proto b/third_party/googleapis/google/ads/googleads/v2/enums/access_role.proto index f0c0b19fe..5e00bf68d 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/access_role.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/access_role.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/account_budget_proposal_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/account_budget_proposal_status.proto index de2077435..44e5976ad 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/account_budget_proposal_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/account_budget_proposal_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/account_budget_proposal_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/account_budget_proposal_type.proto index 91df41fa2..a2288afd0 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/account_budget_proposal_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/account_budget_proposal_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/account_budget_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/account_budget_status.proto index d39190f48..8a17c5f94 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/account_budget_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/account_budget_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/ad_customizer_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v2/enums/ad_customizer_placeholder_field.proto index 10ed0355c..53ecb8c04 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/ad_customizer_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/ad_customizer_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/ad_group_ad_rotation_mode.proto b/third_party/googleapis/google/ads/googleads/v2/enums/ad_group_ad_rotation_mode.proto index e3ee2a9a3..f9d120b09 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/ad_group_ad_rotation_mode.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/ad_group_ad_rotation_mode.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/ad_group_ad_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/ad_group_ad_status.proto index 906e6bbbb..f6656553f 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/ad_group_ad_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/ad_group_ad_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/ad_group_criterion_approval_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/ad_group_criterion_approval_status.proto index 7add7c98e..00c6012a8 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/ad_group_criterion_approval_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/ad_group_criterion_approval_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/ad_group_criterion_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/ad_group_criterion_status.proto index cac580ae7..5bc43a373 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/ad_group_criterion_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/ad_group_criterion_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/ad_group_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/ad_group_status.proto index ca2191a20..318360888 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/ad_group_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/ad_group_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/ad_group_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/ad_group_type.proto index 1bc24973a..624a8fe6e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/ad_group_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/ad_group_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/ad_network_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/ad_network_type.proto index 4bdb41318..9ff247713 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/ad_network_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/ad_network_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/ad_serving_optimization_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/ad_serving_optimization_status.proto index a63903844..4b4983779 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/ad_serving_optimization_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/ad_serving_optimization_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/ad_strength.proto b/third_party/googleapis/google/ads/googleads/v2/enums/ad_strength.proto index 1bb8b2a5b..a66d1c813 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/ad_strength.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/ad_strength.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/ad_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/ad_type.proto index 4ab10599d..17415dd25 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/ad_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/ad_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/advertising_channel_sub_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/advertising_channel_sub_type.proto index 8f9f3cf4c..f29075893 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/advertising_channel_sub_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/advertising_channel_sub_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/advertising_channel_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/advertising_channel_type.proto index 027cdbcca..20b1de289 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/advertising_channel_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/advertising_channel_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/affiliate_location_feed_relationship_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/affiliate_location_feed_relationship_type.proto index 8289101fb..2d3bab1c6 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/affiliate_location_feed_relationship_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/affiliate_location_feed_relationship_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/affiliate_location_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v2/enums/affiliate_location_placeholder_field.proto index f2adb8dbe..f32fe221a 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/affiliate_location_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/affiliate_location_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/age_range_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/age_range_type.proto index 8d15a5c6b..75fb0d7af 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/age_range_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/age_range_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/app_campaign_app_store.proto b/third_party/googleapis/google/ads/googleads/v2/enums/app_campaign_app_store.proto index 49f4a88aa..cd10eda2e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/app_campaign_app_store.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/app_campaign_app_store.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/app_campaign_bidding_strategy_goal_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/app_campaign_bidding_strategy_goal_type.proto index d6dc7dcd7..4743ef355 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/app_campaign_bidding_strategy_goal_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/app_campaign_bidding_strategy_goal_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/app_payment_model_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/app_payment_model_type.proto index f85fedd64..38e9e4189 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/app_payment_model_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/app_payment_model_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/app_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v2/enums/app_placeholder_field.proto index 3fc34b803..d68a0c840 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/app_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/app_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/app_store.proto b/third_party/googleapis/google/ads/googleads/v2/enums/app_store.proto index a12b57b00..6549a407d 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/app_store.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/app_store.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/app_url_operating_system_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/app_url_operating_system_type.proto index f56691efa..a547c9082 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/app_url_operating_system_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/app_url_operating_system_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/asset_field_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/asset_field_type.proto index fa2664717..93d25a5fb 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/asset_field_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/asset_field_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/asset_performance_label.proto b/third_party/googleapis/google/ads/googleads/v2/enums/asset_performance_label.proto index 205a30b94..23295bc36 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/asset_performance_label.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/asset_performance_label.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/asset_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/asset_type.proto index 808516839..4a0e762ae 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/asset_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/asset_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/attribution_model.proto b/third_party/googleapis/google/ads/googleads/v2/enums/attribution_model.proto index 0f0b0ae46..ad30f7086 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/attribution_model.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/attribution_model.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/bid_modifier_source.proto b/third_party/googleapis/google/ads/googleads/v2/enums/bid_modifier_source.proto index 494df692a..b2c04f9d4 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/bid_modifier_source.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/bid_modifier_source.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/bidding_source.proto b/third_party/googleapis/google/ads/googleads/v2/enums/bidding_source.proto index 6f6cd5d60..6e35777d7 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/bidding_source.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/bidding_source.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/bidding_strategy_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/bidding_strategy_status.proto index ae543a854..fc8c5e8c5 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/bidding_strategy_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/bidding_strategy_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/bidding_strategy_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/bidding_strategy_type.proto index 42474f55c..62326f55d 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/bidding_strategy_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/bidding_strategy_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/billing_setup_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/billing_setup_status.proto index 23c2a7a25..06a25f010 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/billing_setup_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/billing_setup_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/brand_safety_suitability.proto b/third_party/googleapis/google/ads/googleads/v2/enums/brand_safety_suitability.proto index d59c93203..f822e44ab 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/brand_safety_suitability.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/brand_safety_suitability.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/budget_delivery_method.proto b/third_party/googleapis/google/ads/googleads/v2/enums/budget_delivery_method.proto index 1d8bc02bb..9d5e4d98e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/budget_delivery_method.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/budget_delivery_method.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/budget_period.proto b/third_party/googleapis/google/ads/googleads/v2/enums/budget_period.proto index aef6ce526..2be12f638 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/budget_period.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/budget_period.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/budget_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/budget_status.proto index e2e3b8a5c..22ec5458b 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/budget_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/budget_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/budget_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/budget_type.proto index 6e9fc133a..81ba40642 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/budget_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/budget_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/call_conversion_reporting_state.proto b/third_party/googleapis/google/ads/googleads/v2/enums/call_conversion_reporting_state.proto index d4175bb68..11eb222f4 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/call_conversion_reporting_state.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/call_conversion_reporting_state.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/call_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v2/enums/call_placeholder_field.proto index 7f7ed94dc..6709beeb5 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/call_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/call_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/callout_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v2/enums/callout_placeholder_field.proto index 2e6c3613e..ee1c505fe 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/callout_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/callout_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/campaign_criterion_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/campaign_criterion_status.proto index 2c42aa3db..651ecacf8 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/campaign_criterion_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/campaign_criterion_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/campaign_draft_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/campaign_draft_status.proto index 18877e356..4a6d16032 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/campaign_draft_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/campaign_draft_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/campaign_experiment_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/campaign_experiment_status.proto index 4a73946a6..20861643e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/campaign_experiment_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/campaign_experiment_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/campaign_experiment_traffic_split_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/campaign_experiment_traffic_split_type.proto index fcb1de0be..de392b142 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/campaign_experiment_traffic_split_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/campaign_experiment_traffic_split_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/campaign_experiment_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/campaign_experiment_type.proto index 01a6f7168..c645942c9 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/campaign_experiment_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/campaign_experiment_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/campaign_serving_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/campaign_serving_status.proto index ee998e3c2..73f540c79 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/campaign_serving_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/campaign_serving_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/campaign_shared_set_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/campaign_shared_set_status.proto index f35ec7200..0db57b7e1 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/campaign_shared_set_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/campaign_shared_set_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/campaign_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/campaign_status.proto index 21ffd9d2d..ef4ffcb2f 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/campaign_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/campaign_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/change_status_operation.proto b/third_party/googleapis/google/ads/googleads/v2/enums/change_status_operation.proto index 8361cc339..6fed1073d 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/change_status_operation.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/change_status_operation.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/change_status_resource_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/change_status_resource_type.proto index 983aa47e7..a2a19b588 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/change_status_resource_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/change_status_resource_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/click_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/click_type.proto index 6318147f1..2d16d5687 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/click_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/click_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/content_label_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/content_label_type.proto index 17b4fb3e5..672454455 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/content_label_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/content_label_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/conversion_action_category.proto b/third_party/googleapis/google/ads/googleads/v2/enums/conversion_action_category.proto index 6000b0618..244ab4478 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/conversion_action_category.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/conversion_action_category.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/conversion_action_counting_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/conversion_action_counting_type.proto index 354c33ba3..68ce9d811 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/conversion_action_counting_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/conversion_action_counting_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/conversion_action_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/conversion_action_status.proto index 623d89edc..d08ad0f61 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/conversion_action_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/conversion_action_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/conversion_action_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/conversion_action_type.proto index c610e1906..a00e67edd 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/conversion_action_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/conversion_action_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/conversion_adjustment_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/conversion_adjustment_type.proto index be3d9468c..bbe168519 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/conversion_adjustment_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/conversion_adjustment_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/conversion_attribution_event_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/conversion_attribution_event_type.proto index 6bdf939be..071ed6bdb 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/conversion_attribution_event_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/conversion_attribution_event_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/conversion_lag_bucket.proto b/third_party/googleapis/google/ads/googleads/v2/enums/conversion_lag_bucket.proto index 94a099bf3..35924a0a5 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/conversion_lag_bucket.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/conversion_lag_bucket.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/conversion_or_adjustment_lag_bucket.proto b/third_party/googleapis/google/ads/googleads/v2/enums/conversion_or_adjustment_lag_bucket.proto index b5caee44a..b27e555b4 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/conversion_or_adjustment_lag_bucket.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/conversion_or_adjustment_lag_bucket.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/criterion_category_channel_availability_mode.proto b/third_party/googleapis/google/ads/googleads/v2/enums/criterion_category_channel_availability_mode.proto index 1d7e15c19..4897380e3 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/criterion_category_channel_availability_mode.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/criterion_category_channel_availability_mode.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/criterion_category_locale_availability_mode.proto b/third_party/googleapis/google/ads/googleads/v2/enums/criterion_category_locale_availability_mode.proto index 16b68bbc4..3228c3e46 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/criterion_category_locale_availability_mode.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/criterion_category_locale_availability_mode.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/criterion_system_serving_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/criterion_system_serving_status.proto index 857ccbfc7..7b92a0450 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/criterion_system_serving_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/criterion_system_serving_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/criterion_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/criterion_type.proto index 7f9a76ccb..bb761dab4 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/criterion_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/criterion_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/custom_interest_member_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/custom_interest_member_type.proto index a0b9dabe3..4046d0b7d 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/custom_interest_member_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/custom_interest_member_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/custom_interest_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/custom_interest_status.proto index 9f9ab6f14..7f1db044e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/custom_interest_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/custom_interest_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/custom_interest_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/custom_interest_type.proto index 2751f2eac..62d2b32b7 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/custom_interest_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/custom_interest_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/custom_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v2/enums/custom_placeholder_field.proto index c614c2304..774269fcf 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/custom_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/custom_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/customer_match_upload_key_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/customer_match_upload_key_type.proto index 16fdfc046..03c554d70 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/customer_match_upload_key_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/customer_match_upload_key_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/customer_pay_per_conversion_eligibility_failure_reason.proto b/third_party/googleapis/google/ads/googleads/v2/enums/customer_pay_per_conversion_eligibility_failure_reason.proto index f016e30c0..33903b222 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/customer_pay_per_conversion_eligibility_failure_reason.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/customer_pay_per_conversion_eligibility_failure_reason.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/data_driven_model_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/data_driven_model_status.proto index fe72a5486..10cab1e4b 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/data_driven_model_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/data_driven_model_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/day_of_week.proto b/third_party/googleapis/google/ads/googleads/v2/enums/day_of_week.proto index 423b490eb..594cba531 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/day_of_week.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/day_of_week.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/device.proto b/third_party/googleapis/google/ads/googleads/v2/enums/device.proto index 67bd0073f..54072ae86 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/device.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/device.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/display_ad_format_setting.proto b/third_party/googleapis/google/ads/googleads/v2/enums/display_ad_format_setting.proto index c65af3993..85547718c 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/display_ad_format_setting.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/display_ad_format_setting.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/display_upload_product_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/display_upload_product_type.proto index 0dc6b7b63..3f4e09863 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/display_upload_product_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/display_upload_product_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/distance_bucket.proto b/third_party/googleapis/google/ads/googleads/v2/enums/distance_bucket.proto index 6aa1e810d..79dab2806 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/distance_bucket.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/distance_bucket.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/dsa_page_feed_criterion_field.proto b/third_party/googleapis/google/ads/googleads/v2/enums/dsa_page_feed_criterion_field.proto index 2192313d8..5fcb3ffd0 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/dsa_page_feed_criterion_field.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/dsa_page_feed_criterion_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/education_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v2/enums/education_placeholder_field.proto index 63e860ae7..cec0bbe23 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/education_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/education_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/extension_setting_device.proto b/third_party/googleapis/google/ads/googleads/v2/enums/extension_setting_device.proto index dec6416d4..c2fdcc6c2 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/extension_setting_device.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/extension_setting_device.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/extension_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/extension_type.proto index 446421749..db1c835bd 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/extension_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/extension_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -73,6 +72,9 @@ message ExtensionTypeEnum { // Affiliate location. AFFILIATE_LOCATION = 13; + + // Hotel callout + HOTEL_CALLOUT = 15; } diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/external_conversion_source.proto b/third_party/googleapis/google/ads/googleads/v2/enums/external_conversion_source.proto index ad2389354..6c2fb8c18 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/external_conversion_source.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/external_conversion_source.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/feed_attribute_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/feed_attribute_type.proto index 83205a14e..bb1dcba1c 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/feed_attribute_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/feed_attribute_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/feed_item_quality_approval_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/feed_item_quality_approval_status.proto index fdba5dbc9..261916332 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/feed_item_quality_approval_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/feed_item_quality_approval_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/feed_item_quality_disapproval_reason.proto b/third_party/googleapis/google/ads/googleads/v2/enums/feed_item_quality_disapproval_reason.proto index 11273709c..320c9f4aa 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/feed_item_quality_disapproval_reason.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/feed_item_quality_disapproval_reason.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/feed_item_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/feed_item_status.proto index 2a4336f72..3f5bd12f0 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/feed_item_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/feed_item_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/feed_item_target_device.proto b/third_party/googleapis/google/ads/googleads/v2/enums/feed_item_target_device.proto index 65208edaa..3b51631f1 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/feed_item_target_device.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/feed_item_target_device.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/feed_item_target_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/feed_item_target_type.proto index 33b3b5603..7c608f191 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/feed_item_target_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/feed_item_target_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/feed_item_validation_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/feed_item_validation_status.proto index 8fb22b4cd..54bbf03fe 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/feed_item_validation_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/feed_item_validation_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/feed_link_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/feed_link_status.proto index e4d82c6d2..c12e33cd4 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/feed_link_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/feed_link_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/feed_mapping_criterion_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/feed_mapping_criterion_type.proto index 2f7bb5d57..692aa39ed 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/feed_mapping_criterion_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/feed_mapping_criterion_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/feed_mapping_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/feed_mapping_status.proto index 65771e68f..7d80a3b76 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/feed_mapping_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/feed_mapping_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/feed_origin.proto b/third_party/googleapis/google/ads/googleads/v2/enums/feed_origin.proto index 093a5b55d..181907689 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/feed_origin.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/feed_origin.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/feed_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/feed_status.proto index 339a43c16..4a879bba1 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/feed_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/feed_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/flight_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v2/enums/flight_placeholder_field.proto index 98f5131bf..a1b860ec8 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/flight_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/flight_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/frequency_cap_event_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/frequency_cap_event_type.proto index 780367315..508ae156e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/frequency_cap_event_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/frequency_cap_event_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/frequency_cap_level.proto b/third_party/googleapis/google/ads/googleads/v2/enums/frequency_cap_level.proto index a3e55fcff..818d5d477 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/frequency_cap_level.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/frequency_cap_level.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/frequency_cap_time_unit.proto b/third_party/googleapis/google/ads/googleads/v2/enums/frequency_cap_time_unit.proto index b5da86cf3..7b3ac4525 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/frequency_cap_time_unit.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/frequency_cap_time_unit.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/gender_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/gender_type.proto index f81e4fa0a..160484acf 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/gender_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/gender_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/geo_target_constant_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/geo_target_constant_status.proto index a52f86f9a..3aa14de15 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/geo_target_constant_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/geo_target_constant_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/geo_targeting_restriction.proto b/third_party/googleapis/google/ads/googleads/v2/enums/geo_targeting_restriction.proto index 1d2e66fd0..deb6d4a2b 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/geo_targeting_restriction.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/geo_targeting_restriction.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/geo_targeting_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/geo_targeting_type.proto index 968c9e2c3..375fcbba3 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/geo_targeting_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/geo_targeting_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/google_ads_field_category.proto b/third_party/googleapis/google/ads/googleads/v2/enums/google_ads_field_category.proto index e4aab7ff3..4d42bdc93 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/google_ads_field_category.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/google_ads_field_category.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/google_ads_field_data_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/google_ads_field_data_type.proto index ff39c44e1..aaa4024e7 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/google_ads_field_data_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/google_ads_field_data_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/hotel_date_selection_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/hotel_date_selection_type.proto index 25a12f2b9..0332b71df 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/hotel_date_selection_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/hotel_date_selection_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/hotel_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v2/enums/hotel_placeholder_field.proto index 6117772c2..11a453b22 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/hotel_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/hotel_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/hotel_price_bucket.proto b/third_party/googleapis/google/ads/googleads/v2/enums/hotel_price_bucket.proto new file mode 100644 index 000000000..ff8f70de5 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v2/enums/hotel_price_bucket.proto @@ -0,0 +1,52 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v2.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V2.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "HotelPriceBucketProto"; +option java_package = "com.google.ads.googleads.v2.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V2\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V2::Enums"; + +// Proto file describing hotel price buckets. + +// Container for enum describing hotel price bucket for a hotel itinerary. +message HotelPriceBucketEnum { + // Enum describing possible hotel price buckets. + enum HotelPriceBucket { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // Tied for lowest price. Partner is within a small variance of the lowest + // price. + LOWEST_TIED = 3; + + // Not lowest price. Partner is not within a small variance of the lowest + // price. + NOT_LOWEST = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/hotel_rate_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/hotel_rate_type.proto index 9a184225a..2c4e517e1 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/hotel_rate_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/hotel_rate_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/income_range_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/income_range_type.proto index 4e0aaef24..d44dacc76 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/income_range_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/income_range_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/interaction_event_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/interaction_event_type.proto index 6fb7ddd6d..8bd60efb1 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/interaction_event_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/interaction_event_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/interaction_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/interaction_type.proto index be3a9b649..a6fd4a8fb 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/interaction_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/interaction_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/invoice_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/invoice_type.proto new file mode 100644 index 000000000..aefc46171 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v2/enums/invoice_type.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v2.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V2.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "InvoiceTypeProto"; +option java_package = "com.google.ads.googleads.v2.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V2\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V2::Enums"; + +// Proto file describing invoice types. + +// Container for enum describing the type of invoices. +message InvoiceTypeEnum { + // The possible type of invoices. + enum InvoiceType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // An invoice with a negative amount. The account receives a credit. + CREDIT_MEMO = 2; + + // An invoice with a positive amount. The account owes a balance. + INVOICE = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/job_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v2/enums/job_placeholder_field.proto index 2326fbfcc..a4593e97b 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/job_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/job_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/keyword_match_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/keyword_match_type.proto index 2e6dcfea4..45f930e32 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/keyword_match_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/keyword_match_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/keyword_plan_competition_level.proto b/third_party/googleapis/google/ads/googleads/v2/enums/keyword_plan_competition_level.proto index 490f42169..f09a1f548 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/keyword_plan_competition_level.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/keyword_plan_competition_level.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/keyword_plan_forecast_interval.proto b/third_party/googleapis/google/ads/googleads/v2/enums/keyword_plan_forecast_interval.proto index df74e1193..a8d9fc179 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/keyword_plan_forecast_interval.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/keyword_plan_forecast_interval.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/keyword_plan_network.proto b/third_party/googleapis/google/ads/googleads/v2/enums/keyword_plan_network.proto index 210a1a5db..9064c6d75 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/keyword_plan_network.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/keyword_plan_network.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/label_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/label_status.proto index de559d875..f333303e1 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/label_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/label_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/legacy_app_install_ad_app_store.proto b/third_party/googleapis/google/ads/googleads/v2/enums/legacy_app_install_ad_app_store.proto index 95a3dd7a7..d8ed2c4f9 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/legacy_app_install_ad_app_store.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/legacy_app_install_ad_app_store.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/listing_custom_attribute_index.proto b/third_party/googleapis/google/ads/googleads/v2/enums/listing_custom_attribute_index.proto index 7bfa77989..053d15c8f 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/listing_custom_attribute_index.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/listing_custom_attribute_index.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/listing_group_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/listing_group_type.proto index de2d03457..4212b71f2 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/listing_group_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/listing_group_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/local_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v2/enums/local_placeholder_field.proto index df2b246dc..2fd0382e8 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/local_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/local_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/location_extension_targeting_criterion_field.proto b/third_party/googleapis/google/ads/googleads/v2/enums/location_extension_targeting_criterion_field.proto index f1fda3fe9..8c113f6d4 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/location_extension_targeting_criterion_field.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/location_extension_targeting_criterion_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/location_group_radius_units.proto b/third_party/googleapis/google/ads/googleads/v2/enums/location_group_radius_units.proto index 5b3f94c2a..d6cfa0c5f 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/location_group_radius_units.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/location_group_radius_units.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/location_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v2/enums/location_placeholder_field.proto index 438cb8941..b4a16ad16 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/location_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/location_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/manager_link_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/manager_link_status.proto index 5336a7a99..693373fe1 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/manager_link_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/manager_link_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/matching_function_context_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/matching_function_context_type.proto index 581d094b5..42b082fcc 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/matching_function_context_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/matching_function_context_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/matching_function_operator.proto b/third_party/googleapis/google/ads/googleads/v2/enums/matching_function_operator.proto index 2932d75a9..c6092ad40 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/matching_function_operator.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/matching_function_operator.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/media_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/media_type.proto index 781100457..15f7e5f7d 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/media_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/media_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/merchant_center_link_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/merchant_center_link_status.proto index 617f65858..a1ac95746 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/merchant_center_link_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/merchant_center_link_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/message_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v2/enums/message_placeholder_field.proto index 61246afa8..3af72e6ef 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/message_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/message_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/mime_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/mime_type.proto index a6b1e6653..7fd3d343a 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/mime_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/mime_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/minute_of_hour.proto b/third_party/googleapis/google/ads/googleads/v2/enums/minute_of_hour.proto index 34cb46454..b18c5a8e8 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/minute_of_hour.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/minute_of_hour.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/mobile_device_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/mobile_device_type.proto index e6e0d2a08..0e812ae42 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/mobile_device_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/mobile_device_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/month_of_year.proto b/third_party/googleapis/google/ads/googleads/v2/enums/month_of_year.proto index 5cc318649..67d3cf7d1 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/month_of_year.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/month_of_year.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/mutate_job_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/mutate_job_status.proto index 8c88eab95..5bec9c32d 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/mutate_job_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/mutate_job_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/negative_geo_target_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/negative_geo_target_type.proto index c1165ac8f..531b87a1b 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/negative_geo_target_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/negative_geo_target_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/operating_system_version_operator_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/operating_system_version_operator_type.proto index 1a46ed04c..f33a81ede 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/operating_system_version_operator_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/operating_system_version_operator_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/page_one_promoted_strategy_goal.proto b/third_party/googleapis/google/ads/googleads/v2/enums/page_one_promoted_strategy_goal.proto index 7c9adbbf0..3017a9746 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/page_one_promoted_strategy_goal.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/page_one_promoted_strategy_goal.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/parental_status_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/parental_status_type.proto index 772c5c55b..435c48c73 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/parental_status_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/parental_status_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/payment_mode.proto b/third_party/googleapis/google/ads/googleads/v2/enums/payment_mode.proto index 815ede508..c00c95ea5 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/payment_mode.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/payment_mode.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/placeholder_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/placeholder_type.proto index 4d83356e5..81bd57556 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/placeholder_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/placeholder_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/placement_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/placement_type.proto index a2fadcbc5..cb4b57f44 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/placement_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/placement_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/policy_approval_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/policy_approval_status.proto index de6f2d7d5..ce5739be4 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/policy_approval_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/policy_approval_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/policy_review_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/policy_review_status.proto index 268e9c61c..8e023567d 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/policy_review_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/policy_review_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -51,6 +50,10 @@ message PolicyReviewStatusEnum { // The resource has been resubmitted for approval or its policy decision has // been appealed. UNDER_APPEAL = 4; + + // The resource is eligible and may be serving but could still undergo + // further review. + ELIGIBLE_MAY_SERVE = 5; } diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/policy_topic_entry_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/policy_topic_entry_type.proto index 9bbd1ac7e..9399ace3b 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/policy_topic_entry_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/policy_topic_entry_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/policy_topic_evidence_destination_mismatch_url_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/policy_topic_evidence_destination_mismatch_url_type.proto index 539b9eeaf..a7eb35c8b 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/policy_topic_evidence_destination_mismatch_url_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/policy_topic_evidence_destination_mismatch_url_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/policy_topic_evidence_destination_not_working_device.proto b/third_party/googleapis/google/ads/googleads/v2/enums/policy_topic_evidence_destination_not_working_device.proto index 222525e28..fc280ccc1 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/policy_topic_evidence_destination_not_working_device.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/policy_topic_evidence_destination_not_working_device.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/policy_topic_evidence_destination_not_working_dns_error_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/policy_topic_evidence_destination_not_working_dns_error_type.proto index fcf16dd11..ff859d220 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/policy_topic_evidence_destination_not_working_dns_error_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/policy_topic_evidence_destination_not_working_dns_error_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/positive_geo_target_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/positive_geo_target_type.proto index f094d3ca8..85bae4837 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/positive_geo_target_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/positive_geo_target_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/preferred_content_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/preferred_content_type.proto index fe276bfb9..825c00f5a 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/preferred_content_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/preferred_content_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/price_extension_price_qualifier.proto b/third_party/googleapis/google/ads/googleads/v2/enums/price_extension_price_qualifier.proto index a0fa76ddc..9675bc5c4 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/price_extension_price_qualifier.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/price_extension_price_qualifier.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/price_extension_price_unit.proto b/third_party/googleapis/google/ads/googleads/v2/enums/price_extension_price_unit.proto index 412f35118..fc93171a0 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/price_extension_price_unit.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/price_extension_price_unit.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/price_extension_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/price_extension_type.proto index 495de62a9..23e66aa36 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/price_extension_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/price_extension_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/price_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v2/enums/price_placeholder_field.proto index c4aba0bc4..e69c12d0a 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/price_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/price_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/product_bidding_category_level.proto b/third_party/googleapis/google/ads/googleads/v2/enums/product_bidding_category_level.proto index 8033b2c8a..02de9216e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/product_bidding_category_level.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/product_bidding_category_level.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/product_bidding_category_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/product_bidding_category_status.proto index 300d2e8d6..a0d91c443 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/product_bidding_category_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/product_bidding_category_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/product_channel.proto b/third_party/googleapis/google/ads/googleads/v2/enums/product_channel.proto index ddb6fe9e0..ef03baa22 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/product_channel.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/product_channel.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/product_channel_exclusivity.proto b/third_party/googleapis/google/ads/googleads/v2/enums/product_channel_exclusivity.proto index d1676a32b..87981228b 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/product_channel_exclusivity.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/product_channel_exclusivity.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/product_condition.proto b/third_party/googleapis/google/ads/googleads/v2/enums/product_condition.proto index 2a2f41f04..c80813210 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/product_condition.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/product_condition.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/product_type_level.proto b/third_party/googleapis/google/ads/googleads/v2/enums/product_type_level.proto index 81ab5b460..936ceae1e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/product_type_level.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/product_type_level.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/promotion_extension_discount_modifier.proto b/third_party/googleapis/google/ads/googleads/v2/enums/promotion_extension_discount_modifier.proto index 6e01ba9d3..038da7aca 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/promotion_extension_discount_modifier.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/promotion_extension_discount_modifier.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/promotion_extension_occasion.proto b/third_party/googleapis/google/ads/googleads/v2/enums/promotion_extension_occasion.proto index 2aea2f815..953b82a38 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/promotion_extension_occasion.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/promotion_extension_occasion.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/promotion_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v2/enums/promotion_placeholder_field.proto index d1e47e2c4..7e754d863 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/promotion_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/promotion_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/proximity_radius_units.proto b/third_party/googleapis/google/ads/googleads/v2/enums/proximity_radius_units.proto index 6b1c1e9ef..0c163124b 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/proximity_radius_units.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/proximity_radius_units.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/quality_score_bucket.proto b/third_party/googleapis/google/ads/googleads/v2/enums/quality_score_bucket.proto index b1a1d079d..58e14c5ff 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/quality_score_bucket.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/quality_score_bucket.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/reach_plan_ad_length.proto b/third_party/googleapis/google/ads/googleads/v2/enums/reach_plan_ad_length.proto new file mode 100644 index 000000000..594ee1687 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v2/enums/reach_plan_ad_length.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v2.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V2.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ReachPlanAdLengthProto"; +option java_package = "com.google.ads.googleads.v2.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V2\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V2::Enums"; + +// Proto file describing ad lengths of a plannable video ad. + +// Message describing length of a plannable video ad. +message ReachPlanAdLengthEnum { + // Possible ad length values. + enum ReachPlanAdLength { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // 6 seconds long ad. + SIX_SECONDS = 2; + + // 15 or 20 seconds long ad. + FIFTEEN_OR_TWENTY_SECONDS = 3; + + // More than 20 seconds long ad. + TWENTY_SECONDS_OR_MORE = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/reach_plan_age_range.proto b/third_party/googleapis/google/ads/googleads/v2/enums/reach_plan_age_range.proto new file mode 100644 index 000000000..e06ac0f51 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v2/enums/reach_plan_age_range.proto @@ -0,0 +1,122 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v2.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V2.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ReachPlanAgeRangeProto"; +option java_package = "com.google.ads.googleads.v2.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V2\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V2::Enums"; + +// Proto file describing a plannable age range. + +// Message describing plannable age ranges. +message ReachPlanAgeRangeEnum { + // Possible plannable age range values. + enum ReachPlanAgeRange { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // Between 18 and 24 years old. + AGE_RANGE_18_24 = 503001; + + // Between 18 and 34 years old. + AGE_RANGE_18_34 = 2; + + // Between 18 and 44 years old. + AGE_RANGE_18_44 = 3; + + // Between 18 and 49 years old. + AGE_RANGE_18_49 = 4; + + // Between 18 and 54 years old. + AGE_RANGE_18_54 = 5; + + // Between 18 and 64 years old. + AGE_RANGE_18_64 = 6; + + // Between 18 and 65+ years old. + AGE_RANGE_18_65_UP = 7; + + // Between 21 and 34 years old. + AGE_RANGE_21_34 = 8; + + // Between 25 and 34 years old. + AGE_RANGE_25_34 = 503002; + + // Between 25 and 44 years old. + AGE_RANGE_25_44 = 9; + + // Between 25 and 49 years old. + AGE_RANGE_25_49 = 10; + + // Between 25 and 54 years old. + AGE_RANGE_25_54 = 11; + + // Between 25 and 64 years old. + AGE_RANGE_25_64 = 12; + + // Between 25 and 65+ years old. + AGE_RANGE_25_65_UP = 13; + + // Between 35 and 44 years old. + AGE_RANGE_35_44 = 503003; + + // Between 35 and 49 years old. + AGE_RANGE_35_49 = 14; + + // Between 35 and 54 years old. + AGE_RANGE_35_54 = 15; + + // Between 35 and 64 years old. + AGE_RANGE_35_64 = 16; + + // Between 35 and 65+ years old. + AGE_RANGE_35_65_UP = 17; + + // Between 45 and 54 years old. + AGE_RANGE_45_54 = 503004; + + // Between 45 and 64 years old. + AGE_RANGE_45_64 = 18; + + // Between 45 and 65+ years old. + AGE_RANGE_45_65_UP = 19; + + // Between 50 and 65+ years old. + AGE_RANGE_50_65_UP = 20; + + // Between 55 and 64 years old. + AGE_RANGE_55_64 = 503005; + + // Between 55 and 65+ years old. + AGE_RANGE_55_65_UP = 21; + + // 65 years old and beyond. + AGE_RANGE_65_UP = 503006; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/real_estate_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v2/enums/real_estate_placeholder_field.proto index 666a4c202..a72209799 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/real_estate_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/real_estate_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/recommendation_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/recommendation_type.proto index 03b35e9e2..b13cca955 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/recommendation_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/recommendation_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/search_engine_results_page_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/search_engine_results_page_type.proto index f0d62f1e2..60d713e49 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/search_engine_results_page_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/search_engine_results_page_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/search_term_match_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/search_term_match_type.proto index 930501d87..4c4e9f0f5 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/search_term_match_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/search_term_match_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/search_term_targeting_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/search_term_targeting_status.proto index 0a9dd7740..522005deb 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/search_term_targeting_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/search_term_targeting_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/served_asset_field_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/served_asset_field_type.proto index 9aab79c7b..8b32f6005 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/served_asset_field_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/served_asset_field_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/shared_set_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/shared_set_status.proto index f51fe626d..d6d0f0219 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/shared_set_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/shared_set_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/shared_set_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/shared_set_type.proto index f24b30b4a..588d4291b 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/shared_set_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/shared_set_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/simulation_modification_method.proto b/third_party/googleapis/google/ads/googleads/v2/enums/simulation_modification_method.proto index 830ac8cae..f1eecdc73 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/simulation_modification_method.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/simulation_modification_method.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/simulation_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/simulation_type.proto index b7b51f771..98dec8b03 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/simulation_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/simulation_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/sitelink_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v2/enums/sitelink_placeholder_field.proto index c5886e3e3..11648fc01 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/sitelink_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/sitelink_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/slot.proto b/third_party/googleapis/google/ads/googleads/v2/enums/slot.proto index c7bba3fee..c56035061 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/slot.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/slot.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/spending_limit_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/spending_limit_type.proto index 1870c94b4..b24fa7709 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/spending_limit_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/spending_limit_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/structured_snippet_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v2/enums/structured_snippet_placeholder_field.proto index 6ccf3f933..b5f08bc1f 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/structured_snippet_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/structured_snippet_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/system_managed_entity_source.proto b/third_party/googleapis/google/ads/googleads/v2/enums/system_managed_entity_source.proto index 9317f1c71..0eb9f54b1 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/system_managed_entity_source.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/system_managed_entity_source.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/target_cpa_opt_in_recommendation_goal.proto b/third_party/googleapis/google/ads/googleads/v2/enums/target_cpa_opt_in_recommendation_goal.proto index c22dafebf..52fb4ad57 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/target_cpa_opt_in_recommendation_goal.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/target_cpa_opt_in_recommendation_goal.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/target_impression_share_location.proto b/third_party/googleapis/google/ads/googleads/v2/enums/target_impression_share_location.proto index d1a94132c..af59ba35e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/target_impression_share_location.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/target_impression_share_location.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/targeting_dimension.proto b/third_party/googleapis/google/ads/googleads/v2/enums/targeting_dimension.proto index 0fed13821..a23ae7818 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/targeting_dimension.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/targeting_dimension.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/time_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/time_type.proto index a4dee47a7..dbea32554 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/time_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/time_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/tracking_code_page_format.proto b/third_party/googleapis/google/ads/googleads/v2/enums/tracking_code_page_format.proto index 827d2d3b5..0ca161692 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/tracking_code_page_format.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/tracking_code_page_format.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/tracking_code_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/tracking_code_type.proto index ab244490e..f7f13f515 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/tracking_code_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/tracking_code_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/travel_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v2/enums/travel_placeholder_field.proto index 199f7e053..a2a83f970 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/travel_placeholder_field.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/travel_placeholder_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/user_interest_taxonomy_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/user_interest_taxonomy_type.proto index 5e39b760e..8213b0034 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/user_interest_taxonomy_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/user_interest_taxonomy_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_access_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_access_status.proto index e85e2be6c..6a8741bcb 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_access_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_access_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_closing_reason.proto b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_closing_reason.proto index f8286e4ed..4623fb5ea 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_closing_reason.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_closing_reason.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_combined_rule_operator.proto b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_combined_rule_operator.proto index 8a19ee684..d1e09f62b 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_combined_rule_operator.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_combined_rule_operator.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_crm_data_source_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_crm_data_source_type.proto index b70f190c5..2f9230755 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_crm_data_source_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_crm_data_source_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_date_rule_item_operator.proto b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_date_rule_item_operator.proto index 526c6d8a7..0a14a98d4 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_date_rule_item_operator.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_date_rule_item_operator.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_logical_rule_operator.proto b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_logical_rule_operator.proto index 485af7f5e..f97b429e9 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_logical_rule_operator.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_logical_rule_operator.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_membership_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_membership_status.proto index af55c67e1..74feef61a 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_membership_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_membership_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_number_rule_item_operator.proto b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_number_rule_item_operator.proto index 489b5b154..b066bc380 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_number_rule_item_operator.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_number_rule_item_operator.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_prepopulation_status.proto b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_prepopulation_status.proto index 2c97a7195..be562939c 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_prepopulation_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_prepopulation_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_rule_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_rule_type.proto index 0598d55d6..01e02dc96 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_rule_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_rule_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_size_range.proto b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_size_range.proto index b4d062cab..2f8cdb163 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_size_range.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_size_range.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_string_rule_item_operator.proto b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_string_rule_item_operator.proto index fdb660c3a..697b9093d 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_string_rule_item_operator.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_string_rule_item_operator.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_type.proto b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_type.proto index ce9207f23..1fb82b3be 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/user_list_type.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/user_list_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/vanity_pharma_display_url_mode.proto b/third_party/googleapis/google/ads/googleads/v2/enums/vanity_pharma_display_url_mode.proto index 9bae73bac..07de2ed9e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/vanity_pharma_display_url_mode.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/vanity_pharma_display_url_mode.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/vanity_pharma_text.proto b/third_party/googleapis/google/ads/googleads/v2/enums/vanity_pharma_text.proto index 5c89fe440..6d0180cc6 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/vanity_pharma_text.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/vanity_pharma_text.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/webpage_condition_operand.proto b/third_party/googleapis/google/ads/googleads/v2/enums/webpage_condition_operand.proto index 8f961a2ff..d51824c4f 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/webpage_condition_operand.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/webpage_condition_operand.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/enums/webpage_condition_operator.proto b/third_party/googleapis/google/ads/googleads/v2/enums/webpage_condition_operator.proto index 3f1e547f6..f92af671e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/enums/webpage_condition_operator.proto +++ b/third_party/googleapis/google/ads/googleads/v2/enums/webpage_condition_operator.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/access_invitation_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/access_invitation_error.proto index 94981d996..88520bad1 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/access_invitation_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/access_invitation_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/account_budget_proposal_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/account_budget_proposal_error.proto index e4faa70a9..8803f761d 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/account_budget_proposal_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/account_budget_proposal_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/ad_customizer_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/ad_customizer_error.proto index 0ac20307c..128417997 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/ad_customizer_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/ad_customizer_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/ad_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/ad_error.proto index 2c59fada8..6fdfcc161 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/ad_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/ad_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/ad_group_ad_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/ad_group_ad_error.proto index 55d90fb06..482f5129b 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/ad_group_ad_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/ad_group_ad_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/ad_group_bid_modifier_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/ad_group_bid_modifier_error.proto index 65834bb69..9d5d63fcd 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/ad_group_bid_modifier_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/ad_group_bid_modifier_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/ad_group_criterion_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/ad_group_criterion_error.proto index ea96df9dd..5394d3445 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/ad_group_criterion_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/ad_group_criterion_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/ad_group_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/ad_group_error.proto index 1b197c9c8..69695f664 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/ad_group_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/ad_group_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/ad_group_feed_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/ad_group_feed_error.proto index cfdc268bf..d2b9aa55e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/ad_group_feed_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/ad_group_feed_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/ad_parameter_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/ad_parameter_error.proto index 561765b35..fef5101a7 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/ad_parameter_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/ad_parameter_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/ad_sharing_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/ad_sharing_error.proto index 1296d56a1..fe4d37492 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/ad_sharing_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/ad_sharing_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/adx_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/adx_error.proto index 47646546e..3867d691c 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/adx_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/adx_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/asset_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/asset_error.proto index 9b69fea80..db43c58c4 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/asset_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/asset_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/authentication_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/authentication_error.proto index 1a639d9b5..ad2332542 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/authentication_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/authentication_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/authorization_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/authorization_error.proto index b01f6594e..e116eb686 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/authorization_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/authorization_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -76,6 +75,10 @@ message AuthorizationErrorEnum { // The developer token is not approved. Non-approved developer tokens can // only be used with test accounts. DEVELOPER_TOKEN_NOT_APPROVED = 10; + + // The login customer specified does not have access to the account + // specified, so the request is invalid. + INVALID_LOGIN_CUSTOMER_ID_SERVING_CUSTOMER_ID_COMBINATION = 11; } diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/bidding_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/bidding_error.proto index 5c84b226e..7b2ae6991 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/bidding_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/bidding_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/bidding_strategy_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/bidding_strategy_error.proto index f7ecea26d..40c38ef6d 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/bidding_strategy_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/bidding_strategy_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/billing_setup_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/billing_setup_error.proto index 7965b69b4..fda491061 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/billing_setup_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/billing_setup_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -40,62 +39,62 @@ message BillingSetupErrorEnum { // The received error code is not known in this version. UNKNOWN = 1; - // Cannot use both an existing Payments account and a new Payments account - // when setting up billing. + // Cannot specify both an existing payments account and a new payments + // account when setting up billing. CANNOT_USE_EXISTING_AND_NEW_ACCOUNT = 2; - // Cannot cancel an APPROVED billing setup whose start time has passed. + // Cannot cancel an approved billing setup whose start time has passed. CANNOT_REMOVE_STARTED_BILLING_SETUP = 3; - // Cannot perform a Change of Bill-To (CBT) to the same Payments account. + // Cannot perform a Change of Bill-To (CBT) to the same payments account. CANNOT_CHANGE_BILLING_TO_SAME_PAYMENTS_ACCOUNT = 4; - // Billing Setups can only be used by customers with ENABLED or DRAFT + // Billing setups can only be used by customers with ENABLED or DRAFT // status. BILLING_SETUP_NOT_PERMITTED_FOR_CUSTOMER_STATUS = 5; - // Billing Setups must either include a correctly formatted existing - // Payments account id, or a non-empty new Payments account name. + // Billing setups must either include a correctly formatted existing + // payments account id, or a non-empty new payments account name. INVALID_PAYMENTS_ACCOUNT = 6; // Only billable and third-party customers can create billing setups. BILLING_SETUP_NOT_PERMITTED_FOR_CUSTOMER_CATEGORY = 7; - // Billing Setup creations can only use NOW for start time type. + // Billing setup creations can only use NOW for start time type. INVALID_START_TIME_TYPE = 8; - // Billing Setups can only be created for a third-party customer if they do + // Billing setups can only be created for a third-party customer if they do // not already have a setup. THIRD_PARTY_ALREADY_HAS_BILLING = 9; - // Billing Setups cannot be created if there is already a pending billing in - // progress, ie. a billing known to Payments. + // Billing setups cannot be created if there is already a pending billing in + // progress. BILLING_SETUP_IN_PROGRESS = 10; - // Billing Setups can only be created by customers who have permission to + // Billing setups can only be created by customers who have permission to // setup billings. Users can contact a representative for help setting up // permissions. NO_SIGNUP_PERMISSION = 11; - // Billing Setups cannot be created if there is already a future-approved + // Billing setups cannot be created if there is already a future-approved // billing. CHANGE_OF_BILL_TO_IN_PROGRESS = 12; - // Billing Setup creation failed because Payments could not find the - // requested Payments profile. + // Requested payments profile not found. PAYMENTS_PROFILE_NOT_FOUND = 13; - // Billing Setup creation failed because Payments could not find the - // requested Payments account. + // Requested payments account not found. PAYMENTS_ACCOUNT_NOT_FOUND = 14; - // Billing Setup creation failed because Payments considers requested - // Payments profile ineligible. + // Billing setup creation failed because the payments profile is ineligible. PAYMENTS_PROFILE_INELIGIBLE = 15; - // Billing Setup creation failed because Payments considers requested - // Payments account ineligible. + // Billing setup creation failed because the payments account is ineligible. PAYMENTS_ACCOUNT_INELIGIBLE = 16; + + // Billing setup creation failed because the payments profile needs internal + // approval. + CUSTOMER_NEEDS_INTERNAL_APPROVAL = 17; } diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/campaign_budget_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/campaign_budget_error.proto index 7ab1b149f..c5ce64106 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/campaign_budget_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/campaign_budget_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/campaign_criterion_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/campaign_criterion_error.proto index ba0a017c8..fc6ec6884 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/campaign_criterion_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/campaign_criterion_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/campaign_draft_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/campaign_draft_error.proto index 257ccb137..2884fffaa 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/campaign_draft_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/campaign_draft_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/campaign_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/campaign_error.proto index c35bebe43..1738e54b6 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/campaign_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/campaign_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -82,11 +81,11 @@ message CampaignErrorEnum { // Given status is invalid. INVALID_AD_SERVING_OPTIMIZATION_STATUS = 15; - // Error in the campaign level tracking url. + // Error in the campaign level tracking URL. INVALID_TRACKING_URL = 16; - // Cannot set both tracking url template and tracking setting. An user has - // to clear legacy tracking setting in order to add tracking url template. + // Cannot set both tracking URL template and tracking setting. A user has + // to clear legacy tracking setting in order to add tracking URL template. CANNOT_SET_BOTH_TRACKING_URL_TEMPLATE_AND_TRACKING_SETTING = 17; // The maximum number of impressions for Frequency Cap should be an integer diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/campaign_experiment_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/campaign_experiment_error.proto index 25db480ce..45e81b8ee 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/campaign_experiment_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/campaign_experiment_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/campaign_feed_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/campaign_feed_error.proto index 37fd105dd..e7acbfd22 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/campaign_feed_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/campaign_feed_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/campaign_shared_set_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/campaign_shared_set_error.proto index 0623b73a3..71cbbd33e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/campaign_shared_set_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/campaign_shared_set_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/change_status_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/change_status_error.proto index 957f2f685..08179adcf 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/change_status_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/change_status_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/collection_size_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/collection_size_error.proto index 32dee5f9c..ddccb1146 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/collection_size_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/collection_size_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/context_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/context_error.proto index 90ac6cbba..d952d8621 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/context_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/context_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/conversion_action_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/conversion_action_error.proto index 083641e2a..0eb311cf1 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/conversion_action_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/conversion_action_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/conversion_adjustment_upload_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/conversion_adjustment_upload_error.proto index d2eb1e904..0d31c6cb3 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/conversion_adjustment_upload_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/conversion_adjustment_upload_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/conversion_upload_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/conversion_upload_error.proto index af55a4724..ec70cfb2c 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/conversion_upload_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/conversion_upload_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -56,7 +55,7 @@ message ConversionUploadErrorEnum { EXPIRED_GCLID = 5; // The click associated with the given gclid occurred too recently. Please - // try uploading again after 24 hours have passed since the click occurred. + // try uploading again after 6 hours have passed since the click occurred. TOO_RECENT_GCLID = 6; // The click associated with the given gclid could not be found in the @@ -103,7 +102,7 @@ message ConversionUploadErrorEnum { // conversion action combination. DUPLICATE_ORDER_ID = 16; - // The call occurred too recently. Please try uploading again after 24 hours + // The call occurred too recently. Please try uploading again after 6 hours // have passed since the call occurred. TOO_RECENT_CALL = 17; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/country_code_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/country_code_error.proto index c1a8ea55e..ed94ebe34 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/country_code_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/country_code_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/criterion_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/criterion_error.proto index 8a39c6d09..5cc77705f 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/criterion_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/criterion_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/currency_code_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/currency_code_error.proto index 3889e9b64..67cd74102 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/currency_code_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/currency_code_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/custom_interest_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/custom_interest_error.proto index d457d84b2..542bdbfae 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/custom_interest_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/custom_interest_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/customer_client_link_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/customer_client_link_error.proto index 4543aef14..2d169f870 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/customer_client_link_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/customer_client_link_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/customer_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/customer_error.proto index 1bab8b7d0..1a9049660 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/customer_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/customer_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/customer_feed_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/customer_feed_error.proto index 6c8290bcf..1fb7d9daa 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/customer_feed_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/customer_feed_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/customer_manager_link_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/customer_manager_link_error.proto index 48d2ad85e..b808e9d9c 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/customer_manager_link_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/customer_manager_link_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/database_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/database_error.proto index 5018e03ec..542e4ec9f 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/database_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/database_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/date_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/date_error.proto index 803069a6a..1f956ae4a 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/date_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/date_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/date_range_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/date_range_error.proto index a748d7fad..935b1d915 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/date_range_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/date_range_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/distinct_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/distinct_error.proto index cc80a645b..50beaf2eb 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/distinct_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/distinct_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/enum_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/enum_error.proto index c03ca0d66..2dc2bc83d 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/enum_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/enum_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/errors.proto b/third_party/googleapis/google/ads/googleads/v2/errors/errors.proto index e0714b8bc..2c70a9812 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/errors.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/errors.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -80,6 +79,7 @@ import "google/ads/googleads/v2/errors/header_error.proto"; import "google/ads/googleads/v2/errors/id_error.proto"; import "google/ads/googleads/v2/errors/image_error.proto"; import "google/ads/googleads/v2/errors/internal_error.proto"; +import "google/ads/googleads/v2/errors/invoice_error.proto"; import "google/ads/googleads/v2/errors/keyword_plan_ad_group_error.proto"; import "google/ads/googleads/v2/errors/keyword_plan_campaign_error.proto"; import "google/ads/googleads/v2/errors/keyword_plan_error.proto"; @@ -109,6 +109,7 @@ import "google/ads/googleads/v2/errors/policy_violation_error.proto"; import "google/ads/googleads/v2/errors/query_error.proto"; import "google/ads/googleads/v2/errors/quota_error.proto"; import "google/ads/googleads/v2/errors/range_error.proto"; +import "google/ads/googleads/v2/errors/reach_plan_error.proto"; import "google/ads/googleads/v2/errors/recommendation_error.proto"; import "google/ads/googleads/v2/errors/region_code_error.proto"; import "google/ads/googleads/v2/errors/request_error.proto"; @@ -478,6 +479,12 @@ message ErrorCode { // The reasons for the access invitation error AccessInvitationErrorEnum.AccessInvitationError access_invitation_error = 124; + + // The reasons for the reach plan error + ReachPlanErrorEnum.ReachPlanError reach_plan_error = 125; + + // The reasons for the invoice error + InvoiceErrorEnum.InvoiceError invoice_error = 126; } } diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/extension_feed_item_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/extension_feed_item_error.proto index ba98509f3..b9d148048 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/extension_feed_item_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/extension_feed_item_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/extension_setting_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/extension_setting_error.proto index 85a646400..c21b6a636 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/extension_setting_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/extension_setting_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/feed_attribute_reference_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/feed_attribute_reference_error.proto index cbd82ea95..dcd03b9d5 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/feed_attribute_reference_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/feed_attribute_reference_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/feed_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/feed_error.proto index 43461f666..4a1510482 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/feed_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/feed_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/feed_item_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/feed_item_error.proto index a26c2efc9..c85c05a8e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/feed_item_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/feed_item_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/feed_item_target_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/feed_item_target_error.proto index b54277f71..8de9235d3 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/feed_item_target_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/feed_item_target_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/feed_item_validation_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/feed_item_validation_error.proto index f4fe8425b..0864c6025 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/feed_item_validation_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/feed_item_validation_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -342,6 +341,12 @@ message FeedItemValidationErrorEnum { // Longitude value is missing. MISSING_LONGITUDE_VALUE = 96; + + // Unable to find address. + ADDRESS_NOT_FOUND = 97; + + // Cannot target provided address. + ADDRESS_NOT_TARGETABLE = 98; } diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/feed_mapping_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/feed_mapping_error.proto index 72c62c30e..d00965b67 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/feed_mapping_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/feed_mapping_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/field_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/field_error.proto index 06932760b..860535da3 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/field_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/field_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/field_mask_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/field_mask_error.proto index 89ef40671..17fc36a48 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/field_mask_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/field_mask_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/function_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/function_error.proto index bdf31bc01..82e18864d 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/function_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/function_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/function_parsing_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/function_parsing_error.proto index b93804c4d..396579c59 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/function_parsing_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/function_parsing_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/geo_target_constant_suggestion_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/geo_target_constant_suggestion_error.proto index 4a4904464..e0f8479b9 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/geo_target_constant_suggestion_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/geo_target_constant_suggestion_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/header_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/header_error.proto index bd3276d88..c230cebb0 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/header_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/header_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/id_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/id_error.proto index 4324e8f9b..8ede7d189 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/id_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/id_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/image_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/image_error.proto index 2d76b5391..4907e1325 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/image_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/image_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/internal_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/internal_error.proto index f0f6d7a02..1a7210bf3 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/internal_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/internal_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -43,8 +42,8 @@ message InternalErrorEnum { // Google Ads API encountered unexpected internal error. INTERNAL_ERROR = 2; - // The intended error code doesn't exist in any API version. This will be - // fixed by adding a new error code as soon as possible. + // The intended error code doesn't exist in specified API version. It will + // be released in a future API version. ERROR_CODE_NOT_PUBLISHED = 3; // Google Ads API encountered an unexpected transient error. The user diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/invoice_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/invoice_error.proto new file mode 100644 index 000000000..a454930db --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v2/errors/invoice_error.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v2.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V2.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "InvoiceErrorProto"; +option java_package = "com.google.ads.googleads.v2.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V2\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V2::Errors"; + +// Proto file describing invoice errors. + +// Container for enum describing possible invoice errors. +message InvoiceErrorEnum { + // Enum describing possible invoice errors. + enum InvoiceError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Cannot request invoices issued before 2019-01-01. + YEAR_MONTH_TOO_OLD = 2; + + // Cannot request invoices for customer who doesn't receive invoices. + NOT_INVOICED_CUSTOMER = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/keyword_plan_ad_group_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/keyword_plan_ad_group_error.proto index 15cd514e7..b2a2a0058 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/keyword_plan_ad_group_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/keyword_plan_ad_group_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/keyword_plan_campaign_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/keyword_plan_campaign_error.proto index 50b7b2eb4..c43f04a62 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/keyword_plan_campaign_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/keyword_plan_campaign_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/keyword_plan_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/keyword_plan_error.proto index f2b71eb0e..b6bcac5dc 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/keyword_plan_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/keyword_plan_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/keyword_plan_idea_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/keyword_plan_idea_error.proto index c5c1fff69..603b4a725 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/keyword_plan_idea_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/keyword_plan_idea_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/keyword_plan_keyword_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/keyword_plan_keyword_error.proto index 12a19d431..353707501 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/keyword_plan_keyword_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/keyword_plan_keyword_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/keyword_plan_negative_keyword_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/keyword_plan_negative_keyword_error.proto index b835f81d9..cfb9d2f54 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/keyword_plan_negative_keyword_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/keyword_plan_negative_keyword_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/label_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/label_error.proto index 1698d3d8e..790b63e20 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/label_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/label_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/language_code_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/language_code_error.proto index 6fe688ac9..024cfd28e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/language_code_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/language_code_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/list_operation_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/list_operation_error.proto index 535b8f3db..01cb3b073 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/list_operation_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/list_operation_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/manager_link_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/manager_link_error.proto index 13a567de7..8ee62f156 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/manager_link_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/manager_link_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/media_bundle_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/media_bundle_error.proto index 54976519c..9f7ddc418 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/media_bundle_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/media_bundle_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/media_file_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/media_file_error.proto index 9e8505e1d..700e4438f 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/media_file_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/media_file_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/media_upload_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/media_upload_error.proto index f14383534..d9da83549 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/media_upload_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/media_upload_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/multiplier_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/multiplier_error.proto index bf3ffbdb8..182a1ec93 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/multiplier_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/multiplier_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/mutate_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/mutate_error.proto index 78a492a84..1eed6c083 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/mutate_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/mutate_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/mutate_job_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/mutate_job_error.proto index 482c8bcfe..3b1d306a8 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/mutate_job_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/mutate_job_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/new_resource_creation_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/new_resource_creation_error.proto index 0a329e5fa..0d32d0079 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/new_resource_creation_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/new_resource_creation_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/not_empty_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/not_empty_error.proto index 6ce8e191c..a745082ab 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/not_empty_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/not_empty_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/not_whitelisted_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/not_whitelisted_error.proto index 559f694a6..80940a19e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/not_whitelisted_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/not_whitelisted_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/null_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/null_error.proto index f93b149d5..640e49ef6 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/null_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/null_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/operation_access_denied_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/operation_access_denied_error.proto index 59986c22f..9d3dbe8cb 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/operation_access_denied_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/operation_access_denied_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/operator_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/operator_error.proto index 8e56aaa42..2a43d832c 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/operator_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/operator_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/partial_failure_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/partial_failure_error.proto index f6d7e9f94..807aacd11 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/partial_failure_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/partial_failure_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/policy_finding_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/policy_finding_error.proto index 15701cdb5..29895a6ed 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/policy_finding_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/policy_finding_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/policy_validation_parameter_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/policy_validation_parameter_error.proto index 5cb642369..3ac696471 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/policy_validation_parameter_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/policy_validation_parameter_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/policy_violation_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/policy_violation_error.proto index 07e462bfc..ba8dfec84 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/policy_violation_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/policy_violation_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/query_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/query_error.proto index 8a56b4897..32637921d 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/query_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/query_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/quota_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/quota_error.proto index 869c3e8a8..337d9405d 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/quota_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/quota_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/range_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/range_error.proto index 954701048..e1ab6bf81 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/range_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/range_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/reach_plan_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/reach_plan_error.proto new file mode 100644 index 000000000..80df2ff43 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v2/errors/reach_plan_error.proto @@ -0,0 +1,45 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v2.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V2.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "ReachPlanErrorProto"; +option java_package = "com.google.ads.googleads.v2.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V2\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V2::Errors"; + +// Proto file describing errors generated from ReachPlanService. + +// Container for enum describing possible errors returned from +// the ReachPlanService. +message ReachPlanErrorEnum { + // Enum describing possible errors from ReachPlanService. + enum ReachPlanError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/recommendation_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/recommendation_error.proto index 34a0d6d81..1fdeb71b0 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/recommendation_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/recommendation_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/region_code_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/region_code_error.proto index 608fd1378..49ba7747e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/region_code_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/region_code_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/request_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/request_error.proto index 0a9569511..5b1f126d6 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/request_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/request_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/resource_access_denied_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/resource_access_denied_error.proto index a683d4521..09db63c58 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/resource_access_denied_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/resource_access_denied_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/resource_count_limit_exceeded_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/resource_count_limit_exceeded_error.proto index 025f69b3d..0b9e6701c 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/resource_count_limit_exceeded_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/resource_count_limit_exceeded_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/setting_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/setting_error.proto index 5aa5f09a3..eb60df171 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/setting_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/setting_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/shared_criterion_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/shared_criterion_error.proto index 1af20ad74..3870b6814 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/shared_criterion_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/shared_criterion_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/shared_set_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/shared_set_error.proto index d47e1d41e..b868c66f0 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/shared_set_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/shared_set_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/size_limit_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/size_limit_error.proto index f49ee810d..9a94beef3 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/size_limit_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/size_limit_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/string_format_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/string_format_error.proto index 63b3916ec..7dddad081 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/string_format_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/string_format_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/string_length_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/string_length_error.proto index 3191fb42b..8764ca727 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/string_length_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/string_length_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/url_field_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/url_field_error.proto index 715aac112..2e306caef 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/url_field_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/url_field_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/user_list_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/user_list_error.proto index afd4d5d4d..6c01b42e4 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/user_list_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/user_list_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/errors/youtube_video_registration_error.proto b/third_party/googleapis/google/ads/googleads/v2/errors/youtube_video_registration_error.proto index 7eec32be0..4f93401c7 100644 --- a/third_party/googleapis/google/ads/googleads/v2/errors/youtube_video_registration_error.proto +++ b/third_party/googleapis/google/ads/googleads/v2/errors/youtube_video_registration_error.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/ads/googleads/v2/googleads_gapic.yaml b/third_party/googleapis/google/ads/googleads/v2/googleads_gapic.yaml new file mode 100644 index 000000000..ff8c544fd --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v2/googleads_gapic.yaml @@ -0,0 +1,17 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 2.0.0 +language_settings: + csharp: + package_name: Google.Ads.GoogleAds.V2.Services + go: + package_name: google.golang.org/google/ads/googleads/v2/services + java: + package_name: com.google.ads.googleads.v2.services + nodejs: + package_name: v2.services + php: + package_name: Google\Ads\Googleads\V2\Services + python: + package_name: google.ads.googleads_v2.gapic.services + ruby: + package_name: Google::Ads::Googleads::V2::Services diff --git a/third_party/googleapis/google/ads/googleads/v2/googleads_grpc_service_config.json b/third_party/googleapis/google/ads/googleads/v2/googleads_grpc_service_config.json new file mode 100644 index 000000000..d2a0c54bc --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v2/googleads_grpc_service_config.json @@ -0,0 +1,124 @@ +{ + "methodConfig": [ + { + "name": [ + { "service": "google.ads.googleads.v2.services.AccountBudgetProposalService" }, + { "service": "google.ads.googleads.v2.services.AccountBudgetService" }, + { "service": "google.ads.googleads.v2.services.AdGroupAdLabelService" }, + { "service": "google.ads.googleads.v2.services.AdGroupAdAssetViewService" }, + { "service": "google.ads.googleads.v2.services.AdGroupAdService" }, + { "service": "google.ads.googleads.v2.services.AdGroupAudienceViewService" }, + { "service": "google.ads.googleads.v2.services.AdGroupBidModifierService" }, + { "service": "google.ads.googleads.v2.services.AdGroupCriterionLabelService" }, + { "service": "google.ads.googleads.v2.services.AdGroupCriterionService" }, + { "service": "google.ads.googleads.v2.services.AdGroupCriterionSimulationService" }, + { "service": "google.ads.googleads.v2.services.AdGroupExtensionSettingService" }, + { "service": "google.ads.googleads.v2.services.AdGroupFeedService" }, + { "service": "google.ads.googleads.v2.services.AdGroupLabelService" }, + { "service": "google.ads.googleads.v2.services.AdGroupService" }, + { "service": "google.ads.googleads.v2.services.AdGroupSimulationService" }, + { "service": "google.ads.googleads.v2.services.AdParameterService" }, + { "service": "google.ads.googleads.v2.services.AdScheduleViewService" }, + { "service": "google.ads.googleads.v2.services.AdService" }, + { "service": "google.ads.googleads.v2.services.AgeRangeViewService" }, + { "service": "google.ads.googleads.v2.services.AssetService" }, + { "service": "google.ads.googleads.v2.services.BiddingStrategyService" }, + { "service": "google.ads.googleads.v2.services.BillingSetupService" }, + { "service": "google.ads.googleads.v2.services.CampaignAudienceViewService" }, + { "service": "google.ads.googleads.v2.services.CampaignBidModifierService" }, + { "service": "google.ads.googleads.v2.services.CampaignBudgetService" }, + { "service": "google.ads.googleads.v2.services.CampaignCriterionService" }, + { "service": "google.ads.googleads.v2.services.CampaignCriterionSimulationService" }, + { "service": "google.ads.googleads.v2.services.CampaignDraftService" }, + { "service": "google.ads.googleads.v2.services.CampaignExperimentService" }, + { "service": "google.ads.googleads.v2.services.CampaignExtensionSettingService" }, + { "service": "google.ads.googleads.v2.services.CampaignFeedService" }, + { "service": "google.ads.googleads.v2.services.CampaignLabelService" }, + { "service": "google.ads.googleads.v2.services.CampaignService" }, + { "service": "google.ads.googleads.v2.services.CampaignSharedSetService" }, + { "service": "google.ads.googleads.v2.services.CarrierConstantService" }, + { "service": "google.ads.googleads.v2.services.ChangeStatusService" }, + { "service": "google.ads.googleads.v2.services.ClickViewService" }, + { "service": "google.ads.googleads.v2.services.ConversionActionService" }, + { "service": "google.ads.googleads.v2.services.ConversionAdjustmentUploadService" }, + { "service": "google.ads.googleads.v2.services.ConversionUploadService" }, + { "service": "google.ads.googleads.v2.services.CustomInterestService" }, + { "service": "google.ads.googleads.v2.services.CustomerClientLinkService" }, + { "service": "google.ads.googleads.v2.services.CustomerClientService" }, + { "service": "google.ads.googleads.v2.services.CustomerExtensionSettingService" }, + { "service": "google.ads.googleads.v2.services.CustomerFeedService" }, + { "service": "google.ads.googleads.v2.services.CustomerLabelService" }, + { "service": "google.ads.googleads.v2.services.CustomerManagerLinkService" }, + { "service": "google.ads.googleads.v2.services.CustomerNegativeCriterionService" }, + { "service": "google.ads.googleads.v2.services.CustomerService" }, + { "service": "google.ads.googleads.v2.services.DetailPlacementViewService" }, + { "service": "google.ads.googleads.v2.services.DisplayKeywordViewService" }, + { "service": "google.ads.googleads.v2.services.DistanceViewService" }, + { "service": "google.ads.googleads.v2.services.DomainCategoryService" }, + { "service": "google.ads.googleads.v2.services.DynamicSearchAdsSearchTermViewService" }, + { "service": "google.ads.googleads.v2.services.ExpandedLandingPageViewService" }, + { "service": "google.ads.googleads.v2.services.ExtensionFeedItemService" }, + { "service": "google.ads.googleads.v2.services.FeedItemService" }, + { "service": "google.ads.googleads.v2.services.FeedItemTargetService" }, + { "service": "google.ads.googleads.v2.services.FeedMappingService" }, + { "service": "google.ads.googleads.v2.services.FeedPlaceholderViewService" }, + { "service": "google.ads.googleads.v2.services.FeedService" }, + { "service": "google.ads.googleads.v2.services.GenderViewService" }, + { "service": "google.ads.googleads.v2.services.GeographicViewService" }, + { "service": "google.ads.googleads.v2.services.GeoTargetConstantService" }, + { "service": "google.ads.googleads.v2.services.GoogleAdsFieldService" }, + { "service": "google.ads.googleads.v2.services.GoogleAdsService" }, + { "service": "google.ads.googleads.v2.services.GroupPlacementViewService" }, + { "service": "google.ads.googleads.v2.services.HotelGroupViewService" }, + { "service": "google.ads.googleads.v2.services.HotelPerformanceViewService" }, + { "service": "google.ads.googleads.v2.services.InvoiceService" }, + { "service": "google.ads.googleads.v2.services.KeywordPlanAdGroupService" }, + { "service": "google.ads.googleads.v2.services.KeywordPlanCampaignService" }, + { "service": "google.ads.googleads.v2.services.KeywordPlanIdeaService" }, + { "service": "google.ads.googleads.v2.services.KeywordPlanKeywordService" }, + { "service": "google.ads.googleads.v2.services.KeywordPlanNegativeKeywordService" }, + { "service": "google.ads.googleads.v2.services.KeywordPlanService" }, + { "service": "google.ads.googleads.v2.services.KeywordViewService" }, + { "service": "google.ads.googleads.v2.services.LabelService" }, + { "service": "google.ads.googleads.v2.services.LandingPageViewService" }, + { "service": "google.ads.googleads.v2.services.LanguageConstantService" }, + { "service": "google.ads.googleads.v2.services.LocationViewService" }, + { "service": "google.ads.googleads.v2.services.ManagedPlacementViewService" }, + { "service": "google.ads.googleads.v2.services.MediaFileService" }, + { "service": "google.ads.googleads.v2.services.MerchantCenterLinkService" }, + { "service": "google.ads.googleads.v2.services.MobileAppCategoryConstantService" }, + { "service": "google.ads.googleads.v2.services.MobileDeviceConstantService" }, + { "service": "google.ads.googleads.v2.services.MutateJobService" }, + { "service": "google.ads.googleads.v2.services.OperatingSystemVersionConstantService" }, + { "service": "google.ads.googleads.v2.services.PaidOrganicSearchTermViewService" }, + { "service": "google.ads.googleads.v2.services.ParentalStatusViewService" }, + { "service": "google.ads.googleads.v2.services.PaymentsAccountService" }, + { "service": "google.ads.googleads.v2.services.ProductBiddingCategoryConstantService" }, + { "service": "google.ads.googleads.v2.services.ProductGroupViewService" }, + { "service": "google.ads.googleads.v2.services.ReachPlanService" }, + { "service": "google.ads.googleads.v2.services.RecommendationService" }, + { "service": "google.ads.googleads.v2.services.RemarketingActionService" }, + { "service": "google.ads.googleads.v2.services.SearchTermViewService" }, + { "service": "google.ads.googleads.v2.services.SharedCriterionService" }, + { "service": "google.ads.googleads.v2.services.SharedSetService" }, + { "service": "google.ads.googleads.v2.services.ShoppingPerformanceViewService" }, + { "service": "google.ads.googleads.v2.services.TopicConstantService" }, + { "service": "google.ads.googleads.v2.services.TopicViewService" }, + { "service": "google.ads.googleads.v2.services.UserInterestService" }, + { "service": "google.ads.googleads.v2.services.UserListService" }, + { "service": "google.ads.googleads.v2.services.UserLocationViewService" }, + { "service": "google.ads.googleads.v2.services.VideoService" } + ], + "timeout": "3600s", + "retryPolicy": { + "initialBackoff": "5s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/ads/googleads/v2/googleads_v2.yaml b/third_party/googleapis/google/ads/googleads/v2/googleads_v2.yaml new file mode 100644 index 000000000..7774a300d --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v2/googleads_v2.yaml @@ -0,0 +1,449 @@ +type: google.api.Service +config_version: 3 +name: googleads.googleapis.com +title: Google Ads API + +apis: +- name: google.ads.googleads.v2.services.AccountBudgetProposalService +- name: google.ads.googleads.v2.services.AccountBudgetService +- name: google.ads.googleads.v2.services.AdGroupAdAssetViewService +- name: google.ads.googleads.v2.services.AdGroupAdLabelService +- name: google.ads.googleads.v2.services.AdGroupAdService +- name: google.ads.googleads.v2.services.AdGroupAudienceViewService +- name: google.ads.googleads.v2.services.AdGroupBidModifierService +- name: google.ads.googleads.v2.services.AdGroupCriterionLabelService +- name: google.ads.googleads.v2.services.AdGroupCriterionService +- name: google.ads.googleads.v2.services.AdGroupCriterionSimulationService +- name: google.ads.googleads.v2.services.AdGroupExtensionSettingService +- name: google.ads.googleads.v2.services.AdGroupFeedService +- name: google.ads.googleads.v2.services.AdGroupLabelService +- name: google.ads.googleads.v2.services.AdGroupService +- name: google.ads.googleads.v2.services.AdGroupSimulationService +- name: google.ads.googleads.v2.services.AdParameterService +- name: google.ads.googleads.v2.services.AdScheduleViewService +- name: google.ads.googleads.v2.services.AdService +- name: google.ads.googleads.v2.services.AgeRangeViewService +- name: google.ads.googleads.v2.services.AssetService +- name: google.ads.googleads.v2.services.BiddingStrategyService +- name: google.ads.googleads.v2.services.BillingSetupService +- name: google.ads.googleads.v2.services.CampaignAudienceViewService +- name: google.ads.googleads.v2.services.CampaignBidModifierService +- name: google.ads.googleads.v2.services.CampaignBudgetService +- name: google.ads.googleads.v2.services.CampaignCriterionService +- name: google.ads.googleads.v2.services.CampaignCriterionSimulationService +- name: google.ads.googleads.v2.services.CampaignDraftService +- name: google.ads.googleads.v2.services.CampaignExperimentService +- name: google.ads.googleads.v2.services.CampaignExtensionSettingService +- name: google.ads.googleads.v2.services.CampaignFeedService +- name: google.ads.googleads.v2.services.CampaignLabelService +- name: google.ads.googleads.v2.services.CampaignService +- name: google.ads.googleads.v2.services.CampaignSharedSetService +- name: google.ads.googleads.v2.services.CarrierConstantService +- name: google.ads.googleads.v2.services.ChangeStatusService +- name: google.ads.googleads.v2.services.ClickViewService +- name: google.ads.googleads.v2.services.ConversionActionService +- name: google.ads.googleads.v2.services.ConversionAdjustmentUploadService +- name: google.ads.googleads.v2.services.ConversionUploadService +- name: google.ads.googleads.v2.services.CustomInterestService +- name: google.ads.googleads.v2.services.CustomerClientLinkService +- name: google.ads.googleads.v2.services.CustomerClientService +- name: google.ads.googleads.v2.services.CustomerExtensionSettingService +- name: google.ads.googleads.v2.services.CustomerFeedService +- name: google.ads.googleads.v2.services.CustomerLabelService +- name: google.ads.googleads.v2.services.CustomerManagerLinkService +- name: google.ads.googleads.v2.services.CustomerNegativeCriterionService +- name: google.ads.googleads.v2.services.CustomerService +- name: google.ads.googleads.v2.services.DetailPlacementViewService +- name: google.ads.googleads.v2.services.DisplayKeywordViewService +- name: google.ads.googleads.v2.services.DistanceViewService +- name: google.ads.googleads.v2.services.DomainCategoryService +- name: google.ads.googleads.v2.services.DynamicSearchAdsSearchTermViewService +- name: google.ads.googleads.v2.services.ExpandedLandingPageViewService +- name: google.ads.googleads.v2.services.ExtensionFeedItemService +- name: google.ads.googleads.v2.services.FeedItemService +- name: google.ads.googleads.v2.services.FeedItemTargetService +- name: google.ads.googleads.v2.services.FeedMappingService +- name: google.ads.googleads.v2.services.FeedPlaceholderViewService +- name: google.ads.googleads.v2.services.FeedService +- name: google.ads.googleads.v2.services.GenderViewService +- name: google.ads.googleads.v2.services.GeoTargetConstantService +- name: google.ads.googleads.v2.services.GeographicViewService +- name: google.ads.googleads.v2.services.GoogleAdsFieldService +- name: google.ads.googleads.v2.services.GoogleAdsService +- name: google.ads.googleads.v2.services.GroupPlacementViewService +- name: google.ads.googleads.v2.services.HotelGroupViewService +- name: google.ads.googleads.v2.services.HotelPerformanceViewService +- name: google.ads.googleads.v2.services.InvoiceService +- name: google.ads.googleads.v2.services.KeywordPlanAdGroupService +- name: google.ads.googleads.v2.services.KeywordPlanCampaignService +- name: google.ads.googleads.v2.services.KeywordPlanIdeaService +- name: google.ads.googleads.v2.services.KeywordPlanKeywordService +- name: google.ads.googleads.v2.services.KeywordPlanNegativeKeywordService +- name: google.ads.googleads.v2.services.KeywordPlanService +- name: google.ads.googleads.v2.services.KeywordViewService +- name: google.ads.googleads.v2.services.LabelService +- name: google.ads.googleads.v2.services.LandingPageViewService +- name: google.ads.googleads.v2.services.LanguageConstantService +- name: google.ads.googleads.v2.services.LocationViewService +- name: google.ads.googleads.v2.services.ManagedPlacementViewService +- name: google.ads.googleads.v2.services.MediaFileService +- name: google.ads.googleads.v2.services.MerchantCenterLinkService +- name: google.ads.googleads.v2.services.MobileAppCategoryConstantService +- name: google.ads.googleads.v2.services.MobileDeviceConstantService +- name: google.ads.googleads.v2.services.MutateJobService +- name: google.ads.googleads.v2.services.OperatingSystemVersionConstantService +- name: google.ads.googleads.v2.services.PaidOrganicSearchTermViewService +- name: google.ads.googleads.v2.services.ParentalStatusViewService +- name: google.ads.googleads.v2.services.PaymentsAccountService +- name: google.ads.googleads.v2.services.ProductBiddingCategoryConstantService +- name: google.ads.googleads.v2.services.ProductGroupViewService +- name: google.ads.googleads.v2.services.ReachPlanService +- name: google.ads.googleads.v2.services.RecommendationService +- name: google.ads.googleads.v2.services.RemarketingActionService +- name: google.ads.googleads.v2.services.SearchTermViewService +- name: google.ads.googleads.v2.services.SharedCriterionService +- name: google.ads.googleads.v2.services.SharedSetService +- name: google.ads.googleads.v2.services.ShoppingPerformanceViewService +- name: google.ads.googleads.v2.services.TopicConstantService +- name: google.ads.googleads.v2.services.TopicViewService +- name: google.ads.googleads.v2.services.UserInterestService +- name: google.ads.googleads.v2.services.UserListService +- name: google.ads.googleads.v2.services.UserLocationViewService +- name: google.ads.googleads.v2.services.VideoService + +types: +- name: google.ads.googleads.v2.errors.GoogleAdsFailure +- name: google.ads.googleads.v2.resources.MutateJob.MutateJobMetadata +- name: google.ads.googleads.v2.services.CreateCampaignExperimentMetadata + +documentation: + summary: |- + Manage your AdWords accounts, campaigns, and reports with this REST-based + API. + overview: |- + # This warning always fires when the last path segment of packages is not + + # the version + +backend: + rules: + - selector: google.ads.googleads.v2.services.AccountBudgetProposalService.GetAccountBudgetProposal + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AccountBudgetProposalService.MutateAccountBudgetProposal + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AccountBudgetService.GetAccountBudget + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdGroupAdAssetViewService.GetAdGroupAdAssetView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdGroupAdLabelService.GetAdGroupAdLabel + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdGroupAdLabelService.MutateAdGroupAdLabels + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdGroupAdService.GetAdGroupAd + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdGroupAdService.MutateAdGroupAds + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdGroupAudienceViewService.GetAdGroupAudienceView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdGroupBidModifierService.GetAdGroupBidModifier + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdGroupBidModifierService.MutateAdGroupBidModifiers + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdGroupCriterionLabelService.GetAdGroupCriterionLabel + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdGroupCriterionLabelService.MutateAdGroupCriterionLabels + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdGroupCriterionService.GetAdGroupCriterion + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdGroupCriterionService.MutateAdGroupCriteria + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdGroupCriterionSimulationService.GetAdGroupCriterionSimulation + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdGroupExtensionSettingService.GetAdGroupExtensionSetting + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdGroupExtensionSettingService.MutateAdGroupExtensionSettings + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdGroupFeedService.GetAdGroupFeed + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdGroupFeedService.MutateAdGroupFeeds + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdGroupLabelService.GetAdGroupLabel + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdGroupLabelService.MutateAdGroupLabels + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdGroupService.GetAdGroup + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdGroupService.MutateAdGroups + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdGroupSimulationService.GetAdGroupSimulation + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdParameterService.GetAdParameter + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdParameterService.MutateAdParameters + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdScheduleViewService.GetAdScheduleView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdService.GetAd + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AdService.MutateAds + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AgeRangeViewService.GetAgeRangeView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AssetService.GetAsset + deadline: 60.0 + - selector: google.ads.googleads.v2.services.AssetService.MutateAssets + deadline: 60.0 + - selector: google.ads.googleads.v2.services.BiddingStrategyService.GetBiddingStrategy + deadline: 60.0 + - selector: google.ads.googleads.v2.services.BiddingStrategyService.MutateBiddingStrategies + deadline: 60.0 + - selector: google.ads.googleads.v2.services.BillingSetupService.GetBillingSetup + deadline: 60.0 + - selector: google.ads.googleads.v2.services.BillingSetupService.MutateBillingSetup + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CampaignAudienceViewService.GetCampaignAudienceView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CampaignBidModifierService.GetCampaignBidModifier + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CampaignBidModifierService.MutateCampaignBidModifiers + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CampaignBudgetService.GetCampaignBudget + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CampaignBudgetService.MutateCampaignBudgets + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CampaignCriterionService.GetCampaignCriterion + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CampaignCriterionService.MutateCampaignCriteria + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CampaignCriterionSimulationService.GetCampaignCriterionSimulation + deadline: 60.0 + - selector: 'google.ads.googleads.v2.services.CampaignDraftService.*' + deadline: 60.0 + - selector: 'google.ads.googleads.v2.services.CampaignExperimentService.*' + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CampaignExtensionSettingService.GetCampaignExtensionSetting + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CampaignExtensionSettingService.MutateCampaignExtensionSettings + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CampaignFeedService.GetCampaignFeed + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CampaignFeedService.MutateCampaignFeeds + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CampaignLabelService.GetCampaignLabel + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CampaignLabelService.MutateCampaignLabels + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CampaignService.GetCampaign + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CampaignService.MutateCampaigns + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CampaignSharedSetService.GetCampaignSharedSet + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CampaignSharedSetService.MutateCampaignSharedSets + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CarrierConstantService.GetCarrierConstant + deadline: 60.0 + - selector: google.ads.googleads.v2.services.ChangeStatusService.GetChangeStatus + deadline: 60.0 + - selector: google.ads.googleads.v2.services.ClickViewService.GetClickView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.ConversionActionService.GetConversionAction + deadline: 60.0 + - selector: google.ads.googleads.v2.services.ConversionActionService.MutateConversionActions + deadline: 60.0 + - selector: google.ads.googleads.v2.services.ConversionAdjustmentUploadService.UploadConversionAdjustments + deadline: 60.0 + - selector: google.ads.googleads.v2.services.ConversionUploadService.UploadCallConversions + deadline: 60.0 + - selector: google.ads.googleads.v2.services.ConversionUploadService.UploadClickConversions + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CustomInterestService.GetCustomInterest + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CustomInterestService.MutateCustomInterests + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CustomerClientLinkService.GetCustomerClientLink + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CustomerClientLinkService.MutateCustomerClientLink + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CustomerClientService.GetCustomerClient + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CustomerExtensionSettingService.GetCustomerExtensionSetting + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CustomerExtensionSettingService.MutateCustomerExtensionSettings + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CustomerFeedService.GetCustomerFeed + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CustomerFeedService.MutateCustomerFeeds + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CustomerLabelService.GetCustomerLabel + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CustomerLabelService.MutateCustomerLabels + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CustomerManagerLinkService.GetCustomerManagerLink + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CustomerManagerLinkService.MutateCustomerManagerLink + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CustomerNegativeCriterionService.GetCustomerNegativeCriterion + deadline: 60.0 + - selector: google.ads.googleads.v2.services.CustomerNegativeCriterionService.MutateCustomerNegativeCriteria + deadline: 60.0 + - selector: 'google.ads.googleads.v2.services.CustomerService.*' + deadline: 60.0 + - selector: google.ads.googleads.v2.services.DetailPlacementViewService.GetDetailPlacementView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.DisplayKeywordViewService.GetDisplayKeywordView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.DistanceViewService.GetDistanceView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.DomainCategoryService.GetDomainCategory + deadline: 60.0 + - selector: google.ads.googleads.v2.services.DynamicSearchAdsSearchTermViewService.GetDynamicSearchAdsSearchTermView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.ExpandedLandingPageViewService.GetExpandedLandingPageView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.ExtensionFeedItemService.GetExtensionFeedItem + deadline: 60.0 + - selector: google.ads.googleads.v2.services.ExtensionFeedItemService.MutateExtensionFeedItems + deadline: 60.0 + - selector: google.ads.googleads.v2.services.FeedItemService.GetFeedItem + deadline: 60.0 + - selector: google.ads.googleads.v2.services.FeedItemService.MutateFeedItems + deadline: 60.0 + - selector: google.ads.googleads.v2.services.FeedItemTargetService.GetFeedItemTarget + deadline: 60.0 + - selector: google.ads.googleads.v2.services.FeedItemTargetService.MutateFeedItemTargets + deadline: 60.0 + - selector: google.ads.googleads.v2.services.FeedMappingService.GetFeedMapping + deadline: 60.0 + - selector: google.ads.googleads.v2.services.FeedMappingService.MutateFeedMappings + deadline: 60.0 + - selector: google.ads.googleads.v2.services.FeedPlaceholderViewService.GetFeedPlaceholderView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.FeedService.GetFeed + deadline: 60.0 + - selector: google.ads.googleads.v2.services.FeedService.MutateFeeds + deadline: 60.0 + - selector: google.ads.googleads.v2.services.GenderViewService.GetGenderView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.GeoTargetConstantService.GetGeoTargetConstant + deadline: 60.0 + - selector: google.ads.googleads.v2.services.GeoTargetConstantService.SuggestGeoTargetConstants + deadline: 60.0 + - selector: google.ads.googleads.v2.services.GeographicViewService.GetGeographicView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.GoogleAdsFieldService.GetGoogleAdsField + deadline: 600.0 + - selector: google.ads.googleads.v2.services.GoogleAdsFieldService.SearchGoogleAdsFields + deadline: 600.0 + - selector: google.ads.googleads.v2.services.GoogleAdsService.Mutate + deadline: 600.0 + - selector: google.ads.googleads.v2.services.GoogleAdsService.Search + deadline: 3600.0 + - selector: google.ads.googleads.v2.services.GroupPlacementViewService.GetGroupPlacementView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.HotelGroupViewService.GetHotelGroupView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.HotelPerformanceViewService.GetHotelPerformanceView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.InvoiceService.ListInvoices + deadline: 60.0 + - selector: google.ads.googleads.v2.services.KeywordPlanAdGroupService.GetKeywordPlanAdGroup + deadline: 60.0 + - selector: google.ads.googleads.v2.services.KeywordPlanAdGroupService.MutateKeywordPlanAdGroups + deadline: 60.0 + - selector: google.ads.googleads.v2.services.KeywordPlanCampaignService.GetKeywordPlanCampaign + deadline: 60.0 + - selector: google.ads.googleads.v2.services.KeywordPlanCampaignService.MutateKeywordPlanCampaigns + deadline: 60.0 + - selector: google.ads.googleads.v2.services.KeywordPlanIdeaService.GenerateKeywordIdeas + deadline: 600.0 + - selector: google.ads.googleads.v2.services.KeywordPlanKeywordService.GetKeywordPlanKeyword + deadline: 60.0 + - selector: google.ads.googleads.v2.services.KeywordPlanKeywordService.MutateKeywordPlanKeywords + deadline: 60.0 + - selector: google.ads.googleads.v2.services.KeywordPlanNegativeKeywordService.GetKeywordPlanNegativeKeyword + deadline: 60.0 + - selector: google.ads.googleads.v2.services.KeywordPlanNegativeKeywordService.MutateKeywordPlanNegativeKeywords + deadline: 60.0 + - selector: google.ads.googleads.v2.services.KeywordPlanService.GenerateForecastMetrics + deadline: 600.0 + - selector: google.ads.googleads.v2.services.KeywordPlanService.GenerateHistoricalMetrics + deadline: 600.0 + - selector: google.ads.googleads.v2.services.KeywordPlanService.GetKeywordPlan + deadline: 60.0 + - selector: google.ads.googleads.v2.services.KeywordPlanService.MutateKeywordPlans + deadline: 60.0 + - selector: google.ads.googleads.v2.services.KeywordViewService.GetKeywordView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.LabelService.GetLabel + deadline: 60.0 + - selector: google.ads.googleads.v2.services.LabelService.MutateLabels + deadline: 60.0 + - selector: google.ads.googleads.v2.services.LandingPageViewService.GetLandingPageView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.LanguageConstantService.GetLanguageConstant + deadline: 60.0 + - selector: google.ads.googleads.v2.services.LocationViewService.GetLocationView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.ManagedPlacementViewService.GetManagedPlacementView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.MediaFileService.GetMediaFile + deadline: 60.0 + - selector: google.ads.googleads.v2.services.MediaFileService.MutateMediaFiles + deadline: 60.0 + - selector: 'google.ads.googleads.v2.services.MerchantCenterLinkService.*' + deadline: 60.0 + - selector: google.ads.googleads.v2.services.MobileAppCategoryConstantService.GetMobileAppCategoryConstant + deadline: 60.0 + - selector: google.ads.googleads.v2.services.MobileDeviceConstantService.GetMobileDeviceConstant + deadline: 60.0 + - selector: 'google.ads.googleads.v2.services.MutateJobService.*' + deadline: 60.0 + - selector: google.ads.googleads.v2.services.OperatingSystemVersionConstantService.GetOperatingSystemVersionConstant + deadline: 60.0 + - selector: google.ads.googleads.v2.services.PaidOrganicSearchTermViewService.GetPaidOrganicSearchTermView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.ParentalStatusViewService.GetParentalStatusView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.PaymentsAccountService.ListPaymentsAccounts + deadline: 60.0 + - selector: google.ads.googleads.v2.services.ProductBiddingCategoryConstantService.GetProductBiddingCategoryConstant + deadline: 60.0 + - selector: google.ads.googleads.v2.services.ProductGroupViewService.GetProductGroupView + deadline: 60.0 + - selector: 'google.ads.googleads.v2.services.ReachPlanService.*' + deadline: 600.0 + - selector: 'google.ads.googleads.v2.services.RecommendationService.*' + deadline: 600.0 + - selector: google.ads.googleads.v2.services.RemarketingActionService.GetRemarketingAction + deadline: 60.0 + - selector: google.ads.googleads.v2.services.RemarketingActionService.MutateRemarketingActions + deadline: 60.0 + - selector: google.ads.googleads.v2.services.SearchTermViewService.GetSearchTermView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.SharedCriterionService.GetSharedCriterion + deadline: 60.0 + - selector: google.ads.googleads.v2.services.SharedCriterionService.MutateSharedCriteria + deadline: 60.0 + - selector: google.ads.googleads.v2.services.SharedSetService.GetSharedSet + deadline: 60.0 + - selector: google.ads.googleads.v2.services.SharedSetService.MutateSharedSets + deadline: 60.0 + - selector: google.ads.googleads.v2.services.ShoppingPerformanceViewService.GetShoppingPerformanceView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.TopicConstantService.GetTopicConstant + deadline: 60.0 + - selector: google.ads.googleads.v2.services.TopicViewService.GetTopicView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.UserInterestService.GetUserInterest + deadline: 60.0 + - selector: google.ads.googleads.v2.services.UserListService.GetUserList + deadline: 60.0 + - selector: google.ads.googleads.v2.services.UserListService.MutateUserLists + deadline: 60.0 + - selector: google.ads.googleads.v2.services.UserLocationViewService.GetUserLocationView + deadline: 60.0 + - selector: google.ads.googleads.v2.services.VideoService.GetVideo + deadline: 60.0 + - selector: 'google.longrunning.Operations.*' + deadline: 60.0 diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/account_budget.proto b/third_party/googleapis/google/ads/googleads/v2/resources/account_budget.proto index 74abe4d32..bd2a699b3 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/account_budget.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/account_budget.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -21,6 +20,8 @@ import "google/ads/googleads/v2/enums/account_budget_proposal_type.proto"; import "google/ads/googleads/v2/enums/account_budget_status.proto"; import "google/ads/googleads/v2/enums/spending_limit_type.proto"; import "google/ads/googleads/v2/enums/time_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -52,117 +53,137 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // adjustments. Adjustments create differences between the 'approved' and // 'adjusted' fields, which would otherwise be identical. message AccountBudget { + option (google.api.resource) = { + type: "googleads.googleapis.com/AccountBudget" + pattern: "customers/{customer}/accountBudgets/{account_budget}" + }; + // A pending proposal associated with the enclosing account-level budget, // if applicable. message PendingAccountBudgetProposal { - // The resource name of the proposal. + // Output only. The resource name of the proposal. // AccountBudgetProposal resource names have the form: // // `customers/{customer_id}/accountBudgetProposals/{account_budget_proposal_id}` - google.protobuf.StringValue account_budget_proposal = 1; - - // The type of this proposal, e.g. END to end the budget associated + google.protobuf.StringValue account_budget_proposal = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AccountBudgetProposal" + } + ]; + + // Output only. The type of this proposal, e.g. END to end the budget associated // with this proposal. - google.ads.googleads.v2.enums.AccountBudgetProposalTypeEnum.AccountBudgetProposalType proposal_type = 2; + google.ads.googleads.v2.enums.AccountBudgetProposalTypeEnum.AccountBudgetProposalType proposal_type = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The name to assign to the account-level budget. - google.protobuf.StringValue name = 3; + // Output only. The name to assign to the account-level budget. + google.protobuf.StringValue name = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The start time in yyyy-MM-dd HH:mm:ss format. - google.protobuf.StringValue start_date_time = 4; + // Output only. The start time in yyyy-MM-dd HH:mm:ss format. + google.protobuf.StringValue start_date_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // A purchase order number is a value that helps users reference this budget + // Output only. A purchase order number is a value that helps users reference this budget // in their monthly invoices. - google.protobuf.StringValue purchase_order_number = 9; + google.protobuf.StringValue purchase_order_number = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Notes associated with this budget. - google.protobuf.StringValue notes = 10; + // Output only. Notes associated with this budget. + google.protobuf.StringValue notes = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The time when this account-level budget proposal was created. + // Output only. The time when this account-level budget proposal was created. // Formatted as yyyy-MM-dd HH:mm:ss. - google.protobuf.StringValue creation_date_time = 11; + google.protobuf.StringValue creation_date_time = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; // The end time of the account-level budget. oneof end_time { - // The end time in yyyy-MM-dd HH:mm:ss format. - google.protobuf.StringValue end_date_time = 5; + // Output only. The end time in yyyy-MM-dd HH:mm:ss format. + google.protobuf.StringValue end_date_time = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The end time as a well-defined type, e.g. FOREVER. - google.ads.googleads.v2.enums.TimeTypeEnum.TimeType end_time_type = 6; + // Output only. The end time as a well-defined type, e.g. FOREVER. + google.ads.googleads.v2.enums.TimeTypeEnum.TimeType end_time_type = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The spending limit. oneof spending_limit { - // The spending limit in micros. One million is equivalent to + // Output only. The spending limit in micros. One million is equivalent to // one unit. - google.protobuf.Int64Value spending_limit_micros = 7; + google.protobuf.Int64Value spending_limit_micros = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The spending limit as a well-defined type, e.g. INFINITE. - google.ads.googleads.v2.enums.SpendingLimitTypeEnum.SpendingLimitType spending_limit_type = 8; + // Output only. The spending limit as a well-defined type, e.g. INFINITE. + google.ads.googleads.v2.enums.SpendingLimitTypeEnum.SpendingLimitType spending_limit_type = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; } } - // The resource name of the account-level budget. + // Output only. The resource name of the account-level budget. // AccountBudget resource names have the form: // // `customers/{customer_id}/accountBudgets/{account_budget_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AccountBudget" + } + ]; - // The ID of the account-level budget. - google.protobuf.Int64Value id = 2; + // Output only. The ID of the account-level budget. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The resource name of the billing setup associated with this account-level + // Output only. The resource name of the billing setup associated with this account-level // budget. BillingSetup resource names have the form: // // `customers/{customer_id}/billingSetups/{billing_setup_id}` - google.protobuf.StringValue billing_setup = 3; + google.protobuf.StringValue billing_setup = 3 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/BillingSetup" + } + ]; - // The status of this account-level budget. - google.ads.googleads.v2.enums.AccountBudgetStatusEnum.AccountBudgetStatus status = 4; + // Output only. The status of this account-level budget. + google.ads.googleads.v2.enums.AccountBudgetStatusEnum.AccountBudgetStatus status = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The name of the account-level budget. - google.protobuf.StringValue name = 5; + // Output only. The name of the account-level budget. + google.protobuf.StringValue name = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The proposed start time of the account-level budget in + // Output only. The proposed start time of the account-level budget in // yyyy-MM-dd HH:mm:ss format. If a start time type of NOW was proposed, // this is the time of request. - google.protobuf.StringValue proposed_start_date_time = 6; + google.protobuf.StringValue proposed_start_date_time = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The approved start time of the account-level budget in yyyy-MM-dd HH:mm:ss + // Output only. The approved start time of the account-level budget in yyyy-MM-dd HH:mm:ss // format. // // For example, if a new budget is approved after the proposed start time, // the approved start time is the time of approval. - google.protobuf.StringValue approved_start_date_time = 7; + google.protobuf.StringValue approved_start_date_time = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The total adjustments amount. + // Output only. The total adjustments amount. // // An example of an adjustment is courtesy credits. - google.protobuf.Int64Value total_adjustments_micros = 18; + google.protobuf.Int64Value total_adjustments_micros = 18 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The value of Ads that have been served, in micros. + // Output only. The value of Ads that have been served, in micros. // // This includes overdelivery costs, in which case a credit might be // automatically applied to the budget (see total_adjustments_micros). - google.protobuf.Int64Value amount_served_micros = 19; + google.protobuf.Int64Value amount_served_micros = 19 [(google.api.field_behavior) = OUTPUT_ONLY]; - // A purchase order number is a value that helps users reference this budget + // Output only. A purchase order number is a value that helps users reference this budget // in their monthly invoices. - google.protobuf.StringValue purchase_order_number = 20; + google.protobuf.StringValue purchase_order_number = 20 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Notes associated with the budget. - google.protobuf.StringValue notes = 21; + // Output only. Notes associated with the budget. + google.protobuf.StringValue notes = 21 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The pending proposal to modify this budget, if applicable. - PendingAccountBudgetProposal pending_proposal = 22; + // Output only. The pending proposal to modify this budget, if applicable. + PendingAccountBudgetProposal pending_proposal = 22 [(google.api.field_behavior) = OUTPUT_ONLY]; // The proposed end time of the account-level budget. oneof proposed_end_time { - // The proposed end time in yyyy-MM-dd HH:mm:ss format. - google.protobuf.StringValue proposed_end_date_time = 8; + // Output only. The proposed end time in yyyy-MM-dd HH:mm:ss format. + google.protobuf.StringValue proposed_end_date_time = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The proposed end time as a well-defined type, e.g. FOREVER. - google.ads.googleads.v2.enums.TimeTypeEnum.TimeType proposed_end_time_type = 9; + // Output only. The proposed end time as a well-defined type, e.g. FOREVER. + google.ads.googleads.v2.enums.TimeTypeEnum.TimeType proposed_end_time_type = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The approved end time of the account-level budget. @@ -170,21 +191,21 @@ message AccountBudget { // For example, if a budget's end time is updated and the proposal is approved // after the proposed end time, the approved end time is the time of approval. oneof approved_end_time { - // The approved end time in yyyy-MM-dd HH:mm:ss format. - google.protobuf.StringValue approved_end_date_time = 10; + // Output only. The approved end time in yyyy-MM-dd HH:mm:ss format. + google.protobuf.StringValue approved_end_date_time = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The approved end time as a well-defined type, e.g. FOREVER. - google.ads.googleads.v2.enums.TimeTypeEnum.TimeType approved_end_time_type = 11; + // Output only. The approved end time as a well-defined type, e.g. FOREVER. + google.ads.googleads.v2.enums.TimeTypeEnum.TimeType approved_end_time_type = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The proposed spending limit. oneof proposed_spending_limit { - // The proposed spending limit in micros. One million is equivalent to + // Output only. The proposed spending limit in micros. One million is equivalent to // one unit. - google.protobuf.Int64Value proposed_spending_limit_micros = 12; + google.protobuf.Int64Value proposed_spending_limit_micros = 12 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The proposed spending limit as a well-defined type, e.g. INFINITE. - google.ads.googleads.v2.enums.SpendingLimitTypeEnum.SpendingLimitType proposed_spending_limit_type = 13; + // Output only. The proposed spending limit as a well-defined type, e.g. INFINITE. + google.ads.googleads.v2.enums.SpendingLimitTypeEnum.SpendingLimitType proposed_spending_limit_type = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The approved spending limit. @@ -193,15 +214,15 @@ message AccountBudget { // proposed spending limit at the time the proposal is approved, the approved // spending limit is set to the amount already spent. oneof approved_spending_limit { - // The approved spending limit in micros. One million is equivalent to + // Output only. The approved spending limit in micros. One million is equivalent to // one unit. This will only be populated if the proposed spending limit // is finite, and will always be greater than or equal to the // proposed spending limit. - google.protobuf.Int64Value approved_spending_limit_micros = 14; + google.protobuf.Int64Value approved_spending_limit_micros = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The approved spending limit as a well-defined type, e.g. INFINITE. This + // Output only. The approved spending limit as a well-defined type, e.g. INFINITE. This // will only be populated if the approved spending limit is INFINITE. - google.ads.googleads.v2.enums.SpendingLimitTypeEnum.SpendingLimitType approved_spending_limit_type = 15; + google.ads.googleads.v2.enums.SpendingLimitTypeEnum.SpendingLimitType approved_spending_limit_type = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The spending limit after adjustments have been applied. Adjustments are @@ -209,7 +230,7 @@ message AccountBudget { // // This value has the final say on how much the account is allowed to spend. oneof adjusted_spending_limit { - // The adjusted spending limit in micros. One million is equivalent to + // Output only. The adjusted spending limit in micros. One million is equivalent to // one unit. // // If the approved spending limit is finite, the adjusted @@ -221,12 +242,12 @@ message AccountBudget { // // For example, a debit adjustment reduces how much the account is // allowed to spend. - google.protobuf.Int64Value adjusted_spending_limit_micros = 16; + google.protobuf.Int64Value adjusted_spending_limit_micros = 16 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The adjusted spending limit as a well-defined type, e.g. INFINITE. + // Output only. The adjusted spending limit as a well-defined type, e.g. INFINITE. // This will only be populated if the adjusted spending limit is INFINITE, // which is guaranteed to be true if the approved spending limit is // INFINITE. - google.ads.googleads.v2.enums.SpendingLimitTypeEnum.SpendingLimitType adjusted_spending_limit_type = 17; + google.ads.googleads.v2.enums.SpendingLimitTypeEnum.SpendingLimitType adjusted_spending_limit_type = 17 [(google.api.field_behavior) = OUTPUT_ONLY]; } } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/account_budget_proposal.proto b/third_party/googleapis/google/ads/googleads/v2/resources/account_budget_proposal.proto index 7d8e9302d..9fe5123c3 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/account_budget_proposal.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/account_budget_proposal.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -21,6 +20,8 @@ import "google/ads/googleads/v2/enums/account_budget_proposal_status.proto"; import "google/ads/googleads/v2/enums/account_budget_proposal_type.proto"; import "google/ads/googleads/v2/enums/spending_limit_type.proto"; import "google/ads/googleads/v2/enums/time_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -45,96 +46,116 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // Please note that the proposal type (proposal_type) changes which fields are // required and which must remain empty. message AccountBudgetProposal { - // The resource name of the proposal. + option (google.api.resource) = { + type: "googleads.googleapis.com/AccountBudgetProposal" + pattern: "customers/{customer}/accountBudgetProposals/{account_budget_proposal}" + }; + + // Immutable. The resource name of the proposal. // AccountBudgetProposal resource names have the form: // // `customers/{customer_id}/accountBudgetProposals/{account_budget_proposal_id}` - string resource_name = 1; - - // The ID of the proposal. - google.protobuf.Int64Value id = 14; - - // The resource name of the billing setup associated with this proposal. - google.protobuf.StringValue billing_setup = 2; - - // The resource name of the account-level budget associated with this + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AccountBudgetProposal" + } + ]; + + // Output only. The ID of the proposal. + google.protobuf.Int64Value id = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. The resource name of the billing setup associated with this proposal. + google.protobuf.StringValue billing_setup = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/BillingSetup" + } + ]; + + // Immutable. The resource name of the account-level budget associated with this // proposal. - google.protobuf.StringValue account_budget = 3; - - // The type of this proposal, e.g. END to end the budget associated with this + google.protobuf.StringValue account_budget = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AccountBudget" + } + ]; + + // Immutable. The type of this proposal, e.g. END to end the budget associated with this // proposal. - google.ads.googleads.v2.enums.AccountBudgetProposalTypeEnum.AccountBudgetProposalType proposal_type = 4; + google.ads.googleads.v2.enums.AccountBudgetProposalTypeEnum.AccountBudgetProposalType proposal_type = 4 [(google.api.field_behavior) = IMMUTABLE]; - // The status of this proposal. + // Output only. The status of this proposal. // When a new proposal is created, the status defaults to PENDING. - google.ads.googleads.v2.enums.AccountBudgetProposalStatusEnum.AccountBudgetProposalStatus status = 15; + google.ads.googleads.v2.enums.AccountBudgetProposalStatusEnum.AccountBudgetProposalStatus status = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The name to assign to the account-level budget. - google.protobuf.StringValue proposed_name = 5; + // Immutable. The name to assign to the account-level budget. + google.protobuf.StringValue proposed_name = 5 [(google.api.field_behavior) = IMMUTABLE]; - // The approved start date time in yyyy-mm-dd hh:mm:ss format. - google.protobuf.StringValue approved_start_date_time = 20; + // Output only. The approved start date time in yyyy-mm-dd hh:mm:ss format. + google.protobuf.StringValue approved_start_date_time = 20 [(google.api.field_behavior) = OUTPUT_ONLY]; - // A purchase order number is a value that enables the user to help them + // Immutable. A purchase order number is a value that enables the user to help them // reference this budget in their monthly invoices. - google.protobuf.StringValue proposed_purchase_order_number = 12; + google.protobuf.StringValue proposed_purchase_order_number = 12 [(google.api.field_behavior) = IMMUTABLE]; - // Notes associated with this budget. - google.protobuf.StringValue proposed_notes = 13; + // Immutable. Notes associated with this budget. + google.protobuf.StringValue proposed_notes = 13 [(google.api.field_behavior) = IMMUTABLE]; - // The date time when this account-level budget proposal was created, which is + // Output only. The date time when this account-level budget proposal was created, which is // not the same as its approval date time, if applicable. - google.protobuf.StringValue creation_date_time = 16; + google.protobuf.StringValue creation_date_time = 16 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The date time when this account-level budget was approved, if applicable. - google.protobuf.StringValue approval_date_time = 17; + // Output only. The date time when this account-level budget was approved, if applicable. + google.protobuf.StringValue approval_date_time = 17 [(google.api.field_behavior) = OUTPUT_ONLY]; // The proposed start date time of the account-level budget, which cannot be // in the past. oneof proposed_start_time { - // The proposed start date time in yyyy-mm-dd hh:mm:ss format. - google.protobuf.StringValue proposed_start_date_time = 18; + // Immutable. The proposed start date time in yyyy-mm-dd hh:mm:ss format. + google.protobuf.StringValue proposed_start_date_time = 18 [(google.api.field_behavior) = IMMUTABLE]; - // The proposed start date time as a well-defined type, e.g. NOW. - google.ads.googleads.v2.enums.TimeTypeEnum.TimeType proposed_start_time_type = 7; + // Immutable. The proposed start date time as a well-defined type, e.g. NOW. + google.ads.googleads.v2.enums.TimeTypeEnum.TimeType proposed_start_time_type = 7 [(google.api.field_behavior) = IMMUTABLE]; } // The proposed end date time of the account-level budget, which cannot be in // the past. oneof proposed_end_time { - // The proposed end date time in yyyy-mm-dd hh:mm:ss format. - google.protobuf.StringValue proposed_end_date_time = 19; + // Immutable. The proposed end date time in yyyy-mm-dd hh:mm:ss format. + google.protobuf.StringValue proposed_end_date_time = 19 [(google.api.field_behavior) = IMMUTABLE]; - // The proposed end date time as a well-defined type, e.g. FOREVER. - google.ads.googleads.v2.enums.TimeTypeEnum.TimeType proposed_end_time_type = 9; + // Immutable. The proposed end date time as a well-defined type, e.g. FOREVER. + google.ads.googleads.v2.enums.TimeTypeEnum.TimeType proposed_end_time_type = 9 [(google.api.field_behavior) = IMMUTABLE]; } // The approved end date time of the account-level budget. oneof approved_end_time { - // The approved end date time in yyyy-mm-dd hh:mm:ss format. - google.protobuf.StringValue approved_end_date_time = 21; + // Output only. The approved end date time in yyyy-mm-dd hh:mm:ss format. + google.protobuf.StringValue approved_end_date_time = 21 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The approved end date time as a well-defined type, e.g. FOREVER. - google.ads.googleads.v2.enums.TimeTypeEnum.TimeType approved_end_time_type = 22; + // Output only. The approved end date time as a well-defined type, e.g. FOREVER. + google.ads.googleads.v2.enums.TimeTypeEnum.TimeType approved_end_time_type = 22 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The proposed spending limit. oneof proposed_spending_limit { - // The proposed spending limit in micros. One million is equivalent to + // Immutable. The proposed spending limit in micros. One million is equivalent to // one unit. - google.protobuf.Int64Value proposed_spending_limit_micros = 10; + google.protobuf.Int64Value proposed_spending_limit_micros = 10 [(google.api.field_behavior) = IMMUTABLE]; - // The proposed spending limit as a well-defined type, e.g. INFINITE. - google.ads.googleads.v2.enums.SpendingLimitTypeEnum.SpendingLimitType proposed_spending_limit_type = 11; + // Immutable. The proposed spending limit as a well-defined type, e.g. INFINITE. + google.ads.googleads.v2.enums.SpendingLimitTypeEnum.SpendingLimitType proposed_spending_limit_type = 11 [(google.api.field_behavior) = IMMUTABLE]; } // The approved spending limit. oneof approved_spending_limit { - // The approved spending limit in micros. One million is equivalent to + // Output only. The approved spending limit in micros. One million is equivalent to // one unit. - google.protobuf.Int64Value approved_spending_limit_micros = 23; + google.protobuf.Int64Value approved_spending_limit_micros = 23 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The approved spending limit as a well-defined type, e.g. INFINITE. - google.ads.googleads.v2.enums.SpendingLimitTypeEnum.SpendingLimitType approved_spending_limit_type = 24; + // Output only. The approved spending limit as a well-defined type, e.g. INFINITE. + google.ads.googleads.v2.enums.SpendingLimitTypeEnum.SpendingLimitType approved_spending_limit_type = 24 [(google.api.field_behavior) = OUTPUT_ONLY]; } } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/ad.proto b/third_party/googleapis/google/ads/googleads/v2/resources/ad.proto index 36c839b4b..a8580b581 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/ad.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/ad.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -24,6 +23,8 @@ import "google/ads/googleads/v2/common/url_collection.proto"; import "google/ads/googleads/v2/enums/ad_type.proto"; import "google/ads/googleads/v2/enums/device.proto"; import "google/ads/googleads/v2/enums/system_managed_entity_source.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -40,14 +41,24 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // An ad. message Ad { - // The resource name of the ad. + option (google.api.resource) = { + type: "googleads.googleapis.com/Ad" + pattern: "customers/{customer}/ads/{ad}" + }; + + // Immutable. The resource name of the ad. // Ad resource names have the form: // // `customers/{customer_id}/ads/{ad_id}` - string resource_name = 37; + string resource_name = 37 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Ad" + } + ]; - // The ID of the ad. - google.protobuf.Int64Value id = 1; + // Output only. The ID of the ad. + google.protobuf.Int64Value id = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // The list of possible final URLs after all cross-domain redirects for the // ad. @@ -64,6 +75,9 @@ message Ad { // The URL template for constructing a tracking URL. google.protobuf.StringValue tracking_url_template = 12; + // The suffix to use when constructing a final URL. + google.protobuf.StringValue final_url_suffix = 38; + // The list of mappings that can be used to substitute custom parameter tags // in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`. repeated google.ads.googleads.v2.common.CustomParameter url_custom_parameters = 10; @@ -71,14 +85,14 @@ message Ad { // The URL that appears in the ad description for some ad formats. google.protobuf.StringValue display_url = 4; - // The type of ad. - google.ads.googleads.v2.enums.AdTypeEnum.AdType type = 5; + // Output only. The type of ad. + google.ads.googleads.v2.enums.AdTypeEnum.AdType type = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Indicates if this ad was automatically added by Google Ads and not by a + // Output only. Indicates if this ad was automatically added by Google Ads and not by a // user. For example, this could happen when ads are automatically created as // suggestions for new ads based on knowledge of how existing ads are // performing. - google.protobuf.BoolValue added_by_google_ads = 19; + google.protobuf.BoolValue added_by_google_ads = 19 [(google.api.field_behavior) = OUTPUT_ONLY]; // The device preference for the ad. You can only specify a preference for // mobile devices. When this preference is set the ad will be preferred over @@ -92,13 +106,13 @@ message Ad { // can be referenced from other fields in the ad. repeated google.ads.googleads.v2.common.UrlCollection url_collections = 26; - // The name of the ad. This is only used to be able to identify the ad. It + // Immutable. The name of the ad. This is only used to be able to identify the ad. It // does not need to be unique and does not affect the served ad. - google.protobuf.StringValue name = 23; + google.protobuf.StringValue name = 23 [(google.api.field_behavior) = IMMUTABLE]; - // If this ad is system managed, then this field will indicate the source. + // Output only. If this ad is system managed, then this field will indicate the source. // This field is read-only. - google.ads.googleads.v2.enums.SystemManagedResourceSourceEnum.SystemManagedResourceSource system_managed_resource_source = 27; + google.ads.googleads.v2.enums.SystemManagedResourceSourceEnum.SystemManagedResourceSource system_managed_resource_source = 27 [(google.api.field_behavior) = OUTPUT_ONLY]; // Details pertinent to the ad type. Exactly one value must be set. oneof ad_data { @@ -145,8 +159,8 @@ message Ad { // Details pertaining to an app ad. google.ads.googleads.v2.common.AppAdInfo app_ad = 29; - // Details pertaining to a legacy app install ad. - google.ads.googleads.v2.common.LegacyAppInstallAdInfo legacy_app_install_ad = 30; + // Immutable. Details pertaining to a legacy app install ad. + google.ads.googleads.v2.common.LegacyAppInstallAdInfo legacy_app_install_ad = 30 [(google.api.field_behavior) = IMMUTABLE]; // Details pertaining to a responsive display ad. google.ads.googleads.v2.common.ResponsiveDisplayAdInfo responsive_display_ad = 31; diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group.proto b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group.proto index e1d85f74e..e7c50c1e2 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -25,6 +24,8 @@ import "google/ads/googleads/v2/enums/ad_group_status.proto"; import "google/ads/googleads/v2/enums/ad_group_type.proto"; import "google/ads/googleads/v2/enums/bidding_source.proto"; import "google/ads/googleads/v2/enums/targeting_dimension.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -41,14 +42,24 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // An ad group. message AdGroup { - // The resource name of the ad group. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroup" + pattern: "customers/{customer}/adGroups/{ad_group}" + }; + + // Immutable. The resource name of the ad group. // Ad group resource names have the form: // // `customers/{customer_id}/adGroups/{ad_group_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; - // The ID of the ad group. - google.protobuf.Int64Value id = 3; + // Output only. The ID of the ad group. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // The name of the ad group. // @@ -64,20 +75,25 @@ message AdGroup { // The status of the ad group. google.ads.googleads.v2.enums.AdGroupStatusEnum.AdGroupStatus status = 5; - // The type of the ad group. - google.ads.googleads.v2.enums.AdGroupTypeEnum.AdGroupType type = 12; + // Immutable. The type of the ad group. + google.ads.googleads.v2.enums.AdGroupTypeEnum.AdGroupType type = 12 [(google.api.field_behavior) = IMMUTABLE]; // The ad rotation mode of the ad group. google.ads.googleads.v2.enums.AdGroupAdRotationModeEnum.AdGroupAdRotationMode ad_rotation_mode = 22; - // For draft or experiment ad groups, this field is the resource name of the + // Output only. For draft or experiment ad groups, this field is the resource name of the // base ad group from which this ad group was created. If a draft or // experiment ad group does not have a base ad group, then this field is null. // // For base ad groups, this field equals the ad group resource name. // // This field is read-only. - google.protobuf.StringValue base_ad_group = 18; + google.protobuf.StringValue base_ad_group = 18 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; // The URL template for constructing a tracking URL. google.protobuf.StringValue tracking_url_template = 13; @@ -86,8 +102,13 @@ message AdGroup { // `tracking_url_template`, `final_urls`, or `mobile_final_urls`. repeated google.ads.googleads.v2.common.CustomParameter url_custom_parameters = 6; - // The campaign to which the ad group belongs. - google.protobuf.StringValue campaign = 10; + // Immutable. The campaign to which the ad group belongs. + google.protobuf.StringValue campaign = 10 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; // The maximum CPC (cost-per-click) bid. google.protobuf.Int64Value cpc_bid_micros = 14; @@ -98,8 +119,8 @@ message AdGroup { // The target CPA (cost-per-acquisition). google.protobuf.Int64Value target_cpa_micros = 27; - // The CPV (cost-per-view) bid. - google.protobuf.Int64Value cpv_bid_micros = 17; + // Output only. The CPV (cost-per-view) bid. + google.protobuf.Int64Value cpv_bid_micros = 17 [(google.api.field_behavior) = OUTPUT_ONLY]; // Average amount in micros that the advertiser is willing to pay for every // thousand times the ad is shown. @@ -130,22 +151,27 @@ message AdGroup { // Setting for targeting related features. google.ads.googleads.v2.common.TargetingSetting targeting_setting = 25; - // The effective target CPA (cost-per-acquisition). + // Output only. The effective target CPA (cost-per-acquisition). // This field is read-only. - google.protobuf.Int64Value effective_target_cpa_micros = 28; + google.protobuf.Int64Value effective_target_cpa_micros = 28 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Source of the effective target CPA. + // Output only. Source of the effective target CPA. // This field is read-only. - google.ads.googleads.v2.enums.BiddingSourceEnum.BiddingSource effective_target_cpa_source = 29; + google.ads.googleads.v2.enums.BiddingSourceEnum.BiddingSource effective_target_cpa_source = 29 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The effective target ROAS (return-on-ad-spend). + // Output only. The effective target ROAS (return-on-ad-spend). // This field is read-only. - google.protobuf.DoubleValue effective_target_roas = 31; + google.protobuf.DoubleValue effective_target_roas = 31 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Source of the effective target ROAS. + // Output only. Source of the effective target ROAS. // This field is read-only. - google.ads.googleads.v2.enums.BiddingSourceEnum.BiddingSource effective_target_roas_source = 32; - - // The resource names of labels attached to this ad group. - repeated google.protobuf.StringValue labels = 33; + google.ads.googleads.v2.enums.BiddingSourceEnum.BiddingSource effective_target_roas_source = 32 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The resource names of labels attached to this ad group. + repeated google.protobuf.StringValue labels = 33 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupLabel" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_ad.proto b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_ad.proto index ff2a256e1..cd63541d7 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_ad.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_ad.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -23,6 +22,8 @@ import "google/ads/googleads/v2/enums/ad_strength.proto"; import "google/ads/googleads/v2/enums/policy_approval_status.proto"; import "google/ads/googleads/v2/enums/policy_review_status.proto"; import "google/ads/googleads/v2/resources/ad.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -39,37 +40,52 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // An ad group ad. message AdGroupAd { - // The resource name of the ad. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupAd" + pattern: "customers/{customer}/adGroupAds/{ad_group_ad}" + }; + + // Immutable. The resource name of the ad. // Ad group ad resource names have the form: // // `customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAd" + } + ]; // The status of the ad. google.ads.googleads.v2.enums.AdGroupAdStatusEnum.AdGroupAdStatus status = 3; - // The ad group to which the ad belongs. - google.protobuf.StringValue ad_group = 4; + // Immutable. The ad group to which the ad belongs. + google.protobuf.StringValue ad_group = 4 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; - // The ad. - Ad ad = 5; + // Immutable. The ad. + Ad ad = 5 [(google.api.field_behavior) = IMMUTABLE]; - // Policy information for the ad. - AdGroupAdPolicySummary policy_summary = 6; + // Output only. Policy information for the ad. + AdGroupAdPolicySummary policy_summary = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Overall ad strength for this ad group ad. - google.ads.googleads.v2.enums.AdStrengthEnum.AdStrength ad_strength = 7; + // Output only. Overall ad strength for this ad group ad. + google.ads.googleads.v2.enums.AdStrengthEnum.AdStrength ad_strength = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Contains policy information for an ad. message AdGroupAdPolicySummary { - // The list of policy findings for this ad. - repeated google.ads.googleads.v2.common.PolicyTopicEntry policy_topic_entries = 1; + // Output only. The list of policy findings for this ad. + repeated google.ads.googleads.v2.common.PolicyTopicEntry policy_topic_entries = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Where in the review process this ad is. - google.ads.googleads.v2.enums.PolicyReviewStatusEnum.PolicyReviewStatus review_status = 2; + // Output only. Where in the review process this ad is. + google.ads.googleads.v2.enums.PolicyReviewStatusEnum.PolicyReviewStatus review_status = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The overall approval status of this ad, calculated based on the status of + // Output only. The overall approval status of this ad, calculated based on the status of // its individual policy topic entries. - google.ads.googleads.v2.enums.PolicyApprovalStatusEnum.PolicyApprovalStatus approval_status = 3; + google.ads.googleads.v2.enums.PolicyApprovalStatusEnum.PolicyApprovalStatus approval_status = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_ad_asset_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_ad_asset_view.proto index 88a772ce5..f6fc28fd0 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_ad_asset_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_ad_asset_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -22,6 +21,8 @@ import "google/ads/googleads/v2/enums/asset_field_type.proto"; import "google/ads/googleads/v2/enums/asset_performance_label.proto"; import "google/ads/googleads/v2/enums/policy_approval_status.proto"; import "google/ads/googleads/v2/enums/policy_review_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -38,37 +39,57 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A link between an AdGroupAd and an Asset. message AdGroupAdAssetView { - // The resource name of the ad group ad asset view. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupAdAssetView" + pattern: "customers/{customer}/adGroupAdAssets/{ad_group_ad_asset_view}" + }; + + // Output only. The resource name of the ad group ad asset view. // Ad group ad asset view resource names have the form: // // `customers/{customer_id}/adGroupAdAssets/{AdGroupAdAsset.ad_group_id}~{AdGroupAdAsset.ad.ad_id}~{AdGroupAdAsset.asset_id}~{AdGroupAdAsset.asset_field_type}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAdAssetView" + } + ]; - // The ad group ad to which the asset is linked. - google.protobuf.StringValue ad_group_ad = 5; + // Output only. The ad group ad to which the asset is linked. + google.protobuf.StringValue ad_group_ad = 5 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAd" + } + ]; - // The asset which is linked to the ad group ad. - google.protobuf.StringValue asset = 6; + // Output only. The asset which is linked to the ad group ad. + google.protobuf.StringValue asset = 6 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Asset" + } + ]; - // Role that the asset takes in the ad. - google.ads.googleads.v2.enums.AssetFieldTypeEnum.AssetFieldType field_type = 2; + // Output only. Role that the asset takes in the ad. + google.ads.googleads.v2.enums.AssetFieldTypeEnum.AssetFieldType field_type = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Policy information for the ad group ad asset. - AdGroupAdAssetPolicySummary policy_summary = 3; + // Output only. Policy information for the ad group ad asset. + AdGroupAdAssetPolicySummary policy_summary = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Performance of an asset linkage. - google.ads.googleads.v2.enums.AssetPerformanceLabelEnum.AssetPerformanceLabel performance_label = 4; + // Output only. Performance of an asset linkage. + google.ads.googleads.v2.enums.AssetPerformanceLabelEnum.AssetPerformanceLabel performance_label = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Contains policy information for an ad group ad asset. message AdGroupAdAssetPolicySummary { - // The list of policy findings for the ad group ad asset. - repeated google.ads.googleads.v2.common.PolicyTopicEntry policy_topic_entries = 1; + // Output only. The list of policy findings for the ad group ad asset. + repeated google.ads.googleads.v2.common.PolicyTopicEntry policy_topic_entries = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Where in the review process this ad group ad asset is. - google.ads.googleads.v2.enums.PolicyReviewStatusEnum.PolicyReviewStatus review_status = 2; + // Output only. Where in the review process this ad group ad asset is. + google.ads.googleads.v2.enums.PolicyReviewStatusEnum.PolicyReviewStatus review_status = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The overall approval status of this ad group ad asset, calculated based on + // Output only. The overall approval status of this ad group ad asset, calculated based on // the status of its individual policy topic entries. - google.ads.googleads.v2.enums.PolicyApprovalStatusEnum.PolicyApprovalStatus approval_status = 3; + google.ads.googleads.v2.enums.PolicyApprovalStatusEnum.PolicyApprovalStatus approval_status = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_ad_label.proto b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_ad_label.proto index fe7640ab1..9f8928fbf 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_ad_label.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_ad_label.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -33,14 +34,34 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A relationship between an ad group ad and a label. message AdGroupAdLabel { - // The resource name of the ad group ad label. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupAdLabel" + pattern: "customers/{customer}/adGroupAdLabels/{ad_group_ad_label}" + }; + + // Immutable. The resource name of the ad group ad label. // Ad group ad label resource names have the form: // `customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAdLabel" + } + ]; - // The ad group ad to which the label is attached. - google.protobuf.StringValue ad_group_ad = 2; + // Immutable. The ad group ad to which the label is attached. + google.protobuf.StringValue ad_group_ad = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAd" + } + ]; - // The label assigned to the ad group ad. - google.protobuf.StringValue label = 3; + // Immutable. The label assigned to the ad group ad. + google.protobuf.StringValue label = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Label" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_audience_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_audience_view.proto index 78adb1b1e..34b8b7826 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_audience_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_audience_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Resources"; @@ -35,9 +36,19 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // Network and YouTube Network ads, and remarketing lists for search ads (RLSA), // aggregated at the audience level. message AdGroupAudienceView { - // The resource name of the ad group audience view. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupAudienceView" + pattern: "customers/{customer}/adGroupAudienceViews/{ad_group_audience_view}" + }; + + // Output only. The resource name of the ad group audience view. // Ad group audience view resource names have the form: // // `customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAudienceView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_bid_modifier.proto b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_bid_modifier.proto index 8565356ae..b547e8c4a 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_bid_modifier.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_bid_modifier.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/common/criteria.proto"; import "google/ads/googleads/v2/enums/bid_modifier_source.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -35,53 +36,73 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // Represents an ad group bid modifier. message AdGroupBidModifier { - // The resource name of the ad group bid modifier. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupBidModifier" + pattern: "customers/{customer}/adGroupBidModifiers/{ad_group_bid_modifier}" + }; + + // Immutable. The resource name of the ad group bid modifier. // Ad group bid modifier resource names have the form: // // `customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}` - string resource_name = 1; - - // The ad group to which this criterion belongs. - google.protobuf.StringValue ad_group = 2; - - // The ID of the criterion to bid modify. + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupBidModifier" + } + ]; + + // Immutable. The ad group to which this criterion belongs. + google.protobuf.StringValue ad_group = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; + + // Output only. The ID of the criterion to bid modify. // // This field is ignored for mutates. - google.protobuf.Int64Value criterion_id = 3; + google.protobuf.Int64Value criterion_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // The modifier for the bid when the criterion matches. The modifier must be // in the range: 0.1 - 10.0. The range is 1.0 - 6.0 for PreferredContent. // Use 0 to opt out of a Device type. google.protobuf.DoubleValue bid_modifier = 4; - // The base ad group from which this draft/trial adgroup bid modifier was + // Output only. The base ad group from which this draft/trial adgroup bid modifier was // created. If ad_group is a base ad group then this field will be equal to // ad_group. If the ad group was created in the draft or trial and has no // corresponding base ad group, then this field will be null. // This field is readonly. - google.protobuf.StringValue base_ad_group = 9; + google.protobuf.StringValue base_ad_group = 9 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; - // Bid modifier source. - google.ads.googleads.v2.enums.BidModifierSourceEnum.BidModifierSource bid_modifier_source = 10; + // Output only. Bid modifier source. + google.ads.googleads.v2.enums.BidModifierSourceEnum.BidModifierSource bid_modifier_source = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; // The criterion of this ad group bid modifier. oneof criterion { - // Criterion for hotel date selection (default dates vs. user selected). - google.ads.googleads.v2.common.HotelDateSelectionTypeInfo hotel_date_selection_type = 5; + // Immutable. Criterion for hotel date selection (default dates vs. user selected). + google.ads.googleads.v2.common.HotelDateSelectionTypeInfo hotel_date_selection_type = 5 [(google.api.field_behavior) = IMMUTABLE]; - // Criterion for number of days prior to the stay the booking is being made. - google.ads.googleads.v2.common.HotelAdvanceBookingWindowInfo hotel_advance_booking_window = 6; + // Immutable. Criterion for number of days prior to the stay the booking is being made. + google.ads.googleads.v2.common.HotelAdvanceBookingWindowInfo hotel_advance_booking_window = 6 [(google.api.field_behavior) = IMMUTABLE]; - // Criterion for length of hotel stay in nights. - google.ads.googleads.v2.common.HotelLengthOfStayInfo hotel_length_of_stay = 7; + // Immutable. Criterion for length of hotel stay in nights. + google.ads.googleads.v2.common.HotelLengthOfStayInfo hotel_length_of_stay = 7 [(google.api.field_behavior) = IMMUTABLE]; - // Criterion for day of the week the booking is for. - google.ads.googleads.v2.common.HotelCheckInDayInfo hotel_check_in_day = 8; + // Immutable. Criterion for day of the week the booking is for. + google.ads.googleads.v2.common.HotelCheckInDayInfo hotel_check_in_day = 8 [(google.api.field_behavior) = IMMUTABLE]; - // A device criterion. - google.ads.googleads.v2.common.DeviceInfo device = 11; + // Immutable. A device criterion. + google.ads.googleads.v2.common.DeviceInfo device = 11 [(google.api.field_behavior) = IMMUTABLE]; - // A preferred content criterion. - google.ads.googleads.v2.common.PreferredContentInfo preferred_content = 12; + // Immutable. A preferred content criterion. + google.ads.googleads.v2.common.PreferredContentInfo preferred_content = 12 [(google.api.field_behavior) = IMMUTABLE]; } } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_criterion.proto b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_criterion.proto index b839cfb45..c9bb36601 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_criterion.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_criterion.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -25,6 +24,8 @@ import "google/ads/googleads/v2/enums/bidding_source.proto"; import "google/ads/googleads/v2/enums/criterion_system_serving_status.proto"; import "google/ads/googleads/v2/enums/criterion_type.proto"; import "google/ads/googleads/v2/enums/quality_score_bucket.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -41,81 +42,96 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // An ad group criterion. message AdGroupCriterion { + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupCriterion" + pattern: "customers/{customer}/adGroupCriteria/{ad_group_criterion}" + }; + // A container for ad group criterion quality information. message QualityInfo { - // The quality score. + // Output only. The quality score. // // This field may not be populated if Google does not have enough // information to determine a value. - google.protobuf.Int32Value quality_score = 1; + google.protobuf.Int32Value quality_score = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The performance of the ad compared to other advertisers. - google.ads.googleads.v2.enums.QualityScoreBucketEnum.QualityScoreBucket creative_quality_score = 2; + // Output only. The performance of the ad compared to other advertisers. + google.ads.googleads.v2.enums.QualityScoreBucketEnum.QualityScoreBucket creative_quality_score = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The quality score of the landing page. - google.ads.googleads.v2.enums.QualityScoreBucketEnum.QualityScoreBucket post_click_quality_score = 3; + // Output only. The quality score of the landing page. + google.ads.googleads.v2.enums.QualityScoreBucketEnum.QualityScoreBucket post_click_quality_score = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The click-through rate compared to that of other advertisers. - google.ads.googleads.v2.enums.QualityScoreBucketEnum.QualityScoreBucket search_predicted_ctr = 4; + // Output only. The click-through rate compared to that of other advertisers. + google.ads.googleads.v2.enums.QualityScoreBucketEnum.QualityScoreBucket search_predicted_ctr = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Estimates for criterion bids at various positions. message PositionEstimates { - // The estimate of the CPC bid required for ad to be shown on first + // Output only. The estimate of the CPC bid required for ad to be shown on first // page of search results. - google.protobuf.Int64Value first_page_cpc_micros = 1; + google.protobuf.Int64Value first_page_cpc_micros = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The estimate of the CPC bid required for ad to be displayed in first + // Output only. The estimate of the CPC bid required for ad to be displayed in first // position, at the top of the first page of search results. - google.protobuf.Int64Value first_position_cpc_micros = 2; + google.protobuf.Int64Value first_position_cpc_micros = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The estimate of the CPC bid required for ad to be displayed at the top + // Output only. The estimate of the CPC bid required for ad to be displayed at the top // of the first page of search results. - google.protobuf.Int64Value top_of_page_cpc_micros = 3; + google.protobuf.Int64Value top_of_page_cpc_micros = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Estimate of how many clicks per week you might get by changing your + // Output only. Estimate of how many clicks per week you might get by changing your // keyword bid to the value in first_position_cpc_micros. - google.protobuf.Int64Value estimated_add_clicks_at_first_position_cpc = 4; + google.protobuf.Int64Value estimated_add_clicks_at_first_position_cpc = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Estimate of how your cost per week might change when changing your + // Output only. Estimate of how your cost per week might change when changing your // keyword bid to the value in first_position_cpc_micros. - google.protobuf.Int64Value estimated_add_cost_at_first_position_cpc = 5; + google.protobuf.Int64Value estimated_add_cost_at_first_position_cpc = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; } - // The resource name of the ad group criterion. + // Immutable. The resource name of the ad group criterion. // Ad group criterion resource names have the form: // // `customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}` - string resource_name = 1; - - // The ID of the criterion. + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterion" + } + ]; + + // Output only. The ID of the criterion. // // This field is ignored for mutates. - google.protobuf.Int64Value criterion_id = 26; + google.protobuf.Int64Value criterion_id = 26 [(google.api.field_behavior) = OUTPUT_ONLY]; // The status of the criterion. google.ads.googleads.v2.enums.AdGroupCriterionStatusEnum.AdGroupCriterionStatus status = 3; - // Information regarding the quality of the criterion. - QualityInfo quality_info = 4; + // Output only. Information regarding the quality of the criterion. + QualityInfo quality_info = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The ad group to which the criterion belongs. - google.protobuf.StringValue ad_group = 5; + // Immutable. The ad group to which the criterion belongs. + google.protobuf.StringValue ad_group = 5 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; - // The type of the criterion. - google.ads.googleads.v2.enums.CriterionTypeEnum.CriterionType type = 25; + // Output only. The type of the criterion. + google.ads.googleads.v2.enums.CriterionTypeEnum.CriterionType type = 25 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Whether to target (`false`) or exclude (`true`) the criterion. + // Immutable. Whether to target (`false`) or exclude (`true`) the criterion. // // This field is immutable. To switch a criterion from positive to negative, // remove then re-add it. - google.protobuf.BoolValue negative = 31; + google.protobuf.BoolValue negative = 31 [(google.api.field_behavior) = IMMUTABLE]; - // Serving status of the criterion. - google.ads.googleads.v2.enums.CriterionSystemServingStatusEnum.CriterionSystemServingStatus system_serving_status = 52; + // Output only. Serving status of the criterion. + google.ads.googleads.v2.enums.CriterionSystemServingStatusEnum.CriterionSystemServingStatus system_serving_status = 52 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Approval status of the criterion. - google.ads.googleads.v2.enums.AdGroupCriterionApprovalStatusEnum.AdGroupCriterionApprovalStatus approval_status = 53; + // Output only. Approval status of the criterion. + google.ads.googleads.v2.enums.AdGroupCriterionApprovalStatusEnum.AdGroupCriterionApprovalStatus approval_status = 53 [(google.api.field_behavior) = OUTPUT_ONLY]; // The modifier for the bid when the criterion matches. The modifier must be // in the range: 0.1 - 10.0. Most targetable criteria types support modifiers. @@ -135,32 +151,32 @@ message AdGroupCriterion { // value stored here is 1,000,000 * [fraction]. google.protobuf.Int64Value percent_cpc_bid_micros = 33; - // The effective CPC (cost-per-click) bid. - google.protobuf.Int64Value effective_cpc_bid_micros = 18; + // Output only. The effective CPC (cost-per-click) bid. + google.protobuf.Int64Value effective_cpc_bid_micros = 18 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The effective CPM (cost-per-thousand viewable impressions) bid. - google.protobuf.Int64Value effective_cpm_bid_micros = 19; + // Output only. The effective CPM (cost-per-thousand viewable impressions) bid. + google.protobuf.Int64Value effective_cpm_bid_micros = 19 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The effective CPV (cost-per-view) bid. - google.protobuf.Int64Value effective_cpv_bid_micros = 20; + // Output only. The effective CPV (cost-per-view) bid. + google.protobuf.Int64Value effective_cpv_bid_micros = 20 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The effective Percent CPC bid amount. - google.protobuf.Int64Value effective_percent_cpc_bid_micros = 34; + // Output only. The effective Percent CPC bid amount. + google.protobuf.Int64Value effective_percent_cpc_bid_micros = 34 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Source of the effective CPC bid. - google.ads.googleads.v2.enums.BiddingSourceEnum.BiddingSource effective_cpc_bid_source = 21; + // Output only. Source of the effective CPC bid. + google.ads.googleads.v2.enums.BiddingSourceEnum.BiddingSource effective_cpc_bid_source = 21 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Source of the effective CPM bid. - google.ads.googleads.v2.enums.BiddingSourceEnum.BiddingSource effective_cpm_bid_source = 22; + // Output only. Source of the effective CPM bid. + google.ads.googleads.v2.enums.BiddingSourceEnum.BiddingSource effective_cpm_bid_source = 22 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Source of the effective CPV bid. - google.ads.googleads.v2.enums.BiddingSourceEnum.BiddingSource effective_cpv_bid_source = 23; + // Output only. Source of the effective CPV bid. + google.ads.googleads.v2.enums.BiddingSourceEnum.BiddingSource effective_cpv_bid_source = 23 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Source of the effective Percent CPC bid. - google.ads.googleads.v2.enums.BiddingSourceEnum.BiddingSource effective_percent_cpc_bid_source = 35; + // Output only. Source of the effective Percent CPC bid. + google.ads.googleads.v2.enums.BiddingSourceEnum.BiddingSource effective_percent_cpc_bid_source = 35 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Estimates for criterion bids at various positions. - PositionEstimates position_estimates = 10; + // Output only. Estimates for criterion bids at various positions. + PositionEstimates position_estimates = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; // The list of possible final URLs after all cross-domain redirects for the // ad. @@ -183,58 +199,58 @@ message AdGroupCriterion { // // Exactly one must be set. oneof criterion { - // Keyword. - google.ads.googleads.v2.common.KeywordInfo keyword = 27; + // Immutable. Keyword. + google.ads.googleads.v2.common.KeywordInfo keyword = 27 [(google.api.field_behavior) = IMMUTABLE]; - // Placement. - google.ads.googleads.v2.common.PlacementInfo placement = 28; + // Immutable. Placement. + google.ads.googleads.v2.common.PlacementInfo placement = 28 [(google.api.field_behavior) = IMMUTABLE]; - // Mobile app category. - google.ads.googleads.v2.common.MobileAppCategoryInfo mobile_app_category = 29; + // Immutable. Mobile app category. + google.ads.googleads.v2.common.MobileAppCategoryInfo mobile_app_category = 29 [(google.api.field_behavior) = IMMUTABLE]; - // Mobile application. - google.ads.googleads.v2.common.MobileApplicationInfo mobile_application = 30; + // Immutable. Mobile application. + google.ads.googleads.v2.common.MobileApplicationInfo mobile_application = 30 [(google.api.field_behavior) = IMMUTABLE]; - // Listing group. - google.ads.googleads.v2.common.ListingGroupInfo listing_group = 32; + // Immutable. Listing group. + google.ads.googleads.v2.common.ListingGroupInfo listing_group = 32 [(google.api.field_behavior) = IMMUTABLE]; - // Age range. - google.ads.googleads.v2.common.AgeRangeInfo age_range = 36; + // Immutable. Age range. + google.ads.googleads.v2.common.AgeRangeInfo age_range = 36 [(google.api.field_behavior) = IMMUTABLE]; - // Gender. - google.ads.googleads.v2.common.GenderInfo gender = 37; + // Immutable. Gender. + google.ads.googleads.v2.common.GenderInfo gender = 37 [(google.api.field_behavior) = IMMUTABLE]; - // Income range. - google.ads.googleads.v2.common.IncomeRangeInfo income_range = 38; + // Immutable. Income range. + google.ads.googleads.v2.common.IncomeRangeInfo income_range = 38 [(google.api.field_behavior) = IMMUTABLE]; - // Parental status. - google.ads.googleads.v2.common.ParentalStatusInfo parental_status = 39; + // Immutable. Parental status. + google.ads.googleads.v2.common.ParentalStatusInfo parental_status = 39 [(google.api.field_behavior) = IMMUTABLE]; - // User List. - google.ads.googleads.v2.common.UserListInfo user_list = 42; + // Immutable. User List. + google.ads.googleads.v2.common.UserListInfo user_list = 42 [(google.api.field_behavior) = IMMUTABLE]; - // YouTube Video. - google.ads.googleads.v2.common.YouTubeVideoInfo youtube_video = 40; + // Immutable. YouTube Video. + google.ads.googleads.v2.common.YouTubeVideoInfo youtube_video = 40 [(google.api.field_behavior) = IMMUTABLE]; - // YouTube Channel. - google.ads.googleads.v2.common.YouTubeChannelInfo youtube_channel = 41; + // Immutable. YouTube Channel. + google.ads.googleads.v2.common.YouTubeChannelInfo youtube_channel = 41 [(google.api.field_behavior) = IMMUTABLE]; - // Topic. - google.ads.googleads.v2.common.TopicInfo topic = 43; + // Immutable. Topic. + google.ads.googleads.v2.common.TopicInfo topic = 43 [(google.api.field_behavior) = IMMUTABLE]; - // User Interest. - google.ads.googleads.v2.common.UserInterestInfo user_interest = 45; + // Immutable. User Interest. + google.ads.googleads.v2.common.UserInterestInfo user_interest = 45 [(google.api.field_behavior) = IMMUTABLE]; - // Webpage - google.ads.googleads.v2.common.WebpageInfo webpage = 46; + // Immutable. Webpage + google.ads.googleads.v2.common.WebpageInfo webpage = 46 [(google.api.field_behavior) = IMMUTABLE]; - // App Payment Model. - google.ads.googleads.v2.common.AppPaymentModelInfo app_payment_model = 47; + // Immutable. App Payment Model. + google.ads.googleads.v2.common.AppPaymentModelInfo app_payment_model = 47 [(google.api.field_behavior) = IMMUTABLE]; - // Custom Affinity. - google.ads.googleads.v2.common.CustomAffinityInfo custom_affinity = 48; + // Immutable. Custom Affinity. + google.ads.googleads.v2.common.CustomAffinityInfo custom_affinity = 48 [(google.api.field_behavior) = IMMUTABLE]; - // Custom Intent. - google.ads.googleads.v2.common.CustomIntentInfo custom_intent = 49; + // Immutable. Custom Intent. + google.ads.googleads.v2.common.CustomIntentInfo custom_intent = 49 [(google.api.field_behavior) = IMMUTABLE]; } } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_criterion_label.proto b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_criterion_label.proto index 25f65231c..f343dd74b 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_criterion_label.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_criterion_label.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -33,14 +34,34 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A relationship between an ad group criterion and a label. message AdGroupCriterionLabel { - // The resource name of the ad group criterion label. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupCriterionLabel" + pattern: "customers/{customer}/adGroupCriterionLabels/{ad_group_criterion_label}" + }; + + // Immutable. The resource name of the ad group criterion label. // Ad group criterion label resource names have the form: // `customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterionLabel" + } + ]; - // The ad group criterion to which the label is attached. - google.protobuf.StringValue ad_group_criterion = 2; + // Immutable. The ad group criterion to which the label is attached. + google.protobuf.StringValue ad_group_criterion = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterion" + } + ]; - // The label assigned to the ad group criterion. - google.protobuf.StringValue label = 3; + // Immutable. The label assigned to the ad group criterion. + google.protobuf.StringValue label = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Label" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_criterion_simulation.proto b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_criterion_simulation.proto index 4cf32d5e2..f9c8cabfc 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_criterion_simulation.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_criterion_simulation.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/common/simulation.proto"; import "google/ads/googleads/v2/enums/simulation_modification_method.proto"; import "google/ads/googleads/v2/enums/simulation_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -38,37 +39,47 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // channel type, criterion type, simulation type, and simulation modification // method are detailed below respectively. // -// DISPLAY KEYWORD CPC_BID UNIFORM -// SEARCH KEYWORD CPC_BID UNIFORM -// SHOPPING LISTING_GROUP CPC_BID UNIFORM +// 1. DISPLAY - KEYWORD - CPC_BID - UNIFORM +// 2. SEARCH - KEYWORD - CPC_BID - UNIFORM +// 3. SHOPPING - LISTING_GROUP - CPC_BID - UNIFORM message AdGroupCriterionSimulation { - // The resource name of the ad group criterion simulation. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupCriterionSimulation" + pattern: "customers/{customer}/adGroupCriterionSimulations/{ad_group_criterion_simulation}" + }; + + // Output only. The resource name of the ad group criterion simulation. // Ad group criterion simulation resource names have the form: // // `customers/{customer_id}/adGroupCriterionSimulations/{ad_group_id}~{criterion_id}~{type}~{modification_method}~{start_date}~{end_date}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterionSimulation" + } + ]; - // AdGroup ID of the simulation. - google.protobuf.Int64Value ad_group_id = 2; + // Output only. AdGroup ID of the simulation. + google.protobuf.Int64Value ad_group_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Criterion ID of the simulation. - google.protobuf.Int64Value criterion_id = 3; + // Output only. Criterion ID of the simulation. + google.protobuf.Int64Value criterion_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The field that the simulation modifies. - google.ads.googleads.v2.enums.SimulationTypeEnum.SimulationType type = 4; + // Output only. The field that the simulation modifies. + google.ads.googleads.v2.enums.SimulationTypeEnum.SimulationType type = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // How the simulation modifies the field. - google.ads.googleads.v2.enums.SimulationModificationMethodEnum.SimulationModificationMethod modification_method = 5; + // Output only. How the simulation modifies the field. + google.ads.googleads.v2.enums.SimulationModificationMethodEnum.SimulationModificationMethod modification_method = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // First day on which the simulation is based, in YYYY-MM-DD format. - google.protobuf.StringValue start_date = 6; + // Output only. First day on which the simulation is based, in YYYY-MM-DD format. + google.protobuf.StringValue start_date = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Last day on which the simulation is based, in YYYY-MM-DD format. - google.protobuf.StringValue end_date = 7; + // Output only. Last day on which the simulation is based, in YYYY-MM-DD format. + google.protobuf.StringValue end_date = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; // List of simulation points. oneof point_list { - // Simulation points if the simulation type is CPC_BID. - google.ads.googleads.v2.common.CpcBidSimulationPointList cpc_bid_point_list = 8; + // Output only. Simulation points if the simulation type is CPC_BID. + google.ads.googleads.v2.common.CpcBidSimulationPointList cpc_bid_point_list = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; } } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_extension_setting.proto b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_extension_setting.proto index f1244580a..cb2d5d9cc 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_extension_setting.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_extension_setting.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/extension_setting_device.proto"; import "google/ads/googleads/v2/enums/extension_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -35,27 +36,44 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // An ad group extension setting. message AdGroupExtensionSetting { - // The resource name of the ad group extension setting. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupExtensionSetting" + pattern: "customers/{customer}/adGroupExtensionSettings/{ad_group_extension_setting}" + }; + + // Immutable. The resource name of the ad group extension setting. // AdGroupExtensionSetting resource names have the form: // // `customers/{customer_id}/adGroupExtensionSettings/{ad_group_id}~{extension_type}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupExtensionSetting" + } + ]; - // The extension type of the ad group extension setting. - google.ads.googleads.v2.enums.ExtensionTypeEnum.ExtensionType extension_type = 2; + // Immutable. The extension type of the ad group extension setting. + google.ads.googleads.v2.enums.ExtensionTypeEnum.ExtensionType extension_type = 2 [(google.api.field_behavior) = IMMUTABLE]; - // The resource name of the ad group. The linked extension feed items will + // Immutable. The resource name of the ad group. The linked extension feed items will // serve under this ad group. // AdGroup resource names have the form: // // `customers/{customer_id}/adGroups/{ad_group_id}` - google.protobuf.StringValue ad_group = 3; + google.protobuf.StringValue ad_group = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; // The resource names of the extension feed items to serve under the ad group. // ExtensionFeedItem resource names have the form: // // `customers/{customer_id}/extensionFeedItems/{feed_item_id}` - repeated google.protobuf.StringValue extension_feed_items = 4; + repeated google.protobuf.StringValue extension_feed_items = 4 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/ExtensionFeedItem" + }]; // The device for which the extensions will serve. Optional. google.ads.googleads.v2.enums.ExtensionSettingDeviceEnum.ExtensionSettingDevice device = 5; diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_feed.proto b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_feed.proto index 9d7692c92..2820d5d97 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_feed.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_feed.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/common/matching_function.proto"; import "google/ads/googleads/v2/enums/feed_link_status.proto"; import "google/ads/googleads/v2/enums/placeholder_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -36,17 +37,37 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // An ad group feed. message AdGroupFeed { - // The resource name of the ad group feed. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupFeed" + pattern: "customers/{customer}/adGroupFeeds/{ad_group_feed}" + }; + + // Immutable. The resource name of the ad group feed. // Ad group feed resource names have the form: // // `customers/{customer_id}/adGroupFeeds/{ad_group_id}~{feed_id} - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupFeed" + } + ]; - // The feed being linked to the ad group. - google.protobuf.StringValue feed = 2; + // Immutable. The feed being linked to the ad group. + google.protobuf.StringValue feed = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; - // The ad group being linked to the feed. - google.protobuf.StringValue ad_group = 3; + // Immutable. The ad group being linked to the feed. + google.protobuf.StringValue ad_group = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; // Indicates which placeholder types the feed may populate under the connected // ad group. Required. @@ -57,7 +78,7 @@ message AdGroupFeed { // Required. google.ads.googleads.v2.common.MatchingFunction matching_function = 5; - // Status of the ad group feed. + // Output only. Status of the ad group feed. // This field is read-only. - google.ads.googleads.v2.enums.FeedLinkStatusEnum.FeedLinkStatus status = 6; + google.ads.googleads.v2.enums.FeedLinkStatusEnum.FeedLinkStatus status = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_label.proto b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_label.proto index 7595e9643..818648824 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_label.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_label.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -33,14 +34,34 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A relationship between an ad group and a label. message AdGroupLabel { - // The resource name of the ad group label. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupLabel" + pattern: "customers/{customer}/adGroupLabels/{ad_group_label}" + }; + + // Immutable. The resource name of the ad group label. // Ad group label resource names have the form: // `customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupLabel" + } + ]; - // The ad group to which the label is attached. - google.protobuf.StringValue ad_group = 2; + // Immutable. The ad group to which the label is attached. + google.protobuf.StringValue ad_group = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; - // The label assigned to the ad group. - google.protobuf.StringValue label = 3; + // Immutable. The label assigned to the ad group. + google.protobuf.StringValue label = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Label" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_simulation.proto b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_simulation.proto index af4b9e884..c4cee7b16 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_simulation.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/ad_group_simulation.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/common/simulation.proto"; import "google/ads/googleads/v2/enums/simulation_modification_method.proto"; import "google/ads/googleads/v2/enums/simulation_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -38,45 +39,55 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // channel type, simulation type and simulation modification method is // detailed below respectively. // -// SEARCH CPC_BID DEFAULT -// SEARCH CPC_BID UNIFORM -// SEARCH TARGET_CPA UNIFORM -// DISPLAY CPC_BID DEFAULT -// DISPLAY CPC_BID UNIFORM -// DISPLAY TARGET_CPA UNIFORM -// VIDEO CPV_BID DEFAULT -// VIDEO CPV_BID UNIFORM +// 1. SEARCH - CPC_BID - DEFAULT +// 2. SEARCH - CPC_BID - UNIFORM +// 3. SEARCH - TARGET_CPA - UNIFORM +// 4. DISPLAY - CPC_BID - DEFAULT +// 5. DISPLAY - CPC_BID - UNIFORM +// 6. DISPLAY - TARGET_CPA - UNIFORM +// 7. VIDEO - CPV_BID - DEFAULT +// 8. VIDEO - CPV_BID - UNIFORM message AdGroupSimulation { - // The resource name of the ad group simulation. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupSimulation" + pattern: "customers/{customer}/adGroupSimulations/{ad_group_simulation}" + }; + + // Output only. The resource name of the ad group simulation. // Ad group simulation resource names have the form: // // `customers/{customer_id}/adGroupSimulations/{ad_group_id}~{type}~{modification_method}~{start_date}~{end_date}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupSimulation" + } + ]; - // Ad group id of the simulation. - google.protobuf.Int64Value ad_group_id = 2; + // Output only. Ad group id of the simulation. + google.protobuf.Int64Value ad_group_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The field that the simulation modifies. - google.ads.googleads.v2.enums.SimulationTypeEnum.SimulationType type = 3; + // Output only. The field that the simulation modifies. + google.ads.googleads.v2.enums.SimulationTypeEnum.SimulationType type = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // How the simulation modifies the field. - google.ads.googleads.v2.enums.SimulationModificationMethodEnum.SimulationModificationMethod modification_method = 4; + // Output only. How the simulation modifies the field. + google.ads.googleads.v2.enums.SimulationModificationMethodEnum.SimulationModificationMethod modification_method = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // First day on which the simulation is based, in YYYY-MM-DD format. - google.protobuf.StringValue start_date = 5; + // Output only. First day on which the simulation is based, in YYYY-MM-DD format. + google.protobuf.StringValue start_date = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Last day on which the simulation is based, in YYYY-MM-DD format - google.protobuf.StringValue end_date = 6; + // Output only. Last day on which the simulation is based, in YYYY-MM-DD format + google.protobuf.StringValue end_date = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; // List of simulation points. oneof point_list { - // Simulation points if the simulation type is CPC_BID. - google.ads.googleads.v2.common.CpcBidSimulationPointList cpc_bid_point_list = 8; + // Output only. Simulation points if the simulation type is CPC_BID. + google.ads.googleads.v2.common.CpcBidSimulationPointList cpc_bid_point_list = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Simulation points if the simulation type is CPV_BID. - google.ads.googleads.v2.common.CpvBidSimulationPointList cpv_bid_point_list = 10; + // Output only. Simulation points if the simulation type is CPV_BID. + google.ads.googleads.v2.common.CpvBidSimulationPointList cpv_bid_point_list = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Simulation points if the simulation type is TARGET_CPA. - google.ads.googleads.v2.common.TargetCpaSimulationPointList target_cpa_point_list = 9; + // Output only. Simulation points if the simulation type is TARGET_CPA. + google.ads.googleads.v2.common.TargetCpaSimulationPointList target_cpa_point_list = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; } } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/ad_parameter.proto b/third_party/googleapis/google/ads/googleads/v2/resources/ad_parameter.proto index 4f11cfb8d..d0c7297ae 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/ad_parameter.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/ad_parameter.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -38,17 +39,32 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // In the ad the parameters are referenced by a placeholder of the form // "{param#:value}". E.g. "{param1:$17}" message AdParameter { - // The resource name of the ad parameter. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdParameter" + pattern: "customers/{customer}/adParameters/{ad_parameter}" + }; + + // Immutable. The resource name of the ad parameter. // Ad parameter resource names have the form: // // `customers/{customer_id}/adParameters/{ad_group_id}~{criterion_id}~{parameter_index}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdParameter" + } + ]; - // The ad group criterion that this ad parameter belongs to. - google.protobuf.StringValue ad_group_criterion = 2; + // Immutable. The ad group criterion that this ad parameter belongs to. + google.protobuf.StringValue ad_group_criterion = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterion" + } + ]; - // The unique index of this ad parameter. Must be either 1 or 2. - google.protobuf.Int64Value parameter_index = 3; + // Immutable. The unique index of this ad parameter. Must be either 1 or 2. + google.protobuf.Int64Value parameter_index = 3 [(google.api.field_behavior) = IMMUTABLE]; // Numeric value to insert into the ad text. The following restrictions // apply: diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/ad_schedule_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/ad_schedule_view.proto index 618c96106..79dc8b2cb 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/ad_schedule_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/ad_schedule_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Resources"; @@ -33,9 +34,19 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // An ad schedule view summarizes the performance of campaigns by // AdSchedule criteria. message AdScheduleView { - // The resource name of the ad schedule view. + option (google.api.resource) = { + type: "googleads.googleapis.com/AdScheduleView" + pattern: "customers/{customer}/adScheduleViews/{ad_schedule_view}" + }; + + // Output only. The resource name of the ad schedule view. // AdSchedule view resource names have the form: // // `customers/{customer_id}/adScheduleViews/{campaign_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdScheduleView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/age_range_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/age_range_view.proto index 5f1c1b405..1f28a9e2f 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/age_range_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/age_range_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Resources"; @@ -32,9 +33,19 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // An age range view. message AgeRangeView { - // The resource name of the age range view. + option (google.api.resource) = { + type: "googleads.googleapis.com/AgeRangeView" + pattern: "customers/{customer}/ageRangeViews/{age_range_view}" + }; + + // Output only. The resource name of the age range view. // Age range view resource names have the form: // // `customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AgeRangeView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/asset.proto b/third_party/googleapis/google/ads/googleads/v2/resources/asset.proto index fc473ce3c..48cdbe291 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/asset.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/asset.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/common/asset_types.proto"; import "google/ads/googleads/v2/enums/asset_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -36,33 +37,43 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // Asset is a part of an ad which can be shared across multiple ads. // It can be an image (ImageAsset), a video (YoutubeVideoAsset), etc. message Asset { - // The resource name of the asset. + option (google.api.resource) = { + type: "googleads.googleapis.com/Asset" + pattern: "customers/{customer}/assets/{asset}" + }; + + // Immutable. The resource name of the asset. // Asset resource names have the form: // // `customers/{customer_id}/assets/{asset_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Asset" + } + ]; - // The ID of the asset. - google.protobuf.Int64Value id = 2; + // Output only. The ID of the asset. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; // Optional name of the asset. google.protobuf.StringValue name = 3; - // Type of the asset. - google.ads.googleads.v2.enums.AssetTypeEnum.AssetType type = 4; + // Output only. Type of the asset. + google.ads.googleads.v2.enums.AssetTypeEnum.AssetType type = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; // The specific type of the asset. oneof asset_data { - // A YouTube video asset. - google.ads.googleads.v2.common.YoutubeVideoAsset youtube_video_asset = 5; + // Immutable. A YouTube video asset. + google.ads.googleads.v2.common.YoutubeVideoAsset youtube_video_asset = 5 [(google.api.field_behavior) = IMMUTABLE]; - // A media bundle asset. - google.ads.googleads.v2.common.MediaBundleAsset media_bundle_asset = 6; + // Immutable. A media bundle asset. + google.ads.googleads.v2.common.MediaBundleAsset media_bundle_asset = 6 [(google.api.field_behavior) = IMMUTABLE]; - // An image asset. - google.ads.googleads.v2.common.ImageAsset image_asset = 7; + // Output only. An image asset. + google.ads.googleads.v2.common.ImageAsset image_asset = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; - // A text asset. - google.ads.googleads.v2.common.TextAsset text_asset = 8; + // Output only. A text asset. + google.ads.googleads.v2.common.TextAsset text_asset = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; } } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/bidding_strategy.proto b/third_party/googleapis/google/ads/googleads/v2/resources/bidding_strategy.proto index 1c3cf33a8..3e7281535 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/bidding_strategy.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/bidding_strategy.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/common/bidding.proto"; import "google/ads/googleads/v2/enums/bidding_strategy_status.proto"; import "google/ads/googleads/v2/enums/bidding_strategy_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -36,14 +37,24 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A bidding strategy. message BiddingStrategy { - // The resource name of the bidding strategy. + option (google.api.resource) = { + type: "googleads.googleapis.com/BiddingStrategy" + pattern: "customers/{customer}/biddingStrategies/{bidding_strategy}" + }; + + // Immutable. The resource name of the bidding strategy. // Bidding strategy resource names have the form: // // `customers/{customer_id}/biddingStrategies/{bidding_strategy_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/BiddingStrategy" + } + ]; - // The ID of the bidding strategy. - google.protobuf.Int64Value id = 3; + // Output only. The ID of the bidding strategy. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // The name of the bidding strategy. // All bidding strategies within an account must be named distinctly. @@ -52,26 +63,26 @@ message BiddingStrategy { // in UTF-8 bytes, (trimmed). google.protobuf.StringValue name = 4; - // The status of the bidding strategy. + // Output only. The status of the bidding strategy. // // This field is read-only. - google.ads.googleads.v2.enums.BiddingStrategyStatusEnum.BiddingStrategyStatus status = 15; + google.ads.googleads.v2.enums.BiddingStrategyStatusEnum.BiddingStrategyStatus status = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The type of the bidding strategy. + // Output only. The type of the bidding strategy. // Create a bidding strategy by setting the bidding scheme. // // This field is read-only. - google.ads.googleads.v2.enums.BiddingStrategyTypeEnum.BiddingStrategyType type = 5; + google.ads.googleads.v2.enums.BiddingStrategyTypeEnum.BiddingStrategyType type = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The number of campaigns attached to this bidding strategy. + // Output only. The number of campaigns attached to this bidding strategy. // // This field is read-only. - google.protobuf.Int64Value campaign_count = 13; + google.protobuf.Int64Value campaign_count = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The number of non-removed campaigns attached to this bidding strategy. + // Output only. The number of non-removed campaigns attached to this bidding strategy. // // This field is read-only. - google.protobuf.Int64Value non_removed_campaign_count = 14; + google.protobuf.Int64Value non_removed_campaign_count = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; // The bidding scheme. // diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/billing_setup.proto b/third_party/googleapis/google/ads/googleads/v2/resources/billing_setup.proto index 15d1c3843..f8ab981a5 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/billing_setup.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/billing_setup.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/billing_setup_status.proto"; import "google/ads/googleads/v2/enums/time_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -33,68 +34,82 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // Proto file describing the BillingSetup resource. -// A billing setup across Ads and Payments systems; an association between a -// Payments account and an advertiser. A billing setup is specific to one -// advertiser. +// A billing setup, which associates a payments account and an advertiser. A +// billing setup is specific to one advertiser. message BillingSetup { - // Container of Payments account information for this billing. + option (google.api.resource) = { + type: "googleads.googleapis.com/BillingSetup" + pattern: "customers/{customer}/billingSetups/{billing_setup}" + }; + + // Container of payments account information for this billing. message PaymentsAccountInfo { - // A 16 digit id used to identify the Payments account associated with the + // Output only. A 16 digit id used to identify the payments account associated with the // billing setup. // // This must be passed as a string with dashes, e.g. "1234-5678-9012-3456". - google.protobuf.StringValue payments_account_id = 1; + google.protobuf.StringValue payments_account_id = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The name of the Payments account associated with the billing setup. + // Immutable. The name of the payments account associated with the billing setup. // - // This enables the user to specify a meaningful name for a Payments account + // This enables the user to specify a meaningful name for a payments account // to aid in reconciling monthly invoices. // // This name will be printed in the monthly invoices. - google.protobuf.StringValue payments_account_name = 2; + google.protobuf.StringValue payments_account_name = 2 [(google.api.field_behavior) = IMMUTABLE]; - // A 12 digit id used to identify the Payments profile associated with the + // Immutable. A 12 digit id used to identify the payments profile associated with the // billing setup. // // This must be passed in as a string with dashes, e.g. "1234-5678-9012". - google.protobuf.StringValue payments_profile_id = 3; + google.protobuf.StringValue payments_profile_id = 3 [(google.api.field_behavior) = IMMUTABLE]; - // The name of the Payments profile associated with the billing setup. - google.protobuf.StringValue payments_profile_name = 4; + // Output only. The name of the payments profile associated with the billing setup. + google.protobuf.StringValue payments_profile_name = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // A secondary payments profile id present in uncommon situations, e.g. + // Output only. A secondary payments profile id present in uncommon situations, e.g. // when a sequential liability agreement has been arranged. - google.protobuf.StringValue secondary_payments_profile_id = 5; + google.protobuf.StringValue secondary_payments_profile_id = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; } - // The resource name of the billing setup. + // Immutable. The resource name of the billing setup. // BillingSetup resource names have the form: // // `customers/{customer_id}/billingSetups/{billing_setup_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/BillingSetup" + } + ]; - // The ID of the billing setup. - google.protobuf.Int64Value id = 2; + // Output only. The ID of the billing setup. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The status of the billing setup. - google.ads.googleads.v2.enums.BillingSetupStatusEnum.BillingSetupStatus status = 3; + // Output only. The status of the billing setup. + google.ads.googleads.v2.enums.BillingSetupStatusEnum.BillingSetupStatus status = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The resource name of the Payments account associated with this billing + // Immutable. The resource name of the payments account associated with this billing // setup. Payments resource names have the form: // // `customers/{customer_id}/paymentsAccounts/{payments_account_id}` - // When setting up billing, this is used to signup with an existing Payments + // When setting up billing, this is used to signup with an existing payments // account (and then payments_account_info should not be set). // When getting a billing setup, this and payments_account_info will be // populated. - google.protobuf.StringValue payments_account = 11; - - // The Payments account information associated with this billing setup. - // When setting up billing, this is used to signup with a new Payments account + google.protobuf.StringValue payments_account = 11 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/PaymentsAccount" + } + ]; + + // Immutable. The payments account information associated with this billing setup. + // When setting up billing, this is used to signup with a new payments account // (and then payments_account should not be set). // When getting a billing setup, this and payments_account will be // populated. - PaymentsAccountInfo payments_account_info = 12; + PaymentsAccountInfo payments_account_info = 12 [(google.api.field_behavior) = IMMUTABLE]; // When creating a new billing setup, this is when the setup should take // effect. NOW is the only acceptable start time if the customer doesn't have @@ -104,21 +119,21 @@ message BillingSetup { // However, if the setup was approved (see status) after the requested start // time, then this is the approval time. oneof start_time { - // The start date time in yyyy-MM-dd or yyyy-MM-dd HH:mm:ss format. Only a + // Immutable. The start date time in yyyy-MM-dd or yyyy-MM-dd HH:mm:ss format. Only a // future time is allowed. - google.protobuf.StringValue start_date_time = 9; + google.protobuf.StringValue start_date_time = 9 [(google.api.field_behavior) = IMMUTABLE]; - // The start time as a type. Only NOW is allowed. - google.ads.googleads.v2.enums.TimeTypeEnum.TimeType start_time_type = 10; + // Immutable. The start time as a type. Only NOW is allowed. + google.ads.googleads.v2.enums.TimeTypeEnum.TimeType start_time_type = 10 [(google.api.field_behavior) = IMMUTABLE]; } // When the billing setup ends / ended. This is either FOREVER or the start // time of the next scheduled billing setup. oneof end_time { - // The end date time in yyyy-MM-dd or yyyy-MM-dd HH:mm:ss format. - google.protobuf.StringValue end_date_time = 13; + // Output only. The end date time in yyyy-MM-dd or yyyy-MM-dd HH:mm:ss format. + google.protobuf.StringValue end_date_time = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The end time as a type. The only possible value is FOREVER. - google.ads.googleads.v2.enums.TimeTypeEnum.TimeType end_time_type = 14; + // Output only. The end time as a type. The only possible value is FOREVER. + google.ads.googleads.v2.enums.TimeTypeEnum.TimeType end_time_type = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; } } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/campaign.proto b/third_party/googleapis/google/ads/googleads/v2/resources/campaign.proto index e42a01aaa..4d3287cc4 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/campaign.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/campaign.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -37,6 +36,8 @@ import "google/ads/googleads/v2/enums/payment_mode.proto"; import "google/ads/googleads/v2/enums/positive_geo_target_type.proto"; import "google/ads/googleads/v2/enums/vanity_pharma_display_url_mode.proto"; import "google/ads/googleads/v2/enums/vanity_pharma_text.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -53,6 +54,11 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A campaign. message Campaign { + option (google.api.resource) = { + type: "googleads.googleapis.com/Campaign" + pattern: "customers/{customer}/campaigns/{campaign}" + }; + // The network settings for the campaign. message NetworkSettings { // Whether ads will be served with google.com search results. @@ -73,8 +79,18 @@ message Campaign { // Campaign-level settings for hotel ads. message HotelSettingInfo { - // The linked Hotel Center account. - google.protobuf.Int64Value hotel_center_id = 1; + // Immutable. The linked Hotel Center account. + google.protobuf.Int64Value hotel_center_id = 1 [(google.api.field_behavior) = IMMUTABLE]; + } + + // Describes how unbranded pharma ads will be displayed. + message VanityPharma { + // The display mode for vanity pharma URLs. + google.ads.googleads.v2.enums.VanityPharmaDisplayUrlModeEnum.VanityPharmaDisplayUrlMode vanity_pharma_display_url_mode = 1; + + // The text that will be displayed in display URL of the text ad when + // website description is the selected display mode for vanity pharma URLs. + google.ads.googleads.v2.enums.VanityPharmaTextEnum.VanityPharmaText vanity_pharma_text = 2; } // The setting for controlling Dynamic Search Ads (DSA). @@ -89,24 +105,38 @@ message Campaign { // Whether the campaign uses advertiser supplied URLs exclusively. google.protobuf.BoolValue use_supplied_urls_only = 3; - // The list of page feeds associated with the campaign. - repeated google.protobuf.StringValue feeds = 5; + // Output only. The list of page feeds associated with the campaign. + repeated google.protobuf.StringValue feeds = 5 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; + } + + // Selective optimization setting for this campaign, which includes a set of + // conversion actions to optimize this campaign towards. + message SelectiveOptimization { + // The selected set of conversion actions for optimizing this campaign. + repeated google.protobuf.StringValue conversion_actions = 1 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/ConversionAction" + }]; } // The setting for Shopping campaigns. Defines the universe of products that // can be advertised by the campaign, and how this campaign interacts with // other Shopping campaigns. message ShoppingSetting { - // ID of the Merchant Center account. + // Immutable. ID of the Merchant Center account. // This field is required for create operations. This field is immutable for // Shopping campaigns. - google.protobuf.Int64Value merchant_id = 1; + google.protobuf.Int64Value merchant_id = 1 [(google.api.field_behavior) = IMMUTABLE]; - // Sales country of products to include in the campaign. + // Immutable. Sales country of products to include in the campaign. // This field is required for Shopping campaigns. This field is immutable. // This field is optional for non-Shopping campaigns, but it must be equal // to 'ZZ' if set. - google.protobuf.StringValue sales_country = 2; + google.protobuf.StringValue sales_country = 2 [(google.api.field_behavior) = IMMUTABLE]; // Priority of the campaign. Campaigns with numerically higher priorities // take precedence over those with lower priorities. @@ -120,59 +150,47 @@ message Campaign { google.protobuf.BoolValue enable_local = 4; } - // Campaign level settings for tracking information. + // Campaign-level settings for tracking information. message TrackingSetting { - // The url used for dynamic tracking. - google.protobuf.StringValue tracking_url = 1; - } - - // Represents a collection of settings related to ads geotargeting. - message GeoTargetTypeSetting { - // The setting used for positive geotargeting in this particular campaign. - google.ads.googleads.v2.enums.PositiveGeoTargetTypeEnum.PositiveGeoTargetType positive_geo_target_type = 1; - - // The setting used for negative geotargeting in this particular campaign. - google.ads.googleads.v2.enums.NegativeGeoTargetTypeEnum.NegativeGeoTargetType negative_geo_target_type = 2; - } - - // Selective optimization setting for this campaign, which includes a set of - // conversion actions to optimize this campaign towards. - message SelectiveOptimization { - // The selected set of conversion actions for optimizing this campaign. - repeated google.protobuf.StringValue conversion_actions = 1; + // Output only. The url used for dynamic tracking. + google.protobuf.StringValue tracking_url = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; } - // Campaign level settings for App Campaigns. + // Campaign-level settings for App Campaigns. message AppCampaignSetting { // Represents the goal which the bidding strategy of this app campaign // should optimize towards. google.ads.googleads.v2.enums.AppCampaignBiddingStrategyGoalTypeEnum.AppCampaignBiddingStrategyGoalType bidding_strategy_goal_type = 1; - // A string that uniquely identifies a mobile application. - google.protobuf.StringValue app_id = 2; + // Immutable. A string that uniquely identifies a mobile application. + google.protobuf.StringValue app_id = 2 [(google.api.field_behavior) = IMMUTABLE]; - // The application store that distributes this specific app. - google.ads.googleads.v2.enums.AppCampaignAppStoreEnum.AppCampaignAppStore app_store = 3; + // Immutable. The application store that distributes this specific app. + google.ads.googleads.v2.enums.AppCampaignAppStoreEnum.AppCampaignAppStore app_store = 3 [(google.api.field_behavior) = IMMUTABLE]; } - // Describes how unbranded pharma ads will be displayed. - message VanityPharma { - // The display mode for vanity pharma URLs. - google.ads.googleads.v2.enums.VanityPharmaDisplayUrlModeEnum.VanityPharmaDisplayUrlMode vanity_pharma_display_url_mode = 1; + // Represents a collection of settings related to ads geotargeting. + message GeoTargetTypeSetting { + // The setting used for positive geotargeting in this particular campaign. + google.ads.googleads.v2.enums.PositiveGeoTargetTypeEnum.PositiveGeoTargetType positive_geo_target_type = 1; - // The text that will be displayed in display URL of the text ad when - // website description is the selected display mode for vanity pharma URLs. - google.ads.googleads.v2.enums.VanityPharmaTextEnum.VanityPharmaText vanity_pharma_text = 2; + // The setting used for negative geotargeting in this particular campaign. + google.ads.googleads.v2.enums.NegativeGeoTargetTypeEnum.NegativeGeoTargetType negative_geo_target_type = 2; } - // The resource name of the campaign. + // Immutable. The resource name of the campaign. // Campaign resource names have the form: // // `customers/{customer_id}/campaigns/{campaign_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; - // The ID of the campaign. - google.protobuf.Int64Value id = 3; + // Output only. The ID of the campaign. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // The name of the campaign. // @@ -188,13 +206,13 @@ message Campaign { // When a new campaign is added, the status defaults to ENABLED. google.ads.googleads.v2.enums.CampaignStatusEnum.CampaignStatus status = 5; - // The ad serving status of the campaign. - google.ads.googleads.v2.enums.CampaignServingStatusEnum.CampaignServingStatus serving_status = 21; + // Output only. The ad serving status of the campaign. + google.ads.googleads.v2.enums.CampaignServingStatusEnum.CampaignServingStatus serving_status = 21 [(google.api.field_behavior) = OUTPUT_ONLY]; // The ad serving optimization status of the campaign. google.ads.googleads.v2.enums.AdServingOptimizationStatusEnum.AdServingOptimizationStatus ad_serving_optimization_status = 8; - // The primary serving target for ads within the campaign. + // Immutable. The primary serving target for ads within the campaign. // The targeting options can be refined in `network_settings`. // // This field is required and should not be empty when creating new @@ -202,14 +220,14 @@ message Campaign { // // Can be set only when creating campaigns. // After the campaign is created, the field can not be changed. - google.ads.googleads.v2.enums.AdvertisingChannelTypeEnum.AdvertisingChannelType advertising_channel_type = 9; + google.ads.googleads.v2.enums.AdvertisingChannelTypeEnum.AdvertisingChannelType advertising_channel_type = 9 [(google.api.field_behavior) = IMMUTABLE]; - // Optional refinement to `advertising_channel_type`. + // Immutable. Optional refinement to `advertising_channel_type`. // Must be a valid sub-type of the parent channel type. // // Can be set only when creating campaigns. // After campaign is created, the field can not be changed. - google.ads.googleads.v2.enums.AdvertisingChannelSubTypeEnum.AdvertisingChannelSubType advertising_channel_sub_type = 10; + google.ads.googleads.v2.enums.AdvertisingChannelSubTypeEnum.AdvertisingChannelSubType advertising_channel_sub_type = 10 [(google.api.field_behavior) = IMMUTABLE]; // The URL template for constructing a tracking URL. google.protobuf.StringValue tracking_url_template = 11; @@ -225,8 +243,8 @@ message Campaign { // The network settings for the campaign. NetworkSettings network_settings = 14; - // The hotel setting for the campaign. - HotelSettingInfo hotel_setting = 32; + // Immutable. The hotel setting for the campaign. + HotelSettingInfo hotel_setting = 32 [(google.api.field_behavior) = IMMUTABLE]; // The setting for controlling Dynamic Search Ads (DSA). DynamicSearchAdsSetting dynamic_search_ads_setting = 33; @@ -243,29 +261,41 @@ message Campaign { // The setting related to App Campaign. AppCampaignSetting app_campaign_setting = 51; - // The resource names of labels attached to this campaign. - repeated google.protobuf.StringValue labels = 53; + // Output only. The resource names of labels attached to this campaign. + repeated google.protobuf.StringValue labels = 53 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignLabel" + } + ]; - // The type of campaign: normal, draft, or experiment. - google.ads.googleads.v2.enums.CampaignExperimentTypeEnum.CampaignExperimentType experiment_type = 17; + // Output only. The type of campaign: normal, draft, or experiment. + google.ads.googleads.v2.enums.CampaignExperimentTypeEnum.CampaignExperimentType experiment_type = 17 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The resource name of the base campaign of a draft or experiment campaign. + // Output only. The resource name of the base campaign of a draft or experiment campaign. // For base campaigns, this is equal to `resource_name`. // // This field is read-only. - google.protobuf.StringValue base_campaign = 28; + google.protobuf.StringValue base_campaign = 28 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; // The budget of the campaign. - google.protobuf.StringValue campaign_budget = 6; + google.protobuf.StringValue campaign_budget = 6 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignBudget" + }]; - // The type of bidding strategy. + // Output only. The type of bidding strategy. // // A bidding strategy can be created by setting either the bidding scheme to // create a standard bidding strategy or the `bidding_strategy` field to // create a portfolio bidding strategy. // // This field is read-only. - google.ads.googleads.v2.enums.BiddingStrategyTypeEnum.BiddingStrategyType bidding_strategy_type = 22; + google.ads.googleads.v2.enums.BiddingStrategyTypeEnum.BiddingStrategyType bidding_strategy_type = 22 [(google.api.field_behavior) = OUTPUT_ONLY]; // The date when campaign started. // @@ -284,8 +314,8 @@ message Campaign { // A list that limits how often each user will see this campaign's ads. repeated google.ads.googleads.v2.common.FrequencyCapEntry frequency_caps = 40; - // 3-Tier Brand Safety setting for the campaign. - google.ads.googleads.v2.enums.BrandSafetySuitabilityEnum.BrandSafetySuitability video_brand_safety_suitability = 42; + // Output only. 3-Tier Brand Safety setting for the campaign. + google.ads.googleads.v2.enums.BrandSafetySuitabilityEnum.BrandSafetySuitability video_brand_safety_suitability = 42 [(google.api.field_behavior) = OUTPUT_ONLY]; // Describes how unbranded pharma ads will be displayed. VanityPharma vanity_pharma = 44; @@ -294,8 +324,8 @@ message Campaign { // conversion actions to optimize this campaign towards. SelectiveOptimization selective_optimization = 45; - // Campaign level settings for tracking information. - TrackingSetting tracking_setting = 46; + // Output only. Campaign-level settings for tracking information. + TrackingSetting tracking_setting = 46 [(google.api.field_behavior) = OUTPUT_ONLY]; // Payment mode for the campaign. google.ads.googleads.v2.enums.PaymentModeEnum.PaymentMode payment_mode = 52; @@ -306,7 +336,9 @@ message Campaign { // standard, that is embedded into the campaign. oneof campaign_bidding_strategy { // Portfolio bidding strategy used by campaign. - google.protobuf.StringValue bidding_strategy = 23; + google.protobuf.StringValue bidding_strategy = 23 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/BiddingStrategy" + }]; // Commission is an automatic bidding strategy in which the advertiser pays // a certain portion of the conversion value. @@ -321,8 +353,8 @@ message Campaign { // impressions. google.ads.googleads.v2.common.ManualCpm manual_cpm = 25; - // A bidding strategy that pays a configurable amount per video view. - google.ads.googleads.v2.common.ManualCpv manual_cpv = 37; + // Output only. A bidding strategy that pays a configurable amount per video view. + google.ads.googleads.v2.common.ManualCpv manual_cpv = 37 [(google.api.field_behavior) = OUTPUT_ONLY]; // Standard Maximize Conversions bidding strategy that automatically // maximizes number of conversions given a daily budget. diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/campaign_audience_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/campaign_audience_view.proto index 9950d5d9f..175c2abef 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/campaign_audience_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/campaign_audience_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Resources"; @@ -36,9 +37,19 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // aggregated by campaign and audience criterion. This view only includes // audiences attached at the campaign level. message CampaignAudienceView { - // The resource name of the campaign audience view. + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignAudienceView" + pattern: "customers/{customer}/campaignAudienceViews/{campaign_audience_view}" + }; + + // Output only. The resource name of the campaign audience view. // Campaign audience view resource names have the form: // // `customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignAudienceView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/campaign_bid_modifier.proto b/third_party/googleapis/google/ads/googleads/v2/resources/campaign_bid_modifier.proto index d12e8eda7..f0065c2a9 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/campaign_bid_modifier.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/campaign_bid_modifier.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/common/criteria.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -34,26 +35,41 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // Represents a bid-modifiable only criterion at the campaign level. message CampaignBidModifier { - // The resource name of the campaign bid modifier. + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignBidModifier" + pattern: "customers/{customer}/campaignBidModifiers/{campaign_bid_modifier}" + }; + + // Immutable. The resource name of the campaign bid modifier. // Campaign bid modifier resource names have the form: // // `customers/{customer_id}/campaignBidModifiers/{campaign_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignBidModifier" + } + ]; - // The campaign to which this criterion belongs. - google.protobuf.StringValue campaign = 2; + // Output only. The campaign to which this criterion belongs. + google.protobuf.StringValue campaign = 2 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; - // The ID of the criterion to bid modify. + // Output only. The ID of the criterion to bid modify. // // This field is ignored for mutates. - google.protobuf.Int64Value criterion_id = 3; + google.protobuf.Int64Value criterion_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // The modifier for the bid when the criterion matches. google.protobuf.DoubleValue bid_modifier = 4; // The criterion of this campaign bid modifier. oneof criterion { - // Criterion for interaction type. Only supported for search campaigns. - google.ads.googleads.v2.common.InteractionTypeInfo interaction_type = 5; + // Immutable. Criterion for interaction type. Only supported for search campaigns. + google.ads.googleads.v2.common.InteractionTypeInfo interaction_type = 5 [(google.api.field_behavior) = IMMUTABLE]; } } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/campaign_budget.proto b/third_party/googleapis/google/ads/googleads/v2/resources/campaign_budget.proto index 4a8725e75..e7e2d4130 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/campaign_budget.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/campaign_budget.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -21,6 +20,8 @@ import "google/ads/googleads/v2/enums/budget_delivery_method.proto"; import "google/ads/googleads/v2/enums/budget_period.proto"; import "google/ads/googleads/v2/enums/budget_status.proto"; import "google/ads/googleads/v2/enums/budget_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -37,19 +38,29 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A campaign budget. message CampaignBudget { - // The resource name of the campaign budget. + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignBudget" + pattern: "customers/{customer}/campaignBudgets/{campaign_budget}" + }; + + // Immutable. The resource name of the campaign budget. // Campaign budget resource names have the form: // // `customers/{customer_id}/campaignBudgets/{budget_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignBudget" + } + ]; - // The ID of the campaign budget. + // Output only. The ID of the campaign budget. // // A campaign budget is created using the CampaignBudgetService create // operation and is assigned a budget ID. A budget ID can be shared across // different campaigns; the system will then allocate the campaign budget // among different campaigns to get optimum results. - google.protobuf.Int64Value id = 3; + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // The name of the campaign budget. // @@ -72,8 +83,8 @@ message CampaignBudget { // currency unit. google.protobuf.Int64Value total_amount_micros = 10; - // The status of this campaign budget. This field is read-only. - google.ads.googleads.v2.enums.BudgetStatusEnum.BudgetStatus status = 6; + // Output only. The status of this campaign budget. This field is read-only. + google.ads.googleads.v2.enums.BudgetStatusEnum.BudgetStatus status = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; // The delivery method that determines the rate at which the campaign budget // is spent. @@ -98,49 +109,49 @@ message CampaignBudget { // A shared campaign budget can never become non-shared. google.protobuf.BoolValue explicitly_shared = 8; - // The number of campaigns actively using the budget. + // Output only. The number of campaigns actively using the budget. // // This field is read-only. - google.protobuf.Int64Value reference_count = 9; + google.protobuf.Int64Value reference_count = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Indicates whether there is a recommended budget for this campaign budget. + // Output only. Indicates whether there is a recommended budget for this campaign budget. // // This field is read-only. - google.protobuf.BoolValue has_recommended_budget = 11; + google.protobuf.BoolValue has_recommended_budget = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The recommended budget amount. If no recommendation is available, this will + // Output only. The recommended budget amount. If no recommendation is available, this will // be set to the budget amount. // Amount is specified in micros, where one million is equivalent to one // currency unit. // // This field is read-only. - google.protobuf.Int64Value recommended_budget_amount_micros = 12; + google.protobuf.Int64Value recommended_budget_amount_micros = 12 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Period over which to spend the budget. Defaults to DAILY if not specified. - google.ads.googleads.v2.enums.BudgetPeriodEnum.BudgetPeriod period = 13; + // Immutable. Period over which to spend the budget. Defaults to DAILY if not specified. + google.ads.googleads.v2.enums.BudgetPeriodEnum.BudgetPeriod period = 13 [(google.api.field_behavior) = IMMUTABLE]; - // The estimated change in weekly clicks if the recommended budget is applied. + // Output only. The estimated change in weekly clicks if the recommended budget is applied. // // This field is read-only. - google.protobuf.Int64Value recommended_budget_estimated_change_weekly_clicks = 14; + google.protobuf.Int64Value recommended_budget_estimated_change_weekly_clicks = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The estimated change in weekly cost in micros if the recommended budget is + // Output only. The estimated change in weekly cost in micros if the recommended budget is // applied. One million is equivalent to one currency unit. // // This field is read-only. - google.protobuf.Int64Value recommended_budget_estimated_change_weekly_cost_micros = 15; + google.protobuf.Int64Value recommended_budget_estimated_change_weekly_cost_micros = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The estimated change in weekly interactions if the recommended budget is + // Output only. The estimated change in weekly interactions if the recommended budget is // applied. // // This field is read-only. - google.protobuf.Int64Value recommended_budget_estimated_change_weekly_interactions = 16; + google.protobuf.Int64Value recommended_budget_estimated_change_weekly_interactions = 16 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The estimated change in weekly views if the recommended budget is applied. + // Output only. The estimated change in weekly views if the recommended budget is applied. // // This field is read-only. - google.protobuf.Int64Value recommended_budget_estimated_change_weekly_views = 17; + google.protobuf.Int64Value recommended_budget_estimated_change_weekly_views = 17 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The type of the campaign budget. - google.ads.googleads.v2.enums.BudgetTypeEnum.BudgetType type = 18; + // Immutable. The type of the campaign budget. + google.ads.googleads.v2.enums.BudgetTypeEnum.BudgetType type = 18 [(google.api.field_behavior) = IMMUTABLE]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/campaign_criterion.proto b/third_party/googleapis/google/ads/googleads/v2/resources/campaign_criterion.proto index f1f34ea4e..83ac21881 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/campaign_criterion.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/campaign_criterion.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/common/criteria.proto"; import "google/ads/googleads/v2/enums/campaign_criterion_status.proto"; import "google/ads/googleads/v2/enums/criterion_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -36,30 +37,45 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A campaign criterion. message CampaignCriterion { - // The resource name of the campaign criterion. + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignCriterion" + pattern: "customers/{customer}/campaignCriteria/{campaign_criterion}" + }; + + // Immutable. The resource name of the campaign criterion. // Campaign criterion resource names have the form: // // `customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}` - string resource_name = 1; - - // The campaign to which the criterion belongs. - google.protobuf.StringValue campaign = 4; - - // The ID of the criterion. + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignCriterion" + } + ]; + + // Immutable. The campaign to which the criterion belongs. + google.protobuf.StringValue campaign = 4 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; + + // Output only. The ID of the criterion. // // This field is ignored during mutate. - google.protobuf.Int64Value criterion_id = 5; + google.protobuf.Int64Value criterion_id = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; // The modifier for the bids when the criterion matches. The modifier must be // in the range: 0.1 - 10.0. Most targetable criteria types support modifiers. // Use 0 to opt out of a Device type. google.protobuf.FloatValue bid_modifier = 14; - // Whether to target (`false`) or exclude (`true`) the criterion. - google.protobuf.BoolValue negative = 7; + // Immutable. Whether to target (`false`) or exclude (`true`) the criterion. + google.protobuf.BoolValue negative = 7 [(google.api.field_behavior) = IMMUTABLE]; - // The type of the criterion. - google.ads.googleads.v2.enums.CriterionTypeEnum.CriterionType type = 6; + // Output only. The type of the criterion. + google.ads.googleads.v2.enums.CriterionTypeEnum.CriterionType type = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; // The status of the criterion. google.ads.googleads.v2.enums.CampaignCriterionStatusEnum.CampaignCriterionStatus status = 35; @@ -68,82 +84,85 @@ message CampaignCriterion { // // Exactly one must be set. oneof criterion { - // Keyword. - google.ads.googleads.v2.common.KeywordInfo keyword = 8; + // Immutable. Keyword. + google.ads.googleads.v2.common.KeywordInfo keyword = 8 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Placement. + google.ads.googleads.v2.common.PlacementInfo placement = 9 [(google.api.field_behavior) = IMMUTABLE]; - // Placement. - google.ads.googleads.v2.common.PlacementInfo placement = 9; + // Immutable. Mobile app category. + google.ads.googleads.v2.common.MobileAppCategoryInfo mobile_app_category = 10 [(google.api.field_behavior) = IMMUTABLE]; - // Mobile app category. - google.ads.googleads.v2.common.MobileAppCategoryInfo mobile_app_category = 10; + // Immutable. Mobile application. + google.ads.googleads.v2.common.MobileApplicationInfo mobile_application = 11 [(google.api.field_behavior) = IMMUTABLE]; - // Mobile application. - google.ads.googleads.v2.common.MobileApplicationInfo mobile_application = 11; + // Immutable. Location. + google.ads.googleads.v2.common.LocationInfo location = 12 [(google.api.field_behavior) = IMMUTABLE]; - // Location. - google.ads.googleads.v2.common.LocationInfo location = 12; + // Immutable. Device. + google.ads.googleads.v2.common.DeviceInfo device = 13 [(google.api.field_behavior) = IMMUTABLE]; - // Device. - google.ads.googleads.v2.common.DeviceInfo device = 13; + // Immutable. Ad Schedule. + google.ads.googleads.v2.common.AdScheduleInfo ad_schedule = 15 [(google.api.field_behavior) = IMMUTABLE]; - // Ad Schedule. - google.ads.googleads.v2.common.AdScheduleInfo ad_schedule = 15; + // Immutable. Age range. + google.ads.googleads.v2.common.AgeRangeInfo age_range = 16 [(google.api.field_behavior) = IMMUTABLE]; - // Age range. - google.ads.googleads.v2.common.AgeRangeInfo age_range = 16; + // Immutable. Gender. + google.ads.googleads.v2.common.GenderInfo gender = 17 [(google.api.field_behavior) = IMMUTABLE]; - // Gender. - google.ads.googleads.v2.common.GenderInfo gender = 17; + // Immutable. Income range. + google.ads.googleads.v2.common.IncomeRangeInfo income_range = 18 [(google.api.field_behavior) = IMMUTABLE]; - // Income range. - google.ads.googleads.v2.common.IncomeRangeInfo income_range = 18; + // Immutable. Parental status. + google.ads.googleads.v2.common.ParentalStatusInfo parental_status = 19 [(google.api.field_behavior) = IMMUTABLE]; - // Parental status. - google.ads.googleads.v2.common.ParentalStatusInfo parental_status = 19; + // Immutable. User List. + google.ads.googleads.v2.common.UserListInfo user_list = 22 [(google.api.field_behavior) = IMMUTABLE]; - // User List. - google.ads.googleads.v2.common.UserListInfo user_list = 22; + // Immutable. YouTube Video. + google.ads.googleads.v2.common.YouTubeVideoInfo youtube_video = 20 [(google.api.field_behavior) = IMMUTABLE]; - // YouTube Video. - google.ads.googleads.v2.common.YouTubeVideoInfo youtube_video = 20; + // Immutable. YouTube Channel. + google.ads.googleads.v2.common.YouTubeChannelInfo youtube_channel = 21 [(google.api.field_behavior) = IMMUTABLE]; - // YouTube Channel. - google.ads.googleads.v2.common.YouTubeChannelInfo youtube_channel = 21; + // Immutable. Proximity. + google.ads.googleads.v2.common.ProximityInfo proximity = 23 [(google.api.field_behavior) = IMMUTABLE]; - // Proximity. - google.ads.googleads.v2.common.ProximityInfo proximity = 23; + // Immutable. Topic. + google.ads.googleads.v2.common.TopicInfo topic = 24 [(google.api.field_behavior) = IMMUTABLE]; - // Topic. - google.ads.googleads.v2.common.TopicInfo topic = 24; + // Immutable. Listing scope. + google.ads.googleads.v2.common.ListingScopeInfo listing_scope = 25 [(google.api.field_behavior) = IMMUTABLE]; - // Listing scope. - google.ads.googleads.v2.common.ListingScopeInfo listing_scope = 25; + // Immutable. Language. + google.ads.googleads.v2.common.LanguageInfo language = 26 [(google.api.field_behavior) = IMMUTABLE]; - // Language. - google.ads.googleads.v2.common.LanguageInfo language = 26; + // Immutable. IpBlock. + google.ads.googleads.v2.common.IpBlockInfo ip_block = 27 [(google.api.field_behavior) = IMMUTABLE]; - // IpBlock. - google.ads.googleads.v2.common.IpBlockInfo ip_block = 27; + // Immutable. ContentLabel. + google.ads.googleads.v2.common.ContentLabelInfo content_label = 28 [(google.api.field_behavior) = IMMUTABLE]; - // ContentLabel. - google.ads.googleads.v2.common.ContentLabelInfo content_label = 28; + // Immutable. Carrier. + google.ads.googleads.v2.common.CarrierInfo carrier = 29 [(google.api.field_behavior) = IMMUTABLE]; - // Carrier. - google.ads.googleads.v2.common.CarrierInfo carrier = 29; + // Immutable. User Interest. + google.ads.googleads.v2.common.UserInterestInfo user_interest = 30 [(google.api.field_behavior) = IMMUTABLE]; - // User Interest. - google.ads.googleads.v2.common.UserInterestInfo user_interest = 30; + // Immutable. Webpage. + google.ads.googleads.v2.common.WebpageInfo webpage = 31 [(google.api.field_behavior) = IMMUTABLE]; - // Webpage. - google.ads.googleads.v2.common.WebpageInfo webpage = 31; + // Immutable. Operating system version. + google.ads.googleads.v2.common.OperatingSystemVersionInfo operating_system_version = 32 [(google.api.field_behavior) = IMMUTABLE]; - // Operating system version. - google.ads.googleads.v2.common.OperatingSystemVersionInfo operating_system_version = 32; + // Immutable. Mobile Device. + google.ads.googleads.v2.common.MobileDeviceInfo mobile_device = 33 [(google.api.field_behavior) = IMMUTABLE]; - // Mobile Device. - google.ads.googleads.v2.common.MobileDeviceInfo mobile_device = 33; + // Immutable. Location Group + google.ads.googleads.v2.common.LocationGroupInfo location_group = 34 [(google.api.field_behavior) = IMMUTABLE]; - // Location Group - google.ads.googleads.v2.common.LocationGroupInfo location_group = 34; + // Immutable. Custom Affinity. + google.ads.googleads.v2.common.CustomAffinityInfo custom_affinity = 36 [(google.api.field_behavior) = IMMUTABLE]; } } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/campaign_criterion_simulation.proto b/third_party/googleapis/google/ads/googleads/v2/resources/campaign_criterion_simulation.proto index f3cdcc3e5..293913297 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/campaign_criterion_simulation.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/campaign_criterion_simulation.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/common/simulation.proto"; import "google/ads/googleads/v2/enums/simulation_modification_method.proto"; import "google/ads/googleads/v2/enums/simulation_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -38,37 +39,47 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // channel type, criterion ids, simulation type and simulation modification // method is detailed below respectively. // -// SEARCH 30000,30001,30002 BID_MODIFIER UNIFORM -// SHOPPING 30000,30001,30002 BID_MODIFIER UNIFORM -// DISPLAY 30001 BID_MODIFIER UNIFORM +// 1. SEARCH - 30000,30001,30002 - BID_MODIFIER - UNIFORM +// 2. SHOPPING - 30000,30001,30002 - BID_MODIFIER - UNIFORM +// 3. DISPLAY - 30001 - BID_MODIFIER - UNIFORM message CampaignCriterionSimulation { - // The resource name of the campaign criterion simulation. + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignCriterionSimulation" + pattern: "customers/{customer}/campaignCriterionSimulations/{campaign_criterion_simulation}" + }; + + // Output only. The resource name of the campaign criterion simulation. // Campaign criterion simulation resource names have the form: // // `customers/{customer_id}/campaignCriterionSimulations/{campaign_id}~{criterion_id}~{type}~{modification_method}~{start_date}~{end_date}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignCriterionSimulation" + } + ]; - // Campaign ID of the simulation. - google.protobuf.Int64Value campaign_id = 2; + // Output only. Campaign ID of the simulation. + google.protobuf.Int64Value campaign_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Criterion ID of the simulation. - google.protobuf.Int64Value criterion_id = 3; + // Output only. Criterion ID of the simulation. + google.protobuf.Int64Value criterion_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The field that the simulation modifies. - google.ads.googleads.v2.enums.SimulationTypeEnum.SimulationType type = 4; + // Output only. The field that the simulation modifies. + google.ads.googleads.v2.enums.SimulationTypeEnum.SimulationType type = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // How the simulation modifies the field. - google.ads.googleads.v2.enums.SimulationModificationMethodEnum.SimulationModificationMethod modification_method = 5; + // Output only. How the simulation modifies the field. + google.ads.googleads.v2.enums.SimulationModificationMethodEnum.SimulationModificationMethod modification_method = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // First day on which the simulation is based, in YYYY-MM-DD format. - google.protobuf.StringValue start_date = 6; + // Output only. First day on which the simulation is based, in YYYY-MM-DD format. + google.protobuf.StringValue start_date = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Last day on which the simulation is based, in YYYY-MM-DD format. - google.protobuf.StringValue end_date = 7; + // Output only. Last day on which the simulation is based, in YYYY-MM-DD format. + google.protobuf.StringValue end_date = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; // List of simulation points. oneof point_list { - // Simulation points if the simulation type is BID_MODIFIER. - google.ads.googleads.v2.common.BidModifierSimulationPointList bid_modifier_point_list = 8; + // Output only. Simulation points if the simulation type is BID_MODIFIER. + google.ads.googleads.v2.common.BidModifierSimulationPointList bid_modifier_point_list = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; } } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/campaign_draft.proto b/third_party/googleapis/google/ads/googleads/v2/resources/campaign_draft.proto index f6b7f1de0..673acb14f 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/campaign_draft.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/campaign_draft.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/campaign_draft_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -34,19 +35,34 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A campaign draft. message CampaignDraft { - // The resource name of the campaign draft. + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignDraft" + pattern: "customers/{customer}/campaignDrafts/{campaign_draft}" + }; + + // Immutable. The resource name of the campaign draft. // Campaign draft resource names have the form: // // `customers/{customer_id}/campaignDrafts/{base_campaign_id}~{draft_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignDraft" + } + ]; - // The ID of the draft. + // Output only. The ID of the draft. // // This field is read-only. - google.protobuf.Int64Value draft_id = 2; + google.protobuf.Int64Value draft_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The base campaign to which the draft belongs. - google.protobuf.StringValue base_campaign = 3; + // Immutable. The base campaign to which the draft belongs. + google.protobuf.StringValue base_campaign = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; // The name of the campaign draft. // @@ -57,22 +73,27 @@ message CampaignDraft { // (code point 0xA) or carriage return (code point 0xD) characters. google.protobuf.StringValue name = 4; - // Resource name of the Campaign that results from overlaying the draft + // Output only. Resource name of the Campaign that results from overlaying the draft // changes onto the base campaign. // // This field is read-only. - google.protobuf.StringValue draft_campaign = 5; + google.protobuf.StringValue draft_campaign = 5 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; - // The status of the campaign draft. This field is read-only. + // Output only. The status of the campaign draft. This field is read-only. // // When a new campaign draft is added, the status defaults to PROPOSED. - google.ads.googleads.v2.enums.CampaignDraftStatusEnum.CampaignDraftStatus status = 6; + google.ads.googleads.v2.enums.CampaignDraftStatusEnum.CampaignDraftStatus status = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Whether there is an experiment based on this draft currently serving. - google.protobuf.BoolValue has_experiment_running = 7; + // Output only. Whether there is an experiment based on this draft currently serving. + google.protobuf.BoolValue has_experiment_running = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The resource name of the long-running operation that can be used to poll + // Output only. The resource name of the long-running operation that can be used to poll // for completion of draft promotion. This is only set if the draft promotion // is in progress or finished. - google.protobuf.StringValue long_running_operation = 8; + google.protobuf.StringValue long_running_operation = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/campaign_experiment.proto b/third_party/googleapis/google/ads/googleads/v2/resources/campaign_experiment.proto index ecf55d8a9..86f8ade12 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/campaign_experiment.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/campaign_experiment.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/campaign_experiment_status.proto"; import "google/ads/googleads/v2/enums/campaign_experiment_traffic_split_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -36,19 +37,34 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // An A/B experiment that compares the performance of the base campaign // (the control) and a variation of that campaign (the experiment). message CampaignExperiment { - // The resource name of the campaign experiment. + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignExperiment" + pattern: "customers/{customer}/campaignExperiments/{campaign_experiment}" + }; + + // Immutable. The resource name of the campaign experiment. // Campaign experiment resource names have the form: // // `customers/{customer_id}/campaignExperiments/{campaign_experiment_id}` - string resource_name = 1; - - // The ID of the campaign experiment. + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignExperiment" + } + ]; + + // Output only. The ID of the campaign experiment. // // This field is read-only. - google.protobuf.Int64Value id = 2; + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The campaign draft with staged changes to the base campaign. - google.protobuf.StringValue campaign_draft = 3; + // Immutable. The campaign draft with staged changes to the base campaign. + google.protobuf.StringValue campaign_draft = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignDraft" + } + ]; // The name of the campaign experiment. // @@ -63,24 +79,29 @@ message CampaignExperiment { // The description of the experiment. google.protobuf.StringValue description = 5; - // Share of traffic directed to experiment as a percent (must be between 1 and + // Immutable. Share of traffic directed to experiment as a percent (must be between 1 and // 99 inclusive. Base campaign receives the remainder of the traffic // (100 - traffic_split_percent). Required for create. - google.protobuf.Int64Value traffic_split_percent = 6; + google.protobuf.Int64Value traffic_split_percent = 6 [(google.api.field_behavior) = IMMUTABLE]; - // Determines the behavior of the traffic split. - google.ads.googleads.v2.enums.CampaignExperimentTrafficSplitTypeEnum.CampaignExperimentTrafficSplitType traffic_split_type = 7; + // Immutable. Determines the behavior of the traffic split. + google.ads.googleads.v2.enums.CampaignExperimentTrafficSplitTypeEnum.CampaignExperimentTrafficSplitType traffic_split_type = 7 [(google.api.field_behavior) = IMMUTABLE]; - // The experiment campaign, as opposed to the base campaign. - google.protobuf.StringValue experiment_campaign = 8; + // Output only. The experiment campaign, as opposed to the base campaign. + google.protobuf.StringValue experiment_campaign = 8 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; - // The status of the campaign experiment. This field is read-only. - google.ads.googleads.v2.enums.CampaignExperimentStatusEnum.CampaignExperimentStatus status = 9; + // Output only. The status of the campaign experiment. This field is read-only. + google.ads.googleads.v2.enums.CampaignExperimentStatusEnum.CampaignExperimentStatus status = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The resource name of the long-running operation that can be used to poll + // Output only. The resource name of the long-running operation that can be used to poll // for completion of experiment create or promote. The most recent long // running operation is returned. - google.protobuf.StringValue long_running_operation = 10; + google.protobuf.StringValue long_running_operation = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; // Date when the campaign experiment starts. By default, the experiment starts // now or on the campaign's start date, whichever is later. If this field is diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/campaign_extension_setting.proto b/third_party/googleapis/google/ads/googleads/v2/resources/campaign_extension_setting.proto index c497dffc1..233d04b17 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/campaign_extension_setting.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/campaign_extension_setting.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/extension_setting_device.proto"; import "google/ads/googleads/v2/enums/extension_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -35,27 +36,44 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A campaign extension setting. message CampaignExtensionSetting { - // The resource name of the campaign extension setting. + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignExtensionSetting" + pattern: "customers/{customer}/campaignExtensionSettings/{campaign_extension_setting}" + }; + + // Immutable. The resource name of the campaign extension setting. // CampaignExtensionSetting resource names have the form: // // `customers/{customer_id}/campaignExtensionSettings/{campaign_id}~{extension_type}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignExtensionSetting" + } + ]; - // The extension type of the customer extension setting. - google.ads.googleads.v2.enums.ExtensionTypeEnum.ExtensionType extension_type = 2; + // Immutable. The extension type of the customer extension setting. + google.ads.googleads.v2.enums.ExtensionTypeEnum.ExtensionType extension_type = 2 [(google.api.field_behavior) = IMMUTABLE]; - // The resource name of the campaign. The linked extension feed items will + // Immutable. The resource name of the campaign. The linked extension feed items will // serve under this campaign. // Campaign resource names have the form: // // `customers/{customer_id}/campaigns/{campaign_id}` - google.protobuf.StringValue campaign = 3; + google.protobuf.StringValue campaign = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; // The resource names of the extension feed items to serve under the campaign. // ExtensionFeedItem resource names have the form: // // `customers/{customer_id}/extensionFeedItems/{feed_item_id}` - repeated google.protobuf.StringValue extension_feed_items = 4; + repeated google.protobuf.StringValue extension_feed_items = 4 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/ExtensionFeedItem" + }]; // The device for which the extensions will serve. Optional. google.ads.googleads.v2.enums.ExtensionSettingDeviceEnum.ExtensionSettingDevice device = 5; diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/campaign_feed.proto b/third_party/googleapis/google/ads/googleads/v2/resources/campaign_feed.proto index d23594519..0f2d18c31 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/campaign_feed.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/campaign_feed.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/common/matching_function.proto"; import "google/ads/googleads/v2/enums/feed_link_status.proto"; import "google/ads/googleads/v2/enums/placeholder_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -36,17 +37,37 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A campaign feed. message CampaignFeed { - // The resource name of the campaign feed. + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignFeed" + pattern: "customers/{customer}/campaignFeeds/{campaign_feed}" + }; + + // Immutable. The resource name of the campaign feed. // Campaign feed resource names have the form: // // `customers/{customer_id}/campaignFeeds/{campaign_id}~{feed_id} - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignFeed" + } + ]; - // The feed to which the CampaignFeed belongs. - google.protobuf.StringValue feed = 2; + // Immutable. The feed to which the CampaignFeed belongs. + google.protobuf.StringValue feed = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; - // The campaign to which the CampaignFeed belongs. - google.protobuf.StringValue campaign = 3; + // Immutable. The campaign to which the CampaignFeed belongs. + google.protobuf.StringValue campaign = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; // Indicates which placeholder types the feed may populate under the connected // campaign. Required. @@ -57,7 +78,7 @@ message CampaignFeed { // Required. google.ads.googleads.v2.common.MatchingFunction matching_function = 5; - // Status of the campaign feed. + // Output only. Status of the campaign feed. // This field is read-only. - google.ads.googleads.v2.enums.FeedLinkStatusEnum.FeedLinkStatus status = 6; + google.ads.googleads.v2.enums.FeedLinkStatusEnum.FeedLinkStatus status = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/campaign_label.proto b/third_party/googleapis/google/ads/googleads/v2/resources/campaign_label.proto index f3b320e47..0470ab466 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/campaign_label.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/campaign_label.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -33,14 +34,34 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // Represents a relationship between a campaign and a label. message CampaignLabel { - // Name of the resource. + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignLabel" + pattern: "customers/{customer}/campaignLabels/{campaign_label}" + }; + + // Immutable. Name of the resource. // Campaign label resource names have the form: // `customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignLabel" + } + ]; - // The campaign to which the label is attached. - google.protobuf.StringValue campaign = 2; + // Immutable. The campaign to which the label is attached. + google.protobuf.StringValue campaign = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; - // The label assigned to the campaign. - google.protobuf.StringValue label = 3; + // Immutable. The label assigned to the campaign. + google.protobuf.StringValue label = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Label" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/campaign_shared_set.proto b/third_party/googleapis/google/ads/googleads/v2/resources/campaign_shared_set.proto index e1e0ece8e..51e88b0bf 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/campaign_shared_set.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/campaign_shared_set.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/campaign_shared_set_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -35,23 +36,43 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // CampaignSharedSets are used for managing the shared sets associated with a // campaign. message CampaignSharedSet { - // The resource name of the campaign shared set. + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignSharedSet" + pattern: "customers/{customer}/campaignSharedSets/{campaign_shared_set}" + }; + + // Immutable. The resource name of the campaign shared set. // Campaign shared set resource names have the form: // // `customers/{customer_id}/campaignSharedSets/{campaign_id}~{shared_set_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignSharedSet" + } + ]; - // The campaign to which the campaign shared set belongs. - google.protobuf.StringValue campaign = 3; + // Immutable. The campaign to which the campaign shared set belongs. + google.protobuf.StringValue campaign = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; - // The shared set associated with the campaign. This may be a negative keyword + // Immutable. The shared set associated with the campaign. This may be a negative keyword // shared set of another customer. This customer should be a manager of the // other customer, otherwise the campaign shared set will exist but have no // serving effect. Only negative keyword shared sets can be associated with // Shopping campaigns. Only negative placement shared sets can be associated // with Display mobile app campaigns. - google.protobuf.StringValue shared_set = 4; + google.protobuf.StringValue shared_set = 4 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/SharedSet" + } + ]; - // The status of this campaign shared set. Read only. - google.ads.googleads.v2.enums.CampaignSharedSetStatusEnum.CampaignSharedSetStatus status = 2; + // Output only. The status of this campaign shared set. Read only. + google.ads.googleads.v2.enums.CampaignSharedSetStatusEnum.CampaignSharedSetStatus status = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/carrier_constant.proto b/third_party/googleapis/google/ads/googleads/v2/resources/carrier_constant.proto index 3ffa24d99..44b0b6fc1 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/carrier_constant.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/carrier_constant.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -33,19 +34,29 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A carrier criterion that can be used in campaign targeting. message CarrierConstant { - // The resource name of the carrier criterion. + option (google.api.resource) = { + type: "googleads.googleapis.com/CarrierConstant" + pattern: "carrierConstants/{carrier_constant}" + }; + + // Output only. The resource name of the carrier criterion. // Carrier criterion resource names have the form: // // `carrierConstants/{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CarrierConstant" + } + ]; - // The ID of the carrier criterion. - google.protobuf.Int64Value id = 2; + // Output only. The ID of the carrier criterion. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The full name of the carrier in English. - google.protobuf.StringValue name = 3; + // Output only. The full name of the carrier in English. + google.protobuf.StringValue name = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The country code of the country where the carrier is located, e.g., "AR", + // Output only. The country code of the country where the carrier is located, e.g., "AR", // "FR", etc. - google.protobuf.StringValue country_code = 4; + google.protobuf.StringValue country_code = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/change_status.proto b/third_party/googleapis/google/ads/googleads/v2/resources/change_status.proto index 626b16ee1..c0f65bf01 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/change_status.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/change_status.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/change_status_operation.proto"; import "google/ads/googleads/v2/enums/change_status_resource_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -35,50 +36,110 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // Describes the status of returned resource. message ChangeStatus { - // The resource name of the change status. + option (google.api.resource) = { + type: "googleads.googleapis.com/ChangeStatus" + pattern: "customers/{customer}/changeStatus/{change_status}" + }; + + // Output only. The resource name of the change status. // Change status resource names have the form: // // `customers/{customer_id}/changeStatus/{change_status_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ChangeStatus" + } + ]; - // Time at which the most recent change has occurred on this resource. - google.protobuf.StringValue last_change_date_time = 3; + // Output only. Time at which the most recent change has occurred on this resource. + google.protobuf.StringValue last_change_date_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Represents the type of the changed resource. This dictates what fields + // Output only. Represents the type of the changed resource. This dictates what fields // will be set. For example, for AD_GROUP, campaign and ad_group fields will // be set. - google.ads.googleads.v2.enums.ChangeStatusResourceTypeEnum.ChangeStatusResourceType resource_type = 4; - - // The Campaign affected by this change. - google.protobuf.StringValue campaign = 5; - - // The AdGroup affected by this change. - google.protobuf.StringValue ad_group = 6; - - // Represents the status of the changed resource. - google.ads.googleads.v2.enums.ChangeStatusOperationEnum.ChangeStatusOperation resource_status = 8; - - // The AdGroupAd affected by this change. - google.protobuf.StringValue ad_group_ad = 9; - - // The AdGroupCriterion affected by this change. - google.protobuf.StringValue ad_group_criterion = 10; - - // The CampaignCriterion affected by this change. - google.protobuf.StringValue campaign_criterion = 11; - - // The Feed affected by this change. - google.protobuf.StringValue feed = 12; - - // The FeedItem affected by this change. - google.protobuf.StringValue feed_item = 13; - - // The AdGroupFeed affected by this change. - google.protobuf.StringValue ad_group_feed = 14; - - // The CampaignFeed affected by this change. - google.protobuf.StringValue campaign_feed = 15; - - // The AdGroupBidModifier affected by this change. - google.protobuf.StringValue ad_group_bid_modifier = 16; + google.ads.googleads.v2.enums.ChangeStatusResourceTypeEnum.ChangeStatusResourceType resource_type = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The Campaign affected by this change. + google.protobuf.StringValue campaign = 5 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; + + // Output only. The AdGroup affected by this change. + google.protobuf.StringValue ad_group = 6 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; + + // Output only. Represents the status of the changed resource. + google.ads.googleads.v2.enums.ChangeStatusOperationEnum.ChangeStatusOperation resource_status = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The AdGroupAd affected by this change. + google.protobuf.StringValue ad_group_ad = 9 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAd" + } + ]; + + // Output only. The AdGroupCriterion affected by this change. + google.protobuf.StringValue ad_group_criterion = 10 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterion" + } + ]; + + // Output only. The CampaignCriterion affected by this change. + google.protobuf.StringValue campaign_criterion = 11 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignCriterion" + } + ]; + + // Output only. The Feed affected by this change. + google.protobuf.StringValue feed = 12 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; + + // Output only. The FeedItem affected by this change. + google.protobuf.StringValue feed_item = 13 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedItem" + } + ]; + + // Output only. The AdGroupFeed affected by this change. + google.protobuf.StringValue ad_group_feed = 14 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupFeed" + } + ]; + + // Output only. The CampaignFeed affected by this change. + google.protobuf.StringValue campaign_feed = 15 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignFeed" + } + ]; + + // Output only. The AdGroupBidModifier affected by this change. + google.protobuf.StringValue ad_group_bid_modifier = 16 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupBidModifier" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/click_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/click_view.proto index ff2c50c13..ee9a6ed45 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/click_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/click_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/common/click_location.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -35,27 +36,45 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A click view with metrics aggregated at each click level, including both // valid and invalid clicks. For non-Search campaigns, metrics.clicks // represents the number of valid and invalid interactions. +// Queries including ClickView must have a filter limiting the results to one +// day and can be requested for dates back to 90 days before the time of the +// request. message ClickView { - // The resource name of the click view. + option (google.api.resource) = { + type: "googleads.googleapis.com/ClickView" + pattern: "customers/{customer}/clickViews/{click_view}" + }; + + // Output only. The resource name of the click view. // Click view resource names have the form: // // `customers/{customer_id}/clickViews/{date (yyyy-MM-dd)}~{gclid}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ClickView" + } + ]; - // The Google Click ID. - google.protobuf.StringValue gclid = 2; + // Output only. The Google Click ID. + google.protobuf.StringValue gclid = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The location criteria matching the area of interest associated with the + // Output only. The location criteria matching the area of interest associated with the // impression. - google.ads.googleads.v2.common.ClickLocation area_of_interest = 3; + google.ads.googleads.v2.common.ClickLocation area_of_interest = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The location criteria matching the location of presence associated with the + // Output only. The location criteria matching the location of presence associated with the // impression. - google.ads.googleads.v2.common.ClickLocation location_of_presence = 4; + google.ads.googleads.v2.common.ClickLocation location_of_presence = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Page number in search results where the ad was shown. - google.protobuf.Int64Value page_number = 5; + // Output only. Page number in search results where the ad was shown. + google.protobuf.Int64Value page_number = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The associated ad. - google.protobuf.StringValue ad_group_ad = 7; + // Output only. The associated ad. + google.protobuf.StringValue ad_group_ad = 7 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAd" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/conversion_action.proto b/third_party/googleapis/google/ads/googleads/v2/resources/conversion_action.proto index 89d6e59fb..ab0093dae 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/conversion_action.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/conversion_action.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -24,6 +23,8 @@ import "google/ads/googleads/v2/enums/conversion_action_counting_type.proto"; import "google/ads/googleads/v2/enums/conversion_action_status.proto"; import "google/ads/googleads/v2/enums/conversion_action_type.proto"; import "google/ads/googleads/v2/enums/data_driven_model_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -40,14 +41,19 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A conversion action. message ConversionAction { + option (google.api.resource) = { + type: "googleads.googleapis.com/ConversionAction" + pattern: "customers/{customer}/conversionActions/{conversion_action}" + }; + // Settings related to this conversion action's attribution model. message AttributionModelSettings { // The attribution model type of this conversion action. google.ads.googleads.v2.enums.AttributionModelEnum.AttributionModel attribution_model = 1; - // The status of the data-driven attribution model for the conversion + // Output only. The status of the data-driven attribution model for the conversion // action. - google.ads.googleads.v2.enums.DataDrivenModelStatusEnum.DataDrivenModelStatus data_driven_model_status = 2; + google.ads.googleads.v2.enums.DataDrivenModelStatusEnum.DataDrivenModelStatus data_driven_model_status = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Settings related to the value for conversion events associated with this @@ -69,14 +75,19 @@ message ConversionAction { google.protobuf.BoolValue always_use_default_value = 3; } - // The resource name of the conversion action. + // Immutable. The resource name of the conversion action. // Conversion action resource names have the form: // // `customers/{customer_id}/conversionActions/{conversion_action_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ConversionAction" + } + ]; - // The ID of the conversion action. - google.protobuf.Int64Value id = 2; + // Output only. The ID of the conversion action. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; // The name of the conversion action. // @@ -87,15 +98,15 @@ message ConversionAction { // The status of this conversion action for conversion event accrual. google.ads.googleads.v2.enums.ConversionActionStatusEnum.ConversionActionStatus status = 4; - // The type of this conversion action. - google.ads.googleads.v2.enums.ConversionActionTypeEnum.ConversionActionType type = 5; + // Immutable. The type of this conversion action. + google.ads.googleads.v2.enums.ConversionActionTypeEnum.ConversionActionType type = 5 [(google.api.field_behavior) = IMMUTABLE]; // The category of conversions reported for this conversion action. google.ads.googleads.v2.enums.ConversionActionCategoryEnum.ConversionActionCategory category = 6; - // The resource name of the conversion action owner customer, or null if this + // Output only. The resource name of the conversion action owner customer, or null if this // is a system-defined conversion action. - google.protobuf.StringValue owner_customer = 7; + google.protobuf.StringValue owner_customer = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; // Whether this conversion action should be included in the "conversions" // metric. @@ -119,8 +130,8 @@ message ConversionAction { // Settings related to this conversion action's attribution model. AttributionModelSettings attribution_model_settings = 13; - // The snippets used for tracking conversions. - repeated google.ads.googleads.v2.common.TagSnippet tag_snippets = 14; + // Output only. The snippets used for tracking conversions. + repeated google.ads.googleads.v2.common.TagSnippet tag_snippets = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; // The phone call duration in seconds after which a conversion should be // reported for this conversion action. diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/custom_interest.proto b/third_party/googleapis/google/ads/googleads/v2/resources/custom_interest.proto index 9bd79b227..7c0fbba50 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/custom_interest.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/custom_interest.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/custom_interest_member_type.proto"; import "google/ads/googleads/v2/enums/custom_interest_status.proto"; import "google/ads/googleads/v2/enums/custom_interest_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -36,14 +37,24 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A custom interest. This is a list of users by interest. message CustomInterest { - // The resource name of the custom interest. + option (google.api.resource) = { + type: "googleads.googleapis.com/CustomInterest" + pattern: "customers/{customer}/customInterests/{custom_interest}" + }; + + // Immutable. The resource name of the custom interest. // Custom interest resource names have the form: // // `customers/{customer_id}/customInterests/{custom_interest_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomInterest" + } + ]; - // Id of the custom interest. - google.protobuf.Int64Value id = 2; + // Output only. Id of the custom interest. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; // Status of this custom interest. Indicates whether the custom interest is // enabled or removed. diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/customer.proto b/third_party/googleapis/google/ads/googleads/v2/resources/customer.proto index 6322bb9f1..b0112db16 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/customer.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/customer.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/customer_pay_per_conversion_eligibility_failure_reason.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -34,25 +35,35 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A customer. message Customer { - // The resource name of the customer. + option (google.api.resource) = { + type: "googleads.googleapis.com/Customer" + pattern: "customers/{customer}" + }; + + // Immutable. The resource name of the customer. // Customer resource names have the form: // // `customers/{customer_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Customer" + } + ]; - // The ID of the customer. - google.protobuf.Int64Value id = 3; + // Output only. The ID of the customer. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // Optional, non-unique descriptive name of the customer. google.protobuf.StringValue descriptive_name = 4; - // The currency in which the account operates. + // Immutable. The currency in which the account operates. // A subset of the currency codes from the ISO 4217 standard is // supported. - google.protobuf.StringValue currency_code = 5; + google.protobuf.StringValue currency_code = 5 [(google.api.field_behavior) = IMMUTABLE]; - // The local timezone ID of the customer. - google.protobuf.StringValue time_zone = 6; + // Immutable. The local timezone ID of the customer. + google.protobuf.StringValue time_zone = 6 [(google.api.field_behavior) = IMMUTABLE]; // The URL template for constructing a tracking URL out of parameters. google.protobuf.StringValue tracking_url_template = 7; @@ -63,29 +74,29 @@ message Customer { // Whether auto-tagging is enabled for the customer. google.protobuf.BoolValue auto_tagging_enabled = 8; - // Whether the Customer has a Partners program badge. If the Customer is not + // Output only. Whether the Customer has a Partners program badge. If the Customer is not // associated with the Partners program, this will be false. For more // information, see https://support.google.com/partners/answer/3125774. - google.protobuf.BoolValue has_partners_badge = 9; + google.protobuf.BoolValue has_partners_badge = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Whether the customer is a manager. - google.protobuf.BoolValue manager = 12; + // Output only. Whether the customer is a manager. + google.protobuf.BoolValue manager = 12 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Whether the customer is a test account. - google.protobuf.BoolValue test_account = 13; + // Output only. Whether the customer is a test account. + google.protobuf.BoolValue test_account = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; // Call reporting setting for a customer. CallReportingSetting call_reporting_setting = 10; - // Conversion tracking setting for a customer. - ConversionTrackingSetting conversion_tracking_setting = 14; + // Output only. Conversion tracking setting for a customer. + ConversionTrackingSetting conversion_tracking_setting = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Remarketing setting for a customer. - RemarketingSetting remarketing_setting = 15; + // Output only. Remarketing setting for a customer. + RemarketingSetting remarketing_setting = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Reasons why the customer is not eligible to use PaymentMode.CONVERSIONS. If + // Output only. Reasons why the customer is not eligible to use PaymentMode.CONVERSIONS. If // the list is empty, the customer is eligible. This field is read-only. - repeated google.ads.googleads.v2.enums.CustomerPayPerConversionEligibilityFailureReasonEnum.CustomerPayPerConversionEligibilityFailureReason pay_per_conversion_eligibility_failure_reasons = 16; + repeated google.ads.googleads.v2.enums.CustomerPayPerConversionEligibilityFailureReasonEnum.CustomerPayPerConversionEligibilityFailureReason pay_per_conversion_eligibility_failure_reasons = 16 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Call reporting setting for a customer. @@ -100,26 +111,28 @@ message CallReportingSetting { // Customer-level call conversion action to attribute a call conversion to. // If not set a default conversion action is used. Only in effect when // call_conversion_reporting_enabled is set to true. - google.protobuf.StringValue call_conversion_action = 9; + google.protobuf.StringValue call_conversion_action = 9 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/ConversionAction" + }]; } // A collection of customer-wide settings related to Google Ads Conversion // Tracking. message ConversionTrackingSetting { - // The conversion tracking id used for this account. This id is automatically + // Output only. The conversion tracking id used for this account. This id is automatically // assigned after any conversion tracking feature is used. If the customer // doesn't use conversion tracking, this is 0. This field is read-only. - google.protobuf.Int64Value conversion_tracking_id = 1; + google.protobuf.Int64Value conversion_tracking_id = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The conversion tracking id of the customer's manager. This is set when the + // Output only. The conversion tracking id of the customer's manager. This is set when the // customer is opted into cross account conversion tracking, and it overrides // conversion_tracking_id. This field can only be managed through the Google // Ads UI. This field is read-only. - google.protobuf.Int64Value cross_account_conversion_tracking_id = 2; + google.protobuf.Int64Value cross_account_conversion_tracking_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Remarketing setting for a customer. message RemarketingSetting { - // The Google global site tag. - google.protobuf.StringValue google_global_site_tag = 1; + // Output only. The Google global site tag. + google.protobuf.StringValue google_global_site_tag = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/customer_client.proto b/third_party/googleapis/google/ads/googleads/v2/resources/customer_client.proto index 90b7c049b..9da1049fd 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/customer_client.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/customer_client.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -35,21 +36,50 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // exist for manager customers. All direct and indirect client customers are // included, as well as the manager itself. message CustomerClient { - // The resource name of the customer client. + option (google.api.resource) = { + type: "googleads.googleapis.com/CustomerClient" + pattern: "customers/{customer}/customerClients/{customer_client}" + }; + + // Output only. The resource name of the customer client. // CustomerClient resource names have the form: // `customers/{customer_id}/customerClients/{client_customer_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerClient" + } + ]; - // The resource name of the client-customer which is linked to + // Output only. The resource name of the client-customer which is linked to // the given customer. Read only. - google.protobuf.StringValue client_customer = 3; + google.protobuf.StringValue client_customer = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Specifies whether this is a + // Output only. Specifies whether this is a // [hidden account](https://support.google.com/google-ads/answer/7519830). // Read only. - google.protobuf.BoolValue hidden = 4; + google.protobuf.BoolValue hidden = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Distance between given customer and client. For self link, the level value + // Output only. Distance between given customer and client. For self link, the level value // will be 0. Read only. - google.protobuf.Int64Value level = 5; + google.protobuf.Int64Value level = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Common Locale Data Repository (CLDR) string representation of the + // time zone of the client, e.g. America/Los_Angeles. Read only. + google.protobuf.StringValue time_zone = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Identifies if the client is a test account. Read only. + google.protobuf.BoolValue test_account = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Identifies if the client is a manager. Read only. + google.protobuf.BoolValue manager = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Descriptive name for the client. Read only. + google.protobuf.StringValue descriptive_name = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Currency code (e.g. 'USD', 'EUR') for the client. Read only. + google.protobuf.StringValue currency_code = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The ID of the client customer. Read only. + google.protobuf.Int64Value id = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/customer_client_link.proto b/third_party/googleapis/google/ads/googleads/v2/resources/customer_client_link.proto index a346f8451..8a4fdeb2f 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/customer_client_link.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/customer_client_link.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/manager_link_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -34,16 +35,26 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // Represents customer client link relationship. message CustomerClientLink { - // Name of the resource. + option (google.api.resource) = { + type: "googleads.googleapis.com/CustomerClientLink" + pattern: "customers/{customer}/customerClientLinks/{customer_client_link}" + }; + + // Immutable. Name of the resource. // CustomerClientLink resource names have the form: // `customers/{customer_id}/customerClientLinks/{client_customer_id}~{manager_link_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerClientLink" + } + ]; - // The client customer linked to this customer. - google.protobuf.StringValue client_customer = 3; + // Immutable. The client customer linked to this customer. + google.protobuf.StringValue client_customer = 3 [(google.api.field_behavior) = IMMUTABLE]; - // This is uniquely identifies a customer client link. Read only. - google.protobuf.Int64Value manager_link_id = 4; + // Output only. This is uniquely identifies a customer client link. Read only. + google.protobuf.Int64Value manager_link_id = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; // This is the status of the link between client and manager. google.ads.googleads.v2.enums.ManagerLinkStatusEnum.ManagerLinkStatus status = 5; diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/customer_extension_setting.proto b/third_party/googleapis/google/ads/googleads/v2/resources/customer_extension_setting.proto index a877779af..e2e9fba83 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/customer_extension_setting.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/customer_extension_setting.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/extension_setting_device.proto"; import "google/ads/googleads/v2/enums/extension_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -35,20 +36,32 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A customer extension setting. message CustomerExtensionSetting { - // The resource name of the customer extension setting. + option (google.api.resource) = { + type: "googleads.googleapis.com/CustomerExtensionSetting" + pattern: "customers/{customer}/customerExtensionSettings/{customer_extension_setting}" + }; + + // Immutable. The resource name of the customer extension setting. // CustomerExtensionSetting resource names have the form: // // `customers/{customer_id}/customerExtensionSettings/{extension_type}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerExtensionSetting" + } + ]; - // The extension type of the customer extension setting. - google.ads.googleads.v2.enums.ExtensionTypeEnum.ExtensionType extension_type = 2; + // Immutable. The extension type of the customer extension setting. + google.ads.googleads.v2.enums.ExtensionTypeEnum.ExtensionType extension_type = 2 [(google.api.field_behavior) = IMMUTABLE]; // The resource names of the extension feed items to serve under the customer. // ExtensionFeedItem resource names have the form: // // `customers/{customer_id}/extensionFeedItems/{feed_item_id}` - repeated google.protobuf.StringValue extension_feed_items = 3; + repeated google.protobuf.StringValue extension_feed_items = 3 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/ExtensionFeedItem" + }]; // The device for which the extensions will serve. Optional. google.ads.googleads.v2.enums.ExtensionSettingDeviceEnum.ExtensionSettingDevice device = 4; diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/customer_feed.proto b/third_party/googleapis/google/ads/googleads/v2/resources/customer_feed.proto index e17dc363e..1abdc9ab4 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/customer_feed.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/customer_feed.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/common/matching_function.proto"; import "google/ads/googleads/v2/enums/feed_link_status.proto"; import "google/ads/googleads/v2/enums/placeholder_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -36,14 +37,29 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A customer feed. message CustomerFeed { - // The resource name of the customer feed. + option (google.api.resource) = { + type: "googleads.googleapis.com/CustomerFeed" + pattern: "customers/{customer}/customerFeeds/{customer_feed}" + }; + + // Immutable. The resource name of the customer feed. // Customer feed resource names have the form: // // `customers/{customer_id}/customerFeeds/{feed_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerFeed" + } + ]; - // The feed being linked to the customer. - google.protobuf.StringValue feed = 2; + // Immutable. The feed being linked to the customer. + google.protobuf.StringValue feed = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; // Indicates which placeholder types the feed may populate under the connected // customer. Required. @@ -54,7 +70,7 @@ message CustomerFeed { // Required. google.ads.googleads.v2.common.MatchingFunction matching_function = 4; - // Status of the customer feed. + // Output only. Status of the customer feed. // This field is read-only. - google.ads.googleads.v2.enums.FeedLinkStatusEnum.FeedLinkStatus status = 5; + google.ads.googleads.v2.enums.FeedLinkStatusEnum.FeedLinkStatus status = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/customer_label.proto b/third_party/googleapis/google/ads/googleads/v2/resources/customer_label.proto index c67989a6e..640b36823 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/customer_label.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/customer_label.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -35,18 +36,28 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // not have access to all the labels attached to it. Additional CustomerLabels // may be returned by increasing permissions with login-customer-id. message CustomerLabel { - // Name of the resource. + option (google.api.resource) = { + type: "googleads.googleapis.com/CustomerLabel" + pattern: "customers/{customer}/customerLabels/{customer_label}" + }; + + // Immutable. Name of the resource. // Customer label resource names have the form: // `customers/{customer_id}/customerLabels/{label_id}` - string resource_name = 1; - - // The resource name of the customer to which the label is attached. + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerLabel" + } + ]; + + // Output only. The resource name of the customer to which the label is attached. // Read only. - google.protobuf.StringValue customer = 2; + google.protobuf.StringValue customer = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The resource name of the label assigned to the customer. + // Output only. The resource name of the label assigned to the customer. // // Note: the Customer ID portion of the label resource name is not // validated when creating a new CustomerLabel. - google.protobuf.StringValue label = 3; + google.protobuf.StringValue label = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/customer_manager_link.proto b/third_party/googleapis/google/ads/googleads/v2/resources/customer_manager_link.proto index 09f46a832..5485407cc 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/customer_manager_link.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/customer_manager_link.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/manager_link_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -34,16 +35,26 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // Represents customer-manager link relationship. message CustomerManagerLink { - // Name of the resource. + option (google.api.resource) = { + type: "googleads.googleapis.com/CustomerManagerLink" + pattern: "customers/{customer}/customerManagerLinks/{customer_manager_link}" + }; + + // Immutable. Name of the resource. // CustomerManagerLink resource names have the form: // `customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}` - string resource_name = 1; - - // The manager customer linked to the customer. - google.protobuf.StringValue manager_customer = 3; - - // ID of the customer-manager link. This field is read only. - google.protobuf.Int64Value manager_link_id = 4; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerManagerLink" + } + ]; + + // Output only. The manager customer linked to the customer. + google.protobuf.StringValue manager_customer = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. ID of the customer-manager link. This field is read only. + google.protobuf.Int64Value manager_link_id = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; // Status of the link between the customer and the manager. google.ads.googleads.v2.enums.ManagerLinkStatusEnum.ManagerLinkStatus status = 5; diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/customer_negative_criterion.proto b/third_party/googleapis/google/ads/googleads/v2/resources/customer_negative_criterion.proto index 230c82b8d..f8f13997d 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/customer_negative_criterion.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/customer_negative_criterion.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/common/criteria.proto"; import "google/ads/googleads/v2/enums/criterion_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -35,38 +36,48 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A negative criterion for exclusions at the customer level. message CustomerNegativeCriterion { - // The resource name of the customer negative criterion. + option (google.api.resource) = { + type: "googleads.googleapis.com/CustomerNegativeCriterion" + pattern: "customers/{customer}/customerNegativeCriteria/{customer_negative_criterion}" + }; + + // Immutable. The resource name of the customer negative criterion. // Customer negative criterion resource names have the form: // // `customers/{customer_id}/customerNegativeCriteria/{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerNegativeCriterion" + } + ]; - // The ID of the criterion. - google.protobuf.Int64Value id = 2; + // Output only. The ID of the criterion. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The type of the criterion. - google.ads.googleads.v2.enums.CriterionTypeEnum.CriterionType type = 3; + // Output only. The type of the criterion. + google.ads.googleads.v2.enums.CriterionTypeEnum.CriterionType type = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // The customer negative criterion. // // Exactly one must be set. oneof criterion { - // ContentLabel. - google.ads.googleads.v2.common.ContentLabelInfo content_label = 4; + // Immutable. ContentLabel. + google.ads.googleads.v2.common.ContentLabelInfo content_label = 4 [(google.api.field_behavior) = IMMUTABLE]; - // MobileApplication. - google.ads.googleads.v2.common.MobileApplicationInfo mobile_application = 5; + // Immutable. MobileApplication. + google.ads.googleads.v2.common.MobileApplicationInfo mobile_application = 5 [(google.api.field_behavior) = IMMUTABLE]; - // MobileAppCategory. - google.ads.googleads.v2.common.MobileAppCategoryInfo mobile_app_category = 6; + // Immutable. MobileAppCategory. + google.ads.googleads.v2.common.MobileAppCategoryInfo mobile_app_category = 6 [(google.api.field_behavior) = IMMUTABLE]; - // Placement. - google.ads.googleads.v2.common.PlacementInfo placement = 7; + // Immutable. Placement. + google.ads.googleads.v2.common.PlacementInfo placement = 7 [(google.api.field_behavior) = IMMUTABLE]; - // YouTube Video. - google.ads.googleads.v2.common.YouTubeVideoInfo youtube_video = 8; + // Immutable. YouTube Video. + google.ads.googleads.v2.common.YouTubeVideoInfo youtube_video = 8 [(google.api.field_behavior) = IMMUTABLE]; - // YouTube Channel. - google.ads.googleads.v2.common.YouTubeChannelInfo youtube_channel = 9; + // Immutable. YouTube Channel. + google.ads.googleads.v2.common.YouTubeChannelInfo youtube_channel = 9 [(google.api.field_behavior) = IMMUTABLE]; } } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/detail_placement_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/detail_placement_view.proto index 5568cac9e..c276b3051 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/detail_placement_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/detail_placement_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/placement_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -34,28 +35,38 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A view with metrics aggregated by ad group and URL or YouTube video. message DetailPlacementView { - // The resource name of the detail placement view. + option (google.api.resource) = { + type: "googleads.googleapis.com/DetailPlacementView" + pattern: "customers/{customer}/detailPlacementViews/{detail_placement_view}" + }; + + // Output only. The resource name of the detail placement view. // Detail placement view resource names have the form: // // `customers/{customer_id}/detailPlacementViews/{ad_group_id}~{base64_placement}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DetailPlacementView" + } + ]; - // The automatic placement string at detail level, e. g. website URL, mobile + // Output only. The automatic placement string at detail level, e. g. website URL, mobile // application ID, or a YouTube video ID. - google.protobuf.StringValue placement = 2; + google.protobuf.StringValue placement = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The display name is URL name for websites, YouTube video name for YouTube + // Output only. The display name is URL name for websites, YouTube video name for YouTube // videos, and translated mobile app name for mobile apps. - google.protobuf.StringValue display_name = 3; + google.protobuf.StringValue display_name = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // URL of the group placement, e.g. domain, link to the mobile application in + // Output only. URL of the group placement, e.g. domain, link to the mobile application in // app store, or a YouTube channel URL. - google.protobuf.StringValue group_placement_target_url = 4; + google.protobuf.StringValue group_placement_target_url = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // URL of the placement, e.g. website, link to the mobile application in app + // Output only. URL of the placement, e.g. website, link to the mobile application in app // store, or a YouTube video URL. - google.protobuf.StringValue target_url = 5; + google.protobuf.StringValue target_url = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Type of the placement, e.g. Website, YouTube Video, and Mobile Application. - google.ads.googleads.v2.enums.PlacementTypeEnum.PlacementType placement_type = 6; + // Output only. Type of the placement, e.g. Website, YouTube Video, and Mobile Application. + google.ads.googleads.v2.enums.PlacementTypeEnum.PlacementType placement_type = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/display_keyword_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/display_keyword_view.proto index e5f8ab942..2f600abc8 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/display_keyword_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/display_keyword_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Resources"; @@ -32,9 +33,19 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A display keyword view. message DisplayKeywordView { - // The resource name of the display keyword view. + option (google.api.resource) = { + type: "googleads.googleapis.com/DisplayKeywordView" + pattern: "customers/{customer}/displayKeywordViews/{display_keyword_view}" + }; + + // Output only. The resource name of the display keyword view. // Display Keyword view resource names have the form: // // `customers/{customer_id}/displayKeywordViews/{ad_group_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DisplayKeywordView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/distance_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/distance_view.proto index 3074a0d8a..044d10efa 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/distance_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/distance_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/distance_bucket.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -32,21 +33,31 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // Proto file describing the DistanceView resource. -// A distance view with metrics aggregated by the user’s distance from an -// advertiser’s location extensions. Each DistanceBucket includes all +// A distance view with metrics aggregated by the user's distance from an +// advertiser's location extensions. Each DistanceBucket includes all // impressions that fall within its distance and a single impression will -// contribute to the metrics for all DistanceBuckets that include the user’s +// contribute to the metrics for all DistanceBuckets that include the user's // distance. message DistanceView { - // The resource name of the distance view. + option (google.api.resource) = { + type: "googleads.googleapis.com/DistanceView" + pattern: "customers/{customer}/distanceViews/{distance_view}" + }; + + // Output only. The resource name of the distance view. // Distance view resource names have the form: // // `customers/{customer_id}/distanceViews/1~{distance_bucket}` - string resource_name = 1; - - // Grouping of user distance from location extensions. - google.ads.googleads.v2.enums.DistanceBucketEnum.DistanceBucket distance_bucket = 2; - - // True if the DistanceBucket is using the metric system, false otherwise. - google.protobuf.BoolValue metric_system = 3; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DistanceView" + } + ]; + + // Output only. Grouping of user distance from location extensions. + google.ads.googleads.v2.enums.DistanceBucketEnum.DistanceBucket distance_bucket = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. True if the DistanceBucket is using the metric system, false otherwise. + google.protobuf.BoolValue metric_system = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/domain_category.proto b/third_party/googleapis/google/ads/googleads/v2/resources/domain_category.proto index 3b79b4b43..a9b563e9a 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/domain_category.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/domain_category.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -36,40 +37,55 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // the domain. The categories can be targeted using WebpageConditionInfo. // See: https://support.google.com/google-ads/answer/2471185 message DomainCategory { - // The resource name of the domain category. + option (google.api.resource) = { + type: "googleads.googleapis.com/DomainCategory" + pattern: "customers/{customer}/domainCategories/{domain_category}" + }; + + // Output only. The resource name of the domain category. // Domain category resource names have the form: // // `customers/{customer_id}/domainCategories/{campaign_id}~{category_base64}~{language_code}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DomainCategory" + } + ]; - // The campaign this category is recommended for. - google.protobuf.StringValue campaign = 2; + // Output only. The campaign this category is recommended for. + google.protobuf.StringValue campaign = 2 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; - // Recommended category for the website domain. e.g. if you have a website + // Output only. Recommended category for the website domain. e.g. if you have a website // about electronics, the categories could be "cameras", "televisions", etc. - google.protobuf.StringValue category = 3; + google.protobuf.StringValue category = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The language code specifying the language of the website. e.g. "en" for + // Output only. The language code specifying the language of the website. e.g. "en" for // English. The language can be specified in the DynamicSearchAdsSetting // required for dynamic search ads. This is the language of the pages from // your website that you want Google Ads to find, create ads for, // and match searches with. - google.protobuf.StringValue language_code = 4; + google.protobuf.StringValue language_code = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The domain for the website. The domain can be specified in the + // Output only. The domain for the website. The domain can be specified in the // DynamicSearchAdsSetting required for dynamic search ads. - google.protobuf.StringValue domain = 5; + google.protobuf.StringValue domain = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Fraction of pages on your site that this category matches. - google.protobuf.DoubleValue coverage_fraction = 6; + // Output only. Fraction of pages on your site that this category matches. + google.protobuf.DoubleValue coverage_fraction = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The position of this category in the set of categories. Lower numbers + // Output only. The position of this category in the set of categories. Lower numbers // indicate a better match for the domain. null indicates not recommended. - google.protobuf.Int64Value category_rank = 7; + google.protobuf.Int64Value category_rank = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Indicates whether this category has sub-categories. - google.protobuf.BoolValue has_children = 8; + // Output only. Indicates whether this category has sub-categories. + google.protobuf.BoolValue has_children = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The recommended cost per click for the category. - google.protobuf.Int64Value recommended_cpc_bid_micros = 9; + // Output only. The recommended cost per click for the category. + google.protobuf.Int64Value recommended_cpc_bid_micros = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/dynamic_search_ads_search_term_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/dynamic_search_ads_search_term_view.proto index 222ba1f4f..402e883dc 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/dynamic_search_ads_search_term_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/dynamic_search_ads_search_term_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -33,29 +34,39 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A dynamic search ads search term view. message DynamicSearchAdsSearchTermView { - // The resource name of the dynamic search ads search term view. + option (google.api.resource) = { + type: "googleads.googleapis.com/DynamicSearchAdsSearchTermView" + pattern: "customers/{customer}/dynamicSearchAdsSearchTermViews/{dynamic_search_ads_search_term_view}" + }; + + // Output only. The resource name of the dynamic search ads search term view. // Dynamic search ads search term view resource names have the form: // // `customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fp}~{headline_fp}~{landing_page_fp}~{page_url_fp}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DynamicSearchAdsSearchTermView" + } + ]; - // Search term + // Output only. Search term // // This field is read-only. - google.protobuf.StringValue search_term = 2; + google.protobuf.StringValue search_term = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The dynamically generated headline of the Dynamic Search Ad. + // Output only. The dynamically generated headline of the Dynamic Search Ad. // // This field is read-only. - google.protobuf.StringValue headline = 3; + google.protobuf.StringValue headline = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The dynamically selected landing page URL of the impression. + // Output only. The dynamically selected landing page URL of the impression. // // This field is read-only. - google.protobuf.StringValue landing_page = 4; + google.protobuf.StringValue landing_page = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The URL of page feed item served for the impression. + // Output only. The URL of page feed item served for the impression. // // This field is read-only. - google.protobuf.StringValue page_url = 5; + google.protobuf.StringValue page_url = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/expanded_landing_page_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/expanded_landing_page_view.proto index c99db6001..0e05b2f7d 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/expanded_landing_page_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/expanded_landing_page_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -34,12 +35,22 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A landing page view with metrics aggregated at the expanded final URL // level. message ExpandedLandingPageView { - // The resource name of the expanded landing page view. + option (google.api.resource) = { + type: "googleads.googleapis.com/ExpandedLandingPageView" + pattern: "customers/{customer}/expandedLandingPageViews/{expanded_landing_page_view}" + }; + + // Output only. The resource name of the expanded landing page view. // Expanded landing page view resource names have the form: // // `customers/{customer_id}/expandedLandingPageViews/{expanded_final_url_fingerprint}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ExpandedLandingPageView" + } + ]; - // The final URL that clicks are directed to. - google.protobuf.StringValue expanded_final_url = 2; + // Output only. The final URL that clicks are directed to. + google.protobuf.StringValue expanded_final_url = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/extension_feed_item.proto b/third_party/googleapis/google/ads/googleads/v2/resources/extension_feed_item.proto index 5956ea87b..52f36ab6f 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/extension_feed_item.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/extension_feed_item.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -22,6 +21,8 @@ import "google/ads/googleads/v2/common/extensions.proto"; import "google/ads/googleads/v2/enums/extension_type.proto"; import "google/ads/googleads/v2/enums/feed_item_status.proto"; import "google/ads/googleads/v2/enums/feed_item_target_device.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -38,15 +39,28 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // An extension feed item. message ExtensionFeedItem { - // The resource name of the extension feed item. + option (google.api.resource) = { + type: "googleads.googleapis.com/ExtensionFeedItem" + pattern: "customers/{customer}/extensionFeedItems/{extension_feed_item}" + }; + + // Immutable. The resource name of the extension feed item. // Extension feed item resource names have the form: // // `customers/{customer_id}/extensionFeedItems/{feed_item_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ExtensionFeedItem" + } + ]; - // The extension type of the extension feed item. + // Output only. The ID of this feed item. Read-only. + google.protobuf.Int64Value id = 24 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The extension type of the extension feed item. // This field is read-only. - google.ads.googleads.v2.enums.ExtensionTypeEnum.ExtensionType extension_type = 13; + google.ads.googleads.v2.enums.ExtensionTypeEnum.ExtensionType extension_type = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; // Start time in which this feed item is effective and can begin serving. The // time is in the customer's time zone. @@ -69,14 +83,16 @@ message ExtensionFeedItem { google.ads.googleads.v2.enums.FeedItemTargetDeviceEnum.FeedItemTargetDevice device = 17; // The targeted geo target constant. - google.protobuf.StringValue targeted_geo_target_constant = 20; + google.protobuf.StringValue targeted_geo_target_constant = 20 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/GeoTargetConstant" + }]; // The targeted keyword. google.ads.googleads.v2.common.KeywordInfo targeted_keyword = 22; - // Status of the feed item. + // Output only. Status of the feed item. // This field is read-only. - google.ads.googleads.v2.enums.FeedItemStatusEnum.FeedItemStatus status = 4; + google.ads.googleads.v2.enums.FeedItemStatusEnum.FeedItemStatus status = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; // Extension type. oneof extension { @@ -104,23 +120,30 @@ message ExtensionFeedItem { // Promotion extension. google.ads.googleads.v2.common.PromotionFeedItem promotion_feed_item = 12; - // Location extension. Locations are synced from a GMB account into a feed. + // Output only. Location extension. Locations are synced from a GMB account into a feed. // This field is read-only. - google.ads.googleads.v2.common.LocationFeedItem location_feed_item = 14; + google.ads.googleads.v2.common.LocationFeedItem location_feed_item = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Affiliate location extension. Feed locations are populated by Google Ads + // Output only. Affiliate location extension. Feed locations are populated by Google Ads // based on a chain ID. // This field is read-only. - google.ads.googleads.v2.common.AffiliateLocationFeedItem affiliate_location_feed_item = 15; + google.ads.googleads.v2.common.AffiliateLocationFeedItem affiliate_location_feed_item = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Hotel Callout extension. + google.ads.googleads.v2.common.HotelCalloutFeedItem hotel_callout_feed_item = 23; } // Targeting at either the campaign or ad group level. Feed items that target // a campaign or ad group will only serve with that resource. oneof serving_resource_targeting { // The targeted campaign. - google.protobuf.StringValue targeted_campaign = 18; + google.protobuf.StringValue targeted_campaign = 18 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + }]; // The targeted ad group. - google.protobuf.StringValue targeted_ad_group = 19; + google.protobuf.StringValue targeted_ad_group = 19 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + }]; } } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/feed.proto b/third_party/googleapis/google/ads/googleads/v2/resources/feed.proto index 1760048d3..bc1a002e4 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/feed.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/feed.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -21,6 +20,8 @@ import "google/ads/googleads/v2/enums/affiliate_location_feed_relationship_type. import "google/ads/googleads/v2/enums/feed_attribute_type.proto"; import "google/ads/googleads/v2/enums/feed_origin.proto"; import "google/ads/googleads/v2/enums/feed_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -37,6 +38,11 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A feed. message Feed { + option (google.api.resource) = { + type: "googleads.googleapis.com/Feed" + pattern: "customers/{customer}/feeds/{feed}" + }; + // Data used to configure a location feed populated from Google My Business // Locations. message PlacesLocationFeedData { @@ -52,10 +58,10 @@ message Feed { google.protobuf.StringValue http_authorization_header = 3; } - // Required authentication token (from OAuth API) for the email. + // Immutable. Required authentication token (from OAuth API) for the email. // This field can only be specified in a create request. All its subfields // are not selectable. - OAuthInfo oauth_info = 1; + OAuthInfo oauth_info = 1 [(google.api.field_behavior) = IMMUTABLE]; // Email address of a Google My Business account or email address of a // manager of the Google My Business account. Required. @@ -96,20 +102,27 @@ message Feed { google.ads.googleads.v2.enums.AffiliateLocationFeedRelationshipTypeEnum.AffiliateLocationFeedRelationshipType relationship_type = 2; } - // The resource name of the feed. + // Immutable. The resource name of the feed. // Feed resource names have the form: // // `customers/{customer_id}/feeds/{feed_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; - // The ID of the feed. + // Output only. The ID of the feed. // This field is read-only. - google.protobuf.Int64Value id = 2; + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Name of the feed. Required. - google.protobuf.StringValue name = 3; + // Immutable. Name of the feed. Required. + google.protobuf.StringValue name = 3 [(google.api.field_behavior) = IMMUTABLE]; - // The Feed's attributes. Required on CREATE. + // The Feed's attributes. Required on CREATE, unless + // system_feed_generation_data is provided, in which case Google Ads will + // update the feed with the correct attributes. // Disallowed on UPDATE. Use attribute_operations to add new attributes. repeated FeedAttribute attributes = 4; @@ -117,12 +130,12 @@ message Feed { // be added, not removed. repeated FeedAttributeOperation attribute_operations = 9; - // Specifies who manages the FeedAttributes for the Feed. - google.ads.googleads.v2.enums.FeedOriginEnum.FeedOrigin origin = 5; + // Immutable. Specifies who manages the FeedAttributes for the Feed. + google.ads.googleads.v2.enums.FeedOriginEnum.FeedOrigin origin = 5 [(google.api.field_behavior) = IMMUTABLE]; - // Status of the feed. + // Output only. Status of the feed. // This field is read-only. - google.ads.googleads.v2.enums.FeedStatusEnum.FeedStatus status = 8; + google.ads.googleads.v2.enums.FeedStatusEnum.FeedStatus status = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; // The system data for the Feed. This data specifies information for // generating the feed items of the system generated feed. @@ -172,9 +185,9 @@ message FeedAttributeOperation { ADD = 2; } - // Type of list operation to perform. - Operator operator = 1; + // Output only. Type of list operation to perform. + Operator operator = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The feed attribute being added to the list. - FeedAttribute value = 2; + // Output only. The feed attribute being added to the list. + FeedAttribute value = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/feed_item.proto b/third_party/googleapis/google/ads/googleads/v2/resources/feed_item.proto index 1ba2df744..ebc1e9f88 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/feed_item.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/feed_item.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -29,6 +28,8 @@ import "google/ads/googleads/v2/enums/placeholder_type.proto"; import "google/ads/googleads/v2/enums/policy_approval_status.proto"; import "google/ads/googleads/v2/enums/policy_review_status.proto"; import "google/ads/googleads/v2/errors/feed_item_validation_error.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -45,17 +46,32 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A feed item. message FeedItem { - // The resource name of the feed item. + option (google.api.resource) = { + type: "googleads.googleapis.com/FeedItem" + pattern: "customers/{customer}/feedItems/{feed_item}" + }; + + // Immutable. The resource name of the feed item. // Feed item resource names have the form: // // `customers/{customer_id}/feedItems/{feed_id}~{feed_item_id}` - string resource_name = 1; - - // The feed to which this feed item belongs. - google.protobuf.StringValue feed = 2; - - // The ID of this feed item. - google.protobuf.Int64Value id = 3; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedItem" + } + ]; + + // Immutable. The feed to which this feed item belongs. + google.protobuf.StringValue feed = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; + + // Output only. The ID of this feed item. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // Start time in which this feed item is effective and can begin serving. The // time is in the customer's time zone. @@ -80,17 +96,17 @@ message FeedItem { // `tracking_url_template`, `final_urls`, or `mobile_final_urls`. repeated google.ads.googleads.v2.common.CustomParameter url_custom_parameters = 8; - // Status of the feed item. + // Output only. Status of the feed item. // This field is read-only. - google.ads.googleads.v2.enums.FeedItemStatusEnum.FeedItemStatus status = 9; + google.ads.googleads.v2.enums.FeedItemStatusEnum.FeedItemStatus status = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; - // List of info about a feed item's validation and approval state for active + // Output only. List of info about a feed item's validation and approval state for active // feed mappings. There will be an entry in the list for each type of feed // mapping associated with the feed, e.g. a feed with a sitelink and a call // feed mapping would cause every feed item associated with that feed to have // an entry in this list for both sitelink and call. // This field is read-only. - repeated FeedItemPlaceholderPolicyInfo policy_infos = 10; + repeated FeedItemPlaceholderPolicyInfo policy_infos = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; } // A feed item attribute value. @@ -109,8 +125,8 @@ message FeedItemAttributeValue { // String value. Should be set if feed_attribute_id refers to a feed attribute // of type STRING, URL or DATE_TIME. // For STRING the maximum length is 1500 characters. For URL the maximum - // length is 2076 characters. For DATE_TIME the format of the string must - // be the same as start and end time for the feed item. + // length is 2076 characters. For DATE_TIME the string must be in the format + // "YYYYMMDD HHMMSS". google.protobuf.StringValue string_value = 4; // Double value. Should be set if feed_attribute_id refers to a feed attribute @@ -148,52 +164,52 @@ message FeedItemAttributeValue { // Policy, validation, and quality approval info for a feed item for the // specified placeholder type. message FeedItemPlaceholderPolicyInfo { - // The placeholder type. - google.ads.googleads.v2.enums.PlaceholderTypeEnum.PlaceholderType placeholder_type_enum = 10; + // Output only. The placeholder type. + google.ads.googleads.v2.enums.PlaceholderTypeEnum.PlaceholderType placeholder_type_enum = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The FeedMapping that contains the placeholder type. - google.protobuf.StringValue feed_mapping_resource_name = 2; + // Output only. The FeedMapping that contains the placeholder type. + google.protobuf.StringValue feed_mapping_resource_name = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Where the placeholder type is in the review process. - google.ads.googleads.v2.enums.PolicyReviewStatusEnum.PolicyReviewStatus review_status = 3; + // Output only. Where the placeholder type is in the review process. + google.ads.googleads.v2.enums.PolicyReviewStatusEnum.PolicyReviewStatus review_status = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The overall approval status of the placeholder type, calculated based on + // Output only. The overall approval status of the placeholder type, calculated based on // the status of its individual policy topic entries. - google.ads.googleads.v2.enums.PolicyApprovalStatusEnum.PolicyApprovalStatus approval_status = 4; + google.ads.googleads.v2.enums.PolicyApprovalStatusEnum.PolicyApprovalStatus approval_status = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The list of policy findings for the placeholder type. - repeated google.ads.googleads.v2.common.PolicyTopicEntry policy_topic_entries = 5; + // Output only. The list of policy findings for the placeholder type. + repeated google.ads.googleads.v2.common.PolicyTopicEntry policy_topic_entries = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The validation status of the palceholder type. - google.ads.googleads.v2.enums.FeedItemValidationStatusEnum.FeedItemValidationStatus validation_status = 6; + // Output only. The validation status of the palceholder type. + google.ads.googleads.v2.enums.FeedItemValidationStatusEnum.FeedItemValidationStatus validation_status = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // List of placeholder type validation errors. - repeated FeedItemValidationError validation_errors = 7; + // Output only. List of placeholder type validation errors. + repeated FeedItemValidationError validation_errors = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Placeholder type quality evaluation approval status. - google.ads.googleads.v2.enums.FeedItemQualityApprovalStatusEnum.FeedItemQualityApprovalStatus quality_approval_status = 8; + // Output only. Placeholder type quality evaluation approval status. + google.ads.googleads.v2.enums.FeedItemQualityApprovalStatusEnum.FeedItemQualityApprovalStatus quality_approval_status = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; - // List of placeholder type quality evaluation disapproval reasons. - repeated google.ads.googleads.v2.enums.FeedItemQualityDisapprovalReasonEnum.FeedItemQualityDisapprovalReason quality_disapproval_reasons = 9; + // Output only. List of placeholder type quality evaluation disapproval reasons. + repeated google.ads.googleads.v2.enums.FeedItemQualityDisapprovalReasonEnum.FeedItemQualityDisapprovalReason quality_disapproval_reasons = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Stores a validation error and the set of offending feed attributes which // together are responsible for causing a feed item validation error. message FeedItemValidationError { - // Error code indicating what validation error was triggered. The description + // Output only. Error code indicating what validation error was triggered. The description // of the error can be found in the 'description' field. - google.ads.googleads.v2.errors.FeedItemValidationErrorEnum.FeedItemValidationError validation_error = 1; + google.ads.googleads.v2.errors.FeedItemValidationErrorEnum.FeedItemValidationError validation_error = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The description of the validation error. - google.protobuf.StringValue description = 2; + // Output only. The description of the validation error. + google.protobuf.StringValue description = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Set of feed attributes in the feed item flagged during validation. If + // Output only. Set of feed attributes in the feed item flagged during validation. If // empty, no specific feed attributes can be associated with the error // (e.g. error across the entire feed item). - repeated google.protobuf.Int64Value feed_attribute_ids = 3; + repeated google.protobuf.Int64Value feed_attribute_ids = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Any extra information related to this error which is not captured by + // Output only. Any extra information related to this error which is not captured by // validation_error and feed_attribute_id (e.g. placeholder field IDs when // feed_attribute_id is not mapped). Note that extra_info is not localized. - google.protobuf.StringValue extra_info = 5; + google.protobuf.StringValue extra_info = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/feed_item_target.proto b/third_party/googleapis/google/ads/googleads/v2/resources/feed_item_target.proto index 7d15e0a68..0ea35810f 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/feed_item_target.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/feed_item_target.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/common/criteria.proto"; import "google/ads/googleads/v2/enums/feed_item_target_device.proto"; import "google/ads/googleads/v2/enums/feed_item_target_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -36,38 +37,68 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A feed item target. message FeedItemTarget { - // The resource name of the feed item target. + option (google.api.resource) = { + type: "googleads.googleapis.com/FeedItemTarget" + pattern: "customers/{customer}/feedItemTargets/{feed_item_target}" + }; + + // Immutable. The resource name of the feed item target. // Feed item target resource names have the form: // `customers/{customer_id}/feedItemTargets/{feed_id}~{feed_item_id}~{feed_item_target_type}~{feed_item_target_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedItemTarget" + } + ]; - // The feed item to which this feed item target belongs. - google.protobuf.StringValue feed_item = 2; + // Immutable. The feed item to which this feed item target belongs. + google.protobuf.StringValue feed_item = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedItem" + } + ]; - // The target type of this feed item target. This field is read-only. - google.ads.googleads.v2.enums.FeedItemTargetTypeEnum.FeedItemTargetType feed_item_target_type = 3; + // Output only. The target type of this feed item target. This field is read-only. + google.ads.googleads.v2.enums.FeedItemTargetTypeEnum.FeedItemTargetType feed_item_target_type = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The ID of the targeted resource. This field is read-only. - google.protobuf.Int64Value feed_item_target_id = 6; + // Output only. The ID of the targeted resource. This field is read-only. + google.protobuf.Int64Value feed_item_target_id = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; // The targeted resource. oneof target { - // The targeted campaign. - google.protobuf.StringValue campaign = 4; + // Immutable. The targeted campaign. + google.protobuf.StringValue campaign = 4 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; - // The targeted ad group. - google.protobuf.StringValue ad_group = 5; + // Immutable. The targeted ad group. + google.protobuf.StringValue ad_group = 5 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; - // The targeted keyword. - google.ads.googleads.v2.common.KeywordInfo keyword = 7; + // Immutable. The targeted keyword. + google.ads.googleads.v2.common.KeywordInfo keyword = 7 [(google.api.field_behavior) = IMMUTABLE]; - // The targeted geo target constant resource name. - google.protobuf.StringValue geo_target_constant = 8; + // Immutable. The targeted geo target constant resource name. + google.protobuf.StringValue geo_target_constant = 8 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GeoTargetConstant" + } + ]; - // The targeted device. - google.ads.googleads.v2.enums.FeedItemTargetDeviceEnum.FeedItemTargetDevice device = 9; + // Immutable. The targeted device. + google.ads.googleads.v2.enums.FeedItemTargetDeviceEnum.FeedItemTargetDevice device = 9 [(google.api.field_behavior) = IMMUTABLE]; - // The targeted schedule. - google.ads.googleads.v2.common.AdScheduleInfo ad_schedule = 10; + // Immutable. The targeted schedule. + google.ads.googleads.v2.common.AdScheduleInfo ad_schedule = 10 [(google.api.field_behavior) = IMMUTABLE]; } } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/feed_mapping.proto b/third_party/googleapis/google/ads/googleads/v2/resources/feed_mapping.proto index 5d7a601f0..e5ede0986 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/feed_mapping.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/feed_mapping.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -41,6 +40,8 @@ import "google/ads/googleads/v2/enums/real_estate_placeholder_field.proto"; import "google/ads/googleads/v2/enums/sitelink_placeholder_field.proto"; import "google/ads/googleads/v2/enums/structured_snippet_placeholder_field.proto"; import "google/ads/googleads/v2/enums/travel_placeholder_field.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -57,114 +58,129 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A feed mapping. message FeedMapping { - // The resource name of the feed mapping. + option (google.api.resource) = { + type: "googleads.googleapis.com/FeedMapping" + pattern: "customers/{customer}/feedMappings/{feed_mapping}" + }; + + // Immutable. The resource name of the feed mapping. // Feed mapping resource names have the form: // // `customers/{customer_id}/feedMappings/{feed_id}~{feed_mapping_id}` - string resource_name = 1; - - // The feed of this feed mapping. - google.protobuf.StringValue feed = 2; - - // Feed attributes to field mappings. These mappings are a one-to-many + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedMapping" + } + ]; + + // Immutable. The feed of this feed mapping. + google.protobuf.StringValue feed = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; + + // Immutable. Feed attributes to field mappings. These mappings are a one-to-many // relationship meaning that 1 feed attribute can be used to populate // multiple placeholder fields, but 1 placeholder field can only draw // data from 1 feed attribute. Ad Customizer is an exception, 1 placeholder // field can be mapped to multiple feed attributes. Required. - repeated AttributeFieldMapping attribute_field_mappings = 5; + repeated AttributeFieldMapping attribute_field_mappings = 5 [(google.api.field_behavior) = IMMUTABLE]; - // Status of the feed mapping. + // Output only. Status of the feed mapping. // This field is read-only. - google.ads.googleads.v2.enums.FeedMappingStatusEnum.FeedMappingStatus status = 6; + google.ads.googleads.v2.enums.FeedMappingStatusEnum.FeedMappingStatus status = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; // Feed mapping target. Can be either a placeholder or a criterion. For a // given feed, the active FeedMappings must have unique targets. Required. oneof target { - // The placeholder type of this mapping (i.e., if the mapping maps feed + // Immutable. The placeholder type of this mapping (i.e., if the mapping maps feed // attributes to placeholder fields). - google.ads.googleads.v2.enums.PlaceholderTypeEnum.PlaceholderType placeholder_type = 3; + google.ads.googleads.v2.enums.PlaceholderTypeEnum.PlaceholderType placeholder_type = 3 [(google.api.field_behavior) = IMMUTABLE]; - // The criterion type of this mapping (i.e., if the mapping maps feed + // Immutable. The criterion type of this mapping (i.e., if the mapping maps feed // attributes to criterion fields). - google.ads.googleads.v2.enums.FeedMappingCriterionTypeEnum.FeedMappingCriterionType criterion_type = 4; + google.ads.googleads.v2.enums.FeedMappingCriterionTypeEnum.FeedMappingCriterionType criterion_type = 4 [(google.api.field_behavior) = IMMUTABLE]; } } // Maps from feed attribute id to a placeholder or criterion field id. message AttributeFieldMapping { - // Feed attribute from which to map. - google.protobuf.Int64Value feed_attribute_id = 1; + // Immutable. Feed attribute from which to map. + google.protobuf.Int64Value feed_attribute_id = 1 [(google.api.field_behavior) = IMMUTABLE]; - // The placeholder field ID. If a placeholder field enum is not published in + // Output only. The placeholder field ID. If a placeholder field enum is not published in // the current API version, then this field will be populated and the field // oneof will be empty. // This field is read-only. - google.protobuf.Int64Value field_id = 2; + google.protobuf.Int64Value field_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; // Placeholder or criterion field to be populated using data from // the above feed attribute. Required. oneof field { - // Sitelink Placeholder Fields. - google.ads.googleads.v2.enums.SitelinkPlaceholderFieldEnum.SitelinkPlaceholderField sitelink_field = 3; + // Immutable. Sitelink Placeholder Fields. + google.ads.googleads.v2.enums.SitelinkPlaceholderFieldEnum.SitelinkPlaceholderField sitelink_field = 3 [(google.api.field_behavior) = IMMUTABLE]; - // Call Placeholder Fields. - google.ads.googleads.v2.enums.CallPlaceholderFieldEnum.CallPlaceholderField call_field = 4; + // Immutable. Call Placeholder Fields. + google.ads.googleads.v2.enums.CallPlaceholderFieldEnum.CallPlaceholderField call_field = 4 [(google.api.field_behavior) = IMMUTABLE]; - // App Placeholder Fields. - google.ads.googleads.v2.enums.AppPlaceholderFieldEnum.AppPlaceholderField app_field = 5; + // Immutable. App Placeholder Fields. + google.ads.googleads.v2.enums.AppPlaceholderFieldEnum.AppPlaceholderField app_field = 5 [(google.api.field_behavior) = IMMUTABLE]; - // Location Placeholder Fields. This field is read-only. - google.ads.googleads.v2.enums.LocationPlaceholderFieldEnum.LocationPlaceholderField location_field = 6; + // Output only. Location Placeholder Fields. This field is read-only. + google.ads.googleads.v2.enums.LocationPlaceholderFieldEnum.LocationPlaceholderField location_field = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Affiliate Location Placeholder Fields. This field is read-only. - google.ads.googleads.v2.enums.AffiliateLocationPlaceholderFieldEnum.AffiliateLocationPlaceholderField affiliate_location_field = 7; + // Output only. Affiliate Location Placeholder Fields. This field is read-only. + google.ads.googleads.v2.enums.AffiliateLocationPlaceholderFieldEnum.AffiliateLocationPlaceholderField affiliate_location_field = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Callout Placeholder Fields. - google.ads.googleads.v2.enums.CalloutPlaceholderFieldEnum.CalloutPlaceholderField callout_field = 8; + // Immutable. Callout Placeholder Fields. + google.ads.googleads.v2.enums.CalloutPlaceholderFieldEnum.CalloutPlaceholderField callout_field = 8 [(google.api.field_behavior) = IMMUTABLE]; - // Structured Snippet Placeholder Fields. - google.ads.googleads.v2.enums.StructuredSnippetPlaceholderFieldEnum.StructuredSnippetPlaceholderField structured_snippet_field = 9; + // Immutable. Structured Snippet Placeholder Fields. + google.ads.googleads.v2.enums.StructuredSnippetPlaceholderFieldEnum.StructuredSnippetPlaceholderField structured_snippet_field = 9 [(google.api.field_behavior) = IMMUTABLE]; - // Message Placeholder Fields. - google.ads.googleads.v2.enums.MessagePlaceholderFieldEnum.MessagePlaceholderField message_field = 10; + // Immutable. Message Placeholder Fields. + google.ads.googleads.v2.enums.MessagePlaceholderFieldEnum.MessagePlaceholderField message_field = 10 [(google.api.field_behavior) = IMMUTABLE]; - // Price Placeholder Fields. - google.ads.googleads.v2.enums.PricePlaceholderFieldEnum.PricePlaceholderField price_field = 11; + // Immutable. Price Placeholder Fields. + google.ads.googleads.v2.enums.PricePlaceholderFieldEnum.PricePlaceholderField price_field = 11 [(google.api.field_behavior) = IMMUTABLE]; - // Promotion Placeholder Fields. - google.ads.googleads.v2.enums.PromotionPlaceholderFieldEnum.PromotionPlaceholderField promotion_field = 12; + // Immutable. Promotion Placeholder Fields. + google.ads.googleads.v2.enums.PromotionPlaceholderFieldEnum.PromotionPlaceholderField promotion_field = 12 [(google.api.field_behavior) = IMMUTABLE]; - // Ad Customizer Placeholder Fields - google.ads.googleads.v2.enums.AdCustomizerPlaceholderFieldEnum.AdCustomizerPlaceholderField ad_customizer_field = 13; + // Immutable. Ad Customizer Placeholder Fields + google.ads.googleads.v2.enums.AdCustomizerPlaceholderFieldEnum.AdCustomizerPlaceholderField ad_customizer_field = 13 [(google.api.field_behavior) = IMMUTABLE]; - // Dynamic Search Ad Page Feed Fields. - google.ads.googleads.v2.enums.DsaPageFeedCriterionFieldEnum.DsaPageFeedCriterionField dsa_page_feed_field = 14; + // Immutable. Dynamic Search Ad Page Feed Fields. + google.ads.googleads.v2.enums.DsaPageFeedCriterionFieldEnum.DsaPageFeedCriterionField dsa_page_feed_field = 14 [(google.api.field_behavior) = IMMUTABLE]; - // Location Target Fields. - google.ads.googleads.v2.enums.LocationExtensionTargetingCriterionFieldEnum.LocationExtensionTargetingCriterionField location_extension_targeting_field = 15; + // Immutable. Location Target Fields. + google.ads.googleads.v2.enums.LocationExtensionTargetingCriterionFieldEnum.LocationExtensionTargetingCriterionField location_extension_targeting_field = 15 [(google.api.field_behavior) = IMMUTABLE]; - // Education Placeholder Fields - google.ads.googleads.v2.enums.EducationPlaceholderFieldEnum.EducationPlaceholderField education_field = 16; + // Immutable. Education Placeholder Fields + google.ads.googleads.v2.enums.EducationPlaceholderFieldEnum.EducationPlaceholderField education_field = 16 [(google.api.field_behavior) = IMMUTABLE]; - // Flight Placeholder Fields - google.ads.googleads.v2.enums.FlightPlaceholderFieldEnum.FlightPlaceholderField flight_field = 17; + // Immutable. Flight Placeholder Fields + google.ads.googleads.v2.enums.FlightPlaceholderFieldEnum.FlightPlaceholderField flight_field = 17 [(google.api.field_behavior) = IMMUTABLE]; - // Custom Placeholder Fields - google.ads.googleads.v2.enums.CustomPlaceholderFieldEnum.CustomPlaceholderField custom_field = 18; + // Immutable. Custom Placeholder Fields + google.ads.googleads.v2.enums.CustomPlaceholderFieldEnum.CustomPlaceholderField custom_field = 18 [(google.api.field_behavior) = IMMUTABLE]; - // Hotel Placeholder Fields - google.ads.googleads.v2.enums.HotelPlaceholderFieldEnum.HotelPlaceholderField hotel_field = 19; + // Immutable. Hotel Placeholder Fields + google.ads.googleads.v2.enums.HotelPlaceholderFieldEnum.HotelPlaceholderField hotel_field = 19 [(google.api.field_behavior) = IMMUTABLE]; - // Real Estate Placeholder Fields - google.ads.googleads.v2.enums.RealEstatePlaceholderFieldEnum.RealEstatePlaceholderField real_estate_field = 20; + // Immutable. Real Estate Placeholder Fields + google.ads.googleads.v2.enums.RealEstatePlaceholderFieldEnum.RealEstatePlaceholderField real_estate_field = 20 [(google.api.field_behavior) = IMMUTABLE]; - // Travel Placeholder Fields - google.ads.googleads.v2.enums.TravelPlaceholderFieldEnum.TravelPlaceholderField travel_field = 21; + // Immutable. Travel Placeholder Fields + google.ads.googleads.v2.enums.TravelPlaceholderFieldEnum.TravelPlaceholderField travel_field = 21 [(google.api.field_behavior) = IMMUTABLE]; - // Local Placeholder Fields - google.ads.googleads.v2.enums.LocalPlaceholderFieldEnum.LocalPlaceholderField local_field = 22; + // Immutable. Local Placeholder Fields + google.ads.googleads.v2.enums.LocalPlaceholderFieldEnum.LocalPlaceholderField local_field = 22 [(google.api.field_behavior) = IMMUTABLE]; - // Job Placeholder Fields - google.ads.googleads.v2.enums.JobPlaceholderFieldEnum.JobPlaceholderField job_field = 23; + // Immutable. Job Placeholder Fields + google.ads.googleads.v2.enums.JobPlaceholderFieldEnum.JobPlaceholderField job_field = 23 [(google.api.field_behavior) = IMMUTABLE]; } } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/feed_placeholder_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/feed_placeholder_view.proto index a3f6f0e33..ffbcfefe0 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/feed_placeholder_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/feed_placeholder_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/placeholder_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Resources"; @@ -33,12 +34,22 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A feed placeholder view. message FeedPlaceholderView { - // The resource name of the feed placeholder view. + option (google.api.resource) = { + type: "googleads.googleapis.com/FeedPlaceholderView" + pattern: "customers/{customer}/feedPlaceholderViews/{feed_placeholder_view}" + }; + + // Output only. The resource name of the feed placeholder view. // Feed placeholder view resource names have the form: // // `customers/{customer_id}/feedPlaceholderViews/{placeholder_type}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedPlaceholderView" + } + ]; - // The placeholder type of the feed placeholder view. - google.ads.googleads.v2.enums.PlaceholderTypeEnum.PlaceholderType placeholder_type = 2; + // Output only. The placeholder type of the feed placeholder view. + google.ads.googleads.v2.enums.PlaceholderTypeEnum.PlaceholderType placeholder_type = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/gender_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/gender_view.proto index 77d0631aa..2cba7b8a4 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/gender_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/gender_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Resources"; @@ -32,9 +33,19 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A gender view. message GenderView { - // The resource name of the gender view. + option (google.api.resource) = { + type: "googleads.googleapis.com/GenderView" + pattern: "customers/{customer}/genderViews/{gender_view}" + }; + + // Output only. The resource name of the gender view. // Gender view resource names have the form: // // `customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GenderView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/geo_target_constant.proto b/third_party/googleapis/google/ads/googleads/v2/resources/geo_target_constant.proto index 1cbe1d1d2..533880044 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/geo_target_constant.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/geo_target_constant.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/geo_target_constant_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -34,28 +35,38 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A geo target constant. message GeoTargetConstant { - // The resource name of the geo target constant. + option (google.api.resource) = { + type: "googleads.googleapis.com/GeoTargetConstant" + pattern: "geoTargetConstants/{geo_target_constant}" + }; + + // Output only. The resource name of the geo target constant. // Geo target constant resource names have the form: // // `geoTargetConstants/{geo_target_constant_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GeoTargetConstant" + } + ]; - // The ID of the geo target constant. - google.protobuf.Int64Value id = 3; + // Output only. The ID of the geo target constant. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Geo target constant English name. - google.protobuf.StringValue name = 4; + // Output only. Geo target constant English name. + google.protobuf.StringValue name = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The ISO-3166-1 alpha-2 country code that is associated with the target. - google.protobuf.StringValue country_code = 5; + // Output only. The ISO-3166-1 alpha-2 country code that is associated with the target. + google.protobuf.StringValue country_code = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Geo target constant target type. - google.protobuf.StringValue target_type = 6; + // Output only. Geo target constant target type. + google.protobuf.StringValue target_type = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Geo target constant status. - google.ads.googleads.v2.enums.GeoTargetConstantStatusEnum.GeoTargetConstantStatus status = 7; + // Output only. Geo target constant status. + google.ads.googleads.v2.enums.GeoTargetConstantStatusEnum.GeoTargetConstantStatus status = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The fully qualified English name, consisting of the target's name and that + // Output only. The fully qualified English name, consisting of the target's name and that // of its parent and country. - google.protobuf.StringValue canonical_name = 8; + google.protobuf.StringValue canonical_name = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/geographic_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/geographic_view.proto index 85159e6f1..dd7d5f917 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/geographic_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/geographic_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/geo_targeting_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -39,15 +40,25 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // the user or an area of interest. If other segment fields are used, you may // get more than one row per country. message GeographicView { - // The resource name of the geographic view. + option (google.api.resource) = { + type: "googleads.googleapis.com/GeographicView" + pattern: "customers/{customer}/geographicViews/{geographic_view}" + }; + + // Output only. The resource name of the geographic view. // Geographic view resource names have the form: // // `customers/{customer_id}/geographicViews/{country_criterion_id}~{location_type}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GeographicView" + } + ]; - // Type of the geo targeting of the campaign. - google.ads.googleads.v2.enums.GeoTargetingTypeEnum.GeoTargetingType location_type = 3; + // Output only. Type of the geo targeting of the campaign. + google.ads.googleads.v2.enums.GeoTargetingTypeEnum.GeoTargetingType location_type = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Criterion Id for the country. - google.protobuf.Int64Value country_criterion_id = 4; + // Output only. Criterion Id for the country. + google.protobuf.Int64Value country_criterion_id = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/google_ads_field.proto b/third_party/googleapis/google/ads/googleads/v2/resources/google_ads_field.proto index ecdbc0e0a..a2fc17ecf 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/google_ads_field.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/google_ads_field.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/google_ads_field_category.proto"; import "google/ads/googleads/v2/enums/google_ads_field_data_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -35,51 +36,61 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A field or resource (artifact) used by GoogleAdsService. message GoogleAdsField { - // The resource name of the artifact. + option (google.api.resource) = { + type: "googleads.googleapis.com/GoogleAdsField" + pattern: "googleAdsFields/{google_ads_field}" + }; + + // Output only. The resource name of the artifact. // Artifact resource names have the form: // // `googleAdsFields/{name}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GoogleAdsField" + } + ]; - // The name of the artifact. - google.protobuf.StringValue name = 2; + // Output only. The name of the artifact. + google.protobuf.StringValue name = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The category of the artifact. - google.ads.googleads.v2.enums.GoogleAdsFieldCategoryEnum.GoogleAdsFieldCategory category = 3; + // Output only. The category of the artifact. + google.ads.googleads.v2.enums.GoogleAdsFieldCategoryEnum.GoogleAdsFieldCategory category = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Whether the artifact can be used in a SELECT clause in search + // Output only. Whether the artifact can be used in a SELECT clause in search // queries. - google.protobuf.BoolValue selectable = 4; + google.protobuf.BoolValue selectable = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Whether the artifact can be used in a WHERE clause in search + // Output only. Whether the artifact can be used in a WHERE clause in search // queries. - google.protobuf.BoolValue filterable = 5; + google.protobuf.BoolValue filterable = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Whether the artifact can be used in a ORDER BY clause in search + // Output only. Whether the artifact can be used in a ORDER BY clause in search // queries. - google.protobuf.BoolValue sortable = 6; + google.protobuf.BoolValue sortable = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The names of all resources, segments, and metrics that are selectable with + // Output only. The names of all resources, segments, and metrics that are selectable with // the described artifact. - repeated google.protobuf.StringValue selectable_with = 7; + repeated google.protobuf.StringValue selectable_with = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The names of all resources that are selectable with the described + // Output only. The names of all resources that are selectable with the described // artifact. Fields from these resources do not segment metrics when included // in search queries. // // This field is only set for artifacts whose category is RESOURCE. - repeated google.protobuf.StringValue attribute_resources = 8; + repeated google.protobuf.StringValue attribute_resources = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; - // At and beyond version V1 this field lists the names of all metrics that are + // Output only. At and beyond version V1 this field lists the names of all metrics that are // selectable with the described artifact when it is used in the FROM clause. // It is only set for artifacts whose category is RESOURCE. // // Before version V1 this field lists the names of all metrics that are // selectable with the described artifact. It is only set for artifacts whose // category is either RESOURCE or SEGMENT - repeated google.protobuf.StringValue metrics = 9; + repeated google.protobuf.StringValue metrics = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; - // At and beyond version V1 this field lists the names of all artifacts, + // Output only. At and beyond version V1 this field lists the names of all artifacts, // whether a segment or another resource, that segment metrics when included // in search queries and when the described artifact is used in the FROM // clause. It is only set for artifacts whose category is RESOURCE. @@ -88,20 +99,20 @@ message GoogleAdsField { // segment or another resource, that segment metrics when included in search // queries. It is only set for artifacts of category RESOURCE, SEGMENT or // METRIC. - repeated google.protobuf.StringValue segments = 10; + repeated google.protobuf.StringValue segments = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Values the artifact can assume if it is a field of type ENUM. + // Output only. Values the artifact can assume if it is a field of type ENUM. // // This field is only set for artifacts of category SEGMENT or ATTRIBUTE. - repeated google.protobuf.StringValue enum_values = 11; + repeated google.protobuf.StringValue enum_values = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; - // This field determines the operators that can be used with the artifact + // Output only. This field determines the operators that can be used with the artifact // in WHERE clauses. - google.ads.googleads.v2.enums.GoogleAdsFieldDataTypeEnum.GoogleAdsFieldDataType data_type = 12; + google.ads.googleads.v2.enums.GoogleAdsFieldDataTypeEnum.GoogleAdsFieldDataType data_type = 12 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The URL of proto describing the artifact's data type. - google.protobuf.StringValue type_url = 13; + // Output only. The URL of proto describing the artifact's data type. + google.protobuf.StringValue type_url = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Whether the field artifact is repeated. - google.protobuf.BoolValue is_repeated = 14; + // Output only. Whether the field artifact is repeated. + google.protobuf.BoolValue is_repeated = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/group_placement_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/group_placement_view.proto index 9f22e1770..fa2147ed6 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/group_placement_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/group_placement_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/placement_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -34,23 +35,33 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A group placement view. message GroupPlacementView { - // The resource name of the group placement view. + option (google.api.resource) = { + type: "googleads.googleapis.com/GroupPlacementView" + pattern: "customers/{customer}/groupPlacementViews/{group_placement_view}" + }; + + // Output only. The resource name of the group placement view. // Group placement view resource names have the form: // // `customers/{customer_id}/groupPlacementViews/{ad_group_id}~{base64_placement}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GroupPlacementView" + } + ]; - // The automatic placement string at group level, e. g. web domain, mobile + // Output only. The automatic placement string at group level, e. g. web domain, mobile // app ID, or a YouTube channel ID. - google.protobuf.StringValue placement = 2; + google.protobuf.StringValue placement = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Domain name for websites and YouTube channel name for YouTube channels. - google.protobuf.StringValue display_name = 3; + // Output only. Domain name for websites and YouTube channel name for YouTube channels. + google.protobuf.StringValue display_name = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // URL of the group placement, e.g. domain, link to the mobile application in + // Output only. URL of the group placement, e.g. domain, link to the mobile application in // app store, or a YouTube channel URL. - google.protobuf.StringValue target_url = 4; + google.protobuf.StringValue target_url = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Type of the placement, e.g. Website, YouTube Channel, Mobile Application. - google.ads.googleads.v2.enums.PlacementTypeEnum.PlacementType placement_type = 5; + // Output only. Type of the placement, e.g. Website, YouTube Channel, Mobile Application. + google.ads.googleads.v2.enums.PlacementTypeEnum.PlacementType placement_type = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/hotel_group_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/hotel_group_view.proto index bcdec2814..e26861fe9 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/hotel_group_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/hotel_group_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Resources"; @@ -32,9 +33,19 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A hotel group view. message HotelGroupView { - // The resource name of the hotel group view. + option (google.api.resource) = { + type: "googleads.googleapis.com/HotelGroupView" + pattern: "customers/{customer}/hotelGroupViews/{hotel_group_view}" + }; + + // Output only. The resource name of the hotel group view. // Hotel Group view resource names have the form: // // `customers/{customer_id}/hotelGroupViews/{ad_group_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/HotelGroupView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/hotel_performance_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/hotel_performance_view.proto index bc2546414..1b5c32b78 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/hotel_performance_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/hotel_performance_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Resources"; @@ -32,9 +33,19 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A hotel performance view. message HotelPerformanceView { - // The resource name of the hotel performance view. + option (google.api.resource) = { + type: "googleads.googleapis.com/HotelPerformanceView" + pattern: "customers/{customer}/hotelPerformanceView" + }; + + // Output only. The resource name of the hotel performance view. // Hotel performance view resource names have the form: // // `customers/{customer_id}/hotelPerformanceView` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/HotelPerformanceView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/invoice.proto b/third_party/googleapis/google/ads/googleads/v2/resources/invoice.proto new file mode 100644 index 000000000..40ad89bd6 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v2/resources/invoice.proto @@ -0,0 +1,184 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v2.resources; + +import "google/ads/googleads/v2/common/dates.proto"; +import "google/ads/googleads/v2/enums/invoice_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V2.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "InvoiceProto"; +option java_package = "com.google.ads.googleads.v2.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V2\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; + +// Proto file describing the Invoice resource. + +// An invoice. All invoice information is snapshotted to match the PDF invoice. +// For invoices older than the launch of InvoiceService, the snapshotted +// information may not match the PDF invoice. +message Invoice { + option (google.api.resource) = { + type: "googleads.googleapis.com/Invoice" + pattern: "customers/{customer}/invoices/{invoice}" + }; + + // Represents a summarized account budget billable cost. + message AccountBudgetSummary { + // Output only. The resource name of the customer associated with this account budget. + // This contains the customer ID, which appears on the invoice PDF as + // "Account ID". + // Customer resource names have the form: + // + // `customers/{customer_id}` + google.protobuf.StringValue customer = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The descriptive name of the account budget’s customer. It appears on the + // invoice PDF as "Account". + google.protobuf.StringValue customer_descriptive_name = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The resource name of the account budget associated with this summarized + // billable cost. + // AccountBudget resource names have the form: + // + // `customers/{customer_id}/accountBudgets/{account_budget_id}` + google.protobuf.StringValue account_budget = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The name of the account budget. It appears on the invoice PDF as "Account + // budget". + google.protobuf.StringValue account_budget_name = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The purchase order number of the account budget. It appears on the + // invoice PDF as "Purchase order". + google.protobuf.StringValue purchase_order_number = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The pretax subtotal amount attributable to this budget during the service + // period, in micros. + google.protobuf.Int64Value subtotal_amount_micros = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The tax amount attributable to this budget during the service period, in + // micros. + google.protobuf.Int64Value tax_amount_micros = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The total amount attributable to this budget during the service period, + // in micros. This equals the sum of the account budget subtotal amount and + // the account budget tax amount. + google.protobuf.Int64Value total_amount_micros = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The billable activity date range of the account budget, within the + // service date range of this invoice. The end date is inclusive. This can + // be different from the account budget's start and end time. + google.ads.googleads.v2.common.DateRange billable_activity_date_range = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // Output only. The resource name of the invoice. Multiple customers can share a given + // invoice, so multiple resource names may point to the same invoice. + // Invoice resource names have the form: + // + // `customers/{customer_id}/invoices/{invoice_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Invoice" + } + ]; + + // Output only. The ID of the invoice. It appears on the invoice PDF as "Invoice number". + google.protobuf.StringValue id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The type of invoice. + google.ads.googleads.v2.enums.InvoiceTypeEnum.InvoiceType type = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The resource name of this invoice’s billing setup. + // + // `customers/{customer_id}/billingSetups/{billing_setup_id}` + google.protobuf.StringValue billing_setup = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. A 16 digit ID used to identify the payments account associated with the + // billing setup, e.g. "1234-5678-9012-3456". It appears on the invoice PDF as + // "Billing Account Number". + google.protobuf.StringValue payments_account_id = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. A 12 digit ID used to identify the payments profile associated with the + // billing setup, e.g. "1234-5678-9012". It appears on the invoice PDF as + // "Billing ID". + google.protobuf.StringValue payments_profile_id = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The issue date in yyyy-mm-dd format. It appears on the invoice PDF as + // either "Issue date" or "Invoice date". + google.protobuf.StringValue issue_date = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The due date in yyyy-mm-dd format. + google.protobuf.StringValue due_date = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The service period date range of this invoice. The end date is inclusive. + google.ads.googleads.v2.common.DateRange service_date_range = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The currency code. All costs are returned in this currency. A subset of the + // currency codes derived from the ISO 4217 standard is supported. + google.protobuf.StringValue currency_code = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The total amount of invoice level adjustments. These adjustments are made + // on the invoice, not on a specific account budget. + google.protobuf.Int64Value invoice_level_adjustments_micros = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The pretax subtotal amount, in micros. This equals the sum of the + // AccountBudgetSummary subtotal amounts, plus the invoice level adjustments. + google.protobuf.Int64Value subtotal_amount_micros = 12 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The sum of all taxes on the invoice, in micros. This equals the sum of the + // AccountBudgetSummary tax amounts, plus taxes not associated with a specific + // account budget. + google.protobuf.Int64Value tax_amount_micros = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The total amount, in micros. This equals the sum of the invoice subtotal + // amount and the invoice tax amount. + google.protobuf.Int64Value total_amount_micros = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The resource name of the original invoice corrected, wrote off, or canceled + // by this invoice, if applicable. If `corrected_invoice` is set, + // `replaced_invoices` will not be set. + // + // Invoice resource names have the form: + // + // `customers/{customer_id}/invoices/{invoice_id}` + google.protobuf.StringValue corrected_invoice = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The resource name of the original invoice(s) being rebilled or replaced by + // this invoice, if applicable. There might be multiple replaced invoices due + // to invoice consolidation. The replaced invoices may not belong to the same + // payments account. If `replaced_invoices` is set, `corrected_invoice` will + // not be set. + // Invoice resource names have the form: + // + // `customers/{customer_id}/invoices/{invoice_id}` + repeated google.protobuf.StringValue replaced_invoices = 16 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The URL to a PDF copy of the invoice. Users need to pass in their OAuth + // token to request the PDF with this URL. + google.protobuf.StringValue pdf_url = 17 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The list of summarized account budget information associated with this + // invoice. + repeated AccountBudgetSummary account_budget_summaries = 18 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/keyword_plan.proto b/third_party/googleapis/google/ads/googleads/v2/resources/keyword_plan.proto index 653dde2cf..51da46e11 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/keyword_plan.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/keyword_plan.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/common/dates.proto"; import "google/ads/googleads/v2/enums/keyword_plan_forecast_interval.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -37,14 +38,24 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // Max number of saved keyword plans: 10000. // It's possible to remove plans if limit is reached. message KeywordPlan { - // The resource name of the Keyword Planner plan. + option (google.api.resource) = { + type: "googleads.googleapis.com/KeywordPlan" + pattern: "customers/{customer}/keywordPlans/{keyword_plan}" + }; + + // Immutable. The resource name of the Keyword Planner plan. // KeywordPlan resource names have the form: // // `customers/{customer_id}/keywordPlans/{kp_plan_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlan" + } + ]; - // The ID of the keyword plan. - google.protobuf.Int64Value id = 2; + // Output only. The ID of the keyword plan. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; // The name of the keyword plan. // diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/keyword_plan_ad_group.proto b/third_party/googleapis/google/ads/googleads/v2/resources/keyword_plan_ad_group.proto index fe47479c4..abb48acc4 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/keyword_plan_ad_group.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/keyword_plan_ad_group.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -34,17 +35,29 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A Keyword Planner ad group. // Max number of keyword plan ad groups per plan: 200. message KeywordPlanAdGroup { - // The resource name of the Keyword Planner ad group. + option (google.api.resource) = { + type: "googleads.googleapis.com/KeywordPlanAdGroup" + pattern: "customers/{customer}/keywordPlanAdGroups/{keyword_plan_ad_group}" + }; + + // Immutable. The resource name of the Keyword Planner ad group. // KeywordPlanAdGroup resource names have the form: // // `customers/{customer_id}/keywordPlanAdGroups/{kp_ad_group_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanAdGroup" + } + ]; // The keyword plan campaign to which this ad group belongs. - google.protobuf.StringValue keyword_plan_campaign = 2; + google.protobuf.StringValue keyword_plan_campaign = 2 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanCampaign" + }]; - // The ID of the keyword plan ad group. - google.protobuf.Int64Value id = 3; + // Output only. The ID of the keyword plan ad group. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // The name of the keyword plan ad group. // diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/keyword_plan_campaign.proto b/third_party/googleapis/google/ads/googleads/v2/resources/keyword_plan_campaign.proto index 5bdb79465..47c0f4e57 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/keyword_plan_campaign.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/keyword_plan_campaign.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/keyword_plan_network.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -35,17 +36,29 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A Keyword Plan campaign. // Max number of keyword plan campaigns per plan allowed: 1. message KeywordPlanCampaign { - // The resource name of the Keyword Plan campaign. + option (google.api.resource) = { + type: "googleads.googleapis.com/KeywordPlanCampaign" + pattern: "customers/{customer}/keywordPlanCampaigns/{keyword_plan_campaign}" + }; + + // Immutable. The resource name of the Keyword Plan campaign. // KeywordPlanCampaign resource names have the form: // // `customers/{customer_id}/keywordPlanCampaigns/{kp_campaign_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanCampaign" + } + ]; // The keyword plan this campaign belongs to. - google.protobuf.StringValue keyword_plan = 2; + google.protobuf.StringValue keyword_plan = 2 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlan" + }]; - // The ID of the Keyword Plan campaign. - google.protobuf.Int64Value id = 3; + // Output only. The ID of the Keyword Plan campaign. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // The name of the Keyword Plan campaign. // @@ -55,7 +68,9 @@ message KeywordPlanCampaign { // The languages targeted for the Keyword Plan campaign. // Max allowed: 1. - repeated google.protobuf.StringValue language_constants = 5; + repeated google.protobuf.StringValue language_constants = 5 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/LanguageConstant" + }]; // Targeting network. // @@ -79,5 +94,7 @@ message KeywordPlanCampaign { // Next ID: 3 message KeywordPlanGeoTarget { // Required. The resource name of the geo target. - google.protobuf.StringValue geo_target_constant = 1; + google.protobuf.StringValue geo_target_constant = 1 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/GeoTargetConstant" + }]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/keyword_plan_keyword.proto b/third_party/googleapis/google/ads/googleads/v2/resources/keyword_plan_keyword.proto index f4ecf0ee1..16a0858a6 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/keyword_plan_keyword.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/keyword_plan_keyword.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/keyword_match_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -35,17 +36,29 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A Keyword Plan ad group keyword. // Max number of keyword plan keywords per plan: 2500. message KeywordPlanKeyword { - // The resource name of the Keyword Plan ad group keyword. + option (google.api.resource) = { + type: "googleads.googleapis.com/KeywordPlanKeyword" + pattern: "customers/{customer}/keywordPlanKeywords/{keyword_plan_keyword}" + }; + + // Immutable. The resource name of the Keyword Plan ad group keyword. // KeywordPlanKeyword resource names have the form: // // `customers/{customer_id}/keywordPlanKeywords/{kp_ad_group_keyword_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanKeyword" + } + ]; // The Keyword Plan ad group to which this keyword belongs. - google.protobuf.StringValue keyword_plan_ad_group = 2; + google.protobuf.StringValue keyword_plan_ad_group = 2 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanAdGroup" + }]; - // The ID of the Keyword Plan keyword. - google.protobuf.Int64Value id = 3; + // Output only. The ID of the Keyword Plan keyword. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // The keyword text. google.protobuf.StringValue text = 4; diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/keyword_plan_negative_keyword.proto b/third_party/googleapis/google/ads/googleads/v2/resources/keyword_plan_negative_keyword.proto index d45bb3bcc..be7955615 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/keyword_plan_negative_keyword.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/keyword_plan_negative_keyword.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/keyword_match_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -35,17 +36,29 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A Keyword Plan negative keyword. // Max number of keyword plan negative keywords per plan: 1000. message KeywordPlanNegativeKeyword { - // The resource name of the Keyword Plan negative keyword. + option (google.api.resource) = { + type: "googleads.googleapis.com/KeywordPlanNegativeKeyword" + pattern: "customers/{customer}/keywordPlanNegativeKeywords/{keyword_plan_negative_keyword}" + }; + + // Immutable. The resource name of the Keyword Plan negative keyword. // KeywordPlanNegativeKeyword resource names have the form: // // `customers/{customer_id}/keywordPlanNegativeKeywords/{kp_negative_keyword_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanNegativeKeyword" + } + ]; // The Keyword Plan campaign to which this negative keyword belongs. - google.protobuf.StringValue keyword_plan_campaign = 2; + google.protobuf.StringValue keyword_plan_campaign = 2 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanCampaign" + }]; - // The ID of the Keyword Plan negative keyword. - google.protobuf.Int64Value id = 3; + // Output only. The ID of the Keyword Plan negative keyword. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // The keyword text. google.protobuf.StringValue text = 4; diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/keyword_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/keyword_view.proto index 9e8c2843b..b8e44b9da 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/keyword_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/keyword_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Resources"; @@ -32,9 +33,19 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A keyword view. message KeywordView { - // The resource name of the keyword view. + option (google.api.resource) = { + type: "googleads.googleapis.com/KeywordView" + pattern: "customers/{customer}/keywordViews/{keyword_view}" + }; + + // Output only. The resource name of the keyword view. // Keyword view resource names have the form: // // `customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/label.proto b/third_party/googleapis/google/ads/googleads/v2/resources/label.proto index c105e8631..b5782ac64 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/label.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/label.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/common/text_label.proto"; import "google/ads/googleads/v2/enums/label_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -33,13 +34,23 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A label. message Label { - // Name of the resource. + option (google.api.resource) = { + type: "googleads.googleapis.com/Label" + pattern: "customers/{customer}/labels/{label}" + }; + + // Immutable. Name of the resource. // Label resource names have the form: // `customers/{customer_id}/labels/{label_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Label" + } + ]; - // Id of the label. Read only. - google.protobuf.Int64Value id = 2; + // Output only. Id of the label. Read only. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; // The name of the label. // @@ -48,8 +59,8 @@ message Label { // The length of this string should be between 1 and 80, inclusive. google.protobuf.StringValue name = 3; - // Status of the label. Read only. - google.ads.googleads.v2.enums.LabelStatusEnum.LabelStatus status = 4; + // Output only. Status of the label. Read only. + google.ads.googleads.v2.enums.LabelStatusEnum.LabelStatus status = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; // A type of label displaying text on a colored background. google.ads.googleads.v2.common.TextLabel text_label = 5; diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/landing_page_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/landing_page_view.proto index 702997e57..59117a823 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/landing_page_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/landing_page_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -34,12 +35,22 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A landing page view with metrics aggregated at the unexpanded final URL // level. message LandingPageView { - // The resource name of the landing page view. + option (google.api.resource) = { + type: "googleads.googleapis.com/LandingPageView" + pattern: "customers/{customer}/landingPageViews/{landing_page_view}" + }; + + // Output only. The resource name of the landing page view. // Landing page view resource names have the form: // // `customers/{customer_id}/landingPageViews/{unexpanded_final_url_fingerprint}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/LandingPageView" + } + ]; - // The advertiser-specified final URL. - google.protobuf.StringValue unexpanded_final_url = 2; + // Output only. The advertiser-specified final URL. + google.protobuf.StringValue unexpanded_final_url = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/language_constant.proto b/third_party/googleapis/google/ads/googleads/v2/resources/language_constant.proto index 6b5f92a1c..6444fa45c 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/language_constant.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/language_constant.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -33,22 +34,32 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A language. message LanguageConstant { - // The resource name of the language constant. + option (google.api.resource) = { + type: "googleads.googleapis.com/LanguageConstant" + pattern: "languageConstants/{language_constant}" + }; + + // Output only. The resource name of the language constant. // Language constant resource names have the form: // // `languageConstants/{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/LanguageConstant" + } + ]; - // The ID of the language constant. - google.protobuf.Int64Value id = 2; + // Output only. The ID of the language constant. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The language code, e.g. "en_US", "en_AU", "es", "fr", etc. - google.protobuf.StringValue code = 3; + // Output only. The language code, e.g. "en_US", "en_AU", "es", "fr", etc. + google.protobuf.StringValue code = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The full name of the language in English, e.g., "English (US)", "Spanish", + // Output only. The full name of the language in English, e.g., "English (US)", "Spanish", // etc. - google.protobuf.StringValue name = 4; + google.protobuf.StringValue name = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Whether the language is targetable. - google.protobuf.BoolValue targetable = 5; + // Output only. Whether the language is targetable. + google.protobuf.BoolValue targetable = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/location_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/location_view.proto index 56bf76fa7..65c8e1126 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/location_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/location_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Resources"; @@ -33,9 +34,19 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A location view summarizes the performance of campaigns by // Location criteria. message LocationView { - // The resource name of the location view. + option (google.api.resource) = { + type: "googleads.googleapis.com/LocationView" + pattern: "customers/{customer}/locationViews/{location_view}" + }; + + // Output only. The resource name of the location view. // Location view resource names have the form: // // `customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/LocationView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/managed_placement_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/managed_placement_view.proto index b28b8326c..d3e4bda08 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/managed_placement_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/managed_placement_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Resources"; @@ -32,9 +33,19 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A managed placement view. message ManagedPlacementView { - // The resource name of the Managed Placement view. + option (google.api.resource) = { + type: "googleads.googleapis.com/ManagedPlacementView" + pattern: "customers/{customer}/managedPlacementViews/{managed_placement_view}" + }; + + // Output only. The resource name of the Managed Placement view. // Managed placement view resource names have the form: // // `customers/{customer_id}/managedPlacementViews/{ad_group_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ManagedPlacementView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/media_file.proto b/third_party/googleapis/google/ads/googleads/v2/resources/media_file.proto index 476923b5c..215cdce0c 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/media_file.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/media_file.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/media_type.proto"; import "google/ads/googleads/v2/enums/mime_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -35,80 +36,90 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A media file. message MediaFile { - // The resource name of the media file. + option (google.api.resource) = { + type: "googleads.googleapis.com/MediaFile" + pattern: "customers/{customer}/mediaFiles/{media_file}" + }; + + // Immutable. The resource name of the media file. // Media file resource names have the form: // // `customers/{customer_id}/mediaFiles/{media_file_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MediaFile" + } + ]; - // The ID of the media file. - google.protobuf.Int64Value id = 2; + // Output only. The ID of the media file. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Type of the media file. - google.ads.googleads.v2.enums.MediaTypeEnum.MediaType type = 5; + // Immutable. Type of the media file. + google.ads.googleads.v2.enums.MediaTypeEnum.MediaType type = 5 [(google.api.field_behavior) = IMMUTABLE]; - // The mime type of the media file. - google.ads.googleads.v2.enums.MimeTypeEnum.MimeType mime_type = 6; + // Output only. The mime type of the media file. + google.ads.googleads.v2.enums.MimeTypeEnum.MimeType mime_type = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The URL of where the original media file was downloaded from (or a file + // Immutable. The URL of where the original media file was downloaded from (or a file // name). Only used for media of type AUDIO and IMAGE. - google.protobuf.StringValue source_url = 7; + google.protobuf.StringValue source_url = 7 [(google.api.field_behavior) = IMMUTABLE]; - // The name of the media file. The name can be used by clients to help + // Immutable. The name of the media file. The name can be used by clients to help // identify previously uploaded media. - google.protobuf.StringValue name = 8; + google.protobuf.StringValue name = 8 [(google.api.field_behavior) = IMMUTABLE]; - // The size of the media file in bytes. - google.protobuf.Int64Value file_size = 9; + // Output only. The size of the media file in bytes. + google.protobuf.Int64Value file_size = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; // The specific type of the media file. oneof mediatype { - // Encapsulates an Image. - MediaImage image = 3; + // Immutable. Encapsulates an Image. + MediaImage image = 3 [(google.api.field_behavior) = IMMUTABLE]; - // A ZIP archive media the content of which contains HTML5 assets. - MediaBundle media_bundle = 4; + // Immutable. A ZIP archive media the content of which contains HTML5 assets. + MediaBundle media_bundle = 4 [(google.api.field_behavior) = IMMUTABLE]; - // Encapsulates an Audio. - MediaAudio audio = 10; + // Output only. Encapsulates an Audio. + MediaAudio audio = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Encapsulates a Video. - MediaVideo video = 11; + // Immutable. Encapsulates a Video. + MediaVideo video = 11 [(google.api.field_behavior) = IMMUTABLE]; } } // Encapsulates an Image. message MediaImage { - // Raw image data. - google.protobuf.BytesValue data = 1; + // Immutable. Raw image data. + google.protobuf.BytesValue data = 1 [(google.api.field_behavior) = IMMUTABLE]; } // Represents a ZIP archive media the content of which contains HTML5 assets. message MediaBundle { - // Raw zipped data. - google.protobuf.BytesValue data = 1; + // Immutable. Raw zipped data. + google.protobuf.BytesValue data = 1 [(google.api.field_behavior) = IMMUTABLE]; } // Encapsulates an Audio. message MediaAudio { - // The duration of the Audio in milliseconds. - google.protobuf.Int64Value ad_duration_millis = 1; + // Output only. The duration of the Audio in milliseconds. + google.protobuf.Int64Value ad_duration_millis = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Encapsulates a Video. message MediaVideo { - // The duration of the Video in milliseconds. - google.protobuf.Int64Value ad_duration_millis = 1; + // Output only. The duration of the Video in milliseconds. + google.protobuf.Int64Value ad_duration_millis = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The YouTube video ID (as seen in YouTube URLs). - google.protobuf.StringValue youtube_video_id = 2; + // Immutable. The YouTube video ID (as seen in YouTube URLs). + google.protobuf.StringValue youtube_video_id = 2 [(google.api.field_behavior) = IMMUTABLE]; - // The Advertising Digital Identification code for this video, as defined by + // Output only. The Advertising Digital Identification code for this video, as defined by // the American Association of Advertising Agencies, used mainly for // television commercials. - google.protobuf.StringValue advertising_id_code = 3; + google.protobuf.StringValue advertising_id_code = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The Industry Standard Commercial Identifier code for this video, used + // Output only. The Industry Standard Commercial Identifier code for this video, used // mainly for television commercials. - google.protobuf.StringValue isci_code = 4; + google.protobuf.StringValue isci_code = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/merchant_center_link.proto b/third_party/googleapis/google/ads/googleads/v2/resources/merchant_center_link.proto index f94b6196c..49f61d3ea 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/merchant_center_link.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/merchant_center_link.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/merchant_center_link_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -35,19 +36,29 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A data sharing connection, proposed or in use, // between a Google Ads Customer and a Merchant Center account. message MerchantCenterLink { - // The resource name of the merchant center link. + option (google.api.resource) = { + type: "googleads.googleapis.com/MerchantCenterLink" + pattern: "customers/{customer}/merchantCenterLinks/{merchant_center_link}" + }; + + // Immutable. The resource name of the merchant center link. // Merchant center link resource names have the form: // // `customers/{customer_id}/merchantCenterLinks/{merchant_center_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MerchantCenterLink" + } + ]; - // The ID of the Merchant Center account. + // Output only. The ID of the Merchant Center account. // This field is readonly. - google.protobuf.Int64Value id = 3; + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The name of the Merchant Center account. + // Output only. The name of the Merchant Center account. // This field is readonly. - google.protobuf.StringValue merchant_center_account_name = 4; + google.protobuf.StringValue merchant_center_account_name = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; // The status of the link. google.ads.googleads.v2.enums.MerchantCenterLinkStatusEnum.MerchantCenterLinkStatus status = 5; diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/mobile_app_category_constant.proto b/third_party/googleapis/google/ads/googleads/v2/resources/mobile_app_category_constant.proto index b33e32a9d..c9f15eb8b 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/mobile_app_category_constant.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/mobile_app_category_constant.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -33,15 +34,25 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A mobile application category constant. message MobileAppCategoryConstant { - // The resource name of the mobile app category constant. + option (google.api.resource) = { + type: "googleads.googleapis.com/MobileAppCategoryConstant" + pattern: "mobileAppCategoryConstants/{mobile_app_category_constant}" + }; + + // Output only. The resource name of the mobile app category constant. // Mobile app category constant resource names have the form: // // `mobileAppCategoryConstants/{mobile_app_category_id}` - string resource_name = 1; - - // The ID of the mobile app category constant. - google.protobuf.Int32Value id = 2; - - // Mobile app category name. - google.protobuf.StringValue name = 3; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MobileAppCategoryConstant" + } + ]; + + // Output only. The ID of the mobile app category constant. + google.protobuf.Int32Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Mobile app category name. + google.protobuf.StringValue name = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/mobile_device_constant.proto b/third_party/googleapis/google/ads/googleads/v2/resources/mobile_device_constant.proto index 5050f4d78..4c83d2341 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/mobile_device_constant.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/mobile_device_constant.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/mobile_device_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -34,24 +35,34 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A mobile device constant. message MobileDeviceConstant { - // The resource name of the mobile device constant. + option (google.api.resource) = { + type: "googleads.googleapis.com/MobileDeviceConstant" + pattern: "mobileDeviceConstants/{mobile_device_constant}" + }; + + // Output only. The resource name of the mobile device constant. // Mobile device constant resource names have the form: // // `mobileDeviceConstants/{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MobileDeviceConstant" + } + ]; - // The ID of the mobile device constant. - google.protobuf.Int64Value id = 2; + // Output only. The ID of the mobile device constant. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The name of the mobile device. - google.protobuf.StringValue name = 3; + // Output only. The name of the mobile device. + google.protobuf.StringValue name = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The manufacturer of the mobile device. - google.protobuf.StringValue manufacturer_name = 4; + // Output only. The manufacturer of the mobile device. + google.protobuf.StringValue manufacturer_name = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The operating system of the mobile device. - google.protobuf.StringValue operating_system_name = 5; + // Output only. The operating system of the mobile device. + google.protobuf.StringValue operating_system_name = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The type of mobile device. - google.ads.googleads.v2.enums.MobileDeviceTypeEnum.MobileDeviceType type = 6; + // Output only. The type of mobile device. + google.ads.googleads.v2.enums.MobileDeviceTypeEnum.MobileDeviceType type = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/mutate_job.proto b/third_party/googleapis/google/ads/googleads/v2/resources/mutate_job.proto index abb48467a..7546dd618 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/mutate_job.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/mutate_job.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/mutate_job_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -33,52 +34,62 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // Proto file describing the mutate job resource. // A list of mutates being processed asynchronously. The mutates are uploaded -// by the user. The mutates themselves aren’t readable and the results of the +// by the user. The mutates themselves aren't readable and the results of the // job can only be read using MutateJobService.ListMutateJobResults. message MutateJob { + option (google.api.resource) = { + type: "googleads.googleapis.com/MutateJob" + pattern: "customers/{customer}/mutateJobs/{mutate_job}" + }; + // Additional information about the mutate job. This message is also used as // metadata returned in mutate job Long Running Operations. message MutateJobMetadata { - // The time when this mutate job was created. + // Output only. The time when this mutate job was created. // Formatted as yyyy-mm-dd hh:mm:ss. Example: "2018-03-05 09:15:00" - google.protobuf.StringValue creation_date_time = 1; + google.protobuf.StringValue creation_date_time = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The time when this mutate job was completed. + // Output only. The time when this mutate job was completed. // Formatted as yyyy-MM-dd HH:mm:ss. Example: "2018-03-05 09:16:00" - google.protobuf.StringValue completion_date_time = 2; + google.protobuf.StringValue completion_date_time = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The fraction (between 0.0 and 1.0) of mutates that have been processed. + // Output only. The fraction (between 0.0 and 1.0) of mutates that have been processed. // This is empty if the job hasn't started running yet. - google.protobuf.DoubleValue estimated_completion_ratio = 3; + google.protobuf.DoubleValue estimated_completion_ratio = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The number of mutate operations in the mutate job. - google.protobuf.Int64Value operation_count = 4; + // Output only. The number of mutate operations in the mutate job. + google.protobuf.Int64Value operation_count = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The number of mutate operations executed by the mutate job. + // Output only. The number of mutate operations executed by the mutate job. // Present only if the job has started running. - google.protobuf.Int64Value executed_operation_count = 5; + google.protobuf.Int64Value executed_operation_count = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; } - // The resource name of the mutate job. + // Immutable. The resource name of the mutate job. // Mutate job resource names have the form: // // `customers/{customer_id}/mutateJobs/{mutate_job_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MutateJob" + } + ]; - // ID of this mutate job. - google.protobuf.Int64Value id = 2; + // Output only. ID of this mutate job. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The next sequence token to use when adding operations. Only set when the + // Output only. The next sequence token to use when adding operations. Only set when the // mutate job status is PENDING. - google.protobuf.StringValue next_add_sequence_token = 3; + google.protobuf.StringValue next_add_sequence_token = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Contains additional information about this mutate job. - MutateJobMetadata metadata = 4; + // Output only. Contains additional information about this mutate job. + MutateJobMetadata metadata = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Status of this mutate job. - google.ads.googleads.v2.enums.MutateJobStatusEnum.MutateJobStatus status = 5; + // Output only. Status of this mutate job. + google.ads.googleads.v2.enums.MutateJobStatusEnum.MutateJobStatus status = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The resource name of the long-running operation that can be used to poll + // Output only. The resource name of the long-running operation that can be used to poll // for completion. Only set when the mutate job status is RUNNING or DONE. - google.protobuf.StringValue long_running_operation = 6; + google.protobuf.StringValue long_running_operation = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/operating_system_version_constant.proto b/third_party/googleapis/google/ads/googleads/v2/resources/operating_system_version_constant.proto index ef484b58a..1c8e49483 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/operating_system_version_constant.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/operating_system_version_constant.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/operating_system_version_operator_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -36,25 +37,35 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // `operator_type`. List of available mobile platforms at // https://developers.google.com/adwords/api/docs/appendix/codes-formats#mobile-platforms message OperatingSystemVersionConstant { - // The resource name of the operating system version constant. + option (google.api.resource) = { + type: "googleads.googleapis.com/OperatingSystemVersionConstant" + pattern: "operatingSystemVersionConstants/{operating_system_version_constant}" + }; + + // Output only. The resource name of the operating system version constant. // Operating system version constant resource names have the form: // // `operatingSystemVersionConstants/{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/OperatingSystemVersionConstant" + } + ]; - // The ID of the operating system version. - google.protobuf.Int64Value id = 2; + // Output only. The ID of the operating system version. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Name of the operating system. - google.protobuf.StringValue name = 3; + // Output only. Name of the operating system. + google.protobuf.StringValue name = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The OS Major Version number. - google.protobuf.Int32Value os_major_version = 4; + // Output only. The OS Major Version number. + google.protobuf.Int32Value os_major_version = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The OS Minor Version number. - google.protobuf.Int32Value os_minor_version = 5; + // Output only. The OS Minor Version number. + google.protobuf.Int32Value os_minor_version = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Determines whether this constant represents a single version or a range of + // Output only. Determines whether this constant represents a single version or a range of // versions. - google.ads.googleads.v2.enums.OperatingSystemVersionOperatorTypeEnum.OperatingSystemVersionOperatorType operator_type = 6; + google.ads.googleads.v2.enums.OperatingSystemVersionOperatorTypeEnum.OperatingSystemVersionOperatorType operator_type = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/paid_organic_search_term_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/paid_organic_search_term_view.proto index 4569dc206..2b24d6d1e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/paid_organic_search_term_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/paid_organic_search_term_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -34,13 +35,23 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A paid organic search term view providing a view of search stats across // ads and organic listings aggregated by search term at the ad group level. message PaidOrganicSearchTermView { - // The resource name of the search term view. + option (google.api.resource) = { + type: "googleads.googleapis.com/PaidOrganicSearchTermView" + pattern: "customers/{customer}/paidOrganicSearchTermViews/{paid_organic_search_term_view}" + }; + + // Output only. The resource name of the search term view. // Search term view resource names have the form: // // `customers/{customer_id}/paidOrganicSearchTermViews/{campaign_id}~ // {ad_group_id}~{URL-base64 search term}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/PaidOrganicSearchTermView" + } + ]; - // The search term. - google.protobuf.StringValue search_term = 2; + // Output only. The search term. + google.protobuf.StringValue search_term = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/parental_status_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/parental_status_view.proto index a189d18a9..7f4d36bc2 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/parental_status_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/parental_status_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Resources"; @@ -32,9 +33,19 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A parental status view. message ParentalStatusView { - // The resource name of the parental status view. + option (google.api.resource) = { + type: "googleads.googleapis.com/ParentalStatusView" + pattern: "customers/{customer}/parentalStatusViews/{parental_status_view}" + }; + + // Output only. The resource name of the parental status view. // Parental Status view resource names have the form: // // `customers/{customer_id}/parentalStatusViews/{ad_group_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ParentalStatusView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/payments_account.proto b/third_party/googleapis/google/ads/googleads/v2/resources/payments_account.proto index ecabea6ef..96e7c1396 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/payments_account.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/payments_account.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -31,30 +32,40 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // Proto file describing the PaymentsAccount resource. -// A Payments account, which can be used to set up billing for an Ads customer. +// A payments account, which can be used to set up billing for an Ads customer. message PaymentsAccount { - // The resource name of the Payments account. + option (google.api.resource) = { + type: "googleads.googleapis.com/PaymentsAccount" + pattern: "customers/{customer}/paymentsAccounts/{payments_account}" + }; + + // Output only. The resource name of the payments account. // PaymentsAccount resource names have the form: // // `customers/{customer_id}/paymentsAccounts/{payments_account_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/PaymentsAccount" + } + ]; - // A 16 digit ID used to identify a Payments account. - google.protobuf.StringValue payments_account_id = 2; + // Output only. A 16 digit ID used to identify a payments account. + google.protobuf.StringValue payments_account_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The name of the Payments account. - google.protobuf.StringValue name = 3; + // Output only. The name of the payments account. + google.protobuf.StringValue name = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The currency code of the Payments account. + // Output only. The currency code of the payments account. // A subset of the currency codes derived from the ISO 4217 standard is // supported. - google.protobuf.StringValue currency_code = 4; + google.protobuf.StringValue currency_code = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // A 12 digit ID used to identify the Payments profile associated with the - // Payments account. - google.protobuf.StringValue payments_profile_id = 5; + // Output only. A 12 digit ID used to identify the payments profile associated with the + // payments account. + google.protobuf.StringValue payments_profile_id = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // A secondary Payments profile ID present in uncommon situations, e.g. + // Output only. A secondary payments profile ID present in uncommon situations, e.g. // when a sequential liability agreement has been arranged. - google.protobuf.StringValue secondary_payments_profile_id = 6; + google.protobuf.StringValue secondary_payments_profile_id = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/product_bidding_category_constant.proto b/third_party/googleapis/google/ads/googleads/v2/resources/product_bidding_category_constant.proto index 3cdc323a5..06a261897 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/product_bidding_category_constant.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/product_bidding_category_constant.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/product_bidding_category_level.proto"; import "google/ads/googleads/v2/enums/product_bidding_category_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -35,34 +36,49 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A Product Bidding Category. message ProductBiddingCategoryConstant { - // The resource name of the product bidding category. + option (google.api.resource) = { + type: "googleads.googleapis.com/ProductBiddingCategoryConstant" + pattern: "productBiddingCategoryConstants/{product_bidding_category_constant}" + }; + + // Output only. The resource name of the product bidding category. // Product bidding category resource names have the form: // // `productBiddingCategoryConstants/{country_code}~{level}~{id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ProductBiddingCategoryConstant" + } + ]; - // ID of the product bidding category. + // Output only. ID of the product bidding category. // // This ID is equivalent to the google_product_category ID as described in // this article: https://support.google.com/merchants/answer/6324436. - google.protobuf.Int64Value id = 2; + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Two-letter upper-case country code of the product bidding category. - google.protobuf.StringValue country_code = 3; + // Output only. Two-letter upper-case country code of the product bidding category. + google.protobuf.StringValue country_code = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Resource name of the parent product bidding category. - google.protobuf.StringValue product_bidding_category_constant_parent = 4; + // Output only. Resource name of the parent product bidding category. + google.protobuf.StringValue product_bidding_category_constant_parent = 4 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ProductBiddingCategoryConstant" + } + ]; - // Level of the product bidding category. - google.ads.googleads.v2.enums.ProductBiddingCategoryLevelEnum.ProductBiddingCategoryLevel level = 5; + // Output only. Level of the product bidding category. + google.ads.googleads.v2.enums.ProductBiddingCategoryLevelEnum.ProductBiddingCategoryLevel level = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Status of the product bidding category. - google.ads.googleads.v2.enums.ProductBiddingCategoryStatusEnum.ProductBiddingCategoryStatus status = 6; + // Output only. Status of the product bidding category. + google.ads.googleads.v2.enums.ProductBiddingCategoryStatusEnum.ProductBiddingCategoryStatus status = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Language code of the product bidding category. - google.protobuf.StringValue language_code = 7; + // Output only. Language code of the product bidding category. + google.protobuf.StringValue language_code = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Display value of the product bidding category localized according to + // Output only. Display value of the product bidding category localized according to // language_code. - google.protobuf.StringValue localized_name = 8; + google.protobuf.StringValue localized_name = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/product_group_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/product_group_view.proto index d9965d327..9d02f20ab 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/product_group_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/product_group_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Resources"; @@ -32,9 +33,19 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A product group view. message ProductGroupView { - // The resource name of the product group view. + option (google.api.resource) = { + type: "googleads.googleapis.com/ProductGroupView" + pattern: "customers/{customer}/productGroupViews/{product_group_view}" + }; + + // Output only. The resource name of the product group view. // Product group view resource names have the form: // // `customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ProductGroupView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/recommendation.proto b/third_party/googleapis/google/ads/googleads/v2/resources/recommendation.proto index 55f7b56b3..bebd708b1 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/recommendation.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/recommendation.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -23,6 +22,8 @@ import "google/ads/googleads/v2/enums/keyword_match_type.proto"; import "google/ads/googleads/v2/enums/recommendation_type.proto"; import "google/ads/googleads/v2/enums/target_cpa_opt_in_recommendation_goal.proto"; import "google/ads/googleads/v2/resources/ad.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -39,128 +40,155 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A recommendation. message Recommendation { + option (google.api.resource) = { + type: "googleads.googleapis.com/Recommendation" + pattern: "customers/{customer}/recommendations/{recommendation}" + }; + // The impact of making the change as described in the recommendation. // Some types of recommendations may not have impact information. message RecommendationImpact { - // Base metrics at the time the recommendation was generated. - RecommendationMetrics base_metrics = 1; + // Output only. Base metrics at the time the recommendation was generated. + RecommendationMetrics base_metrics = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Estimated metrics if the recommendation is applied. - RecommendationMetrics potential_metrics = 2; + // Output only. Estimated metrics if the recommendation is applied. + RecommendationMetrics potential_metrics = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Weekly account performance metrics. For some recommendation types, these // are averaged over the past 90-day period and hence can be fractional. message RecommendationMetrics { - // Number of ad impressions. - google.protobuf.DoubleValue impressions = 1; + // Output only. Number of ad impressions. + google.protobuf.DoubleValue impressions = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Number of ad clicks. - google.protobuf.DoubleValue clicks = 2; + // Output only. Number of ad clicks. + google.protobuf.DoubleValue clicks = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Cost (in micros) for advertising, in the local currency for the account. - google.protobuf.Int64Value cost_micros = 3; + // Output only. Cost (in micros) for advertising, in the local currency for the account. + google.protobuf.Int64Value cost_micros = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Number of conversions. - google.protobuf.DoubleValue conversions = 4; + // Output only. Number of conversions. + google.protobuf.DoubleValue conversions = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Number of video views for a video ad campaign. - google.protobuf.DoubleValue video_views = 5; + // Output only. Number of video views for a video ad campaign. + google.protobuf.DoubleValue video_views = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The budget recommendation for budget constrained campaigns. message CampaignBudgetRecommendation { // The impact estimates for a given budget amount. message CampaignBudgetRecommendationOption { - // The budget amount for this option. - google.protobuf.Int64Value budget_amount_micros = 1; + // Output only. The budget amount for this option. + google.protobuf.Int64Value budget_amount_micros = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The impact estimate if budget is changed to amount specified in this + // Output only. The impact estimate if budget is changed to amount specified in this // option. - RecommendationImpact impact = 2; + RecommendationImpact impact = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } - // The current budget amount in micros. - google.protobuf.Int64Value current_budget_amount_micros = 1; + // Output only. The current budget amount in micros. + google.protobuf.Int64Value current_budget_amount_micros = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The recommended budget amount in micros. - google.protobuf.Int64Value recommended_budget_amount_micros = 2; + // Output only. The recommended budget amount in micros. + google.protobuf.Int64Value recommended_budget_amount_micros = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The budget amounts and associated impact estimates for some values of + // Output only. The budget amounts and associated impact estimates for some values of // possible budget amounts. - repeated CampaignBudgetRecommendationOption budget_options = 3; + repeated CampaignBudgetRecommendationOption budget_options = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The keyword recommendation. message KeywordRecommendation { - // The recommended keyword. - google.ads.googleads.v2.common.KeywordInfo keyword = 1; - - // The recommended CPC (cost-per-click) bid. - google.protobuf.Int64Value recommended_cpc_bid_micros = 2; - } - - // The Optimize Ad Rotation recommendation. - message OptimizeAdRotationRecommendation { + // Output only. The recommended keyword. + google.ads.googleads.v2.common.KeywordInfo keyword = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + // Output only. The recommended CPC (cost-per-click) bid. + google.protobuf.Int64Value recommended_cpc_bid_micros = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The move unused budget recommendation. message MoveUnusedBudgetRecommendation { - // The excess budget's resource_name. - google.protobuf.StringValue excess_campaign_budget = 1; + // Output only. The excess budget's resource_name. + google.protobuf.StringValue excess_campaign_budget = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The recommendation for the constrained budget to increase. - CampaignBudgetRecommendation budget_recommendation = 2; + // Output only. The recommendation for the constrained budget to increase. + CampaignBudgetRecommendation budget_recommendation = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The text ad recommendation. message TextAdRecommendation { - // Recommended ad. - Ad ad = 1; + // Output only. Recommended ad. + Ad ad = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Creation date of the recommended ad. + // Output only. Creation date of the recommended ad. // YYYY-MM-DD format, e.g., 2018-04-17. - google.protobuf.StringValue creation_date = 2; + google.protobuf.StringValue creation_date = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Date, if present, is the earliest when the recommendation will be auto + // Output only. Date, if present, is the earliest when the recommendation will be auto // applied. // YYYY-MM-DD format, e.g., 2018-04-17. - google.protobuf.StringValue auto_apply_date = 3; + google.protobuf.StringValue auto_apply_date = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // The Search Partners Opt-In recommendation. + message SearchPartnersOptInRecommendation { + + } + + // The Maximize Clicks opt-in recommendation. + message MaximizeClicksOptInRecommendation { + // Output only. The recommended new budget amount. + // Only set if the current budget is too high. + google.protobuf.Int64Value recommended_budget_amount_micros = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // The Call extension recommendation. + message CallExtensionRecommendation { + // Output only. Call extensions recommended to be added. + repeated google.ads.googleads.v2.common.CallFeedItem recommended_extensions = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The Target CPA opt-in recommendation. message TargetCpaOptInRecommendation { // The Target CPA opt-in option with impact estimate. message TargetCpaOptInRecommendationOption { - // The goal achieved by this option. - google.ads.googleads.v2.enums.TargetCpaOptInRecommendationGoalEnum.TargetCpaOptInRecommendationGoal goal = 1; + // Output only. The goal achieved by this option. + google.ads.googleads.v2.enums.TargetCpaOptInRecommendationGoalEnum.TargetCpaOptInRecommendationGoal goal = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Average CPA target. - google.protobuf.Int64Value target_cpa_micros = 2; + // Output only. Average CPA target. + google.protobuf.Int64Value target_cpa_micros = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The minimum campaign budget, in local currency for the account, + // Output only. The minimum campaign budget, in local currency for the account, // required to achieve the target CPA. // Amount is specified in micros, where one million is equivalent to one // currency unit. - google.protobuf.Int64Value required_campaign_budget_amount_micros = 3; + google.protobuf.Int64Value required_campaign_budget_amount_micros = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The impact estimate if this option is selected. - RecommendationImpact impact = 4; + // Output only. The impact estimate if this option is selected. + RecommendationImpact impact = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; } - // The available goals and corresponding options for Target CPA strategy. - repeated TargetCpaOptInRecommendationOption options = 1; + // Output only. The available goals and corresponding options for Target CPA strategy. + repeated TargetCpaOptInRecommendationOption options = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The recommended average CPA target. See required budget amount and impact + // Output only. The recommended average CPA target. See required budget amount and impact // of using this recommendation in options list. - google.protobuf.Int64Value recommended_target_cpa_micros = 2; + google.protobuf.Int64Value recommended_target_cpa_micros = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // The keyword match type recommendation. + message KeywordMatchTypeRecommendation { + // Output only. The existing keyword where the match type should be more broad. + google.ads.googleads.v2.common.KeywordInfo keyword = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The recommended new match type. + google.ads.googleads.v2.enums.KeywordMatchTypeEnum.KeywordMatchType recommended_match_type = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The Maximize Conversions Opt-In recommendation. message MaximizeConversionsOptInRecommendation { - // The recommended new budget amount. - google.protobuf.Int64Value recommended_budget_amount_micros = 1; + // Output only. The recommended new budget amount. + google.protobuf.Int64Value recommended_budget_amount_micros = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The Enhanced Cost-Per-Click Opt-In recommendation. @@ -168,65 +196,53 @@ message Recommendation { } - // The Callout extension recommendation. - message CalloutExtensionRecommendation { - // Callout extensions recommended to be added. - repeated google.ads.googleads.v2.common.CalloutFeedItem recommended_extensions = 1; - } - - // The keyword match type recommendation. - message KeywordMatchTypeRecommendation { - // The existing keyword where the match type should be more broad. - google.ads.googleads.v2.common.KeywordInfo keyword = 1; - - // The recommended new match type. - google.ads.googleads.v2.enums.KeywordMatchTypeEnum.KeywordMatchType recommended_match_type = 2; - } - - // The Search Partners Opt-In recommendation. - message SearchPartnersOptInRecommendation { + // The Optimize Ad Rotation recommendation. + message OptimizeAdRotationRecommendation { } - // The Maximize Clicks opt-in recommendation. - message MaximizeClicksOptInRecommendation { - // The recommended new budget amount. - // Only set if the current budget is too high. - google.protobuf.Int64Value recommended_budget_amount_micros = 1; + // The Callout extension recommendation. + message CalloutExtensionRecommendation { + // Output only. Callout extensions recommended to be added. + repeated google.ads.googleads.v2.common.CalloutFeedItem recommended_extensions = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The Sitelink extension recommendation. message SitelinkExtensionRecommendation { - // Sitelink extensions recommended to be added. - repeated google.ads.googleads.v2.common.SitelinkFeedItem recommended_extensions = 1; + // Output only. Sitelink extensions recommended to be added. + repeated google.ads.googleads.v2.common.SitelinkFeedItem recommended_extensions = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; } - // The Call extension recommendation. - message CallExtensionRecommendation { - // Call extensions recommended to be added. - repeated google.ads.googleads.v2.common.CallFeedItem recommended_extensions = 1; - } - - // The resource name of the recommendation. + // Immutable. The resource name of the recommendation. // // `customers/{customer_id}/recommendations/{recommendation_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Recommendation" + } + ]; - // The type of recommendation. - google.ads.googleads.v2.enums.RecommendationTypeEnum.RecommendationType type = 2; + // Output only. The type of recommendation. + google.ads.googleads.v2.enums.RecommendationTypeEnum.RecommendationType type = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The impact on account performance as a result of applying the + // Output only. The impact on account performance as a result of applying the // recommendation. - RecommendationImpact impact = 3; + RecommendationImpact impact = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The budget targeted by this recommendation. This will be set only when + // Output only. The budget targeted by this recommendation. This will be set only when // the recommendation affects a single campaign budget. // // This field will be set for the following recommendation types: // CAMPAIGN_BUDGET, MOVE_UNUSED_BUDGET - google.protobuf.StringValue campaign_budget = 5; + google.protobuf.StringValue campaign_budget = 5 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignBudget" + } + ]; - // The campaign targeted by this recommendation. This will be set only when + // Output only. The campaign targeted by this recommendation. This will be set only when // the recommendation affects a single campaign. // // This field will be set for the following recommendation types: @@ -234,60 +250,70 @@ message Recommendation { // KEYWORD_MATCH_TYPE, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, // OPTIMIZE_AD_ROTATION, SEARCH_PARTNERS_OPT_IN, SITELINK_EXTENSION, // TARGET_CPA_OPT_IN, TEXT_AD - google.protobuf.StringValue campaign = 6; + google.protobuf.StringValue campaign = 6 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; - // The ad group targeted by this recommendation. This will be set only when + // Output only. The ad group targeted by this recommendation. This will be set only when // the recommendation affects a single ad group. // // This field will be set for the following recommendation types: // KEYWORD, OPTIMIZE_AD_ROTATION, TEXT_AD - google.protobuf.StringValue ad_group = 7; + google.protobuf.StringValue ad_group = 7 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; - // Whether the recommendation is dismissed or not. - google.protobuf.BoolValue dismissed = 13; + // Output only. Whether the recommendation is dismissed or not. + google.protobuf.BoolValue dismissed = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; // The details of recommendation. oneof recommendation { - // The campaign budget recommendation. - CampaignBudgetRecommendation campaign_budget_recommendation = 4; + // Output only. The campaign budget recommendation. + CampaignBudgetRecommendation campaign_budget_recommendation = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The keyword recommendation. - KeywordRecommendation keyword_recommendation = 8; + // Output only. The keyword recommendation. + KeywordRecommendation keyword_recommendation = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Add expanded text ad recommendation. - TextAdRecommendation text_ad_recommendation = 9; + // Output only. Add expanded text ad recommendation. + TextAdRecommendation text_ad_recommendation = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The TargetCPA opt-in recommendation. - TargetCpaOptInRecommendation target_cpa_opt_in_recommendation = 10; + // Output only. The TargetCPA opt-in recommendation. + TargetCpaOptInRecommendation target_cpa_opt_in_recommendation = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The MaximizeConversions Opt-In recommendation. - MaximizeConversionsOptInRecommendation maximize_conversions_opt_in_recommendation = 11; + // Output only. The MaximizeConversions Opt-In recommendation. + MaximizeConversionsOptInRecommendation maximize_conversions_opt_in_recommendation = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The Enhanced Cost-Per-Click Opt-In recommendation. - EnhancedCpcOptInRecommendation enhanced_cpc_opt_in_recommendation = 12; + // Output only. The Enhanced Cost-Per-Click Opt-In recommendation. + EnhancedCpcOptInRecommendation enhanced_cpc_opt_in_recommendation = 12 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The Search Partners Opt-In recommendation. - SearchPartnersOptInRecommendation search_partners_opt_in_recommendation = 14; + // Output only. The Search Partners Opt-In recommendation. + SearchPartnersOptInRecommendation search_partners_opt_in_recommendation = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The MaximizeClicks Opt-In recommendation. - MaximizeClicksOptInRecommendation maximize_clicks_opt_in_recommendation = 15; + // Output only. The MaximizeClicks Opt-In recommendation. + MaximizeClicksOptInRecommendation maximize_clicks_opt_in_recommendation = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The Optimize Ad Rotation recommendation. - OptimizeAdRotationRecommendation optimize_ad_rotation_recommendation = 16; + // Output only. The Optimize Ad Rotation recommendation. + OptimizeAdRotationRecommendation optimize_ad_rotation_recommendation = 16 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The Callout extension recommendation. - CalloutExtensionRecommendation callout_extension_recommendation = 17; + // Output only. The Callout extension recommendation. + CalloutExtensionRecommendation callout_extension_recommendation = 17 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The Sitelink extension recommendation. - SitelinkExtensionRecommendation sitelink_extension_recommendation = 18; + // Output only. The Sitelink extension recommendation. + SitelinkExtensionRecommendation sitelink_extension_recommendation = 18 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The Call extension recommendation. - CallExtensionRecommendation call_extension_recommendation = 19; + // Output only. The Call extension recommendation. + CallExtensionRecommendation call_extension_recommendation = 19 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The keyword match type recommendation. - KeywordMatchTypeRecommendation keyword_match_type_recommendation = 20; + // Output only. The keyword match type recommendation. + KeywordMatchTypeRecommendation keyword_match_type_recommendation = 20 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The move unused budget recommendation. - MoveUnusedBudgetRecommendation move_unused_budget_recommendation = 21; + // Output only. The move unused budget recommendation. + MoveUnusedBudgetRecommendation move_unused_budget_recommendation = 21 [(google.api.field_behavior) = OUTPUT_ONLY]; } } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/remarketing_action.proto b/third_party/googleapis/google/ads/googleads/v2/resources/remarketing_action.proto index b5f30a8db..f055fecee 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/remarketing_action.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/remarketing_action.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/common/tag_snippet.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -36,14 +37,24 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // product id and the type of page people visited (product page, shopping cart // page, purchase page, general site visit) on an advertiser's website. message RemarketingAction { - // The resource name of the remarketing action. + option (google.api.resource) = { + type: "googleads.googleapis.com/RemarketingAction" + pattern: "customers/{customer}/remarketingActions/{remarketing_action}" + }; + + // Immutable. The resource name of the remarketing action. // Remarketing action resource names have the form: // // `customers/{customer_id}/remarketingActions/{remarketing_action_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/RemarketingAction" + } + ]; - // Id of the remarketing action. - google.protobuf.Int64Value id = 2; + // Output only. Id of the remarketing action. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; // The name of the remarketing action. // @@ -51,6 +62,6 @@ message RemarketingAction { // remarketing actions. google.protobuf.StringValue name = 3; - // The snippets used for tracking remarketing actions. - repeated google.ads.googleads.v2.common.TagSnippet tag_snippets = 4; + // Output only. The snippets used for tracking remarketing actions. + repeated google.ads.googleads.v2.common.TagSnippet tag_snippets = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/search_term_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/search_term_view.proto index bbeb1f97e..0ffc45dc6 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/search_term_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/search_term_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/search_term_targeting_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -35,19 +36,34 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A search term view with metrics aggregated by search term at the ad group // level. message SearchTermView { - // The resource name of the search term view. + option (google.api.resource) = { + type: "googleads.googleapis.com/SearchTermView" + pattern: "customers/{customer}/searchTermViews/{search_term_view}" + }; + + // Output only. The resource name of the search term view. // Search term view resource names have the form: // // `customers/{customer_id}/searchTermViews/{campaign_id}~{ad_group_id}~{URL-base64_search_term}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/SearchTermView" + } + ]; - // The search term. - google.protobuf.StringValue search_term = 2; + // Output only. The search term. + google.protobuf.StringValue search_term = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The ad group the search term served in. - google.protobuf.StringValue ad_group = 3; + // Output only. The ad group the search term served in. + google.protobuf.StringValue ad_group = 3 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; - // Indicates whether the search term is currently one of your + // Output only. Indicates whether the search term is currently one of your // targeted or excluded keywords. - google.ads.googleads.v2.enums.SearchTermTargetingStatusEnum.SearchTermTargetingStatus status = 4; + google.ads.googleads.v2.enums.SearchTermTargetingStatusEnum.SearchTermTargetingStatus status = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/shared_criterion.proto b/third_party/googleapis/google/ads/googleads/v2/resources/shared_criterion.proto index 954d48bbd..bdcac8039 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/shared_criterion.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/shared_criterion.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/common/criteria.proto"; import "google/ads/googleads/v2/enums/criterion_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -35,43 +36,58 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A criterion belonging to a shared set. message SharedCriterion { - // The resource name of the shared criterion. + option (google.api.resource) = { + type: "googleads.googleapis.com/SharedCriterion" + pattern: "customers/{customer}/sharedCriteria/{shared_criterion}" + }; + + // Immutable. The resource name of the shared criterion. // Shared set resource names have the form: // // `customers/{customer_id}/sharedCriteria/{shared_set_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/SharedCriterion" + } + ]; - // The shared set to which the shared criterion belongs. - google.protobuf.StringValue shared_set = 2; + // Immutable. The shared set to which the shared criterion belongs. + google.protobuf.StringValue shared_set = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/SharedSet" + } + ]; - // The ID of the criterion. + // Output only. The ID of the criterion. // // This field is ignored for mutates. - google.protobuf.Int64Value criterion_id = 26; + google.protobuf.Int64Value criterion_id = 26 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The type of the criterion. - google.ads.googleads.v2.enums.CriterionTypeEnum.CriterionType type = 4; + // Output only. The type of the criterion. + google.ads.googleads.v2.enums.CriterionTypeEnum.CriterionType type = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; // The criterion. // // Exactly one must be set. oneof criterion { - // Keyword. - google.ads.googleads.v2.common.KeywordInfo keyword = 3; + // Immutable. Keyword. + google.ads.googleads.v2.common.KeywordInfo keyword = 3 [(google.api.field_behavior) = IMMUTABLE]; - // YouTube Video. - google.ads.googleads.v2.common.YouTubeVideoInfo youtube_video = 5; + // Immutable. YouTube Video. + google.ads.googleads.v2.common.YouTubeVideoInfo youtube_video = 5 [(google.api.field_behavior) = IMMUTABLE]; - // YouTube Channel. - google.ads.googleads.v2.common.YouTubeChannelInfo youtube_channel = 6; + // Immutable. YouTube Channel. + google.ads.googleads.v2.common.YouTubeChannelInfo youtube_channel = 6 [(google.api.field_behavior) = IMMUTABLE]; - // Placement. - google.ads.googleads.v2.common.PlacementInfo placement = 7; + // Immutable. Placement. + google.ads.googleads.v2.common.PlacementInfo placement = 7 [(google.api.field_behavior) = IMMUTABLE]; - // Mobile App Category. - google.ads.googleads.v2.common.MobileAppCategoryInfo mobile_app_category = 8; + // Immutable. Mobile App Category. + google.ads.googleads.v2.common.MobileAppCategoryInfo mobile_app_category = 8 [(google.api.field_behavior) = IMMUTABLE]; - // Mobile application. - google.ads.googleads.v2.common.MobileApplicationInfo mobile_application = 9; + // Immutable. Mobile application. + google.ads.googleads.v2.common.MobileApplicationInfo mobile_application = 9 [(google.api.field_behavior) = IMMUTABLE]; } } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/shared_set.proto b/third_party/googleapis/google/ads/googleads/v2/resources/shared_set.proto index 027cbcfba..b7a8edc26 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/shared_set.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/shared_set.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/enums/shared_set_status.proto"; import "google/ads/googleads/v2/enums/shared_set_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -36,18 +37,28 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // SharedSets are used for sharing criterion exclusions across multiple // campaigns. message SharedSet { - // The resource name of the shared set. + option (google.api.resource) = { + type: "googleads.googleapis.com/SharedSet" + pattern: "customers/{customer}/sharedSets/{shared_set}" + }; + + // Immutable. The resource name of the shared set. // Shared set resource names have the form: // // `customers/{customer_id}/sharedSets/{shared_set_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/SharedSet" + } + ]; - // The ID of this shared set. Read only. - google.protobuf.Int64Value id = 2; + // Output only. The ID of this shared set. Read only. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The type of this shared set: each shared set holds only a single kind + // Immutable. The type of this shared set: each shared set holds only a single kind // of resource. Required. Immutable. - google.ads.googleads.v2.enums.SharedSetTypeEnum.SharedSetType type = 3; + google.ads.googleads.v2.enums.SharedSetTypeEnum.SharedSetType type = 3 [(google.api.field_behavior) = IMMUTABLE]; // The name of this shared set. Required. // Shared Sets must have names that are unique among active shared sets of @@ -56,12 +67,12 @@ message SharedSet { // inclusive. google.protobuf.StringValue name = 4; - // The status of this shared set. Read only. - google.ads.googleads.v2.enums.SharedSetStatusEnum.SharedSetStatus status = 5; + // Output only. The status of this shared set. Read only. + google.ads.googleads.v2.enums.SharedSetStatusEnum.SharedSetStatus status = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The number of shared criteria within this shared set. Read only. - google.protobuf.Int64Value member_count = 6; + // Output only. The number of shared criteria within this shared set. Read only. + google.protobuf.Int64Value member_count = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The number of campaigns associated with this shared set. Read only. - google.protobuf.Int64Value reference_count = 7; + // Output only. The number of campaigns associated with this shared set. Read only. + google.protobuf.Int64Value reference_count = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/shopping_performance_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/shopping_performance_view.proto index ed5744580..314418264 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/shopping_performance_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/shopping_performance_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Resources"; @@ -37,8 +38,18 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // the state of each dimension as of the date and time when the corresponding // event was recorded. message ShoppingPerformanceView { - // The resource name of the Shopping performance view. + option (google.api.resource) = { + type: "googleads.googleapis.com/ShoppingPerformanceView" + pattern: "customers/{customer}/shoppingPerformanceView" + }; + + // Output only. The resource name of the Shopping performance view. // Shopping performance view resource names have the form: // `customers/{customer_id}/shoppingPerformanceView` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ShoppingPerformanceView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/topic_constant.proto b/third_party/googleapis/google/ads/googleads/v2/resources/topic_constant.proto index d0ba4a459..fcfc5c4aa 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/topic_constant.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/topic_constant.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -35,22 +36,37 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // based on the category into which the placement falls (for example, // "Pets & Animals/Pets/Dogs"). message TopicConstant { - // The resource name of the topic constant. + option (google.api.resource) = { + type: "googleads.googleapis.com/TopicConstant" + pattern: "topicConstants/{topic_constant}" + }; + + // Output only. The resource name of the topic constant. // topic constant resource names have the form: // // `topicConstants/{topic_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/TopicConstant" + } + ]; - // The ID of the topic. - google.protobuf.Int64Value id = 2; + // Output only. The ID of the topic. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Resource name of parent of the topic constant. - google.protobuf.StringValue topic_constant_parent = 3; + // Output only. Resource name of parent of the topic constant. + google.protobuf.StringValue topic_constant_parent = 3 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/TopicConstant" + } + ]; - // The category to target or exclude. Each subsequent element in the array + // Output only. The category to target or exclude. Each subsequent element in the array // describes a more specific sub-category. For example, // {"Pets & Animals", "Pets", "Dogs"} represents the // "Pets & Animals/Pets/Dogs" category. List of available topic categories at // https://developers.google.com/adwords/api/docs/appendix/verticals - repeated google.protobuf.StringValue path = 4; + repeated google.protobuf.StringValue path = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/topic_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/topic_view.proto index 747500139..73a0aaedc 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/topic_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/topic_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Resources"; @@ -32,9 +33,19 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A topic view. message TopicView { - // The resource name of the topic view. + option (google.api.resource) = { + type: "googleads.googleapis.com/TopicView" + pattern: "customers/{customer}/topicViews/{topic_view}" + }; + + // Output only. The resource name of the topic view. // Topic view resource names have the form: // // `customers/{customer_id}/topicViews/{ad_group_id}~{criterion_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/TopicView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/user_interest.proto b/third_party/googleapis/google/ads/googleads/v2/resources/user_interest.proto index c956e28a0..a393cf70c 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/user_interest.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/user_interest.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,6 +18,8 @@ package google.ads.googleads.v2.resources; import "google/ads/googleads/v2/common/criterion_category_availability.proto"; import "google/ads/googleads/v2/enums/user_interest_taxonomy_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -35,27 +36,42 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A user interest: a particular interest-based vertical to be targeted. message UserInterest { - // The resource name of the user interest. + option (google.api.resource) = { + type: "googleads.googleapis.com/UserInterest" + pattern: "customers/{customer}/userInterests/{user_interest}" + }; + + // Output only. The resource name of the user interest. // User interest resource names have the form: // // `customers/{customer_id}/userInterests/{user_interest_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/UserInterest" + } + ]; - // Taxonomy type of the user interest. - google.ads.googleads.v2.enums.UserInterestTaxonomyTypeEnum.UserInterestTaxonomyType taxonomy_type = 2; + // Output only. Taxonomy type of the user interest. + google.ads.googleads.v2.enums.UserInterestTaxonomyTypeEnum.UserInterestTaxonomyType taxonomy_type = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The ID of the user interest. - google.protobuf.Int64Value user_interest_id = 3; + // Output only. The ID of the user interest. + google.protobuf.Int64Value user_interest_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The name of the user interest. - google.protobuf.StringValue name = 4; + // Output only. The name of the user interest. + google.protobuf.StringValue name = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The parent of the user interest. - google.protobuf.StringValue user_interest_parent = 5; + // Output only. The parent of the user interest. + google.protobuf.StringValue user_interest_parent = 5 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/UserInterest" + } + ]; - // True if the user interest is launched to all channels and locales. - google.protobuf.BoolValue launched_to_all = 6; + // Output only. True if the user interest is launched to all channels and locales. + google.protobuf.BoolValue launched_to_all = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Availability information of the user interest. - repeated google.ads.googleads.v2.common.CriterionCategoryAvailability availabilities = 7; + // Output only. Availability information of the user interest. + repeated google.ads.googleads.v2.common.CriterionCategoryAvailability availabilities = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/user_list.proto b/third_party/googleapis/google/ads/googleads/v2/resources/user_list.proto index 9157e4269..35d15acdb 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/user_list.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/user_list.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -24,6 +23,8 @@ import "google/ads/googleads/v2/enums/user_list_closing_reason.proto"; import "google/ads/googleads/v2/enums/user_list_membership_status.proto"; import "google/ads/googleads/v2/enums/user_list_size_range.proto"; import "google/ads/googleads/v2/enums/user_list_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -40,21 +41,31 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A user list. This is a list of users a customer may target. message UserList { - // The resource name of the user list. + option (google.api.resource) = { + type: "googleads.googleapis.com/UserList" + pattern: "customers/{customer}/userLists/{user_list}" + }; + + // Immutable. The resource name of the user list. // User list resource names have the form: // // `customers/{customer_id}/userLists/{user_list_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/UserList" + } + ]; - // Id of the user list. - google.protobuf.Int64Value id = 2; + // Output only. Id of the user list. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // A flag that indicates if a user may edit a list. Depends on the list + // Output only. A flag that indicates if a user may edit a list. Depends on the list // ownership and list type. For example, external remarketing user lists are // not editable. // // This field is read-only. - google.protobuf.BoolValue read_only = 3; + google.protobuf.BoolValue read_only = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // Name of this user list. Depending on its access_reason, the user list name // may not be unique (e.g. if access_reason=SHARED) @@ -80,45 +91,45 @@ message UserList { // It'll be ignored for logical_user_list. google.protobuf.Int64Value membership_life_span = 8; - // Estimated number of users in this user list, on the Google Display Network. + // Output only. Estimated number of users in this user list, on the Google Display Network. // This value is null if the number of users has not yet been determined. // // This field is read-only. - google.protobuf.Int64Value size_for_display = 9; + google.protobuf.Int64Value size_for_display = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Size range in terms of number of users of the UserList, on the Google + // Output only. Size range in terms of number of users of the UserList, on the Google // Display Network. // // This field is read-only. - google.ads.googleads.v2.enums.UserListSizeRangeEnum.UserListSizeRange size_range_for_display = 10; + google.ads.googleads.v2.enums.UserListSizeRangeEnum.UserListSizeRange size_range_for_display = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Estimated number of users in this user list in the google.com domain. + // Output only. Estimated number of users in this user list in the google.com domain. // These are the users available for targeting in Search campaigns. // This value is null if the number of users has not yet been determined. // // This field is read-only. - google.protobuf.Int64Value size_for_search = 11; + google.protobuf.Int64Value size_for_search = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Size range in terms of number of users of the UserList, for Search ads. + // Output only. Size range in terms of number of users of the UserList, for Search ads. // // This field is read-only. - google.ads.googleads.v2.enums.UserListSizeRangeEnum.UserListSizeRange size_range_for_search = 12; + google.ads.googleads.v2.enums.UserListSizeRangeEnum.UserListSizeRange size_range_for_search = 12 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Type of this list. + // Output only. Type of this list. // // This field is read-only. - google.ads.googleads.v2.enums.UserListTypeEnum.UserListType type = 13; + google.ads.googleads.v2.enums.UserListTypeEnum.UserListType type = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; // Indicating the reason why this user list membership status is closed. It is // only populated on lists that were automatically closed due to inactivity, // and will be cleared once the list membership status becomes open. google.ads.googleads.v2.enums.UserListClosingReasonEnum.UserListClosingReason closing_reason = 14; - // Indicates the reason this account has been granted access to the list. + // Output only. Indicates the reason this account has been granted access to the list. // The reason can be SHARED, OWNED, LICENSED or SUBSCRIBED. // // This field is read-only. - google.ads.googleads.v2.enums.AccessReasonEnum.AccessReason access_reason = 15; + google.ads.googleads.v2.enums.AccessReasonEnum.AccessReason access_reason = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; // Indicates if this share is still enabled. When a UserList is shared with // the user this field is set to ENABLED. Later the userList owner can decide @@ -129,10 +140,10 @@ message UserList { // Indicates if this user list is eligible for Google Search Network. google.protobuf.BoolValue eligible_for_search = 17; - // Indicates this user list is eligible for Google Display Network. + // Output only. Indicates this user list is eligible for Google Display Network. // // This field is read-only. - google.protobuf.BoolValue eligible_for_display = 18; + google.protobuf.BoolValue eligible_for_display = 18 [(google.api.field_behavior) = OUTPUT_ONLY]; // The user list. // @@ -141,9 +152,9 @@ message UserList { // User list of CRM users provided by the advertiser. google.ads.googleads.v2.common.CrmBasedUserListInfo crm_based_user_list = 19; - // User list which are similar to users from another UserList. + // Output only. User list which are similar to users from another UserList. // These lists are readonly and automatically created by google. - google.ads.googleads.v2.common.SimilarUserListInfo similar_user_list = 20; + google.ads.googleads.v2.common.SimilarUserListInfo similar_user_list = 20 [(google.api.field_behavior) = OUTPUT_ONLY]; // User list generated by a rule. google.ads.googleads.v2.common.RuleBasedUserListInfo rule_based_user_list = 21; diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/user_location_view.proto b/third_party/googleapis/google/ads/googleads/v2/resources/user_location_view.proto index a99de5e59..759835cab 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/user_location_view.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/user_location_view.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -38,15 +39,25 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // the user by targeted or not targeted location. If other segment fields are // used, you may get more than one row per country. message UserLocationView { - // The resource name of the user location view. + option (google.api.resource) = { + type: "googleads.googleapis.com/UserLocationView" + pattern: "customers/{customer}/userLocationViews/{user_location_view}" + }; + + // Output only. The resource name of the user location view. // UserLocation view resource names have the form: // // `customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}` - string resource_name = 1; - - // Criterion Id for the country. - google.protobuf.Int64Value country_criterion_id = 2; - - // Indicates whether location was targeted or not. - google.protobuf.BoolValue targeting_location = 3; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/UserLocationView" + } + ]; + + // Output only. Criterion Id for the country. + google.protobuf.Int64Value country_criterion_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Indicates whether location was targeted or not. + google.protobuf.BoolValue targeting_location = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/resources/video.proto b/third_party/googleapis/google/ads/googleads/v2/resources/video.proto index de05bc4c3..d2f838fdb 100644 --- a/third_party/googleapis/google/ads/googleads/v2/resources/video.proto +++ b/third_party/googleapis/google/ads/googleads/v2/resources/video.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.resources; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; @@ -33,21 +34,31 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Resources"; // A video. message Video { - // The resource name of the video. + option (google.api.resource) = { + type: "googleads.googleapis.com/Video" + pattern: "customers/{customer}/videos/{video}" + }; + + // Output only. The resource name of the video. // Video resource names have the form: // // `customers/{customer_id}/videos/{video_id}` - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Video" + } + ]; - // The ID of the video. - google.protobuf.StringValue id = 2; + // Output only. The ID of the video. + google.protobuf.StringValue id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The owner channel id of the video. - google.protobuf.StringValue channel_id = 3; + // Output only. The owner channel id of the video. + google.protobuf.StringValue channel_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The duration of the video in milliseconds. - google.protobuf.Int64Value duration_millis = 4; + // Output only. The duration of the video in milliseconds. + google.protobuf.Int64Value duration_millis = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The title of the video. - google.protobuf.StringValue title = 5; + // Output only. The title of the video. + google.protobuf.StringValue title = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/account_budget_proposal_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/account_budget_proposal_service.proto index 5b47c06d6..40cc7c9b8 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/account_budget_proposal_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/account_budget_proposal_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/account_budget_proposal.proto"; import "google/api/annotations.proto"; -import "google/protobuf/field_mask.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -55,6 +56,7 @@ service AccountBudgetProposalService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/accountBudgetProposals/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes account budget proposals. Operation statuses @@ -64,24 +66,30 @@ service AccountBudgetProposalService { post: "/v2/customers/{customer_id=*}/accountBudgetProposals:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operation"; } } // Request message for // [AccountBudgetProposalService.GetAccountBudgetProposal][google.ads.googleads.v2.services.AccountBudgetProposalService.GetAccountBudgetProposal]. message GetAccountBudgetProposalRequest { - // The resource name of the account-level budget proposal to fetch. - string resource_name = 1; + // Required. The resource name of the account-level budget proposal to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AccountBudgetProposal" + } + ]; } // Request message for // [AccountBudgetProposalService.MutateAccountBudgetProposal][google.ads.googleads.v2.services.AccountBudgetProposalService.MutateAccountBudgetProposal]. message MutateAccountBudgetProposalRequest { - // The ID of the customer. - string customer_id = 1; + // Required. The ID of the customer. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The operation to perform on an individual account-level budget proposal. - AccountBudgetProposalOperation operation = 2; + // Required. The operation to perform on an individual account-level budget proposal. + AccountBudgetProposalOperation operation = 2 [(google.api.field_behavior) = REQUIRED]; // If true, the request is validated but not executed. Only errors are // returned, not results. diff --git a/third_party/googleapis/google/ads/googleads/v2/services/account_budget_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/account_budget_service.proto index f793c5129..8aaa8663a 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/account_budget_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/account_budget_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/account_budget.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,12 +44,18 @@ service AccountBudgetService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/accountBudgets/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for // [AccountBudgetService.GetAccountBudget][google.ads.googleads.v2.services.AccountBudgetService.GetAccountBudget]. message GetAccountBudgetRequest { - // The resource name of the account-level budget to fetch. - string resource_name = 1; + // Required. The resource name of the account-level budget to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AccountBudget" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_ad_asset_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_ad_asset_view_service.proto index 1ddcf83df..93a0cb758 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_ad_asset_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_ad_asset_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/ad_group_ad_asset_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service AdGroupAdAssetViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/adGroupAdAssetViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [AdGroupAdAssetViewService.GetAdGroupAdAssetView][google.ads.googleads.v2.services.AdGroupAdAssetViewService.GetAdGroupAdAssetView]. message GetAdGroupAdAssetViewRequest { - // The resource name of the ad group ad asset view to fetch. - string resource_name = 1; + // Required. The resource name of the ad group ad asset view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAdAssetView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_ad_label_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_ad_label_service.proto index 044f7bb12..b1bbad731 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_ad_label_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_ad_label_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/ad_group_ad_label.proto"; import "google/api/annotations.proto"; -import "google/rpc/status.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -42,6 +43,7 @@ service AdGroupAdLabelService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/adGroupAdLabels/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates and removes ad group ad labels. @@ -51,22 +53,28 @@ service AdGroupAdLabelService { post: "/v2/customers/{customer_id=*}/adGroupAdLabels:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [AdGroupAdLabelService.GetAdGroupAdLabel][google.ads.googleads.v2.services.AdGroupAdLabelService.GetAdGroupAdLabel]. message GetAdGroupAdLabelRequest { - // The resource name of the ad group ad label to fetch. - string resource_name = 1; + // Required. The resource name of the ad group ad label to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAdLabel" + } + ]; } // Request message for [AdGroupAdLabelService.MutateAdGroupAdLabels][google.ads.googleads.v2.services.AdGroupAdLabelService.MutateAdGroupAdLabels]. message MutateAdGroupAdLabelsRequest { - // ID of the customer whose ad group ad labels are being modified. - string customer_id = 1; + // Required. ID of the customer whose ad group ad labels are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on ad group ad labels. - repeated AdGroupAdLabelOperation operations = 2; + // Required. The list of operations to perform on ad group ad labels. + repeated AdGroupAdLabelOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_ad_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_ad_service.proto index 852de5c5e..566ddc0ca 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_ad_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_ad_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,9 +19,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/common/policy.proto"; import "google/ads/googleads/v2/resources/ad_group_ad.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -44,6 +45,7 @@ service AdGroupAdService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/adGroupAds/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes ads. Operation statuses are returned. @@ -52,22 +54,28 @@ service AdGroupAdService { post: "/v2/customers/{customer_id=*}/adGroupAds:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [AdGroupAdService.GetAdGroupAd][google.ads.googleads.v2.services.AdGroupAdService.GetAdGroupAd]. message GetAdGroupAdRequest { - // The resource name of the ad to fetch. - string resource_name = 1; + // Required. The resource name of the ad to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAd" + } + ]; } // Request message for [AdGroupAdService.MutateAdGroupAds][google.ads.googleads.v2.services.AdGroupAdService.MutateAdGroupAds]. message MutateAdGroupAdsRequest { - // The ID of the customer whose ads are being modified. - string customer_id = 1; + // Required. The ID of the customer whose ads are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual ads. - repeated AdGroupAdOperation operations = 2; + // Required. The list of operations to perform on individual ads. + repeated AdGroupAdOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_audience_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_audience_view_service.proto index d07da3d9e..6cfe6a63a 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_audience_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_audience_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/ad_group_audience_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service AdGroupAudienceViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/adGroupAudienceViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [AdGroupAudienceViewService.GetAdGoupAudienceView][]. message GetAdGroupAudienceViewRequest { - // The resource name of the ad group audience view to fetch. - string resource_name = 1; + // Required. The resource name of the ad group audience view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAudienceView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_bid_modifier_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_bid_modifier_service.proto index 9a7327d59..9f58476e7 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_bid_modifier_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_bid_modifier_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/ad_group_bid_modifier.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,6 +44,7 @@ service AdGroupBidModifierService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/adGroupBidModifiers/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes ad group bid modifiers. @@ -52,22 +54,28 @@ service AdGroupBidModifierService { post: "/v2/customers/{customer_id=*}/adGroupBidModifiers:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [AdGroupBidModifierService.GetAdGroupBidModifier][google.ads.googleads.v2.services.AdGroupBidModifierService.GetAdGroupBidModifier]. message GetAdGroupBidModifierRequest { - // The resource name of the ad group bid modifier to fetch. - string resource_name = 1; + // Required. The resource name of the ad group bid modifier to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupBidModifier" + } + ]; } // Request message for [AdGroupBidModifierService.MutateAdGroupBidModifiers][google.ads.googleads.v2.services.AdGroupBidModifierService.MutateAdGroupBidModifiers]. message MutateAdGroupBidModifiersRequest { - // ID of the customer whose ad group bid modifiers are being modified. - string customer_id = 1; + // Required. ID of the customer whose ad group bid modifiers are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual ad group bid modifiers. - repeated AdGroupBidModifierOperation operations = 2; + // Required. The list of operations to perform on individual ad group bid modifiers. + repeated AdGroupBidModifierOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_criterion_label_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_criterion_label_service.proto index c64db682d..4c8b6e56d 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_criterion_label_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_criterion_label_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/ad_group_criterion_label.proto"; import "google/api/annotations.proto"; -import "google/rpc/status.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -42,6 +43,7 @@ service AdGroupCriterionLabelService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/adGroupCriterionLabels/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates and removes ad group criterion labels. @@ -51,24 +53,30 @@ service AdGroupCriterionLabelService { post: "/v2/customers/{customer_id=*}/adGroupCriterionLabels:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for // [AdGroupCriterionLabelService.GetAdGroupCriterionLabel][google.ads.googleads.v2.services.AdGroupCriterionLabelService.GetAdGroupCriterionLabel]. message GetAdGroupCriterionLabelRequest { - // The resource name of the ad group criterion label to fetch. - string resource_name = 1; + // Required. The resource name of the ad group criterion label to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterionLabel" + } + ]; } // Request message for // [AdGroupCriterionLabelService.MutateAdGroupCriterionLabels][google.ads.googleads.v2.services.AdGroupCriterionLabelService.MutateAdGroupCriterionLabels]. message MutateAdGroupCriterionLabelsRequest { - // ID of the customer whose ad group criterion labels are being modified. - string customer_id = 1; + // Required. ID of the customer whose ad group criterion labels are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on ad group criterion labels. - repeated AdGroupCriterionLabelOperation operations = 2; + // Required. The list of operations to perform on ad group criterion labels. + repeated AdGroupCriterionLabelOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_criterion_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_criterion_service.proto index bb0c2f887..48ca349d3 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_criterion_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_criterion_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,9 +19,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/common/policy.proto"; import "google/ads/googleads/v2/resources/ad_group_criterion.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -44,6 +45,7 @@ service AdGroupCriterionService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/adGroupCriteria/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes criteria. Operation statuses are returned. @@ -52,22 +54,28 @@ service AdGroupCriterionService { post: "/v2/customers/{customer_id=*}/adGroupCriteria:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [AdGroupCriterionService.GetAdGroupCriterion][google.ads.googleads.v2.services.AdGroupCriterionService.GetAdGroupCriterion]. message GetAdGroupCriterionRequest { - // The resource name of the criterion to fetch. - string resource_name = 1; + // Required. The resource name of the criterion to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterion" + } + ]; } // Request message for [AdGroupCriterionService.MutateAdGroupCriteria][google.ads.googleads.v2.services.AdGroupCriterionService.MutateAdGroupCriteria]. message MutateAdGroupCriteriaRequest { - // ID of the customer whose criteria are being modified. - string customer_id = 1; + // Required. ID of the customer whose criteria are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual criteria. - repeated AdGroupCriterionOperation operations = 2; + // Required. The list of operations to perform on individual criteria. + repeated AdGroupCriterionOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_criterion_simulation_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_criterion_simulation_service.proto index c407a2a51..08ec34b1b 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_criterion_simulation_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_criterion_simulation_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/ad_group_criterion_simulation.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,12 +42,18 @@ service AdGroupCriterionSimulationService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/adGroupCriterionSimulations/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for // [AdGroupCriterionSimulationService.GetAdGroupCriterionSimulation][google.ads.googleads.v2.services.AdGroupCriterionSimulationService.GetAdGroupCriterionSimulation]. message GetAdGroupCriterionSimulationRequest { - // The resource name of the ad group criterion simulation to fetch. - string resource_name = 1; + // Required. The resource name of the ad group criterion simulation to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterionSimulation" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_extension_setting_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_extension_setting_service.proto index 87f6b7e8f..c78b5b6a9 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_extension_setting_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_extension_setting_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/ad_group_extension_setting.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,6 +44,7 @@ service AdGroupExtensionSettingService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/adGroupExtensionSettings/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes ad group extension settings. Operation @@ -52,26 +54,32 @@ service AdGroupExtensionSettingService { post: "/v2/customers/{customer_id=*}/adGroupExtensionSettings:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for // [AdGroupExtensionSettingService.GetAdGroupExtensionSetting][google.ads.googleads.v2.services.AdGroupExtensionSettingService.GetAdGroupExtensionSetting]. message GetAdGroupExtensionSettingRequest { - // The resource name of the ad group extension setting to fetch. - string resource_name = 1; + // Required. The resource name of the ad group extension setting to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupExtensionSetting" + } + ]; } // Request message for // [AdGroupExtensionSettingService.MutateAdGroupExtensionSettings][google.ads.googleads.v2.services.AdGroupExtensionSettingService.MutateAdGroupExtensionSettings]. message MutateAdGroupExtensionSettingsRequest { - // The ID of the customer whose ad group extension settings are being + // Required. The ID of the customer whose ad group extension settings are being // modified. - string customer_id = 1; + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual ad group extension + // Required. The list of operations to perform on individual ad group extension // settings. - repeated AdGroupExtensionSettingOperation operations = 2; + repeated AdGroupExtensionSettingOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_feed_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_feed_service.proto index 15c07d433..4a57759e5 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_feed_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_feed_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/ad_group_feed.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,6 +44,7 @@ service AdGroupFeedService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/adGroupFeeds/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes ad group feeds. Operation statuses are @@ -52,22 +54,28 @@ service AdGroupFeedService { post: "/v2/customers/{customer_id=*}/adGroupFeeds:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [AdGroupFeedService.GetAdGroupFeed][google.ads.googleads.v2.services.AdGroupFeedService.GetAdGroupFeed]. message GetAdGroupFeedRequest { - // The resource name of the ad group feed to fetch. - string resource_name = 1; + // Required. The resource name of the ad group feed to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupFeed" + } + ]; } // Request message for [AdGroupFeedService.MutateAdGroupFeeds][google.ads.googleads.v2.services.AdGroupFeedService.MutateAdGroupFeeds]. message MutateAdGroupFeedsRequest { - // The ID of the customer whose ad group feeds are being modified. - string customer_id = 1; + // Required. The ID of the customer whose ad group feeds are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual ad group feeds. - repeated AdGroupFeedOperation operations = 2; + // Required. The list of operations to perform on individual ad group feeds. + repeated AdGroupFeedOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_label_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_label_service.proto index de6481451..80fda5aab 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_label_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_label_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/ad_group_label.proto"; import "google/api/annotations.proto"; -import "google/rpc/status.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -42,6 +43,7 @@ service AdGroupLabelService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/adGroupLabels/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates and removes ad group labels. @@ -51,22 +53,28 @@ service AdGroupLabelService { post: "/v2/customers/{customer_id=*}/adGroupLabels:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [AdGroupLabelService.GetAdGroupLabel][google.ads.googleads.v2.services.AdGroupLabelService.GetAdGroupLabel]. message GetAdGroupLabelRequest { - // The resource name of the ad group label to fetch. - string resource_name = 1; + // Required. The resource name of the ad group label to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupLabel" + } + ]; } // Request message for [AdGroupLabelService.MutateAdGroupLabels][google.ads.googleads.v2.services.AdGroupLabelService.MutateAdGroupLabels]. message MutateAdGroupLabelsRequest { - // ID of the customer whose ad group labels are being modified. - string customer_id = 1; + // Required. ID of the customer whose ad group labels are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on ad group labels. - repeated AdGroupLabelOperation operations = 2; + // Required. The list of operations to perform on ad group labels. + repeated AdGroupLabelOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_service.proto index 3d01e537d..c7d165615 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/ad_group.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,6 +44,7 @@ service AdGroupService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/adGroups/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes ad groups. Operation statuses are returned. @@ -51,22 +53,28 @@ service AdGroupService { post: "/v2/customers/{customer_id=*}/adGroups:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [AdGroupService.GetAdGroup][google.ads.googleads.v2.services.AdGroupService.GetAdGroup]. message GetAdGroupRequest { - // The resource name of the ad group to fetch. - string resource_name = 1; + // Required. The resource name of the ad group to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; } // Request message for [AdGroupService.MutateAdGroups][google.ads.googleads.v2.services.AdGroupService.MutateAdGroups]. message MutateAdGroupsRequest { - // The ID of the customer whose ad groups are being modified. - string customer_id = 1; + // Required. The ID of the customer whose ad groups are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual ad groups. - repeated AdGroupOperation operations = 2; + // Required. The list of operations to perform on individual ad groups. + repeated AdGroupOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_simulation_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_simulation_service.proto index cfebaab16..94fd27f7f 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/ad_group_simulation_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/ad_group_simulation_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/ad_group_simulation.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service AdGroupSimulationService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/adGroupSimulations/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [AdGroupSimulationService.GetAdGroupSimulation][google.ads.googleads.v2.services.AdGroupSimulationService.GetAdGroupSimulation]. message GetAdGroupSimulationRequest { - // The resource name of the ad group simulation to fetch. - string resource_name = 1; + // Required. The resource name of the ad group simulation to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupSimulation" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/ad_parameter_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/ad_parameter_service.proto index 2993711b9..e0caf586e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/ad_parameter_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/ad_parameter_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/ad_parameter.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,6 +44,7 @@ service AdParameterService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/adParameters/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes ad parameters. Operation statuses are @@ -52,22 +54,28 @@ service AdParameterService { post: "/v2/customers/{customer_id=*}/adParameters:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [AdParameterService.GetAdParameter][google.ads.googleads.v2.services.AdParameterService.GetAdParameter] message GetAdParameterRequest { - // The resource name of the ad parameter to fetch. - string resource_name = 1; + // Required. The resource name of the ad parameter to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdParameter" + } + ]; } // Request message for [AdParameterService.MutateAdParameters][google.ads.googleads.v2.services.AdParameterService.MutateAdParameters] message MutateAdParametersRequest { - // The ID of the customer whose ad parameters are being modified. - string customer_id = 1; + // Required. The ID of the customer whose ad parameters are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual ad parameters. - repeated AdParameterOperation operations = 2; + // Required. The list of operations to perform on individual ad parameters. + repeated AdParameterOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/ad_schedule_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/ad_schedule_view_service.proto index 465f25a01..b9859096f 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/ad_schedule_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/ad_schedule_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/ad_schedule_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service AdScheduleViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/adScheduleViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [AdScheduleViewService.GetAdScheduleView][google.ads.googleads.v2.services.AdScheduleViewService.GetAdScheduleView]. message GetAdScheduleViewRequest { - // The resource name of the ad schedule view to fetch. - string resource_name = 1; + // Required. The resource name of the ad schedule view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdScheduleView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/ad_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/ad_service.proto index 9f764d7c7..d5bb1d2a4 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/ad_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/ad_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/ad.proto"; import "google/api/annotations.proto"; -import "google/protobuf/field_mask.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -42,6 +43,7 @@ service AdService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/ads/*}" }; + option (google.api.method_signature) = "resource_name"; } // Updates ads. Operation statuses are returned. @@ -50,22 +52,28 @@ service AdService { post: "/v2/customers/{customer_id=*}/ads:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [AdService.GetAd][google.ads.googleads.v2.services.AdService.GetAd]. message GetAdRequest { - // The resource name of the ad to fetch. - string resource_name = 1; + // Required. The resource name of the ad to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Ad" + } + ]; } // Request message for [AdService.MutateAds][google.ads.googleads.v2.services.AdService.MutateAds]. message MutateAdsRequest { - // The ID of the customer whose ads are being modified. - string customer_id = 1; + // Required. The ID of the customer whose ads are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual ads. - repeated AdOperation operations = 2; + // Required. The list of operations to perform on individual ads. + repeated AdOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; } // A single update operation on an ad. diff --git a/third_party/googleapis/google/ads/googleads/v2/services/age_range_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/age_range_view_service.proto index 5db684b06..17c64935a 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/age_range_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/age_range_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/age_range_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service AgeRangeViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/ageRangeViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [AgeRangeViewService.GetAgeRangeView][google.ads.googleads.v2.services.AgeRangeViewService.GetAgeRangeView]. message GetAgeRangeViewRequest { - // The resource name of the age range view to fetch. - string resource_name = 1; + // Required. The resource name of the age range view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AgeRangeView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/asset_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/asset_service.proto index 394c52b2d..5ed9d0c1a 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/asset_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/asset_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/asset.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,6 +44,7 @@ service AssetService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/assets/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates assets. Operation statuses are returned. @@ -51,27 +53,33 @@ service AssetService { post: "/v2/customers/{customer_id=*}/assets:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [AssetService.GetAsset][google.ads.googleads.v2.services.AssetService.GetAsset] message GetAssetRequest { - // The resource name of the asset to fetch. - string resource_name = 1; + // Required. The resource name of the asset to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Asset" + } + ]; } // Request message for [AssetService.MutateAssets][google.ads.googleads.v2.services.AssetService.MutateAssets] message MutateAssetsRequest { - // The ID of the customer whose assets are being modified. - string customer_id = 1; + // Required. The ID of the customer whose assets are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual assets. - repeated AssetOperation operations = 2; + // Required. The list of operations to perform on individual assets. + repeated AssetOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; } // A single operation to create an asset. Supported asset types are -// YoutubeVideoAsset, MediaBundleAsset and ImageAsset. TextAsset should be -// created with Ad inline. +// YoutubeVideoAsset, MediaBundleAsset, ImageAsset, and LeadFormAsset. TextAsset +// should be created with Ad inline. message AssetOperation { // The mutate operation. oneof operation { diff --git a/third_party/googleapis/google/ads/googleads/v2/services/bidding_strategy_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/bidding_strategy_service.proto index 74af8c08d..df61d2278 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/bidding_strategy_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/bidding_strategy_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/bidding_strategy.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,6 +44,7 @@ service BiddingStrategyService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/biddingStrategies/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes bidding strategies. Operation statuses are @@ -52,22 +54,28 @@ service BiddingStrategyService { post: "/v2/customers/{customer_id=*}/biddingStrategies:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [BiddingStrategyService.GetBiddingStrategy][google.ads.googleads.v2.services.BiddingStrategyService.GetBiddingStrategy]. message GetBiddingStrategyRequest { - // The resource name of the bidding strategy to fetch. - string resource_name = 1; + // Required. The resource name of the bidding strategy to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/BiddingStrategy" + } + ]; } // Request message for [BiddingStrategyService.MutateBiddingStrategies][google.ads.googleads.v2.services.BiddingStrategyService.MutateBiddingStrategies]. message MutateBiddingStrategiesRequest { - // The ID of the customer whose bidding strategies are being modified. - string customer_id = 1; + // Required. The ID of the customer whose bidding strategies are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual bidding strategies. - repeated BiddingStrategyOperation operations = 2; + // Required. The list of operations to perform on individual bidding strategies. + repeated BiddingStrategyOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/billing_setup_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/billing_setup_service.proto index abec2596a..ea17bf1a0 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/billing_setup_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/billing_setup_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/billing_setup.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -34,8 +35,8 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Services"; // A service for designating the business entity responsible for accrued costs. // -// A billing setup is associated with a Payments account. Billing-related -// activity for all billing setups associated with a particular Payments account +// A billing setup is associated with a payments account. Billing-related +// activity for all billing setups associated with a particular payments account // will appear on a single invoice generated monthly. // // Mutates: @@ -49,6 +50,7 @@ service BillingSetupService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/billingSetups/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates a billing setup, or cancels an existing billing setup. @@ -57,23 +59,29 @@ service BillingSetupService { post: "/v2/customers/{customer_id=*}/billingSetups:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operation"; } } // Request message for // [BillingSetupService.GetBillingSetup][google.ads.googleads.v2.services.BillingSetupService.GetBillingSetup]. message GetBillingSetupRequest { - // The resource name of the billing setup to fetch. - string resource_name = 1; + // Required. The resource name of the billing setup to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/BillingSetup" + } + ]; } // Request message for billing setup mutate operations. message MutateBillingSetupRequest { - // Id of the customer to apply the billing setup mutate operation to. - string customer_id = 1; + // Required. Id of the customer to apply the billing setup mutate operation to. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The operation to perform. - BillingSetupOperation operation = 2; + // Required. The operation to perform. + BillingSetupOperation operation = 2 [(google.api.field_behavior) = REQUIRED]; } // A single operation on a billing setup, which describes the cancellation of an diff --git a/third_party/googleapis/google/ads/googleads/v2/services/campaign_audience_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/campaign_audience_view_service.proto index 410da40a2..073f5eff2 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/campaign_audience_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/campaign_audience_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/campaign_audience_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service CampaignAudienceViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/campaignAudienceViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [CampaignAudienceViewService.GetCampaignAudienceView][google.ads.googleads.v2.services.CampaignAudienceViewService.GetCampaignAudienceView]. message GetCampaignAudienceViewRequest { - // The resource name of the campaign audience view to fetch. - string resource_name = 1; + // Required. The resource name of the campaign audience view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignAudienceView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/campaign_bid_modifier_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/campaign_bid_modifier_service.proto index 3ed35d600..f8fc61b0e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/campaign_bid_modifier_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/campaign_bid_modifier_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/campaign_bid_modifier.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,6 +44,7 @@ service CampaignBidModifierService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/campaignBidModifiers/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes campaign bid modifiers. @@ -52,22 +54,28 @@ service CampaignBidModifierService { post: "/v2/customers/{customer_id=*}/campaignBidModifiers:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [CampaignBidModifierService.GetCampaignBidModifier][google.ads.googleads.v2.services.CampaignBidModifierService.GetCampaignBidModifier]. message GetCampaignBidModifierRequest { - // The resource name of the campaign bid modifier to fetch. - string resource_name = 1; + // Required. The resource name of the campaign bid modifier to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignBidModifier" + } + ]; } // Request message for [CampaignBidModifierService.MutateCampaignBidModifier][]. message MutateCampaignBidModifiersRequest { - // ID of the customer whose campaign bid modifiers are being modified. - string customer_id = 1; + // Required. ID of the customer whose campaign bid modifiers are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual campaign bid modifiers. - repeated CampaignBidModifierOperation operations = 2; + // Required. The list of operations to perform on individual campaign bid modifiers. + repeated CampaignBidModifierOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/campaign_budget_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/campaign_budget_service.proto index a9171c897..ed7b9a66e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/campaign_budget_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/campaign_budget_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/campaign_budget.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,6 +44,7 @@ service CampaignBudgetService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/campaignBudgets/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes campaign budgets. Operation statuses are @@ -52,22 +54,28 @@ service CampaignBudgetService { post: "/v2/customers/{customer_id=*}/campaignBudgets:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [CampaignBudgetService.GetCampaignBudget][google.ads.googleads.v2.services.CampaignBudgetService.GetCampaignBudget]. message GetCampaignBudgetRequest { - // The resource name of the campaign budget to fetch. - string resource_name = 1; + // Required. The resource name of the campaign budget to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignBudget" + } + ]; } // Request message for [CampaignBudgetService.MutateCampaignBudgets][google.ads.googleads.v2.services.CampaignBudgetService.MutateCampaignBudgets]. message MutateCampaignBudgetsRequest { - // The ID of the customer whose campaign budgets are being modified. - string customer_id = 1; + // Required. The ID of the customer whose campaign budgets are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual campaign budgets. - repeated CampaignBudgetOperation operations = 2; + // Required. The list of operations to perform on individual campaign budgets. + repeated CampaignBudgetOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/campaign_criterion_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/campaign_criterion_service.proto index ae4c60080..791bd33af 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/campaign_criterion_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/campaign_criterion_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/campaign_criterion.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,6 +44,7 @@ service CampaignCriterionService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/campaignCriteria/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes criteria. Operation statuses are returned. @@ -51,22 +53,28 @@ service CampaignCriterionService { post: "/v2/customers/{customer_id=*}/campaignCriteria:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [CampaignCriterionService.GetCampaignCriterion][google.ads.googleads.v2.services.CampaignCriterionService.GetCampaignCriterion]. message GetCampaignCriterionRequest { - // The resource name of the criterion to fetch. - string resource_name = 1; + // Required. The resource name of the criterion to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignCriterion" + } + ]; } // Request message for [CampaignCriterionService.MutateCampaignCriteria][google.ads.googleads.v2.services.CampaignCriterionService.MutateCampaignCriteria]. message MutateCampaignCriteriaRequest { - // The ID of the customer whose criteria are being modified. - string customer_id = 1; + // Required. The ID of the customer whose criteria are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual criteria. - repeated CampaignCriterionOperation operations = 2; + // Required. The list of operations to perform on individual criteria. + repeated CampaignCriterionOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/campaign_criterion_simulation_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/campaign_criterion_simulation_service.proto index 2c7e8dd72..670092916 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/campaign_criterion_simulation_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/campaign_criterion_simulation_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/campaign_criterion_simulation.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,12 +42,18 @@ service CampaignCriterionSimulationService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/campaignCriterionSimulations/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for // [CampaignCriterionSimulationService.GetCampaignCriterionSimulation][google.ads.googleads.v2.services.CampaignCriterionSimulationService.GetCampaignCriterionSimulation]. message GetCampaignCriterionSimulationRequest { - // The resource name of the campaign criterion simulation to fetch. - string resource_name = 1; + // Required. The resource name of the campaign criterion simulation to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignCriterionSimulation" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/campaign_draft_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/campaign_draft_service.proto index bd0b6cb0d..ab44f78a9 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/campaign_draft_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/campaign_draft_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,10 +18,12 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/campaign_draft.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/longrunning/operations.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -44,6 +45,7 @@ service CampaignDraftService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/campaignDrafts/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes campaign drafts. Operation statuses are @@ -53,6 +55,7 @@ service CampaignDraftService { post: "/v2/customers/{customer_id=*}/campaignDrafts:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } // Promotes the changes in a draft back to the base campaign. @@ -69,6 +72,11 @@ service CampaignDraftService { post: "/v2/{campaign_draft=customers/*/campaignDrafts/*}:promote" body: "*" }; + option (google.api.method_signature) = "campaign_draft"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "google.protobuf.Empty" + }; } // Returns all errors that occurred during CampaignDraft promote. Throws an @@ -78,22 +86,28 @@ service CampaignDraftService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/campaignDrafts/*}:listAsyncErrors" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [CampaignDraftService.GetCampaignDraft][google.ads.googleads.v2.services.CampaignDraftService.GetCampaignDraft]. message GetCampaignDraftRequest { - // The resource name of the campaign draft to fetch. - string resource_name = 1; + // Required. The resource name of the campaign draft to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignDraft" + } + ]; } // Request message for [CampaignDraftService.MutateCampaignDrafts][google.ads.googleads.v2.services.CampaignDraftService.MutateCampaignDrafts]. message MutateCampaignDraftsRequest { - // The ID of the customer whose campaign drafts are being modified. - string customer_id = 1; + // Required. The ID of the customer whose campaign drafts are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual campaign drafts. - repeated CampaignDraftOperation operations = 2; + // Required. The list of operations to perform on individual campaign drafts. + repeated CampaignDraftOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried @@ -108,8 +122,8 @@ message MutateCampaignDraftsRequest { // Request message for [CampaignDraftService.PromoteCampaignDraft][google.ads.googleads.v2.services.CampaignDraftService.PromoteCampaignDraft]. message PromoteCampaignDraftRequest { - // The resource name of the campaign draft to promote. - string campaign_draft = 1; + // Required. The resource name of the campaign draft to promote. + string campaign_draft = 1 [(google.api.field_behavior) = REQUIRED]; } // A single operation (create, update, remove) on a campaign draft. @@ -155,8 +169,13 @@ message MutateCampaignDraftResult { // Request message for [CampaignDraftService.ListCampaignDraftAsyncErrors][google.ads.googleads.v2.services.CampaignDraftService.ListCampaignDraftAsyncErrors]. message ListCampaignDraftAsyncErrorsRequest { - // The name of the campaign draft from which to retrieve the async errors. - string resource_name = 1; + // Required. The name of the campaign draft from which to retrieve the async errors. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignDraft" + } + ]; // Token of the page to retrieve. If not specified, the first // page of results will be returned. Use the value obtained from diff --git a/third_party/googleapis/google/ads/googleads/v2/services/campaign_experiment_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/campaign_experiment_service.proto index 8707bece2..c6e9eede2 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/campaign_experiment_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/campaign_experiment_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,11 +18,13 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/campaign_experiment.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/longrunning/operations.proto"; import "google/protobuf/empty.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -54,6 +55,7 @@ service CampaignExperimentService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/campaignExperiments/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates a campaign experiment based on a campaign draft. The draft campaign @@ -71,6 +73,11 @@ service CampaignExperimentService { post: "/v2/customers/{customer_id=*}/campaignExperiments:create" body: "*" }; + option (google.api.method_signature) = "customer_id,campaign_experiment"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "google.ads.googleads.v2.services.CreateCampaignExperimentMetadata" + }; } // Updates campaign experiments. Operation statuses are returned. @@ -79,6 +86,7 @@ service CampaignExperimentService { post: "/v2/customers/{customer_id=*}/campaignExperiments:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } // Graduates a campaign experiment to a full campaign. The base and experiment @@ -88,6 +96,7 @@ service CampaignExperimentService { post: "/v2/{campaign_experiment=customers/*/campaignExperiments/*}:graduate" body: "*" }; + option (google.api.method_signature) = "campaign_experiment,campaign_budget"; } // Promotes the changes in a experiment campaign back to the base campaign. @@ -101,6 +110,11 @@ service CampaignExperimentService { post: "/v2/{campaign_experiment=customers/*/campaignExperiments/*}:promote" body: "*" }; + option (google.api.method_signature) = "campaign_experiment"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "google.protobuf.Empty" + }; } // Immediately ends a campaign experiment, changing the experiment's scheduled @@ -111,6 +125,7 @@ service CampaignExperimentService { post: "/v2/{campaign_experiment=customers/*/campaignExperiments/*}:end" body: "*" }; + option (google.api.method_signature) = "campaign_experiment"; } // Returns all errors that occurred during CampaignExperiment create or @@ -120,22 +135,28 @@ service CampaignExperimentService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/campaignExperiments/*}:listAsyncErrors" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [CampaignExperimentService.GetCampaignExperiment][google.ads.googleads.v2.services.CampaignExperimentService.GetCampaignExperiment]. message GetCampaignExperimentRequest { - // The resource name of the campaign experiment to fetch. - string resource_name = 1; + // Required. The resource name of the campaign experiment to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignExperiment" + } + ]; } // Request message for [CampaignExperimentService.MutateCampaignExperiments][google.ads.googleads.v2.services.CampaignExperimentService.MutateCampaignExperiments]. message MutateCampaignExperimentsRequest { - // The ID of the customer whose campaign experiments are being modified. - string customer_id = 1; + // Required. The ID of the customer whose campaign experiments are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual campaign experiments. - repeated CampaignExperimentOperation operations = 2; + // Required. The list of operations to perform on individual campaign experiments. + repeated CampaignExperimentOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried @@ -187,11 +208,11 @@ message MutateCampaignExperimentResult { // Request message for [CampaignExperimentService.CreateCampaignExperiment][google.ads.googleads.v2.services.CampaignExperimentService.CreateCampaignExperiment]. message CreateCampaignExperimentRequest { - // The ID of the customer whose campaign experiment is being created. - string customer_id = 1; + // Required. The ID of the customer whose campaign experiment is being created. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The campaign experiment to be created. - google.ads.googleads.v2.resources.CampaignExperiment campaign_experiment = 2; + // Required. The campaign experiment to be created. + google.ads.googleads.v2.resources.CampaignExperiment campaign_experiment = 2 [(google.api.field_behavior) = REQUIRED]; // If true, the request is validated but not executed. Only errors are // returned, not results. @@ -207,12 +228,12 @@ message CreateCampaignExperimentMetadata { // Request message for [CampaignExperimentService.GraduateCampaignExperiment][google.ads.googleads.v2.services.CampaignExperimentService.GraduateCampaignExperiment]. message GraduateCampaignExperimentRequest { - // The resource name of the campaign experiment to graduate. - string campaign_experiment = 1; + // Required. The resource name of the campaign experiment to graduate. + string campaign_experiment = 1 [(google.api.field_behavior) = REQUIRED]; - // Resource name of the budget to attach to the campaign graduated from the + // Required. Resource name of the budget to attach to the campaign graduated from the // experiment. - string campaign_budget = 2; + string campaign_budget = 2 [(google.api.field_behavior) = REQUIRED]; } // Response message for campaign experiment graduate. @@ -224,22 +245,27 @@ message GraduateCampaignExperimentResponse { // Request message for [CampaignExperimentService.PromoteCampaignExperiment][google.ads.googleads.v2.services.CampaignExperimentService.PromoteCampaignExperiment]. message PromoteCampaignExperimentRequest { - // The resource name of the campaign experiment to promote. - string campaign_experiment = 1; + // Required. The resource name of the campaign experiment to promote. + string campaign_experiment = 1 [(google.api.field_behavior) = REQUIRED]; } // Request message for [CampaignExperimentService.EndCampaignExperiment][google.ads.googleads.v2.services.CampaignExperimentService.EndCampaignExperiment]. message EndCampaignExperimentRequest { - // The resource name of the campaign experiment to end. - string campaign_experiment = 1; + // Required. The resource name of the campaign experiment to end. + string campaign_experiment = 1 [(google.api.field_behavior) = REQUIRED]; } // Request message for // [CampaignExperimentService.ListCampaignExperimentAsyncErrors][google.ads.googleads.v2.services.CampaignExperimentService.ListCampaignExperimentAsyncErrors]. message ListCampaignExperimentAsyncErrorsRequest { - // The name of the campaign experiment from which to retrieve the async + // Required. The name of the campaign experiment from which to retrieve the async // errors. - string resource_name = 1; + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignExperiment" + } + ]; // Token of the page to retrieve. If not specified, the first // page of results will be returned. Use the value obtained from diff --git a/third_party/googleapis/google/ads/googleads/v2/services/campaign_extension_setting_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/campaign_extension_setting_service.proto index 39f9221c2..04647610d 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/campaign_extension_setting_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/campaign_extension_setting_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/campaign_extension_setting.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,6 +44,7 @@ service CampaignExtensionSettingService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/campaignExtensionSettings/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes campaign extension settings. Operation @@ -52,26 +54,32 @@ service CampaignExtensionSettingService { post: "/v2/customers/{customer_id=*}/campaignExtensionSettings:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for // [CampaignExtensionSettingService.GetCampaignExtensionSetting][google.ads.googleads.v2.services.CampaignExtensionSettingService.GetCampaignExtensionSetting]. message GetCampaignExtensionSettingRequest { - // The resource name of the campaign extension setting to fetch. - string resource_name = 1; + // Required. The resource name of the campaign extension setting to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignExtensionSetting" + } + ]; } // Request message for // [CampaignExtensionSettingService.MutateCampaignExtensionSettings][google.ads.googleads.v2.services.CampaignExtensionSettingService.MutateCampaignExtensionSettings]. message MutateCampaignExtensionSettingsRequest { - // The ID of the customer whose campaign extension settings are being + // Required. The ID of the customer whose campaign extension settings are being // modified. - string customer_id = 1; + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual campaign extension + // Required. The list of operations to perform on individual campaign extension // settings. - repeated CampaignExtensionSettingOperation operations = 2; + repeated CampaignExtensionSettingOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/campaign_feed_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/campaign_feed_service.proto index 6cc483ea6..dbbc12822 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/campaign_feed_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/campaign_feed_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/campaign_feed.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,6 +44,7 @@ service CampaignFeedService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/campaignFeeds/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes campaign feeds. Operation statuses are @@ -52,22 +54,28 @@ service CampaignFeedService { post: "/v2/customers/{customer_id=*}/campaignFeeds:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [CampaignFeedService.GetCampaignFeed][google.ads.googleads.v2.services.CampaignFeedService.GetCampaignFeed]. message GetCampaignFeedRequest { - // The resource name of the campaign feed to fetch. - string resource_name = 1; + // Required. The resource name of the campaign feed to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignFeed" + } + ]; } // Request message for [CampaignFeedService.MutateCampaignFeeds][google.ads.googleads.v2.services.CampaignFeedService.MutateCampaignFeeds]. message MutateCampaignFeedsRequest { - // The ID of the customer whose campaign feeds are being modified. - string customer_id = 1; + // Required. The ID of the customer whose campaign feeds are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual campaign feeds. - repeated CampaignFeedOperation operations = 2; + // Required. The list of operations to perform on individual campaign feeds. + repeated CampaignFeedOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/campaign_label_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/campaign_label_service.proto index b08184df8..e8f68ad81 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/campaign_label_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/campaign_label_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/campaign_label.proto"; import "google/api/annotations.proto"; -import "google/rpc/status.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -42,6 +43,7 @@ service CampaignLabelService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/campaignLabels/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates and removes campaign-label relationships. @@ -51,22 +53,28 @@ service CampaignLabelService { post: "/v2/customers/{customer_id=*}/campaignLabels:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [CampaignLabelService.GetCampaignLabel][google.ads.googleads.v2.services.CampaignLabelService.GetCampaignLabel]. message GetCampaignLabelRequest { - // The resource name of the campaign-label relationship to fetch. - string resource_name = 1; + // Required. The resource name of the campaign-label relationship to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignLabel" + } + ]; } // Request message for [CampaignLabelService.MutateCampaignLabels][google.ads.googleads.v2.services.CampaignLabelService.MutateCampaignLabels]. message MutateCampaignLabelsRequest { - // ID of the customer whose campaign-label relationships are being modified. - string customer_id = 1; + // Required. ID of the customer whose campaign-label relationships are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on campaign-label relationships. - repeated CampaignLabelOperation operations = 2; + // Required. The list of operations to perform on campaign-label relationships. + repeated CampaignLabelOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/campaign_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/campaign_service.proto index d972fa6cd..77ba8364a 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/campaign_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/campaign_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/campaign.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,6 +44,7 @@ service CampaignService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/campaigns/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes campaigns. Operation statuses are returned. @@ -51,22 +53,28 @@ service CampaignService { post: "/v2/customers/{customer_id=*}/campaigns:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [CampaignService.GetCampaign][google.ads.googleads.v2.services.CampaignService.GetCampaign]. message GetCampaignRequest { - // The resource name of the campaign to fetch. - string resource_name = 1; + // Required. The resource name of the campaign to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; } // Request message for [CampaignService.MutateCampaigns][google.ads.googleads.v2.services.CampaignService.MutateCampaigns]. message MutateCampaignsRequest { - // The ID of the customer whose campaigns are being modified. - string customer_id = 1; + // Required. The ID of the customer whose campaigns are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual campaigns. - repeated CampaignOperation operations = 2; + // Required. The list of operations to perform on individual campaigns. + repeated CampaignOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/campaign_shared_set_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/campaign_shared_set_service.proto index 9e358599c..778693aea 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/campaign_shared_set_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/campaign_shared_set_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/campaign_shared_set.proto"; import "google/api/annotations.proto"; -import "google/rpc/status.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -42,6 +43,7 @@ service CampaignSharedSetService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/campaignSharedSets/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates or removes campaign shared sets. Operation statuses are returned. @@ -50,22 +52,28 @@ service CampaignSharedSetService { post: "/v2/customers/{customer_id=*}/campaignSharedSets:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [CampaignSharedSetService.GetCampaignSharedSet][google.ads.googleads.v2.services.CampaignSharedSetService.GetCampaignSharedSet]. message GetCampaignSharedSetRequest { - // The resource name of the campaign shared set to fetch. - string resource_name = 1; + // Required. The resource name of the campaign shared set to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignSharedSet" + } + ]; } // Request message for [CampaignSharedSetService.MutateCampaignSharedSets][google.ads.googleads.v2.services.CampaignSharedSetService.MutateCampaignSharedSets]. message MutateCampaignSharedSetsRequest { - // The ID of the customer whose campaign shared sets are being modified. - string customer_id = 1; + // Required. The ID of the customer whose campaign shared sets are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual campaign shared sets. - repeated CampaignSharedSetOperation operations = 2; + // Required. The list of operations to perform on individual campaign shared sets. + repeated CampaignSharedSetOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/carrier_constant_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/carrier_constant_service.proto index 20cc19c9a..e8592dc0f 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/carrier_constant_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/carrier_constant_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/carrier_constant.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service CarrierConstantService { option (google.api.http) = { get: "/v2/{resource_name=carrierConstants/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [CarrierConstantService.GetCarrierConstant][google.ads.googleads.v2.services.CarrierConstantService.GetCarrierConstant]. message GetCarrierConstantRequest { - // Resource name of the carrier constant to fetch. - string resource_name = 1; + // Required. Resource name of the carrier constant to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CarrierConstant" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/change_status_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/change_status_service.proto index 29014b304..4402e16a3 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/change_status_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/change_status_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/change_status.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service ChangeStatusService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/changeStatus/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for '[ChangeStatusService.GetChangeStatus][google.ads.googleads.v2.services.ChangeStatusService.GetChangeStatus]'. message GetChangeStatusRequest { - // The resource name of the change status to fetch. - string resource_name = 1; + // Required. The resource name of the change status to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ChangeStatus" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/click_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/click_view_service.proto index f6a68b142..fe002e75d 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/click_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/click_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/click_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service ClickViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/clickViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [ClickViewService.GetClickView][google.ads.googleads.v2.services.ClickViewService.GetClickView]. message GetClickViewRequest { - // The resource name of the click view to fetch. - string resource_name = 1; + // Required. The resource name of the click view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ClickView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/conversion_action_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/conversion_action_service.proto index d056d551d..571055485 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/conversion_action_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/conversion_action_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/conversion_action.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,6 +44,7 @@ service ConversionActionService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/conversionActions/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates or removes conversion actions. Operation statuses are @@ -52,22 +54,28 @@ service ConversionActionService { post: "/v2/customers/{customer_id=*}/conversionActions:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [ConversionActionService.GetConversionAction][google.ads.googleads.v2.services.ConversionActionService.GetConversionAction]. message GetConversionActionRequest { - // The resource name of the conversion action to fetch. - string resource_name = 1; + // Required. The resource name of the conversion action to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ConversionAction" + } + ]; } // Request message for [ConversionActionService.MutateConversionActions][google.ads.googleads.v2.services.ConversionActionService.MutateConversionActions]. message MutateConversionActionsRequest { - // The ID of the customer whose conversion actions are being modified. - string customer_id = 1; + // Required. The ID of the customer whose conversion actions are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual conversion actions. - repeated ConversionActionOperation operations = 2; + // Required. The list of operations to perform on individual conversion actions. + repeated ConversionActionOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/conversion_adjustment_upload_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/conversion_adjustment_upload_service.proto index 7b643cfad..96c65bf3f 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/conversion_adjustment_upload_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/conversion_adjustment_upload_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,10 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/enums/conversion_adjustment_type.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -42,17 +42,18 @@ service ConversionAdjustmentUploadService { post: "/v2/customers/{customer_id=*}:uploadConversionAdjustments" body: "*" }; + option (google.api.method_signature) = "customer_id,conversion_adjustments"; } } // Request message for // [ConversionAdjustmentUploadService.UploadConversionAdjustments][google.ads.googleads.v2.services.ConversionAdjustmentUploadService.UploadConversionAdjustments]. message UploadConversionAdjustmentsRequest { - // The ID of the customer performing the upload. - string customer_id = 1; + // Required. The ID of the customer performing the upload. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The conversion adjustments that are being uploaded. - repeated ConversionAdjustment conversion_adjustments = 2; + // Required. The conversion adjustments that are being uploaded. + repeated ConversionAdjustment conversion_adjustments = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried out diff --git a/third_party/googleapis/google/ads/googleads/v2/services/conversion_upload_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/conversion_upload_service.proto index de70a7909..bd5ab39c6 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/conversion_upload_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/conversion_upload_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,16 +11,16 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.ads.googleads.v2.services; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,6 +41,7 @@ service ConversionUploadService { post: "/v2/customers/{customer_id=*}:uploadClickConversions" body: "*" }; + option (google.api.method_signature) = "customer_id,conversions"; } // Processes the given call conversions. @@ -49,16 +50,17 @@ service ConversionUploadService { post: "/v2/customers/{customer_id=*}:uploadCallConversions" body: "*" }; + option (google.api.method_signature) = "customer_id,conversions"; } } // Request message for [ConversionUploadService.UploadClickConversions][google.ads.googleads.v2.services.ConversionUploadService.UploadClickConversions]. message UploadClickConversionsRequest { - // The ID of the customer performing the upload. - string customer_id = 1; + // Required. The ID of the customer performing the upload. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The conversions that are being uploaded. - repeated ClickConversion conversions = 2; + // Required. The conversions that are being uploaded. + repeated ClickConversion conversions = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried @@ -86,11 +88,11 @@ message UploadClickConversionsResponse { // Request message for [ConversionUploadService.UploadCallConversions][google.ads.googleads.v2.services.ConversionUploadService.UploadCallConversions]. message UploadCallConversionsRequest { - // The ID of the customer performing the upload. - string customer_id = 1; + // Required. The ID of the customer performing the upload. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The conversions that are being uploaded. - repeated CallConversion conversions = 2; + // Required. The conversions that are being uploaded. + repeated CallConversion conversions = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/custom_interest_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/custom_interest_service.proto index eef10f29f..11fa505b0 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/custom_interest_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/custom_interest_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/custom_interest.proto"; import "google/api/annotations.proto"; -import "google/protobuf/field_mask.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -42,6 +43,7 @@ service CustomInterestService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/customInterests/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates or updates custom interests. Operation statuses are returned. @@ -50,22 +52,28 @@ service CustomInterestService { post: "/v2/customers/{customer_id=*}/customInterests:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [CustomInterestService.GetCustomInterest][google.ads.googleads.v2.services.CustomInterestService.GetCustomInterest]. message GetCustomInterestRequest { - // The resource name of the custom interest to fetch. - string resource_name = 1; + // Required. The resource name of the custom interest to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomInterest" + } + ]; } // Request message for [CustomInterestService.MutateCustomInterests][google.ads.googleads.v2.services.CustomInterestService.MutateCustomInterests]. message MutateCustomInterestsRequest { - // The ID of the customer whose custom interests are being modified. - string customer_id = 1; + // Required. The ID of the customer whose custom interests are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual custom interests. - repeated CustomInterestOperation operations = 2; + // Required. The list of operations to perform on individual custom interests. + repeated CustomInterestOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, the request is validated but not executed. Only errors are // returned, not results. diff --git a/third_party/googleapis/google/ads/googleads/v2/services/customer_client_link_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/customer_client_link_service.proto index 747309999..198a48780 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/customer_client_link_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/customer_client_link_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/customer_client_link.proto"; import "google/api/annotations.proto"; -import "google/protobuf/field_mask.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -40,6 +41,7 @@ service CustomerClientLinkService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/customerClientLinks/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates or updates a customer client link. Operation statuses are returned. @@ -48,22 +50,28 @@ service CustomerClientLinkService { post: "/v2/customers/{customer_id=*}/customerClientLinks:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operation"; } } // Request message for [CustomerClientLinkService.GetCustomerClientLink][google.ads.googleads.v2.services.CustomerClientLinkService.GetCustomerClientLink]. message GetCustomerClientLinkRequest { - // The resource name of the customer client link to fetch. - string resource_name = 1; + // Required. The resource name of the customer client link to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerClientLink" + } + ]; } // Request message for [CustomerClientLinkService.MutateCustomerClientLink][google.ads.googleads.v2.services.CustomerClientLinkService.MutateCustomerClientLink]. message MutateCustomerClientLinkRequest { - // The ID of the customer whose customer link are being modified. - string customer_id = 1; + // Required. The ID of the customer whose customer link are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The operation to perform on the individual CustomerClientLink. - CustomerClientLinkOperation operation = 2; + // Required. The operation to perform on the individual CustomerClientLink. + CustomerClientLinkOperation operation = 2 [(google.api.field_behavior) = REQUIRED]; } // A single operation (create, update) on a CustomerClientLink. diff --git a/third_party/googleapis/google/ads/googleads/v2/services/customer_client_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/customer_client_service.proto index 495d8c118..99f60b2ed 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/customer_client_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/customer_client_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/customer_client.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service CustomerClientService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/customerClients/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [CustomerClientService.GetCustomerClient][google.ads.googleads.v2.services.CustomerClientService.GetCustomerClient]. message GetCustomerClientRequest { - // The resource name of the client to fetch. - string resource_name = 1; + // Required. The resource name of the client to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerClient" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/customer_extension_setting_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/customer_extension_setting_service.proto index 7dce72c4a..bd08f5eb8 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/customer_extension_setting_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/customer_extension_setting_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/customer_extension_setting.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,6 +44,7 @@ service CustomerExtensionSettingService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/customerExtensionSettings/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes customer extension settings. Operation @@ -52,26 +54,32 @@ service CustomerExtensionSettingService { post: "/v2/customers/{customer_id=*}/customerExtensionSettings:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for // [CustomerExtensionSettingService.GetCustomerExtensionSetting][google.ads.googleads.v2.services.CustomerExtensionSettingService.GetCustomerExtensionSetting]. message GetCustomerExtensionSettingRequest { - // The resource name of the customer extension setting to fetch. - string resource_name = 1; + // Required. The resource name of the customer extension setting to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerExtensionSetting" + } + ]; } // Request message for // [CustomerExtensionSettingService.MutateCustomerExtensionSettings][google.ads.googleads.v2.services.CustomerExtensionSettingService.MutateCustomerExtensionSettings]. message MutateCustomerExtensionSettingsRequest { - // The ID of the customer whose customer extension settings are being + // Required. The ID of the customer whose customer extension settings are being // modified. - string customer_id = 1; + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual customer extension + // Required. The list of operations to perform on individual customer extension // settings. - repeated CustomerExtensionSettingOperation operations = 2; + repeated CustomerExtensionSettingOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/customer_feed_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/customer_feed_service.proto index 5cfde1128..ee15cd526 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/customer_feed_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/customer_feed_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/customer_feed.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,6 +44,7 @@ service CustomerFeedService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/customerFeeds/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes customer feeds. Operation statuses are @@ -52,22 +54,28 @@ service CustomerFeedService { post: "/v2/customers/{customer_id=*}/customerFeeds:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [CustomerFeedService.GetCustomerFeed][google.ads.googleads.v2.services.CustomerFeedService.GetCustomerFeed]. message GetCustomerFeedRequest { - // The resource name of the customer feed to fetch. - string resource_name = 1; + // Required. The resource name of the customer feed to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerFeed" + } + ]; } // Request message for [CustomerFeedService.MutateCustomerFeeds][google.ads.googleads.v2.services.CustomerFeedService.MutateCustomerFeeds]. message MutateCustomerFeedsRequest { - // The ID of the customer whose customer feeds are being modified. - string customer_id = 1; + // Required. The ID of the customer whose customer feeds are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual customer feeds. - repeated CustomerFeedOperation operations = 2; + // Required. The list of operations to perform on individual customer feeds. + repeated CustomerFeedOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/customer_label_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/customer_label_service.proto index 00f8cb254..e8424b664 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/customer_label_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/customer_label_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/customer_label.proto"; import "google/api/annotations.proto"; -import "google/rpc/status.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -42,6 +43,7 @@ service CustomerLabelService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/customerLabels/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates and removes customer-label relationships. @@ -51,22 +53,28 @@ service CustomerLabelService { post: "/v2/customers/{customer_id=*}/customerLabels:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [CustomerLabelService.GetCustomerLabel][google.ads.googleads.v2.services.CustomerLabelService.GetCustomerLabel]. message GetCustomerLabelRequest { - // The resource name of the customer-label relationship to fetch. - string resource_name = 1; + // Required. The resource name of the customer-label relationship to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerLabel" + } + ]; } // Request message for [CustomerLabelService.MutateCustomerLabels][google.ads.googleads.v2.services.CustomerLabelService.MutateCustomerLabels]. message MutateCustomerLabelsRequest { - // ID of the customer whose customer-label relationships are being modified. - string customer_id = 1; + // Required. ID of the customer whose customer-label relationships are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on customer-label relationships. - repeated CustomerLabelOperation operations = 2; + // Required. The list of operations to perform on customer-label relationships. + repeated CustomerLabelOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/customer_manager_link_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/customer_manager_link_service.proto index b98cb3df1..6b89892fa 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/customer_manager_link_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/customer_manager_link_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/customer_manager_link.proto"; import "google/api/annotations.proto"; -import "google/protobuf/field_mask.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -40,6 +41,7 @@ service CustomerManagerLinkService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/customerManagerLinks/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates or updates customer manager links. Operation statuses are returned. @@ -48,22 +50,28 @@ service CustomerManagerLinkService { post: "/v2/customers/{customer_id=*}/customerManagerLinks:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [CustomerManagerLinkService.GetCustomerManagerLink][google.ads.googleads.v2.services.CustomerManagerLinkService.GetCustomerManagerLink]. message GetCustomerManagerLinkRequest { - // The resource name of the CustomerManagerLink to fetch. - string resource_name = 1; + // Required. The resource name of the CustomerManagerLink to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerManagerLink" + } + ]; } // Request message for [CustomerManagerLinkService.MutateCustomerManagerLink][google.ads.googleads.v2.services.CustomerManagerLinkService.MutateCustomerManagerLink]. message MutateCustomerManagerLinkRequest { - // The ID of the customer whose customer manager links are being modified. - string customer_id = 1; + // Required. The ID of the customer whose customer manager links are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual customer manager links. - repeated CustomerManagerLinkOperation operations = 2; + // Required. The list of operations to perform on individual customer manager links. + repeated CustomerManagerLinkOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; } // Updates the status of a CustomerManagerLink. diff --git a/third_party/googleapis/google/ads/googleads/v2/services/customer_negative_criterion_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/customer_negative_criterion_service.proto index bcd6d2a2d..bdb7aa50c 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/customer_negative_criterion_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/customer_negative_criterion_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/customer_negative_criterion.proto"; import "google/api/annotations.proto"; -import "google/rpc/status.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -42,6 +43,7 @@ service CustomerNegativeCriterionService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/customerNegativeCriteria/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates or removes criteria. Operation statuses are returned. @@ -50,24 +52,30 @@ service CustomerNegativeCriterionService { post: "/v2/customers/{customer_id=*}/customerNegativeCriteria:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for // [CustomerNegativeCriterionService.GetCustomerNegativeCriterion][google.ads.googleads.v2.services.CustomerNegativeCriterionService.GetCustomerNegativeCriterion]. message GetCustomerNegativeCriterionRequest { - // The resource name of the criterion to fetch. - string resource_name = 1; + // Required. The resource name of the criterion to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerNegativeCriterion" + } + ]; } // Request message for // [CustomerNegativeCriterionService.MutateCustomerNegativeCriteria][google.ads.googleads.v2.services.CustomerNegativeCriterionService.MutateCustomerNegativeCriteria]. message MutateCustomerNegativeCriteriaRequest { - // The ID of the customer whose criteria are being modified. - string customer_id = 1; + // Required. The ID of the customer whose criteria are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual criteria. - repeated CustomerNegativeCriterionOperation operations = 2; + // Required. The list of operations to perform on individual criteria. + repeated CustomerNegativeCriterionOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/customer_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/customer_service.proto index beba6c60e..260999b61 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/customer_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/customer_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,9 +19,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/enums/access_role.proto"; import "google/ads/googleads/v2/resources/customer.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/protobuf/wrappers.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -44,6 +45,7 @@ service CustomerService { option (google.api.http) = { get: "/v2/{resource_name=customers/*}" }; + option (google.api.method_signature) = "resource_name"; } // Updates a customer. Operation statuses are returned. @@ -52,6 +54,7 @@ service CustomerService { post: "/v2/customers/{customer_id=*}:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operation"; } // Returns resource names of customers directly accessible by the @@ -68,22 +71,28 @@ service CustomerService { post: "/v2/customers/{customer_id=*}:createCustomerClient" body: "*" }; + option (google.api.method_signature) = "customer_id,customer_client"; } } // Request message for [CustomerService.GetCustomer][google.ads.googleads.v2.services.CustomerService.GetCustomer]. message GetCustomerRequest { - // The resource name of the customer to fetch. - string resource_name = 1; + // Required. The resource name of the customer to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Customer" + } + ]; } // Request message for [CustomerService.MutateCustomer][google.ads.googleads.v2.services.CustomerService.MutateCustomer]. message MutateCustomerRequest { - // The ID of the customer being modified. - string customer_id = 1; + // Required. The ID of the customer being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The operation to perform on the customer - CustomerOperation operation = 4; + // Required. The operation to perform on the customer + CustomerOperation operation = 4 [(google.api.field_behavior) = REQUIRED]; // If true, the request is validated but not executed. Only errors are // returned, not results. @@ -92,12 +101,12 @@ message MutateCustomerRequest { // Request message for [CustomerService.CreateCustomerClient][google.ads.googleads.v2.services.CustomerService.CreateCustomerClient]. message CreateCustomerClientRequest { - // The ID of the Manager under whom client customer is being created. - string customer_id = 1; + // Required. The ID of the Manager under whom client customer is being created. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The new client customer to create. The resource name on this customer + // Required. The new client customer to create. The resource name on this customer // will be ignored. - google.ads.googleads.v2.resources.Customer customer_client = 2; + google.ads.googleads.v2.resources.Customer customer_client = 2 [(google.api.field_behavior) = REQUIRED]; // Email address of the user who should be invited on the created client // customer. Accessible to whitelisted customers only. diff --git a/third_party/googleapis/google/ads/googleads/v2/services/detail_placement_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/detail_placement_view_service.proto index 21847c11b..bfcb3a5f6 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/detail_placement_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/detail_placement_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/detail_placement_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service DetailPlacementViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/detailPlacementViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [DetailPlacementViewService.GetDetailPlacementView][google.ads.googleads.v2.services.DetailPlacementViewService.GetDetailPlacementView]. message GetDetailPlacementViewRequest { - // The resource name of the Detail Placement view to fetch. - string resource_name = 1; + // Required. The resource name of the Detail Placement view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DetailPlacementView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/display_keyword_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/display_keyword_view_service.proto index 22c82bf5f..98693bbf4 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/display_keyword_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/display_keyword_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/display_keyword_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service DisplayKeywordViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/displayKeywordViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [DisplayKeywordViewService.GetDisplayKeywordView][google.ads.googleads.v2.services.DisplayKeywordViewService.GetDisplayKeywordView]. message GetDisplayKeywordViewRequest { - // The resource name of the display keyword view to fetch. - string resource_name = 1; + // Required. The resource name of the display keyword view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DisplayKeywordView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/distance_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/distance_view_service.proto index 44ffaf91e..75440d2b4 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/distance_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/distance_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/distance_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service DistanceViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/distanceViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [DistanceViewService.GetDistanceView][google.ads.googleads.v2.services.DistanceViewService.GetDistanceView]. message GetDistanceViewRequest { - // The resource name of the distance view to fetch. - string resource_name = 1; + // Required. The resource name of the distance view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DistanceView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/domain_category_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/domain_category_service.proto index eba38c15d..2b6242da6 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/domain_category_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/domain_category_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/domain_category.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,12 +42,18 @@ service DomainCategoryService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/domainCategories/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for // [DomainCategoryService.GetDomainCategory][google.ads.googleads.v2.services.DomainCategoryService.GetDomainCategory]. message GetDomainCategoryRequest { - // Resource name of the domain category to fetch. - string resource_name = 1; + // Required. Resource name of the domain category to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DomainCategory" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/dynamic_search_ads_search_term_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/dynamic_search_ads_search_term_view_service.proto index 922b7e705..3bb4dd6c1 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/dynamic_search_ads_search_term_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/dynamic_search_ads_search_term_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/dynamic_search_ads_search_term_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,12 +42,18 @@ service DynamicSearchAdsSearchTermViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/dynamicSearchAdsSearchTermViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for // [DynamicSearchAdsSearchTermViewService.GetDynamicSearchAdsSearchTermView][google.ads.googleads.v2.services.DynamicSearchAdsSearchTermViewService.GetDynamicSearchAdsSearchTermView]. message GetDynamicSearchAdsSearchTermViewRequest { - // The resource name of the dynamic search ads search term view to fetch. - string resource_name = 1; + // Required. The resource name of the dynamic search ads search term view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DynamicSearchAdsSearchTermView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/expanded_landing_page_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/expanded_landing_page_view_service.proto index 96cf5701d..d7b26b5a0 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/expanded_landing_page_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/expanded_landing_page_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/expanded_landing_page_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,12 +42,18 @@ service ExpandedLandingPageViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/expandedLandingPageViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for // [ExpandedLandingPageViewService.GetExpandedLandingPageView][google.ads.googleads.v2.services.ExpandedLandingPageViewService.GetExpandedLandingPageView]. message GetExpandedLandingPageViewRequest { - // The resource name of the expanded landing page view to fetch. - string resource_name = 1; + // Required. The resource name of the expanded landing page view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ExpandedLandingPageView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/extension_feed_item_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/extension_feed_item_service.proto index 5a5f65bf6..fa2ccb4f4 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/extension_feed_item_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/extension_feed_item_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/extension_feed_item.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,6 +44,7 @@ service ExtensionFeedItemService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/extensionFeedItems/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes extension feed items. Operation @@ -52,23 +54,29 @@ service ExtensionFeedItemService { post: "/v2/customers/{customer_id=*}/extensionFeedItems:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [ExtensionFeedItemService.GetExtensionFeedItem][google.ads.googleads.v2.services.ExtensionFeedItemService.GetExtensionFeedItem]. message GetExtensionFeedItemRequest { - // The resource name of the extension feed item to fetch. - string resource_name = 1; + // Required. The resource name of the extension feed item to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ExtensionFeedItem" + } + ]; } // Request message for [ExtensionFeedItemService.MutateExtensionFeedItems][google.ads.googleads.v2.services.ExtensionFeedItemService.MutateExtensionFeedItems]. message MutateExtensionFeedItemsRequest { - // The ID of the customer whose extension feed items are being + // Required. The ID of the customer whose extension feed items are being // modified. - string customer_id = 1; + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual extension feed items. - repeated ExtensionFeedItemOperation operations = 2; + // Required. The list of operations to perform on individual extension feed items. + repeated ExtensionFeedItemOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/feed_item_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/feed_item_service.proto index 3387c28f4..a91fb15f6 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/feed_item_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/feed_item_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/feed_item.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,6 +44,7 @@ service FeedItemService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/feedItems/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes feed items. Operation statuses are @@ -52,22 +54,28 @@ service FeedItemService { post: "/v2/customers/{customer_id=*}/feedItems:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [FeedItemService.GetFeedItem][google.ads.googleads.v2.services.FeedItemService.GetFeedItem]. message GetFeedItemRequest { - // The resource name of the feed item to fetch. - string resource_name = 1; + // Required. The resource name of the feed item to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedItem" + } + ]; } // Request message for [FeedItemService.MutateFeedItems][google.ads.googleads.v2.services.FeedItemService.MutateFeedItems]. message MutateFeedItemsRequest { - // The ID of the customer whose feed items are being modified. - string customer_id = 1; + // Required. The ID of the customer whose feed items are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual feed items. - repeated FeedItemOperation operations = 2; + // Required. The list of operations to perform on individual feed items. + repeated FeedItemOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/feed_item_target_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/feed_item_target_service.proto index 33a30f80a..b683d7f3c 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/feed_item_target_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/feed_item_target_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/feed_item_target.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,6 +42,7 @@ service FeedItemTargetService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/feedItemTargets/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates or removes feed item targets. Operation statuses are returned. @@ -49,22 +51,28 @@ service FeedItemTargetService { post: "/v2/customers/{customer_id=*}/feedItemTargets:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [FeedItemTargetService.GetFeedItemTarget][google.ads.googleads.v2.services.FeedItemTargetService.GetFeedItemTarget]. message GetFeedItemTargetRequest { - // The resource name of the feed item targets to fetch. - string resource_name = 1; + // Required. The resource name of the feed item targets to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedItemTarget" + } + ]; } // Request message for [FeedItemTargetService.MutateFeedItemTargets][google.ads.googleads.v2.services.FeedItemTargetService.MutateFeedItemTargets]. message MutateFeedItemTargetsRequest { - // The ID of the customer whose feed item targets are being modified. - string customer_id = 1; + // Required. The ID of the customer whose feed item targets are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual feed item targets. - repeated FeedItemTargetOperation operations = 2; + // Required. The list of operations to perform on individual feed item targets. + repeated FeedItemTargetOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; } // A single operation (create, remove) on an feed item target. diff --git a/third_party/googleapis/google/ads/googleads/v2/services/feed_mapping_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/feed_mapping_service.proto index c27fc80a4..932599c46 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/feed_mapping_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/feed_mapping_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/feed_mapping.proto"; import "google/api/annotations.proto"; -import "google/rpc/status.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -42,6 +43,7 @@ service FeedMappingService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/feedMappings/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates or removes feed mappings. Operation statuses are @@ -51,22 +53,28 @@ service FeedMappingService { post: "/v2/customers/{customer_id=*}/feedMappings:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [FeedMappingService.GetFeedMapping][google.ads.googleads.v2.services.FeedMappingService.GetFeedMapping]. message GetFeedMappingRequest { - // The resource name of the feed mapping to fetch. - string resource_name = 1; + // Required. The resource name of the feed mapping to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedMapping" + } + ]; } // Request message for [FeedMappingService.MutateFeedMappings][google.ads.googleads.v2.services.FeedMappingService.MutateFeedMappings]. message MutateFeedMappingsRequest { - // The ID of the customer whose feed mappings are being modified. - string customer_id = 1; + // Required. The ID of the customer whose feed mappings are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual feed mappings. - repeated FeedMappingOperation operations = 2; + // Required. The list of operations to perform on individual feed mappings. + repeated FeedMappingOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/feed_placeholder_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/feed_placeholder_view_service.proto index 03f7520b8..8dd0feaa1 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/feed_placeholder_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/feed_placeholder_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/feed_placeholder_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service FeedPlaceholderViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/feedPlaceholderViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [FeedPlaceholderViewService.GetFeedPlaceholderView][google.ads.googleads.v2.services.FeedPlaceholderViewService.GetFeedPlaceholderView]. message GetFeedPlaceholderViewRequest { - // The resource name of the feed placeholder view to fetch. - string resource_name = 1; + // Required. The resource name of the feed placeholder view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedPlaceholderView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/feed_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/feed_service.proto index e3f667b64..b3cb5c624 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/feed_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/feed_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/feed.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,6 +44,7 @@ service FeedService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/feeds/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes feeds. Operation statuses are @@ -52,22 +54,28 @@ service FeedService { post: "/v2/customers/{customer_id=*}/feeds:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [FeedService.GetFeed][google.ads.googleads.v2.services.FeedService.GetFeed]. message GetFeedRequest { - // The resource name of the feed to fetch. - string resource_name = 1; + // Required. The resource name of the feed to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; } // Request message for [FeedService.MutateFeeds][google.ads.googleads.v2.services.FeedService.MutateFeeds]. message MutateFeedsRequest { - // The ID of the customer whose feeds are being modified. - string customer_id = 1; + // Required. The ID of the customer whose feeds are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual feeds. - repeated FeedOperation operations = 2; + // Required. The list of operations to perform on individual feeds. + repeated FeedOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/gender_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/gender_view_service.proto index 7804be7b2..9f1bd6da9 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/gender_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/gender_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/gender_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service GenderViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/genderViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [GenderViewService.GetGenderView][google.ads.googleads.v2.services.GenderViewService.GetGenderView]. message GetGenderViewRequest { - // The resource name of the gender view to fetch. - string resource_name = 1; + // Required. The resource name of the gender view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GenderView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/geo_target_constant_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/geo_target_constant_service.proto index 45e808446..c129f69b2 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/geo_target_constant_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/geo_target_constant_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/geo_target_constant.proto"; import "google/api/annotations.proto"; -import "google/protobuf/wrappers.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -42,6 +43,7 @@ service GeoTargetConstantService { option (google.api.http) = { get: "/v2/{resource_name=geoTargetConstants/*}" }; + option (google.api.method_signature) = "resource_name"; } // Returns GeoTargetConstant suggestions by location name or by resource name. @@ -55,8 +57,13 @@ service GeoTargetConstantService { // Request message for [GeoTargetConstantService.GetGeoTargetConstant][google.ads.googleads.v2.services.GeoTargetConstantService.GetGeoTargetConstant]. message GetGeoTargetConstantRequest { - // The resource name of the geo target constant to fetch. - string resource_name = 1; + // Required. The resource name of the geo target constant to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GeoTargetConstant" + } + ]; } // Request message for diff --git a/third_party/googleapis/google/ads/googleads/v2/services/geographic_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/geographic_view_service.proto index 424710aad..cd2ca0947 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/geographic_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/geographic_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/geographic_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service GeographicViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/geographicViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [GeographicViewService.GetGeographicView][google.ads.googleads.v2.services.GeographicViewService.GetGeographicView]. message GetGeographicViewRequest { - // The resource name of the geographic view to fetch. - string resource_name = 1; + // Required. The resource name of the geographic view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GeographicView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/google_ads_field_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/google_ads_field_service.proto index 5eb683a25..66017383b 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/google_ads_field_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/google_ads_field_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/google_ads_field.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,6 +42,7 @@ service GoogleAdsFieldService { option (google.api.http) = { get: "/v2/{resource_name=googleAdsFields/*}" }; + option (google.api.method_signature) = "resource_name"; } // Returns all fields that match the search query. @@ -49,19 +51,25 @@ service GoogleAdsFieldService { post: "/v2/googleAdsFields:search" body: "*" }; + option (google.api.method_signature) = "query"; } } // Request message for [GoogleAdsFieldService.GetGoogleAdsField][google.ads.googleads.v2.services.GoogleAdsFieldService.GetGoogleAdsField]. message GetGoogleAdsFieldRequest { - // The resource name of the field to get. - string resource_name = 1; + // Required. The resource name of the field to get. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GoogleAdsField" + } + ]; } // Request message for [GoogleAdsFieldService.SearchGoogleAdsFields][google.ads.googleads.v2.services.GoogleAdsFieldService.SearchGoogleAdsFields]. message SearchGoogleAdsFieldsRequest { - // The query string. - string query = 1; + // Required. The query string. + string query = 1 [(google.api.field_behavior) = REQUIRED]; // Token of the page to retrieve. If not specified, the first page of // results will be returned. Use the value obtained from `next_page_token` diff --git a/third_party/googleapis/google/ads/googleads/v2/services/google_ads_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/google_ads_service.proto index df5197982..2ec47a0e1 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/google_ads_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/google_ads_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -155,9 +154,10 @@ import "google/ads/googleads/v2/services/shared_criterion_service.proto"; import "google/ads/googleads/v2/services/shared_set_service.proto"; import "google/ads/googleads/v2/services/user_list_service.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -180,6 +180,7 @@ service GoogleAdsService { post: "/v2/customers/{customer_id=*}/googleAds:search" body: "*" }; + option (google.api.method_signature) = "customer_id,query"; } // Creates, updates, or removes resources. This method supports atomic @@ -238,16 +239,17 @@ service GoogleAdsService { post: "/v2/customers/{customer_id=*}/googleAds:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,mutate_operations"; } } // Request message for [GoogleAdsService.Search][google.ads.googleads.v2.services.GoogleAdsService.Search]. message SearchGoogleAdsRequest { - // The ID of the customer being queried. - string customer_id = 1; + // Required. The ID of the customer being queried. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The query string. - string query = 2; + // Required. The query string. + string query = 2 [(google.api.field_behavior) = REQUIRED]; // Token of the page to retrieve. If not specified, the first // page of results will be returned. Use the value obtained from @@ -591,11 +593,11 @@ message GoogleAdsRow { // Request message for [GoogleAdsService.Mutate][google.ads.googleads.v2.services.GoogleAdsService.Mutate]. message MutateGoogleAdsRequest { - // The ID of the customer whose resources are being modified. - string customer_id = 1; + // Required. The ID of the customer whose resources are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual resources. - repeated MutateOperation mutate_operations = 2; + // Required. The list of operations to perform on individual resources. + repeated MutateOperation mutate_operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/group_placement_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/group_placement_view_service.proto index 6bdae84d9..bae213d8a 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/group_placement_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/group_placement_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/group_placement_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service GroupPlacementViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/groupPlacementViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [GroupPlacementViewService.GetGroupPlacementView][google.ads.googleads.v2.services.GroupPlacementViewService.GetGroupPlacementView]. message GetGroupPlacementViewRequest { - // The resource name of the Group Placement view to fetch. - string resource_name = 1; + // Required. The resource name of the Group Placement view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GroupPlacementView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/hotel_group_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/hotel_group_view_service.proto index 9a3ab0ddc..5e5c9a780 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/hotel_group_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/hotel_group_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/hotel_group_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service HotelGroupViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/hotelGroupViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [HotelGroupViewService.GetHotelGroupView][google.ads.googleads.v2.services.HotelGroupViewService.GetHotelGroupView]. message GetHotelGroupViewRequest { - // Resource name of the Hotel Group View to fetch. - string resource_name = 1; + // Required. Resource name of the Hotel Group View to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/HotelGroupView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/hotel_performance_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/hotel_performance_view_service.proto index ab54b8a98..2d79e92df 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/hotel_performance_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/hotel_performance_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/hotel_performance_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service HotelPerformanceViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/hotelPerformanceView}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [HotelPerformanceViewService.GetHotelPerformanceView][google.ads.googleads.v2.services.HotelPerformanceViewService.GetHotelPerformanceView]. message GetHotelPerformanceViewRequest { - // Resource name of the Hotel Performance View to fetch. - string resource_name = 1; + // Required. Resource name of the Hotel Performance View to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/HotelPerformanceView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/invoice_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/invoice_service.proto new file mode 100644 index 000000000..79e81d9a9 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v2/services/invoice_service.proto @@ -0,0 +1,72 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v2.services; + +import "google/ads/googleads/v2/enums/month_of_year.proto"; +import "google/ads/googleads/v2/resources/invoice.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; +option java_multiple_files = true; +option java_outer_classname = "InvoiceServiceProto"; +option java_package = "com.google.ads.googleads.v2.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V2\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V2::Services"; + +// Proto file describing the Invoice service. + +// A service to fetch invoices issued for a billing setup during a given month. +service InvoiceService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns all invoices associated with a billing setup, for a given month. + rpc ListInvoices(ListInvoicesRequest) returns (ListInvoicesResponse) { + option (google.api.http) = { + get: "/v2/customers/{customer_id=*}/invoices" + }; + option (google.api.method_signature) = "customer_id,billing_setup,issue_year,issue_month"; + } +} + +// Request message for fetching the invoices of a given billing setup that were +// issued during a given month. +message ListInvoicesRequest { + // Required. The ID of the customer to fetch invoices for. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The billing setup resource name of the requested invoices. + // + // `customers/{customer_id}/billingSetups/{billing_setup_id}` + string billing_setup = 2 [(google.api.field_behavior) = REQUIRED]; + + // Required. The issue year to retrieve invoices, in yyyy format. Only + // invoices issued in 2019 or later can be retrieved. + string issue_year = 3 [(google.api.field_behavior) = REQUIRED]; + + // Required. The issue month to retrieve invoices. + google.ads.googleads.v2.enums.MonthOfYearEnum.MonthOfYear issue_month = 4 [(google.api.field_behavior) = REQUIRED]; +} + +// Response message for [InvoiceService.ListInvoices][google.ads.googleads.v2.services.InvoiceService.ListInvoices]. +message ListInvoicesResponse { + // The list of invoices that match the billing setup and time period. + repeated google.ads.googleads.v2.resources.Invoice invoices = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v2/services/keyword_plan_ad_group_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/keyword_plan_ad_group_service.proto index f6ae5a9da..776c3acbb 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/keyword_plan_ad_group_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/keyword_plan_ad_group_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/keyword_plan_ad_group.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,6 +44,7 @@ service KeywordPlanAdGroupService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/keywordPlanAdGroups/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes Keyword Plan ad groups. Operation statuses are @@ -52,22 +54,28 @@ service KeywordPlanAdGroupService { post: "/v2/customers/{customer_id=*}/keywordPlanAdGroups:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [KeywordPlanAdGroupService.GetKeywordPlanAdGroup][google.ads.googleads.v2.services.KeywordPlanAdGroupService.GetKeywordPlanAdGroup]. message GetKeywordPlanAdGroupRequest { - // The resource name of the Keyword Plan ad group to fetch. - string resource_name = 1; + // Required. The resource name of the Keyword Plan ad group to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanAdGroup" + } + ]; } // Request message for [KeywordPlanAdGroupService.MutateKeywordPlanAdGroups][google.ads.googleads.v2.services.KeywordPlanAdGroupService.MutateKeywordPlanAdGroups]. message MutateKeywordPlanAdGroupsRequest { - // The ID of the customer whose Keyword Plan ad groups are being modified. - string customer_id = 1; + // Required. The ID of the customer whose Keyword Plan ad groups are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual Keyword Plan ad groups. - repeated KeywordPlanAdGroupOperation operations = 2; + // Required. The list of operations to perform on individual Keyword Plan ad groups. + repeated KeywordPlanAdGroupOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/keyword_plan_campaign_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/keyword_plan_campaign_service.proto index 70ee20af9..8d66d8af1 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/keyword_plan_campaign_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/keyword_plan_campaign_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/keyword_plan_campaign.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,6 +44,7 @@ service KeywordPlanCampaignService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/keywordPlanCampaigns/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes Keyword Plan campaigns. Operation statuses are @@ -52,23 +54,29 @@ service KeywordPlanCampaignService { post: "/v2/customers/{customer_id=*}/keywordPlanCampaigns:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [KeywordPlanCampaignService.GetKeywordPlanCampaign][google.ads.googleads.v2.services.KeywordPlanCampaignService.GetKeywordPlanCampaign]. message GetKeywordPlanCampaignRequest { - // The resource name of the Keyword Plan campaign to fetch. - string resource_name = 1; + // Required. The resource name of the Keyword Plan campaign to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanCampaign" + } + ]; } // Request message for // [KeywordPlanCampaignService.MutateKeywordPlanCampaigns][google.ads.googleads.v2.services.KeywordPlanCampaignService.MutateKeywordPlanCampaigns]. message MutateKeywordPlanCampaignsRequest { - // The ID of the customer whose Keyword Plan campaigns are being modified. - string customer_id = 1; + // Required. The ID of the customer whose Keyword Plan campaigns are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual Keyword Plan campaigns. - repeated KeywordPlanCampaignOperation operations = 2; + // Required. The list of operations to perform on individual Keyword Plan campaigns. + repeated KeywordPlanCampaignOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/keyword_plan_idea_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/keyword_plan_idea_service.proto index 1e656665a..4aeacd66a 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/keyword_plan_idea_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/keyword_plan_idea_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,7 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/common/keyword_plan_common.proto"; import "google/ads/googleads/v2/enums/keyword_plan_network.proto"; import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; import "google/protobuf/wrappers.proto"; import "google/api/client.proto"; @@ -52,9 +52,9 @@ message GenerateKeywordIdeasRequest { // The ID of the customer with the recommendation. string customer_id = 1; - // The resource name of the language to target. + // Required. The resource name of the language to target. // Required - google.protobuf.StringValue language = 7; + google.protobuf.StringValue language = 7 [(google.api.field_behavior) = REQUIRED]; // The resource names of the location to target. // Max 10 diff --git a/third_party/googleapis/google/ads/googleads/v2/services/keyword_plan_keyword_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/keyword_plan_keyword_service.proto index 1e9a1aad5..2b48362bf 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/keyword_plan_keyword_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/keyword_plan_keyword_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/keyword_plan_keyword.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,6 +44,7 @@ service KeywordPlanKeywordService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/keywordPlanKeywords/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes Keyword Plan keywords. Operation statuses are @@ -52,22 +54,28 @@ service KeywordPlanKeywordService { post: "/v2/customers/{customer_id=*}/keywordPlanKeywords:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [KeywordPlanKeywordService.GetKeywordPlanKeyword][google.ads.googleads.v2.services.KeywordPlanKeywordService.GetKeywordPlanKeyword]. message GetKeywordPlanKeywordRequest { - // The resource name of the ad group keyword to fetch. - string resource_name = 1; + // Required. The resource name of the ad group keyword to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanKeyword" + } + ]; } // Request message for [KeywordPlanKeywordService.MutateKeywordPlanKeywords][google.ads.googleads.v2.services.KeywordPlanKeywordService.MutateKeywordPlanKeywords]. message MutateKeywordPlanKeywordsRequest { - // The ID of the customer whose Keyword Plan keywords are being modified. - string customer_id = 1; + // Required. The ID of the customer whose Keyword Plan keywords are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual Keyword Plan keywords. - repeated KeywordPlanKeywordOperation operations = 2; + // Required. The list of operations to perform on individual Keyword Plan keywords. + repeated KeywordPlanKeywordOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/keyword_plan_negative_keyword_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/keyword_plan_negative_keyword_service.proto index 197cae4d7..e61537419 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/keyword_plan_negative_keyword_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/keyword_plan_negative_keyword_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/keyword_plan_negative_keyword.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,6 +44,7 @@ service KeywordPlanNegativeKeywordService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/keywordPlanNegativeKeywords/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes Keyword Plan negative keywords. Operation @@ -52,25 +54,31 @@ service KeywordPlanNegativeKeywordService { post: "/v2/customers/{customer_id=*}/keywordPlanNegativeKeywords:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for // [KeywordPlanNegativeKeywordService.GetKeywordPlanNegativeKeyword][google.ads.googleads.v2.services.KeywordPlanNegativeKeywordService.GetKeywordPlanNegativeKeyword]. message GetKeywordPlanNegativeKeywordRequest { - // The resource name of the plan to fetch. - string resource_name = 1; + // Required. The resource name of the plan to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanNegativeKeyword" + } + ]; } // Request message for // [KeywordPlanNegativeKeywordService.MutateKeywordPlanNegativeKeywords][google.ads.googleads.v2.services.KeywordPlanNegativeKeywordService.MutateKeywordPlanNegativeKeywords]. message MutateKeywordPlanNegativeKeywordsRequest { - // The ID of the customer whose negative keywords are being modified. - string customer_id = 1; + // Required. The ID of the customer whose negative keywords are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual Keyword Plan negative + // Required. The list of operations to perform on individual Keyword Plan negative // keywords. - repeated KeywordPlanNegativeKeywordOperation operations = 2; + repeated KeywordPlanNegativeKeywordOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/keyword_plan_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/keyword_plan_service.proto index 7d5095ab3..8aa95c9d0 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/keyword_plan_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/keyword_plan_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,10 +19,12 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/common/keyword_plan_common.proto"; import "google/ads/googleads/v2/resources/keyword_plan.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -45,6 +46,7 @@ service KeywordPlanService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/keywordPlans/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes keyword plans. Operation statuses are @@ -54,6 +56,7 @@ service KeywordPlanService { post: "/v2/customers/{customer_id=*}/keywordPlans:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } // Returns the requested Keyword Plan forecasts. @@ -62,6 +65,7 @@ service KeywordPlanService { post: "/v2/{keyword_plan=customers/*/keywordPlans/*}:generateForecastMetrics" body: "*" }; + option (google.api.method_signature) = "keyword_plan"; } // Returns the requested Keyword Plan historical metrics. @@ -70,22 +74,28 @@ service KeywordPlanService { post: "/v2/{keyword_plan=customers/*/keywordPlans/*}:generateHistoricalMetrics" body: "*" }; + option (google.api.method_signature) = "keyword_plan"; } } // Request message for [KeywordPlanService.GetKeywordPlan][google.ads.googleads.v2.services.KeywordPlanService.GetKeywordPlan]. message GetKeywordPlanRequest { - // The resource name of the plan to fetch. - string resource_name = 1; + // Required. The resource name of the plan to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlan" + } + ]; } // Request message for [KeywordPlanService.MutateKeywordPlans][google.ads.googleads.v2.services.KeywordPlanService.MutateKeywordPlans]. message MutateKeywordPlansRequest { - // The ID of the customer whose keyword plans are being modified. - string customer_id = 1; + // Required. The ID of the customer whose keyword plans are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual keyword plans. - repeated KeywordPlanOperation operations = 2; + // Required. The list of operations to perform on individual keyword plans. + repeated KeywordPlanOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried @@ -141,8 +151,8 @@ message MutateKeywordPlansResult { // Request message for [KeywordPlanService.GenerateForecastMetrics][google.ads.googleads.v2.services.KeywordPlanService.GenerateForecastMetrics]. message GenerateForecastMetricsRequest { - // The resource name of the keyword plan to be forecasted. - string keyword_plan = 1; + // Required. The resource name of the keyword plan to be forecasted. + string keyword_plan = 1 [(google.api.field_behavior) = REQUIRED]; } // Response message for [KeywordPlanService.GenerateForecastMetrics][google.ads.googleads.v2.services.KeywordPlanService.GenerateForecastMetrics]. @@ -211,9 +221,9 @@ message ForecastMetrics { // Request message for [KeywordPlanService.GenerateHistoricalMetrics][google.ads.googleads.v2.services.KeywordPlanService.GenerateHistoricalMetrics]. message GenerateHistoricalMetricsRequest { - // The resource name of the keyword plan of which historical metrics are + // Required. The resource name of the keyword plan of which historical metrics are // requested. - string keyword_plan = 1; + string keyword_plan = 1 [(google.api.field_behavior) = REQUIRED]; } // Response message for [KeywordPlanService.GenerateHistoricalMetrics][google.ads.googleads.v2.services.KeywordPlanService.GenerateHistoricalMetrics]. diff --git a/third_party/googleapis/google/ads/googleads/v2/services/keyword_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/keyword_view_service.proto index 776c594eb..2cacfd0d5 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/keyword_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/keyword_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/keyword_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service KeywordViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/keywordViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [KeywordViewService.GetKeywordView][google.ads.googleads.v2.services.KeywordViewService.GetKeywordView]. message GetKeywordViewRequest { - // The resource name of the keyword view to fetch. - string resource_name = 1; + // Required. The resource name of the keyword view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/label_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/label_service.proto index 06a682c40..f18d15a6b 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/label_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/label_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,10 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/label.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -42,6 +42,7 @@ service LabelService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/labels/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes labels. Operation statuses are returned. @@ -50,22 +51,28 @@ service LabelService { post: "/v2/customers/{customer_id=*}/labels:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [LabelService.GetLabel][google.ads.googleads.v2.services.LabelService.GetLabel]. message GetLabelRequest { - // The resource name of the label to fetch. - string resource_name = 1; + // Required. The resource name of the label to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Label" + } + ]; } // Request message for [LabelService.MutateLabels][google.ads.googleads.v2.services.LabelService.MutateLabels]. message MutateLabelsRequest { - // ID of the customer whose labels are being modified. - string customer_id = 1; + // Required. ID of the customer whose labels are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on labels. - repeated LabelOperation operations = 2; + // Required. The list of operations to perform on labels. + repeated LabelOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/landing_page_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/landing_page_view_service.proto index ef5e9f135..188298bf9 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/landing_page_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/landing_page_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/landing_page_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service LandingPageViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/landingPageViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [LandingPageViewService.GetLandingPageView][google.ads.googleads.v2.services.LandingPageViewService.GetLandingPageView]. message GetLandingPageViewRequest { - // The resource name of the landing page view to fetch. - string resource_name = 1; + // Required. The resource name of the landing page view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/LandingPageView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/language_constant_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/language_constant_service.proto index b326a54ea..29b1ec922 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/language_constant_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/language_constant_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/language_constant.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service LanguageConstantService { option (google.api.http) = { get: "/v2/{resource_name=languageConstants/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [LanguageConstantService.GetLanguageConstant][google.ads.googleads.v2.services.LanguageConstantService.GetLanguageConstant]. message GetLanguageConstantRequest { - // Resource name of the language constant to fetch. - string resource_name = 1; + // Required. Resource name of the language constant to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/LanguageConstant" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/location_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/location_view_service.proto index 2e164c5c5..af2dd4fbd 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/location_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/location_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/location_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service LocationViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/locationViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [LocationViewService.GetLocationView][google.ads.googleads.v2.services.LocationViewService.GetLocationView]. message GetLocationViewRequest { - // The resource name of the location view to fetch. - string resource_name = 1; + // Required. The resource name of the location view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/LocationView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/managed_placement_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/managed_placement_view_service.proto index 3575c8b4f..154bf7a16 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/managed_placement_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/managed_placement_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/managed_placement_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service ManagedPlacementViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/managedPlacementViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [ManagedPlacementViewService.GetManagedPlacementView][google.ads.googleads.v2.services.ManagedPlacementViewService.GetManagedPlacementView]. message GetManagedPlacementViewRequest { - // The resource name of the Managed Placement View to fetch. - string resource_name = 1; + // Required. The resource name of the Managed Placement View to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ManagedPlacementView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/media_file_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/media_file_service.proto index 3e9f42651..86e0b3d07 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/media_file_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/media_file_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,10 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/media_file.proto"; import "google/api/annotations.proto"; -import "google/protobuf/wrappers.proto"; -import "google/rpc/status.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,6 +43,7 @@ service MediaFileService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/mediaFiles/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates media files. Operation statuses are returned. @@ -51,22 +52,28 @@ service MediaFileService { post: "/v2/customers/{customer_id=*}/mediaFiles:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [MediaFileService.GetMediaFile][google.ads.googleads.v2.services.MediaFileService.GetMediaFile] message GetMediaFileRequest { - // The resource name of the media file to fetch. - string resource_name = 1; + // Required. The resource name of the media file to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MediaFile" + } + ]; } // Request message for [MediaFileService.MutateMediaFiles][google.ads.googleads.v2.services.MediaFileService.MutateMediaFiles] message MutateMediaFilesRequest { - // The ID of the customer whose media files are being modified. - string customer_id = 1; + // Required. The ID of the customer whose media files are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual media file. - repeated MediaFileOperation operations = 2; + // Required. The list of operations to perform on individual media file. + repeated MediaFileOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/merchant_center_link_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/merchant_center_link_service.proto index 28e9b41a0..5f27e4267 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/merchant_center_link_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/merchant_center_link_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,8 +18,10 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/merchant_center_link.proto"; import "google/api/annotations.proto"; -import "google/protobuf/field_mask.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -38,11 +39,12 @@ option ruby_package = "Google::Ads::GoogleAds::V2::Services"; service MerchantCenterLinkService { option (google.api.default_host) = "googleads.googleapis.com"; - // Returns Merchant Center links available tor this customer. + // Returns Merchant Center links available for this customer. rpc ListMerchantCenterLinks(ListMerchantCenterLinksRequest) returns (ListMerchantCenterLinksResponse) { option (google.api.http) = { get: "/v2/customers/{customer_id=*}/merchantCenterLinks" }; + option (google.api.method_signature) = "customer_id"; } // Returns the Merchant Center link in full detail. @@ -50,6 +52,7 @@ service MerchantCenterLinkService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/merchantCenterLinks/*}" }; + option (google.api.method_signature) = "resource_name"; } // Updates status or removes a Merchant Center link. @@ -58,14 +61,15 @@ service MerchantCenterLinkService { post: "/v2/customers/{customer_id=*}/merchantCenterLinks:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operation"; } } // Request message for [MerchantCenterLinkService.ListMerchantCenterLinks][google.ads.googleads.v2.services.MerchantCenterLinkService.ListMerchantCenterLinks]. message ListMerchantCenterLinksRequest { - // The ID of the customer onto which to apply the Merchant Center link list + // Required. The ID of the customer onto which to apply the Merchant Center link list // operation. - string customer_id = 1; + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; } // Response message for [MerchantCenterLinkService.ListMerchantCenterLinks][google.ads.googleads.v2.services.MerchantCenterLinkService.ListMerchantCenterLinks]. @@ -76,17 +80,22 @@ message ListMerchantCenterLinksResponse { // Request message for [MerchantCenterLinkService.GetMerchantCenterLink][google.ads.googleads.v2.services.MerchantCenterLinkService.GetMerchantCenterLink]. message GetMerchantCenterLinkRequest { - // Resource name of the Merchant Center link. - string resource_name = 1; + // Required. Resource name of the Merchant Center link. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MerchantCenterLink" + } + ]; } // Request message for [MerchantCenterLinkService.MutateMerchantCenterLink][google.ads.googleads.v2.services.MerchantCenterLinkService.MutateMerchantCenterLink]. message MutateMerchantCenterLinkRequest { - // The ID of the customer being modified. - string customer_id = 1; + // Required. The ID of the customer being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The operation to perform on the link - MerchantCenterLinkOperation operation = 2; + // Required. The operation to perform on the link + MerchantCenterLinkOperation operation = 2 [(google.api.field_behavior) = REQUIRED]; } // A single update on a Merchant Center link. diff --git a/third_party/googleapis/google/ads/googleads/v2/services/mobile_app_category_constant_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/mobile_app_category_constant_service.proto index 180c99f9e..5a45e35db 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/mobile_app_category_constant_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/mobile_app_category_constant_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/mobile_app_category_constant.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -39,12 +40,18 @@ service MobileAppCategoryConstantService { option (google.api.http) = { get: "/v2/{resource_name=mobileAppCategoryConstants/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for // [MobileAppCategoryConstantService.GetMobileAppCategoryConstant][google.ads.googleads.v2.services.MobileAppCategoryConstantService.GetMobileAppCategoryConstant]. message GetMobileAppCategoryConstantRequest { - // Resource name of the mobile app category constant to fetch. - string resource_name = 1; + // Required. Resource name of the mobile app category constant to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MobileAppCategoryConstant" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/mobile_device_constant_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/mobile_device_constant_service.proto index 9a7427920..6bc26b4b1 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/mobile_device_constant_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/mobile_device_constant_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/mobile_device_constant.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service MobileDeviceConstantService { option (google.api.http) = { get: "/v2/{resource_name=mobileDeviceConstants/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [MobileDeviceConstantService.GetMobileDeviceConstant][google.ads.googleads.v2.services.MobileDeviceConstantService.GetMobileDeviceConstant]. message GetMobileDeviceConstantRequest { - // Resource name of the mobile device to fetch. - string resource_name = 1; + // Required. Resource name of the mobile device to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MobileDeviceConstant" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/mutate_job_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/mutate_job_service.proto index e6c72cee8..7eb9b710c 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/mutate_job_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/mutate_job_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,9 +19,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/mutate_job.proto"; import "google/ads/googleads/v2/services/google_ads_service.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/longrunning/operations.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -45,6 +46,7 @@ service MutateJobService { post: "/v2/customers/{customer_id=*}/mutateJobs:create" body: "*" }; + option (google.api.method_signature) = "customer_id"; } // Returns the mutate job. @@ -52,6 +54,7 @@ service MutateJobService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/mutateJobs/*}" }; + option (google.api.method_signature) = "resource_name"; } // Returns the results of the mutate job. The job must be done. @@ -60,6 +63,7 @@ service MutateJobService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/mutateJobs/*}:listResults" }; + option (google.api.method_signature) = "resource_name"; } // Runs the mutate job. @@ -72,6 +76,11 @@ service MutateJobService { post: "/v2/{resource_name=customers/*/mutateJobs/*}:run" body: "*" }; + option (google.api.method_signature) = "resource_name"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "google.ads.googleads.v2.resources.MutateJob.MutateJobMetadata" + }; } // Add operations to the mutate job. @@ -80,13 +89,15 @@ service MutateJobService { post: "/v2/{resource_name=customers/*/mutateJobs/*}:addOperations" body: "*" }; + option (google.api.method_signature) = "resource_name,sequence_token,mutate_operations"; + option (google.api.method_signature) = "resource_name,mutate_operations"; } } // Request message for [MutateJobService.CreateMutateJobRequest][] message CreateMutateJobRequest { - // The ID of the customer for which to create a mutate job. - string customer_id = 1; + // Required. The ID of the customer for which to create a mutate job. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; } // Response message for [MutateJobService.CreateMutateJobResponse][] @@ -97,20 +108,35 @@ message CreateMutateJobResponse { // Request message for [MutateJobService.GetMutateJob][google.ads.googleads.v2.services.MutateJobService.GetMutateJob] message GetMutateJobRequest { - // The resource name of the MutateJob to get. - string resource_name = 1; + // Required. The resource name of the MutateJob to get. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MutateJob" + } + ]; } // Request message for [MutateJobService.RunMutateJob][google.ads.googleads.v2.services.MutateJobService.RunMutateJob] message RunMutateJobRequest { - // The resource name of the MutateJob to run. - string resource_name = 1; + // Required. The resource name of the MutateJob to run. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MutateJob" + } + ]; } // Request message for [MutateJobService.AddMutateJobOperations][google.ads.googleads.v2.services.MutateJobService.AddMutateJobOperations] message AddMutateJobOperationsRequest { - // The resource name of the MutateJob. - string resource_name = 1; + // Required. The resource name of the MutateJob. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MutateJob" + } + ]; // A token used to enforce sequencing. // @@ -120,7 +146,7 @@ message AddMutateJobOperationsRequest { // response. string sequence_token = 2; - // The list of mutates being added. + // Required. The list of mutates being added. // // Operations can use negative integers as temp ids to signify dependencies // between entities created in this MutateJob. For example, a customer with @@ -129,7 +155,7 @@ message AddMutateJobOperationsRequest { // explicitly set to "customers/1234/campaigns/-1", and creating an ad group // in the second operation with the campaign field also set to // "customers/1234/campaigns/-1". - repeated MutateOperation mutate_operations = 3; + repeated MutateOperation mutate_operations = 3 [(google.api.field_behavior) = REQUIRED]; } // Response message for [MutateJobService.AddMutateJobOperations][google.ads.googleads.v2.services.MutateJobService.AddMutateJobOperations] @@ -145,8 +171,13 @@ message AddMutateJobOperationsResponse { // Request message for [MutateJobService.ListMutateJobResults][google.ads.googleads.v2.services.MutateJobService.ListMutateJobResults]. message ListMutateJobResultsRequest { - // The resource name of the MutateJob whose results are being listed. - string resource_name = 1; + // Required. The resource name of the MutateJob whose results are being listed. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MutateJob" + } + ]; // Token of the page to retrieve. If not specified, the first // page of results will be returned. Use the value obtained from diff --git a/third_party/googleapis/google/ads/googleads/v2/services/operating_system_version_constant_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/operating_system_version_constant_service.proto index 349ab351b..a620e4d9e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/operating_system_version_constant_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/operating_system_version_constant_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/operating_system_version_constant.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,12 +42,18 @@ service OperatingSystemVersionConstantService { option (google.api.http) = { get: "/v2/{resource_name=operatingSystemVersionConstants/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for // [OperatingSystemVersionConstantService.GetOperatingSystemVersionConstant][google.ads.googleads.v2.services.OperatingSystemVersionConstantService.GetOperatingSystemVersionConstant]. message GetOperatingSystemVersionConstantRequest { - // Resource name of the OS version to fetch. - string resource_name = 1; + // Required. Resource name of the OS version to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/OperatingSystemVersionConstant" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/paid_organic_search_term_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/paid_organic_search_term_view_service.proto index 586f9fd42..76412b023 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/paid_organic_search_term_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/paid_organic_search_term_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/paid_organic_search_term_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,12 +42,18 @@ service PaidOrganicSearchTermViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/paidOrganicSearchTermViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for // [PaidOrganicSearchTermViewService.GetPaidOrganicSearchTermView][google.ads.googleads.v2.services.PaidOrganicSearchTermViewService.GetPaidOrganicSearchTermView]. message GetPaidOrganicSearchTermViewRequest { - // The resource name of the paid organic search term view to fetch. - string resource_name = 1; + // Required. The resource name of the paid organic search term view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/PaidOrganicSearchTermView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/parental_status_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/parental_status_view_service.proto index 2ae50b215..cc07c2c0e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/parental_status_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/parental_status_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/parental_status_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service ParentalStatusViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/parentalStatusViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [ParentalStatusViewService.GetParentalStatusView][google.ads.googleads.v2.services.ParentalStatusViewService.GetParentalStatusView]. message GetParentalStatusViewRequest { - // The resource name of the parental status view to fetch. - string resource_name = 1; + // Required. The resource name of the parental status view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ParentalStatusView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/payments_account_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/payments_account_service.proto index 5c3073c02..74a406179 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/payments_account_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/payments_account_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,7 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/payments_account.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -30,31 +30,32 @@ option objc_class_prefix = "GAA"; option php_namespace = "Google\\Ads\\GoogleAds\\V2\\Services"; option ruby_package = "Google::Ads::GoogleAds::V2::Services"; -// Proto file describing the Payments account service. +// Proto file describing the payments account service. -// Service to provide Payments accounts that can be used to set up consolidated +// Service to provide payments accounts that can be used to set up consolidated // billing. service PaymentsAccountService { option (google.api.default_host) = "googleads.googleapis.com"; - // Returns all Payments accounts associated with all managers + // Returns all payments accounts associated with all managers // between the login customer ID and specified serving customer in the // hierarchy, inclusive. rpc ListPaymentsAccounts(ListPaymentsAccountsRequest) returns (ListPaymentsAccountsResponse) { option (google.api.http) = { get: "/v2/customers/{customer_id=*}/paymentsAccounts" }; + option (google.api.method_signature) = "customer_id"; } } -// Request message for fetching all accessible Payments accounts. +// Request message for fetching all accessible payments accounts. message ListPaymentsAccountsRequest { - // The ID of the customer to apply the PaymentsAccount list operation to. - string customer_id = 1; + // Required. The ID of the customer to apply the PaymentsAccount list operation to. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; } // Response message for [PaymentsAccountService.ListPaymentsAccounts][google.ads.googleads.v2.services.PaymentsAccountService.ListPaymentsAccounts]. message ListPaymentsAccountsResponse { - // The list of accessible Payments accounts. + // The list of accessible payments accounts. repeated google.ads.googleads.v2.resources.PaymentsAccount payments_accounts = 1; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/product_bidding_category_constant_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/product_bidding_category_constant_service.proto index 7f32d21b7..b65b849ea 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/product_bidding_category_constant_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/product_bidding_category_constant_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/product_bidding_category_constant.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,12 +42,18 @@ service ProductBiddingCategoryConstantService { option (google.api.http) = { get: "/v2/{resource_name=productBiddingCategoryConstants/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for // [ProductBiddingCategoryService.GetProductBiddingCategory][]. message GetProductBiddingCategoryConstantRequest { - // Resource name of the Product Bidding Category to fetch. - string resource_name = 1; + // Required. Resource name of the Product Bidding Category to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ProductBiddingCategoryConstant" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/product_group_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/product_group_view_service.proto index 08f7a1d46..98f683bc1 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/product_group_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/product_group_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/product_group_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service ProductGroupViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/productGroupViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [ProductGroupViewService.GetProductGroupView][google.ads.googleads.v2.services.ProductGroupViewService.GetProductGroupView]. message GetProductGroupViewRequest { - // The resource name of the product group view to fetch. - string resource_name = 1; + // Required. The resource name of the product group view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ProductGroupView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/reach_plan_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/reach_plan_service.proto new file mode 100644 index 000000000..dd023380f --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v2/services/reach_plan_service.proto @@ -0,0 +1,357 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v2.services; + +import "google/ads/googleads/v2/common/criteria.proto"; +import "google/ads/googleads/v2/enums/reach_plan_ad_length.proto"; +import "google/ads/googleads/v2/enums/reach_plan_age_range.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/protobuf/wrappers.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; +option java_multiple_files = true; +option java_outer_classname = "ReachPlanServiceProto"; +option java_package = "com.google.ads.googleads.v2.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V2\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V2::Services"; + +// Proto file describing the reach plan service. + +// Reach Plan Service gives users information about audience size that can +// be reached through advertisement on YouTube. In particular, +// GenerateReachForecast provides estimated number of people of specified +// demographics that can be reached by an ad in a given market by a campaign of +// certain duration with a defined budget. +service ReachPlanService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the list of plannable locations (for example, countries & DMAs). + rpc ListPlannableLocations(ListPlannableLocationsRequest) returns (ListPlannableLocationsResponse) { + option (google.api.http) = { + post: "/v2:listPlannableLocations" + body: "*" + }; + } + + // Returns the list of per-location plannable YouTube ad formats with allowed + // targeting. + rpc ListPlannableProducts(ListPlannableProductsRequest) returns (ListPlannableProductsResponse) { + option (google.api.http) = { + post: "/v2:listPlannableProducts" + body: "*" + }; + option (google.api.method_signature) = "plannable_location_id"; + } + + // Generates a product mix ideas given a set of preferences. This method + // helps the advertiser to obtain a good mix of ad formats and budget + // allocations based on its preferences. + rpc GenerateProductMixIdeas(GenerateProductMixIdeasRequest) returns (GenerateProductMixIdeasResponse) { + option (google.api.http) = { + post: "/v2/customers/{customer_id=*}:generateProductMixIdeas" + body: "*" + }; + option (google.api.method_signature) = "customer_id,plannable_location_id,currency_code,budget_micros"; + } + + // Generates a reach forecast for a given targeting / product mix. + rpc GenerateReachForecast(GenerateReachForecastRequest) returns (GenerateReachForecastResponse) { + option (google.api.http) = { + post: "/v2/customers/{customer_id=*}:generateReachForecast" + body: "*" + }; + option (google.api.method_signature) = "customer_id,campaign_duration,planned_products"; + } +} + +// Request message for [ReachForecastService.ListPlannableLocations][] +message ListPlannableLocationsRequest { + +} + +// The list of plannable locations. +message ListPlannableLocationsResponse { + // The list of locations available for planning (Countries, DMAs, + // sub-countries). + // For locations like Countries, DMAs see + // https://developers.google.com/adwords/api/docs/appendix/geotargeting for + // more information. + repeated PlannableLocation plannable_locations = 1; +} + +// A plannable location: a country, a DMA, a metro region, a tv region, +// a province. +message PlannableLocation { + // The location identifier. + google.protobuf.StringValue id = 1; + + // The unique location name in english. + google.protobuf.StringValue name = 2; + + // The parent country code, not present if location is a country. + // If present will always be a criterion id: additional information, such as + // country name are returned both via ListPlannableLocations or directly by + // accessing GeoTargetConstantService with the criterion id. + google.protobuf.Int64Value parent_country_id = 3; +} + +// Request to list available products in a given location. +message ListPlannableProductsRequest { + // Required. The ID of the selected location for planning. To list the available + // plannable location ids use ListPlannableLocations. + google.protobuf.StringValue plannable_location_id = 1 [(google.api.field_behavior) = REQUIRED]; +} + +// A response with all available products. +message ListPlannableProductsResponse { + // The list of products available for planning and related targeting metadata. + repeated ProductMetadata product_metadata = 1; +} + +// The metadata associated with an available plannable product. +message ProductMetadata { + // The code associated with the ad product. E.g. Trueview, Bumper + // To list the available plannable product codes use ListPlannableProducts. + google.protobuf.StringValue plannable_product_code = 1; + + // The allowed plannable targeting for this product. + PlannableTargeting plannable_targeting = 2; +} + +// The targeting for which traffic metrics will be reported. +message PlannableTargeting { + // Allowed plannable age ranges for the product for which metrics will be + // reported. Actual targeting is computed by mapping this age range onto + // standard Google common.AgeRangeInfo values. + repeated google.ads.googleads.v2.enums.ReachPlanAgeRangeEnum.ReachPlanAgeRange age_ranges = 1; + + // Targetable genders for the ad product. + repeated google.ads.googleads.v2.common.GenderInfo genders = 2; + + // Targetable devices for the ad product. + repeated google.ads.googleads.v2.common.DeviceInfo devices = 3; +} + +// Request message for [ReachForecastService.GenerateProductMixIdeas][]. +message GenerateProductMixIdeasRequest { + // Required. The ID of the customer. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The ID of the location, this is one of the ids returned by + // ListPlannableLocations. + google.protobuf.StringValue plannable_location_id = 2 [(google.api.field_behavior) = REQUIRED]; + + // Required. Currency code. + // Three-character ISO 4217 currency code. + google.protobuf.StringValue currency_code = 3 [(google.api.field_behavior) = REQUIRED]; + + // Required. Total budget. + // Amount in micros. One million is equivalent to one unit. + google.protobuf.Int64Value budget_micros = 4 [(google.api.field_behavior) = REQUIRED]; + + // The preferences of the suggested product mix. + // An unset preference is interpreted as all possible values are allowed, + // unless explicitly specified. + Preferences preferences = 5; +} + +// Set of preferences about the planned mix. +message Preferences { + // True if ad skippable. + // If not set, default is any value. + google.protobuf.BoolValue is_skippable = 1; + + // True if ad start with sound. + // If not set, default is any value. + google.protobuf.BoolValue starts_with_sound = 2; + + // The length of the ad. + // If not set, default is any value. + google.ads.googleads.v2.enums.ReachPlanAdLengthEnum.ReachPlanAdLength ad_length = 3; + + // True if ad will only show on the top content. + // If not set, default is false. + google.protobuf.BoolValue top_content_only = 4; + + // True if the price guaranteed. The cost of serving the ad is agreed upfront + // and not subject to an auction. + // If not set, default is any value. + google.protobuf.BoolValue has_guaranteed_price = 5; +} + +// The suggested product mix. +message GenerateProductMixIdeasResponse { + // A list of products (ad formats) and the associated budget allocation idea. + repeated ProductAllocation product_allocation = 1; +} + +// An allocation of a part of the budget on a given product. +message ProductAllocation { + // Selected product for planning. The product codes returned are within the + // set of the ones returned by ListPlannableProducts when using the same + // location id. + google.protobuf.StringValue plannable_product_code = 1; + + // The value to be allocated for the suggested product in requested currency. + // Amount in micros. One million is equivalent to one unit. + google.protobuf.Int64Value budget_micros = 2; +} + +// Request message for [ReachPlanService.GenerateReachForecast][google.ads.googleads.v2.services.ReachPlanService.GenerateReachForecast]. +message GenerateReachForecastRequest { + // Required. The ID of the customer. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // The currency code. + // Three-character ISO 4217 currency code. + google.protobuf.StringValue currency_code = 2; + + // Required. Campaign duration. + CampaignDuration campaign_duration = 3 [(google.api.field_behavior) = REQUIRED]; + + // Desired cookie frequency cap that will be applied to each planned product. + // This is equivalent to the frequency cap exposed in Google Ads when creating + // a campaign, it represents the maximum number of times an ad can be shown to + // the same user. + // If not specified no cap is applied. + google.protobuf.Int32Value cookie_frequency_cap = 4; + + // Desired minimum effective frequency (the number of times a person was + // exposed to the ad) for the reported reach metrics [1-10]. + // This won't affect the targeting, but just the reporting. + // If not specified, a default of 1 is applied. + google.protobuf.Int32Value min_effective_frequency = 5; + + // The targeting to be applied to all products selected in the product mix. + // + // This is planned targeting: execution details might vary based on the + // advertising product, please consult an implementation specialist. + // + // If no targeting dimensions are specified, then campaigns will target + // everywhere and everyone. + // + // See specific metrics for details on how targeting affects them. + // + // In some cases, targeting may be overridden using the + // PlannedProduct.advanced_product_targeting field. + Targeting targeting = 6; + + // Required. The product to be planned. + repeated PlannedProduct planned_products = 7 [(google.api.field_behavior) = REQUIRED]; +} + +// The targeting for which traffic metrics will be reported. +message Targeting { + // Required. The ID of the selected location. + // Plannable locations ID can be obtained from ListPlannableLocations. + google.protobuf.StringValue plannable_location_id = 1; + + // Required + // Selected age range to be planned on. + google.ads.googleads.v2.enums.ReachPlanAgeRangeEnum.ReachPlanAgeRange age_range = 2; + + // Targetable genders for the ad product. + repeated google.ads.googleads.v2.common.GenderInfo genders = 3; + + // Targetable devices for the ad product. + repeated google.ads.googleads.v2.common.DeviceInfo devices = 4; +} + +// The duration of a planned campaign. +message CampaignDuration { + // The duration value in days. + google.protobuf.Int32Value duration_in_days = 1; +} + +// A product being planned for reach. +message PlannedProduct { + // Required. Selected product for planning. + // Plannable products codes can be obtained from ListPlannableProducts. + google.protobuf.StringValue plannable_product_code = 1; + + // Required. Maximum budget allocation in micros for the selected product. + // The value is specified in the selected planning currency_code. + // E.g. 1 000 000$ = 1 000 000 000 000 micros. + google.protobuf.Int64Value budget_micros = 2; +} + +// Response message containing the generated reach curve. +message GenerateReachForecastResponse { + // Reference on target audiences for this curve. + OnTargetAudienceMetrics on_target_audience_metrics = 1; + + // The generated reach curve for the planned product mix. + ReachCurve reach_curve = 2; +} + +// The reach curve for the planned products. +message ReachCurve { + // All points on the reach curve. + repeated ReachForecast reach_forecasts = 1; +} + +// A point on reach curve. +message ReachForecast { + // The cost in micros. + google.protobuf.Int64Value cost_micros = 1; + + // Forecasted traffic metrics for this point. + Forecast forecast = 2; + + // The forecasted allocation. This differs from the input allocation if one + // or more product cannot fulfill the budget because of limited inventory. + repeated ProductAllocation forecasted_product_allocations = 3; +} + +// Forecasted traffic metrics for the planned products and targeting. +message Forecast { + // Number of unique people reached at least + // GenerateReachForecastRequest.min_effective_frequency times that exactly + // matches the Targeting. + google.protobuf.Int64Value on_target_reach = 1; + + // Total number of unique people reached at least + // GenerateReachForecastRequest.min_effective_frequency times. This includes + // people that may fall outside the specified Targeting. + google.protobuf.Int64Value total_reach = 2; + + // Number of ad impressions that exactly matches the Targeting. + google.protobuf.Int64Value on_target_impressions = 3; + + // Total number of ad impressions. This includes impressions that may fall + // outside the specified Targeting, due to insufficent information on + // signed-in users. + google.protobuf.Int64Value total_impressions = 4; +} + +// Audience metrics for the planned products. +// These metrics consider the following targeting dimensions: +// +// - Location +// - PlannableAgeRange +// - Gender +message OnTargetAudienceMetrics { + // Reference audience size matching the considered targeting for YouTube. + google.protobuf.Int64Value youtube_audience_size = 1; + + // Reference audience size matching the considered targeting for Census. + google.protobuf.Int64Value census_audience_size = 2; +} diff --git a/third_party/googleapis/google/ads/googleads/v2/services/recommendation_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/recommendation_service.proto index 92d6ad11e..9b3d542d6 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/recommendation_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/recommendation_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -22,9 +21,11 @@ import "google/ads/googleads/v2/enums/keyword_match_type.proto"; import "google/ads/googleads/v2/resources/ad.proto"; import "google/ads/googleads/v2/resources/recommendation.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -46,6 +47,7 @@ service RecommendationService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/recommendations/*}" }; + option (google.api.method_signature) = "resource_name"; } // Applies given recommendations with corresponding apply parameters. @@ -54,6 +56,7 @@ service RecommendationService { post: "/v2/customers/{customer_id=*}/recommendations:apply" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } // Dismisses given recommendations. @@ -62,24 +65,30 @@ service RecommendationService { post: "/v2/customers/{customer_id=*}/recommendations:dismiss" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [RecommendationService.GetRecommendation][google.ads.googleads.v2.services.RecommendationService.GetRecommendation]. message GetRecommendationRequest { - // The resource name of the recommendation to fetch. - string resource_name = 1; + // Required. The resource name of the recommendation to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Recommendation" + } + ]; } // Request message for [RecommendationService.ApplyRecommendation][google.ads.googleads.v2.services.RecommendationService.ApplyRecommendation]. message ApplyRecommendationRequest { - // The ID of the customer with the recommendation. - string customer_id = 1; + // Required. The ID of the customer with the recommendation. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to apply recommendations. + // Required. The list of operations to apply recommendations. // If partial_failure=false all recommendations should be of the same type // There is a limit of 100 operations per request. - repeated ApplyRecommendationOperation operations = 2; + repeated ApplyRecommendationOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, operations will be carried @@ -212,13 +221,13 @@ message DismissRecommendationRequest { string resource_name = 1; } - // The ID of the customer with the recommendation. - string customer_id = 1; + // Required. The ID of the customer with the recommendation. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to dismiss recommendations. + // Required. The list of operations to dismiss recommendations. // If partial_failure=false all recommendations should be of the same type // There is a limit of 100 operations per request. - repeated DismissRecommendationOperation operations = 3; + repeated DismissRecommendationOperation operations = 3 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, operations will be carried in a diff --git a/third_party/googleapis/google/ads/googleads/v2/services/remarketing_action_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/remarketing_action_service.proto index 68379b370..f6a73df2e 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/remarketing_action_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/remarketing_action_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,10 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/remarketing_action.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -44,6 +44,7 @@ service RemarketingActionService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/remarketingActions/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates or updates remarketing actions. Operation statuses are returned. @@ -52,22 +53,28 @@ service RemarketingActionService { post: "/v2/customers/{customer_id=*}/remarketingActions:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [RemarketingActionService.GetRemarketingAction][google.ads.googleads.v2.services.RemarketingActionService.GetRemarketingAction]. message GetRemarketingActionRequest { - // The resource name of the remarketing action to fetch. - string resource_name = 1; + // Required. The resource name of the remarketing action to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/RemarketingAction" + } + ]; } // Request message for [RemarketingActionService.MutateRemarketingActions][google.ads.googleads.v2.services.RemarketingActionService.MutateRemarketingActions]. message MutateRemarketingActionsRequest { - // The ID of the customer whose remarketing actions are being modified. - string customer_id = 1; + // Required. The ID of the customer whose remarketing actions are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual remarketing actions. - repeated RemarketingActionOperation operations = 2; + // Required. The list of operations to perform on individual remarketing actions. + repeated RemarketingActionOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/search_term_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/search_term_view_service.proto index f319ca179..e73992568 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/search_term_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/search_term_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/search_term_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service SearchTermViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/searchTermViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [SearchTermViewService.GetSearchTermView][google.ads.googleads.v2.services.SearchTermViewService.GetSearchTermView]. message GetSearchTermViewRequest { - // The resource name of the search term view to fetch. - string resource_name = 1; + // Required. The resource name of the search term view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/SearchTermView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/shared_criterion_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/shared_criterion_service.proto index 6d4703c1a..9fc60251c 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/shared_criterion_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/shared_criterion_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,9 +18,10 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/shared_criterion.proto"; import "google/api/annotations.proto"; -import "google/protobuf/wrappers.proto"; -import "google/rpc/status.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/rpc/status.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -43,6 +43,7 @@ service SharedCriterionService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/sharedCriteria/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates or removes shared criteria. Operation statuses are returned. @@ -51,22 +52,28 @@ service SharedCriterionService { post: "/v2/customers/{customer_id=*}/sharedCriteria:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [SharedCriterionService.GetSharedCriterion][google.ads.googleads.v2.services.SharedCriterionService.GetSharedCriterion]. message GetSharedCriterionRequest { - // The resource name of the shared criterion to fetch. - string resource_name = 1; + // Required. The resource name of the shared criterion to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/SharedCriterion" + } + ]; } // Request message for [SharedCriterionService.MutateSharedCriteria][google.ads.googleads.v2.services.SharedCriterionService.MutateSharedCriteria]. message MutateSharedCriteriaRequest { - // The ID of the customer whose shared criteria are being modified. - string customer_id = 1; + // Required. The ID of the customer whose shared criteria are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual shared criteria. - repeated SharedCriterionOperation operations = 2; + // Required. The list of operations to perform on individual shared criteria. + repeated SharedCriterionOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/shared_set_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/shared_set_service.proto index c0890b608..9cf555dba 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/shared_set_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/shared_set_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,10 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/shared_set.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -44,6 +44,7 @@ service SharedSetService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/sharedSets/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates, updates, or removes shared sets. Operation statuses are returned. @@ -52,22 +53,28 @@ service SharedSetService { post: "/v2/customers/{customer_id=*}/sharedSets:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [SharedSetService.GetSharedSet][google.ads.googleads.v2.services.SharedSetService.GetSharedSet]. message GetSharedSetRequest { - // The resource name of the shared set to fetch. - string resource_name = 1; + // Required. The resource name of the shared set to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/SharedSet" + } + ]; } // Request message for [SharedSetService.MutateSharedSets][google.ads.googleads.v2.services.SharedSetService.MutateSharedSets]. message MutateSharedSetsRequest { - // The ID of the customer whose shared sets are being modified. - string customer_id = 1; + // Required. The ID of the customer whose shared sets are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual shared sets. - repeated SharedSetOperation operations = 2; + // Required. The list of operations to perform on individual shared sets. + repeated SharedSetOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/shopping_performance_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/shopping_performance_view_service.proto index 4f36ba392..9b4deff19 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/shopping_performance_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/shopping_performance_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/shopping_performance_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,12 +42,18 @@ service ShoppingPerformanceViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/shoppingPerformanceView}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for // [ShoppingPerformanceViewService.GetShoppingPerformanceView][google.ads.googleads.v2.services.ShoppingPerformanceViewService.GetShoppingPerformanceView]. message GetShoppingPerformanceViewRequest { - // The resource name of the Shopping performance view to fetch. - string resource_name = 1; + // Required. The resource name of the Shopping performance view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ShoppingPerformanceView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/topic_constant_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/topic_constant_service.proto index dc08e3a1d..96da1963f 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/topic_constant_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/topic_constant_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/topic_constant.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service TopicConstantService { option (google.api.http) = { get: "/v2/{resource_name=topicConstants/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [TopicConstantService.GetTopicConstant][google.ads.googleads.v2.services.TopicConstantService.GetTopicConstant]. message GetTopicConstantRequest { - // Resource name of the Topic to fetch. - string resource_name = 1; + // Required. Resource name of the Topic to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/TopicConstant" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/topic_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/topic_view_service.proto index 4692ef933..f4a3ac7f1 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/topic_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/topic_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/topic_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service TopicViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/topicViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [TopicViewService.GetTopicView][google.ads.googleads.v2.services.TopicViewService.GetTopicView]. message GetTopicViewRequest { - // The resource name of the topic view to fetch. - string resource_name = 1; + // Required. The resource name of the topic view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/TopicView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/user_interest_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/user_interest_service.proto index df98d0a5c..c1f351121 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/user_interest_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/user_interest_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/user_interest.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service UserInterestService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/userInterests/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [UserInterestService.GetUserInterest][google.ads.googleads.v2.services.UserInterestService.GetUserInterest]. message GetUserInterestRequest { - // Resource name of the UserInterest to fetch. - string resource_name = 1; + // Required. Resource name of the UserInterest to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/UserInterest" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/user_list_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/user_list_service.proto index a5e268f3e..beb18e600 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/user_list_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/user_list_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -19,10 +18,11 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/user_list.proto"; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -44,6 +44,7 @@ service UserListService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/userLists/*}" }; + option (google.api.method_signature) = "resource_name"; } // Creates or updates user lists. Operation statuses are returned. @@ -52,22 +53,28 @@ service UserListService { post: "/v2/customers/{customer_id=*}/userLists:mutate" body: "*" }; + option (google.api.method_signature) = "customer_id,operations"; } } // Request message for [UserListService.GetUserList][google.ads.googleads.v2.services.UserListService.GetUserList]. message GetUserListRequest { - // The resource name of the user list to fetch. - string resource_name = 1; + // Required. The resource name of the user list to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/UserList" + } + ]; } // Request message for [UserListService.MutateUserLists][google.ads.googleads.v2.services.UserListService.MutateUserLists]. message MutateUserListsRequest { - // The ID of the customer whose user lists are being modified. - string customer_id = 1; + // Required. The ID of the customer whose user lists are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The list of operations to perform on individual user lists. - repeated UserListOperation operations = 2; + // Required. The list of operations to perform on individual user lists. + repeated UserListOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; // If true, successful operations will be carried out and invalid // operations will return errors. If false, all operations will be carried diff --git a/third_party/googleapis/google/ads/googleads/v2/services/user_location_view_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/user_location_view_service.proto index 43494edf0..a9eac2a0b 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/user_location_view_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/user_location_view_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/user_location_view.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service UserLocationViewService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/userLocationViews/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [UserLocationViewService.GetUserLocationView][google.ads.googleads.v2.services.UserLocationViewService.GetUserLocationView]. message GetUserLocationViewRequest { - // The resource name of the user location view to fetch. - string resource_name = 1; + // Required. The resource name of the user location view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/UserLocationView" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v2/services/video_service.proto b/third_party/googleapis/google/ads/googleads/v2/services/video_service.proto index 7acb6fbe6..dbb5b2995 100644 --- a/third_party/googleapis/google/ads/googleads/v2/services/video_service.proto +++ b/third_party/googleapis/google/ads/googleads/v2/services/video_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -20,6 +19,8 @@ package google.ads.googleads.v2.services; import "google/ads/googleads/v2/resources/video.proto"; import "google/api/annotations.proto"; import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; option csharp_namespace = "Google.Ads.GoogleAds.V2.Services"; option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v2/services;services"; @@ -41,11 +42,17 @@ service VideoService { option (google.api.http) = { get: "/v2/{resource_name=customers/*/videos/*}" }; + option (google.api.method_signature) = "resource_name"; } } // Request message for [VideoService.GetVideo][google.ads.googleads.v2.services.VideoService.GetVideo]. message GetVideoRequest { - // The resource name of the video to fetch. - string resource_name = 1; + // Required. The resource name of the video to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Video" + } + ]; } diff --git a/third_party/googleapis/google/ads/googleads/v3/common/ad_asset.proto b/third_party/googleapis/google/ads/googleads/v3/common/ad_asset.proto new file mode 100644 index 000000000..d78ea8426 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/ad_asset.proto @@ -0,0 +1,62 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/ads/googleads/v3/enums/served_asset_field_type.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "AdAssetProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file describing assets used inside an ad. + +// A text asset used inside an ad. +message AdTextAsset { + // Asset text. + google.protobuf.StringValue text = 1; + + // The pinned field of the asset. This restricts the asset to only serve + // within this field. Multiple assets can be pinned to the same field. An + // asset that is unpinned or pinned to a different field will not serve in a + // field where some other asset has been pinned. + google.ads.googleads.v3.enums.ServedAssetFieldTypeEnum.ServedAssetFieldType pinned_field = 2; +} + +// An image asset used inside an ad. +message AdImageAsset { + // The Asset resource name of this image. + google.protobuf.StringValue asset = 1; +} + +// A video asset used inside an ad. +message AdVideoAsset { + // The Asset resource name of this video. + google.protobuf.StringValue asset = 1; +} + +// A media bundle asset used inside an ad. +message AdMediaBundleAsset { + // The Asset resource name of this media bundle. + google.protobuf.StringValue asset = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/ad_type_infos.proto b/third_party/googleapis/google/ads/googleads/v3/common/ad_type_infos.proto new file mode 100644 index 000000000..e4bc2aac9 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/ad_type_infos.proto @@ -0,0 +1,597 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/ads/googleads/v3/common/ad_asset.proto"; +import "google/ads/googleads/v3/enums/call_conversion_reporting_state.proto"; +import "google/ads/googleads/v3/enums/display_ad_format_setting.proto"; +import "google/ads/googleads/v3/enums/display_upload_product_type.proto"; +import "google/ads/googleads/v3/enums/legacy_app_install_ad_app_store.proto"; +import "google/ads/googleads/v3/enums/mime_type.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "AdTypeInfosProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file containing info messages for specific ad types. + +// A text ad. +message TextAdInfo { + // The headline of the ad. + google.protobuf.StringValue headline = 1; + + // The first line of the ad's description. + google.protobuf.StringValue description1 = 2; + + // The second line of the ad's description. + google.protobuf.StringValue description2 = 3; +} + +// An expanded text ad. +message ExpandedTextAdInfo { + // The first part of the ad's headline. + google.protobuf.StringValue headline_part1 = 1; + + // The second part of the ad's headline. + google.protobuf.StringValue headline_part2 = 2; + + // The third part of the ad's headline. + google.protobuf.StringValue headline_part3 = 6; + + // The description of the ad. + google.protobuf.StringValue description = 3; + + // The second description of the ad. + google.protobuf.StringValue description2 = 7; + + // The text that can appear alongside the ad's displayed URL. + google.protobuf.StringValue path1 = 4; + + // Additional text that can appear alongside the ad's displayed URL. + google.protobuf.StringValue path2 = 5; +} + +// A call-only ad. +message CallOnlyAdInfo { + // The country code in the ad. + google.protobuf.StringValue country_code = 1; + + // The phone number in the ad. + google.protobuf.StringValue phone_number = 2; + + // The business name in the ad. + google.protobuf.StringValue business_name = 3; + + // First headline in the ad. + google.protobuf.StringValue headline1 = 11; + + // Second headline in the ad. + google.protobuf.StringValue headline2 = 12; + + // The first line of the ad's description. + google.protobuf.StringValue description1 = 4; + + // The second line of the ad's description. + google.protobuf.StringValue description2 = 5; + + // Whether to enable call tracking for the creative. Enabling call + // tracking also enables call conversions. + google.protobuf.BoolValue call_tracked = 6; + + // Whether to disable call conversion for the creative. + // If set to `true`, disables call conversions even when `call_tracked` is + // `true`. + // If `call_tracked` is `false`, this field is ignored. + google.protobuf.BoolValue disable_call_conversion = 7; + + // The URL to be used for phone number verification. + google.protobuf.StringValue phone_number_verification_url = 8; + + // The conversion action to attribute a call conversion to. If not set a + // default conversion action is used. This field only has effect if + // call_tracked is set to true. Otherwise this field is ignored. + google.protobuf.StringValue conversion_action = 9; + + // The call conversion behavior of this call only ad. It can use its own call + // conversion setting, inherit the account level setting, or be disabled. + google.ads.googleads.v3.enums.CallConversionReportingStateEnum.CallConversionReportingState conversion_reporting_state = 10; +} + +// An expanded dynamic search ad. +message ExpandedDynamicSearchAdInfo { + // The description of the ad. + google.protobuf.StringValue description = 1; + + // The second description of the ad. + google.protobuf.StringValue description2 = 2; +} + +// A hotel ad. +message HotelAdInfo { + +} + +// A Smart Shopping ad. +message ShoppingSmartAdInfo { + +} + +// A standard Shopping ad. +message ShoppingProductAdInfo { + +} + +// A Shopping Comparison Listing ad. +message ShoppingComparisonListingAdInfo { + // Headline of the ad. This field is required. Allowed length is between 25 + // and 45 characters. + google.protobuf.StringValue headline = 1; +} + +// A Gmail ad. +message GmailAdInfo { + // The Gmail teaser. + GmailTeaser teaser = 1; + + // The MediaFile resource name of the header image. Valid image types are GIF, + // JPEG and PNG. The minimum size is 300x100 pixels and the aspect ratio must + // be between 3:1 and 5:1 (+-1%). + google.protobuf.StringValue header_image = 2; + + // The MediaFile resource name of the marketing image. Valid image types are + // GIF, JPEG and PNG. The image must either be landscape with a minimum size + // of 600x314 pixels and aspect ratio of 600:314 (+-1%) or square with a + // minimum size of 300x300 pixels and aspect ratio of 1:1 (+-1%) + google.protobuf.StringValue marketing_image = 3; + + // Headline of the marketing image. + google.protobuf.StringValue marketing_image_headline = 4; + + // Description of the marketing image. + google.protobuf.StringValue marketing_image_description = 5; + + // Display-call-to-action of the marketing image. + DisplayCallToAction marketing_image_display_call_to_action = 6; + + // Product images. Up to 15 images are supported. + repeated ProductImage product_images = 7; + + // Product videos. Up to 7 videos are supported. At least one product video + // or a marketing image must be specified. + repeated ProductVideo product_videos = 8; +} + +// Gmail teaser data. The teaser is a small header that acts as an invitation +// to view the rest of the ad (the body). +message GmailTeaser { + // Headline of the teaser. + google.protobuf.StringValue headline = 1; + + // Description of the teaser. + google.protobuf.StringValue description = 2; + + // Business name of the advertiser. + google.protobuf.StringValue business_name = 3; + + // The MediaFile resource name of the logo image. Valid image types are GIF, + // JPEG and PNG. The minimum size is 144x144 pixels and the aspect ratio must + // be 1:1 (+-1%). + google.protobuf.StringValue logo_image = 4; +} + +// Data for display call to action. The call to action is a piece of the ad +// that prompts the user to do something. Like clicking a link or making a phone +// call. +message DisplayCallToAction { + // Text for the display-call-to-action. + google.protobuf.StringValue text = 1; + + // Text color for the display-call-to-action in hexadecimal, e.g. #ffffff for + // white. + google.protobuf.StringValue text_color = 2; + + // Identifies the url collection in the ad.url_collections field. If not set + // the url defaults to final_url. + google.protobuf.StringValue url_collection_id = 3; +} + +// Product image specific data. +message ProductImage { + // The MediaFile resource name of the product image. Valid image types are + // GIF, JPEG and PNG. The minimum size is 300x300 pixels and the aspect ratio + // must be 1:1 (+-1%). + google.protobuf.StringValue product_image = 1; + + // Description of the product. + google.protobuf.StringValue description = 2; + + // Display-call-to-action of the product image. + DisplayCallToAction display_call_to_action = 3; +} + +// Product video specific data. +message ProductVideo { + // The MediaFile resource name of a video which must be hosted on YouTube. + google.protobuf.StringValue product_video = 1; +} + +// An image ad. +message ImageAdInfo { + // Width in pixels of the full size image. + google.protobuf.Int64Value pixel_width = 4; + + // Height in pixels of the full size image. + google.protobuf.Int64Value pixel_height = 5; + + // URL of the full size image. + google.protobuf.StringValue image_url = 6; + + // Width in pixels of the preview size image. + google.protobuf.Int64Value preview_pixel_width = 7; + + // Height in pixels of the preview size image. + google.protobuf.Int64Value preview_pixel_height = 8; + + // URL of the preview size image. + google.protobuf.StringValue preview_image_url = 9; + + // The mime type of the image. + google.ads.googleads.v3.enums.MimeTypeEnum.MimeType mime_type = 10; + + // The name of the image. If the image was created from a MediaFile, this is + // the MediaFile's name. If the image was created from bytes, this is empty. + google.protobuf.StringValue name = 11; + + // The image to create the ImageAd from. This can be specified in one of + // two ways. + // 1. An existing MediaFile resource. + // 2. The raw image data as bytes. + oneof image { + // The MediaFile resource to use for the image. + google.protobuf.StringValue media_file = 1; + + // Raw image data as bytes. + google.protobuf.BytesValue data = 2; + + // An ad ID to copy the image from. + google.protobuf.Int64Value ad_id_to_copy_image_from = 3; + } +} + +// Representation of video bumper in-stream ad format (very short in-stream +// non-skippable video ad). +message VideoBumperInStreamAdInfo { + // The MediaFile resource name of the companion banner used with the ad. + google.protobuf.StringValue companion_banner = 1; +} + +// Representation of video non-skippable in-stream ad format (15 second +// in-stream non-skippable video ad). +message VideoNonSkippableInStreamAdInfo { + // The MediaFile resource name of the companion banner used with the ad. + google.protobuf.StringValue companion_banner = 1; +} + +// Representation of video TrueView in-stream ad format (ad shown during video +// playback, often at beginning, which displays a skip button a few seconds into +// the video). +message VideoTrueViewInStreamAdInfo { + // Label on the CTA (call-to-action) button taking the user to the video ad's + // final URL. + // Required for TrueView for action campaigns, optional otherwise. + google.protobuf.StringValue action_button_label = 1; + + // Additional text displayed with the CTA (call-to-action) button to give + // context and encourage clicking on the button. + google.protobuf.StringValue action_headline = 2; + + // The MediaFile resource name of the companion banner used with the ad. + google.protobuf.StringValue companion_banner = 3; +} + +// Representation of video out-stream ad format (ad shown alongside a feed +// with automatic playback, without sound). +message VideoOutstreamAdInfo { + // The headline of the ad. + google.protobuf.StringValue headline = 1; + + // The description line. + google.protobuf.StringValue description = 2; +} + +// Representation of video TrueView discovery ad format. +message VideoTrueViewDiscoveryAdInfo { + // The headline of the ad. + google.protobuf.StringValue headline = 1; + + // First text line for a TrueView video discovery ad. + google.protobuf.StringValue description1 = 2; + + // Second text line for a TrueView video discovery ad. + google.protobuf.StringValue description2 = 3; +} + +// A video ad. +message VideoAdInfo { + // The MediaFile resource to use for the video. + google.protobuf.StringValue media_file = 1; + + // Format-specific schema for the different video formats. + oneof format { + // Video TrueView in-stream ad format. + VideoTrueViewInStreamAdInfo in_stream = 2; + + // Video bumper in-stream ad format. + VideoBumperInStreamAdInfo bumper = 3; + + // Video out-stream ad format. + VideoOutstreamAdInfo out_stream = 4; + + // Video non-skippable in-stream ad format. + VideoNonSkippableInStreamAdInfo non_skippable = 5; + + // Video TrueView discovery ad format. + VideoTrueViewDiscoveryAdInfo discovery = 6; + } +} + +// A responsive search ad. +// +// Responsive search ads let you create an ad that adapts to show more text, and +// more relevant messages, to your customers. Enter multiple headlines and +// descriptions when creating a responsive search ad, and over time, Google Ads +// will automatically test different combinations and learn which combinations +// perform best. By adapting your ad's content to more closely match potential +// customers' search terms, responsive search ads may improve your campaign's +// performance. +// +// More information at https://support.google.com/google-ads/answer/7684791 +message ResponsiveSearchAdInfo { + // List of text assets for headlines. When the ad serves the headlines will + // be selected from this list. + repeated AdTextAsset headlines = 1; + + // List of text assets for descriptions. When the ad serves the descriptions + // will be selected from this list. + repeated AdTextAsset descriptions = 2; + + // First part of text that may appear appended to the url displayed in the ad. + google.protobuf.StringValue path1 = 3; + + // Second part of text that may appear appended to the url displayed in the + // ad. This field can only be set when path1 is also set. + google.protobuf.StringValue path2 = 4; +} + +// A legacy responsive display ad. Ads of this type are labeled 'Responsive ads' +// in the Google Ads UI. +message LegacyResponsiveDisplayAdInfo { + // The short version of the ad's headline. + google.protobuf.StringValue short_headline = 1; + + // The long version of the ad's headline. + google.protobuf.StringValue long_headline = 2; + + // The description of the ad. + google.protobuf.StringValue description = 3; + + // The business name in the ad. + google.protobuf.StringValue business_name = 4; + + // Advertiser's consent to allow flexible color. When true, the ad may be + // served with different color if necessary. When false, the ad will be served + // with the specified colors or a neutral color. + // The default value is true. + // Must be true if main_color and accent_color are not set. + google.protobuf.BoolValue allow_flexible_color = 5; + + // The accent color of the ad in hexadecimal, e.g. #ffffff for white. + // If one of main_color and accent_color is set, the other is required as + // well. + google.protobuf.StringValue accent_color = 6; + + // The main color of the ad in hexadecimal, e.g. #ffffff for white. + // If one of main_color and accent_color is set, the other is required as + // well. + google.protobuf.StringValue main_color = 7; + + // The call-to-action text for the ad. + google.protobuf.StringValue call_to_action_text = 8; + + // The MediaFile resource name of the logo image used in the ad. + google.protobuf.StringValue logo_image = 9; + + // The MediaFile resource name of the square logo image used in the ad. + google.protobuf.StringValue square_logo_image = 10; + + // The MediaFile resource name of the marketing image used in the ad. + google.protobuf.StringValue marketing_image = 11; + + // The MediaFile resource name of the square marketing image used in the ad. + google.protobuf.StringValue square_marketing_image = 12; + + // Specifies which format the ad will be served in. Default is ALL_FORMATS. + google.ads.googleads.v3.enums.DisplayAdFormatSettingEnum.DisplayAdFormatSetting format_setting = 13; + + // Prefix before price. E.g. 'as low as'. + google.protobuf.StringValue price_prefix = 14; + + // Promotion text used for dyanmic formats of responsive ads. For example + // 'Free two-day shipping'. + google.protobuf.StringValue promo_text = 15; +} + +// An app ad. +message AppAdInfo { + // An optional text asset that, if specified, must always be displayed when + // the ad is served. + AdTextAsset mandatory_ad_text = 1; + + // List of text assets for headlines. When the ad serves the headlines will + // be selected from this list. + repeated AdTextAsset headlines = 2; + + // List of text assets for descriptions. When the ad serves the descriptions + // will be selected from this list. + repeated AdTextAsset descriptions = 3; + + // List of image assets that may be displayed with the ad. + repeated AdImageAsset images = 4; + + // List of YouTube video assets that may be displayed with the ad. + repeated AdVideoAsset youtube_videos = 5; + + // List of media bundle assets that may be used with the ad. + repeated AdMediaBundleAsset html5_media_bundles = 6; +} + +// App engagement ads allow you to write text encouraging a specific action in +// the app, like checking in, making a purchase, or booking a flight. +// They allow you to send users to a specific part of your app where they can +// find what they're looking for easier and faster. +message AppEngagementAdInfo { + // List of text assets for headlines. When the ad serves the headlines will + // be selected from this list. + repeated AdTextAsset headlines = 1; + + // List of text assets for descriptions. When the ad serves the descriptions + // will be selected from this list. + repeated AdTextAsset descriptions = 2; + + // List of image assets that may be displayed with the ad. + repeated AdImageAsset images = 3; + + // List of video assets that may be displayed with the ad. + repeated AdVideoAsset videos = 4; +} + +// A legacy app install ad that only can be used by a few select customers. +message LegacyAppInstallAdInfo { + // The id of the mobile app. + google.protobuf.StringValue app_id = 1; + + // The app store the mobile app is available in. + google.ads.googleads.v3.enums.LegacyAppInstallAdAppStoreEnum.LegacyAppInstallAdAppStore app_store = 2; + + // The headline of the ad. + google.protobuf.StringValue headline = 3; + + // The first description line of the ad. + google.protobuf.StringValue description1 = 4; + + // The second description line of the ad. + google.protobuf.StringValue description2 = 5; +} + +// A responsive display ad. +message ResponsiveDisplayAdInfo { + // Marketing images to be used in the ad. Valid image types are GIF, + // JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must + // be 1.91:1 (+-1%). At least one marketing_image is required. Combined with + // square_marketing_images the maximum is 15. + repeated AdImageAsset marketing_images = 1; + + // Square marketing images to be used in the ad. Valid image types are GIF, + // JPEG, and PNG. The minimum size is 300x300 and the aspect ratio must + // be 1:1 (+-1%). At least one square marketing_image is required. Combined + // with marketing_images the maximum is 15. + repeated AdImageAsset square_marketing_images = 2; + + // Logo images to be used in the ad. Valid image types are GIF, + // JPEG, and PNG. The minimum size is 512x128 and the aspect ratio must + // be 4:1 (+-1%). Combined with square_logo_images the maximum is 5. + repeated AdImageAsset logo_images = 3; + + // Square logo images to be used in the ad. Valid image types are GIF, + // JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must + // be 1:1 (+-1%). Combined with square_logo_images the maximum is 5. + repeated AdImageAsset square_logo_images = 4; + + // Short format headlines for the ad. The maximum length is 30 characters. + // At least 1 and max 5 headlines can be specified. + repeated AdTextAsset headlines = 5; + + // A required long format headline. The maximum length is 90 characters. + AdTextAsset long_headline = 6; + + // Descriptive texts for the ad. The maximum length is 90 characters. At + // least 1 and max 5 headlines can be specified. + repeated AdTextAsset descriptions = 7; + + // Optional YouTube videos for the ad. A maximum of 5 videos can be specified. + repeated AdVideoAsset youtube_videos = 8; + + // The advertiser/brand name. Maximum display width is 25. + google.protobuf.StringValue business_name = 9; + + // The main color of the ad in hexadecimal, e.g. #ffffff for white. + // If one of main_color and accent_color is set, the other is required as + // well. + google.protobuf.StringValue main_color = 10; + + // The accent color of the ad in hexadecimal, e.g. #ffffff for white. + // If one of main_color and accent_color is set, the other is required as + // well. + google.protobuf.StringValue accent_color = 11; + + // Advertiser's consent to allow flexible color. When true, the ad may be + // served with different color if necessary. When false, the ad will be served + // with the specified colors or a neutral color. + // The default value is true. + // Must be true if main_color and accent_color are not set. + google.protobuf.BoolValue allow_flexible_color = 12; + + // The call-to-action text for the ad. Maximum display width is 30. + google.protobuf.StringValue call_to_action_text = 13; + + // Prefix before price. E.g. 'as low as'. + google.protobuf.StringValue price_prefix = 14; + + // Promotion text used for dyanmic formats of responsive ads. For example + // 'Free two-day shipping'. + google.protobuf.StringValue promo_text = 15; + + // Specifies which format the ad will be served in. Default is ALL_FORMATS. + google.ads.googleads.v3.enums.DisplayAdFormatSettingEnum.DisplayAdFormatSetting format_setting = 16; +} + +// A generic type of display ad. The exact ad format is controlled by the +// display_upload_product_type field, which determines what kinds of data +// need to be included with the ad. +message DisplayUploadAdInfo { + // The product type of this ad. See comments on the enum for details. + google.ads.googleads.v3.enums.DisplayUploadProductTypeEnum.DisplayUploadProductType display_upload_product_type = 1; + + // The asset data that makes up the ad. + oneof media_asset { + // A media bundle asset to be used in the ad. For information about the + // media bundle for HTML5_UPLOAD_AD see + // https://support.google.com/google-ads/answer/1722096 + // Media bundles that are part of dynamic product types use a special format + // that needs to be created through the Google Web Designer. See + // https://support.google.com/webdesigner/answer/7543898 for more + // information. + AdMediaBundleAsset media_bundle = 2; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/asset_types.proto b/third_party/googleapis/google/ads/googleads/v3/common/asset_types.proto new file mode 100644 index 000000000..eb33d4777 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/asset_types.proto @@ -0,0 +1,81 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/ads/googleads/v3/enums/mime_type.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "AssetTypesProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file containing info messages for specific asset types. + +// A YouTube asset. +message YoutubeVideoAsset { + // YouTube video id. This is the 11 character string value used in the + // YouTube video URL. + google.protobuf.StringValue youtube_video_id = 1; +} + +// A MediaBundle asset. +message MediaBundleAsset { + // Media bundle (ZIP file) asset data. The format of the uploaded ZIP file + // depends on the ad field where it will be used. For more information on the + // format, see the documentation of the ad field where you plan on using the + // MediaBundleAsset. This field is mutate only. + google.protobuf.BytesValue data = 1; +} + +// An Image asset. +message ImageAsset { + // The raw bytes data of an image. This field is mutate only. + google.protobuf.BytesValue data = 1; + + // File size of the image asset in bytes. + google.protobuf.Int64Value file_size = 2; + + // MIME type of the image asset. + google.ads.googleads.v3.enums.MimeTypeEnum.MimeType mime_type = 3; + + // Metadata for this image at its original size. + ImageDimension full_size = 4; +} + +// Metadata for an image at a certain size, either original or resized. +message ImageDimension { + // Height of the image. + google.protobuf.Int64Value height_pixels = 1; + + // Width of the image. + google.protobuf.Int64Value width_pixels = 2; + + // A URL that returns the image with this height and width. + google.protobuf.StringValue url = 3; +} + +// A Text asset. +message TextAsset { + // Text content of the text asset. + google.protobuf.StringValue text = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/bidding.proto b/third_party/googleapis/google/ads/googleads/v3/common/bidding.proto new file mode 100644 index 000000000..cded37b4f --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/bidding.proto @@ -0,0 +1,169 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/ads/googleads/v3/enums/target_impression_share_location.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "BiddingProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file describing bidding schemes. + +// Commission is an automatic bidding strategy in which the advertiser pays a +// certain portion of the conversion value. +message Commission { + // Commission rate defines the portion of the conversion value that the + // advertiser will be billed. A commission rate of x should be passed into + // this field as (x * 1,000,000). For example, 106,000 represents a commission + // rate of 0.106 (10.6%). + google.protobuf.Int64Value commission_rate_micros = 1; +} + +// An automated bidding strategy that raises bids for clicks +// that seem more likely to lead to a conversion and lowers +// them for clicks where they seem less likely. +message EnhancedCpc { + +} + +// Manual click-based bidding where user pays per click. +message ManualCpc { + // Whether bids are to be enhanced based on conversion optimizer data. + google.protobuf.BoolValue enhanced_cpc_enabled = 1; +} + +// Manual impression-based bidding where user pays per thousand impressions. +message ManualCpm { + +} + +// View based bidding where user pays per video view. +message ManualCpv { + +} + +// An automated bidding strategy that sets bids to help get the most conversions +// for your campaign while spending your budget. +message MaximizeConversions { + +} + +// An automated bidding strategy which tries to maximize conversion value +// given a daily budget. +message MaximizeConversionValue { + // The target return on ad spend (ROAS) option. If set, the bid strategy will + // maximize revenue while averaging the target return on ad spend. If the + // target ROAS is high, the bid strategy may not be able to spend the full + // budget. If the target ROAS is not set, the bid strategy will aim to + // achieve the highest possible ROAS for the budget. + google.protobuf.DoubleValue target_roas = 1; +} + +// An automated bid strategy that sets bids to help get as many conversions as +// possible at the target cost-per-acquisition (CPA) you set. +message TargetCpa { + // Average CPA target. + // This target should be greater than or equal to minimum billable unit based + // on the currency for the account. + google.protobuf.Int64Value target_cpa_micros = 1; + + // Maximum bid limit that can be set by the bid strategy. + // The limit applies to all keywords managed by the strategy. + google.protobuf.Int64Value cpc_bid_ceiling_micros = 2; + + // Minimum bid limit that can be set by the bid strategy. + // The limit applies to all keywords managed by the strategy. + google.protobuf.Int64Value cpc_bid_floor_micros = 3; +} + +// Target CPM (cost per thousand impressions) is an automated bidding strategy +// that sets bids to optimize performance given the target CPM you set. +message TargetCpm { + +} + +// An automated bidding strategy that sets bids so that a certain percentage of +// search ads are shown at the top of the first page (or other targeted +// location). +// next tag = 4 +message TargetImpressionShare { + // The targeted location on the search results page. + google.ads.googleads.v3.enums.TargetImpressionShareLocationEnum.TargetImpressionShareLocation location = 1; + + // The desired fraction of ads to be shown in the targeted location in micros. + // E.g. 1% equals 10,000. + google.protobuf.Int64Value location_fraction_micros = 2; + + // The highest CPC bid the automated bidding system is permitted to specify. + // This is a required field entered by the advertiser that sets the ceiling + // and specified in local micros. + google.protobuf.Int64Value cpc_bid_ceiling_micros = 3; +} + +// An automated bidding strategy that helps you maximize revenue while +// averaging a specific target return on ad spend (ROAS). +message TargetRoas { + // Required. The desired revenue (based on conversion data) per unit of spend. + // Value must be between 0.01 and 1000.0, inclusive. + google.protobuf.DoubleValue target_roas = 1; + + // Maximum bid limit that can be set by the bid strategy. + // The limit applies to all keywords managed by the strategy. + google.protobuf.Int64Value cpc_bid_ceiling_micros = 2; + + // Minimum bid limit that can be set by the bid strategy. + // The limit applies to all keywords managed by the strategy. + google.protobuf.Int64Value cpc_bid_floor_micros = 3; +} + +// An automated bid strategy that sets your bids to help get as many clicks +// as possible within your budget. +message TargetSpend { + // The spend target under which to maximize clicks. + // A TargetSpend bidder will attempt to spend the smaller of this value + // or the natural throttling spend amount. + // If not specified, the budget is used as the spend target. + google.protobuf.Int64Value target_spend_micros = 1; + + // Maximum bid limit that can be set by the bid strategy. + // The limit applies to all keywords managed by the strategy. + google.protobuf.Int64Value cpc_bid_ceiling_micros = 2; +} + +// A bidding strategy where bids are a fraction of the advertised price for +// some good or service. +message PercentCpc { + // Maximum bid limit that can be set by the bid strategy. This is + // an optional field entered by the advertiser and specified in local micros. + // Note: A zero value is interpreted in the same way as having bid_ceiling + // undefined. + google.protobuf.Int64Value cpc_bid_ceiling_micros = 1; + + // Adjusts the bid for each auction upward or downward, depending on the + // likelihood of a conversion. Individual bids may exceed + // cpc_bid_ceiling_micros, but the average bid amount for a campaign should + // not. + google.protobuf.BoolValue enhanced_cpc_enabled = 2; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/click_location.proto b/third_party/googleapis/google/ads/googleads/v3/common/click_location.proto new file mode 100644 index 000000000..21069c2a4 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/click_location.proto @@ -0,0 +1,49 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "ClickLocationProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file describing a ClickLocation. + +// Location criteria associated with a click. +message ClickLocation { + // The city location criterion associated with the impression. + google.protobuf.StringValue city = 1; + + // The country location criterion associated with the impression. + google.protobuf.StringValue country = 2; + + // The metro location criterion associated with the impression. + google.protobuf.StringValue metro = 3; + + // The most specific location criterion associated with the impression. + google.protobuf.StringValue most_specific = 4; + + // The region location criterion associated with the impression. + google.protobuf.StringValue region = 5; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/criteria.proto b/third_party/googleapis/google/ads/googleads/v3/common/criteria.proto new file mode 100644 index 000000000..9442c75ff --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/criteria.proto @@ -0,0 +1,593 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/ads/googleads/v3/enums/age_range_type.proto"; +import "google/ads/googleads/v3/enums/app_payment_model_type.proto"; +import "google/ads/googleads/v3/enums/content_label_type.proto"; +import "google/ads/googleads/v3/enums/day_of_week.proto"; +import "google/ads/googleads/v3/enums/device.proto"; +import "google/ads/googleads/v3/enums/gender_type.proto"; +import "google/ads/googleads/v3/enums/hotel_date_selection_type.proto"; +import "google/ads/googleads/v3/enums/income_range_type.proto"; +import "google/ads/googleads/v3/enums/interaction_type.proto"; +import "google/ads/googleads/v3/enums/keyword_match_type.proto"; +import "google/ads/googleads/v3/enums/listing_group_type.proto"; +import "google/ads/googleads/v3/enums/location_group_radius_units.proto"; +import "google/ads/googleads/v3/enums/minute_of_hour.proto"; +import "google/ads/googleads/v3/enums/parental_status_type.proto"; +import "google/ads/googleads/v3/enums/preferred_content_type.proto"; +import "google/ads/googleads/v3/enums/product_bidding_category_level.proto"; +import "google/ads/googleads/v3/enums/product_channel.proto"; +import "google/ads/googleads/v3/enums/product_channel_exclusivity.proto"; +import "google/ads/googleads/v3/enums/product_condition.proto"; +import "google/ads/googleads/v3/enums/product_custom_attribute_index.proto"; +import "google/ads/googleads/v3/enums/product_type_level.proto"; +import "google/ads/googleads/v3/enums/proximity_radius_units.proto"; +import "google/ads/googleads/v3/enums/webpage_condition_operand.proto"; +import "google/ads/googleads/v3/enums/webpage_condition_operator.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "CriteriaProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file describing criteria types. + +// A keyword criterion. +message KeywordInfo { + // The text of the keyword (at most 80 characters and 10 words). + google.protobuf.StringValue text = 1; + + // The match type of the keyword. + google.ads.googleads.v3.enums.KeywordMatchTypeEnum.KeywordMatchType match_type = 2; +} + +// A placement criterion. This can be used to modify bids for sites when +// targeting the content network. +message PlacementInfo { + // URL of the placement. + // + // For example, "http://www.domain.com". + google.protobuf.StringValue url = 1; +} + +// A mobile app category criterion. +message MobileAppCategoryInfo { + // The mobile app category constant resource name. + google.protobuf.StringValue mobile_app_category_constant = 1; +} + +// A mobile application criterion. +message MobileApplicationInfo { + // A string that uniquely identifies a mobile application to Google Ads API. + // The format of this string is "{platform}-{platform_native_id}", where + // platform is "1" for iOS apps and "2" for Android apps, and where + // platform_native_id is the mobile application identifier native to the + // corresponding platform. + // For iOS, this native identifier is the 9 digit string that appears at the + // end of an App Store URL (e.g., "476943146" for "Flood-It! 2" whose App + // Store link is "http://itunes.apple.com/us/app/flood-it!-2/id476943146"). + // For Android, this native identifier is the application's package name + // (e.g., "com.labpixies.colordrips" for "Color Drips" given Google Play link + // "https://play.google.com/store/apps/details?id=com.labpixies.colordrips"). + // A well formed app id for Google Ads API would thus be "1-476943146" for iOS + // and "2-com.labpixies.colordrips" for Android. + // This field is required and must be set in CREATE operations. + google.protobuf.StringValue app_id = 2; + + // Name of this mobile application. + google.protobuf.StringValue name = 3; +} + +// A location criterion. +message LocationInfo { + // The geo target constant resource name. + google.protobuf.StringValue geo_target_constant = 1; +} + +// A device criterion. +message DeviceInfo { + // Type of the device. + google.ads.googleads.v3.enums.DeviceEnum.Device type = 1; +} + +// A preferred content criterion. +message PreferredContentInfo { + // Type of the preferred content. + google.ads.googleads.v3.enums.PreferredContentTypeEnum.PreferredContentType type = 2; +} + +// A listing group criterion. +message ListingGroupInfo { + // Type of the listing group. + google.ads.googleads.v3.enums.ListingGroupTypeEnum.ListingGroupType type = 1; + + // Dimension value with which this listing group is refining its parent. + // Undefined for the root group. + ListingDimensionInfo case_value = 2; + + // Resource name of ad group criterion which is the parent listing group + // subdivision. Null for the root group. + google.protobuf.StringValue parent_ad_group_criterion = 3; +} + +// A listing scope criterion. +message ListingScopeInfo { + // Scope of the campaign criterion. + repeated ListingDimensionInfo dimensions = 2; +} + +// Listing dimensions for listing group criterion. +message ListingDimensionInfo { + // Dimension of one of the types below is always present. + oneof dimension { + // Advertiser-specific hotel ID. + HotelIdInfo hotel_id = 2; + + // Class of the hotel as a number of stars 1 to 5. + HotelClassInfo hotel_class = 3; + + // Country or Region the hotel is located in. + HotelCountryRegionInfo hotel_country_region = 4; + + // State the hotel is located in. + HotelStateInfo hotel_state = 5; + + // City the hotel is located in. + HotelCityInfo hotel_city = 6; + + // Bidding category of a product offer. + ProductBiddingCategoryInfo product_bidding_category = 13; + + // Brand of a product offer. + ProductBrandInfo product_brand = 15; + + // Locality of a product offer. + ProductChannelInfo product_channel = 8; + + // Availability of a product offer. + ProductChannelExclusivityInfo product_channel_exclusivity = 9; + + // Condition of a product offer. + ProductConditionInfo product_condition = 10; + + // Custom attribute of a product offer. + ProductCustomAttributeInfo product_custom_attribute = 16; + + // Item id of a product offer. + ProductItemIdInfo product_item_id = 11; + + // Type of a product offer. + ProductTypeInfo product_type = 12; + + // Unknown dimension. Set when no other listing dimension is set. + UnknownListingDimensionInfo unknown_listing_dimension = 14; + } +} + +// Advertiser-specific hotel ID. +message HotelIdInfo { + // String value of the hotel ID. + google.protobuf.StringValue value = 1; +} + +// Class of the hotel as a number of stars 1 to 5. +message HotelClassInfo { + // Long value of the hotel class. + google.protobuf.Int64Value value = 1; +} + +// Country or Region the hotel is located in. +message HotelCountryRegionInfo { + // The Geo Target Constant resource name. + google.protobuf.StringValue country_region_criterion = 1; +} + +// State the hotel is located in. +message HotelStateInfo { + // The Geo Target Constant resource name. + google.protobuf.StringValue state_criterion = 1; +} + +// City the hotel is located in. +message HotelCityInfo { + // The Geo Target Constant resource name. + google.protobuf.StringValue city_criterion = 1; +} + +// Bidding category of a product offer. +message ProductBiddingCategoryInfo { + // ID of the product bidding category. + // + // This ID is equivalent to the google_product_category ID as described in + // this article: https://support.google.com/merchants/answer/6324436 + google.protobuf.Int64Value id = 1; + + // Two-letter upper-case country code of the product bidding category. It must + // match the campaign.shopping_setting.sales_country field. + google.protobuf.StringValue country_code = 2; + + // Level of the product bidding category. + google.ads.googleads.v3.enums.ProductBiddingCategoryLevelEnum.ProductBiddingCategoryLevel level = 3; +} + +// Brand of the product. +message ProductBrandInfo { + // String value of the product brand. + google.protobuf.StringValue value = 1; +} + +// Locality of a product offer. +message ProductChannelInfo { + // Value of the locality. + google.ads.googleads.v3.enums.ProductChannelEnum.ProductChannel channel = 1; +} + +// Availability of a product offer. +message ProductChannelExclusivityInfo { + // Value of the availability. + google.ads.googleads.v3.enums.ProductChannelExclusivityEnum.ProductChannelExclusivity channel_exclusivity = 1; +} + +// Condition of a product offer. +message ProductConditionInfo { + // Value of the condition. + google.ads.googleads.v3.enums.ProductConditionEnum.ProductCondition condition = 1; +} + +// Custom attribute of a product offer. +message ProductCustomAttributeInfo { + // String value of the product custom attribute. + google.protobuf.StringValue value = 1; + + // Indicates the index of the custom attribute. + google.ads.googleads.v3.enums.ProductCustomAttributeIndexEnum.ProductCustomAttributeIndex index = 2; +} + +// Item id of a product offer. +message ProductItemIdInfo { + // Value of the id. + google.protobuf.StringValue value = 1; +} + +// Type of a product offer. +message ProductTypeInfo { + // Value of the type. + google.protobuf.StringValue value = 1; + + // Level of the type. + google.ads.googleads.v3.enums.ProductTypeLevelEnum.ProductTypeLevel level = 2; +} + +// Unknown listing dimension. +message UnknownListingDimensionInfo { + +} + +// Criterion for hotel date selection (default dates vs. user selected). +message HotelDateSelectionTypeInfo { + // Type of the hotel date selection + google.ads.googleads.v3.enums.HotelDateSelectionTypeEnum.HotelDateSelectionType type = 1; +} + +// Criterion for number of days prior to the stay the booking is being made. +message HotelAdvanceBookingWindowInfo { + // Low end of the number of days prior to the stay. + google.protobuf.Int64Value min_days = 1; + + // High end of the number of days prior to the stay. + google.protobuf.Int64Value max_days = 2; +} + +// Criterion for length of hotel stay in nights. +message HotelLengthOfStayInfo { + // Low end of the number of nights in the stay. + google.protobuf.Int64Value min_nights = 1; + + // High end of the number of nights in the stay. + google.protobuf.Int64Value max_nights = 2; +} + +// Criterion for day of the week the booking is for. +message HotelCheckInDayInfo { + // The day of the week. + google.ads.googleads.v3.enums.DayOfWeekEnum.DayOfWeek day_of_week = 1; +} + +// Criterion for Interaction Type. +message InteractionTypeInfo { + // The interaction type. + google.ads.googleads.v3.enums.InteractionTypeEnum.InteractionType type = 1; +} + +// Represents an AdSchedule criterion. +// +// AdSchedule is specified as the day of the week and a time interval +// within which ads will be shown. +// +// No more than six AdSchedules can be added for the same day. +message AdScheduleInfo { + // Minutes after the start hour at which this schedule starts. + // + // This field is required for CREATE operations and is prohibited on UPDATE + // operations. + google.ads.googleads.v3.enums.MinuteOfHourEnum.MinuteOfHour start_minute = 1; + + // Minutes after the end hour at which this schedule ends. The schedule is + // exclusive of the end minute. + // + // This field is required for CREATE operations and is prohibited on UPDATE + // operations. + google.ads.googleads.v3.enums.MinuteOfHourEnum.MinuteOfHour end_minute = 2; + + // Starting hour in 24 hour time. + // This field must be between 0 and 23, inclusive. + // + // This field is required for CREATE operations and is prohibited on UPDATE + // operations. + google.protobuf.Int32Value start_hour = 3; + + // Ending hour in 24 hour time; 24 signifies end of the day. + // This field must be between 0 and 24, inclusive. + // + // This field is required for CREATE operations and is prohibited on UPDATE + // operations. + google.protobuf.Int32Value end_hour = 4; + + // Day of the week the schedule applies to. + // + // This field is required for CREATE operations and is prohibited on UPDATE + // operations. + google.ads.googleads.v3.enums.DayOfWeekEnum.DayOfWeek day_of_week = 5; +} + +// An age range criterion. +message AgeRangeInfo { + // Type of the age range. + google.ads.googleads.v3.enums.AgeRangeTypeEnum.AgeRangeType type = 1; +} + +// A gender criterion. +message GenderInfo { + // Type of the gender. + google.ads.googleads.v3.enums.GenderTypeEnum.GenderType type = 1; +} + +// An income range criterion. +message IncomeRangeInfo { + // Type of the income range. + google.ads.googleads.v3.enums.IncomeRangeTypeEnum.IncomeRangeType type = 1; +} + +// A parental status criterion. +message ParentalStatusInfo { + // Type of the parental status. + google.ads.googleads.v3.enums.ParentalStatusTypeEnum.ParentalStatusType type = 1; +} + +// A YouTube Video criterion. +message YouTubeVideoInfo { + // YouTube video id as it appears on the YouTube watch page. + google.protobuf.StringValue video_id = 1; +} + +// A YouTube Channel criterion. +message YouTubeChannelInfo { + // The YouTube uploader channel id or the channel code of a YouTube channel. + google.protobuf.StringValue channel_id = 1; +} + +// A User List criterion. Represents a user list that is defined by the +// advertiser to be targeted. +message UserListInfo { + // The User List resource name. + google.protobuf.StringValue user_list = 1; +} + +// A Proximity criterion. The geo point and radius determine what geographical +// area is included. The address is a description of the geo point that does +// not affect ad serving. +// +// There are two ways to create a proximity. First, by setting an address +// and radius. The geo point will be automatically computed. Second, by +// setting a geo point and radius. The address is an optional label that won't +// be validated. +message ProximityInfo { + // Latitude and longitude. + GeoPointInfo geo_point = 1; + + // The radius of the proximity. + google.protobuf.DoubleValue radius = 2; + + // The unit of measurement of the radius. Default is KILOMETERS. + google.ads.googleads.v3.enums.ProximityRadiusUnitsEnum.ProximityRadiusUnits radius_units = 3; + + // Full address. + AddressInfo address = 4; +} + +// Geo point for proximity criterion. +message GeoPointInfo { + // Micro degrees for the longitude. + google.protobuf.Int32Value longitude_in_micro_degrees = 1; + + // Micro degrees for the latitude. + google.protobuf.Int32Value latitude_in_micro_degrees = 2; +} + +// Address for proximity criterion. +message AddressInfo { + // Postal code. + google.protobuf.StringValue postal_code = 1; + + // Province or state code. + google.protobuf.StringValue province_code = 2; + + // Country code. + google.protobuf.StringValue country_code = 3; + + // Province or state name. + google.protobuf.StringValue province_name = 4; + + // Street address line 1. + google.protobuf.StringValue street_address = 5; + + // Street address line 2. This field is write-only. It is only used for + // calculating the longitude and latitude of an address when geo_point is + // empty. + google.protobuf.StringValue street_address2 = 6; + + // Name of the city. + google.protobuf.StringValue city_name = 7; +} + +// A topic criterion. Use topics to target or exclude placements in the +// Google Display Network based on the category into which the placement falls +// (for example, "Pets & Animals/Pets/Dogs"). +message TopicInfo { + // The Topic Constant resource name. + google.protobuf.StringValue topic_constant = 1; + + // The category to target or exclude. Each subsequent element in the array + // describes a more specific sub-category. For example, + // "Pets & Animals", "Pets", "Dogs" represents the "Pets & Animals/Pets/Dogs" + // category. + repeated google.protobuf.StringValue path = 2; +} + +// A language criterion. +message LanguageInfo { + // The language constant resource name. + google.protobuf.StringValue language_constant = 1; +} + +// An IpBlock criterion used for IP exclusions. We allow: +// - IPv4 and IPv6 addresses +// - individual addresses (192.168.0.1) +// - masks for individual addresses (192.168.0.1/32) +// - masks for Class C networks (192.168.0.1/24) +message IpBlockInfo { + // The IP address of this IP block. + google.protobuf.StringValue ip_address = 1; +} + +// Content Label for category exclusion. +message ContentLabelInfo { + // Content label type, required for CREATE operations. + google.ads.googleads.v3.enums.ContentLabelTypeEnum.ContentLabelType type = 1; +} + +// Represents a Carrier Criterion. +message CarrierInfo { + // The Carrier constant resource name. + google.protobuf.StringValue carrier_constant = 1; +} + +// Represents a particular interest-based topic to be targeted. +message UserInterestInfo { + // The UserInterest resource name. + google.protobuf.StringValue user_interest_category = 1; +} + +// Represents a criterion for targeting webpages of an advertiser's website. +message WebpageInfo { + // The name of the criterion that is defined by this parameter. The name value + // will be used for identifying, sorting and filtering criteria with this type + // of parameters. + // + // This field is required for CREATE operations and is prohibited on UPDATE + // operations. + google.protobuf.StringValue criterion_name = 1; + + // Conditions, or logical expressions, for webpage targeting. The list of + // webpage targeting conditions are and-ed together when evaluated + // for targeting. + // + // This field is required for CREATE operations and is prohibited on UPDATE + // operations. + repeated WebpageConditionInfo conditions = 2; +} + +// Logical expression for targeting webpages of an advertiser's website. +message WebpageConditionInfo { + // Operand of webpage targeting condition. + google.ads.googleads.v3.enums.WebpageConditionOperandEnum.WebpageConditionOperand operand = 1; + + // Operator of webpage targeting condition. + google.ads.googleads.v3.enums.WebpageConditionOperatorEnum.WebpageConditionOperator operator = 2; + + // Argument of webpage targeting condition. + google.protobuf.StringValue argument = 3; +} + +// Represents an operating system version to be targeted. +message OperatingSystemVersionInfo { + // The operating system version constant resource name. + google.protobuf.StringValue operating_system_version_constant = 1; +} + +// An app payment model criterion. +message AppPaymentModelInfo { + // Type of the app payment model. + google.ads.googleads.v3.enums.AppPaymentModelTypeEnum.AppPaymentModelType type = 1; +} + +// A mobile device criterion. +message MobileDeviceInfo { + // The mobile device constant resource name. + google.protobuf.StringValue mobile_device_constant = 1; +} + +// A custom affinity criterion. +// A criterion of this type is only targetable. +message CustomAffinityInfo { + // The CustomInterest resource name. + google.protobuf.StringValue custom_affinity = 1; +} + +// A custom intent criterion. +// A criterion of this type is only targetable. +message CustomIntentInfo { + // The CustomInterest resource name. + google.protobuf.StringValue custom_intent = 1; +} + +// A radius around a list of locations specified via a feed. +message LocationGroupInfo { + // Feed specifying locations for targeting. + // This is required and must be set in CREATE operations. + google.protobuf.StringValue feed = 1; + + // Geo target constant(s) restricting the scope of the geographic area within + // the feed. Currently only one geo target constant is allowed. + repeated google.protobuf.StringValue geo_target_constants = 2; + + // Distance in units specifying the radius around targeted locations. + // This is required and must be set in CREATE operations. + google.protobuf.Int64Value radius = 3; + + // Unit of the radius, miles and meters supported currently. + // This is required and must be set in CREATE operations. + google.ads.googleads.v3.enums.LocationGroupRadiusUnitsEnum.LocationGroupRadiusUnits radius_units = 4; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/criterion_category_availability.proto b/third_party/googleapis/google/ads/googleads/v3/common/criterion_category_availability.proto new file mode 100644 index 000000000..7770b5012 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/criterion_category_availability.proto @@ -0,0 +1,83 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/ads/googleads/v3/enums/advertising_channel_sub_type.proto"; +import "google/ads/googleads/v3/enums/advertising_channel_type.proto"; +import "google/ads/googleads/v3/enums/criterion_category_channel_availability_mode.proto"; +import "google/ads/googleads/v3/enums/criterion_category_locale_availability_mode.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "CriterionCategoryAvailabilityProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file describing criterion category availability information. + +// Information of category availability, per advertising channel. +message CriterionCategoryAvailability { + // Channel types and subtypes that are available to the category. + CriterionCategoryChannelAvailability channel = 1; + + // Locales that are available to the category for the channel. + repeated CriterionCategoryLocaleAvailability locale = 2; +} + +// Information of advertising channel type and subtypes a category is available +// in. +message CriterionCategoryChannelAvailability { + // Format of the channel availability. Can be ALL_CHANNELS (the rest of the + // fields will not be set), CHANNEL_TYPE (only advertising_channel_type type + // will be set, the category is available to all sub types under it) or + // CHANNEL_TYPE_AND_SUBTYPES (advertising_channel_type, + // advertising_channel_sub_type, and include_default_channel_sub_type will all + // be set). + google.ads.googleads.v3.enums.CriterionCategoryChannelAvailabilityModeEnum.CriterionCategoryChannelAvailabilityMode availability_mode = 1; + + // Channel type the category is available to. + google.ads.googleads.v3.enums.AdvertisingChannelTypeEnum.AdvertisingChannelType advertising_channel_type = 2; + + // Channel subtypes under the channel type the category is available to. + repeated google.ads.googleads.v3.enums.AdvertisingChannelSubTypeEnum.AdvertisingChannelSubType advertising_channel_sub_type = 3; + + // Whether default channel sub type is included. For example, + // advertising_channel_type being DISPLAY and include_default_channel_sub_type + // being false means that the default display campaign where channel sub type + // is not set is not included in this availability configuration. + google.protobuf.BoolValue include_default_channel_sub_type = 4; +} + +// Information about which locales a category is available in. +message CriterionCategoryLocaleAvailability { + // Format of the locale availability. Can be LAUNCHED_TO_ALL (both country and + // language will be empty), COUNTRY (only country will be set), LANGUAGE (only + // language wil be set), COUNTRY_AND_LANGUAGE (both country and language will + // be set). + google.ads.googleads.v3.enums.CriterionCategoryLocaleAvailabilityModeEnum.CriterionCategoryLocaleAvailabilityMode availability_mode = 1; + + // Code of the country. + google.protobuf.StringValue country_code = 2; + + // Code of the language. + google.protobuf.StringValue language_code = 3; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/custom_parameter.proto b/third_party/googleapis/google/ads/googleads/v3/common/custom_parameter.proto new file mode 100644 index 000000000..1710c1620 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/custom_parameter.proto @@ -0,0 +1,41 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "CustomParameterProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file describing CustomParameter and operation + +// A mapping that can be used by custom parameter tags in a +// `tracking_url_template`, `final_urls`, or `mobile_final_urls`. +message CustomParameter { + // The key matching the parameter tag name. + google.protobuf.StringValue key = 1; + + // The value to be substituted. + google.protobuf.StringValue value = 2; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/dates.proto b/third_party/googleapis/google/ads/googleads/v3/common/dates.proto new file mode 100644 index 000000000..b1edbd0c7 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/dates.proto @@ -0,0 +1,40 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "DatesProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file describing date range message. + +// A date range. +message DateRange { + // The start date, in yyyy-mm-dd format. This date is inclusive. + google.protobuf.StringValue start_date = 1; + + // The end date, in yyyy-mm-dd format. This date is inclusive. + google.protobuf.StringValue end_date = 2; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/explorer_auto_optimizer_setting.proto b/third_party/googleapis/google/ads/googleads/v3/common/explorer_auto_optimizer_setting.proto new file mode 100644 index 000000000..0506cf859 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/explorer_auto_optimizer_setting.proto @@ -0,0 +1,39 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "ExplorerAutoOptimizerSettingProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file describing ExplorerAutoOptimizerSetting + +// Settings for the Display Campaign Optimizer, initially named "Explorer". +// Learn more about +// [automatic targeting](https://support.google.com/google-ads/answer/190596). +message ExplorerAutoOptimizerSetting { + // Indicates whether the optimizer is turned on. + google.protobuf.BoolValue opt_in = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/extensions.proto b/third_party/googleapis/google/ads/googleads/v3/common/extensions.proto new file mode 100644 index 000000000..19026eaa2 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/extensions.proto @@ -0,0 +1,357 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/ads/googleads/v3/common/custom_parameter.proto"; +import "google/ads/googleads/v3/common/feed_common.proto"; +import "google/ads/googleads/v3/enums/app_store.proto"; +import "google/ads/googleads/v3/enums/call_conversion_reporting_state.proto"; +import "google/ads/googleads/v3/enums/price_extension_price_qualifier.proto"; +import "google/ads/googleads/v3/enums/price_extension_price_unit.proto"; +import "google/ads/googleads/v3/enums/price_extension_type.proto"; +import "google/ads/googleads/v3/enums/promotion_extension_discount_modifier.proto"; +import "google/ads/googleads/v3/enums/promotion_extension_occasion.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "ExtensionsProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file describing extension types. + +// Represents an App extension. +message AppFeedItem { + // The visible text displayed when the link is rendered in an ad. + // This string must not be empty, and the length of this string should + // be between 1 and 25, inclusive. + google.protobuf.StringValue link_text = 1; + + // The store-specific ID for the target application. + // This string must not be empty. + google.protobuf.StringValue app_id = 2; + + // The application store that the target application belongs to. + // This field is required. + google.ads.googleads.v3.enums.AppStoreEnum.AppStore app_store = 3; + + // A list of possible final URLs after all cross domain redirects. + // This list must not be empty. + repeated google.protobuf.StringValue final_urls = 4; + + // A list of possible final mobile URLs after all cross domain redirects. + repeated google.protobuf.StringValue final_mobile_urls = 5; + + // URL template for constructing a tracking URL. Default value is "{lpurl}". + google.protobuf.StringValue tracking_url_template = 6; + + // A list of mappings to be used for substituting URL custom parameter tags in + // the tracking_url_template, final_urls, and/or final_mobile_urls. + repeated CustomParameter url_custom_parameters = 7; + + // URL template for appending params to landing page URLs served with parallel + // tracking. + google.protobuf.StringValue final_url_suffix = 8; +} + +// Represents a Call extension. +message CallFeedItem { + // The advertiser's phone number to append to the ad. + // This string must not be empty. + google.protobuf.StringValue phone_number = 1; + + // Uppercase two-letter country code of the advertiser's phone number. + // This string must not be empty. + google.protobuf.StringValue country_code = 2; + + // Indicates whether call tracking is enabled. By default, call tracking is + // not enabled. + google.protobuf.BoolValue call_tracking_enabled = 3; + + // The conversion action to attribute a call conversion to. If not set a + // default conversion action is used. This field only has effect if + // call_tracking_enabled is set to true. Otherwise this field is ignored. + google.protobuf.StringValue call_conversion_action = 4; + + // If true, disable call conversion tracking. call_conversion_action should + // not be set if this is true. Optional. + google.protobuf.BoolValue call_conversion_tracking_disabled = 5; + + // Enum value that indicates whether this call extension uses its own call + // conversion setting (or just have call conversion disabled), or following + // the account level setting. + google.ads.googleads.v3.enums.CallConversionReportingStateEnum.CallConversionReportingState call_conversion_reporting_state = 6; +} + +// Represents a callout extension. +message CalloutFeedItem { + // The callout text. + // The length of this string should be between 1 and 25, inclusive. + google.protobuf.StringValue callout_text = 1; +} + +// Represents a location extension. +message LocationFeedItem { + // The name of the business. + google.protobuf.StringValue business_name = 1; + + // Line 1 of the business address. + google.protobuf.StringValue address_line_1 = 2; + + // Line 2 of the business address. + google.protobuf.StringValue address_line_2 = 3; + + // City of the business address. + google.protobuf.StringValue city = 4; + + // Province of the business address. + google.protobuf.StringValue province = 5; + + // Postal code of the business address. + google.protobuf.StringValue postal_code = 6; + + // Country code of the business address. + google.protobuf.StringValue country_code = 7; + + // Phone number of the business. + google.protobuf.StringValue phone_number = 8; +} + +// Represents an affiliate location extension. +message AffiliateLocationFeedItem { + // The name of the business. + google.protobuf.StringValue business_name = 1; + + // Line 1 of the business address. + google.protobuf.StringValue address_line_1 = 2; + + // Line 2 of the business address. + google.protobuf.StringValue address_line_2 = 3; + + // City of the business address. + google.protobuf.StringValue city = 4; + + // Province of the business address. + google.protobuf.StringValue province = 5; + + // Postal code of the business address. + google.protobuf.StringValue postal_code = 6; + + // Country code of the business address. + google.protobuf.StringValue country_code = 7; + + // Phone number of the business. + google.protobuf.StringValue phone_number = 8; + + // Id of the retail chain that is advertised as a seller of your product. + google.protobuf.Int64Value chain_id = 9; + + // Name of chain. + google.protobuf.StringValue chain_name = 10; +} + +// An extension that users can click on to send a text message to the +// advertiser. +message TextMessageFeedItem { + // The business name to prepend to the message text. + // This field is required. + google.protobuf.StringValue business_name = 1; + + // Uppercase two-letter country code of the advertiser's phone number. + // This field is required. + google.protobuf.StringValue country_code = 2; + + // The advertiser's phone number the message will be sent to. Required. + google.protobuf.StringValue phone_number = 3; + + // The text to show in the ad. + // This field is required. + google.protobuf.StringValue text = 4; + + // The message text populated in the messaging app. + google.protobuf.StringValue extension_text = 5; +} + +// Represents a Price extension. +message PriceFeedItem { + // Price extension type of this extension. + google.ads.googleads.v3.enums.PriceExtensionTypeEnum.PriceExtensionType type = 1; + + // Price qualifier for all offers of this price extension. + google.ads.googleads.v3.enums.PriceExtensionPriceQualifierEnum.PriceExtensionPriceQualifier price_qualifier = 2; + + // Tracking URL template for all offers of this price extension. + google.protobuf.StringValue tracking_url_template = 3; + + // The code of the language used for this price extension. + google.protobuf.StringValue language_code = 4; + + // The price offerings in this price extension. + repeated PriceOffer price_offerings = 5; + + // URL template for appending params to landing page URLs served with parallel + // tracking. + google.protobuf.StringValue final_url_suffix = 6; +} + +// Represents one price offer in a price extension. +message PriceOffer { + // Header text of this offer. + google.protobuf.StringValue header = 1; + + // Description text of this offer. + google.protobuf.StringValue description = 2; + + // Price value of this offer. + Money price = 3; + + // Price unit for this offer. + google.ads.googleads.v3.enums.PriceExtensionPriceUnitEnum.PriceExtensionPriceUnit unit = 4; + + // A list of possible final URLs after all cross domain redirects. + repeated google.protobuf.StringValue final_urls = 5; + + // A list of possible final mobile URLs after all cross domain redirects. + repeated google.protobuf.StringValue final_mobile_urls = 6; +} + +// Represents a Promotion extension. +message PromotionFeedItem { + // A freeform description of what the promotion is targeting. + // This field is required. + google.protobuf.StringValue promotion_target = 1; + + // Enum that modifies the qualification of the discount. + google.ads.googleads.v3.enums.PromotionExtensionDiscountModifierEnum.PromotionExtensionDiscountModifier discount_modifier = 2; + + // Start date of when the promotion is eligible to be redeemed. + google.protobuf.StringValue promotion_start_date = 7; + + // End date of when the promotion is eligible to be redeemed. + google.protobuf.StringValue promotion_end_date = 8; + + // The occasion the promotion was intended for. + // If an occasion is set, the redemption window will need to fall within + // the date range associated with the occasion. + google.ads.googleads.v3.enums.PromotionExtensionOccasionEnum.PromotionExtensionOccasion occasion = 9; + + // A list of possible final URLs after all cross domain redirects. + // This field is required. + repeated google.protobuf.StringValue final_urls = 10; + + // A list of possible final mobile URLs after all cross domain redirects. + repeated google.protobuf.StringValue final_mobile_urls = 11; + + // URL template for constructing a tracking URL. + google.protobuf.StringValue tracking_url_template = 12; + + // A list of mappings to be used for substituting URL custom parameter tags in + // the tracking_url_template, final_urls, and/or final_mobile_urls. + repeated CustomParameter url_custom_parameters = 13; + + // URL template for appending params to landing page URLs served with parallel + // tracking. + google.protobuf.StringValue final_url_suffix = 14; + + // The language of the promotion. + // Represented as BCP 47 language tag. + google.protobuf.StringValue language_code = 15; + + // Discount type, can be percentage off or amount off. + oneof discount_type { + // Percentage off discount in the promotion in micros. + // One million is equivalent to one percent. + // Either this or money_off_amount is required. + google.protobuf.Int64Value percent_off = 3; + + // Money amount off for discount in the promotion. + // Either this or percent_off is required. + Money money_amount_off = 4; + } + + // Promotion trigger. Can be by promotion code or promo by eligible order + // amount. + oneof promotion_trigger { + // A code the user should use in order to be eligible for the promotion. + google.protobuf.StringValue promotion_code = 5; + + // The amount the total order needs to be for the user to be eligible for + // the promotion. + Money orders_over_amount = 6; + } +} + +// Represents a structured snippet extension. +message StructuredSnippetFeedItem { + // The header of the snippet. + // This string must not be empty. + google.protobuf.StringValue header = 1; + + // The values in the snippet. + // The maximum size of this collection is 10. + repeated google.protobuf.StringValue values = 2; +} + +// Represents a sitelink extension. +message SitelinkFeedItem { + // URL display text for the sitelink. + // The length of this string should be between 1 and 25, inclusive. + google.protobuf.StringValue link_text = 1; + + // First line of the description for the sitelink. + // If this value is set, line2 must also be set. + // The length of this string should be between 0 and 35, inclusive. + google.protobuf.StringValue line1 = 2; + + // Second line of the description for the sitelink. + // If this value is set, line1 must also be set. + // The length of this string should be between 0 and 35, inclusive. + google.protobuf.StringValue line2 = 3; + + // A list of possible final URLs after all cross domain redirects. + repeated google.protobuf.StringValue final_urls = 4; + + // A list of possible final mobile URLs after all cross domain redirects. + repeated google.protobuf.StringValue final_mobile_urls = 5; + + // URL template for constructing a tracking URL. + google.protobuf.StringValue tracking_url_template = 6; + + // A list of mappings to be used for substituting URL custom parameter tags in + // the tracking_url_template, final_urls, and/or final_mobile_urls. + repeated CustomParameter url_custom_parameters = 7; + + // Final URL suffix to be appended to landing page URLs served with + // parallel tracking. + google.protobuf.StringValue final_url_suffix = 8; +} + +// Represents a hotel callout extension. +message HotelCalloutFeedItem { + // The callout text. + // The length of this string should be between 1 and 25, inclusive. + google.protobuf.StringValue text = 1; + + // The language of the hotel callout text. + // IETF BCP 47 compliant language code. + google.protobuf.StringValue language_code = 2; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/feed_common.proto b/third_party/googleapis/google/ads/googleads/v3/common/feed_common.proto new file mode 100644 index 000000000..d41803a2a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/feed_common.proto @@ -0,0 +1,40 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "FeedCommonProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file describing common feed proto messages. + +// Represents a price in a particular currency. +message Money { + // Three-character ISO 4217 currency code. + google.protobuf.StringValue currency_code = 1; + + // Amount in micros. One million is equivalent to one unit. + google.protobuf.Int64Value amount_micros = 2; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/final_app_url.proto b/third_party/googleapis/google/ads/googleads/v3/common/final_app_url.proto new file mode 100644 index 000000000..1b362dd5e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/final_app_url.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/ads/googleads/v3/enums/app_url_operating_system_type.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "FinalAppUrlProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file FinalAppUrl type. + +// A URL for deep linking into an app for the given operating system. +message FinalAppUrl { + // The operating system targeted by this URL. Required. + google.ads.googleads.v3.enums.AppUrlOperatingSystemTypeEnum.AppUrlOperatingSystemType os_type = 1; + + // The app deep link URL. Deep links specify a location in an app that + // corresponds to the content you'd like to show, and should be of the form + // {scheme}://{host_path} + // The scheme identifies which app to open. For your app, you can use a custom + // scheme that starts with the app's name. The host and path specify the + // unique location in the app where your content exists. + // Example: "exampleapp://productid_1234". Required. + google.protobuf.StringValue url = 2; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/frequency_cap.proto b/third_party/googleapis/google/ads/googleads/v3/common/frequency_cap.proto new file mode 100644 index 000000000..ee3bb8445 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/frequency_cap.proto @@ -0,0 +1,62 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/ads/googleads/v3/enums/frequency_cap_event_type.proto"; +import "google/ads/googleads/v3/enums/frequency_cap_level.proto"; +import "google/ads/googleads/v3/enums/frequency_cap_time_unit.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "FrequencyCapProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file describing frequency caps. + +// A rule specifying the maximum number of times an ad (or some set of ads) can +// be shown to a user over a particular time period. +message FrequencyCapEntry { + // The key of a particular frequency cap. There can be no more + // than one frequency cap with the same key. + FrequencyCapKey key = 1; + + // Maximum number of events allowed during the time range by this cap. + google.protobuf.Int32Value cap = 2; +} + +// A group of fields used as keys for a frequency cap. +// There can be no more than one frequency cap with the same key. +message FrequencyCapKey { + // The level on which the cap is to be applied (e.g. ad group ad, ad group). + // The cap is applied to all the entities of this level. + google.ads.googleads.v3.enums.FrequencyCapLevelEnum.FrequencyCapLevel level = 1; + + // The type of event that the cap applies to (e.g. impression). + google.ads.googleads.v3.enums.FrequencyCapEventTypeEnum.FrequencyCapEventType event_type = 3; + + // Unit of time the cap is defined at (e.g. day, week). + google.ads.googleads.v3.enums.FrequencyCapTimeUnitEnum.FrequencyCapTimeUnit time_unit = 2; + + // Number of time units the cap lasts. + google.protobuf.Int32Value time_length = 4; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/keyword_plan_common.proto b/third_party/googleapis/google/ads/googleads/v3/common/keyword_plan_common.proto new file mode 100644 index 000000000..dc0ca81cb --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/keyword_plan_common.proto @@ -0,0 +1,45 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/ads/googleads/v3/enums/keyword_plan_competition_level.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "KeywordPlanCommonProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file describing Keyword Planner messages. + +// Historical metrics specific to the targeting options selected. +// Targeting options include geographies, network, etc. +// Refer to https://support.google.com/google-ads/answer/3022575 for more +// details. +message KeywordPlanHistoricalMetrics { + // Approximate number of monthly searches on this query averaged + // for the past 12 months. + google.protobuf.Int64Value avg_monthly_searches = 1; + + // The competition level for the query. + google.ads.googleads.v3.enums.KeywordPlanCompetitionLevelEnum.KeywordPlanCompetitionLevel competition = 2; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/matching_function.proto b/third_party/googleapis/google/ads/googleads/v3/common/matching_function.proto new file mode 100644 index 000000000..ab3b5165b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/matching_function.proto @@ -0,0 +1,127 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/ads/googleads/v3/enums/matching_function_context_type.proto"; +import "google/ads/googleads/v3/enums/matching_function_operator.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "MatchingFunctionProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file describing a matching function. + +// Matching function associated with a +// CustomerFeed, CampaignFeed, or AdGroupFeed. The matching function is used +// to filter the set of feed items selected. +message MatchingFunction { + // String representation of the Function. + // + // Examples: + // + // 1. IDENTITY(true) or IDENTITY(false). All or no feed items served. + // 2. EQUALS(CONTEXT.DEVICE,"Mobile") + // 3. IN(FEED_ITEM_ID,{1000001,1000002,1000003}) + // 4. CONTAINS_ANY(FeedAttribute[12345678,0],{"Mars cruise","Venus cruise"}) + // 5. AND(IN(FEED_ITEM_ID,{10001,10002}),EQUALS(CONTEXT.DEVICE,"Mobile")) + // + // For more details, visit + // https://developers.google.com/adwords/api/docs/guides/feed-matching-functions + // + // Note that because multiple strings may represent the same underlying + // function (whitespace and single versus double quotation marks, for + // example), the value returned may not be identical to the string sent in a + // mutate request. + google.protobuf.StringValue function_string = 1; + + // Operator for a function. + google.ads.googleads.v3.enums.MatchingFunctionOperatorEnum.MatchingFunctionOperator operator = 4; + + // The operands on the left hand side of the equation. This is also the + // operand to be used for single operand expressions such as NOT. + repeated Operand left_operands = 2; + + // The operands on the right hand side of the equation. + repeated Operand right_operands = 3; +} + +// An operand in a matching function. +message Operand { + // A constant operand in a matching function. + message ConstantOperand { + // Constant operand values. Required. + oneof constant_operand_value { + // String value of the operand if it is a string type. + google.protobuf.StringValue string_value = 1; + + // Int64 value of the operand if it is a int64 type. + google.protobuf.Int64Value long_value = 2; + + // Boolean value of the operand if it is a boolean type. + google.protobuf.BoolValue boolean_value = 3; + + // Double value of the operand if it is a double type. + google.protobuf.DoubleValue double_value = 4; + } + } + + // A feed attribute operand in a matching function. + // Used to represent a feed attribute in feed. + message FeedAttributeOperand { + // The associated feed. Required. + google.protobuf.Int64Value feed_id = 1; + + // Id of the referenced feed attribute. Required. + google.protobuf.Int64Value feed_attribute_id = 2; + } + + // A function operand in a matching function. + // Used to represent nested functions. + message FunctionOperand { + // The matching function held in this operand. + MatchingFunction matching_function = 1; + } + + // An operand in a function referring to a value in the request context. + message RequestContextOperand { + // Type of value to be referred in the request context. + google.ads.googleads.v3.enums.MatchingFunctionContextTypeEnum.MatchingFunctionContextType context_type = 1; + } + + // Different operands that can be used in a matching function. Required. + oneof function_argument_operand { + // A constant operand in a matching function. + ConstantOperand constant_operand = 1; + + // This operand specifies a feed attribute in feed. + FeedAttributeOperand feed_attribute_operand = 2; + + // A function operand in a matching function. + // Used to represent nested functions. + FunctionOperand function_operand = 3; + + // An operand in a function referring to a value in the request context. + RequestContextOperand request_context_operand = 4; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/metrics.proto b/third_party/googleapis/google/ads/googleads/v3/common/metrics.proto new file mode 100644 index 000000000..248f6cdd4 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/metrics.proto @@ -0,0 +1,533 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/ads/googleads/v3/enums/interaction_event_type.proto"; +import "google/ads/googleads/v3/enums/quality_score_bucket.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "MetricsProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file describing metrics. + +// Metrics data. +message Metrics { + // The percent of your ad impressions that are shown as the very first ad + // above the organic search results. + google.protobuf.DoubleValue absolute_top_impression_percentage = 95; + + // Average cost of viewable impressions (`active_view_impressions`). + google.protobuf.DoubleValue active_view_cpm = 1; + + // Active view measurable clicks divided by active view viewable impressions. + // This metric is reported only for display network. + google.protobuf.DoubleValue active_view_ctr = 79; + + // A measurement of how often your ad has become viewable on a Display + // Network site. + google.protobuf.Int64Value active_view_impressions = 2; + + // The ratio of impressions that could be measured by Active View over the + // number of served impressions. + google.protobuf.DoubleValue active_view_measurability = 96; + + // The cost of the impressions you received that were measurable by Active + // View. + google.protobuf.Int64Value active_view_measurable_cost_micros = 3; + + // The number of times your ads are appearing on placements in positions + // where they can be seen. + google.protobuf.Int64Value active_view_measurable_impressions = 4; + + // The percentage of time when your ad appeared on an Active View enabled site + // (measurable impressions) and was viewable (viewable impressions). + google.protobuf.DoubleValue active_view_viewability = 97; + + // All conversions from interactions (as oppose to view through conversions) + // divided by the number of ad interactions. + google.protobuf.DoubleValue all_conversions_from_interactions_rate = 65; + + // The total value of all conversions. + google.protobuf.DoubleValue all_conversions_value = 66; + + // The total number of conversions. This only includes conversion actions + // which include_in_conversions_metric attribute is set to true. + google.protobuf.DoubleValue all_conversions = 7; + + // The value of all conversions divided by the total cost of ad interactions + // (such as clicks for text ads or views for video ads). + google.protobuf.DoubleValue all_conversions_value_per_cost = 62; + + // The number of times people clicked the "Call" button to call a store during + // or after clicking an ad. This number doesn't include whether or not calls + // were connected, or the duration of any calls. + // This metric applies to feed items only. + google.protobuf.DoubleValue all_conversions_from_click_to_call = 118; + + // The number of times people clicked a "Get directions" button to navigate to + // a store after clicking an ad. + // This metric applies to feed items only. + google.protobuf.DoubleValue all_conversions_from_directions = 119; + + // The value of all conversions from interactions divided by the total number + // of interactions. + google.protobuf.DoubleValue all_conversions_from_interactions_value_per_interaction = 67; + + // The number of times people clicked a link to view a store's menu after + // clicking an ad. + // This metric applies to feed items only. + google.protobuf.DoubleValue all_conversions_from_menu = 120; + + // The number of times people placed an order at a store after clicking an ad. + // This metric applies to feed items only. + google.protobuf.DoubleValue all_conversions_from_order = 121; + + // The number of other conversions (for example, posting a review or saving a + // location for a store) that occurred after people clicked an ad. + // This metric applies to feed items only. + google.protobuf.DoubleValue all_conversions_from_other_engagement = 122; + + // Estimated number of times people visited a store after clicking an ad. + // This metric applies to feed items only. + google.protobuf.DoubleValue all_conversions_from_store_visit = 123; + + // The number of times that people were taken to a store's URL after clicking + // an ad. + // This metric applies to feed items only. + google.protobuf.DoubleValue all_conversions_from_store_website = 124; + + // The average amount you pay per interaction. This amount is the total cost + // of your ads divided by the total number of interactions. + google.protobuf.DoubleValue average_cost = 8; + + // The total cost of all clicks divided by the total number of clicks + // received. + google.protobuf.DoubleValue average_cpc = 9; + + // The average amount that you've been charged for an ad engagement. This + // amount is the total cost of all ad engagements divided by the total number + // of ad engagements. + google.protobuf.DoubleValue average_cpe = 98; + + // Average cost-per-thousand impressions (CPM). + google.protobuf.DoubleValue average_cpm = 10; + + // The average amount you pay each time someone views your ad. + // The average CPV is defined by the total cost of all ad views divided by + // the number of views. + google.protobuf.DoubleValue average_cpv = 11; + + // Average number of pages viewed per session. + google.protobuf.DoubleValue average_page_views = 99; + + // Total duration of all sessions (in seconds) / number of sessions. Imported + // from Google Analytics. + google.protobuf.DoubleValue average_time_on_site = 84; + + // An indication of how other advertisers are bidding on similar products. + google.protobuf.DoubleValue benchmark_average_max_cpc = 14; + + // An indication on how other advertisers' Shopping ads for similar products + // are performing based on how often people who see their ad click on it. + google.protobuf.DoubleValue benchmark_ctr = 77; + + // Percentage of clicks where the user only visited a single page on your + // site. Imported from Google Analytics. + google.protobuf.DoubleValue bounce_rate = 15; + + // The number of clicks. + google.protobuf.Int64Value clicks = 19; + + // The number of times your ad or your site's listing in the unpaid + // results was clicked. See the help page at + // https://support.google.com/google-ads/answer/3097241 for details. + google.protobuf.Int64Value combined_clicks = 115; + + // The number of times your ad or your site's listing in the unpaid + // results was clicked (combined_clicks) divided by combined_queries. See the + // help page at https://support.google.com/google-ads/answer/3097241 for + // details. + google.protobuf.DoubleValue combined_clicks_per_query = 116; + + // The number of searches that returned pages from your site in the unpaid + // results or showed one of your text ads. See the help page at + // https://support.google.com/google-ads/answer/3097241 for details. + google.protobuf.Int64Value combined_queries = 117; + + // The estimated percent of times that your ad was eligible to show + // on the Display Network but didn't because your budget was too low. + // Note: Content budget lost impression share is reported in the range of 0 + // to 0.9. Any value above 0.9 is reported as 0.9001. + google.protobuf.DoubleValue content_budget_lost_impression_share = 20; + + // The impressions you've received on the Display Network divided + // by the estimated number of impressions you were eligible to receive. + // Note: Content impression share is reported in the range of 0.1 to 1. Any + // value below 0.1 is reported as 0.0999. + google.protobuf.DoubleValue content_impression_share = 21; + + // The last date/time a conversion tag for this conversion action successfully + // fired and was seen by Google Ads. This firing event may not have been the + // result of an attributable conversion (e.g. because the tag was fired from a + // browser that did not previously click an ad from an appropriate + // advertiser). The date/time is in the customer's time zone. + google.protobuf.StringValue conversion_last_received_request_date_time = 73; + + // The date of the most recent conversion for this conversion action. The date + // is in the customer's time zone. + google.protobuf.StringValue conversion_last_conversion_date = 74; + + // The estimated percentage of impressions on the Display Network + // that your ads didn't receive due to poor Ad Rank. + // Note: Content rank lost impression share is reported in the range of 0 + // to 0.9. Any value above 0.9 is reported as 0.9001. + google.protobuf.DoubleValue content_rank_lost_impression_share = 22; + + // Conversions from interactions divided by the number of ad interactions + // (such as clicks for text ads or views for video ads). This only includes + // conversion actions which include_in_conversions_metric attribute is set to + // true. + google.protobuf.DoubleValue conversions_from_interactions_rate = 69; + + // The total value of conversions. This only includes conversion actions which + // include_in_conversions_metric attribute is set to true. + google.protobuf.DoubleValue conversions_value = 70; + + // The value of conversions divided by the cost of ad interactions. This only + // includes conversion actions which include_in_conversions_metric attribute + // is set to true. + google.protobuf.DoubleValue conversions_value_per_cost = 71; + + // The value of conversions from interactions divided by the number of ad + // interactions. This only includes conversion actions which + // include_in_conversions_metric attribute is set to true. + google.protobuf.DoubleValue conversions_from_interactions_value_per_interaction = 72; + + // The number of conversions. This only includes conversion actions which + // include_in_conversions_metric attribute is set to true. + google.protobuf.DoubleValue conversions = 25; + + // The sum of your cost-per-click (CPC) and cost-per-thousand impressions + // (CPM) costs during this period. + google.protobuf.Int64Value cost_micros = 26; + + // The cost of ad interactions divided by all conversions. + google.protobuf.DoubleValue cost_per_all_conversions = 68; + + // The cost of ad interactions divided by conversions. This only includes + // conversion actions which include_in_conversions_metric attribute is set to + // true. + google.protobuf.DoubleValue cost_per_conversion = 28; + + // The cost of ad interactions divided by current model attributed + // conversions. This only includes conversion actions which + // include_in_conversions_metric attribute is set to true. + google.protobuf.DoubleValue cost_per_current_model_attributed_conversion = 106; + + // Conversions from when a customer clicks on a Google Ads ad on one device, + // then converts on a different device or browser. + // Cross-device conversions are already included in all_conversions. + google.protobuf.DoubleValue cross_device_conversions = 29; + + // The number of clicks your ad receives (Clicks) divided by the number + // of times your ad is shown (Impressions). + google.protobuf.DoubleValue ctr = 30; + + // Shows how your historic conversions data would look under the attribution + // model you've currently selected. This only includes conversion actions + // which include_in_conversions_metric attribute is set to true. + google.protobuf.DoubleValue current_model_attributed_conversions = 101; + + // Current model attributed conversions from interactions divided by the + // number of ad interactions (such as clicks for text ads or views for video + // ads). This only includes conversion actions which + // include_in_conversions_metric attribute is set to true. + google.protobuf.DoubleValue current_model_attributed_conversions_from_interactions_rate = 102; + + // The value of current model attributed conversions from interactions divided + // by the number of ad interactions. This only includes conversion actions + // which include_in_conversions_metric attribute is set to true. + google.protobuf.DoubleValue current_model_attributed_conversions_from_interactions_value_per_interaction = 103; + + // The total value of current model attributed conversions. This only includes + // conversion actions which include_in_conversions_metric attribute is set to + // true. + google.protobuf.DoubleValue current_model_attributed_conversions_value = 104; + + // The value of current model attributed conversions divided by the cost of ad + // interactions. This only includes conversion actions which + // include_in_conversions_metric attribute is set to true. + google.protobuf.DoubleValue current_model_attributed_conversions_value_per_cost = 105; + + // How often people engage with your ad after it's shown to them. This is the + // number of ad expansions divided by the number of times your ad is shown. + google.protobuf.DoubleValue engagement_rate = 31; + + // The number of engagements. + // An engagement occurs when a viewer expands your Lightbox ad. Also, in the + // future, other ad types may support engagement metrics. + google.protobuf.Int64Value engagements = 32; + + // Average lead value based on clicks. + google.protobuf.DoubleValue hotel_average_lead_value_micros = 75; + + // The average price difference between the price offered by reporting hotel + // advertiser and the cheapest price offered by the competing advertiser. + google.protobuf.DoubleValue hotel_price_difference_percentage = 129; + + // The creative historical quality score. + google.ads.googleads.v3.enums.QualityScoreBucketEnum.QualityScoreBucket historical_creative_quality_score = 80; + + // The quality of historical landing page experience. + google.ads.googleads.v3.enums.QualityScoreBucketEnum.QualityScoreBucket historical_landing_page_quality_score = 81; + + // The historical quality score. + google.protobuf.Int64Value historical_quality_score = 82; + + // The historical search predicted click through rate (CTR). + google.ads.googleads.v3.enums.QualityScoreBucketEnum.QualityScoreBucket historical_search_predicted_ctr = 83; + + // The number of times the ad was forwarded to someone else as a message. + google.protobuf.Int64Value gmail_forwards = 85; + + // The number of times someone has saved your Gmail ad to their inbox as a + // message. + google.protobuf.Int64Value gmail_saves = 86; + + // The number of clicks to the landing page on the expanded state of Gmail + // ads. + google.protobuf.Int64Value gmail_secondary_clicks = 87; + + // The number of times a store's location-based ad was shown. + // This metric applies to feed items only. + google.protobuf.Int64Value impressions_from_store_reach = 125; + + // Count of how often your ad has appeared on a search results page or + // website on the Google Network. + google.protobuf.Int64Value impressions = 37; + + // How often people interact with your ad after it is shown to them. + // This is the number of interactions divided by the number of times your ad + // is shown. + google.protobuf.DoubleValue interaction_rate = 38; + + // The number of interactions. + // An interaction is the main user action associated with an ad format-clicks + // for text and shopping ads, views for video ads, and so on. + google.protobuf.Int64Value interactions = 39; + + // The types of payable and free interactions. + repeated google.ads.googleads.v3.enums.InteractionEventTypeEnum.InteractionEventType interaction_event_types = 100; + + // The percentage of clicks filtered out of your total number of clicks + // (filtered + non-filtered clicks) during the reporting period. + google.protobuf.DoubleValue invalid_click_rate = 40; + + // Number of clicks Google considers illegitimate and doesn't charge you for. + google.protobuf.Int64Value invalid_clicks = 41; + + // Number of message chats initiated for Click To Message impressions that + // were message tracking eligible. + google.protobuf.Int64Value message_chats = 126; + + // Number of Click To Message impressions that were message tracking eligible. + google.protobuf.Int64Value message_impressions = 127; + + // Number of message chats initiated (message_chats) divided by the number + // of message impressions (message_impressions). + // Rate at which a user initiates a message chat from an ad impression with + // a messaging option and message tracking enabled. + // Note that this rate can be more than 1.0 for a given message impression. + google.protobuf.DoubleValue message_chat_rate = 128; + + // The percentage of mobile clicks that go to a mobile-friendly page. + google.protobuf.DoubleValue mobile_friendly_clicks_percentage = 109; + + // The number of times someone clicked your site's listing in the unpaid + // results for a particular query. See the help page at + // https://support.google.com/google-ads/answer/3097241 for details. + google.protobuf.Int64Value organic_clicks = 110; + + // The number of times someone clicked your site's listing in the unpaid + // results (organic_clicks) divided by the total number of searches that + // returned pages from your site (organic_queries). See the help page at + // https://support.google.com/google-ads/answer/3097241 for details. + google.protobuf.DoubleValue organic_clicks_per_query = 111; + + // The number of listings for your site in the unpaid search results. See the + // help page at https://support.google.com/google-ads/answer/3097241 for + // details. + google.protobuf.Int64Value organic_impressions = 112; + + // The number of times a page from your site was listed in the unpaid search + // results (organic_impressions) divided by the number of searches returning + // your site's listing in the unpaid results (organic_queries). See the help + // page at https://support.google.com/google-ads/answer/3097241 for details. + google.protobuf.DoubleValue organic_impressions_per_query = 113; + + // The total number of searches that returned your site's listing in the + // unpaid results. See the help page at + // https://support.google.com/google-ads/answer/3097241 for details. + google.protobuf.Int64Value organic_queries = 114; + + // Percentage of first-time sessions (from people who had never visited your + // site before). Imported from Google Analytics. + google.protobuf.DoubleValue percent_new_visitors = 42; + + // Number of offline phone calls. + google.protobuf.Int64Value phone_calls = 43; + + // Number of offline phone impressions. + google.protobuf.Int64Value phone_impressions = 44; + + // Number of phone calls received (phone_calls) divided by the number of + // times your phone number is shown (phone_impressions). + google.protobuf.DoubleValue phone_through_rate = 45; + + // Your clickthrough rate (Ctr) divided by the average clickthrough rate of + // all advertisers on the websites that show your ads. Measures how your ads + // perform on Display Network sites compared to other ads on the same sites. + google.protobuf.DoubleValue relative_ctr = 46; + + // The percentage of the customer's Shopping or Search ad impressions that are + // shown in the most prominent Shopping position. See + // https://support.google.com/google-ads/answer/7501826 + // for details. Any value below 0.1 is reported as 0.0999. + google.protobuf.DoubleValue search_absolute_top_impression_share = 78; + + // The number estimating how often your ad wasn't the very first ad above the + // organic search results due to a low budget. Note: Search + // budget lost absolute top impression share is reported in the range of 0 to + // 0.9. Any value above 0.9 is reported as 0.9001. + google.protobuf.DoubleValue search_budget_lost_absolute_top_impression_share = 88; + + // The estimated percent of times that your ad was eligible to show on the + // Search Network but didn't because your budget was too low. Note: Search + // budget lost impression share is reported in the range of 0 to 0.9. Any + // value above 0.9 is reported as 0.9001. + google.protobuf.DoubleValue search_budget_lost_impression_share = 47; + + // The number estimating how often your ad didn't show anywhere above the + // organic search results due to a low budget. Note: Search + // budget lost top impression share is reported in the range of 0 to 0.9. Any + // value above 0.9 is reported as 0.9001. + google.protobuf.DoubleValue search_budget_lost_top_impression_share = 89; + + // The number of clicks you've received on the Search Network + // divided by the estimated number of clicks you were eligible to receive. + // Note: Search click share is reported in the range of 0.1 to 1. Any value + // below 0.1 is reported as 0.0999. + google.protobuf.DoubleValue search_click_share = 48; + + // The impressions you've received divided by the estimated number of + // impressions you were eligible to receive on the Search Network for search + // terms that matched your keywords exactly (or were close variants of your + // keyword), regardless of your keyword match types. Note: Search exact match + // impression share is reported in the range of 0.1 to 1. Any value below 0.1 + // is reported as 0.0999. + google.protobuf.DoubleValue search_exact_match_impression_share = 49; + + // The impressions you've received on the Search Network divided + // by the estimated number of impressions you were eligible to receive. + // Note: Search impression share is reported in the range of 0.1 to 1. Any + // value below 0.1 is reported as 0.0999. + google.protobuf.DoubleValue search_impression_share = 50; + + // The number estimating how often your ad wasn't the very first ad above the + // organic search results due to poor Ad Rank. + // Note: Search rank lost absolute top impression share is reported in the + // range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. + google.protobuf.DoubleValue search_rank_lost_absolute_top_impression_share = 90; + + // The estimated percentage of impressions on the Search Network + // that your ads didn't receive due to poor Ad Rank. + // Note: Search rank lost impression share is reported in the range of 0 to + // 0.9. Any value above 0.9 is reported as 0.9001. + google.protobuf.DoubleValue search_rank_lost_impression_share = 51; + + // The number estimating how often your ad didn't show anywhere above the + // organic search results due to poor Ad Rank. + // Note: Search rank lost top impression share is reported in the range of 0 + // to 0.9. Any value above 0.9 is reported as 0.9001. + google.protobuf.DoubleValue search_rank_lost_top_impression_share = 91; + + // The impressions you've received in the top location (anywhere above the + // organic search results) compared to the estimated number of impressions you + // were eligible to receive in the top location. + // Note: Search top impression share is reported in the range of 0.1 to 1. Any + // value below 0.1 is reported as 0.0999. + google.protobuf.DoubleValue search_top_impression_share = 92; + + // A measure of how quickly your page loads after clicks on your mobile ads. + // The score is a range from 1 to 10, 10 being the fastest. + google.protobuf.Int64Value speed_score = 107; + + // The percent of your ad impressions that are shown anywhere above the + // organic search results. + google.protobuf.DoubleValue top_impression_percentage = 93; + + // The percentage of ad clicks to Accelerated Mobile Pages (AMP) landing pages + // that reach a valid AMP page. + google.protobuf.DoubleValue valid_accelerated_mobile_pages_clicks_percentage = 108; + + // The value of all conversions divided by the number of all conversions. + google.protobuf.DoubleValue value_per_all_conversions = 52; + + // The value of conversions divided by the number of conversions. This only + // includes conversion actions which include_in_conversions_metric attribute + // is set to true. + google.protobuf.DoubleValue value_per_conversion = 53; + + // The value of current model attributed conversions divided by the number of + // the conversions. This only includes conversion actions which + // include_in_conversions_metric attribute is set to true. + google.protobuf.DoubleValue value_per_current_model_attributed_conversion = 94; + + // Percentage of impressions where the viewer watched all of your video. + google.protobuf.DoubleValue video_quartile_100_rate = 54; + + // Percentage of impressions where the viewer watched 25% of your video. + google.protobuf.DoubleValue video_quartile_25_rate = 55; + + // Percentage of impressions where the viewer watched 50% of your video. + google.protobuf.DoubleValue video_quartile_50_rate = 56; + + // Percentage of impressions where the viewer watched 75% of your video. + google.protobuf.DoubleValue video_quartile_75_rate = 57; + + // The number of views your TrueView video ad receives divided by its number + // of impressions, including thumbnail impressions for TrueView in-display + // ads. + google.protobuf.DoubleValue video_view_rate = 58; + + // The number of times your video ads were viewed. + google.protobuf.Int64Value video_views = 59; + + // The total number of view-through conversions. + // These happen when a customer sees an image or rich media ad, then later + // completes a conversion on your site without interacting with (e.g., + // clicking on) another ad. + google.protobuf.Int64Value view_through_conversions = 60; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/offline_user_data.proto b/third_party/googleapis/google/ads/googleads/v3/common/offline_user_data.proto new file mode 100644 index 000000000..2f6b515b8 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/offline_user_data.proto @@ -0,0 +1,191 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "OfflineUserDataProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file describing offline user data. + +// Address identifier of offline data. +message OfflineUserAddressInfo { + // First name of the user, which is hashed as SHA-256 after normalized + // (Lowercase all characters; Remove any extra spaces before, after, and in + // between). + google.protobuf.StringValue hashed_first_name = 1; + + // Last name of the user, which is hashed as SHA-256 after normalized (lower + // case only and no punctuation). + google.protobuf.StringValue hashed_last_name = 2; + + // City of the address. Only accepted for Store Sales Direct data. + google.protobuf.StringValue city = 3; + + // State code of the address. Only accepted for Store Sales Direct data. + google.protobuf.StringValue state = 4; + + // 2-letter country code in ISO-3166-1 alpha-2 of the user's address. + google.protobuf.StringValue country_code = 5; + + // Postal code of the user's address. + google.protobuf.StringValue postal_code = 6; +} + +// Hashed user identifying information. +message UserIdentifier { + // Exactly one must be specified. + oneof identifier { + // Hashed email address using SHA-256 hash function after normalization. + google.protobuf.StringValue hashed_email = 1; + + // Hashed phone number using SHA-256 hash function after normalization + // (E164 standard). + google.protobuf.StringValue hashed_phone_number = 2; + + // Mobile device ID (advertising ID/IDFA). + google.protobuf.StringValue mobile_id = 3; + + // Advertiser-assigned user ID for Customer Match upload, or + // third-party-assigned user ID for SSD. + google.protobuf.StringValue third_party_user_id = 4; + + // Address information. + OfflineUserAddressInfo address_info = 5; + } +} + +// Attribute of the store sales transaction. +message TransactionAttribute { + // Timestamp when transaction occurred. Required. + // The format is "YYYY-MM-DD HH:MM:SS". + // Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30" + google.protobuf.StringValue transaction_date_time = 1; + + // Transaction amount in micros. Required. + google.protobuf.DoubleValue transaction_amount_micros = 2; + + // Transaction currency code. ISO 4217 three-letter code is used. Required. + google.protobuf.StringValue currency_code = 3; + + // The resource name of conversion action to report conversions to. + // Required. + google.protobuf.StringValue conversion_action = 4; + + // Transaction order id. + // Accessible to whitelisted customers only. + google.protobuf.StringValue order_id = 5; + + // Store attributes of the transaction. + // Accessible to whitelisted customers only. + StoreAttribute store_attribute = 6; + + // Value of the custom variable for each transaction. + // Accessible to whitelisted customers only. + google.protobuf.StringValue custom_value = 7; +} + +// Store attributes of the transaction. +message StoreAttribute { + // Store code from + // https://support.google.com/business/answer/3370250#storecode + google.protobuf.StringValue store_code = 1; +} + +// User data holding user identifiers and attributes. +message UserData { + // User identification info. Required. + repeated UserIdentifier user_identifiers = 1; + + // Additional transactions/attributes associated with the user. + // Required when updating store sales data. + TransactionAttribute transaction_attribute = 2; +} + +// Metadata for customer match user list. +message CustomerMatchUserListMetadata { + // The resource name of remarketing list to update data. + // Required for job of CUSTOMER_MATCH_USER_LIST type. + google.protobuf.StringValue user_list = 1; +} + +// Metadata for Store Sales Direct. +message StoreSalesMetadata { + // This is the fraction of all transactions that are identifiable (i.e., + // associated with any form of customer information). + // Required. + // The fraction needs to be between 0 and 1 (excluding 0). + google.protobuf.DoubleValue loyalty_fraction = 1; + + // This is the ratio of sales being uploaded compared to the overall sales + // that can be associated with a customer. Required. + // The fraction needs to be between 0 and 1 (excluding 0). For example, if you + // upload half the sales that you are able to associate with a customer, this + // would be 0.5. + google.protobuf.DoubleValue transaction_upload_fraction = 2; + + // Name of the store sales custom variable key. A predefined key that + // can be applied to the transaction and then later used for custom + // segementation in reporting. + // Accessible to whitelisted customers only. + google.protobuf.StringValue custom_key = 4; + + // Metadata for a third party Store Sales upload. + StoreSalesThirdPartyMetadata third_party_metadata = 3; +} + +// Metadata for a third party Store Sales. +// This is a whitelisted only product. Please contact your Google business +// development representative for details on the upload configuration. +message StoreSalesThirdPartyMetadata { + // Time the advertiser uploaded the data to the partner. Required. + // The format is "YYYY-MM-DD HH:MM:SS". + // Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30" + google.protobuf.StringValue advertiser_upload_date_time = 1; + + // The fraction of transactions that are valid. Invalid transactions may + // include invalid formats or values. + // Required. + // The fraction needs to be between 0 and 1 (excluding 0). + google.protobuf.DoubleValue valid_transaction_fraction = 2; + + // The fraction of valid transactions that are matched to a third party + // assigned user ID on the partner side. + // Required. + // The fraction needs to be between 0 and 1 (excluding 0). + google.protobuf.DoubleValue partner_match_fraction = 3; + + // The fraction of valid transactions that are uploaded by the partner to + // Google. + // Required. + // The fraction needs to be between 0 and 1 (excluding 0). + google.protobuf.DoubleValue partner_upload_fraction = 4; + + // Version of partner IDs to be used for uploads. Required. + google.protobuf.StringValue bridge_map_version_id = 5; + + // ID of the third party partner updating the transaction feed. + google.protobuf.Int64Value partner_id = 6; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/policy.proto b/third_party/googleapis/google/ads/googleads/v3/common/policy.proto new file mode 100644 index 000000000..7372bc069 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/policy.proto @@ -0,0 +1,223 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/ads/googleads/v3/enums/policy_topic_entry_type.proto"; +import "google/ads/googleads/v3/enums/policy_topic_evidence_destination_mismatch_url_type.proto"; +import "google/ads/googleads/v3/enums/policy_topic_evidence_destination_not_working_device.proto"; +import "google/ads/googleads/v3/enums/policy_topic_evidence_destination_not_working_dns_error_type.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "PolicyProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file describing policy information. + +// Key of the violation. The key is used for referring to a violation +// when filing an exemption request. +message PolicyViolationKey { + // Unique ID of the violated policy. + google.protobuf.StringValue policy_name = 1; + + // The text that violates the policy if specified. + // Otherwise, refers to the policy in general + // (e.g., when requesting to be exempt from the whole policy). + // If not specified for criterion exemptions, the whole policy is implied. + // Must be specified for ad exemptions. + google.protobuf.StringValue violating_text = 2; +} + +// Parameter for controlling how policy exemption is done. Ignorable policy +// topics are only usable with expanded text ads and responsive search ads. All +// other ad types must use policy violation keys. +message PolicyValidationParameter { + // The list of policy topics that should not cause a PolicyFindingError to + // be reported. This field is currently only compatible with Enhanced Text Ad. + // It corresponds to the PolicyTopicEntry.topic field. + // + // Resources violating these policies will be saved, but will not be eligible + // to serve. They may begin serving at a later time due to a change in + // policies, re-review of the resource, or a change in advertiser + // certificates. + repeated google.protobuf.StringValue ignorable_policy_topics = 1; + + // The list of policy violation keys that should not cause a + // PolicyViolationError to be reported. Not all policy violations are + // exemptable, please refer to the is_exemptible field in the returned + // PolicyViolationError. + // + // Resources violating these polices will be saved, but will not be eligible + // to serve. They may begin serving at a later time due to a change in + // policies, re-review of the resource, or a change in advertiser + // certificates. + repeated PolicyViolationKey exempt_policy_violation_keys = 2; +} + +// Policy finding attached to a resource (e.g. alcohol policy associated with +// a site that sells alcohol). +// +// Each PolicyTopicEntry has a topic that indicates the specific ads policy +// the entry is about and a type to indicate the effect that the entry will have +// on serving. It may optionally have one or more evidences that indicate the +// reason for the finding. It may also optionally have one or more constraints +// that provide details about how serving may be restricted. +message PolicyTopicEntry { + // Policy topic this finding refers to. For example, "ALCOHOL", + // "TRADEMARKS_IN_AD_TEXT", or "DESTINATION_NOT_WORKING". The set of possible + // policy topics is not fixed for a particular API version and may change + // at any time. + google.protobuf.StringValue topic = 1; + + // Describes the negative or positive effect this policy will have on serving. + google.ads.googleads.v3.enums.PolicyTopicEntryTypeEnum.PolicyTopicEntryType type = 2; + + // Additional information that explains policy finding + // (e.g. the brand name for a trademark finding). + repeated PolicyTopicEvidence evidences = 3; + + // Indicates how serving of this resource may be affected (e.g. not serving + // in a country). + repeated PolicyTopicConstraint constraints = 4; +} + +// Additional information that explains a policy finding. +message PolicyTopicEvidence { + // A list of fragments of text that violated a policy. + message TextList { + // The fragments of text from the resource that caused the policy finding. + repeated google.protobuf.StringValue texts = 1; + } + + // A list of websites that caused a policy finding. Used for + // ONE_WEBSITE_PER_AD_GROUP policy topic, for example. In case there are more + // than five websites, only the top five (those that appear in resources the + // most) will be listed here. + message WebsiteList { + // Websites that caused the policy finding. + repeated google.protobuf.StringValue websites = 1; + } + + // A list of strings found in a destination page that caused a policy + // finding. + message DestinationTextList { + // List of text found in the resource's destination page. + repeated google.protobuf.StringValue destination_texts = 1; + } + + // Evidence of mismatches between the URLs of a resource. + message DestinationMismatch { + // The set of URLs that did not match each other. + repeated google.ads.googleads.v3.enums.PolicyTopicEvidenceDestinationMismatchUrlTypeEnum.PolicyTopicEvidenceDestinationMismatchUrlType url_types = 1; + } + + // Evidence details when the destination is returning an HTTP error + // code or isn't functional in all locations for commonly used devices. + message DestinationNotWorking { + // The full URL that didn't work. + google.protobuf.StringValue expanded_url = 3; + + // The type of device that failed to load the URL. + google.ads.googleads.v3.enums.PolicyTopicEvidenceDestinationNotWorkingDeviceEnum.PolicyTopicEvidenceDestinationNotWorkingDevice device = 4; + + // The time the URL was last checked. + // The format is "YYYY-MM-DD HH:MM:SS". + // Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30" + google.protobuf.StringValue last_checked_date_time = 5; + + // Indicates the reason of the DESTINATION_NOT_WORKING policy finding. + oneof reason { + // The type of DNS error. + google.ads.googleads.v3.enums.PolicyTopicEvidenceDestinationNotWorkingDnsErrorTypeEnum.PolicyTopicEvidenceDestinationNotWorkingDnsErrorType dns_error_type = 1; + + // The HTTP error code. + google.protobuf.Int64Value http_error_code = 2; + } + } + + // Specific evidence information depending on the evidence type. + oneof value { + // List of websites linked with this resource. + WebsiteList website_list = 3; + + // List of evidence found in the text of a resource. + TextList text_list = 4; + + // The language the resource was detected to be written in. + // This is an IETF language tag such as "en-US". + google.protobuf.StringValue language_code = 5; + + // The text in the destination of the resource that is causing a policy + // finding. + DestinationTextList destination_text_list = 6; + + // Mismatch between the destinations of a resource's URLs. + DestinationMismatch destination_mismatch = 7; + + // Details when the destination is returning an HTTP error code or isn't + // functional in all locations for commonly used devices. + DestinationNotWorking destination_not_working = 8; + } +} + +// Describes the effect on serving that a policy topic entry will have. +message PolicyTopicConstraint { + // A list of countries where a resource's serving is constrained. + message CountryConstraintList { + // Total number of countries targeted by the resource. + google.protobuf.Int32Value total_targeted_countries = 1; + + // Countries in which serving is restricted. + repeated CountryConstraint countries = 2; + } + + // Indicates that a policy topic was constrained due to disapproval of the + // website for reseller purposes. + message ResellerConstraint { + + } + + // Indicates that a resource's ability to serve in a particular country is + // constrained. + message CountryConstraint { + // Geo target constant resource name of the country in which serving is + // constrained. + google.protobuf.StringValue country_criterion = 1; + } + + // Specific information about the constraint. + oneof value { + // Countries where the resource cannot serve. + CountryConstraintList country_constraint_list = 1; + + // Reseller constraint. + ResellerConstraint reseller_constraint = 2; + + // Countries where a certificate is required for serving. + CountryConstraintList certificate_missing_in_country_list = 3; + + // Countries where the resource's domain is not covered by the + // certificates associated with it. + CountryConstraintList certificate_domain_mismatch_in_country_list = 4; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/real_time_bidding_setting.proto b/third_party/googleapis/google/ads/googleads/v3/common/real_time_bidding_setting.proto new file mode 100644 index 000000000..5f62fc0ab --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/real_time_bidding_setting.proto @@ -0,0 +1,38 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "RealTimeBiddingSettingProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file describing RealTimeBiddingSetting + +// Settings for Real-Time Bidding, a feature only available for campaigns +// targeting the Ad Exchange network. +message RealTimeBiddingSetting { + // Whether the campaign is opted in to real-time bidding. + google.protobuf.BoolValue opt_in = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/segments.proto b/third_party/googleapis/google/ads/googleads/v3/common/segments.proto new file mode 100644 index 000000000..40869fb3d --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/segments.proto @@ -0,0 +1,313 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/ads/googleads/v3/common/criteria.proto"; +import "google/ads/googleads/v3/enums/ad_network_type.proto"; +import "google/ads/googleads/v3/enums/click_type.proto"; +import "google/ads/googleads/v3/enums/conversion_action_category.proto"; +import "google/ads/googleads/v3/enums/conversion_attribution_event_type.proto"; +import "google/ads/googleads/v3/enums/conversion_lag_bucket.proto"; +import "google/ads/googleads/v3/enums/conversion_or_adjustment_lag_bucket.proto"; +import "google/ads/googleads/v3/enums/day_of_week.proto"; +import "google/ads/googleads/v3/enums/device.proto"; +import "google/ads/googleads/v3/enums/external_conversion_source.proto"; +import "google/ads/googleads/v3/enums/hotel_date_selection_type.proto"; +import "google/ads/googleads/v3/enums/hotel_price_bucket.proto"; +import "google/ads/googleads/v3/enums/hotel_rate_type.proto"; +import "google/ads/googleads/v3/enums/month_of_year.proto"; +import "google/ads/googleads/v3/enums/placeholder_type.proto"; +import "google/ads/googleads/v3/enums/product_channel.proto"; +import "google/ads/googleads/v3/enums/product_channel_exclusivity.proto"; +import "google/ads/googleads/v3/enums/product_condition.proto"; +import "google/ads/googleads/v3/enums/search_engine_results_page_type.proto"; +import "google/ads/googleads/v3/enums/search_term_match_type.proto"; +import "google/ads/googleads/v3/enums/slot.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "SegmentsProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file describing segment only fields. + +// Segment only fields. +message Segments { + // Ad network type. + google.ads.googleads.v3.enums.AdNetworkTypeEnum.AdNetworkType ad_network_type = 3; + + // Click type. + google.ads.googleads.v3.enums.ClickTypeEnum.ClickType click_type = 26; + + // Resource name of the conversion action. + google.protobuf.StringValue conversion_action = 52; + + // Conversion action category. + google.ads.googleads.v3.enums.ConversionActionCategoryEnum.ConversionActionCategory conversion_action_category = 53; + + // Conversion action name. + google.protobuf.StringValue conversion_action_name = 54; + + // This segments your conversion columns by the original conversion and + // conversion value vs. the delta if conversions were adjusted. False row has + // the data as originally stated; While true row has the delta between data + // now and the data as originally stated. Summing the two together results + // post-adjustment data. + google.protobuf.BoolValue conversion_adjustment = 27; + + // Conversion attribution event type. + google.ads.googleads.v3.enums.ConversionAttributionEventTypeEnum.ConversionAttributionEventType conversion_attribution_event_type = 2; + + // An enum value representing the number of days between the impression and + // the conversion. + google.ads.googleads.v3.enums.ConversionLagBucketEnum.ConversionLagBucket conversion_lag_bucket = 50; + + // An enum value representing the number of days between the impression and + // the conversion or between the impression and adjustments to the conversion. + google.ads.googleads.v3.enums.ConversionOrAdjustmentLagBucketEnum.ConversionOrAdjustmentLagBucket conversion_or_adjustment_lag_bucket = 51; + + // Date to which metrics apply. + // yyyy-MM-dd format, e.g., 2018-04-17. + google.protobuf.StringValue date = 4; + + // Day of the week, e.g., MONDAY. + google.ads.googleads.v3.enums.DayOfWeekEnum.DayOfWeek day_of_week = 5; + + // Device to which metrics apply. + google.ads.googleads.v3.enums.DeviceEnum.Device device = 1; + + // External conversion source. + google.ads.googleads.v3.enums.ExternalConversionSourceEnum.ExternalConversionSource external_conversion_source = 55; + + // Resource name of the geo target constant that represents an airport. + google.protobuf.StringValue geo_target_airport = 65; + + // Resource name of the geo target constant that represents a canton. + google.protobuf.StringValue geo_target_canton = 76; + + // Resource name of the geo target constant that represents a city. + google.protobuf.StringValue geo_target_city = 62; + + // Resource name of the geo target constant that represents a country. + google.protobuf.StringValue geo_target_country = 77; + + // Resource name of the geo target constant that represents a county. + google.protobuf.StringValue geo_target_county = 68; + + // Resource name of the geo target constant that represents a district. + google.protobuf.StringValue geo_target_district = 69; + + // Resource name of the geo target constant that represents a metro. + google.protobuf.StringValue geo_target_metro = 63; + + // Resource name of the geo target constant that represents the most + // specific location. + google.protobuf.StringValue geo_target_most_specific_location = 72; + + // Resource name of the geo target constant that represents a postal code. + google.protobuf.StringValue geo_target_postal_code = 71; + + // Resource name of the geo target constant that represents a province. + google.protobuf.StringValue geo_target_province = 75; + + // Resource name of the geo target constant that represents a region. + google.protobuf.StringValue geo_target_region = 64; + + // Resource name of the geo target constant that represents a state. + google.protobuf.StringValue geo_target_state = 67; + + // Hotel booking window in days. + google.protobuf.Int64Value hotel_booking_window_days = 6; + + // Hotel center ID. + google.protobuf.Int64Value hotel_center_id = 7; + + // Hotel check-in date. Formatted as yyyy-MM-dd. + google.protobuf.StringValue hotel_check_in_date = 8; + + // Hotel check-in day of week. + google.ads.googleads.v3.enums.DayOfWeekEnum.DayOfWeek hotel_check_in_day_of_week = 9; + + // Hotel city. + google.protobuf.StringValue hotel_city = 10; + + // Hotel class. + google.protobuf.Int32Value hotel_class = 11; + + // Hotel country. + google.protobuf.StringValue hotel_country = 12; + + // Hotel date selection type. + google.ads.googleads.v3.enums.HotelDateSelectionTypeEnum.HotelDateSelectionType hotel_date_selection_type = 13; + + // Hotel length of stay. + google.protobuf.Int32Value hotel_length_of_stay = 14; + + // Hotel rate rule ID. + google.protobuf.StringValue hotel_rate_rule_id = 73; + + // Hotel rate type. + google.ads.googleads.v3.enums.HotelRateTypeEnum.HotelRateType hotel_rate_type = 74; + + // Hotel price bucket. + google.ads.googleads.v3.enums.HotelPriceBucketEnum.HotelPriceBucket hotel_price_bucket = 78; + + // Hotel state. + google.protobuf.StringValue hotel_state = 15; + + // Hour of day as a number between 0 and 23, inclusive. + google.protobuf.Int32Value hour = 16; + + // Only used with feed item metrics. + // Indicates whether the interaction metrics occurred on the feed item itself + // or a different extension or ad unit. + google.protobuf.BoolValue interaction_on_this_extension = 49; + + // Keyword criterion. + Keyword keyword = 61; + + // Month as represented by the date of the first day of a month. Formatted as + // yyyy-MM-dd. + google.protobuf.StringValue month = 17; + + // Month of the year, e.g., January. + google.ads.googleads.v3.enums.MonthOfYearEnum.MonthOfYear month_of_year = 18; + + // Partner hotel ID. + google.protobuf.StringValue partner_hotel_id = 19; + + // Placeholder type. This is only used with feed item metrics. + google.ads.googleads.v3.enums.PlaceholderTypeEnum.PlaceholderType placeholder_type = 20; + + // Aggregator ID of the product. + google.protobuf.UInt64Value product_aggregator_id = 28; + + // Bidding category (level 1) of the product. + google.protobuf.StringValue product_bidding_category_level1 = 56; + + // Bidding category (level 2) of the product. + google.protobuf.StringValue product_bidding_category_level2 = 57; + + // Bidding category (level 3) of the product. + google.protobuf.StringValue product_bidding_category_level3 = 58; + + // Bidding category (level 4) of the product. + google.protobuf.StringValue product_bidding_category_level4 = 59; + + // Bidding category (level 5) of the product. + google.protobuf.StringValue product_bidding_category_level5 = 60; + + // Brand of the product. + google.protobuf.StringValue product_brand = 29; + + // Channel of the product. + google.ads.googleads.v3.enums.ProductChannelEnum.ProductChannel product_channel = 30; + + // Channel exclusivity of the product. + google.ads.googleads.v3.enums.ProductChannelExclusivityEnum.ProductChannelExclusivity product_channel_exclusivity = 31; + + // Condition of the product. + google.ads.googleads.v3.enums.ProductConditionEnum.ProductCondition product_condition = 32; + + // Resource name of the geo target constant for the country of sale of the + // product. + google.protobuf.StringValue product_country = 33; + + // Custom attribute 0 of the product. + google.protobuf.StringValue product_custom_attribute0 = 34; + + // Custom attribute 1 of the product. + google.protobuf.StringValue product_custom_attribute1 = 35; + + // Custom attribute 2 of the product. + google.protobuf.StringValue product_custom_attribute2 = 36; + + // Custom attribute 3 of the product. + google.protobuf.StringValue product_custom_attribute3 = 37; + + // Custom attribute 4 of the product. + google.protobuf.StringValue product_custom_attribute4 = 38; + + // Item ID of the product. + google.protobuf.StringValue product_item_id = 39; + + // Resource name of the language constant for the language of the product. + google.protobuf.StringValue product_language = 40; + + // Merchant ID of the product. + google.protobuf.UInt64Value product_merchant_id = 41; + + // Store ID of the product. + google.protobuf.StringValue product_store_id = 42; + + // Title of the product. + google.protobuf.StringValue product_title = 43; + + // Type (level 1) of the product. + google.protobuf.StringValue product_type_l1 = 44; + + // Type (level 2) of the product. + google.protobuf.StringValue product_type_l2 = 45; + + // Type (level 3) of the product. + google.protobuf.StringValue product_type_l3 = 46; + + // Type (level 4) of the product. + google.protobuf.StringValue product_type_l4 = 47; + + // Type (level 5) of the product. + google.protobuf.StringValue product_type_l5 = 48; + + // Quarter as represented by the date of the first day of a quarter. + // Uses the calendar year for quarters, e.g., the second quarter of 2018 + // starts on 2018-04-01. Formatted as yyyy-MM-dd. + google.protobuf.StringValue quarter = 21; + + // Type of the search engine results page. + google.ads.googleads.v3.enums.SearchEngineResultsPageTypeEnum.SearchEngineResultsPageType search_engine_results_page_type = 70; + + // Match type of the keyword that triggered the ad, including variants. + google.ads.googleads.v3.enums.SearchTermMatchTypeEnum.SearchTermMatchType search_term_match_type = 22; + + // Position of the ad. + google.ads.googleads.v3.enums.SlotEnum.Slot slot = 23; + + // Resource name of the ad group criterion that represents webpage criterion. + google.protobuf.StringValue webpage = 66; + + // Week as defined as Monday through Sunday, and represented by the date of + // Monday. Formatted as yyyy-MM-dd. + google.protobuf.StringValue week = 24; + + // Year, formatted as yyyy. + google.protobuf.Int32Value year = 25; +} + +// A Keyword criterion segment. +message Keyword { + // The AdGroupCriterion resource name. + google.protobuf.StringValue ad_group_criterion = 1; + + // Keyword info. + KeywordInfo info = 2; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/simulation.proto b/third_party/googleapis/google/ads/googleads/v3/common/simulation.proto new file mode 100644 index 000000000..4987e6aa5 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/simulation.proto @@ -0,0 +1,172 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "SimulationProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file describing simulation points. + +// A container for simulation points for simulations of type BID_MODIFIER. +message BidModifierSimulationPointList { + // Projected metrics for a series of bid modifier amounts. + repeated BidModifierSimulationPoint points = 1; +} + +// A container for simulation points for simulations of type CPC_BID. +message CpcBidSimulationPointList { + // Projected metrics for a series of CPC bid amounts. + repeated CpcBidSimulationPoint points = 1; +} + +// A container for simulation points for simulations of type CPV_BID. +message CpvBidSimulationPointList { + // Projected metrics for a series of CPV bid amounts. + repeated CpvBidSimulationPoint points = 1; +} + +// A container for simulation points for simulations of type TARGET_CPA. +message TargetCpaSimulationPointList { + // Projected metrics for a series of target CPA amounts. + repeated TargetCpaSimulationPoint points = 1; +} + +// Projected metrics for a specific bid modifier amount. +message BidModifierSimulationPoint { + // The simulated bid modifier upon which projected metrics are based. + google.protobuf.DoubleValue bid_modifier = 1; + + // Projected number of biddable conversions. + // Only search advertising channel type supports this field. + google.protobuf.DoubleValue biddable_conversions = 2; + + // Projected total value of biddable conversions. + // Only search advertising channel type supports this field. + google.protobuf.DoubleValue biddable_conversions_value = 3; + + // Projected number of clicks. + google.protobuf.Int64Value clicks = 4; + + // Projected cost in micros. + google.protobuf.Int64Value cost_micros = 5; + + // Projected number of impressions. + google.protobuf.Int64Value impressions = 6; + + // Projected number of top slot impressions. + // Only search advertising channel type supports this field. + google.protobuf.Int64Value top_slot_impressions = 7; + + // Projected number of biddable conversions for the parent resource. + // Only search advertising channel type supports this field. + google.protobuf.DoubleValue parent_biddable_conversions = 8; + + // Projected total value of biddable conversions for the parent resource. + // Only search advertising channel type supports this field. + google.protobuf.DoubleValue parent_biddable_conversions_value = 9; + + // Projected number of clicks for the parent resource. + google.protobuf.Int64Value parent_clicks = 10; + + // Projected cost in micros for the parent resource. + google.protobuf.Int64Value parent_cost_micros = 11; + + // Projected number of impressions for the parent resource. + google.protobuf.Int64Value parent_impressions = 12; + + // Projected number of top slot impressions for the parent resource. + // Only search advertising channel type supports this field. + google.protobuf.Int64Value parent_top_slot_impressions = 13; + + // Projected minimum daily budget that must be available to the parent + // resource to realize this simulation. + google.protobuf.Int64Value parent_required_budget_micros = 14; +} + +// Projected metrics for a specific CPC bid amount. +message CpcBidSimulationPoint { + // The simulated CPC bid upon which projected metrics are based. + google.protobuf.Int64Value cpc_bid_micros = 1; + + // Projected number of biddable conversions. + google.protobuf.DoubleValue biddable_conversions = 2; + + // Projected total value of biddable conversions. + google.protobuf.DoubleValue biddable_conversions_value = 3; + + // Projected number of clicks. + google.protobuf.Int64Value clicks = 4; + + // Projected cost in micros. + google.protobuf.Int64Value cost_micros = 5; + + // Projected number of impressions. + google.protobuf.Int64Value impressions = 6; + + // Projected number of top slot impressions. + // Only search advertising channel type supports this field. + google.protobuf.Int64Value top_slot_impressions = 7; +} + +// Projected metrics for a specific CPV bid amount. +message CpvBidSimulationPoint { + // The simulated CPV bid upon which projected metrics are based. + google.protobuf.Int64Value cpv_bid_micros = 1; + + // Projected cost in micros. + google.protobuf.Int64Value cost_micros = 2; + + // Projected number of impressions. + google.protobuf.Int64Value impressions = 3; + + // Projected number of views. + google.protobuf.Int64Value views = 4; +} + +// Projected metrics for a specific target CPA amount. +message TargetCpaSimulationPoint { + // The simulated target CPA upon which projected metrics are based. + google.protobuf.Int64Value target_cpa_micros = 1; + + // Projected number of biddable conversions. + google.protobuf.DoubleValue biddable_conversions = 2; + + // Projected total value of biddable conversions. + google.protobuf.DoubleValue biddable_conversions_value = 3; + + // Projected number of clicks. + google.protobuf.Int64Value clicks = 4; + + // Projected cost in micros. + google.protobuf.Int64Value cost_micros = 5; + + // Projected number of impressions. + google.protobuf.Int64Value impressions = 6; + + // Projected number of top slot impressions. + // Only search advertising channel type supports this field. + google.protobuf.Int64Value top_slot_impressions = 7; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/tag_snippet.proto b/third_party/googleapis/google/ads/googleads/v3/common/tag_snippet.proto new file mode 100644 index 000000000..51e1a3a43 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/tag_snippet.proto @@ -0,0 +1,51 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/ads/googleads/v3/enums/tracking_code_page_format.proto"; +import "google/ads/googleads/v3/enums/tracking_code_type.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "TagSnippetProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file describing TagSnippet + +// The site tag and event snippet pair for a TrackingCodeType. +message TagSnippet { + // The type of the generated tag snippets for tracking conversions. + google.ads.googleads.v3.enums.TrackingCodeTypeEnum.TrackingCodeType type = 1; + + // The format of the web page where the tracking tag and snippet will be + // installed, e.g. HTML. + google.ads.googleads.v3.enums.TrackingCodePageFormatEnum.TrackingCodePageFormat page_format = 2; + + // The site tag that adds visitors to your basic remarketing lists and sets + // new cookies on your domain. + google.protobuf.StringValue global_site_tag = 3; + + // The event snippet that works with the site tag to track actions that + // should be counted as conversions. + google.protobuf.StringValue event_snippet = 4; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/targeting_setting.proto b/third_party/googleapis/google/ads/googleads/v3/common/targeting_setting.proto new file mode 100644 index 000000000..d2df8dd2b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/targeting_setting.proto @@ -0,0 +1,86 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/ads/googleads/v3/enums/targeting_dimension.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "TargetingSettingProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file describing TargetingSetting + +// Settings for the targeting-related features, at the campaign and ad group +// levels. For more details about the targeting setting, visit +// https://support.google.com/google-ads/answer/7365594 +message TargetingSetting { + // The per-targeting-dimension setting to restrict the reach of your campaign + // or ad group. + repeated TargetRestriction target_restrictions = 1; + + // The list of operations changing the target restrictions. + // + // Adding a target restriction with a targeting dimension that already exists + // causes the existing target restriction to be replaced with the new value. + repeated TargetRestrictionOperation target_restriction_operations = 2; +} + +// The list of per-targeting-dimension targeting settings. +message TargetRestriction { + // The targeting dimension that these settings apply to. + google.ads.googleads.v3.enums.TargetingDimensionEnum.TargetingDimension targeting_dimension = 1; + + // Indicates whether to restrict your ads to show only for the criteria you + // have selected for this targeting_dimension, or to target all values for + // this targeting_dimension and show ads based on your targeting in other + // TargetingDimensions. A value of `true` means that these criteria will only + // apply bid modifiers, and not affect targeting. A value of `false` means + // that these criteria will restrict targeting as well as applying bid + // modifiers. + google.protobuf.BoolValue bid_only = 2; +} + +// Operation to be performed on a target restriction list in a mutate. +message TargetRestrictionOperation { + // The operator. + enum Operator { + // Unspecified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Add the restriction to the existing restrictions. + ADD = 2; + + // Remove the restriction from the existing restrictions. + REMOVE = 3; + } + + // Type of list operation to perform. + Operator operator = 1; + + // The target restriction being added to or removed from the list. + TargetRestriction value = 2; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/text_label.proto b/third_party/googleapis/google/ads/googleads/v3/common/text_label.proto new file mode 100644 index 000000000..448b7247e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/text_label.proto @@ -0,0 +1,41 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "TextLabelProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// A type of label displaying text on a colored background. +message TextLabel { + // Background color of the label in RGB format. This string must match the + // regular expression '^\#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. + // Note: The background color may not be visible for manager accounts. + google.protobuf.StringValue background_color = 1; + + // A short description of the label. The length must be no more than 200 + // characters. + google.protobuf.StringValue description = 2; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/url_collection.proto b/third_party/googleapis/google/ads/googleads/v3/common/url_collection.proto new file mode 100644 index 000000000..85b90bd61 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/url_collection.proto @@ -0,0 +1,46 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "UrlCollectionProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file UrlCollection type. + +// Collection of urls that is tagged with a unique identifier. +message UrlCollection { + // Unique identifier for this UrlCollection instance. + google.protobuf.StringValue url_collection_id = 1; + + // A list of possible final URLs. + repeated google.protobuf.StringValue final_urls = 2; + + // A list of possible final mobile URLs. + repeated google.protobuf.StringValue final_mobile_urls = 3; + + // URL template for constructing a tracking URL. + google.protobuf.StringValue tracking_url_template = 4; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/user_lists.proto b/third_party/googleapis/google/ads/googleads/v3/common/user_lists.proto new file mode 100644 index 000000000..e311f6b05 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/user_lists.proto @@ -0,0 +1,292 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/ads/googleads/v3/enums/customer_match_upload_key_type.proto"; +import "google/ads/googleads/v3/enums/user_list_combined_rule_operator.proto"; +import "google/ads/googleads/v3/enums/user_list_crm_data_source_type.proto"; +import "google/ads/googleads/v3/enums/user_list_date_rule_item_operator.proto"; +import "google/ads/googleads/v3/enums/user_list_logical_rule_operator.proto"; +import "google/ads/googleads/v3/enums/user_list_number_rule_item_operator.proto"; +import "google/ads/googleads/v3/enums/user_list_prepopulation_status.proto"; +import "google/ads/googleads/v3/enums/user_list_rule_type.proto"; +import "google/ads/googleads/v3/enums/user_list_string_rule_item_operator.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "UserListsProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file describing user list types. + +// SimilarUserList is a list of users which are similar to users from another +// UserList. These lists are read-only and automatically created by Google. +message SimilarUserListInfo { + // Seed UserList from which this list is derived. + google.protobuf.StringValue seed_user_list = 1; +} + +// UserList of CRM users provided by the advertiser. +message CrmBasedUserListInfo { + // A string that uniquely identifies a mobile application from which the data + // was collected to the Google Ads API. + // For iOS, the ID string is the 9 digit string that appears at the end of an + // App Store URL (e.g., "476943146" for "Flood-It! 2" whose App Store link is + // http://itunes.apple.com/us/app/flood-it!-2/id476943146). + // For Android, the ID string is the application's package name + // (e.g., "com.labpixies.colordrips" for "Color Drips" given Google Play link + // https://play.google.com/store/apps/details?id=com.labpixies.colordrips). + // Required when creating CrmBasedUserList for uploading mobile advertising + // IDs. + google.protobuf.StringValue app_id = 1; + + // Matching key type of the list. + // Mixed data types are not allowed on the same list. + // This field is required for an ADD operation. + google.ads.googleads.v3.enums.CustomerMatchUploadKeyTypeEnum.CustomerMatchUploadKeyType upload_key_type = 2; + + // Data source of the list. Default value is FIRST_PARTY. + // Only whitelisted customers can create third-party sourced CRM lists. + google.ads.googleads.v3.enums.UserListCrmDataSourceTypeEnum.UserListCrmDataSourceType data_source_type = 3; +} + +// A client defined rule based on custom parameters sent by web sites or +// uploaded by the advertiser. +message UserListRuleInfo { + // Rule type is used to determine how to group rule items. + // + // The default is OR of ANDs (disjunctive normal form). + // That is, rule items will be ANDed together within rule item groups and the + // groups themselves will be ORed together. + // + // Currently AND of ORs (conjunctive normal form) is only supported for + // ExpressionRuleUserList. + google.ads.googleads.v3.enums.UserListRuleTypeEnum.UserListRuleType rule_type = 1; + + // List of rule item groups that defines this rule. + // Rule item groups are grouped together based on rule_type. + repeated UserListRuleItemGroupInfo rule_item_groups = 2; +} + +// A group of rule items. +message UserListRuleItemGroupInfo { + // Rule items that will be grouped together based on rule_type. + repeated UserListRuleItemInfo rule_items = 1; +} + +// An atomic rule item. +message UserListRuleItemInfo { + // Rule variable name. It should match the corresponding key name fired + // by the pixel. + // A name must begin with US-ascii letters or underscore or UTF8 code that is + // greater than 127 and consist of US-ascii letters or digits or underscore or + // UTF8 code that is greater than 127. + // For websites, there are two built-in variable URL (name = 'url__') and + // referrer URL (name = 'ref_url__'). + // This field must be populated when creating a new rule item. + google.protobuf.StringValue name = 1; + + // An atomic rule item. + oneof rule_item { + // An atomic rule item composed of a number operation. + UserListNumberRuleItemInfo number_rule_item = 2; + + // An atomic rule item composed of a string operation. + UserListStringRuleItemInfo string_rule_item = 3; + + // An atomic rule item composed of a date operation. + UserListDateRuleItemInfo date_rule_item = 4; + } +} + +// A rule item composed of a date operation. +message UserListDateRuleItemInfo { + // Date comparison operator. + // This field is required and must be populated when creating new date + // rule item. + google.ads.googleads.v3.enums.UserListDateRuleItemOperatorEnum.UserListDateRuleItemOperator operator = 1; + + // String representing date value to be compared with the rule variable. + // Supported date format is YYYY-MM-DD. + // Times are reported in the customer's time zone. + google.protobuf.StringValue value = 2; + + // The relative date value of the right hand side denoted by number of days + // offset from now. The value field will override this field when both are + // present. + google.protobuf.Int64Value offset_in_days = 3; +} + +// A rule item composed of a number operation. +message UserListNumberRuleItemInfo { + // Number comparison operator. + // This field is required and must be populated when creating a new number + // rule item. + google.ads.googleads.v3.enums.UserListNumberRuleItemOperatorEnum.UserListNumberRuleItemOperator operator = 1; + + // Number value to be compared with the variable. + // This field is required and must be populated when creating a new number + // rule item. + google.protobuf.DoubleValue value = 2; +} + +// A rule item composed of a string operation. +message UserListStringRuleItemInfo { + // String comparison operator. + // This field is required and must be populated when creating a new string + // rule item. + google.ads.googleads.v3.enums.UserListStringRuleItemOperatorEnum.UserListStringRuleItemOperator operator = 1; + + // The right hand side of the string rule item. For URLs or referrer URLs, + // the value can not contain illegal URL chars such as newlines, quotes, + // tabs, or parentheses. This field is required and must be populated when + // creating a new string rule item. + google.protobuf.StringValue value = 2; +} + +// User lists defined by combining two rules, left operand and right operand. +// There are two operators: AND where left operand and right operand have to be +// true; AND_NOT where left operand is true but right operand is false. +message CombinedRuleUserListInfo { + // Left operand of the combined rule. + // This field is required and must be populated when creating new combined + // rule based user list. + UserListRuleInfo left_operand = 1; + + // Right operand of the combined rule. + // This field is required and must be populated when creating new combined + // rule based user list. + UserListRuleInfo right_operand = 2; + + // Operator to connect the two operands. + // + // Required for creating a combined rule user list. + google.ads.googleads.v3.enums.UserListCombinedRuleOperatorEnum.UserListCombinedRuleOperator rule_operator = 3; +} + +// Visitors of a page during specific dates. +message DateSpecificRuleUserListInfo { + // Boolean rule that defines visitor of a page. + // + // Required for creating a date specific rule user list. + UserListRuleInfo rule = 1; + + // Start date of users visit. If set to 2000-01-01, then the list includes all + // users before end_date. The date's format should be YYYY-MM-DD. + // + // Required for creating a data specific rule user list. + google.protobuf.StringValue start_date = 2; + + // End date of users visit. If set to 2037-12-30, then the list includes all + // users after start_date. The date's format should be YYYY-MM-DD. + // + // Required for creating a data specific rule user list. + google.protobuf.StringValue end_date = 3; +} + +// Visitors of a page. The page visit is defined by one boolean rule expression. +message ExpressionRuleUserListInfo { + // Boolean rule that defines this user list. The rule consists of a list of + // rule item groups and each rule item group consists of a list of rule items. + // All the rule item groups are ORed or ANDed together for evaluation based on + // rule.rule_type. + // + // Required for creating an expression rule user list. + UserListRuleInfo rule = 1; +} + +// Representation of a userlist that is generated by a rule. +message RuleBasedUserListInfo { + // The status of pre-population. The field is default to NONE if not set which + // means the previous users will not be considered. If set to REQUESTED, past + // site visitors or app users who match the list definition will be included + // in the list (works on the Display Network only). This will only + // add past users from within the last 30 days, depending on the + // list's membership duration and the date when the remarketing tag is added. + // The status will be updated to FINISHED once request is processed, or FAILED + // if the request fails. + google.ads.googleads.v3.enums.UserListPrepopulationStatusEnum.UserListPrepopulationStatus prepopulation_status = 1; + + // Subtypes of rule based user lists. + oneof rule_based_user_list { + // User lists defined by combining two rules. + // There are two operators: AND, where the left and right operands have to + // be true; AND_NOT where left operand is true but right operand is false. + CombinedRuleUserListInfo combined_rule_user_list = 2; + + // Visitors of a page during specific dates. The visiting periods are + // defined as follows: + // Between start_date (inclusive) and end_date (inclusive); + // Before end_date (exclusive) with start_date = 2000-01-01; + // After start_date (exclusive) with end_date = 2037-12-30. + DateSpecificRuleUserListInfo date_specific_rule_user_list = 3; + + // Visitors of a page. The page visit is defined by one boolean rule + // expression. + ExpressionRuleUserListInfo expression_rule_user_list = 4; + } +} + +// Represents a user list that is a custom combination of user lists. +message LogicalUserListInfo { + // Logical list rules that define this user list. The rules are defined as a + // logical operator (ALL/ANY/NONE) and a list of user lists. All the rules are + // ANDed when they are evaluated. + // + // Required for creating a logical user list. + repeated UserListLogicalRuleInfo rules = 1; +} + +// A user list logical rule. A rule has a logical operator (and/or/not) and a +// list of user lists as operands. +message UserListLogicalRuleInfo { + // The logical operator of the rule. + google.ads.googleads.v3.enums.UserListLogicalRuleOperatorEnum.UserListLogicalRuleOperator operator = 1; + + // The list of operands of the rule. + repeated LogicalUserListOperandInfo rule_operands = 2; +} + +// Operand of logical user list that consists of a user list. +message LogicalUserListOperandInfo { + // Resource name of a user list as an operand. + google.protobuf.StringValue user_list = 1; +} + +// User list targeting as a collection of conversions or remarketing actions. +message BasicUserListInfo { + // Actions associated with this user list. + repeated UserListActionInfo actions = 1; +} + +// Represents an action type used for building remarketing user lists. +message UserListActionInfo { + // Subtypes of user list action. + oneof user_list_action { + // A conversion action that's not generated from remarketing. + google.protobuf.StringValue conversion_action = 1; + + // A remarketing action. + google.protobuf.StringValue remarketing_action = 2; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/common/value.proto b/third_party/googleapis/google/ads/googleads/v3/common/value.proto new file mode 100644 index 000000000..be5792e25 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/common/value.proto @@ -0,0 +1,51 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.common; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Common"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common"; +option java_multiple_files = true; +option java_outer_classname = "ValueProto"; +option java_package = "com.google.ads.googleads.v3.common"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common"; +option ruby_package = "Google::Ads::GoogleAds::V3::Common"; + +// Proto file describing value types + +// A generic data container. +message Value { + // A value. + oneof value { + // A boolean. + bool boolean_value = 1; + + // An int64. + int64 int64_value = 2; + + // A float. + float float_value = 3; + + // A double. + double double_value = 4; + + // A string. + string string_value = 5; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/access_reason.proto b/third_party/googleapis/google/ads/googleads/v3/enums/access_reason.proto new file mode 100644 index 000000000..8acee7121 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/access_reason.proto @@ -0,0 +1,57 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AccessReasonProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Indicates the way the resource such as user list is related to a user. +message AccessReasonEnum { + // Enum describing possible access reasons. + enum AccessReason { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The resource is owned by the user. + OWNED = 2; + + // The resource is shared to the user. + SHARED = 3; + + // The resource is licensed to the user. + LICENSED = 4; + + // The user subscribed to the resource. + SUBSCRIBED = 5; + + // The resource is accessible to the user. + AFFILIATED = 6; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/access_role.proto b/third_party/googleapis/google/ads/googleads/v3/enums/access_role.proto new file mode 100644 index 000000000..4f1729241 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/access_role.proto @@ -0,0 +1,51 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AccessRoleProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Container for enum describing possible access role for user. +message AccessRoleEnum { + // Possible access role of a user. + enum AccessRole { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Owns its account and can control the addition of other users. + ADMIN = 2; + + // Can modify campaigns, but can't affect other users. + STANDARD = 3; + + // Can view campaigns and account changes, but cannot make edits. + READ_ONLY = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/account_budget_proposal_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/account_budget_proposal_status.proto new file mode 100644 index 000000000..286be91df --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/account_budget_proposal_status.proto @@ -0,0 +1,63 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AccountBudgetProposalStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing AccountBudgetProposal statuses. + +// Message describing AccountBudgetProposal statuses. +message AccountBudgetProposalStatusEnum { + // The possible statuses of an AccountBudgetProposal. + enum AccountBudgetProposalStatus { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The proposal is pending approval. + PENDING = 2; + + // The proposal has been approved but the corresponding billing setup + // has not. This can occur for proposals that set up the first budget + // when signing up for billing or when performing a change of bill-to + // operation. + APPROVED_HELD = 3; + + // The proposal has been approved. + APPROVED = 4; + + // The proposal has been cancelled by the user. + CANCELLED = 5; + + // The proposal has been rejected by the user, e.g. by rejecting an + // acceptance email. + REJECTED = 6; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/account_budget_proposal_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/account_budget_proposal_type.proto new file mode 100644 index 000000000..55f33d981 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/account_budget_proposal_type.proto @@ -0,0 +1,56 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AccountBudgetProposalTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing AccountBudgetProposal types. + +// Message describing AccountBudgetProposal types. +message AccountBudgetProposalTypeEnum { + // The possible types of an AccountBudgetProposal. + enum AccountBudgetProposalType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Identifies a request to create a new budget. + CREATE = 2; + + // Identifies a request to edit an existing budget. + UPDATE = 3; + + // Identifies a request to end a budget that has already started. + END = 4; + + // Identifies a request to remove a budget that hasn't started yet. + REMOVE = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/account_budget_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/account_budget_status.proto new file mode 100644 index 000000000..f5035cc46 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/account_budget_status.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AccountBudgetStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing AccountBudget statuses. + +// Message describing AccountBudget statuses. +message AccountBudgetStatusEnum { + // The possible statuses of an AccountBudget. + enum AccountBudgetStatus { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The account budget is pending approval. + PENDING = 2; + + // The account budget has been approved. + APPROVED = 3; + + // The account budget has been cancelled by the user. + CANCELLED = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/ad_customizer_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v3/enums/ad_customizer_placeholder_field.proto new file mode 100644 index 000000000..5df0748f8 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/ad_customizer_placeholder_field.proto @@ -0,0 +1,56 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AdCustomizerPlaceholderFieldProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Ad Customizer placeholder fields. + +// Values for Ad Customizer placeholder fields. +message AdCustomizerPlaceholderFieldEnum { + // Possible values for Ad Customizers placeholder fields. + enum AdCustomizerPlaceholderField { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Data Type: INT64. Integer value to be inserted. + INTEGER = 2; + + // Data Type: STRING. Price value to be inserted. + PRICE = 3; + + // Data Type: DATE_TIME. Date value to be inserted. + DATE = 4; + + // Data Type: STRING. String value to be inserted. + STRING = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/ad_group_ad_rotation_mode.proto b/third_party/googleapis/google/ads/googleads/v3/enums/ad_group_ad_rotation_mode.proto new file mode 100644 index 000000000..d7a89d168 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/ad_group_ad_rotation_mode.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupAdRotationModeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing ad group ad rotation mode. + +// Container for enum describing possible ad rotation modes of ads within an +// ad group. +message AdGroupAdRotationModeEnum { + // The possible ad rotation modes of an ad group. + enum AdGroupAdRotationMode { + // The ad rotation mode has not been specified. + UNSPECIFIED = 0; + + // The received value is not known in this version. + // + // This is a response-only value. + UNKNOWN = 1; + + // Optimize ad group ads based on clicks or conversions. + OPTIMIZE = 2; + + // Rotate evenly forever. + ROTATE_FOREVER = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/ad_group_ad_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/ad_group_ad_status.proto new file mode 100644 index 000000000..22ca2b0fd --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/ad_group_ad_status.proto @@ -0,0 +1,55 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupAdStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing ad group status. + +// Container for enum describing possible statuses of an AdGroupAd. +message AdGroupAdStatusEnum { + // The possible statuses of an AdGroupAd. + enum AdGroupAdStatus { + // No value has been specified. + UNSPECIFIED = 0; + + // The received value is not known in this version. + // + // This is a response-only value. + UNKNOWN = 1; + + // The ad group ad is enabled. + ENABLED = 2; + + // The ad group ad is paused. + PAUSED = 3; + + // The ad group ad is removed. + REMOVED = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/ad_group_criterion_approval_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/ad_group_criterion_approval_status.proto new file mode 100644 index 000000000..e4e6bff64 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/ad_group_criterion_approval_status.proto @@ -0,0 +1,56 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupCriterionApprovalStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing approval status for the criterion. + +// Container for enum describing possible AdGroupCriterion approval statuses. +message AdGroupCriterionApprovalStatusEnum { + // Enumerates AdGroupCriterion approval statuses. + enum AdGroupCriterionApprovalStatus { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // Approved. + APPROVED = 2; + + // Disapproved. + DISAPPROVED = 3; + + // Pending Review. + PENDING_REVIEW = 4; + + // Under review. + UNDER_REVIEW = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/ad_group_criterion_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/ad_group_criterion_status.proto new file mode 100644 index 000000000..f281e6154 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/ad_group_criterion_status.proto @@ -0,0 +1,55 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupCriterionStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing AdGroupCriterion statuses. + +// Message describing AdGroupCriterion statuses. +message AdGroupCriterionStatusEnum { + // The possible statuses of an AdGroupCriterion. + enum AdGroupCriterionStatus { + // No value has been specified. + UNSPECIFIED = 0; + + // The received value is not known in this version. + // + // This is a response-only value. + UNKNOWN = 1; + + // The ad group criterion is enabled. + ENABLED = 2; + + // The ad group criterion is paused. + PAUSED = 3; + + // The ad group criterion is removed. + REMOVED = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/ad_group_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/ad_group_status.proto new file mode 100644 index 000000000..52079e3c5 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/ad_group_status.proto @@ -0,0 +1,55 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing ad group status. + +// Container for enum describing possible statuses of an ad group. +message AdGroupStatusEnum { + // The possible statuses of an ad group. + enum AdGroupStatus { + // The status has not been specified. + UNSPECIFIED = 0; + + // The received value is not known in this version. + // + // This is a response-only value. + UNKNOWN = 1; + + // The ad group is enabled. + ENABLED = 2; + + // The ad group is paused. + PAUSED = 3; + + // The ad group is removed. + REMOVED = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/ad_group_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/ad_group_type.proto new file mode 100644 index 000000000..992996fd8 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/ad_group_type.proto @@ -0,0 +1,90 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing ad group types. + +// Defines types of an ad group, specific to a particular campaign channel +// type. This type drives validations that restrict which entities can be +// added to the ad group. +message AdGroupTypeEnum { + // Enum listing the possible types of an ad group. + enum AdGroupType { + // The type has not been specified. + UNSPECIFIED = 0; + + // The received value is not known in this version. + // + // This is a response-only value. + UNKNOWN = 1; + + // The default ad group type for Search campaigns. + SEARCH_STANDARD = 2; + + // The default ad group type for Display campaigns. + DISPLAY_STANDARD = 3; + + // The ad group type for Shopping campaigns serving standard product ads. + SHOPPING_PRODUCT_ADS = 4; + + // The default ad group type for Hotel campaigns. + HOTEL_ADS = 6; + + // The type for ad groups in Smart Shopping campaigns. + SHOPPING_SMART_ADS = 7; + + // Short unskippable in-stream video ads. + VIDEO_BUMPER = 8; + + // TrueView (skippable) in-stream video ads. + VIDEO_TRUE_VIEW_IN_STREAM = 9; + + // TrueView in-display video ads. + VIDEO_TRUE_VIEW_IN_DISPLAY = 10; + + // Unskippable in-stream video ads. + VIDEO_NON_SKIPPABLE_IN_STREAM = 11; + + // Outstream video ads. + VIDEO_OUTSTREAM = 12; + + // Ad group type for Dynamic Search Ads ad groups. + SEARCH_DYNAMIC_ADS = 13; + + // The type for ad groups in Shopping Comparison Listing campaigns. + SHOPPING_COMPARISON_LISTING_ADS = 14; + + // The ad group type for Promoted Hotel ad groups. + PROMOTED_HOTEL_ADS = 15; + + // Video responsive ad groups. + VIDEO_RESPONSIVE = 16; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/ad_network_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/ad_network_type.proto new file mode 100644 index 000000000..022f8c100 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/ad_network_type.proto @@ -0,0 +1,62 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AdNetworkTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing ad network types. + +// Container for enumeration of Google Ads network types. +message AdNetworkTypeEnum { + // Enumerates Google Ads network types. + enum AdNetworkType { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // Google search. + SEARCH = 2; + + // Search partners. + SEARCH_PARTNERS = 3; + + // Display Network. + CONTENT = 4; + + // YouTube Search. + YOUTUBE_SEARCH = 5; + + // YouTube Videos + YOUTUBE_WATCH = 6; + + // Cross-network. + MIXED = 7; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/ad_serving_optimization_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/ad_serving_optimization_status.proto new file mode 100644 index 000000000..9148ce069 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/ad_serving_optimization_status.proto @@ -0,0 +1,64 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AdServingOptimizationStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing ad serving statuses. + +// Possible ad serving statuses of a campaign. +message AdServingOptimizationStatusEnum { + // Enum describing possible serving statuses. + enum AdServingOptimizationStatus { + // No value has been specified. + UNSPECIFIED = 0; + + // The received value is not known in this version. + // + // This is a response-only value. + UNKNOWN = 1; + + // Ad serving is optimized based on CTR for the campaign. + OPTIMIZE = 2; + + // Ad serving is optimized based on CTR * Conversion for the campaign. If + // the campaign is not in the conversion optimizer bidding strategy, it will + // default to OPTIMIZED. + CONVERSION_OPTIMIZE = 3; + + // Ads are rotated evenly for 90 days, then optimized for clicks. + ROTATE = 4; + + // Show lower performing ads more evenly with higher performing ads, and do + // not optimize. + ROTATE_INDEFINITELY = 5; + + // Ad serving optimization status is not available. + UNAVAILABLE = 6; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/ad_strength.proto b/third_party/googleapis/google/ads/googleads/v3/enums/ad_strength.proto new file mode 100644 index 000000000..7e51ee150 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/ad_strength.proto @@ -0,0 +1,62 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AdStrengthProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing ad strengths. + +// Container for enum describing possible ad strengths. +message AdStrengthEnum { + // Enum listing the possible ad strengths. + enum AdStrength { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The ad strength is currently pending. + PENDING = 2; + + // No ads could be generated. + NO_ADS = 3; + + // Poor strength. + POOR = 4; + + // Average strength. + AVERAGE = 5; + + // Good strength. + GOOD = 6; + + // Excellent strength. + EXCELLENT = 7; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/ad_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/ad_type.proto new file mode 100644 index 000000000..184161826 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/ad_type.proto @@ -0,0 +1,107 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AdTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing the ad type. + +// Container for enum describing possible types of an ad. +message AdTypeEnum { + // The possible types of an ad. + enum AdType { + // No value has been specified. + UNSPECIFIED = 0; + + // The received value is not known in this version. + // + // This is a response-only value. + UNKNOWN = 1; + + // The ad is a text ad. + TEXT_AD = 2; + + // The ad is an expanded text ad. + EXPANDED_TEXT_AD = 3; + + // The ad is a call only ad. + CALL_ONLY_AD = 6; + + // The ad is an expanded dynamic search ad. + EXPANDED_DYNAMIC_SEARCH_AD = 7; + + // The ad is a hotel ad. + HOTEL_AD = 8; + + // The ad is a Smart Shopping ad. + SHOPPING_SMART_AD = 9; + + // The ad is a standard Shopping ad. + SHOPPING_PRODUCT_AD = 10; + + // The ad is a video ad. + VIDEO_AD = 12; + + // This ad is a Gmail ad. + GMAIL_AD = 13; + + // This ad is an Image ad. + IMAGE_AD = 14; + + // The ad is a responsive search ad. + RESPONSIVE_SEARCH_AD = 15; + + // The ad is a legacy responsive display ad. + LEGACY_RESPONSIVE_DISPLAY_AD = 16; + + // The ad is an app ad. + APP_AD = 17; + + // The ad is a legacy app install ad. + LEGACY_APP_INSTALL_AD = 18; + + // The ad is a responsive display ad. + RESPONSIVE_DISPLAY_AD = 19; + + // The ad is a display upload ad with the HTML5_UPLOAD_AD product type. + HTML5_UPLOAD_AD = 21; + + // The ad is a display upload ad with one of the DYNAMIC_HTML5_* product + // types. + DYNAMIC_HTML5_AD = 22; + + // The ad is an app engagement ad. + APP_ENGAGEMENT_AD = 23; + + // The ad is a Shopping Comparison Listing ad. + SHOPPING_COMPARISON_LISTING_AD = 24; + + // Video responsive ad. + VIDEO_RESPONSIVE_AD = 30; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/advertising_channel_sub_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/advertising_channel_sub_type.proto new file mode 100644 index 000000000..9ea36496f --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/advertising_channel_sub_type.proto @@ -0,0 +1,87 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AdvertisingChannelSubTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing advertising channel subtypes. + +// An immutable specialization of an Advertising Channel. +message AdvertisingChannelSubTypeEnum { + // Enum describing the different channel subtypes. + enum AdvertisingChannelSubType { + // Not specified. + UNSPECIFIED = 0; + + // Used as a return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Mobile app campaigns for Search. + SEARCH_MOBILE_APP = 2; + + // Mobile app campaigns for Display. + DISPLAY_MOBILE_APP = 3; + + // AdWords express campaigns for search. + SEARCH_EXPRESS = 4; + + // AdWords Express campaigns for display. + DISPLAY_EXPRESS = 5; + + // Smart Shopping campaigns. + SHOPPING_SMART_ADS = 6; + + // Gmail Ad campaigns. + DISPLAY_GMAIL_AD = 7; + + // Smart display campaigns. + DISPLAY_SMART_CAMPAIGN = 8; + + // Video Outstream campaigns. + VIDEO_OUTSTREAM = 9; + + // Video TrueView for Action campaigns. + VIDEO_ACTION = 10; + + // Video campaigns with non-skippable video ads. + VIDEO_NON_SKIPPABLE = 11; + + // App Campaign that allows you to easily promote your Android or iOS app + // across Google's top properties including Search, Play, YouTube, and the + // Google Display Network. + APP_CAMPAIGN = 12; + + // App Campaign for engagement, focused on driving re-engagement with the + // app across several of Google’s top properties including Search, YouTube, + // and the Google Display Network. + APP_CAMPAIGN_FOR_ENGAGEMENT = 13; + + // Shopping Comparison Listing campaigns. + SHOPPING_COMPARISON_LISTING_ADS = 15; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/advertising_channel_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/advertising_channel_type.proto new file mode 100644 index 000000000..9827e4b8b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/advertising_channel_type.proto @@ -0,0 +1,64 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AdvertisingChannelTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing advertising channel types + +// The channel type a campaign may target to serve on. +message AdvertisingChannelTypeEnum { + // Enum describing the various advertising channel types. + enum AdvertisingChannelType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Search Network. Includes display bundled, and Search+ campaigns. + SEARCH = 2; + + // Google Display Network only. + DISPLAY = 3; + + // Shopping campaigns serve on the shopping property + // and on google.com search results. + SHOPPING = 4; + + // Hotel Ads campaigns. + HOTEL = 5; + + // Video campaigns. + VIDEO = 6; + + // App Campaigns, and App Campaigns for Engagement, that run + // across multiple channels. + MULTI_CHANNEL = 7; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/affiliate_location_feed_relationship_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/affiliate_location_feed_relationship_type.proto new file mode 100644 index 000000000..985eac98e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/affiliate_location_feed_relationship_type.proto @@ -0,0 +1,48 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AffiliateLocationFeedRelationshipTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing relation type for affiliate location feeds. + +// Container for enum describing possible values for a relationship type for +// an affiliate location feed. +message AffiliateLocationFeedRelationshipTypeEnum { + // Possible values for a relationship type for an affiliate location feed. + enum AffiliateLocationFeedRelationshipType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // General retailer relationship. + GENERAL_RETAILER = 2; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/affiliate_location_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v3/enums/affiliate_location_placeholder_field.proto new file mode 100644 index 000000000..6aa7e5d21 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/affiliate_location_placeholder_field.proto @@ -0,0 +1,77 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AffiliateLocationPlaceholderFieldProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Affiliate Location placeholder fields. + +// Values for Affiliate Location placeholder fields. +message AffiliateLocationPlaceholderFieldEnum { + // Possible values for Affiliate Location placeholder fields. + enum AffiliateLocationPlaceholderField { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Data Type: STRING. The name of the business. + BUSINESS_NAME = 2; + + // Data Type: STRING. Line 1 of the business address. + ADDRESS_LINE_1 = 3; + + // Data Type: STRING. Line 2 of the business address. + ADDRESS_LINE_2 = 4; + + // Data Type: STRING. City of the business address. + CITY = 5; + + // Data Type: STRING. Province of the business address. + PROVINCE = 6; + + // Data Type: STRING. Postal code of the business address. + POSTAL_CODE = 7; + + // Data Type: STRING. Country code of the business address. + COUNTRY_CODE = 8; + + // Data Type: STRING. Phone number of the business. + PHONE_NUMBER = 9; + + // Data Type: STRING. Language code of the business. + LANGUAGE_CODE = 10; + + // Data Type: INT64. ID of the chain. + CHAIN_ID = 11; + + // Data Type: STRING. Name of the chain. + CHAIN_NAME = 12; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/age_range_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/age_range_type.proto new file mode 100644 index 000000000..28f172bcd --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/age_range_type.proto @@ -0,0 +1,65 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AgeRangeTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing age range types. + +// Container for enum describing the type of demographic age ranges. +message AgeRangeTypeEnum { + // The type of demographic age ranges (e.g. between 18 and 24 years old). + enum AgeRangeType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Between 18 and 24 years old. + AGE_RANGE_18_24 = 503001; + + // Between 25 and 34 years old. + AGE_RANGE_25_34 = 503002; + + // Between 35 and 44 years old. + AGE_RANGE_35_44 = 503003; + + // Between 45 and 54 years old. + AGE_RANGE_45_54 = 503004; + + // Between 55 and 64 years old. + AGE_RANGE_55_64 = 503005; + + // 65 years old and beyond. + AGE_RANGE_65_UP = 503006; + + // Undetermined age range. + AGE_RANGE_UNDETERMINED = 503999; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/app_campaign_app_store.proto b/third_party/googleapis/google/ads/googleads/v3/enums/app_campaign_app_store.proto new file mode 100644 index 000000000..30d8032d4 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/app_campaign_app_store.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AppCampaignAppStoreProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing App Campaign app store. + +// The application store that distributes mobile applications. +message AppCampaignAppStoreEnum { + // Enum describing app campaign app store. + enum AppCampaignAppStore { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Apple app store. + APPLE_APP_STORE = 2; + + // Google play. + GOOGLE_APP_STORE = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/app_campaign_bidding_strategy_goal_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/app_campaign_bidding_strategy_goal_type.proto new file mode 100644 index 000000000..26d3460ce --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/app_campaign_bidding_strategy_goal_type.proto @@ -0,0 +1,64 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AppCampaignBiddingStrategyGoalTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing App Campaign bidding strategy goal types. + +// Container for enum describing goal towards which the bidding strategy of an +// app campaign should optimize for. +message AppCampaignBiddingStrategyGoalTypeEnum { + // Goal type of App campaign BiddingStrategy. + enum AppCampaignBiddingStrategyGoalType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Aim to maximize the number of app installs. The cpa bid is the + // target cost per install. + OPTIMIZE_INSTALLS_TARGET_INSTALL_COST = 2; + + // Aim to maximize the long term number of selected in-app conversions from + // app installs. The cpa bid is the target cost per install. + OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST = 3; + + // Aim to maximize the long term number of selected in-app conversions from + // app installs. The cpa bid is the target cost per in-app conversion. Note + // that the actual cpa may seem higher than the target cpa at first, since + // the long term conversions haven’t happened yet. + OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST = 4; + + // Aim to maximize all conversions' value, i.e. install + selected in-app + // conversions while achieving or exceeding target return on advertising + // spend. + OPTIMIZE_RETURN_ON_ADVERTISING_SPEND = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/app_payment_model_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/app_payment_model_type.proto new file mode 100644 index 000000000..1147e363f --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/app_payment_model_type.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AppPaymentModelTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing criteria types. + +// Represents a criterion for targeting paid apps. +message AppPaymentModelTypeEnum { + // Enum describing possible app payment models. + enum AppPaymentModelType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Represents paid-for apps. + PAID = 30; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/app_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v3/enums/app_placeholder_field.proto new file mode 100644 index 000000000..52db714fa --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/app_placeholder_field.proto @@ -0,0 +1,75 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AppPlaceholderFieldProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing App placeholder fields. + +// Values for App placeholder fields. +message AppPlaceholderFieldEnum { + // Possible values for App placeholder fields. + enum AppPlaceholderField { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Data Type: INT64. The application store that the target application + // belongs to. Valid values are: 1 = Apple iTunes Store; 2 = Google Play + // Store. + STORE = 2; + + // Data Type: STRING. The store-specific ID for the target application. + ID = 3; + + // Data Type: STRING. The visible text displayed when the link is rendered + // in an ad. + LINK_TEXT = 4; + + // Data Type: STRING. The destination URL of the in-app link. + URL = 5; + + // Data Type: URL_LIST. Final URLs for the in-app link when using Upgraded + // URLs. + FINAL_URLS = 6; + + // Data Type: URL_LIST. Final Mobile URLs for the in-app link when using + // Upgraded URLs. + FINAL_MOBILE_URLS = 7; + + // Data Type: URL. Tracking template for the in-app link when using Upgraded + // URLs. + TRACKING_URL = 8; + + // Data Type: STRING. Final URL suffix for the in-app link when using + // parallel tracking. + FINAL_URL_SUFFIX = 9; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/app_store.proto b/third_party/googleapis/google/ads/googleads/v3/enums/app_store.proto new file mode 100644 index 000000000..80bad8036 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/app_store.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AppStoreProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing app store types for an app extension. + +// Container for enum describing app store type in an app extension. +message AppStoreEnum { + // App store type in an app extension. + enum AppStore { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Apple iTunes. + APPLE_ITUNES = 2; + + // Google Play. + GOOGLE_PLAY = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/app_url_operating_system_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/app_url_operating_system_type.proto new file mode 100644 index 000000000..b90d04c26 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/app_url_operating_system_type.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AppUrlOperatingSystemTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing operating system for a deeplink app URL. + +// The possible OS types for a deeplink AppUrl. +message AppUrlOperatingSystemTypeEnum { + // Operating System + enum AppUrlOperatingSystemType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The Apple IOS operating system. + IOS = 2; + + // The Android operating system. + ANDROID = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/asset_field_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/asset_field_type.proto new file mode 100644 index 000000000..27d756de4 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/asset_field_type.proto @@ -0,0 +1,62 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AssetFieldTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing asset type. + +// Container for enum describing the possible placements of an asset. +message AssetFieldTypeEnum { + // Enum describing the possible placements of an asset. + enum AssetFieldType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The asset is linked for use as a headline. + HEADLINE = 2; + + // The asset is linked for use as a description. + DESCRIPTION = 3; + + // The asset is linked for use as mandatory ad text. + MANDATORY_AD_TEXT = 4; + + // The asset is linked for use as a marketing image. + MARKETING_IMAGE = 5; + + // The asset is linked for use as a media bundle. + MEDIA_BUNDLE = 6; + + // The asset is linked for use as a YouTube video. + YOUTUBE_VIDEO = 7; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/asset_performance_label.proto b/third_party/googleapis/google/ads/googleads/v3/enums/asset_performance_label.proto new file mode 100644 index 000000000..bce7adf99 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/asset_performance_label.proto @@ -0,0 +1,62 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AssetPerformanceLabelProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing the performance label of an asset. + +// Container for enum describing the performance label of an asset. +message AssetPerformanceLabelEnum { + // Enum describing the possible performance labels of an asset, usually + // computed in the context of a linkage. + enum AssetPerformanceLabel { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // This asset does not yet have any performance informantion. This may be + // because it is still under review. + PENDING = 2; + + // The asset has started getting impressions but the stats are not + // statistically significant enough to get an asset performance label. + LEARNING = 3; + + // Worst performing assets. + LOW = 4; + + // Good performing assets. + GOOD = 5; + + // Best performing assets. + BEST = 6; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/asset_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/asset_type.proto new file mode 100644 index 000000000..430606ac8 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/asset_type.proto @@ -0,0 +1,56 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AssetTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing asset type. + +// Container for enum describing the types of asset. +message AssetTypeEnum { + // Enum describing possible types of asset. + enum AssetType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // YouTube video asset. + YOUTUBE_VIDEO = 2; + + // Media bundle asset. + MEDIA_BUNDLE = 3; + + // Image asset. + IMAGE = 4; + + // Text asset. + TEXT = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/attribution_model.proto b/third_party/googleapis/google/ads/googleads/v3/enums/attribution_model.proto new file mode 100644 index 000000000..0d162687c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/attribution_model.proto @@ -0,0 +1,72 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "AttributionModelProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Container for enum representing the attribution model that describes how to +// distribute credit for a particular conversion across potentially many prior +// interactions. +message AttributionModelEnum { + // The attribution model that describes how to distribute credit for a + // particular conversion across potentially many prior interactions. + enum AttributionModel { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Uses external attribution. + EXTERNAL = 100; + + // Attributes all credit for a conversion to its last click. + GOOGLE_ADS_LAST_CLICK = 101; + + // Attributes all credit for a conversion to its first click using Google + // Search attribution. + GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK = 102; + + // Attributes credit for a conversion equally across all of its clicks using + // Google Search attribution. + GOOGLE_SEARCH_ATTRIBUTION_LINEAR = 103; + + // Attributes exponentially more credit for a conversion to its more recent + // clicks using Google Search attribution (half-life is 1 week). + GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY = 104; + + // Attributes 40% of the credit for a conversion to its first and last + // clicks. Remaining 20% is evenly distributed across all other clicks. This + // uses Google Search attribution. + GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED = 105; + + // Flexible model that uses machine learning to determine the appropriate + // distribution of credit among clicks using Google Search attribution. + GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN = 106; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/bid_modifier_source.proto b/third_party/googleapis/google/ads/googleads/v3/enums/bid_modifier_source.proto new file mode 100644 index 000000000..08627b4a8 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/bid_modifier_source.proto @@ -0,0 +1,51 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "BidModifierSourceProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing bid modifier source. + +// Container for enum describing possible bid modifier sources. +message BidModifierSourceEnum { + // Enum describing possible bid modifier sources. + enum BidModifierSource { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The bid modifier is specified at the campaign level, on the campaign + // level criterion. + CAMPAIGN = 2; + + // The bid modifier is specified (overridden) at the ad group level. + AD_GROUP = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/bidding_source.proto b/third_party/googleapis/google/ads/googleads/v3/enums/bidding_source.proto new file mode 100644 index 000000000..813926db0 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/bidding_source.proto @@ -0,0 +1,55 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "BiddingSourceProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing bidding sources. + +// Container for enum describing possible bidding sources. +message BiddingSourceEnum { + // Indicates where a bid or target is defined. For example, an ad group + // criterion may define a cpc bid directly, or it can inherit its cpc bid from + // the ad group. + enum BiddingSource { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Effective bid or target is inherited from campaign bidding strategy. + CAMPAIGN_BIDDING_STRATEGY = 5; + + // The bid or target is defined on the ad group. + AD_GROUP = 6; + + // The bid or target is defined on the ad group criterion. + AD_GROUP_CRITERION = 7; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/bidding_strategy_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/bidding_strategy_status.proto new file mode 100644 index 000000000..87c8bdcd1 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/bidding_strategy_status.proto @@ -0,0 +1,52 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "BiddingStrategyStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing BiddingStrategy statuses. + +// Message describing BiddingStrategy statuses. +message BiddingStrategyStatusEnum { + // The possible statuses of a BiddingStrategy. + enum BiddingStrategyStatus { + // No value has been specified. + UNSPECIFIED = 0; + + // The received value is not known in this version. + // + // This is a response-only value. + UNKNOWN = 1; + + // The bidding strategy is enabled. + ENABLED = 2; + + // The bidding strategy is removed. + REMOVED = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/bidding_strategy_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/bidding_strategy_type.proto new file mode 100644 index 000000000..192121556 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/bidding_strategy_type.proto @@ -0,0 +1,110 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "BiddingStrategyTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing bidding schemes. + +// Container for enum describing possible bidding strategy types. +message BiddingStrategyTypeEnum { + // Enum describing possible bidding strategy types. + enum BiddingStrategyType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Commission is an automatic bidding strategy in which the advertiser pays + // a certain portion of the conversion value. + COMMISSION = 16; + + // Enhanced CPC is a bidding strategy that raises bids for clicks + // that seem more likely to lead to a conversion and lowers + // them for clicks where they seem less likely. + ENHANCED_CPC = 2; + + // Manual click based bidding where user pays per click. + MANUAL_CPC = 3; + + // Manual impression based bidding + // where user pays per thousand impressions. + MANUAL_CPM = 4; + + // A bidding strategy that pays a configurable amount per video view. + MANUAL_CPV = 13; + + // A bidding strategy that automatically maximizes number of conversions + // given a daily budget. + MAXIMIZE_CONVERSIONS = 10; + + // An automated bidding strategy that automatically sets bids to maximize + // revenue while spending your budget. + MAXIMIZE_CONVERSION_VALUE = 11; + + // Page-One Promoted bidding scheme, which sets max cpc bids to + // target impressions on page one or page one promoted slots on google.com. + // This enum value is deprecated. + PAGE_ONE_PROMOTED = 5; + + // Percent Cpc is bidding strategy where bids are a fraction of the + // advertised price for some good or service. + PERCENT_CPC = 12; + + // Target CPA is an automated bid strategy that sets bids + // to help get as many conversions as possible + // at the target cost-per-acquisition (CPA) you set. + TARGET_CPA = 6; + + // Target CPM is an automated bid strategy that sets bids to help get + // as many impressions as possible at the target cost per one thousand + // impressions (CPM) you set. + TARGET_CPM = 14; + + // An automated bidding strategy that sets bids so that a certain percentage + // of search ads are shown at the top of the first page (or other targeted + // location). + TARGET_IMPRESSION_SHARE = 15; + + // Target Outrank Share is an automated bidding strategy that sets bids + // based on the target fraction of auctions where the advertiser + // should outrank a specific competitor. + // This enum value is deprecated. + TARGET_OUTRANK_SHARE = 7; + + // Target ROAS is an automated bidding strategy + // that helps you maximize revenue while averaging + // a specific target Return On Average Spend (ROAS). + TARGET_ROAS = 8; + + // Target Spend is an automated bid strategy that sets your bids + // to help get as many clicks as possible within your budget. + TARGET_SPEND = 9; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/billing_setup_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/billing_setup_status.proto new file mode 100644 index 000000000..f2084bbca --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/billing_setup_status.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "BillingSetupStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing BillingSetup statuses. + +// Message describing BillingSetup statuses. +message BillingSetupStatusEnum { + // The possible statuses of a BillingSetup. + enum BillingSetupStatus { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The billing setup is pending approval. + PENDING = 2; + + // The billing setup has been approved but the corresponding first budget + // has not. This can only occur for billing setups configured for monthly + // invoicing. + APPROVED_HELD = 3; + + // The billing setup has been approved. + APPROVED = 4; + + // The billing setup was cancelled by the user prior to approval. + CANCELLED = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/brand_safety_suitability.proto b/third_party/googleapis/google/ads/googleads/v3/enums/brand_safety_suitability.proto new file mode 100644 index 000000000..d083fc6d9 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/brand_safety_suitability.proto @@ -0,0 +1,73 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "BrandSafetySuitabilityProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing brand safety suitability settings. + +// Container for enum with 3-Tier brand safety suitability control. +message BrandSafetySuitabilityEnum { + // 3-Tier brand safety suitability control. + enum BrandSafetySuitability { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // This option lets you show ads across all inventory on YouTube and video + // partners that meet our standards for monetization. This option may be an + // appropriate choice for brands that want maximum access to the full + // breadth of videos eligible for ads, including, for example, videos that + // have strong profanity in the context of comedy or a documentary, or + // excessive violence as featured in video games. + EXPANDED_INVENTORY = 2; + + // This option lets you show ads across a wide range of content that's + // appropriate for most brands, such as popular music videos, documentaries, + // and movie trailers. The content you can show ads on is based on YouTube's + // advertiser-friendly content guidelines that take into account, for + // example, the strength or frequency of profanity, or the appropriateness + // of subject matter like sensitive events. Ads won't show, for example, on + // content with repeated strong profanity, strong sexual content, or graphic + // violence. + STANDARD_INVENTORY = 3; + + // This option lets you show ads on a reduced range of content that's + // appropriate for brands with particularly strict guidelines around + // inappropriate language and sexual suggestiveness; above and beyond what + // YouTube's advertiser-friendly content guidelines address. The videos + // accessible in this sensitive category meet heightened requirements, + // especially for inappropriate language and sexual suggestiveness. For + // example, your ads will be excluded from showing on some of YouTube's most + // popular music videos and other pop culture content across YouTube and + // Google video partners. + LIMITED_INVENTORY = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/budget_delivery_method.proto b/third_party/googleapis/google/ads/googleads/v3/enums/budget_delivery_method.proto new file mode 100644 index 000000000..4fd6bee2e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/budget_delivery_method.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "BudgetDeliveryMethodProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Budget delivery methods. + +// Message describing Budget delivery methods. A delivery method determines the +// rate at which the Budget is spent. +message BudgetDeliveryMethodEnum { + // Possible delivery methods of a Budget. + enum BudgetDeliveryMethod { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The budget server will throttle serving evenly across + // the entire time period. + STANDARD = 2; + + // The budget server will not throttle serving, + // and ads will serve as fast as possible. + ACCELERATED = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/budget_period.proto b/third_party/googleapis/google/ads/googleads/v3/enums/budget_period.proto new file mode 100644 index 000000000..440d048ad --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/budget_period.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "BudgetPeriodProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Budget delivery methods. + +// Message describing Budget period. +message BudgetPeriodEnum { + // Possible period of a Budget. + enum BudgetPeriod { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Daily budget. + DAILY = 2; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/budget_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/budget_status.proto new file mode 100644 index 000000000..c9a85146c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/budget_status.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "BudgetStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Budget statuses + +// Message describing a Budget status +message BudgetStatusEnum { + // Possible statuses of a Budget. + enum BudgetStatus { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Budget is enabled. + ENABLED = 2; + + // Budget is removed. + REMOVED = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/budget_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/budget_type.proto new file mode 100644 index 000000000..8538fcc74 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/budget_type.proto @@ -0,0 +1,66 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "BudgetTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Budget types. + +// Describes Budget types. +message BudgetTypeEnum { + // Possible Budget types. + enum BudgetType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Budget type for standard Google Ads usage. + // Caps daily spend at two times the specified budget amount. + // Full details: https://support.google.com/google-ads/answer/6385083 + STANDARD = 2; + + // Budget type for Hotels Ads commission program. + // Full details: https://support.google.com/google-ads/answer/9243945 + // + // This type is only supported by campaigns with + // AdvertisingChannelType.HOTEL, BiddingStrategyType.COMMISSION and + // PaymentMode.CONVERSION_VALUE. + HOTEL_ADS_COMMISSION = 3; + + // Budget type with a fixed cost-per-acquisition (conversion). + // Full details: https://support.google.com/google-ads/answer/7528254 + // + // This type is only supported by campaigns with + // AdvertisingChannelType.DISPLAY (excluding + // AdvertisingChannelSubType.DISPLAY_GMAIL), + // BiddingStrategyType.TARGET_CPA and PaymentMode.CONVERSIONS. + FIXED_CPA = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/call_conversion_reporting_state.proto b/third_party/googleapis/google/ads/googleads/v3/enums/call_conversion_reporting_state.proto new file mode 100644 index 000000000..1d1d0aba3 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/call_conversion_reporting_state.proto @@ -0,0 +1,56 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "CallConversionReportingStateProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing call conversion reporting state. + +// Container for enum describing possible data types for call conversion +// reporting state. +message CallConversionReportingStateEnum { + // Possible data types for a call conversion action state. + enum CallConversionReportingState { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Call conversion action is disabled. + DISABLED = 2; + + // Call conversion action will use call conversion type set at the + // account level. + USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION = 3; + + // Call conversion action will use call conversion type set at the resource + // (call only ads/call extensions) level. + USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/call_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v3/enums/call_placeholder_field.proto new file mode 100644 index 000000000..58e024959 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/call_placeholder_field.proto @@ -0,0 +1,66 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "CallPlaceholderFieldProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Call placeholder fields. + +// Values for Call placeholder fields. +message CallPlaceholderFieldEnum { + // Possible values for Call placeholder fields. + enum CallPlaceholderField { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Data Type: STRING. The advertiser's phone number to append to the ad. + PHONE_NUMBER = 2; + + // Data Type: STRING. Uppercase two-letter country code of the advertiser's + // phone number. + COUNTRY_CODE = 3; + + // Data Type: BOOLEAN. Indicates whether call tracking is enabled. Default: + // true. + TRACKED = 4; + + // Data Type: INT64. The ID of an AdCallMetricsConversion object. This + // object contains the phoneCallDurationfield which is the minimum duration + // (in seconds) of a call to be considered a conversion. + CONVERSION_TYPE_ID = 5; + + // Data Type: STRING. Indicates whether this call extension uses its own + // call conversion setting or follows the account level setting. + // Valid values are: USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION and + // USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION. + CONVERSION_REPORTING_STATE = 6; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/callout_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v3/enums/callout_placeholder_field.proto new file mode 100644 index 000000000..49f0cb55b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/callout_placeholder_field.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "CalloutPlaceholderFieldProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Callout placeholder fields. + +// Values for Callout placeholder fields. +message CalloutPlaceholderFieldEnum { + // Possible values for Callout placeholder fields. + enum CalloutPlaceholderField { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Data Type: STRING. Callout text. + CALLOUT_TEXT = 2; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/campaign_criterion_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/campaign_criterion_status.proto new file mode 100644 index 000000000..8539b12f8 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/campaign_criterion_status.proto @@ -0,0 +1,55 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "CampaignCriterionStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing CampaignCriterion statuses. + +// Message describing CampaignCriterion statuses. +message CampaignCriterionStatusEnum { + // The possible statuses of a CampaignCriterion. + enum CampaignCriterionStatus { + // No value has been specified. + UNSPECIFIED = 0; + + // The received value is not known in this version. + // + // This is a response-only value. + UNKNOWN = 1; + + // The campaign criterion is enabled. + ENABLED = 2; + + // The campaign criterion is paused. + PAUSED = 3; + + // The campaign criterion is removed. + REMOVED = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/campaign_draft_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/campaign_draft_status.proto new file mode 100644 index 000000000..378068b37 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/campaign_draft_status.proto @@ -0,0 +1,65 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "CampaignDraftStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing campaign draft status. + +// Container for enum describing possible statuses of a campaign draft. +message CampaignDraftStatusEnum { + // Possible statuses of a campaign draft. + enum CampaignDraftStatus { + // The status has not been specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Initial state of the draft, the advertiser can start adding changes with + // no effect on serving. + PROPOSED = 2; + + // The campaign draft is removed. + REMOVED = 3; + + // Advertiser requested to promote draft's changes back into the original + // campaign. Advertiser can poll the long running operation returned by + // the promote action to see the status of the promotion. + PROMOTING = 5; + + // The process to merge changes in the draft back to the original campaign + // has completed successfully. + PROMOTED = 4; + + // The promotion failed after it was partially applied. Promote cannot be + // attempted again safely, so the issue must be corrected in the original + // campaign. + PROMOTE_FAILED = 6; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/campaign_experiment_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/campaign_experiment_status.proto new file mode 100644 index 000000000..6d21682bd --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/campaign_experiment_status.proto @@ -0,0 +1,77 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "CampaignExperimentStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing campaign experiment status. + +// Container for enum describing possible statuses of a campaign experiment. +message CampaignExperimentStatusEnum { + // Possible statuses of a campaign experiment. + enum CampaignExperimentStatus { + // The status has not been specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The experiment campaign is being initialized. + INITIALIZING = 2; + + // Initialization of the experiment campaign failed. + INITIALIZATION_FAILED = 8; + + // The experiment campaign is fully initialized. The experiment is currently + // running, scheduled to run in the future or has ended based on its + // end date. An experiment with the status INITIALIZING will be updated to + // ENABLED when it is fully created. + ENABLED = 3; + + // The experiment campaign was graduated to a stand-alone + // campaign, existing independently of the experiment. + GRADUATED = 4; + + // The experiment is removed. + REMOVED = 5; + + // The experiment's changes are being applied to the original campaign. + // The long running operation returned by the promote method can be polled + // to see the status of the promotion. + PROMOTING = 6; + + // Promote of the experiment campaign failed. + PROMOTION_FAILED = 9; + + // The changes of the experiment are promoted to their original campaign. + PROMOTED = 7; + + // The experiment was ended manually. It did not end based on its end date. + ENDED_MANUALLY = 10; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/campaign_experiment_traffic_split_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/campaign_experiment_traffic_split_type.proto new file mode 100644 index 000000000..a4514903e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/campaign_experiment_traffic_split_type.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "CampaignExperimentTrafficSplitTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing campaign experiment traffic split type. + +// Container for enum describing campaign experiment traffic split type. +message CampaignExperimentTrafficSplitTypeEnum { + // Enum of strategies for splitting traffic between base and experiment + // campaigns in campaign experiment. + enum CampaignExperimentTrafficSplitType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Traffic is randomly assigned to the base or experiment arm for each + // query, independent of previous assignments for the same user. + RANDOM_QUERY = 2; + + // Traffic is split using cookies to keep users in the same arm (base or + // experiment) of the experiment. + COOKIE = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/campaign_experiment_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/campaign_experiment_type.proto new file mode 100644 index 000000000..7d5ea246e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/campaign_experiment_type.proto @@ -0,0 +1,59 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "CampaignExperimentTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing campaign experiment type. + +// Container for enum describing campaign experiment type. +message CampaignExperimentTypeEnum { + // Indicates if this campaign is a normal campaign, + // a draft campaign, or an experiment campaign. + enum CampaignExperimentType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // This is a regular campaign. + BASE = 2; + + // This is a draft version of a campaign. + // It has some modifications from a base campaign, + // but it does not serve or accrue metrics. + DRAFT = 3; + + // This is an experiment version of a campaign. + // It has some modifications from a base campaign, + // and a percentage of traffic is being diverted + // from the BASE campaign to this experiment campaign. + EXPERIMENT = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/campaign_serving_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/campaign_serving_status.proto new file mode 100644 index 000000000..59f20a92f --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/campaign_serving_status.proto @@ -0,0 +1,61 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "CampaignServingStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Campaign serving statuses. + +// Message describing Campaign serving statuses. +message CampaignServingStatusEnum { + // Possible serving statuses of a campaign. + enum CampaignServingStatus { + // No value has been specified. + UNSPECIFIED = 0; + + // The received value is not known in this version. + // + // This is a response-only value. + UNKNOWN = 1; + + // Serving. + SERVING = 2; + + // None. + NONE = 3; + + // Ended. + ENDED = 4; + + // Pending. + PENDING = 5; + + // Suspended. + SUSPENDED = 6; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/campaign_shared_set_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/campaign_shared_set_status.proto new file mode 100644 index 000000000..348326d3c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/campaign_shared_set_status.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "CampaignSharedSetStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing campaign shared set statuses. + +// Container for enum describing types of campaign shared set statuses. +message CampaignSharedSetStatusEnum { + // Enum listing the possible campaign shared set statuses. + enum CampaignSharedSetStatus { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The campaign shared set is enabled. + ENABLED = 2; + + // The campaign shared set is removed and can no longer be used. + REMOVED = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/campaign_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/campaign_status.proto new file mode 100644 index 000000000..6cc32f61b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/campaign_status.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "CampaignStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing campaign status. + +// Container for enum describing possible statuses of a campaign. +message CampaignStatusEnum { + // Possible statuses of a campaign. + enum CampaignStatus { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Campaign is currently serving ads depending on budget information. + ENABLED = 2; + + // Campaign has been paused by the user. + PAUSED = 3; + + // Campaign has been removed. + REMOVED = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/change_status_operation.proto b/third_party/googleapis/google/ads/googleads/v3/enums/change_status_operation.proto new file mode 100644 index 000000000..7b5f4a53e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/change_status_operation.proto @@ -0,0 +1,54 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ChangeStatusOperationProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing the change status operations. + +// Container for enum describing operations for the ChangeStatus resource. +message ChangeStatusOperationEnum { + // Status of the changed resource + enum ChangeStatusOperation { + // No value has been specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents an unclassified resource unknown + // in this version. + UNKNOWN = 1; + + // The resource was created. + ADDED = 2; + + // The resource was modified. + CHANGED = 3; + + // The resource was removed. + REMOVED = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/change_status_resource_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/change_status_resource_type.proto new file mode 100644 index 000000000..b760d4d03 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/change_status_resource_type.proto @@ -0,0 +1,76 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ChangeStatusResourceTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing the resource types the ChangeStatus resource supports. + +// Container for enum describing supported resource types for the ChangeStatus +// resource. +message ChangeStatusResourceTypeEnum { + // Enum listing the resource types support by the ChangeStatus resource. + enum ChangeStatusResourceType { + // No value has been specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents an unclassified resource unknown + // in this version. + UNKNOWN = 1; + + // An AdGroup resource change. + AD_GROUP = 3; + + // An AdGroupAd resource change. + AD_GROUP_AD = 4; + + // An AdGroupCriterion resource change. + AD_GROUP_CRITERION = 5; + + // A Campaign resource change. + CAMPAIGN = 6; + + // A CampaignCriterion resource change. + CAMPAIGN_CRITERION = 7; + + // A Feed resource change. + FEED = 9; + + // A FeedItem resource change. + FEED_ITEM = 10; + + // An AdGroupFeed resource change. + AD_GROUP_FEED = 11; + + // A CampaignFeed resource change. + CAMPAIGN_FEED = 12; + + // An AdGroupBidModifier resource change. + AD_GROUP_BID_MODIFIER = 13; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/click_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/click_type.proto new file mode 100644 index 000000000..e5dec52c2 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/click_type.proto @@ -0,0 +1,203 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ClickTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing click types. + +// Container for enumeration of Google Ads click types. +message ClickTypeEnum { + // Enumerates Google Ads click types. + enum ClickType { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // App engagement ad deep link. + APP_DEEPLINK = 2; + + // Breadcrumbs. + BREADCRUMBS = 3; + + // Broadband Plan. + BROADBAND_PLAN = 4; + + // Manually dialed phone calls. + CALL_TRACKING = 5; + + // Phone calls. + CALLS = 6; + + // Click on engagement ad. + CLICK_ON_ENGAGEMENT_AD = 7; + + // Driving direction. + GET_DIRECTIONS = 8; + + // Get location details. + LOCATION_EXPANSION = 9; + + // Call. + LOCATION_FORMAT_CALL = 10; + + // Directions. + LOCATION_FORMAT_DIRECTIONS = 11; + + // Image(s). + LOCATION_FORMAT_IMAGE = 12; + + // Go to landing page. + LOCATION_FORMAT_LANDING_PAGE = 13; + + // Map. + LOCATION_FORMAT_MAP = 14; + + // Go to store info. + LOCATION_FORMAT_STORE_INFO = 15; + + // Text. + LOCATION_FORMAT_TEXT = 16; + + // Mobile phone calls. + MOBILE_CALL_TRACKING = 17; + + // Print offer. + OFFER_PRINTS = 18; + + // Other. + OTHER = 19; + + // Product plusbox offer. + PRODUCT_EXTENSION_CLICKS = 20; + + // Shopping - Product - Online. + PRODUCT_LISTING_AD_CLICKS = 21; + + // Sitelink. + SITELINKS = 22; + + // Show nearby locations. + STORE_LOCATOR = 23; + + // Headline. + URL_CLICKS = 25; + + // App store. + VIDEO_APP_STORE_CLICKS = 26; + + // Call-to-Action overlay. + VIDEO_CALL_TO_ACTION_CLICKS = 27; + + // Cards. + VIDEO_CARD_ACTION_HEADLINE_CLICKS = 28; + + // End cap. + VIDEO_END_CAP_CLICKS = 29; + + // Website. + VIDEO_WEBSITE_CLICKS = 30; + + // Visual Sitelinks. + VISUAL_SITELINKS = 31; + + // Wireless Plan. + WIRELESS_PLAN = 32; + + // Shopping - Product - Local. + PRODUCT_LISTING_AD_LOCAL = 33; + + // Shopping - Product - MultiChannel Local. + PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL = 34; + + // Shopping - Product - MultiChannel Online. + PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE = 35; + + // Shopping - Product - Coupon. + PRODUCT_LISTING_ADS_COUPON = 36; + + // Shopping - Product - Sell on Google. + PRODUCT_LISTING_AD_TRANSACTABLE = 37; + + // Shopping - Product - App engagement ad deep link. + PRODUCT_AD_APP_DEEPLINK = 38; + + // Shopping - Showcase - Category. + SHOWCASE_AD_CATEGORY_LINK = 39; + + // Shopping - Showcase - Local storefront. + SHOWCASE_AD_LOCAL_STOREFRONT_LINK = 40; + + // Shopping - Showcase - Online product. + SHOWCASE_AD_ONLINE_PRODUCT_LINK = 42; + + // Shopping - Showcase - Local product. + SHOWCASE_AD_LOCAL_PRODUCT_LINK = 43; + + // Promotion Extension. + PROMOTION_EXTENSION = 44; + + // Ad Headline. + SWIPEABLE_GALLERY_AD_HEADLINE = 45; + + // Swipes. + SWIPEABLE_GALLERY_AD_SWIPES = 46; + + // See More. + SWIPEABLE_GALLERY_AD_SEE_MORE = 47; + + // Sitelink 1. + SWIPEABLE_GALLERY_AD_SITELINK_ONE = 48; + + // Sitelink 2. + SWIPEABLE_GALLERY_AD_SITELINK_TWO = 49; + + // Sitelink 3. + SWIPEABLE_GALLERY_AD_SITELINK_THREE = 50; + + // Sitelink 4. + SWIPEABLE_GALLERY_AD_SITELINK_FOUR = 51; + + // Sitelink 5. + SWIPEABLE_GALLERY_AD_SITELINK_FIVE = 52; + + // Hotel price. + HOTEL_PRICE = 53; + + // Price Extension. + PRICE_EXTENSION = 54; + + // Book on Google hotel room selection. + HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION = 55; + + // Shopping - Comparison Listing. + SHOPPING_COMPARISON_LISTING = 56; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/content_label_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/content_label_type.proto new file mode 100644 index 000000000..53a122695 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/content_label_type.proto @@ -0,0 +1,89 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ContentLabelTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing content label types. + +// Container for enum describing content label types in ContentLabel. +message ContentLabelTypeEnum { + // Enum listing the content label types supported by ContentLabel criterion. + enum ContentLabelType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Sexually suggestive content. + SEXUALLY_SUGGESTIVE = 2; + + // Below the fold placement. + BELOW_THE_FOLD = 3; + + // Parked domain. + PARKED_DOMAIN = 4; + + // Juvenile, gross & bizarre content. + JUVENILE = 6; + + // Profanity & rough language. + PROFANITY = 7; + + // Death & tragedy. + TRAGEDY = 8; + + // Video. + VIDEO = 9; + + // Content rating: G. + VIDEO_RATING_DV_G = 10; + + // Content rating: PG. + VIDEO_RATING_DV_PG = 11; + + // Content rating: T. + VIDEO_RATING_DV_T = 12; + + // Content rating: MA. + VIDEO_RATING_DV_MA = 13; + + // Content rating: not yet rated. + VIDEO_NOT_YET_RATED = 14; + + // Embedded video. + EMBEDDED_VIDEO = 15; + + // Live streaming video. + LIVE_STREAMING_VIDEO = 16; + + // Sensitive social issues. + SOCIAL_ISSUES = 17; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/conversion_action_category.proto b/third_party/googleapis/google/ads/googleads/v3/enums/conversion_action_category.proto new file mode 100644 index 000000000..ef4127e9c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/conversion_action_category.proto @@ -0,0 +1,106 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ConversionActionCategoryProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Container for enum describing the category of conversions that are associated +// with a ConversionAction. +message ConversionActionCategoryEnum { + // The category of conversions that are associated with a ConversionAction. + enum ConversionActionCategory { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Default category. + DEFAULT = 2; + + // User visiting a page. + PAGE_VIEW = 3; + + // Purchase, sales, or "order placed" event. + PURCHASE = 4; + + // Signup user action. + SIGNUP = 5; + + // Lead-generating action. + LEAD = 6; + + // Software download action (as for an app). + DOWNLOAD = 7; + + // The addition of items to a shopping cart or bag on an advertiser site. + ADD_TO_CART = 8; + + // When someone enters the checkout flow on an advertiser site. + BEGIN_CHECKOUT = 9; + + // The start of a paid subscription for a product or service. + SUBSCRIBE_PAID = 10; + + // A call to indicate interest in an advertiser's offering. + PHONE_CALL_LEAD = 11; + + // A lead conversion imported from an external source into Google Ads. + IMPORTED_LEAD = 12; + + // A submission of a form on an advertiser site indicating business + // interest. + SUBMIT_LEAD_FORM = 13; + + // A booking of an appointment with an advertiser's business. + BOOK_APPOINTMENT = 14; + + // A quote or price estimate request. + REQUEST_QUOTE = 15; + + // A search for an advertiser's business location with intention to visit. + GET_DIRECTIONS = 16; + + // A click to an advertiser's partner's site. + OUTBOUND_CLICK = 17; + + // A call, SMS, email, chat or other type of contact to an advertiser. + CONTACT = 18; + + // A website engagement event such as long site time or a Google Analytics + // (GA) Smart Goal. Intended to be used for GA, Firebase, GA Gold goal + // imports. + ENGAGEMENT = 19; + + // A visit to a physical store location. + STORE_VISIT = 20; + + // A sale occurring in a physical store. + STORE_SALE = 21; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/conversion_action_counting_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/conversion_action_counting_type.proto new file mode 100644 index 000000000..a2721fece --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/conversion_action_counting_type.proto @@ -0,0 +1,52 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ConversionActionCountingTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing conversion action counting type. + +// Container for enum describing the conversion deduplication mode for +// conversion optimizer. +message ConversionActionCountingTypeEnum { + // Indicates how conversions for this action will be counted. For more + // information, see https://support.google.com/google-ads/answer/3438531. + enum ConversionActionCountingType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Count only one conversion per click. + ONE_PER_CLICK = 2; + + // Count all conversions per click. + MANY_PER_CLICK = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/conversion_action_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/conversion_action_status.proto new file mode 100644 index 000000000..c30e95816 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/conversion_action_status.proto @@ -0,0 +1,54 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ConversionActionStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing conversion action status. + +// Container for enum describing possible statuses of a conversion action. +message ConversionActionStatusEnum { + // Possible statuses of a conversion action. + enum ConversionActionStatus { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Conversions will be recorded. + ENABLED = 2; + + // Conversions will not be recorded. + REMOVED = 3; + + // Conversions will not be recorded and the conversion action will not + // appear in the UI. + HIDDEN = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/conversion_action_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/conversion_action_type.proto new file mode 100644 index 000000000..70878cb9a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/conversion_action_type.proto @@ -0,0 +1,73 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ConversionActionTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing conversion action type. + +// Container for enum describing possible types of a conversion action. +message ConversionActionTypeEnum { + // Possible types of a conversion action. + enum ConversionActionType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Conversions that occur when a user clicks on an ad's call extension. + AD_CALL = 2; + + // Conversions that occur when a user on a mobile device clicks a phone + // number. + CLICK_TO_CALL = 3; + + // Conversions that occur when a user downloads a mobile app from the Google + // Play Store. + GOOGLE_PLAY_DOWNLOAD = 4; + + // Conversions that occur when a user makes a purchase in an app through + // Android billing. + GOOGLE_PLAY_IN_APP_PURCHASE = 5; + + // Call conversions that are tracked by the advertiser and uploaded. + UPLOAD_CALLS = 6; + + // Conversions that are tracked by the advertiser and uploaded with + // attributed clicks. + UPLOAD_CLICKS = 7; + + // Conversions that occur on a webpage. + WEBPAGE = 8; + + // Conversions that occur when a user calls a dynamically-generated phone + // number from an advertiser's website. + WEBSITE_CALL = 9; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/conversion_adjustment_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/conversion_adjustment_type.proto new file mode 100644 index 000000000..e225309e6 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/conversion_adjustment_type.proto @@ -0,0 +1,52 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ConversionAdjustmentTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing conversion adjustment type. + +// Container for enum describing conversion adjustment types. +message ConversionAdjustmentTypeEnum { + // The different actions advertisers can take to adjust the conversions that + // they already reported. Retractions negate a conversion. Restatements change + // the value of a conversion. + enum ConversionAdjustmentType { + // Not specified. + UNSPECIFIED = 0; + + // Represents value unknown in this version. + UNKNOWN = 1; + + // Negates a conversion so that its total value and count are both zero. + RETRACTION = 2; + + // Changes the value of a conversion. + RESTATEMENT = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/conversion_attribution_event_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/conversion_attribution_event_type.proto new file mode 100644 index 000000000..fe02d9424 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/conversion_attribution_event_type.proto @@ -0,0 +1,48 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ConversionAttributionEventTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Container for enum indicating the event type the conversion is attributed to. +message ConversionAttributionEventTypeEnum { + // The event type of conversions that are attributed to. + enum ConversionAttributionEventType { + // Not specified. + UNSPECIFIED = 0; + + // Represents value unknown in this version. + UNKNOWN = 1; + + // The conversion is attributed to an impression. + IMPRESSION = 2; + + // The conversion is attributed to an interaction. + INTERACTION = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/conversion_lag_bucket.proto b/third_party/googleapis/google/ads/googleads/v3/enums/conversion_lag_bucket.proto new file mode 100644 index 000000000..2f446381e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/conversion_lag_bucket.proto @@ -0,0 +1,117 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ConversionLagBucketProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Container for enum representing the number of days between impression and +// conversion. +message ConversionLagBucketEnum { + // Enum representing the number of days between impression and conversion. + enum ConversionLagBucket { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Conversion lag bucket from 0 to 1 day. 0 day is included, 1 day is not. + LESS_THAN_ONE_DAY = 2; + + // Conversion lag bucket from 1 to 2 days. 1 day is included, 2 days is not. + ONE_TO_TWO_DAYS = 3; + + // Conversion lag bucket from 2 to 3 days. 2 days is included, + // 3 days is not. + TWO_TO_THREE_DAYS = 4; + + // Conversion lag bucket from 3 to 4 days. 3 days is included, + // 4 days is not. + THREE_TO_FOUR_DAYS = 5; + + // Conversion lag bucket from 4 to 5 days. 4 days is included, + // 5 days is not. + FOUR_TO_FIVE_DAYS = 6; + + // Conversion lag bucket from 5 to 6 days. 5 days is included, + // 6 days is not. + FIVE_TO_SIX_DAYS = 7; + + // Conversion lag bucket from 6 to 7 days. 6 days is included, + // 7 days is not. + SIX_TO_SEVEN_DAYS = 8; + + // Conversion lag bucket from 7 to 8 days. 7 days is included, + // 8 days is not. + SEVEN_TO_EIGHT_DAYS = 9; + + // Conversion lag bucket from 8 to 9 days. 8 days is included, + // 9 days is not. + EIGHT_TO_NINE_DAYS = 10; + + // Conversion lag bucket from 9 to 10 days. 9 days is included, + // 10 days is not. + NINE_TO_TEN_DAYS = 11; + + // Conversion lag bucket from 10 to 11 days. 10 days is included, + // 11 days is not. + TEN_TO_ELEVEN_DAYS = 12; + + // Conversion lag bucket from 11 to 12 days. 11 days is included, + // 12 days is not. + ELEVEN_TO_TWELVE_DAYS = 13; + + // Conversion lag bucket from 12 to 13 days. 12 days is included, + // 13 days is not. + TWELVE_TO_THIRTEEN_DAYS = 14; + + // Conversion lag bucket from 13 to 14 days. 13 days is included, + // 14 days is not. + THIRTEEN_TO_FOURTEEN_DAYS = 15; + + // Conversion lag bucket from 14 to 21 days. 14 days is included, + // 21 days is not. + FOURTEEN_TO_TWENTY_ONE_DAYS = 16; + + // Conversion lag bucket from 21 to 30 days. 21 days is included, + // 30 days is not. + TWENTY_ONE_TO_THIRTY_DAYS = 17; + + // Conversion lag bucket from 30 to 45 days. 30 days is included, + // 45 days is not. + THIRTY_TO_FORTY_FIVE_DAYS = 18; + + // Conversion lag bucket from 45 to 60 days. 45 days is included, + // 60 days is not. + FORTY_FIVE_TO_SIXTY_DAYS = 19; + + // Conversion lag bucket from 60 to 90 days. 60 days is included, + // 90 days is not. + SIXTY_TO_NINETY_DAYS = 20; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/conversion_or_adjustment_lag_bucket.proto b/third_party/googleapis/google/ads/googleads/v3/enums/conversion_or_adjustment_lag_bucket.proto new file mode 100644 index 000000000..48d49728f --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/conversion_or_adjustment_lag_bucket.proto @@ -0,0 +1,206 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ConversionOrAdjustmentLagBucketProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Container for enum representing the number of days between the impression and +// the conversion or between the impression and adjustments to the conversion. +message ConversionOrAdjustmentLagBucketEnum { + // Enum representing the number of days between the impression and the + // conversion or between the impression and adjustments to the conversion. + enum ConversionOrAdjustmentLagBucket { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Conversion lag bucket from 0 to 1 day. 0 day is included, 1 day is not. + CONVERSION_LESS_THAN_ONE_DAY = 2; + + // Conversion lag bucket from 1 to 2 days. 1 day is included, 2 days is not. + CONVERSION_ONE_TO_TWO_DAYS = 3; + + // Conversion lag bucket from 2 to 3 days. 2 days is included, + // 3 days is not. + CONVERSION_TWO_TO_THREE_DAYS = 4; + + // Conversion lag bucket from 3 to 4 days. 3 days is included, + // 4 days is not. + CONVERSION_THREE_TO_FOUR_DAYS = 5; + + // Conversion lag bucket from 4 to 5 days. 4 days is included, + // 5 days is not. + CONVERSION_FOUR_TO_FIVE_DAYS = 6; + + // Conversion lag bucket from 5 to 6 days. 5 days is included, + // 6 days is not. + CONVERSION_FIVE_TO_SIX_DAYS = 7; + + // Conversion lag bucket from 6 to 7 days. 6 days is included, + // 7 days is not. + CONVERSION_SIX_TO_SEVEN_DAYS = 8; + + // Conversion lag bucket from 7 to 8 days. 7 days is included, + // 8 days is not. + CONVERSION_SEVEN_TO_EIGHT_DAYS = 9; + + // Conversion lag bucket from 8 to 9 days. 8 days is included, + // 9 days is not. + CONVERSION_EIGHT_TO_NINE_DAYS = 10; + + // Conversion lag bucket from 9 to 10 days. 9 days is included, + // 10 days is not. + CONVERSION_NINE_TO_TEN_DAYS = 11; + + // Conversion lag bucket from 10 to 11 days. 10 days is included, + // 11 days is not. + CONVERSION_TEN_TO_ELEVEN_DAYS = 12; + + // Conversion lag bucket from 11 to 12 days. 11 days is included, + // 12 days is not. + CONVERSION_ELEVEN_TO_TWELVE_DAYS = 13; + + // Conversion lag bucket from 12 to 13 days. 12 days is included, + // 13 days is not. + CONVERSION_TWELVE_TO_THIRTEEN_DAYS = 14; + + // Conversion lag bucket from 13 to 14 days. 13 days is included, + // 14 days is not. + CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS = 15; + + // Conversion lag bucket from 14 to 21 days. 14 days is included, + // 21 days is not. + CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS = 16; + + // Conversion lag bucket from 21 to 30 days. 21 days is included, + // 30 days is not. + CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS = 17; + + // Conversion lag bucket from 30 to 45 days. 30 days is included, + // 45 days is not. + CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS = 18; + + // Conversion lag bucket from 45 to 60 days. 45 days is included, + // 60 days is not. + CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS = 19; + + // Conversion lag bucket from 60 to 90 days. 60 days is included, + // 90 days is not. + CONVERSION_SIXTY_TO_NINETY_DAYS = 20; + + // Conversion adjustment lag bucket from 0 to 1 day. 0 day is included, + // 1 day is not. + ADJUSTMENT_LESS_THAN_ONE_DAY = 21; + + // Conversion adjustment lag bucket from 1 to 2 days. 1 day is included, + // 2 days is not. + ADJUSTMENT_ONE_TO_TWO_DAYS = 22; + + // Conversion adjustment lag bucket from 2 to 3 days. 2 days is included, + // 3 days is not. + ADJUSTMENT_TWO_TO_THREE_DAYS = 23; + + // Conversion adjustment lag bucket from 3 to 4 days. 3 days is included, + // 4 days is not. + ADJUSTMENT_THREE_TO_FOUR_DAYS = 24; + + // Conversion adjustment lag bucket from 4 to 5 days. 4 days is included, + // 5 days is not. + ADJUSTMENT_FOUR_TO_FIVE_DAYS = 25; + + // Conversion adjustment lag bucket from 5 to 6 days. 5 days is included, + // 6 days is not. + ADJUSTMENT_FIVE_TO_SIX_DAYS = 26; + + // Conversion adjustment lag bucket from 6 to 7 days. 6 days is included, + // 7 days is not. + ADJUSTMENT_SIX_TO_SEVEN_DAYS = 27; + + // Conversion adjustment lag bucket from 7 to 8 days. 7 days is included, + // 8 days is not. + ADJUSTMENT_SEVEN_TO_EIGHT_DAYS = 28; + + // Conversion adjustment lag bucket from 8 to 9 days. 8 days is included, + // 9 days is not. + ADJUSTMENT_EIGHT_TO_NINE_DAYS = 29; + + // Conversion adjustment lag bucket from 9 to 10 days. 9 days is included, + // 10 days is not. + ADJUSTMENT_NINE_TO_TEN_DAYS = 30; + + // Conversion adjustment lag bucket from 10 to 11 days. 10 days is included, + // 11 days is not. + ADJUSTMENT_TEN_TO_ELEVEN_DAYS = 31; + + // Conversion adjustment lag bucket from 11 to 12 days. 11 days is included, + // 12 days is not. + ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS = 32; + + // Conversion adjustment lag bucket from 12 to 13 days. 12 days is included, + // 13 days is not. + ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS = 33; + + // Conversion adjustment lag bucket from 13 to 14 days. 13 days is included, + // 14 days is not. + ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS = 34; + + // Conversion adjustment lag bucket from 14 to 21 days. 14 days is included, + // 21 days is not. + ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS = 35; + + // Conversion adjustment lag bucket from 21 to 30 days. 21 days is included, + // 30 days is not. + ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS = 36; + + // Conversion adjustment lag bucket from 30 to 45 days. 30 days is included, + // 45 days is not. + ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS = 37; + + // Conversion adjustment lag bucket from 45 to 60 days. 45 days is included, + // 60 days is not. + ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS = 38; + + // Conversion adjustment lag bucket from 60 to 90 days. 60 days is included, + // 90 days is not. + ADJUSTMENT_SIXTY_TO_NINETY_DAYS = 39; + + // Conversion adjustment lag bucket from 90 to 145 days. 90 days is + // included, 145 days is not. + ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS = 40; + + // Conversion lag bucket UNKNOWN. This is for dates before conversion lag + // bucket was available in Google Ads. + CONVERSION_UNKNOWN = 41; + + // Conversion adjustment lag bucket UNKNOWN. This is for dates before + // conversion adjustment lag bucket was available in Google Ads. + ADJUSTMENT_UNKNOWN = 42; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/criterion_category_channel_availability_mode.proto b/third_party/googleapis/google/ads/googleads/v3/enums/criterion_category_channel_availability_mode.proto new file mode 100644 index 000000000..ce04a6b09 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/criterion_category_channel_availability_mode.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "CriterionCategoryChannelAvailabilityModeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing the criterion category channel availability mode. + +// Describes channel availability mode for a criterion availability - whether +// the availability is meant to include all advertising channels, or a +// particular channel with all its channel subtypes, or a channel with a certain +// subset of channel subtypes. +message CriterionCategoryChannelAvailabilityModeEnum { + // Enum containing the possible CriterionCategoryChannelAvailabilityMode. + enum CriterionCategoryChannelAvailabilityMode { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The category is available to campaigns of all channel types and subtypes. + ALL_CHANNELS = 2; + + // The category is available to campaigns of a specific channel type, + // including all subtypes under it. + CHANNEL_TYPE_AND_ALL_SUBTYPES = 3; + + // The category is available to campaigns of a specific channel type and + // subtype(s). + CHANNEL_TYPE_AND_SUBSET_SUBTYPES = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/criterion_category_locale_availability_mode.proto b/third_party/googleapis/google/ads/googleads/v3/enums/criterion_category_locale_availability_mode.proto new file mode 100644 index 000000000..6d8691516 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/criterion_category_locale_availability_mode.proto @@ -0,0 +1,61 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "CriterionCategoryLocaleAvailabilityModeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing the criterion category locale availability mode. + +// Describes locale availability mode for a criterion availability - whether +// it's available globally, or a particular country with all languages, or a +// particular language with all countries, or a country-language pair. +message CriterionCategoryLocaleAvailabilityModeEnum { + // Enum containing the possible CriterionCategoryLocaleAvailabilityMode. + enum CriterionCategoryLocaleAvailabilityMode { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The category is available to campaigns of all locales. + ALL_LOCALES = 2; + + // The category is available to campaigns within a list of countries, + // regardless of language. + COUNTRY_AND_ALL_LANGUAGES = 3; + + // The category is available to campaigns within a list of languages, + // regardless of country. + LANGUAGE_AND_ALL_COUNTRIES = 4; + + // The category is available to campaigns within a list of country, language + // pairs. + COUNTRY_AND_LANGUAGE = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/criterion_system_serving_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/criterion_system_serving_status.proto new file mode 100644 index 000000000..e6b30ec14 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/criterion_system_serving_status.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "CriterionSystemServingStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing approval status for the criterion. + +// Container for enum describing possible criterion system serving statuses. +message CriterionSystemServingStatusEnum { + // Enumerates criterion system serving statuses. + enum CriterionSystemServingStatus { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // Eligible. + ELIGIBLE = 2; + + // Low search volume. + RARELY_SERVED = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/criterion_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/criterion_type.proto new file mode 100644 index 000000000..2ce579917 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/criterion_type.proto @@ -0,0 +1,134 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "CriterionTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing criteria types. + +// The possible types of a criterion. +message CriterionTypeEnum { + // Enum describing possible criterion types. + enum CriterionType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Keyword. e.g. 'mars cruise'. + KEYWORD = 2; + + // Placement, aka Website. e.g. 'www.flowers4sale.com' + PLACEMENT = 3; + + // Mobile application categories to target. + MOBILE_APP_CATEGORY = 4; + + // Mobile applications to target. + MOBILE_APPLICATION = 5; + + // Devices to target. + DEVICE = 6; + + // Locations to target. + LOCATION = 7; + + // Listing groups to target. + LISTING_GROUP = 8; + + // Ad Schedule. + AD_SCHEDULE = 9; + + // Age range. + AGE_RANGE = 10; + + // Gender. + GENDER = 11; + + // Income Range. + INCOME_RANGE = 12; + + // Parental status. + PARENTAL_STATUS = 13; + + // YouTube Video. + YOUTUBE_VIDEO = 14; + + // YouTube Channel. + YOUTUBE_CHANNEL = 15; + + // User list. + USER_LIST = 16; + + // Proximity. + PROXIMITY = 17; + + // A topic target on the display network (e.g. "Pets & Animals"). + TOPIC = 18; + + // Listing scope to target. + LISTING_SCOPE = 19; + + // Language. + LANGUAGE = 20; + + // IpBlock. + IP_BLOCK = 21; + + // Content Label for category exclusion. + CONTENT_LABEL = 22; + + // Carrier. + CARRIER = 23; + + // A category the user is interested in. + USER_INTEREST = 24; + + // Webpage criterion for dynamic search ads. + WEBPAGE = 25; + + // Operating system version. + OPERATING_SYSTEM_VERSION = 26; + + // App payment model. + APP_PAYMENT_MODEL = 27; + + // Mobile device. + MOBILE_DEVICE = 28; + + // Custom affinity. + CUSTOM_AFFINITY = 29; + + // Custom intent. + CUSTOM_INTENT = 30; + + // Location group. + LOCATION_GROUP = 31; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/custom_interest_member_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/custom_interest_member_type.proto new file mode 100644 index 000000000..cd05e545c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/custom_interest_member_type.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "CustomInterestMemberTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing custom interest member type. + +// The types of custom interest member, either KEYWORD or URL. +message CustomInterestMemberTypeEnum { + // Enum containing possible custom interest member types. + enum CustomInterestMemberType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Custom interest member type KEYWORD. + KEYWORD = 2; + + // Custom interest member type URL. + URL = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/custom_interest_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/custom_interest_status.proto new file mode 100644 index 000000000..24dc1c141 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/custom_interest_status.proto @@ -0,0 +1,51 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "CustomInterestStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing custom interest status. + +// The status of custom interest. +message CustomInterestStatusEnum { + // Enum containing possible custom interest types. + enum CustomInterestStatus { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Enabled status - custom interest is enabled and can be targeted to. + ENABLED = 2; + + // Removed status - custom interest is removed and cannot be used for + // targeting. + REMOVED = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/custom_interest_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/custom_interest_type.proto new file mode 100644 index 000000000..35ea338fd --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/custom_interest_type.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "CustomInterestTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing custom interest type. + +// The types of custom interest. +message CustomInterestTypeEnum { + // Enum containing possible custom interest types. + enum CustomInterestType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Allows brand advertisers to define custom affinity audience lists. + CUSTOM_AFFINITY = 2; + + // Allows advertisers to define custom intent audience lists. + CUSTOM_INTENT = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/custom_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v3/enums/custom_placeholder_field.proto new file mode 100644 index 000000000..e3152c21f --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/custom_placeholder_field.proto @@ -0,0 +1,129 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "CustomPlaceholderFieldProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Custom placeholder fields. + +// Values for Custom placeholder fields. +// For more information about dynamic remarketing feeds, see +// https://support.google.com/google-ads/answer/6053288. +message CustomPlaceholderFieldEnum { + // Possible values for Custom placeholder fields. + enum CustomPlaceholderField { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Data Type: STRING. Required. Combination ID and ID2 must be unique per + // offer. + ID = 2; + + // Data Type: STRING. Combination ID and ID2 must be unique per offer. + ID2 = 3; + + // Data Type: STRING. Required. Main headline with product name to be shown + // in dynamic ad. + ITEM_TITLE = 4; + + // Data Type: STRING. Optional text to be shown in the image ad. + ITEM_SUBTITLE = 5; + + // Data Type: STRING. Optional description of the product to be shown in the + // ad. + ITEM_DESCRIPTION = 6; + + // Data Type: STRING. Full address of your offer or service, including + // postal code. This will be used to identify the closest product to the + // user when there are multiple offers in the feed that are relevant to the + // user. + ITEM_ADDRESS = 7; + + // Data Type: STRING. Price to be shown in the ad. + // Example: "100.00 USD" + PRICE = 8; + + // Data Type: STRING. Formatted price to be shown in the ad. + // Example: "Starting at $100.00 USD", "$80 - $100" + FORMATTED_PRICE = 9; + + // Data Type: STRING. Sale price to be shown in the ad. + // Example: "80.00 USD" + SALE_PRICE = 10; + + // Data Type: STRING. Formatted sale price to be shown in the ad. + // Example: "On sale for $80.00", "$60 - $80" + FORMATTED_SALE_PRICE = 11; + + // Data Type: URL. Image to be displayed in the ad. Highly recommended for + // image ads. + IMAGE_URL = 12; + + // Data Type: STRING. Used as a recommendation engine signal to serve items + // in the same category. + ITEM_CATEGORY = 13; + + // Data Type: URL_LIST. Final URLs for the ad when using Upgraded + // URLs. User will be redirected to these URLs when they click on an ad, or + // when they click on a specific product for ads that have multiple + // products. + FINAL_URLS = 14; + + // Data Type: URL_LIST. Final mobile URLs for the ad when using Upgraded + // URLs. + FINAL_MOBILE_URLS = 15; + + // Data Type: URL. Tracking template for the ad when using Upgraded URLs. + TRACKING_URL = 16; + + // Data Type: STRING_LIST. Keywords used for product retrieval. + CONTEXTUAL_KEYWORDS = 17; + + // Data Type: STRING. Android app link. Must be formatted as: + // android-app://{package_id}/{scheme}/{host_path}. + // The components are defined as follows: + // package_id: app ID as specified in Google Play. + // scheme: the scheme to pass to the application. Can be HTTP, or a custom + // scheme. + // host_path: identifies the specific content within your application. + ANDROID_APP_LINK = 18; + + // Data Type: STRING_LIST. List of recommended IDs to show together with + // this item. + SIMILAR_IDS = 19; + + // Data Type: STRING. iOS app link. + IOS_APP_LINK = 20; + + // Data Type: INT64. iOS app store ID. + IOS_APP_STORE_ID = 21; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/customer_match_upload_key_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/customer_match_upload_key_type.proto new file mode 100644 index 000000000..ae40149f8 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/customer_match_upload_key_type.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "CustomerMatchUploadKeyTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Indicates what type of data are the user list's members matched from. +message CustomerMatchUploadKeyTypeEnum { + // Enum describing possible customer match upload key types. + enum CustomerMatchUploadKeyType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Members are matched from customer info such as email address, phone + // number or physical address. + CONTACT_INFO = 2; + + // Members are matched from a user id generated and assigned by the + // advertiser. + CRM_ID = 3; + + // Members are matched from mobile advertising ids. + MOBILE_ADVERTISING_ID = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/customer_pay_per_conversion_eligibility_failure_reason.proto b/third_party/googleapis/google/ads/googleads/v3/enums/customer_pay_per_conversion_eligibility_failure_reason.proto new file mode 100644 index 000000000..7d3b11c40 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/customer_pay_per_conversion_eligibility_failure_reason.proto @@ -0,0 +1,68 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "CustomerPayPerConversionEligibilityFailureReasonProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing pay per conversion eligibility failure reasons. + +// Container for enum describing reasons why a customer is not eligible to use +// PaymentMode.CONVERSIONS. +message CustomerPayPerConversionEligibilityFailureReasonEnum { + // Enum describing possible reasons a customer is not eligible to use + // PaymentMode.CONVERSIONS. + enum CustomerPayPerConversionEligibilityFailureReason { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Customer does not have enough conversions. + NOT_ENOUGH_CONVERSIONS = 2; + + // Customer's conversion lag is too high. + CONVERSION_LAG_TOO_HIGH = 3; + + // Customer uses shared budgets. + HAS_CAMPAIGN_WITH_SHARED_BUDGET = 4; + + // Customer has conversions with ConversionActionType.UPLOAD_CLICKS. + HAS_UPLOAD_CLICKS_CONVERSION = 5; + + // Customer's average daily spend is too high. + AVERAGE_DAILY_SPEND_TOO_HIGH = 6; + + // Customer's eligibility has not yet been calculated by the Google Ads + // backend. Check back soon. + ANALYSIS_NOT_COMPLETE = 7; + + // Customer is not eligible due to other reasons. + OTHER = 8; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/data_driven_model_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/data_driven_model_status.proto new file mode 100644 index 000000000..4ce19402c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/data_driven_model_status.proto @@ -0,0 +1,62 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "DataDrivenModelStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing data-driven model status. + +// Container for enum indicating data driven model status. +message DataDrivenModelStatusEnum { + // Enumerates data driven model statuses. + enum DataDrivenModelStatus { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The data driven model is available. + AVAILABLE = 2; + + // The data driven model is stale. It hasn't been updated for at least 7 + // days. It is still being used, but will become expired if it does not get + // updated for 30 days. + STALE = 3; + + // The data driven model expired. It hasn't been updated for at least 30 + // days and cannot be used. Most commonly this is because there hasn't been + // the required number of events in a recent 30-day period. + EXPIRED = 4; + + // The data driven model has never been generated. Most commonly this is + // because there has never been the required number of events in any 30-day + // period. + NEVER_GENERATED = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/day_of_week.proto b/third_party/googleapis/google/ads/googleads/v3/enums/day_of_week.proto new file mode 100644 index 000000000..e10fca7d4 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/day_of_week.proto @@ -0,0 +1,65 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "DayOfWeekProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing days of week. + +// Container for enumeration of days of the week, e.g., "Monday". +message DayOfWeekEnum { + // Enumerates days of the week, e.g., "Monday". + enum DayOfWeek { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // Monday. + MONDAY = 2; + + // Tuesday. + TUESDAY = 3; + + // Wednesday. + WEDNESDAY = 4; + + // Thursday. + THURSDAY = 5; + + // Friday. + FRIDAY = 6; + + // Saturday. + SATURDAY = 7; + + // Sunday. + SUNDAY = 8; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/device.proto b/third_party/googleapis/google/ads/googleads/v3/enums/device.proto new file mode 100644 index 000000000..547a06aae --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/device.proto @@ -0,0 +1,59 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "DeviceProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing devices. + +// Container for enumeration of Google Ads devices available for targeting. +message DeviceEnum { + // Enumerates Google Ads devices available for targeting. + enum Device { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // Mobile devices with full browsers. + MOBILE = 2; + + // Tablets with full browsers. + TABLET = 3; + + // Computers. + DESKTOP = 4; + + // Smart TVs and game consoles. + CONNECTED_TV = 6; + + // Other device types. + OTHER = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/display_ad_format_setting.proto b/third_party/googleapis/google/ads/googleads/v3/enums/display_ad_format_setting.proto new file mode 100644 index 000000000..47394a102 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/display_ad_format_setting.proto @@ -0,0 +1,54 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "DisplayAdFormatSettingProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing display ad format settings. + +// Container for display ad format settings. +message DisplayAdFormatSettingEnum { + // Enumerates display ad format settings. + enum DisplayAdFormatSetting { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // Text, image and native formats. + ALL_FORMATS = 2; + + // Text and image formats. + NON_NATIVE = 3; + + // Native format, i.e. the format rendering is controlled by the publisher + // and not by Google. + NATIVE = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/display_upload_product_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/display_upload_product_type.proto new file mode 100644 index 000000000..2ed71ae4b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/display_upload_product_type.proto @@ -0,0 +1,97 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "DisplayUploadProductTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing display upload product types. + +// Container for display upload product types. Product types that have the word +// "DYNAMIC" in them must be associated with a campaign that has a dynamic +// remarketing feed. See https://support.google.com/google-ads/answer/6053288 +// for more info about dynamic remarketing. Other product types are regarded +// as "static" and do not have this requirement. +message DisplayUploadProductTypeEnum { + // Enumerates display upload product types. + enum DisplayUploadProductType { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // HTML5 upload ad. This product type requires the upload_media_bundle + // field in DisplayUploadAdInfo to be set. + HTML5_UPLOAD_AD = 2; + + // Dynamic HTML5 education ad. This product type requires the + // upload_media_bundle field in DisplayUploadAdInfo to be set. Can only be + // used in an education campaign. + DYNAMIC_HTML5_EDUCATION_AD = 3; + + // Dynamic HTML5 flight ad. This product type requires the + // upload_media_bundle field in DisplayUploadAdInfo to be set. Can only be + // used in a flight campaign. + DYNAMIC_HTML5_FLIGHT_AD = 4; + + // Dynamic HTML5 hotel and rental ad. This product type requires the + // upload_media_bundle field in DisplayUploadAdInfo to be set. Can only be + // used in a hotel campaign. + DYNAMIC_HTML5_HOTEL_RENTAL_AD = 5; + + // Dynamic HTML5 job ad. This product type requires the + // upload_media_bundle field in DisplayUploadAdInfo to be set. Can only be + // used in a job campaign. + DYNAMIC_HTML5_JOB_AD = 6; + + // Dynamic HTML5 local ad. This product type requires the + // upload_media_bundle field in DisplayUploadAdInfo to be set. Can only be + // used in a local campaign. + DYNAMIC_HTML5_LOCAL_AD = 7; + + // Dynamic HTML5 real estate ad. This product type requires the + // upload_media_bundle field in DisplayUploadAdInfo to be set. Can only be + // used in a real estate campaign. + DYNAMIC_HTML5_REAL_ESTATE_AD = 8; + + // Dynamic HTML5 custom ad. This product type requires the + // upload_media_bundle field in DisplayUploadAdInfo to be set. Can only be + // used in a custom campaign. + DYNAMIC_HTML5_CUSTOM_AD = 9; + + // Dynamic HTML5 travel ad. This product type requires the + // upload_media_bundle field in DisplayUploadAdInfo to be set. Can only be + // used in a travel campaign. + DYNAMIC_HTML5_TRAVEL_AD = 10; + + // Dynamic HTML5 hotel ad. This product type requires the + // upload_media_bundle field in DisplayUploadAdInfo to be set. Can only be + // used in a hotel campaign. + DYNAMIC_HTML5_HOTEL_AD = 11; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/distance_bucket.proto b/third_party/googleapis/google/ads/googleads/v3/enums/distance_bucket.proto new file mode 100644 index 000000000..f598de3ba --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/distance_bucket.proto @@ -0,0 +1,127 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "DistanceBucketProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing distance buckets. + +// Container for distance buckets of a user’s distance from an advertiser’s +// location extension. +message DistanceBucketEnum { + // The distance bucket for a user’s distance from an advertiser’s location + // extension. + enum DistanceBucket { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // User was within 700m of the location. + WITHIN_700M = 2; + + // User was within 1KM of the location. + WITHIN_1KM = 3; + + // User was within 5KM of the location. + WITHIN_5KM = 4; + + // User was within 10KM of the location. + WITHIN_10KM = 5; + + // User was within 15KM of the location. + WITHIN_15KM = 6; + + // User was within 20KM of the location. + WITHIN_20KM = 7; + + // User was within 25KM of the location. + WITHIN_25KM = 8; + + // User was within 30KM of the location. + WITHIN_30KM = 9; + + // User was within 35KM of the location. + WITHIN_35KM = 10; + + // User was within 40KM of the location. + WITHIN_40KM = 11; + + // User was within 45KM of the location. + WITHIN_45KM = 12; + + // User was within 50KM of the location. + WITHIN_50KM = 13; + + // User was within 55KM of the location. + WITHIN_55KM = 14; + + // User was within 60KM of the location. + WITHIN_60KM = 15; + + // User was within 65KM of the location. + WITHIN_65KM = 16; + + // User was beyond 65KM of the location. + BEYOND_65KM = 17; + + // User was within 0.7 miles of the location. + WITHIN_0_7MILES = 18; + + // User was within 1 mile of the location. + WITHIN_1MILE = 19; + + // User was within 5 miles of the location. + WITHIN_5MILES = 20; + + // User was within 10 miles of the location. + WITHIN_10MILES = 21; + + // User was within 15 miles of the location. + WITHIN_15MILES = 22; + + // User was within 20 miles of the location. + WITHIN_20MILES = 23; + + // User was within 25 miles of the location. + WITHIN_25MILES = 24; + + // User was within 30 miles of the location. + WITHIN_30MILES = 25; + + // User was within 35 miles of the location. + WITHIN_35MILES = 26; + + // User was within 40 miles of the location. + WITHIN_40MILES = 27; + + // User was beyond 40 miles of the location. + BEYOND_40MILES = 28; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/dsa_page_feed_criterion_field.proto b/third_party/googleapis/google/ads/googleads/v3/enums/dsa_page_feed_criterion_field.proto new file mode 100644 index 000000000..ac4ddad9e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/dsa_page_feed_criterion_field.proto @@ -0,0 +1,51 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "DsaPageFeedCriterionFieldProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Dynamic Search Ad Page Feed criterion fields. + +// Values for Dynamic Search Ad Page Feed criterion fields. +message DsaPageFeedCriterionFieldEnum { + // Possible values for Dynamic Search Ad Page Feed criterion fields. + enum DsaPageFeedCriterionField { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Data Type: URL or URL_LIST. URL of the web page you want to target. + PAGE_URL = 2; + + // Data Type: STRING_LIST. The labels that will help you target ads within + // your page feed. + LABEL = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/education_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v3/enums/education_placeholder_field.proto new file mode 100644 index 000000000..51912c931 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/education_placeholder_field.proto @@ -0,0 +1,111 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "EducationPlaceholderFieldProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Education placeholder fields. + +// Values for Education placeholder fields. +// For more information about dynamic remarketing feeds, see +// https://support.google.com/google-ads/answer/6053288. +message EducationPlaceholderFieldEnum { + // Possible values for Education placeholder fields. + enum EducationPlaceholderField { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Data Type: STRING. Required. Combination of PROGRAM ID and LOCATION ID + // must be unique per offer. + PROGRAM_ID = 2; + + // Data Type: STRING. Combination of PROGRAM ID and LOCATION ID must be + // unique per offer. + LOCATION_ID = 3; + + // Data Type: STRING. Required. Main headline with program name to be shown + // in dynamic ad. + PROGRAM_NAME = 4; + + // Data Type: STRING. Area of study that can be shown in dynamic ad. + AREA_OF_STUDY = 5; + + // Data Type: STRING. Description of program that can be shown in dynamic + // ad. + PROGRAM_DESCRIPTION = 6; + + // Data Type: STRING. Name of school that can be shown in dynamic ad. + SCHOOL_NAME = 7; + + // Data Type: STRING. Complete school address, including postal code. + ADDRESS = 8; + + // Data Type: URL. Image to be displayed in ads. + THUMBNAIL_IMAGE_URL = 9; + + // Data Type: URL. Alternative hosted file of image to be used in the ad. + ALTERNATIVE_THUMBNAIL_IMAGE_URL = 10; + + // Data Type: URL_LIST. Required. Final URLs to be used in ad when using + // Upgraded URLs; the more specific the better (e.g. the individual URL of a + // specific program and its location). + FINAL_URLS = 11; + + // Data Type: URL_LIST. Final mobile URLs for the ad when using Upgraded + // URLs. + FINAL_MOBILE_URLS = 12; + + // Data Type: URL. Tracking template for the ad when using Upgraded URLs. + TRACKING_URL = 13; + + // Data Type: STRING_LIST. Keywords used for product retrieval. + CONTEXTUAL_KEYWORDS = 14; + + // Data Type: STRING. Android app link. Must be formatted as: + // android-app://{package_id}/{scheme}/{host_path}. + // The components are defined as follows: + // package_id: app ID as specified in Google Play. + // scheme: the scheme to pass to the application. Can be HTTP, or a custom + // scheme. + // host_path: identifies the specific content within your application. + ANDROID_APP_LINK = 15; + + // Data Type: STRING_LIST. List of recommended program IDs to show together + // with this item. + SIMILAR_PROGRAM_IDS = 16; + + // Data Type: STRING. iOS app link. + IOS_APP_LINK = 17; + + // Data Type: INT64. iOS app store ID. + IOS_APP_STORE_ID = 18; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/extension_setting_device.proto b/third_party/googleapis/google/ads/googleads/v3/enums/extension_setting_device.proto new file mode 100644 index 000000000..4c0f27da3 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/extension_setting_device.proto @@ -0,0 +1,52 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ExtensionSettingDeviceProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing extension setting device type. + +// Container for enum describing extension setting device types. +message ExtensionSettingDeviceEnum { + // Possbile device types for an extension setting. + enum ExtensionSettingDevice { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // Mobile. The extensions in the extension setting will only serve on + // mobile devices. + MOBILE = 2; + + // Desktop. The extensions in the extension setting will only serve on + // desktop devices. + DESKTOP = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/extension_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/extension_type.proto new file mode 100644 index 000000000..e864c4b5a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/extension_type.proto @@ -0,0 +1,81 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ExtensionTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing extension type. + +// Container for enum describing possible data types for an extension in an +// extension setting. +message ExtensionTypeEnum { + // Possible data types for an extension in an extension setting. + enum ExtensionType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // None. + NONE = 2; + + // App. + APP = 3; + + // Call. + CALL = 4; + + // Callout. + CALLOUT = 5; + + // Message. + MESSAGE = 6; + + // Price. + PRICE = 7; + + // Promotion. + PROMOTION = 8; + + // Sitelink. + SITELINK = 10; + + // Structured snippet. + STRUCTURED_SNIPPET = 11; + + // Location. + LOCATION = 12; + + // Affiliate location. + AFFILIATE_LOCATION = 13; + + // Hotel callout + HOTEL_CALLOUT = 15; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/external_conversion_source.proto b/third_party/googleapis/google/ads/googleads/v3/enums/external_conversion_source.proto new file mode 100644 index 000000000..2ce5c64eb --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/external_conversion_source.proto @@ -0,0 +1,130 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ExternalConversionSourceProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Container for enum describing the external conversion source that is +// associated with a ConversionAction. +message ExternalConversionSourceEnum { + // The external conversion source that is associated with a ConversionAction. + enum ExternalConversionSource { + // Not specified. + UNSPECIFIED = 0; + + // Represents value unknown in this version. + UNKNOWN = 1; + + // Conversion that occurs when a user navigates to a particular webpage + // after viewing an ad; Displayed in Google Ads UI as 'Website'. + WEBPAGE = 2; + + // Conversion that comes from linked Google Analytics goal or transaction; + // Displayed in Google Ads UI as 'Analytics'. + ANALYTICS = 3; + + // Website conversion that is uploaded through ConversionUploadService; + // Displayed in Google Ads UI as 'Import from clicks'. + UPLOAD = 4; + + // Conversion that occurs when a user clicks on a call extension directly on + // an ad; Displayed in Google Ads UI as 'Calls from ads'. + AD_CALL_METRICS = 5; + + // Conversion that occurs when a user calls a dynamically-generated phone + // number (by installed javascript) from an advertiser's website after + // clicking on an ad; Displayed in Google Ads UI as 'Calls from website'. + WEBSITE_CALL_METRICS = 6; + + // Conversion that occurs when a user visits an advertiser's retail store + // after clicking on a Google ad; + // Displayed in Google Ads UI as 'Store visits'. + STORE_VISITS = 7; + + // Conversion that occurs when a user takes an in-app action such as a + // purchase in an Android app; + // Displayed in Google Ads UI as 'Android in-app action'. + ANDROID_IN_APP = 8; + + // Conversion that occurs when a user takes an in-app action such as a + // purchase in an iOS app; + // Displayed in Google Ads UI as 'iOS in-app action'. + IOS_IN_APP = 9; + + // Conversion that occurs when a user opens an iOS app for the first time; + // Displayed in Google Ads UI as 'iOS app install (first open)'. + IOS_FIRST_OPEN = 10; + + // Legacy app conversions that do not have an AppPlatform provided; + // Displayed in Google Ads UI as 'Mobile app'. + APP_UNSPECIFIED = 11; + + // Conversion that occurs when a user opens an Android app for the first + // time; Displayed in Google Ads UI as 'Android app install (first open)'. + ANDROID_FIRST_OPEN = 12; + + // Call conversion that is uploaded through ConversionUploadService; + // Displayed in Google Ads UI as 'Import from calls'. + UPLOAD_CALLS = 13; + + // Conversion that comes from a linked Firebase event; + // Displayed in Google Ads UI as 'Firebase'. + FIREBASE = 14; + + // Conversion that occurs when a user clicks on a mobile phone number; + // Displayed in Google Ads UI as 'Phone number clicks'. + CLICK_TO_CALL = 15; + + // Conversion that comes from Salesforce; + // Displayed in Google Ads UI as 'Salesforce.com'. + SALESFORCE = 16; + + // Conversion that comes from in-store purchases recorded by CRM; + // Displayed in Google Ads UI as 'Store sales (data partner)'. + STORE_SALES_CRM = 17; + + // Conversion that comes from in-store purchases from payment network; + // Displayed in Google Ads UI as 'Store sales (payment network)'. + STORE_SALES_PAYMENT_NETWORK = 18; + + // Codeless Google Play conversion; + // Displayed in Google Ads UI as 'Google Play'. + GOOGLE_PLAY = 19; + + // Conversion that comes from a linked third-party app analytics event; + // Displayed in Google Ads UI as 'Third-party app analytics'. + THIRD_PARTY_APP_ANALYTICS = 20; + + // Conversion that is controlled by Google Attribution. + GOOGLE_ATTRIBUTION = 21; + + // Store Sales conversion based on first-party or third-party merchant data + // uploads. Displayed in Google Ads UI as 'Store sales (direct)'. + STORE_SALES_DIRECT = 22; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/feed_attribute_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/feed_attribute_type.proto new file mode 100644 index 000000000..5a8d414c1 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/feed_attribute_type.proto @@ -0,0 +1,83 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "FeedAttributeTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing feed attribute type. + +// Container for enum describing possible data types for a feed attribute. +message FeedAttributeTypeEnum { + // Possible data types for a feed attribute. + enum FeedAttributeType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Int64. + INT64 = 2; + + // Double. + DOUBLE = 3; + + // String. + STRING = 4; + + // Boolean. + BOOLEAN = 5; + + // Url. + URL = 6; + + // Datetime. + DATE_TIME = 7; + + // Int64 list. + INT64_LIST = 8; + + // Double (8 bytes) list. + DOUBLE_LIST = 9; + + // String list. + STRING_LIST = 10; + + // Boolean list. + BOOLEAN_LIST = 11; + + // Url list. + URL_LIST = 12; + + // Datetime list. + DATE_TIME_LIST = 13; + + // Price. + PRICE = 14; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/feed_item_quality_approval_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/feed_item_quality_approval_status.proto new file mode 100644 index 000000000..9e37b1b3d --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/feed_item_quality_approval_status.proto @@ -0,0 +1,52 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "FeedItemQualityApprovalStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing feed item quality evaluation approval statuses. + +// Container for enum describing possible quality evaluation approval statuses +// of a feed item. +message FeedItemQualityApprovalStatusEnum { + // The possible quality evaluation approval statuses of a feed item. + enum FeedItemQualityApprovalStatus { + // No value has been specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Meets all quality expectations. + APPROVED = 2; + + // Does not meet some quality expectations. The specific reason is found in + // the quality_disapproval_reasons field. + DISAPPROVED = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/feed_item_quality_disapproval_reason.proto b/third_party/googleapis/google/ads/googleads/v3/enums/feed_item_quality_disapproval_reason.proto new file mode 100644 index 000000000..1bf0dc718 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/feed_item_quality_disapproval_reason.proto @@ -0,0 +1,99 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "FeedItemQualityDisapprovalReasonProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing feed item quality disapproval reasons. + +// Container for enum describing possible quality evaluation disapproval reasons +// of a feed item. +message FeedItemQualityDisapprovalReasonEnum { + // The possible quality evaluation disapproval reasons of a feed item. + enum FeedItemQualityDisapprovalReason { + // No value has been specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Price contains repetitive headers. + PRICE_TABLE_REPETITIVE_HEADERS = 2; + + // Price contains repetitive description. + PRICE_TABLE_REPETITIVE_DESCRIPTION = 3; + + // Price contains inconsistent items. + PRICE_TABLE_INCONSISTENT_ROWS = 4; + + // Price contains qualifiers in description. + PRICE_DESCRIPTION_HAS_PRICE_QUALIFIERS = 5; + + // Price contains an unsupported language. + PRICE_UNSUPPORTED_LANGUAGE = 6; + + // Price item header is not relevant to the price type. + PRICE_TABLE_ROW_HEADER_TABLE_TYPE_MISMATCH = 7; + + // Price item header has promotional text. + PRICE_TABLE_ROW_HEADER_HAS_PROMOTIONAL_TEXT = 8; + + // Price item description is not relevant to the item header. + PRICE_TABLE_ROW_DESCRIPTION_NOT_RELEVANT = 9; + + // Price item description contains promotional text. + PRICE_TABLE_ROW_DESCRIPTION_HAS_PROMOTIONAL_TEXT = 10; + + // Price item header and description are repetitive. + PRICE_TABLE_ROW_HEADER_DESCRIPTION_REPETITIVE = 11; + + // Price item is in a foreign language, nonsense, or can't be rated. + PRICE_TABLE_ROW_UNRATEABLE = 12; + + // Price item price is invalid or inaccurate. + PRICE_TABLE_ROW_PRICE_INVALID = 13; + + // Price item URL is invalid or irrelevant. + PRICE_TABLE_ROW_URL_INVALID = 14; + + // Price item header or description has price. + PRICE_HEADER_OR_DESCRIPTION_HAS_PRICE = 15; + + // Structured snippet values do not match the header. + STRUCTURED_SNIPPETS_HEADER_POLICY_VIOLATED = 16; + + // Structured snippet values are repeated. + STRUCTURED_SNIPPETS_REPEATED_VALUES = 17; + + // Structured snippet values violate editorial guidelines like punctuation. + STRUCTURED_SNIPPETS_EDITORIAL_GUIDELINES = 18; + + // Structured snippet contain promotional text. + STRUCTURED_SNIPPETS_HAS_PROMOTIONAL_TEXT = 19; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/feed_item_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/feed_item_status.proto new file mode 100644 index 000000000..33d8fe730 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/feed_item_status.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "FeedItemStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing feed item status. + +// Container for enum describing possible statuses of a feed item. +message FeedItemStatusEnum { + // Possible statuses of a feed item. + enum FeedItemStatus { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Feed item is enabled. + ENABLED = 2; + + // Feed item has been removed. + REMOVED = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/feed_item_target_device.proto b/third_party/googleapis/google/ads/googleads/v3/enums/feed_item_target_device.proto new file mode 100644 index 000000000..c750f6622 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/feed_item_target_device.proto @@ -0,0 +1,48 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "FeedItemTargetDeviceProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing feed item target device type. + +// Container for enum describing possible data types for a feed item target +// device. +message FeedItemTargetDeviceEnum { + // Possible data types for a feed item target device. + enum FeedItemTargetDevice { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Mobile. + MOBILE = 2; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/feed_item_target_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/feed_item_target_status.proto new file mode 100644 index 000000000..45cc85fc2 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/feed_item_target_status.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "FeedItemTargetStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing feed item target status. + +// Container for enum describing possible statuses of a feed item target. +message FeedItemTargetStatusEnum { + // Possible statuses of a feed item target. + enum FeedItemTargetStatus { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Feed item target is enabled. + ENABLED = 2; + + // Feed item target has been removed. + REMOVED = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/feed_item_target_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/feed_item_target_type.proto new file mode 100644 index 000000000..dd046c965 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/feed_item_target_type.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "FeedItemTargetTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing feed item target type status. + +// Container for enum describing possible types of a feed item target. +message FeedItemTargetTypeEnum { + // Possible type of a feed item target. + enum FeedItemTargetType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Feed item targets a campaign. + CAMPAIGN = 2; + + // Feed item targets an ad group. + AD_GROUP = 3; + + // Feed item targets a criterion. + CRITERION = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/feed_item_validation_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/feed_item_validation_status.proto new file mode 100644 index 000000000..c083d14a6 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/feed_item_validation_status.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "FeedItemValidationStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing feed item validation statuses. + +// Container for enum describing possible validation statuses of a feed item. +message FeedItemValidationStatusEnum { + // The possible validation statuses of a feed item. + enum FeedItemValidationStatus { + // No value has been specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Validation pending. + PENDING = 2; + + // An error was found. + INVALID = 3; + + // Feed item is semantically well-formed. + VALID = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/feed_link_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/feed_link_status.proto new file mode 100644 index 000000000..92253fbb2 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/feed_link_status.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "FeedLinkStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing status of a feed link. + +// Container for an enum describing possible statuses of a feed link. +message FeedLinkStatusEnum { + // Possible statuses of a feed link. + enum FeedLinkStatus { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Feed link is enabled. + ENABLED = 2; + + // Feed link has been removed. + REMOVED = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/feed_mapping_criterion_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/feed_mapping_criterion_type.proto new file mode 100644 index 000000000..fc6510574 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/feed_mapping_criterion_type.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "FeedMappingCriterionTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing criterion types for feed mappings. + +// Container for enum describing possible criterion types for a feed mapping. +message FeedMappingCriterionTypeEnum { + // Possible placeholder types for a feed mapping. + enum FeedMappingCriterionType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Allows campaign targeting at locations within a location feed. + LOCATION_EXTENSION_TARGETING = 4; + + // Allows url targeting for your dynamic search ads within a page feed. + DSA_PAGE_FEED = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/feed_mapping_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/feed_mapping_status.proto new file mode 100644 index 000000000..06fb88c1b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/feed_mapping_status.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "FeedMappingStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing feed mapping status. + +// Container for enum describing possible statuses of a feed mapping. +message FeedMappingStatusEnum { + // Possible statuses of a feed mapping. + enum FeedMappingStatus { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Feed mapping is enabled. + ENABLED = 2; + + // Feed mapping has been removed. + REMOVED = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/feed_origin.proto b/third_party/googleapis/google/ads/googleads/v3/enums/feed_origin.proto new file mode 100644 index 000000000..b8e3fd7a1 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/feed_origin.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "FeedOriginProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing feed origin. + +// Container for enum describing possible values for a feed origin. +message FeedOriginEnum { + // Possible values for a feed origin. + enum FeedOrigin { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The FeedAttributes for this Feed are managed by the + // user. Users can add FeedAttributes to this Feed. + USER = 2; + + // The FeedAttributes for an GOOGLE Feed are created by Google. A feed of + // this type is maintained by Google and will have the correct attributes + // for the placeholder type of the feed. + GOOGLE = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/feed_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/feed_status.proto new file mode 100644 index 000000000..adb38a24c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/feed_status.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "FeedStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing feed status. + +// Container for enum describing possible statuses of a feed. +message FeedStatusEnum { + // Possible statuses of a feed. + enum FeedStatus { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Feed is enabled. + ENABLED = 2; + + // Feed has been removed. + REMOVED = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/flight_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v3/enums/flight_placeholder_field.proto new file mode 100644 index 000000000..2e2c822b1 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/flight_placeholder_field.proto @@ -0,0 +1,118 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "FlightsPlaceholderFieldProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Flight placeholder fields. + +// Values for Flight placeholder fields. +// For more information about dynamic remarketing feeds, see +// https://support.google.com/google-ads/answer/6053288. +message FlightPlaceholderFieldEnum { + // Possible values for Flight placeholder fields. + enum FlightPlaceholderField { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Data Type: STRING. Required. Destination id. Example: PAR, LON. + // For feed items that only have destination id, destination id must be a + // unique key. For feed items that have both destination id and origin id, + // then the combination must be a unique key. + DESTINATION_ID = 2; + + // Data Type: STRING. Origin id. Example: PAR, LON. + // Optional. Combination of destination id and origin id must be unique per + // offer. + ORIGIN_ID = 3; + + // Data Type: STRING. Required. Main headline with product name to be shown + // in dynamic ad. + FLIGHT_DESCRIPTION = 4; + + // Data Type: STRING. Shorter names are recommended. + ORIGIN_NAME = 5; + + // Data Type: STRING. Shorter names are recommended. + DESTINATION_NAME = 6; + + // Data Type: STRING. Price to be shown in the ad. + // Example: "100.00 USD" + FLIGHT_PRICE = 7; + + // Data Type: STRING. Formatted price to be shown in the ad. + // Example: "Starting at $100.00 USD", "$80 - $100" + FORMATTED_PRICE = 8; + + // Data Type: STRING. Sale price to be shown in the ad. + // Example: "80.00 USD" + FLIGHT_SALE_PRICE = 9; + + // Data Type: STRING. Formatted sale price to be shown in the ad. + // Example: "On sale for $80.00", "$60 - $80" + FORMATTED_SALE_PRICE = 10; + + // Data Type: URL. Image to be displayed in the ad. + IMAGE_URL = 11; + + // Data Type: URL_LIST. Required. Final URLs for the ad when using Upgraded + // URLs. User will be redirected to these URLs when they click on an ad, or + // when they click on a specific flight for ads that show multiple + // flights. + FINAL_URLS = 12; + + // Data Type: URL_LIST. Final mobile URLs for the ad when using Upgraded + // URLs. + FINAL_MOBILE_URLS = 13; + + // Data Type: URL. Tracking template for the ad when using Upgraded URLs. + TRACKING_URL = 14; + + // Data Type: STRING. Android app link. Must be formatted as: + // android-app://{package_id}/{scheme}/{host_path}. + // The components are defined as follows: + // package_id: app ID as specified in Google Play. + // scheme: the scheme to pass to the application. Can be HTTP, or a custom + // scheme. + // host_path: identifies the specific content within your application. + ANDROID_APP_LINK = 15; + + // Data Type: STRING_LIST. List of recommended destination IDs to show + // together with this item. + SIMILAR_DESTINATION_IDS = 16; + + // Data Type: STRING. iOS app link. + IOS_APP_LINK = 17; + + // Data Type: INT64. iOS app store ID. + IOS_APP_STORE_ID = 18; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/frequency_cap_event_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/frequency_cap_event_type.proto new file mode 100644 index 000000000..53492e727 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/frequency_cap_event_type.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "FrequencyCapEventTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing frequency caps. + +// Container for enum describing the type of event that the cap applies to. +message FrequencyCapEventTypeEnum { + // The type of event that the cap applies to (e.g. impression). + enum FrequencyCapEventType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The cap applies on ad impressions. + IMPRESSION = 2; + + // The cap applies on video ad views. + VIDEO_VIEW = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/frequency_cap_level.proto b/third_party/googleapis/google/ads/googleads/v3/enums/frequency_cap_level.proto new file mode 100644 index 000000000..497671d38 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/frequency_cap_level.proto @@ -0,0 +1,54 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "FrequencyCapLevelProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing frequency caps. + +// Container for enum describing the level on which the cap is to be applied. +message FrequencyCapLevelEnum { + // The level on which the cap is to be applied (e.g ad group ad, ad group). + // Cap is applied to all the resources of this level. + enum FrequencyCapLevel { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The cap is applied at the ad group ad level. + AD_GROUP_AD = 2; + + // The cap is applied at the ad group level. + AD_GROUP = 3; + + // The cap is applied at the campaign level. + CAMPAIGN = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/frequency_cap_time_unit.proto b/third_party/googleapis/google/ads/googleads/v3/enums/frequency_cap_time_unit.proto new file mode 100644 index 000000000..70f105263 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/frequency_cap_time_unit.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "FrequencyCapTimeUnitProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing frequency caps. + +// Container for enum describing the unit of time the cap is defined at. +message FrequencyCapTimeUnitEnum { + // Unit of time the cap is defined at (e.g. day, week). + enum FrequencyCapTimeUnit { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The cap would define limit per one day. + DAY = 2; + + // The cap would define limit per one week. + WEEK = 3; + + // The cap would define limit per one month. + MONTH = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/gender_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/gender_type.proto new file mode 100644 index 000000000..e29af5f44 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/gender_type.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "GenderTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing gender types. + +// Container for enum describing the type of demographic genders. +message GenderTypeEnum { + // The type of demographic genders (e.g. female). + enum GenderType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Male. + MALE = 10; + + // Female. + FEMALE = 11; + + // Undetermined gender. + UNDETERMINED = 20; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/geo_target_constant_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/geo_target_constant_status.proto new file mode 100644 index 000000000..067121467 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/geo_target_constant_status.proto @@ -0,0 +1,52 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "GeoTargetConstantStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing geo target constant statuses. + +// Container for describing the status of a geo target constant. +message GeoTargetConstantStatusEnum { + // The possible statuses of a geo target constant. + enum GeoTargetConstantStatus { + // No value has been specified. + UNSPECIFIED = 0; + + // The received value is not known in this version. + // + // This is a response-only value. + UNKNOWN = 1; + + // The geo target constant is valid. + ENABLED = 2; + + // The geo target constant is obsolete and will be removed. + REMOVAL_PLANNED = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/geo_targeting_restriction.proto b/third_party/googleapis/google/ads/googleads/v3/enums/geo_targeting_restriction.proto new file mode 100644 index 000000000..dc5c15c0e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/geo_targeting_restriction.proto @@ -0,0 +1,49 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "GeoTargetingRestrictionProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing GeoTargetingRestriction. + +// Message describing feed item geo targeting restriction. +message GeoTargetingRestrictionEnum { + // A restriction used to determine if the request context's + // geo should be matched. + enum GeoTargetingRestriction { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Indicates that request context should match the physical location of + // the user. + LOCATION_OF_PRESENCE = 2; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/geo_targeting_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/geo_targeting_type.proto new file mode 100644 index 000000000..a3a17b6ee --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/geo_targeting_type.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "GeoTargetingTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing geo targeting types. + +// Container for enum describing possible geo targeting types. +message GeoTargetingTypeEnum { + // The possible geo targeting types. + enum GeoTargetingType { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // Location the user is interested in while making the query. + AREA_OF_INTEREST = 2; + + // Location of the user issuing the query. + LOCATION_OF_PRESENCE = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/google_ads_field_category.proto b/third_party/googleapis/google/ads/googleads/v3/enums/google_ads_field_category.proto new file mode 100644 index 000000000..ab5880744 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/google_ads_field_category.proto @@ -0,0 +1,61 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "GoogleAdsFieldCategoryProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing GoogleAdsField categories + +// Container for enum that determines if the described artifact is a resource +// or a field, and if it is a field, when it segments search queries. +message GoogleAdsFieldCategoryEnum { + // The category of the artifact. + enum GoogleAdsFieldCategory { + // Unspecified + UNSPECIFIED = 0; + + // Unknown + UNKNOWN = 1; + + // The described artifact is a resource. + RESOURCE = 2; + + // The described artifact is a field and is an attribute of a resource. + // Including a resource attribute field in a query may segment the query if + // the resource to which it is attributed segments the resource found in + // the FROM clause. + ATTRIBUTE = 3; + + // The described artifact is a field and always segments search queries. + SEGMENT = 5; + + // The described artifact is a field and is a metric. It never segments + // search queries. + METRIC = 6; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/google_ads_field_data_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/google_ads_field_data_type.proto new file mode 100644 index 000000000..43d4c7e1e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/google_ads_field_data_type.proto @@ -0,0 +1,102 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "GoogleAdsFieldDataTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing GoogleAdsField data types + +// Container holding the various data types. +message GoogleAdsFieldDataTypeEnum { + // These are the various types a GoogleAdsService artifact may take on. + enum GoogleAdsFieldDataType { + // Unspecified + UNSPECIFIED = 0; + + // Unknown + UNKNOWN = 1; + + // Maps to google.protobuf.BoolValue + // + // Applicable operators: =, != + BOOLEAN = 2; + + // Maps to google.protobuf.StringValue. It can be compared using the set of + // operators specific to dates however. + // + // Applicable operators: =, <, >, <=, >=, BETWEEN, DURING, and IN + DATE = 3; + + // Maps to google.protobuf.DoubleValue + // + // Applicable operators: =, !=, <, >, IN, NOT IN + DOUBLE = 4; + + // Maps to an enum. It's specific definition can be found at type_url. + // + // Applicable operators: =, !=, IN, NOT IN + ENUM = 5; + + // Maps to google.protobuf.FloatValue + // + // Applicable operators: =, !=, <, >, IN, NOT IN + FLOAT = 6; + + // Maps to google.protobuf.Int32Value + // + // Applicable operators: =, !=, <, >, <=, >=, BETWEEN, IN, NOT IN + INT32 = 7; + + // Maps to google.protobuf.Int64Value + // + // Applicable operators: =, !=, <, >, <=, >=, BETWEEN, IN, NOT IN + INT64 = 8; + + // Maps to a protocol buffer message type. The data type's details can be + // found in type_url. + // + // No operators work with MESSAGE fields. + MESSAGE = 9; + + // Maps to google.protobuf.StringValue. Represents the resource name + // (unique id) of a resource or one of its foreign keys. + // + // No operators work with RESOURCE_NAME fields. + RESOURCE_NAME = 10; + + // Maps to google.protobuf.StringValue. + // + // Applicable operators: =, !=, LIKE, NOT LIKE, IN, NOT IN + STRING = 11; + + // Maps to google.protobuf.UInt64Value + // + // Applicable operators: =, !=, <, >, <=, >=, BETWEEN, IN, NOT IN + UINT64 = 12; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/hotel_date_selection_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/hotel_date_selection_type.proto new file mode 100644 index 000000000..d21e23706 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/hotel_date_selection_type.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "HotelDateSelectionTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing hotel date selection types. + +// Container for enum describing possible hotel date selection types +message HotelDateSelectionTypeEnum { + // Enum describing possible hotel date selection types. + enum HotelDateSelectionType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Dates selected by default. + DEFAULT_SELECTION = 50; + + // Dates selected by the user. + USER_SELECTED = 51; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/hotel_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v3/enums/hotel_placeholder_field.proto new file mode 100644 index 000000000..776e5aa86 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/hotel_placeholder_field.proto @@ -0,0 +1,124 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "HotelsPlaceholderFieldProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Hotel placeholder fields. + +// Values for Hotel placeholder fields. +// For more information about dynamic remarketing feeds, see +// https://support.google.com/google-ads/answer/6053288. +message HotelPlaceholderFieldEnum { + // Possible values for Hotel placeholder fields. + enum HotelPlaceholderField { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Data Type: STRING. Required. Unique ID. + PROPERTY_ID = 2; + + // Data Type: STRING. Required. Main headline with property name to be shown + // in dynamic ad. + PROPERTY_NAME = 3; + + // Data Type: STRING. Name of destination to be shown in dynamic ad. + DESTINATION_NAME = 4; + + // Data Type: STRING. Description of destination to be shown in dynamic ad. + DESCRIPTION = 5; + + // Data Type: STRING. Complete property address, including postal code. + ADDRESS = 6; + + // Data Type: STRING. Price to be shown in the ad. + // Example: "100.00 USD" + PRICE = 7; + + // Data Type: STRING. Formatted price to be shown in the ad. + // Example: "Starting at $100.00 USD", "$80 - $100" + FORMATTED_PRICE = 8; + + // Data Type: STRING. Sale price to be shown in the ad. + // Example: "80.00 USD" + SALE_PRICE = 9; + + // Data Type: STRING. Formatted sale price to be shown in the ad. + // Example: "On sale for $80.00", "$60 - $80" + FORMATTED_SALE_PRICE = 10; + + // Data Type: URL. Image to be displayed in the ad. + IMAGE_URL = 11; + + // Data Type: STRING. Category of property used to group like items together + // for recommendation engine. + CATEGORY = 12; + + // Data Type: INT64. Star rating (1 to 5) used to group like items + // together for recommendation engine. + STAR_RATING = 13; + + // Data Type: STRING_LIST. Keywords used for product retrieval. + CONTEXTUAL_KEYWORDS = 14; + + // Data Type: URL_LIST. Required. Final URLs for the ad when using Upgraded + // URLs. User will be redirected to these URLs when they click on an ad, or + // when they click on a specific flight for ads that show multiple + // flights. + FINAL_URLS = 15; + + // Data Type: URL_LIST. Final mobile URLs for the ad when using Upgraded + // URLs. + FINAL_MOBILE_URLS = 16; + + // Data Type: URL. Tracking template for the ad when using Upgraded URLs. + TRACKING_URL = 17; + + // Data Type: STRING. Android app link. Must be formatted as: + // android-app://{package_id}/{scheme}/{host_path}. + // The components are defined as follows: + // package_id: app ID as specified in Google Play. + // scheme: the scheme to pass to the application. Can be HTTP, or a custom + // scheme. + // host_path: identifies the specific content within your application. + ANDROID_APP_LINK = 18; + + // Data Type: STRING_LIST. List of recommended property IDs to show together + // with this item. + SIMILAR_PROPERTY_IDS = 19; + + // Data Type: STRING. iOS app link. + IOS_APP_LINK = 20; + + // Data Type: INT64. iOS app store ID. + IOS_APP_STORE_ID = 21; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/hotel_price_bucket.proto b/third_party/googleapis/google/ads/googleads/v3/enums/hotel_price_bucket.proto new file mode 100644 index 000000000..ac9efcef9 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/hotel_price_bucket.proto @@ -0,0 +1,52 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "HotelPriceBucketProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing hotel price buckets. + +// Container for enum describing hotel price bucket for a hotel itinerary. +message HotelPriceBucketEnum { + // Enum describing possible hotel price buckets. + enum HotelPriceBucket { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // Tied for lowest price. Partner is within a small variance of the lowest + // price. + LOWEST_TIED = 3; + + // Not lowest price. Partner is not within a small variance of the lowest + // price. + NOT_LOWEST = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/hotel_rate_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/hotel_rate_type.proto new file mode 100644 index 000000000..0611f8b3e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/hotel_rate_type.proto @@ -0,0 +1,62 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "HotelRateTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing hotel rate types. + +// Container for enum describing possible hotel rate types. +message HotelRateTypeEnum { + // Enum describing possible hotel rate types. + enum HotelRateType { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // Rate type information is unavailable. + UNAVAILABLE = 2; + + // Rates available to everyone. + PUBLIC_RATE = 3; + + // A membership program rate is available and satisfies basic requirements + // like having a public rate available. UI treatment will strikethrough the + // public rate and indicate that a discount is available to the user. For + // more on Qualified Rates, visit + // https://developers.google.com/hotels/hotel-ads/dev-guide/qualified-rates + QUALIFIED_RATE = 4; + + // Rates available to users that satisfy some eligibility criteria. e.g. + // all signed-in users, 20% of mobile users, all mobile users in Canada, + // etc. + PRIVATE_RATE = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/income_range_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/income_range_type.proto new file mode 100644 index 000000000..e2bb50f0c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/income_range_type.proto @@ -0,0 +1,65 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "IncomeRangeTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing income range types. + +// Container for enum describing the type of demographic income ranges. +message IncomeRangeTypeEnum { + // The type of demographic income ranges (e.g. between 0% to 50%). + enum IncomeRangeType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // 0%-50%. + INCOME_RANGE_0_50 = 510001; + + // 50% to 60%. + INCOME_RANGE_50_60 = 510002; + + // 60% to 70%. + INCOME_RANGE_60_70 = 510003; + + // 70% to 80%. + INCOME_RANGE_70_80 = 510004; + + // 80% to 90%. + INCOME_RANGE_80_90 = 510005; + + // Greater than 90%. + INCOME_RANGE_90_UP = 510006; + + // Undetermined income range. + INCOME_RANGE_UNDETERMINED = 510000; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/interaction_event_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/interaction_event_type.proto new file mode 100644 index 000000000..5c93c0a82 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/interaction_event_type.proto @@ -0,0 +1,62 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "InteractionEventTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing types of payable and free interactions. + +// Container for enum describing types of payable and free interactions. +message InteractionEventTypeEnum { + // Enum describing possible types of payable and free interactions. + enum InteractionEventType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Click to site. In most cases, this interaction navigates to an external + // location, usually the advertiser's landing page. This is also the default + // InteractionEventType for click events. + CLICK = 2; + + // The user's expressed intent to engage with the ad in-place. + ENGAGEMENT = 3; + + // User viewed a video ad. + VIDEO_VIEW = 4; + + // The default InteractionEventType for ad conversion events. + // This is used when an ad conversion row does NOT indicate + // that the free interactions (i.e., the ad conversions) + // should be 'promoted' and reported as part of the core metrics. + // These are simply other (ad) conversions. + NONE = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/interaction_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/interaction_type.proto new file mode 100644 index 000000000..b50f85ead --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/interaction_type.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "InteractionTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing interaction types. + +// Container for enum describing possible interaction types. +message InteractionTypeEnum { + // Enum describing possible interaction types. + enum InteractionType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Calls. + CALLS = 8000; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/invoice_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/invoice_type.proto new file mode 100644 index 000000000..0013adcfc --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/invoice_type.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "InvoiceTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing invoice types. + +// Container for enum describing the type of invoices. +message InvoiceTypeEnum { + // The possible type of invoices. + enum InvoiceType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // An invoice with a negative amount. The account receives a credit. + CREDIT_MEMO = 2; + + // An invoice with a positive amount. The account owes a balance. + INVOICE = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/job_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v3/enums/job_placeholder_field.proto new file mode 100644 index 000000000..ac09c8933 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/job_placeholder_field.proto @@ -0,0 +1,115 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "JobsPlaceholderFieldProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Job placeholder fields. + +// Values for Job placeholder fields. +// For more information about dynamic remarketing feeds, see +// https://support.google.com/google-ads/answer/6053288. +message JobPlaceholderFieldEnum { + // Possible values for Job placeholder fields. + enum JobPlaceholderField { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Data Type: STRING. Required. If only JOB_ID is specified, then it must be + // unique. If both JOB_ID and LOCATION_ID are specified, then the + // pair must be unique. + // ID) pair must be unique. + JOB_ID = 2; + + // Data Type: STRING. Combination of JOB_ID and LOCATION_ID must be unique + // per offer. + LOCATION_ID = 3; + + // Data Type: STRING. Required. Main headline with job title to be shown in + // dynamic ad. + TITLE = 4; + + // Data Type: STRING. Job subtitle to be shown in dynamic ad. + SUBTITLE = 5; + + // Data Type: STRING. Description of job to be shown in dynamic ad. + DESCRIPTION = 6; + + // Data Type: URL. Image to be displayed in the ad. Highly recommended for + // image ads. + IMAGE_URL = 7; + + // Data Type: STRING. Category of property used to group like items together + // for recommendation engine. + CATEGORY = 8; + + // Data Type: STRING_LIST. Keywords used for product retrieval. + CONTEXTUAL_KEYWORDS = 9; + + // Data Type: STRING. Complete property address, including postal code. + ADDRESS = 10; + + // Data Type: STRING. Salary or salary range of job to be shown in dynamic + // ad. + SALARY = 11; + + // Data Type: URL_LIST. Required. Final URLs to be used in ad when using + // Upgraded URLs; the more specific the better (e.g. the individual URL of a + // specific job and its location). + FINAL_URLS = 12; + + // Data Type: URL_LIST. Final mobile URLs for the ad when using Upgraded + // URLs. + FINAL_MOBILE_URLS = 14; + + // Data Type: URL. Tracking template for the ad when using Upgraded URLs. + TRACKING_URL = 15; + + // Data Type: STRING. Android app link. Must be formatted as: + // android-app://{package_id}/{scheme}/{host_path}. + // The components are defined as follows: + // package_id: app ID as specified in Google Play. + // scheme: the scheme to pass to the application. Can be HTTP, or a custom + // scheme. + // host_path: identifies the specific content within your application. + ANDROID_APP_LINK = 16; + + // Data Type: STRING_LIST. List of recommended job IDs to show together with + // this item. + SIMILAR_JOB_IDS = 17; + + // Data Type: STRING. iOS app link. + IOS_APP_LINK = 18; + + // Data Type: INT64. iOS app store ID. + IOS_APP_STORE_ID = 19; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/keyword_match_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/keyword_match_type.proto new file mode 100644 index 000000000..73a60905b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/keyword_match_type.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "KeywordMatchTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Keyword match types. + +// Message describing Keyword match types. +message KeywordMatchTypeEnum { + // Possible Keyword match types. + enum KeywordMatchType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Exact match. + EXACT = 2; + + // Phrase match. + PHRASE = 3; + + // Broad match. + BROAD = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/keyword_plan_competition_level.proto b/third_party/googleapis/google/ads/googleads/v3/enums/keyword_plan_competition_level.proto new file mode 100644 index 000000000..324e313dc --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/keyword_plan_competition_level.proto @@ -0,0 +1,57 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "KeywordPlanCompetitionLevelProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Keyword Planner competition levels. + +// Container for enumeration of keyword competition levels. The competition +// level indicates how competitive ad placement is for a keyword and +// is determined by the number of advertisers bidding on that keyword relative +// to all keywords across Google. The competition level can depend on the +// location and Search Network targeting options you've selected. +message KeywordPlanCompetitionLevelEnum { + // Competition level of a keyword. + enum KeywordPlanCompetitionLevel { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // Low competition. The Competition Index range for this is [0, 33]. + LOW = 2; + + // Medium competition. The Competition Index range for this is [34, 66]. + MEDIUM = 3; + + // High competition. The Competition Index range for this is [67, 100]. + HIGH = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/keyword_plan_forecast_interval.proto b/third_party/googleapis/google/ads/googleads/v3/enums/keyword_plan_forecast_interval.proto new file mode 100644 index 000000000..c92f37503 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/keyword_plan_forecast_interval.proto @@ -0,0 +1,56 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "KeywordPlanForecastIntervalProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing keyword plan forecast intervals. + +// Container for enumeration of forecast intervals. +message KeywordPlanForecastIntervalEnum { + // Forecast intervals. + enum KeywordPlanForecastInterval { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // The next week date range for keyword plan. The next week is based + // on the default locale of the user's account and is mostly SUN-SAT or + // MON-SUN. + // This can be different from next-7 days. + NEXT_WEEK = 3; + + // The next month date range for keyword plan. + NEXT_MONTH = 4; + + // The next quarter date range for keyword plan. + NEXT_QUARTER = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/keyword_plan_network.proto b/third_party/googleapis/google/ads/googleads/v3/enums/keyword_plan_network.proto new file mode 100644 index 000000000..a3b0505fb --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/keyword_plan_network.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "KeywordPlanNetworkProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Keyword Planner forecastable network types. + +// Container for enumeration of keyword plan forecastable network types. +message KeywordPlanNetworkEnum { + // Enumerates keyword plan forecastable network types. + enum KeywordPlanNetwork { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // Google Search. + GOOGLE_SEARCH = 2; + + // Google Search + Search partners. + GOOGLE_SEARCH_AND_PARTNERS = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/label_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/label_status.proto new file mode 100644 index 000000000..8b869e64d --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/label_status.proto @@ -0,0 +1,48 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "LabelStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Container for enum describing possible status of a label. +message LabelStatusEnum { + // Possible statuses of a label. + enum LabelStatus { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Label is enabled. + ENABLED = 2; + + // Label is removed. + REMOVED = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/legacy_app_install_ad_app_store.proto b/third_party/googleapis/google/ads/googleads/v3/enums/legacy_app_install_ad_app_store.proto new file mode 100644 index 000000000..c1cb10a80 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/legacy_app_install_ad_app_store.proto @@ -0,0 +1,59 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "LegacyAppInstallAdAppStoreProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing app store types for a legacy app install ad. + +// Container for enum describing app store type in a legacy app install ad. +message LegacyAppInstallAdAppStoreEnum { + // App store type in a legacy app install ad. + enum LegacyAppInstallAdAppStore { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Apple iTunes. + APPLE_APP_STORE = 2; + + // Google Play. + GOOGLE_PLAY = 3; + + // Windows Store. + WINDOWS_STORE = 4; + + // Windows Phone Store. + WINDOWS_PHONE_STORE = 5; + + // The app is hosted in a Chinese app store. + CN_APP_STORE = 6; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/listing_custom_attribute_index.proto b/third_party/googleapis/google/ads/googleads/v3/enums/listing_custom_attribute_index.proto new file mode 100644 index 000000000..f997c65af --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/listing_custom_attribute_index.proto @@ -0,0 +1,60 @@ +// Copyright 2019 Google LLC. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ListingCustomAttributeIndexProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing listing custom attributes. + +// Container for enum describing the index of the listing custom attribute. +message ListingCustomAttributeIndexEnum { + // The index of the listing custom attribute. + enum ListingCustomAttributeIndex { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // First listing custom attribute. + INDEX0 = 7; + + // Second listing custom attribute. + INDEX1 = 8; + + // Third listing custom attribute. + INDEX2 = 9; + + // Fourth listing custom attribute. + INDEX3 = 10; + + // Fifth listing custom attribute. + INDEX4 = 11; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/listing_group_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/listing_group_type.proto new file mode 100644 index 000000000..fe75d13c1 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/listing_group_type.proto @@ -0,0 +1,52 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ListingGroupTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing listing groups. + +// Container for enum describing the type of the listing group. +message ListingGroupTypeEnum { + // The type of the listing group. + enum ListingGroupType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Subdivision of products along some listing dimension. These nodes + // are not used by serving to target listing entries, but is purely + // to define the structure of the tree. + SUBDIVISION = 2; + + // Listing group unit that defines a bid. + UNIT = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/local_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v3/enums/local_placeholder_field.proto new file mode 100644 index 000000000..c6f67d9dc --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/local_placeholder_field.proto @@ -0,0 +1,119 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "LocalPlaceholderFieldProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Local placeholder fields. + +// Values for Local placeholder fields. +// For more information about dynamic remarketing feeds, see +// https://support.google.com/google-ads/answer/6053288. +message LocalPlaceholderFieldEnum { + // Possible values for Local placeholder fields. + enum LocalPlaceholderField { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Data Type: STRING. Required. Unique ID. + DEAL_ID = 2; + + // Data Type: STRING. Required. Main headline with local deal title to be + // shown in dynamic ad. + DEAL_NAME = 3; + + // Data Type: STRING. Local deal subtitle to be shown in dynamic ad. + SUBTITLE = 4; + + // Data Type: STRING. Description of local deal to be shown in dynamic ad. + DESCRIPTION = 5; + + // Data Type: STRING. Price to be shown in the ad. Highly recommended for + // dynamic ads. Example: "100.00 USD" + PRICE = 6; + + // Data Type: STRING. Formatted price to be shown in the ad. + // Example: "Starting at $100.00 USD", "$80 - $100" + FORMATTED_PRICE = 7; + + // Data Type: STRING. Sale price to be shown in the ad. + // Example: "80.00 USD" + SALE_PRICE = 8; + + // Data Type: STRING. Formatted sale price to be shown in the ad. + // Example: "On sale for $80.00", "$60 - $80" + FORMATTED_SALE_PRICE = 9; + + // Data Type: URL. Image to be displayed in the ad. + IMAGE_URL = 10; + + // Data Type: STRING. Complete property address, including postal code. + ADDRESS = 11; + + // Data Type: STRING. Category of local deal used to group like items + // together for recommendation engine. + CATEGORY = 12; + + // Data Type: STRING_LIST. Keywords used for product retrieval. + CONTEXTUAL_KEYWORDS = 13; + + // Data Type: URL_LIST. Required. Final URLs to be used in ad when using + // Upgraded URLs; the more specific the better (e.g. the individual URL of a + // specific local deal and its location). + FINAL_URLS = 14; + + // Data Type: URL_LIST. Final mobile URLs for the ad when using Upgraded + // URLs. + FINAL_MOBILE_URLS = 15; + + // Data Type: URL. Tracking template for the ad when using Upgraded URLs. + TRACKING_URL = 16; + + // Data Type: STRING. Android app link. Must be formatted as: + // android-app://{package_id}/{scheme}/{host_path}. + // The components are defined as follows: + // package_id: app ID as specified in Google Play. + // scheme: the scheme to pass to the application. Can be HTTP, or a custom + // scheme. + // host_path: identifies the specific content within your application. + ANDROID_APP_LINK = 17; + + // Data Type: STRING_LIST. List of recommended local deal IDs to show + // together with this item. + SIMILAR_DEAL_IDS = 18; + + // Data Type: STRING. iOS app link. + IOS_APP_LINK = 19; + + // Data Type: INT64. iOS app store ID. + IOS_APP_STORE_ID = 20; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/location_extension_targeting_criterion_field.proto b/third_party/googleapis/google/ads/googleads/v3/enums/location_extension_targeting_criterion_field.proto new file mode 100644 index 000000000..99f4bc5e1 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/location_extension_targeting_criterion_field.proto @@ -0,0 +1,62 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "LocationExtensionTargetingCriterionFieldProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Location Extension Targeting criterion fields. + +// Values for Location Extension Targeting criterion fields. +message LocationExtensionTargetingCriterionFieldEnum { + // Possible values for Location Extension Targeting criterion fields. + enum LocationExtensionTargetingCriterionField { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Data Type: STRING. Line 1 of the business address. + ADDRESS_LINE_1 = 2; + + // Data Type: STRING. Line 2 of the business address. + ADDRESS_LINE_2 = 3; + + // Data Type: STRING. City of the business address. + CITY = 4; + + // Data Type: STRING. Province of the business address. + PROVINCE = 5; + + // Data Type: STRING. Postal code of the business address. + POSTAL_CODE = 6; + + // Data Type: STRING. Country code of the business address. + COUNTRY_CODE = 7; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/location_group_radius_units.proto b/third_party/googleapis/google/ads/googleads/v3/enums/location_group_radius_units.proto new file mode 100644 index 000000000..7a5480e20 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/location_group_radius_units.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "LocationGroupRadiusUnitsProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing location group radius units. + +// Container for enum describing unit of radius in location group. +message LocationGroupRadiusUnitsEnum { + // The unit of radius distance in location group (e.g. MILES) + enum LocationGroupRadiusUnits { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Meters + METERS = 2; + + // Miles + MILES = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/location_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v3/enums/location_placeholder_field.proto new file mode 100644 index 000000000..c8f4b4a73 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/location_placeholder_field.proto @@ -0,0 +1,68 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "LocationPlaceholderFieldProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Location placeholder fields. + +// Values for Location placeholder fields. +message LocationPlaceholderFieldEnum { + // Possible values for Location placeholder fields. + enum LocationPlaceholderField { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Data Type: STRING. The name of the business. + BUSINESS_NAME = 2; + + // Data Type: STRING. Line 1 of the business address. + ADDRESS_LINE_1 = 3; + + // Data Type: STRING. Line 2 of the business address. + ADDRESS_LINE_2 = 4; + + // Data Type: STRING. City of the business address. + CITY = 5; + + // Data Type: STRING. Province of the business address. + PROVINCE = 6; + + // Data Type: STRING. Postal code of the business address. + POSTAL_CODE = 7; + + // Data Type: STRING. Country code of the business address. + COUNTRY_CODE = 8; + + // Data Type: STRING. Phone number of the business. + PHONE_NUMBER = 9; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/manager_link_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/manager_link_status.proto new file mode 100644 index 000000000..5a5ea0776 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/manager_link_status.proto @@ -0,0 +1,59 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ManagerLinkStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Container for enum describing possible status of a manager and client link. +message ManagerLinkStatusEnum { + // Possible statuses of a link. + enum ManagerLinkStatus { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Indicates current in-effect relationship + ACTIVE = 2; + + // Indicates terminated relationship + INACTIVE = 3; + + // Indicates relationship has been requested by manager, but the client + // hasn't accepted yet. + PENDING = 4; + + // Relationship was requested by the manager, but the client has refused. + REFUSED = 5; + + // Indicates relationship has been requested by manager, but manager + // canceled it. + CANCELED = 6; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/matching_function_context_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/matching_function_context_type.proto new file mode 100644 index 000000000..3d123233e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/matching_function_context_type.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "MatchingFunctionContextTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing matching function context types. + +// Container for context types for an operand in a matching function. +message MatchingFunctionContextTypeEnum { + // Possible context types for an operand in a matching function. + enum MatchingFunctionContextType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Feed item id in the request context. + FEED_ITEM_ID = 2; + + // The device being used (possible values are 'Desktop' or 'Mobile'). + DEVICE_NAME = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/matching_function_operator.proto b/third_party/googleapis/google/ads/googleads/v3/enums/matching_function_operator.proto new file mode 100644 index 000000000..378a21be7 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/matching_function_operator.proto @@ -0,0 +1,65 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "MatchingFunctionOperatorProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing matching function operators. + +// Container for enum describing matching function operator. +message MatchingFunctionOperatorEnum { + // Possible operators in a matching function. + enum MatchingFunctionOperator { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The IN operator. + IN = 2; + + // The IDENTITY operator. + IDENTITY = 3; + + // The EQUALS operator + EQUALS = 4; + + // Operator that takes two or more operands that are of type + // FunctionOperand and checks that all the operands evaluate to true. + // For functions related to ad formats, all the operands must be in + // left_operands. + AND = 5; + + // Operator that returns true if the elements in left_operands contain any + // of the elements in right_operands. Otherwise, return false. The + // right_operands must contain at least 1 and no more than 3 + // ConstantOperands. + CONTAINS_ANY = 6; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/media_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/media_type.proto new file mode 100644 index 000000000..ce85a74e3 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/media_type.proto @@ -0,0 +1,64 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "MediaTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing media types. + +// Container for enum describing the types of media. +message MediaTypeEnum { + // The type of media. + enum MediaType { + // The media type has not been specified. + UNSPECIFIED = 0; + + // The received value is not known in this version. + // + // This is a response-only value. + UNKNOWN = 1; + + // Static image, used for image ad. + IMAGE = 2; + + // Small image, used for map ad. + ICON = 3; + + // ZIP file, used in fields of template ads. + MEDIA_BUNDLE = 4; + + // Audio file. + AUDIO = 5; + + // Video file. + VIDEO = 6; + + // Animated image, such as animated GIF. + DYNAMIC_IMAGE = 7; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/merchant_center_link_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/merchant_center_link_status.proto new file mode 100644 index 000000000..f60f9b19f --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/merchant_center_link_status.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "MerchantCenterLinkStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Merchant Center link statuses. + +// Container for enum describing possible statuses of a Google Merchant Center +// link. +message MerchantCenterLinkStatusEnum { + // Describes the possible statuses for a link between a Google Ads customer + // and a Google Merchant Center account. + enum MerchantCenterLinkStatus { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The link is enabled. + ENABLED = 2; + + // The link has no effect. It was proposed by the Merchant Center Account + // owner and hasn't been confirmed by the customer. + PENDING = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/message_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v3/enums/message_placeholder_field.proto new file mode 100644 index 000000000..57db0f293 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/message_placeholder_field.proto @@ -0,0 +1,61 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "MessagePlaceholderFieldProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Message placeholder fields. + +// Values for Message placeholder fields. +message MessagePlaceholderFieldEnum { + // Possible values for Message placeholder fields. + enum MessagePlaceholderField { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Data Type: STRING. The name of your business. + BUSINESS_NAME = 2; + + // Data Type: STRING. Country code of phone number. + COUNTRY_CODE = 3; + + // Data Type: STRING. A phone number that's capable of sending and receiving + // text messages. + PHONE_NUMBER = 4; + + // Data Type: STRING. The text that will go in your click-to-message ad. + MESSAGE_EXTENSION_TEXT = 5; + + // Data Type: STRING. The message text automatically shows in people's + // messaging apps when they tap to send you a message. + MESSAGE_TEXT = 6; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/mime_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/mime_type.proto new file mode 100644 index 000000000..7956c2535 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/mime_type.proto @@ -0,0 +1,82 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "MimeTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing mime types. + +// Container for enum describing the mime types. +message MimeTypeEnum { + // The mime type + enum MimeType { + // The mime type has not been specified. + UNSPECIFIED = 0; + + // The received value is not known in this version. + // + // This is a response-only value. + UNKNOWN = 1; + + // MIME type of image/jpeg. + IMAGE_JPEG = 2; + + // MIME type of image/gif. + IMAGE_GIF = 3; + + // MIME type of image/png. + IMAGE_PNG = 4; + + // MIME type of application/x-shockwave-flash. + FLASH = 5; + + // MIME type of text/html. + TEXT_HTML = 6; + + // MIME type of application/pdf. + PDF = 7; + + // MIME type of application/msword. + MSWORD = 8; + + // MIME type of application/vnd.ms-excel. + MSEXCEL = 9; + + // MIME type of application/rtf. + RTF = 10; + + // MIME type of audio/wav. + AUDIO_WAV = 11; + + // MIME type of audio/mp3. + AUDIO_MP3 = 12; + + // MIME type of application/x-html5-ad-zip. + HTML5_AD_ZIP = 13; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/minute_of_hour.proto b/third_party/googleapis/google/ads/googleads/v3/enums/minute_of_hour.proto new file mode 100644 index 000000000..1545fe9e4 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/minute_of_hour.proto @@ -0,0 +1,56 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "MinuteOfHourProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing days of week. + +// Container for enumeration of quarter-hours. +message MinuteOfHourEnum { + // Enumerates of quarter-hours. E.g. "FIFTEEN" + enum MinuteOfHour { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // Zero minutes past the hour. + ZERO = 2; + + // Fifteen minutes past the hour. + FIFTEEN = 3; + + // Thirty minutes past the hour. + THIRTY = 4; + + // Forty-five minutes past the hour. + FORTY_FIVE = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/mobile_device_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/mobile_device_type.proto new file mode 100644 index 000000000..8cdec0de8 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/mobile_device_type.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "MobileDeviceTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing mobile device types. + +// Container for enum describing the types of mobile device. +message MobileDeviceTypeEnum { + // The type of mobile device. + enum MobileDeviceType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Mobile phones. + MOBILE = 2; + + // Tablets. + TABLET = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/month_of_year.proto b/third_party/googleapis/google/ads/googleads/v3/enums/month_of_year.proto new file mode 100644 index 000000000..ae6255fd1 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/month_of_year.proto @@ -0,0 +1,80 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "MonthOfYearProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing days of week. + +// Container for enumeration of months of the year, e.g., "January". +message MonthOfYearEnum { + // Enumerates months of the year, e.g., "January". + enum MonthOfYear { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // January. + JANUARY = 2; + + // February. + FEBRUARY = 3; + + // March. + MARCH = 4; + + // April. + APRIL = 5; + + // May. + MAY = 6; + + // June. + JUNE = 7; + + // July. + JULY = 8; + + // August. + AUGUST = 9; + + // September. + SEPTEMBER = 10; + + // October. + OCTOBER = 11; + + // November. + NOVEMBER = 12; + + // December. + DECEMBER = 13; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/mutate_job_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/mutate_job_status.proto new file mode 100644 index 000000000..840ffe8be --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/mutate_job_status.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "MutateJobStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing mutate job statuses. + +// Container for enum describing possible mutate job statuses. +message MutateJobStatusEnum { + // The mutate job statuses. + enum MutateJobStatus { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The job is not currently running. + PENDING = 2; + + // The job is running. + RUNNING = 3; + + // The job is done. + DONE = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/negative_geo_target_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/negative_geo_target_type.proto new file mode 100644 index 000000000..7e19c16dc --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/negative_geo_target_type.proto @@ -0,0 +1,52 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "NegativeGeoTargetTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing negative geo target types. + +// Container for enum describing possible negative geo target types. +message NegativeGeoTargetTypeEnum { + // The possible negative geo target types. + enum NegativeGeoTargetType { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // Specifies that a user is excluded from seeing the ad if they + // are in, or show interest in, advertiser's excluded locations. + PRESENCE_OR_INTEREST = 4; + + // Specifies that a user is excluded from seeing the ad if they + // are in advertiser's excluded locations. + PRESENCE = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/offline_user_data_job_failure_reason.proto b/third_party/googleapis/google/ads/googleads/v3/enums/offline_user_data_job_failure_reason.proto new file mode 100644 index 000000000..c0dfad32d --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/offline_user_data_job_failure_reason.proto @@ -0,0 +1,51 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "OfflineUserDataJobFailureReasonProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing offline user data job failure reasons. + +// Container for enum describing reasons why an offline user data job +// failed to be processed. +message OfflineUserDataJobFailureReasonEnum { + // The failure reason of an offline user data job. + enum OfflineUserDataJobFailureReason { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The matched transactions are insufficient. + INSUFFICIENT_MATCHED_TRANSACTIONS = 2; + + // The uploaded transactions are insufficient. + INSUFFICIENT_TRANSACTIONS = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/offline_user_data_job_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/offline_user_data_job_status.proto new file mode 100644 index 000000000..b13b6eaed --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/offline_user_data_job_status.proto @@ -0,0 +1,56 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "OfflineUserDataJobStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing offline user data job status. + +// Container for enum describing status of an offline user data job. +message OfflineUserDataJobStatusEnum { + // The status of an offline user data job. + enum OfflineUserDataJobStatus { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The job has been successfully created and pending for uploading. + PENDING = 2; + + // Upload(s) have been accepted and data is being processed. + RUNNING = 3; + + // Uploaded data has been successfully processed. + SUCCESS = 4; + + // Uploaded data has failed to be processed. + FAILED = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/offline_user_data_job_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/offline_user_data_job_type.proto new file mode 100644 index 000000000..c1983eb70 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/offline_user_data_job_type.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "OfflineUserDataJobTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing offline user data job types. + +// Container for enum describing types of an offline user data job. +message OfflineUserDataJobTypeEnum { + // The type of an offline user data job. + enum OfflineUserDataJobType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Store Sales Direct data for self service. + STORE_SALES_UPLOAD_FIRST_PARTY = 2; + + // Store Sales Direct data for third party. + STORE_SALES_UPLOAD_THIRD_PARTY = 3; + + // Customer Match user list data. + CUSTOMER_MATCH_USER_LIST = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/operating_system_version_operator_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/operating_system_version_operator_type.proto new file mode 100644 index 000000000..d1369b20a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/operating_system_version_operator_type.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "OperatingSystemVersionOperatorTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing operating system version operator types. + +// Container for enum describing the type of OS operators. +message OperatingSystemVersionOperatorTypeEnum { + // The type of operating system version. + enum OperatingSystemVersionOperatorType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Equals to the specified version. + EQUALS_TO = 2; + + // Greater than or equals to the specified version. + GREATER_THAN_EQUALS_TO = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/page_one_promoted_strategy_goal.proto b/third_party/googleapis/google/ads/googleads/v3/enums/page_one_promoted_strategy_goal.proto new file mode 100644 index 000000000..7b0ad9dc6 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/page_one_promoted_strategy_goal.proto @@ -0,0 +1,30 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "PageOnePromotedStrategyGoalProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing bidding schemes. diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/parental_status_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/parental_status_type.proto new file mode 100644 index 000000000..ed4d12020 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/parental_status_type.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ParentalStatusTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing parenal status types. + +// Container for enum describing the type of demographic parental statuses. +message ParentalStatusTypeEnum { + // The type of parental statuses (e.g. not a parent). + enum ParentalStatusType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Parent. + PARENT = 300; + + // Not a parent. + NOT_A_PARENT = 301; + + // Undetermined parental status. + UNDETERMINED = 302; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/payment_mode.proto b/third_party/googleapis/google/ads/googleads/v3/enums/payment_mode.proto new file mode 100644 index 000000000..29ab88f2a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/payment_mode.proto @@ -0,0 +1,64 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "PaymentModeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing payment modes. + +// Container for enum describing possible payment modes. +message PaymentModeEnum { + // Enum describing possible payment modes. + enum PaymentMode { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Pay per click. + CLICKS = 4; + + // Pay per conversion value. This mode is only supported by campaigns with + // AdvertisingChannelType.HOTEL, BiddingStrategyType.COMMISSION, and + // BudgetType.HOTEL_ADS_COMMISSION. + CONVERSION_VALUE = 5; + + // Pay per conversion. This mode is only supported by campaigns with + // AdvertisingChannelType.DISPLAY (excluding + // AdvertisingChannelSubType.DISPLAY_GMAIL), BiddingStrategyType.TARGET_CPA, + // and BudgetType.FIXED_CPA. The customer must also be eligible for this + // mode. See Customer.eligibility_failure_reasons for details. + CONVERSIONS = 6; + + // Pay per guest stay value. This mode is only supported by campaigns with + // AdvertisingChannelType.HOTEL, BiddingStrategyType.COMMISSION, and + // BudgetType.STANDARD. + GUEST_STAY = 7; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/placeholder_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/placeholder_type.proto new file mode 100644 index 000000000..cd0959a1b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/placeholder_type.proto @@ -0,0 +1,121 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "PlaceholderTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing feed placeholder types. + +// Container for enum describing possible placeholder types for a feed mapping. +message PlaceholderTypeEnum { + // Possible placeholder types for a feed mapping. + enum PlaceholderType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Lets you show links in your ad to pages from your website, including the + // main landing page. + SITELINK = 2; + + // Lets you attach a phone number to an ad, allowing customers to call + // directly from the ad. + CALL = 3; + + // Lets you provide users with a link that points to a mobile app in + // addition to a website. + APP = 4; + + // Lets you show locations of businesses from your Google My Business + // account in your ad. This helps people find your locations by showing your + // ads with your address, a map to your location, or the distance to your + // business. This extension type is useful to draw customers to your + // brick-and-mortar location. + LOCATION = 5; + + // If you sell your product through retail chains, affiliate location + // extensions let you show nearby stores that carry your products. + AFFILIATE_LOCATION = 6; + + // Lets you include additional text with your search ads that provide + // detailed information about your business, including products and services + // you offer. Callouts appear in ads at the top and bottom of Google search + // results. + CALLOUT = 7; + + // Lets you add more info to your ad, specific to some predefined categories + // such as types, brands, styles, etc. A minimum of 3 text (SNIPPETS) values + // are required. + STRUCTURED_SNIPPET = 8; + + // Allows users to see your ad, click an icon, and contact you directly by + // text message. With one tap on your ad, people can contact you to book an + // appointment, get a quote, ask for information, or request a service. + MESSAGE = 9; + + // Lets you display prices for a list of items along with your ads. A price + // feed is composed of three to eight price table rows. + PRICE = 10; + + // Allows you to highlight sales and other promotions that let users see how + // they can save by buying now. + PROMOTION = 11; + + // Lets you dynamically inject custom data into the title and description + // of your ads. + AD_CUSTOMIZER = 12; + + // Indicates that this feed is for education dynamic remarketing. + DYNAMIC_EDUCATION = 13; + + // Indicates that this feed is for flight dynamic remarketing. + DYNAMIC_FLIGHT = 14; + + // Indicates that this feed is for a custom dynamic remarketing type. Use + // this only if the other business types don't apply to your products or + // services. + DYNAMIC_CUSTOM = 15; + + // Indicates that this feed is for hotels and rentals dynamic remarketing. + DYNAMIC_HOTEL = 16; + + // Indicates that this feed is for real estate dynamic remarketing. + DYNAMIC_REAL_ESTATE = 17; + + // Indicates that this feed is for travel dynamic remarketing. + DYNAMIC_TRAVEL = 18; + + // Indicates that this feed is for local deals dynamic remarketing. + DYNAMIC_LOCAL = 19; + + // Indicates that this feed is for job dynamic remarketing. + DYNAMIC_JOB = 20; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/placement_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/placement_type.proto new file mode 100644 index 000000000..942397dc3 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/placement_type.proto @@ -0,0 +1,59 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "PlacementTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing placement types. + +// Container for enum describing possible placement types. +message PlacementTypeEnum { + // Possible placement types for a feed mapping. + enum PlacementType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Websites(e.g. 'www.flowers4sale.com'). + WEBSITE = 2; + + // Mobile application categories(e.g. 'Games'). + MOBILE_APP_CATEGORY = 3; + + // mobile applications(e.g. 'mobileapp::2-com.whatsthewordanswers'). + MOBILE_APPLICATION = 4; + + // YouTube videos(e.g. 'youtube.com/video/wtLJPvx7-ys'). + YOUTUBE_VIDEO = 5; + + // YouTube channels(e.g. 'youtube.com::L8ZULXASCc1I_oaOT0NaOQ'). + YOUTUBE_CHANNEL = 6; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/policy_approval_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/policy_approval_status.proto new file mode 100644 index 000000000..9530d5268 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/policy_approval_status.proto @@ -0,0 +1,61 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "PolicyApprovalStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing policy approval statuses. + +// Container for enum describing possible policy approval statuses. +message PolicyApprovalStatusEnum { + // The possible policy approval statuses. When there are several approval + // statuses available the most severe one will be used. The order of severity + // is DISAPPROVED, AREA_OF_INTEREST_ONLY, APPROVED_LIMITED and APPROVED. + enum PolicyApprovalStatus { + // No value has been specified. + UNSPECIFIED = 0; + + // The received value is not known in this version. + // + // This is a response-only value. + UNKNOWN = 1; + + // Will not serve. + DISAPPROVED = 2; + + // Serves with restrictions. + APPROVED_LIMITED = 3; + + // Serves without restrictions. + APPROVED = 4; + + // Will not serve in targeted countries, but may serve for users who are + // searching for information about the targeted countries. + AREA_OF_INTEREST_ONLY = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/policy_review_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/policy_review_status.proto new file mode 100644 index 000000000..cdc9dde4c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/policy_review_status.proto @@ -0,0 +1,60 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "PolicyReviewStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing policy review statuses. + +// Container for enum describing possible policy review statuses. +message PolicyReviewStatusEnum { + // The possible policy review statuses. + enum PolicyReviewStatus { + // No value has been specified. + UNSPECIFIED = 0; + + // The received value is not known in this version. + // + // This is a response-only value. + UNKNOWN = 1; + + // Currently under review. + REVIEW_IN_PROGRESS = 2; + + // Primary review complete. Other reviews may be continuing. + REVIEWED = 3; + + // The resource has been resubmitted for approval or its policy decision has + // been appealed. + UNDER_APPEAL = 4; + + // The resource is eligible and may be serving but could still undergo + // further review. + ELIGIBLE_MAY_SERVE = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/policy_topic_entry_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/policy_topic_entry_type.proto new file mode 100644 index 000000000..087e18b9a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/policy_topic_entry_type.proto @@ -0,0 +1,66 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "PolicyTopicEntryTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing policy topic entry types. + +// Container for enum describing possible policy topic entry types. +message PolicyTopicEntryTypeEnum { + // The possible policy topic entry types. + enum PolicyTopicEntryType { + // No value has been specified. + UNSPECIFIED = 0; + + // The received value is not known in this version. + // + // This is a response-only value. + UNKNOWN = 1; + + // The resource will not be served. + PROHIBITED = 2; + + // The resource will not be served under some circumstances. + LIMITED = 4; + + // The resource cannot serve at all because of the current targeting + // criteria. + FULLY_LIMITED = 8; + + // May be of interest, but does not limit how the resource is served. + DESCRIPTIVE = 5; + + // Could increase coverage beyond normal. + BROADENING = 6; + + // Constrained for all targeted countries, but may serve in other countries + // through area of interest. + AREA_OF_INTEREST_ONLY = 7; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/policy_topic_evidence_destination_mismatch_url_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/policy_topic_evidence_destination_mismatch_url_type.proto new file mode 100644 index 000000000..d9abcddc4 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/policy_topic_evidence_destination_mismatch_url_type.proto @@ -0,0 +1,62 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "PolicyTopicEvidenceDestinationMismatchUrlTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing policy topic evidence destination mismatch url types. + +// Container for enum describing possible policy topic evidence destination +// mismatch url types. +message PolicyTopicEvidenceDestinationMismatchUrlTypeEnum { + // The possible policy topic evidence destination mismatch url types. + enum PolicyTopicEvidenceDestinationMismatchUrlType { + // No value has been specified. + UNSPECIFIED = 0; + + // The received value is not known in this version. + // + // This is a response-only value. + UNKNOWN = 1; + + // The display url. + DISPLAY_URL = 2; + + // The final url. + FINAL_URL = 3; + + // The final mobile url. + FINAL_MOBILE_URL = 4; + + // The tracking url template, with substituted desktop url. + TRACKING_URL = 5; + + // The tracking url template, with substituted mobile url. + MOBILE_TRACKING_URL = 6; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/policy_topic_evidence_destination_not_working_device.proto b/third_party/googleapis/google/ads/googleads/v3/enums/policy_topic_evidence_destination_not_working_device.proto new file mode 100644 index 000000000..bb77e67e2 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/policy_topic_evidence_destination_not_working_device.proto @@ -0,0 +1,57 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "PolicyTopicEvidenceDestinationNotWorkingDeviceProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing device of destination not working policy topic +// evidence. + +// Container for enum describing possible policy topic evidence destination not +// working devices. +message PolicyTopicEvidenceDestinationNotWorkingDeviceEnum { + // The possible policy topic evidence destination not working devices. + enum PolicyTopicEvidenceDestinationNotWorkingDevice { + // No value has been specified. + UNSPECIFIED = 0; + + // The received value is not known in this version. + // + // This is a response-only value. + UNKNOWN = 1; + + // Landing page doesn't work on desktop device. + DESKTOP = 2; + + // Landing page doesn't work on Android device. + ANDROID = 3; + + // Landing page doesn't work on iOS device. + IOS = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/policy_topic_evidence_destination_not_working_dns_error_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/policy_topic_evidence_destination_not_working_dns_error_type.proto new file mode 100644 index 000000000..5c33b35c2 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/policy_topic_evidence_destination_not_working_dns_error_type.proto @@ -0,0 +1,56 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "PolicyTopicEvidenceDestinationNotWorkingDnsErrorTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing DNS error types of destination not working policy topic +// evidence. + +// Container for enum describing possible policy topic evidence destination not +// working DNS error types. +message PolicyTopicEvidenceDestinationNotWorkingDnsErrorTypeEnum { + // The possible policy topic evidence destination not working DNS error types. + enum PolicyTopicEvidenceDestinationNotWorkingDnsErrorType { + // No value has been specified. + UNSPECIFIED = 0; + + // The received value is not known in this version. + // + // This is a response-only value. + UNKNOWN = 1; + + // Host name not found in DNS when fetching landing page. + HOSTNAME_NOT_FOUND = 2; + + // Google internal crawler issue when communicating with DNS. This error + // doesn't mean the landing page doesn't work. Google will recrawl the + // landing page. + GOOGLE_CRAWLER_DNS_ISSUE = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/positive_geo_target_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/positive_geo_target_type.proto new file mode 100644 index 000000000..7dc400989 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/positive_geo_target_type.proto @@ -0,0 +1,56 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "PositiveGeoTargetTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing positive geo target types. + +// Container for enum describing possible positive geo target types. +message PositiveGeoTargetTypeEnum { + // The possible positive geo target types. + enum PositiveGeoTargetType { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // Specifies that an ad is triggered if the user is in, + // or shows interest in, advertiser's targeted locations. + PRESENCE_OR_INTEREST = 5; + + // Specifies that an ad is triggered if the user + // searches for advertiser's targeted locations. + SEARCH_INTEREST = 6; + + // Specifies that an ad is triggered if the user is in + // or regularly in advertiser's targeted locations. + PRESENCE = 7; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/preferred_content_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/preferred_content_type.proto new file mode 100644 index 000000000..4e40b2a75 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/preferred_content_type.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "PreferredContentTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing preferred content criterion type. + +// Container for enumeration of preferred content criterion type. +message PreferredContentTypeEnum { + // Enumerates preferred content criterion type. + enum PreferredContentType { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // Represents top content on YouTube. + YOUTUBE_TOP_CONTENT = 400; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/price_extension_price_qualifier.proto b/third_party/googleapis/google/ads/googleads/v3/enums/price_extension_price_qualifier.proto new file mode 100644 index 000000000..36fb1d4e5 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/price_extension_price_qualifier.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "PriceExtensionPriceQualifierProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing price extension price qualifier type. + +// Container for enum describing a price extension price qualifier. +message PriceExtensionPriceQualifierEnum { + // Enums of price extension price qualifier. + enum PriceExtensionPriceQualifier { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // 'From' qualifier for the price. + FROM = 2; + + // 'Up to' qualifier for the price. + UP_TO = 3; + + // 'Average' qualifier for the price. + AVERAGE = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/price_extension_price_unit.proto b/third_party/googleapis/google/ads/googleads/v3/enums/price_extension_price_unit.proto new file mode 100644 index 000000000..6d5d06ad1 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/price_extension_price_unit.proto @@ -0,0 +1,62 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "PriceExtensionPriceUnitProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing price extension price unit. + +// Container for enum describing price extension price unit. +message PriceExtensionPriceUnitEnum { + // Price extension price unit. + enum PriceExtensionPriceUnit { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Per hour. + PER_HOUR = 2; + + // Per day. + PER_DAY = 3; + + // Per week. + PER_WEEK = 4; + + // Per month. + PER_MONTH = 5; + + // Per year. + PER_YEAR = 6; + + // Per night. + PER_NIGHT = 7; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/price_extension_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/price_extension_type.proto new file mode 100644 index 000000000..c2bccdced --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/price_extension_type.proto @@ -0,0 +1,71 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "PriceExtensionTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing price extension type. + +// Container for enum describing types for a price extension. +message PriceExtensionTypeEnum { + // Price extension type. + enum PriceExtensionType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The type for showing a list of brands. + BRANDS = 2; + + // The type for showing a list of events. + EVENTS = 3; + + // The type for showing locations relevant to your business. + LOCATIONS = 4; + + // The type for showing sub-regions or districts within a city or region. + NEIGHBORHOODS = 5; + + // The type for showing a collection of product categories. + PRODUCT_CATEGORIES = 6; + + // The type for showing a collection of related product tiers. + PRODUCT_TIERS = 7; + + // The type for showing a collection of services offered by your business. + SERVICES = 8; + + // The type for showing a collection of service categories. + SERVICE_CATEGORIES = 9; + + // The type for showing a collection of related service tiers. + SERVICE_TIERS = 10; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/price_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v3/enums/price_placeholder_field.proto new file mode 100644 index 000000000..15b3b82ef --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/price_placeholder_field.proto @@ -0,0 +1,240 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "PricePlaceholderFieldProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Price placeholder fields. + +// Values for Price placeholder fields. +message PricePlaceholderFieldEnum { + // Possible values for Price placeholder fields. + enum PricePlaceholderField { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Data Type: STRING. The type of your price feed. Must match one of the + // predefined price feed type exactly. + TYPE = 2; + + // Data Type: STRING. The qualifier of each price. Must match one of the + // predefined price qualifiers exactly. + PRICE_QUALIFIER = 3; + + // Data Type: URL. Tracking template for the price feed when using Upgraded + // URLs. + TRACKING_TEMPLATE = 4; + + // Data Type: STRING. Language of the price feed. Must match one of the + // available available locale codes exactly. + LANGUAGE = 5; + + // Data Type: STRING. Final URL suffix for the price feed when using + // parallel tracking. + FINAL_URL_SUFFIX = 6; + + // Data Type: STRING. The header of item 1 of the table. + ITEM_1_HEADER = 100; + + // Data Type: STRING. The description of item 1 of the table. + ITEM_1_DESCRIPTION = 101; + + // Data Type: MONEY. The price (money with currency) of item 1 of the table, + // e.g., 30 USD. The currency must match one of the available currencies. + ITEM_1_PRICE = 102; + + // Data Type: STRING. The price unit of item 1 of the table. Must match one + // of the predefined price units. + ITEM_1_UNIT = 103; + + // Data Type: URL_LIST. The final URLs of item 1 of the table when using + // Upgraded URLs. + ITEM_1_FINAL_URLS = 104; + + // Data Type: URL_LIST. The final mobile URLs of item 1 of the table when + // using Upgraded URLs. + ITEM_1_FINAL_MOBILE_URLS = 105; + + // Data Type: STRING. The header of item 2 of the table. + ITEM_2_HEADER = 200; + + // Data Type: STRING. The description of item 2 of the table. + ITEM_2_DESCRIPTION = 201; + + // Data Type: MONEY. The price (money with currency) of item 2 of the table, + // e.g., 30 USD. The currency must match one of the available currencies. + ITEM_2_PRICE = 202; + + // Data Type: STRING. The price unit of item 2 of the table. Must match one + // of the predefined price units. + ITEM_2_UNIT = 203; + + // Data Type: URL_LIST. The final URLs of item 2 of the table when using + // Upgraded URLs. + ITEM_2_FINAL_URLS = 204; + + // Data Type: URL_LIST. The final mobile URLs of item 2 of the table when + // using Upgraded URLs. + ITEM_2_FINAL_MOBILE_URLS = 205; + + // Data Type: STRING. The header of item 3 of the table. + ITEM_3_HEADER = 300; + + // Data Type: STRING. The description of item 3 of the table. + ITEM_3_DESCRIPTION = 301; + + // Data Type: MONEY. The price (money with currency) of item 3 of the table, + // e.g., 30 USD. The currency must match one of the available currencies. + ITEM_3_PRICE = 302; + + // Data Type: STRING. The price unit of item 3 of the table. Must match one + // of the predefined price units. + ITEM_3_UNIT = 303; + + // Data Type: URL_LIST. The final URLs of item 3 of the table when using + // Upgraded URLs. + ITEM_3_FINAL_URLS = 304; + + // Data Type: URL_LIST. The final mobile URLs of item 3 of the table when + // using Upgraded URLs. + ITEM_3_FINAL_MOBILE_URLS = 305; + + // Data Type: STRING. The header of item 4 of the table. + ITEM_4_HEADER = 400; + + // Data Type: STRING. The description of item 4 of the table. + ITEM_4_DESCRIPTION = 401; + + // Data Type: MONEY. The price (money with currency) of item 4 of the table, + // e.g., 30 USD. The currency must match one of the available currencies. + ITEM_4_PRICE = 402; + + // Data Type: STRING. The price unit of item 4 of the table. Must match one + // of the predefined price units. + ITEM_4_UNIT = 403; + + // Data Type: URL_LIST. The final URLs of item 4 of the table when using + // Upgraded URLs. + ITEM_4_FINAL_URLS = 404; + + // Data Type: URL_LIST. The final mobile URLs of item 4 of the table when + // using Upgraded URLs. + ITEM_4_FINAL_MOBILE_URLS = 405; + + // Data Type: STRING. The header of item 5 of the table. + ITEM_5_HEADER = 500; + + // Data Type: STRING. The description of item 5 of the table. + ITEM_5_DESCRIPTION = 501; + + // Data Type: MONEY. The price (money with currency) of item 5 of the table, + // e.g., 30 USD. The currency must match one of the available currencies. + ITEM_5_PRICE = 502; + + // Data Type: STRING. The price unit of item 5 of the table. Must match one + // of the predefined price units. + ITEM_5_UNIT = 503; + + // Data Type: URL_LIST. The final URLs of item 5 of the table when using + // Upgraded URLs. + ITEM_5_FINAL_URLS = 504; + + // Data Type: URL_LIST. The final mobile URLs of item 5 of the table when + // using Upgraded URLs. + ITEM_5_FINAL_MOBILE_URLS = 505; + + // Data Type: STRING. The header of item 6 of the table. + ITEM_6_HEADER = 600; + + // Data Type: STRING. The description of item 6 of the table. + ITEM_6_DESCRIPTION = 601; + + // Data Type: MONEY. The price (money with currency) of item 6 of the table, + // e.g., 30 USD. The currency must match one of the available currencies. + ITEM_6_PRICE = 602; + + // Data Type: STRING. The price unit of item 6 of the table. Must match one + // of the predefined price units. + ITEM_6_UNIT = 603; + + // Data Type: URL_LIST. The final URLs of item 6 of the table when using + // Upgraded URLs. + ITEM_6_FINAL_URLS = 604; + + // Data Type: URL_LIST. The final mobile URLs of item 6 of the table when + // using Upgraded URLs. + ITEM_6_FINAL_MOBILE_URLS = 605; + + // Data Type: STRING. The header of item 7 of the table. + ITEM_7_HEADER = 700; + + // Data Type: STRING. The description of item 7 of the table. + ITEM_7_DESCRIPTION = 701; + + // Data Type: MONEY. The price (money with currency) of item 7 of the table, + // e.g., 30 USD. The currency must match one of the available currencies. + ITEM_7_PRICE = 702; + + // Data Type: STRING. The price unit of item 7 of the table. Must match one + // of the predefined price units. + ITEM_7_UNIT = 703; + + // Data Type: URL_LIST. The final URLs of item 7 of the table when using + // Upgraded URLs. + ITEM_7_FINAL_URLS = 704; + + // Data Type: URL_LIST. The final mobile URLs of item 7 of the table when + // using Upgraded URLs. + ITEM_7_FINAL_MOBILE_URLS = 705; + + // Data Type: STRING. The header of item 8 of the table. + ITEM_8_HEADER = 800; + + // Data Type: STRING. The description of item 8 of the table. + ITEM_8_DESCRIPTION = 801; + + // Data Type: MONEY. The price (money with currency) of item 8 of the table, + // e.g., 30 USD. The currency must match one of the available currencies. + ITEM_8_PRICE = 802; + + // Data Type: STRING. The price unit of item 8 of the table. Must match one + // of the predefined price units. + ITEM_8_UNIT = 803; + + // Data Type: URL_LIST. The final URLs of item 8 of the table when using + // Upgraded URLs. + ITEM_8_FINAL_URLS = 804; + + // Data Type: URL_LIST. The final mobile URLs of item 8 of the table when + // using Upgraded URLs. + ITEM_8_FINAL_MOBILE_URLS = 805; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/product_bidding_category_level.proto b/third_party/googleapis/google/ads/googleads/v3/enums/product_bidding_category_level.proto new file mode 100644 index 000000000..4c0b0c162 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/product_bidding_category_level.proto @@ -0,0 +1,57 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ProductBiddingCategoryLevelProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Level of a product bidding category. +message ProductBiddingCategoryLevelEnum { + // Enum describing the level of the product bidding category. + enum ProductBiddingCategoryLevel { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Level 1. + LEVEL1 = 2; + + // Level 2. + LEVEL2 = 3; + + // Level 3. + LEVEL3 = 4; + + // Level 4. + LEVEL4 = 5; + + // Level 5. + LEVEL5 = 6; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/product_bidding_category_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/product_bidding_category_status.proto new file mode 100644 index 000000000..d3627f143 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/product_bidding_category_status.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ProductBiddingCategoryStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing bidding schemes. + +// Status of the product bidding category. +message ProductBiddingCategoryStatusEnum { + // Enum describing the status of the product bidding category. + enum ProductBiddingCategoryStatus { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The category is active and can be used for bidding. + ACTIVE = 2; + + // The category is obsolete. Used only for reporting purposes. + OBSOLETE = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/product_channel.proto b/third_party/googleapis/google/ads/googleads/v3/enums/product_channel.proto new file mode 100644 index 000000000..b1265b5a8 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/product_channel.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ProductChannelProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing bidding schemes. + +// Locality of a product offer. +message ProductChannelEnum { + // Enum describing the locality of a product offer. + enum ProductChannel { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The item is sold online. + ONLINE = 2; + + // The item is sold in local stores. + LOCAL = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/product_channel_exclusivity.proto b/third_party/googleapis/google/ads/googleads/v3/enums/product_channel_exclusivity.proto new file mode 100644 index 000000000..30b183fbb --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/product_channel_exclusivity.proto @@ -0,0 +1,52 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ProductChannelExclusivityProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing bidding schemes. + +// Availability of a product offer. +message ProductChannelExclusivityEnum { + // Enum describing the availability of a product offer. + enum ProductChannelExclusivity { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The item is sold through one channel only, either local stores or online + // as indicated by its ProductChannel. + SINGLE_CHANNEL = 2; + + // The item is matched to its online or local stores counterpart, indicating + // it is available for purchase in both ShoppingProductChannels. + MULTI_CHANNEL = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/product_condition.proto b/third_party/googleapis/google/ads/googleads/v3/enums/product_condition.proto new file mode 100644 index 000000000..c43d6031b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/product_condition.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ProductConditionProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing bidding schemes. + +// Condition of a product offer. +message ProductConditionEnum { + // Enum describing the condition of a product offer. + enum ProductCondition { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The product condition is new. + NEW = 3; + + // The product condition is refurbished. + REFURBISHED = 4; + + // The product condition is used. + USED = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/product_custom_attribute_index.proto b/third_party/googleapis/google/ads/googleads/v3/enums/product_custom_attribute_index.proto new file mode 100644 index 000000000..f4c5981db --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/product_custom_attribute_index.proto @@ -0,0 +1,59 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ProductCustomAttributeIndexProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing product custom attributes. + +// Container for enum describing the index of the product custom attribute. +message ProductCustomAttributeIndexEnum { + // The index of the product custom attribute. + enum ProductCustomAttributeIndex { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // First product custom attribute. + INDEX0 = 7; + + // Second product custom attribute. + INDEX1 = 8; + + // Third product custom attribute. + INDEX2 = 9; + + // Fourth product custom attribute. + INDEX3 = 10; + + // Fifth product custom attribute. + INDEX4 = 11; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/product_type_level.proto b/third_party/googleapis/google/ads/googleads/v3/enums/product_type_level.proto new file mode 100644 index 000000000..4fc7b976b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/product_type_level.proto @@ -0,0 +1,59 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ProductTypeLevelProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing bidding schemes. + +// Level of the type of a product offer. +message ProductTypeLevelEnum { + // Enum describing the level of the type of a product offer. + enum ProductTypeLevel { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Level 1. + LEVEL1 = 7; + + // Level 2. + LEVEL2 = 8; + + // Level 3. + LEVEL3 = 9; + + // Level 4. + LEVEL4 = 10; + + // Level 5. + LEVEL5 = 11; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/promotion_extension_discount_modifier.proto b/third_party/googleapis/google/ads/googleads/v3/enums/promotion_extension_discount_modifier.proto new file mode 100644 index 000000000..467ac2482 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/promotion_extension_discount_modifier.proto @@ -0,0 +1,48 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "PromotionExtensionDiscountModifierProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing promotion extension discount modifier. + +// Container for enum describing possible a promotion extension +// discount modifier. +message PromotionExtensionDiscountModifierEnum { + // A promotion extension discount modifier. + enum PromotionExtensionDiscountModifier { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // 'Up to'. + UP_TO = 2; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/promotion_extension_occasion.proto b/third_party/googleapis/google/ads/googleads/v3/enums/promotion_extension_occasion.proto new file mode 100644 index 000000000..493667ea4 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/promotion_extension_occasion.proto @@ -0,0 +1,157 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "PromotionExtensionOccasionProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing promotion extension occasion. + +// Container for enum describing a promotion extension occasion. +// For more information about the occasions please check: +// https://support.google.com/google-ads/answer/7367521 +message PromotionExtensionOccasionEnum { + // A promotion extension occasion. + enum PromotionExtensionOccasion { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // New Year's. + NEW_YEARS = 2; + + // Chinese New Year. + CHINESE_NEW_YEAR = 3; + + // Valentine's Day. + VALENTINES_DAY = 4; + + // Easter. + EASTER = 5; + + // Mother's Day. + MOTHERS_DAY = 6; + + // Father's Day. + FATHERS_DAY = 7; + + // Labor Day. + LABOR_DAY = 8; + + // Back To School. + BACK_TO_SCHOOL = 9; + + // Halloween. + HALLOWEEN = 10; + + // Black Friday. + BLACK_FRIDAY = 11; + + // Cyber Monday. + CYBER_MONDAY = 12; + + // Christmas. + CHRISTMAS = 13; + + // Boxing Day. + BOXING_DAY = 14; + + // Independence Day in any country. + INDEPENDENCE_DAY = 15; + + // National Day in any country. + NATIONAL_DAY = 16; + + // End of any season. + END_OF_SEASON = 17; + + // Winter Sale. + WINTER_SALE = 18; + + // Summer sale. + SUMMER_SALE = 19; + + // Fall Sale. + FALL_SALE = 20; + + // Spring Sale. + SPRING_SALE = 21; + + // Ramadan. + RAMADAN = 22; + + // Eid al-Fitr. + EID_AL_FITR = 23; + + // Eid al-Adha. + EID_AL_ADHA = 24; + + // Singles Day. + SINGLES_DAY = 25; + + // Women's Day. + WOMENS_DAY = 26; + + // Holi. + HOLI = 27; + + // Parent's Day. + PARENTS_DAY = 28; + + // St. Nicholas Day. + ST_NICHOLAS_DAY = 29; + + // Carnival. + CARNIVAL = 30; + + // Epiphany, also known as Three Kings' Day. + EPIPHANY = 31; + + // Rosh Hashanah. + ROSH_HASHANAH = 32; + + // Passover. + PASSOVER = 33; + + // Hanukkah. + HANUKKAH = 34; + + // Diwali. + DIWALI = 35; + + // Navratri. + NAVRATRI = 36; + + // Available in Thai: Songkran. + SONGKRAN = 37; + + // Available in Japanese: Year-end Gift. + YEAR_END_GIFT = 38; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/promotion_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v3/enums/promotion_placeholder_field.proto new file mode 100644 index 000000000..9b6d74b95 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/promotion_placeholder_field.proto @@ -0,0 +1,95 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "PromotionPlaceholderFieldProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Promotion placeholder fields. + +// Values for Promotion placeholder fields. +message PromotionPlaceholderFieldEnum { + // Possible values for Promotion placeholder fields. + enum PromotionPlaceholderField { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Data Type: STRING. The text that appears on the ad when the extension is + // shown. + PROMOTION_TARGET = 2; + + // Data Type: STRING. Allows you to add "up to" phrase to the promotion, + // in case you have variable promotion rates. + DISCOUNT_MODIFIER = 3; + + // Data Type: INT64. Takes a value in micros, where 1 million micros + // represents 1%, and is shown as a percentage when rendered. + PERCENT_OFF = 4; + + // Data Type: MONEY. Requires a currency and an amount of money. + MONEY_AMOUNT_OFF = 5; + + // Data Type: STRING. A string that the user enters to get the discount. + PROMOTION_CODE = 6; + + // Data Type: MONEY. A minimum spend before the user qualifies for the + // promotion. + ORDERS_OVER_AMOUNT = 7; + + // Data Type: DATE. The start date of the promotion. + PROMOTION_START = 8; + + // Data Type: DATE. The end date of the promotion. + PROMOTION_END = 9; + + // Data Type: STRING. Describes the associated event for the promotion using + // one of the PromotionExtensionOccasion enum values, for example NEW_YEARS. + OCCASION = 10; + + // Data Type: URL_LIST. Final URLs to be used in the ad when using Upgraded + // URLs. + FINAL_URLS = 11; + + // Data Type: URL_LIST. Final mobile URLs for the ad when using Upgraded + // URLs. + FINAL_MOBILE_URLS = 12; + + // Data Type: URL. Tracking template for the ad when using Upgraded URLs. + TRACKING_URL = 13; + + // Data Type: STRING. A string represented by a language code for the + // promotion. + LANGUAGE = 14; + + // Data Type: STRING. Final URL suffix for the ad when using parallel + // tracking. + FINAL_URL_SUFFIX = 15; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/proximity_radius_units.proto b/third_party/googleapis/google/ads/googleads/v3/enums/proximity_radius_units.proto new file mode 100644 index 000000000..986ca5579 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/proximity_radius_units.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ProximityRadiusUnitsProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing proximity radius units. + +// Container for enum describing unit of radius in proximity. +message ProximityRadiusUnitsEnum { + // The unit of radius distance in proximity (e.g. MILES) + enum ProximityRadiusUnits { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Miles + MILES = 2; + + // Kilometers + KILOMETERS = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/quality_score_bucket.proto b/third_party/googleapis/google/ads/googleads/v3/enums/quality_score_bucket.proto new file mode 100644 index 000000000..3b9e9b6f1 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/quality_score_bucket.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "QualityScoreBucketProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing quality score buckets. + +// The relative performance compared to other advertisers. +message QualityScoreBucketEnum { + // Enum listing the possible quality score buckets. + enum QualityScoreBucket { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Quality of the creative is below average. + BELOW_AVERAGE = 2; + + // Quality of the creative is average. + AVERAGE = 3; + + // Quality of the creative is above average. + ABOVE_AVERAGE = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/reach_plan_ad_length.proto b/third_party/googleapis/google/ads/googleads/v3/enums/reach_plan_ad_length.proto new file mode 100644 index 000000000..230918343 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/reach_plan_ad_length.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ReachPlanAdLengthProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing ad lengths of a plannable video ad. + +// Message describing length of a plannable video ad. +message ReachPlanAdLengthEnum { + // Possible ad length values. + enum ReachPlanAdLength { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // 6 seconds long ad. + SIX_SECONDS = 2; + + // 15 or 20 seconds long ad. + FIFTEEN_OR_TWENTY_SECONDS = 3; + + // More than 20 seconds long ad. + TWENTY_SECONDS_OR_MORE = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/reach_plan_age_range.proto b/third_party/googleapis/google/ads/googleads/v3/enums/reach_plan_age_range.proto new file mode 100644 index 000000000..8bfa2fa8b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/reach_plan_age_range.proto @@ -0,0 +1,122 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ReachPlanAgeRangeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing a plannable age range. + +// Message describing plannable age ranges. +message ReachPlanAgeRangeEnum { + // Possible plannable age range values. + enum ReachPlanAgeRange { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // Between 18 and 24 years old. + AGE_RANGE_18_24 = 503001; + + // Between 18 and 34 years old. + AGE_RANGE_18_34 = 2; + + // Between 18 and 44 years old. + AGE_RANGE_18_44 = 3; + + // Between 18 and 49 years old. + AGE_RANGE_18_49 = 4; + + // Between 18 and 54 years old. + AGE_RANGE_18_54 = 5; + + // Between 18 and 64 years old. + AGE_RANGE_18_64 = 6; + + // Between 18 and 65+ years old. + AGE_RANGE_18_65_UP = 7; + + // Between 21 and 34 years old. + AGE_RANGE_21_34 = 8; + + // Between 25 and 34 years old. + AGE_RANGE_25_34 = 503002; + + // Between 25 and 44 years old. + AGE_RANGE_25_44 = 9; + + // Between 25 and 49 years old. + AGE_RANGE_25_49 = 10; + + // Between 25 and 54 years old. + AGE_RANGE_25_54 = 11; + + // Between 25 and 64 years old. + AGE_RANGE_25_64 = 12; + + // Between 25 and 65+ years old. + AGE_RANGE_25_65_UP = 13; + + // Between 35 and 44 years old. + AGE_RANGE_35_44 = 503003; + + // Between 35 and 49 years old. + AGE_RANGE_35_49 = 14; + + // Between 35 and 54 years old. + AGE_RANGE_35_54 = 15; + + // Between 35 and 64 years old. + AGE_RANGE_35_64 = 16; + + // Between 35 and 65+ years old. + AGE_RANGE_35_65_UP = 17; + + // Between 45 and 54 years old. + AGE_RANGE_45_54 = 503004; + + // Between 45 and 64 years old. + AGE_RANGE_45_64 = 18; + + // Between 45 and 65+ years old. + AGE_RANGE_45_65_UP = 19; + + // Between 50 and 65+ years old. + AGE_RANGE_50_65_UP = 20; + + // Between 55 and 64 years old. + AGE_RANGE_55_64 = 503005; + + // Between 55 and 65+ years old. + AGE_RANGE_55_65_UP = 21; + + // 65 years old and beyond. + AGE_RANGE_65_UP = 503006; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/reach_plan_network.proto b/third_party/googleapis/google/ads/googleads/v3/enums/reach_plan_network.proto new file mode 100644 index 000000000..5c3029e6c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/reach_plan_network.proto @@ -0,0 +1,54 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ReachPlanNetworkProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing a plannable network. + +// Container for enum describing plannable networks. +message ReachPlanNetworkEnum { + // Possible plannable network values. + enum ReachPlanNetwork { + // Not specified. + UNSPECIFIED = 0; + + // Used as a return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // YouTube network. + YOUTUBE = 2; + + // Google Video Partners (GVP) network. + GOOGLE_VIDEO_PARTNERS = 3; + + // A combination of the YouTube network and the Google Video Partners + // network. + YOUTUBE_AND_GOOGLE_VIDEO_PARTNERS = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/real_estate_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v3/enums/real_estate_placeholder_field.proto new file mode 100644 index 000000000..11e113eb6 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/real_estate_placeholder_field.proto @@ -0,0 +1,115 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "RealEstatePlaceholderFieldProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Real Estate placeholder fields. + +// Values for Real Estate placeholder fields. +// For more information about dynamic remarketing feeds, see +// https://support.google.com/google-ads/answer/6053288. +message RealEstatePlaceholderFieldEnum { + // Possible values for Real Estate placeholder fields. + enum RealEstatePlaceholderField { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Data Type: STRING. Unique ID. + LISTING_ID = 2; + + // Data Type: STRING. Main headline with listing name to be shown in dynamic + // ad. + LISTING_NAME = 3; + + // Data Type: STRING. City name to be shown in dynamic ad. + CITY_NAME = 4; + + // Data Type: STRING. Description of listing to be shown in dynamic ad. + DESCRIPTION = 5; + + // Data Type: STRING. Complete listing address, including postal code. + ADDRESS = 6; + + // Data Type: STRING. Price to be shown in the ad. + // Example: "100.00 USD" + PRICE = 7; + + // Data Type: STRING. Formatted price to be shown in the ad. + // Example: "Starting at $100.00 USD", "$80 - $100" + FORMATTED_PRICE = 8; + + // Data Type: URL. Image to be displayed in the ad. + IMAGE_URL = 9; + + // Data Type: STRING. Type of property (house, condo, apartment, etc.) used + // to group like items together for recommendation engine. + PROPERTY_TYPE = 10; + + // Data Type: STRING. Type of listing (resale, rental, foreclosure, etc.) + // used to group like items together for recommendation engine. + LISTING_TYPE = 11; + + // Data Type: STRING_LIST. Keywords used for product retrieval. + CONTEXTUAL_KEYWORDS = 12; + + // Data Type: URL_LIST. Final URLs to be used in ad when using Upgraded + // URLs; the more specific the better (e.g. the individual URL of a specific + // listing and its location). + FINAL_URLS = 13; + + // Data Type: URL_LIST. Final mobile URLs for the ad when using Upgraded + // URLs. + FINAL_MOBILE_URLS = 14; + + // Data Type: URL. Tracking template for the ad when using Upgraded URLs. + TRACKING_URL = 15; + + // Data Type: STRING. Android app link. Must be formatted as: + // android-app://{package_id}/{scheme}/{host_path}. + // The components are defined as follows: + // package_id: app ID as specified in Google Play. + // scheme: the scheme to pass to the application. Can be HTTP, or a custom + // scheme. + // host_path: identifies the specific content within your application. + ANDROID_APP_LINK = 16; + + // Data Type: STRING_LIST. List of recommended listing IDs to show together + // with this item. + SIMILAR_LISTING_IDS = 17; + + // Data Type: STRING. iOS app link. + IOS_APP_LINK = 18; + + // Data Type: INT64. iOS app store ID. + IOS_APP_STORE_ID = 19; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/recommendation_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/recommendation_type.proto new file mode 100644 index 000000000..398c307f1 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/recommendation_type.proto @@ -0,0 +1,92 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "RecommendationTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Recommendation types. + +// Container for enum describing types of recommendations. +message RecommendationTypeEnum { + // Types of recommendations. + enum RecommendationType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Budget recommendation for budget constrained campaigns. + CAMPAIGN_BUDGET = 2; + + // Keyword recommendation. + KEYWORD = 3; + + // Recommendation to add a new text ad. + TEXT_AD = 4; + + // Recommendation to update a campaign to use a Target CPA bidding strategy. + TARGET_CPA_OPT_IN = 5; + + // Recommendation to update a campaign to use the Maximize Conversions + // bidding strategy. + MAXIMIZE_CONVERSIONS_OPT_IN = 6; + + // Recommendation to enable Enhanced Cost Per Click for a campaign. + ENHANCED_CPC_OPT_IN = 7; + + // Recommendation to start showing your campaign's ads on Google Search + // Partners Websites. + SEARCH_PARTNERS_OPT_IN = 8; + + // Recommendation to update a campaign to use a Maximize Clicks bidding + // strategy. + MAXIMIZE_CLICKS_OPT_IN = 9; + + // Recommendation to start using the "Optimize" ad rotation setting for the + // given ad group. + OPTIMIZE_AD_ROTATION = 10; + + // Recommendation to add callout extensions to a campaign. + CALLOUT_EXTENSION = 11; + + // Recommendation to add sitelink extensions to a campaign. + SITELINK_EXTENSION = 12; + + // Recommendation to add call extensions to a campaign. + CALL_EXTENSION = 13; + + // Recommendation to change an existing keyword from one match type to a + // broader match type. + KEYWORD_MATCH_TYPE = 14; + + // Recommendation to move unused budget from one budget to a constrained + // budget. + MOVE_UNUSED_BUDGET = 15; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/search_engine_results_page_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/search_engine_results_page_type.proto new file mode 100644 index 000000000..0858f0c80 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/search_engine_results_page_type.proto @@ -0,0 +1,54 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "SearchEngineResultsPageTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing search engine results page types. + +// The type of the search engine results page. +message SearchEngineResultsPageTypeEnum { + // The type of the search engine results page. + enum SearchEngineResultsPageType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Only ads were contained in the search engine results page. + ADS_ONLY = 2; + + // Only organic results were contained in the search engine results page. + ORGANIC_ONLY = 3; + + // Both ads and organic results were contained in the search engine results + // page. + ADS_AND_ORGANIC = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/search_term_match_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/search_term_match_type.proto new file mode 100644 index 000000000..47981c4b0 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/search_term_match_type.proto @@ -0,0 +1,59 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "SearchTermMatchTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing search term match types. + +// Container for enum describing match types for a keyword triggering an ad. +message SearchTermMatchTypeEnum { + // Possible match types for a keyword triggering an ad, including variants. + enum SearchTermMatchType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Broad match. + BROAD = 2; + + // Exact match. + EXACT = 3; + + // Phrase match. + PHRASE = 4; + + // Exact match (close variant). + NEAR_EXACT = 5; + + // Phrase match (close variant). + NEAR_PHRASE = 6; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/search_term_targeting_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/search_term_targeting_status.proto new file mode 100644 index 000000000..cff59dfcc --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/search_term_targeting_status.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "SearchTermTargetingStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing search term targeting statuses. + +// Container for enum indicating whether a search term is one of your targeted +// or excluded keywords. +message SearchTermTargetingStatusEnum { + // Indicates whether the search term is one of your targeted or excluded + // keywords. + enum SearchTermTargetingStatus { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Search term is added to targeted keywords. + ADDED = 2; + + // Search term matches a negative keyword. + EXCLUDED = 3; + + // Search term has been both added and excluded. + ADDED_EXCLUDED = 4; + + // Search term is neither targeted nor excluded. + NONE = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/served_asset_field_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/served_asset_field_type.proto new file mode 100644 index 000000000..5b0fdecb3 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/served_asset_field_type.proto @@ -0,0 +1,61 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "ServedAssetFieldTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing policy review statuses. + +// Container for enum describing possible asset field types. +message ServedAssetFieldTypeEnum { + // The possible asset field types. + enum ServedAssetFieldType { + // No value has been specified. + UNSPECIFIED = 0; + + // The received value is not known in this version. + // + // This is a response-only value. + UNKNOWN = 1; + + // The asset is used in headline 1. + HEADLINE_1 = 2; + + // The asset is used in headline 2. + HEADLINE_2 = 3; + + // The asset is used in headline 3. + HEADLINE_3 = 4; + + // The asset is used in description 1. + DESCRIPTION_1 = 5; + + // The asset is used in description 2. + DESCRIPTION_2 = 6; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/shared_set_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/shared_set_status.proto new file mode 100644 index 000000000..5eba8cd19 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/shared_set_status.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "SharedSetStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing shared set statuses. + +// Container for enum describing types of shared set statuses. +message SharedSetStatusEnum { + // Enum listing the possible shared set statuses. + enum SharedSetStatus { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The shared set is enabled. + ENABLED = 2; + + // The shared set is removed and can no longer be used. + REMOVED = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/shared_set_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/shared_set_type.proto new file mode 100644 index 000000000..cbcb1cc7c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/shared_set_type.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "SharedSetTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing shared set types. + +// Container for enum describing types of shared sets. +message SharedSetTypeEnum { + // Enum listing the possible shared set types. + enum SharedSetType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // A set of keywords that can be excluded from targeting. + NEGATIVE_KEYWORDS = 2; + + // A set of placements that can be excluded from targeting. + NEGATIVE_PLACEMENTS = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/simulation_modification_method.proto b/third_party/googleapis/google/ads/googleads/v3/enums/simulation_modification_method.proto new file mode 100644 index 000000000..069f6a257 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/simulation_modification_method.proto @@ -0,0 +1,54 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "SimulationModificationMethodProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing simulation modification methods. + +// Container for enum describing the method by which a simulation modifies +// a field. +message SimulationModificationMethodEnum { + // Enum describing the method by which a simulation modifies a field. + enum SimulationModificationMethod { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The values in a simulation were applied to all children of a given + // resource uniformly. Overrides on child resources were not respected. + UNIFORM = 2; + + // The values in a simulation were applied to the given resource. + // Overrides on child resources were respected, and traffic estimates + // do not include these resources. + DEFAULT = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/simulation_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/simulation_type.proto new file mode 100644 index 000000000..bdc9cf299 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/simulation_type.proto @@ -0,0 +1,56 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "SimulationTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing simulation types. + +// Container for enum describing the field a simulation modifies. +message SimulationTypeEnum { + // Enum describing the field a simulation modifies. + enum SimulationType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The simulation is for a cpc bid. + CPC_BID = 2; + + // The simulation is for a cpv bid. + CPV_BID = 3; + + // The simulation is for a cpa target. + TARGET_CPA = 4; + + // The simulation is for a bid modifier. + BID_MODIFIER = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/sitelink_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v3/enums/sitelink_placeholder_field.proto new file mode 100644 index 000000000..ccc367685 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/sitelink_placeholder_field.proto @@ -0,0 +1,69 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "SitelinkPlaceholderFieldProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Sitelink placeholder fields. + +// Values for Sitelink placeholder fields. +message SitelinkPlaceholderFieldEnum { + // Possible values for Sitelink placeholder fields. + enum SitelinkPlaceholderField { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Data Type: STRING. The link text for your sitelink. + TEXT = 2; + + // Data Type: STRING. First line of the sitelink description. + LINE_1 = 3; + + // Data Type: STRING. Second line of the sitelink description. + LINE_2 = 4; + + // Data Type: URL_LIST. Final URLs for the sitelink when using Upgraded + // URLs. + FINAL_URLS = 5; + + // Data Type: URL_LIST. Final Mobile URLs for the sitelink when using + // Upgraded URLs. + FINAL_MOBILE_URLS = 6; + + // Data Type: URL. Tracking template for the sitelink when using Upgraded + // URLs. + TRACKING_URL = 7; + + // Data Type: STRING. Final URL suffix for sitelink when using parallel + // tracking. + FINAL_URL_SUFFIX = 8; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/slot.proto b/third_party/googleapis/google/ads/googleads/v3/enums/slot.proto new file mode 100644 index 000000000..702ed1479 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/slot.proto @@ -0,0 +1,65 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "SlotProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing slots. + +// Container for enumeration of possible positions of the Ad. +message SlotEnum { + // Enumerates possible positions of the Ad. + enum Slot { + // Not specified. + UNSPECIFIED = 0; + + // The value is unknown in this version. + UNKNOWN = 1; + + // Google search: Side. + SEARCH_SIDE = 2; + + // Google search: Top. + SEARCH_TOP = 3; + + // Google search: Other. + SEARCH_OTHER = 4; + + // Google Display Network. + CONTENT = 5; + + // Search partners: Top. + SEARCH_PARTNER_TOP = 6; + + // Search partners: Other. + SEARCH_PARTNER_OTHER = 7; + + // Cross-network. + MIXED = 8; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/spending_limit_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/spending_limit_type.proto new file mode 100644 index 000000000..da6a155b2 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/spending_limit_type.proto @@ -0,0 +1,48 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "SpendingLimitTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing SpendingLimit types. + +// Message describing spending limit types. +message SpendingLimitTypeEnum { + // The possible spending limit types used by certain resources as an + // alternative to absolute money values in micros. + enum SpendingLimitType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Infinite, indicates unlimited spending power. + INFINITE = 2; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/structured_snippet_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v3/enums/structured_snippet_placeholder_field.proto new file mode 100644 index 000000000..6f43aa196 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/structured_snippet_placeholder_field.proto @@ -0,0 +1,55 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "StructuredSnippetPlaceholderFieldProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Structured Snippet placeholder fields. + +// Values for Structured Snippet placeholder fields. +message StructuredSnippetPlaceholderFieldEnum { + // Possible values for Structured Snippet placeholder fields. + enum StructuredSnippetPlaceholderField { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Data Type: STRING. The category of snippet of your products/services. + // Must match exactly one of the predefined structured snippets headers. + // For a list, visit + // https://developers.google.com/adwords/api/docs/appendix/structured-snippet-headers + HEADER = 2; + + // Data Type: STRING_LIST. Text values that describe your products/services. + // All text must be family safe. Special or non-ASCII characters are not + // permitted. A snippet can be at most 25 characters. + SNIPPETS = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/summary_row_setting.proto b/third_party/googleapis/google/ads/googleads/v3/enums/summary_row_setting.proto new file mode 100644 index 000000000..010df227c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/summary_row_setting.proto @@ -0,0 +1,54 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "SummaryRowSettingProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing summary row setting. + +// Indicates summary row setting in request parameter. +message SummaryRowSettingEnum { + // Enum describing return summary row settings. + enum SummaryRowSetting { + // Not specified. + UNSPECIFIED = 0; + + // Represent unknown values of return summary row. + UNKNOWN = 1; + + // Do not return summary row. + NO_SUMMARY_ROW = 2; + + // Return summary row along with results. The summary row will be returned + // in the last batch alone (last batch will contain no results). + SUMMARY_ROW_WITH_RESULTS = 3; + + // Return summary row only and return no results. + SUMMARY_ROW_ONLY = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/system_managed_entity_source.proto b/third_party/googleapis/google/ads/googleads/v3/enums/system_managed_entity_source.proto new file mode 100644 index 000000000..0d1ff47a8 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/system_managed_entity_source.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "SystemManagedEntitySourceProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing system managed entity sources. + +// Container for enum describing possible system managed entity sources. +message SystemManagedResourceSourceEnum { + // Enum listing the possible system managed entity sources. + enum SystemManagedResourceSource { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Generated ad variations experiment ad. + AD_VARIATIONS = 2; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/target_cpa_opt_in_recommendation_goal.proto b/third_party/googleapis/google/ads/googleads/v3/enums/target_cpa_opt_in_recommendation_goal.proto new file mode 100644 index 000000000..828460dbb --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/target_cpa_opt_in_recommendation_goal.proto @@ -0,0 +1,57 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "TargetCpaOptInRecommendationGoalProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing TargetCpaOptIn recommendation goals. + +// Container for enum describing goals for TargetCpaOptIn recommendation. +message TargetCpaOptInRecommendationGoalEnum { + // Goal of TargetCpaOptIn recommendation. + enum TargetCpaOptInRecommendationGoal { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Recommendation to set Target CPA to maintain the same cost. + SAME_COST = 2; + + // Recommendation to set Target CPA to maintain the same conversions. + SAME_CONVERSIONS = 3; + + // Recommendation to set Target CPA to maintain the same CPA. + SAME_CPA = 4; + + // Recommendation to set Target CPA to a value that is as close as possible + // to, yet lower than, the actual CPA (computed for past 28 days). + CLOSEST_CPA = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/target_impression_share_location.proto b/third_party/googleapis/google/ads/googleads/v3/enums/target_impression_share_location.proto new file mode 100644 index 000000000..e26046e7b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/target_impression_share_location.proto @@ -0,0 +1,55 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "TargetImpressionShareLocationProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing target impression share goal. + +// Container for enum describing where on the first search results page the +// automated bidding system should target impressions for the +// TargetImpressionShare bidding strategy. +message TargetImpressionShareLocationEnum { + // Enum describing possible goals. + enum TargetImpressionShareLocation { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Any location on the web page. + ANYWHERE_ON_PAGE = 2; + + // Top box of ads. + TOP_OF_PAGE = 3; + + // Top slot in the top box of ads. + ABSOLUTE_TOP_OF_PAGE = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/targeting_dimension.proto b/third_party/googleapis/google/ads/googleads/v3/enums/targeting_dimension.proto new file mode 100644 index 000000000..3e31dc6fe --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/targeting_dimension.proto @@ -0,0 +1,74 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "TargetingDimensionProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing criteria types. + +// The dimensions that can be targeted. +message TargetingDimensionEnum { + // Enum describing possible targeting dimensions. + enum TargetingDimension { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Keyword criteria, e.g. 'mars cruise'. KEYWORD may be used as a custom bid + // dimension. Keywords are always a targeting dimension, so may not be set + // as a target "ALL" dimension with TargetRestriction. + KEYWORD = 2; + + // Audience criteria, which include user list, user interest, custom + // affinity, and custom in market. + AUDIENCE = 3; + + // Topic criteria for targeting categories of content, e.g. + // 'category::Animals>Pets' Used for Display and Video targeting. + TOPIC = 4; + + // Criteria for targeting gender. + GENDER = 5; + + // Criteria for targeting age ranges. + AGE_RANGE = 6; + + // Placement criteria, which include websites like 'www.flowers4sale.com', + // as well as mobile applications, mobile app categories, YouTube videos, + // and YouTube channels. + PLACEMENT = 7; + + // Criteria for parental status targeting. + PARENTAL_STATUS = 8; + + // Criteria for income range targeting. + INCOME_RANGE = 9; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/time_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/time_type.proto new file mode 100644 index 000000000..80925901c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/time_type.proto @@ -0,0 +1,51 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "TimeTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing TimeType types. + +// Message describing time types. +message TimeTypeEnum { + // The possible time types used by certain resources as an alternative to + // absolute timestamps. + enum TimeType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // As soon as possible. + NOW = 2; + + // An infinite point in the future. + FOREVER = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/tracking_code_page_format.proto b/third_party/googleapis/google/ads/googleads/v3/enums/tracking_code_page_format.proto new file mode 100644 index 000000000..c621e93cc --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/tracking_code_page_format.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "TrackingCodePageFormatProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Container for enum describing the format of the web page where the tracking +// tag and snippet will be installed. +message TrackingCodePageFormatEnum { + // The format of the web page where the tracking tag and snippet will be + // installed. + enum TrackingCodePageFormat { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Standard HTML page format. + HTML = 2; + + // Google AMP page format. + AMP = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/tracking_code_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/tracking_code_type.proto new file mode 100644 index 000000000..7d43ee0d2 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/tracking_code_type.proto @@ -0,0 +1,59 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "TrackingCodeTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Container for enum describing the type of the generated tag snippets for +// tracking conversions. +message TrackingCodeTypeEnum { + // The type of the generated tag snippets for tracking conversions. + enum TrackingCodeType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The snippet that is fired as a result of a website page loading. + WEBPAGE = 2; + + // The snippet contains a JavaScript function which fires the tag. This + // function is typically called from an onClick handler added to a link or + // button element on the page. + WEBPAGE_ONCLICK = 3; + + // For embedding on a mobile webpage. The snippet contains a JavaScript + // function which fires the tag. + CLICK_TO_CALL = 4; + + // The snippet that is used to replace the phone number on your website with + // a Google forwarding number for call tracking purposes. + WEBSITE_CALL = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/travel_placeholder_field.proto b/third_party/googleapis/google/ads/googleads/v3/enums/travel_placeholder_field.proto new file mode 100644 index 000000000..ef9c67795 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/travel_placeholder_field.proto @@ -0,0 +1,128 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "TravelPlaceholderFieldProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing Travel placeholder fields. + +// Values for Travel placeholder fields. +// For more information about dynamic remarketing feeds, see +// https://support.google.com/google-ads/answer/6053288. +message TravelPlaceholderFieldEnum { + // Possible values for Travel placeholder fields. + enum TravelPlaceholderField { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Data Type: STRING. Required. Destination id. Example: PAR, LON. + // For feed items that only have destination id, destination id must be a + // unique key. For feed items that have both destination id and origin id, + // then the combination must be a unique key. + DESTINATION_ID = 2; + + // Data Type: STRING. Origin id. Example: PAR, LON. + // Combination of DESTINATION_ID and ORIGIN_ID must be + // unique per offer. + ORIGIN_ID = 3; + + // Data Type: STRING. Required. Main headline with name to be shown in + // dynamic ad. + TITLE = 4; + + // Data Type: STRING. The destination name. Shorter names are recommended. + DESTINATION_NAME = 5; + + // Data Type: STRING. Origin name. Shorter names are recommended. + ORIGIN_NAME = 6; + + // Data Type: STRING. Price to be shown in the ad. Highly recommended for + // dynamic ads. + // Example: "100.00 USD" + PRICE = 7; + + // Data Type: STRING. Formatted price to be shown in the ad. + // Example: "Starting at $100.00 USD", "$80 - $100" + FORMATTED_PRICE = 8; + + // Data Type: STRING. Sale price to be shown in the ad. + // Example: "80.00 USD" + SALE_PRICE = 9; + + // Data Type: STRING. Formatted sale price to be shown in the ad. + // Example: "On sale for $80.00", "$60 - $80" + FORMATTED_SALE_PRICE = 10; + + // Data Type: URL. Image to be displayed in the ad. + IMAGE_URL = 11; + + // Data Type: STRING. Category of travel offer used to group like items + // together for recommendation engine. + CATEGORY = 12; + + // Data Type: STRING_LIST. Keywords used for product retrieval. + CONTEXTUAL_KEYWORDS = 13; + + // Data Type: STRING. Address of travel offer, including postal code. + DESTINATION_ADDRESS = 14; + + // Data Type: URL_LIST. Required. Final URLs to be used in ad, when using + // Upgraded URLs; the more specific the better (e.g. the individual URL of a + // specific travel offer and its location). + FINAL_URL = 15; + + // Data Type: URL_LIST. Final mobile URLs for the ad when using Upgraded + // URLs. + FINAL_MOBILE_URLS = 16; + + // Data Type: URL. Tracking template for the ad when using Upgraded URLs. + TRACKING_URL = 17; + + // Data Type: STRING. Android app link. Must be formatted as: + // android-app://{package_id}/{scheme}/{host_path}. + // The components are defined as follows: + // package_id: app ID as specified in Google Play. + // scheme: the scheme to pass to the application. Can be HTTP, or a custom + // scheme. + // host_path: identifies the specific content within your application. + ANDROID_APP_LINK = 18; + + // Data Type: STRING_LIST. List of recommended destination IDs to show + // together with this item. + SIMILAR_DESTINATION_IDS = 19; + + // Data Type: STRING. iOS app link. + IOS_APP_LINK = 20; + + // Data Type: INT64. iOS app store ID. + IOS_APP_STORE_ID = 21; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/user_interest_taxonomy_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/user_interest_taxonomy_type.proto new file mode 100644 index 000000000..a6c34892d --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/user_interest_taxonomy_type.proto @@ -0,0 +1,59 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "UserInterestTaxonomyTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing the UserInterest taxonomy type + +// Message describing a UserInterestTaxonomyType. +message UserInterestTaxonomyTypeEnum { + // Enum containing the possible UserInterestTaxonomyTypes. + enum UserInterestTaxonomyType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The affinity for this user interest. + AFFINITY = 2; + + // The market for this user interest. + IN_MARKET = 3; + + // Users known to have installed applications in the specified categories. + MOBILE_APP_INSTALL_USER = 4; + + // The geographical location of the interest-based vertical. + VERTICAL_GEO = 5; + + // User interest criteria for new smart phone users. + NEW_SMART_PHONE_USER = 6; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/user_list_access_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_access_status.proto new file mode 100644 index 000000000..b7a7f5fb4 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_access_status.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "UserListAccessStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing user list access status. + +// Indicates if this client still has access to the list. +message UserListAccessStatusEnum { + // Enum containing possible user list access statuses. + enum UserListAccessStatus { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The access is enabled. + ENABLED = 2; + + // The access is disabled. + DISABLED = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/user_list_closing_reason.proto b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_closing_reason.proto new file mode 100644 index 000000000..b14300908 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_closing_reason.proto @@ -0,0 +1,48 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "UserListClosingReasonProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing user list closing reason. + +// Indicates the reason why the userlist was closed. +// This enum is only used when a list is auto-closed by the system. +message UserListClosingReasonEnum { + // Enum describing possible user list closing reasons. + enum UserListClosingReason { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The userlist was closed because of not being used for over one year. + UNUSED = 2; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/user_list_combined_rule_operator.proto b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_combined_rule_operator.proto new file mode 100644 index 000000000..6fdeb650b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_combined_rule_operator.proto @@ -0,0 +1,48 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "UserListCombinedRuleOperatorProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Logical operator connecting two rules. +message UserListCombinedRuleOperatorEnum { + // Enum describing possible user list combined rule operators. + enum UserListCombinedRuleOperator { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // A AND B. + AND = 2; + + // A AND NOT B. + AND_NOT = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/user_list_crm_data_source_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_crm_data_source_type.proto new file mode 100644 index 000000000..1a792b92e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_crm_data_source_type.proto @@ -0,0 +1,51 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "UserListCrmDataSourceTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Indicates source of Crm upload data. +message UserListCrmDataSourceTypeEnum { + // Enum describing possible user list crm data source type. + enum UserListCrmDataSourceType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The uploaded data is first-party data. + FIRST_PARTY = 2; + + // The uploaded data is from a third-party credit bureau. + THIRD_PARTY_CREDIT_BUREAU = 3; + + // The uploaded data is from a third-party voter file. + THIRD_PARTY_VOTER_FILE = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/user_list_date_rule_item_operator.proto b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_date_rule_item_operator.proto new file mode 100644 index 000000000..af386825a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_date_rule_item_operator.proto @@ -0,0 +1,54 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "UserListDateRuleItemOperatorProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Supported rule operator for date type. +message UserListDateRuleItemOperatorEnum { + // Enum describing possible user list date rule item operators. + enum UserListDateRuleItemOperator { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Equals. + EQUALS = 2; + + // Not Equals. + NOT_EQUALS = 3; + + // Before. + BEFORE = 4; + + // After. + AFTER = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/user_list_logical_rule_operator.proto b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_logical_rule_operator.proto new file mode 100644 index 000000000..141b028d0 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_logical_rule_operator.proto @@ -0,0 +1,51 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "UserListLogicalRuleOperatorProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// The logical operator of the rule. +message UserListLogicalRuleOperatorEnum { + // Enum describing possible user list logical rule operators. + enum UserListLogicalRuleOperator { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // And - all of the operands. + ALL = 2; + + // Or - at least one of the operands. + ANY = 3; + + // Not - none of the operands. + NONE = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/user_list_membership_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_membership_status.proto new file mode 100644 index 000000000..a921ae29f --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_membership_status.proto @@ -0,0 +1,52 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "UserListMembershipStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing user list membership status. + +// Membership status of this user list. Indicates whether a user list is open +// or active. Only open user lists can accumulate more users and can be used for +// targeting. +message UserListMembershipStatusEnum { + // Enum containing possible user list membership statuses. + enum UserListMembershipStatus { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Open status - List is accruing members and can be targeted to. + OPEN = 2; + + // Closed status - No new members being added. Cannot be used for targeting. + CLOSED = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/user_list_number_rule_item_operator.proto b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_number_rule_item_operator.proto new file mode 100644 index 000000000..e3fe69adb --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_number_rule_item_operator.proto @@ -0,0 +1,60 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "UserListNumberRuleItemOperatorProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Supported rule operator for number type. +message UserListNumberRuleItemOperatorEnum { + // Enum describing possible user list number rule item operators. + enum UserListNumberRuleItemOperator { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Greater than. + GREATER_THAN = 2; + + // Greater than or equal. + GREATER_THAN_OR_EQUAL = 3; + + // Equals. + EQUALS = 4; + + // Not equals. + NOT_EQUALS = 5; + + // Less than. + LESS_THAN = 6; + + // Less than or equal. + LESS_THAN_OR_EQUAL = 7; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/user_list_prepopulation_status.proto b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_prepopulation_status.proto new file mode 100644 index 000000000..0aa56c010 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_prepopulation_status.proto @@ -0,0 +1,51 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "UserListPrepopulationStatusProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Indicates status of prepopulation based on the rule. +message UserListPrepopulationStatusEnum { + // Enum describing possible user list prepopulation status. + enum UserListPrepopulationStatus { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Prepopoulation is being requested. + REQUESTED = 2; + + // Prepopulation is finished. + FINISHED = 3; + + // Prepopulation failed. + FAILED = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/user_list_rule_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_rule_type.proto new file mode 100644 index 000000000..5b38251c4 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_rule_type.proto @@ -0,0 +1,48 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "UserListRuleTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Rule based user list rule type. +message UserListRuleTypeEnum { + // Enum describing possible user list rule types. + enum UserListRuleType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Conjunctive normal form. + AND_OF_ORS = 2; + + // Disjunctive normal form. + OR_OF_ANDS = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/user_list_size_range.proto b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_size_range.proto new file mode 100644 index 000000000..d319d3e34 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_size_range.proto @@ -0,0 +1,92 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "UserListSizeRangeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing user list size range. + +// Size range in terms of number of users of a UserList. +message UserListSizeRangeEnum { + // Enum containing possible user list size ranges. + enum UserListSizeRange { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // User list has less than 500 users. + LESS_THAN_FIVE_HUNDRED = 2; + + // User list has number of users in range of 500 to 1000. + LESS_THAN_ONE_THOUSAND = 3; + + // User list has number of users in range of 1000 to 10000. + ONE_THOUSAND_TO_TEN_THOUSAND = 4; + + // User list has number of users in range of 10000 to 50000. + TEN_THOUSAND_TO_FIFTY_THOUSAND = 5; + + // User list has number of users in range of 50000 to 100000. + FIFTY_THOUSAND_TO_ONE_HUNDRED_THOUSAND = 6; + + // User list has number of users in range of 100000 to 300000. + ONE_HUNDRED_THOUSAND_TO_THREE_HUNDRED_THOUSAND = 7; + + // User list has number of users in range of 300000 to 500000. + THREE_HUNDRED_THOUSAND_TO_FIVE_HUNDRED_THOUSAND = 8; + + // User list has number of users in range of 500000 to 1 million. + FIVE_HUNDRED_THOUSAND_TO_ONE_MILLION = 9; + + // User list has number of users in range of 1 to 2 millions. + ONE_MILLION_TO_TWO_MILLION = 10; + + // User list has number of users in range of 2 to 3 millions. + TWO_MILLION_TO_THREE_MILLION = 11; + + // User list has number of users in range of 3 to 5 millions. + THREE_MILLION_TO_FIVE_MILLION = 12; + + // User list has number of users in range of 5 to 10 millions. + FIVE_MILLION_TO_TEN_MILLION = 13; + + // User list has number of users in range of 10 to 20 millions. + TEN_MILLION_TO_TWENTY_MILLION = 14; + + // User list has number of users in range of 20 to 30 millions. + TWENTY_MILLION_TO_THIRTY_MILLION = 15; + + // User list has number of users in range of 30 to 50 millions. + THIRTY_MILLION_TO_FIFTY_MILLION = 16; + + // User list has over 50 million users. + OVER_FIFTY_MILLION = 17; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/user_list_string_rule_item_operator.proto b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_string_rule_item_operator.proto new file mode 100644 index 000000000..3ddd510c8 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_string_rule_item_operator.proto @@ -0,0 +1,66 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "UserListStringRuleItemOperatorProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Supported rule operator for string type. +message UserListStringRuleItemOperatorEnum { + // Enum describing possible user list string rule item operators. + enum UserListStringRuleItemOperator { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Contains. + CONTAINS = 2; + + // Equals. + EQUALS = 3; + + // Starts with. + STARTS_WITH = 4; + + // Ends with. + ENDS_WITH = 5; + + // Not equals. + NOT_EQUALS = 6; + + // Not contains. + NOT_CONTAINS = 7; + + // Not starts with. + NOT_STARTS_WITH = 8; + + // Not ends with. + NOT_ENDS_WITH = 9; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/user_list_type.proto b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_type.proto new file mode 100644 index 000000000..91d2e8912 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/user_list_type.proto @@ -0,0 +1,63 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "UserListTypeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing user list type. + +// The user list types. +message UserListTypeEnum { + // Enum containing possible user list types. + enum UserListType { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // UserList represented as a collection of conversion types. + REMARKETING = 2; + + // UserList represented as a combination of other user lists/interests. + LOGICAL = 3; + + // UserList created in the Google Ad Manager platform. + EXTERNAL_REMARKETING = 4; + + // UserList associated with a rule. + RULE_BASED = 5; + + // UserList with users similar to users of another UserList. + SIMILAR = 6; + + // UserList of first-party CRM data provided by advertiser in the form of + // emails or other formats. + CRM_BASED = 7; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/vanity_pharma_display_url_mode.proto b/third_party/googleapis/google/ads/googleads/v3/enums/vanity_pharma_display_url_mode.proto new file mode 100644 index 000000000..e00f76ae6 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/vanity_pharma_display_url_mode.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "VanityPharmaDisplayUrlModeProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing vanity pharma display url modes. + +// The display mode for vanity pharma URLs. +message VanityPharmaDisplayUrlModeEnum { + // Enum describing possible display modes for vanity pharma URLs. + enum VanityPharmaDisplayUrlMode { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Replace vanity pharma URL with manufacturer website url. + MANUFACTURER_WEBSITE_URL = 2; + + // Replace vanity pharma URL with description of the website. + WEBSITE_DESCRIPTION = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/vanity_pharma_text.proto b/third_party/googleapis/google/ads/googleads/v3/enums/vanity_pharma_text.proto new file mode 100644 index 000000000..1a6cfa941 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/vanity_pharma_text.proto @@ -0,0 +1,87 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "VanityPharmaTextProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing vanity pharma texts. + +// The text that will be displayed in display URL of the text ad when website +// description is the selected display mode for vanity pharma URLs. +message VanityPharmaTextEnum { + // Enum describing possible text. + enum VanityPharmaText { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Prescription treatment website with website content in English. + PRESCRIPTION_TREATMENT_WEBSITE_EN = 2; + + // Prescription treatment website with website content in Spanish + // (Sitio de tratamientos con receta). + PRESCRIPTION_TREATMENT_WEBSITE_ES = 3; + + // Prescription device website with website content in English. + PRESCRIPTION_DEVICE_WEBSITE_EN = 4; + + // Prescription device website with website content in Spanish (Sitio de + // dispositivos con receta). + PRESCRIPTION_DEVICE_WEBSITE_ES = 5; + + // Medical device website with website content in English. + MEDICAL_DEVICE_WEBSITE_EN = 6; + + // Medical device website with website content in Spanish (Sitio de + // dispositivos médicos). + MEDICAL_DEVICE_WEBSITE_ES = 7; + + // Preventative treatment website with website content in English. + PREVENTATIVE_TREATMENT_WEBSITE_EN = 8; + + // Preventative treatment website with website content in Spanish (Sitio de + // tratamientos preventivos). + PREVENTATIVE_TREATMENT_WEBSITE_ES = 9; + + // Prescription contraception website with website content in English. + PRESCRIPTION_CONTRACEPTION_WEBSITE_EN = 10; + + // Prescription contraception website with website content in Spanish (Sitio + // de anticonceptivos con receta). + PRESCRIPTION_CONTRACEPTION_WEBSITE_ES = 11; + + // Prescription vaccine website with website content in English. + PRESCRIPTION_VACCINE_WEBSITE_EN = 12; + + // Prescription vaccine website with website content in Spanish (Sitio de + // vacunas con receta). + PRESCRIPTION_VACCINE_WEBSITE_ES = 13; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/webpage_condition_operand.proto b/third_party/googleapis/google/ads/googleads/v3/enums/webpage_condition_operand.proto new file mode 100644 index 000000000..869f9e3d4 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/webpage_condition_operand.proto @@ -0,0 +1,59 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "WebpageConditionOperandProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing webpage condition operand. + +// Container for enum describing webpage condition operand in webpage criterion. +message WebpageConditionOperandEnum { + // The webpage condition operand in webpage criterion. + enum WebpageConditionOperand { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Operand denoting a webpage URL targeting condition. + URL = 2; + + // Operand denoting a webpage category targeting condition. + CATEGORY = 3; + + // Operand denoting a webpage title targeting condition. + PAGE_TITLE = 4; + + // Operand denoting a webpage content targeting condition. + PAGE_CONTENT = 5; + + // Operand denoting a webpage custom label targeting condition. + CUSTOM_LABEL = 6; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/enums/webpage_condition_operator.proto b/third_party/googleapis/google/ads/googleads/v3/enums/webpage_condition_operator.proto new file mode 100644 index 000000000..8d37393b3 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/enums/webpage_condition_operator.proto @@ -0,0 +1,51 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.enums; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Enums"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/enums;enums"; +option java_multiple_files = true; +option java_outer_classname = "WebpageConditionOperatorProto"; +option java_package = "com.google.ads.googleads.v3.enums"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Enums"; +option ruby_package = "Google::Ads::GoogleAds::V3::Enums"; + +// Proto file describing webpage condition operator. + +// Container for enum describing webpage condition operator in webpage +// criterion. +message WebpageConditionOperatorEnum { + // The webpage condition operator in webpage criterion. + enum WebpageConditionOperator { + // Not specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // The argument web condition is equal to the compared web condition. + EQUALS = 2; + + // The argument web condition is part of the compared web condition. + CONTAINS = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/access_invitation_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/access_invitation_error.proto new file mode 100644 index 000000000..8d697dcef --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/access_invitation_error.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "AccessInvitationErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing AccessInvitation errors. + +// Container for enum describing possible AccessInvitation errors. +message AccessInvitationErrorEnum { + // Enum describing possible AccessInvitation errors. + enum AccessInvitationError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The email address is invalid for sending an invitation. + INVALID_EMAIL_ADDRESS = 2; + + // Email address already has access to this customer. + EMAIL_ADDRESS_ALREADY_HAS_ACCESS = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/account_budget_proposal_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/account_budget_proposal_error.proto new file mode 100644 index 000000000..9ecf85ff9 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/account_budget_proposal_error.proto @@ -0,0 +1,118 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "AccountBudgetProposalErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing account budget proposal errors. + +// Container for enum describing possible account budget proposal errors. +message AccountBudgetProposalErrorEnum { + // Enum describing possible account budget proposal errors. + enum AccountBudgetProposalError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The field mask must be empty for create/end/remove proposals. + FIELD_MASK_NOT_ALLOWED = 2; + + // The field cannot be set because of the proposal type. + IMMUTABLE_FIELD = 3; + + // The field is required because of the proposal type. + REQUIRED_FIELD_MISSING = 4; + + // Proposals that have been approved cannot be cancelled. + CANNOT_CANCEL_APPROVED_PROPOSAL = 5; + + // Budgets that haven't been approved cannot be removed. + CANNOT_REMOVE_UNAPPROVED_BUDGET = 6; + + // Budgets that are currently running cannot be removed. + CANNOT_REMOVE_RUNNING_BUDGET = 7; + + // Budgets that haven't been approved cannot be truncated. + CANNOT_END_UNAPPROVED_BUDGET = 8; + + // Only budgets that are currently running can be truncated. + CANNOT_END_INACTIVE_BUDGET = 9; + + // All budgets must have names. + BUDGET_NAME_REQUIRED = 10; + + // Expired budgets cannot be edited after a sufficient amount of time has + // passed. + CANNOT_UPDATE_OLD_BUDGET = 11; + + // It is not permissible a propose a new budget that ends in the past. + CANNOT_END_IN_PAST = 12; + + // An expired budget cannot be extended to overlap with the running budget. + CANNOT_EXTEND_END_TIME = 13; + + // A purchase order number is required. + PURCHASE_ORDER_NUMBER_REQUIRED = 14; + + // Budgets that have a pending update cannot be updated. + PENDING_UPDATE_PROPOSAL_EXISTS = 15; + + // Cannot propose more than one budget when the corresponding billing setup + // hasn't been approved. + MULTIPLE_BUDGETS_NOT_ALLOWED_FOR_UNAPPROVED_BILLING_SETUP = 16; + + // Cannot update the start time of a budget that has already started. + CANNOT_UPDATE_START_TIME_FOR_STARTED_BUDGET = 17; + + // Cannot update the spending limit of a budget with an amount lower than + // what has already been spent. + SPENDING_LIMIT_LOWER_THAN_ACCRUED_COST_NOT_ALLOWED = 18; + + // Cannot propose a budget update without actually changing any fields. + UPDATE_IS_NO_OP = 19; + + // The end time must come after the start time. + END_TIME_MUST_FOLLOW_START_TIME = 20; + + // The budget's date range must fall within the date range of its billing + // setup. + BUDGET_DATE_RANGE_INCOMPATIBLE_WITH_BILLING_SETUP = 21; + + // The user is not authorized to mutate budgets for the given billing setup. + NOT_AUTHORIZED = 22; + + // Mutates are not allowed for the given billing setup. + INVALID_BILLING_SETUP = 23; + + // Budget creation failed as it overlaps with an pending budget proposal + // or an approved budget. + OVERLAPS_EXISTING_BUDGET = 24; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/ad_customizer_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/ad_customizer_error.proto new file mode 100644 index 000000000..e46fa0183 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/ad_customizer_error.proto @@ -0,0 +1,59 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "AdCustomizerErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing ad customizer errors. + +// Container for enum describing possible ad customizer errors. +message AdCustomizerErrorEnum { + // Enum describing possible ad customizer errors. + enum AdCustomizerError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Invalid date argument in countdown function. + COUNTDOWN_INVALID_DATE_FORMAT = 2; + + // Countdown end date is in the past. + COUNTDOWN_DATE_IN_PAST = 3; + + // Invalid locale string in countdown function. + COUNTDOWN_INVALID_LOCALE = 4; + + // Days-before argument to countdown function is not positive. + COUNTDOWN_INVALID_START_DAYS_BEFORE = 5; + + // A user list referenced in an IF function does not exist. + UNKNOWN_USER_LIST = 6; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/ad_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/ad_error.proto new file mode 100644 index 000000000..d191eaf82 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/ad_error.proto @@ -0,0 +1,478 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "AdErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing ad errors. + +// Container for enum describing possible ad errors. +message AdErrorEnum { + // Enum describing possible ad errors. + enum AdError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Ad customizers are not supported for ad type. + AD_CUSTOMIZERS_NOT_SUPPORTED_FOR_AD_TYPE = 2; + + // Estimating character sizes the string is too long. + APPROXIMATELY_TOO_LONG = 3; + + // Estimating character sizes the string is too short. + APPROXIMATELY_TOO_SHORT = 4; + + // There is a problem with the snippet. + BAD_SNIPPET = 5; + + // Cannot modify an ad. + CANNOT_MODIFY_AD = 6; + + // business name and url cannot be set at the same time + CANNOT_SET_BUSINESS_NAME_IF_URL_SET = 7; + + // The specified field is incompatible with this ad's type or settings. + CANNOT_SET_FIELD = 8; + + // Cannot set field when originAdId is set. + CANNOT_SET_FIELD_WITH_ORIGIN_AD_ID_SET = 9; + + // Cannot set field when an existing ad id is set for sharing. + CANNOT_SET_FIELD_WITH_AD_ID_SET_FOR_SHARING = 10; + + // Cannot set allowFlexibleColor false if no color is provided by user. + CANNOT_SET_ALLOW_FLEXIBLE_COLOR_FALSE = 11; + + // When user select native, no color control is allowed because we will + // always respect publisher color for native format serving. + CANNOT_SET_COLOR_CONTROL_WHEN_NATIVE_FORMAT_SETTING = 12; + + // Cannot specify a url for the ad type + CANNOT_SET_URL = 13; + + // Cannot specify a tracking or mobile url without also setting final urls + CANNOT_SET_WITHOUT_FINAL_URLS = 14; + + // Cannot specify a legacy url and a final url simultaneously + CANNOT_SET_WITH_FINAL_URLS = 15; + + // Cannot specify a urls in UrlData and in template fields simultaneously. + CANNOT_SET_WITH_URL_DATA = 17; + + // This operator cannot be used with a subclass of Ad. + CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR = 18; + + // Customer is not approved for mobile ads. + CUSTOMER_NOT_APPROVED_MOBILEADS = 19; + + // Customer is not approved for 3PAS richmedia ads. + CUSTOMER_NOT_APPROVED_THIRDPARTY_ADS = 20; + + // Customer is not approved for 3PAS redirect richmedia (Ad Exchange) ads. + CUSTOMER_NOT_APPROVED_THIRDPARTY_REDIRECT_ADS = 21; + + // Not an eligible customer + CUSTOMER_NOT_ELIGIBLE = 22; + + // Customer is not eligible for updating beacon url + CUSTOMER_NOT_ELIGIBLE_FOR_UPDATING_BEACON_URL = 23; + + // There already exists an ad with the same dimensions in the union. + DIMENSION_ALREADY_IN_UNION = 24; + + // Ad's dimension must be set before setting union dimension. + DIMENSION_MUST_BE_SET = 25; + + // Ad's dimension must be included in the union dimensions. + DIMENSION_NOT_IN_UNION = 26; + + // Display Url cannot be specified (applies to Ad Exchange Ads) + DISPLAY_URL_CANNOT_BE_SPECIFIED = 27; + + // Telephone number contains invalid characters or invalid format. Please + // re-enter your number using digits (0-9), dashes (-), and parentheses + // only. + DOMESTIC_PHONE_NUMBER_FORMAT = 28; + + // Emergency telephone numbers are not allowed. Please enter a valid + // domestic phone number to connect customers to your business. + EMERGENCY_PHONE_NUMBER = 29; + + // A required field was not specified or is an empty string. + EMPTY_FIELD = 30; + + // A feed attribute referenced in an ad customizer tag is not in the ad + // customizer mapping for the feed. + FEED_ATTRIBUTE_MUST_HAVE_MAPPING_FOR_TYPE_ID = 31; + + // The ad customizer field mapping for the feed attribute does not match the + // expected field type. + FEED_ATTRIBUTE_MAPPING_TYPE_MISMATCH = 32; + + // The use of ad customizer tags in the ad text is disallowed. Details in + // trigger. + ILLEGAL_AD_CUSTOMIZER_TAG_USE = 33; + + // Tags of the form {PH_x}, where x is a number, are disallowed in ad text. + ILLEGAL_TAG_USE = 34; + + // The dimensions of the ad are specified or derived in multiple ways and + // are not consistent. + INCONSISTENT_DIMENSIONS = 35; + + // The status cannot differ among template ads of the same union. + INCONSISTENT_STATUS_IN_TEMPLATE_UNION = 36; + + // The length of the string is not valid. + INCORRECT_LENGTH = 37; + + // The ad is ineligible for upgrade. + INELIGIBLE_FOR_UPGRADE = 38; + + // User cannot create mobile ad for countries targeted in specified + // campaign. + INVALID_AD_ADDRESS_CAMPAIGN_TARGET = 39; + + // Invalid Ad type. A specific type of Ad is required. + INVALID_AD_TYPE = 40; + + // Headline, description or phone cannot be present when creating mobile + // image ad. + INVALID_ATTRIBUTES_FOR_MOBILE_IMAGE = 41; + + // Image cannot be present when creating mobile text ad. + INVALID_ATTRIBUTES_FOR_MOBILE_TEXT = 42; + + // Invalid call to action text. + INVALID_CALL_TO_ACTION_TEXT = 43; + + // Invalid character in URL. + INVALID_CHARACTER_FOR_URL = 44; + + // Creative's country code is not valid. + INVALID_COUNTRY_CODE = 45; + + // Invalid use of Expanded Dynamic Search Ads tags ({lpurl} etc.) + INVALID_EXPANDED_DYNAMIC_SEARCH_AD_TAG = 47; + + // An input error whose real reason was not properly mapped (should not + // happen). + INVALID_INPUT = 48; + + // An invalid markup language was entered. + INVALID_MARKUP_LANGUAGE = 49; + + // An invalid mobile carrier was entered. + INVALID_MOBILE_CARRIER = 50; + + // Specified mobile carriers target a country not targeted by the campaign. + INVALID_MOBILE_CARRIER_TARGET = 51; + + // Wrong number of elements for given element type + INVALID_NUMBER_OF_ELEMENTS = 52; + + // The format of the telephone number is incorrect. Please re-enter the + // number using the correct format. + INVALID_PHONE_NUMBER_FORMAT = 53; + + // The certified vendor format id is incorrect. + INVALID_RICH_MEDIA_CERTIFIED_VENDOR_FORMAT_ID = 54; + + // The template ad data contains validation errors. + INVALID_TEMPLATE_DATA = 55; + + // The template field doesn't have have the correct type. + INVALID_TEMPLATE_ELEMENT_FIELD_TYPE = 56; + + // Invalid template id. + INVALID_TEMPLATE_ID = 57; + + // After substituting replacement strings, the line is too wide. + LINE_TOO_WIDE = 58; + + // The feed referenced must have ad customizer mapping to be used in a + // customizer tag. + MISSING_AD_CUSTOMIZER_MAPPING = 59; + + // Missing address component in template element address field. + MISSING_ADDRESS_COMPONENT = 60; + + // An ad name must be entered. + MISSING_ADVERTISEMENT_NAME = 61; + + // Business name must be entered. + MISSING_BUSINESS_NAME = 62; + + // Description (line 2) must be entered. + MISSING_DESCRIPTION1 = 63; + + // Description (line 3) must be entered. + MISSING_DESCRIPTION2 = 64; + + // The destination url must contain at least one tag (e.g. {lpurl}) + MISSING_DESTINATION_URL_TAG = 65; + + // The tracking url template of ExpandedDynamicSearchAd must contain at + // least one tag. (e.g. {lpurl}) + MISSING_LANDING_PAGE_URL_TAG = 66; + + // A valid dimension must be specified for this ad. + MISSING_DIMENSION = 67; + + // A display URL must be entered. + MISSING_DISPLAY_URL = 68; + + // Headline must be entered. + MISSING_HEADLINE = 69; + + // A height must be entered. + MISSING_HEIGHT = 70; + + // An image must be entered. + MISSING_IMAGE = 71; + + // Marketing image or product videos are required. + MISSING_MARKETING_IMAGE_OR_PRODUCT_VIDEOS = 72; + + // The markup language in which your site is written must be entered. + MISSING_MARKUP_LANGUAGES = 73; + + // A mobile carrier must be entered. + MISSING_MOBILE_CARRIER = 74; + + // Phone number must be entered. + MISSING_PHONE = 75; + + // Missing required template fields + MISSING_REQUIRED_TEMPLATE_FIELDS = 76; + + // Missing a required field value + MISSING_TEMPLATE_FIELD_VALUE = 77; + + // The ad must have text. + MISSING_TEXT = 78; + + // A visible URL must be entered. + MISSING_VISIBLE_URL = 79; + + // A width must be entered. + MISSING_WIDTH = 80; + + // Only 1 feed can be used as the source of ad customizer substitutions in a + // single ad. + MULTIPLE_DISTINCT_FEEDS_UNSUPPORTED = 81; + + // TempAdUnionId must be use when adding template ads. + MUST_USE_TEMP_AD_UNION_ID_ON_ADD = 82; + + // The string has too many characters. + TOO_LONG = 83; + + // The string has too few characters. + TOO_SHORT = 84; + + // Ad union dimensions cannot change for saved ads. + UNION_DIMENSIONS_CANNOT_CHANGE = 85; + + // Address component is not {country, lat, lng}. + UNKNOWN_ADDRESS_COMPONENT = 86; + + // Unknown unique field name + UNKNOWN_FIELD_NAME = 87; + + // Unknown unique name (template element type specifier) + UNKNOWN_UNIQUE_NAME = 88; + + // Unsupported ad dimension + UNSUPPORTED_DIMENSIONS = 89; + + // URL starts with an invalid scheme. + URL_INVALID_SCHEME = 90; + + // URL ends with an invalid top-level domain name. + URL_INVALID_TOP_LEVEL_DOMAIN = 91; + + // URL contains illegal characters. + URL_MALFORMED = 92; + + // URL must contain a host name. + URL_NO_HOST = 93; + + // URL not equivalent during upgrade. + URL_NOT_EQUIVALENT = 94; + + // URL host name too long to be stored as visible URL (applies to Ad + // Exchange ads) + URL_HOST_NAME_TOO_LONG = 95; + + // URL must start with a scheme. + URL_NO_SCHEME = 96; + + // URL should end in a valid domain extension, such as .com or .net. + URL_NO_TOP_LEVEL_DOMAIN = 97; + + // URL must not end with a path. + URL_PATH_NOT_ALLOWED = 98; + + // URL must not specify a port. + URL_PORT_NOT_ALLOWED = 99; + + // URL must not contain a query. + URL_QUERY_NOT_ALLOWED = 100; + + // A url scheme is not allowed in front of tag in tracking url template + // (e.g. http://{lpurl}) + URL_SCHEME_BEFORE_EXPANDED_DYNAMIC_SEARCH_AD_TAG = 102; + + // The user does not have permissions to create a template ad for the given + // template. + USER_DOES_NOT_HAVE_ACCESS_TO_TEMPLATE = 103; + + // Expandable setting is inconsistent/wrong. For example, an AdX ad is + // invalid if it has a expandable vendor format but no expanding directions + // specified, or expanding directions is specified, but the vendor format is + // not expandable. + INCONSISTENT_EXPANDABLE_SETTINGS = 104; + + // Format is invalid + INVALID_FORMAT = 105; + + // The text of this field did not match a pattern of allowed values. + INVALID_FIELD_TEXT = 106; + + // Template element is mising + ELEMENT_NOT_PRESENT = 107; + + // Error occurred during image processing + IMAGE_ERROR = 108; + + // The value is not within the valid range + VALUE_NOT_IN_RANGE = 109; + + // Template element field is not present + FIELD_NOT_PRESENT = 110; + + // Address is incomplete + ADDRESS_NOT_COMPLETE = 111; + + // Invalid address + ADDRESS_INVALID = 112; + + // Error retrieving specified video + VIDEO_RETRIEVAL_ERROR = 113; + + // Error processing audio + AUDIO_ERROR = 114; + + // Display URL is incorrect for YouTube PYV ads + INVALID_YOUTUBE_DISPLAY_URL = 115; + + // Too many product Images in GmailAd + TOO_MANY_PRODUCT_IMAGES = 116; + + // Too many product Videos in GmailAd + TOO_MANY_PRODUCT_VIDEOS = 117; + + // The device preference is not compatible with the ad type + INCOMPATIBLE_AD_TYPE_AND_DEVICE_PREFERENCE = 118; + + // Call tracking is not supported for specified country. + CALLTRACKING_NOT_SUPPORTED_FOR_COUNTRY = 119; + + // Carrier specific short number is not allowed. + CARRIER_SPECIFIC_SHORT_NUMBER_NOT_ALLOWED = 120; + + // Specified phone number type is disallowed. + DISALLOWED_NUMBER_TYPE = 121; + + // Phone number not supported for country. + PHONE_NUMBER_NOT_SUPPORTED_FOR_COUNTRY = 122; + + // Phone number not supported with call tracking enabled for country. + PHONE_NUMBER_NOT_SUPPORTED_WITH_CALLTRACKING_FOR_COUNTRY = 123; + + // Premium rate phone number is not allowed. + PREMIUM_RATE_NUMBER_NOT_ALLOWED = 124; + + // Vanity phone number is not allowed. + VANITY_PHONE_NUMBER_NOT_ALLOWED = 125; + + // Invalid call conversion type id. + INVALID_CALL_CONVERSION_TYPE_ID = 126; + + // Cannot disable call conversion and set conversion type id. + CANNOT_DISABLE_CALL_CONVERSION_AND_SET_CONVERSION_TYPE_ID = 127; + + // Cannot set path2 without path1. + CANNOT_SET_PATH2_WITHOUT_PATH1 = 128; + + // Missing domain name in campaign setting when adding expanded dynamic + // search ad. + MISSING_DYNAMIC_SEARCH_ADS_SETTING_DOMAIN_NAME = 129; + + // The associated ad is not compatible with restriction type. + INCOMPATIBLE_WITH_RESTRICTION_TYPE = 130; + + // Consent for call recording is required for creating/updating call only + // ads. Please see https://support.google.com/google-ads/answer/7412639. + CUSTOMER_CONSENT_FOR_CALL_RECORDING_REQUIRED = 131; + + // Either an image or a media bundle is required in a display upload ad. + MISSING_IMAGE_OR_MEDIA_BUNDLE = 132; + + // The display upload product type is not supported in this campaign. + PRODUCT_TYPE_NOT_SUPPORTED_IN_THIS_CAMPAIGN = 133; + + // The default value of an ad placeholder can not be the empty string. + PLACEHOLDER_CANNOT_HAVE_EMPTY_DEFAULT_VALUE = 134; + + // Ad placeholders with countdown functions must not have a default value. + PLACEHOLDER_COUNTDOWN_FUNCTION_CANNOT_HAVE_DEFAULT_VALUE = 135; + + // A previous ad placeholder that had a default value was found which means + // that all (non-countdown) placeholders must have a default value. This + // ad placeholder does not have a default value. + PLACEHOLDER_DEFAULT_VALUE_MISSING = 136; + + // A previous ad placeholder that did not have a default value was found + // which means that no placeholders may have a default value. This + // ad placeholder does have a default value. + UNEXPECTED_PLACEHOLDER_DEFAULT_VALUE = 137; + + // Two ad customizers may not be directly adjacent in an ad text. They must + // be separated by at least one character. + AD_CUSTOMIZERS_MAY_NOT_BE_ADJACENT = 138; + + // The ad is not associated with any enabled AdGroupAd, and cannot be + // updated. + UPDATING_AD_WITH_NO_ENABLED_ASSOCIATION = 139; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/ad_group_ad_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/ad_group_ad_error.proto new file mode 100644 index 000000000..99044c56f --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/ad_group_ad_error.proto @@ -0,0 +1,70 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupAdErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing ad group ad errors. + +// Container for enum describing possible ad group ad errors. +message AdGroupAdErrorEnum { + // Enum describing possible ad group ad errors. + enum AdGroupAdError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // No link found between the adgroup ad and the label. + AD_GROUP_AD_LABEL_DOES_NOT_EXIST = 2; + + // The label has already been attached to the adgroup ad. + AD_GROUP_AD_LABEL_ALREADY_EXISTS = 3; + + // The specified ad was not found in the adgroup + AD_NOT_UNDER_ADGROUP = 4; + + // Removed ads may not be modified + CANNOT_OPERATE_ON_REMOVED_ADGROUPAD = 5; + + // An ad of this type is deprecated and cannot be created. Only deletions + // are permitted. + CANNOT_CREATE_DEPRECATED_ADS = 6; + + // Text ads are deprecated and cannot be created. Use expanded text ads + // instead. + CANNOT_CREATE_TEXT_ADS = 7; + + // A required field was not specified or is an empty string. + EMPTY_FIELD = 8; + + // An ad may only be modified once per call + RESOURCE_REFERENCED_IN_MULTIPLE_OPS = 9; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/ad_group_bid_modifier_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/ad_group_bid_modifier_error.proto new file mode 100644 index 000000000..aaba025f9 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/ad_group_bid_modifier_error.proto @@ -0,0 +1,51 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupBidModifierErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing ad group bid modifier errors. + +// Container for enum describing possible ad group bid modifier errors. +message AdGroupBidModifierErrorEnum { + // Enum describing possible ad group bid modifier errors. + enum AdGroupBidModifierError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The criterion ID does not support bid modification. + CRITERION_ID_NOT_SUPPORTED = 2; + + // Cannot override the bid modifier for the given criterion ID if the parent + // campaign is opted out of the same criterion. + CANNOT_OVERRIDE_OPTED_OUT_CAMPAIGN_CRITERION_BID_MODIFIER = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/ad_group_criterion_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/ad_group_criterion_error.proto new file mode 100644 index 000000000..ad2a0c0f7 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/ad_group_criterion_error.proto @@ -0,0 +1,165 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupCriterionErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing ad group criterion errors. + +// Container for enum describing possible ad group criterion errors. +message AdGroupCriterionErrorEnum { + // Enum describing possible ad group criterion errors. + enum AdGroupCriterionError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // No link found between the AdGroupCriterion and the label. + AD_GROUP_CRITERION_LABEL_DOES_NOT_EXIST = 2; + + // The label has already been attached to the AdGroupCriterion. + AD_GROUP_CRITERION_LABEL_ALREADY_EXISTS = 3; + + // Negative AdGroupCriterion cannot have labels. + CANNOT_ADD_LABEL_TO_NEGATIVE_CRITERION = 4; + + // Too many operations for a single call. + TOO_MANY_OPERATIONS = 5; + + // Negative ad group criteria are not updateable. + CANT_UPDATE_NEGATIVE = 6; + + // Concrete type of criterion (keyword v.s. placement) is required for ADD + // and SET operations. + CONCRETE_TYPE_REQUIRED = 7; + + // Bid is incompatible with ad group's bidding settings. + BID_INCOMPATIBLE_WITH_ADGROUP = 8; + + // Cannot target and exclude the same criterion at once. + CANNOT_TARGET_AND_EXCLUDE = 9; + + // The URL of a placement is invalid. + ILLEGAL_URL = 10; + + // Keyword text was invalid. + INVALID_KEYWORD_TEXT = 11; + + // Destination URL was invalid. + INVALID_DESTINATION_URL = 12; + + // The destination url must contain at least one tag (e.g. {lpurl}) + MISSING_DESTINATION_URL_TAG = 13; + + // Keyword-level cpm bid is not supported + KEYWORD_LEVEL_BID_NOT_SUPPORTED_FOR_MANUALCPM = 14; + + // For example, cannot add a biddable ad group criterion that had been + // removed. + INVALID_USER_STATUS = 15; + + // Criteria type cannot be targeted for the ad group. Either the account is + // restricted to keywords only, the criteria type is incompatible with the + // campaign's bidding strategy, or the criteria type can only be applied to + // campaigns. + CANNOT_ADD_CRITERIA_TYPE = 16; + + // Criteria type cannot be excluded for the ad group. Refer to the + // documentation for a specific criterion to check if it is excludable. + CANNOT_EXCLUDE_CRITERIA_TYPE = 17; + + // Partial failure is not supported for shopping campaign mutate operations. + CAMPAIGN_TYPE_NOT_COMPATIBLE_WITH_PARTIAL_FAILURE = 27; + + // Operations in the mutate request changes too many shopping ad groups. + // Please split requests for multiple shopping ad groups across multiple + // requests. + OPERATIONS_FOR_TOO_MANY_SHOPPING_ADGROUPS = 28; + + // Not allowed to modify url fields of an ad group criterion if there are + // duplicate elements for that ad group criterion in the request. + CANNOT_MODIFY_URL_FIELDS_WITH_DUPLICATE_ELEMENTS = 29; + + // Cannot set url fields without also setting final urls. + CANNOT_SET_WITHOUT_FINAL_URLS = 30; + + // Cannot clear final urls if final mobile urls exist. + CANNOT_CLEAR_FINAL_URLS_IF_FINAL_MOBILE_URLS_EXIST = 31; + + // Cannot clear final urls if final app urls exist. + CANNOT_CLEAR_FINAL_URLS_IF_FINAL_APP_URLS_EXIST = 32; + + // Cannot clear final urls if tracking url template exists. + CANNOT_CLEAR_FINAL_URLS_IF_TRACKING_URL_TEMPLATE_EXISTS = 33; + + // Cannot clear final urls if url custom parameters exist. + CANNOT_CLEAR_FINAL_URLS_IF_URL_CUSTOM_PARAMETERS_EXIST = 34; + + // Cannot set both destination url and final urls. + CANNOT_SET_BOTH_DESTINATION_URL_AND_FINAL_URLS = 35; + + // Cannot set both destination url and tracking url template. + CANNOT_SET_BOTH_DESTINATION_URL_AND_TRACKING_URL_TEMPLATE = 36; + + // Final urls are not supported for this criterion type. + FINAL_URLS_NOT_SUPPORTED_FOR_CRITERION_TYPE = 37; + + // Final mobile urls are not supported for this criterion type. + FINAL_MOBILE_URLS_NOT_SUPPORTED_FOR_CRITERION_TYPE = 38; + + // Ad group is invalid due to the listing groups it contains. + INVALID_LISTING_GROUP_HIERARCHY = 39; + + // Listing group unit cannot have children. + LISTING_GROUP_UNIT_CANNOT_HAVE_CHILDREN = 40; + + // Subdivided listing groups must have an "others" case. + LISTING_GROUP_SUBDIVISION_REQUIRES_OTHERS_CASE = 41; + + // Dimension type of listing group must be the same as that of its siblings. + LISTING_GROUP_REQUIRES_SAME_DIMENSION_TYPE_AS_SIBLINGS = 42; + + // Listing group cannot be added to the ad group because it already exists. + LISTING_GROUP_ALREADY_EXISTS = 43; + + // Listing group referenced in the operation was not found in the ad group. + LISTING_GROUP_DOES_NOT_EXIST = 44; + + // Recursive removal failed because listing group subdivision is being + // created or modified in this request. + LISTING_GROUP_CANNOT_BE_REMOVED = 45; + + // Listing group type is not allowed for specified ad group criterion type. + INVALID_LISTING_GROUP_TYPE = 46; + + // Listing group in an ADD operation specifies a non temporary criterion id. + LISTING_GROUP_ADD_MAY_ONLY_USE_TEMP_ID = 47; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/ad_group_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/ad_group_error.proto new file mode 100644 index 000000000..5d9df034f --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/ad_group_error.proto @@ -0,0 +1,86 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing ad group errors. + +// Container for enum describing possible ad group errors. +message AdGroupErrorEnum { + // Enum describing possible ad group errors. + enum AdGroupError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // AdGroup with the same name already exists for the campaign. + DUPLICATE_ADGROUP_NAME = 2; + + // AdGroup name is not valid. + INVALID_ADGROUP_NAME = 3; + + // Advertiser is not allowed to target sites or set site bids that are not + // on the Google Search Network. + ADVERTISER_NOT_ON_CONTENT_NETWORK = 5; + + // Bid amount is too big. + BID_TOO_BIG = 6; + + // AdGroup bid does not match the campaign's bidding strategy. + BID_TYPE_AND_BIDDING_STRATEGY_MISMATCH = 7; + + // AdGroup name is required for Add. + MISSING_ADGROUP_NAME = 8; + + // No link found between the ad group and the label. + ADGROUP_LABEL_DOES_NOT_EXIST = 9; + + // The label has already been attached to the ad group. + ADGROUP_LABEL_ALREADY_EXISTS = 10; + + // The CriterionTypeGroup is not supported for the content bid dimension. + INVALID_CONTENT_BID_CRITERION_TYPE_GROUP = 11; + + // The ad group type is not compatible with the campaign channel type. + AD_GROUP_TYPE_NOT_VALID_FOR_ADVERTISING_CHANNEL_TYPE = 12; + + // The ad group type is not supported in the country of sale of the + // campaign. + ADGROUP_TYPE_NOT_SUPPORTED_FOR_CAMPAIGN_SALES_COUNTRY = 13; + + // Ad groups of AdGroupType.SEARCH_DYNAMIC_ADS can only be added to + // campaigns that have DynamicSearchAdsSetting attached. + CANNOT_ADD_ADGROUP_OF_TYPE_DSA_TO_CAMPAIGN_WITHOUT_DSA_SETTING = 14; + + // Promoted hotels ad groups are only available to whitelisted customers. + PROMOTED_HOTEL_AD_GROUPS_NOT_AVAILABLE_FOR_CUSTOMER = 15; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/ad_group_feed_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/ad_group_feed_error.proto new file mode 100644 index 000000000..e0d17955c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/ad_group_feed_error.proto @@ -0,0 +1,67 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupFeedErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing ad group feed errors. + +// Container for enum describing possible ad group feed errors. +message AdGroupFeedErrorEnum { + // Enum describing possible ad group feed errors. + enum AdGroupFeedError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // An active feed already exists for this ad group and place holder type. + FEED_ALREADY_EXISTS_FOR_PLACEHOLDER_TYPE = 2; + + // The specified feed is removed. + CANNOT_CREATE_FOR_REMOVED_FEED = 3; + + // The AdGroupFeed already exists. UPDATE operation should be used to modify + // the existing AdGroupFeed. + ADGROUP_FEED_ALREADY_EXISTS = 4; + + // Cannot operate on removed AdGroupFeed. + CANNOT_OPERATE_ON_REMOVED_ADGROUP_FEED = 5; + + // Invalid placeholder type. + INVALID_PLACEHOLDER_TYPE = 6; + + // Feed mapping for this placeholder type does not exist. + MISSING_FEEDMAPPING_FOR_PLACEHOLDER_TYPE = 7; + + // Location AdGroupFeeds cannot be created unless there is a location + // CustomerFeed for the specified feed. + NO_EXISTING_LOCATION_CUSTOMER_FEED = 8; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/ad_parameter_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/ad_parameter_error.proto new file mode 100644 index 000000000..e911181cd --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/ad_parameter_error.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "AdParameterErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing ad parameter errors. + +// Container for enum describing possible ad parameter errors. +message AdParameterErrorEnum { + // Enum describing possible ad parameter errors. + enum AdParameterError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The ad group criterion must be a keyword criterion. + AD_GROUP_CRITERION_MUST_BE_KEYWORD = 2; + + // The insertion text is invalid. + INVALID_INSERTION_TEXT_FORMAT = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/ad_sharing_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/ad_sharing_error.proto new file mode 100644 index 000000000..326a131eb --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/ad_sharing_error.proto @@ -0,0 +1,54 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "AdSharingErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing ad sharing errors. + +// Container for enum describing possible ad sharing errors. +message AdSharingErrorEnum { + // Enum describing possible ad sharing errors. + enum AdSharingError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Error resulting in attempting to add an Ad to an AdGroup that already + // contains the Ad. + AD_GROUP_ALREADY_CONTAINS_AD = 2; + + // Ad is not compatible with the AdGroup it is being shared with. + INCOMPATIBLE_AD_UNDER_AD_GROUP = 3; + + // Cannot add AdGroupAd on inactive Ad. + CANNOT_SHARE_INACTIVE_AD = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/adx_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/adx_error.proto new file mode 100644 index 000000000..598d6cf20 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/adx_error.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "AdxErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing adx errors. + +// Container for enum describing possible adx errors. +message AdxErrorEnum { + // Enum describing possible adx errors. + enum AdxError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Attempt to use non-AdX feature by AdX customer. + UNSUPPORTED_FEATURE = 2; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/asset_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/asset_error.proto new file mode 100644 index 000000000..e9b35aea0 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/asset_error.proto @@ -0,0 +1,61 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "AssetErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing asset errors. + +// Container for enum describing possible asset errors. +message AssetErrorEnum { + // Enum describing possible asset errors. + enum AssetError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The customer is not whitelisted for this asset type. + CUSTOMER_NOT_WHITELISTED_FOR_ASSET_TYPE = 2; + + // Assets are duplicated across operations. + DUPLICATE_ASSET = 3; + + // The asset name is duplicated, either across operations or with an + // existing asset. + DUPLICATE_ASSET_NAME = 4; + + // The Asset.asset_data oneof is empty. + ASSET_DATA_IS_MISSING = 5; + + // The asset has a name which is different from an existing duplicate that + // represents the same content. + CANNOT_MODIFY_ASSET_NAME = 6; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/asset_link_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/asset_link_error.proto new file mode 100644 index 000000000..42bc94c2c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/asset_link_error.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "AssetLinkErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing asset link errors. + +// Container for enum describing possible asset link errors. +message AssetLinkErrorEnum { + // Enum describing possible asset link errors. + enum AssetLinkError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Pinning is not supported for the given asset link field. + PINNING_UNSUPPORTED = 2; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/authentication_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/authentication_error.proto new file mode 100644 index 000000000..b2c889b4c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/authentication_error.proto @@ -0,0 +1,103 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "AuthenticationErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing authentication errors. + +// Container for enum describing possible authentication errors. +message AuthenticationErrorEnum { + // Enum describing possible authentication errors. + enum AuthenticationError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Authentication of the request failed. + AUTHENTICATION_ERROR = 2; + + // Client Customer Id is not a number. + CLIENT_CUSTOMER_ID_INVALID = 5; + + // No customer found for the provided customer id. + CUSTOMER_NOT_FOUND = 8; + + // Client's Google Account is deleted. + GOOGLE_ACCOUNT_DELETED = 9; + + // Google account login token in the cookie is invalid. + GOOGLE_ACCOUNT_COOKIE_INVALID = 10; + + // A problem occurred during Google account authentication. + GOOGLE_ACCOUNT_AUTHENTICATION_FAILED = 25; + + // The user in the google account login token does not match the UserId in + // the cookie. + GOOGLE_ACCOUNT_USER_AND_ADS_USER_MISMATCH = 12; + + // Login cookie is required for authentication. + LOGIN_COOKIE_REQUIRED = 13; + + // User in the cookie is not a valid Ads user. + NOT_ADS_USER = 14; + + // Oauth token in the header is not valid. + OAUTH_TOKEN_INVALID = 15; + + // Oauth token in the header has expired. + OAUTH_TOKEN_EXPIRED = 16; + + // Oauth token in the header has been disabled. + OAUTH_TOKEN_DISABLED = 17; + + // Oauth token in the header has been revoked. + OAUTH_TOKEN_REVOKED = 18; + + // Oauth token HTTP header is malformed. + OAUTH_TOKEN_HEADER_INVALID = 19; + + // Login cookie is not valid. + LOGIN_COOKIE_INVALID = 20; + + // User Id in the header is not a valid id. + USER_ID_INVALID = 22; + + // An account administrator changed this account's authentication settings. + // To access this Google Ads account, enable 2-Step Verification in your + // Google account at https://www.google.com/landing/2step. + TWO_STEP_VERIFICATION_NOT_ENROLLED = 23; + + // An account administrator changed this account's authentication settings. + // To access this Google Ads account, enable Advanced Protection in your + // Google account at https://landing.google.com/advancedprotection. + ADVANCED_PROTECTION_NOT_ENROLLED = 24; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/authorization_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/authorization_error.proto new file mode 100644 index 000000000..d070275de --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/authorization_error.proto @@ -0,0 +1,88 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "AuthorizationErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing authorization errors. + +// Container for enum describing possible authorization errors. +message AuthorizationErrorEnum { + // Enum describing possible authorization errors. + enum AuthorizationError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // User doesn't have permission to access customer. Note: If you're + // accessing a client customer, the manager's customer ID must be set in the + // `login-customer-id` header. Learn more at + // https://developers.google.com/google-ads/api/docs/concepts/call-structure#cid + USER_PERMISSION_DENIED = 2; + + // The developer token is not whitelisted. + DEVELOPER_TOKEN_NOT_WHITELISTED = 3; + + // The developer token is not allowed with the project sent in the request. + DEVELOPER_TOKEN_PROHIBITED = 4; + + // The Google Cloud project sent in the request does not have permission to + // access the api. + PROJECT_DISABLED = 5; + + // Authorization of the client failed. + AUTHORIZATION_ERROR = 6; + + // The user does not have permission to perform this action + // (e.g., ADD, UPDATE, REMOVE) on the resource or call a method. + ACTION_NOT_PERMITTED = 7; + + // Signup not complete. + INCOMPLETE_SIGNUP = 8; + + // The customer can't be used because it isn't enabled. + CUSTOMER_NOT_ENABLED = 24; + + // The developer must sign the terms of service. They can be found here: + // ads.google.com/aw/apicenter + MISSING_TOS = 9; + + // The developer token is not approved. Non-approved developer tokens can + // only be used with test accounts. + DEVELOPER_TOKEN_NOT_APPROVED = 10; + + // The login customer specified does not have access to the account + // specified, so the request is invalid. + INVALID_LOGIN_CUSTOMER_ID_SERVING_CUSTOMER_ID_COMBINATION = 11; + + // The developer specified does not have access to the service. + SERVICE_ACCESS_DENIED = 12; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/bidding_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/bidding_error.proto new file mode 100644 index 000000000..6c718f42b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/bidding_error.proto @@ -0,0 +1,121 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "BiddingErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing bidding errors. + +// Container for enum describing possible bidding errors. +message BiddingErrorEnum { + // Enum describing possible bidding errors. + enum BiddingError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Cannot transition to new bidding strategy. + BIDDING_STRATEGY_TRANSITION_NOT_ALLOWED = 2; + + // Cannot attach bidding strategy to campaign. + CANNOT_ATTACH_BIDDING_STRATEGY_TO_CAMPAIGN = 7; + + // Bidding strategy is not supported or cannot be used as anonymous. + INVALID_ANONYMOUS_BIDDING_STRATEGY_TYPE = 10; + + // The type does not match the named strategy's type. + INVALID_BIDDING_STRATEGY_TYPE = 14; + + // The bid is invalid. + INVALID_BID = 17; + + // Bidding strategy is not available for the account type. + BIDDING_STRATEGY_NOT_AVAILABLE_FOR_ACCOUNT_TYPE = 18; + + // Conversion tracking is not enabled for the campaign for VBB transition. + CONVERSION_TRACKING_NOT_ENABLED = 19; + + // Not enough conversions tracked for VBB transitions. + NOT_ENOUGH_CONVERSIONS = 20; + + // Campaign can not be created with given bidding strategy. It can be + // transitioned to the strategy, once eligible. + CANNOT_CREATE_CAMPAIGN_WITH_BIDDING_STRATEGY = 21; + + // Cannot target content network only as campaign uses Page One Promoted + // bidding strategy. + CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_CAMPAIGN_LEVEL_POP_BIDDING_STRATEGY = 23; + + // Budget Optimizer and Target Spend bidding strategies are not supported + // for campaigns with AdSchedule targeting. + BIDDING_STRATEGY_NOT_SUPPORTED_WITH_AD_SCHEDULE = 24; + + // Pay per conversion is not available to all the customer, only few + // whitelisted customers can use this. + PAY_PER_CONVERSION_NOT_AVAILABLE_FOR_CUSTOMER = 25; + + // Pay per conversion is not allowed with Target CPA. + PAY_PER_CONVERSION_NOT_ALLOWED_WITH_TARGET_CPA = 26; + + // Cannot set bidding strategy to Manual CPM for search network only + // campaigns. + BIDDING_STRATEGY_NOT_ALLOWED_FOR_SEARCH_ONLY_CAMPAIGNS = 27; + + // The bidding strategy is not supported for use in drafts or experiments. + BIDDING_STRATEGY_NOT_SUPPORTED_IN_DRAFTS_OR_EXPERIMENTS = 28; + + // Bidding strategy type does not support product type ad group criterion. + BIDDING_STRATEGY_TYPE_DOES_NOT_SUPPORT_PRODUCT_TYPE_ADGROUP_CRITERION = 29; + + // Bid amount is too small. + BID_TOO_SMALL = 30; + + // Bid amount is too big. + BID_TOO_BIG = 31; + + // Bid has too many fractional digit precision. + BID_TOO_MANY_FRACTIONAL_DIGITS = 32; + + // Invalid domain name specified. + INVALID_DOMAIN_NAME = 33; + + // The field is not compatible with the payment mode. + NOT_COMPATIBLE_WITH_PAYMENT_MODE = 34; + + // The field is not compatible with the budget type. + NOT_COMPATIBLE_WITH_BUDGET_TYPE = 35; + + // The field is not compatible with the bidding strategy type. + NOT_COMPATIBLE_WITH_BIDDING_STRATEGY_TYPE = 36; + + // Bidding strategy type is incompatible with shared budget. + BIDDING_STRATEGY_TYPE_INCOMPATIBLE_WITH_SHARED_BUDGET = 37; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/bidding_strategy_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/bidding_strategy_error.proto new file mode 100644 index 000000000..1d5648047 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/bidding_strategy_error.proto @@ -0,0 +1,61 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "BiddingStrategyErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing bidding strategy errors. + +// Container for enum describing possible bidding strategy errors. +message BiddingStrategyErrorEnum { + // Enum describing possible bidding strategy errors. + enum BiddingStrategyError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Each bidding strategy must have a unique name. + DUPLICATE_NAME = 2; + + // Bidding strategy type is immutable. + CANNOT_CHANGE_BIDDING_STRATEGY_TYPE = 3; + + // Only bidding strategies not linked to campaigns, adgroups or adgroup + // criteria can be removed. + CANNOT_REMOVE_ASSOCIATED_STRATEGY = 4; + + // The specified bidding strategy is not supported. + BIDDING_STRATEGY_NOT_SUPPORTED = 5; + + // The bidding strategy is incompatible with the campaign's bidding + // strategy goal type. + INCOMPATIBLE_BIDDING_STRATEGY_AND_BIDDING_STRATEGY_GOAL_TYPE = 6; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/billing_setup_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/billing_setup_error.proto new file mode 100644 index 000000000..a34c6f2d7 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/billing_setup_error.proto @@ -0,0 +1,105 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "BillingSetupErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing billing setup errors. + +// Container for enum describing possible billing setup errors. +message BillingSetupErrorEnum { + // Enum describing possible billing setup errors. + enum BillingSetupError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Cannot specify both an existing payments account and a new payments + // account when setting up billing. + CANNOT_USE_EXISTING_AND_NEW_ACCOUNT = 2; + + // Cannot cancel an approved billing setup whose start time has passed. + CANNOT_REMOVE_STARTED_BILLING_SETUP = 3; + + // Cannot perform a Change of Bill-To (CBT) to the same payments account. + CANNOT_CHANGE_BILLING_TO_SAME_PAYMENTS_ACCOUNT = 4; + + // Billing setups can only be used by customers with ENABLED or DRAFT + // status. + BILLING_SETUP_NOT_PERMITTED_FOR_CUSTOMER_STATUS = 5; + + // Billing setups must either include a correctly formatted existing + // payments account id, or a non-empty new payments account name. + INVALID_PAYMENTS_ACCOUNT = 6; + + // Only billable and third-party customers can create billing setups. + BILLING_SETUP_NOT_PERMITTED_FOR_CUSTOMER_CATEGORY = 7; + + // Billing setup creations can only use NOW for start time type. + INVALID_START_TIME_TYPE = 8; + + // Billing setups can only be created for a third-party customer if they do + // not already have a setup. + THIRD_PARTY_ALREADY_HAS_BILLING = 9; + + // Billing setups cannot be created if there is already a pending billing in + // progress. + BILLING_SETUP_IN_PROGRESS = 10; + + // Billing setups can only be created by customers who have permission to + // setup billings. Users can contact a representative for help setting up + // permissions. + NO_SIGNUP_PERMISSION = 11; + + // Billing setups cannot be created if there is already a future-approved + // billing. + CHANGE_OF_BILL_TO_IN_PROGRESS = 12; + + // Requested payments profile not found. + PAYMENTS_PROFILE_NOT_FOUND = 13; + + // Requested payments account not found. + PAYMENTS_ACCOUNT_NOT_FOUND = 14; + + // Billing setup creation failed because the payments profile is ineligible. + PAYMENTS_PROFILE_INELIGIBLE = 15; + + // Billing setup creation failed because the payments account is ineligible. + PAYMENTS_ACCOUNT_INELIGIBLE = 16; + + // Billing setup creation failed because the payments profile needs internal + // approval. + CUSTOMER_NEEDS_INTERNAL_APPROVAL = 17; + + // Payments account has different currency code than the current customer + // and hence cannot be used to setup billing. + PAYMENTS_ACCOUNT_INELIGIBLE_CURRENCY_CODE_MISMATCH = 19; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/campaign_budget_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/campaign_budget_error.proto new file mode 100644 index 000000000..e13bd82b6 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/campaign_budget_error.proto @@ -0,0 +1,97 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "CampaignBudgetErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing campaign budget errors. + +// Container for enum describing possible campaign budget errors. +message CampaignBudgetErrorEnum { + // Enum describing possible campaign budget errors. + enum CampaignBudgetError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The campaign budget cannot be shared. + CAMPAIGN_BUDGET_CANNOT_BE_SHARED = 17; + + // The requested campaign budget no longer exists. + CAMPAIGN_BUDGET_REMOVED = 2; + + // The campaign budget is associated with at least one campaign, and so the + // campaign budget cannot be removed. + CAMPAIGN_BUDGET_IN_USE = 3; + + // Customer is not whitelisted for this campaign budget period. + CAMPAIGN_BUDGET_PERIOD_NOT_AVAILABLE = 4; + + // This field is not mutable on implicitly shared campaign budgets + CANNOT_MODIFY_FIELD_OF_IMPLICITLY_SHARED_CAMPAIGN_BUDGET = 6; + + // Cannot change explicitly shared campaign budgets back to implicitly + // shared ones. + CANNOT_UPDATE_CAMPAIGN_BUDGET_TO_IMPLICITLY_SHARED = 7; + + // An implicit campaign budget without a name cannot be changed to + // explicitly shared campaign budget. + CANNOT_UPDATE_CAMPAIGN_BUDGET_TO_EXPLICITLY_SHARED_WITHOUT_NAME = 8; + + // Cannot change an implicitly shared campaign budget to an explicitly + // shared one. + CANNOT_UPDATE_CAMPAIGN_BUDGET_TO_EXPLICITLY_SHARED = 9; + + // Only explicitly shared campaign budgets can be used with multiple + // campaigns. + CANNOT_USE_IMPLICITLY_SHARED_CAMPAIGN_BUDGET_WITH_MULTIPLE_CAMPAIGNS = 10; + + // A campaign budget with this name already exists. + DUPLICATE_NAME = 11; + + // A money amount was not in the expected currency. + MONEY_AMOUNT_IN_WRONG_CURRENCY = 12; + + // A money amount was less than the minimum CPC for currency. + MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC = 13; + + // A money amount was greater than the maximum allowed. + MONEY_AMOUNT_TOO_LARGE = 14; + + // A money amount was negative. + NEGATIVE_MONEY_AMOUNT = 15; + + // A money amount was not a multiple of a minimum unit. + NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT = 16; + + // Total budget amount must be unset when BudgetPeriod is DAILY. + TOTAL_BUDGET_AMOUNT_MUST_BE_UNSET_FOR_BUDGET_PERIOD_DAILY = 18; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/campaign_criterion_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/campaign_criterion_error.proto new file mode 100644 index 000000000..8ab8358aa --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/campaign_criterion_error.proto @@ -0,0 +1,81 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "CampaignCriterionErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing campaign criterion errors. + +// Container for enum describing possible campaign criterion errors. +message CampaignCriterionErrorEnum { + // Enum describing possible campaign criterion errors. + enum CampaignCriterionError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Concrete type of criterion (keyword v.s. placement) is required for + // CREATE and UPDATE operations. + CONCRETE_TYPE_REQUIRED = 2; + + // Invalid placement URL. + INVALID_PLACEMENT_URL = 3; + + // Criteria type can not be excluded for the campaign by the customer. like + // AOL account type cannot target site type criteria + CANNOT_EXCLUDE_CRITERIA_TYPE = 4; + + // Cannot set the campaign criterion status for this criteria type. + CANNOT_SET_STATUS_FOR_CRITERIA_TYPE = 5; + + // Cannot set the campaign criterion status for an excluded criteria. + CANNOT_SET_STATUS_FOR_EXCLUDED_CRITERIA = 6; + + // Cannot target and exclude the same criterion. + CANNOT_TARGET_AND_EXCLUDE = 7; + + // The mutate contained too many operations. + TOO_MANY_OPERATIONS = 8; + + // This operator cannot be applied to a criterion of this type. + OPERATOR_NOT_SUPPORTED_FOR_CRITERION_TYPE = 9; + + // The Shopping campaign sales country is not supported for + // ProductSalesChannel targeting. + SHOPPING_CAMPAIGN_SALES_COUNTRY_NOT_SUPPORTED_FOR_SALES_CHANNEL = 10; + + // The existing field can't be updated with CREATE operation. It can be + // updated with UPDATE operation only. + CANNOT_ADD_EXISTING_FIELD = 11; + + // Negative criteria are immutable, so updates are not allowed. + CANNOT_UPDATE_NEGATIVE_CRITERION = 12; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/campaign_draft_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/campaign_draft_error.proto new file mode 100644 index 000000000..fcf940018 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/campaign_draft_error.proto @@ -0,0 +1,79 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "CampaignDraftErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing campaign draft errors. + +// Container for enum describing possible campaign draft errors. +message CampaignDraftErrorEnum { + // Enum describing possible campaign draft errors. + enum CampaignDraftError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // A draft with this name already exists for this campaign. + DUPLICATE_DRAFT_NAME = 2; + + // The draft is removed and cannot be transitioned to another status. + INVALID_STATUS_TRANSITION_FROM_REMOVED = 3; + + // The draft has been promoted and cannot be transitioned to the specified + // status. + INVALID_STATUS_TRANSITION_FROM_PROMOTED = 4; + + // The draft has failed to be promoted and cannot be transitioned to the + // specified status. + INVALID_STATUS_TRANSITION_FROM_PROMOTE_FAILED = 5; + + // This customer is not allowed to create drafts. + CUSTOMER_CANNOT_CREATE_DRAFT = 6; + + // This campaign is not allowed to create drafts. + CAMPAIGN_CANNOT_CREATE_DRAFT = 7; + + // This modification cannot be made on a draft. + INVALID_DRAFT_CHANGE = 8; + + // The draft cannot be transitioned to the specified status from its + // current status. + INVALID_STATUS_TRANSITION = 9; + + // The campaign has reached the maximum number of drafts that can be created + // for a campaign throughout its lifetime. No additional drafts can be + // created for this campaign. Removed drafts also count towards this limit. + MAX_NUMBER_OF_DRAFTS_PER_CAMPAIGN_REACHED = 10; + + // ListAsyncErrors was called without first promoting the draft. + LIST_ERRORS_FOR_PROMOTED_DRAFT_ONLY = 11; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/campaign_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/campaign_error.proto new file mode 100644 index 000000000..865e77ed1 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/campaign_error.proto @@ -0,0 +1,179 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "CampaignErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing campaign errors. + +// Container for enum describing possible campaign errors. +message CampaignErrorEnum { + // Enum describing possible campaign errors. + enum CampaignError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Cannot target content network. + CANNOT_TARGET_CONTENT_NETWORK = 3; + + // Cannot target search network. + CANNOT_TARGET_SEARCH_NETWORK = 4; + + // Cannot cover search network without google search network. + CANNOT_TARGET_SEARCH_NETWORK_WITHOUT_GOOGLE_SEARCH = 5; + + // Cannot target Google Search network for a CPM campaign. + CANNOT_TARGET_GOOGLE_SEARCH_FOR_CPM_CAMPAIGN = 6; + + // Must target at least one network. + CAMPAIGN_MUST_TARGET_AT_LEAST_ONE_NETWORK = 7; + + // Only some Google partners are allowed to target partner search network. + CANNOT_TARGET_PARTNER_SEARCH_NETWORK = 8; + + // Cannot target content network only as campaign has criteria-level bidding + // strategy. + CANNOT_TARGET_CONTENT_NETWORK_ONLY_WITH_CRITERIA_LEVEL_BIDDING_STRATEGY = 9; + + // Cannot modify the start or end date such that the campaign duration would + // not contain the durations of all runnable trials. + CAMPAIGN_DURATION_MUST_CONTAIN_ALL_RUNNABLE_TRIALS = 10; + + // Cannot modify dates, budget or campaign name of a trial campaign. + CANNOT_MODIFY_FOR_TRIAL_CAMPAIGN = 11; + + // Trying to modify the name of an active or paused campaign, where the name + // is already assigned to another active or paused campaign. + DUPLICATE_CAMPAIGN_NAME = 12; + + // Two fields are in conflicting modes. + INCOMPATIBLE_CAMPAIGN_FIELD = 13; + + // Campaign name cannot be used. + INVALID_CAMPAIGN_NAME = 14; + + // Given status is invalid. + INVALID_AD_SERVING_OPTIMIZATION_STATUS = 15; + + // Error in the campaign level tracking URL. + INVALID_TRACKING_URL = 16; + + // Cannot set both tracking URL template and tracking setting. A user has + // to clear legacy tracking setting in order to add tracking URL template. + CANNOT_SET_BOTH_TRACKING_URL_TEMPLATE_AND_TRACKING_SETTING = 17; + + // The maximum number of impressions for Frequency Cap should be an integer + // greater than 0. + MAX_IMPRESSIONS_NOT_IN_RANGE = 18; + + // Only the Day, Week and Month time units are supported. + TIME_UNIT_NOT_SUPPORTED = 19; + + // Operation not allowed on a campaign whose serving status has ended + INVALID_OPERATION_IF_SERVING_STATUS_HAS_ENDED = 20; + + // This budget is exclusively linked to a Campaign that is using experiments + // so it cannot be shared. + BUDGET_CANNOT_BE_SHARED = 21; + + // Campaigns using experiments cannot use a shared budget. + CAMPAIGN_CANNOT_USE_SHARED_BUDGET = 22; + + // A different budget cannot be assigned to a campaign when there are + // running or scheduled trials. + CANNOT_CHANGE_BUDGET_ON_CAMPAIGN_WITH_TRIALS = 23; + + // No link found between the campaign and the label. + CAMPAIGN_LABEL_DOES_NOT_EXIST = 24; + + // The label has already been attached to the campaign. + CAMPAIGN_LABEL_ALREADY_EXISTS = 25; + + // A ShoppingSetting was not found when creating a shopping campaign. + MISSING_SHOPPING_SETTING = 26; + + // The country in shopping setting is not an allowed country. + INVALID_SHOPPING_SALES_COUNTRY = 27; + + // The requested channel type is not available according to the customer's + // account setting. + ADVERTISING_CHANNEL_TYPE_NOT_AVAILABLE_FOR_ACCOUNT_TYPE = 31; + + // The AdvertisingChannelSubType is not a valid subtype of the primary + // channel type. + INVALID_ADVERTISING_CHANNEL_SUB_TYPE = 32; + + // At least one conversion must be selected. + AT_LEAST_ONE_CONVERSION_MUST_BE_SELECTED = 33; + + // Setting ad rotation mode for a campaign is not allowed. Ad rotation mode + // at campaign is deprecated. + CANNOT_SET_AD_ROTATION_MODE = 34; + + // Trying to change start date on a campaign that has started. + CANNOT_MODIFY_START_DATE_IF_ALREADY_STARTED = 35; + + // Trying to modify a date into the past. + CANNOT_SET_DATE_TO_PAST = 36; + + // Hotel center id in the hotel setting does not match any customer links. + MISSING_HOTEL_CUSTOMER_LINK = 37; + + // Hotel center id in the hotel setting must match an active customer link. + INVALID_HOTEL_CUSTOMER_LINK = 38; + + // Hotel setting was not found when creating a hotel ads campaign. + MISSING_HOTEL_SETTING = 39; + + // A Campaign cannot use shared campaign budgets and be part of a campaign + // group. + CANNOT_USE_SHARED_CAMPAIGN_BUDGET_WHILE_PART_OF_CAMPAIGN_GROUP = 40; + + // The app ID was not found. + APP_NOT_FOUND = 41; + + // Campaign.shopping_setting.enable_local is not supported for the specified + // campaign type. + SHOPPING_ENABLE_LOCAL_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE = 42; + + // The merchant does not support the creation of campaigns for Shopping + // Comparison Listing Ads. + MERCHANT_NOT_ALLOWED_FOR_COMPARISON_LISTING_ADS = 43; + + // The App campaign for engagement cannot be created because there aren't + // enough installs. + INSUFFICIENT_APP_INSTALLS_COUNT = 44; + + // The App campaign for engagement cannot be created because the app is + // sensitive. + SENSITIVE_CATEGORY_APP = 45; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/campaign_experiment_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/campaign_experiment_error.proto new file mode 100644 index 000000000..4d55ef7c0 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/campaign_experiment_error.proto @@ -0,0 +1,81 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "CampaignExperimentErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing campaign experiment errors. + +// Container for enum describing possible campaign experiment errors. +message CampaignExperimentErrorEnum { + // Enum describing possible campaign experiment errors. + enum CampaignExperimentError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // An active campaign or experiment with this name already exists. + DUPLICATE_NAME = 2; + + // Experiment cannot be updated from the current state to the + // requested target state. For example, an experiment can only graduate + // if its status is ENABLED. + INVALID_TRANSITION = 3; + + // Cannot create an experiment from a campaign using an explicitly shared + // budget. + CANNOT_CREATE_EXPERIMENT_WITH_SHARED_BUDGET = 4; + + // Cannot create an experiment for a removed base campaign. + CANNOT_CREATE_EXPERIMENT_FOR_REMOVED_BASE_CAMPAIGN = 5; + + // Cannot create an experiment from a draft, which has a status other than + // proposed. + CANNOT_CREATE_EXPERIMENT_FOR_NON_PROPOSED_DRAFT = 6; + + // This customer is not allowed to create an experiment. + CUSTOMER_CANNOT_CREATE_EXPERIMENT = 7; + + // This campaign is not allowed to create an experiment. + CAMPAIGN_CANNOT_CREATE_EXPERIMENT = 8; + + // Trying to set an experiment duration which overlaps with another + // experiment. + EXPERIMENT_DURATIONS_MUST_NOT_OVERLAP = 9; + + // All non-removed experiments must start and end within their campaign's + // duration. + EXPERIMENT_DURATION_MUST_BE_WITHIN_CAMPAIGN_DURATION = 10; + + // The experiment cannot be modified because its status is in a terminal + // state, such as REMOVED. + CANNOT_MUTATE_EXPERIMENT_DUE_TO_STATUS = 11; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/campaign_feed_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/campaign_feed_error.proto new file mode 100644 index 000000000..5ab25af5f --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/campaign_feed_error.proto @@ -0,0 +1,67 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "CampaignFeedErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing campaign feed errors. + +// Container for enum describing possible campaign feed errors. +message CampaignFeedErrorEnum { + // Enum describing possible campaign feed errors. + enum CampaignFeedError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // An active feed already exists for this campaign and placeholder type. + FEED_ALREADY_EXISTS_FOR_PLACEHOLDER_TYPE = 2; + + // The specified feed is removed. + CANNOT_CREATE_FOR_REMOVED_FEED = 4; + + // The CampaignFeed already exists. UPDATE should be used to modify the + // existing CampaignFeed. + CANNOT_CREATE_ALREADY_EXISTING_CAMPAIGN_FEED = 5; + + // Cannot update removed campaign feed. + CANNOT_MODIFY_REMOVED_CAMPAIGN_FEED = 6; + + // Invalid placeholder type. + INVALID_PLACEHOLDER_TYPE = 7; + + // Feed mapping for this placeholder type does not exist. + MISSING_FEEDMAPPING_FOR_PLACEHOLDER_TYPE = 8; + + // Location CampaignFeeds cannot be created unless there is a location + // CustomerFeed for the specified feed. + NO_EXISTING_LOCATION_CUSTOMER_FEED = 9; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/campaign_shared_set_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/campaign_shared_set_error.proto new file mode 100644 index 000000000..b87cd000d --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/campaign_shared_set_error.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "CampaignSharedSetErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing campaign shared set errors. + +// Container for enum describing possible campaign shared set errors. +message CampaignSharedSetErrorEnum { + // Enum describing possible campaign shared set errors. + enum CampaignSharedSetError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The shared set belongs to another customer and permission isn't granted. + SHARED_SET_ACCESS_DENIED = 2; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/change_status_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/change_status_error.proto new file mode 100644 index 000000000..e8ba8d936 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/change_status_error.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "ChangeStatusErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing change status errors. + +// Container for enum describing possible change status errors. +message ChangeStatusErrorEnum { + // Enum describing possible change status errors. + enum ChangeStatusError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The requested start date is too old. + START_DATE_TOO_OLD = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/collection_size_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/collection_size_error.proto new file mode 100644 index 000000000..2af17e8d3 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/collection_size_error.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "CollectionSizeErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing collection size errors. + +// Container for enum describing possible collection size errors. +message CollectionSizeErrorEnum { + // Enum describing possible collection size errors. + enum CollectionSizeError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Too few. + TOO_FEW = 2; + + // Too many. + TOO_MANY = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/context_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/context_error.proto new file mode 100644 index 000000000..c0c5e594a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/context_error.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "ContextErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing context errors. + +// Container for enum describing possible context errors. +message ContextErrorEnum { + // Enum describing possible context errors. + enum ContextError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The operation is not allowed for the given context. + OPERATION_NOT_PERMITTED_FOR_CONTEXT = 2; + + // The operation is not allowed for removed resources. + OPERATION_NOT_PERMITTED_FOR_REMOVED_RESOURCE = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/conversion_action_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/conversion_action_error.proto new file mode 100644 index 000000000..dbafaef0f --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/conversion_action_error.proto @@ -0,0 +1,75 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "ConversionActionErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing conversion action errors. + +// Container for enum describing possible conversion action errors. +message ConversionActionErrorEnum { + // Enum describing possible conversion action errors. + enum ConversionActionError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The specified conversion action name already exists. + DUPLICATE_NAME = 2; + + // Another conversion action with the specified app id already exists. + DUPLICATE_APP_ID = 3; + + // Android first open action conflicts with Google play codeless download + // action tracking the same app. + TWO_CONVERSION_ACTIONS_BIDDING_ON_SAME_APP_DOWNLOAD = 4; + + // Android first open action conflicts with Google play codeless download + // action tracking the same app. + BIDDING_ON_SAME_APP_DOWNLOAD_AS_GLOBAL_ACTION = 5; + + // The attribution model cannot be set to DATA_DRIVEN because a data-driven + // model has never been generated. + DATA_DRIVEN_MODEL_WAS_NEVER_GENERATED = 6; + + // The attribution model cannot be set to DATA_DRIVEN because the + // data-driven model is expired. + DATA_DRIVEN_MODEL_EXPIRED = 7; + + // The attribution model cannot be set to DATA_DRIVEN because the + // data-driven model is stale. + DATA_DRIVEN_MODEL_STALE = 8; + + // The attribution model cannot be set to DATA_DRIVEN because the + // data-driven model is unavailable or the conversion action was newly + // added. + DATA_DRIVEN_MODEL_UNKNOWN = 9; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/conversion_adjustment_upload_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/conversion_adjustment_upload_error.proto new file mode 100644 index 000000000..ac6534f16 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/conversion_adjustment_upload_error.proto @@ -0,0 +1,85 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "ConversionAdjustmentUploadErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing conversion adjustment upload errors. + +// Container for enum describing possible conversion adjustment upload errors. +message ConversionAdjustmentUploadErrorEnum { + // Enum describing possible conversion adjustment upload errors. + enum ConversionAdjustmentUploadError { + // Not specified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The specified conversion action was created too recently. + // Please try the upload again after 4-6 hours have passed since the + // conversion action was created. + TOO_RECENT_CONVERSION_ACTION = 2; + + // No conversion action of a supported ConversionActionType that matches the + // provided information can be found for the customer. + INVALID_CONVERSION_ACTION = 3; + + // A retraction was already reported for this conversion. + CONVERSION_ALREADY_RETRACTED = 4; + + // A conversion for the supplied combination of conversion + // action and conversion identifier could not be found. + CONVERSION_NOT_FOUND = 5; + + // The specified conversion has already expired. Conversions expire after 55 + // days, after which adjustments cannot be reported against them. + CONVERSION_EXPIRED = 6; + + // The supplied adjustment date time precedes that of the original + // conversion. + ADJUSTMENT_PRECEDES_CONVERSION = 7; + + // A restatement with a more recent adjustment date time was already + // reported for this conversion. + MORE_RECENT_RESTATEMENT_FOUND = 8; + + // The conversion was created too recently. + TOO_RECENT_CONVERSION = 9; + + // Restatements cannot be reported for a conversion action that always uses + // the default value. + CANNOT_RESTATE_CONVERSION_ACTION_THAT_ALWAYS_USES_DEFAULT_CONVERSION_VALUE = 10; + + // The request contained more than 2000 adjustments. + TOO_MANY_ADJUSTMENTS_IN_REQUEST = 11; + + // The conversion has been adjusted too many times. + TOO_MANY_ADJUSTMENTS = 12; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/conversion_upload_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/conversion_upload_error.proto new file mode 100644 index 000000000..b852de862 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/conversion_upload_error.proto @@ -0,0 +1,130 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "ConversionUploadErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing conversion upload errors. + +// Container for enum describing possible conversion upload errors. +message ConversionUploadErrorEnum { + // Enum describing possible conversion upload errors. + enum ConversionUploadError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The request contained more than 2000 conversions. + TOO_MANY_CONVERSIONS_IN_REQUEST = 2; + + // The specified gclid could not be decoded. + UNPARSEABLE_GCLID = 3; + + // The specified conversion_date_time is before the event time + // associated with the given gclid. + CONVERSION_PRECEDES_GCLID = 4; + + // The click associated with the given gclid is either too old to be + // imported or occurred outside of the click through lookback window for the + // specified conversion action. + EXPIRED_GCLID = 5; + + // The click associated with the given gclid occurred too recently. Please + // try uploading again after 6 hours have passed since the click occurred. + TOO_RECENT_GCLID = 6; + + // The click associated with the given gclid could not be found in the + // system. This can happen if Google Click IDs are collected for non Google + // Ads clicks. + GCLID_NOT_FOUND = 7; + + // The click associated with the given gclid is owned by a customer + // account that the uploading customer does not manage. + UNAUTHORIZED_CUSTOMER = 8; + + // No upload eligible conversion action that matches the provided + // information can be found for the customer. + INVALID_CONVERSION_ACTION = 9; + + // The specified conversion action was created too recently. + // Please try the upload again after 4-6 hours have passed since the + // conversion action was created. + TOO_RECENT_CONVERSION_ACTION = 10; + + // The click associated with the given gclid does not contain conversion + // tracking information. + CONVERSION_TRACKING_NOT_ENABLED_AT_IMPRESSION_TIME = 11; + + // The specified conversion action does not use an external attribution + // model, but external_attribution_data was set. + EXTERNAL_ATTRIBUTION_DATA_SET_FOR_NON_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION = 12; + + // The specified conversion action uses an external attribution model, but + // external_attribution_data or one of its contained fields was not set. + // Both external_attribution_credit and external_attribution_model must be + // set for externally attributed conversion actions. + EXTERNAL_ATTRIBUTION_DATA_NOT_SET_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION = 13; + + // Order IDs are not supported for conversion actions which use an external + // attribution model. + ORDER_ID_NOT_PERMITTED_FOR_EXTERNALLY_ATTRIBUTED_CONVERSION_ACTION = 14; + + // A conversion with the same order id and conversion action combination + // already exists in our system. + ORDER_ID_ALREADY_IN_USE = 15; + + // The request contained two or more conversions with the same order id and + // conversion action combination. + DUPLICATE_ORDER_ID = 16; + + // The call occurred too recently. Please try uploading again after 6 hours + // have passed since the call occurred. + TOO_RECENT_CALL = 17; + + // The click that initiated the call is too old for this conversion to be + // imported. + EXPIRED_CALL = 18; + + // The call or the click leading to the call was not found. + CALL_NOT_FOUND = 19; + + // The specified conversion_date_time is before the call_start_date_time. + CONVERSION_PRECEDES_CALL = 20; + + // The click associated with the call does not contain conversion tracking + // information. + CONVERSION_TRACKING_NOT_ENABLED_AT_CALL_TIME = 21; + + // The caller’s phone number cannot be parsed. It should be formatted either + // as E.164 "+16502531234", International "+64 3-331 6005" or US national + // number "6502531234". + UNPARSEABLE_CALLERS_PHONE_NUMBER = 22; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/country_code_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/country_code_error.proto new file mode 100644 index 000000000..688c56566 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/country_code_error.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "CountryCodeErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing country code errors. + +// Container for enum describing country code errors. +message CountryCodeErrorEnum { + // Enum describing country code errors. + enum CountryCodeError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The country code is invalid. + INVALID_COUNTRY_CODE = 2; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/criterion_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/criterion_error.proto new file mode 100644 index 000000000..86a0673cd --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/criterion_error.proto @@ -0,0 +1,390 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "CriterionErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing criterion errors. + +// Container for enum describing possible criterion errors. +message CriterionErrorEnum { + // Enum describing possible criterion errors. + enum CriterionError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Concrete type of criterion is required for CREATE and UPDATE operations. + CONCRETE_TYPE_REQUIRED = 2; + + // The category requested for exclusion is invalid. + INVALID_EXCLUDED_CATEGORY = 3; + + // Invalid keyword criteria text. + INVALID_KEYWORD_TEXT = 4; + + // Keyword text should be less than 80 chars. + KEYWORD_TEXT_TOO_LONG = 5; + + // Keyword text has too many words. + KEYWORD_HAS_TOO_MANY_WORDS = 6; + + // Keyword text has invalid characters or symbols. + KEYWORD_HAS_INVALID_CHARS = 7; + + // Invalid placement URL. + INVALID_PLACEMENT_URL = 8; + + // Invalid user list criterion. + INVALID_USER_LIST = 9; + + // Invalid user interest criterion. + INVALID_USER_INTEREST = 10; + + // Placement URL has wrong format. + INVALID_FORMAT_FOR_PLACEMENT_URL = 11; + + // Placement URL is too long. + PLACEMENT_URL_IS_TOO_LONG = 12; + + // Indicates the URL contains an illegal character. + PLACEMENT_URL_HAS_ILLEGAL_CHAR = 13; + + // Indicates the URL contains multiple comma separated URLs. + PLACEMENT_URL_HAS_MULTIPLE_SITES_IN_LINE = 14; + + // Indicates the domain is blacklisted. + PLACEMENT_IS_NOT_AVAILABLE_FOR_TARGETING_OR_EXCLUSION = 15; + + // Invalid topic path. + INVALID_TOPIC_PATH = 16; + + // The YouTube Channel Id is invalid. + INVALID_YOUTUBE_CHANNEL_ID = 17; + + // The YouTube Video Id is invalid. + INVALID_YOUTUBE_VIDEO_ID = 18; + + // Indicates the placement is a YouTube vertical channel, which is no longer + // supported. + YOUTUBE_VERTICAL_CHANNEL_DEPRECATED = 19; + + // Indicates the placement is a YouTube demographic channel, which is no + // longer supported. + YOUTUBE_DEMOGRAPHIC_CHANNEL_DEPRECATED = 20; + + // YouTube urls are not supported in Placement criterion. Use YouTubeChannel + // and YouTubeVideo criterion instead. + YOUTUBE_URL_UNSUPPORTED = 21; + + // Criteria type can not be excluded by the customer, like AOL account type + // cannot target site type criteria. + CANNOT_EXCLUDE_CRITERIA_TYPE = 22; + + // Criteria type can not be targeted. + CANNOT_ADD_CRITERIA_TYPE = 23; + + // Product filter in the product criteria has invalid characters. Operand + // and the argument in the filter can not have "==" or "&+". + INVALID_PRODUCT_FILTER = 24; + + // Product filter in the product criteria is translated to a string as + // operand1==argument1&+operand2==argument2, maximum allowed length for the + // string is 255 chars. + PRODUCT_FILTER_TOO_LONG = 25; + + // Not allowed to exclude similar user list. + CANNOT_EXCLUDE_SIMILAR_USER_LIST = 26; + + // Not allowed to target a closed user list. + CANNOT_ADD_CLOSED_USER_LIST = 27; + + // Not allowed to add display only UserLists to search only campaigns. + CANNOT_ADD_DISPLAY_ONLY_LISTS_TO_SEARCH_ONLY_CAMPAIGNS = 28; + + // Not allowed to add display only UserLists to search plus campaigns. + CANNOT_ADD_DISPLAY_ONLY_LISTS_TO_SEARCH_CAMPAIGNS = 29; + + // Not allowed to add display only UserLists to shopping campaigns. + CANNOT_ADD_DISPLAY_ONLY_LISTS_TO_SHOPPING_CAMPAIGNS = 30; + + // Not allowed to add User interests to search only campaigns. + CANNOT_ADD_USER_INTERESTS_TO_SEARCH_CAMPAIGNS = 31; + + // Not allowed to set bids for this criterion type in search campaigns + CANNOT_SET_BIDS_ON_CRITERION_TYPE_IN_SEARCH_CAMPAIGNS = 32; + + // Final URLs, URL Templates and CustomParameters cannot be set for the + // criterion types of Gender, AgeRange, UserList, Placement, MobileApp, and + // MobileAppCategory in search campaigns and shopping campaigns. + CANNOT_ADD_URLS_TO_CRITERION_TYPE_FOR_CAMPAIGN_TYPE = 33; + + // Invalid custom affinity criterion. + INVALID_CUSTOM_AFFINITY = 96; + + // Invalid custom intent criterion. + INVALID_CUSTOM_INTENT = 97; + + // IP address is not valid. + INVALID_IP_ADDRESS = 34; + + // IP format is not valid. + INVALID_IP_FORMAT = 35; + + // Mobile application is not valid. + INVALID_MOBILE_APP = 36; + + // Mobile application category is not valid. + INVALID_MOBILE_APP_CATEGORY = 37; + + // The CriterionId does not exist or is of the incorrect type. + INVALID_CRITERION_ID = 38; + + // The Criterion is not allowed to be targeted. + CANNOT_TARGET_CRITERION = 39; + + // The criterion is not allowed to be targeted as it is deprecated. + CANNOT_TARGET_OBSOLETE_CRITERION = 40; + + // The CriterionId is not valid for the type. + CRITERION_ID_AND_TYPE_MISMATCH = 41; + + // Distance for the radius for the proximity criterion is invalid. + INVALID_PROXIMITY_RADIUS = 42; + + // Units for the distance for the radius for the proximity criterion is + // invalid. + INVALID_PROXIMITY_RADIUS_UNITS = 43; + + // Street address in the address is not valid. + INVALID_STREETADDRESS_LENGTH = 44; + + // City name in the address is not valid. + INVALID_CITYNAME_LENGTH = 45; + + // Region code in the address is not valid. + INVALID_REGIONCODE_LENGTH = 46; + + // Region name in the address is not valid. + INVALID_REGIONNAME_LENGTH = 47; + + // Postal code in the address is not valid. + INVALID_POSTALCODE_LENGTH = 48; + + // Country code in the address is not valid. + INVALID_COUNTRY_CODE = 49; + + // Latitude for the GeoPoint is not valid. + INVALID_LATITUDE = 50; + + // Longitude for the GeoPoint is not valid. + INVALID_LONGITUDE = 51; + + // The Proximity input is not valid. Both address and geoPoint cannot be + // null. + PROXIMITY_GEOPOINT_AND_ADDRESS_BOTH_CANNOT_BE_NULL = 52; + + // The Proximity address cannot be geocoded to a valid lat/long. + INVALID_PROXIMITY_ADDRESS = 53; + + // User domain name is not valid. + INVALID_USER_DOMAIN_NAME = 54; + + // Length of serialized criterion parameter exceeded size limit. + CRITERION_PARAMETER_TOO_LONG = 55; + + // Time interval in the AdSchedule overlaps with another AdSchedule. + AD_SCHEDULE_TIME_INTERVALS_OVERLAP = 56; + + // AdSchedule time interval cannot span multiple days. + AD_SCHEDULE_INTERVAL_CANNOT_SPAN_MULTIPLE_DAYS = 57; + + // AdSchedule time interval specified is invalid, endTime cannot be earlier + // than startTime. + AD_SCHEDULE_INVALID_TIME_INTERVAL = 58; + + // The number of AdSchedule entries in a day exceeds the limit. + AD_SCHEDULE_EXCEEDED_INTERVALS_PER_DAY_LIMIT = 59; + + // CriteriaId does not match the interval of the AdSchedule specified. + AD_SCHEDULE_CRITERION_ID_MISMATCHING_FIELDS = 60; + + // Cannot set bid modifier for this criterion type. + CANNOT_BID_MODIFY_CRITERION_TYPE = 61; + + // Cannot bid modify criterion, since it is opted out of the campaign. + CANNOT_BID_MODIFY_CRITERION_CAMPAIGN_OPTED_OUT = 62; + + // Cannot set bid modifier for a negative criterion. + CANNOT_BID_MODIFY_NEGATIVE_CRITERION = 63; + + // Bid Modifier already exists. Use SET operation to update. + BID_MODIFIER_ALREADY_EXISTS = 64; + + // Feed Id is not allowed in these Location Groups. + FEED_ID_NOT_ALLOWED = 65; + + // The account may not use the requested criteria type. For example, some + // accounts are restricted to keywords only. + ACCOUNT_INELIGIBLE_FOR_CRITERIA_TYPE = 66; + + // The requested criteria type cannot be used with campaign or ad group + // bidding strategy. + CRITERIA_TYPE_INVALID_FOR_BIDDING_STRATEGY = 67; + + // The Criterion is not allowed to be excluded. + CANNOT_EXCLUDE_CRITERION = 68; + + // The criterion is not allowed to be removed. For example, we cannot remove + // any of the device criterion. + CANNOT_REMOVE_CRITERION = 69; + + // The combined length of product dimension values of the product scope + // criterion is too long. + PRODUCT_SCOPE_TOO_LONG = 70; + + // Product scope contains too many dimensions. + PRODUCT_SCOPE_TOO_MANY_DIMENSIONS = 71; + + // The combined length of product dimension values of the product partition + // criterion is too long. + PRODUCT_PARTITION_TOO_LONG = 72; + + // Product partition contains too many dimensions. + PRODUCT_PARTITION_TOO_MANY_DIMENSIONS = 73; + + // The product dimension is invalid (e.g. dimension contains illegal value, + // dimension type is represented with wrong class, etc). Product dimension + // value can not contain "==" or "&+". + INVALID_PRODUCT_DIMENSION = 74; + + // Product dimension type is either invalid for campaigns of this type or + // cannot be used in the current context. BIDDING_CATEGORY_Lx and + // PRODUCT_TYPE_Lx product dimensions must be used in ascending order of + // their levels: L1, L2, L3, L4, L5... The levels must be specified + // sequentially and start from L1. Furthermore, an "others" product + // partition cannot be subdivided with a dimension of the same type but of a + // higher level ("others" BIDDING_CATEGORY_L3 can be subdivided with BRAND + // but not with BIDDING_CATEGORY_L4). + INVALID_PRODUCT_DIMENSION_TYPE = 75; + + // Bidding categories do not form a valid path in the Shopping bidding + // category taxonomy. + INVALID_PRODUCT_BIDDING_CATEGORY = 76; + + // ShoppingSetting must be added to the campaign before ProductScope + // criteria can be added. + MISSING_SHOPPING_SETTING = 77; + + // Matching function is invalid. + INVALID_MATCHING_FUNCTION = 78; + + // Filter parameters not allowed for location groups targeting. + LOCATION_FILTER_NOT_ALLOWED = 79; + + // Feed not found, or the feed is not an enabled location feed. + INVALID_FEED_FOR_LOCATION_FILTER = 98; + + // Given location filter parameter is invalid for location groups targeting. + LOCATION_FILTER_INVALID = 80; + + // Criteria type cannot be associated with a campaign and its ad group(s) + // simultaneously. + CANNOT_ATTACH_CRITERIA_AT_CAMPAIGN_AND_ADGROUP = 81; + + // Range represented by hotel length of stay's min nights and max nights + // overlaps with an existing criterion. + HOTEL_LENGTH_OF_STAY_OVERLAPS_WITH_EXISTING_CRITERION = 82; + + // Range represented by hotel advance booking window's min days and max days + // overlaps with an existing criterion. + HOTEL_ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION = 83; + + // The field is not allowed to be set when the negative field is set to + // true, e.g. we don't allow bids in negative ad group or campaign criteria. + FIELD_INCOMPATIBLE_WITH_NEGATIVE_TARGETING = 84; + + // The combination of operand and operator in webpage condition is invalid. + INVALID_WEBPAGE_CONDITION = 85; + + // The URL of webpage condition is invalid. + INVALID_WEBPAGE_CONDITION_URL = 86; + + // The URL of webpage condition cannot be empty or contain white space. + WEBPAGE_CONDITION_URL_CANNOT_BE_EMPTY = 87; + + // The URL of webpage condition contains an unsupported protocol. + WEBPAGE_CONDITION_URL_UNSUPPORTED_PROTOCOL = 88; + + // The URL of webpage condition cannot be an IP address. + WEBPAGE_CONDITION_URL_CANNOT_BE_IP_ADDRESS = 89; + + // The domain of the URL is not consistent with the domain in campaign + // setting. + WEBPAGE_CONDITION_URL_DOMAIN_NOT_CONSISTENT_WITH_CAMPAIGN_SETTING = 90; + + // The URL of webpage condition cannot be a public suffix itself. + WEBPAGE_CONDITION_URL_CANNOT_BE_PUBLIC_SUFFIX = 91; + + // The URL of webpage condition has an invalid public suffix. + WEBPAGE_CONDITION_URL_INVALID_PUBLIC_SUFFIX = 92; + + // Value track parameter is not supported in webpage condition URL. + WEBPAGE_CONDITION_URL_VALUE_TRACK_VALUE_NOT_SUPPORTED = 93; + + // Only one URL-EQUALS webpage condition is allowed in a webpage + // criterion and it cannot be combined with other conditions. + WEBPAGE_CRITERION_URL_EQUALS_CAN_HAVE_ONLY_ONE_CONDITION = 94; + + // A webpage criterion cannot be added to a non-DSA ad group. + WEBPAGE_CRITERION_NOT_SUPPORTED_ON_NON_DSA_AD_GROUP = 95; + + // Cannot add positive user list criteria in Smart Display campaigns. + CANNOT_TARGET_USER_LIST_FOR_SMART_DISPLAY_CAMPAIGNS = 99; + + // Listing scope contains too many dimension types. + LISTING_SCOPE_TOO_MANY_DIMENSION_TYPES = 100; + + // Listing scope has too many IN operators. + LISTING_SCOPE_TOO_MANY_IN_OPERATORS = 101; + + // Listing scope contains IN operator on an unsupported dimension type. + LISTING_SCOPE_IN_OPERATOR_NOT_SUPPORTED = 102; + + // There are dimensions with duplicate dimension type. + DUPLICATE_LISTING_DIMENSION_TYPE = 103; + + // There are dimensions with duplicate dimension value. + DUPLICATE_LISTING_DIMENSION_VALUE = 104; + + // Listing group SUBDIVISION nodes cannot have bids. + CANNOT_SET_BIDS_ON_LISTING_GROUP_SUBDIVISION = 105; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/currency_code_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/currency_code_error.proto new file mode 100644 index 000000000..ab25f216f --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/currency_code_error.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "CurrencyCodeErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing currency code errors. + +// Container for enum describing possible currency code errors. +message CurrencyCodeErrorEnum { + // Enum describing possible currency code errors. + enum CurrencyCodeError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The currency code is not supported. + UNSUPPORTED = 2; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/custom_interest_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/custom_interest_error.proto new file mode 100644 index 000000000..a2d9396af --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/custom_interest_error.proto @@ -0,0 +1,66 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "CustomInterestErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing custom interest errors. + +// Container for enum describing possible custom interest errors. +message CustomInterestErrorEnum { + // Enum describing possible custom interest errors. + enum CustomInterestError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Duplicate custom interest name ignoring case. + NAME_ALREADY_USED = 2; + + // In the remove custom interest member operation, both member ID and + // pair [type, parameter] are not present. + CUSTOM_INTEREST_MEMBER_ID_AND_TYPE_PARAMETER_NOT_PRESENT_IN_REMOVE = 3; + + // The pair of [type, parameter] does not exist. + TYPE_AND_PARAMETER_NOT_FOUND = 4; + + // The pair of [type, parameter] already exists. + TYPE_AND_PARAMETER_ALREADY_EXISTED = 5; + + // Unsupported custom interest member type. + INVALID_CUSTOM_INTEREST_MEMBER_TYPE = 6; + + // Cannot remove a custom interest while it's still being targeted. + CANNOT_REMOVE_WHILE_IN_USE = 7; + + // Cannot mutate custom interest type. + CANNOT_CHANGE_TYPE = 8; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/customer_client_link_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/customer_client_link_error.proto new file mode 100644 index 000000000..19976aaff --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/customer_client_link_error.proto @@ -0,0 +1,68 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "CustomerClientLinkErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing CustomerClientLink errors. + +// Container for enum describing possible CustomeClientLink errors. +message CustomerClientLinkErrorEnum { + // Enum describing possible CustomerClientLink errors. + enum CustomerClientLinkError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Trying to manage a client that already in being managed by customer. + CLIENT_ALREADY_INVITED_BY_THIS_MANAGER = 2; + + // Already managed by some other manager in the hierarchy. + CLIENT_ALREADY_MANAGED_IN_HIERARCHY = 3; + + // Attempt to create a cycle in the hierarchy. + CYCLIC_LINK_NOT_ALLOWED = 4; + + // Managed accounts has the maximum number of linked accounts. + CUSTOMER_HAS_TOO_MANY_ACCOUNTS = 5; + + // Invitor has the maximum pending invitations. + CLIENT_HAS_TOO_MANY_INVITATIONS = 6; + + // Attempt to change hidden status of a link that is not active. + CANNOT_HIDE_OR_UNHIDE_MANAGER_ACCOUNTS = 7; + + // Parent manager account has the maximum number of linked accounts. + CUSTOMER_HAS_TOO_MANY_ACCOUNTS_AT_MANAGER = 8; + + // Client has too many managers. + CLIENT_HAS_TOO_MANY_MANAGERS = 9; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/customer_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/customer_error.proto new file mode 100644 index 000000000..4c139b504 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/customer_error.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "CustomerErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Container for enum describing possible customer errors. +message CustomerErrorEnum { + // Set of errors that are related to requests dealing with Customer. + enum CustomerError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Customer status is not allowed to be changed from DRAFT and CLOSED. + // Currency code and at least one of country code and time zone needs to be + // set when status is changed to ENABLED. + STATUS_CHANGE_DISALLOWED = 2; + + // CustomerService cannot get a customer that has not been fully set up. + ACCOUNT_NOT_SET_UP = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/customer_feed_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/customer_feed_error.proto new file mode 100644 index 000000000..18ddb4426 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/customer_feed_error.proto @@ -0,0 +1,66 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "CustomerFeedErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing customer feed errors. + +// Container for enum describing possible customer feed errors. +message CustomerFeedErrorEnum { + // Enum describing possible customer feed errors. + enum CustomerFeedError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // An active feed already exists for this customer and place holder type. + FEED_ALREADY_EXISTS_FOR_PLACEHOLDER_TYPE = 2; + + // The specified feed is removed. + CANNOT_CREATE_FOR_REMOVED_FEED = 3; + + // The CustomerFeed already exists. Update should be used to modify the + // existing CustomerFeed. + CANNOT_CREATE_ALREADY_EXISTING_CUSTOMER_FEED = 4; + + // Cannot update removed customer feed. + CANNOT_MODIFY_REMOVED_CUSTOMER_FEED = 5; + + // Invalid placeholder type. + INVALID_PLACEHOLDER_TYPE = 6; + + // Feed mapping for this placeholder type does not exist. + MISSING_FEEDMAPPING_FOR_PLACEHOLDER_TYPE = 7; + + // Placeholder not allowed at the account level. + PLACEHOLDER_TYPE_NOT_ALLOWED_ON_CUSTOMER_FEED = 8; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/customer_manager_link_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/customer_manager_link_error.proto new file mode 100644 index 000000000..457d35d04 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/customer_manager_link_error.proto @@ -0,0 +1,75 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "CustomerManagerLinkErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing CustomerManagerLink errors. + +// Container for enum describing possible CustomerManagerLink errors. +message CustomerManagerLinkErrorEnum { + // Enum describing possible CustomerManagerLink errors. + enum CustomerManagerLinkError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // No pending invitation. + NO_PENDING_INVITE = 2; + + // Attempt to operate on the same client more than once in the same call. + SAME_CLIENT_MORE_THAN_ONCE_PER_CALL = 3; + + // Manager account has the maximum number of linked accounts. + MANAGER_HAS_MAX_NUMBER_OF_LINKED_ACCOUNTS = 4; + + // If no active user on account it cannot be unlinked from its manager. + CANNOT_UNLINK_ACCOUNT_WITHOUT_ACTIVE_USER = 5; + + // Account should have at least one active owner on it before being + // unlinked. + CANNOT_REMOVE_LAST_CLIENT_ACCOUNT_OWNER = 6; + + // Only account owners may change their permission role. + CANNOT_CHANGE_ROLE_BY_NON_ACCOUNT_OWNER = 7; + + // When a client's link to its manager is not active, the link role cannot + // be changed. + CANNOT_CHANGE_ROLE_FOR_NON_ACTIVE_LINK_ACCOUNT = 8; + + // Attempt to link a child to a parent that contains or will contain + // duplicate children. + DUPLICATE_CHILD_FOUND = 9; + + // The authorized customer is a test account. It can add no more than the + // allowed number of accounts + TEST_ACCOUNT_LINKS_TOO_MANY_CHILD_ACCOUNTS = 10; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/database_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/database_error.proto new file mode 100644 index 000000000..c24eb1c1d --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/database_error.proto @@ -0,0 +1,56 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "DatabaseErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing database errors. + +// Container for enum describing possible database errors. +message DatabaseErrorEnum { + // Enum describing possible database errors. + enum DatabaseError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Multiple requests were attempting to modify the same resource at once. + // Please retry the request. + CONCURRENT_MODIFICATION = 2; + + // The request conflicted with existing data. This error will usually be + // replaced with a more specific error if the request is retried. + DATA_CONSTRAINT_VIOLATION = 3; + + // The data written is too large. Please split the request into smaller + // requests. + REQUEST_TOO_LARGE = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/date_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/date_error.proto new file mode 100644 index 000000000..18cea7025 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/date_error.proto @@ -0,0 +1,74 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "DateErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing date errors. + +// Container for enum describing possible date errors. +message DateErrorEnum { + // Enum describing possible date errors. + enum DateError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Given field values do not correspond to a valid date. + INVALID_FIELD_VALUES_IN_DATE = 2; + + // Given field values do not correspond to a valid date time. + INVALID_FIELD_VALUES_IN_DATE_TIME = 3; + + // The string date's format should be yyyy-mm-dd. + INVALID_STRING_DATE = 4; + + // The string date time's format should be yyyy-mm-dd hh:mm:ss.ssssss. + INVALID_STRING_DATE_TIME_MICROS = 6; + + // The string date time's format should be yyyy-mm-dd hh:mm:ss. + INVALID_STRING_DATE_TIME_SECONDS = 11; + + // The string date time's format should be yyyy-mm-dd hh:mm:ss+|-hh:mm. + INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET = 12; + + // Date is before allowed minimum. + EARLIER_THAN_MINIMUM_DATE = 7; + + // Date is after allowed maximum. + LATER_THAN_MAXIMUM_DATE = 8; + + // Date range bounds are not in order. + DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE = 9; + + // Both dates in range are null. + DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL = 10; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/date_range_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/date_range_error.proto new file mode 100644 index 000000000..b42babd3a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/date_range_error.proto @@ -0,0 +1,59 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "DateRangeErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing date range errors. + +// Container for enum describing possible date range errors. +message DateRangeErrorEnum { + // Enum describing possible date range errors. + enum DateRangeError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Invalid date. + INVALID_DATE = 2; + + // The start date was after the end date. + START_DATE_AFTER_END_DATE = 3; + + // Cannot set date to past time + CANNOT_SET_DATE_TO_PAST = 4; + + // A date was used that is past the system "last" date. + AFTER_MAXIMUM_ALLOWABLE_DATE = 5; + + // Trying to change start date on a resource that has started. + CANNOT_MODIFY_START_DATE_IF_ALREADY_STARTED = 6; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/distinct_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/distinct_error.proto new file mode 100644 index 000000000..ac5b32b2c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/distinct_error.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "DistinctErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing distinct errors. + +// Container for enum describing possible distinct errors. +message DistinctErrorEnum { + // Enum describing possible distinct errors. + enum DistinctError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Duplicate element. + DUPLICATE_ELEMENT = 2; + + // Duplicate type. + DUPLICATE_TYPE = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/enum_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/enum_error.proto new file mode 100644 index 000000000..5683037a5 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/enum_error.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "EnumErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing enum errors. + +// Container for enum describing possible enum errors. +message EnumErrorEnum { + // Enum describing possible enum errors. + enum EnumError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The enum value is not permitted. + ENUM_VALUE_NOT_PERMITTED = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/errors.proto b/third_party/googleapis/google/ads/googleads/v3/errors/errors.proto new file mode 100644 index 000000000..ba1379227 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/errors.proto @@ -0,0 +1,565 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/ads/googleads/v3/common/policy.proto"; +import "google/ads/googleads/v3/common/value.proto"; +import "google/ads/googleads/v3/errors/access_invitation_error.proto"; +import "google/ads/googleads/v3/errors/account_budget_proposal_error.proto"; +import "google/ads/googleads/v3/errors/ad_customizer_error.proto"; +import "google/ads/googleads/v3/errors/ad_error.proto"; +import "google/ads/googleads/v3/errors/ad_group_ad_error.proto"; +import "google/ads/googleads/v3/errors/ad_group_bid_modifier_error.proto"; +import "google/ads/googleads/v3/errors/ad_group_criterion_error.proto"; +import "google/ads/googleads/v3/errors/ad_group_error.proto"; +import "google/ads/googleads/v3/errors/ad_group_feed_error.proto"; +import "google/ads/googleads/v3/errors/ad_parameter_error.proto"; +import "google/ads/googleads/v3/errors/ad_sharing_error.proto"; +import "google/ads/googleads/v3/errors/adx_error.proto"; +import "google/ads/googleads/v3/errors/asset_error.proto"; +import "google/ads/googleads/v3/errors/asset_link_error.proto"; +import "google/ads/googleads/v3/errors/authentication_error.proto"; +import "google/ads/googleads/v3/errors/authorization_error.proto"; +import "google/ads/googleads/v3/errors/bidding_error.proto"; +import "google/ads/googleads/v3/errors/bidding_strategy_error.proto"; +import "google/ads/googleads/v3/errors/billing_setup_error.proto"; +import "google/ads/googleads/v3/errors/campaign_budget_error.proto"; +import "google/ads/googleads/v3/errors/campaign_criterion_error.proto"; +import "google/ads/googleads/v3/errors/campaign_draft_error.proto"; +import "google/ads/googleads/v3/errors/campaign_error.proto"; +import "google/ads/googleads/v3/errors/campaign_experiment_error.proto"; +import "google/ads/googleads/v3/errors/campaign_feed_error.proto"; +import "google/ads/googleads/v3/errors/campaign_shared_set_error.proto"; +import "google/ads/googleads/v3/errors/change_status_error.proto"; +import "google/ads/googleads/v3/errors/collection_size_error.proto"; +import "google/ads/googleads/v3/errors/context_error.proto"; +import "google/ads/googleads/v3/errors/conversion_action_error.proto"; +import "google/ads/googleads/v3/errors/conversion_adjustment_upload_error.proto"; +import "google/ads/googleads/v3/errors/conversion_upload_error.proto"; +import "google/ads/googleads/v3/errors/country_code_error.proto"; +import "google/ads/googleads/v3/errors/criterion_error.proto"; +import "google/ads/googleads/v3/errors/currency_code_error.proto"; +import "google/ads/googleads/v3/errors/custom_interest_error.proto"; +import "google/ads/googleads/v3/errors/customer_client_link_error.proto"; +import "google/ads/googleads/v3/errors/customer_error.proto"; +import "google/ads/googleads/v3/errors/customer_feed_error.proto"; +import "google/ads/googleads/v3/errors/customer_manager_link_error.proto"; +import "google/ads/googleads/v3/errors/database_error.proto"; +import "google/ads/googleads/v3/errors/date_error.proto"; +import "google/ads/googleads/v3/errors/date_range_error.proto"; +import "google/ads/googleads/v3/errors/distinct_error.proto"; +import "google/ads/googleads/v3/errors/enum_error.proto"; +import "google/ads/googleads/v3/errors/extension_feed_item_error.proto"; +import "google/ads/googleads/v3/errors/extension_setting_error.proto"; +import "google/ads/googleads/v3/errors/feed_attribute_reference_error.proto"; +import "google/ads/googleads/v3/errors/feed_error.proto"; +import "google/ads/googleads/v3/errors/feed_item_error.proto"; +import "google/ads/googleads/v3/errors/feed_item_target_error.proto"; +import "google/ads/googleads/v3/errors/feed_item_validation_error.proto"; +import "google/ads/googleads/v3/errors/feed_mapping_error.proto"; +import "google/ads/googleads/v3/errors/field_error.proto"; +import "google/ads/googleads/v3/errors/field_mask_error.proto"; +import "google/ads/googleads/v3/errors/function_error.proto"; +import "google/ads/googleads/v3/errors/function_parsing_error.proto"; +import "google/ads/googleads/v3/errors/geo_target_constant_suggestion_error.proto"; +import "google/ads/googleads/v3/errors/header_error.proto"; +import "google/ads/googleads/v3/errors/id_error.proto"; +import "google/ads/googleads/v3/errors/image_error.proto"; +import "google/ads/googleads/v3/errors/internal_error.proto"; +import "google/ads/googleads/v3/errors/invoice_error.proto"; +import "google/ads/googleads/v3/errors/keyword_plan_ad_group_error.proto"; +import "google/ads/googleads/v3/errors/keyword_plan_campaign_error.proto"; +import "google/ads/googleads/v3/errors/keyword_plan_error.proto"; +import "google/ads/googleads/v3/errors/keyword_plan_idea_error.proto"; +import "google/ads/googleads/v3/errors/keyword_plan_keyword_error.proto"; +import "google/ads/googleads/v3/errors/keyword_plan_negative_keyword_error.proto"; +import "google/ads/googleads/v3/errors/label_error.proto"; +import "google/ads/googleads/v3/errors/language_code_error.proto"; +import "google/ads/googleads/v3/errors/list_operation_error.proto"; +import "google/ads/googleads/v3/errors/manager_link_error.proto"; +import "google/ads/googleads/v3/errors/media_bundle_error.proto"; +import "google/ads/googleads/v3/errors/media_file_error.proto"; +import "google/ads/googleads/v3/errors/media_upload_error.proto"; +import "google/ads/googleads/v3/errors/multiplier_error.proto"; +import "google/ads/googleads/v3/errors/mutate_error.proto"; +import "google/ads/googleads/v3/errors/mutate_job_error.proto"; +import "google/ads/googleads/v3/errors/new_resource_creation_error.proto"; +import "google/ads/googleads/v3/errors/not_empty_error.proto"; +import "google/ads/googleads/v3/errors/not_whitelisted_error.proto"; +import "google/ads/googleads/v3/errors/null_error.proto"; +import "google/ads/googleads/v3/errors/offline_user_data_job_error.proto"; +import "google/ads/googleads/v3/errors/operation_access_denied_error.proto"; +import "google/ads/googleads/v3/errors/operator_error.proto"; +import "google/ads/googleads/v3/errors/partial_failure_error.proto"; +import "google/ads/googleads/v3/errors/payments_account_error.proto"; +import "google/ads/googleads/v3/errors/policy_finding_error.proto"; +import "google/ads/googleads/v3/errors/policy_validation_parameter_error.proto"; +import "google/ads/googleads/v3/errors/policy_violation_error.proto"; +import "google/ads/googleads/v3/errors/query_error.proto"; +import "google/ads/googleads/v3/errors/quota_error.proto"; +import "google/ads/googleads/v3/errors/range_error.proto"; +import "google/ads/googleads/v3/errors/reach_plan_error.proto"; +import "google/ads/googleads/v3/errors/recommendation_error.proto"; +import "google/ads/googleads/v3/errors/region_code_error.proto"; +import "google/ads/googleads/v3/errors/request_error.proto"; +import "google/ads/googleads/v3/errors/resource_access_denied_error.proto"; +import "google/ads/googleads/v3/errors/resource_count_limit_exceeded_error.proto"; +import "google/ads/googleads/v3/errors/setting_error.proto"; +import "google/ads/googleads/v3/errors/shared_criterion_error.proto"; +import "google/ads/googleads/v3/errors/shared_set_error.proto"; +import "google/ads/googleads/v3/errors/size_limit_error.proto"; +import "google/ads/googleads/v3/errors/string_format_error.proto"; +import "google/ads/googleads/v3/errors/string_length_error.proto"; +import "google/ads/googleads/v3/errors/time_zone_error.proto"; +import "google/ads/googleads/v3/errors/url_field_error.proto"; +import "google/ads/googleads/v3/errors/user_data_error.proto"; +import "google/ads/googleads/v3/errors/user_list_error.proto"; +import "google/ads/googleads/v3/errors/youtube_video_registration_error.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "ErrorsProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing the common error protos + +// Describes how a GoogleAds API call failed. It's returned inside +// google.rpc.Status.details when a call fails. +message GoogleAdsFailure { + // The list of errors that occurred. + repeated GoogleAdsError errors = 1; +} + +// GoogleAds-specific error. +message GoogleAdsError { + // An enum value that indicates which error occurred. + ErrorCode error_code = 1; + + // A human-readable description of the error. + string message = 2; + + // The value that triggered the error. + google.ads.googleads.v3.common.Value trigger = 3; + + // Describes the part of the request proto that caused the error. + ErrorLocation location = 4; + + // Additional error details, which are returned by certain error codes. Most + // error codes do not include details. + ErrorDetails details = 5; +} + +// The error reason represented by type and enum. +message ErrorCode { + // The list of error enums + oneof error_code { + // An error caused by the request + RequestErrorEnum.RequestError request_error = 1; + + // An error with a Bidding Strategy mutate. + BiddingStrategyErrorEnum.BiddingStrategyError bidding_strategy_error = 2; + + // An error with a URL field mutate. + UrlFieldErrorEnum.UrlFieldError url_field_error = 3; + + // An error with a list operation. + ListOperationErrorEnum.ListOperationError list_operation_error = 4; + + // An error with an AWQL query + QueryErrorEnum.QueryError query_error = 5; + + // An error with a mutate + MutateErrorEnum.MutateError mutate_error = 7; + + // An error with a field mask + FieldMaskErrorEnum.FieldMaskError field_mask_error = 8; + + // An error encountered when trying to authorize a user. + AuthorizationErrorEnum.AuthorizationError authorization_error = 9; + + // An unexpected server-side error. + InternalErrorEnum.InternalError internal_error = 10; + + // An error with the amonut of quota remaining. + QuotaErrorEnum.QuotaError quota_error = 11; + + // An error with an Ad Group Ad mutate. + AdErrorEnum.AdError ad_error = 12; + + // An error with an Ad Group mutate. + AdGroupErrorEnum.AdGroupError ad_group_error = 13; + + // An error with a Campaign Budget mutate. + CampaignBudgetErrorEnum.CampaignBudgetError campaign_budget_error = 14; + + // An error with a Campaign mutate. + CampaignErrorEnum.CampaignError campaign_error = 15; + + // Indicates failure to properly authenticate user. + AuthenticationErrorEnum.AuthenticationError authentication_error = 17; + + // Indicates failure to properly authenticate user. + AdGroupCriterionErrorEnum.AdGroupCriterionError ad_group_criterion_error = 18; + + // The reasons for the ad customizer error + AdCustomizerErrorEnum.AdCustomizerError ad_customizer_error = 19; + + // The reasons for the ad group ad error + AdGroupAdErrorEnum.AdGroupAdError ad_group_ad_error = 21; + + // The reasons for the ad sharing error + AdSharingErrorEnum.AdSharingError ad_sharing_error = 24; + + // The reasons for the adx error + AdxErrorEnum.AdxError adx_error = 25; + + // The reasons for the asset error + AssetErrorEnum.AssetError asset_error = 107; + + // The reasons for the bidding errors + BiddingErrorEnum.BiddingError bidding_error = 26; + + // The reasons for the campaign criterion error + CampaignCriterionErrorEnum.CampaignCriterionError campaign_criterion_error = 29; + + // The reasons for the collection size error + CollectionSizeErrorEnum.CollectionSizeError collection_size_error = 31; + + // The reasons for the country code error + CountryCodeErrorEnum.CountryCodeError country_code_error = 109; + + // The reasons for the criterion error + CriterionErrorEnum.CriterionError criterion_error = 32; + + // The reasons for the customer error + CustomerErrorEnum.CustomerError customer_error = 90; + + // The reasons for the date error + DateErrorEnum.DateError date_error = 33; + + // The reasons for the date range error + DateRangeErrorEnum.DateRangeError date_range_error = 34; + + // The reasons for the distinct error + DistinctErrorEnum.DistinctError distinct_error = 35; + + // The reasons for the feed attribute reference error + FeedAttributeReferenceErrorEnum.FeedAttributeReferenceError feed_attribute_reference_error = 36; + + // The reasons for the function error + FunctionErrorEnum.FunctionError function_error = 37; + + // The reasons for the function parsing error + FunctionParsingErrorEnum.FunctionParsingError function_parsing_error = 38; + + // The reasons for the id error + IdErrorEnum.IdError id_error = 39; + + // The reasons for the image error + ImageErrorEnum.ImageError image_error = 40; + + // The reasons for the language code error + LanguageCodeErrorEnum.LanguageCodeError language_code_error = 110; + + // The reasons for the media bundle error + MediaBundleErrorEnum.MediaBundleError media_bundle_error = 42; + + // The reasons for media uploading errors. + MediaUploadErrorEnum.MediaUploadError media_upload_error = 116; + + // The reasons for the media file error + MediaFileErrorEnum.MediaFileError media_file_error = 86; + + // The reasons for the multiplier error + MultiplierErrorEnum.MultiplierError multiplier_error = 44; + + // The reasons for the new resource creation error + NewResourceCreationErrorEnum.NewResourceCreationError new_resource_creation_error = 45; + + // The reasons for the not empty error + NotEmptyErrorEnum.NotEmptyError not_empty_error = 46; + + // The reasons for the null error + NullErrorEnum.NullError null_error = 47; + + // The reasons for the operator error + OperatorErrorEnum.OperatorError operator_error = 48; + + // The reasons for the range error + RangeErrorEnum.RangeError range_error = 49; + + // The reasons for error in applying a recommendation + RecommendationErrorEnum.RecommendationError recommendation_error = 58; + + // The reasons for the region code error + RegionCodeErrorEnum.RegionCodeError region_code_error = 51; + + // The reasons for the setting error + SettingErrorEnum.SettingError setting_error = 52; + + // The reasons for the string format error + StringFormatErrorEnum.StringFormatError string_format_error = 53; + + // The reasons for the string length error + StringLengthErrorEnum.StringLengthError string_length_error = 54; + + // The reasons for the operation access denied error + OperationAccessDeniedErrorEnum.OperationAccessDeniedError operation_access_denied_error = 55; + + // The reasons for the resource access denied error + ResourceAccessDeniedErrorEnum.ResourceAccessDeniedError resource_access_denied_error = 56; + + // The reasons for the resource count limit exceeded error + ResourceCountLimitExceededErrorEnum.ResourceCountLimitExceededError resource_count_limit_exceeded_error = 57; + + // The reasons for YouTube video registration errors. + YoutubeVideoRegistrationErrorEnum.YoutubeVideoRegistrationError youtube_video_registration_error = 117; + + // The reasons for the ad group bid modifier error + AdGroupBidModifierErrorEnum.AdGroupBidModifierError ad_group_bid_modifier_error = 59; + + // The reasons for the context error + ContextErrorEnum.ContextError context_error = 60; + + // The reasons for the field error + FieldErrorEnum.FieldError field_error = 61; + + // The reasons for the shared set error + SharedSetErrorEnum.SharedSetError shared_set_error = 62; + + // The reasons for the shared criterion error + SharedCriterionErrorEnum.SharedCriterionError shared_criterion_error = 63; + + // The reasons for the campaign shared set error + CampaignSharedSetErrorEnum.CampaignSharedSetError campaign_shared_set_error = 64; + + // The reasons for the conversion action error + ConversionActionErrorEnum.ConversionActionError conversion_action_error = 65; + + // The reasons for the conversion adjustment upload error + ConversionAdjustmentUploadErrorEnum.ConversionAdjustmentUploadError conversion_adjustment_upload_error = 115; + + // The reasons for the conversion upload error + ConversionUploadErrorEnum.ConversionUploadError conversion_upload_error = 111; + + // The reasons for the header error. + HeaderErrorEnum.HeaderError header_error = 66; + + // The reasons for the database error. + DatabaseErrorEnum.DatabaseError database_error = 67; + + // The reasons for the policy finding error. + PolicyFindingErrorEnum.PolicyFindingError policy_finding_error = 68; + + // The reason for enum error. + EnumErrorEnum.EnumError enum_error = 70; + + // The reason for keyword plan error. + KeywordPlanErrorEnum.KeywordPlanError keyword_plan_error = 71; + + // The reason for keyword plan campaign error. + KeywordPlanCampaignErrorEnum.KeywordPlanCampaignError keyword_plan_campaign_error = 72; + + // The reason for keyword plan negative keyword error. + KeywordPlanNegativeKeywordErrorEnum.KeywordPlanNegativeKeywordError keyword_plan_negative_keyword_error = 73; + + // The reason for keyword plan ad group error. + KeywordPlanAdGroupErrorEnum.KeywordPlanAdGroupError keyword_plan_ad_group_error = 74; + + // The reason for keyword plan keyword error. + KeywordPlanKeywordErrorEnum.KeywordPlanKeywordError keyword_plan_keyword_error = 75; + + // The reason for keyword idea error. + KeywordPlanIdeaErrorEnum.KeywordPlanIdeaError keyword_plan_idea_error = 76; + + // The reasons for account budget proposal errors. + AccountBudgetProposalErrorEnum.AccountBudgetProposalError account_budget_proposal_error = 77; + + // The reasons for the user list error + UserListErrorEnum.UserListError user_list_error = 78; + + // The reasons for the change status error + ChangeStatusErrorEnum.ChangeStatusError change_status_error = 79; + + // The reasons for the feed error + FeedErrorEnum.FeedError feed_error = 80; + + // The reasons for the geo target constant suggestion error. + GeoTargetConstantSuggestionErrorEnum.GeoTargetConstantSuggestionError geo_target_constant_suggestion_error = 81; + + // The reasons for the campaign draft error + CampaignDraftErrorEnum.CampaignDraftError campaign_draft_error = 82; + + // The reasons for the feed item error + FeedItemErrorEnum.FeedItemError feed_item_error = 83; + + // The reason for the label error. + LabelErrorEnum.LabelError label_error = 84; + + // The reasons for the billing setup error + BillingSetupErrorEnum.BillingSetupError billing_setup_error = 87; + + // The reasons for the customer client link error + CustomerClientLinkErrorEnum.CustomerClientLinkError customer_client_link_error = 88; + + // The reasons for the customer manager link error + CustomerManagerLinkErrorEnum.CustomerManagerLinkError customer_manager_link_error = 91; + + // The reasons for the feed mapping error + FeedMappingErrorEnum.FeedMappingError feed_mapping_error = 92; + + // The reasons for the customer feed error + CustomerFeedErrorEnum.CustomerFeedError customer_feed_error = 93; + + // The reasons for the ad group feed error + AdGroupFeedErrorEnum.AdGroupFeedError ad_group_feed_error = 94; + + // The reasons for the campaign feed error + CampaignFeedErrorEnum.CampaignFeedError campaign_feed_error = 96; + + // The reasons for the custom interest error + CustomInterestErrorEnum.CustomInterestError custom_interest_error = 97; + + // The reasons for the campaign experiment error + CampaignExperimentErrorEnum.CampaignExperimentError campaign_experiment_error = 98; + + // The reasons for the extension feed item error + ExtensionFeedItemErrorEnum.ExtensionFeedItemError extension_feed_item_error = 100; + + // The reasons for the ad parameter error + AdParameterErrorEnum.AdParameterError ad_parameter_error = 101; + + // The reasons for the feed item validation error + FeedItemValidationErrorEnum.FeedItemValidationError feed_item_validation_error = 102; + + // The reasons for the extension setting error + ExtensionSettingErrorEnum.ExtensionSettingError extension_setting_error = 103; + + // The reasons for the feed item target error + FeedItemTargetErrorEnum.FeedItemTargetError feed_item_target_error = 104; + + // The reasons for the policy violation error + PolicyViolationErrorEnum.PolicyViolationError policy_violation_error = 105; + + // The reasons for the mutate job error + MutateJobErrorEnum.MutateJobError mutate_job_error = 108; + + // The reasons for the mutate job error + PartialFailureErrorEnum.PartialFailureError partial_failure_error = 112; + + // The reasons for the policy validation parameter error + PolicyValidationParameterErrorEnum.PolicyValidationParameterError policy_validation_parameter_error = 114; + + // The reasons for the size limit error + SizeLimitErrorEnum.SizeLimitError size_limit_error = 118; + + // The reasons for the offline user data job error. + OfflineUserDataJobErrorEnum.OfflineUserDataJobError offline_user_data_job_error = 119; + + // The reasons for the not whitelisted error + NotWhitelistedErrorEnum.NotWhitelistedError not_whitelisted_error = 120; + + // The reasons for the manager link error + ManagerLinkErrorEnum.ManagerLinkError manager_link_error = 121; + + // The reasons for the currency code error + CurrencyCodeErrorEnum.CurrencyCodeError currency_code_error = 122; + + // The reasons for the access invitation error + AccessInvitationErrorEnum.AccessInvitationError access_invitation_error = 124; + + // The reasons for the reach plan error + ReachPlanErrorEnum.ReachPlanError reach_plan_error = 125; + + // The reasons for the invoice error + InvoiceErrorEnum.InvoiceError invoice_error = 126; + + // The reasons for errors in payments accounts service + PaymentsAccountErrorEnum.PaymentsAccountError payments_account_error = 127; + + // The reasons for the time zone error + TimeZoneErrorEnum.TimeZoneError time_zone_error = 128; + + // The reasons for the asset link error + AssetLinkErrorEnum.AssetLinkError asset_link_error = 129; + + // The reasons for the user data error. + UserDataErrorEnum.UserDataError user_data_error = 130; + } +} + +// Describes the part of the request proto that caused the error. +message ErrorLocation { + // A part of a field path. + message FieldPathElement { + // The name of a field or a oneof + string field_name = 1; + + // If field_name is a repeated field, this is the element that failed + google.protobuf.Int64Value index = 2; + } + + // A field path that indicates which field was invalid in the request. + repeated FieldPathElement field_path_elements = 2; +} + +// Additional error details. +message ErrorDetails { + // The error code that should have been returned, but wasn't. This is used + // when the error code is InternalError.ERROR_CODE_NOT_PUBLISHED. + string unpublished_error_code = 1; + + // Describes an ad policy violation. + PolicyViolationDetails policy_violation_details = 2; + + // Describes policy violation findings. + PolicyFindingDetails policy_finding_details = 3; +} + +// Error returned as part of a mutate response. +// This error indicates single policy violation by some text +// in one of the fields. +message PolicyViolationDetails { + // Human readable description of policy violation. + string external_policy_description = 2; + + // Unique identifier for this violation. + // If policy is exemptible, this key may be used to request exemption. + google.ads.googleads.v3.common.PolicyViolationKey key = 4; + + // Human readable name of the policy. + string external_policy_name = 5; + + // Whether user can file an exemption request for this violation. + bool is_exemptible = 6; +} + +// Error returned as part of a mutate response. +// This error indicates one or more policy findings in the fields of a +// resource. +message PolicyFindingDetails { + // The list of policy topics for the resource. Contains the PROHIBITED or + // FULLY_LIMITED policy topic entries that prevented the resource from being + // saved (among any other entries the resource may also have). + repeated google.ads.googleads.v3.common.PolicyTopicEntry policy_topic_entries = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/extension_feed_item_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/extension_feed_item_error.proto new file mode 100644 index 000000000..c64a9437e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/extension_feed_item_error.proto @@ -0,0 +1,194 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "ExtensionFeedItemErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing extension feed item errors. + +// Container for enum describing possible extension feed item error. +message ExtensionFeedItemErrorEnum { + // Enum describing possible extension feed item errors. + enum ExtensionFeedItemError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Value is not within the accepted range. + VALUE_OUT_OF_RANGE = 2; + + // Url list is too long. + URL_LIST_TOO_LONG = 3; + + // Cannot have a geo targeting restriction without having geo targeting. + CANNOT_HAVE_RESTRICTION_ON_EMPTY_GEO_TARGETING = 4; + + // Cannot simultaneously set sitelink field with final urls. + CANNOT_SET_WITH_FINAL_URLS = 5; + + // Must set field with final urls. + CANNOT_SET_WITHOUT_FINAL_URLS = 6; + + // Phone number for a call extension is invalid. + INVALID_PHONE_NUMBER = 7; + + // Phone number for a call extension is not supported for the given country + // code. + PHONE_NUMBER_NOT_SUPPORTED_FOR_COUNTRY = 8; + + // A carrier specific number in short format is not allowed for call + // extensions. + CARRIER_SPECIFIC_SHORT_NUMBER_NOT_ALLOWED = 9; + + // Premium rate numbers are not allowed for call extensions. + PREMIUM_RATE_NUMBER_NOT_ALLOWED = 10; + + // Phone number type for a call extension is not allowed. + // For example, personal number is not allowed for a call extension in + // most regions. + DISALLOWED_NUMBER_TYPE = 11; + + // Phone number for a call extension does not meet domestic format + // requirements. + INVALID_DOMESTIC_PHONE_NUMBER_FORMAT = 12; + + // Vanity phone numbers (i.e. those including letters) are not allowed for + // call extensions. + VANITY_PHONE_NUMBER_NOT_ALLOWED = 13; + + // Call conversion action provided for a call extension is invalid. + INVALID_CALL_CONVERSION_ACTION = 14; + + // For a call extension, the customer is not whitelisted for call tracking. + CUSTOMER_NOT_WHITELISTED_FOR_CALLTRACKING = 15; + + // Call tracking is not supported for the given country for a call + // extension. + CALLTRACKING_NOT_SUPPORTED_FOR_COUNTRY = 16; + + // Customer hasn't consented for call recording, which is required for + // creating/updating call feed items. Please see + // https://support.google.com/google-ads/answer/7412639. + CUSTOMER_CONSENT_FOR_CALL_RECORDING_REQUIRED = 17; + + // App id provided for an app extension is invalid. + INVALID_APP_ID = 18; + + // Quotation marks present in the review text for a review extension. + QUOTES_IN_REVIEW_EXTENSION_SNIPPET = 19; + + // Hyphen character present in the review text for a review extension. + HYPHENS_IN_REVIEW_EXTENSION_SNIPPET = 20; + + // A blacklisted review source name or url was provided for a review + // extension. + REVIEW_EXTENSION_SOURCE_INELIGIBLE = 21; + + // Review source name should not be found in the review text. + SOURCE_NAME_IN_REVIEW_EXTENSION_TEXT = 22; + + // Inconsistent currency codes. + INCONSISTENT_CURRENCY_CODES = 23; + + // Price extension cannot have duplicated headers. + PRICE_EXTENSION_HAS_DUPLICATED_HEADERS = 24; + + // Price item cannot have duplicated header and description. + PRICE_ITEM_HAS_DUPLICATED_HEADER_AND_DESCRIPTION = 25; + + // Price extension has too few items. + PRICE_EXTENSION_HAS_TOO_FEW_ITEMS = 26; + + // Price extension has too many items. + PRICE_EXTENSION_HAS_TOO_MANY_ITEMS = 27; + + // The input value is not currently supported. + UNSUPPORTED_VALUE = 28; + + // The input value is not currently supported in the selected language of an + // extension. + UNSUPPORTED_VALUE_IN_SELECTED_LANGUAGE = 29; + + // Unknown or unsupported device preference. + INVALID_DEVICE_PREFERENCE = 30; + + // Invalid feed item schedule end time (i.e., endHour = 24 and endMinute != + // 0). + INVALID_SCHEDULE_END = 31; + + // Date time zone does not match the account's time zone. + DATE_TIME_MUST_BE_IN_ACCOUNT_TIME_ZONE = 32; + + // Invalid structured snippet header. + INVALID_SNIPPETS_HEADER = 33; + + // Cannot operate on removed feed item. + CANNOT_OPERATE_ON_REMOVED_FEED_ITEM = 34; + + // Phone number not supported when call tracking enabled for country. + PHONE_NUMBER_NOT_SUPPORTED_WITH_CALLTRACKING_FOR_COUNTRY = 35; + + // Cannot set call_conversion_action while call_conversion_tracking_enabled + // is set to true. + CONFLICTING_CALL_CONVERSION_SETTINGS = 36; + + // The type of the input extension feed item doesn't match the existing + // extension feed item. + EXTENSION_TYPE_MISMATCH = 37; + + // The oneof field extension i.e. subtype of extension feed item is + // required. + EXTENSION_SUBTYPE_REQUIRED = 38; + + // The referenced feed item is not mapped to a supported extension type. + EXTENSION_TYPE_UNSUPPORTED = 39; + + // Cannot operate on a Feed with more than one active FeedMapping. + CANNOT_OPERATE_ON_FEED_WITH_MULTIPLE_MAPPINGS = 40; + + // Cannot operate on a Feed that has key attributes. + CANNOT_OPERATE_ON_FEED_WITH_KEY_ATTRIBUTES = 41; + + // Input price is not in a valid format. + INVALID_PRICE_FORMAT = 42; + + // The promotion time is invalid. + PROMOTION_INVALID_TIME = 43; + + // This field has too many decimal places specified. + TOO_MANY_DECIMAL_PLACES_SPECIFIED = 44; + + // Concrete sub type of ExtensionFeedItem is required for this operation. + CONCRETE_EXTENSION_TYPE_REQUIRED = 45; + + // Feed item schedule end time must be after start time. + SCHEDULE_END_NOT_AFTER_START = 46; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/extension_setting_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/extension_setting_error.proto new file mode 100644 index 000000000..eefe3bcf5 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/extension_setting_error.proto @@ -0,0 +1,257 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "ExtensionSettingErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing extension setting validation errors. + +// Container for enum describing validation errors of extension settings. +message ExtensionSettingErrorEnum { + // Enum describing possible extension setting errors. + enum ExtensionSettingError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // A platform restriction was provided without input extensions or existing + // extensions. + EXTENSIONS_REQUIRED = 2; + + // The provided feed type does not correspond to the provided extensions. + FEED_TYPE_EXTENSION_TYPE_MISMATCH = 3; + + // The provided feed type cannot be used. + INVALID_FEED_TYPE = 4; + + // The provided feed type cannot be used at the customer level. + INVALID_FEED_TYPE_FOR_CUSTOMER_EXTENSION_SETTING = 5; + + // Cannot change a feed item field on a CREATE operation. + CANNOT_CHANGE_FEED_ITEM_ON_CREATE = 6; + + // Cannot update an extension that is not already in this setting. + CANNOT_UPDATE_NEWLY_CREATED_EXTENSION = 7; + + // There is no existing AdGroupExtensionSetting for this type. + NO_EXISTING_AD_GROUP_EXTENSION_SETTING_FOR_TYPE = 8; + + // There is no existing CampaignExtensionSetting for this type. + NO_EXISTING_CAMPAIGN_EXTENSION_SETTING_FOR_TYPE = 9; + + // There is no existing CustomerExtensionSetting for this type. + NO_EXISTING_CUSTOMER_EXTENSION_SETTING_FOR_TYPE = 10; + + // The AdGroupExtensionSetting already exists. UPDATE should be used to + // modify the existing AdGroupExtensionSetting. + AD_GROUP_EXTENSION_SETTING_ALREADY_EXISTS = 11; + + // The CampaignExtensionSetting already exists. UPDATE should be used to + // modify the existing CampaignExtensionSetting. + CAMPAIGN_EXTENSION_SETTING_ALREADY_EXISTS = 12; + + // The CustomerExtensionSetting already exists. UPDATE should be used to + // modify the existing CustomerExtensionSetting. + CUSTOMER_EXTENSION_SETTING_ALREADY_EXISTS = 13; + + // An active ad group feed already exists for this place holder type. + AD_GROUP_FEED_ALREADY_EXISTS_FOR_PLACEHOLDER_TYPE = 14; + + // An active campaign feed already exists for this place holder type. + CAMPAIGN_FEED_ALREADY_EXISTS_FOR_PLACEHOLDER_TYPE = 15; + + // An active customer feed already exists for this place holder type. + CUSTOMER_FEED_ALREADY_EXISTS_FOR_PLACEHOLDER_TYPE = 16; + + // Value is not within the accepted range. + VALUE_OUT_OF_RANGE = 17; + + // Cannot simultaneously set specified field with final urls. + CANNOT_SET_FIELD_WITH_FINAL_URLS = 18; + + // Must set field with final urls. + FINAL_URLS_NOT_SET = 19; + + // Phone number for a call extension is invalid. + INVALID_PHONE_NUMBER = 20; + + // Phone number for a call extension is not supported for the given country + // code. + PHONE_NUMBER_NOT_SUPPORTED_FOR_COUNTRY = 21; + + // A carrier specific number in short format is not allowed for call + // extensions. + CARRIER_SPECIFIC_SHORT_NUMBER_NOT_ALLOWED = 22; + + // Premium rate numbers are not allowed for call extensions. + PREMIUM_RATE_NUMBER_NOT_ALLOWED = 23; + + // Phone number type for a call extension is not allowed. + DISALLOWED_NUMBER_TYPE = 24; + + // Phone number for a call extension does not meet domestic format + // requirements. + INVALID_DOMESTIC_PHONE_NUMBER_FORMAT = 25; + + // Vanity phone numbers (i.e. those including letters) are not allowed for + // call extensions. + VANITY_PHONE_NUMBER_NOT_ALLOWED = 26; + + // Country code provided for a call extension is invalid. + INVALID_COUNTRY_CODE = 27; + + // Call conversion type id provided for a call extension is invalid. + INVALID_CALL_CONVERSION_TYPE_ID = 28; + + // For a call extension, the customer is not whitelisted for call tracking. + CUSTOMER_NOT_WHITELISTED_FOR_CALLTRACKING = 29; + + // Call tracking is not supported for the given country for a call + // extension. + CALLTRACKING_NOT_SUPPORTED_FOR_COUNTRY = 30; + + // App id provided for an app extension is invalid. + INVALID_APP_ID = 31; + + // Quotation marks present in the review text for a review extension. + QUOTES_IN_REVIEW_EXTENSION_SNIPPET = 32; + + // Hyphen character present in the review text for a review extension. + HYPHENS_IN_REVIEW_EXTENSION_SNIPPET = 33; + + // A blacklisted review source name or url was provided for a review + // extension. + REVIEW_EXTENSION_SOURCE_NOT_ELIGIBLE = 34; + + // Review source name should not be found in the review text. + SOURCE_NAME_IN_REVIEW_EXTENSION_TEXT = 35; + + // Field must be set. + MISSING_FIELD = 36; + + // Inconsistent currency codes. + INCONSISTENT_CURRENCY_CODES = 37; + + // Price extension cannot have duplicated headers. + PRICE_EXTENSION_HAS_DUPLICATED_HEADERS = 38; + + // Price item cannot have duplicated header and description. + PRICE_ITEM_HAS_DUPLICATED_HEADER_AND_DESCRIPTION = 39; + + // Price extension has too few items + PRICE_EXTENSION_HAS_TOO_FEW_ITEMS = 40; + + // Price extension has too many items + PRICE_EXTENSION_HAS_TOO_MANY_ITEMS = 41; + + // The input value is not currently supported. + UNSUPPORTED_VALUE = 42; + + // Unknown or unsupported device preference. + INVALID_DEVICE_PREFERENCE = 43; + + // Invalid feed item schedule end time (i.e., endHour = 24 and + // endMinute != 0). + INVALID_SCHEDULE_END = 45; + + // Date time zone does not match the account's time zone. + DATE_TIME_MUST_BE_IN_ACCOUNT_TIME_ZONE = 47; + + // Overlapping feed item schedule times (e.g., 7-10AM and 8-11AM) are not + // allowed. + OVERLAPPING_SCHEDULES_NOT_ALLOWED = 48; + + // Feed item schedule end time must be after start time. + SCHEDULE_END_NOT_AFTER_START = 49; + + // There are too many feed item schedules per day. + TOO_MANY_SCHEDULES_PER_DAY = 50; + + // Cannot edit the same extension feed item more than once in the same + // request. + DUPLICATE_EXTENSION_FEED_ITEM_EDIT = 51; + + // Invalid structured snippet header. + INVALID_SNIPPETS_HEADER = 52; + + // Phone number with call tracking enabled is not supported for the + // specified country. + PHONE_NUMBER_NOT_SUPPORTED_WITH_CALLTRACKING_FOR_COUNTRY = 53; + + // The targeted adgroup must belong to the targeted campaign. + CAMPAIGN_TARGETING_MISMATCH = 54; + + // The feed used by the ExtensionSetting is removed and cannot be operated + // on. Remove the ExtensionSetting to allow a new one to be created using + // an active feed. + CANNOT_OPERATE_ON_REMOVED_FEED = 55; + + // The ExtensionFeedItem type is required for this operation. + EXTENSION_TYPE_REQUIRED = 56; + + // The matching function that links the extension feed to the customer, + // campaign, or ad group is not compatible with the ExtensionSetting + // services. + INCOMPATIBLE_UNDERLYING_MATCHING_FUNCTION = 57; + + // Start date must be before end date. + START_DATE_AFTER_END_DATE = 58; + + // Input price is not in a valid format. + INVALID_PRICE_FORMAT = 59; + + // The promotion time is invalid. + PROMOTION_INVALID_TIME = 60; + + // Cannot set both percent discount and money discount fields. + PROMOTION_CANNOT_SET_PERCENT_DISCOUNT_AND_MONEY_DISCOUNT = 61; + + // Cannot set both promotion code and orders over amount fields. + PROMOTION_CANNOT_SET_PROMOTION_CODE_AND_ORDERS_OVER_AMOUNT = 62; + + // This field has too many decimal places specified. + TOO_MANY_DECIMAL_PLACES_SPECIFIED = 63; + + // The language code is not valid. + INVALID_LANGUAGE_CODE = 64; + + // The language is not supported. + UNSUPPORTED_LANGUAGE = 65; + + // Customer hasn't consented for call recording, which is required for + // adding/updating call extensions. Please see + // https://support.google.com/google-ads/answer/7412639. + CUSTOMER_CONSENT_FOR_CALL_RECORDING_REQUIRED = 66; + + // The UPDATE operation does not specify any fields other than the resource + // name in the update mask. + EXTENSION_SETTING_UPDATE_IS_A_NOOP = 67; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/feed_attribute_reference_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/feed_attribute_reference_error.proto new file mode 100644 index 000000000..84d32435f --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/feed_attribute_reference_error.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "FeedAttributeReferenceErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing feed attribute reference errors. + +// Container for enum describing possible feed attribute reference errors. +message FeedAttributeReferenceErrorEnum { + // Enum describing possible feed attribute reference errors. + enum FeedAttributeReferenceError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // A feed referenced by ID has been removed. + CANNOT_REFERENCE_REMOVED_FEED = 2; + + // There is no enabled feed with the given name. + INVALID_FEED_NAME = 3; + + // There is no feed attribute in an enabled feed with the given name. + INVALID_FEED_ATTRIBUTE_NAME = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/feed_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/feed_error.proto new file mode 100644 index 000000000..0aa6ab86a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/feed_error.proto @@ -0,0 +1,111 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "FeedErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing feed errors. + +// Container for enum describing possible feed errors. +message FeedErrorEnum { + // Enum describing possible feed errors. + enum FeedError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The names of the FeedAttributes must be unique. + ATTRIBUTE_NAMES_NOT_UNIQUE = 2; + + // The attribute list must be an exact copy of the existing list if the + // attribute ID's are present. + ATTRIBUTES_DO_NOT_MATCH_EXISTING_ATTRIBUTES = 3; + + // Cannot specify USER origin for a system generated feed. + CANNOT_SPECIFY_USER_ORIGIN_FOR_SYSTEM_FEED = 4; + + // Cannot specify GOOGLE origin for a non-system generated feed. + CANNOT_SPECIFY_GOOGLE_ORIGIN_FOR_NON_SYSTEM_FEED = 5; + + // Cannot specify feed attributes for system feed. + CANNOT_SPECIFY_FEED_ATTRIBUTES_FOR_SYSTEM_FEED = 6; + + // Cannot update FeedAttributes on feed with origin GOOGLE. + CANNOT_UPDATE_FEED_ATTRIBUTES_WITH_ORIGIN_GOOGLE = 7; + + // The given ID refers to a removed Feed. Removed Feeds are immutable. + FEED_REMOVED = 8; + + // The origin of the feed is not valid for the client. + INVALID_ORIGIN_VALUE = 9; + + // A user can only create and modify feeds with USER origin. + FEED_ORIGIN_IS_NOT_USER = 10; + + // Invalid auth token for the given email. + INVALID_AUTH_TOKEN_FOR_EMAIL = 11; + + // Invalid email specified. + INVALID_EMAIL = 12; + + // Feed name matches that of another active Feed. + DUPLICATE_FEED_NAME = 13; + + // Name of feed is not allowed. + INVALID_FEED_NAME = 14; + + // Missing OAuthInfo. + MISSING_OAUTH_INFO = 15; + + // New FeedAttributes must not affect the unique key. + NEW_ATTRIBUTE_CANNOT_BE_PART_OF_UNIQUE_KEY = 16; + + // Too many FeedAttributes for a Feed. + TOO_MANY_ATTRIBUTES = 17; + + // The business account is not valid. + INVALID_BUSINESS_ACCOUNT = 18; + + // Business account cannot access Google My Business account. + BUSINESS_ACCOUNT_CANNOT_ACCESS_LOCATION_ACCOUNT = 19; + + // Invalid chain ID provided for affiliate location feed. + INVALID_AFFILIATE_CHAIN_ID = 20; + + // There is already a feed with the given system feed generation data. + DUPLICATE_SYSTEM_FEED = 21; + + // An error occurred accessing GMB account. + GMB_ACCESS_ERROR = 22; + + // A customer cannot have both LOCATION and AFFILIATE_LOCATION feeds. + CANNOT_HAVE_LOCATION_AND_AFFILIATE_LOCATION_FEEDS = 23; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/feed_item_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/feed_item_error.proto new file mode 100644 index 000000000..465c3ce32 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/feed_item_error.proto @@ -0,0 +1,71 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "FeedItemErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing feed item errors. + +// Container for enum describing possible feed item errors. +message FeedItemErrorEnum { + // Enum describing possible feed item errors. + enum FeedItemError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Cannot convert the feed attribute value from string to its real type. + CANNOT_CONVERT_ATTRIBUTE_VALUE_FROM_STRING = 2; + + // Cannot operate on removed feed item. + CANNOT_OPERATE_ON_REMOVED_FEED_ITEM = 3; + + // Date time zone does not match the account's time zone. + DATE_TIME_MUST_BE_IN_ACCOUNT_TIME_ZONE = 4; + + // Feed item with the key attributes could not be found. + KEY_ATTRIBUTES_NOT_FOUND = 5; + + // Url feed attribute value is not valid. + INVALID_URL = 6; + + // Some key attributes are missing. + MISSING_KEY_ATTRIBUTES = 7; + + // Feed item has same key attributes as another feed item. + KEY_ATTRIBUTES_NOT_UNIQUE = 8; + + // Cannot modify key attributes on an existing feed item. + CANNOT_MODIFY_KEY_ATTRIBUTE_VALUE = 9; + + // The feed attribute value is too large. + SIZE_TOO_LARGE_FOR_MULTI_VALUE_ATTRIBUTE = 10; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/feed_item_target_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/feed_item_target_error.proto new file mode 100644 index 000000000..7f1d897af --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/feed_item_target_error.proto @@ -0,0 +1,70 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "FeedItemTargetErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing feed item target errors. + +// Container for enum describing possible feed item target errors. +message FeedItemTargetErrorEnum { + // Enum describing possible feed item target errors. + enum FeedItemTargetError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // On CREATE, the FeedItemTarget must have a populated field in the oneof + // target. + MUST_SET_TARGET_ONEOF_ON_CREATE = 2; + + // The specified feed item target already exists, so it cannot be added. + FEED_ITEM_TARGET_ALREADY_EXISTS = 3; + + // The schedules for a given feed item cannot overlap. + FEED_ITEM_SCHEDULES_CANNOT_OVERLAP = 4; + + // Too many targets of a given type were added for a single feed item. + TARGET_LIMIT_EXCEEDED_FOR_GIVEN_TYPE = 5; + + // Too many AdSchedules are enabled for the feed item for the given day. + TOO_MANY_SCHEDULES_PER_DAY = 6; + + // A feed item may either have an enabled campaign target or an enabled ad + // group target. + CANNOT_HAVE_ENABLED_CAMPAIGN_AND_ENABLED_AD_GROUP_TARGETS = 7; + + // Duplicate ad schedules aren't allowed. + DUPLICATE_AD_SCHEDULE = 8; + + // Duplicate keywords aren't allowed. + DUPLICATE_KEYWORD = 9; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/feed_item_validation_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/feed_item_validation_error.proto new file mode 100644 index 000000000..334f41cff --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/feed_item_validation_error.proto @@ -0,0 +1,353 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "FeedItemValidationErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing feed item validation errors. + +// Container for enum describing possible validation errors of a feed item. +message FeedItemValidationErrorEnum { + // The possible validation errors of a feed item. + enum FeedItemValidationError { + // No value has been specified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // String is too short. + STRING_TOO_SHORT = 2; + + // String is too long. + STRING_TOO_LONG = 3; + + // Value is not provided. + VALUE_NOT_SPECIFIED = 4; + + // Phone number format is invalid for region. + INVALID_DOMESTIC_PHONE_NUMBER_FORMAT = 5; + + // String does not represent a phone number. + INVALID_PHONE_NUMBER = 6; + + // Phone number format is not compatible with country code. + PHONE_NUMBER_NOT_SUPPORTED_FOR_COUNTRY = 7; + + // Premium rate number is not allowed. + PREMIUM_RATE_NUMBER_NOT_ALLOWED = 8; + + // Phone number type is not allowed. + DISALLOWED_NUMBER_TYPE = 9; + + // Specified value is outside of the valid range. + VALUE_OUT_OF_RANGE = 10; + + // Call tracking is not supported in the selected country. + CALLTRACKING_NOT_SUPPORTED_FOR_COUNTRY = 11; + + // Customer is not whitelisted for call tracking. + CUSTOMER_NOT_WHITELISTED_FOR_CALLTRACKING = 12; + + // Country code is invalid. + INVALID_COUNTRY_CODE = 13; + + // The specified mobile app id is invalid. + INVALID_APP_ID = 14; + + // Some required field attributes are missing. + MISSING_ATTRIBUTES_FOR_FIELDS = 15; + + // Invalid email button type for email extension. + INVALID_TYPE_ID = 16; + + // Email address is invalid. + INVALID_EMAIL_ADDRESS = 17; + + // The HTTPS URL in email extension is invalid. + INVALID_HTTPS_URL = 18; + + // Delivery address is missing from email extension. + MISSING_DELIVERY_ADDRESS = 19; + + // FeedItem scheduling start date comes after end date. + START_DATE_AFTER_END_DATE = 20; + + // FeedItem scheduling start time is missing. + MISSING_FEED_ITEM_START_TIME = 21; + + // FeedItem scheduling end time is missing. + MISSING_FEED_ITEM_END_TIME = 22; + + // Cannot compute system attributes on a FeedItem that has no FeedItemId. + MISSING_FEED_ITEM_ID = 23; + + // Call extension vanity phone numbers are not supported. + VANITY_PHONE_NUMBER_NOT_ALLOWED = 24; + + // Invalid review text. + INVALID_REVIEW_EXTENSION_SNIPPET = 25; + + // Invalid format for numeric value in ad parameter. + INVALID_NUMBER_FORMAT = 26; + + // Invalid format for date value in ad parameter. + INVALID_DATE_FORMAT = 27; + + // Invalid format for price value in ad parameter. + INVALID_PRICE_FORMAT = 28; + + // Unrecognized type given for value in ad parameter. + UNKNOWN_PLACEHOLDER_FIELD = 29; + + // Enhanced sitelinks must have both description lines specified. + MISSING_ENHANCED_SITELINK_DESCRIPTION_LINE = 30; + + // Review source is ineligible. + REVIEW_EXTENSION_SOURCE_INELIGIBLE = 31; + + // Review text cannot contain hyphens or dashes. + HYPHENS_IN_REVIEW_EXTENSION_SNIPPET = 32; + + // Review text cannot contain double quote characters. + DOUBLE_QUOTES_IN_REVIEW_EXTENSION_SNIPPET = 33; + + // Review text cannot contain quote characters. + QUOTES_IN_REVIEW_EXTENSION_SNIPPET = 34; + + // Parameters are encoded in the wrong format. + INVALID_FORM_ENCODED_PARAMS = 35; + + // URL parameter name must contain only letters, numbers, underscores, and + // dashes. + INVALID_URL_PARAMETER_NAME = 36; + + // Cannot find address location. + NO_GEOCODING_RESULT = 37; + + // Review extension text has source name. + SOURCE_NAME_IN_REVIEW_EXTENSION_TEXT = 38; + + // Some phone numbers can be shorter than usual. Some of these short numbers + // are carrier-specific, and we disallow those in ad extensions because they + // will not be available to all users. + CARRIER_SPECIFIC_SHORT_NUMBER_NOT_ALLOWED = 39; + + // Triggered when a request references a placeholder field id that does not + // exist. + INVALID_PLACEHOLDER_FIELD_ID = 40; + + // URL contains invalid ValueTrack tags or format. + INVALID_URL_TAG = 41; + + // Provided list exceeds acceptable size. + LIST_TOO_LONG = 42; + + // Certain combinations of attributes aren't allowed to be specified in the + // same feed item. + INVALID_ATTRIBUTES_COMBINATION = 43; + + // An attribute has the same value repeatedly. + DUPLICATE_VALUES = 44; + + // Advertisers can link a conversion action with a phone number to indicate + // that sufficiently long calls forwarded to that phone number should be + // counted as conversions of the specified type. This is an error message + // indicating that the conversion action specified is invalid (e.g., the + // conversion action does not exist within the appropriate Google Ads + // account, or it is a type of conversion not appropriate to phone call + // conversions). + INVALID_CALL_CONVERSION_ACTION_ID = 45; + + // Tracking template requires final url to be set. + CANNOT_SET_WITHOUT_FINAL_URLS = 46; + + // An app id was provided that doesn't exist in the given app store. + APP_ID_DOESNT_EXIST_IN_APP_STORE = 47; + + // Invalid U2 final url. + INVALID_FINAL_URL = 48; + + // Invalid U2 tracking url. + INVALID_TRACKING_URL = 49; + + // Final URL should start from App download URL. + INVALID_FINAL_URL_FOR_APP_DOWNLOAD_URL = 50; + + // List provided is too short. + LIST_TOO_SHORT = 51; + + // User Action field has invalid value. + INVALID_USER_ACTION = 52; + + // Type field has invalid value. + INVALID_TYPE_NAME = 53; + + // Change status for event is invalid. + INVALID_EVENT_CHANGE_STATUS = 54; + + // The header of a structured snippets extension is not one of the valid + // headers. + INVALID_SNIPPETS_HEADER = 55; + + // Android app link is not formatted correctly + INVALID_ANDROID_APP_LINK = 56; + + // Phone number incompatible with call tracking for country. + NUMBER_TYPE_WITH_CALLTRACKING_NOT_SUPPORTED_FOR_COUNTRY = 57; + + // The input is identical to a reserved keyword + RESERVED_KEYWORD_OTHER = 58; + + // Each option label in the message extension must be unique. + DUPLICATE_OPTION_LABELS = 59; + + // Each option prefill in the message extension must be unique. + DUPLICATE_OPTION_PREFILLS = 60; + + // In message extensions, the number of optional labels and optional + // prefills must be the same. + UNEQUAL_LIST_LENGTHS = 61; + + // All currency codes in an ad extension must be the same. + INCONSISTENT_CURRENCY_CODES = 62; + + // Headers in price extension are not unique. + PRICE_EXTENSION_HAS_DUPLICATED_HEADERS = 63; + + // Header and description in an item are the same. + ITEM_HAS_DUPLICATED_HEADER_AND_DESCRIPTION = 64; + + // Price extension has too few items. + PRICE_EXTENSION_HAS_TOO_FEW_ITEMS = 65; + + // The given value is not supported. + UNSUPPORTED_VALUE = 66; + + // Invalid final mobile url. + INVALID_FINAL_MOBILE_URL = 67; + + // The given string value of Label contains invalid characters + INVALID_KEYWORDLESS_AD_RULE_LABEL = 68; + + // The given URL contains value track parameters. + VALUE_TRACK_PARAMETER_NOT_SUPPORTED = 69; + + // The given value is not supported in the selected language of an + // extension. + UNSUPPORTED_VALUE_IN_SELECTED_LANGUAGE = 70; + + // The iOS app link is not formatted correctly. + INVALID_IOS_APP_LINK = 71; + + // iOS app link or iOS app store id is missing. + MISSING_IOS_APP_LINK_OR_IOS_APP_STORE_ID = 72; + + // Promotion time is invalid. + PROMOTION_INVALID_TIME = 73; + + // Both the percent off and money amount off fields are set. + PROMOTION_CANNOT_SET_PERCENT_OFF_AND_MONEY_AMOUNT_OFF = 74; + + // Both the promotion code and orders over amount fields are set. + PROMOTION_CANNOT_SET_PROMOTION_CODE_AND_ORDERS_OVER_AMOUNT = 75; + + // Too many decimal places are specified. + TOO_MANY_DECIMAL_PLACES_SPECIFIED = 76; + + // Ad Customizers are present and not allowed. + AD_CUSTOMIZERS_NOT_ALLOWED = 77; + + // Language code is not valid. + INVALID_LANGUAGE_CODE = 78; + + // Language is not supported. + UNSUPPORTED_LANGUAGE = 79; + + // IF Function is present and not allowed. + IF_FUNCTION_NOT_ALLOWED = 80; + + // Final url suffix is not valid. + INVALID_FINAL_URL_SUFFIX = 81; + + // Final url suffix contains an invalid tag. + INVALID_TAG_IN_FINAL_URL_SUFFIX = 82; + + // Final url suffix is formatted incorrectly. + INVALID_FINAL_URL_SUFFIX_FORMAT = 83; + + // Consent for call recording, which is required for the use of call + // extensions, was not provided by the advertiser. Please see + // https://support.google.com/google-ads/answer/7412639. + CUSTOMER_CONSENT_FOR_CALL_RECORDING_REQUIRED = 84; + + // Multiple message delivery options are set. + ONLY_ONE_DELIVERY_OPTION_IS_ALLOWED = 85; + + // No message delivery option is set. + NO_DELIVERY_OPTION_IS_SET = 86; + + // String value of conversion reporting state field is not valid. + INVALID_CONVERSION_REPORTING_STATE = 87; + + // Image size is not right. + IMAGE_SIZE_WRONG = 88; + + // Email delivery is not supported in the country specified in the country + // code field. + EMAIL_DELIVERY_NOT_AVAILABLE_IN_COUNTRY = 89; + + // Auto reply is not supported in the country specified in the country code + // field. + AUTO_REPLY_NOT_AVAILABLE_IN_COUNTRY = 90; + + // Invalid value specified for latitude. + INVALID_LATITUDE_VALUE = 91; + + // Invalid value specified for longitude. + INVALID_LONGITUDE_VALUE = 92; + + // Too many label fields provided. + TOO_MANY_LABELS = 93; + + // Invalid image url. + INVALID_IMAGE_URL = 94; + + // Latitude value is missing. + MISSING_LATITUDE_VALUE = 95; + + // Longitude value is missing. + MISSING_LONGITUDE_VALUE = 96; + + // Unable to find address. + ADDRESS_NOT_FOUND = 97; + + // Cannot target provided address. + ADDRESS_NOT_TARGETABLE = 98; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/feed_mapping_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/feed_mapping_error.proto new file mode 100644 index 000000000..284be5e12 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/feed_mapping_error.proto @@ -0,0 +1,100 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "FeedMappingErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing feed item errors. + +// Container for enum describing possible feed item errors. +message FeedMappingErrorEnum { + // Enum describing possible feed item errors. + enum FeedMappingError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The given placeholder field does not exist. + INVALID_PLACEHOLDER_FIELD = 2; + + // The given criterion field does not exist. + INVALID_CRITERION_FIELD = 3; + + // The given placeholder type does not exist. + INVALID_PLACEHOLDER_TYPE = 4; + + // The given criterion type does not exist. + INVALID_CRITERION_TYPE = 5; + + // A feed mapping must contain at least one attribute field mapping. + NO_ATTRIBUTE_FIELD_MAPPINGS = 7; + + // The type of the feed attribute referenced in the attribute field mapping + // must match the type of the placeholder field. + FEED_ATTRIBUTE_TYPE_MISMATCH = 8; + + // A feed mapping for a system generated feed cannot be operated on. + CANNOT_OPERATE_ON_MAPPINGS_FOR_SYSTEM_GENERATED_FEED = 9; + + // Only one feed mapping for a placeholder type is allowed per feed or + // customer (depending on the placeholder type). + MULTIPLE_MAPPINGS_FOR_PLACEHOLDER_TYPE = 10; + + // Only one feed mapping for a criterion type is allowed per customer. + MULTIPLE_MAPPINGS_FOR_CRITERION_TYPE = 11; + + // Only one feed attribute mapping for a placeholder field is allowed + // (depending on the placeholder type). + MULTIPLE_MAPPINGS_FOR_PLACEHOLDER_FIELD = 12; + + // Only one feed attribute mapping for a criterion field is allowed + // (depending on the criterion type). + MULTIPLE_MAPPINGS_FOR_CRITERION_FIELD = 13; + + // This feed mapping may not contain any explicit attribute field mappings. + UNEXPECTED_ATTRIBUTE_FIELD_MAPPINGS = 14; + + // Location placeholder feed mappings can only be created for Places feeds. + LOCATION_PLACEHOLDER_ONLY_FOR_PLACES_FEEDS = 15; + + // Mappings for typed feeds cannot be modified. + CANNOT_MODIFY_MAPPINGS_FOR_TYPED_FEED = 16; + + // The given placeholder type can only be mapped to system generated feeds. + INVALID_PLACEHOLDER_TYPE_FOR_NON_SYSTEM_GENERATED_FEED = 17; + + // The given placeholder type cannot be mapped to a system generated feed + // with the given type. + INVALID_PLACEHOLDER_TYPE_FOR_SYSTEM_GENERATED_FEED_TYPE = 18; + + // The "field" oneof was not set in an AttributeFieldMapping. + ATTRIBUTE_FIELD_MAPPING_MISSING_FIELD = 19; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/field_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/field_error.proto new file mode 100644 index 000000000..f601c070f --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/field_error.proto @@ -0,0 +1,65 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "FieldErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing field errors. + +// Container for enum describing possible field errors. +message FieldErrorEnum { + // Enum describing possible field errors. + enum FieldError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The required field was not present. + REQUIRED = 2; + + // The field attempted to be mutated is immutable. + IMMUTABLE_FIELD = 3; + + // The field's value is invalid. + INVALID_VALUE = 4; + + // The field cannot be set. + VALUE_MUST_BE_UNSET = 5; + + // The required repeated field was empty. + REQUIRED_NONEMPTY_LIST = 6; + + // The field cannot be cleared. + FIELD_CANNOT_BE_CLEARED = 7; + + // The field's value is on a blacklist for this field. + BLACKLISTED_VALUE = 8; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/field_mask_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/field_mask_error.proto new file mode 100644 index 000000000..6f2cdc597 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/field_mask_error.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "FieldMaskErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing field mask errors. + +// Container for enum describing possible field mask errors. +message FieldMaskErrorEnum { + // Enum describing possible field mask errors. + enum FieldMaskError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The field mask must be provided for update operations. + FIELD_MASK_MISSING = 5; + + // The field mask must be empty for create and remove operations. + FIELD_MASK_NOT_ALLOWED = 4; + + // The field mask contained an invalid field. + FIELD_NOT_FOUND = 2; + + // The field mask updated a field with subfields. Fields with subfields may + // be cleared, but not updated. To fix this, the field mask should select + // all the subfields of the invalid field. + FIELD_HAS_SUBFIELDS = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/function_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/function_error.proto new file mode 100644 index 000000000..118f0c071 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/function_error.proto @@ -0,0 +1,93 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "FunctionErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing function errors. + +// Container for enum describing possible function errors. +message FunctionErrorEnum { + // Enum describing possible function errors. + enum FunctionError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The format of the function is not recognized as a supported function + // format. + INVALID_FUNCTION_FORMAT = 2; + + // Operand data types do not match. + DATA_TYPE_MISMATCH = 3; + + // The operands cannot be used together in a conjunction. + INVALID_CONJUNCTION_OPERANDS = 4; + + // Invalid numer of Operands. + INVALID_NUMBER_OF_OPERANDS = 5; + + // Operand Type not supported. + INVALID_OPERAND_TYPE = 6; + + // Operator not supported. + INVALID_OPERATOR = 7; + + // Request context type not supported. + INVALID_REQUEST_CONTEXT_TYPE = 8; + + // The matching function is not allowed for call placeholders + INVALID_FUNCTION_FOR_CALL_PLACEHOLDER = 9; + + // The matching function is not allowed for the specified placeholder + INVALID_FUNCTION_FOR_PLACEHOLDER = 10; + + // Invalid operand. + INVALID_OPERAND = 11; + + // Missing value for the constant operand. + MISSING_CONSTANT_OPERAND_VALUE = 12; + + // The value of the constant operand is invalid. + INVALID_CONSTANT_OPERAND_VALUE = 13; + + // Invalid function nesting. + INVALID_NESTING = 14; + + // The Feed ID was different from another Feed ID in the same function. + MULTIPLE_FEED_IDS_NOT_SUPPORTED = 15; + + // The matching function is invalid for use with a feed with a fixed schema. + INVALID_FUNCTION_FOR_FEED_WITH_FIXED_SCHEMA = 16; + + // Invalid attribute name. + INVALID_ATTRIBUTE_NAME = 17; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/function_parsing_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/function_parsing_error.proto new file mode 100644 index 000000000..a7c634f5b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/function_parsing_error.proto @@ -0,0 +1,77 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "FunctionParsingErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing function parsing errors. + +// Container for enum describing possible function parsing errors. +message FunctionParsingErrorEnum { + // Enum describing possible function parsing errors. + enum FunctionParsingError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Unexpected end of function string. + NO_MORE_INPUT = 2; + + // Could not find an expected character. + EXPECTED_CHARACTER = 3; + + // Unexpected separator character. + UNEXPECTED_SEPARATOR = 4; + + // Unmatched left bracket or parenthesis. + UNMATCHED_LEFT_BRACKET = 5; + + // Unmatched right bracket or parenthesis. + UNMATCHED_RIGHT_BRACKET = 6; + + // Functions are nested too deeply. + TOO_MANY_NESTED_FUNCTIONS = 7; + + // Missing right-hand-side operand. + MISSING_RIGHT_HAND_OPERAND = 8; + + // Invalid operator/function name. + INVALID_OPERATOR_NAME = 9; + + // Feed attribute operand's argument is not an integer. + FEED_ATTRIBUTE_OPERAND_ARGUMENT_NOT_INTEGER = 10; + + // Missing function operands. + NO_OPERANDS = 11; + + // Function had too many operands. + TOO_MANY_OPERANDS = 12; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/geo_target_constant_suggestion_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/geo_target_constant_suggestion_error.proto new file mode 100644 index 000000000..039dd5f98 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/geo_target_constant_suggestion_error.proto @@ -0,0 +1,56 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "GeoTargetConstantSuggestionErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Container for enum describing possible geo target constant suggestion errors. +message GeoTargetConstantSuggestionErrorEnum { + // Enum describing possible geo target constant suggestion errors. + enum GeoTargetConstantSuggestionError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // A location name cannot be greater than 300 characters. + LOCATION_NAME_SIZE_LIMIT = 2; + + // At most 25 location names can be specified in a SuggestGeoTargetConstants + // method. + LOCATION_NAME_LIMIT = 3; + + // The country code is invalid. + INVALID_COUNTRY_CODE = 4; + + // Geo target constant resource names or location names must be provided in + // the request. + REQUEST_PARAMETERS_UNSET = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/header_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/header_error.proto new file mode 100644 index 000000000..dfbbe4544 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/header_error.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "HeaderErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing header errors. + +// Container for enum describing possible header errors. +message HeaderErrorEnum { + // Enum describing possible header errors. + enum HeaderError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The login customer id could not be validated. + INVALID_LOGIN_CUSTOMER_ID = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/id_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/id_error.proto new file mode 100644 index 000000000..d37b0fa9c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/id_error.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "IdErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing id errors. + +// Container for enum describing possible id errors. +message IdErrorEnum { + // Enum describing possible id errors. + enum IdError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Id not found + NOT_FOUND = 2; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/image_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/image_error.proto new file mode 100644 index 000000000..e226d6b2a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/image_error.proto @@ -0,0 +1,161 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "ImageErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing image errors. + +// Container for enum describing possible image errors. +message ImageErrorEnum { + // Enum describing possible image errors. + enum ImageError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The image is not valid. + INVALID_IMAGE = 2; + + // The image could not be stored. + STORAGE_ERROR = 3; + + // There was a problem with the request. + BAD_REQUEST = 4; + + // The image is not of legal dimensions. + UNEXPECTED_SIZE = 5; + + // Animated image are not permitted. + ANIMATED_NOT_ALLOWED = 6; + + // Animation is too long. + ANIMATION_TOO_LONG = 7; + + // There was an error on the server. + SERVER_ERROR = 8; + + // Image cannot be in CMYK color format. + CMYK_JPEG_NOT_ALLOWED = 9; + + // Flash images are not permitted. + FLASH_NOT_ALLOWED = 10; + + // Flash images must support clickTag. + FLASH_WITHOUT_CLICKTAG = 11; + + // A flash error has occurred after fixing the click tag. + FLASH_ERROR_AFTER_FIXING_CLICK_TAG = 12; + + // Unacceptable visual effects. + ANIMATED_VISUAL_EFFECT = 13; + + // There was a problem with the flash image. + FLASH_ERROR = 14; + + // Incorrect image layout. + LAYOUT_PROBLEM = 15; + + // There was a problem reading the image file. + PROBLEM_READING_IMAGE_FILE = 16; + + // There was an error storing the image. + ERROR_STORING_IMAGE = 17; + + // The aspect ratio of the image is not allowed. + ASPECT_RATIO_NOT_ALLOWED = 18; + + // Flash cannot have network objects. + FLASH_HAS_NETWORK_OBJECTS = 19; + + // Flash cannot have network methods. + FLASH_HAS_NETWORK_METHODS = 20; + + // Flash cannot have a Url. + FLASH_HAS_URL = 21; + + // Flash cannot use mouse tracking. + FLASH_HAS_MOUSE_TRACKING = 22; + + // Flash cannot have a random number. + FLASH_HAS_RANDOM_NUM = 23; + + // Ad click target cannot be '_self'. + FLASH_SELF_TARGETS = 24; + + // GetUrl method should only use '_blank'. + FLASH_BAD_GETURL_TARGET = 25; + + // Flash version is not supported. + FLASH_VERSION_NOT_SUPPORTED = 26; + + // Flash movies need to have hard coded click URL or clickTAG + FLASH_WITHOUT_HARD_CODED_CLICK_URL = 27; + + // Uploaded flash file is corrupted. + INVALID_FLASH_FILE = 28; + + // Uploaded flash file can be parsed, but the click tag can not be fixed + // properly. + FAILED_TO_FIX_CLICK_TAG_IN_FLASH = 29; + + // Flash movie accesses network resources + FLASH_ACCESSES_NETWORK_RESOURCES = 30; + + // Flash movie attempts to call external javascript code + FLASH_EXTERNAL_JS_CALL = 31; + + // Flash movie attempts to call flash system commands + FLASH_EXTERNAL_FS_CALL = 32; + + // Image file is too large. + FILE_TOO_LARGE = 33; + + // Image data is too large. + IMAGE_DATA_TOO_LARGE = 34; + + // Error while processing the image. + IMAGE_PROCESSING_ERROR = 35; + + // Image is too small. + IMAGE_TOO_SMALL = 36; + + // Input was invalid. + INVALID_INPUT = 37; + + // There was a problem reading the image file. + PROBLEM_READING_FILE = 38; + + // Image constraints are violated, but details like ASPECT_RATIO_NOT_ALLOWED + // can't be provided. This happens when asset spec contains more than one + // constraint and different criteria of different constraints are violated. + IMAGE_CONSTRAINTS_VIOLATED = 39; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/internal_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/internal_error.proto new file mode 100644 index 000000000..79b760108 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/internal_error.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "InternalErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing internal errors. + +// Container for enum describing possible internal errors. +message InternalErrorEnum { + // Enum describing possible internal errors. + enum InternalError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Google Ads API encountered unexpected internal error. + INTERNAL_ERROR = 2; + + // The intended error code doesn't exist in specified API version. It will + // be released in a future API version. + ERROR_CODE_NOT_PUBLISHED = 3; + + // Google Ads API encountered an unexpected transient error. The user + // should retry their request in these cases. + TRANSIENT_ERROR = 4; + + // The request took longer than a deadline. + DEADLINE_EXCEEDED = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/invoice_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/invoice_error.proto new file mode 100644 index 000000000..134843d47 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/invoice_error.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "InvoiceErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing invoice errors. + +// Container for enum describing possible invoice errors. +message InvoiceErrorEnum { + // Enum describing possible invoice errors. + enum InvoiceError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Cannot request invoices issued before 2019-01-01. + YEAR_MONTH_TOO_OLD = 2; + + // Cannot request invoices for customer who doesn't receive invoices. + NOT_INVOICED_CUSTOMER = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/keyword_plan_ad_group_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/keyword_plan_ad_group_error.proto new file mode 100644 index 000000000..b7989d04b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/keyword_plan_ad_group_error.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "KeywordPlanAdGroupErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing errors from applying a keyword plan ad group. + +// Container for enum describing possible errors from applying a keyword plan +// ad group. +message KeywordPlanAdGroupErrorEnum { + // Enum describing possible errors from applying a keyword plan ad group. + enum KeywordPlanAdGroupError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The keyword plan ad group name is missing, empty, longer than allowed + // limit or contains invalid chars. + INVALID_NAME = 2; + + // The keyword plan ad group name is duplicate to an existing keyword plan + // AdGroup name or other keyword plan AdGroup name in the request. + DUPLICATE_NAME = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/keyword_plan_campaign_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/keyword_plan_campaign_error.proto new file mode 100644 index 000000000..4c7e9e0ec --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/keyword_plan_campaign_error.proto @@ -0,0 +1,62 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "KeywordPlanCampaignErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing errors from applying a keyword plan campaign. + +// Container for enum describing possible errors from applying a keyword plan +// campaign. +message KeywordPlanCampaignErrorEnum { + // Enum describing possible errors from applying a keyword plan campaign. + enum KeywordPlanCampaignError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // A keyword plan campaign name is missing, empty, longer than allowed limit + // or contains invalid chars. + INVALID_NAME = 2; + + // A keyword plan campaign contains one or more untargetable languages. + INVALID_LANGUAGES = 3; + + // A keyword plan campaign contains one or more invalid geo targets. + INVALID_GEOS = 4; + + // The keyword plan campaign name is duplicate to an existing keyword plan + // campaign name or other keyword plan campaign name in the request. + DUPLICATE_NAME = 5; + + // The number of geo targets in the keyword plan campaign exceeds limits. + MAX_GEOS_EXCEEDED = 6; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/keyword_plan_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/keyword_plan_error.proto new file mode 100644 index 000000000..42c6ba91b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/keyword_plan_error.proto @@ -0,0 +1,91 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "KeywordPlanErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing errors from applying keyword plan resources (keyword +// plan, keyword plan campaign, keyword plan ad group or keyword plan keyword) +// or KeywordPlanService RPC. + +// Container for enum describing possible errors from applying a keyword plan +// resource (keyword plan, keyword plan campaign, keyword plan ad group or +// keyword plan keyword) or KeywordPlanService RPC. +message KeywordPlanErrorEnum { + // Enum describing possible errors from applying a keyword plan. + enum KeywordPlanError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The plan's bid multiplier value is outside the valid range. + BID_MULTIPLIER_OUT_OF_RANGE = 2; + + // The plan's bid value is too high. + BID_TOO_HIGH = 3; + + // The plan's bid value is too low. + BID_TOO_LOW = 4; + + // The plan's cpc bid is not a multiple of the minimum billable unit. + BID_TOO_MANY_FRACTIONAL_DIGITS = 5; + + // The plan's daily budget value is too low. + DAILY_BUDGET_TOO_LOW = 6; + + // The plan's daily budget is not a multiple of the minimum billable unit. + DAILY_BUDGET_TOO_MANY_FRACTIONAL_DIGITS = 7; + + // The input has an invalid value. + INVALID_VALUE = 8; + + // The plan has no keyword. + KEYWORD_PLAN_HAS_NO_KEYWORDS = 9; + + // The plan is not enabled and API cannot provide mutation, forecast or + // stats. + KEYWORD_PLAN_NOT_ENABLED = 10; + + // The requested plan cannot be found for providing forecast or stats. + KEYWORD_PLAN_NOT_FOUND = 11; + + // The plan is missing a cpc bid. + MISSING_BID = 13; + + // The plan is missing required forecast_period field. + MISSING_FORECAST_PERIOD = 14; + + // The plan's forecast_period has invalid forecast date range. + INVALID_FORECAST_DATE_RANGE = 15; + + // The plan's name is invalid. + INVALID_NAME = 16; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/keyword_plan_idea_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/keyword_plan_idea_error.proto new file mode 100644 index 000000000..fd4eaf45e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/keyword_plan_idea_error.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "KeywordPlanIdeaErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing errors from KeywordPlanIdeaService. + +// Container for enum describing possible errors from KeywordPlanIdeaService. +message KeywordPlanIdeaErrorEnum { + // Enum describing possible errors from KeywordPlanIdeaService. + enum KeywordPlanIdeaError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Error when crawling the input URL. + URL_CRAWL_ERROR = 2; + + // The input has an invalid value. + INVALID_VALUE = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/keyword_plan_keyword_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/keyword_plan_keyword_error.proto new file mode 100644 index 000000000..bada6547a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/keyword_plan_keyword_error.proto @@ -0,0 +1,65 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "KeywordPlanKeywordErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing errors from applying a keyword plan keyword or keyword +// plan negative keyword. + +// Container for enum describing possible errors from applying a keyword or a +// negative keyword from a keyword plan. +message KeywordPlanKeywordErrorEnum { + // Enum describing possible errors from applying a keyword plan keyword. + enum KeywordPlanKeywordError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // A keyword or negative keyword has invalid match type. + INVALID_KEYWORD_MATCH_TYPE = 2; + + // A keyword or negative keyword with same text and match type already + // exists. + DUPLICATE_KEYWORD = 3; + + // Keyword or negative keyword text exceeds the allowed limit. + KEYWORD_TEXT_TOO_LONG = 4; + + // Keyword or negative keyword text has invalid characters or symbols. + KEYWORD_HAS_INVALID_CHARS = 5; + + // Keyword or negative keyword text has too many words. + KEYWORD_HAS_TOO_MANY_WORDS = 6; + + // Keyword or negative keyword has invalid text. + INVALID_KEYWORD_TEXT = 7; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/keyword_plan_negative_keyword_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/keyword_plan_negative_keyword_error.proto new file mode 100644 index 000000000..36a4e5d88 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/keyword_plan_negative_keyword_error.proto @@ -0,0 +1,46 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "KeywordPlanNegativeKeywordErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing errors from applying a keyword plan negative keyword. + +// Container for enum describing possible errors from applying a keyword plan +// negative keyword. +message KeywordPlanNegativeKeywordErrorEnum { + // Enum describing possible errors from applying a keyword plan negative + // keyword. + enum KeywordPlanNegativeKeywordError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/label_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/label_error.proto new file mode 100644 index 000000000..7b048b538 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/label_error.proto @@ -0,0 +1,73 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "LabelErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing label errors. + +// Container for enum describing possible label errors. +message LabelErrorEnum { + // Enum describing possible label errors. + enum LabelError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // An inactive label cannot be applied. + CANNOT_APPLY_INACTIVE_LABEL = 2; + + // A label cannot be applied to a disabled ad group criterion. + CANNOT_APPLY_LABEL_TO_DISABLED_AD_GROUP_CRITERION = 3; + + // A label cannot be applied to a negative ad group criterion. + CANNOT_APPLY_LABEL_TO_NEGATIVE_AD_GROUP_CRITERION = 4; + + // Cannot apply more than 50 labels per resource. + EXCEEDED_LABEL_LIMIT_PER_TYPE = 5; + + // Labels from a manager account cannot be applied to campaign, ad group, + // ad group ad, or ad group criterion resources. + INVALID_RESOURCE_FOR_MANAGER_LABEL = 6; + + // Label names must be unique. + DUPLICATE_NAME = 7; + + // Label names cannot be empty. + INVALID_LABEL_NAME = 8; + + // Labels cannot be applied to a draft. + CANNOT_ATTACH_LABEL_TO_DRAFT = 9; + + // Labels not from a manager account cannot be applied to the customer + // resource. + CANNOT_ATTACH_NON_MANAGER_LABEL_TO_CUSTOMER = 10; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/language_code_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/language_code_error.proto new file mode 100644 index 000000000..c6bc8fd16 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/language_code_error.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "LanguageCodeErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing language code errors. + +// Container for enum describing language code errors. +message LanguageCodeErrorEnum { + // Enum describing language code errors. + enum LanguageCodeError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The input language code is not recognized. + LANGUAGE_CODE_NOT_FOUND = 2; + + // The language is not allowed to use. + INVALID_LANGUAGE_CODE = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/list_operation_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/list_operation_error.proto new file mode 100644 index 000000000..9407a0292 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/list_operation_error.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "ListOperationErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing list operation errors. + +// Container for enum describing possible list operation errors. +message ListOperationErrorEnum { + // Enum describing possible list operation errors. + enum ListOperationError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Field required in value is missing. + REQUIRED_FIELD_MISSING = 7; + + // Duplicate or identical value is sent in multiple list operations. + DUPLICATE_VALUES = 8; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/manager_link_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/manager_link_error.proto new file mode 100644 index 000000000..09ff2cd0e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/manager_link_error.proto @@ -0,0 +1,97 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "ManagerLinkErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing ManagerLink errors. + +// Container for enum describing possible ManagerLink errors. +message ManagerLinkErrorEnum { + // Enum describing possible ManagerLink errors. + enum ManagerLinkError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The manager and client have incompatible account types. + ACCOUNTS_NOT_COMPATIBLE_FOR_LINKING = 2; + + // Client is already linked to too many managers. + TOO_MANY_MANAGERS = 3; + + // Manager has too many pending invitations. + TOO_MANY_INVITES = 4; + + // Client is already invited by this manager. + ALREADY_INVITED_BY_THIS_MANAGER = 5; + + // The client is already managed by this manager. + ALREADY_MANAGED_BY_THIS_MANAGER = 6; + + // Client is already managed in hierarchy. + ALREADY_MANAGED_IN_HIERARCHY = 7; + + // Manger and sub-manager to be linked have duplicate client. + DUPLICATE_CHILD_FOUND = 8; + + // Client has no active user that can access the client account. + CLIENT_HAS_NO_ADMIN_USER = 9; + + // Adding this link would exceed the maximum hierarchy depth. + MAX_DEPTH_EXCEEDED = 10; + + // Adding this link will create a cycle. + CYCLE_NOT_ALLOWED = 11; + + // Manager account has the maximum number of linked clients. + TOO_MANY_ACCOUNTS = 12; + + // Parent manager account has the maximum number of linked clients. + TOO_MANY_ACCOUNTS_AT_MANAGER = 13; + + // The account is not authorized owner. + NON_OWNER_USER_CANNOT_MODIFY_LINK = 14; + + // Your manager account is suspended, and you are no longer allowed to link + // to clients. + SUSPENDED_ACCOUNT_CANNOT_ADD_CLIENTS = 15; + + // You are not allowed to move a client to a manager that is not under your + // current hierarchy. + CLIENT_OUTSIDE_TREE = 16; + + // The changed status for mutate link is invalid. + INVALID_STATUS_CHANGE = 17; + + // The change for mutate link is invalid. + INVALID_CHANGE = 18; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/media_bundle_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/media_bundle_error.proto new file mode 100644 index 000000000..400716509 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/media_bundle_error.proto @@ -0,0 +1,110 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "MediaBundleErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing media bundle errors. + +// Container for enum describing possible media bundle errors. +message MediaBundleErrorEnum { + // Enum describing possible media bundle errors. + enum MediaBundleError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // There was a problem with the request. + BAD_REQUEST = 3; + + // HTML5 ads using DoubleClick Studio created ZIP files are not supported. + DOUBLECLICK_BUNDLE_NOT_ALLOWED = 4; + + // Cannot reference URL external to the media bundle. + EXTERNAL_URL_NOT_ALLOWED = 5; + + // Media bundle file is too large. + FILE_TOO_LARGE = 6; + + // ZIP file from Google Web Designer is not published. + GOOGLE_WEB_DESIGNER_ZIP_FILE_NOT_PUBLISHED = 7; + + // Input was invalid. + INVALID_INPUT = 8; + + // There was a problem with the media bundle. + INVALID_MEDIA_BUNDLE = 9; + + // There was a problem with one or more of the media bundle entries. + INVALID_MEDIA_BUNDLE_ENTRY = 10; + + // The media bundle contains a file with an unknown mime type + INVALID_MIME_TYPE = 11; + + // The media bundle contain an invalid asset path. + INVALID_PATH = 12; + + // HTML5 ad is trying to reference an asset not in .ZIP file + INVALID_URL_REFERENCE = 13; + + // Media data is too large. + MEDIA_DATA_TOO_LARGE = 14; + + // The media bundle contains no primary entry. + MISSING_PRIMARY_MEDIA_BUNDLE_ENTRY = 15; + + // There was an error on the server. + SERVER_ERROR = 16; + + // The image could not be stored. + STORAGE_ERROR = 17; + + // Media bundle created with the Swiffy tool is not allowed. + SWIFFY_BUNDLE_NOT_ALLOWED = 18; + + // The media bundle contains too many files. + TOO_MANY_FILES = 19; + + // The media bundle is not of legal dimensions. + UNEXPECTED_SIZE = 20; + + // Google Web Designer not created for "Google Ads" environment. + UNSUPPORTED_GOOGLE_WEB_DESIGNER_ENVIRONMENT = 21; + + // Unsupported HTML5 feature in HTML5 asset. + UNSUPPORTED_HTML5_FEATURE = 22; + + // URL in HTML5 entry is not ssl compliant. + URL_IN_MEDIA_BUNDLE_NOT_SSL_COMPLIANT = 23; + + // Custom exits not allowed in HTML5 entry. + CUSTOM_EXIT_NOT_ALLOWED = 24; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/media_file_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/media_file_error.proto new file mode 100644 index 000000000..1f6ec768b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/media_file_error.proto @@ -0,0 +1,113 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "MediaFileErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing media file errors. + +// Container for enum describing possible media file errors. +message MediaFileErrorEnum { + // Enum describing possible media file errors. + enum MediaFileError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Cannot create a standard icon type. + CANNOT_CREATE_STANDARD_ICON = 2; + + // May only select Standard Icons alone. + CANNOT_SELECT_STANDARD_ICON_WITH_OTHER_TYPES = 3; + + // Image contains both a media file ID and data. + CANNOT_SPECIFY_MEDIA_FILE_ID_AND_DATA = 4; + + // A media file with given type and reference ID already exists. + DUPLICATE_MEDIA = 5; + + // A required field was not specified or is an empty string. + EMPTY_FIELD = 6; + + // A media file may only be modified once per call. + RESOURCE_REFERENCED_IN_MULTIPLE_OPS = 7; + + // Field is not supported for the media sub type. + FIELD_NOT_SUPPORTED_FOR_MEDIA_SUB_TYPE = 8; + + // The media file ID is invalid. + INVALID_MEDIA_FILE_ID = 9; + + // The media subtype is invalid. + INVALID_MEDIA_SUB_TYPE = 10; + + // The media file type is invalid. + INVALID_MEDIA_FILE_TYPE = 11; + + // The mimetype is invalid. + INVALID_MIME_TYPE = 12; + + // The media reference ID is invalid. + INVALID_REFERENCE_ID = 13; + + // The YouTube video ID is invalid. + INVALID_YOU_TUBE_ID = 14; + + // Media file has failed transcoding + MEDIA_FILE_FAILED_TRANSCODING = 15; + + // Media file has not been transcoded. + MEDIA_NOT_TRANSCODED = 16; + + // The media type does not match the actual media file's type. + MEDIA_TYPE_DOES_NOT_MATCH_MEDIA_FILE_TYPE = 17; + + // None of the fields have been specified. + NO_FIELDS_SPECIFIED = 18; + + // One of reference ID or media file ID must be specified. + NULL_REFERENCE_ID_AND_MEDIA_ID = 19; + + // The string has too many characters. + TOO_LONG = 20; + + // The specified type is not supported. + UNSUPPORTED_TYPE = 21; + + // YouTube is unavailable for requesting video data. + YOU_TUBE_SERVICE_UNAVAILABLE = 22; + + // The YouTube video has a non positive duration. + YOU_TUBE_VIDEO_HAS_NON_POSITIVE_DURATION = 23; + + // The YouTube video ID is syntactically valid but the video was not found. + YOU_TUBE_VIDEO_NOT_FOUND = 24; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/media_upload_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/media_upload_error.proto new file mode 100644 index 000000000..91e16ba95 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/media_upload_error.proto @@ -0,0 +1,65 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "MediaUploadErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing media uploading errors. + +// Container for enum describing possible media uploading errors. +message MediaUploadErrorEnum { + // Enum describing possible media uploading errors. + enum MediaUploadError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The uploaded file is too big. + FILE_TOO_BIG = 2; + + // Image data is unparseable. + UNPARSEABLE_IMAGE = 3; + + // Animated images are not allowed. + ANIMATED_IMAGE_NOT_ALLOWED = 4; + + // The image or media bundle format is not allowed. + FORMAT_NOT_ALLOWED = 5; + + // Cannot reference URL external to the media bundle. + EXTERNAL_URL_NOT_ALLOWED = 6; + + // HTML5 ad is trying to reference an asset not in .ZIP file. + INVALID_URL_REFERENCE = 7; + + // The media bundle contains no primary entry. + MISSING_PRIMARY_MEDIA_BUNDLE_ENTRY = 8; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/multiplier_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/multiplier_error.proto new file mode 100644 index 000000000..e80463b10 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/multiplier_error.proto @@ -0,0 +1,81 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "MultiplierErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing multiplier errors. + +// Container for enum describing possible multiplier errors. +message MultiplierErrorEnum { + // Enum describing possible multiplier errors. + enum MultiplierError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Multiplier value is too high + MULTIPLIER_TOO_HIGH = 2; + + // Multiplier value is too low + MULTIPLIER_TOO_LOW = 3; + + // Too many fractional digits + TOO_MANY_FRACTIONAL_DIGITS = 4; + + // A multiplier cannot be set for this bidding strategy + MULTIPLIER_NOT_ALLOWED_FOR_BIDDING_STRATEGY = 5; + + // A multiplier cannot be set when there is no base bid (e.g., content max + // cpc) + MULTIPLIER_NOT_ALLOWED_WHEN_BASE_BID_IS_MISSING = 6; + + // A bid multiplier must be specified + NO_MULTIPLIER_SPECIFIED = 7; + + // Multiplier causes bid to exceed daily budget + MULTIPLIER_CAUSES_BID_TO_EXCEED_DAILY_BUDGET = 8; + + // Multiplier causes bid to exceed monthly budget + MULTIPLIER_CAUSES_BID_TO_EXCEED_MONTHLY_BUDGET = 9; + + // Multiplier causes bid to exceed custom budget + MULTIPLIER_CAUSES_BID_TO_EXCEED_CUSTOM_BUDGET = 10; + + // Multiplier causes bid to exceed maximum allowed bid + MULTIPLIER_CAUSES_BID_TO_EXCEED_MAX_ALLOWED_BID = 11; + + // Multiplier causes bid to become less than the minimum bid allowed + BID_LESS_THAN_MIN_ALLOWED_BID_WITH_MULTIPLIER = 12; + + // Multiplier type (cpc vs. cpm) needs to match campaign's bidding strategy + MULTIPLIER_AND_BIDDING_STRATEGY_TYPE_MISMATCH = 13; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/mutate_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/mutate_error.proto new file mode 100644 index 000000000..e81ef5f30 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/mutate_error.proto @@ -0,0 +1,69 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "MutateErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing mutate errors. + +// Container for enum describing possible mutate errors. +message MutateErrorEnum { + // Enum describing possible mutate errors. + enum MutateError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Requested resource was not found. + RESOURCE_NOT_FOUND = 3; + + // Cannot mutate the same resource twice in one request. + ID_EXISTS_IN_MULTIPLE_MUTATES = 7; + + // The field's contents don't match another field that represents the same + // data. + INCONSISTENT_FIELD_VALUES = 8; + + // Mutates are not allowed for the requested resource. + MUTATE_NOT_ALLOWED = 9; + + // The resource isn't in Google Ads. It belongs to another ads system. + RESOURCE_NOT_IN_GOOGLE_ADS = 10; + + // The resource being created already exists. + RESOURCE_ALREADY_EXISTS = 11; + + // This resource cannot be used with "validate_only". + RESOURCE_DOES_NOT_SUPPORT_VALIDATE_ONLY = 12; + + // Attempt to write to read-only fields. + RESOURCE_READ_ONLY = 13; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/mutate_job_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/mutate_job_error.proto new file mode 100644 index 000000000..e1fac000a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/mutate_job_error.proto @@ -0,0 +1,60 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "MutateJobErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing mutate job errors. + +// Container for enum describing possible mutate job errors. +message MutateJobErrorEnum { + // Enum describing possible request errors. + enum MutateJobError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The mutate job cannot add more operations or run after it has started + // running. + CANNOT_MODIFY_JOB_AFTER_JOB_STARTS_RUNNING = 2; + + // The operations for an AddMutateJobOperations request were empty. + EMPTY_OPERATIONS = 3; + + // The sequence token for an AddMutateJobOperations request was invalid. + INVALID_SEQUENCE_TOKEN = 4; + + // Mutate Job Results can only be retrieved once the job is finished. + RESULTS_NOT_READY = 5; + + // The page size for ListMutateJobResults was invalid. + INVALID_PAGE_SIZE = 6; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/new_resource_creation_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/new_resource_creation_error.proto new file mode 100644 index 000000000..0b2b398ce --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/new_resource_creation_error.proto @@ -0,0 +1,54 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "NewResourceCreationErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing new resource creation errors. + +// Container for enum describing possible new resource creation errors. +message NewResourceCreationErrorEnum { + // Enum describing possible new resource creation errors. + enum NewResourceCreationError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Do not set the id field while creating new resources. + CANNOT_SET_ID_FOR_CREATE = 2; + + // Creating more than one resource with the same temp ID is not allowed. + DUPLICATE_TEMP_IDS = 3; + + // Parent resource with specified temp ID failed validation, so no + // validation will be done for this child resource. + TEMP_ID_RESOURCE_HAD_ERRORS = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/not_empty_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/not_empty_error.proto new file mode 100644 index 000000000..ca04a45d5 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/not_empty_error.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "NotEmptyErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing not empty errors. + +// Container for enum describing possible not empty errors. +message NotEmptyErrorEnum { + // Enum describing possible not empty errors. + enum NotEmptyError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Empty list. + EMPTY_LIST = 2; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/not_whitelisted_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/not_whitelisted_error.proto new file mode 100644 index 000000000..385715bb8 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/not_whitelisted_error.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "NotWhitelistedErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing not whitelisted errors. + +// Container for enum describing possible not whitelisted errors. +message NotWhitelistedErrorEnum { + // Enum describing possible not whitelisted errors. + enum NotWhitelistedError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Customer is not whitelisted for accessing this feature. + CUSTOMER_NOT_WHITELISTED_FOR_THIS_FEATURE = 2; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/null_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/null_error.proto new file mode 100644 index 000000000..eb35b2484 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/null_error.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "NullErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing null errors. + +// Container for enum describing possible null errors. +message NullErrorEnum { + // Enum describing possible null errors. + enum NullError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Specified list/container must not contain any null elements + NULL_CONTENT = 2; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/offline_user_data_job_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/offline_user_data_job_error.proto new file mode 100644 index 000000000..5e53058b6 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/offline_user_data_job_error.proto @@ -0,0 +1,117 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "OfflineUserDataJobErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing offline user data job errors. + +// Container for enum describing possible offline user data job errors. +message OfflineUserDataJobErrorEnum { + // Enum describing possible request errors. + enum OfflineUserDataJobError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The user list ID provided for the job is invalid. + INVALID_USER_LIST_ID = 3; + + // Type of the user list is not applicable for the job. + INVALID_USER_LIST_TYPE = 4; + + // Customer is not whitelisted for using user ID in upload data. + NOT_WHITELISTED_FOR_USER_ID = 5; + + // Upload data is not compatible with the upload key type of the associated + // user list. + INCOMPATIBLE_UPLOAD_KEY_TYPE = 6; + + // The user identifier is missing valid data. + MISSING_USER_IDENTIFIER = 7; + + // The mobile ID is malformed. + INVALID_MOBILE_ID_FORMAT = 8; + + // Request is exceeding the maximum number of user identifiers allowed. + TOO_MANY_USER_IDENTIFIERS = 9; + + // Customer is not whitelisted for store sales direct data. + NOT_WHITELISTED_FOR_STORE_SALES_DIRECT = 10; + + // The partner ID in store sales direct metadata is invalid. + INVALID_PARTNER_ID = 11; + + // The data in user identifier should not be encoded. + INVALID_ENCODING = 12; + + // The country code is invalid. + INVALID_COUNTRY_CODE = 13; + + // Incompatible user identifier when using third_party_user_id for store + // sales direct first party data or not using third_party_user_id for store + // sales third party data. + INCOMPATIBLE_USER_IDENTIFIER = 14; + + // A transaction time in the future is not allowed. + FUTURE_TRANSACTION_TIME = 15; + + // The conversion_action specified in transaction_attributes is used to + // report conversions to a conversion action configured in Google Ads. This + // error indicates there is no such conversion action in the account. + INVALID_CONVERSION_ACTION = 16; + + // Mobile ID is not supported for store sales direct data. + MOBILE_ID_NOT_SUPPORTED = 17; + + // When a remove-all operation is provided, it has to be the first operation + // of the operation list. + INVALID_OPERATION_ORDER = 18; + + // Mixing creation and removal of offline data in the same job is not + // allowed. + CONFLICTING_OPERATION = 19; + + // The external update ID already exists. + EXTERNAL_UPDATE_ID_ALREADY_EXISTS = 21; + + // Once the upload job is started, new operations cannot be added. + JOB_ALREADY_STARTED = 22; + + // Remove operation is not allowed for store sales direct updates. + REMOVE_NOT_SUPPORTED = 23; + + // Remove-all is not supported for store sales direct updates. + REMOVE_ALL_NOT_SUPPORTED = 24; + + // The SHA256 encoded value is malformed. + INVALID_SHA256_FORMAT = 25; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/operation_access_denied_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/operation_access_denied_error.proto new file mode 100644 index 000000000..a53e5397b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/operation_access_denied_error.proto @@ -0,0 +1,74 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "OperationAccessDeniedErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing operation access denied errors. + +// Container for enum describing possible operation access denied errors. +message OperationAccessDeniedErrorEnum { + // Enum describing possible operation access denied errors. + enum OperationAccessDeniedError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Unauthorized invocation of a service's method (get, mutate, etc.) + ACTION_NOT_PERMITTED = 2; + + // Unauthorized CREATE operation in invoking a service's mutate method. + CREATE_OPERATION_NOT_PERMITTED = 3; + + // Unauthorized REMOVE operation in invoking a service's mutate method. + REMOVE_OPERATION_NOT_PERMITTED = 4; + + // Unauthorized UPDATE operation in invoking a service's mutate method. + UPDATE_OPERATION_NOT_PERMITTED = 5; + + // A mutate action is not allowed on this campaign, from this client. + MUTATE_ACTION_NOT_PERMITTED_FOR_CLIENT = 6; + + // This operation is not permitted on this campaign type + OPERATION_NOT_PERMITTED_FOR_CAMPAIGN_TYPE = 7; + + // A CREATE operation may not set status to REMOVED. + CREATE_AS_REMOVED_NOT_PERMITTED = 8; + + // This operation is not allowed because the campaign or adgroup is removed. + OPERATION_NOT_PERMITTED_FOR_REMOVED_RESOURCE = 9; + + // This operation is not permitted on this ad group type. + OPERATION_NOT_PERMITTED_FOR_AD_GROUP_TYPE = 10; + + // The mutate is not allowed for this customer. + MUTATE_NOT_PERMITTED_FOR_CUSTOMER = 11; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/operator_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/operator_error.proto new file mode 100644 index 000000000..76e157ee1 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/operator_error.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "OperatorErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing operator errors. + +// Container for enum describing possible operator errors. +message OperatorErrorEnum { + // Enum describing possible operator errors. + enum OperatorError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Operator not supported. + OPERATOR_NOT_SUPPORTED = 2; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/partial_failure_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/partial_failure_error.proto new file mode 100644 index 000000000..6fabcec85 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/partial_failure_error.proto @@ -0,0 +1,48 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "PartialFailureErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing partial failure errors. + +// Container for enum describing possible partial failure errors. +message PartialFailureErrorEnum { + // Enum describing possible partial failure errors. + enum PartialFailureError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The partial failure field was false in the request. + // This method requires this field be set to true. + PARTIAL_FAILURE_MODE_REQUIRED = 2; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/payments_account_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/payments_account_error.proto new file mode 100644 index 000000000..9f8dc527b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/payments_account_error.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "PaymentsAccountErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing payments account service errors. + +// Container for enum describing possible errors in payments account service. +message PaymentsAccountErrorEnum { + // Enum describing possible errors in payments account service. + enum PaymentsAccountError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Manager customers are not supported for payments account service. + NOT_SUPPORTED_FOR_MANAGER_CUSTOMER = 2; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/policy_finding_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/policy_finding_error.proto new file mode 100644 index 000000000..eb5f508d2 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/policy_finding_error.proto @@ -0,0 +1,51 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "PolicyFindingErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing policy finding errors. + +// Container for enum describing possible policy finding errors. +message PolicyFindingErrorEnum { + // Enum describing possible policy finding errors. + enum PolicyFindingError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The resource has been disapproved since the policy summary includes + // policy topics of type PROHIBITED. + POLICY_FINDING = 2; + + // The given policy topic does not exist. + POLICY_TOPIC_NOT_FOUND = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/policy_validation_parameter_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/policy_validation_parameter_error.proto new file mode 100644 index 000000000..0c61af74f --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/policy_validation_parameter_error.proto @@ -0,0 +1,54 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "PolicyValidationParameterErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing policy validation parameter errors. + +// Container for enum describing possible policy validation parameter errors. +message PolicyValidationParameterErrorEnum { + // Enum describing possible policy validation parameter errors. + enum PolicyValidationParameterError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Ignorable policy topics are not supported for the ad type. + UNSUPPORTED_AD_TYPE_FOR_IGNORABLE_POLICY_TOPICS = 2; + + // Exempt policy violation keys are not supported for the ad type. + UNSUPPORTED_AD_TYPE_FOR_EXEMPT_POLICY_VIOLATION_KEYS = 3; + + // Cannot set ignorable policy topics and exempt policy violation keys in + // the same policy violation parameter. + CANNOT_SET_BOTH_IGNORABLE_POLICY_TOPICS_AND_EXEMPT_POLICY_VIOLATION_KEYS = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/policy_violation_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/policy_violation_error.proto new file mode 100644 index 000000000..f38ab67ba --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/policy_violation_error.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "PolicyViolationErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing policy violation errors. + +// Container for enum describing possible policy violation errors. +message PolicyViolationErrorEnum { + // Enum describing possible policy violation errors. + enum PolicyViolationError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // A policy was violated. See PolicyViolationDetails for more detail. + POLICY_ERROR = 2; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/query_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/query_error.proto new file mode 100644 index 000000000..c7c176e77 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/query_error.proto @@ -0,0 +1,218 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "QueryErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing query errors. + +// Container for enum describing possible query errors. +message QueryErrorEnum { + // Enum describing possible query errors. + enum QueryError { + // Name unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Returned if all other query error reasons are not applicable. + QUERY_ERROR = 50; + + // A condition used in the query references an invalid enum constant. + BAD_ENUM_CONSTANT = 18; + + // Query contains an invalid escape sequence. + BAD_ESCAPE_SEQUENCE = 7; + + // Field name is invalid. + BAD_FIELD_NAME = 12; + + // Limit value is invalid (i.e. not a number) + BAD_LIMIT_VALUE = 15; + + // Encountered number can not be parsed. + BAD_NUMBER = 5; + + // Invalid operator encountered. + BAD_OPERATOR = 3; + + // Parameter unknown or not supported. + BAD_PARAMETER_NAME = 61; + + // Parameter have invalid value. + BAD_PARAMETER_VALUE = 62; + + // Invalid resource type was specified in the FROM clause. + BAD_RESOURCE_TYPE_IN_FROM_CLAUSE = 45; + + // Non-ASCII symbol encountered outside of strings. + BAD_SYMBOL = 2; + + // Value is invalid. + BAD_VALUE = 4; + + // Date filters fail to restrict date to a range smaller than 31 days. + // Applicable if the query is segmented by date. + DATE_RANGE_TOO_WIDE = 36; + + // Filters on date/week/month/quarter have a start date after + // end date. + DATE_RANGE_TOO_NARROW = 60; + + // Expected AND between values with BETWEEN operator. + EXPECTED_AND = 30; + + // Expecting ORDER BY to have BY. + EXPECTED_BY = 14; + + // There was no dimension field selected. + EXPECTED_DIMENSION_FIELD_IN_SELECT_CLAUSE = 37; + + // Missing filters on date related fields. + EXPECTED_FILTERS_ON_DATE_RANGE = 55; + + // Missing FROM clause. + EXPECTED_FROM = 44; + + // The operator used in the conditions requires the value to be a list. + EXPECTED_LIST = 41; + + // Fields used in WHERE or ORDER BY clauses are missing from the SELECT + // clause. + EXPECTED_REFERENCED_FIELD_IN_SELECT_CLAUSE = 16; + + // SELECT is missing at the beginning of query. + EXPECTED_SELECT = 13; + + // A list was passed as a value to a condition whose operator expects a + // single value. + EXPECTED_SINGLE_VALUE = 42; + + // Missing one or both values with BETWEEN operator. + EXPECTED_VALUE_WITH_BETWEEN_OPERATOR = 29; + + // Invalid date format. Expected 'YYYY-MM-DD'. + INVALID_DATE_FORMAT = 38; + + // Value passed was not a string when it should have been. I.e., it was a + // number or unquoted literal. + INVALID_STRING_VALUE = 57; + + // A String value passed to the BETWEEN operator does not parse as a date. + INVALID_VALUE_WITH_BETWEEN_OPERATOR = 26; + + // The value passed to the DURING operator is not a Date range literal + INVALID_VALUE_WITH_DURING_OPERATOR = 22; + + // A non-string value was passed to the LIKE operator. + INVALID_VALUE_WITH_LIKE_OPERATOR = 56; + + // An operator was provided that is inapplicable to the field being + // filtered. + OPERATOR_FIELD_MISMATCH = 35; + + // A Condition was found with an empty list. + PROHIBITED_EMPTY_LIST_IN_CONDITION = 28; + + // A condition used in the query references an unsupported enum constant. + PROHIBITED_ENUM_CONSTANT = 54; + + // Fields that are not allowed to be selected together were included in + // the SELECT clause. + PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE = 31; + + // A field that is not orderable was included in the ORDER BY clause. + PROHIBITED_FIELD_IN_ORDER_BY_CLAUSE = 40; + + // A field that is not selectable was included in the SELECT clause. + PROHIBITED_FIELD_IN_SELECT_CLAUSE = 23; + + // A field that is not filterable was included in the WHERE clause. + PROHIBITED_FIELD_IN_WHERE_CLAUSE = 24; + + // Resource type specified in the FROM clause is not supported by this + // service. + PROHIBITED_RESOURCE_TYPE_IN_FROM_CLAUSE = 43; + + // A field that comes from an incompatible resource was included in the + // SELECT clause. + PROHIBITED_RESOURCE_TYPE_IN_SELECT_CLAUSE = 48; + + // A field that comes from an incompatible resource was included in the + // WHERE clause. + PROHIBITED_RESOURCE_TYPE_IN_WHERE_CLAUSE = 58; + + // A metric incompatible with the main resource or other selected + // segmenting resources was included in the SELECT or WHERE clause. + PROHIBITED_METRIC_IN_SELECT_OR_WHERE_CLAUSE = 49; + + // A segment incompatible with the main resource or other selected + // segmenting resources was included in the SELECT or WHERE clause. + PROHIBITED_SEGMENT_IN_SELECT_OR_WHERE_CLAUSE = 51; + + // A segment in the SELECT clause is incompatible with a metric in the + // SELECT or WHERE clause. + PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE = 53; + + // The value passed to the limit clause is too low. + LIMIT_VALUE_TOO_LOW = 25; + + // Query has a string containing a newline character. + PROHIBITED_NEWLINE_IN_STRING = 8; + + // List contains values of different types. + PROHIBITED_VALUE_COMBINATION_IN_LIST = 10; + + // The values passed to the BETWEEN operator are not of the same type. + PROHIBITED_VALUE_COMBINATION_WITH_BETWEEN_OPERATOR = 21; + + // Query contains unterminated string. + STRING_NOT_TERMINATED = 6; + + // Too many segments are specified in SELECT clause. + TOO_MANY_SEGMENTS = 34; + + // Query is incomplete and cannot be parsed. + UNEXPECTED_END_OF_QUERY = 9; + + // FROM clause cannot be specified in this query. + UNEXPECTED_FROM_CLAUSE = 47; + + // Query contains one or more unrecognized fields. + UNRECOGNIZED_FIELD = 32; + + // Query has an unexpected extra part. + UNEXPECTED_INPUT = 11; + + // Metrics cannot be requested for a manager account. To retrieve metrics, + // issue separate requests against each client account under the manager + // account. + REQUESTED_METRICS_FOR_MANAGER = 59; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/quota_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/quota_error.proto new file mode 100644 index 000000000..a0c6e9069 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/quota_error.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "QuotaErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing quota errors. + +// Container for enum describing possible quota errors. +message QuotaErrorEnum { + // Enum describing possible quota errors. + enum QuotaError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Too many requests. + RESOURCE_EXHAUSTED = 2; + + // Access is prohibited. + ACCESS_PROHIBITED = 3; + + // Too many requests in a short amount of time. + RESOURCE_TEMPORARILY_EXHAUSTED = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/range_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/range_error.proto new file mode 100644 index 000000000..f7ae95680 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/range_error.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "RangeErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing range errors. + +// Container for enum describing possible range errors. +message RangeErrorEnum { + // Enum describing possible range errors. + enum RangeError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Too low. + TOO_LOW = 2; + + // Too high. + TOO_HIGH = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/reach_plan_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/reach_plan_error.proto new file mode 100644 index 000000000..8f22c40f1 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/reach_plan_error.proto @@ -0,0 +1,45 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "ReachPlanErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing errors generated from ReachPlanService. + +// Container for enum describing possible errors returned from +// the ReachPlanService. +message ReachPlanErrorEnum { + // Enum describing possible errors from ReachPlanService. + enum ReachPlanError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/recommendation_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/recommendation_error.proto new file mode 100644 index 000000000..5dd203ba1 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/recommendation_error.proto @@ -0,0 +1,90 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "RecommendationErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing errors from applying a recommendation. + +// Container for enum describing possible errors from applying a recommendation. +message RecommendationErrorEnum { + // Enum describing possible errors from applying a recommendation. + enum RecommendationError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The specified budget amount is too low e.g. lower than minimum currency + // unit or lower than ad group minimum cost-per-click. + BUDGET_AMOUNT_TOO_SMALL = 2; + + // The specified budget amount is too large. + BUDGET_AMOUNT_TOO_LARGE = 3; + + // The specified budget amount is not a valid amount. e.g. not a multiple + // of minimum currency unit. + INVALID_BUDGET_AMOUNT = 4; + + // The specified keyword or ad violates ad policy. + POLICY_ERROR = 5; + + // The specified bid amount is not valid. e.g. too many fractional digits, + // or negative amount. + INVALID_BID_AMOUNT = 6; + + // The number of keywords in ad group have reached the maximum allowed. + ADGROUP_KEYWORD_LIMIT = 7; + + // The recommendation requested to apply has already been applied. + RECOMMENDATION_ALREADY_APPLIED = 8; + + // The recommendation requested to apply has been invalidated. + RECOMMENDATION_INVALIDATED = 9; + + // The number of operations in a single request exceeds the maximum allowed. + TOO_MANY_OPERATIONS = 10; + + // There are no operations in the request. + NO_OPERATIONS = 11; + + // Operations with multiple recommendation types are not supported when + // partial failure mode is not enabled. + DIFFERENT_TYPES_NOT_SUPPORTED = 12; + + // Request contains multiple operations with the same resource_name. + DUPLICATE_RESOURCE_NAME = 13; + + // The recommendation requested to dismiss has already been dismissed. + RECOMMENDATION_ALREADY_DISMISSED = 14; + + // The recommendation apply request was malformed and invalid. + INVALID_APPLY_REQUEST = 15; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/region_code_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/region_code_error.proto new file mode 100644 index 000000000..c6d11856f --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/region_code_error.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "RegionCodeErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing region code errors. + +// Container for enum describing possible region code errors. +message RegionCodeErrorEnum { + // Enum describing possible region code errors. + enum RegionCodeError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Invalid region code. + INVALID_REGION_CODE = 2; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/request_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/request_error.proto new file mode 100644 index 000000000..9df0d207a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/request_error.proto @@ -0,0 +1,116 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "RequestErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing request errors. + +// Container for enum describing possible request errors. +message RequestErrorEnum { + // Enum describing possible request errors. + enum RequestError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Resource name is required for this request. + RESOURCE_NAME_MISSING = 3; + + // Resource name provided is malformed. + RESOURCE_NAME_MALFORMED = 4; + + // Resource name provided is malformed. + BAD_RESOURCE_ID = 17; + + // Customer ID is invalid. + INVALID_CUSTOMER_ID = 16; + + // Mutate operation should have either create, update, or remove specified. + OPERATION_REQUIRED = 5; + + // Requested resource not found. + RESOURCE_NOT_FOUND = 6; + + // Next page token specified in user request is invalid. + INVALID_PAGE_TOKEN = 7; + + // Next page token specified in user request has expired. + EXPIRED_PAGE_TOKEN = 8; + + // Page size specified in user request is invalid. + INVALID_PAGE_SIZE = 22; + + // Required field is missing. + REQUIRED_FIELD_MISSING = 9; + + // The field cannot be modified because it's immutable. It's also possible + // that the field can be modified using 'create' operation but not 'update'. + IMMUTABLE_FIELD = 11; + + // Received too many entries in request. + TOO_MANY_MUTATE_OPERATIONS = 13; + + // Request cannot be executed by a manager account. + CANNOT_BE_EXECUTED_BY_MANAGER_ACCOUNT = 14; + + // Mutate request was attempting to modify a readonly field. + // For instance, Budget fields can be requested for Ad Group, + // but are read-only for adGroups:mutate. + CANNOT_MODIFY_FOREIGN_FIELD = 15; + + // Enum value is not permitted. + INVALID_ENUM_VALUE = 18; + + // The developer-token parameter is required for all requests. + DEVELOPER_TOKEN_PARAMETER_MISSING = 19; + + // The login-customer-id parameter is required for this request. + LOGIN_CUSTOMER_ID_PARAMETER_MISSING = 20; + + // page_token is set in the validate only request + VALIDATE_ONLY_REQUEST_HAS_PAGE_TOKEN = 21; + + // return_summary_row cannot be enabled if request did not select any + // metrics field. + CANNOT_RETURN_SUMMARY_ROW_FOR_REQUEST_WITHOUT_METRICS = 29; + + // return_summary_row should not be enabled for validate only requests. + CANNOT_RETURN_SUMMARY_ROW_FOR_VALIDATE_ONLY_REQUESTS = 30; + + // return_summary_row parameter value should be the same between requests + // with page_token field set and their original request. + INCONSISTENT_RETURN_SUMMARY_ROW_VALUE = 31; + + // The total results count cannot be returned if it was not requested in the + // original request. + TOTAL_RESULTS_COUNT_NOT_ORIGINALLY_REQUESTED = 32; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/resource_access_denied_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/resource_access_denied_error.proto new file mode 100644 index 000000000..9ec2aed30 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/resource_access_denied_error.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "ResourceAccessDeniedErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing resource access denied errors. + +// Container for enum describing possible resource access denied errors. +message ResourceAccessDeniedErrorEnum { + // Enum describing possible resource access denied errors. + enum ResourceAccessDeniedError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // User did not have write access. + WRITE_ACCESS_DENIED = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/resource_count_limit_exceeded_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/resource_count_limit_exceeded_error.proto new file mode 100644 index 000000000..de749c727 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/resource_count_limit_exceeded_error.proto @@ -0,0 +1,93 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "ResourceCountLimitExceededErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing resource count limit exceeded errors. + +// Container for enum describing possible resource count limit exceeded errors. +message ResourceCountLimitExceededErrorEnum { + // Enum describing possible resource count limit exceeded errors. + enum ResourceCountLimitExceededError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Indicates that this request would exceed the number of allowed resources + // for the Google Ads account. The exact resource type and limit being + // checked can be inferred from accountLimitType. + ACCOUNT_LIMIT = 2; + + // Indicates that this request would exceed the number of allowed resources + // in a Campaign. The exact resource type and limit being checked can be + // inferred from accountLimitType, and the numeric id of the + // Campaign involved is given by enclosingId. + CAMPAIGN_LIMIT = 3; + + // Indicates that this request would exceed the number of allowed resources + // in an ad group. The exact resource type and limit being checked can be + // inferred from accountLimitType, and the numeric id of the + // ad group involved is given by enclosingId. + ADGROUP_LIMIT = 4; + + // Indicates that this request would exceed the number of allowed resources + // in an ad group ad. The exact resource type and limit being checked can + // be inferred from accountLimitType, and the enclosingId + // contains the ad group id followed by the ad id, separated by a single + // comma (,). + AD_GROUP_AD_LIMIT = 5; + + // Indicates that this request would exceed the number of allowed resources + // in an ad group criterion. The exact resource type and limit being checked + // can be inferred from accountLimitType, and the + // enclosingId contains the ad group id followed by the + // criterion id, separated by a single comma (,). + AD_GROUP_CRITERION_LIMIT = 6; + + // Indicates that this request would exceed the number of allowed resources + // in this shared set. The exact resource type and limit being checked can + // be inferred from accountLimitType, and the numeric id of the + // shared set involved is given by enclosingId. + SHARED_SET_LIMIT = 7; + + // Exceeds a limit related to a matching function. + MATCHING_FUNCTION_LIMIT = 8; + + // The response for this request would exceed the maximum number of rows + // that can be returned. + RESPONSE_ROW_LIMIT_EXCEEDED = 9; + + // This request would exceed a limit on the number of allowed resources. + // The details of which type of limit was exceeded will eventually be + // returned in ErrorDetails. + RESOURCE_LIMIT = 10; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/setting_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/setting_error.proto new file mode 100644 index 000000000..b3fb0e035 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/setting_error.proto @@ -0,0 +1,82 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "SettingErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing setting errors. + +// Container for enum describing possible setting errors. +message SettingErrorEnum { + // Enum describing possible setting errors. + enum SettingError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The campaign setting is not available for this Google Ads account. + SETTING_TYPE_IS_NOT_AVAILABLE = 3; + + // The setting is not compatible with the campaign. + SETTING_TYPE_IS_NOT_COMPATIBLE_WITH_CAMPAIGN = 4; + + // The supplied TargetingSetting contains an invalid CriterionTypeGroup. See + // CriterionTypeGroup documentation for CriterionTypeGroups allowed + // in Campaign or AdGroup TargetingSettings. + TARGETING_SETTING_CONTAINS_INVALID_CRITERION_TYPE_GROUP = 5; + + // TargetingSetting must not explicitly + // set any of the Demographic CriterionTypeGroups (AGE_RANGE, GENDER, + // PARENT, INCOME_RANGE) to false (it's okay to not set them at all, in + // which case the system will set them to true automatically). + TARGETING_SETTING_DEMOGRAPHIC_CRITERION_TYPE_GROUPS_MUST_BE_SET_TO_TARGET_ALL = 6; + + // TargetingSetting cannot change any of + // the Demographic CriterionTypeGroups (AGE_RANGE, GENDER, PARENT, + // INCOME_RANGE) from true to false. + TARGETING_SETTING_CANNOT_CHANGE_TARGET_ALL_TO_FALSE_FOR_DEMOGRAPHIC_CRITERION_TYPE_GROUP = 7; + + // At least one feed id should be present. + DYNAMIC_SEARCH_ADS_SETTING_AT_LEAST_ONE_FEED_ID_MUST_BE_PRESENT = 8; + + // The supplied DynamicSearchAdsSetting contains an invalid domain name. + DYNAMIC_SEARCH_ADS_SETTING_CONTAINS_INVALID_DOMAIN_NAME = 9; + + // The supplied DynamicSearchAdsSetting contains a subdomain name. + DYNAMIC_SEARCH_ADS_SETTING_CONTAINS_SUBDOMAIN_NAME = 10; + + // The supplied DynamicSearchAdsSetting contains an invalid language code. + DYNAMIC_SEARCH_ADS_SETTING_CONTAINS_INVALID_LANGUAGE_CODE = 11; + + // TargetingSettings in search campaigns should not have + // CriterionTypeGroup.PLACEMENT set to targetAll. + TARGET_ALL_IS_NOT_ALLOWED_FOR_PLACEMENT_IN_SEARCH_CAMPAIGN = 12; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/shared_criterion_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/shared_criterion_error.proto new file mode 100644 index 000000000..9a3600030 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/shared_criterion_error.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "SharedCriterionErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing shared criterion errors. + +// Container for enum describing possible shared criterion errors. +message SharedCriterionErrorEnum { + // Enum describing possible shared criterion errors. + enum SharedCriterionError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The criterion is not appropriate for the shared set type. + CRITERION_TYPE_NOT_ALLOWED_FOR_SHARED_SET_TYPE = 2; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/shared_set_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/shared_set_error.proto new file mode 100644 index 000000000..b4627fca7 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/shared_set_error.proto @@ -0,0 +1,56 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "SharedSetErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing shared set errors. + +// Container for enum describing possible shared set errors. +message SharedSetErrorEnum { + // Enum describing possible shared set errors. + enum SharedSetError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The customer cannot create this type of shared set. + CUSTOMER_CANNOT_CREATE_SHARED_SET_OF_THIS_TYPE = 2; + + // A shared set with this name already exists. + DUPLICATE_NAME = 3; + + // Removed shared sets cannot be mutated. + SHARED_SET_REMOVED = 4; + + // The shared set cannot be removed because it is in use. + SHARED_SET_IN_USE = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/size_limit_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/size_limit_error.proto new file mode 100644 index 000000000..d935fc573 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/size_limit_error.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "SizeLimitErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing size limit errors. + +// Container for enum describing possible size limit errors. +message SizeLimitErrorEnum { + // Enum describing possible size limit errors. + enum SizeLimitError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The number of entries in the request exceeds the system limit. + REQUEST_SIZE_LIMIT_EXCEEDED = 2; + + // The number of entries in the response exceeds the system limit. + RESPONSE_SIZE_LIMIT_EXCEEDED = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/string_format_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/string_format_error.proto new file mode 100644 index 000000000..8381603e0 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/string_format_error.proto @@ -0,0 +1,50 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "StringFormatErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing string format errors. + +// Container for enum describing possible string format errors. +message StringFormatErrorEnum { + // Enum describing possible string format errors. + enum StringFormatError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The input string value contains disallowed characters. + ILLEGAL_CHARS = 2; + + // The input string value is invalid for the associated field. + INVALID_FORMAT = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/string_length_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/string_length_error.proto new file mode 100644 index 000000000..e178d2f6a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/string_length_error.proto @@ -0,0 +1,54 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "StringLengthErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing string length errors. + +// Container for enum describing possible string length errors. +message StringLengthErrorEnum { + // Enum describing possible string length errors. + enum StringLengthError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The specified field should have a least one non-whitespace character in + // it. + EMPTY = 4; + + // Too short. + TOO_SHORT = 2; + + // Too long. + TOO_LONG = 3; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/time_zone_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/time_zone_error.proto new file mode 100644 index 000000000..ea82b4c6b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/time_zone_error.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "TimeZoneErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing time zone errors. + +// Container for enum describing possible time zone errors. +message TimeZoneErrorEnum { + // Enum describing possible currency code errors. + enum TimeZoneError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Time zone is not valid. + INVALID_TIME_ZONE = 5; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/url_field_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/url_field_error.proto new file mode 100644 index 000000000..17678be03 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/url_field_error.proto @@ -0,0 +1,215 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "UrlFieldErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing url field errors. + +// Container for enum describing possible url field errors. +message UrlFieldErrorEnum { + // Enum describing possible url field errors. + enum UrlFieldError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // The tracking url template is invalid. + INVALID_TRACKING_URL_TEMPLATE = 2; + + // The tracking url template contains invalid tag. + INVALID_TAG_IN_TRACKING_URL_TEMPLATE = 3; + + // The tracking url template must contain at least one tag (e.g. {lpurl}), + // This applies only to tracking url template associated with website ads or + // product ads. + MISSING_TRACKING_URL_TEMPLATE_TAG = 4; + + // The tracking url template must start with a valid protocol (or lpurl + // tag). + MISSING_PROTOCOL_IN_TRACKING_URL_TEMPLATE = 5; + + // The tracking url template starts with an invalid protocol. + INVALID_PROTOCOL_IN_TRACKING_URL_TEMPLATE = 6; + + // The tracking url template contains illegal characters. + MALFORMED_TRACKING_URL_TEMPLATE = 7; + + // The tracking url template must contain a host name (or lpurl tag). + MISSING_HOST_IN_TRACKING_URL_TEMPLATE = 8; + + // The tracking url template has an invalid or missing top level domain + // extension. + INVALID_TLD_IN_TRACKING_URL_TEMPLATE = 9; + + // The tracking url template contains nested occurrences of the same + // conditional tag (i.e. {ifmobile:{ifmobile:x}}). + REDUNDANT_NESTED_TRACKING_URL_TEMPLATE_TAG = 10; + + // The final url is invalid. + INVALID_FINAL_URL = 11; + + // The final url contains invalid tag. + INVALID_TAG_IN_FINAL_URL = 12; + + // The final url contains nested occurrences of the same conditional tag + // (i.e. {ifmobile:{ifmobile:x}}). + REDUNDANT_NESTED_FINAL_URL_TAG = 13; + + // The final url must start with a valid protocol. + MISSING_PROTOCOL_IN_FINAL_URL = 14; + + // The final url starts with an invalid protocol. + INVALID_PROTOCOL_IN_FINAL_URL = 15; + + // The final url contains illegal characters. + MALFORMED_FINAL_URL = 16; + + // The final url must contain a host name. + MISSING_HOST_IN_FINAL_URL = 17; + + // The tracking url template has an invalid or missing top level domain + // extension. + INVALID_TLD_IN_FINAL_URL = 18; + + // The final mobile url is invalid. + INVALID_FINAL_MOBILE_URL = 19; + + // The final mobile url contains invalid tag. + INVALID_TAG_IN_FINAL_MOBILE_URL = 20; + + // The final mobile url contains nested occurrences of the same conditional + // tag (i.e. {ifmobile:{ifmobile:x}}). + REDUNDANT_NESTED_FINAL_MOBILE_URL_TAG = 21; + + // The final mobile url must start with a valid protocol. + MISSING_PROTOCOL_IN_FINAL_MOBILE_URL = 22; + + // The final mobile url starts with an invalid protocol. + INVALID_PROTOCOL_IN_FINAL_MOBILE_URL = 23; + + // The final mobile url contains illegal characters. + MALFORMED_FINAL_MOBILE_URL = 24; + + // The final mobile url must contain a host name. + MISSING_HOST_IN_FINAL_MOBILE_URL = 25; + + // The tracking url template has an invalid or missing top level domain + // extension. + INVALID_TLD_IN_FINAL_MOBILE_URL = 26; + + // The final app url is invalid. + INVALID_FINAL_APP_URL = 27; + + // The final app url contains invalid tag. + INVALID_TAG_IN_FINAL_APP_URL = 28; + + // The final app url contains nested occurrences of the same conditional tag + // (i.e. {ifmobile:{ifmobile:x}}). + REDUNDANT_NESTED_FINAL_APP_URL_TAG = 29; + + // More than one app url found for the same OS type. + MULTIPLE_APP_URLS_FOR_OSTYPE = 30; + + // The OS type given for an app url is not valid. + INVALID_OSTYPE = 31; + + // The protocol given for an app url is not valid. (E.g. "android-app://") + INVALID_PROTOCOL_FOR_APP_URL = 32; + + // The package id (app id) given for an app url is not valid. + INVALID_PACKAGE_ID_FOR_APP_URL = 33; + + // The number of url custom parameters for an resource exceeds the maximum + // limit allowed. + URL_CUSTOM_PARAMETERS_COUNT_EXCEEDS_LIMIT = 34; + + // An invalid character appears in the parameter key. + INVALID_CHARACTERS_IN_URL_CUSTOM_PARAMETER_KEY = 39; + + // An invalid character appears in the parameter value. + INVALID_CHARACTERS_IN_URL_CUSTOM_PARAMETER_VALUE = 40; + + // The url custom parameter value fails url tag validation. + INVALID_TAG_IN_URL_CUSTOM_PARAMETER_VALUE = 41; + + // The custom parameter contains nested occurrences of the same conditional + // tag (i.e. {ifmobile:{ifmobile:x}}). + REDUNDANT_NESTED_URL_CUSTOM_PARAMETER_TAG = 42; + + // The protocol (http:// or https://) is missing. + MISSING_PROTOCOL = 43; + + // Unsupported protocol in URL. Only http and https are supported. + INVALID_PROTOCOL = 52; + + // The url is invalid. + INVALID_URL = 44; + + // Destination Url is deprecated. + DESTINATION_URL_DEPRECATED = 45; + + // The url contains invalid tag. + INVALID_TAG_IN_URL = 46; + + // The url must contain at least one tag (e.g. {lpurl}), This applies only + // to urls associated with website ads or product ads. + MISSING_URL_TAG = 47; + + // Duplicate url id. + DUPLICATE_URL_ID = 48; + + // Invalid url id. + INVALID_URL_ID = 49; + + // The final url suffix cannot begin with '?' or '&' characters and must be + // a valid query string. + FINAL_URL_SUFFIX_MALFORMED = 50; + + // The final url suffix cannot contain {lpurl} related or {ignore} tags. + INVALID_TAG_IN_FINAL_URL_SUFFIX = 51; + + // The top level domain is invalid, e.g, not a public top level domain + // listed in publicsuffix.org. + INVALID_TOP_LEVEL_DOMAIN = 53; + + // Malformed top level domain in URL. + MALFORMED_TOP_LEVEL_DOMAIN = 54; + + // Malformed URL. + MALFORMED_URL = 55; + + // No host found in URL. + MISSING_HOST = 56; + + // Custom parameter value cannot be null. + NULL_CUSTOM_PARAMETER_VALUE = 57; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/user_data_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/user_data_error.proto new file mode 100644 index 000000000..2cb91ea94 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/user_data_error.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "UserDataErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing user data errors. + +// Container for enum describing possible user data errors. +message UserDataErrorEnum { + // Enum describing possible request errors. + enum UserDataError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Customer is not allowed to perform operations related to Customer Match. + OPERATIONS_FOR_CUSTOMER_MATCH_NOT_ALLOWED = 2; + + // Maximum number of user identifiers allowed for each mutate is 100. + TOO_MANY_USER_IDENTIFIERS = 3; + + // Current user list is not applicable for the given customer. + USER_LIST_NOT_APPLICABLE = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/user_list_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/user_list_error.proto new file mode 100644 index 000000000..86ac4e54a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/user_list_error.proto @@ -0,0 +1,129 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "UserListErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing user list errors. + +// Container for enum describing possible user list errors. +message UserListErrorEnum { + // Enum describing possible user list errors. + enum UserListError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Creating and updating external remarketing user lists is not supported. + EXTERNAL_REMARKETING_USER_LIST_MUTATE_NOT_SUPPORTED = 2; + + // Concrete type of user list is required. + CONCRETE_TYPE_REQUIRED = 3; + + // Creating/updating user list conversion types requires specifying the + // conversion type Id. + CONVERSION_TYPE_ID_REQUIRED = 4; + + // Remarketing user list cannot have duplicate conversion types. + DUPLICATE_CONVERSION_TYPES = 5; + + // Conversion type is invalid/unknown. + INVALID_CONVERSION_TYPE = 6; + + // User list description is empty or invalid. + INVALID_DESCRIPTION = 7; + + // User list name is empty or invalid. + INVALID_NAME = 8; + + // Type of the UserList does not match. + INVALID_TYPE = 9; + + // Embedded logical user lists are not allowed. + CAN_NOT_ADD_LOGICAL_LIST_AS_LOGICAL_LIST_OPERAND = 10; + + // User list rule operand is invalid. + INVALID_USER_LIST_LOGICAL_RULE_OPERAND = 11; + + // Name is already being used for another user list for the account. + NAME_ALREADY_USED = 12; + + // Name is required when creating a new conversion type. + NEW_CONVERSION_TYPE_NAME_REQUIRED = 13; + + // The given conversion type name has been used. + CONVERSION_TYPE_NAME_ALREADY_USED = 14; + + // Only an owner account may edit a user list. + OWNERSHIP_REQUIRED_FOR_SET = 15; + + // Creating user list without setting type in oneof user_list field, or + // creating/updating read-only user list types is not allowed. + USER_LIST_MUTATE_NOT_SUPPORTED = 16; + + // Rule is invalid. + INVALID_RULE = 17; + + // The specified date range is empty. + INVALID_DATE_RANGE = 27; + + // A UserList which is privacy sensitive or legal rejected cannot be mutated + // by external users. + CAN_NOT_MUTATE_SENSITIVE_USERLIST = 28; + + // Maximum number of rulebased user lists a customer can have. + MAX_NUM_RULEBASED_USERLISTS = 29; + + // BasicUserList's billable record field cannot be modified once it is set. + CANNOT_MODIFY_BILLABLE_RECORD_COUNT = 30; + + // crm_based_user_list.app_id field must be set when upload_key_type is + // MOBILE_ADVERTISING_ID. + APP_ID_NOT_SET = 31; + + // Name of the user list is reserved for system generated lists and cannot + // be used. + USERLIST_NAME_IS_RESERVED_FOR_SYSTEM_LIST = 32; + + // Advertiser needs to be whitelisted to use remarketing lists created from + // advertiser uploaded data (e.g., Customer Match lists). + ADVERTISER_NOT_WHITELISTED_FOR_USING_UPLOADED_DATA = 33; + + // The provided rule_type is not supported for the user list. + RULE_TYPE_IS_NOT_SUPPORTED = 34; + + // Similar user list cannot be used as a logical user list operand. + CAN_NOT_ADD_A_SIMILAR_USERLIST_AS_LOGICAL_LIST_OPERAND = 35; + + // Logical user list should not have a mix of CRM based user list and other + // types of lists in its rules. + CAN_NOT_MIX_CRM_BASED_IN_LOGICAL_LIST_WITH_OTHER_LISTS = 36; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/errors/youtube_video_registration_error.proto b/third_party/googleapis/google/ads/googleads/v3/errors/youtube_video_registration_error.proto new file mode 100644 index 000000000..1e189778e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/errors/youtube_video_registration_error.proto @@ -0,0 +1,53 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.errors; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Errors"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/errors;errors"; +option java_multiple_files = true; +option java_outer_classname = "YoutubeVideoRegistrationErrorProto"; +option java_package = "com.google.ads.googleads.v3.errors"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Errors"; +option ruby_package = "Google::Ads::GoogleAds::V3::Errors"; + +// Proto file describing YouTube video registration errors. + +// Container for enum describing YouTube video registration errors. +message YoutubeVideoRegistrationErrorEnum { + // Enum describing YouTube video registration errors. + enum YoutubeVideoRegistrationError { + // Enum unspecified. + UNSPECIFIED = 0; + + // The received error code is not known in this version. + UNKNOWN = 1; + + // Video to be registered wasn't found. + VIDEO_NOT_FOUND = 2; + + // Video to be registered is not accessible (e.g. private). + VIDEO_NOT_ACCESSIBLE = 3; + + // Video to be registered is not eligible (e.g. mature content). + VIDEO_NOT_ELIGIBLE = 4; + } + + +} diff --git a/third_party/googleapis/google/ads/googleads/v3/googleads_gapic.yaml b/third_party/googleapis/google/ads/googleads/v3/googleads_gapic.yaml new file mode 100644 index 000000000..f8a3ee9f9 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/googleads_gapic.yaml @@ -0,0 +1,26 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 2.0.0 +language_settings: + csharp: + package_name: Google.Ads.GoogleAds.V3.Services + go: + package_name: google.golang.org/google/ads/googleads/v3/services + java: + package_name: com.google.ads.googleads.v3.services + nodejs: + package_name: v3.services + php: + package_name: Google\Ads\Googleads\V3\Services + python: + package_name: google.ads.googleads_v3.gapic.services + ruby: + package_name: Google::Ads::Googleads::V3::Services +interfaces: +- name: google.ads.googleads.v3.services.OfflineUserDataJobService + methods: + - name: RunOfflineUserDataJob + long_running: + initial_poll_delay_millis: 300000 + max_poll_delay_millis: 3600000 + poll_delay_multiplier: 1.25 + total_poll_timeout_millis: 43200000 diff --git a/third_party/googleapis/google/ads/googleads/v3/googleads_grpc_service_config.json b/third_party/googleapis/google/ads/googleads/v3/googleads_grpc_service_config.json new file mode 100644 index 000000000..21058f828 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/googleads_grpc_service_config.json @@ -0,0 +1,127 @@ +{ + "methodConfig": [ + { + "name": [ + { "service": "google.ads.googleads.v3.services.AccountBudgetProposalService" }, + { "service": "google.ads.googleads.v3.services.AccountBudgetService" }, + { "service": "google.ads.googleads.v3.services.AdGroupAdAssetViewService" }, + { "service": "google.ads.googleads.v3.services.AdGroupAdLabelService" }, + { "service": "google.ads.googleads.v3.services.AdGroupAdService" }, + { "service": "google.ads.googleads.v3.services.AdGroupAudienceViewService" }, + { "service": "google.ads.googleads.v3.services.AdGroupBidModifierService" }, + { "service": "google.ads.googleads.v3.services.AdGroupCriterionLabelService" }, + { "service": "google.ads.googleads.v3.services.AdGroupCriterionService" }, + { "service": "google.ads.googleads.v3.services.AdGroupCriterionSimulationService" }, + { "service": "google.ads.googleads.v3.services.AdGroupExtensionSettingService" }, + { "service": "google.ads.googleads.v3.services.AdGroupFeedService" }, + { "service": "google.ads.googleads.v3.services.AdGroupLabelService" }, + { "service": "google.ads.googleads.v3.services.AdGroupService" }, + { "service": "google.ads.googleads.v3.services.AdGroupSimulationService" }, + { "service": "google.ads.googleads.v3.services.AdParameterService" }, + { "service": "google.ads.googleads.v3.services.AdScheduleViewService" }, + { "service": "google.ads.googleads.v3.services.AdService" }, + { "service": "google.ads.googleads.v3.services.AgeRangeViewService" }, + { "service": "google.ads.googleads.v3.services.AssetService" }, + { "service": "google.ads.googleads.v3.services.BiddingStrategyService" }, + { "service": "google.ads.googleads.v3.services.BillingSetupService" }, + { "service": "google.ads.googleads.v3.services.CampaignAudienceViewService" }, + { "service": "google.ads.googleads.v3.services.CampaignBidModifierService" }, + { "service": "google.ads.googleads.v3.services.CampaignBudgetService" }, + { "service": "google.ads.googleads.v3.services.CampaignCriterionService" }, + { "service": "google.ads.googleads.v3.services.CampaignCriterionSimulationService" }, + { "service": "google.ads.googleads.v3.services.CampaignDraftService" }, + { "service": "google.ads.googleads.v3.services.CampaignExperimentService" }, + { "service": "google.ads.googleads.v3.services.CampaignExtensionSettingService" }, + { "service": "google.ads.googleads.v3.services.CampaignFeedService" }, + { "service": "google.ads.googleads.v3.services.CampaignLabelService" }, + { "service": "google.ads.googleads.v3.services.CampaignService" }, + { "service": "google.ads.googleads.v3.services.CampaignSharedSetService" }, + { "service": "google.ads.googleads.v3.services.CarrierConstantService" }, + { "service": "google.ads.googleads.v3.services.ChangeStatusService" }, + { "service": "google.ads.googleads.v3.services.ClickViewService" }, + { "service": "google.ads.googleads.v3.services.ConversionActionService" }, + { "service": "google.ads.googleads.v3.services.ConversionAdjustmentUploadService" }, + { "service": "google.ads.googleads.v3.services.ConversionUploadService" }, + { "service": "google.ads.googleads.v3.services.CurrencyConstantService" }, + { "service": "google.ads.googleads.v3.services.CustomInterestService" }, + { "service": "google.ads.googleads.v3.services.CustomerClientLinkService" }, + { "service": "google.ads.googleads.v3.services.CustomerClientService" }, + { "service": "google.ads.googleads.v3.services.CustomerExtensionSettingService" }, + { "service": "google.ads.googleads.v3.services.CustomerFeedService" }, + { "service": "google.ads.googleads.v3.services.CustomerLabelService" }, + { "service": "google.ads.googleads.v3.services.CustomerManagerLinkService" }, + { "service": "google.ads.googleads.v3.services.CustomerNegativeCriterionService" }, + { "service": "google.ads.googleads.v3.services.CustomerService" }, + { "service": "google.ads.googleads.v3.services.DetailPlacementViewService" }, + { "service": "google.ads.googleads.v3.services.DisplayKeywordViewService" }, + { "service": "google.ads.googleads.v3.services.DistanceViewService" }, + { "service": "google.ads.googleads.v3.services.DomainCategoryService" }, + { "service": "google.ads.googleads.v3.services.DynamicSearchAdsSearchTermViewService" }, + { "service": "google.ads.googleads.v3.services.ExpandedLandingPageViewService" }, + { "service": "google.ads.googleads.v3.services.ExtensionFeedItemService" }, + { "service": "google.ads.googleads.v3.services.FeedItemService" }, + { "service": "google.ads.googleads.v3.services.FeedItemTargetService" }, + { "service": "google.ads.googleads.v3.services.FeedMappingService" }, + { "service": "google.ads.googleads.v3.services.FeedPlaceholderViewService" }, + { "service": "google.ads.googleads.v3.services.FeedService" }, + { "service": "google.ads.googleads.v3.services.GenderViewService" }, + { "service": "google.ads.googleads.v3.services.GeoTargetConstantService" }, + { "service": "google.ads.googleads.v3.services.GeographicViewService" }, + { "service": "google.ads.googleads.v3.services.GoogleAdsFieldService" }, + { "service": "google.ads.googleads.v3.services.GoogleAdsService" }, + { "service": "google.ads.googleads.v3.services.GroupPlacementViewService" }, + { "service": "google.ads.googleads.v3.services.HotelGroupViewService" }, + { "service": "google.ads.googleads.v3.services.HotelPerformanceViewService" }, + { "service": "google.ads.googleads.v3.services.InvoiceService" }, + { "service": "google.ads.googleads.v3.services.KeywordPlanAdGroupService" }, + { "service": "google.ads.googleads.v3.services.KeywordPlanCampaignService" }, + { "service": "google.ads.googleads.v3.services.KeywordPlanIdeaService" }, + { "service": "google.ads.googleads.v3.services.KeywordPlanKeywordService" }, + { "service": "google.ads.googleads.v3.services.KeywordPlanNegativeKeywordService" }, + { "service": "google.ads.googleads.v3.services.KeywordPlanService" }, + { "service": "google.ads.googleads.v3.services.KeywordViewService" }, + { "service": "google.ads.googleads.v3.services.LabelService" }, + { "service": "google.ads.googleads.v3.services.LandingPageViewService" }, + { "service": "google.ads.googleads.v3.services.LanguageConstantService" }, + { "service": "google.ads.googleads.v3.services.LocationViewService" }, + { "service": "google.ads.googleads.v3.services.ManagedPlacementViewService" }, + { "service": "google.ads.googleads.v3.services.MediaFileService" }, + { "service": "google.ads.googleads.v3.services.MerchantCenterLinkService" }, + { "service": "google.ads.googleads.v3.services.MobileAppCategoryConstantService" }, + { "service": "google.ads.googleads.v3.services.MobileDeviceConstantService" }, + { "service": "google.ads.googleads.v3.services.MutateJobService" }, + { "service": "google.ads.googleads.v3.services.OfflineUserDataJobService" }, + { "service": "google.ads.googleads.v3.services.OperatingSystemVersionConstantService" }, + { "service": "google.ads.googleads.v3.services.PaidOrganicSearchTermViewService" }, + { "service": "google.ads.googleads.v3.services.ParentalStatusViewService" }, + { "service": "google.ads.googleads.v3.services.PaymentsAccountService" }, + { "service": "google.ads.googleads.v3.services.ProductBiddingCategoryConstantService" }, + { "service": "google.ads.googleads.v3.services.ProductGroupViewService" }, + { "service": "google.ads.googleads.v3.services.ReachPlanService" }, + { "service": "google.ads.googleads.v3.services.RecommendationService" }, + { "service": "google.ads.googleads.v3.services.RemarketingActionService" }, + { "service": "google.ads.googleads.v3.services.SearchTermViewService" }, + { "service": "google.ads.googleads.v3.services.SharedCriterionService" }, + { "service": "google.ads.googleads.v3.services.SharedSetService" }, + { "service": "google.ads.googleads.v3.services.ShoppingPerformanceViewService" }, + { "service": "google.ads.googleads.v3.services.TopicConstantService" }, + { "service": "google.ads.googleads.v3.services.TopicViewService" }, + { "service": "google.ads.googleads.v3.services.UserDataService" }, + { "service": "google.ads.googleads.v3.services.UserInterestService" }, + { "service": "google.ads.googleads.v3.services.UserListService" }, + { "service": "google.ads.googleads.v3.services.UserLocationViewService" }, + { "service": "google.ads.googleads.v3.services.VideoService" } + ], + "timeout": "3600s", + "retryPolicy": { + "initialBackoff": "5s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/ads/googleads/v3/googleads_v3.yaml b/third_party/googleapis/google/ads/googleads/v3/googleads_v3.yaml new file mode 100644 index 000000000..33c6b94cd --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/googleads_v3.yaml @@ -0,0 +1,458 @@ +type: google.api.Service +config_version: 3 +name: googleads.googleapis.com +title: Google Ads API + +apis: +- name: google.ads.googleads.v3.services.AccountBudgetProposalService +- name: google.ads.googleads.v3.services.AccountBudgetService +- name: google.ads.googleads.v3.services.AdGroupAdAssetViewService +- name: google.ads.googleads.v3.services.AdGroupAdLabelService +- name: google.ads.googleads.v3.services.AdGroupAdService +- name: google.ads.googleads.v3.services.AdGroupAudienceViewService +- name: google.ads.googleads.v3.services.AdGroupBidModifierService +- name: google.ads.googleads.v3.services.AdGroupCriterionLabelService +- name: google.ads.googleads.v3.services.AdGroupCriterionService +- name: google.ads.googleads.v3.services.AdGroupCriterionSimulationService +- name: google.ads.googleads.v3.services.AdGroupExtensionSettingService +- name: google.ads.googleads.v3.services.AdGroupFeedService +- name: google.ads.googleads.v3.services.AdGroupLabelService +- name: google.ads.googleads.v3.services.AdGroupService +- name: google.ads.googleads.v3.services.AdGroupSimulationService +- name: google.ads.googleads.v3.services.AdParameterService +- name: google.ads.googleads.v3.services.AdScheduleViewService +- name: google.ads.googleads.v3.services.AdService +- name: google.ads.googleads.v3.services.AgeRangeViewService +- name: google.ads.googleads.v3.services.AssetService +- name: google.ads.googleads.v3.services.BiddingStrategyService +- name: google.ads.googleads.v3.services.BillingSetupService +- name: google.ads.googleads.v3.services.CampaignAudienceViewService +- name: google.ads.googleads.v3.services.CampaignBidModifierService +- name: google.ads.googleads.v3.services.CampaignBudgetService +- name: google.ads.googleads.v3.services.CampaignCriterionService +- name: google.ads.googleads.v3.services.CampaignCriterionSimulationService +- name: google.ads.googleads.v3.services.CampaignDraftService +- name: google.ads.googleads.v3.services.CampaignExperimentService +- name: google.ads.googleads.v3.services.CampaignExtensionSettingService +- name: google.ads.googleads.v3.services.CampaignFeedService +- name: google.ads.googleads.v3.services.CampaignLabelService +- name: google.ads.googleads.v3.services.CampaignService +- name: google.ads.googleads.v3.services.CampaignSharedSetService +- name: google.ads.googleads.v3.services.CarrierConstantService +- name: google.ads.googleads.v3.services.ChangeStatusService +- name: google.ads.googleads.v3.services.ClickViewService +- name: google.ads.googleads.v3.services.ConversionActionService +- name: google.ads.googleads.v3.services.ConversionAdjustmentUploadService +- name: google.ads.googleads.v3.services.ConversionUploadService +- name: google.ads.googleads.v3.services.CurrencyConstantService +- name: google.ads.googleads.v3.services.CustomInterestService +- name: google.ads.googleads.v3.services.CustomerClientLinkService +- name: google.ads.googleads.v3.services.CustomerClientService +- name: google.ads.googleads.v3.services.CustomerExtensionSettingService +- name: google.ads.googleads.v3.services.CustomerFeedService +- name: google.ads.googleads.v3.services.CustomerLabelService +- name: google.ads.googleads.v3.services.CustomerManagerLinkService +- name: google.ads.googleads.v3.services.CustomerNegativeCriterionService +- name: google.ads.googleads.v3.services.CustomerService +- name: google.ads.googleads.v3.services.DetailPlacementViewService +- name: google.ads.googleads.v3.services.DisplayKeywordViewService +- name: google.ads.googleads.v3.services.DistanceViewService +- name: google.ads.googleads.v3.services.DomainCategoryService +- name: google.ads.googleads.v3.services.DynamicSearchAdsSearchTermViewService +- name: google.ads.googleads.v3.services.ExpandedLandingPageViewService +- name: google.ads.googleads.v3.services.ExtensionFeedItemService +- name: google.ads.googleads.v3.services.FeedItemService +- name: google.ads.googleads.v3.services.FeedItemTargetService +- name: google.ads.googleads.v3.services.FeedMappingService +- name: google.ads.googleads.v3.services.FeedPlaceholderViewService +- name: google.ads.googleads.v3.services.FeedService +- name: google.ads.googleads.v3.services.GenderViewService +- name: google.ads.googleads.v3.services.GeoTargetConstantService +- name: google.ads.googleads.v3.services.GeographicViewService +- name: google.ads.googleads.v3.services.GoogleAdsFieldService +- name: google.ads.googleads.v3.services.GoogleAdsService +- name: google.ads.googleads.v3.services.GroupPlacementViewService +- name: google.ads.googleads.v3.services.HotelGroupViewService +- name: google.ads.googleads.v3.services.HotelPerformanceViewService +- name: google.ads.googleads.v3.services.InvoiceService +- name: google.ads.googleads.v3.services.KeywordPlanAdGroupService +- name: google.ads.googleads.v3.services.KeywordPlanCampaignService +- name: google.ads.googleads.v3.services.KeywordPlanIdeaService +- name: google.ads.googleads.v3.services.KeywordPlanKeywordService +- name: google.ads.googleads.v3.services.KeywordPlanNegativeKeywordService +- name: google.ads.googleads.v3.services.KeywordPlanService +- name: google.ads.googleads.v3.services.KeywordViewService +- name: google.ads.googleads.v3.services.LabelService +- name: google.ads.googleads.v3.services.LandingPageViewService +- name: google.ads.googleads.v3.services.LanguageConstantService +- name: google.ads.googleads.v3.services.LocationViewService +- name: google.ads.googleads.v3.services.ManagedPlacementViewService +- name: google.ads.googleads.v3.services.MediaFileService +- name: google.ads.googleads.v3.services.MerchantCenterLinkService +- name: google.ads.googleads.v3.services.MobileAppCategoryConstantService +- name: google.ads.googleads.v3.services.MobileDeviceConstantService +- name: google.ads.googleads.v3.services.MutateJobService +- name: google.ads.googleads.v3.services.OfflineUserDataJobService +- name: google.ads.googleads.v3.services.OperatingSystemVersionConstantService +- name: google.ads.googleads.v3.services.PaidOrganicSearchTermViewService +- name: google.ads.googleads.v3.services.ParentalStatusViewService +- name: google.ads.googleads.v3.services.PaymentsAccountService +- name: google.ads.googleads.v3.services.ProductBiddingCategoryConstantService +- name: google.ads.googleads.v3.services.ProductGroupViewService +- name: google.ads.googleads.v3.services.ReachPlanService +- name: google.ads.googleads.v3.services.RecommendationService +- name: google.ads.googleads.v3.services.RemarketingActionService +- name: google.ads.googleads.v3.services.SearchTermViewService +- name: google.ads.googleads.v3.services.SharedCriterionService +- name: google.ads.googleads.v3.services.SharedSetService +- name: google.ads.googleads.v3.services.ShoppingPerformanceViewService +- name: google.ads.googleads.v3.services.TopicConstantService +- name: google.ads.googleads.v3.services.TopicViewService +- name: google.ads.googleads.v3.services.UserDataService +- name: google.ads.googleads.v3.services.UserInterestService +- name: google.ads.googleads.v3.services.UserListService +- name: google.ads.googleads.v3.services.UserLocationViewService +- name: google.ads.googleads.v3.services.VideoService + +types: +- name: google.ads.googleads.v3.errors.GoogleAdsFailure +- name: google.ads.googleads.v3.resources.MutateJob.MutateJobMetadata +- name: google.ads.googleads.v3.services.CreateCampaignExperimentMetadata + +documentation: + summary: |- + Manage your AdWords accounts, campaigns, and reports with this REST-based + API. + overview: |- + # This warning always fires when the last path segment of packages is not + + # the version + +backend: + rules: + - selector: google.ads.googleads.v3.services.AccountBudgetProposalService.GetAccountBudgetProposal + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AccountBudgetProposalService.MutateAccountBudgetProposal + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AccountBudgetService.GetAccountBudget + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdGroupAdAssetViewService.GetAdGroupAdAssetView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdGroupAdLabelService.GetAdGroupAdLabel + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdGroupAdLabelService.MutateAdGroupAdLabels + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdGroupAdService.GetAdGroupAd + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdGroupAdService.MutateAdGroupAds + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdGroupAudienceViewService.GetAdGroupAudienceView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdGroupBidModifierService.GetAdGroupBidModifier + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdGroupBidModifierService.MutateAdGroupBidModifiers + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdGroupCriterionLabelService.GetAdGroupCriterionLabel + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdGroupCriterionLabelService.MutateAdGroupCriterionLabels + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdGroupCriterionService.GetAdGroupCriterion + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdGroupCriterionService.MutateAdGroupCriteria + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdGroupCriterionSimulationService.GetAdGroupCriterionSimulation + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdGroupExtensionSettingService.GetAdGroupExtensionSetting + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdGroupExtensionSettingService.MutateAdGroupExtensionSettings + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdGroupFeedService.GetAdGroupFeed + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdGroupFeedService.MutateAdGroupFeeds + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdGroupLabelService.GetAdGroupLabel + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdGroupLabelService.MutateAdGroupLabels + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdGroupService.GetAdGroup + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdGroupService.MutateAdGroups + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdGroupSimulationService.GetAdGroupSimulation + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdParameterService.GetAdParameter + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdParameterService.MutateAdParameters + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdScheduleViewService.GetAdScheduleView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdService.GetAd + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AdService.MutateAds + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AgeRangeViewService.GetAgeRangeView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AssetService.GetAsset + deadline: 60.0 + - selector: google.ads.googleads.v3.services.AssetService.MutateAssets + deadline: 60.0 + - selector: google.ads.googleads.v3.services.BiddingStrategyService.GetBiddingStrategy + deadline: 60.0 + - selector: google.ads.googleads.v3.services.BiddingStrategyService.MutateBiddingStrategies + deadline: 60.0 + - selector: google.ads.googleads.v3.services.BillingSetupService.GetBillingSetup + deadline: 60.0 + - selector: google.ads.googleads.v3.services.BillingSetupService.MutateBillingSetup + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CampaignAudienceViewService.GetCampaignAudienceView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CampaignBidModifierService.GetCampaignBidModifier + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CampaignBidModifierService.MutateCampaignBidModifiers + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CampaignBudgetService.GetCampaignBudget + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CampaignBudgetService.MutateCampaignBudgets + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CampaignCriterionService.GetCampaignCriterion + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CampaignCriterionService.MutateCampaignCriteria + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CampaignCriterionSimulationService.GetCampaignCriterionSimulation + deadline: 60.0 + - selector: 'google.ads.googleads.v3.services.CampaignDraftService.*' + deadline: 60.0 + - selector: 'google.ads.googleads.v3.services.CampaignExperimentService.*' + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CampaignExtensionSettingService.GetCampaignExtensionSetting + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CampaignExtensionSettingService.MutateCampaignExtensionSettings + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CampaignFeedService.GetCampaignFeed + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CampaignFeedService.MutateCampaignFeeds + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CampaignLabelService.GetCampaignLabel + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CampaignLabelService.MutateCampaignLabels + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CampaignService.GetCampaign + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CampaignService.MutateCampaigns + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CampaignSharedSetService.GetCampaignSharedSet + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CampaignSharedSetService.MutateCampaignSharedSets + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CarrierConstantService.GetCarrierConstant + deadline: 60.0 + - selector: google.ads.googleads.v3.services.ChangeStatusService.GetChangeStatus + deadline: 60.0 + - selector: google.ads.googleads.v3.services.ClickViewService.GetClickView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.ConversionActionService.GetConversionAction + deadline: 60.0 + - selector: google.ads.googleads.v3.services.ConversionActionService.MutateConversionActions + deadline: 60.0 + - selector: google.ads.googleads.v3.services.ConversionAdjustmentUploadService.UploadConversionAdjustments + deadline: 60.0 + - selector: google.ads.googleads.v3.services.ConversionUploadService.UploadCallConversions + deadline: 60.0 + - selector: google.ads.googleads.v3.services.ConversionUploadService.UploadClickConversions + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CurrencyConstantService.GetCurrencyConstant + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CustomInterestService.GetCustomInterest + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CustomInterestService.MutateCustomInterests + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CustomerClientLinkService.GetCustomerClientLink + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CustomerClientLinkService.MutateCustomerClientLink + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CustomerClientService.GetCustomerClient + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CustomerExtensionSettingService.GetCustomerExtensionSetting + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CustomerExtensionSettingService.MutateCustomerExtensionSettings + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CustomerFeedService.GetCustomerFeed + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CustomerFeedService.MutateCustomerFeeds + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CustomerLabelService.GetCustomerLabel + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CustomerLabelService.MutateCustomerLabels + deadline: 60.0 + - selector: 'google.ads.googleads.v3.services.CustomerManagerLinkService.*' + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CustomerNegativeCriterionService.GetCustomerNegativeCriterion + deadline: 60.0 + - selector: google.ads.googleads.v3.services.CustomerNegativeCriterionService.MutateCustomerNegativeCriteria + deadline: 60.0 + - selector: 'google.ads.googleads.v3.services.CustomerService.*' + deadline: 60.0 + - selector: google.ads.googleads.v3.services.DetailPlacementViewService.GetDetailPlacementView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.DisplayKeywordViewService.GetDisplayKeywordView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.DistanceViewService.GetDistanceView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.DomainCategoryService.GetDomainCategory + deadline: 60.0 + - selector: google.ads.googleads.v3.services.DynamicSearchAdsSearchTermViewService.GetDynamicSearchAdsSearchTermView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.ExpandedLandingPageViewService.GetExpandedLandingPageView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.ExtensionFeedItemService.GetExtensionFeedItem + deadline: 60.0 + - selector: google.ads.googleads.v3.services.ExtensionFeedItemService.MutateExtensionFeedItems + deadline: 60.0 + - selector: google.ads.googleads.v3.services.FeedItemService.GetFeedItem + deadline: 60.0 + - selector: google.ads.googleads.v3.services.FeedItemService.MutateFeedItems + deadline: 60.0 + - selector: google.ads.googleads.v3.services.FeedItemTargetService.GetFeedItemTarget + deadline: 60.0 + - selector: google.ads.googleads.v3.services.FeedItemTargetService.MutateFeedItemTargets + deadline: 60.0 + - selector: google.ads.googleads.v3.services.FeedMappingService.GetFeedMapping + deadline: 60.0 + - selector: google.ads.googleads.v3.services.FeedMappingService.MutateFeedMappings + deadline: 60.0 + - selector: google.ads.googleads.v3.services.FeedPlaceholderViewService.GetFeedPlaceholderView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.FeedService.GetFeed + deadline: 60.0 + - selector: google.ads.googleads.v3.services.FeedService.MutateFeeds + deadline: 60.0 + - selector: google.ads.googleads.v3.services.GenderViewService.GetGenderView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.GeoTargetConstantService.GetGeoTargetConstant + deadline: 60.0 + - selector: google.ads.googleads.v3.services.GeoTargetConstantService.SuggestGeoTargetConstants + deadline: 60.0 + - selector: google.ads.googleads.v3.services.GeographicViewService.GetGeographicView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.GoogleAdsFieldService.GetGoogleAdsField + deadline: 600.0 + - selector: google.ads.googleads.v3.services.GoogleAdsFieldService.SearchGoogleAdsFields + deadline: 600.0 + - selector: google.ads.googleads.v3.services.GoogleAdsService.Mutate + deadline: 600.0 + - selector: google.ads.googleads.v3.services.GoogleAdsService.Search + deadline: 3600.0 + - selector: google.ads.googleads.v3.services.GoogleAdsService.SearchStream + deadline: 3600.0 + - selector: google.ads.googleads.v3.services.GroupPlacementViewService.GetGroupPlacementView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.HotelGroupViewService.GetHotelGroupView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.HotelPerformanceViewService.GetHotelPerformanceView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.InvoiceService.ListInvoices + deadline: 60.0 + - selector: google.ads.googleads.v3.services.KeywordPlanAdGroupService.GetKeywordPlanAdGroup + deadline: 60.0 + - selector: google.ads.googleads.v3.services.KeywordPlanAdGroupService.MutateKeywordPlanAdGroups + deadline: 60.0 + - selector: google.ads.googleads.v3.services.KeywordPlanCampaignService.GetKeywordPlanCampaign + deadline: 60.0 + - selector: google.ads.googleads.v3.services.KeywordPlanCampaignService.MutateKeywordPlanCampaigns + deadline: 60.0 + - selector: google.ads.googleads.v3.services.KeywordPlanIdeaService.GenerateKeywordIdeas + deadline: 600.0 + - selector: google.ads.googleads.v3.services.KeywordPlanKeywordService.GetKeywordPlanKeyword + deadline: 60.0 + - selector: google.ads.googleads.v3.services.KeywordPlanKeywordService.MutateKeywordPlanKeywords + deadline: 60.0 + - selector: google.ads.googleads.v3.services.KeywordPlanNegativeKeywordService.GetKeywordPlanNegativeKeyword + deadline: 60.0 + - selector: google.ads.googleads.v3.services.KeywordPlanNegativeKeywordService.MutateKeywordPlanNegativeKeywords + deadline: 60.0 + - selector: google.ads.googleads.v3.services.KeywordPlanService.GenerateForecastMetrics + deadline: 600.0 + - selector: google.ads.googleads.v3.services.KeywordPlanService.GenerateHistoricalMetrics + deadline: 600.0 + - selector: google.ads.googleads.v3.services.KeywordPlanService.GetKeywordPlan + deadline: 60.0 + - selector: google.ads.googleads.v3.services.KeywordPlanService.MutateKeywordPlans + deadline: 60.0 + - selector: google.ads.googleads.v3.services.KeywordViewService.GetKeywordView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.LabelService.GetLabel + deadline: 60.0 + - selector: google.ads.googleads.v3.services.LabelService.MutateLabels + deadline: 60.0 + - selector: google.ads.googleads.v3.services.LandingPageViewService.GetLandingPageView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.LanguageConstantService.GetLanguageConstant + deadline: 60.0 + - selector: google.ads.googleads.v3.services.LocationViewService.GetLocationView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.ManagedPlacementViewService.GetManagedPlacementView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.MediaFileService.GetMediaFile + deadline: 60.0 + - selector: google.ads.googleads.v3.services.MediaFileService.MutateMediaFiles + deadline: 60.0 + - selector: 'google.ads.googleads.v3.services.MerchantCenterLinkService.*' + deadline: 60.0 + - selector: google.ads.googleads.v3.services.MobileAppCategoryConstantService.GetMobileAppCategoryConstant + deadline: 60.0 + - selector: google.ads.googleads.v3.services.MobileDeviceConstantService.GetMobileDeviceConstant + deadline: 60.0 + - selector: 'google.ads.googleads.v3.services.MutateJobService.*' + deadline: 60.0 + - selector: 'google.ads.googleads.v3.services.OfflineUserDataJobService.*' + deadline: 600.0 + - selector: google.ads.googleads.v3.services.OperatingSystemVersionConstantService.GetOperatingSystemVersionConstant + deadline: 60.0 + - selector: google.ads.googleads.v3.services.PaidOrganicSearchTermViewService.GetPaidOrganicSearchTermView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.ParentalStatusViewService.GetParentalStatusView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.PaymentsAccountService.ListPaymentsAccounts + deadline: 60.0 + - selector: google.ads.googleads.v3.services.ProductBiddingCategoryConstantService.GetProductBiddingCategoryConstant + deadline: 60.0 + - selector: google.ads.googleads.v3.services.ProductGroupViewService.GetProductGroupView + deadline: 60.0 + - selector: 'google.ads.googleads.v3.services.ReachPlanService.*' + deadline: 600.0 + - selector: 'google.ads.googleads.v3.services.RecommendationService.*' + deadline: 600.0 + - selector: google.ads.googleads.v3.services.RemarketingActionService.GetRemarketingAction + deadline: 60.0 + - selector: google.ads.googleads.v3.services.RemarketingActionService.MutateRemarketingActions + deadline: 60.0 + - selector: google.ads.googleads.v3.services.SearchTermViewService.GetSearchTermView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.SharedCriterionService.GetSharedCriterion + deadline: 60.0 + - selector: google.ads.googleads.v3.services.SharedCriterionService.MutateSharedCriteria + deadline: 60.0 + - selector: google.ads.googleads.v3.services.SharedSetService.GetSharedSet + deadline: 60.0 + - selector: google.ads.googleads.v3.services.SharedSetService.MutateSharedSets + deadline: 60.0 + - selector: google.ads.googleads.v3.services.ShoppingPerformanceViewService.GetShoppingPerformanceView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.TopicConstantService.GetTopicConstant + deadline: 60.0 + - selector: google.ads.googleads.v3.services.TopicViewService.GetTopicView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.UserDataService.UploadUserData + deadline: 600.0 + - selector: google.ads.googleads.v3.services.UserInterestService.GetUserInterest + deadline: 60.0 + - selector: google.ads.googleads.v3.services.UserListService.GetUserList + deadline: 60.0 + - selector: google.ads.googleads.v3.services.UserListService.MutateUserLists + deadline: 60.0 + - selector: google.ads.googleads.v3.services.UserLocationViewService.GetUserLocationView + deadline: 60.0 + - selector: google.ads.googleads.v3.services.VideoService.GetVideo + deadline: 60.0 + - selector: 'google.longrunning.Operations.*' + deadline: 60.0 diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/account_budget.proto b/third_party/googleapis/google/ads/googleads/v3/resources/account_budget.proto new file mode 100644 index 000000000..1b12d891e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/account_budget.proto @@ -0,0 +1,253 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/account_budget_proposal_type.proto"; +import "google/ads/googleads/v3/enums/account_budget_status.proto"; +import "google/ads/googleads/v3/enums/spending_limit_type.proto"; +import "google/ads/googleads/v3/enums/time_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "AccountBudgetProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the AccountBudget resource. + +// An account-level budget. It contains information about the budget itself, +// as well as the most recently approved changes to the budget and proposed +// changes that are pending approval. The proposed changes that are pending +// approval, if any, are found in 'pending_proposal'. Effective details about +// the budget are found in fields prefixed 'approved_', 'adjusted_' and those +// without a prefix. Since some effective details may differ from what the user +// had originally requested (e.g. spending limit), these differences are +// juxtaposed via 'proposed_', 'approved_', and possibly 'adjusted_' fields. +// +// This resource is mutated using AccountBudgetProposal and cannot be mutated +// directly. A budget may have at most one pending proposal at any given time. +// It is read through pending_proposal. +// +// Once approved, a budget may be subject to adjustments, such as credit +// adjustments. Adjustments create differences between the 'approved' and +// 'adjusted' fields, which would otherwise be identical. +message AccountBudget { + option (google.api.resource) = { + type: "googleads.googleapis.com/AccountBudget" + pattern: "customers/{customer}/accountBudgets/{account_budget}" + }; + + // A pending proposal associated with the enclosing account-level budget, + // if applicable. + message PendingAccountBudgetProposal { + // Output only. The resource name of the proposal. + // AccountBudgetProposal resource names have the form: + // + // `customers/{customer_id}/accountBudgetProposals/{account_budget_proposal_id}` + google.protobuf.StringValue account_budget_proposal = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AccountBudgetProposal" + } + ]; + + // Output only. The type of this proposal, e.g. END to end the budget associated + // with this proposal. + google.ads.googleads.v3.enums.AccountBudgetProposalTypeEnum.AccountBudgetProposalType proposal_type = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The name to assign to the account-level budget. + google.protobuf.StringValue name = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The start time in yyyy-MM-dd HH:mm:ss format. + google.protobuf.StringValue start_date_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. A purchase order number is a value that helps users reference this budget + // in their monthly invoices. + google.protobuf.StringValue purchase_order_number = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Notes associated with this budget. + google.protobuf.StringValue notes = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The time when this account-level budget proposal was created. + // Formatted as yyyy-MM-dd HH:mm:ss. + google.protobuf.StringValue creation_date_time = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The end time of the account-level budget. + oneof end_time { + // Output only. The end time in yyyy-MM-dd HH:mm:ss format. + google.protobuf.StringValue end_date_time = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The end time as a well-defined type, e.g. FOREVER. + google.ads.googleads.v3.enums.TimeTypeEnum.TimeType end_time_type = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // The spending limit. + oneof spending_limit { + // Output only. The spending limit in micros. One million is equivalent to + // one unit. + google.protobuf.Int64Value spending_limit_micros = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The spending limit as a well-defined type, e.g. INFINITE. + google.ads.googleads.v3.enums.SpendingLimitTypeEnum.SpendingLimitType spending_limit_type = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + } + + // Output only. The resource name of the account-level budget. + // AccountBudget resource names have the form: + // + // `customers/{customer_id}/accountBudgets/{account_budget_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AccountBudget" + } + ]; + + // Output only. The ID of the account-level budget. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The resource name of the billing setup associated with this account-level + // budget. BillingSetup resource names have the form: + // + // `customers/{customer_id}/billingSetups/{billing_setup_id}` + google.protobuf.StringValue billing_setup = 3 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/BillingSetup" + } + ]; + + // Output only. The status of this account-level budget. + google.ads.googleads.v3.enums.AccountBudgetStatusEnum.AccountBudgetStatus status = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The name of the account-level budget. + google.protobuf.StringValue name = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The proposed start time of the account-level budget in + // yyyy-MM-dd HH:mm:ss format. If a start time type of NOW was proposed, + // this is the time of request. + google.protobuf.StringValue proposed_start_date_time = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The approved start time of the account-level budget in yyyy-MM-dd HH:mm:ss + // format. + // + // For example, if a new budget is approved after the proposed start time, + // the approved start time is the time of approval. + google.protobuf.StringValue approved_start_date_time = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The total adjustments amount. + // + // An example of an adjustment is courtesy credits. + google.protobuf.Int64Value total_adjustments_micros = 18 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The value of Ads that have been served, in micros. + // + // This includes overdelivery costs, in which case a credit might be + // automatically applied to the budget (see total_adjustments_micros). + google.protobuf.Int64Value amount_served_micros = 19 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. A purchase order number is a value that helps users reference this budget + // in their monthly invoices. + google.protobuf.StringValue purchase_order_number = 20 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Notes associated with the budget. + google.protobuf.StringValue notes = 21 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The pending proposal to modify this budget, if applicable. + PendingAccountBudgetProposal pending_proposal = 22 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The proposed end time of the account-level budget. + oneof proposed_end_time { + // Output only. The proposed end time in yyyy-MM-dd HH:mm:ss format. + google.protobuf.StringValue proposed_end_date_time = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The proposed end time as a well-defined type, e.g. FOREVER. + google.ads.googleads.v3.enums.TimeTypeEnum.TimeType proposed_end_time_type = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // The approved end time of the account-level budget. + // + // For example, if a budget's end time is updated and the proposal is approved + // after the proposed end time, the approved end time is the time of approval. + oneof approved_end_time { + // Output only. The approved end time in yyyy-MM-dd HH:mm:ss format. + google.protobuf.StringValue approved_end_date_time = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The approved end time as a well-defined type, e.g. FOREVER. + google.ads.googleads.v3.enums.TimeTypeEnum.TimeType approved_end_time_type = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // The proposed spending limit. + oneof proposed_spending_limit { + // Output only. The proposed spending limit in micros. One million is equivalent to + // one unit. + google.protobuf.Int64Value proposed_spending_limit_micros = 12 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The proposed spending limit as a well-defined type, e.g. INFINITE. + google.ads.googleads.v3.enums.SpendingLimitTypeEnum.SpendingLimitType proposed_spending_limit_type = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // The approved spending limit. + // + // For example, if the amount already spent by the account exceeds the + // proposed spending limit at the time the proposal is approved, the approved + // spending limit is set to the amount already spent. + oneof approved_spending_limit { + // Output only. The approved spending limit in micros. One million is equivalent to + // one unit. This will only be populated if the proposed spending limit + // is finite, and will always be greater than or equal to the + // proposed spending limit. + google.protobuf.Int64Value approved_spending_limit_micros = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The approved spending limit as a well-defined type, e.g. INFINITE. This + // will only be populated if the approved spending limit is INFINITE. + google.ads.googleads.v3.enums.SpendingLimitTypeEnum.SpendingLimitType approved_spending_limit_type = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // The spending limit after adjustments have been applied. Adjustments are + // stored in total_adjustments_micros. + // + // This value has the final say on how much the account is allowed to spend. + oneof adjusted_spending_limit { + // Output only. The adjusted spending limit in micros. One million is equivalent to + // one unit. + // + // If the approved spending limit is finite, the adjusted + // spending limit may vary depending on the types of adjustments applied + // to this budget, if applicable. + // + // The different kinds of adjustments are described here: + // https://support.google.com/google-ads/answer/1704323 + // + // For example, a debit adjustment reduces how much the account is + // allowed to spend. + google.protobuf.Int64Value adjusted_spending_limit_micros = 16 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The adjusted spending limit as a well-defined type, e.g. INFINITE. + // This will only be populated if the adjusted spending limit is INFINITE, + // which is guaranteed to be true if the approved spending limit is + // INFINITE. + google.ads.googleads.v3.enums.SpendingLimitTypeEnum.SpendingLimitType adjusted_spending_limit_type = 17 [(google.api.field_behavior) = OUTPUT_ONLY]; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/account_budget_proposal.proto b/third_party/googleapis/google/ads/googleads/v3/resources/account_budget_proposal.proto new file mode 100644 index 000000000..5c0c635d4 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/account_budget_proposal.proto @@ -0,0 +1,161 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/account_budget_proposal_status.proto"; +import "google/ads/googleads/v3/enums/account_budget_proposal_type.proto"; +import "google/ads/googleads/v3/enums/spending_limit_type.proto"; +import "google/ads/googleads/v3/enums/time_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "AccountBudgetProposalProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the AccountBudgetProposal resource. + +// An account-level budget proposal. +// +// All fields prefixed with 'proposed' may not necessarily be applied directly. +// For example, proposed spending limits may be adjusted before their +// application. This is true if the 'proposed' field has an 'approved' +// counterpart, e.g. spending limits. +// +// Please note that the proposal type (proposal_type) changes which fields are +// required and which must remain empty. +message AccountBudgetProposal { + option (google.api.resource) = { + type: "googleads.googleapis.com/AccountBudgetProposal" + pattern: "customers/{customer}/accountBudgetProposals/{account_budget_proposal}" + }; + + // Immutable. The resource name of the proposal. + // AccountBudgetProposal resource names have the form: + // + // `customers/{customer_id}/accountBudgetProposals/{account_budget_proposal_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AccountBudgetProposal" + } + ]; + + // Output only. The ID of the proposal. + google.protobuf.Int64Value id = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. The resource name of the billing setup associated with this proposal. + google.protobuf.StringValue billing_setup = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/BillingSetup" + } + ]; + + // Immutable. The resource name of the account-level budget associated with this + // proposal. + google.protobuf.StringValue account_budget = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AccountBudget" + } + ]; + + // Immutable. The type of this proposal, e.g. END to end the budget associated with this + // proposal. + google.ads.googleads.v3.enums.AccountBudgetProposalTypeEnum.AccountBudgetProposalType proposal_type = 4 [(google.api.field_behavior) = IMMUTABLE]; + + // Output only. The status of this proposal. + // When a new proposal is created, the status defaults to PENDING. + google.ads.googleads.v3.enums.AccountBudgetProposalStatusEnum.AccountBudgetProposalStatus status = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. The name to assign to the account-level budget. + google.protobuf.StringValue proposed_name = 5 [(google.api.field_behavior) = IMMUTABLE]; + + // Output only. The approved start date time in yyyy-mm-dd hh:mm:ss format. + google.protobuf.StringValue approved_start_date_time = 20 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. A purchase order number is a value that enables the user to help them + // reference this budget in their monthly invoices. + google.protobuf.StringValue proposed_purchase_order_number = 12 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Notes associated with this budget. + google.protobuf.StringValue proposed_notes = 13 [(google.api.field_behavior) = IMMUTABLE]; + + // Output only. The date time when this account-level budget proposal was created, which is + // not the same as its approval date time, if applicable. + google.protobuf.StringValue creation_date_time = 16 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The date time when this account-level budget was approved, if applicable. + google.protobuf.StringValue approval_date_time = 17 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The proposed start date time of the account-level budget, which cannot be + // in the past. + oneof proposed_start_time { + // Immutable. The proposed start date time in yyyy-mm-dd hh:mm:ss format. + google.protobuf.StringValue proposed_start_date_time = 18 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. The proposed start date time as a well-defined type, e.g. NOW. + google.ads.googleads.v3.enums.TimeTypeEnum.TimeType proposed_start_time_type = 7 [(google.api.field_behavior) = IMMUTABLE]; + } + + // The proposed end date time of the account-level budget, which cannot be in + // the past. + oneof proposed_end_time { + // Immutable. The proposed end date time in yyyy-mm-dd hh:mm:ss format. + google.protobuf.StringValue proposed_end_date_time = 19 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. The proposed end date time as a well-defined type, e.g. FOREVER. + google.ads.googleads.v3.enums.TimeTypeEnum.TimeType proposed_end_time_type = 9 [(google.api.field_behavior) = IMMUTABLE]; + } + + // The approved end date time of the account-level budget. + oneof approved_end_time { + // Output only. The approved end date time in yyyy-mm-dd hh:mm:ss format. + google.protobuf.StringValue approved_end_date_time = 21 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The approved end date time as a well-defined type, e.g. FOREVER. + google.ads.googleads.v3.enums.TimeTypeEnum.TimeType approved_end_time_type = 22 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // The proposed spending limit. + oneof proposed_spending_limit { + // Immutable. The proposed spending limit in micros. One million is equivalent to + // one unit. + google.protobuf.Int64Value proposed_spending_limit_micros = 10 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. The proposed spending limit as a well-defined type, e.g. INFINITE. + google.ads.googleads.v3.enums.SpendingLimitTypeEnum.SpendingLimitType proposed_spending_limit_type = 11 [(google.api.field_behavior) = IMMUTABLE]; + } + + // The approved spending limit. + oneof approved_spending_limit { + // Output only. The approved spending limit in micros. One million is equivalent to + // one unit. + google.protobuf.Int64Value approved_spending_limit_micros = 23 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The approved spending limit as a well-defined type, e.g. INFINITE. + google.ads.googleads.v3.enums.SpendingLimitTypeEnum.SpendingLimitType approved_spending_limit_type = 24 [(google.api.field_behavior) = OUTPUT_ONLY]; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/ad.proto b/third_party/googleapis/google/ads/googleads/v3/resources/ad.proto new file mode 100644 index 000000000..68138fd72 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/ad.proto @@ -0,0 +1,178 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/ad_type_infos.proto"; +import "google/ads/googleads/v3/common/custom_parameter.proto"; +import "google/ads/googleads/v3/common/final_app_url.proto"; +import "google/ads/googleads/v3/common/url_collection.proto"; +import "google/ads/googleads/v3/enums/ad_type.proto"; +import "google/ads/googleads/v3/enums/device.proto"; +import "google/ads/googleads/v3/enums/system_managed_entity_source.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "AdProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the ad type. + +// An ad. +message Ad { + option (google.api.resource) = { + type: "googleads.googleapis.com/Ad" + pattern: "customers/{customer}/ads/{ad}" + }; + + // Immutable. The resource name of the ad. + // Ad resource names have the form: + // + // `customers/{customer_id}/ads/{ad_id}` + string resource_name = 37 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Ad" + } + ]; + + // Output only. The ID of the ad. + google.protobuf.Int64Value id = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The list of possible final URLs after all cross-domain redirects for the + // ad. + repeated google.protobuf.StringValue final_urls = 2; + + // A list of final app URLs that will be used on mobile if the user has the + // specific app installed. + repeated google.ads.googleads.v3.common.FinalAppUrl final_app_urls = 35; + + // The list of possible final mobile URLs after all cross-domain redirects + // for the ad. + repeated google.protobuf.StringValue final_mobile_urls = 16; + + // The URL template for constructing a tracking URL. + google.protobuf.StringValue tracking_url_template = 12; + + // The suffix to use when constructing a final URL. + google.protobuf.StringValue final_url_suffix = 38; + + // The list of mappings that can be used to substitute custom parameter tags + // in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`. + // For mutates, please use url custom parameter operations. + repeated google.ads.googleads.v3.common.CustomParameter url_custom_parameters = 10; + + // The URL that appears in the ad description for some ad formats. + google.protobuf.StringValue display_url = 4; + + // Output only. The type of ad. + google.ads.googleads.v3.enums.AdTypeEnum.AdType type = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Indicates if this ad was automatically added by Google Ads and not by a + // user. For example, this could happen when ads are automatically created as + // suggestions for new ads based on knowledge of how existing ads are + // performing. + google.protobuf.BoolValue added_by_google_ads = 19 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The device preference for the ad. You can only specify a preference for + // mobile devices. When this preference is set the ad will be preferred over + // other ads when being displayed on a mobile device. The ad can still be + // displayed on other device types, e.g. if no other ads are available. + // If unspecified (no device preference), all devices are targeted. + // This is only supported by some ad types. + google.ads.googleads.v3.enums.DeviceEnum.Device device_preference = 20; + + // Additional URLs for the ad that are tagged with a unique identifier that + // can be referenced from other fields in the ad. + repeated google.ads.googleads.v3.common.UrlCollection url_collections = 26; + + // Immutable. The name of the ad. This is only used to be able to identify the ad. It + // does not need to be unique and does not affect the served ad. + google.protobuf.StringValue name = 23 [(google.api.field_behavior) = IMMUTABLE]; + + // Output only. If this ad is system managed, then this field will indicate the source. + // This field is read-only. + google.ads.googleads.v3.enums.SystemManagedResourceSourceEnum.SystemManagedResourceSource system_managed_resource_source = 27 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Details pertinent to the ad type. Exactly one value must be set. + oneof ad_data { + // Details pertaining to a text ad. + google.ads.googleads.v3.common.TextAdInfo text_ad = 6; + + // Details pertaining to an expanded text ad. + google.ads.googleads.v3.common.ExpandedTextAdInfo expanded_text_ad = 7; + + // Details pertaining to a call-only ad. + google.ads.googleads.v3.common.CallOnlyAdInfo call_only_ad = 13; + + // Details pertaining to an Expanded Dynamic Search Ad. + // This type of ad has its headline, final URLs, and display URL + // auto-generated at serving time according to domain name specific + // information provided by `dynamic_search_ads_setting` linked at the + // campaign level. + google.ads.googleads.v3.common.ExpandedDynamicSearchAdInfo expanded_dynamic_search_ad = 14; + + // Details pertaining to a hotel ad. + google.ads.googleads.v3.common.HotelAdInfo hotel_ad = 15; + + // Details pertaining to a Smart Shopping ad. + google.ads.googleads.v3.common.ShoppingSmartAdInfo shopping_smart_ad = 17; + + // Details pertaining to a Shopping product ad. + google.ads.googleads.v3.common.ShoppingProductAdInfo shopping_product_ad = 18; + + // Details pertaining to a Gmail ad. + google.ads.googleads.v3.common.GmailAdInfo gmail_ad = 21; + + // Details pertaining to an Image ad. + google.ads.googleads.v3.common.ImageAdInfo image_ad = 22; + + // Details pertaining to a Video ad. + google.ads.googleads.v3.common.VideoAdInfo video_ad = 24; + + // Details pertaining to a responsive search ad. + google.ads.googleads.v3.common.ResponsiveSearchAdInfo responsive_search_ad = 25; + + // Details pertaining to a legacy responsive display ad. + google.ads.googleads.v3.common.LegacyResponsiveDisplayAdInfo legacy_responsive_display_ad = 28; + + // Details pertaining to an app ad. + google.ads.googleads.v3.common.AppAdInfo app_ad = 29; + + // Immutable. Details pertaining to a legacy app install ad. + google.ads.googleads.v3.common.LegacyAppInstallAdInfo legacy_app_install_ad = 30 [(google.api.field_behavior) = IMMUTABLE]; + + // Details pertaining to a responsive display ad. + google.ads.googleads.v3.common.ResponsiveDisplayAdInfo responsive_display_ad = 31; + + // Details pertaining to a display upload ad. + google.ads.googleads.v3.common.DisplayUploadAdInfo display_upload_ad = 33; + + // Details pertaining to an app engagement ad. + google.ads.googleads.v3.common.AppEngagementAdInfo app_engagement_ad = 34; + + // Details pertaining to a Shopping Comparison Listing ad. + google.ads.googleads.v3.common.ShoppingComparisonListingAdInfo shopping_comparison_listing_ad = 36; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/ad_group.proto b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group.proto new file mode 100644 index 000000000..271f2954f --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group.proto @@ -0,0 +1,177 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/custom_parameter.proto"; +import "google/ads/googleads/v3/common/explorer_auto_optimizer_setting.proto"; +import "google/ads/googleads/v3/common/targeting_setting.proto"; +import "google/ads/googleads/v3/enums/ad_group_ad_rotation_mode.proto"; +import "google/ads/googleads/v3/enums/ad_group_status.proto"; +import "google/ads/googleads/v3/enums/ad_group_type.proto"; +import "google/ads/googleads/v3/enums/bidding_source.proto"; +import "google/ads/googleads/v3/enums/targeting_dimension.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the ad group resource. + +// An ad group. +message AdGroup { + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroup" + pattern: "customers/{customer}/adGroups/{ad_group}" + }; + + // Immutable. The resource name of the ad group. + // Ad group resource names have the form: + // + // `customers/{customer_id}/adGroups/{ad_group_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; + + // Output only. The ID of the ad group. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The name of the ad group. + // + // This field is required and should not be empty when creating new ad + // groups. + // + // It must contain fewer than 255 UTF-8 full-width characters. + // + // It must not contain any null (code point 0x0), NL line feed + // (code point 0xA) or carriage return (code point 0xD) characters. + google.protobuf.StringValue name = 4; + + // The status of the ad group. + google.ads.googleads.v3.enums.AdGroupStatusEnum.AdGroupStatus status = 5; + + // Immutable. The type of the ad group. + google.ads.googleads.v3.enums.AdGroupTypeEnum.AdGroupType type = 12 [(google.api.field_behavior) = IMMUTABLE]; + + // The ad rotation mode of the ad group. + google.ads.googleads.v3.enums.AdGroupAdRotationModeEnum.AdGroupAdRotationMode ad_rotation_mode = 22; + + // Output only. For draft or experiment ad groups, this field is the resource name of the + // base ad group from which this ad group was created. If a draft or + // experiment ad group does not have a base ad group, then this field is null. + // + // For base ad groups, this field equals the ad group resource name. + // + // This field is read-only. + google.protobuf.StringValue base_ad_group = 18 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; + + // The URL template for constructing a tracking URL. + google.protobuf.StringValue tracking_url_template = 13; + + // The list of mappings used to substitute custom parameter tags in a + // `tracking_url_template`, `final_urls`, or `mobile_final_urls`. + repeated google.ads.googleads.v3.common.CustomParameter url_custom_parameters = 6; + + // Immutable. The campaign to which the ad group belongs. + google.protobuf.StringValue campaign = 10 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; + + // The maximum CPC (cost-per-click) bid. + google.protobuf.Int64Value cpc_bid_micros = 14; + + // The maximum CPM (cost-per-thousand viewable impressions) bid. + google.protobuf.Int64Value cpm_bid_micros = 15; + + // The target CPA (cost-per-acquisition). + google.protobuf.Int64Value target_cpa_micros = 27; + + // Output only. The CPV (cost-per-view) bid. + google.protobuf.Int64Value cpv_bid_micros = 17 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Average amount in micros that the advertiser is willing to pay for every + // thousand times the ad is shown. + google.protobuf.Int64Value target_cpm_micros = 26; + + // The target ROAS (return-on-ad-spend) override. If the ad group's campaign + // bidding strategy is a standard Target ROAS strategy, then this field + // overrides the target ROAS specified in the campaign's bidding strategy. + // Otherwise, this value is ignored. + google.protobuf.DoubleValue target_roas = 30; + + // The percent cpc bid amount, expressed as a fraction of the advertised price + // for some good or service. The valid range for the fraction is [0,1) and the + // value stored here is 1,000,000 * [fraction]. + google.protobuf.Int64Value percent_cpc_bid_micros = 20; + + // Settings for the Display Campaign Optimizer, initially termed "Explorer". + google.ads.googleads.v3.common.ExplorerAutoOptimizerSetting explorer_auto_optimizer_setting = 21; + + // Allows advertisers to specify a targeting dimension on which to place + // absolute bids. This is only applicable for campaigns that target only the + // display network and not search. + google.ads.googleads.v3.enums.TargetingDimensionEnum.TargetingDimension display_custom_bid_dimension = 23; + + // URL template for appending params to Final URL. + google.protobuf.StringValue final_url_suffix = 24; + + // Setting for targeting related features. + google.ads.googleads.v3.common.TargetingSetting targeting_setting = 25; + + // Output only. The effective target CPA (cost-per-acquisition). + // This field is read-only. + google.protobuf.Int64Value effective_target_cpa_micros = 28 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Source of the effective target CPA. + // This field is read-only. + google.ads.googleads.v3.enums.BiddingSourceEnum.BiddingSource effective_target_cpa_source = 29 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The effective target ROAS (return-on-ad-spend). + // This field is read-only. + google.protobuf.DoubleValue effective_target_roas = 31 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Source of the effective target ROAS. + // This field is read-only. + google.ads.googleads.v3.enums.BiddingSourceEnum.BiddingSource effective_target_roas_source = 32 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The resource names of labels attached to this ad group. + repeated google.protobuf.StringValue labels = 33 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupLabel" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_ad.proto b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_ad.proto new file mode 100644 index 000000000..3210f075e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_ad.proto @@ -0,0 +1,91 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/policy.proto"; +import "google/ads/googleads/v3/enums/ad_group_ad_status.proto"; +import "google/ads/googleads/v3/enums/ad_strength.proto"; +import "google/ads/googleads/v3/enums/policy_approval_status.proto"; +import "google/ads/googleads/v3/enums/policy_review_status.proto"; +import "google/ads/googleads/v3/resources/ad.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupAdProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the ad group ad resource. + +// An ad group ad. +message AdGroupAd { + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupAd" + pattern: "customers/{customer}/adGroupAds/{ad_group_ad}" + }; + + // Immutable. The resource name of the ad. + // Ad group ad resource names have the form: + // + // `customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAd" + } + ]; + + // The status of the ad. + google.ads.googleads.v3.enums.AdGroupAdStatusEnum.AdGroupAdStatus status = 3; + + // Immutable. The ad group to which the ad belongs. + google.protobuf.StringValue ad_group = 4 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; + + // Immutable. The ad. + Ad ad = 5 [(google.api.field_behavior) = IMMUTABLE]; + + // Output only. Policy information for the ad. + AdGroupAdPolicySummary policy_summary = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Overall ad strength for this ad group ad. + google.ads.googleads.v3.enums.AdStrengthEnum.AdStrength ad_strength = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// Contains policy information for an ad. +message AdGroupAdPolicySummary { + // Output only. The list of policy findings for this ad. + repeated google.ads.googleads.v3.common.PolicyTopicEntry policy_topic_entries = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Where in the review process this ad is. + google.ads.googleads.v3.enums.PolicyReviewStatusEnum.PolicyReviewStatus review_status = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The overall approval status of this ad, calculated based on the status of + // its individual policy topic entries. + google.ads.googleads.v3.enums.PolicyApprovalStatusEnum.PolicyApprovalStatus approval_status = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_ad_asset_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_ad_asset_view.proto new file mode 100644 index 000000000..624228af4 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_ad_asset_view.proto @@ -0,0 +1,95 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/policy.proto"; +import "google/ads/googleads/v3/enums/asset_field_type.proto"; +import "google/ads/googleads/v3/enums/asset_performance_label.proto"; +import "google/ads/googleads/v3/enums/policy_approval_status.proto"; +import "google/ads/googleads/v3/enums/policy_review_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupAdAssetViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the ad group ad asset view resource. + +// A link between an AdGroupAd and an Asset. +message AdGroupAdAssetView { + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupAdAssetView" + pattern: "customers/{customer}/adGroupAdAssets/{ad_group_ad_asset_view}" + }; + + // Output only. The resource name of the ad group ad asset view. + // Ad group ad asset view resource names have the form: + // + // `customers/{customer_id}/adGroupAdAssets/{AdGroupAdAsset.ad_group_id}~{AdGroupAdAsset.ad.ad_id}~{AdGroupAdAsset.asset_id}~{AdGroupAdAsset.asset_field_type}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAdAssetView" + } + ]; + + // Output only. The ad group ad to which the asset is linked. + google.protobuf.StringValue ad_group_ad = 5 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAd" + } + ]; + + // Output only. The asset which is linked to the ad group ad. + google.protobuf.StringValue asset = 6 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Asset" + } + ]; + + // Output only. Role that the asset takes in the ad. + google.ads.googleads.v3.enums.AssetFieldTypeEnum.AssetFieldType field_type = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Policy information for the ad group ad asset. + AdGroupAdAssetPolicySummary policy_summary = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Performance of an asset linkage. + google.ads.googleads.v3.enums.AssetPerformanceLabelEnum.AssetPerformanceLabel performance_label = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// Contains policy information for an ad group ad asset. +message AdGroupAdAssetPolicySummary { + // Output only. The list of policy findings for the ad group ad asset. + repeated google.ads.googleads.v3.common.PolicyTopicEntry policy_topic_entries = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Where in the review process this ad group ad asset is. + google.ads.googleads.v3.enums.PolicyReviewStatusEnum.PolicyReviewStatus review_status = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The overall approval status of this ad group ad asset, calculated based on + // the status of its individual policy topic entries. + google.ads.googleads.v3.enums.PolicyApprovalStatusEnum.PolicyApprovalStatus approval_status = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_ad_label.proto b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_ad_label.proto new file mode 100644 index 000000000..21e1f6719 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_ad_label.proto @@ -0,0 +1,67 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupAdLabelProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the ad group ad label resource. + +// A relationship between an ad group ad and a label. +message AdGroupAdLabel { + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupAdLabel" + pattern: "customers/{customer}/adGroupAdLabels/{ad_group_ad_label}" + }; + + // Immutable. The resource name of the ad group ad label. + // Ad group ad label resource names have the form: + // `customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAdLabel" + } + ]; + + // Immutable. The ad group ad to which the label is attached. + google.protobuf.StringValue ad_group_ad = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAd" + } + ]; + + // Immutable. The label assigned to the ad group ad. + google.protobuf.StringValue label = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Label" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_audience_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_audience_view.proto new file mode 100644 index 000000000..db25b8126 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_audience_view.proto @@ -0,0 +1,54 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupAudienceViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the ad group audience view resource. + +// An ad group audience view. +// Includes performance data from interests and remarketing lists for Display +// Network and YouTube Network ads, and remarketing lists for search ads (RLSA), +// aggregated at the audience level. +message AdGroupAudienceView { + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupAudienceView" + pattern: "customers/{customer}/adGroupAudienceViews/{ad_group_audience_view}" + }; + + // Output only. The resource name of the ad group audience view. + // Ad group audience view resource names have the form: + // + // `customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAudienceView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_bid_modifier.proto b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_bid_modifier.proto new file mode 100644 index 000000000..0590f64f4 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_bid_modifier.proto @@ -0,0 +1,108 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/criteria.proto"; +import "google/ads/googleads/v3/enums/bid_modifier_source.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupBidModifierProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the ad group bid modifier resource. + +// Represents an ad group bid modifier. +message AdGroupBidModifier { + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupBidModifier" + pattern: "customers/{customer}/adGroupBidModifiers/{ad_group_bid_modifier}" + }; + + // Immutable. The resource name of the ad group bid modifier. + // Ad group bid modifier resource names have the form: + // + // `customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupBidModifier" + } + ]; + + // Immutable. The ad group to which this criterion belongs. + google.protobuf.StringValue ad_group = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; + + // Output only. The ID of the criterion to bid modify. + // + // This field is ignored for mutates. + google.protobuf.Int64Value criterion_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The modifier for the bid when the criterion matches. The modifier must be + // in the range: 0.1 - 10.0. The range is 1.0 - 6.0 for PreferredContent. + // Use 0 to opt out of a Device type. + google.protobuf.DoubleValue bid_modifier = 4; + + // Output only. The base ad group from which this draft/trial adgroup bid modifier was + // created. If ad_group is a base ad group then this field will be equal to + // ad_group. If the ad group was created in the draft or trial and has no + // corresponding base ad group, then this field will be null. + // This field is readonly. + google.protobuf.StringValue base_ad_group = 9 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; + + // Output only. Bid modifier source. + google.ads.googleads.v3.enums.BidModifierSourceEnum.BidModifierSource bid_modifier_source = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The criterion of this ad group bid modifier. + oneof criterion { + // Immutable. Criterion for hotel date selection (default dates vs. user selected). + google.ads.googleads.v3.common.HotelDateSelectionTypeInfo hotel_date_selection_type = 5 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Criterion for number of days prior to the stay the booking is being made. + google.ads.googleads.v3.common.HotelAdvanceBookingWindowInfo hotel_advance_booking_window = 6 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Criterion for length of hotel stay in nights. + google.ads.googleads.v3.common.HotelLengthOfStayInfo hotel_length_of_stay = 7 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Criterion for day of the week the booking is for. + google.ads.googleads.v3.common.HotelCheckInDayInfo hotel_check_in_day = 8 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. A device criterion. + google.ads.googleads.v3.common.DeviceInfo device = 11 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. A preferred content criterion. + google.ads.googleads.v3.common.PreferredContentInfo preferred_content = 12 [(google.api.field_behavior) = IMMUTABLE]; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_criterion.proto b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_criterion.proto new file mode 100644 index 000000000..c992cf2d9 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_criterion.proto @@ -0,0 +1,256 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/criteria.proto"; +import "google/ads/googleads/v3/common/custom_parameter.proto"; +import "google/ads/googleads/v3/enums/ad_group_criterion_approval_status.proto"; +import "google/ads/googleads/v3/enums/ad_group_criterion_status.proto"; +import "google/ads/googleads/v3/enums/bidding_source.proto"; +import "google/ads/googleads/v3/enums/criterion_system_serving_status.proto"; +import "google/ads/googleads/v3/enums/criterion_type.proto"; +import "google/ads/googleads/v3/enums/quality_score_bucket.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupCriterionProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the ad group criterion resource. + +// An ad group criterion. +message AdGroupCriterion { + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupCriterion" + pattern: "customers/{customer}/adGroupCriteria/{ad_group_criterion}" + }; + + // A container for ad group criterion quality information. + message QualityInfo { + // Output only. The quality score. + // + // This field may not be populated if Google does not have enough + // information to determine a value. + google.protobuf.Int32Value quality_score = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The performance of the ad compared to other advertisers. + google.ads.googleads.v3.enums.QualityScoreBucketEnum.QualityScoreBucket creative_quality_score = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The quality score of the landing page. + google.ads.googleads.v3.enums.QualityScoreBucketEnum.QualityScoreBucket post_click_quality_score = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The click-through rate compared to that of other advertisers. + google.ads.googleads.v3.enums.QualityScoreBucketEnum.QualityScoreBucket search_predicted_ctr = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // Estimates for criterion bids at various positions. + message PositionEstimates { + // Output only. The estimate of the CPC bid required for ad to be shown on first + // page of search results. + google.protobuf.Int64Value first_page_cpc_micros = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The estimate of the CPC bid required for ad to be displayed in first + // position, at the top of the first page of search results. + google.protobuf.Int64Value first_position_cpc_micros = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The estimate of the CPC bid required for ad to be displayed at the top + // of the first page of search results. + google.protobuf.Int64Value top_of_page_cpc_micros = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Estimate of how many clicks per week you might get by changing your + // keyword bid to the value in first_position_cpc_micros. + google.protobuf.Int64Value estimated_add_clicks_at_first_position_cpc = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Estimate of how your cost per week might change when changing your + // keyword bid to the value in first_position_cpc_micros. + google.protobuf.Int64Value estimated_add_cost_at_first_position_cpc = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // Immutable. The resource name of the ad group criterion. + // Ad group criterion resource names have the form: + // + // `customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterion" + } + ]; + + // Output only. The ID of the criterion. + // + // This field is ignored for mutates. + google.protobuf.Int64Value criterion_id = 26 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The status of the criterion. + google.ads.googleads.v3.enums.AdGroupCriterionStatusEnum.AdGroupCriterionStatus status = 3; + + // Output only. Information regarding the quality of the criterion. + QualityInfo quality_info = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. The ad group to which the criterion belongs. + google.protobuf.StringValue ad_group = 5 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; + + // Output only. The type of the criterion. + google.ads.googleads.v3.enums.CriterionTypeEnum.CriterionType type = 25 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. Whether to target (`false`) or exclude (`true`) the criterion. + // + // This field is immutable. To switch a criterion from positive to negative, + // remove then re-add it. + google.protobuf.BoolValue negative = 31 [(google.api.field_behavior) = IMMUTABLE]; + + // Output only. Serving status of the criterion. + google.ads.googleads.v3.enums.CriterionSystemServingStatusEnum.CriterionSystemServingStatus system_serving_status = 52 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Approval status of the criterion. + google.ads.googleads.v3.enums.AdGroupCriterionApprovalStatusEnum.AdGroupCriterionApprovalStatus approval_status = 53 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The modifier for the bid when the criterion matches. The modifier must be + // in the range: 0.1 - 10.0. Most targetable criteria types support modifiers. + google.protobuf.DoubleValue bid_modifier = 44; + + // The CPC (cost-per-click) bid. + google.protobuf.Int64Value cpc_bid_micros = 16; + + // The CPM (cost-per-thousand viewable impressions) bid. + google.protobuf.Int64Value cpm_bid_micros = 17; + + // The CPV (cost-per-view) bid. + google.protobuf.Int64Value cpv_bid_micros = 24; + + // The CPC bid amount, expressed as a fraction of the advertised price + // for some good or service. The valid range for the fraction is [0,1) and the + // value stored here is 1,000,000 * [fraction]. + google.protobuf.Int64Value percent_cpc_bid_micros = 33; + + // Output only. The effective CPC (cost-per-click) bid. + google.protobuf.Int64Value effective_cpc_bid_micros = 18 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The effective CPM (cost-per-thousand viewable impressions) bid. + google.protobuf.Int64Value effective_cpm_bid_micros = 19 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The effective CPV (cost-per-view) bid. + google.protobuf.Int64Value effective_cpv_bid_micros = 20 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The effective Percent CPC bid amount. + google.protobuf.Int64Value effective_percent_cpc_bid_micros = 34 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Source of the effective CPC bid. + google.ads.googleads.v3.enums.BiddingSourceEnum.BiddingSource effective_cpc_bid_source = 21 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Source of the effective CPM bid. + google.ads.googleads.v3.enums.BiddingSourceEnum.BiddingSource effective_cpm_bid_source = 22 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Source of the effective CPV bid. + google.ads.googleads.v3.enums.BiddingSourceEnum.BiddingSource effective_cpv_bid_source = 23 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Source of the effective Percent CPC bid. + google.ads.googleads.v3.enums.BiddingSourceEnum.BiddingSource effective_percent_cpc_bid_source = 35 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Estimates for criterion bids at various positions. + PositionEstimates position_estimates = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The list of possible final URLs after all cross-domain redirects for the + // ad. + repeated google.protobuf.StringValue final_urls = 11; + + // The list of possible final mobile URLs after all cross-domain redirects. + repeated google.protobuf.StringValue final_mobile_urls = 51; + + // URL template for appending params to final URL. + google.protobuf.StringValue final_url_suffix = 50; + + // The URL template for constructing a tracking URL. + google.protobuf.StringValue tracking_url_template = 13; + + // The list of mappings used to substitute custom parameter tags in a + // `tracking_url_template`, `final_urls`, or `mobile_final_urls`. + repeated google.ads.googleads.v3.common.CustomParameter url_custom_parameters = 14; + + // The ad group criterion. + // + // Exactly one must be set. + oneof criterion { + // Immutable. Keyword. + google.ads.googleads.v3.common.KeywordInfo keyword = 27 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Placement. + google.ads.googleads.v3.common.PlacementInfo placement = 28 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Mobile app category. + google.ads.googleads.v3.common.MobileAppCategoryInfo mobile_app_category = 29 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Mobile application. + google.ads.googleads.v3.common.MobileApplicationInfo mobile_application = 30 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Listing group. + google.ads.googleads.v3.common.ListingGroupInfo listing_group = 32 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Age range. + google.ads.googleads.v3.common.AgeRangeInfo age_range = 36 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Gender. + google.ads.googleads.v3.common.GenderInfo gender = 37 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Income range. + google.ads.googleads.v3.common.IncomeRangeInfo income_range = 38 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Parental status. + google.ads.googleads.v3.common.ParentalStatusInfo parental_status = 39 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. User List. + google.ads.googleads.v3.common.UserListInfo user_list = 42 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. YouTube Video. + google.ads.googleads.v3.common.YouTubeVideoInfo youtube_video = 40 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. YouTube Channel. + google.ads.googleads.v3.common.YouTubeChannelInfo youtube_channel = 41 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Topic. + google.ads.googleads.v3.common.TopicInfo topic = 43 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. User Interest. + google.ads.googleads.v3.common.UserInterestInfo user_interest = 45 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Webpage + google.ads.googleads.v3.common.WebpageInfo webpage = 46 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. App Payment Model. + google.ads.googleads.v3.common.AppPaymentModelInfo app_payment_model = 47 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Custom Affinity. + google.ads.googleads.v3.common.CustomAffinityInfo custom_affinity = 48 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Custom Intent. + google.ads.googleads.v3.common.CustomIntentInfo custom_intent = 49 [(google.api.field_behavior) = IMMUTABLE]; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_criterion_label.proto b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_criterion_label.proto new file mode 100644 index 000000000..54b131677 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_criterion_label.proto @@ -0,0 +1,67 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupCriterionLabelProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the ad group criterion label resource. + +// A relationship between an ad group criterion and a label. +message AdGroupCriterionLabel { + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupCriterionLabel" + pattern: "customers/{customer}/adGroupCriterionLabels/{ad_group_criterion_label}" + }; + + // Immutable. The resource name of the ad group criterion label. + // Ad group criterion label resource names have the form: + // `customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterionLabel" + } + ]; + + // Immutable. The ad group criterion to which the label is attached. + google.protobuf.StringValue ad_group_criterion = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterion" + } + ]; + + // Immutable. The label assigned to the ad group criterion. + google.protobuf.StringValue label = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Label" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_criterion_simulation.proto b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_criterion_simulation.proto new file mode 100644 index 000000000..4b5e73154 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_criterion_simulation.proto @@ -0,0 +1,85 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/simulation.proto"; +import "google/ads/googleads/v3/enums/simulation_modification_method.proto"; +import "google/ads/googleads/v3/enums/simulation_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupCriterionSimulationProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the ad group criterion simulation resource. + +// An ad group criterion simulation. Supported combinations of advertising +// channel type, criterion type, simulation type, and simulation modification +// method are detailed below respectively. +// +// 1. DISPLAY - KEYWORD - CPC_BID - UNIFORM +// 2. SEARCH - KEYWORD - CPC_BID - UNIFORM +// 3. SHOPPING - LISTING_GROUP - CPC_BID - UNIFORM +message AdGroupCriterionSimulation { + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupCriterionSimulation" + pattern: "customers/{customer}/adGroupCriterionSimulations/{ad_group_criterion_simulation}" + }; + + // Output only. The resource name of the ad group criterion simulation. + // Ad group criterion simulation resource names have the form: + // + // `customers/{customer_id}/adGroupCriterionSimulations/{ad_group_id}~{criterion_id}~{type}~{modification_method}~{start_date}~{end_date}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterionSimulation" + } + ]; + + // Output only. AdGroup ID of the simulation. + google.protobuf.Int64Value ad_group_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Criterion ID of the simulation. + google.protobuf.Int64Value criterion_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The field that the simulation modifies. + google.ads.googleads.v3.enums.SimulationTypeEnum.SimulationType type = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. How the simulation modifies the field. + google.ads.googleads.v3.enums.SimulationModificationMethodEnum.SimulationModificationMethod modification_method = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. First day on which the simulation is based, in YYYY-MM-DD format. + google.protobuf.StringValue start_date = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Last day on which the simulation is based, in YYYY-MM-DD format. + google.protobuf.StringValue end_date = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // List of simulation points. + oneof point_list { + // Output only. Simulation points if the simulation type is CPC_BID. + google.ads.googleads.v3.common.CpcBidSimulationPointList cpc_bid_point_list = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_extension_setting.proto b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_extension_setting.proto new file mode 100644 index 000000000..5dabbcf4d --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_extension_setting.proto @@ -0,0 +1,80 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/extension_setting_device.proto"; +import "google/ads/googleads/v3/enums/extension_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupExtensionSettingProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the AdGroupExtensionSetting resource. + +// An ad group extension setting. +message AdGroupExtensionSetting { + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupExtensionSetting" + pattern: "customers/{customer}/adGroupExtensionSettings/{ad_group_extension_setting}" + }; + + // Immutable. The resource name of the ad group extension setting. + // AdGroupExtensionSetting resource names have the form: + // + // `customers/{customer_id}/adGroupExtensionSettings/{ad_group_id}~{extension_type}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupExtensionSetting" + } + ]; + + // Immutable. The extension type of the ad group extension setting. + google.ads.googleads.v3.enums.ExtensionTypeEnum.ExtensionType extension_type = 2 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. The resource name of the ad group. The linked extension feed items will + // serve under this ad group. + // AdGroup resource names have the form: + // + // `customers/{customer_id}/adGroups/{ad_group_id}` + google.protobuf.StringValue ad_group = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; + + // The resource names of the extension feed items to serve under the ad group. + // ExtensionFeedItem resource names have the form: + // + // `customers/{customer_id}/extensionFeedItems/{feed_item_id}` + repeated google.protobuf.StringValue extension_feed_items = 4 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/ExtensionFeedItem" + }]; + + // The device for which the extensions will serve. Optional. + google.ads.googleads.v3.enums.ExtensionSettingDeviceEnum.ExtensionSettingDevice device = 5; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_feed.proto b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_feed.proto new file mode 100644 index 000000000..f3ed3fca7 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_feed.proto @@ -0,0 +1,84 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/matching_function.proto"; +import "google/ads/googleads/v3/enums/feed_link_status.proto"; +import "google/ads/googleads/v3/enums/placeholder_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupFeedProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the AdGroupFeed resource. + +// An ad group feed. +message AdGroupFeed { + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupFeed" + pattern: "customers/{customer}/adGroupFeeds/{ad_group_feed}" + }; + + // Immutable. The resource name of the ad group feed. + // Ad group feed resource names have the form: + // + // `customers/{customer_id}/adGroupFeeds/{ad_group_id}~{feed_id} + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupFeed" + } + ]; + + // Immutable. The feed being linked to the ad group. + google.protobuf.StringValue feed = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; + + // Immutable. The ad group being linked to the feed. + google.protobuf.StringValue ad_group = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; + + // Indicates which placeholder types the feed may populate under the connected + // ad group. Required. + repeated google.ads.googleads.v3.enums.PlaceholderTypeEnum.PlaceholderType placeholder_types = 4; + + // Matching function associated with the AdGroupFeed. + // The matching function is used to filter the set of feed items selected. + // Required. + google.ads.googleads.v3.common.MatchingFunction matching_function = 5; + + // Output only. Status of the ad group feed. + // This field is read-only. + google.ads.googleads.v3.enums.FeedLinkStatusEnum.FeedLinkStatus status = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_label.proto b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_label.proto new file mode 100644 index 000000000..e6213c35b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_label.proto @@ -0,0 +1,67 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupLabelProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the ad group label resource. + +// A relationship between an ad group and a label. +message AdGroupLabel { + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupLabel" + pattern: "customers/{customer}/adGroupLabels/{ad_group_label}" + }; + + // Immutable. The resource name of the ad group label. + // Ad group label resource names have the form: + // `customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupLabel" + } + ]; + + // Immutable. The ad group to which the label is attached. + google.protobuf.StringValue ad_group = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; + + // Immutable. The label assigned to the ad group. + google.protobuf.StringValue label = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Label" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_simulation.proto b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_simulation.proto new file mode 100644 index 000000000..d05037998 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/ad_group_simulation.proto @@ -0,0 +1,93 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/simulation.proto"; +import "google/ads/googleads/v3/enums/simulation_modification_method.proto"; +import "google/ads/googleads/v3/enums/simulation_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupSimulationProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the ad group simulation resource. + +// An ad group simulation. Supported combinations of advertising +// channel type, simulation type and simulation modification method is +// detailed below respectively. +// +// 1. SEARCH - CPC_BID - DEFAULT +// 2. SEARCH - CPC_BID - UNIFORM +// 3. SEARCH - TARGET_CPA - UNIFORM +// 4. DISPLAY - CPC_BID - DEFAULT +// 5. DISPLAY - CPC_BID - UNIFORM +// 6. DISPLAY - TARGET_CPA - UNIFORM +// 7. VIDEO - CPV_BID - DEFAULT +// 8. VIDEO - CPV_BID - UNIFORM +message AdGroupSimulation { + option (google.api.resource) = { + type: "googleads.googleapis.com/AdGroupSimulation" + pattern: "customers/{customer}/adGroupSimulations/{ad_group_simulation}" + }; + + // Output only. The resource name of the ad group simulation. + // Ad group simulation resource names have the form: + // + // `customers/{customer_id}/adGroupSimulations/{ad_group_id}~{type}~{modification_method}~{start_date}~{end_date}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupSimulation" + } + ]; + + // Output only. Ad group id of the simulation. + google.protobuf.Int64Value ad_group_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The field that the simulation modifies. + google.ads.googleads.v3.enums.SimulationTypeEnum.SimulationType type = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. How the simulation modifies the field. + google.ads.googleads.v3.enums.SimulationModificationMethodEnum.SimulationModificationMethod modification_method = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. First day on which the simulation is based, in YYYY-MM-DD format. + google.protobuf.StringValue start_date = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Last day on which the simulation is based, in YYYY-MM-DD format + google.protobuf.StringValue end_date = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // List of simulation points. + oneof point_list { + // Output only. Simulation points if the simulation type is CPC_BID. + google.ads.googleads.v3.common.CpcBidSimulationPointList cpc_bid_point_list = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Simulation points if the simulation type is CPV_BID. + google.ads.googleads.v3.common.CpvBidSimulationPointList cpv_bid_point_list = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Simulation points if the simulation type is TARGET_CPA. + google.ads.googleads.v3.common.TargetCpaSimulationPointList target_cpa_point_list = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/ad_parameter.proto b/third_party/googleapis/google/ads/googleads/v3/resources/ad_parameter.proto new file mode 100644 index 000000000..d19383e3d --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/ad_parameter.proto @@ -0,0 +1,83 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "AdParameterProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the ad parameter resource. + +// An ad parameter that is used to update numeric values (such as prices or +// inventory levels) in any text line of an ad (including URLs). There can +// be a maximum of two AdParameters per ad group criterion. (One with +// parameter_index = 1 and one with parameter_index = 2.) +// In the ad the parameters are referenced by a placeholder of the form +// "{param#:value}". E.g. "{param1:$17}" +message AdParameter { + option (google.api.resource) = { + type: "googleads.googleapis.com/AdParameter" + pattern: "customers/{customer}/adParameters/{ad_parameter}" + }; + + // Immutable. The resource name of the ad parameter. + // Ad parameter resource names have the form: + // + // `customers/{customer_id}/adParameters/{ad_group_id}~{criterion_id}~{parameter_index}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdParameter" + } + ]; + + // Immutable. The ad group criterion that this ad parameter belongs to. + google.protobuf.StringValue ad_group_criterion = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterion" + } + ]; + + // Immutable. The unique index of this ad parameter. Must be either 1 or 2. + google.protobuf.Int64Value parameter_index = 3 [(google.api.field_behavior) = IMMUTABLE]; + + // Numeric value to insert into the ad text. The following restrictions + // apply: + // - Can use comma or period as a separator, with an optional period or + // comma (respectively) for fractional values. For example, 1,000,000.00 + // and 2.000.000,10 are valid. + // - Can be prepended or appended with a currency symbol. For example, + // $99.99 is valid. + // - Can be prepended or appended with a currency code. For example, 99.99USD + // and EUR200 are valid. + // - Can use '%'. For example, 1.0% and 1,0% are valid. + // - Can use plus or minus. For example, -10.99 and 25+ are valid. + // - Can use '/' between two numbers. For example 4/1 and 0.95/0.45 are + // valid. + google.protobuf.StringValue insertion_text = 4; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/ad_schedule_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/ad_schedule_view.proto new file mode 100644 index 000000000..3e667ac05 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/ad_schedule_view.proto @@ -0,0 +1,52 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "AdScheduleViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the ad schedule view resource. + +// An ad schedule view summarizes the performance of campaigns by +// AdSchedule criteria. +message AdScheduleView { + option (google.api.resource) = { + type: "googleads.googleapis.com/AdScheduleView" + pattern: "customers/{customer}/adScheduleViews/{ad_schedule_view}" + }; + + // Output only. The resource name of the ad schedule view. + // AdSchedule view resource names have the form: + // + // `customers/{customer_id}/adScheduleViews/{campaign_id}~{criterion_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdScheduleView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/age_range_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/age_range_view.proto new file mode 100644 index 000000000..83b9450fc --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/age_range_view.proto @@ -0,0 +1,51 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "AgeRangeViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the age range view resource. + +// An age range view. +message AgeRangeView { + option (google.api.resource) = { + type: "googleads.googleapis.com/AgeRangeView" + pattern: "customers/{customer}/ageRangeViews/{age_range_view}" + }; + + // Output only. The resource name of the age range view. + // Age range view resource names have the form: + // + // `customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AgeRangeView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/asset.proto b/third_party/googleapis/google/ads/googleads/v3/resources/asset.proto new file mode 100644 index 000000000..814936872 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/asset.proto @@ -0,0 +1,79 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/asset_types.proto"; +import "google/ads/googleads/v3/enums/asset_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "AssetProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the asset resource. + +// Asset is a part of an ad which can be shared across multiple ads. +// It can be an image (ImageAsset), a video (YoutubeVideoAsset), etc. +message Asset { + option (google.api.resource) = { + type: "googleads.googleapis.com/Asset" + pattern: "customers/{customer}/assets/{asset}" + }; + + // Immutable. The resource name of the asset. + // Asset resource names have the form: + // + // `customers/{customer_id}/assets/{asset_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Asset" + } + ]; + + // Output only. The ID of the asset. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Optional name of the asset. + google.protobuf.StringValue name = 3; + + // Output only. Type of the asset. + google.ads.googleads.v3.enums.AssetTypeEnum.AssetType type = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The specific type of the asset. + oneof asset_data { + // Immutable. A YouTube video asset. + google.ads.googleads.v3.common.YoutubeVideoAsset youtube_video_asset = 5 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. A media bundle asset. + google.ads.googleads.v3.common.MediaBundleAsset media_bundle_asset = 6 [(google.api.field_behavior) = IMMUTABLE]; + + // Output only. An image asset. + google.ads.googleads.v3.common.ImageAsset image_asset = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. A text asset. + google.ads.googleads.v3.common.TextAsset text_asset = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/bidding_strategy.proto b/third_party/googleapis/google/ads/googleads/v3/resources/bidding_strategy.proto new file mode 100644 index 000000000..5a45e755a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/bidding_strategy.proto @@ -0,0 +1,112 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/bidding.proto"; +import "google/ads/googleads/v3/enums/bidding_strategy_status.proto"; +import "google/ads/googleads/v3/enums/bidding_strategy_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "BiddingStrategyProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the BiddingStrategy resource + +// A bidding strategy. +message BiddingStrategy { + option (google.api.resource) = { + type: "googleads.googleapis.com/BiddingStrategy" + pattern: "customers/{customer}/biddingStrategies/{bidding_strategy}" + }; + + // Immutable. The resource name of the bidding strategy. + // Bidding strategy resource names have the form: + // + // `customers/{customer_id}/biddingStrategies/{bidding_strategy_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/BiddingStrategy" + } + ]; + + // Output only. The ID of the bidding strategy. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The name of the bidding strategy. + // All bidding strategies within an account must be named distinctly. + // + // The length of this string should be between 1 and 255, inclusive, + // in UTF-8 bytes, (trimmed). + google.protobuf.StringValue name = 4; + + // Output only. The status of the bidding strategy. + // + // This field is read-only. + google.ads.googleads.v3.enums.BiddingStrategyStatusEnum.BiddingStrategyStatus status = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The type of the bidding strategy. + // Create a bidding strategy by setting the bidding scheme. + // + // This field is read-only. + google.ads.googleads.v3.enums.BiddingStrategyTypeEnum.BiddingStrategyType type = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The number of campaigns attached to this bidding strategy. + // + // This field is read-only. + google.protobuf.Int64Value campaign_count = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The number of non-removed campaigns attached to this bidding strategy. + // + // This field is read-only. + google.protobuf.Int64Value non_removed_campaign_count = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The bidding scheme. + // + // Only one can be set. + oneof scheme { + // A bidding strategy that raises bids for clicks that seem more likely to + // lead to a conversion and lowers them for clicks where they seem less + // likely. + google.ads.googleads.v3.common.EnhancedCpc enhanced_cpc = 7; + + // A bidding strategy that sets bids to help get as many conversions as + // possible at the target cost-per-acquisition (CPA) you set. + google.ads.googleads.v3.common.TargetCpa target_cpa = 9; + + // A bidding strategy that automatically optimizes towards a desired + // percentage of impressions. + google.ads.googleads.v3.common.TargetImpressionShare target_impression_share = 48; + + // A bidding strategy that helps you maximize revenue while averaging a + // specific target Return On Ad Spend (ROAS). + google.ads.googleads.v3.common.TargetRoas target_roas = 11; + + // A bid strategy that sets your bids to help get as many clicks as + // possible within your budget. + google.ads.googleads.v3.common.TargetSpend target_spend = 12; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/billing_setup.proto b/third_party/googleapis/google/ads/googleads/v3/resources/billing_setup.proto new file mode 100644 index 000000000..f37f59175 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/billing_setup.proto @@ -0,0 +1,139 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/billing_setup_status.proto"; +import "google/ads/googleads/v3/enums/time_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "BillingSetupProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the BillingSetup resource. + +// A billing setup, which associates a payments account and an advertiser. A +// billing setup is specific to one advertiser. +message BillingSetup { + option (google.api.resource) = { + type: "googleads.googleapis.com/BillingSetup" + pattern: "customers/{customer}/billingSetups/{billing_setup}" + }; + + // Container of payments account information for this billing. + message PaymentsAccountInfo { + // Output only. A 16 digit id used to identify the payments account associated with the + // billing setup. + // + // This must be passed as a string with dashes, e.g. "1234-5678-9012-3456". + google.protobuf.StringValue payments_account_id = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. The name of the payments account associated with the billing setup. + // + // This enables the user to specify a meaningful name for a payments account + // to aid in reconciling monthly invoices. + // + // This name will be printed in the monthly invoices. + google.protobuf.StringValue payments_account_name = 2 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. A 12 digit id used to identify the payments profile associated with the + // billing setup. + // + // This must be passed in as a string with dashes, e.g. "1234-5678-9012". + google.protobuf.StringValue payments_profile_id = 3 [(google.api.field_behavior) = IMMUTABLE]; + + // Output only. The name of the payments profile associated with the billing setup. + google.protobuf.StringValue payments_profile_name = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. A secondary payments profile id present in uncommon situations, e.g. + // when a sequential liability agreement has been arranged. + google.protobuf.StringValue secondary_payments_profile_id = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // Immutable. The resource name of the billing setup. + // BillingSetup resource names have the form: + // + // `customers/{customer_id}/billingSetups/{billing_setup_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/BillingSetup" + } + ]; + + // Output only. The ID of the billing setup. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The status of the billing setup. + google.ads.googleads.v3.enums.BillingSetupStatusEnum.BillingSetupStatus status = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. The resource name of the payments account associated with this billing + // setup. Payments resource names have the form: + // + // `customers/{customer_id}/paymentsAccounts/{payments_account_id}` + // When setting up billing, this is used to signup with an existing payments + // account (and then payments_account_info should not be set). + // When getting a billing setup, this and payments_account_info will be + // populated. + google.protobuf.StringValue payments_account = 11 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/PaymentsAccount" + } + ]; + + // Immutable. The payments account information associated with this billing setup. + // When setting up billing, this is used to signup with a new payments account + // (and then payments_account should not be set). + // When getting a billing setup, this and payments_account will be + // populated. + PaymentsAccountInfo payments_account_info = 12 [(google.api.field_behavior) = IMMUTABLE]; + + // When creating a new billing setup, this is when the setup should take + // effect. NOW is the only acceptable start time if the customer doesn't have + // any approved setups. + // + // When fetching an existing billing setup, this is the requested start time. + // However, if the setup was approved (see status) after the requested start + // time, then this is the approval time. + oneof start_time { + // Immutable. The start date time in yyyy-MM-dd or yyyy-MM-dd HH:mm:ss format. Only a + // future time is allowed. + google.protobuf.StringValue start_date_time = 9 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. The start time as a type. Only NOW is allowed. + google.ads.googleads.v3.enums.TimeTypeEnum.TimeType start_time_type = 10 [(google.api.field_behavior) = IMMUTABLE]; + } + + // When the billing setup ends / ended. This is either FOREVER or the start + // time of the next scheduled billing setup. + oneof end_time { + // Output only. The end date time in yyyy-MM-dd or yyyy-MM-dd HH:mm:ss format. + google.protobuf.StringValue end_date_time = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The end time as a type. The only possible value is FOREVER. + google.ads.googleads.v3.enums.TimeTypeEnum.TimeType end_time_type = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/campaign.proto b/third_party/googleapis/google/ads/googleads/v3/resources/campaign.proto new file mode 100644 index 000000000..189d5e6d3 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/campaign.proto @@ -0,0 +1,404 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/bidding.proto"; +import "google/ads/googleads/v3/common/custom_parameter.proto"; +import "google/ads/googleads/v3/common/frequency_cap.proto"; +import "google/ads/googleads/v3/common/real_time_bidding_setting.proto"; +import "google/ads/googleads/v3/common/targeting_setting.proto"; +import "google/ads/googleads/v3/enums/ad_serving_optimization_status.proto"; +import "google/ads/googleads/v3/enums/advertising_channel_sub_type.proto"; +import "google/ads/googleads/v3/enums/advertising_channel_type.proto"; +import "google/ads/googleads/v3/enums/app_campaign_app_store.proto"; +import "google/ads/googleads/v3/enums/app_campaign_bidding_strategy_goal_type.proto"; +import "google/ads/googleads/v3/enums/bidding_strategy_type.proto"; +import "google/ads/googleads/v3/enums/brand_safety_suitability.proto"; +import "google/ads/googleads/v3/enums/campaign_experiment_type.proto"; +import "google/ads/googleads/v3/enums/campaign_serving_status.proto"; +import "google/ads/googleads/v3/enums/campaign_status.proto"; +import "google/ads/googleads/v3/enums/negative_geo_target_type.proto"; +import "google/ads/googleads/v3/enums/payment_mode.proto"; +import "google/ads/googleads/v3/enums/positive_geo_target_type.proto"; +import "google/ads/googleads/v3/enums/vanity_pharma_display_url_mode.proto"; +import "google/ads/googleads/v3/enums/vanity_pharma_text.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "CampaignProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the Campaign resource. + +// A campaign. +message Campaign { + option (google.api.resource) = { + type: "googleads.googleapis.com/Campaign" + pattern: "customers/{customer}/campaigns/{campaign}" + }; + + // The network settings for the campaign. + message NetworkSettings { + // Whether ads will be served with google.com search results. + google.protobuf.BoolValue target_google_search = 1; + + // Whether ads will be served on partner sites in the Google Search Network + // (requires `target_google_search` to also be `true`). + google.protobuf.BoolValue target_search_network = 2; + + // Whether ads will be served on specified placements in the Google Display + // Network. Placements are specified using the Placement criterion. + google.protobuf.BoolValue target_content_network = 3; + + // Whether ads will be served on the Google Partner Network. + // This is available only to some select Google partner accounts. + google.protobuf.BoolValue target_partner_search_network = 4; + } + + // Campaign-level settings for hotel ads. + message HotelSettingInfo { + // Immutable. The linked Hotel Center account. + google.protobuf.Int64Value hotel_center_id = 1 [(google.api.field_behavior) = IMMUTABLE]; + } + + // Campaign-level settings for App Campaigns. + message AppCampaignSetting { + // Represents the goal which the bidding strategy of this app campaign + // should optimize towards. + google.ads.googleads.v3.enums.AppCampaignBiddingStrategyGoalTypeEnum.AppCampaignBiddingStrategyGoalType bidding_strategy_goal_type = 1; + + // Immutable. A string that uniquely identifies a mobile application. + google.protobuf.StringValue app_id = 2 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. The application store that distributes this specific app. + google.ads.googleads.v3.enums.AppCampaignAppStoreEnum.AppCampaignAppStore app_store = 3 [(google.api.field_behavior) = IMMUTABLE]; + } + + // The setting for controlling Dynamic Search Ads (DSA). + message DynamicSearchAdsSetting { + // The Internet domain name that this setting represents, e.g., "google.com" + // or "www.google.com". + google.protobuf.StringValue domain_name = 1; + + // The language code specifying the language of the domain, e.g., "en". + google.protobuf.StringValue language_code = 2; + + // Whether the campaign uses advertiser supplied URLs exclusively. + google.protobuf.BoolValue use_supplied_urls_only = 3; + + // Output only. The list of page feeds associated with the campaign. + repeated google.protobuf.StringValue feeds = 5 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; + } + + // The setting for Shopping campaigns. Defines the universe of products that + // can be advertised by the campaign, and how this campaign interacts with + // other Shopping campaigns. + message ShoppingSetting { + // Immutable. ID of the Merchant Center account. + // This field is required for create operations. This field is immutable for + // Shopping campaigns. + google.protobuf.Int64Value merchant_id = 1 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Sales country of products to include in the campaign. + // This field is required for Shopping campaigns. This field is immutable. + // This field is optional for non-Shopping campaigns, but it must be equal + // to 'ZZ' if set. + google.protobuf.StringValue sales_country = 2 [(google.api.field_behavior) = IMMUTABLE]; + + // Priority of the campaign. Campaigns with numerically higher priorities + // take precedence over those with lower priorities. + // This field is required for Shopping campaigns, with values between 0 and + // 2, inclusive. + // This field is optional for Smart Shopping campaigns, but must be equal to + // 3 if set. + google.protobuf.Int32Value campaign_priority = 3; + + // Whether to include local products. + google.protobuf.BoolValue enable_local = 4; + } + + // Describes how unbranded pharma ads will be displayed. + message VanityPharma { + // The display mode for vanity pharma URLs. + google.ads.googleads.v3.enums.VanityPharmaDisplayUrlModeEnum.VanityPharmaDisplayUrlMode vanity_pharma_display_url_mode = 1; + + // The text that will be displayed in display URL of the text ad when + // website description is the selected display mode for vanity pharma URLs. + google.ads.googleads.v3.enums.VanityPharmaTextEnum.VanityPharmaText vanity_pharma_text = 2; + } + + // Campaign-level settings for tracking information. + message TrackingSetting { + // Output only. The url used for dynamic tracking. + google.protobuf.StringValue tracking_url = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // Represents a collection of settings related to ads geotargeting. + message GeoTargetTypeSetting { + // The setting used for positive geotargeting in this particular campaign. + google.ads.googleads.v3.enums.PositiveGeoTargetTypeEnum.PositiveGeoTargetType positive_geo_target_type = 1; + + // The setting used for negative geotargeting in this particular campaign. + google.ads.googleads.v3.enums.NegativeGeoTargetTypeEnum.NegativeGeoTargetType negative_geo_target_type = 2; + } + + // Selective optimization setting for this campaign, which includes a set of + // conversion actions to optimize this campaign towards. + message SelectiveOptimization { + // The selected set of conversion actions for optimizing this campaign. + repeated google.protobuf.StringValue conversion_actions = 1 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/ConversionAction" + }]; + } + + // Immutable. The resource name of the campaign. + // Campaign resource names have the form: + // + // `customers/{customer_id}/campaigns/{campaign_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; + + // Output only. The ID of the campaign. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The name of the campaign. + // + // This field is required and should not be empty when creating new + // campaigns. + // + // It must not contain any null (code point 0x0), NL line feed + // (code point 0xA) or carriage return (code point 0xD) characters. + google.protobuf.StringValue name = 4; + + // The status of the campaign. + // + // When a new campaign is added, the status defaults to ENABLED. + google.ads.googleads.v3.enums.CampaignStatusEnum.CampaignStatus status = 5; + + // Output only. The ad serving status of the campaign. + google.ads.googleads.v3.enums.CampaignServingStatusEnum.CampaignServingStatus serving_status = 21 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The ad serving optimization status of the campaign. + google.ads.googleads.v3.enums.AdServingOptimizationStatusEnum.AdServingOptimizationStatus ad_serving_optimization_status = 8; + + // Immutable. The primary serving target for ads within the campaign. + // The targeting options can be refined in `network_settings`. + // + // This field is required and should not be empty when creating new + // campaigns. + // + // Can be set only when creating campaigns. + // After the campaign is created, the field can not be changed. + google.ads.googleads.v3.enums.AdvertisingChannelTypeEnum.AdvertisingChannelType advertising_channel_type = 9 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Optional refinement to `advertising_channel_type`. + // Must be a valid sub-type of the parent channel type. + // + // Can be set only when creating campaigns. + // After campaign is created, the field can not be changed. + google.ads.googleads.v3.enums.AdvertisingChannelSubTypeEnum.AdvertisingChannelSubType advertising_channel_sub_type = 10 [(google.api.field_behavior) = IMMUTABLE]; + + // The URL template for constructing a tracking URL. + google.protobuf.StringValue tracking_url_template = 11; + + // The list of mappings used to substitute custom parameter tags in a + // `tracking_url_template`, `final_urls`, or `mobile_final_urls`. + repeated google.ads.googleads.v3.common.CustomParameter url_custom_parameters = 12; + + // Settings for Real-Time Bidding, a feature only available for campaigns + // targeting the Ad Exchange network. + google.ads.googleads.v3.common.RealTimeBiddingSetting real_time_bidding_setting = 39; + + // The network settings for the campaign. + NetworkSettings network_settings = 14; + + // Immutable. The hotel setting for the campaign. + HotelSettingInfo hotel_setting = 32 [(google.api.field_behavior) = IMMUTABLE]; + + // The setting for controlling Dynamic Search Ads (DSA). + DynamicSearchAdsSetting dynamic_search_ads_setting = 33; + + // The setting for controlling Shopping campaigns. + ShoppingSetting shopping_setting = 36; + + // Setting for targeting related features. + google.ads.googleads.v3.common.TargetingSetting targeting_setting = 43; + + // The setting for ads geotargeting. + GeoTargetTypeSetting geo_target_type_setting = 47; + + // The setting related to App Campaign. + AppCampaignSetting app_campaign_setting = 51; + + // Output only. The resource names of labels attached to this campaign. + repeated google.protobuf.StringValue labels = 53 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignLabel" + } + ]; + + // Output only. The type of campaign: normal, draft, or experiment. + google.ads.googleads.v3.enums.CampaignExperimentTypeEnum.CampaignExperimentType experiment_type = 17 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The resource name of the base campaign of a draft or experiment campaign. + // For base campaigns, this is equal to `resource_name`. + // + // This field is read-only. + google.protobuf.StringValue base_campaign = 28 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; + + // The budget of the campaign. + google.protobuf.StringValue campaign_budget = 6 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignBudget" + }]; + + // Output only. The type of bidding strategy. + // + // A bidding strategy can be created by setting either the bidding scheme to + // create a standard bidding strategy or the `bidding_strategy` field to + // create a portfolio bidding strategy. + // + // This field is read-only. + google.ads.googleads.v3.enums.BiddingStrategyTypeEnum.BiddingStrategyType bidding_strategy_type = 22 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The date when campaign started. + // + // This field must not be used in WHERE clauses. + google.protobuf.StringValue start_date = 19; + + // The date when campaign ended. + // + // This field must not be used in WHERE clauses. + google.protobuf.StringValue end_date = 20; + + // Suffix used to append query parameters to landing pages that are served + // with parallel tracking. + google.protobuf.StringValue final_url_suffix = 38; + + // A list that limits how often each user will see this campaign's ads. + repeated google.ads.googleads.v3.common.FrequencyCapEntry frequency_caps = 40; + + // Output only. 3-Tier Brand Safety setting for the campaign. + google.ads.googleads.v3.enums.BrandSafetySuitabilityEnum.BrandSafetySuitability video_brand_safety_suitability = 42 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Describes how unbranded pharma ads will be displayed. + VanityPharma vanity_pharma = 44; + + // Selective optimization setting for this campaign, which includes a set of + // conversion actions to optimize this campaign towards. + SelectiveOptimization selective_optimization = 45; + + // Output only. Campaign-level settings for tracking information. + TrackingSetting tracking_setting = 46 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Payment mode for the campaign. + google.ads.googleads.v3.enums.PaymentModeEnum.PaymentMode payment_mode = 52; + + // Output only. Optimization score of the campaign. + // + // Optimization score is an estimate of how well a campaign is set to perform. + // It ranges from 0% (0.0) to 100% (1.0), with 100% indicating that the + // campaign is performing at full potential. + // + // See "About optimization score" at + // https://support.google.com/google-ads/answer/9061546. + // + // This field is read-only. + google.protobuf.DoubleValue optimization_score = 55 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The bidding strategy for the campaign. + // + // Must be either portfolio (created via BiddingStrategy service) or + // standard, that is embedded into the campaign. + oneof campaign_bidding_strategy { + // Portfolio bidding strategy used by campaign. + google.protobuf.StringValue bidding_strategy = 23 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/BiddingStrategy" + }]; + + // Commission is an automatic bidding strategy in which the advertiser pays + // a certain portion of the conversion value. + google.ads.googleads.v3.common.Commission commission = 49; + + // Standard Manual CPC bidding strategy. + // Manual click-based bidding where user pays per click. + google.ads.googleads.v3.common.ManualCpc manual_cpc = 24; + + // Standard Manual CPM bidding strategy. + // Manual impression-based bidding where user pays per thousand + // impressions. + google.ads.googleads.v3.common.ManualCpm manual_cpm = 25; + + // Output only. A bidding strategy that pays a configurable amount per video view. + google.ads.googleads.v3.common.ManualCpv manual_cpv = 37 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Standard Maximize Conversions bidding strategy that automatically + // maximizes number of conversions given a daily budget. + google.ads.googleads.v3.common.MaximizeConversions maximize_conversions = 30; + + // Standard Maximize Conversion Value bidding strategy that automatically + // sets bids to maximize revenue while spending your budget. + google.ads.googleads.v3.common.MaximizeConversionValue maximize_conversion_value = 31; + + // Standard Target CPA bidding strategy that automatically sets bids to + // help get as many conversions as possible at the target + // cost-per-acquisition (CPA) you set. + google.ads.googleads.v3.common.TargetCpa target_cpa = 26; + + // Target Impression Share bidding strategy. An automated bidding strategy + // that sets bids to achieve a desired percentage of impressions. + google.ads.googleads.v3.common.TargetImpressionShare target_impression_share = 48; + + // Standard Target ROAS bidding strategy that automatically maximizes + // revenue while averaging a specific target return on ad spend (ROAS). + google.ads.googleads.v3.common.TargetRoas target_roas = 29; + + // Standard Target Spend bidding strategy that automatically sets your bids + // to help get as many clicks as possible within your budget. + google.ads.googleads.v3.common.TargetSpend target_spend = 27; + + // Standard Percent Cpc bidding strategy where bids are a fraction of the + // advertised price for some good or service. + google.ads.googleads.v3.common.PercentCpc percent_cpc = 34; + + // A bidding strategy that automatically optimizes cost per thousand + // impressions. + google.ads.googleads.v3.common.TargetCpm target_cpm = 41; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/campaign_audience_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/campaign_audience_view.proto new file mode 100644 index 000000000..a68968694 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/campaign_audience_view.proto @@ -0,0 +1,55 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "CampaignAudienceViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the campaign audience view resource. + +// A campaign audience view. +// Includes performance data from interests and remarketing lists for Display +// Network and YouTube Network ads, and remarketing lists for search ads (RLSA), +// aggregated by campaign and audience criterion. This view only includes +// audiences attached at the campaign level. +message CampaignAudienceView { + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignAudienceView" + pattern: "customers/{customer}/campaignAudienceViews/{campaign_audience_view}" + }; + + // Output only. The resource name of the campaign audience view. + // Campaign audience view resource names have the form: + // + // `customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignAudienceView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/campaign_bid_modifier.proto b/third_party/googleapis/google/ads/googleads/v3/resources/campaign_bid_modifier.proto new file mode 100644 index 000000000..0a5ce82f1 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/campaign_bid_modifier.proto @@ -0,0 +1,75 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/criteria.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "CampaignBidModifierProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the Campaign Bid Modifier resource. + +// Represents a bid-modifiable only criterion at the campaign level. +message CampaignBidModifier { + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignBidModifier" + pattern: "customers/{customer}/campaignBidModifiers/{campaign_bid_modifier}" + }; + + // Immutable. The resource name of the campaign bid modifier. + // Campaign bid modifier resource names have the form: + // + // `customers/{customer_id}/campaignBidModifiers/{campaign_id}~{criterion_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignBidModifier" + } + ]; + + // Output only. The campaign to which this criterion belongs. + google.protobuf.StringValue campaign = 2 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; + + // Output only. The ID of the criterion to bid modify. + // + // This field is ignored for mutates. + google.protobuf.Int64Value criterion_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The modifier for the bid when the criterion matches. + google.protobuf.DoubleValue bid_modifier = 4; + + // The criterion of this campaign bid modifier. + oneof criterion { + // Immutable. Criterion for interaction type. Only supported for search campaigns. + google.ads.googleads.v3.common.InteractionTypeInfo interaction_type = 5 [(google.api.field_behavior) = IMMUTABLE]; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/campaign_budget.proto b/third_party/googleapis/google/ads/googleads/v3/resources/campaign_budget.proto new file mode 100644 index 000000000..46b1a7a34 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/campaign_budget.proto @@ -0,0 +1,157 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/budget_delivery_method.proto"; +import "google/ads/googleads/v3/enums/budget_period.proto"; +import "google/ads/googleads/v3/enums/budget_status.proto"; +import "google/ads/googleads/v3/enums/budget_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "CampaignBudgetProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the Budget resource. + +// A campaign budget. +message CampaignBudget { + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignBudget" + pattern: "customers/{customer}/campaignBudgets/{campaign_budget}" + }; + + // Immutable. The resource name of the campaign budget. + // Campaign budget resource names have the form: + // + // `customers/{customer_id}/campaignBudgets/{budget_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignBudget" + } + ]; + + // Output only. The ID of the campaign budget. + // + // A campaign budget is created using the CampaignBudgetService create + // operation and is assigned a budget ID. A budget ID can be shared across + // different campaigns; the system will then allocate the campaign budget + // among different campaigns to get optimum results. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The name of the campaign budget. + // + // When creating a campaign budget through CampaignBudgetService, every + // explicitly shared campaign budget must have a non-null, non-empty name. + // Campaign budgets that are not explicitly shared derive their name from the + // attached campaign's name. + // + // The length of this string must be between 1 and 255, inclusive, + // in UTF-8 bytes, (trimmed). + google.protobuf.StringValue name = 4; + + // The amount of the budget, in the local currency for the account. + // Amount is specified in micros, where one million is equivalent to one + // currency unit. Monthly spend is capped at 30.4 times this amount. + google.protobuf.Int64Value amount_micros = 5; + + // The lifetime amount of the budget, in the local currency for the account. + // Amount is specified in micros, where one million is equivalent to one + // currency unit. + google.protobuf.Int64Value total_amount_micros = 10; + + // Output only. The status of this campaign budget. This field is read-only. + google.ads.googleads.v3.enums.BudgetStatusEnum.BudgetStatus status = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The delivery method that determines the rate at which the campaign budget + // is spent. + // + // Defaults to STANDARD if unspecified in a create operation. + google.ads.googleads.v3.enums.BudgetDeliveryMethodEnum.BudgetDeliveryMethod delivery_method = 7; + + // Specifies whether the budget is explicitly shared. Defaults to true if + // unspecified in a create operation. + // + // If true, the budget was created with the purpose of sharing + // across one or more campaigns. + // + // If false, the budget was created with the intention of only being used + // with a single campaign. The budget's name and status will stay in sync + // with the campaign's name and status. Attempting to share the budget with a + // second campaign will result in an error. + // + // A non-shared budget can become an explicitly shared. The same operation + // must also assign the budget a name. + // + // A shared campaign budget can never become non-shared. + google.protobuf.BoolValue explicitly_shared = 8; + + // Output only. The number of campaigns actively using the budget. + // + // This field is read-only. + google.protobuf.Int64Value reference_count = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Indicates whether there is a recommended budget for this campaign budget. + // + // This field is read-only. + google.protobuf.BoolValue has_recommended_budget = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The recommended budget amount. If no recommendation is available, this will + // be set to the budget amount. + // Amount is specified in micros, where one million is equivalent to one + // currency unit. + // + // This field is read-only. + google.protobuf.Int64Value recommended_budget_amount_micros = 12 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. Period over which to spend the budget. Defaults to DAILY if not specified. + google.ads.googleads.v3.enums.BudgetPeriodEnum.BudgetPeriod period = 13 [(google.api.field_behavior) = IMMUTABLE]; + + // Output only. The estimated change in weekly clicks if the recommended budget is applied. + // + // This field is read-only. + google.protobuf.Int64Value recommended_budget_estimated_change_weekly_clicks = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The estimated change in weekly cost in micros if the recommended budget is + // applied. One million is equivalent to one currency unit. + // + // This field is read-only. + google.protobuf.Int64Value recommended_budget_estimated_change_weekly_cost_micros = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The estimated change in weekly interactions if the recommended budget is + // applied. + // + // This field is read-only. + google.protobuf.Int64Value recommended_budget_estimated_change_weekly_interactions = 16 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The estimated change in weekly views if the recommended budget is applied. + // + // This field is read-only. + google.protobuf.Int64Value recommended_budget_estimated_change_weekly_views = 17 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. The type of the campaign budget. + google.ads.googleads.v3.enums.BudgetTypeEnum.BudgetType type = 18 [(google.api.field_behavior) = IMMUTABLE]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/campaign_criterion.proto b/third_party/googleapis/google/ads/googleads/v3/resources/campaign_criterion.proto new file mode 100644 index 000000000..3a84f0b31 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/campaign_criterion.proto @@ -0,0 +1,168 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/criteria.proto"; +import "google/ads/googleads/v3/enums/campaign_criterion_status.proto"; +import "google/ads/googleads/v3/enums/criterion_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "CampaignCriterionProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the Campaign Criterion resource. + +// A campaign criterion. +message CampaignCriterion { + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignCriterion" + pattern: "customers/{customer}/campaignCriteria/{campaign_criterion}" + }; + + // Immutable. The resource name of the campaign criterion. + // Campaign criterion resource names have the form: + // + // `customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignCriterion" + } + ]; + + // Immutable. The campaign to which the criterion belongs. + google.protobuf.StringValue campaign = 4 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; + + // Output only. The ID of the criterion. + // + // This field is ignored during mutate. + google.protobuf.Int64Value criterion_id = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The modifier for the bids when the criterion matches. The modifier must be + // in the range: 0.1 - 10.0. Most targetable criteria types support modifiers. + // Use 0 to opt out of a Device type. + google.protobuf.FloatValue bid_modifier = 14; + + // Immutable. Whether to target (`false`) or exclude (`true`) the criterion. + google.protobuf.BoolValue negative = 7 [(google.api.field_behavior) = IMMUTABLE]; + + // Output only. The type of the criterion. + google.ads.googleads.v3.enums.CriterionTypeEnum.CriterionType type = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The status of the criterion. + google.ads.googleads.v3.enums.CampaignCriterionStatusEnum.CampaignCriterionStatus status = 35; + + // The campaign criterion. + // + // Exactly one must be set. + oneof criterion { + // Immutable. Keyword. + google.ads.googleads.v3.common.KeywordInfo keyword = 8 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Placement. + google.ads.googleads.v3.common.PlacementInfo placement = 9 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Mobile app category. + google.ads.googleads.v3.common.MobileAppCategoryInfo mobile_app_category = 10 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Mobile application. + google.ads.googleads.v3.common.MobileApplicationInfo mobile_application = 11 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Location. + google.ads.googleads.v3.common.LocationInfo location = 12 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Device. + google.ads.googleads.v3.common.DeviceInfo device = 13 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Ad Schedule. + google.ads.googleads.v3.common.AdScheduleInfo ad_schedule = 15 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Age range. + google.ads.googleads.v3.common.AgeRangeInfo age_range = 16 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Gender. + google.ads.googleads.v3.common.GenderInfo gender = 17 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Income range. + google.ads.googleads.v3.common.IncomeRangeInfo income_range = 18 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Parental status. + google.ads.googleads.v3.common.ParentalStatusInfo parental_status = 19 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. User List. + google.ads.googleads.v3.common.UserListInfo user_list = 22 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. YouTube Video. + google.ads.googleads.v3.common.YouTubeVideoInfo youtube_video = 20 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. YouTube Channel. + google.ads.googleads.v3.common.YouTubeChannelInfo youtube_channel = 21 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Proximity. + google.ads.googleads.v3.common.ProximityInfo proximity = 23 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Topic. + google.ads.googleads.v3.common.TopicInfo topic = 24 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Listing scope. + google.ads.googleads.v3.common.ListingScopeInfo listing_scope = 25 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Language. + google.ads.googleads.v3.common.LanguageInfo language = 26 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. IpBlock. + google.ads.googleads.v3.common.IpBlockInfo ip_block = 27 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. ContentLabel. + google.ads.googleads.v3.common.ContentLabelInfo content_label = 28 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Carrier. + google.ads.googleads.v3.common.CarrierInfo carrier = 29 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. User Interest. + google.ads.googleads.v3.common.UserInterestInfo user_interest = 30 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Webpage. + google.ads.googleads.v3.common.WebpageInfo webpage = 31 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Operating system version. + google.ads.googleads.v3.common.OperatingSystemVersionInfo operating_system_version = 32 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Mobile Device. + google.ads.googleads.v3.common.MobileDeviceInfo mobile_device = 33 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Location Group + google.ads.googleads.v3.common.LocationGroupInfo location_group = 34 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Custom Affinity. + google.ads.googleads.v3.common.CustomAffinityInfo custom_affinity = 36 [(google.api.field_behavior) = IMMUTABLE]; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/campaign_criterion_simulation.proto b/third_party/googleapis/google/ads/googleads/v3/resources/campaign_criterion_simulation.proto new file mode 100644 index 000000000..f57a3ba76 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/campaign_criterion_simulation.proto @@ -0,0 +1,85 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/simulation.proto"; +import "google/ads/googleads/v3/enums/simulation_modification_method.proto"; +import "google/ads/googleads/v3/enums/simulation_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "CampaignCriterionSimulationProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the campaign criterion simulation resource. + +// A campaign criterion simulation. Supported combinations of advertising +// channel type, criterion ids, simulation type and simulation modification +// method is detailed below respectively. +// +// 1. SEARCH - 30000,30001,30002 - BID_MODIFIER - UNIFORM +// 2. SHOPPING - 30000,30001,30002 - BID_MODIFIER - UNIFORM +// 3. DISPLAY - 30001 - BID_MODIFIER - UNIFORM +message CampaignCriterionSimulation { + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignCriterionSimulation" + pattern: "customers/{customer}/campaignCriterionSimulations/{campaign_criterion_simulation}" + }; + + // Output only. The resource name of the campaign criterion simulation. + // Campaign criterion simulation resource names have the form: + // + // `customers/{customer_id}/campaignCriterionSimulations/{campaign_id}~{criterion_id}~{type}~{modification_method}~{start_date}~{end_date}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignCriterionSimulation" + } + ]; + + // Output only. Campaign ID of the simulation. + google.protobuf.Int64Value campaign_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Criterion ID of the simulation. + google.protobuf.Int64Value criterion_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The field that the simulation modifies. + google.ads.googleads.v3.enums.SimulationTypeEnum.SimulationType type = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. How the simulation modifies the field. + google.ads.googleads.v3.enums.SimulationModificationMethodEnum.SimulationModificationMethod modification_method = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. First day on which the simulation is based, in YYYY-MM-DD format. + google.protobuf.StringValue start_date = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Last day on which the simulation is based, in YYYY-MM-DD format. + google.protobuf.StringValue end_date = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // List of simulation points. + oneof point_list { + // Output only. Simulation points if the simulation type is BID_MODIFIER. + google.ads.googleads.v3.common.BidModifierSimulationPointList bid_modifier_point_list = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/campaign_draft.proto b/third_party/googleapis/google/ads/googleads/v3/resources/campaign_draft.proto new file mode 100644 index 000000000..6e3601b68 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/campaign_draft.proto @@ -0,0 +1,99 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/campaign_draft_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "CampaignDraftProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the Campaign Draft resource. + +// A campaign draft. +message CampaignDraft { + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignDraft" + pattern: "customers/{customer}/campaignDrafts/{campaign_draft}" + }; + + // Immutable. The resource name of the campaign draft. + // Campaign draft resource names have the form: + // + // `customers/{customer_id}/campaignDrafts/{base_campaign_id}~{draft_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignDraft" + } + ]; + + // Output only. The ID of the draft. + // + // This field is read-only. + google.protobuf.Int64Value draft_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. The base campaign to which the draft belongs. + google.protobuf.StringValue base_campaign = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; + + // The name of the campaign draft. + // + // This field is required and should not be empty when creating new + // campaign drafts. + // + // It must not contain any null (code point 0x0), NL line feed + // (code point 0xA) or carriage return (code point 0xD) characters. + google.protobuf.StringValue name = 4; + + // Output only. Resource name of the Campaign that results from overlaying the draft + // changes onto the base campaign. + // + // This field is read-only. + google.protobuf.StringValue draft_campaign = 5 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; + + // Output only. The status of the campaign draft. This field is read-only. + // + // When a new campaign draft is added, the status defaults to PROPOSED. + google.ads.googleads.v3.enums.CampaignDraftStatusEnum.CampaignDraftStatus status = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Whether there is an experiment based on this draft currently serving. + google.protobuf.BoolValue has_experiment_running = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The resource name of the long-running operation that can be used to poll + // for completion of draft promotion. This is only set if the draft promotion + // is in progress or finished. + google.protobuf.StringValue long_running_operation = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/campaign_experiment.proto b/third_party/googleapis/google/ads/googleads/v3/resources/campaign_experiment.proto new file mode 100644 index 000000000..a02838ba5 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/campaign_experiment.proto @@ -0,0 +1,122 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/campaign_experiment_status.proto"; +import "google/ads/googleads/v3/enums/campaign_experiment_traffic_split_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "CampaignExperimentProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the Campaign Experiment resource. + +// An A/B experiment that compares the performance of the base campaign +// (the control) and a variation of that campaign (the experiment). +message CampaignExperiment { + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignExperiment" + pattern: "customers/{customer}/campaignExperiments/{campaign_experiment}" + }; + + // Immutable. The resource name of the campaign experiment. + // Campaign experiment resource names have the form: + // + // `customers/{customer_id}/campaignExperiments/{campaign_experiment_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignExperiment" + } + ]; + + // Output only. The ID of the campaign experiment. + // + // This field is read-only. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. The campaign draft with staged changes to the base campaign. + google.protobuf.StringValue campaign_draft = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignDraft" + } + ]; + + // The name of the campaign experiment. + // + // This field is required when creating new campaign experiments + // and must not conflict with the name of another non-removed + // campaign experiment or campaign. + // + // It must not contain any null (code point 0x0), NL line feed + // (code point 0xA) or carriage return (code point 0xD) characters. + google.protobuf.StringValue name = 4; + + // The description of the experiment. + google.protobuf.StringValue description = 5; + + // Immutable. Share of traffic directed to experiment as a percent (must be between 1 and + // 99 inclusive. Base campaign receives the remainder of the traffic + // (100 - traffic_split_percent). Required for create. + google.protobuf.Int64Value traffic_split_percent = 6 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Determines the behavior of the traffic split. + google.ads.googleads.v3.enums.CampaignExperimentTrafficSplitTypeEnum.CampaignExperimentTrafficSplitType traffic_split_type = 7 [(google.api.field_behavior) = IMMUTABLE]; + + // Output only. The experiment campaign, as opposed to the base campaign. + google.protobuf.StringValue experiment_campaign = 8 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; + + // Output only. The status of the campaign experiment. This field is read-only. + google.ads.googleads.v3.enums.CampaignExperimentStatusEnum.CampaignExperimentStatus status = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The resource name of the long-running operation that can be used to poll + // for completion of experiment create or promote. The most recent long + // running operation is returned. + google.protobuf.StringValue long_running_operation = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Date when the campaign experiment starts. By default, the experiment starts + // now or on the campaign's start date, whichever is later. If this field is + // set, then the experiment starts at the beginning of the specified date in + // the customer's time zone. Cannot be changed once the experiment starts. + // + // Format: YYYY-MM-DD + // Example: 2019-03-14 + google.protobuf.StringValue start_date = 11; + + // Date when the campaign experiment ends. By default, the experiment ends on + // the campaign's end date. If this field is set, then the experiment ends at + // the end of the specified date in the customer's time zone. + // + // Format: YYYY-MM-DD + // Example: 2019-04-18 + google.protobuf.StringValue end_date = 12; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/campaign_extension_setting.proto b/third_party/googleapis/google/ads/googleads/v3/resources/campaign_extension_setting.proto new file mode 100644 index 000000000..32758f7e4 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/campaign_extension_setting.proto @@ -0,0 +1,80 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/extension_setting_device.proto"; +import "google/ads/googleads/v3/enums/extension_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "CampaignExtensionSettingProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the CampaignExtensionSetting resource. + +// A campaign extension setting. +message CampaignExtensionSetting { + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignExtensionSetting" + pattern: "customers/{customer}/campaignExtensionSettings/{campaign_extension_setting}" + }; + + // Immutable. The resource name of the campaign extension setting. + // CampaignExtensionSetting resource names have the form: + // + // `customers/{customer_id}/campaignExtensionSettings/{campaign_id}~{extension_type}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignExtensionSetting" + } + ]; + + // Immutable. The extension type of the customer extension setting. + google.ads.googleads.v3.enums.ExtensionTypeEnum.ExtensionType extension_type = 2 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. The resource name of the campaign. The linked extension feed items will + // serve under this campaign. + // Campaign resource names have the form: + // + // `customers/{customer_id}/campaigns/{campaign_id}` + google.protobuf.StringValue campaign = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; + + // The resource names of the extension feed items to serve under the campaign. + // ExtensionFeedItem resource names have the form: + // + // `customers/{customer_id}/extensionFeedItems/{feed_item_id}` + repeated google.protobuf.StringValue extension_feed_items = 4 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/ExtensionFeedItem" + }]; + + // The device for which the extensions will serve. Optional. + google.ads.googleads.v3.enums.ExtensionSettingDeviceEnum.ExtensionSettingDevice device = 5; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/campaign_feed.proto b/third_party/googleapis/google/ads/googleads/v3/resources/campaign_feed.proto new file mode 100644 index 000000000..7836d161a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/campaign_feed.proto @@ -0,0 +1,84 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/matching_function.proto"; +import "google/ads/googleads/v3/enums/feed_link_status.proto"; +import "google/ads/googleads/v3/enums/placeholder_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "CampaignFeedProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the CampaignFeed resource. + +// A campaign feed. +message CampaignFeed { + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignFeed" + pattern: "customers/{customer}/campaignFeeds/{campaign_feed}" + }; + + // Immutable. The resource name of the campaign feed. + // Campaign feed resource names have the form: + // + // `customers/{customer_id}/campaignFeeds/{campaign_id}~{feed_id} + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignFeed" + } + ]; + + // Immutable. The feed to which the CampaignFeed belongs. + google.protobuf.StringValue feed = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; + + // Immutable. The campaign to which the CampaignFeed belongs. + google.protobuf.StringValue campaign = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; + + // Indicates which placeholder types the feed may populate under the connected + // campaign. Required. + repeated google.ads.googleads.v3.enums.PlaceholderTypeEnum.PlaceholderType placeholder_types = 4; + + // Matching function associated with the CampaignFeed. + // The matching function is used to filter the set of feed items selected. + // Required. + google.ads.googleads.v3.common.MatchingFunction matching_function = 5; + + // Output only. Status of the campaign feed. + // This field is read-only. + google.ads.googleads.v3.enums.FeedLinkStatusEnum.FeedLinkStatus status = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/campaign_label.proto b/third_party/googleapis/google/ads/googleads/v3/resources/campaign_label.proto new file mode 100644 index 000000000..8a92f5fa0 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/campaign_label.proto @@ -0,0 +1,67 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "CampaignLabelProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the campaign label resource. + +// Represents a relationship between a campaign and a label. +message CampaignLabel { + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignLabel" + pattern: "customers/{customer}/campaignLabels/{campaign_label}" + }; + + // Immutable. Name of the resource. + // Campaign label resource names have the form: + // `customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignLabel" + } + ]; + + // Immutable. The campaign to which the label is attached. + google.protobuf.StringValue campaign = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; + + // Immutable. The label assigned to the campaign. + google.protobuf.StringValue label = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Label" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/campaign_shared_set.proto b/third_party/googleapis/google/ads/googleads/v3/resources/campaign_shared_set.proto new file mode 100644 index 000000000..2dab3234e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/campaign_shared_set.proto @@ -0,0 +1,78 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/campaign_shared_set_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "CampaignSharedSetProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the CampaignSharedSet resource. + +// CampaignSharedSets are used for managing the shared sets associated with a +// campaign. +message CampaignSharedSet { + option (google.api.resource) = { + type: "googleads.googleapis.com/CampaignSharedSet" + pattern: "customers/{customer}/campaignSharedSets/{campaign_shared_set}" + }; + + // Immutable. The resource name of the campaign shared set. + // Campaign shared set resource names have the form: + // + // `customers/{customer_id}/campaignSharedSets/{campaign_id}~{shared_set_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignSharedSet" + } + ]; + + // Immutable. The campaign to which the campaign shared set belongs. + google.protobuf.StringValue campaign = 3 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; + + // Immutable. The shared set associated with the campaign. This may be a negative keyword + // shared set of another customer. This customer should be a manager of the + // other customer, otherwise the campaign shared set will exist but have no + // serving effect. Only negative keyword shared sets can be associated with + // Shopping campaigns. Only negative placement shared sets can be associated + // with Display mobile app campaigns. + google.protobuf.StringValue shared_set = 4 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/SharedSet" + } + ]; + + // Output only. The status of this campaign shared set. Read only. + google.ads.googleads.v3.enums.CampaignSharedSetStatusEnum.CampaignSharedSetStatus status = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/carrier_constant.proto b/third_party/googleapis/google/ads/googleads/v3/resources/carrier_constant.proto new file mode 100644 index 000000000..b892f3e4f --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/carrier_constant.proto @@ -0,0 +1,62 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "CarrierConstantProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the Carrier constant resource. + +// A carrier criterion that can be used in campaign targeting. +message CarrierConstant { + option (google.api.resource) = { + type: "googleads.googleapis.com/CarrierConstant" + pattern: "carrierConstants/{carrier_constant}" + }; + + // Output only. The resource name of the carrier criterion. + // Carrier criterion resource names have the form: + // + // `carrierConstants/{criterion_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CarrierConstant" + } + ]; + + // Output only. The ID of the carrier criterion. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The full name of the carrier in English. + google.protobuf.StringValue name = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The country code of the country where the carrier is located, e.g., "AR", + // "FR", etc. + google.protobuf.StringValue country_code = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/change_status.proto b/third_party/googleapis/google/ads/googleads/v3/resources/change_status.proto new file mode 100644 index 000000000..9c54a236c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/change_status.proto @@ -0,0 +1,145 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/change_status_operation.proto"; +import "google/ads/googleads/v3/enums/change_status_resource_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "ChangeStatusProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the Change Status resource. + +// Describes the status of returned resource. +message ChangeStatus { + option (google.api.resource) = { + type: "googleads.googleapis.com/ChangeStatus" + pattern: "customers/{customer}/changeStatus/{change_status}" + }; + + // Output only. The resource name of the change status. + // Change status resource names have the form: + // + // `customers/{customer_id}/changeStatus/{change_status_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ChangeStatus" + } + ]; + + // Output only. Time at which the most recent change has occurred on this resource. + google.protobuf.StringValue last_change_date_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Represents the type of the changed resource. This dictates what fields + // will be set. For example, for AD_GROUP, campaign and ad_group fields will + // be set. + google.ads.googleads.v3.enums.ChangeStatusResourceTypeEnum.ChangeStatusResourceType resource_type = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The Campaign affected by this change. + google.protobuf.StringValue campaign = 5 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; + + // Output only. The AdGroup affected by this change. + google.protobuf.StringValue ad_group = 6 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; + + // Output only. Represents the status of the changed resource. + google.ads.googleads.v3.enums.ChangeStatusOperationEnum.ChangeStatusOperation resource_status = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The AdGroupAd affected by this change. + google.protobuf.StringValue ad_group_ad = 9 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAd" + } + ]; + + // Output only. The AdGroupCriterion affected by this change. + google.protobuf.StringValue ad_group_criterion = 10 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterion" + } + ]; + + // Output only. The CampaignCriterion affected by this change. + google.protobuf.StringValue campaign_criterion = 11 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignCriterion" + } + ]; + + // Output only. The Feed affected by this change. + google.protobuf.StringValue feed = 12 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; + + // Output only. The FeedItem affected by this change. + google.protobuf.StringValue feed_item = 13 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedItem" + } + ]; + + // Output only. The AdGroupFeed affected by this change. + google.protobuf.StringValue ad_group_feed = 14 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupFeed" + } + ]; + + // Output only. The CampaignFeed affected by this change. + google.protobuf.StringValue campaign_feed = 15 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignFeed" + } + ]; + + // Output only. The AdGroupBidModifier affected by this change. + google.protobuf.StringValue ad_group_bid_modifier = 16 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupBidModifier" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/click_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/click_view.proto new file mode 100644 index 000000000..216e207e4 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/click_view.proto @@ -0,0 +1,80 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/click_location.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "ClickViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the ClickView resource. + +// A click view with metrics aggregated at each click level, including both +// valid and invalid clicks. For non-Search campaigns, metrics.clicks +// represents the number of valid and invalid interactions. +// Queries including ClickView must have a filter limiting the results to one +// day and can be requested for dates back to 90 days before the time of the +// request. +message ClickView { + option (google.api.resource) = { + type: "googleads.googleapis.com/ClickView" + pattern: "customers/{customer}/clickViews/{click_view}" + }; + + // Output only. The resource name of the click view. + // Click view resource names have the form: + // + // `customers/{customer_id}/clickViews/{date (yyyy-MM-dd)}~{gclid}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ClickView" + } + ]; + + // Output only. The Google Click ID. + google.protobuf.StringValue gclid = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The location criteria matching the area of interest associated with the + // impression. + google.ads.googleads.v3.common.ClickLocation area_of_interest = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The location criteria matching the location of presence associated with the + // impression. + google.ads.googleads.v3.common.ClickLocation location_of_presence = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Page number in search results where the ad was shown. + google.protobuf.Int64Value page_number = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The associated ad. + google.protobuf.StringValue ad_group_ad = 7 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAd" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/conversion_action.proto b/third_party/googleapis/google/ads/googleads/v3/resources/conversion_action.proto new file mode 100644 index 000000000..b5a33d3c6 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/conversion_action.proto @@ -0,0 +1,144 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/tag_snippet.proto"; +import "google/ads/googleads/v3/enums/attribution_model.proto"; +import "google/ads/googleads/v3/enums/conversion_action_category.proto"; +import "google/ads/googleads/v3/enums/conversion_action_counting_type.proto"; +import "google/ads/googleads/v3/enums/conversion_action_status.proto"; +import "google/ads/googleads/v3/enums/conversion_action_type.proto"; +import "google/ads/googleads/v3/enums/data_driven_model_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "ConversionActionProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the Conversion Action resource. + +// A conversion action. +message ConversionAction { + option (google.api.resource) = { + type: "googleads.googleapis.com/ConversionAction" + pattern: "customers/{customer}/conversionActions/{conversion_action}" + }; + + // Settings related to this conversion action's attribution model. + message AttributionModelSettings { + // The attribution model type of this conversion action. + google.ads.googleads.v3.enums.AttributionModelEnum.AttributionModel attribution_model = 1; + + // Output only. The status of the data-driven attribution model for the conversion + // action. + google.ads.googleads.v3.enums.DataDrivenModelStatusEnum.DataDrivenModelStatus data_driven_model_status = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // Settings related to the value for conversion events associated with this + // conversion action. + message ValueSettings { + // The value to use when conversion events for this conversion action are + // sent with an invalid, disallowed or missing value, or when + // this conversion action is configured to always use the default value. + google.protobuf.DoubleValue default_value = 1; + + // The currency code to use when conversion events for this conversion + // action are sent with an invalid or missing currency code, or when this + // conversion action is configured to always use the default value. + google.protobuf.StringValue default_currency_code = 2; + + // Controls whether the default value and default currency code are used in + // place of the value and currency code specified in conversion events for + // this conversion action. + google.protobuf.BoolValue always_use_default_value = 3; + } + + // Immutable. The resource name of the conversion action. + // Conversion action resource names have the form: + // + // `customers/{customer_id}/conversionActions/{conversion_action_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ConversionAction" + } + ]; + + // Output only. The ID of the conversion action. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The name of the conversion action. + // + // This field is required and should not be empty when creating new + // conversion actions. + google.protobuf.StringValue name = 3; + + // The status of this conversion action for conversion event accrual. + google.ads.googleads.v3.enums.ConversionActionStatusEnum.ConversionActionStatus status = 4; + + // Immutable. The type of this conversion action. + google.ads.googleads.v3.enums.ConversionActionTypeEnum.ConversionActionType type = 5 [(google.api.field_behavior) = IMMUTABLE]; + + // The category of conversions reported for this conversion action. + google.ads.googleads.v3.enums.ConversionActionCategoryEnum.ConversionActionCategory category = 6; + + // Output only. The resource name of the conversion action owner customer, or null if this + // is a system-defined conversion action. + google.protobuf.StringValue owner_customer = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Whether this conversion action should be included in the "conversions" + // metric. + google.protobuf.BoolValue include_in_conversions_metric = 8; + + // The maximum number of days that may elapse between an interaction + // (e.g., a click) and a conversion event. + google.protobuf.Int64Value click_through_lookback_window_days = 9; + + // The maximum number of days which may elapse between an impression and a + // conversion without an interaction. + google.protobuf.Int64Value view_through_lookback_window_days = 10; + + // Settings related to the value for conversion events associated with this + // conversion action. + ValueSettings value_settings = 11; + + // How to count conversion events for the conversion action. + google.ads.googleads.v3.enums.ConversionActionCountingTypeEnum.ConversionActionCountingType counting_type = 12; + + // Settings related to this conversion action's attribution model. + AttributionModelSettings attribution_model_settings = 13; + + // Output only. The snippets used for tracking conversions. + repeated google.ads.googleads.v3.common.TagSnippet tag_snippets = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The phone call duration in seconds after which a conversion should be + // reported for this conversion action. + // + // The value must be between 0 and 10000, inclusive. + google.protobuf.Int64Value phone_call_duration_seconds = 15; + + // App ID for an app conversion action. + google.protobuf.StringValue app_id = 16; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/currency_constant.proto b/third_party/googleapis/google/ads/googleads/v3/resources/currency_constant.proto new file mode 100644 index 000000000..69be80653 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/currency_constant.proto @@ -0,0 +1,65 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "CurrencyConstantProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the Currency Constant resource. + +// A currency constant. +message CurrencyConstant { + option (google.api.resource) = { + type: "googleads.googleapis.com/CurrencyConstant" + pattern: "currencyConstants/{currency_constant}" + }; + + // Output only. The resource name of the currency constant. + // Currency constant resource names have the form: + // + // `currencyConstants/{currency_code}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CurrencyConstant" + } + ]; + + // Output only. ISO 4217 three-letter currency code, e.g. "USD" + google.protobuf.StringValue code = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Full English name of the currency. + google.protobuf.StringValue name = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Standard symbol for describing this currency, e.g. '$' for US Dollars. + google.protobuf.StringValue symbol = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The billable unit for this currency. Billed amounts should be multiples of + // this value. + google.protobuf.Int64Value billable_unit_micros = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/custom_interest.proto b/third_party/googleapis/google/ads/googleads/v3/resources/custom_interest.proto new file mode 100644 index 000000000..c2824decd --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/custom_interest.proto @@ -0,0 +1,90 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/custom_interest_member_type.proto"; +import "google/ads/googleads/v3/enums/custom_interest_status.proto"; +import "google/ads/googleads/v3/enums/custom_interest_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "CustomInterestProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the Custom Interest resource. + +// A custom interest. This is a list of users by interest. +message CustomInterest { + option (google.api.resource) = { + type: "googleads.googleapis.com/CustomInterest" + pattern: "customers/{customer}/customInterests/{custom_interest}" + }; + + // Immutable. The resource name of the custom interest. + // Custom interest resource names have the form: + // + // `customers/{customer_id}/customInterests/{custom_interest_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomInterest" + } + ]; + + // Output only. Id of the custom interest. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Status of this custom interest. Indicates whether the custom interest is + // enabled or removed. + google.ads.googleads.v3.enums.CustomInterestStatusEnum.CustomInterestStatus status = 3; + + // Name of the custom interest. It should be unique across the same custom + // affinity audience. + // This field is required for create operations. + google.protobuf.StringValue name = 4; + + // Type of the custom interest, CUSTOM_AFFINITY or CUSTOM_INTENT. + // By default the type is set to CUSTOM_AFFINITY. + google.ads.googleads.v3.enums.CustomInterestTypeEnum.CustomInterestType type = 5; + + // Description of this custom interest audience. + google.protobuf.StringValue description = 6; + + // List of custom interest members that this custom interest is composed of. + // Members can be added during CustomInterest creation. If members are + // presented in UPDATE operation, existing members will be overridden. + repeated CustomInterestMember members = 7; +} + +// A member of custom interest audience. A member can be a keyword or url. +// It is immutable, that is, it can only be created or removed but not changed. +message CustomInterestMember { + // The type of custom interest member, KEYWORD or URL. + google.ads.googleads.v3.enums.CustomInterestMemberTypeEnum.CustomInterestMemberType member_type = 1; + + // Keyword text when member_type is KEYWORD or URL string when + // member_type is URL. + google.protobuf.StringValue parameter = 2; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/customer.proto b/third_party/googleapis/google/ads/googleads/v3/resources/customer.proto new file mode 100644 index 000000000..7e4d3af1a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/customer.proto @@ -0,0 +1,138 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/customer_pay_per_conversion_eligibility_failure_reason.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "CustomerProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the Customer resource. + +// A customer. +message Customer { + option (google.api.resource) = { + type: "googleads.googleapis.com/Customer" + pattern: "customers/{customer}" + }; + + // Immutable. The resource name of the customer. + // Customer resource names have the form: + // + // `customers/{customer_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Customer" + } + ]; + + // Output only. The ID of the customer. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Optional, non-unique descriptive name of the customer. + google.protobuf.StringValue descriptive_name = 4; + + // Immutable. The currency in which the account operates. + // A subset of the currency codes from the ISO 4217 standard is + // supported. + google.protobuf.StringValue currency_code = 5 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. The local timezone ID of the customer. + google.protobuf.StringValue time_zone = 6 [(google.api.field_behavior) = IMMUTABLE]; + + // The URL template for constructing a tracking URL out of parameters. + google.protobuf.StringValue tracking_url_template = 7; + + // The URL template for appending params to the final URL + google.protobuf.StringValue final_url_suffix = 11; + + // Whether auto-tagging is enabled for the customer. + google.protobuf.BoolValue auto_tagging_enabled = 8; + + // Output only. Whether the Customer has a Partners program badge. If the Customer is not + // associated with the Partners program, this will be false. For more + // information, see https://support.google.com/partners/answer/3125774. + google.protobuf.BoolValue has_partners_badge = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Whether the customer is a manager. + google.protobuf.BoolValue manager = 12 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Whether the customer is a test account. + google.protobuf.BoolValue test_account = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Call reporting setting for a customer. + CallReportingSetting call_reporting_setting = 10; + + // Output only. Conversion tracking setting for a customer. + ConversionTrackingSetting conversion_tracking_setting = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Remarketing setting for a customer. + RemarketingSetting remarketing_setting = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Reasons why the customer is not eligible to use PaymentMode.CONVERSIONS. If + // the list is empty, the customer is eligible. This field is read-only. + repeated google.ads.googleads.v3.enums.CustomerPayPerConversionEligibilityFailureReasonEnum.CustomerPayPerConversionEligibilityFailureReason pay_per_conversion_eligibility_failure_reasons = 16 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// Call reporting setting for a customer. +message CallReportingSetting { + // Enable reporting of phone call events by redirecting them via Google + // System. + google.protobuf.BoolValue call_reporting_enabled = 1; + + // Whether to enable call conversion reporting. + google.protobuf.BoolValue call_conversion_reporting_enabled = 2; + + // Customer-level call conversion action to attribute a call conversion to. + // If not set a default conversion action is used. Only in effect when + // call_conversion_reporting_enabled is set to true. + google.protobuf.StringValue call_conversion_action = 9 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/ConversionAction" + }]; +} + +// A collection of customer-wide settings related to Google Ads Conversion +// Tracking. +message ConversionTrackingSetting { + // Output only. The conversion tracking id used for this account. This id is automatically + // assigned after any conversion tracking feature is used. If the customer + // doesn't use conversion tracking, this is 0. This field is read-only. + google.protobuf.Int64Value conversion_tracking_id = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The conversion tracking id of the customer's manager. This is set when the + // customer is opted into cross account conversion tracking, and it overrides + // conversion_tracking_id. This field can only be managed through the Google + // Ads UI. This field is read-only. + google.protobuf.Int64Value cross_account_conversion_tracking_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// Remarketing setting for a customer. +message RemarketingSetting { + // Output only. The Google global site tag. + google.protobuf.StringValue google_global_site_tag = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/customer_client.proto b/third_party/googleapis/google/ads/googleads/v3/resources/customer_client.proto new file mode 100644 index 000000000..d04d4cada --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/customer_client.proto @@ -0,0 +1,85 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "CustomerClientProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the CustomerClient resource. + +// A link between the given customer and a client customer. CustomerClients only +// exist for manager customers. All direct and indirect client customers are +// included, as well as the manager itself. +message CustomerClient { + option (google.api.resource) = { + type: "googleads.googleapis.com/CustomerClient" + pattern: "customers/{customer}/customerClients/{customer_client}" + }; + + // Output only. The resource name of the customer client. + // CustomerClient resource names have the form: + // `customers/{customer_id}/customerClients/{client_customer_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerClient" + } + ]; + + // Output only. The resource name of the client-customer which is linked to + // the given customer. Read only. + google.protobuf.StringValue client_customer = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Specifies whether this is a + // [hidden account](https://support.google.com/google-ads/answer/7519830). + // Read only. + google.protobuf.BoolValue hidden = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Distance between given customer and client. For self link, the level value + // will be 0. Read only. + google.protobuf.Int64Value level = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Common Locale Data Repository (CLDR) string representation of the + // time zone of the client, e.g. America/Los_Angeles. Read only. + google.protobuf.StringValue time_zone = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Identifies if the client is a test account. Read only. + google.protobuf.BoolValue test_account = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Identifies if the client is a manager. Read only. + google.protobuf.BoolValue manager = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Descriptive name for the client. Read only. + google.protobuf.StringValue descriptive_name = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Currency code (e.g. 'USD', 'EUR') for the client. Read only. + google.protobuf.StringValue currency_code = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The ID of the client customer. Read only. + google.protobuf.Int64Value id = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/customer_client_link.proto b/third_party/googleapis/google/ads/googleads/v3/resources/customer_client_link.proto new file mode 100644 index 000000000..c0c8dd663 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/customer_client_link.proto @@ -0,0 +1,66 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/manager_link_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "CustomerClientLinkProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the CustomerClientLink resource. + +// Represents customer client link relationship. +message CustomerClientLink { + option (google.api.resource) = { + type: "googleads.googleapis.com/CustomerClientLink" + pattern: "customers/{customer}/customerClientLinks/{customer_client_link}" + }; + + // Immutable. Name of the resource. + // CustomerClientLink resource names have the form: + // `customers/{customer_id}/customerClientLinks/{client_customer_id}~{manager_link_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerClientLink" + } + ]; + + // Immutable. The client customer linked to this customer. + google.protobuf.StringValue client_customer = 3 [(google.api.field_behavior) = IMMUTABLE]; + + // Output only. This is uniquely identifies a customer client link. Read only. + google.protobuf.Int64Value manager_link_id = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // This is the status of the link between client and manager. + google.ads.googleads.v3.enums.ManagerLinkStatusEnum.ManagerLinkStatus status = 5; + + // The visibility of the link. Users can choose whether or not to see hidden + // links in the AdWords UI. + // Default value is false + google.protobuf.BoolValue hidden = 6; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/customer_extension_setting.proto b/third_party/googleapis/google/ads/googleads/v3/resources/customer_extension_setting.proto new file mode 100644 index 000000000..c4c1ef8b8 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/customer_extension_setting.proto @@ -0,0 +1,68 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/extension_setting_device.proto"; +import "google/ads/googleads/v3/enums/extension_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "CustomerExtensionSettingProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the CustomerExtensionSetting resource. + +// A customer extension setting. +message CustomerExtensionSetting { + option (google.api.resource) = { + type: "googleads.googleapis.com/CustomerExtensionSetting" + pattern: "customers/{customer}/customerExtensionSettings/{customer_extension_setting}" + }; + + // Immutable. The resource name of the customer extension setting. + // CustomerExtensionSetting resource names have the form: + // + // `customers/{customer_id}/customerExtensionSettings/{extension_type}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerExtensionSetting" + } + ]; + + // Immutable. The extension type of the customer extension setting. + google.ads.googleads.v3.enums.ExtensionTypeEnum.ExtensionType extension_type = 2 [(google.api.field_behavior) = IMMUTABLE]; + + // The resource names of the extension feed items to serve under the customer. + // ExtensionFeedItem resource names have the form: + // + // `customers/{customer_id}/extensionFeedItems/{feed_item_id}` + repeated google.protobuf.StringValue extension_feed_items = 3 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/ExtensionFeedItem" + }]; + + // The device for which the extensions will serve. Optional. + google.ads.googleads.v3.enums.ExtensionSettingDeviceEnum.ExtensionSettingDevice device = 4; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/customer_feed.proto b/third_party/googleapis/google/ads/googleads/v3/resources/customer_feed.proto new file mode 100644 index 000000000..aacc6938d --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/customer_feed.proto @@ -0,0 +1,76 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/matching_function.proto"; +import "google/ads/googleads/v3/enums/feed_link_status.proto"; +import "google/ads/googleads/v3/enums/placeholder_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "CustomerFeedProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the CustomerFeed resource. + +// A customer feed. +message CustomerFeed { + option (google.api.resource) = { + type: "googleads.googleapis.com/CustomerFeed" + pattern: "customers/{customer}/customerFeeds/{customer_feed}" + }; + + // Immutable. The resource name of the customer feed. + // Customer feed resource names have the form: + // + // `customers/{customer_id}/customerFeeds/{feed_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerFeed" + } + ]; + + // Immutable. The feed being linked to the customer. + google.protobuf.StringValue feed = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; + + // Indicates which placeholder types the feed may populate under the connected + // customer. Required. + repeated google.ads.googleads.v3.enums.PlaceholderTypeEnum.PlaceholderType placeholder_types = 3; + + // Matching function associated with the CustomerFeed. + // The matching function is used to filter the set of feed items selected. + // Required. + google.ads.googleads.v3.common.MatchingFunction matching_function = 4; + + // Output only. Status of the customer feed. + // This field is read-only. + google.ads.googleads.v3.enums.FeedLinkStatusEnum.FeedLinkStatus status = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/customer_label.proto b/third_party/googleapis/google/ads/googleads/v3/resources/customer_label.proto new file mode 100644 index 000000000..c36f4c381 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/customer_label.proto @@ -0,0 +1,63 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "CustomerLabelProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the customer label resource. + +// Represents a relationship between a customer and a label. This customer may +// not have access to all the labels attached to it. Additional CustomerLabels +// may be returned by increasing permissions with login-customer-id. +message CustomerLabel { + option (google.api.resource) = { + type: "googleads.googleapis.com/CustomerLabel" + pattern: "customers/{customer}/customerLabels/{customer_label}" + }; + + // Immutable. Name of the resource. + // Customer label resource names have the form: + // `customers/{customer_id}/customerLabels/{label_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerLabel" + } + ]; + + // Output only. The resource name of the customer to which the label is attached. + // Read only. + google.protobuf.StringValue customer = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The resource name of the label assigned to the customer. + // + // Note: the Customer ID portion of the label resource name is not + // validated when creating a new CustomerLabel. + google.protobuf.StringValue label = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/customer_manager_link.proto b/third_party/googleapis/google/ads/googleads/v3/resources/customer_manager_link.proto new file mode 100644 index 000000000..9843d9d39 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/customer_manager_link.proto @@ -0,0 +1,61 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/manager_link_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "CustomerManagerLinkProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the CustomerManagerLink resource. + +// Represents customer-manager link relationship. +message CustomerManagerLink { + option (google.api.resource) = { + type: "googleads.googleapis.com/CustomerManagerLink" + pattern: "customers/{customer}/customerManagerLinks/{customer_manager_link}" + }; + + // Immutable. Name of the resource. + // CustomerManagerLink resource names have the form: + // `customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerManagerLink" + } + ]; + + // Output only. The manager customer linked to the customer. + google.protobuf.StringValue manager_customer = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. ID of the customer-manager link. This field is read only. + google.protobuf.Int64Value manager_link_id = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Status of the link between the customer and the manager. + google.ads.googleads.v3.enums.ManagerLinkStatusEnum.ManagerLinkStatus status = 5; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/customer_negative_criterion.proto b/third_party/googleapis/google/ads/googleads/v3/resources/customer_negative_criterion.proto new file mode 100644 index 000000000..521aabcdf --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/customer_negative_criterion.proto @@ -0,0 +1,83 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/criteria.proto"; +import "google/ads/googleads/v3/enums/criterion_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "CustomerNegativeCriterionProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the Customer Negative Criterion resource. + +// A negative criterion for exclusions at the customer level. +message CustomerNegativeCriterion { + option (google.api.resource) = { + type: "googleads.googleapis.com/CustomerNegativeCriterion" + pattern: "customers/{customer}/customerNegativeCriteria/{customer_negative_criterion}" + }; + + // Immutable. The resource name of the customer negative criterion. + // Customer negative criterion resource names have the form: + // + // `customers/{customer_id}/customerNegativeCriteria/{criterion_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerNegativeCriterion" + } + ]; + + // Output only. The ID of the criterion. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The type of the criterion. + google.ads.googleads.v3.enums.CriterionTypeEnum.CriterionType type = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The customer negative criterion. + // + // Exactly one must be set. + oneof criterion { + // Immutable. ContentLabel. + google.ads.googleads.v3.common.ContentLabelInfo content_label = 4 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. MobileApplication. + google.ads.googleads.v3.common.MobileApplicationInfo mobile_application = 5 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. MobileAppCategory. + google.ads.googleads.v3.common.MobileAppCategoryInfo mobile_app_category = 6 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Placement. + google.ads.googleads.v3.common.PlacementInfo placement = 7 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. YouTube Video. + google.ads.googleads.v3.common.YouTubeVideoInfo youtube_video = 8 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. YouTube Channel. + google.ads.googleads.v3.common.YouTubeChannelInfo youtube_channel = 9 [(google.api.field_behavior) = IMMUTABLE]; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/detail_placement_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/detail_placement_view.proto new file mode 100644 index 000000000..b34526abd --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/detail_placement_view.proto @@ -0,0 +1,72 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/placement_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "DetailPlacementViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the detail placement view resource. + +// A view with metrics aggregated by ad group and URL or YouTube video. +message DetailPlacementView { + option (google.api.resource) = { + type: "googleads.googleapis.com/DetailPlacementView" + pattern: "customers/{customer}/detailPlacementViews/{detail_placement_view}" + }; + + // Output only. The resource name of the detail placement view. + // Detail placement view resource names have the form: + // + // `customers/{customer_id}/detailPlacementViews/{ad_group_id}~{base64_placement}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DetailPlacementView" + } + ]; + + // Output only. The automatic placement string at detail level, e. g. website URL, mobile + // application ID, or a YouTube video ID. + google.protobuf.StringValue placement = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The display name is URL name for websites, YouTube video name for YouTube + // videos, and translated mobile app name for mobile apps. + google.protobuf.StringValue display_name = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. URL of the group placement, e.g. domain, link to the mobile application in + // app store, or a YouTube channel URL. + google.protobuf.StringValue group_placement_target_url = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. URL of the placement, e.g. website, link to the mobile application in app + // store, or a YouTube video URL. + google.protobuf.StringValue target_url = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Type of the placement, e.g. Website, YouTube Video, and Mobile Application. + google.ads.googleads.v3.enums.PlacementTypeEnum.PlacementType placement_type = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/display_keyword_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/display_keyword_view.proto new file mode 100644 index 000000000..ef6a16f7c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/display_keyword_view.proto @@ -0,0 +1,51 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "DisplayKeywordViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the display keyword view resource. + +// A display keyword view. +message DisplayKeywordView { + option (google.api.resource) = { + type: "googleads.googleapis.com/DisplayKeywordView" + pattern: "customers/{customer}/displayKeywordViews/{display_keyword_view}" + }; + + // Output only. The resource name of the display keyword view. + // Display Keyword view resource names have the form: + // + // `customers/{customer_id}/displayKeywordViews/{ad_group_id}~{criterion_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DisplayKeywordView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/distance_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/distance_view.proto new file mode 100644 index 000000000..d334934b6 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/distance_view.proto @@ -0,0 +1,63 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/distance_bucket.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "DistanceViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the DistanceView resource. + +// A distance view with metrics aggregated by the user's distance from an +// advertiser's location extensions. Each DistanceBucket includes all +// impressions that fall within its distance and a single impression will +// contribute to the metrics for all DistanceBuckets that include the user's +// distance. +message DistanceView { + option (google.api.resource) = { + type: "googleads.googleapis.com/DistanceView" + pattern: "customers/{customer}/distanceViews/{distance_view}" + }; + + // Output only. The resource name of the distance view. + // Distance view resource names have the form: + // + // `customers/{customer_id}/distanceViews/1~{distance_bucket}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DistanceView" + } + ]; + + // Output only. Grouping of user distance from location extensions. + google.ads.googleads.v3.enums.DistanceBucketEnum.DistanceBucket distance_bucket = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. True if the DistanceBucket is using the metric system, false otherwise. + google.protobuf.BoolValue metric_system = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/domain_category.proto b/third_party/googleapis/google/ads/googleads/v3/resources/domain_category.proto new file mode 100644 index 000000000..95faa4dcd --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/domain_category.proto @@ -0,0 +1,91 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "DomainCategoryProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the Domain Category resource. + +// A category generated automatically by crawling a domain. If a campaign uses +// the DynamicSearchAdsSetting, then domain categories will be generated for +// the domain. The categories can be targeted using WebpageConditionInfo. +// See: https://support.google.com/google-ads/answer/2471185 +message DomainCategory { + option (google.api.resource) = { + type: "googleads.googleapis.com/DomainCategory" + pattern: "customers/{customer}/domainCategories/{domain_category}" + }; + + // Output only. The resource name of the domain category. + // Domain category resource names have the form: + // + // `customers/{customer_id}/domainCategories/{campaign_id}~{category_base64}~{language_code}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DomainCategory" + } + ]; + + // Output only. The campaign this category is recommended for. + google.protobuf.StringValue campaign = 2 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; + + // Output only. Recommended category for the website domain. e.g. if you have a website + // about electronics, the categories could be "cameras", "televisions", etc. + google.protobuf.StringValue category = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The language code specifying the language of the website. e.g. "en" for + // English. The language can be specified in the DynamicSearchAdsSetting + // required for dynamic search ads. This is the language of the pages from + // your website that you want Google Ads to find, create ads for, + // and match searches with. + google.protobuf.StringValue language_code = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The domain for the website. The domain can be specified in the + // DynamicSearchAdsSetting required for dynamic search ads. + google.protobuf.StringValue domain = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Fraction of pages on your site that this category matches. + google.protobuf.DoubleValue coverage_fraction = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The position of this category in the set of categories. Lower numbers + // indicate a better match for the domain. null indicates not recommended. + google.protobuf.Int64Value category_rank = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Indicates whether this category has sub-categories. + google.protobuf.BoolValue has_children = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The recommended cost per click for the category. + google.protobuf.Int64Value recommended_cpc_bid_micros = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/dynamic_search_ads_search_term_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/dynamic_search_ads_search_term_view.proto new file mode 100644 index 000000000..688d4af4d --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/dynamic_search_ads_search_term_view.proto @@ -0,0 +1,87 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "DynamicSearchAdsSearchTermViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the Dynamic Search Ads Search Term View resource. + +// A dynamic search ads search term view. +message DynamicSearchAdsSearchTermView { + option (google.api.resource) = { + type: "googleads.googleapis.com/DynamicSearchAdsSearchTermView" + pattern: "customers/{customer}/dynamicSearchAdsSearchTermViews/{dynamic_search_ads_search_term_view}" + }; + + // Output only. The resource name of the dynamic search ads search term view. + // Dynamic search ads search term view resource names have the form: + // + // `customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fp}~{headline_fp}~{landing_page_fp}~{page_url_fp}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DynamicSearchAdsSearchTermView" + } + ]; + + // Output only. Search term + // + // This field is read-only. + google.protobuf.StringValue search_term = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The dynamically generated headline of the Dynamic Search Ad. + // + // This field is read-only. + google.protobuf.StringValue headline = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The dynamically selected landing page URL of the impression. + // + // This field is read-only. + google.protobuf.StringValue landing_page = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The URL of page feed item served for the impression. + // + // This field is read-only. + google.protobuf.StringValue page_url = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. True if query matches a negative keyword. + // + // This field is read-only. + google.protobuf.BoolValue has_negative_keyword = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. True if query is added to targeted keywords. + // + // This field is read-only. + google.protobuf.BoolValue has_matching_keyword = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. True if query matches a negative url. + // + // This field is read-only. + google.protobuf.BoolValue has_negative_url = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/expanded_landing_page_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/expanded_landing_page_view.proto new file mode 100644 index 000000000..c6402b156 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/expanded_landing_page_view.proto @@ -0,0 +1,56 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "ExpandedLandingPageViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the expanded landing page view resource. + +// A landing page view with metrics aggregated at the expanded final URL +// level. +message ExpandedLandingPageView { + option (google.api.resource) = { + type: "googleads.googleapis.com/ExpandedLandingPageView" + pattern: "customers/{customer}/expandedLandingPageViews/{expanded_landing_page_view}" + }; + + // Output only. The resource name of the expanded landing page view. + // Expanded landing page view resource names have the form: + // + // `customers/{customer_id}/expandedLandingPageViews/{expanded_final_url_fingerprint}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ExpandedLandingPageView" + } + ]; + + // Output only. The final URL that clicks are directed to. + google.protobuf.StringValue expanded_final_url = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/extension_feed_item.proto b/third_party/googleapis/google/ads/googleads/v3/resources/extension_feed_item.proto new file mode 100644 index 000000000..5f8348682 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/extension_feed_item.proto @@ -0,0 +1,149 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/criteria.proto"; +import "google/ads/googleads/v3/common/extensions.proto"; +import "google/ads/googleads/v3/enums/extension_type.proto"; +import "google/ads/googleads/v3/enums/feed_item_status.proto"; +import "google/ads/googleads/v3/enums/feed_item_target_device.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "ExtensionFeedItemProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the ExtensionFeedItem resource. + +// An extension feed item. +message ExtensionFeedItem { + option (google.api.resource) = { + type: "googleads.googleapis.com/ExtensionFeedItem" + pattern: "customers/{customer}/extensionFeedItems/{extension_feed_item}" + }; + + // Immutable. The resource name of the extension feed item. + // Extension feed item resource names have the form: + // + // `customers/{customer_id}/extensionFeedItems/{feed_item_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ExtensionFeedItem" + } + ]; + + // Output only. The ID of this feed item. Read-only. + google.protobuf.Int64Value id = 24 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The extension type of the extension feed item. + // This field is read-only. + google.ads.googleads.v3.enums.ExtensionTypeEnum.ExtensionType extension_type = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Start time in which this feed item is effective and can begin serving. The + // time is in the customer's time zone. + // The format is "YYYY-MM-DD HH:MM:SS". + // Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30" + google.protobuf.StringValue start_date_time = 5; + + // End time in which this feed item is no longer effective and will stop + // serving. The time is in the customer's time zone. + // The format is "YYYY-MM-DD HH:MM:SS". + // Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30" + google.protobuf.StringValue end_date_time = 6; + + // List of non-overlapping schedules specifying all time intervals + // for which the feed item may serve. There can be a maximum of 6 schedules + // per day. + repeated google.ads.googleads.v3.common.AdScheduleInfo ad_schedules = 16; + + // The targeted device. + google.ads.googleads.v3.enums.FeedItemTargetDeviceEnum.FeedItemTargetDevice device = 17; + + // The targeted geo target constant. + google.protobuf.StringValue targeted_geo_target_constant = 20 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/GeoTargetConstant" + }]; + + // The targeted keyword. + google.ads.googleads.v3.common.KeywordInfo targeted_keyword = 22; + + // Output only. Status of the feed item. + // This field is read-only. + google.ads.googleads.v3.enums.FeedItemStatusEnum.FeedItemStatus status = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Extension type. + oneof extension { + // Sitelink extension. + google.ads.googleads.v3.common.SitelinkFeedItem sitelink_feed_item = 2; + + // Structured snippet extension. + google.ads.googleads.v3.common.StructuredSnippetFeedItem structured_snippet_feed_item = 3; + + // App extension. + google.ads.googleads.v3.common.AppFeedItem app_feed_item = 7; + + // Call extension. + google.ads.googleads.v3.common.CallFeedItem call_feed_item = 8; + + // Callout extension. + google.ads.googleads.v3.common.CalloutFeedItem callout_feed_item = 9; + + // Text message extension. + google.ads.googleads.v3.common.TextMessageFeedItem text_message_feed_item = 10; + + // Price extension. + google.ads.googleads.v3.common.PriceFeedItem price_feed_item = 11; + + // Promotion extension. + google.ads.googleads.v3.common.PromotionFeedItem promotion_feed_item = 12; + + // Output only. Location extension. Locations are synced from a GMB account into a feed. + // This field is read-only. + google.ads.googleads.v3.common.LocationFeedItem location_feed_item = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Affiliate location extension. Feed locations are populated by Google Ads + // based on a chain ID. + // This field is read-only. + google.ads.googleads.v3.common.AffiliateLocationFeedItem affiliate_location_feed_item = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Hotel Callout extension. + google.ads.googleads.v3.common.HotelCalloutFeedItem hotel_callout_feed_item = 23; + } + + // Targeting at either the campaign or ad group level. Feed items that target + // a campaign or ad group will only serve with that resource. + oneof serving_resource_targeting { + // The targeted campaign. + google.protobuf.StringValue targeted_campaign = 18 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + }]; + + // The targeted ad group. + google.protobuf.StringValue targeted_ad_group = 19 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + }]; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/feed.proto b/third_party/googleapis/google/ads/googleads/v3/resources/feed.proto new file mode 100644 index 000000000..98c58d338 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/feed.proto @@ -0,0 +1,193 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/affiliate_location_feed_relationship_type.proto"; +import "google/ads/googleads/v3/enums/feed_attribute_type.proto"; +import "google/ads/googleads/v3/enums/feed_origin.proto"; +import "google/ads/googleads/v3/enums/feed_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "FeedProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the Feed resource. + +// A feed. +message Feed { + option (google.api.resource) = { + type: "googleads.googleapis.com/Feed" + pattern: "customers/{customer}/feeds/{feed}" + }; + + // Data used to configure a location feed populated from Google My Business + // Locations. + message PlacesLocationFeedData { + // Data used for authorization using OAuth. + message OAuthInfo { + // The HTTP method used to obtain authorization. + google.protobuf.StringValue http_method = 1; + + // The HTTP request URL used to obtain authorization. + google.protobuf.StringValue http_request_url = 2; + + // The HTTP authorization header used to obtain authorization. + google.protobuf.StringValue http_authorization_header = 3; + } + + // Immutable. Required authentication token (from OAuth API) for the email. + // This field can only be specified in a create request. All its subfields + // are not selectable. + OAuthInfo oauth_info = 1 [(google.api.field_behavior) = IMMUTABLE]; + + // Email address of a Google My Business account or email address of a + // manager of the Google My Business account. Required. + google.protobuf.StringValue email_address = 2; + + // Plus page ID of the managed business whose locations should be used. If + // this field is not set, then all businesses accessible by the user + // (specified by email_address) are used. + // This field is mutate-only and is not selectable. + google.protobuf.StringValue business_account_id = 10; + + // Used to filter Google My Business listings by business name. If + // business_name_filter is set, only listings with a matching business name + // are candidates to be sync'd into FeedItems. + google.protobuf.StringValue business_name_filter = 4; + + // Used to filter Google My Business listings by categories. If entries + // exist in category_filters, only listings that belong to any of the + // categories are candidates to be sync'd into FeedItems. If no entries + // exist in category_filters, then all listings are candidates for syncing. + repeated google.protobuf.StringValue category_filters = 5; + + // Used to filter Google My Business listings by labels. If entries exist in + // label_filters, only listings that has any of the labels set are + // candidates to be synchronized into FeedItems. If no entries exist in + // label_filters, then all listings are candidates for syncing. + repeated google.protobuf.StringValue label_filters = 6; + } + + // Data used to configure an affiliate location feed populated with the + // specified chains. + message AffiliateLocationFeedData { + // The list of chains that the affiliate location feed will sync the + // locations from. + repeated google.protobuf.Int64Value chain_ids = 1; + + // The relationship the chains have with the advertiser. + google.ads.googleads.v3.enums.AffiliateLocationFeedRelationshipTypeEnum.AffiliateLocationFeedRelationshipType relationship_type = 2; + } + + // Immutable. The resource name of the feed. + // Feed resource names have the form: + // + // `customers/{customer_id}/feeds/{feed_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; + + // Output only. The ID of the feed. + // This field is read-only. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. Name of the feed. Required. + google.protobuf.StringValue name = 3 [(google.api.field_behavior) = IMMUTABLE]; + + // The Feed's attributes. Required on CREATE, unless + // system_feed_generation_data is provided, in which case Google Ads will + // update the feed with the correct attributes. + // Disallowed on UPDATE. Use attribute_operations to add new attributes. + repeated FeedAttribute attributes = 4; + + // The list of operations changing the feed attributes. Attributes can only + // be added, not removed. + repeated FeedAttributeOperation attribute_operations = 9; + + // Immutable. Specifies who manages the FeedAttributes for the Feed. + google.ads.googleads.v3.enums.FeedOriginEnum.FeedOrigin origin = 5 [(google.api.field_behavior) = IMMUTABLE]; + + // Output only. Status of the feed. + // This field is read-only. + google.ads.googleads.v3.enums.FeedStatusEnum.FeedStatus status = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The system data for the Feed. This data specifies information for + // generating the feed items of the system generated feed. + oneof system_feed_generation_data { + // Data used to configure a location feed populated from Google My Business + // Locations. + PlacesLocationFeedData places_location_feed_data = 6; + + // Data used to configure an affiliate location feed populated with + // the specified chains. + AffiliateLocationFeedData affiliate_location_feed_data = 7; + } +} + +// FeedAttributes define the types of data expected to be present in a Feed. A +// single FeedAttribute specifies the expected type of the FeedItemAttributes +// with the same FeedAttributeId. Optionally, a FeedAttribute can be marked as +// being part of a FeedItem's unique key. +message FeedAttribute { + // ID of the attribute. + google.protobuf.Int64Value id = 1; + + // The name of the attribute. Required. + google.protobuf.StringValue name = 2; + + // Data type for feed attribute. Required. + google.ads.googleads.v3.enums.FeedAttributeTypeEnum.FeedAttributeType type = 3; + + // Indicates that data corresponding to this attribute is part of a + // FeedItem's unique key. It defaults to false if it is unspecified. Note + // that a unique key is not required in a Feed's schema, in which case the + // FeedItems must be referenced by their feed_item_id. + google.protobuf.BoolValue is_part_of_key = 4; +} + +// Operation to be performed on a feed attribute list in a mutate. +message FeedAttributeOperation { + // The operator. + enum Operator { + // Unspecified. + UNSPECIFIED = 0; + + // Used for return value only. Represents value unknown in this version. + UNKNOWN = 1; + + // Add the attribute to the existing attributes. + ADD = 2; + } + + // Output only. Type of list operation to perform. + Operator operator = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The feed attribute being added to the list. + FeedAttribute value = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/feed_item.proto b/third_party/googleapis/google/ads/googleads/v3/resources/feed_item.proto new file mode 100644 index 000000000..e683626fc --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/feed_item.proto @@ -0,0 +1,215 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/custom_parameter.proto"; +import "google/ads/googleads/v3/common/feed_common.proto"; +import "google/ads/googleads/v3/common/policy.proto"; +import "google/ads/googleads/v3/enums/feed_item_quality_approval_status.proto"; +import "google/ads/googleads/v3/enums/feed_item_quality_disapproval_reason.proto"; +import "google/ads/googleads/v3/enums/feed_item_status.proto"; +import "google/ads/googleads/v3/enums/feed_item_validation_status.proto"; +import "google/ads/googleads/v3/enums/geo_targeting_restriction.proto"; +import "google/ads/googleads/v3/enums/placeholder_type.proto"; +import "google/ads/googleads/v3/enums/policy_approval_status.proto"; +import "google/ads/googleads/v3/enums/policy_review_status.proto"; +import "google/ads/googleads/v3/errors/feed_item_validation_error.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "FeedItemProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the FeedItem resource. + +// A feed item. +message FeedItem { + option (google.api.resource) = { + type: "googleads.googleapis.com/FeedItem" + pattern: "customers/{customer}/feedItems/{feed_item}" + }; + + // Immutable. The resource name of the feed item. + // Feed item resource names have the form: + // + // `customers/{customer_id}/feedItems/{feed_id}~{feed_item_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedItem" + } + ]; + + // Immutable. The feed to which this feed item belongs. + google.protobuf.StringValue feed = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; + + // Output only. The ID of this feed item. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Start time in which this feed item is effective and can begin serving. The + // time is in the customer's time zone. + // The format is "YYYY-MM-DD HH:MM:SS". + // Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30" + google.protobuf.StringValue start_date_time = 4; + + // End time in which this feed item is no longer effective and will stop + // serving. The time is in the customer's time zone. + // The format is "YYYY-MM-DD HH:MM:SS". + // Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30" + google.protobuf.StringValue end_date_time = 5; + + // The feed item's attribute values. + repeated FeedItemAttributeValue attribute_values = 6; + + // Geo targeting restriction specifies the type of location that can be used + // for targeting. + google.ads.googleads.v3.enums.GeoTargetingRestrictionEnum.GeoTargetingRestriction geo_targeting_restriction = 7; + + // The list of mappings used to substitute custom parameter tags in a + // `tracking_url_template`, `final_urls`, or `mobile_final_urls`. + repeated google.ads.googleads.v3.common.CustomParameter url_custom_parameters = 8; + + // Output only. Status of the feed item. + // This field is read-only. + google.ads.googleads.v3.enums.FeedItemStatusEnum.FeedItemStatus status = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. List of info about a feed item's validation and approval state for active + // feed mappings. There will be an entry in the list for each type of feed + // mapping associated with the feed, e.g. a feed with a sitelink and a call + // feed mapping would cause every feed item associated with that feed to have + // an entry in this list for both sitelink and call. + // This field is read-only. + repeated FeedItemPlaceholderPolicyInfo policy_infos = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// A feed item attribute value. +message FeedItemAttributeValue { + // Id of the feed attribute for which the value is associated with. + google.protobuf.Int64Value feed_attribute_id = 1; + + // Int64 value. Should be set if feed_attribute_id refers to a feed attribute + // of type INT64. + google.protobuf.Int64Value integer_value = 2; + + // Bool value. Should be set if feed_attribute_id refers to a feed attribute + // of type BOOLEAN. + google.protobuf.BoolValue boolean_value = 3; + + // String value. Should be set if feed_attribute_id refers to a feed attribute + // of type STRING, URL or DATE_TIME. + // For STRING the maximum length is 1500 characters. For URL the maximum + // length is 2076 characters. For DATE_TIME the string must be in the format + // "YYYYMMDD HHMMSS". + google.protobuf.StringValue string_value = 4; + + // Double value. Should be set if feed_attribute_id refers to a feed attribute + // of type DOUBLE. + google.protobuf.DoubleValue double_value = 5; + + // Price value. Should be set if feed_attribute_id refers to a feed attribute + // of type PRICE. + google.ads.googleads.v3.common.Money price_value = 6; + + // Repeated int64 value. Should be set if feed_attribute_id refers to a feed + // attribute of type INT64_LIST. + repeated google.protobuf.Int64Value integer_values = 7; + + // Repeated bool value. Should be set if feed_attribute_id refers to a feed + // attribute of type BOOLEAN_LIST. + repeated google.protobuf.BoolValue boolean_values = 8; + + // Repeated string value. Should be set if feed_attribute_id refers to a feed + // attribute of type STRING_LIST, URL_LIST or DATE_TIME_LIST. + // For STRING_LIST and URL_LIST the total size of the list in bytes may not + // exceed 3000. For DATE_TIME_LIST the number of elements may not exceed 200. + // + // For STRING_LIST the maximum length of each string element is 1500 + // characters. For URL_LIST the maximum length is 2076 characters. For + // DATE_TIME the format of the string must be the same as start and end time + // for the feed item. + repeated google.protobuf.StringValue string_values = 9; + + // Repeated double value. Should be set if feed_attribute_id refers to a feed + // attribute of type DOUBLE_LIST. + repeated google.protobuf.DoubleValue double_values = 10; +} + +// Policy, validation, and quality approval info for a feed item for the +// specified placeholder type. +message FeedItemPlaceholderPolicyInfo { + // Output only. The placeholder type. + google.ads.googleads.v3.enums.PlaceholderTypeEnum.PlaceholderType placeholder_type_enum = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The FeedMapping that contains the placeholder type. + google.protobuf.StringValue feed_mapping_resource_name = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Where the placeholder type is in the review process. + google.ads.googleads.v3.enums.PolicyReviewStatusEnum.PolicyReviewStatus review_status = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The overall approval status of the placeholder type, calculated based on + // the status of its individual policy topic entries. + google.ads.googleads.v3.enums.PolicyApprovalStatusEnum.PolicyApprovalStatus approval_status = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The list of policy findings for the placeholder type. + repeated google.ads.googleads.v3.common.PolicyTopicEntry policy_topic_entries = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The validation status of the palceholder type. + google.ads.googleads.v3.enums.FeedItemValidationStatusEnum.FeedItemValidationStatus validation_status = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. List of placeholder type validation errors. + repeated FeedItemValidationError validation_errors = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Placeholder type quality evaluation approval status. + google.ads.googleads.v3.enums.FeedItemQualityApprovalStatusEnum.FeedItemQualityApprovalStatus quality_approval_status = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. List of placeholder type quality evaluation disapproval reasons. + repeated google.ads.googleads.v3.enums.FeedItemQualityDisapprovalReasonEnum.FeedItemQualityDisapprovalReason quality_disapproval_reasons = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// Stores a validation error and the set of offending feed attributes which +// together are responsible for causing a feed item validation error. +message FeedItemValidationError { + // Output only. Error code indicating what validation error was triggered. The description + // of the error can be found in the 'description' field. + google.ads.googleads.v3.errors.FeedItemValidationErrorEnum.FeedItemValidationError validation_error = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The description of the validation error. + google.protobuf.StringValue description = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Set of feed attributes in the feed item flagged during validation. If + // empty, no specific feed attributes can be associated with the error + // (e.g. error across the entire feed item). + repeated google.protobuf.Int64Value feed_attribute_ids = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Any extra information related to this error which is not captured by + // validation_error and feed_attribute_id (e.g. placeholder field IDs when + // feed_attribute_id is not mapped). Note that extra_info is not localized. + google.protobuf.StringValue extra_info = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/feed_item_target.proto b/third_party/googleapis/google/ads/googleads/v3/resources/feed_item_target.proto new file mode 100644 index 000000000..d5ca398df --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/feed_item_target.proto @@ -0,0 +1,109 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/criteria.proto"; +import "google/ads/googleads/v3/enums/feed_item_target_device.proto"; +import "google/ads/googleads/v3/enums/feed_item_target_status.proto"; +import "google/ads/googleads/v3/enums/feed_item_target_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "FeedItemTargetProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the FeedItemTarget resource. + +// A feed item target. +message FeedItemTarget { + option (google.api.resource) = { + type: "googleads.googleapis.com/FeedItemTarget" + pattern: "customers/{customer}/feedItemTargets/{feed_item_target}" + }; + + // Immutable. The resource name of the feed item target. + // Feed item target resource names have the form: + // `customers/{customer_id}/feedItemTargets/{feed_id}~{feed_item_id}~{feed_item_target_type}~{feed_item_target_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedItemTarget" + } + ]; + + // Immutable. The feed item to which this feed item target belongs. + google.protobuf.StringValue feed_item = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedItem" + } + ]; + + // Output only. The target type of this feed item target. This field is read-only. + google.ads.googleads.v3.enums.FeedItemTargetTypeEnum.FeedItemTargetType feed_item_target_type = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The ID of the targeted resource. This field is read-only. + google.protobuf.Int64Value feed_item_target_id = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Status of the feed item target. + // This field is read-only. + google.ads.googleads.v3.enums.FeedItemTargetStatusEnum.FeedItemTargetStatus status = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The targeted resource. + oneof target { + // Immutable. The targeted campaign. + google.protobuf.StringValue campaign = 4 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; + + // Immutable. The targeted ad group. + google.protobuf.StringValue ad_group = 5 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; + + // Immutable. The targeted keyword. + google.ads.googleads.v3.common.KeywordInfo keyword = 7 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. The targeted geo target constant resource name. + google.protobuf.StringValue geo_target_constant = 8 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GeoTargetConstant" + } + ]; + + // Immutable. The targeted device. + google.ads.googleads.v3.enums.FeedItemTargetDeviceEnum.FeedItemTargetDevice device = 9 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. The targeted schedule. + google.ads.googleads.v3.common.AdScheduleInfo ad_schedule = 10 [(google.api.field_behavior) = IMMUTABLE]; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/feed_mapping.proto b/third_party/googleapis/google/ads/googleads/v3/resources/feed_mapping.proto new file mode 100644 index 000000000..b0a0d51b7 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/feed_mapping.proto @@ -0,0 +1,186 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/ad_customizer_placeholder_field.proto"; +import "google/ads/googleads/v3/enums/affiliate_location_placeholder_field.proto"; +import "google/ads/googleads/v3/enums/app_placeholder_field.proto"; +import "google/ads/googleads/v3/enums/call_placeholder_field.proto"; +import "google/ads/googleads/v3/enums/callout_placeholder_field.proto"; +import "google/ads/googleads/v3/enums/custom_placeholder_field.proto"; +import "google/ads/googleads/v3/enums/dsa_page_feed_criterion_field.proto"; +import "google/ads/googleads/v3/enums/education_placeholder_field.proto"; +import "google/ads/googleads/v3/enums/feed_mapping_criterion_type.proto"; +import "google/ads/googleads/v3/enums/feed_mapping_status.proto"; +import "google/ads/googleads/v3/enums/flight_placeholder_field.proto"; +import "google/ads/googleads/v3/enums/hotel_placeholder_field.proto"; +import "google/ads/googleads/v3/enums/job_placeholder_field.proto"; +import "google/ads/googleads/v3/enums/local_placeholder_field.proto"; +import "google/ads/googleads/v3/enums/location_extension_targeting_criterion_field.proto"; +import "google/ads/googleads/v3/enums/location_placeholder_field.proto"; +import "google/ads/googleads/v3/enums/message_placeholder_field.proto"; +import "google/ads/googleads/v3/enums/placeholder_type.proto"; +import "google/ads/googleads/v3/enums/price_placeholder_field.proto"; +import "google/ads/googleads/v3/enums/promotion_placeholder_field.proto"; +import "google/ads/googleads/v3/enums/real_estate_placeholder_field.proto"; +import "google/ads/googleads/v3/enums/sitelink_placeholder_field.proto"; +import "google/ads/googleads/v3/enums/structured_snippet_placeholder_field.proto"; +import "google/ads/googleads/v3/enums/travel_placeholder_field.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "FeedMappingProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the FeedMapping resource. + +// A feed mapping. +message FeedMapping { + option (google.api.resource) = { + type: "googleads.googleapis.com/FeedMapping" + pattern: "customers/{customer}/feedMappings/{feed_mapping}" + }; + + // Immutable. The resource name of the feed mapping. + // Feed mapping resource names have the form: + // + // `customers/{customer_id}/feedMappings/{feed_id}~{feed_mapping_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedMapping" + } + ]; + + // Immutable. The feed of this feed mapping. + google.protobuf.StringValue feed = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; + + // Immutable. Feed attributes to field mappings. These mappings are a one-to-many + // relationship meaning that 1 feed attribute can be used to populate + // multiple placeholder fields, but 1 placeholder field can only draw + // data from 1 feed attribute. Ad Customizer is an exception, 1 placeholder + // field can be mapped to multiple feed attributes. Required. + repeated AttributeFieldMapping attribute_field_mappings = 5 [(google.api.field_behavior) = IMMUTABLE]; + + // Output only. Status of the feed mapping. + // This field is read-only. + google.ads.googleads.v3.enums.FeedMappingStatusEnum.FeedMappingStatus status = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Feed mapping target. Can be either a placeholder or a criterion. For a + // given feed, the active FeedMappings must have unique targets. Required. + oneof target { + // Immutable. The placeholder type of this mapping (i.e., if the mapping maps feed + // attributes to placeholder fields). + google.ads.googleads.v3.enums.PlaceholderTypeEnum.PlaceholderType placeholder_type = 3 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. The criterion type of this mapping (i.e., if the mapping maps feed + // attributes to criterion fields). + google.ads.googleads.v3.enums.FeedMappingCriterionTypeEnum.FeedMappingCriterionType criterion_type = 4 [(google.api.field_behavior) = IMMUTABLE]; + } +} + +// Maps from feed attribute id to a placeholder or criterion field id. +message AttributeFieldMapping { + // Immutable. Feed attribute from which to map. + google.protobuf.Int64Value feed_attribute_id = 1 [(google.api.field_behavior) = IMMUTABLE]; + + // Output only. The placeholder field ID. If a placeholder field enum is not published in + // the current API version, then this field will be populated and the field + // oneof will be empty. + // This field is read-only. + google.protobuf.Int64Value field_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Placeholder or criterion field to be populated using data from + // the above feed attribute. Required. + oneof field { + // Immutable. Sitelink Placeholder Fields. + google.ads.googleads.v3.enums.SitelinkPlaceholderFieldEnum.SitelinkPlaceholderField sitelink_field = 3 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Call Placeholder Fields. + google.ads.googleads.v3.enums.CallPlaceholderFieldEnum.CallPlaceholderField call_field = 4 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. App Placeholder Fields. + google.ads.googleads.v3.enums.AppPlaceholderFieldEnum.AppPlaceholderField app_field = 5 [(google.api.field_behavior) = IMMUTABLE]; + + // Output only. Location Placeholder Fields. This field is read-only. + google.ads.googleads.v3.enums.LocationPlaceholderFieldEnum.LocationPlaceholderField location_field = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Affiliate Location Placeholder Fields. This field is read-only. + google.ads.googleads.v3.enums.AffiliateLocationPlaceholderFieldEnum.AffiliateLocationPlaceholderField affiliate_location_field = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. Callout Placeholder Fields. + google.ads.googleads.v3.enums.CalloutPlaceholderFieldEnum.CalloutPlaceholderField callout_field = 8 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Structured Snippet Placeholder Fields. + google.ads.googleads.v3.enums.StructuredSnippetPlaceholderFieldEnum.StructuredSnippetPlaceholderField structured_snippet_field = 9 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Message Placeholder Fields. + google.ads.googleads.v3.enums.MessagePlaceholderFieldEnum.MessagePlaceholderField message_field = 10 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Price Placeholder Fields. + google.ads.googleads.v3.enums.PricePlaceholderFieldEnum.PricePlaceholderField price_field = 11 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Promotion Placeholder Fields. + google.ads.googleads.v3.enums.PromotionPlaceholderFieldEnum.PromotionPlaceholderField promotion_field = 12 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Ad Customizer Placeholder Fields + google.ads.googleads.v3.enums.AdCustomizerPlaceholderFieldEnum.AdCustomizerPlaceholderField ad_customizer_field = 13 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Dynamic Search Ad Page Feed Fields. + google.ads.googleads.v3.enums.DsaPageFeedCriterionFieldEnum.DsaPageFeedCriterionField dsa_page_feed_field = 14 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Location Target Fields. + google.ads.googleads.v3.enums.LocationExtensionTargetingCriterionFieldEnum.LocationExtensionTargetingCriterionField location_extension_targeting_field = 15 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Education Placeholder Fields + google.ads.googleads.v3.enums.EducationPlaceholderFieldEnum.EducationPlaceholderField education_field = 16 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Flight Placeholder Fields + google.ads.googleads.v3.enums.FlightPlaceholderFieldEnum.FlightPlaceholderField flight_field = 17 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Custom Placeholder Fields + google.ads.googleads.v3.enums.CustomPlaceholderFieldEnum.CustomPlaceholderField custom_field = 18 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Hotel Placeholder Fields + google.ads.googleads.v3.enums.HotelPlaceholderFieldEnum.HotelPlaceholderField hotel_field = 19 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Real Estate Placeholder Fields + google.ads.googleads.v3.enums.RealEstatePlaceholderFieldEnum.RealEstatePlaceholderField real_estate_field = 20 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Travel Placeholder Fields + google.ads.googleads.v3.enums.TravelPlaceholderFieldEnum.TravelPlaceholderField travel_field = 21 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Local Placeholder Fields + google.ads.googleads.v3.enums.LocalPlaceholderFieldEnum.LocalPlaceholderField local_field = 22 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Job Placeholder Fields + google.ads.googleads.v3.enums.JobPlaceholderFieldEnum.JobPlaceholderField job_field = 23 [(google.api.field_behavior) = IMMUTABLE]; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/feed_placeholder_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/feed_placeholder_view.proto new file mode 100644 index 000000000..1857fb14a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/feed_placeholder_view.proto @@ -0,0 +1,55 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/placeholder_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "FeedPlaceholderViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the FeedPlaceholderView resource. + +// A feed placeholder view. +message FeedPlaceholderView { + option (google.api.resource) = { + type: "googleads.googleapis.com/FeedPlaceholderView" + pattern: "customers/{customer}/feedPlaceholderViews/{feed_placeholder_view}" + }; + + // Output only. The resource name of the feed placeholder view. + // Feed placeholder view resource names have the form: + // + // `customers/{customer_id}/feedPlaceholderViews/{placeholder_type}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedPlaceholderView" + } + ]; + + // Output only. The placeholder type of the feed placeholder view. + google.ads.googleads.v3.enums.PlaceholderTypeEnum.PlaceholderType placeholder_type = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/gender_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/gender_view.proto new file mode 100644 index 000000000..ab28a2361 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/gender_view.proto @@ -0,0 +1,51 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "GenderViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the gender view resource. + +// A gender view. +message GenderView { + option (google.api.resource) = { + type: "googleads.googleapis.com/GenderView" + pattern: "customers/{customer}/genderViews/{gender_view}" + }; + + // Output only. The resource name of the gender view. + // Gender view resource names have the form: + // + // `customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GenderView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/geo_target_constant.proto b/third_party/googleapis/google/ads/googleads/v3/resources/geo_target_constant.proto new file mode 100644 index 000000000..ca8e916f2 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/geo_target_constant.proto @@ -0,0 +1,72 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/geo_target_constant_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "GeoTargetConstantProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the geo target constant resource. + +// A geo target constant. +message GeoTargetConstant { + option (google.api.resource) = { + type: "googleads.googleapis.com/GeoTargetConstant" + pattern: "geoTargetConstants/{geo_target_constant}" + }; + + // Output only. The resource name of the geo target constant. + // Geo target constant resource names have the form: + // + // `geoTargetConstants/{geo_target_constant_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GeoTargetConstant" + } + ]; + + // Output only. The ID of the geo target constant. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Geo target constant English name. + google.protobuf.StringValue name = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The ISO-3166-1 alpha-2 country code that is associated with the target. + google.protobuf.StringValue country_code = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Geo target constant target type. + google.protobuf.StringValue target_type = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Geo target constant status. + google.ads.googleads.v3.enums.GeoTargetConstantStatusEnum.GeoTargetConstantStatus status = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The fully qualified English name, consisting of the target's name and that + // of its parent and country. + google.protobuf.StringValue canonical_name = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/geographic_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/geographic_view.proto new file mode 100644 index 000000000..39b363716 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/geographic_view.proto @@ -0,0 +1,64 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/geo_targeting_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "GeographicViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the geographic view resource. + +// A geographic view. +// +// Geographic View includes all metrics aggregated at the country level, +// one row per country. It reports metrics at either actual physical location of +// the user or an area of interest. If other segment fields are used, you may +// get more than one row per country. +message GeographicView { + option (google.api.resource) = { + type: "googleads.googleapis.com/GeographicView" + pattern: "customers/{customer}/geographicViews/{geographic_view}" + }; + + // Output only. The resource name of the geographic view. + // Geographic view resource names have the form: + // + // `customers/{customer_id}/geographicViews/{country_criterion_id}~{location_type}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GeographicView" + } + ]; + + // Output only. Type of the geo targeting of the campaign. + google.ads.googleads.v3.enums.GeoTargetingTypeEnum.GeoTargetingType location_type = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Criterion Id for the country. + google.protobuf.Int64Value country_criterion_id = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/google_ads_field.proto b/third_party/googleapis/google/ads/googleads/v3/resources/google_ads_field.proto new file mode 100644 index 000000000..3dc08c1f8 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/google_ads_field.proto @@ -0,0 +1,118 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/google_ads_field_category.proto"; +import "google/ads/googleads/v3/enums/google_ads_field_data_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "GoogleAdsFieldProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the Google Ads Field resource. + +// A field or resource (artifact) used by GoogleAdsService. +message GoogleAdsField { + option (google.api.resource) = { + type: "googleads.googleapis.com/GoogleAdsField" + pattern: "googleAdsFields/{google_ads_field}" + }; + + // Output only. The resource name of the artifact. + // Artifact resource names have the form: + // + // `googleAdsFields/{name}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GoogleAdsField" + } + ]; + + // Output only. The name of the artifact. + google.protobuf.StringValue name = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The category of the artifact. + google.ads.googleads.v3.enums.GoogleAdsFieldCategoryEnum.GoogleAdsFieldCategory category = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Whether the artifact can be used in a SELECT clause in search + // queries. + google.protobuf.BoolValue selectable = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Whether the artifact can be used in a WHERE clause in search + // queries. + google.protobuf.BoolValue filterable = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Whether the artifact can be used in a ORDER BY clause in search + // queries. + google.protobuf.BoolValue sortable = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The names of all resources, segments, and metrics that are selectable with + // the described artifact. + repeated google.protobuf.StringValue selectable_with = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The names of all resources that are selectable with the described + // artifact. Fields from these resources do not segment metrics when included + // in search queries. + // + // This field is only set for artifacts whose category is RESOURCE. + repeated google.protobuf.StringValue attribute_resources = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. At and beyond version V1 this field lists the names of all metrics that are + // selectable with the described artifact when it is used in the FROM clause. + // It is only set for artifacts whose category is RESOURCE. + // + // Before version V1 this field lists the names of all metrics that are + // selectable with the described artifact. It is only set for artifacts whose + // category is either RESOURCE or SEGMENT + repeated google.protobuf.StringValue metrics = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. At and beyond version V1 this field lists the names of all artifacts, + // whether a segment or another resource, that segment metrics when included + // in search queries and when the described artifact is used in the FROM + // clause. It is only set for artifacts whose category is RESOURCE. + // + // Before version V1 this field lists the names of all artifacts, whether a + // segment or another resource, that segment metrics when included in search + // queries. It is only set for artifacts of category RESOURCE, SEGMENT or + // METRIC. + repeated google.protobuf.StringValue segments = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Values the artifact can assume if it is a field of type ENUM. + // + // This field is only set for artifacts of category SEGMENT or ATTRIBUTE. + repeated google.protobuf.StringValue enum_values = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. This field determines the operators that can be used with the artifact + // in WHERE clauses. + google.ads.googleads.v3.enums.GoogleAdsFieldDataTypeEnum.GoogleAdsFieldDataType data_type = 12 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The URL of proto describing the artifact's data type. + google.protobuf.StringValue type_url = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Whether the field artifact is repeated. + google.protobuf.BoolValue is_repeated = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/group_placement_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/group_placement_view.proto new file mode 100644 index 000000000..78e5152ed --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/group_placement_view.proto @@ -0,0 +1,67 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/placement_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "GroupPlacementViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the group placement view resource. + +// A group placement view. +message GroupPlacementView { + option (google.api.resource) = { + type: "googleads.googleapis.com/GroupPlacementView" + pattern: "customers/{customer}/groupPlacementViews/{group_placement_view}" + }; + + // Output only. The resource name of the group placement view. + // Group placement view resource names have the form: + // + // `customers/{customer_id}/groupPlacementViews/{ad_group_id}~{base64_placement}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GroupPlacementView" + } + ]; + + // Output only. The automatic placement string at group level, e. g. web domain, mobile + // app ID, or a YouTube channel ID. + google.protobuf.StringValue placement = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Domain name for websites and YouTube channel name for YouTube channels. + google.protobuf.StringValue display_name = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. URL of the group placement, e.g. domain, link to the mobile application in + // app store, or a YouTube channel URL. + google.protobuf.StringValue target_url = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Type of the placement, e.g. Website, YouTube Channel, Mobile Application. + google.ads.googleads.v3.enums.PlacementTypeEnum.PlacementType placement_type = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/hotel_group_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/hotel_group_view.proto new file mode 100644 index 000000000..5eaf7a228 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/hotel_group_view.proto @@ -0,0 +1,51 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "HotelGroupViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the hotel group view resource. + +// A hotel group view. +message HotelGroupView { + option (google.api.resource) = { + type: "googleads.googleapis.com/HotelGroupView" + pattern: "customers/{customer}/hotelGroupViews/{hotel_group_view}" + }; + + // Output only. The resource name of the hotel group view. + // Hotel Group view resource names have the form: + // + // `customers/{customer_id}/hotelGroupViews/{ad_group_id}~{criterion_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/HotelGroupView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/hotel_performance_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/hotel_performance_view.proto new file mode 100644 index 000000000..8af349912 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/hotel_performance_view.proto @@ -0,0 +1,51 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "HotelPerformanceViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the hotel performance view resource. + +// A hotel performance view. +message HotelPerformanceView { + option (google.api.resource) = { + type: "googleads.googleapis.com/HotelPerformanceView" + pattern: "customers/{customer}/hotelPerformanceView" + }; + + // Output only. The resource name of the hotel performance view. + // Hotel performance view resource names have the form: + // + // `customers/{customer_id}/hotelPerformanceView` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/HotelPerformanceView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/invoice.proto b/third_party/googleapis/google/ads/googleads/v3/resources/invoice.proto new file mode 100644 index 000000000..1e86c822f --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/invoice.proto @@ -0,0 +1,184 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/dates.proto"; +import "google/ads/googleads/v3/enums/invoice_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "InvoiceProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the Invoice resource. + +// An invoice. All invoice information is snapshotted to match the PDF invoice. +// For invoices older than the launch of InvoiceService, the snapshotted +// information may not match the PDF invoice. +message Invoice { + option (google.api.resource) = { + type: "googleads.googleapis.com/Invoice" + pattern: "customers/{customer}/invoices/{invoice}" + }; + + // Represents a summarized account budget billable cost. + message AccountBudgetSummary { + // Output only. The resource name of the customer associated with this account budget. + // This contains the customer ID, which appears on the invoice PDF as + // "Account ID". + // Customer resource names have the form: + // + // `customers/{customer_id}` + google.protobuf.StringValue customer = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The descriptive name of the account budget’s customer. It appears on the + // invoice PDF as "Account". + google.protobuf.StringValue customer_descriptive_name = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The resource name of the account budget associated with this summarized + // billable cost. + // AccountBudget resource names have the form: + // + // `customers/{customer_id}/accountBudgets/{account_budget_id}` + google.protobuf.StringValue account_budget = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The name of the account budget. It appears on the invoice PDF as "Account + // budget". + google.protobuf.StringValue account_budget_name = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The purchase order number of the account budget. It appears on the + // invoice PDF as "Purchase order". + google.protobuf.StringValue purchase_order_number = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The pretax subtotal amount attributable to this budget during the service + // period, in micros. + google.protobuf.Int64Value subtotal_amount_micros = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The tax amount attributable to this budget during the service period, in + // micros. + google.protobuf.Int64Value tax_amount_micros = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The total amount attributable to this budget during the service period, + // in micros. This equals the sum of the account budget subtotal amount and + // the account budget tax amount. + google.protobuf.Int64Value total_amount_micros = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The billable activity date range of the account budget, within the + // service date range of this invoice. The end date is inclusive. This can + // be different from the account budget's start and end time. + google.ads.googleads.v3.common.DateRange billable_activity_date_range = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // Output only. The resource name of the invoice. Multiple customers can share a given + // invoice, so multiple resource names may point to the same invoice. + // Invoice resource names have the form: + // + // `customers/{customer_id}/invoices/{invoice_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Invoice" + } + ]; + + // Output only. The ID of the invoice. It appears on the invoice PDF as "Invoice number". + google.protobuf.StringValue id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The type of invoice. + google.ads.googleads.v3.enums.InvoiceTypeEnum.InvoiceType type = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The resource name of this invoice’s billing setup. + // + // `customers/{customer_id}/billingSetups/{billing_setup_id}` + google.protobuf.StringValue billing_setup = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. A 16 digit ID used to identify the payments account associated with the + // billing setup, e.g. "1234-5678-9012-3456". It appears on the invoice PDF as + // "Billing Account Number". + google.protobuf.StringValue payments_account_id = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. A 12 digit ID used to identify the payments profile associated with the + // billing setup, e.g. "1234-5678-9012". It appears on the invoice PDF as + // "Billing ID". + google.protobuf.StringValue payments_profile_id = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The issue date in yyyy-mm-dd format. It appears on the invoice PDF as + // either "Issue date" or "Invoice date". + google.protobuf.StringValue issue_date = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The due date in yyyy-mm-dd format. + google.protobuf.StringValue due_date = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The service period date range of this invoice. The end date is inclusive. + google.ads.googleads.v3.common.DateRange service_date_range = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The currency code. All costs are returned in this currency. A subset of the + // currency codes derived from the ISO 4217 standard is supported. + google.protobuf.StringValue currency_code = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The total amount of invoice level adjustments. These adjustments are made + // on the invoice, not on a specific account budget. + google.protobuf.Int64Value invoice_level_adjustments_micros = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The pretax subtotal amount, in micros. This equals the sum of the + // AccountBudgetSummary subtotal amounts, plus the invoice level adjustments. + google.protobuf.Int64Value subtotal_amount_micros = 12 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The sum of all taxes on the invoice, in micros. This equals the sum of the + // AccountBudgetSummary tax amounts, plus taxes not associated with a specific + // account budget. + google.protobuf.Int64Value tax_amount_micros = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The total amount, in micros. This equals the sum of the invoice subtotal + // amount and the invoice tax amount. + google.protobuf.Int64Value total_amount_micros = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The resource name of the original invoice corrected, wrote off, or canceled + // by this invoice, if applicable. If `corrected_invoice` is set, + // `replaced_invoices` will not be set. + // + // Invoice resource names have the form: + // + // `customers/{customer_id}/invoices/{invoice_id}` + google.protobuf.StringValue corrected_invoice = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The resource name of the original invoice(s) being rebilled or replaced by + // this invoice, if applicable. There might be multiple replaced invoices due + // to invoice consolidation. The replaced invoices may not belong to the same + // payments account. If `replaced_invoices` is set, `corrected_invoice` will + // not be set. + // Invoice resource names have the form: + // + // `customers/{customer_id}/invoices/{invoice_id}` + repeated google.protobuf.StringValue replaced_invoices = 16 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The URL to a PDF copy of the invoice. Users need to pass in their OAuth + // token to request the PDF with this URL. + google.protobuf.StringValue pdf_url = 17 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The list of summarized account budget information associated with this + // invoice. + repeated AccountBudgetSummary account_budget_summaries = 18 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/keyword_plan.proto b/third_party/googleapis/google/ads/googleads/v3/resources/keyword_plan.proto new file mode 100644 index 000000000..58e8b8c84 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/keyword_plan.proto @@ -0,0 +1,83 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/dates.proto"; +import "google/ads/googleads/v3/enums/keyword_plan_forecast_interval.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "KeywordPlanProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the keyword plan resource. + +// A Keyword Planner plan. +// Max number of saved keyword plans: 10000. +// It's possible to remove plans if limit is reached. +message KeywordPlan { + option (google.api.resource) = { + type: "googleads.googleapis.com/KeywordPlan" + pattern: "customers/{customer}/keywordPlans/{keyword_plan}" + }; + + // Immutable. The resource name of the Keyword Planner plan. + // KeywordPlan resource names have the form: + // + // `customers/{customer_id}/keywordPlans/{kp_plan_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlan" + } + ]; + + // Output only. The ID of the keyword plan. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The name of the keyword plan. + // + // This field is required and should not be empty when creating new keyword + // plans. + google.protobuf.StringValue name = 3; + + // The date period used for forecasting the plan. + KeywordPlanForecastPeriod forecast_period = 4; +} + +// The forecasting period associated with the keyword plan. +message KeywordPlanForecastPeriod { + // Required. The date used for forecasting the Plan. + oneof interval { + // A future date range relative to the current date used for forecasting. + google.ads.googleads.v3.enums.KeywordPlanForecastIntervalEnum.KeywordPlanForecastInterval date_interval = 1; + + // The custom date range used for forecasting. + // The start and end dates must be in the future. Otherwise, an error will + // be returned when the forecasting action is performed. + // The start and end dates are inclusive. + google.ads.googleads.v3.common.DateRange date_range = 2; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/keyword_plan_ad_group.proto b/third_party/googleapis/google/ads/googleads/v3/resources/keyword_plan_ad_group.proto new file mode 100644 index 000000000..e0fc27991 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/keyword_plan_ad_group.proto @@ -0,0 +1,72 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "KeywordPlanAdGroupProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the keyword plan ad group resource. + +// A Keyword Planner ad group. +// Max number of keyword plan ad groups per plan: 200. +message KeywordPlanAdGroup { + option (google.api.resource) = { + type: "googleads.googleapis.com/KeywordPlanAdGroup" + pattern: "customers/{customer}/keywordPlanAdGroups/{keyword_plan_ad_group}" + }; + + // Immutable. The resource name of the Keyword Planner ad group. + // KeywordPlanAdGroup resource names have the form: + // + // `customers/{customer_id}/keywordPlanAdGroups/{kp_ad_group_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanAdGroup" + } + ]; + + // The keyword plan campaign to which this ad group belongs. + google.protobuf.StringValue keyword_plan_campaign = 2 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanCampaign" + }]; + + // Output only. The ID of the keyword plan ad group. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The name of the keyword plan ad group. + // + // This field is required and should not be empty when creating keyword plan + // ad group. + google.protobuf.StringValue name = 4; + + // A default ad group max cpc bid in micros in account currency for all + // biddable keywords under the keyword plan ad group. + // If not set, will inherit from parent campaign. + google.protobuf.Int64Value cpc_bid_micros = 5; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/keyword_plan_campaign.proto b/third_party/googleapis/google/ads/googleads/v3/resources/keyword_plan_campaign.proto new file mode 100644 index 000000000..8c24b0e1b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/keyword_plan_campaign.proto @@ -0,0 +1,99 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/keyword_plan_network.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "KeywordPlanCampaignProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the keyword plan campaign resource. + +// A Keyword Plan campaign. +// Max number of keyword plan campaigns per plan allowed: 1. +message KeywordPlanCampaign { + option (google.api.resource) = { + type: "googleads.googleapis.com/KeywordPlanCampaign" + pattern: "customers/{customer}/keywordPlanCampaigns/{keyword_plan_campaign}" + }; + + // Immutable. The resource name of the Keyword Plan campaign. + // KeywordPlanCampaign resource names have the form: + // + // `customers/{customer_id}/keywordPlanCampaigns/{kp_campaign_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanCampaign" + } + ]; + + // The keyword plan this campaign belongs to. + google.protobuf.StringValue keyword_plan = 2 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlan" + }]; + + // Output only. The ID of the Keyword Plan campaign. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The name of the Keyword Plan campaign. + // + // This field is required and should not be empty when creating Keyword Plan + // campaigns. + google.protobuf.StringValue name = 4; + + // The languages targeted for the Keyword Plan campaign. + // Max allowed: 1. + repeated google.protobuf.StringValue language_constants = 5 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/LanguageConstant" + }]; + + // Targeting network. + // + // This field is required and should not be empty when creating Keyword Plan + // campaigns. + google.ads.googleads.v3.enums.KeywordPlanNetworkEnum.KeywordPlanNetwork keyword_plan_network = 6; + + // A default max cpc bid in micros, and in the account currency, for all ad + // groups under the campaign. + // + // This field is required and should not be empty when creating Keyword Plan + // campaigns. + google.protobuf.Int64Value cpc_bid_micros = 7; + + // The geo targets. + // Max number allowed: 20. + repeated KeywordPlanGeoTarget geo_targets = 8; +} + +// A geo target. +message KeywordPlanGeoTarget { + // Required. The resource name of the geo target. + google.protobuf.StringValue geo_target_constant = 1 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/GeoTargetConstant" + }]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/keyword_plan_keyword.proto b/third_party/googleapis/google/ads/googleads/v3/resources/keyword_plan_keyword.proto new file mode 100644 index 000000000..ae4ca9033 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/keyword_plan_keyword.proto @@ -0,0 +1,72 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/keyword_match_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "KeywordPlanKeywordProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the keyword plan keyword resource. + +// A Keyword Plan ad group keyword. +// Max number of keyword plan keywords per plan: 2500. +message KeywordPlanKeyword { + option (google.api.resource) = { + type: "googleads.googleapis.com/KeywordPlanKeyword" + pattern: "customers/{customer}/keywordPlanKeywords/{keyword_plan_keyword}" + }; + + // Immutable. The resource name of the Keyword Plan ad group keyword. + // KeywordPlanKeyword resource names have the form: + // + // `customers/{customer_id}/keywordPlanKeywords/{kp_ad_group_keyword_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanKeyword" + } + ]; + + // The Keyword Plan ad group to which this keyword belongs. + google.protobuf.StringValue keyword_plan_ad_group = 2 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanAdGroup" + }]; + + // Output only. The ID of the Keyword Plan keyword. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The keyword text. + google.protobuf.StringValue text = 4; + + // The keyword match type. + google.ads.googleads.v3.enums.KeywordMatchTypeEnum.KeywordMatchType match_type = 5; + + // A keyword level max cpc bid in micros, in the account currency, that + // overrides the keyword plan ad group cpc bid. + google.protobuf.Int64Value cpc_bid_micros = 6; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/keyword_plan_negative_keyword.proto b/third_party/googleapis/google/ads/googleads/v3/resources/keyword_plan_negative_keyword.proto new file mode 100644 index 000000000..8c691bd5e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/keyword_plan_negative_keyword.proto @@ -0,0 +1,68 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/keyword_match_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "KeywordPlanNegativeKeywordProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the keyword plan negative keyword resource. + +// A Keyword Plan negative keyword. +// Max number of keyword plan negative keywords per plan: 1000. +message KeywordPlanNegativeKeyword { + option (google.api.resource) = { + type: "googleads.googleapis.com/KeywordPlanNegativeKeyword" + pattern: "customers/{customer}/keywordPlanNegativeKeywords/{keyword_plan_negative_keyword}" + }; + + // Immutable. The resource name of the Keyword Plan negative keyword. + // KeywordPlanNegativeKeyword resource names have the form: + // + // `customers/{customer_id}/keywordPlanNegativeKeywords/{kp_negative_keyword_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanNegativeKeyword" + } + ]; + + // The Keyword Plan campaign to which this negative keyword belongs. + google.protobuf.StringValue keyword_plan_campaign = 2 [(google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanCampaign" + }]; + + // Output only. The ID of the Keyword Plan negative keyword. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The keyword text. + google.protobuf.StringValue text = 4; + + // The keyword match type. + google.ads.googleads.v3.enums.KeywordMatchTypeEnum.KeywordMatchType match_type = 5; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/keyword_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/keyword_view.proto new file mode 100644 index 000000000..36701ce06 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/keyword_view.proto @@ -0,0 +1,51 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "KeywordViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the keyword view resource. + +// A keyword view. +message KeywordView { + option (google.api.resource) = { + type: "googleads.googleapis.com/KeywordView" + pattern: "customers/{customer}/keywordViews/{keyword_view}" + }; + + // Output only. The resource name of the keyword view. + // Keyword view resource names have the form: + // + // `customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/label.proto b/third_party/googleapis/google/ads/googleads/v3/resources/label.proto new file mode 100644 index 000000000..a75871e9f --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/label.proto @@ -0,0 +1,67 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/text_label.proto"; +import "google/ads/googleads/v3/enums/label_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "LabelProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// A label. +message Label { + option (google.api.resource) = { + type: "googleads.googleapis.com/Label" + pattern: "customers/{customer}/labels/{label}" + }; + + // Immutable. Name of the resource. + // Label resource names have the form: + // `customers/{customer_id}/labels/{label_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Label" + } + ]; + + // Output only. Id of the label. Read only. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The name of the label. + // + // This field is required and should not be empty when creating a new label. + // + // The length of this string should be between 1 and 80, inclusive. + google.protobuf.StringValue name = 3; + + // Output only. Status of the label. Read only. + google.ads.googleads.v3.enums.LabelStatusEnum.LabelStatus status = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // A type of label displaying text on a colored background. + google.ads.googleads.v3.common.TextLabel text_label = 5; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/landing_page_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/landing_page_view.proto new file mode 100644 index 000000000..fda51342c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/landing_page_view.proto @@ -0,0 +1,56 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "LandingPageViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the landing page view resource. + +// A landing page view with metrics aggregated at the unexpanded final URL +// level. +message LandingPageView { + option (google.api.resource) = { + type: "googleads.googleapis.com/LandingPageView" + pattern: "customers/{customer}/landingPageViews/{landing_page_view}" + }; + + // Output only. The resource name of the landing page view. + // Landing page view resource names have the form: + // + // `customers/{customer_id}/landingPageViews/{unexpanded_final_url_fingerprint}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/LandingPageView" + } + ]; + + // Output only. The advertiser-specified final URL. + google.protobuf.StringValue unexpanded_final_url = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/language_constant.proto b/third_party/googleapis/google/ads/googleads/v3/resources/language_constant.proto new file mode 100644 index 000000000..54eabdbbf --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/language_constant.proto @@ -0,0 +1,65 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "LanguageConstantProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the language constant resource. + +// A language. +message LanguageConstant { + option (google.api.resource) = { + type: "googleads.googleapis.com/LanguageConstant" + pattern: "languageConstants/{language_constant}" + }; + + // Output only. The resource name of the language constant. + // Language constant resource names have the form: + // + // `languageConstants/{criterion_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/LanguageConstant" + } + ]; + + // Output only. The ID of the language constant. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The language code, e.g. "en_US", "en_AU", "es", "fr", etc. + google.protobuf.StringValue code = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The full name of the language in English, e.g., "English (US)", "Spanish", + // etc. + google.protobuf.StringValue name = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Whether the language is targetable. + google.protobuf.BoolValue targetable = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/location_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/location_view.proto new file mode 100644 index 000000000..1405e57c9 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/location_view.proto @@ -0,0 +1,52 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "LocationViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the location view resource. + +// A location view summarizes the performance of campaigns by +// Location criteria. +message LocationView { + option (google.api.resource) = { + type: "googleads.googleapis.com/LocationView" + pattern: "customers/{customer}/locationViews/{location_view}" + }; + + // Output only. The resource name of the location view. + // Location view resource names have the form: + // + // `customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/LocationView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/managed_placement_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/managed_placement_view.proto new file mode 100644 index 000000000..2175df462 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/managed_placement_view.proto @@ -0,0 +1,51 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "ManagedPlacementViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the Managed Placement view resource. + +// A managed placement view. +message ManagedPlacementView { + option (google.api.resource) = { + type: "googleads.googleapis.com/ManagedPlacementView" + pattern: "customers/{customer}/managedPlacementViews/{managed_placement_view}" + }; + + // Output only. The resource name of the Managed Placement view. + // Managed placement view resource names have the form: + // + // `customers/{customer_id}/managedPlacementViews/{ad_group_id}~{criterion_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ManagedPlacementView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/media_file.proto b/third_party/googleapis/google/ads/googleads/v3/resources/media_file.proto new file mode 100644 index 000000000..4068912af --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/media_file.proto @@ -0,0 +1,125 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/media_type.proto"; +import "google/ads/googleads/v3/enums/mime_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "MediaFileProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the media file resource. + +// A media file. +message MediaFile { + option (google.api.resource) = { + type: "googleads.googleapis.com/MediaFile" + pattern: "customers/{customer}/mediaFiles/{media_file}" + }; + + // Immutable. The resource name of the media file. + // Media file resource names have the form: + // + // `customers/{customer_id}/mediaFiles/{media_file_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MediaFile" + } + ]; + + // Output only. The ID of the media file. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. Type of the media file. + google.ads.googleads.v3.enums.MediaTypeEnum.MediaType type = 5 [(google.api.field_behavior) = IMMUTABLE]; + + // Output only. The mime type of the media file. + google.ads.googleads.v3.enums.MimeTypeEnum.MimeType mime_type = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. The URL of where the original media file was downloaded from (or a file + // name). Only used for media of type AUDIO and IMAGE. + google.protobuf.StringValue source_url = 7 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. The name of the media file. The name can be used by clients to help + // identify previously uploaded media. + google.protobuf.StringValue name = 8 [(google.api.field_behavior) = IMMUTABLE]; + + // Output only. The size of the media file in bytes. + google.protobuf.Int64Value file_size = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The specific type of the media file. + oneof mediatype { + // Immutable. Encapsulates an Image. + MediaImage image = 3 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. A ZIP archive media the content of which contains HTML5 assets. + MediaBundle media_bundle = 4 [(google.api.field_behavior) = IMMUTABLE]; + + // Output only. Encapsulates an Audio. + MediaAudio audio = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. Encapsulates a Video. + MediaVideo video = 11 [(google.api.field_behavior) = IMMUTABLE]; + } +} + +// Encapsulates an Image. +message MediaImage { + // Immutable. Raw image data. + google.protobuf.BytesValue data = 1 [(google.api.field_behavior) = IMMUTABLE]; +} + +// Represents a ZIP archive media the content of which contains HTML5 assets. +message MediaBundle { + // Immutable. Raw zipped data. + google.protobuf.BytesValue data = 1 [(google.api.field_behavior) = IMMUTABLE]; +} + +// Encapsulates an Audio. +message MediaAudio { + // Output only. The duration of the Audio in milliseconds. + google.protobuf.Int64Value ad_duration_millis = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// Encapsulates a Video. +message MediaVideo { + // Output only. The duration of the Video in milliseconds. + google.protobuf.Int64Value ad_duration_millis = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. The YouTube video ID (as seen in YouTube URLs). + google.protobuf.StringValue youtube_video_id = 2 [(google.api.field_behavior) = IMMUTABLE]; + + // Output only. The Advertising Digital Identification code for this video, as defined by + // the American Association of Advertising Agencies, used mainly for + // television commercials. + google.protobuf.StringValue advertising_id_code = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The Industry Standard Commercial Identifier code for this video, used + // mainly for television commercials. + google.protobuf.StringValue isci_code = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/merchant_center_link.proto b/third_party/googleapis/google/ads/googleads/v3/resources/merchant_center_link.proto new file mode 100644 index 000000000..a5a8d021b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/merchant_center_link.proto @@ -0,0 +1,65 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/merchant_center_link_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "MerchantCenterLinkProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the Merchant Center link resource. + +// A data sharing connection, proposed or in use, +// between a Google Ads Customer and a Merchant Center account. +message MerchantCenterLink { + option (google.api.resource) = { + type: "googleads.googleapis.com/MerchantCenterLink" + pattern: "customers/{customer}/merchantCenterLinks/{merchant_center_link}" + }; + + // Immutable. The resource name of the merchant center link. + // Merchant center link resource names have the form: + // + // `customers/{customer_id}/merchantCenterLinks/{merchant_center_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MerchantCenterLink" + } + ]; + + // Output only. The ID of the Merchant Center account. + // This field is readonly. + google.protobuf.Int64Value id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The name of the Merchant Center account. + // This field is readonly. + google.protobuf.StringValue merchant_center_account_name = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The status of the link. + google.ads.googleads.v3.enums.MerchantCenterLinkStatusEnum.MerchantCenterLinkStatus status = 5; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/mobile_app_category_constant.proto b/third_party/googleapis/google/ads/googleads/v3/resources/mobile_app_category_constant.proto new file mode 100644 index 000000000..7ae25c914 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/mobile_app_category_constant.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "MobileAppCategoryConstantProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the Mobile App Category Constant resource. + +// A mobile application category constant. +message MobileAppCategoryConstant { + option (google.api.resource) = { + type: "googleads.googleapis.com/MobileAppCategoryConstant" + pattern: "mobileAppCategoryConstants/{mobile_app_category_constant}" + }; + + // Output only. The resource name of the mobile app category constant. + // Mobile app category constant resource names have the form: + // + // `mobileAppCategoryConstants/{mobile_app_category_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MobileAppCategoryConstant" + } + ]; + + // Output only. The ID of the mobile app category constant. + google.protobuf.Int32Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Mobile app category name. + google.protobuf.StringValue name = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/mobile_device_constant.proto b/third_party/googleapis/google/ads/googleads/v3/resources/mobile_device_constant.proto new file mode 100644 index 000000000..711904254 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/mobile_device_constant.proto @@ -0,0 +1,68 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/mobile_device_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "MobileDeviceConstantProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the mobile device constant resource. + +// A mobile device constant. +message MobileDeviceConstant { + option (google.api.resource) = { + type: "googleads.googleapis.com/MobileDeviceConstant" + pattern: "mobileDeviceConstants/{mobile_device_constant}" + }; + + // Output only. The resource name of the mobile device constant. + // Mobile device constant resource names have the form: + // + // `mobileDeviceConstants/{criterion_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MobileDeviceConstant" + } + ]; + + // Output only. The ID of the mobile device constant. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The name of the mobile device. + google.protobuf.StringValue name = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The manufacturer of the mobile device. + google.protobuf.StringValue manufacturer_name = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The operating system of the mobile device. + google.protobuf.StringValue operating_system_name = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The type of mobile device. + google.ads.googleads.v3.enums.MobileDeviceTypeEnum.MobileDeviceType type = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/mutate_job.proto b/third_party/googleapis/google/ads/googleads/v3/resources/mutate_job.proto new file mode 100644 index 000000000..61a72ca04 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/mutate_job.proto @@ -0,0 +1,95 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/mutate_job_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "MutateJobProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the mutate job resource. + +// A list of mutates being processed asynchronously. The mutates are uploaded +// by the user. The mutates themselves aren't readable and the results of the +// job can only be read using MutateJobService.ListMutateJobResults. +message MutateJob { + option (google.api.resource) = { + type: "googleads.googleapis.com/MutateJob" + pattern: "customers/{customer}/mutateJobs/{mutate_job}" + }; + + // Additional information about the mutate job. This message is also used as + // metadata returned in mutate job Long Running Operations. + message MutateJobMetadata { + // Output only. The time when this mutate job was created. + // Formatted as yyyy-mm-dd hh:mm:ss. Example: "2018-03-05 09:15:00" + google.protobuf.StringValue creation_date_time = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The time when this mutate job was completed. + // Formatted as yyyy-MM-dd HH:mm:ss. Example: "2018-03-05 09:16:00" + google.protobuf.StringValue completion_date_time = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The fraction (between 0.0 and 1.0) of mutates that have been processed. + // This is empty if the job hasn't started running yet. + google.protobuf.DoubleValue estimated_completion_ratio = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The number of mutate operations in the mutate job. + google.protobuf.Int64Value operation_count = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The number of mutate operations executed by the mutate job. + // Present only if the job has started running. + google.protobuf.Int64Value executed_operation_count = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // Immutable. The resource name of the mutate job. + // Mutate job resource names have the form: + // + // `customers/{customer_id}/mutateJobs/{mutate_job_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MutateJob" + } + ]; + + // Output only. ID of this mutate job. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The next sequence token to use when adding operations. Only set when the + // mutate job status is PENDING. + google.protobuf.StringValue next_add_sequence_token = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Contains additional information about this mutate job. + MutateJobMetadata metadata = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Status of this mutate job. + google.ads.googleads.v3.enums.MutateJobStatusEnum.MutateJobStatus status = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The resource name of the long-running operation that can be used to poll + // for completion. Only set when the mutate job status is RUNNING or DONE. + google.protobuf.StringValue long_running_operation = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/offline_user_data_job.proto b/third_party/googleapis/google/ads/googleads/v3/resources/offline_user_data_job.proto new file mode 100644 index 000000000..6e2d5e394 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/offline_user_data_job.proto @@ -0,0 +1,83 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/offline_user_data.proto"; +import "google/ads/googleads/v3/enums/offline_user_data_job_failure_reason.proto"; +import "google/ads/googleads/v3/enums/offline_user_data_job_status.proto"; +import "google/ads/googleads/v3/enums/offline_user_data_job_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "OfflineUserDataJobProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the offline user data job resource. + +// A job containing offline user data of store visitors, or user list members +// that will be processed asynchronously. The uploaded data isn't readable and +// the processing results of the job can only be read using +// OfflineUserDataJobService.GetOfflineUserDataJob. +message OfflineUserDataJob { + option (google.api.resource) = { + type: "googleads.googleapis.com/OfflineUserDataJob" + pattern: "customers/{customer}/offlineUserDataJobs/{offline_user_data_job}" + }; + + // Immutable. The resource name of the offline user data job. + // Offline user data job resource names have the form: + // + // `customers/{customer_id}/offlineUserDataJobs/{offline_user_data_job_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/OfflineUserDataJob" + } + ]; + + // Output only. ID of this offline user data job. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. User specified job ID. + google.protobuf.Int64Value external_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Type of the job. + google.ads.googleads.v3.enums.OfflineUserDataJobTypeEnum.OfflineUserDataJobType type = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Status of the job. + google.ads.googleads.v3.enums.OfflineUserDataJobStatusEnum.OfflineUserDataJobStatus status = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Reason for the processing failure, if status is FAILED. + google.ads.googleads.v3.enums.OfflineUserDataJobFailureReasonEnum.OfflineUserDataJobFailureReason failure_reason = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Metadata of the job. + oneof metadata { + // Output only. Metadata for data updates to a CRM-based user list. + google.ads.googleads.v3.common.CustomerMatchUserListMetadata customer_match_user_list_metadata = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Metadata for store sales data update. + google.ads.googleads.v3.common.StoreSalesMetadata store_sales_metadata = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/operating_system_version_constant.proto b/third_party/googleapis/google/ads/googleads/v3/resources/operating_system_version_constant.proto new file mode 100644 index 000000000..cb9ed40ba --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/operating_system_version_constant.proto @@ -0,0 +1,71 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/operating_system_version_operator_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "OperatingSystemVersionConstantProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the operating system version constant resource. + +// A mobile operating system version or a range of versions, depending on +// `operator_type`. List of available mobile platforms at +// https://developers.google.com/adwords/api/docs/appendix/codes-formats#mobile-platforms +message OperatingSystemVersionConstant { + option (google.api.resource) = { + type: "googleads.googleapis.com/OperatingSystemVersionConstant" + pattern: "operatingSystemVersionConstants/{operating_system_version_constant}" + }; + + // Output only. The resource name of the operating system version constant. + // Operating system version constant resource names have the form: + // + // `operatingSystemVersionConstants/{criterion_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/OperatingSystemVersionConstant" + } + ]; + + // Output only. The ID of the operating system version. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Name of the operating system. + google.protobuf.StringValue name = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The OS Major Version number. + google.protobuf.Int32Value os_major_version = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The OS Minor Version number. + google.protobuf.Int32Value os_minor_version = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Determines whether this constant represents a single version or a range of + // versions. + google.ads.googleads.v3.enums.OperatingSystemVersionOperatorTypeEnum.OperatingSystemVersionOperatorType operator_type = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/paid_organic_search_term_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/paid_organic_search_term_view.proto new file mode 100644 index 000000000..0bb047386 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/paid_organic_search_term_view.proto @@ -0,0 +1,57 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "PaidOrganicSearchTermViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the PaidOrganicSearchTermView resource. + +// A paid organic search term view providing a view of search stats across +// ads and organic listings aggregated by search term at the ad group level. +message PaidOrganicSearchTermView { + option (google.api.resource) = { + type: "googleads.googleapis.com/PaidOrganicSearchTermView" + pattern: "customers/{customer}/paidOrganicSearchTermViews/{paid_organic_search_term_view}" + }; + + // Output only. The resource name of the search term view. + // Search term view resource names have the form: + // + // `customers/{customer_id}/paidOrganicSearchTermViews/{campaign_id}~ + // {ad_group_id}~{URL-base64 search term}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/PaidOrganicSearchTermView" + } + ]; + + // Output only. The search term. + google.protobuf.StringValue search_term = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/parental_status_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/parental_status_view.proto new file mode 100644 index 000000000..8aae34dbc --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/parental_status_view.proto @@ -0,0 +1,51 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "ParentalStatusViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the parental status view resource. + +// A parental status view. +message ParentalStatusView { + option (google.api.resource) = { + type: "googleads.googleapis.com/ParentalStatusView" + pattern: "customers/{customer}/parentalStatusViews/{parental_status_view}" + }; + + // Output only. The resource name of the parental status view. + // Parental Status view resource names have the form: + // + // `customers/{customer_id}/parentalStatusViews/{ad_group_id}~{criterion_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ParentalStatusView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/payments_account.proto b/third_party/googleapis/google/ads/googleads/v3/resources/payments_account.proto new file mode 100644 index 000000000..5012e167b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/payments_account.proto @@ -0,0 +1,74 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "PaymentsAccountProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the PaymentsAccount resource. + +// A payments account, which can be used to set up billing for an Ads customer. +message PaymentsAccount { + option (google.api.resource) = { + type: "googleads.googleapis.com/PaymentsAccount" + pattern: "customers/{customer}/paymentsAccounts/{payments_account}" + }; + + // Output only. The resource name of the payments account. + // PaymentsAccount resource names have the form: + // + // `customers/{customer_id}/paymentsAccounts/{payments_account_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/PaymentsAccount" + } + ]; + + // Output only. A 16 digit ID used to identify a payments account. + google.protobuf.StringValue payments_account_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The name of the payments account. + google.protobuf.StringValue name = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The currency code of the payments account. + // A subset of the currency codes derived from the ISO 4217 standard is + // supported. + google.protobuf.StringValue currency_code = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. A 12 digit ID used to identify the payments profile associated with the + // payments account. + google.protobuf.StringValue payments_profile_id = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. A secondary payments profile ID present in uncommon situations, e.g. + // when a sequential liability agreement has been arranged. + google.protobuf.StringValue secondary_payments_profile_id = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Paying manager of this payment account. + google.protobuf.StringValue paying_manager_customer = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/product_bidding_category_constant.proto b/third_party/googleapis/google/ads/googleads/v3/resources/product_bidding_category_constant.proto new file mode 100644 index 000000000..149fb016a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/product_bidding_category_constant.proto @@ -0,0 +1,84 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/product_bidding_category_level.proto"; +import "google/ads/googleads/v3/enums/product_bidding_category_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "ProductBiddingCategoryConstantProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the ProductBiddingCategoryConstant resource. + +// A Product Bidding Category. +message ProductBiddingCategoryConstant { + option (google.api.resource) = { + type: "googleads.googleapis.com/ProductBiddingCategoryConstant" + pattern: "productBiddingCategoryConstants/{product_bidding_category_constant}" + }; + + // Output only. The resource name of the product bidding category. + // Product bidding category resource names have the form: + // + // `productBiddingCategoryConstants/{country_code}~{level}~{id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ProductBiddingCategoryConstant" + } + ]; + + // Output only. ID of the product bidding category. + // + // This ID is equivalent to the google_product_category ID as described in + // this article: https://support.google.com/merchants/answer/6324436. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Two-letter upper-case country code of the product bidding category. + google.protobuf.StringValue country_code = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Resource name of the parent product bidding category. + google.protobuf.StringValue product_bidding_category_constant_parent = 4 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ProductBiddingCategoryConstant" + } + ]; + + // Output only. Level of the product bidding category. + google.ads.googleads.v3.enums.ProductBiddingCategoryLevelEnum.ProductBiddingCategoryLevel level = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Status of the product bidding category. + google.ads.googleads.v3.enums.ProductBiddingCategoryStatusEnum.ProductBiddingCategoryStatus status = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Language code of the product bidding category. + google.protobuf.StringValue language_code = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Display value of the product bidding category localized according to + // language_code. + google.protobuf.StringValue localized_name = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/product_group_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/product_group_view.proto new file mode 100644 index 000000000..2572a3fb6 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/product_group_view.proto @@ -0,0 +1,51 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "ProductGroupViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the ProductGroup View resource. + +// A product group view. +message ProductGroupView { + option (google.api.resource) = { + type: "googleads.googleapis.com/ProductGroupView" + pattern: "customers/{customer}/productGroupViews/{product_group_view}" + }; + + // Output only. The resource name of the product group view. + // Product group view resource names have the form: + // + // `customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ProductGroupView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/recommendation.proto b/third_party/googleapis/google/ads/googleads/v3/resources/recommendation.proto new file mode 100644 index 000000000..104ab6e8d --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/recommendation.proto @@ -0,0 +1,319 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/criteria.proto"; +import "google/ads/googleads/v3/common/extensions.proto"; +import "google/ads/googleads/v3/enums/keyword_match_type.proto"; +import "google/ads/googleads/v3/enums/recommendation_type.proto"; +import "google/ads/googleads/v3/enums/target_cpa_opt_in_recommendation_goal.proto"; +import "google/ads/googleads/v3/resources/ad.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "RecommendationProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the Recommendation resource. + +// A recommendation. +message Recommendation { + option (google.api.resource) = { + type: "googleads.googleapis.com/Recommendation" + pattern: "customers/{customer}/recommendations/{recommendation}" + }; + + // The impact of making the change as described in the recommendation. + // Some types of recommendations may not have impact information. + message RecommendationImpact { + // Output only. Base metrics at the time the recommendation was generated. + RecommendationMetrics base_metrics = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Estimated metrics if the recommendation is applied. + RecommendationMetrics potential_metrics = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // Weekly account performance metrics. For some recommendation types, these + // are averaged over the past 90-day period and hence can be fractional. + message RecommendationMetrics { + // Output only. Number of ad impressions. + google.protobuf.DoubleValue impressions = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Number of ad clicks. + google.protobuf.DoubleValue clicks = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Cost (in micros) for advertising, in the local currency for the account. + google.protobuf.Int64Value cost_micros = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Number of conversions. + google.protobuf.DoubleValue conversions = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Number of video views for a video ad campaign. + google.protobuf.DoubleValue video_views = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // The budget recommendation for budget constrained campaigns. + message CampaignBudgetRecommendation { + // The impact estimates for a given budget amount. + message CampaignBudgetRecommendationOption { + // Output only. The budget amount for this option. + google.protobuf.Int64Value budget_amount_micros = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The impact estimate if budget is changed to amount specified in this + // option. + RecommendationImpact impact = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // Output only. The current budget amount in micros. + google.protobuf.Int64Value current_budget_amount_micros = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The recommended budget amount in micros. + google.protobuf.Int64Value recommended_budget_amount_micros = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The budget amounts and associated impact estimates for some values of + // possible budget amounts. + repeated CampaignBudgetRecommendationOption budget_options = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // The keyword recommendation. + message KeywordRecommendation { + // Output only. The recommended keyword. + google.ads.googleads.v3.common.KeywordInfo keyword = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The recommended CPC (cost-per-click) bid. + google.protobuf.Int64Value recommended_cpc_bid_micros = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // The text ad recommendation. + message TextAdRecommendation { + // Output only. Recommended ad. + Ad ad = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Creation date of the recommended ad. + // YYYY-MM-DD format, e.g., 2018-04-17. + google.protobuf.StringValue creation_date = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Date, if present, is the earliest when the recommendation will be auto + // applied. + // YYYY-MM-DD format, e.g., 2018-04-17. + google.protobuf.StringValue auto_apply_date = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // The Target CPA opt-in recommendation. + message TargetCpaOptInRecommendation { + // The Target CPA opt-in option with impact estimate. + message TargetCpaOptInRecommendationOption { + // Output only. The goal achieved by this option. + google.ads.googleads.v3.enums.TargetCpaOptInRecommendationGoalEnum.TargetCpaOptInRecommendationGoal goal = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Average CPA target. + google.protobuf.Int64Value target_cpa_micros = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The minimum campaign budget, in local currency for the account, + // required to achieve the target CPA. + // Amount is specified in micros, where one million is equivalent to one + // currency unit. + google.protobuf.Int64Value required_campaign_budget_amount_micros = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The impact estimate if this option is selected. + RecommendationImpact impact = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // Output only. The available goals and corresponding options for Target CPA strategy. + repeated TargetCpaOptInRecommendationOption options = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The recommended average CPA target. See required budget amount and impact + // of using this recommendation in options list. + google.protobuf.Int64Value recommended_target_cpa_micros = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // The Maximize Conversions Opt-In recommendation. + message MaximizeConversionsOptInRecommendation { + // Output only. The recommended new budget amount. + google.protobuf.Int64Value recommended_budget_amount_micros = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // The Maximize Clicks opt-in recommendation. + message MaximizeClicksOptInRecommendation { + // Output only. The recommended new budget amount. + // Only set if the current budget is too high. + google.protobuf.Int64Value recommended_budget_amount_micros = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // The Callout extension recommendation. + message CalloutExtensionRecommendation { + // Output only. Callout extensions recommended to be added. + repeated google.ads.googleads.v3.common.CalloutFeedItem recommended_extensions = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // The move unused budget recommendation. + message MoveUnusedBudgetRecommendation { + // Output only. The excess budget's resource_name. + google.protobuf.StringValue excess_campaign_budget = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The recommendation for the constrained budget to increase. + CampaignBudgetRecommendation budget_recommendation = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // The Enhanced Cost-Per-Click Opt-In recommendation. + message EnhancedCpcOptInRecommendation { + + } + + // The keyword match type recommendation. + message KeywordMatchTypeRecommendation { + // Output only. The existing keyword where the match type should be more broad. + google.ads.googleads.v3.common.KeywordInfo keyword = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The recommended new match type. + google.ads.googleads.v3.enums.KeywordMatchTypeEnum.KeywordMatchType recommended_match_type = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // The Search Partners Opt-In recommendation. + message SearchPartnersOptInRecommendation { + + } + + // The Call extension recommendation. + message CallExtensionRecommendation { + // Output only. Call extensions recommended to be added. + repeated google.ads.googleads.v3.common.CallFeedItem recommended_extensions = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // The Optimize Ad Rotation recommendation. + message OptimizeAdRotationRecommendation { + + } + + // The Sitelink extension recommendation. + message SitelinkExtensionRecommendation { + // Output only. Sitelink extensions recommended to be added. + repeated google.ads.googleads.v3.common.SitelinkFeedItem recommended_extensions = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // Immutable. The resource name of the recommendation. + // + // `customers/{customer_id}/recommendations/{recommendation_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Recommendation" + } + ]; + + // Output only. The type of recommendation. + google.ads.googleads.v3.enums.RecommendationTypeEnum.RecommendationType type = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The impact on account performance as a result of applying the + // recommendation. + RecommendationImpact impact = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The budget targeted by this recommendation. This will be set only when + // the recommendation affects a single campaign budget. + // + // This field will be set for the following recommendation types: + // CAMPAIGN_BUDGET, MOVE_UNUSED_BUDGET + google.protobuf.StringValue campaign_budget = 5 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignBudget" + } + ]; + + // Output only. The campaign targeted by this recommendation. This will be set only when + // the recommendation affects a single campaign. + // + // This field will be set for the following recommendation types: + // CALL_EXTENSION, CALLOUT_EXTENSION, ENHANCED_CPC_OPT_IN, KEYWORD, + // KEYWORD_MATCH_TYPE, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, + // OPTIMIZE_AD_ROTATION, SEARCH_PARTNERS_OPT_IN, SITELINK_EXTENSION, + // TARGET_CPA_OPT_IN, TEXT_AD + google.protobuf.StringValue campaign = 6 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; + + // Output only. The ad group targeted by this recommendation. This will be set only when + // the recommendation affects a single ad group. + // + // This field will be set for the following recommendation types: + // KEYWORD, OPTIMIZE_AD_ROTATION, TEXT_AD + google.protobuf.StringValue ad_group = 7 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; + + // Output only. Whether the recommendation is dismissed or not. + google.protobuf.BoolValue dismissed = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The details of recommendation. + oneof recommendation { + // Output only. The campaign budget recommendation. + CampaignBudgetRecommendation campaign_budget_recommendation = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The keyword recommendation. + KeywordRecommendation keyword_recommendation = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Add expanded text ad recommendation. + TextAdRecommendation text_ad_recommendation = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The TargetCPA opt-in recommendation. + TargetCpaOptInRecommendation target_cpa_opt_in_recommendation = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The MaximizeConversions Opt-In recommendation. + MaximizeConversionsOptInRecommendation maximize_conversions_opt_in_recommendation = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The Enhanced Cost-Per-Click Opt-In recommendation. + EnhancedCpcOptInRecommendation enhanced_cpc_opt_in_recommendation = 12 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The Search Partners Opt-In recommendation. + SearchPartnersOptInRecommendation search_partners_opt_in_recommendation = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The MaximizeClicks Opt-In recommendation. + MaximizeClicksOptInRecommendation maximize_clicks_opt_in_recommendation = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The Optimize Ad Rotation recommendation. + OptimizeAdRotationRecommendation optimize_ad_rotation_recommendation = 16 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The Callout extension recommendation. + CalloutExtensionRecommendation callout_extension_recommendation = 17 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The Sitelink extension recommendation. + SitelinkExtensionRecommendation sitelink_extension_recommendation = 18 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The Call extension recommendation. + CallExtensionRecommendation call_extension_recommendation = 19 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The keyword match type recommendation. + KeywordMatchTypeRecommendation keyword_match_type_recommendation = 20 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The move unused budget recommendation. + MoveUnusedBudgetRecommendation move_unused_budget_recommendation = 21 [(google.api.field_behavior) = OUTPUT_ONLY]; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/remarketing_action.proto b/third_party/googleapis/google/ads/googleads/v3/resources/remarketing_action.proto new file mode 100644 index 000000000..e1aff0a8a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/remarketing_action.proto @@ -0,0 +1,67 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/tag_snippet.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "RemarketingActionProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the Remarketing Action resource. + +// A remarketing action. A snippet of JavaScript code that will collect the +// product id and the type of page people visited (product page, shopping cart +// page, purchase page, general site visit) on an advertiser's website. +message RemarketingAction { + option (google.api.resource) = { + type: "googleads.googleapis.com/RemarketingAction" + pattern: "customers/{customer}/remarketingActions/{remarketing_action}" + }; + + // Immutable. The resource name of the remarketing action. + // Remarketing action resource names have the form: + // + // `customers/{customer_id}/remarketingActions/{remarketing_action_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/RemarketingAction" + } + ]; + + // Output only. Id of the remarketing action. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The name of the remarketing action. + // + // This field is required and should not be empty when creating new + // remarketing actions. + google.protobuf.StringValue name = 3; + + // Output only. The snippets used for tracking remarketing actions. + repeated google.ads.googleads.v3.common.TagSnippet tag_snippets = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/search_term_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/search_term_view.proto new file mode 100644 index 000000000..11125bc95 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/search_term_view.proto @@ -0,0 +1,69 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/search_term_targeting_status.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "SearchTermViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the SearchTermView resource. + +// A search term view with metrics aggregated by search term at the ad group +// level. +message SearchTermView { + option (google.api.resource) = { + type: "googleads.googleapis.com/SearchTermView" + pattern: "customers/{customer}/searchTermViews/{search_term_view}" + }; + + // Output only. The resource name of the search term view. + // Search term view resource names have the form: + // + // `customers/{customer_id}/searchTermViews/{campaign_id}~{ad_group_id}~{URL-base64_search_term}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/SearchTermView" + } + ]; + + // Output only. The search term. + google.protobuf.StringValue search_term = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The ad group the search term served in. + google.protobuf.StringValue ad_group = 3 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; + + // Output only. Indicates whether the search term is currently one of your + // targeted or excluded keywords. + google.ads.googleads.v3.enums.SearchTermTargetingStatusEnum.SearchTermTargetingStatus status = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/shared_criterion.proto b/third_party/googleapis/google/ads/googleads/v3/resources/shared_criterion.proto new file mode 100644 index 000000000..25baf4a43 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/shared_criterion.proto @@ -0,0 +1,93 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/criteria.proto"; +import "google/ads/googleads/v3/enums/criterion_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "SharedCriterionProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the SharedCriterion resource. + +// A criterion belonging to a shared set. +message SharedCriterion { + option (google.api.resource) = { + type: "googleads.googleapis.com/SharedCriterion" + pattern: "customers/{customer}/sharedCriteria/{shared_criterion}" + }; + + // Immutable. The resource name of the shared criterion. + // Shared set resource names have the form: + // + // `customers/{customer_id}/sharedCriteria/{shared_set_id}~{criterion_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/SharedCriterion" + } + ]; + + // Immutable. The shared set to which the shared criterion belongs. + google.protobuf.StringValue shared_set = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/SharedSet" + } + ]; + + // Output only. The ID of the criterion. + // + // This field is ignored for mutates. + google.protobuf.Int64Value criterion_id = 26 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The type of the criterion. + google.ads.googleads.v3.enums.CriterionTypeEnum.CriterionType type = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The criterion. + // + // Exactly one must be set. + oneof criterion { + // Immutable. Keyword. + google.ads.googleads.v3.common.KeywordInfo keyword = 3 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. YouTube Video. + google.ads.googleads.v3.common.YouTubeVideoInfo youtube_video = 5 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. YouTube Channel. + google.ads.googleads.v3.common.YouTubeChannelInfo youtube_channel = 6 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Placement. + google.ads.googleads.v3.common.PlacementInfo placement = 7 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Mobile App Category. + google.ads.googleads.v3.common.MobileAppCategoryInfo mobile_app_category = 8 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Mobile application. + google.ads.googleads.v3.common.MobileApplicationInfo mobile_application = 9 [(google.api.field_behavior) = IMMUTABLE]; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/shared_set.proto b/third_party/googleapis/google/ads/googleads/v3/resources/shared_set.proto new file mode 100644 index 000000000..0ec8bc632 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/shared_set.proto @@ -0,0 +1,78 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/enums/shared_set_status.proto"; +import "google/ads/googleads/v3/enums/shared_set_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "SharedSetProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the SharedSet resource. + +// SharedSets are used for sharing criterion exclusions across multiple +// campaigns. +message SharedSet { + option (google.api.resource) = { + type: "googleads.googleapis.com/SharedSet" + pattern: "customers/{customer}/sharedSets/{shared_set}" + }; + + // Immutable. The resource name of the shared set. + // Shared set resource names have the form: + // + // `customers/{customer_id}/sharedSets/{shared_set_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/SharedSet" + } + ]; + + // Output only. The ID of this shared set. Read only. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. The type of this shared set: each shared set holds only a single kind + // of resource. Required. Immutable. + google.ads.googleads.v3.enums.SharedSetTypeEnum.SharedSetType type = 3 [(google.api.field_behavior) = IMMUTABLE]; + + // The name of this shared set. Required. + // Shared Sets must have names that are unique among active shared sets of + // the same type. + // The length of this string should be between 1 and 255 UTF-8 bytes, + // inclusive. + google.protobuf.StringValue name = 4; + + // Output only. The status of this shared set. Read only. + google.ads.googleads.v3.enums.SharedSetStatusEnum.SharedSetStatus status = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The number of shared criteria within this shared set. Read only. + google.protobuf.Int64Value member_count = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The number of campaigns associated with this shared set. Read only. + google.protobuf.Int64Value reference_count = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/shopping_performance_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/shopping_performance_view.proto new file mode 100644 index 000000000..e794512d9 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/shopping_performance_view.proto @@ -0,0 +1,55 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "ShoppingPerformanceViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the ShoppingPerformanceView resource. + +// Shopping performance view. +// Provides Shopping campaign statistics aggregated at several product dimension +// levels. Product dimension values from Merchant Center such as brand, +// category, custom attributes, product condition and product type will reflect +// the state of each dimension as of the date and time when the corresponding +// event was recorded. +message ShoppingPerformanceView { + option (google.api.resource) = { + type: "googleads.googleapis.com/ShoppingPerformanceView" + pattern: "customers/{customer}/shoppingPerformanceView" + }; + + // Output only. The resource name of the Shopping performance view. + // Shopping performance view resource names have the form: + // `customers/{customer_id}/shoppingPerformanceView` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ShoppingPerformanceView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/topic_constant.proto b/third_party/googleapis/google/ads/googleads/v3/resources/topic_constant.proto new file mode 100644 index 000000000..a20f7706c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/topic_constant.proto @@ -0,0 +1,72 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "TopicConstantProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the Topic Constant resource. + +// Use topics to target or exclude placements in the Google Display Network +// based on the category into which the placement falls (for example, +// "Pets & Animals/Pets/Dogs"). +message TopicConstant { + option (google.api.resource) = { + type: "googleads.googleapis.com/TopicConstant" + pattern: "topicConstants/{topic_constant}" + }; + + // Output only. The resource name of the topic constant. + // topic constant resource names have the form: + // + // `topicConstants/{topic_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/TopicConstant" + } + ]; + + // Output only. The ID of the topic. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Resource name of parent of the topic constant. + google.protobuf.StringValue topic_constant_parent = 3 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/TopicConstant" + } + ]; + + // Output only. The category to target or exclude. Each subsequent element in the array + // describes a more specific sub-category. For example, + // {"Pets & Animals", "Pets", "Dogs"} represents the + // "Pets & Animals/Pets/Dogs" category. List of available topic categories at + // https://developers.google.com/adwords/api/docs/appendix/verticals + repeated google.protobuf.StringValue path = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/topic_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/topic_view.proto new file mode 100644 index 000000000..8f5731196 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/topic_view.proto @@ -0,0 +1,51 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "TopicViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the topic view resource. + +// A topic view. +message TopicView { + option (google.api.resource) = { + type: "googleads.googleapis.com/TopicView" + pattern: "customers/{customer}/topicViews/{topic_view}" + }; + + // Output only. The resource name of the topic view. + // Topic view resource names have the form: + // + // `customers/{customer_id}/topicViews/{ad_group_id}~{criterion_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/TopicView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/user_interest.proto b/third_party/googleapis/google/ads/googleads/v3/resources/user_interest.proto new file mode 100644 index 000000000..8ab8e5e57 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/user_interest.proto @@ -0,0 +1,77 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/criterion_category_availability.proto"; +import "google/ads/googleads/v3/enums/user_interest_taxonomy_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "UserInterestProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the User Interest resource. + +// A user interest: a particular interest-based vertical to be targeted. +message UserInterest { + option (google.api.resource) = { + type: "googleads.googleapis.com/UserInterest" + pattern: "customers/{customer}/userInterests/{user_interest}" + }; + + // Output only. The resource name of the user interest. + // User interest resource names have the form: + // + // `customers/{customer_id}/userInterests/{user_interest_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/UserInterest" + } + ]; + + // Output only. Taxonomy type of the user interest. + google.ads.googleads.v3.enums.UserInterestTaxonomyTypeEnum.UserInterestTaxonomyType taxonomy_type = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The ID of the user interest. + google.protobuf.Int64Value user_interest_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The name of the user interest. + google.protobuf.StringValue name = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The parent of the user interest. + google.protobuf.StringValue user_interest_parent = 5 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/UserInterest" + } + ]; + + // Output only. True if the user interest is launched to all channels and locales. + google.protobuf.BoolValue launched_to_all = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Availability information of the user interest. + repeated google.ads.googleads.v3.common.CriterionCategoryAvailability availabilities = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/user_list.proto b/third_party/googleapis/google/ads/googleads/v3/resources/user_list.proto new file mode 100644 index 000000000..c62da5dc7 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/user_list.proto @@ -0,0 +1,168 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/ads/googleads/v3/common/user_lists.proto"; +import "google/ads/googleads/v3/enums/access_reason.proto"; +import "google/ads/googleads/v3/enums/user_list_access_status.proto"; +import "google/ads/googleads/v3/enums/user_list_closing_reason.proto"; +import "google/ads/googleads/v3/enums/user_list_membership_status.proto"; +import "google/ads/googleads/v3/enums/user_list_size_range.proto"; +import "google/ads/googleads/v3/enums/user_list_type.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "UserListProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the User List resource. + +// A user list. This is a list of users a customer may target. +message UserList { + option (google.api.resource) = { + type: "googleads.googleapis.com/UserList" + pattern: "customers/{customer}/userLists/{user_list}" + }; + + // Immutable. The resource name of the user list. + // User list resource names have the form: + // + // `customers/{customer_id}/userLists/{user_list_id}` + string resource_name = 1 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/UserList" + } + ]; + + // Output only. Id of the user list. + google.protobuf.Int64Value id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. A flag that indicates if a user may edit a list. Depends on the list + // ownership and list type. For example, external remarketing user lists are + // not editable. + // + // This field is read-only. + google.protobuf.BoolValue read_only = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Name of this user list. Depending on its access_reason, the user list name + // may not be unique (e.g. if access_reason=SHARED) + google.protobuf.StringValue name = 4; + + // Description of this user list. + google.protobuf.StringValue description = 5; + + // Membership status of this user list. Indicates whether a user list is open + // or active. Only open user lists can accumulate more users and can be + // targeted to. + google.ads.googleads.v3.enums.UserListMembershipStatusEnum.UserListMembershipStatus membership_status = 6; + + // An ID from external system. It is used by user list sellers to correlate + // IDs on their systems. + google.protobuf.StringValue integration_code = 7; + + // Number of days a user's cookie stays on your list since its most recent + // addition to the list. This field must be between 0 and 540 inclusive. + // However, for CRM based userlists, this field can be set to 10000 which + // means no expiration. + // + // It'll be ignored for logical_user_list. + google.protobuf.Int64Value membership_life_span = 8; + + // Output only. Estimated number of users in this user list, on the Google Display Network. + // This value is null if the number of users has not yet been determined. + // + // This field is read-only. + google.protobuf.Int64Value size_for_display = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Size range in terms of number of users of the UserList, on the Google + // Display Network. + // + // This field is read-only. + google.ads.googleads.v3.enums.UserListSizeRangeEnum.UserListSizeRange size_range_for_display = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Estimated number of users in this user list in the google.com domain. + // These are the users available for targeting in Search campaigns. + // This value is null if the number of users has not yet been determined. + // + // This field is read-only. + google.protobuf.Int64Value size_for_search = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Size range in terms of number of users of the UserList, for Search ads. + // + // This field is read-only. + google.ads.googleads.v3.enums.UserListSizeRangeEnum.UserListSizeRange size_range_for_search = 12 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Type of this list. + // + // This field is read-only. + google.ads.googleads.v3.enums.UserListTypeEnum.UserListType type = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Indicating the reason why this user list membership status is closed. It is + // only populated on lists that were automatically closed due to inactivity, + // and will be cleared once the list membership status becomes open. + google.ads.googleads.v3.enums.UserListClosingReasonEnum.UserListClosingReason closing_reason = 14; + + // Output only. Indicates the reason this account has been granted access to the list. + // The reason can be SHARED, OWNED, LICENSED or SUBSCRIBED. + // + // This field is read-only. + google.ads.googleads.v3.enums.AccessReasonEnum.AccessReason access_reason = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Indicates if this share is still enabled. When a UserList is shared with + // the user this field is set to ENABLED. Later the userList owner can decide + // to revoke the share and make it DISABLED. + // The default value of this field is set to ENABLED. + google.ads.googleads.v3.enums.UserListAccessStatusEnum.UserListAccessStatus account_user_list_status = 16; + + // Indicates if this user list is eligible for Google Search Network. + google.protobuf.BoolValue eligible_for_search = 17; + + // Output only. Indicates this user list is eligible for Google Display Network. + // + // This field is read-only. + google.protobuf.BoolValue eligible_for_display = 18 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The user list. + // + // Exactly one must be set. + oneof user_list { + // User list of CRM users provided by the advertiser. + google.ads.googleads.v3.common.CrmBasedUserListInfo crm_based_user_list = 19; + + // Output only. User list which are similar to users from another UserList. + // These lists are readonly and automatically created by google. + google.ads.googleads.v3.common.SimilarUserListInfo similar_user_list = 20 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // User list generated by a rule. + google.ads.googleads.v3.common.RuleBasedUserListInfo rule_based_user_list = 21; + + // User list that is a custom combination of user lists and user interests. + google.ads.googleads.v3.common.LogicalUserListInfo logical_user_list = 22; + + // User list targeting as a collection of conversion or remarketing actions. + google.ads.googleads.v3.common.BasicUserListInfo basic_user_list = 23; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/user_location_view.proto b/third_party/googleapis/google/ads/googleads/v3/resources/user_location_view.proto new file mode 100644 index 000000000..115196711 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/user_location_view.proto @@ -0,0 +1,63 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "UserLocationViewProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the user location view resource. + +// A user location view. +// +// User Location View includes all metrics aggregated at the country level, +// one row per country. It reports metrics at the actual physical location of +// the user by targeted or not targeted location. If other segment fields are +// used, you may get more than one row per country. +message UserLocationView { + option (google.api.resource) = { + type: "googleads.googleapis.com/UserLocationView" + pattern: "customers/{customer}/userLocationViews/{user_location_view}" + }; + + // Output only. The resource name of the user location view. + // UserLocation view resource names have the form: + // + // `customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/UserLocationView" + } + ]; + + // Output only. Criterion Id for the country. + google.protobuf.Int64Value country_criterion_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Indicates whether location was targeted or not. + google.protobuf.BoolValue targeting_location = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/resources/video.proto b/third_party/googleapis/google/ads/googleads/v3/resources/video.proto new file mode 100644 index 000000000..5b984c85c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/resources/video.proto @@ -0,0 +1,64 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.resources; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/resources;resources"; +option java_multiple_files = true; +option java_outer_classname = "VideoProto"; +option java_package = "com.google.ads.googleads.v3.resources"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V3::Resources"; + +// Proto file describing the video resource. + +// A video. +message Video { + option (google.api.resource) = { + type: "googleads.googleapis.com/Video" + pattern: "customers/{customer}/videos/{video}" + }; + + // Output only. The resource name of the video. + // Video resource names have the form: + // + // `customers/{customer_id}/videos/{video_id}` + string resource_name = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Video" + } + ]; + + // Output only. The ID of the video. + google.protobuf.StringValue id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The owner channel id of the video. + google.protobuf.StringValue channel_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The duration of the video in milliseconds. + google.protobuf.Int64Value duration_millis = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The title of the video. + google.protobuf.StringValue title = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/account_budget_proposal_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/account_budget_proposal_service.proto new file mode 100644 index 000000000..ddba31b0e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/account_budget_proposal_service.proto @@ -0,0 +1,137 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/account_budget_proposal.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "AccountBudgetProposalServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the AccountBudgetProposal service. + +// A service for managing account-level budgets via proposals. +// +// A proposal is a request to create a new budget or make changes to an +// existing one. +// +// Reads for account-level budgets managed by these proposals will be +// supported in a future version. Until then, please use the +// BudgetOrderService from the AdWords API. Learn more at +// https://developers.google.com/adwords/api/docs/guides/budget-order +// +// Mutates: +// The CREATE operation creates a new proposal. +// UPDATE operations aren't supported. +// The REMOVE operation cancels a pending proposal. +service AccountBudgetProposalService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns an account-level budget proposal in full detail. + rpc GetAccountBudgetProposal(GetAccountBudgetProposalRequest) returns (google.ads.googleads.v3.resources.AccountBudgetProposal) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/accountBudgetProposals/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes account budget proposals. Operation statuses + // are returned. + rpc MutateAccountBudgetProposal(MutateAccountBudgetProposalRequest) returns (MutateAccountBudgetProposalResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/accountBudgetProposals:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operation"; + } +} + +// Request message for +// [AccountBudgetProposalService.GetAccountBudgetProposal][google.ads.googleads.v3.services.AccountBudgetProposalService.GetAccountBudgetProposal]. +message GetAccountBudgetProposalRequest { + // Required. The resource name of the account-level budget proposal to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AccountBudgetProposal" + } + ]; +} + +// Request message for +// [AccountBudgetProposalService.MutateAccountBudgetProposal][google.ads.googleads.v3.services.AccountBudgetProposalService.MutateAccountBudgetProposal]. +message MutateAccountBudgetProposalRequest { + // Required. The ID of the customer. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The operation to perform on an individual account-level budget proposal. + AccountBudgetProposalOperation operation = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 3; +} + +// A single operation to propose the creation of a new account-level budget or +// edit/end/remove an existing one. +message AccountBudgetProposalOperation { + // FieldMask that determines which budget fields are modified. While budgets + // may be modified, proposals that propose such modifications are final. + // Therefore, update operations are not supported for proposals. + // + // Proposals that modify budgets have the 'update' proposal type. Specifying + // a mask for any other proposal type is considered an error. + google.protobuf.FieldMask update_mask = 3; + + // The mutate operation. + oneof operation { + // Create operation: A new proposal to create a new budget, edit an + // existing budget, end an actively running budget, or remove an approved + // budget scheduled to start in the future. + // No resource name is expected for the new proposal. + google.ads.googleads.v3.resources.AccountBudgetProposal create = 2; + + // Remove operation: A resource name for the removed proposal is expected, + // in this format: + // + // `customers/{customer_id}/accountBudgetProposals/{account_budget_proposal_id}` + // A request may be cancelled iff it is pending. + string remove = 1; + } +} + +// Response message for account-level budget mutate operations. +message MutateAccountBudgetProposalResponse { + // The result of the mutate. + MutateAccountBudgetProposalResult result = 2; +} + +// The result for the account budget proposal mutate. +message MutateAccountBudgetProposalResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/account_budget_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/account_budget_service.proto new file mode 100644 index 000000000..44ebb9d60 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/account_budget_service.proto @@ -0,0 +1,61 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/account_budget.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "AccountBudgetServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the AccountBudget service. + +// A service for fetching an account-level budget. +// +// Account-level budgets are mutated by creating proposal resources. +service AccountBudgetService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns an account-level budget in full detail. + rpc GetAccountBudget(GetAccountBudgetRequest) returns (google.ads.googleads.v3.resources.AccountBudget) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/accountBudgets/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for +// [AccountBudgetService.GetAccountBudget][google.ads.googleads.v3.services.AccountBudgetService.GetAccountBudget]. +message GetAccountBudgetRequest { + // Required. The resource name of the account-level budget to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AccountBudget" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/ad_group_ad_asset_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_ad_asset_view_service.proto new file mode 100644 index 000000000..72248d021 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_ad_asset_view_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/ad_group_ad_asset_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupAdAssetViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the ad group ad asset view service. + +// Service to fetch ad group ad asset views. +service AdGroupAdAssetViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested ad group ad asset view in full detail. + rpc GetAdGroupAdAssetView(GetAdGroupAdAssetViewRequest) returns (google.ads.googleads.v3.resources.AdGroupAdAssetView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/adGroupAdAssetViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [AdGroupAdAssetViewService.GetAdGroupAdAssetView][google.ads.googleads.v3.services.AdGroupAdAssetViewService.GetAdGroupAdAssetView]. +message GetAdGroupAdAssetViewRequest { + // Required. The resource name of the ad group ad asset view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAdAssetView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/ad_group_ad_label_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_ad_label_service.proto new file mode 100644 index 000000000..4f1271dc3 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_ad_label_service.proto @@ -0,0 +1,123 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/ad_group_ad_label.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupAdLabelServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Ad Group Ad Label service. + +// Service to manage labels on ad group ads. +service AdGroupAdLabelService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested ad group ad label in full detail. + rpc GetAdGroupAdLabel(GetAdGroupAdLabelRequest) returns (google.ads.googleads.v3.resources.AdGroupAdLabel) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/adGroupAdLabels/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates and removes ad group ad labels. + // Operation statuses are returned. + rpc MutateAdGroupAdLabels(MutateAdGroupAdLabelsRequest) returns (MutateAdGroupAdLabelsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/adGroupAdLabels:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [AdGroupAdLabelService.GetAdGroupAdLabel][google.ads.googleads.v3.services.AdGroupAdLabelService.GetAdGroupAdLabel]. +message GetAdGroupAdLabelRequest { + // Required. The resource name of the ad group ad label to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAdLabel" + } + ]; +} + +// Request message for [AdGroupAdLabelService.MutateAdGroupAdLabels][google.ads.googleads.v3.services.AdGroupAdLabelService.MutateAdGroupAdLabels]. +message MutateAdGroupAdLabelsRequest { + // Required. ID of the customer whose ad group ad labels are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on ad group ad labels. + repeated AdGroupAdLabelOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, remove) on an ad group ad label. +message AdGroupAdLabelOperation { + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new ad group ad + // label. + google.ads.googleads.v3.resources.AdGroupAdLabel create = 1; + + // Remove operation: A resource name for the ad group ad label + // being removed, in this format: + // + // `customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id} + // _{label_id}` + string remove = 2; + } +} + +// Response message for an ad group ad labels mutate. +message MutateAdGroupAdLabelsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateAdGroupAdLabelResult results = 2; +} + +// The result for an ad group ad label mutate. +message MutateAdGroupAdLabelResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/ad_group_ad_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_ad_service.proto new file mode 100644 index 000000000..f6d10b732 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_ad_service.proto @@ -0,0 +1,131 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/common/policy.proto"; +import "google/ads/googleads/v3/resources/ad_group_ad.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupAdServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Ad Group Ad service. + +// Service to manage ads in an ad group. +service AdGroupAdService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested ad in full detail. + rpc GetAdGroupAd(GetAdGroupAdRequest) returns (google.ads.googleads.v3.resources.AdGroupAd) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/adGroupAds/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes ads. Operation statuses are returned. + rpc MutateAdGroupAds(MutateAdGroupAdsRequest) returns (MutateAdGroupAdsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/adGroupAds:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [AdGroupAdService.GetAdGroupAd][google.ads.googleads.v3.services.AdGroupAdService.GetAdGroupAd]. +message GetAdGroupAdRequest { + // Required. The resource name of the ad to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAd" + } + ]; +} + +// Request message for [AdGroupAdService.MutateAdGroupAds][google.ads.googleads.v3.services.AdGroupAdService.MutateAdGroupAds]. +message MutateAdGroupAdsRequest { + // Required. The ID of the customer whose ads are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual ads. + repeated AdGroupAdOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update, remove) on an ad group ad. +message AdGroupAdOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // Configuration for how policies are validated. + google.ads.googleads.v3.common.PolicyValidationParameter policy_validation_parameter = 5; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new ad. + google.ads.googleads.v3.resources.AdGroupAd create = 1; + + // Update operation: The ad is expected to have a valid resource name. + google.ads.googleads.v3.resources.AdGroupAd update = 2; + + // Remove operation: A resource name for the removed ad is expected, + // in this format: + // + // `customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}` + string remove = 3; + } +} + +// Response message for an ad group ad mutate. +message MutateAdGroupAdsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateAdGroupAdResult results = 2; +} + +// The result for the ad mutate. +message MutateAdGroupAdResult { + // The resource name returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/ad_group_audience_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_audience_view_service.proto new file mode 100644 index 000000000..9b4f6f26a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_audience_view_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/ad_group_audience_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupAudienceViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the AdGroup Audience View service. + +// Service to manage ad group audience views. +service AdGroupAudienceViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested ad group audience view in full detail. + rpc GetAdGroupAudienceView(GetAdGroupAudienceViewRequest) returns (google.ads.googleads.v3.resources.AdGroupAudienceView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/adGroupAudienceViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [AdGroupAudienceViewService.GetAdGoupAudienceView][]. +message GetAdGroupAudienceViewRequest { + // Required. The resource name of the ad group audience view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupAudienceView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/ad_group_bid_modifier_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_bid_modifier_service.proto new file mode 100644 index 000000000..1c44496ec --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_bid_modifier_service.proto @@ -0,0 +1,130 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/ad_group_bid_modifier.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupBidModifierServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Ad Group Bid Modifier service. + +// Service to manage ad group bid modifiers. +service AdGroupBidModifierService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested ad group bid modifier in full detail. + rpc GetAdGroupBidModifier(GetAdGroupBidModifierRequest) returns (google.ads.googleads.v3.resources.AdGroupBidModifier) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/adGroupBidModifiers/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes ad group bid modifiers. + // Operation statuses are returned. + rpc MutateAdGroupBidModifiers(MutateAdGroupBidModifiersRequest) returns (MutateAdGroupBidModifiersResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/adGroupBidModifiers:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [AdGroupBidModifierService.GetAdGroupBidModifier][google.ads.googleads.v3.services.AdGroupBidModifierService.GetAdGroupBidModifier]. +message GetAdGroupBidModifierRequest { + // Required. The resource name of the ad group bid modifier to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupBidModifier" + } + ]; +} + +// Request message for [AdGroupBidModifierService.MutateAdGroupBidModifiers][google.ads.googleads.v3.services.AdGroupBidModifierService.MutateAdGroupBidModifiers]. +message MutateAdGroupBidModifiersRequest { + // Required. ID of the customer whose ad group bid modifiers are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual ad group bid modifiers. + repeated AdGroupBidModifierOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, remove, update) on an ad group bid modifier. +message AdGroupBidModifierOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new ad group bid + // modifier. + google.ads.googleads.v3.resources.AdGroupBidModifier create = 1; + + // Update operation: The ad group bid modifier is expected to have a valid + // resource name. + google.ads.googleads.v3.resources.AdGroupBidModifier update = 2; + + // Remove operation: A resource name for the removed ad group bid modifier + // is expected, in this format: + // + // `customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}` + string remove = 3; + } +} + +// Response message for ad group bid modifiers mutate. +message MutateAdGroupBidModifiersResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateAdGroupBidModifierResult results = 2; +} + +// The result for the criterion mutate. +message MutateAdGroupBidModifierResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/ad_group_criterion_label_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_criterion_label_service.proto new file mode 100644 index 000000000..b30e72072 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_criterion_label_service.proto @@ -0,0 +1,124 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/ad_group_criterion_label.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupCriterionLabelServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Ad Group Criterion Label service. + +// Service to manage labels on ad group criteria. +service AdGroupCriterionLabelService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested ad group criterion label in full detail. + rpc GetAdGroupCriterionLabel(GetAdGroupCriterionLabelRequest) returns (google.ads.googleads.v3.resources.AdGroupCriterionLabel) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/adGroupCriterionLabels/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates and removes ad group criterion labels. + // Operation statuses are returned. + rpc MutateAdGroupCriterionLabels(MutateAdGroupCriterionLabelsRequest) returns (MutateAdGroupCriterionLabelsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/adGroupCriterionLabels:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for +// [AdGroupCriterionLabelService.GetAdGroupCriterionLabel][google.ads.googleads.v3.services.AdGroupCriterionLabelService.GetAdGroupCriterionLabel]. +message GetAdGroupCriterionLabelRequest { + // Required. The resource name of the ad group criterion label to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterionLabel" + } + ]; +} + +// Request message for +// [AdGroupCriterionLabelService.MutateAdGroupCriterionLabels][google.ads.googleads.v3.services.AdGroupCriterionLabelService.MutateAdGroupCriterionLabels]. +message MutateAdGroupCriterionLabelsRequest { + // Required. ID of the customer whose ad group criterion labels are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on ad group criterion labels. + repeated AdGroupCriterionLabelOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, remove) on an ad group criterion label. +message AdGroupCriterionLabelOperation { + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new ad group + // label. + google.ads.googleads.v3.resources.AdGroupCriterionLabel create = 1; + + // Remove operation: A resource name for the ad group criterion label + // being removed, in this format: + // + // `customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}` + string remove = 2; + } +} + +// Response message for an ad group criterion labels mutate. +message MutateAdGroupCriterionLabelsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateAdGroupCriterionLabelResult results = 2; +} + +// The result for an ad group criterion label mutate. +message MutateAdGroupCriterionLabelResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/ad_group_criterion_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_criterion_service.proto new file mode 100644 index 000000000..b34ece539 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_criterion_service.proto @@ -0,0 +1,140 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/common/policy.proto"; +import "google/ads/googleads/v3/resources/ad_group_criterion.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupCriterionServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Ad Group Criterion service. + +// Service to manage ad group criteria. +service AdGroupCriterionService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested criterion in full detail. + rpc GetAdGroupCriterion(GetAdGroupCriterionRequest) returns (google.ads.googleads.v3.resources.AdGroupCriterion) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/adGroupCriteria/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes criteria. Operation statuses are returned. + rpc MutateAdGroupCriteria(MutateAdGroupCriteriaRequest) returns (MutateAdGroupCriteriaResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/adGroupCriteria:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [AdGroupCriterionService.GetAdGroupCriterion][google.ads.googleads.v3.services.AdGroupCriterionService.GetAdGroupCriterion]. +message GetAdGroupCriterionRequest { + // Required. The resource name of the criterion to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterion" + } + ]; +} + +// Request message for [AdGroupCriterionService.MutateAdGroupCriteria][google.ads.googleads.v3.services.AdGroupCriterionService.MutateAdGroupCriteria]. +message MutateAdGroupCriteriaRequest { + // Required. ID of the customer whose criteria are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual criteria. + repeated AdGroupCriterionOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, remove, update) on an ad group criterion. +message AdGroupCriterionOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The list of policy violation keys that should not cause a + // PolicyViolationError to be reported. Not all policy violations are + // exemptable, please refer to the is_exemptible field in the returned + // PolicyViolationError. + // + // Resources violating these polices will be saved, but will not be eligible + // to serve. They may begin serving at a later time due to a change in + // policies, re-review of the resource, or a change in advertiser + // certificates. + repeated google.ads.googleads.v3.common.PolicyViolationKey exempt_policy_violation_keys = 5; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new criterion. + google.ads.googleads.v3.resources.AdGroupCriterion create = 1; + + // Update operation: The criterion is expected to have a valid resource + // name. + google.ads.googleads.v3.resources.AdGroupCriterion update = 2; + + // Remove operation: A resource name for the removed criterion is expected, + // in this format: + // + // `customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}` + string remove = 3; + } +} + +// Response message for an ad group criterion mutate. +message MutateAdGroupCriteriaResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateAdGroupCriterionResult results = 2; +} + +// The result for the criterion mutate. +message MutateAdGroupCriterionResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/ad_group_criterion_simulation_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_criterion_simulation_service.proto new file mode 100644 index 000000000..c56a9b028 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_criterion_simulation_service.proto @@ -0,0 +1,59 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/ad_group_criterion_simulation.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupCriterionSimulationServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the AdGroupCriterionSimulation service. + +// Service to fetch ad group criterion simulations. +service AdGroupCriterionSimulationService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested ad group criterion simulation in full detail. + rpc GetAdGroupCriterionSimulation(GetAdGroupCriterionSimulationRequest) returns (google.ads.googleads.v3.resources.AdGroupCriterionSimulation) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/adGroupCriterionSimulations/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for +// [AdGroupCriterionSimulationService.GetAdGroupCriterionSimulation][google.ads.googleads.v3.services.AdGroupCriterionSimulationService.GetAdGroupCriterionSimulation]. +message GetAdGroupCriterionSimulationRequest { + // Required. The resource name of the ad group criterion simulation to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupCriterionSimulation" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/ad_group_extension_setting_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_extension_setting_service.proto new file mode 100644 index 000000000..7047e706a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_extension_setting_service.proto @@ -0,0 +1,134 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/ad_group_extension_setting.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupExtensionSettingServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the AdGroupExtensionSetting service. + +// Service to manage ad group extension settings. +service AdGroupExtensionSettingService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested ad group extension setting in full detail. + rpc GetAdGroupExtensionSetting(GetAdGroupExtensionSettingRequest) returns (google.ads.googleads.v3.resources.AdGroupExtensionSetting) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/adGroupExtensionSettings/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes ad group extension settings. Operation + // statuses are returned. + rpc MutateAdGroupExtensionSettings(MutateAdGroupExtensionSettingsRequest) returns (MutateAdGroupExtensionSettingsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/adGroupExtensionSettings:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for +// [AdGroupExtensionSettingService.GetAdGroupExtensionSetting][google.ads.googleads.v3.services.AdGroupExtensionSettingService.GetAdGroupExtensionSetting]. +message GetAdGroupExtensionSettingRequest { + // Required. The resource name of the ad group extension setting to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupExtensionSetting" + } + ]; +} + +// Request message for +// [AdGroupExtensionSettingService.MutateAdGroupExtensionSettings][google.ads.googleads.v3.services.AdGroupExtensionSettingService.MutateAdGroupExtensionSettings]. +message MutateAdGroupExtensionSettingsRequest { + // Required. The ID of the customer whose ad group extension settings are being + // modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual ad group extension + // settings. + repeated AdGroupExtensionSettingOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update, remove) on an ad group extension setting. +message AdGroupExtensionSettingOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new ad group + // extension setting. + google.ads.googleads.v3.resources.AdGroupExtensionSetting create = 1; + + // Update operation: The ad group extension setting is expected to have a + // valid resource name. + google.ads.googleads.v3.resources.AdGroupExtensionSetting update = 2; + + // Remove operation: A resource name for the removed ad group extension + // setting is expected, in this format: + // + // `customers/{customer_id}/adGroupExtensionSettings/{ad_group_id}~{extension_type}` + string remove = 3; + } +} + +// Response message for an ad group extension setting mutate. +message MutateAdGroupExtensionSettingsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateAdGroupExtensionSettingResult results = 2; +} + +// The result for the ad group extension setting mutate. +message MutateAdGroupExtensionSettingResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/ad_group_feed_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_feed_service.proto new file mode 100644 index 000000000..103f59c44 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_feed_service.proto @@ -0,0 +1,129 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/ad_group_feed.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupFeedServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the AdGroupFeed service. + +// Service to manage ad group feeds. +service AdGroupFeedService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested ad group feed in full detail. + rpc GetAdGroupFeed(GetAdGroupFeedRequest) returns (google.ads.googleads.v3.resources.AdGroupFeed) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/adGroupFeeds/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes ad group feeds. Operation statuses are + // returned. + rpc MutateAdGroupFeeds(MutateAdGroupFeedsRequest) returns (MutateAdGroupFeedsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/adGroupFeeds:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [AdGroupFeedService.GetAdGroupFeed][google.ads.googleads.v3.services.AdGroupFeedService.GetAdGroupFeed]. +message GetAdGroupFeedRequest { + // Required. The resource name of the ad group feed to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupFeed" + } + ]; +} + +// Request message for [AdGroupFeedService.MutateAdGroupFeeds][google.ads.googleads.v3.services.AdGroupFeedService.MutateAdGroupFeeds]. +message MutateAdGroupFeedsRequest { + // Required. The ID of the customer whose ad group feeds are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual ad group feeds. + repeated AdGroupFeedOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update, remove) on an ad group feed. +message AdGroupFeedOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new ad group feed. + google.ads.googleads.v3.resources.AdGroupFeed create = 1; + + // Update operation: The ad group feed is expected to have a valid resource + // name. + google.ads.googleads.v3.resources.AdGroupFeed update = 2; + + // Remove operation: A resource name for the removed ad group feed is + // expected, in this format: + // + // `customers/{customer_id}/adGroupFeeds/{ad_group_id}~{feed_id}` + string remove = 3; + } +} + +// Response message for an ad group feed mutate. +message MutateAdGroupFeedsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateAdGroupFeedResult results = 2; +} + +// The result for the ad group feed mutate. +message MutateAdGroupFeedResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/ad_group_label_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_label_service.proto new file mode 100644 index 000000000..e903a8fb7 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_label_service.proto @@ -0,0 +1,122 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/ad_group_label.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupLabelServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Ad Group Label service. + +// Service to manage labels on ad groups. +service AdGroupLabelService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested ad group label in full detail. + rpc GetAdGroupLabel(GetAdGroupLabelRequest) returns (google.ads.googleads.v3.resources.AdGroupLabel) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/adGroupLabels/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates and removes ad group labels. + // Operation statuses are returned. + rpc MutateAdGroupLabels(MutateAdGroupLabelsRequest) returns (MutateAdGroupLabelsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/adGroupLabels:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [AdGroupLabelService.GetAdGroupLabel][google.ads.googleads.v3.services.AdGroupLabelService.GetAdGroupLabel]. +message GetAdGroupLabelRequest { + // Required. The resource name of the ad group label to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupLabel" + } + ]; +} + +// Request message for [AdGroupLabelService.MutateAdGroupLabels][google.ads.googleads.v3.services.AdGroupLabelService.MutateAdGroupLabels]. +message MutateAdGroupLabelsRequest { + // Required. ID of the customer whose ad group labels are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on ad group labels. + repeated AdGroupLabelOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, remove) on an ad group label. +message AdGroupLabelOperation { + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new ad group + // label. + google.ads.googleads.v3.resources.AdGroupLabel create = 1; + + // Remove operation: A resource name for the ad group label + // being removed, in this format: + // + // `customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}` + string remove = 2; + } +} + +// Response message for an ad group labels mutate. +message MutateAdGroupLabelsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateAdGroupLabelResult results = 2; +} + +// The result for an ad group label mutate. +message MutateAdGroupLabelResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/ad_group_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_service.proto new file mode 100644 index 000000000..495449e0a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_service.proto @@ -0,0 +1,127 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/ad_group.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Ad Group service. + +// Service to manage ad groups. +service AdGroupService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested ad group in full detail. + rpc GetAdGroup(GetAdGroupRequest) returns (google.ads.googleads.v3.resources.AdGroup) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/adGroups/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes ad groups. Operation statuses are returned. + rpc MutateAdGroups(MutateAdGroupsRequest) returns (MutateAdGroupsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/adGroups:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [AdGroupService.GetAdGroup][google.ads.googleads.v3.services.AdGroupService.GetAdGroup]. +message GetAdGroupRequest { + // Required. The resource name of the ad group to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroup" + } + ]; +} + +// Request message for [AdGroupService.MutateAdGroups][google.ads.googleads.v3.services.AdGroupService.MutateAdGroups]. +message MutateAdGroupsRequest { + // Required. The ID of the customer whose ad groups are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual ad groups. + repeated AdGroupOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update, remove) on an ad group. +message AdGroupOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new ad group. + google.ads.googleads.v3.resources.AdGroup create = 1; + + // Update operation: The ad group is expected to have a valid resource name. + google.ads.googleads.v3.resources.AdGroup update = 2; + + // Remove operation: A resource name for the removed ad group is expected, + // in this format: + // + // `customers/{customer_id}/adGroups/{ad_group_id}` + string remove = 3; + } +} + +// Response message for an ad group mutate. +message MutateAdGroupsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateAdGroupResult results = 2; +} + +// The result for the ad group mutate. +message MutateAdGroupResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/ad_group_simulation_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_simulation_service.proto new file mode 100644 index 000000000..56f00966f --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/ad_group_simulation_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/ad_group_simulation.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "AdGroupSimulationServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the AdGroupSimulation service. + +// Service to fetch ad group simulations. +service AdGroupSimulationService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested ad group simulation in full detail. + rpc GetAdGroupSimulation(GetAdGroupSimulationRequest) returns (google.ads.googleads.v3.resources.AdGroupSimulation) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/adGroupSimulations/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [AdGroupSimulationService.GetAdGroupSimulation][google.ads.googleads.v3.services.AdGroupSimulationService.GetAdGroupSimulation]. +message GetAdGroupSimulationRequest { + // Required. The resource name of the ad group simulation to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdGroupSimulation" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/ad_parameter_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/ad_parameter_service.proto new file mode 100644 index 000000000..290a6ee3c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/ad_parameter_service.proto @@ -0,0 +1,129 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/ad_parameter.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "AdParameterServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Ad Parameter service. + +// Service to manage ad parameters. +service AdParameterService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested ad parameter in full detail. + rpc GetAdParameter(GetAdParameterRequest) returns (google.ads.googleads.v3.resources.AdParameter) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/adParameters/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes ad parameters. Operation statuses are + // returned. + rpc MutateAdParameters(MutateAdParametersRequest) returns (MutateAdParametersResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/adParameters:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [AdParameterService.GetAdParameter][google.ads.googleads.v3.services.AdParameterService.GetAdParameter] +message GetAdParameterRequest { + // Required. The resource name of the ad parameter to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdParameter" + } + ]; +} + +// Request message for [AdParameterService.MutateAdParameters][google.ads.googleads.v3.services.AdParameterService.MutateAdParameters] +message MutateAdParametersRequest { + // Required. The ID of the customer whose ad parameters are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual ad parameters. + repeated AdParameterOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update, remove) on ad parameter. +message AdParameterOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new ad parameter. + google.ads.googleads.v3.resources.AdParameter create = 1; + + // Update operation: The ad parameter is expected to have a valid resource + // name. + google.ads.googleads.v3.resources.AdParameter update = 2; + + // Remove operation: A resource name for the ad parameter to remove is + // expected in this format: + // + // `customers/{customer_id}/adParameters/{ad_group_id}~{criterion_id}~{parameter_index}` + string remove = 3; + } +} + +// Response message for an ad parameter mutate. +message MutateAdParametersResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateAdParameterResult results = 2; +} + +// The result for the ad parameter mutate. +message MutateAdParameterResult { + // The resource name returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/ad_schedule_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/ad_schedule_view_service.proto new file mode 100644 index 000000000..ac547c10e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/ad_schedule_view_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/ad_schedule_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "AdScheduleViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the AdSchedule View service. + +// Service to fetch ad schedule views. +service AdScheduleViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested ad schedule view in full detail. + rpc GetAdScheduleView(GetAdScheduleViewRequest) returns (google.ads.googleads.v3.resources.AdScheduleView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/adScheduleViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [AdScheduleViewService.GetAdScheduleView][google.ads.googleads.v3.services.AdScheduleViewService.GetAdScheduleView]. +message GetAdScheduleViewRequest { + // Required. The resource name of the ad schedule view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AdScheduleView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/ad_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/ad_service.proto new file mode 100644 index 000000000..40cf417a8 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/ad_service.proto @@ -0,0 +1,104 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/ad.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "AdServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Ad service. + +// Service to manage ads. +service AdService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested ad in full detail. + rpc GetAd(GetAdRequest) returns (google.ads.googleads.v3.resources.Ad) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/ads/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Updates ads. Operation statuses are returned. + rpc MutateAds(MutateAdsRequest) returns (MutateAdsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/ads:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [AdService.GetAd][google.ads.googleads.v3.services.AdService.GetAd]. +message GetAdRequest { + // Required. The resource name of the ad to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Ad" + } + ]; +} + +// Request message for [AdService.MutateAds][google.ads.googleads.v3.services.AdService.MutateAds]. +message MutateAdsRequest { + // Required. The ID of the customer whose ads are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual ads. + repeated AdOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// A single update operation on an ad. +message AdOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 2; + + // The mutate operation. + oneof operation { + // Update operation: The ad is expected to have a valid resource name + // in this format: + // + // `customers/{customer_id}/ads/{ad_id}` + google.ads.googleads.v3.resources.Ad update = 1; + } +} + +// Response message for an ad mutate. +message MutateAdsResponse { + // All results for the mutate. + repeated MutateAdResult results = 2; +} + +// The result for the ad mutate. +message MutateAdResult { + // The resource name returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/age_range_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/age_range_view_service.proto new file mode 100644 index 000000000..ac159e1b3 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/age_range_view_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/age_range_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "AgeRangeViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Age Range View service. + +// Service to manage age range views. +service AgeRangeViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested age range view in full detail. + rpc GetAgeRangeView(GetAgeRangeViewRequest) returns (google.ads.googleads.v3.resources.AgeRangeView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/ageRangeViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [AgeRangeViewService.GetAgeRangeView][google.ads.googleads.v3.services.AgeRangeViewService.GetAgeRangeView]. +message GetAgeRangeViewRequest { + // Required. The resource name of the age range view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/AgeRangeView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/asset_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/asset_service.proto new file mode 100644 index 000000000..8f1416603 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/asset_service.proto @@ -0,0 +1,101 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/asset.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "AssetServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Asset service. + +// Service to manage assets. Asset types can be created with AssetService are +// YoutubeVideoAsset, MediaBundleAsset and ImageAsset. TextAsset should be +// created with Ad inline. +service AssetService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested asset in full detail. + rpc GetAsset(GetAssetRequest) returns (google.ads.googleads.v3.resources.Asset) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/assets/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates assets. Operation statuses are returned. + rpc MutateAssets(MutateAssetsRequest) returns (MutateAssetsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/assets:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [AssetService.GetAsset][google.ads.googleads.v3.services.AssetService.GetAsset] +message GetAssetRequest { + // Required. The resource name of the asset to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Asset" + } + ]; +} + +// Request message for [AssetService.MutateAssets][google.ads.googleads.v3.services.AssetService.MutateAssets] +message MutateAssetsRequest { + // Required. The ID of the customer whose assets are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual assets. + repeated AssetOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// A single operation to create an asset. Supported asset types are +// YoutubeVideoAsset, MediaBundleAsset, ImageAsset, and LeadFormAsset. TextAsset +// should be created with Ad inline. +message AssetOperation { + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new asset. + google.ads.googleads.v3.resources.Asset create = 1; + } +} + +// Response message for an asset mutate. +message MutateAssetsResponse { + // All results for the mutate. + repeated MutateAssetResult results = 2; +} + +// The result for the asset mutate. +message MutateAssetResult { + // The resource name returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/bidding_strategy_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/bidding_strategy_service.proto new file mode 100644 index 000000000..8fdbfb8d8 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/bidding_strategy_service.proto @@ -0,0 +1,130 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/bidding_strategy.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "BiddingStrategyServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Bidding Strategy service. + +// Service to manage bidding strategies. +service BiddingStrategyService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested bidding strategy in full detail. + rpc GetBiddingStrategy(GetBiddingStrategyRequest) returns (google.ads.googleads.v3.resources.BiddingStrategy) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/biddingStrategies/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes bidding strategies. Operation statuses are + // returned. + rpc MutateBiddingStrategies(MutateBiddingStrategiesRequest) returns (MutateBiddingStrategiesResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/biddingStrategies:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [BiddingStrategyService.GetBiddingStrategy][google.ads.googleads.v3.services.BiddingStrategyService.GetBiddingStrategy]. +message GetBiddingStrategyRequest { + // Required. The resource name of the bidding strategy to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/BiddingStrategy" + } + ]; +} + +// Request message for [BiddingStrategyService.MutateBiddingStrategies][google.ads.googleads.v3.services.BiddingStrategyService.MutateBiddingStrategies]. +message MutateBiddingStrategiesRequest { + // Required. The ID of the customer whose bidding strategies are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual bidding strategies. + repeated BiddingStrategyOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update, remove) on a bidding strategy. +message BiddingStrategyOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new bidding + // strategy. + google.ads.googleads.v3.resources.BiddingStrategy create = 1; + + // Update operation: The bidding strategy is expected to have a valid + // resource name. + google.ads.googleads.v3.resources.BiddingStrategy update = 2; + + // Remove operation: A resource name for the removed bidding strategy is + // expected, in this format: + // + // `customers/{customer_id}/biddingStrategies/{bidding_strategy_id}` + string remove = 3; + } +} + +// Response message for bidding strategy mutate. +message MutateBiddingStrategiesResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateBiddingStrategyResult results = 2; +} + +// The result for the bidding strategy mutate. +message MutateBiddingStrategyResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/billing_setup_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/billing_setup_service.proto new file mode 100644 index 000000000..8a177e9b2 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/billing_setup_service.proto @@ -0,0 +1,115 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/billing_setup.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "BillingSetupServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the BillingSetup service. + +// A service for designating the business entity responsible for accrued costs. +// +// A billing setup is associated with a payments account. Billing-related +// activity for all billing setups associated with a particular payments account +// will appear on a single invoice generated monthly. +// +// Mutates: +// The REMOVE operation cancels a pending billing setup. +// The CREATE operation creates a new billing setup. +service BillingSetupService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns a billing setup. + rpc GetBillingSetup(GetBillingSetupRequest) returns (google.ads.googleads.v3.resources.BillingSetup) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/billingSetups/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates a billing setup, or cancels an existing billing setup. + rpc MutateBillingSetup(MutateBillingSetupRequest) returns (MutateBillingSetupResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/billingSetups:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operation"; + } +} + +// Request message for +// [BillingSetupService.GetBillingSetup][google.ads.googleads.v3.services.BillingSetupService.GetBillingSetup]. +message GetBillingSetupRequest { + // Required. The resource name of the billing setup to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/BillingSetup" + } + ]; +} + +// Request message for billing setup mutate operations. +message MutateBillingSetupRequest { + // Required. Id of the customer to apply the billing setup mutate operation to. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The operation to perform. + BillingSetupOperation operation = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// A single operation on a billing setup, which describes the cancellation of an +// existing billing setup. +message BillingSetupOperation { + // Only one of these operations can be set. "Update" operations are not + // supported. + oneof operation { + // Creates a billing setup. No resource name is expected for the new billing + // setup. + google.ads.googleads.v3.resources.BillingSetup create = 2; + + // Resource name of the billing setup to remove. A setup cannot be + // removed unless it is in a pending state or its scheduled start time is in + // the future. The resource name looks like + // `customers/{customer_id}/billingSetups/{billing_id}`. + string remove = 1; + } +} + +// Response message for a billing setup operation. +message MutateBillingSetupResponse { + // A result that identifies the resource affected by the mutate request. + MutateBillingSetupResult result = 1; +} + +// Result for a single billing setup mutate. +message MutateBillingSetupResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/campaign_audience_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/campaign_audience_view_service.proto new file mode 100644 index 000000000..0134cd2fa --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/campaign_audience_view_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/campaign_audience_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "CampaignAudienceViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Campaign Audience View service. + +// Service to manage campaign audience views. +service CampaignAudienceViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested campaign audience view in full detail. + rpc GetCampaignAudienceView(GetCampaignAudienceViewRequest) returns (google.ads.googleads.v3.resources.CampaignAudienceView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/campaignAudienceViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [CampaignAudienceViewService.GetCampaignAudienceView][google.ads.googleads.v3.services.CampaignAudienceViewService.GetCampaignAudienceView]. +message GetCampaignAudienceViewRequest { + // Required. The resource name of the campaign audience view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignAudienceView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/campaign_bid_modifier_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/campaign_bid_modifier_service.proto new file mode 100644 index 000000000..113107cc0 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/campaign_bid_modifier_service.proto @@ -0,0 +1,130 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/campaign_bid_modifier.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "CampaignBidModifierServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Campaign Bid Modifier service. + +// Service to manage campaign bid modifiers. +service CampaignBidModifierService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested campaign bid modifier in full detail. + rpc GetCampaignBidModifier(GetCampaignBidModifierRequest) returns (google.ads.googleads.v3.resources.CampaignBidModifier) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/campaignBidModifiers/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes campaign bid modifiers. + // Operation statuses are returned. + rpc MutateCampaignBidModifiers(MutateCampaignBidModifiersRequest) returns (MutateCampaignBidModifiersResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/campaignBidModifiers:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [CampaignBidModifierService.GetCampaignBidModifier][google.ads.googleads.v3.services.CampaignBidModifierService.GetCampaignBidModifier]. +message GetCampaignBidModifierRequest { + // Required. The resource name of the campaign bid modifier to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignBidModifier" + } + ]; +} + +// Request message for [CampaignBidModifierService.MutateCampaignBidModifier][]. +message MutateCampaignBidModifiersRequest { + // Required. ID of the customer whose campaign bid modifiers are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual campaign bid modifiers. + repeated CampaignBidModifierOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, remove, update) on a campaign bid modifier. +message CampaignBidModifierOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new campaign bid + // modifier. + google.ads.googleads.v3.resources.CampaignBidModifier create = 1; + + // Update operation: The campaign bid modifier is expected to have a valid + // resource name. + google.ads.googleads.v3.resources.CampaignBidModifier update = 2; + + // Remove operation: A resource name for the removed campaign bid modifier + // is expected, in this format: + // + // `customers/{customer_id}/CampaignBidModifiers/{campaign_id}~{criterion_id}` + string remove = 3; + } +} + +// Response message for campaign bid modifiers mutate. +message MutateCampaignBidModifiersResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateCampaignBidModifierResult results = 2; +} + +// The result for the criterion mutate. +message MutateCampaignBidModifierResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/campaign_budget_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/campaign_budget_service.proto new file mode 100644 index 000000000..95bf89291 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/campaign_budget_service.proto @@ -0,0 +1,129 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/campaign_budget.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "CampaignBudgetServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Campaign Budget service. + +// Service to manage campaign budgets. +service CampaignBudgetService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested Campaign Budget in full detail. + rpc GetCampaignBudget(GetCampaignBudgetRequest) returns (google.ads.googleads.v3.resources.CampaignBudget) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/campaignBudgets/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes campaign budgets. Operation statuses are + // returned. + rpc MutateCampaignBudgets(MutateCampaignBudgetsRequest) returns (MutateCampaignBudgetsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/campaignBudgets:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [CampaignBudgetService.GetCampaignBudget][google.ads.googleads.v3.services.CampaignBudgetService.GetCampaignBudget]. +message GetCampaignBudgetRequest { + // Required. The resource name of the campaign budget to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignBudget" + } + ]; +} + +// Request message for [CampaignBudgetService.MutateCampaignBudgets][google.ads.googleads.v3.services.CampaignBudgetService.MutateCampaignBudgets]. +message MutateCampaignBudgetsRequest { + // Required. The ID of the customer whose campaign budgets are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual campaign budgets. + repeated CampaignBudgetOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update, remove) on a campaign budget. +message CampaignBudgetOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new budget. + google.ads.googleads.v3.resources.CampaignBudget create = 1; + + // Update operation: The campaign budget is expected to have a valid + // resource name. + google.ads.googleads.v3.resources.CampaignBudget update = 2; + + // Remove operation: A resource name for the removed budget is expected, in + // this format: + // + // `customers/{customer_id}/campaignBudgets/{budget_id}` + string remove = 3; + } +} + +// Response message for campaign budget mutate. +message MutateCampaignBudgetsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateCampaignBudgetResult results = 2; +} + +// The result for the campaign budget mutate. +message MutateCampaignBudgetResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/campaign_criterion_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/campaign_criterion_service.proto new file mode 100644 index 000000000..678c83e71 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/campaign_criterion_service.proto @@ -0,0 +1,128 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/campaign_criterion.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "CampaignCriterionServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Campaign Criterion service. + +// Service to manage campaign criteria. +service CampaignCriterionService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested criterion in full detail. + rpc GetCampaignCriterion(GetCampaignCriterionRequest) returns (google.ads.googleads.v3.resources.CampaignCriterion) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/campaignCriteria/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes criteria. Operation statuses are returned. + rpc MutateCampaignCriteria(MutateCampaignCriteriaRequest) returns (MutateCampaignCriteriaResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/campaignCriteria:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [CampaignCriterionService.GetCampaignCriterion][google.ads.googleads.v3.services.CampaignCriterionService.GetCampaignCriterion]. +message GetCampaignCriterionRequest { + // Required. The resource name of the criterion to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignCriterion" + } + ]; +} + +// Request message for [CampaignCriterionService.MutateCampaignCriteria][google.ads.googleads.v3.services.CampaignCriterionService.MutateCampaignCriteria]. +message MutateCampaignCriteriaRequest { + // Required. The ID of the customer whose criteria are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual criteria. + repeated CampaignCriterionOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update, remove) on a campaign criterion. +message CampaignCriterionOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new criterion. + google.ads.googleads.v3.resources.CampaignCriterion create = 1; + + // Update operation: The criterion is expected to have a valid resource + // name. + google.ads.googleads.v3.resources.CampaignCriterion update = 2; + + // Remove operation: A resource name for the removed criterion is expected, + // in this format: + // + // `customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}` + string remove = 3; + } +} + +// Response message for campaign criterion mutate. +message MutateCampaignCriteriaResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateCampaignCriterionResult results = 2; +} + +// The result for the criterion mutate. +message MutateCampaignCriterionResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/campaign_criterion_simulation_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/campaign_criterion_simulation_service.proto new file mode 100644 index 000000000..c2261b0af --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/campaign_criterion_simulation_service.proto @@ -0,0 +1,59 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/campaign_criterion_simulation.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "CampaignCriterionSimulationServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the CampaignCriterionSimulation service. + +// Service to fetch campaign criterion simulations. +service CampaignCriterionSimulationService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested campaign criterion simulation in full detail. + rpc GetCampaignCriterionSimulation(GetCampaignCriterionSimulationRequest) returns (google.ads.googleads.v3.resources.CampaignCriterionSimulation) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/campaignCriterionSimulations/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for +// [CampaignCriterionSimulationService.GetCampaignCriterionSimulation][google.ads.googleads.v3.services.CampaignCriterionSimulationService.GetCampaignCriterionSimulation]. +message GetCampaignCriterionSimulationRequest { + // Required. The resource name of the campaign criterion simulation to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignCriterionSimulation" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/campaign_draft_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/campaign_draft_service.proto new file mode 100644 index 000000000..1be17bf22 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/campaign_draft_service.proto @@ -0,0 +1,202 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/campaign_draft.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/longrunning/operations.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "CampaignDraftServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Campaign Draft service. + +// Service to manage campaign drafts. +service CampaignDraftService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested campaign draft in full detail. + rpc GetCampaignDraft(GetCampaignDraftRequest) returns (google.ads.googleads.v3.resources.CampaignDraft) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/campaignDrafts/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes campaign drafts. Operation statuses are + // returned. + rpc MutateCampaignDrafts(MutateCampaignDraftsRequest) returns (MutateCampaignDraftsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/campaignDrafts:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } + + // Promotes the changes in a draft back to the base campaign. + // + // This method returns a Long Running Operation (LRO) indicating if the + // Promote is done. Use [Operations.GetOperation] to poll the LRO until it + // is done. Only a done status is returned in the response. See the status + // in the Campaign Draft resource to determine if the promotion was + // successful. If the LRO failed, use + // [CampaignDraftService.ListCampaignDraftAsyncErrors][google.ads.googleads.v3.services.CampaignDraftService.ListCampaignDraftAsyncErrors] to view the list of + // error reasons. + rpc PromoteCampaignDraft(PromoteCampaignDraftRequest) returns (google.longrunning.Operation) { + option (google.api.http) = { + post: "/v3/{campaign_draft=customers/*/campaignDrafts/*}:promote" + body: "*" + }; + option (google.api.method_signature) = "campaign_draft"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "google.protobuf.Empty" + }; + } + + // Returns all errors that occurred during CampaignDraft promote. Throws an + // error if called before campaign draft is promoted. + // Supports standard list paging. + rpc ListCampaignDraftAsyncErrors(ListCampaignDraftAsyncErrorsRequest) returns (ListCampaignDraftAsyncErrorsResponse) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/campaignDrafts/*}:listAsyncErrors" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [CampaignDraftService.GetCampaignDraft][google.ads.googleads.v3.services.CampaignDraftService.GetCampaignDraft]. +message GetCampaignDraftRequest { + // Required. The resource name of the campaign draft to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignDraft" + } + ]; +} + +// Request message for [CampaignDraftService.MutateCampaignDrafts][google.ads.googleads.v3.services.CampaignDraftService.MutateCampaignDrafts]. +message MutateCampaignDraftsRequest { + // Required. The ID of the customer whose campaign drafts are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual campaign drafts. + repeated CampaignDraftOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// Request message for [CampaignDraftService.PromoteCampaignDraft][google.ads.googleads.v3.services.CampaignDraftService.PromoteCampaignDraft]. +message PromoteCampaignDraftRequest { + // Required. The resource name of the campaign draft to promote. + string campaign_draft = 1 [(google.api.field_behavior) = REQUIRED]; +} + +// A single operation (create, update, remove) on a campaign draft. +message CampaignDraftOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new campaign + // draft. + google.ads.googleads.v3.resources.CampaignDraft create = 1; + + // Update operation: The campaign draft is expected to have a valid + // resource name. + google.ads.googleads.v3.resources.CampaignDraft update = 2; + + // Remove operation: The campaign draft is expected to have a valid + // resource name, in this format: + // + // `customers/{customer_id}/campaignDrafts/{base_campaign_id}~{draft_id}` + string remove = 3; + } +} + +// Response message for campaign draft mutate. +message MutateCampaignDraftsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateCampaignDraftResult results = 2; +} + +// The result for the campaign draft mutate. +message MutateCampaignDraftResult { + // Returned for successful operations. + string resource_name = 1; +} + +// Request message for [CampaignDraftService.ListCampaignDraftAsyncErrors][google.ads.googleads.v3.services.CampaignDraftService.ListCampaignDraftAsyncErrors]. +message ListCampaignDraftAsyncErrorsRequest { + // Required. The name of the campaign draft from which to retrieve the async errors. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignDraft" + } + ]; + + // Token of the page to retrieve. If not specified, the first + // page of results will be returned. Use the value obtained from + // `next_page_token` in the previous response in order to request + // the next page of results. + string page_token = 2; + + // Number of elements to retrieve in a single page. + // When a page request is too large, the server may decide to + // further limit the number of returned resources. + int32 page_size = 3; +} + +// Response message for [CampaignDraftService.ListCampaignDraftAsyncErrors][google.ads.googleads.v3.services.CampaignDraftService.ListCampaignDraftAsyncErrors]. +message ListCampaignDraftAsyncErrorsResponse { + // Details of the errors when performing the asynchronous operation. + repeated google.rpc.Status errors = 1; + + // Pagination token used to retrieve the next page of results. + // Pass the content of this string as the `page_token` attribute of + // the next request. `next_page_token` is not returned for the last + // page. + string next_page_token = 2; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/campaign_experiment_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/campaign_experiment_service.proto new file mode 100644 index 000000000..1f80bda6d --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/campaign_experiment_service.proto @@ -0,0 +1,293 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/campaign_experiment.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/longrunning/operations.proto"; +import "google/protobuf/empty.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "CampaignExperimentServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Campaign Experiment service. + +// CampaignExperimentService manages the life cycle of campaign experiments. +// It is used to create new experiments from drafts, modify experiment +// properties, promote changes in an experiment back to its base campaign, +// graduate experiments into new stand-alone campaigns, and to remove an +// experiment. +// +// An experiment consists of two variants or arms - the base campaign and the +// experiment campaign, directing a fixed share of traffic to each arm. +// A campaign experiment is created from a draft of changes to the base campaign +// and will be a snapshot of changes in the draft at the time of creation. +service CampaignExperimentService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested campaign experiment in full detail. + rpc GetCampaignExperiment(GetCampaignExperimentRequest) returns (google.ads.googleads.v3.resources.CampaignExperiment) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/campaignExperiments/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates a campaign experiment based on a campaign draft. The draft campaign + // will be forked into a real campaign (called the experiment campaign) that + // will begin serving ads if successfully created. + // + // The campaign experiment is created immediately with status INITIALIZING. + // This method return a long running operation that tracks the forking of the + // draft campaign. If the forking fails, a list of errors can be retrieved + // using the ListCampaignExperimentAsyncErrors method. The operation's + // metadata will be a StringValue containing the resource name of the created + // campaign experiment. + rpc CreateCampaignExperiment(CreateCampaignExperimentRequest) returns (google.longrunning.Operation) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/campaignExperiments:create" + body: "*" + }; + option (google.api.method_signature) = "customer_id,campaign_experiment"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "google.ads.googleads.v3.services.CreateCampaignExperimentMetadata" + }; + } + + // Updates campaign experiments. Operation statuses are returned. + rpc MutateCampaignExperiments(MutateCampaignExperimentsRequest) returns (MutateCampaignExperimentsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/campaignExperiments:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } + + // Graduates a campaign experiment to a full campaign. The base and experiment + // campaigns will start running independently with their own budgets. + rpc GraduateCampaignExperiment(GraduateCampaignExperimentRequest) returns (GraduateCampaignExperimentResponse) { + option (google.api.http) = { + post: "/v3/{campaign_experiment=customers/*/campaignExperiments/*}:graduate" + body: "*" + }; + option (google.api.method_signature) = "campaign_experiment,campaign_budget"; + } + + // Promotes the changes in a experiment campaign back to the base campaign. + // + // The campaign experiment is updated immediately with status PROMOTING. + // This method return a long running operation that tracks the promoting of + // the experiment campaign. If the promoting fails, a list of errors can be + // retrieved using the ListCampaignExperimentAsyncErrors method. + rpc PromoteCampaignExperiment(PromoteCampaignExperimentRequest) returns (google.longrunning.Operation) { + option (google.api.http) = { + post: "/v3/{campaign_experiment=customers/*/campaignExperiments/*}:promote" + body: "*" + }; + option (google.api.method_signature) = "campaign_experiment"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "google.protobuf.Empty" + }; + } + + // Immediately ends a campaign experiment, changing the experiment's scheduled + // end date and without waiting for end of day. End date is updated to be the + // time of the request. + rpc EndCampaignExperiment(EndCampaignExperimentRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + post: "/v3/{campaign_experiment=customers/*/campaignExperiments/*}:end" + body: "*" + }; + option (google.api.method_signature) = "campaign_experiment"; + } + + // Returns all errors that occurred during CampaignExperiment create or + // promote (whichever occurred last). + // Supports standard list paging. + rpc ListCampaignExperimentAsyncErrors(ListCampaignExperimentAsyncErrorsRequest) returns (ListCampaignExperimentAsyncErrorsResponse) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/campaignExperiments/*}:listAsyncErrors" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [CampaignExperimentService.GetCampaignExperiment][google.ads.googleads.v3.services.CampaignExperimentService.GetCampaignExperiment]. +message GetCampaignExperimentRequest { + // Required. The resource name of the campaign experiment to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignExperiment" + } + ]; +} + +// Request message for [CampaignExperimentService.MutateCampaignExperiments][google.ads.googleads.v3.services.CampaignExperimentService.MutateCampaignExperiments]. +message MutateCampaignExperimentsRequest { + // Required. The ID of the customer whose campaign experiments are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual campaign experiments. + repeated CampaignExperimentOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single update operation on a campaign experiment. +message CampaignExperimentOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 3; + + // The mutate operation. + oneof operation { + // Update operation: The campaign experiment is expected to have a valid + // resource name. + google.ads.googleads.v3.resources.CampaignExperiment update = 1; + + // Remove operation: The campaign experiment is expected to have a valid + // resource name, in this format: + // + // `customers/{customer_id}/campaignExperiments/{campaign_experiment_id}` + string remove = 2; + } +} + +// Response message for campaign experiment mutate. +message MutateCampaignExperimentsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateCampaignExperimentResult results = 2; +} + +// The result for the campaign experiment mutate. +message MutateCampaignExperimentResult { + // Returned for successful operations. + string resource_name = 1; +} + +// Request message for [CampaignExperimentService.CreateCampaignExperiment][google.ads.googleads.v3.services.CampaignExperimentService.CreateCampaignExperiment]. +message CreateCampaignExperimentRequest { + // Required. The ID of the customer whose campaign experiment is being created. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The campaign experiment to be created. + google.ads.googleads.v3.resources.CampaignExperiment campaign_experiment = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 3; +} + +// Message used as metadata returned in Long Running Operations for +// CreateCampaignExperimentRequest +message CreateCampaignExperimentMetadata { + // Resource name of campaign experiment created. + string campaign_experiment = 1; +} + +// Request message for [CampaignExperimentService.GraduateCampaignExperiment][google.ads.googleads.v3.services.CampaignExperimentService.GraduateCampaignExperiment]. +message GraduateCampaignExperimentRequest { + // Required. The resource name of the campaign experiment to graduate. + string campaign_experiment = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. Resource name of the budget to attach to the campaign graduated from the + // experiment. + string campaign_budget = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// Response message for campaign experiment graduate. +message GraduateCampaignExperimentResponse { + // The resource name of the campaign from the graduated experiment. + // This campaign is the same one as CampaignExperiment.experiment_campaign. + string graduated_campaign = 1; +} + +// Request message for [CampaignExperimentService.PromoteCampaignExperiment][google.ads.googleads.v3.services.CampaignExperimentService.PromoteCampaignExperiment]. +message PromoteCampaignExperimentRequest { + // Required. The resource name of the campaign experiment to promote. + string campaign_experiment = 1 [(google.api.field_behavior) = REQUIRED]; +} + +// Request message for [CampaignExperimentService.EndCampaignExperiment][google.ads.googleads.v3.services.CampaignExperimentService.EndCampaignExperiment]. +message EndCampaignExperimentRequest { + // Required. The resource name of the campaign experiment to end. + string campaign_experiment = 1 [(google.api.field_behavior) = REQUIRED]; +} + +// Request message for +// [CampaignExperimentService.ListCampaignExperimentAsyncErrors][google.ads.googleads.v3.services.CampaignExperimentService.ListCampaignExperimentAsyncErrors]. +message ListCampaignExperimentAsyncErrorsRequest { + // Required. The name of the campaign experiment from which to retrieve the async + // errors. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignExperiment" + } + ]; + + // Token of the page to retrieve. If not specified, the first + // page of results will be returned. Use the value obtained from + // `next_page_token` in the previous response in order to request + // the next page of results. + string page_token = 2; + + // Number of elements to retrieve in a single page. + // When a page request is too large, the server may decide to + // further limit the number of returned resources. + int32 page_size = 3; +} + +// Response message for +// [CampaignExperimentService.ListCampaignExperimentAsyncErrors][google.ads.googleads.v3.services.CampaignExperimentService.ListCampaignExperimentAsyncErrors]. +message ListCampaignExperimentAsyncErrorsResponse { + // Details of the errors when performing the asynchronous operation. + repeated google.rpc.Status errors = 1; + + // Pagination token used to retrieve the next page of results. + // Pass the content of this string as the `page_token` attribute of + // the next request. `next_page_token` is not returned for the last + // page. + string next_page_token = 2; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/campaign_extension_setting_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/campaign_extension_setting_service.proto new file mode 100644 index 000000000..2c2af123e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/campaign_extension_setting_service.proto @@ -0,0 +1,134 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/campaign_extension_setting.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "CampaignExtensionSettingServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the CampaignExtensionSetting service. + +// Service to manage campaign extension settings. +service CampaignExtensionSettingService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested campaign extension setting in full detail. + rpc GetCampaignExtensionSetting(GetCampaignExtensionSettingRequest) returns (google.ads.googleads.v3.resources.CampaignExtensionSetting) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/campaignExtensionSettings/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes campaign extension settings. Operation + // statuses are returned. + rpc MutateCampaignExtensionSettings(MutateCampaignExtensionSettingsRequest) returns (MutateCampaignExtensionSettingsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/campaignExtensionSettings:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for +// [CampaignExtensionSettingService.GetCampaignExtensionSetting][google.ads.googleads.v3.services.CampaignExtensionSettingService.GetCampaignExtensionSetting]. +message GetCampaignExtensionSettingRequest { + // Required. The resource name of the campaign extension setting to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignExtensionSetting" + } + ]; +} + +// Request message for +// [CampaignExtensionSettingService.MutateCampaignExtensionSettings][google.ads.googleads.v3.services.CampaignExtensionSettingService.MutateCampaignExtensionSettings]. +message MutateCampaignExtensionSettingsRequest { + // Required. The ID of the customer whose campaign extension settings are being + // modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual campaign extension + // settings. + repeated CampaignExtensionSettingOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update, remove) on a campaign extension setting. +message CampaignExtensionSettingOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new campaign + // extension setting. + google.ads.googleads.v3.resources.CampaignExtensionSetting create = 1; + + // Update operation: The campaign extension setting is expected to have a + // valid resource name. + google.ads.googleads.v3.resources.CampaignExtensionSetting update = 2; + + // Remove operation: A resource name for the removed campaign extension + // setting is expected, in this format: + // + // `customers/{customer_id}/campaignExtensionSettings/{campaign_id}~{extension_type}` + string remove = 3; + } +} + +// Response message for a campaign extension setting mutate. +message MutateCampaignExtensionSettingsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateCampaignExtensionSettingResult results = 2; +} + +// The result for the campaign extension setting mutate. +message MutateCampaignExtensionSettingResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/campaign_feed_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/campaign_feed_service.proto new file mode 100644 index 000000000..e8a9d8d58 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/campaign_feed_service.proto @@ -0,0 +1,129 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/campaign_feed.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "CampaignFeedServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the CampaignFeed service. + +// Service to manage campaign feeds. +service CampaignFeedService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested campaign feed in full detail. + rpc GetCampaignFeed(GetCampaignFeedRequest) returns (google.ads.googleads.v3.resources.CampaignFeed) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/campaignFeeds/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes campaign feeds. Operation statuses are + // returned. + rpc MutateCampaignFeeds(MutateCampaignFeedsRequest) returns (MutateCampaignFeedsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/campaignFeeds:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [CampaignFeedService.GetCampaignFeed][google.ads.googleads.v3.services.CampaignFeedService.GetCampaignFeed]. +message GetCampaignFeedRequest { + // Required. The resource name of the campaign feed to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignFeed" + } + ]; +} + +// Request message for [CampaignFeedService.MutateCampaignFeeds][google.ads.googleads.v3.services.CampaignFeedService.MutateCampaignFeeds]. +message MutateCampaignFeedsRequest { + // Required. The ID of the customer whose campaign feeds are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual campaign feeds. + repeated CampaignFeedOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update, remove) on a campaign feed. +message CampaignFeedOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new campaign feed. + google.ads.googleads.v3.resources.CampaignFeed create = 1; + + // Update operation: The campaign feed is expected to have a valid resource + // name. + google.ads.googleads.v3.resources.CampaignFeed update = 2; + + // Remove operation: A resource name for the removed campaign feed is + // expected, in this format: + // + // `customers/{customer_id}/campaignFeeds/{campaign_id}~{feed_id}` + string remove = 3; + } +} + +// Response message for a campaign feed mutate. +message MutateCampaignFeedsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateCampaignFeedResult results = 2; +} + +// The result for the campaign feed mutate. +message MutateCampaignFeedResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/campaign_label_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/campaign_label_service.proto new file mode 100644 index 000000000..eaabcd07a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/campaign_label_service.proto @@ -0,0 +1,122 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/campaign_label.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "CampaignLabelServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Campaign Label service. + +// Service to manage labels on campaigns. +service CampaignLabelService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested campaign-label relationship in full detail. + rpc GetCampaignLabel(GetCampaignLabelRequest) returns (google.ads.googleads.v3.resources.CampaignLabel) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/campaignLabels/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates and removes campaign-label relationships. + // Operation statuses are returned. + rpc MutateCampaignLabels(MutateCampaignLabelsRequest) returns (MutateCampaignLabelsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/campaignLabels:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [CampaignLabelService.GetCampaignLabel][google.ads.googleads.v3.services.CampaignLabelService.GetCampaignLabel]. +message GetCampaignLabelRequest { + // Required. The resource name of the campaign-label relationship to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignLabel" + } + ]; +} + +// Request message for [CampaignLabelService.MutateCampaignLabels][google.ads.googleads.v3.services.CampaignLabelService.MutateCampaignLabels]. +message MutateCampaignLabelsRequest { + // Required. ID of the customer whose campaign-label relationships are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on campaign-label relationships. + repeated CampaignLabelOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, remove) on a campaign-label relationship. +message CampaignLabelOperation { + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new campaign-label + // relationship. + google.ads.googleads.v3.resources.CampaignLabel create = 1; + + // Remove operation: A resource name for the campaign-label relationship + // being removed, in this format: + // + // `customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}` + string remove = 2; + } +} + +// Response message for a campaign labels mutate. +message MutateCampaignLabelsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateCampaignLabelResult results = 2; +} + +// The result for a campaign label mutate. +message MutateCampaignLabelResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/campaign_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/campaign_service.proto new file mode 100644 index 000000000..b89d06fc9 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/campaign_service.proto @@ -0,0 +1,128 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/campaign.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "CampaignServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Campaign service. + +// Service to manage campaigns. +service CampaignService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested campaign in full detail. + rpc GetCampaign(GetCampaignRequest) returns (google.ads.googleads.v3.resources.Campaign) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/campaigns/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes campaigns. Operation statuses are returned. + rpc MutateCampaigns(MutateCampaignsRequest) returns (MutateCampaignsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/campaigns:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [CampaignService.GetCampaign][google.ads.googleads.v3.services.CampaignService.GetCampaign]. +message GetCampaignRequest { + // Required. The resource name of the campaign to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Campaign" + } + ]; +} + +// Request message for [CampaignService.MutateCampaigns][google.ads.googleads.v3.services.CampaignService.MutateCampaigns]. +message MutateCampaignsRequest { + // Required. The ID of the customer whose campaigns are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual campaigns. + repeated CampaignOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update, remove) on a campaign. +message CampaignOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new campaign. + google.ads.googleads.v3.resources.Campaign create = 1; + + // Update operation: The campaign is expected to have a valid + // resource name. + google.ads.googleads.v3.resources.Campaign update = 2; + + // Remove operation: A resource name for the removed campaign is + // expected, in this format: + // + // `customers/{customer_id}/campaigns/{campaign_id}` + string remove = 3; + } +} + +// Response message for campaign mutate. +message MutateCampaignsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateCampaignResult results = 2; +} + +// The result for the campaign mutate. +message MutateCampaignResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/campaign_shared_set_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/campaign_shared_set_service.proto new file mode 100644 index 000000000..9169a74f5 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/campaign_shared_set_service.proto @@ -0,0 +1,121 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/campaign_shared_set.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "CampaignSharedSetServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Campaign Shared Set service. + +// Service to manage campaign shared sets. +service CampaignSharedSetService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested campaign shared set in full detail. + rpc GetCampaignSharedSet(GetCampaignSharedSetRequest) returns (google.ads.googleads.v3.resources.CampaignSharedSet) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/campaignSharedSets/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates or removes campaign shared sets. Operation statuses are returned. + rpc MutateCampaignSharedSets(MutateCampaignSharedSetsRequest) returns (MutateCampaignSharedSetsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/campaignSharedSets:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [CampaignSharedSetService.GetCampaignSharedSet][google.ads.googleads.v3.services.CampaignSharedSetService.GetCampaignSharedSet]. +message GetCampaignSharedSetRequest { + // Required. The resource name of the campaign shared set to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CampaignSharedSet" + } + ]; +} + +// Request message for [CampaignSharedSetService.MutateCampaignSharedSets][google.ads.googleads.v3.services.CampaignSharedSetService.MutateCampaignSharedSets]. +message MutateCampaignSharedSetsRequest { + // Required. The ID of the customer whose campaign shared sets are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual campaign shared sets. + repeated CampaignSharedSetOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, remove) on an campaign shared set. +message CampaignSharedSetOperation { + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new campaign + // shared set. + google.ads.googleads.v3.resources.CampaignSharedSet create = 1; + + // Remove operation: A resource name for the removed campaign shared set is + // expected, in this format: + // + // `customers/{customer_id}/campaignSharedSets/{campaign_id}~{shared_set_id}` + string remove = 3; + } +} + +// Response message for a campaign shared set mutate. +message MutateCampaignSharedSetsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateCampaignSharedSetResult results = 2; +} + +// The result for the campaign shared set mutate. +message MutateCampaignSharedSetResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/carrier_constant_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/carrier_constant_service.proto new file mode 100644 index 000000000..9bc0b4c05 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/carrier_constant_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/carrier_constant.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "CarrierConstantServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the carrier constant service. + +// Service to fetch carrier constants. +service CarrierConstantService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested carrier constant in full detail. + rpc GetCarrierConstant(GetCarrierConstantRequest) returns (google.ads.googleads.v3.resources.CarrierConstant) { + option (google.api.http) = { + get: "/v3/{resource_name=carrierConstants/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [CarrierConstantService.GetCarrierConstant][google.ads.googleads.v3.services.CarrierConstantService.GetCarrierConstant]. +message GetCarrierConstantRequest { + // Required. Resource name of the carrier constant to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CarrierConstant" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/change_status_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/change_status_service.proto new file mode 100644 index 000000000..1f884296b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/change_status_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/change_status.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "ChangeStatusServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Change Status service. + +// Service to fetch change statuses. +service ChangeStatusService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested change status in full detail. + rpc GetChangeStatus(GetChangeStatusRequest) returns (google.ads.googleads.v3.resources.ChangeStatus) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/changeStatus/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for '[ChangeStatusService.GetChangeStatus][google.ads.googleads.v3.services.ChangeStatusService.GetChangeStatus]'. +message GetChangeStatusRequest { + // Required. The resource name of the change status to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ChangeStatus" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/click_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/click_view_service.proto new file mode 100644 index 000000000..d1ce74c91 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/click_view_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/click_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "ClickViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the ClickView service. + +// Service to fetch click views. +service ClickViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested click view in full detail. + rpc GetClickView(GetClickViewRequest) returns (google.ads.googleads.v3.resources.ClickView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/clickViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [ClickViewService.GetClickView][google.ads.googleads.v3.services.ClickViewService.GetClickView]. +message GetClickViewRequest { + // Required. The resource name of the click view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ClickView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/conversion_action_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/conversion_action_service.proto new file mode 100644 index 000000000..2b2d4ac34 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/conversion_action_service.proto @@ -0,0 +1,130 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/conversion_action.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "ConversionActionServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Conversion Action service. + +// Service to manage conversion actions. +service ConversionActionService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested conversion action. + rpc GetConversionAction(GetConversionActionRequest) returns (google.ads.googleads.v3.resources.ConversionAction) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/conversionActions/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates or removes conversion actions. Operation statuses are + // returned. + rpc MutateConversionActions(MutateConversionActionsRequest) returns (MutateConversionActionsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/conversionActions:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [ConversionActionService.GetConversionAction][google.ads.googleads.v3.services.ConversionActionService.GetConversionAction]. +message GetConversionActionRequest { + // Required. The resource name of the conversion action to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ConversionAction" + } + ]; +} + +// Request message for [ConversionActionService.MutateConversionActions][google.ads.googleads.v3.services.ConversionActionService.MutateConversionActions]. +message MutateConversionActionsRequest { + // Required. The ID of the customer whose conversion actions are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual conversion actions. + repeated ConversionActionOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update, remove) on a conversion action. +message ConversionActionOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new conversion + // action. + google.ads.googleads.v3.resources.ConversionAction create = 1; + + // Update operation: The conversion action is expected to have a valid + // resource name. + google.ads.googleads.v3.resources.ConversionAction update = 2; + + // Remove operation: A resource name for the removed conversion action is + // expected, in this format: + // + // `customers/{customer_id}/conversionActions/{conversion_action_id}` + string remove = 3; + } +} + +// Response message for [ConversionActionService.MutateConversionActions][google.ads.googleads.v3.services.ConversionActionService.MutateConversionActions]. +message MutateConversionActionsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateConversionActionResult results = 2; +} + +// The result for the conversion action mutate. +message MutateConversionActionResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/conversion_adjustment_upload_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/conversion_adjustment_upload_service.proto new file mode 100644 index 000000000..ddd1bfe5f --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/conversion_adjustment_upload_service.proto @@ -0,0 +1,167 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/enums/conversion_adjustment_type.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/protobuf/wrappers.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "ConversionAdjustmentUploadServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Service to upload conversion adjustments. +service ConversionAdjustmentUploadService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Processes the given conversion adjustments. + rpc UploadConversionAdjustments(UploadConversionAdjustmentsRequest) returns (UploadConversionAdjustmentsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}:uploadConversionAdjustments" + body: "*" + }; + option (google.api.method_signature) = "customer_id,conversion_adjustments,partial_failure"; + } +} + +// Request message for +// [ConversionAdjustmentUploadService.UploadConversionAdjustments][google.ads.googleads.v3.services.ConversionAdjustmentUploadService.UploadConversionAdjustments]. +message UploadConversionAdjustmentsRequest { + // Required. The ID of the customer performing the upload. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The conversion adjustments that are being uploaded. + repeated ConversionAdjustment conversion_adjustments = 2 [(google.api.field_behavior) = REQUIRED]; + + // Required. If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried out + // in one transaction if and only if they are all valid. This should always be + // set to true. + bool partial_failure = 3 [(google.api.field_behavior) = REQUIRED]; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// Response message for +// [ConversionAdjustmentUploadService.UploadConversionAdjustments][google.ads.googleads.v3.services.ConversionAdjustmentUploadService.UploadConversionAdjustments]. +message UploadConversionAdjustmentsResponse { + // Errors that pertain to conversion adjustment failures in the partial + // failure mode. Returned when all errors occur inside the adjustments. If any + // errors occur outside the adjustments (e.g. auth errors), we return an RPC + // level error. + google.rpc.Status partial_failure_error = 1; + + // Returned for successfully processed conversion adjustments. Proto will be + // empty for rows that received an error. Results are not returned when + // validate_only is true. + repeated ConversionAdjustmentResult results = 2; +} + +// A conversion adjustment. +message ConversionAdjustment { + // Resource name of the conversion action associated with this conversion + // adjustment. Note: Although this resource name consists of a customer id and + // a conversion action id, validation will ignore the customer id and use the + // conversion action id as the sole identifier of the conversion action. + google.protobuf.StringValue conversion_action = 3; + + // The date time at which the adjustment occurred. Must be after the + // conversion_date_time. The timezone must be specified. The format is + // "yyyy-mm-dd hh:mm:ss+|-hh:mm", e.g. "2019-01-01 12:32:45-08:00". + google.protobuf.StringValue adjustment_date_time = 4; + + // The adjustment type. + google.ads.googleads.v3.enums.ConversionAdjustmentTypeEnum.ConversionAdjustmentType adjustment_type = 5; + + // Information needed to restate the conversion's value. + // Required for restatements. Should not be supplied for retractions. An error + // will be returned if provided for a retraction. + RestatementValue restatement_value = 6; + + // Identifies the conversion to be adjusted. + oneof conversion_identifier { + // Uniquely identifies a conversion that was reported without an order ID + // specified. + GclidDateTimePair gclid_date_time_pair = 1; + + // The order ID of the conversion to be adjusted. If the conversion was + // reported with an order ID specified, that order ID must be used as the + // identifier here. + google.protobuf.StringValue order_id = 2; + } +} + +// Contains information needed to restate a conversion's value. +message RestatementValue { + // The restated conversion value. This is the value of the conversion after + // restatement. For example, to change the value of a conversion from 100 to + // 70, an adjusted value of 70 should be reported. + google.protobuf.DoubleValue adjusted_value = 1; + + // The currency of the restated value. If not provided, then the default + // currency from the conversion action is used, and if that is not set then + // the account currency is used. This is the ISO 4217 3-character currency + // code e.g. USD or EUR. + google.protobuf.StringValue currency_code = 2; +} + +// Uniquely identifies a conversion that was reported without an order ID +// specified. +message GclidDateTimePair { + // Google click ID (gclid) associated with the original conversion for this + // adjustment. + google.protobuf.StringValue gclid = 1; + + // The date time at which the original conversion for this adjustment + // occurred. The timezone must be specified. The format is "yyyy-mm-dd + // hh:mm:ss+|-hh:mm", e.g. "2019-01-01 12:32:45-08:00". + google.protobuf.StringValue conversion_date_time = 2; +} + +// Information identifying a successfully processed ConversionAdjustment. +message ConversionAdjustmentResult { + // Resource name of the conversion action associated with this conversion + // adjustment. + google.protobuf.StringValue conversion_action = 3; + + // The date time at which the adjustment occurred. The format is + // "yyyy-mm-dd hh:mm:ss+|-hh:mm", e.g. "2019-01-01 12:32:45-08:00". + google.protobuf.StringValue adjustment_date_time = 4; + + // The adjustment type. + google.ads.googleads.v3.enums.ConversionAdjustmentTypeEnum.ConversionAdjustmentType adjustment_type = 5; + + // Identifies the conversion that was adjusted. + oneof conversion_identifier { + // Uniquely identifies a conversion that was reported without an order ID + // specified. + GclidDateTimePair gclid_date_time_pair = 1; + + // The order ID of the conversion that was adjusted. + google.protobuf.StringValue order_id = 2; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/conversion_upload_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/conversion_upload_service.proto new file mode 100644 index 000000000..0ca815bfa --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/conversion_upload_service.proto @@ -0,0 +1,223 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/protobuf/wrappers.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "ConversionUploadServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Service to upload conversions. +service ConversionUploadService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Processes the given click conversions. + rpc UploadClickConversions(UploadClickConversionsRequest) returns (UploadClickConversionsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}:uploadClickConversions" + body: "*" + }; + option (google.api.method_signature) = "customer_id,conversions,partial_failure"; + } + + // Processes the given call conversions. + rpc UploadCallConversions(UploadCallConversionsRequest) returns (UploadCallConversionsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}:uploadCallConversions" + body: "*" + }; + option (google.api.method_signature) = "customer_id,conversions,partial_failure"; + } +} + +// Request message for [ConversionUploadService.UploadClickConversions][google.ads.googleads.v3.services.ConversionUploadService.UploadClickConversions]. +message UploadClickConversionsRequest { + // Required. The ID of the customer performing the upload. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The conversions that are being uploaded. + repeated ClickConversion conversions = 2 [(google.api.field_behavior) = REQUIRED]; + + // Required. If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // This should always be set to true. + bool partial_failure = 3 [(google.api.field_behavior) = REQUIRED]; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// Response message for [ConversionUploadService.UploadClickConversions][google.ads.googleads.v3.services.ConversionUploadService.UploadClickConversions]. +message UploadClickConversionsResponse { + // Errors that pertain to conversion failures in the partial failure mode. + // Returned when all errors occur inside the conversions. If any errors occur + // outside the conversions (e.g. auth errors), we return an RPC level error. + google.rpc.Status partial_failure_error = 1; + + // Returned for successfully processed conversions. Proto will be empty for + // rows that received an error. Results are not returned when validate_only is + // true. + repeated ClickConversionResult results = 2; +} + +// Request message for [ConversionUploadService.UploadCallConversions][google.ads.googleads.v3.services.ConversionUploadService.UploadCallConversions]. +message UploadCallConversionsRequest { + // Required. The ID of the customer performing the upload. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The conversions that are being uploaded. + repeated CallConversion conversions = 2 [(google.api.field_behavior) = REQUIRED]; + + // Required. If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // This should always be set to true. + bool partial_failure = 3 [(google.api.field_behavior) = REQUIRED]; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// Response message for [ConversionUploadService.UploadCallConversions][google.ads.googleads.v3.services.ConversionUploadService.UploadCallConversions]. +message UploadCallConversionsResponse { + // Errors that pertain to conversion failures in the partial failure mode. + // Returned when all errors occur inside the conversions. If any errors occur + // outside the conversions (e.g. auth errors), we return an RPC level error. + google.rpc.Status partial_failure_error = 1; + + // Returned for successfully processed conversions. Proto will be empty for + // rows that received an error. Results are not returned when validate_only is + // true. + repeated CallConversionResult results = 2; +} + +// A click conversion. +message ClickConversion { + // The Google click ID (gclid) associated with this conversion. + google.protobuf.StringValue gclid = 1; + + // Resource name of the conversion action associated with this conversion. + // Note: Although this resource name consists of a customer id and a + // conversion action id, validation will ignore the customer id and use the + // conversion action id as the sole identifier of the conversion action. + google.protobuf.StringValue conversion_action = 2; + + // The date time at which the conversion occurred. Must be after + // the click time. The timezone must be specified. The format is + // "yyyy-mm-dd hh:mm:ss+|-hh:mm", e.g. “2019-01-01 12:32:45-08:00”. + google.protobuf.StringValue conversion_date_time = 3; + + // The value of the conversion for the advertiser. + google.protobuf.DoubleValue conversion_value = 4; + + // Currency associated with the conversion value. This is the ISO 4217 + // 3-character currency code. For example: USD, EUR. + google.protobuf.StringValue currency_code = 5; + + // The order ID associated with the conversion. An order id can only be used + // for one conversion per conversion action. + google.protobuf.StringValue order_id = 6; + + // Additional data about externally attributed conversions. This field + // is required for conversions with an externally attributed conversion + // action, but should not be set otherwise. + ExternalAttributionData external_attribution_data = 7; +} + +// A call conversion. +message CallConversion { + // The caller id from which this call was placed. Caller id is expected to be + // in E.164 format with preceding '+' sign. e.g. "+16502531234". + google.protobuf.StringValue caller_id = 1; + + // The date time at which the call occurred. The timezone must be specified. + // The format is "yyyy-mm-dd hh:mm:ss+|-hh:mm", + // e.g. "2019-01-01 12:32:45-08:00". + google.protobuf.StringValue call_start_date_time = 2; + + // Resource name of the conversion action associated with this conversion. + // Note: Although this resource name consists of a customer id and a + // conversion action id, validation will ignore the customer id and use the + // conversion action id as the sole identifier of the conversion action. + google.protobuf.StringValue conversion_action = 3; + + // The date time at which the conversion occurred. Must be after the call + // time. The timezone must be specified. The format is + // "yyyy-mm-dd hh:mm:ss+|-hh:mm", e.g. "2019-01-01 12:32:45-08:00". + google.protobuf.StringValue conversion_date_time = 4; + + // The value of the conversion for the advertiser. + google.protobuf.DoubleValue conversion_value = 5; + + // Currency associated with the conversion value. This is the ISO 4217 + // 3-character currency code. For example: USD, EUR. + google.protobuf.StringValue currency_code = 6; +} + +// Contains additional information about externally attributed conversions. +message ExternalAttributionData { + // Represents the fraction of the conversion that is attributed to the + // Google Ads click. + google.protobuf.DoubleValue external_attribution_credit = 1; + + // Specifies the attribution model name. + google.protobuf.StringValue external_attribution_model = 2; +} + +// Identifying information for a successfully processed ClickConversion. +message ClickConversionResult { + // The Google Click ID (gclid) associated with this conversion. + google.protobuf.StringValue gclid = 1; + + // Resource name of the conversion action associated with this conversion. + google.protobuf.StringValue conversion_action = 2; + + // The date time at which the conversion occurred. The format is + // "yyyy-mm-dd hh:mm:ss+|-hh:mm", e.g. “2019-01-01 12:32:45-08:00”. + google.protobuf.StringValue conversion_date_time = 3; +} + +// Identifying information for a successfully processed CallConversionUpload. +message CallConversionResult { + // The caller id from which this call was placed. Caller id is expected to be + // in E.164 format with preceding '+' sign. + google.protobuf.StringValue caller_id = 1; + + // The date time at which the call occurred. The format is + // "yyyy-mm-dd hh:mm:ss+|-hh:mm", e.g. "2019-01-01 12:32:45-08:00". + google.protobuf.StringValue call_start_date_time = 2; + + // Resource name of the conversion action associated with this conversion. + google.protobuf.StringValue conversion_action = 3; + + // The date time at which the conversion occurred. The format is + // "yyyy-mm-dd hh:mm:ss+|-hh:mm", e.g. "2019-01-01 12:32:45-08:00". + google.protobuf.StringValue conversion_date_time = 4; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/currency_constant_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/currency_constant_service.proto new file mode 100644 index 000000000..a9c788ff3 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/currency_constant_service.proto @@ -0,0 +1,56 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/currency_constant.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "CurrencyConstantServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Service to fetch currency constants. +service CurrencyConstantService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested currency constant. + rpc GetCurrencyConstant(GetCurrencyConstantRequest) returns (google.ads.googleads.v3.resources.CurrencyConstant) { + option (google.api.http) = { + get: "/v3/{resource_name=currencyConstants/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [CurrencyConstantService.GetCurrencyConstant][google.ads.googleads.v3.services.CurrencyConstantService.GetCurrencyConstant]. +message GetCurrencyConstantRequest { + // Required. Resource name of the currency constant to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CurrencyConstant" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/custom_interest_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/custom_interest_service.proto new file mode 100644 index 000000000..4be702b05 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/custom_interest_service.proto @@ -0,0 +1,110 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/custom_interest.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "CustomInterestServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Custom Interest service. + +// Service to manage custom interests. +service CustomInterestService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested custom interest in full detail. + rpc GetCustomInterest(GetCustomInterestRequest) returns (google.ads.googleads.v3.resources.CustomInterest) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/customInterests/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates or updates custom interests. Operation statuses are returned. + rpc MutateCustomInterests(MutateCustomInterestsRequest) returns (MutateCustomInterestsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/customInterests:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [CustomInterestService.GetCustomInterest][google.ads.googleads.v3.services.CustomInterestService.GetCustomInterest]. +message GetCustomInterestRequest { + // Required. The resource name of the custom interest to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomInterest" + } + ]; +} + +// Request message for [CustomInterestService.MutateCustomInterests][google.ads.googleads.v3.services.CustomInterestService.MutateCustomInterests]. +message MutateCustomInterestsRequest { + // Required. The ID of the customer whose custom interests are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual custom interests. + repeated CustomInterestOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update) on a custom interest. +message CustomInterestOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new custom + // interest. + google.ads.googleads.v3.resources.CustomInterest create = 1; + + // Update operation: The custom interest is expected to have a valid + // resource name. + google.ads.googleads.v3.resources.CustomInterest update = 2; + } +} + +// Response message for custom interest mutate. +message MutateCustomInterestsResponse { + // All results for the mutate. + repeated MutateCustomInterestResult results = 2; +} + +// The result for the custom interest mutate. +message MutateCustomInterestResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/customer_client_link_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/customer_client_link_service.proto new file mode 100644 index 000000000..ab1d1a3b8 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/customer_client_link_service.proto @@ -0,0 +1,102 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/customer_client_link.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "CustomerClientLinkServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Service to manage customer client links. +service CustomerClientLinkService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested CustomerClientLink in full detail. + rpc GetCustomerClientLink(GetCustomerClientLinkRequest) returns (google.ads.googleads.v3.resources.CustomerClientLink) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/customerClientLinks/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates or updates a customer client link. Operation statuses are returned. + rpc MutateCustomerClientLink(MutateCustomerClientLinkRequest) returns (MutateCustomerClientLinkResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/customerClientLinks:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operation"; + } +} + +// Request message for [CustomerClientLinkService.GetCustomerClientLink][google.ads.googleads.v3.services.CustomerClientLinkService.GetCustomerClientLink]. +message GetCustomerClientLinkRequest { + // Required. The resource name of the customer client link to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerClientLink" + } + ]; +} + +// Request message for [CustomerClientLinkService.MutateCustomerClientLink][google.ads.googleads.v3.services.CustomerClientLinkService.MutateCustomerClientLink]. +message MutateCustomerClientLinkRequest { + // Required. The ID of the customer whose customer link are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The operation to perform on the individual CustomerClientLink. + CustomerClientLinkOperation operation = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// A single operation (create, update) on a CustomerClientLink. +message CustomerClientLinkOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new link. + google.ads.googleads.v3.resources.CustomerClientLink create = 1; + + // Update operation: The link is expected to have a valid resource name. + google.ads.googleads.v3.resources.CustomerClientLink update = 2; + } +} + +// Response message for a CustomerClientLink mutate. +message MutateCustomerClientLinkResponse { + // A result that identifies the resource affected by the mutate request. + MutateCustomerClientLinkResult result = 1; +} + +// The result for a single customer client link mutate. +message MutateCustomerClientLinkResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/customer_client_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/customer_client_service.proto new file mode 100644 index 000000000..d61eb7e83 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/customer_client_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/customer_client.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "CustomerClientServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Customer Client service. + +// Service to get clients in a customer's hierarchy. +service CustomerClientService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested client in full detail. + rpc GetCustomerClient(GetCustomerClientRequest) returns (google.ads.googleads.v3.resources.CustomerClient) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/customerClients/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [CustomerClientService.GetCustomerClient][google.ads.googleads.v3.services.CustomerClientService.GetCustomerClient]. +message GetCustomerClientRequest { + // Required. The resource name of the client to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerClient" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/customer_extension_setting_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/customer_extension_setting_service.proto new file mode 100644 index 000000000..4eedadbfd --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/customer_extension_setting_service.proto @@ -0,0 +1,134 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/customer_extension_setting.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "CustomerExtensionSettingServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the CustomerExtensionSetting service. + +// Service to manage customer extension settings. +service CustomerExtensionSettingService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested customer extension setting in full detail. + rpc GetCustomerExtensionSetting(GetCustomerExtensionSettingRequest) returns (google.ads.googleads.v3.resources.CustomerExtensionSetting) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/customerExtensionSettings/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes customer extension settings. Operation + // statuses are returned. + rpc MutateCustomerExtensionSettings(MutateCustomerExtensionSettingsRequest) returns (MutateCustomerExtensionSettingsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/customerExtensionSettings:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for +// [CustomerExtensionSettingService.GetCustomerExtensionSetting][google.ads.googleads.v3.services.CustomerExtensionSettingService.GetCustomerExtensionSetting]. +message GetCustomerExtensionSettingRequest { + // Required. The resource name of the customer extension setting to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerExtensionSetting" + } + ]; +} + +// Request message for +// [CustomerExtensionSettingService.MutateCustomerExtensionSettings][google.ads.googleads.v3.services.CustomerExtensionSettingService.MutateCustomerExtensionSettings]. +message MutateCustomerExtensionSettingsRequest { + // Required. The ID of the customer whose customer extension settings are being + // modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual customer extension + // settings. + repeated CustomerExtensionSettingOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update, remove) on a customer extension setting. +message CustomerExtensionSettingOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new customer + // extension setting. + google.ads.googleads.v3.resources.CustomerExtensionSetting create = 1; + + // Update operation: The customer extension setting is expected to have a + // valid resource name. + google.ads.googleads.v3.resources.CustomerExtensionSetting update = 2; + + // Remove operation: A resource name for the removed customer extension + // setting is expected, in this format: + // + // `customers/{customer_id}/customerExtensionSettings/{extension_type}` + string remove = 3; + } +} + +// Response message for a customer extension setting mutate. +message MutateCustomerExtensionSettingsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateCustomerExtensionSettingResult results = 2; +} + +// The result for the customer extension setting mutate. +message MutateCustomerExtensionSettingResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/customer_feed_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/customer_feed_service.proto new file mode 100644 index 000000000..6b8a63a4e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/customer_feed_service.proto @@ -0,0 +1,129 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/customer_feed.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "CustomerFeedServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the CustomerFeed service. + +// Service to manage customer feeds. +service CustomerFeedService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested customer feed in full detail. + rpc GetCustomerFeed(GetCustomerFeedRequest) returns (google.ads.googleads.v3.resources.CustomerFeed) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/customerFeeds/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes customer feeds. Operation statuses are + // returned. + rpc MutateCustomerFeeds(MutateCustomerFeedsRequest) returns (MutateCustomerFeedsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/customerFeeds:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [CustomerFeedService.GetCustomerFeed][google.ads.googleads.v3.services.CustomerFeedService.GetCustomerFeed]. +message GetCustomerFeedRequest { + // Required. The resource name of the customer feed to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerFeed" + } + ]; +} + +// Request message for [CustomerFeedService.MutateCustomerFeeds][google.ads.googleads.v3.services.CustomerFeedService.MutateCustomerFeeds]. +message MutateCustomerFeedsRequest { + // Required. The ID of the customer whose customer feeds are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual customer feeds. + repeated CustomerFeedOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update, remove) on a customer feed. +message CustomerFeedOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new customer feed. + google.ads.googleads.v3.resources.CustomerFeed create = 1; + + // Update operation: The customer feed is expected to have a valid resource + // name. + google.ads.googleads.v3.resources.CustomerFeed update = 2; + + // Remove operation: A resource name for the removed customer feed is + // expected, in this format: + // + // `customers/{customer_id}/customerFeeds/{feed_id}` + string remove = 3; + } +} + +// Response message for a customer feed mutate. +message MutateCustomerFeedsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateCustomerFeedResult results = 2; +} + +// The result for the customer feed mutate. +message MutateCustomerFeedResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/customer_label_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/customer_label_service.proto new file mode 100644 index 000000000..c6c7a7c52 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/customer_label_service.proto @@ -0,0 +1,122 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/customer_label.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "CustomerLabelServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Customer Label service. + +// Service to manage labels on customers. +service CustomerLabelService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested customer-label relationship in full detail. + rpc GetCustomerLabel(GetCustomerLabelRequest) returns (google.ads.googleads.v3.resources.CustomerLabel) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/customerLabels/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates and removes customer-label relationships. + // Operation statuses are returned. + rpc MutateCustomerLabels(MutateCustomerLabelsRequest) returns (MutateCustomerLabelsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/customerLabels:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [CustomerLabelService.GetCustomerLabel][google.ads.googleads.v3.services.CustomerLabelService.GetCustomerLabel]. +message GetCustomerLabelRequest { + // Required. The resource name of the customer-label relationship to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerLabel" + } + ]; +} + +// Request message for [CustomerLabelService.MutateCustomerLabels][google.ads.googleads.v3.services.CustomerLabelService.MutateCustomerLabels]. +message MutateCustomerLabelsRequest { + // Required. ID of the customer whose customer-label relationships are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on customer-label relationships. + repeated CustomerLabelOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, remove) on a customer-label relationship. +message CustomerLabelOperation { + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new customer-label + // relationship. + google.ads.googleads.v3.resources.CustomerLabel create = 1; + + // Remove operation: A resource name for the customer-label relationship + // being removed, in this format: + // + // `customers/{customer_id}/customerLabels/{label_id}` + string remove = 2; + } +} + +// Response message for a customer labels mutate. +message MutateCustomerLabelsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateCustomerLabelResult results = 2; +} + +// The result for a customer label mutate. +message MutateCustomerLabelResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/customer_manager_link_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/customer_manager_link_service.proto new file mode 100644 index 000000000..e0701eaef --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/customer_manager_link_service.proto @@ -0,0 +1,139 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/customer_manager_link.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "CustomerManagerLinkServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Service to manage customer-manager links. +service CustomerManagerLinkService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested CustomerManagerLink in full detail. + rpc GetCustomerManagerLink(GetCustomerManagerLinkRequest) returns (google.ads.googleads.v3.resources.CustomerManagerLink) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/customerManagerLinks/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates or updates customer manager links. Operation statuses are returned. + rpc MutateCustomerManagerLink(MutateCustomerManagerLinkRequest) returns (MutateCustomerManagerLinkResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/customerManagerLinks:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } + + // Moves a client customer to a new manager customer. + // This simplifies the complex request that requires two operations to move + // a client customer to a new manager. i.e: + // 1. Update operation with Status INACTIVE (previous manager) and, + // 2. Update operation with Status ACTIVE (new manager). + rpc MoveManagerLink(MoveManagerLinkRequest) returns (MoveManagerLinkResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/customerManagerLinks:moveManagerLink" + body: "*" + }; + option (google.api.method_signature) = "customer_id,previous_customer_manager_link,new_manager"; + } +} + +// Request message for [CustomerManagerLinkService.GetCustomerManagerLink][google.ads.googleads.v3.services.CustomerManagerLinkService.GetCustomerManagerLink]. +message GetCustomerManagerLinkRequest { + // Required. The resource name of the CustomerManagerLink to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerManagerLink" + } + ]; +} + +// Request message for [CustomerManagerLinkService.MutateCustomerManagerLink][google.ads.googleads.v3.services.CustomerManagerLinkService.MutateCustomerManagerLink]. +message MutateCustomerManagerLinkRequest { + // Required. The ID of the customer whose customer manager links are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual customer manager links. + repeated CustomerManagerLinkOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// Request message for [CustomerManagerLinkService.MoveManagerLink][google.ads.googleads.v3.services.CustomerManagerLinkService.MoveManagerLink]. +message MoveManagerLinkRequest { + // Required. The ID of the client customer that is being moved. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The resource name of the previous CustomerManagerLink. + // The resource name has the form: + // `customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}` + string previous_customer_manager_link = 2 [(google.api.field_behavior) = REQUIRED]; + + // Required. The resource name of the new manager customer that the client wants to move + // to. Customer resource names have the format: "customers/{customer_id}" + string new_manager = 3 [(google.api.field_behavior) = REQUIRED]; +} + +// Updates the status of a CustomerManagerLink. +// The following actions are possible: +// 1. Update operation with status ACTIVE accepts a pending invitation. +// 2. Update operation with status REFUSED declines a pending invitation. +// 3. Update operation with status INACTIVE terminates link to manager. +message CustomerManagerLinkOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Update operation: The link is expected to have a valid resource name. + google.ads.googleads.v3.resources.CustomerManagerLink update = 2; + } +} + +// Response message for a CustomerManagerLink mutate. +message MutateCustomerManagerLinkResponse { + // A result that identifies the resource affected by the mutate request. + repeated MutateCustomerManagerLinkResult results = 1; +} + +// Response message for a CustomerManagerLink moveManagerLink. +message MoveManagerLinkResponse { + // Returned for successful operations. Represents a CustomerManagerLink + // resource of the newly created link between client customer and new manager + // customer. + string resource_name = 1; +} + +// The result for the customer manager link mutate. +message MutateCustomerManagerLinkResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/customer_negative_criterion_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/customer_negative_criterion_service.proto new file mode 100644 index 000000000..b4e39244a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/customer_negative_criterion_service.proto @@ -0,0 +1,122 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/customer_negative_criterion.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "CustomerNegativeCriterionServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Customer Negative Criterion service. + +// Service to manage customer negative criteria. +service CustomerNegativeCriterionService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested criterion in full detail. + rpc GetCustomerNegativeCriterion(GetCustomerNegativeCriterionRequest) returns (google.ads.googleads.v3.resources.CustomerNegativeCriterion) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/customerNegativeCriteria/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates or removes criteria. Operation statuses are returned. + rpc MutateCustomerNegativeCriteria(MutateCustomerNegativeCriteriaRequest) returns (MutateCustomerNegativeCriteriaResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/customerNegativeCriteria:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for +// [CustomerNegativeCriterionService.GetCustomerNegativeCriterion][google.ads.googleads.v3.services.CustomerNegativeCriterionService.GetCustomerNegativeCriterion]. +message GetCustomerNegativeCriterionRequest { + // Required. The resource name of the criterion to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/CustomerNegativeCriterion" + } + ]; +} + +// Request message for +// [CustomerNegativeCriterionService.MutateCustomerNegativeCriteria][google.ads.googleads.v3.services.CustomerNegativeCriterionService.MutateCustomerNegativeCriteria]. +message MutateCustomerNegativeCriteriaRequest { + // Required. The ID of the customer whose criteria are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual criteria. + repeated CustomerNegativeCriterionOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create or remove) on a customer level negative criterion. +message CustomerNegativeCriterionOperation { + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new criterion. + google.ads.googleads.v3.resources.CustomerNegativeCriterion create = 1; + + // Remove operation: A resource name for the removed criterion is expected, + // in this format: + // + // `customers/{customer_id}/customerNegativeCriteria/{criterion_id}` + string remove = 2; + } +} + +// Response message for customer negative criterion mutate. +message MutateCustomerNegativeCriteriaResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateCustomerNegativeCriteriaResult results = 2; +} + +// The result for the criterion mutate. +message MutateCustomerNegativeCriteriaResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/customer_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/customer_service.proto new file mode 100644 index 000000000..0644c9561 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/customer_service.proto @@ -0,0 +1,157 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/enums/access_role.proto"; +import "google/ads/googleads/v3/resources/customer.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/protobuf/wrappers.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "CustomerServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Customer service. + +// Service to manage customers. +service CustomerService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested customer in full detail. + rpc GetCustomer(GetCustomerRequest) returns (google.ads.googleads.v3.resources.Customer) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Updates a customer. Operation statuses are returned. + rpc MutateCustomer(MutateCustomerRequest) returns (MutateCustomerResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operation"; + } + + // Returns resource names of customers directly accessible by the + // user authenticating the call. + rpc ListAccessibleCustomers(ListAccessibleCustomersRequest) returns (ListAccessibleCustomersResponse) { + option (google.api.http) = { + get: "/v3/customers:listAccessibleCustomers" + }; + } + + // Creates a new client under manager. The new client customer is returned. + rpc CreateCustomerClient(CreateCustomerClientRequest) returns (CreateCustomerClientResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}:createCustomerClient" + body: "*" + }; + option (google.api.method_signature) = "customer_id,customer_client"; + } +} + +// Request message for [CustomerService.GetCustomer][google.ads.googleads.v3.services.CustomerService.GetCustomer]. +message GetCustomerRequest { + // Required. The resource name of the customer to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Customer" + } + ]; +} + +// Request message for [CustomerService.MutateCustomer][google.ads.googleads.v3.services.CustomerService.MutateCustomer]. +message MutateCustomerRequest { + // Required. The ID of the customer being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The operation to perform on the customer + CustomerOperation operation = 4 [(google.api.field_behavior) = REQUIRED]; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 5; +} + +// Request message for [CustomerService.CreateCustomerClient][google.ads.googleads.v3.services.CustomerService.CreateCustomerClient]. +message CreateCustomerClientRequest { + // Required. The ID of the Manager under whom client customer is being created. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The new client customer to create. The resource name on this customer + // will be ignored. + google.ads.googleads.v3.resources.Customer customer_client = 2 [(google.api.field_behavior) = REQUIRED]; + + // Email address of the user who should be invited on the created client + // customer. Accessible to whitelisted customers only. + google.protobuf.StringValue email_address = 3; + + // The proposed role of user on the created client customer. + // Accessible to whitelisted customers only. + google.ads.googleads.v3.enums.AccessRoleEnum.AccessRole access_role = 4; +} + +// A single update on a customer. +message CustomerOperation { + // Mutate operation. Only updates are supported for customer. + google.ads.googleads.v3.resources.Customer update = 1; + + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 2; +} + +// Response message for CreateCustomerClient mutate. +message CreateCustomerClientResponse { + // The resource name of the newly created customer client. + string resource_name = 2; +} + +// Response message for customer mutate. +message MutateCustomerResponse { + // Result for the mutate. + MutateCustomerResult result = 2; +} + +// The result for the customer mutate. +message MutateCustomerResult { + // Returned for successful operations. + string resource_name = 1; +} + +// Request message for [CustomerService.ListAccessibleCustomers][google.ads.googleads.v3.services.CustomerService.ListAccessibleCustomers]. +message ListAccessibleCustomersRequest { + +} + +// Response message for [CustomerService.ListAccessibleCustomers][google.ads.googleads.v3.services.CustomerService.ListAccessibleCustomers]. +message ListAccessibleCustomersResponse { + // Resource name of customers directly accessible by the + // user authenticating the call. + repeated string resource_names = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/detail_placement_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/detail_placement_view_service.proto new file mode 100644 index 000000000..dc92f24c7 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/detail_placement_view_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/detail_placement_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "DetailPlacementViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Detail Placement View service. + +// Service to fetch Detail Placement views. +service DetailPlacementViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested Detail Placement view in full detail. + rpc GetDetailPlacementView(GetDetailPlacementViewRequest) returns (google.ads.googleads.v3.resources.DetailPlacementView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/detailPlacementViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [DetailPlacementViewService.GetDetailPlacementView][google.ads.googleads.v3.services.DetailPlacementViewService.GetDetailPlacementView]. +message GetDetailPlacementViewRequest { + // Required. The resource name of the Detail Placement view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DetailPlacementView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/display_keyword_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/display_keyword_view_service.proto new file mode 100644 index 000000000..1189819fc --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/display_keyword_view_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/display_keyword_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "DisplayKeywordViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Display Keyword View service. + +// Service to manage display keyword views. +service DisplayKeywordViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested display keyword view in full detail. + rpc GetDisplayKeywordView(GetDisplayKeywordViewRequest) returns (google.ads.googleads.v3.resources.DisplayKeywordView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/displayKeywordViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [DisplayKeywordViewService.GetDisplayKeywordView][google.ads.googleads.v3.services.DisplayKeywordViewService.GetDisplayKeywordView]. +message GetDisplayKeywordViewRequest { + // Required. The resource name of the display keyword view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DisplayKeywordView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/distance_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/distance_view_service.proto new file mode 100644 index 000000000..6673b5546 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/distance_view_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/distance_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "DistanceViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Distance View service. + +// Service to fetch distance views. +service DistanceViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the attributes of the requested distance view. + rpc GetDistanceView(GetDistanceViewRequest) returns (google.ads.googleads.v3.resources.DistanceView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/distanceViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [DistanceViewService.GetDistanceView][google.ads.googleads.v3.services.DistanceViewService.GetDistanceView]. +message GetDistanceViewRequest { + // Required. The resource name of the distance view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DistanceView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/domain_category_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/domain_category_service.proto new file mode 100644 index 000000000..cedbbdb5b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/domain_category_service.proto @@ -0,0 +1,59 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/domain_category.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "DomainCategoryServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the DomainCategory Service. + +// Service to fetch domain categories. +service DomainCategoryService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested domain category. + rpc GetDomainCategory(GetDomainCategoryRequest) returns (google.ads.googleads.v3.resources.DomainCategory) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/domainCategories/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for +// [DomainCategoryService.GetDomainCategory][google.ads.googleads.v3.services.DomainCategoryService.GetDomainCategory]. +message GetDomainCategoryRequest { + // Required. Resource name of the domain category to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DomainCategory" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/dynamic_search_ads_search_term_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/dynamic_search_ads_search_term_view_service.proto new file mode 100644 index 000000000..fe5066c86 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/dynamic_search_ads_search_term_view_service.proto @@ -0,0 +1,59 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/dynamic_search_ads_search_term_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "DynamicSearchAdsSearchTermViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Dynamic Search Ads Search Term View service. + +// Service to fetch dynamic search ads views. +service DynamicSearchAdsSearchTermViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested dynamic search ads search term view in full detail. + rpc GetDynamicSearchAdsSearchTermView(GetDynamicSearchAdsSearchTermViewRequest) returns (google.ads.googleads.v3.resources.DynamicSearchAdsSearchTermView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/dynamicSearchAdsSearchTermViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for +// [DynamicSearchAdsSearchTermViewService.GetDynamicSearchAdsSearchTermView][google.ads.googleads.v3.services.DynamicSearchAdsSearchTermViewService.GetDynamicSearchAdsSearchTermView]. +message GetDynamicSearchAdsSearchTermViewRequest { + // Required. The resource name of the dynamic search ads search term view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/DynamicSearchAdsSearchTermView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/expanded_landing_page_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/expanded_landing_page_view_service.proto new file mode 100644 index 000000000..b0a7909f7 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/expanded_landing_page_view_service.proto @@ -0,0 +1,59 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/expanded_landing_page_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "ExpandedLandingPageViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the expanded landing page view service. + +// Service to fetch expanded landing page views. +service ExpandedLandingPageViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested expanded landing page view in full detail. + rpc GetExpandedLandingPageView(GetExpandedLandingPageViewRequest) returns (google.ads.googleads.v3.resources.ExpandedLandingPageView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/expandedLandingPageViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for +// [ExpandedLandingPageViewService.GetExpandedLandingPageView][google.ads.googleads.v3.services.ExpandedLandingPageViewService.GetExpandedLandingPageView]. +message GetExpandedLandingPageViewRequest { + // Required. The resource name of the expanded landing page view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ExpandedLandingPageView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/extension_feed_item_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/extension_feed_item_service.proto new file mode 100644 index 000000000..d505f023c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/extension_feed_item_service.proto @@ -0,0 +1,131 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/extension_feed_item.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "ExtensionFeedItemServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the ExtensionFeedItem service. + +// Service to manage extension feed items. +service ExtensionFeedItemService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested extension feed item in full detail. + rpc GetExtensionFeedItem(GetExtensionFeedItemRequest) returns (google.ads.googleads.v3.resources.ExtensionFeedItem) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/extensionFeedItems/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes extension feed items. Operation + // statuses are returned. + rpc MutateExtensionFeedItems(MutateExtensionFeedItemsRequest) returns (MutateExtensionFeedItemsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/extensionFeedItems:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [ExtensionFeedItemService.GetExtensionFeedItem][google.ads.googleads.v3.services.ExtensionFeedItemService.GetExtensionFeedItem]. +message GetExtensionFeedItemRequest { + // Required. The resource name of the extension feed item to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ExtensionFeedItem" + } + ]; +} + +// Request message for [ExtensionFeedItemService.MutateExtensionFeedItems][google.ads.googleads.v3.services.ExtensionFeedItemService.MutateExtensionFeedItems]. +message MutateExtensionFeedItemsRequest { + // Required. The ID of the customer whose extension feed items are being + // modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual extension feed items. + repeated ExtensionFeedItemOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update, remove) on an extension feed item. +message ExtensionFeedItemOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new extension + // feed item. + google.ads.googleads.v3.resources.ExtensionFeedItem create = 1; + + // Update operation: The extension feed item is expected to have a + // valid resource name. + google.ads.googleads.v3.resources.ExtensionFeedItem update = 2; + + // Remove operation: A resource name for the removed extension feed item + // is expected, in this format: + // + // `customers/{customer_id}/extensionFeedItems/{feed_item_id}` + string remove = 3; + } +} + +// Response message for an extension feed item mutate. +message MutateExtensionFeedItemsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateExtensionFeedItemResult results = 2; +} + +// The result for the extension feed item mutate. +message MutateExtensionFeedItemResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/feed_item_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/feed_item_service.proto new file mode 100644 index 000000000..a7b5525f0 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/feed_item_service.proto @@ -0,0 +1,129 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/feed_item.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "FeedItemServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the FeedItem service. + +// Service to manage feed items. +service FeedItemService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested feed item in full detail. + rpc GetFeedItem(GetFeedItemRequest) returns (google.ads.googleads.v3.resources.FeedItem) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/feedItems/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes feed items. Operation statuses are + // returned. + rpc MutateFeedItems(MutateFeedItemsRequest) returns (MutateFeedItemsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/feedItems:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [FeedItemService.GetFeedItem][google.ads.googleads.v3.services.FeedItemService.GetFeedItem]. +message GetFeedItemRequest { + // Required. The resource name of the feed item to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedItem" + } + ]; +} + +// Request message for [FeedItemService.MutateFeedItems][google.ads.googleads.v3.services.FeedItemService.MutateFeedItems]. +message MutateFeedItemsRequest { + // Required. The ID of the customer whose feed items are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual feed items. + repeated FeedItemOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update, remove) on an feed item. +message FeedItemOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new feed item. + google.ads.googleads.v3.resources.FeedItem create = 1; + + // Update operation: The feed item is expected to have a valid resource + // name. + google.ads.googleads.v3.resources.FeedItem update = 2; + + // Remove operation: A resource name for the removed feed item is + // expected, in this format: + // + // `customers/{customer_id}/feedItems/{feed_id}~{feed_item_id}` + string remove = 3; + } +} + +// Response message for an feed item mutate. +message MutateFeedItemsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateFeedItemResult results = 2; +} + +// The result for the feed item mutate. +message MutateFeedItemResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/feed_item_target_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/feed_item_target_service.proto new file mode 100644 index 000000000..ad135525e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/feed_item_target_service.proto @@ -0,0 +1,104 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/feed_item_target.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "FeedItemTargetServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the FeedItemTarget service. + +// Service to manage feed item targets. +service FeedItemTargetService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested feed item targets in full detail. + rpc GetFeedItemTarget(GetFeedItemTargetRequest) returns (google.ads.googleads.v3.resources.FeedItemTarget) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/feedItemTargets/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates or removes feed item targets. Operation statuses are returned. + rpc MutateFeedItemTargets(MutateFeedItemTargetsRequest) returns (MutateFeedItemTargetsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/feedItemTargets:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [FeedItemTargetService.GetFeedItemTarget][google.ads.googleads.v3.services.FeedItemTargetService.GetFeedItemTarget]. +message GetFeedItemTargetRequest { + // Required. The resource name of the feed item targets to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedItemTarget" + } + ]; +} + +// Request message for [FeedItemTargetService.MutateFeedItemTargets][google.ads.googleads.v3.services.FeedItemTargetService.MutateFeedItemTargets]. +message MutateFeedItemTargetsRequest { + // Required. The ID of the customer whose feed item targets are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual feed item targets. + repeated FeedItemTargetOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// A single operation (create, remove) on an feed item target. +message FeedItemTargetOperation { + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new feed item + // target. + google.ads.googleads.v3.resources.FeedItemTarget create = 1; + + // Remove operation: A resource name for the removed feed item target is + // expected, in this format: + // + // `customers/{customer_id}/feedItemTargets/{feed_id}~{feed_item_id}~{feed_item_target_type}~{feed_item_target_id}` + string remove = 2; + } +} + +// Response message for an feed item target mutate. +message MutateFeedItemTargetsResponse { + // All results for the mutate. + repeated MutateFeedItemTargetResult results = 2; +} + +// The result for the feed item target mutate. +message MutateFeedItemTargetResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/feed_mapping_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/feed_mapping_service.proto new file mode 100644 index 000000000..02aeb34f5 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/feed_mapping_service.proto @@ -0,0 +1,121 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/feed_mapping.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "FeedMappingServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the FeedMapping service. + +// Service to manage feed mappings. +service FeedMappingService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested feed mapping in full detail. + rpc GetFeedMapping(GetFeedMappingRequest) returns (google.ads.googleads.v3.resources.FeedMapping) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/feedMappings/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates or removes feed mappings. Operation statuses are + // returned. + rpc MutateFeedMappings(MutateFeedMappingsRequest) returns (MutateFeedMappingsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/feedMappings:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [FeedMappingService.GetFeedMapping][google.ads.googleads.v3.services.FeedMappingService.GetFeedMapping]. +message GetFeedMappingRequest { + // Required. The resource name of the feed mapping to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedMapping" + } + ]; +} + +// Request message for [FeedMappingService.MutateFeedMappings][google.ads.googleads.v3.services.FeedMappingService.MutateFeedMappings]. +message MutateFeedMappingsRequest { + // Required. The ID of the customer whose feed mappings are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual feed mappings. + repeated FeedMappingOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, remove) on a feed mapping. +message FeedMappingOperation { + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new feed mapping. + google.ads.googleads.v3.resources.FeedMapping create = 1; + + // Remove operation: A resource name for the removed feed mapping is + // expected, in this format: + // + // `customers/{customer_id}/feedMappings/{feed_id}~{feed_mapping_id}` + string remove = 3; + } +} + +// Response message for a feed mapping mutate. +message MutateFeedMappingsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateFeedMappingResult results = 2; +} + +// The result for the feed mapping mutate. +message MutateFeedMappingResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/feed_placeholder_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/feed_placeholder_view_service.proto new file mode 100644 index 000000000..2936bf767 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/feed_placeholder_view_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/feed_placeholder_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "FeedPlaceholderViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the FeedPlaceholderView service. + +// Service to fetch feed placeholder views. +service FeedPlaceholderViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested feed placeholder view in full detail. + rpc GetFeedPlaceholderView(GetFeedPlaceholderViewRequest) returns (google.ads.googleads.v3.resources.FeedPlaceholderView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/feedPlaceholderViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [FeedPlaceholderViewService.GetFeedPlaceholderView][google.ads.googleads.v3.services.FeedPlaceholderViewService.GetFeedPlaceholderView]. +message GetFeedPlaceholderViewRequest { + // Required. The resource name of the feed placeholder view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/FeedPlaceholderView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/feed_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/feed_service.proto new file mode 100644 index 000000000..165a2c374 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/feed_service.proto @@ -0,0 +1,129 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/feed.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "FeedServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Feed service. + +// Service to manage feeds. +service FeedService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested feed in full detail. + rpc GetFeed(GetFeedRequest) returns (google.ads.googleads.v3.resources.Feed) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/feeds/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes feeds. Operation statuses are + // returned. + rpc MutateFeeds(MutateFeedsRequest) returns (MutateFeedsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/feeds:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [FeedService.GetFeed][google.ads.googleads.v3.services.FeedService.GetFeed]. +message GetFeedRequest { + // Required. The resource name of the feed to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Feed" + } + ]; +} + +// Request message for [FeedService.MutateFeeds][google.ads.googleads.v3.services.FeedService.MutateFeeds]. +message MutateFeedsRequest { + // Required. The ID of the customer whose feeds are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual feeds. + repeated FeedOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update, remove) on an feed. +message FeedOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new feed. + google.ads.googleads.v3.resources.Feed create = 1; + + // Update operation: The feed is expected to have a valid resource + // name. + google.ads.googleads.v3.resources.Feed update = 2; + + // Remove operation: A resource name for the removed feed is + // expected, in this format: + // + // `customers/{customer_id}/feeds/{feed_id}` + string remove = 3; + } +} + +// Response message for an feed mutate. +message MutateFeedsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateFeedResult results = 2; +} + +// The result for the feed mutate. +message MutateFeedResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/gender_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/gender_view_service.proto new file mode 100644 index 000000000..69965c21a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/gender_view_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/gender_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "GenderViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Gender View service. + +// Service to manage gender views. +service GenderViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested gender view in full detail. + rpc GetGenderView(GetGenderViewRequest) returns (google.ads.googleads.v3.resources.GenderView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/genderViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [GenderViewService.GetGenderView][google.ads.googleads.v3.services.GenderViewService.GetGenderView]. +message GetGenderViewRequest { + // Required. The resource name of the gender view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GenderView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/geo_target_constant_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/geo_target_constant_service.proto new file mode 100644 index 000000000..f0088c409 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/geo_target_constant_service.proto @@ -0,0 +1,129 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/geo_target_constant.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "GeoTargetConstantServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Geo target constant service. + +// Service to fetch geo target constants. +service GeoTargetConstantService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested geo target constant in full detail. + rpc GetGeoTargetConstant(GetGeoTargetConstantRequest) returns (google.ads.googleads.v3.resources.GeoTargetConstant) { + option (google.api.http) = { + get: "/v3/{resource_name=geoTargetConstants/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Returns GeoTargetConstant suggestions by location name or by resource name. + rpc SuggestGeoTargetConstants(SuggestGeoTargetConstantsRequest) returns (SuggestGeoTargetConstantsResponse) { + option (google.api.http) = { + post: "/v3/geoTargetConstants:suggest" + body: "*" + }; + } +} + +// Request message for [GeoTargetConstantService.GetGeoTargetConstant][google.ads.googleads.v3.services.GeoTargetConstantService.GetGeoTargetConstant]. +message GetGeoTargetConstantRequest { + // Required. The resource name of the geo target constant to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GeoTargetConstant" + } + ]; +} + +// Request message for +// [GeoTargetConstantService.SuggestGeoTargetConstantsRequest][]. +message SuggestGeoTargetConstantsRequest { + // A list of location names. + message LocationNames { + // A list of location names. + repeated google.protobuf.StringValue names = 1; + } + + // A list of geo target constant resource names. + message GeoTargets { + // A list of geo target constant resource names. + repeated google.protobuf.StringValue geo_target_constants = 1; + } + + // If possible, returned geo targets are translated using this locale. If not, + // en is used by default. This is also used as a hint for returned geo + // targets. + google.protobuf.StringValue locale = 3; + + // Returned geo targets are restricted to this country code. + google.protobuf.StringValue country_code = 5; + + // Required. A selector of geo target constants. + oneof query { + // The location names to search by. At most 25 names can be set. + LocationNames location_names = 1; + + // The geo target constant resource names to filter by. + GeoTargets geo_targets = 2; + } +} + +// Response message for [GeoTargetConstantService.SuggestGeoTargetConstants][google.ads.googleads.v3.services.GeoTargetConstantService.SuggestGeoTargetConstants] +message SuggestGeoTargetConstantsResponse { + // Geo target constant suggestions. + repeated GeoTargetConstantSuggestion geo_target_constant_suggestions = 1; +} + +// A geo target constant suggestion. +message GeoTargetConstantSuggestion { + // The language this GeoTargetConstantSuggestion is currently translated to. + // It affects the name of geo target fields. For example, if locale=en, then + // name=Spain. If locale=es, then name=España. The default locale will be + // returned if no translation exists for the locale in the request. + google.protobuf.StringValue locale = 1; + + // Approximate user population that will be targeted, rounded to the + // nearest 100. + google.protobuf.Int64Value reach = 2; + + // If the request searched by location name, this is the location name that + // matched the geo target. + google.protobuf.StringValue search_term = 3; + + // The GeoTargetConstant result. + google.ads.googleads.v3.resources.GeoTargetConstant geo_target_constant = 4; + + // The list of parents of the geo target constant. + repeated google.ads.googleads.v3.resources.GeoTargetConstant geo_target_constant_parents = 5; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/geographic_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/geographic_view_service.proto new file mode 100644 index 000000000..a9f301c99 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/geographic_view_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/geographic_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "GeographicViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the GeographicViewService. + +// Service to manage geographic views. +service GeographicViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested geographic view in full detail. + rpc GetGeographicView(GetGeographicViewRequest) returns (google.ads.googleads.v3.resources.GeographicView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/geographicViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [GeographicViewService.GetGeographicView][google.ads.googleads.v3.services.GeographicViewService.GetGeographicView]. +message GetGeographicViewRequest { + // Required. The resource name of the geographic view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GeographicView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/google_ads_field_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/google_ads_field_service.proto new file mode 100644 index 000000000..04f4a7866 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/google_ads_field_service.proto @@ -0,0 +1,97 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/google_ads_field.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "GoogleAdsFieldServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the GoogleAdsFieldService + +// Service to fetch Google Ads API fields. +service GoogleAdsFieldService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns just the requested field. + rpc GetGoogleAdsField(GetGoogleAdsFieldRequest) returns (google.ads.googleads.v3.resources.GoogleAdsField) { + option (google.api.http) = { + get: "/v3/{resource_name=googleAdsFields/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Returns all fields that match the search query. + rpc SearchGoogleAdsFields(SearchGoogleAdsFieldsRequest) returns (SearchGoogleAdsFieldsResponse) { + option (google.api.http) = { + post: "/v3/googleAdsFields:search" + body: "*" + }; + option (google.api.method_signature) = "query"; + } +} + +// Request message for [GoogleAdsFieldService.GetGoogleAdsField][google.ads.googleads.v3.services.GoogleAdsFieldService.GetGoogleAdsField]. +message GetGoogleAdsFieldRequest { + // Required. The resource name of the field to get. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GoogleAdsField" + } + ]; +} + +// Request message for [GoogleAdsFieldService.SearchGoogleAdsFields][google.ads.googleads.v3.services.GoogleAdsFieldService.SearchGoogleAdsFields]. +message SearchGoogleAdsFieldsRequest { + // Required. The query string. + string query = 1 [(google.api.field_behavior) = REQUIRED]; + + // Token of the page to retrieve. If not specified, the first page of + // results will be returned. Use the value obtained from `next_page_token` + // in the previous response in order to request the next page of results. + string page_token = 2; + + // Number of elements to retrieve in a single page. + // When too large a page is requested, the server may decide to further + // limit the number of returned resources. + int32 page_size = 3; +} + +// Response message for [GoogleAdsFieldService.SearchGoogleAdsFields][google.ads.googleads.v3.services.GoogleAdsFieldService.SearchGoogleAdsFields]. +message SearchGoogleAdsFieldsResponse { + // The list of fields that matched the query. + repeated google.ads.googleads.v3.resources.GoogleAdsField results = 1; + + // Pagination token used to retrieve the next page of results. Pass the + // content of this string as the `page_token` attribute of the next request. + // `next_page_token` is not returned for the last page. + string next_page_token = 2; + + // Total number of results that match the query ignoring the LIMIT clause. + int64 total_results_count = 3; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/google_ads_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/google_ads_service.proto new file mode 100644 index 000000000..44dc020c9 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/google_ads_service.proto @@ -0,0 +1,928 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/common/metrics.proto"; +import "google/ads/googleads/v3/common/segments.proto"; +import "google/ads/googleads/v3/enums/summary_row_setting.proto"; +import "google/ads/googleads/v3/resources/account_budget.proto"; +import "google/ads/googleads/v3/resources/account_budget_proposal.proto"; +import "google/ads/googleads/v3/resources/ad_group.proto"; +import "google/ads/googleads/v3/resources/ad_group_ad.proto"; +import "google/ads/googleads/v3/resources/ad_group_ad_asset_view.proto"; +import "google/ads/googleads/v3/resources/ad_group_ad_label.proto"; +import "google/ads/googleads/v3/resources/ad_group_audience_view.proto"; +import "google/ads/googleads/v3/resources/ad_group_bid_modifier.proto"; +import "google/ads/googleads/v3/resources/ad_group_criterion.proto"; +import "google/ads/googleads/v3/resources/ad_group_criterion_label.proto"; +import "google/ads/googleads/v3/resources/ad_group_criterion_simulation.proto"; +import "google/ads/googleads/v3/resources/ad_group_extension_setting.proto"; +import "google/ads/googleads/v3/resources/ad_group_feed.proto"; +import "google/ads/googleads/v3/resources/ad_group_label.proto"; +import "google/ads/googleads/v3/resources/ad_group_simulation.proto"; +import "google/ads/googleads/v3/resources/ad_parameter.proto"; +import "google/ads/googleads/v3/resources/ad_schedule_view.proto"; +import "google/ads/googleads/v3/resources/age_range_view.proto"; +import "google/ads/googleads/v3/resources/asset.proto"; +import "google/ads/googleads/v3/resources/bidding_strategy.proto"; +import "google/ads/googleads/v3/resources/billing_setup.proto"; +import "google/ads/googleads/v3/resources/campaign.proto"; +import "google/ads/googleads/v3/resources/campaign_audience_view.proto"; +import "google/ads/googleads/v3/resources/campaign_bid_modifier.proto"; +import "google/ads/googleads/v3/resources/campaign_budget.proto"; +import "google/ads/googleads/v3/resources/campaign_criterion.proto"; +import "google/ads/googleads/v3/resources/campaign_criterion_simulation.proto"; +import "google/ads/googleads/v3/resources/campaign_draft.proto"; +import "google/ads/googleads/v3/resources/campaign_experiment.proto"; +import "google/ads/googleads/v3/resources/campaign_extension_setting.proto"; +import "google/ads/googleads/v3/resources/campaign_feed.proto"; +import "google/ads/googleads/v3/resources/campaign_label.proto"; +import "google/ads/googleads/v3/resources/campaign_shared_set.proto"; +import "google/ads/googleads/v3/resources/carrier_constant.proto"; +import "google/ads/googleads/v3/resources/change_status.proto"; +import "google/ads/googleads/v3/resources/click_view.proto"; +import "google/ads/googleads/v3/resources/conversion_action.proto"; +import "google/ads/googleads/v3/resources/currency_constant.proto"; +import "google/ads/googleads/v3/resources/custom_interest.proto"; +import "google/ads/googleads/v3/resources/customer.proto"; +import "google/ads/googleads/v3/resources/customer_client.proto"; +import "google/ads/googleads/v3/resources/customer_client_link.proto"; +import "google/ads/googleads/v3/resources/customer_extension_setting.proto"; +import "google/ads/googleads/v3/resources/customer_feed.proto"; +import "google/ads/googleads/v3/resources/customer_label.proto"; +import "google/ads/googleads/v3/resources/customer_manager_link.proto"; +import "google/ads/googleads/v3/resources/customer_negative_criterion.proto"; +import "google/ads/googleads/v3/resources/detail_placement_view.proto"; +import "google/ads/googleads/v3/resources/display_keyword_view.proto"; +import "google/ads/googleads/v3/resources/distance_view.proto"; +import "google/ads/googleads/v3/resources/domain_category.proto"; +import "google/ads/googleads/v3/resources/dynamic_search_ads_search_term_view.proto"; +import "google/ads/googleads/v3/resources/expanded_landing_page_view.proto"; +import "google/ads/googleads/v3/resources/extension_feed_item.proto"; +import "google/ads/googleads/v3/resources/feed.proto"; +import "google/ads/googleads/v3/resources/feed_item.proto"; +import "google/ads/googleads/v3/resources/feed_item_target.proto"; +import "google/ads/googleads/v3/resources/feed_mapping.proto"; +import "google/ads/googleads/v3/resources/feed_placeholder_view.proto"; +import "google/ads/googleads/v3/resources/gender_view.proto"; +import "google/ads/googleads/v3/resources/geo_target_constant.proto"; +import "google/ads/googleads/v3/resources/geographic_view.proto"; +import "google/ads/googleads/v3/resources/group_placement_view.proto"; +import "google/ads/googleads/v3/resources/hotel_group_view.proto"; +import "google/ads/googleads/v3/resources/hotel_performance_view.proto"; +import "google/ads/googleads/v3/resources/keyword_plan.proto"; +import "google/ads/googleads/v3/resources/keyword_plan_ad_group.proto"; +import "google/ads/googleads/v3/resources/keyword_plan_campaign.proto"; +import "google/ads/googleads/v3/resources/keyword_plan_keyword.proto"; +import "google/ads/googleads/v3/resources/keyword_plan_negative_keyword.proto"; +import "google/ads/googleads/v3/resources/keyword_view.proto"; +import "google/ads/googleads/v3/resources/label.proto"; +import "google/ads/googleads/v3/resources/landing_page_view.proto"; +import "google/ads/googleads/v3/resources/language_constant.proto"; +import "google/ads/googleads/v3/resources/location_view.proto"; +import "google/ads/googleads/v3/resources/managed_placement_view.proto"; +import "google/ads/googleads/v3/resources/media_file.proto"; +import "google/ads/googleads/v3/resources/mobile_app_category_constant.proto"; +import "google/ads/googleads/v3/resources/mobile_device_constant.proto"; +import "google/ads/googleads/v3/resources/mutate_job.proto"; +import "google/ads/googleads/v3/resources/offline_user_data_job.proto"; +import "google/ads/googleads/v3/resources/operating_system_version_constant.proto"; +import "google/ads/googleads/v3/resources/paid_organic_search_term_view.proto"; +import "google/ads/googleads/v3/resources/parental_status_view.proto"; +import "google/ads/googleads/v3/resources/product_bidding_category_constant.proto"; +import "google/ads/googleads/v3/resources/product_group_view.proto"; +import "google/ads/googleads/v3/resources/recommendation.proto"; +import "google/ads/googleads/v3/resources/remarketing_action.proto"; +import "google/ads/googleads/v3/resources/search_term_view.proto"; +import "google/ads/googleads/v3/resources/shared_criterion.proto"; +import "google/ads/googleads/v3/resources/shared_set.proto"; +import "google/ads/googleads/v3/resources/shopping_performance_view.proto"; +import "google/ads/googleads/v3/resources/topic_constant.proto"; +import "google/ads/googleads/v3/resources/topic_view.proto"; +import "google/ads/googleads/v3/resources/user_interest.proto"; +import "google/ads/googleads/v3/resources/user_list.proto"; +import "google/ads/googleads/v3/resources/user_location_view.proto"; +import "google/ads/googleads/v3/resources/video.proto"; +import "google/ads/googleads/v3/services/ad_group_ad_label_service.proto"; +import "google/ads/googleads/v3/services/ad_group_ad_service.proto"; +import "google/ads/googleads/v3/services/ad_group_bid_modifier_service.proto"; +import "google/ads/googleads/v3/services/ad_group_criterion_label_service.proto"; +import "google/ads/googleads/v3/services/ad_group_criterion_service.proto"; +import "google/ads/googleads/v3/services/ad_group_extension_setting_service.proto"; +import "google/ads/googleads/v3/services/ad_group_feed_service.proto"; +import "google/ads/googleads/v3/services/ad_group_label_service.proto"; +import "google/ads/googleads/v3/services/ad_group_service.proto"; +import "google/ads/googleads/v3/services/ad_parameter_service.proto"; +import "google/ads/googleads/v3/services/ad_service.proto"; +import "google/ads/googleads/v3/services/asset_service.proto"; +import "google/ads/googleads/v3/services/bidding_strategy_service.proto"; +import "google/ads/googleads/v3/services/campaign_bid_modifier_service.proto"; +import "google/ads/googleads/v3/services/campaign_budget_service.proto"; +import "google/ads/googleads/v3/services/campaign_criterion_service.proto"; +import "google/ads/googleads/v3/services/campaign_draft_service.proto"; +import "google/ads/googleads/v3/services/campaign_experiment_service.proto"; +import "google/ads/googleads/v3/services/campaign_extension_setting_service.proto"; +import "google/ads/googleads/v3/services/campaign_feed_service.proto"; +import "google/ads/googleads/v3/services/campaign_label_service.proto"; +import "google/ads/googleads/v3/services/campaign_service.proto"; +import "google/ads/googleads/v3/services/campaign_shared_set_service.proto"; +import "google/ads/googleads/v3/services/conversion_action_service.proto"; +import "google/ads/googleads/v3/services/customer_extension_setting_service.proto"; +import "google/ads/googleads/v3/services/customer_feed_service.proto"; +import "google/ads/googleads/v3/services/customer_label_service.proto"; +import "google/ads/googleads/v3/services/customer_negative_criterion_service.proto"; +import "google/ads/googleads/v3/services/customer_service.proto"; +import "google/ads/googleads/v3/services/extension_feed_item_service.proto"; +import "google/ads/googleads/v3/services/feed_item_service.proto"; +import "google/ads/googleads/v3/services/feed_item_target_service.proto"; +import "google/ads/googleads/v3/services/feed_mapping_service.proto"; +import "google/ads/googleads/v3/services/feed_service.proto"; +import "google/ads/googleads/v3/services/label_service.proto"; +import "google/ads/googleads/v3/services/media_file_service.proto"; +import "google/ads/googleads/v3/services/remarketing_action_service.proto"; +import "google/ads/googleads/v3/services/shared_criterion_service.proto"; +import "google/ads/googleads/v3/services/shared_set_service.proto"; +import "google/ads/googleads/v3/services/user_list_service.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "GoogleAdsServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the GoogleAdsService. + +// Service to fetch data and metrics across resources. +service GoogleAdsService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns all rows that match the search query. + rpc Search(SearchGoogleAdsRequest) returns (SearchGoogleAdsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/googleAds:search" + body: "*" + }; + option (google.api.method_signature) = "customer_id,query"; + } + + // Returns all rows that match the search stream query. + rpc SearchStream(SearchGoogleAdsStreamRequest) returns (stream SearchGoogleAdsStreamResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/googleAds:searchStream" + body: "*" + }; + option (google.api.method_signature) = "customer_id,query"; + } + + // Creates, updates, or removes resources. This method supports atomic + // transactions with multiple types of resources. For example, you can + // atomically create a campaign and a campaign budget, or perform up to + // thousands of mutates atomically. + // + // This method is essentially a wrapper around a series of mutate methods. The + // only features it offers over calling those methods directly are: + // + // - Atomic transactions + // - Temp resource names (described below) + // - Somewhat reduced latency over making a series of mutate calls + // + // Note: Only resources that support atomic transactions are included, so this + // method can't replace all calls to individual services. + // + // ## Atomic Transaction Benefits + // + // Atomicity makes error handling much easier. If you're making a series of + // changes and one fails, it can leave your account in an inconsistent state. + // With atomicity, you either reach the desired state directly, or the request + // fails and you can retry. + // + // ## Temp Resource Names + // + // Temp resource names are a special type of resource name used to create a + // resource and reference that resource in the same request. For example, if a + // campaign budget is created with `resource_name` equal to + // `customers/123/campaignBudgets/-1`, that resource name can be reused in + // the `Campaign.budget` field in the same request. That way, the two + // resources are created and linked atomically. + // + // To create a temp resource name, put a negative number in the part of the + // name that the server would normally allocate. + // + // Note: + // + // - Resources must be created with a temp name before the name can be reused. + // For example, the previous CampaignBudget+Campaign example would fail if + // the mutate order was reversed. + // - Temp names are not remembered across requests. + // - There's no limit to the number of temp names in a request. + // - Each temp name must use a unique negative number, even if the resource + // types differ. + // + // ## Latency + // + // It's important to group mutates by resource type or the request may time + // out and fail. Latency is roughly equal to a series of calls to individual + // mutate methods, where each change in resource type is a new call. For + // example, mutating 10 campaigns then 10 ad groups is like 2 calls, while + // mutating 1 campaign, 1 ad group, 1 campaign, 1 ad group is like 4 calls. + rpc Mutate(MutateGoogleAdsRequest) returns (MutateGoogleAdsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/googleAds:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,mutate_operations"; + } +} + +// Request message for [GoogleAdsService.Search][google.ads.googleads.v3.services.GoogleAdsService.Search]. +message SearchGoogleAdsRequest { + // Required. The ID of the customer being queried. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The query string. + string query = 2 [(google.api.field_behavior) = REQUIRED]; + + // Token of the page to retrieve. If not specified, the first + // page of results will be returned. Use the value obtained from + // `next_page_token` in the previous response in order to request + // the next page of results. + string page_token = 3; + + // Number of elements to retrieve in a single page. + // When too large a page is requested, the server may decide to + // further limit the number of returned resources. + int32 page_size = 4; + + // If true, the request is validated but not executed. + bool validate_only = 5; + + // If true, the total number of results that match the query ignoring the + // LIMIT clause will be included in the response. + // Default is false. + bool return_total_results_count = 7; + + // Determines whether a summary row will be returned. By default, summary row + // is not returned. If requested, the summary row will be sent in a response + // by itself after all other query results are returned. + google.ads.googleads.v3.enums.SummaryRowSettingEnum.SummaryRowSetting summary_row_setting = 8; +} + +// Response message for [GoogleAdsService.Search][google.ads.googleads.v3.services.GoogleAdsService.Search]. +message SearchGoogleAdsResponse { + // The list of rows that matched the query. + repeated GoogleAdsRow results = 1; + + // Pagination token used to retrieve the next page of results. + // Pass the content of this string as the `page_token` attribute of + // the next request. `next_page_token` is not returned for the last + // page. + string next_page_token = 2; + + // Total number of results that match the query ignoring the LIMIT + // clause. + int64 total_results_count = 3; + + // FieldMask that represents what fields were requested by the user. + google.protobuf.FieldMask field_mask = 5; + + // Summary row that contains summary of metrics in results. + // Summary of metrics means aggregation of metrics across all results, + // here aggregation could be sum, average, rate, etc. + GoogleAdsRow summary_row = 6; +} + +// Request message for [GoogleAdsService.SearchStream][google.ads.googleads.v3.services.GoogleAdsService.SearchStream]. +message SearchGoogleAdsStreamRequest { + // Required. The ID of the customer being queried. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The query string. + string query = 2 [(google.api.field_behavior) = REQUIRED]; + + // Determines whether a summary row will be returned. By default, summary row + // is not returned. If requested, the summary row will be sent in a response + // by itself after all other query results are returned. + google.ads.googleads.v3.enums.SummaryRowSettingEnum.SummaryRowSetting summary_row_setting = 3; +} + +// Response message for [GoogleAdsService.SearchStream][google.ads.googleads.v3.services.GoogleAdsService.SearchStream]. +message SearchGoogleAdsStreamResponse { + // The list of rows that matched the query. + repeated GoogleAdsRow results = 1; + + // FieldMask that represents what fields were requested by the user. + google.protobuf.FieldMask field_mask = 2; + + // Summary row that contains summary of metrics in results. + // Summary of metrics means aggregation of metrics across all results, + // here aggregation could be sum, average, rate, etc. + GoogleAdsRow summary_row = 3; +} + +// A returned row from the query. +message GoogleAdsRow { + // The account budget in the query. + google.ads.googleads.v3.resources.AccountBudget account_budget = 42; + + // The account budget proposal referenced in the query. + google.ads.googleads.v3.resources.AccountBudgetProposal account_budget_proposal = 43; + + // The ad group referenced in the query. + google.ads.googleads.v3.resources.AdGroup ad_group = 3; + + // The ad referenced in the query. + google.ads.googleads.v3.resources.AdGroupAd ad_group_ad = 16; + + // The ad group ad asset view in the query. + google.ads.googleads.v3.resources.AdGroupAdAssetView ad_group_ad_asset_view = 131; + + // The ad group ad label referenced in the query. + google.ads.googleads.v3.resources.AdGroupAdLabel ad_group_ad_label = 120; + + // The ad group audience view referenced in the query. + google.ads.googleads.v3.resources.AdGroupAudienceView ad_group_audience_view = 57; + + // The bid modifier referenced in the query. + google.ads.googleads.v3.resources.AdGroupBidModifier ad_group_bid_modifier = 24; + + // The criterion referenced in the query. + google.ads.googleads.v3.resources.AdGroupCriterion ad_group_criterion = 17; + + // The ad group criterion label referenced in the query. + google.ads.googleads.v3.resources.AdGroupCriterionLabel ad_group_criterion_label = 121; + + // The ad group criterion simulation referenced in the query. + google.ads.googleads.v3.resources.AdGroupCriterionSimulation ad_group_criterion_simulation = 110; + + // The ad group extension setting referenced in the query. + google.ads.googleads.v3.resources.AdGroupExtensionSetting ad_group_extension_setting = 112; + + // The ad group feed referenced in the query. + google.ads.googleads.v3.resources.AdGroupFeed ad_group_feed = 67; + + // The ad group label referenced in the query. + google.ads.googleads.v3.resources.AdGroupLabel ad_group_label = 115; + + // The ad group simulation referenced in the query. + google.ads.googleads.v3.resources.AdGroupSimulation ad_group_simulation = 107; + + // The ad parameter referenced in the query. + google.ads.googleads.v3.resources.AdParameter ad_parameter = 130; + + // The age range view referenced in the query. + google.ads.googleads.v3.resources.AgeRangeView age_range_view = 48; + + // The ad schedule view referenced in the query. + google.ads.googleads.v3.resources.AdScheduleView ad_schedule_view = 89; + + // The domain category referenced in the query. + google.ads.googleads.v3.resources.DomainCategory domain_category = 91; + + // The asset referenced in the query. + google.ads.googleads.v3.resources.Asset asset = 105; + + // The bidding strategy referenced in the query. + google.ads.googleads.v3.resources.BiddingStrategy bidding_strategy = 18; + + // The billing setup referenced in the query. + google.ads.googleads.v3.resources.BillingSetup billing_setup = 41; + + // The campaign budget referenced in the query. + google.ads.googleads.v3.resources.CampaignBudget campaign_budget = 19; + + // The campaign referenced in the query. + google.ads.googleads.v3.resources.Campaign campaign = 2; + + // The campaign audience view referenced in the query. + google.ads.googleads.v3.resources.CampaignAudienceView campaign_audience_view = 69; + + // The campaign bid modifier referenced in the query. + google.ads.googleads.v3.resources.CampaignBidModifier campaign_bid_modifier = 26; + + // The campaign criterion referenced in the query. + google.ads.googleads.v3.resources.CampaignCriterion campaign_criterion = 20; + + // The campaign criterion simulation referenced in the query. + google.ads.googleads.v3.resources.CampaignCriterionSimulation campaign_criterion_simulation = 111; + + // The campaign draft referenced in the query. + google.ads.googleads.v3.resources.CampaignDraft campaign_draft = 49; + + // The campaign experiment referenced in the query. + google.ads.googleads.v3.resources.CampaignExperiment campaign_experiment = 84; + + // The campaign extension setting referenced in the query. + google.ads.googleads.v3.resources.CampaignExtensionSetting campaign_extension_setting = 113; + + // The campaign feed referenced in the query. + google.ads.googleads.v3.resources.CampaignFeed campaign_feed = 63; + + // The campaign label referenced in the query. + google.ads.googleads.v3.resources.CampaignLabel campaign_label = 108; + + // Campaign Shared Set referenced in AWQL query. + google.ads.googleads.v3.resources.CampaignSharedSet campaign_shared_set = 30; + + // The carrier constant referenced in the query. + google.ads.googleads.v3.resources.CarrierConstant carrier_constant = 66; + + // The ChangeStatus referenced in the query. + google.ads.googleads.v3.resources.ChangeStatus change_status = 37; + + // The conversion action referenced in the query. + google.ads.googleads.v3.resources.ConversionAction conversion_action = 103; + + // The ClickView referenced in the query. + google.ads.googleads.v3.resources.ClickView click_view = 122; + + // The currency constant referenced in the query. + google.ads.googleads.v3.resources.CurrencyConstant currency_constant = 134; + + // The CustomInterest referenced in the query. + google.ads.googleads.v3.resources.CustomInterest custom_interest = 104; + + // The customer referenced in the query. + google.ads.googleads.v3.resources.Customer customer = 1; + + // The CustomerManagerLink referenced in the query. + google.ads.googleads.v3.resources.CustomerManagerLink customer_manager_link = 61; + + // The CustomerClientLink referenced in the query. + google.ads.googleads.v3.resources.CustomerClientLink customer_client_link = 62; + + // The CustomerClient referenced in the query. + google.ads.googleads.v3.resources.CustomerClient customer_client = 70; + + // The customer extension setting referenced in the query. + google.ads.googleads.v3.resources.CustomerExtensionSetting customer_extension_setting = 114; + + // The customer feed referenced in the query. + google.ads.googleads.v3.resources.CustomerFeed customer_feed = 64; + + // The customer label referenced in the query. + google.ads.googleads.v3.resources.CustomerLabel customer_label = 124; + + // The customer negative criterion referenced in the query. + google.ads.googleads.v3.resources.CustomerNegativeCriterion customer_negative_criterion = 88; + + // The detail placement view referenced in the query. + google.ads.googleads.v3.resources.DetailPlacementView detail_placement_view = 118; + + // The display keyword view referenced in the query. + google.ads.googleads.v3.resources.DisplayKeywordView display_keyword_view = 47; + + // The distance view referenced in the query. + google.ads.googleads.v3.resources.DistanceView distance_view = 132; + + // The dynamic search ads search term view referenced in the query. + google.ads.googleads.v3.resources.DynamicSearchAdsSearchTermView dynamic_search_ads_search_term_view = 106; + + // The expanded landing page view referenced in the query. + google.ads.googleads.v3.resources.ExpandedLandingPageView expanded_landing_page_view = 128; + + // The extension feed item referenced in the query. + google.ads.googleads.v3.resources.ExtensionFeedItem extension_feed_item = 85; + + // The feed referenced in the query. + google.ads.googleads.v3.resources.Feed feed = 46; + + // The feed item referenced in the query. + google.ads.googleads.v3.resources.FeedItem feed_item = 50; + + // The feed item target referenced in the query. + google.ads.googleads.v3.resources.FeedItemTarget feed_item_target = 116; + + // The feed mapping referenced in the query. + google.ads.googleads.v3.resources.FeedMapping feed_mapping = 58; + + // The feed placeholder view referenced in the query. + google.ads.googleads.v3.resources.FeedPlaceholderView feed_placeholder_view = 97; + + // The gender view referenced in the query. + google.ads.googleads.v3.resources.GenderView gender_view = 40; + + // The geo target constant referenced in the query. + google.ads.googleads.v3.resources.GeoTargetConstant geo_target_constant = 23; + + // The geographic view referenced in the query. + google.ads.googleads.v3.resources.GeographicView geographic_view = 125; + + // The group placement view referenced in the query. + google.ads.googleads.v3.resources.GroupPlacementView group_placement_view = 119; + + // The hotel group view referenced in the query. + google.ads.googleads.v3.resources.HotelGroupView hotel_group_view = 51; + + // The hotel performance view referenced in the query. + google.ads.googleads.v3.resources.HotelPerformanceView hotel_performance_view = 71; + + // The keyword view referenced in the query. + google.ads.googleads.v3.resources.KeywordView keyword_view = 21; + + // The keyword plan referenced in the query. + google.ads.googleads.v3.resources.KeywordPlan keyword_plan = 32; + + // The keyword plan campaign referenced in the query. + google.ads.googleads.v3.resources.KeywordPlanCampaign keyword_plan_campaign = 33; + + // The keyword plan negative keyword referenced in the query. + google.ads.googleads.v3.resources.KeywordPlanNegativeKeyword keyword_plan_negative_keyword = 34; + + // The keyword plan ad group referenced in the query. + google.ads.googleads.v3.resources.KeywordPlanAdGroup keyword_plan_ad_group = 35; + + // The keyword plan keyword referenced in the query. + google.ads.googleads.v3.resources.KeywordPlanKeyword keyword_plan_keyword = 36; + + // The label referenced in the query. + google.ads.googleads.v3.resources.Label label = 52; + + // The landing page view referenced in the query. + google.ads.googleads.v3.resources.LandingPageView landing_page_view = 126; + + // The language constant referenced in the query. + google.ads.googleads.v3.resources.LanguageConstant language_constant = 55; + + // The location view referenced in the query. + google.ads.googleads.v3.resources.LocationView location_view = 123; + + // The managed placement view referenced in the query. + google.ads.googleads.v3.resources.ManagedPlacementView managed_placement_view = 53; + + // The media file referenced in the query. + google.ads.googleads.v3.resources.MediaFile media_file = 90; + + // The mobile app category constant referenced in the query. + google.ads.googleads.v3.resources.MobileAppCategoryConstant mobile_app_category_constant = 87; + + // The mobile device constant referenced in the query. + google.ads.googleads.v3.resources.MobileDeviceConstant mobile_device_constant = 98; + + // The mutate job referenced in the query. + google.ads.googleads.v3.resources.MutateJob mutate_job = 127; + + // The offline user data job referenced in the query. + google.ads.googleads.v3.resources.OfflineUserDataJob offline_user_data_job = 137; + + // The operating system version constant referenced in the query. + google.ads.googleads.v3.resources.OperatingSystemVersionConstant operating_system_version_constant = 86; + + // The paid organic search term view referenced in the query. + google.ads.googleads.v3.resources.PaidOrganicSearchTermView paid_organic_search_term_view = 129; + + // The parental status view referenced in the query. + google.ads.googleads.v3.resources.ParentalStatusView parental_status_view = 45; + + // The Product Bidding Category referenced in the query. + google.ads.googleads.v3.resources.ProductBiddingCategoryConstant product_bidding_category_constant = 109; + + // The product group view referenced in the query. + google.ads.googleads.v3.resources.ProductGroupView product_group_view = 54; + + // The recommendation referenced in the query. + google.ads.googleads.v3.resources.Recommendation recommendation = 22; + + // The search term view referenced in the query. + google.ads.googleads.v3.resources.SearchTermView search_term_view = 68; + + // The shared set referenced in the query. + google.ads.googleads.v3.resources.SharedCriterion shared_criterion = 29; + + // The shared set referenced in the query. + google.ads.googleads.v3.resources.SharedSet shared_set = 27; + + // The shopping performance view referenced in the query. + google.ads.googleads.v3.resources.ShoppingPerformanceView shopping_performance_view = 117; + + // The topic view referenced in the query. + google.ads.googleads.v3.resources.TopicView topic_view = 44; + + // The user interest referenced in the query. + google.ads.googleads.v3.resources.UserInterest user_interest = 59; + + // The user list referenced in the query. + google.ads.googleads.v3.resources.UserList user_list = 38; + + // The user location view referenced in the query. + google.ads.googleads.v3.resources.UserLocationView user_location_view = 135; + + // The remarketing action referenced in the query. + google.ads.googleads.v3.resources.RemarketingAction remarketing_action = 60; + + // The topic constant referenced in the query. + google.ads.googleads.v3.resources.TopicConstant topic_constant = 31; + + // The video referenced in the query. + google.ads.googleads.v3.resources.Video video = 39; + + // The metrics. + google.ads.googleads.v3.common.Metrics metrics = 4; + + // The segments. + google.ads.googleads.v3.common.Segments segments = 102; +} + +// Request message for [GoogleAdsService.Mutate][google.ads.googleads.v3.services.GoogleAdsService.Mutate]. +message MutateGoogleAdsRequest { + // Required. The ID of the customer whose resources are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual resources. + repeated MutateOperation mutate_operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// Response message for [GoogleAdsService.Mutate][google.ads.googleads.v3.services.GoogleAdsService.Mutate]. +message MutateGoogleAdsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g., auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All responses for the mutate. + repeated MutateOperationResponse mutate_operation_responses = 1; +} + +// A single operation (create, update, remove) on a resource. +message MutateOperation { + // The mutate operation. + oneof operation { + // An ad group ad label mutate operation. + AdGroupAdLabelOperation ad_group_ad_label_operation = 17; + + // An ad group ad mutate operation. + AdGroupAdOperation ad_group_ad_operation = 1; + + // An ad group bid modifier mutate operation. + AdGroupBidModifierOperation ad_group_bid_modifier_operation = 2; + + // An ad group criterion label mutate operation. + AdGroupCriterionLabelOperation ad_group_criterion_label_operation = 18; + + // An ad group criterion mutate operation. + AdGroupCriterionOperation ad_group_criterion_operation = 3; + + // An ad group extension setting mutate operation. + AdGroupExtensionSettingOperation ad_group_extension_setting_operation = 19; + + // An ad group feed mutate operation. + AdGroupFeedOperation ad_group_feed_operation = 20; + + // An ad group label mutate operation. + AdGroupLabelOperation ad_group_label_operation = 21; + + // An ad group mutate operation. + AdGroupOperation ad_group_operation = 5; + + // An ad mutate operation. + AdOperation ad_operation = 49; + + // An ad parameter mutate operation. + AdParameterOperation ad_parameter_operation = 22; + + // An asset mutate operation. + AssetOperation asset_operation = 23; + + // A bidding strategy mutate operation. + BiddingStrategyOperation bidding_strategy_operation = 6; + + // A campaign bid modifier mutate operation. + CampaignBidModifierOperation campaign_bid_modifier_operation = 7; + + // A campaign budget mutate operation. + CampaignBudgetOperation campaign_budget_operation = 8; + + // A campaign criterion mutate operation. + CampaignCriterionOperation campaign_criterion_operation = 13; + + // A campaign draft mutate operation. + CampaignDraftOperation campaign_draft_operation = 24; + + // A campaign experiment mutate operation. + CampaignExperimentOperation campaign_experiment_operation = 25; + + // A campaign extension setting mutate operation. + CampaignExtensionSettingOperation campaign_extension_setting_operation = 26; + + // A campaign feed mutate operation. + CampaignFeedOperation campaign_feed_operation = 27; + + // A campaign label mutate operation. + CampaignLabelOperation campaign_label_operation = 28; + + // A campaign mutate operation. + CampaignOperation campaign_operation = 10; + + // A campaign shared set mutate operation. + CampaignSharedSetOperation campaign_shared_set_operation = 11; + + // A conversion action mutate operation. + ConversionActionOperation conversion_action_operation = 12; + + // A customer extension setting mutate operation. + CustomerExtensionSettingOperation customer_extension_setting_operation = 30; + + // A customer feed mutate operation. + CustomerFeedOperation customer_feed_operation = 31; + + // A customer label mutate operation. + CustomerLabelOperation customer_label_operation = 32; + + // A customer negative criterion mutate operation. + CustomerNegativeCriterionOperation customer_negative_criterion_operation = 34; + + // A customer mutate operation. + CustomerOperation customer_operation = 35; + + // An extension feed item mutate operation. + ExtensionFeedItemOperation extension_feed_item_operation = 36; + + // A feed item mutate operation. + FeedItemOperation feed_item_operation = 37; + + // A feed item target mutate operation. + FeedItemTargetOperation feed_item_target_operation = 38; + + // A feed mapping mutate operation. + FeedMappingOperation feed_mapping_operation = 39; + + // A feed mutate operation. + FeedOperation feed_operation = 40; + + // A label mutate operation. + LabelOperation label_operation = 41; + + // A media file mutate operation. + MediaFileOperation media_file_operation = 42; + + // A remarketing action mutate operation. + RemarketingActionOperation remarketing_action_operation = 43; + + // A shared criterion mutate operation. + SharedCriterionOperation shared_criterion_operation = 14; + + // A shared set mutate operation. + SharedSetOperation shared_set_operation = 15; + + // A user list mutate operation. + UserListOperation user_list_operation = 16; + } +} + +// Response message for the resource mutate. +message MutateOperationResponse { + // The mutate response. + oneof response { + // The result for the ad group ad label mutate. + MutateAdGroupAdLabelResult ad_group_ad_label_result = 17; + + // The result for the ad group ad mutate. + MutateAdGroupAdResult ad_group_ad_result = 1; + + // The result for the ad group bid modifier mutate. + MutateAdGroupBidModifierResult ad_group_bid_modifier_result = 2; + + // The result for the ad group criterion label mutate. + MutateAdGroupCriterionLabelResult ad_group_criterion_label_result = 18; + + // The result for the ad group criterion mutate. + MutateAdGroupCriterionResult ad_group_criterion_result = 3; + + // The result for the ad group extension setting mutate. + MutateAdGroupExtensionSettingResult ad_group_extension_setting_result = 19; + + // The result for the ad group feed mutate. + MutateAdGroupFeedResult ad_group_feed_result = 20; + + // The result for the ad group label mutate. + MutateAdGroupLabelResult ad_group_label_result = 21; + + // The result for the ad group mutate. + MutateAdGroupResult ad_group_result = 5; + + // The result for the ad parameter mutate. + MutateAdParameterResult ad_parameter_result = 22; + + // The result for the ad mutate. + MutateAdResult ad_result = 49; + + // The result for the asset mutate. + MutateAssetResult asset_result = 23; + + // The result for the bidding strategy mutate. + MutateBiddingStrategyResult bidding_strategy_result = 6; + + // The result for the campaign bid modifier mutate. + MutateCampaignBidModifierResult campaign_bid_modifier_result = 7; + + // The result for the campaign budget mutate. + MutateCampaignBudgetResult campaign_budget_result = 8; + + // The result for the campaign criterion mutate. + MutateCampaignCriterionResult campaign_criterion_result = 13; + + // The result for the campaign draft mutate. + MutateCampaignDraftResult campaign_draft_result = 24; + + // The result for the campaign experiment mutate. + MutateCampaignExperimentResult campaign_experiment_result = 25; + + // The result for the campaign extension setting mutate. + MutateCampaignExtensionSettingResult campaign_extension_setting_result = 26; + + // The result for the campaign feed mutate. + MutateCampaignFeedResult campaign_feed_result = 27; + + // The result for the campaign label mutate. + MutateCampaignLabelResult campaign_label_result = 28; + + // The result for the campaign mutate. + MutateCampaignResult campaign_result = 10; + + // The result for the campaign shared set mutate. + MutateCampaignSharedSetResult campaign_shared_set_result = 11; + + // The result for the conversion action mutate. + MutateConversionActionResult conversion_action_result = 12; + + // The result for the customer extension setting mutate. + MutateCustomerExtensionSettingResult customer_extension_setting_result = 30; + + // The result for the customer feed mutate. + MutateCustomerFeedResult customer_feed_result = 31; + + // The result for the customer label mutate. + MutateCustomerLabelResult customer_label_result = 32; + + // The result for the customer negative criterion mutate. + MutateCustomerNegativeCriteriaResult customer_negative_criterion_result = 34; + + // The result for the customer mutate. + MutateCustomerResult customer_result = 35; + + // The result for the extension feed item mutate. + MutateExtensionFeedItemResult extension_feed_item_result = 36; + + // The result for the feed item mutate. + MutateFeedItemResult feed_item_result = 37; + + // The result for the feed item target mutate. + MutateFeedItemTargetResult feed_item_target_result = 38; + + // The result for the feed mapping mutate. + MutateFeedMappingResult feed_mapping_result = 39; + + // The result for the feed mutate. + MutateFeedResult feed_result = 40; + + // The result for the label mutate. + MutateLabelResult label_result = 41; + + // The result for the media file mutate. + MutateMediaFileResult media_file_result = 42; + + // The result for the remarketing action mutate. + MutateRemarketingActionResult remarketing_action_result = 43; + + // The result for the shared criterion mutate. + MutateSharedCriterionResult shared_criterion_result = 14; + + // The result for the shared set mutate. + MutateSharedSetResult shared_set_result = 15; + + // The result for the user list mutate. + MutateUserListResult user_list_result = 16; + } +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/group_placement_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/group_placement_view_service.proto new file mode 100644 index 000000000..0f8a3a668 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/group_placement_view_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/group_placement_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "GroupPlacementViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Group Placement View service. + +// Service to fetch Group Placement views. +service GroupPlacementViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested Group Placement view in full detail. + rpc GetGroupPlacementView(GetGroupPlacementViewRequest) returns (google.ads.googleads.v3.resources.GroupPlacementView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/groupPlacementViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [GroupPlacementViewService.GetGroupPlacementView][google.ads.googleads.v3.services.GroupPlacementViewService.GetGroupPlacementView]. +message GetGroupPlacementViewRequest { + // Required. The resource name of the Group Placement view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/GroupPlacementView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/hotel_group_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/hotel_group_view_service.proto new file mode 100644 index 000000000..2354eff9a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/hotel_group_view_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/hotel_group_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "HotelGroupViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Hotel Group View Service. + +// Service to manage Hotel Group Views. +service HotelGroupViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested Hotel Group View in full detail. + rpc GetHotelGroupView(GetHotelGroupViewRequest) returns (google.ads.googleads.v3.resources.HotelGroupView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/hotelGroupViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [HotelGroupViewService.GetHotelGroupView][google.ads.googleads.v3.services.HotelGroupViewService.GetHotelGroupView]. +message GetHotelGroupViewRequest { + // Required. Resource name of the Hotel Group View to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/HotelGroupView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/hotel_performance_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/hotel_performance_view_service.proto new file mode 100644 index 000000000..c24eff83c --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/hotel_performance_view_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/hotel_performance_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "HotelPerformanceViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Hotel Performance View Service. + +// Service to manage Hotel Performance Views. +service HotelPerformanceViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested Hotel Performance View in full detail. + rpc GetHotelPerformanceView(GetHotelPerformanceViewRequest) returns (google.ads.googleads.v3.resources.HotelPerformanceView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/hotelPerformanceView}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [HotelPerformanceViewService.GetHotelPerformanceView][google.ads.googleads.v3.services.HotelPerformanceViewService.GetHotelPerformanceView]. +message GetHotelPerformanceViewRequest { + // Required. Resource name of the Hotel Performance View to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/HotelPerformanceView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/invoice_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/invoice_service.proto new file mode 100644 index 000000000..614cf93e9 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/invoice_service.proto @@ -0,0 +1,72 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/enums/month_of_year.proto"; +import "google/ads/googleads/v3/resources/invoice.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "InvoiceServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Invoice service. + +// A service to fetch invoices issued for a billing setup during a given month. +service InvoiceService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns all invoices associated with a billing setup, for a given month. + rpc ListInvoices(ListInvoicesRequest) returns (ListInvoicesResponse) { + option (google.api.http) = { + get: "/v3/customers/{customer_id=*}/invoices" + }; + option (google.api.method_signature) = "customer_id,billing_setup,issue_year,issue_month"; + } +} + +// Request message for fetching the invoices of a given billing setup that were +// issued during a given month. +message ListInvoicesRequest { + // Required. The ID of the customer to fetch invoices for. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The billing setup resource name of the requested invoices. + // + // `customers/{customer_id}/billingSetups/{billing_setup_id}` + string billing_setup = 2 [(google.api.field_behavior) = REQUIRED]; + + // Required. The issue year to retrieve invoices, in yyyy format. Only + // invoices issued in 2019 or later can be retrieved. + string issue_year = 3 [(google.api.field_behavior) = REQUIRED]; + + // Required. The issue month to retrieve invoices. + google.ads.googleads.v3.enums.MonthOfYearEnum.MonthOfYear issue_month = 4 [(google.api.field_behavior) = REQUIRED]; +} + +// Response message for [InvoiceService.ListInvoices][google.ads.googleads.v3.services.InvoiceService.ListInvoices]. +message ListInvoicesResponse { + // The list of invoices that match the billing setup and time period. + repeated google.ads.googleads.v3.resources.Invoice invoices = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/keyword_plan_ad_group_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/keyword_plan_ad_group_service.proto new file mode 100644 index 000000000..4a0d8a05d --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/keyword_plan_ad_group_service.proto @@ -0,0 +1,131 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/keyword_plan_ad_group.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "KeywordPlanAdGroupServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the keyword plan ad group service. + +// Service to manage Keyword Plan ad groups. +service KeywordPlanAdGroupService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested Keyword Plan ad group in full detail. + rpc GetKeywordPlanAdGroup(GetKeywordPlanAdGroupRequest) returns (google.ads.googleads.v3.resources.KeywordPlanAdGroup) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/keywordPlanAdGroups/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes Keyword Plan ad groups. Operation statuses are + // returned. + rpc MutateKeywordPlanAdGroups(MutateKeywordPlanAdGroupsRequest) returns (MutateKeywordPlanAdGroupsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/keywordPlanAdGroups:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [KeywordPlanAdGroupService.GetKeywordPlanAdGroup][google.ads.googleads.v3.services.KeywordPlanAdGroupService.GetKeywordPlanAdGroup]. +message GetKeywordPlanAdGroupRequest { + // Required. The resource name of the Keyword Plan ad group to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanAdGroup" + } + ]; +} + +// Request message for [KeywordPlanAdGroupService.MutateKeywordPlanAdGroups][google.ads.googleads.v3.services.KeywordPlanAdGroupService.MutateKeywordPlanAdGroups]. +message MutateKeywordPlanAdGroupsRequest { + // Required. The ID of the customer whose Keyword Plan ad groups are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual Keyword Plan ad groups. + repeated KeywordPlanAdGroupOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update, remove) on a Keyword Plan ad group. +message KeywordPlanAdGroupOperation { + // The FieldMask that determines which resource fields are modified in an + // update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new Keyword Plan + // ad group. + google.ads.googleads.v3.resources.KeywordPlanAdGroup create = 1; + + // Update operation: The Keyword Plan ad group is expected to have a valid + // resource name. + google.ads.googleads.v3.resources.KeywordPlanAdGroup update = 2; + + // Remove operation: A resource name for the removed Keyword Plan ad group + // is expected, in this format: + // + // `customers/{customer_id}/keywordPlanAdGroups/{kp_ad_group_id}` + string remove = 3; + } +} + +// Response message for a Keyword Plan ad group mutate. +message MutateKeywordPlanAdGroupsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateKeywordPlanAdGroupResult results = 2; +} + +// The result for the Keyword Plan ad group mutate. +message MutateKeywordPlanAdGroupResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/keyword_plan_campaign_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/keyword_plan_campaign_service.proto new file mode 100644 index 000000000..728a90c2b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/keyword_plan_campaign_service.proto @@ -0,0 +1,132 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/keyword_plan_campaign.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "KeywordPlanCampaignServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the keyword plan campaign service. + +// Service to manage Keyword Plan campaigns. +service KeywordPlanCampaignService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested Keyword Plan campaign in full detail. + rpc GetKeywordPlanCampaign(GetKeywordPlanCampaignRequest) returns (google.ads.googleads.v3.resources.KeywordPlanCampaign) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/keywordPlanCampaigns/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes Keyword Plan campaigns. Operation statuses are + // returned. + rpc MutateKeywordPlanCampaigns(MutateKeywordPlanCampaignsRequest) returns (MutateKeywordPlanCampaignsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/keywordPlanCampaigns:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [KeywordPlanCampaignService.GetKeywordPlanCampaign][google.ads.googleads.v3.services.KeywordPlanCampaignService.GetKeywordPlanCampaign]. +message GetKeywordPlanCampaignRequest { + // Required. The resource name of the Keyword Plan campaign to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanCampaign" + } + ]; +} + +// Request message for +// [KeywordPlanCampaignService.MutateKeywordPlanCampaigns][google.ads.googleads.v3.services.KeywordPlanCampaignService.MutateKeywordPlanCampaigns]. +message MutateKeywordPlanCampaignsRequest { + // Required. The ID of the customer whose Keyword Plan campaigns are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual Keyword Plan campaigns. + repeated KeywordPlanCampaignOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update, remove) on a Keyword Plan campaign. +message KeywordPlanCampaignOperation { + // The FieldMask that determines which resource fields are modified in an + // update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new Keyword Plan + // campaign. + google.ads.googleads.v3.resources.KeywordPlanCampaign create = 1; + + // Update operation: The Keyword Plan campaign is expected to have a valid + // resource name. + google.ads.googleads.v3.resources.KeywordPlanCampaign update = 2; + + // Remove operation: A resource name for the removed Keyword Plan campaign + // is expected, in this format: + // + // `customers/{customer_id}/keywordPlanCampaigns/{keywordPlan_campaign_id}` + string remove = 3; + } +} + +// Response message for a Keyword Plan campaign mutate. +message MutateKeywordPlanCampaignsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateKeywordPlanCampaignResult results = 2; +} + +// The result for the Keyword Plan campaign mutate. +message MutateKeywordPlanCampaignResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/keyword_plan_idea_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/keyword_plan_idea_service.proto new file mode 100644 index 000000000..b14ebdc4e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/keyword_plan_idea_service.proto @@ -0,0 +1,117 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/common/keyword_plan_common.proto"; +import "google/ads/googleads/v3/enums/keyword_plan_network.proto"; +import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/client.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "KeywordPlanIdeaServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the keyword plan idea service. + +// Service to generate keyword ideas. +service KeywordPlanIdeaService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns a list of keyword ideas. + rpc GenerateKeywordIdeas(GenerateKeywordIdeasRequest) returns (GenerateKeywordIdeaResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}:generateKeywordIdeas" + body: "*" + }; + } +} + +// Request message for [KeywordIdeaService.GenerateKeywordIdeas][]. +message GenerateKeywordIdeasRequest { + // The ID of the customer with the recommendation. + string customer_id = 1; + + // Required. The resource name of the language to target. + // Required + google.protobuf.StringValue language = 7 [(google.api.field_behavior) = REQUIRED]; + + // The resource names of the location to target. + // Max 10 + repeated google.protobuf.StringValue geo_target_constants = 8; + + // Targeting network. + google.ads.googleads.v3.enums.KeywordPlanNetworkEnum.KeywordPlanNetwork keyword_plan_network = 9; + + // The type of seed to generate keyword ideas. + oneof seed { + // A Keyword and a specific Url to generate ideas from + // e.g. cars, www.example.com/cars. + KeywordAndUrlSeed keyword_and_url_seed = 2; + + // A Keyword or phrase to generate ideas from, e.g. cars. + KeywordSeed keyword_seed = 3; + + // A specific url to generate ideas from, e.g. www.example.com/cars. + UrlSeed url_seed = 5; + } +} + +// Keyword And Url Seed +message KeywordAndUrlSeed { + // The URL to crawl in order to generate keyword ideas. + google.protobuf.StringValue url = 1; + + // Requires at least one keyword. + repeated google.protobuf.StringValue keywords = 2; +} + +// Keyword Seed +message KeywordSeed { + // Requires at least one keyword. + repeated google.protobuf.StringValue keywords = 1; +} + +// Url Seed +message UrlSeed { + // The URL to crawl in order to generate keyword ideas. + google.protobuf.StringValue url = 1; +} + +// Response message for [KeywordIdeaService.GenerateKeywordIdeas][]. +message GenerateKeywordIdeaResponse { + // Results of generating keyword ideas. + repeated GenerateKeywordIdeaResult results = 1; +} + +// The result of generating keyword ideas. +message GenerateKeywordIdeaResult { + // Text of the keyword idea. + // As in Keyword Plan historical metrics, this text may not be an actual + // keyword, but the canonical form of multiple keywords. + // See KeywordPlanKeywordHistoricalMetrics message in KeywordPlanService. + google.protobuf.StringValue text = 2; + + // The historical metrics for the keyword + google.ads.googleads.v3.common.KeywordPlanHistoricalMetrics keyword_idea_metrics = 3; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/keyword_plan_keyword_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/keyword_plan_keyword_service.proto new file mode 100644 index 000000000..5806273ef --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/keyword_plan_keyword_service.proto @@ -0,0 +1,131 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/keyword_plan_keyword.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "KeywordPlanKeywordServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the keyword plan keyword service. + +// Service to manage Keyword Plan ad group keywords. +service KeywordPlanKeywordService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested Keyword Plan keyword in full detail. + rpc GetKeywordPlanKeyword(GetKeywordPlanKeywordRequest) returns (google.ads.googleads.v3.resources.KeywordPlanKeyword) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/keywordPlanKeywords/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes Keyword Plan keywords. Operation statuses are + // returned. + rpc MutateKeywordPlanKeywords(MutateKeywordPlanKeywordsRequest) returns (MutateKeywordPlanKeywordsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/keywordPlanKeywords:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [KeywordPlanKeywordService.GetKeywordPlanKeyword][google.ads.googleads.v3.services.KeywordPlanKeywordService.GetKeywordPlanKeyword]. +message GetKeywordPlanKeywordRequest { + // Required. The resource name of the ad group keyword to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanKeyword" + } + ]; +} + +// Request message for [KeywordPlanKeywordService.MutateKeywordPlanKeywords][google.ads.googleads.v3.services.KeywordPlanKeywordService.MutateKeywordPlanKeywords]. +message MutateKeywordPlanKeywordsRequest { + // Required. The ID of the customer whose Keyword Plan keywords are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual Keyword Plan keywords. + repeated KeywordPlanKeywordOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update, remove) on a Keyword Plan keyword. +message KeywordPlanKeywordOperation { + // The FieldMask that determines which resource fields are modified in an + // update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new Keyword Plan + // ad group keyword. + google.ads.googleads.v3.resources.KeywordPlanKeyword create = 1; + + // Update operation: The Keyword Plan keyword is expected to have a valid + // resource name. + google.ads.googleads.v3.resources.KeywordPlanKeyword update = 2; + + // Remove operation: A resource name for the removed Keyword Plan keyword is + // expected, in this format: + // + // `customers/{customer_id}/keywordPlanKeywords/{kp_ad_group_keyword_id}` + string remove = 3; + } +} + +// Response message for a Keyword Plan keyword mutate. +message MutateKeywordPlanKeywordsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateKeywordPlanKeywordResult results = 2; +} + +// The result for the Keyword Plan keyword mutate. +message MutateKeywordPlanKeywordResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/keyword_plan_negative_keyword_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/keyword_plan_negative_keyword_service.proto new file mode 100644 index 000000000..b40bbe457 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/keyword_plan_negative_keyword_service.proto @@ -0,0 +1,135 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/keyword_plan_negative_keyword.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "KeywordPlanNegativeKeywordServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the keyword plan negative keyword service. + +// Service to manage Keyword Plan negative keywords. +service KeywordPlanNegativeKeywordService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested plan in full detail. + rpc GetKeywordPlanNegativeKeyword(GetKeywordPlanNegativeKeywordRequest) returns (google.ads.googleads.v3.resources.KeywordPlanNegativeKeyword) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/keywordPlanNegativeKeywords/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes Keyword Plan negative keywords. Operation + // statuses are returned. + rpc MutateKeywordPlanNegativeKeywords(MutateKeywordPlanNegativeKeywordsRequest) returns (MutateKeywordPlanNegativeKeywordsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/keywordPlanNegativeKeywords:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for +// [KeywordPlanNegativeKeywordService.GetKeywordPlanNegativeKeyword][google.ads.googleads.v3.services.KeywordPlanNegativeKeywordService.GetKeywordPlanNegativeKeyword]. +message GetKeywordPlanNegativeKeywordRequest { + // Required. The resource name of the plan to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlanNegativeKeyword" + } + ]; +} + +// Request message for +// [KeywordPlanNegativeKeywordService.MutateKeywordPlanNegativeKeywords][google.ads.googleads.v3.services.KeywordPlanNegativeKeywordService.MutateKeywordPlanNegativeKeywords]. +message MutateKeywordPlanNegativeKeywordsRequest { + // Required. The ID of the customer whose negative keywords are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual Keyword Plan negative + // keywords. + repeated KeywordPlanNegativeKeywordOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update, remove) on a Keyword Plan negative +// keyword. +message KeywordPlanNegativeKeywordOperation { + // The FieldMask that determines which resource fields are modified in an + // update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new Keyword Plan + // negative keyword. + google.ads.googleads.v3.resources.KeywordPlanNegativeKeyword create = 1; + + // Update operation: The Keyword Plan negative keyword expected to have a + // valid resource name. + google.ads.googleads.v3.resources.KeywordPlanNegativeKeyword update = 2; + + // Remove operation: A resource name for the removed Keyword Plan negative + // keywords expected in this format: + // + // `customers/{customer_id}/keywordPlanNegativeKeywords/{kp_negative_keyword_id}` + string remove = 3; + } +} + +// Response message for a Keyword Plan negative keyword mutate. +message MutateKeywordPlanNegativeKeywordsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateKeywordPlanNegativeKeywordResult results = 2; +} + +// The result for the Keyword Plan negative keyword mutate. +message MutateKeywordPlanNegativeKeywordResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/keyword_plan_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/keyword_plan_service.proto new file mode 100644 index 000000000..7d963347d --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/keyword_plan_service.proto @@ -0,0 +1,249 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/common/keyword_plan_common.proto"; +import "google/ads/googleads/v3/resources/keyword_plan.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/protobuf/wrappers.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "KeywordPlanServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the keyword plan service. + +// Service to manage keyword plans. +service KeywordPlanService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested plan in full detail. + rpc GetKeywordPlan(GetKeywordPlanRequest) returns (google.ads.googleads.v3.resources.KeywordPlan) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/keywordPlans/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes keyword plans. Operation statuses are + // returned. + rpc MutateKeywordPlans(MutateKeywordPlansRequest) returns (MutateKeywordPlansResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/keywordPlans:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } + + // Returns the requested Keyword Plan forecasts. + rpc GenerateForecastMetrics(GenerateForecastMetricsRequest) returns (GenerateForecastMetricsResponse) { + option (google.api.http) = { + post: "/v3/{keyword_plan=customers/*/keywordPlans/*}:generateForecastMetrics" + body: "*" + }; + option (google.api.method_signature) = "keyword_plan"; + } + + // Returns the requested Keyword Plan historical metrics. + rpc GenerateHistoricalMetrics(GenerateHistoricalMetricsRequest) returns (GenerateHistoricalMetricsResponse) { + option (google.api.http) = { + post: "/v3/{keyword_plan=customers/*/keywordPlans/*}:generateHistoricalMetrics" + body: "*" + }; + option (google.api.method_signature) = "keyword_plan"; + } +} + +// Request message for [KeywordPlanService.GetKeywordPlan][google.ads.googleads.v3.services.KeywordPlanService.GetKeywordPlan]. +message GetKeywordPlanRequest { + // Required. The resource name of the plan to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordPlan" + } + ]; +} + +// Request message for [KeywordPlanService.MutateKeywordPlans][google.ads.googleads.v3.services.KeywordPlanService.MutateKeywordPlans]. +message MutateKeywordPlansRequest { + // Required. The ID of the customer whose keyword plans are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual keyword plans. + repeated KeywordPlanOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update, remove) on a keyword plan. +message KeywordPlanOperation { + // The FieldMask that determines which resource fields are modified in an + // update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new keyword plan. + google.ads.googleads.v3.resources.KeywordPlan create = 1; + + // Update operation: The keyword plan is expected to have a valid resource + // name. + google.ads.googleads.v3.resources.KeywordPlan update = 2; + + // Remove operation: A resource name for the removed keyword plan is + // expected in this format: + // + // `customers/{customer_id}/keywordPlans/{keyword_plan_id}` + string remove = 3; + } +} + +// Response message for a keyword plan mutate. +message MutateKeywordPlansResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateKeywordPlansResult results = 2; +} + +// The result for the keyword plan mutate. +message MutateKeywordPlansResult { + // Returned for successful operations. + string resource_name = 1; +} + +// Request message for [KeywordPlanService.GenerateForecastMetrics][google.ads.googleads.v3.services.KeywordPlanService.GenerateForecastMetrics]. +message GenerateForecastMetricsRequest { + // Required. The resource name of the keyword plan to be forecasted. + string keyword_plan = 1 [(google.api.field_behavior) = REQUIRED]; +} + +// Response message for [KeywordPlanService.GenerateForecastMetrics][google.ads.googleads.v3.services.KeywordPlanService.GenerateForecastMetrics]. +message GenerateForecastMetricsResponse { + // List of campaign forecasts. + // One maximum. + repeated KeywordPlanCampaignForecast campaign_forecasts = 1; + + // List of ad group forecasts. + repeated KeywordPlanAdGroupForecast ad_group_forecasts = 2; + + // List of keyword forecasts. + repeated KeywordPlanKeywordForecast keyword_forecasts = 3; +} + +// A campaign forecast. +message KeywordPlanCampaignForecast { + // The resource name of the Keyword Plan campaign related to the forecast. + // + // `customers/{customer_id}/keywordPlanCampaigns/{keyword_plan_campaign_id}` + google.protobuf.StringValue keyword_plan_campaign = 1; + + // The forecast for the Keyword Plan campaign. + ForecastMetrics campaign_forecast = 2; +} + +// An ad group forecast. +message KeywordPlanAdGroupForecast { + // The resource name of the Keyword Plan ad group related to the forecast. + // + // `customers/{customer_id}/keywordPlanAdGroups/{keyword_plan_ad_group_id}` + google.protobuf.StringValue keyword_plan_ad_group = 1; + + // The forecast for the Keyword Plan ad group. + ForecastMetrics ad_group_forecast = 2; +} + +// A keyword forecast. +message KeywordPlanKeywordForecast { + // The resource name of the Keyword Plan keyword related to the forecast. + // + // `customers/{customer_id}/keywordPlanAdGroupKeywords/{keyword_plan_ad_group_keyword_id}` + google.protobuf.StringValue keyword_plan_ad_group_keyword = 1; + + // The forecast for the Keyword Plan keyword. + ForecastMetrics keyword_forecast = 2; +} + +// Forecast metrics. +message ForecastMetrics { + // Impressions + google.protobuf.DoubleValue impressions = 1; + + // Ctr + google.protobuf.DoubleValue ctr = 2; + + // AVG cpc + google.protobuf.Int64Value average_cpc = 3; + + // Clicks + google.protobuf.DoubleValue clicks = 5; + + // Cost + google.protobuf.Int64Value cost_micros = 6; +} + +// Request message for [KeywordPlanService.GenerateHistoricalMetrics][google.ads.googleads.v3.services.KeywordPlanService.GenerateHistoricalMetrics]. +message GenerateHistoricalMetricsRequest { + // Required. The resource name of the keyword plan of which historical metrics are + // requested. + string keyword_plan = 1 [(google.api.field_behavior) = REQUIRED]; +} + +// Response message for [KeywordPlanService.GenerateHistoricalMetrics][google.ads.googleads.v3.services.KeywordPlanService.GenerateHistoricalMetrics]. +message GenerateHistoricalMetricsResponse { + // List of keyword historical metrics. + repeated KeywordPlanKeywordHistoricalMetrics metrics = 1; +} + +// A keyword historical metrics. +message KeywordPlanKeywordHistoricalMetrics { + // The text of the query associated with one or more ad_group_keywords in the + // plan. + // + // Note that we de-dupe your keywords list, eliminating close variants before + // returning the plan's keywords as text. For example, if your plan originally + // contained the keywords 'car' and 'cars', the returned search query will + // only contain 'car'. + google.protobuf.StringValue search_query = 1; + + // The historical metrics for the query associated with one or more + // ad_group_keywords in the plan. + google.ads.googleads.v3.common.KeywordPlanHistoricalMetrics keyword_metrics = 2; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/keyword_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/keyword_view_service.proto new file mode 100644 index 000000000..da07da190 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/keyword_view_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/keyword_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "KeywordViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Keyword View service. + +// Service to manage keyword views. +service KeywordViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested keyword view in full detail. + rpc GetKeywordView(GetKeywordViewRequest) returns (google.ads.googleads.v3.resources.KeywordView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/keywordViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [KeywordViewService.GetKeywordView][google.ads.googleads.v3.services.KeywordViewService.GetKeywordView]. +message GetKeywordViewRequest { + // Required. The resource name of the keyword view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/KeywordView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/label_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/label_service.proto new file mode 100644 index 000000000..f0a341314 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/label_service.proto @@ -0,0 +1,125 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/label.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "LabelServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Service to manage labels. +service LabelService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested label in full detail. + rpc GetLabel(GetLabelRequest) returns (google.ads.googleads.v3.resources.Label) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/labels/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes labels. Operation statuses are returned. + rpc MutateLabels(MutateLabelsRequest) returns (MutateLabelsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/labels:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [LabelService.GetLabel][google.ads.googleads.v3.services.LabelService.GetLabel]. +message GetLabelRequest { + // Required. The resource name of the label to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Label" + } + ]; +} + +// Request message for [LabelService.MutateLabels][google.ads.googleads.v3.services.LabelService.MutateLabels]. +message MutateLabelsRequest { + // Required. ID of the customer whose labels are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on labels. + repeated LabelOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, remove, update) on a label. +message LabelOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new label. + google.ads.googleads.v3.resources.Label create = 1; + + // Update operation: The label is expected to have a valid resource name. + google.ads.googleads.v3.resources.Label update = 2; + + // Remove operation: A resource name for the label being removed, in + // this format: + // + // `customers/{customer_id}/labels/{label_id}` + string remove = 3; + } +} + +// Response message for a labels mutate. +message MutateLabelsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateLabelResult results = 2; +} + +// The result for a label mutate. +message MutateLabelResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/landing_page_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/landing_page_view_service.proto new file mode 100644 index 000000000..8ea75bdf3 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/landing_page_view_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/landing_page_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "LandingPageViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the landing page view service. + +// Service to fetch landing page views. +service LandingPageViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested landing page view in full detail. + rpc GetLandingPageView(GetLandingPageViewRequest) returns (google.ads.googleads.v3.resources.LandingPageView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/landingPageViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [LandingPageViewService.GetLandingPageView][google.ads.googleads.v3.services.LandingPageViewService.GetLandingPageView]. +message GetLandingPageViewRequest { + // Required. The resource name of the landing page view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/LandingPageView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/language_constant_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/language_constant_service.proto new file mode 100644 index 000000000..f1bb58598 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/language_constant_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/language_constant.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "LanguageConstantServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the language constant service. + +// Service to fetch language constants. +service LanguageConstantService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested language constant. + rpc GetLanguageConstant(GetLanguageConstantRequest) returns (google.ads.googleads.v3.resources.LanguageConstant) { + option (google.api.http) = { + get: "/v3/{resource_name=languageConstants/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [LanguageConstantService.GetLanguageConstant][google.ads.googleads.v3.services.LanguageConstantService.GetLanguageConstant]. +message GetLanguageConstantRequest { + // Required. Resource name of the language constant to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/LanguageConstant" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/location_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/location_view_service.proto new file mode 100644 index 000000000..cb8d8602f --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/location_view_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/location_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "LocationViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Location View service. + +// Service to fetch location views. +service LocationViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested location view in full detail. + rpc GetLocationView(GetLocationViewRequest) returns (google.ads.googleads.v3.resources.LocationView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/locationViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [LocationViewService.GetLocationView][google.ads.googleads.v3.services.LocationViewService.GetLocationView]. +message GetLocationViewRequest { + // Required. The resource name of the location view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/LocationView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/managed_placement_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/managed_placement_view_service.proto new file mode 100644 index 000000000..cb8c938dc --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/managed_placement_view_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/managed_placement_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "ManagedPlacementViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Managed Placement View service. + +// Service to manage Managed Placement views. +service ManagedPlacementViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested Managed Placement view in full detail. + rpc GetManagedPlacementView(GetManagedPlacementViewRequest) returns (google.ads.googleads.v3.resources.ManagedPlacementView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/managedPlacementViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [ManagedPlacementViewService.GetManagedPlacementView][google.ads.googleads.v3.services.ManagedPlacementViewService.GetManagedPlacementView]. +message GetManagedPlacementViewRequest { + // Required. The resource name of the Managed Placement View to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ManagedPlacementView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/media_file_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/media_file_service.proto new file mode 100644 index 000000000..54e27bea9 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/media_file_service.proto @@ -0,0 +1,114 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/media_file.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "MediaFileServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Media File service. + +// Service to manage media files. +service MediaFileService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested media file in full detail. + rpc GetMediaFile(GetMediaFileRequest) returns (google.ads.googleads.v3.resources.MediaFile) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/mediaFiles/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates media files. Operation statuses are returned. + rpc MutateMediaFiles(MutateMediaFilesRequest) returns (MutateMediaFilesResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/mediaFiles:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [MediaFileService.GetMediaFile][google.ads.googleads.v3.services.MediaFileService.GetMediaFile] +message GetMediaFileRequest { + // Required. The resource name of the media file to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MediaFile" + } + ]; +} + +// Request message for [MediaFileService.MutateMediaFiles][google.ads.googleads.v3.services.MediaFileService.MutateMediaFiles] +message MutateMediaFilesRequest { + // Required. The ID of the customer whose media files are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual media file. + repeated MediaFileOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation to create media file. +message MediaFileOperation { + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new media file. + google.ads.googleads.v3.resources.MediaFile create = 1; + } +} + +// Response message for a media file mutate. +message MutateMediaFilesResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateMediaFileResult results = 2; +} + +// The result for the media file mutate. +message MutateMediaFileResult { + // The resource name returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/merchant_center_link_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/merchant_center_link_service.proto new file mode 100644 index 000000000..5a5e80d30 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/merchant_center_link_service.proto @@ -0,0 +1,130 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/merchant_center_link.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "MerchantCenterLinkServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the MerchantCenterLink service. + +// This service allows management of links between Google Ads and Google +// Merchant Center. +service MerchantCenterLinkService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns Merchant Center links available for this customer. + rpc ListMerchantCenterLinks(ListMerchantCenterLinksRequest) returns (ListMerchantCenterLinksResponse) { + option (google.api.http) = { + get: "/v3/customers/{customer_id=*}/merchantCenterLinks" + }; + option (google.api.method_signature) = "customer_id"; + } + + // Returns the Merchant Center link in full detail. + rpc GetMerchantCenterLink(GetMerchantCenterLinkRequest) returns (google.ads.googleads.v3.resources.MerchantCenterLink) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/merchantCenterLinks/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Updates status or removes a Merchant Center link. + rpc MutateMerchantCenterLink(MutateMerchantCenterLinkRequest) returns (MutateMerchantCenterLinkResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/merchantCenterLinks:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operation"; + } +} + +// Request message for [MerchantCenterLinkService.ListMerchantCenterLinks][google.ads.googleads.v3.services.MerchantCenterLinkService.ListMerchantCenterLinks]. +message ListMerchantCenterLinksRequest { + // Required. The ID of the customer onto which to apply the Merchant Center link list + // operation. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; +} + +// Response message for [MerchantCenterLinkService.ListMerchantCenterLinks][google.ads.googleads.v3.services.MerchantCenterLinkService.ListMerchantCenterLinks]. +message ListMerchantCenterLinksResponse { + // Merchant Center links available for the requested customer + repeated google.ads.googleads.v3.resources.MerchantCenterLink merchant_center_links = 1; +} + +// Request message for [MerchantCenterLinkService.GetMerchantCenterLink][google.ads.googleads.v3.services.MerchantCenterLinkService.GetMerchantCenterLink]. +message GetMerchantCenterLinkRequest { + // Required. Resource name of the Merchant Center link. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MerchantCenterLink" + } + ]; +} + +// Request message for [MerchantCenterLinkService.MutateMerchantCenterLink][google.ads.googleads.v3.services.MerchantCenterLinkService.MutateMerchantCenterLink]. +message MutateMerchantCenterLinkRequest { + // Required. The ID of the customer being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The operation to perform on the link + MerchantCenterLinkOperation operation = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// A single update on a Merchant Center link. +message MerchantCenterLinkOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 3; + + // The operation to perform + oneof operation { + // Update operation: The merchant center link is expected to have a valid + // resource name. + google.ads.googleads.v3.resources.MerchantCenterLink update = 1; + + // Remove operation: A resource name for the removed merchant center link is + // expected, in this format: + // + // `customers/{customer_id}/merchantCenterLinks/{merchant_center_id}` + string remove = 2; + } +} + +// Response message for Merchant Center link mutate. +message MutateMerchantCenterLinkResponse { + // Result for the mutate. + MutateMerchantCenterLinkResult result = 2; +} + +// The result for the Merchant Center link mutate. +message MutateMerchantCenterLinkResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/mobile_app_category_constant_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/mobile_app_category_constant_service.proto new file mode 100644 index 000000000..e40489eaa --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/mobile_app_category_constant_service.proto @@ -0,0 +1,57 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/mobile_app_category_constant.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "MobileAppCategoryConstantServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Service to fetch mobile app category constants. +service MobileAppCategoryConstantService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested mobile app category constant. + rpc GetMobileAppCategoryConstant(GetMobileAppCategoryConstantRequest) returns (google.ads.googleads.v3.resources.MobileAppCategoryConstant) { + option (google.api.http) = { + get: "/v3/{resource_name=mobileAppCategoryConstants/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for +// [MobileAppCategoryConstantService.GetMobileAppCategoryConstant][google.ads.googleads.v3.services.MobileAppCategoryConstantService.GetMobileAppCategoryConstant]. +message GetMobileAppCategoryConstantRequest { + // Required. Resource name of the mobile app category constant to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MobileAppCategoryConstant" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/mobile_device_constant_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/mobile_device_constant_service.proto new file mode 100644 index 000000000..ce3297ef3 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/mobile_device_constant_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/mobile_device_constant.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "MobileDeviceConstantServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the mobile device constant service. + +// Service to fetch mobile device constants. +service MobileDeviceConstantService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested mobile device constant in full detail. + rpc GetMobileDeviceConstant(GetMobileDeviceConstantRequest) returns (google.ads.googleads.v3.resources.MobileDeviceConstant) { + option (google.api.http) = { + get: "/v3/{resource_name=mobileDeviceConstants/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [MobileDeviceConstantService.GetMobileDeviceConstant][google.ads.googleads.v3.services.MobileDeviceConstantService.GetMobileDeviceConstant]. +message GetMobileDeviceConstantRequest { + // Required. Resource name of the mobile device to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MobileDeviceConstant" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/mutate_job_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/mutate_job_service.proto new file mode 100644 index 000000000..d8f6583ec --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/mutate_job_service.proto @@ -0,0 +1,217 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/mutate_job.proto"; +import "google/ads/googleads/v3/services/google_ads_service.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/longrunning/operations.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "MutateJobServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the MutateJobService. + +// Service to manage mutate jobs. +service MutateJobService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Creates a mutate job. + rpc CreateMutateJob(CreateMutateJobRequest) returns (CreateMutateJobResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/mutateJobs:create" + body: "*" + }; + option (google.api.method_signature) = "customer_id"; + } + + // Returns the mutate job. + rpc GetMutateJob(GetMutateJobRequest) returns (google.ads.googleads.v3.resources.MutateJob) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/mutateJobs/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Returns the results of the mutate job. The job must be done. + // Supports standard list paging. + rpc ListMutateJobResults(ListMutateJobResultsRequest) returns (ListMutateJobResultsResponse) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/mutateJobs/*}:listResults" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Runs the mutate job. + // + // The Operation.metadata field type is MutateJobMetadata. When finished, the + // long running operation will not contain errors or a response. Instead, use + // ListMutateJobResults to get the results of the job. + rpc RunMutateJob(RunMutateJobRequest) returns (google.longrunning.Operation) { + option (google.api.http) = { + post: "/v3/{resource_name=customers/*/mutateJobs/*}:run" + body: "*" + }; + option (google.api.method_signature) = "resource_name"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "google.ads.googleads.v3.resources.MutateJob.MutateJobMetadata" + }; + } + + // Add operations to the mutate job. + rpc AddMutateJobOperations(AddMutateJobOperationsRequest) returns (AddMutateJobOperationsResponse) { + option (google.api.http) = { + post: "/v3/{resource_name=customers/*/mutateJobs/*}:addOperations" + body: "*" + }; + option (google.api.method_signature) = "resource_name,sequence_token,mutate_operations"; + option (google.api.method_signature) = "resource_name,mutate_operations"; + } +} + +// Request message for [MutateJobService.CreateMutateJobRequest][] +message CreateMutateJobRequest { + // Required. The ID of the customer for which to create a mutate job. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; +} + +// Response message for [MutateJobService.CreateMutateJobResponse][] +message CreateMutateJobResponse { + // The resource name of the MutateJob. + string resource_name = 1; +} + +// Request message for [MutateJobService.GetMutateJob][google.ads.googleads.v3.services.MutateJobService.GetMutateJob] +message GetMutateJobRequest { + // Required. The resource name of the MutateJob to get. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MutateJob" + } + ]; +} + +// Request message for [MutateJobService.RunMutateJob][google.ads.googleads.v3.services.MutateJobService.RunMutateJob] +message RunMutateJobRequest { + // Required. The resource name of the MutateJob to run. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MutateJob" + } + ]; +} + +// Request message for [MutateJobService.AddMutateJobOperations][google.ads.googleads.v3.services.MutateJobService.AddMutateJobOperations] +message AddMutateJobOperationsRequest { + // Required. The resource name of the MutateJob. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MutateJob" + } + ]; + + // A token used to enforce sequencing. + // + // The first AddMutateJobOperations request for a MutateJob should not set + // sequence_token. Subsequent requests must set sequence_token to the value of + // next_sequence_token received in the previous AddMutateJobOperations + // response. + string sequence_token = 2; + + // Required. The list of mutates being added. + // + // Operations can use negative integers as temp ids to signify dependencies + // between entities created in this MutateJob. For example, a customer with + // id = 1234 can create a campaign and an ad group in that same campaign by + // creating a campaign in the first operation with the resource name + // explicitly set to "customers/1234/campaigns/-1", and creating an ad group + // in the second operation with the campaign field also set to + // "customers/1234/campaigns/-1". + repeated MutateOperation mutate_operations = 3 [(google.api.field_behavior) = REQUIRED]; +} + +// Response message for [MutateJobService.AddMutateJobOperations][google.ads.googleads.v3.services.MutateJobService.AddMutateJobOperations] +message AddMutateJobOperationsResponse { + // The total number of operations added so far for this job. + int64 total_operations = 1; + + // The sequence token to be used when calling AddMutateJobOperations again if + // more operations need to be added. The next AddMutateJobOperations request + // must set the sequence_token field to the value of this field. + string next_sequence_token = 2; +} + +// Request message for [MutateJobService.ListMutateJobResults][google.ads.googleads.v3.services.MutateJobService.ListMutateJobResults]. +message ListMutateJobResultsRequest { + // Required. The resource name of the MutateJob whose results are being listed. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/MutateJob" + } + ]; + + // Token of the page to retrieve. If not specified, the first + // page of results will be returned. Use the value obtained from + // `next_page_token` in the previous response in order to request + // the next page of results. + string page_token = 2; + + // Number of elements to retrieve in a single page. + // When a page request is too large, the server may decide to + // further limit the number of returned resources. + int32 page_size = 3; +} + +// Response message for [MutateJobService.ListMutateJobResults][google.ads.googleads.v3.services.MutateJobService.ListMutateJobResults]. +message ListMutateJobResultsResponse { + // The list of rows that matched the query. + repeated MutateJobResult results = 1; + + // Pagination token used to retrieve the next page of results. + // Pass the content of this string as the `page_token` attribute of + // the next request. `next_page_token` is not returned for the last + // page. + string next_page_token = 2; +} + +// MutateJob result. +message MutateJobResult { + // Index of the mutate operation. + int64 operation_index = 1; + + // Response for the mutate. + // May be empty if errors occurred. + MutateOperationResponse mutate_operation_response = 2; + + // Details of the errors when processing the operation. + google.rpc.Status status = 3; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/offline_user_data_job_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/offline_user_data_job_service.proto new file mode 100644 index 000000000..31b4754a9 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/offline_user_data_job_service.proto @@ -0,0 +1,170 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/common/offline_user_data.proto"; +import "google/ads/googleads/v3/resources/offline_user_data_job.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/longrunning/operations.proto"; +import "google/protobuf/wrappers.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "OfflineUserDataJobServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the OfflineUserDataJobService. + +// Service to manage offline user data jobs. +service OfflineUserDataJobService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Creates an offline user data job. + rpc CreateOfflineUserDataJob(CreateOfflineUserDataJobRequest) returns (CreateOfflineUserDataJobResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/offlineUserDataJobs:create" + body: "*" + }; + option (google.api.method_signature) = "customer_id,job"; + } + + // Returns the offline user data job. + rpc GetOfflineUserDataJob(GetOfflineUserDataJobRequest) returns (google.ads.googleads.v3.resources.OfflineUserDataJob) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/offlineUserDataJobs/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Adds operations to the offline user data job. + rpc AddOfflineUserDataJobOperations(AddOfflineUserDataJobOperationsRequest) returns (AddOfflineUserDataJobOperationsResponse) { + option (google.api.http) = { + post: "/v3/{resource_name=customers/*/offlineUserDataJobs/*}:addOperations" + body: "*" + }; + option (google.api.method_signature) = "resource_name,operations"; + } + + // Runs the offline user data job. + // + // When finished, the long running operation will contain the processing + // result or failure information, if any. + rpc RunOfflineUserDataJob(RunOfflineUserDataJobRequest) returns (google.longrunning.Operation) { + option (google.api.http) = { + post: "/v3/{resource_name=customers/*/offlineUserDataJobs/*}:run" + body: "*" + }; + option (google.api.method_signature) = "resource_name"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "google.protobuf.Empty" + }; + } +} + +// Request message for +// [OfflineUserDataJobService.CreateOfflineUserDataJobRequest][] +message CreateOfflineUserDataJobRequest { + // Required. The ID of the customer for which to create an offline user data job. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The offline user data job to be created. + google.ads.googleads.v3.resources.OfflineUserDataJob job = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// Response message for +// [OfflineUserDataJobService.CreateOfflineUserDataJobResponse][] +message CreateOfflineUserDataJobResponse { + // The resource name of the OfflineUserDataJob. + string resource_name = 1; +} + +// Request message for [OfflineUserDataJobService.GetOfflineUserDataJob][google.ads.googleads.v3.services.OfflineUserDataJobService.GetOfflineUserDataJob] +message GetOfflineUserDataJobRequest { + // Required. The resource name of the OfflineUserDataJob to get. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/OfflineUserDataJob" + } + ]; +} + +// Request message for [OfflineUserDataJobService.RunOfflineUserDataJob][google.ads.googleads.v3.services.OfflineUserDataJobService.RunOfflineUserDataJob] +message RunOfflineUserDataJobRequest { + // Required. The resource name of the OfflineUserDataJob to run. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/OfflineUserDataJob" + } + ]; +} + +// Request message for +// [OfflineUserDataJobService.AddOfflineUserDataJobOperations][google.ads.googleads.v3.services.OfflineUserDataJobService.AddOfflineUserDataJobOperations] +message AddOfflineUserDataJobOperationsRequest { + // Required. The resource name of the OfflineUserDataJob. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/OfflineUserDataJob" + } + ]; + + // True to enable partial failure for the offline user data job. + google.protobuf.BoolValue enable_partial_failure = 2; + + // Required. The list of operations to be done. + repeated OfflineUserDataJobOperation operations = 3 [(google.api.field_behavior) = REQUIRED]; +} + +// Operation to be made for the AddOfflineUserDataJobOperationsRequest. +message OfflineUserDataJobOperation { + // Operation to be made for the AddOfflineUserDataJobOperationsRequest. + oneof operation { + // Add the provided data to the transaction. Data cannot be retrieved after + // being uploaded. + google.ads.googleads.v3.common.UserData create = 1; + + // Remove the provided data from the transaction. Data cannot be retrieved + // after being uploaded. + google.ads.googleads.v3.common.UserData remove = 2; + + // Remove all previously provided data. This is only supported for Customer + // Match. + bool remove_all = 3; + } +} + +// Response message for +// [OfflineUserDataJobService.AddOfflineUserDataJobOperations][google.ads.googleads.v3.services.OfflineUserDataJobService.AddOfflineUserDataJobOperations] +message AddOfflineUserDataJobOperationsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/operating_system_version_constant_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/operating_system_version_constant_service.proto new file mode 100644 index 000000000..ea6dbb9a8 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/operating_system_version_constant_service.proto @@ -0,0 +1,59 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/operating_system_version_constant.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "OperatingSystemVersionConstantServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the OS version constant service + +// Service to fetch Operating System Version constants. +service OperatingSystemVersionConstantService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested OS version constant in full detail. + rpc GetOperatingSystemVersionConstant(GetOperatingSystemVersionConstantRequest) returns (google.ads.googleads.v3.resources.OperatingSystemVersionConstant) { + option (google.api.http) = { + get: "/v3/{resource_name=operatingSystemVersionConstants/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for +// [OperatingSystemVersionConstantService.GetOperatingSystemVersionConstant][google.ads.googleads.v3.services.OperatingSystemVersionConstantService.GetOperatingSystemVersionConstant]. +message GetOperatingSystemVersionConstantRequest { + // Required. Resource name of the OS version to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/OperatingSystemVersionConstant" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/paid_organic_search_term_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/paid_organic_search_term_view_service.proto new file mode 100644 index 000000000..8c58ad9f5 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/paid_organic_search_term_view_service.proto @@ -0,0 +1,59 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/paid_organic_search_term_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "PaidOrganicSearchTermViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Paid Organic Search Term View service. + +// Service to fetch paid organic search term views. +service PaidOrganicSearchTermViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested paid organic search term view in full detail. + rpc GetPaidOrganicSearchTermView(GetPaidOrganicSearchTermViewRequest) returns (google.ads.googleads.v3.resources.PaidOrganicSearchTermView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/paidOrganicSearchTermViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for +// [PaidOrganicSearchTermViewService.GetPaidOrganicSearchTermView][google.ads.googleads.v3.services.PaidOrganicSearchTermViewService.GetPaidOrganicSearchTermView]. +message GetPaidOrganicSearchTermViewRequest { + // Required. The resource name of the paid organic search term view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/PaidOrganicSearchTermView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/parental_status_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/parental_status_view_service.proto new file mode 100644 index 000000000..b28736bd6 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/parental_status_view_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/parental_status_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "ParentalStatusViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Parental Status View service. + +// Service to manage parental status views. +service ParentalStatusViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested parental status view in full detail. + rpc GetParentalStatusView(GetParentalStatusViewRequest) returns (google.ads.googleads.v3.resources.ParentalStatusView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/parentalStatusViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [ParentalStatusViewService.GetParentalStatusView][google.ads.googleads.v3.services.ParentalStatusViewService.GetParentalStatusView]. +message GetParentalStatusViewRequest { + // Required. The resource name of the parental status view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ParentalStatusView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/payments_account_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/payments_account_service.proto new file mode 100644 index 000000000..4ac37d322 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/payments_account_service.proto @@ -0,0 +1,61 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/payments_account.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "PaymentsAccountServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the payments account service. + +// Service to provide payments accounts that can be used to set up consolidated +// billing. +service PaymentsAccountService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns all payments accounts associated with all managers + // between the login customer ID and specified serving customer in the + // hierarchy, inclusive. + rpc ListPaymentsAccounts(ListPaymentsAccountsRequest) returns (ListPaymentsAccountsResponse) { + option (google.api.http) = { + get: "/v3/customers/{customer_id=*}/paymentsAccounts" + }; + option (google.api.method_signature) = "customer_id"; + } +} + +// Request message for fetching all accessible payments accounts. +message ListPaymentsAccountsRequest { + // Required. The ID of the customer to apply the PaymentsAccount list operation to. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; +} + +// Response message for [PaymentsAccountService.ListPaymentsAccounts][google.ads.googleads.v3.services.PaymentsAccountService.ListPaymentsAccounts]. +message ListPaymentsAccountsResponse { + // The list of accessible payments accounts. + repeated google.ads.googleads.v3.resources.PaymentsAccount payments_accounts = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/product_bidding_category_constant_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/product_bidding_category_constant_service.proto new file mode 100644 index 000000000..b94e28138 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/product_bidding_category_constant_service.proto @@ -0,0 +1,59 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/product_bidding_category_constant.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "ProductBiddingCategoryConstantServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Product Bidding Category constant service + +// Service to fetch Product Bidding Categories. +service ProductBiddingCategoryConstantService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested Product Bidding Category in full detail. + rpc GetProductBiddingCategoryConstant(GetProductBiddingCategoryConstantRequest) returns (google.ads.googleads.v3.resources.ProductBiddingCategoryConstant) { + option (google.api.http) = { + get: "/v3/{resource_name=productBiddingCategoryConstants/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for +// [ProductBiddingCategoryService.GetProductBiddingCategory][]. +message GetProductBiddingCategoryConstantRequest { + // Required. Resource name of the Product Bidding Category to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ProductBiddingCategoryConstant" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/product_group_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/product_group_view_service.proto new file mode 100644 index 000000000..0205b1d5b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/product_group_view_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/product_group_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "ProductGroupViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the ProductGroup View service. + +// Service to manage product group views. +service ProductGroupViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested product group view in full detail. + rpc GetProductGroupView(GetProductGroupViewRequest) returns (google.ads.googleads.v3.resources.ProductGroupView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/productGroupViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [ProductGroupViewService.GetProductGroupView][google.ads.googleads.v3.services.ProductGroupViewService.GetProductGroupView]. +message GetProductGroupViewRequest { + // Required. The resource name of the product group view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ProductGroupView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/reach_plan_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/reach_plan_service.proto new file mode 100644 index 000000000..9986fe59a --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/reach_plan_service.proto @@ -0,0 +1,367 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/common/criteria.proto"; +import "google/ads/googleads/v3/enums/reach_plan_ad_length.proto"; +import "google/ads/googleads/v3/enums/reach_plan_age_range.proto"; +import "google/ads/googleads/v3/enums/reach_plan_network.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/protobuf/wrappers.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "ReachPlanServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the reach plan service. + +// Reach Plan Service gives users information about audience size that can +// be reached through advertisement on YouTube. In particular, +// GenerateReachForecast provides estimated number of people of specified +// demographics that can be reached by an ad in a given market by a campaign of +// certain duration with a defined budget. +service ReachPlanService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the list of plannable locations (for example, countries & DMAs). + rpc ListPlannableLocations(ListPlannableLocationsRequest) returns (ListPlannableLocationsResponse) { + option (google.api.http) = { + post: "/v3:listPlannableLocations" + body: "*" + }; + } + + // Returns the list of per-location plannable YouTube ad formats with allowed + // targeting. + rpc ListPlannableProducts(ListPlannableProductsRequest) returns (ListPlannableProductsResponse) { + option (google.api.http) = { + post: "/v3:listPlannableProducts" + body: "*" + }; + option (google.api.method_signature) = "plannable_location_id"; + } + + // Generates a product mix ideas given a set of preferences. This method + // helps the advertiser to obtain a good mix of ad formats and budget + // allocations based on its preferences. + rpc GenerateProductMixIdeas(GenerateProductMixIdeasRequest) returns (GenerateProductMixIdeasResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}:generateProductMixIdeas" + body: "*" + }; + option (google.api.method_signature) = "customer_id,plannable_location_id,currency_code,budget_micros"; + } + + // Generates a reach forecast for a given targeting / product mix. + rpc GenerateReachForecast(GenerateReachForecastRequest) returns (GenerateReachForecastResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}:generateReachForecast" + body: "*" + }; + option (google.api.method_signature) = "customer_id,campaign_duration,planned_products"; + } +} + +// Request message for [ReachForecastService.ListPlannableLocations][] +message ListPlannableLocationsRequest { + +} + +// The list of plannable locations. +message ListPlannableLocationsResponse { + // The list of locations available for planning (Countries, DMAs, + // sub-countries). + // For locations like Countries, DMAs see + // https://developers.google.com/adwords/api/docs/appendix/geotargeting for + // more information. + repeated PlannableLocation plannable_locations = 1; +} + +// A plannable location: a country, a DMA, a metro region, a tv region, +// a province. +message PlannableLocation { + // The location identifier. + google.protobuf.StringValue id = 1; + + // The unique location name in english. + google.protobuf.StringValue name = 2; + + // The parent country code, not present if location is a country. + // If present will always be a criterion id: additional information, such as + // country name are returned both via ListPlannableLocations or directly by + // accessing GeoTargetConstantService with the criterion id. + google.protobuf.Int64Value parent_country_id = 3; +} + +// Request to list available products in a given location. +message ListPlannableProductsRequest { + // Required. The ID of the selected location for planning. To list the available + // plannable location ids use ListPlannableLocations. + google.protobuf.StringValue plannable_location_id = 1 [(google.api.field_behavior) = REQUIRED]; +} + +// A response with all available products. +message ListPlannableProductsResponse { + // The list of products available for planning and related targeting metadata. + repeated ProductMetadata product_metadata = 1; +} + +// The metadata associated with an available plannable product. +message ProductMetadata { + // The code associated with the ad product. E.g. Trueview, Bumper + // To list the available plannable product codes use ListPlannableProducts. + google.protobuf.StringValue plannable_product_code = 1; + + // The allowed plannable targeting for this product. + PlannableTargeting plannable_targeting = 2; +} + +// The targeting for which traffic metrics will be reported. +message PlannableTargeting { + // Allowed plannable age ranges for the product for which metrics will be + // reported. Actual targeting is computed by mapping this age range onto + // standard Google common.AgeRangeInfo values. + repeated google.ads.googleads.v3.enums.ReachPlanAgeRangeEnum.ReachPlanAgeRange age_ranges = 1; + + // Targetable genders for the ad product. + repeated google.ads.googleads.v3.common.GenderInfo genders = 2; + + // Targetable devices for the ad product. + repeated google.ads.googleads.v3.common.DeviceInfo devices = 3; + + // Targetable networks for the ad product. + repeated google.ads.googleads.v3.enums.ReachPlanNetworkEnum.ReachPlanNetwork networks = 4; +} + +// Request message for [ReachForecastService.GenerateProductMixIdeas][]. +message GenerateProductMixIdeasRequest { + // Required. The ID of the customer. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The ID of the location, this is one of the ids returned by + // ListPlannableLocations. + google.protobuf.StringValue plannable_location_id = 2 [(google.api.field_behavior) = REQUIRED]; + + // Required. Currency code. + // Three-character ISO 4217 currency code. + google.protobuf.StringValue currency_code = 3 [(google.api.field_behavior) = REQUIRED]; + + // Required. Total budget. + // Amount in micros. One million is equivalent to one unit. + google.protobuf.Int64Value budget_micros = 4 [(google.api.field_behavior) = REQUIRED]; + + // The preferences of the suggested product mix. + // An unset preference is interpreted as all possible values are allowed, + // unless explicitly specified. + Preferences preferences = 5; +} + +// Set of preferences about the planned mix. +message Preferences { + // True if ad skippable. + // If not set, default is any value. + google.protobuf.BoolValue is_skippable = 1; + + // True if ad start with sound. + // If not set, default is any value. + google.protobuf.BoolValue starts_with_sound = 2; + + // The length of the ad. + // If not set, default is any value. + google.ads.googleads.v3.enums.ReachPlanAdLengthEnum.ReachPlanAdLength ad_length = 3; + + // True if ad will only show on the top content. + // If not set, default is false. + google.protobuf.BoolValue top_content_only = 4; + + // True if the price guaranteed. The cost of serving the ad is agreed upfront + // and not subject to an auction. + // If not set, default is any value. + google.protobuf.BoolValue has_guaranteed_price = 5; +} + +// The suggested product mix. +message GenerateProductMixIdeasResponse { + // A list of products (ad formats) and the associated budget allocation idea. + repeated ProductAllocation product_allocation = 1; +} + +// An allocation of a part of the budget on a given product. +message ProductAllocation { + // Selected product for planning. The product codes returned are within the + // set of the ones returned by ListPlannableProducts when using the same + // location id. + google.protobuf.StringValue plannable_product_code = 1; + + // The value to be allocated for the suggested product in requested currency. + // Amount in micros. One million is equivalent to one unit. + google.protobuf.Int64Value budget_micros = 2; +} + +// Request message for [ReachPlanService.GenerateReachForecast][google.ads.googleads.v3.services.ReachPlanService.GenerateReachForecast]. +message GenerateReachForecastRequest { + // Required. The ID of the customer. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // The currency code. + // Three-character ISO 4217 currency code. + google.protobuf.StringValue currency_code = 2; + + // Required. Campaign duration. + CampaignDuration campaign_duration = 3 [(google.api.field_behavior) = REQUIRED]; + + // Desired cookie frequency cap that will be applied to each planned product. + // This is equivalent to the frequency cap exposed in Google Ads when creating + // a campaign, it represents the maximum number of times an ad can be shown to + // the same user. + // If not specified, no cap is applied. + google.protobuf.Int32Value cookie_frequency_cap = 4; + + // Desired minimum effective frequency (the number of times a person was + // exposed to the ad) for the reported reach metrics [1-10]. + // This won't affect the targeting, but just the reporting. + // If not specified, a default of 1 is applied. + google.protobuf.Int32Value min_effective_frequency = 5; + + // The targeting to be applied to all products selected in the product mix. + // + // This is planned targeting: execution details might vary based on the + // advertising product, please consult an implementation specialist. + // + // See specific metrics for details on how targeting affects them. + // + // In some cases, targeting may be overridden using the + // PlannedProduct.advanced_product_targeting field. + Targeting targeting = 6; + + // Required. The products to be forecast. + // The max number of allowed planned products is 15. + repeated PlannedProduct planned_products = 7 [(google.api.field_behavior) = REQUIRED]; +} + +// The targeting for which traffic metrics will be reported. +message Targeting { + // Required. The ID of the selected location. + // Plannable locations ID can be obtained from ListPlannableLocations. + google.protobuf.StringValue plannable_location_id = 1; + + // Targeted age range. + // If not specified, targets all age ranges. + google.ads.googleads.v3.enums.ReachPlanAgeRangeEnum.ReachPlanAgeRange age_range = 2; + + // Targeted genders. + // If not specified, targets all genders. + repeated google.ads.googleads.v3.common.GenderInfo genders = 3; + + // Targeted devices. + // If not specified, targets all applicable devices. Applicable devices vary + // by product and region and can be obtained from ListPlannableProducts. + repeated google.ads.googleads.v3.common.DeviceInfo devices = 4; + + // Targetable network for the ad product. + // If not specified, targets all applicable networks. Applicable networks vary + // by product and region and can be obtained from ListPlannableProducts. + google.ads.googleads.v3.enums.ReachPlanNetworkEnum.ReachPlanNetwork network = 5; +} + +// The duration of a planned campaign. +message CampaignDuration { + // The duration value in days. + google.protobuf.Int32Value duration_in_days = 1; +} + +// A product being planned for reach. +message PlannedProduct { + // Required. Selected product for planning. + // Plannable products codes can be obtained from ListPlannableProducts. + google.protobuf.StringValue plannable_product_code = 1; + + // Required. Maximum budget allocation in micros for the selected product. + // The value is specified in the selected planning currency_code. + // E.g. 1 000 000$ = 1 000 000 000 000 micros. + google.protobuf.Int64Value budget_micros = 2; +} + +// Response message containing the generated reach curve. +message GenerateReachForecastResponse { + // Reference on target audiences for this curve. + OnTargetAudienceMetrics on_target_audience_metrics = 1; + + // The generated reach curve for the planned product mix. + ReachCurve reach_curve = 2; +} + +// The reach curve for the planned products. +message ReachCurve { + // All points on the reach curve. + repeated ReachForecast reach_forecasts = 1; +} + +// A point on reach curve. +message ReachForecast { + // The cost in micros. + google.protobuf.Int64Value cost_micros = 1; + + // Forecasted traffic metrics for this point. + Forecast forecast = 2; + + // The forecasted allocation. This differs from the input allocation if one + // or more product cannot fulfill the budget because of limited inventory. + repeated ProductAllocation forecasted_product_allocations = 3; +} + +// Forecasted traffic metrics for the planned products and targeting. +message Forecast { + // Number of unique people reached at least + // GenerateReachForecastRequest.min_effective_frequency times that exactly + // matches the Targeting. + google.protobuf.Int64Value on_target_reach = 1; + + // Total number of unique people reached at least + // GenerateReachForecastRequest.min_effective_frequency times. This includes + // people that may fall outside the specified Targeting. + google.protobuf.Int64Value total_reach = 2; + + // Number of ad impressions that exactly matches the Targeting. + google.protobuf.Int64Value on_target_impressions = 3; + + // Total number of ad impressions. This includes impressions that may fall + // outside the specified Targeting, due to insufficient information on + // signed-in users. + google.protobuf.Int64Value total_impressions = 4; +} + +// Audience metrics for the planned products. +// These metrics consider the following targeting dimensions: +// +// - Location +// - PlannableAgeRange +// - Gender +message OnTargetAudienceMetrics { + // Reference audience size matching the considered targeting for YouTube. + google.protobuf.Int64Value youtube_audience_size = 1; + + // Reference audience size matching the considered targeting for Census. + google.protobuf.Int64Value census_audience_size = 2; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/recommendation_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/recommendation_service.proto new file mode 100644 index 000000000..b71d6992d --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/recommendation_service.proto @@ -0,0 +1,255 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/common/extensions.proto"; +import "google/ads/googleads/v3/enums/keyword_match_type.proto"; +import "google/ads/googleads/v3/resources/ad.proto"; +import "google/ads/googleads/v3/resources/recommendation.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/wrappers.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "RecommendationServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Recommendation service. + +// Service to manage recommendations. +service RecommendationService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested recommendation in full detail. + rpc GetRecommendation(GetRecommendationRequest) returns (google.ads.googleads.v3.resources.Recommendation) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/recommendations/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Applies given recommendations with corresponding apply parameters. + rpc ApplyRecommendation(ApplyRecommendationRequest) returns (ApplyRecommendationResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/recommendations:apply" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } + + // Dismisses given recommendations. + rpc DismissRecommendation(DismissRecommendationRequest) returns (DismissRecommendationResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/recommendations:dismiss" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [RecommendationService.GetRecommendation][google.ads.googleads.v3.services.RecommendationService.GetRecommendation]. +message GetRecommendationRequest { + // Required. The resource name of the recommendation to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Recommendation" + } + ]; +} + +// Request message for [RecommendationService.ApplyRecommendation][google.ads.googleads.v3.services.RecommendationService.ApplyRecommendation]. +message ApplyRecommendationRequest { + // Required. The ID of the customer with the recommendation. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to apply recommendations. + // If partial_failure=false all recommendations should be of the same type + // There is a limit of 100 operations per request. + repeated ApplyRecommendationOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, operations will be carried + // out as a transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; +} + +// Information about the operation to apply a recommendation and any parameters +// to customize it. +message ApplyRecommendationOperation { + // Parameters to use when applying a campaign budget recommendation. + message CampaignBudgetParameters { + // New budget amount to set for target budget resource. This is a required + // field. + google.protobuf.Int64Value new_budget_amount_micros = 1; + } + + // Parameters to use when applying a text ad recommendation. + message TextAdParameters { + // New ad to add to recommended ad group. All necessary fields need to be + // set in this message. This is a required field. + google.ads.googleads.v3.resources.Ad ad = 1; + } + + // Parameters to use when applying keyword recommendation. + message KeywordParameters { + // The ad group resource to add keyword to. This is a required field. + google.protobuf.StringValue ad_group = 1; + + // The match type of the keyword. This is a required field. + google.ads.googleads.v3.enums.KeywordMatchTypeEnum.KeywordMatchType match_type = 2; + + // Optional, CPC bid to set for the keyword. If not set, keyword will use + // bid based on bidding strategy used by target ad group. + google.protobuf.Int64Value cpc_bid_micros = 3; + } + + // Parameters to use when applying Target CPA recommendation. + message TargetCpaOptInParameters { + // Average CPA to use for Target CPA bidding strategy. This is a required + // field. + google.protobuf.Int64Value target_cpa_micros = 1; + + // Optional, budget amount to set for the campaign. + google.protobuf.Int64Value new_campaign_budget_amount_micros = 2; + } + + // Parameters to use when applying callout extension recommendation. + message CalloutExtensionParameters { + // Callout extensions to be added. This is a required field. + repeated google.ads.googleads.v3.common.CalloutFeedItem callout_extensions = 1; + } + + // Parameters to use when applying call extension recommendation. + message CallExtensionParameters { + // Call extensions to be added. This is a required field. + repeated google.ads.googleads.v3.common.CallFeedItem call_extensions = 1; + } + + // Parameters to use when applying sitelink extension recommendation. + message SitelinkExtensionParameters { + // Sitelink extensions to be added. This is a required field. + repeated google.ads.googleads.v3.common.SitelinkFeedItem sitelink_extensions = 1; + } + + // Parameters to use when applying move unused budget recommendation. + message MoveUnusedBudgetParameters { + // Budget amount to move from excess budget to constrained budget. This is + // a required field. + google.protobuf.Int64Value budget_micros_to_move = 1; + } + + // The resource name of the recommendation to apply. + string resource_name = 1; + + // Parameters to use when applying the recommendation. + oneof apply_parameters { + // Optional parameters to use when applying a campaign budget + // recommendation. + CampaignBudgetParameters campaign_budget = 2; + + // Optional parameters to use when applying a text ad recommendation. + TextAdParameters text_ad = 3; + + // Optional parameters to use when applying keyword recommendation. + KeywordParameters keyword = 4; + + // Optional parameters to use when applying target CPA opt-in + // recommendation. + TargetCpaOptInParameters target_cpa_opt_in = 5; + + // Parameters to use when applying callout extension recommendation. + CalloutExtensionParameters callout_extension = 6; + + // Parameters to use when applying call extension recommendation. + CallExtensionParameters call_extension = 7; + + // Parameters to use when applying sitelink extension recommendation. + SitelinkExtensionParameters sitelink_extension = 8; + + // Parameters to use when applying move unused budget recommendation. + MoveUnusedBudgetParameters move_unused_budget = 9; + } +} + +// Response message for [RecommendationService.ApplyRecommendation][google.ads.googleads.v3.services.RecommendationService.ApplyRecommendation]. +message ApplyRecommendationResponse { + // Results of operations to apply recommendations. + repeated ApplyRecommendationResult results = 1; + + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors) + // we return the RPC level error. + google.rpc.Status partial_failure_error = 2; +} + +// The result of applying a recommendation. +message ApplyRecommendationResult { + // Returned for successful applies. + string resource_name = 1; +} + +// Request message for [RecommendationService.DismissRecommendation][google.ads.googleads.v3.services.RecommendationService.DismissRecommendation]. +message DismissRecommendationRequest { + // Operation to dismiss a single recommendation identified by resource_name. + message DismissRecommendationOperation { + // The resource name of the recommendation to dismiss. + string resource_name = 1; + } + + // Required. The ID of the customer with the recommendation. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to dismiss recommendations. + // If partial_failure=false all recommendations should be of the same type + // There is a limit of 100 operations per request. + repeated DismissRecommendationOperation operations = 3 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, operations will be carried in a + // single transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 2; +} + +// Response message for [RecommendationService.DismissRecommendation][google.ads.googleads.v3.services.RecommendationService.DismissRecommendation]. +message DismissRecommendationResponse { + // The result of dismissing a recommendation. + message DismissRecommendationResult { + // Returned for successful dismissals. + string resource_name = 1; + } + + // Results of operations to dismiss recommendations. + repeated DismissRecommendationResult results = 1; + + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors) + // we return the RPC level error. + google.rpc.Status partial_failure_error = 2; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/remarketing_action_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/remarketing_action_service.proto new file mode 100644 index 000000000..234339e95 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/remarketing_action_service.proto @@ -0,0 +1,123 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/remarketing_action.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "RemarketingActionServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Remarketing Action service. + +// Service to manage remarketing actions. +service RemarketingActionService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested remarketing action in full detail. + rpc GetRemarketingAction(GetRemarketingActionRequest) returns (google.ads.googleads.v3.resources.RemarketingAction) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/remarketingActions/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates or updates remarketing actions. Operation statuses are returned. + rpc MutateRemarketingActions(MutateRemarketingActionsRequest) returns (MutateRemarketingActionsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/remarketingActions:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [RemarketingActionService.GetRemarketingAction][google.ads.googleads.v3.services.RemarketingActionService.GetRemarketingAction]. +message GetRemarketingActionRequest { + // Required. The resource name of the remarketing action to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/RemarketingAction" + } + ]; +} + +// Request message for [RemarketingActionService.MutateRemarketingActions][google.ads.googleads.v3.services.RemarketingActionService.MutateRemarketingActions]. +message MutateRemarketingActionsRequest { + // Required. The ID of the customer whose remarketing actions are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual remarketing actions. + repeated RemarketingActionOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update) on a remarketing action. +message RemarketingActionOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new remarketing + // action. + google.ads.googleads.v3.resources.RemarketingAction create = 1; + + // Update operation: The remarketing action is expected to have a valid + // resource name. + google.ads.googleads.v3.resources.RemarketingAction update = 2; + } +} + +// Response message for remarketing action mutate. +message MutateRemarketingActionsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateRemarketingActionResult results = 2; +} + +// The result for the remarketing action mutate. +message MutateRemarketingActionResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/search_term_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/search_term_view_service.proto new file mode 100644 index 000000000..ac752fe30 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/search_term_view_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/search_term_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "SearchTermViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Search Term View service. + +// Service to manage search term views. +service SearchTermViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the attributes of the requested search term view. + rpc GetSearchTermView(GetSearchTermViewRequest) returns (google.ads.googleads.v3.resources.SearchTermView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/searchTermViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [SearchTermViewService.GetSearchTermView][google.ads.googleads.v3.services.SearchTermViewService.GetSearchTermView]. +message GetSearchTermViewRequest { + // Required. The resource name of the search term view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/SearchTermView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/shared_criterion_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/shared_criterion_service.proto new file mode 100644 index 000000000..49849e550 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/shared_criterion_service.proto @@ -0,0 +1,121 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/shared_criterion.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "SharedCriterionServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Shared Criterion service. + +// Service to manage shared criteria. +service SharedCriterionService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested shared criterion in full detail. + rpc GetSharedCriterion(GetSharedCriterionRequest) returns (google.ads.googleads.v3.resources.SharedCriterion) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/sharedCriteria/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates or removes shared criteria. Operation statuses are returned. + rpc MutateSharedCriteria(MutateSharedCriteriaRequest) returns (MutateSharedCriteriaResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/sharedCriteria:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [SharedCriterionService.GetSharedCriterion][google.ads.googleads.v3.services.SharedCriterionService.GetSharedCriterion]. +message GetSharedCriterionRequest { + // Required. The resource name of the shared criterion to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/SharedCriterion" + } + ]; +} + +// Request message for [SharedCriterionService.MutateSharedCriteria][google.ads.googleads.v3.services.SharedCriterionService.MutateSharedCriteria]. +message MutateSharedCriteriaRequest { + // Required. The ID of the customer whose shared criteria are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual shared criteria. + repeated SharedCriterionOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, remove) on an shared criterion. +message SharedCriterionOperation { + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new shared + // criterion. + google.ads.googleads.v3.resources.SharedCriterion create = 1; + + // Remove operation: A resource name for the removed shared criterion is + // expected, in this format: + // + // `customers/{customer_id}/sharedCriteria/{shared_set_id}~{criterion_id}` + string remove = 3; + } +} + +// Response message for a shared criterion mutate. +message MutateSharedCriteriaResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateSharedCriterionResult results = 2; +} + +// The result for the shared criterion mutate. +message MutateSharedCriterionResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/shared_set_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/shared_set_service.proto new file mode 100644 index 000000000..5b5192ec2 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/shared_set_service.proto @@ -0,0 +1,128 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/shared_set.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "SharedSetServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Shared Set service. + +// Service to manage shared sets. +service SharedSetService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested shared set in full detail. + rpc GetSharedSet(GetSharedSetRequest) returns (google.ads.googleads.v3.resources.SharedSet) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/sharedSets/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates, updates, or removes shared sets. Operation statuses are returned. + rpc MutateSharedSets(MutateSharedSetsRequest) returns (MutateSharedSetsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/sharedSets:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [SharedSetService.GetSharedSet][google.ads.googleads.v3.services.SharedSetService.GetSharedSet]. +message GetSharedSetRequest { + // Required. The resource name of the shared set to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/SharedSet" + } + ]; +} + +// Request message for [SharedSetService.MutateSharedSets][google.ads.googleads.v3.services.SharedSetService.MutateSharedSets]. +message MutateSharedSetsRequest { + // Required. The ID of the customer whose shared sets are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual shared sets. + repeated SharedSetOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update, remove) on an shared set. +message SharedSetOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new shared set. + google.ads.googleads.v3.resources.SharedSet create = 1; + + // Update operation: The shared set is expected to have a valid resource + // name. + google.ads.googleads.v3.resources.SharedSet update = 2; + + // Remove operation: A resource name for the removed shared set is expected, + // in this format: + // + // `customers/{customer_id}/sharedSets/{shared_set_id}` + string remove = 3; + } +} + +// Response message for a shared set mutate. +message MutateSharedSetsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateSharedSetResult results = 2; +} + +// The result for the shared set mutate. +message MutateSharedSetResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/shopping_performance_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/shopping_performance_view_service.proto new file mode 100644 index 000000000..46c91862d --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/shopping_performance_view_service.proto @@ -0,0 +1,59 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/shopping_performance_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "ShoppingPerformanceViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the ShoppingPerformanceView service. + +// Service to fetch Shopping performance views. +service ShoppingPerformanceViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested Shopping performance view in full detail. + rpc GetShoppingPerformanceView(GetShoppingPerformanceViewRequest) returns (google.ads.googleads.v3.resources.ShoppingPerformanceView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/shoppingPerformanceView}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for +// [ShoppingPerformanceViewService.GetShoppingPerformanceView][google.ads.googleads.v3.services.ShoppingPerformanceViewService.GetShoppingPerformanceView]. +message GetShoppingPerformanceViewRequest { + // Required. The resource name of the Shopping performance view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/ShoppingPerformanceView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/topic_constant_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/topic_constant_service.proto new file mode 100644 index 000000000..5f06a0aa1 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/topic_constant_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/topic_constant.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "TopicConstantServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Topic constant service + +// Service to fetch topic constants. +service TopicConstantService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested topic constant in full detail. + rpc GetTopicConstant(GetTopicConstantRequest) returns (google.ads.googleads.v3.resources.TopicConstant) { + option (google.api.http) = { + get: "/v3/{resource_name=topicConstants/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [TopicConstantService.GetTopicConstant][google.ads.googleads.v3.services.TopicConstantService.GetTopicConstant]. +message GetTopicConstantRequest { + // Required. Resource name of the Topic to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/TopicConstant" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/topic_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/topic_view_service.proto new file mode 100644 index 000000000..ef16d79f5 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/topic_view_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/topic_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "TopicViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Topic View service. + +// Service to manage topic views. +service TopicViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested topic view in full detail. + rpc GetTopicView(GetTopicViewRequest) returns (google.ads.googleads.v3.resources.TopicView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/topicViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [TopicViewService.GetTopicView][google.ads.googleads.v3.services.TopicViewService.GetTopicView]. +message GetTopicViewRequest { + // Required. The resource name of the topic view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/TopicView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/user_data_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/user_data_service.proto new file mode 100644 index 000000000..2b8a9fcd1 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/user_data_service.proto @@ -0,0 +1,82 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/common/offline_user_data.proto"; +import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/client.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "UserDataServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the UserDataService. + +// Service to manage user data uploads. +// Accessible to whitelisted customers only. +service UserDataService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Uploads the given user data. + rpc UploadUserData(UploadUserDataRequest) returns (UploadUserDataResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}:uploadUserData" + body: "*" + }; + } +} + +// Request message for [UserDataService.UploadUserData][google.ads.googleads.v3.services.UserDataService.UploadUserData] +message UploadUserDataRequest { + // Required. The ID of the customer for which to update the user data. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to be done. + repeated UserDataOperation operations = 3 [(google.api.field_behavior) = REQUIRED]; + + // Metadata of the request. + oneof metadata { + // Metadata for data updates to a Customer Match user list. + google.ads.googleads.v3.common.CustomerMatchUserListMetadata customer_match_user_list_metadata = 2; + } +} + +// Operation to be made for the UploadUserDataRequest. +message UserDataOperation { + // Operation to be made for the UploadUserDataRequest. + oneof operation { + // The list of user data to be appended to the user list. + google.ads.googleads.v3.common.UserData create = 1; + } +} + +// Response message for [UserDataService.UploadUserData][google.ads.googleads.v3.services.UserDataService.UploadUserData] +message UploadUserDataResponse { + // The date time at which the request was received by API, formatted as + // "yyyy-mm-dd hh:mm:ss+|-hh:mm", e.g. "2019-01-01 12:32:45-08:00". + google.protobuf.StringValue upload_date_time = 1; + + // Number of upload data operations received by API. + google.protobuf.Int32Value received_operations_count = 2; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/user_interest_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/user_interest_service.proto new file mode 100644 index 000000000..2b2c1bb5b --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/user_interest_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/user_interest.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "UserInterestServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the user interest service + +// Service to fetch Google Ads User Interest. +service UserInterestService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested user interest in full detail + rpc GetUserInterest(GetUserInterestRequest) returns (google.ads.googleads.v3.resources.UserInterest) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/userInterests/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [UserInterestService.GetUserInterest][google.ads.googleads.v3.services.UserInterestService.GetUserInterest]. +message GetUserInterestRequest { + // Required. Resource name of the UserInterest to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/UserInterest" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/user_list_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/user_list_service.proto new file mode 100644 index 000000000..5e2f7492e --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/user_list_service.proto @@ -0,0 +1,128 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/user_list.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/field_mask.proto"; +import "google/rpc/status.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "UserListServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the User List service. + +// Service to manage user lists. +service UserListService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested user list. + rpc GetUserList(GetUserListRequest) returns (google.ads.googleads.v3.resources.UserList) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/userLists/*}" + }; + option (google.api.method_signature) = "resource_name"; + } + + // Creates or updates user lists. Operation statuses are returned. + rpc MutateUserLists(MutateUserListsRequest) returns (MutateUserListsResponse) { + option (google.api.http) = { + post: "/v3/customers/{customer_id=*}/userLists:mutate" + body: "*" + }; + option (google.api.method_signature) = "customer_id,operations"; + } +} + +// Request message for [UserListService.GetUserList][google.ads.googleads.v3.services.UserListService.GetUserList]. +message GetUserListRequest { + // Required. The resource name of the user list to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/UserList" + } + ]; +} + +// Request message for [UserListService.MutateUserLists][google.ads.googleads.v3.services.UserListService.MutateUserLists]. +message MutateUserListsRequest { + // Required. The ID of the customer whose user lists are being modified. + string customer_id = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The list of operations to perform on individual user lists. + repeated UserListOperation operations = 2 [(google.api.field_behavior) = REQUIRED]; + + // If true, successful operations will be carried out and invalid + // operations will return errors. If false, all operations will be carried + // out in one transaction if and only if they are all valid. + // Default is false. + bool partial_failure = 3; + + // If true, the request is validated but not executed. Only errors are + // returned, not results. + bool validate_only = 4; +} + +// A single operation (create, update) on a user list. +message UserListOperation { + // FieldMask that determines which resource fields are modified in an update. + google.protobuf.FieldMask update_mask = 4; + + // The mutate operation. + oneof operation { + // Create operation: No resource name is expected for the new user list. + google.ads.googleads.v3.resources.UserList create = 1; + + // Update operation: The user list is expected to have a valid resource + // name. + google.ads.googleads.v3.resources.UserList update = 2; + + // Remove operation: A resource name for the removed user list is expected, + // in this format: + // + // `customers/{customer_id}/userLists/{user_list_id}` + string remove = 3; + } +} + +// Response message for user list mutate. +message MutateUserListsResponse { + // Errors that pertain to operation failures in the partial failure mode. + // Returned only when partial_failure = true and all errors occur inside the + // operations. If any errors occur outside the operations (e.g. auth errors), + // we return an RPC level error. + google.rpc.Status partial_failure_error = 3; + + // All results for the mutate. + repeated MutateUserListResult results = 2; +} + +// The result for the user list mutate. +message MutateUserListResult { + // Returned for successful operations. + string resource_name = 1; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/user_location_view_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/user_location_view_service.proto new file mode 100644 index 000000000..0fc7437fb --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/user_location_view_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/user_location_view.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "UserLocationViewServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the UserLocationView service. + +// Service to manage user location views. +service UserLocationViewService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested user location view in full detail. + rpc GetUserLocationView(GetUserLocationViewRequest) returns (google.ads.googleads.v3.resources.UserLocationView) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/userLocationViews/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [UserLocationViewService.GetUserLocationView][google.ads.googleads.v3.services.UserLocationViewService.GetUserLocationView]. +message GetUserLocationViewRequest { + // Required. The resource name of the user location view to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/UserLocationView" + } + ]; +} diff --git a/third_party/googleapis/google/ads/googleads/v3/services/video_service.proto b/third_party/googleapis/google/ads/googleads/v3/services/video_service.proto new file mode 100644 index 000000000..d43862235 --- /dev/null +++ b/third_party/googleapis/google/ads/googleads/v3/services/video_service.proto @@ -0,0 +1,58 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.ads.googleads.v3.services; + +import "google/ads/googleads/v3/resources/video.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option csharp_namespace = "Google.Ads.GoogleAds.V3.Services"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/services;services"; +option java_multiple_files = true; +option java_outer_classname = "VideoServiceProto"; +option java_package = "com.google.ads.googleads.v3.services"; +option objc_class_prefix = "GAA"; +option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Services"; +option ruby_package = "Google::Ads::GoogleAds::V3::Services"; + +// Proto file describing the Video service. + +// Service to manage videos. +service VideoService { + option (google.api.default_host) = "googleads.googleapis.com"; + + // Returns the requested video in full detail. + rpc GetVideo(GetVideoRequest) returns (google.ads.googleads.v3.resources.Video) { + option (google.api.http) = { + get: "/v3/{resource_name=customers/*/videos/*}" + }; + option (google.api.method_signature) = "resource_name"; + } +} + +// Request message for [VideoService.GetVideo][google.ads.googleads.v3.services.VideoService.GetVideo]. +message GetVideoRequest { + // Required. The resource name of the video to fetch. + string resource_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "googleads.googleapis.com/Video" + } + ]; +} diff --git a/third_party/googleapis/google/analytics/management/v1alpha/BUILD.bazel b/third_party/googleapis/google/analytics/management/v1alpha/BUILD.bazel new file mode 100644 index 000000000..f1bd991eb --- /dev/null +++ b/third_party/googleapis/google/analytics/management/v1alpha/BUILD.bazel @@ -0,0 +1,369 @@ +# This file was automatically generated by BuildFileGenerator + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") +load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") + +proto_library( + name = "management_proto", + srcs = [ + "management_api.proto", + "resources.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +proto_library_with_info( + name = "management_proto_with_info", + deps = [ + ":management_proto", + "//google/cloud:common_resources_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", + "java_proto_library", +) + +java_proto_library( + name = "management_java_proto", + deps = [":management_proto"], +) + +java_grpc_library( + name = "management_java_grpc", + srcs = [":management_proto"], + deps = [":management_java_proto"], +) + +java_gapic_library( + name = "management_java_gapic", + src = ":management_proto_with_info", + gapic_yaml = "analyticsmanagement_gapic.yaml", + package = "google.analytics.management.v1alpha", + service_yaml = "analyticsmanagement_v1alpha.yaml", + test_deps = [ + ":management_java_grpc", + ], + deps = [ + ":management_java_proto", + ], +) + +java_gapic_test( + name = "management_java_gapic_test_suite", + test_classes = [ + "com.google.analytics.management.v1alpha.ManagementClientTest", + ], + runtime_deps = [":management_java_gapic_test"], +) + +# Open Source Packages +java_gapic_assembly_gradle_pkg( + name = "google-cloud-analytics-management-v1alpha-java", + deps = [ + ":management_java_gapic", + ":management_java_grpc", + ":management_java_proto", + ":management_proto", + ], +) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", + "go_proto_library", + "go_test", +) + +go_proto_library( + name = "management_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/analytics/management/v1alpha", + protos = [":management_proto"], + deps = [ + "//google/api:annotations_go_proto", + ], +) + +# go_gapic_library( +# name = "management_go_gapic", +# src = ":management_proto_with_info", +# gapic_yaml = "analyticsmanagement_gapic.yaml", +# importpath = "google.golang.org/genproto/googleapis/analytics/management/v1alpha", +# package = "google.analytics.management.v1alpha", +# service_yaml = "analyticsmanagement_v1alpha.yaml", +# deps = [ +# ":management_go_proto", +# ], +# ) + +#go_test( +# name = "management_go_gapic_test", +# srcs = [":management_go_gapic_srcjar_test"], +# embed = [":management_go_gapic"], +# importpath = "google.golang.org/genproto/googleapis/analytics/management/v1alpha", +#) + +# # Open Source Packages +# go_gapic_assembly_pkg( +# name = "gapi-cloud-analytics-management-v1alpha-go", +# deps = [ +# ":management_go_gapic", +# ":management_go_gapic_srcjar-smoke-test.srcjar", +# ":management_go_gapic_srcjar-test.srcjar", +# ":management_go_proto", +# ], +# ) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "management_moved_proto", + srcs = [":management_proto"], + # Customization (ikuleshov): Without this parameter, the proto resources + # are generated with "google.cloud" package prefix and the generated + # clients do not compile. + import_prefix = "google/analytics/management/v1alpha/proto", + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +py_proto_library( + name = "management_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":management_moved_proto"], +) + +py_grpc_library( + name = "management_py_grpc", + srcs = [":management_moved_proto"], + deps = [":management_py_proto"], +) + +py_gapic_library( + name = "management_py_gapic", + src = ":management_proto_with_info", + gapic_yaml = "analyticsmanagement_gapic.yaml", + package = "google.analytics.management.v1alpha", + service_yaml = "analyticsmanagement_v1alpha.yaml", + deps = [ + ":management_py_grpc", + ":management_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "analytics-management-v1alpha-py", + deps = [ + ":management_py_gapic", + ":management_py_grpc", + ":management_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "management_php_proto", + deps = [":management_proto"], +) + +php_grpc_library( + name = "management_php_grpc", + srcs = [":management_proto"], + deps = [":management_php_proto"], +) + +php_gapic_library( + name = "management_php_gapic", + src = ":management_proto_with_info", + gapic_yaml = "analyticsmanagement_gapic.yaml", + package = "google.analytics.management.v1alpha", + service_yaml = "analyticsmanagement_v1alpha.yaml", + deps = [ + ":management_php_grpc", + ":management_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-analytics-management-v1alpha-php", + deps = [ + ":management_php_gapic", + ":management_php_grpc", + ":management_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "management_nodejs_gapic", + src = ":management_proto_with_info", + gapic_yaml = "analyticsmanagement_gapic.yaml", + package = "google.analytics.management.v1alpha", + service_yaml = "analyticsmanagement_v1alpha.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "analytics-management-v1alpha-nodejs", + deps = [ + ":management_nodejs_gapic", + ":management_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "management_ruby_proto", + deps = [":management_proto"], +) + +ruby_grpc_library( + name = "management_ruby_grpc", + srcs = [":management_proto"], + deps = [":management_ruby_proto"], +) + +ruby_gapic_library( + name = "management_ruby_gapic", + src = ":management_proto_with_info", + gapic_yaml = "analyticsmanagement_gapic.yaml", + package = "google.analytics.management.v1alpha", + service_yaml = "analyticsmanagement_v1alpha.yaml", + deps = [ + ":management_ruby_grpc", + ":management_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-analytics-management-v1alpha-ruby", + deps = [ + ":management_ruby_gapic", + ":management_ruby_grpc", + ":management_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "management_csharp_proto", + deps = [":management_proto"], +) + +csharp_grpc_library( + name = "management_csharp_grpc", + srcs = [":management_proto"], + deps = [":management_csharp_proto"], +) + +csharp_gapic_library( + name = "management_csharp_gapic", + src = ":management_proto_with_info", + gapic_yaml = "analyticsmanagement_gapic.yaml", + package = "google.analytics.management.v1alpha", + service_yaml = "analyticsmanagement_v1alpha.yaml", + deps = [ + ":management_csharp_grpc", + ":management_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-analytics-management-v1alpha-csharp", + deps = [ + ":management_csharp_gapic", + ":management_csharp_grpc", + ":management_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/analytics/management/v1alpha/analyticsmanagement_gapic.yaml b/third_party/googleapis/google/analytics/management/v1alpha/analyticsmanagement_gapic.yaml new file mode 100644 index 000000000..991a5ac17 --- /dev/null +++ b/third_party/googleapis/google/analytics/management/v1alpha/analyticsmanagement_gapic.yaml @@ -0,0 +1,19 @@ +# The file created manually as per go/actools-user-guide +type: com.google.api.codegen.ConfigProto +config_schema_version: 2.0.0 +language_settings: + java: + package_name: com.google.analytics.management.v1alpha + python: + package_name: google.analytics.management.v1alpha.gapic + go: + package_name: google.golang.org/api/analyticsmanagement/v1alpha + csharp: + package_name: Google.Analytics.Management.V1alpha + ruby: + package_name: Google::Analytics::Management::V1alpha + php: + package_name: Google\Analytics\Management\V1alpha + nodejs: + package_name: google.analytics.management.v1alpha + domain_layer_location: analyticsmanagement.google.com diff --git a/third_party/googleapis/google/analytics/management/v1alpha/analyticsmanagement_v1alpha.yaml b/third_party/googleapis/google/analytics/management/v1alpha/analyticsmanagement_v1alpha.yaml new file mode 100644 index 000000000..ff7ffb2f1 --- /dev/null +++ b/third_party/googleapis/google/analytics/management/v1alpha/analyticsmanagement_v1alpha.yaml @@ -0,0 +1,106 @@ +type: google.api.Service +config_version: 3 +name: analyticsmanagement.googleapis.com +title: Analytics Management API + +apis: +- name: google.analytics.management.v1alpha.Management + +authentication: + rules: + - selector: 'google.analytics.management.v1alpha.Management.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/analytics.edit + - selector: google.analytics.management.v1alpha.Management.AuditUserLinks + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/analytics.manage.users.readonly + - selector: google.analytics.management.v1alpha.Management.BatchCreateUserLinks + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/analytics.manage.users + - selector: google.analytics.management.v1alpha.Management.BatchDeleteUserLinks + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/analytics.manage.users + - selector: google.analytics.management.v1alpha.Management.BatchGetUserLinks + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/analytics.manage.users.readonly + - selector: google.analytics.management.v1alpha.Management.BatchUpdateUserLinks + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/analytics.manage.users + - selector: google.analytics.management.v1alpha.Management.CreateUserLink + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/analytics.manage.users + - selector: google.analytics.management.v1alpha.Management.DeleteUserLink + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/analytics.manage.users + - selector: google.analytics.management.v1alpha.Management.GetAccount + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/analytics.readonly + - selector: google.analytics.management.v1alpha.Management.GetAndroidAppDataStream + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/analytics.readonly + - selector: google.analytics.management.v1alpha.Management.GetEnhancedMeasurementSettings + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/analytics.readonly + - selector: google.analytics.management.v1alpha.Management.GetIosAppDataStream + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/analytics.readonly + - selector: google.analytics.management.v1alpha.Management.GetProperty + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/analytics.readonly + - selector: google.analytics.management.v1alpha.Management.GetUserLink + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/analytics.manage.users.readonly + - selector: google.analytics.management.v1alpha.Management.GetWebDataStream + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/analytics.readonly + - selector: google.analytics.management.v1alpha.Management.ListAccounts + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/analytics.readonly + - selector: google.analytics.management.v1alpha.Management.ListAndroidAppDataStreams + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/analytics.readonly + - selector: google.analytics.management.v1alpha.Management.ListFirebaseLinks + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/analytics.readonly + - selector: google.analytics.management.v1alpha.Management.ListGoogleAdsLinks + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/analytics.readonly + - selector: google.analytics.management.v1alpha.Management.ListIosAppDataStreams + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/analytics.readonly + - selector: google.analytics.management.v1alpha.Management.ListProperties + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/analytics.readonly + - selector: google.analytics.management.v1alpha.Management.ListUserLinks + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/analytics.manage.users.readonly + - selector: google.analytics.management.v1alpha.Management.ListWebDataStreams + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/analytics.readonly + - selector: google.analytics.management.v1alpha.Management.UpdateUserLink + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/analytics.manage.users diff --git a/third_party/googleapis/google/analytics/management/v1alpha/management_api.proto b/third_party/googleapis/google/analytics/management/v1alpha/management_api.proto new file mode 100644 index 000000000..2312ae7cc --- /dev/null +++ b/third_party/googleapis/google/analytics/management/v1alpha/management_api.proto @@ -0,0 +1,1315 @@ +// Copyright 2019 Google LLC. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// + +syntax = "proto3"; + +package google.analytics.management.v1alpha; + +import "google/analytics/management/v1alpha/resources.proto"; +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/empty.proto"; +import "google/protobuf/field_mask.proto"; + +option go_package = "google.golang.org/genproto/googleapis/analytics/management/v1alpha;management"; +option java_multiple_files = true; +option java_outer_classname = "ManagementApiProto"; +option java_package = "com.google.analytics.management.v1alpha"; + +// Service Interface for the GA Management API (App+Web). +service Management { + option (google.api.default_host) = "analyticsmanagement.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/analytics.edit," + "https://www.googleapis.com/auth/analytics.manage.users," + "https://www.googleapis.com/auth/analytics.manage.users.readonly," + "https://www.googleapis.com/auth/analytics.readonly"; + + // Lookup for a single Account. + // Throws "Target not found" if no such account found, or if caller does not + // have permissions to access it. + rpc GetAccount(GetAccountRequest) returns (Account) { + option (google.api.http) = { + get: "/v1alpha/{name=accounts/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Returns all accounts accessible by the caller. + // + // Note that these accounts might not currently have App+Web properties. + // Soft-deleted (ie: "trashed") accounts are excluded by default. + // Returns an empty list if no relevant accounts are found. + rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse) { + option (google.api.http) = { + get: "/v1alpha/accounts" + }; + } + + // Marks target Account as soft-deleted (ie: "trashed") and returns it. + // + // This API does not have a method to restore soft-deleted accounts. + // However, they can be restored using the Trash Can UI. + // + // If the accounts are not restored before the expiration time, the account + // and all child resources (eg: Properties, GoogleAdsLinks, Streams, + // UserLinks) will be permanently purged. + // https://support.google.com/analytics/answer/6154772 + // + // Returns an error if the target is not found. + rpc DeleteAccount(DeleteAccountRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1alpha/{name=accounts/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Updates an account. + rpc UpdateAccount(UpdateAccountRequest) returns (Account) { + option (google.api.http) = { + patch: "/v1alpha/{account.name=accounts/*}" + body: "account" + }; + option (google.api.method_signature) = "account,update_mask"; + } + + // Requests a ticket for creating an account. + rpc ProvisionAccountTicket(ProvisionAccountTicketRequest) returns (ProvisionAccountTicketResponse) { + option (google.api.http) = { + post: "/v1alpha/accounts:provisionAccountTicket" + body: "*" + }; + } + + // Lookup for a single "App+Web" Property. + // + // Throws "Target not found" if no such property found, if property is not + // of the type "App+Web", or if caller does not have permissions to access it. + rpc GetProperty(GetPropertyRequest) returns (Property) { + option (google.api.http) = { + get: "/v1alpha/{name=properties/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Returns child Properties under the specified parent Account. + // + // Only "App+Web" properties will be returned. + // Properties will be excluded if the caller does not have access. + // Soft-deleted (ie: "trashed") properties are excluded by default. + // Returns an empty list if no relevant properties are found. + rpc ListProperties(ListPropertiesRequest) returns (ListPropertiesResponse) { + option (google.api.http) = { + get: "/v1alpha/properties" + }; + } + + // Creates an "App+Web" property with the specified location and attributes. + rpc CreateProperty(CreatePropertyRequest) returns (Property) { + option (google.api.http) = { + post: "/v1alpha/properties" + body: "property" + }; + option (google.api.method_signature) = "property"; + } + + // Marks target Property as soft-deleted (ie: "trashed") and returns it. + // + // This API does not have a method to restore soft-deleted properties. + // However, they can be restored using the Trash Can UI. + // + // If the properties are not restored before the expiration time, the Property + // and all child resources (eg: GoogleAdsLinks, Streams, UserLinks) + // will be permanently purged. + // https://support.google.com/analytics/answer/6154772 + // + // Returns an error if the target is not found, or is not an App+Web Property. + rpc DeleteProperty(DeletePropertyRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1alpha/{name=properties/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Updates a property. + rpc UpdateProperty(UpdatePropertyRequest) returns (Property) { + option (google.api.http) = { + patch: "/v1alpha/{property.name=properties/*}" + body: "property" + }; + option (google.api.method_signature) = "property,update_mask"; + } + + // Gets information about a user's link to an account or property. + rpc GetUserLink(GetUserLinkRequest) returns (UserLink) { + option (google.api.http) = { + get: "/v1alpha/{name=accounts/*/userLinks/*}" + additional_bindings { + get: "/v1alpha/{name=properties/*/userLinks/*}" + } + }; + option (google.api.method_signature) = "name"; + } + + // Gets information about multiple users' links to an account or property. + rpc BatchGetUserLinks(BatchGetUserLinksRequest) returns (BatchGetUserLinksResponse) { + option (google.api.http) = { + get: "/v1alpha/{parent=accounts/*}/userLinks:batchGet" + additional_bindings { + get: "/v1alpha/{parent=properties/*}/userLinks:batchGet" + } + }; + } + + // Lists all user links on an account or property. + rpc ListUserLinks(ListUserLinksRequest) returns (ListUserLinksResponse) { + option (google.api.http) = { + get: "/v1alpha/{parent=accounts/*}/userLinks" + additional_bindings { + get: "/v1alpha/{parent=properties/*}/userLinks" + } + }; + option (google.api.method_signature) = "parent"; + } + + // Lists all user links on an account or property, including implicit ones + // that come from effective permissions granted by groups or organization + // admin roles. + // + // If a returned user link does not have direct permissions, they cannot + // be removed from the account or property directly with the DeleteUserLink + // command. They have to be removed from the group/etc that gives them + // permissions, which is currently only usable/discoverable in the GA or GMP + // UIs. + rpc AuditUserLinks(AuditUserLinksRequest) returns (AuditUserLinksResponse) { + option (google.api.http) = { + post: "/v1alpha/{parent=accounts/*}/userLinks:audit" + body: "*" + additional_bindings { + post: "/v1alpha/{parent=properties/*}/userLinks:audit" + body: "*" + } + }; + } + + // Creates a user link on an account or property. + // + // If the user with the specified email already has permissions on the + // account or property, then the user's existing permissions will be unioned + // with the permissions specified in the new UserLink. + rpc CreateUserLink(CreateUserLinkRequest) returns (UserLink) { + option (google.api.http) = { + post: "/v1alpha/{parent=accounts/*}/userLinks" + body: "user_link" + additional_bindings { + post: "/v1alpha/{parent=properties/*}/userLinks" + body: "user_link" + } + }; + option (google.api.method_signature) = "parent,user_link"; + } + + // Creates information about multiple users' links to an account or property. + // + // This method is transactional. If any UserLink cannot be created, none of + // the UserLinks will be created. + rpc BatchCreateUserLinks(BatchCreateUserLinksRequest) returns (BatchCreateUserLinksResponse) { + option (google.api.http) = { + post: "/v1alpha/{parent=accounts/*}/userLinks:batchCreate" + body: "*" + additional_bindings { + post: "/v1alpha/{parent=properties/*}/userLinks:batchCreate" + body: "*" + } + }; + } + + // Updates a user link on an account or property. + rpc UpdateUserLink(UpdateUserLinkRequest) returns (UserLink) { + option (google.api.http) = { + patch: "/v1alpha/{user_link.name=accounts/*/userLinks/*}" + body: "user_link" + additional_bindings { + patch: "/v1alpha/{user_link.name=properties/*/userLinks/*}" + body: "user_link" + } + }; + option (google.api.method_signature) = "user_link"; + } + + // Updates information about multiple users' links to an account or property. + rpc BatchUpdateUserLinks(BatchUpdateUserLinksRequest) returns (BatchUpdateUserLinksResponse) { + option (google.api.http) = { + post: "/v1alpha/{parent=accounts/*}/userLinks:batchUpdate" + body: "*" + additional_bindings { + post: "/v1alpha/{parent=properties/*}/userLinks:batchUpdate" + body: "*" + } + }; + } + + // Deletes a user link on an account or property. + rpc DeleteUserLink(DeleteUserLinkRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1alpha/{name=accounts/*/userLinks/*}" + additional_bindings { + delete: "/v1alpha/{name=properties/*/userLinks/*}" + } + }; + option (google.api.method_signature) = "name"; + } + + // Deletes information about multiple users' links to an account or property. + rpc BatchDeleteUserLinks(BatchDeleteUserLinksRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + post: "/v1alpha/{parent=accounts/*}/userLinks:batchDelete" + body: "*" + additional_bindings { + post: "/v1alpha/{parent=properties/*}/userLinks:batchDelete" + body: "*" + } + }; + } + + // Lookup for a single WebDataStream + // + // Throws "Target not found" if no such web data stream found, or if the + // caller does not have permissions to access it. + rpc GetWebDataStream(GetWebDataStreamRequest) returns (WebDataStream) { + option (google.api.http) = { + get: "/v1alpha/{name=properties/*/webDataStreams/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Deletes a web stream on a property. + rpc DeleteWebDataStream(DeleteWebDataStreamRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1alpha/{name=properties/*/webDataStreams/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Updates a web stream on a property. + rpc UpdateWebDataStream(UpdateWebDataStreamRequest) returns (WebDataStream) { + option (google.api.http) = { + patch: "/v1alpha/{web_data_stream.name=properties/*/webDataStreams/*}" + body: "web_data_stream" + }; + option (google.api.method_signature) = "web_data_stream,update_mask"; + } + + // Creates a web stream with the specified location and attributes. + rpc CreateWebDataStream(CreateWebDataStreamRequest) returns (WebDataStream) { + option (google.api.http) = { + post: "/v1alpha/{parent=properties/*}/webDataStreams" + body: "web_data_stream" + }; + option (google.api.method_signature) = "parent,web_data_stream"; + } + + // Returns child web data streams under the specified parent property. + // + // Web data streams will be excluded if the caller does not have access. + // Returns an empty list if no relevant web data streams are found. + rpc ListWebDataStreams(ListWebDataStreamsRequest) returns (ListWebDataStreamsResponse) { + option (google.api.http) = { + get: "/v1alpha/{parent=properties/*}/webDataStreams" + }; + option (google.api.method_signature) = "parent"; + } + + // Lookup for a single IosAppDataStream + // + // Throws "Target not found" if no such iOS app data stream found, or if the + // caller does not have permissions to access it. + rpc GetIosAppDataStream(GetIosAppDataStreamRequest) returns (IosAppDataStream) { + option (google.api.http) = { + get: "/v1alpha/{name=properties/*/iosAppDataStreams/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Deletes an iOS app stream on a property. + rpc DeleteIosAppDataStream(DeleteIosAppDataStreamRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1alpha/{name=properties/*/iosAppDataStreams/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Updates an iOS app stream on a property. + rpc UpdateIosAppDataStream(UpdateIosAppDataStreamRequest) returns (IosAppDataStream) { + option (google.api.http) = { + patch: "/v1alpha/{ios_app_data_stream.name=properties/*/iosAppDataStreams/*}" + body: "ios_app_data_stream" + }; + option (google.api.method_signature) = "ios_app_data_stream,update_mask"; + } + + // Creates an iOS app data stream with the specified location and attributes. + rpc CreateIosAppDataStream(CreateIosAppDataStreamRequest) returns (IosAppDataStream) { + option (google.api.http) = { + post: "/v1alpha/{parent=properties/*}/iosAppDataStreams" + body: "ios_app_data_stream" + }; + option (google.api.method_signature) = "parent,ios_app_data_stream"; + } + + // Returns child iOS app data streams under the specified parent property. + // + // iOS app data streams will be excluded if the caller does not have access. + // Returns an empty list if no relevant iOS app data streams are found. + rpc ListIosAppDataStreams(ListIosAppDataStreamsRequest) returns (ListIosAppDataStreamsResponse) { + option (google.api.http) = { + get: "/v1alpha/{parent=properties/*}/iosAppDataStreams" + }; + option (google.api.method_signature) = "parent"; + } + + // Lookup for a single AndroidAppDataStream + // + // Throws "Target not found" if no such android app data stream found, or if + // the caller does not have permissions to access it. + rpc GetAndroidAppDataStream(GetAndroidAppDataStreamRequest) returns (AndroidAppDataStream) { + option (google.api.http) = { + get: "/v1alpha/{name=properties/*/androidAppDataStreams/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Deletes an android app stream on a property. + rpc DeleteAndroidAppDataStream(DeleteAndroidAppDataStreamRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1alpha/{name=properties/*/androidAppDataStreams/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Updates an android app stream on a property. + rpc UpdateAndroidAppDataStream(UpdateAndroidAppDataStreamRequest) returns (AndroidAppDataStream) { + option (google.api.http) = { + patch: "/v1alpha/{android_app_data_stream.name=properties/*/androidAppDataStreams/*}" + body: "android_app_data_stream" + }; + option (google.api.method_signature) = "android_app_data_stream,update_mask"; + } + + // Creates an android app stream with the specified location and attributes. + rpc CreateAndroidAppDataStream(CreateAndroidAppDataStreamRequest) returns (AndroidAppDataStream) { + option (google.api.http) = { + post: "/v1alpha/{parent=properties/*}/androidAppDataStreams" + body: "android_app_data_stream" + }; + option (google.api.method_signature) = "parent,android_app_data_stream"; + } + + // Returns child android app streams under the specified parent property. + // + // Android app streams will be excluded if the caller does not have access. + // Returns an empty list if no relevant android app streams are found. + rpc ListAndroidAppDataStreams(ListAndroidAppDataStreamsRequest) returns (ListAndroidAppDataStreamsResponse) { + option (google.api.http) = { + get: "/v1alpha/{parent=properties/*}/androidAppDataStreams" + }; + option (google.api.method_signature) = "parent"; + } + + // Returns the singleton enhanced measurement settings for this web stream. + // Note that the stream must enable enhanced measurement for these settings to + // take effect. + rpc GetEnhancedMeasurementSettings(GetEnhancedMeasurementSettingsRequest) returns (EnhancedMeasurementSettings) { + option (google.api.http) = { + get: "/v1alpha/{name=properties/*/webDataStreams/*/enhancedMeasurementSettings}" + }; + option (google.api.method_signature) = "name"; + } + + // Updates the singleton enhanced measurement settings for this web stream. + // Note that the stream must enable enhanced measurement for these settings to + // take effect. + rpc UpdateEnhancedMeasurementSettings(UpdateEnhancedMeasurementSettingsRequest) returns (EnhancedMeasurementSettings) { + option (google.api.http) = { + patch: "/v1alpha/{enhanced_measurement_settings.name=properties/*/webDataStreams/*/enhancedMeasurementSettings}" + body: "enhanced_measurement_settings" + }; + option (google.api.method_signature) = "enhanced_measurement_settings,update_mask"; + } + + // Creates a FirebaseLink. + // + // Properties can have at most one FirebaseLink. + rpc CreateFirebaseLink(CreateFirebaseLinkRequest) returns (FirebaseLink) { + option (google.api.http) = { + post: "/v1alpha/{parent=properties/*}/firebaseLinks" + body: "firebase_link" + }; + option (google.api.method_signature) = "parent,firebase_link"; + } + + // Updates a FirebaseLink on a property + rpc UpdateFirebaseLink(UpdateFirebaseLinkRequest) returns (FirebaseLink) { + option (google.api.http) = { + patch: "/v1alpha/{firebase_link.name=properties/*/firebaseLinks/*}" + body: "firebase_link" + }; + option (google.api.method_signature) = "firebase_link,update_mask"; + } + + // Deletes a FirebaseLink on a property + rpc DeleteFirebaseLink(DeleteFirebaseLinkRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1alpha/{name=properties/*/firebaseLinks/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Lists FirebaseLinks on a property. + // Properties can have at most one FirebaseLink. + rpc ListFirebaseLinks(ListFirebaseLinksRequest) returns (ListFirebaseLinksResponse) { + option (google.api.http) = { + get: "/v1alpha/{parent=properties/*}/firebaseLinks" + }; + option (google.api.method_signature) = "parent"; + } + + // Returns the Site Tag for the specified web stream. + // Site Tags are immutable singletons. + rpc GetGlobalSiteTag(GetGlobalSiteTagRequest) returns (GlobalSiteTag) { + option (google.api.http) = { + get: "/v1alpha/{name=properties/*/webDataStreams/*/globalSiteTag}" + }; + option (google.api.method_signature) = "name"; + } + + // Creates a GoogleAdsLink. + rpc CreateGoogleAdsLink(CreateGoogleAdsLinkRequest) returns (GoogleAdsLink) { + option (google.api.http) = { + post: "/v1alpha/{parent=properties/*}/googleAdsLinks" + body: "google_ads_link" + }; + option (google.api.method_signature) = "parent,google_ads_link"; + } + + // Updates a GoogleAdsLink on a property + rpc UpdateGoogleAdsLink(UpdateGoogleAdsLinkRequest) returns (GoogleAdsLink) { + option (google.api.http) = { + patch: "/v1alpha/{google_ads_link.name=properties/*/googleAdsLinks/*}" + body: "google_ads_link" + }; + option (google.api.method_signature) = "google_ads_link,update_mask"; + } + + // Deletes a GoogleAdsLink on a property + rpc DeleteGoogleAdsLink(DeleteGoogleAdsLinkRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1alpha/{name=properties/*/googleAdsLinks/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Lists GoogleAdsLinks on a property. + rpc ListGoogleAdsLinks(ListGoogleAdsLinksRequest) returns (ListGoogleAdsLinksResponse) { + option (google.api.http) = { + get: "/v1alpha/{parent=properties/*}/googleAdsLinks" + }; + option (google.api.method_signature) = "parent"; + } +} + +// Request message for GetAccount RPC. +message GetAccountRequest { + // Required. The name of the account to lookup. + // Format: accounts/{account_id} + // Example: "accounts/100" + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "analyticsmanagement.googleapis.com/Account" + } + ]; +} + +// Request message for ListAccounts RPC. +message ListAccountsRequest { + // The maximum number of resources to return. The service may return + // fewer than this value, even if there are additional pages. + // If unspecified, at most 50 resources will be returned. + // The maximum value is 200; (higher values will be coerced to the maximum) + int32 page_size = 1; + + // A page token, received from a previous `ListAccounts` call. + // Provide this to retrieve the subsequent page. + // When paginating, all other parameters provided to `ListAccounts` must + // match the call that provided the page token. + string page_token = 2; + + // Whether to include soft-deleted (ie: "trashed") Accounts in the + // results. Accounts can be inspected to determine whether they are deleted or + // not. + bool show_deleted = 3; +} + +// Request message for ListAccounts RPC. +message ListAccountsResponse { + // Results that were accessible to the caller. + repeated Account accounts = 1; + + // A token, which can be sent as `page_token` to retrieve the next page. + // If this field is omitted, there are no subsequent pages. + string next_page_token = 2; +} + +// Request message for DeleteAccount RPC. +message DeleteAccountRequest { + // Required. The name of the Account to soft-delete. + // Format: accounts/{account_id} + // Example: "accounts/100" + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "analyticsmanagement.googleapis.com/Account" + } + ]; +} + +// Request message for UpdateAccount RPC. +message UpdateAccountRequest { + // Required. The account to update. + // The account's `name` field is used to identify the account. + Account account = 1 [(google.api.field_behavior) = REQUIRED]; + + // The list of fields to be updated. Omitted fields will not be updated. + google.protobuf.FieldMask update_mask = 2; +} + +// Request message for ProvisionAccountTicket RPC. +message ProvisionAccountTicketRequest { + // The account to create. + Account account = 1; + + // Redirect URI where the user will be sent after accepting Terms of Service. + // Must be configured in Developers Console as a Redirect URI + string redirect_uri = 2; +} + +// Response message for ProvisionAccountTicket RPC. +message ProvisionAccountTicketResponse { + // The param to be passed in the ToS link. + string account_ticket_id = 1; +} + +// Request message for GetProperty RPC. +message GetPropertyRequest { + // Required. The name of the property to lookup. + // Format: properties/{property_id} + // Example: "properties/1000" + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "analyticsmanagement.googleapis.com/Property" + } + ]; +} + +// Request message for ListProperties RPC. +message ListPropertiesRequest { + // Required. An expression for filtering the results of the request. + // Fields eligible for filtering are: + // `parent:`(The resource name of the parent account) or + // `firebase_project:`(The id or number of the linked firebase project). + // Some examples of filters: + // + // | Filter | Description | + // |-----------------------------|-------------------------------------------| + // | parent:accounts/123 | The account with account id: 123. | + // | firebase_project:project-id | The firebase project with id: project-id. | + // | firebase_project:123 | The firebase project with number: 123. | + string filter = 1 [(google.api.field_behavior) = REQUIRED]; + + // The maximum number of resources to return. The service may return + // fewer than this value, even if there are additional pages. + // If unspecified, at most 50 resources will be returned. + // The maximum value is 200; (higher values will be coerced to the maximum) + int32 page_size = 2; + + // A page token, received from a previous `ListProperties` call. + // Provide this to retrieve the subsequent page. + // When paginating, all other parameters provided to `ListProperties` must + // match the call that provided the page token. + string page_token = 3; + + // Whether to include soft-deleted (ie: "trashed") Properties in the + // results. Properties can be inspected to determine whether they are deleted + // or not. + bool show_deleted = 4; +} + +// Response message for ListProperties RPC. +message ListPropertiesResponse { + // Results that matched the filter criteria and were accessible to the caller. + repeated Property properties = 1; + + // A token, which can be sent as `page_token` to retrieve the next page. + // If this field is omitted, there are no subsequent pages. + string next_page_token = 2; +} + +// Request message for UpdateProperty RPC. +message UpdatePropertyRequest { + // Required. The property to update. + // The property's `name` field is used to identify the property to be + // updated. + Property property = 1 [(google.api.field_behavior) = REQUIRED]; + + // The list of fields to be updated. Omitted fields will not be updated. + google.protobuf.FieldMask update_mask = 2; +} + +// Request message for CreateProperty RPC. +message CreatePropertyRequest { + // Required. The property to create. + // Note: the supplied property must specify its parent. + Property property = 1 [(google.api.field_behavior) = REQUIRED]; +} + +// Request message for DeleteProperty RPC. +message DeletePropertyRequest { + // Required. The name of the Property to soft-delete. + // Format: properties/{property_id} + // Example: "properties/1000" + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "analyticsmanagement.googleapis.com/Property" + } + ]; +} + +// Request message for GetUserLink RPC. +message GetUserLinkRequest { + // Required. Example format: accounts/1234/userLinks/5678 + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "analyticsmanagement.googleapis.com/UserLink" + } + ]; +} + +// Request message for BatchGetUserLinks RPC. +message BatchGetUserLinksRequest { + // Required. The account or property that all user links in the request are + // for. The parent of all provided values for the 'names' field must match + // this field. + // Example format: accounts/1234 + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "analyticsmanagement.googleapis.com/UserLink" + } + ]; + + // Required. The names of the user links to retrieve. + // A maximum of 1000 user links can be retrieved in a batch. + // Format: accounts/{accountId}/userLinks/{userLinkId} + repeated string names = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "analyticsmanagement.googleapis.com/UserLink" + } + ]; +} + +// Response message for BatchGetUserLinks RPC. +message BatchGetUserLinksResponse { + // The requested user links. + repeated UserLink user_links = 1; +} + +// Request message for ListUserLinks RPC. +message ListUserLinksRequest { + // Required. Example format: accounts/1234 + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "analyticsmanagement.googleapis.com/UserLink" + } + ]; + + // The maximum number of user links to return. + // The service may return fewer than this value. + // If unspecified, at most 200 user links will be returned. + // The maximum value is 500; values above 500 will be coerced to 500. + int32 page_size = 2; + + // A page token, received from a previous `ListUserLinks` call. + // Provide this to retrieve the subsequent page. + // When paginating, all other parameters provided to `ListUserLinks` must + // match the call that provided the page token. + string page_token = 3; +} + +// Response message for ListUserLinks RPC. +message ListUserLinksResponse { + // List of UserLinks. These will be ordered stably, but in an arbitrary order. + repeated UserLink user_links = 1; + + // A token, which can be sent as `page_token` to retrieve the next page. + // If this field is omitted, there are no subsequent pages. + string next_page_token = 2; +} + +// Request message for AuditUserLinks RPC. +message AuditUserLinksRequest { + // Required. Example format: accounts/1234 + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "analyticsmanagement.googleapis.com/UserLink" + } + ]; + + // The maximum number of user links to return. + // The service may return fewer than this value. + // If unspecified, at most 1000 user links will be returned. + // The maximum value is 5000; values above 5000 will be coerced to 5000. + int32 page_size = 2; + + // A page token, received from a previous `AuditUserLinks` call. + // Provide this to retrieve the subsequent page. + // When paginating, all other parameters provided to `AuditUserLinks` must + // match the call that provided the page token. + string page_token = 3; +} + +// Response message for AuditUserLinks RPC. +message AuditUserLinksResponse { + // List of AuditUserLinks. These will be ordered stably, but in an arbitrary + // order. + repeated AuditUserLink user_links = 1; + + // A token, which can be sent as `page_token` to retrieve the next page. + // If this field is omitted, there are no subsequent pages. + string next_page_token = 2; +} + +// Request message for CreateUserLink RPC. +// +// Users can have multiple email addresses associated with their Google +// account, and one of these email addresses is the "primary" email address. +// Any of the email addresses associated with a Google account may be used +// for a new UserLink, but the returned UserLink will always contain the +// "primary" email address. As a result, the input and output email address +// for this request may differ. +message CreateUserLinkRequest { + // Required. Example format: accounts/1234 + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "analyticsmanagement.googleapis.com/UserLink" + } + ]; + + // Required. The user link to create. + UserLink user_link = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// Request message for BatchCreateUserLinks RPC. +message BatchCreateUserLinksRequest { + // Required. The account or property that all user links in the request are for. + // This field is required. The parent field in the CreateUserLinkRequest + // messages must either be empty or match this field. + // Example format: accounts/1234 + string parent = 1 [(google.api.field_behavior) = REQUIRED]; + + // The requests specifying the user links to create. + // A maximum of 1000 user links can be created in a batch. + repeated CreateUserLinkRequest requests = 2; +} + +// Response message for BatchCreateUserLinks RPC. +message BatchCreateUserLinksResponse { + // The user links created. + repeated UserLink user_links = 1; +} + +// Request message for UpdateUserLink RPC. +message UpdateUserLinkRequest { + // Required. The user link to update. + UserLink user_link = 1 [(google.api.field_behavior) = REQUIRED]; +} + +// Request message for BatchUpdateUserLinks RPC. +message BatchUpdateUserLinksRequest { + // Required. The account or property that all user links in the request are + // for. The parent field in the UpdateUserLinkRequest messages must either be + // empty or match this field. + // Example format: accounts/1234 + string parent = 1 [(google.api.field_behavior) = REQUIRED]; + + // The requests specifying the user links to update. + // A maximum of 1000 user links can be updated in a batch. + repeated UpdateUserLinkRequest requests = 2; +} + +// Response message for BatchUpdateUserLinks RPC. +message BatchUpdateUserLinksResponse { + // The user links updated. + repeated UserLink user_links = 1; +} + +// Request message for DeleteUserLink RPC. +message DeleteUserLinkRequest { + // Required. Example format: accounts/1234/userLinks/5678 + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "analyticsmanagement.googleapis.com/UserLink" + } + ]; +} + +// Request message for BatchDeleteUserLinks RPC. +message BatchDeleteUserLinksRequest { + // Required. The account or property that all user links in the request are + // for. The parent of all values for user link names to delete must match this + // field. + // Example format: accounts/1234 + string parent = 1 [(google.api.field_behavior) = REQUIRED]; + + // The requests specifying the user links to update. + // A maximum of 1000 user links can be updated in a batch. + repeated DeleteUserLinkRequest requests = 2; +} + +// Request message for GetWebDataStream RPC. +message GetWebDataStreamRequest { + // Required. The name of the web data stream to lookup. + // Format: properties/{property_id}/webDataStreams/{stream_id} + // Example: "properties/123/webDataStreams/456" + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "analyticsmanagement.googleapis.com/WebDataStream" + } + ]; +} + +// Request message for DeleteWebDataStream RPC. +message DeleteWebDataStreamRequest { + // Required. The name of the web data stream to delete. + // Format: properties/{property_id}/webDataStreams/{stream_id} + // Example: "properties/123/webDataStreams/456" + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "analyticsmanagement.googleapis.com/WebDataStream" + } + ]; +} + +// Request message for UpdateWebDataStream RPC. +message UpdateWebDataStreamRequest { + // Required. The web stream to update. + // The `name` field is used to identify the web stream to be updated. + WebDataStream web_data_stream = 1 [(google.api.field_behavior) = REQUIRED]; + + // The list of fields to be updated. Omitted fields will not be updated. + google.protobuf.FieldMask update_mask = 2; +} + +// Request message for CreateWebDataStream RPC. +message CreateWebDataStreamRequest { + // Required. The web stream to create. + WebDataStream web_data_stream = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The parent resource where this web data stream will be created. + // Format: properties/123 + string parent = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "analyticsmanagement.googleapis.com/WebDataStream" + } + ]; +} + +// Request message for ListWebDataStreams RPC. +message ListWebDataStreamsRequest { + // Required. The name of the parent property. + // For example, to list results of web streams under the property with Id + // 123: "properties/123" + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "analyticsmanagement.googleapis.com/WebDataStream" + } + ]; + + // The maximum number of resources to return. + // If unspecified, at most 50 resources will be returned. + // The maximum value is 200; (higher values will be coerced to the maximum) + int32 page_size = 2; + + // A page token, received from a previous `ListWebDataStreams` call. + // Provide this to retrieve the subsequent page. + // When paginating, all other parameters provided to `ListWebDataStreams` must + // match the call that provided the page token. + string page_token = 3; +} + +// Request message for ListWebDataStreams RPC. +message ListWebDataStreamsResponse { + // Results that matched the filter criteria and were accessible to the caller. + repeated WebDataStream web_data_streams = 1; + + // A token, which can be sent as `page_token` to retrieve the next page. + // If this field is omitted, there are no subsequent pages. + string next_page_token = 2; +} + +// Request message for GetIosAppDataStream RPC. +message GetIosAppDataStreamRequest { + // Required. The name of the iOS app data stream to lookup. + // Format: properties/{property_id}/iosAppDataStreams/{stream_id} + // Example: "properties/123/iosAppDataStreams/456" + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "analyticsmanagement.googleapis.com/IosAppDataStream" + } + ]; +} + +// Request message for DeleteIosAppDataStream RPC. +message DeleteIosAppDataStreamRequest { + // Required. The name of the iOS app data stream to delete. + // Format: properties/{property_id}/iosAppDataStreams/{stream_id} + // Example: "properties/123/iosAppDataStreams/456" + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "analyticsmanagement.googleapis.com/IosAppDataStream" + } + ]; +} + +// Request message for UpdateIosAppDataStream RPC. +message UpdateIosAppDataStreamRequest { + // Required. The iOS app stream to update. + // The `name` field is used to identify the iOS app stream to be updated. + IosAppDataStream ios_app_data_stream = 1 [(google.api.field_behavior) = REQUIRED]; + + // The list of fields to be updated. Omitted fields will not be updated. + google.protobuf.FieldMask update_mask = 2; +} + +// Request message for CreateIosAppDataStream RPC. +message CreateIosAppDataStreamRequest { + // Required. The iOS app data stream to create. + IosAppDataStream ios_app_data_stream = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The parent resource where this ios app data stream will be created. + // Format: properties/123 + string parent = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "analyticsmanagement.googleapis.com/IosAppDataStream" + } + ]; +} + +// Request message for ListIosAppDataStreams RPC. +message ListIosAppDataStreamsRequest { + // Required. The name of the parent property. + // For example, to list results of app streams under the property with Id + // 123: "properties/123" + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "analyticsmanagement.googleapis.com/IosAppDataStream" + } + ]; + + // The maximum number of resources to return. + // If unspecified, at most 50 resources will be returned. + // The maximum value is 200; (higher values will be coerced to the maximum) + int32 page_size = 2; + + // A page token, received from a previous `ListIosAppDataStreams` + // call. Provide this to retrieve the subsequent page. + // When paginating, all other parameters provided to `ListIosAppDataStreams` + // must match the call that provided the page token. + string page_token = 3; +} + +// Request message for ListIosAppDataStreams RPC. +message ListIosAppDataStreamsResponse { + // Results that matched the filter criteria and were accessible to the caller. + repeated IosAppDataStream ios_app_data_streams = 1; + + // A token, which can be sent as `page_token` to retrieve the next page. + // If this field is omitted, there are no subsequent pages. + string next_page_token = 2; +} + +// Request message for GetAndroidAppDataStream RPC. +message GetAndroidAppDataStreamRequest { + // Required. The name of the android app data stream to lookup. + // Format: properties/{property_id}/androidAppDataStreams/{stream_id} + // Example: "properties/123/androidAppDataStreams/456" + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "analyticsmanagement.googleapis.com/AndroidAppDataStream" + } + ]; +} + +// Request message for DeleteAndroidAppDataStream RPC. +message DeleteAndroidAppDataStreamRequest { + // Required. The name of the android app data stream to delete. + // Format: properties/{property_id}/androidAppDataStreams/{stream_id} + // Example: "properties/123/androidAppDataStreams/456" + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "analyticsmanagement.googleapis.com/AndroidAppDataStream" + } + ]; +} + +// Request message for UpdateAndroidAppDataStream RPC. +message UpdateAndroidAppDataStreamRequest { + // Required. The android app stream to update. + // The `name` field is used to identify the android app stream to be updated. + AndroidAppDataStream android_app_data_stream = 1 [(google.api.field_behavior) = REQUIRED]; + + // The list of fields to be updated. Omitted fields will not be updated. + google.protobuf.FieldMask update_mask = 2; +} + +// Request message for CreateAndroidAppDataStream RPC. +message CreateAndroidAppDataStreamRequest { + // Required. The android app stream to create. + AndroidAppDataStream android_app_data_stream = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The parent resource where this android app data stream will be created. + // Format: properties/123 + string parent = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "analyticsmanagement.googleapis.com/AndroidAppDataStream" + } + ]; +} + +// Request message for ListAndroidAppDataStreams RPC. +message ListAndroidAppDataStreamsRequest { + // Required. The name of the parent property. + // For example, to limit results to app streams under the property with Id + // 123: "properties/123" + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "analyticsmanagement.googleapis.com/AndroidAppDataStream" + } + ]; + + // The maximum number of resources to return. + // + // If unspecified, at most 50 resources will be returned. + // The maximum value is 200; (higher values will be coerced to the maximum) + int32 page_size = 2; + + // A page token, received from a previous call. Provide this to + // retrieve the subsequent page. + // When paginating, all other parameters provided to + // `ListAndroidAppDataStreams` must match the call that provided the page + // token. + string page_token = 3; +} + +// Request message for ListAndroidDataStreams RPC. +message ListAndroidAppDataStreamsResponse { + // Results that matched the filter criteria and were accessible to the caller. + repeated AndroidAppDataStream android_app_data_streams = 1; + + // A token, which can be sent as `page_token` to retrieve the next page. + // If this field is omitted, there are no subsequent pages. + string next_page_token = 2; +} + +// Request message for GetEnhancedMeasurementSettings RPC. +message GetEnhancedMeasurementSettingsRequest { + // Required. The name of the settings to lookup. + // Format: + // properties/{property_id}/webDataStreams/{stream_id}/enhancedMeasurementSettings + // Example: "properties/1000/webDataStreams/2000/enhancedMeasurementSettings" + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "analyticsmanagement.googleapis.com/EnhancedMeasurementSettings" + } + ]; +} + +// Request message for UpdateEnhancedMeasurementSettings RPC. +message UpdateEnhancedMeasurementSettingsRequest { + // Required. The settings to update. + // The `name` field is used to identify the settings to be updated. + EnhancedMeasurementSettings enhanced_measurement_settings = 1 [(google.api.field_behavior) = REQUIRED]; + + // The list of fields to be updated. Omitted fields will not be updated. + google.protobuf.FieldMask update_mask = 2; +} + +// Request message for CreateFirebaseLink RPC +message CreateFirebaseLinkRequest { + // Required. Format: properties/{property_id} + // Example: properties/1234 + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "analyticsmanagement.googleapis.com/FirebaseLink" + } + ]; + + // Required. The Firebase link to create. + FirebaseLink firebase_link = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// Request message for UpdateFirebaseLink RPC +message UpdateFirebaseLinkRequest { + // Required. The Firebase link to update. + FirebaseLink firebase_link = 1 [(google.api.field_behavior) = REQUIRED]; + + // The list of fields to be updated. Omitted fields will not be updated. + google.protobuf.FieldMask update_mask = 2; +} + +// Request message for DeleteFirebaseLink RPC +message DeleteFirebaseLinkRequest { + // Required. Format: properties/{property_id}/firebaseLinks/{firebase_link_id} + // Example: properties/1234/firebaseLinks/5678 + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "analyticsmanagement.googleapis.com/FirebaseLink" + } + ]; +} + +// Request message for ListFirebaseLinks RPC +message ListFirebaseLinksRequest { + // Required. Format: properties/{property_id} + // Example: properties/1234 + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "analyticsmanagement.googleapis.com/FirebaseLink" + } + ]; +} + +// Response message for ListFirebaseLinks RPC +message ListFirebaseLinksResponse { + // List of FirebaseLinks. This will have at most one value. + repeated FirebaseLink firebase_links = 1; +} + +// Request message for GetGlobalSiteTag RPC. +message GetGlobalSiteTagRequest { + // Required. The name of the site tag to lookup. + // Note that site tags are singletons and do not have unique IDs. + // Format: properties/{property_id}/webDataStreams/{stream_id}/globalSiteTag + // Example: "properties/123/webDataStreams/456/globalSiteTag" + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "analyticsmanagement.googleapis.com/GlobalSiteTag" + } + ]; +} + +// Request message for CreateGoogleAdsLink RPC +message CreateGoogleAdsLinkRequest { + // Required. Example format: properties/1234 + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "analyticsmanagement.googleapis.com/GoogleAdsLink" + } + ]; + + // Required. The GoogleAdsLink to create. + GoogleAdsLink google_ads_link = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// Request message for UpdateGoogleAdsLink RPC +message UpdateGoogleAdsLinkRequest { + // The GoogleAdsLink to update + GoogleAdsLink google_ads_link = 1; + + // The list of fields to be updated. Omitted fields will not be updated. + google.protobuf.FieldMask update_mask = 2; +} + +// Request message for DeleteGoogleAdsLink RPC. +message DeleteGoogleAdsLinkRequest { + // Required. Example format: properties/1234/googleAdsLinks/5678 + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "analyticsmanagement.googleapis.com/GoogleAdsLink" + } + ]; +} + +// Request message for ListGoogleAdsLinks RPC. +message ListGoogleAdsLinksRequest { + // Required. Example format: properties/1234 + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "analyticsmanagement.googleapis.com/GoogleAdsLink" + } + ]; + + // The maximum number of resources to return. + // If unspecified, at most 50 resources will be returned. + // The maximum value is 200 (higher values will be coerced to the maximum). + int32 page_size = 2; + + // A page token, received from a previous `ListGoogleAdsLinks` call. + // Provide this to retrieve the subsequent page. + // + // When paginating, all other parameters provided to `ListGoogleAdsLinks` must + // match the call that provided the page token. + string page_token = 3; +} + +// Response message for ListGoogleAdsLinks RPC. +message ListGoogleAdsLinksResponse { + // List of GoogleAdsLinks. + repeated GoogleAdsLink google_ads_links = 1; + + // A token, which can be sent as `page_token` to retrieve the next page. + // If this field is omitted, there are no subsequent pages. + string next_page_token = 2; +} diff --git a/third_party/googleapis/google/analytics/management/v1alpha/management_grpc_service_config.json b/third_party/googleapis/google/analytics/management/v1alpha/management_grpc_service_config.json new file mode 100644 index 000000000..19d999b66 --- /dev/null +++ b/third_party/googleapis/google/analytics/management/v1alpha/management_grpc_service_config.json @@ -0,0 +1,148 @@ +{ + "methodConfig": [ + { + "timeout": "60s", + "name": [ + { + "service": "google.analytics.management.v1alpha.Management", + "method": "GetAccount" + }, + { + "service": "google.analytics.management.v1alpha.Management", + "method": "ListAccounts" + }, + { + "service": "google.analytics.management.v1alpha.Management", + "method": "DeleteAccount" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "UpdateAccount" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "ProvisionAccountTicket" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "GetProperty" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "ListProperties" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "DeleteProperty" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "CreateProperty" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "UpdateProperty" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "GetUserLink" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "BatchGetUserLinks" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "ListUserLinks" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "AuditUserLinks" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "CreateUserLink" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "BatchCreateUserLinks" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "UpdateUserLink" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "BatchUpdateUserLinks" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "DeleteUserLink" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "BatchDeleteUserLinks" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "GetWebDataStream" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "UpdateWebDataStream" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "CreateWebDataStream" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "ListWebDataStreams" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "GetIosAppDataStream" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "DeleteIosAppDataStream" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "UpdateIosAppDataStream" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "CreateIosAppDataStream" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "ListIosAppDataStreams" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "GetAndroidAppDataStream" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "DeleteAndroidAppDataStream" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "UpdateAndroidAppDataStream" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "CreateAndroidAppDataStream" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "ListAndroidAppDataStreams" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "GetEnhancedMeasurementSettings" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "UpdateEnhancedMeasurementSettings" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "CreateFirebaseLink" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "UpdateFirebaseLink" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "DeleteFirebaseLink" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "ListFirebaseLinks" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "GetGlobalSiteTag" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "CreateGoogleAdsLink" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "UpdateGoogleAdsLink" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "DeleteGoogleAdsLink" + }, { + "service": "google.analytics.management.v1alpha.Management", + "method": "ListGoogleAdsLinks" + } + ], + "timeout": "60s" + } + ] +} diff --git a/third_party/googleapis/google/analytics/management/v1alpha/resources.proto b/third_party/googleapis/google/analytics/management/v1alpha/resources.proto new file mode 100644 index 000000000..2db63ff62 --- /dev/null +++ b/third_party/googleapis/google/analytics/management/v1alpha/resources.proto @@ -0,0 +1,526 @@ +// Copyright 2019 Google LLC. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// + +syntax = "proto3"; + +package google.analytics.management.v1alpha; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/timestamp.proto"; + +option go_package = "google.golang.org/genproto/googleapis/analytics/management/v1alpha;management"; +option java_multiple_files = true; +option java_outer_classname = "ResourcesProto"; +option java_package = "com.google.analytics.management.v1alpha"; + +// NEXT TAG: 7 +// A resource message representing a Google Analytics account. +message Account { + option (google.api.resource) = { + type: "analyticsmanagement.googleapis.com/Account" + pattern: "accounts/{account}" + }; + + // Output only. Resource name of this account. + // Format: accounts/{account_id} + // Example: "accounts/100" + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Time when this account was originally created. + google.protobuf.Timestamp create_time = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Time when account payload fields were last updated. + google.protobuf.Timestamp update_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Human-readable display name for this account. + string display_name = 4; + + // Country of business. Must be a non-deprecated code for a UN M.49 region. + // https://unicode.org/cldr/charts/latest/supplemental/territory_containment_un_m_49.html + string country_code = 5; + + // Output only. Indicates whether this Account is soft-deleted or not. Deleted + // accounts are excluded from List results unless specifically requested. + bool deleted = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// NEXT TAG: 10 +// A resource message representing a Google Analytics App+Web property. +message Property { + option (google.api.resource) = { + type: "analyticsmanagement.googleapis.com/Property" + pattern: "properties/{property}" + }; + + // Output only. Resource name of this property. + // Format: properties/{property_id} + // Example: "properties/1000" + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Time when the entity was originally created. + google.protobuf.Timestamp create_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Time when entity payload fields were last updated. + google.protobuf.Timestamp update_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. Resource name of this property's logical parent. + // + // Note: The Property-Moving UI can be used to change the parent. + // Format: accounts/{account_id} + // Example: "accounts/100" + string parent = 2 [(google.api.field_behavior) = IMMUTABLE]; + + // Human-readable display name for this property. + string display_name = 5; + + // Industry associated with this property + // Example: AUTOMOTIVE, FOOD_AND_DRINK + IndustryCategory industry_category = 6; + + // Reporting Time Zone, used as the day boundary for reports, regardless of + // where the data originates. If the time zone honors DST, Analytics will + // automatically adjust for the changes. + // + // NOTE: Changing the time zone only affects data going forward, and is not + // applied retroactively. + // + // Format: https://www.iana.org/time-zones + // Example: "America/Los_Angeles" + string time_zone = 7; + + // The currency type used in reports involving monetary values. + // + // + // Format: https://en.wikipedia.org/wiki/ISO_4217 + // Examples: "USD", "EUR", "JPY" + string currency_code = 8; + + // Output only. Indicates whether this Property is soft-deleted or not. Deleted properties + // are excluded from List results unless specifically requested. + bool deleted = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// A resource message representing a Google Analytics Android app stream. +message AndroidAppDataStream { + option (google.api.resource) = { + type: "analyticsmanagement.googleapis.com/AndroidAppDataStream" + pattern: "properties/{property}/androidAppDataStreams/{android_app_data_stream}" + }; + + // Output only. Resource name of this Data Stream. + // Format: properties/{property_id}/androidAppDataStreams/{stream_id} + // Example: "properties/1000/androidAppDataStreams/2000" + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Analytics "Measurement ID", without the "G-" prefix. + // ex: "G-1A2BCD345E" would just be "1A2BCD345E" + string measurement_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. ID of the corresponding Android app in Firebase, if any. + // This ID can change if the Android app is deleted and recreated. + string firebase_app_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Time when this stream was originally created. + google.protobuf.Timestamp create_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Time when stream payload fields were last updated. + google.protobuf.Timestamp update_time = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. The package name for the app being measured. + // Example: "com.example.myandroidapp" + string package_name = 6 [(google.api.field_behavior) = IMMUTABLE]; + + // Human-readable display name for the Data Stream. + string display_name = 7; +} + +// A resource message representing a Google Analytics IOS app stream. +message IosAppDataStream { + option (google.api.resource) = { + type: "analyticsmanagement.googleapis.com/IosAppDataStream" + pattern: "properties/{property}/iosAppDataStreams/{ios_app_data_stream}" + }; + + // Output only. Resource name of this Data Stream. + // Format: properties/{property_id}/iosAppDataStreams/{stream_id} + // Example: "properties/1000/iosAppDataStreams/2000" + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Analytics "Measurement ID", without the "G-" prefix. + // Example: "G-1A2BCD345E" would just be "1A2BCD345E" + string measurement_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. ID of the corresponding iOS app in Firebase, if any. + // This ID can change if the iOS app is deleted and recreated. + string firebase_app_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Time when this stream was originally created. + google.protobuf.Timestamp create_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Time when stream payload fields were last updated. + google.protobuf.Timestamp update_time = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. The Apple App Store Bundle ID for the app + // Example: "com.example.myiosapp" + string bundle_id = 6 [(google.api.field_behavior) = IMMUTABLE]; + + // Human-readable display name for the Data Stream. + string display_name = 7; +} + +// A resource message representing a Google Analytics web stream. +message WebDataStream { + option (google.api.resource) = { + type: "analyticsmanagement.googleapis.com/WebDataStream" + pattern: "properties/{property}/webDataStreams/{web_data_stream}" + }; + + // Output only. Resource name of this Data Stream. + // Format: properties/{property_id}/webDataStreams/{stream_id} + // Example: "properties/1000/webDataStreams/2000" + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Analytics "Measurement ID", without the "G-" prefix. + // Example: "G-1A2BCD345E" would just be "1A2BCD345E" + string measurement_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. ID of the corresponding web app in Firebase, if any. + // This ID can change if the web app is deleted and recreated. + string firebase_app_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Time when this stream was originally created. + google.protobuf.Timestamp create_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Time when stream payload fields were last updated. + google.protobuf.Timestamp update_time = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. Domain name of the web app being measured, or empty. + // Example: "http://www.google.com", "https://www.google.com" + string default_uri = 6 [(google.api.field_behavior) = IMMUTABLE]; + + // Human-readable display name for the Data Stream. + string display_name = 7; +} + +// A resource message representing a user's permissions on an Account or +// Property resource. +message UserLink { + option (google.api.resource) = { + type: "analyticsmanagement.googleapis.com/UserLink" + pattern: "accounts/{account}/userLinks/{user_link}" + pattern: "properties/{property}/userLinks/{user_link}" + }; + + // Example format: properties/1234/userLinks/5678 + string name = 1; + + // Email address of the user to link + string email_address = 2; + + // Roles directly assigned to this user for this account or property. + // + // Valid values: + // predefinedRoles/read + // predefinedRoles/collaborate + // predefinedRoles/edit + // predefinedRoles/manage-users + // + // Excludes roles that are inherited from a higher-level entity, group, + // or organization admin role. + // + // A UserLink that is updated to have an empty list of direct_roles will be + // deleted. + repeated string direct_roles = 3; +} + +// Read-only resource used to summarize a principal's effective roles. +message AuditUserLink { + // Example format: properties/1234/userLinks/5678 + string name = 1; + + // Email address of the linked user + string email_address = 2; + + // Roles directly assigned to this user for this entity. + // + // Format: predefinedRoles/read + // + // Excludes roles that are inherited from an account (if this is for a + // property), group, or organization admin role. + repeated string direct_roles = 3; + + // Union of all permissions a user has at this account or property (includes + // direct permissions, group-inherited permissions, etc.). + // + // Format: predefinedRoles/read + repeated string effective_roles = 4; +} + +// Singleton resource under a WebDataStream, configuring measurement of +// additional site interactions and content. +message EnhancedMeasurementSettings { + option (google.api.resource) = { + type: "analyticsmanagement.googleapis.com/EnhancedMeasurementSettings" + pattern: "properties/{property}/webDataStreams/{web_data_stream}/enhancedMeasurementSettings" + }; + + // Output only. Resource name of this Data Stream. + // Format: + // properties/{property_id}/webDataStreams/{stream_id}/enhancedMeasurementSettings + // Example: "properties/1000/webDataStreams/2000/enhancedMeasurementSettings" + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Indicates whether Enhanced Measurement Settings will be used to + // automatically measure interactions and content on this web stream. + // + // Changing this value does not affect the settings themselves, but determines + // whether they are respected. + bool stream_enabled = 2; + + // Output only. If enabled, capture a page view event each time a page loads or the + // website changes the browser history state. + bool page_views_enabled = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // If enabled, capture scroll events each time a visitor gets to the bottom of + // a page. + bool scrolls_enabled = 4; + + // If enabled, capture an outbound click event each time a visitor clicks a + // link that leads them away from your domain. + bool outbound_clicks_enabled = 5; + + // Capture events when your visitors view content on your site that has + // structured data (eg, articles, blog posts, product details screens, etc.). + bool content_views_enabled = 6; + + // If enabled, capture a view search results event each time a visitor + // performs a search on your site (based on a query parameter). + bool site_search_enabled = 7; + + // If enabled, capture a view search results event each time a visitor + // interacts with a form on your site. + bool form_interactions_enabled = 8; + + // If enabled, capture video play, progress, and complete events as visitors + // view embedded videos on your site. + bool video_engagement_enabled = 9; + + // If enabled, capture a file download event each time a link is clicked with + // a common document, compressed file, application, video, or audio extension. + bool file_downloads_enabled = 10; + + // If enabled, capture a click event each time a visitor clicks a link or + // element that has data attributes beginning with "data-ga". + bool data_tagged_element_clicks_enabled = 11; + + // If enabled, capture a page view event each time a page loads. + bool page_loads_enabled = 12; + + // If enabled, capture a page view event each time the website changes the + // browser history state. + bool page_changes_enabled = 13; + + // Capture events when your visitors view content on your site that has + // articles or blog posts. + bool articles_and_blogs_enabled = 14; + + // Capture events when your visitors view content on your site that has + // product details screens, etc. + bool products_and_ecommerce_enabled = 15; + + // Required. URL query parameters to interpret as site search parameters. + // Max length is 1024 characters. Must not be empty. + string search_query_parameter = 16 [(google.api.field_behavior) = REQUIRED]; + + // Additional URL query parameters. + // Max length is 1024 characters. + string url_query_parameter = 17; + + // Domains to exclude from measurement. Max length is 1024 characters. + string excluded_domains = 18; +} + +// A link between an App+Web property and a Firebase project. +message FirebaseLink { + option (google.api.resource) = { + type: "analyticsmanagement.googleapis.com/FirebaseLink" + pattern: "properties/{property}/firebaseLinks/{firebase_link}" + }; + + // Output only. Example format: properties/1234/firebaseLinks/5678 + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. Firebase project resource name. When creating a FirebaseLink, you may + // provide this resource name using either a project number or project ID. + // Once this resource has been created, returned FirebaseLinks will always + // have a project_name that contains a project number. + // + // Format: 'projects/{project number}' + // Example: 'projects/1234' + string project = 2 [(google.api.field_behavior) = IMMUTABLE]; + + // Output only. Time when this FirebaseLink was originally created. + google.protobuf.Timestamp create_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Maximum user access to the App + Web property allowed to admins of + // the linked Firebase project. + MaximumUserAccess maximum_user_access = 4; +} + +// Read-only resource with the tag for sending data from a website to a +// WebDataStream. +message GlobalSiteTag { + option (google.api.resource) = { + type: "analyticsmanagement.googleapis.com/GlobalSiteTag" + pattern: "properties/{property}/globalSiteTag" + }; + + // Immutable. JavaScript code snippet to be pasted as the first item into the head tag of + // every webpage to measure. + string snippet = 1 [(google.api.field_behavior) = IMMUTABLE]; +} + +// A link between an App+Web property and a Google Ads account. +message GoogleAdsLink { + option (google.api.resource) = { + type: "analyticsmanagement.googleapis.com/GoogleAdsLink" + pattern: "properties/{property}/googleAdsLinks/{google_ads_link}" + }; + + // Output only. Format: properties/{propertyId}/googleAdsLinks/{googleAdsLinkId} + // + // Note: googleAdsLinkId is not the Google Ads customer ID. + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. Format: properties/{propertyId} + string parent = 2 [(google.api.field_behavior) = IMMUTABLE]; + + // Immutable. Google Ads customer ID. + string customer_id = 3 [(google.api.field_behavior) = IMMUTABLE]; + + // Output only. If true, this link is for a Google Ads manager account. + bool can_manage_clients = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Enable personalized advertising features with this integration. + // Automatically publish my Google Analytics audience lists and Google + // Analytics remarketing events/parameters to the linked Google Ads account. + bool ads_personalization_enabled = 5; +} + +// The category selected for this property, used for industry benchmarking. +enum IndustryCategory { + // Industry category unspecified + INDUSTRY_CATEGORY_UNSPECIFIED = 0; + + // Automotive + AUTOMOTIVE = 1; + + // Business and industrial markets + BUSINESS_AND_INDUSTRIAL_MARKETS = 2; + + // Finance + FINANCE = 3; + + // Healthcare + HEALTHCARE = 4; + + // Technology + TECHNOLOGY = 5; + + // Travel + TRAVEL = 6; + + // Other + OTHER = 7; + + // Arts and entertainment + ARTS_AND_ENTERTAINMENT = 8; + + // Beauty and fitness + BEAUTY_AND_FITNESS = 9; + + // Books and literature + BOOKS_AND_LITERATURE = 10; + + // Food and drink + FOOD_AND_DRINK = 11; + + // Games + GAMES = 12; + + // Hobbies and leisure + HOBBIES_AND_LEISURE = 13; + + // Home and garden + HOME_AND_GARDEN = 14; + + // Internet and telecom + INTERNET_AND_TELECOM = 15; + + // Law and government + LAW_AND_GOVERNMENT = 16; + + // News + NEWS = 17; + + // Online communities + ONLINE_COMMUNITIES = 18; + + // People and society + PEOPLE_AND_SOCIETY = 19; + + // Pets and animals + PETS_AND_ANIMALS = 20; + + // Real estate + REAL_ESTATE = 21; + + // Reference + REFERENCE = 22; + + // Science + SCIENCE = 23; + + // Sports + SPORTS = 24; + + // Jobs and education + JOBS_AND_EDUCATION = 25; + + // Shopping + SHOPPING = 26; +} + +// Maximum access settings that Firebase user receive on the linked Analytics +// property. +enum MaximumUserAccess { + // Unspecified maximum user access. + MAXIMUM_USER_ACCESS_UNSPECIFIED = 0; + + // Firebase users have no access to the Analytics property. + NO_ACCESS = 1; + + // Firebase users have Read & Analyze access to the Analytics property. + READ_AND_ANALYZE = 2; + + // Firebase users have edit access to the Analytics property, but may not + // manage the Firebase link. + EDITOR_WITHOUT_LINK_MANAGEMENT = 3; + + // Firebase users have edit access to the Analytics property and may manage + // the Firebase link. + EDITOR_INCLUDING_LINK_MANAGEMENT = 4; +} diff --git a/third_party/googleapis/google/api/BUILD.bazel b/third_party/googleapis/google/api/BUILD.bazel index f7c43cd32..ec6301030 100644 --- a/third_party/googleapis/google/api/BUILD.bazel +++ b/third_party/googleapis/google/api/BUILD.bazel @@ -1,3 +1,5 @@ +load("@rules_proto//proto:defs.bzl", "proto_library") + # This is an API workspace, having public visibility by default makes perfect sense. package(default_visibility = ["//visibility:public"]) @@ -317,8 +319,6 @@ go_proto_library( importpath = "google.golang.org/genproto/googleapis/api", protos = [ ":launch_stage_proto", - "//google/api/experimental:authorization_config_proto", - "//google/api/experimental:experimental_proto", ], deps = [ ":annotations_go_proto", @@ -524,3 +524,148 @@ cc_proto_library( name = "usage_cc_proto", deps = [":usage_proto"], ) + +############################################################################## +# Python +############################################################################## +load("@com_google_googleapis_imports//:imports.bzl", "py_proto_library") + +py_proto_library( + name = "annotations_py_proto", + deps = [":annotations_proto"], +) + +py_proto_library( + name = "auth_py_proto", + deps = [":auth_proto"], +) + +py_proto_library( + name = "backend_py_proto", + deps = [":backend_proto"], +) + +py_proto_library( + name = "billing_py_proto", + deps = [":billing_proto"], +) + +py_proto_library( + name = "client_py_proto", + deps = [":client_proto"], +) + +py_proto_library( + name = "config_change_py_proto", + deps = [":config_change_proto"], +) + +py_proto_library( + name = "consumer_py_proto", + deps = [":consumer_proto"], +) + +py_proto_library( + name = "context_py_proto", + deps = [":context_proto"], +) + +py_proto_library( + name = "control_py_proto", + deps = [":control_proto"], +) + +py_proto_library( + name = "distribution_py_proto", + deps = [":distribution_proto"], +) + +py_proto_library( + name = "documentation_py_proto", + deps = [":documentation_proto"], +) + +py_proto_library( + name = "endpoint_py_proto", + deps = [":endpoint_proto"], +) + +py_proto_library( + name = "field_behavior_py_proto", + deps = [":field_behavior_proto"], +) + +py_proto_library( + name = "http_py_proto", + deps = [":http_proto"], +) + +py_proto_library( + name = "httpbody_py_proto", + deps = [":httpbody_proto"], +) + +py_proto_library( + name = "label_py_proto", + deps = [":label_proto"], +) + +py_proto_library( + name = "launch_stage_py_proto", + deps = [":launch_stage_proto"], +) + +py_proto_library( + name = "log_py_proto", + deps = [":log_proto"], +) + +py_proto_library( + name = "logging_py_proto", + deps = [":logging_proto"], +) + +py_proto_library( + name = "metric_py_proto", + deps = [":metric_proto"], +) + +py_proto_library( + name = "monitored_resource_py_proto", + deps = [":monitored_resource_proto"], +) + +py_proto_library( + name = "monitoring_py_proto", + deps = ["monitoring_proto"], +) + +py_proto_library( + name = "quota_py_proto", + deps = ["quota_proto"], +) + +py_proto_library( + name = "resource_py_proto", + deps = [":resource_proto"], +) + +py_proto_library( + name = "service_py_proto", + deps = [":service_proto"], +) + +py_proto_library( + name = "source_info_py_proto", + deps = [":source_info_proto"], +) + +py_proto_library( + name = "system_parameter_py_proto", + deps = [":system_parameter_proto"], +) + +py_proto_library( + name = "usage_py_proto", + deps = [":usage_proto"], +) diff --git a/third_party/googleapis/google/api/auth.proto b/third_party/googleapis/google/api/auth.proto index 7c5d61666..1b187cb49 100644 --- a/third_party/googleapis/google/api/auth.proto +++ b/third_party/googleapis/google/api/auth.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -72,6 +71,27 @@ message AuthenticationRule { repeated AuthRequirement requirements = 7; } +// Specifies a location to extract JWT from an API request. +message JwtLocation { + oneof in { + // Specifies HTTP header name to extract JWT token. + string header = 1; + + // Specifies URL query parameter name to extract JWT token. + string query = 2; + } + + // The value prefix. The value format is "value_prefix{token}" + // Only applies to "in" header type. Must be empty for "in" query type. + // If not empty, the header value has to match (case sensitive) this prefix. + // If not matched, JWT will not be extracted. If matched, JWT will be + // extracted after the prefix is removed. + // + // For example, for "Authorization: Bearer {JWT}", + // value_prefix="Bearer " with a space at the end. + string value_prefix = 3; +} + // Configuration for an authentication provider, including support for // [JSON Web Token // (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32). @@ -122,6 +142,25 @@ message AuthProvider { // Redirect URL if JWT token is required but not present or is expired. // Implement authorizationUrl of securityDefinitions in OpenAPI spec. string authorization_url = 5; + + // Defines the locations to extract the JWT. + // + // JWT locations can be either from HTTP headers or URL query parameters. + // The rule is that the first match wins. The checking order is: checking + // all headers first, then URL query parameters. + // + // If not specified, default to use following 3 locations: + // 1) Authorization: Bearer + // 2) x-goog-iap-jwt-assertion + // 3) access_token query parameter + // + // Default locations can be specified as followings: + // jwt_locations: + // - header: Authorization + // value_prefix: "Bearer " + // - header: x-goog-iap-jwt-assertion + // - query: access_token + repeated JwtLocation jwt_locations = 6; } // OAuth scopes are a way to define data and permissions on data. For example, diff --git a/third_party/googleapis/google/api/backend.proto b/third_party/googleapis/google/api/backend.proto index 26a16ef41..2dbaa30a7 100644 --- a/third_party/googleapis/google/api/backend.proto +++ b/third_party/googleapis/google/api/backend.proto @@ -96,10 +96,29 @@ message BackendRule { string selector = 1; // The address of the API backend. + // + // The scheme is used to determine the backend protocol and security. + // The following schemes are accepted: + // + // SCHEME PROTOCOL SECURITY + // http:// HTTP None + // https:// HTTP TLS + // grpc:// gRPC None + // grpcs:// gRPC TLS + // + // It is recommended to explicitly include a scheme. Leaving out the scheme + // may cause constrasting behaviors across platforms. + // + // If the port is unspecified, the default is: + // - 80 for schemes without TLS + // - 443 for schemes with TLS + // + // For HTTP backends, use [protocol][google.api.BackendRule.protocol] + // to specify the protocol version. string address = 2; - // The number of seconds to wait for a response from a request. The default - // deadline for gRPC is infinite (no deadline) and HTTP requests is 5 seconds. + // The number of seconds to wait for a response from a request. The default + // varies based on the request protocol and deployment environment. double deadline = 3; // Minimum deadline in seconds needed for this method. Calls having deadline @@ -120,8 +139,45 @@ message BackendRule { // // For example, specifying `jwt_audience` implies that the backend expects // authentication via a JWT. + // + // When authentication is unspecified, the resulting behavior is the same + // as `disable_auth` set to `true`. + // + // Refer to https://developers.google.com/identity/protocols/OpenIDConnect for + // JWT ID token. oneof authentication { - // The JWT audience is used when generating a JWT id token for the backend. + // The JWT audience is used when generating a JWT ID token for the backend. + // This ID token will be added in the HTTP "authorization" header, and sent + // to the backend. string jwt_audience = 7; + + // When disable_auth is true, a JWT ID token won't be generated and the + // original "Authorization" HTTP header will be preserved. If the header is + // used to carry the original token and is expected by the backend, this + // field must be set to true to preserve the header. + bool disable_auth = 8; } + + // The protocol used for sending a request to the backend. + // The supported values are "http/1.1" and "h2". + // + // The default value is inferred from the scheme in the + // [address][google.api.BackendRule.address] field: + // + // SCHEME PROTOCOL + // http:// http/1.1 + // https:// http/1.1 + // grpc:// h2 + // grpcs:// h2 + // + // For secure HTTP backends (https://) that support HTTP/2, set this field + // to "h2" for improved performance. + // + // Configuring this field to non-default values is only supported for secure + // HTTP backends. This field will be ignored for all other backends. + // + // See + // https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids + // for more details on the supported values. + string protocol = 9; } diff --git a/third_party/googleapis/google/api/expr/artman_cel.yaml b/third_party/googleapis/google/api/expr/artman_cel.yaml deleted file mode 100644 index 89d2d28b2..000000000 --- a/third_party/googleapis/google/api/expr/artman_cel.yaml +++ /dev/null @@ -1,37 +0,0 @@ -# This file is auto-generated based on service config and could be -# incorrect. The API producer can manually edit it. Remove all the FIXMEs -# before sending this file out for review. -common: - api_name: cel - api_version: v1alpha1 - organization_name: google-cloud - proto_deps: - - name: google-common-protos - src_proto_paths: - - v1alpha1 - service_yaml: cel.yaml - gapic_yaml: v1alpha1/cel_gapic.yaml -artifacts: -- name: gapic_config - type: GAPIC_CONFIG -- name: java_gapic - type: GAPIC - language: JAVA -- name: python_gapic - type: GAPIC - language: PYTHON -- name: nodejs_gapic - type: GAPIC - language: NODEJS -- name: php_gapic - type: GAPIC - language: PHP -- name: go_gapic - type: GAPIC - language: GO -- name: ruby_gapic - type: GAPIC - language: RUBY -- name: csharp_gapic - type: GAPIC - language: CSHARP diff --git a/third_party/googleapis/google/api/expr/v1alpha1/BUILD.bazel b/third_party/googleapis/google/api/expr/v1alpha1/BUILD.bazel index 6334c9d3d..c2e842bc3 100644 --- a/third_party/googleapis/google/api/expr/v1alpha1/BUILD.bazel +++ b/third_party/googleapis/google/api/expr/v1alpha1/BUILD.bazel @@ -1,32 +1,37 @@ +# This file was automatically generated by BuildFileGenerator + # This is an API workspace, having public visibility by default makes perfect sense. package(default_visibility = ["//visibility:public"]) ############################################################################## # Common ############################################################################## -load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") +load("@rules_proto//proto:defs.bzl", "proto_library") proto_library( - name = "cel_service_proto", - srcs = ["cel_service.proto"], - deps = [ - ":conformance_service_proto", + name = "expr_proto", + srcs = [ + "checked.proto", + "eval.proto", + "explain.proto", + "syntax.proto", + "value.proto", ], -) - -proto_library( - name = "checked_proto", - srcs = ["checked.proto"], deps = [ - ":syntax_proto", + "//google/rpc:status_proto", + "@com_google_protobuf//:any_proto", + "@com_google_protobuf//:duration_proto", "@com_google_protobuf//:empty_proto", "@com_google_protobuf//:struct_proto", + "@com_google_protobuf//:timestamp_proto", ], ) proto_library( name = "conformance_service_proto", - srcs = ["conformance_service.proto"], + srcs = [ + "conformance_service.proto", + ], deps = [ ":checked_proto", ":eval_proto", @@ -35,6 +40,16 @@ proto_library( ], ) +proto_library( + name = "checked_proto", + srcs = ["checked.proto"], + deps = [ + ":syntax_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:struct_proto", + ], +) + proto_library( name = "eval_proto", srcs = ["eval.proto"], @@ -71,90 +86,29 @@ proto_library( ], ) -proto_library( - name = "cel_proto", - srcs = [ - "cel_service.proto", - "checked.proto", - "conformance_service.proto", - "eval.proto", - "explain.proto", - "syntax.proto", - "value.proto", - ], - deps = [ - "//google/rpc:status_proto", - "@com_google_protobuf//:any_proto", - "@com_google_protobuf//:duration_proto", - "@com_google_protobuf//:empty_proto", - "@com_google_protobuf//:struct_proto", - "@com_google_protobuf//:timestamp_proto", - ], -) - -proto_library_with_info( - name = "cel_proto_with_info", - deps = [":cel_proto"], -) - ############################################################################## # Java ############################################################################## load( "@com_google_googleapis_imports//:imports.bzl", "java_grpc_library", - "java_gapic_library", - "java_gapic_assembly_gradle_pkg", "java_proto_library", - "java_test", ) -_JAVA_GRPC_DEPS = [ - "@com_google_api_grpc_proto_google_common_protos//jar", -] +java_proto_library( + name = "expr_java_proto", + deps = [":expr_proto"], +) java_proto_library( - name = "cel_java_proto", - deps = [":cel_proto"], + name = "conformance_service_java_proto", + deps = [":conformance_service_proto"], ) java_grpc_library( - name = "cel_java_grpc", - srcs = [":cel_proto"], - deps = [":cel_java_proto"] + _JAVA_GRPC_DEPS, -) - -java_gapic_library( - name = "cel_java_gapic", - src = ":cel_proto_with_info", - gapic_yaml = "cel_gapic.yaml", - service_yaml = "//google/api/expr:cel.yaml", - test_deps = [":cel_java_grpc"], - deps = [":cel_java_proto"] + _JAVA_GRPC_DEPS, -) - -[java_test( - name = test_name, - test_class = test_name, - runtime_deps = [":cel_java_gapic_test"], -) for test_name in [ - "com.google.cloud.api.expr.v1alpha1.CelServiceClientTest", - "com.google.cloud.api.expr.v1alpha1.ConformanceServiceClientTest", -]] - -# Opensource Packages -java_gapic_assembly_gradle_pkg( - name = "google-cloud-cel-v1alpha1-java", - client_deps = [":cel_java_gapic"], - client_group = "com.google.cloud", - client_test_deps = [":cel_java_gapic_test"], - grpc_deps = [":cel_java_grpc"], - grpc_group = "com.google.api.grpc", - proto_deps = [ - ":cel_java_proto", - ":cel_proto", - ] + _JAVA_GRPC_DEPS, - version = "0.0.0-SNAPSHOT", + name = "conformance_service_java_grpc", + srcs = [":conformance_service_proto"], + deps = [":conformance_service_java_proto"], ) ############################################################################## @@ -163,68 +117,162 @@ java_gapic_assembly_gradle_pkg( load( "@com_google_googleapis_imports//:imports.bzl", "go_proto_library", - "go_test", - "go_gapic_library", - "go_gapic_assembly_pkg", ) go_proto_library( - name = "cel_go_proto", + name = "expr_go_proto", compilers = ["@io_bazel_rules_go//proto:go_grpc"], importpath = "google.golang.org/genproto/googleapis/api/expr/v1alpha1", - protos = [":cel_proto"], + protos = [":expr_proto"], deps = [ - "//google/api:annotations_go_proto", "//google/rpc:status_go_proto", ], ) -go_gapic_library( - name = "cel_go_gapic", - src = ":cel_proto_with_info", - gapic_yaml = "cel_gapic.yaml", - importpath = "cloud.google.com/go/expr/apiv1alpha1", - service_yaml = "//google/api/expr:cel.yaml", - deps = [":cel_go_proto"], +go_proto_library( + name = "conformance_service_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/api/expr/conformance/v1alpha1", + protos = [":conformance_service_proto"], + deps = [ + ":expr_go_proto", + "//google/rpc:status_go_proto", + ], ) -go_test( - name = "cel_go_gapic_test", - srcs = [":cel_go_gapic_srcjar_test"], - embed = [":cel_go_gapic"], - importpath = "cloud.google.com/go/expr/apiv1alpha1", + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_grpc_library", + "py_proto_library", ) -# Opensource Packages -go_gapic_assembly_pkg( - name = "gapi-cloud-cel-v1alpha1-go", +moved_proto_library( + name = "expr_moved_proto", + srcs = [":expr_proto"], deps = [ - ":cel_go_gapic", - ":cel_go_gapic_srcjar-smoke-test.srcjar", - ":cel_go_gapic_srcjar-test.srcjar", - ":cel_go_proto", + "//google/rpc:status_proto", + "@com_google_protobuf//:any_proto", + "@com_google_protobuf//:duration_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:struct_proto", + "@com_google_protobuf//:timestamp_proto", ], ) +moved_proto_library( + name = "conformance_service_moved_proto", + srcs = [":conformance_service_proto"], + deps = [ + ":expr_moved_proto", + "//google/rpc:status_proto", + ], +) + +py_proto_library( + name = "expr_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":expr_moved_proto"], +) + +py_proto_library( + name = "conformance_service_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":conformance_service_moved_proto"], +) + +py_grpc_library( + name = "conformance_service_py_grpc", + srcs = [":conformance_service_moved_proto"], + deps = [":conformance_service_py_proto"], +) + ############################################################################## -# C++ +# PHP ############################################################################## load( "@com_google_googleapis_imports//:imports.bzl", - "cc_grpc_library", - "cc_proto_library", + "php_grpc_library", + "php_proto_library", ) -cc_proto_library( - name = "cel_service_cc_proto", - deps = [":cel_service_proto"], +php_proto_library( + name = "expr_php_proto", + deps = [":expr_proto"], ) -cc_grpc_library( - name = "cel_service_cc_grpc", - srcs = [":cel_service_proto"], - deps = [":cel_service_cc_proto"], - grpc_only = True, +php_proto_library( + name = "conformance_service_php_proto", + deps = [":conformance_service_proto"], +) + +php_grpc_library( + name = "conformance_service_php_grpc", + srcs = [":conformance_service_proto"], + deps = [":conformance_service_php_proto"], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "expr_ruby_proto", + deps = [":expr_proto"], +) + +ruby_proto_library( + name = "conformance_service_ruby_proto", + deps = [":conformance_service_proto"], +) + +ruby_grpc_library( + name = "conformance_service_ruby_grpc", + srcs = [":conformance_service_proto"], + deps = [":conformance_service_ruby_proto"], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "expr_csharp_proto", + deps = [":expr_proto"], +) + +csharp_proto_library( + name = "conformance_service_csharp_proto", + deps = [":conformance_service_proto"], +) + +csharp_grpc_library( + name = "conformance_service_csharp_grpc", + srcs = [":conformance_service_proto"], + deps = [":conformance_service_csharp_proto"], +) + +############################################################################## +# C++ +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "cc_grpc_library", + "cc_proto_library", ) cc_proto_library( @@ -240,8 +288,9 @@ cc_proto_library( cc_grpc_library( name = "conformance_service_cc_grpc", srcs = [":conformance_service_proto"], - deps = [":conformance_service_cc_proto"], + generate_mocks = True, grpc_only = True, + deps = [":conformance_service_cc_proto"], ) cc_proto_library( diff --git a/third_party/googleapis/google/api/expr/v1alpha1/cel_service.proto b/third_party/googleapis/google/api/expr/v1alpha1/cel_service.proto deleted file mode 100644 index 0bf649ff5..000000000 --- a/third_party/googleapis/google/api/expr/v1alpha1/cel_service.proto +++ /dev/null @@ -1,44 +0,0 @@ -// Copyright 2018 Google LLC. -// -// Licensed under the Apache License, Version 2.0 (the "License"); -// you may not use this file except in compliance with the License. -// You may obtain a copy of the License at -// -// http://www.apache.org/licenses/LICENSE-2.0 -// -// Unless required by applicable law or agreed to in writing, software -// distributed under the License is distributed on an "AS IS" BASIS, -// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -// See the License for the specific language governing permissions and -// limitations under the License. -// - -syntax = "proto3"; - -package google.api.expr.v1alpha1; - -import "google/api/expr/v1alpha1/conformance_service.proto"; - -option cc_enable_arenas = true; -option go_package = "google.golang.org/genproto/googleapis/api/expr/v1alpha1;expr"; -option java_multiple_files = true; -option java_outer_classname = "CelServiceProto"; -option java_package = "com.google.api.expr.v1alpha1"; - -// Access a CEL implementation from another process or machine. -// A CEL implementation is decomposed as a parser, a static checker, -// and an evaluator. Every CEL implementation is expected to provide -// a server for this API. The API will be used for conformance testing, -// utilities, and execution as a service. -service CelService { - // Transforms CEL source text into a parsed representation. - rpc Parse(ParseRequest) returns (ParseResponse) {} - - // Runs static checks on a parsed CEL representation and return - // an annotated representation, or a set of issues. - rpc Check(CheckRequest) returns (CheckResponse) {} - - // Evaluates a parsed or annotation CEL representation given - // values of external bindings. - rpc Eval(EvalRequest) returns (EvalResponse) {} -} diff --git a/third_party/googleapis/google/api/expr/v1alpha1/checked.proto b/third_party/googleapis/google/api/expr/v1alpha1/checked.proto index 60dd09e20..e6333b073 100644 --- a/third_party/googleapis/google/api/expr/v1alpha1/checked.proto +++ b/third_party/googleapis/google/api/expr/v1alpha1/checked.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -236,8 +235,8 @@ message Decl { // logging which are not observable from CEL). message FunctionDecl { // An overload indicates a function's parameter types and return type, and - // may optionally include a function body described in terms of - // [Expr][google.api.expr.v1alpha1.Expr] values. + // may optionally include a function body described in terms of [Expr][google.api.expr.v1alpha1.Expr] + // values. // // Functions overloads are declared in either a function or method // call-style. For methods, the `params[0]` is the expected type of the @@ -249,13 +248,11 @@ message Decl { // Required. Globally unique overload name of the function which reflects // the function name and argument types. // - // This will be used by a [Reference][google.api.expr.v1alpha1.Reference] - // to indicate the `overload_id` that was resolved for the function - // `name`. + // This will be used by a [Reference][google.api.expr.v1alpha1.Reference] to indicate the `overload_id` that + // was resolved for the function `name`. string overload_id = 1; - // List of function parameter [Type][google.api.expr.v1alpha1.Type] - // values. + // List of function parameter [Type][google.api.expr.v1alpha1.Type] values. // // Param types are disjoint after generic type parameters have been // replaced with the type `DYN`. Since the `DYN` type is compatible with @@ -297,11 +294,9 @@ message Decl { // Declarations are organized in containers and this represents the full path // to the declaration in its container, as in `google.api.expr.Decl`. // - // Declarations used as - // [FunctionDecl.Overload][google.api.expr.v1alpha1.Decl.FunctionDecl.Overload] - // parameters may or may not have a name depending on whether the overload is - // function declaration or a function definition containing a result - // [Expr][google.api.expr.v1alpha1.Expr]. + // Declarations used as [FunctionDecl.Overload][google.api.expr.v1alpha1.Decl.FunctionDecl.Overload] parameters may or may not + // have a name depending on whether the overload is function declaration or a + // function definition containing a result [Expr][google.api.expr.v1alpha1.Expr]. string name = 1; // Required. The declaration kind. @@ -326,8 +321,7 @@ message Reference { // presented candidates must happen at runtime because of dynamic types. The // type checker attempts to narrow down this list as much as possible. // - // Empty if this is not a reference to a - // [Decl.FunctionDecl][google.api.expr.v1alpha1.Decl.FunctionDecl]. + // Empty if this is not a reference to a [Decl.FunctionDecl][google.api.expr.v1alpha1.Decl.FunctionDecl]. repeated string overload_id = 3; // For references to constants, this may contain the value of the diff --git a/third_party/googleapis/google/api/expr/v1alpha1/conformance_service.proto b/third_party/googleapis/google/api/expr/v1alpha1/conformance_service.proto index 7a9321a0e..8dfa9d74d 100644 --- a/third_party/googleapis/google/api/expr/v1alpha1/conformance_service.proto +++ b/third_party/googleapis/google/api/expr/v1alpha1/conformance_service.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -23,7 +22,7 @@ import "google/api/expr/v1alpha1/syntax.proto"; import "google/rpc/status.proto"; option cc_enable_arenas = true; -option go_package = "google.golang.org/genproto/googleapis/api/expr/v1alpha1;expr"; +option go_package = "google.golang.org/genproto/googleapis/api/expr/conformance/v1alpha1;confpb"; option java_multiple_files = true; option java_outer_classname = "ConformanceServiceProto"; option java_package = "com.google.api.expr.v1alpha1"; @@ -34,16 +33,20 @@ option java_package = "com.google.api.expr.v1alpha1"; // a server for this API. The API will be used for conformance testing // and other utilities. service ConformanceService { + // Transforms CEL source text into a parsed representation. - rpc Parse(ParseRequest) returns (ParseResponse) {} + rpc Parse(ParseRequest) returns (ParseResponse) { + } // Runs static checks on a parsed CEL representation and return // an annotated representation, or a set of issues. - rpc Check(CheckRequest) returns (CheckResponse) {} + rpc Check(CheckRequest) returns (CheckResponse) { + } // Evaluates a parsed or annotation CEL representation given // values of external bindings. - rpc Eval(EvalRequest) returns (EvalResponse) {} + rpc Eval(EvalRequest) returns (EvalResponse) { + } } // Request message for the Parse method. @@ -54,8 +57,7 @@ message ParseRequest { // Tag for version of CEL syntax, for future use. string syntax_version = 2; - // File or resource for source text, used in - // [SourceInfo][google.api.expr.v1alpha1.SourceInfo]. + // File or resource for source text, used in [SourceInfo][google.api.expr.v1alpha1.SourceInfo]. string source_location = 3; // Prevent macro expansion. See "Macros" in Language Defiinition. @@ -85,10 +87,9 @@ message CheckRequest { // Language Definition. string container = 3; - // If true, use only the declarations in - // [type_env][google.api.expr.v1alpha1.CheckRequest.type_env]. If false - // (default), add declarations for the standard definitions to the type - // environment. See "Standard Definitions" in the Language Definition. + // If true, use only the declarations in [type_env][google.api.expr.v1alpha1.CheckRequest.type_env]. If false (default), + // add declarations for the standard definitions to the type environment. See + // "Standard Definitions" in the Language Definition. bool no_std_env = 4; } @@ -113,12 +114,10 @@ message EvalRequest { } // Bindings for the external variables. The types SHOULD be compatible - // with the type environment in - // [CheckRequest][google.api.expr.v1alpha1.CheckRequest], if checked. + // with the type environment in [CheckRequest][google.api.expr.v1alpha1.CheckRequest], if checked. map bindings = 3; - // SHOULD be the same container as used in - // [CheckRequest][google.api.expr.v1alpha1.CheckRequest], if checked. + // SHOULD be the same container as used in [CheckRequest][google.api.expr.v1alpha1.CheckRequest], if checked. string container = 4; } @@ -128,9 +127,9 @@ message EvalResponse { ExprValue result = 1; // Any number of issues with [StatusDetails][] as the details. - // Note that CEL execution errors are reified into - // [ExprValue][google.api.expr.v1alpha1.ExprValue]. Nevertheless, we'll allow - // out-of-band issues to be raised, which also makes the replies more regular. + // Note that CEL execution errors are reified into [ExprValue][google.api.expr.v1alpha1.ExprValue]. + // Nevertheless, we'll allow out-of-band issues to be raised, + // which also makes the replies more regular. repeated google.rpc.Status issues = 2; } diff --git a/third_party/googleapis/google/api/expr/v1alpha1/eval.proto b/third_party/googleapis/google/api/expr/v1alpha1/eval.proto index f516ba6bc..c09506830 100644 --- a/third_party/googleapis/google/api/expr/v1alpha1/eval.proto +++ b/third_party/googleapis/google/api/expr/v1alpha1/eval.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/api/expr/v1alpha1/explain.proto b/third_party/googleapis/google/api/expr/v1alpha1/explain.proto index 089e144a1..5e1bc941d 100644 --- a/third_party/googleapis/google/api/expr/v1alpha1/explain.proto +++ b/third_party/googleapis/google/api/expr/v1alpha1/explain.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/api/expr/v1alpha1/syntax.proto b/third_party/googleapis/google/api/expr/v1alpha1/syntax.proto index 4a3cb907a..3f7652f16 100644 --- a/third_party/googleapis/google/api/expr/v1alpha1/syntax.proto +++ b/third_party/googleapis/google/api/expr/v1alpha1/syntax.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -45,24 +44,21 @@ message ParsedExpr { // operators with the exception of the '.' operator are modelled as function // calls. This makes it easy to represent new operators into the existing AST. // -// All references within expressions must resolve to a -// [Decl][google.api.expr.v1alpha1.Decl] provided at type-check for an -// expression to be valid. A reference may either be a bare identifier `name` or -// a qualified identifier `google.api.name`. References may either refer to a -// value or a function declaration. +// All references within expressions must resolve to a [Decl][google.api.expr.v1alpha1.Decl] provided at +// type-check for an expression to be valid. A reference may either be a bare +// identifier `name` or a qualified identifier `google.api.name`. References +// may either refer to a value or a function declaration. // // For example, the expression `google.api.name.startsWith('expr')` references -// the declaration `google.api.name` within a -// [Expr.Select][google.api.expr.v1alpha1.Expr.Select] expression, and the -// function declaration `startsWith`. +// the declaration `google.api.name` within a [Expr.Select][google.api.expr.v1alpha1.Expr.Select] expression, and +// the function declaration `startsWith`. message Expr { // An identifier expression. e.g. `request`. message Ident { // Required. Holds a single, unqualified identifier, possibly preceded by a // '.'. // - // Qualified names are represented by the - // [Expr.Select][google.api.expr.v1alpha1.Expr.Select] expression. + // Qualified names are represented by the [Expr.Select][google.api.expr.v1alpha1.Expr.Select] expression. string name = 1; } @@ -239,8 +235,7 @@ message Expr { // primitives. // // Lists and structs are not included as constants as these aggregate types may -// contain [Expr][google.api.expr.v1alpha1.Expr] elements which require -// evaluation and are thus not constant. +// contain [Expr][google.api.expr.v1alpha1.Expr] elements which require evaluation and are thus not constant. // // Examples of literals include: `"hello"`, `b'bytes'`, `1u`, `4.2`, `-2`, // `true`, `null`. @@ -302,6 +297,16 @@ message SourceInfo { // A map from the parse node id (e.g. `Expr.id`) to the character offset // within source. map positions = 4; + + // A map from the parse node id where a macro replacement was made to the + // call `Expr` that resulted in a macro expansion. + // + // For example, `has(value.field)` is a function call that is replaced by a + // `test_only` field selection in the AST. Likewise, the call + // `list.exists(e, e > 10)` translates to a comprehension expression. The key + // in the map corresponds to the expression id of the expanded macro, and the + // value is the call `Expr` that was replaced. + map macro_calls = 5; } // A specific position in source. diff --git a/third_party/googleapis/google/api/expr/v1alpha1/value.proto b/third_party/googleapis/google/api/expr/v1alpha1/value.proto index a0508ed91..3f2d250fa 100644 --- a/third_party/googleapis/google/api/expr/v1alpha1/value.proto +++ b/third_party/googleapis/google/api/expr/v1alpha1/value.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/api/expr/v1beta1/BUILD.bazel b/third_party/googleapis/google/api/expr/v1beta1/BUILD.bazel index bcf7e6f03..819e1364a 100644 --- a/third_party/googleapis/google/api/expr/v1beta1/BUILD.bazel +++ b/third_party/googleapis/google/api/expr/v1beta1/BUILD.bazel @@ -1,3 +1,5 @@ +load("@rules_proto//proto:defs.bzl", "proto_library") + # This is an API workspace, having public visibility by default makes perfect sense. package(default_visibility = ["//visibility:public"]) diff --git a/third_party/googleapis/google/api/expr/v1beta1/decl.proto b/third_party/googleapis/google/api/expr/v1beta1/decl.proto index 6d079b822..d3d748b4e 100644 --- a/third_party/googleapis/google/api/expr/v1beta1/decl.proto +++ b/third_party/googleapis/google/api/expr/v1beta1/decl.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google LLC. +// Copyright 2019 Google LLC. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. diff --git a/third_party/googleapis/google/api/expr/v1beta1/eval.proto b/third_party/googleapis/google/api/expr/v1beta1/eval.proto index cdbe6ac3f..0c6c4d98e 100644 --- a/third_party/googleapis/google/api/expr/v1beta1/eval.proto +++ b/third_party/googleapis/google/api/expr/v1beta1/eval.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google LLC. +// Copyright 2019 Google LLC. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. diff --git a/third_party/googleapis/google/api/expr/v1beta1/expr.proto b/third_party/googleapis/google/api/expr/v1beta1/expr.proto index 93b917f14..77249bafc 100644 --- a/third_party/googleapis/google/api/expr/v1beta1/expr.proto +++ b/third_party/googleapis/google/api/expr/v1beta1/expr.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google LLC. +// Copyright 2019 Google LLC. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -45,24 +45,21 @@ message ParsedExpr { // operators with the exception of the '.' operator are modelled as function // calls. This makes it easy to represent new operators into the existing AST. // -// All references within expressions must resolve to a -// [Decl][google.api.expr.v1beta1.Decl] provided at type-check for an expression -// to be valid. A reference may either be a bare identifier `name` or a -// qualified identifier `google.api.name`. References may either refer to a -// value or a function declaration. +// All references within expressions must resolve to a [Decl][google.api.expr.v1beta1.Decl] provided at +// type-check for an expression to be valid. A reference may either be a bare +// identifier `name` or a qualified identifier `google.api.name`. References +// may either refer to a value or a function declaration. // // For example, the expression `google.api.name.startsWith('expr')` references -// the declaration `google.api.name` within a -// [Expr.Select][google.api.expr.v1beta1.Expr.Select] expression, and the -// function declaration `startsWith`. +// the declaration `google.api.name` within a [Expr.Select][google.api.expr.v1beta1.Expr.Select] expression, and +// the function declaration `startsWith`. message Expr { // An identifier expression. e.g. `request`. message Ident { // Required. Holds a single, unqualified identifier, possibly preceded by a // '.'. // - // Qualified names are represented by the - // [Expr.Select][google.api.expr.v1beta1.Expr.Select] expression. + // Qualified names are represented by the [Expr.Select][google.api.expr.v1beta1.Expr.Select] expression. string name = 1; } @@ -237,8 +234,7 @@ message Expr { // primitives. // // Lists and structs are not included as constants as these aggregate types may -// contain [Expr][google.api.expr.v1beta1.Expr] elements which require -// evaluation and are thus not constant. +// contain [Expr][google.api.expr.v1beta1.Expr] elements which require evaluation and are thus not constant. // // Examples of literals include: `"hello"`, `b'bytes'`, `1u`, `4.2`, `-2`, // `true`, `null`. diff --git a/third_party/googleapis/google/api/expr/v1beta1/source.proto b/third_party/googleapis/google/api/expr/v1beta1/source.proto index adaf84d5e..78bb0a064 100644 --- a/third_party/googleapis/google/api/expr/v1beta1/source.proto +++ b/third_party/googleapis/google/api/expr/v1beta1/source.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google LLC. +// Copyright 2019 Google LLC. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. diff --git a/third_party/googleapis/google/api/expr/v1beta1/value.proto b/third_party/googleapis/google/api/expr/v1beta1/value.proto index a5ae06766..0978228dc 100644 --- a/third_party/googleapis/google/api/expr/v1beta1/value.proto +++ b/third_party/googleapis/google/api/expr/v1beta1/value.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google LLC. +// Copyright 2019 Google LLC. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. diff --git a/third_party/googleapis/google/api/metric.proto b/third_party/googleapis/google/api/metric.proto index cd2762a94..a200d48be 100644 --- a/third_party/googleapis/google/api/metric.proto +++ b/third_party/googleapis/google/api/metric.proto @@ -123,9 +123,27 @@ message MetricDescriptor { // Some combinations of `metric_kind` and `value_type` might not be supported. ValueType value_type = 4; - // The unit in which the metric value is reported. It is only applicable - // if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The - // supported units are a subset of [The Unified Code for Units of + // The units in which the metric value is reported. It is only applicable + // if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit` + // defines the representation of the stored metric values. + // + // Different systems may scale the values to be more easily displayed (so a + // value of `0.02KBy` _might_ be displayed as `20By`, and a value of + // `3523KBy` _might_ be displayed as `3.5MBy`). However, if the `unit` is + // `KBy`, then the value of the metric is always in thousands of bytes, no + // matter how it may be displayed.. + // + // If you want a custom metric to record the exact number of CPU-seconds used + // by a job, you can create an `INT64 CUMULATIVE` metric whose `unit` is + // `s{CPU}` (or equivalently `1s{CPU}` or just `s`). If the job uses 12,005 + // CPU-seconds, then the value is written as `12005`. + // + // Alternatively, if you want a custome metric to record data in a more + // granular way, you can create a `DOUBLE CUMULATIVE` metric whose `unit` is + // `ks{CPU}`, and then write the value `12.005` (which is `12005/1000`), + // or use `Kis{CPU}` and write `11.723` (which is `12005/1024`). + // + // The supported units are a subset of [The Unified Code for Units of // Measure](http://unitsofmeasure.org/ucum.html) standard: // // **Basic units (UNIT)** @@ -139,33 +157,40 @@ message MetricDescriptor { // // **Prefixes (PREFIX)** // - // * `k` kilo (10**3) - // * `M` mega (10**6) - // * `G` giga (10**9) - // * `T` tera (10**12) - // * `P` peta (10**15) - // * `E` exa (10**18) - // * `Z` zetta (10**21) - // * `Y` yotta (10**24) - // * `m` milli (10**-3) - // * `u` micro (10**-6) - // * `n` nano (10**-9) - // * `p` pico (10**-12) - // * `f` femto (10**-15) - // * `a` atto (10**-18) - // * `z` zepto (10**-21) - // * `y` yocto (10**-24) - // * `Ki` kibi (2**10) - // * `Mi` mebi (2**20) - // * `Gi` gibi (2**30) - // * `Ti` tebi (2**40) + // * `k` kilo (10^3) + // * `M` mega (10^6) + // * `G` giga (10^9) + // * `T` tera (10^12) + // * `P` peta (10^15) + // * `E` exa (10^18) + // * `Z` zetta (10^21) + // * `Y` yotta (10^24) + // + // * `m` milli (10^-3) + // * `u` micro (10^-6) + // * `n` nano (10^-9) + // * `p` pico (10^-12) + // * `f` femto (10^-15) + // * `a` atto (10^-18) + // * `z` zepto (10^-21) + // * `y` yocto (10^-24) + // + // * `Ki` kibi (2^10) + // * `Mi` mebi (2^20) + // * `Gi` gibi (2^30) + // * `Ti` tebi (2^40) + // * `Pi` pebi (2^50) // // **Grammar** // // The grammar also includes these connectors: // - // * `/` division (as an infix operator, e.g. `1/s`). - // * `.` multiplication (as an infix operator, e.g. `GBy.d`) + // * `/` division or ratio (as an infix operator). For examples, + // `kBy/{email}` or `MiBy/10ms` (although you should almost never + // have `/s` in a metric `unit`; rates should always be computed at + // query time from the underlying cumulative or delta value). + // * `.` multiplication or composition (as an infix operator). For + // examples, `GBy.d` or `k{watt}.h`. // // The grammar for a unit is as follows: // @@ -180,14 +205,26 @@ message MetricDescriptor { // // Notes: // - // * `Annotation` is just a comment if it follows a `UNIT` and is - // equivalent to `1` if it is used alone. For examples, - // `{requests}/s == 1/s`, `By{transmitted}/s == By/s`. + // * `Annotation` is just a comment if it follows a `UNIT`. If the annotation + // is used alone, then the unit is equivalent to `1`. For examples, + // `{request}/s == 1/s`, `By{transmitted}/s == By/s`. // * `NAME` is a sequence of non-blank printable ASCII characters not - // containing '{' or '}'. - // * `1` represents dimensionless value 1, such as in `1/s`. - // * `%` represents dimensionless value 1/100, and annotates values giving - // a percentage. + // containing `{` or `}`. + // * `1` represents a unitary [dimensionless + // unit](https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, such + // as in `1/s`. It is typically used when none of the basic units are + // appropriate. For example, "new users per day" can be represented as + // `1/d` or `{new-users}/d` (and a metric value `5` would mean "5 new + // users). Alternatively, "thousands of page views per day" would be + // represented as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric + // value of `5.3` would mean "5300 page views per day"). + // * `%` represents dimensionless value of 1/100, and annotates values giving + // a percentage (so the metric values are typically in the range of 0..100, + // and a metric value `3` means "3 percent"). + // * `10^2.%` indicates a metric contains a ratio, typically in the range + // 0..1, that will be multiplied by 100 and displayed as a percentage + // (so a metric value `0.03` means "3 percent"). + // string unit = 5; // A detailed description of the metric, which can be used in documentation. diff --git a/third_party/googleapis/google/api/resource.proto b/third_party/googleapis/google/api/resource.proto index ad6230f1e..2a52e61aa 100644 --- a/third_party/googleapis/google/api/resource.proto +++ b/third_party/googleapis/google/api/resource.proto @@ -27,29 +27,20 @@ option java_package = "com.google.api"; option objc_class_prefix = "GAPI"; extend google.protobuf.FieldOptions { - // An annotation that describes a resource reference. - // - // Example: - // - // message Subscription { - // string topic = 2 [(google.api.resource_reference) = { - // type: "pubsub.googleapis.com/Topic" - // }]; - // } + // An annotation that describes a resource reference, see + // [ResourceReference][]. google.api.ResourceReference resource_reference = 1055; } +extend google.protobuf.FileOptions { + // An annotation that describes a resource definition without a corresponding + // message; see [ResourceDescriptor][]. + repeated google.api.ResourceDescriptor resource_definition = 1053; +} + extend google.protobuf.MessageOptions { - // An annotation that describes a resource definition. - // - // Example: - // - // message Topic { - // option (google.api.resource) = { - // type: "pubsub.googleapis.com/Topic" - // pattern: "projects/{project}/topics/{topic}" - // }; - // } + // An annotation that describes a resource definition, see + // [ResourceDescriptor][]. google.api.ResourceDescriptor resource = 1053; } @@ -61,30 +52,106 @@ extend google.protobuf.MessageOptions { // // Example: // -// message Topic { -// // Indicates this message defines a resource schema. -// // Declares the resource type in the format of {service}/{kind}. -// // For Kubernetes resources, the format is {api group}/{kind}. -// option (google.api.resource) = { -// type: "pubsub.googleapis.com/Topic" -// pattern: "projects/{project}/topics/{topic}" -// }; -// } +// message Topic { +// // Indicates this message defines a resource schema. +// // Declares the resource type in the format of {service}/{kind}. +// // For Kubernetes resources, the format is {api group}/{kind}. +// option (google.api.resource) = { +// type: "pubsub.googleapis.com/Topic" +// name_descriptor: { +// pattern: "projects/{project}/topics/{topic}" +// parent_type: "cloudresourcemanager.googleapis.com/Project" +// parent_name_extractor: "projects/{project}" +// } +// }; +// } +// +// The ResourceDescriptor Yaml config will look like: +// +// resources: +// - type: "pubsub.googleapis.com/Topic" +// name_descriptor: +// - pattern: "projects/{project}/topics/{topic}" +// parent_type: "cloudresourcemanager.googleapis.com/Project" +// parent_name_extractor: "projects/{project}" // // Sometimes, resources have multiple patterns, typically because they can // live under multiple parents. // // Example: // -// message LogEntry { -// option (google.api.resource) = { -// type: "logging.googleapis.com/LogEntry" -// pattern: "projects/{project}/logs/{log}" -// pattern: "organizations/{organization}/logs/{log}" -// pattern: "folders/{folder}/logs/{log}" -// pattern: "billingAccounts/{billing_account}/logs/{log}" -// }; -// } +// message LogEntry { +// option (google.api.resource) = { +// type: "logging.googleapis.com/LogEntry" +// name_descriptor: { +// pattern: "projects/{project}/logs/{log}" +// parent_type: "cloudresourcemanager.googleapis.com/Project" +// parent_name_extractor: "projects/{project}" +// } +// name_descriptor: { +// pattern: "folders/{folder}/logs/{log}" +// parent_type: "cloudresourcemanager.googleapis.com/Folder" +// parent_name_extractor: "folders/{folder}" +// } +// name_descriptor: { +// pattern: "organizations/{organization}/logs/{log}" +// parent_type: "cloudresourcemanager.googleapis.com/Organization" +// parent_name_extractor: "organizations/{organization}" +// } +// name_descriptor: { +// pattern: "billingAccounts/{billing_account}/logs/{log}" +// parent_type: "billing.googleapis.com/BillingAccount" +// parent_name_extractor: "billingAccounts/{billing_account}" +// } +// }; +// } +// +// The ResourceDescriptor Yaml config will look like: +// +// resources: +// - type: 'logging.googleapis.com/LogEntry' +// name_descriptor: +// - pattern: "projects/{project}/logs/{log}" +// parent_type: "cloudresourcemanager.googleapis.com/Project" +// parent_name_extractor: "projects/{project}" +// - pattern: "folders/{folder}/logs/{log}" +// parent_type: "cloudresourcemanager.googleapis.com/Folder" +// parent_name_extractor: "folders/{folder}" +// - pattern: "organizations/{organization}/logs/{log}" +// parent_type: "cloudresourcemanager.googleapis.com/Organization" +// parent_name_extractor: "organizations/{organization}" +// - pattern: "billingAccounts/{billing_account}/logs/{log}" +// parent_type: "billing.googleapis.com/BillingAccount" +// parent_name_extractor: "billingAccounts/{billing_account}" +// +// For flexible resources, the resource name doesn't contain parent names, but +// the resource itself has parents for policy evaluation. +// +// Example: +// +// message Shelf { +// option (google.api.resource) = { +// type: "library.googleapis.com/Shelf" +// name_descriptor: { +// pattern: "shelves/{shelf}" +// parent_type: "cloudresourcemanager.googleapis.com/Project" +// } +// name_descriptor: { +// pattern: "shelves/{shelf}" +// parent_type: "cloudresourcemanager.googleapis.com/Folder" +// } +// }; +// } +// +// The ResourceDescriptor Yaml config will look like: +// +// resources: +// - type: 'library.googleapis.com/Shelf' +// name_descriptor: +// - pattern: "shelves/{shelf}" +// parent_type: "cloudresourcemanager.googleapis.com/Project" +// - pattern: "shelves/{shelf}" +// parent_type: "cloudresourcemanager.googleapis.com/Folder" message ResourceDescriptor { // A description of the historical or future-looking state of the // resource pattern. @@ -114,11 +181,20 @@ message ResourceDescriptor { // characters allowed for the `resource_type_kind` is 100. string type = 1; - // Optional. The valid resource name pattern(s) for this resource type. + // Optional. The relative resource name pattern associated with this resource + // type. The DNS prefix of the full resource name shouldn't be specified here. + // + // The path pattern must follow the syntax, which aligns with HTTP binding + // syntax: + // + // Template = Segment { "/" Segment } ; + // Segment = LITERAL | Variable ; + // Variable = "{" LITERAL "}" ; // // Examples: - // - "projects/{project}/topics/{topic}" - // - "projects/{project}/knowledgeBases/{knowledge_base}" + // + // - "projects/{project}/topics/{topic}" + // - "projects/{project}/knowledgeBases/{knowledge_base}" // // The components in braces correspond to the IDs for each resource in the // hierarchy. It is expected that, if multiple patterns are provided, @@ -133,43 +209,56 @@ message ResourceDescriptor { // Optional. The historical or future-looking state of the resource pattern. // // Example: - // // The InspectTemplate message originally only supported resource - // // names with organization, and project was added later. - // message InspectTemplate { - // option (google.api.resource) = { - // type: "dlp.googleapis.com/InspectTemplate" - // pattern: - // "organizations/{organization}/inspectTemplates/{inspect_template}" - // pattern: "projects/{project}/inspectTemplates/{inspect_template}" - // history: ORIGINALLY_SINGLE_PATTERN - // }; - // } + // + // // The InspectTemplate message originally only supported resource + // // names with organization, and project was added later. + // message InspectTemplate { + // option (google.api.resource) = { + // type: "dlp.googleapis.com/InspectTemplate" + // pattern: + // "organizations/{organization}/inspectTemplates/{inspect_template}" + // pattern: "projects/{project}/inspectTemplates/{inspect_template}" + // history: ORIGINALLY_SINGLE_PATTERN + // }; + // } History history = 4; + + // The plural name used in the resource name, such as 'projects' for + // the name of 'projects/{project}'. It is the same concept of the `plural` + // field in k8s CRD spec + // https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/ + string plural = 5; + + // The same concept of the `singular` field in k8s CRD spec + // https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/ + // Such as "project" for the `resourcemanager.googleapis.com/Project` type. + string singular = 6; } -// Defines a proto annotation that describes a field that refers to a resource. +// Defines a proto annotation that describes a string field that refers to +// an API resource. message ResourceReference { // The resource type that the annotated field references. // // Example: // - // message Subscription { - // string topic = 2 [(google.api.resource_reference) = { - // type = "pubsub.googleapis.com/Topic" - // }]; - // } + // message Subscription { + // string topic = 2 [(google.api.resource_reference) = { + // type: "pubsub.googleapis.com/Topic" + // }]; + // } string type = 1; // The resource type of a child collection that the annotated field - // references. This is useful for `parent` fields where a resource has more - // than one possible type of parent. + // references. This is useful for annotating the `parent` field that + // doesn't have a fixed resource type. // // Example: // - // message ListLogEntriesRequest { - // string parent = 1 [(google.api.resource_reference) = { - // child_type: "logging.googleapis.com/LogEntry" - // }; - // } + // message ListLogEntriesRequest { + // string parent = 1 [(google.api.resource_reference) = { + // child_type: "logging.googleapis.com/LogEntry" + // }; + // } string child_type = 2; } diff --git a/third_party/googleapis/google/api/servicecontrol/v1/BUILD.bazel b/third_party/googleapis/google/api/servicecontrol/v1/BUILD.bazel new file mode 100644 index 000000000..a9d2dd312 --- /dev/null +++ b/third_party/googleapis/google/api/servicecontrol/v1/BUILD.bazel @@ -0,0 +1,43 @@ +# This file was automatically generated by BuildFileGenerator + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") + +proto_library( + name = "servicecontrol_proto", + srcs = [ + "check_error.proto", + "distribution.proto", + "log_entry.proto", + "metric_value.proto", + "operation.proto", + "quota_controller.proto", + "service_controller.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/logging/type:type_proto", + "//google/rpc:status_proto", + "//google/type:money_proto", + "@com_google_protobuf//:any_proto", + "@com_google_protobuf//:struct_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +load("@com_google_googleapis_imports//:imports.bzl", "cc_proto_library") + +cc_proto_library( + name = "servicecontrol_cc_proto", + deps = [ + ":servicecontrol_proto", + ], +) diff --git a/third_party/googleapis/google/api/servicecontrol/v1/check_error.proto b/third_party/googleapis/google/api/servicecontrol/v1/check_error.proto index 3395839d8..de3969d2f 100644 --- a/third_party/googleapis/google/api/servicecontrol/v1/check_error.proto +++ b/third_party/googleapis/google/api/servicecontrol/v1/check_error.proto @@ -32,8 +32,8 @@ message CheckError { // This is never used in `CheckResponse`. ERROR_CODE_UNSPECIFIED = 0; - // The consumer's project id was not found. - // Same as [google.rpc.Code.NOT_FOUND][]. + // The consumer's project id, network container, or resource container was + // not found. Same as [google.rpc.Code.NOT_FOUND][]. NOT_FOUND = 5; // The consumer doesn't have access to the specified resource. @@ -43,6 +43,9 @@ message CheckError { // Quota check failed. Same as [google.rpc.Code.RESOURCE_EXHAUSTED][]. RESOURCE_EXHAUSTED = 8; + // The consumer has been flagged as an abuser. + ABUSER_DETECTED = 103; + // The consumer hasn't activated the service. SERVICE_NOT_ACTIVATED = 104; @@ -80,6 +83,26 @@ message CheckError { // The consumer's API Key was not found in config record. API_KEY_NOT_FOUND = 113; + // Request is not allowed as per security policies defined in Org Policy. + SECURITY_POLICY_VIOLATED = 121; + + // The credential in the request can not be verified. + INVALID_CREDENTIAL = 123; + + // Request is not allowed as per location policies defined in Org Policy. + LOCATION_POLICY_VIOLATED = 124; + + // The input consumer info does not represent a valid consumer folder or + // organization. + CONSUMER_INVALID = 125; + + // NOTE: By convention, all *_UNAVAILABLE codes are required to be in the + // 300 - 399 range. + + // NOTE: Unless there are very special business requirements, service + // producer should ignore the following errors. These errors should not + // cause the rejection of client requests. + // The backend server for looking up project id/number is unavailable. NAMESPACE_LOOKUP_UNAVAILABLE = 300; @@ -88,6 +111,18 @@ message CheckError { // The backend server for checking billing status is unavailable. BILLING_STATUS_UNAVAILABLE = 302; + + // The backend server for checking quota limits is unavailable. + QUOTA_CHECK_UNAVAILABLE = 303; + + // Cloud Resource Manager backend server is unavailable. + CLOUD_RESOURCE_MANAGER_BACKEND_UNAVAILABLE = 305; + + // Backend server for evaluating security policy is unavailable. + SECURITY_POLICY_BACKEND_UNAVAILABLE = 306; + + // Backend server for evaluating location policy is unavailable. + LOCATION_POLICY_BACKEND_UNAVAILABLE = 307; } // The error code. diff --git a/third_party/googleapis/google/api/servicemanagement/BUILD.bazel b/third_party/googleapis/google/api/servicemanagement/BUILD.bazel index e69de29bb..1e5b8c2af 100644 --- a/third_party/googleapis/google/api/servicemanagement/BUILD.bazel +++ b/third_party/googleapis/google/api/servicemanagement/BUILD.bazel @@ -0,0 +1 @@ +exports_files(glob(["*.yaml"])) \ No newline at end of file diff --git a/third_party/googleapis/google/api/servicemanagement/artman_servicemanagement_v1.yaml b/third_party/googleapis/google/api/servicemanagement/artman_servicemanagement_v1.yaml index cfb5fce21..a7e229cf9 100644 --- a/third_party/googleapis/google/api/servicemanagement/artman_servicemanagement_v1.yaml +++ b/third_party/googleapis/google/api/servicemanagement/artman_servicemanagement_v1.yaml @@ -3,11 +3,12 @@ common: api_version: v1 organization_name: google-cloud proto_deps: - - name: google-common-protos + - name: google-common-protos src_proto_paths: - v1 - service_yaml: servicemanagement_v1.yaml + service_yaml: v1/servicemanagement_v1.yaml gapic_yaml: v1/servicemanagement_gapic.yaml + proto_package: google.api.servicemanagement.v1 artifacts: - name: gapic_config type: GAPIC_CONFIG diff --git a/third_party/googleapis/google/api/servicemanagement/servicemanagement_v1.yaml b/third_party/googleapis/google/api/servicemanagement/servicemanagement_v1.yaml deleted file mode 100644 index b23a788f8..000000000 --- a/third_party/googleapis/google/api/servicemanagement/servicemanagement_v1.yaml +++ /dev/null @@ -1,233 +0,0 @@ -type: google.api.Service -config_version: 2 -name: servicemanagement.googleapis.com -title: Google Service Management API - -apis: -- name: google.api.servicemanagement.v1.ServiceManager - -types: -- name: google.api.servicemanagement.v1.ConfigSource -- name: google.api.servicemanagement.v1.ConfigRef -- name: google.api.servicemanagement.v1.OperationMetadata -- name: google.api.servicemanagement.v1.Rollout -- name: google.api.servicemanagement.v1.SubmitConfigSourceResponse -- name: google.api.servicemanagement.v1.UndeleteServiceResponse - -documentation: - summary: |- - Google Service Management allows service producers to publish their services - on Google Cloud Platform so that they can be discovered and used by service - consumers. - overview: |- - Google Service Management manages a set of *services*. Service Management - allows *service producers* to publish their services on Google Cloud - Platform so that they can be discovered and used by *service consumers*. It - also handles the tasks of tracking service lifecycle and programming various - backend systems -- such as [Stackdriver - Logging](https://cloud.google.com/stackdriver), [Stackdriver - Monitoring](https://cloud.google.com/stackdriver) -- to support the managed - services. - - If you are a service producer, you can use the Google Service Management API - and [Google Cloud SDK (gcloud)](/sdk) to publish and manage your services. - Each managed service has a service configuration which declares various - aspects of the service such as its API surface, along with parameters to - configure the supporting backend systems, such as logging and monitoring. If - you build your service using [Google Cloud - Endpoints](https://cloud.google.com/endpoints/), the service configuration - will be handled automatically. - - If you are a service consumer and want to use a managed service, you can use - the Google Service Management API or [Google Cloud - Console](https://console.cloud.google.com) to activate the service for your - [Google developer project](https://developers.google.com/console/help/new/), - then start using its APIs and functions. - - ## Managed services - - REST URL: - `https://servicemanagement.googleapis.com/v1/services/{service-name}`
- REST schema is defined - [here](/service-management/reference/rest/v1/services). - - A managed service refers to a network service managed by Service Management. - Each managed service has a unique name, such as `example.googleapis.com`, - which must be a valid fully-qualified DNS name, as per RFC 1035. - - A managed service typically provides some REST APIs and/or other functions - to their service consumers, such as mobile apps or cloud services. - - Service producers can use methods, such as - [services.create](/service-management/reference/rest/v1/services/create), - [services.delete](/service-management/reference/rest/v1/services/delete), - [services.undelete](/service-management/reference/rest/v1/services/undelete), - to manipulate their managed services. - - ## Service producers - - A service producer is the Google developer project responsible for - publishing and maintaining a managed service. Each managed service is owned - by exactly one service producer. - - ## Service consumers - - A service consumer is a Google developer project that has enabled and can - invoke APIs on a managed service. A managed service can have many service - consumers. - - ## Service configuration - - REST URL: - `https://servicemanagement.googleapis.com/v1/services/{service-name}/configs/{config_id}` -
REST schema is defined - [here](/service-management/reference/rest/v1/services.configs). - - Each managed service is described by a service configuration which covers a - wide range of features, including its name, title, RPC API definitions, REST - API definitions, documentation, authentication, and more. - - To change the configuration of a managed service, the service producer needs - to publish an updated service configuration to Service Management. Service - Management keeps a history of published service configurations, making it - possible to easily retrace how a service's configuration evolved over time. - Service configurations can be published using the - [services.configs.create](/service-management/reference/rest/v1/services.configs/create) - or - [services.configs.submit](/service-management/reference/rest/v1/services.configs/submit) - methods. - - Alternatively, `services.configs.submit` allows publishing an - [OpenAPI](https://github.com/OAI/OpenAPI-Specification) specification, - formerly known as the Swagger Specification, which is automatically - converted to a corresponding service configuration. - - ## Service rollout - - REST URL: - `https://servicemanagement.googleapis.com/v1/services/{service-name}/rollouts/{rollout-id}` -
REST schema is defined - [here](/service-management/reference/rest/v1/services.rollouts). - - A `Rollout` defines how Google Service Management should deploy service - configurations to backend systems and how the configurations take effect at - runtime. It lets service producers specify multiple service configuration - versions to be deployed together, and a strategy that indicates how they - should be used. - - Updating a managed service's configuration can be dangerous, as a - configuration error can lead to a service outage. To mitigate risks, Service - Management supports gradual rollout of service configuration changes. This - feature gives service producers time to identity potential issues and - rollback service configuration changes in case of errors, thus minimizing - the customer impact of bad configurations. For example, you could specify - that 5% of traffic uses configuration 1, while the remaining 95% uses - configuration 2. - - Service Management keeps a history of rollouts so that service producers can - undo to previous configuration versions. You can rollback a configuration by - initiating a new `Rollout` that clones a previously submitted rollout - record. - rules: - - selector: google.longrunning.Operations.ListOperations - description: Lists service operations that match the specified filter in the request. - -backend: - rules: - - selector: google.longrunning.Operations.ListOperations - deadline: 10.0 - - selector: google.longrunning.Operations.GetOperation - deadline: 10.0 - - selector: google.api.servicemanagement.v1.ServiceManager.ListServices - deadline: 10.0 - - selector: google.api.servicemanagement.v1.ServiceManager.GetService - deadline: 10.0 - - selector: google.api.servicemanagement.v1.ServiceManager.CreateService - deadline: 20.0 - - selector: google.api.servicemanagement.v1.ServiceManager.DeleteService - deadline: 10.0 - - selector: google.api.servicemanagement.v1.ServiceManager.UndeleteService - deadline: 10.0 - - selector: google.api.servicemanagement.v1.ServiceManager.ListServiceConfigs - deadline: 10.0 - - selector: google.api.servicemanagement.v1.ServiceManager.GetServiceConfig - deadline: 10.0 - - selector: google.api.servicemanagement.v1.ServiceManager.CreateServiceConfig - deadline: 20.0 - - selector: google.api.servicemanagement.v1.ServiceManager.SubmitConfigSource - deadline: 20.0 - - selector: google.api.servicemanagement.v1.ServiceManager.ListServiceRollouts - deadline: 10.0 - - selector: google.api.servicemanagement.v1.ServiceManager.GetServiceRollout - deadline: 10.0 - - selector: google.api.servicemanagement.v1.ServiceManager.CreateServiceRollout - deadline: 10.0 - - selector: google.api.servicemanagement.v1.ServiceManager.GenerateConfigReport - deadline: 10.0 - - selector: google.api.servicemanagement.v1.ServiceManager.EnableService - deadline: 10.0 - - selector: google.api.servicemanagement.v1.ServiceManager.DisableService - deadline: 10.0 - - selector: google.iam.v1.IAMPolicy.SetIamPolicy - deadline: 10.0 - - selector: google.iam.v1.IAMPolicy.GetIamPolicy - deadline: 10.0 - - selector: google.iam.v1.IAMPolicy.TestIamPermissions - deadline: 10.0 - -http: - rules: - - selector: google.longrunning.Operations.ListOperations - get: /v1/operations - - - selector: google.iam.v1.IAMPolicy.SetIamPolicy - post: '/v1/{resource=services/*}:setIamPolicy' - body: '*' - additional_bindings: - - post: '/v1/{resource=services/*/consumers/*}:setIamPolicy' - body: '*' - - - selector: google.iam.v1.IAMPolicy.GetIamPolicy - post: '/v1/{resource=services/*}:getIamPolicy' - body: '*' - additional_bindings: - - post: '/v1/{resource=services/*/consumers/*}:getIamPolicy' - body: '*' - - - selector: google.iam.v1.IAMPolicy.TestIamPermissions - post: '/v1/{resource=services/*}:testIamPermissions' - body: '*' - additional_bindings: - - post: '/v1/{resource=services/*/consumers/*}:testIamPermissions' - body: '*' - - -authentication: - rules: - - selector: '*' - oauth: - canonical_scopes: |- - https://www.googleapis.com/auth/cloud-platform, - https://www.googleapis.com/auth/service.management - - selector: |- - google.api.servicemanagement.v1.ServiceManager.GetService, - google.api.servicemanagement.v1.ServiceManager.GetServiceConfig, - google.api.servicemanagement.v1.ServiceManager.GetServiceRollout, - google.api.servicemanagement.v1.ServiceManager.ListServiceConfigs, - google.api.servicemanagement.v1.ServiceManager.ListServiceRollouts, - google.api.servicemanagement.v1.ServiceManager.ListServices - oauth: - canonical_scopes: |- - https://www.googleapis.com/auth/cloud-platform, - https://www.googleapis.com/auth/cloud-platform.read-only, - https://www.googleapis.com/auth/service.management, - https://www.googleapis.com/auth/service.management.readonly - - selector: |- - google.iam.v1.IAMPolicy.GetIamPolicy, - google.iam.v1.IAMPolicy.TestIamPermissions - oauth: - canonical_scopes: |- - https://www.googleapis.com/auth/cloud-platform, - https://www.googleapis.com/auth/cloud-platform.read-only, - https://www.googleapis.com/auth/service.management, - https://www.googleapis.com/auth/service.management.readonly diff --git a/third_party/googleapis/google/api/servicemanagement/v1/BUILD.bazel b/third_party/googleapis/google/api/servicemanagement/v1/BUILD.bazel new file mode 100644 index 000000000..13cdb85a1 --- /dev/null +++ b/third_party/googleapis/google/api/servicemanagement/v1/BUILD.bazel @@ -0,0 +1,385 @@ +# This file was automatically generated by BuildFileGenerator + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") +load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") + +proto_library( + name = "servicemanagement_proto", + srcs = [ + "resources.proto", + "servicemanager.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:config_change_proto", + "//google/api:field_behavior_proto", + "//google/api:metric_proto", + "//google/api:quota_proto", + "//google/api:service_proto", + "//google/longrunning:operations_proto", + "//google/rpc:status_proto", + "@com_google_protobuf//:any_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +proto_library_with_info( + name = "servicemanagement_proto_with_info", + deps = [ + ":servicemanagement_proto", + "//google/cloud:common_resources_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", + "java_proto_library", +) + +java_proto_library( + name = "servicemanagement_java_proto", + deps = [":servicemanagement_proto"], +) + +java_grpc_library( + name = "servicemanagement_java_grpc", + srcs = [":servicemanagement_proto"], + deps = [":servicemanagement_java_proto"], +) + +java_gapic_library( + name = "servicemanagement_java_gapic", + src = ":servicemanagement_proto_with_info", + gapic_yaml = "servicemanagement_gapic.yaml", + package = "google.api.servicemanagement.v1", + service_yaml = "servicemanagement_v1.yaml", + test_deps = [ + ":servicemanagement_java_grpc", + ], + deps = [ + ":servicemanagement_java_proto", + "//google/api:api_java_proto", + ], +) + +java_gapic_test( + name = "servicemanagement_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.api.servicemanagement.v1.ServiceManagerClientTest", + ], + runtime_deps = [":servicemanagement_java_gapic_test"], +) + +# Open Source Packages +java_gapic_assembly_gradle_pkg( + name = "google-cloud-api-servicemanagement-v1-java", + deps = [ + ":servicemanagement_java_gapic", + ":servicemanagement_java_grpc", + ":servicemanagement_java_proto", + ":servicemanagement_proto", + ], +) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", + "go_proto_library", + "go_test", +) + +go_proto_library( + name = "servicemanagement_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/api/servicemanagement/v1", + protos = [":servicemanagement_proto"], + deps = [ + "//google/api:annotations_go_proto", + "//google/api:configchange_go_proto", + "//google/api:metric_go_proto", + "//google/api:serviceconfig_go_proto", + "//google/longrunning:longrunning_go_proto", + "//google/rpc:status_go_proto", + ], +) + +go_gapic_library( + name = "servicemanagement_go_gapic", + srcs = [":servicemanagement_proto_with_info"], + grpc_service_config = "servicemanagement_grpc_service_config.json", + importpath = "cloud.google.com/go/api/servicemanagement/apiv1;servicemanagement", + service_yaml = "servicemanagement_v1.yaml", + deps = [ + ":servicemanagement_go_proto", + "//google/api:serviceconfig_go_proto", + "//google/longrunning:longrunning_go_gapic", + "//google/longrunning:longrunning_go_proto", + "@com_google_cloud_go//longrunning:go_default_library", + "@com_google_cloud_go//longrunning/autogen:go_default_library", + "@io_bazel_rules_go//proto/wkt:any_go_proto", + ], +) + +go_test( + name = "servicemanagement_go_gapic_test", + srcs = [":servicemanagement_go_gapic_srcjar_test"], + embed = [":servicemanagement_go_gapic"], + importpath = "cloud.google.com/go/api/servicemanagement/apiv1", +) + +# Open Source Packages +go_gapic_assembly_pkg( + name = "gapi-cloud-api-servicemanagement-v1-go", + deps = [ + ":servicemanagement_go_gapic", + ":servicemanagement_go_gapic_srcjar-test.srcjar", + ":servicemanagement_go_proto", + ], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "servicemanagement_moved_proto", + srcs = [":servicemanagement_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:config_change_proto", + "//google/api:field_behavior_proto", + "//google/api:metric_proto", + "//google/api:quota_proto", + "//google/api:service_proto", + "//google/longrunning:operations_proto", + "//google/rpc:status_proto", + "@com_google_protobuf//:any_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +py_proto_library( + name = "servicemanagement_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":servicemanagement_moved_proto"], +) + +py_grpc_library( + name = "servicemanagement_py_grpc", + srcs = [":servicemanagement_moved_proto"], + deps = [":servicemanagement_py_proto"], +) + +py_gapic_library( + name = "servicemanagement_py_gapic", + src = ":servicemanagement_proto_with_info", + gapic_yaml = "servicemanagement_gapic.yaml", + package = "google.api.servicemanagement.v1", + service_yaml = "servicemanagement_v1.yaml", + deps = [ + ":servicemanagement_py_grpc", + ":servicemanagement_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "api-servicemanagement-v1-py", + deps = [ + ":servicemanagement_py_gapic", + ":servicemanagement_py_grpc", + ":servicemanagement_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "servicemanagement_php_proto", + deps = [":servicemanagement_proto"], +) + +php_grpc_library( + name = "servicemanagement_php_grpc", + srcs = [":servicemanagement_proto"], + deps = [":servicemanagement_php_proto"], +) + +php_gapic_library( + name = "servicemanagement_php_gapic", + src = ":servicemanagement_proto_with_info", + gapic_yaml = "servicemanagement_gapic.yaml", + package = "google.api.servicemanagement.v1", + service_yaml = "servicemanagement_v1.yaml", + deps = [ + ":servicemanagement_php_grpc", + ":servicemanagement_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-api-servicemanagement-v1-php", + deps = [ + ":servicemanagement_php_gapic", + ":servicemanagement_php_grpc", + ":servicemanagement_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "servicemanagement_nodejs_gapic", + src = ":servicemanagement_proto_with_info", + gapic_yaml = "servicemanagement_gapic.yaml", + package = "google.api.servicemanagement.v1", + service_yaml = "servicemanagement_v1.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "api-servicemanagement-v1-nodejs", + deps = [ + ":servicemanagement_nodejs_gapic", + ":servicemanagement_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "servicemanagement_ruby_proto", + deps = [":servicemanagement_proto"], +) + +ruby_grpc_library( + name = "servicemanagement_ruby_grpc", + srcs = [":servicemanagement_proto"], + deps = [":servicemanagement_ruby_proto"], +) + +ruby_gapic_library( + name = "servicemanagement_ruby_gapic", + src = ":servicemanagement_proto_with_info", + gapic_yaml = "servicemanagement_gapic.yaml", + package = "google.api.servicemanagement.v1", + service_yaml = "servicemanagement_v1.yaml", + deps = [ + ":servicemanagement_ruby_grpc", + ":servicemanagement_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-api-servicemanagement-v1-ruby", + deps = [ + ":servicemanagement_ruby_gapic", + ":servicemanagement_ruby_grpc", + ":servicemanagement_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "servicemanagement_csharp_proto", + deps = [":servicemanagement_proto"], +) + +csharp_grpc_library( + name = "servicemanagement_csharp_grpc", + srcs = [":servicemanagement_proto"], + deps = [":servicemanagement_csharp_proto"], +) + +csharp_gapic_library( + name = "servicemanagement_csharp_gapic", + src = ":servicemanagement_proto_with_info", + gapic_yaml = "servicemanagement_gapic.yaml", + package = "google.api.servicemanagement.v1", + service_yaml = "servicemanagement_v1.yaml", + deps = [ + ":servicemanagement_csharp_grpc", + ":servicemanagement_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-api-servicemanagement-v1-csharp", + deps = [ + ":servicemanagement_csharp_gapic", + ":servicemanagement_csharp_grpc", + ":servicemanagement_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/api/servicemanagement/v1/resources.proto b/third_party/googleapis/google/api/servicemanagement/v1/resources.proto index 1c924849c..d7eee52c9 100644 --- a/third_party/googleapis/google/api/servicemanagement/v1/resources.proto +++ b/third_party/googleapis/google/api/servicemanagement/v1/resources.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google Inc. +// Copyright 2019 Google LLC. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,6 +11,7 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. +// syntax = "proto3"; @@ -18,12 +19,13 @@ package google.api.servicemanagement.v1; import "google/api/annotations.proto"; import "google/api/config_change.proto"; +import "google/api/field_behavior.proto"; import "google/api/metric.proto"; +import "google/api/quota.proto"; import "google/api/service.proto"; import "google/longrunning/operations.proto"; import "google/protobuf/any.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/struct.proto"; import "google/protobuf/timestamp.proto"; import "google/rpc/status.proto"; @@ -195,7 +197,7 @@ message ChangeReport { message Rollout { // Strategy that specifies how clients of Google Service Controller want to // send traffic to use different config versions. This is generally - // used by API proxy to split traffic based on your configured precentage for + // used by API proxy to split traffic based on your configured percentage for // each config version. // // One example of how to gradually rollout a new service configuration using @@ -232,7 +234,9 @@ message Rollout { // Strategy used to delete a service. This strategy is a placeholder only // used by the system generated rollout to delete a service. - message DeleteServiceStrategy {} + message DeleteServiceStrategy { + + } // Status of a Rollout. enum RolloutStatus { @@ -260,15 +264,15 @@ message Rollout { FAILED_ROLLED_BACK = 6; } - // Optional unique identifier of this Rollout. Only lower case letters, digits - // and '-' are allowed. + // Optional. Unique identifier of this Rollout. Must be no longer than 63 characters + // and only lower case letters, digits, '.', '_' and '-' are allowed. // // If not specified by client, the server will generate one. The generated id // will have the form of , where "date" is the create // date in ISO 8601 format. "revision number" is a monotonically increasing // positive number that is reset every day for each service. // An example of the generated rollout_id is '2016-02-16r1' - string rollout_id = 1; + string rollout_id = 1 [(google.api.field_behavior) = OPTIONAL]; // Creation time of the rollout. Readonly. google.protobuf.Timestamp create_time = 2; diff --git a/third_party/googleapis/google/api/servicemanagement/v1/servicemanagement_gapic.legacy.yaml b/third_party/googleapis/google/api/servicemanagement/v1/servicemanagement_gapic.legacy.yaml new file mode 100644 index 000000000..7086218c1 --- /dev/null +++ b/third_party/googleapis/google/api/servicemanagement/v1/servicemanagement_gapic.legacy.yaml @@ -0,0 +1,300 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 1.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.api.servicemanagement.v1 + python: + package_name: google.cloud.api.servicemanagement_v1.gapic + go: + package_name: cloud.google.com/go/api/servicemanagement/apiv1 + csharp: + package_name: Google.Api.Servicemanagement.V1 + ruby: + package_name: Google::Cloud::Api::Servicemanagement::V1 + php: + package_name: Google\Cloud\Api\Servicemanagement\V1 + nodejs: + package_name: servicemanagement.v1 +# A list of API interface configurations. +interfaces: +- name: google.api.servicemanagement.v1.ServiceManager + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + smoke_test: + method: ListServices + init_fields: + - producer_project_id=$PROJECT_ID + collections: [] + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - UNAVAILABLE + - DEADLINE_EXCEEDED + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # + # name - The simple name of the method. + # + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce method + # overloads which allow a client to directly pass request message fields as + # method parameters. This information may or may not be used, depending on + # the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request message. + # + # required_fields - Fields that are always required for a request to be + # valid. + # + # resource_name_treatment - An enum that specifies how to treat the resource + # name formats defined in the field_name_patterns and + # response_field_name_patterns fields. + # UNSET: default value + # NONE: the collection configs will not be used by the generated code. + # VALIDATE: string fields will be validated by the client against the + # specified resource name formats. + # STATIC_TYPES: the client will use generated types for resource names. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a paging + # list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It defines + # which fields match the paging pattern in the request. The request consists + # of a page_size_field and a token_field. The page_size_field is the name of + # the optional field specifying the maximum number of elements to be + # returned in the response. The token_field is the name of the field in the + # request containing the page token. + # The response specifies response information of the list method. It defines + # which fields match the paging pattern in the response. The response + # consists of a token_field and a resources_field. The token_field is the + # name of the field in the response containing the next page token. The + # resources_field is the name of the field in the response containing the + # list of resources belonging to the page. + # + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: ListServices + flattening: + groups: + - parameters: + - producer_project_id + - consumer_id + required_fields: + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: services + retry_codes_name: idempotent + retry_params_name: default + timeout_millis: 10000 + - name: GetService + flattening: + groups: + - parameters: + - service_name + required_fields: + - service_name + retry_codes_name: idempotent + retry_params_name: default + timeout_millis: 10000 + - name: CreateService + flattening: + groups: + - parameters: + - service + required_fields: + - service + retry_codes_name: non_idempotent + retry_params_name: default + timeout_millis: 20000 + - name: DeleteService + flattening: + groups: + - parameters: + - service_name + required_fields: + - service_name + retry_codes_name: idempotent + retry_params_name: default + timeout_millis: 60000 + - name: UndeleteService + flattening: + groups: + - parameters: + - service_name + required_fields: + - service_name + retry_codes_name: non_idempotent + retry_params_name: default + # REVIEW: Could this operation take a long time? + timeout_millis: 60000 + - name: ListServiceConfigs + flattening: + groups: + - parameters: + - service_name + required_fields: + - service_name + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: service_configs + retry_codes_name: idempotent + retry_params_name: default + timeout_millis: 10000 + - name: GetServiceConfig + flattening: + groups: + - parameters: + - service_name + - config_id + - view + required_fields: + - service_name + - config_id + retry_codes_name: idempotent + retry_params_name: default + timeout_millis: 10000 + - name: CreateServiceConfig + flattening: + groups: + - parameters: + - service_name + - service_config + required_fields: + - service_name + - service_config + retry_codes_name: non_idempotent + retry_params_name: default + timeout_millis: 20000 + - name: SubmitConfigSource + flattening: + groups: + - parameters: + - service_name + - config_source + - validate_only + required_fields: + - service_name + - config_source + retry_codes_name: non_idempotent + retry_params_name: default + timeout_millis: 10000 + - name: ListServiceRollouts + flattening: + groups: + - parameters: + - service_name + - filter + required_fields: + - service_name + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: rollouts + retry_codes_name: idempotent + retry_params_name: default + timeout_millis: 10000 + - name: GetServiceRollout + flattening: + groups: + - parameters: + - service_name + - rollout_id + required_fields: + - service_name + - rollout_id + retry_codes_name: idempotent + retry_params_name: default + timeout_millis: 10000 + - name: CreateServiceRollout + flattening: + groups: + - parameters: + - service_name + - rollout + required_fields: + - service_name + - rollout + retry_codes_name: non_idempotent + retry_params_name: default + timeout_millis: 10000 + - name: GenerateConfigReport + flattening: + groups: + - parameters: + - new_config + - old_config + required_fields: + - new_config + - old_config + retry_codes_name: non_idempotent + retry_params_name: default + timeout_millis: 10000 + - name: EnableService + flattening: + groups: + - parameters: + - service_name + - consumer_id + required_fields: + - service_name + - consumer_id + retry_codes_name: idempotent + retry_params_name: default + timeout_millis: 10000 + - name: DisableService + flattening: + groups: + - parameters: + - service_name + - consumer_id + required_fields: + - service_name + - consumer_id + retry_codes_name: idempotent + retry_params_name: default + timeout_millis: 10000 diff --git a/third_party/googleapis/google/api/servicemanagement/v1/servicemanagement_gapic.yaml b/third_party/googleapis/google/api/servicemanagement/v1/servicemanagement_gapic.yaml index 0cca80e29..e6985653f 100644 --- a/third_party/googleapis/google/api/servicemanagement/v1/servicemanagement_gapic.yaml +++ b/third_party/googleapis/google/api/servicemanagement/v1/servicemanagement_gapic.yaml @@ -1,5 +1,5 @@ type: com.google.api.codegen.ConfigProto -config_schema_version: 1.0.0 +config_schema_version: 2.0.0 # The settings of generated code in a specific language. language_settings: java: @@ -16,286 +16,3 @@ language_settings: package_name: Google\Cloud\Api\Servicemanagement\V1 nodejs: package_name: servicemanagement.v1 -# A list of API interface configurations. -interfaces: - # The fully qualified name of the API interface. -- name: google.api.servicemanagement.v1.ServiceManager - # A list of resource collection configurations. - # Consists of a name_pattern and an entity_name. - # The name_pattern is a pattern to describe the names of the resources of this - # collection, using the platform's conventions for URI patterns. A generator - # may use this to generate methods to compose and decompose such names. The - # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; - # those will be taken as hints for the parameter names of the generated - # methods. If empty, no name methods are generated. - # The entity_name is the name to be used as a basis for generated methods and - # classes. - smoke_test: - method: ListServices - init_fields: - - producer_project_id=$PROJECT_ID - collections: [] - # Definition for retryable codes. - retry_codes_def: - - name: idempotent - retry_codes: - - UNAVAILABLE - - DEADLINE_EXCEEDED - - name: non_idempotent - retry_codes: [] - # Definition for retry/backoff parameters. - retry_params_def: - - name: default - initial_retry_delay_millis: 100 - retry_delay_multiplier: 1.3 - max_retry_delay_millis: 60000 - initial_rpc_timeout_millis: 20000 - rpc_timeout_multiplier: 1 - max_rpc_timeout_millis: 20000 - total_timeout_millis: 600000 - # A list of method configurations. - # Common properties: - # - # name - The simple name of the method. - # - # flattening - Specifies the configuration for parameter flattening. - # Describes the parameter groups for which a generator should produce method - # overloads which allow a client to directly pass request message fields as - # method parameters. This information may or may not be used, depending on - # the target language. - # Consists of groups, which each represent a list of parameters to be - # flattened. Each parameter listed must be a field of the request message. - # - # required_fields - Fields that are always required for a request to be - # valid. - # - # resource_name_treatment - An enum that specifies how to treat the resource - # name formats defined in the field_name_patterns and - # response_field_name_patterns fields. - # UNSET: default value - # NONE: the collection configs will not be used by the generated code. - # VALIDATE: string fields will be validated by the client against the - # specified resource name formats. - # STATIC_TYPES: the client will use generated types for resource names. - # - # page_streaming - Specifies the configuration for paging. - # Describes information for generating a method which transforms a paging - # list RPC into a stream of resources. - # Consists of a request and a response. - # The request specifies request information of the list method. It defines - # which fields match the paging pattern in the request. The request consists - # of a page_size_field and a token_field. The page_size_field is the name of - # the optional field specifying the maximum number of elements to be - # returned in the response. The token_field is the name of the field in the - # request containing the page token. - # The response specifies response information of the list method. It defines - # which fields match the paging pattern in the response. The response - # consists of a token_field and a resources_field. The token_field is the - # name of the field in the response containing the next page token. The - # resources_field is the name of the field in the response containing the - # list of resources belonging to the page. - # - # retry_codes_name - Specifies the configuration for retryable codes. The - # name must be defined in interfaces.retry_codes_def. - # - # retry_params_name - Specifies the configuration for retry/backoff - # parameters. The name must be defined in interfaces.retry_params_def. - # - # field_name_patterns - Maps the field name of the request type to - # entity_name of interfaces.collections. - # Specifies the string pattern that the field must follow. - # - # timeout_millis - Specifies the default timeout for a non-retrying call. If - # the call is retrying, refer to retry_params_name instead. - methods: - - name: ListServices - flattening: - groups: - - parameters: - - producer_project_id - - consumer_id - required_fields: - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: services - retry_codes_name: idempotent - retry_params_name: default - timeout_millis: 10000 - - name: GetService - flattening: - groups: - - parameters: - - service_name - required_fields: - - service_name - retry_codes_name: idempotent - retry_params_name: default - timeout_millis: 10000 - - name: CreateService - flattening: - groups: - - parameters: - - service - required_fields: - - service - retry_codes_name: non_idempotent - retry_params_name: default - timeout_millis: 20000 - - name: DeleteService - flattening: - groups: - - parameters: - - service_name - required_fields: - - service_name - retry_codes_name: idempotent - retry_params_name: default - timeout_millis: 60000 - - name: UndeleteService - flattening: - groups: - - parameters: - - service_name - required_fields: - - service_name - retry_codes_name: non_idempotent - retry_params_name: default - # REVIEW: Could this operation take a long time? - timeout_millis: 60000 - - name: ListServiceConfigs - flattening: - groups: - - parameters: - - service_name - required_fields: - - service_name - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: service_configs - retry_codes_name: idempotent - retry_params_name: default - timeout_millis: 10000 - - name: GetServiceConfig - flattening: - groups: - - parameters: - - service_name - - config_id - - view - required_fields: - - service_name - - config_id - retry_codes_name: idempotent - retry_params_name: default - timeout_millis: 10000 - - name: CreateServiceConfig - flattening: - groups: - - parameters: - - service_name - - service_config - required_fields: - - service_name - - service_config - retry_codes_name: non_idempotent - retry_params_name: default - timeout_millis: 20000 - - name: SubmitConfigSource - flattening: - groups: - - parameters: - - service_name - - config_source - - validate_only - required_fields: - - service_name - - config_source - retry_codes_name: non_idempotent - retry_params_name: default - timeout_millis: 10000 - - name: ListServiceRollouts - flattening: - groups: - - parameters: - - service_name - - filter - required_fields: - - service_name - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: rollouts - retry_codes_name: idempotent - retry_params_name: default - timeout_millis: 10000 - - name: GetServiceRollout - flattening: - groups: - - parameters: - - service_name - - rollout_id - required_fields: - - service_name - - rollout_id - retry_codes_name: idempotent - retry_params_name: default - timeout_millis: 10000 - - name: CreateServiceRollout - flattening: - groups: - - parameters: - - service_name - - rollout - required_fields: - - service_name - - rollout - retry_codes_name: non_idempotent - retry_params_name: default - timeout_millis: 10000 - - name: GenerateConfigReport - flattening: - groups: - - parameters: - - new_config - - old_config - required_fields: - - new_config - - old_config - retry_codes_name: non_idempotent - retry_params_name: default - timeout_millis: 10000 - - name: EnableService - flattening: - groups: - - parameters: - - service_name - - consumer_id - required_fields: - - service_name - - consumer_id - retry_codes_name: idempotent - retry_params_name: default - timeout_millis: 10000 - - name: DisableService - flattening: - groups: - - parameters: - - service_name - - consumer_id - required_fields: - - service_name - - consumer_id - retry_codes_name: idempotent - retry_params_name: default - timeout_millis: 10000 diff --git a/third_party/googleapis/google/api/servicemanagement/v1/servicemanagement_grpc_service_config.json b/third_party/googleapis/google/api/servicemanagement/v1/servicemanagement_grpc_service_config.json new file mode 100755 index 000000000..e2ec9d59e --- /dev/null +++ b/third_party/googleapis/google/api/servicemanagement/v1/servicemanagement_grpc_service_config.json @@ -0,0 +1,12 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.api.servicemanagement.v1.ServiceManager" + } + ], + "timeout": "10s" + } + ] +} diff --git a/third_party/googleapis/google/api/servicemanagement/v1/servicemanagement_v1.yaml b/third_party/googleapis/google/api/servicemanagement/v1/servicemanagement_v1.yaml new file mode 100644 index 000000000..43640dd58 --- /dev/null +++ b/third_party/googleapis/google/api/servicemanagement/v1/servicemanagement_v1.yaml @@ -0,0 +1,275 @@ +type: google.api.Service +config_version: 2 +name: servicemanagement.googleapis.com +title: Service Management API + +apis: +- name: google.api.servicemanagement.v1.ServiceManager + +types: +- name: google.api.servicemanagement.v1.ConfigRef +- name: google.api.servicemanagement.v1.ConfigSource +- name: google.api.servicemanagement.v1.DisableServiceResponse +- name: google.api.servicemanagement.v1.EnableServiceResponse +- name: google.api.servicemanagement.v1.OperationMetadata +- name: google.api.servicemanagement.v1.Rollout +- name: google.api.servicemanagement.v1.SubmitConfigSourceResponse +- name: google.api.servicemanagement.v1.UndeleteServiceResponse + +documentation: + summary: |- + Google Service Management allows service producers to publish their + services on Google Cloud Platform so that they can be discovered and used + by service consumers. + overview: |- + Google Service Management manages a set of *services*. Service Management + allows *service producers* to + publish their services on Google Cloud Platform so that they can be + discovered and used by *service consumers*. It also handles the tasks of + tracking + service lifecycle and programming various backend systems -- such as + [Stackdriver Logging](https://cloud.google.com/stackdriver), + [Stackdriver Monitoring](https://cloud.google.com/stackdriver) -- to + support the managed services. + + If you are a service producer, you can use the Google Service Management + API and [Google Cloud SDK (gcloud)](/sdk) to publish and manage your + services. + Each managed service has a service configuration which declares various + aspects of the service such as its API surface, along with parameters to + configure the supporting backend systems, such as logging and monitoring. + If you build your service using + [Google Cloud Endpoints](https://cloud.google.com/endpoints/), the service + configuration will be handled automatically. + + If you are a service consumer and want to use a managed service, you can + use the Google Service Management API or [Google Cloud + Console](https://console.cloud.google.com) to activate the service for + your [Google developer + project](https://developers.google.com/console/help/new/), then start + using its APIs and functions. + + ## Managed services + + REST URL: + `https://servicemanagement.googleapis.com/v1/services/{service-name}`
REST schema is defined + [here](/service-management/reference/rest/v1/services). + + A managed service refers to a network service managed by + Service Management. Each managed service has a unique name, such as + `example.googleapis.com`, which must be a valid fully-qualified DNS name, + as per RFC 1035. + + A managed service typically provides some REST APIs and/or other + functions to their service consumers, such as mobile apps or cloud + services. + + Service producers can use methods, such as + [services.create](/service-management/reference/rest/v1/services/create), + [services.delete](/service-management/reference/rest/v1/services/delete), + [services.undelete](/service-management/reference/rest/v1/services/undelete), to + manipulate their managed services. + + ## Service producers + + A service producer is the Google developer project responsible for + publishing and maintaining a managed service. Each managed service is + owned by exactly one service producer. + + ## Service consumers + + A service consumer is a Google developer project that has enabled and can + invoke APIs on a managed service. A managed service can have many service + consumers. + + ## Service configuration + + REST URL: + `https://servicemanagement.googleapis.com/v1/services/{service-name}/configs/{config_id}` +
REST schema is defined + [here](/service-management/reference/rest/v1/services.configs). + + Each managed service is described by a service configuration which covers + a wide range of features, including its name, title, RPC API + definitions, + REST API definitions, documentation, authentication, and more. + + To change the configuration of a managed service, the service producer + needs to publish an updated service configuration to Service + Management. + Service Management keeps a history of published + service configurations, making it possible to easily retrace how a + service's configuration evolved over time. Service configurations can be + published + using the [services.configs.create](/service-management/reference/rest/v1/services.configs/create) or + [services.configs.submit](/service-management/reference/rest/v1/services.configs/submit) methods. Alternatively, + `services.configs.submit` allows publishing an + [OpenAPI](https://github.com/OAI/OpenAPI-Specification) specification, + formerly known as the Swagger Specification, which is automatically + converted to a corresponding service configuration. + + ## Service rollout + + REST URL: + `https://servicemanagement.googleapis.com/v1/services/{service-name}/rollouts/{rollout-id}` +
REST schema is defined + [here](/service-management/reference/rest/v1/services.rollouts). + + A `Rollout` defines how Google Service Management should deploy service + configurations to backend systems and how the configurations take effect + at runtime. It lets service producers specify multiple service + configuration + versions to be deployed together, and a strategy that indicates how they + should be used. + + Updating a managed service's configuration can be dangerous, as a + configuration error can lead to a service outage. To mitigate risks, + Service Management + supports gradual rollout of service configuration changes. This feature + gives service producers time to identity potential issues and rollback + service + configuration changes in case of errors, thus minimizing the customer + impact of bad configurations. For example, you could specify that 5% of + traffic uses configuration 1, while the remaining 95% uses configuration + 2. + + Service Management keeps a history of rollouts so that service + producers can undo to previous configuration versions. You can rollback a + configuration by initiating a new `Rollout` that clones a previously + submitted + rollout record. + rules: + - selector: google.iam.v1.IAMPolicy.GetIamPolicy + description: |- + Gets the access control policy for a resource. Returns an empty policy + if the resource exists and does not have a policy set. + + - selector: google.iam.v1.IAMPolicy.SetIamPolicy + description: |- + Sets the access control policy on the specified resource. Replaces + any existing policy. + + Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and + PERMISSION_DENIED + + - selector: google.iam.v1.IAMPolicy.TestIamPermissions + description: |- + Returns permissions that a caller has on the specified resource. If the + resource does not exist, this will return an empty set of + permissions, not a NOT_FOUND error. + + Note: This operation is designed to be used for building + permission-aware UIs and command-line tools, not for authorization + checking. This operation may "fail open" without warning. + + - selector: google.longrunning.Operations.ListOperations + description: Lists service operations that match the specified filter in the request. + +backend: + rules: + - selector: 'google.api.servicemanagement.v1.ServiceManager.*' + deadline: 10.0 + - selector: google.api.servicemanagement.v1.ServiceManager.CreateServiceConfig + deadline: 20.0 + - selector: 'google.iam.v1.IAMPolicy.*' + deadline: 10.0 + - selector: 'google.longrunning.Operations.*' + deadline: 10.0 + +http: + rules: + - selector: google.iam.v1.IAMPolicy.GetIamPolicy + post: '/v1/{resource=services/*}:getIamPolicy' + body: '*' + additional_bindings: + - post: '/v1/{resource=services/*/consumers/*}:getIamPolicy' + body: '*' + - selector: google.iam.v1.IAMPolicy.SetIamPolicy + post: '/v1/{resource=services/*}:setIamPolicy' + body: '*' + additional_bindings: + - post: '/v1/{resource=services/*/consumers/*}:setIamPolicy' + body: '*' + - selector: google.iam.v1.IAMPolicy.TestIamPermissions + post: '/v1/{resource=services/*}:testIamPermissions' + body: '*' + additional_bindings: + - post: '/v1/{resource=services/*/consumers/*}:testIamPermissions' + body: '*' + - selector: google.longrunning.Operations.ListOperations + get: /v1/operations + +authentication: + rules: + - selector: 'google.api.servicemanagement.v1.ServiceManager.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform, + https://www.googleapis.com/auth/service.management + - selector: google.api.servicemanagement.v1.ServiceManager.GetService + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform, + https://www.googleapis.com/auth/cloud-platform.read-only, + https://www.googleapis.com/auth/service.management, + https://www.googleapis.com/auth/service.management.readonly + - selector: google.api.servicemanagement.v1.ServiceManager.GetServiceConfig + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform, + https://www.googleapis.com/auth/cloud-platform.read-only, + https://www.googleapis.com/auth/service.management, + https://www.googleapis.com/auth/service.management.readonly + - selector: google.api.servicemanagement.v1.ServiceManager.GetServiceRollout + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform, + https://www.googleapis.com/auth/cloud-platform.read-only, + https://www.googleapis.com/auth/service.management, + https://www.googleapis.com/auth/service.management.readonly + - selector: google.api.servicemanagement.v1.ServiceManager.ListServiceConfigs + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform, + https://www.googleapis.com/auth/cloud-platform.read-only, + https://www.googleapis.com/auth/service.management, + https://www.googleapis.com/auth/service.management.readonly + - selector: google.api.servicemanagement.v1.ServiceManager.ListServiceRollouts + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform, + https://www.googleapis.com/auth/cloud-platform.read-only, + https://www.googleapis.com/auth/service.management, + https://www.googleapis.com/auth/service.management.readonly + - selector: google.api.servicemanagement.v1.ServiceManager.ListServices + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform, + https://www.googleapis.com/auth/cloud-platform.read-only, + https://www.googleapis.com/auth/service.management, + https://www.googleapis.com/auth/service.management.readonly + - selector: google.iam.v1.IAMPolicy.GetIamPolicy + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform, + https://www.googleapis.com/auth/cloud-platform.read-only, + https://www.googleapis.com/auth/service.management, + https://www.googleapis.com/auth/service.management.readonly + - selector: google.iam.v1.IAMPolicy.SetIamPolicy + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform, + https://www.googleapis.com/auth/service.management + - selector: google.iam.v1.IAMPolicy.TestIamPermissions + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform, + https://www.googleapis.com/auth/cloud-platform.read-only, + https://www.googleapis.com/auth/service.management, + https://www.googleapis.com/auth/service.management.readonly + - selector: 'google.longrunning.Operations.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform, + https://www.googleapis.com/auth/service.management diff --git a/third_party/googleapis/google/api/servicemanagement/v1/servicemanager.proto b/third_party/googleapis/google/api/servicemanagement/v1/servicemanager.proto index 02d506665..6069b8176 100644 --- a/third_party/googleapis/google/api/servicemanagement/v1/servicemanager.proto +++ b/third_party/googleapis/google/api/servicemanagement/v1/servicemanager.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google Inc. +// Copyright 2019 Google LLC. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -17,12 +17,13 @@ syntax = "proto3"; package google.api.servicemanagement.v1; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; import "google/api/service.proto"; import "google/api/servicemanagement/v1/resources.proto"; import "google/longrunning/operations.proto"; import "google/protobuf/any.proto"; import "google/protobuf/field_mask.proto"; -import "google/protobuf/struct.proto"; import "google/rpc/status.proto"; option csharp_namespace = "Google.Cloud.ServiceManagement.V1"; @@ -35,6 +36,13 @@ option php_namespace = "Google\\Cloud\\ServiceManagement\\V1"; // [Google Service Management API](/service-management/overview) service ServiceManager { + option (google.api.default_host) = "servicemanagement.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/cloud-platform.read-only," + "https://www.googleapis.com/auth/service.management," + "https://www.googleapis.com/auth/service.management.readonly"; + // Lists managed services. // // Returns all public services. For authenticated users, also returns all @@ -48,6 +56,7 @@ service ServiceManager { option (google.api.http) = { get: "/v1/services" }; + option (google.api.method_signature) = "producer_project_id,consumer_id"; } // Gets a managed service. Authentication is required unless the service is @@ -56,33 +65,40 @@ service ServiceManager { option (google.api.http) = { get: "/v1/services/{service_name}" }; + option (google.api.method_signature) = "service_name"; } // Creates a new managed service. // Please note one producer project can own no more than 20 services. // // Operation - rpc CreateService(CreateServiceRequest) - returns (google.longrunning.Operation) { + rpc CreateService(CreateServiceRequest) returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/services" body: "service" }; + option (google.api.method_signature) = "service"; + option (google.longrunning.operation_info) = { + response_type: "google.api.servicemanagement.v1.ManagedService" + metadata_type: "google.api.servicemanagement.v1.OperationMetadata" + }; } // Deletes a managed service. This method will change the service to the // `Soft-Delete` state for 30 days. Within this period, service producers may - // call - // [UndeleteService][google.api.servicemanagement.v1.ServiceManager.UndeleteService] - // to restore the service. After 30 days, the service will be permanently - // deleted. + // call [UndeleteService][google.api.servicemanagement.v1.ServiceManager.UndeleteService] to restore the service. + // After 30 days, the service will be permanently deleted. // // Operation - rpc DeleteService(DeleteServiceRequest) - returns (google.longrunning.Operation) { + rpc DeleteService(DeleteServiceRequest) returns (google.longrunning.Operation) { option (google.api.http) = { delete: "/v1/services/{service_name}" }; + option (google.api.method_signature) = "service_name"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "google.api.servicemanagement.v1.OperationMetadata" + }; } // Revives a previously deleted managed service. The method restores the @@ -91,28 +107,35 @@ service ServiceManager { // last 30 days. // // Operation - rpc UndeleteService(UndeleteServiceRequest) - returns (google.longrunning.Operation) { + rpc UndeleteService(UndeleteServiceRequest) returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/services/{service_name}:undelete" }; + option (google.api.method_signature) = "service_name"; + option (google.longrunning.operation_info) = { + response_type: "google.api.servicemanagement.v1.UndeleteServiceResponse" + metadata_type: "google.api.servicemanagement.v1.OperationMetadata" + }; } // Lists the history of the service configuration for a managed service, // from the newest to the oldest. - rpc ListServiceConfigs(ListServiceConfigsRequest) - returns (ListServiceConfigsResponse) { + rpc ListServiceConfigs(ListServiceConfigsRequest) returns (ListServiceConfigsResponse) { option (google.api.http) = { get: "/v1/services/{service_name}/configs" }; + option (google.api.method_signature) = "service_name"; } // Gets a service configuration (version) for a managed service. rpc GetServiceConfig(GetServiceConfigRequest) returns (google.api.Service) { option (google.api.http) = { get: "/v1/services/{service_name}/configs/{config_id}" - additional_bindings { get: "/v1/services/{service_name}/config" } + additional_bindings { + get: "/v1/services/{service_name}/config" + } }; + option (google.api.method_signature) = "service_name,config_id,view"; } // Creates a new service configuration (version) for a managed service. @@ -123,12 +146,12 @@ service ServiceManager { // Only the 100 most recent service configurations and ones referenced by // existing rollouts are kept for each service. The rest will be deleted // eventually. - rpc CreateServiceConfig(CreateServiceConfigRequest) - returns (google.api.Service) { + rpc CreateServiceConfig(CreateServiceConfigRequest) returns (google.api.Service) { option (google.api.http) = { post: "/v1/services/{service_name}/configs" body: "service_config" }; + option (google.api.method_signature) = "service_name,service_config"; } // Creates a new service configuration (version) for a managed service based @@ -137,37 +160,40 @@ service ServiceManager { // Specification). This method stores the source configurations as well as the // generated service configuration. To rollout the service configuration to // other services, - // please call - // [CreateServiceRollout][google.api.servicemanagement.v1.ServiceManager.CreateServiceRollout]. + // please call [CreateServiceRollout][google.api.servicemanagement.v1.ServiceManager.CreateServiceRollout]. // // Only the 100 most recent configuration sources and ones referenced by // existing service configurtions are kept for each service. The rest will be // deleted eventually. // // Operation - rpc SubmitConfigSource(SubmitConfigSourceRequest) - returns (google.longrunning.Operation) { + rpc SubmitConfigSource(SubmitConfigSourceRequest) returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/services/{service_name}/configs:submit" body: "*" }; + option (google.api.method_signature) = "service_name,config_source,validate_only"; + option (google.longrunning.operation_info) = { + response_type: "google.api.servicemanagement.v1.SubmitConfigSourceResponse" + metadata_type: "google.api.servicemanagement.v1.OperationMetadata" + }; } // Lists the history of the service configuration rollouts for a managed // service, from the newest to the oldest. - rpc ListServiceRollouts(ListServiceRolloutsRequest) - returns (ListServiceRolloutsResponse) { + rpc ListServiceRollouts(ListServiceRolloutsRequest) returns (ListServiceRolloutsResponse) { option (google.api.http) = { get: "/v1/services/{service_name}/rollouts" }; + option (google.api.method_signature) = "service_name,filter"; } - // Gets a service configuration - // [rollout][google.api.servicemanagement.v1.Rollout]. + // Gets a service configuration [rollout][google.api.servicemanagement.v1.Rollout]. rpc GetServiceRollout(GetServiceRolloutRequest) returns (Rollout) { option (google.api.http) = { get: "/v1/services/{service_name}/rollouts/{rollout_id}" }; + option (google.api.method_signature) = "service_name,rollout_id"; } // Creates a new service configuration rollout. Based on rollout, the @@ -184,12 +210,16 @@ service ServiceManager { // service. The rest will be deleted eventually. // // Operation - rpc CreateServiceRollout(CreateServiceRolloutRequest) - returns (google.longrunning.Operation) { + rpc CreateServiceRollout(CreateServiceRolloutRequest) returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/services/{service_name}/rollouts" body: "rollout" }; + option (google.api.method_signature) = "service_name,rollout"; + option (google.longrunning.operation_info) = { + response_type: "google.api.servicemanagement.v1.Rollout" + metadata_type: "google.api.servicemanagement.v1.OperationMetadata" + }; } // Generates and returns a report (errors, warnings and changes from @@ -203,39 +233,49 @@ service ServiceManager { // If GenerateConfigReportRequest.old_value is not specified, this method // will compare GenerateConfigReportRequest.new_value with the last pushed // service configuration. - rpc GenerateConfigReport(GenerateConfigReportRequest) - returns (GenerateConfigReportResponse) { + rpc GenerateConfigReport(GenerateConfigReportRequest) returns (GenerateConfigReportResponse) { option (google.api.http) = { post: "/v1/services:generateConfigReport" body: "*" }; + option (google.api.method_signature) = "new_config,old_config"; } - // Enables a [service][google.api.servicemanagement.v1.ManagedService] for a - // project, so it can be used for the project. See [Cloud Auth - // Guide](https://cloud.google.com/docs/authentication) for more information. + // Enables a [service][google.api.servicemanagement.v1.ManagedService] for a project, so it can be used + // for the project. See + // [Cloud Auth Guide](https://cloud.google.com/docs/authentication) for + // more information. // // Operation - rpc EnableService(EnableServiceRequest) - returns (google.longrunning.Operation) { + rpc EnableService(EnableServiceRequest) returns (google.longrunning.Operation) { + option deprecated = true; option (google.api.http) = { post: "/v1/services/{service_name}:enable" body: "*" }; + option (google.api.method_signature) = "service_name,consumer_id"; + option (google.longrunning.operation_info) = { + response_type: "google.api.servicemanagement.v1.EnableServiceResponse" + metadata_type: "google.api.servicemanagement.v1.OperationMetadata" + }; } - // Disables a [service][google.api.servicemanagement.v1.ManagedService] for a - // project, so it can no longer be be used for the project. It prevents - // accidental usage that may cause unexpected billing charges or security - // leaks. + // Disables a [service][google.api.servicemanagement.v1.ManagedService] for a project, so it can no longer be + // be used for the project. It prevents accidental usage that may cause + // unexpected billing charges or security leaks. // // Operation - rpc DisableService(DisableServiceRequest) - returns (google.longrunning.Operation) { + rpc DisableService(DisableServiceRequest) returns (google.longrunning.Operation) { + option deprecated = true; option (google.api.http) = { post: "/v1/services/{service_name}:disable" body: "*" }; + option (google.api.method_signature) = "service_name,consumer_id"; + option (google.longrunning.operation_info) = { + response_type: "google.api.servicemanagement.v1.DisableServiceResponse" + metadata_type: "google.api.servicemanagement.v1.OperationMetadata" + }; } } @@ -244,7 +284,8 @@ message ListServicesRequest { // Include services produced by the specified project. string producer_project_id = 1; - // Requested size of the next page of data. + // The max number of items to include in the response list. Page size is 50 + // if not specified. Maximum value is 100. int32 page_size = 5; // Token identifying which result to start with; returned by a previous list @@ -256,7 +297,7 @@ message ListServicesRequest { // The Google Service Management implementation accepts the following // forms: // - project: - string consumer_id = 7; + string consumer_id = 7 [deprecated = true]; } // Response message for `ListServices` method. @@ -270,29 +311,29 @@ message ListServicesResponse { // Request message for `GetService` method. message GetServiceRequest { - // The name of the service. See the `ServiceManager` overview for naming + // Required. The name of the service. See the `ServiceManager` overview for naming // requirements. For example: `example.googleapis.com`. - string service_name = 1; + string service_name = 1 [(google.api.field_behavior) = REQUIRED]; } // Request message for CreateService method. message CreateServiceRequest { - // Initial values for the service resource. - ManagedService service = 1; + // Required. Initial values for the service resource. + ManagedService service = 1 [(google.api.field_behavior) = REQUIRED]; } // Request message for DeleteService method. message DeleteServiceRequest { - // The name of the service. See the [overview](/service-management/overview) + // Required. The name of the service. See the [overview](/service-management/overview) // for naming requirements. For example: `example.googleapis.com`. - string service_name = 1; + string service_name = 1 [(google.api.field_behavior) = REQUIRED]; } // Request message for UndeleteService method. message UndeleteServiceRequest { - // The name of the service. See the [overview](/service-management/overview) + // Required. The name of the service. See the [overview](/service-management/overview) // for naming requirements. For example: `example.googleapis.com`. - string service_name = 1; + string service_name = 1 [(google.api.field_behavior) = REQUIRED]; } // Response message for UndeleteService method. @@ -314,12 +355,15 @@ message GetServiceConfigRequest { FULL = 1; } - // The name of the service. See the [overview](/service-management/overview) + // Required. The name of the service. See the [overview](/service-management/overview) // for naming requirements. For example: `example.googleapis.com`. - string service_name = 1; + string service_name = 1 [(google.api.field_behavior) = REQUIRED]; - // The id of the service configuration resource. - string config_id = 2; + // Required. The id of the service configuration resource. + // + // This field must be specified for the server to return all fields, including + // `SourceInfo`. + string config_id = 2 [(google.api.field_behavior) = REQUIRED]; // Specifies which parts of the Service Config should be returned in the // response. @@ -328,14 +372,15 @@ message GetServiceConfigRequest { // Request message for ListServiceConfigs method. message ListServiceConfigsRequest { - // The name of the service. See the [overview](/service-management/overview) + // Required. The name of the service. See the [overview](/service-management/overview) // for naming requirements. For example: `example.googleapis.com`. - string service_name = 1; + string service_name = 1 [(google.api.field_behavior) = REQUIRED]; // The token of the page to retrieve. string page_token = 2; - // The max number of items to include in the response list. + // The max number of items to include in the response list. Page size is 50 + // if not specified. Maximum value is 100. int32 page_size = 3; } @@ -350,27 +395,27 @@ message ListServiceConfigsResponse { // Request message for CreateServiceConfig method. message CreateServiceConfigRequest { - // The name of the service. See the [overview](/service-management/overview) + // Required. The name of the service. See the [overview](/service-management/overview) // for naming requirements. For example: `example.googleapis.com`. - string service_name = 1; + string service_name = 1 [(google.api.field_behavior) = REQUIRED]; - // The service configuration resource. - google.api.Service service_config = 2; + // Required. The service configuration resource. + google.api.Service service_config = 2 [(google.api.field_behavior) = REQUIRED]; } // Request message for SubmitConfigSource method. message SubmitConfigSourceRequest { - // The name of the service. See the [overview](/service-management/overview) + // Required. The name of the service. See the [overview](/service-management/overview) // for naming requirements. For example: `example.googleapis.com`. - string service_name = 1; + string service_name = 1 [(google.api.field_behavior) = REQUIRED]; - // The source configuration for the service. - ConfigSource config_source = 2; + // Required. The source configuration for the service. + ConfigSource config_source = 2 [(google.api.field_behavior) = REQUIRED]; // Optional. If set, this will result in the generation of a // `google.api.Service` configuration based on the `ConfigSource` provided, // but the generated config and the sources will NOT be persisted. - bool validate_only = 3; + bool validate_only = 3 [(google.api.field_behavior) = OPTIONAL]; } // Response message for SubmitConfigSource method. @@ -381,27 +426,28 @@ message SubmitConfigSourceResponse { // Request message for 'CreateServiceRollout' message CreateServiceRolloutRequest { - // The name of the service. See the [overview](/service-management/overview) + // Required. The name of the service. See the [overview](/service-management/overview) // for naming requirements. For example: `example.googleapis.com`. - string service_name = 1; + string service_name = 1 [(google.api.field_behavior) = REQUIRED]; - // The rollout resource. The `service_name` field is output only. - Rollout rollout = 2; + // Required. The rollout resource. The `service_name` field is output only. + Rollout rollout = 2 [(google.api.field_behavior) = REQUIRED]; } // Request message for 'ListServiceRollouts' message ListServiceRolloutsRequest { - // The name of the service. See the [overview](/service-management/overview) + // Required. The name of the service. See the [overview](/service-management/overview) // for naming requirements. For example: `example.googleapis.com`. - string service_name = 1; + string service_name = 1 [(google.api.field_behavior) = REQUIRED]; // The token of the page to retrieve. string page_token = 2; - // The max number of items to include in the response list. + // The max number of items to include in the response list. Page size is 50 + // if not specified. Maximum value is 100. int32 page_size = 3; - // Use `filter` to return subset of rollouts. + // Required. Use `filter` to return subset of rollouts. // The following filters are supported: // -- To limit the results to only those in // [status](google.api.servicemanagement.v1.RolloutStatus) 'SUCCESS', @@ -409,7 +455,7 @@ message ListServiceRolloutsRequest { // -- To limit the results to those in // [status](google.api.servicemanagement.v1.RolloutStatus) 'CANCELLED' // or 'FAILED', use filter='status=CANCELLED OR status=FAILED' - string filter = 4; + string filter = 4 [(google.api.field_behavior) = REQUIRED]; } // Response message for ListServiceRollouts method. @@ -423,21 +469,21 @@ message ListServiceRolloutsResponse { // Request message for GetServiceRollout method. message GetServiceRolloutRequest { - // The name of the service. See the [overview](/service-management/overview) + // Required. The name of the service. See the [overview](/service-management/overview) // for naming requirements. For example: `example.googleapis.com`. - string service_name = 1; + string service_name = 1 [(google.api.field_behavior) = REQUIRED]; - // The id of the rollout resource. - string rollout_id = 2; + // Required. The id of the rollout resource. + string rollout_id = 2 [(google.api.field_behavior) = REQUIRED]; } // Request message for EnableService method. message EnableServiceRequest { - // Name of the service to enable. Specifying an unknown service name will + // Required. Name of the service to enable. Specifying an unknown service name will // cause the request to fail. - string service_name = 1; + string service_name = 1 [(google.api.field_behavior) = REQUIRED]; - // The identity of consumer resource which service enablement will be + // Required. The identity of consumer resource which service enablement will be // applied to. // // The Google Service Management implementation accepts the following @@ -446,16 +492,21 @@ message EnableServiceRequest { // // Note: this is made compatible with // google.api.servicecontrol.v1.Operation.consumer_id. - string consumer_id = 2; + string consumer_id = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// Operation payload for EnableService method. +message EnableServiceResponse { + } // Request message for DisableService method. message DisableServiceRequest { - // Name of the service to disable. Specifying an unknown service name + // Required. Name of the service to disable. Specifying an unknown service name // will cause the request to fail. - string service_name = 1; + string service_name = 1 [(google.api.field_behavior) = REQUIRED]; - // The identity of consumer resource which service disablement will be + // Required. The identity of consumer resource which service disablement will be // applied to. // // The Google Service Management implementation accepts the following @@ -464,24 +515,29 @@ message DisableServiceRequest { // // Note: this is made compatible with // google.api.servicecontrol.v1.Operation.consumer_id. - string consumer_id = 2; + string consumer_id = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// Operation payload for DisableService method. +message DisableServiceResponse { + } // Request message for GenerateConfigReport method. message GenerateConfigReportRequest { - // Service configuration for which we want to generate the report. + // Required. Service configuration for which we want to generate the report. // For this version of API, the supported types are // [google.api.servicemanagement.v1.ConfigRef][google.api.servicemanagement.v1.ConfigRef], // [google.api.servicemanagement.v1.ConfigSource][google.api.servicemanagement.v1.ConfigSource], // and [google.api.Service][google.api.Service] - google.protobuf.Any new_config = 1; + google.protobuf.Any new_config = 1 [(google.api.field_behavior) = REQUIRED]; - // Service configuration against which the comparison will be done. + // Optional. Service configuration against which the comparison will be done. // For this version of API, the supported types are // [google.api.servicemanagement.v1.ConfigRef][google.api.servicemanagement.v1.ConfigRef], // [google.api.servicemanagement.v1.ConfigSource][google.api.servicemanagement.v1.ConfigSource], // and [google.api.Service][google.api.Service] - google.protobuf.Any old_config = 2; + google.protobuf.Any old_config = 2 [(google.api.field_behavior) = OPTIONAL]; } // Response message for GenerateConfigReport method. diff --git a/third_party/googleapis/google/artman_core.yaml b/third_party/googleapis/google/artman_core.yaml index 1ae4967ae..3cdd232ea 100644 --- a/third_party/googleapis/google/artman_core.yaml +++ b/third_party/googleapis/google/artman_core.yaml @@ -4,6 +4,7 @@ common: src_proto_paths: - api - cloud/audit + - geo/type - logging/type - longrunning - rpc diff --git a/third_party/googleapis/google/bigtable/BUILD.bazel b/third_party/googleapis/google/bigtable/BUILD.bazel index 1e5b8c2af..a87c57fec 100644 --- a/third_party/googleapis/google/bigtable/BUILD.bazel +++ b/third_party/googleapis/google/bigtable/BUILD.bazel @@ -1 +1 @@ -exports_files(glob(["*.yaml"])) \ No newline at end of file +exports_files(glob(["*.yaml"])) diff --git a/third_party/googleapis/google/bigtable/admin/BUILD.bazel b/third_party/googleapis/google/bigtable/admin/BUILD.bazel index 1e5b8c2af..a87c57fec 100644 --- a/third_party/googleapis/google/bigtable/admin/BUILD.bazel +++ b/third_party/googleapis/google/bigtable/admin/BUILD.bazel @@ -1 +1 @@ -exports_files(glob(["*.yaml"])) \ No newline at end of file +exports_files(glob(["*.yaml"])) diff --git a/third_party/googleapis/google/bigtable/admin/artman_bigtableadmin.legacy.yaml b/third_party/googleapis/google/bigtable/admin/artman_bigtableadmin.legacy.yaml new file mode 100644 index 000000000..4f6edfec6 --- /dev/null +++ b/third_party/googleapis/google/bigtable/admin/artman_bigtableadmin.legacy.yaml @@ -0,0 +1,19 @@ +common: + api_name: bigtable-admin + api_version: v2 + organization_name: google-cloud + service_yaml: v2/bigtableadmin_v2.yaml + gapic_yaml: v2/bigtableadmin_gapic.legacy.yaml + src_proto_paths: + - v2 + proto_deps: + - name: google-common-protos + - name: google-iam-v1 + proto_path: google/iam/v1 + test_proto_deps: + - name: google-iam-v1 + proto_path: google/iam/v1 +artifacts: +- name: ruby_gapic + type: GAPIC + language: RUBY diff --git a/third_party/googleapis/google/bigtable/admin/artman_bigtableadmin.yaml b/third_party/googleapis/google/bigtable/admin/artman_bigtableadmin.yaml index abb1304d8..0c6ec1d6d 100644 --- a/third_party/googleapis/google/bigtable/admin/artman_bigtableadmin.yaml +++ b/third_party/googleapis/google/bigtable/admin/artman_bigtableadmin.yaml @@ -2,7 +2,7 @@ common: api_name: bigtable-admin api_version: v2 organization_name: google-cloud - service_yaml: bigtableadmin.yaml + service_yaml: v2/bigtableadmin_v2.yaml gapic_yaml: v2/bigtableadmin_gapic.yaml src_proto_paths: - v2 @@ -23,9 +23,6 @@ artifacts: - name: php_gapic type: GAPIC language: PHP -- name: ruby_gapic - type: GAPIC - language: RUBY - name: go_gapic type: GAPIC language: GO @@ -35,5 +32,3 @@ artifacts: - name: nodejs_gapic type: GAPIC language: NODEJS -- name: gapic_config - type: GAPIC_CONFIG diff --git a/third_party/googleapis/google/bigtable/admin/cluster/bigtableclusteradmin.yaml b/third_party/googleapis/google/bigtable/admin/cluster/bigtableclusteradmin.yaml index be789aa70..ca8f73b9a 100644 --- a/third_party/googleapis/google/bigtable/admin/cluster/bigtableclusteradmin.yaml +++ b/third_party/googleapis/google/bigtable/admin/cluster/bigtableclusteradmin.yaml @@ -1,5 +1,5 @@ type: google.api.Service -config_version: 0 +config_version: 1 name: bigtableclusteradmin.googleapis.com title: Google Cloud Bigtable Cluster Admin API diff --git a/third_party/googleapis/google/bigtable/admin/table/bigtabletableadmin.yaml b/third_party/googleapis/google/bigtable/admin/table/bigtabletableadmin.yaml index e1b7886b4..a3411efa2 100644 --- a/third_party/googleapis/google/bigtable/admin/table/bigtabletableadmin.yaml +++ b/third_party/googleapis/google/bigtable/admin/table/bigtabletableadmin.yaml @@ -1,5 +1,5 @@ type: google.api.Service -config_version: 0 +config_version: 1 name: bigtabletableadmin.googleapis.com title: Google Cloud Bigtable Table Admin API diff --git a/third_party/googleapis/google/bigtable/admin/v2/BUILD.bazel b/third_party/googleapis/google/bigtable/admin/v2/BUILD.bazel index 03cfa6018..726ea842b 100644 --- a/third_party/googleapis/google/bigtable/admin/v2/BUILD.bazel +++ b/third_party/googleapis/google/bigtable/admin/v2/BUILD.bazel @@ -1,13 +1,16 @@ +# This file was automatically generated by BuildFileGenerator + # This is an API workspace, having public visibility by default makes perfect sense. package(default_visibility = ["//visibility:public"]) ############################################################################## # Common ############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") proto_library( - name = "bigtableadmin_proto", + name = "admin_proto", srcs = [ "bigtable_instance_admin.proto", "bigtable_table_admin.proto", @@ -17,6 +20,9 @@ proto_library( ], deps = [ "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", "//google/iam/v1:iam_policy_proto", "//google/iam/v1:policy_proto", "//google/longrunning:operations_proto", @@ -28,8 +34,11 @@ proto_library( ) proto_library_with_info( - name = "bigtableadmin_proto_with_info", - deps = [":bigtableadmin_proto"], + name = "admin_proto_with_info", + deps = [ + ":admin_proto", + "//google/cloud:common_resources_proto", + ], ) ############################################################################## @@ -37,71 +46,58 @@ proto_library_with_info( ############################################################################## load( "@com_google_googleapis_imports//:imports.bzl", - "java_grpc_library", - "java_gapic_library", "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", "java_proto_library", - "java_resource_name_proto_library", - "java_test", ) -_JAVA_GRPC_DEPS = [ - "@com_google_api_grpc_proto_google_common_protos//jar", - "@com_google_api_grpc_proto_google_iam_v1//jar", -] - java_proto_library( - name = "bigtableadmin_java_proto", - deps = [":bigtableadmin_proto"], + name = "admin_java_proto", + deps = [":admin_proto"], ) java_grpc_library( - name = "bigtableadmin_java_grpc", - srcs = [":bigtableadmin_proto"], - deps = [":bigtableadmin_java_proto"] + _JAVA_GRPC_DEPS, -) - -java_resource_name_proto_library( - name = "bigtableadmin_resource_name_java_proto", - gapic_yaml = "bigtableadmin_gapic.yaml", - deps = [":bigtableadmin_proto"], + name = "admin_java_grpc", + srcs = [":admin_proto"], + deps = [":admin_java_proto"], ) java_gapic_library( - name = "bigtableadmin_java_gapic", - src = ":bigtableadmin_proto_with_info", + name = "admin_java_gapic", + src = ":admin_proto_with_info", gapic_yaml = "bigtableadmin_gapic.yaml", - service_yaml = "//google/bigtable/admin:bigtableadmin.yaml", - test_deps = [":bigtableadmin_java_grpc"], + package = "google.bigtable.admin.v2", + service_yaml = "bigtableadmin_v2.yaml", + test_deps = [ + ":admin_java_grpc", + "//google/iam/v1:iam_java_grpc", + ], deps = [ - ":bigtableadmin_java_proto", - ":bigtableadmin_resource_name_java_proto", - ] + _JAVA_GRPC_DEPS, + ":admin_java_proto", + "//google/iam/v1:iam_java_proto", + ], ) -[java_test( - name = test_name, - test_class = test_name, - runtime_deps = [":bigtableadmin_java_gapic_test"], -) for test_name in [ - "com.google.cloud.bigtable.admin.v2.BaseBigtableInstanceAdminClientTest", - "com.google.cloud.bigtable.admin.v2.BaseBigtableTableAdminClientTest", -]] +java_gapic_test( + name = "admin_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.bigtable.admin.v2.BaseBigtableInstanceAdminClientTest", + "com.google.cloud.bigtable.admin.v2.BaseBigtableTableAdminClientTest", + ], + runtime_deps = [":admin_java_gapic_test"], +) -# Opensource Packages +# Open Source Packages java_gapic_assembly_gradle_pkg( name = "google-cloud-bigtable-admin-v2-java", - client_deps = [":bigtableadmin_java_gapic"], - client_group = "com.google.cloud", - client_test_deps = [":bigtableadmin_java_gapic_test"], - grpc_deps = [":bigtableadmin_java_grpc"], - grpc_group = "com.google.api.grpc", - proto_deps = [ - ":bigtableadmin_proto", - ":bigtableadmin_java_proto", - ":bigtableadmin_resource_name_java_proto", - ] + _JAVA_GRPC_DEPS, - version = "0.0.0-SNAPSHOT", + deps = [ + ":admin_java_gapic", + ":admin_java_grpc", + ":admin_java_proto", + ":admin_proto", + ], ) ############################################################################## @@ -109,17 +105,17 @@ java_gapic_assembly_gradle_pkg( ############################################################################## load( "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", "go_proto_library", "go_test", - "go_gapic_library", - "go_gapic_assembly_pkg", ) go_proto_library( - name = "bigtableadmin_go_proto", + name = "admin_go_proto", compilers = ["@io_bazel_rules_go//proto:go_grpc"], importpath = "google.golang.org/genproto/googleapis/bigtable/admin/v2", - protos = [":bigtableadmin_proto"], + protos = [":admin_proto"], deps = [ "//google/api:annotations_go_proto", "//google/iam/v1:iam_go_proto", @@ -128,34 +124,280 @@ go_proto_library( ) go_gapic_library( - name = "bigtableadmin_go_gapic", - src = ":bigtableadmin_proto_with_info", - gapic_yaml = "bigtableadmin_gapic.yaml", - importpath = "cloud.google.com/go/bigtable/admin/apiv2", - service_yaml = "//google/bigtable/admin:bigtableadmin.yaml", + name = "admin_go_gapic", + srcs = [":admin_proto_with_info"], + grpc_service_config = "bigtableadmin_grpc_service_config.json", + importpath = "cloud.google.com/go/bigtable/admin/apiv2;admin", + service_yaml = "bigtableadmin_v2.yaml", deps = [ - ":bigtableadmin_go_proto", + ":admin_go_proto", "//google/iam/v1:iam_go_proto", "//google/longrunning:longrunning_go_gapic", "//google/longrunning:longrunning_go_proto", "@com_google_cloud_go//longrunning:go_default_library", + "@com_google_cloud_go//longrunning/autogen:go_default_library", + "@io_bazel_rules_go//proto/wkt:duration_go_proto", ], ) go_test( - name = "bigtableadmin_go_gapic_test", - srcs = [":bigtableadmin_go_gapic_srcjar_test"], - embed = [":bigtableadmin_go_gapic"], + name = "admin_go_gapic_test", + srcs = [":admin_go_gapic_srcjar_test"], + embed = [":admin_go_gapic"], importpath = "cloud.google.com/go/bigtable/admin/apiv2", ) -# Opensource Packages +# Open Source Packages go_gapic_assembly_pkg( - name = "gapi-cloud-bigtableadmin-v2-go", + name = "gapi-cloud-bigtable-admin-v2-go", + deps = [ + ":admin_go_gapic", + ":admin_go_gapic_srcjar-test.srcjar", + ":admin_go_proto", + ], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "admin_moved_proto", + srcs = [":admin_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/iam/v1:iam_policy_proto", + "//google/iam/v1:policy_proto", + "//google/longrunning:operations_proto", + "@com_google_protobuf//:duration_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +py_proto_library( + name = "admin_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":admin_moved_proto"], +) + +py_grpc_library( + name = "admin_py_grpc", + srcs = [":admin_moved_proto"], + deps = [":admin_py_proto"], +) + +py_gapic_library( + name = "admin_py_gapic", + src = ":admin_proto_with_info", + gapic_yaml = "bigtableadmin_gapic.yaml", + package = "google.bigtable.admin.v2", + service_yaml = "bigtableadmin_v2.yaml", + deps = [ + ":admin_py_grpc", + ":admin_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "bigtable-admin-v2-py", + deps = [ + ":admin_py_gapic", + ":admin_py_grpc", + ":admin_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "admin_php_proto", + deps = [":admin_proto"], +) + +php_grpc_library( + name = "admin_php_grpc", + srcs = [":admin_proto"], + deps = [":admin_php_proto"], +) + +php_gapic_library( + name = "admin_php_gapic", + src = ":admin_proto_with_info", + gapic_yaml = "bigtableadmin_gapic.legacy.yaml", + package = "google.bigtable.admin.v2", + service_yaml = "bigtableadmin_v2.yaml", + deps = [ + ":admin_php_grpc", + ":admin_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-bigtable-admin-v2-php", + deps = [ + ":admin_php_gapic", + ":admin_php_grpc", + ":admin_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "admin_nodejs_gapic", + src = ":admin_proto_with_info", + gapic_yaml = "bigtableadmin_gapic.yaml", + package = "google.bigtable.admin.v2", + service_yaml = "bigtableadmin_v2.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "bigtable-admin-v2-nodejs", + deps = [ + ":admin_nodejs_gapic", + ":admin_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "admin_ruby_proto", + deps = [":admin_proto"], +) + +ruby_grpc_library( + name = "admin_ruby_grpc", + srcs = [":admin_proto"], + deps = [":admin_ruby_proto"], +) + +ruby_gapic_library( + name = "admin_ruby_gapic", + src = ":admin_proto_with_info", + gapic_yaml = "bigtableadmin_gapic.yaml", + package = "google.bigtable.admin.v2", + service_yaml = "bigtableadmin_v2.yaml", + deps = [ + ":admin_ruby_grpc", + ":admin_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-bigtable-admin-v2-ruby", deps = [ - ":bigtableadmin_go_gapic", - ":bigtableadmin_go_gapic_srcjar-smoke-test.srcjar", - ":bigtableadmin_go_gapic_srcjar-test.srcjar", - ":bigtableadmin_go_proto", + ":admin_ruby_gapic", + ":admin_ruby_grpc", + ":admin_ruby_proto", ], ) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "admin_csharp_proto", + deps = [":admin_proto"], +) + +csharp_grpc_library( + name = "admin_csharp_grpc", + srcs = [":admin_proto"], + deps = [":admin_csharp_proto"], +) + +csharp_gapic_library( + name = "admin_csharp_gapic", + src = ":admin_proto_with_info", + gapic_yaml = "bigtableadmin_gapic.yaml", + package = "google.bigtable.admin.v2", + service_yaml = "bigtableadmin_v2.yaml", + deps = [ + ":admin_csharp_grpc", + ":admin_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-bigtable-admin-v2-csharp", + deps = [ + ":admin_csharp_gapic", + ":admin_csharp_grpc", + ":admin_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# +# PLEASE DO NOT DELETE +# These rules are not auto-generated, but they are used by OSS C++ projects. +load( + "@com_google_googleapis_imports//:imports.bzl", + "cc_grpc_library", + "cc_proto_library") + +cc_proto_library( + name = "admin_cc_proto", + deps = [":admin_proto"], +) + +cc_grpc_library( + name = "admin_cc_grpc", + srcs = [":admin_proto"], + grpc_only = True, + deps = [":admin_cc_proto"], +) diff --git a/third_party/googleapis/google/bigtable/admin/v2/bigtable_instance_admin.proto b/third_party/googleapis/google/bigtable/admin/v2/bigtable_instance_admin.proto index 80ce42470..8e05bfd0f 100644 --- a/third_party/googleapis/google/bigtable/admin/v2/bigtable_instance_admin.proto +++ b/third_party/googleapis/google/bigtable/admin/v2/bigtable_instance_admin.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google LLC. +// Copyright 2019 Google LLC. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -18,6 +18,9 @@ syntax = "proto3"; package google.bigtable.admin.v2; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/bigtable/admin/v2/instance.proto"; import "google/iam/v1/iam_policy.proto"; import "google/iam/v1/policy.proto"; @@ -37,13 +40,27 @@ option php_namespace = "Google\\Cloud\\Bigtable\\Admin\\V2"; // Clusters. Provides access to the Instance and Cluster schemas only, not the // tables' metadata or data stored in those tables. service BigtableInstanceAdmin { + option (google.api.default_host) = "bigtableadmin.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/bigtable.admin," + "https://www.googleapis.com/auth/bigtable.admin.cluster," + "https://www.googleapis.com/auth/bigtable.admin.instance," + "https://www.googleapis.com/auth/cloud-bigtable.admin," + "https://www.googleapis.com/auth/cloud-bigtable.admin.cluster," + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/cloud-platform.read-only"; + // Create an instance within a project. - rpc CreateInstance(CreateInstanceRequest) - returns (google.longrunning.Operation) { + rpc CreateInstance(CreateInstanceRequest) returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v2/{parent=projects/*}/instances" body: "*" }; + option (google.api.method_signature) = "parent,instance_id,instance,clusters"; + option (google.longrunning.operation_info) = { + response_type: "Instance" + metadata_type: "CreateInstanceMetadata" + }; } // Gets information about an instance. @@ -51,6 +68,7 @@ service BigtableInstanceAdmin { option (google.api.http) = { get: "/v2/{name=projects/*/instances/*}" }; + option (google.api.method_signature) = "name"; } // Lists information about instances in a project. @@ -58,9 +76,12 @@ service BigtableInstanceAdmin { option (google.api.http) = { get: "/v2/{parent=projects/*}/instances" }; + option (google.api.method_signature) = "parent"; } - // Updates an instance within a project. + // Updates an instance within a project. This method updates only the display + // name and type for an Instance. To update other Instance properties, such as + // labels, use PartialUpdateInstance. rpc UpdateInstance(Instance) returns (Instance) { option (google.api.http) = { put: "/v2/{name=projects/*/instances/*}" @@ -68,13 +89,18 @@ service BigtableInstanceAdmin { }; } - // Partially updates an instance within a project. - rpc PartialUpdateInstance(PartialUpdateInstanceRequest) - returns (google.longrunning.Operation) { + // Partially updates an instance within a project. This method can modify all + // fields of an Instance and is the preferred way to update an Instance. + rpc PartialUpdateInstance(PartialUpdateInstanceRequest) returns (google.longrunning.Operation) { option (google.api.http) = { patch: "/v2/{instance.name=projects/*/instances/*}" body: "instance" }; + option (google.api.method_signature) = "instance,update_mask"; + option (google.longrunning.operation_info) = { + response_type: "Instance" + metadata_type: "UpdateInstanceMetadata" + }; } // Delete an instance from a project. @@ -82,15 +108,20 @@ service BigtableInstanceAdmin { option (google.api.http) = { delete: "/v2/{name=projects/*/instances/*}" }; + option (google.api.method_signature) = "name"; } // Creates a cluster within an instance. - rpc CreateCluster(CreateClusterRequest) - returns (google.longrunning.Operation) { + rpc CreateCluster(CreateClusterRequest) returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v2/{parent=projects/*/instances/*}/clusters" body: "cluster" }; + option (google.api.method_signature) = "parent,cluster_id,cluster"; + option (google.longrunning.operation_info) = { + response_type: "Cluster" + metadata_type: "CreateClusterMetadata" + }; } // Gets information about a cluster. @@ -98,6 +129,7 @@ service BigtableInstanceAdmin { option (google.api.http) = { get: "/v2/{name=projects/*/instances/*/clusters/*}" }; + option (google.api.method_signature) = "name"; } // Lists information about clusters in an instance. @@ -105,6 +137,7 @@ service BigtableInstanceAdmin { option (google.api.http) = { get: "/v2/{parent=projects/*/instances/*}/clusters" }; + option (google.api.method_signature) = "parent"; } // Updates a cluster within an instance. @@ -113,6 +146,10 @@ service BigtableInstanceAdmin { put: "/v2/{name=projects/*/instances/*/clusters/*}" body: "*" }; + option (google.longrunning.operation_info) = { + response_type: "Cluster" + metadata_type: "UpdateClusterMetadata" + }; } // Deletes a cluster from an instance. @@ -120,6 +157,7 @@ service BigtableInstanceAdmin { option (google.api.http) = { delete: "/v2/{name=projects/*/instances/*/clusters/*}" }; + option (google.api.method_signature) = "name"; } // Creates an app profile within an instance. @@ -128,6 +166,7 @@ service BigtableInstanceAdmin { post: "/v2/{parent=projects/*/instances/*}/appProfiles" body: "app_profile" }; + option (google.api.method_signature) = "parent,app_profile_id,app_profile"; } // Gets information about an app profile. @@ -135,98 +174,118 @@ service BigtableInstanceAdmin { option (google.api.http) = { get: "/v2/{name=projects/*/instances/*/appProfiles/*}" }; + option (google.api.method_signature) = "name"; } // Lists information about app profiles in an instance. - rpc ListAppProfiles(ListAppProfilesRequest) - returns (ListAppProfilesResponse) { + rpc ListAppProfiles(ListAppProfilesRequest) returns (ListAppProfilesResponse) { option (google.api.http) = { get: "/v2/{parent=projects/*/instances/*}/appProfiles" }; + option (google.api.method_signature) = "parent"; } // Updates an app profile within an instance. - rpc UpdateAppProfile(UpdateAppProfileRequest) - returns (google.longrunning.Operation) { + rpc UpdateAppProfile(UpdateAppProfileRequest) returns (google.longrunning.Operation) { option (google.api.http) = { patch: "/v2/{app_profile.name=projects/*/instances/*/appProfiles/*}" body: "app_profile" }; + option (google.api.method_signature) = "app_profile,update_mask"; + option (google.longrunning.operation_info) = { + response_type: "AppProfile" + metadata_type: "UpdateAppProfileMetadata" + }; } // Deletes an app profile from an instance. - rpc DeleteAppProfile(DeleteAppProfileRequest) - returns (google.protobuf.Empty) { + rpc DeleteAppProfile(DeleteAppProfileRequest) returns (google.protobuf.Empty) { option (google.api.http) = { delete: "/v2/{name=projects/*/instances/*/appProfiles/*}" }; + option (google.api.method_signature) = "name"; } // Gets the access control policy for an instance resource. Returns an empty // policy if an instance exists but does not have a policy set. - rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) - returns (google.iam.v1.Policy) { + rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) returns (google.iam.v1.Policy) { option (google.api.http) = { post: "/v2/{resource=projects/*/instances/*}:getIamPolicy" body: "*" }; + option (google.api.method_signature) = "resource"; } // Sets the access control policy on an instance resource. Replaces any // existing policy. - rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) - returns (google.iam.v1.Policy) { + rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) returns (google.iam.v1.Policy) { option (google.api.http) = { post: "/v2/{resource=projects/*/instances/*}:setIamPolicy" body: "*" }; + option (google.api.method_signature) = "resource,policy"; } // Returns permissions that the caller has on the specified instance resource. - rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest) - returns (google.iam.v1.TestIamPermissionsResponse) { + rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest) returns (google.iam.v1.TestIamPermissionsResponse) { option (google.api.http) = { post: "/v2/{resource=projects/*/instances/*}:testIamPermissions" body: "*" }; + option (google.api.method_signature) = "resource,permissions"; } } // Request message for BigtableInstanceAdmin.CreateInstance. message CreateInstanceRequest { - // The unique name of the project in which to create the new instance. - // Values are of the form `projects/`. - string parent = 1; - - // The ID to be used when referring to the new instance within its project, + // Required. The unique name of the project in which to create the new instance. + // Values are of the form `projects/{project}`. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudresourcemanager.googleapis.com/Project" + } + ]; + + // Required. The ID to be used when referring to the new instance within its project, // e.g., just `myinstance` rather than // `projects/myproject/instances/myinstance`. - string instance_id = 2; + string instance_id = 2 [(google.api.field_behavior) = REQUIRED]; - // The instance to create. + // Required. The instance to create. // Fields marked `OutputOnly` must be left blank. - Instance instance = 3; + Instance instance = 3 [(google.api.field_behavior) = REQUIRED]; - // The clusters to be created within the instance, mapped by desired + // Required. The clusters to be created within the instance, mapped by desired // cluster ID, e.g., just `mycluster` rather than // `projects/myproject/instances/myinstance/clusters/mycluster`. // Fields marked `OutputOnly` must be left blank. - // Currently, at most two clusters can be specified. - map clusters = 4; + // Currently, at most four clusters can be specified. + map clusters = 4 [(google.api.field_behavior) = REQUIRED]; } // Request message for BigtableInstanceAdmin.GetInstance. message GetInstanceRequest { - // The unique name of the requested instance. Values are of the form - // `projects//instances/`. - string name = 1; + // Required. The unique name of the requested instance. Values are of the form + // `projects/{project}/instances/{instance}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/Instance" + } + ]; } // Request message for BigtableInstanceAdmin.ListInstances. message ListInstancesRequest { - // The unique name of the project for which a list of instances is requested. - // Values are of the form `projects/`. - string parent = 1; + // Required. The unique name of the project for which a list of instances is requested. + // Values are of the form `projects/{project}`. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudresourcemanager.googleapis.com/Project" + } + ]; // DEPRECATED: This field is unused and ignored. string page_token = 2; @@ -251,52 +310,72 @@ message ListInstancesResponse { // Request message for BigtableInstanceAdmin.PartialUpdateInstance. message PartialUpdateInstanceRequest { - // The Instance which will (partially) replace the current value. - Instance instance = 1; + // Required. The Instance which will (partially) replace the current value. + Instance instance = 1 [(google.api.field_behavior) = REQUIRED]; - // The subset of Instance fields which should be replaced. + // Required. The subset of Instance fields which should be replaced. // Must be explicitly set. - google.protobuf.FieldMask update_mask = 2; + google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED]; } // Request message for BigtableInstanceAdmin.DeleteInstance. message DeleteInstanceRequest { - // The unique name of the instance to be deleted. - // Values are of the form `projects//instances/`. - string name = 1; + // Required. The unique name of the instance to be deleted. + // Values are of the form `projects/{project}/instances/{instance}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/Instance" + } + ]; } // Request message for BigtableInstanceAdmin.CreateCluster. message CreateClusterRequest { - // The unique name of the instance in which to create the new cluster. + // Required. The unique name of the instance in which to create the new cluster. // Values are of the form - // `projects//instances/`. - string parent = 1; - - // The ID to be used when referring to the new cluster within its instance, + // `projects/{project}/instances/{instance}`. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/Instance" + } + ]; + + // Required. The ID to be used when referring to the new cluster within its instance, // e.g., just `mycluster` rather than // `projects/myproject/instances/myinstance/clusters/mycluster`. - string cluster_id = 2; + string cluster_id = 2 [(google.api.field_behavior) = REQUIRED]; - // The cluster to be created. + // Required. The cluster to be created. // Fields marked `OutputOnly` must be left blank. - Cluster cluster = 3; + Cluster cluster = 3 [(google.api.field_behavior) = REQUIRED]; } // Request message for BigtableInstanceAdmin.GetCluster. message GetClusterRequest { - // The unique name of the requested cluster. Values are of the form - // `projects//instances//clusters/`. - string name = 1; + // Required. The unique name of the requested cluster. Values are of the form + // `projects/{project}/instances/{instance}/clusters/{cluster}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/Cluster" + } + ]; } // Request message for BigtableInstanceAdmin.ListClusters. message ListClustersRequest { - // The unique name of the instance for which a list of clusters is requested. - // Values are of the form `projects//instances/`. - // Use ` = '-'` to list Clusters for all Instances in a project, + // Required. The unique name of the instance for which a list of clusters is requested. + // Values are of the form `projects/{project}/instances/{instance}`. + // Use `{instance} = '-'` to list Clusters for all Instances in a project, // e.g., `projects/myproject/instances/-`. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/Instance" + } + ]; // DEPRECATED: This field is unused and ignored. string page_token = 2; @@ -320,9 +399,14 @@ message ListClustersResponse { // Request message for BigtableInstanceAdmin.DeleteCluster. message DeleteClusterRequest { - // The unique name of the cluster to be deleted. Values are of the form - // `projects//instances//clusters/`. - string name = 1; + // Required. The unique name of the cluster to be deleted. Values are of the form + // `projects/{project}/instances/{instance}/clusters/{cluster}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/Cluster" + } + ]; } // The metadata for the Operation returned by CreateInstance. @@ -375,19 +459,24 @@ message UpdateClusterMetadata { // Request message for BigtableInstanceAdmin.CreateAppProfile. message CreateAppProfileRequest { - // The unique name of the instance in which to create the new app profile. + // Required. The unique name of the instance in which to create the new app profile. // Values are of the form - // `projects//instances/`. - string parent = 1; - - // The ID to be used when referring to the new app profile within its + // `projects/{project}/instances/{instance}`. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/Instance" + } + ]; + + // Required. The ID to be used when referring to the new app profile within its // instance, e.g., just `myprofile` rather than // `projects/myproject/instances/myinstance/appProfiles/myprofile`. - string app_profile_id = 2; + string app_profile_id = 2 [(google.api.field_behavior) = REQUIRED]; - // The app profile to be created. + // Required. The app profile to be created. // Fields marked `OutputOnly` will be ignored. - AppProfile app_profile = 3; + AppProfile app_profile = 3 [(google.api.field_behavior) = REQUIRED]; // If true, ignore safety checks when creating the app profile. bool ignore_warnings = 4; @@ -395,22 +484,39 @@ message CreateAppProfileRequest { // Request message for BigtableInstanceAdmin.GetAppProfile. message GetAppProfileRequest { - // The unique name of the requested app profile. Values are of the form - // `projects//instances//appProfiles/`. - string name = 1; + // Required. The unique name of the requested app profile. Values are of the form + // `projects/{project}/instances/{instance}/appProfiles/{app_profile}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/AppProfile" + } + ]; } // Request message for BigtableInstanceAdmin.ListAppProfiles. message ListAppProfilesRequest { - // The unique name of the instance for which a list of app profiles is + // Required. The unique name of the instance for which a list of app profiles is // requested. Values are of the form - // `projects//instances/`. - // Use ` = '-'` to list AppProfiles for all Instances in a project, + // `projects/{project}/instances/{instance}`. + // Use `{instance} = '-'` to list AppProfiles for all Instances in a project, // e.g., `projects/myproject/instances/-`. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/Instance" + } + ]; // Maximum number of results per page. - // CURRENTLY UNIMPLEMENTED AND IGNORED. + // + // A page_size of zero lets the server choose the number of items to return. + // A page_size which is strictly positive will return at most that many items. + // A negative page_size will cause an error. + // + // Following the first request, subsequent paginated calls are not required + // to pass a page_size. If a page_size is set in subsequent calls, it must + // match the page_size given in the first request. int32 page_size = 3; // The value of `next_page_token` returned by a previous call. @@ -436,12 +542,12 @@ message ListAppProfilesResponse { // Request message for BigtableInstanceAdmin.UpdateAppProfile. message UpdateAppProfileRequest { - // The app profile which will (partially) replace the current value. - AppProfile app_profile = 1; + // Required. The app profile which will (partially) replace the current value. + AppProfile app_profile = 1 [(google.api.field_behavior) = REQUIRED]; - // The subset of app profile fields which should be replaced. + // Required. The subset of app profile fields which should be replaced. // If unset, all fields will be replaced. - google.protobuf.FieldMask update_mask = 2; + google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED]; // If true, ignore safety checks when updating the app profile. bool ignore_warnings = 3; @@ -449,9 +555,14 @@ message UpdateAppProfileRequest { // Request message for BigtableInstanceAdmin.DeleteAppProfile. message DeleteAppProfileRequest { - // The unique name of the app profile to be deleted. Values are of the form - // `projects//instances//appProfiles/`. - string name = 1; + // Required. The unique name of the app profile to be deleted. Values are of the form + // `projects/{project}/instances/{instance}/appProfiles/{app_profile}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/AppProfile" + } + ]; // If true, ignore safety checks when deleting the app profile. bool ignore_warnings = 2; diff --git a/third_party/googleapis/google/bigtable/admin/v2/bigtable_table_admin.proto b/third_party/googleapis/google/bigtable/admin/v2/bigtable_table_admin.proto index 79c461e05..119ef73a4 100644 --- a/third_party/googleapis/google/bigtable/admin/v2/bigtable_table_admin.proto +++ b/third_party/googleapis/google/bigtable/admin/v2/bigtable_table_admin.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,17 +11,23 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.bigtable.admin.v2; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/bigtable/admin/v2/common.proto"; import "google/bigtable/admin/v2/table.proto"; +import "google/iam/v1/iam_policy.proto"; +import "google/iam/v1/policy.proto"; import "google/longrunning/operations.proto"; import "google/protobuf/duration.proto"; import "google/protobuf/empty.proto"; +import "google/protobuf/field_mask.proto"; import "google/protobuf/timestamp.proto"; option csharp_namespace = "Google.Cloud.Bigtable.Admin.V2"; @@ -37,6 +43,15 @@ option php_namespace = "Google\\Cloud\\Bigtable\\Admin\\V2"; // Provides access to the table schemas only, not the data stored within // the tables. service BigtableTableAdmin { + option (google.api.default_host) = "bigtableadmin.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/bigtable.admin," + "https://www.googleapis.com/auth/bigtable.admin.table," + "https://www.googleapis.com/auth/cloud-bigtable.admin," + "https://www.googleapis.com/auth/cloud-bigtable.admin.table," + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/cloud-platform.read-only"; + // Creates a new table in the specified instance. // The table can be created with a full set of initial column families, // specified in the request. @@ -45,6 +60,7 @@ service BigtableTableAdmin { post: "/v2/{parent=projects/*/instances/*}/tables" body: "*" }; + option (google.api.method_signature) = "parent,table_id,table"; } // Creates a new table from the specified snapshot. The target table must @@ -61,6 +77,11 @@ service BigtableTableAdmin { post: "/v2/{parent=projects/*/instances/*}/tables:createFromSnapshot" body: "*" }; + option (google.api.method_signature) = "parent,table_id,source_snapshot"; + option (google.longrunning.operation_info) = { + response_type: "Table" + metadata_type: "CreateTableFromSnapshotMetadata" + }; } // Lists all tables served from a specified instance. @@ -68,6 +89,7 @@ service BigtableTableAdmin { option (google.api.http) = { get: "/v2/{parent=projects/*/instances/*}/tables" }; + option (google.api.method_signature) = "parent"; } // Gets metadata information about the specified table. @@ -75,6 +97,7 @@ service BigtableTableAdmin { option (google.api.http) = { get: "/v2/{name=projects/*/instances/*/tables/*}" }; + option (google.api.method_signature) = "name"; } // Permanently deletes a specified table and all of its data. @@ -82,6 +105,7 @@ service BigtableTableAdmin { option (google.api.http) = { delete: "/v2/{name=projects/*/instances/*/tables/*}" }; + option (google.api.method_signature) = "name"; } // Performs a series of column family modifications on the specified table. @@ -93,6 +117,7 @@ service BigtableTableAdmin { post: "/v2/{name=projects/*/instances/*/tables/*}:modifyColumnFamilies" body: "*" }; + option (google.api.method_signature) = "name,modifications"; } // Permanently drop/delete a row range from a specified table. The request can @@ -115,6 +140,7 @@ service BigtableTableAdmin { post: "/v2/{name=projects/*/instances/*/tables/*}:generateConsistencyToken" body: "*" }; + option (google.api.method_signature) = "name"; } // Checks replication consistency based on a consistency token, that is, if @@ -126,6 +152,7 @@ service BigtableTableAdmin { post: "/v2/{name=projects/*/instances/*/tables/*}:checkConsistency" body: "*" }; + option (google.api.method_signature) = "name,consistency_token"; } // Creates a new snapshot in the specified cluster from the specified @@ -142,6 +169,12 @@ service BigtableTableAdmin { post: "/v2/{name=projects/*/instances/*/tables/*}:snapshot" body: "*" }; + option (google.api.method_signature) = + "name,cluster,snapshot_id,description"; + option (google.longrunning.operation_info) = { + response_type: "Snapshot" + metadata_type: "SnapshotTableMetadata" + }; } // Gets metadata information about the specified snapshot. @@ -155,6 +188,7 @@ service BigtableTableAdmin { option (google.api.http) = { get: "/v2/{name=projects/*/instances/*/clusters/*/snapshots/*}" }; + option (google.api.method_signature) = "name"; } // Lists all snapshots associated with the specified cluster. @@ -168,6 +202,7 @@ service BigtableTableAdmin { option (google.api.http) = { get: "/v2/{parent=projects/*/instances/*/clusters/*}/snapshots" }; + option (google.api.method_signature) = "parent"; } // Permanently deletes the specified snapshot. @@ -181,6 +216,121 @@ service BigtableTableAdmin { option (google.api.http) = { delete: "/v2/{name=projects/*/instances/*/clusters/*/snapshots/*}" }; + option (google.api.method_signature) = "name"; + } + + // Starts creating a new Cloud Bigtable Backup. The returned backup + // [long-running operation][google.longrunning.Operation] can be used to + // track creation of the backup. The + // [metadata][google.longrunning.Operation.metadata] field type is + // [CreateBackupMetadata][google.bigtable.admin.v2.CreateBackupMetadata]. The + // [response][google.longrunning.Operation.response] field type is + // [Backup][google.bigtable.admin.v2.Backup], if successful. Cancelling the + // returned operation will stop the creation and delete the backup. + rpc CreateBackup(CreateBackupRequest) returns (google.longrunning.Operation) { + option (google.api.http) = { + post: "/v2/{parent=projects/*/instances/*/clusters/*}/backups" + body: "backup" + }; + option (google.longrunning.operation_info) = { + response_type: "Backup" + metadata_type: "CreateBackupMetadata" + }; + option (google.api.method_signature) = "parent,backup_id,backup"; + } + + // Gets metadata on a pending or completed Cloud Bigtable Backup. + rpc GetBackup(GetBackupRequest) returns (Backup) { + option (google.api.http) = { + get: "/v2/{name=projects/*/instances/*/clusters/*/backups/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Updates a pending or completed Cloud Bigtable Backup. + rpc UpdateBackup(UpdateBackupRequest) returns (Backup) { + option (google.api.http) = { + patch: "/v2/{backup.name=projects/*/instances/*/clusters/*/backups/*}" + body: "backup" + }; + option (google.api.method_signature) = "backup,update_mask"; + } + + // Deletes a pending or completed Cloud Bigtable backup. + rpc DeleteBackup(DeleteBackupRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v2/{name=projects/*/instances/*/clusters/*/backups/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Lists Cloud Bigtable backups. Returns both completed and pending + // backups. + rpc ListBackups(ListBackupsRequest) returns (ListBackupsResponse) { + option (google.api.http) = { + get: "/v2/{parent=projects/*/instances/*/clusters/*}/backups" + }; + option (google.api.method_signature) = "parent"; + } + + // Create a new table by restoring from a completed backup. The new table + // must be in the same instance as the instance containing the backup. The + // returned table [long-running operation][google.longrunning.Operation] can + // be used to track the progress of the operation, and to cancel it. The + // [metadata][google.longrunning.Operation.metadata] field type is + // [RestoreTableMetadata][google.bigtable.admin.RestoreTableMetadata]. The + // [response][google.longrunning.Operation.response] type is + // [Table][google.bigtable.admin.v2.Table], if successful. + rpc RestoreTable(RestoreTableRequest) returns (google.longrunning.Operation) { + option (google.api.http) = { + post: "/v2/{parent=projects/*/instances/*}/tables:restore" + body: "*" + }; + option (google.longrunning.operation_info) = { + response_type: "Table" + metadata_type: "RestoreTableMetadata" + }; + } + + // Gets the access control policy for a resource. + // Returns an empty policy if the resource exists but does not have a policy + // set. + rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) + returns (google.iam.v1.Policy) { + option (google.api.http) = { + post: "/v2/{resource=projects/*/instances/*/tables/*}:getIamPolicy" + body: "*" + }; + option (google.api.method_signature) = "resource"; + } + + // Sets the access control policy on a Table or Backup resource. + // Replaces any existing policy. + rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) + returns (google.iam.v1.Policy) { + option (google.api.http) = { + post: "/v2/{resource=projects/*/instances/*/tables/*}:setIamPolicy" + body: "*" + additional_bindings { + post: "/v2/{resource=projects/*/instances/*/clusters/*/backups/*}:setIamPolicy" + body: "*" + } + }; + option (google.api.method_signature) = "resource,policy"; + } + + // Returns permissions that the caller has on the specified table resource. + rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest) + returns (google.iam.v1.TestIamPermissionsResponse) { + option (google.api.http) = { + post: "/v2/{resource=projects/*/instances/*/tables/*}:testIamPermissions" + body: "*" + additional_bindings { + post: "/v2/{resource=projects/*/instances/*/clusters/*/backups/*}:testIamPermissions" + body: "*" + } + }; + option (google.api.method_signature) = "resource,permissions"; } } @@ -193,16 +343,22 @@ message CreateTableRequest { bytes key = 1; } - // The unique name of the instance in which to create the table. - // Values are of the form `projects//instances/`. - string parent = 1; + // Required. The unique name of the instance in which to create the table. + // Values are of the form `projects/{project}/instances/{instance}`. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/Instance" + } + ]; - // The name by which the new table should be referred to within the parent - // instance, e.g., `foobar` rather than `/tables/foobar`. - string table_id = 2; + // Required. The name by which the new table should be referred to within the + // parent instance, e.g., `foobar` rather than `{parent}/tables/foobar`. + // Maximum 50 characters. + string table_id = 2 [(google.api.field_behavior) = REQUIRED]; - // The Table to create. - Table table = 3; + // Required. The Table to create. + Table table = 3 [(google.api.field_behavior) = REQUIRED]; // The optional list of row keys that will be used to initially split the // table into several tablets (tablets are similar to HBase regions). @@ -231,28 +387,41 @@ message CreateTableRequest { // feature might be changed in backward-incompatible ways and is not recommended // for production use. It is not subject to any SLA or deprecation policy. message CreateTableFromSnapshotRequest { - // The unique name of the instance in which to create the table. - // Values are of the form `projects//instances/`. - string parent = 1; - - // The name by which the new table should be referred to within the parent - // instance, e.g., `foobar` rather than `/tables/foobar`. - string table_id = 2; - - // The unique name of the snapshot from which to restore the table. The - // snapshot and the table must be in the same instance. - // Values are of the form - // `projects//instances//clusters//snapshots/`. - string source_snapshot = 3; + // Required. The unique name of the instance in which to create the table. + // Values are of the form `projects/{project}/instances/{instance}`. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/Instance" + } + ]; + + // Required. The name by which the new table should be referred to within the + // parent instance, e.g., `foobar` rather than `{parent}/tables/foobar`. + string table_id = 2 [(google.api.field_behavior) = REQUIRED]; + + // Required. The unique name of the snapshot from which to restore the table. + // The snapshot and the table must be in the same instance. Values are of the + // form + // `projects/{project}/instances/{instance}/clusters/{cluster}/snapshots/{snapshot}`. + string source_snapshot = 3 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/Snapshot" + } + ]; } // Request message for // [google.bigtable.admin.v2.BigtableTableAdmin.DropRowRange][google.bigtable.admin.v2.BigtableTableAdmin.DropRowRange] message DropRowRangeRequest { - // The unique name of the table on which to drop a range of rows. + // Required. The unique name of the table on which to drop a range of rows. // Values are of the form - // `projects//instances//tables/`. - string name = 1; + // `projects/{project}/instances/{instance}/tables/{table}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { type: "bigtable.googleapis.com/Table" } + ]; // Delete all rows or by prefix. oneof target { @@ -268,16 +437,28 @@ message DropRowRangeRequest { // Request message for // [google.bigtable.admin.v2.BigtableTableAdmin.ListTables][google.bigtable.admin.v2.BigtableTableAdmin.ListTables] message ListTablesRequest { - // The unique name of the instance for which tables should be listed. - // Values are of the form `projects//instances/`. - string parent = 1; + // Required. The unique name of the instance for which tables should be + // listed. Values are of the form `projects/{project}/instances/{instance}`. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/Instance" + } + ]; // The view to be applied to the returned tables' fields. - // Defaults to `NAME_ONLY` if unspecified; no others are currently supported. + // Only NAME_ONLY view (default) and REPLICATION_VIEW are supported. Table.View view = 2; // Maximum number of results per page. - // CURRENTLY UNIMPLEMENTED AND IGNORED. + // + // A page_size of zero lets the server choose the number of items to return. + // A page_size which is strictly positive will return at most that many items. + // A negative page_size will cause an error. + // + // Following the first request, subsequent paginated calls are not required + // to pass a page_size. If a page_size is set in subsequent calls, it must + // match the page_size given in the first request. int32 page_size = 4; // The value of `next_page_token` returned by a previous call. @@ -299,10 +480,13 @@ message ListTablesResponse { // Request message for // [google.bigtable.admin.v2.BigtableTableAdmin.GetTable][google.bigtable.admin.v2.BigtableTableAdmin.GetTable] message GetTableRequest { - // The unique name of the requested table. + // Required. The unique name of the requested table. // Values are of the form - // `projects//instances//tables/
`. - string name = 1; + // `projects/{project}/instances/{instance}/tables/{table}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { type: "bigtable.googleapis.com/Table" } + ]; // The view to be applied to the returned table's fields. // Defaults to `SCHEMA_VIEW` if unspecified. @@ -312,10 +496,13 @@ message GetTableRequest { // Request message for // [google.bigtable.admin.v2.BigtableTableAdmin.DeleteTable][google.bigtable.admin.v2.BigtableTableAdmin.DeleteTable] message DeleteTableRequest { - // The unique name of the table to be deleted. + // Required. The unique name of the table to be deleted. // Values are of the form - // `projects//instances//tables/
`. - string name = 1; + // `projects/{project}/instances/{instance}/tables/{table}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { type: "bigtable.googleapis.com/Table" } + ]; } // Request message for @@ -342,25 +529,32 @@ message ModifyColumnFamiliesRequest { } } - // The unique name of the table whose families should be modified. + // Required. The unique name of the table whose families should be modified. // Values are of the form - // `projects//instances//tables/
`. - string name = 1; - - // Modifications to be atomically applied to the specified table's families. - // Entries are applied in order, meaning that earlier modifications can be - // masked by later ones (in the case of repeated updates to the same family, - // for example). - repeated Modification modifications = 2; + // `projects/{project}/instances/{instance}/tables/{table}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { type: "bigtable.googleapis.com/Table" } + ]; + + // Required. Modifications to be atomically applied to the specified table's + // families. Entries are applied in order, meaning that earlier modifications + // can be masked by later ones (in the case of repeated updates to the same + // family, for example). + repeated Modification modifications = 2 + [(google.api.field_behavior) = REQUIRED]; } // Request message for // [google.bigtable.admin.v2.BigtableTableAdmin.GenerateConsistencyToken][google.bigtable.admin.v2.BigtableTableAdmin.GenerateConsistencyToken] message GenerateConsistencyTokenRequest { - // The unique name of the Table for which to create a consistency token. - // Values are of the form - // `projects//instances//tables/
`. - string name = 1; + // Required. The unique name of the Table for which to create a consistency + // token. Values are of the form + // `projects/{project}/instances/{instance}/tables/{table}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { type: "bigtable.googleapis.com/Table" } + ]; } // Response message for @@ -373,13 +567,16 @@ message GenerateConsistencyTokenResponse { // Request message for // [google.bigtable.admin.v2.BigtableTableAdmin.CheckConsistency][google.bigtable.admin.v2.BigtableTableAdmin.CheckConsistency] message CheckConsistencyRequest { - // The unique name of the Table for which to check replication consistency. - // Values are of the form - // `projects//instances//tables/
`. - string name = 1; - - // The token created using GenerateConsistencyToken for the Table. - string consistency_token = 2; + // Required. The unique name of the Table for which to check replication + // consistency. Values are of the form + // `projects/{project}/instances/{instance}/tables/{table}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { type: "bigtable.googleapis.com/Table" } + ]; + + // Required. The token created using GenerateConsistencyToken for the Table. + string consistency_token = 2 [(google.api.field_behavior) = REQUIRED]; } // Response message for @@ -398,21 +595,29 @@ message CheckConsistencyResponse { // feature might be changed in backward-incompatible ways and is not recommended // for production use. It is not subject to any SLA or deprecation policy. message SnapshotTableRequest { - // The unique name of the table to have the snapshot taken. + // Required. The unique name of the table to have the snapshot taken. // Values are of the form - // `projects//instances//tables/
`. - string name = 1; + // `projects/{project}/instances/{instance}/tables/{table}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { type: "bigtable.googleapis.com/Table" } + ]; - // The name of the cluster where the snapshot will be created in. + // Required. The name of the cluster where the snapshot will be created in. // Values are of the form - // `projects//instances//clusters/`. - string cluster = 2; + // `projects/{project}/instances/{instance}/clusters/{cluster}`. + string cluster = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/Cluster" + } + ]; - // The ID by which the new snapshot should be referred to within the parent - // cluster, e.g., `mysnapshot` of the form: `[_a-zA-Z0-9][-_.a-zA-Z0-9]*` - // rather than - // `projects//instances//clusters//snapshots/mysnapshot`. - string snapshot_id = 3; + // Required. The ID by which the new snapshot should be referred to within the + // parent cluster, e.g., `mysnapshot` of the form: + // `[_a-zA-Z0-9][-_.a-zA-Z0-9]*` rather than + // `projects/{project}/instances/{instance}/clusters/{cluster}/snapshots/mysnapshot`. + string snapshot_id = 3 [(google.api.field_behavior) = REQUIRED]; // The amount of time that the new snapshot can stay active after it is // created. Once 'ttl' expires, the snapshot will get deleted. The maximum @@ -432,10 +637,15 @@ message SnapshotTableRequest { // feature might be changed in backward-incompatible ways and is not recommended // for production use. It is not subject to any SLA or deprecation policy. message GetSnapshotRequest { - // The unique name of the requested snapshot. + // Required. The unique name of the requested snapshot. // Values are of the form - // `projects//instances//clusters//snapshots/`. - string name = 1; + // `projects/{project}/instances/{instance}/clusters/{cluster}/snapshots/{snapshot}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/Snapshot" + } + ]; } // Request message for @@ -446,12 +656,17 @@ message GetSnapshotRequest { // feature might be changed in backward-incompatible ways and is not recommended // for production use. It is not subject to any SLA or deprecation policy. message ListSnapshotsRequest { - // The unique name of the cluster for which snapshots should be listed. - // Values are of the form - // `projects//instances//clusters/`. - // Use ` = '-'` to list snapshots for all clusters in an instance, - // e.g., `projects//instances//clusters/-`. - string parent = 1; + // Required. The unique name of the cluster for which snapshots should be + // listed. Values are of the form + // `projects/{project}/instances/{instance}/clusters/{cluster}`. + // Use `{cluster} = '-'` to list snapshots for all clusters in an instance, + // e.g., `projects/{project}/instances/{instance}/clusters/-`. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/Cluster" + } + ]; // The maximum number of snapshots to return per page. // CURRENTLY UNIMPLEMENTED AND IGNORED. @@ -486,10 +701,15 @@ message ListSnapshotsResponse { // feature might be changed in backward-incompatible ways and is not recommended // for production use. It is not subject to any SLA or deprecation policy. message DeleteSnapshotRequest { - // The unique name of the snapshot to be deleted. + // Required. The unique name of the snapshot to be deleted. // Values are of the form - // `projects//instances//clusters//snapshots/`. - string name = 1; + // `projects/{project}/instances/{instance}/clusters/{cluster}/snapshots/{snapshot}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/Snapshot" + } + ]; } // The metadata for the Operation returned by SnapshotTable. @@ -526,3 +746,248 @@ message CreateTableFromSnapshotMetadata { // The time at which the operation failed or was completed successfully. google.protobuf.Timestamp finish_time = 3; } + +// The request for +// [CreateBackup][google.bigtable.admin.v2.BigtableTableAdmin.CreateBackup]. +message CreateBackupRequest { + // Required. This must be one of the clusters in the instance in which this + // table is located. The backup will be stored in this cluster. Values are + // of the form `projects/{project}/instances/{instance}/clusters/{cluster}`. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/Cluster" + } + ]; + + // Required. The id of the backup to be created. The `backup_id` along with + // the parent `parent` are combined as {parent}/backups/{backup_id} to create + // the full backup name, of the form: + // `projects/{project}/instances/{instance}/clusters/{cluster}/backups/{backup_id}`. + // This string must be between 1 and 50 characters in length and match the + // regex [_a-zA-Z0-9][-_.a-zA-Z0-9]*. + string backup_id = 2 [(google.api.field_behavior) = REQUIRED]; + + // Required. The backup to create. + Backup backup = 3 [(google.api.field_behavior) = REQUIRED]; +} + +// Metadata type for the operation returned by +// [CreateBackup][google.bigtable.admin.v2.BigtableTableAdmin.CreateBackup]. +message CreateBackupMetadata { + // The name of the backup being created. + string name = 1; + + // The name of the table the backup is created from. + string source_table = 2; + + // The time at which this operation started. + google.protobuf.Timestamp start_time = 3; + + // If set, the time at which this operation finished or was cancelled. + google.protobuf.Timestamp end_time = 4; +} + +// The request for +// [GetBackup][google.bigtable.admin.v2.BigtableTableAdmin.GetBackup]. +message GetBackupRequest { + // Required. Name of the backup. + // Values are of the form + // `projects/{project}/instances/{instance}/clusters/{cluster}/backups/{backup}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { type: "bigtable.googleapis.com/Backup" } + ]; +} + +// The request for +// [UpdateBackup][google.bigtable.admin.v2.BigtableTableAdmin.UpdateBackup]. +message UpdateBackupRequest { + // Required. The backup to update. `backup.name`, and the fields to be updated + // as specified by `update_mask` are required. Other fields are ignored. + // Update is only supported for the following fields: + // * `backup.expire_time`. + Backup backup = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. A mask specifying which fields (e.g. `expire_time`) in the + // Backup resource should be updated. This mask is relative to the Backup + // resource, not to the request message. The field mask must always be + // specified; this prevents any future fields from being erased accidentally + // by clients that do not know about them. + google.protobuf.FieldMask update_mask = 2 + [(google.api.field_behavior) = REQUIRED]; +} + +// The request for +// [DeleteBackup][google.bigtable.admin.v2.BigtableTableAdmin.DeleteBackup]. +message DeleteBackupRequest { + // Required. Name of the backup to delete. + // Values are of the form + // `projects/{project}/instances/{instance}/clusters/{cluster}/backups/{backup}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { type: "bigtable.googleapis.com/Backup" } + ]; +} + +// The request for +// [ListBackups][google.bigtable.admin.v2.BigtableTableAdmin.ListBackups]. +message ListBackupsRequest { + // Required. The cluster to list backups from. Values are of the + // form `projects/{project}/instances/{instance}/clusters/{cluster}`. + // Use `{cluster} = '-'` to list backups for all clusters in an instance, + // e.g., `projects/{project}/instances/{instance}/clusters/-`. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/Cluster" + } + ]; + + // A filter expression that filters backups listed in the response. + // The expression must specify the field name, a comparison operator, + // and the value that you want to use for filtering. The value must be a + // string, a number, or a boolean. The comparison operator must be + // <, >, <=, >=, !=, =, or :. Colon ‘:’ represents a HAS operator which is + // roughly synonymous with equality. Filter rules are case insensitive. + // + // The fields eligible for filtering are: + // * `name` + // * `source_table` + // * `state` + // * `start_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ) + // * `end_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ) + // * `expire_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ) + // * `size_bytes` + // + // To filter on multiple expressions, provide each separate expression within + // parentheses. By default, each expression is an AND expression. However, + // you can include AND, OR, and NOT expressions explicitly. + // + // Some examples of using filters are: + // + // * `name:"exact"` --> The backup's name is the string "exact". + // * `name:howl` --> The backup's name contains the string "howl". + // * `source_table:prod` + // --> The source_table's name contains the string "prod". + // * `state:CREATING` --> The backup is pending creation. + // * `state:READY` --> The backup is fully created and ready for use. + // * `(name:howl) AND (start_time < \"2018-03-28T14:50:00Z\")` + // --> The backup name contains the string "howl" and start_time + // of the backup is before 2018-03-28T14:50:00Z. + // * `size_bytes > 10000000000` --> The backup's size is greater than 10GB + string filter = 2; + + // An expression for specifying the sort order of the results of the request. + // The string value should specify one or more fields in + // [Backup][google.bigtable.admin.v2.Backup]. The full syntax is described at + // https://aip.dev/132#ordering. + // + // Fields supported are: + // * name + // * source_table + // * expire_time + // * start_time + // * end_time + // * size_bytes + // * state + // + // For example, "start_time". The default sorting order is ascending. + // To specify descending order for the field, a suffix " desc" should + // be appended to the field name. For example, "start_time desc". + // Redundant space characters in the syntax are insigificant. + // + // If order_by is empty, results will be sorted by `start_time` in descending + // order starting from the most recently created backup. + string order_by = 3; + + // Number of backups to be returned in the response. If 0 or + // less, defaults to the server's maximum allowed page size. + int32 page_size = 4; + + // If non-empty, `page_token` should contain a + // [next_page_token][google.bigtable.admin.v2.ListBackupsResponse.next_page_token] + // from a previous + // [ListBackupsResponse][google.bigtable.admin.v2.ListBackupsResponse] to the + // same `parent` and with the same `filter`. + string page_token = 5; +} + +// The response for +// [ListBackups][google.bigtable.admin.v2.BigtableTableAdmin.ListBackups]. +message ListBackupsResponse { + // The list of matching backups. + repeated Backup backups = 1; + + // `next_page_token` can be sent in a subsequent + // [ListBackups][google.bigtable.admin.v2.BigtableTableAdmin.ListBackups] call + // to fetch more of the matching backups. + string next_page_token = 2; +} + +// The request for +// [RestoreTable][google.bigtable.admin.v2.BigtableTableAdmin.RestoreTable]. +message RestoreTableRequest { + // Required. The name of the instance in which to create the restored + // table. This instance must be the parent of the source backup. Values are + // of the form `projects//instances/`. + string parent = 1; + + // Required. The id of the table to create and restore to. This + // table must not already exist. The `table_id` appended to + // `parent` forms the full table name of the form + // `projects//instances//tables/`. + string table_id = 2; + + // Required. The source from which to restore. + oneof source { + // Name of the backup from which to restore. Values are of the form + // `projects//instances//clusters//backups/`. + string backup = 3; + } +} + +// Metadata type for the long-running operation returned by +// [RestoreTable][google.bigtable.admin.v2.BigtableTableAdmin.RestoreTable]. +message RestoreTableMetadata { + // Name of the table being created and restored to. + string name = 1; + + // The type of the restore source. + RestoreSourceType source_type = 2; + + // Information about the source used to restore the table, as specified by + // `source` in + // [RestoreTableRequest][google.bigtable.admin.v2.RestoreTableRequest]. + oneof source_info { + BackupInfo backup_info = 3; + } + + // If exists, the name of the long-running operation that will be used to + // track the post-restore optimization process to optimize the performance of + // the restored table. The metadata type of the long-running operation is + // [OptimizeRestoreTableMetadata][]. The response type is + // [Empty][google.protobuf.Empty]. This long-running operation may be + // automatically created by the system if applicable after the + // RestoreTable long-running operation completes successfully. This operation + // may not be created if the table is already optimized or the restore was + // not successful. + string optimize_table_operation_name = 4; + + // The progress of the + // [RestoreTable][google.bigtable.admin.v2.BigtableTableAdmin.RestoreTable] + // operation. + OperationProgress progress = 5; +} + +// Metadata type for the long-running operation used to track the progress +// of optimizations performed on a newly restored table. This long-running +// operation is automatically created by the system after the successful +// completion of a table restore, and cannot be cancelled. +message OptimizeRestoredTableMetadata { + // Name of the restored table being optimized. + string name = 1; + + // The progress of the post-restore optimizations. + OperationProgress progress = 2; +} diff --git a/third_party/googleapis/google/bigtable/admin/v2/bigtableadmin_gapic.legacy.yaml b/third_party/googleapis/google/bigtable/admin/v2/bigtableadmin_gapic.legacy.yaml new file mode 100644 index 000000000..80ea567b3 --- /dev/null +++ b/third_party/googleapis/google/bigtable/admin/v2/bigtableadmin_gapic.legacy.yaml @@ -0,0 +1,1029 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 1.0.0 +language_settings: + java: + package_name: com.google.cloud.bigtable.admin.v2 + interface_names: + google.bigtable.admin.v2.BigtableInstanceAdmin: BaseBigtableInstanceAdmin + google.bigtable.admin.v2.BigtableTableAdmin: BaseBigtableTableAdmin + python: + package_name: google.cloud.bigtable_admin_v2.gapic + go: + package_name: cloud.google.com/go/bigtable/admin/apiv2 + csharp: + package_name: Google.Cloud.Bigtable.Admin.V2 + ruby: + package_name: Google::Cloud::Bigtable::Admin::V2 + release_level: GA + php: + package_name: Google\Cloud\Bigtable\Admin\V2 + nodejs: + package_name: admin.v2 +interfaces: +- name: google.bigtable.admin.v2.BigtableInstanceAdmin + collections: + - name_pattern: projects/{project} + entity_name: project + language_overrides: + - language: csharp + common_resource_name: Google.Api.Gax.ResourceNames.ProjectName + - name_pattern: projects/{project}/instances/{instance} + entity_name: instance + - name_pattern: projects/{project}/instances/{instance}/appProfiles/{app_profile} + entity_name: app_profile + - name_pattern: projects/{project}/instances/{instance}/clusters/{cluster} + entity_name: cluster + - name_pattern: projects/{project}/locations/{location} + entity_name: location + retry_codes_def: + - name: idempotent + retry_codes: + - UNAVAILABLE + - DEADLINE_EXCEEDED + - name: non_idempotent + retry_codes: [] + retry_params_def: + - name: idempotent_params + initial_retry_delay_millis: 1000 + retry_delay_multiplier: 2 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 60000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 60000 + total_timeout_millis: 600000 + - name: non_idempotent_params + initial_retry_delay_millis: 0 + retry_delay_multiplier: 1 + max_retry_delay_millis: 0 + initial_rpc_timeout_millis: 60000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 60000 + total_timeout_millis: 60000 + - name: non_idempotent_heavy_params + initial_retry_delay_millis: 0 + retry_delay_multiplier: 1 + max_retry_delay_millis: 0 + initial_rpc_timeout_millis: 300000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 300000 + total_timeout_millis: 300000 + methods: + - name: CreateInstance + flattening: + groups: + - parameters: + - parent + - instance_id + - instance + - clusters + required_fields: + - parent + - instance_id + - instance + - clusters + retry_codes_name: non_idempotent + retry_params_name: non_idempotent_heavy_params + field_name_patterns: + parent: project + resource_name_treatment: STATIC_TYPES + timeout_millis: 300000 + long_running: + return_type: google.bigtable.admin.v2.Instance + metadata_type: google.bigtable.admin.v2.CreateInstanceMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 600000 + header_request_params: + - parent + - name: GetInstance + flattening: + groups: + - parameters: + - name + required_fields: + - name + resource_name_treatment: STATIC_TYPES + retry_codes_name: idempotent + retry_params_name: idempotent_params + field_name_patterns: + name: instance + timeout_millis: 60000 + header_request_params: + - name + - name: ListInstances + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + retry_codes_name: idempotent + retry_params_name: idempotent_params + field_name_patterns: + parent: project + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + header_request_params: + - parent + - name: UpdateInstance + required_fields: + - name + - display_name + - type + - labels + retry_codes_name: idempotent + retry_params_name: idempotent_params + field_name_patterns: + name: instance + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + # Should use PartialUpdateInstance instead + surface_treatments: + - include_languages: [java, csharp] + visibility: DISABLED + header_request_params: + - name + - name: PartialUpdateInstance + flattening: + groups: + - parameters: + - instance + - update_mask + required_fields: + - instance + - update_mask + retry_codes_name: idempotent + retry_params_name: idempotent_params + field_name_patterns: + instance.name: instance + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + long_running: + return_type: google.bigtable.admin.v2.Instance + metadata_type: google.bigtable.admin.v2.UpdateInstanceMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 600000 + header_request_params: + - instance.name + - name: DeleteInstance + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: non_idempotent + retry_params_name: non_idempotent_params + field_name_patterns: + name: instance + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + header_request_params: + - name + - name: CreateCluster + flattening: + groups: + - parameters: + - parent + - cluster_id + - cluster + required_fields: + - parent + - cluster_id + - cluster + retry_codes_name: non_idempotent + retry_params_name: non_idempotent_params + field_name_patterns: + parent: instance + resource_name_treatment: STATIC_TYPES + long_running: + return_type: google.bigtable.admin.v2.Cluster + metadata_type: google.bigtable.admin.v2.CreateClusterMetadata + initial_poll_delay_millis: 5000 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 60000 + total_poll_timeout_millis: 21600000 + timeout_millis: 60000 + header_request_params: + - parent + - name: GetCluster + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: idempotent_params + field_name_patterns: + name: cluster + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + header_request_params: + - name + - name: ListClusters + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + retry_codes_name: idempotent + retry_params_name: idempotent_params + field_name_patterns: + parent: instance + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + header_request_params: + - parent + - name: UpdateCluster + required_fields: + - name + - serve_nodes + retry_codes_name: idempotent + retry_params_name: idempotent_params + field_name_patterns: + name: cluster + resource_name_treatment: STATIC_TYPES + long_running: + return_type: google.bigtable.admin.v2.Cluster + metadata_type: google.bigtable.admin.v2.UpdateClusterMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 600000 + timeout_millis: 60000 + header_request_params: + - name + - name: DeleteCluster + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: non_idempotent + retry_params_name: non_idempotent_params + field_name_patterns: + name: cluster + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + header_request_params: + - name + - name: CreateAppProfile + flattening: + groups: + - parameters: + - parent + - app_profile_id + - app_profile + required_fields: + - parent + - app_profile_id + - app_profile + retry_codes_name: non_idempotent + retry_params_name: non_idempotent_params + field_name_patterns: + parent: instance + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + header_request_params: + - parent + - name: GetAppProfile + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: idempotent_params + field_name_patterns: + name: app_profile + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + header_request_params: + - name + - name: ListAppProfiles + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + token_field: page_token + response: + token_field: next_page_token + resources_field: app_profiles + retry_codes_name: idempotent + retry_params_name: idempotent_params + field_name_patterns: + parent: instance + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + header_request_params: + - parent + - name: UpdateAppProfile + flattening: + groups: + - parameters: + - app_profile + - update_mask + required_fields: + - app_profile + - update_mask + retry_codes_name: idempotent + retry_params_name: idempotent_params + field_name_patterns: + app_profile.name: app_profile + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + long_running: + return_type: google.bigtable.admin.v2.AppProfile + metadata_type: google.bigtable.admin.v2.UpdateAppProfileMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 600000 + header_request_params: + - app_profile.name + - name: DeleteAppProfile + flattening: + groups: + - parameters: + - name + required_fields: + - name + - ignore_warnings + retry_codes_name: non_idempotent + retry_params_name: non_idempotent_params + field_name_patterns: + name: app_profile + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + header_request_params: + - name + - name: GetIamPolicy + flattening: + groups: + - parameters: + - resource + required_fields: + - resource + retry_codes_name: idempotent + retry_params_name: idempotent_params + field_name_patterns: + resource: instance + timeout_millis: 60000 + header_request_params: + - resource + - name: SetIamPolicy + flattening: + groups: + - parameters: + - resource + - policy + required_fields: + - resource + - policy + retry_codes_name: non_idempotent + retry_params_name: non_idempotent_params + field_name_patterns: + resource: instance + timeout_millis: 60000 + header_request_params: + - resource + - name: TestIamPermissions + flattening: + groups: + - parameters: + - resource + - permissions + required_fields: + - resource + - permissions + retry_codes_name: idempotent + retry_params_name: idempotent_params + field_name_patterns: + resource: instance + timeout_millis: 60000 + header_request_params: + - resource +- name: google.bigtable.admin.v2.BigtableTableAdmin + collections: + - name_pattern: projects/{project}/instances/{instance} + entity_name: instance + - name_pattern: projects/{project}/instances/{instance}/clusters/{cluster} + entity_name: cluster + - name_pattern: projects/{project}/instances/{instance}/clusters/{cluster}/snapshots/{snapshot} + entity_name: snapshot + - name_pattern: projects/{project}/instances/{instance}/clusters/{cluster}/backups/{backup} + entity_name: backup + - name_pattern: projects/{project}/instances/{instance}/tables/{table} + entity_name: table + language_overrides: + - language: csharp + common_resource_name: Google.Cloud.Bigtable.Common.V2.TableName + retry_codes_def: + - name: idempotent + retry_codes: + - UNAVAILABLE + - DEADLINE_EXCEEDED + - name: non_idempotent + retry_codes: [] + retry_params_def: + - name: idempotent_params + initial_retry_delay_millis: 1000 + retry_delay_multiplier: 2 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 60000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 60000 + total_timeout_millis: 600000 + - name: non_idempotent_params + initial_retry_delay_millis: 0 + retry_delay_multiplier: 1 + max_retry_delay_millis: 0 + initial_rpc_timeout_millis: 60000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 60000 + total_timeout_millis: 60000 + - name: non_idempotent_heavy_params + initial_retry_delay_millis: 0 + retry_delay_multiplier: 1 + max_retry_delay_millis: 0 + initial_rpc_timeout_millis: 300000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 300000 + total_timeout_millis: 300000 + - name: drop_row_range_params + initial_retry_delay_millis: 0 + retry_delay_multiplier: 1 + max_retry_delay_millis: 0 + initial_rpc_timeout_millis: 3600000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 3600000 + total_timeout_millis: 3600000 + + methods: + - name: CreateTable + flattening: + groups: + - parameters: + - parent + - table_id + - table + required_fields: + - parent + - table_id + - table + retry_codes_name: non_idempotent + retry_params_name: non_idempotent_heavy_params + field_name_patterns: + parent: instance + resource_name_treatment: STATIC_TYPES + timeout_millis: 300000 + header_request_params: + - parent + - name: CreateTableFromSnapshot + flattening: + groups: + - parameters: + - parent + - table_id + - source_snapshot + required_fields: + - parent + - table_id + - source_snapshot + retry_codes_name: non_idempotent + retry_params_name: non_idempotent_params + field_name_patterns: + parent: instance + resource_name_treatment: STATIC_TYPES + long_running: + return_type: google.bigtable.admin.v2.Table + metadata_type: google.bigtable.admin.v2.CreateTableFromSnapshotMetadata + initial_poll_delay_millis: 5000 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 60000 + total_poll_timeout_millis: 3600000 + timeout_millis: 60000 + # Snapshots are Alpha-only and not supported in C# + surface_treatments: + - include_languages: [csharp] + visibility: DISABLED + header_request_params: + - parent + - name: ListTables + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + token_field: page_token + response: + token_field: next_page_token + resources_field: tables + retry_codes_name: idempotent + retry_params_name: idempotent_params + field_name_patterns: + parent: instance + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + header_request_params: + - parent + - name: GetTable + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: idempotent_params + field_name_patterns: + name: table + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + header_request_params: + - name + - name: DeleteTable + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: non_idempotent + retry_params_name: non_idempotent_params + field_name_patterns: + name: table + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + header_request_params: + - name + - name: ModifyColumnFamilies + flattening: + groups: + - parameters: + - name + - modifications + required_fields: + - name + - modifications + retry_codes_name: non_idempotent + retry_params_name: non_idempotent_heavy_params + field_name_patterns: + name: table + resource_name_treatment: STATIC_TYPES + timeout_millis: 300000 + header_request_params: + - name + - name: DropRowRange + required_fields: + - name + retry_codes_name: non_idempotent + retry_params_name: drop_row_range_params + field_name_patterns: + name: table + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + header_request_params: + - name + - name: GenerateConsistencyToken + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: idempotent_params + field_name_patterns: + name: table + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + header_request_params: + - name + - name: CheckConsistency + flattening: + groups: + - parameters: + - name + - consistency_token + required_fields: + - name + - consistency_token + retry_codes_name: idempotent + retry_params_name: idempotent_params + field_name_patterns: + name: table + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + header_request_params: + - name + - name: GetIamPolicy + flattening: + groups: + - parameters: + - resource + required_fields: + - resource + retry_codes_name: idempotent + retry_params_name: idempotent_params + field_name_patterns: + resource: table + timeout_millis: 60000 + header_request_params: + - resource + - name: SetIamPolicy + flattening: + groups: + - parameters: + - resource + - policy + required_fields: + - resource + - policy + retry_codes_name: non_idempotent + retry_params_name: non_idempotent_params + field_name_patterns: + resource: table + timeout_millis: 60000 + header_request_params: + - resource + - name: TestIamPermissions + flattening: + groups: + - parameters: + - resource + - permissions + required_fields: + - resource + - permissions + retry_codes_name: idempotent + retry_params_name: idempotent_params + field_name_patterns: + resource: table + timeout_millis: 60000 + header_request_params: + - resource + - name: SnapshotTable + flattening: + groups: + - parameters: + - name + - cluster + - snapshot_id + - description + required_fields: + - name + - cluster + - snapshot_id + - description + retry_codes_name: non_idempotent + retry_params_name: non_idempotent_params + field_name_patterns: + name: table + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + long_running: + return_type: google.bigtable.admin.v2.Snapshot + metadata_type: google.bigtable.admin.v2.SnapshotTableMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 600000 + # Snapshots are Alpha-only and not supported in C# + surface_treatments: + - include_languages: [csharp] + visibility: DISABLED + header_request_params: + - name + - name: GetSnapshot + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: idempotent_params + field_name_patterns: + name: snapshot + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + # Snapshots are Alpha-only and not supported in C# + surface_treatments: + - include_languages: [csharp] + visibility: DISABLED + header_request_params: + - name + - name: ListSnapshots + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: snapshots + retry_codes_name: idempotent + retry_params_name: idempotent_params + field_name_patterns: + parent: cluster + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + # Snapshots are Alpha-only and not supported in C# + surface_treatments: + - include_languages: [csharp] + visibility: DISABLED + header_request_params: + - parent + - name: DeleteSnapshot + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: non_idempotent + retry_params_name: non_idempotent_params + field_name_patterns: + name: snapshot + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + # Snapshots are Alpha-only and not supported in C# + surface_treatments: + - include_languages: [csharp] + visibility: DISABLED + header_request_params: + - name + - name: CreateBackup + flattening: + groups: + - parameters: + - parent + - backup_id + - backup + required_fields: + - parent + - backup_id + - backup + retry_codes_name: non_idempotent + retry_params_name: non_idempotent_params + field_name_patterns: + parent: cluster + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + long_running: + return_type: google.bigtable.admin.v2.Backup + metadata_type: google.bigtable.admin.v2.CreateBackupMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 600000 + # Managed Backup is in alpha and not supported in C# + surface_treatments: + - include_languages: [csharp] + visibility: DISABLED + header_request_params: + - parent + - name: GetBackup + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: idempotent_params + field_name_patterns: + name: backup + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + # Managed Backup is in alpha and not supported in C# + surface_treatments: + - include_languages: [csharp] + visibility: DISABLED + header_request_params: + - name + - name: ListBackups + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: backups + retry_codes_name: idempotent + retry_params_name: idempotent_params + field_name_patterns: + parent: cluster + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + # Managed Backup is in alpha and not supported in C# + surface_treatments: + - include_languages: [csharp] + visibility: DISABLED + header_request_params: + - parent + - name: UpdateBackup + flattening: + groups: + - parameters: + - backup + - update_mask + required_fields: + - backup + - update_mask + retry_codes_name: non_idempotent + retry_params_name: non_idempotent_params + field_name_patterns: + name: backup + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + # Managed Backup is in alpha and not supported in C# + surface_treatments: + - include_languages: [csharp] + visibility: DISABLED + header_request_params: + - backup + - name: DeleteBackup + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: non_idempotent + retry_params_name: non_idempotent_params + field_name_patterns: + name: backup + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + # Managed Backup is in alpha and not supported in C# + surface_treatments: + - include_languages: [csharp] + visibility: DISABLED + header_request_params: + - name + - name: RestoreTable + required_fields: + - parent + retry_codes_name: non_idempotent + retry_params_name: non_idempotent_params + field_name_patterns: + name: cluster + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + long_running: + return_type: google.bigtable.admin.v2.Table + metadata_type: google.bigtable.admin.v2.RestoreTableMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 600000 + # Managed Backup is in alpha and not supported in C# + surface_treatments: + - include_languages: [csharp] + visibility: DISABLED + header_request_params: + - parent + +resource_name_generation: +- message_name: CreateInstanceRequest + field_entity_map: + parent: project +- message_name: GetInstanceRequest + field_entity_map: + name: instance +- message_name: ListInstancesRequest + field_entity_map: + parent: project +- message_name: UpdateInstanceRequest + field_entity_map: + name: instance +- message_name: DeleteInstanceRequest + field_entity_map: + name: instance +- message_name: CreateClusterRequest + field_entity_map: + parent: instance +- message_name: GetClusterRequest + field_entity_map: + name: cluster +- message_name: ListClustersRequest + field_entity_map: + parent: instance +- message_name: UpdateClusterRequest + field_entity_map: + name: cluster +- message_name: DeleteClusterRequest + field_entity_map: + name: cluster +- message_name: CreateAppProfileRequest + field_entity_map: + parent: instance +- message_name: GetAppProfileRequest + field_entity_map: + name: app_profile +- message_name: ListAppProfilesRequest + field_entity_map: + parent: instance +- message_name: DeleteAppProfileRequest + field_entity_map: + name: app_profile +- message_name: CreateTableRequest + field_entity_map: + parent: instance +- message_name: CreateTableFromSnapshotRequest + field_entity_map: + parent: instance + source_snapshot: snapshot +- message_name: ListTablesRequest + field_entity_map: + parent: instance +- message_name: GetTableRequest + field_entity_map: + name: table +- message_name: DeleteTableRequest + field_entity_map: + name: table +- message_name: ModifyColumnFamiliesRequest + field_entity_map: + name: table +- message_name: DropRowRangeRequest + field_entity_map: + name: table +- message_name: GenerateConsistencyTokenRequest + field_entity_map: + name: table +- message_name: CheckConsistencyRequest + field_entity_map: + name: table +- message_name: SnapshotTableRequest + field_entity_map: + name: table + cluster: cluster + snapshot_id: snapshot +- message_name: GetSnapshotRequest + field_entity_map: + name: snapshot +- message_name: ListSnapshotsRequest + field_entity_map: + parent: cluster +- message_name: DeleteSnapshotRequest + field_entity_map: + name: snapshot +- message_name: CreateBackupRequest + field_entity_map: + parent: cluster +- message_name: GetBackupRequest + field_entity_map: + name: backup +- message_name: ListBackupsRequest + field_entity_map: + parent: cluster +- message_name: UpdateBackupRequest + field_entity_map: + name: backup +- message_name: DeleteBackupRequest + field_entity_map: + name: backup +- message_name: Instance + field_entity_map: + name: instance +- message_name: Cluster + field_entity_map: + name: cluster + location: location +- message_name: Table + field_entity_map: + name: table +- message_name: Snapshot + field_entity_map: + name: snapshot +- message_name: Backup + field_entity_map: + name: backup diff --git a/third_party/googleapis/google/bigtable/admin/v2/bigtableadmin_gapic.yaml b/third_party/googleapis/google/bigtable/admin/v2/bigtableadmin_gapic.yaml index 521f43ec2..1fef6825f 100644 --- a/third_party/googleapis/google/bigtable/admin/v2/bigtableadmin_gapic.yaml +++ b/third_party/googleapis/google/bigtable/admin/v2/bigtableadmin_gapic.yaml @@ -1,5 +1,5 @@ type: com.google.api.codegen.ConfigProto -config_schema_version: 1.0.0 +config_schema_version: 2.0.0 language_settings: java: package_name: com.google.cloud.bigtable.admin.v2 @@ -14,773 +14,257 @@ language_settings: package_name: Google.Cloud.Bigtable.Admin.V2 ruby: package_name: Google::Cloud::Bigtable::Admin::V2 - release_level: BETA + release_level: GA php: package_name: Google\Cloud\Bigtable\Admin\V2 nodejs: package_name: admin.v2 interfaces: - name: google.bigtable.admin.v2.BigtableInstanceAdmin - collections: - - name_pattern: projects/{project} - entity_name: project - language_overrides: - - language: csharp - common_resource_name: Google.Api.Gax.ResourceNames.ProjectName - - name_pattern: projects/{project}/instances/{instance} - entity_name: instance - - name_pattern: projects/{project}/instances/{instance}/appProfiles/{app_profile} - entity_name: app_profile - - name_pattern: projects/{project}/instances/{instance}/clusters/{cluster} - entity_name: cluster - - name_pattern: projects/{project}/locations/{location} - entity_name: location - retry_codes_def: - - name: idempotent - retry_codes: - - UNAVAILABLE - - DEADLINE_EXCEEDED - - name: non_idempotent - retry_codes: - - UNAVAILABLE retry_params_def: - - name: default - initial_retry_delay_millis: 5 + - name: idempotent_params + initial_retry_delay_millis: 1000 retry_delay_multiplier: 2 max_retry_delay_millis: 60000 initial_rpc_timeout_millis: 60000 rpc_timeout_multiplier: 1 max_rpc_timeout_millis: 60000 total_timeout_millis: 600000 + - name: non_idempotent_params + initial_retry_delay_millis: 0 + retry_delay_multiplier: 1 + max_retry_delay_millis: 0 + initial_rpc_timeout_millis: 60000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 60000 + total_timeout_millis: 60000 + - name: non_idempotent_heavy_params + initial_retry_delay_millis: 0 + retry_delay_multiplier: 1 + max_retry_delay_millis: 0 + initial_rpc_timeout_millis: 300000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 300000 + total_timeout_millis: 300000 methods: - name: CreateInstance - flattening: - groups: - - parameters: - - parent - - instance_id - - instance - - clusters - required_fields: - - parent - - instance_id - - instance - - clusters - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: project - resource_name_treatment: STATIC_TYPES - timeout_millis: 60000 + retry_params_name: non_idempotent_heavy_params long_running: - return_type: google.bigtable.admin.v2.Instance - metadata_type: google.bigtable.admin.v2.CreateInstanceMetadata initial_poll_delay_millis: 500 poll_delay_multiplier: 1.5 max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - header_request_params: - - parent + total_poll_timeout_millis: 600000 - name: GetInstance - flattening: - groups: - - parameters: - - name - required_fields: - - name - resource_name_treatment: STATIC_TYPES - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: instance - timeout_millis: 120000 - header_request_params: - - name + retry_params_name: idempotent_params - name: ListInstances - flattening: - groups: - - parameters: - - parent - required_fields: - - parent - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: project - resource_name_treatment: STATIC_TYPES - timeout_millis: 120000 - header_request_params: - - parent + retry_params_name: idempotent_params - name: UpdateInstance - required_fields: - - name - - display_name - - type - - labels retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: instance - resource_name_treatment: STATIC_TYPES - timeout_millis: 60000 - # Should use PartialUpdateInstance instead + retry_params_name: idempotent_params surface_treatments: - include_languages: [java, csharp] visibility: DISABLED - header_request_params: - - name - name: PartialUpdateInstance - flattening: - groups: - - parameters: - - instance - - update_mask - required_fields: - - instance - - update_mask retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - instance.name: instance - resource_name_treatment: STATIC_TYPES - timeout_millis: 60000 + retry_params_name: idempotent_params long_running: - return_type: google.bigtable.admin.v2.Instance - metadata_type: google.bigtable.admin.v2.UpdateInstanceMetadata initial_poll_delay_millis: 500 poll_delay_multiplier: 1.5 max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - header_request_params: - - instance.name + total_poll_timeout_millis: 600000 - name: DeleteInstance - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - name: instance - resource_name_treatment: STATIC_TYPES - timeout_millis: 150000 - header_request_params: - - name + retry_params_name: non_idempotent_params - name: CreateCluster - flattening: - groups: - - parameters: - - parent - - cluster_id - - cluster - required_fields: - - parent - - cluster_id - - cluster - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: instance - resource_name_treatment: STATIC_TYPES + retry_params_name: non_idempotent_params long_running: - return_type: google.bigtable.admin.v2.Cluster - metadata_type: google.bigtable.admin.v2.CreateClusterMetadata - initial_poll_delay_millis: 500 + initial_poll_delay_millis: 5000 poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - timeout_millis: 60000 - header_request_params: - - parent + max_poll_delay_millis: 60000 + total_poll_timeout_millis: 21600000 - name: GetCluster - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: cluster - resource_name_treatment: STATIC_TYPES - timeout_millis: 120000 - header_request_params: - - name + retry_params_name: idempotent_params - name: ListClusters - flattening: - groups: - - parameters: - - parent - required_fields: - - parent - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: instance - resource_name_treatment: STATIC_TYPES - timeout_millis: 120000 - header_request_params: - - parent + retry_params_name: idempotent_params - name: UpdateCluster - required_fields: - - name - - serve_nodes retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: cluster - resource_name_treatment: STATIC_TYPES + retry_params_name: idempotent_params long_running: - return_type: google.bigtable.admin.v2.Cluster - metadata_type: google.bigtable.admin.v2.UpdateClusterMetadata initial_poll_delay_millis: 500 poll_delay_multiplier: 1.5 max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - timeout_millis: 60000 - header_request_params: - - name + total_poll_timeout_millis: 600000 - name: DeleteCluster - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - name: cluster - resource_name_treatment: STATIC_TYPES - timeout_millis: 120000 - header_request_params: - - name + retry_params_name: non_idempotent_params - name: CreateAppProfile - flattening: - groups: - - parameters: - - parent - - app_profile_id - - app_profile - required_fields: - - parent - - app_profile_id - - app_profile - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: instance - resource_name_treatment: STATIC_TYPES - timeout_millis: 120000 - header_request_params: - - parent + retry_params_name: non_idempotent_params - name: GetAppProfile - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: app_profile - resource_name_treatment: STATIC_TYPES - timeout_millis: 120000 - header_request_params: - - name + retry_params_name: idempotent_params - name: ListAppProfiles - flattening: - groups: - - parameters: - - parent - required_fields: - - parent - page_streaming: - request: - token_field: page_token - response: - token_field: next_page_token - resources_field: app_profiles - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: instance - resource_name_treatment: STATIC_TYPES - timeout_millis: 120000 - header_request_params: - - parent + retry_params_name: idempotent_params - name: UpdateAppProfile - flattening: - groups: - - parameters: - - app_profile - - update_mask - required_fields: - - app_profile - - update_mask retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - app_profile.name: app_profile - resource_name_treatment: STATIC_TYPES - timeout_millis: 120000 + retry_params_name: idempotent_params long_running: - return_type: google.bigtable.admin.v2.AppProfile - metadata_type: google.bigtable.admin.v2.UpdateAppProfileMetadata - initial_poll_delay_millis: 5 + initial_poll_delay_millis: 500 poll_delay_multiplier: 1.5 max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - header_request_params: - - app_profile.name + total_poll_timeout_millis: 600000 - name: DeleteAppProfile - flattening: - groups: - - parameters: - - name - required_fields: - - name - - ignore_warnings - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - name: app_profile - resource_name_treatment: STATIC_TYPES - timeout_millis: 120000 - header_request_params: - - name + retry_params_name: non_idempotent_params - name: GetIamPolicy - flattening: - groups: - - parameters: - - resource - required_fields: - - resource retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - resource: instance - timeout_millis: 120000 - header_request_params: - - resource + retry_params_name: idempotent_params - name: SetIamPolicy - flattening: - groups: - - parameters: - - resource - - policy - required_fields: - - resource - - policy - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - resource: instance - timeout_millis: 120000 - header_request_params: - - resource + retry_params_name: non_idempotent_params - name: TestIamPermissions - flattening: - groups: - - parameters: - - resource - - permissions - required_fields: - - resource - - permissions retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - resource: instance - timeout_millis: 120000 - header_request_params: - - resource + retry_params_name: idempotent_params + - name: google.bigtable.admin.v2.BigtableTableAdmin - collections: - - name_pattern: projects/{project}/instances/{instance} - entity_name: instance - - name_pattern: projects/{project}/instances/{instance}/clusters/{cluster} - entity_name: cluster - - name_pattern: projects/{project}/instances/{instance}/clusters/{cluster}/snapshots/{snapshot} - entity_name: snapshot - - name_pattern: projects/{project}/instances/{instance}/tables/{table} - entity_name: table - language_overrides: - - language: csharp - common_resource_name: Google.Cloud.Bigtable.Common.V2.TableName - retry_codes_def: - - name: idempotent - retry_codes: - - UNAVAILABLE - - DEADLINE_EXCEEDED - - name: non_idempotent - retry_codes: [] retry_params_def: - - name: default - initial_retry_delay_millis: 100 - retry_delay_multiplier: 1.3 + - name: idempotent_params + initial_retry_delay_millis: 1000 + retry_delay_multiplier: 2 max_retry_delay_millis: 60000 - initial_rpc_timeout_millis: 20000 + initial_rpc_timeout_millis: 60000 rpc_timeout_multiplier: 1 - max_rpc_timeout_millis: 20000 + max_rpc_timeout_millis: 60000 total_timeout_millis: 600000 + - name: non_idempotent_params + initial_retry_delay_millis: 0 + retry_delay_multiplier: 1 + max_retry_delay_millis: 0 + initial_rpc_timeout_millis: 60000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 60000 + total_timeout_millis: 60000 + - name: non_idempotent_heavy_params + initial_retry_delay_millis: 0 + retry_delay_multiplier: 1 + max_retry_delay_millis: 0 + initial_rpc_timeout_millis: 300000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 300000 + total_timeout_millis: 300000 + - name: drop_row_range_params + initial_retry_delay_millis: 0 + retry_delay_multiplier: 1 + max_retry_delay_millis: 0 + initial_rpc_timeout_millis: 3600000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 3600000 + total_timeout_millis: 3600000 methods: - name: CreateTable - flattening: - groups: - - parameters: - - parent - - table_id - - table - required_fields: - - parent - - table_id - - table - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: instance - resource_name_treatment: STATIC_TYPES - timeout_millis: 900000 - header_request_params: - - parent + retry_params_name: non_idempotent_heavy_params - name: CreateTableFromSnapshot - flattening: - groups: - - parameters: - - parent - - table_id - - source_snapshot - required_fields: - - parent - - table_id - - source_snapshot - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: instance - resource_name_treatment: STATIC_TYPES + retry_params_name: non_idempotent_params long_running: - return_type: google.bigtable.admin.v2.Table - metadata_type: google.bigtable.admin.v2.CreateTableFromSnapshotMetadata - initial_poll_delay_millis: 500 + initial_poll_delay_millis: 5000 poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - timeout_millis: 60000 + max_poll_delay_millis: 60000 + total_poll_timeout_millis: 3600000 # Snapshots are Alpha-only and not supported in C# surface_treatments: - include_languages: [csharp] visibility: DISABLED - header_request_params: - - parent - name: ListTables - flattening: - groups: - - parameters: - - parent - required_fields: - - parent - page_streaming: - request: - token_field: page_token - response: - token_field: next_page_token - resources_field: tables - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: instance - resource_name_treatment: STATIC_TYPES - timeout_millis: 120000 - header_request_params: - - parent + retry_params_name: idempotent_params - name: GetTable - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: table - resource_name_treatment: STATIC_TYPES - timeout_millis: 120000 - header_request_params: - - name + retry_params_name: idempotent_params - name: DeleteTable - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - name: table - resource_name_treatment: STATIC_TYPES - timeout_millis: 120000 - header_request_params: - - name + retry_params_name: non_idempotent_params - name: ModifyColumnFamilies - flattening: - groups: - - parameters: - - name - - modifications - required_fields: - - name - - modifications - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - name: table - resource_name_treatment: STATIC_TYPES - timeout_millis: 900000 - header_request_params: - - name + retry_params_name: non_idempotent_heavy_params - name: DropRowRange - required_fields: - - name - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - name: table - resource_name_treatment: STATIC_TYPES - timeout_millis: 900000 - header_request_params: - - name + retry_params_name: drop_row_range_params - name: GenerateConsistencyToken - flattening: - groups: - - parameters: - - name - required_fields: - - name retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: table - resource_name_treatment: STATIC_TYPES - timeout_millis: 60000 - header_request_params: - - name + retry_params_name: idempotent_params - name: CheckConsistency - flattening: - groups: - - parameters: - - name - - consistency_token - required_fields: - - name - - consistency_token retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: table - resource_name_treatment: STATIC_TYPES - timeout_millis: 60000 - header_request_params: - - name + retry_params_name: idempotent_params + - name: GetIamPolicy + retry_codes_name: idempotent + retry_params_name: idempotent_params + - name: SetIamPolicy + retry_params_name: non_idempotent_params + - name: TestIamPermissions + retry_codes_name: idempotent + retry_params_name: idempotent_params - name: SnapshotTable - flattening: - groups: - - parameters: - - name - - cluster - - snapshot_id - - description - required_fields: - - name - - cluster - - snapshot_id - - description - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - name: table - resource_name_treatment: STATIC_TYPES - timeout_millis: 60000 + retry_params_name: non_idempotent_params long_running: - return_type: google.bigtable.admin.v2.Snapshot - metadata_type: google.bigtable.admin.v2.SnapshotTableMetadata initial_poll_delay_millis: 500 poll_delay_multiplier: 1.5 max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 + total_poll_timeout_millis: 600000 # Snapshots are Alpha-only and not supported in C# surface_treatments: - include_languages: [csharp] visibility: DISABLED - header_request_params: - - name - name: GetSnapshot - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: snapshot - resource_name_treatment: STATIC_TYPES - timeout_millis: 60000 + retry_params_name: idempotent_params # Snapshots are Alpha-only and not supported in C# surface_treatments: - include_languages: [csharp] visibility: DISABLED - header_request_params: - - name - name: ListSnapshots - flattening: - groups: - - parameters: - - parent - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: snapshots retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: cluster - resource_name_treatment: STATIC_TYPES - timeout_millis: 60000 + retry_params_name: idempotent_params # Snapshots are Alpha-only and not supported in C# surface_treatments: - include_languages: [csharp] visibility: DISABLED - header_request_params: - - parent - name: DeleteSnapshot - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - name: snapshot - resource_name_treatment: STATIC_TYPES - timeout_millis: 60000 + retry_params_name: non_idempotent_params # Snapshots are Alpha-only and not supported in C# surface_treatments: - include_languages: [csharp] visibility: DISABLED - header_request_params: - - name - -resource_name_generation: -- message_name: CreateInstanceRequest - field_entity_map: - parent: project -- message_name: GetInstanceRequest - field_entity_map: - name: instance -- message_name: ListInstancesRequest - field_entity_map: - parent: project -- message_name: UpdateInstanceRequest - field_entity_map: - name: instance -- message_name: DeleteInstanceRequest - field_entity_map: - name: instance -- message_name: CreateClusterRequest - field_entity_map: - parent: instance -- message_name: GetClusterRequest - field_entity_map: - name: cluster -- message_name: ListClustersRequest - field_entity_map: - parent: instance -- message_name: UpdateClusterRequest - field_entity_map: - name: cluster -- message_name: DeleteClusterRequest - field_entity_map: - name: cluster -- message_name: CreateAppProfileRequest - field_entity_map: - parent: instance -- message_name: GetAppProfileRequest - field_entity_map: - name: app_profile -- message_name: ListAppProfilesRequest - field_entity_map: - parent: instance -- message_name: DeleteAppProfileRequest - field_entity_map: - name: app_profile -- message_name: CreateTableRequest - field_entity_map: - parent: instance -- message_name: CreateTableFromSnapshotRequest - field_entity_map: - parent: instance - source_snapshot: snapshot -- message_name: ListTablesRequest - field_entity_map: - parent: instance -- message_name: GetTableRequest - field_entity_map: - name: table -- message_name: DeleteTableRequest - field_entity_map: - name: table -- message_name: ModifyColumnFamiliesRequest - field_entity_map: - name: table -- message_name: DropRowRangeRequest - field_entity_map: - name: table -- message_name: GenerateConsistencyTokenRequest - field_entity_map: - name: table -- message_name: CheckConsistencyRequest - field_entity_map: - name: table -- message_name: SnapshotTableRequest - field_entity_map: - name: table - cluster: cluster - snapshot_id: snapshot -- message_name: GetSnapshotRequest - field_entity_map: - name: snapshot -- message_name: ListSnapshotsRequest - field_entity_map: - parent: cluster -- message_name: DeleteSnapshotRequest - field_entity_map: - name: snapshot -- message_name: Instance - field_entity_map: - name: instance -- message_name: Cluster - field_entity_map: - name: cluster - location: location -- message_name: Table - field_entity_map: - name: table -- message_name: Snapshot - field_entity_map: - name: snapshot + - name: CreateBackup + retry_params_name: non_idempotent_params + long_running: + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 600000 + # Managed Backup is in alpha and not supported in C# + surface_treatments: + - include_languages: [csharp] + visibility: DISABLED + - name: GetBackup + retry_params_name: idempotent_params + # Managed Backup is in alpha and not supported in C# + surface_treatments: + - include_languages: [csharp] + visibility: DISABLED + - name: ListBackups + retry_params_name: idempotent_params + # Managed Backup is in alpha and not supported in C# + surface_treatments: + - include_languages: [csharp] + visibility: DISABLED + - name: UpdateBackup + retry_params_name: non_idempotent_params + # Managed Backup is in alpha and not supported in C# + surface_treatments: + - include_languages: [csharp] + visibility: DISABLED + - name: DeleteBackup + retry_params_name: non_idempotent_params + # Managed Backup is in alpha and not supported in C# + surface_treatments: + - include_languages: [csharp] + visibility: DISABLED + - name: RestoreTable + retry_params_name: non_idempotent_params + long_running: + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 600000 + # Managed Backup is in alpha and not supported in C# + surface_treatments: + - include_languages: [csharp] + visibility: DISABLED diff --git a/third_party/googleapis/google/bigtable/admin/v2/bigtableadmin_grpc_service_config.json b/third_party/googleapis/google/bigtable/admin/v2/bigtableadmin_grpc_service_config.json new file mode 100755 index 000000000..5682ad9fa --- /dev/null +++ b/third_party/googleapis/google/bigtable/admin/v2/bigtableadmin_grpc_service_config.json @@ -0,0 +1,199 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.bigtable.admin.v2.BigtableTableAdmin", + "method": "CreateTable" + }, + { + "service": "google.bigtable.admin.v2.BigtableTableAdmin", + "method": "ModifyColumnFamilies" + } + ], + "timeout": "300s" + }, + { + "name": [ + { + "service": "google.bigtable.admin.v2.BigtableTableAdmin", + "method": "CreateTableFromSnapshot" + }, + { + "service": "google.bigtable.admin.v2.BigtableTableAdmin", + "method": "DeleteTable" + }, + { + "service": "google.bigtable.admin.v2.BigtableTableAdmin", + "method": "SetIamPolicy" + }, + { + "service": "google.bigtable.admin.v2.BigtableTableAdmin", + "method": "SnapshotTable" + }, + { + "service": "google.bigtable.admin.v2.BigtableTableAdmin", + "method": "DeleteSnapshot" + } + ], + "timeout": "60s" + }, + { + "name": [ + { + "service": "google.bigtable.admin.v2.BigtableTableAdmin", + "method": "ListTables" + }, + { + "service": "google.bigtable.admin.v2.BigtableTableAdmin", + "method": "GetTable" + }, + { + "service": "google.bigtable.admin.v2.BigtableTableAdmin", + "method": "GenerateConsistencyToken" + }, + { + "service": "google.bigtable.admin.v2.BigtableTableAdmin", + "method": "CheckConsistency" + }, + { + "service": "google.bigtable.admin.v2.BigtableTableAdmin", + "method": "GetIamPolicy" + }, + { + "service": "google.bigtable.admin.v2.BigtableTableAdmin", + "method": "TestIamPermissions" + }, + { + "service": "google.bigtable.admin.v2.BigtableTableAdmin", + "method": "GetSnapshot" + }, + { + "service": "google.bigtable.admin.v2.BigtableTableAdmin", + "method": "ListSnapshots" + } + ], + "timeout": "60s", + "retryPolicy": { + "maxAttempts": 5, + "initialBackoff": "1s", + "maxBackoff": "60s", + "backoffMultiplier": 2, + "retryableStatusCodes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ] + } + }, + { + "name": [ + { + "service": "google.bigtable.admin.v2.BigtableTableAdmin", + "method": "DropRowRange" + } + ], + "timeout": "3600s" + }, + { + "name": [ + { + "service": "google.bigtable.admin.v2.BigtableInstanceAdmin", + "method": "CreateInstance" + } + ], + "timeout": "300s" + }, + { + "name": [ + { + "service": "google.bigtable.admin.v2.BigtableInstanceAdmin", + "method": "GetInstance" + }, + { + "service": "google.bigtable.admin.v2.BigtableInstanceAdmin", + "method": "ListInstances" + }, + { + "service": "google.bigtable.admin.v2.BigtableInstanceAdmin", + "method": "UpdateInstance" + }, + { + "service": "google.bigtable.admin.v2.BigtableInstanceAdmin", + "method": "PartialUpdateInstance" + }, + { + "service": "google.bigtable.admin.v2.BigtableInstanceAdmin", + "method": "GetCluster" + }, + { + "service": "google.bigtable.admin.v2.BigtableInstanceAdmin", + "method": "ListClusters" + }, + { + "service": "google.bigtable.admin.v2.BigtableInstanceAdmin", + "method": "UpdateCluster" + }, + { + "service": "google.bigtable.admin.v2.BigtableInstanceAdmin", + "method": "GetAppProfile" + }, + { + "service": "google.bigtable.admin.v2.BigtableInstanceAdmin", + "method": "ListAppProfiles" + }, + { + "service": "google.bigtable.admin.v2.BigtableInstanceAdmin", + "method": "UpdateAppProfile" + }, + { + "service": "google.bigtable.admin.v2.BigtableInstanceAdmin", + "method": "GetIamPolicy" + }, + { + "service": "google.bigtable.admin.v2.BigtableInstanceAdmin", + "method": "TestIamPermissions" + } + ], + "timeout": "60s", + "retryPolicy": { + "maxAttempts": 5, + "initialBackoff": "1s", + "maxBackoff": "60s", + "backoffMultiplier": 2, + "retryableStatusCodes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ] + } + }, + { + "name": [ + { + "service": "google.bigtable.admin.v2.BigtableInstanceAdmin", + "method": "DeleteInstance" + }, + { + "service": "google.bigtable.admin.v2.BigtableInstanceAdmin", + "method": "CreateCluster" + }, + { + "service": "google.bigtable.admin.v2.BigtableInstanceAdmin", + "method": "DeleteCluster" + }, + { + "service": "google.bigtable.admin.v2.BigtableInstanceAdmin", + "method": "CreateAppProfile" + }, + { + "service": "google.bigtable.admin.v2.BigtableInstanceAdmin", + "method": "DeleteAppProfile" + }, + { + "service": "google.bigtable.admin.v2.BigtableInstanceAdmin", + "method": "SetIamPolicy" + } + ], + "timeout": "60s" + } + ] +} diff --git a/third_party/googleapis/google/bigtable/admin/bigtableadmin.yaml b/third_party/googleapis/google/bigtable/admin/v2/bigtableadmin_v2.yaml similarity index 52% rename from third_party/googleapis/google/bigtable/admin/bigtableadmin.yaml rename to third_party/googleapis/google/bigtable/admin/v2/bigtableadmin_v2.yaml index 5e6b8075d..f13bf93c1 100644 --- a/third_party/googleapis/google/bigtable/admin/bigtableadmin.yaml +++ b/third_party/googleapis/google/bigtable/admin/v2/bigtableadmin_v2.yaml @@ -8,113 +8,48 @@ apis: - name: google.bigtable.admin.v2.BigtableTableAdmin types: +- name: google.bigtable.admin.v2.Backup +- name: google.bigtable.admin.v2.CreateBackupMetadata +- name: google.bigtable.admin.v2.CreateClusterMetadata - name: google.bigtable.admin.v2.CreateInstanceMetadata -- name: google.bigtable.admin.v2.UpdateInstanceMetadata - name: google.bigtable.admin.v2.CreateTableFromSnapshotMetadata +- name: google.bigtable.admin.v2.OptimizeRestoredTableMetadata +- name: google.bigtable.admin.v2.RestoreTableMetadata - name: google.bigtable.admin.v2.SnapshotTableMetadata -- name: google.bigtable.admin.v2.CreateClusterMetadata -- name: google.bigtable.admin.v2.UpdateClusterMetadata - name: google.bigtable.admin.v2.UpdateAppProfileMetadata +- name: google.bigtable.admin.v2.UpdateClusterMetadata +- name: google.bigtable.admin.v2.UpdateInstanceMetadata + +documentation: + summary: Administer your Cloud Bigtable tables and instances. backend: rules: - - selector: google.longrunning.Operations.ListOperations - deadline: 60.0 - - selector: google.longrunning.Operations.GetOperation - deadline: 60.0 - - selector: google.longrunning.Operations.DeleteOperation - deadline: 60.0 - - selector: google.longrunning.Operations.CancelOperation - deadline: 60.0 - - selector: google.longrunning.Operations.WaitOperation - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.CreateInstance - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.GetInstance - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.ListInstances - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.UpdateInstance - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.PartialUpdateInstance - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.DeleteInstance - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.CreateCluster - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.GetCluster - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.ListClusters - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.UpdateCluster - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.DeleteCluster - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.CreateAppProfile - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.GetAppProfile - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.ListAppProfiles - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.UpdateAppProfile - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.EnableAppProfile - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.DisableAppProfile + - selector: 'google.bigtable.admin.v2.BigtableInstanceAdmin.*' deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.DeleteAppProfile - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.GetIamPolicy - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.SetIamPolicy - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.TestIamPermissions + - selector: 'google.bigtable.admin.v2.BigtableTableAdmin.*' deadline: 60.0 - selector: google.bigtable.admin.v2.BigtableTableAdmin.CreateTable deadline: 130.0 - - selector: google.bigtable.admin.v2.BigtableTableAdmin.CreateTableFromSnapshot - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableTableAdmin.ListTables - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableTableAdmin.GetTable - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableTableAdmin.DeleteTable - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableTableAdmin.ModifyColumnFamilies - deadline: 60.0 - selector: google.bigtable.admin.v2.BigtableTableAdmin.DropRowRange deadline: 900.0 - - selector: google.bigtable.admin.v2.BigtableTableAdmin.GenerateConsistencyToken - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableTableAdmin.CheckConsistency - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableTableAdmin.SnapshotTable - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableTableAdmin.GetSnapshot - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableTableAdmin.ListSnapshots - deadline: 60.0 - - selector: google.bigtable.admin.v2.BigtableTableAdmin.DeleteSnapshot + - selector: 'google.longrunning.Operations.*' deadline: 60.0 http: rules: - - selector: google.longrunning.Operations.ListOperations - get: '/v2/{name=operations/projects/**}/operations' - - - selector: google.longrunning.Operations.GetOperation - get: '/v2/{name=operations/**}' - - - selector: google.longrunning.Operations.DeleteOperation - delete: '/v2/{name=operations/**}' - - selector: google.longrunning.Operations.CancelOperation post: '/v2/{name=operations/**}:cancel' - + - selector: google.longrunning.Operations.DeleteOperation + delete: '/v2/{name=operations/**}' + - selector: google.longrunning.Operations.GetOperation + get: '/v2/{name=operations/**}' + - selector: google.longrunning.Operations.ListOperations + get: '/v2/{name=operations/projects/**}/operations' authentication: rules: - - selector: '*' + - selector: 'google.bigtable.admin.v2.BigtableInstanceAdmin.*' oauth: canonical_scopes: |- https://www.googleapis.com/auth/bigtable.admin, @@ -123,6 +58,56 @@ authentication: https://www.googleapis.com/auth/cloud-bigtable.admin, https://www.googleapis.com/auth/cloud-bigtable.admin.cluster, https://www.googleapis.com/auth/cloud-platform + - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.GetAppProfile + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/bigtable.admin, + https://www.googleapis.com/auth/bigtable.admin.cluster, + https://www.googleapis.com/auth/bigtable.admin.instance, + https://www.googleapis.com/auth/cloud-bigtable.admin, + https://www.googleapis.com/auth/cloud-bigtable.admin.cluster, + https://www.googleapis.com/auth/cloud-platform, + https://www.googleapis.com/auth/cloud-platform.read-only + - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.GetCluster + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/bigtable.admin, + https://www.googleapis.com/auth/bigtable.admin.cluster, + https://www.googleapis.com/auth/bigtable.admin.instance, + https://www.googleapis.com/auth/cloud-bigtable.admin, + https://www.googleapis.com/auth/cloud-bigtable.admin.cluster, + https://www.googleapis.com/auth/cloud-platform, + https://www.googleapis.com/auth/cloud-platform.read-only + - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.GetInstance + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/bigtable.admin, + https://www.googleapis.com/auth/bigtable.admin.cluster, + https://www.googleapis.com/auth/bigtable.admin.instance, + https://www.googleapis.com/auth/cloud-bigtable.admin, + https://www.googleapis.com/auth/cloud-bigtable.admin.cluster, + https://www.googleapis.com/auth/cloud-platform, + https://www.googleapis.com/auth/cloud-platform.read-only + - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.ListClusters + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/bigtable.admin, + https://www.googleapis.com/auth/bigtable.admin.cluster, + https://www.googleapis.com/auth/bigtable.admin.instance, + https://www.googleapis.com/auth/cloud-bigtable.admin, + https://www.googleapis.com/auth/cloud-bigtable.admin.cluster, + https://www.googleapis.com/auth/cloud-platform, + https://www.googleapis.com/auth/cloud-platform.read-only + - selector: google.bigtable.admin.v2.BigtableInstanceAdmin.ListInstances + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/bigtable.admin, + https://www.googleapis.com/auth/bigtable.admin.cluster, + https://www.googleapis.com/auth/bigtable.admin.instance, + https://www.googleapis.com/auth/cloud-bigtable.admin, + https://www.googleapis.com/auth/cloud-bigtable.admin.cluster, + https://www.googleapis.com/auth/cloud-platform, + https://www.googleapis.com/auth/cloud-platform.read-only - selector: 'google.bigtable.admin.v2.BigtableTableAdmin.*' oauth: canonical_scopes: |- @@ -131,23 +116,16 @@ authentication: https://www.googleapis.com/auth/cloud-bigtable.admin, https://www.googleapis.com/auth/cloud-bigtable.admin.table, https://www.googleapis.com/auth/cloud-platform - - selector: |- - google.bigtable.admin.v2.BigtableInstanceAdmin.GetCluster, - google.bigtable.admin.v2.BigtableInstanceAdmin.GetInstance, - google.bigtable.admin.v2.BigtableInstanceAdmin.ListClusters, - google.bigtable.admin.v2.BigtableInstanceAdmin.ListInstances + - selector: google.bigtable.admin.v2.BigtableTableAdmin.GetTable oauth: canonical_scopes: |- https://www.googleapis.com/auth/bigtable.admin, - https://www.googleapis.com/auth/bigtable.admin.cluster, - https://www.googleapis.com/auth/bigtable.admin.instance, + https://www.googleapis.com/auth/bigtable.admin.table, https://www.googleapis.com/auth/cloud-bigtable.admin, - https://www.googleapis.com/auth/cloud-bigtable.admin.cluster, + https://www.googleapis.com/auth/cloud-bigtable.admin.table, https://www.googleapis.com/auth/cloud-platform, https://www.googleapis.com/auth/cloud-platform.read-only - - selector: |- - google.bigtable.admin.v2.BigtableTableAdmin.GetTable, - google.bigtable.admin.v2.BigtableTableAdmin.ListTables + - selector: google.bigtable.admin.v2.BigtableTableAdmin.ListTables oauth: canonical_scopes: |- https://www.googleapis.com/auth/bigtable.admin, @@ -156,9 +134,26 @@ authentication: https://www.googleapis.com/auth/cloud-bigtable.admin.table, https://www.googleapis.com/auth/cloud-platform, https://www.googleapis.com/auth/cloud-platform.read-only - - selector: |- - google.longrunning.Operations.GetOperation, - google.longrunning.Operations.ListOperations + - selector: 'google.longrunning.Operations.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/bigtable.admin, + https://www.googleapis.com/auth/bigtable.admin.cluster, + https://www.googleapis.com/auth/bigtable.admin.instance, + https://www.googleapis.com/auth/cloud-bigtable.admin, + https://www.googleapis.com/auth/cloud-bigtable.admin.cluster, + https://www.googleapis.com/auth/cloud-platform + - selector: google.longrunning.Operations.GetOperation + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/bigtable.admin, + https://www.googleapis.com/auth/bigtable.admin.cluster, + https://www.googleapis.com/auth/bigtable.admin.instance, + https://www.googleapis.com/auth/cloud-bigtable.admin, + https://www.googleapis.com/auth/cloud-bigtable.admin.cluster, + https://www.googleapis.com/auth/cloud-platform, + https://www.googleapis.com/auth/cloud-platform.read-only + - selector: google.longrunning.Operations.ListOperations oauth: canonical_scopes: |- https://www.googleapis.com/auth/bigtable.admin, diff --git a/third_party/googleapis/google/bigtable/admin/v2/common.proto b/third_party/googleapis/google/bigtable/admin/v2/common.proto index ad4d73599..89d24ea97 100644 --- a/third_party/googleapis/google/bigtable/admin/v2/common.proto +++ b/third_party/googleapis/google/bigtable/admin/v2/common.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,11 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.bigtable.admin.v2; -import "google/api/annotations.proto"; import "google/protobuf/timestamp.proto"; option csharp_namespace = "Google.Cloud.Bigtable.Admin.V2"; @@ -38,3 +36,18 @@ enum StorageType { // Magnetic drive (HDD) storage should be used. HDD = 2; } + +// Encapsulates progress related information for a Cloud Bigtable long +// running operation. +message OperationProgress { + // Percent completion of the operation. + // Values are between 0 and 100 inclusive. + int32 progress_percent = 1; + + // Time the request was received. + google.protobuf.Timestamp start_time = 2; + + // If set, the time at which this operation failed or was completed + // successfully. + google.protobuf.Timestamp end_time = 3; +} diff --git a/third_party/googleapis/google/bigtable/admin/v2/instance.proto b/third_party/googleapis/google/bigtable/admin/v2/instance.proto index ef8599bfe..e15f63ac0 100644 --- a/third_party/googleapis/google/bigtable/admin/v2/instance.proto +++ b/third_party/googleapis/google/bigtable/admin/v2/instance.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google LLC. +// Copyright 2019 Google LLC. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -17,7 +17,8 @@ syntax = "proto3"; package google.bigtable.admin.v2; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/bigtable/admin/v2/common.proto"; option csharp_namespace = "Google.Cloud.Bigtable.Admin.V2"; @@ -29,9 +30,14 @@ option php_namespace = "Google\\Cloud\\Bigtable\\Admin\\V2"; // A collection of Bigtable [Tables][google.bigtable.admin.v2.Table] and // the resources that serve them. -// All tables in an instance are served from a single -// [Cluster][google.bigtable.admin.v2.Cluster]. +// All tables in an instance are served from all +// [Clusters][google.bigtable.admin.v2.Cluster] in the instance. message Instance { + option (google.api.resource) = { + type: "bigtable.googleapis.com/Instance" + pattern: "projects/{project}/instances/{instance}" + }; + // Possible states of an instance. enum State { // The state of the instance could not be determined. @@ -67,15 +73,14 @@ message Instance { DEVELOPMENT = 2; } - // (`OutputOnly`) // The unique name of the instance. Values are of the form - // `projects//instances/[a-z][a-z0-9\\-]+[a-z0-9]`. - string name = 1; + // `projects/{project}/instances/[a-z][a-z0-9\\-]+[a-z0-9]`. + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The descriptive name for this instance as it appears in UIs. + // Required. The descriptive name for this instance as it appears in UIs. // Can be changed at any time, but should be kept globally unique // to avoid confusion. - string display_name = 2; + string display_name = 2 [(google.api.field_behavior) = REQUIRED]; // (`OutputOnly`) // The current state of the instance. @@ -102,6 +107,11 @@ message Instance { // of serving all [Tables][google.bigtable.admin.v2.Table] in the parent // [Instance][google.bigtable.admin.v2.Instance]. message Cluster { + option (google.api.resource) = { + type: "bigtable.googleapis.com/Cluster" + pattern: "projects/{project}/instances/{instance}/clusters/{cluster}" + }; + // Possible states of a cluster. enum State { // The state of the cluster could not be determined. @@ -127,25 +137,25 @@ message Cluster { DISABLED = 4; } - // (`OutputOnly`) // The unique name of the cluster. Values are of the form - // `projects//instances//clusters/[a-z][-a-z0-9]*`. - string name = 1; + // `projects/{project}/instances/{instance}/clusters/[a-z][-a-z0-9]*`. + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // (`CreationOnly`) // The location where this cluster's nodes and storage reside. For best // performance, clients should be located as close as possible to this // cluster. Currently only zones are supported, so values should be of the - // form `projects//locations/`. - string location = 2; + // form `projects/{project}/locations/{zone}`. + string location = 2 [(google.api.resource_reference) = { + type: "locations.googleapis.com/Location" + }]; - // (`OutputOnly`) // The current state of the cluster. - State state = 3; + State state = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // The number of nodes allocated to this cluster. More nodes enable higher - // throughput and more consistent performance. - int32 serve_nodes = 4; + // Required. The number of nodes allocated to this cluster. More nodes enable + // higher throughput and more consistent performance. + int32 serve_nodes = 4 [(google.api.field_behavior) = REQUIRED]; // (`CreationOnly`) // The type of storage used by this cluster to serve its @@ -156,14 +166,20 @@ message Cluster { // A configuration object describing how Cloud Bigtable should treat traffic // from a particular end user application. message AppProfile { - // Read/write requests may be routed to any cluster in the instance, and will - // fail over to another cluster in the event of transient errors or delays. - // Choosing this option sacrifices read-your-writes consistency to improve - // availability. + option (google.api.resource) = { + type: "bigtable.googleapis.com/AppProfile" + pattern: "projects/{project}/instances/{instance}/appProfiles/{app_profile}" + }; + + // Read/write requests are routed to the nearest cluster in the instance, and + // will fail over to the nearest cluster that is available in the event of + // transient errors or delays. Clusters in a region are considered + // equidistant. Choosing this option sacrifices read-your-writes consistency + // to improve availability. message MultiClusterRoutingUseAny {} // Unconditionally routes all read/write requests to a specific cluster. - // This option preserves read-your-writes consistency, but does not improve + // This option preserves read-your-writes consistency but does not improve // availability. message SingleClusterRouting { // The cluster to which read/write requests should be routed. @@ -193,10 +209,10 @@ message AppProfile { // Optional long form description of the use case for this AppProfile. string description = 3; - // The routing policy for all read/write requests which use this app profile. + // The routing policy for all read/write requests that use this app profile. // A value must be explicitly set. oneof routing_policy { - // Use a multi-cluster routing policy that may pick any cluster. + // Use a multi-cluster routing policy. MultiClusterRoutingUseAny multi_cluster_routing_use_any = 5; // Use a single-cluster routing policy. diff --git a/third_party/googleapis/google/bigtable/admin/v2/table.proto b/third_party/googleapis/google/bigtable/admin/v2/table.proto index 5019d8b86..535378989 100644 --- a/third_party/googleapis/google/bigtable/admin/v2/table.proto +++ b/third_party/googleapis/google/bigtable/admin/v2/table.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.bigtable.admin.v2; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/duration.proto"; import "google/protobuf/timestamp.proto"; @@ -28,9 +28,36 @@ option java_outer_classname = "TableProto"; option java_package = "com.google.bigtable.admin.v2"; option php_namespace = "Google\\Cloud\\Bigtable\\Admin\\V2"; +// Indicates the type of the restore source. +enum RestoreSourceType { + // No restore associated. + RESTORE_SOURCE_TYPE_UNSPECIFIED = 0; + + // A backup was used as the source of the restore. + BACKUP = 1; +} + +// Information about a table restore. +message RestoreInfo { + // The type of the restore source. + RestoreSourceType source_type = 1; + + // Information about the source used to restore the table. + oneof source_info { + // Information about the backup used to restore the table. The backup + // may no longer exist. + BackupInfo backup_info = 2; + } +} + // A collection of user data indexed by row, column, and timestamp. // Each table is served using the resources of its parent cluster. message Table { + option (google.api.resource) = { + type: "bigtable.googleapis.com/Table" + pattern: "projects/{project}/instances/{instance}/tables/{table}" + }; + // The state of a table's data in a particular cluster. message ClusterState { // Table replication states. @@ -55,10 +82,14 @@ message Table { // replication delay, reads may not immediately reflect the state of the // table in other clusters. READY = 4; + + // The table is fully created and ready for use after a restore, and is + // being optimized for performance. When optimizations are complete, the + // table will transition to `READY` state. + READY_OPTIMIZING = 5; } - // (`OutputOnly`) - // The state of replication for the table in this cluster. + // Output only. The state of replication for the table in this cluster. ReplicationState replication_state = 1; } @@ -84,22 +115,20 @@ message Table { // Only populates `name` and fields related to the table's schema. SCHEMA_VIEW = 2; - // Only populates `name` and fields related to the table's - // replication state. + // Only populates `name` and fields related to the table's replication + // state. REPLICATION_VIEW = 3; // Populates all fields. FULL = 4; } - // (`OutputOnly`) - // The unique name of the table. Values are of the form + // Output only. The unique name of the table. Values are of the form // `projects//instances//tables/[_a-zA-Z0-9][-_.a-zA-Z0-9]*`. // Views: `NAME_ONLY`, `SCHEMA_VIEW`, `REPLICATION_VIEW`, `FULL` string name = 1; - // (`OutputOnly`) - // Map from cluster ID to per-cluster table state. + // Output only. Map from cluster ID to per-cluster table state. // If it could not be determined whether or not the table has data in a // particular cluster (for example, if its zone is unavailable), then // there will be an entry for the cluster with UNKNOWN `replication_status`. @@ -115,8 +144,12 @@ message Table { // The granularity (i.e. `MILLIS`) at which timestamps are stored in // this table. Timestamps not matching the granularity will be rejected. // If unspecified at creation time, the value will be set to `MILLIS`. - // Views: `SCHEMA_VIEW`, `FULL` + // Views: `SCHEMA_VIEW`, `FULL`. TimestampGranularity granularity = 4; + + // Output only. If this table was restored from another data source (e.g. a + // backup), this field will be populated with information about the restore. + RestoreInfo restore_info = 6; } // A set of columns within a table which share a common configuration. @@ -170,6 +203,11 @@ message GcRule { // feature might be changed in backward-incompatible ways and is not recommended // for production use. It is not subject to any SLA or deprecation policy. message Snapshot { + option (google.api.resource) = { + type: "bigtable.googleapis.com/Snapshot" + pattern: "projects/{project}/instances/{instance}/clusters/{cluster}/snapshots/{snapshot}" + }; + // Possible states of a snapshot. enum State { // The state of the snapshot could not be determined. @@ -184,37 +222,118 @@ message Snapshot { CREATING = 2; } - // (`OutputOnly`) - // The unique name of the snapshot. + // Output only. The unique name of the snapshot. // Values are of the form // `projects//instances//clusters//snapshots/`. string name = 1; - // (`OutputOnly`) - // The source table at the time the snapshot was taken. + // Output only. The source table at the time the snapshot was taken. Table source_table = 2; - // (`OutputOnly`) - // The size of the data in the source table at the time the snapshot was - // taken. In some cases, this value may be computed asynchronously via a - // background process and a placeholder of 0 will be used in the meantime. + // Output only. The size of the data in the source table at the time the + // snapshot was taken. In some cases, this value may be computed + // asynchronously via a background process and a placeholder of 0 will be used + // in the meantime. int64 data_size_bytes = 3; - // (`OutputOnly`) - // The time when the snapshot is created. + // Output only. The time when the snapshot is created. google.protobuf.Timestamp create_time = 4; - // (`OutputOnly`) - // The time when the snapshot will be deleted. The maximum amount of time a - // snapshot can stay active is 365 days. If 'ttl' is not specified, + // Output only. The time when the snapshot will be deleted. The maximum amount + // of time a snapshot can stay active is 365 days. If 'ttl' is not specified, // the default maximum of 365 days will be used. google.protobuf.Timestamp delete_time = 5; - // (`OutputOnly`) - // The current state of the snapshot. + // Output only. The current state of the snapshot. State state = 6; - // (`OutputOnly`) - // Description of the snapshot. + // Output only. Description of the snapshot. string description = 7; } + +// A backup of a Cloud Bigtable table. +message Backup { + option (google.api.resource) = { + type: "bigtable.googleapis.com/Backup" + pattern: "projects/{project}/instances/{instance}/clusters/{cluster}/backups/{backup}" + }; + + // Indicates the current state of the backup. + enum State { + // Not specified. + STATE_UNSPECIFIED = 0; + + // The pending backup is still being created. Operations on the + // backup may fail with `FAILED_PRECONDITION` in this state. + CREATING = 1; + + // The backup is complete and ready for use. + READY = 2; + } + + // Output only. A globally unique identifier for the backup which cannot be + // changed. Values are of the form + // `projects/{project}/instances/{instance}/clusters/{cluster}/ + // backups/[_a-zA-Z0-9][-_.a-zA-Z0-9]*` + // The final segment of the name must be between 1 and 50 characters + // in length. + // + // The backup is stored in the cluster identified by the prefix of the backup + // name of the form + // `projects/{project}/instances/{instance}/clusters/{cluster}`. + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Required. Immutable. Name of the table from which this backup was created. + // This needs to be in the same instance as the backup. Values are of the form + // `projects/{project}/instances/{instance}/tables/{source_table}`. + string source_table = 2 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.field_behavior) = REQUIRED + ]; + + // Required. The expiration time of the backup, with microseconds + // granularity that must be at least 6 hours and at most 30 days + // from the time the request is received. Once the `expire_time` + // has passed, Cloud Bigtable will delete the backup and free the + // resources used by the backup. + google.protobuf.Timestamp expire_time = 3 + [(google.api.field_behavior) = REQUIRED]; + + // Output only. `start_time` is the time that the backup was started + // (i.e. approximately the time the + // [CreateBackup][google.bigtable.admin.v2.BigtableTableAdmin.CreateBackup] + // request is received). The row data in this backup will be no older than + // this timestamp. + google.protobuf.Timestamp start_time = 4 + [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. `end_time` is the time that the backup was finished. The row + // data in the backup will be no newer than this timestamp. + google.protobuf.Timestamp end_time = 5 + [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Size of the backup in bytes. + int64 size_bytes = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The current state of the backup. + State state = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// Information about a backup. +message BackupInfo { + // Output only. Name of the backup. + string backup = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The time that the backup was started. Row data in the backup + // will be no older than this timestamp. + google.protobuf.Timestamp start_time = 2 + [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. This time that the backup was finished. Row data in the + // backup will be no newer than this timestamp. + google.protobuf.Timestamp end_time = 3 + [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Name of the table the backup was created from. + string source_table = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/bigtable/artman_bigtable.yaml b/third_party/googleapis/google/bigtable/artman_bigtable.yaml index 5b4aa0258..7fd1777a4 100644 --- a/third_party/googleapis/google/bigtable/artman_bigtable.yaml +++ b/third_party/googleapis/google/bigtable/artman_bigtable.yaml @@ -2,8 +2,9 @@ common: api_name: bigtable api_version: v2 organization_name: google-cloud - service_yaml: bigtable.yaml + service_yaml: v2/bigtable_v2.yaml gapic_yaml: v2/bigtable_gapic.yaml + proto_package: google.bigtable.v2 src_proto_paths: - v2 proto_deps: diff --git a/third_party/googleapis/google/bigtable/v2/BUILD.bazel b/third_party/googleapis/google/bigtable/v2/BUILD.bazel index a1d7fc108..c60faf6d4 100644 --- a/third_party/googleapis/google/bigtable/v2/BUILD.bazel +++ b/third_party/googleapis/google/bigtable/v2/BUILD.bazel @@ -1,9 +1,12 @@ +# This file was automatically generated by BuildFileGenerator + # This is an API workspace, having public visibility by default makes perfect sense. package(default_visibility = ["//visibility:public"]) ############################################################################## # Common ############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") proto_library( @@ -14,6 +17,9 @@ proto_library( ], deps = [ "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", "//google/rpc:status_proto", "@com_google_protobuf//:wrappers_proto", ], @@ -21,7 +27,10 @@ proto_library( proto_library_with_info( name = "bigtable_proto_with_info", - deps = [":bigtable_proto"], + deps = [ + ":bigtable_proto", + "//google/cloud:common_resources_proto", + ], ) ############################################################################## @@ -29,18 +38,13 @@ proto_library_with_info( ############################################################################## load( "@com_google_googleapis_imports//:imports.bzl", - "java_grpc_library", - "java_gapic_library", "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", "java_proto_library", - "java_resource_name_proto_library", - "java_test", ) -_JAVA_GRPC_DEPS = [ - "@com_google_api_grpc_proto_google_common_protos//jar", -] - java_proto_library( name = "bigtable_java_proto", deps = [":bigtable_proto"], @@ -49,49 +53,40 @@ java_proto_library( java_grpc_library( name = "bigtable_java_grpc", srcs = [":bigtable_proto"], - deps = [":bigtable_java_proto"] + _JAVA_GRPC_DEPS, -) - -java_resource_name_proto_library( - name = "bigtable_resource_name_java_proto", - gapic_yaml = "bigtable_gapic.yaml", - deps = [":bigtable_proto"], + deps = [":bigtable_java_proto"], ) java_gapic_library( name = "bigtable_java_gapic", src = ":bigtable_proto_with_info", gapic_yaml = "bigtable_gapic.yaml", - service_yaml = "//google/bigtable:bigtable.yaml", - test_deps = [":bigtable_java_grpc"], + package = "google.bigtable.v2", + service_yaml = "bigtable_v2.yaml", + test_deps = [ + ":bigtable_java_grpc", + ], deps = [ ":bigtable_java_proto", - ":bigtable_resource_name_java_proto", - ] + _JAVA_GRPC_DEPS, + ], ) -[java_test( - name = test_name, - test_class = test_name, +java_gapic_test( + name = "bigtable_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.bigtable.data.v2.BaseBigtableDataClientTest", + ], runtime_deps = [":bigtable_java_gapic_test"], -) for test_name in [ - "com.google.cloud.bigtable.data.v2.BaseBigtableDataClientTest", -]] +) -# Opensource Packages +# Open Source Packages java_gapic_assembly_gradle_pkg( name = "google-cloud-bigtable-v2-java", - client_deps = [":bigtable_java_gapic"], - client_group = "com.google.cloud", - client_test_deps = [":bigtable_java_gapic_test"], - grpc_deps = [":bigtable_java_grpc"], - grpc_group = "com.google.api.grpc", - proto_deps = [ + deps = [ + ":bigtable_java_gapic", + ":bigtable_java_grpc", ":bigtable_java_proto", ":bigtable_proto", - ":bigtable_resource_name_java_proto", - ] + _JAVA_GRPC_DEPS, - version = "0.0.0-SNAPSHOT", + ], ) ############################################################################## @@ -99,10 +94,10 @@ java_gapic_assembly_gradle_pkg( ############################################################################## load( "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", "go_proto_library", "go_test", - "go_gapic_library", - "go_gapic_assembly_pkg", ) go_proto_library( @@ -118,11 +113,13 @@ go_proto_library( go_gapic_library( name = "bigtable_go_gapic", - src = ":bigtable_proto_with_info", - gapic_yaml = "bigtable_gapic.yaml", - importpath = "cloud.google.com/go/bigtable/apiv2", - service_yaml = "//google/bigtable:bigtable.yaml", - deps = [":bigtable_go_proto"], + srcs = [":bigtable_proto_with_info"], + grpc_service_config = "bigtable_grpc_service_config.json", + importpath = "cloud.google.com/go/bigtable/apiv2;bigtable", + service_yaml = "bigtable_v2.yaml", + deps = [ + ":bigtable_go_proto", + ], ) go_test( @@ -132,13 +129,249 @@ go_test( importpath = "cloud.google.com/go/bigtable/apiv2", ) -# Opensource Packages +# Open Source Packages go_gapic_assembly_pkg( name = "gapi-cloud-bigtable-v2-go", deps = [ ":bigtable_go_gapic", - ":bigtable_go_gapic_srcjar-smoke-test.srcjar", ":bigtable_go_gapic_srcjar-test.srcjar", ":bigtable_go_proto", ], ) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "bigtable_moved_proto", + srcs = [":bigtable_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/rpc:status_proto", + "@com_google_protobuf//:wrappers_proto", + ], +) + +py_proto_library( + name = "bigtable_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":bigtable_moved_proto"], +) + +py_grpc_library( + name = "bigtable_py_grpc", + srcs = [":bigtable_moved_proto"], + deps = [":bigtable_py_proto"], +) + +py_gapic_library( + name = "bigtable_py_gapic", + src = ":bigtable_proto_with_info", + gapic_yaml = "bigtable_gapic.yaml", + package = "google.bigtable.v2", + service_yaml = "bigtable_v2.yaml", + deps = [ + ":bigtable_py_grpc", + ":bigtable_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "bigtable-v2-py", + deps = [ + ":bigtable_py_gapic", + ":bigtable_py_grpc", + ":bigtable_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "bigtable_php_proto", + deps = [":bigtable_proto"], +) + +php_grpc_library( + name = "bigtable_php_grpc", + srcs = [":bigtable_proto"], + deps = [":bigtable_php_proto"], +) + +php_gapic_library( + name = "bigtable_php_gapic", + src = ":bigtable_proto_with_info", + gapic_yaml = "bigtable_gapic.yaml", + package = "google.bigtable.v2", + service_yaml = "bigtable_v2.yaml", + deps = [ + ":bigtable_php_grpc", + ":bigtable_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-bigtable-v2-php", + deps = [ + ":bigtable_php_gapic", + ":bigtable_php_grpc", + ":bigtable_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "bigtable_nodejs_gapic", + src = ":bigtable_proto_with_info", + gapic_yaml = "bigtable_gapic.yaml", + package = "google.bigtable.v2", + service_yaml = "bigtable_v2.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "bigtable-v2-nodejs", + deps = [ + ":bigtable_nodejs_gapic", + ":bigtable_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "bigtable_ruby_proto", + deps = [":bigtable_proto"], +) + +ruby_grpc_library( + name = "bigtable_ruby_grpc", + srcs = [":bigtable_proto"], + deps = [":bigtable_ruby_proto"], +) + +ruby_gapic_library( + name = "bigtable_ruby_gapic", + src = ":bigtable_proto_with_info", + gapic_yaml = "bigtable_gapic.yaml", + package = "google.bigtable.v2", + service_yaml = "bigtable_v2.yaml", + deps = [ + ":bigtable_ruby_grpc", + ":bigtable_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-bigtable-v2-ruby", + deps = [ + ":bigtable_ruby_gapic", + ":bigtable_ruby_grpc", + ":bigtable_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "bigtable_csharp_proto", + deps = [":bigtable_proto"], +) + +csharp_grpc_library( + name = "bigtable_csharp_grpc", + srcs = [":bigtable_proto"], + deps = [":bigtable_csharp_proto"], +) + +csharp_gapic_library( + name = "bigtable_csharp_gapic", + src = ":bigtable_proto_with_info", + gapic_yaml = "bigtable_gapic.yaml", + package = "google.bigtable.v2", + service_yaml = "bigtable_v2.yaml", + deps = [ + ":bigtable_csharp_grpc", + ":bigtable_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-bigtable-v2-csharp", + deps = [ + ":bigtable_csharp_gapic", + ":bigtable_csharp_grpc", + ":bigtable_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "cc_grpc_library", + "cc_proto_library") + +cc_proto_library( + name = "bigtable_cc_proto", + deps = [":bigtable_proto"], +) + +cc_grpc_library( + name = "bigtable_cc_grpc", + srcs = [":bigtable_proto"], + grpc_only = True, + deps = [":bigtable_cc_proto"], +) diff --git a/third_party/googleapis/google/bigtable/v2/bigtable.proto b/third_party/googleapis/google/bigtable/v2/bigtable.proto index 0ab763ba6..c54225ed3 100644 --- a/third_party/googleapis/google/bigtable/v2/bigtable.proto +++ b/third_party/googleapis/google/bigtable/v2/bigtable.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google Inc. +// Copyright 2019 Google LLC. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -17,6 +17,9 @@ syntax = "proto3"; package google.bigtable.v2; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/bigtable/v2/data.proto"; import "google/protobuf/wrappers.proto"; import "google/rpc/status.proto"; @@ -27,9 +30,22 @@ option java_multiple_files = true; option java_outer_classname = "BigtableProto"; option java_package = "com.google.bigtable.v2"; option php_namespace = "Google\\Cloud\\Bigtable\\V2"; +option (google.api.resource_definition) = { + type: "bigtable.googleapis.com/Table" + pattern: "projects/{project}/instances/{instance}/tables/{table}" +}; // Service for reading from and writing to existing Bigtable tables. service Bigtable { + option (google.api.default_host) = "bigtable.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/bigtable.data," + "https://www.googleapis.com/auth/bigtable.data.readonly," + "https://www.googleapis.com/auth/cloud-bigtable.data," + "https://www.googleapis.com/auth/cloud-bigtable.data.readonly," + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/cloud-platform.read-only"; + // Streams back the contents of all requested rows in key order, optionally // applying the same Reader filter to each. Depending on their size, // rows and cells may be broken up across multiple responses, but @@ -40,17 +56,20 @@ service Bigtable { post: "/v2/{table_name=projects/*/instances/*/tables/*}:readRows" body: "*" }; + option (google.api.method_signature) = "table_name"; + option (google.api.method_signature) = "table_name,app_profile_id"; } // Returns a sample of row keys in the table. The returned row keys will // delimit contiguous sections of the table of approximately equal size, // which can be used to break up the data for distributed tasks like // mapreduces. - rpc SampleRowKeys(SampleRowKeysRequest) - returns (stream SampleRowKeysResponse) { + rpc SampleRowKeys(SampleRowKeysRequest) returns (stream SampleRowKeysResponse) { option (google.api.http) = { get: "/v2/{table_name=projects/*/instances/*/tables/*}:sampleRowKeys" }; + option (google.api.method_signature) = "table_name"; + option (google.api.method_signature) = "table_name,app_profile_id"; } // Mutates a row atomically. Cells already present in the row are left @@ -60,6 +79,8 @@ service Bigtable { post: "/v2/{table_name=projects/*/instances/*/tables/*}:mutateRow" body: "*" }; + option (google.api.method_signature) = "table_name,row_key,mutations"; + option (google.api.method_signature) = "table_name,row_key,mutations,app_profile_id"; } // Mutates multiple rows in a batch. Each individual row is mutated @@ -70,15 +91,18 @@ service Bigtable { post: "/v2/{table_name=projects/*/instances/*/tables/*}:mutateRows" body: "*" }; + option (google.api.method_signature) = "table_name,entries"; + option (google.api.method_signature) = "table_name,entries,app_profile_id"; } // Mutates a row atomically based on the output of a predicate Reader filter. - rpc CheckAndMutateRow(CheckAndMutateRowRequest) - returns (CheckAndMutateRowResponse) { + rpc CheckAndMutateRow(CheckAndMutateRowRequest) returns (CheckAndMutateRowResponse) { option (google.api.http) = { post: "/v2/{table_name=projects/*/instances/*/tables/*}:checkAndMutateRow" body: "*" }; + option (google.api.method_signature) = "table_name,row_key,predicate_filter,true_mutations,false_mutations"; + option (google.api.method_signature) = "table_name,row_key,predicate_filter,true_mutations,false_mutations,app_profile_id"; } // Modifies a row atomically on the server. The method reads the latest @@ -86,21 +110,27 @@ service Bigtable { // entry based on pre-defined read/modify/write rules. The new value for the // timestamp is the greater of the existing timestamp or the current server // time. The method returns the new contents of all modified cells. - rpc ReadModifyWriteRow(ReadModifyWriteRowRequest) - returns (ReadModifyWriteRowResponse) { + rpc ReadModifyWriteRow(ReadModifyWriteRowRequest) returns (ReadModifyWriteRowResponse) { option (google.api.http) = { post: "/v2/{table_name=projects/*/instances/*/tables/*}:readModifyWriteRow" body: "*" }; + option (google.api.method_signature) = "table_name,row_key,rules"; + option (google.api.method_signature) = "table_name,row_key,rules,app_profile_id"; } } // Request message for Bigtable.ReadRows. message ReadRowsRequest { - // The unique name of the table from which to read. + // Required. The unique name of the table from which to read. // Values are of the form // `projects//instances//tables/
`. - string table_name = 1; + string table_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/Table" + } + ]; // This value specifies routing for replication. If not specified, the // "default" application profile will be used. @@ -172,6 +202,7 @@ message ReadRowsResponse { // to pre-allocate memory to hold the full cell value. int32 value_size = 7; + // Signals to the client concerning previous CellChunks received. oneof row_status { // Indicates that the client should drop all previous chunks for // `row_key`, as it will be re-read from the beginning. @@ -183,6 +214,7 @@ message ReadRowsResponse { } } + // A collection of a row's contents as part of the read request. repeated CellChunk chunks = 1; // Optionally the server might return the row key of the last row it @@ -197,10 +229,15 @@ message ReadRowsResponse { // Request message for Bigtable.SampleRowKeys. message SampleRowKeysRequest { - // The unique name of the table from which to sample row keys. + // Required. The unique name of the table from which to sample row keys. // Values are of the form // `projects//instances//tables/
`. - string table_name = 1; + string table_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/Table" + } + ]; // This value specifies routing for replication. If not specified, the // "default" application profile will be used. @@ -227,57 +264,71 @@ message SampleRowKeysResponse { // Request message for Bigtable.MutateRow. message MutateRowRequest { - // The unique name of the table to which the mutation should be applied. + // Required. The unique name of the table to which the mutation should be applied. // Values are of the form // `projects//instances//tables/
`. - string table_name = 1; + string table_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/Table" + } + ]; // This value specifies routing for replication. If not specified, the // "default" application profile will be used. string app_profile_id = 4; - // The key of the row to which the mutation should be applied. - bytes row_key = 2; + // Required. The key of the row to which the mutation should be applied. + bytes row_key = 2 [(google.api.field_behavior) = REQUIRED]; - // Changes to be atomically applied to the specified row. Entries are applied + // Required. Changes to be atomically applied to the specified row. Entries are applied // in order, meaning that earlier mutations can be masked by later ones. // Must contain at least one entry and at most 100000. - repeated Mutation mutations = 3; + repeated Mutation mutations = 3 [(google.api.field_behavior) = REQUIRED]; } // Response message for Bigtable.MutateRow. -message MutateRowResponse {} +message MutateRowResponse { + +} // Request message for BigtableService.MutateRows. message MutateRowsRequest { + // A mutation for a given row. message Entry { // The key of the row to which the `mutations` should be applied. bytes row_key = 1; - // Changes to be atomically applied to the specified row. Mutations are + // Required. Changes to be atomically applied to the specified row. Mutations are // applied in order, meaning that earlier mutations can be masked by // later ones. // You must specify at least one mutation. - repeated Mutation mutations = 2; + repeated Mutation mutations = 2 [(google.api.field_behavior) = REQUIRED]; } - // The unique name of the table to which the mutations should be applied. - string table_name = 1; + // Required. The unique name of the table to which the mutations should be applied. + string table_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/Table" + } + ]; // This value specifies routing for replication. If not specified, the // "default" application profile will be used. string app_profile_id = 3; - // The row keys and corresponding mutations to be applied in bulk. + // Required. The row keys and corresponding mutations to be applied in bulk. // Each entry is applied as an atomic mutation, but the entries may be // applied in arbitrary order (even between entries for the same row). // At least one entry must be specified, and in total the entries can // contain at most 100000 mutations. - repeated Entry entries = 2; + repeated Entry entries = 2 [(google.api.field_behavior) = REQUIRED]; } // Response message for BigtableService.MutateRows. message MutateRowsResponse { + // The result of applying a passed mutation in the original request. message Entry { // The index into the original request's `entries` list of the Entry // for which a result is being reported. @@ -296,18 +347,23 @@ message MutateRowsResponse { // Request message for Bigtable.CheckAndMutateRow. message CheckAndMutateRowRequest { - // The unique name of the table to which the conditional mutation should be + // Required. The unique name of the table to which the conditional mutation should be // applied. // Values are of the form // `projects//instances//tables/
`. - string table_name = 1; + string table_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/Table" + } + ]; // This value specifies routing for replication. If not specified, the // "default" application profile will be used. string app_profile_id = 7; - // The key of the row to which the conditional mutation should be applied. - bytes row_key = 2; + // Required. The key of the row to which the conditional mutation should be applied. + bytes row_key = 2 [(google.api.field_behavior) = REQUIRED]; // The filter to be applied to the contents of the specified row. Depending // on whether or not any results are yielded, either `true_mutations` or @@ -339,23 +395,28 @@ message CheckAndMutateRowResponse { // Request message for Bigtable.ReadModifyWriteRow. message ReadModifyWriteRowRequest { - // The unique name of the table to which the read/modify/write rules should be + // Required. The unique name of the table to which the read/modify/write rules should be // applied. // Values are of the form // `projects//instances//tables/
`. - string table_name = 1; + string table_name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigtable.googleapis.com/Table" + } + ]; // This value specifies routing for replication. If not specified, the // "default" application profile will be used. string app_profile_id = 4; - // The key of the row to which the read/modify/write rules should be applied. - bytes row_key = 2; + // Required. The key of the row to which the read/modify/write rules should be applied. + bytes row_key = 2 [(google.api.field_behavior) = REQUIRED]; - // Rules specifying how the specified row's contents are to be transformed + // Required. Rules specifying how the specified row's contents are to be transformed // into writes. Entries are applied in order, meaning that earlier rules will // affect the results of later ones. - repeated ReadModifyWriteRule rules = 3; + repeated ReadModifyWriteRule rules = 3 [(google.api.field_behavior) = REQUIRED]; } // Response message for Bigtable.ReadModifyWriteRow. diff --git a/third_party/googleapis/google/bigtable/v2/bigtable_gapic.legacy.yaml b/third_party/googleapis/google/bigtable/v2/bigtable_gapic.legacy.yaml new file mode 100644 index 000000000..d88eee9fd --- /dev/null +++ b/third_party/googleapis/google/bigtable/v2/bigtable_gapic.legacy.yaml @@ -0,0 +1,198 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 1.0.0 +language_settings: + java: + package_name: com.google.cloud.bigtable.data.v2 + interface_names: + google.bigtable.v2.Bigtable: BaseBigtableData + python: + package_name: google.cloud.bigtable_v2.gapic + go: + package_name: cloud.google.com/go/bigtable/apiv2 + csharp: + package_name: Google.Cloud.Bigtable.V2 + interface_names: + google.bigtable.v2.Bigtable: BigtableServiceApi + ruby: + package_name: Google::Cloud::Bigtable::V2 + release_level: GA + php: + package_name: Google\Cloud\Bigtable\V2 + nodejs: + package_name: bigtable.v2 + domain_layer_location: google-cloud +interfaces: +- name: google.bigtable.v2.Bigtable + collections: + - name_pattern: projects/{project}/instances/{instance}/tables/{table} + entity_name: table + language_overrides: + - language: csharp + common_resource_name: Google.Cloud.Bigtable.Common.V2.TableName + retry_codes_def: + - name: idempotent + retry_codes: + - UNAVAILABLE + - DEADLINE_EXCEEDED + - name: non_idempotent + retry_codes: [] + retry_params_def: + - name: idempotent_params + initial_retry_delay_millis: 10 + retry_delay_multiplier: 2 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + - name: non_idempotent_params + initial_retry_delay_millis: 10 + retry_delay_multiplier: 2 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 20000 + - name: read_rows_params + initial_retry_delay_millis: 10 + retry_delay_multiplier: 2 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 300000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 300000 + total_timeout_millis: 43200000 + - name: mutate_rows_params + initial_retry_delay_millis: 10 + retry_delay_multiplier: 2 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 60000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 60000 + total_timeout_millis: 600000 + methods: + - name: ReadRows + flattening: + groups: + - parameters: + - table_name + required_fields: + - table_name + retry_codes_name: idempotent + retry_params_name: read_rows_params + field_name_patterns: + table_name: table + resource_name_treatment: STATIC_TYPES + timeout_millis: 43200000 + header_request_params: + - table_name + - name: SampleRowKeys + flattening: + groups: + - parameters: + - table_name + required_fields: + - table_name + retry_codes_name: idempotent + retry_params_name: idempotent_params + field_name_patterns: + table_name: table + timeout_millis: 20000 + resource_name_treatment: STATIC_TYPES + header_request_params: + - table_name + - name: MutateRow + flattening: + groups: + - parameters: + - table_name + - row_key + - mutations + required_fields: + - table_name + - row_key + - mutations + retry_codes_name: idempotent + retry_params_name: idempotent_params + field_name_patterns: + table_name: table + resource_name_treatment: STATIC_TYPES + timeout_millis: 20000 + header_request_params: + - table_name + - name: MutateRows + flattening: + groups: + - parameters: + - table_name + - entries + required_fields: + - table_name + - entries + retry_codes_name: idempotent + retry_params_name: mutate_rows_params + field_name_patterns: + table_name: table + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + header_request_params: + - table_name + - name: CheckAndMutateRow + flattening: + groups: + - parameters: + - table_name + - row_key + - predicate_filter + - true_mutations + - false_mutations + # Note that one of {true_mutations,false_mutations} must be specified, but + # since they are not both required, we leave them as optional params. + required_fields: + - table_name + - row_key + retry_codes_name: non_idempotent + retry_params_name: non_idempotent_params + field_name_patterns: + table_name: table + resource_name_treatment: STATIC_TYPES + timeout_millis: 20000 + header_request_params: + - table_name + - name: ReadModifyWriteRow + flattening: + groups: + - parameters: + - table_name + - row_key + - rules + required_fields: + - table_name + - row_key + - rules + retry_codes_name: non_idempotent + retry_params_name: non_idempotent_params + field_name_patterns: + table_name: table + resource_name_treatment: STATIC_TYPES + timeout_millis: 20000 + header_request_params: + - table_name +resource_name_generation: +- message_name: ReadRowsRequest + field_entity_map: + table_name: table +- message_name: SampleRowKeysRequest + field_entity_map: + table_name: table +- message_name: MutateRowRequest + field_entity_map: + table_name: table +- message_name: MutateRowsRequest + field_entity_map: + table_name: table +- message_name: CheckAndMutateRowRequest + field_entity_map: + table_name: table +- message_name: ReadModifyWriteRowRequest + field_entity_map: + table_name: table diff --git a/third_party/googleapis/google/bigtable/v2/bigtable_gapic.yaml b/third_party/googleapis/google/bigtable/v2/bigtable_gapic.yaml index c34fe42b3..792c288ca 100644 --- a/third_party/googleapis/google/bigtable/v2/bigtable_gapic.yaml +++ b/third_party/googleapis/google/bigtable/v2/bigtable_gapic.yaml @@ -1,5 +1,5 @@ type: com.google.api.codegen.ConfigProto -config_schema_version: 1.0.0 +config_schema_version: 2.0.0 language_settings: java: package_name: com.google.cloud.bigtable.data.v2 @@ -15,7 +15,7 @@ language_settings: google.bigtable.v2.Bigtable: BigtableServiceApi ruby: package_name: Google::Cloud::Bigtable::V2 - release_level: BETA + release_level: GA php: package_name: Google\Cloud\Bigtable\V2 nodejs: @@ -24,8 +24,7 @@ language_settings: interfaces: - name: google.bigtable.v2.Bigtable collections: - - name_pattern: projects/{project}/instances/{instance}/tables/{table} - entity_name: table + - entity_name: table language_overrides: - language: csharp common_resource_name: Google.Cloud.Bigtable.Common.V2.TableName @@ -37,146 +36,60 @@ interfaces: - name: non_idempotent retry_codes: [] retry_params_def: - - name: default - initial_retry_delay_millis: 100 - retry_delay_multiplier: 1.3 + - name: idempotent_params + initial_retry_delay_millis: 10 + retry_delay_multiplier: 2 max_retry_delay_millis: 60000 initial_rpc_timeout_millis: 20000 rpc_timeout_multiplier: 1 max_rpc_timeout_millis: 20000 total_timeout_millis: 600000 - - name: streaming - initial_retry_delay_millis: 100 - retry_delay_multiplier: 1.3 + - name: non_idempotent_params + initial_retry_delay_millis: 10 + retry_delay_multiplier: 2 max_retry_delay_millis: 60000 initial_rpc_timeout_millis: 20000 rpc_timeout_multiplier: 1 max_rpc_timeout_millis: 20000 - total_timeout_millis: 3600000 + total_timeout_millis: 20000 + - name: read_rows_params + initial_retry_delay_millis: 10 + retry_delay_multiplier: 2 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 300000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 300000 + total_timeout_millis: 43200000 + - name: mutate_rows_params + initial_retry_delay_millis: 10 + retry_delay_multiplier: 2 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 60000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 60000 + total_timeout_millis: 600000 methods: - name: ReadRows - flattening: - groups: - - parameters: - - table_name - required_fields: - - table_name retry_codes_name: idempotent - retry_params_name: streaming - field_name_patterns: - table_name: table - resource_name_treatment: STATIC_TYPES - timeout_millis: 3600000 - header_request_params: - - table_name + retry_params_name: read_rows_params + timeout_millis: 43200000 - name: SampleRowKeys - flattening: - groups: - - parameters: - - table_name - required_fields: - - table_name retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - table_name: table - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - header_request_params: - - table_name + retry_params_name: idempotent_params + timeout_millis: 20000 - name: MutateRow - flattening: - groups: - - parameters: - - table_name - - row_key - - mutations - required_fields: - - table_name - - row_key - - mutations retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - table_name: table - resource_name_treatment: STATIC_TYPES - timeout_millis: 60000 - header_request_params: - - table_name + retry_params_name: idempotent_params + timeout_millis: 20000 - name: MutateRows - flattening: - groups: - - parameters: - - table_name - - entries - required_fields: - - table_name - - entries retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - table_name: table - resource_name_treatment: STATIC_TYPES + retry_params_name: mutate_rows_params timeout_millis: 60000 - header_request_params: - - table_name - name: CheckAndMutateRow - flattening: - groups: - - parameters: - - table_name - - row_key - - predicate_filter - - true_mutations - - false_mutations - # Note that one of {true_mutations,false_mutations} must be specified, but - # since they are not both required, we leave them as optional params. - required_fields: - - table_name - - row_key retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - table_name: table - resource_name_treatment: STATIC_TYPES - timeout_millis: 60000 - header_request_params: - - table_name + retry_params_name: non_idempotent_params + timeout_millis: 20000 - name: ReadModifyWriteRow - flattening: - groups: - - parameters: - - table_name - - row_key - - rules - required_fields: - - table_name - - row_key - - rules retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - table_name: table - resource_name_treatment: STATIC_TYPES - timeout_millis: 60000 - header_request_params: - - table_name -resource_name_generation: -- message_name: ReadRowsRequest - field_entity_map: - table_name: table -- message_name: SampleRowKeysRequest - field_entity_map: - table_name: table -- message_name: MutateRowRequest - field_entity_map: - table_name: table -- message_name: MutateRowsRequest - field_entity_map: - table_name: table -- message_name: CheckAndMutateRowRequest - field_entity_map: - table_name: table -- message_name: ReadModifyWriteRowRequest - field_entity_map: - table_name: table + retry_params_name: non_idempotent_params + timeout_millis: 20000 diff --git a/third_party/googleapis/google/bigtable/v2/bigtable_grpc_service_config.json b/third_party/googleapis/google/bigtable/v2/bigtable_grpc_service_config.json new file mode 100755 index 000000000..d6a182eb5 --- /dev/null +++ b/third_party/googleapis/google/bigtable/v2/bigtable_grpc_service_config.json @@ -0,0 +1,78 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.bigtable.v2.Bigtable", + "method": "ReadRows" + } + ], + "timeout": "43200s", + "retryPolicy": { + "maxAttempts": 5, + "initialBackoff": "0.010s", + "maxBackoff": "60s", + "backoffMultiplier": 2, + "retryableStatusCodes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ] + } + }, + { + "name": [ + { + "service": "google.bigtable.v2.Bigtable", + "method": "SampleRowKeys" + }, + { + "service": "google.bigtable.v2.Bigtable", + "method": "MutateRow" + } + ], + "timeout": "20s", + "retryPolicy": { + "maxAttempts": 5, + "initialBackoff": "0.010s", + "maxBackoff": "60s", + "backoffMultiplier": 2, + "retryableStatusCodes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ] + } + }, + { + "name": [ + { + "service": "google.bigtable.v2.Bigtable", + "method": "MutateRows" + } + ], + "timeout": "60s", + "retryPolicy": { + "maxAttempts": 5, + "initialBackoff": "0.010s", + "maxBackoff": "60s", + "backoffMultiplier": 2, + "retryableStatusCodes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ] + } + }, + { + "name": [ + { + "service": "google.bigtable.v2.Bigtable", + "method": "CheckAndMutateRow" + }, + { + "service": "google.bigtable.v2.Bigtable", + "method": "ReadModifyWriteRow" + } + ], + "timeout": "20s" + } + ] +} diff --git a/third_party/googleapis/google/bigtable/bigtable.yaml b/third_party/googleapis/google/bigtable/v2/bigtable_v2.yaml similarity index 60% rename from third_party/googleapis/google/bigtable/bigtable.yaml rename to third_party/googleapis/google/bigtable/v2/bigtable_v2.yaml index ba5393cd7..44f5f5f35 100644 --- a/third_party/googleapis/google/bigtable/bigtable.yaml +++ b/third_party/googleapis/google/bigtable/v2/bigtable_v2.yaml @@ -1,5 +1,5 @@ type: google.api.Service -config_version: 0 +config_version: 1 name: bigtable.googleapis.com title: Cloud Bigtable API @@ -13,15 +13,22 @@ documentation: authentication: rules: - - selector: '*' + - selector: 'google.bigtable.v2.Bigtable.*' oauth: canonical_scopes: |- https://www.googleapis.com/auth/bigtable.data, https://www.googleapis.com/auth/cloud-bigtable.data, https://www.googleapis.com/auth/cloud-platform - - selector: |- - google.bigtable.v2.Bigtable.ReadRows, - google.bigtable.v2.Bigtable.SampleRowKeys + - selector: google.bigtable.v2.Bigtable.ReadRows + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/bigtable.data, + https://www.googleapis.com/auth/bigtable.data.readonly, + https://www.googleapis.com/auth/cloud-bigtable.data, + https://www.googleapis.com/auth/cloud-bigtable.data.readonly, + https://www.googleapis.com/auth/cloud-platform, + https://www.googleapis.com/auth/cloud-platform.read-only + - selector: google.bigtable.v2.Bigtable.SampleRowKeys oauth: canonical_scopes: |- https://www.googleapis.com/auth/bigtable.data, diff --git a/third_party/googleapis/google/bigtable/v2/data.proto b/third_party/googleapis/google/bigtable/v2/data.proto index d0aab0b63..8fd0c15cb 100644 --- a/third_party/googleapis/google/bigtable/v2/data.proto +++ b/third_party/googleapis/google/bigtable/v2/data.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google Inc. +// Copyright 2019 Google LLC. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,6 +11,7 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. +// syntax = "proto3"; @@ -485,7 +486,9 @@ message Mutation { } // A Mutation which deletes all cells from the containing row. - message DeleteFromRow {} + message DeleteFromRow { + + } // Which of the possible Mutation types to apply. oneof mutation { diff --git a/third_party/googleapis/google/chromeos/moblab/BUILD.bazel b/third_party/googleapis/google/chromeos/moblab/BUILD.bazel new file mode 100644 index 000000000..a87c57fec --- /dev/null +++ b/third_party/googleapis/google/chromeos/moblab/BUILD.bazel @@ -0,0 +1 @@ +exports_files(glob(["*.yaml"])) diff --git a/third_party/googleapis/google/chromeos/moblab/v1beta1/BUILD.bazel b/third_party/googleapis/google/chromeos/moblab/v1beta1/BUILD.bazel new file mode 100644 index 000000000..03f5ca267 --- /dev/null +++ b/third_party/googleapis/google/chromeos/moblab/v1beta1/BUILD.bazel @@ -0,0 +1,368 @@ +# This file was automatically generated by BuildFileGenerator + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") +load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") + +proto_library( + name = "moblab_proto", + srcs = [ + "build_service.proto", + "resources.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/longrunning:operations_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +proto_library_with_info( + name = "moblab_proto_with_info", + deps = [ + ":moblab_proto", + "//google/cloud:common_resources_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", + "java_proto_library", +) + +java_proto_library( + name = "moblab_java_proto", + deps = [":moblab_proto"], +) + +java_grpc_library( + name = "moblab_java_grpc", + srcs = [":moblab_proto"], + deps = [":moblab_java_proto"], +) + +java_gapic_library( + name = "moblab_java_gapic", + src = ":moblab_proto_with_info", + gapic_yaml = "chromeosmoblab_gapic.yaml", + package = "google.chromeos.moblab.v1beta1", + service_yaml = "chromeosmoblab_v1beta1.yaml", + test_deps = [ + ":moblab_java_grpc", + ], + deps = [ + ":moblab_java_proto", + ], +) + +java_gapic_test( + name = "moblab_java_gapic_test_suite", + test_classes = [ + "com.google.chromeos.moblab.v1beta1.BuildServiceClientTest", + ], + runtime_deps = [":moblab_java_gapic_test"], +) + +# Open Source Packages +java_gapic_assembly_gradle_pkg( + name = "google-cloud-chromeos-moblab-v1beta1-java", + deps = [ + ":moblab_java_gapic", + ":moblab_java_grpc", + ":moblab_java_proto", + ":moblab_proto", + ], +) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", + "go_proto_library", + "go_test", +) + +go_proto_library( + name = "moblab_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/chromeos/moblab/v1beta1", + protos = [":moblab_proto"], + deps = [ + "//google/api:annotations_go_proto", + "//google/longrunning:longrunning_go_proto", + ], +) + +go_gapic_library( + name = "moblab_go_gapic", + srcs = [":moblab_proto_with_info"], + grpc_service_config = "moblab_grpc_service_config.json", + importpath = "google.golang.org/google/chromeos/moblab/v1beta1;moblab", + service_yaml = "chromeosmoblab_v1beta1.yaml", + deps = [ + ":moblab_go_proto", + "//google/longrunning:longrunning_go_gapic", + "//google/longrunning:longrunning_go_proto", + "@com_google_cloud_go//longrunning:go_default_library", + "@com_google_cloud_go//longrunning/autogen:go_default_library", + ], +) + +go_test( + name = "moblab_go_gapic_test", + srcs = [":moblab_go_gapic_srcjar_test"], + embed = [":moblab_go_gapic"], + importpath = "google.golang.org/google/chromeos/moblab/v1beta1", +) + +# Open Source Packages +go_gapic_assembly_pkg( + name = "gapi-cloud-chromeos-moblab-v1beta1-go", + deps = [ + ":moblab_go_gapic", + ":moblab_go_gapic_srcjar-test.srcjar", + ":moblab_go_proto", + ], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "moblab_moved_proto", + srcs = [":moblab_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/longrunning:operations_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +py_proto_library( + name = "moblab_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":moblab_moved_proto"], +) + +py_grpc_library( + name = "moblab_py_grpc", + srcs = [":moblab_moved_proto"], + deps = [":moblab_py_proto"], +) + +py_gapic_library( + name = "moblab_py_gapic", + src = ":moblab_proto_with_info", + gapic_yaml = "chromeosmoblab_gapic.yaml", + package = "google.chromeos.moblab.v1beta1", + service_yaml = "chromeosmoblab_v1beta1.yaml", + deps = [ + ":moblab_py_grpc", + ":moblab_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "chromeos-moblab-v1beta1-py", + deps = [ + ":moblab_py_gapic", + ":moblab_py_grpc", + ":moblab_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "moblab_php_proto", + deps = [":moblab_proto"], +) + +php_grpc_library( + name = "moblab_php_grpc", + srcs = [":moblab_proto"], + deps = [":moblab_php_proto"], +) + +php_gapic_library( + name = "moblab_php_gapic", + src = ":moblab_proto_with_info", + gapic_yaml = "chromeosmoblab_gapic.yaml", + package = "google.chromeos.moblab.v1beta1", + service_yaml = "chromeosmoblab_v1beta1.yaml", + deps = [ + ":moblab_php_grpc", + ":moblab_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-chromeos-moblab-v1beta1-php", + deps = [ + ":moblab_php_gapic", + ":moblab_php_grpc", + ":moblab_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "moblab_nodejs_gapic", + src = ":moblab_proto_with_info", + gapic_yaml = "chromeosmoblab_gapic.yaml", + package = "google.chromeos.moblab.v1beta1", + service_yaml = "chromeosmoblab_v1beta1.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "chromeos-moblab-v1beta1-nodejs", + deps = [ + ":moblab_nodejs_gapic", + ":moblab_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "moblab_ruby_proto", + deps = [":moblab_proto"], +) + +ruby_grpc_library( + name = "moblab_ruby_grpc", + srcs = [":moblab_proto"], + deps = [":moblab_ruby_proto"], +) + +ruby_gapic_library( + name = "moblab_ruby_gapic", + src = ":moblab_proto_with_info", + gapic_yaml = "chromeosmoblab_gapic.yaml", + package = "google.chromeos.moblab.v1beta1", + service_yaml = "chromeosmoblab_v1beta1.yaml", + deps = [ + ":moblab_ruby_grpc", + ":moblab_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-chromeos-moblab-v1beta1-ruby", + deps = [ + ":moblab_ruby_gapic", + ":moblab_ruby_grpc", + ":moblab_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "moblab_csharp_proto", + deps = [":moblab_proto"], +) + +csharp_grpc_library( + name = "moblab_csharp_grpc", + srcs = [":moblab_proto"], + deps = [":moblab_csharp_proto"], +) + +csharp_gapic_library( + name = "moblab_csharp_gapic", + src = ":moblab_proto_with_info", + gapic_yaml = "chromeosmoblab_gapic.yaml", + package = "google.chromeos.moblab.v1beta1", + service_yaml = "chromeosmoblab_v1beta1.yaml", + deps = [ + ":moblab_csharp_grpc", + ":moblab_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-chromeos-moblab-v1beta1-csharp", + deps = [ + ":moblab_csharp_gapic", + ":moblab_csharp_grpc", + ":moblab_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/chromeos/moblab/v1beta1/build_service.proto b/third_party/googleapis/google/chromeos/moblab/v1beta1/build_service.proto new file mode 100644 index 000000000..a39a3989c --- /dev/null +++ b/third_party/googleapis/google/chromeos/moblab/v1beta1/build_service.proto @@ -0,0 +1,186 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.chromeos.moblab.v1beta1; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/chromeos/moblab/v1beta1/resources.proto"; +import "google/longrunning/operations.proto"; +import "google/protobuf/field_mask.proto"; +import "google/protobuf/timestamp.proto"; + +option go_package = "google.golang.org/genproto/googleapis/chromeos/moblab/v1beta1;moblab"; +option java_multiple_files = true; +option java_outer_classname = "BuildServiceProto"; +option java_package = "com.google.chromeos.moblab.v1beta1"; +option optimize_for = SPEED; + +// Manages Chrome OS build services. +service BuildService { + option (google.api.default_host) = "chromeosmoblab.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/moblabapi"; + + // Lists all builds for the given build target and model in descending order + // for the milestones and build versions. + rpc ListBuilds(ListBuildsRequest) returns (ListBuildsResponse) { + option (google.api.http) = { + get: "/v1beta1/{parent=buildTargets/*/models/*}/builds" + }; + option (google.api.method_signature) = "parent"; + } + + // Checks the stage status for a given build artifact in a partner Google + // Cloud Storage bucket. + rpc CheckBuildStageStatus(CheckBuildStageStatusRequest) returns (CheckBuildStageStatusResponse) { + option (google.api.http) = { + get: "/v1beta1/{name=buildTargets/*/models/*/builds/*/artifacts/*}:check" + }; + option (google.api.method_signature) = "name"; + } + + // Stages a given build artifact from a internal Google Cloud Storage bucket + // to a partner Google Cloud Storage bucket. If any of objects has already + // been copied, it will overwrite the previous objects. Operation + rpc StageBuild(StageBuildRequest) returns (google.longrunning.Operation) { + option (google.api.http) = { + post: "/v1beta1/{name=buildTargets/*/models/*/builds/*/artifacts/*}:stage" + body: "*" + }; + option (google.api.method_signature) = "name"; + option (google.longrunning.operation_info) = { + response_type: "StageBuildResponse" + metadata_type: "StageBuildMetadata" + }; + } +} + +// Request message for listing builds. +// NEXT_TAG: 7 +message ListBuildsRequest { + // Required. The full resource name of the model. The model id is the same as + // the build target id for non-unified builds. + // For example, + // 'buildTargets/octopus/models/bobba'. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "chromeosmoblab.googleapis.com/Model" + } + ]; + + // Optional. The number of builds to return in a page. + int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. A page token, received from a previous `ListBuilds` call. Provide this to + // retrieve the subsequent page. + string page_token = 3 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Filter that specifies value constraints of fields. For example, the + // filter can be set as "filter='milestone=milestones/80'" to only select + // builds in milestone 80. + string filter = 4 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Read mask that specifies which Build fields to return. If empty, all Build + // fields will be returned. + // Valid fields: name, milestone, build_version. + // For example, if the read_mask is set as "read_mask='milestone'", the + // ListBuilds will return a list of Builds object with only the milestone + // field. + google.protobuf.FieldMask read_mask = 5 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The operation that groups by all the Build fields specified in the read + // mask. The group_by field should be the same as the read_mask field in + // convention of SQL. + google.protobuf.FieldMask group_by = 6 [(google.api.field_behavior) = OPTIONAL]; +} + +// Response message for listing builds. +// NEXT_TAG: 4 +message ListBuildsResponse { + // The list of builds. + repeated Build builds = 1; + + // Token to retrieve the next page of builds. If this field is omitted, there + // are no subsequent pages. + string next_page_token = 2; + + // Total number of builds. + int32 total_size = 3; +} + +// Request message for checking if the build artifact is staged. +message CheckBuildStageStatusRequest { + // Required. The full resource name of the build artifact. + // For example, + // 'buildTargets/octopus/models/bobba/builds/12607.6.0/artifacts/chromeos-moblab-peng-staging'. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "chromeosmoblab.googleapis.com/BuildArtifact" + } + ]; +} + +// Response message for checking the stage status of a build artifact. +// NEXT_TAG: 4 +message CheckBuildStageStatusResponse { + // The status to represent if the build is staged or not. + bool is_build_staged = 1; + + // The staged build artifact in the destination bucket. + BuildArtifact staged_build_artifact = 2; + + // The source build artifact in the source bucket. + BuildArtifact source_build_artifact = 3; +} + +// Request message for staging a build artifact. +message StageBuildRequest { + // Required. The full resource name of the build artifact. + // For example, + // 'buildTargets/octopus/models/bobba/builds/12607.6.0/artifacts/chromeos-moblab-peng-staging'. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "chromeosmoblab.googleapis.com/BuildArtifact" + } + ]; +} + +// Response message for staging a build artifact. +message StageBuildResponse { + // The staged build in the destination bucket. + BuildArtifact staged_build_artifact = 1; +} + +// Metadata message for staging a build artifact. +// NEXT_TAG: 4 +message StageBuildMetadata { + // Approximate percentage of progress, e.g. "50" means 50%. + float progress_percent = 1; + + // Build stage start time. + google.protobuf.Timestamp start_time = 2; + + // Build stage end time. + google.protobuf.Timestamp end_time = 3; +} diff --git a/third_party/googleapis/google/chromeos/moblab/v1beta1/chromeosmoblab_gapic.yaml b/third_party/googleapis/google/chromeos/moblab/v1beta1/chromeosmoblab_gapic.yaml new file mode 100644 index 000000000..602b7eacb --- /dev/null +++ b/third_party/googleapis/google/chromeos/moblab/v1beta1/chromeosmoblab_gapic.yaml @@ -0,0 +1,17 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 2.0.0 +language_settings: + java: + package_name: com.google.chromeos.moblab.v1beta1 + python: + package_name: google.chromeos.moblab_v1beta1.gapic + go: + package_name: cloud.google.com/go/chromeos/moblab/apiv1beta1 + csharp: + package_name: Google.Chromeos.Moblab.V1beta1 + ruby: + package_name: Google::Chromeos::Moblab::V1beta1 + php: + package_name: Google\Chromeos\Moblab\V1beta1 + nodejs: + package_name: google.chromeos.moblab.v1beta1 diff --git a/third_party/googleapis/google/chromeos/moblab/v1beta1/chromeosmoblab_v1beta1.yaml b/third_party/googleapis/google/chromeos/moblab/v1beta1/chromeosmoblab_v1beta1.yaml new file mode 100644 index 000000000..64a8aa6b4 --- /dev/null +++ b/third_party/googleapis/google/chromeos/moblab/v1beta1/chromeosmoblab_v1beta1.yaml @@ -0,0 +1,26 @@ +type: google.api.Service +config_version: 3 +name: chromeosmoblab.googleapis.com +title: Chrome OS Moblab API + +control: + environment: servicecontrol.googleapis.com + +apis: +- name: google.chromeos.moblab.v1beta1.BuildService + +backend: + rules: + - selector: 'google.chromeos.moblab.v1beta1.BuildService.*' + deadline: 10.0 + +documentation: + summary: |- + Moblab API is an external-facing API that Moblabs deployed in remote external labs of Chrome OS + partners can communicate with for various testing needs. + +authentication: + rules: + - selector: 'google.chromeos.moblab.v1beta1.BuildService.*' + oauth: + canonical_scopes: https://www.googleapis.com/auth/moblabapi diff --git a/third_party/googleapis/google/chromeos/moblab/v1beta1/moblab_grpc_service_config.json b/third_party/googleapis/google/chromeos/moblab/v1beta1/moblab_grpc_service_config.json new file mode 100644 index 000000000..5c9de9d18 --- /dev/null +++ b/third_party/googleapis/google/chromeos/moblab/v1beta1/moblab_grpc_service_config.json @@ -0,0 +1,35 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.chromeos.moblab.v1beta1.BuildService", + "method": "CheckBuildStageStatus" + }, + { + "service": "google.chromeos.moblab.v1beta1.BuildService", + "method": "ListBuilds" + } + ], + "timeout": "60s", + "retryPolicy": { + "maxAttempts": 5, + "initialBackoff": "1s", + "maxBackoff": "10s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE" + ] + } + }, + { + "name": [ + { + "service": "google.chromeos.moblab.v1beta1.BuildService", + "method": "StageBuild" + } + ], + "timeout": "60s" + } + ] +} \ No newline at end of file diff --git a/third_party/googleapis/google/chromeos/moblab/v1beta1/resources.proto b/third_party/googleapis/google/chromeos/moblab/v1beta1/resources.proto new file mode 100644 index 000000000..290268935 --- /dev/null +++ b/third_party/googleapis/google/chromeos/moblab/v1beta1/resources.proto @@ -0,0 +1,118 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.chromeos.moblab.v1beta1; + +import "google/api/resource.proto"; + +option go_package = "google.golang.org/genproto/googleapis/chromeos/moblab/v1beta1;moblab"; +option java_multiple_files = true; +option java_outer_classname = "ResourcesProto"; +option java_package = "com.google.chromeos.moblab.v1beta1"; +option optimize_for = SPEED; + +// Resource that represents a build target. +message BuildTarget { + option (google.api.resource) = { + type: "chromeosmoblab.googleapis.com/BuildTarget" + pattern: "buildTargets/{build_target}" + }; + + // The resource name of the build target. + // Format: buildTargets/{build_target} + string name = 1; +} + +// Resource that represents a model. Each model belongs to a build target. For +// non-unified build, the model name is the same as its build target name. +message Model { + option (google.api.resource) = { + type: "chromeosmoblab.googleapis.com/Model" + pattern: "buildTargets/{build_target}/models/{model}" + }; + + // The resource name of the model. + // Format: buildTargets/{build_target}/models/{model} + string name = 1; +} + +// Resource that represents a chrome OS milestone. +message Milestone { + option (google.api.resource) = { + type: "chromeosmoblab.googleapis.com/Milestone" + pattern: "milestones/{milestone}" + }; + + // The resource name of the milestone. + // Format: milestones/{milestone} + string name = 1; +} + +// Resource that represents a build for the given build target, model, milestone +// and build version. +// NEXT_TAG: 4 +message Build { + option (google.api.resource) = { + type: "chromeosmoblab.googleapis.com/Build" + pattern: "buildTargets/{build_target}/models/{model}/builds/{build}" + }; + + // The resource name of the build. + // Format: buildTargets/{build_target}/models/{model}/builds/{build} + // Example: buildTargets/octopus/models/bobba/builds/1234.0.0 + string name = 1; + + // The milestone that owns the build. + // Format: milestones/{milestone} + string milestone = 2 [(google.api.resource_reference) = { + type: "chromeosmoblab.googleapis.com/Milestone" + }]; + + // The build version of the build, e.g. 1234.0.0. + string build_version = 3; +} + +// Resource that represents a build artifact stored in Google Cloud Storage for +// the given build target, model, build version and bucket. NEXT_TAG: 6 +message BuildArtifact { + option (google.api.resource) = { + type: "chromeosmoblab.googleapis.com/BuildArtifact" + pattern: "buildTargets/{build_target}/models/{model}/builds/{build}/artifacts/{artifact}" + }; + + // The resource name of the build artifact. + // Format: + // buildTargets/{build_target}/models/{model}/builds/{build}/artifacts/{artifact} + // Example: + // buildTargets/octopus/models/bobba/builds/1234.0.0/artifacts/chromeos-moblab-peng-staging + string name = 1; + + // The build metadata of the build artifact. + string build = 2 [(google.api.resource_reference) = { + type: "chromeosmoblab.googleapis.com/Build" + }]; + + // The bucket that stores the build artifact. + string bucket = 3; + + // The path of the build artifact in the bucket. + string path = 4; + + // The number of objects in the build artifact folder. The object number can + // be used to calculated the stage progress by comparing the source build + // artifact with the destination build artifact. + uint32 object_count = 5; +} diff --git a/third_party/googleapis/google/cloud/BUILD.bazel b/third_party/googleapis/google/cloud/BUILD.bazel new file mode 100644 index 000000000..676dc2e50 --- /dev/null +++ b/third_party/googleapis/google/cloud/BUILD.bazel @@ -0,0 +1,13 @@ +load("@rules_proto//proto:defs.bzl", "proto_library") + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +proto_library( + name = "common_resources_proto", + srcs = ["common_resources.proto"], + deps = ["//google/api:resource_proto"], +) diff --git a/third_party/googleapis/google/cloud/accessapproval/v1/BUILD.bazel b/third_party/googleapis/google/cloud/accessapproval/v1/BUILD.bazel new file mode 100644 index 000000000..8d4858977 --- /dev/null +++ b/third_party/googleapis/google/cloud/accessapproval/v1/BUILD.bazel @@ -0,0 +1,360 @@ +# This file was automatically generated by BuildFileGenerator + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") +load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") + +proto_library( + name = "accessapproval_proto", + srcs = [ + "accessapproval.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +proto_library_with_info( + name = "accessapproval_proto_with_info", + deps = [ + ":accessapproval_proto", + "//google/cloud:common_resources_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", + "java_proto_library", +) + +java_proto_library( + name = "accessapproval_java_proto", + deps = [":accessapproval_proto"], +) + +java_grpc_library( + name = "accessapproval_java_grpc", + srcs = [":accessapproval_proto"], + deps = [":accessapproval_java_proto"], +) + +java_gapic_library( + name = "accessapproval_java_gapic", + src = ":accessapproval_proto_with_info", + gapic_yaml = "accessapproval_gapic.yaml", + package = "google.cloud.accessapproval.v1", + service_yaml = "accessapproval_v1.yaml", + test_deps = [ + ":accessapproval_java_grpc", + ], + deps = [ + ":accessapproval_java_proto", + ], +) + +java_gapic_test( + name = "accessapproval_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.accessapproval.v1.AccessApprovalAdminClientTest", + ], + runtime_deps = [":accessapproval_java_gapic_test"], +) + +# Open Source Packages +java_gapic_assembly_gradle_pkg( + name = "google-cloud-accessapproval-v1-java", + deps = [ + ":accessapproval_java_gapic", + ":accessapproval_java_grpc", + ":accessapproval_java_proto", + ":accessapproval_proto", + ], +) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", + "go_proto_library", + "go_test", +) + +go_proto_library( + name = "accessapproval_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/cloud/accessapproval/v1", + protos = [":accessapproval_proto"], + deps = [ + "//google/api:annotations_go_proto", + ], +) + +go_gapic_library( + name = "accessapproval_go_gapic", + srcs = [":accessapproval_proto_with_info"], + grpc_service_config = "", + importpath = "cloud.google.com/go/accessapproval/apiv1;accessapproval", + service_yaml = "accessapproval_v1.yaml", + deps = [ + ":accessapproval_go_proto", + ], +) + +go_test( + name = "accessapproval_go_gapic_test", + srcs = [":accessapproval_go_gapic_srcjar_test"], + embed = [":accessapproval_go_gapic"], + importpath = "cloud.google.com/go/accessapproval/apiv1", +) + +# Open Source Packages +go_gapic_assembly_pkg( + name = "gapi-cloud-accessapproval-v1-go", + deps = [ + ":accessapproval_go_gapic", + ":accessapproval_go_gapic_srcjar-test.srcjar", + ":accessapproval_go_proto", + ], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "accessapproval_moved_proto", + srcs = [":accessapproval_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +py_proto_library( + name = "accessapproval_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":accessapproval_moved_proto"], +) + +py_grpc_library( + name = "accessapproval_py_grpc", + srcs = [":accessapproval_moved_proto"], + deps = [":accessapproval_py_proto"], +) + +py_gapic_library( + name = "accessapproval_py_gapic", + src = ":accessapproval_proto_with_info", + gapic_yaml = "accessapproval_gapic.yaml", + package = "google.cloud.accessapproval.v1", + service_yaml = "accessapproval_v1.yaml", + deps = [ + ":accessapproval_py_grpc", + ":accessapproval_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "accessapproval-v1-py", + deps = [ + ":accessapproval_py_gapic", + ":accessapproval_py_grpc", + ":accessapproval_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "accessapproval_php_proto", + deps = [":accessapproval_proto"], +) + +php_grpc_library( + name = "accessapproval_php_grpc", + srcs = [":accessapproval_proto"], + deps = [":accessapproval_php_proto"], +) + +php_gapic_library( + name = "accessapproval_php_gapic", + src = ":accessapproval_proto_with_info", + gapic_yaml = "accessapproval_gapic.yaml", + package = "google.cloud.accessapproval.v1", + service_yaml = "accessapproval_v1.yaml", + deps = [ + ":accessapproval_php_grpc", + ":accessapproval_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-accessapproval-v1-php", + deps = [ + ":accessapproval_php_gapic", + ":accessapproval_php_grpc", + ":accessapproval_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "accessapproval_nodejs_gapic", + src = ":accessapproval_proto_with_info", + gapic_yaml = "accessapproval_gapic.yaml", + package = "google.cloud.accessapproval.v1", + service_yaml = "accessapproval_v1.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "accessapproval-v1-nodejs", + deps = [ + ":accessapproval_nodejs_gapic", + ":accessapproval_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "accessapproval_ruby_proto", + deps = [":accessapproval_proto"], +) + +ruby_grpc_library( + name = "accessapproval_ruby_grpc", + srcs = [":accessapproval_proto"], + deps = [":accessapproval_ruby_proto"], +) + +ruby_gapic_library( + name = "accessapproval_ruby_gapic", + src = ":accessapproval_proto_with_info", + gapic_yaml = "accessapproval_gapic.yaml", + package = "google.cloud.accessapproval.v1", + service_yaml = "accessapproval_v1.yaml", + deps = [ + ":accessapproval_ruby_grpc", + ":accessapproval_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-accessapproval-v1-ruby", + deps = [ + ":accessapproval_ruby_gapic", + ":accessapproval_ruby_grpc", + ":accessapproval_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "accessapproval_csharp_proto", + deps = [":accessapproval_proto"], +) + +csharp_grpc_library( + name = "accessapproval_csharp_grpc", + srcs = [":accessapproval_proto"], + deps = [":accessapproval_csharp_proto"], +) + +csharp_gapic_library( + name = "accessapproval_csharp_gapic", + src = ":accessapproval_proto_with_info", + gapic_yaml = "accessapproval_gapic.yaml", + package = "google.cloud.accessapproval.v1", + service_yaml = "accessapproval_v1.yaml", + deps = [ + ":accessapproval_csharp_grpc", + ":accessapproval_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-accessapproval-v1-csharp", + deps = [ + ":accessapproval_csharp_gapic", + ":accessapproval_csharp_grpc", + ":accessapproval_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/cloud/accessapproval/v1/accessapproval.proto b/third_party/googleapis/google/cloud/accessapproval/v1/accessapproval.proto new file mode 100644 index 000000000..96aaa048f --- /dev/null +++ b/third_party/googleapis/google/cloud/accessapproval/v1/accessapproval.proto @@ -0,0 +1,481 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.accessapproval.v1; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/protobuf/empty.proto"; +import "google/protobuf/field_mask.proto"; +import "google/protobuf/timestamp.proto"; + +option go_package = "google.golang.org/genproto/googleapis/cloud/accessapproval/v1;accessapproval"; +option java_multiple_files = true; +option java_outer_classname = "AccessApprovalProto"; +option java_package = "com.google.cloud.accessapproval.v1"; +option ruby_package = "Google::Cloud::AccessApproval::V1"; + +// This API allows a customer to manage accesses to cloud resources by +// Google personnel. It defines the following resource model: +// +// - The API has a collection of +// [ApprovalRequest][google.cloud.accessapproval.v1.ApprovalRequest] +// resources, named `approvalRequests/{approval_request_id}` +// - The API has top-level settings per Project/Folder/Organization, named +// `accessApprovalSettings` +// +// The service also periodically emails a list of recipients, defined at the +// Project/Folder/Organization level in the accessApprovalSettings, when there +// is a pending ApprovalRequest for them to act on. The ApprovalRequests can +// also optionally be published to a Cloud Pub/Sub topic owned by the customer +// (for Beta, the Pub/Sub setup is managed manually). +// +// ApprovalRequests can be approved or dismissed. Google personel can only +// access the indicated resource or resources if the request is approved +// (subject to some exclusions: +// https://cloud.google.com/access-approval/docs/overview#exclusions). +// +// Note: Using Access Approval functionality will mean that Google may not be +// able to meet the SLAs for your chosen products, as any support response times +// may be dramatically increased. As such the SLAs do not apply to any service +// disruption to the extent impacted by Customer's use of Access Approval. Do +// not enable Access Approval for projects where you may require high service +// availability and rapid response by Google Cloud Support. +// +// After a request is approved or dismissed, no further action may be taken on +// it. Requests with the requested_expiration in the past or with no activity +// for 14 days are considered dismissed. When an approval expires, the request +// is considered dismissed. +// +// If a request is not approved or dismissed, we call it pending. +service AccessApproval { + option (google.api.default_host) = "accessapproval.googleapis.com"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; + + // Lists approval requests associated with a project, folder, or organization. + // Approval requests can be filtered by state (pending, active, dismissed). + // The order is reverse chronological. + rpc ListApprovalRequests(ListApprovalRequestsMessage) returns (ListApprovalRequestsResponse) { + option (google.api.http) = { + get: "/v1/{parent=projects/*}/approvalRequests" + additional_bindings { + get: "/v1/{parent=folders/*}/approvalRequests" + } + additional_bindings { + get: "/v1/{parent=organizations/*}/approvalRequests" + } + }; + option (google.api.method_signature) = "parent"; + } + + // Gets an approval request. Returns NOT_FOUND if the request does not exist. + rpc GetApprovalRequest(GetApprovalRequestMessage) returns (ApprovalRequest) { + option (google.api.http) = { + get: "/v1/{name=projects/*/approvalRequests/*}" + additional_bindings { + get: "/v1/{name=folders/*/approvalRequests/*}" + } + additional_bindings { + get: "/v1/{name=organizations/*/approvalRequests/*}" + } + }; + option (google.api.method_signature) = "name"; + } + + // Approves a request and returns the updated ApprovalRequest. + // + // Returns NOT_FOUND if the request does not exist. Returns + // FAILED_PRECONDITION if the request exists but is not in a pending state. + rpc ApproveApprovalRequest(ApproveApprovalRequestMessage) returns (ApprovalRequest) { + option (google.api.http) = { + post: "/v1/{name=projects/*/approvalRequests/*}:approve" + body: "*" + additional_bindings { + post: "/v1/{name=folders/*/approvalRequests/*}:approve" + body: "*" + } + additional_bindings { + post: "/v1/{name=organizations/*/approvalRequests/*}:approve" + body: "*" + } + }; + } + + // Dismisses a request. Returns the updated ApprovalRequest. + // + // NOTE: This does not deny access to the resource if another request has been + // made and approved. It is equivalent in effect to ignoring the request + // altogether. + // + // Returns NOT_FOUND if the request does not exist. + // + // Returns FAILED_PRECONDITION if the request exists but is not in a pending + // state. + rpc DismissApprovalRequest(DismissApprovalRequestMessage) returns (ApprovalRequest) { + option (google.api.http) = { + post: "/v1/{name=projects/*/approvalRequests/*}:dismiss" + body: "*" + additional_bindings { + post: "/v1/{name=folders/*/approvalRequests/*}:dismiss" + body: "*" + } + additional_bindings { + post: "/v1/{name=organizations/*/approvalRequests/*}:dismiss" + body: "*" + } + }; + } + + // Gets the settings associated with a project, folder, or organization. + rpc GetAccessApprovalSettings(GetAccessApprovalSettingsMessage) returns (AccessApprovalSettings) { + option (google.api.http) = { + get: "/v1/{name=projects/*/accessApprovalSettings}" + additional_bindings { + get: "/v1/{name=folders/*/accessApprovalSettings}" + } + additional_bindings { + get: "/v1/{name=organizations/*/accessApprovalSettings}" + } + }; + option (google.api.method_signature) = "name"; + } + + // Updates the settings associated with a project, folder, or organization. + // Settings to update are determined by the value of field_mask. + rpc UpdateAccessApprovalSettings(UpdateAccessApprovalSettingsMessage) returns (AccessApprovalSettings) { + option (google.api.http) = { + patch: "/v1/{settings.name=projects/*/accessApprovalSettings}" + body: "settings" + additional_bindings { + patch: "/v1/{settings.name=folders/*/accessApprovalSettings}" + body: "settings" + } + additional_bindings { + patch: "/v1/{settings.name=organizations/*/accessApprovalSettings}" + body: "settings" + } + }; + option (google.api.method_signature) = "settings,update_mask"; + } + + // Deletes the settings associated with a project, folder, or organization. + // This will have the effect of disabling Access Approval for the project, + // folder, or organization, but only if all ancestors also have Access + // Approval disabled. If Access Approval is enabled at a higher level of the + // hierarchy, then Access Approval will still be enabled at this level as + // the settings are inherited. + rpc DeleteAccessApprovalSettings(DeleteAccessApprovalSettingsMessage) returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1/{name=projects/*/accessApprovalSettings}" + additional_bindings { + delete: "/v1/{name=folders/*/accessApprovalSettings}" + } + additional_bindings { + delete: "/v1/{name=organizations/*/accessApprovalSettings}" + } + }; + option (google.api.method_signature) = "name"; + } +} + +// Home office and physical location of the principal. +message AccessLocations { + // The "home office" location of the principal. A two-letter country code + // (ISO 3166-1 alpha-2), such as "US", "DE" or "GB" or a region code. In some + // limited situations Google systems may refer refer to a region code instead + // of a country code. + // Possible Region Codes: + //
    + //
  1. ASI: Asia
    2. + //
  2. EUR: Europe
    3. + //
  3. OCE: Oceania
    4. + //
  4. AFR: Africa
    5. + //
  5. NAM: North America
    6. + //
  6. SAM: South America
    7. + //
  7. ANT: Antarctica
    8. + //
  8. ANY: Any location
    9. + //
+ string principal_office_country = 1; + + // Physical location of the principal at the time of the access. A + // two-letter country code (ISO 3166-1 alpha-2), such as "US", "DE" or "GB" or + // a region code. In some limited situations Google systems may refer refer to + // a region code instead of a country code. + // Possible Region Codes: + //
    + //
  1. ASI: Asia
    2. + //
  2. EUR: Europe
    3. + //
  3. OCE: Oceania
    4. + //
  4. AFR: Africa
    5. + //
  5. NAM: North America
    6. + //
  6. SAM: South America
    7. + //
  7. ANT: Antarctica
    8. + //
  8. ANY: Any location
    9. + //
+ string principal_physical_location_country = 2; +} + +message AccessReason { + // Type of access justification. + enum Type { + // Default value for proto, shouldn't be used. + TYPE_UNSPECIFIED = 0; + + // Customer made a request or raised an issue that required the principal to + // access customer data. `detail` is of the form ("#####" is the issue ID): + //
    + //
  1. "Feedback Report: #####"
    2. + //
  2. "Case Number: #####"
    3. + //
  3. "Case ID: #####"
    4. + //
  4. "E-PIN Reference: #####"
    5. + //
  5. "Google-#####"
    6. + //
  6. "T-#####"
    7. + //
+ CUSTOMER_INITIATED_SUPPORT = 1; + + // The principal accessed customer data in order to diagnose or resolve a + // suspected issue in services or a known outage. Often this access is used + // to confirm that customers are not affected by a suspected service issue + // or to remediate a reversible system issue. + GOOGLE_INITIATED_SERVICE = 2; + + // Google initiated service for security, fraud, abuse, or compliance + // purposes. + GOOGLE_INITIATED_REVIEW = 3; + } + + // Type of access justification. + Type type = 1; + + // More detail about certain reason types. See comments for each type above. + string detail = 2; +} + +// A decision that has been made to approve access to a resource. +message ApproveDecision { + // The time at which approval was granted. + google.protobuf.Timestamp approve_time = 1; + + // The time at which the approval expires. + google.protobuf.Timestamp expire_time = 2; +} + +// A decision that has been made to dismiss an approval request. +message DismissDecision { + // The time at which the approval request was dismissed. + google.protobuf.Timestamp dismiss_time = 1; +} + +// The properties associated with the resource of the request. +message ResourceProperties { + // Whether an approval will exclude the descendants of the resource being + // requested. + bool excludes_descendants = 1; +} + +// A request for the customer to approve access to a resource. +message ApprovalRequest { + // The resource name of the request. Format is + // "{projects|folders|organizations}/{id}/approvalRequests/{approval_request_id}". + string name = 1; + + // The resource for which approval is being requested. The format of the + // resource name is defined at + // https://cloud.google.com/apis/design/resource_names. The resource name here + // may either be a "full" resource name (e.g. + // "//library.googleapis.com/shelves/shelf1/books/book2") or a "relative" + // resource name (e.g. "shelves/shelf1/books/book2") as described in the + // resource name specification. + string requested_resource_name = 2; + + // Properties related to the resource represented by requested_resource_name. + ResourceProperties requested_resource_properties = 9; + + // The justification for which approval is being requested. + AccessReason requested_reason = 3; + + // The locations for which approval is being requested. + AccessLocations requested_locations = 4; + + // The time at which approval was requested. + google.protobuf.Timestamp request_time = 5; + + // The requested expiration for the approval. If the request is approved, + // access will be granted from the time of approval until the expiration time. + google.protobuf.Timestamp requested_expiration = 6; + + // The current decision on the approval request. + oneof decision { + // Access was approved. + ApproveDecision approve = 7; + + // The request was dismissed. + DismissDecision dismiss = 8; + } +} + +// Represents the enrollment of a cloud resource into a specific service. +message EnrolledService { + // The product for which Access Approval will be enrolled. Allowed values are + // listed below (case-sensitive): + //
    + //
  1. all
    2. + //
  2. appengine.googleapis.com
    3. + //
  3. bigquery.googleapis.com
    4. + //
  4. bigtable.googleapis.com
    5. + //
  5. cloudkms.googleapis.com
    6. + //
  6. compute.googleapis.com
    7. + //
  7. dataflow.googleapis.com
    8. + //
  8. iam.googleapis.com
    9. + //
  9. pubsub.googleapis.com
    10. + //
  10. storage.googleapis.com
    11. + //
      + string cloud_product = 1; + + // The enrollment level of the service. + EnrollmentLevel enrollment_level = 2; +} + +// Represents the type of enrollment for a given service to Access Approval. +enum EnrollmentLevel { + // Default value for proto, shouldn't be used. + ENROLLMENT_LEVEL_UNSPECIFIED = 0; + + // Service is enrolled in Access Approval for all requests + BLOCK_ALL = 1; +} + +// Settings on a Project/Folder/Organization related to Access Approval. +message AccessApprovalSettings { + // The resource name of the settings. Format is one of: + //
        + //
      1. "projects/{project_id}/accessApprovalSettings"
        2. + //
      2. "folders/{folder_id}/accessApprovalSettings"
        3. + //
      3. "organizations/{organization_id}/accessApprovalSettings"
        4. + //
          + string name = 1; + + // A list of email addresses to which notifications relating to approval + // requests should be sent. Notifications relating to a resource will be sent + // to all emails in the settings of ancestor resources of that resource. A + // maximum of 50 email addresses are allowed. + repeated string notification_emails = 2; + + // A list of Google Cloud Services for which the given resource has Access + // Approval enrolled. Access requests for the resource given by name against + // any of these services contained here will be required to have explicit + // approval. If name refers to an organization, enrollment can be done for + // individual services. If name refers to a folder or project, enrollment can + // only be done on an all or nothing basis. + // + // If a cloud_product is repeated in this list, the first entry will be + // honored and all following entries will be discarded. A maximum of 10 + // enrolled services will be enforced, to be expanded as the set of supported + // services is expanded. + repeated EnrolledService enrolled_services = 3; + + // Output only. This field is read only (not settable via + // UpdateAccessAccessApprovalSettings method). If the field is true, that + // indicates that at least one service is enrolled for Access Approval in one + // or more ancestors of the Project or Folder (this field will always be + // unset for the organization since organizations do not have ancestors). + bool enrolled_ancestor = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// Request to list approval requests. +message ListApprovalRequestsMessage { + // The parent resource. This may be "projects/{project_id}", + // "folders/{folder_id}", or "organizations/{organization_id}". + string parent = 1; + + // A filter on the type of approval requests to retrieve. Must be one of the + // following values: + //
            + //
          1. [not set]: Requests that are pending or have active approvals.
            2. + //
          2. ALL: All requests.
            3. + //
          3. PENDING: Only pending requests.
            4. + //
          4. ACTIVE: Only active (i.e. currently approved) requests.
            5. + //
          5. DISMISSED: Only dismissed (including expired) requests.
            6. + //
          + string filter = 2; + + // Requested page size. + int32 page_size = 3; + + // A token identifying the page of results to return. + string page_token = 4; +} + +// Response to listing of ApprovalRequest objects. +message ListApprovalRequestsResponse { + // Approval request details. + repeated ApprovalRequest approval_requests = 1; + + // Token to retrieve the next page of results, or empty if there are no more. + string next_page_token = 2; +} + +// Request to get an approval request. +message GetApprovalRequestMessage { + // Name of the approval request to retrieve. + string name = 1; +} + +// Request to approve an ApprovalRequest. +message ApproveApprovalRequestMessage { + // Name of the approval request to approve. + string name = 1; + + // The expiration time of this approval. + google.protobuf.Timestamp expire_time = 2; +} + +// Request to dismiss an approval request. +message DismissApprovalRequestMessage { + // Name of the ApprovalRequest to dismiss. + string name = 1; +} + +// Request to get access approval settings. +message GetAccessApprovalSettingsMessage { + // Name of the AccessApprovalSettings to retrieve. + string name = 1; +} + +// Request to update access approval settings. +message UpdateAccessApprovalSettingsMessage { + // The new AccessApprovalSettings. + AccessApprovalSettings settings = 1; + + // The update mask applies to the settings. Only the top level fields of + // AccessApprovalSettings (notification_emails & enrolled_services) are + // supported. For each field, if it is included, the currently stored value + // will be entirely overwritten with the value of the field passed in this + // request. + // + // For the `FieldMask` definition, see + // https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask + // If this field is left unset, only the notification_emails field will be + // updated. + google.protobuf.FieldMask update_mask = 2; +} + +// Request to delete access approval settings. +message DeleteAccessApprovalSettingsMessage { + // Name of the AccessApprovalSettings to delete. + string name = 1; +} diff --git a/third_party/googleapis/google/cloud/accessapproval/v1/accessapproval_gapic.yaml b/third_party/googleapis/google/cloud/accessapproval/v1/accessapproval_gapic.yaml new file mode 100644 index 000000000..634eeef01 --- /dev/null +++ b/third_party/googleapis/google/cloud/accessapproval/v1/accessapproval_gapic.yaml @@ -0,0 +1,20 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 2.0.0 +language_settings: + java: + package_name: com.google.cloud.accessapproval.v1 + interface_names: + google.cloud.accessapproval.v1.AccessApproval: AccessApprovalAdmin + python: + package_name: google.cloud.accessapproval_v1.gapic + go: + package_name: cloud.google.com/go/accessapproval/apiv1 + csharp: + package_name: Google.Cloud.AccessApproval.V1 + ruby: + package_name: Google::Cloud::AccessApproval::V1 + php: + package_name: Google\Cloud\AccessApproval\V1 + nodejs: + package_name: accessapproval.v1 + domain_layer_location: google-cloud diff --git a/third_party/googleapis/google/cloud/accessapproval/v1/accessapproval_v1.yaml b/third_party/googleapis/google/cloud/accessapproval/v1/accessapproval_v1.yaml new file mode 100644 index 000000000..9893bf20f --- /dev/null +++ b/third_party/googleapis/google/cloud/accessapproval/v1/accessapproval_v1.yaml @@ -0,0 +1,22 @@ +type: google.api.Service +config_version: 3 +name: accessapproval.googleapis.com +title: Access Approval API + +apis: +- name: google.cloud.accessapproval.v1.AccessApproval + +documentation: + summary: An API for controlling access to data by Google personnel. + +backend: + rules: + - selector: 'google.cloud.accessapproval.v1.AccessApproval.*' + deadline: 10.0 + +authentication: + rules: + - selector: 'google.cloud.accessapproval.v1.AccessApproval.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/asset/BUILD.bazel b/third_party/googleapis/google/cloud/asset/BUILD.bazel index 1e5b8c2af..a87c57fec 100644 --- a/third_party/googleapis/google/cloud/asset/BUILD.bazel +++ b/third_party/googleapis/google/cloud/asset/BUILD.bazel @@ -1 +1 @@ -exports_files(glob(["*.yaml"])) \ No newline at end of file +exports_files(glob(["*.yaml"])) diff --git a/third_party/googleapis/google/cloud/asset/artman_cloudasset_v1.yaml b/third_party/googleapis/google/cloud/asset/artman_cloudasset_v1.yaml index 53429a5d8..f0ef4c771 100644 --- a/third_party/googleapis/google/cloud/asset/artman_cloudasset_v1.yaml +++ b/third_party/googleapis/google/cloud/asset/artman_cloudasset_v1.yaml @@ -4,11 +4,12 @@ common: api_version: v1 organization_name: google-cloud proto_deps: - - name: google-common-protos + - name: google-common-protos src_proto_paths: - v1 - service_yaml: asset_v1.yaml + service_yaml: v1/cloudasset_v1.yaml gapic_yaml: v1/cloudasset_gapic.yaml + proto_package: google.cloud.asset.v1 artifacts: - name: gapic_config type: GAPIC_CONFIG diff --git a/third_party/googleapis/google/cloud/asset/artman_cloudasset_v1beta1.yaml b/third_party/googleapis/google/cloud/asset/artman_cloudasset_v1beta1.yaml index c3278c500..fa196fe9c 100644 --- a/third_party/googleapis/google/cloud/asset/artman_cloudasset_v1beta1.yaml +++ b/third_party/googleapis/google/cloud/asset/artman_cloudasset_v1beta1.yaml @@ -4,7 +4,7 @@ common: api_version: v1beta1 organization_name: google-cloud proto_deps: - - name: google-common-protos + - name: google-common-protos src_proto_paths: - v1beta1 service_yaml: asset_v1beta1.yaml diff --git a/third_party/googleapis/google/cloud/asset/artman_cloudasset_v1p2beta1.yaml b/third_party/googleapis/google/cloud/asset/artman_cloudasset_v1p2beta1.yaml new file mode 100644 index 000000000..004cd2bfd --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/artman_cloudasset_v1p2beta1.yaml @@ -0,0 +1,35 @@ +common: + # Keep the api_name asset, otherwise Java code gen will be broken. + api_name: asset + api_version: v1p2beta1 + organization_name: google-cloud + proto_deps: + - name: google-common-protos + src_proto_paths: + - v1p2beta1 + service_yaml: asset_v1p2beta1.yaml + gapic_yaml: v1p2beta1/cloudasset_gapic.yaml +artifacts: +- name: gapic_config + type: GAPIC_CONFIG +- name: java_gapic + type: GAPIC + language: JAVA +- name: python_gapic + type: GAPIC + language: PYTHON +- name: nodejs_gapic + type: GAPIC + language: NODEJS +- name: php_gapic + type: GAPIC + language: PHP +- name: go_gapic + type: GAPIC + language: GO +- name: ruby_gapic + type: GAPIC + language: RUBY +- name: csharp_gapic + type: GAPIC + language: CSHARP diff --git a/third_party/googleapis/google/cloud/asset/asset_v1p2beta1.yaml b/third_party/googleapis/google/cloud/asset/asset_v1p2beta1.yaml new file mode 100644 index 000000000..3d218a365 --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/asset_v1p2beta1.yaml @@ -0,0 +1,38 @@ +type: google.api.Service +config_version: 3 +name: cloudasset.googleapis.com +title: Cloud Asset API + +apis: +- name: google.cloud.asset.v1p2beta1.AssetService + +documentation: + summary: The cloud asset API manages the history and inventory of cloud resources. + overview: |- + # Cloud Asset API + + The Cloud Asset API keeps a history of Google Cloud Platform (GCP) asset + metadata, and allows GCP users to download a dump of all asset metadata + for the resource types listed below within an organization or a project at + a given timestamp. + + Read more documents here: + https://cloud.google.com/resource-manager/docs/cloud-asset-inventory/overview + +backend: + rules: + - selector: 'google.cloud.asset.v1p2beta1.AssetService.*' + deadline: 600.0 + - selector: google.longrunning.Operations.GetOperation + deadline: 60.0 + +authentication: + rules: + - selector: 'google.cloud.asset.v1p2beta1.AssetService.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: google.longrunning.Operations.GetOperation + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/asset/v1/BUILD.bazel b/third_party/googleapis/google/cloud/asset/v1/BUILD.bazel new file mode 100644 index 000000000..ef733e6d2 --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1/BUILD.bazel @@ -0,0 +1,391 @@ +# This file was automatically generated by BuildFileGenerator + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") +load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") + +proto_library( + name = "asset_proto", + srcs = [ + "asset_service.proto", + "assets.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/cloud/orgpolicy/v1:orgpolicy_proto", + "//google/iam/v1:policy_proto", + "//google/identity/accesscontextmanager/v1:accesscontextmanager_proto", + "//google/longrunning:operations_proto", + "//google/type:expr_proto", + "@com_google_protobuf//:any_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:struct_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +proto_library_with_info( + name = "asset_proto_with_info", + deps = [ + ":asset_proto", + "//google/cloud:common_resources_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", + "java_proto_library", +) + +java_proto_library( + name = "asset_java_proto", + deps = [":asset_proto"], +) + +java_grpc_library( + name = "asset_java_grpc", + srcs = [":asset_proto"], + deps = [":asset_java_proto"], +) + +java_gapic_library( + name = "asset_java_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1", + service_yaml = "cloudasset_v1.yaml", + test_deps = [ + ":asset_java_grpc", + "//google/iam/v1:iam_java_grpc", + ], + deps = [ + ":asset_java_proto", + "//google/iam/v1:iam_java_proto", + ], +) + +java_gapic_test( + name = "asset_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.asset.v1.AssetServiceClientTest", + ], + runtime_deps = [":asset_java_gapic_test"], +) + +# Open Source Packages +java_gapic_assembly_gradle_pkg( + name = "google-cloud-asset-v1-java", + deps = [ + ":asset_java_gapic", + ":asset_java_grpc", + ":asset_java_proto", + ":asset_proto", + ], +) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", + "go_proto_library", + "go_test", +) + +go_proto_library( + name = "asset_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/cloud/asset/v1", + protos = [":asset_proto"], + deps = [ + "//google/api:annotations_go_proto", + "//google/cloud/orgpolicy/v1:orgpolicy_go_proto", + "//google/iam/v1:iam_go_proto", + "//google/identity/accesscontextmanager/v1:accesscontextmanager_go_proto", + "//google/longrunning:longrunning_go_proto", + "//google/type:expr_go_proto", + ], +) + +go_gapic_library( + name = "asset_go_gapic", + srcs = [":asset_proto_with_info"], + grpc_service_config = "cloudasset_grpc_service_config.json", + importpath = "cloud.google.com/go/asset/apiv1;asset", + service_yaml = "cloudasset_v1.yaml", + deps = [ + ":asset_go_proto", + "//google/iam/v1:iam_go_proto", + "//google/longrunning:longrunning_go_gapic", + "//google/longrunning:longrunning_go_proto", + "@com_google_cloud_go//longrunning:go_default_library", + "@com_google_cloud_go//longrunning/autogen:go_default_library", + "@io_bazel_rules_go//proto/wkt:any_go_proto", + "@io_bazel_rules_go//proto/wkt:struct_go_proto", + ], +) + +go_test( + name = "asset_go_gapic_test", + srcs = [":asset_go_gapic_srcjar_test"], + embed = [":asset_go_gapic"], + importpath = "cloud.google.com/go/asset/apiv1", +) + +# Open Source Packages +go_gapic_assembly_pkg( + name = "gapi-cloud-asset-v1-go", + deps = [ + ":asset_go_gapic", + ":asset_go_gapic_srcjar-test.srcjar", + ":asset_go_proto", + ], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "asset_moved_proto", + srcs = [":asset_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/cloud/orgpolicy/v1:orgpolicy_proto", + "//google/iam/v1:policy_proto", + "//google/identity/accesscontextmanager/v1:accesscontextmanager_proto", + "//google/longrunning:operations_proto", + "//google/type:expr_proto", + "@com_google_protobuf//:any_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:struct_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +py_proto_library( + name = "asset_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":asset_moved_proto"], +) + +py_grpc_library( + name = "asset_py_grpc", + srcs = [":asset_moved_proto"], + deps = [":asset_py_proto"], +) + +py_gapic_library( + name = "asset_py_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1", + service_yaml = "cloudasset_v1.yaml", + deps = [ + ":asset_py_grpc", + ":asset_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "asset-v1-py", + deps = [ + ":asset_py_gapic", + ":asset_py_grpc", + ":asset_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "asset_php_proto", + deps = [":asset_proto"], +) + +php_grpc_library( + name = "asset_php_grpc", + srcs = [":asset_proto"], + deps = [":asset_php_proto"], +) + +php_gapic_library( + name = "asset_php_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1", + service_yaml = "cloudasset_v1.yaml", + deps = [ + ":asset_php_grpc", + ":asset_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-asset-v1-php", + deps = [ + ":asset_php_gapic", + ":asset_php_grpc", + ":asset_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "asset_nodejs_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1", + service_yaml = "cloudasset_v1.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "asset-v1-nodejs", + deps = [ + ":asset_nodejs_gapic", + ":asset_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "asset_ruby_proto", + deps = [":asset_proto"], +) + +ruby_grpc_library( + name = "asset_ruby_grpc", + srcs = [":asset_proto"], + deps = [":asset_ruby_proto"], +) + +ruby_gapic_library( + name = "asset_ruby_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1", + service_yaml = "cloudasset_v1.yaml", + deps = [ + ":asset_ruby_grpc", + ":asset_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-asset-v1-ruby", + deps = [ + ":asset_ruby_gapic", + ":asset_ruby_grpc", + ":asset_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "asset_csharp_proto", + deps = [":asset_proto"], +) + +csharp_grpc_library( + name = "asset_csharp_grpc", + srcs = [":asset_proto"], + deps = [":asset_csharp_proto"], +) + +csharp_gapic_library( + name = "asset_csharp_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1", + service_yaml = "cloudasset_v1.yaml", + deps = [ + ":asset_csharp_grpc", + ":asset_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-asset-v1-csharp", + deps = [ + ":asset_csharp_gapic", + ":asset_csharp_grpc", + ":asset_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/cloud/asset/v1/asset_service.proto b/third_party/googleapis/google/cloud/asset/v1/asset_service.proto index 0dfc2898b..0eab6efdd 100644 --- a/third_party/googleapis/google/cloud/asset/v1/asset_service.proto +++ b/third_party/googleapis/google/cloud/asset/v1/asset_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,16 +11,21 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.asset.v1; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/cloud/asset/v1/assets.proto"; import "google/longrunning/operations.proto"; +import "google/protobuf/empty.proto"; +import "google/protobuf/field_mask.proto"; import "google/protobuf/timestamp.proto"; +import "google/type/expr.proto"; option csharp_namespace = "Google.Cloud.Asset.V1"; option go_package = "google.golang.org/genproto/googleapis/cloud/asset/v1;asset"; @@ -29,18 +34,26 @@ option java_outer_classname = "AssetServiceProto"; option java_package = "com.google.cloud.asset.v1"; option php_namespace = "Google\\Cloud\\Asset\\V1"; - // Asset service definition. service AssetService { + option (google.api.default_host) = "cloudasset.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform"; + // Exports assets with time and resource types to a given Cloud Storage // location. The output format is newline-delimited JSON. - // This API implements the [google.longrunning.Operation][google.longrunning.Operation] API allowing you - // to keep track of the export. + // This API implements the + // [google.longrunning.Operation][google.longrunning.Operation] API allowing + // you to keep track of the export. rpc ExportAssets(ExportAssetsRequest) returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/{parent=*/*}:exportAssets" body: "*" }; + option (google.longrunning.operation_info) = { + response_type: "google.cloud.asset.v1.ExportAssetsResponse" + metadata_type: "google.cloud.asset.v1.ExportAssetsRequest" + }; } // Batch gets the update history of assets that overlap a time window. @@ -50,11 +63,79 @@ service AssetService { // attached IAM POLICY both exist. This can create gaps in the output history. // If a specified asset does not exist, this API returns an INVALID_ARGUMENT // error. - rpc BatchGetAssetsHistory(BatchGetAssetsHistoryRequest) returns (BatchGetAssetsHistoryResponse) { + rpc BatchGetAssetsHistory(BatchGetAssetsHistoryRequest) + returns (BatchGetAssetsHistoryResponse) { option (google.api.http) = { get: "/v1/{parent=*/*}:batchGetAssetsHistory" }; } + + // Creates a feed in a parent project/folder/organization to listen to its + // asset updates. + rpc CreateFeed(CreateFeedRequest) returns (Feed) { + option (google.api.http) = { + post: "/v1/{parent=*/*}/feeds" + body: "*" + }; + option (google.api.method_signature) = "parent"; + } + + // Gets details about an asset feed. + rpc GetFeed(GetFeedRequest) returns (Feed) { + option (google.api.http) = { + get: "/v1/{name=*/*/feeds/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Lists all asset feeds in a parent project/folder/organization. + rpc ListFeeds(ListFeedsRequest) returns (ListFeedsResponse) { + option (google.api.http) = { + get: "/v1/{parent=*/*}/feeds" + }; + option (google.api.method_signature) = "parent"; + } + + // Updates an asset feed configuration. + rpc UpdateFeed(UpdateFeedRequest) returns (Feed) { + option (google.api.http) = { + patch: "/v1/{feed.name=*/*/feeds/*}" + body: "*" + }; + option (google.api.method_signature) = "feed"; + } + + // Deletes an asset feed. + rpc DeleteFeed(DeleteFeedRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1/{name=*/*/feeds/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Searches all the resources within the given accessible scope (e.g., a + // project, a folder or an organization). Callers should have + // cloud.assets.SearchAllResources permission upon the requested scope, + // otherwise the request will be rejected. + rpc SearchAllResources(SearchAllResourcesRequest) + returns (SearchAllResourcesResponse) { + option (google.api.http) = { + get: "/v1/{scope=*/*}:searchAllResources" + }; + option (google.api.method_signature) = "scope,query,asset_types"; + } + + // Searches all the IAM policies within the given accessible scope (e.g., a + // project, a folder or an organization). Callers should have + // cloud.assets.SearchAllIamPolicies permission upon the requested scope, + // otherwise the request will be rejected. + rpc SearchAllIamPolicies(SearchAllIamPoliciesRequest) + returns (SearchAllIamPoliciesResponse) { + option (google.api.http) = { + get: "/v1/{scope=*/*}:searchAllIamPolicies" + }; + option (google.api.method_signature) = "scope,query"; + } } // Export asset request. @@ -63,19 +144,24 @@ message ExportAssetsRequest { // organization number (such as "organizations/123"), a project ID (such as // "projects/my-project-id"), or a project number (such as "projects/12345"), // or a folder number (such as "folders/123"). - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "cloudasset.googleapis.com/Asset" + } + ]; // Timestamp to take an asset snapshot. This can only be set to a timestamp - // between 2018-10-02 UTC (inclusive) and the current time. If not specified, - // the current time will be used. Due to delays in resource data collection - // and indexing, there is a volatile window during which running the same - // query may get different results. + // between the current time and the current time minus 35 days (inclusive). + // If not specified, the current time will be used. Due to delays in resource + // data collection and indexing, there is a volatile window during which + // running the same query may get different results. google.protobuf.Timestamp read_time = 2; // A list of asset types of which to take a snapshot for. For example: - // "compute.googleapis.com/Disk". If specified, only matching assets will be returned. - // See [Introduction to Cloud Asset - // Inventory](https://cloud.google.com/resource-manager/docs/cloud-asset-inventory/overview) + // "compute.googleapis.com/Disk". If specified, only matching assets will be + // returned. See [Introduction to Cloud Asset + // Inventory](https://cloud.google.com/asset-inventory/docs/overview) // for all supported asset types. repeated string asset_types = 3; @@ -85,12 +171,14 @@ message ExportAssetsRequest { // Required. Output configuration indicating where the results will be output // to. All results will be in newline delimited JSON format. - OutputConfig output_config = 5; + OutputConfig output_config = 5 [(google.api.field_behavior) = REQUIRED]; } // The export asset response. This message is returned by the -// [google.longrunning.Operations.GetOperation][google.longrunning.Operations.GetOperation] method in the returned -// [google.longrunning.Operation.response][google.longrunning.Operation.response] field. +// [google.longrunning.Operations.GetOperation][google.longrunning.Operations.GetOperation] +// method in the returned +// [google.longrunning.Operation.response][google.longrunning.Operation.response] +// field. message ExportAssetsResponse { // Time the snapshot was taken. google.protobuf.Timestamp read_time = 1; @@ -105,29 +193,35 @@ message BatchGetAssetsHistoryRequest { // Required. The relative name of the root asset. It can only be an // organization number (such as "organizations/123"), a project ID (such as // "projects/my-project-id")", or a project number (such as "projects/12345"). - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "cloudasset.googleapis.com/Asset" + } + ]; // A list of the full names of the assets. For example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`. // See [Resource // Names](https://cloud.google.com/apis/design/resource_names#full_resource_name) - // and [Resource Name Format](https://cloud.google.com/resource-manager/docs/cloud-asset-inventory/resource-name-format) + // and [Resource Name + // Format](https://cloud.google.com/asset-inventory/docs/resource-name-format) // for more info. // // The request becomes a no-op if the asset name list is empty, and the max // size of the asset name list is 100 in one request. repeated string asset_names = 2; - // Required. The content type. - ContentType content_type = 3; + // Optional. The content type. + ContentType content_type = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. The time window for the asset history. Both start_time and - // end_time are optional and if set, it must be after 2018-10-02 UTC. If - // end_time is not set, it is default to current timestamp. If start_time is - // not set, the snapshot of the assets at end_time will be returned. The - // returned results contain all temporal assets whose time window overlap with - // read_time_window. - TimeWindow read_time_window = 4; + // end_time are optional and if set, it must be after the current time minus + // 35 days. If end_time is not set, it is default to current timestamp. + // If start_time is not set, the snapshot of the assets at end_time will be + // returned. The returned results contain all temporal assets whose time + // window overlap with read_time_window. + TimeWindow read_time_window = 4 [(google.api.field_behavior) = OPTIONAL]; } // Batch get assets history response. @@ -136,12 +230,90 @@ message BatchGetAssetsHistoryResponse { repeated TemporalAsset assets = 1; } +// Create asset feed request. +message CreateFeedRequest { + // Required. The name of the project/folder/organization where this feed + // should be created in. It can only be an organization number (such as + // "organizations/123"), a folder number (such as "folders/123"), a project ID + // (such as "projects/my-project-id")", or a project number (such as + // "projects/12345"). + string parent = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. This is the client-assigned asset feed identifier and it needs to + // be unique under a specific parent project/folder/organization. + string feed_id = 2 [(google.api.field_behavior) = REQUIRED]; + + // Required. The feed details. The field `name` must be empty and it will be + // generated in the format of: projects/project_number/feeds/feed_id + // folders/folder_number/feeds/feed_id + // organizations/organization_number/feeds/feed_id + Feed feed = 3 [(google.api.field_behavior) = REQUIRED]; +} + +// Get asset feed request. +message GetFeedRequest { + // Required. The name of the Feed and it must be in the format of: + // projects/project_number/feeds/feed_id + // folders/folder_number/feeds/feed_id + // organizations/organization_number/feeds/feed_id + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { type: "cloudasset.googleapis.com/Feed" } + ]; +} + +// List asset feeds request. +message ListFeedsRequest { + // Required. The parent project/folder/organization whose feeds are to be + // listed. It can only be using project/folder/organization number (such as + // "folders/12345")", or a project ID (such as "projects/my-project-id"). + string parent = 1 [(google.api.field_behavior) = REQUIRED]; +} + +message ListFeedsResponse { + // A list of feeds. + repeated Feed feeds = 1; +} + +// Update asset feed request. +message UpdateFeedRequest { + // Required. The new values of feed details. It must match an existing feed + // and the field `name` must be in the format of: + // projects/project_number/feeds/feed_id or + // folders/folder_number/feeds/feed_id or + // organizations/organization_number/feeds/feed_id. + Feed feed = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. Only updates the `feed` fields indicated by this mask. + // The field mask must not be empty, and it must not contain fields that + // are immutable or only set by the server. + google.protobuf.FieldMask update_mask = 2 + [(google.api.field_behavior) = REQUIRED]; +} + +message DeleteFeedRequest { + // Required. The name of the feed and it must be in the format of: + // projects/project_number/feeds/feed_id + // folders/folder_number/feeds/feed_id + // organizations/organization_number/feeds/feed_id + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { type: "cloudasset.googleapis.com/Feed" } + ]; +} + // Output configuration for export assets destination. message OutputConfig { // Asset export destination. oneof destination { // Destination on Cloud Storage. GcsDestination gcs_destination = 1; + + // Destination on BigQuery. The output table stores the fields in asset + // proto as columns in BigQuery. The resource/iam_policy field is converted + // to a record with each field to a column, except metadata to a single JSON + // string. + BigQueryDestination bigquery_destination = 2; } } @@ -155,9 +327,257 @@ message GcsDestination { // Metadata](https://cloud.google.com/storage/docs/viewing-editing-metadata) // for more information. string uri = 1; + + // The uri prefix of all generated Cloud Storage objects. For example: + // "gs://bucket_name/object_name_prefix". Each object uri is in format: + // "gs://bucket_name/object_name_prefix// and only + // contains assets for that type. starts from 0. For example: + // "gs://bucket_name/object_name_prefix/compute.googleapis.com/Disk/0" is + // the first shard of output objects containing all + // compute.googleapis.com/Disk assets. An INVALID_ARGUMENT error will be + // returned if file with the same name "gs://bucket_name/object_name_prefix" + // already exists. + string uri_prefix = 2; } } +// A BigQuery destination. +message BigQueryDestination { + // Required. The BigQuery dataset in format + // "projects/projectId/datasets/datasetId", to which the snapshot result + // should be exported. If this dataset does not exist, the export call returns + // an INVALID_ARGUMENT error. + string dataset = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The BigQuery table to which the snapshot result should be + // written. If this table does not exist, a new table with the given name + // will be created. + string table = 2 [(google.api.field_behavior) = REQUIRED]; + + // If the destination table already exists and this flag is `TRUE`, the + // table will be overwritten by the contents of assets snapshot. If the flag + // is `FALSE` or unset and the destination table already exists, the export + // call returns an INVALID_ARGUMEMT error. + bool force = 3; +} + +// A Pub/Sub destination. +message PubsubDestination { + // The name of the Pub/Sub topic to publish to. + // For example: `projects/PROJECT_ID/topics/TOPIC_ID`. + string topic = 1; +} + +// Output configuration for asset feed destination. +message FeedOutputConfig { + // Asset feed destination. + oneof destination { + // Destination on Pub/Sub. + PubsubDestination pubsub_destination = 1; + } +} + +// An asset feed used to export asset updates to a destinations. +// An asset feed filter controls what updates are exported. +// The asset feed must be created within a project, organization, or +// folder. Supported destinations are: +// Pub/Sub topics. +message Feed { + option (google.api.resource) = { + type: "cloudasset.googleapis.com/Feed" + pattern: "projects/{project}/feeds/{feed}" + pattern: "folders/{folder}/feeds/{feed}" + pattern: "organizations/{organization}/feeds/{feed}" + history: ORIGINALLY_SINGLE_PATTERN + }; + + // Required. The format will be + // projects/{project_number}/feeds/{client-assigned_feed_identifier} or + // folders/{folder_number}/feeds/{client-assigned_feed_identifier} or + // organizations/{organization_number}/feeds/{client-assigned_feed_identifier} + // + // The client-assigned feed identifier must be unique within the parent + // project/folder/organization. + string name = 1 [(google.api.field_behavior) = REQUIRED]; + + // A list of the full names of the assets to receive updates. You must specify + // either or both of asset_names and asset_types. Only asset updates matching + // specified asset_names and asset_types are exported to the feed. For + // example: + // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`. + // See [Resource + // Names](https://cloud.google.com/apis/design/resource_names#full_resource_name) + // for more info. + repeated string asset_names = 2; + + // A list of types of the assets to receive updates. You must specify either + // or both of asset_names and asset_types. Only asset updates matching + // specified asset_names and asset_types are exported to the feed. + // For example: `"compute.googleapis.com/Disk"` + // + // See [this + // topic](https://cloud.google.com/asset-inventory/docs/supported-asset-types) + // for a list of all supported asset types. + repeated string asset_types = 3; + + // Asset content type. If not specified, no content but the asset name and + // type will be returned. + ContentType content_type = 4; + + // Required. Feed output configuration defining where the asset updates are + // published to. + FeedOutputConfig feed_output_config = 5 + [(google.api.field_behavior) = REQUIRED]; +} + +// Search all resources request. +message SearchAllResourcesRequest { + // Required. A scope can be a project, a folder or an organization. The search + // is limited to the resources within the `scope`. + // + // The allowed values are: + // + // * projects/{PROJECT_ID} + // * projects/{PROJECT_NUMBER} + // * folders/{FOLDER_NUMBER} + // * organizations/{ORGANIZATION_NUMBER} + string scope = 1 [(google.api.field_behavior) = REQUIRED]; + + // Optional. The query statement. An empty query can be specified to search + // all the resources of certain `asset_types` within the given `scope`. + // + // Examples: + // + // * `name : "Important"` to find Cloud resources whose name contains + // "Important" as a word. + // * `displayName : "Impor*"` to find Cloud resources whose display name + // contains "Impor" as a word prefix. + // * `description : "*por*"` to find Cloud resources whose description + // contains "por" as a substring. + // * `location : "us-west*"` to find Cloud resources whose location is + // prefixed with "us-west". + // * `labels : "prod"` to find Cloud resources whose labels contain "prod" as + // a key or value. + // * `labels.env : "prod"` to find Cloud resources which have a label "env" + // and its value is "prod". + // * `labels.env : *` to find Cloud resources which have a label "env". + // * `"Important"` to find Cloud resources which contain "Important" as a word + // in any of the searchable fields. + // * `"Impor*"` to find Cloud resources which contain "Impor" as a word prefix + // in any of the searchable fields. + // * `"*por*"` to find Cloud resources which contain "por" as a substring in + // any of the searchable fields. + // * `("Important" AND location : ("us-west1" OR "global"))` to find Cloud + // resources which contain "Important" as a word in any of the searchable + // fields and are also located in the "us-west1" region or the "global" + // location. + // + // See [how to construct a + // query](https://cloud.google.com/asset-inventory/docs/searching-resources#how_to_construct_a_query) + // for more details. + string query = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. A list of asset types that this request searches for. If empty, + // it will search all the [searchable asset + // types](https://cloud.google.com/asset-inventory/docs/supported-asset-types#searchable_asset_types). + repeated string asset_types = 3 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The page size for search result pagination. Page size is capped + // at 500 even if a larger value is given. If set to zero, server will pick an + // appropriate default. Returned results may be fewer than requested. When + // this happens, there could be more results as long as `next_page_token` is + // returned. + int32 page_size = 4 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. If present, then retrieve the next batch of results from the + // preceding call to this method. `page_token` must be the value of + // `next_page_token` from the previous response. The values of all other + // method parameters, must be identical to those in the previous call. + string page_token = 5 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. A comma separated list of fields specifying the sorting order of + // the results. The default order is ascending. Add " DESC" after the field + // name to indicate descending order. Redundant space characters are ignored. + // Example: "location DESC, name". See [supported resource metadata + // fields](https://cloud.google.com/asset-inventory/docs/searching-resources#query_on_resource_metadata_fields) + // for more details. + string order_by = 6 [(google.api.field_behavior) = OPTIONAL]; +} + +// Search all resources response. +message SearchAllResourcesResponse { + // A list of Resources that match the search query. It contains the resource + // standard metadata information. + repeated ResourceSearchResult results = 1; + + // If there are more results than those appearing in this response, then + // `next_page_token` is included. To get the next set of results, call this + // method again using the value of `next_page_token` as `page_token`. + string next_page_token = 2; +} + +// Search all IAM policies request. +message SearchAllIamPoliciesRequest { + // Required. A scope can be a project, a folder or an organization. The search + // is limited to the IAM policies within the `scope`. + // + // The allowed values are: + // + // * projects/{PROJECT_ID} + // * projects/{PROJECT_NUMBER} + // * folders/{FOLDER_NUMBER} + // * organizations/{ORGANIZATION_NUMBER} + string scope = 1 [(google.api.field_behavior) = REQUIRED]; + + // Optional. The query statement. An empty query can be specified to search + // all the IAM policies within the given `scope`. + // + // Examples: + // + // * `policy : "amy@gmail.com"` to find Cloud IAM policy bindings that + // specify user "amy@gmail.com". + // * `policy : "roles/compute.admin"` to find Cloud IAM policy bindings that + // specify the Compute Admin role. + // * `policy.role.permissions : "storage.buckets.update"` to find Cloud IAM + // policy bindings that specify a role containing "storage.buckets.update" + // permission. + // * `resource : "organizations/123"` to find Cloud IAM policy bindings that + // are set on "organizations/123". + // * `(resource : ("organizations/123" OR "folders/1234") AND policy : "amy")` + // to find Cloud IAM policy bindings that are set on "organizations/123" or + // "folders/1234", and also specify user "amy". + // + // See [how to construct a + // query](https://cloud.google.com/asset-inventory/docs/searching-iam-policies#how_to_construct_a_query) + // for more details. + string query = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The page size for search result pagination. Page size is capped + // at 500 even if a larger value is given. If set to zero, server will pick an + // appropriate default. Returned results may be fewer than requested. When + // this happens, there could be more results as long as `next_page_token` is + // returned. + int32 page_size = 3 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. If present, retrieve the next batch of results from the preceding + // call to this method. `page_token` must be the value of `next_page_token` + // from the previous response. The values of all other method parameters must + // be identical to those in the previous call. + string page_token = 4 [(google.api.field_behavior) = OPTIONAL]; +} + +// Search all IAM policies response. +message SearchAllIamPoliciesResponse { + // A list of IamPolicy that match the search query. Related information such + // as the associated resource is returned along with the policy. + repeated IamPolicySearchResult results = 1; + + // Set if there are more results than those appearing in this response; to get + // the next set of results, call this method again, using this value as the + // `page_token`. + string next_page_token = 2; +} + // Asset content type. enum ContentType { // Unspecified content type. @@ -168,4 +588,10 @@ enum ContentType { // The actual IAM policy set on a resource. IAM_POLICY = 2; + + // The Cloud Organization Policy set on an asset. + ORG_POLICY = 4; + + // The Cloud Access context mananger Policy set on an asset. + ACCESS_POLICY = 5; } diff --git a/third_party/googleapis/google/cloud/asset/v1/assets.proto b/third_party/googleapis/google/cloud/asset/v1/assets.proto index f6a8108c0..4e537d5ce 100644 --- a/third_party/googleapis/google/cloud/asset/v1/assets.proto +++ b/third_party/googleapis/google/cloud/asset/v1/assets.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,18 +11,23 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.asset.v1; import "google/api/annotations.proto"; +import "google/api/resource.proto"; +import "google/cloud/orgpolicy/v1/orgpolicy.proto"; import "google/iam/v1/policy.proto"; +import "google/identity/accesscontextmanager/v1/access_level.proto"; +import "google/identity/accesscontextmanager/v1/access_policy.proto"; +import "google/identity/accesscontextmanager/v1/service_perimeter.proto"; import "google/protobuf/any.proto"; import "google/protobuf/struct.proto"; import "google/protobuf/timestamp.proto"; +option cc_enable_arenas = true; option csharp_namespace = "Google.Cloud.Asset.V1"; option go_package = "google.golang.org/genproto/googleapis/cloud/asset/v1;asset"; option java_multiple_files = true; @@ -30,73 +35,122 @@ option java_outer_classname = "AssetProto"; option java_package = "com.google.cloud.asset.v1"; option php_namespace = "Google\\Cloud\\Asset\\V1"; - -// Temporal asset. In addition to the asset, the temporal asset includes the -// status of the asset and valid from and to time of it. +// An asset in Google Cloud and its temporal metadata, including the time window +// when it was observed and its status during that window. message TemporalAsset { // The time window when the asset data and state was observed. TimeWindow window = 1; - // If the asset is deleted or not. + // Whether the asset has been deleted or not. bool deleted = 2; - // Asset. + // An asset in Google Cloud. Asset asset = 3; } -// A time window of (start_time, end_time]. +// A time window specified by its "start_time" and "end_time". message TimeWindow { // Start time of the time window (exclusive). google.protobuf.Timestamp start_time = 1; - // End time of the time window (inclusive). - // Current timestamp if not specified. + // End time of the time window (inclusive). If not specified, the current + // timestamp is used instead. google.protobuf.Timestamp end_time = 2; } -// Cloud asset. This includes all Google Cloud Platform resources, -// Cloud IAM policies, and other non-GCP assets. +// An asset in Google Cloud. An asset can be any resource in the Google Cloud +// [resource +// hierarchy](https://cloud.google.com/resource-manager/docs/cloud-platform-resource-hierarchy), +// a resource outside the Google Cloud resource hierarchy (such as Google +// Kubernetes Engine clusters and objects), or a Cloud IAM policy. message Asset { + option (google.api.resource) = { + type: "cloudasset.googleapis.com/Asset" + pattern: "*" + }; + // The full name of the asset. For example: - // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`. + // "//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1" + // // See [Resource - // Names](https://cloud.google.com/apis/design/resource_names#full_resource_name) + // names](https://cloud.google.com/apis/design/resource_names#full_resource_name) // for more information. string name = 1; - // Type of the asset. Example: "compute.googleapis.com/Disk". + // The type of the asset. For example: "compute.googleapis.com/Disk" + // + // See [Supported asset + // types](https://cloud.google.com/asset-inventory/docs/supported-asset-types) + // for more information. string asset_type = 2; - // Representation of the resource. + // A representation of the resource. Resource resource = 3; - // Representation of the actual Cloud IAM policy set on a cloud resource. For - // each resource, there must be at most one Cloud IAM policy set on it. + // A representation of the Cloud IAM policy set on a Google Cloud resource. + // There can be a maximum of one Cloud IAM policy set on any given resource. + // In addition, Cloud IAM policies inherit their granted access scope from any + // policies set on parent resources in the resource hierarchy. Therefore, the + // effectively policy is the union of both the policy set on this resource + // and each policy set on all of the resource's ancestry resource levels in + // the hierarchy. See + // [this topic](https://cloud.google.com/iam/docs/policies#inheritance) for + // more information. google.iam.v1.Policy iam_policy = 4; + + // A representation of an [organization + // policy](https://cloud.google.com/resource-manager/docs/organization-policy/overview#organization_policy). + // There can be more than one organization policy with different constraints + // set on a given resource. + repeated google.cloud.orgpolicy.v1.Policy org_policy = 6; + + // A representation of an [access + // policy](https://cloud.google.com/access-context-manager/docs/overview#access-policies). + oneof access_context_policy { + google.identity.accesscontextmanager.v1.AccessPolicy access_policy = 7; + + google.identity.accesscontextmanager.v1.AccessLevel access_level = 8; + + google.identity.accesscontextmanager.v1.ServicePerimeter service_perimeter = + 9; + } + + // The ancestry path of an asset in Google Cloud [resource + // hierarchy](https://cloud.google.com/resource-manager/docs/cloud-platform-resource-hierarchy), + // represented as a list of relative resource names. An ancestry path starts + // with the closest ancestor in the hierarchy and ends at root. If the asset + // is a project, folder, or organization, the ancestry path starts from the + // asset itself. + // + // For example: `["projects/123456789", "folders/5432", "organizations/1234"]` + repeated string ancestors = 10; } -// Representation of a cloud resource. +// A representation of a Google Cloud resource. message Resource { - // The API version. Example: "v1". + // The API version. For example: "v1" string version = 1; // The URL of the discovery document containing the resource's JSON schema. // For example: - // `"https://www.googleapis.com/discovery/v1/apis/compute/v1/rest"`. - // It will be left unspecified for resources without a discovery-based API, - // such as Cloud Bigtable. + // "https://www.googleapis.com/discovery/v1/apis/compute/v1/rest" + // + // This value is unspecified for resources that do not have an API based on a + // discovery document, such as Cloud Bigtable. string discovery_document_uri = 2; - // The JSON schema name listed in the discovery document. - // Example: "Project". It will be left unspecified for resources (such as - // Cloud Bigtable) without a discovery-based API. + // The JSON schema name listed in the discovery document. For example: + // "Project" + // + // This value is unspecified for resources that do not have an API based on a + // discovery document, such as Cloud Bigtable. string discovery_name = 3; - // The REST URL for accessing the resource. An HTTP GET operation using this - // URL returns the resource itself. - // Example: - // `https://cloudresourcemanager.googleapis.com/v1/projects/my-project-123`. - // It will be left unspecified for resources without a REST API. + // The REST URL for accessing the resource. An HTTP `GET` request using this + // URL returns the resource itself. For example: + // "https://cloudresourcemanager.googleapis.com/v1/projects/my-project-123" + // + // This value is unspecified for resources without a REST API. string resource_url = 4; // The full name of the immediate parent of this resource. See @@ -104,15 +158,175 @@ message Resource { // Names](https://cloud.google.com/apis/design/resource_names#full_resource_name) // for more information. // - // For GCP assets, it is the parent resource defined in the [Cloud IAM policy + // For Google Cloud assets, this value is the parent resource defined in the + // [Cloud IAM policy // hierarchy](https://cloud.google.com/iam/docs/overview#policy_hierarchy). // For example: - // `"//cloudresourcemanager.googleapis.com/projects/my_project_123"`. + // "//cloudresourcemanager.googleapis.com/projects/my_project_123" // - // For third-party assets, it is up to the users to define. + // For third-party assets, this field may be set differently. string parent = 5; - // The content of the resource, in which some sensitive fields are scrubbed - // away and may not be present. + // The content of the resource, in which some sensitive fields are removed + // and may not be present. google.protobuf.Struct data = 6; + + // The location of the resource in Google Cloud, such as its zone and region. + // For more information, see https://cloud.google.com/about/locations/. + string location = 8; +} + +// A result of Resource Search, containing information of a cloud resoure. +message ResourceSearchResult { + // The full resource name of this resource. Example: + // "//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1". + // See [Cloud Asset Inventory Resource Name + // Format](https://cloud.google.com/asset-inventory/docs/resource-name-format) + // for more information. + // + // To search against the `name`: + // + // * use a field query. Example: `name : "instance1"` + // * use a free text query. Example: `"instance1"` + string name = 1; + + // The type of this resource. Example: "compute.googleapis.com/Disk". + // + // To search against the `asset_type`: + // + // * specify the `asset_type` field in your search request. + string asset_type = 2; + + // The project that this resource belongs to, in the form of + // projects/{PROJECT_NUMBER}. + // + // To search against the `project`: + // + // * specify the `scope` field as this project in your search request. + string project = 3; + + // The display name of this resource. + // + // To search against the `display_name`: + // + // * use a field query. Example: `displayName : "My Instance"` + // * use a free text query. Example: `"My Instance"` + string display_name = 4; + + // One or more paragraphs of text description of this resource. Maximum length + // could be up to 1M bytes. + // + // To search against the `description`: + // + // * use a field query. Example: `description : "*important instance*"` + // * use a free text query. Example: `"*important instance*"` + string description = 5; + + // Location can be "global", regional like "us-east1", or zonal like + // "us-west1-b". + // + // To search against the `location`: + // + // * use a field query. Example: `location : "us-west*"` + // * use a free text query. Example: `"us-west*"` + string location = 6; + + // Labels associated with this resource. See [Labelling and grouping GCP + // resources](https://cloud.google.com/blog/products/gcp/labelling-and-grouping-your-google-cloud-platform-resources) + // for more information. + // + // To search against the `labels`: + // + // * use a field query, as following: + // - query on any label's key or value. Example: `labels : "prod"` + // - query by a given label. Example: `labels.env : "prod"` + // - query by a given label'sexistence. Example: `labels.env : *` + // * use a free text query. Example: `"prod"` + map labels = 7; + + // Network tags associated with this resource. Like labels, network tags are a + // type of annotations used to group GCP resources. See [Labelling GCP + // resources](https://cloud.google.com/blog/products/gcp/labelling-and-grouping-your-google-cloud-platform-resources) + // for more information. + // + // To search against the `network_tags`: + // + // * use a field query. Example: `networkTags : "internal"` + // * use a free text query. Example: `"internal"` + repeated string network_tags = 8; + + // The additional attributes of this resource. The attributes may vary from + // one resource type to another. Examples: "projectId" for Project, + // "dnsName" for DNS ManagedZone. + // + // To search against the `additional_attributes`: + // + // * use a free text query to match the attributes values. Example: to search + // additional_attributes = { dnsName: "foobar" }, you can issue a query + // `"foobar"`. + google.protobuf.Struct additional_attributes = 9; +} + +// A result of IAM Policy search, containing information of an IAM policy. +message IamPolicySearchResult { + // Explanation about the IAM policy search result. + message Explanation { + // IAM permissions + message Permissions { + // A list of permissions. A sample permission string: "compute.disk.get". + repeated string permissions = 1; + } + + // The map from roles to their included permissions that match the + // permission query (i.e., a query containing `policy.role.permissions:`). + // Example: if query `policy.role.permissions : "compute.disk.get"` + // matches a policy binding that contains owner role, the + // matched_permissions will be {"roles/owner": ["compute.disk.get"]}. The + // roles can also be found in the returned `policy` bindings. Note that the + // map is populated only for requests with permission queries. + map matched_permissions = 1; + } + + // The full resource name of the resource associated with this IAM policy. + // Example: + // "//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1". + // See [Cloud Asset Inventory Resource Name + // Format](https://cloud.google.com/asset-inventory/docs/resource-name-format) + // for more information. + // + // To search against the `resource`: + // + // * use a field query. Example: `resource : "organizations/123"` + string resource = 1; + + // The project that the associated GCP resource belongs to, in the form of + // projects/{PROJECT_NUMBER}. If an IAM policy is set on a resource (like VM + // instance, Cloud Storage bucket), the project field will indicate the + // project that contains the resource. If an IAM policy is set on a folder or + // orgnization, the project field will be empty. + // + // To search against the `project`: + // + // * specify the `scope` field as this project in your search request. + string project = 2; + + // The IAM policy directly set on the given resource. Note that the original + // IAM policy can contain multiple bindings. This only contains the bindings + // that match the given query. For queries that don't contain a constrain on + // policies (e.g., an empty query), this contains all the bindings. + // + // To search against the `policy` bindings: + // + // * use a field query, as following: + // - query by the policy contained members. Example: + // `policy : "amy@gmail.com"` + // - query by the policy contained roles. Example: + // `policy : "roles/compute.admin"` + // - query by the policy contained roles' implied permissions. Example: + // `policy.role.permissions : "compute.instances.create"` + google.iam.v1.Policy policy = 3; + + // Explanation about the IAM policy search result. It contains additional + // information to explain why the search result matches the query. + Explanation explanation = 4; } diff --git a/third_party/googleapis/google/cloud/asset/v1/cloudasset_gapic.legacy.yaml b/third_party/googleapis/google/cloud/asset/v1/cloudasset_gapic.legacy.yaml new file mode 100644 index 000000000..754d5a8d6 --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1/cloudasset_gapic.legacy.yaml @@ -0,0 +1,194 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 1.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.asset.v1 + python: + package_name: google.cloud.asset_v1.gapic + go: + package_name: cloud.google.com/go/asset/apiv1 + csharp: + package_name: Google.Cloud.Asset.V1 + ruby: + package_name: Google::Cloud::Asset::V1 + php: + package_name: Google\Cloud\Asset\V1 + nodejs: + package_name: asset.v1 +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.cloud.asset.v1.AssetService + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: + - name_pattern: projects/{project} + entity_name: project + language_overrides: + - language: csharp + common_resource_name: Google.Api.Gax.ResourceNames.ProjectName + - name_pattern: 'projects/{project}/feeds/{feed}' + entity_name: feed + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - DEADLINE_EXCEEDED + - UNAVAILABLE + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # + # name - The simple name of the method. + # + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce method + # overloads which allow a client to directly pass request message fields as + # method parameters. This information may or may not be used, depending on + # the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request message. + # + # required_fields - Fields that are always required for a request to be + # valid. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a paging + # list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It defines + # which fields match the paging pattern in the request. The request consists + # of a page_size_field and a token_field. The page_size_field is the name of + # the optional field specifying the maximum number of elements to be + # returned in the response. The token_field is the name of the field in the + # request containing the page token. + # The response specifies response information of the list method. It defines + # which fields match the paging pattern in the response. The response + # consists of a token_field and a resources_field. The token_field is the + # name of the field in the response containing the next page token. The + # resources_field is the name of the field in the response containing the + # list of resources belonging to the page. + # + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: ExportAssets + required_fields: + - parent + - output_config + retry_codes_name: non_idempotent + retry_params_name: default + resource_name_treatment: STATIC_TYPES + long_running: + return_type: google.cloud.asset.v1.ExportAssetsResponse + metadata_type: google.cloud.asset.v1.ExportAssetsRequest + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + timeout_millis: 600000 + - name: BatchGetAssetsHistory + required_fields: + - parent + - content_type + - read_time_window + retry_codes_name: idempotent + retry_params_name: default + resource_name_treatment: STATIC_TYPES + timeout_millis: 600000 + - name: CreateFeed + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + - feed_id + - feed + retry_codes_name: non_idempotent + retry_params_name: default + timeout_millis: 30000 + - name: GetFeed + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: feed + timeout_millis: 10000 + - name: ListFeeds + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + retry_codes_name: idempotent + retry_params_name: default + timeout_millis: 10000 + - name: UpdateFeed + flattening: + groups: + - parameters: + - feed + required_fields: + - feed + - update_mask + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + feed.name: feed + timeout_millis: 30000 + - name: DeleteFeed + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: feed + timeout_millis: 30000 +resource_name_generation: +- message_name: ExportAssetsRequest + field_entity_map: + parent: project +- message_name: BatchGetAssetsHistoryRequest + field_entity_map: + parent: project diff --git a/third_party/googleapis/google/cloud/asset/v1/cloudasset_gapic.yaml b/third_party/googleapis/google/cloud/asset/v1/cloudasset_gapic.yaml index 9d60f1042..4e0d26236 100644 --- a/third_party/googleapis/google/cloud/asset/v1/cloudasset_gapic.yaml +++ b/third_party/googleapis/google/cloud/asset/v1/cloudasset_gapic.yaml @@ -1,5 +1,5 @@ type: com.google.api.codegen.ConfigProto -config_schema_version: 1.0.0 +config_schema_version: 2.0.0 # The settings of generated code in a specific language. language_settings: java: @@ -16,127 +16,8 @@ language_settings: package_name: Google\Cloud\Asset\V1 nodejs: package_name: asset.v1 -# A list of API interface configurations. interfaces: - # The fully qualified name of the API interface. - name: google.cloud.asset.v1.AssetService - # A list of resource collection configurations. - # Consists of a name_pattern and an entity_name. - # The name_pattern is a pattern to describe the names of the resources of this - # collection, using the platform's conventions for URI patterns. A generator - # may use this to generate methods to compose and decompose such names. The - # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; - # those will be taken as hints for the parameter names of the generated - # methods. If empty, no name methods are generated. - # The entity_name is the name to be used as a basis for generated methods and - # classes. - collections: - - name_pattern: projects/{project} - entity_name: project - language_overrides: - - language: csharp - common_resource_name: Google.Api.Gax.ResourceNames.ProjectName - # Definition for retryable codes. - retry_codes_def: - - name: idempotent - retry_codes: - - DEADLINE_EXCEEDED - - UNAVAILABLE - - name: non_idempotent - retry_codes: [] - # Definition for retry/backoff parameters. - retry_params_def: - - name: default - initial_retry_delay_millis: 100 - retry_delay_multiplier: 1.3 - max_retry_delay_millis: 60000 - initial_rpc_timeout_millis: 20000 - rpc_timeout_multiplier: 1 - max_rpc_timeout_millis: 20000 - total_timeout_millis: 600000 - # A list of method configurations. - # Common properties: - # - # name - The simple name of the method. - # - # flattening - Specifies the configuration for parameter flattening. - # Describes the parameter groups for which a generator should produce method - # overloads which allow a client to directly pass request message fields as - # method parameters. This information may or may not be used, depending on - # the target language. - # Consists of groups, which each represent a list of parameters to be - # flattened. Each parameter listed must be a field of the request message. - # - # required_fields - Fields that are always required for a request to be - # valid. - # - # resource_name_treatment - An enum that specifies how to treat the resource - # name formats defined in the field_name_patterns and - # response_field_name_patterns fields. - # UNSET: default value - # NONE: the collection configs will not be used by the generated code. - # VALIDATE: string fields will be validated by the client against the - # specified resource name formats. - # STATIC_TYPES: the client will use generated types for resource names. - # - # page_streaming - Specifies the configuration for paging. - # Describes information for generating a method which transforms a paging - # list RPC into a stream of resources. - # Consists of a request and a response. - # The request specifies request information of the list method. It defines - # which fields match the paging pattern in the request. The request consists - # of a page_size_field and a token_field. The page_size_field is the name of - # the optional field specifying the maximum number of elements to be - # returned in the response. The token_field is the name of the field in the - # request containing the page token. - # The response specifies response information of the list method. It defines - # which fields match the paging pattern in the response. The response - # consists of a token_field and a resources_field. The token_field is the - # name of the field in the response containing the next page token. The - # resources_field is the name of the field in the response containing the - # list of resources belonging to the page. - # - # retry_codes_name - Specifies the configuration for retryable codes. The - # name must be defined in interfaces.retry_codes_def. - # - # retry_params_name - Specifies the configuration for retry/backoff - # parameters. The name must be defined in interfaces.retry_params_def. - # - # field_name_patterns - Maps the field name of the request type to - # entity_name of interfaces.collections. - # Specifies the string pattern that the field must follow. - # - # timeout_millis - Specifies the default timeout for a non-retrying call. If - # the call is retrying, refer to retry_params_name instead. methods: - - name: ExportAssets - required_fields: - - parent - - output_config - retry_codes_name: non_idempotent - retry_params_name: default - resource_name_treatment: STATIC_TYPES - long_running: - return_type: google.cloud.asset.v1.ExportAssetsResponse - metadata_type: google.cloud.asset.v1.ExportAssetsRequest - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - timeout_millis: 600000 - - name: BatchGetAssetsHistory - required_fields: - - parent - - content_type - - read_time_window + - name: DeleteFeed retry_codes_name: idempotent - retry_params_name: default - resource_name_treatment: STATIC_TYPES - timeout_millis: 600000 -resource_name_generation: -- message_name: ExportAssetsRequest - field_entity_map: - parent: project -- message_name: BatchGetAssetsHistoryRequest - field_entity_map: - parent: project diff --git a/third_party/googleapis/google/cloud/asset/v1/cloudasset_grpc_service_config.json b/third_party/googleapis/google/cloud/asset/v1/cloudasset_grpc_service_config.json new file mode 100755 index 000000000..031b3169a --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1/cloudasset_grpc_service_config.json @@ -0,0 +1,54 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.asset.v1.AssetService", + "method": "ExportAssets" + } + ], + "timeout": "60s" + }, + { + "name": [ + { + "service": "google.cloud.asset.v1.AssetService", + "method": "BatchGetAssetsHistory" + } + ], + "timeout": "60s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.asset.v1.AssetService", + "method": "SearchAllResources" + }, + { + "service": "google.cloud.asset.v1.AssetService", + "method": "SearchAllIamPolicies" + } + ], + "timeout": "15s", + "retryPolicy": { + "maxAttempts": 5, + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/cloud/asset/v1/cloudasset_v1.yaml b/third_party/googleapis/google/cloud/asset/v1/cloudasset_v1.yaml new file mode 100644 index 000000000..dc65c62cf --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1/cloudasset_v1.yaml @@ -0,0 +1,38 @@ +type: google.api.Service +config_version: 3 +name: cloudasset.googleapis.com +title: Cloud Asset API + +apis: +- name: google.cloud.asset.v1.AssetService + +documentation: + summary: The cloud asset API manages the history and inventory of cloud resources. + overview: |- + # Cloud Asset API + + The Cloud Asset API keeps a history of Google Cloud Platform (GCP) asset + metadata, and allows GCP users to download a dump of all asset metadata + for the resource types listed below within an organization or a project at + a given timestamp. + + Read more documents here: + https://cloud.google.com/asset-inventory/docs + +backend: + rules: + - selector: 'google.cloud.asset.v1.AssetService.*' + deadline: 600.0 + - selector: google.longrunning.Operations.GetOperation + deadline: 60.0 + +authentication: + rules: + - selector: 'google.cloud.asset.v1.AssetService.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: google.longrunning.Operations.GetOperation + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/asset/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/asset/v1beta1/BUILD.bazel index 6b2b2ac92..fbf50ebc8 100644 --- a/third_party/googleapis/google/cloud/asset/v1beta1/BUILD.bazel +++ b/third_party/googleapis/google/cloud/asset/v1beta1/BUILD.bazel @@ -1,9 +1,12 @@ +# This file was automatically generated by BuildFileGenerator + # This is an API workspace, having public visibility by default makes perfect sense. package(default_visibility = ["//visibility:public"]) ############################################################################## # Common ############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") proto_library( @@ -14,6 +17,9 @@ proto_library( ], deps = [ "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", "//google/iam/v1:policy_proto", "//google/longrunning:operations_proto", "@com_google_protobuf//:any_proto", @@ -24,7 +30,10 @@ proto_library( proto_library_with_info( name = "asset_proto_with_info", - deps = [":asset_proto"], + deps = [ + ":asset_proto", + "//google/cloud:common_resources_proto", + ], ) ############################################################################## @@ -32,19 +41,13 @@ proto_library_with_info( ############################################################################## load( "@com_google_googleapis_imports//:imports.bzl", - "java_grpc_library", - "java_gapic_library", "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", "java_proto_library", - "java_resource_name_proto_library", - "java_test", ) -_JAVA_GRPC_DEPS = [ - "@com_google_api_grpc_proto_google_common_protos//jar", - "@com_google_api_grpc_proto_google_iam_v1//jar", -] - java_proto_library( name = "asset_java_proto", deps = [":asset_proto"], @@ -53,45 +56,45 @@ java_proto_library( java_grpc_library( name = "asset_java_grpc", srcs = [":asset_proto"], - deps = [":asset_java_proto"] + _JAVA_GRPC_DEPS, + deps = [":asset_java_proto"], ) java_gapic_library( name = "asset_java_gapic", src = ":asset_proto_with_info", gapic_yaml = "cloudasset_gapic.yaml", - service_yaml = "//google/cloud/asset:asset_v1beta1.yaml", - test_deps = [":asset_java_grpc"], - deps = [":asset_java_proto"] + _JAVA_GRPC_DEPS, + package = "google.cloud.asset.v1beta1", + service_yaml = "cloudasset_v1beta1.yaml", + test_deps = [ + ":asset_java_grpc", + "//google/iam/v1:iam_java_grpc", + ], + deps = [ + ":asset_java_proto", + "//google/iam/v1:iam_java_proto", + ], ) -# TODO: configure flattened methods in AssetServiceClient so +# Configure flattened methods in AssetServiceClient so # com.google.cloud.asset.v1beta1.AssetServiceClientTest has actual methods to test (now it is empty, # and Bazel does not allow to run empty test classes (test classes without test methods)). -# -#[java_test( -# name = test_name, -# test_class = test_name, -# runtime_deps = [ -# ":asset_java_gapic_test", -# ], -#) for test_name in [ -# "com.google.cloud.asset.v1beta1.AssetServiceClientTest", -#]] - -# Opensource Packages +java_gapic_test( + name = "asset_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.asset.v1beta1.AssetServiceClientTest", + ], + runtime_deps = [":asset_java_gapic_test"], +) + +# Open Source Packages java_gapic_assembly_gradle_pkg( name = "google-cloud-asset-v1beta1-java", - client_deps = [":asset_java_gapic"], - client_group = "com.google.cloud", - client_test_deps = [":asset_java_gapic_test"], - grpc_deps = [":asset_java_grpc"], - grpc_group = "com.google.api.grpc", - proto_deps = [ + deps = [ + ":asset_java_gapic", + ":asset_java_grpc", ":asset_java_proto", ":asset_proto", - ] + _JAVA_GRPC_DEPS, - version = "0.0.0-SNAPSHOT", + ], ) ############################################################################## @@ -99,10 +102,10 @@ java_gapic_assembly_gradle_pkg( ############################################################################## load( "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", "go_proto_library", "go_test", - "go_gapic_library", - "go_gapic_assembly_pkg", ) go_proto_library( @@ -119,15 +122,19 @@ go_proto_library( go_gapic_library( name = "asset_go_gapic", - src = ":asset_proto_with_info", - gapic_yaml = "cloudasset_gapic.yaml", - importpath = "cloud.google.com/go/asset/apiv1beta1", - service_yaml = "//google/cloud/asset:asset_v1beta1.yaml", + srcs = [":asset_proto_with_info"], + grpc_service_config = "cloudasset_grpc_service_config.json", + importpath = "cloud.google.com/go/asset/apiv1beta1;asset", + service_yaml = "cloudasset_v1beta1.yaml", deps = [ ":asset_go_proto", + "//google/iam/v1:iam_go_proto", "//google/longrunning:longrunning_go_gapic", "//google/longrunning:longrunning_go_proto", "@com_google_cloud_go//longrunning:go_default_library", + "@com_google_cloud_go//longrunning/autogen:go_default_library", + "@io_bazel_rules_go//proto/wkt:any_go_proto", + "@io_bazel_rules_go//proto/wkt:struct_go_proto", ], ) @@ -138,13 +145,237 @@ go_test( importpath = "cloud.google.com/go/asset/apiv1beta1", ) -# Opensource Packages +# Open Source Packages go_gapic_assembly_pkg( name = "gapi-cloud-asset-v1beta1-go", deps = [ ":asset_go_gapic", - ":asset_go_gapic_srcjar-smoke-test.srcjar", ":asset_go_gapic_srcjar-test.srcjar", ":asset_go_proto", ], ) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "asset_moved_proto", + srcs = [":asset_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/iam/v1:policy_proto", + "//google/longrunning:operations_proto", + "@com_google_protobuf//:any_proto", + "@com_google_protobuf//:struct_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +py_proto_library( + name = "asset_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":asset_moved_proto"], +) + +py_grpc_library( + name = "asset_py_grpc", + srcs = [":asset_moved_proto"], + deps = [":asset_py_proto"], +) + +py_gapic_library( + name = "asset_py_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1beta1", + service_yaml = "cloudasset_v1beta1.yaml", + deps = [ + ":asset_py_grpc", + ":asset_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "asset-v1beta1-py", + deps = [ + ":asset_py_gapic", + ":asset_py_grpc", + ":asset_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "asset_php_proto", + deps = [":asset_proto"], +) + +php_grpc_library( + name = "asset_php_grpc", + srcs = [":asset_proto"], + deps = [":asset_php_proto"], +) + +php_gapic_library( + name = "asset_php_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1beta1", + service_yaml = "cloudasset_v1beta1.yaml", + deps = [ + ":asset_php_grpc", + ":asset_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-asset-v1beta1-php", + deps = [ + ":asset_php_gapic", + ":asset_php_grpc", + ":asset_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "asset_nodejs_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1beta1", + service_yaml = "cloudasset_v1beta1.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "asset-v1beta1-nodejs", + deps = [ + ":asset_nodejs_gapic", + ":asset_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "asset_ruby_proto", + deps = [":asset_proto"], +) + +ruby_grpc_library( + name = "asset_ruby_grpc", + srcs = [":asset_proto"], + deps = [":asset_ruby_proto"], +) + +ruby_gapic_library( + name = "asset_ruby_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1beta1", + service_yaml = "cloudasset_v1beta1.yaml", + deps = [ + ":asset_ruby_grpc", + ":asset_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-asset-v1beta1-ruby", + deps = [ + ":asset_ruby_gapic", + ":asset_ruby_grpc", + ":asset_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "asset_csharp_proto", + deps = [":asset_proto"], +) + +csharp_grpc_library( + name = "asset_csharp_grpc", + srcs = [":asset_proto"], + deps = [":asset_csharp_proto"], +) + +csharp_gapic_library( + name = "asset_csharp_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1beta1", + service_yaml = "cloudasset_v1beta1.yaml", + deps = [ + ":asset_csharp_grpc", + ":asset_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-asset-v1beta1-csharp", + deps = [ + ":asset_csharp_gapic", + ":asset_csharp_grpc", + ":asset_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/cloud/asset/v1beta1/asset_service.proto b/third_party/googleapis/google/cloud/asset/v1beta1/asset_service.proto index 8e2d1b0a3..956c6a767 100644 --- a/third_party/googleapis/google/cloud/asset/v1beta1/asset_service.proto +++ b/third_party/googleapis/google/cloud/asset/v1beta1/asset_service.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google LLC. +// Copyright 2019 Google LLC. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -18,6 +18,9 @@ syntax = "proto3"; package google.cloud.asset.v1beta1; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/cloud/asset/v1beta1/assets.proto"; import "google/longrunning/operations.proto"; import "google/protobuf/timestamp.proto"; @@ -31,6 +34,10 @@ option php_namespace = "Google\\Cloud\\Asset\\V1beta1"; // Asset service definition. service AssetService { + option (google.api.default_host) = "cloudasset.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform"; + // Exports assets with time and resource types to a given Cloud Storage // location. The output format is newline-delimited JSON. // This API implements the @@ -49,6 +56,10 @@ service AssetService { body: "*" } }; + option (google.longrunning.operation_info) = { + response_type: "google.cloud.asset.v1beta1.ExportAssetsResponse" + metadata_type: "google.cloud.asset.v1beta1.ExportAssetsRequest" + }; } // Batch gets the update history of assets that overlap a time window. @@ -56,6 +67,8 @@ service AssetService { // non-delete or deleted status. // For IAM_POLICY content, this API outputs history when the asset and its // attached IAM POLICY both exist. This can create gaps in the output history. + // If a specified asset does not exist, this API returns an INVALID_ARGUMENT + // error. rpc BatchGetAssetsHistory(BatchGetAssetsHistoryRequest) returns (BatchGetAssetsHistoryResponse) { option (google.api.http) = { @@ -73,7 +86,12 @@ message ExportAssetsRequest { // organization number (such as "organizations/123"), a project ID (such as // "projects/my-project-id"), a project number (such as "projects/12345"), or // a folder number (such as "folders/123"). - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "cloudasset.googleapis.com/Asset" + } + ]; // Timestamp to take an asset snapshot. This can only be set to a timestamp // between 2018-10-02 UTC (inclusive) and the current time. If not specified, @@ -95,7 +113,7 @@ message ExportAssetsRequest { // Required. Output configuration indicating where the results will be output // to. All results will be in newline delimited JSON format. - OutputConfig output_config = 5; + OutputConfig output_config = 5 [(google.api.field_behavior) = REQUIRED]; } // The export asset response. This message is returned by the @@ -117,7 +135,12 @@ message BatchGetAssetsHistoryRequest { // Required. The relative name of the root asset. It can only be an // organization number (such as "organizations/123"), a project ID (such as // "projects/my-project-id")", or a project number (such as "projects/12345"). - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "cloudasset.googleapis.com/Asset" + } + ]; // A list of the full names of the assets. For example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`. @@ -129,8 +152,8 @@ message BatchGetAssetsHistoryRequest { // size of the asset name list is 100 in one request. repeated string asset_names = 2; - // Required. The content type. - ContentType content_type = 3; + // Optional. The content type. + ContentType content_type = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. The time window for the asset history. Both start_time and // end_time are optional and if set, it must be after 2018-10-02 UTC. If @@ -138,7 +161,7 @@ message BatchGetAssetsHistoryRequest { // not set, the snapshot of the assets at end_time will be returned. The // returned results contain all temporal assets whose time window overlap with // read_time_window. - TimeWindow read_time_window = 4; + TimeWindow read_time_window = 4 [(google.api.field_behavior) = OPTIONAL]; } // Batch get assets history response. @@ -166,6 +189,16 @@ message GcsDestination { // Metadata](https://cloud.google.com/storage/docs/viewing-editing-metadata) // for more information. string uri = 1; + + // The uri prefix of all generated Cloud Storage objects. For example: + // "gs://bucket_name/object_name_prefix". Each object uri is in format: + // "gs://bucket_name/object_name_prefix// and only + // contains assets for that type. starts from 0. For example: + // "gs://bucket_name/object_name_prefix/google.compute.disk/0" is the first + // shard of output objects containing all google.compute.disk assets. + // An INVALID_ARGUMENT error will be returned if file with the same name + // "gs://bucket_name/object_name_prefix" already exists. + string uri_prefix = 2; } } diff --git a/third_party/googleapis/google/cloud/asset/v1beta1/assets.proto b/third_party/googleapis/google/cloud/asset/v1beta1/assets.proto index 84db977b9..4bb1438c8 100644 --- a/third_party/googleapis/google/cloud/asset/v1beta1/assets.proto +++ b/third_party/googleapis/google/cloud/asset/v1beta1/assets.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google LLC. +// Copyright 2019 Google LLC. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -18,11 +18,13 @@ syntax = "proto3"; package google.cloud.asset.v1beta1; import "google/api/annotations.proto"; +import "google/api/resource.proto"; import "google/iam/v1/policy.proto"; import "google/protobuf/any.proto"; import "google/protobuf/struct.proto"; import "google/protobuf/timestamp.proto"; +option cc_enable_arenas = true; option csharp_namespace = "Google.Cloud.Asset.V1Beta1"; option go_package = "google.golang.org/genproto/googleapis/cloud/asset/v1beta1;asset"; option java_multiple_files = true; @@ -56,6 +58,11 @@ message TimeWindow { // Cloud asset. This includes all Google Cloud Platform resources, // Cloud IAM policies, and other non-GCP assets. message Asset { + option (google.api.resource) = { + type: "cloudasset.googleapis.com/Asset" + pattern: "*" + }; + // The full name of the asset. For example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`. // See [Resource diff --git a/third_party/googleapis/google/cloud/asset/v1beta1/cloudasset_gapic.legacy.yaml b/third_party/googleapis/google/cloud/asset/v1beta1/cloudasset_gapic.legacy.yaml new file mode 100644 index 000000000..d88a59238 --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1beta1/cloudasset_gapic.legacy.yaml @@ -0,0 +1,146 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 1.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.asset.v1beta1 + python: + package_name: google.cloud.asset_v1beta1.gapic + go: + package_name: cloud.google.com/go/asset/apiv1beta1 + csharp: + package_name: Google.Cloud.Asset.V1Beta1 + ruby: + package_name: Google::Cloud::Asset::V1beta1 + php: + package_name: Google\Cloud\Asset\V1beta1 + nodejs: + package_name: asset.v1beta1 +# A list of API interface configurations. +interfaces: + # The fully qualified name of the API interface. +- name: google.cloud.asset.v1beta1.AssetService + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: + - name_pattern: projects/{project} + entity_name: project + language_overrides: + - language: csharp + common_resource_name: Google.Api.Gax.ResourceNames.ProjectName + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - DEADLINE_EXCEEDED + - UNAVAILABLE + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # + # name - The simple name of the method. + # + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce method + # overloads which allow a client to directly pass request message fields as + # method parameters. This information may or may not be used, depending on + # the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request message. + # + # required_fields - Fields that are always required for a request to be + # valid. + # + # resource_name_treatment - An enum that specifies how to treat the resource + # name formats defined in the field_name_patterns and + # response_field_name_patterns fields. + # UNSET: default value + # NONE: the collection configs will not be used by the generated code. + # VALIDATE: string fields will be validated by the client against the + # specified resource name formats. + # STATIC_TYPES: the client will use generated types for resource names. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a paging + # list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It defines + # which fields match the paging pattern in the request. The request consists + # of a page_size_field and a token_field. The page_size_field is the name of + # the optional field specifying the maximum number of elements to be + # returned in the response. The token_field is the name of the field in the + # request containing the page token. + # The response specifies response information of the list method. It defines + # which fields match the paging pattern in the response. The response + # consists of a token_field and a resources_field. The token_field is the + # name of the field in the response containing the next page token. The + # resources_field is the name of the field in the response containing the + # list of resources belonging to the page. + # + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: ExportAssets + required_fields: + - parent + - output_config + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: project + resource_name_treatment: STATIC_TYPES + long_running: + return_type: google.cloud.asset.v1beta1.ExportAssetsResponse + metadata_type: google.cloud.asset.v1beta1.ExportAssetsRequest + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + timeout_millis: 600000 + - name: BatchGetAssetsHistory + required_fields: + - parent + - content_type + - read_time_window + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: project + resource_name_treatment: STATIC_TYPES + timeout_millis: 600000 +resource_name_generation: +- message_name: ExportAssetsRequest + field_entity_map: + parent: project +- message_name: BatchGetAssetsHistoryRequest + field_entity_map: + parent: project diff --git a/third_party/googleapis/google/cloud/asset/v1beta1/cloudasset_gapic.yaml b/third_party/googleapis/google/cloud/asset/v1beta1/cloudasset_gapic.yaml index d88a59238..8081d9ea4 100644 --- a/third_party/googleapis/google/cloud/asset/v1beta1/cloudasset_gapic.yaml +++ b/third_party/googleapis/google/cloud/asset/v1beta1/cloudasset_gapic.yaml @@ -1,5 +1,5 @@ type: com.google.api.codegen.ConfigProto -config_schema_version: 1.0.0 +config_schema_version: 2.0.0 # The settings of generated code in a specific language. language_settings: java: @@ -20,127 +20,10 @@ language_settings: interfaces: # The fully qualified name of the API interface. - name: google.cloud.asset.v1beta1.AssetService - # A list of resource collection configurations. - # Consists of a name_pattern and an entity_name. - # The name_pattern is a pattern to describe the names of the resources of this - # collection, using the platform's conventions for URI patterns. A generator - # may use this to generate methods to compose and decompose such names. The - # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; - # those will be taken as hints for the parameter names of the generated - # methods. If empty, no name methods are generated. - # The entity_name is the name to be used as a basis for generated methods and - # classes. - collections: - - name_pattern: projects/{project} - entity_name: project - language_overrides: - - language: csharp - common_resource_name: Google.Api.Gax.ResourceNames.ProjectName - # Definition for retryable codes. - retry_codes_def: - - name: idempotent - retry_codes: - - DEADLINE_EXCEEDED - - UNAVAILABLE - - name: non_idempotent - retry_codes: [] - # Definition for retry/backoff parameters. - retry_params_def: - - name: default - initial_retry_delay_millis: 100 - retry_delay_multiplier: 1.3 - max_retry_delay_millis: 60000 - initial_rpc_timeout_millis: 20000 - rpc_timeout_multiplier: 1 - max_rpc_timeout_millis: 20000 - total_timeout_millis: 600000 - # A list of method configurations. - # Common properties: - # - # name - The simple name of the method. - # - # flattening - Specifies the configuration for parameter flattening. - # Describes the parameter groups for which a generator should produce method - # overloads which allow a client to directly pass request message fields as - # method parameters. This information may or may not be used, depending on - # the target language. - # Consists of groups, which each represent a list of parameters to be - # flattened. Each parameter listed must be a field of the request message. - # - # required_fields - Fields that are always required for a request to be - # valid. - # - # resource_name_treatment - An enum that specifies how to treat the resource - # name formats defined in the field_name_patterns and - # response_field_name_patterns fields. - # UNSET: default value - # NONE: the collection configs will not be used by the generated code. - # VALIDATE: string fields will be validated by the client against the - # specified resource name formats. - # STATIC_TYPES: the client will use generated types for resource names. - # - # page_streaming - Specifies the configuration for paging. - # Describes information for generating a method which transforms a paging - # list RPC into a stream of resources. - # Consists of a request and a response. - # The request specifies request information of the list method. It defines - # which fields match the paging pattern in the request. The request consists - # of a page_size_field and a token_field. The page_size_field is the name of - # the optional field specifying the maximum number of elements to be - # returned in the response. The token_field is the name of the field in the - # request containing the page token. - # The response specifies response information of the list method. It defines - # which fields match the paging pattern in the response. The response - # consists of a token_field and a resources_field. The token_field is the - # name of the field in the response containing the next page token. The - # resources_field is the name of the field in the response containing the - # list of resources belonging to the page. - # - # retry_codes_name - Specifies the configuration for retryable codes. The - # name must be defined in interfaces.retry_codes_def. - # - # retry_params_name - Specifies the configuration for retry/backoff - # parameters. The name must be defined in interfaces.retry_params_def. - # - # field_name_patterns - Maps the field name of the request type to - # entity_name of interfaces.collections. - # Specifies the string pattern that the field must follow. - # - # timeout_millis - Specifies the default timeout for a non-retrying call. If - # the call is retrying, refer to retry_params_name instead. methods: - name: ExportAssets - required_fields: - - parent - - output_config - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: project - resource_name_treatment: STATIC_TYPES long_running: - return_type: google.cloud.asset.v1beta1.ExportAssetsResponse - metadata_type: google.cloud.asset.v1beta1.ExportAssetsRequest initial_poll_delay_millis: 500 poll_delay_multiplier: 1.5 max_poll_delay_millis: 5000 total_poll_timeout_millis: 300000 - timeout_millis: 600000 - - name: BatchGetAssetsHistory - required_fields: - - parent - - content_type - - read_time_window - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: project - resource_name_treatment: STATIC_TYPES - timeout_millis: 600000 -resource_name_generation: -- message_name: ExportAssetsRequest - field_entity_map: - parent: project -- message_name: BatchGetAssetsHistoryRequest - field_entity_map: - parent: project diff --git a/third_party/googleapis/google/cloud/asset/v1beta1/cloudasset_grpc_service_config.json b/third_party/googleapis/google/cloud/asset/v1beta1/cloudasset_grpc_service_config.json new file mode 100755 index 000000000..e38239344 --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1beta1/cloudasset_grpc_service_config.json @@ -0,0 +1,31 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.asset.v1beta1.AssetService", + "method": "ExportAssets" + } + ], + "timeout": "60s" + }, + { + "name": [ + { + "service": "google.cloud.asset.v1beta1.AssetService", + "method": "BatchGetAssetsHistory" + } + ], + "timeout": "60s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/cloud/asset/asset_v1.yaml b/third_party/googleapis/google/cloud/asset/v1beta1/cloudasset_v1beta1.yaml similarity index 55% rename from third_party/googleapis/google/cloud/asset/asset_v1.yaml rename to third_party/googleapis/google/cloud/asset/v1beta1/cloudasset_v1beta1.yaml index 71c62ee8d..b959cb05b 100644 --- a/third_party/googleapis/google/cloud/asset/asset_v1.yaml +++ b/third_party/googleapis/google/cloud/asset/v1beta1/cloudasset_v1beta1.yaml @@ -4,7 +4,7 @@ name: cloudasset.googleapis.com title: Cloud Asset API apis: -- name: google.cloud.asset.v1.AssetService +- name: google.cloud.asset.v1beta1.AssetService documentation: summary: The cloud asset API manages the history and inventory of cloud resources. @@ -12,21 +12,21 @@ documentation: # Cloud Asset API The Cloud Asset API keeps a history of Google Cloud Platform (GCP) asset - metadata, and allows GCP users to download a dump of all asset metadata for - the resource types listed below within an organization or a project at a - given timestamp. + metadata, and allows GCP users to download a dump of all asset metadata + for the resource types listed below within an organization or a project at + a given timestamp. Read more documents here: - https://cloud.google.com/resource-manager/docs/cloud-asset-inventory/overview + https://cloud.google.com/asset-inventory/docs backend: rules: - - selector: google.longrunning.Operations.GetOperation - deadline: 60.0 - - selector: google.cloud.asset.v1.AssetService.ExportAssets + - selector: google.cloud.asset.v1beta1.AssetService.BatchGetAssetsHistory deadline: 600.0 - - selector: google.cloud.asset.v1.AssetService.BatchGetAssetsHistory + - selector: google.cloud.asset.v1beta1.AssetService.ExportAssets deadline: 600.0 + - selector: google.longrunning.Operations.GetOperation + deadline: 60.0 http: rules: @@ -34,17 +34,19 @@ http: get: '/v1beta1/{name=projects/*/operations/*/**}' additional_bindings: - get: '/v1beta1/{name=folders/*/operations/*/**}' - - get: '/v1beta1/{name=organizations/*/operations/*/**}' - - get: '/v1p1alpha1/{name=*/*/operations/*/**}' - - - get: '/v1/{name=*/*/operations/*/**}' - - authentication: rules: - - selector: '*' + - selector: google.cloud.asset.v1beta1.AssetService.BatchGetAssetsHistory + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: google.cloud.asset.v1beta1.AssetService.ExportAssets + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: google.longrunning.Operations.GetOperation oauth: canonical_scopes: |- https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/asset/v1p1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/asset/v1p1beta1/BUILD.bazel new file mode 100644 index 000000000..f039fdd85 --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1p1beta1/BUILD.bazel @@ -0,0 +1,361 @@ +# This file was automatically generated by BuildFileGenerator + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") +load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") + +proto_library( + name = "asset_proto", + srcs = [ + "asset_service.proto", + "assets.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/iam/v1:policy_proto", + ], +) + +proto_library_with_info( + name = "asset_proto_with_info", + deps = [ + ":asset_proto", + "//google/cloud:common_resources_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", + "java_proto_library", +) + +java_proto_library( + name = "asset_java_proto", + deps = [":asset_proto"], +) + +java_grpc_library( + name = "asset_java_grpc", + srcs = [":asset_proto"], + deps = [":asset_java_proto"], +) + +java_gapic_library( + name = "asset_java_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1p1beta1", + service_yaml = "cloudasset_v1p1beta1.yaml", + test_deps = [ + ":asset_java_grpc", + "//google/iam/v1:iam_java_grpc", + ], + deps = [ + ":asset_java_proto", + "//google/iam/v1:iam_java_proto", + ], +) + +java_gapic_test( + name = "asset_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.asset.v1p1beta1.AssetServiceClientTest", + ], + runtime_deps = [":asset_java_gapic_test"], +) + +# Open Source Packages +java_gapic_assembly_gradle_pkg( + name = "google-cloud-asset-v1p1beta1-java", + deps = [ + ":asset_java_gapic", + ":asset_java_grpc", + ":asset_java_proto", + ":asset_proto", + ], +) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", + "go_proto_library", + "go_test", +) + +go_proto_library( + name = "asset_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/cloud/asset/v1p1beta1", + protos = [":asset_proto"], + deps = [ + "//google/api:annotations_go_proto", + "//google/iam/v1:iam_go_proto", + ], +) + +go_gapic_library( + name = "asset_go_gapic", + srcs = [":asset_proto_with_info"], + grpc_service_config = "cloudasset_grpc_service_config.json", + importpath = "cloud.google.com/go/asset/apiv1p1beta1;asset", + service_yaml = "cloudasset_v1p1beta1.yaml", + deps = [ + ":asset_go_proto", + "//google/iam/v1:iam_go_proto", + ], +) + +go_test( + name = "asset_go_gapic_test", + srcs = [":asset_go_gapic_srcjar_test"], + embed = [":asset_go_gapic"], + importpath = "cloud.google.com/go/asset/apiv1p1beta1", +) + +# Open Source Packages +go_gapic_assembly_pkg( + name = "gapi-cloud-asset-v1p1beta1-go", + deps = [ + ":asset_go_gapic", + ":asset_go_gapic_srcjar-test.srcjar", + ":asset_go_proto", + ], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "asset_moved_proto", + srcs = [":asset_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/iam/v1:policy_proto", + ], +) + +py_proto_library( + name = "asset_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":asset_moved_proto"], +) + +py_grpc_library( + name = "asset_py_grpc", + srcs = [":asset_moved_proto"], + deps = [":asset_py_proto"], +) + +py_gapic_library( + name = "asset_py_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1p1beta1", + service_yaml = "cloudasset_v1p1beta1.yaml", + deps = [ + ":asset_py_grpc", + ":asset_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "asset-v1p1beta1-py", + deps = [ + ":asset_py_gapic", + ":asset_py_grpc", + ":asset_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "asset_php_proto", + deps = [":asset_proto"], +) + +php_grpc_library( + name = "asset_php_grpc", + srcs = [":asset_proto"], + deps = [":asset_php_proto"], +) + +php_gapic_library( + name = "asset_php_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1p1beta1", + service_yaml = "cloudasset_v1p1beta1.yaml", + deps = [ + ":asset_php_grpc", + ":asset_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-asset-v1p1beta1-php", + deps = [ + ":asset_php_gapic", + ":asset_php_grpc", + ":asset_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "asset_nodejs_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1p1beta1", + service_yaml = "cloudasset_v1p1beta1.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "asset-v1p1beta1-nodejs", + deps = [ + ":asset_nodejs_gapic", + ":asset_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "asset_ruby_proto", + deps = [":asset_proto"], +) + +ruby_grpc_library( + name = "asset_ruby_grpc", + srcs = [":asset_proto"], + deps = [":asset_ruby_proto"], +) + +ruby_gapic_library( + name = "asset_ruby_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1p1beta1", + service_yaml = "cloudasset_v1p1beta1.yaml", + deps = [ + ":asset_ruby_grpc", + ":asset_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-asset-v1p1beta1-ruby", + deps = [ + ":asset_ruby_gapic", + ":asset_ruby_grpc", + ":asset_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "asset_csharp_proto", + deps = [":asset_proto"], +) + +csharp_grpc_library( + name = "asset_csharp_grpc", + srcs = [":asset_proto"], + deps = [":asset_csharp_proto"], +) + +csharp_gapic_library( + name = "asset_csharp_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1p1beta1", + service_yaml = "cloudasset_v1p1beta1.yaml", + deps = [ + ":asset_csharp_grpc", + ":asset_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-asset-v1p1beta1-csharp", + deps = [ + ":asset_csharp_gapic", + ":asset_csharp_grpc", + ":asset_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/cloud/asset/v1p1beta1/artman_cloudasset_v1p1beta1.yaml b/third_party/googleapis/google/cloud/asset/v1p1beta1/artman_cloudasset_v1p1beta1.yaml new file mode 100644 index 000000000..ca93339bf --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1p1beta1/artman_cloudasset_v1p1beta1.yaml @@ -0,0 +1,35 @@ +common: + # Keep the api_name asset, otherwise Java code gen will be broken. + api_name: asset + api_version: v1p1beta1 + organization_name: google-cloud + proto_deps: + - name: google-common-protos + src_proto_paths: + - . + service_yaml: cloudasset_v1p1beta1.yaml + gapic_yaml: cloudasset_gapic.yaml +artifacts: +- name: gapic_config + type: GAPIC_CONFIG +- name: java_gapic + type: GAPIC + language: JAVA +- name: python_gapic + type: GAPIC + language: PYTHON +- name: nodejs_gapic + type: GAPIC + language: NODEJS +- name: php_gapic + type: GAPIC + language: PHP +- name: go_gapic + type: GAPIC + language: GO +- name: ruby_gapic + type: GAPIC + language: RUBY +- name: csharp_gapic + type: GAPIC + language: CSHARP diff --git a/third_party/googleapis/google/cloud/asset/v1p1beta1/asset_service.proto b/third_party/googleapis/google/cloud/asset/v1p1beta1/asset_service.proto new file mode 100644 index 000000000..d5a0d8c41 --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1p1beta1/asset_service.proto @@ -0,0 +1,149 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.asset.v1p1beta1; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/cloud/asset/v1p1beta1/assets.proto"; + +option csharp_namespace = "Google.Cloud.Asset.V1P1Beta1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/asset/v1p1beta1;asset"; +option java_multiple_files = true; +option java_outer_classname = "AssetServiceProto"; +option java_package = "com.google.cloud.asset.v1p1beta1"; +option php_namespace = "Google\\Cloud\\Asset\\V1p1beta1"; + +// Asset service definition. +service AssetService { + option (google.api.default_host) = "cloudasset.googleapis.com"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; + + // Searches all the resources under a given accessible CRM scope + // (project/folder/organization). This RPC gives callers + // especially admins the ability to search all the resources under a scope, + // even if they don't have .get permission of all the resources. Callers + // should have cloud.assets.SearchAllResources permission on the requested + // scope, otherwise it will be rejected. + rpc SearchAllResources(SearchAllResourcesRequest) returns (SearchAllResourcesResponse) { + option (google.api.http) = { + get: "/v1p1beta1/{scope=*/*}/resources:searchAll" + }; + option (google.api.method_signature) = "scope,query,asset_types"; + } + + // Searches all the IAM policies under a given accessible CRM scope + // (project/folder/organization). This RPC gives callers + // especially admins the ability to search all the IAM policies under a scope, + // even if they don't have .getIamPolicy permission of all the IAM policies. + // Callers should have cloud.assets.SearchAllIamPolicies permission on the + // requested scope, otherwise it will be rejected. + rpc SearchAllIamPolicies(SearchAllIamPoliciesRequest) returns (SearchAllIamPoliciesResponse) { + option (google.api.http) = { + get: "/v1p1beta1/{scope=*/*}/iamPolicies:searchAll" + }; + option (google.api.method_signature) = "scope,query"; + } +} + +// Search all resources request. +message SearchAllResourcesRequest { + // Required. The relative name of an asset. The search is limited to the resources + // within the `scope`. The allowed value must be: + // * Organization number (such as "organizations/123") + // * Folder number(such as "folders/1234") + // * Project number (such as "projects/12345") + // * Project id (such as "projects/abc") + string scope = 1 [(google.api.field_behavior) = REQUIRED]; + + // Optional. The query statement. + string query = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. A list of asset types that this request searches for. If empty, it will + // search all the supported asset types. + repeated string asset_types = 3 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The page size for search result pagination. Page size is capped at 500 even + // if a larger value is given. If set to zero, server will pick an appropriate + // default. Returned results may be fewer than requested. When this happens, + // there could be more results as long as `next_page_token` is returned. + int32 page_size = 4 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. If present, then retrieve the next batch of results from the preceding call + // to this method. `page_token` must be the value of `next_page_token` from + // the previous response. The values of all other method parameters, must be + // identical to those in the previous call. + string page_token = 5 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. A comma separated list of fields specifying the sorting order of the + // results. The default order is ascending. Add " desc" after the field name + // to indicate descending order. Redundant space characters are ignored. For + // example, " foo , bar desc ". + string order_by = 10 [(google.api.field_behavior) = OPTIONAL]; +} + +// Search all resources response. +message SearchAllResourcesResponse { + // A list of resource that match the search query. + repeated StandardResourceMetadata results = 1; + + // If there are more results than those appearing in this response, then + // `next_page_token` is included. To get the next set of results, call this + // method again using the value of `next_page_token` as `page_token`. + string next_page_token = 2; +} + +// Search all IAM policies request. +message SearchAllIamPoliciesRequest { + // Required. The relative name of an asset. The search is limited to the resources + // within the `scope`. The allowed value must be: + // * Organization number (such as "organizations/123") + // * Folder number(such as "folders/1234") + // * Project number (such as "projects/12345") + // * Project id (such as "projects/abc") + string scope = 1 [(google.api.field_behavior) = REQUIRED]; + + // Optional. The query statement. + // Examples: + // * "policy:myuser@mydomain.com" + // * "policy:(myuser@mydomain.com viewer)" + string query = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The page size for search result pagination. Page size is capped at 500 even + // if a larger value is given. If set to zero, server will pick an appropriate + // default. Returned results may be fewer than requested. When this happens, + // there could be more results as long as `next_page_token` is returned. + int32 page_size = 3 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. If present, retrieve the next batch of results from the preceding call to + // this method. `page_token` must be the value of `next_page_token` from the + // previous response. The values of all other method parameters must be + // identical to those in the previous call. + string page_token = 4 [(google.api.field_behavior) = OPTIONAL]; +} + +// Search all IAM policies response. +message SearchAllIamPoliciesResponse { + // A list of IamPolicy that match the search query. Related information such + // as the associated resource is returned along with the policy. + repeated IamPolicySearchResult results = 1; + + // Set if there are more results than those appearing in this response; to get + // the next set of results, call this method again, using this value as the + // `page_token`. + string next_page_token = 2; +} diff --git a/third_party/googleapis/google/cloud/asset/v1p1beta1/assets.proto b/third_party/googleapis/google/cloud/asset/v1p1beta1/assets.proto new file mode 100644 index 000000000..549ea688b --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1p1beta1/assets.proto @@ -0,0 +1,114 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.asset.v1p1beta1; + +import "google/iam/v1/policy.proto"; +import "google/api/annotations.proto"; + +option cc_enable_arenas = true; +option csharp_namespace = "Google.Cloud.Asset.V1P1Beta1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/asset/v1p1beta1;asset"; +option java_multiple_files = true; +option java_outer_classname = "AssetProto"; +option java_package = "com.google.cloud.asset.v1p1beta1"; +option php_namespace = "Google\\Cloud\\Asset\\V1p1beta1"; + +// The standard metadata of a cloud resource. +message StandardResourceMetadata { + // The full resource name. For example: + // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`. + // See [Resource + // Names](https://cloud.google.com/apis/design/resource_names#full_resource_name) + // for more information. + string name = 1; + + // The type of this resource. + // For example: "compute.googleapis.com/Disk". + string asset_type = 2; + + // The project that this resource belongs to, in the form of + // `projects/{project_number}`. + string project = 3; + + // The display name of this resource. + string display_name = 4; + + // One or more paragraphs of text description of this resource. Maximum length + // could be up to 1M bytes. + string description = 5; + + // Additional searchable attributes of this resource. + // Informational only. The exact set of attributes is subject to change. + // For example: project id, DNS name etc. + repeated string additional_attributes = 10; + + // Location can be "global", regional like "us-east1", or zonal like + // "us-west1-b". + string location = 11; + + // Labels associated with this resource. See [Labelling and grouping GCP + // resources](https://cloud.google.com/blog/products/gcp/labelling-and-grouping-your-google-cloud-platform-resources) + // for more information. + map labels = 12; + + // Network tags associated with this resource. Like labels, network tags are a + // type of annotations used to group GCP resources. See [Labelling GCP + // resources](lhttps://cloud.google.com/blog/products/gcp/labelling-and-grouping-your-google-cloud-platform-resources) + // for more information. + repeated string network_tags = 13; +} + +// The result for a IAM Policy search. +message IamPolicySearchResult { + // Explanation about the IAM policy search result. + message Explanation { + // The map from roles to their included permission matching the permission + // query (e.g. containing `policy.role.permissions:`). A sample role string: + // "roles/compute.instanceAdmin". The roles can also be found in the + // returned `policy` bindings. Note that the map is populated only if + // requesting with a permission query. + map matched_permissions = 1; + } + + // The [full resource + // name](https://cloud.google.com/apis/design/resource_names#full_resource_name) + // of the resource associated with this IAM policy. + string resource = 1; + + // The project that the associated GCP resource belongs to, in the form of + // `projects/{project_number}`. If an IAM policy is set on a resource (like VM + // instance, Cloud Storage bucket), the project field will indicate the + // project that contains the resource. If an IAM policy is set on a folder or + // orgnization, the project field will be empty. + string project = 3; + + // The IAM policy directly set on the given resource. Note that the original + // IAM policy can contain multiple bindings. This only contains the bindings + // that match the given query. For queries that don't contain a constrain on + // policies (e.g. an empty query), this contains all the bindings. + google.iam.v1.Policy policy = 4; + + // Explanation about the IAM policy search result. It contains additional + // information to explain why the search result matches the query. + Explanation explanation = 5; +} + +// IAM permissions +message Permissions { + // A list of permissions. A sample permission string: "compute.disk.get". + repeated string permissions = 1; +} diff --git a/third_party/googleapis/google/cloud/asset/v1p1beta1/cloudasset_gapic.legacy.yaml b/third_party/googleapis/google/cloud/asset/v1p1beta1/cloudasset_gapic.legacy.yaml new file mode 100644 index 000000000..11f29e134 --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1p1beta1/cloudasset_gapic.legacy.yaml @@ -0,0 +1,134 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 1.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.asset.v1p1beta1 + python: + package_name: google.cloud.asset_v1p1beta1.gapic + go: + package_name: cloud.google.com/go/asset/apiv1p1beta1 + csharp: + package_name: Google.Cloud.Asset.V1p1beta1 + ruby: + package_name: Google::Cloud::Asset::V1p1beta1 + php: + package_name: Google\Cloud\Asset\V1p1beta1 + nodejs: + package_name: asset.v1p1beta1 +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.cloud.asset.v1p1beta1.AssetService + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: [] + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - DEADLINE_EXCEEDED + - UNAVAILABLE + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # + # name - The simple name of the method. + # + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce method + # overloads which allow a client to directly pass request message fields as + # method parameters. This information may or may not be used, depending on + # the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request message. + # + # required_fields - Fields that are always required for a request to be + # valid. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a paging + # list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It defines + # which fields match the paging pattern in the request. The request consists + # of a page_size_field and a token_field. The page_size_field is the name of + # the optional field specifying the maximum number of elements to be + # returned in the response. The token_field is the name of the field in the + # request containing the page token. + # The response specifies response information of the list method. It defines + # which fields match the paging pattern in the response. The response + # consists of a token_field and a resources_field. The token_field is the + # name of the field in the response containing the next page token. The + # resources_field is the name of the field in the response containing the + # list of resources belonging to the page. + # + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: SearchAllResources + flattening: + groups: + - parameters: + - scope + - query + - asset_types + required_fields: + - scope + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: results + retry_codes_name: idempotent + retry_params_name: default + timeout_millis: 15000 + - name: SearchAllIamPolicies + flattening: + groups: + - parameters: + - scope + - query + required_fields: + - scope + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: results + retry_codes_name: idempotent + retry_params_name: default + timeout_millis: 15000 diff --git a/third_party/googleapis/google/cloud/asset/v1p1beta1/cloudasset_gapic.yaml b/third_party/googleapis/google/cloud/asset/v1p1beta1/cloudasset_gapic.yaml new file mode 100644 index 000000000..039c76216 --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1p1beta1/cloudasset_gapic.yaml @@ -0,0 +1,22 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 2.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.asset.v1p1beta1 + python: + package_name: google.cloud.asset_v1p1beta1.gapic + go: + package_name: cloud.google.com/go/asset/apiv1p1beta1 + csharp: + package_name: Google.Cloud.Asset.V1p1beta1 + ruby: + package_name: Google::Cloud::Asset::V1p1beta1 + php: + package_name: Google\Cloud\Asset\V1p1beta1 + nodejs: + package_name: asset.v1p1beta1 +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.cloud.asset.v1p1beta1.AssetService diff --git a/third_party/googleapis/google/cloud/asset/v1p1beta1/cloudasset_grpc_service_config.json b/third_party/googleapis/google/cloud/asset/v1p1beta1/cloudasset_grpc_service_config.json new file mode 100755 index 000000000..34b6749d7 --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1p1beta1/cloudasset_grpc_service_config.json @@ -0,0 +1,35 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.asset.v1p1beta1.AssetService", + "method": "SearchResources" + }, + { + "service": "google.cloud.asset.v1p1beta1.AssetService", + "method": "SearchIamPolicies" + }, + { + "service": "google.cloud.asset.v1p1beta1.AssetService", + "method": "SearchAllResources" + }, + { + "service": "google.cloud.asset.v1p1beta1.AssetService", + "method": "SearchAllIamPolicies" + } + ], + "timeout": "15s", + "retryPolicy": { + "maxAttempts": 5, + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/cloud/asset/v1p1beta1/cloudasset_v1p1beta1.yaml b/third_party/googleapis/google/cloud/asset/v1p1beta1/cloudasset_v1p1beta1.yaml new file mode 100644 index 000000000..74aad50aa --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1p1beta1/cloudasset_v1p1beta1.yaml @@ -0,0 +1,44 @@ +type: google.api.Service +config_version: 3 +name: cloudasset.googleapis.com +title: Cloud Asset API + +apis: +- name: google.cloud.asset.v1p1beta1.AssetService + +documentation: + summary: The cloud asset API manages the history and inventory of cloud resources. + overview: |- + # Cloud Asset API + + The Cloud Asset API keeps a history of Google Cloud Platform (GCP) asset + metadata, and allows GCP users to download a dump of all asset metadata + for the resource types listed below within an organization or a project at + a given timestamp. + + Read more documents here: + https://cloud.google.com/asset-inventory/docs + +backend: + rules: + - selector: google.cloud.asset.v1p1beta1.AssetService.SearchAllIamPolicies + deadline: 600.0 + - selector: google.cloud.asset.v1p1beta1.AssetService.SearchAllResources + deadline: 600.0 + - selector: google.longrunning.Operations.GetOperation + deadline: 60.0 + +authentication: + rules: + - selector: google.cloud.asset.v1p1beta1.AssetService.SearchAllIamPolicies + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: google.cloud.asset.v1p1beta1.AssetService.SearchAllResources + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: google.longrunning.Operations.GetOperation + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/asset/v1p2beta1/BUILD.bazel b/third_party/googleapis/google/cloud/asset/v1p2beta1/BUILD.bazel new file mode 100644 index 000000000..45ef0b256 --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1p2beta1/BUILD.bazel @@ -0,0 +1,382 @@ +# This file was automatically generated by BuildFileGenerator + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") +load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") + +proto_library( + name = "asset_proto", + srcs = [ + "asset_service.proto", + "assets.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/iam/v1:policy_proto", + "//google/longrunning:operations_proto", + "@com_google_protobuf//:any_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:struct_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +proto_library_with_info( + name = "asset_proto_with_info", + deps = [ + ":asset_proto", + "//google/cloud:common_resources_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", + "java_proto_library", +) + +java_proto_library( + name = "asset_java_proto", + deps = [":asset_proto"], +) + +java_grpc_library( + name = "asset_java_grpc", + srcs = [":asset_proto"], + deps = [":asset_java_proto"], +) + +java_gapic_library( + name = "asset_java_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1p2beta1", + service_yaml = "cloudasset_v1p2beta1.yaml", + test_deps = [ + ":asset_java_grpc", + "//google/iam/v1:iam_java_grpc", + ], + deps = [ + ":asset_java_proto", + "//google/iam/v1:iam_java_proto", + ], +) + +java_gapic_test( + name = "asset_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.asset.v1p2beta1.AssetServiceClientTest", + ], + runtime_deps = [":asset_java_gapic_test"], +) + +# Open Source Packages +java_gapic_assembly_gradle_pkg( + name = "google-cloud-asset-v1p2beta1-java", + deps = [ + ":asset_java_gapic", + ":asset_java_grpc", + ":asset_java_proto", + ":asset_proto", + ], +) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", + "go_proto_library", + "go_test", +) + +go_proto_library( + name = "asset_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/cloud/asset/v1p2beta1", + protos = [":asset_proto"], + deps = [ + "//google/api:annotations_go_proto", + "//google/iam/v1:iam_go_proto", + "//google/longrunning:longrunning_go_proto", + ], +) + +go_gapic_library( + name = "asset_go_gapic", + srcs = [":asset_proto_with_info"], + grpc_service_config = "cloudasset_grpc_service_config.json", + importpath = "cloud.google.com/go/asset/apiv1p2beta1;asset", + service_yaml = "cloudasset_v1p2beta1.yaml", + deps = [ + ":asset_go_proto", + "//google/iam/v1:iam_go_proto", + "//google/longrunning:longrunning_go_gapic", + "//google/longrunning:longrunning_go_proto", + "@com_google_cloud_go//longrunning:go_default_library", + "@com_google_cloud_go//longrunning/autogen:go_default_library", + "@io_bazel_rules_go//proto/wkt:any_go_proto", + "@io_bazel_rules_go//proto/wkt:struct_go_proto", + ], +) + +go_test( + name = "asset_go_gapic_test", + srcs = [":asset_go_gapic_srcjar_test"], + embed = [":asset_go_gapic"], + importpath = "cloud.google.com/go/asset/apiv1p2beta1", +) + +# Open Source Packages +go_gapic_assembly_pkg( + name = "gapi-cloud-asset-v1p2beta1-go", + deps = [ + ":asset_go_gapic", + ":asset_go_gapic_srcjar-test.srcjar", + ":asset_go_proto", + ], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "asset_moved_proto", + srcs = [":asset_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/iam/v1:policy_proto", + "//google/longrunning:operations_proto", + "@com_google_protobuf//:any_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:struct_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +py_proto_library( + name = "asset_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":asset_moved_proto"], +) + +py_grpc_library( + name = "asset_py_grpc", + srcs = [":asset_moved_proto"], + deps = [":asset_py_proto"], +) + +py_gapic_library( + name = "asset_py_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1p2beta1", + service_yaml = "cloudasset_v1p2beta1.yaml", + deps = [ + ":asset_py_grpc", + ":asset_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "asset-v1p2beta1-py", + deps = [ + ":asset_py_gapic", + ":asset_py_grpc", + ":asset_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "asset_php_proto", + deps = [":asset_proto"], +) + +php_grpc_library( + name = "asset_php_grpc", + srcs = [":asset_proto"], + deps = [":asset_php_proto"], +) + +php_gapic_library( + name = "asset_php_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1p2beta1", + service_yaml = "cloudasset_v1p2beta1.yaml", + deps = [ + ":asset_php_grpc", + ":asset_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-asset-v1p2beta1-php", + deps = [ + ":asset_php_gapic", + ":asset_php_grpc", + ":asset_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "asset_nodejs_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1p2beta1", + service_yaml = "cloudasset_v1p2beta1.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "asset-v1p2beta1-nodejs", + deps = [ + ":asset_nodejs_gapic", + ":asset_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "asset_ruby_proto", + deps = [":asset_proto"], +) + +ruby_grpc_library( + name = "asset_ruby_grpc", + srcs = [":asset_proto"], + deps = [":asset_ruby_proto"], +) + +ruby_gapic_library( + name = "asset_ruby_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1p2beta1", + service_yaml = "cloudasset_v1p2beta1.yaml", + deps = [ + ":asset_ruby_grpc", + ":asset_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-asset-v1p2beta1-ruby", + deps = [ + ":asset_ruby_gapic", + ":asset_ruby_grpc", + ":asset_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "asset_csharp_proto", + deps = [":asset_proto"], +) + +csharp_grpc_library( + name = "asset_csharp_grpc", + srcs = [":asset_proto"], + deps = [":asset_csharp_proto"], +) + +csharp_gapic_library( + name = "asset_csharp_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1p2beta1", + service_yaml = "cloudasset_v1p2beta1.yaml", + deps = [ + ":asset_csharp_grpc", + ":asset_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-asset-v1p2beta1-csharp", + deps = [ + ":asset_csharp_gapic", + ":asset_csharp_grpc", + ":asset_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/cloud/asset/v1p2beta1/asset_service.proto b/third_party/googleapis/google/cloud/asset/v1p2beta1/asset_service.proto new file mode 100644 index 000000000..7925bba68 --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1p2beta1/asset_service.proto @@ -0,0 +1,261 @@ +// Copyright 2019 Google LLC. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// + +syntax = "proto3"; + +package google.cloud.asset.v1p2beta1; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/cloud/asset/v1p2beta1/assets.proto"; +import "google/longrunning/operations.proto"; +import "google/protobuf/empty.proto"; +import "google/protobuf/field_mask.proto"; +import "google/protobuf/timestamp.proto"; + +option csharp_namespace = "Google.Cloud.Asset.V1p2Beta1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/asset/v1p2beta1;asset"; +option java_multiple_files = true; +option java_outer_classname = "AssetServiceProto"; +option java_package = "com.google.cloud.asset.v1p2beta1"; +option php_namespace = "Google\\Cloud\\Asset\\V1p2Beta1"; + +// Asset service definition. +service AssetService { + option (google.api.default_host) = "cloudasset.googleapis.com"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; + + // Creates a feed in a parent project/folder/organization to listen to its + // asset updates. + rpc CreateFeed(CreateFeedRequest) returns (Feed) { + option (google.api.http) = { + post: "/v1p2beta1/{parent=*/*}/feeds" + body: "*" + }; + option (google.api.method_signature) = "parent"; + } + + // Gets details about an asset feed. + rpc GetFeed(GetFeedRequest) returns (Feed) { + option (google.api.http) = { + get: "/v1p2beta1/{name=*/*/feeds/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Lists all asset feeds in a parent project/folder/organization. + rpc ListFeeds(ListFeedsRequest) returns (ListFeedsResponse) { + option (google.api.http) = { + get: "/v1p2beta1/{parent=*/*}/feeds" + }; + option (google.api.method_signature) = "parent"; + } + + // Updates an asset feed configuration. + rpc UpdateFeed(UpdateFeedRequest) returns (Feed) { + option (google.api.http) = { + patch: "/v1p2beta1/{feed.name=*/*/feeds/*}" + body: "*" + }; + option (google.api.method_signature) = "feed"; + } + + // Deletes an asset feed. + rpc DeleteFeed(DeleteFeedRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1p2beta1/{name=*/*/feeds/*}" + }; + option (google.api.method_signature) = "name"; + } +} + +// Create asset feed request. +message CreateFeedRequest { + // Required. The name of the project/folder/organization where this feed + // should be created in. It can only be an organization number (such as + // "organizations/123"), a folder number (such as "folders/123"), a project ID + // (such as "projects/my-project-id")", or a project number (such as + // "projects/12345"). + string parent = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. This is the client-assigned asset feed identifier and it needs to + // be unique under a specific parent project/folder/organization. + string feed_id = 2 [(google.api.field_behavior) = REQUIRED]; + + // Required. The feed details. The field `name` must be empty and it will be generated + // in the format of: + // projects/project_number/feeds/feed_id + // folders/folder_number/feeds/feed_id + // organizations/organization_number/feeds/feed_id + Feed feed = 3 [(google.api.field_behavior) = REQUIRED]; +} + +// Get asset feed request. +message GetFeedRequest { + // Required. The name of the Feed and it must be in the format of: + // projects/project_number/feeds/feed_id + // folders/folder_number/feeds/feed_id + // organizations/organization_number/feeds/feed_id + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudasset.googleapis.com/Feed" + } + ]; +} + +// List asset feeds request. +message ListFeedsRequest { + // Required. The parent project/folder/organization whose feeds are to be + // listed. It can only be using project/folder/organization number (such as + // "folders/12345")", or a project ID (such as "projects/my-project-id"). + string parent = 1 [(google.api.field_behavior) = REQUIRED]; +} + +message ListFeedsResponse { + // A list of feeds. + repeated Feed feeds = 1; +} + +// Update asset feed request. +message UpdateFeedRequest { + // Required. The new values of feed details. It must match an existing feed and the + // field `name` must be in the format of: + // projects/project_number/feeds/feed_id or + // folders/folder_number/feeds/feed_id or + // organizations/organization_number/feeds/feed_id. + Feed feed = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. Only updates the `feed` fields indicated by this mask. + // The field mask must not be empty, and it must not contain fields that + // are immutable or only set by the server. + google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED]; +} + +message DeleteFeedRequest { + // Required. The name of the feed and it must be in the format of: + // projects/project_number/feeds/feed_id + // folders/folder_number/feeds/feed_id + // organizations/organization_number/feeds/feed_id + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudasset.googleapis.com/Feed" + } + ]; +} + +// Output configuration for export assets destination. +message OutputConfig { + // Asset export destination. + oneof destination { + // Destination on Cloud Storage. + GcsDestination gcs_destination = 1; + } +} + +// A Cloud Storage location. +message GcsDestination { + // Required. + oneof object_uri { + // The uri of the Cloud Storage object. It's the same uri that is used by + // gsutil. For example: "gs://bucket_name/object_name". See [Viewing and + // Editing Object + // Metadata](https://cloud.google.com/storage/docs/viewing-editing-metadata) + // for more information. + string uri = 1; + } +} + +// A Cloud Pubsub destination. +message PubsubDestination { + // The name of the Cloud Pub/Sub topic to publish to. + // For example: `projects/PROJECT_ID/topics/TOPIC_ID`. + string topic = 1; +} + +// Output configuration for asset feed destination. +message FeedOutputConfig { + // Asset feed destination. + oneof destination { + // Destination on Cloud Pubsub. + PubsubDestination pubsub_destination = 1; + } +} + +// An asset feed used to export asset updates to a destinations. +// An asset feed filter controls what updates are exported. +// The asset feed must be created within a project, organization, or +// folder. Supported destinations are: +// Cloud Pub/Sub topics. +message Feed { + option (google.api.resource) = { + type: "cloudasset.googleapis.com/Feed" + pattern: "projects/{project}/feeds/{feed}" + pattern: "folders/{folder}/feeds/{feed}" + pattern: "organizations/{organization}/feeds/{feed}" + history: ORIGINALLY_SINGLE_PATTERN + }; + + // Required. The format will be + // projects/{project_number}/feeds/{client-assigned_feed_identifier} or + // folders/{folder_number}/feeds/{client-assigned_feed_identifier} or + // organizations/{organization_number}/feeds/{client-assigned_feed_identifier} + // + // The client-assigned feed identifier must be unique within the parent + // project/folder/organization. + string name = 1 [(google.api.field_behavior) = REQUIRED]; + + // A list of the full names of the assets to receive updates. You must specify + // either or both of asset_names and asset_types. Only asset updates matching + // specified asset_names and asset_types are exported to the feed. For + // example: + // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`. + // See [Resource + // Names](https://cloud.google.com/apis/design/resource_names#full_resource_name) + // for more info. + repeated string asset_names = 2; + + // A list of types of the assets to receive updates. You must specify either + // or both of asset_names and asset_types. Only asset updates matching + // specified asset_names and asset_types are exported to the feed. + // For example: + // "compute.googleapis.com/Disk" See [Introduction to Cloud Asset + // Inventory](https://cloud.google.com/resource-manager/docs/cloud-asset-inventory/overview) + // for all supported asset types. + repeated string asset_types = 3; + + // Asset content type. If not specified, no content but the asset name and + // type will be returned. + ContentType content_type = 4; + + // Required. Feed output configuration defining where the asset updates are + // published to. + FeedOutputConfig feed_output_config = 5 [(google.api.field_behavior) = REQUIRED]; +} + +// Asset content type. +enum ContentType { + // Unspecified content type. + CONTENT_TYPE_UNSPECIFIED = 0; + + // Resource metadata. + RESOURCE = 1; + + // The actual IAM policy set on a resource. + IAM_POLICY = 2; +} diff --git a/third_party/googleapis/google/cloud/asset/v1p2beta1/assets.proto b/third_party/googleapis/google/cloud/asset/v1p2beta1/assets.proto new file mode 100644 index 000000000..8fee229bb --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1p2beta1/assets.proto @@ -0,0 +1,126 @@ +// Copyright 2019 Google LLC. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// + +syntax = "proto3"; + +package google.cloud.asset.v1p2beta1; + +import "google/api/annotations.proto"; +import "google/iam/v1/policy.proto"; +import "google/protobuf/any.proto"; +import "google/protobuf/struct.proto"; +import "google/protobuf/timestamp.proto"; + +option cc_enable_arenas = true; +option csharp_namespace = "Google.Cloud.Asset.v1p2beta1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/asset/v1p2beta1;asset"; +option java_multiple_files = true; +option java_outer_classname = "AssetProto"; +option java_package = "com.google.cloud.asset.v1p2beta1"; +option php_namespace = "Google\\Cloud\\Asset\\v1p2beta1"; + +// Temporal asset. In addition to the asset, the temporal asset includes the +// status of the asset and valid from and to time of it. +message TemporalAsset { + // The time window when the asset data and state was observed. + TimeWindow window = 1; + + // If the asset is deleted or not. + bool deleted = 2; + + // Asset. + Asset asset = 3; +} + +// A time window of (start_time, end_time]. +message TimeWindow { + // Start time of the time window (exclusive). + google.protobuf.Timestamp start_time = 1; + + // End time of the time window (inclusive). + // Current timestamp if not specified. + google.protobuf.Timestamp end_time = 2; +} + +// Cloud asset. This includes all Google Cloud Platform resources, +// Cloud IAM policies, and other non-GCP assets. +message Asset { + // The full name of the asset. For example: + // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`. + // See [Resource + // Names](https://cloud.google.com/apis/design/resource_names#full_resource_name) + // for more information. + string name = 1; + + // Type of the asset. Example: "compute.googleapis.com/Disk". + string asset_type = 2; + + // Representation of the resource. + Resource resource = 3; + + // Representation of the actual Cloud IAM policy set on a cloud resource. For + // each resource, there must be at most one Cloud IAM policy set on it. + google.iam.v1.Policy iam_policy = 4; + + // Asset's ancestry path in Cloud Resource Manager (CRM) hierarchy, + // represented as a list of relative resource names. Ancestry path starts with + // the closest CRM ancestor and ends at root. If the asset is a CRM + // project/folder/organization, this starts from the asset itself. + // + // Example: ["projects/123456789", "folders/5432", "organizations/1234"] + repeated string ancestors = 6; +} + +// Representation of a cloud resource. +message Resource { + // The API version. Example: "v1". + string version = 1; + + // The URL of the discovery document containing the resource's JSON schema. + // For example: + // `"https://www.googleapis.com/discovery/v1/apis/compute/v1/rest"`. + // It will be left unspecified for resources without a discovery-based API, + // such as Cloud Bigtable. + string discovery_document_uri = 2; + + // The JSON schema name listed in the discovery document. + // Example: "Project". It will be left unspecified for resources (such as + // Cloud Bigtable) without a discovery-based API. + string discovery_name = 3; + + // The REST URL for accessing the resource. An HTTP GET operation using this + // URL returns the resource itself. + // Example: + // `https://cloudresourcemanager.googleapis.com/v1/projects/my-project-123`. + // It will be left unspecified for resources without a REST API. + string resource_url = 4; + + // The full name of the immediate parent of this resource. See + // [Resource + // Names](https://cloud.google.com/apis/design/resource_names#full_resource_name) + // for more information. + // + // For GCP assets, it is the parent resource defined in the [Cloud IAM policy + // hierarchy](https://cloud.google.com/iam/docs/overview#policy_hierarchy). + // For example: + // `"//cloudresourcemanager.googleapis.com/projects/my_project_123"`. + // + // For third-party assets, it is up to the users to define. + string parent = 5; + + // The content of the resource, in which some sensitive fields are scrubbed + // away and may not be present. + google.protobuf.Struct data = 6; +} diff --git a/third_party/googleapis/google/cloud/asset/v1p2beta1/cloudasset_gapic.legacy.yaml b/third_party/googleapis/google/cloud/asset/v1p2beta1/cloudasset_gapic.legacy.yaml new file mode 100644 index 000000000..f26588ff5 --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1p2beta1/cloudasset_gapic.legacy.yaml @@ -0,0 +1,158 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 1.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.asset.v1p2beta1 + python: + package_name: google.cloud.asset_v1p2beta1.gapic + go: + package_name: cloud.google.com/go/asset/apiv1p2beta1 + csharp: + package_name: Google.Cloud.Asset.V1p2beta1 + ruby: + package_name: Google::Cloud::Asset::V1p2beta1 + php: + package_name: Google\Cloud\Asset\V1p2beta1 + nodejs: + package_name: asset.v1p2beta1 +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.cloud.asset.v1p2beta1.AssetService + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: + - name_pattern: 'projects/{project}/feeds/{feed}' + entity_name: feed + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - DEADLINE_EXCEEDED + - UNAVAILABLE + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # + # name - The simple name of the method. + # + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce method + # overloads which allow a client to directly pass request message fields as + # method parameters. This information may or may not be used, depending on + # the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request message. + # + # required_fields - Fields that are always required for a request to be + # valid. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a paging + # list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It defines + # which fields match the paging pattern in the request. The request consists + # of a page_size_field and a token_field. The page_size_field is the name of + # the optional field specifying the maximum number of elements to be + # returned in the response. The token_field is the name of the field in the + # request containing the page token. + # The response specifies response information of the list method. It defines + # which fields match the paging pattern in the response. The response + # consists of a token_field and a resources_field. The token_field is the + # name of the field in the response containing the next page token. The + # resources_field is the name of the field in the response containing the + # list of resources belonging to the page. + # + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: CreateFeed + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + - feed_id + - feed + retry_codes_name: non_idempotent + retry_params_name: default + timeout_millis: 30000 + - name: GetFeed + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: feed + timeout_millis: 10000 + - name: ListFeeds + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + retry_codes_name: idempotent + retry_params_name: default + timeout_millis: 10000 + - name: UpdateFeed + flattening: + groups: + - parameters: + - feed + required_fields: + - feed + - update_mask + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + feed.name: feed + timeout_millis: 30000 + - name: DeleteFeed + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: feed + timeout_millis: 30000 diff --git a/third_party/googleapis/google/cloud/asset/v1p2beta1/cloudasset_gapic.yaml b/third_party/googleapis/google/cloud/asset/v1p2beta1/cloudasset_gapic.yaml new file mode 100644 index 000000000..233203a6d --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1p2beta1/cloudasset_gapic.yaml @@ -0,0 +1,25 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 2.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.asset.v1p2beta1 + python: + package_name: google.cloud.asset_v1p2beta1.gapic + go: + package_name: cloud.google.com/go/asset/apiv1p2beta1 + csharp: + package_name: Google.Cloud.Asset.V1p2beta1 + ruby: + package_name: Google::Cloud::Asset::V1p2beta1 + php: + package_name: Google\Cloud\Asset\V1p2beta1 + nodejs: + package_name: asset.v1p2beta1 +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.cloud.asset.v1p2beta1.AssetService + methods: + - name: DeleteFeed + retry_codes_name: idempotent diff --git a/third_party/googleapis/google/cloud/asset/v1p2beta1/cloudasset_grpc_service_config.json b/third_party/googleapis/google/cloud/asset/v1p2beta1/cloudasset_grpc_service_config.json new file mode 100755 index 000000000..7e7147099 --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1p2beta1/cloudasset_grpc_service_config.json @@ -0,0 +1,43 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.asset.v1p2beta1.AssetService", + "method": "CreateFeed" + }, + { + "service": "google.cloud.asset.v1p2beta1.AssetService", + "method": "UpdateFeed" + } + ], + "timeout": "60s" + }, + { + "name": [ + { + "service": "google.cloud.asset.v1p2beta1.AssetService", + "method": "GetFeed" + }, + { + "service": "google.cloud.asset.v1p2beta1.AssetService", + "method": "ListFeeds" + }, + { + "service": "google.cloud.asset.v1p2beta1.AssetService", + "method": "DeleteFeed" + } + ], + "timeout": "60s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/cloud/asset/v1p2beta1/cloudasset_v1p2beta1.yaml b/third_party/googleapis/google/cloud/asset/v1p2beta1/cloudasset_v1p2beta1.yaml new file mode 100644 index 000000000..19bc8819f --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1p2beta1/cloudasset_v1p2beta1.yaml @@ -0,0 +1,38 @@ +type: google.api.Service +config_version: 3 +name: cloudasset.googleapis.com +title: Cloud Asset API + +apis: +- name: google.cloud.asset.v1p2beta1.AssetService + +documentation: + summary: The cloud asset API manages the history and inventory of cloud resources. + overview: |- + # Cloud Asset API + + The Cloud Asset API keeps a history of Google Cloud Platform (GCP) asset + metadata, and allows GCP users to download a dump of all asset metadata + for the resource types listed below within an organization or a project at + a given timestamp. + + Read more documents here: + https://cloud.google.com/asset-inventory/docs + +backend: + rules: + - selector: 'google.cloud.asset.v1p2beta1.AssetService.*' + deadline: 600.0 + - selector: google.longrunning.Operations.GetOperation + deadline: 60.0 + +authentication: + rules: + - selector: 'google.cloud.asset.v1p2beta1.AssetService.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: google.longrunning.Operations.GetOperation + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/asset/v1p4beta1/BUILD.bazel b/third_party/googleapis/google/cloud/asset/v1p4beta1/BUILD.bazel new file mode 100644 index 000000000..f7a8b2233 --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1p4beta1/BUILD.bazel @@ -0,0 +1,374 @@ +# This file was automatically generated by BuildFileGenerator + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") +load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") + +proto_library( + name = "asset_proto", + srcs = [ + "asset_service.proto", + "assets.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/iam/v1:policy_proto", + "//google/longrunning:operations_proto", + "//google/rpc:code_proto", + "@com_google_protobuf//:duration_proto", + ], +) + +proto_library_with_info( + name = "asset_proto_with_info", + deps = [ + ":asset_proto", + "//google/cloud:common_resources_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", + "java_proto_library", +) + +java_proto_library( + name = "asset_java_proto", + deps = [":asset_proto"], +) + +java_grpc_library( + name = "asset_java_grpc", + srcs = [":asset_proto"], + deps = [":asset_java_proto"], +) + +java_gapic_library( + name = "asset_java_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1p4beta1", + service_yaml = "cloudasset_v1p4beta1.yaml", + test_deps = [ + ":asset_java_grpc", + "//google/iam/v1:iam_java_grpc", + ], + deps = [ + ":asset_java_proto", + "//google/iam/v1:iam_java_proto", + ], +) + +java_gapic_test( + name = "asset_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.asset.v1p4beta1.AssetServiceClientTest", + ], + runtime_deps = [":asset_java_gapic_test"], +) + +# Open Source Packages +java_gapic_assembly_gradle_pkg( + name = "google-cloud-asset-v1p4beta1-java", + deps = [ + ":asset_java_gapic", + ":asset_java_grpc", + ":asset_java_proto", + ":asset_proto", + ], +) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", + "go_proto_library", + "go_test", +) + +go_proto_library( + name = "asset_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/cloud/asset/v1p4beta1", + protos = [":asset_proto"], + deps = [ + "//google/api:annotations_go_proto", + "//google/iam/v1:iam_go_proto", + "//google/longrunning:longrunning_go_proto", + "//google/rpc:code_go_proto", + ], +) + +go_gapic_library( + name = "asset_go_gapic", + srcs = [":asset_proto_with_info"], + grpc_service_config = "cloudasset_grpc_service_config.json", + importpath = "cloud.google.com/go/asset/apiv1p4beta1;asset", + service_yaml = "cloudasset_v1p4beta1.yaml", + deps = [ + ":asset_go_proto", + "//google/iam/v1:iam_go_proto", + "//google/longrunning:longrunning_go_gapic", + "//google/longrunning:longrunning_go_proto", + "@com_google_cloud_go//longrunning:go_default_library", + "@com_google_cloud_go//longrunning/autogen:go_default_library", + "@io_bazel_rules_go//proto/wkt:duration_go_proto", + ], +) + +go_test( + name = "asset_go_gapic_test", + srcs = [":asset_go_gapic_srcjar_test"], + embed = [":asset_go_gapic"], + importpath = "cloud.google.com/go/asset/apiv1p4beta1", +) + +# Open Source Packages +go_gapic_assembly_pkg( + name = "gapi-cloud-asset-v1p4beta1-go", + deps = [ + ":asset_go_gapic", + ":asset_go_gapic_srcjar-test.srcjar", + ":asset_go_proto", + ], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "asset_moved_proto", + srcs = [":asset_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/iam/v1:policy_proto", + "//google/longrunning:operations_proto", + "//google/rpc:code_proto", + "@com_google_protobuf//:duration_proto", + ], +) + +py_proto_library( + name = "asset_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":asset_moved_proto"], +) + +py_grpc_library( + name = "asset_py_grpc", + srcs = [":asset_moved_proto"], + deps = [":asset_py_proto"], +) + +py_gapic_library( + name = "asset_py_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1p4beta1", + service_yaml = "cloudasset_v1p4beta1.yaml", + deps = [ + ":asset_py_grpc", + ":asset_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "asset-v1p4beta1-py", + deps = [ + ":asset_py_gapic", + ":asset_py_grpc", + ":asset_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "asset_php_proto", + deps = [":asset_proto"], +) + +php_grpc_library( + name = "asset_php_grpc", + srcs = [":asset_proto"], + deps = [":asset_php_proto"], +) + +php_gapic_library( + name = "asset_php_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1p4beta1", + service_yaml = "cloudasset_v1p4beta1.yaml", + deps = [ + ":asset_php_grpc", + ":asset_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-asset-v1p4beta1-php", + deps = [ + ":asset_php_gapic", + ":asset_php_grpc", + ":asset_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "asset_nodejs_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1p4beta1", + service_yaml = "cloudasset_v1p4beta1.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "asset-v1p4beta1-nodejs", + deps = [ + ":asset_nodejs_gapic", + ":asset_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "asset_ruby_proto", + deps = [":asset_proto"], +) + +ruby_grpc_library( + name = "asset_ruby_grpc", + srcs = [":asset_proto"], + deps = [":asset_ruby_proto"], +) + +ruby_gapic_library( + name = "asset_ruby_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1p4beta1", + service_yaml = "cloudasset_v1p4beta1.yaml", + deps = [ + ":asset_ruby_grpc", + ":asset_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-asset-v1p4beta1-ruby", + deps = [ + ":asset_ruby_gapic", + ":asset_ruby_grpc", + ":asset_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "asset_csharp_proto", + deps = [":asset_proto"], +) + +csharp_grpc_library( + name = "asset_csharp_grpc", + srcs = [":asset_proto"], + deps = [":asset_csharp_proto"], +) + +csharp_gapic_library( + name = "asset_csharp_gapic", + src = ":asset_proto_with_info", + gapic_yaml = "cloudasset_gapic.yaml", + package = "google.cloud.asset.v1p4beta1", + service_yaml = "cloudasset_v1p4beta1.yaml", + deps = [ + ":asset_csharp_grpc", + ":asset_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-asset-v1p4beta1-csharp", + deps = [ + ":asset_csharp_gapic", + ":asset_csharp_grpc", + ":asset_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/cloud/asset/v1p4beta1/asset_service.proto b/third_party/googleapis/google/cloud/asset/v1p4beta1/asset_service.proto new file mode 100644 index 000000000..db60941a5 --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1p4beta1/asset_service.proto @@ -0,0 +1,343 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.asset.v1p4beta1; + +import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/cloud/asset/v1p4beta1/assets.proto"; +import "google/iam/v1/policy.proto"; +import "google/longrunning/operations.proto"; +import "google/protobuf/duration.proto"; +import "google/api/client.proto"; + +option csharp_namespace = "Google.Cloud.Asset.V1P4Beta1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/asset/v1p4beta1;asset"; +option java_multiple_files = true; +option java_outer_classname = "AssetServiceProto"; +option java_package = "com.google.cloud.asset.v1p4beta1"; +option php_namespace = "Google\\Cloud\\Asset\\V1p4beta1"; + +// Asset service definition. +service AssetService { + option (google.api.default_host) = "cloudasset.googleapis.com"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; + + // Analyzes IAM policies based on the specified request. Returns + // a list of [IamPolicyAnalysisResult][google.cloud.asset.v1p4beta1.IamPolicyAnalysisResult] matching the request. + rpc AnalyzeIamPolicy(AnalyzeIamPolicyRequest) returns (AnalyzeIamPolicyResponse) { + option (google.api.http) = { + get: "/v1p4beta1/{analysis_query.parent=*/*}:analyzeIamPolicy" + }; + } + + // Exports IAM policy analysis based on the specified request. This API + // implements the [google.longrunning.Operation][google.longrunning.Operation] API allowing you to keep + // track of the export. The metadata contains the request to help callers to + // map responses to requests. + rpc ExportIamPolicyAnalysis(ExportIamPolicyAnalysisRequest) returns (google.longrunning.Operation) { + option (google.api.http) = { + post: "/v1p4beta1/{analysis_query.parent=*/*}:exportIamPolicyAnalysis" + body: "*" + }; + option (google.longrunning.operation_info) = { + response_type: "google.cloud.asset.v1p4beta1.ExportIamPolicyAnalysisResponse" + metadata_type: "google.cloud.asset.v1p4beta1.ExportIamPolicyAnalysisRequest" + }; + } +} + +// IAM policy analysis query message. +message IamPolicyAnalysisQuery { + // Specifies the resource to analyze for access policies, which may be set + // directly on the resource, or on ancestors such as organizations, folders or + // projects. At least one of [ResourceSelector][google.cloud.asset.v1p4beta1.IamPolicyAnalysisQuery.ResourceSelector], [IdentitySelector][google.cloud.asset.v1p4beta1.IamPolicyAnalysisQuery.IdentitySelector] or + // [AccessSelector][google.cloud.asset.v1p4beta1.IamPolicyAnalysisQuery.AccessSelector] must be specified in a request. + message ResourceSelector { + // Required. The [full resource + // name](https://cloud.google.com/apis/design/resource_names#full_resource_name) + // . + string full_resource_name = 1 [(google.api.field_behavior) = REQUIRED]; + } + + // Specifies an identity for which to determine resource access, based on + // roles assigned either directly to them or to the groups they belong to, + // directly or indirectly. + message IdentitySelector { + // Required. The identity appear in the form of members in + // [IAM policy + // binding](https://cloud.google.com/iam/reference/rest/v1/Binding). + string identity = 1 [(google.api.field_behavior) = REQUIRED]; + } + + // Specifies roles and/or permissions to analyze, to determine both the + // identities possessing them and the resources they control. If multiple + // values are specified, results will include identities and resources + // matching any of them. + message AccessSelector { + // Optional. The roles to appear in result. + repeated string roles = 1 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The permissions to appear in result. + repeated string permissions = 2 [(google.api.field_behavior) = OPTIONAL]; + } + + // Required. The relative name of the root asset. Only resources and IAM policies within + // the parent will be analyzed. This can only be an organization number (such + // as "organizations/123") or a folder number (such as "folders/123"). + string parent = 1 [(google.api.field_behavior) = REQUIRED]; + + // Optional. Specifies a resource for analysis. Leaving it empty means ANY. + ResourceSelector resource_selector = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Specifies an identity for analysis. Leaving it empty means ANY. + IdentitySelector identity_selector = 3 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Specifies roles or permissions for analysis. Leaving it empty + // means ANY. + AccessSelector access_selector = 4 [(google.api.field_behavior) = OPTIONAL]; +} + +// A request message for [AssetService.AnalyzeIamPolicy][google.cloud.asset.v1p4beta1.AssetService.AnalyzeIamPolicy]. +message AnalyzeIamPolicyRequest { + // Contains request options. + message Options { + // Optional. If true, the identities section of the result will expand any + // Google groups appearing in an IAM policy binding. + // + // If [identity_selector][] is specified, the identity in the result will + // be determined by the selector, and this flag will have no effect. + // + // Default is false. + bool expand_groups = 1 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. If true, the access section of result will expand any roles + // appearing in IAM policy bindings to include their permissions. + // + // If [access_selector][] is specified, the access section of the result + // will be determined by the selector, and this flag will have no effect. + // + // Default is false. + bool expand_roles = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. If true, the resource section of the result will expand any + // resource attached to an IAM policy to include resources lower in the + // resource hierarchy. + // + // For example, if the request analyzes for which resources user A has + // permission P, and the results include an IAM policy with P on a GCP + // folder, the results will also include resources in that folder with + // permission P. + // + // If [resource_selector][] is specified, the resource section of the result + // will be determined by the selector, and this flag will have no effect. + // Default is false. + bool expand_resources = 3 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. If true, the result will output resource edges, starting + // from the policy attached resource, to any expanded resources. + // Default is false. + bool output_resource_edges = 4 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. If true, the result will output group identity edges, starting + // from the binding's group members, to any expanded identities. + // Default is false. + bool output_group_edges = 5 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. If true, the response will include access analysis from identities to + // resources via service account impersonation. This is a very expensive + // operation, because many derived queries will be executed. We highly + // recommend you use ExportIamPolicyAnalysis rpc instead. + // + // For example, if the request analyzes for which resources user A has + // permission P, and there's an IAM policy states user A has + // iam.serviceAccounts.getAccessToken permission to a service account SA, + // and there's another IAM policy states service account SA has permission P + // to a GCP folder F, then user A potentially has access to the GCP folder + // F. And those advanced analysis results will be included in + // [AnalyzeIamPolicyResponse.service_account_impersonation_analysis][google.cloud.asset.v1p4beta1.AnalyzeIamPolicyResponse.service_account_impersonation_analysis]. + // + // Another example, if the request analyzes for who has + // permission P to a GCP folder F, and there's an IAM policy states user A + // has iam.serviceAccounts.actAs permission to a service account SA, and + // there's another IAM policy states service account SA has permission P to + // the GCP folder F, then user A potentially has access to the GCP folder + // F. And those advanced analysis results will be included in + // [AnalyzeIamPolicyResponse.service_account_impersonation_analysis][google.cloud.asset.v1p4beta1.AnalyzeIamPolicyResponse.service_account_impersonation_analysis]. + // + // Default is false. + bool analyze_service_account_impersonation = 6 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Amount of time executable has to complete. See JSON representation of + // [Duration](https://developers.google.com/protocol-buffers/docs/proto3#json). + // + // If this field is set with a value less than the RPC deadline, and the + // execution of your query hasn't finished in the specified + // execution timeout, you will get a response with partial result. + // Otherwise, your query's execution will continue until the RPC deadline. + // If it's not finished until then, you will get a DEADLINE_EXCEEDED error. + // + // Default is empty. + google.protobuf.Duration execution_timeout = 7 [(google.api.field_behavior) = OPTIONAL]; + } + + // Required. The request query. + IamPolicyAnalysisQuery analysis_query = 1 [(google.api.field_behavior) = REQUIRED]; + + // Optional. The request options. + Options options = 2 [(google.api.field_behavior) = OPTIONAL]; +} + +// A response message for [AssetService.AnalyzeIamPolicy][google.cloud.asset.v1p4beta1.AssetService.AnalyzeIamPolicy]. +message AnalyzeIamPolicyResponse { + // An analysis message to group the query and results. + message IamPolicyAnalysis { + // The analysis query. + IamPolicyAnalysisQuery analysis_query = 1; + + // A list of [IamPolicyAnalysisResult][google.cloud.asset.v1p4beta1.IamPolicyAnalysisResult] that matches the analysis query, or + // empty if no result is found. + repeated IamPolicyAnalysisResult analysis_results = 2; + + // Represents whether all entries in the [analysis_results][google.cloud.asset.v1p4beta1.AnalyzeIamPolicyResponse.IamPolicyAnalysis.analysis_results] have been + // fully explored to answer the query. + bool fully_explored = 3; + } + + // The main analysis that matches the original request. + IamPolicyAnalysis main_analysis = 1; + + // The service account impersonation analysis if + // [AnalyzeIamPolicyRequest.analyze_service_account_impersonation][] is + // enabled. + repeated IamPolicyAnalysis service_account_impersonation_analysis = 2; + + // Represents whether all entries in the [main_analysis][google.cloud.asset.v1p4beta1.AnalyzeIamPolicyResponse.main_analysis] and + // [service_account_impersonation_analysis][google.cloud.asset.v1p4beta1.AnalyzeIamPolicyResponse.service_account_impersonation_analysis] have been fully explored to + // answer the query in the request. + bool fully_explored = 3; + + // A list of non-critical errors happened during the request handling to + // explain why `fully_explored` is false, or empty if no error happened. + repeated IamPolicyAnalysisResult.AnalysisState non_critical_errors = 4; +} + +// Output configuration for export IAM policy analysis destination. +message IamPolicyAnalysisOutputConfig { + // A Cloud Storage location. + message GcsDestination { + // Required. The uri of the Cloud Storage object. It's the same uri that is used by + // gsutil. For example: "gs://bucket_name/object_name". See [Viewing and + // Editing Object + // Metadata](https://cloud.google.com/storage/docs/viewing-editing-metadata) + // for more information. + string uri = 1 [(google.api.field_behavior) = REQUIRED]; + } + + // IAM policy analysis export destination. + oneof destination { + // Destination on Cloud Storage. + GcsDestination gcs_destination = 1; + } +} + +// A request message for [AssetService.ExportIamPolicyAnalysis][google.cloud.asset.v1p4beta1.AssetService.ExportIamPolicyAnalysis]. +message ExportIamPolicyAnalysisRequest { + // Contains request options. + message Options { + // Optional. If true, the identities section of the result will expand any + // Google groups appearing in an IAM policy binding. + // + // If [identity_selector][] is specified, the identity in the result will + // be determined by the selector, and this flag will have no effect. + // + // Default is false. + bool expand_groups = 1 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. If true, the access section of result will expand any roles + // appearing in IAM policy bindings to include their permissions. + // + // If [access_selector][] is specified, the access section of the result + // will be determined by the selector, and this flag will have no effect. + // + // Default is false. + bool expand_roles = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. If true, the resource section of the result will expand any + // resource attached to an IAM policy to include resources lower in the + // resource hierarchy. + // + // For example, if the request analyzes for which resources user A has + // permission P, and the results include an IAM policy with P on a GCP + // folder, the results will also include resources in that folder with + // permission P. + // + // If [resource_selector][] is specified, the resource section of the result + // will be determined by the selector, and this flag will have no effect. + // Default is false. + bool expand_resources = 3 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. If true, the result will output resource edges, starting + // from the policy attached resource, to any expanded resources. + // Default is false. + bool output_resource_edges = 4 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. If true, the result will output group identity edges, starting + // from the binding's group members, to any expanded identities. + // Default is false. + bool output_group_edges = 5 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. If true, the response will include access analysis from identities to + // resources via service account impersonation. This is a very expensive + // operation, because many derived queries will be executed. + // + // For example, if the request analyzes for which resources user A has + // permission P, and there's an IAM policy states user A has + // iam.serviceAccounts.getAccessToken permission to a service account SA, + // and there's another IAM policy states service account SA has permission P + // to a GCP folder F, then user A potentially has access to the GCP folder + // F. And those advanced analysis results will be included in + // [AnalyzeIamPolicyResponse.service_account_impersonation_analysis][google.cloud.asset.v1p4beta1.AnalyzeIamPolicyResponse.service_account_impersonation_analysis]. + // + // Another example, if the request analyzes for who has + // permission P to a GCP folder F, and there's an IAM policy states user A + // has iam.serviceAccounts.actAs permission to a service account SA, and + // there's another IAM policy states service account SA has permission P to + // the GCP folder F, then user A potentially has access to the GCP folder + // F. And those advanced analysis results will be included in + // [AnalyzeIamPolicyResponse.service_account_impersonation_analysis][google.cloud.asset.v1p4beta1.AnalyzeIamPolicyResponse.service_account_impersonation_analysis]. + // + // Default is false. + bool analyze_service_account_impersonation = 6 [(google.api.field_behavior) = OPTIONAL]; + } + + // Required. The request query. + IamPolicyAnalysisQuery analysis_query = 1 [(google.api.field_behavior) = REQUIRED]; + + // Optional. The request options. + Options options = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Required. Output configuration indicating where the results will be output to. + IamPolicyAnalysisOutputConfig output_config = 3 [(google.api.field_behavior) = REQUIRED]; +} + +// The export IAM policy analysis response. This message is returned by the +// [google.longrunning.Operations.GetOperation][] method in the returned +// [google.longrunning.Operation.response][] field. +message ExportIamPolicyAnalysisResponse { + // Output configuration indicating where the results were output to. + IamPolicyAnalysisOutputConfig output_config = 1; +} diff --git a/third_party/googleapis/google/cloud/asset/v1p4beta1/assets.proto b/third_party/googleapis/google/cloud/asset/v1p4beta1/assets.proto new file mode 100644 index 000000000..0d7c5e055 --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1p4beta1/assets.proto @@ -0,0 +1,167 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.asset.v1p4beta1; + +import "google/iam/v1/policy.proto"; +import "google/rpc/code.proto"; +import "google/api/annotations.proto"; + +option cc_enable_arenas = true; +option csharp_namespace = "Google.Cloud.Asset.V1P4Beta1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/asset/v1p4beta1;asset"; +option java_multiple_files = true; +option java_outer_classname = "AssetProto"; +option java_package = "com.google.cloud.asset.v1p4beta1"; +option php_namespace = "Google\\Cloud\\Asset\\V1p4beta1"; + +// IAM Policy analysis result, consisting of one IAM policy binding and derived +// access control lists. +message IamPolicyAnalysisResult { + // Represents analysis state of each node in the result graph or non-critical + // errors in the response. + message AnalysisState { + // The Google standard error code that best describes the state. + // For example: + // - OK means the node has been successfully explored; + // - PERMISSION_DENIED means an access denied error is encountered; + // - DEADLINE_EXCEEDED means the node hasn't been explored in time; + google.rpc.Code code = 1; + + // The human-readable description of the cause of failure. + string cause = 2; + } + + // A GCP resource that appears in an access control list. + message Resource { + // The [full resource name](https://aip.dev/122#full-resource-names). + string full_resource_name = 1; + + // The analysis state of this resource node. + AnalysisState analysis_state = 2; + } + + // A role or permission that appears in an access control list. + message Access { + oneof oneof_access { + // The role. + string role = 1; + + // The permission. + string permission = 2; + } + + // The analysis state of this access node. + AnalysisState analysis_state = 3; + } + + // A directional edge. + message Edge { + // The source node of the edge. + string source_node = 1; + + // The target node of the edge. + string target_node = 2; + } + + // An identity that appears in an access control list. + message Identity { + // The identity name in any form of members appear in + // [IAM policy + // binding](https://cloud.google.com/iam/reference/rest/v1/Binding), such + // as: + // - user:foo@google.com + // - group:group1@google.com + // - serviceAccount:s1@prj1.iam.gserviceaccount.com + // - projectOwner:some_project_id + // - domain:google.com + // - allUsers + // - etc. + string name = 1; + + // The analysis state of this identity node. + AnalysisState analysis_state = 2; + } + + // An access control list, derived from the above IAM policy binding, which + // contains a set of resources and accesses. May include one + // item from each set to compose an access control entry. + // + // NOTICE that there could be multiple access control lists for one IAM policy + // binding. The access control lists are created based on resource and access + // combinations. + // + // For example, assume we have the following cases in one IAM policy binding: + // - Permission P1 and P2 apply to resource R1 and R2; + // - Permission P3 applies to resource R2 and R3; + // + // This will result in the following access control lists: + // - AccessControlList 1: [R1, R2], [P1, P2] + // - AccessControlList 2: [R2, R3], [P3] + message AccessControlList { + // The resources that match one of the following conditions: + // - The resource_selector, if it is specified in request; + // - Otherwise, resources reachable from the policy attached resource. + repeated Resource resources = 1; + + // The accesses that match one of the following conditions: + // - The access_selector, if it is specified in request; + // - Otherwise, access specifiers reachable from the policy binding's role. + repeated Access accesses = 2; + + // Resource edges of the graph starting from the policy attached + // resource to any descendant resources. The [Edge.source_node][google.cloud.asset.v1p4beta1.IamPolicyAnalysisResult.Edge.source_node] contains + // the full resource name of a parent resource and [Edge.target_node][google.cloud.asset.v1p4beta1.IamPolicyAnalysisResult.Edge.target_node] + // contains the full resource name of a child resource. This field is + // present only if the output_resource_edges option is enabled in request. + repeated Edge resource_edges = 3; + } + + message IdentityList { + // Only the identities that match one of the following conditions will be + // presented: + // - The identity_selector, if it is specified in request; + // - Otherwise, identities reachable from the policy binding's members. + repeated Identity identities = 1; + + // Group identity edges of the graph starting from the binding's + // group members to any node of the [identities][google.cloud.asset.v1p4beta1.IamPolicyAnalysisResult.IdentityList.identities]. The [Edge.source_node][google.cloud.asset.v1p4beta1.IamPolicyAnalysisResult.Edge.source_node] + // contains a group, such as "group:parent@google.com". The + // [Edge.target_node][google.cloud.asset.v1p4beta1.IamPolicyAnalysisResult.Edge.target_node] contains a member of the group, + // such as "group:child@google.com" or "user:foo@google.com". + // This field is present only if the output_group_edges option is enabled in + // request. + repeated Edge group_edges = 2; + } + + // The full name of the resource to which the [iam_binding][google.cloud.asset.v1p4beta1.IamPolicyAnalysisResult.iam_binding] policy attaches. + string attached_resource_full_name = 1; + + // The Cloud IAM policy binding under analysis. + google.iam.v1.Binding iam_binding = 2; + + // The access control lists derived from the [iam_binding][google.cloud.asset.v1p4beta1.IamPolicyAnalysisResult.iam_binding] that match or + // potentially match resource and access selectors specified in the request. + repeated AccessControlList access_control_lists = 3; + + // The identity list derived from members of the [iam_binding][google.cloud.asset.v1p4beta1.IamPolicyAnalysisResult.iam_binding] that match or + // potentially match identity selector specified in the request. + IdentityList identity_list = 4; + + // Represents whether all nodes in the transitive closure of the + // [iam_binding][google.cloud.asset.v1p4beta1.IamPolicyAnalysisResult.iam_binding] node have been explored. + bool fully_explored = 5; +} diff --git a/third_party/googleapis/google/cloud/asset/v1p4beta1/cloudasset_gapic.legacy.yaml b/third_party/googleapis/google/cloud/asset/v1p4beta1/cloudasset_gapic.legacy.yaml new file mode 100644 index 000000000..e57332c63 --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1p4beta1/cloudasset_gapic.legacy.yaml @@ -0,0 +1,117 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 1.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.asset.v1p4beta1 + python: + package_name: google.cloud.asset_v1p4beta1.gapic + go: + package_name: cloud.google.com/go/asset/apiv1p4beta1 + csharp: + package_name: Google.Cloud.Asset.V1p2beta1 + ruby: + package_name: Google::Cloud::Asset::V1p2beta1 + php: + package_name: Google\Cloud\Asset\V1p2beta1 + nodejs: + package_name: asset.v1p4beta1 +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.cloud.asset.v1p4beta1.AssetService + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: [] + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - DEADLINE_EXCEEDED + - UNAVAILABLE + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # + # name - The simple name of the method. + # + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce method + # overloads which allow a client to directly pass request message fields as + # method parameters. This information may or may not be used, depending on + # the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request message. + # + # required_fields - Fields that are always required for a request to be + # valid. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a paging + # list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It defines + # which fields match the paging pattern in the request. The request consists + # of a page_size_field and a token_field. The page_size_field is the name of + # the optional field specifying the maximum number of elements to be + # returned in the response. The token_field is the name of the field in the + # request containing the page token. + # The response specifies response information of the list method. It defines + # which fields match the paging pattern in the response. The response + # consists of a token_field and a resources_field. The token_field is the + # name of the field in the response containing the next page token. The + # resources_field is the name of the field in the response containing the + # list of resources belonging to the page. + # + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: AnalyzeIamPolicy + required_fields: + - analysis_query + retry_codes_name: idempotent + retry_params_name: default + timeout_millis: 300000 + - name: ExportIamPolicyAnalysis + required_fields: + - analysis_query + - output_config + retry_codes_name: non_idempotent + retry_params_name: default + long_running: + return_type: google.cloud.asset.v1p4beta1.ExportIamPolicyAnalysisResponse + metadata_type: google.cloud.asset.v1p4beta1.ExportIamPolicyAnalysisRequest + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + timeout_millis: 300000 diff --git a/third_party/googleapis/google/cloud/asset/v1p4beta1/cloudasset_gapic.yaml b/third_party/googleapis/google/cloud/asset/v1p4beta1/cloudasset_gapic.yaml new file mode 100644 index 000000000..4757e0a34 --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1p4beta1/cloudasset_gapic.yaml @@ -0,0 +1,29 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 2.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.asset.v1p4beta1 + python: + package_name: google.cloud.asset_v1p4beta1.gapic + go: + package_name: cloud.google.com/go/asset/apiv1p4beta1 + csharp: + package_name: Google.Cloud.Asset.V1p2beta1 + ruby: + package_name: Google::Cloud::Asset::V1p2beta1 + php: + package_name: Google\Cloud\Asset\V1p2beta1 + nodejs: + package_name: asset.v1p4beta1 +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.cloud.asset.v1p4beta1.AssetService + methods: + - name: ExportIamPolicyAnalysis + long_running: + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 diff --git a/third_party/googleapis/google/cloud/asset/v1p4beta1/cloudasset_grpc_service_config.json b/third_party/googleapis/google/cloud/asset/v1p4beta1/cloudasset_grpc_service_config.json new file mode 100644 index 000000000..95f62b468 --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1p4beta1/cloudasset_grpc_service_config.json @@ -0,0 +1,30 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.asset.v1p4beta1.AssetService", + "method": "ExportIamPolicyAnalysis" + } + ], + "timeout": "60s" + }, + { + "name": [ + { + "service": "google.cloud.asset.v1p4beta1.AssetService", + "method": "AnalyzeIamPolicy" + } + ], + "timeout": "300s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/cloud/asset/v1p4beta1/cloudasset_v1p4beta1.yaml b/third_party/googleapis/google/cloud/asset/v1p4beta1/cloudasset_v1p4beta1.yaml new file mode 100644 index 000000000..fe6be3970 --- /dev/null +++ b/third_party/googleapis/google/cloud/asset/v1p4beta1/cloudasset_v1p4beta1.yaml @@ -0,0 +1,44 @@ +type: google.api.Service +config_version: 3 +name: cloudasset.googleapis.com +title: Cloud Asset API + +apis: +- name: google.cloud.asset.v1p4beta1.AssetService + +documentation: + summary: The cloud asset API manages the history and inventory of cloud resources. + overview: |- + # Cloud Asset API + + The Cloud Asset API keeps a history of Google Cloud Platform (GCP) asset + metadata, and allows GCP users to download a dump of all asset metadata + for the resource types listed below within an organization or a project at + a given timestamp. + + Read more documents here: + https://cloud.google.com/asset-inventory/docs + +backend: + rules: + - selector: google.cloud.asset.v1p4beta1.AssetService.AnalyzeIamPolicy + deadline: 600.0 + - selector: google.cloud.asset.v1p4beta1.AssetService.ExportIamPolicyAnalysis + deadline: 600.0 + - selector: google.longrunning.Operations.GetOperation + deadline: 60.0 + +authentication: + rules: + - selector: google.cloud.asset.v1p4beta1.AssetService.AnalyzeIamPolicy + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: google.cloud.asset.v1p4beta1.AssetService.ExportIamPolicyAnalysis + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: google.longrunning.Operations.GetOperation + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/automl/BUILD.bazel b/third_party/googleapis/google/cloud/automl/BUILD.bazel index 1e5b8c2af..a87c57fec 100644 --- a/third_party/googleapis/google/cloud/automl/BUILD.bazel +++ b/third_party/googleapis/google/cloud/automl/BUILD.bazel @@ -1 +1 @@ -exports_files(glob(["*.yaml"])) \ No newline at end of file +exports_files(glob(["*.yaml"])) diff --git a/third_party/googleapis/google/cloud/automl/artman_automl_v1.yaml b/third_party/googleapis/google/cloud/automl/artman_automl_v1.yaml new file mode 100644 index 000000000..115e73eef --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/artman_automl_v1.yaml @@ -0,0 +1,34 @@ +common: + api_name: automl + api_version: v1 + organization_name: google-cloud + proto_deps: + - name: google-common-protos + src_proto_paths: + - v1 + service_yaml: automl_v1.yaml + gapic_yaml: v1/automl_gapic.yaml +artifacts: +- name: gapic_config + type: GAPIC_CONFIG +- name: java_gapic + type: GAPIC + language: JAVA +- name: python_gapic + type: GAPIC + language: PYTHON +- name: nodejs_gapic + type: GAPIC + language: NODEJS +- name: php_gapic + type: GAPIC + language: PHP +- name: go_gapic + type: GAPIC + language: GO +- name: ruby_gapic + type: GAPIC + language: RUBY +- name: csharp_gapic + type: GAPIC + language: CSHARP diff --git a/third_party/googleapis/google/cloud/automl/automl_v1.yaml b/third_party/googleapis/google/cloud/automl/automl_v1.yaml new file mode 100644 index 000000000..7f890c92e --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/automl_v1.yaml @@ -0,0 +1,117 @@ +type: google.api.Service +config_version: 3 +name: automl.googleapis.com +title: Cloud AutoML API + +apis: +- name: google.cloud.automl.v1.AutoMl +- name: google.cloud.automl.v1.PredictionService + +types: +- name: google.cloud.automl.v1.OperationMetadata +- name: google.cloud.automl.v1.BatchPredictResult + +documentation: + summary: |- + Train high-quality custom machine learning models with minimum effort and + machine learning expertise. + overview: |- + Cloud AutoML is a suite of machine learning products that enables developers + with limited machine learning expertise to train high-quality models + specific to their business needs, by leveraging Google’s state-of-the-art + transfer learning, and Neural Architecture Search technology. + +backend: + rules: + - selector: google.longrunning.Operations.ListOperations + deadline: 50.0 + - selector: google.longrunning.Operations.GetOperation + deadline: 5.0 + - selector: google.longrunning.Operations.DeleteOperation + deadline: 5.0 + - selector: google.longrunning.Operations.CancelOperation + deadline: 5.0 + - selector: google.cloud.automl.v1.PredictionService.Predict + deadline: 60.0 + - selector: google.cloud.automl.v1.PredictionService.BatchPredict + deadline: 20.0 + - selector: google.cloud.automl.v1.AutoMl.CreateDataset + deadline: 5.0 + - selector: google.cloud.automl.v1.AutoMl.GetDataset + deadline: 5.0 + - selector: google.cloud.automl.v1.AutoMl.ListDatasets + deadline: 50.0 + - selector: google.cloud.automl.v1.AutoMl.UpdateDataset + deadline: 5.0 + - selector: google.cloud.automl.v1.AutoMl.DeleteDataset + deadline: 5.0 + - selector: google.cloud.automl.v1.AutoMl.ImportData + deadline: 20.0 + - selector: google.cloud.automl.v1.AutoMl.ExportData + deadline: 5.0 + - selector: google.cloud.automl.v1.AutoMl.GetAnnotationSpec + deadline: 5.0 + - selector: google.cloud.automl.v1.AutoMl.CreateModel + deadline: 20.0 + - selector: google.cloud.automl.v1.AutoMl.GetModel + deadline: 5.0 + - selector: google.cloud.automl.v1.AutoMl.UpdateModel + deadline: 5.0 + - selector: google.cloud.automl.v1.AutoMl.ListModels + deadline: 50.0 + - selector: google.cloud.automl.v1.AutoMl.DeleteModel + deadline: 5.0 + - selector: google.cloud.automl.v1.AutoMl.DeployModel + deadline: 5.0 + - selector: google.cloud.automl.v1.AutoMl.UndeployModel + deadline: 5.0 + - selector: google.cloud.automl.v1.AutoMl.ExportModel + deadline: 5.0 + - selector: google.cloud.automl.v1.AutoMl.GetModelEvaluation + deadline: 5.0 + - selector: google.cloud.automl.v1.AutoMl.ListModelEvaluations + deadline: 50.0 + - selector: google.iam.v1.IAMPolicy.SetIamPolicy + deadline: 5.0 + - selector: google.iam.v1.IAMPolicy.GetIamPolicy + deadline: 5.0 + - selector: google.iam.v1.IAMPolicy.TestIamPermissions + deadline: 5.0 + +http: + rules: + - selector: google.longrunning.Operations.ListOperations + get: '/v1/{name=projects/*/locations/*}/operations' + + - selector: google.longrunning.Operations.GetOperation + get: '/v1/{name=projects/*/locations/*/operations/*}' + + - selector: google.longrunning.Operations.DeleteOperation + delete: '/v1/{name=projects/*/locations/*/operations/*}' + + - selector: google.longrunning.Operations.CancelOperation + post: '/v1/{name=projects/*/locations/*/operations/*}:cancel' + body: '*' + + - selector: google.iam.v1.IAMPolicy.SetIamPolicy + post: '/v1/{resource=projects/*/locations/*/datasets/*}:setIamPolicy' + body: '*' + additional_bindings: + - post: '/v1/{resource=projects/*/locations/*/models/*}:setIamPolicy' + body: '*' + + - selector: google.iam.v1.IAMPolicy.GetIamPolicy + get: '/v1/{resource=projects/*/locations/*/datasets/*}:getIamPolicy' + additional_bindings: + - get: '/v1/{resource=projects/*/locations/*/models/*}:getIamPolicy' + + - selector: google.iam.v1.IAMPolicy.TestIamPermissions + post: '/v1/{resource=projects/*/locations/*/**}:testIamPermissions' + body: '*' + +authentication: + rules: + - selector: '*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/automl/v1/BUILD.bazel b/third_party/googleapis/google/cloud/automl/v1/BUILD.bazel new file mode 100644 index 000000000..0f849c873 --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1/BUILD.bazel @@ -0,0 +1,400 @@ +# This file was automatically generated by BuildFileGenerator + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") +load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") + +proto_library( + name = "automl_proto", + srcs = [ + "annotation_payload.proto", + "annotation_spec.proto", + "classification.proto", + "data_items.proto", + "dataset.proto", + "detection.proto", + "geometry.proto", + "image.proto", + "io.proto", + "model.proto", + "model_evaluation.proto", + "operations.proto", + "prediction_service.proto", + "service.proto", + "text.proto", + "text_extraction.proto", + "text_segment.proto", + "text_sentiment.proto", + "translation.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/longrunning:operations_proto", + "//google/rpc:status_proto", + "@com_google_protobuf//:any_proto", + "@com_google_protobuf//:duration_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:struct_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +proto_library_with_info( + name = "automl_proto_with_info", + deps = [ + ":automl_proto", + "//google/cloud:common_resources_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", + "java_proto_library", +) + +java_proto_library( + name = "automl_java_proto", + deps = [":automl_proto"], +) + +java_grpc_library( + name = "automl_java_grpc", + srcs = [":automl_proto"], + deps = [":automl_java_proto"], +) + +java_gapic_library( + name = "automl_java_gapic", + src = ":automl_proto_with_info", + gapic_yaml = "automl_gapic.yaml", + package = "google.cloud.automl.v1", + service_yaml = "automl_v1.yaml", + test_deps = [ + ":automl_java_grpc", + ], + deps = [ + ":automl_java_proto", + ], +) + +java_gapic_test( + name = "automl_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.automl.v1.AutoMlClientTest", + "com.google.cloud.automl.v1.PredictionServiceClientTest", + ], + runtime_deps = [":automl_java_gapic_test"], +) + +# Open Source Packages +java_gapic_assembly_gradle_pkg( + name = "google-cloud-automl-v1-java", + deps = [ + ":automl_java_gapic", + ":automl_java_grpc", + ":automl_java_proto", + ":automl_proto", + ], +) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", + "go_proto_library", + "go_test", +) + +go_proto_library( + name = "automl_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/cloud/automl/v1", + protos = [":automl_proto"], + deps = [ + "//google/api:annotations_go_proto", + "//google/longrunning:longrunning_go_proto", + "//google/rpc:status_go_proto", + ], +) + +go_gapic_library( + name = "automl_go_gapic", + srcs = [":automl_proto_with_info"], + grpc_service_config = "automl_grpc_service_config.json", + importpath = "cloud.google.com/go/automl/apiv1;automl", + service_yaml = "automl_v1.yaml", + deps = [ + ":automl_go_proto", + "//google/longrunning:longrunning_go_gapic", + "//google/longrunning:longrunning_go_proto", + "@com_google_cloud_go//longrunning:go_default_library", + "@com_google_cloud_go//longrunning/autogen:go_default_library", + "@io_bazel_rules_go//proto/wkt:any_go_proto", + "@io_bazel_rules_go//proto/wkt:duration_go_proto", + "@io_bazel_rules_go//proto/wkt:struct_go_proto", + ], +) + +go_test( + name = "automl_go_gapic_test", + srcs = [":automl_go_gapic_srcjar_test"], + embed = [":automl_go_gapic"], + importpath = "cloud.google.com/go/automl/apiv1", +) + +# Open Source Packages +go_gapic_assembly_pkg( + name = "gapi-cloud-automl-v1-go", + deps = [ + ":automl_go_gapic", + ":automl_go_gapic_srcjar-test.srcjar", + ":automl_go_proto", + ], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "automl_moved_proto", + srcs = [":automl_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/longrunning:operations_proto", + "//google/rpc:status_proto", + "@com_google_protobuf//:any_proto", + "@com_google_protobuf//:duration_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:struct_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +py_proto_library( + name = "automl_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":automl_moved_proto"], +) + +py_grpc_library( + name = "automl_py_grpc", + srcs = [":automl_moved_proto"], + deps = [":automl_py_proto"], +) + +py_gapic_library( + name = "automl_py_gapic", + src = ":automl_proto_with_info", + gapic_yaml = "automl_gapic.yaml", + package = "google.cloud.automl.v1", + service_yaml = "automl_v1.yaml", + deps = [ + ":automl_py_grpc", + ":automl_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "automl-v1-py", + deps = [ + ":automl_py_gapic", + ":automl_py_grpc", + ":automl_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "automl_php_proto", + deps = [":automl_proto"], +) + +php_grpc_library( + name = "automl_php_grpc", + srcs = [":automl_proto"], + deps = [":automl_php_proto"], +) + +php_gapic_library( + name = "automl_php_gapic", + src = ":automl_proto_with_info", + gapic_yaml = "automl_gapic.yaml", + package = "google.cloud.automl.v1", + service_yaml = "automl_v1.yaml", + deps = [ + ":automl_php_grpc", + ":automl_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-automl-v1-php", + deps = [ + ":automl_php_gapic", + ":automl_php_grpc", + ":automl_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "automl_nodejs_gapic", + src = ":automl_proto_with_info", + gapic_yaml = "automl_gapic.yaml", + package = "google.cloud.automl.v1", + service_yaml = "automl_v1.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "automl-v1-nodejs", + deps = [ + ":automl_nodejs_gapic", + ":automl_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "automl_ruby_proto", + deps = [":automl_proto"], +) + +ruby_grpc_library( + name = "automl_ruby_grpc", + srcs = [":automl_proto"], + deps = [":automl_ruby_proto"], +) + +ruby_gapic_library( + name = "automl_ruby_gapic", + src = ":automl_proto_with_info", + gapic_yaml = "automl_gapic.yaml", + package = "google.cloud.automl.v1", + service_yaml = "automl_v1.yaml", + deps = [ + ":automl_ruby_grpc", + ":automl_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-automl-v1-ruby", + deps = [ + ":automl_ruby_gapic", + ":automl_ruby_grpc", + ":automl_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "automl_csharp_proto", + deps = [":automl_proto"], +) + +csharp_grpc_library( + name = "automl_csharp_grpc", + srcs = [":automl_proto"], + deps = [":automl_csharp_proto"], +) + +csharp_gapic_library( + name = "automl_csharp_gapic", + src = ":automl_proto_with_info", + gapic_yaml = "automl_gapic.yaml", + package = "google.cloud.automl.v1", + service_yaml = "automl_v1.yaml", + deps = [ + ":automl_csharp_grpc", + ":automl_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-automl-v1-csharp", + deps = [ + ":automl_csharp_gapic", + ":automl_csharp_grpc", + ":automl_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/cloud/automl/v1/annotation_payload.proto b/third_party/googleapis/google/cloud/automl/v1/annotation_payload.proto new file mode 100644 index 000000000..a81feaf10 --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1/annotation_payload.proto @@ -0,0 +1,67 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.automl.v1; + +import "google/cloud/automl/v1/classification.proto"; +import "google/cloud/automl/v1/detection.proto"; +import "google/cloud/automl/v1/text_extraction.proto"; +import "google/cloud/automl/v1/text_sentiment.proto"; +import "google/cloud/automl/v1/translation.proto"; +import "google/protobuf/any.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Cloud.AutoML.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1;automl"; +option java_multiple_files = true; +option java_package = "com.google.cloud.automl.v1"; +option php_namespace = "Google\\Cloud\\AutoMl\\V1"; +option ruby_package = "Google::Cloud::AutoML::V1"; + +// Contains annotation information that is relevant to AutoML. +message AnnotationPayload { + // Output only . Additional information about the annotation + // specific to the AutoML domain. + oneof detail { + // Annotation details for translation. + TranslationAnnotation translation = 2; + + // Annotation details for content or image classification. + ClassificationAnnotation classification = 3; + + // Annotation details for image object detection. + ImageObjectDetectionAnnotation image_object_detection = 4; + + // Annotation details for text extraction. + TextExtractionAnnotation text_extraction = 6; + + // Annotation details for text sentiment. + TextSentimentAnnotation text_sentiment = 7; + } + + // Output only . The resource ID of the annotation spec that + // this annotation pertains to. The annotation spec comes from either an + // ancestor dataset, or the dataset that was used to train the model in use. + string annotation_spec_id = 1; + + // Output only. The value of + // [display_name][google.cloud.automl.v1.AnnotationSpec.display_name] + // when the model was trained. Because this field returns a value at model + // training time, for different models trained using the same dataset, the + // returned value could be different as model owner could update the + // `display_name` between any two model training. + string display_name = 5; +} diff --git a/third_party/googleapis/google/cloud/automl/v1/annotation_spec.proto b/third_party/googleapis/google/cloud/automl/v1/annotation_spec.proto new file mode 100644 index 000000000..9eb61579e --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1/annotation_spec.proto @@ -0,0 +1,49 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.automl.v1; + +import "google/api/resource.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Cloud.AutoML.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1;automl"; +option java_multiple_files = true; +option java_package = "com.google.cloud.automl.v1"; +option php_namespace = "Google\\Cloud\\AutoMl\\V1"; +option ruby_package = "Google::Cloud::AutoML::V1"; + +// A definition of an annotation spec. +message AnnotationSpec { + option (google.api.resource) = { + type: "automl.googleapis.com/AnnotationSpec" + pattern: "projects/{project}/locations/{location}/datasets/{dataset}/annotationSpecs/{annotation_spec}" + }; + + // Output only. Resource name of the annotation spec. + // Form: + // + // 'projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/annotationSpecs/{annotation_spec_id}' + string name = 1; + + // Required. The name of the annotation spec to show in the interface. The name can be + // up to 32 characters long and must match the regexp `[a-zA-Z0-9_]+`. + string display_name = 2; + + // Output only. The number of examples in the parent dataset + // labeled by the annotation spec. + int32 example_count = 9; +} diff --git a/third_party/googleapis/google/cloud/automl/v1/automl_gapic.legacy.yaml b/third_party/googleapis/google/cloud/automl/v1/automl_gapic.legacy.yaml new file mode 100644 index 000000000..71da5602d --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1/automl_gapic.legacy.yaml @@ -0,0 +1,612 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 1.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.automl.v1 + python: + package_name: google.cloud.automl_v1.gapic + go: + package_name: cloud.google.com/go/automl/apiv1 + release_level: GA + csharp: + package_name: Google.Cloud.AutoML.V1 + ruby: + package_name: Google::Cloud::AutoML::V1 + php: + package_name: Google\Cloud\AutoMl\V1 + nodejs: + package_name: automl.v1 +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.cloud.automl.v1.AutoMl + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: + - name_pattern: projects/{project}/locations/{location} + entity_name: location + - name_pattern: projects/{project}/locations/{location}/datasets/{dataset} + entity_name: dataset + - name_pattern: projects/{project}/locations/{location}/datasets/{dataset}/annotationSpecs/{annotation_spec} + entity_name: annotation_spec + - name_pattern: projects/{project}/locations/{location}/models/{model} + entity_name: model + - name_pattern: projects/{project}/locations/{location}/models/{model}/modelEvaluations/{model_evaluation} + entity_name: model_evaluation + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - DEADLINE_EXCEEDED + - UNAVAILABLE + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # + # name - The simple name of the method. + # + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce method + # overloads which allow a client to directly pass request message fields as + # method parameters. This information may or may not be used, depending on + # the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request message. + # + # required_fields - Fields that are always required for a request to be + # valid. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a paging + # list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It defines + # which fields match the paging pattern in the request. The request consists + # of a page_size_field and a token_field. The page_size_field is the name of + # the optional field specifying the maximum number of elements to be + # returned in the response. The token_field is the name of the field in the + # request containing the page token. + # The response specifies response information of the list method. It defines + # which fields match the paging pattern in the response. The response + # consists of a token_field and a resources_field. The token_field is the + # name of the field in the response containing the next page token. The + # resources_field is the name of the field in the response containing the + # list of resources belonging to the page. + # + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: CreateDataset + flattening: + groups: + - parameters: + - parent + - dataset + required_fields: + - parent + - dataset + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: location + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + long_running: + return_type: google.cloud.automl.v1.Dataset + metadata_type: google.cloud.automl.v1.OperationMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + - name: UpdateDataset + flattening: + groups: + - parameters: + - dataset + - update_mask + required_fields: + - dataset + - update_mask + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + dataset.name: dataset + timeout_millis: 5000 + - name: GetDataset + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: dataset + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + - name: ListDatasets + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: datasets + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: location + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + - name: DeleteDataset + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: dataset + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + long_running: + return_type: google.protobuf.Empty + metadata_type: google.cloud.automl.v1.OperationMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + - name: ImportData + flattening: + groups: + - parameters: + - name + - input_config + required_fields: + - name + - input_config + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: dataset + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + long_running: + return_type: google.protobuf.Empty + metadata_type: google.cloud.automl.v1.OperationMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 3600000 + - name: ExportData + flattening: + groups: + - parameters: + - name + - output_config + required_fields: + - name + - output_config + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: dataset + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + long_running: + return_type: google.protobuf.Empty + metadata_type: google.cloud.automl.v1.OperationMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + - name: GetAnnotationSpec + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: annotation_spec + timeout_millis: 5000 + - name: CreateModel + flattening: + groups: + - parameters: + - parent + - model + required_fields: + - parent + - model + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: location + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + long_running: + return_type: google.cloud.automl.v1.Model + metadata_type: google.cloud.automl.v1.OperationMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + - name: GetModel + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: model + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + - name: UpdateModel + flattening: + groups: + - parameters: + - model + - update_mask + required_fields: + - model + - update_mask + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: model + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + - name: ListModels + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: model + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: location + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + - name: DeleteModel + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: model + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + long_running: + return_type: google.protobuf.Empty + metadata_type: google.cloud.automl.v1.OperationMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + - name: DeployModel + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: model + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + long_running: + return_type: google.protobuf.Empty + metadata_type: google.cloud.automl.v1.OperationMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 3600000 + - name: UndeployModel + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: model + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + long_running: + return_type: google.protobuf.Empty + metadata_type: google.cloud.automl.v1.OperationMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 3600000 + - name: ExportModel + required_fields: + - name + - output_config + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: model + long_running: + return_type: google.protobuf.Empty + metadata_type: google.cloud.automl.v1.OperationMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + timeout_millis: 5000 + - name: GetModelEvaluation + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: model_evaluation + timeout_millis: 60000 + - name: ListModelEvaluations + flattening: + groups: + - parameters: + - parent + - filter + required_fields: + - parent + - filter + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: model_evaluation + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: model + timeout_millis: 60000 +# The fully qualified name of the API interface. +- name: google.cloud.automl.v1.PredictionService + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: + - name_pattern: projects/{project}/locations/{location}/models/{model} + entity_name: model + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - DEADLINE_EXCEEDED + - UNAVAILABLE + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # + # name - The simple name of the method. + # + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce method + # overloads which allow a client to directly pass request message fields as + # method parameters. This information may or may not be used, depending on + # the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request message. + # + # required_fields - Fields that are always required for a request to be + # valid. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a paging + # list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It defines + # which fields match the paging pattern in the request. The request consists + # of a page_size_field and a token_field. The page_size_field is the name of + # the optional field specifying the maximum number of elements to be + # returned in the response. The token_field is the name of the field in the + # request containing the page token. + # The response specifies response information of the list method. It defines + # which fields match the paging pattern in the response. The response + # consists of a token_field and a resources_field. The token_field is the + # name of the field in the response containing the next page token. The + # resources_field is the name of the field in the response containing the + # list of resources belonging to the page. + # + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: Predict + flattening: + groups: + - parameters: + - name + - payload + - params + required_fields: + - name + - payload + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: model + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + - name: BatchPredict + required_fields: + - name + - input_config + - output_config + flattening: + groups: + - parameters: + - name + - input_config + - output_config + - params + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: model + long_running: + return_type: google.cloud.automl.v1.BatchPredictResult + metadata_type: google.cloud.automl.v1.OperationMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 86400000 + timeout_millis: 20000 +resource_name_generation: +- message_name: CreateDatasetRequest + field_entity_map: + parent: location +- message_name: UpdateDatasetRequest + field_entity_map: + dataset.name: dataset +- message_name: GetDatasetRequest + field_entity_map: + name: dataset +- message_name: ListDatasetsRequest + field_entity_map: + parent: location +- message_name: DeleteDatasetRequest + field_entity_map: + name: dataset +- message_name: ImportDataRequest + field_entity_map: + name: dataset +- message_name: ExportDataRequest + field_entity_map: + name: dataset +- message_name: GetAnnotationSpecRequest + field_entity_map: + name: annotation_spec +- message_name: CreateModelRequest + field_entity_map: + parent: location +- message_name: GetModelRequest + field_entity_map: + name: model +- message_name: UpdateModelRequest + field_entity_map: + name: model +- message_name: ListModelsRequest + field_entity_map: + parent: location +- message_name: DeleteModelRequest + field_entity_map: + name: model +- message_name: DeployModelRequest + field_entity_map: + name: model +- message_name: UndeployModelRequest + field_entity_map: + name: model +- message_name: ExportModelRequest + field_entity_map: + name: model +- message_name: GetModelEvaluationRequest + field_entity_map: + name: model_evaluation +- message_name: ListModelEvaluationsRequest + field_entity_map: + parent: model +- message_name: PredictRequest + field_entity_map: + name: model +- message_name: BatchPredictRequest + field_entity_map: + name: model diff --git a/third_party/googleapis/google/cloud/automl/v1/automl_gapic.yaml b/third_party/googleapis/google/cloud/automl/v1/automl_gapic.yaml new file mode 100644 index 000000000..8cc635f23 --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1/automl_gapic.yaml @@ -0,0 +1,75 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 2.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.automl.v1 + python: + package_name: google.cloud.automl_v1.gapic + go: + package_name: cloud.google.com/go/automl/apiv1 + release_level: GA + csharp: + package_name: Google.Cloud.AutoML.V1 + ruby: + package_name: Google::Cloud::AutoML::V1 + php: + package_name: Google\Cloud\AutoMl\V1 + nodejs: + package_name: automl.v1 +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.cloud.automl.v1.AutoMl + # A list of method configurations. + # Common properties: + # + # name - The simple name of the method. + # + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce method + # overloads which allow a client to directly pass request message fields as + # method parameters. This information may or may not be used, depending on + # the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request message. + # + # required_fields - Fields that are always required for a request to be + # valid. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a paging + # list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It defines + # which fields match the paging pattern in the request. The request consists + # of a page_size_field and a token_field. The page_size_field is the name of + # the optional field specifying the maximum number of elements to be + # returned in the response. The token_field is the name of the field in the + # request containing the page token. + # The response specifies response information of the list method. It defines + # which fields match the paging pattern in the response. The response + # consists of a token_field and a resources_field. The token_field is the + # name of the field in the response containing the next page token. The + # resources_field is the name of the field in the response containing the + # list of resources belonging to the page. + # + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: DeleteDataset + retry_codes_name: idempotent + - name: DeleteModel + retry_codes_name: idempotent +# The fully qualified name of the API interface. +- name: google.cloud.automl.v1.PredictionService diff --git a/third_party/googleapis/google/cloud/automl/v1/automl_grpc_service_config.json b/third_party/googleapis/google/cloud/automl/v1/automl_grpc_service_config.json new file mode 100644 index 000000000..9cd59d2c0 --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1/automl_grpc_service_config.json @@ -0,0 +1,109 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.automl.v1.AutoMl", + "method": "CreateDataset" + }, + { + "service": "google.cloud.automl.v1.AutoMl", + "method": "UpdateDataset" + }, + { + "service": "google.cloud.automl.v1.AutoMl", + "method": "ImportData" + }, + { + "service": "google.cloud.automl.v1.AutoMl", + "method": "ExportData" + }, + { + "service": "google.cloud.automl.v1.AutoMl", + "method": "CreateModel" + }, + { + "service": "google.cloud.automl.v1.AutoMl", + "method": "UpdateModel" + }, + { + "service": "google.cloud.automl.v1.AutoMl", + "method": "DeployModel" + }, + { + "service": "google.cloud.automl.v1.AutoMl", + "method": "UndeployModel" + }, + { + "service": "google.cloud.automl.v1.AutoMl", + "method": "ExportModel" + } + ], + "timeout": "5s" + }, + { + "name": [ + { + "service": "google.cloud.automl.v1.AutoMl", + "method": "GetDataset" + }, + { + "service": "google.cloud.automl.v1.AutoMl", + "method": "ListDatasets" + }, + { + "service": "google.cloud.automl.v1.AutoMl", + "method": "DeleteDataset" + }, + { + "service": "google.cloud.automl.v1.AutoMl", + "method": "GetAnnotationSpec" + }, + { + "service": "google.cloud.automl.v1.AutoMl", + "method": "GetModel" + }, + { + "service": "google.cloud.automl.v1.AutoMl", + "method": "ListModels" + }, + { + "service": "google.cloud.automl.v1.AutoMl", + "method": "DeleteModel" + }, + { + "service": "google.cloud.automl.v1.AutoMl", + "method": "GetModelEvaluation" + }, + { + "service": "google.cloud.automl.v1.AutoMl", + "method": "ListModelEvaluations" + } + ], + "timeout": "5s", + "retryPolicy": { + "maxAttempts": 5, + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.automl.v1.PredictionService", + "method": "Predict" + }, + { + "service": "google.cloud.automl.v1.PredictionService", + "method": "BatchPredict" + } + ], + "timeout": "60s" + } + ] +} diff --git a/third_party/googleapis/google/cloud/automl/v1/automl_v1.yaml b/third_party/googleapis/google/cloud/automl/v1/automl_v1.yaml new file mode 100644 index 000000000..bc75483c3 --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1/automl_v1.yaml @@ -0,0 +1,127 @@ +type: google.api.Service +config_version: 3 +name: automl.googleapis.com +title: Cloud AutoML API + +apis: +- name: google.cloud.automl.v1.AutoMl +- name: google.cloud.automl.v1.PredictionService + +types: +- name: google.cloud.automl.v1.BatchPredictResult +- name: google.cloud.automl.v1.OperationMetadata + +documentation: + summary: |- + Train high-quality custom machine learning models with minimum effort and + machine learning expertise. + overview: |- + Cloud AutoML is a suite of machine learning products that enables + developers with limited machine learning expertise to train high-quality + models specific to their business needs, by leveraging Google's + state-of-the-art transfer learning, and Neural Architecture Search + technology. + rules: + - selector: google.iam.v1.IAMPolicy.GetIamPolicy + description: |- + Gets the access control policy for a resource. Returns an empty policy + if the resource exists and does not have a policy set. + + - selector: google.iam.v1.IAMPolicy.SetIamPolicy + description: |- + Sets the access control policy on the specified resource. Replaces + any existing policy. + + Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and + PERMISSION_DENIED + + - selector: google.iam.v1.IAMPolicy.TestIamPermissions + description: |- + Returns permissions that a caller has on the specified resource. If the + resource does not exist, this will return an empty set of + permissions, not a NOT_FOUND error. + + Note: This operation is designed to be used for building + permission-aware UIs and command-line tools, not for authorization + checking. This operation may "fail open" without warning. + +backend: + rules: + - selector: 'google.cloud.automl.v1.AutoMl.*' + deadline: 5.0 + - selector: google.cloud.automl.v1.AutoMl.CreateModel + deadline: 20.0 + - selector: google.cloud.automl.v1.AutoMl.ImportData + deadline: 20.0 + - selector: google.cloud.automl.v1.AutoMl.ListDatasets + deadline: 50.0 + - selector: google.cloud.automl.v1.AutoMl.ListModelEvaluations + deadline: 50.0 + - selector: google.cloud.automl.v1.AutoMl.ListModels + deadline: 50.0 + - selector: google.cloud.automl.v1.PredictionService.BatchPredict + deadline: 20.0 + - selector: google.cloud.automl.v1.PredictionService.Predict + deadline: 60.0 + - selector: 'google.iam.v1.IAMPolicy.*' + deadline: 5.0 + - selector: 'google.longrunning.Operations.*' + deadline: 5.0 + - selector: google.longrunning.Operations.ListOperations + deadline: 50.0 + - selector: google.longrunning.Operations.WaitOperation + deadline: 300.0 + +http: + rules: + - selector: google.longrunning.Operations.ListOperations + get: '/v1/{name=projects/*/locations/*}/operations' + + - selector: google.longrunning.Operations.GetOperation + get: '/v1/{name=projects/*/locations/*/operations/*}' + + - selector: google.longrunning.Operations.DeleteOperation + delete: '/v1/{name=projects/*/locations/*/operations/*}' + + - selector: google.longrunning.Operations.CancelOperation + post: '/v1/{name=projects/*/locations/*/operations/*}:cancel' + body: '*' + + - selector: google.iam.v1.IAMPolicy.SetIamPolicy + post: '/v1/{resource=projects/*/locations/*/datasets/*}:setIamPolicy' + body: '*' + additional_bindings: + - post: '/v1/{resource=projects/*/locations/*/models/*}:setIamPolicy' + body: '*' + + - selector: google.iam.v1.IAMPolicy.GetIamPolicy + get: '/v1/{resource=projects/*/locations/*/datasets/*}:getIamPolicy' + additional_bindings: + - get: '/v1/{resource=projects/*/locations/*/models/*}:getIamPolicy' + + - selector: google.iam.v1.IAMPolicy.TestIamPermissions + post: '/v1/{resource=projects/*/locations/*/**}:testIamPermissions' + body: '*' + +authentication: + rules: + - selector: 'google.cloud.automl.v1.AutoMl.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: google.cloud.automl.v1.PredictionService.BatchPredict + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: google.cloud.automl.v1.PredictionService.Predict + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: 'google.iam.v1.IAMPolicy.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: 'google.longrunning.Operations.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/automl/v1/classification.proto b/third_party/googleapis/google/cloud/automl/v1/classification.proto new file mode 100644 index 000000000..9213bfde8 --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1/classification.proto @@ -0,0 +1,177 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.automl.v1; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Cloud.AutoML.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1;automl"; +option java_multiple_files = true; +option java_outer_classname = "ClassificationProto"; +option java_package = "com.google.cloud.automl.v1"; +option php_namespace = "Google\\Cloud\\AutoMl\\V1"; +option ruby_package = "Google::Cloud::AutoML::V1"; + +// Type of the classification problem. +enum ClassificationType { + // An un-set value of this enum. + CLASSIFICATION_TYPE_UNSPECIFIED = 0; + + // At most one label is allowed per example. + MULTICLASS = 1; + + // Multiple labels are allowed for one example. + MULTILABEL = 2; +} + +// Contains annotation details specific to classification. +message ClassificationAnnotation { + // Output only. A confidence estimate between 0.0 and 1.0. A higher value + // means greater confidence that the annotation is positive. If a user + // approves an annotation as negative or positive, the score value remains + // unchanged. If a user creates an annotation, the score is 0 for negative or + // 1 for positive. + float score = 1; +} + +// Model evaluation metrics for classification problems. +// Note: For Video Classification this metrics only describe quality of the +// Video Classification predictions of "segment_classification" type. +message ClassificationEvaluationMetrics { + // Metrics for a single confidence threshold. + message ConfidenceMetricsEntry { + // Output only. Metrics are computed with an assumption that the model + // never returns predictions with score lower than this value. + float confidence_threshold = 1; + + // Output only. Metrics are computed with an assumption that the model + // always returns at most this many predictions (ordered by their score, + // descendingly), but they all still need to meet the confidence_threshold. + int32 position_threshold = 14; + + // Output only. Recall (True Positive Rate) for the given confidence + // threshold. + float recall = 2; + + // Output only. Precision for the given confidence threshold. + float precision = 3; + + // Output only. False Positive Rate for the given confidence threshold. + float false_positive_rate = 8; + + // Output only. The harmonic mean of recall and precision. + float f1_score = 4; + + // Output only. The Recall (True Positive Rate) when only considering the + // label that has the highest prediction score and not below the confidence + // threshold for each example. + float recall_at1 = 5; + + // Output only. The precision when only considering the label that has the + // highest prediction score and not below the confidence threshold for each + // example. + float precision_at1 = 6; + + // Output only. The False Positive Rate when only considering the label that + // has the highest prediction score and not below the confidence threshold + // for each example. + float false_positive_rate_at1 = 9; + + // Output only. The harmonic mean of [recall_at1][google.cloud.automl.v1.ClassificationEvaluationMetrics.ConfidenceMetricsEntry.recall_at1] and [precision_at1][google.cloud.automl.v1.ClassificationEvaluationMetrics.ConfidenceMetricsEntry.precision_at1]. + float f1_score_at1 = 7; + + // Output only. The number of model created labels that match a ground truth + // label. + int64 true_positive_count = 10; + + // Output only. The number of model created labels that do not match a + // ground truth label. + int64 false_positive_count = 11; + + // Output only. The number of ground truth labels that are not matched + // by a model created label. + int64 false_negative_count = 12; + + // Output only. The number of labels that were not created by the model, + // but if they would, they would not match a ground truth label. + int64 true_negative_count = 13; + } + + // Confusion matrix of the model running the classification. + message ConfusionMatrix { + // Output only. A row in the confusion matrix. + message Row { + // Output only. Value of the specific cell in the confusion matrix. + // The number of values each row has (i.e. the length of the row) is equal + // to the length of the `annotation_spec_id` field or, if that one is not + // populated, length of the [display_name][google.cloud.automl.v1.ClassificationEvaluationMetrics.ConfusionMatrix.display_name] field. + repeated int32 example_count = 1; + } + + // Output only. IDs of the annotation specs used in the confusion matrix. + // For Tables CLASSIFICATION + // + // [prediction_type][google.cloud.automl.v1p1beta.TablesModelMetadata.prediction_type] + // only list of [annotation_spec_display_name-s][] is populated. + repeated string annotation_spec_id = 1; + + // Output only. Display name of the annotation specs used in the confusion + // matrix, as they were at the moment of the evaluation. For Tables + // CLASSIFICATION + // + // [prediction_type-s][google.cloud.automl.v1p1beta.TablesModelMetadata.prediction_type], + // distinct values of the target column at the moment of the model + // evaluation are populated here. + repeated string display_name = 3; + + // Output only. Rows in the confusion matrix. The number of rows is equal to + // the size of `annotation_spec_id`. + // `row[i].example_count[j]` is the number of examples that have ground + // truth of the `annotation_spec_id[i]` and are predicted as + // `annotation_spec_id[j]` by the model being evaluated. + repeated Row row = 2; + } + + // Output only. The Area Under Precision-Recall Curve metric. Micro-averaged + // for the overall evaluation. + float au_prc = 1; + + // Output only. The Area Under Receiver Operating Characteristic curve metric. + // Micro-averaged for the overall evaluation. + float au_roc = 6; + + // Output only. The Log Loss metric. + float log_loss = 7; + + // Output only. Metrics for each confidence_threshold in + // 0.00,0.05,0.10,...,0.95,0.96,0.97,0.98,0.99 and + // position_threshold = INT32_MAX_VALUE. + // ROC and precision-recall curves, and other aggregated metrics are derived + // from them. The confidence metrics entries may also be supplied for + // additional values of position_threshold, but from these no aggregated + // metrics are computed. + repeated ConfidenceMetricsEntry confidence_metrics_entry = 3; + + // Output only. Confusion matrix of the evaluation. + // Only set for MULTICLASS classification problems where number + // of labels is no more than 10. + // Only set for model level evaluation, not for evaluation per label. + ConfusionMatrix confusion_matrix = 4; + + // Output only. The annotation spec ids used for this evaluation. + repeated string annotation_spec_id = 5; +} diff --git a/third_party/googleapis/google/cloud/automl/v1/data_items.proto b/third_party/googleapis/google/cloud/automl/v1/data_items.proto new file mode 100644 index 000000000..63896ba92 --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1/data_items.proto @@ -0,0 +1,192 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.automl.v1; + +import "google/cloud/automl/v1/geometry.proto"; +import "google/cloud/automl/v1/io.proto"; +import "google/cloud/automl/v1/text_segment.proto"; +import "google/protobuf/any.proto"; +import "google/protobuf/duration.proto"; +import "google/protobuf/struct.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Cloud.AutoML.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1;automl"; +option java_multiple_files = true; +option java_package = "com.google.cloud.automl.v1"; +option php_namespace = "Google\\Cloud\\AutoMl\\V1"; +option ruby_package = "Google::Cloud::AutoML::V1"; + +// A representation of an image. +// Only images up to 30MB in size are supported. +message Image { + // Input only. The data representing the image. + // For Predict calls [image_bytes][google.cloud.automl.v1.Image.image_bytes] must be set . + oneof data { + // Image content represented as a stream of bytes. + // Note: As with all `bytes` fields, protobuffers use a pure binary + // representation, whereas JSON representations use base64. + bytes image_bytes = 1; + } + + // Output only. HTTP URI to the thumbnail image. + string thumbnail_uri = 4; +} + +// A representation of a text snippet. +message TextSnippet { + // Required. The content of the text snippet as a string. Up to 250000 + // characters long. + string content = 1; + + // Optional. The format of [content][google.cloud.automl.v1.TextSnippet.content]. Currently the only two allowed + // values are "text/html" and "text/plain". If left blank, the format is + // automatically determined from the type of the uploaded [content][google.cloud.automl.v1.TextSnippet.content]. + string mime_type = 2; + + // Output only. HTTP URI where you can download the content. + string content_uri = 4; +} + +// Message that describes dimension of a document. +message DocumentDimensions { + // Unit of the document dimension. + enum DocumentDimensionUnit { + // Should not be used. + DOCUMENT_DIMENSION_UNIT_UNSPECIFIED = 0; + + // Document dimension is measured in inches. + INCH = 1; + + // Document dimension is measured in centimeters. + CENTIMETER = 2; + + // Document dimension is measured in points. 72 points = 1 inch. + POINT = 3; + } + + // Unit of the dimension. + DocumentDimensionUnit unit = 1; + + // Width value of the document, works together with the unit. + float width = 2; + + // Height value of the document, works together with the unit. + float height = 3; +} + +// A structured text document e.g. a PDF. +message Document { + // Describes the layout information of a [text_segment][google.cloud.automl.v1.Document.Layout.text_segment] in the document. + message Layout { + // The type of TextSegment in the context of the original document. + enum TextSegmentType { + // Should not be used. + TEXT_SEGMENT_TYPE_UNSPECIFIED = 0; + + // The text segment is a token. e.g. word. + TOKEN = 1; + + // The text segment is a paragraph. + PARAGRAPH = 2; + + // The text segment is a form field. + FORM_FIELD = 3; + + // The text segment is the name part of a form field. It will be treated + // as child of another FORM_FIELD TextSegment if its span is subspan of + // another TextSegment with type FORM_FIELD. + FORM_FIELD_NAME = 4; + + // The text segment is the text content part of a form field. It will be + // treated as child of another FORM_FIELD TextSegment if its span is + // subspan of another TextSegment with type FORM_FIELD. + FORM_FIELD_CONTENTS = 5; + + // The text segment is a whole table, including headers, and all rows. + TABLE = 6; + + // The text segment is a table's headers. It will be treated as child of + // another TABLE TextSegment if its span is subspan of another TextSegment + // with type TABLE. + TABLE_HEADER = 7; + + // The text segment is a row in table. It will be treated as child of + // another TABLE TextSegment if its span is subspan of another TextSegment + // with type TABLE. + TABLE_ROW = 8; + + // The text segment is a cell in table. It will be treated as child of + // another TABLE_ROW TextSegment if its span is subspan of another + // TextSegment with type TABLE_ROW. + TABLE_CELL = 9; + } + + // Text Segment that represents a segment in + // [document_text][google.cloud.automl.v1p1beta.Document.document_text]. + TextSegment text_segment = 1; + + // Page number of the [text_segment][google.cloud.automl.v1.Document.Layout.text_segment] in the original document, starts + // from 1. + int32 page_number = 2; + + // The position of the [text_segment][google.cloud.automl.v1.Document.Layout.text_segment] in the page. + // Contains exactly 4 + // + // [normalized_vertices][google.cloud.automl.v1p1beta.BoundingPoly.normalized_vertices] + // and they are connected by edges in the order provided, which will + // represent a rectangle parallel to the frame. The + // [NormalizedVertex-s][google.cloud.automl.v1p1beta.NormalizedVertex] are + // relative to the page. + // Coordinates are based on top-left as point (0,0). + BoundingPoly bounding_poly = 3; + + // The type of the [text_segment][google.cloud.automl.v1.Document.Layout.text_segment] in document. + TextSegmentType text_segment_type = 4; + } + + // An input config specifying the content of the document. + DocumentInputConfig input_config = 1; + + // The plain text version of this document. + TextSnippet document_text = 2; + + // Describes the layout of the document. + // Sorted by [page_number][]. + repeated Layout layout = 3; + + // The dimensions of the page in the document. + DocumentDimensions document_dimensions = 4; + + // Number of pages in the document. + int32 page_count = 5; +} + +// Example data used for training or prediction. +message ExamplePayload { + // Required. The example data. + oneof payload { + // Example image. + Image image = 1; + + // Example text. + TextSnippet text_snippet = 2; + + // Example document. + Document document = 4; + } +} diff --git a/third_party/googleapis/google/cloud/automl/v1/dataset.proto b/third_party/googleapis/google/cloud/automl/v1/dataset.proto new file mode 100644 index 000000000..2040ec96a --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1/dataset.proto @@ -0,0 +1,96 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.automl.v1; + +import "google/api/resource.proto"; +import "google/cloud/automl/v1/image.proto"; +import "google/cloud/automl/v1/text.proto"; +import "google/cloud/automl/v1/translation.proto"; +import "google/protobuf/timestamp.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Cloud.AutoML.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1;automl"; +option java_multiple_files = true; +option java_package = "com.google.cloud.automl.v1"; +option php_namespace = "Google\\Cloud\\AutoMl\\V1"; +option ruby_package = "Google::Cloud::AutoML::V1"; + +// A workspace for solving a single, particular machine learning (ML) problem. +// A workspace contains examples that may be annotated. +message Dataset { + option (google.api.resource) = { + type: "automl.googleapis.com/Dataset" + pattern: "projects/{project}/locations/{location}/datasets/{dataset}" + }; + + // Required. + // The dataset metadata that is specific to the problem type. + oneof dataset_metadata { + // Metadata for a dataset used for translation. + TranslationDatasetMetadata translation_dataset_metadata = 23; + + // Metadata for a dataset used for image classification. + ImageClassificationDatasetMetadata image_classification_dataset_metadata = 24; + + // Metadata for a dataset used for text classification. + TextClassificationDatasetMetadata text_classification_dataset_metadata = 25; + + // Metadata for a dataset used for image object detection. + ImageObjectDetectionDatasetMetadata image_object_detection_dataset_metadata = 26; + + // Metadata for a dataset used for text extraction. + TextExtractionDatasetMetadata text_extraction_dataset_metadata = 28; + + // Metadata for a dataset used for text sentiment. + TextSentimentDatasetMetadata text_sentiment_dataset_metadata = 30; + } + + // Output only. The resource name of the dataset. + // Form: `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}` + string name = 1; + + // Required. The name of the dataset to show in the interface. The name can be + // up to 32 characters long and can consist only of ASCII Latin letters A-Z + // and a-z, underscores + // (_), and ASCII digits 0-9. + string display_name = 2; + + // User-provided description of the dataset. The description can be up to + // 25000 characters long. + string description = 3; + + // Output only. The number of examples in the dataset. + int32 example_count = 21; + + // Output only. Timestamp when this dataset was created. + google.protobuf.Timestamp create_time = 14; + + // Used to perform consistent read-modify-write updates. If not set, a blind + // "overwrite" update happens. + string etag = 17; + + // Optional. The labels with user-defined metadata to organize your dataset. + // + // Label keys and values can be no longer than 64 characters + // (Unicode codepoints), can only contain lowercase letters, numeric + // characters, underscores and dashes. International characters are allowed. + // Label values are optional. Label keys must start with a letter. + // + // See https://goo.gl/xmQnxf for more information on and examples of labels. + map labels = 39; +} diff --git a/third_party/googleapis/google/cloud/automl/v1/detection.proto b/third_party/googleapis/google/cloud/automl/v1/detection.proto new file mode 100644 index 000000000..13fe5935f --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1/detection.proto @@ -0,0 +1,87 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.automl.v1; + +import "google/cloud/automl/v1/geometry.proto"; +import "google/protobuf/duration.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Cloud.AutoML.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1;automl"; +option java_multiple_files = true; +option java_package = "com.google.cloud.automl.v1"; +option php_namespace = "Google\\Cloud\\AutoMl\\V1"; +option ruby_package = "Google::Cloud::AutoML::V1"; + +// Annotation details for image object detection. +message ImageObjectDetectionAnnotation { + // Output only. The rectangle representing the object location. + BoundingPoly bounding_box = 1; + + // Output only. The confidence that this annotation is positive for the parent example, + // value in [0, 1], higher means higher positivity confidence. + float score = 2; +} + +// Bounding box matching model metrics for a single intersection-over-union +// threshold and multiple label match confidence thresholds. +message BoundingBoxMetricsEntry { + // Metrics for a single confidence threshold. + message ConfidenceMetricsEntry { + // Output only. The confidence threshold value used to compute the metrics. + float confidence_threshold = 1; + + // Output only. Recall under the given confidence threshold. + float recall = 2; + + // Output only. Precision under the given confidence threshold. + float precision = 3; + + // Output only. The harmonic mean of recall and precision. + float f1_score = 4; + } + + // Output only. The intersection-over-union threshold value used to compute + // this metrics entry. + float iou_threshold = 1; + + // Output only. The mean average precision, most often close to au_prc. + float mean_average_precision = 2; + + // Output only. Metrics for each label-match confidence_threshold from + // 0.05,0.10,...,0.95,0.96,0.97,0.98,0.99. Precision-recall curve is + // derived from them. + repeated ConfidenceMetricsEntry confidence_metrics_entries = 3; +} + +// Model evaluation metrics for image object detection problems. +// Evaluates prediction quality of labeled bounding boxes. +message ImageObjectDetectionEvaluationMetrics { + // Output only. The total number of bounding boxes (i.e. summed over all + // images) the ground truth used to create this evaluation had. + int32 evaluated_bounding_box_count = 1; + + // Output only. The bounding boxes match metrics for each + // Intersection-over-union threshold 0.05,0.10,...,0.95,0.96,0.97,0.98,0.99 + // and each label confidence threshold 0.05,0.10,...,0.95,0.96,0.97,0.98,0.99 + // pair. + repeated BoundingBoxMetricsEntry bounding_box_metrics_entries = 2; + + // Output only. The single metric for bounding boxes evaluation: + // the mean_average_precision averaged over all bounding_box_metrics_entries. + float bounding_box_mean_average_precision = 3; +} diff --git a/third_party/googleapis/google/cloud/automl/v1/geometry.proto b/third_party/googleapis/google/cloud/automl/v1/geometry.proto new file mode 100644 index 000000000..a6d97e805 --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1/geometry.proto @@ -0,0 +1,47 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.automl.v1; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Cloud.AutoML.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1;automl"; +option java_multiple_files = true; +option java_package = "com.google.cloud.automl.v1"; +option php_namespace = "Google\\Cloud\\AutoMl\\V1"; +option ruby_package = "Google::Cloud::AutoML::V1"; + +// A vertex represents a 2D point in the image. +// The normalized vertex coordinates are between 0 to 1 fractions relative to +// the original plane (image, video). E.g. if the plane (e.g. whole image) would +// have size 10 x 20 then a point with normalized coordinates (0.1, 0.3) would +// be at the position (1, 6) on that plane. +message NormalizedVertex { + // Required. Horizontal coordinate. + float x = 1; + + // Required. Vertical coordinate. + float y = 2; +} + +// A bounding polygon of a detected object on a plane. +// On output both vertices and normalized_vertices are provided. +// The polygon is formed by connecting vertices in the order they are listed. +message BoundingPoly { + // Output only . The bounding polygon normalized vertices. + repeated NormalizedVertex normalized_vertices = 2; +} diff --git a/third_party/googleapis/google/cloud/automl/v1/image.proto b/third_party/googleapis/google/cloud/automl/v1/image.proto new file mode 100644 index 000000000..5269d22c0 --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1/image.proto @@ -0,0 +1,206 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.automl.v1; + +import "google/api/resource.proto"; +import "google/cloud/automl/v1/annotation_spec.proto"; +import "google/cloud/automl/v1/classification.proto"; +import "google/protobuf/timestamp.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Cloud.AutoML.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1;automl"; +option java_multiple_files = true; +option java_outer_classname = "ImageProto"; +option java_package = "com.google.cloud.automl.v1"; +option php_namespace = "Google\\Cloud\\AutoMl\\V1"; +option ruby_package = "Google::Cloud::AutoML::V1"; + +// Dataset metadata that is specific to image classification. +message ImageClassificationDatasetMetadata { + // Required. Type of the classification problem. + ClassificationType classification_type = 1; +} + +// Dataset metadata specific to image object detection. +message ImageObjectDetectionDatasetMetadata { + +} + +// Model metadata for image classification. +message ImageClassificationModelMetadata { + // Optional. The ID of the `base` model. If it is specified, the new model + // will be created based on the `base` model. Otherwise, the new model will be + // created from scratch. The `base` model must be in the same + // `project` and `location` as the new model to create, and have the same + // `model_type`. + string base_model_id = 1; + + // The train budget of creating this model, expressed in milli node + // hours i.e. 1,000 value in this field means 1 node hour. The actual + // `train_cost` will be equal or less than this value. If further model + // training ceases to provide any improvements, it will stop without using + // full budget and the stop_reason will be `MODEL_CONVERGED`. + // Note, node_hour = actual_hour * number_of_nodes_invovled. + // For model type `cloud`(default), the train budget must be between 8,000 + // and 800,000 milli node hours, inclusive. The default value is 192, 000 + // which represents one day in wall time. For model type + // `mobile-low-latency-1`, `mobile-versatile-1`, `mobile-high-accuracy-1`, + // `mobile-core-ml-low-latency-1`, `mobile-core-ml-versatile-1`, + // `mobile-core-ml-high-accuracy-1`, the train budget must be between 1,000 + // and 100,000 milli node hours, inclusive. The default value is 24, 000 which + // represents one day in wall time. + int64 train_budget_milli_node_hours = 16; + + // Output only. The actual train cost of creating this model, expressed in + // milli node hours, i.e. 1,000 value in this field means 1 node hour. + // Guaranteed to not exceed the train budget. + int64 train_cost_milli_node_hours = 17; + + // Output only. The reason that this create model operation stopped, + // e.g. `BUDGET_REACHED`, `MODEL_CONVERGED`. + string stop_reason = 5; + + // Optional. Type of the model. The available values are: + // * `cloud` - Model to be used via prediction calls to AutoML API. + // This is the default value. + // * `mobile-low-latency-1` - A model that, in addition to providing + // prediction via AutoML API, can also be exported (see + // [AutoMl.ExportModel][google.cloud.automl.v1.AutoMl.ExportModel]) and used on a mobile or edge device + // with TensorFlow afterwards. Expected to have low latency, but + // may have lower prediction quality than other models. + // * `mobile-versatile-1` - A model that, in addition to providing + // prediction via AutoML API, can also be exported (see + // [AutoMl.ExportModel][google.cloud.automl.v1.AutoMl.ExportModel]) and used on a mobile or edge device + // with TensorFlow afterwards. + // * `mobile-high-accuracy-1` - A model that, in addition to providing + // prediction via AutoML API, can also be exported (see + // [AutoMl.ExportModel][google.cloud.automl.v1.AutoMl.ExportModel]) and used on a mobile or edge device + // with TensorFlow afterwards. Expected to have a higher + // latency, but should also have a higher prediction quality + // than other models. + // * `mobile-core-ml-low-latency-1` - A model that, in addition to providing + // prediction via AutoML API, can also be exported (see + // [AutoMl.ExportModel][google.cloud.automl.v1.AutoMl.ExportModel]) and used on a mobile device with Core + // ML afterwards. Expected to have low latency, but may have + // lower prediction quality than other models. + // * `mobile-core-ml-versatile-1` - A model that, in addition to providing + // prediction via AutoML API, can also be exported (see + // [AutoMl.ExportModel][google.cloud.automl.v1.AutoMl.ExportModel]) and used on a mobile device with Core + // ML afterwards. + // * `mobile-core-ml-high-accuracy-1` - A model that, in addition to + // providing prediction via AutoML API, can also be exported + // (see [AutoMl.ExportModel][google.cloud.automl.v1.AutoMl.ExportModel]) and used on a mobile device with + // Core ML afterwards. Expected to have a higher latency, but + // should also have a higher prediction quality than other + // models. + string model_type = 7; + + // Output only. An approximate number of online prediction QPS that can + // be supported by this model per each node on which it is deployed. + double node_qps = 13; + + // Output only. The number of nodes this model is deployed on. A node is an + // abstraction of a machine resource, which can handle online prediction QPS + // as given in the node_qps field. + int64 node_count = 14; +} + +// Model metadata specific to image object detection. +message ImageObjectDetectionModelMetadata { + // Optional. Type of the model. The available values are: + // * `cloud-high-accuracy-1` - (default) A model to be used via prediction + // calls to AutoML API. Expected to have a higher latency, but + // should also have a higher prediction quality than other + // models. + // * `cloud-low-latency-1` - A model to be used via prediction + // calls to AutoML API. Expected to have low latency, but may + // have lower prediction quality than other models. + // * `mobile-low-latency-1` - A model that, in addition to providing + // prediction via AutoML API, can also be exported (see + // [AutoMl.ExportModel][google.cloud.automl.v1.AutoMl.ExportModel]) and used on a mobile or edge device + // with TensorFlow afterwards. Expected to have low latency, but + // may have lower prediction quality than other models. + // * `mobile-versatile-1` - A model that, in addition to providing + // prediction via AutoML API, can also be exported (see + // [AutoMl.ExportModel][google.cloud.automl.v1.AutoMl.ExportModel]) and used on a mobile or edge device + // with TensorFlow afterwards. + // * `mobile-high-accuracy-1` - A model that, in addition to providing + // prediction via AutoML API, can also be exported (see + // [AutoMl.ExportModel][google.cloud.automl.v1.AutoMl.ExportModel]) and used on a mobile or edge device + // with TensorFlow afterwards. Expected to have a higher + // latency, but should also have a higher prediction quality + // than other models. + string model_type = 1; + + // Output only. The number of nodes this model is deployed on. A node is an + // abstraction of a machine resource, which can handle online prediction QPS + // as given in the qps_per_node field. + int64 node_count = 3; + + // Output only. An approximate number of online prediction QPS that can + // be supported by this model per each node on which it is deployed. + double node_qps = 4; + + // Output only. The reason that this create model operation stopped, + // e.g. `BUDGET_REACHED`, `MODEL_CONVERGED`. + string stop_reason = 5; + + // The train budget of creating this model, expressed in milli node + // hours i.e. 1,000 value in this field means 1 node hour. The actual + // `train_cost` will be equal or less than this value. If further model + // training ceases to provide any improvements, it will stop without using + // full budget and the stop_reason will be `MODEL_CONVERGED`. + // Note, node_hour = actual_hour * number_of_nodes_invovled. + // For model type `cloud-high-accuracy-1`(default) and `cloud-low-latency-1`, + // the train budget must be between 20,000 and 900,000 milli node hours, + // inclusive. The default value is 216, 000 which represents one day in + // wall time. + // For model type `mobile-low-latency-1`, `mobile-versatile-1`, + // `mobile-high-accuracy-1`, `mobile-core-ml-low-latency-1`, + // `mobile-core-ml-versatile-1`, `mobile-core-ml-high-accuracy-1`, the train + // budget must be between 1,000 and 100,000 milli node hours, inclusive. + // The default value is 24, 000 which represents one day in wall time. + int64 train_budget_milli_node_hours = 6; + + // Output only. The actual train cost of creating this model, expressed in + // milli node hours, i.e. 1,000 value in this field means 1 node hour. + // Guaranteed to not exceed the train budget. + int64 train_cost_milli_node_hours = 7; +} + +// Model deployment metadata specific to Image Classification. +message ImageClassificationModelDeploymentMetadata { + // Input only. The number of nodes to deploy the model on. A node is an + // abstraction of a machine resource, which can handle online prediction QPS + // as given in the model's + // + // [node_qps][google.cloud.automl.v1.ImageClassificationModelMetadata.node_qps]. + // Must be between 1 and 100, inclusive on both ends. + int64 node_count = 1; +} + +// Model deployment metadata specific to Image Object Detection. +message ImageObjectDetectionModelDeploymentMetadata { + // Input only. The number of nodes to deploy the model on. A node is an + // abstraction of a machine resource, which can handle online prediction QPS + // as given in the model's + // + // [qps_per_node][google.cloud.automl.v1.ImageObjectDetectionModelMetadata.qps_per_node]. + // Must be between 1 and 100, inclusive on both ends. + int64 node_count = 1; +} diff --git a/third_party/googleapis/google/cloud/automl/v1/io.proto b/third_party/googleapis/google/cloud/automl/v1/io.proto new file mode 100644 index 000000000..c6ac8a35b --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1/io.proto @@ -0,0 +1,1377 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.automl.v1; + +import "google/api/field_behavior.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Cloud.AutoML.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1;automl"; +option java_multiple_files = true; +option java_package = "com.google.cloud.automl.v1"; +option php_namespace = "Google\\Cloud\\AutoMl\\V1"; +option ruby_package = "Google::Cloud::AutoML::V1"; + +// Input configuration for [AutoMl.ImportData][google.cloud.automl.v1.AutoMl.ImportData] action. +// +// The format of input depends on dataset_metadata the Dataset into which +// the import is happening has. As input source the +// [gcs_source][google.cloud.automl.v1.InputConfig.gcs_source] +// is expected, unless specified otherwise. Additionally any input .CSV file +// by itself must be 100MB or smaller, unless specified otherwise. +// If an "example" file (that is, image, video etc.) with identical content +// (even if it had different `GCS_FILE_PATH`) is mentioned multiple times, then +// its label, bounding boxes etc. are appended. The same file should be always +// provided with the same `ML_USE` and `GCS_FILE_PATH`, if it is not, then +// these values are nondeterministically selected from the given ones. +// +// The formats are represented in EBNF with commas being literal and with +// non-terminal symbols defined near the end of this comment. The formats are: +// +//

          AutoML Vision

          +// +// +//
          Classification
          +// +// See [Preparing your training +// data](https://cloud.google.com/vision/automl/docs/prepare) for more +// information. +// +// CSV file(s) with each line in format: +// +// ML_USE,GCS_FILE_PATH,LABEL,LABEL,... +// +// * `ML_USE` - Identifies the data set that the current row (file) applies +// to. +// This value can be one of the following: +// * `TRAIN` - Rows in this file are used to train the model. +// * `TEST` - Rows in this file are used to test the model during training. +// * `UNASSIGNED` - Rows in this file are not categorized. They are +// Automatically divided into train and test data. 80% for training and +// 20% for testing. +// +// * `GCS_FILE_PATH` - The Google Cloud Storage location of an image of up to +// 30MB in size. Supported extensions: .JPEG, .GIF, .PNG, .WEBP, .BMP, +// .TIFF, .ICO. +// +// * `LABEL` - A label that identifies the object in the image. +// +// For the `MULTICLASS` classification type, at most one `LABEL` is allowed +// per image. If an image has not yet been labeled, then it should be +// mentioned just once with no `LABEL`. +// +// Some sample rows: +// +// TRAIN,gs://folder/image1.jpg,daisy +// TEST,gs://folder/image2.jpg,dandelion,tulip,rose +// UNASSIGNED,gs://folder/image3.jpg,daisy +// UNASSIGNED,gs://folder/image4.jpg +// +// +//
          Object Detection
          +// See [Preparing your training +// data](https://cloud.google.com/vision/automl/object-detection/docs/prepare) +// for more information. +// +// A CSV file(s) with each line in format: +// +// ML_USE,GCS_FILE_PATH,[LABEL],(BOUNDING_BOX | ,,,,,,,) +// +// * `ML_USE` - Identifies the data set that the current row (file) applies +// to. +// This value can be one of the following: +// * `TRAIN` - Rows in this file are used to train the model. +// * `TEST` - Rows in this file are used to test the model during training. +// * `UNASSIGNED` - Rows in this file are not categorized. They are +// Automatically divided into train and test data. 80% for training and +// 20% for testing. +// +// * `GCS_FILE_PATH` - The Google Cloud Storage location of an image of up to +// 30MB in size. Supported extensions: .JPEG, .GIF, .PNG. Each image +// is assumed to be exhaustively labeled. +// +// * `LABEL` - A label that identifies the object in the image specified by the +// `BOUNDING_BOX`. +// +// * `BOUNDING BOX` - The vertices of an object in the example image. +// The minimum allowed `BOUNDING_BOX` edge length is 0.01, and no more than +// 500 `BOUNDING_BOX` instances per image are allowed (one `BOUNDING_BOX` +// per line). If an image has no looked for objects then it should be +// mentioned just once with no LABEL and the ",,,,,,," in place of the +// `BOUNDING_BOX`. +// +// **Four sample rows:** +// +// TRAIN,gs://folder/image1.png,car,0.1,0.1,,,0.3,0.3,, +// TRAIN,gs://folder/image1.png,bike,.7,.6,,,.8,.9,, +// UNASSIGNED,gs://folder/im2.png,car,0.1,0.1,0.2,0.1,0.2,0.3,0.1,0.3 +// TEST,gs://folder/im3.png,,,,,,,,, +//
          +//
          +// +// +//

          AutoML Video Intelligence

          +// +// +//
          Classification
          +// +// See [Preparing your training +// data](https://cloud.google.com/video-intelligence/automl/docs/prepare) for +// more information. +// +// CSV file(s) with each line in format: +// +// ML_USE,GCS_FILE_PATH +// +// For `ML_USE`, do not use `VALIDATE`. +// +// `GCS_FILE_PATH` is the path to another .csv file that describes training +// example for a given `ML_USE`, using the following row format: +// +// GCS_FILE_PATH,(LABEL,TIME_SEGMENT_START,TIME_SEGMENT_END | ,,) +// +// Here `GCS_FILE_PATH` leads to a video of up to 50GB in size and up +// to 3h duration. Supported extensions: .MOV, .MPEG4, .MP4, .AVI. +// +// `TIME_SEGMENT_START` and `TIME_SEGMENT_END` must be within the +// length of the video, and the end time must be after the start time. Any +// segment of a video which has one or more labels on it, is considered a +// hard negative for all other labels. Any segment with no labels on +// it is considered to be unknown. If a whole video is unknown, then +// it should be mentioned just once with ",," in place of `LABEL, +// TIME_SEGMENT_START,TIME_SEGMENT_END`. +// +// Sample top level CSV file: +// +// TRAIN,gs://folder/train_videos.csv +// TEST,gs://folder/test_videos.csv +// UNASSIGNED,gs://folder/other_videos.csv +// +// Sample rows of a CSV file for a particular ML_USE: +// +// gs://folder/video1.avi,car,120,180.000021 +// gs://folder/video1.avi,bike,150,180.000021 +// gs://folder/vid2.avi,car,0,60.5 +// gs://folder/vid3.avi,,, +// +// +// +//
          Object Tracking
          +// +// See [Preparing your training +// data](/video-intelligence/automl/object-tracking/docs/prepare) for more +// information. +// +// CSV file(s) with each line in format: +// +// ML_USE,GCS_FILE_PATH +// +// For `ML_USE`, do not use `VALIDATE`. +// +// `GCS_FILE_PATH` is the path to another .csv file that describes training +// example for a given `ML_USE`, using the following row format: +// +// GCS_FILE_PATH,LABEL,[INSTANCE_ID],TIMESTAMP,BOUNDING_BOX +// +// or +// +// GCS_FILE_PATH,,,,,,,,,, +// +// Here `GCS_FILE_PATH` leads to a video of up to 50GB in size and up +// to 3h duration. Supported extensions: .MOV, .MPEG4, .MP4, .AVI. +// Providing `INSTANCE_ID`s can help to obtain a better model. When +// a specific labeled entity leaves the video frame, and shows up +// afterwards it is not required, albeit preferable, that the same +// `INSTANCE_ID` is given to it. +// +// `TIMESTAMP` must be within the length of the video, the +// `BOUNDING_BOX` is assumed to be drawn on the closest video's frame +// to the `TIMESTAMP`. Any mentioned by the `TIMESTAMP` frame is expected +// to be exhaustively labeled and no more than 500 `BOUNDING_BOX`-es per +// frame are allowed. If a whole video is unknown, then it should be +// mentioned just once with ",,,,,,,,,," in place of `LABEL, +// [INSTANCE_ID],TIMESTAMP,BOUNDING_BOX`. +// +// Sample top level CSV file: +// +// TRAIN,gs://folder/train_videos.csv +// TEST,gs://folder/test_videos.csv +// UNASSIGNED,gs://folder/other_videos.csv +// +// Seven sample rows of a CSV file for a particular ML_USE: +// +// gs://folder/video1.avi,car,1,12.10,0.8,0.8,0.9,0.8,0.9,0.9,0.8,0.9 +// gs://folder/video1.avi,car,1,12.90,0.4,0.8,0.5,0.8,0.5,0.9,0.4,0.9 +// gs://folder/video1.avi,car,2,12.10,.4,.2,.5,.2,.5,.3,.4,.3 +// gs://folder/video1.avi,car,2,12.90,.8,.2,,,.9,.3,, +// gs://folder/video1.avi,bike,,12.50,.45,.45,,,.55,.55,, +// gs://folder/video2.avi,car,1,0,.1,.9,,,.9,.1,, +// gs://folder/video2.avi,,,,,,,,,,, +//
          +//
          +// +// +//

          AutoML Natural Language

          +// +// +//
          Entity Extraction
          +// +// See [Preparing your training +// data](/natural-language/automl/entity-analysis/docs/prepare) for more +// information. +// +// One or more CSV file(s) with each line in the following format: +// +// ML_USE,GCS_FILE_PATH +// +// * `ML_USE` - Identifies the data set that the current row (file) applies +// to. +// This value can be one of the following: +// * `TRAIN` - Rows in this file are used to train the model. +// * `TEST` - Rows in this file are used to test the model during training. +// * `UNASSIGNED` - Rows in this file are not categorized. They are +// Automatically divided into train and test data. 80% for training and +// 20% for testing.. +// +// * `GCS_FILE_PATH` - a Identifies JSON Lines (.JSONL) file stored in +// Google Cloud Storage that contains in-line text in-line as documents +// for model training. +// +// After the training data set has been determined from the `TRAIN` and +// `UNASSIGNED` CSV files, the training data is divided into train and +// validation data sets. 70% for training and 30% for validation. +// +// For example: +// +// TRAIN,gs://folder/file1.jsonl +// VALIDATE,gs://folder/file2.jsonl +// TEST,gs://folder/file3.jsonl +// +// **In-line JSONL files** +// +// In-line .JSONL files contain, per line, a JSON document that wraps a +// [`text_snippet`][google.cloud.automl.v1.TextSnippet] field followed by +// one or more [`annotations`][google.cloud.automl.v1.AnnotationPayload] +// fields, which have `display_name` and `text_extraction` fields to describe +// the entity from the text snippet. Multiple JSON documents can be separated +// using line breaks (\n). +// +// The supplied text must be annotated exhaustively. For example, if you +// include the text "horse", but do not label it as "animal", +// then "horse" is assumed to not be an "animal". +// +// Any given text snippet content must have 30,000 characters or +// less, and also be UTF-8 NFC encoded. ASCII is accepted as it is +// UTF-8 NFC encoded. +// +// For example: +// +// { +// "text_snippet": { +// "content": "dog car cat" +// }, +// "annotations": [ +// { +// "display_name": "animal", +// "text_extraction": { +// "text_segment": {"start_offset": 0, "end_offset": 2} +// } +// }, +// { +// "display_name": "vehicle", +// "text_extraction": { +// "text_segment": {"start_offset": 4, "end_offset": 6} +// } +// }, +// { +// "display_name": "animal", +// "text_extraction": { +// "text_segment": {"start_offset": 8, "end_offset": 10} +// } +// } +// ] +// }\n +// { +// "text_snippet": { +// "content": "This dog is good." +// }, +// "annotations": [ +// { +// "display_name": "animal", +// "text_extraction": { +// "text_segment": {"start_offset": 5, "end_offset": 7} +// } +// } +// ] +// } +// +// **JSONL files that reference documents** +// +// .JSONL files contain, per line, a JSON document that wraps a +// `input_config` that contains the path to a source document. +// Multiple JSON documents can be separated using line breaks (\n). +// +// Supported document extensions: .PDF, .TIF, .TIFF +// +// For example: +// +// { +// "document": { +// "input_config": { +// "gcs_source": { "input_uris": [ "gs://folder/document1.pdf" ] +// } +// } +// } +// }\n +// { +// "document": { +// "input_config": { +// "gcs_source": { "input_uris": [ "gs://folder/document2.tif" ] +// } +// } +// } +// } +// +// **In-line JSONL files with document layout information** +// +// **Note:** You can only annotate documents using the UI. The format described +// below applies to annotated documents exported using the UI or `exportData`. +// +// In-line .JSONL files for documents contain, per line, a JSON document +// that wraps a `document` field that provides the textual content of the +// document and the layout information. +// +// For example: +// +// { +// "document": { +// "document_text": { +// "content": "dog car cat" +// } +// "layout": [ +// { +// "text_segment": { +// "start_offset": 0, +// "end_offset": 11, +// }, +// "page_number": 1, +// "bounding_poly": { +// "normalized_vertices": [ +// {"x": 0.1, "y": 0.1}, +// {"x": 0.1, "y": 0.3}, +// {"x": 0.3, "y": 0.3}, +// {"x": 0.3, "y": 0.1}, +// ], +// }, +// "text_segment_type": TOKEN, +// } +// ], +// "document_dimensions": { +// "width": 8.27, +// "height": 11.69, +// "unit": INCH, +// } +// "page_count": 3, +// }, +// "annotations": [ +// { +// "display_name": "animal", +// "text_extraction": { +// "text_segment": {"start_offset": 0, "end_offset": 3} +// } +// }, +// { +// "display_name": "vehicle", +// "text_extraction": { +// "text_segment": {"start_offset": 4, "end_offset": 7} +// } +// }, +// { +// "display_name": "animal", +// "text_extraction": { +// "text_segment": {"start_offset": 8, "end_offset": 11} +// } +// }, +// ], +// +// +// +// +//
          Classification
          +// +// See [Preparing your training +// data](https://cloud.google.com/natural-language/automl/docs/prepare) for more +// information. +// +// One or more CSV file(s) with each line in the following format: +// +// ML_USE,(TEXT_SNIPPET | GCS_FILE_PATH),LABEL,LABEL,... +// +// * `ML_USE` - Identifies the data set that the current row (file) applies +// to. +// This value can be one of the following: +// * `TRAIN` - Rows in this file are used to train the model. +// * `TEST` - Rows in this file are used to test the model during training. +// * `UNASSIGNED` - Rows in this file are not categorized. They are +// Automatically divided into train and test data. 80% for training and +// 20% for testing. +// +// * `TEXT_SNIPPET` and `GCS_FILE_PATH` are distinguished by a pattern. If +// the column content is a valid Google Cloud Storage file path, that is, +// prefixed by "gs://", it is treated as a `GCS_FILE_PATH`. Otherwise, if +// the content is enclosed in double quotes (""), it is treated as a +// `TEXT_SNIPPET`. For `GCS_FILE_PATH`, the path must lead to a +// file with supported extension and UTF-8 encoding, for example, +// "gs://folder/content.txt" AutoML imports the file content +// as a text snippet. For `TEXT_SNIPPET`, AutoML imports the column content +// excluding quotes. In both cases, size of the content must be 10MB or +// less in size. For zip files, the size of each file inside the zip must be +// 10MB or less in size. +// +// For the `MULTICLASS` classification type, at most one `LABEL` is allowed. +// +// The `ML_USE` and `LABEL` columns are optional. +// Supported file extensions: .TXT, .PDF, .TIF, .TIFF, .ZIP +// +// A maximum of 100 unique labels are allowed per CSV row. +// +// Sample rows: +// +// TRAIN,"They have bad food and very rude",RudeService,BadFood +// gs://folder/content.txt,SlowService +// TEST,gs://folder/document.pdf +// VALIDATE,gs://folder/text_files.zip,BadFood +// +// +// +//
          Sentiment Analysis
          +// +// See [Preparing your training +// data](https://cloud.google.com/natural-language/automl/docs/prepare) for more +// information. +// +// CSV file(s) with each line in format: +// +// ML_USE,(TEXT_SNIPPET | GCS_FILE_PATH),SENTIMENT +// +// * `ML_USE` - Identifies the data set that the current row (file) applies +// to. +// This value can be one of the following: +// * `TRAIN` - Rows in this file are used to train the model. +// * `TEST` - Rows in this file are used to test the model during training. +// * `UNASSIGNED` - Rows in this file are not categorized. They are +// Automatically divided into train and test data. 80% for training and +// 20% for testing. +// +// * `TEXT_SNIPPET` and `GCS_FILE_PATH` are distinguished by a pattern. If +// the column content is a valid Google Cloud Storage file path, that is, +// prefixed by "gs://", it is treated as a `GCS_FILE_PATH`. Otherwise, if +// the content is enclosed in double quotes (""), it is treated as a +// `TEXT_SNIPPET`. For `GCS_FILE_PATH`, the path must lead to a +// file with supported extension and UTF-8 encoding, for example, +// "gs://folder/content.txt" AutoML imports the file content +// as a text snippet. For `TEXT_SNIPPET`, AutoML imports the column content +// excluding quotes. In both cases, size of the content must be 128kB or +// less in size. For zip files, the size of each file inside the zip must be +// 128kB or less in size. +// +// The `ML_USE` and `SENTIMENT` columns are optional. +// Supported file extensions: .TXT, .PDF, .TIF, .TIFF, .ZIP +// +// * `SENTIMENT` - An integer between 0 and +// Dataset.text_sentiment_dataset_metadata.sentiment_max +// (inclusive). Describes the ordinal of the sentiment - higher +// value means a more positive sentiment. All the values are +// completely relative, i.e. neither 0 needs to mean a negative or +// neutral sentiment nor sentiment_max needs to mean a positive one - +// it is just required that 0 is the least positive sentiment +// in the data, and sentiment_max is the most positive one. +// The SENTIMENT shouldn't be confused with "score" or "magnitude" +// from the previous Natural Language Sentiment Analysis API. +// All SENTIMENT values between 0 and sentiment_max must be +// represented in the imported data. On prediction the same 0 to +// sentiment_max range will be used. The difference between +// neighboring sentiment values needs not to be uniform, e.g. 1 and +// 2 may be similar whereas the difference between 2 and 3 may be +// large. +// +// Sample rows: +// +// TRAIN,"@freewrytin this is way too good for your product",2 +// gs://folder/content.txt,3 +// TEST,gs://folder/document.pdf +// VALIDATE,gs://folder/text_files.zip,2 +//
          +//
          +// +// +// +//

          AutoML Tables

          +// +// See [Preparing your training +// data](https://cloud.google.com/automl-tables/docs/prepare) for more +// information. +// +// You can use either +// [gcs_source][google.cloud.automl.v1.InputConfig.gcs_source] or +// [bigquery_source][google.cloud.automl.v1.InputConfig.bigquery_source]. +// All input is concatenated into a +// single +// +// [primary_table_spec_id][google.cloud.automl.v1.TablesDatasetMetadata.primary_table_spec_id] +// +// **For gcs_source:** +// +// CSV file(s), where the first row of the first file is the header, +// containing unique column names. If the first row of a subsequent +// file is the same as the header, then it is also treated as a +// header. All other rows contain values for the corresponding +// columns. +// +// Each .CSV file by itself must be 10GB or smaller, and their total +// size must be 100GB or smaller. +// +// First three sample rows of a CSV file: +// 
          +// "Id","First Name","Last Name","Dob","Addresses"
+//
+// "1","John","Doe","1968-01-22","[{"status":"current","address":"123_First_Avenue","city":"Seattle","state":"WA","zip":"11111","numberOfYears":"1"},{"status":"previous","address":"456_Main_Street","city":"Portland","state":"OR","zip":"22222","numberOfYears":"5"}]"
+//
+// "2","Jane","Doe","1980-10-16","[{"status":"current","address":"789_Any_Avenue","city":"Albany","state":"NY","zip":"33333","numberOfYears":"2"},{"status":"previous","address":"321_Main_Street","city":"Hoboken","state":"NJ","zip":"44444","numberOfYears":"3"}]}
+//
          +// **For bigquery_source:** +// +// An URI of a BigQuery table. The user data size of the BigQuery +// table must be 100GB or smaller. +// +// An imported table must have between 2 and 1,000 columns, inclusive, +// and between 1000 and 100,000,000 rows, inclusive. There are at most 5 +// import data running in parallel. +// +//
          +//
          +// +// +// **Input field definitions:** +// +// `ML_USE` +// : ("TRAIN" | "VALIDATE" | "TEST" | "UNASSIGNED") +// Describes how the given example (file) should be used for model +// training. "UNASSIGNED" can be used when user has no preference. +// +// `GCS_FILE_PATH` +// : The path to a file on Google Cloud Storage. For example, +// "gs://folder/image1.png". +// +// `LABEL` +// : A display name of an object on an image, video etc., e.g. "dog". +// Must be up to 32 characters long and can consist only of ASCII +// Latin letters A-Z and a-z, underscores(_), and ASCII digits 0-9. +// For each label an AnnotationSpec is created which display_name +// becomes the label; AnnotationSpecs are given back in predictions. +// +// `INSTANCE_ID` +// : A positive integer that identifies a specific instance of a +// labeled entity on an example. Used e.g. to track two cars on +// a video while being able to tell apart which one is which. +// +// `BOUNDING_BOX` +// : (`VERTEX,VERTEX,VERTEX,VERTEX` | `VERTEX,,,VERTEX,,`) +// A rectangle parallel to the frame of the example (image, +// video). If 4 vertices are given they are connected by edges +// in the order provided, if 2 are given they are recognized +// as diagonally opposite vertices of the rectangle. +// +// `VERTEX` +// : (`COORDINATE,COORDINATE`) +// First coordinate is horizontal (x), the second is vertical (y). +// +// `COORDINATE` +// : A float in 0 to 1 range, relative to total length of +// image or video in given dimension. For fractions the +// leading non-decimal 0 can be omitted (i.e. 0.3 = .3). +// Point 0,0 is in top left. +// +// `TIME_SEGMENT_START` +// : (`TIME_OFFSET`) +// Expresses a beginning, inclusive, of a time segment +// within an example that has a time dimension +// (e.g. video). +// +// `TIME_SEGMENT_END` +// : (`TIME_OFFSET`) +// Expresses an end, exclusive, of a time segment within +// n example that has a time dimension (e.g. video). +// +// `TIME_OFFSET` +// : A number of seconds as measured from the start of an +// example (e.g. video). Fractions are allowed, up to a +// microsecond precision. "inf" is allowed, and it means the end +// of the example. +// +// `TEXT_SNIPPET` +// : The content of a text snippet, UTF-8 encoded, enclosed within +// double quotes (""). +// +// `DOCUMENT` +// : A field that provides the textual content with document and the layout +// information. +// +// +// **Errors:** +// +// If any of the provided CSV files can't be parsed or if more than certain +// percent of CSV rows cannot be processed then the operation fails and +// nothing is imported. Regardless of overall success or failure the per-row +// failures, up to a certain count cap, is listed in +// Operation.metadata.partial_failures. +// +message InputConfig { + // The source of the input. + oneof source { + // The Google Cloud Storage location for the input content. + // For [AutoMl.ImportData][google.cloud.automl.v1.AutoMl.ImportData], `gcs_source` points to a CSV file with + // a structure described in [InputConfig][google.cloud.automl.v1.InputConfig]. + GcsSource gcs_source = 1; + } + + // Additional domain-specific parameters describing the semantic of the + // imported data, any string must be up to 25000 + // characters long. + // + //

          AutoML Tables

          + // + // `schema_inference_version` + // : (integer) This value must be supplied. + // The version of the + // algorithm to use for the initial inference of the + // column data types of the imported table. Allowed values: "1". + map params = 2; +} + +// Input configuration for BatchPredict Action. +// +// The format of input depends on the ML problem of the model used for +// prediction. As input source the +// [gcs_source][google.cloud.automl.v1.InputConfig.gcs_source] +// is expected, unless specified otherwise. +// +// The formats are represented in EBNF with commas being literal and with +// non-terminal symbols defined near the end of this comment. The formats +// are: +// +//

          AutoML Vision

          +//
          Classification
          +// +// One or more CSV files where each line is a single column: +// +// GCS_FILE_PATH +// +// The Google Cloud Storage location of an image of up to +// 30MB in size. Supported extensions: .JPEG, .GIF, .PNG. +// This path is treated as the ID in the batch predict output. +// +// Sample rows: +// +// gs://folder/image1.jpeg +// gs://folder/image2.gif +// gs://folder/image3.png +// +//
          Object Detection
          +// +// One or more CSV files where each line is a single column: +// +// GCS_FILE_PATH +// +// The Google Cloud Storage location of an image of up to +// 30MB in size. Supported extensions: .JPEG, .GIF, .PNG. +// This path is treated as the ID in the batch predict output. +// +// Sample rows: +// +// gs://folder/image1.jpeg +// gs://folder/image2.gif +// gs://folder/image3.png +//
          +//
          +// +//

          AutoML Video Intelligence

          +//
          Classification
          +// +// One or more CSV files where each line is a single column: +// +// GCS_FILE_PATH,TIME_SEGMENT_START,TIME_SEGMENT_END +// +// `GCS_FILE_PATH` is the Google Cloud Storage location of video up to 50GB in +// size and up to 3h in duration duration. +// Supported extensions: .MOV, .MPEG4, .MP4, .AVI. +// +// `TIME_SEGMENT_START` and `TIME_SEGMENT_END` must be within the +// length of the video, and the end time must be after the start time. +// +// Sample rows: +// +// gs://folder/video1.mp4,10,40 +// gs://folder/video1.mp4,20,60 +// gs://folder/vid2.mov,0,inf +// +//
          Object Tracking
          +// +// One or more CSV files where each line is a single column: +// +// GCS_FILE_PATH,TIME_SEGMENT_START,TIME_SEGMENT_END +// +// `GCS_FILE_PATH` is the Google Cloud Storage location of video up to 50GB in +// size and up to 3h in duration duration. +// Supported extensions: .MOV, .MPEG4, .MP4, .AVI. +// +// `TIME_SEGMENT_START` and `TIME_SEGMENT_END` must be within the +// length of the video, and the end time must be after the start time. +// +// Sample rows: +// +// gs://folder/video1.mp4,10,40 +// gs://folder/video1.mp4,20,60 +// gs://folder/vid2.mov,0,inf +//
          +//
          +// +//

          AutoML Natural Language

          +//
          Classification
          +// +// One or more CSV files where each line is a single column: +// +// GCS_FILE_PATH +// +// `GCS_FILE_PATH` is the Google Cloud Storage location of a text file. +// Supported file extensions: .TXT, .PDF, .TIF, .TIFF +// +// Text files can be no larger than 10MB in size. +// +// Sample rows: +// +// gs://folder/text1.txt +// gs://folder/text2.pdf +// gs://folder/text3.tif +// +//
          Sentiment Analysis
          +// One or more CSV files where each line is a single column: +// +// GCS_FILE_PATH +// +// `GCS_FILE_PATH` is the Google Cloud Storage location of a text file. +// Supported file extensions: .TXT, .PDF, .TIF, .TIFF +// +// Text files can be no larger than 128kB in size. +// +// Sample rows: +// +// gs://folder/text1.txt +// gs://folder/text2.pdf +// gs://folder/text3.tif +// +//
          Entity Extraction
          +// +// One or more JSONL (JSON Lines) files that either provide inline text or +// documents. You can only use one format, either inline text or documents, +// for a single call to [AutoMl.BatchPredict]. +// +// Each JSONL file contains a per line a proto that +// wraps a temporary user-assigned TextSnippet ID (string up to 2000 +// characters long) called "id", a TextSnippet proto (in +// JSON representation) and zero or more TextFeature protos. Any given +// text snippet content must have 30,000 characters or less, and also +// be UTF-8 NFC encoded (ASCII already is). The IDs provided should be +// unique. +// +// Each document JSONL file contains, per line, a proto that wraps a Document +// proto with `input_config` set. Each document cannot exceed 2MB in size. +// +// Supported document extensions: .PDF, .TIF, .TIFF +// +// Each JSONL file must not exceed 100MB in size, and no more than 20 +// JSONL files may be passed. +// +// Sample inline JSONL file (Shown with artificial line +// breaks. Actual line breaks are denoted by "\n".): +// +// { +// "id": "my_first_id", +// "text_snippet": { "content": "dog car cat"}, +// "text_features": [ +// { +// "text_segment": {"start_offset": 4, "end_offset": 6}, +// "structural_type": PARAGRAPH, +// "bounding_poly": { +// "normalized_vertices": [ +// {"x": 0.1, "y": 0.1}, +// {"x": 0.1, "y": 0.3}, +// {"x": 0.3, "y": 0.3}, +// {"x": 0.3, "y": 0.1}, +// ] +// }, +// } +// ], +// }\n +// { +// "id": "2", +// "text_snippet": { +// "content": "Extended sample content", +// "mime_type": "text/plain" +// } +// } +// +// Sample document JSONL file (Shown with artificial line +// breaks. Actual line breaks are denoted by "\n".): +// +// { +// "document": { +// "input_config": { +// "gcs_source": { "input_uris": [ "gs://folder/document1.pdf" ] +// } +// } +// } +// }\n +// { +// "document": { +// "input_config": { +// "gcs_source": { "input_uris": [ "gs://folder/document2.tif" ] +// } +// } +// } +// } +//
          +//
          +// +//

          AutoML Tables

          +// +// See [Preparing your training +// data](https://cloud.google.com/automl-tables/docs/predict-batch) for more +// information. +// +// You can use either +// [gcs_source][google.cloud.automl.v1.BatchPredictInputConfig.gcs_source] +// or +// [bigquery_source][BatchPredictInputConfig.bigquery_source]. +// +// **For gcs_source:** +// +// CSV file(s), each by itself 10GB or smaller and total size must be +// 100GB or smaller, where first file must have a header containing +// column names. If the first row of a subsequent file is the same as +// the header, then it is also treated as a header. All other rows +// contain values for the corresponding columns. +// +// The column names must contain the model's +// +// [input_feature_column_specs'][google.cloud.automl.v1.TablesModelMetadata.input_feature_column_specs] +// [display_name-s][google.cloud.automl.v1.ColumnSpec.display_name] +// (order doesn't matter). The columns corresponding to the model's +// input feature column specs must contain values compatible with the +// column spec's data types. Prediction on all the rows, i.e. the CSV +// lines, will be attempted. +// +// +// Sample rows from a CSV file: +// 
          +// "First Name","Last Name","Dob","Addresses"
+//
+// "John","Doe","1968-01-22","[{"status":"current","address":"123_First_Avenue","city":"Seattle","state":"WA","zip":"11111","numberOfYears":"1"},{"status":"previous","address":"456_Main_Street","city":"Portland","state":"OR","zip":"22222","numberOfYears":"5"}]"
+//
+// "Jane","Doe","1980-10-16","[{"status":"current","address":"789_Any_Avenue","city":"Albany","state":"NY","zip":"33333","numberOfYears":"2"},{"status":"previous","address":"321_Main_Street","city":"Hoboken","state":"NJ","zip":"44444","numberOfYears":"3"}]}
+//
          +// **For bigquery_source:** +// +// The URI of a BigQuery table. The user data size of the BigQuery +// table must be 100GB or smaller. +// +// The column names must contain the model's +// +// [input_feature_column_specs'][google.cloud.automl.v1.TablesModelMetadata.input_feature_column_specs] +// [display_name-s][google.cloud.automl.v1.ColumnSpec.display_name] +// (order doesn't matter). The columns corresponding to the model's +// input feature column specs must contain values compatible with the +// column spec's data types. Prediction on all the rows of the table +// will be attempted. +//
          +//
          +// +// **Input field definitions:** +// +// `GCS_FILE_PATH` +// : The path to a file on Google Cloud Storage. For example, +// "gs://folder/video.avi". +// +// `TIME_SEGMENT_START` +// : (`TIME_OFFSET`) +// Expresses a beginning, inclusive, of a time segment +// within an example that has a time dimension +// (e.g. video). +// +// `TIME_SEGMENT_END` +// : (`TIME_OFFSET`) +// Expresses an end, exclusive, of a time segment within +// n example that has a time dimension (e.g. video). +// +// `TIME_OFFSET` +// : A number of seconds as measured from the start of an +// example (e.g. video). Fractions are allowed, up to a +// microsecond precision. "inf" is allowed, and it means the end +// of the example. +// +// **Errors:** +// +// If any of the provided CSV files can't be parsed or if more than certain +// percent of CSV rows cannot be processed then the operation fails and +// prediction does not happen. Regardless of overall success or failure the +// per-row failures, up to a certain count cap, will be listed in +// Operation.metadata.partial_failures. +message BatchPredictInputConfig { + // The source of the input. + oneof source { + // Required. The Google Cloud Storage location for the input content. + GcsSource gcs_source = 1 [(google.api.field_behavior) = REQUIRED]; + } +} + +// Input configuration of a [Document][google.cloud.automl.v1.Document]. +message DocumentInputConfig { + // The Google Cloud Storage location of the document file. Only a single path + // should be given. + // + // Max supported size: 512MB. + // + // Supported extensions: .PDF. + GcsSource gcs_source = 1; +} + +// * For Translation: +// CSV file `translation.csv`, with each line in format: +// ML_USE,GCS_FILE_PATH +// GCS_FILE_PATH leads to a .TSV file which describes examples that have +// given ML_USE, using the following row format per line: +// TEXT_SNIPPET (in source language) \t TEXT_SNIPPET (in target +// language) +// +// * For Tables: +// Output depends on whether the dataset was imported from Google Cloud +// Storage or BigQuery. +// Google Cloud Storage case: +// +// [gcs_destination][google.cloud.automl.v1p1beta.OutputConfig.gcs_destination] +// must be set. Exported are CSV file(s) `tables_1.csv`, +// `tables_2.csv`,...,`tables_N.csv` with each having as header line +// the table's column names, and all other lines contain values for +// the header columns. +// BigQuery case: +// +// [bigquery_destination][google.cloud.automl.v1p1beta.OutputConfig.bigquery_destination] +// pointing to a BigQuery project must be set. In the given project a +// new dataset will be created with name +// +// `export_data__` +// where will be made +// BigQuery-dataset-name compatible (e.g. most special characters will +// become underscores), and timestamp will be in +// YYYY_MM_DDThh_mm_ss_sssZ "based on ISO-8601" format. In that +// dataset a new table called `primary_table` will be created, and +// filled with precisely the same data as this obtained on import. +message OutputConfig { + // The destination of the output. + oneof destination { + // Required. The Google Cloud Storage location where the output is to be written to. + // For Image Object Detection, Text Extraction, Video Classification and + // Tables, in the given directory a new directory will be created with name: + // export_data-- where + // timestamp is in YYYY-MM-DDThh:mm:ss.sssZ ISO-8601 format. All export + // output will be written into that directory. + GcsDestination gcs_destination = 1 [(google.api.field_behavior) = REQUIRED]; + } +} + +// Output configuration for BatchPredict Action. +// +// As destination the +// +// [gcs_destination][google.cloud.automl.v1.BatchPredictOutputConfig.gcs_destination] +// must be set unless specified otherwise for a domain. If gcs_destination is +// set then in the given directory a new directory is created. Its name +// will be +// "prediction--", +// where timestamp is in YYYY-MM-DDThh:mm:ss.sssZ ISO-8601 format. The contents +// of it depends on the ML problem the predictions are made for. +// +// * For Image Classification: +// In the created directory files `image_classification_1.jsonl`, +// `image_classification_2.jsonl`,...,`image_classification_N.jsonl` +// will be created, where N may be 1, and depends on the +// total number of the successfully predicted images and annotations. +// A single image will be listed only once with all its annotations, +// and its annotations will never be split across files. +// Each .JSONL file will contain, per line, a JSON representation of a +// proto that wraps image's "ID" : "" followed by a list of +// zero or more AnnotationPayload protos (called annotations), which +// have classification detail populated. +// If prediction for any image failed (partially or completely), then an +// additional `errors_1.jsonl`, `errors_2.jsonl`,..., `errors_N.jsonl` +// files will be created (N depends on total number of failed +// predictions). These files will have a JSON representation of a proto +// that wraps the same "ID" : "" but here followed by +// exactly one +// +// [`google.rpc.Status`](https: +// //github.com/googleapis/googleapis/blob/master/google/rpc/status.proto) +// containing only `code` and `message`fields. +// +// * For Image Object Detection: +// In the created directory files `image_object_detection_1.jsonl`, +// `image_object_detection_2.jsonl`,...,`image_object_detection_N.jsonl` +// will be created, where N may be 1, and depends on the +// total number of the successfully predicted images and annotations. +// Each .JSONL file will contain, per line, a JSON representation of a +// proto that wraps image's "ID" : "" followed by a list of +// zero or more AnnotationPayload protos (called annotations), which +// have image_object_detection detail populated. A single image will +// be listed only once with all its annotations, and its annotations +// will never be split across files. +// If prediction for any image failed (partially or completely), then +// additional `errors_1.jsonl`, `errors_2.jsonl`,..., `errors_N.jsonl` +// files will be created (N depends on total number of failed +// predictions). These files will have a JSON representation of a proto +// that wraps the same "ID" : "" but here followed by +// exactly one +// +// [`google.rpc.Status`](https: +// //github.com/googleapis/googleapis/blob/master/google/rpc/status.proto) +// containing only `code` and `message`fields. +// * For Video Classification: +// In the created directory a video_classification.csv file, and a .JSON +// file per each video classification requested in the input (i.e. each +// line in given CSV(s)), will be created. +// +// The format of video_classification.csv is: +// +// GCS_FILE_PATH,TIME_SEGMENT_START,TIME_SEGMENT_END,JSON_FILE_NAME,STATUS +// where: +// GCS_FILE_PATH,TIME_SEGMENT_START,TIME_SEGMENT_END = matches 1 to 1 +// the prediction input lines (i.e. video_classification.csv has +// precisely the same number of lines as the prediction input had.) +// JSON_FILE_NAME = Name of .JSON file in the output directory, which +// contains prediction responses for the video time segment. +// STATUS = "OK" if prediction completed successfully, or an error code +// with message otherwise. If STATUS is not "OK" then the .JSON file +// for that line may not exist or be empty. +// +// Each .JSON file, assuming STATUS is "OK", will contain a list of +// AnnotationPayload protos in JSON format, which are the predictions +// for the video time segment the file is assigned to in the +// video_classification.csv. All AnnotationPayload protos will have +// video_classification field set, and will be sorted by +// video_classification.type field (note that the returned types are +// governed by `classifaction_types` parameter in +// [PredictService.BatchPredictRequest.params][]). +// +// * For Video Object Tracking: +// In the created directory a video_object_tracking.csv file will be +// created, and multiple files video_object_trackinng_1.json, +// video_object_trackinng_2.json,..., video_object_trackinng_N.json, +// where N is the number of requests in the input (i.e. the number of +// lines in given CSV(s)). +// +// The format of video_object_tracking.csv is: +// +// GCS_FILE_PATH,TIME_SEGMENT_START,TIME_SEGMENT_END,JSON_FILE_NAME,STATUS +// where: +// GCS_FILE_PATH,TIME_SEGMENT_START,TIME_SEGMENT_END = matches 1 to 1 +// the prediction input lines (i.e. video_object_tracking.csv has +// precisely the same number of lines as the prediction input had.) +// JSON_FILE_NAME = Name of .JSON file in the output directory, which +// contains prediction responses for the video time segment. +// STATUS = "OK" if prediction completed successfully, or an error +// code with message otherwise. If STATUS is not "OK" then the .JSON +// file for that line may not exist or be empty. +// +// Each .JSON file, assuming STATUS is "OK", will contain a list of +// AnnotationPayload protos in JSON format, which are the predictions +// for each frame of the video time segment the file is assigned to in +// video_object_tracking.csv. All AnnotationPayload protos will have +// video_object_tracking field set. +// * For Text Classification: +// In the created directory files `text_classification_1.jsonl`, +// `text_classification_2.jsonl`,...,`text_classification_N.jsonl` +// will be created, where N may be 1, and depends on the +// total number of inputs and annotations found. +// +// Each .JSONL file will contain, per line, a JSON representation of a +// proto that wraps input text file (or document) in +// the text snippet (or document) proto and a list of +// zero or more AnnotationPayload protos (called annotations), which +// have classification detail populated. A single text file (or +// document) will be listed only once with all its annotations, and its +// annotations will never be split across files. +// +// If prediction for any input file (or document) failed (partially or +// completely), then additional `errors_1.jsonl`, `errors_2.jsonl`,..., +// `errors_N.jsonl` files will be created (N depends on total number of +// failed predictions). These files will have a JSON representation of a +// proto that wraps input file followed by exactly one +// +// [`google.rpc.Status`](https: +// //github.com/googleapis/googleapis/blob/master/google/rpc/status.proto) +// containing only `code` and `message`. +// +// * For Text Sentiment: +// In the created directory files `text_sentiment_1.jsonl`, +// `text_sentiment_2.jsonl`,...,`text_sentiment_N.jsonl` +// will be created, where N may be 1, and depends on the +// total number of inputs and annotations found. +// +// Each .JSONL file will contain, per line, a JSON representation of a +// proto that wraps input text file (or document) in +// the text snippet (or document) proto and a list of +// zero or more AnnotationPayload protos (called annotations), which +// have text_sentiment detail populated. A single text file (or +// document) will be listed only once with all its annotations, and its +// annotations will never be split across files. +// +// If prediction for any input file (or document) failed (partially or +// completely), then additional `errors_1.jsonl`, `errors_2.jsonl`,..., +// `errors_N.jsonl` files will be created (N depends on total number of +// failed predictions). These files will have a JSON representation of a +// proto that wraps input file followed by exactly one +// +// [`google.rpc.Status`](https: +// //github.com/googleapis/googleapis/blob/master/google/rpc/status.proto) +// containing only `code` and `message`. +// +// * For Text Extraction: +// In the created directory files `text_extraction_1.jsonl`, +// `text_extraction_2.jsonl`,...,`text_extraction_N.jsonl` +// will be created, where N may be 1, and depends on the +// total number of inputs and annotations found. +// The contents of these .JSONL file(s) depend on whether the input +// used inline text, or documents. +// If input was inline, then each .JSONL file will contain, per line, +// a JSON representation of a proto that wraps given in request text +// snippet's "id" (if specified), followed by input text snippet, +// and a list of zero or more +// AnnotationPayload protos (called annotations), which have +// text_extraction detail populated. A single text snippet will be +// listed only once with all its annotations, and its annotations will +// never be split across files. +// If input used documents, then each .JSONL file will contain, per +// line, a JSON representation of a proto that wraps given in request +// document proto, followed by its OCR-ed representation in the form +// of a text snippet, finally followed by a list of zero or more +// AnnotationPayload protos (called annotations), which have +// text_extraction detail populated and refer, via their indices, to +// the OCR-ed text snippet. A single document (and its text snippet) +// will be listed only once with all its annotations, and its +// annotations will never be split across files. +// If prediction for any text snippet failed (partially or completely), +// then additional `errors_1.jsonl`, `errors_2.jsonl`,..., +// `errors_N.jsonl` files will be created (N depends on total number of +// failed predictions). These files will have a JSON representation of a +// proto that wraps either the "id" : "" (in case of inline) +// or the document proto (in case of document) but here followed by +// exactly one +// +// [`google.rpc.Status`](https: +// //github.com/googleapis/googleapis/blob/master/google/rpc/status.proto) +// containing only `code` and `message`. +// +// * For Tables: +// Output depends on whether +// +// [gcs_destination][google.cloud.automl.v1p1beta.BatchPredictOutputConfig.gcs_destination] +// or +// +// [bigquery_destination][google.cloud.automl.v1p1beta.BatchPredictOutputConfig.bigquery_destination] +// is set (either is allowed). +// Google Cloud Storage case: +// In the created directory files `tables_1.csv`, `tables_2.csv`,..., +// `tables_N.csv` will be created, where N may be 1, and depends on +// the total number of the successfully predicted rows. +// For all CLASSIFICATION +// +// [prediction_type-s][google.cloud.automl.v1p1beta.TablesModelMetadata.prediction_type]: +// Each .csv file will contain a header, listing all columns' +// +// [display_name-s][google.cloud.automl.v1p1beta.ColumnSpec.display_name] +// given on input followed by M target column names in the format of +// +// "<[target_column_specs][google.cloud.automl.v1p1beta.TablesModelMetadata.target_column_spec] +// +// [display_name][google.cloud.automl.v1p1beta.ColumnSpec.display_name]>__score" where M is the number of distinct target values, +// i.e. number of distinct values in the target column of the table +// used to train the model. Subsequent lines will contain the +// respective values of successfully predicted rows, with the last, +// i.e. the target, columns having the corresponding prediction +// [scores][google.cloud.automl.v1p1beta.TablesAnnotation.score]. +// For REGRESSION and FORECASTING +// +// [prediction_type-s][google.cloud.automl.v1p1beta.TablesModelMetadata.prediction_type]: +// Each .csv file will contain a header, listing all columns' +// [display_name-s][google.cloud.automl.v1p1beta.display_name] +// given on input followed by the predicted target column with name +// in the format of +// +// "predicted_<[target_column_specs][google.cloud.automl.v1p1beta.TablesModelMetadata.target_column_spec] +// +// [display_name][google.cloud.automl.v1p1beta.ColumnSpec.display_name]>" +// Subsequent lines will contain the respective values of +// successfully predicted rows, with the last, i.e. the target, +// column having the predicted target value. +// If prediction for any rows failed, then an additional +// `errors_1.csv`, `errors_2.csv`,..., `errors_N.csv` will be +// created (N depends on total number of failed rows). These files +// will have analogous format as `tables_*.csv`, but always with a +// single target column having +// +// [`google.rpc.Status`](https: +// //github.com/googleapis/googleapis/blob/master/google/rpc/status.proto) +// represented as a JSON string, and containing only `code` and +// `message`. +// BigQuery case: +// +// [bigquery_destination][google.cloud.automl.v1p1beta.OutputConfig.bigquery_destination] +// pointing to a BigQuery project must be set. In the given project a +// new dataset will be created with name +// `prediction__` +// where will be made +// BigQuery-dataset-name compatible (e.g. most special characters will +// become underscores), and timestamp will be in +// YYYY_MM_DDThh_mm_ss_sssZ "based on ISO-8601" format. In the dataset +// two tables will be created, `predictions`, and `errors`. +// The `predictions` table's column names will be the input columns' +// +// [display_name-s][google.cloud.automl.v1p1beta.ColumnSpec.display_name] +// followed by the target column with name in the format of +// +// "predicted_<[target_column_specs][google.cloud.automl.v1p1beta.TablesModelMetadata.target_column_spec] +// +// [display_name][google.cloud.automl.v1p1beta.ColumnSpec.display_name]>" +// The input feature columns will contain the respective values of +// successfully predicted rows, with the target column having an +// ARRAY of +// +// [AnnotationPayloads][google.cloud.automl.v1p1beta.AnnotationPayload], +// represented as STRUCT-s, containing +// [TablesAnnotation][google.cloud.automl.v1p1beta.TablesAnnotation]. +// The `errors` table contains rows for which the prediction has +// failed, it has analogous input columns while the target column name +// is in the format of +// +// "errors_<[target_column_specs][google.cloud.automl.v1p1beta.TablesModelMetadata.target_column_spec] +// +// [display_name][google.cloud.automl.v1p1beta.ColumnSpec.display_name]>", +// and as a value has +// +// [`google.rpc.Status`](https: +// //github.com/googleapis/googleapis/blob/master/google/rpc/status.proto) +// represented as a STRUCT, and containing only `code` and `message`. +message BatchPredictOutputConfig { + // The destination of the output. + oneof destination { + // Required. The Google Cloud Storage location of the directory where the output is to + // be written to. + GcsDestination gcs_destination = 1 [(google.api.field_behavior) = REQUIRED]; + } +} + +// Output configuration for ModelExport Action. +message ModelExportOutputConfig { + // The destination of the output. + oneof destination { + // Required. The Google Cloud Storage location where the model is to be written to. + // This location may only be set for the following model formats: + // "tflite", "edgetpu_tflite", "tf_saved_model", "tf_js", "core_ml". + // + // Under the directory given as the destination a new one with name + // "model-export--", + // where timestamp is in YYYY-MM-DDThh:mm:ss.sssZ ISO-8601 format, + // will be created. Inside the model and any of its supporting files + // will be written. + GcsDestination gcs_destination = 1 [(google.api.field_behavior) = REQUIRED]; + } + + // The format in which the model must be exported. The available, and default, + // formats depend on the problem and model type (if given problem and type + // combination doesn't have a format listed, it means its models are not + // exportable): + // + // * For Image Classification mobile-low-latency-1, mobile-versatile-1, + // mobile-high-accuracy-1: + // "tflite" (default), "edgetpu_tflite", "tf_saved_model", "tf_js", + // "docker". + // + // * For Image Classification mobile-core-ml-low-latency-1, + // mobile-core-ml-versatile-1, mobile-core-ml-high-accuracy-1: + // "core_ml" (default). + // + // * For Image Object Detection mobile-low-latency-1, mobile-versatile-1, + // mobile-high-accuracy-1: + // "tflite", "tf_saved_model", "tf_js". + // Formats description: + // + // * tflite - Used for Android mobile devices. + // * edgetpu_tflite - Used for [Edge TPU](https://cloud.google.com/edge-tpu/) + // devices. + // * tf_saved_model - A tensorflow model in SavedModel format. + // * tf_js - A [TensorFlow.js](https://www.tensorflow.org/js) model that can + // be used in the browser and in Node.js using JavaScript. + // * docker - Used for Docker containers. Use the params field to customize + // the container. The container is verified to work correctly on + // ubuntu 16.04 operating system. See more at + // [containers + // + // quickstart](https: + // //cloud.google.com/vision/automl/docs/containers-gcs-quickstart) + // * core_ml - Used for iOS mobile devices. + string model_format = 4; + + // Additional model-type and format specific parameters describing the + // requirements for the to be exported model files, any string must be up to + // 25000 characters long. + // + // * For `docker` format: + // `cpu_architecture` - (string) "x86_64" (default). + // `gpu_architecture` - (string) "none" (default), "nvidia". + map params = 2; +} + +// The Google Cloud Storage location for the input content. +message GcsSource { + // Required. Google Cloud Storage URIs to input files, up to 2000 + // characters long. Accepted forms: + // * Full object path, e.g. gs://bucket/directory/object.csv + repeated string input_uris = 1 [(google.api.field_behavior) = REQUIRED]; +} + +// The Google Cloud Storage location where the output is to be written to. +message GcsDestination { + // Required. Google Cloud Storage URI to output directory, up to 2000 + // characters long. + // Accepted forms: + // * Prefix path: gs://bucket/directory + // The requesting user must have write permission to the bucket. + // The directory is created if it doesn't exist. + string output_uri_prefix = 1 [(google.api.field_behavior) = REQUIRED]; +} diff --git a/third_party/googleapis/google/cloud/automl/v1/model.proto b/third_party/googleapis/google/cloud/automl/v1/model.proto new file mode 100644 index 000000000..f53689377 --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1/model.proto @@ -0,0 +1,112 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.automl.v1; + +import "google/api/resource.proto"; +import "google/cloud/automl/v1/image.proto"; +import "google/cloud/automl/v1/text.proto"; +import "google/cloud/automl/v1/translation.proto"; +import "google/protobuf/timestamp.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Cloud.AutoML.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1;automl"; +option java_multiple_files = true; +option java_package = "com.google.cloud.automl.v1"; +option php_namespace = "Google\\Cloud\\AutoMl\\V1"; +option ruby_package = "Google::Cloud::AutoML::V1"; + +// API proto representing a trained machine learning model. +message Model { + option (google.api.resource) = { + type: "automl.googleapis.com/Model" + pattern: "projects/{project}/locations/{location}/models/{model}" + }; + + // Deployment state of the model. + enum DeploymentState { + // Should not be used, an un-set enum has this value by default. + DEPLOYMENT_STATE_UNSPECIFIED = 0; + + // Model is deployed. + DEPLOYED = 1; + + // Model is not deployed. + UNDEPLOYED = 2; + } + + // Required. + // The model metadata that is specific to the problem type. + // Must match the metadata type of the dataset used to train the model. + oneof model_metadata { + // Metadata for translation models. + TranslationModelMetadata translation_model_metadata = 15; + + // Metadata for image classification models. + ImageClassificationModelMetadata image_classification_model_metadata = 13; + + // Metadata for text classification models. + TextClassificationModelMetadata text_classification_model_metadata = 14; + + // Metadata for image object detection models. + ImageObjectDetectionModelMetadata image_object_detection_model_metadata = 20; + + // Metadata for text extraction models. + TextExtractionModelMetadata text_extraction_model_metadata = 19; + + // Metadata for text sentiment models. + TextSentimentModelMetadata text_sentiment_model_metadata = 22; + } + + // Output only. Resource name of the model. + // Format: `projects/{project_id}/locations/{location_id}/models/{model_id}` + string name = 1; + + // Required. The name of the model to show in the interface. The name can be + // up to 32 characters long and can consist only of ASCII Latin letters A-Z + // and a-z, underscores + // (_), and ASCII digits 0-9. It must start with a letter. + string display_name = 2; + + // Required. The resource ID of the dataset used to create the model. The dataset must + // come from the same ancestor project and location. + string dataset_id = 3; + + // Output only. Timestamp when the model training finished and can be used for prediction. + google.protobuf.Timestamp create_time = 7; + + // Output only. Timestamp when this model was last updated. + google.protobuf.Timestamp update_time = 11; + + // Output only. Deployment state of the model. A model can only serve + // prediction requests after it gets deployed. + DeploymentState deployment_state = 8; + + // Used to perform a consistent read-modify-write updates. If not set, a blind + // "overwrite" update happens. + string etag = 10; + + // Optional. The labels with user-defined metadata to organize your model. + // + // Label keys and values can be no longer than 64 characters + // (Unicode codepoints), can only contain lowercase letters, numeric + // characters, underscores and dashes. International characters are allowed. + // Label values are optional. Label keys must start with a letter. + // + // See https://goo.gl/xmQnxf for more information on and examples of labels. + map labels = 34; +} diff --git a/third_party/googleapis/google/cloud/automl/v1/model_evaluation.proto b/third_party/googleapis/google/cloud/automl/v1/model_evaluation.proto new file mode 100644 index 000000000..601389f7a --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1/model_evaluation.proto @@ -0,0 +1,106 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.automl.v1; + +import "google/api/resource.proto"; +import "google/cloud/automl/v1/classification.proto"; +import "google/cloud/automl/v1/detection.proto"; +import "google/cloud/automl/v1/text_extraction.proto"; +import "google/cloud/automl/v1/text_sentiment.proto"; +import "google/cloud/automl/v1/translation.proto"; +import "google/protobuf/timestamp.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Cloud.AutoML.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1;automl"; +option java_multiple_files = true; +option java_package = "com.google.cloud.automl.v1"; +option php_namespace = "Google\\Cloud\\AutoMl\\V1"; +option ruby_package = "Google::Cloud::AutoML::V1"; + +// Evaluation results of a model. +message ModelEvaluation { + option (google.api.resource) = { + type: "automl.googleapis.com/ModelEvaluation" + pattern: "projects/{project}/locations/{location}/models/{model}/modelEvaluations/{model_evaluation}" + }; + + // Output only. Problem type specific evaluation metrics. + oneof metrics { + // Model evaluation metrics for image, text, video and tables + // classification. + // Tables problem is considered a classification when the target column + // is CATEGORY DataType. + ClassificationEvaluationMetrics classification_evaluation_metrics = 8; + + // Model evaluation metrics for translation. + TranslationEvaluationMetrics translation_evaluation_metrics = 9; + + // Model evaluation metrics for image object detection. + ImageObjectDetectionEvaluationMetrics image_object_detection_evaluation_metrics = 12; + + // Evaluation metrics for text sentiment models. + TextSentimentEvaluationMetrics text_sentiment_evaluation_metrics = 11; + + // Evaluation metrics for text extraction models. + TextExtractionEvaluationMetrics text_extraction_evaluation_metrics = 13; + } + + // Output only. Resource name of the model evaluation. + // Format: + // + // `projects/{project_id}/locations/{location_id}/models/{model_id}/modelEvaluations/{model_evaluation_id}` + string name = 1; + + // Output only. The ID of the annotation spec that the model evaluation applies to. The + // The ID is empty for the overall model evaluation. + // For Tables annotation specs in the dataset do not exist and this ID is + // always not set, but for CLASSIFICATION + // + // [prediction_type-s][google.cloud.automl.v1.TablesModelMetadata.prediction_type] + // the + // [display_name][google.cloud.automl.v1.ModelEvaluation.display_name] + // field is used. + string annotation_spec_id = 2; + + // Output only. The value of + // [display_name][google.cloud.automl.v1.AnnotationSpec.display_name] + // at the moment when the model was trained. Because this field returns a + // value at model training time, for different models trained from the same + // dataset, the values may differ, since display names could had been changed + // between the two model's trainings. For Tables CLASSIFICATION + // + // [prediction_type-s][google.cloud.automl.v1.TablesModelMetadata.prediction_type] + // distinct values of the target column at the moment of the model evaluation + // are populated here. + // The display_name is empty for the overall model evaluation. + string display_name = 15; + + // Output only. Timestamp when this model evaluation was created. + google.protobuf.Timestamp create_time = 5; + + // Output only. The number of examples used for model evaluation, i.e. for + // which ground truth from time of model creation is compared against the + // predicted annotations created by the model. + // For overall ModelEvaluation (i.e. with annotation_spec_id not set) this is + // the total number of all examples used for evaluation. + // Otherwise, this is the count of examples that according to the ground + // truth were annotated by the + // + // [annotation_spec_id][google.cloud.automl.v1.ModelEvaluation.annotation_spec_id]. + int32 evaluated_example_count = 6; +} diff --git a/third_party/googleapis/google/cloud/automl/v1/operations.proto b/third_party/googleapis/google/cloud/automl/v1/operations.proto new file mode 100644 index 000000000..d6a998708 --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1/operations.proto @@ -0,0 +1,167 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.automl.v1; + +import "google/cloud/automl/v1/dataset.proto"; +import "google/cloud/automl/v1/io.proto"; +import "google/protobuf/timestamp.proto"; +import "google/rpc/status.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Cloud.AutoML.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1;automl"; +option java_multiple_files = true; +option java_package = "com.google.cloud.automl.v1"; +option php_namespace = "Google\\Cloud\\AutoMl\\V1"; +option ruby_package = "Google::Cloud::AutoML::V1"; + +// Metadata used across all long running operations returned by AutoML API. +message OperationMetadata { + // Ouptut only. Details of specific operation. Even if this field is empty, + // the presence allows to distinguish different types of operations. + oneof details { + // Details of a Delete operation. + DeleteOperationMetadata delete_details = 8; + + // Details of a DeployModel operation. + DeployModelOperationMetadata deploy_model_details = 24; + + // Details of an UndeployModel operation. + UndeployModelOperationMetadata undeploy_model_details = 25; + + // Details of CreateModel operation. + CreateModelOperationMetadata create_model_details = 10; + + // Details of CreateDataset operation. + CreateDatasetOperationMetadata create_dataset_details = 30; + + // Details of ImportData operation. + ImportDataOperationMetadata import_data_details = 15; + + // Details of BatchPredict operation. + BatchPredictOperationMetadata batch_predict_details = 16; + + // Details of ExportData operation. + ExportDataOperationMetadata export_data_details = 21; + + // Details of ExportModel operation. + ExportModelOperationMetadata export_model_details = 22; + } + + // Output only. Progress of operation. Range: [0, 100]. + // Not used currently. + int32 progress_percent = 13; + + // Output only. Partial failures encountered. + // E.g. single files that couldn't be read. + // This field should never exceed 20 entries. + // Status details field will contain standard GCP error details. + repeated google.rpc.Status partial_failures = 2; + + // Output only. Time when the operation was created. + google.protobuf.Timestamp create_time = 3; + + // Output only. Time when the operation was updated for the last time. + google.protobuf.Timestamp update_time = 4; +} + +// Details of operations that perform deletes of any entities. +message DeleteOperationMetadata { + +} + +// Details of DeployModel operation. +message DeployModelOperationMetadata { + +} + +// Details of UndeployModel operation. +message UndeployModelOperationMetadata { + +} + +// Details of CreateDataset operation. +message CreateDatasetOperationMetadata { + +} + +// Details of CreateModel operation. +message CreateModelOperationMetadata { + +} + +// Details of ImportData operation. +message ImportDataOperationMetadata { + +} + +// Details of ExportData operation. +message ExportDataOperationMetadata { + // Further describes this export data's output. + // Supplements + // [OutputConfig][google.cloud.automl.v1.OutputConfig]. + message ExportDataOutputInfo { + // The output location to which the exported data is written. + oneof output_location { + // The full path of the Google Cloud Storage directory created, into which + // the exported data is written. + string gcs_output_directory = 1; + } + } + + // Output only. Information further describing this export data's output. + ExportDataOutputInfo output_info = 1; +} + +// Details of BatchPredict operation. +message BatchPredictOperationMetadata { + // Further describes this batch predict's output. + // Supplements + // + // [BatchPredictOutputConfig][google.cloud.automl.v1.BatchPredictOutputConfig]. + message BatchPredictOutputInfo { + // The output location into which prediction output is written. + oneof output_location { + // The full path of the Google Cloud Storage directory created, into which + // the prediction output is written. + string gcs_output_directory = 1; + } + } + + // Output only. The input config that was given upon starting this + // batch predict operation. + BatchPredictInputConfig input_config = 1; + + // Output only. Information further describing this batch predict's output. + BatchPredictOutputInfo output_info = 2; +} + +// Details of ExportModel operation. +message ExportModelOperationMetadata { + // Further describes the output of model export. + // Supplements + // [ModelExportOutputConfig][google.cloud.automl.v1.ModelExportOutputConfig]. + message ExportModelOutputInfo { + // The full path of the Google Cloud Storage directory created, into which + // the model will be exported. + string gcs_output_directory = 1; + } + + // Output only. Information further describing the output of this model + // export. + ExportModelOutputInfo output_info = 2; +} diff --git a/third_party/googleapis/google/cloud/automl/v1/prediction_service.proto b/third_party/googleapis/google/cloud/automl/v1/prediction_service.proto new file mode 100644 index 000000000..b7b69cc2b --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1/prediction_service.proto @@ -0,0 +1,323 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.automl.v1; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/cloud/automl/v1/annotation_payload.proto"; +import "google/cloud/automl/v1/data_items.proto"; +import "google/cloud/automl/v1/io.proto"; +import "google/cloud/automl/v1/operations.proto"; +import "google/longrunning/operations.proto"; + +option csharp_namespace = "Google.Cloud.AutoML.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1;automl"; +option java_multiple_files = true; +option java_outer_classname = "PredictionServiceProto"; +option java_package = "com.google.cloud.automl.v1"; +option php_namespace = "Google\\Cloud\\AutoMl\\V1"; +option ruby_package = "Google::Cloud::AutoML::V1"; + +// AutoML Prediction API. +// +// On any input that is documented to expect a string parameter in +// snake_case or kebab-case, either of those cases is accepted. +service PredictionService { + option (google.api.default_host) = "automl.googleapis.com"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; + + // Perform an online prediction. The prediction result is directly + // returned in the response. + // Available for following ML scenarios, and their expected request payloads: + // + // AutoML Vision Classification + // + // * An image in .JPEG, .GIF or .PNG format, image_bytes up to 30MB. + // + // AutoML Vision Object Detection + // + // * An image in .JPEG, .GIF or .PNG format, image_bytes up to 30MB. + // + // AutoML Natural Language Classification + // + // * A TextSnippet up to 60,000 characters, UTF-8 encoded or a document in + // .PDF, .TIF or .TIFF format with size upto 2MB. + // + // AutoML Natural Language Entity Extraction + // + // * A TextSnippet up to 10,000 characters, UTF-8 NFC encoded or a document + // in .PDF, .TIF or .TIFF format with size upto 20MB. + // + // AutoML Natural Language Sentiment Analysis + // + // * A TextSnippet up to 60,000 characters, UTF-8 encoded or a document in + // .PDF, .TIF or .TIFF format with size upto 2MB. + // + // AutoML Translation + // + // * A TextSnippet up to 25,000 characters, UTF-8 encoded. + // + // AutoML Tables + // + // * A row with column values matching + // the columns of the model, up to 5MB. Not available for FORECASTING + // `prediction_type`. + rpc Predict(PredictRequest) returns (PredictResponse) { + option (google.api.http) = { + post: "/v1/{name=projects/*/locations/*/models/*}:predict" + body: "*" + }; + option (google.api.method_signature) = "name,payload,params"; + } + + // Perform a batch prediction. Unlike the online [Predict][google.cloud.automl.v1.PredictionService.Predict], batch + // prediction result won't be immediately available in the response. Instead, + // a long running operation object is returned. User can poll the operation + // result via [GetOperation][google.longrunning.Operations.GetOperation] + // method. Once the operation is done, [BatchPredictResult][google.cloud.automl.v1.BatchPredictResult] is returned in + // the [response][google.longrunning.Operation.response] field. + // Available for following ML scenarios: + // + // * AutoML Vision Classification + // * AutoML Vision Object Detection + // * AutoML Video Intelligence Classification + // * AutoML Video Intelligence Object Tracking * AutoML Natural Language Classification + // * AutoML Natural Language Entity Extraction + // * AutoML Natural Language Sentiment Analysis + // * AutoML Tables + rpc BatchPredict(BatchPredictRequest) returns (google.longrunning.Operation) { + option (google.api.http) = { + post: "/v1/{name=projects/*/locations/*/models/*}:batchPredict" + body: "*" + }; + option (google.api.method_signature) = "name,input_config,output_config,params"; + option (google.longrunning.operation_info) = { + response_type: "BatchPredictResult" + metadata_type: "OperationMetadata" + }; + } +} + +// Request message for [PredictionService.Predict][google.cloud.automl.v1.PredictionService.Predict]. +message PredictRequest { + // Required. Name of the model requested to serve the prediction. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Model" + } + ]; + + // Required. Payload to perform a prediction on. The payload must match the + // problem type that the model was trained to solve. + ExamplePayload payload = 2 [(google.api.field_behavior) = REQUIRED]; + + // Additional domain-specific parameters, any string must be up to 25000 + // characters long. + // + // AutoML Vision Classification + // + // `score_threshold` + // : (float) A value from 0.0 to 1.0. When the model + // makes predictions for an image, it will only produce results that have + // at least this confidence score. The default is 0.5. + // + // AutoML Vision Object Detection + // + // `score_threshold` + // : (float) When Model detects objects on the image, + // it will only produce bounding boxes which have at least this + // confidence score. Value in 0 to 1 range, default is 0.5. + // + // `max_bounding_box_count` + // : (int64) The maximum number of bounding + // boxes returned. The default is 100. The + // number of returned bounding boxes might be limited by the server. + // + // AutoML Tables + // + // `feature_importance` + // : (boolean) Whether + // + // [feature_importance][google.cloud.automl.v1.TablesModelColumnInfo.feature_importance] + // is populated in the returned list of + // [TablesAnnotation][google.cloud.automl.v1.TablesAnnotation] + // objects. The default is false. + map params = 3; +} + +// Response message for [PredictionService.Predict][google.cloud.automl.v1.PredictionService.Predict]. +message PredictResponse { + // Prediction result. + // AutoML Translation and AutoML Natural Language Sentiment Analysis + // return precisely one payload. + repeated AnnotationPayload payload = 1; + + // The preprocessed example that AutoML actually makes prediction on. + // Empty if AutoML does not preprocess the input example. + // + // For AutoML Natural Language (Classification, Entity Extraction, and + // Sentiment Analysis), if the input is a document, the recognized text is + // returned in the + // [document_text][google.cloud.automl.v1.Document.document_text] + // property. + ExamplePayload preprocessed_input = 3; + + // Additional domain-specific prediction response metadata. + // + // AutoML Vision Object Detection + // + // `max_bounding_box_count` + // : (int64) The maximum number of bounding boxes to return per image. + // + // AutoML Natural Language Sentiment Analysis + // + // `sentiment_score` + // : (float, deprecated) A value between -1 and 1, + // -1 maps to least positive sentiment, while 1 maps to the most positive + // one and the higher the score, the more positive the sentiment in the + // document is. Yet these values are relative to the training data, so + // e.g. if all data was positive then -1 is also positive (though + // the least). + // `sentiment_score` is not the same as "score" and "magnitude" + // from Sentiment Analysis in the Natural Language API. + map metadata = 2; +} + +// Request message for [PredictionService.BatchPredict][google.cloud.automl.v1.PredictionService.BatchPredict]. +message BatchPredictRequest { + // Required. Name of the model requested to serve the batch prediction. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Model" + } + ]; + + // Required. The input configuration for batch prediction. + BatchPredictInputConfig input_config = 3 [(google.api.field_behavior) = REQUIRED]; + + // Required. The Configuration specifying where output predictions should + // be written. + BatchPredictOutputConfig output_config = 4 [(google.api.field_behavior) = REQUIRED]; + + // Additional domain-specific parameters for the predictions, any string must + // be up to 25000 characters long. + // + // AutoML Natural Language Classification + // + // `score_threshold` + // : (float) A value from 0.0 to 1.0. When the model + // makes predictions for a text snippet, it will only produce results + // that have at least this confidence score. The default is 0.5. + // + // + // AutoML Vision Classification + // + // `score_threshold` + // : (float) A value from 0.0 to 1.0. When the model + // makes predictions for an image, it will only produce results that + // have at least this confidence score. The default is 0.5. + // + // AutoML Vision Object Detection + // + // `score_threshold` + // : (float) When Model detects objects on the image, + // it will only produce bounding boxes which have at least this + // confidence score. Value in 0 to 1 range, default is 0.5. + // + // `max_bounding_box_count` + // : (int64) The maximum number of bounding + // boxes returned per image. The default is 100, the + // number of bounding boxes returned might be limited by the server. + // AutoML Video Intelligence Classification + // + // `score_threshold` + // : (float) A value from 0.0 to 1.0. When the model + // makes predictions for a video, it will only produce results that + // have at least this confidence score. The default is 0.5. + // + // `segment_classification` + // : (boolean) Set to true to request + // segment-level classification. AutoML Video Intelligence returns + // labels and their confidence scores for the entire segment of the + // video that user specified in the request configuration. + // The default is true. + // + // `shot_classification` + // : (boolean) Set to true to request shot-level + // classification. AutoML Video Intelligence determines the boundaries + // for each camera shot in the entire segment of the video that user + // specified in the request configuration. AutoML Video Intelligence + // then returns labels and their confidence scores for each detected + // shot, along with the start and end time of the shot. + // The default is false. + // + // WARNING: Model evaluation is not done for this classification type, + // the quality of it depends on training data, but there are no metrics + // provided to describe that quality. + // + // `1s_interval_classification` + // : (boolean) Set to true to request + // classification for a video at one-second intervals. AutoML Video + // Intelligence returns labels and their confidence scores for each + // second of the entire segment of the video that user specified in the + // request configuration. The default is false. + // + // WARNING: Model evaluation is not done for this classification + // type, the quality of it depends on training data, but there are no + // metrics provided to describe that quality. + // + // AutoML Video Intelligence Object Tracking + // + // `score_threshold` + // : (float) When Model detects objects on video frames, + // it will only produce bounding boxes which have at least this + // confidence score. Value in 0 to 1 range, default is 0.5. + // + // `max_bounding_box_count` + // : (int64) The maximum number of bounding + // boxes returned per image. The default is 100, the + // number of bounding boxes returned might be limited by the server. + // + // `min_bounding_box_size` + // : (float) Only bounding boxes with shortest edge + // at least that long as a relative value of video frame size are + // returned. Value in 0 to 1 range. Default is 0. + // + map params = 5; +} + +// Result of the Batch Predict. This message is returned in +// [response][google.longrunning.Operation.response] of the operation returned +// by the [PredictionService.BatchPredict][google.cloud.automl.v1.PredictionService.BatchPredict]. +message BatchPredictResult { + // Additional domain-specific prediction response metadata. + // + // AutoML Vision Object Detection + // + // `max_bounding_box_count` + // : (int64) The maximum number of bounding boxes returned per image. + // + // AutoML Video Intelligence Object Tracking + // + // `max_bounding_box_count` + // : (int64) The maximum number of bounding boxes returned per frame. + map metadata = 1; +} diff --git a/third_party/googleapis/google/cloud/automl/v1/service.proto b/third_party/googleapis/google/cloud/automl/v1/service.proto new file mode 100644 index 000000000..7c73243cc --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1/service.proto @@ -0,0 +1,609 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.automl.v1; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/cloud/automl/v1/annotation_payload.proto"; +import "google/cloud/automl/v1/annotation_spec.proto"; +import "google/cloud/automl/v1/dataset.proto"; +import "google/cloud/automl/v1/image.proto"; +import "google/cloud/automl/v1/io.proto"; +import "google/cloud/automl/v1/model.proto"; +import "google/cloud/automl/v1/model_evaluation.proto"; +import "google/cloud/automl/v1/operations.proto"; +import "google/longrunning/operations.proto"; +import "google/protobuf/field_mask.proto"; + +option csharp_namespace = "Google.Cloud.AutoML.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1;automl"; +option java_multiple_files = true; +option java_outer_classname = "AutoMlProto"; +option java_package = "com.google.cloud.automl.v1"; +option php_namespace = "Google\\Cloud\\AutoMl\\V1"; +option ruby_package = "Google::Cloud::AutoML::V1"; + +// AutoML Server API. +// +// The resource names are assigned by the server. +// The server never reuses names that it has created after the resources with +// those names are deleted. +// +// An ID of a resource is the last element of the item's resource name. For +// `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}`, then +// the id for the item is `{dataset_id}`. +// +// Currently the only supported `location_id` is "us-central1". +// +// On any input that is documented to expect a string parameter in +// snake_case or kebab-case, either of those cases is accepted. +service AutoMl { + option (google.api.default_host) = "automl.googleapis.com"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; + + // Creates a dataset. + rpc CreateDataset(CreateDatasetRequest) returns (google.longrunning.Operation) { + option (google.api.http) = { + post: "/v1/{parent=projects/*/locations/*}/datasets" + body: "dataset" + }; + option (google.api.method_signature) = "parent,dataset"; + option (google.longrunning.operation_info) = { + response_type: "Dataset" + metadata_type: "OperationMetadata" + }; + } + + // Gets a dataset. + rpc GetDataset(GetDatasetRequest) returns (Dataset) { + option (google.api.http) = { + get: "/v1/{name=projects/*/locations/*/datasets/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Lists datasets in a project. + rpc ListDatasets(ListDatasetsRequest) returns (ListDatasetsResponse) { + option (google.api.http) = { + get: "/v1/{parent=projects/*/locations/*}/datasets" + }; + option (google.api.method_signature) = "parent"; + } + + // Updates a dataset. + rpc UpdateDataset(UpdateDatasetRequest) returns (Dataset) { + option (google.api.http) = { + patch: "/v1/{dataset.name=projects/*/locations/*/datasets/*}" + body: "dataset" + }; + option (google.api.method_signature) = "dataset,update_mask"; + } + + // Deletes a dataset and all of its contents. + // Returns empty response in the + // [response][google.longrunning.Operation.response] field when it completes, + // and `delete_details` in the + // [metadata][google.longrunning.Operation.metadata] field. + rpc DeleteDataset(DeleteDatasetRequest) returns (google.longrunning.Operation) { + option (google.api.http) = { + delete: "/v1/{name=projects/*/locations/*/datasets/*}" + }; + option (google.api.method_signature) = "name"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "OperationMetadata" + }; + } + + // Imports data into a dataset. + // For Tables this method can only be called on an empty Dataset. + // + // For Tables: + // * A + // [schema_inference_version][google.cloud.automl.v1.InputConfig.params] + // parameter must be explicitly set. + // Returns an empty response in the + // [response][google.longrunning.Operation.response] field when it completes. + rpc ImportData(ImportDataRequest) returns (google.longrunning.Operation) { + option (google.api.http) = { + post: "/v1/{name=projects/*/locations/*/datasets/*}:importData" + body: "*" + }; + option (google.api.method_signature) = "name,input_config"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "OperationMetadata" + }; + } + + // Exports dataset's data to the provided output location. + // Returns an empty response in the + // [response][google.longrunning.Operation.response] field when it completes. + rpc ExportData(ExportDataRequest) returns (google.longrunning.Operation) { + option (google.api.http) = { + post: "/v1/{name=projects/*/locations/*/datasets/*}:exportData" + body: "*" + }; + option (google.api.method_signature) = "name,output_config"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "OperationMetadata" + }; + } + + // Gets an annotation spec. + rpc GetAnnotationSpec(GetAnnotationSpecRequest) returns (AnnotationSpec) { + option (google.api.http) = { + get: "/v1/{name=projects/*/locations/*/datasets/*/annotationSpecs/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Creates a model. + // Returns a Model in the [response][google.longrunning.Operation.response] + // field when it completes. + // When you create a model, several model evaluations are created for it: + // a global evaluation, and one evaluation for each annotation spec. + rpc CreateModel(CreateModelRequest) returns (google.longrunning.Operation) { + option (google.api.http) = { + post: "/v1/{parent=projects/*/locations/*}/models" + body: "model" + }; + option (google.api.method_signature) = "parent,model"; + option (google.longrunning.operation_info) = { + response_type: "Model" + metadata_type: "OperationMetadata" + }; + } + + // Gets a model. + rpc GetModel(GetModelRequest) returns (Model) { + option (google.api.http) = { + get: "/v1/{name=projects/*/locations/*/models/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Lists models. + rpc ListModels(ListModelsRequest) returns (ListModelsResponse) { + option (google.api.http) = { + get: "/v1/{parent=projects/*/locations/*}/models" + }; + option (google.api.method_signature) = "parent"; + } + + // Deletes a model. + // Returns `google.protobuf.Empty` in the + // [response][google.longrunning.Operation.response] field when it completes, + // and `delete_details` in the + // [metadata][google.longrunning.Operation.metadata] field. + rpc DeleteModel(DeleteModelRequest) returns (google.longrunning.Operation) { + option (google.api.http) = { + delete: "/v1/{name=projects/*/locations/*/models/*}" + }; + option (google.api.method_signature) = "name"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "OperationMetadata" + }; + } + + // Updates a model. + rpc UpdateModel(UpdateModelRequest) returns (Model) { + option (google.api.http) = { + patch: "/v1/{model.name=projects/*/locations/*/models/*}" + body: "model" + }; + option (google.api.method_signature) = "model,update_mask"; + } + + // Deploys a model. If a model is already deployed, deploying it with the + // same parameters has no effect. Deploying with different parametrs + // (as e.g. changing + // + // [node_number][google.cloud.automl.v1p1beta.ImageObjectDetectionModelDeploymentMetadata.node_number]) + // will reset the deployment state without pausing the model's availability. + // + // Only applicable for Text Classification, Image Object Detection , Tables, and Image Segmentation; all other domains manage + // deployment automatically. + // + // Returns an empty response in the + // [response][google.longrunning.Operation.response] field when it completes. + rpc DeployModel(DeployModelRequest) returns (google.longrunning.Operation) { + option (google.api.http) = { + post: "/v1/{name=projects/*/locations/*/models/*}:deploy" + body: "*" + }; + option (google.api.method_signature) = "name"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "OperationMetadata" + }; + } + + // Undeploys a model. If the model is not deployed this method has no effect. + // + // Only applicable for Text Classification, Image Object Detection and Tables; + // all other domains manage deployment automatically. + // + // Returns an empty response in the + // [response][google.longrunning.Operation.response] field when it completes. + rpc UndeployModel(UndeployModelRequest) returns (google.longrunning.Operation) { + option (google.api.http) = { + post: "/v1/{name=projects/*/locations/*/models/*}:undeploy" + body: "*" + }; + option (google.api.method_signature) = "name"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "OperationMetadata" + }; + } + + // Exports a trained, "export-able", model to a user specified Google Cloud + // Storage location. A model is considered export-able if and only if it has + // an export format defined for it in + // [ModelExportOutputConfig][google.cloud.automl.v1.ModelExportOutputConfig]. + // + // Returns an empty response in the + // [response][google.longrunning.Operation.response] field when it completes. + rpc ExportModel(ExportModelRequest) returns (google.longrunning.Operation) { + option (google.api.http) = { + post: "/v1/{name=projects/*/locations/*/models/*}:export" + body: "*" + }; + option (google.api.method_signature) = "name,output_config"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "OperationMetadata" + }; + } + + // Gets a model evaluation. + rpc GetModelEvaluation(GetModelEvaluationRequest) returns (ModelEvaluation) { + option (google.api.http) = { + get: "/v1/{name=projects/*/locations/*/models/*/modelEvaluations/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Lists model evaluations. + rpc ListModelEvaluations(ListModelEvaluationsRequest) returns (ListModelEvaluationsResponse) { + option (google.api.http) = { + get: "/v1/{parent=projects/*/locations/*/models/*}/modelEvaluations" + }; + option (google.api.method_signature) = "parent,filter"; + } +} + +// Request message for [AutoMl.CreateDataset][google.cloud.automl.v1.AutoMl.CreateDataset]. +message CreateDatasetRequest { + // Required. The resource name of the project to create the dataset for. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "locations.googleapis.com/Location" + } + ]; + + // Required. The dataset to create. + Dataset dataset = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// Request message for [AutoMl.GetDataset][google.cloud.automl.v1.AutoMl.GetDataset]. +message GetDatasetRequest { + // Required. The resource name of the dataset to retrieve. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Dataset" + } + ]; +} + +// Request message for [AutoMl.ListDatasets][google.cloud.automl.v1.AutoMl.ListDatasets]. +message ListDatasetsRequest { + // Required. The resource name of the project from which to list datasets. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "locations.googleapis.com/Location" + } + ]; + + // An expression for filtering the results of the request. + // + // * `dataset_metadata` - for existence of the case (e.g. + // image_classification_dataset_metadata:*). Some examples of using the filter are: + // + // * `translation_dataset_metadata:*` --> The dataset has + // translation_dataset_metadata. + string filter = 3; + + // Requested page size. Server may return fewer results than requested. + // If unspecified, server will pick a default size. + int32 page_size = 4; + + // A token identifying a page of results for the server to return + // Typically obtained via + // [ListDatasetsResponse.next_page_token][google.cloud.automl.v1.ListDatasetsResponse.next_page_token] of the previous + // [AutoMl.ListDatasets][google.cloud.automl.v1.AutoMl.ListDatasets] call. + string page_token = 6; +} + +// Response message for [AutoMl.ListDatasets][google.cloud.automl.v1.AutoMl.ListDatasets]. +message ListDatasetsResponse { + // The datasets read. + repeated Dataset datasets = 1; + + // A token to retrieve next page of results. + // Pass to [ListDatasetsRequest.page_token][google.cloud.automl.v1.ListDatasetsRequest.page_token] to obtain that page. + string next_page_token = 2; +} + +// Request message for [AutoMl.UpdateDataset][google.cloud.automl.v1.AutoMl.UpdateDataset] +message UpdateDatasetRequest { + // Required. The dataset which replaces the resource on the server. + Dataset dataset = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The update mask applies to the resource. + google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// Request message for [AutoMl.DeleteDataset][google.cloud.automl.v1.AutoMl.DeleteDataset]. +message DeleteDatasetRequest { + // Required. The resource name of the dataset to delete. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Dataset" + } + ]; +} + +// Request message for [AutoMl.ImportData][google.cloud.automl.v1.AutoMl.ImportData]. +message ImportDataRequest { + // Required. Dataset name. Dataset must already exist. All imported + // annotations and examples will be added. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Dataset" + } + ]; + + // Required. The desired input location and its domain specific semantics, + // if any. + InputConfig input_config = 3 [(google.api.field_behavior) = REQUIRED]; +} + +// Request message for [AutoMl.ExportData][google.cloud.automl.v1.AutoMl.ExportData]. +message ExportDataRequest { + // Required. The resource name of the dataset. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Dataset" + } + ]; + + // Required. The desired output location. + OutputConfig output_config = 3 [(google.api.field_behavior) = REQUIRED]; +} + +// Request message for [AutoMl.GetAnnotationSpec][google.cloud.automl.v1.AutoMl.GetAnnotationSpec]. +message GetAnnotationSpecRequest { + // Required. The resource name of the annotation spec to retrieve. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/AnnotationSpec" + } + ]; +} + +// Request message for [AutoMl.CreateModel][google.cloud.automl.v1.AutoMl.CreateModel]. +message CreateModelRequest { + // Required. Resource name of the parent project where the model is being created. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "locations.googleapis.com/Location" + } + ]; + + // Required. The model to create. + Model model = 4 [(google.api.field_behavior) = REQUIRED]; +} + +// Request message for [AutoMl.GetModel][google.cloud.automl.v1.AutoMl.GetModel]. +message GetModelRequest { + // Required. Resource name of the model. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Model" + } + ]; +} + +// Request message for [AutoMl.ListModels][google.cloud.automl.v1.AutoMl.ListModels]. +message ListModelsRequest { + // Required. Resource name of the project, from which to list the models. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "locations.googleapis.com/Location" + } + ]; + + // An expression for filtering the results of the request. + // + // * `model_metadata` - for existence of the case (e.g. + // video_classification_model_metadata:*). + // * `dataset_id` - for = or !=. Some examples of using the filter are: + // + // * `image_classification_model_metadata:*` --> The model has + // image_classification_model_metadata. + // * `dataset_id=5` --> The model was created from a dataset with ID 5. + string filter = 3; + + // Requested page size. + int32 page_size = 4; + + // A token identifying a page of results for the server to return + // Typically obtained via + // [ListModelsResponse.next_page_token][google.cloud.automl.v1.ListModelsResponse.next_page_token] of the previous + // [AutoMl.ListModels][google.cloud.automl.v1.AutoMl.ListModels] call. + string page_token = 6; +} + +// Response message for [AutoMl.ListModels][google.cloud.automl.v1.AutoMl.ListModels]. +message ListModelsResponse { + // List of models in the requested page. + repeated Model model = 1; + + // A token to retrieve next page of results. + // Pass to [ListModelsRequest.page_token][google.cloud.automl.v1.ListModelsRequest.page_token] to obtain that page. + string next_page_token = 2; +} + +// Request message for [AutoMl.DeleteModel][google.cloud.automl.v1.AutoMl.DeleteModel]. +message DeleteModelRequest { + // Required. Resource name of the model being deleted. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Model" + } + ]; +} + +// Request message for [AutoMl.UpdateModel][google.cloud.automl.v1.AutoMl.UpdateModel] +message UpdateModelRequest { + // Required. The model which replaces the resource on the server. + Model model = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The update mask applies to the resource. + google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// Request message for [AutoMl.DeployModel][google.cloud.automl.v1.AutoMl.DeployModel]. +message DeployModelRequest { + // The per-domain specific deployment parameters. + oneof model_deployment_metadata { + // Model deployment metadata specific to Image Object Detection. + ImageObjectDetectionModelDeploymentMetadata image_object_detection_model_deployment_metadata = 2; + + // Model deployment metadata specific to Image Classification. + ImageClassificationModelDeploymentMetadata image_classification_model_deployment_metadata = 4; + } + + // Required. Resource name of the model to deploy. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Model" + } + ]; +} + +// Request message for [AutoMl.UndeployModel][google.cloud.automl.v1.AutoMl.UndeployModel]. +message UndeployModelRequest { + // Required. Resource name of the model to undeploy. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Model" + } + ]; +} + +// Request message for [AutoMl.ExportModel][google.cloud.automl.v1.AutoMl.ExportModel]. +// Models need to be enabled for exporting, otherwise an error code will be +// returned. +message ExportModelRequest { + // Required. The resource name of the model to export. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Model" + } + ]; + + // Required. The desired output location and configuration. + ModelExportOutputConfig output_config = 3 [(google.api.field_behavior) = REQUIRED]; +} + +// Request message for [AutoMl.GetModelEvaluation][google.cloud.automl.v1.AutoMl.GetModelEvaluation]. +message GetModelEvaluationRequest { + // Required. Resource name for the model evaluation. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/ModelEvaluation" + } + ]; +} + +// Request message for [AutoMl.ListModelEvaluations][google.cloud.automl.v1.AutoMl.ListModelEvaluations]. +message ListModelEvaluationsRequest { + // Required. Resource name of the model to list the model evaluations for. + // If modelId is set as "-", this will list model evaluations from across all + // models of the parent location. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Model" + } + ]; + + // Required. An expression for filtering the results of the request. + // + // * `annotation_spec_id` - for =, != or existence. See example below for + // the last. + // + // Some examples of using the filter are: + // + // * `annotation_spec_id!=4` --> The model evaluation was done for + // annotation spec with ID different than 4. + // * `NOT annotation_spec_id:*` --> The model evaluation was done for + // aggregate of all annotation specs. + string filter = 3 [(google.api.field_behavior) = REQUIRED]; + + // Requested page size. + int32 page_size = 4; + + // A token identifying a page of results for the server to return. + // Typically obtained via + // [ListModelEvaluationsResponse.next_page_token][google.cloud.automl.v1.ListModelEvaluationsResponse.next_page_token] of the previous + // [AutoMl.ListModelEvaluations][google.cloud.automl.v1.AutoMl.ListModelEvaluations] call. + string page_token = 6; +} + +// Response message for [AutoMl.ListModelEvaluations][google.cloud.automl.v1.AutoMl.ListModelEvaluations]. +message ListModelEvaluationsResponse { + // List of model evaluations in the requested page. + repeated ModelEvaluation model_evaluation = 1; + + // A token to retrieve next page of results. + // Pass to the [ListModelEvaluationsRequest.page_token][google.cloud.automl.v1.ListModelEvaluationsRequest.page_token] field of a new + // [AutoMl.ListModelEvaluations][google.cloud.automl.v1.AutoMl.ListModelEvaluations] request to obtain that page. + string next_page_token = 2; +} diff --git a/third_party/googleapis/google/cloud/automl/v1/text.proto b/third_party/googleapis/google/cloud/automl/v1/text.proto new file mode 100644 index 000000000..667031b87 --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1/text.proto @@ -0,0 +1,66 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.automl.v1; + +import "google/cloud/automl/v1/classification.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Cloud.AutoML.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1;automl"; +option java_multiple_files = true; +option java_outer_classname = "TextProto"; +option java_package = "com.google.cloud.automl.v1"; +option php_namespace = "Google\\Cloud\\AutoMl\\V1"; +option ruby_package = "Google::Cloud::AutoML::V1"; + +// Dataset metadata for classification. +message TextClassificationDatasetMetadata { + // Required. Type of the classification problem. + ClassificationType classification_type = 1; +} + +// Model metadata that is specific to text classification. +message TextClassificationModelMetadata { + // Output only. Classification type of the dataset used to train this model. + ClassificationType classification_type = 3; +} + +// Dataset metadata that is specific to text extraction +message TextExtractionDatasetMetadata { + +} + +// Model metadata that is specific to text extraction. +message TextExtractionModelMetadata { + +} + +// Dataset metadata for text sentiment. +message TextSentimentDatasetMetadata { + // Required. A sentiment is expressed as an integer ordinal, where higher value + // means a more positive sentiment. The range of sentiments that will be used + // is between 0 and sentiment_max (inclusive on both ends), and all the values + // in the range must be represented in the dataset before a model can be + // created. + // sentiment_max value must be between 1 and 10 (inclusive). + int32 sentiment_max = 1; +} + +// Model metadata that is specific to text sentiment. +message TextSentimentModelMetadata { + +} diff --git a/third_party/googleapis/google/cloud/automl/v1/text_extraction.proto b/third_party/googleapis/google/cloud/automl/v1/text_extraction.proto new file mode 100644 index 000000000..37a31e715 --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1/text_extraction.proto @@ -0,0 +1,69 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.automl.v1; + +import "google/cloud/automl/v1/text_segment.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Cloud.AutoML.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1;automl"; +option java_multiple_files = true; +option java_package = "com.google.cloud.automl.v1"; +option php_namespace = "Google\\Cloud\\AutoMl\\V1"; +option ruby_package = "Google::Cloud::AutoML::V1"; + +// Annotation for identifying spans of text. +message TextExtractionAnnotation { + // Required. Text extraction annotations can either be a text segment or a + // text relation. + oneof annotation { + // An entity annotation will set this, which is the part of the original + // text to which the annotation pertains. + TextSegment text_segment = 3; + } + + // Output only. A confidence estimate between 0.0 and 1.0. A higher value + // means greater confidence in correctness of the annotation. + float score = 1; +} + +// Model evaluation metrics for text extraction problems. +message TextExtractionEvaluationMetrics { + // Metrics for a single confidence threshold. + message ConfidenceMetricsEntry { + // Output only. The confidence threshold value used to compute the metrics. + // Only annotations with score of at least this threshold are considered to + // be ones the model would return. + float confidence_threshold = 1; + + // Output only. Recall under the given confidence threshold. + float recall = 3; + + // Output only. Precision under the given confidence threshold. + float precision = 4; + + // Output only. The harmonic mean of recall and precision. + float f1_score = 5; + } + + // Output only. The Area under precision recall curve metric. + float au_prc = 1; + + // Output only. Metrics that have confidence thresholds. + // Precision-recall curve can be derived from it. + repeated ConfidenceMetricsEntry confidence_metrics_entries = 2; +} diff --git a/third_party/googleapis/google/cloud/automl/v1/text_segment.proto b/third_party/googleapis/google/cloud/automl/v1/text_segment.proto new file mode 100644 index 000000000..be7eb1543 --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1/text_segment.proto @@ -0,0 +1,42 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.automl.v1; + +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Cloud.AutoML.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1;automl"; +option java_multiple_files = true; +option java_outer_classname = "TextSegmentProto"; +option java_package = "com.google.cloud.automl.v1"; +option php_namespace = "Google\\Cloud\\AutoMl\\V1"; +option ruby_package = "Google::Cloud::AutoML::V1"; + +// A contiguous part of a text (string), assuming it has an UTF-8 NFC encoding. +message TextSegment { + // Output only. The content of the TextSegment. + string content = 3; + + // Required. Zero-based character index of the first character of the text + // segment (counting characters from the beginning of the text). + int64 start_offset = 1; + + // Required. Zero-based character index of the first character past the end of + // the text segment (counting character from the beginning of the text). + // The character at the end_offset is NOT included in the text segment. + int64 end_offset = 2; +} diff --git a/third_party/googleapis/google/cloud/automl/v1/text_sentiment.proto b/third_party/googleapis/google/cloud/automl/v1/text_sentiment.proto new file mode 100644 index 000000000..c68b9ed3d --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1/text_sentiment.proto @@ -0,0 +1,78 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.automl.v1; + +import "google/cloud/automl/v1/classification.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Cloud.AutoML.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1;automl"; +option java_multiple_files = true; +option java_outer_classname = "TextSentimentProto"; +option java_package = "com.google.cloud.automl.v1"; +option php_namespace = "Google\\Cloud\\AutoMl\\V1"; +option ruby_package = "Google::Cloud::AutoML::V1"; + +// Contains annotation details specific to text sentiment. +message TextSentimentAnnotation { + // Output only. The sentiment with the semantic, as given to the + // [AutoMl.ImportData][google.cloud.automl.v1.AutoMl.ImportData] when populating the dataset from which the model used + // for the prediction had been trained. + // The sentiment values are between 0 and + // Dataset.text_sentiment_dataset_metadata.sentiment_max (inclusive), + // with higher value meaning more positive sentiment. They are completely + // relative, i.e. 0 means least positive sentiment and sentiment_max means + // the most positive from the sentiments present in the train data. Therefore + // e.g. if train data had only negative sentiment, then sentiment_max, would + // be still negative (although least negative). + // The sentiment shouldn't be confused with "score" or "magnitude" + // from the previous Natural Language Sentiment Analysis API. + int32 sentiment = 1; +} + +// Model evaluation metrics for text sentiment problems. +message TextSentimentEvaluationMetrics { + // Output only. Precision. + float precision = 1; + + // Output only. Recall. + float recall = 2; + + // Output only. The harmonic mean of recall and precision. + float f1_score = 3; + + // Output only. Mean absolute error. Only set for the overall model + // evaluation, not for evaluation of a single annotation spec. + float mean_absolute_error = 4; + + // Output only. Mean squared error. Only set for the overall model + // evaluation, not for evaluation of a single annotation spec. + float mean_squared_error = 5; + + // Output only. Linear weighted kappa. Only set for the overall model + // evaluation, not for evaluation of a single annotation spec. + float linear_kappa = 6; + + // Output only. Quadratic weighted kappa. Only set for the overall model + // evaluation, not for evaluation of a single annotation spec. + float quadratic_kappa = 7; + + // Output only. Confusion matrix of the evaluation. + // Only set for the overall model evaluation, not for evaluation of a single + // annotation spec. + ClassificationEvaluationMetrics.ConfusionMatrix confusion_matrix = 8; +} diff --git a/third_party/googleapis/google/cloud/automl/v1/translation.proto b/third_party/googleapis/google/cloud/automl/v1/translation.proto new file mode 100644 index 000000000..642894e85 --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1/translation.proto @@ -0,0 +1,70 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.automl.v1; + +import "google/api/field_behavior.proto"; +import "google/cloud/automl/v1/data_items.proto"; +import "google/api/annotations.proto"; + +option csharp_namespace = "Google.Cloud.AutoML.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1;automl"; +option java_multiple_files = true; +option java_outer_classname = "TranslationProto"; +option java_package = "com.google.cloud.automl.v1"; +option php_namespace = "Google\\Cloud\\AutoMl\\V1"; +option ruby_package = "Google::Cloud::AutoML::V1"; + +// Dataset metadata that is specific to translation. +message TranslationDatasetMetadata { + // Required. The BCP-47 language code of the source language. + string source_language_code = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The BCP-47 language code of the target language. + string target_language_code = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// Evaluation metrics for the dataset. +message TranslationEvaluationMetrics { + // Output only. BLEU score. + double bleu_score = 1; + + // Output only. BLEU score for base model. + double base_bleu_score = 2; +} + +// Model metadata that is specific to translation. +message TranslationModelMetadata { + // The resource name of the model to use as a baseline to train the custom + // model. If unset, we use the default base model provided by Google + // Translate. Format: + // `projects/{project_id}/locations/{location_id}/models/{model_id}` + string base_model = 1; + + // Output only. Inferred from the dataset. + // The source language (The BCP-47 language code) that is used for training. + string source_language_code = 2; + + // Output only. The target language (The BCP-47 language code) that is used + // for training. + string target_language_code = 3; +} + +// Annotation details specific to translation. +message TranslationAnnotation { + // Output only . The translated content. + TextSnippet translated_content = 1; +} diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/automl/v1beta1/BUILD.bazel index 320e14835..87ca7a56e 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/BUILD.bazel +++ b/third_party/googleapis/google/cloud/automl/v1beta1/BUILD.bazel @@ -1,9 +1,12 @@ +# This file was automatically generated by BuildFileGenerator + # This is an API workspace, having public visibility by default makes perfect sense. package(default_visibility = ["//visibility:public"]) ############################################################################## # Common ############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") proto_library( @@ -41,6 +44,8 @@ proto_library( deps = [ "//google/api:annotations_proto", "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", "//google/longrunning:operations_proto", "//google/rpc:status_proto", "@com_google_protobuf//:any_proto", @@ -54,7 +59,10 @@ proto_library( proto_library_with_info( name = "automl_proto_with_info", - deps = [":automl_proto"], + deps = [ + ":automl_proto", + "//google/cloud:common_resources_proto", + ], ) ############################################################################## @@ -62,18 +70,13 @@ proto_library_with_info( ############################################################################## load( "@com_google_googleapis_imports//:imports.bzl", - "java_grpc_library", - "java_gapic_library", "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", "java_proto_library", - "java_resource_name_proto_library", - "java_test", ) -_JAVA_GRPC_DEPS = [ - "@com_google_api_grpc_proto_google_common_protos//jar", -] - java_proto_library( name = "automl_java_proto", deps = [":automl_proto"], @@ -82,52 +85,41 @@ java_proto_library( java_grpc_library( name = "automl_java_grpc", srcs = [":automl_proto"], - deps = [":automl_java_proto"] + _JAVA_GRPC_DEPS, -) - -java_resource_name_proto_library( - name = "automl_resource_name_java_proto", - gapic_yaml = "automl_gapic.yaml", - deps = [":automl_proto"], + deps = [":automl_java_proto"], ) java_gapic_library( name = "automl_java_gapic", src = ":automl_proto_with_info", gapic_yaml = "automl_gapic.yaml", - service_yaml = "//google/cloud/automl:automl_v1beta1.yaml", - test_deps = [":automl_java_grpc"], + package = "google.cloud.automl.v1beta1", + service_yaml = "automl_v1beta1.yaml", + test_deps = [ + ":automl_java_grpc", + ], deps = [ ":automl_java_proto", - ":automl_resource_name_java_proto", - ] + _JAVA_GRPC_DEPS, + ], ) -[java_test( - name = test_name, - test_class = test_name, - runtime_deps = [ - ":automl_java_gapic_test", +java_gapic_test( + name = "automl_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.automl.v1beta1.AutoMlClientTest", + "com.google.cloud.automl.v1beta1.PredictionServiceClientTest", ], -) for test_name in [ - "com.google.cloud.automl.v1beta1.AutoMlClientTest", - "com.google.cloud.automl.v1beta1.PredictionServiceClientTest", -]] + runtime_deps = [":automl_java_gapic_test"], +) -# Opensource Packages +# Open Source Packages java_gapic_assembly_gradle_pkg( name = "google-cloud-automl-v1beta1-java", - client_deps = [":automl_java_gapic"], - client_group = "com.google.cloud", - client_test_deps = [":automl_java_gapic_test"], - grpc_deps = [":automl_java_grpc"], - grpc_group = "com.google.api.grpc", - proto_deps = [ + deps = [ + ":automl_java_gapic", + ":automl_java_grpc", ":automl_java_proto", ":automl_proto", - ":automl_resource_name_java_proto", - ] + _JAVA_GRPC_DEPS, - version = "0.0.0-SNAPSHOT", + ], ) ############################################################################## @@ -135,10 +127,10 @@ java_gapic_assembly_gradle_pkg( ############################################################################## load( "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", "go_proto_library", "go_test", - "go_gapic_library", - "go_gapic_assembly_pkg", ) go_proto_library( @@ -155,15 +147,19 @@ go_proto_library( go_gapic_library( name = "automl_go_gapic", - src = ":automl_proto_with_info", - gapic_yaml = "automl_gapic.yaml", - importpath = "cloud.google.com/go/cloud/automl/apiv1beta1", - service_yaml = "//google/cloud/automl:automl_v1beta1.yaml", + srcs = [":automl_proto_with_info"], + grpc_service_config = "automl_grpc_service_config.json", + importpath = "cloud.google.com/go/automl/apiv1beta1;automl", + service_yaml = "automl_v1beta1.yaml", deps = [ ":automl_go_proto", "//google/longrunning:longrunning_go_gapic", "//google/longrunning:longrunning_go_proto", "@com_google_cloud_go//longrunning:go_default_library", + "@com_google_cloud_go//longrunning/autogen:go_default_library", + "@io_bazel_rules_go//proto/wkt:any_go_proto", + "@io_bazel_rules_go//proto/wkt:duration_go_proto", + "@io_bazel_rules_go//proto/wkt:struct_go_proto", ], ) @@ -171,16 +167,243 @@ go_test( name = "automl_go_gapic_test", srcs = [":automl_go_gapic_srcjar_test"], embed = [":automl_go_gapic"], - importpath = "cloud.google.com/go/cloud/automl/apiv1beta1", + importpath = "cloud.google.com/go/automl/apiv1beta1", ) -# Opensource Packages +# Open Source Packages go_gapic_assembly_pkg( name = "gapi-cloud-automl-v1beta1-go", deps = [ ":automl_go_gapic", - ":automl_go_gapic_srcjar-smoke-test.srcjar", ":automl_go_gapic_srcjar-test.srcjar", ":automl_go_proto", ], ) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "automl_moved_proto", + srcs = [":automl_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/longrunning:operations_proto", + "//google/rpc:status_proto", + "@com_google_protobuf//:any_proto", + "@com_google_protobuf//:duration_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:struct_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +py_proto_library( + name = "automl_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":automl_moved_proto"], +) + +py_grpc_library( + name = "automl_py_grpc", + srcs = [":automl_moved_proto"], + deps = [":automl_py_proto"], +) + +py_gapic_library( + name = "automl_py_gapic", + src = ":automl_proto_with_info", + gapic_yaml = "automl_gapic.yaml", + package = "google.cloud.automl.v1beta1", + service_yaml = "automl_v1beta1.yaml", + deps = [ + ":automl_py_grpc", + ":automl_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "automl-v1beta1-py", + deps = [ + ":automl_py_gapic", + ":automl_py_grpc", + ":automl_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "automl_php_proto", + deps = [":automl_proto"], +) + +php_grpc_library( + name = "automl_php_grpc", + srcs = [":automl_proto"], + deps = [":automl_php_proto"], +) + +php_gapic_library( + name = "automl_php_gapic", + src = ":automl_proto_with_info", + gapic_yaml = "automl_gapic.yaml", + package = "google.cloud.automl.v1beta1", + service_yaml = "automl_v1beta1.yaml", + deps = [ + ":automl_php_grpc", + ":automl_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-automl-v1beta1-php", + deps = [ + ":automl_php_gapic", + ":automl_php_grpc", + ":automl_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "automl_nodejs_gapic", + src = ":automl_proto_with_info", + gapic_yaml = "automl_gapic.yaml", + package = "google.cloud.automl.v1beta1", + service_yaml = "automl_v1beta1.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "automl-v1beta1-nodejs", + deps = [ + ":automl_nodejs_gapic", + ":automl_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "automl_ruby_proto", + deps = [":automl_proto"], +) + +ruby_grpc_library( + name = "automl_ruby_grpc", + srcs = [":automl_proto"], + deps = [":automl_ruby_proto"], +) + +ruby_gapic_library( + name = "automl_ruby_gapic", + src = ":automl_proto_with_info", + gapic_yaml = "automl_gapic.yaml", + package = "google.cloud.automl.v1beta1", + service_yaml = "automl_v1beta1.yaml", + deps = [ + ":automl_ruby_grpc", + ":automl_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-automl-v1beta1-ruby", + deps = [ + ":automl_ruby_gapic", + ":automl_ruby_grpc", + ":automl_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "automl_csharp_proto", + deps = [":automl_proto"], +) + +csharp_grpc_library( + name = "automl_csharp_grpc", + srcs = [":automl_proto"], + deps = [":automl_csharp_proto"], +) + +csharp_gapic_library( + name = "automl_csharp_gapic", + src = ":automl_proto_with_info", + gapic_yaml = "automl_gapic.yaml", + package = "google.cloud.automl.v1beta1", + service_yaml = "automl_v1beta1.yaml", + deps = [ + ":automl_csharp_grpc", + ":automl_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-automl-v1beta1-csharp", + deps = [ + ":automl_csharp_gapic", + ":automl_csharp_grpc", + ":automl_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/annotation_payload.proto b/third_party/googleapis/google/cloud/automl/v1beta1/annotation_payload.proto index 7cc2860f1..f62bb269e 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/annotation_payload.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/annotation_payload.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/annotation_spec.proto b/third_party/googleapis/google/cloud/automl/v1beta1/annotation_spec.proto index 483792b66..d9df07ee3 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/annotation_spec.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/annotation_spec.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,12 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.automl.v1beta1; +import "google/api/resource.proto"; import "google/api/annotations.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl"; @@ -27,16 +27,19 @@ option ruby_package = "Google::Cloud::AutoML::V1beta1"; // A definition of an annotation spec. message AnnotationSpec { + option (google.api.resource) = { + type: "automl.googleapis.com/AnnotationSpec" + pattern: "projects/{project}/locations/{location}/datasets/{dataset}/annotationSpecs/{annotation_spec}" + }; + // Output only. Resource name of the annotation spec. // Form: // // 'projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/annotationSpecs/{annotation_spec_id}' string name = 1; - // Required. - // The name of the annotation spec to show in the interface. The name can be + // Required. The name of the annotation spec to show in the interface. The name can be // up to 32 characters long and must match the regexp `[a-zA-Z0-9_]+`. - // (_), and ASCII digits 0-9. string display_name = 2; // Output only. The number of examples in the parent dataset diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/automl_gapic.legacy.yaml b/third_party/googleapis/google/cloud/automl/v1beta1/automl_gapic.legacy.yaml new file mode 100644 index 000000000..c83ffca05 --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1beta1/automl_gapic.legacy.yaml @@ -0,0 +1,730 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 1.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.automl.v1beta1 + python: + package_name: google.cloud.automl_v1beta1.gapic + go: + package_name: cloud.google.com/go/automl/apiv1beta1 + csharp: + package_name: Google.Cloud.Automl.V1Beta1 + ruby: + package_name: Google::Cloud::AutoML::V1beta1 + php: + package_name: Google\Cloud\AutoMl\V1beta1 + nodejs: + package_name: automl.v1beta1 + domain_layer_location: google-cloud +# A list of API interface configurations. +interfaces: + # The fully qualified name of the API interface. +- name: google.cloud.automl.v1beta1.PredictionService + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: + - name_pattern: projects/{project}/locations/{location}/models/{model} + entity_name: model + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - UNAVAILABLE + - DEADLINE_EXCEEDED + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 60000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 60000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # + # name - The simple name of the method. + # + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce method + # overloads which allow a client to directly pass request message fields as + # method parameters. This information may or may not be used, depending on + # the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request message. + # + # required_fields - Fields that are always required for a request to be + # valid. + # + # resource_name_treatment - An enum that specifies how to treat the resource + # name formats defined in the field_name_patterns and + # response_field_name_patterns fields. + # UNSET: default value + # NONE: the collection configs will not be used by the generated code. + # VALIDATE: string fields will be validated by the client against the + # specified resource name formats. + # STATIC_TYPES: the client will use generated types for resource names. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a paging + # list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It defines + # which fields match the paging pattern in the request. The request consists + # of a page_size_field and a token_field. The page_size_field is the name of + # the optional field specifying the maximum number of elements to be + # returned in the response. The token_field is the name of the field in the + # request containing the page token. + # The response specifies response information of the list method. It defines + # which fields match the paging pattern in the response. The response + # consists of a token_field and a resources_field. The token_field is the + # name of the field in the response containing the next page token. The + # resources_field is the name of the field in the response containing the + # list of resources belonging to the page. + # + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: Predict + flattening: + groups: + - parameters: + - name + - payload + - params + required_fields: + - name + - payload + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: model + resource_name_treatment: STATIC_TYPES + timeout_millis: 60000 + - name: BatchPredict + required_fields: + - name + - input_config + - output_config + flattening: + groups: + - parameters: + - name + - input_config + - output_config + - params + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: model + long_running: + return_type: google.cloud.automl.v1beta1.BatchPredictResult + metadata_type: google.cloud.automl.v1beta1.OperationMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 86400000 + timeout_millis: 20000 + # The fully qualified name of the API interface. +- name: google.cloud.automl.v1beta1.AutoMl + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: + - name_pattern: projects/{project}/locations/{location} + entity_name: location + - name_pattern: projects/{project}/locations/{location}/datasets/{dataset} + entity_name: dataset + - name_pattern: projects/{project}/locations/{location}/models/{model} + entity_name: model + - name_pattern: projects/{project}/locations/{location}/models/{model}/modelEvaluations/{model_evaluation} + entity_name: model_evaluation + - name_pattern: projects/{project}/locations/{location}/datasets/{dataset}/annotationSpecs/{annotation_spec} + entity_name: annotation_spec + - name_pattern: projects/{project}/locations/{location}/datasets/{dataset}/tableSpecs/{table_spec} + entity_name: table_spec + - name_pattern: projects/{project}/locations/{location}/datasets/{dataset}/tableSpecs/{table_spec}/columnSpecs/{column_spec} + entity_name: column_spec + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - UNAVAILABLE + - DEADLINE_EXCEEDED + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # + # name - The simple name of the method. + # + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce method + # overloads which allow a client to directly pass request message fields as + # method parameters. This information may or may not be used, depending on + # the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request message. + # + # required_fields - Fields that are always required for a request to be + # valid. + # + # resource_name_treatment - An enum that specifies how to treat the resource + # name formats defined in the field_name_patterns and + # response_field_name_patterns fields. + # UNSET: default value + # NONE: the collection configs will not be used by the generated code. + # VALIDATE: string fields will be validated by the client against the + # specified resource name formats. + # STATIC_TYPES: the client will use generated types for resource names. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a paging + # list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It defines + # which fields match the paging pattern in the request. The request consists + # of a page_size_field and a token_field. The page_size_field is the name of + # the optional field specifying the maximum number of elements to be + # returned in the response. The token_field is the name of the field in the + # request containing the page token. + # The response specifies response information of the list method. It defines + # which fields match the paging pattern in the response. The response + # consists of a token_field and a resources_field. The token_field is the + # name of the field in the response containing the next page token. The + # resources_field is the name of the field in the response containing the + # list of resources belonging to the page. + # + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: CreateDataset + flattening: + groups: + - parameters: + - parent + - dataset + required_fields: + - parent + - dataset + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: location + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + - name: UpdateDataset + flattening: + groups: + - parameters: + - dataset + required_fields: + - dataset + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + dataset.name: dataset + timeout_millis: 5000 + - name: GetDataset + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: dataset + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + - name: ListDatasets + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: datasets + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: location + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + - name: DeleteDataset + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: dataset + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + long_running: + return_type: google.protobuf.Empty + metadata_type: google.cloud.automl.v1beta1.OperationMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + - name: ImportData + flattening: + groups: + - parameters: + - name + - input_config + required_fields: + - name + - input_config + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: dataset + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + long_running: + return_type: google.protobuf.Empty + metadata_type: google.cloud.automl.v1beta1.OperationMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 86400000 + - name: ExportData + flattening: + groups: + - parameters: + - name + - output_config + required_fields: + - name + - output_config + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: dataset + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + long_running: + return_type: google.protobuf.Empty + metadata_type: google.cloud.automl.v1beta1.OperationMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + - name: CreateModel + flattening: + groups: + - parameters: + - parent + - model + required_fields: + - parent + - model + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: location + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + long_running: + return_type: google.cloud.automl.v1beta1.Model + metadata_type: google.cloud.automl.v1beta1.OperationMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 86400000 + - name: GetModel + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: model + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + - name: ListModels + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: model + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: location + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + - name: DeleteModel + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: model + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + long_running: + return_type: google.protobuf.Empty + metadata_type: google.cloud.automl.v1beta1.OperationMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + - name: DeployModel + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: model + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + long_running: + return_type: google.protobuf.Empty + metadata_type: google.cloud.automl.v1beta1.OperationMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 3600000 + - name: UndeployModel + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: model + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + long_running: + return_type: google.protobuf.Empty + metadata_type: google.cloud.automl.v1beta1.OperationMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 3600000 + - name: GetModelEvaluation + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: model_evaluation + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + - name: ExportModel + required_fields: + - name + - output_config + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: model + long_running: + return_type: google.protobuf.Empty + metadata_type: google.cloud.automl.v1beta1.OperationMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + timeout_millis: 5000 + - name: ExportEvaluatedExamples + required_fields: + - name + - output_config + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: model + long_running: + return_type: google.protobuf.Empty + metadata_type: google.cloud.automl.v1beta1.OperationMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + timeout_millis: 5000 + - name: ListModelEvaluations + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: model_evaluation + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: model + resource_name_treatment: STATIC_TYPES + timeout_millis: 5000 + - name: GetAnnotationSpec + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: annotation_spec + timeout_millis: 5000 + - name: GetTableSpec + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: table_spec + timeout_millis: 5000 + - name: ListTableSpecs + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: table_specs + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: dataset + timeout_millis: 5000 + - name: UpdateTableSpec + flattening: + groups: + - parameters: + - table_spec + required_fields: + - table_spec + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + table_spec.name: table_spec + timeout_millis: 5000 + - name: GetColumnSpec + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: column_spec + timeout_millis: 5000 + - name: ListColumnSpecs + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: column_specs + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: table_spec + timeout_millis: 5000 + - name: UpdateColumnSpec + flattening: + groups: + - parameters: + - column_spec + required_fields: + - column_spec + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + column_spec.name: column_spec + timeout_millis: 5000 +resource_name_generation: +- message_name: CreateDatasetRequest + field_entity_map: + parent: location +- message_name: UpdateDatasetRequest + field_entity_map: + dataset.name: dataset +- message_name: GetDatasetRequest + field_entity_map: + name: dataset +- message_name: ListDatasetsRequest + field_entity_map: + parent: location +- message_name: DeleteDatasetRequest + field_entity_map: + name: dataset +- message_name: ImportDataRequest + field_entity_map: + name: dataset +- message_name: ExportDataRequest + field_entity_map: + name: dataset +- message_name: CreateModelRequest + field_entity_map: + parent: location +- message_name: GetModelRequest + field_entity_map: + name: model +- message_name: ListModelsRequest + field_entity_map: + parent: location +- message_name: DeleteModelRequest + field_entity_map: + name: model +- message_name: DeployModelRequest + field_entity_map: + name: model +- message_name: UndeployModelRequest + field_entity_map: + name: model +- message_name: ExportModelRequest + field_entity_map: + name: model +- message_name: ExportEvaluatedExamplesRequest + field_entity_map: + name: model +- message_name: GetModelEvaluationRequest + field_entity_map: + name: model_evaluation +- message_name: ListModelEvaluationsRequest + field_entity_map: + parent: model +- message_name: PredictRequest + field_entity_map: + name: model +- message_name: BatchPredictRequest + field_entity_map: + name: model +- message_name: GetAnnotationSpecRequest + field_entity_map: + name: annotation_spec +- message_name: GetTableSpecRequest + field_entity_map: + name: table_spec +- message_name: ListTableSpecsRequest + field_entity_map: + parent: dataset +- message_name: UpdateTableSpecRequest + field_entity_map: + table_spec.name: table_spec +- message_name: GetColumnSpecRequest + field_entity_map: + name: column_spec +- message_name: ListColumnSpecsRequest + field_entity_map: + parent: table_spec +- message_name: UpdateColumnSpecRequest + field_entity_map: + column_spec.name: column_spec diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/automl_gapic.yaml b/third_party/googleapis/google/cloud/automl/v1beta1/automl_gapic.yaml index 2895ae1be..90d99c485 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/automl_gapic.yaml +++ b/third_party/googleapis/google/cloud/automl/v1beta1/automl_gapic.yaml @@ -1,5 +1,5 @@ type: com.google.api.codegen.ConfigProto -config_schema_version: 1.0.0 +config_schema_version: 2.0.0 # The settings of generated code in a specific language. language_settings: java: @@ -21,27 +21,6 @@ language_settings: interfaces: # The fully qualified name of the API interface. - name: google.cloud.automl.v1beta1.PredictionService - # A list of resource collection configurations. - # Consists of a name_pattern and an entity_name. - # The name_pattern is a pattern to describe the names of the resources of this - # collection, using the platform's conventions for URI patterns. A generator - # may use this to generate methods to compose and decompose such names. The - # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; - # those will be taken as hints for the parameter names of the generated - # methods. If empty, no name methods are generated. - # The entity_name is the name to be used as a basis for generated methods and - # classes. - collections: - - name_pattern: projects/{project}/locations/{location}/models/{model} - entity_name: model - # Definition for retryable codes. - retry_codes_def: - - name: idempotent - retry_codes: - - UNAVAILABLE - - DEADLINE_EXCEEDED - - name: non_idempotent - retry_codes: [] # Definition for retry/backoff parameters. retry_params_def: - name: default @@ -108,90 +87,13 @@ interfaces: # the call is retrying, refer to retry_params_name instead. methods: - name: Predict - flattening: - groups: - - parameters: - - name - - payload - - params - required_fields: - - name - - payload retry_codes_name: non_idempotent retry_params_name: default - field_name_patterns: - name: model - resource_name_treatment: STATIC_TYPES - timeout_millis: 60000 - name: BatchPredict - required_fields: - - name - - input_config - - output_config - flattening: - groups: - - parameters: - - name - - input_config - - output_config - - params retry_codes_name: non_idempotent retry_params_name: default - field_name_patterns: - name: model - long_running: - return_type: google.cloud.automl.v1beta1.BatchPredictResult - metadata_type: google.cloud.automl.v1beta1.OperationMetadata - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - timeout_millis: 20000 # The fully qualified name of the API interface. - name: google.cloud.automl.v1beta1.AutoMl - # A list of resource collection configurations. - # Consists of a name_pattern and an entity_name. - # The name_pattern is a pattern to describe the names of the resources of this - # collection, using the platform's conventions for URI patterns. A generator - # may use this to generate methods to compose and decompose such names. The - # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; - # those will be taken as hints for the parameter names of the generated - # methods. If empty, no name methods are generated. - # The entity_name is the name to be used as a basis for generated methods and - # classes. - collections: - - name_pattern: projects/{project}/locations/{location} - entity_name: location - - name_pattern: projects/{project}/locations/{location}/datasets/{dataset} - entity_name: dataset - - name_pattern: projects/{project}/locations/{location}/models/{model} - entity_name: model - - name_pattern: projects/{project}/locations/{location}/models/{model}/modelEvaluations/{model_evaluation} - entity_name: model_evaluation - - name_pattern: projects/{project}/locations/{location}/datasets/{dataset}/annotationSpecs/{annotation_spec} - entity_name: annotation_spec - - name_pattern: projects/{project}/locations/{location}/datasets/{dataset}/tableSpecs/{table_spec} - entity_name: table_spec - - name_pattern: projects/{project}/locations/{location}/datasets/{dataset}/tableSpecs/{table_spec}/columnSpecs/{column_spec} - entity_name: column_spec - # Definition for retryable codes. - retry_codes_def: - - name: idempotent - retry_codes: - - UNAVAILABLE - - DEADLINE_EXCEEDED - - name: non_idempotent - retry_codes: [] - # Definition for retry/backoff parameters. - retry_params_def: - - name: default - initial_retry_delay_millis: 100 - retry_delay_multiplier: 1.3 - max_retry_delay_millis: 60000 - initial_rpc_timeout_millis: 20000 - rpc_timeout_multiplier: 1 - max_rpc_timeout_millis: 20000 - total_timeout_millis: 600000 # A list of method configurations. # Common properties: # @@ -247,484 +149,17 @@ interfaces: # timeout_millis - Specifies the default timeout for a non-retrying call. If # the call is retrying, refer to retry_params_name instead. methods: - - name: CreateDataset - flattening: - groups: - - parameters: - - parent - - dataset - required_fields: - - parent - - dataset - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: location - resource_name_treatment: STATIC_TYPES - timeout_millis: 5000 - - name: UpdateDataset - flattening: - groups: - - parameters: - - dataset - required_fields: - - dataset - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - dataset.name: dataset - timeout_millis: 5000 - - name: GetDataset - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: dataset - resource_name_treatment: STATIC_TYPES - timeout_millis: 5000 - - name: ListDatasets - flattening: - groups: - - parameters: - - parent - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: datasets - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: location - resource_name_treatment: STATIC_TYPES - timeout_millis: 5000 - name: DeleteDataset - flattening: - groups: - - parameters: - - name - required_fields: - - name retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: dataset - resource_name_treatment: STATIC_TYPES - timeout_millis: 5000 - long_running: - return_type: google.protobuf.Empty - metadata_type: google.cloud.automl.v1beta1.OperationMetadata - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - name: ImportData - flattening: - groups: - - parameters: - - name - - input_config - required_fields: - - name - - input_config retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - name: dataset - resource_name_treatment: STATIC_TYPES - timeout_millis: 5000 - long_running: - return_type: google.protobuf.Empty - metadata_type: google.cloud.automl.v1beta1.OperationMetadata - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - name: ExportData - flattening: - groups: - - parameters: - - name - - output_config - required_fields: - - name - - output_config - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - name: dataset - resource_name_treatment: STATIC_TYPES - timeout_millis: 5000 - long_running: - return_type: google.protobuf.Empty - metadata_type: google.cloud.automl.v1beta1.OperationMetadata - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - - name: CreateModel - flattening: - groups: - - parameters: - - parent - - model - required_fields: - - parent - - model retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: location - resource_name_treatment: STATIC_TYPES - timeout_millis: 5000 - long_running: - return_type: google.cloud.automl.v1beta1.Model - metadata_type: google.cloud.automl.v1beta1.OperationMetadata - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - - name: GetModel - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: model - resource_name_treatment: STATIC_TYPES - timeout_millis: 5000 - - name: ListModels - flattening: - groups: - - parameters: - - parent - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: model - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: location - resource_name_treatment: STATIC_TYPES - timeout_millis: 5000 - name: DeleteModel - flattening: - groups: - - parameters: - - name - required_fields: - - name retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: model - resource_name_treatment: STATIC_TYPES - timeout_millis: 5000 - long_running: - return_type: google.protobuf.Empty - metadata_type: google.cloud.automl.v1beta1.OperationMetadata - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - - name: DeployModel - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - name: model - resource_name_treatment: STATIC_TYPES - timeout_millis: 5000 - long_running: - return_type: google.protobuf.Empty - metadata_type: google.cloud.automl.v1beta1.OperationMetadata - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - - name: UndeployModel - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - name: model - resource_name_treatment: STATIC_TYPES - timeout_millis: 5000 - long_running: - return_type: google.protobuf.Empty - metadata_type: google.cloud.automl.v1beta1.OperationMetadata - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - - name: GetModelEvaluation - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: model_evaluation - resource_name_treatment: STATIC_TYPES - timeout_millis: 5000 - name: ExportModel - required_fields: - - name - - output_config retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - name: model - long_running: - return_type: google.protobuf.Empty - metadata_type: google.cloud.automl.v1beta1.OperationMetadata - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - timeout_millis: 5000 - name: ExportEvaluatedExamples - required_fields: - - name - - output_config retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - name: model - long_running: - return_type: google.protobuf.Empty - metadata_type: google.cloud.automl.v1beta1.OperationMetadata - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - timeout_millis: 5000 - name: ListModelEvaluations - flattening: - groups: - - parameters: - - parent - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: model_evaluation - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: model - resource_name_treatment: STATIC_TYPES - timeout_millis: 5000 - - name: GetAnnotationSpec - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: annotation_spec - timeout_millis: 5000 - - name: GetTableSpec - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: table_spec - timeout_millis: 5000 - - name: ListTableSpecs - flattening: - groups: - - parameters: - - parent - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: table_specs - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: dataset - timeout_millis: 5000 - - name: UpdateTableSpec - flattening: - groups: - - parameters: - - table_spec - required_fields: - - table_spec - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - table_spec.name: table_spec - timeout_millis: 5000 - - name: GetColumnSpec - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: column_spec - timeout_millis: 5000 - - name: ListColumnSpecs - flattening: - groups: - - parameters: - - parent - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: column_specs - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: table_spec - timeout_millis: 5000 - - name: UpdateColumnSpec - flattening: - groups: - - parameters: - - column_spec - required_fields: - - column_spec retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - column_spec.name: column_spec - timeout_millis: 5000 -resource_name_generation: -- message_name: CreateDatasetRequest - field_entity_map: - parent: location -- message_name: UpdateDatasetRequest - field_entity_map: - dataset.name: dataset -- message_name: GetDatasetRequest - field_entity_map: - name: dataset -- message_name: ListDatasetsRequest - field_entity_map: - parent: location -- message_name: DeleteDatasetRequest - field_entity_map: - name: dataset -- message_name: ImportDataRequest - field_entity_map: - name: dataset -- message_name: ExportDataRequest - field_entity_map: - name: dataset -- message_name: CreateModelRequest - field_entity_map: - parent: location -- message_name: GetModelRequest - field_entity_map: - name: model -- message_name: ListModelsRequest - field_entity_map: - parent: location -- message_name: DeleteModelRequest - field_entity_map: - name: model -- message_name: DeployModelRequest - field_entity_map: - name: model -- message_name: UndeployModelRequest - field_entity_map: - name: model -- message_name: ExportModelRequest - field_entity_map: - name: model -- message_name: ExportEvaluatedExamplesRequest - field_entity_map: - name: model -- message_name: GetModelEvaluationRequest - field_entity_map: - name: model_evaluation -- message_name: ListModelEvaluationsRequest - field_entity_map: - parent: model -- message_name: PredictRequest - field_entity_map: - name: model -- message_name: BatchPredictRequest - field_entity_map: - name: model -- message_name: GetAnnotationSpecRequest - field_entity_map: - name: annotation_spec -- message_name: GetTableSpecRequest - field_entity_map: - name: table_spec -- message_name: ListTableSpecsRequest - field_entity_map: - parent: dataset -- message_name: UpdateTableSpecRequest - field_entity_map: - table_spec.name: table_spec -- message_name: GetColumnSpecRequest - field_entity_map: - name: column_spec -- message_name: ListColumnSpecsRequest - field_entity_map: - parent: table_spec -- message_name: UpdateColumnSpecRequest - field_entity_map: - column_spec.name: column_spec diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/automl_grpc_service_config.json b/third_party/googleapis/google/cloud/automl/v1beta1/automl_grpc_service_config.json new file mode 100755 index 000000000..f008ecc37 --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1beta1/automl_grpc_service_config.json @@ -0,0 +1,133 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.automl.v1beta1.PredictionService", + "method": "Predict" + }, + { + "service": "google.cloud.automl.v1beta1.PredictionService", + "method": "BatchPredict" + } + ], + "timeout": "60s" + }, + { + "name": [ + { + "service": "google.cloud.automl.v1beta1.AutoMl", + "method": "CreateDataset" + }, + { + "service": "google.cloud.automl.v1beta1.AutoMl", + "method": "UpdateDataset" + }, + { + "service": "google.cloud.automl.v1beta1.AutoMl", + "method": "ImportData" + }, + { + "service": "google.cloud.automl.v1beta1.AutoMl", + "method": "ExportData" + }, + { + "service": "google.cloud.automl.v1beta1.AutoMl", + "method": "CreateModel" + }, + { + "service": "google.cloud.automl.v1beta1.AutoMl", + "method": "DeployModel" + }, + { + "service": "google.cloud.automl.v1beta1.AutoMl", + "method": "UndeployModel" + }, + { + "service": "google.cloud.automl.v1beta1.AutoMl", + "method": "ExportModel" + }, + { + "service": "google.cloud.automl.v1beta1.AutoMl", + "method": "ExportEvaluatedExamples" + }, + { + "service": "google.cloud.automl.v1beta1.AutoMl", + "method": "ListModelEvaluations" + }, + { + "service": "google.cloud.automl.v1beta1.AutoMl", + "method": "UpdateTableSpec" + }, + { + "service": "google.cloud.automl.v1beta1.AutoMl", + "method": "UpdateColumnSpec" + } + ], + "timeout": "5s" + }, + { + "name": [ + { + "service": "google.cloud.automl.v1beta1.AutoMl", + "method": "GetDataset" + }, + { + "service": "google.cloud.automl.v1beta1.AutoMl", + "method": "ListDatasets" + }, + { + "service": "google.cloud.automl.v1beta1.AutoMl", + "method": "DeleteDataset" + }, + { + "service": "google.cloud.automl.v1beta1.AutoMl", + "method": "GetModel" + }, + { + "service": "google.cloud.automl.v1beta1.AutoMl", + "method": "ListModels" + }, + { + "service": "google.cloud.automl.v1beta1.AutoMl", + "method": "DeleteModel" + }, + { + "service": "google.cloud.automl.v1beta1.AutoMl", + "method": "GetModelEvaluation" + }, + { + "service": "google.cloud.automl.v1beta1.AutoMl", + "method": "GetAnnotationSpec" + }, + { + "service": "google.cloud.automl.v1beta1.AutoMl", + "method": "GetTableSpec" + }, + { + "service": "google.cloud.automl.v1beta1.AutoMl", + "method": "ListTableSpecs" + }, + { + "service": "google.cloud.automl.v1beta1.AutoMl", + "method": "GetColumnSpec" + }, + { + "service": "google.cloud.automl.v1beta1.AutoMl", + "method": "ListColumnSpecs" + } + ], + "timeout": "5s", + "retryPolicy": { + "maxAttempts": 5, + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/automl_v1beta1.yaml b/third_party/googleapis/google/cloud/automl/v1beta1/automl_v1beta1.yaml new file mode 100644 index 000000000..179829f8c --- /dev/null +++ b/third_party/googleapis/google/cloud/automl/v1beta1/automl_v1beta1.yaml @@ -0,0 +1,127 @@ +type: google.api.Service +config_version: 3 +name: automl.googleapis.com +title: Cloud AutoML API + +apis: +- name: google.cloud.automl.v1beta1.AutoMl +- name: google.cloud.automl.v1beta1.PredictionService + +types: +- name: google.cloud.automl.v1beta1.BatchPredictResult +- name: google.cloud.automl.v1beta1.OperationMetadata + +documentation: + summary: |- + Train high-quality custom machine learning models with minimum effort and + machine learning expertise. + overview: |- + Cloud AutoML is a suite of machine learning products that enables + developers with limited machine learning expertise to train high-quality + models specific to their business needs, by leveraging Google's + state-of-the-art transfer learning, and Neural Architecture Search + technology. + rules: + - selector: google.iam.v1.IAMPolicy.GetIamPolicy + description: |- + Gets the access control policy for a resource. Returns an empty policy + if the resource exists and does not have a policy set. + + - selector: google.iam.v1.IAMPolicy.SetIamPolicy + description: |- + Sets the access control policy on the specified resource. Replaces + any existing policy. + + Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and + PERMISSION_DENIED + + - selector: google.iam.v1.IAMPolicy.TestIamPermissions + description: |- + Returns permissions that a caller has on the specified resource. If the + resource does not exist, this will return an empty set of + permissions, not a NOT_FOUND error. + + Note: This operation is designed to be used for building + permission-aware UIs and command-line tools, not for authorization + checking. This operation may "fail open" without warning. + +backend: + rules: + - selector: 'google.cloud.automl.v1beta1.AutoMl.*' + deadline: 5.0 + - selector: google.cloud.automl.v1beta1.AutoMl.CreateModel + deadline: 20.0 + - selector: google.cloud.automl.v1beta1.AutoMl.ImportData + deadline: 20.0 + - selector: google.cloud.automl.v1beta1.AutoMl.ListDatasets + deadline: 50.0 + - selector: google.cloud.automl.v1beta1.AutoMl.ListModelEvaluations + deadline: 50.0 + - selector: google.cloud.automl.v1beta1.AutoMl.ListModels + deadline: 50.0 + - selector: google.cloud.automl.v1beta1.PredictionService.BatchPredict + deadline: 20.0 + - selector: google.cloud.automl.v1beta1.PredictionService.Predict + deadline: 60.0 + - selector: 'google.iam.v1.IAMPolicy.*' + deadline: 5.0 + - selector: 'google.longrunning.Operations.*' + deadline: 5.0 + - selector: google.longrunning.Operations.ListOperations + deadline: 50.0 + - selector: google.longrunning.Operations.WaitOperation + deadline: 300.0 + +http: + rules: + - selector: google.longrunning.Operations.ListOperations + get: '/v1beta1/{name=projects/*/locations/*}/operations' + + - selector: google.longrunning.Operations.GetOperation + get: '/v1beta1/{name=projects/*/locations/*/operations/*}' + + - selector: google.longrunning.Operations.DeleteOperation + delete: '/v1beta1/{name=projects/*/locations/*/operations/*}' + + - selector: google.longrunning.Operations.CancelOperation + post: '/v1beta1/{name=projects/*/locations/*/operations/*}:cancel' + body: '*' + + - selector: google.iam.v1.IAMPolicy.SetIamPolicy + post: '/v1beta1/{resource=projects/*/locations/*/datasets/*}:setIamPolicy' + body: '*' + additional_bindings: + - post: '/v1beta1/{resource=projects/*/locations/*/models/*}:setIamPolicy' + body: '*' + + - selector: google.iam.v1.IAMPolicy.GetIamPolicy + get: '/v1beta1/{resource=projects/*/locations/*/datasets/*}:getIamPolicy' + additional_bindings: + - get: '/v1beta1/{resource=projects/*/locations/*/models/*}:getIamPolicy' + + - selector: google.iam.v1.IAMPolicy.TestIamPermissions + post: '/v1beta1/{resource=projects/*/locations/*/**}:testIamPermissions' + body: '*' + +authentication: + rules: + - selector: 'google.cloud.automl.v1beta1.AutoMl.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: google.cloud.automl.v1beta1.PredictionService.BatchPredict + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: google.cloud.automl.v1beta1.PredictionService.Predict + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: 'google.iam.v1.IAMPolicy.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: 'google.longrunning.Operations.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/classification.proto b/third_party/googleapis/google/cloud/automl/v1beta1/classification.proto index 9d588c152..0594d01e6 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/classification.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/classification.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -164,11 +163,20 @@ message ClassificationEvaluationMetrics { // only list of [annotation_spec_display_name-s][] is populated. repeated string annotation_spec_id = 1; + // Output only. Display name of the annotation specs used in the confusion + // matrix, as they were at the moment of the evaluation. For Tables + // CLASSIFICATION + // + // [prediction_type-s][google.cloud.automl.v1beta1.TablesModelMetadata.prediction_type], + // distinct values of the target column at the moment of the model + // evaluation are populated here. + repeated string display_name = 3; + // Output only. Rows in the confusion matrix. The number of rows is equal to // the size of `annotation_spec_id`. - // `row[i].value[j]` is the number of examples that have ground truth of the - // `annotation_spec_id[i]` and are predicted as `annotation_spec_id[j]` by - // the model being evaluated. + // `row[i].example_count[j]` is the number of examples that have ground + // truth of the `annotation_spec_id[i]` and are predicted as + // `annotation_spec_id[j]` by the model being evaluated. repeated Row row = 2; } diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/column_spec.proto b/third_party/googleapis/google/cloud/automl/v1beta1/column_spec.proto index 8a3b52110..03389b8a4 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/column_spec.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/column_spec.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,12 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.automl.v1beta1; +import "google/api/resource.proto"; import "google/cloud/automl/v1beta1/data_stats.proto"; import "google/cloud/automl/v1beta1/data_types.proto"; import "google/api/annotations.proto"; @@ -32,6 +32,11 @@ option ruby_package = "Google::Cloud::AutoML::V1beta1"; // Used by: // * Tables message ColumnSpec { + option (google.api.resource) = { + type: "automl.googleapis.com/ColumnSpec" + pattern: "projects/{project}/locations/{location}/datasets/{dataset}/tableSpecs/{table_spec}/columnSpecs/{column_spec}" + }; + // Identifies the table's column, and its correlation with the column this // ColumnSpec describes. message CorrelatedColumn { @@ -64,12 +69,7 @@ message ColumnSpec { // for the timestamp at which these stats were last updated. DataStats data_stats = 4; - // Output only. Top 10 most correlated with this column columns of the table, - // ordered by - // [cramers_v][google.cloud.automl.v1beta1.CorrelationStats.cramers_v] metric. - // This field may be stale, see the ancestor's - // Dataset.tables_dataset_metadata.stats_update_time field - // for the timestamp at which these stats were last updated. + // Deprecated. repeated CorrelatedColumn top_correlated_columns = 5; // Used to perform consistent read-modify-write updates. If not set, a blind diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/data_items.proto b/third_party/googleapis/google/cloud/automl/v1beta1/data_items.proto index a1ad57214..9b9187ad3 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/data_items.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/data_items.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,15 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.automl.v1beta1; +import "google/cloud/automl/v1beta1/geometry.proto"; import "google/cloud/automl/v1beta1/io.proto"; +import "google/cloud/automl/v1beta1/temporal.proto"; +import "google/cloud/automl/v1beta1/text_segment.proto"; import "google/protobuf/any.proto"; import "google/protobuf/duration.proto"; import "google/protobuf/struct.proto"; @@ -33,9 +35,9 @@ option ruby_package = "Google::Cloud::AutoML::V1beta1"; // Only images up to 30MB in size are supported. message Image { // Input only. The data representing the image. - // For Predict calls [image_bytes][] must be set, as other options are not + // For Predict calls [image_bytes][google.cloud.automl.v1beta1.Image.image_bytes] must be set, as other options are not // currently supported by prediction API. You can read the contents of an - // uploaded image by using the [content_uri][] field. + // uploaded image by using the [content_uri][google.cloud.automl.v1beta1.Image.content_uri] field. oneof data { // Image content represented as a stream of bytes. // Note: As with all `bytes` fields, protobuffers use a pure binary @@ -56,26 +58,134 @@ message TextSnippet { // characters long. string content = 1; - // The format of the source text. Currently the only two allowed values are - // "text/html" and "text/plain". If left blank the format is automatically - // determined from the type of the uploaded content. + // Optional. The format of [content][google.cloud.automl.v1beta1.TextSnippet.content]. Currently the only two allowed + // values are "text/html" and "text/plain". If left blank, the format is + // automatically determined from the type of the uploaded [content][google.cloud.automl.v1beta1.TextSnippet.content]. string mime_type = 2; // Output only. HTTP URI where you can download the content. string content_uri = 4; } +// Message that describes dimension of a document. +message DocumentDimensions { + // Unit of the document dimension. + enum DocumentDimensionUnit { + // Should not be used. + DOCUMENT_DIMENSION_UNIT_UNSPECIFIED = 0; + + // Document dimension is measured in inches. + INCH = 1; + + // Document dimension is measured in centimeters. + CENTIMETER = 2; + + // Document dimension is measured in points. 72 points = 1 inch. + POINT = 3; + } + + // Unit of the dimension. + DocumentDimensionUnit unit = 1; + + // Width value of the document, works together with the unit. + float width = 2; + + // Height value of the document, works together with the unit. + float height = 3; +} + // A structured text document e.g. a PDF. message Document { + // Describes the layout information of a [text_segment][google.cloud.automl.v1beta1.Document.Layout.text_segment] in the document. + message Layout { + // The type of TextSegment in the context of the original document. + enum TextSegmentType { + // Should not be used. + TEXT_SEGMENT_TYPE_UNSPECIFIED = 0; + + // The text segment is a token. e.g. word. + TOKEN = 1; + + // The text segment is a paragraph. + PARAGRAPH = 2; + + // The text segment is a form field. + FORM_FIELD = 3; + + // The text segment is the name part of a form field. It will be treated + // as child of another FORM_FIELD TextSegment if its span is subspan of + // another TextSegment with type FORM_FIELD. + FORM_FIELD_NAME = 4; + + // The text segment is the text content part of a form field. It will be + // treated as child of another FORM_FIELD TextSegment if its span is + // subspan of another TextSegment with type FORM_FIELD. + FORM_FIELD_CONTENTS = 5; + + // The text segment is a whole table, including headers, and all rows. + TABLE = 6; + + // The text segment is a table's headers. It will be treated as child of + // another TABLE TextSegment if its span is subspan of another TextSegment + // with type TABLE. + TABLE_HEADER = 7; + + // The text segment is a row in table. It will be treated as child of + // another TABLE TextSegment if its span is subspan of another TextSegment + // with type TABLE. + TABLE_ROW = 8; + + // The text segment is a cell in table. It will be treated as child of + // another TABLE_ROW TextSegment if its span is subspan of another + // TextSegment with type TABLE_ROW. + TABLE_CELL = 9; + } + + // Text Segment that represents a segment in + // [document_text][google.cloud.automl.v1beta1.Document.document_text]. + TextSegment text_segment = 1; + + // Page number of the [text_segment][google.cloud.automl.v1beta1.Document.Layout.text_segment] in the original document, starts + // from 1. + int32 page_number = 2; + + // The position of the [text_segment][google.cloud.automl.v1beta1.Document.Layout.text_segment] in the page. + // Contains exactly 4 + // + // [normalized_vertices][google.cloud.automl.v1beta1.BoundingPoly.normalized_vertices] + // and they are connected by edges in the order provided, which will + // represent a rectangle parallel to the frame. The + // [NormalizedVertex-s][google.cloud.automl.v1beta1.NormalizedVertex] are + // relative to the page. + // Coordinates are based on top-left as point (0,0). + BoundingPoly bounding_poly = 3; + + // The type of the [text_segment][google.cloud.automl.v1beta1.Document.Layout.text_segment] in document. + TextSegmentType text_segment_type = 4; + } + // An input config specifying the content of the document. DocumentInputConfig input_config = 1; + + // The plain text version of this document. + TextSnippet document_text = 2; + + // Describes the layout of the document. + // Sorted by [page_number][]. + repeated Layout layout = 3; + + // The dimensions of the page in the document. + DocumentDimensions document_dimensions = 4; + + // Number of pages in the document. + int32 page_count = 5; } // A representation of a row in a relational table. message Row { - // Input Only. // The resource IDs of the column specs describing the columns of the row. - // If set must contain, but possibly in a different order, all input feature + // If set must contain, but possibly in a different order, all input + // feature // // [column_spec_ids][google.cloud.automl.v1beta1.TablesModelMetadata.input_feature_column_specs] // of the Model this row is being passed to. @@ -83,9 +193,9 @@ message Row { // field is set. repeated string column_spec_ids = 2; - // Input Only. - // The values of the row cells, given in the same order as the - // column_spec_ids, or, if not set, then in the same order as input feature + // Required. The values of the row cells, given in the same order as the + // column_spec_ids, or, if not set, then in the same order as input + // feature // // [column_specs][google.cloud.automl.v1beta1.TablesModelMetadata.input_feature_column_specs] // of the Model this row is being passed to. diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/data_stats.proto b/third_party/googleapis/google/cloud/automl/v1beta1/data_stats.proto index 5d941a5ba..c13a5d451 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/data_stats.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/data_stats.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/data_types.proto b/third_party/googleapis/google/cloud/automl/v1beta1/data_types.proto index e97314508..6f77f56b9 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/data_types.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/data_types.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -27,14 +26,6 @@ option ruby_package = "Google::Cloud::AutoML::V1beta1"; // `TypeCode` is used as a part of // [DataType][google.cloud.automl.v1beta1.DataType]. -// -// Each legal value of a DataType can be encoded to or decoded from a JSON -// value, using the encodings listed below, and definitions of which can be -// found at -// -// https: -// //developers.google.com/protocol-buffers -// // /docs/reference/google.protobuf#value. enum TypeCode { // Not specified. Should not be used. TYPE_CODE_UNSPECIFIED = 0; diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/dataset.proto b/third_party/googleapis/google/cloud/automl/v1beta1/dataset.proto index e07b17841..8d1b8d937 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/dataset.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/dataset.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,12 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.automl.v1beta1; +import "google/api/resource.proto"; import "google/cloud/automl/v1beta1/image.proto"; import "google/cloud/automl/v1beta1/tables.proto"; import "google/cloud/automl/v1beta1/text.proto"; @@ -34,6 +34,11 @@ option ruby_package = "Google::Cloud::AutoML::V1beta1"; // A workspace for solving a single, particular machine learning (ML) problem. // A workspace contains examples that may be annotated. message Dataset { + option (google.api.resource) = { + type: "automl.googleapis.com/Dataset" + pattern: "projects/{project}/locations/{location}/datasets/{dataset}" + }; + // Required. // The dataset metadata that is specific to the problem type. oneof dataset_metadata { diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/detection.proto b/third_party/googleapis/google/cloud/automl/v1beta1/detection.proto index 66f0b2fc1..c5864e209 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/detection.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/detection.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -29,20 +28,17 @@ option ruby_package = "Google::Cloud::AutoML::V1beta1"; // Annotation details for image object detection. message ImageObjectDetectionAnnotation { - // Output only. - // The rectangle representing the object location. + // Output only. The rectangle representing the object location. BoundingPoly bounding_box = 1; - // Output only. - // The confidence that this annotation is positive for the parent example, + // Output only. The confidence that this annotation is positive for the parent example, // value in [0, 1], higher means higher positivity confidence. float score = 2; } // Annotation details for video object tracking. message VideoObjectTrackingAnnotation { - // Optional. - // The instance of the object, expressed as a positive integer. Used to tell + // Optional. The instance of the object, expressed as a positive integer. Used to tell // apart objects of the same type (i.e. AnnotationSpec) when multiple are // present on a single example. // NOTE: Instance ID prediction quality is not a part of model evaluation and @@ -59,8 +55,7 @@ message VideoObjectTrackingAnnotation { // at the time_offset of the video). BoundingPoly bounding_box = 3; - // Output only. - // The confidence that this annotation is positive for the video at + // Output only. The confidence that this annotation is positive for the video at // the time_offset, value in [0, 1], higher means higher positivity // confidence. For annotations created by the user the score is 1. When // user approves an annotation, the original float score is kept (and not diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/geometry.proto b/third_party/googleapis/google/cloud/automl/v1beta1/geometry.proto index e5379ab14..d5654aaca 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/geometry.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/geometry.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/image.proto b/third_party/googleapis/google/cloud/automl/v1beta1/image.proto index c1596c634..960eaeb01 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/image.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/image.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,12 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.automl.v1beta1; +import "google/api/resource.proto"; import "google/cloud/automl/v1beta1/annotation_spec.proto"; import "google/cloud/automl/v1beta1/classification.proto"; import "google/protobuf/timestamp.proto"; @@ -96,6 +96,15 @@ message ImageClassificationModelMetadata { // should also have a higher prediction quality than other // models. string model_type = 7; + + // Output only. An approximate number of online prediction QPS that can + // be supported by this model per each node on which it is deployed. + double node_qps = 13; + + // Output only. The number of nodes this model is deployed on. A node is an + // abstraction of a machine resource, which can handle online prediction QPS + // as given in the node_qps field. + int64 node_count = 14; } // Model metadata specific to image object detection. @@ -108,6 +117,21 @@ message ImageObjectDetectionModelMetadata { // * `cloud-low-latency-1` - A model to be used via prediction // calls to AutoML API. Expected to have low latency, but may // have lower prediction quality than other models. + // * `mobile-low-latency-1` - A model that, in addition to providing + // prediction via AutoML API, can also be exported (see + // [AutoMl.ExportModel][google.cloud.automl.v1beta1.AutoMl.ExportModel]) and used on a mobile or edge device + // with TensorFlow afterwards. Expected to have low latency, but + // may have lower prediction quality than other models. + // * `mobile-versatile-1` - A model that, in addition to providing + // prediction via AutoML API, can also be exported (see + // [AutoMl.ExportModel][google.cloud.automl.v1beta1.AutoMl.ExportModel]) and used on a mobile or edge device + // with TensorFlow afterwards. + // * `mobile-high-accuracy-1` - A model that, in addition to providing + // prediction via AutoML API, can also be exported (see + // [AutoMl.ExportModel][google.cloud.automl.v1beta1.AutoMl.ExportModel]) and used on a mobile or edge device + // with TensorFlow afterwards. Expected to have a higher + // latency, but should also have a higher prediction quality + // than other models. string model_type = 1; // Output only. The number of nodes this model is deployed on. A node is an @@ -128,9 +152,16 @@ message ImageObjectDetectionModelMetadata { // `train_cost` will be equal or less than this value. If further model // training ceases to provide any improvements, it will stop without using // full budget and the stop_reason will be `MODEL_CONVERGED`. - // Note, node_hour = actual_hour * number_of_nodes_invovled. The train budget - // must be between 20,000 and 2,000,000 milli node hours, inclusive. The - // default value is 216, 000 which represents one day in wall time. + // Note, node_hour = actual_hour * number_of_nodes_invovled. + // For model type `cloud-high-accuracy-1`(default) and `cloud-low-latency-1`, + // the train budget must be between 20,000 and 900,000 milli node hours, + // inclusive. The default value is 216, 000 which represents one day in + // wall time. + // For model type `mobile-low-latency-1`, `mobile-versatile-1`, + // `mobile-high-accuracy-1`, `mobile-core-ml-low-latency-1`, + // `mobile-core-ml-versatile-1`, `mobile-core-ml-high-accuracy-1`, the train + // budget must be between 1,000 and 100,000 milli node hours, inclusive. + // The default value is 24, 000 which represents one day in wall time. int64 train_budget_milli_node_hours = 6; // Output only. The actual train cost of creating this model, expressed in @@ -139,6 +170,17 @@ message ImageObjectDetectionModelMetadata { int64 train_cost_milli_node_hours = 7; } +// Model deployment metadata specific to Image Classification. +message ImageClassificationModelDeploymentMetadata { + // Input only. The number of nodes to deploy the model on. A node is an + // abstraction of a machine resource, which can handle online prediction QPS + // as given in the model's + // + // [node_qps][google.cloud.automl.v1beta1.ImageClassificationModelMetadata.node_qps]. + // Must be between 1 and 100, inclusive on both ends. + int64 node_count = 1; +} + // Model deployment metadata specific to Image Object Detection. message ImageObjectDetectionModelDeploymentMetadata { // Input only. The number of nodes to deploy the model on. A node is an diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/io.proto b/third_party/googleapis/google/cloud/automl/v1beta1/io.proto index cab08b3b7..a99793830 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/io.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/io.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -32,10 +31,10 @@ option ruby_package = "Google::Cloud::AutoML::V1beta1"; // [gcs_source][google.cloud.automl.v1beta1.InputConfig.gcs_source] // is expected, unless specified otherwise. Additionally any input .CSV file // by itself must be 100MB or smaller, unless specified otherwise. -// If an "example" file (i.e. image, video etc.) with identical content +// If an "example" file (that is, image, video etc.) with identical content // (even if it had different GCS_FILE_PATH) is mentioned multiple times, then // its label, bounding boxes etc. are appended. The same file should be always -// provided with the same ML_USE and GCS_FILE_PATH, if it is not then +// provided with the same ML_USE and GCS_FILE_PATH, if it is not, then // these values are nondeterministically selected from the given ones. // // The formats are represented in EBNF with commas being literal and with @@ -65,12 +64,16 @@ option ruby_package = "Google::Cloud::AutoML::V1beta1"; // BOUNDING_BOX-es per image are allowed (one BOUNDING_BOX is defined // per line). If an image has not yet been labeled, then it should be // mentioned just once with no LABEL and the ",,,,,,," in place of the +// BOUNDING_BOX. For images which are known to not contain any +// bounding boxes, they should be labelled explictly as +// "NEGATIVE_IMAGE", followed by ",,,,,,," in place of the // BOUNDING_BOX. -// Four sample rows: +// Sample rows: // TRAIN,gs://folder/image1.png,car,0.1,0.1,,,0.3,0.3,, // TRAIN,gs://folder/image1.png,bike,.7,.6,,,.8,.9,, // UNASSIGNED,gs://folder/im2.png,car,0.1,0.1,0.2,0.1,0.2,0.3,0.1,0.3 // TEST,gs://folder/im3.png,,,,,,,,, +// TRAIN,gs://folder/im4.png,NEGATIVE_IMAGE,,,,,,,,, // // * For Video Classification: // CSV file(s) with each line in format: @@ -135,21 +138,26 @@ option ruby_package = "Google::Cloud::AutoML::V1beta1"; // * For Text Extraction: // CSV file(s) with each line in format: // ML_USE,GCS_FILE_PATH -// GCS_FILE_PATH leads to a .JSONL (i.e. JSON Lines) file which either -// imports text in-line or as documents. +// GCS_FILE_PATH leads to a .JSONL (that is, JSON Lines) file which +// either imports text in-line or as documents. Any given +// .JSONL file must be 100MB or smaller. // The in-line .JSONL file contains, per line, a proto that wraps a -// TextSnippet proto (in json representation) followed by one or -// more AnnotationPayload protos (called annotations), which have -// display_name and text_extraction detail populated. -// The given text is expected to be annotated exhaustively, e.g. if -// you look for animals and text contains "dolphin" that is not -// labeled, then "dolphin" will be assumed to not be an animal. Any -// given text snippet content must have 30,000 characters or less, -// and also be UTF-8 NFC encoded (ASCII already is). The document .JSONL file contains, per line, a proto that wraps a -// Document proto with input_config set. Only PDF documents are -// supported now, and each document may be up to 2MB large. -// Currently annotations on documents cannot be specified at import. -// Any given .JSONL file must be 100MB or smaller. +// TextSnippet proto (in json representation) followed by one or more +// AnnotationPayload protos (called annotations), which have +// display_name and text_extraction detail populated. The given text +// is expected to be annotated exhaustively, for example, if you look +// for animals and text contains "dolphin" that is not labeled, then +// "dolphin" is assumed to not be an animal. Any given text snippet +// content must be 10KB or smaller, and also be UTF-8 NFC encoded +// (ASCII already is). +// The document .JSONL file contains, per line, a proto that wraps a +// Document proto. The Document proto must have either document_text +// or input_config set. In document_text case, the Document proto may +// also contain the spatial information of the document, including +// layout, document dimension and page number. In input_config case, +// only PDF documents are supported now, and each document may be up +// to 2MB large. Currently, annotations on documents cannot be +// specified at import. // Three sample CSV rows: // TRAIN,gs://folder/file1.jsonl // VALIDATE,gs://folder/file2.jsonl @@ -158,27 +166,61 @@ option ruby_package = "Google::Cloud::AutoML::V1beta1"; // with artificial line breaks, but the only actual line break is // denoted by \n).: // { -// "text_snippet": { -// "content": "dog car cat" -// } "annotations": [ -// { -// "display_name": "animal", -// "text_extraction": { -// "text_segment": {"start_offset": 0, "end_offset": 3} +// "document": { +// "document_text": {"content": "dog cat"} +// "layout": [ +// { +// "text_segment": { +// "start_offset": 0, +// "end_offset": 3, +// }, +// "page_number": 1, +// "bounding_poly": { +// "normalized_vertices": [ +// {"x": 0.1, "y": 0.1}, +// {"x": 0.1, "y": 0.3}, +// {"x": 0.3, "y": 0.3}, +// {"x": 0.3, "y": 0.1}, +// ], +// }, +// "text_segment_type": TOKEN, +// }, +// { +// "text_segment": { +// "start_offset": 4, +// "end_offset": 7, +// }, +// "page_number": 1, +// "bounding_poly": { +// "normalized_vertices": [ +// {"x": 0.4, "y": 0.1}, +// {"x": 0.4, "y": 0.3}, +// {"x": 0.8, "y": 0.3}, +// {"x": 0.8, "y": 0.1}, +// ], +// }, +// "text_segment_type": TOKEN, // } -// }, +// +// ], +// "document_dimensions": { +// "width": 8.27, +// "height": 11.69, +// "unit": INCH, +// } +// "page_count": 1, +// }, +// "annotations": [ // { -// "display_name": "vehicle", -// "text_extraction": { -// "text_segment": {"start_offset": 4, "end_offset": 7} -// } +// "display_name": "animal", +// "text_extraction": {"text_segment": {"start_offset": 0, +// "end_offset": 3}} // }, // { // "display_name": "animal", -// "text_extraction": { -// "text_segment": {"start_offset": 8, "end_offset": 11} -// } -// }, +// "text_extraction": {"text_segment": {"start_offset": 4, +// "end_offset": 7}} +// } // ], // }\n // { @@ -219,44 +261,44 @@ option ruby_package = "Google::Cloud::AutoML::V1beta1"; // TEXT_SNIPPET and GCS_FILE_PATH are distinguished by a pattern. If // the column content is a valid gcs file path, i.e. prefixed by // "gs://", it will be treated as a GCS_FILE_PATH, else if the content -// is enclosed within double quotes (""), it will -// be treated as a TEXT_SNIPPET. In the GCS_FILE_PATH case, the path -// must lead to a .txt file with UTF-8 encoding, e.g. -// "gs://folder/content.txt", and the content in it will be extracted +// is enclosed within double quotes (""), it is +// treated as a TEXT_SNIPPET. In the GCS_FILE_PATH case, the path +// must lead to a .txt file with UTF-8 encoding, for example, +// "gs://folder/content.txt", and the content in it is extracted // as a text snippet. In TEXT_SNIPPET case, the column content -// excluding quotes will be treated as to be imported text snippet. In +// excluding quotes is treated as to be imported text snippet. In // both cases, the text snippet/file size must be within 128kB. // Maximum 100 unique labels are allowed per CSV row. -// Four sample rows: -// TRAIN,"They have bad food and very rude",RudeService,BadFood -// TRAIN,gs://folder/content.txt,SlowService -// TEST,"Typically always bad service there.",RudeService -// VALIDATE,"Stomach ache to go.",BadFood +// Sample rows: +// TRAIN,"They have bad food and very rude",RudeService,BadFood +// TRAIN,gs://folder/content.txt,SlowService +// TEST,"Typically always bad service there.",RudeService +// VALIDATE,"Stomach ache to go.",BadFood // // * For Text Sentiment: // CSV file(s) with each line in format: // ML_USE,(TEXT_SNIPPET | GCS_FILE_PATH),SENTIMENT // TEXT_SNIPPET and GCS_FILE_PATH are distinguished by a pattern. If -// the column content is a valid gcs file path, i.e. prefixed by -// "gs://", it will be treated as a GCS_FILE_PATH, otherwise it will -// be treated as a TEXT_SNIPPET. In the GCS_FILE_PATH case, the path -// must lead to a .txt file with UTF-8 encoding, e.g. -// "gs://folder/content.txt", and the content in it will be extracted +// the column content is a valid gcs file path, that is, prefixed by +// "gs://", it is treated as a GCS_FILE_PATH, otherwise it is treated +// as a TEXT_SNIPPET. In the GCS_FILE_PATH case, the path +// must lead to a .txt file with UTF-8 encoding, for example, +// "gs://folder/content.txt", and the content in it is extracted // as a text snippet. In TEXT_SNIPPET case, the column content itself -// will be treated as to be imported text snippet. In both cases, the +// is treated as to be imported text snippet. In both cases, the // text snippet must be up to 500 characters long. -// Four sample rows: -// TRAIN,"@freewrytin God is way too good for Claritin",2 -// TRAIN,"I need Claritin so bad",3 -// TEST,"Thank god for Claritin.",4 -// VALIDATE,gs://folder/content.txt,2 +// Sample rows: +// TRAIN,"@freewrytin this is way too good for your product",2 +// TRAIN,"I need this product so bad",3 +// TEST,"Thank you for this product.",4 +// VALIDATE,gs://folder/content.txt,2 // // * For Tables: // Either // [gcs_source][google.cloud.automl.v1beta1.InputConfig.gcs_source] or // // [bigquery_source][google.cloud.automl.v1beta1.InputConfig.bigquery_source] -// can be used. All inputs will be concatenated into a single +// can be used. All inputs is concatenated into a single // // [primary_table][google.cloud.automl.v1beta1.TablesDatasetMetadata.primary_table_name] // For gcs_source: @@ -279,7 +321,6 @@ option ruby_package = "Google::Cloud::AutoML::V1beta1"; // An imported table must have between 2 and 1,000 columns, inclusive, // and between 1000 and 100,000,000 rows, inclusive. There are at most 5 // import data running in parallel. -// // Definitions: // ML_USE = "TRAIN" | "VALIDATE" | "TEST" | "UNASSIGNED" // Describes how the given example (file) should be used for model @@ -338,7 +379,7 @@ option ruby_package = "Google::Cloud::AutoML::V1beta1"; // If any of the provided CSV files can't be parsed or if more than certain // percent of CSV rows cannot be processed then the operation fails and // nothing is imported. Regardless of overall success or failure the per-row -// failures, up to a certain count cap, will be listed in +// failures, up to a certain count cap, is listed in // Operation.metadata.partial_failures. // message InputConfig { @@ -375,6 +416,28 @@ message InputConfig { // The formats are represented in EBNF with commas being literal and with // non-terminal symbols defined near the end of this comment. The formats // are: +// +// * For Image Classification: +// CSV file(s) with each line having just a single column: +// GCS_FILE_PATH +// which leads to image of up to 30MB in size. Supported +// extensions: .JPEG, .GIF, .PNG. This path is treated as the ID in +// the Batch predict output. +// Three sample rows: +// gs://folder/image1.jpeg +// gs://folder/image2.gif +// gs://folder/image3.png +// +// * For Image Object Detection: +// CSV file(s) with each line having just a single column: +// GCS_FILE_PATH +// which leads to image of up to 30MB in size. Supported +// extensions: .JPEG, .GIF, .PNG. This path is treated as the ID in +// the Batch predict output. +// Three sample rows: +// gs://folder/image1.jpeg +// gs://folder/image2.gif +// gs://folder/image3.png // * For Video Classification: // CSV file(s) with each line in format: // GCS_FILE_PATH,TIME_SEGMENT_START,TIME_SEGMENT_END @@ -398,6 +461,28 @@ message InputConfig { // gs://folder/video1.mp4,10,240 // gs://folder/video1.mp4,300,360 // gs://folder/vid2.mov,0,inf +// * For Text Classification: +// CSV file(s) with each line having just a single column: +// GCS_FILE_PATH | TEXT_SNIPPET +// Any given text file can have size upto 128kB. +// Any given text snippet content must have 60,000 characters or less. +// Three sample rows: +// gs://folder/text1.txt +// "Some text content to predict" +// gs://folder/text3.pdf +// Supported file extensions: .txt, .pdf +// +// * For Text Sentiment: +// CSV file(s) with each line having just a single column: +// GCS_FILE_PATH | TEXT_SNIPPET +// Any given text file can have size upto 128kB. +// Any given text snippet content must have 500 characters or less. +// Three sample rows: +// gs://folder/text1.txt +// "Some text content to predict" +// gs://folder/text3.pdf +// Supported file extensions: .txt, .pdf +// // * For Text Extraction // .JSONL (i.e. JSON Lines) file(s) which either provide text in-line or // as documents (for a single BatchPredict call only one of the these @@ -470,101 +555,51 @@ message InputConfig { // 100GB or smaller, where first file must have a header containing // column names. If the first row of a subsequent file is the same as // the header, then it is also treated as a header. All other rows -// contain values for the corresponding columns. For all -// CLASSIFICATION and REGRESSION -// -// [prediction_type-s][google.cloud.automl.v1beta1.TablesModelMetadata.prediction_type]: -// The column names must contain the model's +// contain values for the corresponding columns. +// The column names must contain the model's // // [input_feature_column_specs'][google.cloud.automl.v1beta1.TablesModelMetadata.input_feature_column_specs] // // [display_name-s][google.cloud.automl.v1beta1.ColumnSpec.display_name] -// (order doesn't matter). The columns corresponding to the model's -// input feature column specs must contain values compatible with -// the column spec's data types. Prediction on all the rows, i.e. -// the CSV lines, will be attempted. First three sample rows of a -// CSV file: +// (order doesn't matter). The columns corresponding to the model's +// input feature column specs must contain values compatible with the +// column spec's data types. Prediction on all the rows, i.e. the CSV +// lines, will be attempted. For FORECASTING +// +// [prediction_type][google.cloud.automl.v1beta1.TablesModelMetadata.prediction_type]: +// all columns having +// +// [TIME_SERIES_AVAILABLE_PAST_ONLY][google.cloud.automl.v1beta1.ColumnSpec.ForecastingMetadata.ColumnType] +// type will be ignored. +// First three sample rows of a CSV file: // "First Name","Last Name","Dob","Addresses" // // "John","Doe","1968-01-22","[{"status":"current","address":"123_First_Avenue","city":"Seattle","state":"WA","zip":"11111","numberOfYears":"1"},{"status":"previous","address":"456_Main_Street","city":"Portland","state":"OR","zip":"22222","numberOfYears":"5"}]" // // "Jane","Doe","1980-10-16","[{"status":"current","address":"789_Any_Avenue","city":"Albany","state":"NY","zip":"33333","numberOfYears":"2"},{"status":"previous","address":"321_Main_Street","city":"Hoboken","state":"NJ","zip":"44444","numberOfYears":"3"}]} -// For FORECASTING -// -// [prediction_type][google.cloud.automl.v1beta1.TablesModelMetadata.prediction_type]: -// The column names must contain the union of the model's -// -// [input_feature_column_specs'][google.cloud.automl.v1beta1.TablesModelMetadata.input_feature_column_specs] -// -// [display_name-s][google.cloud.automl.v1beta1.ColumnSpec.display_name] -// and -// -// [target_column_specs'][google.cloud.automl.v1beta1.TablesModelMetadata.target_column_spec] -// -// [display_name][google.cloud.automl.v1beta1.ColumnSpec.display_name] -// (order doesn't matter), with values compatible with these column -// specs data types, except as specified below. -// The input rows must contain not only the to-be-predicted rows -// but also the historical data rows, even if they would be -// identical as the ones on which the model has been trained. -// The historical rows must have non-NULL target column -// values. The to-be-predicted rows must have NULL values in the -// target column and all columns having -// -// [TIME_SERIES_AVAILABLE_PAST_ONLY][google.cloud.automl.v1beta1.ColumnSpec.ForecastingMetadata.ColumnType.KEY] -// type, regardless if these columns are -// [nullable][google.cloud.automl.v1beta1.DataType.nullable]. -// Prediction only on the to-be-predicted rows will be attempted. -// First four sample rows of a CSV file: -// -// "Year","City","OlympicsThatYear","Population","WaterUsedGigaGallons" -// "2000","NYC","true","8008278","452.7" -// "2001","NYC","false","8024963","432.2" -// "2002","NYC","true","","" // BigQuery case: // An URI of a BigQuery table. The user data size of the BigQuery // table must be 100GB or smaller. -// For all CLASSIFICATION and REGRESSION -// -// [prediction_type-s][google.cloud.automl.v1beta1.TablesModelMetadata.prediction_type]: -// The column names must contain the model's +// The column names must contain the model's // // [input_feature_column_specs'][google.cloud.automl.v1beta1.TablesModelMetadata.input_feature_column_specs] // // [display_name-s][google.cloud.automl.v1beta1.ColumnSpec.display_name] -// (order doesn't matter). The columns corresponding to the model's -// input feature column specs must contain values compatible with -// the column spec's data types. Prediction on all the rows of the -// table will be attempted. -// For FORECASTING +// (order doesn't matter). The columns corresponding to the model's +// input feature column specs must contain values compatible with the +// column spec's data types. Prediction on all the rows of the table +// will be attempted. For FORECASTING // // [prediction_type][google.cloud.automl.v1beta1.TablesModelMetadata.prediction_type]: -// The column names must contain the union of the model's +// all columns having // -// [input_feature_column_specs'][google.cloud.automl.v1beta1.TablesModelMetadata.input_feature_column_specs] -// -// [display_name-s][google.cloud.automl.v1beta1.ColumnSpec.display_name] -// and -// -// [target_column_specs'][google.cloud.automl.v1beta1.TablesModelMetadata.target_column_spec] -// -// [display_name][google.cloud.automl.v1beta1.ColumnSpec.display_name] -// (order doesn't matter), with values compatible with these column -// specs data types, except as specified below. -// The table's rows must contain not only the to-be-predicted rows -// but also the historical data rows, even if they would be -// identical as the ones on which the model has been trained. -// The historical rows must have non-NULL target column values. -// The to-be-predicted rows must have NULL values in the -// target column and all columns having -// -// [TIME_SERIES_AVAILABLE_PAST_ONLY][google.cloud.automl.v1beta1.ColumnSpec.ForecastingMetadata.ColumnType.KEY] -// type, regardless if these columns are -// [nullable][google.cloud.automl.v1beta1.DataType.nullable]. -// Prediction only on the to-be-predicted rows will be attempted. +// [TIME_SERIES_AVAILABLE_PAST_ONLY][google.cloud.automl.v1beta1.ColumnSpec.ForecastingMetadata.ColumnType] +// type will be ignored. // // Definitions: // GCS_FILE_PATH = A path to file on GCS, e.g. "gs://folder/video.avi". +// TEXT_SNIPPET = A content of a text snippet, UTF-8 encoded, enclosed within +// double quotes ("") // TIME_SEGMENT_START = TIME_OFFSET // Expresses a beginning, inclusive, of a time segment // within an @@ -656,11 +691,55 @@ message OutputConfig { // // [gcs_destination][google.cloud.automl.v1beta1.BatchPredictOutputConfig.gcs_destination] // must be set unless specified otherwise for a domain. If gcs_destination is -// set then in the given directory a new directory will be created. Its name +// set then in the given directory a new directory is created. Its name // will be // "prediction--", // where timestamp is in YYYY-MM-DDThh:mm:ss.sssZ ISO-8601 format. The contents // of it depends on the ML problem the predictions are made for. +// +// * For Image Classification: +// In the created directory files `image_classification_1.jsonl`, +// `image_classification_2.jsonl`,...,`image_classification_N.jsonl` +// will be created, where N may be 1, and depends on the +// total number of the successfully predicted images and annotations. +// A single image will be listed only once with all its annotations, +// and its annotations will never be split across files. +// Each .JSONL file will contain, per line, a JSON representation of a +// proto that wraps image's "ID" : "" followed by a list of +// zero or more AnnotationPayload protos (called annotations), which +// have classification detail populated. +// If prediction for any image failed (partially or completely), then an +// additional `errors_1.jsonl`, `errors_2.jsonl`,..., `errors_N.jsonl` +// files will be created (N depends on total number of failed +// predictions). These files will have a JSON representation of a proto +// that wraps the same "ID" : "" but here followed by +// exactly one +// +// [`google.rpc.Status`](https: +// //github.com/googleapis/googleapis/blob/master/google/rpc/status.proto) +// containing only `code` and `message`fields. +// +// * For Image Object Detection: +// In the created directory files `image_object_detection_1.jsonl`, +// `image_object_detection_2.jsonl`,...,`image_object_detection_N.jsonl` +// will be created, where N may be 1, and depends on the +// total number of the successfully predicted images and annotations. +// Each .JSONL file will contain, per line, a JSON representation of a +// proto that wraps image's "ID" : "" followed by a list of +// zero or more AnnotationPayload protos (called annotations), which +// have image_object_detection detail populated. A single image will +// be listed only once with all its annotations, and its annotations +// will never be split across files. +// If prediction for any image failed (partially or completely), then +// additional `errors_1.jsonl`, `errors_2.jsonl`,..., `errors_N.jsonl` +// files will be created (N depends on total number of failed +// predictions). These files will have a JSON representation of a proto +// that wraps the same "ID" : "" but here followed by +// exactly one +// +// [`google.rpc.Status`](https: +// //github.com/googleapis/googleapis/blob/master/google/rpc/status.proto) +// containing only `code` and `message`fields. // * For Video Classification: // In the created directory a video_classification.csv file, and a .JSON // file per each video classification requested in the input (i.e. each @@ -713,6 +792,54 @@ message OutputConfig { // for each frame of the video time segment the file is assigned to in // video_object_tracking.csv. All AnnotationPayload protos will have // video_object_tracking field set. +// * For Text Classification: +// In the created directory files `text_classification_1.jsonl`, +// `text_classification_2.jsonl`,...,`text_classification_N.jsonl` +// will be created, where N may be 1, and depends on the +// total number of inputs and annotations found. +// +// Each .JSONL file will contain, per line, a JSON representation of a +// proto that wraps input text snippet or input text file and a list of +// zero or more AnnotationPayload protos (called annotations), which +// have classification detail populated. A single text snippet or file +// will be listed only once with all its annotations, and its +// annotations will never be split across files. +// +// If prediction for any text snippet or file failed (partially or +// completely), then additional `errors_1.jsonl`, `errors_2.jsonl`,..., +// `errors_N.jsonl` files will be created (N depends on total number of +// failed predictions). These files will have a JSON representation of a +// proto that wraps input text snippet or input text file followed by +// exactly one +// +// [`google.rpc.Status`](https: +// //github.com/googleapis/googleapis/blob/master/google/rpc/status.proto) +// containing only `code` and `message`. +// +// * For Text Sentiment: +// In the created directory files `text_sentiment_1.jsonl`, +// `text_sentiment_2.jsonl`,...,`text_sentiment_N.jsonl` +// will be created, where N may be 1, and depends on the +// total number of inputs and annotations found. +// +// Each .JSONL file will contain, per line, a JSON representation of a +// proto that wraps input text snippet or input text file and a list of +// zero or more AnnotationPayload protos (called annotations), which +// have text_sentiment detail populated. A single text snippet or file +// will be listed only once with all its annotations, and its +// annotations will never be split across files. +// +// If prediction for any text snippet or file failed (partially or +// completely), then additional `errors_1.jsonl`, `errors_2.jsonl`,..., +// `errors_N.jsonl` files will be created (N depends on total number of +// failed predictions). These files will have a JSON representation of a +// proto that wraps input text snippet or input text file followed by +// exactly one +// +// [`google.rpc.Status`](https: +// //github.com/googleapis/googleapis/blob/master/google/rpc/status.proto) +// containing only `code` and `message`. +// // * For Text Extraction: // In the created directory files `text_extraction_1.jsonl`, // `text_extraction_2.jsonl`,...,`text_extraction_N.jsonl` @@ -722,7 +849,8 @@ message OutputConfig { // used inline text, or documents. // If input was inline, then each .JSONL file will contain, per line, // a JSON representation of a proto that wraps given in request text -// snippet's "id" : "" followed by a list of zero or more +// snippet's "id" (if specified), followed by input text snippet, +// and a list of zero or more // AnnotationPayload protos (called annotations), which have // text_extraction detail populated. A single text snippet will be // listed only once with all its annotations, and its annotations will @@ -857,7 +985,7 @@ message ModelExportOutputConfig { oneof destination { // The Google Cloud Storage location where the model is to be written to. // This location may only be set for the following model formats: - // "tflite", "edgetpu_tflite", "core_ml", "docker". + // "tflite", "edgetpu_tflite", "tf_saved_model", "tf_js", "core_ml". // // Under the directory given as the destination a new one with name // "model-export--", @@ -881,7 +1009,8 @@ message ModelExportOutputConfig { // // * For Image Classification mobile-low-latency-1, mobile-versatile-1, // mobile-high-accuracy-1: - // "tflite" (default), "edgetpu_tflite", "tf_saved_model", "docker". + // "tflite" (default), "edgetpu_tflite", "tf_saved_model", "tf_js", + // "docker". // // * For Image Classification mobile-core-ml-low-latency-1, // mobile-core-ml-versatile-1, mobile-core-ml-high-accuracy-1: @@ -892,10 +1021,15 @@ message ModelExportOutputConfig { // * edgetpu_tflite - Used for [Edge TPU](https://cloud.google.com/edge-tpu/) // devices. // * tf_saved_model - A tensorflow model in SavedModel format. + // * tf_js - A [TensorFlow.js](https://www.tensorflow.org/js) model that can + // be used in the browser and in Node.js using JavaScript. // * docker - Used for Docker containers. Use the params field to customize // the container. The container is verified to work correctly on // ubuntu 16.04 operating system. See more at - // [containers quickstart](https://cloud.google.com/vision/automl/docs/containers-gcs-quickstart) + // [containers + // + // quickstart](https: + // //cloud.google.com/vision/automl/docs/containers-gcs-quickstart) // * core_ml - Used for iOS mobile devices. string model_format = 4; diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/model.proto b/third_party/googleapis/google/cloud/automl/v1beta1/model.proto index ecac533e1..2b2e8d73f 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/model.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/model.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,12 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.automl.v1beta1; +import "google/api/resource.proto"; import "google/cloud/automl/v1beta1/image.proto"; import "google/cloud/automl/v1beta1/tables.proto"; import "google/cloud/automl/v1beta1/text.proto"; @@ -33,6 +33,11 @@ option ruby_package = "Google::Cloud::AutoML::V1beta1"; // API proto representing a trained machine learning model. message Model { + option (google.api.resource) = { + type: "automl.googleapis.com/Model" + pattern: "projects/{project}/locations/{location}/models/{model}" + }; + // Deployment state of the model. enum DeploymentState { // Should not be used, an un-set enum has this value by default. @@ -77,8 +82,7 @@ message Model { TextSentimentModelMetadata text_sentiment_model_metadata = 22; } - // Output only. - // Resource name of the model. + // Output only. Resource name of the model. // Format: `projects/{project_id}/locations/{location_id}/models/{model_id}` string name = 1; @@ -88,17 +92,14 @@ message Model { // (_), and ASCII digits 0-9. It must start with a letter. string display_name = 2; - // Required. - // The resource ID of the dataset used to create the model. The dataset must + // Required. The resource ID of the dataset used to create the model. The dataset must // come from the same ancestor project and location. string dataset_id = 3; - // Output only. - // Timestamp when the model training finished and can be used for prediction. + // Output only. Timestamp when the model training finished and can be used for prediction. google.protobuf.Timestamp create_time = 7; - // Output only. - // Timestamp when this model was last updated. + // Output only. Timestamp when this model was last updated. google.protobuf.Timestamp update_time = 11; // Output only. Deployment state of the model. A model can only serve diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/model_evaluation.proto b/third_party/googleapis/google/cloud/automl/v1beta1/model_evaluation.proto index f84ae62f6..d5633fcdf 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/model_evaluation.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/model_evaluation.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,12 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.automl.v1beta1; +import "google/api/resource.proto"; import "google/cloud/automl/v1beta1/classification.proto"; import "google/cloud/automl/v1beta1/detection.proto"; import "google/cloud/automl/v1beta1/regression.proto"; @@ -35,6 +35,11 @@ option ruby_package = "Google::Cloud::AutoML::V1beta1"; // Evaluation results of a model. message ModelEvaluation { + option (google.api.resource) = { + type: "automl.googleapis.com/ModelEvaluation" + pattern: "projects/{project}/locations/{location}/models/{model}/modelEvaluations/{model_evaluation}" + }; + // Output only. Problem type specific evaluation metrics. oneof metrics { // Model evaluation metrics for image, text, video and tables @@ -64,15 +69,13 @@ message ModelEvaluation { TextExtractionEvaluationMetrics text_extraction_evaluation_metrics = 13; } - // Output only. - // Resource name of the model evaluation. + // Output only. Resource name of the model evaluation. // Format: // // `projects/{project_id}/locations/{location_id}/models/{model_id}/modelEvaluations/{model_evaluation_id}` string name = 1; - // Output only. - // The ID of the annotation spec that the model evaluation applies to. The + // Output only. The ID of the annotation spec that the model evaluation applies to. The // The ID is empty for the overall model evaluation. // For Tables annotation specs in the dataset do not exist and this ID is // always not set, but for CLASSIFICATION @@ -84,7 +87,7 @@ message ModelEvaluation { string annotation_spec_id = 2; // Output only. The value of - // [display_name][google.cloud.automl.v1beta1.AnnotationSpec.dispay_name] at + // [display_name][google.cloud.automl.v1beta1.AnnotationSpec.display_name] at // the moment when the model was trained. Because this field returns a value // at model training time, for different models trained from the same dataset, // the values may differ, since display names could had been changed between @@ -97,12 +100,10 @@ message ModelEvaluation { // The display_name is empty for the overall model evaluation. string display_name = 15; - // Output only. - // Timestamp when this model evaluation was created. + // Output only. Timestamp when this model evaluation was created. google.protobuf.Timestamp create_time = 5; - // Output only. - // The number of examples used for model evaluation, i.e. for + // Output only. The number of examples used for model evaluation, i.e. for // which ground truth from time of model creation is compared against the // predicted annotations created by the model. // For overall ModelEvaluation (i.e. with annotation_spec_id not set) this is diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/operations.proto b/third_party/googleapis/google/cloud/automl/v1beta1/operations.proto index aba18cd67..cce3fedc5 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/operations.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/operations.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/prediction_service.proto b/third_party/googleapis/google/cloud/automl/v1beta1/prediction_service.proto index b45f35316..0bcf685e0 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/prediction_service.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/prediction_service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,19 +11,20 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.automl.v1beta1; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/cloud/automl/v1beta1/annotation_payload.proto"; import "google/cloud/automl/v1beta1/data_items.proto"; import "google/cloud/automl/v1beta1/io.proto"; import "google/cloud/automl/v1beta1/operations.proto"; import "google/longrunning/operations.proto"; -import "google/api/client.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl"; option java_multiple_files = true; @@ -57,11 +58,14 @@ service PredictionService { // up to 5MB. Not available for FORECASTING // // [prediction_type][google.cloud.automl.v1beta1.TablesModelMetadata.prediction_type]. + // * Text Sentiment - TextSnippet, content up 500 characters, UTF-8 + // encoded. rpc Predict(PredictRequest) returns (PredictResponse) { option (google.api.http) = { post: "/v1beta1/{name=projects/*/locations/*/models/*}:predict" body: "*" }; + option (google.api.method_signature) = "name,payload,params"; } // Perform a batch prediction. Unlike the online [Predict][google.cloud.automl.v1beta1.PredictionService.Predict], batch @@ -71,27 +75,37 @@ service PredictionService { // method. Once the operation is done, [BatchPredictResult][google.cloud.automl.v1beta1.BatchPredictResult] is returned in // the [response][google.longrunning.Operation.response] field. // Available for following ML problems: + // * Image Classification + // * Image Object Detection // * Video Classification - // * Video Object Tracking - // * Text Extraction + // * Video Object Tracking * Text Extraction // * Tables rpc BatchPredict(BatchPredictRequest) returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1beta1/{name=projects/*/locations/*/models/*}:batchPredict" body: "*" }; + option (google.api.method_signature) = "name,input_config,output_config,params"; + option (google.longrunning.operation_info) = { + response_type: "BatchPredictResult" + metadata_type: "OperationMetadata" + }; } } // Request message for [PredictionService.Predict][google.cloud.automl.v1beta1.PredictionService.Predict]. message PredictRequest { - // Name of the model requested to serve the prediction. - string name = 1; + // Required. Name of the model requested to serve the prediction. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Model" + } + ]; - // Required. - // Payload to perform a prediction on. The payload must match the + // Required. Payload to perform a prediction on. The payload must match the // problem type that the model was trained to solve. - ExamplePayload payload = 2; + ExamplePayload payload = 2 [(google.api.field_behavior) = REQUIRED]; // Additional domain-specific parameters, any string must be up to 25000 // characters long. @@ -101,13 +115,17 @@ message PredictRequest { // `score_threshold` - (float) A value from 0.0 to 1.0. When the model // makes predictions for an image, it will only produce results that have // at least this confidence score. The default is 0.5. - // * For Tables: - // `feature_importance` - (boolean) Whether // - // [feature_importance][[google.cloud.automl.v1beta1.TablesModelColumnInfo.feature_importance] - // should be populated in the returned - // - // [TablesAnnotation(-s)][[google.cloud.automl.v1beta1.TablesAnnotation]. + // * For Image Object Detection: + // `score_threshold` - (float) When Model detects objects on the image, + // it will only produce bounding boxes which have at least this + // confidence score. Value in 0 to 1 range, default is 0.5. + // `max_bounding_box_count` - (int64) No more than this number of bounding + // boxes will be returned in the response. Default is 100, the + // requested value may be limited by server. + // * For Tables: + // feature_importance - (boolean) Whether feature importance + // should be populated in the returned TablesAnnotation. // The default is false. map params = 3; } @@ -118,6 +136,13 @@ message PredictResponse { // Translation and Text Sentiment will return precisely one payload. repeated AnnotationPayload payload = 1; + // The preprocessed example that AutoML actually makes prediction on. + // Empty if AutoML does not preprocess the input example. + // * For Text Extraction: + // If the input is a .pdf file, the OCR'ed text will be provided in + // [document_text][google.cloud.automl.v1beta1.Document.document_text]. + ExamplePayload preprocessed_input = 3; + // Additional domain-specific prediction response metadata. // // * For Image Object Detection: @@ -138,20 +163,47 @@ message PredictResponse { // Request message for [PredictionService.BatchPredict][google.cloud.automl.v1beta1.PredictionService.BatchPredict]. message BatchPredictRequest { - // Name of the model requested to serve the batch prediction. - string name = 1; + // Required. Name of the model requested to serve the batch prediction. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Model" + } + ]; // Required. The input configuration for batch prediction. - BatchPredictInputConfig input_config = 3; + BatchPredictInputConfig input_config = 3 [(google.api.field_behavior) = REQUIRED]; // Required. The Configuration specifying where output predictions should // be written. - BatchPredictOutputConfig output_config = 4; + BatchPredictOutputConfig output_config = 4 [(google.api.field_behavior) = REQUIRED]; - // Additional domain-specific parameters for the predictions, any string must + // Required. Additional domain-specific parameters for the predictions, any string must // be up to 25000 characters long. // + // * For Text Classification: + // + // `score_threshold` - (float) A value from 0.0 to 1.0. When the model + // makes predictions for a text snippet, it will only produce results + // that have at least this confidence score. The default is 0.5. + // + // * For Image Classification: + // + // `score_threshold` - (float) A value from 0.0 to 1.0. When the model + // makes predictions for an image, it will only produce results that + // have at least this confidence score. The default is 0.5. + // + // * For Image Object Detection: + // + // `score_threshold` - (float) When Model detects objects on the image, + // it will only produce bounding boxes which have at least this + // confidence score. Value in 0 to 1 range, default is 0.5. + // `max_bounding_box_count` - (int64) No more than this number of bounding + // boxes will be produced per image. Default is 100, the + // requested value may be limited by server. + // // * For Video Classification : + // // `score_threshold` - (float) A value from 0.0 to 1.0. When the model // makes predictions for a video, it will only produce results that // have at least this confidence score. The default is 0.5. @@ -179,7 +231,14 @@ message BatchPredictRequest { // metrics provided to describe that quality. The default is // "false". // + // * For Tables: + // + // feature_importance - (boolean) Whether feature importance + // should be populated in the returned TablesAnnotations. The + // default is false. + // // * For Video Object Tracking: + // // `score_threshold` - (float) When Model detects objects on video frames, // it will only produce bounding boxes which have at least this // confidence score. Value in 0 to 1 range, default is 0.5. @@ -189,13 +248,21 @@ message BatchPredictRequest { // `min_bounding_box_size` - (float) Only bounding boxes with shortest edge // at least that long as a relative value of video frame size will be // returned. Value in 0 to 1 range. Default is 0. - // - map params = 5; + map params = 5 [(google.api.field_behavior) = REQUIRED]; } // Result of the Batch Predict. This message is returned in // [response][google.longrunning.Operation.response] of the operation returned // by the [PredictionService.BatchPredict][google.cloud.automl.v1beta1.PredictionService.BatchPredict]. message BatchPredictResult { - + // Additional domain-specific prediction response metadata. + // + // * For Image Object Detection: + // `max_bounding_box_count` - (int64) At most that many bounding boxes per + // image could have been returned. + // + // * For Video Object Tracking: + // `max_bounding_box_count` - (int64) At most that many bounding boxes per + // frame could have been returned. + map metadata = 1; } diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/ranges.proto b/third_party/googleapis/google/cloud/automl/v1beta1/ranges.proto index 6a1d66fa0..89572bb05 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/ranges.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/ranges.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/regression.proto b/third_party/googleapis/google/cloud/automl/v1beta1/regression.proto index d2b96af13..1286d3d80 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/regression.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/regression.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/service.proto b/third_party/googleapis/google/cloud/automl/v1beta1/service.proto index 323bf0626..a421ece14 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/service.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/service.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,15 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.automl.v1beta1; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/cloud/automl/v1beta1/annotation_payload.proto"; import "google/cloud/automl/v1beta1/annotation_spec.proto"; import "google/cloud/automl/v1beta1/column_spec.proto"; @@ -30,7 +32,6 @@ import "google/cloud/automl/v1beta1/operations.proto"; import "google/cloud/automl/v1beta1/table_spec.proto"; import "google/longrunning/operations.proto"; import "google/protobuf/field_mask.proto"; -import "google/api/client.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/automl/v1beta1;automl"; option java_multiple_files = true; @@ -63,6 +64,7 @@ service AutoMl { post: "/v1beta1/{parent=projects/*/locations/*}/datasets" body: "dataset" }; + option (google.api.method_signature) = "parent,dataset"; } // Gets a dataset. @@ -70,6 +72,7 @@ service AutoMl { option (google.api.http) = { get: "/v1beta1/{name=projects/*/locations/*/datasets/*}" }; + option (google.api.method_signature) = "name"; } // Lists datasets in a project. @@ -77,6 +80,7 @@ service AutoMl { option (google.api.http) = { get: "/v1beta1/{parent=projects/*/locations/*}/datasets" }; + option (google.api.method_signature) = "parent"; } // Updates a dataset. @@ -85,6 +89,7 @@ service AutoMl { patch: "/v1beta1/{dataset.name=projects/*/locations/*/datasets/*}" body: "dataset" }; + option (google.api.method_signature) = "dataset"; } // Deletes a dataset and all of its contents. @@ -96,6 +101,11 @@ service AutoMl { option (google.api.http) = { delete: "/v1beta1/{name=projects/*/locations/*/datasets/*}" }; + option (google.api.method_signature) = "name"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "OperationMetadata" + }; } // Imports data into a dataset. @@ -112,6 +122,11 @@ service AutoMl { post: "/v1beta1/{name=projects/*/locations/*/datasets/*}:importData" body: "*" }; + option (google.api.method_signature) = "name,input_config"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "OperationMetadata" + }; } // Exports dataset's data to the provided output location. @@ -122,6 +137,11 @@ service AutoMl { post: "/v1beta1/{name=projects/*/locations/*/datasets/*}:exportData" body: "*" }; + option (google.api.method_signature) = "name,output_config"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "OperationMetadata" + }; } // Gets an annotation spec. @@ -129,6 +149,7 @@ service AutoMl { option (google.api.http) = { get: "/v1beta1/{name=projects/*/locations/*/datasets/*/annotationSpecs/*}" }; + option (google.api.method_signature) = "name"; } // Gets a table spec. @@ -136,6 +157,7 @@ service AutoMl { option (google.api.http) = { get: "/v1beta1/{name=projects/*/locations/*/datasets/*/tableSpecs/*}" }; + option (google.api.method_signature) = "name"; } // Lists table specs in a dataset. @@ -143,6 +165,7 @@ service AutoMl { option (google.api.http) = { get: "/v1beta1/{parent=projects/*/locations/*/datasets/*}/tableSpecs" }; + option (google.api.method_signature) = "parent"; } // Updates a table spec. @@ -151,6 +174,7 @@ service AutoMl { patch: "/v1beta1/{table_spec.name=projects/*/locations/*/datasets/*/tableSpecs/*}" body: "table_spec" }; + option (google.api.method_signature) = "table_spec"; } // Gets a column spec. @@ -158,6 +182,7 @@ service AutoMl { option (google.api.http) = { get: "/v1beta1/{name=projects/*/locations/*/datasets/*/tableSpecs/*/columnSpecs/*}" }; + option (google.api.method_signature) = "name"; } // Lists column specs in a table spec. @@ -165,6 +190,7 @@ service AutoMl { option (google.api.http) = { get: "/v1beta1/{parent=projects/*/locations/*/datasets/*/tableSpecs/*}/columnSpecs" }; + option (google.api.method_signature) = "parent"; } // Updates a column spec. @@ -173,6 +199,7 @@ service AutoMl { patch: "/v1beta1/{column_spec.name=projects/*/locations/*/datasets/*/tableSpecs/*/columnSpecs/*}" body: "column_spec" }; + option (google.api.method_signature) = "column_spec"; } // Creates a model. @@ -185,6 +212,11 @@ service AutoMl { post: "/v1beta1/{parent=projects/*/locations/*}/models" body: "model" }; + option (google.api.method_signature) = "parent,model"; + option (google.longrunning.operation_info) = { + response_type: "Model" + metadata_type: "OperationMetadata" + }; } // Gets a model. @@ -192,6 +224,7 @@ service AutoMl { option (google.api.http) = { get: "/v1beta1/{name=projects/*/locations/*/models/*}" }; + option (google.api.method_signature) = "name"; } // Lists models. @@ -199,6 +232,7 @@ service AutoMl { option (google.api.http) = { get: "/v1beta1/{parent=projects/*/locations/*}/models" }; + option (google.api.method_signature) = "parent"; } // Deletes a model. @@ -210,6 +244,11 @@ service AutoMl { option (google.api.http) = { delete: "/v1beta1/{name=projects/*/locations/*/models/*}" }; + option (google.api.method_signature) = "name"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "OperationMetadata" + }; } // Deploys a model. If a model is already deployed, deploying it with the @@ -219,8 +258,8 @@ service AutoMl { // [node_number][google.cloud.automl.v1beta1.ImageObjectDetectionModelDeploymentMetadata.node_number]) // will reset the deployment state without pausing the model's availability. // - // Only applicable for Text Classification, Image Object Detection and Tables; - // all other domains manage deployment automatically. + // Only applicable for Text Classification, Image Object Detection , Tables, and Image Segmentation; all other domains manage + // deployment automatically. // // Returns an empty response in the // [response][google.longrunning.Operation.response] field when it completes. @@ -229,6 +268,11 @@ service AutoMl { post: "/v1beta1/{name=projects/*/locations/*/models/*}:deploy" body: "*" }; + option (google.api.method_signature) = "name"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "OperationMetadata" + }; } // Undeploys a model. If the model is not deployed this method has no effect. @@ -243,6 +287,11 @@ service AutoMl { post: "/v1beta1/{name=projects/*/locations/*/models/*}:undeploy" body: "*" }; + option (google.api.method_signature) = "name"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "OperationMetadata" + }; } // Exports a trained, "export-able", model to a user specified Google Cloud @@ -258,6 +307,11 @@ service AutoMl { post: "/v1beta1/{name=projects/*/locations/*/models/*}:export" body: "*" }; + option (google.api.method_signature) = "name,output_config"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "OperationMetadata" + }; } // Exports examples on which the model was evaluated (i.e. which were in the @@ -279,6 +333,11 @@ service AutoMl { post: "/v1beta1/{name=projects/*/locations/*/models/*}:exportEvaluatedExamples" body: "*" }; + option (google.api.method_signature) = "name,output_config"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "OperationMetadata" + }; } // Gets a model evaluation. @@ -286,6 +345,7 @@ service AutoMl { option (google.api.http) = { get: "/v1beta1/{name=projects/*/locations/*/models/*/modelEvaluations/*}" }; + option (google.api.method_signature) = "name"; } // Lists model evaluations. @@ -293,28 +353,44 @@ service AutoMl { option (google.api.http) = { get: "/v1beta1/{parent=projects/*/locations/*/models/*}/modelEvaluations" }; + option (google.api.method_signature) = "parent"; } } // Request message for [AutoMl.CreateDataset][google.cloud.automl.v1beta1.AutoMl.CreateDataset]. message CreateDatasetRequest { - // The resource name of the project to create the dataset for. - string parent = 1; - - // The dataset to create. - Dataset dataset = 2; + // Required. The resource name of the project to create the dataset for. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "locations.googleapis.com/Location" + } + ]; + + // Required. The dataset to create. + Dataset dataset = 2 [(google.api.field_behavior) = REQUIRED]; } // Request message for [AutoMl.GetDataset][google.cloud.automl.v1beta1.AutoMl.GetDataset]. message GetDatasetRequest { - // The resource name of the dataset to retrieve. - string name = 1; + // Required. The resource name of the dataset to retrieve. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Dataset" + } + ]; } // Request message for [AutoMl.ListDatasets][google.cloud.automl.v1beta1.AutoMl.ListDatasets]. message ListDatasetsRequest { - // The resource name of the project from which to list datasets. - string parent = 1; + // Required. The resource name of the project from which to list datasets. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "locations.googleapis.com/Location" + } + ]; // An expression for filtering the results of the request. // @@ -348,54 +424,74 @@ message ListDatasetsResponse { // Request message for [AutoMl.UpdateDataset][google.cloud.automl.v1beta1.AutoMl.UpdateDataset] message UpdateDatasetRequest { - // The dataset which replaces the resource on the server. - Dataset dataset = 1; + // Required. The dataset which replaces the resource on the server. + Dataset dataset = 1 [(google.api.field_behavior) = REQUIRED]; - // The update mask applies to the resource. For the `FieldMask` definition, - // see - // - // https: - // //developers.google.com/protocol-buffers - // // /docs/reference/google.protobuf#fieldmask + // The update mask applies to the resource. google.protobuf.FieldMask update_mask = 2; } // Request message for [AutoMl.DeleteDataset][google.cloud.automl.v1beta1.AutoMl.DeleteDataset]. message DeleteDatasetRequest { - // The resource name of the dataset to delete. - string name = 1; + // Required. The resource name of the dataset to delete. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Dataset" + } + ]; } // Request message for [AutoMl.ImportData][google.cloud.automl.v1beta1.AutoMl.ImportData]. message ImportDataRequest { // Required. Dataset name. Dataset must already exist. All imported // annotations and examples will be added. - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Dataset" + } + ]; // Required. The desired input location and its domain specific semantics, // if any. - InputConfig input_config = 3; + InputConfig input_config = 3 [(google.api.field_behavior) = REQUIRED]; } // Request message for [AutoMl.ExportData][google.cloud.automl.v1beta1.AutoMl.ExportData]. message ExportDataRequest { // Required. The resource name of the dataset. - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Dataset" + } + ]; // Required. The desired output location. - OutputConfig output_config = 3; + OutputConfig output_config = 3 [(google.api.field_behavior) = REQUIRED]; } // Request message for [AutoMl.GetAnnotationSpec][google.cloud.automl.v1beta1.AutoMl.GetAnnotationSpec]. message GetAnnotationSpecRequest { - // The resource name of the annotation spec to retrieve. - string name = 1; + // Required. The resource name of the annotation spec to retrieve. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/AnnotationSpec" + } + ]; } // Request message for [AutoMl.GetTableSpec][google.cloud.automl.v1beta1.AutoMl.GetTableSpec]. message GetTableSpecRequest { - // The resource name of the table spec to retrieve. - string name = 1; + // Required. The resource name of the table spec to retrieve. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/TableSpec" + } + ]; // Mask specifying which fields to read. google.protobuf.FieldMask field_mask = 2; @@ -403,8 +499,13 @@ message GetTableSpecRequest { // Request message for [AutoMl.ListTableSpecs][google.cloud.automl.v1beta1.AutoMl.ListTableSpecs]. message ListTableSpecsRequest { - // The resource name of the dataset to list table specs from. - string parent = 1; + // Required. The resource name of the dataset to list table specs from. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Dataset" + } + ]; // Mask specifying which fields to read. google.protobuf.FieldMask field_mask = 2; @@ -435,22 +536,22 @@ message ListTableSpecsResponse { // Request message for [AutoMl.UpdateTableSpec][google.cloud.automl.v1beta1.AutoMl.UpdateTableSpec] message UpdateTableSpecRequest { - // The table spec which replaces the resource on the server. - TableSpec table_spec = 1; + // Required. The table spec which replaces the resource on the server. + TableSpec table_spec = 1 [(google.api.field_behavior) = REQUIRED]; - // The update mask applies to the resource. For the `FieldMask` definition, - // see - // - // https: - // //developers.google.com/protocol-buffers - // // /docs/reference/google.protobuf#fieldmask + // The update mask applies to the resource. google.protobuf.FieldMask update_mask = 2; } // Request message for [AutoMl.GetColumnSpec][google.cloud.automl.v1beta1.AutoMl.GetColumnSpec]. message GetColumnSpecRequest { - // The resource name of the column spec to retrieve. - string name = 1; + // Required. The resource name of the column spec to retrieve. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/ColumnSpec" + } + ]; // Mask specifying which fields to read. google.protobuf.FieldMask field_mask = 2; @@ -458,8 +559,13 @@ message GetColumnSpecRequest { // Request message for [AutoMl.ListColumnSpecs][google.cloud.automl.v1beta1.AutoMl.ListColumnSpecs]. message ListColumnSpecsRequest { - // The resource name of the table spec to list column specs from. - string parent = 1; + // Required. The resource name of the table spec to list column specs from. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/TableSpec" + } + ]; // Mask specifying which fields to read. google.protobuf.FieldMask field_mask = 2; @@ -490,37 +596,47 @@ message ListColumnSpecsResponse { // Request message for [AutoMl.UpdateColumnSpec][google.cloud.automl.v1beta1.AutoMl.UpdateColumnSpec] message UpdateColumnSpecRequest { - // The column spec which replaces the resource on the server. - ColumnSpec column_spec = 1; + // Required. The column spec which replaces the resource on the server. + ColumnSpec column_spec = 1 [(google.api.field_behavior) = REQUIRED]; - // The update mask applies to the resource. For the `FieldMask` definition, - // see - // - // https: - // //developers.google.com/protocol-buffers - // // /docs/reference/google.protobuf#fieldmask + // The update mask applies to the resource. google.protobuf.FieldMask update_mask = 2; } // Request message for [AutoMl.CreateModel][google.cloud.automl.v1beta1.AutoMl.CreateModel]. message CreateModelRequest { - // Resource name of the parent project where the model is being created. - string parent = 1; - - // The model to create. - Model model = 4; + // Required. Resource name of the parent project where the model is being created. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "locations.googleapis.com/Location" + } + ]; + + // Required. The model to create. + Model model = 4 [(google.api.field_behavior) = REQUIRED]; } // Request message for [AutoMl.GetModel][google.cloud.automl.v1beta1.AutoMl.GetModel]. message GetModelRequest { - // Resource name of the model. - string name = 1; + // Required. Resource name of the model. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Model" + } + ]; } // Request message for [AutoMl.ListModels][google.cloud.automl.v1beta1.AutoMl.ListModels]. message ListModelsRequest { - // Resource name of the project, from which to list the models. - string parent = 1; + // Required. Resource name of the project, from which to list the models. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "locations.googleapis.com/Location" + } + ]; // An expression for filtering the results of the request. // @@ -555,8 +671,13 @@ message ListModelsResponse { // Request message for [AutoMl.DeleteModel][google.cloud.automl.v1beta1.AutoMl.DeleteModel]. message DeleteModelRequest { - // Resource name of the model being deleted. - string name = 1; + // Required. Resource name of the model being deleted. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Model" + } + ]; } // Request message for [AutoMl.DeployModel][google.cloud.automl.v1beta1.AutoMl.DeployModel]. @@ -565,16 +686,29 @@ message DeployModelRequest { oneof model_deployment_metadata { // Model deployment metadata specific to Image Object Detection. ImageObjectDetectionModelDeploymentMetadata image_object_detection_model_deployment_metadata = 2; + + // Model deployment metadata specific to Image Classification. + ImageClassificationModelDeploymentMetadata image_classification_model_deployment_metadata = 4; } - // Resource name of the model to deploy. - string name = 1; + // Required. Resource name of the model to deploy. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Model" + } + ]; } // Request message for [AutoMl.UndeployModel][google.cloud.automl.v1beta1.AutoMl.UndeployModel]. message UndeployModelRequest { - // Resource name of the model to undeploy. - string name = 1; + // Required. Resource name of the model to undeploy. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Model" + } + ]; } // Request message for [AutoMl.ExportModel][google.cloud.automl.v1beta1.AutoMl.ExportModel]. @@ -582,34 +716,54 @@ message UndeployModelRequest { // returned. message ExportModelRequest { // Required. The resource name of the model to export. - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Model" + } + ]; // Required. The desired output location and configuration. - ModelExportOutputConfig output_config = 3; + ModelExportOutputConfig output_config = 3 [(google.api.field_behavior) = REQUIRED]; } // Request message for [AutoMl.ExportEvaluatedExamples][google.cloud.automl.v1beta1.AutoMl.ExportEvaluatedExamples]. message ExportEvaluatedExamplesRequest { // Required. The resource name of the model whose evaluated examples are to // be exported. - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Model" + } + ]; // Required. The desired output location and configuration. - ExportEvaluatedExamplesOutputConfig output_config = 3; + ExportEvaluatedExamplesOutputConfig output_config = 3 [(google.api.field_behavior) = REQUIRED]; } // Request message for [AutoMl.GetModelEvaluation][google.cloud.automl.v1beta1.AutoMl.GetModelEvaluation]. message GetModelEvaluationRequest { - // Resource name for the model evaluation. - string name = 1; + // Required. Resource name for the model evaluation. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/ModelEvaluation" + } + ]; } // Request message for [AutoMl.ListModelEvaluations][google.cloud.automl.v1beta1.AutoMl.ListModelEvaluations]. message ListModelEvaluationsRequest { - // Resource name of the model to list the model evaluations for. + // Required. Resource name of the model to list the model evaluations for. // If modelId is set as "-", this will list model evaluations from across all // models of the parent location. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "automl.googleapis.com/Model" + } + ]; // An expression for filtering the results of the request. // diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/table_spec.proto b/third_party/googleapis/google/cloud/automl/v1beta1/table_spec.proto index 98f87f122..bc3fc7440 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/table_spec.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/table_spec.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,12 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.automl.v1beta1; +import "google/api/resource.proto"; import "google/cloud/automl/v1beta1/io.proto"; import "google/api/annotations.proto"; @@ -36,6 +36,11 @@ option ruby_package = "Google::Cloud::AutoML::V1beta1"; // Used by: // * Tables message TableSpec { + option (google.api.resource) = { + type: "automl.googleapis.com/TableSpec" + pattern: "projects/{project}/locations/{location}/datasets/{dataset}/tableSpecs/{table_spec}" + }; + // Output only. The resource name of the table spec. // Form: // @@ -55,6 +60,10 @@ message TableSpec { // Output only. The number of rows (i.e. examples) in the table. int64 row_count = 3; + // Output only. The number of valid rows (i.e. without values that don't match + // DataType-s of their columns). + int64 valid_row_count = 4; + // Output only. The number of columns of the table. That is, the number of // child ColumnSpec-s. int64 column_count = 7; diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/tables.proto b/third_party/googleapis/google/cloud/automl/v1beta1/tables.proto index 1cf916367..5327f5e78 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/tables.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/tables.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -22,6 +21,7 @@ import "google/cloud/automl/v1beta1/column_spec.proto"; import "google/cloud/automl/v1beta1/data_items.proto"; import "google/cloud/automl/v1beta1/data_stats.proto"; import "google/cloud/automl/v1beta1/ranges.proto"; +import "google/cloud/automl/v1beta1/regression.proto"; import "google/cloud/automl/v1beta1/temporal.proto"; import "google/protobuf/struct.proto"; import "google/protobuf/timestamp.proto"; @@ -42,9 +42,12 @@ message TablesDatasetMetadata { // training & prediction target. // This column must be non-nullable and have one of following data types // (otherwise model creation will error): + // // * CATEGORY + // // * FLOAT64 - // Furthermore, if the type is CATEGORY , then only up to + // + // If the type is CATEGORY , only up to // 100 unique values may exist in that column across all rows. // // NOTE: Updates of this field will instantly affect any other users @@ -89,16 +92,30 @@ message TablesDatasetMetadata { // for the timestamp at which these stats were last updated. map target_column_correlations = 6; - // The most recent timestamp when target_column_correlations field and all - // descendant ColumnSpec.data_stats and ColumnSpec.top_correlated_columns - // fields were last (re-)generated. Any changes that happened to the dataset - // afterwards are not reflected in these fields values. The regeneration - // happens in the background on a best effort basis. + // Output only. The most recent timestamp when target_column_correlations + // field and all descendant ColumnSpec.data_stats and + // ColumnSpec.top_correlated_columns fields were last (re-)generated. Any + // changes that happened to the dataset afterwards are not reflected in these + // fields values. The regeneration happens in the background on a best effort + // basis. google.protobuf.Timestamp stats_update_time = 7; } // Model metadata specific to AutoML Tables. message TablesModelMetadata { + // Additional optimization objective configuration. Required for + // `MAXIMIZE_PRECISION_AT_RECALL` and `MAXIMIZE_RECALL_AT_PRECISION`, + // otherwise unused. + oneof additional_optimization_objective_config { + // Required when optimization_objective is "MAXIMIZE_PRECISION_AT_RECALL". + // Must be between 0 and 1, inclusive. + float optimization_objective_recall_value = 17; + + // Required when optimization_objective is "MAXIMIZE_RECALL_AT_PRECISION". + // Must be between 0 and 1, inclusive. + float optimization_objective_precision_value = 18; + } + // Column spec of the dataset's primary table's column the model is // predicting. Snapshotted when model creation started. // Only 3 fields are used: @@ -122,12 +139,16 @@ message TablesModelMetadata { // // [ml_use_column][google.cloud.automl.v1beta1.TablesDatasetMetadata.ml_use_column_spec_id] // must never be included here. + // // Only 3 fields are used: - // name - May be set on CreateModel, if set only the columns specified are - // used, otherwise all primary table's columns (except the ones listed - // above) are used for the training and prediction input. - // display_name - Output only. - // data_type - Output only. + // + // * name - May be set on CreateModel, if set only the columns specified are + // used, otherwise all primary table's columns (except the ones listed + // above) are used for the training and prediction input. + // + // * display_name - Output only. + // + // * data_type - Output only. repeated ColumnSpec input_feature_column_specs = 3; // Objective function the model is optimizing towards. The training process @@ -155,25 +176,8 @@ message TablesModelMetadata { // "MINIMIZE_RMSE" (default) - Minimize root-mean-squared error (RMSE). // "MINIMIZE_MAE" - Minimize mean-absolute error (MAE). // "MINIMIZE_RMSLE" - Minimize root-mean-squared log error (RMSLE). - // - // FORECASTING: - // "MINIMIZE_RMSE" (default) - Minimize root-mean-squared error (RMSE). - // "MINIMIZE_MAE" - Minimize mean-absolute error (MAE). string optimization_objective = 4; - // Additional optimization objective configuration. Required for - // `MAXIMIZE_PRECISION_AT_RECALL` and `MAXIMIZE_RECALL_AT_PRECISION`, - // otherwise unused. - oneof additional_optimization_objective_config { - // Required when optimization_objective is "MAXIMIZE_PRECISION_AT_RECALL". - // Must be between 0 and 1, inclusive. - float optimization_objective_recall_value = 17; - - // Required when optimization_objective is "MAXIMIZE_RECALL_AT_PRECISION". - // Must be between 0 and 1, inclusive. - float optimization_objective_precision_value = 18; - } - // Output only. Auxiliary information for each of the // input_feature_column_specs with respect to this particular model. repeated TablesModelColumnInfo tables_model_column_info = 5; @@ -226,9 +230,11 @@ message TablesAnnotation { // // [target_column][google.cloud.automl.v1beta1.TablesModelMetadata.target_column_spec]. // The value depends on the column's DataType: - // CATEGORY - the predicted (with the above confidence `score`) CATEGORY - // value. - // FLOAT64 - the predicted (with above `prediction_interval`) FLOAT64 value. + // + // * CATEGORY - the predicted (with the above confidence `score`) CATEGORY + // value. + // + // * FLOAT64 - the predicted (with above `prediction_interval`) FLOAT64 value. google.protobuf.Value value = 2; // Output only. Auxiliary information for each of the model's @@ -243,6 +249,15 @@ message TablesAnnotation { // [column_display_name][google.cloud.automl.v1beta1.TablesModelColumnInfo.column_display_name] // would be populated, then this whole field is not. repeated TablesModelColumnInfo tables_model_column_info = 3; + + // Output only. Stores the prediction score for the baseline example, which + // is defined as the example with all values set to their baseline values. + // This is used as part of the Sampled Shapley explanation of the model's + // prediction. This field is populated only when feature importance is + // requested. For regression models, this holds the baseline prediction for + // the baseline example. For classification models, this holds the baseline + // prediction for the baseline example for the argmax class. + float baseline_score = 5; } // An information specific to given column and Tables Model, in context @@ -256,9 +271,7 @@ message TablesModelColumnInfo { // its ColumnSpec). string column_display_name = 2; - // Output only. - // - // When given as part of a Model (always populated): + // Output only. When given as part of a Model (always populated): // Measurement of how much model predictions correctness on the TEST data // depend on values in this column. A value between 0 and 1, higher means // higher influence. These values are normalized - for all input feature @@ -271,8 +284,9 @@ message TablesModelColumnInfo { // [feature_importance][google.cloud.automl.v1beta1.PredictRequest.params] // param is set): // Measurement of how impactful for the prediction returned for the given row - // the value in this column was. A value between 0 and 1, higher means larger - // impact. These values are normalized - for all input feature columns of a - // single predicted row they add to 1. + // the value in this column was. Specifically, the feature importance + // specifies the marginal contribution that the feature made to the prediction + // score compared to the baseline score. These values are computed using the + // Sampled Shapley method. float feature_importance = 3; } diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/temporal.proto b/third_party/googleapis/google/cloud/automl/v1beta1/temporal.proto index 84874d99f..76db8887c 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/temporal.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/temporal.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/text.proto b/third_party/googleapis/google/cloud/automl/v1beta1/text.proto index 15c8368ed..f6f33185c 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/text.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/text.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -29,14 +28,14 @@ option ruby_package = "Google::Cloud::AutoML::V1beta1"; // Dataset metadata for classification. message TextClassificationDatasetMetadata { - // Required. - // Type of the classification problem. + // Required. Type of the classification problem. ClassificationType classification_type = 1; } // Model metadata that is specific to text classification. message TextClassificationModelMetadata { - + // Output only. Classification type of the dataset used to train this model. + ClassificationType classification_type = 3; } // Dataset metadata that is specific to text extraction @@ -51,8 +50,7 @@ message TextExtractionModelMetadata { // Dataset metadata for text sentiment. message TextSentimentDatasetMetadata { - // Required. - // A sentiment is expressed as an integer ordinal, where higher value + // Required. A sentiment is expressed as an integer ordinal, where higher value // means a more positive sentiment. The range of sentiments that will be used // is between 0 and sentiment_max (inclusive on both ends), and all the values // in the range must be represented in the dataset before a model can be diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/text_extraction.proto b/third_party/googleapis/google/cloud/automl/v1beta1/text_extraction.proto index 07f0dda81..cfb0e0b37 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/text_extraction.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/text_extraction.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/text_segment.proto b/third_party/googleapis/google/cloud/automl/v1beta1/text_segment.proto index 41b8be1cc..94b17d930 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/text_segment.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/text_segment.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/text_sentiment.proto b/third_party/googleapis/google/cloud/automl/v1beta1/text_sentiment.proto index 978acb0f9..5444c52b9 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/text_sentiment.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/text_sentiment.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/translation.proto b/third_party/googleapis/google/cloud/automl/v1beta1/translation.proto index ed02b2af5..8585bd410 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/translation.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/translation.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,12 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.automl.v1beta1; +import "google/api/field_behavior.proto"; import "google/cloud/automl/v1beta1/data_items.proto"; import "google/api/annotations.proto"; @@ -30,10 +30,10 @@ option ruby_package = "Google::Cloud::AutoML::V1beta1"; // Dataset metadata that is specific to translation. message TranslationDatasetMetadata { // Required. The BCP-47 language code of the source language. - string source_language_code = 1; + string source_language_code = 1 [(google.api.field_behavior) = REQUIRED]; // Required. The BCP-47 language code of the target language. - string target_language_code = 2; + string target_language_code = 2 [(google.api.field_behavior) = REQUIRED]; } // Evaluation metrics for the dataset. diff --git a/third_party/googleapis/google/cloud/automl/v1beta1/video.proto b/third_party/googleapis/google/cloud/automl/v1beta1/video.proto index b7c7325bc..268ae2a8c 100644 --- a/third_party/googleapis/google/cloud/automl/v1beta1/video.proto +++ b/third_party/googleapis/google/cloud/automl/v1beta1/video.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/cloud/bigquery/artman_bigquery_v2.yaml b/third_party/googleapis/google/cloud/bigquery/artman_bigquery_v2.yaml index 426a197a8..e0b3851f2 100644 --- a/third_party/googleapis/google/cloud/bigquery/artman_bigquery_v2.yaml +++ b/third_party/googleapis/google/cloud/bigquery/artman_bigquery_v2.yaml @@ -8,6 +8,7 @@ common: - v2 service_yaml: bigquery_v2.yaml gapic_yaml: v2/bigquery_gapic.yaml + proto_package: google.cloud.bigquery.v2 artifacts: - name: gapic_config type: GAPIC_CONFIG diff --git a/third_party/googleapis/google/cloud/bigquery/bigquery_v2.yaml b/third_party/googleapis/google/cloud/bigquery/bigquery_v2.yaml index f6ffefee7..75c9634a7 100644 --- a/third_party/googleapis/google/cloud/bigquery/bigquery_v2.yaml +++ b/third_party/googleapis/google/cloud/bigquery/bigquery_v2.yaml @@ -20,12 +20,14 @@ authentication: oauth: canonical_scopes: |- https://www.googleapis.com/auth/bigquery, + https://www.googleapis.com/auth/bigquery.readonly, https://www.googleapis.com/auth/cloud-platform, https://www.googleapis.com/auth/cloud-platform.read-only - selector: google.cloud.bigquery.v2.ModelService.ListModels oauth: canonical_scopes: |- https://www.googleapis.com/auth/bigquery, + https://www.googleapis.com/auth/bigquery.readonly, https://www.googleapis.com/auth/cloud-platform, https://www.googleapis.com/auth/cloud-platform.read-only - selector: google.cloud.bigquery.v2.ModelService.PatchModel diff --git a/third_party/googleapis/google/cloud/bigquery/connection/v1/BUILD.bazel b/third_party/googleapis/google/cloud/bigquery/connection/v1/BUILD.bazel new file mode 100644 index 000000000..f97c0d8f1 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/connection/v1/BUILD.bazel @@ -0,0 +1,179 @@ +# This file was automatically generated by BuildFileGenerator + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") + +proto_library( + name = "connection_proto", + srcs = [ + "connection.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/iam/v1:iam_policy_proto", + "//google/iam/v1:policy_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:wrappers_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_grpc_library", + "java_proto_library", +) + +java_proto_library( + name = "connection_java_proto", + deps = [":connection_proto"], +) + +java_grpc_library( + name = "connection_java_grpc", + srcs = [":connection_proto"], + deps = [":connection_java_proto"], +) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_proto_library", +) + +go_proto_library( + name = "connection_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/cloud/bigquery/connection/v1", + protos = [":connection_proto"], + deps = [ + "//google/api:annotations_go_proto", + "//google/iam/v1:iam_go_proto", + ], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "connection_moved_proto", + srcs = [":connection_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/iam/v1:iam_policy_proto", + "//google/iam/v1:policy_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:wrappers_proto", + ], +) + +py_proto_library( + name = "connection_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":connection_moved_proto"], +) + +py_grpc_library( + name = "connection_py_grpc", + srcs = [":connection_moved_proto"], + deps = [":connection_py_proto"], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "connection_php_proto", + deps = [":connection_proto"], +) + +php_grpc_library( + name = "connection_php_grpc", + srcs = [":connection_proto"], + deps = [":connection_php_proto"], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "connection_ruby_proto", + deps = [":connection_proto"], +) + +ruby_grpc_library( + name = "connection_ruby_grpc", + srcs = [":connection_proto"], + deps = [":connection_ruby_proto"], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "connection_csharp_proto", + deps = [":connection_proto"], +) + +csharp_grpc_library( + name = "connection_csharp_grpc", + srcs = [":connection_proto"], + deps = [":connection_csharp_proto"], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ code here diff --git a/third_party/googleapis/google/cloud/bigquery/connection/v1/bigqueryconnection_grpc_service_config.json b/third_party/googleapis/google/cloud/bigquery/connection/v1/bigqueryconnection_grpc_service_config.json new file mode 100755 index 000000000..b73fed3a5 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/connection/v1/bigqueryconnection_grpc_service_config.json @@ -0,0 +1,56 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.bigquery.connection.v1.ConnectionService", + "method": "CreateConnection" + }, + { + "service": "google.cloud.bigquery.connection.v1.ConnectionService", + "method": "UpdateConnection" + }, + { + "service": "google.cloud.bigquery.connection.v1.ConnectionService", + "method": "GetIamPolicy" + }, + { + "service": "google.cloud.bigquery.connection.v1.ConnectionService", + "method": "SetIamPolicy" + }, + { + "service": "google.cloud.bigquery.connection.v1.ConnectionService", + "method": "TestIamPermissions" + } + ], + "timeout": "60s" + }, + { + "name": [ + { + "service": "google.cloud.bigquery.connection.v1.ConnectionService", + "method": "GetConnection" + }, + { + "service": "google.cloud.bigquery.connection.v1.ConnectionService", + "method": "ListConnections" + }, + { + "service": "google.cloud.bigquery.connection.v1.ConnectionService", + "method": "DeleteConnection" + } + ], + "timeout": "60s", + "retryPolicy": { + "maxAttempts": 5, + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/cloud/bigquery/connection/v1/bigqueryconnection_v1.yaml b/third_party/googleapis/google/cloud/bigquery/connection/v1/bigqueryconnection_v1.yaml new file mode 100644 index 000000000..2cdc5bc72 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/connection/v1/bigqueryconnection_v1.yaml @@ -0,0 +1,18 @@ +type: google.api.Service +config_version: 3 +name: bigqueryconnection.googleapis.com +title: BigQuery Connection API + +apis: +- name: google.cloud.bigquery.connection.v1.ConnectionService + +documentation: + summary: Allows users to manage BigQuery connections to external data sources. + +authentication: + rules: + - selector: 'google.cloud.bigquery.connection.v1.ConnectionService.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/bigquery, + https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/bigquery/connection/v1/connection.proto b/third_party/googleapis/google/cloud/bigquery/connection/v1/connection.proto new file mode 100644 index 000000000..3bde8c124 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/connection/v1/connection.proto @@ -0,0 +1,278 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.bigquery.connection.v1; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/iam/v1/iam_policy.proto"; +import "google/iam/v1/policy.proto"; +import "google/protobuf/empty.proto"; +import "google/protobuf/field_mask.proto"; +import "google/protobuf/wrappers.proto"; + +option csharp_namespace = "Google.Cloud.BigQuery.Connection.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/connection/v1;connection"; +option java_multiple_files = true; +option java_outer_classname = "ConnectionProto"; +option java_package = "com.google.cloud.bigquery.connection.v1"; + +// Manages external data source connections and credentials. +service ConnectionService { + option (google.api.default_host) = "bigqueryconnection.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/bigquery," + "https://www.googleapis.com/auth/cloud-platform"; + + // Creates a new connection. + rpc CreateConnection(CreateConnectionRequest) returns (Connection) { + option (google.api.http) = { + post: "/v1/{parent=projects/*/locations/*}/connections" + body: "connection" + }; + option (google.api.method_signature) = "parent,connection,connection_id"; + } + + // Returns specified connection. + rpc GetConnection(GetConnectionRequest) returns (Connection) { + option (google.api.http) = { + get: "/v1/{name=projects/*/locations/*/connections/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Returns a list of connections in the given project. + rpc ListConnections(ListConnectionsRequest) returns (ListConnectionsResponse) { + option (google.api.http) = { + get: "/v1/{parent=projects/*/locations/*}/connections" + }; + } + + // Updates the specified connection. For security reasons, also resets + // credential if connection properties are in the update field mask. + rpc UpdateConnection(UpdateConnectionRequest) returns (Connection) { + option (google.api.http) = { + patch: "/v1/{name=projects/*/locations/*/connections/*}" + body: "connection" + }; + option (google.api.method_signature) = "name,connection,update_mask"; + } + + // Deletes connection and associated credential. + rpc DeleteConnection(DeleteConnectionRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1/{name=projects/*/locations/*/connections/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Gets the access control policy for a resource. + // Returns an empty policy if the resource exists and does not have a policy + // set. + rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) returns (google.iam.v1.Policy) { + option (google.api.http) = { + post: "/v1/{resource=projects/*/locations/*/connections/*}:getIamPolicy" + body: "*" + }; + option (google.api.method_signature) = "resource,options"; + } + + // Sets the access control policy on the specified resource. Replaces any + // existing policy. + // + // Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and PERMISSION_DENIED + rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) returns (google.iam.v1.Policy) { + option (google.api.http) = { + post: "/v1/{resource=projects/*/locations/*/connections/*}:setIamPolicy" + body: "*" + }; + option (google.api.method_signature) = "resource,policy"; + } + + // Returns permissions that a caller has on the specified resource. + // If the resource does not exist, this will return an empty set of + // permissions, not a NOT_FOUND error. + // + // Note: This operation is designed to be used for building permission-aware + // UIs and command-line tools, not for authorization checking. This operation + // may "fail open" without warning. + rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest) returns (google.iam.v1.TestIamPermissionsResponse) { + option (google.api.http) = { + post: "/v1/{resource=projects/*/locations/*/connections/*}:testIamPermissions" + body: "*" + }; + option (google.api.method_signature) = "resource,permissions"; + } +} + +// The request for [ConnectionService.CreateConnection][google.cloud.bigquery.connection.v1.ConnectionService.CreateConnection]. +message CreateConnectionRequest { + // Required. Parent resource name. + // Must be in the format `projects/{project_id}/locations/{location_id}` + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "locations.googleapis.com/Location" + } + ]; + + // Optional. Connection id that should be assigned to the created connection. + string connection_id = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Required. Connection to create. + Connection connection = 3 [(google.api.field_behavior) = REQUIRED]; +} + +// The request for [ConnectionService.GetConnection][google.cloud.bigquery.connection.v1.ConnectionService.GetConnection]. +message GetConnectionRequest { + // Required. Name of the requested connection, for example: + // `projects/{project_id}/locations/{location_id}/connections/{connection_id}` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigqueryconnection.googleapis.com/Connection" + } + ]; +} + +// The request for [ConnectionService.ListConnections][google.cloud.bigquery.connection.v1.ConnectionService.ListConnections]. +message ListConnectionsRequest { + // Required. Parent resource name. + // Must be in the form: `projects/{project_id}/locations/{location_id}` + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "locations.googleapis.com/Location" + } + ]; + + // Required. Page size. + int32 page_size = 4 [(google.api.field_behavior) = REQUIRED]; + + // Page token. + string page_token = 3; +} + +// The response for [ConnectionService.ListConnections][google.cloud.bigquery.connection.v1.ConnectionService.ListConnections]. +message ListConnectionsResponse { + // Next page token. + string next_page_token = 1; + + // List of connections. + repeated Connection connections = 2; +} + +// The request for [ConnectionService.UpdateConnection][google.cloud.bigquery.connection.v1.ConnectionService.UpdateConnection]. +message UpdateConnectionRequest { + // Required. Name of the connection to update, for example: + // `projects/{project_id}/locations/{location_id}/connections/{connection_id}` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigqueryconnection.googleapis.com/Connection" + } + ]; + + // Required. Connection containing the updated fields. + Connection connection = 2 [(google.api.field_behavior) = REQUIRED]; + + // Required. Update mask for the connection fields to be updated. + google.protobuf.FieldMask update_mask = 3 [(google.api.field_behavior) = REQUIRED]; +} + +// The request for [ConnectionService.DeleteConnectionRequest][]. +message DeleteConnectionRequest { + // Required. Name of the deleted connection, for example: + // `projects/{project_id}/locations/{location_id}/connections/{connection_id}` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigqueryconnection.googleapis.com/Connection" + } + ]; +} + +// Configuration parameters to establish connection with an external data +// source, except the credential attributes. +message Connection { + option (google.api.resource) = { + type: "bigqueryconnection.googleapis.com/Connection" + pattern: "projects/{project}/locations/{location}/connections/{connection}" + }; + + // The resource name of the connection in the form of: + // `projects/{project_id}/locations/{location_id}/connections/{connection_id}` + string name = 1; + + // User provided display name for the connection. + string friendly_name = 2; + + // User provided description. + string description = 3; + + // Properties specific to the underlying data source. + oneof properties { + // Cloud SQL properties. + CloudSqlProperties cloud_sql = 4; + } + + // Output only. The creation timestamp of the connection. + int64 creation_time = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The last update timestamp of the connection. + int64 last_modified_time = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. True, if credential is configured for this connection. + bool has_credential = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// Connection properties specific to the Cloud SQL. +message CloudSqlProperties { + // Supported Cloud SQL database types. + enum DatabaseType { + // Unspecified database type. + DATABASE_TYPE_UNSPECIFIED = 0; + + // Cloud SQL for PostgreSQL. + POSTGRES = 1; + + // Cloud SQL for MySQL. + MYSQL = 2; + } + + // Cloud SQL instance ID in the form `project:location:instance`. + string instance_id = 1; + + // Database name. + string database = 2; + + // Type of the Cloud SQL database. + DatabaseType type = 3; + + // Input only. Cloud SQL credential. + CloudSqlCredential credential = 4 [(google.api.field_behavior) = INPUT_ONLY]; +} + +// Credential info for the Cloud SQL. +message CloudSqlCredential { + // The username for the credential. + string username = 1; + + // The password for the credential. + string password = 2; +} diff --git a/third_party/googleapis/google/cloud/bigquery/connection/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/bigquery/connection/v1beta1/BUILD.bazel new file mode 100644 index 000000000..f2ccafc2a --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/connection/v1beta1/BUILD.bazel @@ -0,0 +1,372 @@ +# This file was automatically generated by BuildFileGenerator + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") +load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") + +proto_library( + name = "connection_proto", + srcs = [ + "connection.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/iam/v1:iam_policy_proto", + "//google/iam/v1:policy_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:wrappers_proto", + ], +) + +proto_library_with_info( + name = "connection_proto_with_info", + deps = [ + ":connection_proto", + "//google/cloud:common_resources_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", + "java_proto_library", +) + +java_proto_library( + name = "connection_java_proto", + deps = [":connection_proto"], +) + +java_grpc_library( + name = "connection_java_grpc", + srcs = [":connection_proto"], + deps = [":connection_java_proto"], +) + +java_gapic_library( + name = "connection_java_gapic", + src = ":connection_proto_with_info", + gapic_yaml = "bigqueryconnection_gapic.yaml", + package = "google.cloud.bigquery.connection.v1beta1", + service_yaml = "bigqueryconnection_v1beta1.yaml", + test_deps = [ + ":connection_java_grpc", + "//google/iam/v1:iam_java_grpc", + ], + deps = [ + ":connection_java_proto", + "//google/iam/v1:iam_java_proto", + ], +) + +java_gapic_test( + name = "connection_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.bigquery.connection.v1beta1.ConnectionServiceClientTest", + ], + runtime_deps = [":connection_java_gapic_test"], +) + +# Open Source Packages +java_gapic_assembly_gradle_pkg( + name = "google-cloud-bigquery-connection-v1beta1-java", + deps = [ + ":connection_java_gapic", + ":connection_java_grpc", + ":connection_java_proto", + ":connection_proto", + ], +) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", + "go_proto_library", + "go_test", +) + +go_proto_library( + name = "connection_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/cloud/bigquery/connection/v1beta1", + protos = [":connection_proto"], + deps = [ + "//google/api:annotations_go_proto", + "//google/iam/v1:iam_go_proto", + ], +) + +#go_gapic_library( +# name = "connection_go_gapic", +# src = ":connection_proto_with_info", +# gapic_yaml = "bigqueryconnection_gapic.yaml", +# importpath = "cloud.google.com/go/bigquery/connection/apiv1beta1", +# package = "google.cloud.bigquery.connection.v1beta1", +# service_yaml = "bigqueryconnection_v1beta1.yaml", +# deps = [ +# ":connection_go_proto", +# "//google/iam/v1:iam_go_proto", +# ], +#) +# +#go_test( +# name = "connection_go_gapic_test", +# srcs = [":connection_go_gapic_srcjar_test"], +# embed = [":connection_go_gapic"], +# importpath = "cloud.google.com/go/bigquery/connection/apiv1beta1", +#) +# +## Open Source Packages +#go_gapic_assembly_pkg( +# name = "gapi-cloud-bigquery-connection-v1beta1-go", +# deps = [ +# ":connection_go_gapic", +# ":connection_go_gapic_srcjar-smoke-test.srcjar", +# ":connection_go_gapic_srcjar-test.srcjar", +# ":connection_go_proto", +# ], +#) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "connection_moved_proto", + srcs = [":connection_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/iam/v1:iam_policy_proto", + "//google/iam/v1:policy_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:wrappers_proto", + ], +) + +py_proto_library( + name = "connection_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":connection_moved_proto"], +) + +py_grpc_library( + name = "connection_py_grpc", + srcs = [":connection_moved_proto"], + deps = [":connection_py_proto"], +) + +py_gapic_library( + name = "connection_py_gapic", + src = ":connection_proto_with_info", + gapic_yaml = "bigqueryconnection_gapic.yaml", + package = "google.cloud.bigquery.connection.v1beta1", + service_yaml = "bigqueryconnection_v1beta1.yaml", + deps = [ + ":connection_py_grpc", + ":connection_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "bigquery-connection-v1beta1-py", + deps = [ + ":connection_py_gapic", + ":connection_py_grpc", + ":connection_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "connection_php_proto", + deps = [":connection_proto"], +) + +php_grpc_library( + name = "connection_php_grpc", + srcs = [":connection_proto"], + deps = [":connection_php_proto"], +) + +php_gapic_library( + name = "connection_php_gapic", + src = ":connection_proto_with_info", + gapic_yaml = "bigqueryconnection_gapic.yaml", + package = "google.cloud.bigquery.connection.v1beta1", + service_yaml = "bigqueryconnection_v1beta1.yaml", + deps = [ + ":connection_php_grpc", + ":connection_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-bigquery-connection-v1beta1-php", + deps = [ + ":connection_php_gapic", + ":connection_php_grpc", + ":connection_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "connection_nodejs_gapic", + src = ":connection_proto_with_info", + gapic_yaml = "bigqueryconnection_gapic.yaml", + package = "google.cloud.bigquery.connection.v1beta1", + service_yaml = "bigqueryconnection_v1beta1.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "bigquery-connection-v1beta1-nodejs", + deps = [ + ":connection_nodejs_gapic", + ":connection_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "connection_ruby_proto", + deps = [":connection_proto"], +) + +ruby_grpc_library( + name = "connection_ruby_grpc", + srcs = [":connection_proto"], + deps = [":connection_ruby_proto"], +) + +ruby_gapic_library( + name = "connection_ruby_gapic", + src = ":connection_proto_with_info", + gapic_yaml = "bigqueryconnection_gapic.yaml", + package = "google.cloud.bigquery.connection.v1beta1", + service_yaml = "bigqueryconnection_v1beta1.yaml", + deps = [ + ":connection_ruby_grpc", + ":connection_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-bigquery-connection-v1beta1-ruby", + deps = [ + ":connection_ruby_gapic", + ":connection_ruby_grpc", + ":connection_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "connection_csharp_proto", + deps = [":connection_proto"], +) + +csharp_grpc_library( + name = "connection_csharp_grpc", + srcs = [":connection_proto"], + deps = [":connection_csharp_proto"], +) + +csharp_gapic_library( + name = "connection_csharp_gapic", + src = ":connection_proto_with_info", + gapic_yaml = "bigqueryconnection_gapic.yaml", + package = "google.cloud.bigquery.connection.v1beta1", + service_yaml = "bigqueryconnection_v1beta1.yaml", + deps = [ + ":connection_csharp_grpc", + ":connection_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-bigquery-connection-v1beta1-csharp", + deps = [ + ":connection_csharp_gapic", + ":connection_csharp_grpc", + ":connection_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/cloud/bigquery/connection/v1beta1/artman_bigqueryconnection_v1beta1.yaml b/third_party/googleapis/google/cloud/bigquery/connection/v1beta1/artman_bigqueryconnection_v1beta1.yaml new file mode 100644 index 000000000..86bdca407 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/connection/v1beta1/artman_bigqueryconnection_v1beta1.yaml @@ -0,0 +1,20 @@ +common: + api_name: bigqueryconnection + api_version: v1beta1 + organization_name: google-cloud + proto_deps: + - name: google-common-protos + src_proto_paths: + - . + service_yaml: bigqueryconnection_v1beta1.yaml + gapic_yaml: bigqueryconnection_gapic.yaml + proto_package: google.cloud.bigquery.connection.v1beta1 +artifacts: +- name: gapic_config + type: GAPIC_CONFIG +- name: python_gapic + type: GAPIC + language: PYTHON +- name: php_gapic + type: GAPIC + language: PHP diff --git a/third_party/googleapis/google/cloud/bigquery/connection/v1beta1/bigqueryconnection_gapic.legacy.yaml b/third_party/googleapis/google/cloud/bigquery/connection/v1beta1/bigqueryconnection_gapic.legacy.yaml new file mode 100644 index 000000000..120914a57 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/connection/v1beta1/bigqueryconnection_gapic.legacy.yaml @@ -0,0 +1,230 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 1.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.bigquery.connection.v1beta1 + python: + package_name: google.cloud.bigquery.connection_v1beta1.gapic + go: + package_name: cloud.google.com/go/bigquery/connection/apiv1beta1 + csharp: + package_name: Google.Cloud.BigQuery.Connection.V1Beta1 + ruby: + package_name: Google::Cloud::Bigquery::Connection::V1beta1 + php: + package_name: Google\Cloud\BigQuery\Connection\V1beta1 + nodejs: + package_name: connection.v1beta1 +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.cloud.bigquery.connection.v1beta1.ConnectionService + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: + - name_pattern: projects/{project}/locations/{location} + entity_name: location + - name_pattern: projects/{project}/locations/{location}/connections/{connection} + entity_name: connection + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - DEADLINE_EXCEEDED + - UNAVAILABLE + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # + # name - The simple name of the method. + # + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce method + # overloads which allow a client to directly pass request message fields as + # method parameters. This information may or may not be used, depending on + # the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request message. + # + # required_fields - Fields that are always required for a request to be + # valid. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a paging + # list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It defines + # which fields match the paging pattern in the request. The request consists + # of a page_size_field and a token_field. The page_size_field is the name of + # the optional field specifying the maximum number of elements to be + # returned in the response. The token_field is the name of the field in the + # request containing the page token. + # The response specifies response information of the list method. It defines + # which fields match the paging pattern in the response. The response + # consists of a token_field and a resources_field. The token_field is the + # name of the field in the response containing the next page token. The + # resources_field is the name of the field in the response containing the + # list of resources belonging to the page. + # + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: CreateConnection + flattening: + groups: + - parameters: + - parent + - connection + - connection_id + required_fields: + - parent + - connection + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: location + timeout_millis: 60000 + - name: GetConnection + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: connection + timeout_millis: 60000 + - name: ListConnections + flattening: + groups: + - parameters: + - parent + - max_results + required_fields: + - parent + - max_results + page_streaming: + request: + token_field: page_token + response: + token_field: next_page_token + resources_field: connections + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: location + timeout_millis: 60000 + - name: UpdateConnection + flattening: + groups: + - parameters: + - name + - connection + - update_mask + required_fields: + - name + - connection + - update_mask + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: connection + timeout_millis: 60000 + - name: UpdateConnectionCredential + flattening: + groups: + - parameters: + - name + - credential + required_fields: + - name + - credential + retry_codes_name: non_idempotent + retry_params_name: default + timeout_millis: 60000 + - name: DeleteConnection + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: connection + timeout_millis: 60000 + - name: GetIamPolicy + flattening: + groups: + - parameters: + - resource + - options + required_fields: + - resource + - options + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + resource: connection + timeout_millis: 60000 + - name: SetIamPolicy + flattening: + groups: + - parameters: + - resource + - policy + required_fields: + - resource + - policy + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + resource: connection + timeout_millis: 60000 + - name: TestIamPermissions + flattening: + groups: + - parameters: + - resource + - permissions + required_fields: + - resource + - permissions + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + resource: connection + timeout_millis: 60000 diff --git a/third_party/googleapis/google/cloud/bigquery/connection/v1beta1/bigqueryconnection_gapic.yaml b/third_party/googleapis/google/cloud/bigquery/connection/v1beta1/bigqueryconnection_gapic.yaml new file mode 100644 index 000000000..c668bf552 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/connection/v1beta1/bigqueryconnection_gapic.yaml @@ -0,0 +1,23 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 2.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.bigquery.connection.v1beta1 + python: + package_name: google.cloud.bigquery.connection_v1beta1.gapic + go: + package_name: cloud.google.com/go/bigquery/connection/apiv1beta1 + csharp: + package_name: Google.Cloud.BigQuery.Connection.V1Beta1 + ruby: + package_name: Google::Cloud::Bigquery::Connection::V1beta1 + php: + package_name: Google\Cloud\BigQuery\Connection\V1beta1 + nodejs: + package_name: connection.v1beta1 +interfaces: +- name: google.cloud.bigquery.connection.v1beta1.ConnectionService + methods: + - name: DeleteConnection + retry_codes_name: idempotent diff --git a/third_party/googleapis/google/cloud/bigquery/connection/v1beta1/bigqueryconnection_grpc_service_config.json b/third_party/googleapis/google/cloud/bigquery/connection/v1beta1/bigqueryconnection_grpc_service_config.json new file mode 100755 index 000000000..d65121d4e --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/connection/v1beta1/bigqueryconnection_grpc_service_config.json @@ -0,0 +1,60 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.bigquery.connection.v1beta1.ConnectionService", + "method": "CreateConnection" + }, + { + "service": "google.cloud.bigquery.connection.v1beta1.ConnectionService", + "method": "UpdateConnection" + }, + { + "service": "google.cloud.bigquery.connection.v1beta1.ConnectionService", + "method": "UpdateConnectionCredential" + }, + { + "service": "google.cloud.bigquery.connection.v1beta1.ConnectionService", + "method": "GetIamPolicy" + }, + { + "service": "google.cloud.bigquery.connection.v1beta1.ConnectionService", + "method": "SetIamPolicy" + }, + { + "service": "google.cloud.bigquery.connection.v1beta1.ConnectionService", + "method": "TestIamPermissions" + } + ], + "timeout": "60s" + }, + { + "name": [ + { + "service": "google.cloud.bigquery.connection.v1beta1.ConnectionService", + "method": "GetConnection" + }, + { + "service": "google.cloud.bigquery.connection.v1beta1.ConnectionService", + "method": "ListConnections" + }, + { + "service": "google.cloud.bigquery.connection.v1beta1.ConnectionService", + "method": "DeleteConnection" + } + ], + "timeout": "60s", + "retryPolicy": { + "maxAttempts": 5, + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/cloud/bigquery/connection/v1beta1/bigqueryconnection_v1beta1.yaml b/third_party/googleapis/google/cloud/bigquery/connection/v1beta1/bigqueryconnection_v1beta1.yaml new file mode 100644 index 000000000..0758da5e1 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/connection/v1beta1/bigqueryconnection_v1beta1.yaml @@ -0,0 +1,18 @@ +type: google.api.Service +config_version: 3 +name: bigqueryconnection.googleapis.com +title: BigQuery Connection API + +apis: +- name: google.cloud.bigquery.connection.v1beta1.ConnectionService + +documentation: + summary: Allows users to manage BigQuery connections to external data sources. + +authentication: + rules: + - selector: 'google.cloud.bigquery.connection.v1beta1.ConnectionService.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/bigquery, + https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/bigquery/connection/v1beta1/connection.proto b/third_party/googleapis/google/cloud/bigquery/connection/v1beta1/connection.proto new file mode 100644 index 000000000..5b6d05dff --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/connection/v1beta1/connection.proto @@ -0,0 +1,306 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.bigquery.connection.v1beta1; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/iam/v1/iam_policy.proto"; +import "google/iam/v1/policy.proto"; +import "google/protobuf/empty.proto"; +import "google/protobuf/field_mask.proto"; +import "google/protobuf/wrappers.proto"; + +option csharp_namespace = "Google.Cloud.BigQuery.Connection.V1Beta1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/connection/v1beta1;connection"; +option java_outer_classname = "ConnectionProto"; +option java_package = "com.google.cloud.bigquery.connection.v1beta1"; + +// Manages external data source connections and credentials. +service ConnectionService { + option (google.api.default_host) = "bigqueryconnection.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/bigquery," + "https://www.googleapis.com/auth/cloud-platform"; + + // Creates a new connection. + rpc CreateConnection(CreateConnectionRequest) returns (Connection) { + option (google.api.http) = { + post: "/v1beta1/{parent=projects/*/locations/*}/connections" + body: "connection" + }; + option (google.api.method_signature) = "parent,connection,connection_id"; + } + + // Returns specified connection. + rpc GetConnection(GetConnectionRequest) returns (Connection) { + option (google.api.http) = { + get: "/v1beta1/{name=projects/*/locations/*/connections/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Returns a list of connections in the given project. + rpc ListConnections(ListConnectionsRequest) returns (ListConnectionsResponse) { + option (google.api.http) = { + get: "/v1beta1/{parent=projects/*/locations/*}/connections" + }; + option (google.api.method_signature) = "parent,max_results"; + } + + // Updates the specified connection. For security reasons, also resets + // credential if connection properties are in the update field mask. + rpc UpdateConnection(UpdateConnectionRequest) returns (Connection) { + option (google.api.http) = { + patch: "/v1beta1/{name=projects/*/locations/*/connections/*}" + body: "connection" + }; + option (google.api.method_signature) = "name,connection,update_mask"; + } + + // Sets the credential for the specified connection. + rpc UpdateConnectionCredential(UpdateConnectionCredentialRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + patch: "/v1beta1/{name=projects/*/locations/*/connections/*/credential}" + body: "credential" + }; + option (google.api.method_signature) = "name,credential"; + } + + // Deletes connection and associated credential. + rpc DeleteConnection(DeleteConnectionRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1beta1/{name=projects/*/locations/*/connections/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Gets the access control policy for a resource. + // Returns an empty policy if the resource exists and does not have a policy + // set. + rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) returns (google.iam.v1.Policy) { + option (google.api.http) = { + post: "/v1beta1/{resource=projects/*/locations/*/connections/*}:getIamPolicy" + body: "*" + }; + option (google.api.method_signature) = "resource,options"; + } + + // Sets the access control policy on the specified resource. Replaces any + // existing policy. + // + // Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and PERMISSION_DENIED + rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) returns (google.iam.v1.Policy) { + option (google.api.http) = { + post: "/v1beta1/{resource=projects/*/locations/*/connections/*}:setIamPolicy" + body: "*" + }; + option (google.api.method_signature) = "resource,policy"; + } + + // Returns permissions that a caller has on the specified resource. + // If the resource does not exist, this will return an empty set of + // permissions, not a NOT_FOUND error. + // + // Note: This operation is designed to be used for building permission-aware + // UIs and command-line tools, not for authorization checking. This operation + // may "fail open" without warning. + rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest) returns (google.iam.v1.TestIamPermissionsResponse) { + option (google.api.http) = { + post: "/v1beta1/{resource=projects/*/locations/*/connections/*}:testIamPermissions" + body: "*" + }; + option (google.api.method_signature) = "resource,permissions"; + } +} + +// The request for [ConnectionService.CreateConnection][google.cloud.bigquery.connection.v1beta1.ConnectionService.CreateConnection]. +message CreateConnectionRequest { + // Required. Parent resource name. + // Must be in the format `projects/{project_id}/locations/{location_id}` + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "locations.googleapis.com/Location" + } + ]; + + // Optional. Connection id that should be assigned to the created connection. + string connection_id = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Required. Connection to create. + Connection connection = 3 [(google.api.field_behavior) = REQUIRED]; +} + +// The request for [ConnectionService.GetConnection][google.cloud.bigquery.connection.v1beta1.ConnectionService.GetConnection]. +message GetConnectionRequest { + // Required. Name of the requested connection, for example: + // `projects/{project_id}/locations/{location_id}/connections/{connection_id}` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigqueryconnection.googleapis.com/Connection" + } + ]; +} + +// The request for [ConnectionService.ListConnections][google.cloud.bigquery.connection.v1beta1.ConnectionService.ListConnections]. +message ListConnectionsRequest { + // Required. Parent resource name. + // Must be in the form: `projects/{project_id}/locations/{location_id}` + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "locations.googleapis.com/Location" + } + ]; + + // Required. Maximum number of results per page. + google.protobuf.UInt32Value max_results = 2 [(google.api.field_behavior) = REQUIRED]; + + // Page token. + string page_token = 3; +} + +// The response for [ConnectionService.ListConnections][google.cloud.bigquery.connection.v1beta1.ConnectionService.ListConnections]. +message ListConnectionsResponse { + // Next page token. + string next_page_token = 1; + + // List of connections. + repeated Connection connections = 2; +} + +// The request for [ConnectionService.UpdateConnection][google.cloud.bigquery.connection.v1beta1.ConnectionService.UpdateConnection]. +message UpdateConnectionRequest { + // Required. Name of the connection to update, for example: + // `projects/{project_id}/locations/{location_id}/connections/{connection_id}` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigqueryconnection.googleapis.com/Connection" + } + ]; + + // Required. Connection containing the updated fields. + Connection connection = 2 [(google.api.field_behavior) = REQUIRED]; + + // Required. Update mask for the connection fields to be updated. + google.protobuf.FieldMask update_mask = 3 [(google.api.field_behavior) = REQUIRED]; +} + +// The request for [ConnectionService.UpdateConnectionCredential][google.cloud.bigquery.connection.v1beta1.ConnectionService.UpdateConnectionCredential]. +message UpdateConnectionCredentialRequest { + // Required. Name of the connection, for example: + // `projects/{project_id}/locations/{location_id}/connections/{connection_id}/credential` + string name = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. Credential to use with the connection. + ConnectionCredential credential = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// The request for [ConnectionService.DeleteConnectionRequest][]. +message DeleteConnectionRequest { + // Required. Name of the deleted connection, for example: + // `projects/{project_id}/locations/{location_id}/connections/{connection_id}` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigqueryconnection.googleapis.com/Connection" + } + ]; +} + +// Configuration parameters to establish connection with an external data +// source, except the credential attributes. +message Connection { + option (google.api.resource) = { + type: "bigqueryconnection.googleapis.com/Connection" + pattern: "projects/{project}/locations/{location}/connections/{connection}" + }; + + // The resource name of the connection in the form of: + // `projects/{project_id}/locations/{location_id}/connections/{connection_id}` + string name = 1; + + // User provided display name for the connection. + string friendly_name = 2; + + // User provided description. + string description = 3; + + // Properties specific to the underlying data source. + oneof properties { + // Cloud SQL properties. + CloudSqlProperties cloud_sql = 4; + } + + // Output only. The creation timestamp of the connection. + int64 creation_time = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The last update timestamp of the connection. + int64 last_modified_time = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. True, if credential is configured for this connection. + bool has_credential = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// Credential to use with a connection. +message ConnectionCredential { + // Credential specific to the underlying data source. + oneof credential { + // Credential for Cloud SQL database. + CloudSqlCredential cloud_sql = 1; + } +} + +// Connection properties specific to the Cloud SQL. +message CloudSqlProperties { + // Supported Cloud SQL database types. + enum DatabaseType { + // Unspecified database type. + DATABASE_TYPE_UNSPECIFIED = 0; + + // Cloud SQL for PostgreSQL. + POSTGRES = 1; + + // Cloud SQL for MySQL. + MYSQL = 2; + } + + // Cloud SQL instance ID in the form `project:location:instance`. + string instance_id = 1; + + // Database name. + string database = 2; + + // Type of the Cloud SQL database. + DatabaseType type = 3; + + // Input only. Cloud SQL credential. + CloudSqlCredential credential = 4 [(google.api.field_behavior) = INPUT_ONLY]; +} + +// Credential info for the Cloud SQL. +message CloudSqlCredential { + // The username for the credential. + string username = 1; + + // The password for the credential. + string password = 2; +} diff --git a/third_party/googleapis/google/cloud/bigquery/datatransfer/BUILD.bazel b/third_party/googleapis/google/cloud/bigquery/datatransfer/BUILD.bazel index 1e5b8c2af..a87c57fec 100644 --- a/third_party/googleapis/google/cloud/bigquery/datatransfer/BUILD.bazel +++ b/third_party/googleapis/google/cloud/bigquery/datatransfer/BUILD.bazel @@ -1 +1 @@ -exports_files(glob(["*.yaml"])) \ No newline at end of file +exports_files(glob(["*.yaml"])) diff --git a/third_party/googleapis/google/cloud/bigquery/datatransfer/artman_bigquerydatatransfer.yaml b/third_party/googleapis/google/cloud/bigquery/datatransfer/artman_bigquerydatatransfer.yaml index 6e3950d8c..16a4c1865 100644 --- a/third_party/googleapis/google/cloud/bigquery/datatransfer/artman_bigquerydatatransfer.yaml +++ b/third_party/googleapis/google/cloud/bigquery/datatransfer/artman_bigquerydatatransfer.yaml @@ -6,8 +6,9 @@ common: - name: google-common-protos src_proto_paths: - v1 - service_yaml: datatransfer.yaml + service_yaml: v1/bigquerydatatransfer_v1.yaml gapic_yaml: v1/bigquerydatatransfer_gapic.yaml + proto_package: google.cloud.bigquery.datatransfer.v1 artifacts: - name: gapic_config type: GAPIC_CONFIG diff --git a/third_party/googleapis/google/cloud/bigquery/datatransfer/datatransfer.yaml b/third_party/googleapis/google/cloud/bigquery/datatransfer/datatransfer.yaml deleted file mode 100644 index 9879bbf37..000000000 --- a/third_party/googleapis/google/cloud/bigquery/datatransfer/datatransfer.yaml +++ /dev/null @@ -1,19 +0,0 @@ -type: google.api.Service -config_version: 3 -name: bigquerydatatransfer.googleapis.com -title: BigQuery Data Transfer API - -apis: -- name: google.cloud.bigquery.datatransfer.v1.DataTransferService - -documentation: - summary: |- - Transfers data from partner SaaS applications to Google BigQuery on a - scheduled, managed basis. - -authentication: - rules: - - selector: '*' - oauth: - canonical_scopes: |- - https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/BUILD.bazel b/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/BUILD.bazel index a26bb5e1c..47f825f96 100644 --- a/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/BUILD.bazel +++ b/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/BUILD.bazel @@ -1,20 +1,25 @@ +# This file was automatically generated by BuildFileGenerator + # This is an API workspace, having public visibility by default makes perfect sense. package(default_visibility = ["//visibility:public"]) ############################################################################## # Common ############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") proto_library( - name = "bigquerydatatransfer_proto", + name = "datatransfer_proto", srcs = [ - ":datatransfer.proto", - ":transfer.proto", + "datatransfer.proto", + "transfer.proto", ], deps = [ "//google/api:annotations_proto", "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", "//google/rpc:status_proto", "@com_google_protobuf//:duration_proto", "@com_google_protobuf//:empty_proto", @@ -26,8 +31,11 @@ proto_library( ) proto_library_with_info( - name = "bigquerydatatransfer_proto_with_info", - deps = [":bigquerydatatransfer_proto"], + name = "datatransfer_proto_with_info", + deps = [ + ":datatransfer_proto", + "//google/cloud:common_resources_proto", + ], ) ############################################################################## @@ -35,75 +43,55 @@ proto_library_with_info( ############################################################################## load( "@com_google_googleapis_imports//:imports.bzl", - "java_grpc_library", - "java_gapic_library", "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", "java_proto_library", - "java_resource_name_proto_library", - "java_test", ) -_JAVA_GRPC_DEPS = [ - "@com_google_api_grpc_proto_google_common_protos//jar", -] - java_proto_library( - name = "bigquerydatatransfer_java_proto", - deps = [":bigquerydatatransfer_proto"], + name = "datatransfer_java_proto", + deps = [":datatransfer_proto"], ) java_grpc_library( - name = "bigquerydatatransfer_java_grpc", - srcs = [":bigquerydatatransfer_proto"], - deps = [":bigquerydatatransfer_java_proto"] + _JAVA_GRPC_DEPS, -) - -java_resource_name_proto_library( - name = "bigquerydatatransfer_resource_name_java_proto", - gapic_yaml = "bigquerydatatransfer_gapic.yaml", - deps = [":bigquerydatatransfer_proto"], + name = "datatransfer_java_grpc", + srcs = [":datatransfer_proto"], + deps = [":datatransfer_java_proto"], ) java_gapic_library( - name = "bigquerydatatransfer_java_gapic", - src = ":bigquerydatatransfer_proto_with_info", + name = "datatransfer_java_gapic", + src = ":datatransfer_proto_with_info", gapic_yaml = "bigquerydatatransfer_gapic.yaml", - service_yaml = "//google/cloud/bigquery/datatransfer:datatransfer.yaml", - test_deps = [":bigquerydatatransfer_java_grpc"], + package = "google.cloud.bigquery.datatransfer.v1", + service_yaml = "bigquerydatatransfer_v1.yaml", + test_deps = [ + ":datatransfer_java_grpc", + ], deps = [ - ":bigquerydatatransfer_java_proto", - ":bigquerydatatransfer_resource_name_java_proto", - ] + _JAVA_GRPC_DEPS, + ":datatransfer_java_proto", + ], ) -[java_test( - name = test_name, - test_class = test_name, - runtime_deps = [ - ":bigquerydatatransfer_java_gapic_test", +java_gapic_test( + name = "datatransfer_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.bigquery.datatransfer.v1.DataTransferServiceClientTest", ], -) for test_name in [ - "com.google.cloud.bigquery.datatransfer.v1.DataTransferServiceClientTest", -]] + runtime_deps = [":datatransfer_java_gapic_test"], +) -# Opensource Packages +# Open Source Packages java_gapic_assembly_gradle_pkg( - name = "google-cloud-bigquerydatatransfer-v1-java", - client_deps = [ - ":bigquerydatatransfer_java_gapic", - ], - client_group = "com.google.cloud", - client_test_deps = [ - ":bigquerydatatransfer_java_gapic_test", + name = "google-cloud-bigquery-datatransfer-v1-java", + deps = [ + ":datatransfer_java_gapic", + ":datatransfer_java_grpc", + ":datatransfer_java_proto", + ":datatransfer_proto", ], - grpc_deps = [":bigquerydatatransfer_java_grpc"], - grpc_group = "com.google.api.grpc", - proto_deps = [ - ":bigquerydatatransfer_java_proto", - ":bigquerydatatransfer_proto", - ":bigquerydatatransfer_resource_name_java_proto", - ] + _JAVA_GRPC_DEPS, - version = "0.0.0-SNAPSHOT", ) ############################################################################## @@ -111,17 +99,17 @@ java_gapic_assembly_gradle_pkg( ############################################################################## load( "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", "go_proto_library", "go_test", - "go_gapic_library", - "go_gapic_assembly_pkg", ) go_proto_library( - name = "bigquerydatatransfer_go_proto", + name = "datatransfer_go_proto", compilers = ["@io_bazel_rules_go//proto:go_grpc"], importpath = "google.golang.org/genproto/googleapis/cloud/bigquery/datatransfer/v1", - protos = [":bigquerydatatransfer_proto"], + protos = [":datatransfer_proto"], deps = [ "//google/api:annotations_go_proto", "//google/rpc:status_go_proto", @@ -129,28 +117,257 @@ go_proto_library( ) go_gapic_library( - name = "bigquerydatatransfer_go_gapic", - src = ":bigquerydatatransfer_proto_with_info", - gapic_yaml = "bigquerydatatransfer_gapic.yaml", - importpath = "cloud.google.com/go/bigquery/datatransfer/apiv1", - service_yaml = "//google/cloud/bigquery/datatransfer:datatransfer.yaml", - deps = [":bigquerydatatransfer_go_proto"], + name = "datatransfer_go_gapic", + srcs = [":datatransfer_proto_with_info"], + grpc_service_config = "bigquerydatatransfer_grpc_service_config.json", + importpath = "cloud.google.com/go/bigquery/datatransfer/apiv1;datatransfer", + service_yaml = "bigquerydatatransfer_v1.yaml", + deps = [ + ":datatransfer_go_proto", + "@io_bazel_rules_go//proto/wkt:duration_go_proto", + ], ) go_test( - name = "bigquerydatatransfer_go_gapic_test", - srcs = [":bigquerydatatransfer_go_gapic_srcjar_test"], - embed = [":bigquerydatatransfer_go_gapic"], + name = "datatransfer_go_gapic_test", + srcs = [":datatransfer_go_gapic_srcjar_test"], + embed = [":datatransfer_go_gapic"], importpath = "cloud.google.com/go/bigquery/datatransfer/apiv1", ) -# Opensource Packages +# Open Source Packages go_gapic_assembly_pkg( - name = "gapi-cloud-bigquerydatatransfer-v1-go", + name = "gapi-cloud-bigquery-datatransfer-v1-go", deps = [ - ":bigquerydatatransfer_go_gapic", - ":bigquerydatatransfer_go_gapic_srcjar-smoke-test.srcjar", - ":bigquerydatatransfer_go_gapic_srcjar-test.srcjar", - ":bigquerydatatransfer_go_proto", + ":datatransfer_go_gapic", + ":datatransfer_go_gapic_srcjar-test.srcjar", + ":datatransfer_go_proto", ], ) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "datatransfer_moved_proto", + srcs = [":datatransfer_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/rpc:status_proto", + "@com_google_protobuf//:duration_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:struct_proto", + "@com_google_protobuf//:timestamp_proto", + "@com_google_protobuf//:wrappers_proto", + ], +) + +py_proto_library( + name = "datatransfer_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":datatransfer_moved_proto"], +) + +py_grpc_library( + name = "datatransfer_py_grpc", + srcs = [":datatransfer_moved_proto"], + deps = [":datatransfer_py_proto"], +) + +py_gapic_library( + name = "datatransfer_py_gapic", + src = ":datatransfer_proto_with_info", + gapic_yaml = "bigquerydatatransfer_gapic.yaml", + package = "google.cloud.bigquery.datatransfer.v1", + service_yaml = "bigquerydatatransfer_v1.yaml", + deps = [ + ":datatransfer_py_grpc", + ":datatransfer_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "bigquery-datatransfer-v1-py", + deps = [ + ":datatransfer_py_gapic", + ":datatransfer_py_grpc", + ":datatransfer_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "datatransfer_php_proto", + deps = [":datatransfer_proto"], +) + +php_grpc_library( + name = "datatransfer_php_grpc", + srcs = [":datatransfer_proto"], + deps = [":datatransfer_php_proto"], +) + +php_gapic_library( + name = "datatransfer_php_gapic", + src = ":datatransfer_proto_with_info", + gapic_yaml = "bigquerydatatransfer_gapic.yaml", + package = "google.cloud.bigquery.datatransfer.v1", + service_yaml = "bigquerydatatransfer_v1.yaml", + deps = [ + ":datatransfer_php_grpc", + ":datatransfer_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-bigquery-datatransfer-v1-php", + deps = [ + ":datatransfer_php_gapic", + ":datatransfer_php_grpc", + ":datatransfer_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "datatransfer_nodejs_gapic", + src = ":datatransfer_proto_with_info", + gapic_yaml = "bigquerydatatransfer_gapic.yaml", + package = "google.cloud.bigquery.datatransfer.v1", + service_yaml = "bigquerydatatransfer_v1.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "bigquery-datatransfer-v1-nodejs", + deps = [ + ":datatransfer_nodejs_gapic", + ":datatransfer_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "datatransfer_ruby_proto", + deps = [":datatransfer_proto"], +) + +ruby_grpc_library( + name = "datatransfer_ruby_grpc", + srcs = [":datatransfer_proto"], + deps = [":datatransfer_ruby_proto"], +) + +ruby_gapic_library( + name = "datatransfer_ruby_gapic", + src = ":datatransfer_proto_with_info", + gapic_yaml = "bigquerydatatransfer_gapic.yaml", + package = "google.cloud.bigquery.datatransfer.v1", + service_yaml = "bigquerydatatransfer_v1.yaml", + deps = [ + ":datatransfer_ruby_grpc", + ":datatransfer_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-bigquery-datatransfer-v1-ruby", + deps = [ + ":datatransfer_ruby_gapic", + ":datatransfer_ruby_grpc", + ":datatransfer_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "datatransfer_csharp_proto", + deps = [":datatransfer_proto"], +) + +csharp_grpc_library( + name = "datatransfer_csharp_grpc", + srcs = [":datatransfer_proto"], + deps = [":datatransfer_csharp_proto"], +) + +csharp_gapic_library( + name = "datatransfer_csharp_gapic", + src = ":datatransfer_proto_with_info", + gapic_yaml = "bigquerydatatransfer_gapic.yaml", + package = "google.cloud.bigquery.datatransfer.v1", + service_yaml = "bigquerydatatransfer_v1.yaml", + deps = [ + ":datatransfer_csharp_grpc", + ":datatransfer_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-bigquery-datatransfer-v1-csharp", + deps = [ + ":datatransfer_csharp_gapic", + ":datatransfer_csharp_grpc", + ":datatransfer_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/bigquerydatatransfer_gapic.legacy.yaml b/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/bigquerydatatransfer_gapic.legacy.yaml new file mode 100644 index 000000000..1320af240 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/bigquerydatatransfer_gapic.legacy.yaml @@ -0,0 +1,424 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 1.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.bigquery.datatransfer.v1 + python: + package_name: google.cloud.bigquery_datatransfer_v1.gapic + go: + package_name: cloud.google.com/go/bigquery/datatransfer/apiv1 + csharp: + package_name: Google.Cloud.BigQuery.DataTransfer.V1 + ruby: + package_name: Google::Cloud::Bigquery::DataTransfer::V1 + release_level: BETA + php: + package_name: Google\Cloud\BigQuery\DataTransfer\V1 + nodejs: + package_name: bigquery-data-transfer.v1 + domain_layer_location: google-cloud +collection_oneofs: +- oneof_name: parent_oneof + collection_names: + - project + - location +- oneof_name: data_source_oneof + collection_names: + - project_data_source + - location_data_source +- oneof_name: transfer_config_oneof + collection_names: + - project_transfer_config + - location_transfer_config +- oneof_name: run_oneof + collection_names: + - project_run + - location_run +collections: +- name_pattern: projects/{project} + entity_name: project + language_overrides: + - language: csharp + common_resource_name: Google.Api.Gax.ResourceNames.ProjectName +- name_pattern: projects/{project}/locations/{location} + entity_name: location +- name_pattern: projects/{project}/dataSources/{data_source} + entity_name: project_data_source +- name_pattern: projects/{project}/locations/{location}/dataSources/{data_source} + entity_name: location_data_source +- name_pattern: projects/{project}/transferConfigs/{transfer_config} + entity_name: project_transfer_config +- name_pattern: projects/{project}/locations/{location}/transferConfigs/{transfer_config} + entity_name: location_transfer_config +- name_pattern: projects/{project}/transferConfigs/{transfer_config}/runs/{run} + entity_name: project_run +- name_pattern: projects/{project}/locations/{location}/transferConfigs/{transfer_config}/runs/{run} + entity_name: location_run +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.cloud.bigquery.datatransfer.v1.DataTransferService + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: + - name_pattern: projects/{project}/locations/{location} + entity_name: location + # Definition for smoke test. + smoke_test: + method: ListDataSources + init_fields: + - parent%project=$PROJECT_ID + - parent%location="us-central1" + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - UNAVAILABLE + - DEADLINE_EXCEEDED + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # name - The simple name of the method. + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce + # method overloads which allow a client to directly pass request message + # fields as method parameters. This information may or may not be used, + # depending on the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request + # message. + # required_fields - Fields that are always required for a request to be + # valid. + # + # resource_name_treatment - An enum that specifies how to treat the + # resource name formats defined in the field_name_patterns + # and response_field_name_patterns fields. + # UNSET: default value + # NONE: the collection configs will not be used by the generated code. + # VALIDATE: string fields will be validated by the client against the + # specified resource name formats. + # STATIC_TYPES: the client will use generated types for resource names. + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a + # paging list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It + # defines which fields match the paging pattern in the request. The + # request consists of a page_size_field and a token_field. The + # page_size_field is the name of the optional field specifying the + # maximum number of elements to be returned in the response. The + # token_field is the name of the field in the request containing the + # page token. + # The response specifies response information of the list method. It + # defines which fields match the paging pattern in the response. The + # response consists of a token_field and a resources_field. The + # token_field is the name of the field in the response containing the + # next page token. The resources_field is the name of the field in the + # response containing the list of resources belonging to the page. + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: GetDataSource + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: data_source_oneof + timeout_millis: 20000 + resource_name_treatment: STATIC_TYPES + header_request_params: + - name + - name: ListDataSources + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: data_sources + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: parent_oneof + timeout_millis: 20000 + resource_name_treatment: STATIC_TYPES + header_request_params: + - parent + - name: CreateTransferConfig + flattening: + groups: + - parameters: + - parent + - transfer_config + required_fields: + - parent + - transfer_config + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: parent_oneof + timeout_millis: 30000 + resource_name_treatment: STATIC_TYPES + header_request_params: + - parent + - name: UpdateTransferConfig + flattening: + groups: + - parameters: + - transfer_config + - update_mask + required_fields: + - transfer_config + - update_mask + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + transfer_config.name: transfer_config_oneof + timeout_millis: 30000 + resource_name_treatment: STATIC_TYPES + header_request_params: + - transfer_config.name + - name: DeleteTransferConfig + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: transfer_config_oneof + timeout_millis: 30000 + resource_name_treatment: STATIC_TYPES + header_request_params: + - name + - name: GetTransferConfig + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: transfer_config_oneof + timeout_millis: 30000 + resource_name_treatment: STATIC_TYPES + header_request_params: + - name + - name: ListTransferConfigs + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: transfer_configs + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: parent_oneof + timeout_millis: 30000 + resource_name_treatment: STATIC_TYPES + header_request_params: + - parent + - name: ScheduleTransferRuns + flattening: + groups: + - parameters: + - parent + - start_time + - end_time + required_fields: + - parent + - start_time + - end_time + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: transfer_config_oneof + timeout_millis: 30000 + resource_name_treatment: STATIC_TYPES + header_request_params: + - parent + - name: GetTransferRun + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: run_oneof + timeout_millis: 30000 + resource_name_treatment: STATIC_TYPES + header_request_params: + - name + - name: DeleteTransferRun + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: run_oneof + timeout_millis: 30000 + resource_name_treatment: STATIC_TYPES + header_request_params: + - name + - name: ListTransferRuns + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: transfer_runs + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: transfer_config_oneof + timeout_millis: 30000 + resource_name_treatment: STATIC_TYPES + header_request_params: + - parent + - name: ListTransferLogs + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: transfer_messages + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: run_oneof + timeout_millis: 30000 + resource_name_treatment: STATIC_TYPES + header_request_params: + - parent + - name: CheckValidCreds + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: data_source_oneof + timeout_millis: 30000 + resource_name_treatment: STATIC_TYPES + header_request_params: + - name +resource_name_generation: +- message_name: GetDataSourceRequest + field_entity_map: + name: data_source_oneof +- message_name: ListDataSourcesRequest + field_entity_map: + parent: parent_oneof +- message_name: CreateTransferConfigRequest + field_entity_map: + parent: parent_oneof +- message_name: GetTransferConfigRequest + field_entity_map: + name: transfer_config_oneof +- message_name: DeleteTransferConfigRequest + field_entity_map: + name: transfer_config_oneof +- message_name: GetTransferRunRequest + field_entity_map: + name: run_oneof +- message_name: DeleteTransferRunRequest + field_entity_map: + name: run_oneof +- message_name: ListTransferConfigsRequest + field_entity_map: + parent: parent_oneof +- message_name: ListTransferRunsRequest + field_entity_map: + parent: transfer_config_oneof +- message_name: ListTransferLogsRequest + field_entity_map: + parent: run_oneof +- message_name: CheckValidCredsRequest + field_entity_map: + name: data_source_oneof +- message_name: ScheduleTransferRunsRequest + field_entity_map: + parent: transfer_config_oneof +- message_name: DataSource + field_entity_map: + name: data_source_oneof +- message_name: TransferConfig + field_entity_map: + name: transfer_config_oneof +- message_name: TransferRun + field_entity_map: + name: run_oneof diff --git a/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/bigquerydatatransfer_gapic.yaml b/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/bigquerydatatransfer_gapic.yaml index 82ea62ff5..cca93ce4d 100644 --- a/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/bigquerydatatransfer_gapic.yaml +++ b/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/bigquerydatatransfer_gapic.yaml @@ -1,5 +1,5 @@ type: com.google.api.codegen.ConfigProto -config_schema_version: 1.0.0 +config_schema_version: 2.0.0 # The settings of generated code in a specific language. language_settings: java: @@ -18,44 +18,11 @@ language_settings: nodejs: package_name: bigquery-data-transfer.v1 domain_layer_location: google-cloud -collection_oneofs: -- oneof_name: parent_oneof - collection_names: - - project - - location -- oneof_name: data_source_oneof - collection_names: - - project_data_source - - location_data_source -- oneof_name: transfer_config_oneof - collection_names: - - project_transfer_config - - location_transfer_config -- oneof_name: run_oneof - collection_names: - - project_run - - location_run collections: -- name_pattern: projects/{project} - entity_name: project +- entity_name: project language_overrides: - language: csharp common_resource_name: Google.Api.Gax.ResourceNames.ProjectName -- name_pattern: projects/{project}/locations/{location} - entity_name: location -- name_pattern: projects/{project}/dataSources/{data_source} - entity_name: project_data_source -- name_pattern: projects/{project}/locations/{location}/dataSources/{data_source} - entity_name: location_data_source -- name_pattern: projects/{project}/transferConfigs/{transfer_config} - entity_name: project_transfer_config -- name_pattern: projects/{project}/locations/{location}/transferConfigs/{transfer_config} - entity_name: location_transfer_config -- name_pattern: projects/{project}/transferConfigs/{transfer_config}/runs/{run} - entity_name: project_run -- name_pattern: projects/{project}/locations/{location}/transferConfigs/{transfer_config}/runs/{run} - entity_name: location_run -# A list of API interface configurations. interfaces: # The fully qualified name of the API interface. - name: google.cloud.bigquery.datatransfer.v1.DataTransferService @@ -69,356 +36,29 @@ interfaces: # methods. If empty, no name methods are generated. # The entity_name is the name to be used as a basis for generated methods and # classes. - collections: - - name_pattern: projects/{project}/locations/{location} - entity_name: location + deprecated_collections: + - name_pattern: projects/{project}/dataSources/{data_source} + entity_name: project_data_source + - name_pattern: projects/{project}/locations/{location}/dataSources/{data_source} + entity_name: location_data_source + - name_pattern: projects/{project}/transferConfigs/{transfer_config} + entity_name: project_transfer_config + - name_pattern: projects/{project}/locations/{location}/transferConfigs/{transfer_config} + entity_name: location_transfer_config + - name_pattern: projects/{project}/transferConfigs/{transfer_config}/runs/{run} + entity_name: project_run + - name_pattern: projects/{project}/locations/{location}/transferConfigs/{transfer_config}/runs/{run} + entity_name: location_run # Definition for smoke test. smoke_test: method: ListDataSources init_fields: - parent%project=$PROJECT_ID - parent%location="us-central1" - # Definition for retryable codes. - retry_codes_def: - - name: idempotent - retry_codes: - - UNAVAILABLE - - DEADLINE_EXCEEDED - - name: non_idempotent - retry_codes: [] - # Definition for retry/backoff parameters. - retry_params_def: - - name: default - initial_retry_delay_millis: 100 - retry_delay_multiplier: 1.3 - max_retry_delay_millis: 60000 - initial_rpc_timeout_millis: 20000 - rpc_timeout_multiplier: 1 - max_rpc_timeout_millis: 20000 - total_timeout_millis: 600000 - # A list of method configurations. - # Common properties: - # name - The simple name of the method. - # flattening - Specifies the configuration for parameter flattening. - # Describes the parameter groups for which a generator should produce - # method overloads which allow a client to directly pass request message - # fields as method parameters. This information may or may not be used, - # depending on the target language. - # Consists of groups, which each represent a list of parameters to be - # flattened. Each parameter listed must be a field of the request - # message. - # required_fields - Fields that are always required for a request to be - # valid. - # - # resource_name_treatment - An enum that specifies how to treat the - # resource name formats defined in the field_name_patterns - # and response_field_name_patterns fields. - # UNSET: default value - # NONE: the collection configs will not be used by the generated code. - # VALIDATE: string fields will be validated by the client against the - # specified resource name formats. - # STATIC_TYPES: the client will use generated types for resource names. - # page_streaming - Specifies the configuration for paging. - # Describes information for generating a method which transforms a - # paging list RPC into a stream of resources. - # Consists of a request and a response. - # The request specifies request information of the list method. It - # defines which fields match the paging pattern in the request. The - # request consists of a page_size_field and a token_field. The - # page_size_field is the name of the optional field specifying the - # maximum number of elements to be returned in the response. The - # token_field is the name of the field in the request containing the - # page token. - # The response specifies response information of the list method. It - # defines which fields match the paging pattern in the response. The - # response consists of a token_field and a resources_field. The - # token_field is the name of the field in the response containing the - # next page token. The resources_field is the name of the field in the - # response containing the list of resources belonging to the page. - # retry_codes_name - Specifies the configuration for retryable codes. The - # name must be defined in interfaces.retry_codes_def. - # retry_params_name - Specifies the configuration for retry/backoff - # parameters. The name must be defined in interfaces.retry_params_def. - # field_name_patterns - Maps the field name of the request type to - # entity_name of interfaces.collections. - # Specifies the string pattern that the field must follow. - # timeout_millis - Specifies the default timeout for a non-retrying call. If - # the call is retrying, refer to retry_params_name instead. methods: - - name: GetDataSource - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: data_source_oneof - timeout_millis: 20000 - resource_name_treatment: STATIC_TYPES - header_request_params: - - name - - name: ListDataSources - flattening: - groups: - - parameters: - - parent - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: data_sources - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: parent_oneof - timeout_millis: 20000 - resource_name_treatment: STATIC_TYPES - header_request_params: - - parent - - name: CreateTransferConfig - flattening: - groups: - - parameters: - - parent - - transfer_config - required_fields: - - parent - - transfer_config - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: parent_oneof - timeout_millis: 30000 - resource_name_treatment: STATIC_TYPES - header_request_params: - - parent - - name: UpdateTransferConfig - flattening: - groups: - - parameters: - - transfer_config - - update_mask - required_fields: - - transfer_config - - update_mask - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - transfer_config.name: transfer_config_oneof - timeout_millis: 30000 - resource_name_treatment: STATIC_TYPES - header_request_params: - - transfer_config.name - name: DeleteTransferConfig - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: transfer_config_oneof - timeout_millis: 30000 - resource_name_treatment: STATIC_TYPES - header_request_params: - - name - - name: GetTransferConfig - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: transfer_config_oneof - timeout_millis: 30000 - resource_name_treatment: STATIC_TYPES - header_request_params: - - name - - name: ListTransferConfigs - flattening: - groups: - - parameters: - - parent - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: transfer_configs retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: parent_oneof - timeout_millis: 30000 - resource_name_treatment: STATIC_TYPES - header_request_params: - - parent - - name: ScheduleTransferRuns - flattening: - groups: - - parameters: - - parent - - start_time - - end_time - required_fields: - - parent - - start_time - - end_time - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: transfer_config_oneof - timeout_millis: 30000 - resource_name_treatment: STATIC_TYPES - header_request_params: - - parent - - name: GetTransferRun - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: run_oneof - timeout_millis: 30000 - resource_name_treatment: STATIC_TYPES - header_request_params: - - name - name: DeleteTransferRun - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: run_oneof - timeout_millis: 30000 - resource_name_treatment: STATIC_TYPES - header_request_params: - - name - - name: ListTransferRuns - flattening: - groups: - - parameters: - - parent - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: transfer_runs - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: transfer_config_oneof - timeout_millis: 30000 - resource_name_treatment: STATIC_TYPES - header_request_params: - - parent - - name: ListTransferLogs - flattening: - groups: - - parameters: - - parent - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: transfer_messages retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: run_oneof - timeout_millis: 30000 - resource_name_treatment: STATIC_TYPES - header_request_params: - - parent - name: CheckValidCreds - flattening: - groups: - - parameters: - - name - required_fields: - - name retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: data_source_oneof - timeout_millis: 30000 - resource_name_treatment: STATIC_TYPES - header_request_params: - - name -resource_name_generation: -- message_name: GetDataSourceRequest - field_entity_map: - name: data_source_oneof -- message_name: ListDataSourcesRequest - field_entity_map: - parent: parent_oneof -- message_name: CreateTransferConfigRequest - field_entity_map: - parent: parent_oneof -- message_name: GetTransferConfigRequest - field_entity_map: - name: transfer_config_oneof -- message_name: DeleteTransferConfigRequest - field_entity_map: - name: transfer_config_oneof -- message_name: GetTransferRunRequest - field_entity_map: - name: run_oneof -- message_name: DeleteTransferRunRequest - field_entity_map: - name: run_oneof -- message_name: ListTransferConfigsRequest - field_entity_map: - parent: parent_oneof -- message_name: ListTransferRunsRequest - field_entity_map: - parent: transfer_config_oneof -- message_name: ListTransferLogsRequest - field_entity_map: - parent: run_oneof -- message_name: CheckValidCredsRequest - field_entity_map: - name: data_source_oneof -- message_name: ScheduleTransferRunsRequest - field_entity_map: - parent: transfer_config_oneof -- message_name: DataSource - field_entity_map: - name: data_source_oneof -- message_name: TransferConfig - field_entity_map: - name: transfer_config_oneof -- message_name: TransferRun - field_entity_map: - name: run_oneof diff --git a/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/bigquerydatatransfer_grpc_service_config.json b/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/bigquerydatatransfer_grpc_service_config.json new file mode 100755 index 000000000..fae673513 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/bigquerydatatransfer_grpc_service_config.json @@ -0,0 +1,76 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.bigquery.datatransfer.v1.DataTransferService", + "method": "GetDataSource" + }, + { + "service": "google.cloud.bigquery.datatransfer.v1.DataTransferService", + "method": "ListDataSources" + }, + { + "service": "google.cloud.bigquery.datatransfer.v1.DataTransferService", + "method": "DeleteTransferConfig" + }, + { + "service": "google.cloud.bigquery.datatransfer.v1.DataTransferService", + "method": "GetTransferConfig" + }, + { + "service": "google.cloud.bigquery.datatransfer.v1.DataTransferService", + "method": "ListTransferConfigs" + }, + { + "service": "google.cloud.bigquery.datatransfer.v1.DataTransferService", + "method": "GetTransferRun" + }, + { + "service": "google.cloud.bigquery.datatransfer.v1.DataTransferService", + "method": "DeleteTransferRun" + }, + { + "service": "google.cloud.bigquery.datatransfer.v1.DataTransferService", + "method": "ListTransferRuns" + }, + { + "service": "google.cloud.bigquery.datatransfer.v1.DataTransferService", + "method": "ListTransferLogs" + }, + { + "service": "google.cloud.bigquery.datatransfer.v1.DataTransferService", + "method": "CheckValidCreds" + } + ], + "timeout": "20s", + "retryPolicy": { + "maxAttempts": 5, + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.bigquery.datatransfer.v1.DataTransferService", + "method": "CreateTransferConfig" + }, + { + "service": "google.cloud.bigquery.datatransfer.v1.DataTransferService", + "method": "UpdateTransferConfig" + }, + { + "service": "google.cloud.bigquery.datatransfer.v1.DataTransferService", + "method": "ScheduleTransferRuns" + } + ], + "timeout": "30s" + } + ] +} diff --git a/third_party/googleapis/google/cloud/bigquery/datatransfer/bigquerydatatransfer.yaml b/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/bigquerydatatransfer_v1.yaml similarity index 100% rename from third_party/googleapis/google/cloud/bigquery/datatransfer/bigquerydatatransfer.yaml rename to third_party/googleapis/google/cloud/bigquery/datatransfer/v1/bigquerydatatransfer_v1.yaml diff --git a/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/datasource.proto b/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/datasource.proto deleted file mode 100644 index d7400a559..000000000 --- a/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/datasource.proto +++ /dev/null @@ -1,542 +0,0 @@ -// Copyright 2019 Google LLC. -// -// Licensed under the Apache License, Version 2.0 (the "License"); -// you may not use this file except in compliance with the License. -// You may obtain a copy of the License at -// -// http://www.apache.org/licenses/LICENSE-2.0 -// -// Unless required by applicable law or agreed to in writing, software -// distributed under the License is distributed on an "AS IS" BASIS, -// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -// See the License for the specific language governing permissions and -// limitations under the License. -// - -syntax = "proto3"; - -package google.cloud.bigquery.datatransfer.v1; - -import "google/api/annotations.proto"; -import "google/cloud/bigquery/datatransfer/v1/datatransfer.proto"; -import "google/cloud/bigquery/datatransfer/v1/transfer.proto"; -import "google/protobuf/duration.proto"; -import "google/protobuf/empty.proto"; -import "google/protobuf/field_mask.proto"; -import "google/protobuf/timestamp.proto"; -import "google/protobuf/wrappers.proto"; -import "google/api/client.proto"; - -option csharp_namespace = "Google.Cloud.BigQuery.DataTransfer.V1"; -option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/datatransfer/v1;datatransfer"; -option java_multiple_files = true; -option java_outer_classname = "DataSourceProto"; -option java_package = "com.google.cloud.bigquery.datatransfer.v1"; -option php_namespace = "Google\\Cloud\\BigQuery\\DataTransfer\\V1"; - -// The Google BigQuery Data Transfer API allows BigQuery users to -// configure transfer of their data from other Google Products into BigQuery. -// This service exposes methods that should be used by data source backend. -service DataSourceService { - option (google.api.default_host) = "bigquerydatatransfer.googleapis.com"; - - // Update a transfer run. If successful, resets - // data_source.update_deadline_seconds timer. - rpc UpdateTransferRun(UpdateTransferRunRequest) returns (TransferRun) { - option (google.api.http) = { - patch: "/v1/{transfer_run.name=projects/*/locations/*/transferConfigs/*/runs/*}" - body: "transfer_run" - }; - } - - // Log messages for a transfer run. If successful (at least 1 message), resets - // data_source.update_deadline_seconds timer. - rpc LogTransferRunMessages(LogTransferRunMessagesRequest) returns (google.protobuf.Empty) { - option (google.api.http) = { - post: "/v1/{name=projects/*/locations/*/transferConfigs/*/runs/*}:logMessages" - body: "*" - }; - } - - // Notify the Data Transfer Service that data is ready for loading. - // The Data Transfer Service will start and monitor multiple BigQuery Load - // jobs for a transfer run. Monitored jobs will be automatically retried - // and produce log messages when starting and finishing a job. - // Can be called multiple times for the same transfer run. - rpc StartBigQueryJobs(StartBigQueryJobsRequest) returns (google.protobuf.Empty) { - option (google.api.http) = { - post: "/v1/{name=projects/*/locations/*/transferConfigs/*/runs/*}:startBigQueryJobs" - body: "*" - }; - } - - // Notify the Data Transfer Service that the data source is done processing - // the run. No more status updates or requests to start/monitor jobs will be - // accepted. The run will be finalized by the Data Transfer Service when all - // monitored jobs are completed. - // Does not need to be called if the run is set to FAILED. - rpc FinishRun(FinishRunRequest) returns (google.protobuf.Empty) { - option (google.api.http) = { - post: "/v1/{name=projects/*/locations/*/transferConfigs/*/runs/*}:finishRun" - body: "*" - }; - } - - // Creates a data source definition. Calling this method will automatically - // use your credentials to create the following Google Cloud resources in - // YOUR Google Cloud project. - // 1. OAuth client - // 2. Pub/Sub Topics and Subscriptions in each supported_location_ids. e.g., - // projects/{project_id}/{topics|subscriptions}/bigquerydatatransfer.{data_source_id}.{location_id}.run - // The field data_source.client_id should be left empty in the input request, - // as the API will create a new OAuth client on behalf of the caller. On the - // other hand data_source.scopes usually need to be set when there are OAuth - // scopes that need to be granted by end users. - // 3. We need a longer deadline due to the 60 seconds SLO from Pub/Sub admin - // Operations. This also applies to update and delete data source definition. - rpc CreateDataSourceDefinition(CreateDataSourceDefinitionRequest) returns (DataSourceDefinition) { - option (google.api.http) = { - post: "/v1/{parent=projects/*/locations/*}/dataSourceDefinitions" - body: "data_source_definition" - }; - } - - // Updates an existing data source definition. If changing - // supported_location_ids, triggers same effects as mentioned in "Create a - // data source definition." - rpc UpdateDataSourceDefinition(UpdateDataSourceDefinitionRequest) returns (DataSourceDefinition) { - option (google.api.http) = { - patch: "/v1/{data_source_definition.name=projects/*/locations/*/dataSourceDefinitions/*}" - body: "data_source_definition" - }; - } - - // Deletes a data source definition, all of the transfer configs associated - // with this data source definition (if any) must be deleted first by the user - // in ALL regions, in order to delete the data source definition. - // This method is primarily meant for deleting data sources created during - // testing stage. - // If the data source is referenced by transfer configs in the region - // specified in the request URL, the method will fail immediately. If in the - // current region (e.g., US) it's not used by any transfer configs, but in - // another region (e.g., EU) it is, then although the method will succeed in - // region US, but it will fail when the deletion operation is replicated to - // region EU. And eventually, the system will replicate the data source - // definition back from EU to US, in order to bring all regions to - // consistency. The final effect is that the data source appears to be - // 'undeleted' in the US region. - rpc DeleteDataSourceDefinition(DeleteDataSourceDefinitionRequest) returns (google.protobuf.Empty) { - option (google.api.http) = { - delete: "/v1/{name=projects/*/locations/*/dataSourceDefinitions/*}" - }; - } - - // Retrieves an existing data source definition. - rpc GetDataSourceDefinition(GetDataSourceDefinitionRequest) returns (DataSourceDefinition) { - option (google.api.http) = { - get: "/v1/{name=projects/*/locations/*/dataSourceDefinitions/*}" - }; - } - - // Lists supported data source definitions. - rpc ListDataSourceDefinitions(ListDataSourceDefinitionsRequest) returns (ListDataSourceDefinitionsResponse) { - option (google.api.http) = { - get: "/v1/{parent=projects/*/locations/*}/dataSourceDefinitions" - }; - } -} - -// Describes data which should be imported. -message ImportedDataInfo { - // Defines schema of a field in the imported data. - message FieldSchema { - // LINT.IfChange - // Field type. - enum Type { - // Illegal value. - TYPE_UNSPECIFIED = 0; - - // 64K, UTF8. - STRING = 1; - - // 64-bit signed. - INTEGER = 2; - - // 64-bit IEEE floating point. - FLOAT = 3; - - // Aggregate type. - RECORD = 4; - - // 64K, Binary. - BYTES = 5; - - // 2-valued. - BOOLEAN = 6; - - // 64-bit signed usec since UTC epoch. - TIMESTAMP = 7; - - // Civil date - Year, Month, Day. - DATE = 8; - - // Civil time - Hour, Minute, Second, Microseconds. - TIME = 9; - - // Combination of civil date and civil time. - DATETIME = 10; - - // Numeric type with 38 decimal digits of precision and 9 decimal digits - // of scale. - NUMERIC = 11; - - // Geography object (go/googlesql_geography). - GEOGRAPHY = 12; - } - - // Field name. Matches: [A-Za-z_][A-Za-z_0-9]{0,127} - string field_name = 1; - - // Field type - Type type = 2; - - // Is field repeated. - bool is_repeated = 3; - - // Description for this field. - string description = 4; - - // Present iff type == RECORD. - RecordSchema schema = 5; - } - - // Describes schema of the data to be ingested. - message RecordSchema { - // One field per column in the record. - repeated FieldSchema fields = 1; - } - - // External table definition. These tables can be referenced with 'name' - // in the query and can be read just like any other table. - message TableDefinition { - // CSV specific options. - message CsvOptions { - // The delimiter. We currently restrict this to U+0001 to U+00FF and - // apply additional constraints during validation. - google.protobuf.StringValue field_delimiter = 1; - - // Whether CSV files are allowed to have quoted newlines. If quoted - // newlines are allowed, we can't split CSV files. - google.protobuf.BoolValue allow_quoted_newlines = 2; - - // The quote character. We currently restrict this to U+0000 to U+00FF - // and apply additional constraints during validation. Set to '\0' to - // indicate no quote is used. - google.protobuf.StringValue quote_char = 3; - - // Number of leading rows to skip. - google.protobuf.Int64Value skip_leading_rows = 4; - - // Accept rows that are missing trailing optional columns. - google.protobuf.BoolValue allow_jagged_rows = 5; - } - - // BigQuery table_id (required). This will be used to reference this - // table in the query. - string table_id = 1; - - // URIs for the data to be imported. All URIs must be from the same storage - // system. - repeated string source_uris = 2; - - // Describes the format of the data in source_uri. - Format format = 3; - - // Specify the maximum number of bad records that can be ignored. - // If bad records exceed this threshold the query is aborted. - int32 max_bad_records = 4; - - // Character encoding of the input when applicable (CSV, JSON). - // Defaults to UTF8. - Encoding encoding = 5; - - // CSV specific options. - CsvOptions csv_options = 6; - - // Optional schema for the data. When not specified for JSON and CSV formats - // we will try to detect it automatically. - RecordSchema schema = 7; - - // Indicates if extra values that are not represented in the table schema is - // allowed. - google.protobuf.BoolValue ignore_unknown_values = 10; - } - - // Data format. - enum Format { - // Unspecified format. In this case, we have to infer the format from the - // data source. - FORMAT_UNSPECIFIED = 0; - - // CSV format. - CSV = 1; - - // Newline-delimited JSON. - JSON = 2; - - // Avro format. See http://avro.apache.org . - AVRO = 3; - - // RecordIO. - RECORDIO = 4; - - // ColumnIO. - COLUMNIO = 5; - - // Capacitor. - CAPACITOR = 6; - - // Parquet format. See https://parquet.apache.org . - PARQUET = 7; - - // ORC format. See https://orc.apache.org . - ORC = 8; - } - - // Encoding of input data in CSV/JSON format. - enum Encoding { - // Default encoding (UTF8). - ENCODING_UNSPECIFIED = 0; - - // ISO_8859_1 encoding. - ISO_8859_1 = 1; - - // UTF8 encoding. - UTF8 = 2; - } - - // SQL query to run. When empty, API checks that there is only one - // table_def specified and loads this table. Only Standard SQL queries - // are accepted. Legacy SQL is not allowed. - string sql = 1; - - // Table where results should be written. - string destination_table_id = 2; - - // The description of a destination table. This can be several sentences - // or paragraphs describing the table contents in detail. - string destination_table_description = 10; - - // When used WITHOUT the "sql" parameter, describes the schema of the - // destination table. - // When used WITH the "sql" parameter, describes tables with data stored - // outside of BigQuery. - repeated TableDefinition table_defs = 3; - - // Inline code for User-defined function resources. - // Ignored when "sql" parameter is empty. - repeated string user_defined_functions = 4; - - // Specifies the action if the destination table already exists. - WriteDisposition write_disposition = 6; -} - -// A request to update a transfer run. -message UpdateTransferRunRequest { - // Run name must be set and correspond to an already existing run. Only - // state, error_status, and data_version fields will be updated. All other - // fields will be ignored. - TransferRun transfer_run = 1; - - // Required list of fields to be updated in this request. - google.protobuf.FieldMask update_mask = 2; -} - -// A request to add transfer status messages to the run. -message LogTransferRunMessagesRequest { - // Name of the resource in the form: - // "projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}/runs/{run_id}" - string name = 1; - - // Messages to append. - repeated TransferMessage transfer_messages = 2; -} - -// A request to start and monitor a BigQuery load job. -message StartBigQueryJobsRequest { - // Name of the resource in the form: - // "projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}/runs/{run_id}" - string name = 1; - - // Import jobs which should be started and monitored. - repeated ImportedDataInfo imported_data = 2; - - // User credentials which should be used to start/monitor - // BigQuery jobs. If not specified, then jobs - // are started using data source service account credentials. - // This may be OAuth token or JWT token. - bytes user_credentials = 3; - - // The number of BQ Jobs that can run in parallel. - int32 max_parallelism = 8; -} - -// A request to finish a run. -message FinishRunRequest { - // Name of the resource in the form: - // "projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}/runs/{run_id}" - string name = 1; -} - -// Represents the request of the CreateDataSourceDefinition method. -message CreateDataSourceDefinitionRequest { - // The BigQuery project id for which data source definition is associated. - // Must be in the form: `projects/{project_id}/locations/{location_id}` - string parent = 1; - - // Data source definition. - DataSourceDefinition data_source_definition = 2; -} - -// Represents the request of the UpdateDataSourceDefinition method. -message UpdateDataSourceDefinitionRequest { - // Data source definition. - DataSourceDefinition data_source_definition = 1; - - // Update field mask. - google.protobuf.FieldMask update_mask = 2; -} - -// Represents the request of the DeleteDataSourceDefinition method. All transfer -// configs associated with the data source must be deleted first, before the -// data source can be deleted. -message DeleteDataSourceDefinitionRequest { - // The field will contain name of the resource requested, for example: - // `projects/{project_id}/locations/{location_id}/dataSourceDefinitions/{data_source_id}` - string name = 1; -} - -// Represents the request of the GetDataSourceDefinition method. -message GetDataSourceDefinitionRequest { - // The field will contain name of the resource requested. - string name = 1; -} - -// Options for writing to the table. -// The WRITE_EMPTY option is intentionally excluded from the enum and is not -// supported by the data transfer service. -enum WriteDisposition { - // The default writeDispostion - WRITE_DISPOSITION_UNSPECIFIED = 0; - - // overwrites the table data. - WRITE_TRUNCATE = 1; - - // the data is appended to the table. - // Note duplication might happen if this mode is used. - WRITE_APPEND = 2; -} - -// Represents the request of the ListDataSourceDefinitions method. -message ListDataSourceDefinitionsRequest { - // The BigQuery project id for which data sources should be returned. - // Must be in the form: `projects/{project_id}/locations/{location_id}` - string parent = 1; - - // Pagination token, which can be used to request a specific page - // of `ListDataSourceDefinitionsRequest` list results. For multiple-page - // results, `ListDataSourceDefinitionsResponse` outputs a `next_page` token, - // which can be used as the `page_token` value to request the next page of - // the list results. - string page_token = 2; - - // Page size. The default page size is the maximum value of 1000 results. - int32 page_size = 3; -} - -// Returns a list of supported data source definitions. -message ListDataSourceDefinitionsResponse { - // List of supported data source definitions. - repeated DataSourceDefinition data_source_definitions = 1; - - // Output only. The next-pagination token. For multiple-page list results, - // this token can be used as the - // `ListDataSourceDefinitionsRequest.page_token` - // to request the next page of the list results. - string next_page_token = 2; -} - -// Represents the data source definition. -message DataSourceDefinition { - // The resource name of the data source definition. - // Data source definition names have the form - // `projects/{project_id}/locations/{location}/dataSourceDefinitions/{data_source_id}`. - string name = 21; - - // Data source metadata. - DataSource data_source = 1; - - // The Pub/Sub topic to be used for broadcasting a message when a transfer run - // is created. Both this topic and transfer_config_pubsub_topic can be - // set to a custom topic. By default, both topics are auto-generated if none - // of them is provided when creating the definition. However, if one topic is - // manually set, the other topic has to be manually set as well. The only - // difference is that transfer_run_pubsub_topic must be a non-empty Pub/Sub - // topic, but transfer_config_pubsub_topic can be set to empty. The comments - // about "{location}" for transfer_config_pubsub_topic apply here too. - string transfer_run_pubsub_topic = 13; - - // Duration which should be added to schedule_time to calculate - // run_time when job is scheduled. Only applicable for automatically - // scheduled transfer runs. Used to start a run early on a data source that - // supports continuous data refresh to compensate for unknown timezone - // offsets. Use a negative number to start a run late for data sources not - // supporting continuous data refresh. - google.protobuf.Duration run_time_offset = 16; - - // Support e-mail address of the OAuth client's Brand, which contains the - // consent screen data. - string support_email = 22; - - // When service account is specified, BigQuery will share created dataset - // with the given service account. Also, this service account will be - // eligible to perform status updates and message logging for data transfer - // runs for the corresponding data_source_id. - string service_account = 2; - - // Is data source disabled? If true, data_source is not visible. - // API will also stop returning any data transfer configs and/or runs - // associated with the data source. This setting has higher priority - // than whitelisted_project_ids. - bool disabled = 5; - - // The Pub/Sub topic to use for broadcasting a message for transfer config. If - // empty, a message will not be broadcasted. Both this topic and - // transfer_run_pubsub_topic are auto-generated if none of them is provided - // when creating the definition. It is recommended to provide - // transfer_config_pubsub_topic if a user-owned transfer_run_pubsub_topic is - // provided. Otherwise, it will be set to empty. If "{location}" is found in - // the value, then that means, data source wants to handle message separately - // for datasets in different regions. We will replace {location} with the - // actual dataset location, as the actual topic name. For example, - // projects/connector/topics/scheduler-{location} could become - // projects/connector/topics/scheduler-us. If "{location}" is not found, then - // we will use the input value as topic name. - string transfer_config_pubsub_topic = 12; - - // Supported location_ids used for deciding in which locations Pub/Sub topics - // need to be created. If custom Pub/Sub topics are used and they contains - // '{location}', the location_ids will be used for validating the topics by - // replacing the '{location}' with the individual location in the list. The - // valid values are the "location_id" field of the response of `GET - // https://bigquerydatatransfer.googleapis.com/v1/{name=projects/*}/locations` - // In addition, if the data source needs to support all available regions, - // supported_location_ids can be set to "global" (a single string element). - // When "global" is specified: - // 1) the data source implementation is supposed to stage the data in proper - // region of the destination dataset; - // 2) Data source developer should be aware of the implications (e.g., network - // traffic latency, potential charge associated with cross-region traffic, - // etc.) of supporting the "global" region; - repeated string supported_location_ids = 23; -} diff --git a/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/datatransfer.proto b/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/datatransfer.proto index e9a396834..a401c15c3 100644 --- a/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/datatransfer.proto +++ b/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/datatransfer.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,20 +11,21 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.bigquery.datatransfer.v1; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/cloud/bigquery/datatransfer/v1/transfer.proto"; import "google/protobuf/duration.proto"; import "google/protobuf/empty.proto"; import "google/protobuf/field_mask.proto"; import "google/protobuf/timestamp.proto"; import "google/protobuf/wrappers.proto"; -import "google/api/client.proto"; option csharp_namespace = "Google.Cloud.BigQuery.DataTransfer.V1"; option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/datatransfer/v1;datatransfer"; @@ -32,6 +33,7 @@ option java_multiple_files = true; option java_outer_classname = "DataTransferProto"; option java_package = "com.google.cloud.bigquery.datatransfer.v1"; option php_namespace = "Google\\Cloud\\BigQuery\\DataTransfer\\V1"; +option ruby_package = "Google::Cloud::Bigquery::DataTransfer::V1"; // The Google BigQuery Data Transfer Service API enables BigQuery users to // configure the transfer of their data from other Google Products into @@ -50,6 +52,7 @@ service DataTransferService { get: "/v1/{name=projects/*/dataSources/*}" } }; + option (google.api.method_signature) = "name"; } // Lists supported data sources and returns their settings, @@ -61,6 +64,7 @@ service DataTransferService { get: "/v1/{parent=projects/*}/dataSources" } }; + option (google.api.method_signature) = "parent"; } // Creates a new data transfer configuration. @@ -73,6 +77,7 @@ service DataTransferService { body: "transfer_config" } }; + option (google.api.method_signature) = "parent,transfer_config"; } // Updates a data transfer configuration. @@ -86,6 +91,7 @@ service DataTransferService { body: "transfer_config" } }; + option (google.api.method_signature) = "transfer_config,update_mask"; } // Deletes a data transfer configuration, @@ -97,6 +103,7 @@ service DataTransferService { delete: "/v1/{name=projects/*/transferConfigs/*}" } }; + option (google.api.method_signature) = "name"; } // Returns information about a data transfer config. @@ -107,6 +114,7 @@ service DataTransferService { get: "/v1/{name=projects/*/transferConfigs/*}" } }; + option (google.api.method_signature) = "name"; } // Returns information about all data transfers in the project. @@ -117,6 +125,7 @@ service DataTransferService { get: "/v1/{parent=projects/*}/transferConfigs" } }; + option (google.api.method_signature) = "parent"; } // Creates transfer runs for a time range [start_time, end_time]. @@ -134,6 +143,7 @@ service DataTransferService { body: "*" } }; + option (google.api.method_signature) = "parent,start_time,end_time"; } // Start manual transfer runs to be executed now with schedule_time equal to @@ -159,6 +169,7 @@ service DataTransferService { get: "/v1/{name=projects/*/transferConfigs/*/runs/*}" } }; + option (google.api.method_signature) = "name"; } // Deletes the specified transfer run. @@ -169,6 +180,7 @@ service DataTransferService { delete: "/v1/{name=projects/*/transferConfigs/*/runs/*}" } }; + option (google.api.method_signature) = "name"; } // Returns information about running and completed jobs. @@ -179,6 +191,7 @@ service DataTransferService { get: "/v1/{parent=projects/*/transferConfigs/*}/runs" } }; + option (google.api.method_signature) = "parent"; } // Returns user facing log messages for the data transfer run. @@ -189,6 +202,7 @@ service DataTransferService { get: "/v1/{parent=projects/*/transferConfigs/*/runs/*}/transferLogs" } }; + option (google.api.method_signature) = "parent"; } // Returns true if valid credentials exist for the given data source and @@ -206,6 +220,7 @@ service DataTransferService { body: "*" } }; + option (google.api.method_signature) = "name"; } } @@ -295,6 +310,12 @@ message DataSourceParameter { // Represents data source metadata. Metadata is sufficient to // render UI and request proper OAuth tokens. message DataSource { + option (google.api.resource) = { + type: "bigquerydatatransfer.googleapis.com/DataSource" + pattern: "projects/{project}/dataSources/{data_source}" + pattern: "projects/{project}/locations/{location}/dataSources/{data_source}" + }; + // The type of authorization needed for this data source. enum AuthorizationType { // Type unspecified. @@ -307,6 +328,11 @@ message DataSource { // Return an authorization code for a given Google+ page that can then be // exchanged for a refresh token on the backend. GOOGLE_PLUS_AUTHORIZATION_CODE = 2; + + // Use First Party Client OAuth. First Party Client OAuth doesn't require a + // refresh token to get an offline access token. Instead, it uses a + // client-signed JWT assertion to retrieve an access token. + FIRST_PARTY_OAUTH = 3; } // Represents how the data source supports data auto refresh. @@ -326,7 +352,7 @@ message DataSource { } // Output only. Data source resource name. - string name = 1; + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Data source id. string data_source_id = 2; @@ -396,16 +422,28 @@ message DataSource { // A request to get data source info. message GetDataSourceRequest { - // The field will contain name of the resource requested, for example: - // `projects/{project_id}/dataSources/{data_source_id}` - string name = 1; + // Required. The field will contain name of the resource requested, for example: + // `projects/{project_id}/dataSources/{data_source_id}` or + // `projects/{project_id}/locations/{location_id}/dataSources/{data_source_id}` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigquerydatatransfer.googleapis.com/DataSource" + } + ]; } // Request to list supported data sources and their data transfer settings. message ListDataSourcesRequest { - // The BigQuery project id for which data sources should be returned. - // Must be in the form: `projects/{project_id}` - string parent = 1; + // Required. The BigQuery project id for which data sources should be returned. + // Must be in the form: `projects/{project_id}` or + // `projects/{project_id}/locations/{location_id} + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "bigquerydatatransfer.googleapis.com/DataSource" + } + ]; // Pagination token, which can be used to request a specific page // of `ListDataSourcesRequest` list results. For multiple-page @@ -427,7 +465,7 @@ message ListDataSourcesResponse { // this token can be used as the // `ListDataSourcesRequest.page_token` // to request the next page of list results. - string next_page_token = 2; + string next_page_token = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } // A request to create a data transfer configuration. If new credentials are @@ -437,14 +475,19 @@ message ListDataSourcesResponse { // authorization code. Otherwise, the transfer configuration will be associated // with the calling user. message CreateTransferConfigRequest { - // The BigQuery project id where the transfer configuration should be created. - // Must be in the format projects/{project_id}/locations/{location_id} - // If specified location and location of the destination bigquery dataset - // do not match - the request will fail. - string parent = 1; - - // Data transfer configuration to create. - TransferConfig transfer_config = 2; + // Required. The BigQuery project id where the transfer configuration should be created. + // Must be in the format projects/{project_id}/locations/{location_id} or + // projects/{project_id}. If specified location and location of the + // destination bigquery dataset do not match - the request will fail. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "bigquerydatatransfer.googleapis.com/TransferConfig" + } + ]; + + // Required. Data transfer configuration to create. + TransferConfig transfer_config = 2 [(google.api.field_behavior) = REQUIRED]; // Optional OAuth2 authorization code to use with this transfer configuration. // This is required if new credentials are needed, as indicated by @@ -471,13 +514,19 @@ message CreateTransferConfigRequest { // version_info back in the authorization response which be be put in a JWT // claim in the token request. string version_info = 5; + + // Optional service account name. If this field is set, transfer config will + // be created with this service account credentials. It requires that + // requesting user calling this API has permissions to act as this service + // account. + string service_account_name = 6; } // A request to update a transfer configuration. To update the user id of the // transfer configuration, an authorization code needs to be provided. message UpdateTransferConfigRequest { - // Data transfer configuration to create. - TransferConfig transfer_config = 1; + // Required. Data transfer configuration to create. + TransferConfig transfer_config = 1 [(google.api.field_behavior) = REQUIRED]; // Optional OAuth2 authorization code to use with this transfer configuration. // If it is provided, the transfer configuration will be associated with the @@ -497,8 +546,8 @@ message UpdateTransferConfigRequest { // the user to copy the code and paste it in the application. string authorization_code = 3; - // Required list of fields to be updated in this request. - google.protobuf.FieldMask update_mask = 4; + // Required. Required list of fields to be updated in this request. + google.protobuf.FieldMask update_mask = 4 [(google.api.field_behavior) = REQUIRED]; // Optional version info. If users want to find a very recent access token, // that is, immediately after approving access, users have to set the @@ -507,42 +556,79 @@ message UpdateTransferConfigRequest { // version_info back in the authorization response which be be put in a JWT // claim in the token request. string version_info = 5; + + // Optional service account name. If this field is set and + // "service_account_name" is set in update_mask, transfer config will be + // updated to use this service account credentials. It requires that + // requesting user calling this API has permissions to act as this service + // account. + string service_account_name = 6; } // A request to get data transfer information. message GetTransferConfigRequest { - // The field will contain name of the resource requested, for example: - // `projects/{project_id}/transferConfigs/{config_id}` - string name = 1; + // Required. The field will contain name of the resource requested, for example: + // `projects/{project_id}/transferConfigs/{config_id}` or + // `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigquerydatatransfer.googleapis.com/TransferConfig" + } + ]; } // A request to delete data transfer information. All associated transfer runs // and log messages will be deleted as well. message DeleteTransferConfigRequest { - // The field will contain name of the resource requested, for example: - // `projects/{project_id}/transferConfigs/{config_id}` - string name = 1; + // Required. The field will contain name of the resource requested, for example: + // `projects/{project_id}/transferConfigs/{config_id}` or + // `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigquerydatatransfer.googleapis.com/TransferConfig" + } + ]; } // A request to get data transfer run information. message GetTransferRunRequest { - // The field will contain name of the resource requested, for example: - // `projects/{project_id}/transferConfigs/{config_id}/runs/{run_id}` - string name = 1; + // Required. The field will contain name of the resource requested, for example: + // `projects/{project_id}/transferConfigs/{config_id}/runs/{run_id}` or + // `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}/runs/{run_id}` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigquerydatatransfer.googleapis.com/Run" + } + ]; } // A request to delete data transfer run information. message DeleteTransferRunRequest { - // The field will contain name of the resource requested, for example: - // `projects/{project_id}/transferConfigs/{config_id}/runs/{run_id}` - string name = 1; + // Required. The field will contain name of the resource requested, for example: + // `projects/{project_id}/transferConfigs/{config_id}/runs/{run_id}` or + // `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}/runs/{run_id}` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigquerydatatransfer.googleapis.com/Run" + } + ]; } // A request to list data transfers configured for a BigQuery project. message ListTransferConfigsRequest { - // The BigQuery project id for which data sources - // should be returned: `projects/{project_id}`. - string parent = 1; + // Required. The BigQuery project id for which data sources + // should be returned: `projects/{project_id}` or + // `projects/{project_id}/locations/{location_id}` + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "bigquerydatatransfer.googleapis.com/TransferConfig" + } + ]; // When specified, only configurations of requested data sources are returned. repeated string data_source_ids = 2; @@ -561,13 +647,13 @@ message ListTransferConfigsRequest { // The returned list of pipelines in the project. message ListTransferConfigsResponse { // Output only. The stored pipeline transfer configurations. - repeated TransferConfig transfer_configs = 1; + repeated TransferConfig transfer_configs = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The next-pagination token. For multiple-page list results, // this token can be used as the // `ListTransferConfigsRequest.page_token` // to request the next page of list results. - string next_page_token = 2; + string next_page_token = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } // A request to list data transfer runs. UI can use this method to show/filter @@ -583,10 +669,16 @@ message ListTransferRunsRequest { LATEST = 1; } - // Name of transfer configuration for which transfer runs should be retrieved. + // Required. Name of transfer configuration for which transfer runs should be retrieved. // Format of transfer configuration resource name is: - // `projects/{project_id}/transferConfigs/{config_id}`. - string parent = 1; + // `projects/{project_id}/transferConfigs/{config_id}` or + // `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}`. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "bigquerydatatransfer.googleapis.com/Run" + } + ]; // When specified, only transfer runs with requested states are returned. repeated TransferState states = 2; @@ -608,20 +700,26 @@ message ListTransferRunsRequest { // The returned list of pipelines in the project. message ListTransferRunsResponse { // Output only. The stored pipeline transfer runs. - repeated TransferRun transfer_runs = 1; + repeated TransferRun transfer_runs = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The next-pagination token. For multiple-page list results, // this token can be used as the // `ListTransferRunsRequest.page_token` // to request the next page of list results. - string next_page_token = 2; + string next_page_token = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } // A request to get user facing log messages associated with data transfer run. message ListTransferLogsRequest { - // Transfer run name in the form: - // `projects/{project_id}/transferConfigs/{config_Id}/runs/{run_id}`. - string parent = 1; + // Required. Transfer run name in the form: + // `projects/{project_id}/transferConfigs/{config_id}/runs/{run_id}` or + // `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}/runs/{run_id}` + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigquerydatatransfer.googleapis.com/Run" + } + ]; // Pagination token, which can be used to request a specific page // of `ListTransferLogsRequest` list results. For multiple-page @@ -641,13 +739,13 @@ message ListTransferLogsRequest { // The returned list transfer run messages. message ListTransferLogsResponse { // Output only. The stored pipeline transfer messages. - repeated TransferMessage transfer_messages = 1; + repeated TransferMessage transfer_messages = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The next-pagination token. For multiple-page list results, // this token can be used as the // `GetTransferRunLogRequest.page_token` // to request the next page of list results. - string next_page_token = 2; + string next_page_token = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } // A request to determine whether the user has valid credentials. This method @@ -657,9 +755,15 @@ message ListTransferLogsResponse { // returns false, as it cannot be determined whether the credentials are // already valid merely based on the user id. message CheckValidCredsRequest { - // The data source in the form: - // `projects/{project_id}/dataSources/{data_source_id}` - string name = 1; + // Required. The data source in the form: + // `projects/{project_id}/dataSources/{data_source_id}` or + // `projects/{project_id}/locations/{location_id}/dataSources/{data_source_id}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigquerydatatransfer.googleapis.com/DataSource" + } + ]; } // A response indicating whether the credentials exist and are valid. @@ -670,17 +774,23 @@ message CheckValidCredsResponse { // A request to schedule transfer runs for a time range. message ScheduleTransferRunsRequest { - // Transfer configuration name in the form: - // `projects/{project_id}/transferConfigs/{config_id}`. - string parent = 1; - - // Start time of the range of transfer runs. For example, + // Required. Transfer configuration name in the form: + // `projects/{project_id}/transferConfigs/{config_id}` or + // `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}`. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigquerydatatransfer.googleapis.com/TransferConfig" + } + ]; + + // Required. Start time of the range of transfer runs. For example, // `"2017-05-25T00:00:00+00:00"`. - google.protobuf.Timestamp start_time = 2; + google.protobuf.Timestamp start_time = 2 [(google.api.field_behavior) = REQUIRED]; - // End time of the range of transfer runs. For example, + // Required. End time of the range of transfer runs. For example, // `"2017-05-30T00:00:00+00:00"`. - google.protobuf.Timestamp end_time = 3; + google.protobuf.Timestamp end_time = 3 [(google.api.field_behavior) = REQUIRED]; } // A response to schedule transfer runs for a time range. @@ -708,8 +818,11 @@ message StartManualTransferRunsRequest { } // Transfer configuration name in the form: - // `projects/{project_id}/transferConfigs/{config_id}`. - string parent = 1; + // `projects/{project_id}/transferConfigs/{config_id}` or + // `projects/{project_id}/locations/{location_id}/transferConfigs/{config_id}`. + string parent = 1 [(google.api.resource_reference) = { + type: "bigquerydatatransfer.googleapis.com/TransferConfig" + }]; // The requested time specification - this can be a time range or a specific // run_time. diff --git a/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/transfer.proto b/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/transfer.proto index 9501ea3cc..5985f0969 100644 --- a/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/transfer.proto +++ b/third_party/googleapis/google/cloud/bigquery/datatransfer/v1/transfer.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.bigquery.datatransfer.v1; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/struct.proto"; import "google/protobuf/timestamp.proto"; import "google/rpc/status.proto"; @@ -29,6 +29,7 @@ option java_outer_classname = "TransferProto"; option java_package = "com.google.cloud.bigquery.datatransfer.v1"; option objc_class_prefix = "GCBDT"; option php_namespace = "Google\\Cloud\\BigQuery\\DataTransfer\\V1"; +option ruby_package = "Google::Cloud::Bigquery::DataTransfer::V1"; // DEPRECATED. Represents data transfer type. enum TransferType { @@ -67,6 +68,13 @@ enum TransferState { CANCELLED = 6; } +// Represents preferences for sending email notifications for transfer run +// events. +message EmailPreferences { + // If true, email notifications will be sent on transfer run failures. + bool enable_failure_email = 1; +} + // Options customizing the data transfer schedule. message ScheduleOptions { // If true, automatic scheduling of data transfer runs for this configuration @@ -96,6 +104,12 @@ message ScheduleOptions { // `destination_dataset_id` is created when needed and shared with the // appropriate data source service account. message TransferConfig { + option (google.api.resource) = { + type: "bigquerydatatransfer.googleapis.com/TransferConfig" + pattern: "projects/{project}/transferConfigs/{transfer_config}" + pattern: "projects/{project}/locations/{location}/transferConfigs/{transfer_config}" + }; + // The resource name of the transfer config. // Transfer config names have the form of // `projects/{project_id}/locations/{region}/transferConfigs/{config_id}`. @@ -105,8 +119,11 @@ message TransferConfig { // required, will be generated for config_id. string name = 1; - // The BigQuery target dataset id. - string destination_dataset_id = 2; + // The desination of the transfer config. + oneof destination { + // The BigQuery target dataset id. + string destination_dataset_id = 2; + } // User specified display name for the data transfer. string display_name = 3; @@ -147,23 +164,37 @@ message TransferConfig { bool disabled = 13; // Output only. Data transfer modification time. Ignored by server on input. - google.protobuf.Timestamp update_time = 4; + google.protobuf.Timestamp update_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Next time when data transfer will run. - google.protobuf.Timestamp next_run_time = 8; + google.protobuf.Timestamp next_run_time = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. State of the most recently updated transfer run. - TransferState state = 10; + TransferState state = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; // Deprecated. Unique ID of the user on whose behalf transfer is done. int64 user_id = 11; // Output only. Region in which BigQuery dataset is located. - string dataset_region = 14; + string dataset_region = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Pub/Sub topic where notifications will be sent after transfer runs + // associated with this transfer config finish. + string notification_pubsub_topic = 15; + + // Email notifications will be sent according to these preferences + // to the email address of the user who owns this transfer config. + EmailPreferences email_preferences = 18; } // Represents a data transfer run. message TransferRun { + option (google.api.resource) = { + type: "bigquerydatatransfer.googleapis.com/Run" + pattern: "projects/{project}/transferConfigs/{transfer_config}/runs/{run}" + pattern: "projects/{project}/locations/{location}/transferConfigs/{transfer_config}/runs/{run}" + }; + // The resource name of the transfer run. // Transfer run names have the form // `projects/{project_id}/locations/{location}/transferConfigs/{config_id}/runs/{run_id}`. @@ -182,23 +213,26 @@ message TransferRun { // Output only. Time when transfer run was started. // Parameter ignored by server for input requests. - google.protobuf.Timestamp start_time = 4; + google.protobuf.Timestamp start_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Time when transfer run ended. // Parameter ignored by server for input requests. - google.protobuf.Timestamp end_time = 5; + google.protobuf.Timestamp end_time = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Last time the data transfer run state was updated. - google.protobuf.Timestamp update_time = 6; + google.protobuf.Timestamp update_time = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Data transfer specific parameters. - google.protobuf.Struct params = 9; + google.protobuf.Struct params = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Output only. The BigQuery target dataset id. - string destination_dataset_id = 2; + // Data transfer destination. + oneof destination { + // Output only. The BigQuery target dataset id. + string destination_dataset_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + } // Output only. Data source id. - string data_source_id = 7; + string data_source_id = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; // Data transfer run state. Ignored for input requests. TransferState state = 8; @@ -211,7 +245,16 @@ message TransferRun { // scheduled manually, this is empty. // NOTE: the system might choose to delay the schedule depending on the // current load, so `schedule_time` doesn't always match this. - string schedule = 12; + string schedule = 12 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Pub/Sub topic where a notification will be sent after this + // transfer run finishes + string notification_pubsub_topic = 23 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Email notifications will be sent according to these + // preferences to the email address of the user who owns the transfer config + // this run was derived from. + EmailPreferences email_preferences = 25 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Represents a user facing message for a particular data transfer run. diff --git a/third_party/googleapis/google/cloud/bigquery/reservation/v1/BUILD.bazel b/third_party/googleapis/google/cloud/bigquery/reservation/v1/BUILD.bazel new file mode 100644 index 000000000..15108ea72 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/reservation/v1/BUILD.bazel @@ -0,0 +1,365 @@ +# This file was automatically generated by BuildFileGenerator + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") +load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") + +proto_library( + name = "reservation_proto", + srcs = [ + "reservation.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/rpc:status_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +proto_library_with_info( + name = "reservation_proto_with_info", + deps = [ + ":reservation_proto", + "//google/cloud:common_resources_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", + "java_proto_library", +) + +java_proto_library( + name = "reservation_java_proto", + deps = [":reservation_proto"], +) + +java_grpc_library( + name = "reservation_java_grpc", + srcs = [":reservation_proto"], + deps = [":reservation_java_proto"], +) + +java_gapic_library( + name = "reservation_java_gapic", + src = ":reservation_proto_with_info", + gapic_yaml = "bigqueryreservation_gapic.yaml", + package = "google.cloud.bigquery.reservation.v1", + service_yaml = "bigqueryreservation_v1.yaml", + test_deps = [ + ":reservation_java_grpc", + ], + deps = [ + ":reservation_java_proto", + ], +) + +java_gapic_test( + name = "reservation_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.bigquery.reservation.v1.ReservationServiceClientTest", + ], + runtime_deps = [":reservation_java_gapic_test"], +) + +# Open Source Packages +java_gapic_assembly_gradle_pkg( + name = "google-cloud-bigquery-reservation-v1-java", + deps = [ + ":reservation_java_gapic", + ":reservation_java_grpc", + ":reservation_java_proto", + ":reservation_proto", + ], +) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", + "go_proto_library", + "go_test", +) + +go_proto_library( + name = "reservation_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/cloud/bigquery/reservation/v1", + protos = [":reservation_proto"], + deps = [ + "//google/api:annotations_go_proto", + "//google/rpc:status_go_proto", + ], +) + +go_gapic_library( + name = "reservation_go_gapic", + srcs = [":reservation_proto_with_info"], + grpc_service_config = "bigqueryreservation_grpc_service_config.json", + importpath = "cloud.google.com/go/bigquery/reservation/apiv1;reservation", + service_yaml = "bigqueryreservation_v1.yaml", + deps = [ + ":reservation_go_proto", + ], +) + +go_test( + name = "reservation_go_gapic_test", + srcs = [":reservation_go_gapic_srcjar_test"], + embed = [":reservation_go_gapic"], + importpath = "cloud.google.com/go/bigquery/reservation/apiv1", +) + +# Open Source Packages +go_gapic_assembly_pkg( + name = "gapi-cloud-bigquery-reservation-v1-go", + deps = [ + ":reservation_go_gapic", + ":reservation_go_gapic_srcjar-test.srcjar", + ":reservation_go_proto", + ], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "reservation_moved_proto", + srcs = [":reservation_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/rpc:status_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +py_proto_library( + name = "reservation_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":reservation_moved_proto"], +) + +py_grpc_library( + name = "reservation_py_grpc", + srcs = [":reservation_moved_proto"], + deps = [":reservation_py_proto"], +) + +py_gapic_library( + name = "reservation_py_gapic", + src = ":reservation_proto_with_info", + gapic_yaml = "bigqueryreservation_gapic.yaml", + package = "google.cloud.bigquery.reservation.v1", + service_yaml = "bigqueryreservation_v1.yaml", + deps = [ + ":reservation_py_grpc", + ":reservation_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "bigquery-reservation-v1-py", + deps = [ + ":reservation_py_gapic", + ":reservation_py_grpc", + ":reservation_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "reservation_php_proto", + deps = [":reservation_proto"], +) + +php_grpc_library( + name = "reservation_php_grpc", + srcs = [":reservation_proto"], + deps = [":reservation_php_proto"], +) + +php_gapic_library( + name = "reservation_php_gapic", + src = ":reservation_proto_with_info", + gapic_yaml = "bigqueryreservation_gapic.yaml", + package = "google.cloud.bigquery.reservation.v1", + service_yaml = "bigqueryreservation_v1.yaml", + deps = [ + ":reservation_php_grpc", + ":reservation_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-bigquery-reservation-v1-php", + deps = [ + ":reservation_php_gapic", + ":reservation_php_grpc", + ":reservation_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "reservation_nodejs_gapic", + src = ":reservation_proto_with_info", + gapic_yaml = "bigqueryreservation_gapic.yaml", + package = "google.cloud.bigquery.reservation.v1", + service_yaml = "bigqueryreservation_v1.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "bigquery-reservation-v1-nodejs", + deps = [ + ":reservation_nodejs_gapic", + ":reservation_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "reservation_ruby_proto", + deps = [":reservation_proto"], +) + +ruby_grpc_library( + name = "reservation_ruby_grpc", + srcs = [":reservation_proto"], + deps = [":reservation_ruby_proto"], +) + +ruby_gapic_library( + name = "reservation_ruby_gapic", + src = ":reservation_proto_with_info", + gapic_yaml = "bigqueryreservation_gapic.yaml", + package = "google.cloud.bigquery.reservation.v1", + service_yaml = "bigqueryreservation_v1.yaml", + deps = [ + ":reservation_ruby_grpc", + ":reservation_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-bigquery-reservation-v1-ruby", + deps = [ + ":reservation_ruby_gapic", + ":reservation_ruby_grpc", + ":reservation_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "reservation_csharp_proto", + deps = [":reservation_proto"], +) + +csharp_grpc_library( + name = "reservation_csharp_grpc", + srcs = [":reservation_proto"], + deps = [":reservation_csharp_proto"], +) + +csharp_gapic_library( + name = "reservation_csharp_gapic", + src = ":reservation_proto_with_info", + gapic_yaml = "bigqueryreservation_gapic.yaml", + package = "google.cloud.bigquery.reservation.v1", + service_yaml = "bigqueryreservation_v1.yaml", + deps = [ + ":reservation_csharp_grpc", + ":reservation_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-bigquery-reservation-v1-csharp", + deps = [ + ":reservation_csharp_gapic", + ":reservation_csharp_grpc", + ":reservation_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/cloud/bigquery/reservation/v1/bigqueryreservation_gapic.legacy.yaml b/third_party/googleapis/google/cloud/bigquery/reservation/v1/bigqueryreservation_gapic.legacy.yaml new file mode 100644 index 000000000..ecef35918 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/reservation/v1/bigqueryreservation_gapic.legacy.yaml @@ -0,0 +1,383 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 1.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.bigquery.reservation.v1 + python: + package_name: google.cloud.bigquery.reservation_v1.gapic + go: + package_name: cloud.google.com/go/bigquery/reservation/apiv1 + csharp: + package_name: Google.Cloud.Bigquery.Reservation.V1 + ruby: + package_name: Google::Cloud::Bigquery::Reservation::V1 + php: + package_name: Google\Cloud\Bigquery\Reservation\V1 + nodejs: + package_name: reservation.v1 +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.cloud.bigquery.reservation.v1.ReservationService + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: + - name_pattern: projects/{project}/locations/{location} + entity_name: location + - name_pattern: projects/{project}/locations/{location}/capacityCommitments/{capacity_commitment} + entity_name: capacity_commitment + - name_pattern: projects/{project}/locations/{location}/reservations/{reservation} + entity_name: reservation + - name_pattern: projects/{project}/locations/{location}/reservations/{reservation}/assignments/{assignment} + entity_name: assignment + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - DEADLINE_EXCEEDED + - UNAVAILABLE + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # + # name - The simple name of the method. + # + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce method + # overloads which allow a client to directly pass request message fields as + # method parameters. This information may or may not be used, depending on + # the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request message. + # + # required_fields - Fields that are always required for a request to be + # valid. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a paging + # list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It defines + # which fields match the paging pattern in the request. The request consists + # of a page_size_field and a token_field. The page_size_field is the name of + # the optional field specifying the maximum number of elements to be + # returned in the response. The token_field is the name of the field in the + # request containing the page token. + # The response specifies response information of the list method. It defines + # which fields match the paging pattern in the response. The response + # consists of a token_field and a resources_field. The token_field is the + # name of the field in the response containing the next page token. The + # resources_field is the name of the field in the response containing the + # list of resources belonging to the page. + # + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: CreateReservation + flattening: + groups: + - parameters: + - parent + - reservation_id + - reservation + required_fields: + - parent + - reservation_id + - reservation + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: location + timeout_millis: 60000 + - name: ListReservations + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: reservations + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: location + timeout_millis: 60000 + - name: GetReservation + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: reservation + timeout_millis: 60000 + - name: GetBiReservation + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: reservation + timeout_millis: 60000 + - name: DeleteReservation + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: reservation + timeout_millis: 60000 + - name: UpdateReservation + flattening: + groups: + - parameters: + - reservation + - update_mask + required_fields: + - reservation + - update_mask + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + reservation.name: reservation + timeout_millis: 60000 + - name: UpdateBiReservation + flattening: + groups: + - parameters: + - bi_reservation + - update_mask + required_fields: + - bi_reservation + - update_mask + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + reservation.name: reservation + timeout_millis: 60000 + - name: CreateCapacityCommitment + flattening: + groups: + - parameters: + - parent + - capacity_commitment + required_fields: + - parent + - capacity_commitment + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: location + timeout_millis: 60000 + - name: ListCapacityCommitments + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: capacity_commitments + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: location + timeout_millis: 60000 + - name: GetCapacityCommitment + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: capacity_commitment + timeout_millis: 60000 + - name: UpdateCapacityCommitment + flattening: + groups: + - parameters: + - capacity_commitment + - update_mask + required_fields: + - capacity_commitment + - update_mask + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + capacity_commitment.name: capacity_commitment + timeout_millis: 60000 + - name: SplitCapacityCommitment + flattening: + groups: + - parameters: + - name + - slot_count + required_fields: + - name + - slot_count + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: capacity_commitment + timeout_millis: 60000 + - name: MergeCapacityCommitments + flattening: + groups: + - parameters: + - parent + - capacity_commitment_ids + required_fields: + - parent + - capacity_commitment_ids + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: location + timeout_millis: 6000 + - name: DeleteCapacityCommitment + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: capacity_commitment + timeout_millis: 60000 + - name: CreateAssignment + flattening: + groups: + - parameters: + - parent + - assignment + required_fields: + - parent + - assignment + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: reservation + timeout_millis: 60000 + - name: ListAssignments + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: assignments + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: reservation + timeout_millis: 60000 + - name: DeleteAssignment + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: assignment + timeout_millis: 60000 + - name: SearchAssignments + flattening: + groups: + - parameters: + - parent + - query + required_fields: + - parent + - query + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: assignments + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: location + timeout_millis: 60000 + - name: MoveAssignment + flattening: + groups: + - parameters: + - name + - destination_id + required_fields: + - name + - destination_id + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: assignment + timeout_millis: 60000 diff --git a/third_party/googleapis/google/cloud/bigquery/reservation/v1/bigqueryreservation_gapic.yaml b/third_party/googleapis/google/cloud/bigquery/reservation/v1/bigqueryreservation_gapic.yaml new file mode 100644 index 000000000..8dd77f5a3 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/reservation/v1/bigqueryreservation_gapic.yaml @@ -0,0 +1,29 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 2.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.bigquery.reservation.v1 + python: + package_name: google.cloud.bigquery.reservation_v1.gapic + go: + package_name: cloud.google.com/go/bigquery/reservation/apiv1 + csharp: + package_name: Google.Cloud.Bigquery.Reservation.V1 + ruby: + package_name: Google::Cloud::Bigquery::Reservation::V1 + php: + package_name: Google\Cloud\Bigquery\Reservation\V1 + nodejs: + package_name: reservation.v1 +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.cloud.bigquery.reservation.v1.ReservationService + methods: + - name: DeleteReservation + retry_codes_name: idempotent + - name: DeleteCapacityCommitment + retry_codes_name: idempotent + - name: DeleteAssignment + retry_codes_name: idempotent diff --git a/third_party/googleapis/google/cloud/bigquery/reservation/v1/bigqueryreservation_grpc_service_config.json b/third_party/googleapis/google/cloud/bigquery/reservation/v1/bigqueryreservation_grpc_service_config.json new file mode 100755 index 000000000..a32cd2b6e --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/reservation/v1/bigqueryreservation_grpc_service_config.json @@ -0,0 +1,100 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.bigquery.reservation.v1.ReservationService", + "method": "CreateReservation" + }, + { + "service": "google.cloud.bigquery.reservation.v1.ReservationService", + "method": "UpdateReservation" + }, + { + "service": "google.cloud.bigquery.reservation.v1.ReservationService", + "method": "CreateCapacityCommitment" + }, + { + "service": "google.cloud.bigquery.reservation.v1.ReservationService", + "method": "UpdateCapacityCommitment" + }, + { + "service": "google.cloud.bigquery.reservation.v1.ReservationService", + "method": "SplitCapacityCommitment" + }, + { + "service": "google.cloud.bigquery.reservation.v1.ReservationService", + "method": "MergeCapacityCommitments" + }, + { + "service": "google.cloud.bigquery.reservation.v1.ReservationService", + "method": "CreateAssignment" + }, + { + "service": "google.cloud.bigquery.reservation.v1.ReservationService", + "method": "MoveAssignment" + }, + { + "service": "google.cloud.bigquery.reservation.v1.ReservationService", + "method": "UpdateBiReservation" + } + ], + "timeout": "60s" + }, + { + "name": [ + { + "service": "google.cloud.bigquery.reservation.v1.ReservationService", + "method": "ListReservations" + }, + { + "service": "google.cloud.bigquery.reservation.v1.ReservationService", + "method": "GetReservation" + }, + { + "service": "google.cloud.bigquery.reservation.v1.ReservationService", + "method": "DeleteReservation" + }, + { + "service": "google.cloud.bigquery.reservation.v1.ReservationService", + "method": "ListCapacityCommitments" + }, + { + "service": "google.cloud.bigquery.reservation.v1.ReservationService", + "method": "GetCapacityCommitment" + }, + { + "service": "google.cloud.bigquery.reservation.v1.ReservationService", + "method": "DeleteCapacityCommitment" + }, + { + "service": "google.cloud.bigquery.reservation.v1.ReservationService", + "method": "ListAssignments" + }, + { + "service": "google.cloud.bigquery.reservation.v1.ReservationService", + "method": "DeleteAssignment" + }, + { + "service": "google.cloud.bigquery.reservation.v1.ReservationService", + "method": "SearchAssignments" + }, + { + "service": "google.cloud.bigquery.reservation.v1.ReservationService", + "method": "GetBiReservation" + } + ], + "timeout": "60s", + "retryPolicy": { + "maxAttempts": 5, + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/cloud/bigquery/reservation/v1/bigqueryreservation_v1.yaml b/third_party/googleapis/google/cloud/bigquery/reservation/v1/bigqueryreservation_v1.yaml new file mode 100644 index 000000000..ab278cf32 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/reservation/v1/bigqueryreservation_v1.yaml @@ -0,0 +1,30 @@ +type: google.api.Service +config_version: 3 +name: bigqueryreservation.googleapis.com +title: BigQuery Reservation API + +apis: +- name: google.cloud.bigquery.reservation.v1.ReservationService + +documentation: + summary: 'A service to modify your BigQuery flat-rate reservations.' + +backend: + rules: + - selector: 'google.cloud.bigquery.reservation.v1.ReservationService.*' + deadline: 30.0 + - selector: 'google.longrunning.Operations.*' + deadline: 30.0 + +authentication: + rules: + - selector: 'google.cloud.bigquery.reservation.v1.ReservationService.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/bigquery, + https://www.googleapis.com/auth/cloud-platform + - selector: 'google.longrunning.Operations.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/bigquery, + https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/bigquery/reservation/v1/reservation.proto b/third_party/googleapis/google/cloud/bigquery/reservation/v1/reservation.proto new file mode 100644 index 000000000..e3c24d422 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/reservation/v1/reservation.proto @@ -0,0 +1,905 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.bigquery.reservation.v1; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/empty.proto"; +import "google/protobuf/field_mask.proto"; +import "google/protobuf/timestamp.proto"; +import "google/rpc/status.proto"; + +option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/reservation/v1;reservation"; +option java_multiple_files = true; +option java_outer_classname = "ReservationProto"; +option java_package = "com.google.cloud.bigquery.reservation.v1"; + +// This API allows users to manage their flat-rate BigQuery reservations. +// +// A reservation provides computational resource guarantees, in the form of +// [slots](https://cloud.google.com/bigquery/docs/slots), to users. A slot is a +// unit of computational power in BigQuery, and serves as the basic unit of +// parallelism. In a scan of a multi-partitioned table, a single slot operates +// on a single partition of the table. A reservation resource exists as a child +// resource of the admin project and location, e.g.: +// `projects/myproject/locations/US/reservations/reservationName`. +// +// A capacity commitment is a way to purchase compute capacity for BigQuery jobs +// (in the form of slots) with some committed period of usage. A capacity +// commitment resource exists as a child resource of the admin project and +// location, e.g.: +// `projects/myproject/locations/US/capacityCommitments/id`. +service ReservationService { + option (google.api.default_host) = "bigqueryreservation.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/bigquery," + "https://www.googleapis.com/auth/cloud-platform"; + + // Creates a new reservation resource. + rpc CreateReservation(CreateReservationRequest) returns (Reservation) { + option (google.api.http) = { + post: "/v1/{parent=projects/*/locations/*}/reservations" + body: "reservation" + }; + option (google.api.method_signature) = "parent,reservation,reservation_id"; + } + + // Lists all the reservations for the project in the specified location. + rpc ListReservations(ListReservationsRequest) + returns (ListReservationsResponse) { + option (google.api.http) = { + get: "/v1/{parent=projects/*/locations/*}/reservations" + }; + option (google.api.method_signature) = "parent"; + } + + // Returns information about the reservation. + rpc GetReservation(GetReservationRequest) returns (Reservation) { + option (google.api.http) = { + get: "/v1/{name=projects/*/locations/*/reservations/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Deletes a reservation. + // Returns `google.rpc.Code.FAILED_PRECONDITION` when reservation has + // assignments. + rpc DeleteReservation(DeleteReservationRequest) + returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1/{name=projects/*/locations/*/reservations/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Updates an existing reservation resource. + rpc UpdateReservation(UpdateReservationRequest) returns (Reservation) { + option (google.api.http) = { + patch: "/v1/{reservation.name=projects/*/locations/*/reservations/*}" + body: "reservation" + }; + option (google.api.method_signature) = "reservation,update_mask"; + } + + // Creates a new capacity commitment resource. + rpc CreateCapacityCommitment(CreateCapacityCommitmentRequest) + returns (CapacityCommitment) { + option (google.api.http) = { + post: "/v1/{parent=projects/*/locations/*}/capacityCommitments" + body: "capacity_commitment" + }; + option (google.api.method_signature) = "parent,capacity_commitment"; + } + + // Lists all the capacity commitments for the admin project. + rpc ListCapacityCommitments(ListCapacityCommitmentsRequest) + returns (ListCapacityCommitmentsResponse) { + option (google.api.http) = { + get: "/v1/{parent=projects/*/locations/*}/capacityCommitments" + }; + option (google.api.method_signature) = "parent"; + } + + // Returns information about the capacity commitment. + rpc GetCapacityCommitment(GetCapacityCommitmentRequest) + returns (CapacityCommitment) { + option (google.api.http) = { + get: "/v1/{name=projects/*/locations/*/capacityCommitments/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Deletes a capacity commitment. Attempting to delete capacity commitment + // before its commitment_end_time will fail with the error code + // `google.rpc.Code.FAILED_PRECONDITION`. + rpc DeleteCapacityCommitment(DeleteCapacityCommitmentRequest) + returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1/{name=projects/*/locations/*/capacityCommitments/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Updates an existing capacity commitment. + // + // Only `plan` and `renewal_plan` fields can be updated. + // + // Plan can only be changed to a plan of a longer commitment period. + // Attempting to change to a plan with shorter commitment period will fail + // with the error code `google.rpc.Code.FAILED_PRECONDITION`. + rpc UpdateCapacityCommitment(UpdateCapacityCommitmentRequest) + returns (CapacityCommitment) { + option (google.api.http) = { + patch: "/v1/{capacity_commitment.name=projects/*/locations/*/capacityCommitments/*}" + body: "capacity_commitment" + }; + option (google.api.method_signature) = "capacity_commitment,update_mask"; + } + + // Splits capacity commitment to two commitments of the same plan and + // `commitment_end_time`. + // + // A common use case is to enable downgrading commitments. + // + // For example, in order to downgrade from 10000 slots to 8000, you might + // split a 10000 capacity commitment into commitments of 2000 and 8000. Then, + // you would change the plan of the first one to `FLEX` and then delete it. + rpc SplitCapacityCommitment(SplitCapacityCommitmentRequest) + returns (SplitCapacityCommitmentResponse) { + option (google.api.http) = { + post: "/v1/{name=projects/*/locations/*/capacityCommitments/*}:split" + body: "*" + }; + option (google.api.method_signature) = "name,slot_count"; + } + + // Merges capacity commitments of the same plan into a single commitment. + // + // The resulting capacity commitment has the greater commitment_end_time + // out of the to-be-merged capacity commitments. + // + // Attempting to merge capacity commitments of different plan will fail + // with the error code `google.rpc.Code.FAILED_PRECONDITION`. + rpc MergeCapacityCommitments(MergeCapacityCommitmentsRequest) + returns (CapacityCommitment) { + option (google.api.http) = { + post: "/v1/{parent=projects/*/locations/*}/capacityCommitments:merge" + body: "*" + }; + option (google.api.method_signature) = "parent,capacity_commitment_ids"; + } + + // Creates an assignment object which allows the given project to submit jobs + // of a certain type using slots from the specified reservation. + // + // Currently a + // resource (project, folder, organization) can only have one assignment per + // each (job_type, location) combination, and that reservation will be used + // for all jobs of the matching type. + // + // Different assignments can be created on different levels of the + // projects, folders or organization hierarchy. During query execution, + // the assignment is looked up at the project, folder and organization levels + // in that order. The first assignment found is applied to the query. + // + // When creating assignments, it does not matter if other assignments exist at + // higher levels. + // + // Example: + // + // * The organization `organizationA` contains two projects, `project1` + // and `project2`. + // * Assignments for all three entities (`organizationA`, `project1`, and + // `project2`) could all be created and mapped to the same or different + // reservations. + // + // Returns `google.rpc.Code.PERMISSION_DENIED` if user does not have + // 'bigquery.admin' permissions on the project using the reservation + // and the project that owns this reservation. + // + // Returns `google.rpc.Code.INVALID_ARGUMENT` when location of the assignment + // does not match location of the reservation. + rpc CreateAssignment(CreateAssignmentRequest) returns (Assignment) { + option (google.api.http) = { + post: "/v1/{parent=projects/*/locations/*/reservations/*}/assignments" + body: "assignment" + }; + option (google.api.method_signature) = "parent,assignment"; + } + + // Lists assignments. + // + // Only explicitly created assignments will be returned. + // + // Example: + // + // * Organization `organizationA` contains two projects, `project1` and + // `project2`. + // * Reservation `res1` exists and was created previously. + // * CreateAssignment was used previously to define the following + // associations between entities and reservations: `` + // and `` + // + // In this example, ListAssignments will just return the above two assignments + // for reservation `res1`, and no expansion/merge will happen. + // + // The wildcard "-" can be used for + // reservations in the request. In that case all assignments belongs to the + // specified project and location will be listed. + // + // **Note** "-" cannot be used for projects nor locations. + rpc ListAssignments(ListAssignmentsRequest) + returns (ListAssignmentsResponse) { + option (google.api.http) = { + get: "/v1/{parent=projects/*/locations/*/reservations/*}/assignments" + }; + option (google.api.method_signature) = "parent"; + } + + // Deletes a assignment. No expansion will happen. + // + // Example: + // + // * Organization `organizationA` contains two projects, `project1` and + // `project2`. + // * Reservation `res1` exists and was created previously. + // * CreateAssignment was used previously to define the following + // associations between entities and reservations: `` + // and `` + // + // In this example, deletion of the `` assignment won't + // affect the other assignment ``. After said deletion, + // queries from `project1` will still use `res1` while queries from + // `project2` will switch to use on-demand mode. + rpc DeleteAssignment(DeleteAssignmentRequest) + returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1/{name=projects/*/locations/*/reservations/*/assignments/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Looks up assignments for a specified resource for a particular region. + // If the request is about a project: + // + // 1. Assignments created on the project will be returned if they exist. + // 2. Otherwise assignments created on the closest ancestor will be + // returned. + // 3. Assignments for different JobTypes will all be returned. + // + // The same logic applies if the request is about a folder. + // + // If the request is about an organization, then assignments created on the + // organization will be returned (organization doesn't have ancestors). + // + // Comparing to ListAssignments, there are some behavior + // differences: + // + // 1. permission on the assignee will be verified in this API. + // 2. Hierarchy lookup (project->folder->organization) happens in this API. + // 3. Parent here is `projects/*/locations/*`, instead of + // `projects/*/locations/*reservations/*`. + // + // **Note** "-" cannot be used for projects + // nor locations. + rpc SearchAssignments(SearchAssignmentsRequest) + returns (SearchAssignmentsResponse) { + option (google.api.http) = { + get: "/v1/{parent=projects/*/locations/*}:searchAssignments" + }; + option (google.api.method_signature) = "parent,query"; + } + + // Moves an assignment under a new reservation. + // + // This differs from removing an existing assignment and recreating a new one + // by providing a transactional change that ensures an assignee always has an + // associated reservation. + rpc MoveAssignment(MoveAssignmentRequest) returns (Assignment) { + option (google.api.http) = { + post: "/v1/{name=projects/*/locations/*/reservations/*/assignments/*}:move" + body: "*" + }; + option (google.api.method_signature) = "name,destination_id"; + } + + // Retrieves a BI reservation. + rpc GetBiReservation(GetBiReservationRequest) returns (BiReservation) { + option (google.api.http) = { + get: "/v1/{name=projects/*/locations/*/biReservation}" + }; + option (google.api.method_signature) = "name"; + } + + // Updates a BI reservation. + // + // Only fields specified in the `field_mask` are updated. + // + // A singleton BI reservation always exists with default size 0. + // In order to reserve BI capacity it needs to be updated to an amount + // greater than 0. In order to release BI capacity reservation size + // must be set to 0. + rpc UpdateBiReservation(UpdateBiReservationRequest) returns (BiReservation) { + option (google.api.http) = { + patch: "/v1/{bi_reservation.name=projects/*/locations/*/biReservation}" + body: "bi_reservation" + }; + option (google.api.method_signature) = "bi_reservation,update_mask"; + } +} + +// A reservation is a mechanism used to guarantee slots to users. +message Reservation { + option (google.api.resource) = { + type: "bigqueryreservation.googleapis.com/Reservation" + pattern: "projects/{project}/locations/{location}/reservations/{reservation}" + }; + + // The resource name of the reservation, e.g., + // `projects/*/locations/*/reservations/team1-prod`. + string name = 1; + + // Minimum slots available to this reservation. A slot is a unit of + // computational power in BigQuery, and serves as the unit of parallelism. + // + // Queries using this reservation might use more slots during runtime if + // ignore_idle_slots is set to false. + // + // If the new reservation's slot capacity exceed the parent's slot capacity or + // if total slot capacity of the new reservation and its siblings exceeds the + // parent's slot capacity, the request will fail with + // `google.rpc.Code.RESOURCE_EXHAUSTED`. + int64 slot_capacity = 2; + + // If false, any query using this reservation will use idle slots from other + // reservations within the same admin project. If true, a query using this + // reservation will execute with the slot capacity specified above at most. + bool ignore_idle_slots = 4; +} + +// Capacity commitment is a way to purchase compute capacity for BigQuery jobs +// (in the form of slots) with some committed period of usage. Annual +// commitments renew by default. Commitments can be removed after their +// commitment end time passes. +// +// In order to remove annual commitment, its plan needs to be changed +// to monthly or flex first. +// +// A capacity commitment resource exists as a child resource of the admin +// project. +message CapacityCommitment { + option (google.api.resource) = { + type: "bigqueryreservation.googleapis.com/CapacityCommitment" + pattern: "projects/{project}/locations/{location}/capacityCommitments/{capacity_commitment}" + }; + + // Commitment plan defines the current committed period. Capacity commitment + // cannot be deleted during it's committed period. + enum CommitmentPlan { + // Invalid plan value. Requests with this value will be rejected with + // error code `google.rpc.Code.INVALID_ARGUMENT`. + COMMITMENT_PLAN_UNSPECIFIED = 0; + + // Flex commitments have committed period of 1 minute after becoming ACTIVE. + // After that, they are not in a committed period anymore and can be removed + // any time. + FLEX = 3; + + // Trial commitments have a committed period of 182 days after becoming + // ACTIVE. After that, they are converted to a new commitment based on the + // `renewal_plan`. Default `renewal_plan` for Trial commitment is Flex so + // that it can be deleted right after committed period ends. + TRIAL = 5; + + // Monthly commitments have a committed period of 30 days after becoming + // ACTIVE. After that, they are not in a committed period anymore and can be + // removed any time. + MONTHLY = 2; + + // Annual commitments have a committed period of 365 days after becoming + // ACTIVE. After that they are converted to a new commitment based on the + // renewal_plan. + ANNUAL = 4; + } + + // Capacity commitment can either become ACTIVE right away or transition + // from PENDING to ACTIVE or FAILED. + enum State { + // Invalid state value. + STATE_UNSPECIFIED = 0; + + // Capacity commitment is pending provisioning. Pending capacity commitment + // does not contribute to the parent's slot_capacity. + PENDING = 1; + + // Once slots are provisioned, capacity commitment becomes active. + // slot_count is added to the parent's slot_capacity. + ACTIVE = 2; + + // Capacity commitment is failed to be activated by the backend. + FAILED = 3; + } + + // Output only. The resource name of the capacity commitment, e.g., + // `projects/myproject/locations/US/capacityCommitments/123` + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Number of slots in this commitment. + int64 slot_count = 2; + + // Capacity commitment commitment plan. + CommitmentPlan plan = 3; + + // Output only. State of the commitment. + State state = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The end of the current commitment period. It is applicable + // only for ACTIVE capacity commitments. + google.protobuf.Timestamp commitment_end_time = 5 + [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. For FAILED commitment plan, provides the reason of failure. + google.rpc.Status failure_status = 7 + [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The plan this capacity commitment is converted to after commitment_end_time + // passes. Once the plan is changed, committed period is extended according to + // commitment plan. Only applicable for ANNUAL and TRIAL commitments. + CommitmentPlan renewal_plan = 8; +} + +// The request for +// [ReservationService.CreateReservation][google.cloud.bigquery.reservation.v1.ReservationService.CreateReservation]. +message CreateReservationRequest { + // Required. Project, location. E.g., + // `projects/myproject/locations/US` + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "bigqueryreservation.googleapis.com/Reservation" + } + ]; + + // The reservation ID. This field must only contain lower case alphanumeric + // characters or dash. Max length is 64 characters. + string reservation_id = 2; + + // Definition of the new reservation to create. + Reservation reservation = 3; +} + +// The request for +// [ReservationService.ListReservations][google.cloud.bigquery.reservation.v1.ReservationService.ListReservations]. +message ListReservationsRequest { + // Required. The parent resource name containing project and location, e.g.: + // "projects/myproject/locations/US" + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "bigqueryreservation.googleapis.com/Reservation" + } + ]; + + // The maximum number of items to return per page. + int32 page_size = 2; + + // The next_page_token value returned from a previous List request, if any. + string page_token = 3; +} + +// The response for +// [ReservationService.ListReservations][google.cloud.bigquery.reservation.v1.ReservationService.ListReservations]. +message ListReservationsResponse { + // List of reservations visible to the user. + repeated Reservation reservations = 1; + + // Token to retrieve the next page of results, or empty if there are no + // more results in the list. + string next_page_token = 2; +} + +// The request for +// [ReservationService.GetReservation][google.cloud.bigquery.reservation.v1.ReservationService.GetReservation]. +message GetReservationRequest { + // Required. Resource name of the reservation to retrieve. E.g., + // `projects/myproject/locations/US/reservations/team1-prod` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigqueryreservation.googleapis.com/Reservation" + } + ]; +} + +// The request for +// [ReservationService.DeleteReservation][google.cloud.bigquery.reservation.v1.ReservationService.DeleteReservation]. +message DeleteReservationRequest { + // Required. Resource name of the reservation to retrieve. E.g., + // `projects/myproject/locations/US/reservations/team1-prod` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigqueryreservation.googleapis.com/Reservation" + } + ]; +} + +// The request for +// [ReservationService.UpdateReservation][google.cloud.bigquery.reservation.v1.ReservationService.UpdateReservation]. +message UpdateReservationRequest { + // Content of the reservation to update. + Reservation reservation = 1; + + // Standard field mask for the set of fields to be updated. + google.protobuf.FieldMask update_mask = 2; +} + +// The request for +// [ReservationService.CreateCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.CreateCapacityCommitment]. +message CreateCapacityCommitmentRequest { + // Required. Resource name of the parent reservation. E.g., + // projects/myproject/locations/US + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "bigqueryreservation.googleapis.com/CapacityCommitment" + } + ]; + + // Content of the capacity commitment to create. + CapacityCommitment capacity_commitment = 2; + + // If true, fail the request if another project in the organization has a + // capacity commitment. + bool enforce_single_admin_project_per_org = 4; +} + +// The request for +// [ReservationService.ListCapacityCommitments][google.cloud.bigquery.reservation.v1.ReservationService.ListCapacityCommitments]. +message ListCapacityCommitmentsRequest { + // Required. Resource name of the parent reservation. E.g., + // projects/myproject/locations/US + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "bigqueryreservation.googleapis.com/CapacityCommitment" + } + ]; + + // The maximum number of items to return. + int32 page_size = 2; + + // The next_page_token value returned from a previous List request, if any. + string page_token = 3; +} + +// The response for +// [ReservationService.ListCapacityCommitments][google.cloud.bigquery.reservation.v1.ReservationService.ListCapacityCommitments]. +message ListCapacityCommitmentsResponse { + // List of capacity commitments visible to the user. + repeated CapacityCommitment capacity_commitments = 1; + + // Token to retrieve the next page of results, or empty if there are no + // more results in the list. + string next_page_token = 2; +} + +// The request for +// [ReservationService.GetCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.GetCapacityCommitment]. +message GetCapacityCommitmentRequest { + // Required. Resource name of the capacity commitment to retrieve. E.g., + // projects/myproject/locations/US/capacityCommitments/123 + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigqueryreservation.googleapis.com/CapacityCommitment" + } + ]; +} + +// The request for +// [ReservationService.DeleteCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.DeleteCapacityCommitment]. +message DeleteCapacityCommitmentRequest { + // Required. Resource name of the capacity commitment to delete. E.g., + // projects/myproject/locations/US/capacityCommitments/123 + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigqueryreservation.googleapis.com/CapacityCommitment" + } + ]; +} + +// The request for +// [ReservationService.UpdateCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.UpdateCapacityCommitment]. +message UpdateCapacityCommitmentRequest { + // Content of the capacity commitment to update. + CapacityCommitment capacity_commitment = 1; + + // Standard field mask for the set of fields to be updated. + google.protobuf.FieldMask update_mask = 2; +} + +// The request for +// [ReservationService.SplitCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.SplitCapacityCommitment]. +message SplitCapacityCommitmentRequest { + // Required. The resource name e.g.,: + // projects/myproject/locations/US/capacityCommitments/123 + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigqueryreservation.googleapis.com/CapacityCommitment" + } + ]; + + // Number of slots in the capacity commitment after the split. + int64 slot_count = 2; +} + +// The response for +// [ReservationService.SplitCapacityCommitment][google.cloud.bigquery.reservation.v1.ReservationService.SplitCapacityCommitment]. +message SplitCapacityCommitmentResponse { + // First capacity commitment, result of a split. + CapacityCommitment first = 1; + + // Second capacity commitment, result of a split. + CapacityCommitment second = 2; +} + +// The request for +// [ReservationService.MergeCapacityCommitments][google.cloud.bigquery.reservation.v1.ReservationService.MergeCapacityCommitments]. +message MergeCapacityCommitmentsRequest { + // Parent resource that identifies admin project and location e.g., + // projects/myproject/locations/us + string parent = 1 [(google.api.resource_reference) = { + child_type: "bigqueryreservation.googleapis.com/CapacityCommitment" + }]; + + // Ids of capacity commitments to merge. + // These capacity commitments must exist under admin project and location + // specified in the parent. + repeated string capacity_commitment_ids = 2; +} + +// A Assignment allows a project to submit jobs +// of a certain type using slots from the specified reservation. +message Assignment { + option (google.api.resource) = { + type: "bigqueryreservation.googleapis.com/Assignment" + pattern: "projects/{project}/locations/{location}/reservations/{reservation}/assignments/{assignment}" + }; + + // Types of job, which could be specified when using the reservation. + enum JobType { + // Invalid type. Requests with this value will be rejected with + // error code `google.rpc.Code.INVALID_ARGUMENT`. + JOB_TYPE_UNSPECIFIED = 0; + + // Pipeline (load/export) jobs from the project will use the reservation. + PIPELINE = 1; + + // Query jobs from the project will use the reservation. + QUERY = 2; + } + + // Assignment will remain in PENDING state if no active capacity commitment is + // present. It will become ACTIVE when some capacity commitment becomes + // active. + enum State { + // Invalid state value. + STATE_UNSPECIFIED = 0; + + // Queries from assignee will be executed as on-demand, if related + // assignment is pending. + PENDING = 1; + + // Assignment is ready. + ACTIVE = 2; + } + + // Output only. Name of the resource. E.g.: + // `projects/myproject/locations/US/reservations/team1-prod/assignments/123`. + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The resource which will use the reservation. E.g. + // `projects/myproject`, `folders/123`, or `organizations/456`. + string assignee = 4; + + // Which type of jobs will use the reservation. + JobType job_type = 3; + + // Output only. State of the assignment. + State state = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// The request for +// [ReservationService.CreateAssignment][google.cloud.bigquery.reservation.v1.ReservationService.CreateAssignment]. +// Note: "bigquery.reservationAssignments.create" permission is required on the +// related assignee. +message CreateAssignmentRequest { + // Required. The parent resource name of the assignment + // E.g. `projects/myproject/locations/US/reservations/team1-prod` + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "bigqueryreservation.googleapis.com/Assignment" + } + ]; + + // Assignment resource to create. + Assignment assignment = 2; +} + +// The request for +// [ReservationService.ListAssignments][google.cloud.bigquery.reservation.v1.ReservationService.ListAssignments]. +message ListAssignmentsRequest { + // Required. The parent resource name e.g.: + // + // `projects/myproject/locations/US/reservations/team1-prod` + // + // Or: + // + // `projects/myproject/locations/US/reservations/-` + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigqueryreservation.googleapis.com/Reservation" + } + ]; + + // The maximum number of items to return per page. + int32 page_size = 2; + + // The next_page_token value returned from a previous List request, if any. + string page_token = 3; +} + +// The response for +// [ReservationService.ListAssignments][google.cloud.bigquery.reservation.v1.ReservationService.ListAssignments]. +message ListAssignmentsResponse { + // List of assignments visible to the user. + repeated Assignment assignments = 1; + + // Token to retrieve the next page of results, or empty if there are no + // more results in the list. + string next_page_token = 2; +} + +// The request for +// [ReservationService.DeleteAssignment][google.cloud.bigquery.reservation.v1.ReservationService.DeleteAssignment]. +// Note: "bigquery.reservationAssignments.delete" permission is required on the +// related assignee. +message DeleteAssignmentRequest { + // Required. Name of the resource, e.g. + // `projects/myproject/locations/US/reservations/team1-prod/assignments/123` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigqueryreservation.googleapis.com/Assignment" + } + ]; +} + +// The request for +// [ReservationService.SearchAssignments][google.cloud.bigquery.reservation.v1.ReservationService.SearchAssignments]. +// Note: "bigquery.reservationAssignments.search" permission is required on the +// related assignee. +message SearchAssignmentsRequest { + // Required. The resource name of the admin project(containing project and + // location), e.g.: + // "projects/myproject/locations/US". + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "bigqueryreservation.googleapis.com/Assignment" + } + ]; + + // Please specify resource name as assignee in the query. + // + // Examples: + // + // * `assignee=projects/myproject` + // * `assignee=folders/123` + // * `assignee=organizations/456` + string query = 2; + + // The maximum number of items to return per page. + int32 page_size = 3; + + // The next_page_token value returned from a previous List request, if any. + string page_token = 4; +} + +// The response for +// [ReservationService.SearchAssignments][google.cloud.bigquery.reservation.v1.ReservationService.SearchAssignments]. +message SearchAssignmentsResponse { + // List of assignments visible to the user. + repeated Assignment assignments = 1; + + // Token to retrieve the next page of results, or empty if there are no + // more results in the list. + string next_page_token = 2; +} + +// The request for +// [ReservationService.MoveAssignment][google.cloud.bigquery.reservation.v1.ReservationService.MoveAssignment]. +// +// **Note**: "bigquery.reservationAssignments.create" permission is required on +// the destination_id. +// +// **Note**: "bigquery.reservationAssignments.create" and +// "bigquery.reservationAssignments.delete" permission are required on the +// related assignee. +message MoveAssignmentRequest { + // Required. The resource name of the assignment, + // e.g. + // `projects/myproject/locations/US/reservations/team1-prod/assignments/123` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigqueryreservation.googleapis.com/Assignment" + } + ]; + + // The new reservation ID, e.g.: + // `projects/myotherproject/locations/US/reservations/team2-prod` + string destination_id = 3; +} + +// Represents a BI Reservation. +message BiReservation { + option (google.api.resource) = { + type: "bigqueryreservation.googleapis.com/BiReservation" + pattern: "projects/{project}/locations/{location}/bireservation" + }; + + // The resource name of the singleton BI reservation. + // Reservation names have the form + // `projects/{project_id}/locations/{location_id}/bireservation`. + string name = 1; + + // Output only. The last update timestamp of a reservation. + google.protobuf.Timestamp update_time = 3 + [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Size of a reservation, in bytes. + int64 size = 4; +} + +// A request to get a singleton BI reservation. +message GetBiReservationRequest { + // Required. Name of the requested reservation, for example: + // `projects/{project_id}/locations/{location_id}/bireservation` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigqueryreservation.googleapis.com/BiReservation" + } + ]; +} + +// A request to update a BI reservation. +message UpdateBiReservationRequest { + // A reservation to update. + BiReservation bi_reservation = 1; + + // A list of fields to be updated in this request. + google.protobuf.FieldMask update_mask = 2; +} diff --git a/third_party/googleapis/google/cloud/bigquery/reservation/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/bigquery/reservation/v1beta1/BUILD.bazel new file mode 100644 index 000000000..44b12b6d0 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/reservation/v1beta1/BUILD.bazel @@ -0,0 +1,365 @@ +# This file was automatically generated by BuildFileGenerator + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") +load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") + +proto_library( + name = "reservation_proto", + srcs = [ + "reservation.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/rpc:status_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +proto_library_with_info( + name = "reservation_proto_with_info", + deps = [ + ":reservation_proto", + "//google/cloud:common_resources_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", + "java_proto_library", +) + +java_proto_library( + name = "reservation_java_proto", + deps = [":reservation_proto"], +) + +java_grpc_library( + name = "reservation_java_grpc", + srcs = [":reservation_proto"], + deps = [":reservation_java_proto"], +) + +java_gapic_library( + name = "reservation_java_gapic", + src = ":reservation_proto_with_info", + gapic_yaml = "bigqueryreservation_gapic.yaml", + package = "google.cloud.bigquery.reservation.v1beta1", + service_yaml = "bigqueryreservation_v1beta1.yaml", + test_deps = [ + ":reservation_java_grpc", + ], + deps = [ + ":reservation_java_proto", + ], +) + +java_gapic_test( + name = "reservation_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.bigquery.reservation.v1beta1.ReservationServiceClientTest", + ], + runtime_deps = [":reservation_java_gapic_test"], +) + +# Open Source Packages +java_gapic_assembly_gradle_pkg( + name = "google-cloud-bigquery-reservation-v1beta1-java", + deps = [ + ":reservation_java_gapic", + ":reservation_java_grpc", + ":reservation_java_proto", + ":reservation_proto", + ], +) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", + "go_proto_library", + "go_test", +) + +go_proto_library( + name = "reservation_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/cloud/bigquery/reservation/v1beta1", + protos = [":reservation_proto"], + deps = [ + "//google/api:annotations_go_proto", + "//google/rpc:status_go_proto", + ], +) + +go_gapic_library( + name = "reservation_go_gapic", + srcs = [":reservation_proto_with_info"], + grpc_service_config = "bigqueryreservation_grpc_service_config.json", + importpath = "cloud.google.com/go/bigquery/reservation/apiv1beta1;reservation", + service_yaml = "bigqueryreservation_v1beta1.yaml", + deps = [ + ":reservation_go_proto", + ], +) + +go_test( + name = "reservation_go_gapic_test", + srcs = [":reservation_go_gapic_srcjar_test"], + embed = [":reservation_go_gapic"], + importpath = "cloud.google.com/go/bigquery/reservation/apiv1beta1", +) + +# Open Source Packages +go_gapic_assembly_pkg( + name = "gapi-cloud-bigquery-reservation-v1beta1-go", + deps = [ + ":reservation_go_gapic", + ":reservation_go_gapic_srcjar-test.srcjar", + ":reservation_go_proto", + ], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "reservation_moved_proto", + srcs = [":reservation_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/rpc:status_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +py_proto_library( + name = "reservation_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":reservation_moved_proto"], +) + +py_grpc_library( + name = "reservation_py_grpc", + srcs = [":reservation_moved_proto"], + deps = [":reservation_py_proto"], +) + +py_gapic_library( + name = "reservation_py_gapic", + src = ":reservation_proto_with_info", + gapic_yaml = "bigqueryreservation_gapic.yaml", + package = "google.cloud.bigquery.reservation.v1beta1", + service_yaml = "bigqueryreservation_v1beta1.yaml", + deps = [ + ":reservation_py_grpc", + ":reservation_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "bigquery-reservation-v1beta1-py", + deps = [ + ":reservation_py_gapic", + ":reservation_py_grpc", + ":reservation_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "reservation_php_proto", + deps = [":reservation_proto"], +) + +php_grpc_library( + name = "reservation_php_grpc", + srcs = [":reservation_proto"], + deps = [":reservation_php_proto"], +) + +php_gapic_library( + name = "reservation_php_gapic", + src = ":reservation_proto_with_info", + gapic_yaml = "bigqueryreservation_gapic.yaml", + package = "google.cloud.bigquery.reservation.v1beta1", + service_yaml = "bigqueryreservation_v1beta1.yaml", + deps = [ + ":reservation_php_grpc", + ":reservation_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-bigquery-reservation-v1beta1-php", + deps = [ + ":reservation_php_gapic", + ":reservation_php_grpc", + ":reservation_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "reservation_nodejs_gapic", + src = ":reservation_proto_with_info", + gapic_yaml = "bigqueryreservation_gapic.yaml", + package = "google.cloud.bigquery.reservation.v1beta1", + service_yaml = "bigqueryreservation_v1beta1.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "bigquery-reservation-v1beta1-nodejs", + deps = [ + ":reservation_nodejs_gapic", + ":reservation_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "reservation_ruby_proto", + deps = [":reservation_proto"], +) + +ruby_grpc_library( + name = "reservation_ruby_grpc", + srcs = [":reservation_proto"], + deps = [":reservation_ruby_proto"], +) + +ruby_gapic_library( + name = "reservation_ruby_gapic", + src = ":reservation_proto_with_info", + gapic_yaml = "bigqueryreservation_gapic.yaml", + package = "google.cloud.bigquery.reservation.v1beta1", + service_yaml = "bigqueryreservation_v1beta1.yaml", + deps = [ + ":reservation_ruby_grpc", + ":reservation_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-bigquery-reservation-v1beta1-ruby", + deps = [ + ":reservation_ruby_gapic", + ":reservation_ruby_grpc", + ":reservation_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "reservation_csharp_proto", + deps = [":reservation_proto"], +) + +csharp_grpc_library( + name = "reservation_csharp_grpc", + srcs = [":reservation_proto"], + deps = [":reservation_csharp_proto"], +) + +csharp_gapic_library( + name = "reservation_csharp_gapic", + src = ":reservation_proto_with_info", + gapic_yaml = "bigqueryreservation_gapic.yaml", + package = "google.cloud.bigquery.reservation.v1beta1", + service_yaml = "bigqueryreservation_v1beta1.yaml", + deps = [ + ":reservation_csharp_grpc", + ":reservation_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-bigquery-reservation-v1beta1-csharp", + deps = [ + ":reservation_csharp_gapic", + ":reservation_csharp_grpc", + ":reservation_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/cloud/bigquery/reservation/v1beta1/artman_bigqueryreservation_v1beta1.yaml b/third_party/googleapis/google/cloud/bigquery/reservation/v1beta1/artman_bigqueryreservation_v1beta1.yaml new file mode 100644 index 000000000..70460351f --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/reservation/v1beta1/artman_bigqueryreservation_v1beta1.yaml @@ -0,0 +1,19 @@ +common: + api_name: bigqueryreservation + api_version: v1beta1 + organization_name: google-cloud + proto_deps: + - name: google-common-protos + src_proto_paths: + - . + service_yaml: bigqueryreservation_v1beta1.yaml + gapic_yaml: bigqueryreservation_gapic.yaml +artifacts: +- name: gapic_config + type: GAPIC_CONFIG +- name: python_gapic + type: GAPIC + language: PYTHON +- name: php_gapic + type: GAPIC + language: PHP diff --git a/third_party/googleapis/google/cloud/bigquery/reservation/v1beta1/bigqueryreservation_gapic.legacy.yaml b/third_party/googleapis/google/cloud/bigquery/reservation/v1beta1/bigqueryreservation_gapic.legacy.yaml new file mode 100644 index 000000000..10260b254 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/reservation/v1beta1/bigqueryreservation_gapic.legacy.yaml @@ -0,0 +1,369 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 1.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.bigquery.reservation.v1beta1 + python: + package_name: google.cloud.bigquery.reservation_v1beta1.gapic + go: + package_name: cloud.google.com/go/bigquery/reservation/apiv1beta1 + csharp: + package_name: Google.Cloud.Bigquery.Reservation.V1beta1 + ruby: + package_name: Google::Cloud::Bigquery::Reservation::V1beta1 + php: + package_name: Google\Cloud\Bigquery\Reservation\V1beta1 + nodejs: + package_name: reservation.v1beta1 +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.cloud.bigquery.reservation.v1beta1.ReservationService + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: + - name_pattern: projects/{project}/locations/{location} + entity_name: location + - name_pattern: projects/{project}/locations/{location}/capacityCommitments/{capacity_commitment} + entity_name: capacity_commitment + - name_pattern: projects/{project}/locations/{location}/reservations/{reservation} + entity_name: reservation + - name_pattern: projects/{project}/locations/{location}/reservations/{reservation}/assignments/{assignment} + entity_name: assignment + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - DEADLINE_EXCEEDED + - UNAVAILABLE + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # + # name - The simple name of the method. + # + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce method + # overloads which allow a client to directly pass request message fields as + # method parameters. This information may or may not be used, depending on + # the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request message. + # + # required_fields - Fields that are always required for a request to be + # valid. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a paging + # list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It defines + # which fields match the paging pattern in the request. The request consists + # of a page_size_field and a token_field. The page_size_field is the name of + # the optional field specifying the maximum number of elements to be + # returned in the response. The token_field is the name of the field in the + # request containing the page token. + # The response specifies response information of the list method. It defines + # which fields match the paging pattern in the response. The response + # consists of a token_field and a resources_field. The token_field is the + # name of the field in the response containing the next page token. The + # resources_field is the name of the field in the response containing the + # list of resources belonging to the page. + # + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: CreateReservation + flattening: + groups: + - parameters: + - parent + - reservation_id + - reservation + required_fields: + - parent + - reservation_id + - reservation + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: location + timeout_millis: 60000 + - name: ListReservations + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: reservations + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: location + timeout_millis: 60000 + - name: GetReservation + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: reservation + timeout_millis: 60000 + - name: GetBiReservation + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: reservation + timeout_millis: 60000 + - name: DeleteReservation + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: reservation + timeout_millis: 60000 + - name: UpdateReservation + flattening: + groups: + - parameters: + - reservation + - update_mask + required_fields: + - reservation + - update_mask + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + reservation.name: reservation + timeout_millis: 60000 + - name: UpdateBiReservation + flattening: + groups: + - parameters: + - reservation + - update_mask + required_fields: + - reservation + - update_mask + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + reservation.name: reservation + timeout_millis: 60000 + - name: ListCapacityCommitments + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: capacity_commitments + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: location + timeout_millis: 60000 + - name: GetCapacityCommitment + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: capacity_commitment + timeout_millis: 60000 + - name: UpdateCapacityCommitment + flattening: + groups: + - parameters: + - capacity_commitment + - update_mask + required_fields: + - capacity_commitment + - update_mask + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + capacity_commitment.name: capacity_commitment + timeout_millis: 60000 + - name: SplitCapacityCommitment + flattening: + groups: + - parameters: + - name + - slot_count + required_fields: + - name + - slot_count + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: capacity_commitment + timeout_millis: 60000 + - name: MergeCapacityCommitments + flattening: + groups: + - parameters: + - parent + - capacity_commitment_ids + required_fields: + - parent + - capacity_commitment_ids + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: location + timeout_millis: 6000 + - name: DeleteCapacityCommitment + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: capacity_commitment + timeout_millis: 60000 + - name: CreateAssignment + flattening: + groups: + - parameters: + - parent + - assignment + required_fields: + - parent + - assignment + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: reservation + timeout_millis: 60000 + - name: ListAssignments + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: assignments + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: reservation + timeout_millis: 60000 + - name: DeleteAssignment + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: assignment + timeout_millis: 60000 + - name: SearchAssignments + flattening: + groups: + - parameters: + - parent + - query + required_fields: + - parent + - query + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: assignments + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: location + timeout_millis: 60000 + - name: MoveAssignment + flattening: + groups: + - parameters: + - name + - destination_id + required_fields: + - name + - destination_id + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: assignment + timeout_millis: 60000 diff --git a/third_party/googleapis/google/cloud/bigquery/reservation/v1beta1/bigqueryreservation_gapic.yaml b/third_party/googleapis/google/cloud/bigquery/reservation/v1beta1/bigqueryreservation_gapic.yaml new file mode 100644 index 000000000..8d36e0466 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/reservation/v1beta1/bigqueryreservation_gapic.yaml @@ -0,0 +1,29 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 2.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.bigquery.reservation.v1beta1 + python: + package_name: google.cloud.bigquery.reservation_v1beta1.gapic + go: + package_name: cloud.google.com/go/bigquery/reservation/apiv1beta1 + csharp: + package_name: Google.Cloud.Bigquery.Reservation.V1beta1 + ruby: + package_name: Google::Cloud::Bigquery::Reservation::V1beta1 + php: + package_name: Google\Cloud\Bigquery\Reservation\V1beta1 + nodejs: + package_name: reservation.v1beta1 +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.cloud.bigquery.reservation.v1beta1.ReservationService + methods: + - name: DeleteReservation + retry_codes_name: idempotent + - name: DeleteCapacityCommitment + retry_codes_name: idempotent + - name: DeleteAssignment + retry_codes_name: idempotent diff --git a/third_party/googleapis/google/cloud/bigquery/reservation/v1beta1/bigqueryreservation_grpc_service_config.json b/third_party/googleapis/google/cloud/bigquery/reservation/v1beta1/bigqueryreservation_grpc_service_config.json new file mode 100755 index 000000000..f7c774fdb --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/reservation/v1beta1/bigqueryreservation_grpc_service_config.json @@ -0,0 +1,96 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.bigquery.reservation.v1beta1.ReservationService", + "method": "CreateReservation" + }, + { + "service": "google.cloud.bigquery.reservation.v1beta1.ReservationService", + "method": "UpdateReservation" + }, + { + "service": "google.cloud.bigquery.reservation.v1beta1.ReservationService", + "method": "UpdateCapacityCommitment" + }, + { + "service": "google.cloud.bigquery.reservation.v1beta1.ReservationService", + "method": "SplitCapacityCommitment" + }, + { + "service": "google.cloud.bigquery.reservation.v1beta1.ReservationService", + "method": "MergeCapacityCommitments" + }, + { + "service": "google.cloud.bigquery.reservation.v1beta1.ReservationService", + "method": "CreateAssignment" + }, + { + "service": "google.cloud.bigquery.reservation.v1beta1.ReservationService", + "method": "MoveAssignment" + }, + { + "service": "google.cloud.bigquery.reservation.v1beta1.ReservationService", + "method": "UpdateBiReservation" + } + ], + "timeout": "60s" + }, + { + "name": [ + { + "service": "google.cloud.bigquery.reservation.v1beta1.ReservationService", + "method": "ListReservations" + }, + { + "service": "google.cloud.bigquery.reservation.v1beta1.ReservationService", + "method": "GetReservation" + }, + { + "service": "google.cloud.bigquery.reservation.v1beta1.ReservationService", + "method": "DeleteReservation" + }, + { + "service": "google.cloud.bigquery.reservation.v1beta1.ReservationService", + "method": "ListCapacityCommitments" + }, + { + "service": "google.cloud.bigquery.reservation.v1beta1.ReservationService", + "method": "GetCapacityCommitment" + }, + { + "service": "google.cloud.bigquery.reservation.v1beta1.ReservationService", + "method": "DeleteCapacityCommitment" + }, + { + "service": "google.cloud.bigquery.reservation.v1beta1.ReservationService", + "method": "ListAssignments" + }, + { + "service": "google.cloud.bigquery.reservation.v1beta1.ReservationService", + "method": "DeleteAssignment" + }, + { + "service": "google.cloud.bigquery.reservation.v1beta1.ReservationService", + "method": "SearchAssignments" + }, + { + "service": "google.cloud.bigquery.reservation.v1beta1.ReservationService", + "method": "GetBiReservation" + } + ], + "timeout": "60s", + "retryPolicy": { + "maxAttempts": 5, + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/cloud/bigquery/reservation/v1beta1/bigqueryreservation_v1beta1.yaml b/third_party/googleapis/google/cloud/bigquery/reservation/v1beta1/bigqueryreservation_v1beta1.yaml new file mode 100644 index 000000000..96ff59e55 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/reservation/v1beta1/bigqueryreservation_v1beta1.yaml @@ -0,0 +1,23 @@ +type: google.api.Service +config_version: 3 +name: bigqueryreservation.googleapis.com +title: BigQuery Reservation API + +apis: +- name: google.cloud.bigquery.reservation.v1beta1.ReservationService + +documentation: + summary: 'A service to modify your BigQuery flat-rate reservations.' + +authentication: + rules: + - selector: 'google.cloud.bigquery.reservation.v1beta1.ReservationService.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/bigquery, + https://www.googleapis.com/auth/cloud-platform + - selector: 'google.longrunning.Operations.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/bigquery, + https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/bigquery/reservation/v1beta1/reservation.proto b/third_party/googleapis/google/cloud/bigquery/reservation/v1beta1/reservation.proto new file mode 100644 index 000000000..2a4fb3a77 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/reservation/v1beta1/reservation.proto @@ -0,0 +1,808 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.bigquery.reservation.v1beta1; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/empty.proto"; +import "google/protobuf/field_mask.proto"; +import "google/protobuf/timestamp.proto"; +import "google/rpc/status.proto"; + +option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/reservation/v1beta1;reservation"; +option java_multiple_files = true; +option java_package = "com.google.cloud.bigquery.reservation.v1beta1"; + +// This API allows users to manage their flat-rate BigQuery reservations. +// +// A reservation provides computational resource guarantees, in the form of +// [slots](https://cloud.google.com/bigquery/docs/slots), to users. A slot is a +// unit of computational power in BigQuery, and serves as the basic unit of +// parallelism. In a scan of a multi-partitioned table, a single slot operates +// on a single partition of the table. A reservation resource exists as a child +// resource of the admin project and location, e.g.: +// projects/myproject/locations/US/reservations/reservationName. +// +// A capacity commitment is a way to purchase compute capacity for BigQuery jobs +// (in the form of slots) with some committed period of usage. A capacity +// commitment resource exists as a child resource of the admin project and +// location, e.g.: +// projects/myproject/locations/US/capacityCommitments/id. +service ReservationService { + option (google.api.default_host) = "bigqueryreservation.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/bigquery," + "https://www.googleapis.com/auth/cloud-platform"; + + // Creates a new reservation resource. + rpc CreateReservation(CreateReservationRequest) returns (Reservation) { + option (google.api.http) = { + post: "/v1beta1/{parent=projects/*/locations/*}/reservations" + body: "reservation" + }; + option (google.api.method_signature) = "parent,reservation,reservation_id"; + } + + // Lists all the reservations for the project in the specified location. + rpc ListReservations(ListReservationsRequest) + returns (ListReservationsResponse) { + option (google.api.http) = { + get: "/v1beta1/{parent=projects/*/locations/*}/reservations" + }; + option (google.api.method_signature) = "parent"; + } + + // Returns information about the reservation. + rpc GetReservation(GetReservationRequest) returns (Reservation) { + option (google.api.http) = { + get: "/v1beta1/{name=projects/*/locations/*/reservations/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Deletes a reservation. + // Returns `google.rpc.Code.FAILED_PRECONDITION` when reservation has + // assignments. + rpc DeleteReservation(DeleteReservationRequest) + returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1beta1/{name=projects/*/locations/*/reservations/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Updates an existing reservation resource. + rpc UpdateReservation(UpdateReservationRequest) returns (Reservation) { + option (google.api.http) = { + patch: "/v1beta1/{reservation.name=projects/*/locations/*/reservations/*}" + body: "reservation" + }; + option (google.api.method_signature) = "reservation,update_mask"; + } + + // Lists all the capacity commitments for the admin project. + rpc ListCapacityCommitments(ListCapacityCommitmentsRequest) + returns (ListCapacityCommitmentsResponse) { + option (google.api.http) = { + get: "/v1beta1/{parent=projects/*/locations/*}/capacityCommitments" + }; + option (google.api.method_signature) = "parent"; + } + + // Returns information about the capacity commitment. + rpc GetCapacityCommitment(GetCapacityCommitmentRequest) + returns (CapacityCommitment) { + option (google.api.http) = { + get: "/v1beta1/{name=projects/*/locations/*/capacityCommitments/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Deletes a capacity commitment. Attempting to delete capacity commitment + // before its commitment_end_time will fail with the error code + // `google.rpc.Code.FAILED_PRECONDITION`. + rpc DeleteCapacityCommitment(DeleteCapacityCommitmentRequest) + returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1beta1/{name=projects/*/locations/*/capacityCommitments/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Updates an existing capacity commitment. + // + // Only renewal_plan field can be updated. + rpc UpdateCapacityCommitment(UpdateCapacityCommitmentRequest) + returns (CapacityCommitment) { + option (google.api.http) = { + patch: "/v1beta1/{capacity_commitment.name=projects/*/locations/*/capacityCommitments/*}" + body: "capacity_commitment" + }; + option (google.api.method_signature) = "capacity_commitment,update_mask"; + } + + // Splits capacity commitment to two commitments of the same plan and + // commitment_end_time. A common use case to do that is to perform a downgrade + // e.g., in order to downgrade from 10000 slots to 8000, one might split 10000 + // capacity commitment to 2000 and 8000, change the plan of the first one to + // flex and then delete it. + rpc SplitCapacityCommitment(SplitCapacityCommitmentRequest) + returns (SplitCapacityCommitmentResponse) { + option (google.api.http) = { + post: "/v1beta1/{name=projects/*/locations/*/capacityCommitments/*}:split" + body: "*" + }; + option (google.api.method_signature) = "name,slot_count"; + } + + // Merges capacity commitments of the same plan into one. Resulting capacity + // commitment has the longer commitment_end_time out of the two. Attempting to + // merge capacity commitments of different plan will fail with the error code + // `google.rpc.Code.FAILED_PRECONDITION`. + rpc MergeCapacityCommitments(MergeCapacityCommitmentsRequest) + returns (CapacityCommitment) { + option (google.api.http) = { + post: "/v1beta1/{parent=projects/*/locations/*}/capacityCommitments:merge" + body: "*" + }; + option (google.api.method_signature) = "parent,capacity_commitment_ids"; + } + + // Returns `google.rpc.Code.PERMISSION_DENIED` if user does not have + // 'bigquery.admin' permissions on the project using the reservation + // and the project that owns this reservation. + // Returns `google.rpc.Code.INVALID_ARGUMENT` when location of the assignment + // does not match location of the reservation. + rpc CreateAssignment(CreateAssignmentRequest) returns (Assignment) { + option (google.api.http) = { + post: "/v1beta1/{parent=projects/*/locations/*/reservations/*}/assignments" + body: "assignment" + }; + option (google.api.method_signature) = "parent,assignment"; + } + + // Lists assignments. + // Only explicitly created assignments will be returned. E.g: + // organizationA contains project1 and project2. Reservation res1 exists. + // CreateAssignment was invoked previously and following assignments were + // created explicitly: + // + // + // Then this API will just return the above two assignments for reservation + // res1, and no expansion/merge will happen. Wildcard "-" can be used for + // reservations in the request. In that case all assignments belongs to the + // specified project and location will be listed. Note + // "-" cannot be used for projects nor locations. + rpc ListAssignments(ListAssignmentsRequest) + returns (ListAssignmentsResponse) { + option (google.api.http) = { + get: "/v1beta1/{parent=projects/*/locations/*/reservations/*}/assignments" + }; + option (google.api.method_signature) = "parent"; + } + + // Deletes a assignment. No expansion will happen. + // E.g: + // organizationA contains project1 and project2. Reservation res1 exists. + // CreateAssignment was invoked previously and following assignments were + // created explicitly: + // + // + // Then deletion of won't affect . After + // deletion of , queries from project1 will still use + // res1, while queries from project2 will use on-demand mode. + rpc DeleteAssignment(DeleteAssignmentRequest) + returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1beta1/{name=projects/*/locations/*/reservations/*/assignments/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Looks up assignments for a specified resource for a particular region. + // If the request is about a project: + // 1) Assignments created on the project will be returned if they exist. + // 2) Otherwise assignments created on the closest ancestor will be + // returned. 3) Assignments for different JobTypes will all be returned. + // Same logic applies if the request is about a folder. + // If the request is about an organization, then assignments created on the + // organization will be returned (organization doesn't have ancestors). + // Comparing to ListAssignments, there are some behavior + // differences: + // 1) permission on the assignee will be verified in this API. + // 2) Hierarchy lookup (project->folder->organization) happens in this API. + // 3) Parent here is projects/*/locations/*, instead of + // projects/*/locations/*reservations/*. + // Note "-" cannot be used for projects + // nor locations. + rpc SearchAssignments(SearchAssignmentsRequest) + returns (SearchAssignmentsResponse) { + option (google.api.http) = { + get: "/v1beta1/{parent=projects/*/locations/*}:searchAssignments" + }; + option (google.api.method_signature) = "parent,query"; + } + + // Moves a assignment under a new reservation. Customers can do this by + // deleting the existing assignment followed by creating another assignment + // under the new reservation, but this method provides a transactional way to + // do so, to make sure the assignee always has an associated reservation. + // Without the method customers might see some queries run on-demand which + // might be unexpected. + rpc MoveAssignment(MoveAssignmentRequest) returns (Assignment) { + option (google.api.http) = { + post: "/v1beta1/{name=projects/*/locations/*/reservations/*/assignments/*}:move" + body: "*" + }; + option (google.api.method_signature) = "name,destination_id"; + } + + // Retrieves a BI reservation. + rpc GetBiReservation(GetBiReservationRequest) returns (BiReservation) { + option (google.api.http) = { + get: "/v1beta1/{name=projects/*/locations/*/biReservation}" + }; + option (google.api.method_signature) = "name"; + } + + // Updates a BI reservation. + // Only fields specified in the field_mask are updated. + // Singleton BI reservation always exists with default size 0. + // In order to reserve BI capacity it needs to be updated to an amount + // greater than 0. In order to release BI capacity reservation size + // must be set to 0. + rpc UpdateBiReservation(UpdateBiReservationRequest) returns (BiReservation) { + option (google.api.http) = { + patch: "/v1beta1/{bi_reservation.name=projects/*/locations/*/biReservation}" + body: "bi_reservation" + }; + option (google.api.method_signature) = "bi_reservation,update_mask"; + } +} + +// A reservation is a mechanism used to guarantee slots to users. +message Reservation { + option (google.api.resource) = { + type: "bigqueryreservation.googleapis.com/Reservation" + pattern: "projects/{project}/locations/{location}/reservations/{reservation}" + }; + + // The resource name of the reservation, e.g., + // "projects/*/locations/*/reservations/team1-prod". + string name = 1; + + // Minimum slots available to this reservation. A slot is a unit of + // computational power in BigQuery, and serves as the unit of parallelism. + // Queries using this reservation might use more slots during runtime if + // ignore_idle_slots is set to false. + // If the new reservation's slot capacity exceed the parent's slot capacity or + // if total slot capacity of the new reservation and its siblings exceeds the + // parent's slot capacity, the request will fail with + // `google.rpc.Code.RESOURCE_EXHAUSTED`. + int64 slot_capacity = 2; + + // If false, any query using this reservation will use idle slots from other + // reservations within the same admin project. If true, a query using this + // reservation will execute with the slot capacity specified above at most. + bool ignore_idle_slots = 4; +} + +// Capacity commitment is a way to purchase compute capacity for BigQuery jobs +// (in the form of slots) with some committed period of usage. Monthly and +// annual commitments renew by default. Only flex commitments can be removed. In +// order to remove monthly or annual commitments, their plan needs to be changed +// to flex first. +// +// A capacity commitment resource exists as a child resource of the admin +// project. +message CapacityCommitment { + option (google.api.resource) = { + type: "bigqueryreservation.googleapis.com/CapacityCommitment" + pattern: "projects/{project}/locations/{location}/capacityCommitments/{capacity_commitment}" + }; + + // Commitment plan defines the current committed period. Capacity commitment + // cannot be deleted during it's committed period. + enum CommitmentPlan { + // Invalid plan value. Requests with this value will be rejected with + // error code `google.rpc.Code.INVALID_ARGUMENT`. + COMMITMENT_PLAN_UNSPECIFIED = 0; + + // Flex commitments have committed period of 1 minute after becoming ACTIVE. + // After that, they are not in a committed period anymore and can be removed + // any time. + FLEX = 3; + + // Monthly commitments have a committed period of 30 days after becoming + // ACTIVE. + MONTHLY = 2; + + // Annual commitments have a committed period of 365 days after becoming + // ACTIVE. + ANNUAL = 4; + } + + // Capacity commitment can either become ACTIVE right away or transition + // from PENDING to ACTIVE or FAILED. + enum State { + // Invalid state value. + STATE_UNSPECIFIED = 0; + + // Capacity commitment is pending provisioning. Pending capacity commitment + // does not contribute to the parent's slot_capacity. + PENDING = 1; + + // Once slots are provisioned, capacity commitment becomes active. + // slot_count is added to the parent's slot_capacity. + ACTIVE = 2; + + // Capacity commitment is failed to be activated by the backend. + FAILED = 3; + } + + // Output only. The resource name of the capacity commitment, e.g., + // projects/myproject/locations/US/capacityCommitments/123 + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Number of slots in this commitment. + int64 slot_count = 2; + + // Capacity commitment commitment plan. + CommitmentPlan plan = 3; + + // Output only. State of the commitment. + State state = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The end of the current commitment period. It is applicable + // only for ACTIVE capacity commitments. + google.protobuf.Timestamp commitment_end_time = 5 + [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. For FAILED commitment plan, provides the reason of failure. + google.rpc.Status failure_status = 7 + [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The plan this capacity commitment is converted to after commitment_end_time + // passes. Once the plan is changed, committed period is extended according to + // commitment plan. Only applicable for MONTHLY and ANNUAL commitments. + CommitmentPlan renewal_plan = 8; +} + +// The request for +// [ReservationService.CreateReservation][google.cloud.bigquery.reservation.v1beta1.ReservationService.CreateReservation]. +message CreateReservationRequest { + // Required. Project, location. E.g., + // projects/myproject/locations/US + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "bigqueryreservation.googleapis.com/Reservation" + } + ]; + + // The reservation ID. This field must only contain lower case alphanumeric + // characters or dash. Max length is 64 characters. + string reservation_id = 2; + + // Content of the new reservation to create. + Reservation reservation = 3; +} + +// The request for +// [ReservationService.ListReservations][google.cloud.bigquery.reservation.v1beta1.ReservationService.ListReservations]. +message ListReservationsRequest { + // Required. The parent resource name containing project and location, e.g.: + // "projects/myproject/locations/US" + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "bigqueryreservation.googleapis.com/Reservation" + } + ]; + + // The maximum number of items to return. + int32 page_size = 2; + + // The next_page_token value returned from a previous List request, if any. + string page_token = 3; + + // Can be used to filter out reservations based on names, capacity, etc, e.g.: + // filter="reservation.slot_capacity > 200" + // filter="reservation.name = \"*dev/*\"" + // Advanced filtering syntax can be + // [here](https://cloud.google.com/logging/docs/view/advanced-filters). + string filter = 4; +} + +// The response for +// [ReservationService.ListReservations][google.cloud.bigquery.reservation.v1beta1.ReservationService.ListReservations]. +message ListReservationsResponse { + // List of reservations visible to the user. + repeated Reservation reservations = 1; + + // Token to retrieve the next page of results, or empty if there are no + // more results in the list. + string next_page_token = 2; +} + +// The request for +// [ReservationService.GetReservation][google.cloud.bigquery.reservation.v1beta1.ReservationService.GetReservation]. +message GetReservationRequest { + // Required. Resource name of the reservation to retrieve. E.g., + // projects/myproject/locations/US/reservations/team1-prod + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigqueryreservation.googleapis.com/Reservation" + } + ]; +} + +// The request for +// [ReservationService.DeleteReservation][google.cloud.bigquery.reservation.v1beta1.ReservationService.DeleteReservation]. +message DeleteReservationRequest { + // Required. Resource name of the reservation to retrieve. E.g., + // projects/myproject/locations/US/reservations/team1-prod + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigqueryreservation.googleapis.com/Reservation" + } + ]; +} + +// The request for +// [ReservationService.UpdateReservation][google.cloud.bigquery.reservation.v1beta1.ReservationService.UpdateReservation]. +message UpdateReservationRequest { + // Content of the reservation to update. + Reservation reservation = 1; + + // Standard field mask for the set of fields to be updated. + google.protobuf.FieldMask update_mask = 2; +} + +// The request for +// [ReservationService.ListCapacityCommitments][google.cloud.bigquery.reservation.v1beta1.ReservationService.ListCapacityCommitments]. +message ListCapacityCommitmentsRequest { + // Required. Resource name of the parent reservation. E.g., + // projects/myproject/locations/US + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "bigqueryreservation.googleapis.com/CapacityCommitment" + } + ]; + + // The maximum number of items to return. + int32 page_size = 2; + + // The next_page_token value returned from a previous List request, if any. + string page_token = 3; +} + +// The response for +// [ReservationService.ListCapacityCommitments][google.cloud.bigquery.reservation.v1beta1.ReservationService.ListCapacityCommitments]. +message ListCapacityCommitmentsResponse { + // List of capacity commitments visible to the user. + repeated CapacityCommitment capacity_commitments = 1; + + // Token to retrieve the next page of results, or empty if there are no + // more results in the list. + string next_page_token = 2; +} + +// The request for +// [ReservationService.GetCapacityCommitment][google.cloud.bigquery.reservation.v1beta1.ReservationService.GetCapacityCommitment]. +message GetCapacityCommitmentRequest { + // Required. Resource name of the capacity commitment to retrieve. E.g., + // projects/myproject/locations/US/capacityCommitments/123 + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigqueryreservation.googleapis.com/CapacityCommitment" + } + ]; +} + +// The request for +// [ReservationService.DeleteCapacityCommitment][google.cloud.bigquery.reservation.v1beta1.ReservationService.DeleteCapacityCommitment]. +message DeleteCapacityCommitmentRequest { + // Required. Resource name of the capacity commitment to delete. E.g., + // projects/myproject/locations/US/capacityCommitments/123 + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigqueryreservation.googleapis.com/CapacityCommitment" + } + ]; +} + +// The request for +// [ReservationService.UpdateCapacityCommitment][google.cloud.bigquery.reservation.v1beta1.ReservationService.UpdateCapacityCommitment]. +message UpdateCapacityCommitmentRequest { + // Content of the capacity commitment to update. + CapacityCommitment capacity_commitment = 1; + + // Standard field mask for the set of fields to be updated. + google.protobuf.FieldMask update_mask = 2; +} + +// The request for +// [ReservationService.SplitCapacityCommitment][google.cloud.bigquery.reservation.v1beta1.ReservationService.SplitCapacityCommitment]. +message SplitCapacityCommitmentRequest { + // Required. The resource name e.g.,: + // projects/myproject/locations/US/capacityCommitments/123 + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigqueryreservation.googleapis.com/CapacityCommitment" + } + ]; + + // Number of slots in the capacity commitment after the split. + int64 slot_count = 2; +} + +// The response for +// [ReservationService.SplitCapacityCommitment][google.cloud.bigquery.reservation.v1beta1.ReservationService.SplitCapacityCommitment]. +message SplitCapacityCommitmentResponse { + // First capacity commitment, result of a split. + CapacityCommitment first = 1; + + // Second capacity commitment, result of a split. + CapacityCommitment second = 2; +} + +// The request for +// [ReservationService.MergeCapacityCommitments][google.cloud.bigquery.reservation.v1beta1.ReservationService.MergeCapacityCommitments]. +message MergeCapacityCommitmentsRequest { + // Parent resource that identifies admin project and location e.g., + // projects/myproject/locations/us + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "bigqueryreservation.googleapis.com/CapacityCommitment" + } + ]; + + // Ids of capacity commitments to merge. + // These capacity commitments must exist under admin project and location + // specified in the parent. + repeated string capacity_commitment_ids = 2; +} + +// A Assignment allows a project to submit jobs +// of a certain type using slots from the specified reservation. +message Assignment { + option (google.api.resource) = { + type: "bigqueryreservation.googleapis.com/Assignment" + pattern: "projects/{project}/locations/{location}/reservations/{reservation}/assignments/{assignment}" + }; + + // Types of job, which could be specified when using the reservation. + enum JobType { + // Invalid type. Requests with this value will be rejected with + // error code `google.rpc.Code.INVALID_ARGUMENT`. + JOB_TYPE_UNSPECIFIED = 0; + + // Pipeline (load/export) jobs from the project will use the reservation. + PIPELINE = 1; + + // Query jobs from the project will use the reservation. + QUERY = 2; + } + + // Assignment will remain in PENDING state if no active capacity commitment is + // present. It will become ACTIVE when some capacity commitment becomes + // active. + enum State { + // Invalid state value. + STATE_UNSPECIFIED = 0; + + // Queries from assignee will be executed as on-demand, if related + // assignment is pending. + PENDING = 1; + + // Assignment is ready. + ACTIVE = 2; + } + + // Output only. Name of the resource. E.g.: + // projects/myproject/locations/US/reservations/team1-prod/assignments/123. + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The resource which will use the reservation. E.g. + // projects/myproject, folders/123, organizations/456. + string assignee = 4 [(google.api.resource_reference) = { type: "*" }]; + + // Which type of jobs will use the reservation. + JobType job_type = 3; + + // Output only. State of the assignment. + State state = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// The request for +// [ReservationService.CreateAssignment][google.cloud.bigquery.reservation.v1beta1.ReservationService.CreateAssignment]. +// Note: "bigquery.reservationAssignments.create" permission is required on the +// related assignee. +message CreateAssignmentRequest { + // Required. The parent resource name of the assignment + // E.g.: projects/myproject/locations/US/reservations/team1-prod + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "bigqueryreservation.googleapis.com/Assignment" + } + ]; + + // Assignment resource to create. + Assignment assignment = 2; +} + +// The request for +// [ReservationService.ListAssignments][google.cloud.bigquery.reservation.v1beta1.ReservationService.ListAssignments]. +message ListAssignmentsRequest { + // Required. The parent resource name e.g.: + // projects/myproject/locations/US/reservations/team1-prod + // Or: + // projects/myproject/locations/US/reservations/- + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "bigqueryreservation.googleapis.com/Assignment" + } + ]; + + // The maximum number of items to return. + int32 page_size = 2; + + // The next_page_token value returned from a previous List request, if any. + string page_token = 3; +} + +// The response for +// [ReservationService.ListAssignments][google.cloud.bigquery.reservation.v1beta1.ReservationService.ListAssignments]. +message ListAssignmentsResponse { + // List of assignments visible to the user. + repeated Assignment assignments = 1; + + // Token to retrieve the next page of results, or empty if there are no + // more results in the list. + string next_page_token = 2; +} + +// The request for +// [ReservationService.DeleteAssignment][google.cloud.bigquery.reservation.v1beta1.ReservationService.DeleteAssignment]. +// Note: "bigquery.reservationAssignments.delete" permission is required on the +// related assignee. +message DeleteAssignmentRequest { + // Required. Name of the resource, e.g.: + // projects/myproject/locations/US/reservations/team1-prod/assignments/123 + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigqueryreservation.googleapis.com/Assignment" + } + ]; +} + +// The request for +// [ReservationService.SearchAssignments][google.cloud.bigquery.reservation.v1beta1.ReservationService.SearchAssignments]. +// Note: "bigquery.reservationAssignments.search" permission is required on the +// related assignee. +message SearchAssignmentsRequest { + // Required. The resource name of the admin project(containing project and + // location), e.g.: + // "projects/myproject/locations/US". + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "locations.googleapis.com/Location" + } + ]; + + // Please specify resource name as assignee in the query. + // e.g., "assignee=projects/myproject" + // "assignee=folders/123" + // "assignee=organizations/456" + string query = 2; + + // The maximum number of items to return. + int32 page_size = 3; + + // The next_page_token value returned from a previous List request, if any. + string page_token = 4; +} + +// The response for +// [ReservationService.SearchAssignments][google.cloud.bigquery.reservation.v1beta1.ReservationService.SearchAssignments]. +message SearchAssignmentsResponse { + // List of assignments visible to the user. + repeated Assignment assignments = 1; + + // Token to retrieve the next page of results, or empty if there are no + // more results in the list. + string next_page_token = 2; +} + +// The request for +// [ReservationService.MoveAssignment][google.cloud.bigquery.reservation.v1beta1.ReservationService.MoveAssignment]. +// Note: "bigquery.reservationAssignments.create" permission is required on the +// destination_id. Note: "bigquery.reservationAssignments.create" and +// "bigquery.reservationAssignments.delete" permission is required on the +// related assignee. +message MoveAssignmentRequest { + // Required. The resource name of the assignment, + // e.g.: + // projects/myproject/locations/US/reservations/team1-prod/assignments/123 + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigqueryreservation.googleapis.com/Assignment" + } + ]; + + // The new reservation ID, e.g.: + // projects/myotherproject/locations/US/reservations/team2-prod + string destination_id = 3 [(google.api.resource_reference) = { + child_type: "bigqueryreservation.googleapis.com/Assignment" + }]; +} + +// Represents a BI Reservation. +message BiReservation { + option (google.api.resource) = { + type: "bigqueryreservation.googleapis.com/BiReservation" + pattern: "projects/{project}/locations/{location}/bireservation" + }; + + // The resource name of the singleton BI reservation. + // Reservation names have the form + // `projects/{project_id}/locations/{location_id}/bireservation`. + string name = 1; + + // Output only. The last update timestamp of a reservation. + google.protobuf.Timestamp update_time = 3 + [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Size of a reservation, in bytes. + int64 size = 4; +} + +// A request to get a singleton BI reservation. +message GetBiReservationRequest { + // Required. Name of the requested reservation, for example: + // `projects/{project_id}/locations/{location_id}/bireservation` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigqueryreservation.googleapis.com/BiReservation" + } + ]; +} + +// A request to update a BI reservation. +message UpdateBiReservationRequest { + // A reservation to update. + BiReservation bi_reservation = 1; + + // A list of fields to be updated in this request. + google.protobuf.FieldMask update_mask = 2; +} diff --git a/third_party/googleapis/google/cloud/bigquery/storage/BUILD.bazel b/third_party/googleapis/google/cloud/bigquery/storage/BUILD.bazel index 1e5b8c2af..a87c57fec 100644 --- a/third_party/googleapis/google/cloud/bigquery/storage/BUILD.bazel +++ b/third_party/googleapis/google/cloud/bigquery/storage/BUILD.bazel @@ -1 +1 @@ -exports_files(glob(["*.yaml"])) \ No newline at end of file +exports_files(glob(["*.yaml"])) diff --git a/third_party/googleapis/google/cloud/bigquery/storage/artman_bigquerystorage_v1.yaml b/third_party/googleapis/google/cloud/bigquery/storage/artman_bigquerystorage_v1.yaml new file mode 100644 index 000000000..a631db85f --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/artman_bigquerystorage_v1.yaml @@ -0,0 +1,20 @@ +common: + api_name: bigquerystorage + api_version: v1 + organization_name: google-cloud + proto_deps: + - name: google-common-protos + src_proto_paths: + - v1 + service_yaml: v1/bigquerystorage_v1.yaml + gapic_yaml: v1/bigquerystorage_gapic.yaml + proto_package: google.cloud.bigquery.storage.v1 +artifacts: +- name: gapic_config + type: GAPIC_CONFIG +- name: python_gapic + type: GAPIC + language: PYTHON +- name: php_gapic + type: GAPIC + language: PHP diff --git a/third_party/googleapis/google/cloud/bigquery/storage/artman_bigquerystorage_v1alpha2.yaml b/third_party/googleapis/google/cloud/bigquery/storage/artman_bigquerystorage_v1alpha2.yaml new file mode 100644 index 000000000..135151444 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/artman_bigquerystorage_v1alpha2.yaml @@ -0,0 +1,17 @@ +common: + api_name: bigquerystorage + api_version: v1alpha2 + organization_name: google-cloud + proto_deps: + - name: google-common-protos + src_proto_paths: + - v1alpha2 + service_yaml: v1alpha2/bigquerystorage_v1alpha2.yaml + gapic_yaml: v1alpha2/bigquerystorage_gapic.yaml + proto_package: google.cloud.bigquery.storage.v1alpha2 +artifacts: +- name: gapic_config + type: GAPIC_CONFIG +- name: python_gapic + type: GAPIC + language: PYTHON diff --git a/third_party/googleapis/google/cloud/bigquery/storage/artman_bigquerystorage_v1beta1.yaml b/third_party/googleapis/google/cloud/bigquery/storage/artman_bigquerystorage_v1beta1.yaml index 49e837efd..ac737345c 100644 --- a/third_party/googleapis/google/cloud/bigquery/storage/artman_bigquerystorage_v1beta1.yaml +++ b/third_party/googleapis/google/cloud/bigquery/storage/artman_bigquerystorage_v1beta1.yaml @@ -3,32 +3,15 @@ common: api_version: v1beta1 organization_name: google-cloud proto_deps: - - name: google-common-protos + - name: google-common-protos src_proto_paths: - v1beta1 - service_yaml: storage_v1beta1.yaml + service_yaml: v1beta1/bigquerystorage_v1beta1.yaml gapic_yaml: v1beta1/bigquerystorage_gapic.yaml + proto_package: google.cloud.bigquery.storage.v1beta1 artifacts: - name: gapic_config type: GAPIC_CONFIG -- name: java_gapic - type: GAPIC - language: JAVA - name: python_gapic type: GAPIC language: PYTHON -- name: nodejs_gapic - type: GAPIC - language: NODEJS -- name: php_gapic - type: GAPIC - language: PHP -- name: go_gapic - type: GAPIC - language: GO -- name: ruby_gapic - type: GAPIC - language: RUBY -- name: csharp_gapic - type: GAPIC - language: CSHARP diff --git a/third_party/googleapis/google/cloud/bigquery/storage/artman_bigquerystorage_v1beta2.yaml b/third_party/googleapis/google/cloud/bigquery/storage/artman_bigquerystorage_v1beta2.yaml new file mode 100644 index 000000000..28d109c29 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/artman_bigquerystorage_v1beta2.yaml @@ -0,0 +1,17 @@ +common: + api_name: bigquerystorage + api_version: v1beta2 + organization_name: google-cloud + proto_deps: + - name: google-common-protos + src_proto_paths: + - v1beta2 + service_yaml: v1beta2/bigquerystorage_v1beta2.yaml + gapic_yaml: v1beta2/bigquerystorage_gapic.yaml + proto_package: google.cloud.bigquery.storage.v1beta2 +artifacts: +- name: gapic_config + type: GAPIC_CONFIG +- name: python_gapic + type: GAPIC + language: PYTHON diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1/BUILD.bazel b/third_party/googleapis/google/cloud/bigquery/storage/v1/BUILD.bazel new file mode 100644 index 000000000..0e97194ea --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1/BUILD.bazel @@ -0,0 +1,377 @@ +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") +load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") + +proto_library( + name = "storage_proto", + srcs = [ + "arrow.proto", + "avro.proto", + "storage.proto", + "stream.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +proto_library_with_info( + name = "storage_proto_with_info", + deps = [ + ":storage_proto", + "//google/cloud:common_resources_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", + "java_proto_library", +) + +java_proto_library( + name = "storage_java_proto", + deps = [":storage_proto"], +) + +java_grpc_library( + name = "storage_java_grpc", + srcs = [":storage_proto"], + deps = [":storage_java_proto"], +) + +java_gapic_library( + name = "storage_java_gapic", + src = ":storage_proto_with_info", + gapic_yaml = "bigquerystorage_gapic.yaml", + package = "google.cloud.bigquery.storage.v1", + service_yaml = "bigquerystorage_v1.yaml", + test_deps = [ + ":storage_java_grpc", + ], + deps = [ + ":storage_java_proto", + ], +) + +java_gapic_test( + name = "storage_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.bigquery.storage.v1.BaseBigQueryReadClientTest", + ], + runtime_deps = [":storage_java_gapic_test"], +) + +# Open Source Packages +java_gapic_assembly_gradle_pkg( + name = "google-cloud-bigquery-storage-v1-java", + deps = [ + ":storage_java_gapic", + ":storage_java_grpc", + ":storage_java_proto", + ":storage_proto", + ], +) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", + "go_proto_library", + "go_test", +) + +go_proto_library( + name = "storage_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/cloud/bigquery/storage/v1", + protos = [":storage_proto"], + deps = [ + "//google/api:annotations_go_proto", + ], +) + +go_gapic_library( + name = "storage_go_gapic", + srcs = [":storage_proto_with_info"], + grpc_service_config = "bigquerystorage_grpc_service_config.json", + importpath = "cloud.google.com/go/bigquery/storage/apiv1;storage", + service_yaml = "bigquerystorage_v1.yaml", + deps = [ + ":storage_go_proto", + ], +) + +go_test( + name = "storage_go_gapic_test", + srcs = [":storage_go_gapic_srcjar_test"], + embed = [":storage_go_gapic"], + importpath = "cloud.google.com/go/bigquery/storage/apiv1", +) + +# Open Source Packages +go_gapic_assembly_pkg( + name = "gapi-cloud-bigquery-storage-v1-go", + deps = [ + ":storage_go_gapic", + ":storage_go_gapic_srcjar-test.srcjar", + ":storage_go_proto", + ], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "storage_moved_proto", + srcs = [":storage_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +py_proto_library( + name = "storage_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":storage_moved_proto"], +) + +py_grpc_library( + name = "storage_py_grpc", + srcs = [":storage_moved_proto"], + deps = [":storage_py_proto"], +) + +py_gapic_library( + name = "storage_py_gapic", + src = ":storage_proto_with_info", + gapic_yaml = "bigquerystorage_gapic.yaml", + package = "google.cloud.bigquery.storage.v1", + service_yaml = "bigquerystorage_v1.yaml", + deps = [ + ":storage_py_grpc", + ":storage_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "bigquery-storage-v1-py", + deps = [ + ":storage_py_gapic", + ":storage_py_grpc", + ":storage_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "storage_php_proto", + deps = [":storage_proto"], +) + +php_grpc_library( + name = "storage_php_grpc", + srcs = [":storage_proto"], + deps = [":storage_php_proto"], +) + +php_gapic_library( + name = "storage_php_gapic", + src = ":storage_proto_with_info", + gapic_yaml = "bigquerystorage_gapic.yaml", + package = "google.cloud.bigquery.storage.v1", + service_yaml = "bigquerystorage_v1.yaml", + deps = [ + ":storage_php_grpc", + ":storage_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-bigquery-storage-v1-php", + deps = [ + ":storage_php_gapic", + ":storage_php_grpc", + ":storage_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "storage_nodejs_gapic", + src = ":storage_proto_with_info", + gapic_yaml = "bigquerystorage_gapic.yaml", + package = "google.cloud.bigquery.storage.v1", + service_yaml = "bigquerystorage_v1.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "bigquery-storage-v1-nodejs", + deps = [ + ":storage_nodejs_gapic", + ":storage_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "storage_ruby_proto", + deps = [":storage_proto"], +) + +ruby_grpc_library( + name = "storage_ruby_grpc", + srcs = [":storage_proto"], + deps = [":storage_ruby_proto"], +) + +ruby_gapic_library( + name = "storage_ruby_gapic", + src = ":storage_proto_with_info", + gapic_yaml = "bigquerystorage_gapic.yaml", + package = "google.cloud.bigquery.storage.v1", + service_yaml = "bigquerystorage_v1.yaml", + deps = [ + ":storage_ruby_grpc", + ":storage_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-bigquery-storage-v1-ruby", + deps = [ + ":storage_ruby_gapic", + ":storage_ruby_grpc", + ":storage_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "storage_csharp_proto", + deps = [":storage_proto"], +) + +csharp_grpc_library( + name = "storage_csharp_grpc", + srcs = [":storage_proto"], + deps = [":storage_csharp_proto"], +) + +csharp_gapic_library( + name = "storage_csharp_gapic", + src = ":storage_proto_with_info", + gapic_yaml = "bigquerystorage_gapic.yaml", + package = "google.cloud.bigquery.storage.v1", + service_yaml = "bigquerystorage_v1.yaml", + deps = [ + ":storage_csharp_grpc", + ":storage_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-bigquery-storage-v1-csharp", + deps = [ + ":storage_csharp_gapic", + ":storage_csharp_grpc", + ":storage_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "cc_grpc_library", + "cc_proto_library", +) + +cc_proto_library( + name = "storage_cc_proto", + deps = [":storage_proto"], +) + +cc_grpc_library( + name = "storage_cc_grpc", + srcs = [":storage_proto"], + generate_mocks = True, + grpc_only = True, + deps = [":storage_cc_proto"], +) diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1/arrow.proto b/third_party/googleapis/google/cloud/bigquery/storage/v1/arrow.proto new file mode 100644 index 000000000..1c54eeab0 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1/arrow.proto @@ -0,0 +1,45 @@ +// Copyright 2019 Google LLC. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// + +syntax = "proto3"; + +package google.cloud.bigquery.storage.v1; + +option csharp_namespace = "Google.Cloud.BigQuery.Storage.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/storage/v1;storage"; +option java_multiple_files = true; +option java_outer_classname = "ArrowProto"; +option java_package = "com.google.cloud.bigquery.storage.v1"; +option php_namespace = "Google\\Cloud\\BigQuery\\Storage\\V1"; + +// Arrow schema as specified in +// https://arrow.apache.org/docs/python/api/datatypes.html +// and serialized to bytes using IPC: +// https://arrow.apache.org/docs/format/Columnar.html#serialization-and-interprocess-communication-ipc +// +// See code samples on how this message can be deserialized. +message ArrowSchema { + // IPC serialized Arrow schema. + bytes serialized_schema = 1; +} + +// Arrow RecordBatch. +message ArrowRecordBatch { + // IPC-serialized Arrow RecordBatch. + bytes serialized_record_batch = 1; + + // The count of rows in `serialized_record_batch`. + int64 row_count = 2; +} diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1/avro.proto b/third_party/googleapis/google/cloud/bigquery/storage/v1/avro.proto new file mode 100644 index 000000000..9a064447b --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1/avro.proto @@ -0,0 +1,41 @@ +// Copyright 2019 Google LLC. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// + +syntax = "proto3"; + +package google.cloud.bigquery.storage.v1; + +option csharp_namespace = "Google.Cloud.BigQuery.Storage.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/storage/v1;storage"; +option java_multiple_files = true; +option java_outer_classname = "AvroProto"; +option java_package = "com.google.cloud.bigquery.storage.v1"; +option php_namespace = "Google\\Cloud\\BigQuery\\Storage\\V1"; + +// Avro schema. +message AvroSchema { + // Json serialized schema, as described at + // https://avro.apache.org/docs/1.8.1/spec.html. + string schema = 1; +} + +// Avro rows. +message AvroRows { + // Binary serialized rows in a block. + bytes serialized_binary_rows = 1; + + // The count of rows in the returning block. + int64 row_count = 2; +} diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1/bigquerystorage_gapic.legacy.yaml b/third_party/googleapis/google/cloud/bigquery/storage/v1/bigquerystorage_gapic.legacy.yaml new file mode 100644 index 000000000..3f7d04aa3 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1/bigquerystorage_gapic.legacy.yaml @@ -0,0 +1,84 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 1.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.bigquery.storage.v1 + interface_names: + google.cloud.bigquery.storage.v1.BigQueryRead: BaseBigQueryRead + python: + package_name: google.cloud.bigquery_storage_v1.gapic + go: + package_name: cloud.google.com/go/bigquery/storage/apiv1 + csharp: + package_name: Google.Cloud.BigQuery.Storage.V1 + ruby: + package_name: Google::Cloud::Bigquery::Storage::V1 + php: + package_name: Google\Cloud\BigQuery\Storage\V1 + nodejs: + package_name: storage.v1 +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.cloud.bigquery.storage.v1.BigQueryRead + collections: [] + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - DEADLINE_EXCEEDED + - UNAVAILABLE + - name: unary_streaming + retry_codes: + - UNAVAILABLE + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + - name: create_read_session + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 120000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 120000 + total_timeout_millis: 600000 + - name: read_rows + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 86400000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 86400000 + total_timeout_millis: 86400000 + methods: + - name: CreateReadSession + flattening: + groups: + - parameters: + - parent + - read_session + - max_stream_count + retry_codes_name: idempotent + retry_params_name: create_read_session + timeout_millis: 60000 + - name: ReadRows + flattening: + groups: + - parameters: + - read_stream + - offset + retry_codes_name: unary_streaming + retry_params_name: read_rows + timeout_millis: 86400000 + - name: SplitReadStream + retry_codes_name: idempotent + retry_params_name: default + timeout_millis: 60000 diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1/bigquerystorage_gapic.yaml b/third_party/googleapis/google/cloud/bigquery/storage/v1/bigquerystorage_gapic.yaml new file mode 100644 index 000000000..9162b1677 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1/bigquerystorage_gapic.yaml @@ -0,0 +1,70 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 2.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.bigquery.storage.v1 + interface_names: + google.cloud.bigquery.storage.v1.BigQueryRead: BaseBigQueryRead + python: + package_name: google.cloud.bigquery_storage_v1.gapic + go: + package_name: cloud.google.com/go/bigquery/storage/apiv1 + csharp: + package_name: Google.Cloud.BigQuery.Storage.V1 + ruby: + package_name: Google::Cloud::Bigquery::Storage::V1 + php: + package_name: Google\Cloud\BigQuery\Storage\V1 + nodejs: + package_name: storage.v1 +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.cloud.bigquery.storage.v1.BigQueryRead + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - DEADLINE_EXCEEDED + - UNAVAILABLE + - name: unary_streaming + retry_codes: + - UNAVAILABLE + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + - name: create_read_session + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 120000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 120000 + total_timeout_millis: 600000 + - name: read_rows + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 86400000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 86400000 + total_timeout_millis: 86400000 + methods: + - name: CreateReadSession + retry_codes_name: idempotent + retry_params_name: create_read_session + - name: ReadRows + retry_codes_name: unary_streaming + retry_params_name: read_rows + timeout_millis: 86400000 + - name: SplitReadStream + retry_codes_name: idempotent + retry_params_name: default diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1/bigquerystorage_grpc_service_config.json b/third_party/googleapis/google/cloud/bigquery/storage/v1/bigquerystorage_grpc_service_config.json new file mode 100644 index 000000000..2efc373b1 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1/bigquerystorage_grpc_service_config.json @@ -0,0 +1,57 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.bigquery.storage.v1.BigQueryRead", + "method": "CreateReadSession" + } + ], + "timeout": "600s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.bigquery.storage.v1.BigQueryRead", + "method": "ReadRows" + } + ], + "timeout": "86400s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.bigquery.storage.v1.BigQueryRead", + "method": "SplitReadStream" + } + ], + "timeout": "600s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1/bigquerystorage_v1.yaml b/third_party/googleapis/google/cloud/bigquery/storage/v1/bigquerystorage_v1.yaml new file mode 100644 index 000000000..f671c4a51 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1/bigquerystorage_v1.yaml @@ -0,0 +1,25 @@ +type: google.api.Service +config_version: 3 +name: bigquerystorage.googleapis.com +title: BigQuery Storage API + +apis: +- name: google.cloud.bigquery.storage.v1.BigQueryRead + +backend: + rules: + - selector: google.cloud.bigquery.storage.v1.BigQueryRead.CreateReadSession + deadline: 120.0 + - selector: google.cloud.bigquery.storage.v1.BigQueryRead.ReadRows + deadline: 21600.0 + - selector: google.cloud.bigquery.storage.v1.BigQueryRead.SplitReadStream + deadline: 120.0 + +authentication: + rules: + - selector: 'google.cloud.bigquery.storage.v1.BigQueryRead.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/bigquery, + https://www.googleapis.com/auth/bigquery.readonly, + https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1/storage.proto b/third_party/googleapis/google/cloud/bigquery/storage/v1/storage.proto new file mode 100644 index 000000000..26fcd6ac2 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1/storage.proto @@ -0,0 +1,236 @@ +// Copyright 2019 Google LLC. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// + +syntax = "proto3"; + +package google.cloud.bigquery.storage.v1; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/cloud/bigquery/storage/v1/arrow.proto"; +import "google/cloud/bigquery/storage/v1/avro.proto"; +import "google/cloud/bigquery/storage/v1/stream.proto"; + +option csharp_namespace = "Google.Cloud.BigQuery.Storage.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/storage/v1;storage"; +option java_multiple_files = true; +option java_outer_classname = "StorageProto"; +option java_package = "com.google.cloud.bigquery.storage.v1"; +option php_namespace = "Google\\Cloud\\BigQuery\\Storage\\V1"; +option (google.api.resource_definition) = { + type: "bigquery.googleapis.com/Table" + pattern: "projects/{project}/datasets/{dataset}/tables/{table}" +}; + +// BigQuery Read API. +// +// The Read API can be used to read data from BigQuery. +service BigQueryRead { + option (google.api.default_host) = "bigquerystorage.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/bigquery," + "https://www.googleapis.com/auth/bigquery.readonly," + "https://www.googleapis.com/auth/cloud-platform"; + + // Creates a new read session. A read session divides the contents of a + // BigQuery table into one or more streams, which can then be used to read + // data from the table. The read session also specifies properties of the + // data to be read, such as a list of columns or a push-down filter describing + // the rows to be returned. + // + // A particular row can be read by at most one stream. When the caller has + // reached the end of each stream in the session, then all the data in the + // table has been read. + // + // Data is assigned to each stream such that roughly the same number of + // rows can be read from each stream. Because the server-side unit for + // assigning data is collections of rows, the API does not guarantee that + // each stream will return the same number or rows. Additionally, the + // limits are enforced based on the number of pre-filtered rows, so some + // filters can lead to lopsided assignments. + // + // Read sessions automatically expire 24 hours after they are created and do + // not require manual clean-up by the caller. + rpc CreateReadSession(CreateReadSessionRequest) returns (ReadSession) { + option (google.api.http) = { + post: "/v1/{read_session.table=projects/*/datasets/*/tables/*}" + body: "*" + }; + option (google.api.method_signature) = "parent,read_session,max_stream_count"; + } + + // Reads rows from the stream in the format prescribed by the ReadSession. + // Each response contains one or more table rows, up to a maximum of 100 MiB + // per response; read requests which attempt to read individual rows larger + // than 100 MiB will fail. + // + // Each request also returns a set of stream statistics reflecting the current + // state of the stream. + rpc ReadRows(ReadRowsRequest) returns (stream ReadRowsResponse) { + option (google.api.http) = { + get: "/v1/{read_stream=projects/*/locations/*/sessions/*/streams/*}" + }; + option (google.api.method_signature) = "read_stream,offset"; + } + + // Splits a given `ReadStream` into two `ReadStream` objects. These + // `ReadStream` objects are referred to as the primary and the residual + // streams of the split. The original `ReadStream` can still be read from in + // the same manner as before. Both of the returned `ReadStream` objects can + // also be read from, and the rows returned by both child streams will be + // the same as the rows read from the original stream. + // + // Moreover, the two child streams will be allocated back-to-back in the + // original `ReadStream`. Concretely, it is guaranteed that for streams + // original, primary, and residual, that original[0-j] = primary[0-j] and + // original[j-n] = residual[0-m] once the streams have been read to + // completion. + rpc SplitReadStream(SplitReadStreamRequest) returns (SplitReadStreamResponse) { + option (google.api.http) = { + get: "/v1/{name=projects/*/locations/*/sessions/*/streams/*}" + }; + } +} + +// Request message for `CreateReadSession`. +message CreateReadSessionRequest { + // Required. The request project that owns the session, in the form of + // `projects/{project_id}`. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudresourcemanager.googleapis.com/Project" + } + ]; + + // Required. Session to be created. + ReadSession read_session = 2 [(google.api.field_behavior) = REQUIRED]; + + // Max initial number of streams. If unset or zero, the server will + // provide a value of streams so as to produce reasonable throughput. Must be + // non-negative. The number of streams may be lower than the requested number, + // depending on the amount parallelism that is reasonable for the table. Error + // will be returned if the max count is greater than the current system + // max limit of 1,000. + // + // Streams must be read starting from offset 0. + int32 max_stream_count = 3; +} + +// Request message for `ReadRows`. +message ReadRowsRequest { + // Required. Stream to read rows from. + string read_stream = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigquerystorage.googleapis.com/ReadStream" + } + ]; + + // The offset requested must be less than the last row read from Read. + // Requesting a larger offset is undefined. If not specified, start reading + // from offset zero. + int64 offset = 2; +} + +// Information on if the current connection is being throttled. +message ThrottleState { + // How much this connection is being throttled. Zero means no throttling, + // 100 means fully throttled. + int32 throttle_percent = 1; +} + +// Estimated stream statistics for a given Stream. +message StreamStats { + message Progress { + // The fraction of rows assigned to the stream that have been processed by + // the server so far, not including the rows in the current response + // message. + // + // This value, along with `at_response_end`, can be used to interpolate + // the progress made as the rows in the message are being processed using + // the following formula: `at_response_start + (at_response_end - + // at_response_start) * rows_processed_from_response / rows_in_response`. + // + // Note that if a filter is provided, the `at_response_end` value of the + // previous response may not necessarily be equal to the + // `at_response_start` value of the current response. + double at_response_start = 1; + + // Similar to `at_response_start`, except that this value includes the + // rows in the current response. + double at_response_end = 2; + } + + // Represents the progress of the current stream. + Progress progress = 2; +} + +// Response from calling `ReadRows` may include row data, progress and +// throttling information. +message ReadRowsResponse { + // Row data is returned in format specified during session creation. + oneof rows { + // Serialized row data in AVRO format. + AvroRows avro_rows = 3; + + // Serialized row data in Arrow RecordBatch format. + ArrowRecordBatch arrow_record_batch = 4; + } + + // Number of serialized rows in the rows block. + int64 row_count = 6; + + // Statistics for the stream. + StreamStats stats = 2; + + // Throttling state. If unset, the latest response still describes + // the current throttling status. + ThrottleState throttle_state = 5; +} + +// Request message for `SplitReadStream`. +message SplitReadStreamRequest { + // Required. Name of the stream to split. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigquerystorage.googleapis.com/ReadStream" + } + ]; + + // A value in the range (0.0, 1.0) that specifies the fractional point at + // which the original stream should be split. The actual split point is + // evaluated on pre-filtered rows, so if a filter is provided, then there is + // no guarantee that the division of the rows between the new child streams + // will be proportional to this fractional value. Additionally, because the + // server-side unit for assigning data is collections of rows, this fraction + // will always map to a data storage boundary on the server side. + double fraction = 2; +} + +// Response message for `SplitReadStream`. +message SplitReadStreamResponse { + // Primary stream, which contains the beginning portion of + // |original_stream|. An empty value indicates that the original stream can no + // longer be split. + ReadStream primary_stream = 1; + + // Remainder stream, which contains the tail of |original_stream|. An empty + // value indicates that the original stream can no longer be split. + ReadStream remainder_stream = 2; +} diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1/stream.proto b/third_party/googleapis/google/cloud/bigquery/storage/v1/stream.proto new file mode 100644 index 000000000..febad0367 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1/stream.proto @@ -0,0 +1,137 @@ +// Copyright 2019 Google LLC. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// + +syntax = "proto3"; + +package google.cloud.bigquery.storage.v1; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/cloud/bigquery/storage/v1/arrow.proto"; +import "google/cloud/bigquery/storage/v1/avro.proto"; +import "google/protobuf/timestamp.proto"; + +option csharp_namespace = "Google.Cloud.BigQuery.Storage.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/storage/v1;storage"; +option java_multiple_files = true; +option java_outer_classname = "StreamProto"; +option java_package = "com.google.cloud.bigquery.storage.v1"; +option php_namespace = "Google\\Cloud\\BigQuery\\Storage\\V1"; + +// Data format for input or output data. +enum DataFormat { + DATA_FORMAT_UNSPECIFIED = 0; + + // Avro is a standard open source row based file format. + // See https://avro.apache.org/ for more details. + AVRO = 1; + + // Arrow is a standard open source column-based message format. + // See https://arrow.apache.org/ for more details. + ARROW = 2; +} + +// Information about the ReadSession. +message ReadSession { + option (google.api.resource) = { + type: "bigquerystorage.googleapis.com/ReadSession" + pattern: "projects/{project}/locations/{location}/sessions/{session}" + }; + + // Additional attributes when reading a table. + message TableModifiers { + // The snapshot time of the table. If not set, interpreted as now. + google.protobuf.Timestamp snapshot_time = 1; + } + + // Options dictating how we read a table. + message TableReadOptions { + // Names of the fields in the table that should be read. If empty, all + // fields will be read. If the specified field is a nested field, all + // the sub-fields in the field will be selected. The output field order is + // unrelated to the order of fields in selected_fields. + repeated string selected_fields = 1; + + // SQL text filtering statement, similar to a WHERE clause in a query. + // Aggregates are not supported. + // + // Examples: "int_field > 5" + // "date_field = CAST('2014-9-27' as DATE)" + // "nullable_field is not NULL" + // "st_equals(geo_field, st_geofromtext("POINT(2, 2)"))" + // "numeric_field BETWEEN 1.0 AND 5.0" + string row_restriction = 2; + } + + // Output only. Unique identifier for the session, in the form + // `projects/{project_id}/locations/{location}/sessions/{session_id}`. + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Time at which the session becomes invalid. After this time, subsequent + // requests to read this Session will return errors. The expire_time is + // automatically assigned and currently cannot be specified or updated. + google.protobuf.Timestamp expire_time = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. Data format of the output data. + DataFormat data_format = 3 [(google.api.field_behavior) = IMMUTABLE]; + + // The schema for the read. If read_options.selected_fields is set, the + // schema may be different from the table schema as it will only contain + // the selected fields. + oneof schema { + // Output only. Avro schema. + AvroSchema avro_schema = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Arrow schema. + ArrowSchema arrow_schema = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // Immutable. Table that this ReadSession is reading from, in the form + // `projects/{project_id}/datasets/{dataset_id}/tables/{table_id}` + string table = 6 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "bigquery.googleapis.com/Table" + } + ]; + + // Optional. Any modifiers which are applied when reading from the specified table. + TableModifiers table_modifiers = 7 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Read options for this session (e.g. column selection, filters). + TableReadOptions read_options = 8 [(google.api.field_behavior) = OPTIONAL]; + + // Output only. A list of streams created with the session. + // + // At least one stream is created with the session. In the future, larger + // request_stream_count values *may* result in this list being unpopulated, + // in that case, the user will need to use a List method to get the streams + // instead, which is not yet available. + repeated ReadStream streams = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// Information about a single stream that gets data out of the storage system. +// Most of the information about `ReadStream` instances is aggregated, making +// `ReadStream` lightweight. +message ReadStream { + option (google.api.resource) = { + type: "bigquerystorage.googleapis.com/ReadStream" + pattern: "projects/{project}/locations/{location}/sessions/{session}/streams/{stream}" + }; + + // Output only. Name of the stream, in the form + // `projects/{project_id}/locations/{location}/sessions/{session_id}/streams/{stream_id}`. + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/BUILD.bazel b/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/BUILD.bazel new file mode 100644 index 000000000..2789b99ea --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/BUILD.bazel @@ -0,0 +1,371 @@ +# This file was automatically generated by BuildFileGenerator + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") +load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") + +proto_library( + name = "storage_proto", + srcs = [ + "protobuf.proto", + "storage.proto", + "stream.proto", + "table.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/rpc:status_proto", + "//google/api:resource_proto", + "@com_google_protobuf//:descriptor_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:timestamp_proto", + "@com_google_protobuf//:wrappers_proto", + ], +) + +proto_library_with_info( + name = "storage_proto_with_info", + deps = [ + ":storage_proto", + "//google/cloud:common_resources_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", + "java_proto_library", +) + +java_proto_library( + name = "storage_java_proto", + deps = [":storage_proto"], +) + +java_grpc_library( + name = "storage_java_grpc", + srcs = [":storage_proto"], + deps = [":storage_java_proto"], +) + +java_gapic_library( + name = "storage_java_gapic", + src = ":storage_proto_with_info", + gapic_yaml = "bigquerystorage_gapic.yaml", + package = "google.cloud.bigquery.storage.v1alpha2", + service_yaml = "bigquerystorage_v1alpha2.yaml", + test_deps = [ + ":storage_java_grpc", + ], + deps = [ + ":storage_java_proto", + ], +) + +java_gapic_test( + name = "storage_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.bigquery.storage.v1alpha2.BigQueryWriteClientTest", + ], + runtime_deps = [":storage_java_gapic_test"], +) + +# Open Source Packages +java_gapic_assembly_gradle_pkg( + name = "google-cloud-bigquery-storage-v1alpha2-java", + deps = [ + ":storage_java_gapic", + ":storage_java_grpc", + ":storage_java_proto", + ":storage_proto", + ], +) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", + "go_proto_library", + "go_test", +) + +go_proto_library( + name = "storage_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/cloud/bigquery/storage/v1alpha2", + protos = [":storage_proto"], + deps = [ + "//google/api:annotations_go_proto", + "//google/rpc:status_go_proto", + ], +) + +go_gapic_library( + name = "storage_go_gapic", + srcs = [":storage_proto_with_info"], + grpc_service_config = "bigquerystorage_grpc_service_config.json", + importpath = "cloud.google.com/go/bigquery/storage/apiv1alpha2;storage", + service_yaml = "bigquerystorage_v1alpha2.yaml", + deps = [ + ":storage_go_proto", + ], +) + +go_test( + name = "storage_go_gapic_test", + srcs = [":storage_go_gapic_srcjar_test"], + embed = [":storage_go_gapic"], + importpath = "cloud.google.com/go/bigquery/storage/apiv1alpha2", +) + +# Open Source Packages +go_gapic_assembly_pkg( + name = "gapi-cloud-bigquery-storage-v1alpha2-go", + deps = [ + ":storage_go_gapic", + ":storage_go_gapic_srcjar-test.srcjar", + ":storage_go_proto", + ], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "storage_moved_proto", + srcs = [":storage_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/rpc:status_proto", + "//google/api:resource_proto", + "@com_google_protobuf//:descriptor_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:timestamp_proto", + "@com_google_protobuf//:wrappers_proto", + ], +) + +py_proto_library( + name = "storage_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":storage_moved_proto"], +) + +py_grpc_library( + name = "storage_py_grpc", + srcs = [":storage_moved_proto"], + deps = [":storage_py_proto"], +) + +py_gapic_library( + name = "storage_py_gapic", + src = ":storage_proto_with_info", + gapic_yaml = "bigquerystorage_gapic.yaml", + package = "google.cloud.bigquery.storage.v1alpha2", + service_yaml = "bigquerystorage_v1alpha2.yaml", + deps = [ + ":storage_py_grpc", + ":storage_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "bigquery-storage-v1alpha2-py", + deps = [ + ":storage_py_gapic", + ":storage_py_grpc", + ":storage_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "storage_php_proto", + deps = [":storage_proto"], +) + +php_grpc_library( + name = "storage_php_grpc", + srcs = [":storage_proto"], + deps = [":storage_php_proto"], +) + +php_gapic_library( + name = "storage_php_gapic", + src = ":storage_proto_with_info", + gapic_yaml = "bigquerystorage_gapic.yaml", + package = "google.cloud.bigquery.storage.v1alpha2", + service_yaml = "bigquerystorage_v1alpha2.yaml", + deps = [ + ":storage_php_grpc", + ":storage_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-bigquery-storage-v1alpha2-php", + deps = [ + ":storage_php_gapic", + ":storage_php_grpc", + ":storage_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "storage_nodejs_gapic", + src = ":storage_proto_with_info", + gapic_yaml = "bigquerystorage_gapic.yaml", + package = "google.cloud.bigquery.storage.v1alpha2", + service_yaml = "bigquerystorage_v1alpha2.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "bigquery-storage-v1alpha2-nodejs", + deps = [ + ":storage_nodejs_gapic", + ":storage_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +# Enable once proto2 dependency is eliminated. +#load( +# "@com_google_googleapis_imports//:imports.bzl", +# "ruby_gapic_assembly_pkg", +# "ruby_gapic_library", +# "ruby_grpc_library", +# "ruby_proto_library", +#) +# +#ruby_proto_library( +# name = "storage_ruby_proto", +# deps = [":storage_proto"], +#) +# +#ruby_grpc_library( +# name = "storage_ruby_grpc", +# srcs = [":storage_proto"], +# deps = [":storage_ruby_proto"], +#) +# +#ruby_gapic_library( +# name = "storage_ruby_gapic", +# src = ":storage_proto_with_info", +# gapic_yaml = "bigquerystorage_gapic.yaml", +# package = "google.cloud.bigquery.storage.v1alpha2", +# service_yaml = "bigquerystorage_v1alpha2.yaml", +# deps = [ +# ":storage_ruby_grpc", +# ":storage_ruby_proto", +# ], +#) +# +## Open Source Packages +#ruby_gapic_assembly_pkg( +# name = "google-cloud-bigquery-storage-v1alpha2-ruby", +# deps = [ +# ":storage_ruby_gapic", +# ":storage_ruby_grpc", +# ":storage_ruby_proto", +# ], +#) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "storage_csharp_proto", + deps = [":storage_proto"], +) + +csharp_grpc_library( + name = "storage_csharp_grpc", + srcs = [":storage_proto"], + deps = [":storage_csharp_proto"], +) + +csharp_gapic_library( + name = "storage_csharp_gapic", + src = ":storage_proto_with_info", + gapic_yaml = "bigquerystorage_gapic.yaml", + package = "google.cloud.bigquery.storage.v1alpha2", + service_yaml = "bigquerystorage_v1alpha2.yaml", + deps = [ + ":storage_csharp_grpc", + ":storage_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-bigquery-storage-v1alpha2-csharp", + deps = [ + ":storage_csharp_gapic", + ":storage_csharp_grpc", + ":storage_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/bigquerystorage_gapic.legacy.yaml b/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/bigquerystorage_gapic.legacy.yaml new file mode 100644 index 000000000..39cd0a76b --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/bigquerystorage_gapic.legacy.yaml @@ -0,0 +1,18 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 1.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.bigquery.storage.v1alpha2 + python: + package_name: google.cloud.bigquery.storage_v1alpha2.gapic + go: + package_name: cloud.google.com/go/bigquery/storage/apiv1alpha2 + csharp: + package_name: Google.Cloud.Bigquery.Storage.V1alpha2 + ruby: + package_name: Google::Cloud::Bigquery::Storage::V1alpha2 + php: + package_name: Google\Cloud\Bigquery\Storage\V1alpha2 + nodejs: + package_name: storage.v1alpha2 diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/bigquerystorage_gapic.yaml b/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/bigquerystorage_gapic.yaml new file mode 100644 index 000000000..60b62f11c --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/bigquerystorage_gapic.yaml @@ -0,0 +1,18 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 2.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.bigquery.storage.v1alpha2 + python: + package_name: google.cloud.bigquery.storage_v1alpha2.gapic + go: + package_name: cloud.google.com/go/bigquery/storage/apiv1alpha2 + csharp: + package_name: Google.Cloud.Bigquery.Storage.V1alpha2 + ruby: + package_name: Google::Cloud::Bigquery::Storage::V1alpha2 + php: + package_name: Google\Cloud\Bigquery\Storage\V1alpha2 + nodejs: + package_name: storage.v1alpha2 diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/bigquerystorage_grpc_service_config.json b/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/bigquerystorage_grpc_service_config.json new file mode 100644 index 000000000..8fe6c1049 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/bigquerystorage_grpc_service_config.json @@ -0,0 +1,65 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.bigquery.storage.v1alpha2.BigQueryWrite", + "method": "CreateWriteStream" + } + ], + "timeout": "600s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.bigquery.storage.v1alpha2.BigQueryWrite", + "method": "AppendRows" + } + ], + "timeout": "86400s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.bigquery.storage.v1alpha2.BigQueryWrite", + "method": "BatchCommitWriteStreams" + }, + { + "service": "google.cloud.bigquery.storage.v1alpha2.BigQueryWrite", + "method": "FinalizeWriteStream" + }, + { + "service": "google.cloud.bigquery.storage.v1alpha2.BigQueryWrite", + "method": "GetWriteStream" + } + ], + "timeout": "600s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/bigquerystorage_v1alpha2.yaml b/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/bigquerystorage_v1alpha2.yaml new file mode 100644 index 000000000..af09ff19e --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/bigquerystorage_v1alpha2.yaml @@ -0,0 +1,16 @@ +type: google.api.Service +config_version: 3 +name: bigquerystorage.googleapis.com +title: BigQuery Storage API + +apis: +- name: google.cloud.bigquery.storage.v1alpha2.BigQueryWrite + +authentication: + rules: + - selector: 'google.cloud.bigquery.storage.v1alpha2.BigQueryWrite.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/bigquery, + https://www.googleapis.com/auth/bigquery.insertdata, + https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/protobuf.proto b/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/protobuf.proto new file mode 100644 index 000000000..882adf5b4 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/protobuf.proto @@ -0,0 +1,42 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.bigquery.storage.v1alpha2; + +import "google/protobuf/descriptor.proto"; + +option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/storage/v1alpha2;storage"; +option java_outer_classname = "ProtoBufProto"; +option java_package = "com.google.cloud.bigquery.storage.v1alpha2"; + +// Protobuf schema is an API presentation the proto buffer schema. +message ProtoSchema { + // Descriptor for input message. The descriptor has to be self contained, + // including all the nested types, excepted for proto buffer well known types + // (https://developers.google.com/protocol-buffers/docs/reference/google.protobuf) + // and zetasql public protos + // (https://github.com/google/zetasql/tree/master/zetasql/public/proto). + google.protobuf.DescriptorProto proto_descriptor = 1; +} + +// Protobuf rows. +message ProtoRows { + // A sequence of rows serialized as a Protocol Buffer. + // + // See https://developers.google.com/protocol-buffers/docs/overview for more + // information on deserializing this field. + repeated bytes serialized_rows = 1; +} diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/storage.proto b/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/storage.proto new file mode 100644 index 000000000..e9a893b99 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/storage.proto @@ -0,0 +1,256 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.bigquery.storage.v1alpha2; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/cloud/bigquery/storage/v1alpha2/protobuf.proto"; +import "google/cloud/bigquery/storage/v1alpha2/stream.proto"; +import "google/cloud/bigquery/storage/v1alpha2/table.proto"; +import "google/protobuf/empty.proto"; +import "google/protobuf/timestamp.proto"; +import "google/protobuf/wrappers.proto"; +import "google/rpc/status.proto"; + +option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/storage/v1alpha2;storage"; +option java_package = "com.google.cloud.bigquery.storage.v1alpha2"; + +// Request message for `CreateWriteStream`. +message CreateWriteStreamRequest { + // Required. Reference to the table to which the stream belongs, in the format + // of `projects/{project}/datasets/{dataset}/tables/{table}`. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigquerystorage.googleapis.com/Table" + } + ]; + + // Required. Stream to be created. + WriteStream write_stream = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// BigQuery Write API. +// +// The Write API can be used to write data to BigQuery. +service BigQueryWrite { + option (google.api.default_host) = "bigquerystorage.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/bigquery," + "https://www.googleapis.com/auth/bigquery.insertdata," + "https://www.googleapis.com/auth/cloud-platform"; + + // Creates a write stream to the given table. + rpc CreateWriteStream(CreateWriteStreamRequest) returns (WriteStream) { + option (google.api.http) = { + post: "/v1alpha2/{parent=projects/*/datasets/*/tables/*}" + body: "write_stream" + }; + option (google.api.method_signature) = "parent,write_stream"; + } + + // Appends data to the given stream. + // + // If `offset` is specified, the `offset` is checked against the end of + // stream. The server returns `OUT_OF_RANGE` in `AppendRowsResponse` if an + // attempt is made to append to an offset beyond the current end of the stream + // or `ALREADY_EXISTS` if user provids an `offset` that has already been + // written to. User can retry with adjusted offset within the same RPC + // stream. If `offset` is not specified, append happens at the end of the + // stream. + // + // The response contains the offset at which the append happened. Responses + // are received in the same order in which requests are sent. There will be + // one response for each successful request. If the `offset` is not set in + // response, it means append didn't happen due to some errors. If one request + // fails, all the subsequent requests will also fail until a success request + // is made again. + // + // If the stream is of `PENDING` type, data will only be available for read + // operations after the stream is committed. + rpc AppendRows(stream AppendRowsRequest) returns (stream AppendRowsResponse) { + option (google.api.http) = { + post: "/v1alpha2/{write_stream=projects/*/datasets/*/tables/*/streams/*}" + body: "*" + }; + option (google.api.method_signature) = "write_stream"; + } + + // Gets a write stream. + rpc GetWriteStream(GetWriteStreamRequest) returns (WriteStream) { + option (google.api.http) = { + post: "/v1alpha2/{name=projects/*/datasets/*/tables/*/streams/*}" + body: "*" + }; + option (google.api.method_signature) = "name"; + } + + // Finalize a write stream so that no new data can be appended to the + // stream. + rpc FinalizeWriteStream(FinalizeWriteStreamRequest) returns (FinalizeWriteStreamResponse) { + option (google.api.http) = { + post: "/v1alpha2/{name=projects/*/datasets/*/tables/*/streams/*}" + body: "*" + }; + option (google.api.method_signature) = "name"; + } + + // Atomically commits a group of `PENDING` streams that belong to the same + // `parent` table. + // Streams must be finalized before commit and cannot be committed multiple + // times. Once a stream is committed, data in the stream becomes available + // for read operations. + rpc BatchCommitWriteStreams(BatchCommitWriteStreamsRequest) returns (BatchCommitWriteStreamsResponse) { + option (google.api.http) = { + get: "/v1alpha2/{parent=projects/*/datasets/*/tables/*}" + }; + option (google.api.method_signature) = "parent"; + } + + // Flushes rows to a BUFFERED stream. + // If users are appending rows to BUFFERED stream, flush operation is + // required in order for the rows to become available for reading. A + // Flush operation flushes up to any previously flushed offset in a BUFFERED + // stream, to the offset specified in the request. + rpc FlushRows(FlushRowsRequest) returns (FlushRowsResponse) { + option (google.api.http) = { + post: "/v1alpha2/{write_stream=projects/*/datasets/*/tables/*/streams/*}" + body: "*" + }; + option (google.api.method_signature) = "write_stream"; + } +} + +// Request message for `AppendRows`. +message AppendRowsRequest { + message ProtoData { + // Proto schema used to serialize the data. + ProtoSchema writer_schema = 1; + + // Serialized row data in protobuf message format. + ProtoRows rows = 2; + } + + // Required. The stream that is the target of the append operation. This value must be + // specified for the initial request. If subsequent requests specify the + // stream name, it must equal to the value provided in the first request. + string write_stream = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigquerystorage.googleapis.com/WriteStream" + } + ]; + + // Optional. If present, the write is only performed if the next append offset is same + // as the provided value. If not present, the write is performed at the + // current end of stream. + google.protobuf.Int64Value offset = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Input rows. The `writer_schema` field must be specified at the initial + // request and currently, it will be ignored if specified in following + // requests. Following requests must have data in the same format as the + // initial request. + oneof rows { + ProtoData proto_rows = 4; + } +} + +// Response message for `AppendRows`. +message AppendRowsResponse { + oneof response { + // The row offset at which the last append occurred. + int64 offset = 1; + + // Error in case of append failure. If set, it means rows are not accepted + // into the system. Users can retry within the same connection. + google.rpc.Status error = 2; + } +} + +// Request message for `GetWriteStreamRequest`. +message GetWriteStreamRequest { + // Required. Name of the stream to get, in the form of + // `projects/{project}/datasets/{dataset}/tables/{table}/streams/{stream}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigquerystorage.googleapis.com/WriteStream" + } + ]; +} + +// Request message for `BatchCommitWriteStreams`. +message BatchCommitWriteStreamsRequest { + // Required. Parent table that all the streams should belong to, in the form of + // `projects/{project}/datasets/{dataset}/tables/{table}`. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigquerystorage.googleapis.com/Table" + } + ]; + + // Required. The group of streams that will be committed atomically. + repeated string write_streams = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// Response message for `BatchCommitWriteStreams`. +message BatchCommitWriteStreamsResponse { + // The time at which streams were committed in microseconds granularity. + google.protobuf.Timestamp commit_time = 1; +} + +// Request message for invoking `FinalizeWriteStream`. +message FinalizeWriteStreamRequest { + // Required. Name of the stream to finalize, in the form of + // `projects/{project}/datasets/{dataset}/tables/{table}/streams/{stream}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigquerystorage.googleapis.com/WriteStream" + } + ]; +} + +// Response message for `FinalizeWriteStream`. +message FinalizeWriteStreamResponse { + // Number of rows in the finalized stream. + int64 row_count = 1; +} + +// Request message for `FlushRows`. +message FlushRowsRequest { + // Required. The stream that is the target of the flush operation. + string write_stream = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigquerystorage.googleapis.com/WriteStream" + } + ]; + + // Ending offset of the flush operation. Rows before this offset(including + // this offset) will be flushed. + int64 offset = 2; +} + +// Respond message for `FlushRows`. +message FlushRowsResponse { + // The rows before this offset (including this offset) are flushed. + int64 offset = 1; +} diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/stream.proto b/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/stream.proto new file mode 100644 index 000000000..0ec0ef81a --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/stream.proto @@ -0,0 +1,76 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.bigquery.storage.v1alpha2; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/cloud/bigquery/storage/v1alpha2/table.proto"; +import "google/protobuf/timestamp.proto"; + +option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/storage/v1alpha2;storage"; +option java_package = "com.google.cloud.bigquery.storage.v1alpha2"; +option (google.api.resource_definition) = { + type: "bigquerystorage.googleapis.com/Table" + pattern: "projects/{project}/datasets/{dataset}/tables/{table}" +}; + +// Information about a single stream that gets data inside the storage system. +message WriteStream { + option (google.api.resource) = { + type: "bigquerystorage.googleapis.com/WriteStream" + pattern: "projects/{project}/datasets/{dataset}/tables/{table}/streams/{stream}" + }; + + enum Type { + // Unknown type. + TYPE_UNSPECIFIED = 0; + + // Data will commit automatically and appear as soon as the write is + // acknowledged. + COMMITTED = 1; + + // Data is invisible until the stream is committed. + PENDING = 2; + + // Data is only visible up to the offset to which it was flushed. + BUFFERED = 3; + } + + // Output only. Name of the stream, in the form + // `projects/{project}/datasets/{dataset}/tables/{table}/streams/{stream}`. + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + Type type = 2 [(google.api.field_behavior) = IMMUTABLE]; + + // Output only. Create time of the stream. + google.protobuf.Timestamp create_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Commit time of the stream. + // If a stream is of `COMMITTED` type, then it will have a commit_time same as + // `create_time`. If the stream is of `PENDING` type, commit_time being empty + // means it is not committed. + google.protobuf.Timestamp commit_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The schema of the destination table. It is only returned in + // `CreateWriteStream` response. Caller should generate data that's + // compatible with this schema to send in initial `AppendRowsRequest`. + // The table schema could go out of date during the life time of the stream. + TableSchema table_schema = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Id set by client to annotate its identity. + string external_id = 6; +} diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/table.proto b/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/table.proto new file mode 100644 index 000000000..d4bc01716 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1alpha2/table.proto @@ -0,0 +1,100 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.bigquery.storage.v1alpha2; + +import "google/api/field_behavior.proto"; + +option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/storage/v1alpha2;storage"; +option java_package = "com.google.cloud.bigquery.storage.v1alpha2"; + +// Schema of a table +message TableSchema { + // Describes the fields in a table. + repeated TableFieldSchema fields = 1; +} + +// A field in TableSchema +message TableFieldSchema { + enum Type { + // Illegal value + TYPE_UNSPECIFIED = 0; + + // 64K, UTF8 + STRING = 1; + + // 64-bit signed + INT64 = 2; + + // 64-bit IEEE floating point + DOUBLE = 3; + + // Aggregate type + STRUCT = 4; + + // 64K, Binary + BYTES = 5; + + // 2-valued + BOOL = 6; + + // 64-bit signed usec since UTC epoch + TIMESTAMP = 7; + + // Civil date - Year, Month, Day + DATE = 8; + + // Civil time - Hour, Minute, Second, Microseconds + TIME = 9; + + // Combination of civil date and civil time + DATETIME = 10; + + // Geography object (go/googlesql_geography) + GEOGRAPHY = 11; + + // Numeric value (go/googlesql_numeric) + NUMERIC = 12; + } + + enum Mode { + // Illegal value + MODE_UNSPECIFIED = 0; + + NULLABLE = 1; + + REQUIRED = 2; + + REPEATED = 3; + } + + // Required. The field name. The name must contain only letters (a-z, A-Z), + // numbers (0-9), or underscores (_), and must start with a letter or + // underscore. The maximum length is 128 characters. + string name = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The field data type. + Type type = 2 [(google.api.field_behavior) = REQUIRED]; + + // Optional. The field mode. The default value is NULLABLE. + Mode mode = 3 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Describes the nested schema fields if the type property is set to STRUCT. + repeated TableFieldSchema fields = 4 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The field description. The maximum length is 1,024 characters. + string description = 6 [(google.api.field_behavior) = OPTIONAL]; +} diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/BUILD.bazel index 1772fa579..bd8a003b0 100644 --- a/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/BUILD.bazel +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/BUILD.bazel @@ -1,14 +1,18 @@ +# This file was automatically generated by BuildFileGenerator + # This is an API workspace, having public visibility by default makes perfect sense. package(default_visibility = ["//visibility:public"]) ############################################################################## # Common ############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") proto_library( - name = "bigquerystorage_proto", + name = "storage_proto", srcs = [ + "arrow.proto", "avro.proto", "read_options.proto", "storage.proto", @@ -16,6 +20,8 @@ proto_library( ], deps = [ "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", "//google/api:resource_proto", "@com_google_protobuf//:empty_proto", "@com_google_protobuf//:timestamp_proto", @@ -23,8 +29,11 @@ proto_library( ) proto_library_with_info( - name = "bigquerystorage_proto_with_info", - deps = [":bigquerystorage_proto"], + name = "storage_proto_with_info", + deps = [ + ":storage_proto", + "//google/cloud:common_resources_proto", + ], ) ############################################################################## @@ -32,71 +41,55 @@ proto_library_with_info( ############################################################################## load( "@com_google_googleapis_imports//:imports.bzl", - "java_grpc_library", - "java_gapic_library", "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", "java_proto_library", - "java_resource_name_proto_library", - "java_test", ) -_JAVA_GRPC_DEPS = [ - "@com_google_api_grpc_proto_google_common_protos//jar", -] - java_proto_library( - name = "bigquerystorage_java_proto", - deps = [":bigquerystorage_proto"], + name = "storage_java_proto", + deps = [":storage_proto"], ) java_grpc_library( - name = "bigquerystorage_java_grpc", - srcs = [":bigquerystorage_proto"], - deps = [":bigquerystorage_java_proto"] + _JAVA_GRPC_DEPS, -) - -java_resource_name_proto_library( - name = "bigquerystorage_resource_name_java_proto", - gapic_yaml = "bigquerystorage_gapic.yaml", - deps = [":bigquerystorage_proto"], + name = "storage_java_grpc", + srcs = [":storage_proto"], + deps = [":storage_java_proto"], ) java_gapic_library( - name = "bigquerystorage_java_gapic", - src = ":bigquerystorage_proto_with_info", + name = "storage_java_gapic", + src = ":storage_proto_with_info", gapic_yaml = "bigquerystorage_gapic.yaml", - service_yaml = "//google/cloud/bigquery/storage:storage_v1beta1.yaml", - test_deps = [":bigquerystorage_java_grpc"], + package = "google.cloud.bigquery.storage.v1beta1", + service_yaml = "bigquerystorage_v1beta1.yaml", + test_deps = [ + ":storage_java_grpc", + ], deps = [ - ":bigquerystorage_java_proto", - ":bigquerystorage_resource_name_java_proto", - ] + _JAVA_GRPC_DEPS, + ":storage_java_proto", + ], ) -[java_test( - name = test_name, - test_class = test_name, - runtime_deps = [ - ":bigquerystorage_java_gapic_test", +java_gapic_test( + name = "storage_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.bigquery.storage.v1beta1.BaseBigQueryStorageClientTest", ], -) for test_name in [ - "com.google.cloud.bigquery.storage.v1beta1.BaseBigQueryStorageClientTest", -]] + runtime_deps = [":storage_java_gapic_test"], +) -# Opensource Packages +# Open Source Packages java_gapic_assembly_gradle_pkg( - name = "google-cloud-bigquerystorage-v1-java", - client_deps = [":bigquerystorage_java_gapic"], - client_group = "com.google.cloud", - client_test_deps = [":bigquerystorage_java_gapic_test"], - grpc_deps = [":bigquerystorage_java_grpc"], - grpc_group = "com.google.api.grpc", - proto_deps = [ - ":bigquerystorage_java_proto", - ":bigquerystorage_proto", - ":bigquerystorage_resource_name_java_proto", - ] + _JAVA_GRPC_DEPS, - version = "0.0.0-SNAPSHOT", + name = "google-cloud-bigquery-storage-v1beta1-java", + deps = [ + ":storage_java_gapic", + ":storage_java_grpc", + ":storage_java_proto", + ":storage_proto", + ], ) ############################################################################## @@ -104,45 +97,286 @@ java_gapic_assembly_gradle_pkg( ############################################################################## load( "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", "go_proto_library", "go_test", - "go_gapic_library", - "go_gapic_assembly_pkg", ) go_proto_library( - name = "bigquerystorage_go_proto", + name = "storage_go_proto", compilers = ["@io_bazel_rules_go//proto:go_grpc"], importpath = "google.golang.org/genproto/googleapis/cloud/bigquery/storage/v1beta1", - protos = [":bigquerystorage_proto"], + protos = [":storage_proto"], deps = [ "//google/api:annotations_go_proto", ], ) go_gapic_library( - name = "bigquerystorage_go_gapic", - src = ":bigquerystorage_proto_with_info", - gapic_yaml = "bigquerystorage_gapic.yaml", - importpath = "cloud.google.com/go/bigquery/datatransfer/apiv1", - service_yaml = "//google/cloud/bigquery/storage:storage_v1beta1.yaml", - deps = [":bigquerystorage_go_proto"], + name = "storage_go_gapic", + srcs = [":storage_proto_with_info"], + grpc_service_config = "bigquerystorage_grpc_service_config.json", + importpath = "cloud.google.com/go/bigquery/storage/apiv1beta1;storage", + service_yaml = "bigquerystorage_v1beta1.yaml", + deps = [ + ":storage_go_proto", + ], ) go_test( - name = "bigquerystorage_go_gapic_test", - srcs = [":bigquerystorage_go_gapic_srcjar_test"], - embed = [":bigquerystorage_go_gapic"], + name = "storage_go_gapic_test", + srcs = [":storage_go_gapic_srcjar_test"], + embed = [":storage_go_gapic"], importpath = "cloud.google.com/go/bigquery/storage/apiv1beta1", ) -# Opensource Packages +# Open Source Packages go_gapic_assembly_pkg( - name = "gapi-cloud-bigquerystorage-v1-go", + name = "gapi-cloud-bigquery-storage-v1beta1-go", + deps = [ + ":storage_go_gapic", + ":storage_go_gapic_srcjar-test.srcjar", + ":storage_go_proto", + ], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "storage_moved_proto", + srcs = [":storage_proto"], deps = [ - ":bigquerystorage_go_gapic", - ":bigquerystorage_go_gapic_srcjar-smoke-test.srcjar", - ":bigquerystorage_go_gapic_srcjar-test.srcjar", - ":bigquerystorage_go_proto", + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +py_proto_library( + name = "storage_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":storage_moved_proto"], +) + +py_grpc_library( + name = "storage_py_grpc", + srcs = [":storage_moved_proto"], + deps = [":storage_py_proto"], +) + +py_gapic_library( + name = "storage_py_gapic", + src = ":storage_proto_with_info", + gapic_yaml = "bigquerystorage_gapic.yaml", + package = "google.cloud.bigquery.storage.v1beta1", + service_yaml = "bigquerystorage_v1beta1.yaml", + deps = [ + ":storage_py_grpc", + ":storage_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "bigquery-storage-v1beta1-py", + deps = [ + ":storage_py_gapic", + ":storage_py_grpc", + ":storage_py_proto", ], ) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "storage_php_proto", + deps = [":storage_proto"], +) + +php_grpc_library( + name = "storage_php_grpc", + srcs = [":storage_proto"], + deps = [":storage_php_proto"], +) + +php_gapic_library( + name = "storage_php_gapic", + src = ":storage_proto_with_info", + gapic_yaml = "bigquerystorage_gapic.yaml", + package = "google.cloud.bigquery.storage.v1beta1", + service_yaml = "bigquerystorage_v1beta1.yaml", + deps = [ + ":storage_php_grpc", + ":storage_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-bigquery-storage-v1beta1-php", + deps = [ + ":storage_php_gapic", + ":storage_php_grpc", + ":storage_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "storage_nodejs_gapic", + src = ":storage_proto_with_info", + gapic_yaml = "bigquerystorage_gapic.yaml", + package = "google.cloud.bigquery.storage.v1beta1", + service_yaml = "bigquerystorage_v1beta1.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "bigquery-storage-v1beta1-nodejs", + deps = [ + ":storage_nodejs_gapic", + ":storage_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "storage_ruby_proto", + deps = [":storage_proto"], +) + +ruby_grpc_library( + name = "storage_ruby_grpc", + srcs = [":storage_proto"], + deps = [":storage_ruby_proto"], +) + +ruby_gapic_library( + name = "storage_ruby_gapic", + src = ":storage_proto_with_info", + gapic_yaml = "bigquerystorage_gapic.yaml", + package = "google.cloud.bigquery.storage.v1beta1", + service_yaml = "bigquerystorage_v1beta1.yaml", + deps = [ + ":storage_ruby_grpc", + ":storage_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-bigquery-storage-v1beta1-ruby", + deps = [ + ":storage_ruby_gapic", + ":storage_ruby_grpc", + ":storage_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "storage_csharp_proto", + deps = [":storage_proto"], +) + +csharp_grpc_library( + name = "storage_csharp_grpc", + srcs = [":storage_proto"], + deps = [":storage_csharp_proto"], +) + +csharp_gapic_library( + name = "storage_csharp_gapic", + src = ":storage_proto_with_info", + gapic_yaml = "bigquerystorage_gapic.yaml", + package = "google.cloud.bigquery.storage.v1beta1", + service_yaml = "bigquerystorage_v1beta1.yaml", + deps = [ + ":storage_csharp_grpc", + ":storage_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-bigquery-storage-v1beta1-csharp", + deps = [ + ":storage_csharp_gapic", + ":storage_csharp_grpc", + ":storage_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "cc_grpc_library", + "cc_proto_library", +) + +cc_proto_library( + name = "storage_cc_proto", + deps = [":storage_proto"], +) + +cc_grpc_library( + name = "storage_cc_grpc", + srcs = [":storage_proto"], + generate_mocks = True, + grpc_only = True, + deps = [":storage_cc_proto"], +) + diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/arrow.proto b/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/arrow.proto index 3003de444..f70c61c72 100644 --- a/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/arrow.proto +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/arrow.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/avro.proto b/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/avro.proto index 021d8e44f..7d034a28a 100644 --- a/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/avro.proto +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/avro.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/bigquerystorage_gapic.yaml b/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/bigquerystorage_gapic.yaml index 3843dbc4f..964d2c70c 100644 --- a/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/bigquerystorage_gapic.yaml +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/bigquerystorage_gapic.yaml @@ -20,7 +20,7 @@ language_settings: package_name: storage.v1beta1 # A list of API interface configurations. interfaces: - # The fully qualified name of the API interface. +# The fully qualified name of the API interface. - name: google.cloud.bigquery.storage.v1beta1.BigQueryStorage # A list of resource collection configurations. # Consists of a name_pattern and an entity_name. diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/bigquerystorage_grpc_service_config.json b/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/bigquerystorage_grpc_service_config.json new file mode 100644 index 000000000..4450be8c2 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/bigquerystorage_grpc_service_config.json @@ -0,0 +1,65 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.bigquery.storage.v1beta1.BigQueryStorage", + "method": "CreateReadSession" + } + ], + "timeout": "600s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.bigquery.storage.v1beta1.BigQueryStorage", + "method": "ReadRows" + } + ], + "timeout": "86400s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.bigquery.storage.v1beta1.BigQueryStorage", + "method": "BatchCreateReadSessionStreams" + }, + { + "service": "google.cloud.bigquery.storage.v1beta1.BigQueryStorage", + "method": "FinalizeStream" + }, + { + "service": "google.cloud.bigquery.storage.v1beta1.BigQueryStorage", + "method": "SplitReadStream" + } + ], + "timeout": "600s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/cloud/bigquery/storage/storage_v1beta1.yaml b/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/bigquerystorage_v1beta1.yaml similarity index 60% rename from third_party/googleapis/google/cloud/bigquery/storage/storage_v1beta1.yaml rename to third_party/googleapis/google/cloud/bigquery/storage/v1beta1/bigquerystorage_v1beta1.yaml index bcb700d62..74689be3f 100644 --- a/third_party/googleapis/google/cloud/bigquery/storage/storage_v1beta1.yaml +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/bigquerystorage_v1beta1.yaml @@ -6,10 +6,18 @@ title: BigQuery Storage API apis: - name: google.cloud.bigquery.storage.v1beta1.BigQueryStorage +backend: + rules: + - selector: 'google.cloud.bigquery.storage.v1beta1.BigQueryStorage.*' + deadline: 120.0 + - selector: google.cloud.bigquery.storage.v1beta1.BigQueryStorage.ReadRows + deadline: 21600.0 + authentication: rules: - selector: 'google.cloud.bigquery.storage.v1beta1.BigQueryStorage.*' oauth: canonical_scopes: |- https://www.googleapis.com/auth/bigquery, + https://www.googleapis.com/auth/bigquery.readonly, https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/read_options.proto b/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/read_options.proto index 9591deba7..1ff8d8b5e 100644 --- a/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/read_options.proto +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/read_options.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -29,8 +28,7 @@ message TableReadOptions { repeated string selected_fields = 1; // Optional. SQL text filtering statement, similar to a WHERE clause in - // a query. Currently, only a single predicate that is a comparison between - // a column and a constant value is supported. Aggregates are not supported. + // a query. Aggregates are not supported. // // Examples: "int_field > 5" // "date_field = CAST('2014-9-27' as DATE)" diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/storage.proto b/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/storage.proto index fa2de616d..81e77c73a 100644 --- a/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/storage.proto +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/storage.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,20 +11,21 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.bigquery.storage.v1beta1; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/cloud/bigquery/storage/v1beta1/arrow.proto"; import "google/cloud/bigquery/storage/v1beta1/avro.proto"; import "google/cloud/bigquery/storage/v1beta1/read_options.proto"; import "google/cloud/bigquery/storage/v1beta1/table_reference.proto"; import "google/protobuf/empty.proto"; import "google/protobuf/timestamp.proto"; -import "google/api/client.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/storage/v1beta1;storage"; option java_package = "com.google.cloud.bigquery.storage.v1beta1"; @@ -36,6 +37,7 @@ service BigQueryStorage { option (google.api.default_host) = "bigquerystorage.googleapis.com"; option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/bigquery," + "https://www.googleapis.com/auth/bigquery.readonly," "https://www.googleapis.com/auth/cloud-platform"; // Creates a new read session. A read session divides the contents of a @@ -59,6 +61,7 @@ service BigQueryStorage { body: "*" } }; + option (google.api.method_signature) = "table_reference,parent,requested_streams"; } // Reads rows from the table in the format prescribed by the read session. @@ -74,6 +77,7 @@ service BigQueryStorage { option (google.api.http) = { get: "/v1beta1/{read_position.stream.name=projects/*/streams/*}" }; + option (google.api.method_signature) = "read_position"; } // Creates additional streams for a ReadSession. This API can be used to @@ -84,6 +88,7 @@ service BigQueryStorage { post: "/v1beta1/{session.name=projects/*/sessions/*}" body: "*" }; + option (google.api.method_signature) = "session,requested_streams"; } // Triggers the graceful termination of a single stream in a ReadSession. This @@ -105,6 +110,7 @@ service BigQueryStorage { post: "/v1beta1/{stream.name=projects/*/streams/*}" body: "*" }; + option (google.api.method_signature) = "stream"; } // Splits a given read stream into two Streams. These streams are referred to @@ -124,11 +130,17 @@ service BigQueryStorage { option (google.api.http) = { get: "/v1beta1/{original_stream.name=projects/*/streams/*}" }; + option (google.api.method_signature) = "original_stream"; } } // Information about a single data stream within a read session. message Stream { + option (google.api.resource) = { + type: "bigquerystorage.googleapis.com/Stream" + pattern: "projects/{project}/locations/{location}/streams/{stream}" + }; + // Name of the stream, in the form // `projects/{project_id}/locations/{location}/streams/{stream_id}`. string name = 1; @@ -145,6 +157,11 @@ message StreamPosition { // Information returned from a `CreateReadSession` request. message ReadSession { + option (google.api.resource) = { + type: "bigquerystorage.googleapis.com/ReadSession" + pattern: "projects/{project}/locations/{location}/sessions/{session}" + }; + // Unique identifier for the session, in the form // `projects/{project_id}/locations/{location}/sessions/{session_id}`. string name = 1; @@ -181,17 +198,22 @@ message ReadSession { // requested parallelism, projection filters and constraints. message CreateReadSessionRequest { // Required. Reference to the table to read. - TableReference table_reference = 1; + TableReference table_reference = 1 [(google.api.field_behavior) = REQUIRED]; // Required. String of the form `projects/{project_id}` indicating the // project this ReadSession is associated with. This is the project that will // be billed for usage. - string parent = 6; - - // Optional. Any modifiers to the Table (e.g. snapshot timestamp). + string parent = 6 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudresourcemanager.googleapis.com/Project" + } + ]; + + // Any modifiers to the Table (e.g. snapshot timestamp). TableModifiers table_modifiers = 2; - // Optional. Initial number of streams. If unset or 0, we will + // Initial number of streams. If unset or 0, we will // provide a value of streams so as to produce reasonable throughput. Must be // non-negative. The number of streams may be lower than the requested number, // depending on the amount parallelism that is reasonable for the table and @@ -200,7 +222,7 @@ message CreateReadSessionRequest { // Streams must be read starting from offset 0. int32 requested_streams = 3; - // Optional. Read options for this session (e.g. column selection, filters). + // Read options for this session (e.g. column selection, filters). TableReadOptions read_options = 4; // Data output format. Currently default to Avro. @@ -248,7 +270,7 @@ message ReadRowsRequest { // Required. Identifier of the position in the stream to start reading from. // The offset requested must be less than the last row read from ReadRows. // Requesting a larger offset is undefined. - StreamPosition read_position = 1; + StreamPosition read_position = 1 [(google.api.field_behavior) = REQUIRED]; } // Progress information for a given Stream. @@ -267,6 +289,9 @@ message StreamStatus { // sharding strategy. float fraction_consumed = 2; + // Represents the progress of the current stream. + Progress progress = 4; + // Whether this stream can be split. For sessions that use the LIQUID sharding // strategy, this value is always false. For BALANCED sessions, this value is // false when enough data have been read such that no more splits are possible @@ -275,6 +300,25 @@ message StreamStatus { bool is_splittable = 3; } +message Progress { + // The fraction of rows assigned to the stream that have been processed by the + // server so far, not including the rows in the current response message. + // + // This value, along with `at_response_end`, can be used to interpolate the + // progress made as the rows in the message are being processed using the + // following formula: `at_response_start + (at_response_end - + // at_response_start) * rows_processed_from_response / rows_in_response`. + // + // Note that if a filter is provided, the `at_response_end` value of the + // previous response may not necessarily be equal to the `at_response_start` + // value of the current response. + float at_response_start = 1; + + // Similar to `at_response_start`, except that this value includes the rows in + // the current response. + float at_response_end = 2; +} + // Information on if the current connection is being throttled. message ThrottleStatus { // How much this connection is being throttled. @@ -313,12 +357,12 @@ message ReadRowsResponse { message BatchCreateReadSessionStreamsRequest { // Required. Must be a non-expired session obtained from a call to // CreateReadSession. Only the name field needs to be set. - ReadSession session = 1; + ReadSession session = 1 [(google.api.field_behavior) = REQUIRED]; // Required. Number of new streams requested. Must be positive. // Number of added streams may be less than this, see CreateReadSessionRequest // for more information. - int32 requested_streams = 2; + int32 requested_streams = 2 [(google.api.field_behavior) = REQUIRED]; } // The response from `BatchCreateReadSessionStreams` returns the stream @@ -330,14 +374,14 @@ message BatchCreateReadSessionStreamsResponse { // Request information for invoking `FinalizeStream`. message FinalizeStreamRequest { - // Stream to finalize. - Stream stream = 2; + // Required. Stream to finalize. + Stream stream = 2 [(google.api.field_behavior) = REQUIRED]; } // Request information for `SplitReadStream`. message SplitReadStreamRequest { - // Stream to split. - Stream original_stream = 1; + // Required. Stream to split. + Stream original_stream = 1 [(google.api.field_behavior) = REQUIRED]; // A value in the range (0.0, 1.0) that specifies the fractional point at // which the original stream should be split. The actual split point is diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/table_reference.proto b/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/table_reference.proto index fb74bbf6c..4269392f6 100644 --- a/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/table_reference.proto +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1beta1/table_reference.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,12 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.bigquery.storage.v1beta1; +import "google/api/resource.proto"; import "google/protobuf/timestamp.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/storage/v1beta1;storage"; diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/BUILD.bazel b/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/BUILD.bazel new file mode 100644 index 000000000..d2e1ec642 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/BUILD.bazel @@ -0,0 +1,377 @@ +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") +load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") + +proto_library( + name = "storage_proto", + srcs = [ + "arrow.proto", + "avro.proto", + "storage.proto", + "stream.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +proto_library_with_info( + name = "storage_proto_with_info", + deps = [ + ":storage_proto", + "//google/cloud:common_resources_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", + "java_proto_library", +) + +java_proto_library( + name = "storage_java_proto", + deps = [":storage_proto"], +) + +java_grpc_library( + name = "storage_java_grpc", + srcs = [":storage_proto"], + deps = [":storage_java_proto"], +) + +java_gapic_library( + name = "storage_java_gapic", + src = ":storage_proto_with_info", + gapic_yaml = "bigquerystorage_gapic.yaml", + package = "google.cloud.bigquery.storage.v1beta2", + service_yaml = "bigquerystorage_v1beta2.yaml", + test_deps = [ + ":storage_java_grpc", + ], + deps = [ + ":storage_java_proto", + ], +) + +java_gapic_test( + name = "storage_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.bigquery.storage.v1beta2.BaseBigQueryReadClientTest", + ], + runtime_deps = [":storage_java_gapic_test"], +) + +# Open Source Packages +java_gapic_assembly_gradle_pkg( + name = "google-cloud-bigquery-storage-v1beta2-java", + deps = [ + ":storage_java_gapic", + ":storage_java_grpc", + ":storage_java_proto", + ":storage_proto", + ], +) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", + "go_proto_library", + "go_test", +) + +go_proto_library( + name = "storage_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/cloud/bigquery/storage/v1beta2", + protos = [":storage_proto"], + deps = [ + "//google/api:annotations_go_proto", + ], +) + +go_gapic_library( + name = "storage_go_gapic", + srcs = [":storage_proto_with_info"], + grpc_service_config = "bigquerystorage_grpc_service_config.json", + importpath = "cloud.google.com/go/bigquery/storage/apiv1beta2;storage", + service_yaml = "bigquerystorage_v1beta2.yaml", + deps = [ + ":storage_go_proto", + ], +) + +go_test( + name = "storage_go_gapic_test", + srcs = [":storage_go_gapic_srcjar_test"], + embed = [":storage_go_gapic"], + importpath = "cloud.google.com/go/bigquery/storage/apiv1beta2", +) + +# Open Source Packages +go_gapic_assembly_pkg( + name = "gapi-cloud-bigquery-storage-v1beta2-go", + deps = [ + ":storage_go_gapic", + ":storage_go_gapic_srcjar-test.srcjar", + ":storage_go_proto", + ], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "storage_moved_proto", + srcs = [":storage_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +py_proto_library( + name = "storage_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":storage_moved_proto"], +) + +py_grpc_library( + name = "storage_py_grpc", + srcs = [":storage_moved_proto"], + deps = [":storage_py_proto"], +) + +py_gapic_library( + name = "storage_py_gapic", + src = ":storage_proto_with_info", + gapic_yaml = "bigquerystorage_gapic.yaml", + package = "google.cloud.bigquery.storage.v1beta2", + service_yaml = "bigquerystorage_v1beta2.yaml", + deps = [ + ":storage_py_grpc", + ":storage_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "bigquery-storage-v1beta2-py", + deps = [ + ":storage_py_gapic", + ":storage_py_grpc", + ":storage_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "storage_php_proto", + deps = [":storage_proto"], +) + +php_grpc_library( + name = "storage_php_grpc", + srcs = [":storage_proto"], + deps = [":storage_php_proto"], +) + +php_gapic_library( + name = "storage_php_gapic", + src = ":storage_proto_with_info", + gapic_yaml = "bigquerystorage_gapic.yaml", + package = "google.cloud.bigquery.storage.v1beta2", + service_yaml = "bigquerystorage_v1beta2.yaml", + deps = [ + ":storage_php_grpc", + ":storage_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-bigquery-storage-v1beta2-php", + deps = [ + ":storage_php_gapic", + ":storage_php_grpc", + ":storage_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "storage_nodejs_gapic", + src = ":storage_proto_with_info", + gapic_yaml = "bigquerystorage_gapic.yaml", + package = "google.cloud.bigquery.storage.v1beta2", + service_yaml = "bigquerystorage_v1beta2.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "bigquery-storage-v1beta2-nodejs", + deps = [ + ":storage_nodejs_gapic", + ":storage_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "storage_ruby_proto", + deps = [":storage_proto"], +) + +ruby_grpc_library( + name = "storage_ruby_grpc", + srcs = [":storage_proto"], + deps = [":storage_ruby_proto"], +) + +ruby_gapic_library( + name = "storage_ruby_gapic", + src = ":storage_proto_with_info", + gapic_yaml = "bigquerystorage_gapic.yaml", + package = "google.cloud.bigquery.storage.v1beta2", + service_yaml = "bigquerystorage_v1beta2.yaml", + deps = [ + ":storage_ruby_grpc", + ":storage_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-bigquery-storage-v1beta2-ruby", + deps = [ + ":storage_ruby_gapic", + ":storage_ruby_grpc", + ":storage_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "storage_csharp_proto", + deps = [":storage_proto"], +) + +csharp_grpc_library( + name = "storage_csharp_grpc", + srcs = [":storage_proto"], + deps = [":storage_csharp_proto"], +) + +csharp_gapic_library( + name = "storage_csharp_gapic", + src = ":storage_proto_with_info", + gapic_yaml = "bigquerystorage_gapic.yaml", + package = "google.cloud.bigquery.storage.v1beta2", + service_yaml = "bigquerystorage_v1beta2.yaml", + deps = [ + ":storage_csharp_grpc", + ":storage_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-bigquery-storage-v1beta2-csharp", + deps = [ + ":storage_csharp_gapic", + ":storage_csharp_grpc", + ":storage_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "cc_grpc_library", + "cc_proto_library", +) + +cc_proto_library( + name = "storage_cc_proto", + deps = [":storage_proto"], +) + +cc_grpc_library( + name = "storage_cc_grpc", + srcs = [":storage_proto"], + generate_mocks = True, + grpc_only = True, + deps = [":storage_cc_proto"], +) diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/arrow.proto b/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/arrow.proto new file mode 100644 index 000000000..74733db96 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/arrow.proto @@ -0,0 +1,58 @@ +// Copyright 2019 Google LLC. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// + +syntax = "proto3"; + +package google.cloud.bigquery.storage.v1beta2; + +option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/storage/v1beta2;storage"; +option java_multiple_files = true; +option java_outer_classname = "ArrowProto"; +option java_package = "com.google.cloud.bigquery.storage.v1beta2"; + +// Arrow schema as specified in +// https://arrow.apache.org/docs/python/api/datatypes.html +// and serialized to bytes using IPC: +// https://arrow.apache.org/docs/format/Columnar.html#serialization-and-interprocess-communication-ipc +// +// See code samples on how this message can be deserialized. +message ArrowSchema { + // IPC serialized Arrow schema. + bytes serialized_schema = 1; +} + +// Arrow RecordBatch. +message ArrowRecordBatch { + // IPC-serialized Arrow RecordBatch. + bytes serialized_record_batch = 1; +} + +// Contains options specific to Arrow Serialization. +message ArrowSerializationOptions { + // The IPC format to use when serializing Arrow streams. + enum Format { + // If unspecied the IPC format as of 0.15 release will be used. + FORMAT_UNSPECIFIED = 0; + + // Use the legacy IPC message format as of Apache Arrow Release 0.14. + ARROW_0_14 = 1; + + // Use the message format as of Apache Arrow Release 0.15. + ARROW_0_15 = 2; + } + + // The Arrow IPC format to use. + Format format = 1; +} diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/avro.proto b/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/avro.proto new file mode 100644 index 000000000..371946906 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/avro.proto @@ -0,0 +1,36 @@ +// Copyright 2019 Google LLC. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// + +syntax = "proto3"; + +package google.cloud.bigquery.storage.v1beta2; + +option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/storage/v1beta2;storage"; +option java_multiple_files = true; +option java_outer_classname = "AvroProto"; +option java_package = "com.google.cloud.bigquery.storage.v1beta2"; + +// Avro schema. +message AvroSchema { + // Json serialized schema, as described at + // https://avro.apache.org/docs/1.8.1/spec.html. + string schema = 1; +} + +// Avro rows. +message AvroRows { + // Binary serialized rows in a block. + bytes serialized_binary_rows = 1; +} diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/bigquerystorage_gapic.legacy.yaml b/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/bigquerystorage_gapic.legacy.yaml new file mode 100644 index 000000000..fef14b57d --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/bigquerystorage_gapic.legacy.yaml @@ -0,0 +1,84 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 1.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.bigquery.storage.v1beta2 + interface_names: + google.cloud.bigquery.storage.v1beta2.BigQueryRead: BaseBigQueryRead + python: + package_name: google.cloud.bigquery_storage_v1beta2.gapic + go: + package_name: cloud.google.com/go/bigquery/storage/apiv1beta2 + csharp: + package_name: Google.Cloud.Bigquery.Storage.V1beta2 + ruby: + package_name: Google::Cloud::Bigquery::Storage::V1beta2 + php: + package_name: Google\Cloud\Bigquery\Storage\V1beta2 + nodejs: + package_name: storage.v1beta2 +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.cloud.bigquery.storage.v1beta2.BigQueryRead + collections: [] + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - DEADLINE_EXCEEDED + - UNAVAILABLE + - name: unary_streaming + retry_codes: + - UNAVAILABLE + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + - name: create_read_session + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 120000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 120000 + total_timeout_millis: 600000 + - name: read_rows + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 86400000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 86400000 + total_timeout_millis: 86400000 + methods: + - name: CreateReadSession + flattening: + groups: + - parameters: + - parent + - read_session + - max_stream_count + retry_codes_name: idempotent + retry_params_name: create_read_session + timeout_millis: 60000 + - name: ReadRows + flattening: + groups: + - parameters: + - read_stream + - offset + retry_codes_name: unary_streaming + retry_params_name: read_rows + timeout_millis: 86400000 + - name: SplitReadStream + retry_codes_name: idempotent + retry_params_name: default + timeout_millis: 60000 diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/bigquerystorage_gapic.yaml b/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/bigquerystorage_gapic.yaml new file mode 100644 index 000000000..f3b83cd1b --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/bigquerystorage_gapic.yaml @@ -0,0 +1,70 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 2.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.bigquery.storage.v1beta2 + interface_names: + google.cloud.bigquery.storage.v1beta2.BigQueryRead: BaseBigQueryRead + python: + package_name: google.cloud.bigquery_storage_v1beta2.gapic + go: + package_name: cloud.google.com/go/bigquery/storage/apiv1beta2 + csharp: + package_name: Google.Cloud.Bigquery.Storage.V1beta2 + ruby: + package_name: Google::Cloud::Bigquery::Storage::V1beta2 + php: + package_name: Google\Cloud\Bigquery\Storage\V1beta2 + nodejs: + package_name: storage.v1beta2 +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.cloud.bigquery.storage.v1beta2.BigQueryRead + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - DEADLINE_EXCEEDED + - UNAVAILABLE + - name: unary_streaming + retry_codes: + - UNAVAILABLE + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + - name: create_read_session + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 120000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 120000 + total_timeout_millis: 600000 + - name: read_rows + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 86400000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 86400000 + total_timeout_millis: 86400000 + methods: + - name: CreateReadSession + retry_codes_name: idempotent + retry_params_name: create_read_session + - name: ReadRows + retry_codes_name: unary_streaming + retry_params_name: read_rows + timeout_millis: 86400000 + - name: SplitReadStream + retry_codes_name: idempotent + retry_params_name: default diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/bigquerystorage_grpc_service_config.json b/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/bigquerystorage_grpc_service_config.json new file mode 100644 index 000000000..270f5f937 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/bigquerystorage_grpc_service_config.json @@ -0,0 +1,57 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.bigquery.storage.v1beta2.BigQueryRead", + "method": "CreateReadSession" + } + ], + "timeout": "600s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.bigquery.storage.v1beta2.BigQueryRead", + "method": "ReadRows" + } + ], + "timeout": "86400s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.bigquery.storage.v1beta2.BigQueryRead", + "method": "SplitReadStream" + } + ], + "timeout": "600s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/bigquerystorage_v1beta2.yaml b/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/bigquerystorage_v1beta2.yaml new file mode 100644 index 000000000..16230fadd --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/bigquerystorage_v1beta2.yaml @@ -0,0 +1,25 @@ +type: google.api.Service +config_version: 3 +name: bigquerystorage.googleapis.com +title: BigQuery Storage API + +apis: +- name: google.cloud.bigquery.storage.v1beta2.BigQueryRead + +backend: + rules: + - selector: google.cloud.bigquery.storage.v1beta2.BigQueryRead.CreateReadSession + deadline: 120.0 + - selector: google.cloud.bigquery.storage.v1beta2.BigQueryRead.ReadRows + deadline: 21600.0 + - selector: google.cloud.bigquery.storage.v1beta2.BigQueryRead.SplitReadStream + deadline: 120.0 + +authentication: + rules: + - selector: 'google.cloud.bigquery.storage.v1beta2.BigQueryRead.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/bigquery, + https://www.googleapis.com/auth/bigquery.readonly, + https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/storage.proto b/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/storage.proto new file mode 100644 index 000000000..373c83525 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/storage.proto @@ -0,0 +1,230 @@ +// Copyright 2019 Google LLC. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// + +syntax = "proto3"; + +package google.cloud.bigquery.storage.v1beta2; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/cloud/bigquery/storage/v1beta2/arrow.proto"; +import "google/cloud/bigquery/storage/v1beta2/avro.proto"; +import "google/cloud/bigquery/storage/v1beta2/stream.proto"; + +option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/storage/v1beta2;storage"; +option java_multiple_files = true; +option java_outer_classname = "StorageProto"; +option java_package = "com.google.cloud.bigquery.storage.v1beta2"; + +// BigQuery Read API. +// +// The Read API can be used to read data from BigQuery. +service BigQueryRead { + option (google.api.default_host) = "bigquerystorage.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/bigquery," + "https://www.googleapis.com/auth/bigquery.readonly," + "https://www.googleapis.com/auth/cloud-platform"; + + // Creates a new read session. A read session divides the contents of a + // BigQuery table into one or more streams, which can then be used to read + // data from the table. The read session also specifies properties of the + // data to be read, such as a list of columns or a push-down filter describing + // the rows to be returned. + // + // A particular row can be read by at most one stream. When the caller has + // reached the end of each stream in the session, then all the data in the + // table has been read. + // + // Data is assigned to each stream such that roughly the same number of + // rows can be read from each stream. Because the server-side unit for + // assigning data is collections of rows, the API does not guarantee that + // each stream will return the same number or rows. Additionally, the + // limits are enforced based on the number of pre-filtered rows, so some + // filters can lead to lopsided assignments. + // + // Read sessions automatically expire 24 hours after they are created and do + // not require manual clean-up by the caller. + rpc CreateReadSession(CreateReadSessionRequest) returns (ReadSession) { + option (google.api.http) = { + post: "/v1beta2/{read_session.table=projects/*/datasets/*/tables/*}" + body: "*" + }; + option (google.api.method_signature) = "parent,read_session,max_stream_count"; + } + + // Reads rows from the stream in the format prescribed by the ReadSession. + // Each response contains one or more table rows, up to a maximum of 100 MiB + // per response; read requests which attempt to read individual rows larger + // than 100 MiB will fail. + // + // Each request also returns a set of stream statistics reflecting the current + // state of the stream. + rpc ReadRows(ReadRowsRequest) returns (stream ReadRowsResponse) { + option (google.api.http) = { + get: "/v1beta2/{read_stream=projects/*/locations/*/sessions/*/streams/*}" + }; + option (google.api.method_signature) = "read_stream,offset"; + } + + // Splits a given `ReadStream` into two `ReadStream` objects. These + // `ReadStream` objects are referred to as the primary and the residual + // streams of the split. The original `ReadStream` can still be read from in + // the same manner as before. Both of the returned `ReadStream` objects can + // also be read from, and the rows returned by both child streams will be + // the same as the rows read from the original stream. + // + // Moreover, the two child streams will be allocated back-to-back in the + // original `ReadStream`. Concretely, it is guaranteed that for streams + // original, primary, and residual, that original[0-j] = primary[0-j] and + // original[j-n] = residual[0-m] once the streams have been read to + // completion. + rpc SplitReadStream(SplitReadStreamRequest) returns (SplitReadStreamResponse) { + option (google.api.http) = { + get: "/v1beta2/{name=projects/*/locations/*/sessions/*/streams/*}" + }; + } +} + +// Request message for `CreateReadSession`. +message CreateReadSessionRequest { + // Required. The request project that owns the session, in the form of + // `projects/{project_id}`. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudresourcemanager.googleapis.com/Project" + } + ]; + + // Required. Session to be created. + ReadSession read_session = 2 [(google.api.field_behavior) = REQUIRED]; + + // Max initial number of streams. If unset or zero, the server will + // provide a value of streams so as to produce reasonable throughput. Must be + // non-negative. The number of streams may be lower than the requested number, + // depending on the amount parallelism that is reasonable for the table. Error + // will be returned if the max count is greater than the current system + // max limit of 1,000. + // + // Streams must be read starting from offset 0. + int32 max_stream_count = 3; +} + +// Request message for `ReadRows`. +message ReadRowsRequest { + // Required. Stream to read rows from. + string read_stream = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigquerystorage.googleapis.com/ReadStream" + } + ]; + + // The offset requested must be less than the last row read from Read. + // Requesting a larger offset is undefined. If not specified, start reading + // from offset zero. + int64 offset = 2; +} + +// Information on if the current connection is being throttled. +message ThrottleState { + // How much this connection is being throttled. Zero means no throttling, + // 100 means fully throttled. + int32 throttle_percent = 1; +} + +// Estimated stream statistics for a given Stream. +message StreamStats { + message Progress { + // The fraction of rows assigned to the stream that have been processed by + // the server so far, not including the rows in the current response + // message. + // + // This value, along with `at_response_end`, can be used to interpolate + // the progress made as the rows in the message are being processed using + // the following formula: `at_response_start + (at_response_end - + // at_response_start) * rows_processed_from_response / rows_in_response`. + // + // Note that if a filter is provided, the `at_response_end` value of the + // previous response may not necessarily be equal to the + // `at_response_start` value of the current response. + double at_response_start = 1; + + // Similar to `at_response_start`, except that this value includes the + // rows in the current response. + double at_response_end = 2; + } + + // Represents the progress of the current stream. + Progress progress = 2; +} + +// Response from calling `ReadRows` may include row data, progress and +// throttling information. +message ReadRowsResponse { + // Row data is returned in format specified during session creation. + oneof rows { + // Serialized row data in AVRO format. + AvroRows avro_rows = 3; + + // Serialized row data in Arrow RecordBatch format. + ArrowRecordBatch arrow_record_batch = 4; + } + + // Number of serialized rows in the rows block. + int64 row_count = 6; + + // Statistics for the stream. + StreamStats stats = 2; + + // Throttling state. If unset, the latest response still describes + // the current throttling status. + ThrottleState throttle_state = 5; +} + +// Request message for `SplitReadStream`. +message SplitReadStreamRequest { + // Required. Name of the stream to split. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "bigquerystorage.googleapis.com/ReadStream" + } + ]; + + // A value in the range (0.0, 1.0) that specifies the fractional point at + // which the original stream should be split. The actual split point is + // evaluated on pre-filtered rows, so if a filter is provided, then there is + // no guarantee that the division of the rows between the new child streams + // will be proportional to this fractional value. Additionally, because the + // server-side unit for assigning data is collections of rows, this fraction + // will always map to a data storage boundary on the server side. + double fraction = 2; +} + +// Response message for `SplitReadStream`. +message SplitReadStreamResponse { + // Primary stream, which contains the beginning portion of + // |original_stream|. An empty value indicates that the original stream can no + // longer be split. + ReadStream primary_stream = 1; + + // Remainder stream, which contains the tail of |original_stream|. An empty + // value indicates that the original stream can no longer be split. + ReadStream remainder_stream = 2; +} diff --git a/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/stream.proto b/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/stream.proto new file mode 100644 index 000000000..38d5de478 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/storage/v1beta2/stream.proto @@ -0,0 +1,142 @@ +// Copyright 2019 Google LLC. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// + +syntax = "proto3"; + +package google.cloud.bigquery.storage.v1beta2; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/cloud/bigquery/storage/v1beta2/arrow.proto"; +import "google/cloud/bigquery/storage/v1beta2/avro.proto"; +import "google/protobuf/timestamp.proto"; + +option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/storage/v1beta2;storage"; +option java_multiple_files = true; +option java_outer_classname = "StreamProto"; +option java_package = "com.google.cloud.bigquery.storage.v1beta2"; +option (google.api.resource_definition) = { + type: "bigquery.googleapis.com/Table" + pattern: "projects/{project}/datasets/{dataset}/tables/{table}" +}; + +// Data format for input or output data. +enum DataFormat { + DATA_FORMAT_UNSPECIFIED = 0; + + // Avro is a standard open source row based file format. + // See https://avro.apache.org/ for more details. + AVRO = 1; + + // Arrow is a standard open source column-based message format. + // See https://arrow.apache.org/ for more details. + ARROW = 2; +} + +// Information about the ReadSession. +message ReadSession { + option (google.api.resource) = { + type: "bigquerystorage.googleapis.com/ReadSession" + pattern: "projects/{project}/locations/{location}/sessions/{session}" + }; + + // Additional attributes when reading a table. + message TableModifiers { + // The snapshot time of the table. If not set, interpreted as now. + google.protobuf.Timestamp snapshot_time = 1; + } + + // Options dictating how we read a table. + message TableReadOptions { + // Names of the fields in the table that should be read. If empty, all + // fields will be read. If the specified field is a nested field, all + // the sub-fields in the field will be selected. The output field order is + // unrelated to the order of fields in selected_fields. + repeated string selected_fields = 1; + + // SQL text filtering statement, similar to a WHERE clause in a query. + // Aggregates are not supported. + // + // Examples: "int_field > 5" + // "date_field = CAST('2014-9-27' as DATE)" + // "nullable_field is not NULL" + // "st_equals(geo_field, st_geofromtext("POINT(2, 2)"))" + // "numeric_field BETWEEN 1.0 AND 5.0" + string row_restriction = 2; + + // Optional. Options specific to the Apache Arrow output format. + ArrowSerializationOptions arrow_serialization_options = 3 [(google.api.field_behavior) = OPTIONAL]; + } + + // Output only. Unique identifier for the session, in the form + // `projects/{project_id}/locations/{location}/sessions/{session_id}`. + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Time at which the session becomes invalid. After this time, subsequent + // requests to read this Session will return errors. The expire_time is + // automatically assigned and currently cannot be specified or updated. + google.protobuf.Timestamp expire_time = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Immutable. Data format of the output data. + DataFormat data_format = 3 [(google.api.field_behavior) = IMMUTABLE]; + + // The schema for the read. If read_options.selected_fields is set, the + // schema may be different from the table schema as it will only contain + // the selected fields. + oneof schema { + // Output only. Avro schema. + AvroSchema avro_schema = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Arrow schema. + ArrowSchema arrow_schema = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + } + + // Immutable. Table that this ReadSession is reading from, in the form + // `projects/{project_id}/datasets/{dataset_id}/tables/{table_id} + string table = 6 [ + (google.api.field_behavior) = IMMUTABLE, + (google.api.resource_reference) = { + type: "bigquery.googleapis.com/Table" + } + ]; + + // Optional. Any modifiers which are applied when reading from the specified table. + TableModifiers table_modifiers = 7 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Read options for this session (e.g. column selection, filters). + TableReadOptions read_options = 8 [(google.api.field_behavior) = OPTIONAL]; + + // Output only. A list of streams created with the session. + // + // At least one stream is created with the session. In the future, larger + // request_stream_count values *may* result in this list being unpopulated, + // in that case, the user will need to use a List method to get the streams + // instead, which is not yet available. + repeated ReadStream streams = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// Information about a single stream that gets data out of the storage system. +// Most of the information about `ReadStream` instances is aggregated, making +// `ReadStream` lightweight. +message ReadStream { + option (google.api.resource) = { + type: "bigquerystorage.googleapis.com/ReadStream" + pattern: "projects/{project}/locations/{location}/sessions/{session}/streams/{stream}" + }; + + // Output only. Name of the stream, in the form + // `projects/{project_id}/locations/{location}/sessions/{session_id}/streams/{stream_id}`. + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/cloud/bigquery/v2/BUILD.bazel b/third_party/googleapis/google/cloud/bigquery/v2/BUILD.bazel new file mode 100644 index 000000000..667222cb6 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/v2/BUILD.bazel @@ -0,0 +1,364 @@ +# This file was automatically generated by BuildFileGenerator + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") +load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") + +proto_library( + name = "bigquery_proto", + srcs = [ + "encryption_config.proto", + "model.proto", + "model_reference.proto", + "standard_sql.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:timestamp_proto", + "@com_google_protobuf//:wrappers_proto", + ], +) + +proto_library_with_info( + name = "bigquery_proto_with_info", + deps = [ + ":bigquery_proto", + "//google/cloud:common_resources_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", + "java_proto_library", +) + +java_proto_library( + name = "bigquery_java_proto", + deps = [":bigquery_proto"], +) + +java_grpc_library( + name = "bigquery_java_grpc", + srcs = [":bigquery_proto"], + deps = [":bigquery_java_proto"], +) + +java_gapic_library( + name = "bigquery_java_gapic", + src = ":bigquery_proto_with_info", + gapic_yaml = "bigquery_gapic.yaml", + package = "google.cloud.bigquery.v2", + service_yaml = "bigquery_v2.yaml", + test_deps = [ + ":bigquery_java_grpc", + ], + deps = [ + ":bigquery_java_proto", + ], +) + +java_gapic_test( + name = "bigquery_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.bigquery.v2.ModelServiceClientTest", + ], + runtime_deps = [":bigquery_java_gapic_test"], +) + +# Open Source Packages +java_gapic_assembly_gradle_pkg( + name = "google-cloud-bigquery-v2-java", + deps = [ + ":bigquery_java_gapic", + ":bigquery_java_grpc", + ":bigquery_java_proto", + ":bigquery_proto", + ], +) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", + "go_proto_library", + "go_test", +) + +go_proto_library( + name = "bigquery_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/cloud/bigquery/v2", + protos = [":bigquery_proto"], + deps = [ + "//google/api:annotations_go_proto", + ], +) + +go_gapic_library( + name = "bigquery_go_gapic", + srcs = [":bigquery_proto_with_info"], + grpc_service_config = "bigquery_grpc_service_config.json", + importpath = "cloud.google.com/go/bigquery/apiv2;bigquery", + service_yaml = "bigquery_v2.yaml", + deps = [ + ":bigquery_go_proto", + ], +) + +go_test( + name = "bigquery_go_gapic_test", + srcs = [":bigquery_go_gapic_srcjar_test"], + embed = [":bigquery_go_gapic"], + importpath = "cloud.google.com/go/bigquery/apiv2", +) + +# Open Source Packages +go_gapic_assembly_pkg( + name = "gapi-cloud-bigquery-v2-go", + deps = [ + ":bigquery_go_gapic", + ":bigquery_go_gapic_srcjar-test.srcjar", + ":bigquery_go_proto", + ], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "bigquery_moved_proto", + srcs = [":bigquery_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:timestamp_proto", + "@com_google_protobuf//:wrappers_proto", + ], +) + +py_proto_library( + name = "bigquery_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":bigquery_moved_proto"], +) + +py_grpc_library( + name = "bigquery_py_grpc", + srcs = [":bigquery_moved_proto"], + deps = [":bigquery_py_proto"], +) + +py_gapic_library( + name = "bigquery_py_gapic", + src = ":bigquery_proto_with_info", + gapic_yaml = "bigquery_gapic.yaml", + package = "google.cloud.bigquery.v2", + service_yaml = "bigquery_v2.yaml", + deps = [ + ":bigquery_py_grpc", + ":bigquery_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "bigquery-v2-py", + deps = [ + ":bigquery_py_gapic", + ":bigquery_py_grpc", + ":bigquery_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "bigquery_php_proto", + deps = [":bigquery_proto"], +) + +php_grpc_library( + name = "bigquery_php_grpc", + srcs = [":bigquery_proto"], + deps = [":bigquery_php_proto"], +) + +# Add api.http options to all RPCs in the services to enable PHP GAPIC +#php_gapic_library( +# name = "bigquery_php_gapic", +# src = ":bigquery_proto_with_info", +# gapic_yaml = "bigquery_gapic.yaml", +# package = "google.cloud.bigquery.v2", +# service_yaml = "bigquery_v2.yaml", +# deps = [ +# ":bigquery_php_grpc", +# ":bigquery_php_proto", +# ], +#) +# +## Open Source Packages +#php_gapic_assembly_pkg( +# name = "google-cloud-bigquery-v2-php", +# deps = [ +# ":bigquery_php_gapic", +# ":bigquery_php_grpc", +# ":bigquery_php_proto", +# ], +#) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "bigquery_nodejs_gapic", + src = ":bigquery_proto_with_info", + gapic_yaml = "bigquery_gapic.yaml", + package = "google.cloud.bigquery.v2", + service_yaml = "bigquery_v2.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "bigquery-v2-nodejs", + deps = [ + ":bigquery_nodejs_gapic", + ":bigquery_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "bigquery_ruby_proto", + deps = [":bigquery_proto"], +) + +ruby_grpc_library( + name = "bigquery_ruby_grpc", + srcs = [":bigquery_proto"], + deps = [":bigquery_ruby_proto"], +) + +ruby_gapic_library( + name = "bigquery_ruby_gapic", + src = ":bigquery_proto_with_info", + gapic_yaml = "bigquery_gapic.yaml", + package = "google.cloud.bigquery.v2", + service_yaml = "bigquery_v2.yaml", + deps = [ + ":bigquery_ruby_grpc", + ":bigquery_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-bigquery-v2-ruby", + deps = [ + ":bigquery_ruby_gapic", + ":bigquery_ruby_grpc", + ":bigquery_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "bigquery_csharp_proto", + deps = [":bigquery_proto"], +) + +csharp_grpc_library( + name = "bigquery_csharp_grpc", + srcs = [":bigquery_proto"], + deps = [":bigquery_csharp_proto"], +) + +csharp_gapic_library( + name = "bigquery_csharp_gapic", + src = ":bigquery_proto_with_info", + gapic_yaml = "bigquery_gapic.yaml", + package = "google.cloud.bigquery.v2", + service_yaml = "bigquery_v2.yaml", + deps = [ + ":bigquery_csharp_grpc", + ":bigquery_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-bigquery-v2-csharp", + deps = [ + ":bigquery_csharp_gapic", + ":bigquery_csharp_grpc", + ":bigquery_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/cloud/bigquery/v2/bigquery_gapic.legacy.yaml b/third_party/googleapis/google/cloud/bigquery/v2/bigquery_gapic.legacy.yaml new file mode 100644 index 000000000..de614d248 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/v2/bigquery_gapic.legacy.yaml @@ -0,0 +1,175 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 1.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.bigquery.v2 + python: + package_name: google.cloud.bigquery_v2.gapic + go: + package_name: cloud.google.com/go/bigquery/apiv2 + csharp: + package_name: Google.Cloud.Bigquery.V2 + ruby: + package_name: Google::Cloud::Bigquery::V2 + php: + package_name: Google\Cloud\Bigquery\V2 + nodejs: + package_name: bigquery.v2 +# The configuration for the license header to put on generated files. +license_header: + # The file containing the copyright line(s). + copyright_file: copyright-google.txt + # The file containing the raw license header without any copyright line(s). + license_file: license-header-apache-2.0.txt +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.cloud.bigquery.v2.ModelService + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: [] + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - DEADLINE_EXCEEDED + - UNAVAILABLE + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # + # name - The simple name of the method. + # + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce method + # overloads which allow a client to directly pass request message fields as + # method parameters. This information may or may not be used, depending on + # the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request message. + # + # required_fields - Fields that are always required for a request to be + # valid. + # + # resource_name_treatment - An enum that specifies how to treat the resource + # name formats defined in the field_name_patterns and + # response_field_name_patterns fields. + # UNSET: default value + # NONE: the collection configs will not be used by the generated code. + # VALIDATE: string fields will be validated by the client against the + # specified resource name formats. + # STATIC_TYPES: the client will use generated types for resource names. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a paging + # list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It defines + # which fields match the paging pattern in the request. The request consists + # of a page_size_field and a token_field. The page_size_field is the name of + # the optional field specifying the maximum number of elements to be + # returned in the response. The token_field is the name of the field in the + # request containing the page token. + # The response specifies response information of the list method. It defines + # which fields match the paging pattern in the response. The response + # consists of a token_field and a resources_field. The token_field is the + # name of the field in the response containing the next page token. The + # resources_field is the name of the field in the response containing the + # list of resources belonging to the page. + # + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: GetModel + flattening: + groups: + - parameters: + - project_id + - dataset_id + - model_id + required_fields: + - project_id + - dataset_id + - model_id + retry_codes_name: non_idempotent + retry_params_name: default + timeout_millis: 60000 + - name: ListModels + flattening: + groups: + - parameters: + - project_id + - dataset_id + - max_results + required_fields: + - project_id + - dataset_id + page_streaming: + request: + token_field: page_token + response: + token_field: next_page_token + resources_field: models + retry_codes_name: non_idempotent + retry_params_name: default + timeout_millis: 60000 + - name: PatchModel + flattening: + groups: + - parameters: + - project_id + - dataset_id + - model_id + - model + required_fields: + - project_id + - dataset_id + - model_id + - model + retry_codes_name: non_idempotent + retry_params_name: default + timeout_millis: 60000 + - name: DeleteModel + flattening: + groups: + - parameters: + - project_id + - dataset_id + - model_id + required_fields: + - project_id + - dataset_id + - model_id + retry_codes_name: non_idempotent + retry_params_name: default + timeout_millis: 60000 diff --git a/third_party/googleapis/google/cloud/bigquery/v2/bigquery_gapic.yaml b/third_party/googleapis/google/cloud/bigquery/v2/bigquery_gapic.yaml index de614d248..e9a219b6d 100644 --- a/third_party/googleapis/google/cloud/bigquery/v2/bigquery_gapic.yaml +++ b/third_party/googleapis/google/cloud/bigquery/v2/bigquery_gapic.yaml @@ -1,5 +1,5 @@ type: com.google.api.codegen.ConfigProto -config_schema_version: 1.0.0 +config_schema_version: 2.0.0 # The settings of generated code in a specific language. language_settings: java: @@ -16,160 +16,3 @@ language_settings: package_name: Google\Cloud\Bigquery\V2 nodejs: package_name: bigquery.v2 -# The configuration for the license header to put on generated files. -license_header: - # The file containing the copyright line(s). - copyright_file: copyright-google.txt - # The file containing the raw license header without any copyright line(s). - license_file: license-header-apache-2.0.txt -# A list of API interface configurations. -interfaces: -# The fully qualified name of the API interface. -- name: google.cloud.bigquery.v2.ModelService - # A list of resource collection configurations. - # Consists of a name_pattern and an entity_name. - # The name_pattern is a pattern to describe the names of the resources of this - # collection, using the platform's conventions for URI patterns. A generator - # may use this to generate methods to compose and decompose such names. The - # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; - # those will be taken as hints for the parameter names of the generated - # methods. If empty, no name methods are generated. - # The entity_name is the name to be used as a basis for generated methods and - # classes. - collections: [] - # Definition for retryable codes. - retry_codes_def: - - name: idempotent - retry_codes: - - DEADLINE_EXCEEDED - - UNAVAILABLE - - name: non_idempotent - retry_codes: [] - # Definition for retry/backoff parameters. - retry_params_def: - - name: default - initial_retry_delay_millis: 100 - retry_delay_multiplier: 1.3 - max_retry_delay_millis: 60000 - initial_rpc_timeout_millis: 20000 - rpc_timeout_multiplier: 1 - max_rpc_timeout_millis: 20000 - total_timeout_millis: 600000 - # A list of method configurations. - # Common properties: - # - # name - The simple name of the method. - # - # flattening - Specifies the configuration for parameter flattening. - # Describes the parameter groups for which a generator should produce method - # overloads which allow a client to directly pass request message fields as - # method parameters. This information may or may not be used, depending on - # the target language. - # Consists of groups, which each represent a list of parameters to be - # flattened. Each parameter listed must be a field of the request message. - # - # required_fields - Fields that are always required for a request to be - # valid. - # - # resource_name_treatment - An enum that specifies how to treat the resource - # name formats defined in the field_name_patterns and - # response_field_name_patterns fields. - # UNSET: default value - # NONE: the collection configs will not be used by the generated code. - # VALIDATE: string fields will be validated by the client against the - # specified resource name formats. - # STATIC_TYPES: the client will use generated types for resource names. - # - # page_streaming - Specifies the configuration for paging. - # Describes information for generating a method which transforms a paging - # list RPC into a stream of resources. - # Consists of a request and a response. - # The request specifies request information of the list method. It defines - # which fields match the paging pattern in the request. The request consists - # of a page_size_field and a token_field. The page_size_field is the name of - # the optional field specifying the maximum number of elements to be - # returned in the response. The token_field is the name of the field in the - # request containing the page token. - # The response specifies response information of the list method. It defines - # which fields match the paging pattern in the response. The response - # consists of a token_field and a resources_field. The token_field is the - # name of the field in the response containing the next page token. The - # resources_field is the name of the field in the response containing the - # list of resources belonging to the page. - # - # retry_codes_name - Specifies the configuration for retryable codes. The - # name must be defined in interfaces.retry_codes_def. - # - # retry_params_name - Specifies the configuration for retry/backoff - # parameters. The name must be defined in interfaces.retry_params_def. - # - # field_name_patterns - Maps the field name of the request type to - # entity_name of interfaces.collections. - # Specifies the string pattern that the field must follow. - # - # timeout_millis - Specifies the default timeout for a non-retrying call. If - # the call is retrying, refer to retry_params_name instead. - methods: - - name: GetModel - flattening: - groups: - - parameters: - - project_id - - dataset_id - - model_id - required_fields: - - project_id - - dataset_id - - model_id - retry_codes_name: non_idempotent - retry_params_name: default - timeout_millis: 60000 - - name: ListModels - flattening: - groups: - - parameters: - - project_id - - dataset_id - - max_results - required_fields: - - project_id - - dataset_id - page_streaming: - request: - token_field: page_token - response: - token_field: next_page_token - resources_field: models - retry_codes_name: non_idempotent - retry_params_name: default - timeout_millis: 60000 - - name: PatchModel - flattening: - groups: - - parameters: - - project_id - - dataset_id - - model_id - - model - required_fields: - - project_id - - dataset_id - - model_id - - model - retry_codes_name: non_idempotent - retry_params_name: default - timeout_millis: 60000 - - name: DeleteModel - flattening: - groups: - - parameters: - - project_id - - dataset_id - - model_id - required_fields: - - project_id - - dataset_id - - model_id - retry_codes_name: non_idempotent - retry_params_name: default - timeout_millis: 60000 diff --git a/third_party/googleapis/google/cloud/bigquery/v2/bigquery_grpc_service_config.json b/third_party/googleapis/google/cloud/bigquery/v2/bigquery_grpc_service_config.json new file mode 100755 index 000000000..9dcb0e879 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/v2/bigquery_grpc_service_config.json @@ -0,0 +1,25 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.bigquery.v2.ModelService", + "method": "GetModel" + }, + { + "service": "google.cloud.bigquery.v2.ModelService", + "method": "ListModels" + }, + { + "service": "google.cloud.bigquery.v2.ModelService", + "method": "PatchModel" + }, + { + "service": "google.cloud.bigquery.v2.ModelService", + "method": "DeleteModel" + } + ], + "timeout": "600s" + } + ] +} diff --git a/third_party/googleapis/google/cloud/bigquery/v2/bigquery_v2.yaml b/third_party/googleapis/google/cloud/bigquery/v2/bigquery_v2.yaml new file mode 100644 index 000000000..75c9634a7 --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/v2/bigquery_v2.yaml @@ -0,0 +1,37 @@ +type: google.api.Service +config_version: 2 +name: bigquery.googleapis.com +title: BigQuery API + +apis: +- name: google.cloud.bigquery.v2.ModelService + +documentation: + summary: 'A data platform for customers to create, manage, share and query data.' + +authentication: + rules: + - selector: google.cloud.bigquery.v2.ModelService.DeleteModel + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/bigquery, + https://www.googleapis.com/auth/cloud-platform + - selector: google.cloud.bigquery.v2.ModelService.GetModel + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/bigquery, + https://www.googleapis.com/auth/bigquery.readonly, + https://www.googleapis.com/auth/cloud-platform, + https://www.googleapis.com/auth/cloud-platform.read-only + - selector: google.cloud.bigquery.v2.ModelService.ListModels + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/bigquery, + https://www.googleapis.com/auth/bigquery.readonly, + https://www.googleapis.com/auth/cloud-platform, + https://www.googleapis.com/auth/cloud-platform.read-only + - selector: google.cloud.bigquery.v2.ModelService.PatchModel + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/bigquery, + https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/bigquery/v2/encryption_config.proto b/third_party/googleapis/google/cloud/bigquery/v2/encryption_config.proto new file mode 100644 index 000000000..54445f0fa --- /dev/null +++ b/third_party/googleapis/google/cloud/bigquery/v2/encryption_config.proto @@ -0,0 +1,33 @@ +// Copyright 2019 Google LLC. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// + +syntax = "proto3"; + +package google.cloud.bigquery.v2; + +import "google/api/field_behavior.proto"; +import "google/protobuf/wrappers.proto"; +import "google/api/annotations.proto"; + +option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/v2;bigquery"; +option java_outer_classname = "EncryptionConfigProto"; +option java_package = "com.google.cloud.bigquery.v2"; + +message EncryptionConfiguration { + // Optional. Describes the Cloud KMS encryption key that will be used to + // protect destination BigQuery table. The BigQuery Service Account associated + // with your project requires access to this encryption key. + google.protobuf.StringValue kms_key_name = 1 [(google.api.field_behavior) = OPTIONAL]; +} diff --git a/third_party/googleapis/google/cloud/bigquery/v2/model.proto b/third_party/googleapis/google/cloud/bigquery/v2/model.proto index 2b5b6894d..13d980774 100644 --- a/third_party/googleapis/google/cloud/bigquery/v2/model.proto +++ b/third_party/googleapis/google/cloud/bigquery/v2/model.proto @@ -17,13 +17,15 @@ syntax = "proto3"; package google.cloud.bigquery.v2; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/cloud/bigquery/v2/encryption_config.proto"; import "google/cloud/bigquery/v2/model_reference.proto"; import "google/cloud/bigquery/v2/standard_sql.proto"; import "google/protobuf/empty.proto"; import "google/protobuf/timestamp.proto"; import "google/protobuf/wrappers.proto"; import "google/api/annotations.proto"; -import "google/api/client.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/v2;bigquery"; option java_outer_classname = "ModelProto"; @@ -33,29 +35,52 @@ service ModelService { option (google.api.default_host) = "bigquery.googleapis.com"; option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/bigquery," + "https://www.googleapis.com/auth/bigquery.readonly," "https://www.googleapis.com/auth/cloud-platform," "https://www.googleapis.com/auth/cloud-platform.read-only"; // Gets the specified model resource by model ID. rpc GetModel(GetModelRequest) returns (Model) { + option (google.api.method_signature) = "project_id,dataset_id,model_id"; } // Lists all models in the specified dataset. Requires the READER dataset // role. rpc ListModels(ListModelsRequest) returns (ListModelsResponse) { + option (google.api.method_signature) = "project_id,dataset_id,max_results"; } // Patch specific fields in the specified model. rpc PatchModel(PatchModelRequest) returns (Model) { + option (google.api.method_signature) = "project_id,dataset_id,model_id,model"; } // Deletes the model specified by modelId from the dataset. rpc DeleteModel(DeleteModelRequest) returns (google.protobuf.Empty) { + option (google.api.method_signature) = "project_id,dataset_id,model_id"; } } message Model { - // Evaluation metrics for regression models. + message KmeansEnums { + // Indicates the method used to initialize the centroids for KMeans + // clustering algorithm. + enum KmeansInitializationMethod { + KMEANS_INITIALIZATION_METHOD_UNSPECIFIED = 0; + + // Initializes the centroids randomly. + RANDOM = 1; + + // Initializes the centroids using data specified in + // kmeans_initialization_column. + CUSTOM = 2; + } + + + } + + // Evaluation metrics for regression and explicit feedback type matrix + // factorization models. message RegressionMetrics { // Mean absolute error. google.protobuf.DoubleValue mean_absolute_error = 1; @@ -199,11 +224,60 @@ message Model { // Evaluation metrics for clustering models. message ClusteringMetrics { + // Message containing the information about one cluster. + message Cluster { + // Representative value of a single feature within the cluster. + message FeatureValue { + // Representative value of a categorical feature. + message CategoricalValue { + // Represents the count of a single category within the cluster. + message CategoryCount { + // The name of category. + string category = 1; + + // The count of training samples matching the category within the + // cluster. + google.protobuf.Int64Value count = 2; + } + + // Counts of all categories for the categorical feature. If there are + // more than ten categories, we return top ten (by count) and return + // one more CategoryCount with category "_OTHER_" and count as + // aggregate counts of remaining categories. + repeated CategoryCount category_counts = 1; + } + + // The feature column name. + string feature_column = 1; + + oneof value { + // The numerical feature value. This is the centroid value for this + // feature. + google.protobuf.DoubleValue numerical_value = 2; + + // The categorical feature value. + CategoricalValue categorical_value = 3; + } + } + + // Centroid id. + int64 centroid_id = 1; + + // Values of highly variant features for this cluster. + repeated FeatureValue feature_values = 2; + + // Count of training data rows that were assigned to this cluster. + google.protobuf.Int64Value count = 3; + } + // Davies-Bouldin index. google.protobuf.DoubleValue davies_bouldin_index = 1; // Mean of squared distances between each sample to its cluster centroid. google.protobuf.DoubleValue mean_squared_distance = 2; + + // [Beta] Information for all clusters. + repeated Cluster clusters = 3; } // Evaluation metrics of a model. These are either computed on all training @@ -211,7 +285,8 @@ message Model { // training. These are not present for imported models. message EvaluationMetrics { oneof metrics { - // Populated for regression models. + // Populated for regression models and explicit feedback type matrix + // factorization models. RegressionMetrics regression_metrics = 1; // Populated for binary classification/classifier models. @@ -220,7 +295,7 @@ message Model { // Populated for multi-class classification/classifier models. MultiClassClassificationMetrics multi_class_classification_metrics = 3; - // [Beta] Populated for clustering models. + // Populated for clustering models. ClusteringMetrics clustering_metrics = 4; } } @@ -292,10 +367,10 @@ message Model { // training data. Only applicable for classification models. map label_class_weights = 17; - // [Beta] Distance type for clustering models. + // Distance type for clustering models. DistanceType distance_type = 20; - // [Beta] Number of clusters for clustering models. + // Number of clusters for clustering models. int64 num_clusters = 21; // [Beta] Google Cloud Storage URI from which the model was imported. Only @@ -304,6 +379,13 @@ message Model { // Optimization strategy for training linear regression models. OptimizationStrategy optimization_strategy = 23; + + // The method used to initialize the centroids for kmeans algorithm. + KmeansEnums.KmeansInitializationMethod kmeans_initialization_method = 33; + + // The column used to provide the initial centroids for kmeans algorithm + // when kmeans_initialization_method is CUSTOM. + string kmeans_initialization_column = 34; } // Information about a single iteration of the training run. @@ -336,7 +418,7 @@ message Model { // Learn rate used for this iteration. double learn_rate = 7; - // [Beta] Information about top clusters for clustering models. + // Information about top clusters for clustering models. repeated ClusterInfo cluster_infos = 8; } @@ -365,7 +447,7 @@ message Model { // Logistic regression based classification model. LOGISTIC_REGRESSION = 2; - // [Beta] K-means clustering model. + // K-means clustering model. KMEANS = 3; // [Beta] An imported TensorFlow model. @@ -438,105 +520,108 @@ message Model { } // Output only. A hash of this resource. - string etag = 1; + string etag = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Required. Unique identifier for this model. - ModelReference model_reference = 2; + ModelReference model_reference = 2 [(google.api.field_behavior) = REQUIRED]; - // Output only. The time when this model was created, in millisecs since the - // epoch. - int64 creation_time = 5; + // Output only. The time when this model was created, in millisecs since the epoch. + int64 creation_time = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Output only. The time when this model was last modified, in millisecs - // since the epoch. - int64 last_modified_time = 6; + // Output only. The time when this model was last modified, in millisecs since the epoch. + int64 last_modified_time = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // [Optional] A user-friendly description of this model. - string description = 12; + // Optional. A user-friendly description of this model. + string description = 12 [(google.api.field_behavior) = OPTIONAL]; - // [Optional] A descriptive name for this model. - string friendly_name = 14; + // Optional. A descriptive name for this model. + string friendly_name = 14 [(google.api.field_behavior) = OPTIONAL]; - // [Optional] The labels associated with this model. You can use these to - // organize and group your models. Label keys and values can be no longer + // The labels associated with this model. You can use these to organize + // and group your models. Label keys and values can be no longer // than 63 characters, can only contain lowercase letters, numeric // characters, underscores and dashes. International characters are allowed. // Label values are optional. Label keys must start with a letter and each // label in the list must have a different key. map labels = 15; - // [Optional] The time when this model expires, in milliseconds since the - // epoch. If not present, the model will persist indefinitely. Expired models + // Optional. The time when this model expires, in milliseconds since the epoch. + // If not present, the model will persist indefinitely. Expired models // will be deleted and their storage reclaimed. The defaultTableExpirationMs // property of the encapsulating dataset can be used to set a default // expirationTime on newly created models. - int64 expiration_time = 16; + int64 expiration_time = 16 [(google.api.field_behavior) = OPTIONAL]; // Output only. The geographic location where the model resides. This value // is inherited from the dataset. - string location = 13; + string location = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Custom encryption configuration (e.g., Cloud KMS keys). This shows the + // encryption configuration of the model data while stored in BigQuery + // storage. + google.cloud.bigquery.v2.EncryptionConfiguration encryption_configuration = 17; // Output only. Type of the model resource. - ModelType model_type = 7; + ModelType model_type = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Output only. Information for all training runs in increasing order of - // start_time. - repeated TrainingRun training_runs = 9; + // Output only. Information for all training runs in increasing order of start_time. + repeated TrainingRun training_runs = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Input feature columns that were used to train this model. - repeated StandardSqlField feature_columns = 10; + repeated StandardSqlField feature_columns = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Label columns that were used to train this model. // The output of the model will have a "predicted_" prefix to these columns. - repeated StandardSqlField label_columns = 11; + repeated StandardSqlField label_columns = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; } message GetModelRequest { - // Project ID of the requested model. - string project_id = 1; + // Required. Project ID of the requested model. + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Dataset ID of the requested model. - string dataset_id = 2; + // Required. Dataset ID of the requested model. + string dataset_id = 2 [(google.api.field_behavior) = REQUIRED]; - // Model ID of the requested model. - string model_id = 3; + // Required. Model ID of the requested model. + string model_id = 3 [(google.api.field_behavior) = REQUIRED]; } message PatchModelRequest { - // Project ID of the model to patch. - string project_id = 1; + // Required. Project ID of the model to patch. + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Dataset ID of the model to patch. - string dataset_id = 2; + // Required. Dataset ID of the model to patch. + string dataset_id = 2 [(google.api.field_behavior) = REQUIRED]; - // Model ID of the model to patch. - string model_id = 3; + // Required. Model ID of the model to patch. + string model_id = 3 [(google.api.field_behavior) = REQUIRED]; - // Patched model. - // Follows patch semantics. Missing fields are not updated. To clear a field, - // explicitly set to default value. - Model model = 4; + // Required. Patched model. + // Follows RFC5789 patch semantics. Missing fields are not updated. + // To clear a field, explicitly set to default value. + Model model = 4 [(google.api.field_behavior) = REQUIRED]; } message DeleteModelRequest { - // Project ID of the model to delete. - string project_id = 1; + // Required. Project ID of the model to delete. + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Dataset ID of the model to delete. - string dataset_id = 2; + // Required. Dataset ID of the model to delete. + string dataset_id = 2 [(google.api.field_behavior) = REQUIRED]; - // Model ID of the model to delete. - string model_id = 3; + // Required. Model ID of the model to delete. + string model_id = 3 [(google.api.field_behavior) = REQUIRED]; } message ListModelsRequest { - // Project ID of the models to list. - string project_id = 1; + // Required. Project ID of the models to list. + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Dataset ID of the models to list. - string dataset_id = 2; + // Required. Dataset ID of the models to list. + string dataset_id = 2 [(google.api.field_behavior) = REQUIRED]; - // The maximum number of results per page. + // The maximum number of results to return in a single response page. + // Leverage the page tokens to iterate through the entire collection. google.protobuf.UInt32Value max_results = 3; // Page token, returned by a previous call to request the next page of diff --git a/third_party/googleapis/google/cloud/bigquery/v2/model_reference.proto b/third_party/googleapis/google/cloud/bigquery/v2/model_reference.proto index f436659ab..fadd17514 100644 --- a/third_party/googleapis/google/cloud/bigquery/v2/model_reference.proto +++ b/third_party/googleapis/google/cloud/bigquery/v2/model_reference.proto @@ -17,6 +17,7 @@ syntax = "proto3"; package google.cloud.bigquery.v2; +import "google/api/field_behavior.proto"; import "google/api/annotations.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/v2;bigquery"; @@ -25,14 +26,14 @@ option java_package = "com.google.cloud.bigquery.v2"; // Id path of a model. message ModelReference { - // [Required] The ID of the project containing this model. - string project_id = 1; + // Required. The ID of the project containing this model. + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // [Required] The ID of the dataset containing this model. - string dataset_id = 2; + // Required. The ID of the dataset containing this model. + string dataset_id = 2 [(google.api.field_behavior) = REQUIRED]; - // [Required] The ID of the model. The ID must contain only + // Required. The ID of the model. The ID must contain only // letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum // length is 1,024 characters. - string model_id = 3; + string model_id = 3 [(google.api.field_behavior) = REQUIRED]; } diff --git a/third_party/googleapis/google/cloud/bigquery/v2/standard_sql.proto b/third_party/googleapis/google/cloud/bigquery/v2/standard_sql.proto index 98173092f..ff69dfc4e 100644 --- a/third_party/googleapis/google/cloud/bigquery/v2/standard_sql.proto +++ b/third_party/googleapis/google/cloud/bigquery/v2/standard_sql.proto @@ -17,6 +17,7 @@ syntax = "proto3"; package google.cloud.bigquery.v2; +import "google/api/field_behavior.proto"; import "google/api/annotations.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/bigquery/v2;bigquery"; @@ -82,7 +83,7 @@ message StandardSqlDataType { // Required. The top level type of this field. // Can be any standard SQL data type (e.g., "INT64", "DATE", "ARRAY"). - TypeKind type_kind = 1; + TypeKind type_kind = 1 [(google.api.field_behavior) = REQUIRED]; oneof sub_type { // The type of the array's elements, if type_kind = "ARRAY". @@ -96,12 +97,12 @@ message StandardSqlDataType { // A field or a column. message StandardSqlField { // Optional. The name of this field. Can be absent for struct fields. - string name = 1; + string name = 1 [(google.api.field_behavior) = OPTIONAL]; // Optional. The type of this parameter. Absent if not explicitly // specified (e.g., CREATE FUNCTION statement can omit the return type; // in this case the output parameter does not have this "type" field). - StandardSqlDataType type = 2; + StandardSqlDataType type = 2 [(google.api.field_behavior) = OPTIONAL]; } message StandardSqlStructType { diff --git a/third_party/googleapis/google/cloud/videointelligence/artman_videointelligence_v1beta1.yaml b/third_party/googleapis/google/cloud/billing/budgets/artman_billingbudgets_v1beta1.yaml similarity index 78% rename from third_party/googleapis/google/cloud/videointelligence/artman_videointelligence_v1beta1.yaml rename to third_party/googleapis/google/cloud/billing/budgets/artman_billingbudgets_v1beta1.yaml index 2f1f114a6..0c5105edd 100644 --- a/third_party/googleapis/google/cloud/videointelligence/artman_videointelligence_v1beta1.yaml +++ b/third_party/googleapis/google/cloud/billing/budgets/artman_billingbudgets_v1beta1.yaml @@ -1,35 +1,34 @@ common: - api_name: video-intelligence + api_name: billingbudgets api_version: v1beta1 organization_name: google-cloud - service_yaml: videointelligence_v1beta1.yaml - gapic_yaml: v1beta1/videointelligence_gapic.yaml - src_proto_paths: - - v1beta1 proto_deps: - name: google-common-protos + src_proto_paths: + - v1beta1 + service_yaml: v1beta1/billingbudgets.yaml + gapic_yaml: v1beta1/billingbudgets_gapic.yaml artifacts: +- name: gapic_config + type: GAPIC_CONFIG - name: java_gapic type: GAPIC language: JAVA - name: python_gapic type: GAPIC language: PYTHON +- name: nodejs_gapic + type: GAPIC + language: NODEJS - name: php_gapic type: GAPIC language: PHP -- name: ruby_gapic - type: GAPIC - language: RUBY - name: go_gapic type: GAPIC language: GO +- name: ruby_gapic + type: GAPIC + language: RUBY - name: csharp_gapic type: GAPIC language: CSHARP -- name: nodejs_gapic - type: GAPIC - language: NODEJS - release_level: BETA -- name: gapic_config - type: GAPIC_CONFIG diff --git a/third_party/googleapis/google/cloud/billing/budgets/v1alpha1/BUILD.bazel b/third_party/googleapis/google/cloud/billing/budgets/v1alpha1/BUILD.bazel new file mode 100644 index 000000000..4f1148a00 --- /dev/null +++ b/third_party/googleapis/google/cloud/billing/budgets/v1alpha1/BUILD.bazel @@ -0,0 +1,176 @@ +# This file was automatically generated by BuildFileGenerator + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") + +proto_library( + name = "budgets_proto", + srcs = [ + "budget_model.proto", + "budget_service.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/type:money_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_grpc_library", + "java_proto_library", +) + +java_proto_library( + name = "budgets_java_proto", + deps = [":budgets_proto"], +) + +java_grpc_library( + name = "budgets_java_grpc", + srcs = [":budgets_proto"], + deps = [":budgets_java_proto"], +) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_proto_library", +) + +go_proto_library( + name = "budgets_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/cloud/billing/budgets/v1alpha1", + protos = [":budgets_proto"], + deps = [ + "//google/api:annotations_go_proto", + "//google/type:money_go_proto", + ], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "budgets_moved_proto", + srcs = [":budgets_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/type:money_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + ], +) + +py_proto_library( + name = "budgets_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":budgets_moved_proto"], +) + +py_grpc_library( + name = "budgets_py_grpc", + srcs = [":budgets_moved_proto"], + deps = [":budgets_py_proto"], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "budgets_php_proto", + deps = [":budgets_proto"], +) + +php_grpc_library( + name = "budgets_php_grpc", + srcs = [":budgets_proto"], + deps = [":budgets_php_proto"], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "budgets_ruby_proto", + deps = [":budgets_proto"], +) + +ruby_grpc_library( + name = "budgets_ruby_grpc", + srcs = [":budgets_proto"], + deps = [":budgets_ruby_proto"], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "budgets_csharp_proto", + deps = [":budgets_proto"], +) + +csharp_grpc_library( + name = "budgets_csharp_grpc", + srcs = [":budgets_proto"], + deps = [":budgets_csharp_proto"], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ code here diff --git a/third_party/googleapis/google/cloud/billing/budgets/v1alpha1/billingbudgets.yaml b/third_party/googleapis/google/cloud/billing/budgets/v1alpha1/billingbudgets.yaml new file mode 100644 index 000000000..72accd265 --- /dev/null +++ b/third_party/googleapis/google/cloud/billing/budgets/v1alpha1/billingbudgets.yaml @@ -0,0 +1,20 @@ +type: google.api.Service +config_version: 3 +name: billingbudgets.googleapis.com +title: Cloud Billing Budget API + +apis: +- name: google.cloud.billing.budgets.v1alpha1.BudgetService + +documentation: + summary: |- + The Cloud Billing Budget API stores Cloud Billing budgets, which define a + budget plan and the rules to execute as spend is tracked against that + plan. + +authentication: + rules: + - selector: 'google.cloud.billing.budgets.v1alpha1.BudgetService.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/billing/budgets/v1alpha1/billingbudgets_grpc_service_config.json b/third_party/googleapis/google/cloud/billing/budgets/v1alpha1/billingbudgets_grpc_service_config.json new file mode 100644 index 000000000..63dddd879 --- /dev/null +++ b/third_party/googleapis/google/cloud/billing/budgets/v1alpha1/billingbudgets_grpc_service_config.json @@ -0,0 +1,44 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.billing.budgets.v1alpha1.BudgetService", + "method": "CreateBudget" + } + ], + "timeout": "60s" + }, + { + "name": [ + { + "service": "google.cloud.billing.budgets.v1alpha1.BudgetService", + "method": "UpdateBudget" + }, + { + "service": "google.cloud.billing.budgets.v1alpha1.BudgetService", + "method": "GetBudget" + }, + { + "service": "google.cloud.billing.budgets.v1alpha1.BudgetService", + "method": "ListBudgets" + }, + { + "service": "google.cloud.billing.budgets.v1alpha1.BudgetService", + "method": "DeleteBudget" + } + ], + "timeout": "60s", + "retryPolicy": { + "maxAttempts": 5, + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/cloud/billing/budgets/v1alpha1/budget_model.proto b/third_party/googleapis/google/cloud/billing/budgets/v1alpha1/budget_model.proto new file mode 100644 index 000000000..c3d907b2c --- /dev/null +++ b/third_party/googleapis/google/cloud/billing/budgets/v1alpha1/budget_model.proto @@ -0,0 +1,179 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.billing.budgets.v1alpha1; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/type/money.proto"; + +option go_package = "google.golang.org/genproto/googleapis/cloud/billing/budgets/v1alpha1;budgets"; +option java_multiple_files = true; +option java_package = "com.google.cloud.billing.budgets.v1alpha1"; + +// A budget is a plan that describes what you expect to spend on Cloud +// projects, plus the rules to execute as spend is tracked against that plan, +// (for example, send an alert when 90% of the target spend is met). +// Currently all plans are monthly budgets so the usage period(s) tracked are +// implied (calendar months of usage back-to-back). +message Budget { + option (google.api.resource) = { + type: "billingbudgets.googleapis.com/Budget" + pattern: "billingAccounts/{billing_account}/budgets/{budget}" + }; + + // Output only. Resource name of the budget. + // The resource name implies the scope of a budget. Values are of the form + // `billingAccounts/{billingAccountId}/budgets/{budgetId}`. + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // User data for display name in UI. + // Validation: <= 60 chars. + string display_name = 2; + + // Optional. Filters that define which resources are used to compute + // the actual spend against the budget. + Filter budget_filter = 3 [(google.api.field_behavior) = OPTIONAL]; + + // Required. Budgeted amount. + BudgetAmount amount = 4 [(google.api.field_behavior) = REQUIRED]; + + // Optional. Rules that trigger alerts (notifications of thresholds + // being crossed) when spend exceeds the specified percentages of the budget. + repeated ThresholdRule threshold_rules = 5 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Rules to apply to all updates to the actual spend, regardless + // of the thresholds set in `threshold_rules`. + AllUpdatesRule all_updates_rule = 6 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Etag to validate that the object is unchanged for a + // read-modify-write operation. + // An empty etag will cause an update to overwrite other changes. + string etag = 7 [(google.api.field_behavior) = OPTIONAL]; +} + +// The budgeted amount for each usage period. +message BudgetAmount { + // Specification for what amount to use as the budget. + oneof budget_amount { + // A specified amount to use as the budget. + // `currency_code` is optional. If specified, it must match the + // currency of the billing account. The `currency_code` is provided on + // output. + google.type.Money specified_amount = 1; + + // Use the last period's actual spend as the budget for the present period. + LastPeriodAmount last_period_amount = 2; + } +} + +// Describes a budget amount targeted to last period's spend. +// At this time, the amount is automatically 100% of last period's spend; +// that is, there are no other options yet. +// Future configuration will be described here (for example, configuring a +// percentage of last period's spend). +message LastPeriodAmount { + +} + +// ThresholdRule contains a definition of a threshold which triggers +// an alert (a notification of a threshold being crossed) to be sent when +// spend goes above the specified amount. +// Alerts are automatically e-mailed to users with the Billing Account +// Administrator role or the Billing Account User role. +// The thresholds here have no effect on notifications sent to anything +// configured under `Budget.all_updates_rule`. +message ThresholdRule { + // The type of basis used to determine if spend has passed the threshold. + enum Basis { + // Unspecified threshold basis. + BASIS_UNSPECIFIED = 0; + + // Use current spend as the basis for comparison against the threshold. + CURRENT_SPEND = 1; + + // Use forecasted spend for the period as the basis for comparison against + // the threshold. + FORECASTED_SPEND = 2; + } + + // Required. Send an alert when this threshold is exceeded. + // This is a 1.0-based percentage, so 0.5 = 50%. + // Validation: non-negative number. + double threshold_percent = 1 [(google.api.field_behavior) = REQUIRED]; + + // Optional. The type of basis used to determine if spend has passed the + // threshold. Behavior defaults to CURRENT_SPEND if not set. + Basis spend_basis = 2 [(google.api.field_behavior) = OPTIONAL]; +} + +// AllUpdatesRule defines notifications that are sent on every update to the +// billing account's spend, regardless of the thresholds defined using +// threshold rules. +message AllUpdatesRule { + // Required. The name of the Cloud Pub/Sub topic where budget related messages will be + // published, in the form `projects/{project_id}/topics/{topic_id}`. Updates + // are sent at regular intervals to the topic. + // The topic needs to be created before the budget is created; see + // https://cloud.google.com/billing/docs/how-to/budgets#manage-notifications + // for more details. + // Caller is expected to have + // `pubsub.topics.setIamPolicy` permission on the topic when it's set for a + // budget, otherwise, the API call will fail with PERMISSION_DENIED. See + // https://cloud.google.com/pubsub/docs/access-control for more details on + // Pub/Sub roles and permissions. + string pubsub_topic = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The schema version of the notification. + // Only "1.0" is accepted. It represents the JSON schema as defined in + // https://cloud.google.com/billing/docs/how-to/budgets#notification_format + string schema_version = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// A filter for a budget, limiting the scope of the cost to calculate. +message Filter { + // Specifies how credits should be treated when determining spend for + // threshold calculations. + enum CreditTypesTreatment { + CREDIT_TYPES_TREATMENT_UNSPECIFIED = 0; + + // All types of credit are subtracted from the gross cost to determine the + // spend for threshold calculations. + INCLUDE_ALL_CREDITS = 1; + + // All types of credit are added to the net cost to determine the spend for + // threshold calculations. + EXCLUDE_ALL_CREDITS = 2; + } + + // Optional. A set of projects of the form `projects/{project}`, + // specifying that usage from only this set of projects should be + // included in the budget. If omitted, the report will include all usage for + // the billing account, regardless of which project the usage occurred on. + // Only zero or one project can be specified currently. + repeated string projects = 1 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. If not set, default behavior is `INCLUDE_ALL_CREDITS`. + CreditTypesTreatment credit_types_treatment = 4 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. A set of services of the form `services/{service_id}`, + // specifying that usage from only this set of services should be + // included in the budget. If omitted, the report will include usage for + // all the services. + // The service names are available through the Catalog API: + // https://cloud.google.com/billing/v1/how-tos/catalog-api. + repeated string services = 3 [(google.api.field_behavior) = OPTIONAL]; +} diff --git a/third_party/googleapis/google/cloud/billing/budgets/v1alpha1/budget_service.proto b/third_party/googleapis/google/cloud/billing/budgets/v1alpha1/budget_service.proto new file mode 100644 index 000000000..1efd1441c --- /dev/null +++ b/third_party/googleapis/google/cloud/billing/budgets/v1alpha1/budget_service.proto @@ -0,0 +1,174 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.billing.budgets.v1alpha1; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/cloud/billing/budgets/v1alpha1/budget_model.proto"; +import "google/protobuf/empty.proto"; +import "google/protobuf/field_mask.proto"; + +option go_package = "google.golang.org/genproto/googleapis/cloud/billing/budgets/v1alpha1;budgets"; +option java_multiple_files = true; +option java_package = "com.google.cloud.billing.budgets.v1alpha1"; + +// BudgetService stores Cloud Billing budgets, which define a +// budget plan and rules to execute as we track spend against that plan. +service BudgetService { + option (google.api.default_host) = "billingbudgets.googleapis.com"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; + + // Creates a new budget. See + // Quotas and limits + // for more information on the limits of the number of budgets you can create. + rpc CreateBudget(CreateBudgetRequest) returns (Budget) { + option (google.api.http) = { + post: "/v1alpha1/{parent=billingAccounts/*}/budgets" + body: "*" + }; + } + + // Updates a budget and returns the updated budget. + // + // WARNING: There are some fields exposed on the Google Cloud Console that + // aren't available on this API. Budget fields that are not exposed in + // this API will not be changed by this method. + rpc UpdateBudget(UpdateBudgetRequest) returns (Budget) { + option (google.api.http) = { + patch: "/v1alpha1/{budget.name=billingAccounts/*/budgets/*}" + body: "*" + }; + } + + // Returns a budget. + // + // WARNING: There are some fields exposed on the Google Cloud Console that + // aren't available on this API. When reading from the API, you will not + // see these fields in the return value, though they may have been set + // in the Cloud Console. + rpc GetBudget(GetBudgetRequest) returns (Budget) { + option (google.api.http) = { + get: "/v1alpha1/{name=billingAccounts/*/budgets/*}" + }; + } + + // Returns a list of budgets for a billing account. + // + // WARNING: There are some fields exposed on the Google Cloud Console that + // aren't available on this API. When reading from the API, you will not + // see these fields in the return value, though they may have been set + // in the Cloud Console. + rpc ListBudgets(ListBudgetsRequest) returns (ListBudgetsResponse) { + option (google.api.http) = { + get: "/v1alpha1/{parent=billingAccounts/*}/budgets" + }; + } + + // Deletes a budget. Returns successfully if already deleted. + rpc DeleteBudget(DeleteBudgetRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1alpha1/{name=billingAccounts/*/budgets/*}" + }; + } +} + +// Request for CreateBudget +message CreateBudgetRequest { + // Required. The name of the billing account to create the budget in. Values + // are of the form `billingAccounts/{billingAccountId}`. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "billingbudgets.googleapis.com/Budget" + } + ]; + + // Required. Budget to create. + Budget budget = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// Request for UpdateBudget +message UpdateBudgetRequest { + // Required. The updated budget object. + // The budget to update is specified by the budget name in the budget. + Budget budget = 1 [(google.api.field_behavior) = REQUIRED]; + + // Optional. Indicates which fields in the provided budget to update. + // Read-only fields (such as `name`) cannot be changed. If this is not + // provided, then only fields with non-default values from the request are + // updated. See + // https://developers.google.com/protocol-buffers/docs/proto3#default for more + // details about default values. + google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = OPTIONAL]; +} + +// Request for GetBudget +message GetBudgetRequest { + // Required. Name of budget to get. Values are of the form + // `billingAccounts/{billingAccountId}/budgets/{budgetId}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "billingbudgets.googleapis.com/Budget" + } + ]; +} + +// Request for ListBudgets +message ListBudgetsRequest { + // Required. Name of billing account to list budgets under. Values + // are of the form `billingAccounts/{billingAccountId}`. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "billingbudgets.googleapis.com/Budget" + } + ]; + + // Optional. The maximum number of budgets to return per page. + // The default and maximum value are 100. + int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The value returned by the last `ListBudgetsResponse` which + // indicates that this is a continuation of a prior `ListBudgets` call, + // and that the system should return the next page of data. + string page_token = 3 [(google.api.field_behavior) = OPTIONAL]; +} + +// Response for ListBudgets +message ListBudgetsResponse { + // List of the budgets owned by the requested billing account. + repeated Budget budgets = 1; + + // If not empty, indicates that there may be more budgets that match the + // request; this value should be passed in a new `ListBudgetsRequest`. + string next_page_token = 2; +} + +// Request for DeleteBudget +message DeleteBudgetRequest { + // Required. Name of the budget to delete. Values are of the form + // `billingAccounts/{billingAccountId}/budgets/{budgetId}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "billingbudgets.googleapis.com/Budget" + } + ]; +} diff --git a/third_party/googleapis/google/cloud/billing/budgets/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/billing/budgets/v1beta1/BUILD.bazel new file mode 100644 index 000000000..35970baab --- /dev/null +++ b/third_party/googleapis/google/cloud/billing/budgets/v1beta1/BUILD.bazel @@ -0,0 +1,364 @@ +# This file was automatically generated by BuildFileGenerator + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") +load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") + +proto_library( + name = "budgets_proto", + srcs = [ + "budget_model.proto", + "budget_service.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/type:money_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + ], +) + +proto_library_with_info( + name = "budgets_proto_with_info", + deps = [ + ":budgets_proto", + "//google/cloud:common_resources_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", + "java_proto_library", +) + +java_proto_library( + name = "budgets_java_proto", + deps = [":budgets_proto"], +) + +java_grpc_library( + name = "budgets_java_grpc", + srcs = [":budgets_proto"], + deps = [":budgets_java_proto"], +) + +java_gapic_library( + name = "budgets_java_gapic", + src = ":budgets_proto_with_info", + gapic_yaml = "billingbudgets_gapic.yaml", + package = "google.cloud.billing.budgets.v1beta1", + service_yaml = "billingbudgets.yaml", + test_deps = [ + ":budgets_java_grpc", + ], + deps = [ + ":budgets_java_proto", + ], +) + +java_gapic_test( + name = "budgets_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.billing.budgets.v1beta1.BudgetServiceClientTest", + ], + runtime_deps = [":budgets_java_gapic_test"], +) + +# Open Source Packages +java_gapic_assembly_gradle_pkg( + name = "google-cloud-billing-budgets-v1beta1-java", + deps = [ + ":budgets_java_gapic", + ":budgets_java_grpc", + ":budgets_java_proto", + ":budgets_proto", + ], +) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", + "go_proto_library", + "go_test", +) + +go_proto_library( + name = "budgets_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/cloud/billing/budgets/v1beta1", + protos = [":budgets_proto"], + deps = [ + "//google/api:annotations_go_proto", + "//google/type:money_go_proto", + ], +) + +go_gapic_library( + name = "budgets_go_gapic", + srcs = [":budgets_proto_with_info"], + grpc_service_config = "billingbudgets_grpc_service_config.json", + importpath = "cloud.google.com/go/billing/budgets/apiv1beta1;budgets", + service_yaml = "billingbudgets.yaml", + deps = [ + ":budgets_go_proto", + ], +) + +go_test( + name = "budgets_go_gapic_test", + srcs = [":budgets_go_gapic_srcjar_test"], + embed = [":budgets_go_gapic"], + importpath = "cloud.google.com/go/billing/budgets/apiv1beta1", +) + +# Open Source Packages +go_gapic_assembly_pkg( + name = "gapi-cloud-billing-budgets-v1beta1-go", + deps = [ + ":budgets_go_gapic", + ":budgets_go_gapic_srcjar-test.srcjar", + ":budgets_go_proto", + ], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "budgets_moved_proto", + srcs = [":budgets_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/type:money_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + ], +) + +py_proto_library( + name = "budgets_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":budgets_moved_proto"], +) + +py_grpc_library( + name = "budgets_py_grpc", + srcs = [":budgets_moved_proto"], + deps = [":budgets_py_proto"], +) + +py_gapic_library( + name = "budgets_py_gapic", + src = ":budgets_proto_with_info", + gapic_yaml = "billingbudgets_gapic.yaml", + package = "google.cloud.billing.budgets.v1beta1", + service_yaml = "billingbudgets.yaml", + deps = [ + ":budgets_py_grpc", + ":budgets_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "billing-budgets-v1beta1-py", + deps = [ + ":budgets_py_gapic", + ":budgets_py_grpc", + ":budgets_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "budgets_php_proto", + deps = [":budgets_proto"], +) + +php_grpc_library( + name = "budgets_php_grpc", + srcs = [":budgets_proto"], + deps = [":budgets_php_proto"], +) + +php_gapic_library( + name = "budgets_php_gapic", + src = ":budgets_proto_with_info", + gapic_yaml = "billingbudgets_gapic.yaml", + package = "google.cloud.billing.budgets.v1beta1", + service_yaml = "billingbudgets.yaml", + deps = [ + ":budgets_php_grpc", + ":budgets_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-billing-budgets-v1beta1-php", + deps = [ + ":budgets_php_gapic", + ":budgets_php_grpc", + ":budgets_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "budgets_nodejs_gapic", + src = ":budgets_proto_with_info", + gapic_yaml = "billingbudgets_gapic.yaml", + package = "google.cloud.billing.budgets.v1beta1", + service_yaml = "billingbudgets.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "billing-budgets-v1beta1-nodejs", + deps = [ + ":budgets_nodejs_gapic", + ":budgets_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "budgets_ruby_proto", + deps = [":budgets_proto"], +) + +ruby_grpc_library( + name = "budgets_ruby_grpc", + srcs = [":budgets_proto"], + deps = [":budgets_ruby_proto"], +) + +ruby_gapic_library( + name = "budgets_ruby_gapic", + src = ":budgets_proto_with_info", + gapic_yaml = "billingbudgets_gapic.yaml", + package = "google.cloud.billing.budgets.v1beta1", + service_yaml = "billingbudgets.yaml", + deps = [ + ":budgets_ruby_grpc", + ":budgets_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-billing-budgets-v1beta1-ruby", + deps = [ + ":budgets_ruby_gapic", + ":budgets_ruby_grpc", + ":budgets_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "budgets_csharp_proto", + deps = [":budgets_proto"], +) + +csharp_grpc_library( + name = "budgets_csharp_grpc", + srcs = [":budgets_proto"], + deps = [":budgets_csharp_proto"], +) + +csharp_gapic_library( + name = "budgets_csharp_gapic", + src = ":budgets_proto_with_info", + gapic_yaml = "billingbudgets_gapic.yaml", + package = "google.cloud.billing.budgets.v1beta1", + service_yaml = "billingbudgets.yaml", + deps = [ + ":budgets_csharp_grpc", + ":budgets_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-billing-budgets-v1beta1-csharp", + deps = [ + ":budgets_csharp_gapic", + ":budgets_csharp_grpc", + ":budgets_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/cloud/billing/budgets/v1beta1/billingbudgets.yaml b/third_party/googleapis/google/cloud/billing/budgets/v1beta1/billingbudgets.yaml new file mode 100644 index 000000000..01ae424dc --- /dev/null +++ b/third_party/googleapis/google/cloud/billing/budgets/v1beta1/billingbudgets.yaml @@ -0,0 +1,20 @@ +type: google.api.Service +config_version: 3 +name: billingbudgets.googleapis.com +title: Cloud Billing Budget API + +apis: +- name: google.cloud.billing.budgets.v1beta1.BudgetService + +documentation: + summary: |- + The Cloud Billing Budget API stores Cloud Billing budgets, which define a + budget plan and the rules to execute as spend is tracked against that + plan. + +authentication: + rules: + - selector: 'google.cloud.billing.budgets.v1beta1.BudgetService.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/billing/budgets/v1beta1/billingbudgets_gapic.yaml b/third_party/googleapis/google/cloud/billing/budgets/v1beta1/billingbudgets_gapic.yaml new file mode 100644 index 000000000..2829c873e --- /dev/null +++ b/third_party/googleapis/google/cloud/billing/budgets/v1beta1/billingbudgets_gapic.yaml @@ -0,0 +1,70 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 2.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.billing.budgets.v1beta1 + python: + package_name: google.cloud.billing_budgets_v1beta1.gapic + go: + package_name: cloud.google.com/go/billing/budgets/apiv1beta1 + csharp: + package_name: Google.Cloud.Billing.Budgets.V1Beta1 + ruby: + package_name: Google::Cloud::Billing::Budgets::V1beta1 + php: + package_name: Google\Cloud\Billing\Budgets\V1beta1 + nodejs: + package_name: billing-budgets.v1beta1 + domain_layer_location: google-cloud +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.cloud.billing.budgets.v1beta1.BudgetService + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - DEADLINE_EXCEEDED + - UNAVAILABLE + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # + # name - The simple name of the method. + # + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: CreateBudget + retry_codes_name: non_idempotent + retry_params_name: default + - name: UpdateBudget + retry_codes_name: idempotent + retry_params_name: default + - name: GetBudget + retry_codes_name: idempotent + retry_params_name: default + - name: ListBudgets + retry_codes_name: idempotent + retry_params_name: default + - name: DeleteBudget + retry_codes_name: idempotent + retry_params_name: default diff --git a/third_party/googleapis/google/cloud/billing/budgets/v1beta1/billingbudgets_grpc_service_config.json b/third_party/googleapis/google/cloud/billing/budgets/v1beta1/billingbudgets_grpc_service_config.json new file mode 100644 index 000000000..ced46bf84 --- /dev/null +++ b/third_party/googleapis/google/cloud/billing/budgets/v1beta1/billingbudgets_grpc_service_config.json @@ -0,0 +1,44 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.billing.budgets.v1beta1.BudgetService", + "method": "CreateBudget" + } + ], + "timeout": "60s" + }, + { + "name": [ + { + "service": "google.cloud.billing.budgets.v1beta1.BudgetService", + "method": "UpdateBudget" + }, + { + "service": "google.cloud.billing.budgets.v1beta1.BudgetService", + "method": "GetBudget" + }, + { + "service": "google.cloud.billing.budgets.v1beta1.BudgetService", + "method": "ListBudgets" + }, + { + "service": "google.cloud.billing.budgets.v1beta1.BudgetService", + "method": "DeleteBudget" + } + ], + "timeout": "60s", + "retryPolicy": { + "maxAttempts": 5, + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/cloud/billing/budgets/v1beta1/budget_model.proto b/third_party/googleapis/google/cloud/billing/budgets/v1beta1/budget_model.proto new file mode 100644 index 000000000..d25cf3324 --- /dev/null +++ b/third_party/googleapis/google/cloud/billing/budgets/v1beta1/budget_model.proto @@ -0,0 +1,179 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.billing.budgets.v1beta1; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/type/money.proto"; + +option go_package = "google.golang.org/genproto/googleapis/cloud/billing/budgets/v1beta1;budgets"; +option java_multiple_files = true; +option java_package = "com.google.cloud.billing.budgets.v1beta1"; + +// A budget is a plan that describes what you expect to spend on Cloud +// projects, plus the rules to execute as spend is tracked against that plan, +// (for example, send an alert when 90% of the target spend is met). +// Currently all plans are monthly budgets so the usage period(s) tracked are +// implied (calendar months of usage back-to-back). +message Budget { + option (google.api.resource) = { + type: "billingbudgets.googleapis.com/Budget" + pattern: "billingAccounts/{billing_account}/budgets/{budget}" + }; + + // Output only. Resource name of the budget. + // The resource name implies the scope of a budget. Values are of the form + // `billingAccounts/{billingAccountId}/budgets/{budgetId}`. + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // User data for display name in UI. + // Validation: <= 60 chars. + string display_name = 2; + + // Optional. Filters that define which resources are used to compute + // the actual spend against the budget. + Filter budget_filter = 3 [(google.api.field_behavior) = OPTIONAL]; + + // Required. Budgeted amount. + BudgetAmount amount = 4 [(google.api.field_behavior) = REQUIRED]; + + // Optional. Rules that trigger alerts (notifications of thresholds + // being crossed) when spend exceeds the specified percentages of the budget. + repeated ThresholdRule threshold_rules = 5 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Rules to apply to all updates to the actual spend, regardless + // of the thresholds set in `threshold_rules`. + AllUpdatesRule all_updates_rule = 6 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Etag to validate that the object is unchanged for a + // read-modify-write operation. + // An empty etag will cause an update to overwrite other changes. + string etag = 7 [(google.api.field_behavior) = OPTIONAL]; +} + +// The budgeted amount for each usage period. +message BudgetAmount { + // Specification for what amount to use as the budget. + oneof budget_amount { + // A specified amount to use as the budget. + // `currency_code` is optional. If specified, it must match the + // currency of the billing account. The `currency_code` is provided on + // output. + google.type.Money specified_amount = 1; + + // Use the last period's actual spend as the budget for the present period. + LastPeriodAmount last_period_amount = 2; + } +} + +// Describes a budget amount targeted to last period's spend. +// At this time, the amount is automatically 100% of last period's spend; +// that is, there are no other options yet. +// Future configuration will be described here (for example, configuring a +// percentage of last period's spend). +message LastPeriodAmount { + +} + +// ThresholdRule contains a definition of a threshold which triggers +// an alert (a notification of a threshold being crossed) to be sent when +// spend goes above the specified amount. +// Alerts are automatically e-mailed to users with the Billing Account +// Administrator role or the Billing Account User role. +// The thresholds here have no effect on notifications sent to anything +// configured under `Budget.all_updates_rule`. +message ThresholdRule { + // The type of basis used to determine if spend has passed the threshold. + enum Basis { + // Unspecified threshold basis. + BASIS_UNSPECIFIED = 0; + + // Use current spend as the basis for comparison against the threshold. + CURRENT_SPEND = 1; + + // Use forecasted spend for the period as the basis for comparison against + // the threshold. + FORECASTED_SPEND = 2; + } + + // Required. Send an alert when this threshold is exceeded. + // This is a 1.0-based percentage, so 0.5 = 50%. + // Validation: non-negative number. + double threshold_percent = 1 [(google.api.field_behavior) = REQUIRED]; + + // Optional. The type of basis used to determine if spend has passed the + // threshold. Behavior defaults to CURRENT_SPEND if not set. + Basis spend_basis = 2 [(google.api.field_behavior) = OPTIONAL]; +} + +// AllUpdatesRule defines notifications that are sent on every update to the +// billing account's spend, regardless of the thresholds defined using +// threshold rules. +message AllUpdatesRule { + // Required. The name of the Cloud Pub/Sub topic where budget related messages will be + // published, in the form `projects/{project_id}/topics/{topic_id}`. Updates + // are sent at regular intervals to the topic. + // The topic needs to be created before the budget is created; see + // https://cloud.google.com/billing/docs/how-to/budgets#manage-notifications + // for more details. + // Caller is expected to have + // `pubsub.topics.setIamPolicy` permission on the topic when it's set for a + // budget, otherwise, the API call will fail with PERMISSION_DENIED. See + // https://cloud.google.com/pubsub/docs/access-control for more details on + // Pub/Sub roles and permissions. + string pubsub_topic = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. The schema version of the notification. + // Only "1.0" is accepted. It represents the JSON schema as defined in + // https://cloud.google.com/billing/docs/how-to/budgets#notification_format + string schema_version = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// A filter for a budget, limiting the scope of the cost to calculate. +message Filter { + // Specifies how credits should be treated when determining spend for + // threshold calculations. + enum CreditTypesTreatment { + CREDIT_TYPES_TREATMENT_UNSPECIFIED = 0; + + // All types of credit are subtracted from the gross cost to determine the + // spend for threshold calculations. + INCLUDE_ALL_CREDITS = 1; + + // All types of credit are added to the net cost to determine the spend for + // threshold calculations. + EXCLUDE_ALL_CREDITS = 2; + } + + // Optional. A set of projects of the form `projects/{project}`, + // specifying that usage from only this set of projects should be + // included in the budget. If omitted, the report will include all usage for + // the billing account, regardless of which project the usage occurred on. + // Only zero or one project can be specified currently. + repeated string projects = 1 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. If not set, default behavior is `INCLUDE_ALL_CREDITS`. + CreditTypesTreatment credit_types_treatment = 4 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. A set of services of the form `services/{service_id}`, + // specifying that usage from only this set of services should be + // included in the budget. If omitted, the report will include usage for + // all the services. + // The service names are available through the Catalog API: + // https://cloud.google.com/billing/v1/how-tos/catalog-api. + repeated string services = 3 [(google.api.field_behavior) = OPTIONAL]; +} diff --git a/third_party/googleapis/google/cloud/billing/budgets/v1beta1/budget_service.proto b/third_party/googleapis/google/cloud/billing/budgets/v1beta1/budget_service.proto new file mode 100644 index 000000000..ab2b0714c --- /dev/null +++ b/third_party/googleapis/google/cloud/billing/budgets/v1beta1/budget_service.proto @@ -0,0 +1,174 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.billing.budgets.v1beta1; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/cloud/billing/budgets/v1beta1/budget_model.proto"; +import "google/protobuf/empty.proto"; +import "google/protobuf/field_mask.proto"; + +option go_package = "google.golang.org/genproto/googleapis/cloud/billing/budgets/v1beta1;budgets"; +option java_multiple_files = true; +option java_package = "com.google.cloud.billing.budgets.v1beta1"; + +// BudgetService stores Cloud Billing budgets, which define a +// budget plan and rules to execute as we track spend against that plan. +service BudgetService { + option (google.api.default_host) = "billingbudgets.googleapis.com"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; + + // Creates a new budget. See + // Quotas and limits + // for more information on the limits of the number of budgets you can create. + rpc CreateBudget(CreateBudgetRequest) returns (Budget) { + option (google.api.http) = { + post: "/v1beta1/{parent=billingAccounts/*}/budgets" + body: "*" + }; + } + + // Updates a budget and returns the updated budget. + // + // WARNING: There are some fields exposed on the Google Cloud Console that + // aren’t available on this API. Budget fields that are not exposed in + // this API will not be changed by this method. + rpc UpdateBudget(UpdateBudgetRequest) returns (Budget) { + option (google.api.http) = { + patch: "/v1beta1/{budget.name=billingAccounts/*/budgets/*}" + body: "*" + }; + } + + // Returns a budget. + // + // WARNING: There are some fields exposed on the Google Cloud Console that + // aren’t available on this API. When reading from the API, you will not + // see these fields in the return value, though they may have been set + // in the Cloud Console. + rpc GetBudget(GetBudgetRequest) returns (Budget) { + option (google.api.http) = { + get: "/v1beta1/{name=billingAccounts/*/budgets/*}" + }; + } + + // Returns a list of budgets for a billing account. + // + // WARNING: There are some fields exposed on the Google Cloud Console that + // aren’t available on this API. When reading from the API, you will not + // see these fields in the return value, though they may have been set + // in the Cloud Console. + rpc ListBudgets(ListBudgetsRequest) returns (ListBudgetsResponse) { + option (google.api.http) = { + get: "/v1beta1/{parent=billingAccounts/*}/budgets" + }; + } + + // Deletes a budget. Returns successfully if already deleted. + rpc DeleteBudget(DeleteBudgetRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1beta1/{name=billingAccounts/*/budgets/*}" + }; + } +} + +// Request for CreateBudget +message CreateBudgetRequest { + // Required. The name of the billing account to create the budget in. Values + // are of the form `billingAccounts/{billingAccountId}`. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "billingbudgets.googleapis.com/Budget" + } + ]; + + // Required. Budget to create. + Budget budget = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// Request for UpdateBudget +message UpdateBudgetRequest { + // Required. The updated budget object. + // The budget to update is specified by the budget name in the budget. + Budget budget = 1 [(google.api.field_behavior) = REQUIRED]; + + // Optional. Indicates which fields in the provided budget to update. + // Read-only fields (such as `name`) cannot be changed. If this is not + // provided, then only fields with non-default values from the request are + // updated. See + // https://developers.google.com/protocol-buffers/docs/proto3#default for more + // details about default values. + google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = OPTIONAL]; +} + +// Request for GetBudget +message GetBudgetRequest { + // Required. Name of budget to get. Values are of the form + // `billingAccounts/{billingAccountId}/budgets/{budgetId}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "billingbudgets.googleapis.com/Budget" + } + ]; +} + +// Request for ListBudgets +message ListBudgetsRequest { + // Required. Name of billing account to list budgets under. Values + // are of the form `billingAccounts/{billingAccountId}`. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "billingbudgets.googleapis.com/Budget" + } + ]; + + // Optional. The maximum number of budgets to return per page. + // The default and maximum value are 100. + int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The value returned by the last `ListBudgetsResponse` which + // indicates that this is a continuation of a prior `ListBudgets` call, + // and that the system should return the next page of data. + string page_token = 3 [(google.api.field_behavior) = OPTIONAL]; +} + +// Response for ListBudgets +message ListBudgetsResponse { + // List of the budgets owned by the requested billing account. + repeated Budget budgets = 1; + + // If not empty, indicates that there may be more budgets that match the + // request; this value should be passed in a new `ListBudgetsRequest`. + string next_page_token = 2; +} + +// Request for DeleteBudget +message DeleteBudgetRequest { + // Required. Name of the budget to delete. Values are of the form + // `billingAccounts/{billingAccountId}/budgets/{budgetId}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "billingbudgets.googleapis.com/Budget" + } + ]; +} diff --git a/third_party/googleapis/google/cloud/billing/v1/BUILD.bazel b/third_party/googleapis/google/cloud/billing/v1/BUILD.bazel new file mode 100644 index 000000000..e7b406a0a --- /dev/null +++ b/third_party/googleapis/google/cloud/billing/v1/BUILD.bazel @@ -0,0 +1,373 @@ +# This file was automatically generated by BuildFileGenerator + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") +load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") + +proto_library( + name = "billing_proto", + srcs = [ + "cloud_billing.proto", + "cloud_catalog.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/iam/v1:iam_policy_proto", + "//google/iam/v1:policy_proto", + "//google/type:money_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +proto_library_with_info( + name = "billing_proto_with_info", + deps = [ + ":billing_proto", + "//google/cloud:common_resources_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", + "java_proto_library", +) + +java_proto_library( + name = "billing_java_proto", + deps = [":billing_proto"], +) + +java_grpc_library( + name = "billing_java_grpc", + srcs = [":billing_proto"], + deps = [":billing_java_proto"], +) + +java_gapic_library( + name = "billing_java_gapic", + src = ":billing_proto_with_info", + gapic_yaml = "cloud_billing_gapic.yaml", + package = "google.cloud.billing.v1", + service_yaml = "cloudbilling.yaml", + test_deps = [ + ":billing_java_grpc", + "//google/iam/v1:iam_java_grpc", + ], + deps = [ + ":billing_java_proto", + "//google/iam/v1:iam_java_proto", + ], +) + +java_gapic_test( + name = "billing_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.billing.v1.CloudBillingClientTest", + "com.google.cloud.billing.v1.CloudCatalogClientTest", + ], + runtime_deps = [":billing_java_gapic_test"], +) + +# Open Source Packages +java_gapic_assembly_gradle_pkg( + name = "google-cloud-billing-v1-java", + deps = [ + ":billing_java_gapic", + ":billing_java_grpc", + ":billing_java_proto", + ":billing_proto", + ], +) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", + "go_proto_library", + "go_test", +) + +go_proto_library( + name = "billing_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/cloud/billing/v1", + protos = [":billing_proto"], + deps = [ + "//google/api:annotations_go_proto", + "//google/iam/v1:iam_go_proto", + "//google/type:money_go_proto", + ], +) + +go_gapic_library( + name = "billing_go_gapic", + srcs = [":billing_proto_with_info"], + grpc_service_config = "cloud_billing_grpc_service_config.json", + importpath = "cloud.google.com/go/billing/apiv1;billing", + service_yaml = "cloudbilling.yaml", + deps = [ + ":billing_go_proto", + "//google/iam/v1:iam_go_proto", + ], +) + +go_test( + name = "billing_go_gapic_test", + srcs = [":billing_go_gapic_srcjar_test"], + embed = [":billing_go_gapic"], + importpath = "cloud.google.com/go/billing/apiv1", +) + +# Open Source Packages +go_gapic_assembly_pkg( + name = "gapi-cloud-billing-v1-go", + deps = [ + ":billing_go_gapic", + ":billing_go_gapic_srcjar-test.srcjar", + ":billing_go_proto", + ], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "billing_moved_proto", + srcs = [":billing_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/iam/v1:iam_policy_proto", + "//google/iam/v1:policy_proto", + "//google/type:money_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +py_proto_library( + name = "billing_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":billing_moved_proto"], +) + +py_grpc_library( + name = "billing_py_grpc", + srcs = [":billing_moved_proto"], + deps = [":billing_py_proto"], +) + +py_gapic_library( + name = "billing_py_gapic", + src = ":billing_proto_with_info", + gapic_yaml = "cloud_billing_gapic.yaml", + package = "google.cloud.billing.v1", + service_yaml = "cloudbilling.yaml", + deps = [ + ":billing_py_grpc", + ":billing_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "billing-v1-py", + deps = [ + ":billing_py_gapic", + ":billing_py_grpc", + ":billing_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "billing_php_proto", + deps = [":billing_proto"], +) + +php_grpc_library( + name = "billing_php_grpc", + srcs = [":billing_proto"], + deps = [":billing_php_proto"], +) + +php_gapic_library( + name = "billing_php_gapic", + src = ":billing_proto_with_info", + gapic_yaml = "cloud_billing_gapic.yaml", + package = "google.cloud.billing.v1", + service_yaml = "cloudbilling.yaml", + deps = [ + ":billing_php_grpc", + ":billing_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-billing-v1-php", + deps = [ + ":billing_php_gapic", + ":billing_php_grpc", + ":billing_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "billing_nodejs_gapic", + src = ":billing_proto_with_info", + gapic_yaml = "cloud_billing_gapic.yaml", + package = "google.cloud.billing.v1", + service_yaml = "cloudbilling.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "billing-v1-nodejs", + deps = [ + ":billing_nodejs_gapic", + ":billing_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "billing_ruby_proto", + deps = [":billing_proto"], +) + +ruby_grpc_library( + name = "billing_ruby_grpc", + srcs = [":billing_proto"], + deps = [":billing_ruby_proto"], +) + +ruby_gapic_library( + name = "billing_ruby_gapic", + src = ":billing_proto_with_info", + gapic_yaml = "cloud_billing_gapic.yaml", + package = "google.cloud.billing.v1", + service_yaml = "cloudbilling.yaml", + deps = [ + ":billing_ruby_grpc", + ":billing_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-billing-v1-ruby", + deps = [ + ":billing_ruby_gapic", + ":billing_ruby_grpc", + ":billing_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "billing_csharp_proto", + deps = [":billing_proto"], +) + +csharp_grpc_library( + name = "billing_csharp_grpc", + srcs = [":billing_proto"], + deps = [":billing_csharp_proto"], +) + +csharp_gapic_library( + name = "billing_csharp_gapic", + src = ":billing_proto_with_info", + gapic_yaml = "cloud_billing_gapic.yaml", + package = "google.cloud.billing.v1", + service_yaml = "cloudbilling.yaml", + deps = [ + ":billing_csharp_grpc", + ":billing_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-billing-v1-csharp", + deps = [ + ":billing_csharp_gapic", + ":billing_csharp_grpc", + ":billing_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/cloud/billing/v1/cloud_billing.proto b/third_party/googleapis/google/cloud/billing/v1/cloud_billing.proto index 2985d4515..f0b19d14d 100644 --- a/third_party/googleapis/google/cloud/billing/v1/cloud_billing.proto +++ b/third_party/googleapis/google/cloud/billing/v1/cloud_billing.proto @@ -1,4 +1,4 @@ -// Copyright 2016 Google Inc. +// Copyright 2019 Google LLC. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,58 +11,102 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. +// syntax = "proto3"; package google.cloud.billing.v1; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/iam/v1/iam_policy.proto"; +import "google/iam/v1/policy.proto"; +import "google/protobuf/field_mask.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/billing/v1;billing"; option java_multiple_files = true; option java_outer_classname = "CloudBillingProto"; option java_package = "com.google.cloud.billing.v1"; -// Retrieves Google Cloud Console billing accounts and associates them with -// projects. +// Retrieves GCP Console billing accounts and associates them with projects. service CloudBilling { + option (google.api.default_host) = "cloudbilling.googleapis.com"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; + // Gets information about a billing account. The current authenticated user - // must be an [owner of the billing - // account](https://support.google.com/cloud/answer/4430947). + // must be a [viewer of the billing + // account](https://cloud.google.com/billing/docs/how-to/billing-access). rpc GetBillingAccount(GetBillingAccountRequest) returns (BillingAccount) { option (google.api.http) = { get: "/v1/{name=billingAccounts/*}" }; + option (google.api.method_signature) = "name"; } - // Lists the billing accounts that the current authenticated user - // [owns](https://support.google.com/cloud/answer/4430947). - rpc ListBillingAccounts(ListBillingAccountsRequest) - returns (ListBillingAccountsResponse) { + // Lists the billing accounts that the current authenticated user has + // permission to + // [view](https://cloud.google.com/billing/docs/how-to/billing-access). + rpc ListBillingAccounts(ListBillingAccountsRequest) returns (ListBillingAccountsResponse) { option (google.api.http) = { get: "/v1/billingAccounts" }; + option (google.api.method_signature) = ""; + } + + // Updates a billing account's fields. + // Currently the only field that can be edited is `display_name`. + // The current authenticated user must have the `billing.accounts.update` + // IAM permission, which is typically given to the + // [administrator](https://cloud.google.com/billing/docs/how-to/billing-access) + // of the billing account. + rpc UpdateBillingAccount(UpdateBillingAccountRequest) returns (BillingAccount) { + option (google.api.http) = { + patch: "/v1/{name=billingAccounts/*}" + body: "account" + }; + option (google.api.method_signature) = "name,account"; + } + + // Creates a billing account. + // This method can only be used to create + // [billing subaccounts](https://cloud.google.com/billing/docs/concepts) + // by GCP resellers. + // When creating a subaccount, the current authenticated user must have the + // `billing.accounts.update` IAM permission on the master account, which is + // typically given to billing account + // [administrators](https://cloud.google.com/billing/docs/how-to/billing-access). + // This method will return an error if the master account has not been + // provisioned as a reseller account. + rpc CreateBillingAccount(CreateBillingAccountRequest) returns (BillingAccount) { + option (google.api.http) = { + post: "/v1/billingAccounts" + body: "billing_account" + }; + option (google.api.method_signature) = "billing_account"; } // Lists the projects associated with a billing account. The current - // authenticated user must be an [owner of the billing - // account](https://support.google.com/cloud/answer/4430947). - rpc ListProjectBillingInfo(ListProjectBillingInfoRequest) - returns (ListProjectBillingInfoResponse) { + // authenticated user must have the `billing.resourceAssociations.list` IAM + // permission, which is often given to billing account + // [viewers](https://cloud.google.com/billing/docs/how-to/billing-access). + rpc ListProjectBillingInfo(ListProjectBillingInfoRequest) returns (ListProjectBillingInfoResponse) { option (google.api.http) = { get: "/v1/{name=billingAccounts/*}/projects" }; + option (google.api.method_signature) = "name"; } // Gets the billing information for a project. The current authenticated user // must have [permission to view the // project](https://cloud.google.com/docs/permissions-overview#h.bgs0oxofvnoo // ). - rpc GetProjectBillingInfo(GetProjectBillingInfoRequest) - returns (ProjectBillingInfo) { + rpc GetProjectBillingInfo(GetProjectBillingInfoRequest) returns (ProjectBillingInfo) { option (google.api.http) = { get: "/v1/{name=projects/*}/billingInfo" }; + option (google.api.method_signature) = "name"; } // Sets or updates the billing account associated with a project. You specify @@ -74,14 +118,14 @@ service CloudBilling { // usage charges. // // *Note:* Incurred charges that have not yet been reported in the transaction - // history of the Google Cloud Console may be billed to the new billing + // history of the GCP Console might be billed to the new billing // account, even if the charge occurred before the new billing account was // assigned to the project. // // The current authenticated user must have ownership privileges for both the // [project](https://cloud.google.com/docs/permissions-overview#h.bgs0oxofvnoo // ) and the [billing - // account](https://support.google.com/cloud/answer/4430947). + // account](https://cloud.google.com/billing/docs/how-to/billing-access). // // You can disable billing on the project by setting the // `billing_account_name` field to empty. This action disassociates the @@ -96,36 +140,79 @@ service CloudBilling { // resources used by the project will be shut down. Thus, unless you wish to // disable billing, you should always call this method with the name of an // *open* billing account. - rpc UpdateProjectBillingInfo(UpdateProjectBillingInfoRequest) - returns (ProjectBillingInfo) { + rpc UpdateProjectBillingInfo(UpdateProjectBillingInfoRequest) returns (ProjectBillingInfo) { option (google.api.http) = { put: "/v1/{name=projects/*}/billingInfo" body: "project_billing_info" }; + option (google.api.method_signature) = "name,project_billing_info"; + } + + // Gets the access control policy for a billing account. + // The caller must have the `billing.accounts.getIamPolicy` permission on the + // account, which is often given to billing account + // [viewers](https://cloud.google.com/billing/docs/how-to/billing-access). + rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) returns (google.iam.v1.Policy) { + option (google.api.http) = { + get: "/v1/{resource=billingAccounts/*}:getIamPolicy" + }; + option (google.api.method_signature) = "resource"; + } + + // Sets the access control policy for a billing account. Replaces any existing + // policy. + // The caller must have the `billing.accounts.setIamPolicy` permission on the + // account, which is often given to billing account + // [administrators](https://cloud.google.com/billing/docs/how-to/billing-access). + rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) returns (google.iam.v1.Policy) { + option (google.api.http) = { + post: "/v1/{resource=billingAccounts/*}:setIamPolicy" + body: "*" + }; + option (google.api.method_signature) = "resource,policy"; + } + + // Tests the access control policy for a billing account. This method takes + // the resource and a set of permissions as input and returns the subset of + // the input permissions that the caller is allowed for that resource. + rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest) returns (google.iam.v1.TestIamPermissionsResponse) { + option (google.api.http) = { + post: "/v1/{resource=billingAccounts/*}:testIamPermissions" + body: "*" + }; + option (google.api.method_signature) = "resource,permissions"; } } -// A billing account in [Google Cloud -// Console](https://console.cloud.google.com/). You can assign a billing account -// to one or more projects. +// A billing account in [GCP Console](https://console.cloud.google.com/). +// You can assign a billing account to one or more projects. message BillingAccount { // The resource name of the billing account. The resource name has the form // `billingAccounts/{billing_account_id}`. For example, // `billingAccounts/012345-567890-ABCDEF` would be the resource name for // billing account `012345-567890-ABCDEF`. - string name = 1; + string name = 1 [(google.api.resource_reference) = { + type: "cloudbilling.googleapis.com/BillingAccount" + }]; - // True if the billing account is open, and will therefore be charged for any + // Output only. True if the billing account is open, and will therefore be charged for any // usage on associated projects. False if the billing account is closed, and // therefore projects associated with it will be unable to use paid services. - bool open = 2; + bool open = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; // The display name given to the billing account, such as `My Billing - // Account`. This name is displayed in the Google Cloud Console. + // Account`. This name is displayed in the GCP Console. string display_name = 3; + + // If this account is a + // [subaccount](https://cloud.google.com/billing/docs/concepts), then this + // will be the resource name of the master billing account that it is being + // resold through. + // Otherwise this will be empty. + string master_billing_account = 4; } -// Encapsulation of billing information for a Cloud Console project. A project +// Encapsulation of billing information for a GCP Console project. A project // has at most one associated billing account at a time (but a billing account // can be assigned to multiple projects). message ProjectBillingInfo { @@ -153,9 +240,14 @@ message ProjectBillingInfo { // Request message for `GetBillingAccount`. message GetBillingAccountRequest { - // The resource name of the billing account to retrieve. For example, + // Required. The resource name of the billing account to retrieve. For example, // `billingAccounts/012345-567890-ABCDEF`. - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudbilling.googleapis.com/BillingAccount" + } + ]; } // Request message for `ListBillingAccounts`. @@ -168,6 +260,14 @@ message ListBillingAccountsRequest { // `next_page_token` value returned from a previous `ListBillingAccounts` // call. If unspecified, the first page of results is returned. string page_token = 2; + + // Options for how to filter the returned billing accounts. + // Currently this only supports filtering for + // [subaccounts](https://cloud.google.com/billing/docs/concepts) under a + // single provided reseller billing account. + // (e.g. "master_billing_account=billingAccounts/012345-678901-ABCDEF"). + // Boolean algebra and other fields are not currently supported. + string filter = 3; } // Response message for `ListBillingAccounts`. @@ -181,11 +281,43 @@ message ListBillingAccountsResponse { string next_page_token = 2; } +// Request message for `CreateBillingAccount`. +message CreateBillingAccountRequest { + // Required. The billing account resource to create. + // Currently CreateBillingAccount only supports subaccount creation, so + // any created billing accounts must be under a provided master billing + // account. + BillingAccount billing_account = 1 [(google.api.field_behavior) = REQUIRED]; +} + +// Request message for `UpdateBillingAccount`. +message UpdateBillingAccountRequest { + // Required. The name of the billing account resource to be updated. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudbilling.googleapis.com/BillingAccount" + } + ]; + + // Required. The billing account resource to replace the resource on the server. + BillingAccount account = 2 [(google.api.field_behavior) = REQUIRED]; + + // The update mask applied to the resource. + // Only "display_name" is currently supported. + google.protobuf.FieldMask update_mask = 3; +} + // Request message for `ListProjectBillingInfo`. message ListProjectBillingInfoRequest { - // The resource name of the billing account associated with the projects that + // Required. The resource name of the billing account associated with the projects that // you want to list. For example, `billingAccounts/012345-567890-ABCDEF`. - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudbilling.googleapis.com/BillingAccount" + } + ]; // Requested page size. The maximum page size is 100; this is also the // default. @@ -211,18 +343,18 @@ message ListProjectBillingInfoResponse { // Request message for `GetProjectBillingInfo`. message GetProjectBillingInfoRequest { - // The resource name of the project for which billing information is + // Required. The resource name of the project for which billing information is // retrieved. For example, `projects/tokyo-rain-123`. - string name = 1; + string name = 1 [(google.api.field_behavior) = REQUIRED]; } // Request message for `UpdateProjectBillingInfo`. message UpdateProjectBillingInfoRequest { - // The resource name of the project associated with the billing information + // Required. The resource name of the project associated with the billing information // that you want to update. For example, `projects/tokyo-rain-123`. - string name = 1; + string name = 1 [(google.api.field_behavior) = REQUIRED]; // The new billing information for the project. Read-only fields are ignored; - // thus, you may leave empty all fields except `billing_account_name`. + // thus, you can leave empty all fields except `billing_account_name`. ProjectBillingInfo project_billing_info = 2; } diff --git a/third_party/googleapis/google/cloud/billing/v1/cloud_billing_gapic.yaml b/third_party/googleapis/google/cloud/billing/v1/cloud_billing_gapic.yaml new file mode 100644 index 000000000..66d708ced --- /dev/null +++ b/third_party/googleapis/google/cloud/billing/v1/cloud_billing_gapic.yaml @@ -0,0 +1,19 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 2.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.billing.v1 + python: + package_name: google.cloud.billing_v1.gapic + go: + package_name: cloud.google.com/go/billing/apiv1 + csharp: + package_name: Google.Cloud.Billing.V1 + ruby: + package_name: Google::Cloud::Billing::V1 + php: + package_name: Google\Cloud\Billing\V1 + nodejs: + package_name: billing.v1 + domain_layer_location: google-cloud diff --git a/third_party/googleapis/google/cloud/billing/v1/cloud_billing_grpc_service_config.json b/third_party/googleapis/google/cloud/billing/v1/cloud_billing_grpc_service_config.json new file mode 100644 index 000000000..c78eb4d68 --- /dev/null +++ b/third_party/googleapis/google/cloud/billing/v1/cloud_billing_grpc_service_config.json @@ -0,0 +1,64 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.billing.v1.CloudBilling", + "method": "CreateBillingAccount" + } + ], + "timeout": "60s" + }, + { + "name": [ + { + "service": "google.cloud.billing.v1.CloudBilling", + "method": "GetBillingAccount" + }, + { + "service": "google.cloud.billing.v1.CloudBilling", + "method": "ListBillingAccounts" + }, + { + "service": "google.cloud.billing.v1.CloudBilling", + "method": "UpdateBillingAccount" + }, + { + "service": "google.cloud.billing.v1.CloudBilling", + "method": "ListProjectBillingInfo" + }, + { + "service": "google.cloud.billing.v1.CloudBilling", + "method": "GetProjectBillingInfo" + }, + { + "service": "google.cloud.billing.v1.CloudBilling", + "method": "UpdateProjectBillingInfo" + }, + { + "service": "google.cloud.billing.v1.CloudBilling", + "method": "GetIamPolicy" + }, + { + "service": "google.cloud.billing.v1.CloudBilling", + "method": "SetIamPolicy" + }, + { + "service": "google.cloud.billing.v1.CloudBilling", + "method": "TestIamPermissions" + } + ], + "timeout": "60s", + "retryPolicy": { + "maxAttempts": 5, + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/cloud/billing/v1/cloud_catalog.proto b/third_party/googleapis/google/cloud/billing/v1/cloud_catalog.proto new file mode 100644 index 000000000..7bc2f14e3 --- /dev/null +++ b/third_party/googleapis/google/cloud/billing/v1/cloud_catalog.proto @@ -0,0 +1,331 @@ +// Copyright 2019 Google LLC. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// + +syntax = "proto3"; + +package google.cloud.billing.v1; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/timestamp.proto"; +import "google/type/money.proto"; + +option csharp_namespace = "Google.Cloud.Billing.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/billing/v1;billing"; +option java_multiple_files = true; +option java_outer_classname = "CloudCatalogProto"; +option java_package = "com.google.cloud.billing.v1"; +option objc_class_prefix = "CLDCTLG"; + +// A catalog of Google Cloud Platform services and SKUs. +// Provides pricing information and metadata on Google Cloud Platform services +// and SKUs. +service CloudCatalog { + option (google.api.default_host) = "cloudbilling.googleapis.com"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; + + // Lists all public cloud services. + rpc ListServices(ListServicesRequest) returns (ListServicesResponse) { + option (google.api.http) = { + get: "/v1/services" + }; + option (google.api.method_signature) = ""; + } + + // Lists all publicly available SKUs for a given cloud service. + rpc ListSkus(ListSkusRequest) returns (ListSkusResponse) { + option (google.api.http) = { + get: "/v1/{parent=services/*}/skus" + }; + option (google.api.method_signature) = "parent"; + } +} + +// Encapsulates a single service in Google Cloud Platform. +message Service { + option (google.api.resource) = { + type: "cloudbilling.googleapis.com/Service" + pattern: "services/{service}" + }; + + // The resource name for the service. + // Example: "services/DA34-426B-A397" + string name = 1; + + // The identifier for the service. + // Example: "DA34-426B-A397" + string service_id = 2; + + // A human readable display name for this service. + string display_name = 3; + + // The business under which the service is offered. + // Ex. "businessEntities/GCP", "businessEntities/Maps" + string business_entity_name = 4; +} + +// Encapsulates a single SKU in Google Cloud Platform +message Sku { + option (google.api.resource) = { + type: "cloudbilling.googleapis.com/Sku" + pattern: "services/{service}/skus/{sku}" + }; + + // The resource name for the SKU. + // Example: "services/DA34-426B-A397/skus/AA95-CD31-42FE" + string name = 1; + + // The identifier for the SKU. + // Example: "AA95-CD31-42FE" + string sku_id = 2; + + // A human readable description of the SKU, has a maximum length of 256 + // characters. + string description = 3; + + // The category hierarchy of this SKU, purely for organizational purpose. + Category category = 4; + + // List of service regions this SKU is offered at. + // Example: "asia-east1" + // Service regions can be found at https://cloud.google.com/about/locations/ + repeated string service_regions = 5; + + // A timeline of pricing info for this SKU in chronological order. + repeated PricingInfo pricing_info = 6; + + // Identifies the service provider. + // This is 'Google' for first party services in Google Cloud Platform. + string service_provider_name = 7; +} + +// Represents the category hierarchy of a SKU. +message Category { + // The display name of the service this SKU belongs to. + string service_display_name = 1; + + // The type of product the SKU refers to. + // Example: "Compute", "Storage", "Network", "ApplicationServices" etc. + string resource_family = 2; + + // A group classification for related SKUs. + // Example: "RAM", "GPU", "Prediction", "Ops", "GoogleEgress" etc. + string resource_group = 3; + + // Represents how the SKU is consumed. + // Example: "OnDemand", "Preemptible", "Commit1Mo", "Commit1Yr" etc. + string usage_type = 4; +} + +// Represents the pricing information for a SKU at a single point of time. +message PricingInfo { + // The timestamp from which this pricing was effective within the requested + // time range. This is guaranteed to be greater than or equal to the + // start_time field in the request and less than the end_time field in the + // request. If a time range was not specified in the request this field will + // be equivalent to a time within the last 12 hours, indicating the latest + // pricing info. + google.protobuf.Timestamp effective_time = 1; + + // An optional human readable summary of the pricing information, has a + // maximum length of 256 characters. + string summary = 2; + + // Expresses the pricing formula. See `PricingExpression` for an example. + PricingExpression pricing_expression = 3; + + // Aggregation Info. This can be left unspecified if the pricing expression + // doesn't require aggregation. + AggregationInfo aggregation_info = 4; + + // Conversion rate used for currency conversion, from USD to the currency + // specified in the request. This includes any surcharge collected for billing + // in non USD currency. If a currency is not specified in the request this + // defaults to 1.0. + // Example: USD * currency_conversion_rate = JPY + double currency_conversion_rate = 5; +} + +// Expresses a mathematical pricing formula. For Example:- +// +// `usage_unit: GBy` +// `tiered_rates:` +// `[start_usage_amount: 20, unit_price: $10]` +// `[start_usage_amount: 100, unit_price: $5]` +// +// The above expresses a pricing formula where the first 20GB is free, the +// next 80GB is priced at $10 per GB followed by $5 per GB for additional +// usage. +message PricingExpression { + // The price rate indicating starting usage and its corresponding price. + message TierRate { + // Usage is priced at this rate only after this amount. + // Example: start_usage_amount of 10 indicates that the usage will be priced + // at the unit_price after the first 10 usage_units. + double start_usage_amount = 1; + + // The price per unit of usage. + // Example: unit_price of amount $10 indicates that each unit will cost $10. + google.type.Money unit_price = 2; + } + + // The short hand for unit of usage this pricing is specified in. + // Example: usage_unit of "GiBy" means that usage is specified in "Gibi Byte". + string usage_unit = 1; + + // The unit of usage in human readable form. + // Example: "gibi byte". + string usage_unit_description = 4; + + // The base unit for the SKU which is the unit used in usage exports. + // Example: "By" + string base_unit = 5; + + // The base unit in human readable form. + // Example: "byte". + string base_unit_description = 6; + + // Conversion factor for converting from price per usage_unit to price per + // base_unit, and start_usage_amount to start_usage_amount in base_unit. + // unit_price / base_unit_conversion_factor = price per base_unit. + // start_usage_amount * base_unit_conversion_factor = start_usage_amount in + // base_unit. + double base_unit_conversion_factor = 7; + + // The recommended quantity of units for displaying pricing info. When + // displaying pricing info it is recommended to display: + // (unit_price * display_quantity) per display_quantity usage_unit. + // This field does not affect the pricing formula and is for display purposes + // only. + // Example: If the unit_price is "0.0001 USD", the usage_unit is "GB" and + // the display_quantity is "1000" then the recommended way of displaying the + // pricing info is "0.10 USD per 1000 GB" + double display_quantity = 2; + + // The list of tiered rates for this pricing. The total cost is computed by + // applying each of the tiered rates on usage. This repeated list is sorted + // by ascending order of start_usage_amount. + repeated TierRate tiered_rates = 3; +} + +// Represents the aggregation level and interval for pricing of a single SKU. +message AggregationInfo { + // The level at which usage is aggregated to compute cost. + // Example: "ACCOUNT" aggregation level indicates that usage for tiered + // pricing is aggregated across all projects in a single account. + enum AggregationLevel { + AGGREGATION_LEVEL_UNSPECIFIED = 0; + + ACCOUNT = 1; + + PROJECT = 2; + } + + // The interval at which usage is aggregated to compute cost. + // Example: "MONTHLY" aggregation interval indicates that usage for tiered + // pricing is aggregated every month. + enum AggregationInterval { + AGGREGATION_INTERVAL_UNSPECIFIED = 0; + + DAILY = 1; + + MONTHLY = 2; + } + + AggregationLevel aggregation_level = 1; + + AggregationInterval aggregation_interval = 2; + + // The number of intervals to aggregate over. + // Example: If aggregation_level is "DAILY" and aggregation_count is 14, + // aggregation will be over 14 days. + int32 aggregation_count = 3; +} + +// Request message for `ListServices`. +message ListServicesRequest { + // Requested page size. Defaults to 5000. + int32 page_size = 1; + + // A token identifying a page of results to return. This should be a + // `next_page_token` value returned from a previous `ListServices` + // call. If unspecified, the first page of results is returned. + string page_token = 2; +} + +// Response message for `ListServices`. +message ListServicesResponse { + // A list of services. + repeated Service services = 1; + + // A token to retrieve the next page of results. To retrieve the next page, + // call `ListServices` again with the `page_token` field set to this + // value. This field is empty if there are no more results to retrieve. + string next_page_token = 2; +} + +// Request message for `ListSkus`. +message ListSkusRequest { + // Required. The name of the service. + // Example: "services/DA34-426B-A397" + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudbilling.googleapis.com/Service" + } + ]; + + // Optional inclusive start time of the time range for which the pricing + // versions will be returned. Timestamps in the future are not allowed. + // The time range has to be within a single calendar month in + // America/Los_Angeles timezone. Time range as a whole is optional. If not + // specified, the latest pricing will be returned (up to 12 hours old at + // most). + google.protobuf.Timestamp start_time = 2; + + // Optional exclusive end time of the time range for which the pricing + // versions will be returned. Timestamps in the future are not allowed. + // The time range has to be within a single calendar month in + // America/Los_Angeles timezone. Time range as a whole is optional. If not + // specified, the latest pricing will be returned (up to 12 hours old at + // most). + google.protobuf.Timestamp end_time = 3; + + // The ISO 4217 currency code for the pricing info in the response proto. + // Will use the conversion rate as of start_time. + // Optional. If not specified USD will be used. + string currency_code = 4; + + // Requested page size. Defaults to 5000. + int32 page_size = 5; + + // A token identifying a page of results to return. This should be a + // `next_page_token` value returned from a previous `ListSkus` + // call. If unspecified, the first page of results is returned. + string page_token = 6; +} + +// Response message for `ListSkus`. +message ListSkusResponse { + // The list of public SKUs of the given service. + repeated Sku skus = 1; + + // A token to retrieve the next page of results. To retrieve the next page, + // call `ListSkus` again with the `page_token` field set to this + // value. This field is empty if there are no more results to retrieve. + string next_page_token = 2; +} diff --git a/third_party/googleapis/google/cloud/billing/v1/cloud_catalog_grpc_service_config.json b/third_party/googleapis/google/cloud/billing/v1/cloud_catalog_grpc_service_config.json new file mode 100644 index 000000000..188fd0479 --- /dev/null +++ b/third_party/googleapis/google/cloud/billing/v1/cloud_catalog_grpc_service_config.json @@ -0,0 +1,17 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.billing.v1.CloudCatalog", + "method": "ListServices" + }, + { + "service": "google.cloud.billing.v1.CloudCatalog", + "method": "ListSkus" + } + ], + "timeout": "60s" + } + ] +} diff --git a/third_party/googleapis/google/cloud/billing/v1/cloudbilling.yaml b/third_party/googleapis/google/cloud/billing/v1/cloudbilling.yaml new file mode 100644 index 000000000..fb0e32e1b --- /dev/null +++ b/third_party/googleapis/google/cloud/billing/v1/cloudbilling.yaml @@ -0,0 +1,28 @@ +type: google.api.Service +config_version: 1 +name: cloudbilling.googleapis.com +title: Cloud Billing API + +apis: +- name: google.cloud.billing.v1.CloudBilling +- name: google.cloud.billing.v1.CloudCatalog + +documentation: + summary: |- + Allows developers to manage billing for their Google Cloud Platform + projects programmatically. + +authentication: + rules: + - selector: 'google.cloud.billing.v1.CloudBilling.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: google.cloud.billing.v1.CloudCatalog.ListServices + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: google.cloud.billing.v1.CloudCatalog.ListSkus + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/binaryauthorization/artman_binaryauthorization_v1beta1.yaml b/third_party/googleapis/google/cloud/binaryauthorization/artman_binaryauthorization_v1beta1.yaml index 036c547ff..07d27f08a 100644 --- a/third_party/googleapis/google/cloud/binaryauthorization/artman_binaryauthorization_v1beta1.yaml +++ b/third_party/googleapis/google/cloud/binaryauthorization/artman_binaryauthorization_v1beta1.yaml @@ -6,8 +6,9 @@ common: - name: google-common-protos src_proto_paths: - v1beta1 - service_yaml: binaryauthorization_v1beta1.yaml + service_yaml: v1beta1/binaryauthorization_v1beta1.yaml gapic_yaml: v1beta1/binaryauthorization_gapic.yaml + proto_package: google.cloud.binaryauthorization.v1beta1 artifacts: - name: gapic_config type: GAPIC_CONFIG diff --git a/third_party/googleapis/google/cloud/binaryauthorization/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/binaryauthorization/v1beta1/BUILD.bazel new file mode 100644 index 000000000..c3e3dbb26 --- /dev/null +++ b/third_party/googleapis/google/cloud/binaryauthorization/v1beta1/BUILD.bazel @@ -0,0 +1,362 @@ +# This file was automatically generated by BuildFileGenerator + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") +load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") + +proto_library( + name = "binaryauthorization_proto", + srcs = [ + "resources.proto", + "service.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +proto_library_with_info( + name = "binaryauthorization_proto_with_info", + deps = [ + ":binaryauthorization_proto", + "//google/cloud:common_resources_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", + "java_proto_library", +) + +java_proto_library( + name = "binaryauthorization_java_proto", + deps = [":binaryauthorization_proto"], +) + +java_grpc_library( + name = "binaryauthorization_java_grpc", + srcs = [":binaryauthorization_proto"], + deps = [":binaryauthorization_java_proto"], +) + +# Uncomment, once java file level options are included in the protos +#java_gapic_library( +# name = "binaryauthorization_java_gapic", +# src = ":binaryauthorization_proto_with_info", +# gapic_yaml = "binaryauthorization_gapic.yaml", +# package = "google.cloud.binaryauthorization.v1beta1", +# service_yaml = "binaryauthorization_v1beta1.yaml", +# test_deps = [ +# ":binaryauthorization_java_grpc", +# ], +# deps = [ +# ":binaryauthorization_java_proto", +# ], +#) +# +#java_gapic_test( +# name = "binaryauthorization_java_gapic_test_suite", +# test_classes = [ +# "com.google.cloud.binaryauthorization.v1beta1.BinauthzManagementServiceV1Beta1ClientTest", +# ], +# runtime_deps = [":binaryauthorization_java_gapic_test"], +#) +# +## Open Source Packages +#java_gapic_assembly_gradle_pkg( +# name = "google-cloud-binaryauthorization-v1beta1-java", +# deps = [ +# ":binaryauthorization_java_gapic", +# ":binaryauthorization_java_grpc", +# ":binaryauthorization_java_proto", +# ":binaryauthorization_proto", +# ], +#) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", + "go_proto_library", + "go_test", +) + +go_proto_library( + name = "binaryauthorization_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/cloud/binaryauthorization/v1beta1", + protos = [":binaryauthorization_proto"], + deps = [ + "//google/api:annotations_go_proto", + ], +) + +go_gapic_library( + name = "binaryauthorization_go_gapic", + srcs = [":binaryauthorization_proto_with_info"], + grpc_service_config = "binaryauthorization_grpc_service_config.json", + importpath = "cloud.google.com/go/binaryauthorization/apiv1beta1;binaryauthorization", + service_yaml = "binaryauthorization_v1beta1.yaml", + deps = [ + ":binaryauthorization_go_proto", + ], +) + +go_test( + name = "binaryauthorization_go_gapic_test", + srcs = [":binaryauthorization_go_gapic_srcjar_test"], + embed = [":binaryauthorization_go_gapic"], + importpath = "cloud.google.com/go/binaryauthorization/apiv1beta1", +) + +# Open Source Packages +go_gapic_assembly_pkg( + name = "gapi-cloud-binaryauthorization-v1beta1-go", + deps = [ + ":binaryauthorization_go_gapic", + ":binaryauthorization_go_gapic_srcjar-test.srcjar", + ":binaryauthorization_go_proto", + ], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "binaryauthorization_moved_proto", + srcs = [":binaryauthorization_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +py_proto_library( + name = "binaryauthorization_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":binaryauthorization_moved_proto"], +) + +py_grpc_library( + name = "binaryauthorization_py_grpc", + srcs = [":binaryauthorization_moved_proto"], + deps = [":binaryauthorization_py_proto"], +) + +py_gapic_library( + name = "binaryauthorization_py_gapic", + src = ":binaryauthorization_proto_with_info", + gapic_yaml = "binaryauthorization_gapic.yaml", + package = "google.cloud.binaryauthorization.v1beta1", + service_yaml = "binaryauthorization_v1beta1.yaml", + deps = [ + ":binaryauthorization_py_grpc", + ":binaryauthorization_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "binaryauthorization-v1beta1-py", + deps = [ + ":binaryauthorization_py_gapic", + ":binaryauthorization_py_grpc", + ":binaryauthorization_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "binaryauthorization_php_proto", + deps = [":binaryauthorization_proto"], +) + +php_grpc_library( + name = "binaryauthorization_php_grpc", + srcs = [":binaryauthorization_proto"], + deps = [":binaryauthorization_php_proto"], +) + +php_gapic_library( + name = "binaryauthorization_php_gapic", + src = ":binaryauthorization_proto_with_info", + gapic_yaml = "binaryauthorization_gapic.yaml", + package = "google.cloud.binaryauthorization.v1beta1", + service_yaml = "binaryauthorization_v1beta1.yaml", + deps = [ + ":binaryauthorization_php_grpc", + ":binaryauthorization_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-binaryauthorization-v1beta1-php", + deps = [ + ":binaryauthorization_php_gapic", + ":binaryauthorization_php_grpc", + ":binaryauthorization_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "binaryauthorization_nodejs_gapic", + src = ":binaryauthorization_proto_with_info", + gapic_yaml = "binaryauthorization_gapic.yaml", + package = "google.cloud.binaryauthorization.v1beta1", + service_yaml = "binaryauthorization_v1beta1.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "binaryauthorization-v1beta1-nodejs", + deps = [ + ":binaryauthorization_nodejs_gapic", + ":binaryauthorization_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "binaryauthorization_ruby_proto", + deps = [":binaryauthorization_proto"], +) + +ruby_grpc_library( + name = "binaryauthorization_ruby_grpc", + srcs = [":binaryauthorization_proto"], + deps = [":binaryauthorization_ruby_proto"], +) + +ruby_gapic_library( + name = "binaryauthorization_ruby_gapic", + src = ":binaryauthorization_proto_with_info", + gapic_yaml = "binaryauthorization_gapic.yaml", + package = "google.cloud.binaryauthorization.v1beta1", + service_yaml = "binaryauthorization_v1beta1.yaml", + deps = [ + ":binaryauthorization_ruby_grpc", + ":binaryauthorization_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-binaryauthorization-v1beta1-ruby", + deps = [ + ":binaryauthorization_ruby_gapic", + ":binaryauthorization_ruby_grpc", + ":binaryauthorization_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "binaryauthorization_csharp_proto", + deps = [":binaryauthorization_proto"], +) + +csharp_grpc_library( + name = "binaryauthorization_csharp_grpc", + srcs = [":binaryauthorization_proto"], + deps = [":binaryauthorization_csharp_proto"], +) + +csharp_gapic_library( + name = "binaryauthorization_csharp_gapic", + src = ":binaryauthorization_proto_with_info", + gapic_yaml = "binaryauthorization_gapic.yaml", + package = "google.cloud.binaryauthorization.v1beta1", + service_yaml = "binaryauthorization_v1beta1.yaml", + deps = [ + ":binaryauthorization_csharp_grpc", + ":binaryauthorization_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-binaryauthorization-v1beta1-csharp", + deps = [ + ":binaryauthorization_csharp_gapic", + ":binaryauthorization_csharp_grpc", + ":binaryauthorization_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/cloud/binaryauthorization/v1beta1/binaryauthorization_gapic.legacy.yaml b/third_party/googleapis/google/cloud/binaryauthorization/v1beta1/binaryauthorization_gapic.legacy.yaml new file mode 100644 index 000000000..24a87ee79 --- /dev/null +++ b/third_party/googleapis/google/cloud/binaryauthorization/v1beta1/binaryauthorization_gapic.legacy.yaml @@ -0,0 +1,197 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 1.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.binaryauthorization.v1beta1 + python: + package_name: google.cloud.binaryauthorization_v1beta1.gapic + go: + package_name: cloud.google.com/go/binaryauthorization/apiv1beta1 + csharp: + package_name: Google.Cloud.Binaryauthorization.V1beta1 + ruby: + package_name: Google::Cloud::Binaryauthorization::V1beta1 + php: + package_name: Google\Cloud\Binaryauthorization\V1beta1 + nodejs: + package_name: binaryauthorization.v1beta1 +# A list of API interface configurations. +interfaces: +- name: google.cloud.binaryauthorization.v1beta1.BinauthzManagementServiceV1Beta1 + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: + - name_pattern: projects/{project} + entity_name: project + - name_pattern: projects/{project}/attestors/{attestor} + entity_name: attestor + - name_pattern: projects/{project}/policy + entity_name: project_policy + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - DEADLINE_EXCEEDED + - UNAVAILABLE + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # + # name - The simple name of the method. + # + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce method + # overloads which allow a client to directly pass request message fields as + # method parameters. This information may or may not be used, depending on + # the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request message. + # + # required_fields - Fields that are always required for a request to be + # valid. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a paging + # list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It defines + # which fields match the paging pattern in the request. The request consists + # of a page_size_field and a token_field. The page_size_field is the name of + # the optional field specifying the maximum number of elements to be + # returned in the response. The token_field is the name of the field in the + # request containing the page token. + # The response specifies response information of the list method. It defines + # which fields match the paging pattern in the response. The response + # consists of a token_field and a resources_field. The token_field is the + # name of the field in the response containing the next page token. The + # resources_field is the name of the field in the response containing the + # list of resources belonging to the page. + # + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: GetPolicy + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: project_policy + timeout_millis: 60000 + - name: UpdatePolicy + flattening: + groups: + - parameters: + - policy + required_fields: + - policy + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + policy.name: project_policy + timeout_millis: 60000 + - name: CreateAttestor + flattening: + groups: + - parameters: + - parent + - attestor_id + - attestor + required_fields: + - parent + - attestor_id + - attestor + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: project + timeout_millis: 60000 + - name: GetAttestor + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: attestor + timeout_millis: 60000 + - name: UpdateAttestor + flattening: + groups: + - parameters: + - attestor + required_fields: + - attestor + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + attestor.name: attestor + timeout_millis: 60000 + - name: ListAttestors + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: attestors + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: project + timeout_millis: 60000 + - name: DeleteAttestor + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: attestor + timeout_millis: 60000 diff --git a/third_party/googleapis/google/cloud/binaryauthorization/v1beta1/binaryauthorization_gapic.yaml b/third_party/googleapis/google/cloud/binaryauthorization/v1beta1/binaryauthorization_gapic.yaml index 16dbce7ea..7c7b177a2 100644 --- a/third_party/googleapis/google/cloud/binaryauthorization/v1beta1/binaryauthorization_gapic.yaml +++ b/third_party/googleapis/google/cloud/binaryauthorization/v1beta1/binaryauthorization_gapic.yaml @@ -1,5 +1,5 @@ type: com.google.api.codegen.ConfigProto -config_schema_version: 1.0.0 +config_schema_version: 2.0.0 # The settings of generated code in a specific language. language_settings: java: @@ -16,183 +16,3 @@ language_settings: package_name: Google\Cloud\Binaryauthorization\V1beta1 nodejs: package_name: binaryauthorization.v1beta1 -# A list of API interface configurations. -interfaces: -# The fully qualified name of the API interface. -- name: google.cloud.binaryauthorization.v1beta1.BinauthzManagementServiceV1Beta1 - # A list of resource collection configurations. - # Consists of a name_pattern and an entity_name. - # The name_pattern is a pattern to describe the names of the resources of this - # collection, using the platform's conventions for URI patterns. A generator - # may use this to generate methods to compose and decompose such names. The - # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; - # those will be taken as hints for the parameter names of the generated - # methods. If empty, no name methods are generated. - # The entity_name is the name to be used as a basis for generated methods and - # classes. - collections: - - name_pattern: projects/{project} - entity_name: project - - name_pattern: projects/{project}/attestors/{attestor} - entity_name: attestor - - name_pattern: projects/{project}/policy - entity_name: project_policy - # Definition for retryable codes. - retry_codes_def: - - name: idempotent - retry_codes: - - DEADLINE_EXCEEDED - - UNAVAILABLE - - name: non_idempotent - retry_codes: [] - # Definition for retry/backoff parameters. - retry_params_def: - - name: default - initial_retry_delay_millis: 100 - retry_delay_multiplier: 1.3 - max_retry_delay_millis: 60000 - initial_rpc_timeout_millis: 20000 - rpc_timeout_multiplier: 1 - max_rpc_timeout_millis: 20000 - total_timeout_millis: 600000 - # A list of method configurations. - # Common properties: - # - # name - The simple name of the method. - # - # flattening - Specifies the configuration for parameter flattening. - # Describes the parameter groups for which a generator should produce method - # overloads which allow a client to directly pass request message fields as - # method parameters. This information may or may not be used, depending on - # the target language. - # Consists of groups, which each represent a list of parameters to be - # flattened. Each parameter listed must be a field of the request message. - # - # required_fields - Fields that are always required for a request to be - # valid. - # - # page_streaming - Specifies the configuration for paging. - # Describes information for generating a method which transforms a paging - # list RPC into a stream of resources. - # Consists of a request and a response. - # The request specifies request information of the list method. It defines - # which fields match the paging pattern in the request. The request consists - # of a page_size_field and a token_field. The page_size_field is the name of - # the optional field specifying the maximum number of elements to be - # returned in the response. The token_field is the name of the field in the - # request containing the page token. - # The response specifies response information of the list method. It defines - # which fields match the paging pattern in the response. The response - # consists of a token_field and a resources_field. The token_field is the - # name of the field in the response containing the next page token. The - # resources_field is the name of the field in the response containing the - # list of resources belonging to the page. - # - # retry_codes_name - Specifies the configuration for retryable codes. The - # name must be defined in interfaces.retry_codes_def. - # - # retry_params_name - Specifies the configuration for retry/backoff - # parameters. The name must be defined in interfaces.retry_params_def. - # - # field_name_patterns - Maps the field name of the request type to - # entity_name of interfaces.collections. - # Specifies the string pattern that the field must follow. - # - # timeout_millis - Specifies the default timeout for a non-retrying call. If - # the call is retrying, refer to retry_params_name instead. - methods: - - name: GetPolicy - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: project_policy - timeout_millis: 60000 - - name: UpdatePolicy - flattening: - groups: - - parameters: - - policy - required_fields: - - policy - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - policy.name: project_policy - timeout_millis: 60000 - - name: CreateAttestor - flattening: - groups: - - parameters: - - parent - - attestor_id - - attestor - required_fields: - - parent - - attestor_id - - attestor - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: project - timeout_millis: 60000 - - name: GetAttestor - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: attestor - timeout_millis: 60000 - - name: UpdateAttestor - flattening: - groups: - - parameters: - - attestor - required_fields: - - attestor - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - attestor.name: attestor - timeout_millis: 60000 - - name: ListAttestors - flattening: - groups: - - parameters: - - parent - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: attestors - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: project - timeout_millis: 60000 - - name: DeleteAttestor - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: attestor - timeout_millis: 60000 diff --git a/third_party/googleapis/google/cloud/binaryauthorization/v1beta1/binaryauthorization_grpc_service_config.json b/third_party/googleapis/google/cloud/binaryauthorization/v1beta1/binaryauthorization_grpc_service_config.json new file mode 100755 index 000000000..6da9842f4 --- /dev/null +++ b/third_party/googleapis/google/cloud/binaryauthorization/v1beta1/binaryauthorization_grpc_service_config.json @@ -0,0 +1,51 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.binaryauthorization.v1beta1.BinauthzManagementServiceV1Beta1", + "method": "GetPolicy" + }, + { + "service": "google.cloud.binaryauthorization.v1beta1.BinauthzManagementServiceV1Beta1", + "method": "UpdatePolicy" + }, + { + "service": "google.cloud.binaryauthorization.v1beta1.BinauthzManagementServiceV1Beta1", + "method": "GetAttestor" + }, + { + "service": "google.cloud.binaryauthorization.v1beta1.BinauthzManagementServiceV1Beta1", + "method": "UpdateAttestor" + }, + { + "service": "google.cloud.binaryauthorization.v1beta1.BinauthzManagementServiceV1Beta1", + "method": "ListAttestors" + }, + { + "service": "google.cloud.binaryauthorization.v1beta1.BinauthzManagementServiceV1Beta1", + "method": "DeleteAttestor" + } + ], + "timeout": "600s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.binaryauthorization.v1beta1.BinauthzManagementServiceV1Beta1", + "method": "CreateAttestor" + } + ], + "timeout": "600s" + } + ] +} diff --git a/third_party/googleapis/google/cloud/binaryauthorization/binaryauthorization_v1beta1.yaml b/third_party/googleapis/google/cloud/binaryauthorization/v1beta1/binaryauthorization_v1beta1.yaml similarity index 68% rename from third_party/googleapis/google/cloud/binaryauthorization/binaryauthorization_v1beta1.yaml rename to third_party/googleapis/google/cloud/binaryauthorization/v1beta1/binaryauthorization_v1beta1.yaml index d2143b3e2..4405518b0 100644 --- a/third_party/googleapis/google/cloud/binaryauthorization/binaryauthorization_v1beta1.yaml +++ b/third_party/googleapis/google/cloud/binaryauthorization/v1beta1/binaryauthorization_v1beta1.yaml @@ -21,6 +21,9 @@ documentation: Sets the access control policy on the specified resource. Replaces any existing policy. + Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and + PERMISSION_DENIED + - selector: google.iam.v1.IAMPolicy.TestIamPermissions description: |- Returns permissions that a caller has on the specified resource. If the @@ -31,25 +34,6 @@ documentation: permission-aware UIs and command-line tools, not for authorization checking. This operation may "fail open" without warning. -http: - rules: - - selector: google.iam.v1.IAMPolicy.GetIamPolicy - get: '/v1beta1/{resource=projects/*/policy}:getIamPolicy' - additional_bindings: - - get: '/v1beta1/{resource=projects/*/attestors/*}:getIamPolicy' - - selector: google.iam.v1.IAMPolicy.SetIamPolicy - post: '/v1beta1/{resource=projects/*/policy}:setIamPolicy' - body: '*' - additional_bindings: - - post: '/v1beta1/{resource=projects/*/attestors/*}:setIamPolicy' - body: '*' - - selector: google.iam.v1.IAMPolicy.TestIamPermissions - post: '/v1beta1/{resource=projects/*/policy}:testIamPermissions' - body: '*' - additional_bindings: - - post: '/v1beta1/{resource=projects/*/attestors/*}:testIamPermissions' - body: '*' - authentication: rules: - selector: 'google.cloud.binaryauthorization.v1beta1.BinauthzManagementServiceV1Beta1.*' diff --git a/third_party/googleapis/google/cloud/binaryauthorization/v1beta1/resources.proto b/third_party/googleapis/google/cloud/binaryauthorization/v1beta1/resources.proto index 909ba9551..682500500 100644 --- a/third_party/googleapis/google/cloud/binaryauthorization/v1beta1/resources.proto +++ b/third_party/googleapis/google/cloud/binaryauthorization/v1beta1/resources.proto @@ -17,14 +17,21 @@ syntax = "proto3"; package google.cloud.binaryauthorization.v1beta1; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/timestamp.proto"; +import "google/api/annotations.proto"; option cc_enable_arenas = true; option go_package = "google.golang.org/genproto/googleapis/cloud/binaryauthorization/v1beta1;binaryauthorization"; // A [policy][google.cloud.binaryauthorization.v1beta1.Policy] for container image binary authorization. message Policy { + option (google.api.resource) = { + type: "binaryauthorization.googleapis.com/Policy" + pattern: "projects/{project}/policy" + }; + enum GlobalPolicyEvaluationMode { // Not specified: DISABLE is assumed. GLOBAL_POLICY_EVALUATION_MODE_UNSPECIFIED = 0; @@ -38,21 +45,21 @@ message Policy { // Output only. The resource name, in the format `projects/*/policy`. There is // at most one policy per project. - string name = 1; + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Optional. A descriptive comment. - string description = 6; + string description = 6 [(google.api.field_behavior) = OPTIONAL]; // Optional. Controls the evaluation of a Google-maintained global admission // policy for common system-level images. Images not covered by the global // policy will be subject to the project admission policy. This setting // has no effect when specified inside a global admission policy. - GlobalPolicyEvaluationMode global_policy_evaluation_mode = 7; + GlobalPolicyEvaluationMode global_policy_evaluation_mode = 7 [(google.api.field_behavior) = OPTIONAL]; // Optional. Admission policy whitelisting. A matching admission request will // always be permitted. This feature is typically used to exclude Google or // third-party infrastructure images from Binary Authorization policies. - repeated AdmissionWhitelistPattern admission_whitelist_patterns = 2; + repeated AdmissionWhitelistPattern admission_whitelist_patterns = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. Per-cluster admission rules. Cluster spec format: // `location.clusterId`. There can be at most one admission rule per cluster @@ -61,14 +68,14 @@ message Policy { // (e.g. us-central1). // For `clusterId` syntax restrictions see // https://cloud.google.com/container-engine/reference/rest/v1/projects.zones.clusters. - map cluster_admission_rules = 3; + map cluster_admission_rules = 3 [(google.api.field_behavior) = OPTIONAL]; // Required. Default admission rule for a cluster without a per-cluster, per- // kubernetes-service-account, or per-istio-service-identity admission rule. - AdmissionRule default_admission_rule = 4; + AdmissionRule default_admission_rule = 4 [(google.api.field_behavior) = REQUIRED]; // Output only. Time when the policy was last updated. - google.protobuf.Timestamp update_time = 5; + google.protobuf.Timestamp update_time = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; } // An [admission whitelist pattern][google.cloud.binaryauthorization.v1beta1.AdmissionWhitelistPattern] exempts images @@ -119,7 +126,7 @@ message AdmissionRule { } // Required. How this admission rule will be evaluated. - EvaluationMode evaluation_mode = 1; + EvaluationMode evaluation_mode = 1 [(google.api.field_behavior) = REQUIRED]; // Optional. The resource names of the attestors that must attest to // a container image, in the format `projects/*/attestors/*`. Each @@ -129,23 +136,28 @@ message AdmissionRule { // // Note: this field must be non-empty when the evaluation_mode field specifies // REQUIRE_ATTESTATION, otherwise it must be empty. - repeated string require_attestations_by = 2; + repeated string require_attestations_by = 2 [(google.api.field_behavior) = OPTIONAL]; // Required. The action when a pod creation is denied by the admission rule. - EnforcementMode enforcement_mode = 3; + EnforcementMode enforcement_mode = 3 [(google.api.field_behavior) = REQUIRED]; } // An [attestor][google.cloud.binaryauthorization.v1beta1.Attestor] that attests to container image // artifacts. An existing attestor cannot be modified except where // indicated. message Attestor { + option (google.api.resource) = { + type: "binaryauthorization.googleapis.com/Attestor" + pattern: "projects/{project}/attestors/{attestor}" + }; + // Required. The resource name, in the format: // `projects/*/attestors/*`. This field may not be updated. - string name = 1; + string name = 1 [(google.api.field_behavior) = REQUIRED]; // Optional. A descriptive comment. This field may be updated. // The field may be displayed in chooser dialogs. - string description = 6; + string description = 6 [(google.api.field_behavior) = OPTIONAL]; // Required. Identifies an [attestor][google.cloud.binaryauthorization.v1beta1.Attestor] that attests to a // container image artifact. This determines how an attestation will @@ -158,7 +170,7 @@ message Attestor { } // Output only. Time when the attestor was last updated. - google.protobuf.Timestamp update_time = 4; + google.protobuf.Timestamp update_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; } // An [user owned drydock note][google.cloud.binaryauthorization.v1beta1.UserOwnedDrydockNote] references a Drydock @@ -171,7 +183,7 @@ message UserOwnedDrydockNote { // An attestation by this attestor is stored as a Drydock // ATTESTATION_AUTHORITY Occurrence that names a container image and that // links to this Note. Drydock is an external dependency. - string note_reference = 1; + string note_reference = 1 [(google.api.field_behavior) = REQUIRED]; // Optional. Public keys that verify attestations signed by this // attestor. This field may be updated. @@ -182,7 +194,7 @@ message UserOwnedDrydockNote { // // If this field is empty, this attestor always returns that no // valid attestations exist. - repeated AttestorPublicKey public_keys = 2; + repeated AttestorPublicKey public_keys = 2 [(google.api.field_behavior) = OPTIONAL]; // Output only. This field will contain the service account email address // that this Attestor will use as the principal when querying Container @@ -193,7 +205,7 @@ message UserOwnedDrydockNote { // This email address is fixed for the lifetime of the Attestor, but callers // should not make any other assumptions about the service account email; // future versions may use an email based on a different naming pattern. - string delegation_service_account_email = 3; + string delegation_service_account_email = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; } // A public key in the PkixPublicKey format (see @@ -261,7 +273,7 @@ message PkixPublicKey { // attestations signed by this attestor. message AttestorPublicKey { // Optional. A descriptive comment. This field may be updated. - string comment = 1; + string comment = 1 [(google.api.field_behavior) = OPTIONAL]; // The ID of this public key. // Signatures verified by BinAuthz must include the ID of the public key that diff --git a/third_party/googleapis/google/cloud/binaryauthorization/v1beta1/service.proto b/third_party/googleapis/google/cloud/binaryauthorization/v1beta1/service.proto index 33bef1db8..f2e5f59e4 100644 --- a/third_party/googleapis/google/cloud/binaryauthorization/v1beta1/service.proto +++ b/third_party/googleapis/google/cloud/binaryauthorization/v1beta1/service.proto @@ -18,6 +18,9 @@ syntax = "proto3"; package google.cloud.binaryauthorization.v1beta1; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/cloud/binaryauthorization/v1beta1/resources.proto"; import "google/protobuf/empty.proto"; @@ -33,18 +36,22 @@ option go_package = "google.golang.org/genproto/googleapis/cloud/binaryauthoriza // // * [Policy][google.cloud.binaryauthorization.v1beta1.Policy] // * [Attestor][google.cloud.binaryauthorization.v1beta1.Attestor] -// -// A [policy][google.cloud.binaryauthorization.v1beta1.Policy] specifies the [attestors][google.cloud.binaryauthorization.v1beta1.Attestor] that must attest to -// a container image, before the project is allowed to deploy that -// image. There is at most one policy per project. All image admission -// requests are permitted if a project has no policy. service BinauthzManagementServiceV1Beta1 { + option (google.api.default_host) = "binaryauthorization.googleapis.com"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; + + // A [policy][google.cloud.binaryauthorization.v1beta1.Policy] specifies the [attestors][google.cloud.binaryauthorization.v1beta1.Attestor] that must attest to + // a container image, before the project is allowed to deploy that + // image. There is at most one policy per project. All image admission + // requests are permitted if a project has no policy. + // // Gets the [policy][google.cloud.binaryauthorization.v1beta1.Policy] for this project. Returns a default // [policy][google.cloud.binaryauthorization.v1beta1.Policy] if the project does not have one. rpc GetPolicy(GetPolicyRequest) returns (Policy) { option (google.api.http) = { get: "/v1beta1/{name=projects/*/policy}" }; + option (google.api.method_signature) = "name"; } // Creates or updates a project's [policy][google.cloud.binaryauthorization.v1beta1.Policy], and returns a copy of the @@ -57,6 +64,7 @@ service BinauthzManagementServiceV1Beta1 { put: "/v1beta1/{policy.name=projects/*/policy}" body: "policy" }; + option (google.api.method_signature) = "policy"; } // Creates an [attestor][google.cloud.binaryauthorization.v1beta1.Attestor], and returns a copy of the new @@ -68,6 +76,7 @@ service BinauthzManagementServiceV1Beta1 { post: "/v1beta1/{parent=projects/*}/attestors" body: "attestor" }; + option (google.api.method_signature) = "parent,attestor_id,attestor"; } // Gets an [attestor][google.cloud.binaryauthorization.v1beta1.Attestor]. @@ -76,6 +85,7 @@ service BinauthzManagementServiceV1Beta1 { option (google.api.http) = { get: "/v1beta1/{name=projects/*/attestors/*}" }; + option (google.api.method_signature) = "name"; } // Updates an [attestor][google.cloud.binaryauthorization.v1beta1.Attestor]. @@ -85,6 +95,7 @@ service BinauthzManagementServiceV1Beta1 { put: "/v1beta1/{attestor.name=projects/*/attestors/*}" body: "attestor" }; + option (google.api.method_signature) = "attestor"; } // Lists [attestors][google.cloud.binaryauthorization.v1beta1.Attestor]. @@ -93,6 +104,7 @@ service BinauthzManagementServiceV1Beta1 { option (google.api.http) = { get: "/v1beta1/{parent=projects/*}/attestors" }; + option (google.api.method_signature) = "parent"; } // Deletes an [attestor][google.cloud.binaryauthorization.v1beta1.Attestor]. Returns NOT_FOUND if the @@ -101,6 +113,7 @@ service BinauthzManagementServiceV1Beta1 { option (google.api.http) = { delete: "/v1beta1/{name=projects/*/attestors/*}" }; + option (google.api.method_signature) = "name"; } } @@ -108,7 +121,12 @@ service BinauthzManagementServiceV1Beta1 { message GetPolicyRequest { // Required. The resource name of the [policy][google.cloud.binaryauthorization.v1beta1.Policy] to retrieve, // in the format `projects/*/policy`. - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "binaryauthorization.googleapis.com/Policy" + } + ]; } // Request message for [BinauthzManagementService.UpdatePolicy][]. @@ -116,28 +134,38 @@ message UpdatePolicyRequest { // Required. A new or updated [policy][google.cloud.binaryauthorization.v1beta1.Policy] value. The service will // overwrite the [policy name][google.cloud.binaryauthorization.v1beta1.Policy.name] field with the resource name in // the request URL, in the format `projects/*/policy`. - Policy policy = 1; + Policy policy = 1 [(google.api.field_behavior) = REQUIRED]; } // Request message for [BinauthzManagementService.CreateAttestor][]. message CreateAttestorRequest { // Required. The parent of this [attestor][google.cloud.binaryauthorization.v1beta1.Attestor]. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudresourcemanager.googleapis.com/Project" + } + ]; // Required. The [attestors][google.cloud.binaryauthorization.v1beta1.Attestor] ID. - string attestor_id = 2; + string attestor_id = 2 [(google.api.field_behavior) = REQUIRED]; // Required. The initial [attestor][google.cloud.binaryauthorization.v1beta1.Attestor] value. The service will // overwrite the [attestor name][google.cloud.binaryauthorization.v1beta1.Attestor.name] field with the resource name, // in the format `projects/*/attestors/*`. - Attestor attestor = 3; + Attestor attestor = 3 [(google.api.field_behavior) = REQUIRED]; } // Request message for [BinauthzManagementService.GetAttestor][]. message GetAttestorRequest { // Required. The name of the [attestor][google.cloud.binaryauthorization.v1beta1.Attestor] to retrieve, in the format // `projects/*/attestors/*`. - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "binaryauthorization.googleapis.com/Attestor" + } + ]; } // Request message for [BinauthzManagementService.UpdateAttestor][]. @@ -145,14 +173,19 @@ message UpdateAttestorRequest { // Required. The updated [attestor][google.cloud.binaryauthorization.v1beta1.Attestor] value. The service will // overwrite the [attestor name][google.cloud.binaryauthorization.v1beta1.Attestor.name] field with the resource name // in the request URL, in the format `projects/*/attestors/*`. - Attestor attestor = 1; + Attestor attestor = 1 [(google.api.field_behavior) = REQUIRED]; } // Request message for [BinauthzManagementService.ListAttestors][]. message ListAttestorsRequest { // Required. The resource name of the project associated with the // [attestors][google.cloud.binaryauthorization.v1beta1.Attestor], in the format `projects/*`. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudresourcemanager.googleapis.com/Project" + } + ]; // Requested page size. The server may return fewer results than requested. If // unspecified, the server will pick an appropriate default. @@ -179,5 +212,10 @@ message ListAttestorsResponse { message DeleteAttestorRequest { // Required. The name of the [attestors][google.cloud.binaryauthorization.v1beta1.Attestor] to delete, in the format // `projects/*/attestors/*`. - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "binaryauthorization.googleapis.com/Attestor" + } + ]; } diff --git a/third_party/googleapis/google/cloud/common_resources.proto b/third_party/googleapis/google/cloud/common_resources.proto new file mode 100644 index 000000000..56c9f800d --- /dev/null +++ b/third_party/googleapis/google/cloud/common_resources.proto @@ -0,0 +1,52 @@ +// Copyright 2019 Google LLC. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// This file contains stub messages for common resources in GCP. +// It is not intended to be directly generated, and is instead used by +// other tooling to be able to match common resource patterns. +syntax = "proto3"; + +package google.cloud; + +import "google/api/resource.proto"; + + +option (google.api.resource_definition) = { + type: "cloudresourcemanager.googleapis.com/Project" + pattern: "projects/{project}" +}; + + +option (google.api.resource_definition) = { + type: "cloudresourcemanager.googleapis.com/Organization" + pattern: "organizations/{organization}" +}; + + +option (google.api.resource_definition) = { + type: "cloudresourcemanager.googleapis.com/Folder" + pattern: "folders/{folder}" +}; + + +option (google.api.resource_definition) = { + type: "cloudbilling.googleapis.com/BillingAccount" + pattern: "billingAccounts/{billing_account}" +}; + +option (google.api.resource_definition) = { + type: "locations.googleapis.com/Location" + pattern: "projects/{project}/locations/{location}" +}; + diff --git a/third_party/googleapis/google/cloud/datacatalog/v1/BUILD.bazel b/third_party/googleapis/google/cloud/datacatalog/v1/BUILD.bazel new file mode 100644 index 000000000..ddea6a7a2 --- /dev/null +++ b/third_party/googleapis/google/cloud/datacatalog/v1/BUILD.bazel @@ -0,0 +1,377 @@ +# This file was automatically generated by BuildFileGenerator + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") +load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") + +proto_library( + name = "datacatalog_proto", + srcs = [ + "common.proto", + "datacatalog.proto", + "gcs_fileset_spec.proto", + "schema.proto", + "search.proto", + "table_spec.proto", + "tags.proto", + "timestamps.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/iam/v1:iam_policy_proto", + "//google/iam/v1:policy_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +proto_library_with_info( + name = "datacatalog_proto_with_info", + deps = [ + ":datacatalog_proto", + "//google/cloud:common_resources_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", + "java_proto_library", +) + +java_proto_library( + name = "datacatalog_java_proto", + deps = [":datacatalog_proto"], +) + +java_grpc_library( + name = "datacatalog_java_grpc", + srcs = [":datacatalog_proto"], + deps = [":datacatalog_java_proto"], +) + +java_gapic_library( + name = "datacatalog_java_gapic", + src = ":datacatalog_proto_with_info", + gapic_yaml = "datacatalog_gapic.yaml", + package = "google.cloud.datacatalog.v1", + service_yaml = "datacatalog_v1.yaml", + test_deps = [ + ":datacatalog_java_grpc", + "//google/iam/v1:iam_java_grpc", + ], + deps = [ + ":datacatalog_java_proto", + "//google/iam/v1:iam_java_proto", + ], +) + +java_gapic_test( + name = "datacatalog_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.datacatalog.v1.DataCatalogClientTest", + ], + runtime_deps = [":datacatalog_java_gapic_test"], +) + +# Open Source Packages +java_gapic_assembly_gradle_pkg( + name = "google-cloud-datacatalog-v1-java", + deps = [ + ":datacatalog_java_gapic", + ":datacatalog_java_grpc", + ":datacatalog_java_proto", + ":datacatalog_proto", + ], +) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", + "go_proto_library", + "go_test", +) + +go_proto_library( + name = "datacatalog_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1", + protos = [":datacatalog_proto"], + deps = [ + "//google/api:annotations_go_proto", + "//google/iam/v1:iam_go_proto", + ], +) + +go_gapic_library( + name = "datacatalog_go_gapic", + srcs = [":datacatalog_proto_with_info"], + grpc_service_config = "datacatalog_grpc_service_config.json", + importpath = "cloud.google.com/go/datacatalog/apiv1;datacatalog", + service_yaml = "datacatalog_v1.yaml", + deps = [ + ":datacatalog_go_proto", + "//google/iam/v1:iam_go_proto", + ], +) + +go_test( + name = "datacatalog_go_gapic_test", + srcs = [":datacatalog_go_gapic_srcjar_test"], + embed = [":datacatalog_go_gapic"], + importpath = "cloud.google.com/go/datacatalog/apiv1", +) + +# Open Source Packages +go_gapic_assembly_pkg( + name = "gapi-cloud-datacatalog-v1-go", + deps = [ + ":datacatalog_go_gapic", + ":datacatalog_go_gapic_srcjar-test.srcjar", + ":datacatalog_go_proto", + ], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "datacatalog_moved_proto", + srcs = [":datacatalog_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/iam/v1:iam_policy_proto", + "//google/iam/v1:policy_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +py_proto_library( + name = "datacatalog_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":datacatalog_moved_proto"], +) + +py_grpc_library( + name = "datacatalog_py_grpc", + srcs = [":datacatalog_moved_proto"], + deps = [":datacatalog_py_proto"], +) + +py_gapic_library( + name = "datacatalog_py_gapic", + src = ":datacatalog_proto_with_info", + gapic_yaml = "datacatalog_gapic.yaml", + package = "google.cloud.datacatalog.v1", + service_yaml = "datacatalog_v1.yaml", + deps = [ + ":datacatalog_py_grpc", + ":datacatalog_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "datacatalog-v1-py", + deps = [ + ":datacatalog_py_gapic", + ":datacatalog_py_grpc", + ":datacatalog_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "datacatalog_php_proto", + deps = [":datacatalog_proto"], +) + +php_grpc_library( + name = "datacatalog_php_grpc", + srcs = [":datacatalog_proto"], + deps = [":datacatalog_php_proto"], +) + +php_gapic_library( + name = "datacatalog_php_gapic", + src = ":datacatalog_proto_with_info", + gapic_yaml = "datacatalog_gapic.yaml", + package = "google.cloud.datacatalog.v1", + service_yaml = "datacatalog_v1.yaml", + deps = [ + ":datacatalog_php_grpc", + ":datacatalog_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-datacatalog-v1-php", + deps = [ + ":datacatalog_php_gapic", + ":datacatalog_php_grpc", + ":datacatalog_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "datacatalog_nodejs_gapic", + src = ":datacatalog_proto_with_info", + gapic_yaml = "datacatalog_gapic.yaml", + package = "google.cloud.datacatalog.v1", + service_yaml = "datacatalog_v1.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "datacatalog-v1-nodejs", + deps = [ + ":datacatalog_nodejs_gapic", + ":datacatalog_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "datacatalog_ruby_proto", + deps = [":datacatalog_proto"], +) + +ruby_grpc_library( + name = "datacatalog_ruby_grpc", + srcs = [":datacatalog_proto"], + deps = [":datacatalog_ruby_proto"], +) + +ruby_gapic_library( + name = "datacatalog_ruby_gapic", + src = ":datacatalog_proto_with_info", + gapic_yaml = "datacatalog_gapic.yaml", + package = "google.cloud.datacatalog.v1", + service_yaml = "datacatalog_v1.yaml", + deps = [ + ":datacatalog_ruby_grpc", + ":datacatalog_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-datacatalog-v1-ruby", + deps = [ + ":datacatalog_ruby_gapic", + ":datacatalog_ruby_grpc", + ":datacatalog_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "datacatalog_csharp_proto", + deps = [":datacatalog_proto"], +) + +csharp_grpc_library( + name = "datacatalog_csharp_grpc", + srcs = [":datacatalog_proto"], + deps = [":datacatalog_csharp_proto"], +) + +csharp_gapic_library( + name = "datacatalog_csharp_gapic", + src = ":datacatalog_proto_with_info", + gapic_yaml = "datacatalog_gapic.yaml", + package = "google.cloud.datacatalog.v1", + service_yaml = "datacatalog_v1.yaml", + deps = [ + ":datacatalog_csharp_grpc", + ":datacatalog_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-datacatalog-v1-csharp", + deps = [ + ":datacatalog_csharp_gapic", + ":datacatalog_csharp_grpc", + ":datacatalog_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/cloud/datacatalog/v1/common.proto b/third_party/googleapis/google/cloud/datacatalog/v1/common.proto new file mode 100644 index 000000000..bb31bceb8 --- /dev/null +++ b/third_party/googleapis/google/cloud/datacatalog/v1/common.proto @@ -0,0 +1,38 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.datacatalog.v1; + +option cc_enable_arenas = true; +option csharp_namespace = "Google.Cloud.DataCatalog.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1;datacatalog"; +option java_multiple_files = true; +option java_package = "com.google.cloud.datacatalog.v1"; +option php_namespace = "Google\\Cloud\\DataCatalog\\V1"; +option ruby_package = "Google::Cloud::DataCatalog::V1"; + +// This enum describes all the possible systems that Data Catalog integrates +// with. +enum IntegratedSystem { + // Default unknown system. + INTEGRATED_SYSTEM_UNSPECIFIED = 0; + + // BigQuery. + BIGQUERY = 1; + + // Cloud Pub/Sub. + CLOUD_PUBSUB = 2; +} diff --git a/third_party/googleapis/google/cloud/datacatalog/v1/datacatalog.proto b/third_party/googleapis/google/cloud/datacatalog/v1/datacatalog.proto new file mode 100644 index 000000000..c5b700ddb --- /dev/null +++ b/third_party/googleapis/google/cloud/datacatalog/v1/datacatalog.proto @@ -0,0 +1,1261 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.datacatalog.v1; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/cloud/datacatalog/v1/common.proto"; +import "google/cloud/datacatalog/v1/gcs_fileset_spec.proto"; +import "google/cloud/datacatalog/v1/schema.proto"; +import "google/cloud/datacatalog/v1/search.proto"; +import "google/cloud/datacatalog/v1/table_spec.proto"; +import "google/cloud/datacatalog/v1/tags.proto"; +import "google/cloud/datacatalog/v1/timestamps.proto"; +import "google/iam/v1/iam_policy.proto"; +import "google/iam/v1/policy.proto"; +import "google/protobuf/empty.proto"; +import "google/protobuf/field_mask.proto"; + +option cc_enable_arenas = true; +option csharp_namespace = "Google.Cloud.DataCatalog.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1;datacatalog"; +option java_multiple_files = true; +option java_package = "com.google.cloud.datacatalog.v1"; +option php_namespace = "Google\\Cloud\\DataCatalog\\V1"; +option ruby_package = "Google::Cloud::DataCatalog::V1"; + +// Data Catalog API service allows clients to discover, understand, and manage +// their data. +service DataCatalog { + option (google.api.default_host) = "datacatalog.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform"; + + // Searches Data Catalog for multiple resources like entries, tags that + // match a query. + // + // This is a custom method + // (https://cloud.google.com/apis/design/custom_methods) and does not return + // the complete resource, only the resource identifier and high level + // fields. Clients can subsequentally call `Get` methods. + // + // Note that Data Catalog search queries do not guarantee full recall. Query + // results that match your query may not be returned, even in subsequent + // result pages. Also note that results returned (and not returned) can vary + // across repeated search queries. + // + // See [Data Catalog Search + // Syntax](https://cloud.google.com/data-catalog/docs/how-to/search-reference) + // for more information. + rpc SearchCatalog(SearchCatalogRequest) returns (SearchCatalogResponse) { + option (google.api.http) = { + post: "/v1/catalog:search" + body: "*" + }; + option (google.api.method_signature) = "scope,query"; + } + + // Creates an EntryGroup. + // + // An entry group contains logically related entries together with Cloud + // Identity and Access Management policies that specify the users who can + // create, edit, and view entries within the entry group. + // + // Data Catalog automatically creates an entry group for BigQuery entries + // ("@bigquery") and Pub/Sub topics ("@pubsub"). Users create their own entry + // group to contain Cloud Storage fileset entries or custom type entries, + // and the IAM policies associated with those entries. Entry groups, like + // entries, can be searched. + // + // A maximum of 10,000 entry groups may be created per organization across all + // locations. + // + // Users should enable the Data Catalog API in the project identified by + // the `parent` parameter (see [Data Catalog Resource Project] + // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + // more information). + rpc CreateEntryGroup(CreateEntryGroupRequest) returns (EntryGroup) { + option (google.api.http) = { + post: "/v1/{parent=projects/*/locations/*}/entryGroups" + body: "entry_group" + }; + option (google.api.method_signature) = "parent,entry_group_id,entry_group"; + } + + // Gets an EntryGroup. + rpc GetEntryGroup(GetEntryGroupRequest) returns (EntryGroup) { + option (google.api.http) = { + get: "/v1/{name=projects/*/locations/*/entryGroups/*}" + }; + option (google.api.method_signature) = "name"; + option (google.api.method_signature) = "name,read_mask"; + } + + // Updates an EntryGroup. The user should enable the Data Catalog API in the + // project identified by the `entry_group.name` parameter (see [Data Catalog + // Resource Project] + // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + // more information). + rpc UpdateEntryGroup(UpdateEntryGroupRequest) returns (EntryGroup) { + option (google.api.http) = { + patch: "/v1/{entry_group.name=projects/*/locations/*/entryGroups/*}" + body: "entry_group" + }; + option (google.api.method_signature) = "entry_group"; + option (google.api.method_signature) = "entry_group,update_mask"; + } + + // Deletes an EntryGroup. Only entry groups that do not contain entries can be + // deleted. Users should enable the Data Catalog API in the project + // identified by the `name` parameter (see [Data Catalog Resource Project] + // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + // more information). + rpc DeleteEntryGroup(DeleteEntryGroupRequest) + returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1/{name=projects/*/locations/*/entryGroups/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Lists entry groups. + rpc ListEntryGroups(ListEntryGroupsRequest) + returns (ListEntryGroupsResponse) { + option (google.api.http) = { + get: "/v1/{parent=projects/*/locations/*}/entryGroups" + }; + option (google.api.method_signature) = "parent"; + } + + // Creates an entry. Only entries of 'FILESET' type or user-specified type can + // be created. + // + // Users should enable the Data Catalog API in the project identified by + // the `parent` parameter (see [Data Catalog Resource Project] + // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + // more information). + // + // A maximum of 100,000 entries may be created per entry group. + rpc CreateEntry(CreateEntryRequest) returns (Entry) { + option (google.api.http) = { + post: "/v1/{parent=projects/*/locations/*/entryGroups/*}/entries" + body: "entry" + }; + option (google.api.method_signature) = "parent,entry_id,entry"; + } + + // Updates an existing entry. + // Users should enable the Data Catalog API in the project identified by + // the `entry.name` parameter (see [Data Catalog Resource Project] + // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + // more information). + rpc UpdateEntry(UpdateEntryRequest) returns (Entry) { + option (google.api.http) = { + patch: "/v1/{entry.name=projects/*/locations/*/entryGroups/*/entries/*}" + body: "entry" + }; + option (google.api.method_signature) = "entry"; + option (google.api.method_signature) = "entry,update_mask"; + } + + // Deletes an existing entry. Only entries created through + // [CreateEntry][google.cloud.datacatalog.v1.DataCatalog.CreateEntry] + // method can be deleted. + // Users should enable the Data Catalog API in the project identified by + // the `name` parameter (see [Data Catalog Resource Project] + // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + // more information). + rpc DeleteEntry(DeleteEntryRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1/{name=projects/*/locations/*/entryGroups/*/entries/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Gets an entry. + rpc GetEntry(GetEntryRequest) returns (Entry) { + option (google.api.http) = { + get: "/v1/{name=projects/*/locations/*/entryGroups/*/entries/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Get an entry by target resource name. This method allows clients to use + // the resource name from the source Google Cloud Platform service to get the + // Data Catalog Entry. + rpc LookupEntry(LookupEntryRequest) returns (Entry) { + option (google.api.http) = { + get: "/v1/entries:lookup" + }; + } + + // Lists entries. + rpc ListEntries(ListEntriesRequest) returns (ListEntriesResponse) { + option (google.api.http) = { + get: "/v1/{parent=projects/*/locations/*/entryGroups/*}/entries" + }; + option (google.api.method_signature) = "parent"; + } + + // Creates a tag template. The user should enable the Data Catalog API in + // the project identified by the `parent` parameter (see [Data Catalog + // Resource + // Project](https://cloud.google.com/data-catalog/docs/concepts/resource-project) + // for more information). + rpc CreateTagTemplate(CreateTagTemplateRequest) returns (TagTemplate) { + option (google.api.http) = { + post: "/v1/{parent=projects/*/locations/*}/tagTemplates" + body: "tag_template" + }; + option (google.api.method_signature) = + "parent,tag_template_id,tag_template"; + } + + // Gets a tag template. + rpc GetTagTemplate(GetTagTemplateRequest) returns (TagTemplate) { + option (google.api.http) = { + get: "/v1/{name=projects/*/locations/*/tagTemplates/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Updates a tag template. This method cannot be used to update the fields of + // a template. The tag template fields are represented as separate resources + // and should be updated using their own create/update/delete methods. + // Users should enable the Data Catalog API in the project identified by + // the `tag_template.name` parameter (see [Data Catalog Resource Project] + // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + // more information). + rpc UpdateTagTemplate(UpdateTagTemplateRequest) returns (TagTemplate) { + option (google.api.http) = { + patch: "/v1/{tag_template.name=projects/*/locations/*/tagTemplates/*}" + body: "tag_template" + }; + option (google.api.method_signature) = "tag_template"; + option (google.api.method_signature) = "tag_template,update_mask"; + } + + // Deletes a tag template and all tags using the template. + // Users should enable the Data Catalog API in the project identified by + // the `name` parameter (see [Data Catalog Resource Project] + // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + // more information). + rpc DeleteTagTemplate(DeleteTagTemplateRequest) + returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1/{name=projects/*/locations/*/tagTemplates/*}" + }; + option (google.api.method_signature) = "name,force"; + } + + // Creates a field in a tag template. The user should enable the Data Catalog + // API in the project identified by the `parent` parameter (see + // [Data Catalog Resource + // Project](https://cloud.google.com/data-catalog/docs/concepts/resource-project) + // for more information). + rpc CreateTagTemplateField(CreateTagTemplateFieldRequest) + returns (TagTemplateField) { + option (google.api.http) = { + post: "/v1/{parent=projects/*/locations/*/tagTemplates/*}/fields" + body: "tag_template_field" + }; + option (google.api.method_signature) = + "parent,tag_template_field_id,tag_template_field"; + } + + // Updates a field in a tag template. This method cannot be used to update the + // field type. Users should enable the Data Catalog API in the project + // identified by the `name` parameter (see [Data Catalog Resource Project] + // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + // more information). + rpc UpdateTagTemplateField(UpdateTagTemplateFieldRequest) + returns (TagTemplateField) { + option (google.api.http) = { + patch: "/v1/{name=projects/*/locations/*/tagTemplates/*/fields/*}" + body: "tag_template_field" + }; + option (google.api.method_signature) = "name,tag_template_field"; + option (google.api.method_signature) = + "name,tag_template_field,update_mask"; + } + + // Renames a field in a tag template. The user should enable the Data Catalog + // API in the project identified by the `name` parameter (see [Data Catalog + // Resource + // Project](https://cloud.google.com/data-catalog/docs/concepts/resource-project) + // for more information). + rpc RenameTagTemplateField(RenameTagTemplateFieldRequest) + returns (TagTemplateField) { + option (google.api.http) = { + post: "/v1/{name=projects/*/locations/*/tagTemplates/*/fields/*}:rename" + body: "*" + }; + option (google.api.method_signature) = "name,new_tag_template_field_id"; + } + + // Deletes a field in a tag template and all uses of that field. + // Users should enable the Data Catalog API in the project identified by + // the `name` parameter (see [Data Catalog Resource Project] + // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + // more information). + rpc DeleteTagTemplateField(DeleteTagTemplateFieldRequest) + returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1/{name=projects/*/locations/*/tagTemplates/*/fields/*}" + }; + option (google.api.method_signature) = "name,force"; + } + + // Creates a tag on an [Entry][google.cloud.datacatalog.v1.Entry]. + // Note: The project identified by the `parent` parameter for the + // [tag](https://cloud.google.com/data-catalog/docs/reference/rest/v1/projects.locations.entryGroups.entries.tags/create#path-parameters) + // and the + // [tag + // template](https://cloud.google.com/data-catalog/docs/reference/rest/v1/projects.locations.tagTemplates/create#path-parameters) + // used to create the tag must be from the same organization. + rpc CreateTag(CreateTagRequest) returns (Tag) { + option (google.api.http) = { + post: "/v1/{parent=projects/*/locations/*/entryGroups/*/entries/*}/tags" + body: "tag" + additional_bindings { + post: "/v1/{parent=projects/*/locations/*/entryGroups/*}/tags" + body: "tag" + } + }; + option (google.api.method_signature) = "parent,tag"; + } + + // Updates an existing tag. + rpc UpdateTag(UpdateTagRequest) returns (Tag) { + option (google.api.http) = { + patch: "/v1/{tag.name=projects/*/locations/*/entryGroups/*/entries/*/tags/*}" + body: "tag" + additional_bindings { + patch: "/v1/{tag.name=projects/*/locations/*/entryGroups/*/tags/*}" + body: "tag" + } + }; + option (google.api.method_signature) = "tag"; + option (google.api.method_signature) = "tag,update_mask"; + } + + // Deletes a tag. + rpc DeleteTag(DeleteTagRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1/{name=projects/*/locations/*/entryGroups/*/entries/*/tags/*}" + additional_bindings { + delete: "/v1/{name=projects/*/locations/*/entryGroups/*/tags/*}" + } + }; + option (google.api.method_signature) = "name"; + } + + // Lists the tags on an [Entry][google.cloud.datacatalog.v1.Entry]. + rpc ListTags(ListTagsRequest) returns (ListTagsResponse) { + option (google.api.http) = { + get: "/v1/{parent=projects/*/locations/*/entryGroups/*/entries/*}/tags" + additional_bindings { + get: "/v1/{parent=projects/*/locations/*/entryGroups/*}/tags" + } + }; + option (google.api.method_signature) = "parent"; + } + + // Sets the access control policy for a resource. Replaces any existing + // policy. + // Supported resources are: + // - Tag templates. + // - Entries. + // - Entry groups. + // Note, this method cannot be used to manage policies for BigQuery, Pub/Sub + // and any external Google Cloud Platform resources synced to Data Catalog. + // + // Callers must have following Google IAM permission + // - `datacatalog.tagTemplates.setIamPolicy` to set policies on tag + // templates. + // - `datacatalog.entries.setIamPolicy` to set policies on entries. + // - `datacatalog.entryGroups.setIamPolicy` to set policies on entry groups. + rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) + returns (google.iam.v1.Policy) { + option (google.api.http) = { + post: "/v1/{resource=projects/*/locations/*/tagTemplates/*}:setIamPolicy" + body: "*" + additional_bindings { + post: "/v1/{resource=projects/*/locations/*/entryGroups/*}:setIamPolicy" + body: "*" + } + }; + option (google.api.method_signature) = "resource,policy"; + } + + // Gets the access control policy for a resource. A `NOT_FOUND` error + // is returned if the resource does not exist. An empty policy is returned + // if the resource exists but does not have a policy set on it. + // + // Supported resources are: + // - Tag templates. + // - Entries. + // - Entry groups. + // Note, this method cannot be used to manage policies for BigQuery, Pub/Sub + // and any external Google Cloud Platform resources synced to Data Catalog. + // + // Callers must have following Google IAM permission + // - `datacatalog.tagTemplates.getIamPolicy` to get policies on tag + // templates. + // - `datacatalog.entries.getIamPolicy` to get policies on entries. + // - `datacatalog.entryGroups.getIamPolicy` to get policies on entry groups. + rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) + returns (google.iam.v1.Policy) { + option (google.api.http) = { + post: "/v1/{resource=projects/*/locations/*/tagTemplates/*}:getIamPolicy" + body: "*" + additional_bindings { + post: "/v1/{resource=projects/*/locations/*/entryGroups/*}:getIamPolicy" + body: "*" + } + additional_bindings { + post: "/v1/{resource=projects/*/locations/*/entryGroups/*/entries/*}:getIamPolicy" + body: "*" + } + }; + option (google.api.method_signature) = "resource"; + } + + // Returns the caller's permissions on a resource. + // If the resource does not exist, an empty set of permissions is returned + // (We don't return a `NOT_FOUND` error). + // + // Supported resources are: + // - Tag templates. + // - Entries. + // - Entry groups. + // Note, this method cannot be used to manage policies for BigQuery, Pub/Sub + // and any external Google Cloud Platform resources synced to Data Catalog. + // + // A caller is not required to have Google IAM permission to make this + // request. + rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest) + returns (google.iam.v1.TestIamPermissionsResponse) { + option (google.api.http) = { + post: "/v1/{resource=projects/*/locations/*/tagTemplates/*}:testIamPermissions" + body: "*" + additional_bindings { + post: "/v1/{resource=projects/*/locations/*/entryGroups/*}:testIamPermissions" + body: "*" + } + additional_bindings { + post: "/v1/{resource=projects/*/locations/*/entryGroups/*/entries/*}:testIamPermissions" + body: "*" + } + }; + } +} + +// Request message for +// [SearchCatalog][google.cloud.datacatalog.v1.DataCatalog.SearchCatalog]. +message SearchCatalogRequest { + // The criteria that select the subspace used for query matching. + message Scope { + // The list of organization IDs to search within. To find your organization + // ID, follow instructions in + // https://cloud.google.com/resource-manager/docs/creating-managing-organization. + repeated string include_org_ids = 2; + + // The list of project IDs to search within. To learn more about the + // distinction between project names/IDs/numbers, go to + // https://cloud.google.com/docs/overview/#projects. + repeated string include_project_ids = 3; + + // If `true`, include Google Cloud Platform (GCP) public datasets in the + // search results. Info on GCP public datasets is available at + // https://cloud.google.com/public-datasets/. By default, GCP public + // datasets are excluded. + bool include_gcp_public_datasets = 7; + + // Optional. The list of locations to search within. + // 1. If empty, search will be performed in all locations; + // 2. If any of the locations are NOT in the valid locations list, error + // will be returned; + // 3. Otherwise, search only the given locations for matching results. + // Typical usage is to leave this field empty. When a location is + // unreachable as returned in the `SearchCatalogResponse.unreachable` field, + // users can repeat the search request with this parameter set to get + // additional information on the error. + // + // Valid locations: + // * asia-east1 + // * asia-east2 + // * asia-northeast1 + // * asia-northeast2 + // * asia-northeast3 + // * asia-south1 + // * asia-southeast1 + // * australia-southeast1 + // * eu + // * europe-north1 + // * europe-west1 + // * europe-west2 + // * europe-west3 + // * europe-west4 + // * europe-west6 + // * global + // * northamerica-northeast1 + // * southamerica-east1 + // * us + // * us-central1 + // * us-east1 + // * us-east4 + // * us-west1 + // * us-west2 + repeated string restricted_locations = 16 + [(google.api.field_behavior) = OPTIONAL]; + } + + // Required. The scope of this search request. A `scope` that has empty + // `include_org_ids`, `include_project_ids` AND false + // `include_gcp_public_datasets` is considered invalid. Data Catalog will + // return an error in such a case. + Scope scope = 6 [(google.api.field_behavior) = REQUIRED]; + + // Required. The query string in search query syntax. The query must be + // non-empty. + // + // Query strings can be simple as "x" or more qualified as: + // + // * name:x + // * column:x + // * description:y + // + // Note: Query tokens need to have a minimum of 3 characters for substring + // matching to work correctly. See [Data Catalog Search + // Syntax](https://cloud.google.com/data-catalog/docs/how-to/search-reference) + // for more information. + string query = 1 [(google.api.field_behavior) = REQUIRED]; + + // Number of results in the search page. If <=0 then defaults to 10. Max limit + // for page_size is 1000. Throws an invalid argument for page_size > 1000. + int32 page_size = 2; + + // Optional. Pagination token returned in an earlier + // [SearchCatalogResponse.next_page_token][google.cloud.datacatalog.v1.SearchCatalogResponse.next_page_token], + // which indicates that this is a continuation of a prior + // [SearchCatalogRequest][google.cloud.datacatalog.v1.DataCatalog.SearchCatalog] + // call, and that the system should return the next page of data. If empty, + // the first page is returned. + string page_token = 3 [(google.api.field_behavior) = OPTIONAL]; + + // Specifies the ordering of results, currently supported case-sensitive + // choices are: + // + // * `relevance`, only supports descending + // * `last_modified_timestamp [asc|desc]`, defaults to descending if not + // specified + // + // If not specified, defaults to `relevance` descending. + string order_by = 5; +} + +// Response message for +// [SearchCatalog][google.cloud.datacatalog.v1.DataCatalog.SearchCatalog]. +message SearchCatalogResponse { + // Search results. + repeated SearchCatalogResult results = 1; + + // The token that can be used to retrieve the next page of results. + string next_page_token = 3; + + // Unreachable locations. Search result does not include data from those + // locations. Users can get additional information on the error by repeating + // the search request with a more restrictive parameter -- setting the value + // for `SearchDataCatalogRequest.scope.include_locations`. + repeated string unreachable = 6; +} + +// Request message for +// [CreateEntryGroup][google.cloud.datacatalog.v1.DataCatalog.CreateEntryGroup]. +message CreateEntryGroupRequest { + // Required. The name of the project this entry group is in. Example: + // + // * projects/{project_id}/locations/{location} + // + // Note that this EntryGroup and its child resources may not actually be + // stored in the location in this name. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "datacatalog.googleapis.com/EntryGroup" + } + ]; + + // Required. The id of the entry group to create. + // The id must begin with a letter or underscore, contain only English + // letters, numbers and underscores, and be at most 64 characters. + string entry_group_id = 3 [(google.api.field_behavior) = REQUIRED]; + + // The entry group to create. Defaults to an empty entry group. + EntryGroup entry_group = 2; +} + +// Request message for +// [UpdateEntryGroup][google.cloud.datacatalog.v1.DataCatalog.UpdateEntryGroup]. +message UpdateEntryGroupRequest { + // Required. The updated entry group. "name" field must be set. + EntryGroup entry_group = 1 [(google.api.field_behavior) = REQUIRED]; + + // The fields to update on the entry group. If absent or empty, all modifiable + // fields are updated. + google.protobuf.FieldMask update_mask = 2; +} + +// Request message for +// [GetEntryGroup][google.cloud.datacatalog.v1.DataCatalog.GetEntryGroup]. +message GetEntryGroupRequest { + // Required. The name of the entry group. For example, + // `projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/EntryGroup" + } + ]; + + // The fields to return. If not set or empty, all fields are returned. + google.protobuf.FieldMask read_mask = 2; +} + +// Request message for +// [DeleteEntryGroup][google.cloud.datacatalog.v1.DataCatalog.DeleteEntryGroup]. +message DeleteEntryGroupRequest { + // Required. The name of the entry group. For example, + // `projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/EntryGroup" + } + ]; + + // Optional. If true, deletes all entries in the entry group. + bool force = 2 [(google.api.field_behavior) = OPTIONAL]; +} + +// Request message for +// [ListEntryGroups][google.cloud.datacatalog.v1.DataCatalog.ListEntryGroups]. +message ListEntryGroupsRequest { + // Required. The name of the location that contains the entry groups, which + // can be provided in URL format. Example: + // + // * projects/{project_id}/locations/{location} + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/EntryGroup" + } + ]; + + // Optional. The maximum number of items to return. Default is 10. Max limit + // is 1000. Throws an invalid argument for `page_size > 1000`. + int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Token that specifies which page is requested. If empty, the first + // page is returned. + string page_token = 3 [(google.api.field_behavior) = OPTIONAL]; +} + +// Response message for +// [ListEntryGroups][google.cloud.datacatalog.v1.DataCatalog.ListEntryGroups]. +message ListEntryGroupsResponse { + // EntryGroup details. + repeated EntryGroup entry_groups = 1; + + // Token to retrieve the next page of results. It is set to empty if no items + // remain in results. + string next_page_token = 2; +} + +// Request message for +// [CreateEntry][google.cloud.datacatalog.v1.DataCatalog.CreateEntry]. +message CreateEntryRequest { + // Required. The name of the entry group this entry is in. Example: + // + // * projects/{project_id}/locations/{location}/entryGroups/{entry_group_id} + // + // Note that this Entry and its child resources may not actually be stored in + // the location in this name. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/EntryGroup" + } + ]; + + // Required. The id of the entry to create. + string entry_id = 3 [(google.api.field_behavior) = REQUIRED]; + + // Required. The entry to create. + Entry entry = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// Request message for +// [UpdateEntry][google.cloud.datacatalog.v1.DataCatalog.UpdateEntry]. +message UpdateEntryRequest { + // Required. The updated entry. The "name" field must be set. + Entry entry = 1 [(google.api.field_behavior) = REQUIRED]; + + // The fields to update on the entry. If absent or empty, all modifiable + // fields are updated. + // + // The following fields are modifiable: + // * For entries with type `DATA_STREAM`: + // * `schema` + // * For entries with type `FILESET` + // * `schema` + // * `display_name` + // * `description` + // * `gcs_fileset_spec` + // * `gcs_fileset_spec.file_patterns` + // * For entries with `user_specified_type` + // * `schema` + // * `display_name` + // * `description` + // * user_specified_type + // * user_specified_system + // * linked_resource + // * source_system_timestamps + google.protobuf.FieldMask update_mask = 2; +} + +// Request message for +// [DeleteEntry][google.cloud.datacatalog.v1.DataCatalog.DeleteEntry]. +message DeleteEntryRequest { + // Required. The name of the entry. Example: + // + // * projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/Entry" + } + ]; +} + +// Request message for +// [GetEntry][google.cloud.datacatalog.v1.DataCatalog.GetEntry]. +message GetEntryRequest { + // Required. The name of the entry. Example: + // + // * projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/Entry" + } + ]; +} + +// Request message for +// [LookupEntry][google.cloud.datacatalog.v1.DataCatalog.LookupEntry]. +message LookupEntryRequest { + // Required. Represents either the Google Cloud Platform resource or SQL name + // for a Google Cloud Platform resource. + oneof target_name { + // The full name of the Google Cloud Platform resource the Data Catalog + // entry represents. See: + // https://cloud.google.com/apis/design/resource_names#full_resource_name. + // Full names are case-sensitive. + // + // Examples: + // + // * //bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/tableId + // * //pubsub.googleapis.com/projects/projectId/topics/topicId + string linked_resource = 1; + + // The SQL name of the entry. SQL names are case-sensitive. + // + // Examples: + // + // * `pubsub.project_id.topic_id` + // * ``pubsub.project_id.`topic.id.with.dots` `` + // * `bigquery.table.project_id.dataset_id.table_id` + // * `bigquery.dataset.project_id.dataset_id` + // * `datacatalog.entry.project_id.location_id.entry_group_id.entry_id` + // + // `*_id`s shoud satisfy the standard SQL rules for identifiers. + // https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical. + string sql_resource = 3; + } +} + +// Entry Metadata. +// A Data Catalog Entry resource represents another resource in Google +// Cloud Platform (such as a BigQuery dataset or a Pub/Sub topic) or +// outside of Google Cloud Platform. Clients can use the `linked_resource` field +// in the Entry resource to refer to the original resource ID of the source +// system. +// +// An Entry resource contains resource details, such as its schema. An Entry can +// also be used to attach flexible metadata, such as a +// [Tag][google.cloud.datacatalog.v1.Tag]. +message Entry { + option (google.api.resource) = { + type: "datacatalog.googleapis.com/Entry" + pattern: "projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}" + }; + + // The Data Catalog resource name of the entry in URL format. Example: + // + // * projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} + // + // Note that this Entry and its child resources may not actually be stored in + // the location in this name. + string name = 1 [(google.api.resource_reference) = { + type: "datacatalog.googleapis.com/EntryGroup" + }]; + + // The resource this metadata entry refers to. + // + // For Google Cloud Platform resources, `linked_resource` is the [full name of + // the + // resource](https://cloud.google.com/apis/design/resource_names#full_resource_name). + // For example, the `linked_resource` for a table resource from BigQuery is: + // + // * //bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/tableId + // + // Output only when Entry is of type in the EntryType enum. For entries with + // user_specified_type, this field is optional and defaults to an empty + // string. + string linked_resource = 9; + + // Required. Entry type. + oneof entry_type { + // The type of the entry. + // Only used for Entries with types in the EntryType enum. + EntryType type = 2; + + // Entry type if it does not fit any of the input-allowed values listed in + // `EntryType` enum above. When creating an entry, users should check the + // enum values first, if nothing matches the entry to be created, then + // provide a custom value, for example "my_special_type". + // `user_specified_type` strings must begin with a letter or underscore and + // can only contain letters, numbers, and underscores; are case insensitive; + // must be at least 1 character and at most 64 characters long. + // + // Currently, only FILESET enum value is allowed. All other entries created + // through Data Catalog must use `user_specified_type`. + string user_specified_type = 16; + } + + // The source system of the entry. + oneof system { + // Output only. This field indicates the entry's source system that Data + // Catalog integrates with, such as BigQuery or Pub/Sub. + IntegratedSystem integrated_system = 17 + [(google.api.field_behavior) = OUTPUT_ONLY]; + + // This field indicates the entry's source system that Data Catalog does not + // integrate with. `user_specified_system` strings must begin with a letter + // or underscore and can only contain letters, numbers, and underscores; are + // case insensitive; must be at least 1 character and at most 64 characters + // long. + string user_specified_system = 18; + } + + // Type specification information. + oneof type_spec { + // Specification that applies to a Cloud Storage fileset. This is only valid + // on entries of type FILESET. + GcsFilesetSpec gcs_fileset_spec = 6; + + // Specification that applies to a BigQuery table. This is only valid on + // entries of type `TABLE`. + BigQueryTableSpec bigquery_table_spec = 12; + + // Specification for a group of BigQuery tables with name pattern + // `[prefix]YYYYMMDD`. Context: + // https://cloud.google.com/bigquery/docs/partitioned-tables#partitioning_versus_sharding. + BigQueryDateShardedSpec bigquery_date_sharded_spec = 15; + } + + // Display information such as title and description. A short name to identify + // the entry, for example, "Analytics Data - Jan 2011". Default value is an + // empty string. + string display_name = 3; + + // Entry description, which can consist of several sentences or paragraphs + // that describe entry contents. Default value is an empty string. + string description = 4; + + // Schema of the entry. An entry might not have any schema attached to it. + Schema schema = 5; + + // Timestamps about the underlying resource, not about this Data Catalog + // entry. Output only when Entry is of type in the EntryType enum. For entries + // with user_specified_type, this field is optional and defaults to an empty + // timestamp. + SystemTimestamps source_system_timestamps = 7; +} + +// EntryGroup Metadata. +// An EntryGroup resource represents a logical grouping of zero or more +// Data Catalog [Entry][google.cloud.datacatalog.v1.Entry] resources. +message EntryGroup { + option (google.api.resource) = { + type: "datacatalog.googleapis.com/EntryGroup" + pattern: "projects/{project}/locations/{location}/entryGroups/{entry_group}" + }; + + // The resource name of the entry group in URL format. Example: + // + // * projects/{project_id}/locations/{location}/entryGroups/{entry_group_id} + // + // Note that this EntryGroup and its child resources may not actually be + // stored in the location in this name. + string name = 1; + + // A short name to identify the entry group, for example, + // "analytics data - jan 2011". Default value is an empty string. + string display_name = 2; + + // Entry group description, which can consist of several sentences or + // paragraphs that describe entry group contents. Default value is an empty + // string. + string description = 3; + + // Output only. Timestamps about this EntryGroup. Default value is empty + // timestamps. + SystemTimestamps data_catalog_timestamps = 4 + [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// Request message for +// [CreateTagTemplate][google.cloud.datacatalog.v1.DataCatalog.CreateTagTemplate]. +message CreateTagTemplateRequest { + // Required. The name of the project and the template location + // [region](https://cloud.google.com/data-catalog/docs/concepts/regions). + // + // Example: + // + // * projects/{project_id}/locations/us-central1 + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "datacatalog.googleapis.com/TagTemplate" + } + ]; + + // Required. The id of the tag template to create. + string tag_template_id = 3 [(google.api.field_behavior) = REQUIRED]; + + // Required. The tag template to create. + TagTemplate tag_template = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// Request message for +// [GetTagTemplate][google.cloud.datacatalog.v1.DataCatalog.GetTagTemplate]. +message GetTagTemplateRequest { + // Required. The name of the tag template. Example: + // + // * projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id} + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/TagTemplate" + } + ]; +} + +// Request message for +// [UpdateTagTemplate][google.cloud.datacatalog.v1.DataCatalog.UpdateTagTemplate]. +message UpdateTagTemplateRequest { + // Required. The template to update. The "name" field must be set. + TagTemplate tag_template = 1 [(google.api.field_behavior) = REQUIRED]; + + // The field mask specifies the parts of the template to overwrite. + // + // Allowed fields: + // + // * `display_name` + // + // If absent or empty, all of the allowed fields above will be updated. + google.protobuf.FieldMask update_mask = 2; +} + +// Request message for +// [DeleteTagTemplate][google.cloud.datacatalog.v1.DataCatalog.DeleteTagTemplate]. +message DeleteTagTemplateRequest { + // Required. The name of the tag template to delete. Example: + // + // * projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id} + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/TagTemplate" + } + ]; + + // Required. Currently, this field must always be set to `true`. + // This confirms the deletion of any possible tags using this template. + // `force = false` will be supported in the future. + bool force = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// Request message for +// [CreateTag][google.cloud.datacatalog.v1.DataCatalog.CreateTag]. +message CreateTagRequest { + // Required. The name of the resource to attach this tag to. Tags can be + // attached to Entries. Example: + // + // * projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} + // + // Note that this Tag and its child resources may not actually be stored in + // the location in this name. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { type: "datacatalog.googleapis.com/Tag" } + ]; + + // Required. The tag to create. + Tag tag = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// Request message for +// [UpdateTag][google.cloud.datacatalog.v1.DataCatalog.UpdateTag]. +message UpdateTagRequest { + // Required. The updated tag. The "name" field must be set. + Tag tag = 1 [(google.api.field_behavior) = REQUIRED]; + + // The fields to update on the Tag. If absent or empty, all modifiable fields + // are updated. Currently the only modifiable field is the field `fields`. + google.protobuf.FieldMask update_mask = 2; +} + +// Request message for +// [DeleteTag][google.cloud.datacatalog.v1.DataCatalog.DeleteTag]. +message DeleteTagRequest { + // Required. The name of the tag to delete. Example: + // + // * projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id}/tags/{tag_id} + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "datacatalog.googleapis.com/Tag" + } + ]; +} + +// Request message for +// [CreateTagTemplateField][google.cloud.datacatalog.v1.DataCatalog.CreateTagTemplateField]. +message CreateTagTemplateFieldRequest { + // Required. The name of the project and the template location + // [region](https://cloud.google.com/data-catalog/docs/concepts/regions). + // + // Example: + // + // * projects/{project_id}/locations/us-central1/tagTemplates/{tag_template_id} + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/TagTemplate" + } + ]; + + // Required. The ID of the tag template field to create. + // Field ids can contain letters (both uppercase and lowercase), numbers + // (0-9), underscores (_) and dashes (-). Field IDs must be at least 1 + // character long and at most 128 characters long. Field IDs must also be + // unique within their template. + string tag_template_field_id = 2 [(google.api.field_behavior) = REQUIRED]; + + // Required. The tag template field to create. + TagTemplateField tag_template_field = 3 + [(google.api.field_behavior) = REQUIRED]; +} + +// Request message for +// [UpdateTagTemplateField][google.cloud.datacatalog.v1.DataCatalog.UpdateTagTemplateField]. +message UpdateTagTemplateFieldRequest { + // Required. The name of the tag template field. Example: + // + // * projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}/fields/{tag_template_field_id} + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/TagTemplateField" + } + ]; + + // Required. The template to update. + TagTemplateField tag_template_field = 2 + [(google.api.field_behavior) = REQUIRED]; + + // Optional. The field mask specifies the parts of the template to be updated. + // Allowed fields: + // + // * `display_name` + // * `type.enum_type` + // * `is_required` + // + // If `update_mask` is not set or empty, all of the allowed fields above will + // be updated. + // + // When updating an enum type, the provided values will be merged with the + // existing values. Therefore, enum values can only be added, existing enum + // values cannot be deleted nor renamed. Updating a template field from + // optional to required is NOT allowed. + google.protobuf.FieldMask update_mask = 3 + [(google.api.field_behavior) = OPTIONAL]; +} + +// Request message for +// [RenameTagTemplateField][google.cloud.datacatalog.v1.DataCatalog.RenameTagTemplateField]. +message RenameTagTemplateFieldRequest { + // Required. The name of the tag template. Example: + // + // * projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}/fields/{tag_template_field_id} + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/TagTemplateField" + } + ]; + + // Required. The new ID of this tag template field. For example, + // `my_new_field`. + string new_tag_template_field_id = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// Request message for +// [DeleteTagTemplateField][google.cloud.datacatalog.v1.DataCatalog.DeleteTagTemplateField]. +message DeleteTagTemplateFieldRequest { + // Required. The name of the tag template field to delete. Example: + // + // * projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}/fields/{tag_template_field_id} + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/TagTemplateField" + } + ]; + + // Required. Currently, this field must always be set to `true`. + // This confirms the deletion of this field from any tags using this field. + // `force = false` will be supported in the future. + bool force = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// Request message for +// [ListTags][google.cloud.datacatalog.v1.DataCatalog.ListTags]. +message ListTagsRequest { + // Required. The name of the Data Catalog resource to list the tags of. The + // resource could be an [Entry][google.cloud.datacatalog.v1.Entry] or an + // [EntryGroup][google.cloud.datacatalog.v1.EntryGroup]. + // + // Examples: + // + // * projects/{project_id}/locations/{location}/entryGroups/{entry_group_id} + // * projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "datacatalog.googleapis.com/Tag" + } + ]; + + // The maximum number of tags to return. Default is 10. Max limit is 1000. + int32 page_size = 2; + + // Token that specifies which page is requested. If empty, the first page is + // returned. + string page_token = 3; +} + +// Response message for +// [ListTags][google.cloud.datacatalog.v1.DataCatalog.ListTags]. +message ListTagsResponse { + // [Tag][google.cloud.datacatalog.v1.Tag] details. + repeated Tag tags = 1; + + // Token to retrieve the next page of results. It is set to empty if no items + // remain in results. + string next_page_token = 2; +} + +// Request message for +// [ListEntries][google.cloud.datacatalog.v1.DataCatalog.ListEntries]. +message ListEntriesRequest { + // Required. The name of the entry group that contains the entries, which can + // be provided in URL format. Example: + // + // * projects/{project_id}/locations/{location}/entryGroups/{entry_group_id} + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/EntryGroup" + } + ]; + + // The maximum number of items to return. Default is 10. Max limit is 1000. + // Throws an invalid argument for `page_size > 1000`. + int32 page_size = 2; + + // Token that specifies which page is requested. If empty, the first page is + // returned. + string page_token = 3; + + // The fields to return for each Entry. If not set or empty, all + // fields are returned. + // For example, setting read_mask to contain only one path "name" will cause + // ListEntries to return a list of Entries with only "name" field. + google.protobuf.FieldMask read_mask = 4; +} + +// Response message for +// [ListEntries][google.cloud.datacatalog.v1.DataCatalog.ListEntries]. +message ListEntriesResponse { + // Entry details. + repeated Entry entries = 1; + + // Token to retrieve the next page of results. It is set to empty if no items + // remain in results. + string next_page_token = 2; +} + +// Entry resources in Data Catalog can be of different types e.g. a BigQuery +// Table entry is of type `TABLE`. This enum describes all the possible types +// Data Catalog contains. +enum EntryType { + // Default unknown type. + ENTRY_TYPE_UNSPECIFIED = 0; + + // Output only. The type of entry that has a GoogleSQL schema, including + // logical views. + TABLE = 2; + + // Output only. The type of models, examples include + // https://cloud.google.com/bigquery-ml/docs/bigqueryml-intro + MODEL = 5; + + // Output only. An entry type which is used for streaming entries. Example: + // Pub/Sub topic. + DATA_STREAM = 3; + + // An entry type which is a set of files or objects. Example: + // Cloud Storage fileset. + FILESET = 4; +} diff --git a/third_party/googleapis/google/cloud/datacatalog/v1/datacatalog_gapic.yaml b/third_party/googleapis/google/cloud/datacatalog/v1/datacatalog_gapic.yaml new file mode 100644 index 000000000..af0e33817 --- /dev/null +++ b/third_party/googleapis/google/cloud/datacatalog/v1/datacatalog_gapic.yaml @@ -0,0 +1,18 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 2.0.0 +language_settings: + java: + package_name: com.google.cloud.datacatalog.v1 + python: + package_name: google.cloud.datacatalog_v1.gapic + go: + package_name: cloud.google.com/go/datacatalog/apiv1 + csharp: + package_name: Google.Cloud.Datacatalog.V1 + ruby: + package_name: Google::Cloud::Datacatalog::V1 + php: + package_name: Google\Cloud\Datacatalog\V1 + nodejs: + package_name: datacatalog.v1 + domain_layer_location: google-cloud diff --git a/third_party/googleapis/google/cloud/datacatalog/v1/datacatalog_grpc_service_config.json b/third_party/googleapis/google/cloud/datacatalog/v1/datacatalog_grpc_service_config.json new file mode 100755 index 000000000..b683fa856 --- /dev/null +++ b/third_party/googleapis/google/cloud/datacatalog/v1/datacatalog_grpc_service_config.json @@ -0,0 +1,65 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.datacatalog.v1.DataCatalog" + } + ], + "timeout": "60s" + }, + { + "name": [ + { + "service": "google.cloud.datacatalog.v1.DataCatalog", + "method": "GetEntry" + }, + { + "service": "google.cloud.datacatalog.v1.DataCatalog", + "method": "GetEntryGroup" + }, + { + "service": "google.cloud.datacatalog.v1.DataCatalog", + "method": "GetIamPolicy" + }, + { + "service": "google.cloud.datacatalog.v1.DataCatalog", + "method": "GettagTemplate" + }, + { + "service": "google.cloud.datacatalog.v1.DataCatalog", + "method": "ListEntries" + }, + { + "service": "google.cloud.datacatalog.v1.DataCatalog", + "method": "ListEntryGroups" + }, + { + "service": "google.cloud.datacatalog.v1.DataCatalog", + "method": "ListTags" + }, + { + "service": "google.cloud.datacatalog.v1.DataCatalog", + "method": "LookupEntry" + }, + { + "service": "google.cloud.datacatalog.v1.DataCatalog", + "method": "SearchCatalog" + }, + { + "service": "google.cloud.datacatalog.v1.DataCatalog", + "method": "TestIamPermisisons" + } + ], + "timeout": "60s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/cloud/datacatalog/datacatalog_v1beta1.yaml b/third_party/googleapis/google/cloud/datacatalog/v1/datacatalog_v1.yaml similarity index 86% rename from third_party/googleapis/google/cloud/datacatalog/datacatalog_v1beta1.yaml rename to third_party/googleapis/google/cloud/datacatalog/v1/datacatalog_v1.yaml index 5e18b6f2f..7b8f7c609 100644 --- a/third_party/googleapis/google/cloud/datacatalog/datacatalog_v1beta1.yaml +++ b/third_party/googleapis/google/cloud/datacatalog/v1/datacatalog_v1.yaml @@ -4,7 +4,7 @@ name: datacatalog.googleapis.com title: Google Cloud Data Catalog API apis: -- name: google.cloud.datacatalog.v1beta1.DataCatalog +- name: google.cloud.datacatalog.v1.DataCatalog documentation: summary: |- @@ -26,11 +26,14 @@ documentation: Sets the access control policy on the specified resource. Replaces any existing policy. + Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` + errors. + - selector: google.iam.v1.IAMPolicy.TestIamPermissions description: |- Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of - permissions, not a NOT_FOUND error. + permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization @@ -38,7 +41,7 @@ documentation: authentication: rules: - - selector: 'google.cloud.datacatalog.v1beta1.DataCatalog.*' + - selector: 'google.cloud.datacatalog.v1.DataCatalog.*' oauth: canonical_scopes: |- https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/datacatalog/v1/gcs_fileset_spec.proto b/third_party/googleapis/google/cloud/datacatalog/v1/gcs_fileset_spec.proto new file mode 100644 index 000000000..b0605c13f --- /dev/null +++ b/third_party/googleapis/google/cloud/datacatalog/v1/gcs_fileset_spec.proto @@ -0,0 +1,75 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.datacatalog.v1; + +import "google/api/field_behavior.proto"; +import "google/cloud/datacatalog/v1/timestamps.proto"; + +option cc_enable_arenas = true; +option csharp_namespace = "Google.Cloud.DataCatalog.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1;datacatalog"; +option java_multiple_files = true; +option java_package = "com.google.cloud.datacatalog.v1"; +option php_namespace = "Google\\Cloud\\DataCatalog\\V1"; +option ruby_package = "Google::Cloud::DataCatalog::V1"; + +// Describes a Cloud Storage fileset entry. +message GcsFilesetSpec { + // Required. Patterns to identify a set of files in Google Cloud Storage. See [Cloud + // Storage documentation](/storage/docs/gsutil/addlhelp/WildcardNames) for + // more information. Note that bucket wildcards are currently not supported. + // + // Examples of valid file_patterns: + // + // * `gs://bucket_name/dir/*`: matches all files within `bucket_name/dir` + // directory. + // * `gs://bucket_name/dir/**`: matches all files in `bucket_name/dir` + // spanning all subdirectories. + // * `gs://bucket_name/file*`: matches files prefixed by `file` in + // `bucket_name` + // * `gs://bucket_name/??.txt`: matches files with two characters followed by + // `.txt` in `bucket_name` + // * `gs://bucket_name/[aeiou].txt`: matches files that contain a single + // vowel character followed by `.txt` in + // `bucket_name` + // * `gs://bucket_name/[a-m].txt`: matches files that contain `a`, `b`, ... + // or `m` followed by `.txt` in `bucket_name` + // * `gs://bucket_name/a/*/b`: matches all files in `bucket_name` that match + // `a/*/b` pattern, such as `a/c/b`, `a/d/b` + // * `gs://another_bucket/a.txt`: matches `gs://another_bucket/a.txt` + // + // You can combine wildcards to provide more powerful matches, for example: + // + // * `gs://bucket_name/[a-m]??.j*g` + repeated string file_patterns = 1 [(google.api.field_behavior) = REQUIRED]; + + // Output only. Sample files contained in this fileset, not all files + // contained in this fileset are represented here. + repeated GcsFileSpec sample_gcs_file_specs = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// Specifications of a single file in Cloud Storage. +message GcsFileSpec { + // Required. The full file path. Example: `gs://bucket_name/a/b.txt`. + string file_path = 1 [(google.api.field_behavior) = REQUIRED]; + + // Output only. Timestamps about the Cloud Storage file. + SystemTimestamps gcs_timestamps = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The size of the file, in bytes. + int64 size_bytes = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/cloud/datacatalog/v1/schema.proto b/third_party/googleapis/google/cloud/datacatalog/v1/schema.proto new file mode 100644 index 000000000..c34d99e27 --- /dev/null +++ b/third_party/googleapis/google/cloud/datacatalog/v1/schema.proto @@ -0,0 +1,55 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.datacatalog.v1; + +import "google/api/field_behavior.proto"; + +option cc_enable_arenas = true; +option csharp_namespace = "Google.Cloud.DataCatalog.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1;datacatalog"; +option java_multiple_files = true; +option java_package = "com.google.cloud.datacatalog.v1"; +option php_namespace = "Google\\Cloud\\DataCatalog\\V1"; +option ruby_package = "Google::Cloud::DataCatalog::V1"; + +// Represents a schema (e.g. BigQuery, GoogleSQL, Avro schema). +message Schema { + // Required. Schema of columns. A maximum of 10,000 columns and sub-columns can be + // specified. + repeated ColumnSchema columns = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// Representation of a column within a schema. Columns could be nested inside +// other columns. +message ColumnSchema { + // Required. Name of the column. + string column = 6 [(google.api.field_behavior) = REQUIRED]; + + // Required. Type of the column. + string type = 1 [(google.api.field_behavior) = REQUIRED]; + + // Optional. Description of the column. Default value is an empty string. + string description = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. A column's mode indicates whether the values in this column are required, + // nullable, etc. Only `NULLABLE`, `REQUIRED` and `REPEATED` are supported. + // Default mode is `NULLABLE`. + string mode = 3 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Schema of sub-columns. A column can have zero or more sub-columns. + repeated ColumnSchema subcolumns = 7 [(google.api.field_behavior) = OPTIONAL]; +} diff --git a/third_party/googleapis/google/cloud/datacatalog/v1/search.proto b/third_party/googleapis/google/cloud/datacatalog/v1/search.proto new file mode 100644 index 000000000..37f6923b1 --- /dev/null +++ b/third_party/googleapis/google/cloud/datacatalog/v1/search.proto @@ -0,0 +1,84 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.datacatalog.v1; + +import "google/api/field_behavior.proto"; +import "google/cloud/datacatalog/v1/common.proto"; +import "google/protobuf/timestamp.proto"; + +option cc_enable_arenas = true; +option csharp_namespace = "Google.Cloud.DataCatalog.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1;datacatalog"; +option java_multiple_files = true; +option java_package = "com.google.cloud.datacatalog.v1"; +option php_namespace = "Google\\Cloud\\DataCatalog\\V1"; +option ruby_package = "Google::Cloud::DataCatalog::V1"; + +// A result that appears in the response of a search request. Each result +// captures details of one entry that matches the search. +message SearchCatalogResult { + // Type of the search result. This field can be used to determine which Get + // method to call to fetch the full resource. + SearchResultType search_result_type = 1; + + // Sub-type of the search result. This is a dot-delimited description of the + // resource's full type, and is the same as the value callers would provide in + // the "type" search facet. Examples: `entry.table`, `entry.dataStream`, + // `tagTemplate`. + string search_result_subtype = 2; + + // The relative resource name of the resource in URL format. + // Examples: + // + // * `projects/{project_id}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}` + // * `projects/{project_id}/tagTemplates/{tag_template_id}` + string relative_resource_name = 3; + + // The full name of the cloud resource the entry belongs to. See: + // https://cloud.google.com/apis/design/resource_names#full_resource_name. + // Example: + // + // * `//bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/tableId` + string linked_resource = 4; + + // The source system of the entry. Only applicable when `search_result_type` + // is ENTRY. + oneof system { + // Output only. This field indicates the entry's source system that Data Catalog + // integrates with, such as BigQuery or Cloud Pub/Sub. + IntegratedSystem integrated_system = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // This field indicates the entry's source system that Data Catalog does not + // integrate with. + string user_specified_system = 9; + } +} + +// The different types of resources that can be returned in search. +enum SearchResultType { + // Default unknown type. + SEARCH_RESULT_TYPE_UNSPECIFIED = 0; + + // An [Entry][google.cloud.datacatalog.v1.Entry]. + ENTRY = 1; + + // A [TagTemplate][google.cloud.datacatalog.v1.TagTemplate]. + TAG_TEMPLATE = 2; + + // An [EntryGroup][google.cloud.datacatalog.v1.EntryGroup]. + ENTRY_GROUP = 3; +} diff --git a/third_party/googleapis/google/cloud/datacatalog/v1/table_spec.proto b/third_party/googleapis/google/cloud/datacatalog/v1/table_spec.proto new file mode 100644 index 000000000..c87afc54c --- /dev/null +++ b/third_party/googleapis/google/cloud/datacatalog/v1/table_spec.proto @@ -0,0 +1,101 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.datacatalog.v1; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + +option cc_enable_arenas = true; +option csharp_namespace = "Google.Cloud.DataCatalog.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1;datacatalog"; +option java_multiple_files = true; +option java_package = "com.google.cloud.datacatalog.v1"; +option php_namespace = "Google\\Cloud\\DataCatalog\\V1"; +option ruby_package = "Google::Cloud::DataCatalog::V1"; + +// Describes a BigQuery table. +message BigQueryTableSpec { + // Output only. The table source type. + TableSourceType table_source_type = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. + oneof type_spec { + // Table view specification. This field should only be populated if + // `table_source_type` is `BIGQUERY_VIEW`. + ViewSpec view_spec = 2; + + // Spec of a BigQuery table. This field should only be populated if + // `table_source_type` is `BIGQUERY_TABLE`. + TableSpec table_spec = 3; + } +} + +// Table source type. +enum TableSourceType { + // Default unknown type. + TABLE_SOURCE_TYPE_UNSPECIFIED = 0; + + // Table view. + BIGQUERY_VIEW = 2; + + // BigQuery native table. + BIGQUERY_TABLE = 5; +} + +// Table view specification. +message ViewSpec { + // Output only. The query that defines the table view. + string view_query = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// Normal BigQuery table spec. +message TableSpec { + // Output only. If the table is a dated shard, i.e., with name pattern `[prefix]YYYYMMDD`, + // `grouped_entry` is the Data Catalog resource name of the date sharded + // grouped entry, for example, + // `projects/{project_id}/locations/{location}/entrygroups/{entry_group_id}/entries/{entry_id}`. + // Otherwise, `grouped_entry` is empty. + string grouped_entry = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/Entry" + } + ]; +} + +// Spec for a group of BigQuery tables with name pattern `[prefix]YYYYMMDD`. +// Context: +// https://cloud.google.com/bigquery/docs/partitioned-tables#partitioning_versus_sharding +message BigQueryDateShardedSpec { + // Output only. The Data Catalog resource name of the dataset entry the current table + // belongs to, for example, + // `projects/{project_id}/locations/{location}/entrygroups/{entry_group_id}/entries/{entry_id}`. + string dataset = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/Entry" + } + ]; + + // Output only. The table name prefix of the shards. The name of any given shard is + // `[table_prefix]YYYYMMDD`, for example, for shard `MyTable20180101`, the + // `table_prefix` is `MyTable`. + string table_prefix = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Total number of shards. + int64 shard_count = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/cloud/datacatalog/v1/tags.proto b/third_party/googleapis/google/cloud/datacatalog/v1/tags.proto new file mode 100644 index 000000000..4efefa522 --- /dev/null +++ b/third_party/googleapis/google/cloud/datacatalog/v1/tags.proto @@ -0,0 +1,229 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.datacatalog.v1; + +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/timestamp.proto"; + +option cc_enable_arenas = true; +option csharp_namespace = "Google.Cloud.DataCatalog.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1;datacatalog"; +option java_multiple_files = true; +option java_package = "com.google.cloud.datacatalog.v1"; +option php_namespace = "Google\\Cloud\\DataCatalog\\V1"; +option ruby_package = "Google::Cloud::DataCatalog::V1"; + +// Tags are used to attach custom metadata to Data Catalog resources. Tags +// conform to the specifications within their tag template. +// +// See [Data Catalog +// IAM](https://cloud.google.com/data-catalog/docs/concepts/iam) for information +// on the permissions needed to create or view tags. +message Tag { + option (google.api.resource) = { + type: "datacatalog.googleapis.com/Tag" + pattern: "projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}/tags/{tag}" + }; + + // The resource name of the tag in URL format. Example: + // + // * projects/{project_id}/locations/{location}/entrygroups/{entry_group_id}/entries/{entry_id}/tags/{tag_id} + // + // where `tag_id` is a system-generated identifier. + // Note that this Tag may not actually be stored in the location in this name. + string name = 1; + + // Required. The resource name of the tag template that this tag uses. Example: + // + // * projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id} + // + // This field cannot be modified after creation. + string template = 2 [(google.api.field_behavior) = REQUIRED]; + + // Output only. The display name of the tag template. + string template_display_name = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The scope within the parent resource that this tag is attached to. If not + // provided, the tag is attached to the parent resource itself. + // Deleting the scope from the parent resource will delete all tags attached + // to that scope. These fields cannot be updated after creation. + oneof scope { + // Resources like Entry can have schemas associated with them. This scope + // allows users to attach tags to an individual column based on that schema. + // + // For attaching a tag to a nested column, use `.` to separate the column + // names. Example: + // + // * `outer_column.inner_column` + string column = 4; + } + + // Required. This maps the ID of a tag field to the value of and additional information + // about that field. Valid field IDs are defined by the tag's template. A tag + // must have at least 1 field and at most 500 fields. + map fields = 3 [(google.api.field_behavior) = REQUIRED]; +} + +// Contains the value and supporting information for a field within +// a [Tag][google.cloud.datacatalog.v1.Tag]. +message TagField { + // Holds an enum value. + message EnumValue { + // The display name of the enum value. + string display_name = 1; + } + + // Output only. The display name of this field. + string display_name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Required. The value of this field. + oneof kind { + // Holds the value for a tag field with double type. + double double_value = 2; + + // Holds the value for a tag field with string type. + string string_value = 3; + + // Holds the value for a tag field with boolean type. + bool bool_value = 4; + + // Holds the value for a tag field with timestamp type. + google.protobuf.Timestamp timestamp_value = 5; + + // Holds the value for a tag field with enum type. This value must be + // one of the allowed values in the definition of this enum. + EnumValue enum_value = 6; + } + + // Output only. The order of this field with respect to other fields in this tag. It can be + // set in [Tag][google.cloud.datacatalog.v1.TagTemplateField.order]. For + // example, a higher value can indicate a more important field. The value can + // be negative. Multiple fields can have the same order, and field orders + // within a tag do not have to be sequential. + int32 order = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// A tag template defines a tag, which can have one or more typed fields. +// The template is used to create and attach the tag to GCP resources. +// [Tag template +// roles](https://cloud.google.com/iam/docs/understanding-roles#data-catalog-roles) +// provide permissions to create, edit, and use the template. See, for example, +// the [TagTemplate +// User](https://cloud.google.com/data-catalog/docs/how-to/template-user) role, +// which includes permission to use the tag template to tag resources. +message TagTemplate { + option (google.api.resource) = { + type: "datacatalog.googleapis.com/TagTemplate" + pattern: "projects/{project}/locations/{location}/tagTemplates/{tag_template}" + }; + + // The resource name of the tag template in URL format. Example: + // + // * projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id} + // + // Note that this TagTemplate and its child resources may not actually be + // stored in the location in this name. + string name = 1; + + // The display name for this template. Defaults to an empty string. + string display_name = 2; + + // Required. Map of tag template field IDs to the settings for the field. + // This map is an exhaustive list of the allowed fields. This map must contain + // at least one field and at most 500 fields. + // + // The keys to this map are tag template field IDs. Field IDs can contain + // letters (both uppercase and lowercase), numbers (0-9) and underscores (_). + // Field IDs must be at least 1 character long and at most + // 64 characters long. Field IDs must start with a letter or underscore. + map fields = 3 [(google.api.field_behavior) = REQUIRED]; +} + +// The template for an individual field within a tag template. +message TagTemplateField { + option (google.api.resource) = { + type: "datacatalog.googleapis.com/TagTemplateField" + pattern: "projects/{project}/locations/{location}/tagTemplates/{tag_template}/fields/{field}" + }; + + // Output only. The resource name of the tag template field in URL format. Example: + // + // * projects/{project_id}/locations/{location}/tagTemplates/{tag_template}/fields/{field} + // + // Note that this TagTemplateField may not actually be stored in the location + // in this name. + string name = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The display name for this field. Defaults to an empty string. + string display_name = 1; + + // Required. The type of value this tag field can contain. + FieldType type = 2 [(google.api.field_behavior) = REQUIRED]; + + // Whether this is a required field. Defaults to false. + bool is_required = 3; + + // The order of this field with respect to other fields in this tag + // template. For example, a higher value can indicate a more important field. + // The value can be negative. Multiple fields can have the same order, and + // field orders within a tag do not have to be sequential. + int32 order = 5; +} + +message FieldType { + message EnumType { + message EnumValue { + // Required. The display name of the enum value. Must not be an empty string. + string display_name = 1 [(google.api.field_behavior) = REQUIRED]; + } + + // Required on create; optional on update. The set of allowed values for + // this enum. This set must not be empty, the display names of the values in + // this set must not be empty and the display names of the values must be + // case-insensitively unique within this set. Currently, enum values can + // only be added to the list of allowed values. Deletion and renaming of + // enum values are not supported. Can have up to 500 allowed values. + repeated EnumValue allowed_values = 1; + } + + enum PrimitiveType { + // This is the default invalid value for a type. + PRIMITIVE_TYPE_UNSPECIFIED = 0; + + // A double precision number. + DOUBLE = 1; + + // An UTF-8 string. + STRING = 2; + + // A boolean value. + BOOL = 3; + + // A timestamp. + TIMESTAMP = 4; + } + + // Required. + oneof type_decl { + // Represents primitive types - string, bool etc. + PrimitiveType primitive_type = 1; + + // Represents an enum type. + EnumType enum_type = 2; + } +} diff --git a/third_party/googleapis/google/cloud/datacatalog/v1/timestamps.proto b/third_party/googleapis/google/cloud/datacatalog/v1/timestamps.proto new file mode 100644 index 000000000..a4372ae3c --- /dev/null +++ b/third_party/googleapis/google/cloud/datacatalog/v1/timestamps.proto @@ -0,0 +1,41 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.datacatalog.v1; + +import "google/api/field_behavior.proto"; +import "google/protobuf/timestamp.proto"; + +option cc_enable_arenas = true; +option csharp_namespace = "Google.Cloud.DataCatalog.V1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1;datacatalog"; +option java_multiple_files = true; +option java_package = "com.google.cloud.datacatalog.v1"; +option php_namespace = "Google\\Cloud\\DataCatalog\\V1"; +option ruby_package = "Google::Cloud::DataCatalog::V1"; + +// Timestamps about this resource according to a particular system. +message SystemTimestamps { + // The creation time of the resource within the given system. + google.protobuf.Timestamp create_time = 1; + + // The last-modified time of the resource within the given system. + google.protobuf.Timestamp update_time = 2; + + // Output only. The expiration time of the resource within the given system. + // Currently only apllicable to BigQuery resources. + google.protobuf.Timestamp expire_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/cloud/datacatalog/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/datacatalog/v1beta1/BUILD.bazel new file mode 100644 index 000000000..864a16355 --- /dev/null +++ b/third_party/googleapis/google/cloud/datacatalog/v1beta1/BUILD.bazel @@ -0,0 +1,381 @@ +# This file was automatically generated by BuildFileGenerator + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") +load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") + +proto_library( + name = "datacatalog_proto", + srcs = [ + "common.proto", + "datacatalog.proto", + "gcs_fileset_spec.proto", + "policytagmanager.proto", + "policytagmanagerserialization.proto", + "schema.proto", + "search.proto", + "table_spec.proto", + "tags.proto", + "timestamps.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/iam/v1:iam_policy_proto", + "//google/iam/v1:policy_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +proto_library_with_info( + name = "datacatalog_proto_with_info", + deps = [ + ":datacatalog_proto", + "//google/cloud:common_resources_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", + "java_proto_library", +) + +java_proto_library( + name = "datacatalog_java_proto", + deps = [":datacatalog_proto"], +) + +java_grpc_library( + name = "datacatalog_java_grpc", + srcs = [":datacatalog_proto"], + deps = [":datacatalog_java_proto"], +) + +java_gapic_library( + name = "datacatalog_java_gapic", + src = ":datacatalog_proto_with_info", + gapic_yaml = "datacatalog_gapic.yaml", + package = "google.cloud.datacatalog.v1beta1", + service_yaml = "datacatalog_v1beta1.yaml", + test_deps = [ + ":datacatalog_java_grpc", + "//google/iam/v1:iam_java_grpc", + ], + deps = [ + ":datacatalog_java_proto", + "//google/iam/v1:iam_java_proto", + ], +) + +java_gapic_test( + name = "datacatalog_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.datacatalog.v1beta1.DataCatalogClientTest", + "com.google.cloud.datacatalog.v1beta1.PolicyTagManagerClientTest", + "com.google.cloud.datacatalog.v1beta1.PolicyTagManagerSerializationClientTest", + ], + runtime_deps = [":datacatalog_java_gapic_test"], +) + +# Open Source Packages +java_gapic_assembly_gradle_pkg( + name = "google-cloud-datacatalog-v1beta1-java", + deps = [ + ":datacatalog_java_gapic", + ":datacatalog_java_grpc", + ":datacatalog_java_proto", + ":datacatalog_proto", + ], +) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", + "go_proto_library", + "go_test", +) + +go_proto_library( + name = "datacatalog_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1", + protos = [":datacatalog_proto"], + deps = [ + "//google/api:annotations_go_proto", + "//google/iam/v1:iam_go_proto", + ], +) + +go_gapic_library( + name = "datacatalog_go_gapic", + srcs = [":datacatalog_proto_with_info"], + grpc_service_config = "datacatalog_grpc_service_config.json", + importpath = "cloud.google.com/go/datacatalog/apiv1beta1;datacatalog", + service_yaml = "datacatalog_v1beta1.yaml", + deps = [ + ":datacatalog_go_proto", + "//google/iam/v1:iam_go_proto", + ], +) + +go_test( + name = "datacatalog_go_gapic_test", + srcs = [":datacatalog_go_gapic_srcjar_test"], + embed = [":datacatalog_go_gapic"], + importpath = "cloud.google.com/go/datacatalog/apiv1beta1", +) + +# Open Source Packages +go_gapic_assembly_pkg( + name = "gapi-cloud-datacatalog-v1beta1-go", + deps = [ + ":datacatalog_go_gapic", + ":datacatalog_go_gapic_srcjar-test.srcjar", + ":datacatalog_go_proto", + ], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "datacatalog_moved_proto", + srcs = [":datacatalog_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/iam/v1:iam_policy_proto", + "//google/iam/v1:policy_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +py_proto_library( + name = "datacatalog_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":datacatalog_moved_proto"], +) + +py_grpc_library( + name = "datacatalog_py_grpc", + srcs = [":datacatalog_moved_proto"], + deps = [":datacatalog_py_proto"], +) + +py_gapic_library( + name = "datacatalog_py_gapic", + src = ":datacatalog_proto_with_info", + gapic_yaml = "datacatalog_gapic.yaml", + package = "google.cloud.datacatalog.v1beta1", + service_yaml = "datacatalog_v1beta1.yaml", + deps = [ + ":datacatalog_py_grpc", + ":datacatalog_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "datacatalog-v1beta1-py", + deps = [ + ":datacatalog_py_gapic", + ":datacatalog_py_grpc", + ":datacatalog_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "datacatalog_php_proto", + deps = [":datacatalog_proto"], +) + +php_grpc_library( + name = "datacatalog_php_grpc", + srcs = [":datacatalog_proto"], + deps = [":datacatalog_php_proto"], +) + +php_gapic_library( + name = "datacatalog_php_gapic", + src = ":datacatalog_proto_with_info", + gapic_yaml = "datacatalog_gapic.yaml", + package = "google.cloud.datacatalog.v1beta1", + service_yaml = "datacatalog_v1beta1.yaml", + deps = [ + ":datacatalog_php_grpc", + ":datacatalog_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-datacatalog-v1beta1-php", + deps = [ + ":datacatalog_php_gapic", + ":datacatalog_php_grpc", + ":datacatalog_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "datacatalog_nodejs_gapic", + src = ":datacatalog_proto_with_info", + gapic_yaml = "datacatalog_gapic.yaml", + package = "google.cloud.datacatalog.v1beta1", + service_yaml = "datacatalog_v1beta1.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "datacatalog-v1beta1-nodejs", + deps = [ + ":datacatalog_nodejs_gapic", + ":datacatalog_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "datacatalog_ruby_proto", + deps = [":datacatalog_proto"], +) + +ruby_grpc_library( + name = "datacatalog_ruby_grpc", + srcs = [":datacatalog_proto"], + deps = [":datacatalog_ruby_proto"], +) + +ruby_gapic_library( + name = "datacatalog_ruby_gapic", + src = ":datacatalog_proto_with_info", + gapic_yaml = "datacatalog_gapic.yaml", + package = "google.cloud.datacatalog.v1beta1", + service_yaml = "datacatalog_v1beta1.yaml", + deps = [ + ":datacatalog_ruby_grpc", + ":datacatalog_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-datacatalog-v1beta1-ruby", + deps = [ + ":datacatalog_ruby_gapic", + ":datacatalog_ruby_grpc", + ":datacatalog_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "datacatalog_csharp_proto", + deps = [":datacatalog_proto"], +) + +csharp_grpc_library( + name = "datacatalog_csharp_grpc", + srcs = [":datacatalog_proto"], + deps = [":datacatalog_csharp_proto"], +) + +csharp_gapic_library( + name = "datacatalog_csharp_gapic", + src = ":datacatalog_proto_with_info", + gapic_yaml = "datacatalog_gapic.yaml", + package = "google.cloud.datacatalog.v1beta1", + service_yaml = "datacatalog_v1beta1.yaml", + deps = [ + ":datacatalog_csharp_grpc", + ":datacatalog_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-datacatalog-v1beta1-csharp", + deps = [ + ":datacatalog_csharp_gapic", + ":datacatalog_csharp_grpc", + ":datacatalog_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/cloud/datacatalog/artman_datacatalog_v1beta1.yaml b/third_party/googleapis/google/cloud/datacatalog/v1beta1/artman_datacatalog_v1beta1.yaml similarity index 91% rename from third_party/googleapis/google/cloud/datacatalog/artman_datacatalog_v1beta1.yaml rename to third_party/googleapis/google/cloud/datacatalog/v1beta1/artman_datacatalog_v1beta1.yaml index e3fdc8ca3..a410e5af1 100644 --- a/third_party/googleapis/google/cloud/datacatalog/artman_datacatalog_v1beta1.yaml +++ b/third_party/googleapis/google/cloud/datacatalog/v1beta1/artman_datacatalog_v1beta1.yaml @@ -5,9 +5,9 @@ common: proto_deps: - name: google-common-protos src_proto_paths: - - v1beta1 + - . service_yaml: datacatalog_v1beta1.yaml - gapic_yaml: v1beta1/datacatalog_gapic.yaml + gapic_yaml: datacatalog_gapic.yaml artifacts: - name: gapic_config type: GAPIC_CONFIG diff --git a/third_party/googleapis/google/cloud/datacatalog/v1beta1/common.proto b/third_party/googleapis/google/cloud/datacatalog/v1beta1/common.proto new file mode 100644 index 000000000..a759b371e --- /dev/null +++ b/third_party/googleapis/google/cloud/datacatalog/v1beta1/common.proto @@ -0,0 +1,38 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.datacatalog.v1beta1; + +option cc_enable_arenas = true; +option csharp_namespace = "Google.Cloud.DataCatalog.V1Beta1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog"; +option java_multiple_files = true; +option java_package = "com.google.cloud.datacatalog.v1beta1"; +option php_namespace = "Google\\Cloud\\DataCatalog\\V1beta1"; +option ruby_package = "Google::Cloud::DataCatalog::V1beta1"; + +// This enum describes all the possible systems that Data Catalog integrates +// with. +enum IntegratedSystem { + // Default unknown system. + INTEGRATED_SYSTEM_UNSPECIFIED = 0; + + // BigQuery. + BIGQUERY = 1; + + // Cloud Pub/Sub. + CLOUD_PUBSUB = 2; +} diff --git a/third_party/googleapis/google/cloud/datacatalog/v1beta1/datacatalog.proto b/third_party/googleapis/google/cloud/datacatalog/v1beta1/datacatalog.proto index e89e7ad62..038e2203f 100644 --- a/third_party/googleapis/google/cloud/datacatalog/v1beta1/datacatalog.proto +++ b/third_party/googleapis/google/cloud/datacatalog/v1beta1/datacatalog.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,17 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.datacatalog.v1beta1; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/cloud/datacatalog/v1beta1/common.proto"; +import "google/cloud/datacatalog/v1beta1/gcs_fileset_spec.proto"; import "google/cloud/datacatalog/v1beta1/schema.proto"; import "google/cloud/datacatalog/v1beta1/search.proto"; import "google/cloud/datacatalog/v1beta1/table_spec.proto"; @@ -27,12 +31,14 @@ import "google/iam/v1/iam_policy.proto"; import "google/iam/v1/policy.proto"; import "google/protobuf/empty.proto"; import "google/protobuf/field_mask.proto"; -import "google/api/client.proto"; option cc_enable_arenas = true; +option csharp_namespace = "Google.Cloud.DataCatalog.V1Beta1"; option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog"; option java_multiple_files = true; -option java_package = "com.google.cloud.datacatalog"; +option java_package = "com.google.cloud.datacatalog.v1beta1"; +option php_namespace = "Google\\Cloud\\DataCatalog\\V1beta1"; +option ruby_package = "Google::Cloud::DataCatalog::V1beta1"; // Data Catalog API service allows clients to discover, understand, and manage // their data. @@ -46,28 +52,125 @@ service DataCatalog { // This is a custom method // (https://cloud.google.com/apis/design/custom_methods) and does not return // the complete resource, only the resource identifier and high level - // fields. Clients can subsequentally call Get methods. + // fields. Clients can subsequentally call `Get` methods. // - // Note that searches do not have full recall. There may be results that match - // your query but are not returned, even in subsequent pages of results. These - // missing results may vary across repeated calls to search. Do not rely on - // this method if you need to guarantee full recall. + // Note that Data Catalog search queries do not guarantee full recall. Query + // results that match your query may not be returned, even in subsequent + // result pages. Also note that results returned (and not returned) can vary + // across repeated search queries. // // See [Data Catalog Search - // Syntax](/data-catalog/docs/how-to/search-reference) for more information. + // Syntax](https://cloud.google.com/data-catalog/docs/how-to/search-reference) + // for more information. rpc SearchCatalog(SearchCatalogRequest) returns (SearchCatalogResponse) { option (google.api.http) = { post: "/v1beta1/catalog:search" body: "*" }; + option (google.api.method_signature) = "scope,query"; + } + + // A maximum of 10,000 entry groups may be created per organization across all + // locations. + // + // Users should enable the Data Catalog API in the project identified by + // the `parent` parameter (see [Data Catalog Resource Project] + // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + // more information). + rpc CreateEntryGroup(CreateEntryGroupRequest) returns (EntryGroup) { + option (google.api.http) = { + post: "/v1beta1/{parent=projects/*/locations/*}/entryGroups" + body: "entry_group" + }; + option (google.api.method_signature) = "parent,entry_group_id,entry_group"; + } + + // Updates an EntryGroup. The user should enable the Data Catalog API in the + // project identified by the `entry_group.name` parameter (see [Data Catalog + // Resource Project] + // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + // more information). + rpc UpdateEntryGroup(UpdateEntryGroupRequest) returns (EntryGroup) { + option (google.api.http) = { + patch: "/v1beta1/{entry_group.name=projects/*/locations/*/entryGroups/*}" + body: "entry_group" + }; + option (google.api.method_signature) = "entry_group"; + option (google.api.method_signature) = "entry_group,update_mask"; + } + + // Gets an EntryGroup. + rpc GetEntryGroup(GetEntryGroupRequest) returns (EntryGroup) { + option (google.api.http) = { + get: "/v1beta1/{name=projects/*/locations/*/entryGroups/*}" + }; + option (google.api.method_signature) = "name"; + option (google.api.method_signature) = "name,read_mask"; + } + + // Deletes an EntryGroup. Only entry groups that do not contain entries can be + // deleted. Users should enable the Data Catalog API in the project + // identified by the `name` parameter (see [Data Catalog Resource Project] + // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + // more information). + rpc DeleteEntryGroup(DeleteEntryGroupRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1beta1/{name=projects/*/locations/*/entryGroups/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Lists entry groups. + rpc ListEntryGroups(ListEntryGroupsRequest) returns (ListEntryGroupsResponse) { + option (google.api.http) = { + get: "/v1beta1/{parent=projects/*/locations/*}/entryGroups" + }; + option (google.api.method_signature) = "parent"; + } + + // Creates an entry. Only entries of 'FILESET' type or user-specified type can + // be created. + // + // Users should enable the Data Catalog API in the project identified by + // the `parent` parameter (see [Data Catalog Resource Project] + // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + // more information). + // + // A maximum of 100,000 entries may be created per entry group. + rpc CreateEntry(CreateEntryRequest) returns (Entry) { + option (google.api.http) = { + post: "/v1beta1/{parent=projects/*/locations/*/entryGroups/*}/entries" + body: "entry" + }; + option (google.api.method_signature) = "parent,entry_id,entry"; } // Updates an existing entry. + // Users should enable the Data Catalog API in the project identified by + // the `entry.name` parameter (see [Data Catalog Resource Project] + // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + // more information). rpc UpdateEntry(UpdateEntryRequest) returns (Entry) { option (google.api.http) = { patch: "/v1beta1/{entry.name=projects/*/locations/*/entryGroups/*/entries/*}" body: "entry" }; + option (google.api.method_signature) = "entry"; + option (google.api.method_signature) = "entry,update_mask"; + } + + // Deletes an existing entry. Only entries created through + // [CreateEntry][google.cloud.datacatalog.v1beta1.DataCatalog.CreateEntry] + // method can be deleted. + // Users should enable the Data Catalog API in the project identified by + // the `name` parameter (see [Data Catalog Resource Project] + // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + // more information). + rpc DeleteEntry(DeleteEntryRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1beta1/{name=projects/*/locations/*/entryGroups/*/entries/*}" + }; + option (google.api.method_signature) = "name"; } // Gets an entry. @@ -75,6 +178,7 @@ service DataCatalog { option (google.api.http) = { get: "/v1beta1/{name=projects/*/locations/*/entryGroups/*/entries/*}" }; + option (google.api.method_signature) = "name"; } // Get an entry by target resource name. This method allows clients to use @@ -86,12 +190,25 @@ service DataCatalog { }; } - // Creates a tag template. + // Lists entries. + rpc ListEntries(ListEntriesRequest) returns (ListEntriesResponse) { + option (google.api.http) = { + get: "/v1beta1/{parent=projects/*/locations/*/entryGroups/*}/entries" + }; + option (google.api.method_signature) = "parent"; + } + + // Creates a tag template. The user should enable the Data Catalog API in + // the project identified by the `parent` parameter (see [Data Catalog + // Resource + // Project](https://cloud.google.com/data-catalog/docs/concepts/resource-project) + // for more information). rpc CreateTagTemplate(CreateTagTemplateRequest) returns (TagTemplate) { option (google.api.http) = { post: "/v1beta1/{parent=projects/*/locations/*}/tagTemplates" body: "tag_template" }; + option (google.api.method_signature) = "parent,tag_template_id,tag_template"; } // Gets a tag template. @@ -99,63 +216,106 @@ service DataCatalog { option (google.api.http) = { get: "/v1beta1/{name=projects/*/locations/*/tagTemplates/*}" }; + option (google.api.method_signature) = "name"; } // Updates a tag template. This method cannot be used to update the fields of // a template. The tag template fields are represented as separate resources // and should be updated using their own create/update/delete methods. + // Users should enable the Data Catalog API in the project identified by + // the `tag_template.name` parameter (see [Data Catalog Resource Project] + // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + // more information). rpc UpdateTagTemplate(UpdateTagTemplateRequest) returns (TagTemplate) { option (google.api.http) = { patch: "/v1beta1/{tag_template.name=projects/*/locations/*/tagTemplates/*}" body: "tag_template" }; + option (google.api.method_signature) = "tag_template"; + option (google.api.method_signature) = "tag_template,update_mask"; } // Deletes a tag template and all tags using the template. + // Users should enable the Data Catalog API in the project identified by + // the `name` parameter (see [Data Catalog Resource Project] + // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + // more information). rpc DeleteTagTemplate(DeleteTagTemplateRequest) returns (google.protobuf.Empty) { option (google.api.http) = { delete: "/v1beta1/{name=projects/*/locations/*/tagTemplates/*}" }; + option (google.api.method_signature) = "name,force"; } - // Creates a field in a tag template. + // Creates a field in a tag template. The user should enable the Data Catalog + // API in the project identified by the `parent` parameter (see + // [Data Catalog Resource + // Project](https://cloud.google.com/data-catalog/docs/concepts/resource-project) + // for more information). rpc CreateTagTemplateField(CreateTagTemplateFieldRequest) returns (TagTemplateField) { option (google.api.http) = { post: "/v1beta1/{parent=projects/*/locations/*/tagTemplates/*}/fields" body: "tag_template_field" }; + option (google.api.method_signature) = "parent,tag_template_field_id,tag_template_field"; } // Updates a field in a tag template. This method cannot be used to update the - // field type. + // field type. Users should enable the Data Catalog API in the project + // identified by the `name` parameter (see [Data Catalog Resource Project] + // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + // more information). rpc UpdateTagTemplateField(UpdateTagTemplateFieldRequest) returns (TagTemplateField) { option (google.api.http) = { patch: "/v1beta1/{name=projects/*/locations/*/tagTemplates/*/fields/*}" body: "tag_template_field" }; + option (google.api.method_signature) = "name,tag_template_field"; + option (google.api.method_signature) = "name,tag_template_field,update_mask"; } - // Renames a field in a tag template. + // Renames a field in a tag template. The user should enable the Data Catalog + // API in the project identified by the `name` parameter (see [Data Catalog + // Resource + // Project](https://cloud.google.com/data-catalog/docs/concepts/resource-project) + // for more information). rpc RenameTagTemplateField(RenameTagTemplateFieldRequest) returns (TagTemplateField) { option (google.api.http) = { post: "/v1beta1/{name=projects/*/locations/*/tagTemplates/*/fields/*}:rename" body: "*" }; + option (google.api.method_signature) = "name,new_tag_template_field_id"; } // Deletes a field in a tag template and all uses of that field. + // Users should enable the Data Catalog API in the project identified by + // the `name` parameter (see [Data Catalog Resource Project] + // (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for + // more information). rpc DeleteTagTemplateField(DeleteTagTemplateFieldRequest) returns (google.protobuf.Empty) { option (google.api.http) = { delete: "/v1beta1/{name=projects/*/locations/*/tagTemplates/*/fields/*}" }; + option (google.api.method_signature) = "name,force"; } // Creates a tag on an [Entry][google.cloud.datacatalog.v1beta1.Entry]. + // Note: The project identified by the `parent` parameter for the + // [tag](https://cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.entryGroups.entries.tags/create#path-parameters) + // and the + // [tag + // template](https://cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.tagTemplates/create#path-parameters) + // used to create the tag must be from the same organization. rpc CreateTag(CreateTagRequest) returns (Tag) { option (google.api.http) = { post: "/v1beta1/{parent=projects/*/locations/*/entryGroups/*/entries/*}/tags" body: "tag" + additional_bindings { + post: "/v1beta1/{parent=projects/*/locations/*/entryGroups/*}/tags" + body: "tag" + } }; + option (google.api.method_signature) = "parent,tag"; } // Updates an existing tag. @@ -163,38 +323,62 @@ service DataCatalog { option (google.api.http) = { patch: "/v1beta1/{tag.name=projects/*/locations/*/entryGroups/*/entries/*/tags/*}" body: "tag" + additional_bindings { + patch: "/v1beta1/{tag.name=projects/*/locations/*/entryGroups/*/tags/*}" + body: "tag" + } }; + option (google.api.method_signature) = "tag"; + option (google.api.method_signature) = "tag,update_mask"; } // Deletes a tag. rpc DeleteTag(DeleteTagRequest) returns (google.protobuf.Empty) { option (google.api.http) = { delete: "/v1beta1/{name=projects/*/locations/*/entryGroups/*/entries/*/tags/*}" + additional_bindings { + delete: "/v1beta1/{name=projects/*/locations/*/entryGroups/*/tags/*}" + } }; + option (google.api.method_signature) = "name"; } // Lists the tags on an [Entry][google.cloud.datacatalog.v1beta1.Entry]. rpc ListTags(ListTagsRequest) returns (ListTagsResponse) { option (google.api.http) = { get: "/v1beta1/{parent=projects/*/locations/*/entryGroups/*/entries/*}/tags" + additional_bindings { + get: "/v1beta1/{parent=projects/*/locations/*/entryGroups/*}/tags" + } }; + option (google.api.method_signature) = "parent"; } // Sets the access control policy for a resource. Replaces any existing // policy. // Supported resources are: // - Tag templates. - // Note, this method cannot be used to manage policies for BigQuery, Cloud - // Pub/Sub and any external Google Cloud Platform resources synced to Cloud - // Data Catalog. + // - Entries. + // - Entry groups. + // Note, this method cannot be used to manage policies for BigQuery, Pub/Sub + // and any external Google Cloud Platform resources synced to Data Catalog. // // Callers must have following Google IAM permission - // `datacatalog.tagTemplates.setIamPolicy` to set policies on tag templates. + // - `datacatalog.tagTemplates.setIamPolicy` to set policies on tag + // templates. + // - `datacatalog.entries.setIamPolicy` to set policies on entries. + // - `datacatalog.entryGroups.setIamPolicy` to set policies on entry groups. rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) returns (google.iam.v1.Policy) { option (google.api.http) = { post: "/v1beta1/{resource=projects/*/locations/*/tagTemplates/*}:setIamPolicy" body: "*" + additional_bindings { + post: "/v1beta1/{resource=projects/*/locations/*/entryGroups/*}:setIamPolicy" + body: "*" + } }; + + option (google.api.method_signature) = "resource,policy"; } // Gets the access control policy for a resource. A `NOT_FOUND` error @@ -203,28 +387,42 @@ service DataCatalog { // // Supported resources are: // - Tag templates. - // Note, this method cannot be used to manage policies for BigQuery, Cloud - // Pub/Sub and any external Google Cloud Platform resources synced to Cloud - // Data Catalog. + // - Entries. + // - Entry groups. + // Note, this method cannot be used to manage policies for BigQuery, Pub/Sub + // and any external Google Cloud Platform resources synced to Data Catalog. // // Callers must have following Google IAM permission - // `datacatalog.tagTemplates.getIamPolicy` to get policies on tag templates. + // - `datacatalog.tagTemplates.getIamPolicy` to get policies on tag + // templates. + // - `datacatalog.entries.getIamPolicy` to get policies on entries. + // - `datacatalog.entryGroups.getIamPolicy` to get policies on entry groups. rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) returns (google.iam.v1.Policy) { option (google.api.http) = { post: "/v1beta1/{resource=projects/*/locations/*/tagTemplates/*}:getIamPolicy" body: "*" + additional_bindings { + post: "/v1beta1/{resource=projects/*/locations/*/entryGroups/*}:getIamPolicy" + body: "*" + } + additional_bindings { + post: "/v1beta1/{resource=projects/*/locations/*/entryGroups/*/entries/*}:getIamPolicy" + body: "*" + } }; + option (google.api.method_signature) = "resource"; } // Returns the caller's permissions on a resource. // If the resource does not exist, an empty set of permissions is returned // (We don't return a `NOT_FOUND` error). // - // Supported resource are: - // - tag templates. - // Note, this method cannot be used to manage policies for BigQuery, Cloud - // Pub/Sub and any external Google Cloud Platform resources synced to Cloud - // Data Catalog. + // Supported resources are: + // - Tag templates. + // - Entries. + // - Entry groups. + // Note, this method cannot be used to manage policies for BigQuery, Pub/Sub + // and any external Google Cloud Platform resources synced to Data Catalog. // // A caller is not required to have Google IAM permission to make this // request. @@ -232,6 +430,14 @@ service DataCatalog { option (google.api.http) = { post: "/v1beta1/{resource=projects/*/locations/*/tagTemplates/*}:testIamPermissions" body: "*" + additional_bindings { + post: "/v1beta1/{resource=projects/*/locations/*/entryGroups/*}:testIamPermissions" + body: "*" + } + additional_bindings { + post: "/v1beta1/{resource=projects/*/locations/*/entryGroups/*/entries/*}:testIamPermissions" + body: "*" + } }; } } @@ -239,35 +445,32 @@ service DataCatalog { // Request message for // [SearchCatalog][google.cloud.datacatalog.v1beta1.DataCatalog.SearchCatalog]. message SearchCatalogRequest { + // The criteria that select the subspace used for query matching. message Scope { - // Data Catalog tries to automatically choose the right corpus of data to - // search through. You can ensure an organization is included by adding it - // to "include_org_ids". You can ensure a project's org is included with - // "include_project_ids". You must specify at least one organization - // using "include_org_ids" or "include_project_ids" in all search requests. - // - // List of organization IDs to search within. To find your organization ID, - // follow instructions in - // https://cloud.google.com/resource-manager/docs/creating-managing-organization + // The list of organization IDs to search within. To find your organization + // ID, follow instructions in + // https://cloud.google.com/resource-manager/docs/creating-managing-organization. repeated string include_org_ids = 2; - // List of project IDs to search within. To learn more about the + // The list of project IDs to search within. To learn more about the // distinction between project names/IDs/numbers, go to - // https://cloud.google.com/docs/overview/#projects + // https://cloud.google.com/docs/overview/#projects. repeated string include_project_ids = 3; - // If true, include Google Cloud Platform (GCP) public datasets in the + // If `true`, include Google Cloud Platform (GCP) public datasets in the // search results. Info on GCP public datasets is available at // https://cloud.google.com/public-datasets/. By default, GCP public // datasets are excluded. bool include_gcp_public_datasets = 7; } - // Required. The scope of this search request. - Scope scope = 6; + // Required. The scope of this search request. A `scope` that has empty + // `include_org_ids`, `include_project_ids` AND false + // `include_gcp_public_datasets` is considered invalid. Data Catalog will + // return an error in such a case. + Scope scope = 6 [(google.api.field_behavior) = REQUIRED]; - // Required. The query string in search query syntax. The query must be - // non-empty. + // Required. The query string in search query syntax. The query must be non-empty. // // Query strings can be simple as "x" or more qualified as: // @@ -277,37 +480,37 @@ message SearchCatalogRequest { // // Note: Query tokens need to have a minimum of 3 characters for substring // matching to work correctly. See [Data Catalog Search - // Syntax](/data-catalog/docs/how-to/search-reference) for more information. - string query = 1; + // Syntax](https://cloud.google.com/data-catalog/docs/how-to/search-reference) + // for more information. + string query = 1 [(google.api.field_behavior) = REQUIRED]; // Number of results in the search page. If <=0 then defaults to 10. Max limit // for page_size is 1000. Throws an invalid argument for page_size > 1000. int32 page_size = 2; - // Optional pagination token returned in an earlier - // [SearchCatalogResponse.next_page_token][google.cloud.datacatalog.v1beta1.DataCatalog.SearchCatalogResponse.next_page_token]; + // Optional. Pagination token returned in an earlier + // [SearchCatalogResponse.next_page_token][google.cloud.datacatalog.v1beta1.SearchCatalogResponse.next_page_token], which // indicates that this is a continuation of a prior - // [SearchCatalog][google.cloud.datacatalog.v1beta1.DataCatalog.SearchCatalog] - // call, and that the system should return the next page of data. If empty - // then the first page is returned. - string page_token = 3; + // [SearchCatalogRequest][google.cloud.datacatalog.v1beta1.DataCatalog.SearchCatalog] + // call, and that the system should return the next page of data. If empty, + // the first page is returned. + string page_token = 3 [(google.api.field_behavior) = OPTIONAL]; // Specifies the ordering of results, currently supported case-sensitive // choices are: - //
            - //
          • relevance
            • - //
          • last_access_timestamp [asc|desc], defaults to descending if not - // specified,
            • - //
          • last_modified_timestamp [asc|desc], defaults to descending if not - // specified.
            • - //
          + // + // * `relevance`, only supports descending + // * `last_modified_timestamp [asc|desc]`, defaults to descending if not + // specified + // + // If not specified, defaults to `relevance` descending. string order_by = 5; } // Response message for // [SearchCatalog][google.cloud.datacatalog.v1beta1.DataCatalog.SearchCatalog]. message SearchCatalogResponse { - // Search results in descending order of relevance. + // Search results. repeated SearchCatalogResult results = 1; // The token that can be used to retrieve the next page of results. @@ -315,32 +518,185 @@ message SearchCatalogResponse { } // Request message for -// [UpdateEntry][google.cloud.datacatalog.v1beta1.DataCatalog.UpdateEntry]. -message UpdateEntryRequest { - // Required. The updated Entry. - Entry entry = 1; +// [CreateEntryGroup][google.cloud.datacatalog.v1beta1.DataCatalog.CreateEntryGroup]. +message CreateEntryGroupRequest { + // Required. The name of the project this entry group is in. Example: + // + // * projects/{project_id}/locations/{location} + // + // Note that this EntryGroup and its child resources may not actually be + // stored in the location in this name. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "datacatalog.googleapis.com/EntryGroup" + } + ]; + + // Required. The id of the entry group to create. + // The id must begin with a letter or underscore, contain only English + // letters, numbers and underscores, and be at most 64 characters. + string entry_group_id = 3 [(google.api.field_behavior) = REQUIRED]; + + // The entry group to create. Defaults to an empty entry group. + EntryGroup entry_group = 2; +} - // Optional. The fields to update on the entry. If absent or empty, all - // modifiable fields are updated. +// Request message for +// [UpdateEntryGroup][google.cloud.datacatalog.v1beta1.DataCatalog.UpdateEntryGroup]. +message UpdateEntryGroupRequest { + // Required. The updated entry group. "name" field must be set. + EntryGroup entry_group = 1 [(google.api.field_behavior) = REQUIRED]; + + // The fields to update on the entry group. If absent or empty, all modifiable + // fields are updated. + google.protobuf.FieldMask update_mask = 2; +} + +// Request message for +// [GetEntryGroup][google.cloud.datacatalog.v1beta1.DataCatalog.GetEntryGroup]. +message GetEntryGroupRequest { + // Required. The name of the entry group. For example, + // `projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/EntryGroup" + } + ]; + + // The fields to return. If not set or empty, all fields are returned. + google.protobuf.FieldMask read_mask = 2; +} + +// Request message for +// [DeleteEntryGroup][google.cloud.datacatalog.v1beta1.DataCatalog.DeleteEntryGroup]. +message DeleteEntryGroupRequest { + // Required. The name of the entry group. For example, + // `projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}`. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/EntryGroup" + } + ]; + + // Optional. If true, deletes all entries in the entry group. + bool force = 2 [(google.api.field_behavior) = OPTIONAL]; +} + +// Request message for +// [ListEntryGroups][google.cloud.datacatalog.v1beta1.DataCatalog.ListEntryGroups]. +message ListEntryGroupsRequest { + // Required. The name of the location that contains the entry groups, which can be + // provided in URL format. Example: // - // Modifiable fields in synced entries: + // * projects/{project_id}/locations/{location} + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/EntryGroup" + } + ]; + + // Optional. The maximum number of items to return. Default is 10. Max limit is 1000. + // Throws an invalid argument for `page_size > 1000`. + int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Token that specifies which page is requested. If empty, the first page is + // returned. + string page_token = 3 [(google.api.field_behavior) = OPTIONAL]; +} + +// Response message for +// [ListEntryGroups][google.cloud.datacatalog.v1beta1.DataCatalog.ListEntryGroups]. +message ListEntryGroupsResponse { + // EntryGroup details. + repeated EntryGroup entry_groups = 1; + + // Token to retrieve the next page of results. It is set to empty if no items + // remain in results. + string next_page_token = 2; +} + +// Request message for +// [CreateEntry][google.cloud.datacatalog.v1beta1.DataCatalog.CreateEntry]. +message CreateEntryRequest { + // Required. The name of the entry group this entry is in. Example: // - // 1. schema (Pub/Sub topics only) + // * projects/{project_id}/locations/{location}/entryGroups/{entry_group_id} // - // Modifiable fields in native entries: + // Note that this Entry and its child resources may not actually be stored in + // the location in this name. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/EntryGroup" + } + ]; + + // Required. The id of the entry to create. + string entry_id = 3 [(google.api.field_behavior) = REQUIRED]; + + // Required. The entry to create. + Entry entry = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// Request message for +// [UpdateEntry][google.cloud.datacatalog.v1beta1.DataCatalog.UpdateEntry]. +message UpdateEntryRequest { + // Required. The updated entry. The "name" field must be set. + Entry entry = 1 [(google.api.field_behavior) = REQUIRED]; + + // The fields to update on the entry. If absent or empty, all modifiable + // fields are updated. // - // 1. display_name - // 2. description - // 3. schema + // The following fields are modifiable: + // * For entries with type `DATA_STREAM`: + // * `schema` + // * For entries with type `FILESET` + // * `schema` + // * `display_name` + // * `description` + // * `gcs_fileset_spec` + // * `gcs_fileset_spec.file_patterns` + // * For entries with `user_specified_type` + // * `schema` + // * `display_name` + // * `description` + // * user_specified_type + // * user_specified_system + // * linked_resource + // * source_system_timestamps google.protobuf.FieldMask update_mask = 2; } +// Request message for +// [DeleteEntry][google.cloud.datacatalog.v1beta1.DataCatalog.DeleteEntry]. +message DeleteEntryRequest { + // Required. The name of the entry. Example: + // + // * projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/Entry" + } + ]; +} + // Request message for // [GetEntry][google.cloud.datacatalog.v1beta1.DataCatalog.GetEntry]. message GetEntryRequest { - // Required. The name of the entry. For example, - // "projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id}". - string name = 1; + // Required. The name of the entry. Example: + // + // * projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/Entry" + } + ]; } // Request message for @@ -351,274 +707,406 @@ message LookupEntryRequest { oneof target_name { // The full name of the Google Cloud Platform resource the Data Catalog // entry represents. See: - // https://cloud.google.com/apis/design/resource_names#full_resource_name + // https://cloud.google.com/apis/design/resource_names#full_resource_name. // Full names are case-sensitive. // // Examples: - // "//bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/tableId". - // "//pubsub.googleapis.com/projects/projectId/topics/topicId" + // + // * //bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/tableId + // * //pubsub.googleapis.com/projects/projectId/topics/topicId string linked_resource = 1; // The SQL name of the entry. SQL names are case-sensitive. // // Examples: - //
            - //
          • cloud_pubsub.project_id.topic_id
            • - //
          • pubsub.project_id.`topic.id.with.dots`
            • - //
          • bigquery.project_id.dataset_id.table_id
            • - //
          • datacatalog.project_id.location_id.entry_group_id.entry_id
            • - //
          - // *_ids shoud satisfy the standard SQL rules for identifiers. - // https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical + // + // * `pubsub.project_id.topic_id` + // * ``pubsub.project_id.`topic.id.with.dots` `` + // * `bigquery.table.project_id.dataset_id.table_id` + // * `bigquery.dataset.project_id.dataset_id` + // * `datacatalog.entry.project_id.location_id.entry_group_id.entry_id` + // + // `*_id`s shoud satisfy the standard SQL rules for identifiers. + // https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical. string sql_resource = 3; } } // Entry Metadata. // A Data Catalog Entry resource represents another resource in Google -// Cloud Platform, such as a BigQuery Dataset or a Pub/Sub Topic. Clients can -// use the `linked_resource` field in the Entry resource to refer to the -// original resource id of the source system. +// Cloud Platform (such as a BigQuery dataset or a Pub/Sub topic), or +// outside of Google Cloud Platform. Clients can use the `linked_resource` field +// in the Entry resource to refer to the original resource ID of the source +// system. // // An Entry resource contains resource details, such as its schema. An Entry can // also be used to attach flexible metadata, such as a // [Tag][google.cloud.datacatalog.v1beta1.Tag]. message Entry { - // Required when used in - // [UpdateEntryRequest][google.cloud.datacatalog.v1beta1.UpdateEntryRequest]. - // The Data Catalog resource name of the entry in URL format. For example, - // "projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id}". + option (google.api.resource) = { + type: "datacatalog.googleapis.com/Entry" + pattern: "projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}" + }; + + // The Data Catalog resource name of the entry in URL format. Example: + // + // * projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} + // // Note that this Entry and its child resources may not actually be stored in // the location in this name. - string name = 1; + string name = 1 [(google.api.resource_reference) = { + type: "datacatalog.googleapis.com/EntryGroup" + }]; - // Output only. The full name of the cloud resource the entry belongs to. See: - // https://cloud.google.com/apis/design/resource_names#full_resource_name + // The resource this metadata entry refers to. // - // Data Catalog supports resources from select Google Cloud Platform systems. - // `linked_resource` is the full name of the Google Cloud Platform resource. + // For Google Cloud Platform resources, `linked_resource` is the [full name of + // the + // resource](https://cloud.google.com/apis/design/resource_names#full_resource_name). // For example, the `linked_resource` for a table resource from BigQuery is: // - // "//bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/tableId". + // * //bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/tableId + // + // Output only when Entry is of type in the EntryType enum. For entries with + // user_specified_type, this field is optional and defaults to an empty + // string. string linked_resource = 9; - // Required. Type of entry. - EntryType type = 2; + // Required. Entry type. + oneof entry_type { + // The type of the entry. + // Only used for Entries with types in the EntryType enum. + EntryType type = 2; + + // Entry type if it does not fit any of the input-allowed values listed in + // `EntryType` enum above. When creating an entry, users should check the + // enum values first, if nothing matches the entry to be created, then + // provide a custom value, for example "my_special_type". + // `user_specified_type` strings must begin with a letter or underscore and + // can only contain letters, numbers, and underscores; are case insensitive; + // must be at least 1 character and at most 64 characters long. + // + // Currently, only FILESET enum value is allowed. All other entries created + // through Data Catalog must use `user_specified_type`. + string user_specified_type = 16; + } + + // The source system of the entry. + oneof system { + // Output only. This field indicates the entry's source system that Data Catalog + // integrates with, such as BigQuery or Pub/Sub. + IntegratedSystem integrated_system = 17 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // This field indicates the entry's source system that Data Catalog does not + // integrate with. `user_specified_system` strings must begin with a letter + // or underscore and can only contain letters, numbers, and underscores; are + // case insensitive; must be at least 1 character and at most 64 characters + // long. + string user_specified_system = 18; + } - // Optional. Type specification information. + // Type specification information. oneof type_spec { + // Specification that applies to a Cloud Storage fileset. This is only valid + // on entries of type FILESET. + GcsFilesetSpec gcs_fileset_spec = 6; + // Specification that applies to a BigQuery table. This is only valid on - // entries of type TABLE. + // entries of type `TABLE`. BigQueryTableSpec bigquery_table_spec = 12; // Specification for a group of BigQuery tables with name pattern - // [prefix]YYYYMMDD. Context: - // https://cloud.google.com/bigquery/docs/partitioned-tables#partitioning_versus_sharding + // `[prefix]YYYYMMDD`. Context: + // https://cloud.google.com/bigquery/docs/partitioned-tables#partitioning_versus_sharding. BigQueryDateShardedSpec bigquery_date_sharded_spec = 15; } - // Optional. Display information such as title and description. A short name - // to identify the entry, for example, "Analytics Data - Jan 2011". Default - // value is an empty string. + // Display information such as title and description. A short name to identify + // the entry, for example, "Analytics Data - Jan 2011". Default value is an + // empty string. string display_name = 3; - // Optional. Entry description, which can consist of several sentences or - // paragraphs that describe entry contents. Default value is an empty string. + // Entry description, which can consist of several sentences or paragraphs + // that describe entry contents. Default value is an empty string. string description = 4; - // Optional. Schema of the entry. An entry might not have any schema attached - // to it. + // Schema of the entry. An entry might not have any schema attached to it. Schema schema = 5; - // Output only. Timestamps about the underlying Google Cloud Platform resource - // -- not about this Data Catalog Entry. - SystemTimestamps source_system_timestamps = 7; + // Output only. Timestamps about the underlying resource, not about this Data Catalog + // entry. Output only when Entry is of type in the EntryType enum. For entries + // with user_specified_type, this field is optional and defaults to an empty + // timestamp. + SystemTimestamps source_system_timestamps = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// EntryGroup Metadata. +// An EntryGroup resource represents a logical grouping of zero or more +// Data Catalog [Entry][google.cloud.datacatalog.v1beta1.Entry] resources. +message EntryGroup { + option (google.api.resource) = { + type: "datacatalog.googleapis.com/EntryGroup" + pattern: "projects/{project}/locations/{location}/entryGroups/{entry_group}" + }; + + // The resource name of the entry group in URL format. Example: + // + // * projects/{project_id}/locations/{location}/entryGroups/{entry_group_id} + // + // Note that this EntryGroup and its child resources may not actually be + // stored in the location in this name. + string name = 1; + + // A short name to identify the entry group, for example, + // "analytics data - jan 2011". Default value is an empty string. + string display_name = 2; + + // Entry group description, which can consist of several sentences or + // paragraphs that describe entry group contents. Default value is an empty + // string. + string description = 3; + + // Output only. Timestamps about this EntryGroup. Default value is empty timestamps. + SystemTimestamps data_catalog_timestamps = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Request message for // [CreateTagTemplate][google.cloud.datacatalog.v1beta1.DataCatalog.CreateTagTemplate]. message CreateTagTemplateRequest { - // Required. The name of the project and the location this template is in. - // Example: "projects/{project_id}/locations/{location}". Note that this - // TagTemplate and its child resources may not actually be stored in the - // location in this name. - string parent = 1; + // Required. The name of the project and the template location + // [region](https://cloud.google.com/data-catalog/docs/concepts/regions. + // + // Example: + // + // * projects/{project_id}/locations/us-central1 + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "datacatalog.googleapis.com/TagTemplate" + } + ]; // Required. The id of the tag template to create. - string tag_template_id = 3; + string tag_template_id = 3 [(google.api.field_behavior) = REQUIRED]; // Required. The tag template to create. - TagTemplate tag_template = 2; + TagTemplate tag_template = 2 [(google.api.field_behavior) = REQUIRED]; } // Request message for // [GetTagTemplate][google.cloud.datacatalog.v1beta1.DataCatalog.GetTagTemplate]. message GetTagTemplateRequest { - // Required. The name of the tag template. For example, - // "projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}". - string name = 1; + // Required. The name of the tag template. Example: + // + // * projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id} + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/TagTemplate" + } + ]; } // Request message for // [UpdateTagTemplate][google.cloud.datacatalog.v1beta1.DataCatalog.UpdateTagTemplate]. message UpdateTagTemplateRequest { - // Required. The template to update. - TagTemplate tag_template = 1; + // Required. The template to update. The "name" field must be set. + TagTemplate tag_template = 1 [(google.api.field_behavior) = REQUIRED]; - // Optional. The field mask specifies the parts of the template to overwrite. + // The field mask specifies the parts of the template to overwrite. // // Allowed fields: // - // * display_name + // * `display_name` // - // If update_mask is omitted, all of the allowed fields above will be updated. + // If absent or empty, all of the allowed fields above will be updated. google.protobuf.FieldMask update_mask = 2; } // Request message for // [DeleteTagTemplate][google.cloud.datacatalog.v1beta1.DataCatalog.DeleteTagTemplate]. message DeleteTagTemplateRequest { - // Required. The name of the tag template to delete. For example, - // "projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}". - string name = 1; - - // Required. Currently, this field must always be set to true. + // Required. The name of the tag template to delete. Example: + // + // * projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id} + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/TagTemplate" + } + ]; + + // Required. Currently, this field must always be set to `true`. // This confirms the deletion of any possible tags using this template. - // force = false will be supported in the future. - bool force = 2; + // `force = false` will be supported in the future. + bool force = 2 [(google.api.field_behavior) = REQUIRED]; } // Request message for // [CreateTag][google.cloud.datacatalog.v1beta1.DataCatalog.CreateTag]. message CreateTagRequest { - // Required. - // The name of the resource to attach this tag to. Tags can be attached to - // Entries. (example: - // "projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id}"). + // Required. The name of the resource to attach this tag to. Tags can be attached to + // Entries. Example: + // + // * projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} + // // Note that this Tag and its child resources may not actually be stored in // the location in this name. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/Tag" + } + ]; // Required. The tag to create. - Tag tag = 2; + Tag tag = 2 [(google.api.field_behavior) = REQUIRED]; } // Request message for // [UpdateTag][google.cloud.datacatalog.v1beta1.DataCatalog.UpdateTag]. message UpdateTagRequest { - // Required. The updated tag. - Tag tag = 1; + // Required. The updated tag. The "name" field must be set. + Tag tag = 1 [(google.api.field_behavior) = REQUIRED]; - // Optional. The fields to update on the Tag. If absent or empty, all - // modifiable fields are updated. Currently the only modifiable field is the - // field `fields`. + // The fields to update on the Tag. If absent or empty, all modifiable fields + // are updated. Currently the only modifiable field is the field `fields`. google.protobuf.FieldMask update_mask = 2; } // Request message for // [DeleteTag][google.cloud.datacatalog.v1beta1.DataCatalog.DeleteTag]. message DeleteTagRequest { - // Required. The name of the tag to delete. For example, - // "projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id}/tags/{tag_id}". - string name = 1; + // Required. The name of the tag to delete. Example: + // + // * projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id}/tags/{tag_id} + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "datacatalog.googleapis.com/Tag" + } + ]; } // Request message for // [CreateTagTemplateField][google.cloud.datacatalog.v1beta1.DataCatalog.CreateTagTemplateField]. message CreateTagTemplateFieldRequest { - // Required. The name of the project this template is in. Example: - // "projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}". - // Note that this TagTemplateField may not actually be stored in the location - // in this name. - string parent = 1; - - // Required. The id of the tag template field to create. + // Required. The name of the project and the template location + // [region](https://cloud.google.com/data-catalog/docs/concepts/regions). + // + // Example: + // + // * projects/{project_id}/locations/us-central1/tagTemplates/{tag_template_id} + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/TagTemplate" + } + ]; + + // Required. The ID of the tag template field to create. // Field ids can contain letters (both uppercase and lowercase), numbers - // (0-9), underscores (_) and dashes (-). Field ids must be at least 1 - // character long and at most 128 characters long. Field ids must also be - // unique to their template. - string tag_template_field_id = 2; + // (0-9), underscores (_) and dashes (-). Field IDs must be at least 1 + // character long and at most 128 characters long. Field IDs must also be + // unique within their template. + string tag_template_field_id = 2 [(google.api.field_behavior) = REQUIRED]; // Required. The tag template field to create. - TagTemplateField tag_template_field = 3; + TagTemplateField tag_template_field = 3 [(google.api.field_behavior) = REQUIRED]; } // Request message for // [UpdateTagTemplateField][google.cloud.datacatalog.v1beta1.DataCatalog.UpdateTagTemplateField]. message UpdateTagTemplateFieldRequest { - // Required. The name of the tag template field. For example, - // "projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}/fields/{tag_template_field_id}". - string name = 1; + // Required. The name of the tag template field. Example: + // + // * projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}/fields/{tag_template_field_id} + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/TagTemplateField" + } + ]; // Required. The template to update. - TagTemplateField tag_template_field = 2; + TagTemplateField tag_template_field = 2 [(google.api.field_behavior) = REQUIRED]; - // Optional. The field mask specifies the parts of the template to overwrite. + // Optional. The field mask specifies the parts of the template to be updated. // Allowed fields: // - // * display_name - // * type.enum_type + // * `display_name` + // * `type.enum_type` + // * `is_required` // - // If update_mask is omitted, all of the allowed fields above will be updated. + // If `update_mask` is not set or empty, all of the allowed fields above will + // be updated. // // When updating an enum type, the provided values will be merged with the // existing values. Therefore, enum values can only be added, existing enum - // values cannot be deleted nor renamed. - google.protobuf.FieldMask update_mask = 3; + // values cannot be deleted nor renamed. Updating a template field from + // optional to required is NOT allowed. + google.protobuf.FieldMask update_mask = 3 [(google.api.field_behavior) = OPTIONAL]; } // Request message for // [RenameTagTemplateField][google.cloud.datacatalog.v1beta1.DataCatalog.RenameTagTemplateField]. message RenameTagTemplateFieldRequest { - // Required. The name of the tag template. For example, - // "projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}/fields/{tag_template_field_id}". - string name = 1; - - // Required. The new ID of this tag template field. For example, - // "my_new_field". - string new_tag_template_field_id = 2; -} - -// Entry resources in Data Catalog can be of different types e.g. BigQuery -// Table entry is of type 'TABLE'. This enum describes all the possible types -// Data Catalog contains. -enum EntryType { - // Default unknown type - ENTRY_TYPE_UNSPECIFIED = 0; - - // The type of entry that has a GoogleSQL schema, including logical views. - TABLE = 2; - - // An entry type which is used for streaming entries. Example - Pub/Sub. - DATA_STREAM = 3; + // Required. The name of the tag template. Example: + // + // * projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}/fields/{tag_template_field_id} + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/TagTemplateField" + } + ]; + + // Required. The new ID of this tag template field. For example, `my_new_field`. + string new_tag_template_field_id = 2 [(google.api.field_behavior) = REQUIRED]; } // Request message for // [DeleteTagTemplateField][google.cloud.datacatalog.v1beta1.DataCatalog.DeleteTagTemplateField]. message DeleteTagTemplateFieldRequest { - // Required. The name of the tag template field to delete. For example, - // "projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}/fields/{tag_template_field_id}". - string name = 1; - - // Required. Currently, this field must always be set to true. + // Required. The name of the tag template field to delete. Example: + // + // * projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}/fields/{tag_template_field_id} + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/TagTemplateField" + } + ]; + + // Required. Currently, this field must always be set to `true`. // This confirms the deletion of this field from any tags using this field. - // force = false will be supported in the future. - bool force = 2; + // `force = false` will be supported in the future. + bool force = 2 [(google.api.field_behavior) = REQUIRED]; } // Request message for // [ListTags][google.cloud.datacatalog.v1beta1.DataCatalog.ListTags]. message ListTagsRequest { - // Required. The name of the Data Catalog resource to list the tags of. The - // resource could be an [Entry][google.cloud.datacatalog.v1beta1.Entry]. - string parent = 1; - - // Optional. The maximum number of tags to return. Default is 10. Max limit is - // 1000. + // Required. The name of the Data Catalog resource to list the tags of. The resource + // could be an [Entry][google.cloud.datacatalog.v1beta1.Entry] or an + // [EntryGroup][google.cloud.datacatalog.v1beta1.EntryGroup]. + // + // Examples: + // + // * projects/{project_id}/locations/{location}/entryGroups/{entry_group_id} + // * projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id} + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "datacatalog.googleapis.com/Tag" + } + ]; + + // The maximum number of tags to return. Default is 10. Max limit is 1000. int32 page_size = 2; - // Optional. Token that specifies which page is requested. If empty, the first - // page is returned. + // Token that specifies which page is requested. If empty, the first page is + // returned. string page_token = 3; } @@ -632,3 +1120,67 @@ message ListTagsResponse { // remain in results. string next_page_token = 2; } + +// Request message for +// [ListEntries][google.cloud.datacatalog.v1beta1.DataCatalog.ListEntries]. +message ListEntriesRequest { + // Required. The name of the entry group that contains the entries, which can + // be provided in URL format. Example: + // + // * projects/{project_id}/locations/{location}/entryGroups/{entry_group_id} + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/EntryGroup" + } + ]; + + // The maximum number of items to return. Default is 10. Max limit is 1000. + // Throws an invalid argument for `page_size > 1000`. + int32 page_size = 2; + + // Token that specifies which page is requested. If empty, the first page is + // returned. + string page_token = 3; + + // The fields to return for each Entry. If not set or empty, all + // fields are returned. + // For example, setting read_mask to contain only one path "name" will cause + // ListEntries to return a list of Entries with only "name" field. + google.protobuf.FieldMask read_mask = 4; +} + +// Response message for +// [ListEntries][google.cloud.datacatalog.v1beta1.DataCatalog.ListEntries]. +message ListEntriesResponse { + // Entry details. + repeated Entry entries = 1; + + // Token to retrieve the next page of results. It is set to empty if no items + // remain in results. + string next_page_token = 2; +} + +// Entry resources in Data Catalog can be of different types e.g. a BigQuery +// Table entry is of type `TABLE`. This enum describes all the possible types +// Data Catalog contains. +enum EntryType { + // Default unknown type. + ENTRY_TYPE_UNSPECIFIED = 0; + + // Output only. The type of entry that has a GoogleSQL schema, including + // logical views. + TABLE = 2; + + // Output only. The type of models. + // https://cloud.google.com/bigquery-ml/docs/bigqueryml-intro + MODEL = 5; + + // Output only. An entry type which is used for streaming entries. Example: + // Pub/Sub topic. + DATA_STREAM = 3; + + // An entry type which is a set of files or objects. Example: + // Cloud Storage fileset. + FILESET = 4; +} diff --git a/third_party/googleapis/google/cloud/datacatalog/v1beta1/datacatalog_gapic.legacy.yaml b/third_party/googleapis/google/cloud/datacatalog/v1beta1/datacatalog_gapic.legacy.yaml new file mode 100644 index 000000000..cbe34409a --- /dev/null +++ b/third_party/googleapis/google/cloud/datacatalog/v1beta1/datacatalog_gapic.legacy.yaml @@ -0,0 +1,586 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 1.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.datacatalog.v1beta1 + python: + package_name: google.cloud.datacatalog_v1beta1.gapic + go: + package_name: cloud.google.com/go/datacatalog/apiv1beta1 + csharp: + package_name: Google.Cloud.Datacatalog.V1beta1 + ruby: + package_name: Google::Cloud::Datacatalog::V1beta1 + php: + package_name: Google\Cloud\Datacatalog\V1beta1 + nodejs: + package_name: datacatalog.v1beta1 + domain_layer_location: google-cloud +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.cloud.datacatalog.v1beta1.DataCatalog + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: + - name_pattern: projects/{project}/locations/{location} + entity_name: location + - name_pattern: projects/{project}/locations/{location}/entryGroups/{entry_group} + entity_name: entry_group + - name_pattern: projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry} + entity_name: entry + - name_pattern: projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}/tags/{tag} + entity_name: tag + - name_pattern: projects/{project}/locations/{location}/tagTemplates/{tag_template} + entity_name: tag_template + - name_pattern: projects/{project}/locations/{location}/tagTemplates/{tag_template}/fields/{field} + entity_name: field + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - DEADLINE_EXCEEDED + - UNAVAILABLE + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # + # name - The simple name of the method. + # + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce method + # overloads which allow a client to directly pass request message fields as + # method parameters. This information may or may not be used, depending on + # the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request message. + # + # required_fields - Fields that are always required for a request to be + # valid. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a paging + # list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It defines + # which fields match the paging pattern in the request. The request consists + # of a page_size_field and a token_field. The page_size_field is the name of + # the optional field specifying the maximum number of elements to be + # returned in the response. The token_field is the name of the field in the + # request containing the page token. + # The response specifies response information of the list method. It defines + # which fields match the paging pattern in the response. The response + # consists of a token_field and a resources_field. The token_field is the + # name of the field in the response containing the next page token. The + # resources_field is the name of the field in the response containing the + # list of resources belonging to the page. + # + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: SearchCatalog + flattening: + groups: + - parameters: + - scope + - query + - order_by + required_fields: + - scope + - query + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: results + retry_codes_name: non_idempotent + retry_params_name: default + timeout_millis: 60000 + samples: + standalone: + - value_sets: [datacatalog_search] + region_tag: datacatalog_search + sample_value_sets: + - id: datacatalog_search + description: Search Catalog + parameters: + defaults: + - scope.include_project_ids[0] = "[Google Cloud Project ID]" + - scope.include_gcp_public_datasets = false + - query = "[String in search query syntax]" + attributes: + - parameter: scope.include_project_ids[0] + description: Your Google Cloud project ID. + sample_argument_name: include_project_id + - parameter: scope.include_gcp_public_datasets + description: If true, include Google Cloud Platform (GCP) public datasets in the search results. + sample_argument_name: include_gcp_public_datasets + - parameter: query + description: | + Your query string. + See: https://cloud.google.com/data-catalog/docs/how-to/search-reference + Example: system=bigquery type=dataset + sample_argument_name: query + on_success: + - print: ["Result type: %s", $resp.search_result_type] + - print: ["Result subtype: %s", $resp.search_result_subtype] + - print: ["Relative resource name: %s", $resp.relative_resource_name] + - print: ["Linked resource: %s\n", $resp.linked_resource] + - name: CreateEntryGroup + flattening: + groups: + - parameters: + - parent + - entry_group_id + - entry_group + required_fields: + - parent + - entry_group_id + - entry_group + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: location + timeout_millis: 60000 + - name: GetEntryGroup + flattening: + groups: + - parameters: + - name + - read_mask + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: entry_group + timeout_millis: 60000 + - name: DeleteEntryGroup + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: entry_group + timeout_millis: 60000 + - name: CreateEntry + flattening: + groups: + - parameters: + - parent + - entry_id + - entry + required_fields: + - parent + - entry_id + - entry + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: entry_group + timeout_millis: 60000 + - name: UpdateEntry + flattening: + groups: + - parameters: + - entry + - update_mask + required_fields: + - entry + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + entry.name: entry + timeout_millis: 60000 + - name: DeleteEntry + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: entry + timeout_millis: 60000 + - name: GetEntry + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: entry + timeout_millis: 60000 + samples: + standalone: + - region_tag: datacatalog_get_entry + value_sets: [datacatalog_get_entry] + sample_value_sets: + - id: datacatalog_get_entry + description: Get Entry + parameters: + defaults: + # The full "name" is of the format: "projects/{project_id}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}" + # Each part of the name can be separated out into its own parameter using `name%[part name]` + - name%project = "[Google Cloud Project ID]" + - name%location = "[Google Cloud Location ID]" + - name%entry_group = "[Entry Group ID]" + - name%entry = "[Entry ID]" + attributes: + - parameter: name%project + description: "Your Google Cloud project ID" + sample_argument_name: project_id + - parameter: name%location + description: "Google Cloud region, e.g. us-central1" + sample_argument_name: location_id + - parameter: name%entry_group + description: "ID of the Entry Group, e.g. @bigquery, @pubsub, my_entry_group" + sample_argument_name: entry_group_id + - parameter: name%entry + description: "ID of the Entry" + sample_argument_name: entry_id + on_success: + - define: entry = $resp + - print: ["Entry name: %s", entry.name] + - print: ["Entry type: %s", entry.type] + - print: ["Linked resource: %s", entry.linked_resource] + - name: LookupEntry + retry_codes_name: idempotent + retry_params_name: default + timeout_millis: 60000 + samples: + standalone: + - region_tag: datacatalog_lookup_entry + value_sets: [datacatalog_lookup_entry] + - region_tag: datacatalog_lookup_entry_sql_resource + value_sets: [datacatalog_lookup_entry_sql_resource] + sample_value_sets: + - id: datacatalog_lookup_entry + description: Lookup Entry + parameters: + defaults: + - linked_resource = "[Full Resource Name]" + attributes: + - parameter: linked_resource + sample_argument_name: resource_name + description: | + The full name of the Google Cloud Platform resource the Data Catalog entry represents. + See: https://cloud.google.com/apis/design/resource_names#full_resource_name + Examples: + //bigquery.googleapis.com/projects/bigquery-public-data/datasets/new_york_taxi_trips/tables/taxi_zone_geom + //pubsub.googleapis.com/projects/pubsub-public-data/topics/taxirides-realtime + on_success: + - define: entry = $resp + - print: ["Entry name: %s", entry.name] + - print: ["Entry type: %s", entry.type] + - print: ["Linked resource: %s", entry.linked_resource] + - id: datacatalog_lookup_entry_sql_resource + description: Lookup Entry using SQL resource + parameters: + defaults: + - sql_resource = "[SQL Resource Name]" + attributes: + - parameter: sql_resource + sample_argument_name: sql_name + description: | + The SQL name of the Google Cloud Platform resource the Data Catalog entry represents. + Examples: + bigquery.table.`bigquery-public-data`.new_york_taxi_trips.taxi_zone_geom + pubsub.topic.`pubsub-public-data`.`taxirides-realtime` + on_success: + - define: entry = $resp + - print: ["Entry name: %s", entry.name] + - print: ["Entry type: %s", entry.type] + - print: ["Linked resource: %s", entry.linked_resource] + - name: ListEntryGroups + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: location + timeout_millis: 60000 + - name: ListEntries + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: entry_group + timeout_millis: 60000 + - name: UpdateEntryGroup + flattening: + groups: + - parameters: + - entry_group + - parameters: + - entry_group + - update_mask + required_fields: + - entry_group + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + entry_group.name: entry_group + timeout_millis: 60000 + - name: CreateTagTemplate + flattening: + groups: + - parameters: + - parent + - tag_template_id + - tag_template + required_fields: + - parent + - tag_template_id + - tag_template + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: location + timeout_millis: 60000 + - name: GetTagTemplate + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: tag_template + timeout_millis: 60000 + - name: UpdateTagTemplate + flattening: + groups: + - parameters: + - tag_template + - update_mask + required_fields: + - tag_template + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + tag_template.name: tag_template + timeout_millis: 60000 + - name: DeleteTagTemplate + flattening: + groups: + - parameters: + - name + - force + required_fields: + - name + - force + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: tag_template + timeout_millis: 60000 + - name: CreateTagTemplateField + flattening: + groups: + - parameters: + - parent + - tag_template_field_id + - tag_template_field + required_fields: + - parent + - tag_template_field_id + - tag_template_field + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: tag_template + timeout_millis: 60000 + - name: UpdateTagTemplateField + flattening: + groups: + - parameters: + - name + - tag_template_field + - update_mask + required_fields: + - name + - tag_template_field + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: field + timeout_millis: 60000 + - name: RenameTagTemplateField + flattening: + groups: + - parameters: + - name + - new_tag_template_field_id + required_fields: + - name + - new_tag_template_field_id + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: field + timeout_millis: 60000 + - name: DeleteTagTemplateField + flattening: + groups: + - parameters: + - name + - force + required_fields: + - name + - force + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: field + timeout_millis: 60000 + - name: CreateTag + flattening: + groups: + - parameters: + - parent + - tag + required_fields: + - parent + - tag + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: entry + timeout_millis: 60000 + - name: UpdateTag + flattening: + groups: + - parameters: + - tag + - update_mask + required_fields: + - tag + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + tag.name: tag + timeout_millis: 60000 + - name: DeleteTag + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: tag + timeout_millis: 60000 + - name: ListTags + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: tags + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: entry + timeout_millis: 60000 + - name: SetIamPolicy + flattening: + groups: + - parameters: + - resource + - policy + required_fields: + - resource + - policy + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + resource: tag_template + timeout_millis: 60000 + - name: GetIamPolicy + flattening: + groups: + - parameters: + - resource + required_fields: + - resource + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + resource: tag_template + timeout_millis: 60000 + - name: TestIamPermissions + flattening: + groups: + - parameters: + - resource + - permissions + required_fields: + - resource + - permissions + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + resource: tag_template + timeout_millis: 60000 diff --git a/third_party/googleapis/google/cloud/datacatalog/v1beta1/datacatalog_gapic.yaml b/third_party/googleapis/google/cloud/datacatalog/v1beta1/datacatalog_gapic.yaml index 5ceffbaef..f45b39515 100644 --- a/third_party/googleapis/google/cloud/datacatalog/v1beta1/datacatalog_gapic.yaml +++ b/third_party/googleapis/google/cloud/datacatalog/v1beta1/datacatalog_gapic.yaml @@ -1,5 +1,5 @@ type: com.google.api.codegen.ConfigProto -config_schema_version: 1.0.0 +config_schema_version: 2.0.0 # The settings of generated code in a specific language. language_settings: java: @@ -17,354 +17,130 @@ language_settings: nodejs: package_name: datacatalog.v1beta1 domain_layer_location: google-cloud - # A list of API interface configurations. interfaces: # The fully qualified name of the API interface. - name: google.cloud.datacatalog.v1beta1.DataCatalog - # A list of resource collection configurations. - # Consists of a name_pattern and an entity_name. - # The name_pattern is a pattern to describe the names of the resources of this - # collection, using the platform's conventions for URI patterns. A generator - # may use this to generate methods to compose and decompose such names. The - # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; - # those will be taken as hints for the parameter names of the generated - # methods. If empty, no name methods are generated. - # The entity_name is the name to be used as a basis for generated methods and - # classes. - collections: - - name_pattern: projects/{project}/locations/{location} - entity_name: location - - name_pattern: projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry} - entity_name: entry - - name_pattern: projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}/tags/{tag} - entity_name: tag - - name_pattern: projects/{project}/locations/{location}/tagTemplates/{tag_template} - entity_name: tag_template - - name_pattern: projects/{project}/locations/{location}/tagTemplates/{tag_template}/fields/{field} - entity_name: field - # Definition for retryable codes. - retry_codes_def: - - name: idempotent - retry_codes: - - DEADLINE_EXCEEDED - - UNAVAILABLE - - name: non_idempotent - retry_codes: [] - # Definition for retry/backoff parameters. - retry_params_def: - - name: default - initial_retry_delay_millis: 100 - retry_delay_multiplier: 1.3 - max_retry_delay_millis: 60000 - initial_rpc_timeout_millis: 20000 - rpc_timeout_multiplier: 1 - max_rpc_timeout_millis: 20000 - total_timeout_millis: 600000 - # A list of method configurations. - # Common properties: - # - # name - The simple name of the method. - # - # flattening - Specifies the configuration for parameter flattening. - # Describes the parameter groups for which a generator should produce method - # overloads which allow a client to directly pass request message fields as - # method parameters. This information may or may not be used, depending on - # the target language. - # Consists of groups, which each represent a list of parameters to be - # flattened. Each parameter listed must be a field of the request message. - # - # required_fields - Fields that are always required for a request to be - # valid. - # - # page_streaming - Specifies the configuration for paging. - # Describes information for generating a method which transforms a paging - # list RPC into a stream of resources. - # Consists of a request and a response. - # The request specifies request information of the list method. It defines - # which fields match the paging pattern in the request. The request consists - # of a page_size_field and a token_field. The page_size_field is the name of - # the optional field specifying the maximum number of elements to be - # returned in the response. The token_field is the name of the field in the - # request containing the page token. - # The response specifies response information of the list method. It defines - # which fields match the paging pattern in the response. The response - # consists of a token_field and a resources_field. The token_field is the - # name of the field in the response containing the next page token. The - # resources_field is the name of the field in the response containing the - # list of resources belonging to the page. - # - # retry_codes_name - Specifies the configuration for retryable codes. The - # name must be defined in interfaces.retry_codes_def. - # - # retry_params_name - Specifies the configuration for retry/backoff - # parameters. The name must be defined in interfaces.retry_params_def. - # - # field_name_patterns - Maps the field name of the request type to - # entity_name of interfaces.collections. - # Specifies the string pattern that the field must follow. - # - # timeout_millis - Specifies the default timeout for a non-retrying call. If - # the call is retrying, refer to retry_params_name instead. methods: - name: SearchCatalog - flattening: - groups: - - parameters: - - scope - - query - - order_by - required_fields: - - scope - - query - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: results - retry_codes_name: non_idempotent - retry_params_name: default - timeout_millis: 60000 - - name: UpdateEntry - flattening: - groups: - - parameters: - - entry - - update_mask - required_fields: - - entry - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - entry.name: entry - timeout_millis: 60000 - - name: GetEntry - flattening: - groups: - - parameters: - - name - required_fields: - - name + samples: + standalone: + - value_sets: [datacatalog_search] + region_tag: datacatalog_search + sample_value_sets: + - id: datacatalog_search + description: Search Catalog + parameters: + defaults: + - scope.include_project_ids[0] = "[Google Cloud Project ID]" + - scope.include_gcp_public_datasets = false + - query = "[String in search query syntax]" + attributes: + - parameter: scope.include_project_ids[0] + description: Your Google Cloud project ID. + sample_argument_name: include_project_id + - parameter: scope.include_gcp_public_datasets + description: If true, include Google Cloud Platform (GCP) public datasets in the search results. + sample_argument_name: include_gcp_public_datasets + - parameter: query + description: | + Your query string. + See: https://cloud.google.com/data-catalog/docs/how-to/search-reference + Example: system=bigquery type=dataset + sample_argument_name: query + on_success: + - print: ["Result type: %s", $resp.search_result_type] + - print: ["Result subtype: %s", $resp.search_result_subtype] + - print: ["Relative resource name: %s", $resp.relative_resource_name] + - print: ["Linked resource: %s\n", $resp.linked_resource] + - name: DeleteEntryGroup retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: entry - timeout_millis: 60000 - - name: LookupEntry + - name: DeleteEntry retry_codes_name: idempotent - retry_params_name: default - timeout_millis: 60000 - - name: CreateTagTemplate - flattening: - groups: - - parameters: - - parent - - tag_template_id - - tag_template - required_fields: - - parent - - tag_template_id - - tag_template - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: location - timeout_millis: 60000 - - name: GetTagTemplate - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: tag_template - timeout_millis: 60000 - - name: UpdateTagTemplate - flattening: - groups: - - parameters: - - tag_template - - update_mask - required_fields: - - tag_template - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - tag_template.name: tag_template - timeout_millis: 60000 + - name: GetEntry + samples: + standalone: + - region_tag: datacatalog_get_entry + value_sets: [datacatalog_get_entry] + sample_value_sets: + - id: datacatalog_get_entry + description: Get Entry + parameters: + defaults: + # The full "name" is of the format: "projects/{project_id}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}" + # Each part of the name can be separated out into its own parameter using `name%[part name]` + - name%project = "[Google Cloud Project ID]" + - name%location = "[Google Cloud Location ID]" + - name%entry_group = "[Entry Group ID]" + - name%entry = "[Entry ID]" + attributes: + - parameter: name%project + description: "Your Google Cloud project ID" + sample_argument_name: project_id + - parameter: name%location + description: "Google Cloud region, e.g. us-central1" + sample_argument_name: location_id + - parameter: name%entry_group + description: "ID of the Entry Group, e.g. @bigquery, @pubsub, my_entry_group" + sample_argument_name: entry_group_id + - parameter: name%entry + description: "ID of the Entry" + sample_argument_name: entry_id + on_success: + - define: entry = $resp + - print: ["Entry name: %s", entry.name] + - print: ["Entry type: %s", entry.type] + - print: ["Linked resource: %s", entry.linked_resource] + - name: LookupEntry + samples: + standalone: + - region_tag: datacatalog_lookup_entry + value_sets: [datacatalog_lookup_entry] + - region_tag: datacatalog_lookup_entry_sql_resource + value_sets: [datacatalog_lookup_entry_sql_resource] + sample_value_sets: + - id: datacatalog_lookup_entry + description: Lookup Entry + parameters: + defaults: + - linked_resource = "[Full Resource Name]" + attributes: + - parameter: linked_resource + sample_argument_name: resource_name + description: | + The full name of the Google Cloud Platform resource the Data Catalog entry represents. + See: https://cloud.google.com/apis/design/resource_names#full_resource_name + Examples: + //bigquery.googleapis.com/projects/bigquery-public-data/datasets/new_york_taxi_trips/tables/taxi_zone_geom + //pubsub.googleapis.com/projects/pubsub-public-data/topics/taxirides-realtime + on_success: + - define: entry = $resp + - print: ["Entry name: %s", entry.name] + - print: ["Entry type: %s", entry.type] + - print: ["Linked resource: %s", entry.linked_resource] + - id: datacatalog_lookup_entry_sql_resource + description: Lookup Entry using SQL resource + parameters: + defaults: + - sql_resource = "[SQL Resource Name]" + attributes: + - parameter: sql_resource + sample_argument_name: sql_name + description: | + The SQL name of the Google Cloud Platform resource the Data Catalog entry represents. + Examples: + bigquery.table.`bigquery-public-data`.new_york_taxi_trips.taxi_zone_geom + pubsub.topic.`pubsub-public-data`.`taxirides-realtime` + on_success: + - define: entry = $resp + - print: ["Entry name: %s", entry.name] + - print: ["Entry type: %s", entry.type] + - print: ["Linked resource: %s", entry.linked_resource] - name: DeleteTagTemplate - flattening: - groups: - - parameters: - - name - - force - required_fields: - - name - - force retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: tag_template - timeout_millis: 60000 - - name: CreateTagTemplateField - flattening: - groups: - - parameters: - - parent - - tag_template_field_id - - tag_template_field - required_fields: - - parent - - tag_template_field_id - - tag_template_field - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: tag_template - timeout_millis: 60000 - - name: UpdateTagTemplateField - flattening: - groups: - - parameters: - - name - - tag_template_field - - update_mask - required_fields: - - name - - tag_template_field - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - name: field - timeout_millis: 60000 - - name: RenameTagTemplateField - flattening: - groups: - - parameters: - - name - - new_tag_template_field_id - required_fields: - - name - - new_tag_template_field_id - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - name: field - timeout_millis: 60000 - name: DeleteTagTemplateField - flattening: - groups: - - parameters: - - name - - force - required_fields: - - name - - force retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: field - timeout_millis: 60000 - - name: CreateTag - flattening: - groups: - - parameters: - - parent - - tag - required_fields: - - parent - - tag - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: entry - timeout_millis: 60000 - - name: UpdateTag - flattening: - groups: - - parameters: - - tag - - update_mask - required_fields: - - tag - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - tag.name: tag - timeout_millis: 60000 - name: DeleteTag - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: tag - timeout_millis: 60000 - - name: ListTags - flattening: - groups: - - parameters: - - parent - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: tags retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: entry - timeout_millis: 60000 - - name: SetIamPolicy - flattening: - groups: - - parameters: - - resource - - policy - required_fields: - - resource - - policy - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - resource: tag_template - timeout_millis: 60000 - name: GetIamPolicy - flattening: - groups: - - parameters: - - resource - required_fields: - - resource - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - resource: tag_template - timeout_millis: 60000 - - name: TestIamPermissions - flattening: - groups: - - parameters: - - resource - - permissions - required_fields: - - resource - - permissions retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - resource: tag_template - timeout_millis: 60000 diff --git a/third_party/googleapis/google/cloud/datacatalog/v1beta1/datacatalog_grpc_service_config.json b/third_party/googleapis/google/cloud/datacatalog/v1beta1/datacatalog_grpc_service_config.json new file mode 100755 index 000000000..3e39b464c --- /dev/null +++ b/third_party/googleapis/google/cloud/datacatalog/v1beta1/datacatalog_grpc_service_config.json @@ -0,0 +1,66 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.datacatalog.v1beta1.DataCatalog" + } + ], + "timeout": "60s" + }, + { + "name": [ + { + "service": "google.cloud.datacatalog.v1beta1.DataCatalog", + "method": "GetEntryGroup" + }, + { + "service": "google.cloud.datacatalog.v1beta1.DataCatalog", + "method": "DeleteEntryGroup" + }, + { + "service": "google.cloud.datacatalog.v1beta1.DataCatalog", + "method": "DeleteEntry" + }, + { + "service": "google.cloud.datacatalog.v1beta1.DataCatalog", + "method": "GetEntry" + }, + { + "service": "google.cloud.datacatalog.v1beta1.DataCatalog", + "method": "LookupEntry" + }, + { + "service": "google.cloud.datacatalog.v1beta1.DataCatalog", + "method": "GetTagTemplate" + }, + { + "service": "google.cloud.datacatalog.v1beta1.DataCatalog", + "method": "DeleteTagTemplate" + }, + { + "service": "google.cloud.datacatalog.v1beta1.DataCatalog", + "method": "DeleteTagTemplateField" + }, + { + "service": "google.cloud.datacatalog.v1beta1.DataCatalog", + "method": "DeleteTag" + }, + { + "service": "google.cloud.datacatalog.v1beta1.DataCatalog", + "method": "ListTags" + } + ], + "timeout": "60s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/cloud/datacatalog/v1beta1/datacatalog_v1beta1.yaml b/third_party/googleapis/google/cloud/datacatalog/v1beta1/datacatalog_v1beta1.yaml new file mode 100644 index 000000000..1a1d044bc --- /dev/null +++ b/third_party/googleapis/google/cloud/datacatalog/v1beta1/datacatalog_v1beta1.yaml @@ -0,0 +1,65 @@ +type: google.api.Service +config_version: 3 +name: datacatalog.googleapis.com +title: Google Cloud Data Catalog API + +apis: +- name: google.cloud.datacatalog.v1beta1.DataCatalog +- name: google.cloud.datacatalog.v1beta1.PolicyTagManager +- name: google.cloud.datacatalog.v1beta1.PolicyTagManagerSerialization + +documentation: + summary: |- + A fully managed and highly scalable data discovery and metadata management + service. + overview: |- + DataCatalog is a centralized and unified data catalog service for all your + Cloud resources, where users and systems can discover data, explore and + curate its semantics, understand how to act on it, and help govern its + usage. + rules: + - selector: google.iam.v1.IAMPolicy.GetIamPolicy + description: |- + Gets the access control policy for a resource. Returns an empty policy + if the resource exists and does not have a policy set. + + - selector: google.iam.v1.IAMPolicy.SetIamPolicy + description: |- + Sets the access control policy on the specified resource. Replaces + any existing policy. + + Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` + errors. + + - selector: google.iam.v1.IAMPolicy.TestIamPermissions + description: |- + Returns permissions that a caller has on the specified resource. If the + resource does not exist, this will return an empty set of + permissions, not a `NOT_FOUND` error. + + Note: This operation is designed to be used for building + permission-aware UIs and command-line tools, not for authorization + checking. This operation may "fail open" without warning. + +authentication: + rules: + - selector: 'google.cloud.datacatalog.v1beta1.DataCatalog.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: 'google.cloud.datacatalog.v1beta1.PolicyTagManager.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: google.cloud.datacatalog.v1beta1.PolicyTagManagerSerialization.ExportTaxonomies + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: google.cloud.datacatalog.v1beta1.PolicyTagManagerSerialization.ImportTaxonomies + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: 'google.iam.v1.IAMPolicy.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/datacatalog/v1beta1/gcs_fileset_spec.proto b/third_party/googleapis/google/cloud/datacatalog/v1beta1/gcs_fileset_spec.proto new file mode 100644 index 000000000..57cdcdfab --- /dev/null +++ b/third_party/googleapis/google/cloud/datacatalog/v1beta1/gcs_fileset_spec.proto @@ -0,0 +1,75 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.datacatalog.v1beta1; + +import "google/api/field_behavior.proto"; +import "google/cloud/datacatalog/v1beta1/timestamps.proto"; + +option cc_enable_arenas = true; +option csharp_namespace = "Google.Cloud.DataCatalog.V1Beta1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog"; +option java_multiple_files = true; +option java_package = "com.google.cloud.datacatalog.v1beta1"; +option php_namespace = "Google\\Cloud\\DataCatalog\\V1beta1"; +option ruby_package = "Google::Cloud::DataCatalog::V1beta1"; + +// Describes a Cloud Storage fileset entry. +message GcsFilesetSpec { + // Required. Patterns to identify a set of files in Google Cloud Storage. See [Cloud + // Storage documentation](/storage/docs/gsutil/addlhelp/WildcardNames) for + // more information. Note that bucket wildcards are currently not supported. + // + // Examples of valid file_patterns: + // + // * `gs://bucket_name/dir/*`: matches all files within `bucket_name/dir` + // directory. + // * `gs://bucket_name/dir/**`: matches all files in `bucket_name/dir` + // spanning all subdirectories. + // * `gs://bucket_name/file*`: matches files prefixed by `file` in + // `bucket_name` + // * `gs://bucket_name/??.txt`: matches files with two characters followed by + // `.txt` in `bucket_name` + // * `gs://bucket_name/[aeiou].txt`: matches files that contain a single + // vowel character followed by `.txt` in + // `bucket_name` + // * `gs://bucket_name/[a-m].txt`: matches files that contain `a`, `b`, ... + // or `m` followed by `.txt` in `bucket_name` + // * `gs://bucket_name/a/*/b`: matches all files in `bucket_name` that match + // `a/*/b` pattern, such as `a/c/b`, `a/d/b` + // * `gs://another_bucket/a.txt`: matches `gs://another_bucket/a.txt` + // + // You can combine wildcards to provide more powerful matches, for example: + // + // * `gs://bucket_name/[a-m]??.j*g` + repeated string file_patterns = 1 [(google.api.field_behavior) = REQUIRED]; + + // Output only. Sample files contained in this fileset, not all files contained in this + // fileset are represented here. + repeated GcsFileSpec sample_gcs_file_specs = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// Specifications of a single file in Cloud Storage. +message GcsFileSpec { + // Required. The full file path. Example: `gs://bucket_name/a/b.txt`. + string file_path = 1 [(google.api.field_behavior) = REQUIRED]; + + // Output only. Timestamps about the Cloud Storage file. + SystemTimestamps gcs_timestamps = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The size of the file, in bytes. + int64 size_bytes = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/cloud/datacatalog/v1beta1/policytagmanager.proto b/third_party/googleapis/google/cloud/datacatalog/v1beta1/policytagmanager.proto new file mode 100644 index 000000000..5602bcf16 --- /dev/null +++ b/third_party/googleapis/google/cloud/datacatalog/v1beta1/policytagmanager.proto @@ -0,0 +1,417 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.datacatalog.v1beta1; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/cloud/datacatalog/v1beta1/timestamps.proto"; +import "google/iam/v1/iam_policy.proto"; +import "google/iam/v1/policy.proto"; +import "google/protobuf/empty.proto"; +import "google/protobuf/field_mask.proto"; + +option cc_enable_arenas = true; +option csharp_namespace = "Google.Cloud.DataCatalog.V1Beta1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog"; +option java_multiple_files = true; +option java_outer_classname = "PolicyTagManagerProto"; +option java_package = "com.google.cloud.datacatalog.v1beta1"; +option php_namespace = "Google\\Cloud\\DataCatalog\\V1beta1"; +option ruby_package = "Google::Cloud::DataCatalog::V1beta1"; + +// The policy tag manager API service allows clients to manage their taxonomies +// and policy tags. +service PolicyTagManager { + option (google.api.default_host) = "datacatalog.googleapis.com"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; + + // Creates a taxonomy in the specified project. + rpc CreateTaxonomy(CreateTaxonomyRequest) returns (Taxonomy) { + option (google.api.http) = { + post: "/v1beta1/{parent=projects/*/locations/*}/taxonomies" + body: "taxonomy" + }; + option (google.api.method_signature) = "parent,taxonomy"; + } + + // Deletes a taxonomy. This operation will also delete all + // policy tags in this taxonomy along with their associated policies. + rpc DeleteTaxonomy(DeleteTaxonomyRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1beta1/{name=projects/*/locations/*/taxonomies/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Updates a taxonomy. + rpc UpdateTaxonomy(UpdateTaxonomyRequest) returns (Taxonomy) { + option (google.api.http) = { + patch: "/v1beta1/{taxonomy.name=projects/*/locations/*/taxonomies/*}" + body: "taxonomy" + }; + option (google.api.method_signature) = "taxonomy"; + } + + // Lists all taxonomies in a project in a particular location that the caller + // has permission to view. + rpc ListTaxonomies(ListTaxonomiesRequest) returns (ListTaxonomiesResponse) { + option (google.api.http) = { + get: "/v1beta1/{parent=projects/*/locations/*}/taxonomies" + }; + option (google.api.method_signature) = "parent"; + } + + // Gets a taxonomy. + rpc GetTaxonomy(GetTaxonomyRequest) returns (Taxonomy) { + option (google.api.http) = { + get: "/v1beta1/{name=projects/*/locations/*/taxonomies/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Creates a policy tag in the specified taxonomy. + rpc CreatePolicyTag(CreatePolicyTagRequest) returns (PolicyTag) { + option (google.api.http) = { + post: "/v1beta1/{parent=projects/*/locations/*/taxonomies/*}/policyTags" + body: "policy_tag" + }; + option (google.api.method_signature) = "parent,policy_tag"; + } + + // Deletes a policy tag. Also deletes all of its descendant policy tags. + rpc DeletePolicyTag(DeletePolicyTagRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1beta1/{name=projects/*/locations/*/taxonomies/*/policyTags/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Updates a policy tag. + rpc UpdatePolicyTag(UpdatePolicyTagRequest) returns (PolicyTag) { + option (google.api.http) = { + patch: "/v1beta1/{policy_tag.name=projects/*/locations/*/taxonomies/*/policyTags/*}" + body: "policy_tag" + }; + option (google.api.method_signature) = "policy_tag"; + } + + // Lists all policy tags in a taxonomy. + rpc ListPolicyTags(ListPolicyTagsRequest) returns (ListPolicyTagsResponse) { + option (google.api.http) = { + get: "/v1beta1/{parent=projects/*/locations/*/taxonomies/*}/policyTags" + }; + option (google.api.method_signature) = "parent"; + } + + // Gets a policy tag. + rpc GetPolicyTag(GetPolicyTagRequest) returns (PolicyTag) { + option (google.api.http) = { + get: "/v1beta1/{name=projects/*/locations/*/taxonomies/*/policyTags/*}" + }; + option (google.api.method_signature) = "name"; + } + + // Gets the IAM policy for a taxonomy or a policy tag. + rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) returns (google.iam.v1.Policy) { + option (google.api.http) = { + post: "/v1beta1/{resource=projects/*/locations/*/taxonomies/*}:getIamPolicy" + body: "*" + additional_bindings { + post: "/v1beta1/{resource=projects/*/locations/*/taxonomies/*/policyTags/*}:getIamPolicy" + body: "*" + } + }; + } + + // Sets the IAM policy for a taxonomy or a policy tag. + rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) returns (google.iam.v1.Policy) { + option (google.api.http) = { + post: "/v1beta1/{resource=projects/*/locations/*/taxonomies/*}:setIamPolicy" + body: "*" + additional_bindings { + post: "/v1beta1/{resource=projects/*/locations/*/taxonomies/*/policyTags/*}:setIamPolicy" + body: "*" + } + }; + } + + // Returns the permissions that a caller has on the specified taxonomy or + // policy tag. + rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest) returns (google.iam.v1.TestIamPermissionsResponse) { + option (google.api.http) = { + post: "/v1beta1/{resource=projects/*/locations/*/taxonomies/*}:testIamPermissions" + body: "*" + additional_bindings { + post: "/v1beta1/{resource=projects/*/locations/*/taxonomies/*/policyTags/*}:testIamPermissions" + body: "*" + } + }; + } +} + +// A taxonomy is a collection of policy tags that classify data along a common +// axis. For instance a data *sensitivity* taxonomy could contain policy tags +// denoting PII such as age, zipcode, and SSN. A data *origin* taxonomy could +// contain policy tags to distinguish user data, employee data, partner data, +// public data. +message Taxonomy { + option (google.api.resource) = { + type: "datacatalog.googleapis.com/Taxonomy" + pattern: "projects/{project}/locations/{location}/taxonomies/{taxonomy}" + }; + + // Defines policy types where policy tag can be used for. + enum PolicyType { + // Unspecified policy type. + POLICY_TYPE_UNSPECIFIED = 0; + + // Fine grained access control policy, which enables access control on + // tagged resources. + FINE_GRAINED_ACCESS_CONTROL = 1; + } + + // Output only. Resource name of this taxonomy, whose format is: + // "projects/{project_number}/locations/{location_id}/taxonomies/{id}". + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Required. User defined name of this taxonomy. It must: contain only unicode letters, + // numbers, underscores, dashes and spaces; not start or end with spaces; and + // be at most 200 bytes long when encoded in UTF-8. + string display_name = 2 [(google.api.field_behavior) = REQUIRED]; + + // Optional. Description of this taxonomy. It must: contain only unicode characters, + // tabs, newlines, carriage returns and page breaks; and be at most 2000 bytes + // long when encoded in UTF-8. If not set, defaults to an empty description. + string description = 3 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. A list of policy types that are activated for this taxonomy. If not set, + // defaults to an empty list. + repeated PolicyType activated_policy_types = 6 [(google.api.field_behavior) = OPTIONAL]; +} + +// Denotes one policy tag in a taxonomy (e.g. ssn). Policy Tags can be defined +// in a hierarchy. For example, consider the following hierarchy: +// Geolocation -> (LatLong, City, ZipCode). PolicyTag "Geolocation" +// contains three child policy tags: "LatLong", "City", and "ZipCode". +message PolicyTag { + option (google.api.resource) = { + type: "datacatalog.googleapis.com/PolicyTag" + pattern: "projects/{project}/locations/{location}/taxonomies/{taxonomy}/policyTags/{policy_tag}" + }; + + // Output only. Resource name of this policy tag, whose format is: + // "projects/{project_number}/locations/{location_id}/taxonomies/{taxonomy_id}/policyTags/{id}". + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Required. User defined name of this policy tag. It must: be unique within the parent + // taxonomy; contain only unicode letters, numbers, underscores, dashes and + // spaces; not start or end with spaces; and be at most 200 bytes long when + // encoded in UTF-8. + string display_name = 2 [(google.api.field_behavior) = REQUIRED]; + + // Description of this policy tag. It must: contain only unicode characters, + // tabs, newlines, carriage returns and page breaks; and be at most 2000 bytes + // long when encoded in UTF-8. If not set, defaults to an empty description. + // If not set, defaults to an empty description. + string description = 3; + + // Resource name of this policy tag's parent policy tag (e.g. for the + // "LatLong" policy tag in the example above, this field contains the + // resource name of the "Geolocation" policy tag). If empty, it means this + // policy tag is a top level policy tag (e.g. this field is empty for the + // "Geolocation" policy tag in the example above). If not set, defaults to an + // empty string. + string parent_policy_tag = 4; + + // Output only. Resource names of child policy tags of this policy tag. + repeated string child_policy_tags = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// Request message for +// [CreateTaxonomy][google.cloud.datacatalog.v1beta1.PolicyTagManager.CreateTaxonomy]. +message CreateTaxonomyRequest { + // Required. Resource name of the project that the taxonomy will belong to. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "datacatalog.googleapis.com/Taxonomy" + } + ]; + + // The taxonomy to be created. + Taxonomy taxonomy = 2; +} + +// Request message for +// [DeleteTaxonomy][google.cloud.datacatalog.v1beta1.PolicyTagManager.DeleteTaxonomy]. +message DeleteTaxonomyRequest { + // Required. Resource name of the taxonomy to be deleted. All policy tags in + // this taxonomy will also be deleted. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/Taxonomy" + } + ]; +} + +// Request message for +// [UpdateTaxonomy][google.cloud.datacatalog.v1beta1.PolicyTagManager.UpdateTaxonomy]. +message UpdateTaxonomyRequest { + // The taxonomy to update. Only description, display_name, and activated + // policy types can be updated. + Taxonomy taxonomy = 1; + + // The update mask applies to the resource. For the `FieldMask` definition, + // see + // https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask + // If not set, defaults to all of the fields that are allowed to update. + google.protobuf.FieldMask update_mask = 2; +} + +// Request message for +// [ListTaxonomies][google.cloud.datacatalog.v1beta1.PolicyTagManager.ListTaxonomies]. +message ListTaxonomiesRequest { + // Required. Resource name of the project to list the taxonomies of. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "datacatalog.googleapis.com/Taxonomy" + } + ]; + + // The maximum number of items to return. Must be a value between 1 and 1000. + // If not set, defaults to 50. + int32 page_size = 2; + + // The next_page_token value returned from a previous list request, if any. If + // not set, defaults to an empty string. + string page_token = 3; +} + +// Response message for +// [ListTaxonomies][google.cloud.datacatalog.v1beta1.PolicyTagManager.ListTaxonomies]. +message ListTaxonomiesResponse { + // Taxonomies that the project contains. + repeated Taxonomy taxonomies = 1; + + // Token used to retrieve the next page of results, or empty if there are no + // more results in the list. + string next_page_token = 2; +} + +// Request message for +// [GetTaxonomy][google.cloud.datacatalog.v1beta1.PolicyTagManager.GetTaxonomy]. +message GetTaxonomyRequest { + // Required. Resource name of the requested taxonomy. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/Taxonomy" + } + ]; +} + +// Request message for +// [CreatePolicyTag][google.cloud.datacatalog.v1beta1.PolicyTagManager.CreatePolicyTag]. +message CreatePolicyTagRequest { + // Required. Resource name of the taxonomy that the policy tag will belong to. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "datacatalog.googleapis.com/PolicyTag" + } + ]; + + // The policy tag to be created. + PolicyTag policy_tag = 2; +} + +// Request message for +// [DeletePolicyTag][google.cloud.datacatalog.v1beta1.PolicyTagManager.DeletePolicyTag]. +message DeletePolicyTagRequest { + // Required. Resource name of the policy tag to be deleted. All of its descendant + // policy tags will also be deleted. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/PolicyTag" + } + ]; +} + +// Request message for +// [UpdatePolicyTag][google.cloud.datacatalog.v1beta1.PolicyTagManager.UpdatePolicyTag]. +message UpdatePolicyTagRequest { + // The policy tag to update. Only the description, display_name, and + // parent_policy_tag fields can be updated. + PolicyTag policy_tag = 1; + + // The update mask applies to the resource. Only display_name, description and + // parent_policy_tag can be updated and thus can be listed in the mask. If + // update_mask is not provided, all allowed fields (i.e. display_name, + // description and parent) will be updated. For more information including the + // `FieldMask` definition, see + // https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask + // If not set, defaults to all of the fields that are allowed to update. + google.protobuf.FieldMask update_mask = 2; +} + +// Request message for +// [ListPolicyTags][google.cloud.datacatalog.v1beta1.PolicyTagManager.ListPolicyTags]. +message ListPolicyTagsRequest { + // Required. Resource name of the taxonomy to list the policy tags of. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "datacatalog.googleapis.com/PolicyTag" + } + ]; + + // The maximum number of items to return. Must be a value between 1 and 1000. + // If not set, defaults to 50. + int32 page_size = 2; + + // The next_page_token value returned from a previous List request, if any. If + // not set, defaults to an empty string. + string page_token = 3; +} + +// Response message for +// [ListPolicyTags][google.cloud.datacatalog.v1beta1.PolicyTagManager.ListPolicyTags]. +message ListPolicyTagsResponse { + // The policy tags that are in the requested taxonomy. + repeated PolicyTag policy_tags = 1; + + // Token used to retrieve the next page of results, or empty if there are no + // more results in the list. + string next_page_token = 2; +} + +// Request message for +// [GetPolicyTag][google.cloud.datacatalog.v1beta1.PolicyTagManager.GetPolicyTag]. +message GetPolicyTagRequest { + // Required. Resource name of the requested policy tag. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/PolicyTag" + } + ]; +} diff --git a/third_party/googleapis/google/cloud/datacatalog/v1beta1/policytagmanagerserialization.proto b/third_party/googleapis/google/cloud/datacatalog/v1beta1/policytagmanagerserialization.proto new file mode 100644 index 000000000..b6e4fb320 --- /dev/null +++ b/third_party/googleapis/google/cloud/datacatalog/v1beta1/policytagmanagerserialization.proto @@ -0,0 +1,157 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.datacatalog.v1beta1; + +import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/cloud/datacatalog/v1beta1/policytagmanager.proto"; +import "google/iam/v1/policy.proto"; +import "google/api/client.proto"; + +option cc_enable_arenas = true; +option csharp_namespace = "Google.Cloud.DataCatalog.V1Beta1"; +option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog"; +option java_multiple_files = true; +option java_outer_classname = "PolicyTagManagerSerializationProto"; +option java_package = "com.google.cloud.datacatalog.v1beta1"; +option php_namespace = "Google\\Cloud\\DataCatalog\\V1beta1"; +option ruby_package = "Google::Cloud::DataCatalog::V1beta1"; + +// Policy tag manager serialization API service allows clients to manipulate +// their taxonomies and policy tags data with serialized format. +service PolicyTagManagerSerialization { + option (google.api.default_host) = "datacatalog.googleapis.com"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; + + // Imports all taxonomies and their policy tags to a project as new + // taxonomies. + // + // This method provides a bulk taxonomy / policy tag creation using nested + // proto structure. + rpc ImportTaxonomies(ImportTaxonomiesRequest) returns (ImportTaxonomiesResponse) { + option (google.api.http) = { + post: "/v1beta1/{parent=projects/*/locations/*}/taxonomies:import" + body: "*" + }; + } + + // Exports all taxonomies and their policy tags in a project. + // + // This method generates SerializedTaxonomy protos with nested policy tags + // that can be used as an input for future ImportTaxonomies calls. + rpc ExportTaxonomies(ExportTaxonomiesRequest) returns (ExportTaxonomiesResponse) { + option (google.api.http) = { + get: "/v1beta1/{parent=projects/*/locations/*}/taxonomies:export" + }; + } +} + +// Message capturing a taxonomy and its policy tag hierarchy as a nested proto. +// Used for taxonomy import/export and mutation. +message SerializedTaxonomy { + // Required. Display name of the taxonomy. Max 200 bytes when encoded in UTF-8. + string display_name = 1 [(google.api.field_behavior) = REQUIRED]; + + // Description of the serialized taxonomy. The length of the + // description is limited to 2000 bytes when encoded in UTF-8. If not set, + // defaults to an empty description. + string description = 2; + + // Top level policy tags associated with the taxonomy if any. + repeated SerializedPolicyTag policy_tags = 3; +} + +// Message representing one policy tag when exported as a nested proto. +message SerializedPolicyTag { + // Required. Display name of the policy tag. Max 200 bytes when encoded in UTF-8. + string display_name = 2 [(google.api.field_behavior) = REQUIRED]; + + // Description of the serialized policy tag. The length of the + // description is limited to 2000 bytes when encoded in UTF-8. If not set, + // defaults to an empty description. + string description = 3; + + // Children of the policy tag if any. + repeated SerializedPolicyTag child_policy_tags = 4; +} + +// Request message for +// [ImportTaxonomies][google.cloud.datacatalog.v1beta1.PolicyTagManagerSerialization.ImportTaxonomies]. +message ImportTaxonomiesRequest { + // Required. Resource name of project that the newly created taxonomies will + // belong to. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "datacatalog.googleapis.com/Taxonomy" + } + ]; + + // Required. Source taxonomies to be imported in a tree structure. + oneof source { + // Inline source used for taxonomies import + InlineSource inline_source = 2; + } +} + +// Inline source used for taxonomies import. +message InlineSource { + // Required. Taxonomies to be imported. + repeated SerializedTaxonomy taxonomies = 1 [(google.api.field_behavior) = REQUIRED]; +} + +// Response message for +// [ImportTaxonomies][google.cloud.datacatalog.v1beta1.PolicyTagManagerSerialization.ImportTaxonomies]. +message ImportTaxonomiesResponse { + // Taxonomies that were imported. + repeated Taxonomy taxonomies = 1; +} + +// Request message for +// [ExportTaxonomies][google.cloud.datacatalog.v1beta1.PolicyTagManagerSerialization.ExportTaxonomies]. +message ExportTaxonomiesRequest { + // Required. Resource name of the project that taxonomies to be exported + // will share. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "datacatalog.googleapis.com/Taxonomy" + } + ]; + + // Required. Resource names of the taxonomies to be exported. + repeated string taxonomies = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/Taxonomy" + } + ]; + + // Required. Taxonomies export destination. + oneof destination { + // Export taxonomies as serialized taxonomies. + bool serialized_taxonomies = 3; + } +} + +// Response message for +// [ExportTaxonomies][google.cloud.datacatalog.v1beta1.PolicyTagManagerSerialization.ExportTaxonomies]. +message ExportTaxonomiesResponse { + // List of taxonomies and policy tags in a tree structure. + repeated SerializedTaxonomy taxonomies = 1; +} diff --git a/third_party/googleapis/google/cloud/datacatalog/v1beta1/samples/datacatalog_get_entry.test.yaml b/third_party/googleapis/google/cloud/datacatalog/v1beta1/samples/datacatalog_get_entry.test.yaml new file mode 100644 index 000000000..051b7f576 --- /dev/null +++ b/third_party/googleapis/google/cloud/datacatalog/v1beta1/samples/datacatalog_get_entry.test.yaml @@ -0,0 +1,39 @@ +test: + suites: + - name: Data Catalog v1beta1 Get Entry sample tests + setup: + - call: + sample: datacatalog_lookup_entry + params: + resource_name: + literal: //bigquery.googleapis.com/projects/bigquery-public-data/datasets/new_york_taxi_trips/tables/taxi_zone_geom + - extract_match: + pattern: projects/([\w-]+) + variable: project_id + - extract_match: + pattern: locations/([\w-]+) + variable: location_id + - extract_match: + pattern: entryGroups/(@[\w-]+|[\w-]+) + variable: entry_group_id + - extract_match: + pattern: entries/([\w-]+) + variable: entry_id + cases: + - name: Get Entry for a public BigQuery Table + spec: + - call: + sample: datacatalog_get_entry + params: + project_id: + variable: project_id + location_id: + variable: location_id + entry_group_id: + variable: entry_group_id + entry_id: + variable: entry_id + - assert_contains: + - literal: "Entry name: projects/bigquery-public-data" + - literal: "Entry type: TABLE" + - literal: "Linked resource: //bigquery.googleapis.com/projects/bigquery-public-data/datasets/new_york_taxi_trips/tables/taxi_zone_geom" diff --git a/third_party/googleapis/google/cloud/datacatalog/v1beta1/samples/datacatalog_lookup_entry.test.yaml b/third_party/googleapis/google/cloud/datacatalog/v1beta1/samples/datacatalog_lookup_entry.test.yaml new file mode 100644 index 000000000..e244cd70a --- /dev/null +++ b/third_party/googleapis/google/cloud/datacatalog/v1beta1/samples/datacatalog_lookup_entry.test.yaml @@ -0,0 +1,26 @@ +test: + suites: + - name: Data Catalog v1beta1 Lookup Entry sample tests + cases: + - name: Lookup Entry for a public BigQuery Table + spec: + - call: + sample: datacatalog_lookup_entry + params: + resource_name: + literal: //bigquery.googleapis.com/projects/bigquery-public-data/datasets/new_york_taxi_trips/tables/taxi_zone_geom + - assert_contains: + - literal: "Entry name: projects/bigquery-public-data" + - literal: "Entry type: TABLE" + - literal: "Linked resource: //bigquery.googleapis.com/projects/bigquery-public-data/datasets/new_york_taxi_trips/tables/taxi_zone_geom" + - name: Lookup Entry for a public PubSub Topic + spec: + - call: + sample: datacatalog_lookup_entry + params: + resource_name: + literal: //pubsub.googleapis.com/projects/pubsub-public-data/topics/taxirides-realtime + - assert_contains: + - literal: "Entry name: projects/pubsub-public-data" + - literal: "Entry type: DATA_STREAM" + - literal: "Linked resource: //pubsub.googleapis.com/projects/pubsub-public-data/topics/taxirides-realtime" diff --git a/third_party/googleapis/google/cloud/datacatalog/v1beta1/samples/datacatalog_lookup_entry_sql_resource.test.yaml b/third_party/googleapis/google/cloud/datacatalog/v1beta1/samples/datacatalog_lookup_entry_sql_resource.test.yaml new file mode 100644 index 000000000..36e50eead --- /dev/null +++ b/third_party/googleapis/google/cloud/datacatalog/v1beta1/samples/datacatalog_lookup_entry_sql_resource.test.yaml @@ -0,0 +1,26 @@ +test: + suites: + - name: Data Catalog v1beta1 Lookup Entry by SQL Resource sample tests + cases: + - name: Lookup Entry for a public BigQuery Table + spec: + - call: + sample: datacatalog_lookup_entry_sql_resource + params: + sql_name: + literal: bigquery.table.\`bigquery-public-data\`.new_york_taxi_trips.taxi_zone_geom + - assert_contains: + - literal: "Entry name: projects/bigquery-public-data" + - literal: "Entry type: TABLE" + - literal: "Linked resource: //bigquery.googleapis.com/projects/bigquery-public-data/datasets/new_york_taxi_trips/tables/taxi_zone_geom" + - name: Lookup Entry for a public PubSub Topic + spec: + - call: + sample: datacatalog_lookup_entry_sql_resource + params: + sql_name: + literal: pubsub.topic.\`pubsub-public-data\`.\`taxirides-realtime\` + - assert_contains: + - literal: "Entry name: projects/pubsub-public-data" + - literal: "Entry type: DATA_STREAM" + - literal: "Linked resource: //pubsub.googleapis.com/projects/pubsub-public-data/topics/taxirides-realtime" diff --git a/third_party/googleapis/google/cloud/datacatalog/v1beta1/samples/datacatalog_search.test.yaml b/third_party/googleapis/google/cloud/datacatalog/v1beta1/samples/datacatalog_search.test.yaml new file mode 100644 index 000000000..7877a0363 --- /dev/null +++ b/third_party/googleapis/google/cloud/datacatalog/v1beta1/samples/datacatalog_search.test.yaml @@ -0,0 +1,25 @@ +test: + suites: + - name: Data Catalog v1beta1 Search sample tests + setup: + # Get project ID from environment variable. + - env: + name: GOOGLE_PROJECT_ID + variable: project_id + cases: + - name: Search Catalog + spec: + - call: + sample: datacatalog_search + params: + include_project_id: + variable: project_id + include_gcp_public_datasets: + literal: "true" + query: + literal: "system=bigquery type=dataset name:trips" + - assert_contains: + - literal: "Result type: ENTRY" + - literal: "Result subtype: entry.dataset" + - literal: "Relative resource name: projects/bigquery-public-data" + - literal: "Linked resource: //bigquery.googleapis.com/projects/bigquery-public-data/datasets" diff --git a/third_party/googleapis/google/cloud/datacatalog/v1beta1/schema.proto b/third_party/googleapis/google/cloud/datacatalog/v1beta1/schema.proto index 839ef1d8c..d8e69fd46 100644 --- a/third_party/googleapis/google/cloud/datacatalog/v1beta1/schema.proto +++ b/third_party/googleapis/google/cloud/datacatalog/v1beta1/schema.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,42 +11,45 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.datacatalog.v1beta1; +import "google/api/field_behavior.proto"; + option cc_enable_arenas = true; +option csharp_namespace = "Google.Cloud.DataCatalog.V1Beta1"; option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog"; option java_multiple_files = true; -option java_package = "com.google.cloud.datacatalog"; +option java_package = "com.google.cloud.datacatalog.v1beta1"; +option php_namespace = "Google\\Cloud\\DataCatalog\\V1beta1"; +option ruby_package = "Google::Cloud::DataCatalog::V1beta1"; // Represents a schema (e.g. BigQuery, GoogleSQL, Avro schema). message Schema { - // Required. Schema of columns. A maximum of 10,000 columns and sub-columns - // can be specified. - repeated ColumnSchema columns = 2; + // Required. Schema of columns. A maximum of 10,000 columns and sub-columns can be + // specified. + repeated ColumnSchema columns = 2 [(google.api.field_behavior) = REQUIRED]; } // Representation of a column within a schema. Columns could be nested inside // other columns. message ColumnSchema { // Required. Name of the column. - string column = 6; + string column = 6 [(google.api.field_behavior) = REQUIRED]; // Required. Type of the column. - string type = 1; + string type = 1 [(google.api.field_behavior) = REQUIRED]; // Optional. Description of the column. Default value is an empty string. - string description = 2; + string description = 2 [(google.api.field_behavior) = OPTIONAL]; - // Optional. A column's mode indicates whether the values in this column are - // required, nullable, etc. Only 'NULLABLE', 'REQUIRED' and 'REPEATED' are - // supported. Default mode is 'NULLABLE'. - string mode = 3; + // Optional. A column's mode indicates whether the values in this column are required, + // nullable, etc. Only `NULLABLE`, `REQUIRED` and `REPEATED` are supported. + // Default mode is `NULLABLE`. + string mode = 3 [(google.api.field_behavior) = OPTIONAL]; - // Optional. Schema of sub-columns. A column can have zero or more - // sub-columns. - repeated ColumnSchema subcolumns = 7; + // Optional. Schema of sub-columns. A column can have zero or more sub-columns. + repeated ColumnSchema subcolumns = 7 [(google.api.field_behavior) = OPTIONAL]; } diff --git a/third_party/googleapis/google/cloud/datacatalog/v1beta1/search.proto b/third_party/googleapis/google/cloud/datacatalog/v1beta1/search.proto index 2a31dd945..c1f41412d 100644 --- a/third_party/googleapis/google/cloud/datacatalog/v1beta1/search.proto +++ b/third_party/googleapis/google/cloud/datacatalog/v1beta1/search.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,19 +11,22 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.datacatalog.v1beta1; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/cloud/datacatalog/v1beta1/common.proto"; import "google/protobuf/timestamp.proto"; option cc_enable_arenas = true; +option csharp_namespace = "Google.Cloud.DataCatalog.V1Beta1"; option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog"; option java_multiple_files = true; -option java_package = "com.google.cloud.datacatalog"; +option java_package = "com.google.cloud.datacatalog.v1beta1"; +option php_namespace = "Google\\Cloud\\DataCatalog\\V1beta1"; +option ruby_package = "Google::Cloud::DataCatalog::V1beta1"; // A result that appears in the response of a search request. Each result // captures details of one entry that matches the search. @@ -34,20 +37,22 @@ message SearchCatalogResult { // Sub-type of the search result. This is a dot-delimited description of the // resource's full type, and is the same as the value callers would provide in - // the "type" search facet. Examples: "entry.table", "entry.dataStream", - // "tagTemplate" + // the "type" search facet. Examples: `entry.table`, `entry.dataStream`, + // `tagTemplate`. string search_result_subtype = 2; // The relative resource name of the resource in URL format. // Examples: - // "projects/{project_id}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}". - // "projects/{project_id}/tagTemplates/{tag_template_id}". + // + // * `projects/{project_id}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}` + // * `projects/{project_id}/tagTemplates/{tag_template_id}` string relative_resource_name = 3; // The full name of the cloud resource the entry belongs to. See: - // https://cloud.google.com/apis/design/resource_names#full_resource_name + // https://cloud.google.com/apis/design/resource_names#full_resource_name. // Example: - // "//bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/tableId". + // + // * `//bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/tableId` string linked_resource = 4; } diff --git a/third_party/googleapis/google/cloud/datacatalog/v1beta1/table_spec.proto b/third_party/googleapis/google/cloud/datacatalog/v1beta1/table_spec.proto index 8e9547fea..c08f43efd 100644 --- a/third_party/googleapis/google/cloud/datacatalog/v1beta1/table_spec.proto +++ b/third_party/googleapis/google/cloud/datacatalog/v1beta1/table_spec.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,30 +11,35 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.datacatalog.v1beta1; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; + option cc_enable_arenas = true; +option csharp_namespace = "Google.Cloud.DataCatalog.V1Beta1"; option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog"; option java_multiple_files = true; -option java_package = "com.google.cloud.datacatalog"; +option java_package = "com.google.cloud.datacatalog.v1beta1"; +option php_namespace = "Google\\Cloud\\DataCatalog\\V1beta1"; +option ruby_package = "Google::Cloud::DataCatalog::V1beta1"; // Describes a BigQuery table. message BigQueryTableSpec { // Output only. The table source type. - TableSourceType table_source_type = 1; + TableSourceType table_source_type = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. oneof type_spec { // Table view specification. This field should only be populated if - // table_source_type is BIGQUERY_VIEW. + // `table_source_type` is `BIGQUERY_VIEW`. ViewSpec view_spec = 2; // Spec of a BigQuery table. This field should only be populated if - // table_source_type is BIGQUERY_TABLE. + // `table_source_type` is `BIGQUERY_TABLE`. TableSpec table_spec = 3; } } @@ -54,35 +59,43 @@ enum TableSourceType { // Table view specification. message ViewSpec { // Output only. The query that defines the table view. - string view_query = 1; + string view_query = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Normal BigQuery table spec. message TableSpec { - // Output only. If the table is a dated shard, i.e. with name pattern - // [prefix]YYYYMMDD, grouped_entry is the Data Catalog resource name of the - // date sharded grouped entry, e.g. - // projects/{project_id}/locations/{location}/entrygroups/{entry_group_id} - // /entries/{entry_id}. - // Otherwise, grouped_entry will be empty. - string grouped_entry = 1; + // Output only. If the table is a dated shard, i.e., with name pattern `[prefix]YYYYMMDD`, + // `grouped_entry` is the Data Catalog resource name of the date sharded + // grouped entry, for example, + // `projects/{project_id}/locations/{location}/entrygroups/{entry_group_id}/entries/{entry_id}`. + // Otherwise, `grouped_entry` is empty. + string grouped_entry = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/Entry" + } + ]; } -// Spec for a group of BigQuery tables with name pattern [prefix]YYYYMMDD. +// Spec for a group of BigQuery tables with name pattern `[prefix]YYYYMMDD`. // Context: // https://cloud.google.com/bigquery/docs/partitioned-tables#partitioning_versus_sharding message BigQueryDateShardedSpec { - // Output only. The Data Catalog resource name of the dataset entry the - // current table belongs to, e.g. - // projects/{project_id}/locations/{location}/entrygroups/{entry_group_id} - // /entries/{entry_id} - string dataset = 1; + // Output only. The Data Catalog resource name of the dataset entry the current table + // belongs to, for example, + // `projects/{project_id}/locations/{location}/entrygroups/{entry_group_id}/entries/{entry_id}`. + string dataset = 1 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.resource_reference) = { + type: "datacatalog.googleapis.com/Entry" + } + ]; - // Output only. The table name prefix of the shards. The name of any given - // shard is [table_prefix]YYYYMMDD, e.g. for shard MyTable20180101, the - // table_prefix is "MyTable" - string table_prefix = 2; + // Output only. The table name prefix of the shards. The name of any given shard is + // `[table_prefix]YYYYMMDD`, for example, for shard `MyTable20180101`, the + // `table_prefix` is `MyTable`. + string table_prefix = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Total number of shards. - int64 shard_count = 3; + int64 shard_count = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/cloud/datacatalog/v1beta1/tags.proto b/third_party/googleapis/google/cloud/datacatalog/v1beta1/tags.proto index f01843c20..c15fb218a 100644 --- a/third_party/googleapis/google/cloud/datacatalog/v1beta1/tags.proto +++ b/third_party/googleapis/google/cloud/datacatalog/v1beta1/tags.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,56 +11,72 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.datacatalog.v1beta1; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/timestamp.proto"; option cc_enable_arenas = true; +option csharp_namespace = "Google.Cloud.DataCatalog.V1Beta1"; option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog"; option java_multiple_files = true; -option java_package = "com.google.cloud.datacatalog"; +option java_package = "com.google.cloud.datacatalog.v1beta1"; +option php_namespace = "Google\\Cloud\\DataCatalog\\V1beta1"; +option ruby_package = "Google::Cloud::DataCatalog::V1beta1"; // Tags are used to attach custom metadata to Data Catalog resources. Tags // conform to the specifications within their tag template. +// +// See [Data Catalog +// IAM](https://cloud.google.com/data-catalog/docs/concepts/iam) for information +// on the permissions needed to create or view tags. message Tag { - // Required when used in - // [UpdateTagRequest][google.cloud.datacatalog.v1beta1.UpdateTagRequest]. The - // resource name of the tag in URL format. For example, - // projects/{project_id}/locations/{location}/entrygroups/{entry_group_id}/entries/{entry_id}/tags/{tag_id}", - // where tag_id is a system-generated identifier. Note that this Tag may not - // actually be stored in the location in this name. + option (google.api.resource) = { + type: "datacatalog.googleapis.com/Tag" + pattern: "projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}/tags/{tag}" + }; + + // The resource name of the tag in URL format. Example: + // + // * projects/{project_id}/locations/{location}/entrygroups/{entry_group_id}/entries/{entry_id}/tags/{tag_id} + // + // where `tag_id` is a system-generated identifier. + // Note that this Tag may not actually be stored in the location in this name. string name = 1; - // Required. The resource name of the tag template that this tag uses. For - // example, - // projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}. + // Required. The resource name of the tag template that this tag uses. Example: + // + // * projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id} + // // This field cannot be modified after creation. - string template = 2; + string template = 2 [(google.api.field_behavior) = REQUIRED]; // Output only. The display name of the tag template. - string template_display_name = 5; + string template_display_name = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Optional. The scope within the parent resource that this tag is attached - // to. If not provided, the tag is attached to the parent resource itself. + // The scope within the parent resource that this tag is attached to. If not + // provided, the tag is attached to the parent resource itself. // Deleting the scope from the parent resource will delete all tags attached // to that scope. These fields cannot be updated after creation. oneof scope { // Resources like Entry can have schemas associated with them. This scope // allows users to attach tags to an individual column based on that schema. // - // For attaching a tag to a nested column, use '.' to separate the column - // names: "outer_column.inner_column". + // For attaching a tag to a nested column, use `.` to separate the column + // names. Example: + // + // * `outer_column.inner_column` string column = 4; } - // Required. This maps the id of a tag field to the value of & additional - // information about that field. Valid field IDs are defined by the tag's - // template. A tag must have at least 1 field and at most 500 fields. - map fields = 3; + // Required. This maps the ID of a tag field to the value of and additional information + // about that field. Valid field IDs are defined by the tag's template. A tag + // must have at least 1 field and at most 500 fields. + map fields = 3 [(google.api.field_behavior) = REQUIRED]; } // Contains the value and supporting information for a field within @@ -73,7 +89,7 @@ message TagField { } // Output only. The display name of this field. - string display_name = 1; + string display_name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Required. The value of this field. oneof kind { @@ -93,59 +109,95 @@ message TagField { // one of the allowed values in the definition of this enum. EnumValue enum_value = 6; } + + // Output only. The order of this field with respect to other fields in this tag. It can be + // set in [Tag][google.cloud.datacatalog.v1beta1.TagTemplateField.order]. For + // example, a higher value can indicate a more important field. The value can + // be negative. Multiple fields can have the same order, and field orders + // within a tag do not have to be sequential. + int32 order = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; } -// Tag templates defines the schema of the tags used to attach to Data Catalog -// resources. It defines the mapping of accepted field names and types that can -// be used within the tag. The tag template also controls the access to the tag. +// A tag template defines a tag, which can have one or more typed fields. +// The template is used to create and attach the tag to GCP resources. +// [Tag template +// roles](https://cloud.google.com/iam/docs/understanding-roles#data-catalog-roles) +// provide permissions to create, edit, and use the template. See, for example, +// the [TagTemplate +// User](https://cloud.google.com/data-catalog/docs/how-to/template-user) role, +// which includes permission to use the tag template to tag resources. message TagTemplate { - // Required when used in - // [UpdateTagTemplateRequest][google.cloud.datacatalog.v1beta1.UpdateTagTemplateRequest]. - // The resource name of the tag template in URL format. For example, - // projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}. + option (google.api.resource) = { + type: "datacatalog.googleapis.com/TagTemplate" + pattern: "projects/{project}/locations/{location}/tagTemplates/{tag_template}" + }; + + // The resource name of the tag template in URL format. Example: + // + // * projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id} + // // Note that this TagTemplate and its child resources may not actually be // stored in the location in this name. string name = 1; - // Optional. The display name for this template. Default value is an empty - // string. + // The display name for this template. Defaults to an empty string. string display_name = 2; - // Required. Map of tag template field ids to the settings for the field. + // Required. Map of tag template field IDs to the settings for the field. // This map is an exhaustive list of the allowed fields. This map must contain // at least one field and at most 500 fields. // // The keys to this map are tag template field IDs. Field IDs can contain // letters (both uppercase and lowercase), numbers (0-9) and underscores (_). - // Field IDs must be at least 1 character long and at most 64 characters long. - // Field IDs must start with a letter or underscore. - map fields = 3; + // Field IDs must be at least 1 character long and at most + // 64 characters long. Field IDs must start with a letter or underscore. + map fields = 3 [(google.api.field_behavior) = REQUIRED]; } // The template for an individual field within a tag template. message TagTemplateField { - // Optional. The display name for this field. Default value is an empty - // string. + option (google.api.resource) = { + type: "datacatalog.googleapis.com/TagTemplateField" + pattern: "projects/{project}/locations/{location}/tagTemplates/{tag_template}/fields/{field}" + }; + + // Output only. The resource name of the tag template field in URL format. Example: + // + // * projects/{project_id}/locations/{location}/tagTemplates/{tag_template}/fields/{field} + // + // Note that this TagTemplateField may not actually be stored in the location + // in this name. + string name = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // The display name for this field. Defaults to an empty string. string display_name = 1; // Required. The type of value this tag field can contain. - FieldType type = 2; + FieldType type = 2 [(google.api.field_behavior) = REQUIRED]; + + // Whether this is a required field. Defaults to false. + bool is_required = 3; + + // The order of this field with respect to other fields in this tag + // template. A higher value indicates a more important field. The value can + // be negative. Multiple fields can have the same order, and field orders + // within a tag do not have to be sequential. + int32 order = 5; } message FieldType { message EnumType { message EnumValue { - // Required. The display name of the enum value. Must not be an empty - // string. - string display_name = 1; + // Required. The display name of the enum value. Must not be an empty string. + string display_name = 1 [(google.api.field_behavior) = REQUIRED]; } - // Required. The set of allowed values for this enum. This set must not be - // empty, the display names of the values in this set must not be empty and - // the display names of the values must be case-insensitively unique within - // this set. Currently, enum values can only be added to the list of allowed - // values. Deletion and renaming of enum values are not supported. Can have - // up to 500 allowed values. + // Required on create; optional on update. The set of allowed values for + // this enum. This set must not be empty, the display names of the values in + // this set must not be empty and the display names of the values must be + // case-insensitively unique within this set. Currently, enum values can + // only be added to the list of allowed values. Deletion and renaming of + // enum values are not supported. Can have up to 500 allowed values. repeated EnumValue allowed_values = 1; } diff --git a/third_party/googleapis/google/cloud/datacatalog/v1beta1/timestamps.proto b/third_party/googleapis/google/cloud/datacatalog/v1beta1/timestamps.proto index bb048b915..dc49c75cb 100644 --- a/third_party/googleapis/google/cloud/datacatalog/v1beta1/timestamps.proto +++ b/third_party/googleapis/google/cloud/datacatalog/v1beta1/timestamps.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,28 +11,31 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.datacatalog.v1beta1; +import "google/api/field_behavior.proto"; import "google/protobuf/timestamp.proto"; option cc_enable_arenas = true; +option csharp_namespace = "Google.Cloud.DataCatalog.V1Beta1"; option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog"; option java_multiple_files = true; -option java_package = "com.google.cloud.datacatalog"; +option java_package = "com.google.cloud.datacatalog.v1beta1"; +option php_namespace = "Google\\Cloud\\DataCatalog\\V1beta1"; +option ruby_package = "Google::Cloud::DataCatalog::V1beta1"; // Timestamps about this resource according to a particular system. message SystemTimestamps { - // Output only. The creation time of the resource within the given system. + // The creation time of the resource within the given system. google.protobuf.Timestamp create_time = 1; - // Output only. The last-modified time of the resource within the given - // system. + // The last-modified time of the resource within the given system. google.protobuf.Timestamp update_time = 2; // Output only. The expiration time of the resource within the given system. - google.protobuf.Timestamp expire_time = 3; + // Currently only apllicable to BigQuery resources. + google.protobuf.Timestamp expire_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/cloud/datalabeling/BUILD.bazel b/third_party/googleapis/google/cloud/datalabeling/BUILD.bazel new file mode 100644 index 000000000..a87c57fec --- /dev/null +++ b/third_party/googleapis/google/cloud/datalabeling/BUILD.bazel @@ -0,0 +1 @@ +exports_files(glob(["*.yaml"])) diff --git a/third_party/googleapis/google/cloud/datalabeling/artman_datalabeling_v1beta1.yaml b/third_party/googleapis/google/cloud/datalabeling/artman_datalabeling_v1beta1.yaml index 2d81d3c57..fede620c0 100644 --- a/third_party/googleapis/google/cloud/datalabeling/artman_datalabeling_v1beta1.yaml +++ b/third_party/googleapis/google/cloud/datalabeling/artman_datalabeling_v1beta1.yaml @@ -6,8 +6,9 @@ common: - name: google-common-protos src_proto_paths: - v1beta1 - service_yaml: datalabeling_v1beta1.yaml + service_yaml: v1beta1/datalabeling_v1beta1.yaml gapic_yaml: v1beta1/datalabeling_gapic.yaml + proto_package: google.cloud.datalabeling.v1beta1 artifacts: - name: gapic_config type: GAPIC_CONFIG diff --git a/third_party/googleapis/google/cloud/datalabeling/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/datalabeling/v1beta1/BUILD.bazel new file mode 100644 index 000000000..51e13936a --- /dev/null +++ b/third_party/googleapis/google/cloud/datalabeling/v1beta1/BUILD.bazel @@ -0,0 +1,384 @@ +# This file was automatically generated by BuildFileGenerator + +# This is an API workspace, having public visibility by default makes perfect sense. +package(default_visibility = ["//visibility:public"]) + +############################################################################## +# Common +############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") +load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") + +proto_library( + name = "datalabeling_proto", + srcs = [ + "annotation.proto", + "annotation_spec_set.proto", + "data_labeling_service.proto", + "data_payloads.proto", + "dataset.proto", + "evaluation.proto", + "evaluation_job.proto", + "human_annotation_config.proto", + "instruction.proto", + "operations.proto", + ], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/longrunning:operations_proto", + "//google/rpc:status_proto", + "@com_google_protobuf//:duration_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +proto_library_with_info( + name = "datalabeling_proto_with_info", + deps = [ + ":datalabeling_proto", + "//google/cloud:common_resources_proto", + ], +) + +############################################################################## +# Java +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", + "java_proto_library", +) + +java_proto_library( + name = "datalabeling_java_proto", + deps = [":datalabeling_proto"], +) + +java_grpc_library( + name = "datalabeling_java_grpc", + srcs = [":datalabeling_proto"], + deps = [":datalabeling_java_proto"], +) + +java_gapic_library( + name = "datalabeling_java_gapic", + src = ":datalabeling_proto_with_info", + gapic_yaml = "datalabeling_gapic.yaml", + package = "google.cloud.datalabeling.v1beta1", + service_yaml = "datalabeling_v1beta1.yaml", + test_deps = [ + ":datalabeling_java_grpc", + ], + deps = [ + ":datalabeling_java_proto", + ], +) + +java_gapic_test( + name = "datalabeling_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.datalabeling.v1beta1.DataLabelingServiceClientTest", + ], + runtime_deps = [":datalabeling_java_gapic_test"], +) + +# Open Source Packages +java_gapic_assembly_gradle_pkg( + name = "google-cloud-datalabeling-v1beta1-java", + deps = [ + ":datalabeling_java_gapic", + ":datalabeling_java_grpc", + ":datalabeling_java_proto", + ":datalabeling_proto", + ], +) + +############################################################################## +# Go +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", + "go_proto_library", + "go_test", +) + +go_proto_library( + name = "datalabeling_go_proto", + compilers = ["@io_bazel_rules_go//proto:go_grpc"], + importpath = "google.golang.org/genproto/googleapis/cloud/datalabeling/v1beta1", + protos = [":datalabeling_proto"], + deps = [ + "//google/api:annotations_go_proto", + "//google/longrunning:longrunning_go_proto", + "//google/rpc:status_go_proto", + ], +) + +go_gapic_library( + name = "datalabeling_go_gapic", + srcs = [":datalabeling_proto_with_info"], + grpc_service_config = "datalabeling_grpc_service_config.json", + importpath = "cloud.google.com/go/datalabeling/apiv1beta1;datalabeling", + service_yaml = "datalabeling_v1beta1.yaml", + deps = [ + ":datalabeling_go_proto", + "//google/longrunning:longrunning_go_gapic", + "//google/longrunning:longrunning_go_proto", + "@com_google_cloud_go//longrunning:go_default_library", + "@com_google_cloud_go//longrunning/autogen:go_default_library", + "@io_bazel_rules_go//proto/wkt:duration_go_proto", + ], +) + +go_test( + name = "datalabeling_go_gapic_test", + srcs = [":datalabeling_go_gapic_srcjar_test"], + embed = [":datalabeling_go_gapic"], + importpath = "cloud.google.com/go/datalabeling/apiv1beta1", +) + +# Open Source Packages +go_gapic_assembly_pkg( + name = "gapi-cloud-datalabeling-v1beta1-go", + deps = [ + ":datalabeling_go_gapic", + ":datalabeling_go_gapic_srcjar-test.srcjar", + ":datalabeling_go_proto", + ], +) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "datalabeling_moved_proto", + srcs = [":datalabeling_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/longrunning:operations_proto", + "//google/rpc:status_proto", + "@com_google_protobuf//:duration_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +py_proto_library( + name = "datalabeling_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":datalabeling_moved_proto"], +) + +py_grpc_library( + name = "datalabeling_py_grpc", + srcs = [":datalabeling_moved_proto"], + deps = [":datalabeling_py_proto"], +) + +py_gapic_library( + name = "datalabeling_py_gapic", + src = ":datalabeling_proto_with_info", + gapic_yaml = "datalabeling_gapic.yaml", + package = "google.cloud.datalabeling.v1beta1", + service_yaml = "datalabeling_v1beta1.yaml", + deps = [ + ":datalabeling_py_grpc", + ":datalabeling_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "datalabeling-v1beta1-py", + deps = [ + ":datalabeling_py_gapic", + ":datalabeling_py_grpc", + ":datalabeling_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "datalabeling_php_proto", + deps = [":datalabeling_proto"], +) + +php_grpc_library( + name = "datalabeling_php_grpc", + srcs = [":datalabeling_proto"], + deps = [":datalabeling_php_proto"], +) + +php_gapic_library( + name = "datalabeling_php_gapic", + src = ":datalabeling_proto_with_info", + gapic_yaml = "datalabeling_gapic.yaml", + package = "google.cloud.datalabeling.v1beta1", + service_yaml = "datalabeling_v1beta1.yaml", + deps = [ + ":datalabeling_php_grpc", + ":datalabeling_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-datalabeling-v1beta1-php", + deps = [ + ":datalabeling_php_gapic", + ":datalabeling_php_grpc", + ":datalabeling_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "datalabeling_nodejs_gapic", + src = ":datalabeling_proto_with_info", + gapic_yaml = "datalabeling_gapic.yaml", + package = "google.cloud.datalabeling.v1beta1", + service_yaml = "datalabeling_v1beta1.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "datalabeling-v1beta1-nodejs", + deps = [ + ":datalabeling_nodejs_gapic", + ":datalabeling_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "datalabeling_ruby_proto", + deps = [":datalabeling_proto"], +) + +ruby_grpc_library( + name = "datalabeling_ruby_grpc", + srcs = [":datalabeling_proto"], + deps = [":datalabeling_ruby_proto"], +) + +ruby_gapic_library( + name = "datalabeling_ruby_gapic", + src = ":datalabeling_proto_with_info", + gapic_yaml = "datalabeling_gapic.yaml", + package = "google.cloud.datalabeling.v1beta1", + service_yaml = "datalabeling_v1beta1.yaml", + deps = [ + ":datalabeling_ruby_grpc", + ":datalabeling_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-datalabeling-v1beta1-ruby", + deps = [ + ":datalabeling_ruby_gapic", + ":datalabeling_ruby_grpc", + ":datalabeling_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "datalabeling_csharp_proto", + deps = [":datalabeling_proto"], +) + +csharp_grpc_library( + name = "datalabeling_csharp_grpc", + srcs = [":datalabeling_proto"], + deps = [":datalabeling_csharp_proto"], +) + +csharp_gapic_library( + name = "datalabeling_csharp_gapic", + src = ":datalabeling_proto_with_info", + gapic_yaml = "datalabeling_gapic.yaml", + package = "google.cloud.datalabeling.v1beta1", + service_yaml = "datalabeling_v1beta1.yaml", + deps = [ + ":datalabeling_csharp_grpc", + ":datalabeling_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-datalabeling-v1beta1-csharp", + deps = [ + ":datalabeling_csharp_gapic", + ":datalabeling_csharp_grpc", + ":datalabeling_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/cloud/datalabeling/v1beta1/annotation.proto b/third_party/googleapis/google/cloud/datalabeling/v1beta1/annotation.proto index b71e45980..4750fdc3b 100644 --- a/third_party/googleapis/google/cloud/datalabeling/v1beta1/annotation.proto +++ b/third_party/googleapis/google/cloud/datalabeling/v1beta1/annotation.proto @@ -18,15 +18,16 @@ syntax = "proto3"; package google.cloud.datalabeling.v1beta1; import "google/api/annotations.proto"; +import "google/api/resource.proto"; import "google/cloud/datalabeling/v1beta1/annotation_spec_set.proto"; -import "google/cloud/datalabeling/v1beta1/data_payloads.proto"; import "google/protobuf/duration.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/datalabeling/v1beta1;datalabeling"; option java_multiple_files = true; option java_package = "com.google.cloud.datalabeling.v1beta1"; -// Specifies where is the answer from. +// Specifies where the annotation comes from (whether it was provided by a +// human labeler or a different source). enum AnnotationSource { ANNOTATION_SOURCE_UNSPECIFIED = 0; @@ -71,10 +72,11 @@ enum AnnotationSentiment { enum AnnotationType { ANNOTATION_TYPE_UNSPECIFIED = 0; - // Classification annotations in an image. + // Classification annotations in an image. Allowed for continuous evaluation. IMAGE_CLASSIFICATION_ANNOTATION = 1; - // Bounding box annotations in an image. + // Bounding box annotations in an image. A form of image object detection. + // Allowed for continuous evaluation. IMAGE_BOUNDING_BOX_ANNOTATION = 2; // Oriented bounding box. The box does not have to be parallel to horizontal @@ -102,13 +104,13 @@ enum AnnotationType { // Video event annotation. VIDEO_EVENT_ANNOTATION = 6; - // Classification for text. + // Classification for text. Allowed for continuous evaluation. TEXT_CLASSIFICATION_ANNOTATION = 8; // Entity extraction for text. TEXT_ENTITY_EXTRACTION_ANNOTATION = 9; - // General classification. + // General classification. Allowed for continuous evaluation. GENERAL_CLASSIFICATION_ANNOTATION = 14; } diff --git a/third_party/googleapis/google/cloud/datalabeling/v1beta1/annotation_spec_set.proto b/third_party/googleapis/google/cloud/datalabeling/v1beta1/annotation_spec_set.proto index bd5413dc7..71bc12a1a 100644 --- a/third_party/googleapis/google/cloud/datalabeling/v1beta1/annotation_spec_set.proto +++ b/third_party/googleapis/google/cloud/datalabeling/v1beta1/annotation_spec_set.proto @@ -18,28 +18,36 @@ syntax = "proto3"; package google.cloud.datalabeling.v1beta1; import "google/api/annotations.proto"; +import "google/api/resource.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/datalabeling/v1beta1;datalabeling"; option java_multiple_files = true; option java_package = "com.google.cloud.datalabeling.v1beta1"; -// AnnotationSpecSet is a collection of label definitions. For example, in -// image classification tasks, we define a set of labels, this set is called -// AnnotationSpecSet. AnnotationSpecSet is immutable upon creation. +// An AnnotationSpecSet is a collection of label definitions. For example, in +// image classification tasks, you define a set of possible labels for images as +// an AnnotationSpecSet. An AnnotationSpecSet is immutable upon creation. message AnnotationSpecSet { - // Output only. AnnotationSpecSet resource name, format: - // projects/{project_id}/annotationSpecSets/{annotation_spec_set_id} + option (google.api.resource) = { + type: "datalabeling.googleapis.com/AnnotationSpecSet" + pattern: "projects/{project}/annotationSpecSets/{annotation_spec_set}" + }; + + // Output only. The AnnotationSpecSet resource name in the following format: + // + // "projects/{project_id}/annotationSpecSets/{annotation_spec_set_id}" string name = 1; - // Required. The display name for AnnotationSpecSet defined by user. - // Maximum of 64 characters. + // Required. The display name for AnnotationSpecSet that you define when you + // create it. Maximum of 64 characters. string display_name = 2; // Optional. User-provided description of the annotation specification set. - // The description can be up to 10000 characters long. + // The description can be up to 10,000 characters long. string description = 3; - // Required. The actual spec set defined by the users. + // Required. The array of AnnotationSpecs that you define when you create the + // AnnotationSpecSet. These are the possible labels for the labeling task. repeated AnnotationSpec annotation_specs = 4; // Output only. The names of any related resources that are blocking changes @@ -47,12 +55,15 @@ message AnnotationSpecSet { repeated string blocking_resources = 5; } -// Container of information related to one annotation spec. +// Container of information related to one possible annotation that can be used +// in a labeling task. For example, an image classification task where images +// are labeled as `dog` or `cat` must reference an AnnotationSpec for `dog` and +// an AnnotationSpec for `cat`. message AnnotationSpec { // Required. The display name of the AnnotationSpec. Maximum of 64 characters. string display_name = 1; // Optional. User-provided description of the annotation specification. - // The description can be up to 10000 characters long. + // The description can be up to 10,000 characters long. string description = 2; } diff --git a/third_party/googleapis/google/cloud/datalabeling/v1beta1/data_labeling_service.proto b/third_party/googleapis/google/cloud/datalabeling/v1beta1/data_labeling_service.proto index 8395206d9..7616bc2f7 100644 --- a/third_party/googleapis/google/cloud/datalabeling/v1beta1/data_labeling_service.proto +++ b/third_party/googleapis/google/cloud/datalabeling/v1beta1/data_labeling_service.proto @@ -19,14 +19,14 @@ package google.cloud.datalabeling.v1beta1; import "google/api/annotations.proto"; import "google/api/client.proto"; -import "google/cloud/datalabeling/v1beta1/annotation.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/cloud/datalabeling/v1beta1/annotation_spec_set.proto"; import "google/cloud/datalabeling/v1beta1/dataset.proto"; import "google/cloud/datalabeling/v1beta1/evaluation.proto"; import "google/cloud/datalabeling/v1beta1/evaluation_job.proto"; import "google/cloud/datalabeling/v1beta1/human_annotation_config.proto"; import "google/cloud/datalabeling/v1beta1/instruction.proto"; -import "google/cloud/datalabeling/v1beta1/operations.proto"; import "google/longrunning/operations.proto"; import "google/protobuf/empty.proto"; import "google/protobuf/field_mask.proto"; @@ -37,8 +37,7 @@ option java_package = "com.google.cloud.datalabeling.v1beta1"; service DataLabelingService { option (google.api.default_host) = "datalabeling.googleapis.com"; - option (google.api.oauth_scopes) = - "https://www.googleapis.com/auth/cloud-platform"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; // Creates dataset. If success return a Dataset resource. rpc CreateDataset(CreateDatasetRequest) returns (Dataset) { @@ -46,6 +45,7 @@ service DataLabelingService { post: "/v1beta1/{parent=projects/*}/datasets" body: "*" }; + option (google.api.method_signature) = "parent,dataset"; } // Gets dataset by resource name. @@ -53,6 +53,7 @@ service DataLabelingService { option (google.api.http) = { get: "/v1beta1/{name=projects/*/datasets/*}" }; + option (google.api.method_signature) = "name"; } // Lists datasets under a project. Pagination is supported. @@ -60,6 +61,7 @@ service DataLabelingService { option (google.api.http) = { get: "/v1beta1/{parent=projects/*}/datasets" }; + option (google.api.method_signature) = "parent,filter"; } // Deletes a dataset by resource name. @@ -67,6 +69,7 @@ service DataLabelingService { option (google.api.http) = { delete: "/v1beta1/{name=projects/*/datasets/*}" }; + option (google.api.method_signature) = "name"; } // Imports data into dataset based on source locations defined in request. @@ -79,6 +82,11 @@ service DataLabelingService { post: "/v1beta1/{name=projects/*/datasets/*}:importData" body: "*" }; + option (google.api.method_signature) = "name,input_config"; + option (google.longrunning.operation_info) = { + response_type: "ImportDataOperationResponse" + metadata_type: "ImportDataOperationMetadata" + }; } // Exports data and annotations from dataset. @@ -87,6 +95,11 @@ service DataLabelingService { post: "/v1beta1/{name=projects/*/datasets/*}:exportData" body: "*" }; + option (google.api.method_signature) = "name,annotated_dataset,filter,output_config"; + option (google.longrunning.operation_info) = { + response_type: "ExportDataOperationResponse" + metadata_type: "ExportDataOperationMetadata" + }; } // Gets a data item in a dataset by resource name. This API can be @@ -95,6 +108,7 @@ service DataLabelingService { option (google.api.http) = { get: "/v1beta1/{name=projects/*/datasets/*/dataItems/*}" }; + option (google.api.method_signature) = "name"; } // Lists data items in a dataset. This API can be called after data @@ -103,27 +117,27 @@ service DataLabelingService { option (google.api.http) = { get: "/v1beta1/{parent=projects/*/datasets/*}/dataItems" }; + option (google.api.method_signature) = "parent,filter"; } // Gets an annotated dataset by resource name. - rpc GetAnnotatedDataset(GetAnnotatedDatasetRequest) - returns (AnnotatedDataset) { + rpc GetAnnotatedDataset(GetAnnotatedDatasetRequest) returns (AnnotatedDataset) { option (google.api.http) = { get: "/v1beta1/{name=projects/*/datasets/*/annotatedDatasets/*}" }; + option (google.api.method_signature) = "name"; } // Lists annotated datasets for a dataset. Pagination is supported. - rpc ListAnnotatedDatasets(ListAnnotatedDatasetsRequest) - returns (ListAnnotatedDatasetsResponse) { + rpc ListAnnotatedDatasets(ListAnnotatedDatasetsRequest) returns (ListAnnotatedDatasetsResponse) { option (google.api.http) = { get: "/v1beta1/{parent=projects/*/datasets/*}/annotatedDatasets" }; + option (google.api.method_signature) = "parent,filter"; } // Deletes an annotated dataset by resource name. - rpc DeleteAnnotatedDataset(DeleteAnnotatedDatasetRequest) - returns (google.protobuf.Empty) { + rpc DeleteAnnotatedDataset(DeleteAnnotatedDatasetRequest) returns (google.protobuf.Empty) { option (google.api.http) = { delete: "/v1beta1/{name=projects/*/datasets/*/annotatedDatasets/*}" }; @@ -136,6 +150,11 @@ service DataLabelingService { post: "/v1beta1/{parent=projects/*/datasets/*}/image:label" body: "*" }; + option (google.api.method_signature) = "parent,basic_config,feature"; + option (google.longrunning.operation_info) = { + response_type: "AnnotatedDataset" + metadata_type: "LabelOperationMetadata" + }; } // Starts a labeling task for video. The type of video labeling task is @@ -145,6 +164,11 @@ service DataLabelingService { post: "/v1beta1/{parent=projects/*/datasets/*}/video:label" body: "*" }; + option (google.api.method_signature) = "parent,basic_config,feature"; + option (google.longrunning.operation_info) = { + response_type: "AnnotatedDataset" + metadata_type: "LabelOperationMetadata" + }; } // Starts a labeling task for text. The type of text labeling task is @@ -154,6 +178,11 @@ service DataLabelingService { post: "/v1beta1/{parent=projects/*/datasets/*}/text:label" body: "*" }; + option (google.api.method_signature) = "parent,basic_config,feature"; + option (google.longrunning.operation_info) = { + response_type: "AnnotatedDataset" + metadata_type: "LabelOperationMetadata" + }; } // Gets an example by resource name, including both data and annotation. @@ -161,6 +190,7 @@ service DataLabelingService { option (google.api.http) = { get: "/v1beta1/{name=projects/*/datasets/*/annotatedDatasets/*/examples/*}" }; + option (google.api.method_signature) = "name,filter"; } // Lists examples in an annotated dataset. Pagination is supported. @@ -168,48 +198,53 @@ service DataLabelingService { option (google.api.http) = { get: "/v1beta1/{parent=projects/*/datasets/*/annotatedDatasets/*}/examples" }; + option (google.api.method_signature) = "parent,filter"; } // Creates an annotation spec set by providing a set of labels. - rpc CreateAnnotationSpecSet(CreateAnnotationSpecSetRequest) - returns (AnnotationSpecSet) { + rpc CreateAnnotationSpecSet(CreateAnnotationSpecSetRequest) returns (AnnotationSpecSet) { option (google.api.http) = { post: "/v1beta1/{parent=projects/*}/annotationSpecSets" body: "*" }; + option (google.api.method_signature) = "parent,annotation_spec_set"; } // Gets an annotation spec set by resource name. - rpc GetAnnotationSpecSet(GetAnnotationSpecSetRequest) - returns (AnnotationSpecSet) { + rpc GetAnnotationSpecSet(GetAnnotationSpecSetRequest) returns (AnnotationSpecSet) { option (google.api.http) = { get: "/v1beta1/{name=projects/*/annotationSpecSets/*}" }; + option (google.api.method_signature) = "name"; } // Lists annotation spec sets for a project. Pagination is supported. - rpc ListAnnotationSpecSets(ListAnnotationSpecSetsRequest) - returns (ListAnnotationSpecSetsResponse) { + rpc ListAnnotationSpecSets(ListAnnotationSpecSetsRequest) returns (ListAnnotationSpecSetsResponse) { option (google.api.http) = { get: "/v1beta1/{parent=projects/*}/annotationSpecSets" }; + option (google.api.method_signature) = "parent,filter"; } // Deletes an annotation spec set by resource name. - rpc DeleteAnnotationSpecSet(DeleteAnnotationSpecSetRequest) - returns (google.protobuf.Empty) { + rpc DeleteAnnotationSpecSet(DeleteAnnotationSpecSetRequest) returns (google.protobuf.Empty) { option (google.api.http) = { delete: "/v1beta1/{name=projects/*/annotationSpecSets/*}" }; + option (google.api.method_signature) = "name"; } // Creates an instruction for how data should be labeled. - rpc CreateInstruction(CreateInstructionRequest) - returns (google.longrunning.Operation) { + rpc CreateInstruction(CreateInstructionRequest) returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1beta1/{parent=projects/*}/instructions" body: "*" }; + option (google.api.method_signature) = "parent,instruction"; + option (google.longrunning.operation_info) = { + response_type: "Instruction" + metadata_type: "CreateInstructionMetadata" + }; } // Gets an instruction by resource name. @@ -217,49 +252,51 @@ service DataLabelingService { option (google.api.http) = { get: "/v1beta1/{name=projects/*/instructions/*}" }; + option (google.api.method_signature) = "name"; } // Lists instructions for a project. Pagination is supported. - rpc ListInstructions(ListInstructionsRequest) - returns (ListInstructionsResponse) { + rpc ListInstructions(ListInstructionsRequest) returns (ListInstructionsResponse) { option (google.api.http) = { get: "/v1beta1/{parent=projects/*}/instructions" }; + option (google.api.method_signature) = "parent,filter"; } // Deletes an instruction object by resource name. - rpc DeleteInstruction(DeleteInstructionRequest) - returns (google.protobuf.Empty) { + rpc DeleteInstruction(DeleteInstructionRequest) returns (google.protobuf.Empty) { option (google.api.http) = { delete: "/v1beta1/{name=projects/*/instructions/*}" }; + option (google.api.method_signature) = "name"; } - // Gets an evaluation by resource name. + // Gets an evaluation by resource name (to search, use + // [projects.evaluations.search][google.cloud.datalabeling.v1beta1.DataLabelingService.SearchEvaluations]). rpc GetEvaluation(GetEvaluationRequest) returns (Evaluation) { option (google.api.http) = { get: "/v1beta1/{name=projects/*/datasets/*/evaluations/*}" }; + option (google.api.method_signature) = "name"; } - // Searchs evaluations within a project. Supported filter: evaluation_job, - // evaluation_time. - rpc SearchEvaluations(SearchEvaluationsRequest) - returns (SearchEvaluationsResponse) { + // Searches [evaluations][google.cloud.datalabeling.v1beta1.Evaluation] within a project. + rpc SearchEvaluations(SearchEvaluationsRequest) returns (SearchEvaluationsResponse) { option (google.api.http) = { get: "/v1beta1/{parent=projects/*}/evaluations:search" }; + option (google.api.method_signature) = "parent,filter"; } - // Searchs example comparisons in evaluation, in format of examples - // of both ground truth and prediction(s). It is represented as a search with - // evaluation id. - rpc SearchExampleComparisons(SearchExampleComparisonsRequest) - returns (SearchExampleComparisonsResponse) { + // Searches example comparisons from an evaluation. The return format is a + // list of example comparisons that show ground truth and prediction(s) for + // a single input. Search by providing an evaluation ID. + rpc SearchExampleComparisons(SearchExampleComparisonsRequest) returns (SearchExampleComparisonsResponse) { option (google.api.http) = { post: "/v1beta1/{parent=projects/*/datasets/*/evaluations/*}/exampleComparisons:search" body: "*" }; + option (google.api.method_signature) = "parent"; } // Creates an evaluation job. @@ -268,14 +305,21 @@ service DataLabelingService { post: "/v1beta1/{parent=projects/*}/evaluationJobs" body: "*" }; + option (google.api.method_signature) = "parent,job"; } - // Updates an evaluation job. + // Updates an evaluation job. You can only update certain fields of the job's + // [EvaluationJobConfig][google.cloud.datalabeling.v1beta1.EvaluationJobConfig]: `humanAnnotationConfig.instruction`, + // `exampleCount`, and `exampleSamplePercentage`. + // + // If you want to change any other aspect of the evaluation job, you must + // delete the job and create a new one. rpc UpdateEvaluationJob(UpdateEvaluationJobRequest) returns (EvaluationJob) { option (google.api.http) = { patch: "/v1beta1/{evaluation_job.name=projects/*/evaluationJobs/*}" body: "evaluation_job" }; + option (google.api.method_signature) = "evaluation_job,update_mask"; } // Gets an evaluation job by resource name. @@ -283,43 +327,44 @@ service DataLabelingService { option (google.api.http) = { get: "/v1beta1/{name=projects/*/evaluationJobs/*}" }; + option (google.api.method_signature) = "name"; } - // Pauses an evaluation job. Pausing a evaluation job that is already in - // PAUSED state will be a no-op. - rpc PauseEvaluationJob(PauseEvaluationJobRequest) - returns (google.protobuf.Empty) { + // Pauses an evaluation job. Pausing an evaluation job that is already in a + // `PAUSED` state is a no-op. + rpc PauseEvaluationJob(PauseEvaluationJobRequest) returns (google.protobuf.Empty) { option (google.api.http) = { post: "/v1beta1/{name=projects/*/evaluationJobs/*}:pause" body: "*" }; + option (google.api.method_signature) = "name"; } - // Resumes a paused evaluation job. Deleted evaluation job can't be resumed. - // Resuming a running evaluation job will be a no-op. - rpc ResumeEvaluationJob(ResumeEvaluationJobRequest) - returns (google.protobuf.Empty) { + // Resumes a paused evaluation job. A deleted evaluation job can't be resumed. + // Resuming a running or scheduled evaluation job is a no-op. + rpc ResumeEvaluationJob(ResumeEvaluationJobRequest) returns (google.protobuf.Empty) { option (google.api.http) = { post: "/v1beta1/{name=projects/*/evaluationJobs/*}:resume" body: "*" }; + option (google.api.method_signature) = "name"; } // Stops and deletes an evaluation job. - rpc DeleteEvaluationJob(DeleteEvaluationJobRequest) - returns (google.protobuf.Empty) { + rpc DeleteEvaluationJob(DeleteEvaluationJobRequest) returns (google.protobuf.Empty) { option (google.api.http) = { delete: "/v1beta1/{name=projects/*/evaluationJobs/*}" }; + option (google.api.method_signature) = "name"; } // Lists all evaluation jobs within a project with possible filters. // Pagination is supported. - rpc ListEvaluationJobs(ListEvaluationJobsRequest) - returns (ListEvaluationJobsResponse) { + rpc ListEvaluationJobs(ListEvaluationJobsRequest) returns (ListEvaluationJobsResponse) { option (google.api.http) = { get: "/v1beta1/{parent=projects/*}/evaluationJobs" }; + option (google.api.method_signature) = "parent,filter"; } } @@ -327,38 +372,53 @@ service DataLabelingService { message CreateDatasetRequest { // Required. Dataset resource parent, format: // projects/{project_id} - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudresourcemanager.googleapis.com/Project" + } + ]; // Required. The dataset to be created. - Dataset dataset = 2; + Dataset dataset = 2 [(google.api.field_behavior) = REQUIRED]; } // Request message for GetDataSet. message GetDatasetRequest { // Required. Dataset resource name, format: // projects/{project_id}/datasets/{dataset_id} - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/Dataset" + } + ]; } // Request message for ListDataset. message ListDatasetsRequest { // Required. Dataset resource parent, format: // projects/{project_id} - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudresourcemanager.googleapis.com/Project" + } + ]; // Optional. Filter on dataset is not supported at this moment. - string filter = 2; + string filter = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. Requested page size. Server may return fewer results than // requested. Default value is 100. - int32 page_size = 3; + int32 page_size = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. A token identifying a page of results for the server to return. // Typically obtained by - // [ListDatasetsResponse.next_page_token][google.cloud.datalabeling.v1beta1.ListDatasetsResponse.next_page_token] - // of the previous [DataLabelingService.ListDatasets] call. Returns the first - // page if empty. - string page_token = 4; + // [ListDatasetsResponse.next_page_token][google.cloud.datalabeling.v1beta1.ListDatasetsResponse.next_page_token] of the previous + // [DataLabelingService.ListDatasets] call. + // Returns the first page if empty. + string page_token = 4 [(google.api.field_behavior) = OPTIONAL]; } // Results of listing datasets within a project. @@ -374,17 +434,27 @@ message ListDatasetsResponse { message DeleteDatasetRequest { // Required. Dataset resource name, format: // projects/{project_id}/datasets/{dataset_id} - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/Dataset" + } + ]; } // Request message for ImportData API. message ImportDataRequest { // Required. Dataset resource name, format: // projects/{project_id}/datasets/{dataset_id} - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/Dataset" + } + ]; // Required. Specify the input source of the data. - InputConfig input_config = 2; + InputConfig input_config = 2 [(google.api.field_behavior) = REQUIRED]; // Email of the user who started the import task and should be notified by // email. If empty no notification will be sent. @@ -395,20 +465,30 @@ message ImportDataRequest { message ExportDataRequest { // Required. Dataset resource name, format: // projects/{project_id}/datasets/{dataset_id} - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/Dataset" + } + ]; // Required. Annotated dataset resource name. DataItem in // Dataset and their annotations in specified annotated dataset will be // exported. It's in format of // projects/{project_id}/datasets/{dataset_id}/annotatedDatasets/ // {annotated_dataset_id} - string annotated_dataset = 2; + string annotated_dataset = 2 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/AnnotatedDataset" + } + ]; // Optional. Filter is not supported at this moment. - string filter = 3; + string filter = 3 [(google.api.field_behavior) = OPTIONAL]; // Required. Specify the output destination. - OutputConfig output_config = 4; + OutputConfig output_config = 4 [(google.api.field_behavior) = REQUIRED]; // Email of the user who started the export task and should be notified by // email. If empty no notification will be sent. @@ -419,28 +499,38 @@ message ExportDataRequest { message GetDataItemRequest { // Required. The name of the data item to get, format: // projects/{project_id}/datasets/{dataset_id}/dataItems/{data_item_id} - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/DataItem" + } + ]; } // Request message for ListDataItems. message ListDataItemsRequest { // Required. Name of the dataset to list data items, format: // projects/{project_id}/datasets/{dataset_id} - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/Dataset" + } + ]; // Optional. Filter is not supported at this moment. - string filter = 2; + string filter = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. Requested page size. Server may return fewer results than // requested. Default value is 100. - int32 page_size = 3; + int32 page_size = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. A token identifying a page of results for the server to return. // Typically obtained by - // [ListDataItemsResponse.next_page_token][google.cloud.datalabeling.v1beta1.ListDataItemsResponse.next_page_token] - // of the previous [DataLabelingService.ListDataItems] call. Return first page - // if empty. - string page_token = 4; + // [ListDataItemsResponse.next_page_token][google.cloud.datalabeling.v1beta1.ListDataItemsResponse.next_page_token] of the previous + // [DataLabelingService.ListDataItems] call. + // Return first page if empty. + string page_token = 4 [(google.api.field_behavior) = OPTIONAL]; } // Results of listing data items in a dataset. @@ -457,28 +547,38 @@ message GetAnnotatedDatasetRequest { // Required. Name of the annotated dataset to get, format: // projects/{project_id}/datasets/{dataset_id}/annotatedDatasets/ // {annotated_dataset_id} - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/AnnotatedDataset" + } + ]; } // Request message for ListAnnotatedDatasets. message ListAnnotatedDatasetsRequest { // Required. Name of the dataset to list annotated datasets, format: // projects/{project_id}/datasets/{dataset_id} - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/Dataset" + } + ]; // Optional. Filter is not supported at this moment. - string filter = 2; + string filter = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. Requested page size. Server may return fewer results than // requested. Default value is 100. - int32 page_size = 3; + int32 page_size = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. A token identifying a page of results for the server to return. // Typically obtained by - // [ListAnnotatedDatasetsResponse.next_page_token][google.cloud.datalabeling.v1beta1.ListAnnotatedDatasetsResponse.next_page_token] - // of the previous [DataLabelingService.ListAnnotatedDatasets] call. Return - // first page if empty. - string page_token = 4; + // [ListAnnotatedDatasetsResponse.next_page_token][google.cloud.datalabeling.v1beta1.ListAnnotatedDatasetsResponse.next_page_token] of the previous + // [DataLabelingService.ListAnnotatedDatasets] call. + // Return first page if empty. + string page_token = 4 [(google.api.field_behavior) = OPTIONAL]; } // Results of listing annotated datasets for a dataset. @@ -495,7 +595,12 @@ message DeleteAnnotatedDatasetRequest { // Required. Name of the annotated dataset to delete, format: // projects/{project_id}/datasets/{dataset_id}/annotatedDatasets/ // {annotated_dataset_id} - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/AnnotatedDataset" + } + ]; } // Request message for starting an image labeling task. @@ -553,13 +658,18 @@ message LabelImageRequest { // Required. Name of the dataset to request labeling task, format: // projects/{project_id}/datasets/{dataset_id} - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/Dataset" + } + ]; // Required. Basic human annotation config. - HumanAnnotationConfig basic_config = 2; + HumanAnnotationConfig basic_config = 2 [(google.api.field_behavior) = REQUIRED]; // Required. The type of image labeling task. - Feature feature = 3; + Feature feature = 3 [(google.api.field_behavior) = REQUIRED]; } // Request message for LabelVideo. @@ -607,13 +717,18 @@ message LabelVideoRequest { // Required. Name of the dataset to request labeling task, format: // projects/{project_id}/datasets/{dataset_id} - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/Dataset" + } + ]; // Required. Basic human annotation config. - HumanAnnotationConfig basic_config = 2; + HumanAnnotationConfig basic_config = 2 [(google.api.field_behavior) = REQUIRED]; // Required. The type of video labeling task. - Feature feature = 3; + Feature feature = 3 [(google.api.field_behavior) = REQUIRED]; } // Request message for LabelText. @@ -645,13 +760,18 @@ message LabelTextRequest { // Required. Name of the data set to request labeling task, format: // projects/{project_id}/datasets/{dataset_id} - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/Dataset" + } + ]; // Required. Basic human annotation config. - HumanAnnotationConfig basic_config = 2; + HumanAnnotationConfig basic_config = 2 [(google.api.field_behavior) = REQUIRED]; // Required. The type of text labeling task. - Feature feature = 6; + Feature feature = 6 [(google.api.field_behavior) = REQUIRED]; } // Request message for GetExample @@ -659,35 +779,45 @@ message GetExampleRequest { // Required. Name of example, format: // projects/{project_id}/datasets/{dataset_id}/annotatedDatasets/ // {annotated_dataset_id}/examples/{example_id} - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/Example" + } + ]; // Optional. An expression for filtering Examples. Filter by // annotation_spec.display_name is supported. Format // "annotation_spec.display_name = {display_name}" - string filter = 2; + string filter = 2 [(google.api.field_behavior) = OPTIONAL]; } // Request message for ListExamples. message ListExamplesRequest { // Required. Example resource parent. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/AnnotatedDataset" + } + ]; // Optional. An expression for filtering Examples. For annotated datasets that // have annotation spec set, filter by // annotation_spec.display_name is supported. Format // "annotation_spec.display_name = {display_name}" - string filter = 2; + string filter = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. Requested page size. Server may return fewer results than // requested. Default value is 100. - int32 page_size = 3; + int32 page_size = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. A token identifying a page of results for the server to return. // Typically obtained by - // [ListExamplesResponse.next_page_token][google.cloud.datalabeling.v1beta1.ListExamplesResponse.next_page_token] - // of the previous [DataLabelingService.ListExamples] call. Return first page - // if empty. - string page_token = 4; + // [ListExamplesResponse.next_page_token][google.cloud.datalabeling.v1beta1.ListExamplesResponse.next_page_token] of the previous + // [DataLabelingService.ListExamples] call. + // Return first page if empty. + string page_token = 4 [(google.api.field_behavior) = OPTIONAL]; } // Results of listing Examples in and annotated dataset. @@ -703,40 +833,55 @@ message ListExamplesResponse { message CreateAnnotationSpecSetRequest { // Required. AnnotationSpecSet resource parent, format: // projects/{project_id} - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudresourcemanager.googleapis.com/Project" + } + ]; // Required. Annotation spec set to create. Annotation specs must be included. // Only one annotation spec will be accepted for annotation specs with same // display_name. - AnnotationSpecSet annotation_spec_set = 2; + AnnotationSpecSet annotation_spec_set = 2 [(google.api.field_behavior) = REQUIRED]; } // Request message for GetAnnotationSpecSet. message GetAnnotationSpecSetRequest { // Required. AnnotationSpecSet resource name, format: // projects/{project_id}/annotationSpecSets/{annotation_spec_set_id} - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/AnnotationSpecSet" + } + ]; } // Request message for ListAnnotationSpecSets. message ListAnnotationSpecSetsRequest { // Required. Parent of AnnotationSpecSet resource, format: // projects/{project_id} - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudresourcemanager.googleapis.com/Project" + } + ]; // Optional. Filter is not supported at this moment. - string filter = 2; + string filter = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. Requested page size. Server may return fewer results than // requested. Default value is 100. - int32 page_size = 3; + int32 page_size = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. A token identifying a page of results for the server to return. // Typically obtained by - // [ListAnnotationSpecSetsResponse.next_page_token][google.cloud.datalabeling.v1beta1.ListAnnotationSpecSetsResponse.next_page_token] - // of the previous [DataLabelingService.ListAnnotationSpecSets] call. Return - // first page if empty. - string page_token = 4; + // [ListAnnotationSpecSetsResponse.next_page_token][google.cloud.datalabeling.v1beta1.ListAnnotationSpecSetsResponse.next_page_token] of the previous + // [DataLabelingService.ListAnnotationSpecSets] call. + // Return first page if empty. + string page_token = 4 [(google.api.field_behavior) = OPTIONAL]; } // Results of listing annotation spec set under a project. @@ -752,52 +897,77 @@ message ListAnnotationSpecSetsResponse { message DeleteAnnotationSpecSetRequest { // Required. AnnotationSpec resource name, format: // `projects/{project_id}/annotationSpecSets/{annotation_spec_set_id}`. - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/AnnotationSpecSet" + } + ]; } // Request message for CreateInstruction. message CreateInstructionRequest { // Required. Instruction resource parent, format: // projects/{project_id} - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudresourcemanager.googleapis.com/Project" + } + ]; // Required. Instruction of how to perform the labeling task. - Instruction instruction = 2; + Instruction instruction = 2 [(google.api.field_behavior) = REQUIRED]; } // Request message for GetInstruction. message GetInstructionRequest { // Required. Instruction resource name, format: // projects/{project_id}/instructions/{instruction_id} - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/Instruction" + } + ]; } // Request message for DeleteInstruction. message DeleteInstructionRequest { // Required. Instruction resource name, format: // projects/{project_id}/instructions/{instruction_id} - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/Instruction" + } + ]; } // Request message for ListInstructions. message ListInstructionsRequest { // Required. Instruction resource parent, format: // projects/{project_id} - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudresourcemanager.googleapis.com/Project" + } + ]; // Optional. Filter is not supported at this moment. - string filter = 2; + string filter = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. Requested page size. Server may return fewer results than // requested. Default value is 100. - int32 page_size = 3; + int32 page_size = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. A token identifying a page of results for the server to return. // Typically obtained by - // [ListInstructionsResponse.next_page_token][google.cloud.datalabeling.v1beta1.ListInstructionsResponse.next_page_token] - // of the previous [DataLabelingService.ListInstructions] call. Return first - // page if empty. - string page_token = 4; + // [ListInstructionsResponse.next_page_token][google.cloud.datalabeling.v1beta1.ListInstructionsResponse.next_page_token] of the previous + // [DataLabelingService.ListInstructions] call. + // Return first page if empty. + string page_token = 4 [(google.api.field_behavior) = OPTIONAL]; } // Results of listing instructions under a project. @@ -812,39 +982,77 @@ message ListInstructionsResponse { // Request message for GetEvaluation. message GetEvaluationRequest { // Required. Name of the evaluation. Format: - // 'projects/{project_id}/datasets/{dataset_id}/evaluations/{evaluation_id}' - string name = 1; + // + // "projects/{project_id}/datasets/{dataset_id}/evaluations/{evaluation_id}' + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/Evaluation" + } + ]; } // Request message for SearchEvaluation. message SearchEvaluationsRequest { - // Required. Evaluation search parent. Format: - // projects/{project_id} - string parent = 1; - - // Optional. Support filtering by model id, job state, start and end time. - // Format: - // "evaluation_job.evaluation_job_id = {evaluation_job_id} AND - // evaluation_job.evaluation_job_run_time_start = {timestamp} AND - // evaluation_job.evaluation_job_run_time_end = {timestamp} AND - // annotation_spec.display_name = {display_name}" - string filter = 2; + // Required. Evaluation search parent (project ID). Format: + // "projects/{project_id}" + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/Evaluation" + } + ]; + + // Optional. To search evaluations, you can filter by the following: + // + // * evaluation_job.evaluation_job_id (the last part of + // [EvaluationJob.name][google.cloud.datalabeling.v1beta1.EvaluationJob.name]) + // * evaluation_job.model_id (the {model_name} portion + // of [EvaluationJob.modelVersion][google.cloud.datalabeling.v1beta1.EvaluationJob.model_version]) + // * evaluation_job.evaluation_job_run_time_start (Minimum + // threshold for the + // [evaluationJobRunTime][google.cloud.datalabeling.v1beta1.Evaluation.evaluation_job_run_time] that created + // the evaluation) + // * evaluation_job.evaluation_job_run_time_end (Maximum + // threshold for the + // [evaluationJobRunTime][google.cloud.datalabeling.v1beta1.Evaluation.evaluation_job_run_time] that created + // the evaluation) + // * evaluation_job.job_state ([EvaluationJob.state][google.cloud.datalabeling.v1beta1.EvaluationJob.state]) + // * annotation_spec.display_name (the Evaluation contains a + // metric for the annotation spec with this + // [displayName][google.cloud.datalabeling.v1beta1.AnnotationSpec.display_name]) + // + // To filter by multiple critiera, use the `AND` operator or the `OR` + // operator. The following examples shows a string that filters by several + // critiera: + // + // "evaluation_job.evaluation_job_id = + // {evaluation_job_id} AND evaluation_job.model_id = + // {model_name} AND + // evaluation_job.evaluation_job_run_time_start = + // {timestamp_1} AND + // evaluation_job.evaluation_job_run_time_end = + // {timestamp_2} AND annotation_spec.display_name = + // {display_name}" + string filter = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. Requested page size. Server may return fewer results than // requested. Default value is 100. - int32 page_size = 3; + int32 page_size = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. A token identifying a page of results for the server to return. - // Typically obtained by - // [SearchEvaluationsResponse.next_page_token][google.cloud.datalabeling.v1beta1.SearchEvaluationsResponse.next_page_token] - // of the previous [DataLabelingService.SearchEvaluations] call. Return first - // page if empty. - string page_token = 4; + // Typically obtained by the + // [nextPageToken][google.cloud.datalabeling.v1beta1.SearchEvaluationsResponse.next_page_token] of the response + // to a previous search request. + // + // If you don't specify this field, the API call requests the first page of + // the search. + string page_token = 4 [(google.api.field_behavior) = OPTIONAL]; } // Results of searching evaluations. message SearchEvaluationsResponse { - // The list of evaluations to return. + // The list of evaluations matching the search. repeated Evaluation evaluations = 1; // A token to retrieve next page of results. @@ -853,33 +1061,44 @@ message SearchEvaluationsResponse { // Request message of SearchExampleComparisons. message SearchExampleComparisonsRequest { - // Required. Name of the Evaluation resource to search example comparison - // from. Format: - // projects/{project_id}/datasets/{dataset_id}/evaluations/{evaluation_id} - string parent = 1; + // Required. Name of the [Evaluation][google.cloud.datalabeling.v1beta1.Evaluation] resource to search for example + // comparisons from. Format: + // + // "projects/{project_id}/datasets/{dataset_id}/evaluations/{evaluation_id}" + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/Evaluation" + } + ]; // Optional. Requested page size. Server may return fewer results than // requested. Default value is 100. - int32 page_size = 2; + int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. A token identifying a page of results for the server to return. - // Typically obtained by - // [SearchExampleComparisons.next_page_token][] of the previous - // [DataLabelingService.SearchExampleComparisons] call. - // Return first page if empty. - string page_token = 3; + // Typically obtained by the + // [nextPageToken][SearchExampleComparisons.next_page_token] of the response + // to a previous search rquest. + // + // If you don't specify this field, the API call requests the first page of + // the search. + string page_token = 3 [(google.api.field_behavior) = OPTIONAL]; } // Results of searching example comparisons. message SearchExampleComparisonsResponse { - // Example comparisons containing annotation comparison between groundtruth - // and predictions. + // Example comparisons comparing ground truth output and predictions for a + // specific input. message ExampleComparison { + // The ground truth output for the input. Example ground_truth_example = 1; + // Predictions by the model for the input. repeated Example model_created_examples = 2; } + // A list of example comparisons matching the search criteria. repeated ExampleComparison example_comparisons = 1; // A token to retrieve next page of results. @@ -888,72 +1107,119 @@ message SearchExampleComparisonsResponse { // Request message for CreateEvaluationJob. message CreateEvaluationJobRequest { - // Required. Evaluation job resource parent, format: - // projects/{project_id}. - string parent = 1; + // Required. Evaluation job resource parent. Format: + // "projects/{project_id}" + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudresourcemanager.googleapis.com/Project" + } + ]; // Required. The evaluation job to create. - EvaluationJob job = 2; + EvaluationJob job = 2 [(google.api.field_behavior) = REQUIRED]; } // Request message for UpdateEvaluationJob. message UpdateEvaluationJobRequest { // Required. Evaluation job that is going to be updated. - EvaluationJob evaluation_job = 1; - - // Optional. Mask for which field in evaluation_job should be updated. - google.protobuf.FieldMask update_mask = 2; + EvaluationJob evaluation_job = 1 [(google.api.field_behavior) = REQUIRED]; + + // Optional. Mask for which fields to update. You can only provide the + // following fields: + // + // * `evaluationJobConfig.humanAnnotationConfig.instruction` + // * `evaluationJobConfig.exampleCount` + // * `evaluationJobConfig.exampleSamplePercentage` + // + // You can provide more than one of these fields by separating them with + // commas. + google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = OPTIONAL]; } // Request message for GetEvaluationJob. message GetEvaluationJobRequest { // Required. Name of the evaluation job. Format: - // 'projects/{project_id}/evaluationJobs/{evaluation_job_id}' - string name = 1; + // + // "projects/{project_id}/evaluationJobs/{evaluation_job_id}" + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/EvaluationJob" + } + ]; } // Request message for PauseEvaluationJob. message PauseEvaluationJobRequest { // Required. Name of the evaluation job that is going to be paused. Format: - // 'projects/{project_id}/evaluationJobs/{evaluation_job_id}' - string name = 1; + // + // "projects/{project_id}/evaluationJobs/{evaluation_job_id}" + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/EvaluationJob" + } + ]; } // Request message ResumeEvaluationJob. message ResumeEvaluationJobRequest { // Required. Name of the evaluation job that is going to be resumed. Format: - // 'projects/{project_id}/evaluationJobs/{evaluation_job_id}' - string name = 1; + // + // "projects/{project_id}/evaluationJobs/{evaluation_job_id}" + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/EvaluationJob" + } + ]; } // Request message DeleteEvaluationJob. message DeleteEvaluationJobRequest { // Required. Name of the evaluation job that is going to be deleted. Format: - // 'projects/{project_id}/evaluationJobs/{evaluation_job_id}' - string name = 1; + // + // "projects/{project_id}/evaluationJobs/{evaluation_job_id}" + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "datalabeling.googleapis.com/EvaluationJob" + } + ]; } // Request message for ListEvaluationJobs. message ListEvaluationJobsRequest { - // Required. Evaluation resource parent. Format: - // "projects/{project_id}" - string parent = 1; - - // Optional. Only support filter by model id and job state. Format: - // "evaluation_job.model_id = {model_id} AND evaluation_job.state = - // {EvaluationJob::State}" - string filter = 2; + // Required. Evaluation job resource parent. Format: + // "projects/{project_id}" + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudresourcemanager.googleapis.com/Project" + } + ]; + + // Optional. You can filter the jobs to list by model_id (also known as + // model_name, as described in + // [EvaluationJob.modelVersion][google.cloud.datalabeling.v1beta1.EvaluationJob.model_version]) or by + // evaluation job state (as described in [EvaluationJob.state][google.cloud.datalabeling.v1beta1.EvaluationJob.state]). To filter + // by both criteria, use the `AND` operator or the `OR` operator. For example, + // you can use the following string for your filter: + // "evaluation_job.model_id = {model_name} AND + // evaluation_job.state = {evaluation_job_state}" + string filter = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. Requested page size. Server may return fewer results than // requested. Default value is 100. - int32 page_size = 3; + int32 page_size = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. A token identifying a page of results for the server to return. - // Typically obtained by - // [ListEvaluationJobs.next_page_token][] of the previous - // [DataLabelingService.ListEvaluationJobs] call. - // Return first page if empty. - string page_token = 4; + // Typically obtained by the + // [nextPageToken][google.cloud.datalabeling.v1beta1.ListEvaluationJobsResponse.next_page_token] in the response + // to the previous request. The request returns the first page if this is + // empty. + string page_token = 4 [(google.api.field_behavior) = OPTIONAL]; } // Results for listing evaluation jobs. diff --git a/third_party/googleapis/google/cloud/datalabeling/v1beta1/datalabeling_gapic.legacy.yaml b/third_party/googleapis/google/cloud/datalabeling/v1beta1/datalabeling_gapic.legacy.yaml new file mode 100644 index 000000000..82caa70e0 --- /dev/null +++ b/third_party/googleapis/google/cloud/datalabeling/v1beta1/datalabeling_gapic.legacy.yaml @@ -0,0 +1,669 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 1.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.datalabeling.v1beta1 + python: + package_name: google.cloud.datalabeling_v1beta1.gapic + go: + package_name: cloud.google.com/go/datalabeling/apiv1beta1 + csharp: + package_name: Google.Cloud.Datalabeling.V1beta1 + ruby: + package_name: Google::Cloud::Datalabeling::V1beta1 + php: + package_name: Google\Cloud\Datalabeling\V1beta1 + nodejs: + package_name: datalabeling.v1beta1 +# The configuration for the license header to put on generated files. +license_header: + # The file containing the raw license header without any copyright line(s). + license_file: license-header-apache-2.0.txt +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.cloud.datalabeling.v1beta1.DataLabelingService + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: + - name_pattern: projects/{project} + entity_name: project + - name_pattern: projects/{project}/annotationSpecSets/{annotation_spec_set} + entity_name: annotation_spec_set + - name_pattern: projects/{project}/datasets/{dataset} + entity_name: dataset + - name_pattern: projects/{project}/datasets/{dataset}/annotatedDatasets/{annotated_dataset} + entity_name: annotated_dataset + - name_pattern: projects/{project}/datasets/{dataset}/annotatedDatasets/{annotated_dataset}/examples/{example} + entity_name: example + - name_pattern: projects/{project}/datasets/{dataset}/dataItems/{data_item} + entity_name: data_item + - name_pattern: projects/{project}/instructions/{instruction} + entity_name: instruction + - name_pattern: projects/{project}/datasets/{dataset}/evaluations/{evaluation} + entity_name: evaluation + - name_pattern: projects/{project}/evaluationJobs/{evaluation_job} + entity_name: evaluation_job + retry_codes_def: + - name: idempotent + retry_codes: + - DEADLINE_EXCEEDED + - UNAVAILABLE + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 30000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 300000 + # A list of method configurations. + # Common properties: + # + # name - The simple name of the method. + # + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce method + # overloads which allow a client to directly pass request message fields as + # method parameters. This information may or may not be used, depending on + # the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request message. + # + # required_fields - Fields that are always required for a request to be + # valid. + # + # resource_name_treatment - An enum that specifies how to treat the resource + # name formats defined in the field_name_patterns and + # response_field_name_patterns fields. + # UNSET: default value + # NONE: the collection configs will not be used by the generated code. + # VALIDATE: string fields will be validated by the client against the + # specified resource name formats. + # STATIC_TYPES: the client will use generated types for resource names. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a paging + # list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It defines + # which fields match the paging pattern in the request. The request consists + # of a page_size_field and a token_field. The page_size_field is the name of + # the optional field specifying the maximum number of elements to be + # returned in the response. The token_field is the name of the field in the + # request containing the page token. + # The response specifies response information of the list method. It defines + # which fields match the paging pattern in the response. The response + # consists of a token_field and a resources_field. The token_field is the + # name of the field in the response containing the next page token. The + # resources_field is the name of the field in the response containing the + # list of resources belonging to the page. + # + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: CreateDataset + flattening: + groups: + - parameters: + - parent + - dataset + required_fields: + - parent + - dataset + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: project + timeout_millis: 30000 + - name: GetDataset + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: dataset + timeout_millis: 30000 + - name: ListDatasets + flattening: + groups: + - parameters: + - parent + - filter + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: datasets + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: project + timeout_millis: 30000 + - name: DeleteDataset + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: dataset + timeout_millis: 30000 + - name: ImportData + flattening: + groups: + - parameters: + - name + - input_config + required_fields: + - name + - input_config + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: dataset + long_running: + return_type: google.cloud.datalabeling.v1beta1.ImportDataOperationResponse + metadata_type: google.cloud.datalabeling.v1beta1.ImportDataOperationMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + timeout_millis: 30000 + - name: ExportData + flattening: + groups: + - parameters: + - name + - annotated_dataset + - filter + - output_config + required_fields: + - name + - annotated_dataset + - output_config + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: dataset + long_running: + return_type: google.cloud.datalabeling.v1beta1.ExportDataOperationResponse + metadata_type: google.cloud.datalabeling.v1beta1.ExportDataOperationMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + timeout_millis: 30000 + - name: GetDataItem + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: data_item + timeout_millis: 30000 + - name: ListDataItems + flattening: + groups: + - parameters: + - parent + - filter + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: data_items + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: dataset + timeout_millis: 30000 + - name: GetAnnotatedDataset + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: annotated_dataset + timeout_millis: 30000 + - name: ListAnnotatedDatasets + flattening: + groups: + - parameters: + - parent + - filter + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: annotated_datasets + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: dataset + timeout_millis: 30000 + - name: LabelImage + flattening: + groups: + - parameters: + - parent + - basic_config + - feature + required_fields: + - parent + - basic_config + - feature + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: dataset + long_running: + return_type: google.cloud.datalabeling.v1beta1.AnnotatedDataset + metadata_type: google.cloud.datalabeling.v1beta1.LabelOperationMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + timeout_millis: 30000 + - name: LabelVideo + flattening: + groups: + - parameters: + - parent + - basic_config + - feature + required_fields: + - parent + - basic_config + - feature + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: dataset + long_running: + return_type: google.cloud.datalabeling.v1beta1.AnnotatedDataset + metadata_type: google.cloud.datalabeling.v1beta1.LabelOperationMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + timeout_millis: 30000 + - name: LabelText + flattening: + groups: + - parameters: + - parent + - basic_config + - feature + required_fields: + - parent + - basic_config + - feature + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: dataset + long_running: + return_type: google.cloud.datalabeling.v1beta1.AnnotatedDataset + metadata_type: google.cloud.datalabeling.v1beta1.LabelOperationMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + timeout_millis: 30000 + - name: GetExample + flattening: + groups: + - parameters: + - name + - filter + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: example + timeout_millis: 30000 + - name: ListExamples + flattening: + groups: + - parameters: + - parent + - filter + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: examples + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: annotated_dataset + timeout_millis: 30000 + - name: CreateAnnotationSpecSet + flattening: + groups: + - parameters: + - parent + - annotation_spec_set + required_fields: + - parent + - annotation_spec_set + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: project + timeout_millis: 30000 + - name: GetAnnotationSpecSet + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: annotation_spec_set + timeout_millis: 30000 + - name: ListAnnotationSpecSets + flattening: + groups: + - parameters: + - parent + - filter + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: annotation_spec_sets + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: project + timeout_millis: 30000 + - name: DeleteAnnotationSpecSet + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: annotation_spec_set + timeout_millis: 30000 + - name: CreateInstruction + flattening: + groups: + - parameters: + - parent + - instruction + required_fields: + - parent + - instruction + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: project + long_running: + return_type: google.cloud.datalabeling.v1beta1.Instruction + metadata_type: google.cloud.datalabeling.v1beta1.CreateInstructionMetadata + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + timeout_millis: 30000 + - name: GetInstruction + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: instruction + timeout_millis: 30000 + - name: ListInstructions + flattening: + groups: + - parameters: + - parent + - filter + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: instructions + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: project + timeout_millis: 30000 + - name: DeleteInstruction + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: instruction + timeout_millis: 30000 + - name: GetEvaluation + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: evaluation + timeout_millis: 60000 + - name: SearchEvaluations + flattening: + groups: + - parameters: + - parent + - filter + required_fields: + - parent + - filter + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: evaluations + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: project + timeout_millis: 60000 + - name: SearchExampleComparisons + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: example_comparisons + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: evaluation + timeout_millis: 60000 + - name: CreateEvaluationJob + flattening: + groups: + - parameters: + - parent + - job + required_fields: + - parent + - job + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: project + timeout_millis: 60000 + - name: UpdateEvaluationJob + flattening: + groups: + - parameters: + - evaluation_job + - update_mask + required_fields: + - evaluation_job + - update_mask + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + evaluation_job.name: evaluation_job + timeout_millis: 60000 + - name: GetEvaluationJob + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: evaluation_job + timeout_millis: 60000 + - name: PauseEvaluationJob + # params. + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: evaluation_job + timeout_millis: 60000 + - name: ResumeEvaluationJob + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: evaluation_job + timeout_millis: 60000 + - name: DeleteEvaluationJob + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: evaluation_job + timeout_millis: 60000 + - name: ListEvaluationJobs + flattening: + groups: + - parameters: + - parent + - filter + required_fields: + - parent + - filter + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: evaluation_jobs + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: project + timeout_millis: 60000 diff --git a/third_party/googleapis/google/cloud/datalabeling/v1beta1/datalabeling_gapic.yaml b/third_party/googleapis/google/cloud/datalabeling/v1beta1/datalabeling_gapic.yaml index 82caa70e0..0521c9536 100644 --- a/third_party/googleapis/google/cloud/datalabeling/v1beta1/datalabeling_gapic.yaml +++ b/third_party/googleapis/google/cloud/datalabeling/v1beta1/datalabeling_gapic.yaml @@ -1,5 +1,5 @@ type: com.google.api.codegen.ConfigProto -config_schema_version: 1.0.0 +config_schema_version: 2.0.0 # The settings of generated code in a specific language. language_settings: java: @@ -16,51 +16,8 @@ language_settings: package_name: Google\Cloud\Datalabeling\V1beta1 nodejs: package_name: datalabeling.v1beta1 -# The configuration for the license header to put on generated files. -license_header: - # The file containing the raw license header without any copyright line(s). - license_file: license-header-apache-2.0.txt -# A list of API interface configurations. interfaces: -# The fully qualified name of the API interface. - name: google.cloud.datalabeling.v1beta1.DataLabelingService - # A list of resource collection configurations. - # Consists of a name_pattern and an entity_name. - # The name_pattern is a pattern to describe the names of the resources of this - # collection, using the platform's conventions for URI patterns. A generator - # may use this to generate methods to compose and decompose such names. The - # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; - # those will be taken as hints for the parameter names of the generated - # methods. If empty, no name methods are generated. - # The entity_name is the name to be used as a basis for generated methods and - # classes. - collections: - - name_pattern: projects/{project} - entity_name: project - - name_pattern: projects/{project}/annotationSpecSets/{annotation_spec_set} - entity_name: annotation_spec_set - - name_pattern: projects/{project}/datasets/{dataset} - entity_name: dataset - - name_pattern: projects/{project}/datasets/{dataset}/annotatedDatasets/{annotated_dataset} - entity_name: annotated_dataset - - name_pattern: projects/{project}/datasets/{dataset}/annotatedDatasets/{annotated_dataset}/examples/{example} - entity_name: example - - name_pattern: projects/{project}/datasets/{dataset}/dataItems/{data_item} - entity_name: data_item - - name_pattern: projects/{project}/instructions/{instruction} - entity_name: instruction - - name_pattern: projects/{project}/datasets/{dataset}/evaluations/{evaluation} - entity_name: evaluation - - name_pattern: projects/{project}/evaluationJobs/{evaluation_job} - entity_name: evaluation_job - retry_codes_def: - - name: idempotent - retry_codes: - - DEADLINE_EXCEEDED - - UNAVAILABLE - - name: non_idempotent - retry_codes: [] - # Definition for retry/backoff parameters. retry_params_def: - name: default initial_retry_delay_millis: 100 @@ -70,600 +27,14 @@ interfaces: rpc_timeout_multiplier: 1 max_rpc_timeout_millis: 20000 total_timeout_millis: 300000 - # A list of method configurations. - # Common properties: - # - # name - The simple name of the method. - # - # flattening - Specifies the configuration for parameter flattening. - # Describes the parameter groups for which a generator should produce method - # overloads which allow a client to directly pass request message fields as - # method parameters. This information may or may not be used, depending on - # the target language. - # Consists of groups, which each represent a list of parameters to be - # flattened. Each parameter listed must be a field of the request message. - # - # required_fields - Fields that are always required for a request to be - # valid. - # - # resource_name_treatment - An enum that specifies how to treat the resource - # name formats defined in the field_name_patterns and - # response_field_name_patterns fields. - # UNSET: default value - # NONE: the collection configs will not be used by the generated code. - # VALIDATE: string fields will be validated by the client against the - # specified resource name formats. - # STATIC_TYPES: the client will use generated types for resource names. - # - # page_streaming - Specifies the configuration for paging. - # Describes information for generating a method which transforms a paging - # list RPC into a stream of resources. - # Consists of a request and a response. - # The request specifies request information of the list method. It defines - # which fields match the paging pattern in the request. The request consists - # of a page_size_field and a token_field. The page_size_field is the name of - # the optional field specifying the maximum number of elements to be - # returned in the response. The token_field is the name of the field in the - # request containing the page token. - # The response specifies response information of the list method. It defines - # which fields match the paging pattern in the response. The response - # consists of a token_field and a resources_field. The token_field is the - # name of the field in the response containing the next page token. The - # resources_field is the name of the field in the response containing the - # list of resources belonging to the page. - # - # retry_codes_name - Specifies the configuration for retryable codes. The - # name must be defined in interfaces.retry_codes_def. - # - # retry_params_name - Specifies the configuration for retry/backoff - # parameters. The name must be defined in interfaces.retry_params_def. - # - # field_name_patterns - Maps the field name of the request type to - # entity_name of interfaces.collections. - # Specifies the string pattern that the field must follow. - # - # timeout_millis - Specifies the default timeout for a non-retrying call. If - # the call is retrying, refer to retry_params_name instead. methods: - - name: CreateDataset - flattening: - groups: - - parameters: - - parent - - dataset - required_fields: - - parent - - dataset - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: project - timeout_millis: 30000 - - name: GetDataset - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: dataset - timeout_millis: 30000 - - name: ListDatasets - flattening: - groups: - - parameters: - - parent - - filter - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: datasets - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: project - timeout_millis: 30000 - name: DeleteDataset - flattening: - groups: - - parameters: - - name - required_fields: - - name retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: dataset - timeout_millis: 30000 - - name: ImportData - flattening: - groups: - - parameters: - - name - - input_config - required_fields: - - name - - input_config - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - name: dataset - long_running: - return_type: google.cloud.datalabeling.v1beta1.ImportDataOperationResponse - metadata_type: google.cloud.datalabeling.v1beta1.ImportDataOperationMetadata - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - timeout_millis: 30000 - name: ExportData - flattening: - groups: - - parameters: - - name - - annotated_dataset - - filter - - output_config - required_fields: - - name - - annotated_dataset - - output_config - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: dataset - long_running: - return_type: google.cloud.datalabeling.v1beta1.ExportDataOperationResponse - metadata_type: google.cloud.datalabeling.v1beta1.ExportDataOperationMetadata - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - timeout_millis: 30000 - - name: GetDataItem - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: data_item - timeout_millis: 30000 - - name: ListDataItems - flattening: - groups: - - parameters: - - parent - - filter - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: data_items - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: dataset - timeout_millis: 30000 - - name: GetAnnotatedDataset - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: annotated_dataset - timeout_millis: 30000 - - name: ListAnnotatedDatasets - flattening: - groups: - - parameters: - - parent - - filter - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: annotated_datasets - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: dataset - timeout_millis: 30000 - - name: LabelImage - flattening: - groups: - - parameters: - - parent - - basic_config - - feature - required_fields: - - parent - - basic_config - - feature - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: dataset - long_running: - return_type: google.cloud.datalabeling.v1beta1.AnnotatedDataset - metadata_type: google.cloud.datalabeling.v1beta1.LabelOperationMetadata - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - timeout_millis: 30000 - - name: LabelVideo - flattening: - groups: - - parameters: - - parent - - basic_config - - feature - required_fields: - - parent - - basic_config - - feature - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: dataset - long_running: - return_type: google.cloud.datalabeling.v1beta1.AnnotatedDataset - metadata_type: google.cloud.datalabeling.v1beta1.LabelOperationMetadata - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - timeout_millis: 30000 - - name: LabelText - flattening: - groups: - - parameters: - - parent - - basic_config - - feature - required_fields: - - parent - - basic_config - - feature - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: dataset - long_running: - return_type: google.cloud.datalabeling.v1beta1.AnnotatedDataset - metadata_type: google.cloud.datalabeling.v1beta1.LabelOperationMetadata - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - timeout_millis: 30000 - - name: GetExample - flattening: - groups: - - parameters: - - name - - filter - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: example - timeout_millis: 30000 - - name: ListExamples - flattening: - groups: - - parameters: - - parent - - filter - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: examples retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: annotated_dataset - timeout_millis: 30000 - - name: CreateAnnotationSpecSet - flattening: - groups: - - parameters: - - parent - - annotation_spec_set - required_fields: - - parent - - annotation_spec_set - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: project - timeout_millis: 30000 - - name: GetAnnotationSpecSet - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: annotation_spec_set - timeout_millis: 30000 - - name: ListAnnotationSpecSets - flattening: - groups: - - parameters: - - parent - - filter - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: annotation_spec_sets - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: project - timeout_millis: 30000 - name: DeleteAnnotationSpecSet - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: annotation_spec_set - timeout_millis: 30000 - - name: CreateInstruction - flattening: - groups: - - parameters: - - parent - - instruction - required_fields: - - parent - - instruction - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: project - long_running: - return_type: google.cloud.datalabeling.v1beta1.Instruction - metadata_type: google.cloud.datalabeling.v1beta1.CreateInstructionMetadata - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - timeout_millis: 30000 - - name: GetInstruction - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: instruction - timeout_millis: 30000 - - name: ListInstructions - flattening: - groups: - - parameters: - - parent - - filter - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: instructions retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: project - timeout_millis: 30000 - name: DeleteInstruction - flattening: - groups: - - parameters: - - name - required_fields: - - name retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: instruction - timeout_millis: 30000 - - name: GetEvaluation - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: evaluation - timeout_millis: 60000 - - name: SearchEvaluations - flattening: - groups: - - parameters: - - parent - - filter - required_fields: - - parent - - filter - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: evaluations - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: project - timeout_millis: 60000 - - name: SearchExampleComparisons - flattening: - groups: - - parameters: - - parent - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: example_comparisons - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: evaluation - timeout_millis: 60000 - - name: CreateEvaluationJob - flattening: - groups: - - parameters: - - parent - - job - required_fields: - - parent - - job - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: project - timeout_millis: 60000 - - name: UpdateEvaluationJob - flattening: - groups: - - parameters: - - evaluation_job - - update_mask - required_fields: - - evaluation_job - - update_mask - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - evaluation_job.name: evaluation_job - timeout_millis: 60000 - - name: GetEvaluationJob - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: evaluation_job - timeout_millis: 60000 - - name: PauseEvaluationJob - # params. - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - name: evaluation_job - timeout_millis: 60000 - - name: ResumeEvaluationJob - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - name: evaluation_job - timeout_millis: 60000 - name: DeleteEvaluationJob - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: evaluation_job - timeout_millis: 60000 - - name: ListEvaluationJobs - flattening: - groups: - - parameters: - - parent - - filter - required_fields: - - parent - - filter - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: evaluation_jobs retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: project - timeout_millis: 60000 diff --git a/third_party/googleapis/google/cloud/datalabeling/v1beta1/datalabeling_grpc_service_config.json b/third_party/googleapis/google/cloud/datalabeling/v1beta1/datalabeling_grpc_service_config.json new file mode 100755 index 000000000..a59fd83ac --- /dev/null +++ b/third_party/googleapis/google/cloud/datalabeling/v1beta1/datalabeling_grpc_service_config.json @@ -0,0 +1,155 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "CreateDataset" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "ImportData" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "LabelImage" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "LabelVideo" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "LabelText" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "CreateAnnotationSpecSet" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "CreateInstruction" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "SearchExampleComparisons" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "CreateEvaluationJob" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "UpdateEvaluationJob" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "PauseEvaluationJob" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "ResumeEvaluationJob" + } + ], + "timeout": "30s" + }, + { + "name": [ + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "GetDataset" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "ListDatasets" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "DeleteDataset" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "ExportData" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "GetDataItem" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "ListDataItems" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "GetAnnotatedDataset" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "ListAnnotatedDatasets" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "GetExample" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "ListExamples" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "GetAnnotationSpecSet" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "ListAnnotationSpecSets" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "DeleteAnnotationSpecSet" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "GetInstruction" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "ListInstructions" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "DeleteInstruction" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "GetEvaluation" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "SearchEvaluations" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "GetEvaluationJob" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "DeleteEvaluationJob" + }, + { + "service": "google.cloud.datalabeling.v1beta1.DataLabelingService", + "method": "ListEvaluationJobs" + } + ], + "timeout": "30s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "30s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/cloud/datalabeling/datalabeling_v1beta1.yaml b/third_party/googleapis/google/cloud/datalabeling/v1beta1/datalabeling_v1beta1.yaml similarity index 97% rename from third_party/googleapis/google/cloud/datalabeling/datalabeling_v1beta1.yaml rename to third_party/googleapis/google/cloud/datalabeling/v1beta1/datalabeling_v1beta1.yaml index 80f481c23..3814b2388 100644 --- a/third_party/googleapis/google/cloud/datalabeling/datalabeling_v1beta1.yaml +++ b/third_party/googleapis/google/cloud/datalabeling/v1beta1/datalabeling_v1beta1.yaml @@ -39,6 +39,9 @@ documentation: Sets the access control policy on the specified resource. Replaces any existing policy. + Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and + PERMISSION_DENIED + - selector: google.iam.v1.IAMPolicy.TestIamPermissions description: |- Returns permissions that a caller has on the specified resource. If the diff --git a/third_party/googleapis/google/cloud/datalabeling/v1beta1/dataset.proto b/third_party/googleapis/google/cloud/datalabeling/v1beta1/dataset.proto index 5289abcc9..a0bc9a433 100644 --- a/third_party/googleapis/google/cloud/datalabeling/v1beta1/dataset.proto +++ b/third_party/googleapis/google/cloud/datalabeling/v1beta1/dataset.proto @@ -18,7 +18,9 @@ syntax = "proto3"; package google.cloud.datalabeling.v1beta1; import "google/api/annotations.proto"; +import "google/api/resource.proto"; import "google/cloud/datalabeling/v1beta1/annotation.proto"; +import "google/cloud/datalabeling/v1beta1/annotation_spec_set.proto"; import "google/cloud/datalabeling/v1beta1/data_payloads.proto"; import "google/cloud/datalabeling/v1beta1/human_annotation_config.proto"; import "google/protobuf/timestamp.proto"; @@ -30,18 +32,26 @@ option java_package = "com.google.cloud.datalabeling.v1beta1"; enum DataType { DATA_TYPE_UNSPECIFIED = 0; + // Allowed for continuous evaluation. IMAGE = 1; VIDEO = 2; + // Allowed for continuous evaluation. TEXT = 4; + // Allowed for continuous evaluation. GENERAL_DATA = 6; } // Dataset is the resource to hold your data. You can request multiple labeling // tasks for a dataset while each one will generate an AnnotatedDataset. message Dataset { + option (google.api.resource) = { + type: "datalabeling.googleapis.com/Dataset" + pattern: "projects/{project}/datasets/{dataset}" + }; + // Output only. Dataset resource name, format is: // projects/{project_id}/datasets/{dataset_id} string name = 1; @@ -82,20 +92,22 @@ message InputConfig { // Source located in Cloud Storage. GcsSource gcs_source = 2; + // Source located in BigQuery. You must specify this field if you are using + // this InputConfig in an [EvaluationJob][google.cloud.datalabeling.v1beta1.EvaluationJob]. BigQuerySource bigquery_source = 5; } // Required. Data type must be specifed when user tries to import data. DataType data_type = 1; - // Optional. If input contains annotation, user needs to specify the - // type and metadata of the annotation when creating it as an annotated - // dataset. + // Optional. The type of annotation to be performed on this data. You must + // specify this field if you are using this InputConfig in an + // [EvaluationJob][google.cloud.datalabeling.v1beta1.EvaluationJob]. AnnotationType annotation_type = 3; - // Optional. Metadata about annotations in the input. Each annotation type may - // have different metadata. - // Metadata for classification problem. + // Optional. Metadata about annotations for the input. You must specify this + // field if you are using this InputConfig in an [EvaluationJob][google.cloud.datalabeling.v1beta1.EvaluationJob] for a + // model version that performs classification. ClassificationMetadata classification_metadata = 4; } @@ -123,10 +135,24 @@ message GcsSource { string mime_type = 2; } -// The BigQuery location for the input content. +// The BigQuery location for input data. If used in an [EvaluationJob][google.cloud.datalabeling.v1beta1.EvaluationJob], this +// is where the service saves the prediction input and output sampled from the +// model version. message BigQuerySource { - // Required. BigQuery URI to a table, up to 2000 characters long. - // Accepted forms: BigQuery gs path e.g. bq://projectId.bqDatasetId.bqTableId + // Required. BigQuery URI to a table, up to 2,000 characters long. If you + // specify the URI of a table that does not exist, Data Labeling Service + // creates a table at the URI with the correct schema when you create your + // [EvaluationJob][google.cloud.datalabeling.v1beta1.EvaluationJob]. If you specify the URI of a table that already exists, + // it must have the + // [correct + // schema](/ml-engine/docs/continuous-evaluation/create-job#table-schema). + // + // Provide the table URI in the following format: + // + // "bq://{your_project_id}/{your_dataset_name}/{your_table_name}" + // + // [Learn + // more](/ml-engine/docs/continuous-evaluation/create-job#table-schema). string input_uri = 1; } @@ -135,7 +161,7 @@ message OutputConfig { // Required. Location to output data to. oneof destination { // Output to a file in Cloud Storage. Should be used for labeling output - // other thanimage segmentation. + // other than image segmentation. GcsDestination gcs_destination = 1; // Output to a folder in Cloud Storage. Should be used for image @@ -164,6 +190,11 @@ message GcsFolderDestination { // DataItem is a piece of data, without annotation. For example, an image. message DataItem { + option (google.api.resource) = { + type: "datalabeling.googleapis.com/DataItem" + pattern: "projects/{project}/datasets/{dataset}/dataItems/{data_item}" + }; + // Output only. oneof payload { // The image payload, a container of the image bytes/uri. @@ -185,6 +216,11 @@ message DataItem { // labeling task will generate an AnnotatedDataset under the Dataset that the // task is requested for. message AnnotatedDataset { + option (google.api.resource) = { + type: "datalabeling.googleapis.com/AnnotatedDataset" + pattern: "projects/{project}/datasets/{dataset}/annotatedDatasets/{annotated_dataset}" + }; + // Output only. AnnotatedDataset resource name in format of: // projects/{project_id}/datasets/{dataset_id}/annotatedDatasets/ // {annotated_dataset_id} @@ -281,6 +317,11 @@ message AnnotatedDatasetMetadata { // An Example is a piece of data and its annotation. For example, an image with // label "house". message Example { + option (google.api.resource) = { + type: "datalabeling.googleapis.com/Example" + pattern: "projects/{project}/datasets/{dataset}/annotatedDatasets/{annotated_dataset}/examples/{example}" + }; + // Output only. The data part of Example. oneof payload { // The image payload, a container of the image bytes/uri. diff --git a/third_party/googleapis/google/cloud/datalabeling/v1beta1/evaluation.proto b/third_party/googleapis/google/cloud/datalabeling/v1beta1/evaluation.proto index ad1e975a3..fde0366d3 100644 --- a/third_party/googleapis/google/cloud/datalabeling/v1beta1/evaluation.proto +++ b/third_party/googleapis/google/cloud/datalabeling/v1beta1/evaluation.proto @@ -18,6 +18,7 @@ syntax = "proto3"; package google.cloud.datalabeling.v1beta1; import "google/api/annotations.proto"; +import "google/api/resource.proto"; import "google/cloud/datalabeling/v1beta1/annotation.proto"; import "google/cloud/datalabeling/v1beta1/annotation_spec_set.proto"; import "google/protobuf/timestamp.proto"; @@ -26,51 +27,72 @@ option go_package = "google.golang.org/genproto/googleapis/cloud/datalabeling/v1 option java_multiple_files = true; option java_package = "com.google.cloud.datalabeling.v1beta1"; -// Describes an evaluation between 2 annotated datasets. Created by an -// evaluation plan. +// Describes an evaluation between a machine learning model's predictions and +// ground truth labels. Created when an [EvaluationJob][google.cloud.datalabeling.v1beta1.EvaluationJob] runs successfully. message Evaluation { - // Resource name of an evaluation. - // Format: - // 'projects/{project_id}/datasets/{dataset_id}/evaluations/{evaluation_id}' + option (google.api.resource) = { + type: "datalabeling.googleapis.com/Evaluation" + pattern: "projects/{project}/datasets/{dataset}/evaluations/{evaluation}" + }; + + // Output only. Resource name of an evaluation. The name has the following + // format: + // + // "projects/{project_id}/datasets/{dataset_id}/evaluations/{evaluation_id}' string name = 1; - // Options used in evaluation plan for creating the evaluation. + // Output only. Options used in the evaluation job that created this + // evaluation. EvaluationConfig config = 2; - // Output only. Timestamp when the evaluation plan triggered this evaluation - // flow. + // Output only. Timestamp for when the evaluation job that created this + // evaluation ran. google.protobuf.Timestamp evaluation_job_run_time = 3; - // Output only. Timestamp when this model evaluation was created. + // Output only. Timestamp for when this evaluation was created. google.protobuf.Timestamp create_time = 4; - // Output only. Metrics of the evaluation. + // Output only. Metrics comparing predictions to ground truth labels. EvaluationMetrics evaluation_metrics = 5; - // Type of the annotation to compute metrics for in the groundtruth and - // annotation labeled dataset. Required for creation. + // Output only. Type of task that the model version being evaluated performs, + // as defined in the + // + // [evaluationJobConfig.inputConfig.annotationType][google.cloud.datalabeling.v1beta1.EvaluationJobConfig.input_config] + // field of the evaluation job that created this evaluation. AnnotationType annotation_type = 6; - // Output only. Count of items in groundtruth dataset included in this - // evaluation. Will be unset if annotation type is not applicable. + // Output only. The number of items in the ground truth dataset that were used + // for this evaluation. Only populated when the evaulation is for certain + // AnnotationTypes. int64 evaluated_item_count = 7; } +// Configuration details used for calculating evaluation metrics and creating an +// [Evaluation][google.cloud.datalabeling.v1beta1.Evaluation]. message EvaluationConfig { // Vertical specific options for general metrics. oneof vertical_option { + // Only specify this field if the related model performs image object + // detection (`IMAGE_BOUNDING_BOX_ANNOTATION`). Describes how to evaluate + // bounding boxes. BoundingBoxEvaluationOptions bounding_box_evaluation_options = 1; } } // Options regarding evaluation between bounding boxes. message BoundingBoxEvaluationOptions { - // Minimize IoU required to consider 2 bounding boxes are matched. + // Minimum + // [intersection-over-union + // + // (IOU)](/vision/automl/object-detection/docs/evaluate#intersection-over-union) + // required for 2 bounding boxes to be considered a match. This must be a + // number between 0 and 1. float iou_threshold = 1; } message EvaluationMetrics { - // Common metrics covering most genernal cases. + // Common metrics covering most general cases. oneof metrics { ClassificationMetrics classification_metrics = 1; @@ -78,13 +100,17 @@ message EvaluationMetrics { } } +// Metrics calculated for a classification model. message ClassificationMetrics { - // Precision-recall curve. + // Precision-recall curve based on ground truth labels, predicted labels, and + // scores for the predicted labels. PrCurve pr_curve = 1; + // Confusion matrix of predicted labels vs. ground truth labels. ConfusionMatrix confusion_matrix = 2; } +// Metrics calculated for an image object detection (bounding box) model. message ObjectDetectionMetrics { // Precision-recall curve. PrCurve pr_curve = 1; @@ -92,8 +118,18 @@ message ObjectDetectionMetrics { message PrCurve { message ConfidenceMetricsEntry { - // Threshold used for this entry, for example, IoU threshold for bounding - // box problem, or detection threshold for classification. + // Threshold used for this entry. + // + // For classification tasks, this is a classification threshold: a + // predicted label is categorized as positive or negative (in the context of + // this point on the PR curve) based on whether the label's score meets this + // threshold. + // + // For image object detection (bounding box) tasks, this is the + // [intersection-over-union + // + // (IOU)](/vision/automl/object-detection/docs/evaluate#intersection-over-union) + // threshold for the context of this point on the PR curve. float confidence_threshold = 1; // Recall value. @@ -111,10 +147,7 @@ message PrCurve { // Precision value for entries with label that has highest score. float precision_at1 = 6; - // The harmonic mean of - // [recall_at1][google.cloud.datalabeling.v1beta1.PrCurve.ConfidenceMetricsEntry.recall_at1] - // and - // [precision_at1][google.cloud.datalabeling.v1beta1.PrCurve.ConfidenceMetricsEntry.precision_at1]. + // The harmonic mean of [recall_at1][google.cloud.datalabeling.v1beta1.PrCurve.ConfidenceMetricsEntry.recall_at1] and [precision_at1][google.cloud.datalabeling.v1beta1.PrCurve.ConfidenceMetricsEntry.precision_at1]. float f1_score_at1 = 7; // Recall value for entries with label that has highest 5 scores. @@ -123,43 +156,48 @@ message PrCurve { // Precision value for entries with label that has highest 5 scores. float precision_at5 = 9; - // The harmonic mean of - // [recall_at5][google.cloud.datalabeling.v1beta1.PrCurve.ConfidenceMetricsEntry.recall_at5] - // and - // [precision_at5][google.cloud.datalabeling.v1beta1.PrCurve.ConfidenceMetricsEntry.precision_at5]. + // The harmonic mean of [recall_at5][google.cloud.datalabeling.v1beta1.PrCurve.ConfidenceMetricsEntry.recall_at5] and [precision_at5][google.cloud.datalabeling.v1beta1.PrCurve.ConfidenceMetricsEntry.precision_at5]. float f1_score_at5 = 10; } - // PR curve against which annotation spec. Could be empty. + // The annotation spec of the label for which the precision-recall curve + // calculated. If this field is empty, that means the precision-recall curve + // is an aggregate curve for all labels. AnnotationSpec annotation_spec = 1; - // Area under precision recall curve. + // Area under the precision-recall curve. Not to be confused with area under + // a receiver operating characteristic (ROC) curve. float area_under_curve = 2; - // entries to draw PR graph. + // Entries that make up the precision-recall graph. Each entry is a "point" on + // the graph drawn for a different `confidence_threshold`. repeated ConfidenceMetricsEntry confidence_metrics_entries = 3; - // mean average prcision of this curve. + // Mean average prcision of this curve. float mean_average_precision = 4; } -// Confusion matrix of the model running the classification. Not applicable -// when label filtering is specified in evaluation option. +// Confusion matrix of the model running the classification. Only applicable +// when the metrics entry aggregates multiple labels. Not applicable when the +// entry is for a single label. message ConfusionMatrix { message ConfusionMatrixEntry { - // The predicted annotation spec. + // The annotation spec of a predicted label. AnnotationSpec annotation_spec = 1; - // Number of items being predicted as this label. + // Number of items predicted to have this label. (The ground truth label for + // these items is the `Row.annotationSpec` of this entry's parent.) int32 item_count = 2; } - // A row in the confusion matrix. + // A row in the confusion matrix. Each entry in this row has the same + // ground truth label. message Row { - // the original annotation spec of this row. + // The annotation spec of the ground truth label for this row. AnnotationSpec annotation_spec = 1; - // Info describing predicted label distribution. + // A list of the confusion matrix entries. One entry for each possible + // predicted label. repeated ConfusionMatrixEntry entries = 2; } diff --git a/third_party/googleapis/google/cloud/datalabeling/v1beta1/evaluation_job.proto b/third_party/googleapis/google/cloud/datalabeling/v1beta1/evaluation_job.proto index ad6424643..49270feea 100644 --- a/third_party/googleapis/google/cloud/datalabeling/v1beta1/evaluation_job.proto +++ b/third_party/googleapis/google/cloud/datalabeling/v1beta1/evaluation_job.proto @@ -18,6 +18,7 @@ syntax = "proto3"; package google.cloud.datalabeling.v1beta1; import "google/api/annotations.proto"; +import "google/api/resource.proto"; import "google/cloud/datalabeling/v1beta1/dataset.proto"; import "google/cloud/datalabeling/v1beta1/evaluation.proto"; import "google/cloud/datalabeling/v1beta1/human_annotation_config.proto"; @@ -28,124 +29,244 @@ option go_package = "google.golang.org/genproto/googleapis/cloud/datalabeling/v1 option java_multiple_files = true; option java_package = "com.google.cloud.datalabeling.v1beta1"; -// Defines an evaluation job that is triggered periodically to generate -// evaluations. +// Defines an evaluation job that runs periodically to generate +// [Evaluations][google.cloud.datalabeling.v1beta1.Evaluation]. [Creating an evaluation +// job](/ml-engine/docs/continuous-evaluation/create-job) is the starting point +// for using continuous evaluation. message EvaluationJob { + option (google.api.resource) = { + type: "datalabeling.googleapis.com/EvaluationJob" + pattern: "projects/{project}/evaluationJobs/{evaluation_job}" + }; + // State of the job. enum State { STATE_UNSPECIFIED = 0; + // The job is scheduled to run at the [configured interval][google.cloud.datalabeling.v1beta1.EvaluationJob.schedule]. You + // can [pause][google.cloud.datalabeling.v1beta1.DataLabelingService.PauseEvaluationJob] or + // [delete][google.cloud.datalabeling.v1beta1.DataLabelingService.DeleteEvaluationJob] the job. + // + // When the job is in this state, it samples prediction input and output + // from your model version into your BigQuery table as predictions occur. SCHEDULED = 1; + // The job is currently running. When the job runs, Data Labeling Service + // does several things: + // + // 1. If you have configured your job to use Data Labeling Service for + // ground truth labeling, the service creates a + // [Dataset][google.cloud.datalabeling.v1beta1.Dataset] and a labeling task for all data sampled + // since the last time the job ran. Human labelers provide ground truth + // labels for your data. Human labeling may take hours, or even days, + // depending on how much data has been sampled. The job remains in the + // `RUNNING` state during this time, and it can even be running multiple + // times in parallel if it gets triggered again (for example 24 hours + // later) before the earlier run has completed. When human labelers have + // finished labeling the data, the next step occurs. + //

          + // If you have configured your job to provide your own ground truth + // labels, Data Labeling Service still creates a [Dataset][google.cloud.datalabeling.v1beta1.Dataset] for newly + // sampled data, but it expects that you have already added ground truth + // labels to the BigQuery table by this time. The next step occurs + // immediately. + // + // 2. Data Labeling Service creates an [Evaluation][google.cloud.datalabeling.v1beta1.Evaluation] by comparing your + // model version's predictions with the ground truth labels. + // + // If the job remains in this state for a long time, it continues to sample + // prediction data into your BigQuery table and will run again at the next + // interval, even if it causes the job to run multiple times in parallel. RUNNING = 2; + // The job is not sampling prediction input and output into your BigQuery + // table and it will not run according to its schedule. You can + // [resume][google.cloud.datalabeling.v1beta1.DataLabelingService.ResumeEvaluationJob] the job. PAUSED = 3; + // The job has this state right before it is deleted. STOPPED = 4; } - // Format: 'projects/{project_id}/evaluationJobs/{evaluation_job_id}' + // Output only. After you create a job, Data Labeling Service assigns a name + // to the job with the following format: + // + // "projects/{project_id}/evaluationJobs/{evaluation_job_id}" string name = 1; - // Description of the job. The description can be up to - // 25000 characters long. + // Required. Description of the job. The description can be up to 25,000 + // characters long. string description = 2; + // Output only. Describes the current state of the job. State state = 3; - // Describes the schedule on which the job will be executed. Minimum schedule - // unit is 1 day. + // Required. Describes the interval at which the job runs. This interval must + // be at least 1 day, and it is rounded to the nearest day. For example, if + // you specify a 50-hour interval, the job runs every 2 days. // - // The schedule can be either of the following types: - // * [Crontab](http://en.wikipedia.org/wiki/Cron#Overview) - // * English-like + // You can provide the schedule in + // [crontab format](/scheduler/docs/configuring/cron-job-schedules) or in an + // [English-like + // format](/appengine/docs/standard/python/config/cronref#schedule_format). // - // [schedule](https: - // //cloud.google.com/scheduler/docs/configuring/cron-job-schedules) + // Regardless of what you specify, the job will run at 10:00 AM UTC. Only the + // interval from this schedule is used, not the specific time of day. string schedule = 4; - // The versioned model that is being evaluated here. - // Only one job is allowed for each model name. - // Format: 'projects/*/models/*/versions/*' + // Required. The [AI Platform Prediction model + // version](/ml-engine/docs/prediction-overview) to be evaluated. Prediction + // input and output is sampled from this model version. When creating an + // evaluation job, specify the model version in the following format: + // + // "projects/{project_id}/models/{model_name}/versions/{version_name}" + // + // There can only be one evaluation job per model version. string model_version = 5; - // Detailed config for running this eval job. + // Required. Configuration details for the evaluation job. EvaluationJobConfig evaluation_job_config = 6; - // Name of the AnnotationSpecSet. + // Required. Name of the [AnnotationSpecSet][google.cloud.datalabeling.v1beta1.AnnotationSpecSet] describing all the + // labels that your machine learning model outputs. You must create this + // resource before you create an evaluation job and provide its name in the + // following format: + // + // "projects/{project_id}/annotationSpecSets/{annotation_spec_set_id}" string annotation_spec_set = 7; - // If a human annotation should be requested when some data don't have ground - // truth. + // Required. Whether you want Data Labeling Service to provide ground truth + // labels for prediction input. If you want the service to assign human + // labelers to annotate your data, set this to `true`. If you want to provide + // your own ground truth labels in the evaluation job's BigQuery table, set + // this to `false`. bool label_missing_ground_truth = 8; - // Output only. Any attempts with errors happening in evaluation job runs each - // time will be recorded here incrementally. + // Output only. Every time the evaluation job runs and an error occurs, the + // failed attempt is appended to this array. repeated Attempt attempts = 9; - // Timestamp when this evaluation job was created. + // Output only. Timestamp of when this evaluation job was created. google.protobuf.Timestamp create_time = 10; } +// Configures specific details of how a continuous evaluation job works. Provide +// this configuration when you create an EvaluationJob. message EvaluationJobConfig { - // config specific to different supported human annotation use cases. + // Required. Details for how you want human reviewers to provide ground truth + // labels. oneof human_annotation_request_config { + // Specify this field if your model version performs image classification or + // general classification. + // + // `annotationSpecSet` in this configuration must match + // [EvaluationJob.annotationSpecSet][google.cloud.datalabeling.v1beta1.EvaluationJob.annotation_spec_set]. + // `allowMultiLabel` in this configuration must match + // `classificationMetadata.isMultiLabel` in [input_config][google.cloud.datalabeling.v1beta1.EvaluationJobConfig.input_config]. ImageClassificationConfig image_classification_config = 4; + // Specify this field if your model version performs image object detection + // (bounding box detection). + // + // `annotationSpecSet` in this configuration must match + // [EvaluationJob.annotationSpecSet][google.cloud.datalabeling.v1beta1.EvaluationJob.annotation_spec_set]. BoundingPolyConfig bounding_poly_config = 5; - VideoClassificationConfig video_classification_config = 6; - - ObjectDetectionConfig object_detection_config = 7; - + // Specify this field if your model version performs text classification. + // + // `annotationSpecSet` in this configuration must match + // [EvaluationJob.annotationSpecSet][google.cloud.datalabeling.v1beta1.EvaluationJob.annotation_spec_set]. + // `allowMultiLabel` in this configuration must match + // `classificationMetadata.isMultiLabel` in [input_config][google.cloud.datalabeling.v1beta1.EvaluationJobConfig.input_config]. TextClassificationConfig text_classification_config = 8; - - ObjectTrackingConfig object_tracking_config = 12; } - // Input config for data, gcs_source in the config will be the root path for - // data. Data should be organzied chronically under that path. + // Rquired. Details for the sampled prediction input. Within this + // configuration, there are requirements for several fields: + // + // * `dataType` must be one of `IMAGE`, `TEXT`, or `GENERAL_DATA`. + // * `annotationType` must be one of `IMAGE_CLASSIFICATION_ANNOTATION`, + // `TEXT_CLASSIFICATION_ANNOTATION`, `GENERAL_CLASSIFICATION_ANNOTATION`, + // or `IMAGE_BOUNDING_BOX_ANNOTATION` (image object detection). + // * If your machine learning model performs classification, you must specify + // `classificationMetadata.isMultiLabel`. + // * You must specify `bigquerySource` (not `gcsSource`). InputConfig input_config = 1; - // Config used to create evaluation. + // Required. Details for calculating evaluation metrics and creating + // [Evaulations][google.cloud.datalabeling.v1beta1.Evaluation]. If your model version performs image object + // detection, you must specify the `boundingBoxEvaluationOptions` field within + // this configuration. Otherwise, provide an empty object for this + // configuration. EvaluationConfig evaluation_config = 2; + // Optional. Details for human annotation of your data. If you set + // [labelMissingGroundTruth][google.cloud.datalabeling.v1beta1.EvaluationJob.label_missing_ground_truth] to + // `true` for this evaluation job, then you must specify this field. If you + // plan to provide your own ground truth labels, then omit this field. + // + // Note that you must create an [Instruction][google.cloud.datalabeling.v1beta1.Instruction] resource before you can + // specify this field. Provide the name of the instruction resource in the + // `instruction` field within this configuration. HumanAnnotationConfig human_annotation_config = 3; - // Mappings between reserved keys for bigquery import and customized tensor - // names. Key is the reserved key, value is tensor name in the bigquery table. - // Different annotation type has different required key mapping. See user - // manual for more details: + // Required. Prediction keys that tell Data Labeling Service where to find the + // data for evaluation in your BigQuery table. When the service samples + // prediction input and output from your model version and saves it to + // BigQuery, the data gets stored as JSON strings in the BigQuery table. These + // keys tell Data Labeling Service how to parse the JSON. + // + // You can provide the following entries in this field: + // + // * `data_json_key`: the data key for prediction input. You must provide + // either this key or `reference_json_key`. + // * `reference_json_key`: the data reference key for prediction input. You + // must provide either this key or `data_json_key`. + // * `label_json_key`: the label key for prediction output. Required. + // * `label_score_json_key`: the score key for prediction output. Required. + // * `bounding_box_json_key`: the bounding box key for prediction output. + // Required if your model version perform image object detection. // - // https: - // //docs.google.com/document/d/1bg1meMIBGY - // // 9I5QEoFoHSX6u9LsZQYBSmPt6E9SxqHZc/edit#heading=h.tfyjhxhvsqem + // Learn [how to configure prediction + // keys](/ml-engine/docs/continuous-evaluation/create-job#prediction-keys). map bigquery_import_keys = 9; - // Max number of examples to collect in each period. + // Required. The maximum number of predictions to sample and save to BigQuery + // during each [evaluation interval][google.cloud.datalabeling.v1beta1.EvaluationJob.schedule]. This limit + // overrides `example_sample_percentage`: even if the service has not sampled + // enough predictions to fulfill `example_sample_perecentage` during an + // interval, it stops sampling predictions when it meets this limit. int32 example_count = 10; - // Percentage of examples to collect in each period. 0.1 means 10% of total - // examples will be collected, and 0.0 means no collection. + // Required. Fraction of predictions to sample and save to BigQuery during + // each [evaluation interval][google.cloud.datalabeling.v1beta1.EvaluationJob.schedule]. For example, 0.1 means + // 10% of predictions served by your model version get saved to BigQuery. double example_sample_percentage = 11; - // Alert config for the evaluation job. The alert will be triggered when its - // criteria is met. + // Optional. Configuration details for evaluation job alerts. Specify this + // field if you want to receive email alerts if the evaluation job finds that + // your predictions have low mean average precision during a run. EvaluationJobAlertConfig evaluation_job_alert_config = 13; } +// Provides details for how an evaluation job sends email alerts based on the +// results of a run. message EvaluationJobAlertConfig { - // Required. Email of the user who will be receiving the alert. + // Required. An email address to send alerts to. string email = 1; - // If a single evaluation run's aggregate mean average precision is - // lower than this threshold, the alert will be triggered. + // Required. A number between 0 and 1 that describes a minimum mean average + // precision threshold. When the evaluation job runs, if it calculates that + // your model version's predictions from the recent interval have + // [meanAveragePrecision][google.cloud.datalabeling.v1beta1.PrCurve.mean_average_precision] below this + // threshold, then it sends an alert to your specified email. double min_acceptable_mean_average_precision = 2; } -// Records a failed attempt. +// Records a failed evaluation job run. message Attempt { google.protobuf.Timestamp attempt_time = 1; + // Details of errors that occurred. repeated google.rpc.Status partial_failures = 2; } diff --git a/third_party/googleapis/google/cloud/datalabeling/v1beta1/human_annotation_config.proto b/third_party/googleapis/google/cloud/datalabeling/v1beta1/human_annotation_config.proto index d392aca70..5658bb9b8 100644 --- a/third_party/googleapis/google/cloud/datalabeling/v1beta1/human_annotation_config.proto +++ b/third_party/googleapis/google/cloud/datalabeling/v1beta1/human_annotation_config.proto @@ -18,6 +18,7 @@ syntax = "proto3"; package google.cloud.datalabeling.v1beta1; import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; import "google/protobuf/duration.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/datalabeling/v1beta1;datalabeling"; @@ -39,45 +40,45 @@ enum StringAggregationType { // Configuration for how human labeling task should be done. message HumanAnnotationConfig { - // Required except for LabelAudio case. Instruction resource name. - string instruction = 1; + // Required. Instruction resource name. + string instruction = 1 [(google.api.field_behavior) = REQUIRED]; // Required. A human-readable name for AnnotatedDataset defined by // users. Maximum of 64 characters // . - string annotated_dataset_display_name = 2; + string annotated_dataset_display_name = 2 [(google.api.field_behavior) = REQUIRED]; // Optional. A human-readable description for AnnotatedDataset. // The description can be up to 10000 characters long. - string annotated_dataset_description = 3; + string annotated_dataset_description = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. A human-readable label used to logically group labeling tasks. // This string must match the regular expression `[a-zA-Z\\d_-]{0,128}`. - string label_group = 4; + string label_group = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. The Language of this question, as a // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). // Default value is en-US. // Only need to set this when task is language related. For example, French - // text classification or Chinese audio transcription. - string language_code = 5; + // text classification. + string language_code = 5 [(google.api.field_behavior) = OPTIONAL]; // Optional. Replication of questions. Each question will be sent to up to // this number of contributors to label. Aggregated answers will be returned. // Default is set to 1. // For image related labeling, valid values are 1, 3, 5. - int32 replica_count = 6; + int32 replica_count = 6 [(google.api.field_behavior) = OPTIONAL]; - // Optional. Maximum duration for contributors to answer a question. Default - // is 1800 seconds. - google.protobuf.Duration question_duration = 7; + // Optional. Maximum duration for contributors to answer a question. Maximum + // is 3600 seconds. Default is 3600 seconds. + google.protobuf.Duration question_duration = 7 [(google.api.field_behavior) = OPTIONAL]; // Optional. If you want your own labeling contributors to manage and work on // this labeling request, you can set these contributors here. We will give // them access to the question types in crowdcompute. Note that these // emails must be registered in crowdcompute worker UI: // https://crowd-compute.appspot.com/ - repeated string contributor_emails = 9; + repeated string contributor_emails = 9 [(google.api.field_behavior) = OPTIONAL]; // Email of the user who started the labeling task and should be notified by // email. If empty no notification will be sent. @@ -87,39 +88,39 @@ message HumanAnnotationConfig { // Config for image classification human labeling task. message ImageClassificationConfig { // Required. Annotation spec set resource name. - string annotation_spec_set = 1; + string annotation_spec_set = 1 [(google.api.field_behavior) = REQUIRED]; // Optional. If allow_multi_label is true, contributors are able to choose // multiple labels for one image. - bool allow_multi_label = 2; + bool allow_multi_label = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. The type of how to aggregate answers. - StringAggregationType answer_aggregation_type = 3; + StringAggregationType answer_aggregation_type = 3 [(google.api.field_behavior) = OPTIONAL]; } // Config for image bounding poly (and bounding box) human labeling task. message BoundingPolyConfig { // Required. Annotation spec set resource name. - string annotation_spec_set = 1; + string annotation_spec_set = 1 [(google.api.field_behavior) = REQUIRED]; // Optional. Instruction message showed on contributors UI. - string instruction_message = 2; + string instruction_message = 2 [(google.api.field_behavior) = OPTIONAL]; } // Config for image polyline human labeling task. message PolylineConfig { // Required. Annotation spec set resource name. - string annotation_spec_set = 1; + string annotation_spec_set = 1 [(google.api.field_behavior) = REQUIRED]; // Optional. Instruction message showed on contributors UI. - string instruction_message = 2; + string instruction_message = 2 [(google.api.field_behavior) = OPTIONAL]; } // Config for image segmentation message SegmentationConfig { // Required. Annotation spec set resource name. format: // projects/{project_id}/annotationSpecSets/{annotation_spec_set_id} - string annotation_spec_set = 1; + string annotation_spec_set = 1 [(google.api.field_behavior) = REQUIRED]; // Instruction message showed on labelers UI. string instruction_message = 2; @@ -134,11 +135,11 @@ message VideoClassificationConfig { // Annotation spec set with the setting of allowing multi labels or not. message AnnotationSpecSetConfig { // Required. Annotation spec set resource name. - string annotation_spec_set = 1; + string annotation_spec_set = 1 [(google.api.field_behavior) = REQUIRED]; // Optional. If allow_multi_label is true, contributors are able to // choose multiple labels from one annotation spec set. - bool allow_multi_label = 2; + bool allow_multi_label = 2 [(google.api.field_behavior) = OPTIONAL]; } // Required. The list of annotation spec set configs. @@ -147,10 +148,10 @@ message VideoClassificationConfig { // in each AnnotationSpecSet will be shown in a group to contributors. // Contributors can select one or more (depending on whether to allow multi // label) from each group. - repeated AnnotationSpecSetConfig annotation_spec_set_configs = 1; + repeated AnnotationSpecSetConfig annotation_spec_set_configs = 1 [(google.api.field_behavior) = REQUIRED]; // Optional. Option to apply shot detection on the video. - bool apply_shot_detection = 2; + bool apply_shot_detection = 2 [(google.api.field_behavior) = OPTIONAL]; } // Config for video object detection human labeling task. @@ -160,16 +161,16 @@ message VideoClassificationConfig { // extraction frame rate. message ObjectDetectionConfig { // Required. Annotation spec set resource name. - string annotation_spec_set = 1; + string annotation_spec_set = 1 [(google.api.field_behavior) = REQUIRED]; // Required. Number of frames per second to be extracted from the video. - double extraction_frame_rate = 3; + double extraction_frame_rate = 3 [(google.api.field_behavior) = REQUIRED]; } // Config for video object tracking human labeling task. message ObjectTrackingConfig { // Required. Annotation spec set resource name. - string annotation_spec_set = 1; + string annotation_spec_set = 1 [(google.api.field_behavior) = REQUIRED]; } // Config for video event human labeling task. @@ -177,20 +178,20 @@ message EventConfig { // Required. The list of annotation spec set resource name. Similar to video // classification, we support selecting event from multiple AnnotationSpecSet // at the same time. - repeated string annotation_spec_sets = 1; + repeated string annotation_spec_sets = 1 [(google.api.field_behavior) = REQUIRED]; } // Config for text classification human labeling task. message TextClassificationConfig { // Optional. If allow_multi_label is true, contributors are able to choose // multiple labels for one text segment. - bool allow_multi_label = 1; + bool allow_multi_label = 1 [(google.api.field_behavior) = OPTIONAL]; // Required. Annotation spec set resource name. - string annotation_spec_set = 2; + string annotation_spec_set = 2 [(google.api.field_behavior) = REQUIRED]; // Optional. Configs for sentiment selection. - SentimentConfig sentiment_config = 3; + SentimentConfig sentiment_config = 3 [(google.api.field_behavior) = OPTIONAL]; } // Config for setting up sentiments. @@ -204,5 +205,5 @@ message SentimentConfig { // Config for text entity extraction human labeling task. message TextEntityExtractionConfig { // Required. Annotation spec set resource name. - string annotation_spec_set = 1; + string annotation_spec_set = 1 [(google.api.field_behavior) = REQUIRED]; } diff --git a/third_party/googleapis/google/cloud/datalabeling/v1beta1/instruction.proto b/third_party/googleapis/google/cloud/datalabeling/v1beta1/instruction.proto index 6cb7b50f3..50839614a 100644 --- a/third_party/googleapis/google/cloud/datalabeling/v1beta1/instruction.proto +++ b/third_party/googleapis/google/cloud/datalabeling/v1beta1/instruction.proto @@ -18,6 +18,7 @@ syntax = "proto3"; package google.cloud.datalabeling.v1beta1; import "google/api/annotations.proto"; +import "google/api/resource.proto"; import "google/cloud/datalabeling/v1beta1/dataset.proto"; import "google/protobuf/timestamp.proto"; @@ -26,12 +27,13 @@ option java_multiple_files = true; option java_package = "com.google.cloud.datalabeling.v1beta1"; // Instruction of how to perform the labeling task for human operators. -// Currently two types of instruction are supported - CSV file and PDF. -// One of the two types instruction must be provided. -// CSV file is only supported for image classification task. Instructions for -// other task should be provided as PDF. -// For image classification, CSV and PDF can be provided at the same time. +// Currently only PDF instruction is supported. message Instruction { + option (google.api.resource) = { + type: "datalabeling.googleapis.com/Instruction" + pattern: "projects/{project}/instructions/{instruction}" + }; + // Output only. Instruction resource name, format: // projects/{project_id}/instructions/{instruction_id} string name = 1; @@ -52,15 +54,14 @@ message Instruction { // Required. The data type of this instruction. DataType data_type = 6; - // One of CSV or PDF instruction is required. + // Deprecated: this instruction format is not supported any more. // Instruction from a CSV file, such as for classification task. // The CSV file should have exact two columns, in the following format: // // * The first column is labeled data, such as an image reference, text. // * The second column is comma separated labels associated with data. - CsvInstruction csv_instruction = 7; + CsvInstruction csv_instruction = 7 [deprecated = true]; - // One of CSV or PDF instruction is required. // Instruction from a PDF document. The PDF should be in a Cloud Storage // bucket. PdfInstruction pdf_instruction = 9; @@ -70,6 +71,7 @@ message Instruction { repeated string blocking_resources = 10; } +// Deprecated: this instruction format is not supported any more. // Instruction from a CSV file. message CsvInstruction { // CSV file for the instruction. Only gcs path is allowed. diff --git a/third_party/googleapis/google/cloud/datalabeling/v1beta1/operations.proto b/third_party/googleapis/google/cloud/datalabeling/v1beta1/operations.proto index 80371d0e2..7f0692443 100644 --- a/third_party/googleapis/google/cloud/datalabeling/v1beta1/operations.proto +++ b/third_party/googleapis/google/cloud/datalabeling/v1beta1/operations.proto @@ -18,6 +18,7 @@ syntax = "proto3"; package google.cloud.datalabeling.v1beta1; import "google/api/annotations.proto"; +import "google/api/resource.proto"; import "google/cloud/datalabeling/v1beta1/dataset.proto"; import "google/cloud/datalabeling/v1beta1/human_annotation_config.proto"; import "google/protobuf/timestamp.proto"; @@ -42,7 +43,7 @@ message ImportDataOperationResponse { // Response used for ExportDataset longrunning operation. message ExportDataOperationResponse { // Ouptut only. The name of dataset. - // "projects/*/datasets/*/Datasets/*" + // "projects/*/datasets/*" string dataset = 1; // Output only. Total number of examples requested to export @@ -60,7 +61,7 @@ message ExportDataOperationResponse { // Metadata of an ImportData operation. message ImportDataOperationMetadata { - // Ouptut only. The name of imported dataset. + // Output only. The name of imported dataset. // "projects/*/datasets/*" string dataset = 1; @@ -76,7 +77,7 @@ message ImportDataOperationMetadata { // Metadata of an ExportData operation. message ExportDataOperationMetadata { // Output only. The name of dataset to be exported. - // "projects/*/datasets/*/Datasets/*" + // "projects/*/datasets/*" string dataset = 1; // Output only. Partial failures encountered. @@ -89,7 +90,7 @@ message ExportDataOperationMetadata { } // Metadata of a labeling operation, such as LabelImage or LabelVideo. -// Next tag: 18 +// Next tag: 20 message LabelOperationMetadata { // Ouptut only. Details of specific label operation. oneof details { @@ -103,8 +104,7 @@ message LabelOperationMetadata { LabelImageBoundingPolyOperationMetadata image_bounding_poly_details = 11; // Details of label image oriented bounding box operation. - LabelImageOrientedBoundingBoxOperationMetadata - image_oriented_bounding_box_details = 14; + LabelImageOrientedBoundingBoxOperationMetadata image_oriented_bounding_box_details = 14; // Details of label image polyline operation. LabelImagePolylineOperationMetadata image_polyline_details = 12; @@ -116,8 +116,7 @@ message LabelOperationMetadata { LabelVideoClassificationOperationMetadata video_classification_details = 5; // Details of label video object detection operation. - LabelVideoObjectDetectionOperationMetadata video_object_detection_details = - 6; + LabelVideoObjectDetectionOperationMetadata video_object_detection_details = 6; // Details of label video object tracking operation. LabelVideoObjectTrackingOperationMetadata video_object_tracking_details = 7; @@ -129,8 +128,7 @@ message LabelOperationMetadata { LabelTextClassificationOperationMetadata text_classification_details = 9; // Details of label text entity extraction operation. - LabelTextEntityExtractionOperationMetadata text_entity_extraction_details = - 13; + LabelTextEntityExtractionOperationMetadata text_entity_extraction_details = 13; } // Output only. Progress of label operation. Range: [0, 100]. diff --git a/third_party/googleapis/google/cloud/dataproc/artman_dataproc_v1.yaml b/third_party/googleapis/google/cloud/dataproc/artman_dataproc_v1.yaml index 211938f79..38f3d9091 100644 --- a/third_party/googleapis/google/cloud/dataproc/artman_dataproc_v1.yaml +++ b/third_party/googleapis/google/cloud/dataproc/artman_dataproc_v1.yaml @@ -3,11 +3,12 @@ common: api_version: v1 organization_name: google-cloud proto_deps: - - name: google-common-protos + - name: google-common-protos src_proto_paths: - v1 service_yaml: v1/dataproc.yaml gapic_yaml: v1/dataproc_gapic.yaml + proto_package: google.cloud.dataproc.v1 artifacts: - name: gapic_config type: GAPIC_CONFIG diff --git a/third_party/googleapis/google/cloud/dataproc/artman_dataproc_v1beta2.yaml b/third_party/googleapis/google/cloud/dataproc/artman_dataproc_v1beta2.yaml index e56bd8e9c..667fd85f5 100644 --- a/third_party/googleapis/google/cloud/dataproc/artman_dataproc_v1beta2.yaml +++ b/third_party/googleapis/google/cloud/dataproc/artman_dataproc_v1beta2.yaml @@ -8,6 +8,7 @@ common: - v1beta2 service_yaml: v1beta2/dataproc.yaml gapic_yaml: v1beta2/dataproc_gapic.yaml + proto_package: google.cloud.dataproc.v1beta2 artifacts: - name: gapic_config type: GAPIC_CONFIG diff --git a/third_party/googleapis/google/cloud/dataproc/v1/BUILD.bazel b/third_party/googleapis/google/cloud/dataproc/v1/BUILD.bazel index 391aaf6f2..33b9517ab 100644 --- a/third_party/googleapis/google/cloud/dataproc/v1/BUILD.bazel +++ b/third_party/googleapis/google/cloud/dataproc/v1/BUILD.bazel @@ -1,14 +1,18 @@ +# This file was automatically generated by BuildFileGenerator + # This is an API workspace, having public visibility by default makes perfect sense. package(default_visibility = ["//visibility:public"]) ############################################################################## # Common ############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") proto_library( name = "dataproc_proto", srcs = [ + "autoscaling_policies.proto", "clusters.proto", "jobs.proto", "operations.proto", @@ -17,6 +21,9 @@ proto_library( ], deps = [ "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", "//google/longrunning:operations_proto", "@com_google_protobuf//:duration_proto", "@com_google_protobuf//:empty_proto", @@ -27,7 +34,10 @@ proto_library( proto_library_with_info( name = "dataproc_proto_with_info", - deps = [":dataproc_proto"], + deps = [ + ":dataproc_proto", + "//google/cloud:common_resources_proto", + ], ) ############################################################################## @@ -35,18 +45,13 @@ proto_library_with_info( ############################################################################## load( "@com_google_googleapis_imports//:imports.bzl", - "java_grpc_library", - "java_gapic_library", "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", "java_proto_library", - "java_resource_name_proto_library", - "java_test", ) -_JAVA_GRPC_DEPS = [ - "@com_google_api_grpc_proto_google_common_protos//jar", -] - java_proto_library( name = "dataproc_java_proto", deps = [":dataproc_proto"], @@ -55,53 +60,44 @@ java_proto_library( java_grpc_library( name = "dataproc_java_grpc", srcs = [":dataproc_proto"], - deps = [":dataproc_java_proto"] + _JAVA_GRPC_DEPS, -) - -java_resource_name_proto_library( - name = "dataproc_resource_name_java_proto", - gapic_yaml = "dataproc_gapic.yaml", - deps = [":dataproc_proto"], + deps = [":dataproc_java_proto"], ) java_gapic_library( name = "dataproc_java_gapic", src = ":dataproc_proto_with_info", gapic_yaml = "dataproc_gapic.yaml", - service_yaml = "dataproc.yaml", - test_deps = [":dataproc_java_grpc"], + package = "google.cloud.dataproc.v1", + service_yaml = "dataproc_v1.yaml", + test_deps = [ + ":dataproc_java_grpc", + ], deps = [ ":dataproc_java_proto", - ":dataproc_resource_name_java_proto", - ] + _JAVA_GRPC_DEPS, + ], ) -[java_test( - name = test_name, - test_class = test_name, - runtime_deps = [ - ":dataproc_java_gapic_test", +java_gapic_test( + name = "dataproc_java_gapic_test_suite", + test_classes = [ + # Add AutoscalingPolicyService to gapic yaml + "com.google.cloud.dataproc.v1.AutoscalingPolicyServiceClientTest", + "com.google.cloud.dataproc.v1.ClusterControllerClientTest", + "com.google.cloud.dataproc.v1.JobControllerClientTest", + "com.google.cloud.dataproc.v1.WorkflowTemplateServiceClientTest", ], -) for test_name in [ - "com.google.cloud.dataproc.v1.ClusterControllerClientTest", - "com.google.cloud.dataproc.v1.JobControllerClientTest", - "com.google.cloud.dataproc.v1.WorkflowTemplateServiceClientTest", -]] + runtime_deps = [":dataproc_java_gapic_test"], +) -# Opensource Packages +# Open Source Packages java_gapic_assembly_gradle_pkg( name = "google-cloud-dataproc-v1-java", - client_deps = [":dataproc_java_gapic"], - client_group = "com.google.cloud", - client_test_deps = [":dataproc_java_gapic_test"], - grpc_deps = [":dataproc_java_grpc"], - grpc_group = "com.google.api.grpc", - proto_deps = [ + deps = [ + ":dataproc_java_gapic", + ":dataproc_java_grpc", ":dataproc_java_proto", ":dataproc_proto", - ":dataproc_resource_name_java_proto", - ] + _JAVA_GRPC_DEPS, - version = "0.0.0-SNAPSHOT", + ], ) ############################################################################## @@ -109,10 +105,10 @@ java_gapic_assembly_gradle_pkg( ############################################################################## load( "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", "go_proto_library", "go_test", - "go_gapic_library", - "go_gapic_assembly_pkg", ) go_proto_library( @@ -128,15 +124,17 @@ go_proto_library( go_gapic_library( name = "dataproc_go_gapic", - src = ":dataproc_proto_with_info", - gapic_yaml = "dataproc_gapic.yaml", - importpath = "cloud.google.com/go/dataproc/apiv1", - service_yaml = "dataproc.yaml", + srcs = [":dataproc_proto_with_info"], + grpc_service_config = "dataproc_grpc_service_config.json", + importpath = "cloud.google.com/go/dataproc/apiv1;dataproc", + service_yaml = "dataproc_v1.yaml", deps = [ ":dataproc_go_proto", "//google/longrunning:longrunning_go_gapic", "//google/longrunning:longrunning_go_proto", "@com_google_cloud_go//longrunning:go_default_library", + "@com_google_cloud_go//longrunning/autogen:go_default_library", + "@io_bazel_rules_go//proto/wkt:duration_go_proto", ], ) @@ -147,13 +145,237 @@ go_test( importpath = "cloud.google.com/go/dataproc/apiv1", ) -# Opensource Packages +# Open Source Packages go_gapic_assembly_pkg( name = "gapi-cloud-dataproc-v1-go", deps = [ ":dataproc_go_gapic", - ":dataproc_go_gapic_srcjar-smoke-test.srcjar", ":dataproc_go_gapic_srcjar-test.srcjar", ":dataproc_go_proto", ], ) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "dataproc_moved_proto", + srcs = [":dataproc_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/longrunning:operations_proto", + "@com_google_protobuf//:duration_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +py_proto_library( + name = "dataproc_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":dataproc_moved_proto"], +) + +py_grpc_library( + name = "dataproc_py_grpc", + srcs = [":dataproc_moved_proto"], + deps = [":dataproc_py_proto"], +) + +py_gapic_library( + name = "dataproc_py_gapic", + src = ":dataproc_proto_with_info", + gapic_yaml = "dataproc_gapic.yaml", + package = "google.cloud.dataproc.v1", + service_yaml = "dataproc_v1.yaml", + deps = [ + ":dataproc_py_grpc", + ":dataproc_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "dataproc-v1-py", + deps = [ + ":dataproc_py_gapic", + ":dataproc_py_grpc", + ":dataproc_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "dataproc_php_proto", + deps = [":dataproc_proto"], +) + +php_grpc_library( + name = "dataproc_php_grpc", + srcs = [":dataproc_proto"], + deps = [":dataproc_php_proto"], +) + +php_gapic_library( + name = "dataproc_php_gapic", + src = ":dataproc_proto_with_info", + gapic_yaml = "dataproc_gapic.yaml", + package = "google.cloud.dataproc.v1", + service_yaml = "dataproc_v1.yaml", + deps = [ + ":dataproc_php_grpc", + ":dataproc_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-dataproc-v1-php", + deps = [ + ":dataproc_php_gapic", + ":dataproc_php_grpc", + ":dataproc_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "dataproc_nodejs_gapic", + src = ":dataproc_proto_with_info", + gapic_yaml = "dataproc_gapic.yaml", + package = "google.cloud.dataproc.v1", + service_yaml = "dataproc_v1.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "dataproc-v1-nodejs", + deps = [ + ":dataproc_nodejs_gapic", + ":dataproc_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "dataproc_ruby_proto", + deps = [":dataproc_proto"], +) + +ruby_grpc_library( + name = "dataproc_ruby_grpc", + srcs = [":dataproc_proto"], + deps = [":dataproc_ruby_proto"], +) + +ruby_gapic_library( + name = "dataproc_ruby_gapic", + src = ":dataproc_proto_with_info", + gapic_yaml = "dataproc_gapic.yaml", + package = "google.cloud.dataproc.v1", + service_yaml = "dataproc_v1.yaml", + deps = [ + ":dataproc_ruby_grpc", + ":dataproc_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-dataproc-v1-ruby", + deps = [ + ":dataproc_ruby_gapic", + ":dataproc_ruby_grpc", + ":dataproc_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "dataproc_csharp_proto", + deps = [":dataproc_proto"], +) + +csharp_grpc_library( + name = "dataproc_csharp_grpc", + srcs = [":dataproc_proto"], + deps = [":dataproc_csharp_proto"], +) + +csharp_gapic_library( + name = "dataproc_csharp_gapic", + src = ":dataproc_proto_with_info", + gapic_yaml = "dataproc_gapic.yaml", + package = "google.cloud.dataproc.v1", + service_yaml = "dataproc_v1.yaml", + deps = [ + ":dataproc_csharp_grpc", + ":dataproc_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-dataproc-v1-csharp", + deps = [ + ":dataproc_csharp_gapic", + ":dataproc_csharp_grpc", + ":dataproc_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/cloud/dataproc/v1/autoscaling_policies.proto b/third_party/googleapis/google/cloud/dataproc/v1/autoscaling_policies.proto new file mode 100644 index 000000000..4ce5868d0 --- /dev/null +++ b/third_party/googleapis/google/cloud/dataproc/v1/autoscaling_policies.proto @@ -0,0 +1,349 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.dataproc.v1; + +import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/duration.proto"; +import "google/protobuf/empty.proto"; + +option go_package = "google.golang.org/genproto/googleapis/cloud/dataproc/v1;dataproc"; +option java_multiple_files = true; +option java_outer_classname = "AutoscalingPoliciesProto"; +option java_package = "com.google.cloud.dataproc.v1"; +option (google.api.resource_definition) = { + type: "dataproc.googleapis.com/Region" + pattern: "projects/{project}/regions/{region}" +}; + +// The API interface for managing autoscaling policies in the +// Dataproc API. +service AutoscalingPolicyService { + option (google.api.default_host) = "dataproc.googleapis.com"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; + + // Creates new autoscaling policy. + rpc CreateAutoscalingPolicy(CreateAutoscalingPolicyRequest) returns (AutoscalingPolicy) { + option (google.api.http) = { + post: "/v1/{parent=projects/*/locations/*}/autoscalingPolicies" + body: "policy" + additional_bindings { + post: "/v1/{parent=projects/*/regions/*}/autoscalingPolicies" + body: "policy" + } + }; + option (google.api.method_signature) = "parent,policy"; + } + + // Updates (replaces) autoscaling policy. + // + // Disabled check for update_mask, because all updates will be full + // replacements. + rpc UpdateAutoscalingPolicy(UpdateAutoscalingPolicyRequest) returns (AutoscalingPolicy) { + option (google.api.http) = { + put: "/v1/{policy.name=projects/*/locations/*/autoscalingPolicies/*}" + body: "policy" + additional_bindings { + put: "/v1/{policy.name=projects/*/regions/*/autoscalingPolicies/*}" + body: "policy" + } + }; + option (google.api.method_signature) = "policy"; + } + + // Retrieves autoscaling policy. + rpc GetAutoscalingPolicy(GetAutoscalingPolicyRequest) returns (AutoscalingPolicy) { + option (google.api.http) = { + get: "/v1/{name=projects/*/locations/*/autoscalingPolicies/*}" + additional_bindings { + get: "/v1/{name=projects/*/regions/*/autoscalingPolicies/*}" + } + }; + option (google.api.method_signature) = "name"; + } + + // Lists autoscaling policies in the project. + rpc ListAutoscalingPolicies(ListAutoscalingPoliciesRequest) returns (ListAutoscalingPoliciesResponse) { + option (google.api.http) = { + get: "/v1/{parent=projects/*/locations/*}/autoscalingPolicies" + additional_bindings { + get: "/v1/{parent=projects/*/regions/*}/autoscalingPolicies" + } + }; + option (google.api.method_signature) = "parent"; + } + + // Deletes an autoscaling policy. It is an error to delete an autoscaling + // policy that is in use by one or more clusters. + rpc DeleteAutoscalingPolicy(DeleteAutoscalingPolicyRequest) returns (google.protobuf.Empty) { + option (google.api.http) = { + delete: "/v1/{name=projects/*/locations/*/autoscalingPolicies/*}" + additional_bindings { + delete: "/v1/{name=projects/*/regions/*/autoscalingPolicies/*}" + } + }; + option (google.api.method_signature) = "name"; + } +} + +// Describes an autoscaling policy for Dataproc cluster autoscaler. +message AutoscalingPolicy { + option (google.api.resource) = { + type: "dataproc.googleapis.com/AutoscalingPolicy" + pattern: "projects/{project}/locations/{location}/autoscalingPolicies/{autoscaling_policy}" + pattern: "projects/{project}/regions/{region}/autoscalingPolicies/{autoscaling_policy}" + }; + + // Required. The policy id. + // + // The id must contain only letters (a-z, A-Z), numbers (0-9), + // underscores (_), and hyphens (-). Cannot begin or end with underscore + // or hyphen. Must consist of between 3 and 50 characters. + // + string id = 1; + + // Output only. The "resource name" of the autoscaling policy, as described + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.autoscalingPolicies`, the resource name of the + // policy has the following format: + // `projects/{project_id}/regions/{region}/autoscalingPolicies/{policy_id}` + // + // * For `projects.locations.autoscalingPolicies`, the resource name of the + // policy has the following format: + // `projects/{project_id}/locations/{location}/autoscalingPolicies/{policy_id}` + string name = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Autoscaling algorithm for policy. + oneof algorithm { + BasicAutoscalingAlgorithm basic_algorithm = 3 [(google.api.field_behavior) = REQUIRED]; + } + + // Required. Describes how the autoscaler will operate for primary workers. + InstanceGroupAutoscalingPolicyConfig worker_config = 4 [(google.api.field_behavior) = REQUIRED]; + + // Optional. Describes how the autoscaler will operate for secondary workers. + InstanceGroupAutoscalingPolicyConfig secondary_worker_config = 5 [(google.api.field_behavior) = OPTIONAL]; +} + +// Basic algorithm for autoscaling. +message BasicAutoscalingAlgorithm { + // Required. YARN autoscaling configuration. + BasicYarnAutoscalingConfig yarn_config = 1 [(google.api.field_behavior) = REQUIRED]; + + // Optional. Duration between scaling events. A scaling period starts after + // the update operation from the previous event has completed. + // + // Bounds: [2m, 1d]. Default: 2m. + google.protobuf.Duration cooldown_period = 2 [(google.api.field_behavior) = OPTIONAL]; +} + +// Basic autoscaling configurations for YARN. +message BasicYarnAutoscalingConfig { + // Required. Timeout for YARN graceful decommissioning of Node Managers. + // Specifies the duration to wait for jobs to complete before forcefully + // removing workers (and potentially interrupting jobs). Only applicable to + // downscaling operations. + // + // Bounds: [0s, 1d]. + google.protobuf.Duration graceful_decommission_timeout = 5 [(google.api.field_behavior) = REQUIRED]; + + // Required. Fraction of average pending memory in the last cooldown period + // for which to add workers. A scale-up factor of 1.0 will result in scaling + // up so that there is no pending memory remaining after the update (more + // aggressive scaling). A scale-up factor closer to 0 will result in a smaller + // magnitude of scaling up (less aggressive scaling). + // + // Bounds: [0.0, 1.0]. + double scale_up_factor = 1 [(google.api.field_behavior) = REQUIRED]; + + // Required. Fraction of average pending memory in the last cooldown period + // for which to remove workers. A scale-down factor of 1 will result in + // scaling down so that there is no available memory remaining after the + // update (more aggressive scaling). A scale-down factor of 0 disables + // removing workers, which can be beneficial for autoscaling a single job. + // + // Bounds: [0.0, 1.0]. + double scale_down_factor = 2 [(google.api.field_behavior) = REQUIRED]; + + // Optional. Minimum scale-up threshold as a fraction of total cluster size + // before scaling occurs. For example, in a 20-worker cluster, a threshold of + // 0.1 means the autoscaler must recommend at least a 2-worker scale-up for + // the cluster to scale. A threshold of 0 means the autoscaler will scale up + // on any recommended change. + // + // Bounds: [0.0, 1.0]. Default: 0.0. + double scale_up_min_worker_fraction = 3 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Minimum scale-down threshold as a fraction of total cluster size + // before scaling occurs. For example, in a 20-worker cluster, a threshold of + // 0.1 means the autoscaler must recommend at least a 2 worker scale-down for + // the cluster to scale. A threshold of 0 means the autoscaler will scale down + // on any recommended change. + // + // Bounds: [0.0, 1.0]. Default: 0.0. + double scale_down_min_worker_fraction = 4 [(google.api.field_behavior) = OPTIONAL]; +} + +// Configuration for the size bounds of an instance group, including its +// proportional size to other groups. +message InstanceGroupAutoscalingPolicyConfig { + // Optional. Minimum number of instances for this group. + // + // Primary workers - Bounds: [2, max_instances]. Default: 2. + // Secondary workers - Bounds: [0, max_instances]. Default: 0. + int32 min_instances = 1 [(google.api.field_behavior) = OPTIONAL]; + + // Required. Maximum number of instances for this group. Required for primary + // workers. Note that by default, clusters will not use secondary workers. + // Required for secondary workers if the minimum secondary instances is set. + // + // Primary workers - Bounds: [min_instances, ). + // Secondary workers - Bounds: [min_instances, ). Default: 0. + int32 max_instances = 2 [(google.api.field_behavior) = REQUIRED]; + + // Optional. Weight for the instance group, which is used to determine the + // fraction of total workers in the cluster from this instance group. + // For example, if primary workers have weight 2, and secondary workers have + // weight 1, the cluster will have approximately 2 primary workers for each + // secondary worker. + // + // The cluster may not reach the specified balance if constrained + // by min/max bounds or other autoscaling settings. For example, if + // `max_instances` for secondary workers is 0, then only primary workers will + // be added. The cluster can also be out of balance when created. + // + // If weight is not set on any instance group, the cluster will default to + // equal weight for all groups: the cluster will attempt to maintain an equal + // number of workers in each group within the configured size bounds for each + // group. If weight is set for one group only, the cluster will default to + // zero weight on the unset group. For example if weight is set only on + // primary workers, the cluster will use primary workers only and no + // secondary workers. + int32 weight = 3 [(google.api.field_behavior) = OPTIONAL]; +} + +// A request to create an autoscaling policy. +message CreateAutoscalingPolicyRequest { + // Required. The "resource name" of the region or location, as described + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.autoscalingPolicies.create`, the resource name + // of the region has the following format: + // `projects/{project_id}/regions/{region}` + // + // * For `projects.locations.autoscalingPolicies.create`, the resource name + // of the location has the following format: + // `projects/{project_id}/locations/{location}` + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dataproc.googleapis.com/AutoscalingPolicy" + } + ]; + + // Required. The autoscaling policy to create. + AutoscalingPolicy policy = 2 [(google.api.field_behavior) = REQUIRED]; +} + +// A request to fetch an autoscaling policy. +message GetAutoscalingPolicyRequest { + // Required. The "resource name" of the autoscaling policy, as described + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.autoscalingPolicies.get`, the resource name + // of the policy has the following format: + // `projects/{project_id}/regions/{region}/autoscalingPolicies/{policy_id}` + // + // * For `projects.locations.autoscalingPolicies.get`, the resource name + // of the policy has the following format: + // `projects/{project_id}/locations/{location}/autoscalingPolicies/{policy_id}` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "dataproc.googleapis.com/AutoscalingPolicy" + } + ]; +} + +// A request to update an autoscaling policy. +message UpdateAutoscalingPolicyRequest { + // Required. The updated autoscaling policy. + AutoscalingPolicy policy = 1 [(google.api.field_behavior) = REQUIRED]; +} + +// A request to delete an autoscaling policy. +// +// Autoscaling policies in use by one or more clusters will not be deleted. +message DeleteAutoscalingPolicyRequest { + // Required. The "resource name" of the autoscaling policy, as described + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.autoscalingPolicies.delete`, the resource name + // of the policy has the following format: + // `projects/{project_id}/regions/{region}/autoscalingPolicies/{policy_id}` + // + // * For `projects.locations.autoscalingPolicies.delete`, the resource name + // of the policy has the following format: + // `projects/{project_id}/locations/{location}/autoscalingPolicies/{policy_id}` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "dataproc.googleapis.com/AutoscalingPolicy" + } + ]; +} + +// A request to list autoscaling policies in a project. +message ListAutoscalingPoliciesRequest { + // Required. The "resource name" of the region or location, as described + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.autoscalingPolicies.list`, the resource name + // of the region has the following format: + // `projects/{project_id}/regions/{region}` + // + // * For `projects.locations.autoscalingPolicies.list`, the resource name + // of the location has the following format: + // `projects/{project_id}/locations/{location}` + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dataproc.googleapis.com/AutoscalingPolicy" + } + ]; + + // Optional. The maximum number of results to return in each response. + // Must be less than or equal to 1000. Defaults to 100. + int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The page token, returned by a previous call, to request the + // next page of results. + string page_token = 3 [(google.api.field_behavior) = OPTIONAL]; +} + +// A response to a request to list autoscaling policies in a project. +message ListAutoscalingPoliciesResponse { + // Output only. Autoscaling policies list. + repeated AutoscalingPolicy policies = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. This token is included in the response if there are more + // results to fetch. + string next_page_token = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; +} diff --git a/third_party/googleapis/google/cloud/dataproc/v1/clusters.proto b/third_party/googleapis/google/cloud/dataproc/v1/clusters.proto index ab2cc2d02..fbaf9391e 100644 --- a/third_party/googleapis/google/cloud/dataproc/v1/clusters.proto +++ b/third_party/googleapis/google/cloud/dataproc/v1/clusters.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.dataproc.v1; import "google/api/annotations.proto"; -import "google/cloud/dataproc/v1/operations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; import "google/cloud/dataproc/v1/shared.proto"; import "google/longrunning/operations.proto"; import "google/protobuf/duration.proto"; @@ -33,27 +33,51 @@ option java_package = "com.google.cloud.dataproc.v1"; // The ClusterControllerService provides methods to manage clusters // of Compute Engine instances. service ClusterController { - // Creates a cluster in a project. + option (google.api.default_host) = "dataproc.googleapis.com"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; + + // Creates a cluster in a project. The returned + // [Operation.metadata][google.longrunning.Operation.metadata] will be + // [ClusterOperationMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#clusteroperationmetadata). rpc CreateCluster(CreateClusterRequest) returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/projects/{project_id}/regions/{region}/clusters" body: "cluster" }; + option (google.api.method_signature) = "project_id,region,cluster"; + option (google.longrunning.operation_info) = { + response_type: "Cluster" + metadata_type: "google.cloud.dataproc.v1.ClusterOperationMetadata" + }; } - // Updates a cluster in a project. + // Updates a cluster in a project. The returned + // [Operation.metadata][google.longrunning.Operation.metadata] will be + // [ClusterOperationMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#clusteroperationmetadata). rpc UpdateCluster(UpdateClusterRequest) returns (google.longrunning.Operation) { option (google.api.http) = { patch: "/v1/projects/{project_id}/regions/{region}/clusters/{cluster_name}" body: "cluster" }; + option (google.api.method_signature) = "project_id,region,cluster_name,cluster,update_mask"; + option (google.longrunning.operation_info) = { + response_type: "Cluster" + metadata_type: "google.cloud.dataproc.v1.ClusterOperationMetadata" + }; } - // Deletes a cluster in a project. + // Deletes a cluster in a project. The returned + // [Operation.metadata][google.longrunning.Operation.metadata] will be + // [ClusterOperationMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#clusteroperationmetadata). rpc DeleteCluster(DeleteClusterRequest) returns (google.longrunning.Operation) { option (google.api.http) = { delete: "/v1/projects/{project_id}/regions/{region}/clusters/{cluster_name}" }; + option (google.api.method_signature) = "project_id,region,cluster_name"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "google.cloud.dataproc.v1.ClusterOperationMetadata" + }; } // Gets the resource representation for a cluster in a project. @@ -61,23 +85,35 @@ service ClusterController { option (google.api.http) = { get: "/v1/projects/{project_id}/regions/{region}/clusters/{cluster_name}" }; + option (google.api.method_signature) = "project_id,region,cluster_name"; } - // Lists all regions/{region}/clusters in a project. + // Lists all regions/{region}/clusters in a project alphabetically. rpc ListClusters(ListClustersRequest) returns (ListClustersResponse) { option (google.api.http) = { get: "/v1/projects/{project_id}/regions/{region}/clusters" }; + option (google.api.method_signature) = "project_id,region"; + option (google.api.method_signature) = "project_id,region,filter"; } - // Gets cluster diagnostic information. - // After the operation completes, the Operation.response field - // contains `DiagnoseClusterOutputLocation`. + // Gets cluster diagnostic information. The returned + // [Operation.metadata][google.longrunning.Operation.metadata] will be + // [ClusterOperationMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#clusteroperationmetadata). + // After the operation completes, + // [Operation.response][google.longrunning.Operation.response] + // contains + // [DiagnoseClusterResults](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#diagnoseclusterresults). rpc DiagnoseCluster(DiagnoseClusterRequest) returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1/projects/{project_id}/regions/{region}/clusters/{cluster_name}:diagnose" body: "*" }; + option (google.api.method_signature) = "project_id,region,cluster_name"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "DiagnoseClusterResults" + }; } } @@ -85,15 +121,15 @@ service ClusterController { // a cluster of Compute Engine instances. message Cluster { // Required. The Google Cloud Platform project ID that the cluster belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; // Required. The cluster name. Cluster names within a project must be // unique. Names of deleted clusters can be reused. - string cluster_name = 2; + string cluster_name = 2 [(google.api.field_behavior) = REQUIRED]; - // Required. The cluster config. Note that Cloud Dataproc may set + // Required. The cluster config. Note that Dataproc may set // default values, and values may change when clusters are updated. - ClusterConfig config = 3; + ClusterConfig config = 3 [(google.api.field_behavior) = REQUIRED]; // Optional. The labels to associate with this cluster. // Label **keys** must contain 1 to 63 characters, and must conform to @@ -102,56 +138,56 @@ message Cluster { // characters, and must conform to [RFC // 1035](https://www.ietf.org/rfc/rfc1035.txt). No more than 32 labels can be // associated with a cluster. - map labels = 8; + map labels = 8 [(google.api.field_behavior) = OPTIONAL]; // Output only. Cluster status. - ClusterStatus status = 4; + ClusterStatus status = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The previous cluster status. - repeated ClusterStatus status_history = 7; + repeated ClusterStatus status_history = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Output only. A cluster UUID (Unique Universal Identifier). Cloud Dataproc + // Output only. A cluster UUID (Unique Universal Identifier). Dataproc // generates this value when it creates the cluster. - string cluster_uuid = 6; + string cluster_uuid = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Contains cluster daemon metrics such as HDFS and YARN stats. + // Output only. Contains cluster daemon metrics such as HDFS and YARN stats. // // **Beta Feature**: This report is available for testing purposes only. It // may be changed before final release. - ClusterMetrics metrics = 9; + ClusterMetrics metrics = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The cluster config. message ClusterConfig { - // Optional. A Google Cloud Storage bucket used to stage job + // Optional. A Cloud Storage bucket used to stage job // dependencies, config files, and job driver console output. // If you do not specify a staging bucket, Cloud // Dataproc will determine a Cloud Storage location (US, - // ASIA, or EU) for your cluster's staging bucket according to the Google + // ASIA, or EU) for your cluster's staging bucket according to the // Compute Engine zone where your cluster is deployed, and then create // and manage this project-level, per-location bucket (see - // [Cloud Dataproc staging - // bucket](/dataproc/docs/concepts/configuring-clusters/staging-bucket)). - string config_bucket = 1; + // [Dataproc staging + // bucket](https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/staging-bucket)). + string config_bucket = 1 [(google.api.field_behavior) = OPTIONAL]; // Optional. The shared Compute Engine config settings for // all instances in a cluster. - GceClusterConfig gce_cluster_config = 8; + GceClusterConfig gce_cluster_config = 8 [(google.api.field_behavior) = OPTIONAL]; // Optional. The Compute Engine config settings for // the master instance in a cluster. - InstanceGroupConfig master_config = 9; + InstanceGroupConfig master_config = 9 [(google.api.field_behavior) = OPTIONAL]; // Optional. The Compute Engine config settings for // worker instances in a cluster. - InstanceGroupConfig worker_config = 10; + InstanceGroupConfig worker_config = 10 [(google.api.field_behavior) = OPTIONAL]; // Optional. The Compute Engine config settings for // additional worker instances in a cluster. - InstanceGroupConfig secondary_worker_config = 12; + InstanceGroupConfig secondary_worker_config = 12 [(google.api.field_behavior) = OPTIONAL]; // Optional. The config settings for software inside the cluster. - SoftwareConfig software_config = 13; + SoftwareConfig software_config = 13 [(google.api.field_behavior) = OPTIONAL]; // Optional. Commands to execute on each node after config is // completed. By default, executables are run on master and all worker nodes. @@ -166,17 +202,41 @@ message ClusterConfig { // else // ... worker specific actions ... // fi - repeated NodeInitializationAction initialization_actions = 11; + repeated NodeInitializationAction initialization_actions = 11 [(google.api.field_behavior) = OPTIONAL]; // Optional. Encryption settings for the cluster. - EncryptionConfig encryption_config = 15; + EncryptionConfig encryption_config = 15 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Autoscaling config for the policy associated with the cluster. + // Cluster does not autoscale if this field is unset. + AutoscalingConfig autoscaling_config = 18 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Security settings for the cluster. + SecurityConfig security_config = 16 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Lifecycle setting for the cluster. + LifecycleConfig lifecycle_config = 17 [(google.api.field_behavior) = OPTIONAL]; +} + +// Autoscaling Policy config associated with the cluster. +message AutoscalingConfig { + // Optional. The autoscaling policy used by the cluster. + // + // Only resource names including projectid and location (region) are valid. + // Examples: + // + // * `https://www.googleapis.com/compute/v1/projects/[project_id]/locations/[dataproc_region]/autoscalingPolicies/[policy_id]` + // * `projects/[project_id]/locations/[dataproc_region]/autoscalingPolicies/[policy_id]` + // + // Note that the policy must be in the same project and Dataproc region. + string policy_uri = 1 [(google.api.field_behavior) = OPTIONAL]; } // Encryption settings for the cluster. message EncryptionConfig { // Optional. The Cloud KMS key name to use for PD disk encryption for all // instances in the cluster. - string gce_pd_kms_key_name = 1; + string gce_pd_kms_key_name = 1 [(google.api.field_behavior) = OPTIONAL]; } // Common config settings for resources of Compute Engine cluster @@ -184,7 +244,7 @@ message EncryptionConfig { message GceClusterConfig { // Optional. The zone where the Compute Engine cluster will be located. // On a create request, it is required in the "global" region. If omitted - // in a non-global Cloud Dataproc region, the service will pick a zone in the + // in a non-global Dataproc region, the service will pick a zone in the // corresponding Compute Engine region. On a get request, zone will // always be present. // @@ -193,20 +253,21 @@ message GceClusterConfig { // * `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone]` // * `projects/[project_id]/zones/[zone]` // * `us-central1-f` - string zone_uri = 1; + string zone_uri = 1 [(google.api.field_behavior) = OPTIONAL]; // Optional. The Compute Engine network to be used for machine // communications. Cannot be specified with subnetwork_uri. If neither // `network_uri` nor `subnetwork_uri` is specified, the "default" network of // the project is used, if it exists. Cannot be a "Custom Subnet Network" (see - // [Using Subnetworks](/compute/docs/subnetworks) for more information). + // [Using Subnetworks](https://cloud.google.com/compute/docs/subnetworks) for + // more information). // // A full URL, partial URI, or short name are valid. Examples: // // * `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/global/default` // * `projects/[project_id]/regions/global/default` // * `default` - string network_uri = 2; + string network_uri = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. The Compute Engine subnetwork to be used for machine // communications. Cannot be specified with network_uri. @@ -216,7 +277,7 @@ message GceClusterConfig { // * `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/us-east1/subnetworks/sub0` // * `projects/[project_id]/regions/us-east1/subnetworks/sub0` // * `sub0` - string subnetwork_uri = 6; + string subnetwork_uri = 6 [(google.api.field_behavior) = OPTIONAL]; // Optional. If true, all instances in the cluster will only have internal IP // addresses. By default, clusters are not restricted to internal IP @@ -224,20 +285,20 @@ message GceClusterConfig { // instance. This `internal_ip_only` restriction can only be enabled for // subnetwork enabled networks, and all off-cluster dependencies must be // configured to be accessible without external IP addresses. - bool internal_ip_only = 7; + bool internal_ip_only = 7 [(google.api.field_behavior) = OPTIONAL]; - // Optional. The service account of the instances. Defaults to the default - // Compute Engine service account. Custom service accounts need - // permissions equivalent to the following IAM roles: + // Optional. The [Dataproc service + // account](https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/service-accounts#service_accounts_in_cloud_dataproc) + // (also see [VM Data Plane + // identity](https://cloud.google.com/dataproc/docs/concepts/iam/dataproc-principals#vm_service_account_data_plane_identity)) + // used by Dataproc cluster VM instances to access Google Cloud Platform + // services. // - // * roles/logging.logWriter - // * roles/storage.objectAdmin - // - // (see - // https://cloud.google.com/compute/docs/access/service-accounts#custom_service_accounts - // for more information). - // Example: `[account_id]@[project_id].iam.gserviceaccount.com` - string service_account = 8; + // If not specified, the + // [Compute Engine default service + // account](https://cloud.google.com/compute/docs/access/service-accounts#default_service_account) + // is used. + string service_account = 8 [(google.api.field_behavior) = OPTIONAL]; // Optional. The URIs of service account scopes to be included in // Compute Engine instances. The following base set of scopes is always @@ -253,33 +314,51 @@ message GceClusterConfig { // * https://www.googleapis.com/auth/bigtable.admin.table // * https://www.googleapis.com/auth/bigtable.data // * https://www.googleapis.com/auth/devstorage.full_control - repeated string service_account_scopes = 3; + repeated string service_account_scopes = 3 [(google.api.field_behavior) = OPTIONAL]; - // The Compute Engine tags to add to all instances (see - // [Tagging instances](/compute/docs/label-or-tag-resources#tags)). + // The Compute Engine tags to add to all instances (see [Tagging + // instances](https://cloud.google.com/compute/docs/label-or-tag-resources#tags)). repeated string tags = 4; // The Compute Engine metadata entries to add to all instances (see // [Project and instance // metadata](https://cloud.google.com/compute/docs/storing-retrieving-metadata#project_and_instance_metadata)). map metadata = 5; + + // Optional. Reservation Affinity for consuming Zonal reservation. + ReservationAffinity reservation_affinity = 11 [(google.api.field_behavior) = OPTIONAL]; } -// Optional. The config settings for Compute Engine resources in +// The config settings for Compute Engine resources in // an instance group, such as a master or worker group. message InstanceGroupConfig { // Optional. The number of VM instances in the instance group. // For master instance groups, must be set to 1. - int32 num_instances = 1; + int32 num_instances = 1 [(google.api.field_behavior) = OPTIONAL]; - // Output only. The list of instance names. Cloud Dataproc derives the names + // Output only. The list of instance names. Dataproc derives the names // from `cluster_name`, `num_instances`, and the instance group. - repeated string instance_names = 2; + repeated string instance_names = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Optional. The Compute Engine image resource used for cluster - // instances. It can be specified or may be inferred from - // `SoftwareConfig.image_version`. - string image_uri = 3; + // Optional. The Compute Engine image resource used for cluster instances. + // + // The URI can represent an image or image family. + // + // Image examples: + // + // * `https://www.googleapis.com/compute/beta/projects/[project_id]/global/images/[image-id]` + // * `projects/[project_id]/global/images/[image-id]` + // * `image-id` + // + // Image family examples. Dataproc will use the most recent + // image from the family: + // + // * `https://www.googleapis.com/compute/beta/projects/[project_id]/global/images/family/[custom-image-family-name]` + // * `projects/[project_id]/global/images/family/[custom-image-family-name]` + // + // If the URI is unspecified, it will be inferred from + // `SoftwareConfig.image_version` or the system default. + string image_uri = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. The Compute Engine machine type used for cluster instances. // @@ -289,50 +368,53 @@ message InstanceGroupConfig { // * `projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2` // * `n1-standard-2` // - // **Auto Zone Exception**: If you are using the Cloud Dataproc + // **Auto Zone Exception**: If you are using the Dataproc // [Auto Zone - // Placement](/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement) + // Placement](https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement) // feature, you must use the short name of the machine type // resource, for example, `n1-standard-2`. - string machine_type_uri = 4; + string machine_type_uri = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. Disk option config settings. - DiskConfig disk_config = 5; + DiskConfig disk_config = 5 [(google.api.field_behavior) = OPTIONAL]; - // Optional. Specifies that this instance group contains preemptible + // Output only. Specifies that this instance group contains preemptible // instances. - bool is_preemptible = 6; + bool is_preemptible = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The config for Compute Engine Instance Group // Manager that manages this group. // This is only used for preemptible instance groups. - ManagedGroupConfig managed_group_config = 7; + ManagedGroupConfig managed_group_config = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; // Optional. The Compute Engine accelerator configuration for these // instances. - // - // **Beta Feature**: This feature is still under development. It may be - // changed before final release. - repeated AcceleratorConfig accelerators = 8; + repeated AcceleratorConfig accelerators = 8 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Specifies the minimum cpu platform for the Instance Group. + // See [Dataproc -> Minimum CPU + // Platform](https://cloud.google.com/dataproc/docs/concepts/compute/dataproc-min-cpu). + string min_cpu_platform = 9 [(google.api.field_behavior) = OPTIONAL]; } // Specifies the resources used to actively manage an instance group. message ManagedGroupConfig { // Output only. The name of the Instance Template used for the Managed // Instance Group. - string instance_template_name = 1; + string instance_template_name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The name of the Instance Group Manager for this group. - string instance_group_manager_name = 2; + string instance_group_manager_name = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Specifies the type and number of accelerator cards attached to the instances -// of an instance. See [GPUs on Compute Engine](/compute/docs/gpus/). +// of an instance. See [GPUs on Compute +// Engine](https://cloud.google.com/compute/docs/gpus/). message AcceleratorConfig { // Full URL, partial URI, or short name of the accelerator type resource to // expose to this instance. See // [Compute Engine - // AcceleratorTypes](/compute/docs/reference/beta/acceleratorTypes). + // AcceleratorTypes](https://cloud.google.com/compute/docs/reference/beta/acceleratorTypes). // // Examples: // @@ -340,9 +422,9 @@ message AcceleratorConfig { // * `projects/[project_id]/zones/us-east1-a/acceleratorTypes/nvidia-tesla-k80` // * `nvidia-tesla-k80` // - // **Auto Zone Exception**: If you are using the Cloud Dataproc + // **Auto Zone Exception**: If you are using the Dataproc // [Auto Zone - // Placement](/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement) + // Placement](https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement) // feature, you must use the short name of the accelerator type // resource, for example, `nvidia-tesla-k80`. string accelerator_type_uri = 1; @@ -356,10 +438,10 @@ message DiskConfig { // Optional. Type of the boot disk (default is "pd-standard"). // Valid values: "pd-ssd" (Persistent Disk Solid State Drive) or // "pd-standard" (Persistent Disk Hard Disk Drive). - string boot_disk_type = 3; + string boot_disk_type = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. Size in GB of the boot disk (default is 500GB). - int32 boot_disk_size_gb = 1; + int32 boot_disk_size_gb = 1 [(google.api.field_behavior) = OPTIONAL]; // Optional. Number of attached SSDs, from 0 to 4 (default is 0). // If SSDs are not attached, the boot disk is used to store runtime logs and @@ -367,20 +449,23 @@ message DiskConfig { // If one or more SSDs are attached, this runtime bulk // data is spread across them, and the boot disk contains only basic // config and installed binaries. - int32 num_local_ssds = 2; + int32 num_local_ssds = 2 [(google.api.field_behavior) = OPTIONAL]; } // Specifies an executable to run on a fully configured node and a // timeout period for executable completion. message NodeInitializationAction { // Required. Cloud Storage URI of executable file. - string executable_file = 1; + string executable_file = 1 [(google.api.field_behavior) = REQUIRED]; // Optional. Amount of time executable has to complete. Default is - // 10 minutes. Cluster creation fails with an explanatory error message (the + // 10 minutes (see JSON representation of + // [Duration](https://developers.google.com/protocol-buffers/docs/proto3#json)). + // + // Cluster creation fails with an explanatory error message (the // name of the executable that caused the error and the exceeded timeout // period) if the executable is not completed at end of the timeout period. - google.protobuf.Duration execution_timeout = 2; + google.protobuf.Duration execution_timeout = 2 [(google.api.field_behavior) = OPTIONAL]; } // The status of a cluster and its instances. @@ -419,36 +504,116 @@ message ClusterStatus { UNHEALTHY = 1; // The agent-reported status is out of date (may occur if - // Cloud Dataproc loses communication with Agent). + // Dataproc loses communication with Agent). // // Applies to RUNNING state. STALE_STATUS = 2; } // Output only. The cluster's state. - State state = 1; + State state = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Output only. Optional details of cluster's state. - string detail = 2; + // Optional. Output only. Details of cluster's state. + string detail = 2 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.field_behavior) = OPTIONAL + ]; - // Output only. Time when this state was entered. - google.protobuf.Timestamp state_start_time = 3; + // Output only. Time when this state was entered (see JSON representation of + // [Timestamp](https://developers.google.com/protocol-buffers/docs/proto3#json)). + google.protobuf.Timestamp state_start_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Additional state information that includes // status reported by the agent. - Substate substate = 4; + Substate substate = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// Security related configuration, including Kerberos. +message SecurityConfig { + // Kerberos related configuration. + KerberosConfig kerberos_config = 1; +} + +// Specifies Kerberos related configuration. +message KerberosConfig { + // Optional. Flag to indicate whether to Kerberize the cluster (default: false). Set + // this field to true to enable Kerberos on a cluster. + bool enable_kerberos = 1 [(google.api.field_behavior) = OPTIONAL]; + + // Required. The Cloud Storage URI of a KMS encrypted file containing the root + // principal password. + string root_principal_password_uri = 2 [(google.api.field_behavior) = REQUIRED]; + + // Required. The uri of the KMS key used to encrypt various sensitive + // files. + string kms_key_uri = 3 [(google.api.field_behavior) = REQUIRED]; + + // Optional. The Cloud Storage URI of the keystore file used for SSL + // encryption. If not provided, Dataproc will provide a self-signed + // certificate. + string keystore_uri = 4 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The Cloud Storage URI of the truststore file used for SSL + // encryption. If not provided, Dataproc will provide a self-signed + // certificate. + string truststore_uri = 5 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The Cloud Storage URI of a KMS encrypted file containing the + // password to the user provided keystore. For the self-signed certificate, + // this password is generated by Dataproc. + string keystore_password_uri = 6 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The Cloud Storage URI of a KMS encrypted file containing the + // password to the user provided key. For the self-signed certificate, this + // password is generated by Dataproc. + string key_password_uri = 7 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The Cloud Storage URI of a KMS encrypted file containing the + // password to the user provided truststore. For the self-signed certificate, + // this password is generated by Dataproc. + string truststore_password_uri = 8 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The remote realm the Dataproc on-cluster KDC will trust, should + // the user enable cross realm trust. + string cross_realm_trust_realm = 9 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The KDC (IP or hostname) for the remote trusted realm in a cross + // realm trust relationship. + string cross_realm_trust_kdc = 10 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The admin server (IP or hostname) for the remote trusted realm in + // a cross realm trust relationship. + string cross_realm_trust_admin_server = 11 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The Cloud Storage URI of a KMS encrypted file containing the + // shared password between the on-cluster Kerberos realm and the remote + // trusted realm, in a cross realm trust relationship. + string cross_realm_trust_shared_password_uri = 12 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The Cloud Storage URI of a KMS encrypted file containing the + // master key of the KDC database. + string kdc_db_key_uri = 13 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The lifetime of the ticket granting ticket, in hours. + // If not specified, or user specifies 0, then default value 10 + // will be used. + int32 tgt_lifetime_hours = 14 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The name of the on-cluster Kerberos realm. + // If not specified, the uppercased domain of hostnames will be the realm. + string realm = 15 [(google.api.field_behavior) = OPTIONAL]; } // Specifies the selection and config of software inside the cluster. message SoftwareConfig { // Optional. The version of software inside the cluster. It must be one of the - // supported [Cloud Dataproc - // Versions](/dataproc/docs/concepts/versioning/dataproc-versions#supported_cloud_dataproc_versions), + // supported [Dataproc + // Versions](https://cloud.google.com/dataproc/docs/concepts/versioning/dataproc-versions#supported_cloud_dataproc_versions), // such as "1.2" (including a subminor version, such as "1.2.29"), or the // ["preview" - // version](/dataproc/docs/concepts/versioning/dataproc-versions#other_versions). + // version](https://cloud.google.com/dataproc/docs/concepts/versioning/dataproc-versions#other_versions). // If unspecified, it defaults to the latest Debian version. - string image_version = 1; + string image_version = 1 [(google.api.field_behavior) = OPTIONAL]; // Optional. The properties to set on daemon config files. // @@ -466,12 +631,42 @@ message SoftwareConfig { // * spark: `spark-defaults.conf` // * yarn: `yarn-site.xml` // - // For more information, see - // [Cluster properties](/dataproc/docs/concepts/cluster-properties). - map properties = 2; + // For more information, see [Cluster + // properties](https://cloud.google.com/dataproc/docs/concepts/cluster-properties). + map properties = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The set of components to activate on the cluster. + repeated Component optional_components = 3 [(google.api.field_behavior) = OPTIONAL]; +} + +// Specifies the cluster auto-delete schedule configuration. +message LifecycleConfig { + // Optional. The duration to keep the cluster alive while idling (when no jobs + // are running). Passing this threshold will cause the cluster to be + // deleted. Minimum value is 10 minutes; maximum value is 14 days (see JSON + // representation of + // [Duration](https://developers.google.com/protocol-buffers/docs/proto3#json). + google.protobuf.Duration idle_delete_ttl = 1 [(google.api.field_behavior) = OPTIONAL]; + + // Either the exact time the cluster should be deleted at or + // the cluster maximum age. + oneof ttl { + // Optional. The time when cluster will be auto-deleted (see JSON representation of + // [Timestamp](https://developers.google.com/protocol-buffers/docs/proto3#json)). + google.protobuf.Timestamp auto_delete_time = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The lifetime duration of cluster. The cluster will be + // auto-deleted at the end of this period. Minimum value is 10 minutes; + // maximum value is 14 days (see JSON representation of + // [Duration](https://developers.google.com/protocol-buffers/docs/proto3#json)). + google.protobuf.Duration auto_delete_ttl = 3 [(google.api.field_behavior) = OPTIONAL]; + } - // The set of optional components to activate on the cluster. - repeated Component optional_components = 3; + // Output only. The time when cluster became idle (most recent job finished) + // and became eligible for deletion due to idleness (see JSON representation + // of + // [Timestamp](https://developers.google.com/protocol-buffers/docs/proto3#json)). + google.protobuf.Timestamp idle_start_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Contains cluster daemon metrics, such as HDFS and YARN stats. @@ -490,13 +685,13 @@ message ClusterMetrics { message CreateClusterRequest { // Required. The ID of the Google Cloud Platform project that the cluster // belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The Cloud Dataproc region in which to handle the request. - string region = 3; + // Required. The Dataproc region in which to handle the request. + string region = 3 [(google.api.field_behavior) = REQUIRED]; // Required. The cluster to create. - Cluster cluster = 2; + Cluster cluster = 2 [(google.api.field_behavior) = REQUIRED]; // Optional. A unique id used to identify the request. If the server // receives two [CreateClusterRequest][google.cloud.dataproc.v1.CreateClusterRequest] requests with the same @@ -509,33 +704,34 @@ message CreateClusterRequest { // // The id must contain only letters (a-z, A-Z), numbers (0-9), // underscores (_), and hyphens (-). The maximum length is 40 characters. - string request_id = 4; + string request_id = 4 [(google.api.field_behavior) = OPTIONAL]; } // A request to update a cluster. message UpdateClusterRequest { // Required. The ID of the Google Cloud Platform project the // cluster belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The Cloud Dataproc region in which to handle the request. - string region = 5; + // Required. The Dataproc region in which to handle the request. + string region = 5 [(google.api.field_behavior) = REQUIRED]; // Required. The cluster name. - string cluster_name = 2; + string cluster_name = 2 [(google.api.field_behavior) = REQUIRED]; // Required. The changes to the cluster. - Cluster cluster = 3; + Cluster cluster = 3 [(google.api.field_behavior) = REQUIRED]; // Optional. Timeout for graceful YARN decomissioning. Graceful // decommissioning allows removing nodes from the cluster without // interrupting jobs in progress. Timeout specifies how long to wait for jobs // in progress to finish before forcefully removing nodes (and potentially // interrupting jobs). Default timeout is 0 (for forceful decommission), and - // the maximum allowed timeout is 1 day. + // the maximum allowed timeout is 1 day. (see JSON representation of + // [Duration](https://developers.google.com/protocol-buffers/docs/proto3#json)). // // Only supported on Dataproc image versions 1.2 and higher. - google.protobuf.Duration graceful_decommission_timeout = 6; + google.protobuf.Duration graceful_decommission_timeout = 6 [(google.api.field_behavior) = OPTIONAL]; // Required. Specifies the path, relative to `Cluster`, of // the field to update. For example, to change the number of workers @@ -582,9 +778,13 @@ message UpdateClusterRequest { //
// // + // + // + // // //
config.secondary_worker_config.num_instancesResize secondary worker group
config.autoscaling_config.policy_uriUse, stop using, or + // change autoscaling policies
- google.protobuf.FieldMask update_mask = 4; + google.protobuf.FieldMask update_mask = 4 [(google.api.field_behavior) = REQUIRED]; // Optional. A unique id used to identify the request. If the server // receives two [UpdateClusterRequest][google.cloud.dataproc.v1.UpdateClusterRequest] requests with the same @@ -597,24 +797,24 @@ message UpdateClusterRequest { // // The id must contain only letters (a-z, A-Z), numbers (0-9), // underscores (_), and hyphens (-). The maximum length is 40 characters. - string request_id = 7; + string request_id = 7 [(google.api.field_behavior) = OPTIONAL]; } // A request to delete a cluster. message DeleteClusterRequest { // Required. The ID of the Google Cloud Platform project that the cluster // belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The Cloud Dataproc region in which to handle the request. - string region = 3; + // Required. The Dataproc region in which to handle the request. + string region = 3 [(google.api.field_behavior) = REQUIRED]; // Required. The cluster name. - string cluster_name = 2; + string cluster_name = 2 [(google.api.field_behavior) = REQUIRED]; // Optional. Specifying the `cluster_uuid` means the RPC should fail // (with error NOT_FOUND) if cluster with specified UUID does not exist. - string cluster_uuid = 4; + string cluster_uuid = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. A unique id used to identify the request. If the server // receives two [DeleteClusterRequest][google.cloud.dataproc.v1.DeleteClusterRequest] requests with the same @@ -627,30 +827,30 @@ message DeleteClusterRequest { // // The id must contain only letters (a-z, A-Z), numbers (0-9), // underscores (_), and hyphens (-). The maximum length is 40 characters. - string request_id = 5; + string request_id = 5 [(google.api.field_behavior) = OPTIONAL]; } // Request to get the resource representation for a cluster in a project. message GetClusterRequest { // Required. The ID of the Google Cloud Platform project that the cluster // belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The Cloud Dataproc region in which to handle the request. - string region = 3; + // Required. The Dataproc region in which to handle the request. + string region = 3 [(google.api.field_behavior) = REQUIRED]; // Required. The cluster name. - string cluster_name = 2; + string cluster_name = 2 [(google.api.field_behavior) = REQUIRED]; } // A request to list the clusters in a project. message ListClustersRequest { // Required. The ID of the Google Cloud Platform project that the cluster // belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The Cloud Dataproc region in which to handle the request. - string region = 4; + // Required. The Dataproc region in which to handle the request. + string region = 4 [(google.api.field_behavior) = REQUIRED]; // Optional. A filter constraining the clusters to list. Filters are // case-sensitive and have the following syntax: @@ -671,37 +871,37 @@ message ListClustersRequest { // // status.state = ACTIVE AND clusterName = mycluster // AND labels.env = staging AND labels.starred = * - string filter = 5; + string filter = 5 [(google.api.field_behavior) = OPTIONAL]; // Optional. The standard List page size. - int32 page_size = 2; + int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. The standard List page token. - string page_token = 3; + string page_token = 3 [(google.api.field_behavior) = OPTIONAL]; } // The list of all clusters in a project. message ListClustersResponse { // Output only. The clusters in the project. - repeated Cluster clusters = 1; + repeated Cluster clusters = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. This token is included in the response if there are more // results to fetch. To fetch additional results, provide this value as the // `page_token` in a subsequent `ListClustersRequest`. - string next_page_token = 2; + string next_page_token = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } // A request to collect cluster diagnostic information. message DiagnoseClusterRequest { // Required. The ID of the Google Cloud Platform project that the cluster // belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The Cloud Dataproc region in which to handle the request. - string region = 3; + // Required. The Dataproc region in which to handle the request. + string region = 3 [(google.api.field_behavior) = REQUIRED]; // Required. The cluster name. - string cluster_name = 2; + string cluster_name = 2 [(google.api.field_behavior) = REQUIRED]; } // The location of diagnostic output. @@ -709,5 +909,32 @@ message DiagnoseClusterResults { // Output only. The Cloud Storage URI of the diagnostic output. // The output report is a plain text file with a summary of collected // diagnostics. - string output_uri = 1; + string output_uri = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// Reservation Affinity for consuming Zonal reservation. +message ReservationAffinity { + // Indicates whether to consume capacity from an reservation or not. + enum Type { + TYPE_UNSPECIFIED = 0; + + // Do not consume from any allocated capacity. + NO_RESERVATION = 1; + + // Consume any reservation available. + ANY_RESERVATION = 2; + + // Must consume from a specific reservation. Must specify key value fields + // for specifying the reservations. + SPECIFIC_RESERVATION = 3; + } + + // Optional. Type of reservation to consume + Type consume_reservation_type = 1 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Corresponds to the label key of reservation resource. + string key = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Corresponds to the label values of reservation resource. + repeated string values = 3 [(google.api.field_behavior) = OPTIONAL]; } diff --git a/third_party/googleapis/google/cloud/dataproc/v1/dataproc.yaml b/third_party/googleapis/google/cloud/dataproc/v1/dataproc.yaml index e6d36de27..75726da18 100644 --- a/third_party/googleapis/google/cloud/dataproc/v1/dataproc.yaml +++ b/third_party/googleapis/google/cloud/dataproc/v1/dataproc.yaml @@ -7,6 +7,7 @@ apis: - name: google.cloud.dataproc.v1.ClusterController - name: google.cloud.dataproc.v1.JobController - name: google.cloud.dataproc.v1.WorkflowTemplateService +- name: google.cloud.dataproc.v1.AutoscalingPolicyService types: - name: google.cloud.dataproc.v1.DiagnoseClusterResults diff --git a/third_party/googleapis/google/cloud/dataproc/v1/dataproc_gapic.legacy.yaml b/third_party/googleapis/google/cloud/dataproc/v1/dataproc_gapic.legacy.yaml new file mode 100644 index 000000000..63811e63b --- /dev/null +++ b/third_party/googleapis/google/cloud/dataproc/v1/dataproc_gapic.legacy.yaml @@ -0,0 +1,778 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 1.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.dataproc.v1 + python: + package_name: google.cloud.dataproc_v1.gapic + go: + package_name: cloud.google.com/go/dataproc/apiv1 + csharp: + package_name: Google.Cloud.Dataproc.V1 + ruby: + package_name: Google::Cloud::Dataproc::V1 + php: + package_name: Google\Cloud\Dataproc\V1 + nodejs: + package_name: dataproc.v1 + domain_layer_location: google-cloud +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.cloud.dataproc.v1.AutoscalingPolicyService + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: + - name_pattern: projects/{project}/regions/{region} + entity_name: region + - name_pattern: projects/{project}/regions/{region}/autoscalingPolicies/{autoscaling_policy} + entity_name: autoscaling_policy + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - DEADLINE_EXCEEDED + - UNAVAILABLE + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # + # name - The simple name of the method. + # + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce method + # overloads which allow a client to directly pass request message fields as + # method parameters. This information may or may not be used, depending on + # the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request message. + # + # required_fields - Fields that are always required for a request to be + # valid. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a paging + # list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It defines + # which fields match the paging pattern in the request. The request consists + # of a page_size_field and a token_field. The page_size_field is the name of + # the optional field specifying the maximum number of elements to be + # returned in the response. The token_field is the name of the field in the + # request containing the page token. + # The response specifies response information of the list method. It defines + # which fields match the paging pattern in the response. The response + # consists of a token_field and a resources_field. The token_field is the + # name of the field in the response containing the next page token. The + # resources_field is the name of the field in the response containing the + # list of resources belonging to the page. + # + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: CreateAutoscalingPolicy + flattening: + groups: + - parameters: + - parent + - policy + required_fields: + - parent + - policy + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: region + timeout_millis: 60000 + - name: UpdateAutoscalingPolicy + flattening: + groups: + - parameters: + - policy + required_fields: + - policy + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + policy.name: autoscaling_policy + timeout_millis: 60000 + - name: GetAutoscalingPolicy + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: autoscaling_policy + timeout_millis: 60000 + - name: ListAutoscalingPolicies + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: policies + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: region + timeout_millis: 60000 + - name: DeleteAutoscalingPolicy + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: autoscaling_policy + timeout_millis: 60000 +- name: google.cloud.dataproc.v1.ClusterController + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: [] + # Definition for smoke test. + smoke_test: + method: ListClusters + init_fields: + - project_id=$PROJECT_ID + - region="global" + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - INTERNAL + - DEADLINE_EXCEEDED + - UNAVAILABLE + - name: non_idempotent + retry_codes: + - UNAVAILABLE + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 10000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 10000 + total_timeout_millis: 300000 + # A list of method configurations. + # Common properties: + # + # name - The simple name of the method. + # + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce method + # overloads which allow a client to directly pass request message fields as + # method parameters. This information may or may not be used, depending on + # the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request message. + # + # required_fields - Fields that are always required for a request to be + # valid. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a paging + # list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It defines + # which fields match the paging pattern in the request. The request consists + # of a page_size_field and a token_field. The page_size_field is the name of + # the optional field specifying the maximum number of elements to be + # returned in the response. The token_field is the name of the field in the + # request containing the page token. + # The response specifies response information of the list method. It defines + # which fields match the paging pattern in the response. The response + # consists of a token_field and a resources_field. The token_field is the + # name of the field in the response containing the next page token. The + # resources_field is the name of the field in the response containing the + # list of resources belonging to the page. + # + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: CreateCluster + flattening: + groups: + - parameters: + - project_id + - region + - cluster + required_fields: + - project_id + - region + - cluster + retry_codes_name: non_idempotent + retry_params_name: default + timeout_millis: 30000 + long_running: + return_type: google.cloud.dataproc.v1.Cluster + metadata_type: google.cloud.dataproc.v1.ClusterOperationMetadata + implements_delete: false + implements_cancel: false + initial_poll_delay_millis: 1000 + poll_delay_multiplier: 2 + max_poll_delay_millis: 10000 + total_poll_timeout_millis: 900000 + - name: UpdateCluster + flattening: + groups: + - parameters: + - project_id + - region + - cluster_name + - cluster + - update_mask + required_fields: + - project_id + - region + - cluster_name + - cluster + - update_mask + retry_codes_name: non_idempotent + retry_params_name: default + timeout_millis: 30000 + long_running: + return_type: google.cloud.dataproc.v1.Cluster + metadata_type: google.cloud.dataproc.v1.ClusterOperationMetadata + implements_delete: false + implements_cancel: false + initial_poll_delay_millis: 1000 + poll_delay_multiplier: 2 + max_poll_delay_millis: 10000 + total_poll_timeout_millis: 900000 + - name: DeleteCluster + flattening: + groups: + - parameters: + - project_id + - region + - cluster_name + required_fields: + - project_id + - region + - cluster_name + retry_codes_name: non_idempotent + retry_params_name: default + timeout_millis: 30000 + long_running: + return_type: google.protobuf.Empty + metadata_type: google.cloud.dataproc.v1.ClusterOperationMetadata + implements_delete: false + implements_cancel: false + initial_poll_delay_millis: 1000 + poll_delay_multiplier: 2 + max_poll_delay_millis: 10000 + total_poll_timeout_millis: 900000 + - name: GetCluster + flattening: + groups: + - parameters: + - project_id + - region + - cluster_name + required_fields: + - project_id + - region + - cluster_name + retry_codes_name: idempotent + retry_params_name: default + timeout_millis: 60000 + - name: ListClusters + flattening: + groups: + - parameters: + - project_id + - region + - parameters: + - project_id + - region + - filter + required_fields: + - project_id + - region + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: clusters + retry_codes_name: idempotent + retry_params_name: default + timeout_millis: 60000 + - name: DiagnoseCluster + flattening: + groups: + - parameters: + - project_id + - region + - cluster_name + required_fields: + - project_id + - region + - cluster_name + retry_codes_name: non_idempotent + retry_params_name: default + timeout_millis: 60000 + long_running: + return_type: google.protobuf.Empty + metadata_type: google.cloud.dataproc.v1.DiagnoseClusterResults + implements_delete: false + implements_cancel: false + initial_poll_delay_millis: 1000 + poll_delay_multiplier: 2 + max_poll_delay_millis: 10000 + total_poll_timeout_millis: 30000 + # The fully qualified name of the API interface. +- name: google.cloud.dataproc.v1.JobController + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: [] + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - DEADLINE_EXCEEDED + - INTERNAL + - UNAVAILABLE + - name: non_idempotent + retry_codes: + - UNAVAILABLE + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 30000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 30000 + total_timeout_millis: 900000 + # A list of method configurations. + # Common properties: + # + # name - The simple name of the method. + # + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce method + # overloads which allow a client to directly pass request message fields as + # method parameters. This information may or may not be used, depending on + # the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request message. + # + # required_fields - Fields that are always required for a request to be + # valid. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a paging + # list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It defines + # which fields match the paging pattern in the request. The request consists + # of a page_size_field and a token_field. The page_size_field is the name of + # the optional field specifying the maximum number of elements to be + # returned in the response. The token_field is the name of the field in the + # request containing the page token. + # The response specifies response information of the list method. It defines + # which fields match the paging pattern in the response. The response + # consists of a token_field and a resources_field. The token_field is the + # name of the field in the response containing the next page token. The + # resources_field is the name of the field in the response containing the + # list of resources belonging to the page. + # + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: SubmitJob + flattening: + groups: + - parameters: + - project_id + - region + - job + required_fields: + - project_id + - region + - job + retry_codes_name: non_idempotent + retry_params_name: default + timeout_millis: 30000 + - name: GetJob + flattening: + groups: + - parameters: + - project_id + - region + - job_id + required_fields: + - project_id + - region + - job_id + retry_codes_name: idempotent + retry_params_name: default + timeout_millis: 30000 + - name: ListJobs + flattening: + groups: + - parameters: + - project_id + - region + - parameters: + - project_id + - region + - filter + required_fields: + - project_id + - region + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: jobs + retry_codes_name: idempotent + retry_params_name: default + timeout_millis: 30000 + - name: UpdateJob + required_fields: + - project_id + - region + - job_id + - job + - update_mask + retry_codes_name: non_idempotent + retry_params_name: default + timeout_millis: 30000 + - name: CancelJob + flattening: + groups: + - parameters: + - project_id + - region + - job_id + required_fields: + - project_id + - region + - job_id + retry_codes_name: idempotent + retry_params_name: default + timeout_millis: 30000 + - name: DeleteJob + flattening: + groups: + - parameters: + - project_id + - region + - job_id + required_fields: + - project_id + - region + - job_id + retry_codes_name: non_idempotent + retry_params_name: default + timeout_millis: 30000 + # The fully qualified name of the API interface. +- name: google.cloud.dataproc.v1.WorkflowTemplateService + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: + - name_pattern: projects/{project}/regions/{region} + entity_name: region + - name_pattern: projects/{project}/regions/{region}/workflowTemplates/{workflow_template} + entity_name: workflow_template + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - DEADLINE_EXCEEDED + - INTERNAL + - UNAVAILABLE + - name: non_idempotent + retry_codes: + - UNAVAILABLE + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # + # name - The simple name of the method. + # + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce method + # overloads which allow a client to directly pass request message fields as + # method parameters. This information may or may not be used, depending on + # the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request message. + # + # required_fields - Fields that are always required for a request to be + # valid. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a paging + # list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It defines + # which fields match the paging pattern in the request. The request consists + # of a page_size_field and a token_field. The page_size_field is the name of + # the optional field specifying the maximum number of elements to be + # returned in the response. The token_field is the name of the field in the + # request containing the page token. + # The response specifies response information of the list method. It defines + # which fields match the paging pattern in the response. The response + # consists of a token_field and a resources_field. The token_field is the + # name of the field in the response containing the next page token. The + # resources_field is the name of the field in the response containing the + # list of resources belonging to the page. + # + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: CreateWorkflowTemplate + flattening: + groups: + - parameters: + - parent + - template + required_fields: + - parent + - template + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: region + timeout_millis: 30000 + - name: GetWorkflowTemplate + # params. + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: workflow_template + timeout_millis: 60000 + - name: InstantiateWorkflowTemplate + flattening: + groups: + - parameters: + - name + - parameters: + - name + - parameters + required_fields: + - name + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: workflow_template + timeout_millis: 60000 + long_running: + return_type: google.protobuf.Empty + metadata_type: google.cloud.dataproc.v1.WorkflowMetadata + implements_delete: false + implements_cancel: false + initial_poll_delay_millis: 1000 + poll_delay_multiplier: 2 + max_poll_delay_millis: 10000 + total_poll_timeout_millis: 43200000 + - name: InstantiateInlineWorkflowTemplate + flattening: + groups: + - parameters: + - parent + - template + required_fields: + - parent + - template + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: region + timeout_millis: 60000 + long_running: + return_type: google.protobuf.Empty + metadata_type: google.cloud.dataproc.v1.WorkflowMetadata + implements_delete: false + implements_cancel: false + initial_poll_delay_millis: 1000 + poll_delay_multiplier: 2 + max_poll_delay_millis: 10000 + total_poll_timeout_millis: 43200000 + - name: UpdateWorkflowTemplate + flattening: + groups: + - parameters: + - template + required_fields: + - template + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + template.name: workflow_template + timeout_millis: 60000 + - name: ListWorkflowTemplates + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: templates + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: region + timeout_millis: 60000 + - name: DeleteWorkflowTemplate + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + name: workflow_template + timeout_millis: 60000 +resource_name_generation: +- message_name: WorkflowTemplate + field_entity_map: + name: workflow_template +- message_name: CreateWorkflowTemplateRequest + field_entity_map: + parent: region +- message_name: GetWorkflowTemplateRequest + field_entity_map: + name: workflow_template +- message_name: InstantiateWorkflowTemplateRequest + field_entity_map: + name: workflow_template +- message_name: InstantiateInlineWorkflowTemplateRequest + field_entity_map: + parent: region +- message_name: ListWorkflowTemplatesRequest + field_entity_map: + parent: region +- message_name: DeleteWorkflowTemplateRequest + field_entity_map: + name: workflow_template diff --git a/third_party/googleapis/google/cloud/dataproc/v1/dataproc_gapic.yaml b/third_party/googleapis/google/cloud/dataproc/v1/dataproc_gapic.yaml index 870972830..57861c84c 100644 --- a/third_party/googleapis/google/cloud/dataproc/v1/dataproc_gapic.yaml +++ b/third_party/googleapis/google/cloud/dataproc/v1/dataproc_gapic.yaml @@ -1,6 +1,5 @@ type: com.google.api.codegen.ConfigProto -config_schema_version: 1.0.0 -# The settings of generated code in a specific language. +config_schema_version: 2.0.0 language_settings: java: package_name: com.google.cloud.dataproc.v1 @@ -17,28 +16,17 @@ language_settings: nodejs: package_name: dataproc.v1 domain_layer_location: google-cloud -# A list of API interface configurations. interfaces: -# The fully qualified name of the API interface. +- name: google.cloud.dataproc.v1.AutoscalingPolicyService + methods: + - name: UpdateAutoscalingPolicy + retry_codes_name: idempotent - name: google.cloud.dataproc.v1.ClusterController - # A list of resource collection configurations. - # Consists of a name_pattern and an entity_name. - # The name_pattern is a pattern to describe the names of the resources of this - # collection, using the platform's conventions for URI patterns. A generator - # may use this to generate methods to compose and decompose such names. The - # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; - # those will be taken as hints for the parameter names of the generated - # methods. If empty, no name methods are generated. - # The entity_name is the name to be used as a basis for generated methods and - # classes. - collections: [] - # Definition for smoke test. smoke_test: method: ListClusters init_fields: - project_id=$PROJECT_ID - region="global" - # Definition for retryable codes. retry_codes_def: - name: idempotent retry_codes: @@ -48,7 +36,6 @@ interfaces: - name: non_idempotent retry_codes: - UNAVAILABLE - # Definition for retry/backoff parameters. retry_params_def: - name: default initial_retry_delay_millis: 100 @@ -58,199 +45,20 @@ interfaces: rpc_timeout_multiplier: 1 max_rpc_timeout_millis: 10000 total_timeout_millis: 300000 - # A list of method configurations. - # Common properties: - # - # name - The simple name of the method. - # - # flattening - Specifies the configuration for parameter flattening. - # Describes the parameter groups for which a generator should produce method - # overloads which allow a client to directly pass request message fields as - # method parameters. This information may or may not be used, depending on - # the target language. - # Consists of groups, which each represent a list of parameters to be - # flattened. Each parameter listed must be a field of the request message. - # - # required_fields - Fields that are always required for a request to be - # valid. - # - # page_streaming - Specifies the configuration for paging. - # Describes information for generating a method which transforms a paging - # list RPC into a stream of resources. - # Consists of a request and a response. - # The request specifies request information of the list method. It defines - # which fields match the paging pattern in the request. The request consists - # of a page_size_field and a token_field. The page_size_field is the name of - # the optional field specifying the maximum number of elements to be - # returned in the response. The token_field is the name of the field in the - # request containing the page token. - # The response specifies response information of the list method. It defines - # which fields match the paging pattern in the response. The response - # consists of a token_field and a resources_field. The token_field is the - # name of the field in the response containing the next page token. The - # resources_field is the name of the field in the response containing the - # list of resources belonging to the page. - # - # retry_codes_name - Specifies the configuration for retryable codes. The - # name must be defined in interfaces.retry_codes_def. - # - # retry_params_name - Specifies the configuration for retry/backoff - # parameters. The name must be defined in interfaces.retry_params_def. - # - # field_name_patterns - Maps the field name of the request type to - # entity_name of interfaces.collections. - # Specifies the string pattern that the field must follow. - # - # timeout_millis - Specifies the default timeout for a non-retrying call. If - # the call is retrying, refer to retry_params_name instead. methods: - name: CreateCluster - flattening: - groups: - - parameters: - - project_id - - region - - cluster - required_fields: - - project_id - - region - - cluster retry_codes_name: non_idempotent - retry_params_name: default - timeout_millis: 30000 - long_running: - return_type: google.cloud.dataproc.v1.Cluster - metadata_type: google.cloud.dataproc.v1.ClusterOperationMetadata - implements_delete: false - implements_cancel: false - initial_poll_delay_millis: 1000 - poll_delay_multiplier: 2 - max_poll_delay_millis: 10000 - total_poll_timeout_millis: 900000 - name: UpdateCluster - flattening: - groups: - - parameters: - - project_id - - region - - cluster_name - - cluster - - update_mask - required_fields: - - project_id - - region - - cluster_name - - cluster - - update_mask retry_codes_name: non_idempotent - retry_params_name: default - timeout_millis: 30000 - long_running: - return_type: google.cloud.dataproc.v1.Cluster - metadata_type: google.cloud.dataproc.v1.ClusterOperationMetadata - implements_delete: false - implements_cancel: false - initial_poll_delay_millis: 1000 - poll_delay_multiplier: 2 - max_poll_delay_millis: 10000 - total_poll_timeout_millis: 900000 - name: DeleteCluster - flattening: - groups: - - parameters: - - project_id - - region - - cluster_name - required_fields: - - project_id - - region - - cluster_name retry_codes_name: non_idempotent - retry_params_name: default - timeout_millis: 30000 - long_running: - return_type: google.protobuf.Empty - metadata_type: google.cloud.dataproc.v1.ClusterOperationMetadata - implements_delete: false - implements_cancel: false - initial_poll_delay_millis: 1000 - poll_delay_multiplier: 2 - max_poll_delay_millis: 10000 - total_poll_timeout_millis: 900000 - name: GetCluster - flattening: - groups: - - parameters: - - project_id - - region - - cluster_name - required_fields: - - project_id - - region - - cluster_name retry_codes_name: idempotent - retry_params_name: default - timeout_millis: 60000 - name: ListClusters - flattening: - groups: - - parameters: - - project_id - - region - - parameters: - - project_id - - region - - filter - required_fields: - - project_id - - region - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: clusters retry_codes_name: idempotent - retry_params_name: default - timeout_millis: 60000 - name: DiagnoseCluster - flattening: - groups: - - parameters: - - project_id - - region - - cluster_name - required_fields: - - project_id - - region - - cluster_name retry_codes_name: non_idempotent - retry_params_name: default - timeout_millis: 60000 - long_running: - return_type: google.protobuf.Empty - metadata_type: google.cloud.dataproc.v1.DiagnoseClusterResults - implements_delete: false - implements_cancel: false - initial_poll_delay_millis: 1000 - poll_delay_multiplier: 2 - max_poll_delay_millis: 10000 - total_poll_timeout_millis: 30000 - # The fully qualified name of the API interface. - name: google.cloud.dataproc.v1.JobController - # A list of resource collection configurations. - # Consists of a name_pattern and an entity_name. - # The name_pattern is a pattern to describe the names of the resources of this - # collection, using the platform's conventions for URI patterns. A generator - # may use this to generate methods to compose and decompose such names. The - # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; - # those will be taken as hints for the parameter names of the generated - # methods. If empty, no name methods are generated. - # The entity_name is the name to be used as a basis for generated methods and - # classes. - collections: [] - # Definition for retryable codes. retry_codes_def: - name: idempotent retry_codes: @@ -260,7 +68,6 @@ interfaces: - name: non_idempotent retry_codes: - UNAVAILABLE - # Definition for retry/backoff parameters. retry_params_def: - name: default initial_retry_delay_millis: 100 @@ -270,159 +77,20 @@ interfaces: rpc_timeout_multiplier: 1 max_rpc_timeout_millis: 30000 total_timeout_millis: 900000 - # A list of method configurations. - # Common properties: - # - # name - The simple name of the method. - # - # flattening - Specifies the configuration for parameter flattening. - # Describes the parameter groups for which a generator should produce method - # overloads which allow a client to directly pass request message fields as - # method parameters. This information may or may not be used, depending on - # the target language. - # Consists of groups, which each represent a list of parameters to be - # flattened. Each parameter listed must be a field of the request message. - # - # required_fields - Fields that are always required for a request to be - # valid. - # - # page_streaming - Specifies the configuration for paging. - # Describes information for generating a method which transforms a paging - # list RPC into a stream of resources. - # Consists of a request and a response. - # The request specifies request information of the list method. It defines - # which fields match the paging pattern in the request. The request consists - # of a page_size_field and a token_field. The page_size_field is the name of - # the optional field specifying the maximum number of elements to be - # returned in the response. The token_field is the name of the field in the - # request containing the page token. - # The response specifies response information of the list method. It defines - # which fields match the paging pattern in the response. The response - # consists of a token_field and a resources_field. The token_field is the - # name of the field in the response containing the next page token. The - # resources_field is the name of the field in the response containing the - # list of resources belonging to the page. - # - # retry_codes_name - Specifies the configuration for retryable codes. The - # name must be defined in interfaces.retry_codes_def. - # - # retry_params_name - Specifies the configuration for retry/backoff - # parameters. The name must be defined in interfaces.retry_params_def. - # - # field_name_patterns - Maps the field name of the request type to - # entity_name of interfaces.collections. - # Specifies the string pattern that the field must follow. - # - # timeout_millis - Specifies the default timeout for a non-retrying call. If - # the call is retrying, refer to retry_params_name instead. methods: - name: SubmitJob - flattening: - groups: - - parameters: - - project_id - - region - - job - required_fields: - - project_id - - region - - job retry_codes_name: non_idempotent - retry_params_name: default - timeout_millis: 30000 - name: GetJob - flattening: - groups: - - parameters: - - project_id - - region - - job_id - required_fields: - - project_id - - region - - job_id retry_codes_name: idempotent - retry_params_name: default - timeout_millis: 30000 - name: ListJobs - flattening: - groups: - - parameters: - - project_id - - region - - parameters: - - project_id - - region - - filter - required_fields: - - project_id - - region - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: jobs retry_codes_name: idempotent - retry_params_name: default - timeout_millis: 30000 - name: UpdateJob - required_fields: - - project_id - - region - - job_id - - job - - update_mask retry_codes_name: non_idempotent - retry_params_name: default - timeout_millis: 30000 - name: CancelJob - flattening: - groups: - - parameters: - - project_id - - region - - job_id - required_fields: - - project_id - - region - - job_id retry_codes_name: idempotent - retry_params_name: default - timeout_millis: 30000 - name: DeleteJob - flattening: - groups: - - parameters: - - project_id - - region - - job_id - required_fields: - - project_id - - region - - job_id retry_codes_name: non_idempotent - retry_params_name: default - timeout_millis: 30000 - # The fully qualified name of the API interface. - name: google.cloud.dataproc.v1.WorkflowTemplateService - # A list of resource collection configurations. - # Consists of a name_pattern and an entity_name. - # The name_pattern is a pattern to describe the names of the resources of this - # collection, using the platform's conventions for URI patterns. A generator - # may use this to generate methods to compose and decompose such names. The - # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; - # those will be taken as hints for the parameter names of the generated - # methods. If empty, no name methods are generated. - # The entity_name is the name to be used as a basis for generated methods and - # classes. - collections: - - name_pattern: projects/{project}/regions/{region} - entity_name: region - - name_pattern: projects/{project}/regions/{region}/workflowTemplates/{workflow_template} - entity_name: workflow_template - # Definition for retryable codes. retry_codes_def: - name: idempotent retry_codes: @@ -432,198 +100,18 @@ interfaces: - name: non_idempotent retry_codes: - UNAVAILABLE - # Definition for retry/backoff parameters. - retry_params_def: - - name: default - initial_retry_delay_millis: 100 - retry_delay_multiplier: 1.3 - max_retry_delay_millis: 60000 - initial_rpc_timeout_millis: 20000 - rpc_timeout_multiplier: 1 - max_rpc_timeout_millis: 20000 - total_timeout_millis: 600000 - # A list of method configurations. - # Common properties: - # - # name - The simple name of the method. - # - # flattening - Specifies the configuration for parameter flattening. - # Describes the parameter groups for which a generator should produce method - # overloads which allow a client to directly pass request message fields as - # method parameters. This information may or may not be used, depending on - # the target language. - # Consists of groups, which each represent a list of parameters to be - # flattened. Each parameter listed must be a field of the request message. - # - # required_fields - Fields that are always required for a request to be - # valid. - # - # page_streaming - Specifies the configuration for paging. - # Describes information for generating a method which transforms a paging - # list RPC into a stream of resources. - # Consists of a request and a response. - # The request specifies request information of the list method. It defines - # which fields match the paging pattern in the request. The request consists - # of a page_size_field and a token_field. The page_size_field is the name of - # the optional field specifying the maximum number of elements to be - # returned in the response. The token_field is the name of the field in the - # request containing the page token. - # The response specifies response information of the list method. It defines - # which fields match the paging pattern in the response. The response - # consists of a token_field and a resources_field. The token_field is the - # name of the field in the response containing the next page token. The - # resources_field is the name of the field in the response containing the - # list of resources belonging to the page. - # - # retry_codes_name - Specifies the configuration for retryable codes. The - # name must be defined in interfaces.retry_codes_def. - # - # retry_params_name - Specifies the configuration for retry/backoff - # parameters. The name must be defined in interfaces.retry_params_def. - # - # field_name_patterns - Maps the field name of the request type to - # entity_name of interfaces.collections. - # Specifies the string pattern that the field must follow. - # - # timeout_millis - Specifies the default timeout for a non-retrying call. If - # the call is retrying, refer to retry_params_name instead. methods: - name: CreateWorkflowTemplate - flattening: - groups: - - parameters: - - parent - - template - required_fields: - - parent - - template retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: region - timeout_millis: 30000 - name: GetWorkflowTemplate - # params. - flattening: - groups: - - parameters: - - name - required_fields: - - name retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: workflow_template - timeout_millis: 60000 - name: InstantiateWorkflowTemplate - flattening: - groups: - - parameters: - - name - - parameters: - - name - - parameters - required_fields: - - name retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - name: workflow_template - timeout_millis: 60000 - long_running: - return_type: google.protobuf.Empty - metadata_type: google.cloud.dataproc.v1.WorkflowMetadata - implements_delete: false - implements_cancel: false - initial_poll_delay_millis: 1000 - poll_delay_multiplier: 2 - max_poll_delay_millis: 10000 - total_poll_timeout_millis: 43200000 - name: InstantiateInlineWorkflowTemplate - flattening: - groups: - - parameters: - - parent - - template - required_fields: - - parent - - template retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: region - timeout_millis: 60000 - long_running: - return_type: google.protobuf.Empty - metadata_type: google.cloud.dataproc.v1.WorkflowMetadata - implements_delete: false - implements_cancel: false - initial_poll_delay_millis: 1000 - poll_delay_multiplier: 2 - max_poll_delay_millis: 10000 - total_poll_timeout_millis: 43200000 - name: UpdateWorkflowTemplate - flattening: - groups: - - parameters: - - template - required_fields: - - template retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - template.name: workflow_template - timeout_millis: 60000 - name: ListWorkflowTemplates - flattening: - groups: - - parameters: - - parent - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: templates retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: region - timeout_millis: 60000 - name: DeleteWorkflowTemplate - flattening: - groups: - - parameters: - - name - required_fields: - - name retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - name: workflow_template - timeout_millis: 60000 -resource_name_generation: -- message_name: WorkflowTemplate - field_entity_map: - name: workflow_template -- message_name: CreateWorkflowTemplateRequest - field_entity_map: - parent: region -- message_name: GetWorkflowTemplateRequest - field_entity_map: - name: workflow_template -- message_name: InstantiateWorkflowTemplateRequest - field_entity_map: - name: workflow_template -- message_name: InstantiateInlineWorkflowTemplateRequest - field_entity_map: - parent: region -- message_name: ListWorkflowTemplatesRequest - field_entity_map: - parent: region -- message_name: DeleteWorkflowTemplateRequest - field_entity_map: - name: workflow_template diff --git a/third_party/googleapis/google/cloud/dataproc/v1/dataproc_grpc_service_config.json b/third_party/googleapis/google/cloud/dataproc/v1/dataproc_grpc_service_config.json new file mode 100755 index 000000000..411b7bab7 --- /dev/null +++ b/third_party/googleapis/google/cloud/dataproc/v1/dataproc_grpc_service_config.json @@ -0,0 +1,207 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.dataproc.v1.AutoscalingPolicyService", + "method": "CreateAutoscalingPolicy" + }, + { + "service": "google.cloud.dataproc.v1.AutoscalingPolicyService", + "method": "DeleteAutoscalingPolicy" + } + ], + "timeout": "600s" + }, + { + "name": [ + { + "service": "google.cloud.dataproc.v1.AutoscalingPolicyService", + "method": "UpdateAutoscalingPolicy" + }, + { + "service": "google.cloud.dataproc.v1.AutoscalingPolicyService", + "method": "GetAutoscalingPolicy" + }, + { + "service": "google.cloud.dataproc.v1.AutoscalingPolicyService", + "method": "ListAutoscalingPolicies" + } + ], + "timeout": "600s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dataproc.v1.JobController", + "method": "GetJob" + }, + { + "service": "google.cloud.dataproc.v1.JobController", + "method": "ListJobs" + }, + { + "service": "google.cloud.dataproc.v1.JobController", + "method": "CancelJob" + } + ], + "timeout": "900s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "INTERNAL", + "UNAVAILABLE" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dataproc.v1.WorkflowTemplateService", + "method": "CreateWorkflowTemplate" + }, + { + "service": "google.cloud.dataproc.v1.WorkflowTemplateService", + "method": "InstantiateWorkflowTemplate" + }, + { + "service": "google.cloud.dataproc.v1.WorkflowTemplateService", + "method": "InstantiateInlineWorkflowTemplate" + }, + { + "service": "google.cloud.dataproc.v1.WorkflowTemplateService", + "method": "UpdateWorkflowTemplate" + }, + { + "service": "google.cloud.dataproc.v1.WorkflowTemplateService", + "method": "DeleteWorkflowTemplate" + } + ], + "timeout": "600s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dataproc.v1.WorkflowTemplateService", + "method": "GetWorkflowTemplate" + }, + { + "service": "google.cloud.dataproc.v1.WorkflowTemplateService", + "method": "ListWorkflowTemplates" + } + ], + "timeout": "600s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "INTERNAL", + "UNAVAILABLE" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dataproc.v1.ClusterController", + "method": "CreateCluster" + }, + { + "service": "google.cloud.dataproc.v1.ClusterController", + "method": "UpdateCluster" + }, + { + "service": "google.cloud.dataproc.v1.ClusterController", + "method": "DeleteCluster" + }, + { + "service": "google.cloud.dataproc.v1.ClusterController", + "method": "DiagnoseCluster" + } + ], + "timeout": "300s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dataproc.v1.ClusterController", + "method": "GetCluster" + }, + { + "service": "google.cloud.dataproc.v1.ClusterController", + "method": "ListClusters" + } + ], + "timeout": "300s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "INTERNAL", + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dataproc.v1.JobController", + "method": "SubmitJob" + }, + { + "service": "google.cloud.dataproc.v1.JobController", + "method": "SubmitJobAsOperation" + }, + { + "service": "google.cloud.dataproc.v1.JobController", + "method": "UpdateJob" + }, + { + "service": "google.cloud.dataproc.v1.JobController", + "method": "DeleteJob" + } + ], + "timeout": "900s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/cloud/dataproc/v1/dataproc_v1.yaml b/third_party/googleapis/google/cloud/dataproc/v1/dataproc_v1.yaml new file mode 100644 index 000000000..cb6dc5fc9 --- /dev/null +++ b/third_party/googleapis/google/cloud/dataproc/v1/dataproc_v1.yaml @@ -0,0 +1,83 @@ +type: google.api.Service +config_version: 2 +name: dataproc.googleapis.com +title: Cloud Dataproc API + +apis: +- name: google.cloud.dataproc.v1.AutoscalingPolicyService +- name: google.cloud.dataproc.v1.ClusterController +- name: google.cloud.dataproc.v1.JobController +- name: google.cloud.dataproc.v1.WorkflowTemplateService + +types: +- name: google.cloud.dataproc.v1.ClusterOperationMetadata +- name: google.cloud.dataproc.v1.DiagnoseClusterResults +- name: google.cloud.dataproc.v1.JobMetadata +- name: google.cloud.dataproc.v1.WorkflowMetadata + +documentation: + summary: 'Manages Hadoop-based clusters and jobs on Google Cloud Platform.' + rules: + - selector: google.iam.v1.IAMPolicy.GetIamPolicy + description: |- + Gets the access control policy for a resource. Returns an empty policy + if the resource exists and does not have a policy set. + + - selector: google.iam.v1.IAMPolicy.SetIamPolicy + description: |- + Sets the access control policy on the specified resource. Replaces + any existing policy. + + Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and + PERMISSION_DENIED + + - selector: google.iam.v1.IAMPolicy.TestIamPermissions + description: |- + Returns permissions that a caller has on the specified resource. If the + resource does not exist, this will return an empty set of + permissions, not a NOT_FOUND error. + + Note: This operation is designed to be used for building + permission-aware UIs and command-line tools, not for authorization + checking. This operation may "fail open" without warning. + +http: + rules: + - selector: google.longrunning.Operations.ListOperations + get: '/v1/{name=projects/*/regions/*/operations}' + + - selector: google.longrunning.Operations.GetOperation + get: '/v1/{name=projects/*/regions/*/operations/*}' + + - selector: google.longrunning.Operations.DeleteOperation + delete: '/v1/{name=projects/*/regions/*/operations/*}' + + - selector: google.longrunning.Operations.CancelOperation + post: '/v1/{name=projects/*/regions/*/operations/*}:cancel' + +authentication: + rules: + - selector: 'google.cloud.dataproc.v1.AutoscalingPolicyService.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: 'google.cloud.dataproc.v1.ClusterController.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: 'google.cloud.dataproc.v1.JobController.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: 'google.cloud.dataproc.v1.WorkflowTemplateService.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: 'google.iam.v1.IAMPolicy.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: 'google.longrunning.Operations.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/dataproc/v1/jobs.proto b/third_party/googleapis/google/cloud/dataproc/v1/jobs.proto index 7ead7bb95..0379c09dd 100644 --- a/third_party/googleapis/google/cloud/dataproc/v1/jobs.proto +++ b/third_party/googleapis/google/cloud/dataproc/v1/jobs.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,15 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.dataproc.v1; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/longrunning/operations.proto"; import "google/protobuf/empty.proto"; import "google/protobuf/field_mask.proto"; import "google/protobuf/timestamp.proto"; @@ -29,12 +31,29 @@ option java_package = "com.google.cloud.dataproc.v1"; // The JobController provides methods to manage jobs. service JobController { + option (google.api.default_host) = "dataproc.googleapis.com"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; + // Submits a job to a cluster. rpc SubmitJob(SubmitJobRequest) returns (Job) { option (google.api.http) = { post: "/v1/projects/{project_id}/regions/{region}/jobs:submit" body: "*" }; + option (google.api.method_signature) = "project_id,region,job"; + } + + // Submits job to a cluster. + rpc SubmitJobAsOperation(SubmitJobRequest) returns (google.longrunning.Operation) { + option (google.api.http) = { + post: "/v1/projects/{project_id}/regions/{region}/jobs:submitAsOperation" + body: "*" + }; + option (google.api.method_signature) = "project_id, region, job"; + option (google.longrunning.operation_info) = { + response_type: "Job" + metadata_type: "JobMetadata" + }; } // Gets the resource representation for a job in a project. @@ -42,6 +61,7 @@ service JobController { option (google.api.http) = { get: "/v1/projects/{project_id}/regions/{region}/jobs/{job_id}" }; + option (google.api.method_signature) = "project_id,region,job_id"; } // Lists regions/{region}/jobs in a project. @@ -49,6 +69,8 @@ service JobController { option (google.api.http) = { get: "/v1/projects/{project_id}/regions/{region}/jobs" }; + option (google.api.method_signature) = "project_id,region"; + option (google.api.method_signature) = "project_id,region,filter"; } // Updates a job in a project. @@ -61,14 +83,15 @@ service JobController { // Starts a job cancellation request. To access the job resource // after cancellation, call - // [regions/{region}/jobs.list](/dataproc/docs/reference/rest/v1/projects.regions.jobs/list) + // [regions/{region}/jobs.list](https://cloud.google.com/dataproc/docs/reference/rest/v1/projects.regions.jobs/list) // or - // [regions/{region}/jobs.get](/dataproc/docs/reference/rest/v1/projects.regions.jobs/get). + // [regions/{region}/jobs.get](https://cloud.google.com/dataproc/docs/reference/rest/v1/projects.regions.jobs/get). rpc CancelJob(CancelJobRequest) returns (Job) { option (google.api.http) = { post: "/v1/projects/{project_id}/regions/{region}/jobs/{job_id}:cancel" body: "*" }; + option (google.api.method_signature) = "project_id,region,job_id"; } // Deletes the job from the project. If the job is active, the delete fails, @@ -77,6 +100,7 @@ service JobController { option (google.api.http) = { delete: "/v1/projects/{project_id}/regions/{region}/jobs/{job_id}" }; + option (google.api.method_signature) = "project_id,region,job_id"; } } @@ -121,7 +145,7 @@ message LoggingConfig { map driver_log_levels = 2; } -// A Cloud Dataproc job for running +// A Dataproc job for running // [Apache Hadoop // MapReduce](https://hadoop.apache.org/docs/current/hadoop-mapreduce-client/hadoop-mapreduce-client-core/MapReduceTutorial.html) // jobs on [Apache Hadoop @@ -148,33 +172,33 @@ message HadoopJob { // include arguments, such as `-libjars` or `-Dfoo=bar`, that can be set as // job properties, since a collision may occur that causes an incorrect job // submission. - repeated string args = 3; + repeated string args = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. Jar file URIs to add to the CLASSPATHs of the // Hadoop driver and tasks. - repeated string jar_file_uris = 4; + repeated string jar_file_uris = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS (Hadoop Compatible Filesystem) URIs of files to be copied // to the working directory of Hadoop drivers and distributed tasks. Useful // for naively parallel tasks. - repeated string file_uris = 5; + repeated string file_uris = 5 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS URIs of archives to be extracted in the working directory of // Hadoop drivers and tasks. Supported file types: // .jar, .tar, .tar.gz, .tgz, or .zip. - repeated string archive_uris = 6; + repeated string archive_uris = 6 [(google.api.field_behavior) = OPTIONAL]; // Optional. A mapping of property names to values, used to configure Hadoop. - // Properties that conflict with values set by the Cloud Dataproc API may be + // Properties that conflict with values set by the Dataproc API may be // overwritten. Can include properties set in /etc/hadoop/conf/*-site and // classes in user code. - map properties = 7; + map properties = 7 [(google.api.field_behavior) = OPTIONAL]; // Optional. The runtime log config for job execution. - LoggingConfig logging_config = 8; + LoggingConfig logging_config = 8 [(google.api.field_behavior) = OPTIONAL]; } -// A Cloud Dataproc job for running [Apache Spark](http://spark.apache.org/) +// A Dataproc job for running [Apache Spark](http://spark.apache.org/) // applications on YARN. message SparkJob { // Required. The specification of the main method to call to drive the job. @@ -194,69 +218,69 @@ message SparkJob { // Optional. The arguments to pass to the driver. Do not include arguments, // such as `--conf`, that can be set as job properties, since a collision may // occur that causes an incorrect job submission. - repeated string args = 3; + repeated string args = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS URIs of jar files to add to the CLASSPATHs of the // Spark driver and tasks. - repeated string jar_file_uris = 4; + repeated string jar_file_uris = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS URIs of files to be copied to the working directory of // Spark drivers and distributed tasks. Useful for naively parallel tasks. - repeated string file_uris = 5; + repeated string file_uris = 5 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS URIs of archives to be extracted in the working directory // of Spark drivers and tasks. Supported file types: // .jar, .tar, .tar.gz, .tgz, and .zip. - repeated string archive_uris = 6; + repeated string archive_uris = 6 [(google.api.field_behavior) = OPTIONAL]; // Optional. A mapping of property names to values, used to configure Spark. - // Properties that conflict with values set by the Cloud Dataproc API may be + // Properties that conflict with values set by the Dataproc API may be // overwritten. Can include properties set in // /etc/spark/conf/spark-defaults.conf and classes in user code. - map properties = 7; + map properties = 7 [(google.api.field_behavior) = OPTIONAL]; // Optional. The runtime log config for job execution. - LoggingConfig logging_config = 8; + LoggingConfig logging_config = 8 [(google.api.field_behavior) = OPTIONAL]; } -// A Cloud Dataproc job for running +// A Dataproc job for running // [Apache // PySpark](https://spark.apache.org/docs/0.9.0/python-programming-guide.html) // applications on YARN. message PySparkJob { // Required. The HCFS URI of the main Python file to use as the driver. Must // be a .py file. - string main_python_file_uri = 1; + string main_python_file_uri = 1 [(google.api.field_behavior) = REQUIRED]; // Optional. The arguments to pass to the driver. Do not include arguments, // such as `--conf`, that can be set as job properties, since a collision may // occur that causes an incorrect job submission. - repeated string args = 2; + repeated string args = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS file URIs of Python files to pass to the PySpark // framework. Supported file types: .py, .egg, and .zip. - repeated string python_file_uris = 3; + repeated string python_file_uris = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS URIs of jar files to add to the CLASSPATHs of the // Python driver and tasks. - repeated string jar_file_uris = 4; + repeated string jar_file_uris = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS URIs of files to be copied to the working directory of // Python drivers and distributed tasks. Useful for naively parallel tasks. - repeated string file_uris = 5; + repeated string file_uris = 5 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS URIs of archives to be extracted in the working directory of // .jar, .tar, .tar.gz, .tgz, and .zip. - repeated string archive_uris = 6; + repeated string archive_uris = 6 [(google.api.field_behavior) = OPTIONAL]; // Optional. A mapping of property names to values, used to configure PySpark. - // Properties that conflict with values set by the Cloud Dataproc API may be + // Properties that conflict with values set by the Dataproc API may be // overwritten. Can include properties set in // /etc/spark/conf/spark-defaults.conf and classes in user code. - map properties = 7; + map properties = 7 [(google.api.field_behavior) = OPTIONAL]; // Optional. The runtime log config for job execution. - LoggingConfig logging_config = 8; + LoggingConfig logging_config = 8 [(google.api.field_behavior) = OPTIONAL]; } // A list of queries to run on a cluster. @@ -275,10 +299,10 @@ message QueryList { // ] // } // } - repeated string queries = 1; + repeated string queries = 1 [(google.api.field_behavior) = REQUIRED]; } -// A Cloud Dataproc job for running [Apache Hive](https://hive.apache.org/) +// A Dataproc job for running [Apache Hive](https://hive.apache.org/) // queries on YARN. message HiveJob { // Required. The sequence of Hive queries to execute, specified as either @@ -294,25 +318,25 @@ message HiveJob { // Optional. Whether to continue executing queries if a query fails. // The default value is `false`. Setting to `true` can be useful when // executing independent parallel queries. - bool continue_on_failure = 3; + bool continue_on_failure = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. Mapping of query variable names to values (equivalent to the // Hive command: `SET name="value";`). - map script_variables = 4; + map script_variables = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. A mapping of property names and values, used to configure Hive. - // Properties that conflict with values set by the Cloud Dataproc API may be + // Properties that conflict with values set by the Dataproc API may be // overwritten. Can include properties set in /etc/hadoop/conf/*-site.xml, // /etc/hive/conf/hive-site.xml, and classes in user code. - map properties = 5; + map properties = 5 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS URIs of jar files to add to the CLASSPATH of the // Hive server and Hadoop MapReduce (MR) tasks. Can contain Hive SerDes // and UDFs. - repeated string jar_file_uris = 6; + repeated string jar_file_uris = 6 [(google.api.field_behavior) = OPTIONAL]; } -// A Cloud Dataproc job for running [Apache Spark +// A Dataproc job for running [Apache Spark // SQL](http://spark.apache.org/sql/) queries. message SparkSqlJob { // Required. The sequence of Spark SQL queries to execute, specified as @@ -327,21 +351,21 @@ message SparkSqlJob { // Optional. Mapping of query variable names to values (equivalent to the // Spark SQL command: SET `name="value";`). - map script_variables = 3; + map script_variables = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. A mapping of property names to values, used to configure // Spark SQL's SparkConf. Properties that conflict with values set by the - // Cloud Dataproc API may be overwritten. - map properties = 4; + // Dataproc API may be overwritten. + map properties = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS URIs of jar files to be added to the Spark CLASSPATH. - repeated string jar_file_uris = 56; + repeated string jar_file_uris = 56 [(google.api.field_behavior) = OPTIONAL]; // Optional. The runtime log config for job execution. - LoggingConfig logging_config = 6; + LoggingConfig logging_config = 6 [(google.api.field_behavior) = OPTIONAL]; } -// A Cloud Dataproc job for running [Apache Pig](https://pig.apache.org/) +// A Dataproc job for running [Apache Pig](https://pig.apache.org/) // queries on YARN. message PigJob { // Required. The sequence of Pig queries to execute, specified as an HCFS @@ -357,37 +381,105 @@ message PigJob { // Optional. Whether to continue executing queries if a query fails. // The default value is `false`. Setting to `true` can be useful when // executing independent parallel queries. - bool continue_on_failure = 3; + bool continue_on_failure = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. Mapping of query variable names to values (equivalent to the Pig // command: `name=[value]`). - map script_variables = 4; + map script_variables = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. A mapping of property names to values, used to configure Pig. - // Properties that conflict with values set by the Cloud Dataproc API may be + // Properties that conflict with values set by the Dataproc API may be // overwritten. Can include properties set in /etc/hadoop/conf/*-site.xml, // /etc/pig/conf/pig.properties, and classes in user code. - map properties = 5; + map properties = 5 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS URIs of jar files to add to the CLASSPATH of // the Pig Client and Hadoop MapReduce (MR) tasks. Can contain Pig UDFs. - repeated string jar_file_uris = 6; + repeated string jar_file_uris = 6 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The runtime log config for job execution. + LoggingConfig logging_config = 7 [(google.api.field_behavior) = OPTIONAL]; +} + +// A Dataproc job for running +// [Apache SparkR](https://spark.apache.org/docs/latest/sparkr.html) +// applications on YARN. +message SparkRJob { + // Required. The HCFS URI of the main R file to use as the driver. + // Must be a .R file. + string main_r_file_uri = 1 [(google.api.field_behavior) = REQUIRED]; + + // Optional. The arguments to pass to the driver. Do not include arguments, + // such as `--conf`, that can be set as job properties, since a collision may + // occur that causes an incorrect job submission. + repeated string args = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. HCFS URIs of files to be copied to the working directory of + // R drivers and distributed tasks. Useful for naively parallel tasks. + repeated string file_uris = 3 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. HCFS URIs of archives to be extracted in the working directory of + // Spark drivers and tasks. Supported file types: + // .jar, .tar, .tar.gz, .tgz, and .zip. + repeated string archive_uris = 4 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. A mapping of property names to values, used to configure SparkR. + // Properties that conflict with values set by the Dataproc API may be + // overwritten. Can include properties set in + // /etc/spark/conf/spark-defaults.conf and classes in user code. + map properties = 5 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The runtime log config for job execution. + LoggingConfig logging_config = 6 [(google.api.field_behavior) = OPTIONAL]; +} + +// A Dataproc job for running [Presto](https://prestosql.io/) queries. +// **IMPORTANT**: The [Dataproc Presto Optional +// Component](/dataproc/docs/concepts/components/presto) must be enabled when +// the cluster is created to submit a Presto job to the cluster. +message PrestoJob { + // Required. The sequence of Presto queries to execute, specified as + // either an HCFS file URI or as a list of queries. + oneof queries { + // The HCFS URI of the script that contains SQL queries. + string query_file_uri = 1; + + // A list of queries. + QueryList query_list = 2; + } + + // Optional. Whether to continue executing queries if a query fails. + // The default value is `false`. Setting to `true` can be useful when + // executing independent parallel queries. + bool continue_on_failure = 3 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The format in which query output will be displayed. See the + // Presto documentation for supported output formats + string output_format = 4 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Presto client tags to attach to this query + repeated string client_tags = 5 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. A mapping of property names to values. Used to set Presto + // [session properties](https://prestodb.io/docs/current/sql/set-session.html) + // Equivalent to using the --session flag in the Presto CLI + map properties = 6 [(google.api.field_behavior) = OPTIONAL]; // Optional. The runtime log config for job execution. - LoggingConfig logging_config = 7; + LoggingConfig logging_config = 7 [(google.api.field_behavior) = OPTIONAL]; } -// Cloud Dataproc job config. +// Dataproc job config. message JobPlacement { // Required. The name of the cluster where the job will be submitted. - string cluster_name = 1; + string cluster_name = 1 [(google.api.field_behavior) = REQUIRED]; - // Output only. A cluster UUID generated by the Cloud Dataproc service when + // Output only. A cluster UUID generated by the Dataproc service when // the job is submitted. - string cluster_uuid = 2; + string cluster_uuid = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } -// Cloud Dataproc job status. +// Dataproc job status. message JobStatus { // The job state. enum State { @@ -445,7 +537,7 @@ message JobStatus { QUEUED = 2; // The agent-reported status is out of date, which may be caused by a - // loss of communication between the agent and Cloud Dataproc. If the + // loss of communication between the agent and Dataproc. If the // agent does not send a timely update, the job will fail. // // Applies to RUNNING state. @@ -453,25 +545,28 @@ message JobStatus { } // Output only. A state message specifying the overall job state. - State state = 1; + State state = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Output only. Optional job state details, such as an error + // Optional. Output only. Job state details, such as an error // description if the state is ERROR. - string details = 2; + string details = 2 [ + (google.api.field_behavior) = OUTPUT_ONLY, + (google.api.field_behavior) = OPTIONAL + ]; // Output only. The time when this state was entered. - google.protobuf.Timestamp state_start_time = 6; + google.protobuf.Timestamp state_start_time = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Additional state information, which includes // status reported by the agent. - Substate substate = 7; + Substate substate = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Encapsulates the full scoping used to reference a job. message JobReference { // Required. The ID of the Google Cloud Platform project that the job // belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; // Optional. The job ID, which must be unique within the project. // @@ -479,7 +574,7 @@ message JobReference { // underscores (_), or hyphens (-). The maximum length is 100 characters. // // If not specified by the caller, the job ID will be provided by the server. - string job_id = 2; + string job_id = 2 [(google.api.field_behavior) = OPTIONAL]; } // A YARN application created by a job. Application information is a subset of @@ -520,76 +615,82 @@ message YarnApplication { } // Required. The application name. - string name = 1; + string name = 1 [(google.api.field_behavior) = REQUIRED]; // Required. The application state. - State state = 2; + State state = 2 [(google.api.field_behavior) = REQUIRED]; // Required. The numerical progress of the application, from 1 to 100. - float progress = 3; + float progress = 3 [(google.api.field_behavior) = REQUIRED]; // Optional. The HTTP URL of the ApplicationMaster, HistoryServer, or // TimelineServer that provides application-specific information. The URL uses // the internal hostname, and requires a proxy server for resolution and, // possibly, access. - string tracking_url = 4; + string tracking_url = 4 [(google.api.field_behavior) = OPTIONAL]; } -// A Cloud Dataproc job resource. +// A Dataproc job resource. message Job { // Optional. The fully qualified reference to the job, which can be used to // obtain the equivalent REST path of the job resource. If this property // is not specified when a job is created, the server generates a // job_id. - JobReference reference = 1; + JobReference reference = 1 [(google.api.field_behavior) = OPTIONAL]; // Required. Job information, including how, when, and where to // run the job. - JobPlacement placement = 2; + JobPlacement placement = 2 [(google.api.field_behavior) = REQUIRED]; // Required. The application/framework-specific portion of the job. oneof type_job { - // Job is a Hadoop job. - HadoopJob hadoop_job = 3; + // Optional. Job is a Hadoop job. + HadoopJob hadoop_job = 3 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Job is a Spark job. + SparkJob spark_job = 4 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Job is a PySpark job. + PySparkJob pyspark_job = 5 [(google.api.field_behavior) = OPTIONAL]; - // Job is a Spark job. - SparkJob spark_job = 4; + // Optional. Job is a Hive job. + HiveJob hive_job = 6 [(google.api.field_behavior) = OPTIONAL]; - // Job is a Pyspark job. - PySparkJob pyspark_job = 5; + // Optional. Job is a Pig job. + PigJob pig_job = 7 [(google.api.field_behavior) = OPTIONAL]; - // Job is a Hive job. - HiveJob hive_job = 6; + // Optional. Job is a SparkR job. + SparkRJob spark_r_job = 21 [(google.api.field_behavior) = OPTIONAL]; - // Job is a Pig job. - PigJob pig_job = 7; + // Optional. Job is a SparkSql job. + SparkSqlJob spark_sql_job = 12 [(google.api.field_behavior) = OPTIONAL]; - // Job is a SparkSql job. - SparkSqlJob spark_sql_job = 12; + // Optional. Job is a Presto job. + PrestoJob presto_job = 23 [(google.api.field_behavior) = OPTIONAL]; } // Output only. The job status. Additional application-specific // status information may be contained in the type_job // and yarn_applications fields. - JobStatus status = 8; + JobStatus status = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The previous job status. - repeated JobStatus status_history = 13; + repeated JobStatus status_history = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The collection of YARN applications spun up by this job. // // **Beta** Feature: This report is available for testing purposes only. It // may be changed before final release. - repeated YarnApplication yarn_applications = 9; + repeated YarnApplication yarn_applications = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. A URI pointing to the location of the stdout of the job's // driver program. - string driver_output_resource_uri = 17; + string driver_output_resource_uri = 17 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. If present, the location of miscellaneous control files // which may be used as part of job setup and handling. If not present, // control files may be placed in the same location as `driver_output_uri`. - string driver_control_files_uri = 15; + string driver_control_files_uri = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; // Optional. The labels to associate with this job. // Label **keys** must contain 1 to 63 characters, and must conform to @@ -598,15 +699,21 @@ message Job { // characters, and must conform to [RFC // 1035](https://www.ietf.org/rfc/rfc1035.txt). No more than 32 labels can be // associated with a job. - map labels = 18; + map labels = 18 [(google.api.field_behavior) = OPTIONAL]; // Optional. Job scheduling configuration. - JobScheduling scheduling = 20; + JobScheduling scheduling = 20 [(google.api.field_behavior) = OPTIONAL]; // Output only. A UUID that uniquely identifies a job within the project // over time. This is in contrast to a user-settable reference.job_id that // may be reused over time. - string job_uuid = 22; + string job_uuid = 22 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Indicates whether the job is completed. If the value is `false`, + // the job is still in progress. If `true`, the job is completed, and + // `status.state` field will indicate if it was successful, failed, + // or cancelled. + bool done = 24 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Job scheduling options. @@ -619,20 +726,20 @@ message JobScheduling { // 4 times within 10 minute window. // // Maximum value is 10. - int32 max_failures_per_hour = 1; + int32 max_failures_per_hour = 1 [(google.api.field_behavior) = OPTIONAL]; } // A request to submit a job. message SubmitJobRequest { // Required. The ID of the Google Cloud Platform project that the job // belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The Cloud Dataproc region in which to handle the request. - string region = 3; + // Required. The Dataproc region in which to handle the request. + string region = 3 [(google.api.field_behavior) = REQUIRED]; // Required. The job resource. - Job job = 2; + Job job = 2 [(google.api.field_behavior) = REQUIRED]; // Optional. A unique id used to identify the request. If the server // receives two [SubmitJobRequest][google.cloud.dataproc.v1.SubmitJobRequest] requests with the same @@ -645,20 +752,35 @@ message SubmitJobRequest { // // The id must contain only letters (a-z, A-Z), numbers (0-9), // underscores (_), and hyphens (-). The maximum length is 40 characters. - string request_id = 4; + string request_id = 4 [(google.api.field_behavior) = OPTIONAL]; +} + +// Job Operation metadata. +message JobMetadata { + // Output only. The job id. + string job_id = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Most recent job status. + JobStatus status = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Operation type. + string operation_type = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Job submission time. + google.protobuf.Timestamp start_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; } // A request to get the resource representation for a job in a project. message GetJobRequest { // Required. The ID of the Google Cloud Platform project that the job // belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The Cloud Dataproc region in which to handle the request. - string region = 3; + // Required. The Dataproc region in which to handle the request. + string region = 3 [(google.api.field_behavior) = REQUIRED]; // Required. The job ID. - string job_id = 2; + string job_id = 2 [(google.api.field_behavior) = REQUIRED]; } // A request to list jobs in a project. @@ -678,27 +800,27 @@ message ListJobsRequest { // Required. The ID of the Google Cloud Platform project that the job // belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The Cloud Dataproc region in which to handle the request. - string region = 6; + // Required. The Dataproc region in which to handle the request. + string region = 6 [(google.api.field_behavior) = REQUIRED]; // Optional. The number of results to return in each response. - int32 page_size = 2; + int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. The page token, returned by a previous call, to request the // next page of results. - string page_token = 3; + string page_token = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. If set, the returned jobs list includes only jobs that were // submitted to the named cluster. - string cluster_name = 4; + string cluster_name = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. Specifies enumerated categories of jobs to list. // (default = match ALL jobs). // // If `filter` is provided, `jobStateMatcher` will be ignored. - JobStateMatcher job_state_matcher = 5; + JobStateMatcher job_state_matcher = 5 [(google.api.field_behavior) = OPTIONAL]; // Optional. A filter constraining the jobs to list. Filters are // case-sensitive and have the following syntax: @@ -714,23 +836,23 @@ message ListJobsRequest { // Example filter: // // status.state = ACTIVE AND labels.env = staging AND labels.starred = * - string filter = 7; + string filter = 7 [(google.api.field_behavior) = OPTIONAL]; } // A request to update a job. message UpdateJobRequest { // Required. The ID of the Google Cloud Platform project that the job // belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The Cloud Dataproc region in which to handle the request. - string region = 2; + // Required. The Dataproc region in which to handle the request. + string region = 2 [(google.api.field_behavior) = REQUIRED]; // Required. The job ID. - string job_id = 3; + string job_id = 3 [(google.api.field_behavior) = REQUIRED]; // Required. The changes to the job. - Job job = 4; + Job job = 4 [(google.api.field_behavior) = REQUIRED]; // Required. Specifies the path, relative to Job, of // the field to update. For example, to update the labels of a Job the @@ -738,42 +860,42 @@ message UpdateJobRequest { // labels, and the `PATCH` request body would specify the new // value. Note: Currently, labels is the only // field that can be updated. - google.protobuf.FieldMask update_mask = 5; + google.protobuf.FieldMask update_mask = 5 [(google.api.field_behavior) = REQUIRED]; } // A list of jobs in a project. message ListJobsResponse { // Output only. Jobs list. - repeated Job jobs = 1; + repeated Job jobs = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Optional. This token is included in the response if there are more results // to fetch. To fetch additional results, provide this value as the // `page_token` in a subsequent ListJobsRequest. - string next_page_token = 2; + string next_page_token = 2 [(google.api.field_behavior) = OPTIONAL]; } // A request to cancel a job. message CancelJobRequest { // Required. The ID of the Google Cloud Platform project that the job // belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The Cloud Dataproc region in which to handle the request. - string region = 3; + // Required. The Dataproc region in which to handle the request. + string region = 3 [(google.api.field_behavior) = REQUIRED]; // Required. The job ID. - string job_id = 2; + string job_id = 2 [(google.api.field_behavior) = REQUIRED]; } // A request to delete a job. message DeleteJobRequest { // Required. The ID of the Google Cloud Platform project that the job // belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The Cloud Dataproc region in which to handle the request. - string region = 3; + // Required. The Dataproc region in which to handle the request. + string region = 3 [(google.api.field_behavior) = REQUIRED]; // Required. The job ID. - string job_id = 2; + string job_id = 2 [(google.api.field_behavior) = REQUIRED]; } diff --git a/third_party/googleapis/google/cloud/dataproc/v1/operations.proto b/third_party/googleapis/google/cloud/dataproc/v1/operations.proto index c820cd8e6..724d2a895 100644 --- a/third_party/googleapis/google/cloud/dataproc/v1/operations.proto +++ b/third_party/googleapis/google/cloud/dataproc/v1/operations.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,14 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.dataproc.v1; -import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; import "google/protobuf/timestamp.proto"; +import "google/api/annotations.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/dataproc/v1;dataproc"; option java_multiple_files = true; @@ -43,41 +43,41 @@ message ClusterOperationStatus { } // Output only. A message containing the operation state. - State state = 1; + State state = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. A message containing the detailed operation state. - string inner_state = 2; + string inner_state = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. A message containing any operation metadata details. - string details = 3; + string details = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The time this state was entered. - google.protobuf.Timestamp state_start_time = 4; + google.protobuf.Timestamp state_start_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Metadata describing the operation. message ClusterOperationMetadata { // Output only. Name of the cluster for the operation. - string cluster_name = 7; + string cluster_name = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Cluster UUID for the operation. - string cluster_uuid = 8; + string cluster_uuid = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Current operation status. - ClusterOperationStatus status = 9; + ClusterOperationStatus status = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The previous operation status. - repeated ClusterOperationStatus status_history = 10; + repeated ClusterOperationStatus status_history = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The operation type. - string operation_type = 11; + string operation_type = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Short description of operation. - string description = 12; + string description = 12 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Labels associated with the operation - map labels = 13; + map labels = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Errors encountered during operation execution. - repeated string warnings = 14; + repeated string warnings = 14 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/cloud/dataproc/v1/shared.proto b/third_party/googleapis/google/cloud/dataproc/v1/shared.proto index 74bd56a80..99d6e7760 100644 --- a/third_party/googleapis/google/cloud/dataproc/v1/shared.proto +++ b/third_party/googleapis/google/cloud/dataproc/v1/shared.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -38,6 +37,12 @@ enum Component { // The Jupyter Notebook. JUPYTER = 1; + // The Presto query engine. + PRESTO = 6; + // The Zeppelin notebook. ZEPPELIN = 4; + + // The Zookeeper service. + ZOOKEEPER = 8; } diff --git a/third_party/googleapis/google/cloud/dataproc/v1/workflow_templates.proto b/third_party/googleapis/google/cloud/dataproc/v1/workflow_templates.proto index 61295a550..d1cfcc09f 100644 --- a/third_party/googleapis/google/cloud/dataproc/v1/workflow_templates.proto +++ b/third_party/googleapis/google/cloud/dataproc/v1/workflow_templates.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,15 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.dataproc.v1; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/cloud/dataproc/v1/clusters.proto"; import "google/cloud/dataproc/v1/jobs.proto"; import "google/longrunning/operations.proto"; @@ -30,8 +32,11 @@ option java_outer_classname = "WorkflowTemplatesProto"; option java_package = "com.google.cloud.dataproc.v1"; // The API interface for managing Workflow Templates in the -// Cloud Dataproc API. +// Dataproc API. service WorkflowTemplateService { + option (google.api.default_host) = "dataproc.googleapis.com"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; + // Creates new workflow template. rpc CreateWorkflowTemplate(CreateWorkflowTemplateRequest) returns (WorkflowTemplate) { option (google.api.http) = { @@ -42,6 +47,7 @@ service WorkflowTemplateService { body: "template" } }; + option (google.api.method_signature) = "parent,template"; } // Retrieves the latest workflow template. @@ -55,6 +61,7 @@ service WorkflowTemplateService { get: "/v1/{name=projects/*/regions/*/workflowTemplates/*}" } }; + option (google.api.method_signature) = "name"; } // Instantiates a template and begins execution. @@ -70,7 +77,9 @@ service WorkflowTemplateService { // clusters to be deleted. // // The [Operation.metadata][google.longrunning.Operation.metadata] will be - // [WorkflowMetadata][google.cloud.dataproc.v1.WorkflowMetadata]. + // [WorkflowMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#workflowmetadata). + // Also see [Using + // WorkflowMetadata](https://cloud.google.com/dataproc/docs/concepts/workflows/debugging#using_workflowmetadata). // // On successful completion, // [Operation.response][google.longrunning.Operation.response] will be @@ -84,6 +93,12 @@ service WorkflowTemplateService { body: "*" } }; + option (google.api.method_signature) = "name"; + option (google.api.method_signature) = "name,parameters"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "WorkflowMetadata" + }; } // Instantiates a template and begins execution. @@ -103,7 +118,9 @@ service WorkflowTemplateService { // clusters to be deleted. // // The [Operation.metadata][google.longrunning.Operation.metadata] will be - // [WorkflowMetadata][google.cloud.dataproc.v1.WorkflowMetadata]. + // [WorkflowMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#workflowmetadata). + // Also see [Using + // WorkflowMetadata](https://cloud.google.com/dataproc/docs/concepts/workflows/debugging#using_workflowmetadata). // // On successful completion, // [Operation.response][google.longrunning.Operation.response] will be @@ -117,6 +134,11 @@ service WorkflowTemplateService { body: "template" } }; + option (google.api.method_signature) = "parent,template"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "WorkflowMetadata" + }; } // Updates (replaces) workflow template. The updated template @@ -130,6 +152,7 @@ service WorkflowTemplateService { body: "template" } }; + option (google.api.method_signature) = "template"; } // Lists workflows that match the specified filter in the request. @@ -140,6 +163,7 @@ service WorkflowTemplateService { get: "/v1/{parent=projects/*/regions/*}/workflowTemplates" } }; + option (google.api.method_signature) = "parent"; } // Deletes a workflow template. It does not cancel in-progress workflows. @@ -150,22 +174,32 @@ service WorkflowTemplateService { delete: "/v1/{name=projects/*/regions/*/workflowTemplates/*}" } }; + option (google.api.method_signature) = "name"; } } -// A Cloud Dataproc workflow template resource. +// A Dataproc workflow template resource. message WorkflowTemplate { - // Required. The template id. - // - // The id must contain only letters (a-z, A-Z), numbers (0-9), - // underscores (_), and hyphens (-). Cannot begin or end with underscore - // or hyphen. Must consist of between 3 and 50 characters. - string id = 2; + option (google.api.resource) = { + type: "dataproc.googleapis.com/WorkflowTemplate" + pattern: "projects/{project}/regions/{region}/workflowTemplates/{workflow_template}" + pattern: "projects/{project}/locations/{location}/workflowTemplates/{workflow_template}" + history: ORIGINALLY_SINGLE_PATTERN + }; - // Output only. The "resource name" of the template, as described - // in https://cloud.google.com/apis/design/resource_names of the form - // `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}` - string name = 1; + string id = 2 [(google.api.field_behavior) = REQUIRED]; + + // Output only. The resource name of the workflow template, as described + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.workflowTemplates`, the resource name of the + // template has the following format: + // `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}` + // + // * For `projects.locations.workflowTemplates`, the resource name of the + // template has the following format: + // `projects/{project_id}/locations/{location}/workflowTemplates/{template_id}` + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Optional. Used to perform a consistent read-modify-write. // @@ -176,13 +210,13 @@ message WorkflowTemplate { // the current template with the `version` field filled in with the // current server version. The user updates other fields in the template, // then returns it as part of the `UpdateWorkflowTemplate` request. - int32 version = 3; + int32 version = 3 [(google.api.field_behavior) = OPTIONAL]; // Output only. The time template was created. - google.protobuf.Timestamp create_time = 4; + google.protobuf.Timestamp create_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The time template was last updated. - google.protobuf.Timestamp update_time = 5; + google.protobuf.Timestamp update_time = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; // Optional. The labels to associate with this template. These labels // will be propagated to all jobs and clusters created by the workflow @@ -196,18 +230,18 @@ message WorkflowTemplate { // [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt). // // No more than 32 labels can be associated with a template. - map labels = 6; + map labels = 6 [(google.api.field_behavior) = OPTIONAL]; // Required. WorkflowTemplate scheduling information. - WorkflowTemplatePlacement placement = 7; + WorkflowTemplatePlacement placement = 7 [(google.api.field_behavior) = REQUIRED]; // Required. The Directed Acyclic Graph of Jobs to submit. - repeated OrderedJob jobs = 8; + repeated OrderedJob jobs = 8 [(google.api.field_behavior) = REQUIRED]; - // Optional. Template parameters whose values are substituted into the + // Optional. emplate parameters whose values are substituted into the // template. Values for parameters must be provided when the template is // instantiated. - repeated TemplateParameter parameters = 9; + repeated TemplateParameter parameters = 9 [(google.api.field_behavior) = OPTIONAL]; } // Specifies workflow execution target. @@ -217,7 +251,7 @@ message WorkflowTemplatePlacement { // Required. Specifies where workflow executes; either on a managed // cluster or an existing cluster chosen by labels. oneof placement { - // Optional. A cluster that is managed by the workflow. + // A cluster that is managed by the workflow. ManagedCluster managed_cluster = 1; // Optional. A selector that chooses target cluster for jobs based @@ -236,10 +270,10 @@ message ManagedCluster { // The name must contain only lower-case letters (a-z), numbers (0-9), // and hyphens (-). Must begin with a letter. Cannot begin or end with // hyphen. Must consist of between 2 and 35 characters. - string cluster_name = 2; + string cluster_name = 2 [(google.api.field_behavior) = REQUIRED]; // Required. The cluster configuration. - ClusterConfig config = 3; + ClusterConfig config = 3 [(google.api.field_behavior) = REQUIRED]; // Optional. The labels to associate with this cluster. // @@ -251,7 +285,7 @@ message ManagedCluster { // the following PCRE regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63} // // No more than 32 labels can be associated with a given cluster. - map labels = 4; + map labels = 4 [(google.api.field_behavior) = OPTIONAL]; } // A selector that chooses target cluster for jobs based on metadata. @@ -261,11 +295,11 @@ message ClusterSelector { // // If unspecified, the zone of the first cluster matching the selector // is used. - string zone = 1; + string zone = 1 [(google.api.field_behavior) = OPTIONAL]; // Required. The cluster labels. Cluster must have all labels // to match. - map cluster_labels = 2; + map cluster_labels = 2 [(google.api.field_behavior) = REQUIRED]; } // A job executed by the workflow. @@ -281,27 +315,27 @@ message OrderedJob { // The id must contain only letters (a-z, A-Z), numbers (0-9), // underscores (_), and hyphens (-). Cannot begin or end with underscore // or hyphen. Must consist of between 3 and 50 characters. - string step_id = 1; + string step_id = 1 [(google.api.field_behavior) = REQUIRED]; // Required. The job definition. oneof job_type { - // Job is a Hadoop job. HadoopJob hadoop_job = 2; - // Job is a Spark job. SparkJob spark_job = 3; - // Job is a Pyspark job. PySparkJob pyspark_job = 4; - // Job is a Hive job. HiveJob hive_job = 5; - // Job is a Pig job. PigJob pig_job = 6; - // Job is a SparkSql job. + // Spark R job + SparkRJob spark_r_job = 11; + SparkSqlJob spark_sql_job = 7; + + // Presto job + PrestoJob presto_job = 12; } // Optional. The labels to associate with this job. @@ -314,14 +348,14 @@ message OrderedJob { // the following regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63} // // No more than 32 labels can be associated with a given job. - map labels = 8; + map labels = 8 [(google.api.field_behavior) = OPTIONAL]; // Optional. Job scheduling configuration. - JobScheduling scheduling = 9; + JobScheduling scheduling = 9 [(google.api.field_behavior) = OPTIONAL]; // Optional. The optional list of prerequisite job step_ids. // If not specified, the job will start at the beginning of workflow. - repeated string prerequisite_step_ids = 10; + repeated string prerequisite_step_ids = 10 [(google.api.field_behavior) = OPTIONAL]; } // A configurable parameter that replaces one or more fields in the template. @@ -334,14 +368,14 @@ message OrderedJob { // - Main class (in HadoopJob and SparkJob) // - Zone (in ClusterSelector) message TemplateParameter { - // Required. Parameter name. + // Required. Parameter name. // The parameter name is used as the key, and paired with the // parameter value, which are passed to the template when the template // is instantiated. // The name must contain only capital letters (A-Z), numbers (0-9), and // underscores (_), and must not start with a number. The maximum length is // 40 characters. - string name = 1; + string name = 1 [(google.api.field_behavior) = REQUIRED]; // Required. Paths to all fields that the parameter replaces. // A field is allowed to appear in at most one parameter's list of field @@ -387,14 +421,14 @@ message TemplateParameter { // // - placement.clusterSelector.clusterLabels // - jobs['step-id'].sparkJob.args - repeated string fields = 2; + repeated string fields = 2 [(google.api.field_behavior) = REQUIRED]; // Optional. Brief description of the parameter. // Must not exceed 1024 characters. - string description = 3; + string description = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. Validation rules to be applied to this parameter's value. - ParameterValidation validation = 4; + ParameterValidation validation = 4 [(google.api.field_behavior) = OPTIONAL]; } // Configuration for parameter validation. @@ -414,16 +448,16 @@ message RegexValidation { // Required. RE2 regular expressions used to validate the parameter's value. // The value must match the regex in its entirety (substring // matches are not sufficient). - repeated string regexes = 1; + repeated string regexes = 1 [(google.api.field_behavior) = REQUIRED]; } // Validation based on a list of allowed values. message ValueValidation { // Required. List of allowed values for the parameter. - repeated string values = 1; + repeated string values = 1 [(google.api.field_behavior) = REQUIRED]; } -// A Cloud Dataproc workflow template resource. +// A Dataproc workflow template resource. message WorkflowMetadata { // The operation state. enum State { @@ -440,57 +474,66 @@ message WorkflowMetadata { DONE = 3; } - // Output only. The "resource name" of the template. - string template = 1; + // Output only. The resource name of the workflow template as described + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.workflowTemplates`, the resource name of the + // template has the following format: + // `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}` + // + // * For `projects.locations.workflowTemplates`, the resource name of the + // template has the following format: + // `projects/{project_id}/locations/{location}/workflowTemplates/{template_id}` + string template = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The version of template at the time of // workflow instantiation. - int32 version = 2; + int32 version = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The create cluster operation metadata. - ClusterOperation create_cluster = 3; + ClusterOperation create_cluster = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The workflow graph. - WorkflowGraph graph = 4; + WorkflowGraph graph = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The delete cluster operation metadata. - ClusterOperation delete_cluster = 5; + ClusterOperation delete_cluster = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The workflow state. - State state = 6; + State state = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The name of the target cluster. - string cluster_name = 7; + string cluster_name = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; // Map from parameter names to values that were used for those parameters. map parameters = 8; // Output only. Workflow start time. - google.protobuf.Timestamp start_time = 9; + google.protobuf.Timestamp start_time = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Workflow end time. - google.protobuf.Timestamp end_time = 10; + google.protobuf.Timestamp end_time = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The UUID of target cluster. - string cluster_uuid = 11; + string cluster_uuid = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The cluster operation triggered by a workflow. message ClusterOperation { // Output only. The id of the cluster operation. - string operation_id = 1; + string operation_id = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Error, if operation failed. - string error = 2; + string error = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Indicates the operation is done. - bool done = 3; + bool done = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The workflow graph. message WorkflowGraph { // Output only. The workflow nodes. - repeated WorkflowNode nodes = 1; + repeated WorkflowNode nodes = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The workflow node. @@ -518,52 +561,88 @@ message WorkflowNode { } // Output only. The name of the node. - string step_id = 1; + string step_id = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Node's prerequisite nodes. - repeated string prerequisite_step_ids = 2; + repeated string prerequisite_step_ids = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The job id; populated after the node enters RUNNING state. - string job_id = 3; + string job_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The node state. - NodeState state = 5; + NodeState state = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The error detail. - string error = 6; + string error = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; } // A request to create a workflow template. message CreateWorkflowTemplateRequest { - // Required. The "resource name" of the region, as described - // in https://cloud.google.com/apis/design/resource_names of the form - // `projects/{project_id}/regions/{region}` - string parent = 1; + // Required. The resource name of the region or location, as described + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.workflowTemplates,create`, the resource name of the + // region has the following format: + // `projects/{project_id}/regions/{region}` + // + // * For `projects.locations.workflowTemplates.create`, the resource name of + // the location has the following format: + // `projects/{project_id}/locations/{location}` + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dataproc.googleapis.com/WorkflowTemplate" + } + ]; // Required. The Dataproc workflow template to create. - WorkflowTemplate template = 2; + WorkflowTemplate template = 2 [(google.api.field_behavior) = REQUIRED]; } // A request to fetch a workflow template. message GetWorkflowTemplateRequest { - // Required. The "resource name" of the workflow template, as described - // in https://cloud.google.com/apis/design/resource_names of the form - // `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}` - string name = 1; + // Required. The resource name of the workflow template, as described + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.workflowTemplates.get`, the resource name of the + // template has the following format: + // `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}` + // + // * For `projects.locations.workflowTemplates.get`, the resource name of the + // template has the following format: + // `projects/{project_id}/locations/{location}/workflowTemplates/{template_id}` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "dataproc.googleapis.com/WorkflowTemplate" + } + ]; // Optional. The version of workflow template to retrieve. Only previously - // instatiated versions can be retrieved. + // instantiated versions can be retrieved. // // If unspecified, retrieves the current version. - int32 version = 2; + int32 version = 2 [(google.api.field_behavior) = OPTIONAL]; } // A request to instantiate a workflow template. message InstantiateWorkflowTemplateRequest { - // Required. The "resource name" of the workflow template, as described - // in https://cloud.google.com/apis/design/resource_names of the form - // `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}` - string name = 1; + // Required. The resource name of the workflow template, as described + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.workflowTemplates.instantiate`, the resource name + // of the template has the following format: + // `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}` + // + // * For `projects.locations.workflowTemplates.instantiate`, the resource name + // of the template has the following format: + // `projects/{project_id}/locations/{location}/workflowTemplates/{template_id}` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "dataproc.googleapis.com/WorkflowTemplate" + } + ]; // Optional. The version of workflow template to instantiate. If specified, // the workflow will be instantiated only if the current version of @@ -571,7 +650,7 @@ message InstantiateWorkflowTemplateRequest { // // This option cannot be used to instantiate a previous version of // workflow template. - int32 version = 2; + int32 version = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. A tag that prevents multiple concurrent workflow // instances with the same tag from running. This mitigates risk of @@ -582,22 +661,34 @@ message InstantiateWorkflowTemplateRequest { // // The tag must contain only letters (a-z, A-Z), numbers (0-9), // underscores (_), and hyphens (-). The maximum length is 40 characters. - string request_id = 5; + string request_id = 5 [(google.api.field_behavior) = OPTIONAL]; // Optional. Map from parameter names to values that should be used for those // parameters. Values may not exceed 100 characters. - map parameters = 6; + map parameters = 6 [(google.api.field_behavior) = OPTIONAL]; } // A request to instantiate an inline workflow template. message InstantiateInlineWorkflowTemplateRequest { - // Required. The "resource name" of the workflow template region, as described - // in https://cloud.google.com/apis/design/resource_names of the form - // `projects/{project_id}/regions/{region}` - string parent = 1; + // Required. The resource name of the region or location, as described + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.workflowTemplates,instantiateinline`, the resource + // name of the region has the following format: + // `projects/{project_id}/regions/{region}` + // + // * For `projects.locations.workflowTemplates.instantiateinline`, the + // resource name of the location has the following format: + // `projects/{project_id}/locations/{location}` + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dataproc.googleapis.com/WorkflowTemplate" + } + ]; // Required. The workflow template to instantiate. - WorkflowTemplate template = 2; + WorkflowTemplate template = 2 [(google.api.field_behavior) = REQUIRED]; // Optional. A tag that prevents multiple concurrent workflow // instances with the same tag from running. This mitigates risk of @@ -608,7 +699,7 @@ message InstantiateInlineWorkflowTemplateRequest { // // The tag must contain only letters (a-z, A-Z), numbers (0-9), // underscores (_), and hyphens (-). The maximum length is 40 characters. - string request_id = 3; + string request_id = 3 [(google.api.field_behavior) = OPTIONAL]; } // A request to update a workflow template. @@ -616,46 +707,70 @@ message UpdateWorkflowTemplateRequest { // Required. The updated workflow template. // // The `template.version` field must match the current version. - WorkflowTemplate template = 1; + WorkflowTemplate template = 1 [(google.api.field_behavior) = REQUIRED]; } // A request to list workflow templates in a project. message ListWorkflowTemplatesRequest { - // Required. The "resource name" of the region, as described - // in https://cloud.google.com/apis/design/resource_names of the form - // `projects/{project_id}/regions/{region}` - string parent = 1; + // Required. The resource name of the region or location, as described + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.workflowTemplates,list`, the resource + // name of the region has the following format: + // `projects/{project_id}/regions/{region}` + // + // * For `projects.locations.workflowTemplates.list`, the + // resource name of the location has the following format: + // `projects/{project_id}/locations/{location}` + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dataproc.googleapis.com/WorkflowTemplate" + } + ]; // Optional. The maximum number of results to return in each response. - int32 page_size = 2; + int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. The page token, returned by a previous call, to request the // next page of results. - string page_token = 3; + string page_token = 3 [(google.api.field_behavior) = OPTIONAL]; } // A response to a request to list workflow templates in a project. message ListWorkflowTemplatesResponse { // Output only. WorkflowTemplates list. - repeated WorkflowTemplate templates = 1; + repeated WorkflowTemplate templates = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. This token is included in the response if there are more // results to fetch. To fetch additional results, provide this value as the // page_token in a subsequent ListWorkflowTemplatesRequest. - string next_page_token = 2; + string next_page_token = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } // A request to delete a workflow template. // // Currently started workflows will remain running. message DeleteWorkflowTemplateRequest { - // Required. The "resource name" of the workflow template, as described - // in https://cloud.google.com/apis/design/resource_names of the form - // `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}` - string name = 1; + // Required. The resource name of the workflow template, as described + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.workflowTemplates.delete`, the resource name + // of the template has the following format: + // `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}` + // + // * For `projects.locations.workflowTemplates.instantiate`, the resource name + // of the template has the following format: + // `projects/{project_id}/locations/{location}/workflowTemplates/{template_id}` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "dataproc.googleapis.com/WorkflowTemplate" + } + ]; // Optional. The version of workflow template to delete. If specified, // will only delete the template if the current server version matches // specified version. - int32 version = 2; + int32 version = 2 [(google.api.field_behavior) = OPTIONAL]; } diff --git a/third_party/googleapis/google/cloud/dataproc/v1beta2/BUILD.bazel b/third_party/googleapis/google/cloud/dataproc/v1beta2/BUILD.bazel index 9c73c96c8..62fa2a5a3 100644 --- a/third_party/googleapis/google/cloud/dataproc/v1beta2/BUILD.bazel +++ b/third_party/googleapis/google/cloud/dataproc/v1beta2/BUILD.bazel @@ -1,9 +1,12 @@ +# This file was automatically generated by BuildFileGenerator + # This is an API workspace, having public visibility by default makes perfect sense. package(default_visibility = ["//visibility:public"]) ############################################################################## # Common ############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") proto_library( @@ -18,6 +21,9 @@ proto_library( ], deps = [ "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", "//google/longrunning:operations_proto", "@com_google_protobuf//:duration_proto", "@com_google_protobuf//:empty_proto", @@ -28,7 +34,10 @@ proto_library( proto_library_with_info( name = "dataproc_proto_with_info", - deps = [":dataproc_proto"], + deps = [ + ":dataproc_proto", + "//google/cloud:common_resources_proto", + ], ) ############################################################################## @@ -36,18 +45,13 @@ proto_library_with_info( ############################################################################## load( "@com_google_googleapis_imports//:imports.bzl", - "java_grpc_library", - "java_gapic_library", "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", "java_proto_library", - "java_resource_name_proto_library", - "java_test", ) -_JAVA_GRPC_DEPS = [ - "@com_google_api_grpc_proto_google_common_protos//jar", -] - java_proto_library( name = "dataproc_java_proto", deps = [":dataproc_proto"], @@ -56,53 +60,43 @@ java_proto_library( java_grpc_library( name = "dataproc_java_grpc", srcs = [":dataproc_proto"], - deps = [":dataproc_java_proto"] + _JAVA_GRPC_DEPS, -) - -java_resource_name_proto_library( - name = "dataproc_resource_name_java_proto", - gapic_yaml = "dataproc_gapic.yaml", - deps = [":dataproc_proto"], + deps = [":dataproc_java_proto"], ) java_gapic_library( name = "dataproc_java_gapic", src = ":dataproc_proto_with_info", gapic_yaml = "dataproc_gapic.yaml", - service_yaml = "dataproc.yaml", - test_deps = [":dataproc_java_grpc"], + package = "google.cloud.dataproc.v1beta2", + service_yaml = "dataproc_v1beta2.yaml", + test_deps = [ + ":dataproc_java_grpc", + ], deps = [ ":dataproc_java_proto", - ":dataproc_resource_name_java_proto", - ] + _JAVA_GRPC_DEPS, + ], ) -[java_test( - name = test_name, - test_class = test_name, - runtime_deps = [ - ":dataproc_java_gapic_test", +java_gapic_test( + name = "dataproc_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.dataproc.v1beta2.AutoscalingPolicyServiceClientTest", + "com.google.cloud.dataproc.v1beta2.ClusterControllerClientTest", + "com.google.cloud.dataproc.v1beta2.JobControllerClientTest", + "com.google.cloud.dataproc.v1beta2.WorkflowTemplateServiceClientTest", ], -) for test_name in [ - "com.google.cloud.dataproc.v1beta2.ClusterControllerClientTest", - "com.google.cloud.dataproc.v1beta2.JobControllerClientTest", - "com.google.cloud.dataproc.v1beta2.WorkflowTemplateServiceClientTest", -]] + runtime_deps = [":dataproc_java_gapic_test"], +) -# Opensource Packages +# Open Source Packages java_gapic_assembly_gradle_pkg( name = "google-cloud-dataproc-v1beta2-java", - client_deps = [":dataproc_java_gapic"], - client_group = "com.google.cloud", - client_test_deps = [":dataproc_java_gapic_test"], - grpc_deps = [":dataproc_java_grpc"], - grpc_group = "com.google.api.grpc", - proto_deps = [ + deps = [ + ":dataproc_java_gapic", + ":dataproc_java_grpc", ":dataproc_java_proto", ":dataproc_proto", - ":dataproc_resource_name_java_proto", - ] + _JAVA_GRPC_DEPS, - version = "0.0.0-SNAPSHOT", + ], ) ############################################################################## @@ -110,10 +104,10 @@ java_gapic_assembly_gradle_pkg( ############################################################################## load( "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", "go_proto_library", "go_test", - "go_gapic_library", - "go_gapic_assembly_pkg", ) go_proto_library( @@ -129,15 +123,17 @@ go_proto_library( go_gapic_library( name = "dataproc_go_gapic", - src = ":dataproc_proto_with_info", - gapic_yaml = "dataproc_gapic.yaml", - importpath = "cloud.google.com/go/dataproc/apiv1beta2", - service_yaml = "dataproc.yaml", + srcs = [":dataproc_proto_with_info"], + grpc_service_config = "dataproc_grpc_service_config.json", + importpath = "cloud.google.com/go/dataproc/apiv1beta2;dataproc", + service_yaml = "dataproc_v1beta2.yaml", deps = [ ":dataproc_go_proto", "//google/longrunning:longrunning_go_gapic", "//google/longrunning:longrunning_go_proto", "@com_google_cloud_go//longrunning:go_default_library", + "@com_google_cloud_go//longrunning/autogen:go_default_library", + "@io_bazel_rules_go//proto/wkt:duration_go_proto", ], ) @@ -148,13 +144,237 @@ go_test( importpath = "cloud.google.com/go/dataproc/apiv1beta2", ) -# Opensource Packages +# Open Source Packages go_gapic_assembly_pkg( name = "gapi-cloud-dataproc-v1beta2-go", deps = [ ":dataproc_go_gapic", - ":dataproc_go_gapic_srcjar-smoke-test.srcjar", ":dataproc_go_gapic_srcjar-test.srcjar", ":dataproc_go_proto", ], ) + +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "dataproc_moved_proto", + srcs = [":dataproc_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/longrunning:operations_proto", + "@com_google_protobuf//:duration_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +py_proto_library( + name = "dataproc_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":dataproc_moved_proto"], +) + +py_grpc_library( + name = "dataproc_py_grpc", + srcs = [":dataproc_moved_proto"], + deps = [":dataproc_py_proto"], +) + +py_gapic_library( + name = "dataproc_py_gapic", + src = ":dataproc_proto_with_info", + gapic_yaml = "dataproc_gapic.yaml", + package = "google.cloud.dataproc.v1beta2", + service_yaml = "dataproc_v1beta2.yaml", + deps = [ + ":dataproc_py_grpc", + ":dataproc_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "dataproc-v1beta2-py", + deps = [ + ":dataproc_py_gapic", + ":dataproc_py_grpc", + ":dataproc_py_proto", + ], +) + +############################################################################## +# PHP +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", +) + +php_proto_library( + name = "dataproc_php_proto", + deps = [":dataproc_proto"], +) + +php_grpc_library( + name = "dataproc_php_grpc", + srcs = [":dataproc_proto"], + deps = [":dataproc_php_proto"], +) + +php_gapic_library( + name = "dataproc_php_gapic", + src = ":dataproc_proto_with_info", + gapic_yaml = "dataproc_gapic.yaml", + package = "google.cloud.dataproc.v1beta2", + service_yaml = "dataproc_v1beta2.yaml", + deps = [ + ":dataproc_php_grpc", + ":dataproc_php_proto", + ], +) + +# Open Source Packages +php_gapic_assembly_pkg( + name = "google-cloud-dataproc-v1beta2-php", + deps = [ + ":dataproc_php_gapic", + ":dataproc_php_grpc", + ":dataproc_php_proto", + ], +) + +############################################################################## +# Node.js +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", +) + +nodejs_gapic_library( + name = "dataproc_nodejs_gapic", + src = ":dataproc_proto_with_info", + gapic_yaml = "dataproc_gapic.yaml", + package = "google.cloud.dataproc.v1beta2", + service_yaml = "dataproc_v1beta2.yaml", + deps = [], +) + +nodejs_gapic_assembly_pkg( + name = "dataproc-v1beta2-nodejs", + deps = [ + ":dataproc_nodejs_gapic", + ":dataproc_proto", + ], +) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "dataproc_ruby_proto", + deps = [":dataproc_proto"], +) + +ruby_grpc_library( + name = "dataproc_ruby_grpc", + srcs = [":dataproc_proto"], + deps = [":dataproc_ruby_proto"], +) + +ruby_gapic_library( + name = "dataproc_ruby_gapic", + src = ":dataproc_proto_with_info", + gapic_yaml = "dataproc_gapic.yaml", + package = "google.cloud.dataproc.v1beta2", + service_yaml = "dataproc_v1beta2.yaml", + deps = [ + ":dataproc_ruby_grpc", + ":dataproc_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-dataproc-v1beta2-ruby", + deps = [ + ":dataproc_ruby_gapic", + ":dataproc_ruby_grpc", + ":dataproc_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "dataproc_csharp_proto", + deps = [":dataproc_proto"], +) + +csharp_grpc_library( + name = "dataproc_csharp_grpc", + srcs = [":dataproc_proto"], + deps = [":dataproc_csharp_proto"], +) + +csharp_gapic_library( + name = "dataproc_csharp_gapic", + src = ":dataproc_proto_with_info", + gapic_yaml = "dataproc_gapic.yaml", + package = "google.cloud.dataproc.v1beta2", + service_yaml = "dataproc_v1beta2.yaml", + deps = [ + ":dataproc_csharp_grpc", + ":dataproc_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-dataproc-v1beta2-csharp", + deps = [ + ":dataproc_csharp_gapic", + ":dataproc_csharp_grpc", + ":dataproc_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/cloud/dataproc/v1beta2/autoscaling_policies.proto b/third_party/googleapis/google/cloud/dataproc/v1beta2/autoscaling_policies.proto index 0c3efbd06..a7d6376be 100644 --- a/third_party/googleapis/google/cloud/dataproc/v1beta2/autoscaling_policies.proto +++ b/third_party/googleapis/google/cloud/dataproc/v1beta2/autoscaling_policies.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,28 +11,33 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.dataproc.v1beta2; import "google/api/annotations.proto"; -import "google/cloud/dataproc/v1beta2/clusters.proto"; -import "google/cloud/dataproc/v1beta2/jobs.proto"; -import "google/longrunning/operations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/duration.proto"; import "google/protobuf/empty.proto"; -import "google/protobuf/timestamp.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/dataproc/v1beta2;dataproc"; option java_multiple_files = true; option java_outer_classname = "AutoscalingPoliciesProto"; option java_package = "com.google.cloud.dataproc.v1beta2"; +option (google.api.resource_definition) = { + type: "dataproc.googleapis.com/Region" + pattern: "projects/{project}/regions/{region}" +}; // The API interface for managing autoscaling policies in the -// Google Cloud Dataproc API. +// Cloud Dataproc API. service AutoscalingPolicyService { + option (google.api.default_host) = "dataproc.googleapis.com"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; + // Creates new autoscaling policy. rpc CreateAutoscalingPolicy(CreateAutoscalingPolicyRequest) returns (AutoscalingPolicy) { option (google.api.http) = { @@ -43,6 +48,7 @@ service AutoscalingPolicyService { body: "policy" } }; + option (google.api.method_signature) = "parent,policy"; } // Updates (replaces) autoscaling policy. @@ -58,6 +64,7 @@ service AutoscalingPolicyService { body: "policy" } }; + option (google.api.method_signature) = "policy"; } // Retrieves autoscaling policy. @@ -68,6 +75,7 @@ service AutoscalingPolicyService { get: "/v1beta2/{name=projects/*/regions/*/autoscalingPolicies/*}" } }; + option (google.api.method_signature) = "name"; } // Lists autoscaling policies in the project. @@ -78,6 +86,7 @@ service AutoscalingPolicyService { get: "/v1beta2/{parent=projects/*/regions/*}/autoscalingPolicies" } }; + option (google.api.method_signature) = "parent"; } // Deletes an autoscaling policy. It is an error to delete an autoscaling @@ -89,22 +98,37 @@ service AutoscalingPolicyService { delete: "/v1beta2/{name=projects/*/regions/*/autoscalingPolicies/*}" } }; + option (google.api.method_signature) = "name"; } } // Describes an autoscaling policy for Dataproc cluster autoscaler. message AutoscalingPolicy { + option (google.api.resource) = { + type: "dataproc.googleapis.com/AutoscalingPolicy" + pattern: "projects/{project}/locations/{location}/autoscalingPolicies/{autoscaling_policy}" + pattern: "projects/{project}/regions/{region}/autoscalingPolicies/{autoscaling_policy}" + history: ORIGINALLY_SINGLE_PATTERN + }; + // Required. The policy id. // // The id must contain only letters (a-z, A-Z), numbers (0-9), // underscores (_), and hyphens (-). Cannot begin or end with underscore // or hyphen. Must consist of between 3 and 50 characters. - string id = 1; + string id = 1 [(google.api.field_behavior) = REQUIRED]; - // Output only. The "resource name" of the policy, as described - // in https://cloud.google.com/apis/design/resource_names of the form - // `projects/{project_id}/regions/{region}/autoscalingPolicies/{policy_id}`. - string name = 2; + // Output only. The "resource name" of the autoscaling policy, as described + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.autoscalingPolicies`, the resource name of the + // policy has the following format: + // `projects/{project_id}/regions/{region}/autoscalingPolicies/{policy_id}` + // + // * For `projects.locations.autoscalingPolicies`, the resource name of the + // policy has the following format: + // `projects/{project_id}/locations/{location}/autoscalingPolicies/{policy_id}` + string name = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; // Required. Autoscaling algorithm for policy. oneof algorithm { @@ -112,22 +136,22 @@ message AutoscalingPolicy { } // Required. Describes how the autoscaler will operate for primary workers. - InstanceGroupAutoscalingPolicyConfig worker_config = 4; + InstanceGroupAutoscalingPolicyConfig worker_config = 4 [(google.api.field_behavior) = REQUIRED]; // Optional. Describes how the autoscaler will operate for secondary workers. - InstanceGroupAutoscalingPolicyConfig secondary_worker_config = 5; + InstanceGroupAutoscalingPolicyConfig secondary_worker_config = 5 [(google.api.field_behavior) = OPTIONAL]; } // Basic algorithm for autoscaling. message BasicAutoscalingAlgorithm { // Required. YARN autoscaling configuration. - BasicYarnAutoscalingConfig yarn_config = 1; + BasicYarnAutoscalingConfig yarn_config = 1 [(google.api.field_behavior) = REQUIRED]; // Optional. Duration between scaling events. A scaling period starts after // the update operation from the previous event has completed. // // Bounds: [2m, 1d]. Default: 2m. - google.protobuf.Duration cooldown_period = 2; + google.protobuf.Duration cooldown_period = 2 [(google.api.field_behavior) = OPTIONAL]; } // Basic autoscaling configurations for YARN. @@ -138,7 +162,7 @@ message BasicYarnAutoscalingConfig { // downscaling operations. // // Bounds: [0s, 1d]. - google.protobuf.Duration graceful_decommission_timeout = 5; + google.protobuf.Duration graceful_decommission_timeout = 5 [(google.api.field_behavior) = REQUIRED]; // Required. Fraction of average pending memory in the last cooldown period // for which to add workers. A scale-up factor of 1.0 will result in scaling @@ -147,7 +171,7 @@ message BasicYarnAutoscalingConfig { // magnitude of scaling up (less aggressive scaling). // // Bounds: [0.0, 1.0]. - double scale_up_factor = 1; + double scale_up_factor = 1 [(google.api.field_behavior) = REQUIRED]; // Required. Fraction of average pending memory in the last cooldown period // for which to remove workers. A scale-down factor of 1 will result in @@ -156,7 +180,7 @@ message BasicYarnAutoscalingConfig { // removing workers, which can be beneficial for autoscaling a single job. // // Bounds: [0.0, 1.0]. - double scale_down_factor = 2; + double scale_down_factor = 2 [(google.api.field_behavior) = REQUIRED]; // Optional. Minimum scale-up threshold as a fraction of total cluster size // before scaling occurs. For example, in a 20-worker cluster, a threshold of @@ -165,7 +189,7 @@ message BasicYarnAutoscalingConfig { // on any recommended change. // // Bounds: [0.0, 1.0]. Default: 0.0. - double scale_up_min_worker_fraction = 3; + double scale_up_min_worker_fraction = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. Minimum scale-down threshold as a fraction of total cluster size // before scaling occurs. For example, in a 20-worker cluster, a threshold of @@ -174,7 +198,7 @@ message BasicYarnAutoscalingConfig { // on any recommended change. // // Bounds: [0.0, 1.0]. Default: 0.0. - double scale_down_min_worker_fraction = 4; + double scale_down_min_worker_fraction = 4 [(google.api.field_behavior) = OPTIONAL]; } // Configuration for the size bounds of an instance group, including its @@ -184,7 +208,7 @@ message InstanceGroupAutoscalingPolicyConfig { // // Primary workers - Bounds: [2, max_instances]. Default: 2. // Secondary workers - Bounds: [0, max_instances]. Default: 0. - int32 min_instances = 1; + int32 min_instances = 1 [(google.api.field_behavior) = OPTIONAL]; // Optional. Maximum number of instances for this group. Required for primary // workers. Note that by default, clusters will not use secondary workers. @@ -192,7 +216,7 @@ message InstanceGroupAutoscalingPolicyConfig { // // Primary workers - Bounds: [min_instances, ). Required. // Secondary workers - Bounds: [min_instances, ). Default: 0. - int32 max_instances = 2; + int32 max_instances = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. Weight for the instance group, which is used to determine the // fraction of total workers in the cluster from this instance group. @@ -212,32 +236,56 @@ message InstanceGroupAutoscalingPolicyConfig { // zero weight on the unset group. For example if weight is set only on // primary workers, the cluster will use primary workers only and no // secondary workers. - int32 weight = 3; + int32 weight = 3 [(google.api.field_behavior) = OPTIONAL]; } // A request to create an autoscaling policy. message CreateAutoscalingPolicyRequest { - // Required. The "resource name" of the region, as described - // in https://cloud.google.com/apis/design/resource_names of the form - // `projects/{project_id}/regions/{region}`. - string parent = 1; - - // The autoscaling policy to create. - AutoscalingPolicy policy = 2; + // Required. The "resource name" of the region or location, as described + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.autoscalingPolicies.create`, the resource name + // has the following format: + // `projects/{project_id}/regions/{region}` + // + // * For `projects.locations.autoscalingPolicies.create`, the resource name + // has the following format: + // `projects/{project_id}/locations/{location}` + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dataproc.googleapis.com/AutoscalingPolicy" + } + ]; + + // Required. The autoscaling policy to create. + AutoscalingPolicy policy = 2 [(google.api.field_behavior) = REQUIRED]; } // A request to fetch an autoscaling policy. message GetAutoscalingPolicyRequest { // Required. The "resource name" of the autoscaling policy, as described - // in https://cloud.google.com/apis/design/resource_names of the form - // `projects/{project_id}/regions/{region}/autoscalingPolicies/{policy_id}`. - string name = 1; + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.autoscalingPolicies.get`, the resource name + // of the policy has the following format: + // `projects/{project_id}/regions/{region}/autoscalingPolicies/{policy_id}` + // + // * For `projects.locations.autoscalingPolicies.get`, the resource name + // of the policy has the following format: + // `projects/{project_id}/locations/{location}/autoscalingPolicies/{policy_id}` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "dataproc.googleapis.com/AutoscalingPolicy" + } + ]; } // A request to update an autoscaling policy. message UpdateAutoscalingPolicyRequest { // Required. The updated autoscaling policy. - AutoscalingPolicy policy = 1; + AutoscalingPolicy policy = 1 [(google.api.field_behavior) = REQUIRED]; } // A request to delete an autoscaling policy. @@ -245,32 +293,57 @@ message UpdateAutoscalingPolicyRequest { // Autoscaling policies in use by one or more clusters will not be deleted. message DeleteAutoscalingPolicyRequest { // Required. The "resource name" of the autoscaling policy, as described - // in https://cloud.google.com/apis/design/resource_names of the form - // `projects/{project_id}/regions/{region}/autoscalingPolicies/{policy_id}`. - string name = 1; + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.autoscalingPolicies.delete`, the resource name + // of the policy has the following format: + // `projects/{project_id}/regions/{region}/autoscalingPolicies/{policy_id}` + // + // * For `projects.locations.autoscalingPolicies.delete`, the resource name + // of the policy has the following format: + // `projects/{project_id}/locations/{location}/autoscalingPolicies/{policy_id}` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "dataproc.googleapis.com/AutoscalingPolicy" + } + ]; } // A request to list autoscaling policies in a project. message ListAutoscalingPoliciesRequest { - // Required. The "resource name" of the region, as described - // in https://cloud.google.com/apis/design/resource_names of the form - // `projects/{project_id}/regions/{region}` - string parent = 1; + // Required. The "resource name" of the region or location, as described + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.autoscalingPolicies.list`, the resource name + // of the region has the following format: + // `projects/{project_id}/regions/{region}` + // + // * For `projects.locations.autoscalingPolicies.list`, the resource name + // of the location has the following format: + // `projects/{project_id}/locations/{location}` + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dataproc.googleapis.com/AutoscalingPolicy" + } + ]; // Optional. The maximum number of results to return in each response. - int32 page_size = 2; + // Must be less than or equal to 1000. Defaults to 100. + int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. The page token, returned by a previous call, to request the // next page of results. - string page_token = 3; + string page_token = 3 [(google.api.field_behavior) = OPTIONAL]; } // A response to a request to list autoscaling policies in a project. message ListAutoscalingPoliciesResponse { // Output only. Autoscaling policies list. - repeated AutoscalingPolicy policies = 1; + repeated AutoscalingPolicy policies = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. This token is included in the response if there are more // results to fetch. - string next_page_token = 2; + string next_page_token = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } diff --git a/third_party/googleapis/google/cloud/dataproc/v1beta2/clusters.proto b/third_party/googleapis/google/cloud/dataproc/v1beta2/clusters.proto index d3bed6b3f..93e6fe79e 100644 --- a/third_party/googleapis/google/cloud/dataproc/v1beta2/clusters.proto +++ b/third_party/googleapis/google/cloud/dataproc/v1beta2/clusters.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,15 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.dataproc.v1beta2; import "google/api/annotations.proto"; -import "google/cloud/dataproc/v1beta2/operations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/cloud/dataproc/v1beta2/shared.proto"; import "google/longrunning/operations.proto"; import "google/protobuf/duration.proto"; @@ -33,27 +34,51 @@ option java_package = "com.google.cloud.dataproc.v1beta2"; // The ClusterControllerService provides methods to manage clusters // of Compute Engine instances. service ClusterController { - // Creates a cluster in a project. + option (google.api.default_host) = "dataproc.googleapis.com"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; + + // Creates a cluster in a project. The returned + // [Operation.metadata][google.longrunning.Operation.metadata] will be + // [ClusterOperationMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1beta2#clusteroperationmetadata). rpc CreateCluster(CreateClusterRequest) returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1beta2/projects/{project_id}/regions/{region}/clusters" body: "cluster" }; + option (google.api.method_signature) = "project_id, region, cluster"; + option (google.longrunning.operation_info) = { + response_type: "Cluster" + metadata_type: "google.cloud.dataproc.v1beta2.ClusterOperationMetadata" + }; } - // Updates a cluster in a project. + // Updates a cluster in a project. The returned + // [Operation.metadata][google.longrunning.Operation.metadata] will be + // [ClusterOperationMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1beta2#clusteroperationmetadata). rpc UpdateCluster(UpdateClusterRequest) returns (google.longrunning.Operation) { option (google.api.http) = { patch: "/v1beta2/projects/{project_id}/regions/{region}/clusters/{cluster_name}" body: "cluster" }; + option (google.api.method_signature) = "project_id, region, cluster_name, cluster, update_mask"; + option (google.longrunning.operation_info) = { + response_type: "Cluster" + metadata_type: "google.cloud.dataproc.v1beta2.ClusterOperationMetadata" + }; } - // Deletes a cluster in a project. + // Deletes a cluster in a project. The returned + // [Operation.metadata][google.longrunning.Operation.metadata] will be + // [ClusterOperationMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1beta2#clusteroperationmetadata). rpc DeleteCluster(DeleteClusterRequest) returns (google.longrunning.Operation) { option (google.api.http) = { delete: "/v1beta2/projects/{project_id}/regions/{region}/clusters/{cluster_name}" }; + option (google.api.method_signature) = "project_id, region, cluster_name"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "google.cloud.dataproc.v1beta2.ClusterOperationMetadata" + }; } // Gets the resource representation for a cluster in a project. @@ -61,23 +86,35 @@ service ClusterController { option (google.api.http) = { get: "/v1beta2/projects/{project_id}/regions/{region}/clusters/{cluster_name}" }; + option (google.api.method_signature) = "project_id, region, cluster_name"; } - // Lists all regions/{region}/clusters in a project. + // Lists all regions/{region}/clusters in a project alphabetically. rpc ListClusters(ListClustersRequest) returns (ListClustersResponse) { option (google.api.http) = { get: "/v1beta2/projects/{project_id}/regions/{region}/clusters" }; + option (google.api.method_signature) = "project_id, region"; + option (google.api.method_signature) = "project_id, region, filter"; } - // Gets cluster diagnostic information. - // After the operation completes, the Operation.response field - // contains `DiagnoseClusterOutputLocation`. + // Gets cluster diagnostic information. The returned + // [Operation.metadata][google.longrunning.Operation.metadata] will be + // [ClusterOperationMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1beta2#clusteroperationmetadata). + // After the operation completes, + // [Operation.response][google.longrunning.Operation.response] + // contains + // [Empty][google.protobuf.Empty]. rpc DiagnoseCluster(DiagnoseClusterRequest) returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v1beta2/projects/{project_id}/regions/{region}/clusters/{cluster_name}:diagnose" body: "*" }; + option (google.api.method_signature) = "project_id, region, cluster_name"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "google.cloud.dataproc.v1beta2.ClusterOperationMetadata" + }; } } @@ -85,15 +122,15 @@ service ClusterController { // a cluster of Compute Engine instances. message Cluster { // Required. The Google Cloud Platform project ID that the cluster belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; // Required. The cluster name. Cluster names within a project must be // unique. Names of deleted clusters can be reused. - string cluster_name = 2; + string cluster_name = 2 [(google.api.field_behavior) = REQUIRED]; - // Required. The cluster config. Note that Cloud Dataproc may set + // Required. The cluster config. Note that Dataproc may set // default values, and values may change when clusters are updated. - ClusterConfig config = 3; + ClusterConfig config = 3 [(google.api.field_behavior) = REQUIRED]; // Optional. The labels to associate with this cluster. // Label **keys** must contain 1 to 63 characters, and must conform to @@ -102,59 +139,59 @@ message Cluster { // characters, and must conform to [RFC // 1035](https://www.ietf.org/rfc/rfc1035.txt). No more than 32 labels can be // associated with a cluster. - map labels = 8; + map labels = 8 [(google.api.field_behavior) = OPTIONAL]; // Output only. Cluster status. - ClusterStatus status = 4; + ClusterStatus status = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The previous cluster status. - repeated ClusterStatus status_history = 7; + repeated ClusterStatus status_history = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Output only. A cluster UUID (Unique Universal Identifier). Cloud Dataproc + // Output only. A cluster UUID (Unique Universal Identifier). Dataproc // generates this value when it creates the cluster. - string cluster_uuid = 6; + string cluster_uuid = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Contains cluster daemon metrics such as HDFS and YARN stats. // // **Beta Feature**: This report is available for testing purposes only. It // may be changed before final release. - ClusterMetrics metrics = 9; + ClusterMetrics metrics = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The cluster config. message ClusterConfig { - // Optional. A Google Cloud Storage bucket used to stage job + // Optional. A Cloud Storage bucket used to stage job // dependencies, config files, and job driver console output. // If you do not specify a staging bucket, Cloud // Dataproc will determine a Cloud Storage location (US, - // ASIA, or EU) for your cluster's staging bucket according to the Google + // ASIA, or EU) for your cluster's staging bucket according to the // Compute Engine zone where your cluster is deployed, and then create // and manage this project-level, per-location bucket (see - // [Cloud Dataproc staging - // bucket](/dataproc/docs/concepts/configuring-clusters/staging-bucket)). - string config_bucket = 1; + // [Dataproc staging + // bucket](https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/staging-bucket)). + string config_bucket = 1 [(google.api.field_behavior) = OPTIONAL]; // Optional. The shared Compute Engine config settings for // all instances in a cluster. - GceClusterConfig gce_cluster_config = 8; + GceClusterConfig gce_cluster_config = 8 [(google.api.field_behavior) = OPTIONAL]; // Optional. The Compute Engine config settings for // the master instance in a cluster. - InstanceGroupConfig master_config = 9; + InstanceGroupConfig master_config = 9 [(google.api.field_behavior) = OPTIONAL]; // Optional. The Compute Engine config settings for // worker instances in a cluster. - InstanceGroupConfig worker_config = 10; + InstanceGroupConfig worker_config = 10 [(google.api.field_behavior) = OPTIONAL]; // Optional. The Compute Engine config settings for // additional worker instances in a cluster. - InstanceGroupConfig secondary_worker_config = 12; + InstanceGroupConfig secondary_worker_config = 12 [(google.api.field_behavior) = OPTIONAL]; // Optional. The config settings for software inside the cluster. - SoftwareConfig software_config = 13; + SoftwareConfig software_config = 13 [(google.api.field_behavior) = OPTIONAL]; // Optional. The config setting for auto delete cluster schedule. - LifecycleConfig lifecycle_config = 14; + LifecycleConfig lifecycle_config = 14 [(google.api.field_behavior) = OPTIONAL]; // Optional. Commands to execute on each node after config is // completed. By default, executables are run on master and all worker nodes. @@ -169,31 +206,58 @@ message ClusterConfig { // else // ... worker specific actions ... // fi - repeated NodeInitializationAction initialization_actions = 11; + repeated NodeInitializationAction initialization_actions = 11 [(google.api.field_behavior) = OPTIONAL]; // Optional. Encryption settings for the cluster. - EncryptionConfig encryption_config = 15; + EncryptionConfig encryption_config = 15 [(google.api.field_behavior) = OPTIONAL]; // Optional. Autoscaling config for the policy associated with the cluster. // Cluster does not autoscale if this field is unset. - AutoscalingConfig autoscaling_config = 16; + AutoscalingConfig autoscaling_config = 16 [(google.api.field_behavior) = OPTIONAL]; // Optional. Port/endpoint configuration for this cluster - EndpointConfig endpoint_config = 17; + EndpointConfig endpoint_config = 17 [(google.api.field_behavior) = OPTIONAL]; // Optional. Security related configuration. - SecurityConfig security_config = 18; + SecurityConfig security_config = 18 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The Kubernetes Engine config for Dataproc clusters deployed to Kubernetes. + // Setting this is considered mutually exclusive with Compute Engine-based + // options such as `gce_cluster_config`, `master_config`, `worker_config`, + // `secondary_worker_config`, and `autoscaling_config`. + GkeClusterConfig gke_cluster_config = 19 [(google.api.field_behavior) = OPTIONAL]; +} + +// The GKE config for this cluster. +message GkeClusterConfig { + // A full, namespace-isolated deployment target for an existing GKE cluster. + message NamespacedGkeDeploymentTarget { + // Optional. The target GKE cluster to deploy to. + // Format: 'projects/{project}/locations/{location}/clusters/{cluster_id}' + string target_gke_cluster = 1 [ + (google.api.field_behavior) = OPTIONAL, + (google.api.resource_reference) = { + type: "container.googleapis.com/Cluster" + } + ]; + + // Optional. A namespace within the GKE cluster to deploy into. + string cluster_namespace = 2 [(google.api.field_behavior) = OPTIONAL]; + } + + // Optional. A target for the deployment. + NamespacedGkeDeploymentTarget namespaced_gke_deployment_target = 1 [(google.api.field_behavior) = OPTIONAL]; } // Endpoint config for this cluster message EndpointConfig { // Output only. The map of port descriptions to URLs. Will only be populated // if enable_http_port_access is true. - map http_ports = 1; + map http_ports = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Optional. If true, enable http access to specific ports on the cluster // from external sources. Defaults to false. - bool enable_http_port_access = 2; + bool enable_http_port_access = 2 [(google.api.field_behavior) = OPTIONAL]; } // Autoscaling Policy config associated with the cluster. @@ -206,15 +270,15 @@ message AutoscalingConfig { // * `https://www.googleapis.com/compute/v1/projects/[project_id]/locations/[dataproc_region]/autoscalingPolicies/[policy_id]` // * `projects/[project_id]/locations/[dataproc_region]/autoscalingPolicies/[policy_id]` // - // Note that the policy must be in the same project and Cloud Dataproc region. - string policy_uri = 1; + // Note that the policy must be in the same project and Dataproc region. + string policy_uri = 1 [(google.api.field_behavior) = OPTIONAL]; } // Encryption settings for the cluster. message EncryptionConfig { // Optional. The Cloud KMS key name to use for PD disk encryption for all // instances in the cluster. - string gce_pd_kms_key_name = 1; + string gce_pd_kms_key_name = 1 [(google.api.field_behavior) = OPTIONAL]; } // Common config settings for resources of Compute Engine cluster @@ -222,7 +286,7 @@ message EncryptionConfig { message GceClusterConfig { // Optional. The zone where the Compute Engine cluster will be located. // On a create request, it is required in the "global" region. If omitted - // in a non-global Cloud Dataproc region, the service will pick a zone in the + // in a non-global Dataproc region, the service will pick a zone in the // corresponding Compute Engine region. On a get request, zone will always be // present. // @@ -231,20 +295,21 @@ message GceClusterConfig { // * `https://www.googleapis.com/compute/v1/projects/[project_id]/zones/[zone]` // * `projects/[project_id]/zones/[zone]` // * `us-central1-f` - string zone_uri = 1; + string zone_uri = 1 [(google.api.field_behavior) = OPTIONAL]; // Optional. The Compute Engine network to be used for machine // communications. Cannot be specified with subnetwork_uri. If neither // `network_uri` nor `subnetwork_uri` is specified, the "default" network of // the project is used, if it exists. Cannot be a "Custom Subnet Network" (see - // [Using Subnetworks](/compute/docs/subnetworks) for more information). + // [Using Subnetworks](https://cloud.google.com/compute/docs/subnetworks) for + // more information). // // A full URL, partial URI, or short name are valid. Examples: // // * `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/global/default` // * `projects/[project_id]/regions/global/default` // * `default` - string network_uri = 2; + string network_uri = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. The Compute Engine subnetwork to be used for machine // communications. Cannot be specified with network_uri. @@ -254,7 +319,7 @@ message GceClusterConfig { // * `https://www.googleapis.com/compute/v1/projects/[project_id]/regions/us-east1/subnetworks/sub0` // * `projects/[project_id]/regions/us-east1/subnetworks/sub0` // * `sub0` - string subnetwork_uri = 6; + string subnetwork_uri = 6 [(google.api.field_behavior) = OPTIONAL]; // Optional. If true, all instances in the cluster will only have internal IP // addresses. By default, clusters are not restricted to internal IP @@ -262,20 +327,20 @@ message GceClusterConfig { // instance. This `internal_ip_only` restriction can only be enabled for // subnetwork enabled networks, and all off-cluster dependencies must be // configured to be accessible without external IP addresses. - bool internal_ip_only = 7; + bool internal_ip_only = 7 [(google.api.field_behavior) = OPTIONAL]; - // Optional. The service account of the instances. Defaults to the default - // Compute Engine service account. Custom service accounts need - // permissions equivalent to the following IAM roles: + // Optional. The [Dataproc service + // account](https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/service-accounts#service_accounts_in_cloud_dataproc) + // (also see [VM Data Plane + // identity](https://cloud.google.com/dataproc/docs/concepts/iam/dataproc-principals#vm_service_account_data_plane_identity)) + // used by Dataproc cluster VM instances to access Google Cloud Platform + // services. // - // * roles/logging.logWriter - // * roles/storage.objectAdmin - // - // (see - // https://cloud.google.com/compute/docs/access/service-accounts#custom_service_accounts - // for more information). - // Example: `[account_id]@[project_id].iam.gserviceaccount.com` - string service_account = 8; + // If not specified, the + // [Compute Engine default service + // account](https://cloud.google.com/compute/docs/access/service-accounts#default_service_account) + // is used. + string service_account = 8 [(google.api.field_behavior) = OPTIONAL]; // Optional. The URIs of service account scopes to be included in // Compute Engine instances. The following base set of scopes is always @@ -291,10 +356,10 @@ message GceClusterConfig { // * https://www.googleapis.com/auth/bigtable.admin.table // * https://www.googleapis.com/auth/bigtable.data // * https://www.googleapis.com/auth/devstorage.full_control - repeated string service_account_scopes = 3; + repeated string service_account_scopes = 3 [(google.api.field_behavior) = OPTIONAL]; - // The Compute Engine tags to add to all instances (see - // [Tagging instances](/compute/docs/label-or-tag-resources#tags)). + // The Compute Engine tags to add to all instances (see [Tagging + // instances](https://cloud.google.com/compute/docs/label-or-tag-resources#tags)). repeated string tags = 4; // The Compute Engine metadata entries to add to all instances (see @@ -303,24 +368,39 @@ message GceClusterConfig { map metadata = 5; // Optional. Reservation Affinity for consuming Zonal reservation. - ReservationAffinity reservation_affinity = 11; + ReservationAffinity reservation_affinity = 11 [(google.api.field_behavior) = OPTIONAL]; } -// Optional. The config settings for Compute Engine resources in +// The config settings for Compute Engine resources in // an instance group, such as a master or worker group. message InstanceGroupConfig { // Optional. The number of VM instances in the instance group. // For master instance groups, must be set to 1. - int32 num_instances = 1; + int32 num_instances = 1 [(google.api.field_behavior) = OPTIONAL]; - // Output only. The list of instance names. Cloud Dataproc derives the names + // Output only. The list of instance names. Dataproc derives the names // from `cluster_name`, `num_instances`, and the instance group. - repeated string instance_names = 2; + repeated string instance_names = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Optional. The Compute Engine image resource used for cluster - // instances. It can be specified or may be inferred from - // `SoftwareConfig.image_version`. - string image_uri = 3; + // Optional. The Compute Engine image resource used for cluster instances. + // + // The URI can represent an image or image family. + // + // Image examples: + // + // * `https://www.googleapis.com/compute/beta/projects/[project_id]/global/images/[image-id]` + // * `projects/[project_id]/global/images/[image-id]` + // * `image-id` + // + // Image family examples. Dataproc will use the most recent + // image from the family: + // + // * `https://www.googleapis.com/compute/beta/projects/[project_id]/global/images/family/[custom-image-family-name]` + // * `projects/[project_id]/global/images/family/[custom-image-family-name]` + // + // If the URI is unspecified, it will be inferred from + // `SoftwareConfig.image_version` or the system default. + string image_uri = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. The Compute Engine machine type used for cluster instances. // @@ -330,35 +410,32 @@ message InstanceGroupConfig { // * `projects/[project_id]/zones/us-east1-a/machineTypes/n1-standard-2` // * `n1-standard-2` // - // **Auto Zone Exception**: If you are using the Cloud Dataproc + // **Auto Zone Exception**: If you are using the Dataproc // [Auto Zone - // Placement](/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement) + // Placement](https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement) // feature, you must use the short name of the machine type // resource, for example, `n1-standard-2`. - string machine_type_uri = 4; + string machine_type_uri = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. Disk option config settings. - DiskConfig disk_config = 5; + DiskConfig disk_config = 5 [(google.api.field_behavior) = OPTIONAL]; - // Optional. Specifies that this instance group contains preemptible + // Output only. Specifies that this instance group contains preemptible // instances. - bool is_preemptible = 6; + bool is_preemptible = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The config for Compute Engine Instance Group // Manager that manages this group. // This is only used for preemptible instance groups. - ManagedGroupConfig managed_group_config = 7; + ManagedGroupConfig managed_group_config = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; // Optional. The Compute Engine accelerator configuration for these // instances. - // - // **Beta Feature**: This feature is still under development. It may be - // changed before final release. - repeated AcceleratorConfig accelerators = 8; + repeated AcceleratorConfig accelerators = 8 [(google.api.field_behavior) = OPTIONAL]; - // Optional. Specifies the minimum cpu platform for the Instance Group. - // See [Cloud Dataproc→Minimum CPU Platform] - // (/dataproc/docs/concepts/compute/dataproc-min-cpu). + // Specifies the minimum cpu platform for the Instance Group. + // See [Dataproc -> Minimum CPU + // Platform](https://cloud.google.com/dataproc/docs/concepts/compute/dataproc-min-cpu). string min_cpu_platform = 9; } @@ -366,28 +443,29 @@ message InstanceGroupConfig { message ManagedGroupConfig { // Output only. The name of the Instance Template used for the Managed // Instance Group. - string instance_template_name = 1; + string instance_template_name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The name of the Instance Group Manager for this group. - string instance_group_manager_name = 2; + string instance_group_manager_name = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Specifies the type and number of accelerator cards attached to the instances -// of an instance group (see [GPUs on Compute Engine](/compute/docs/gpus/)). +// of an instance group (see [GPUs on Compute +// Engine](https://cloud.google.com/compute/docs/gpus/)). message AcceleratorConfig { // Full URL, partial URI, or short name of the accelerator type resource to // expose to this instance. See // [Compute Engine - // AcceleratorTypes](/compute/docs/reference/beta/acceleratorTypes) + // AcceleratorTypes](https://cloud.google.com/compute/docs/reference/beta/acceleratorTypes) // // Examples // * `https://www.googleapis.com/compute/beta/projects/[project_id]/zones/us-east1-a/acceleratorTypes/nvidia-tesla-k80` // * `projects/[project_id]/zones/us-east1-a/acceleratorTypes/nvidia-tesla-k80` // * `nvidia-tesla-k80` // - // **Auto Zone Exception**: If you are using the Cloud Dataproc + // **Auto Zone Exception**: If you are using the Dataproc // [Auto Zone - // Placement](/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement) + // Placement](https://cloud.google.com/dataproc/docs/concepts/configuring-clusters/auto-zone#using_auto_zone_placement) // feature, you must use the short name of the accelerator type // resource, for example, `nvidia-tesla-k80`. string accelerator_type_uri = 1; @@ -401,12 +479,12 @@ message DiskConfig { // Optional. Type of the boot disk (default is "pd-standard"). // Valid values: "pd-ssd" (Persistent Disk Solid State Drive) or // "pd-standard" (Persistent Disk Hard Disk Drive). - string boot_disk_type = 3; + string boot_disk_type = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. Size in GB of the boot disk (default is 500GB). - int32 boot_disk_size_gb = 1; + int32 boot_disk_size_gb = 1 [(google.api.field_behavior) = OPTIONAL]; - // Optional. Number of attached SSDs, from 0 to 4 (default is 0). + // Number of attached SSDs, from 0 to 4 (default is 0). // If SSDs are not attached, the boot disk is used to store runtime logs and // [HDFS](https://hadoop.apache.org/docs/r1.2.1/hdfs_user_guide.html) data. // If one or more SSDs are attached, this runtime bulk @@ -417,26 +495,32 @@ message DiskConfig { // Specifies the cluster auto-delete schedule configuration. message LifecycleConfig { - // Optional. The duration to keep the cluster alive while idling. - // Passing this threshold will cause the cluster to be - // deleted. Valid range: **[10m, 14d]**. - // - // Example: **"10m"**, the minimum value, to delete the - // cluster when it has had no jobs running for 10 minutes. - google.protobuf.Duration idle_delete_ttl = 1; - - // Optional. Either the exact time the cluster should be deleted at or + // Optional. The duration to keep the cluster alive while idling (when no jobs + // are running). Passing this threshold will cause the cluster to be + // deleted. Minimum value is 10 minutes; maximum value is 14 days (see JSON + // representation of + // [Duration](https://developers.google.com/protocol-buffers/docs/proto3#json). + google.protobuf.Duration idle_delete_ttl = 1 [(google.api.field_behavior) = OPTIONAL]; + + // Either the exact time the cluster should be deleted at or // the cluster maximum age. oneof ttl { - // Optional. The time when cluster will be auto-deleted. - google.protobuf.Timestamp auto_delete_time = 2; + // Optional. The time when cluster will be auto-deleted. (see JSON representation of + // [Timestamp](https://developers.google.com/protocol-buffers/docs/proto3#json)). + google.protobuf.Timestamp auto_delete_time = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. The lifetime duration of cluster. The cluster will be - // auto-deleted at the end of this period. Valid range: **[10m, 14d]**. - // - // Example: **"1d"**, to delete the cluster 1 day after its creation.. - google.protobuf.Duration auto_delete_ttl = 3; + // auto-deleted at the end of this period. Minimum value is 10 minutes; + // maximum value is 14 days (see JSON representation of + // [Duration](https://developers.google.com/protocol-buffers/docs/proto3#json)). + google.protobuf.Duration auto_delete_ttl = 3 [(google.api.field_behavior) = OPTIONAL]; } + + // Output only. The time when cluster became idle (most recent job finished) + // and became eligible for deletion due to idleness (see JSON representation + // of + // [Timestamp](https://developers.google.com/protocol-buffers/docs/proto3#json)). + google.protobuf.Timestamp idle_start_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Security related configuration, including encryption, Kerberos, etc. @@ -447,80 +531,88 @@ message SecurityConfig { // Specifies Kerberos related configuration. message KerberosConfig { - // Optional. Flag to indicate whether to Kerberize the cluster. - bool enable_kerberos = 1; + // Optional. Flag to indicate whether to Kerberize the cluster (default: false). Set + // this field to true to enable Kerberos on a cluster. + bool enable_kerberos = 1 [(google.api.field_behavior) = OPTIONAL]; // Required. The Cloud Storage URI of a KMS encrypted file containing the root // principal password. - string root_principal_password_uri = 2; + string root_principal_password_uri = 2 [(google.api.field_behavior) = REQUIRED]; // Required. The uri of the KMS key used to encrypt various sensitive // files. - string kms_key_uri = 3; + string kms_key_uri = 3 [(google.api.field_behavior) = REQUIRED]; // Optional. The Cloud Storage URI of the keystore file used for SSL // encryption. If not provided, Dataproc will provide a self-signed // certificate. - string keystore_uri = 4; + string keystore_uri = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. The Cloud Storage URI of the truststore file used for SSL // encryption. If not provided, Dataproc will provide a self-signed // certificate. - string truststore_uri = 5; + string truststore_uri = 5 [(google.api.field_behavior) = OPTIONAL]; // Optional. The Cloud Storage URI of a KMS encrypted file containing the // password to the user provided keystore. For the self-signed certificate, // this password is generated by Dataproc. - string keystore_password_uri = 6; + string keystore_password_uri = 6 [(google.api.field_behavior) = OPTIONAL]; // Optional. The Cloud Storage URI of a KMS encrypted file containing the // password to the user provided key. For the self-signed certificate, this // password is generated by Dataproc. - string key_password_uri = 7; + string key_password_uri = 7 [(google.api.field_behavior) = OPTIONAL]; // Optional. The Cloud Storage URI of a KMS encrypted file containing the // password to the user provided truststore. For the self-signed certificate, // this password is generated by Dataproc. - string truststore_password_uri = 8; + string truststore_password_uri = 8 [(google.api.field_behavior) = OPTIONAL]; // Optional. The remote realm the Dataproc on-cluster KDC will trust, should // the user enable cross realm trust. - string cross_realm_trust_realm = 9; + string cross_realm_trust_realm = 9 [(google.api.field_behavior) = OPTIONAL]; // Optional. The KDC (IP or hostname) for the remote trusted realm in a cross // realm trust relationship. - string cross_realm_trust_kdc = 10; + string cross_realm_trust_kdc = 10 [(google.api.field_behavior) = OPTIONAL]; // Optional. The admin server (IP or hostname) for the remote trusted realm in // a cross realm trust relationship. - string cross_realm_trust_admin_server = 11; + string cross_realm_trust_admin_server = 11 [(google.api.field_behavior) = OPTIONAL]; // Optional. The Cloud Storage URI of a KMS encrypted file containing the // shared password between the on-cluster Kerberos realm and the remote // trusted realm, in a cross realm trust relationship. - string cross_realm_trust_shared_password_uri = 12; + string cross_realm_trust_shared_password_uri = 12 [(google.api.field_behavior) = OPTIONAL]; // Optional. The Cloud Storage URI of a KMS encrypted file containing the // master key of the KDC database. - string kdc_db_key_uri = 13; + string kdc_db_key_uri = 13 [(google.api.field_behavior) = OPTIONAL]; // Optional. The lifetime of the ticket granting ticket, in hours. // If not specified, or user specifies 0, then default value 10 // will be used. - int32 tgt_lifetime_hours = 14; + int32 tgt_lifetime_hours = 14 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The name of the on-cluster Kerberos realm. + // If not specified, the uppercased domain of hostnames will be the realm. + string realm = 15 [(google.api.field_behavior) = OPTIONAL]; } // Specifies an executable to run on a fully configured node and a // timeout period for executable completion. message NodeInitializationAction { // Required. Cloud Storage URI of executable file. - string executable_file = 1; + string executable_file = 1 [(google.api.field_behavior) = REQUIRED]; // Optional. Amount of time executable has to complete. Default is - // 10 minutes. Cluster creation fails with an explanatory error message (the + // 10 minutes (see JSON representation of + // [Duration](https://developers.google.com/protocol-buffers/docs/proto3#json)). + // + // Cluster creation fails with an explanatory error message (the // name of the executable that caused the error and the exceeded timeout // period) if the executable is not completed at end of the timeout period. - google.protobuf.Duration execution_timeout = 2; + google.protobuf.Duration execution_timeout = 2 [(google.api.field_behavior) = OPTIONAL]; } // The status of a cluster and its instances. @@ -544,6 +636,15 @@ message ClusterStatus { // The cluster is being updated. It continues to accept and process jobs. UPDATING = 5; + + // The cluster is being stopped. It cannot be used. + STOPPING = 6; + + // The cluster is currently stopped. It is not ready for use. + STOPPED = 7; + + // The cluster is being started. It is not ready for use. + STARTING = 8; } // The cluster substate. @@ -559,36 +660,37 @@ message ClusterStatus { UNHEALTHY = 1; // The agent-reported status is out of date (may occur if - // Cloud Dataproc loses communication with Agent). + // Dataproc loses communication with Agent). // // Applies to RUNNING state. STALE_STATUS = 2; } // Output only. The cluster's state. - State state = 1; + State state = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Optional details of cluster's state. - string detail = 2; + string detail = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Output only. Time when this state was entered. - google.protobuf.Timestamp state_start_time = 3; + // Output only. Time when this state was entered (see JSON representation of + // [Timestamp](https://developers.google.com/protocol-buffers/docs/proto3#json)). + google.protobuf.Timestamp state_start_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Additional state information that includes // status reported by the agent. - Substate substate = 4; + Substate substate = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Specifies the selection and config of software inside the cluster. message SoftwareConfig { // Optional. The version of software inside the cluster. It must be one of the - // supported [Cloud Dataproc - // Versions](/dataproc/docs/concepts/versioning/dataproc-versions#supported_cloud_dataproc_versions), + // supported [Dataproc + // Versions](https://cloud.google.com/dataproc/docs/concepts/versioning/dataproc-versions#supported_cloud_dataproc_versions), // such as "1.2" (including a subminor version, such as "1.2.29"), or the // ["preview" - // version](/dataproc/docs/concepts/versioning/dataproc-versions#other_versions). + // version](https://cloud.google.com/dataproc/docs/concepts/versioning/dataproc-versions#other_versions). // If unspecified, it defaults to the latest Debian version. - string image_version = 1; + string image_version = 1 [(google.api.field_behavior) = OPTIONAL]; // Optional. The properties to set on daemon config files. // @@ -606,9 +708,9 @@ message SoftwareConfig { // * spark: `spark-defaults.conf` // * yarn: `yarn-site.xml` // - // For more information, see - // [Cluster properties](/dataproc/docs/concepts/cluster-properties). - map properties = 2; + // For more information, see [Cluster + // properties](https://cloud.google.com/dataproc/docs/concepts/cluster-properties). + map properties = 2 [(google.api.field_behavior) = OPTIONAL]; // The set of optional components to activate on the cluster. repeated Component optional_components = 3; @@ -630,13 +732,13 @@ message ClusterMetrics { message CreateClusterRequest { // Required. The ID of the Google Cloud Platform project that the cluster // belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The Cloud Dataproc region in which to handle the request. - string region = 3; + // Required. The Dataproc region in which to handle the request. + string region = 3 [(google.api.field_behavior) = REQUIRED]; // Required. The cluster to create. - Cluster cluster = 2; + Cluster cluster = 2 [(google.api.field_behavior) = REQUIRED]; // Optional. A unique id used to identify the request. If the server // receives two [CreateClusterRequest][google.cloud.dataproc.v1beta2.CreateClusterRequest] requests with the same @@ -649,33 +751,34 @@ message CreateClusterRequest { // // The id must contain only letters (a-z, A-Z), numbers (0-9), // underscores (_), and hyphens (-). The maximum length is 40 characters. - string request_id = 4; + string request_id = 4 [(google.api.field_behavior) = OPTIONAL]; } // A request to update a cluster. message UpdateClusterRequest { // Required. The ID of the Google Cloud Platform project the // cluster belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The Cloud Dataproc region in which to handle the request. - string region = 5; + // Required. The Dataproc region in which to handle the request. + string region = 5 [(google.api.field_behavior) = REQUIRED]; // Required. The cluster name. - string cluster_name = 2; + string cluster_name = 2 [(google.api.field_behavior) = REQUIRED]; // Required. The changes to the cluster. - Cluster cluster = 3; + Cluster cluster = 3 [(google.api.field_behavior) = REQUIRED]; // Optional. Timeout for graceful YARN decomissioning. Graceful // decommissioning allows removing nodes from the cluster without // interrupting jobs in progress. Timeout specifies how long to wait for jobs // in progress to finish before forcefully removing nodes (and potentially // interrupting jobs). Default timeout is 0 (for forceful decommission), and - // the maximum allowed timeout is 1 day. + // the maximum allowed timeout is 1 day (see JSON representation of + // [Duration](https://developers.google.com/protocol-buffers/docs/proto3#json)). // // Only supported on Dataproc image versions 1.2 and higher. - google.protobuf.Duration graceful_decommission_timeout = 6; + google.protobuf.Duration graceful_decommission_timeout = 6 [(google.api.field_behavior) = OPTIONAL]; // Required. Specifies the path, relative to `Cluster`, of // the field to update. For example, to change the number of workers @@ -737,7 +840,7 @@ message UpdateClusterRequest { // autoscaling policies // // - google.protobuf.FieldMask update_mask = 4; + google.protobuf.FieldMask update_mask = 4 [(google.api.field_behavior) = REQUIRED]; // Optional. A unique id used to identify the request. If the server // receives two [UpdateClusterRequest][google.cloud.dataproc.v1beta2.UpdateClusterRequest] requests with the same @@ -750,24 +853,24 @@ message UpdateClusterRequest { // // The id must contain only letters (a-z, A-Z), numbers (0-9), // underscores (_), and hyphens (-). The maximum length is 40 characters. - string request_id = 7; + string request_id = 7 [(google.api.field_behavior) = OPTIONAL]; } // A request to delete a cluster. message DeleteClusterRequest { // Required. The ID of the Google Cloud Platform project that the cluster // belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The Cloud Dataproc region in which to handle the request. - string region = 3; + // Required. The Dataproc region in which to handle the request. + string region = 3 [(google.api.field_behavior) = REQUIRED]; // Required. The cluster name. - string cluster_name = 2; + string cluster_name = 2 [(google.api.field_behavior) = REQUIRED]; // Optional. Specifying the `cluster_uuid` means the RPC should fail // (with error NOT_FOUND) if cluster with specified UUID does not exist. - string cluster_uuid = 4; + string cluster_uuid = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. A unique id used to identify the request. If the server // receives two [DeleteClusterRequest][google.cloud.dataproc.v1beta2.DeleteClusterRequest] requests with the same @@ -780,32 +883,32 @@ message DeleteClusterRequest { // // The id must contain only letters (a-z, A-Z), numbers (0-9), // underscores (_), and hyphens (-). The maximum length is 40 characters. - string request_id = 5; + string request_id = 5 [(google.api.field_behavior) = OPTIONAL]; } // Request to get the resource representation for a cluster in a project. message GetClusterRequest { // Required. The ID of the Google Cloud Platform project that the cluster // belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The Cloud Dataproc region in which to handle the request. - string region = 3; + // Required. The Dataproc region in which to handle the request. + string region = 3 [(google.api.field_behavior) = REQUIRED]; // Required. The cluster name. - string cluster_name = 2; + string cluster_name = 2 [(google.api.field_behavior) = REQUIRED]; } // A request to list the clusters in a project. message ListClustersRequest { // Required. The ID of the Google Cloud Platform project that the cluster // belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The Cloud Dataproc region in which to handle the request. - string region = 4; + // Required. The Dataproc region in which to handle the request. + string region = 4 [(google.api.field_behavior) = REQUIRED]; - // Optional. A filter constraining the clusters to list. Filters are + // Optional. A filter constraining the clusters to list. Filters are // case-sensitive and have the following syntax: // // field = value [AND [field = value]] ... @@ -824,37 +927,37 @@ message ListClustersRequest { // // status.state = ACTIVE AND clusterName = mycluster // AND labels.env = staging AND labels.starred = * - string filter = 5; + string filter = 5 [(google.api.field_behavior) = OPTIONAL]; // Optional. The standard List page size. - int32 page_size = 2; + int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. The standard List page token. - string page_token = 3; + string page_token = 3 [(google.api.field_behavior) = OPTIONAL]; } // The list of all clusters in a project. message ListClustersResponse { // Output only. The clusters in the project. - repeated Cluster clusters = 1; + repeated Cluster clusters = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. This token is included in the response if there are more // results to fetch. To fetch additional results, provide this value as the // `page_token` in a subsequent ListClustersRequest. - string next_page_token = 2; + string next_page_token = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } // A request to collect cluster diagnostic information. message DiagnoseClusterRequest { // Required. The ID of the Google Cloud Platform project that the cluster // belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The Cloud Dataproc region in which to handle the request. - string region = 3; + // Required. The Dataproc region in which to handle the request. + string region = 3 [(google.api.field_behavior) = REQUIRED]; // Required. The cluster name. - string cluster_name = 2; + string cluster_name = 2 [(google.api.field_behavior) = REQUIRED]; } // The location of diagnostic output. @@ -862,7 +965,7 @@ message DiagnoseClusterResults { // Output only. The Cloud Storage URI of the diagnostic output. // The output report is a plain text file with a summary of collected // diagnostics. - string output_uri = 1; + string output_uri = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Reservation Affinity for consuming Zonal reservation. @@ -883,11 +986,11 @@ message ReservationAffinity { } // Optional. Type of reservation to consume - Type consume_reservation_type = 1; + Type consume_reservation_type = 1 [(google.api.field_behavior) = OPTIONAL]; // Optional. Corresponds to the label key of reservation resource. - string key = 2; + string key = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. Corresponds to the label values of reservation resource. - repeated string values = 3; + repeated string values = 3 [(google.api.field_behavior) = OPTIONAL]; } diff --git a/third_party/googleapis/google/cloud/dataproc/v1beta2/dataproc_gapic.legacy.yaml b/third_party/googleapis/google/cloud/dataproc/v1beta2/dataproc_gapic.legacy.yaml new file mode 100644 index 000000000..33ab4c380 --- /dev/null +++ b/third_party/googleapis/google/cloud/dataproc/v1beta2/dataproc_gapic.legacy.yaml @@ -0,0 +1,96 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 2.0.0 +language_settings: + java: + package_name: com.google.cloud.dataproc.v1beta2 + python: + package_name: google.cloud.dataproc_v1beta2.gapic + go: + package_name: cloud.google.com/go/dataproc/apiv1beta2 + csharp: + package_name: Google.Cloud.Dataproc.V1Beta2 + ruby: + package_name: Google::Cloud::Dataproc::V1beta2 + php: + package_name: Google\Cloud\Dataproc\V1beta2 + nodejs: + package_name: dataproc.v1beta2 + domain_layer_location: google-cloud +interfaces: +- name: google.cloud.dataproc.v1beta2.ClusterController + smoke_test: + method: ListClusters + init_fields: + - project_id=$PROJECT_ID + - region="global" + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - INTERNAL + - DEADLINE_EXCEEDED + - UNAVAILABLE + - name: non_idempotent + retry_codes: + - UNAVAILABLE + methods: + - name: CreateCluster + retry_codes_name: non_idempotent + - name: UpdateCluster + retry_codes_name: non_idempotent + - name: DeleteCluster + retry_codes_name: non_idempotent + - name: GetCluster + retry_codes_name: idempotent + - name: ListClusters + retry_codes_name: idempotent + - name: DiagnoseCluster + retry_codes_name: non_idempotent +- name: google.cloud.dataproc.v1beta2.JobController + retry_codes_def: + - name: idempotent + retry_codes: + - DEADLINE_EXCEEDED + - INTERNAL + - UNAVAILABLE + - name: non_idempotent + retry_codes: + - UNAVAILABLE + methods: + - name: SubmitJob + retry_codes_name: non_idempotent + - name: GetJob + retry_codes_name: idempotent + - name: ListJobs + retry_codes_name: idempotent + - name: UpdateJob + retry_codes_name: non_idempotent + - name: CancelJob + retry_codes_name: idempotent + - name: DeleteJob + retry_codes_name: non_idempotent +- name: google.cloud.dataproc.v1beta2.WorkflowTemplateService + retry_codes_def: + - name: idempotent + retry_codes: + - DEADLINE_EXCEEDED + - INTERNAL + - UNAVAILABLE + - name: non_idempotent + retry_codes: + - UNAVAILABLE + methods: + - name: CreateWorkflowTemplate + retry_codes_name: non_idempotent + - name: GetWorkflowTemplate + retry_codes_name: idempotent + - name: InstantiateWorkflowTemplate + retry_codes_name: non_idempotent + - name: InstantiateInlineWorkflowTemplate + retry_codes_name: non_idempotent + - name: UpdateWorkflowTemplate + retry_codes_name: non_idempotent + - name: ListWorkflowTemplates + retry_codes_name: idempotent + - name: DeleteWorkflowTemplate + retry_codes_name: non_idempotent diff --git a/third_party/googleapis/google/cloud/dataproc/v1beta2/dataproc_gapic.yaml b/third_party/googleapis/google/cloud/dataproc/v1beta2/dataproc_gapic.yaml index 576bfc8e2..93c54d2d4 100644 --- a/third_party/googleapis/google/cloud/dataproc/v1beta2/dataproc_gapic.yaml +++ b/third_party/googleapis/google/cloud/dataproc/v1beta2/dataproc_gapic.yaml @@ -1,6 +1,5 @@ type: com.google.api.codegen.ConfigProto -config_schema_version: 1.0.0 -# The settings of generated code in a specific language. +config_schema_version: 2.0.0 language_settings: java: package_name: com.google.cloud.dataproc.v1beta2 @@ -17,172 +16,12 @@ language_settings: nodejs: package_name: dataproc.v1beta2 domain_layer_location: google-cloud -# A list of API interface configurations. interfaces: -# The fully qualified name of the API interface. -- name: google.cloud.dataproc.v1beta2.AutoscalingPolicyService - # A list of resource collection configurations. - # Consists of a name_pattern and an entity_name. - # The name_pattern is a pattern to describe the names of the resources of this - # collection, using the platform's conventions for URI patterns. A generator - # may use this to generate methods to compose and decompose such names. The - # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; - # those will be taken as hints for the parameter names of the generated - # methods. If empty, no name methods are generated. - # The entity_name is the name to be used as a basis for generated methods and - # classes. - collections: - - name_pattern: projects/{project}/regions/{region} - entity_name: region - - name_pattern: projects/{project}/regions/{region}/autoscalingPolicies/{autoscaling_policy} - entity_name: autoscaling_policy - # Definition for retryable codes. - retry_codes_def: - - name: idempotent - retry_codes: - - DEADLINE_EXCEEDED - - UNAVAILABLE - - name: non_idempotent - retry_codes: [] - # Definition for retry/backoff parameters. - retry_params_def: - - name: default - initial_retry_delay_millis: 100 - retry_delay_multiplier: 1.3 - max_retry_delay_millis: 60000 - initial_rpc_timeout_millis: 20000 - rpc_timeout_multiplier: 1 - max_rpc_timeout_millis: 20000 - total_timeout_millis: 600000 - # A list of method configurations. - # Common properties: - # - # name - The simple name of the method. - # - # flattening - Specifies the configuration for parameter flattening. - # Describes the parameter groups for which a generator should produce method - # overloads which allow a client to directly pass request message fields as - # method parameters. This information may or may not be used, depending on - # the target language. - # Consists of groups, which each represent a list of parameters to be - # flattened. Each parameter listed must be a field of the request message. - # - # required_fields - Fields that are always required for a request to be - # valid. - # - # page_streaming - Specifies the configuration for paging. - # Describes information for generating a method which transforms a paging - # list RPC into a stream of resources. - # Consists of a request and a response. - # The request specifies request information of the list method. It defines - # which fields match the paging pattern in the request. The request consists - # of a page_size_field and a token_field. The page_size_field is the name of - # the optional field specifying the maximum number of elements to be - # returned in the response. The token_field is the name of the field in the - # request containing the page token. - # The response specifies response information of the list method. It defines - # which fields match the paging pattern in the response. The response - # consists of a token_field and a resources_field. The token_field is the - # name of the field in the response containing the next page token. The - # resources_field is the name of the field in the response containing the - # list of resources belonging to the page. - # - # retry_codes_name - Specifies the configuration for retryable codes. The - # name must be defined in interfaces.retry_codes_def. - # - # retry_params_name - Specifies the configuration for retry/backoff - # parameters. The name must be defined in interfaces.retry_params_def. - # - # field_name_patterns - Maps the field name of the request type to - # entity_name of interfaces.collections. - # Specifies the string pattern that the field must follow. - # - # timeout_millis - Specifies the default timeout for a non-retrying call. If - # the call is retrying, refer to retry_params_name instead. +- name: google.cloud.dataproc.v1.AutoscalingPolicyService methods: - - name: CreateAutoscalingPolicy - flattening: - groups: - - parameters: - - parent - - policy - required_fields: - - parent - - policy - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: region - timeout_millis: 60000 - name: UpdateAutoscalingPolicy - flattening: - groups: - - parameters: - - policy - required_fields: - - policy - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - policy.name: autoscaling_policy - timeout_millis: 60000 - - name: GetAutoscalingPolicy - flattening: - groups: - - parameters: - - name - required_fields: - - name retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: autoscaling_policy - timeout_millis: 60000 - - name: ListAutoscalingPolicies - flattening: - groups: - - parameters: - - parent - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: policies - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: region - timeout_millis: 60000 - - name: DeleteAutoscalingPolicy - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - name: autoscaling_policy - timeout_millis: 60000 -# The fully qualified name of the API interface. - name: google.cloud.dataproc.v1beta2.ClusterController - # A list of resource collection configurations. - # Consists of a name_pattern and an entity_name. - # The name_pattern is a pattern to describe the names of the resources of this - # collection, using the platform's conventions for URI patterns. A generator - # may use this to generate methods to compose and decompose such names. The - # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; - # those will be taken as hints for the parameter names of the generated - # methods. If empty, no name methods are generated. - # The entity_name is the name to be used as a basis for generated methods and - # classes. - collections: [] - # Definition for smoke test. smoke_test: method: ListClusters init_fields: @@ -198,209 +37,29 @@ interfaces: - name: non_idempotent retry_codes: - UNAVAILABLE - # Definition for retry/backoff parameters. retry_params_def: - name: default initial_retry_delay_millis: 100 retry_delay_multiplier: 1.3 max_retry_delay_millis: 60000 - initial_rpc_timeout_millis: 10000 + initial_rpc_timeout_millis: 20000 rpc_timeout_multiplier: 1 - max_rpc_timeout_millis: 10000 - total_timeout_millis: 300000 - # A list of method configurations. - # Common properties: - # - # name - The simple name of the method. - # - # flattening - Specifies the configuration for parameter flattening. - # Describes the parameter groups for which a generator should produce method - # overloads which allow a client to directly pass request message fields as - # method parameters. This information may or may not be used, depending on - # the target language. - # Consists of groups, which each represent a list of parameters to be - # flattened. Each parameter listed must be a field of the request message. - # - # required_fields - Fields that are always required for a request to be - # valid. - # - # page_streaming - Specifies the configuration for paging. - # Describes information for generating a method which transforms a paging - # list RPC into a stream of resources. - # Consists of a request and a response. - # The request specifies request information of the list method. It defines - # which fields match the paging pattern in the request. The request consists - # of a page_size_field and a token_field. The page_size_field is the name of - # the optional field specifying the maximum number of elements to be - # returned in the response. The token_field is the name of the field in the - # request containing the page token. - # The response specifies response information of the list method. It defines - # which fields match the paging pattern in the response. The response - # consists of a token_field and a resources_field. The token_field is the - # name of the field in the response containing the next page token. The - # resources_field is the name of the field in the response containing the - # list of resources belonging to the page. - # - # retry_codes_name - Specifies the configuration for retryable codes. The - # name must be defined in interfaces.retry_codes_def. - # - # retry_params_name - Specifies the configuration for retry/backoff - # parameters. The name must be defined in interfaces.retry_params_def. - # - # field_name_patterns - Maps the field name of the request type to - # entity_name of interfaces.collections. - # Specifies the string pattern that the field must follow. - # - # timeout_millis - Specifies the default timeout for a non-retrying call. If - # the call is retrying, refer to retry_params_name instead. + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 methods: - name: CreateCluster - flattening: - groups: - - parameters: - - project_id - - region - - cluster - required_fields: - - project_id - - region - - cluster retry_codes_name: non_idempotent - retry_params_name: default - timeout_millis: 30000 - long_running: - return_type: google.cloud.dataproc.v1beta2.Cluster - metadata_type: google.cloud.dataproc.v1beta2.ClusterOperationMetadata - implements_delete: false - implements_cancel: false - initial_poll_delay_millis: 1000 - poll_delay_multiplier: 2 - max_poll_delay_millis: 10000 - total_poll_timeout_millis: 900000 - name: UpdateCluster - flattening: - groups: - - parameters: - - project_id - - region - - cluster_name - - cluster - - update_mask - required_fields: - - project_id - - region - - cluster_name - - cluster - - update_mask retry_codes_name: non_idempotent - retry_params_name: default - timeout_millis: 30000 - long_running: - return_type: google.cloud.dataproc.v1beta2.Cluster - metadata_type: google.cloud.dataproc.v1beta2.ClusterOperationMetadata - implements_delete: false - implements_cancel: false - initial_poll_delay_millis: 1000 - poll_delay_multiplier: 2 - max_poll_delay_millis: 10000 - total_poll_timeout_millis: 900000 - name: DeleteCluster - flattening: - groups: - - parameters: - - project_id - - region - - cluster_name - required_fields: - - project_id - - region - - cluster_name retry_codes_name: non_idempotent - retry_params_name: default - timeout_millis: 30000 - long_running: - return_type: google.protobuf.Empty - metadata_type: google.cloud.dataproc.v1beta2.ClusterOperationMetadata - implements_delete: false - implements_cancel: false - initial_poll_delay_millis: 1000 - poll_delay_multiplier: 2 - max_poll_delay_millis: 10000 - total_poll_timeout_millis: 900000 - name: GetCluster - flattening: - groups: - - parameters: - - project_id - - region - - cluster_name - required_fields: - - project_id - - region - - cluster_name retry_codes_name: idempotent - retry_params_name: default - timeout_millis: 60000 - name: ListClusters - flattening: - groups: - - parameters: - - project_id - - region - - parameters: - - project_id - - region - - filter - required_fields: - - project_id - - region - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: clusters retry_codes_name: idempotent - retry_params_name: default - timeout_millis: 60000 - name: DiagnoseCluster - flattening: - groups: - - parameters: - - project_id - - region - - cluster_name - required_fields: - - project_id - - region - - cluster_name retry_codes_name: non_idempotent - retry_params_name: default - timeout_millis: 60000 - long_running: - return_type: google.protobuf.Empty - metadata_type: google.cloud.dataproc.v1beta2.DiagnoseClusterResults - implements_delete: false - implements_cancel: false - initial_poll_delay_millis: 1000 - poll_delay_multiplier: 2 - max_poll_delay_millis: 10000 - total_poll_timeout_millis: 30000 - # The fully qualified name of the API interface. - name: google.cloud.dataproc.v1beta2.JobController - # A list of resource collection configurations. - # Consists of a name_pattern and an entity_name. - # The name_pattern is a pattern to describe the names of the resources of this - # collection, using the platform's conventions for URI patterns. A generator - # may use this to generate methods to compose and decompose such names. The - # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; - # those will be taken as hints for the parameter names of the generated - # methods. If empty, no name methods are generated. - # The entity_name is the name to be used as a basis for generated methods and - # classes. - collections: [] - # Definition for retryable codes. retry_codes_def: - name: idempotent retry_codes: @@ -410,169 +69,20 @@ interfaces: - name: non_idempotent retry_codes: - UNAVAILABLE - # Definition for retry/backoff parameters. - retry_params_def: - - name: default - initial_retry_delay_millis: 100 - retry_delay_multiplier: 1.3 - max_retry_delay_millis: 60000 - initial_rpc_timeout_millis: 30000 - rpc_timeout_multiplier: 1 - max_rpc_timeout_millis: 30000 - total_timeout_millis: 900000 - # A list of method configurations. - # Common properties: - # - # name - The simple name of the method. - # - # flattening - Specifies the configuration for parameter flattening. - # Describes the parameter groups for which a generator should produce method - # overloads which allow a client to directly pass request message fields as - # method parameters. This information may or may not be used, depending on - # the target language. - # Consists of groups, which each represent a list of parameters to be - # flattened. Each parameter listed must be a field of the request message. - # - # required_fields - Fields that are always required for a request to be - # valid. - # - # page_streaming - Specifies the configuration for paging. - # Describes information for generating a method which transforms a paging - # list RPC into a stream of resources. - # Consists of a request and a response. - # The request specifies request information of the list method. It defines - # which fields match the paging pattern in the request. The request consists - # of a page_size_field and a token_field. The page_size_field is the name of - # the optional field specifying the maximum number of elements to be - # returned in the response. The token_field is the name of the field in the - # request containing the page token. - # The response specifies response information of the list method. It defines - # which fields match the paging pattern in the response. The response - # consists of a token_field and a resources_field. The token_field is the - # name of the field in the response containing the next page token. The - # resources_field is the name of the field in the response containing the - # list of resources belonging to the page. - # - # retry_codes_name - Specifies the configuration for retryable codes. The - # name must be defined in interfaces.retry_codes_def. - # - # retry_params_name - Specifies the configuration for retry/backoff - # parameters. The name must be defined in interfaces.retry_params_def. - # - # field_name_patterns - Maps the field name of the request type to - # entity_name of interfaces.collections. - # Specifies the string pattern that the field must follow. - # - # timeout_millis - Specifies the default timeout for a non-retrying call. If - # the call is retrying, refer to retry_params_name instead. methods: - name: SubmitJob - flattening: - groups: - - parameters: - - project_id - - region - - job - required_fields: - - project_id - - region - - job retry_codes_name: non_idempotent - retry_params_name: default - timeout_millis: 30000 - name: GetJob - flattening: - groups: - - parameters: - - project_id - - region - - job_id - required_fields: - - project_id - - region - - job_id retry_codes_name: idempotent - retry_params_name: default - timeout_millis: 30000 - name: ListJobs - flattening: - groups: - - parameters: - - project_id - - region - - parameters: - - project_id - - region - - filter - required_fields: - - project_id - - region - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: jobs retry_codes_name: idempotent - retry_params_name: default - timeout_millis: 30000 - name: UpdateJob - required_fields: - - project_id - - region - - job_id - - job - - update_mask retry_codes_name: non_idempotent - retry_params_name: default - timeout_millis: 30000 - name: CancelJob - flattening: - groups: - - parameters: - - project_id - - region - - job_id - required_fields: - - project_id - - region - - job_id retry_codes_name: idempotent - retry_params_name: default - timeout_millis: 30000 - name: DeleteJob - flattening: - groups: - - parameters: - - project_id - - region - - job_id - required_fields: - - project_id - - region - - job_id retry_codes_name: non_idempotent - retry_params_name: default - timeout_millis: 30000 - # The fully qualified name of the API interface. - name: google.cloud.dataproc.v1beta2.WorkflowTemplateService - # A list of resource collection configurations. - # Consists of a name_pattern and an entity_name. - # The name_pattern is a pattern to describe the names of the resources of this - # collection, using the platform's conventions for URI patterns. A generator - # may use this to generate methods to compose and decompose such names. The - # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; - # those will be taken as hints for the parameter names of the generated - # methods. If empty, no name methods are generated. - # The entity_name is the name to be used as a basis for generated methods and - # classes. - collections: - - name_pattern: projects/{project}/regions/{region} - entity_name: region - - name_pattern: projects/{project}/regions/{region}/workflowTemplates/{workflow_template} - entity_name: workflow_template - # Definition for retryable codes. retry_codes_def: - name: idempotent retry_codes: @@ -582,212 +92,18 @@ interfaces: - name: non_idempotent retry_codes: - UNAVAILABLE - # Definition for retry/backoff parameters. - retry_params_def: - - name: default - initial_retry_delay_millis: 100 - retry_delay_multiplier: 1.3 - max_retry_delay_millis: 60000 - initial_rpc_timeout_millis: 20000 - rpc_timeout_multiplier: 1 - max_rpc_timeout_millis: 20000 - total_timeout_millis: 600000 - # A list of method configurations. - # Common properties: - # - # name - The simple name of the method. - # - # flattening - Specifies the configuration for parameter flattening. - # Describes the parameter groups for which a generator should produce method - # overloads which allow a client to directly pass request message fields as - # method parameters. This information may or may not be used, depending on - # the target language. - # Consists of groups, which each represent a list of parameters to be - # flattened. Each parameter listed must be a field of the request message. - # - # required_fields - Fields that are always required for a request to be - # valid. - # - # page_streaming - Specifies the configuration for paging. - # Describes information for generating a method which transforms a paging - # list RPC into a stream of resources. - # Consists of a request and a response. - # The request specifies request information of the list method. It defines - # which fields match the paging pattern in the request. The request consists - # of a page_size_field and a token_field. The page_size_field is the name of - # the optional field specifying the maximum number of elements to be - # returned in the response. The token_field is the name of the field in the - # request containing the page token. - # The response specifies response information of the list method. It defines - # which fields match the paging pattern in the response. The response - # consists of a token_field and a resources_field. The token_field is the - # name of the field in the response containing the next page token. The - # resources_field is the name of the field in the response containing the - # list of resources belonging to the page. - # - # retry_codes_name - Specifies the configuration for retryable codes. The - # name must be defined in interfaces.retry_codes_def. - # - # retry_params_name - Specifies the configuration for retry/backoff - # parameters. The name must be defined in interfaces.retry_params_def. - # - # field_name_patterns - Maps the field name of the request type to - # entity_name of interfaces.collections. - # Specifies the string pattern that the field must follow. - # - # timeout_millis - Specifies the default timeout for a non-retrying call. If - # the call is retrying, refer to retry_params_name instead. methods: - name: CreateWorkflowTemplate - flattening: - groups: - - parameters: - - parent - - template - required_fields: - - parent - - template retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: region - timeout_millis: 30000 - name: GetWorkflowTemplate - flattening: - groups: - - parameters: - - name - required_fields: - - name retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: workflow_template - timeout_millis: 60000 - name: InstantiateWorkflowTemplate - flattening: - groups: - - parameters: - - name - - parameters: - - name - - parameters - required_fields: - - name retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - name: workflow_template - timeout_millis: 60000 - long_running: - return_type: google.protobuf.Empty - metadata_type: google.cloud.dataproc.v1beta2.WorkflowMetadata - implements_delete: false - implements_cancel: false - initial_poll_delay_millis: 1000 - poll_delay_multiplier: 2 - max_poll_delay_millis: 10000 - total_poll_timeout_millis: 43200000 - name: InstantiateInlineWorkflowTemplate - flattening: - groups: - - parameters: - - parent - - template - required_fields: - - parent - - template retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: region - timeout_millis: 60000 - long_running: - return_type: google.protobuf.Empty - metadata_type: google.cloud.dataproc.v1beta2.WorkflowMetadata - implements_delete: false - implements_cancel: false - initial_poll_delay_millis: 1000 - poll_delay_multiplier: 2 - max_poll_delay_millis: 10000 - total_poll_timeout_millis: 43200000 - name: UpdateWorkflowTemplate - flattening: - groups: - - parameters: - - template - required_fields: - - template retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - template.name: workflow_template - timeout_millis: 60000 - name: ListWorkflowTemplates - flattening: - groups: - - parameters: - - parent - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: templates retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: region - timeout_millis: 60000 - name: DeleteWorkflowTemplate - flattening: - groups: - - parameters: - - name - required_fields: - - name retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - name: workflow_template - timeout_millis: 60000 -resource_name_generation: -- message_name: AutoscalingPolicy - field_entity_map: - name: autoscaling_policy -- message_name: CreateAutoscalingPolicyRequest - field_entity_map: - parent: region -- message_name: GetAutoscalingPolicyRequest - field_entity_map: - name: autoscaling_policy -- message_name: ListAutoscalingPoliciesRequest - field_entity_map: - parent: region -- message_name: DeleteAutoscalingPolicyRequest - field_entity_map: - name: autoscaling_policy -- message_name: WorkflowTemplate - field_entity_map: - name: workflow_template -- message_name: CreateWorkflowTemplateRequest - field_entity_map: - parent: region -- message_name: GetWorkflowTemplateRequest - field_entity_map: - name: workflow_template -- message_name: InstantiateWorkflowTemplateRequest - field_entity_map: - name: workflow_template -- message_name: InstantiateInlineWorkflowTemplateRequest - field_entity_map: - parent: region -- message_name: ListWorkflowTemplatesRequest - field_entity_map: - parent: region -- message_name: DeleteWorkflowTemplateRequest - field_entity_map: - name: workflow_template diff --git a/third_party/googleapis/google/cloud/dataproc/v1beta2/dataproc_grpc_service_config.json b/third_party/googleapis/google/cloud/dataproc/v1beta2/dataproc_grpc_service_config.json new file mode 100755 index 000000000..89c3fb0d3 --- /dev/null +++ b/third_party/googleapis/google/cloud/dataproc/v1beta2/dataproc_grpc_service_config.json @@ -0,0 +1,215 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.dataproc.v1beta2.AutoscalingPolicyService", + "method": "CreateAutoscalingPolicy" + }, + { + "service": "google.cloud.dataproc.v1beta2.AutoscalingPolicyService", + "method": "DeleteAutoscalingPolicy" + } + ], + "timeout": "600s" + }, + { + "name": [ + { + "service": "google.cloud.dataproc.v1beta2.AutoscalingPolicyService", + "method": "UpdateAutoscalingPolicy" + }, + { + "service": "google.cloud.dataproc.v1beta2.AutoscalingPolicyService", + "method": "GetAutoscalingPolicy" + }, + { + "service": "google.cloud.dataproc.v1beta2.AutoscalingPolicyService", + "method": "ListAutoscalingPolicies" + } + ], + "timeout": "600s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dataproc.v1beta2.ClusterController", + "method": "CreateCluster" + }, + { + "service": "google.cloud.dataproc.v1beta2.ClusterController", + "method": "UpdateCluster" + }, + { + "service": "google.cloud.dataproc.v1beta2.ClusterController", + "method": "DeleteCluster" + }, + { + "service": "google.cloud.dataproc.v1beta2.ClusterController", + "method": "DiagnoseCluster" + }, + { + "service": "google.cloud.dataproc.v1beta2.ClusterController", + "method": "StartCluster" + }, + { + "service": "google.cloud.dataproc.v1beta2.ClusterController", + "method": "StopCluster" + } + ], + "timeout": "300s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dataproc.v1beta2.ClusterController", + "method": "GetCluster" + }, + { + "service": "google.cloud.dataproc.v1beta2.ClusterController", + "method": "ListClusters" + } + ], + "timeout": "300s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "INTERNAL", + "DEADLINE_EXCEEDED", + "UNAVAILABLE" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dataproc.v1beta2.JobController", + "method": "SubmitJob" + }, + { + "service": "google.cloud.dataproc.v1beta2.JobController", + "method": "SubmitJobAsOperation" + }, + { + "service": "google.cloud.dataproc.v1beta2.JobController", + "method": "UpdateJob" + }, + { + "service": "google.cloud.dataproc.v1beta2.JobController", + "method": "DeleteJob" + } + ], + "timeout": "900s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dataproc.v1beta2.JobController", + "method": "GetJob" + }, + { + "service": "google.cloud.dataproc.v1beta2.JobController", + "method": "ListJobs" + }, + { + "service": "google.cloud.dataproc.v1beta2.JobController", + "method": "CancelJob" + } + ], + "timeout": "900s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "INTERNAL", + "UNAVAILABLE" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dataproc.v1beta2.WorkflowTemplateService", + "method": "CreateWorkflowTemplate" + }, + { + "service": "google.cloud.dataproc.v1beta2.WorkflowTemplateService", + "method": "InstantiateWorkflowTemplate" + }, + { + "service": "google.cloud.dataproc.v1beta2.WorkflowTemplateService", + "method": "InstantiateInlineWorkflowTemplate" + }, + { + "service": "google.cloud.dataproc.v1beta2.WorkflowTemplateService", + "method": "UpdateWorkflowTemplate" + }, + { + "service": "google.cloud.dataproc.v1beta2.WorkflowTemplateService", + "method": "DeleteWorkflowTemplate" + } + ], + "timeout": "600s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dataproc.v1beta2.WorkflowTemplateService", + "method": "GetWorkflowTemplate" + }, + { + "service": "google.cloud.dataproc.v1beta2.WorkflowTemplateService", + "method": "ListWorkflowTemplates" + } + ], + "timeout": "600s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "DEADLINE_EXCEEDED", + "INTERNAL", + "UNAVAILABLE" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/cloud/dataproc/v1beta2/dataproc_v1beta2.yaml b/third_party/googleapis/google/cloud/dataproc/v1beta2/dataproc_v1beta2.yaml new file mode 100644 index 000000000..c7b7a18da --- /dev/null +++ b/third_party/googleapis/google/cloud/dataproc/v1beta2/dataproc_v1beta2.yaml @@ -0,0 +1,94 @@ +type: google.api.Service +config_version: 2 +name: dataproc.googleapis.com +title: Cloud Dataproc API + +apis: +- name: google.cloud.dataproc.v1beta2.AutoscalingPolicyService +- name: google.cloud.dataproc.v1beta2.ClusterController +- name: google.cloud.dataproc.v1beta2.JobController +- name: google.cloud.dataproc.v1beta2.WorkflowTemplateService + +types: +- name: google.cloud.dataproc.v1beta2.ClusterOperationMetadata +- name: google.cloud.dataproc.v1beta2.DiagnoseClusterResults +- name: google.cloud.dataproc.v1beta2.JobMetadata +- name: google.cloud.dataproc.v1beta2.WorkflowMetadata + +documentation: + summary: 'Manages Hadoop-based clusters and jobs on Google Cloud Platform.' + rules: + - selector: google.iam.v1.IAMPolicy.GetIamPolicy + description: |- + Gets the access control policy for a resource. Returns an empty policy + if the resource exists and does not have a policy set. + + - selector: google.iam.v1.IAMPolicy.SetIamPolicy + description: |- + Sets the access control policy on the specified resource. Replaces + any existing policy. + + Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and + PERMISSION_DENIED + + - selector: google.iam.v1.IAMPolicy.TestIamPermissions + description: |- + Returns permissions that a caller has on the specified resource. If the + resource does not exist, this will return an empty set of + permissions, not a NOT_FOUND error. + + Note: This operation is designed to be used for building + permission-aware UIs and command-line tools, not for authorization + checking. This operation may "fail open" without warning. + +http: + rules: + - selector: google.longrunning.Operations.ListOperations + get: '/v1beta2/{name=projects/*/regions/*/operations}' + + - selector: google.longrunning.Operations.GetOperation + get: '/v1beta2/{name=projects/*/regions/*/operations/*}' + + - selector: google.longrunning.Operations.DeleteOperation + delete: '/v1beta2/{name=projects/*/regions/*/operations/*}' + + - selector: google.longrunning.Operations.CancelOperation + post: '/v1beta2/{name=projects/*/regions/*/operations/*}:cancel' + + - selector: google.iam.v1.IAMPolicy.SetIamPolicy + post: '/v1beta2/{resource=projects/*/regions/*/clusters/*}:setIamPolicy' + body: '*' + + - selector: google.iam.v1.IAMPolicy.GetIamPolicy + get: '/v1beta2/{resource=projects/*/regions/*/clusters/*}:getIamPolicy' + + - selector: google.iam.v1.IAMPolicy.TestIamPermissions + post: '/v1beta2/{resource=projects/*/regions/*/clusters/*}:testIamPermissions' + body: '*' + +authentication: + rules: + - selector: 'google.cloud.dataproc.v1beta2.AutoscalingPolicyService.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: 'google.cloud.dataproc.v1beta2.ClusterController.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: 'google.cloud.dataproc.v1beta2.JobController.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: 'google.cloud.dataproc.v1beta2.WorkflowTemplateService.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: 'google.iam.v1.IAMPolicy.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform + - selector: 'google.longrunning.Operations.*' + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform diff --git a/third_party/googleapis/google/cloud/dataproc/v1beta2/jobs.proto b/third_party/googleapis/google/cloud/dataproc/v1beta2/jobs.proto index 4d888dafc..325dc9e57 100644 --- a/third_party/googleapis/google/cloud/dataproc/v1beta2/jobs.proto +++ b/third_party/googleapis/google/cloud/dataproc/v1beta2/jobs.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,15 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.dataproc.v1beta2; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/longrunning/operations.proto"; import "google/protobuf/empty.proto"; import "google/protobuf/field_mask.proto"; import "google/protobuf/timestamp.proto"; @@ -29,12 +31,29 @@ option java_package = "com.google.cloud.dataproc.v1beta2"; // The JobController provides methods to manage jobs. service JobController { + option (google.api.default_host) = "dataproc.googleapis.com"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; + // Submits a job to a cluster. rpc SubmitJob(SubmitJobRequest) returns (Job) { option (google.api.http) = { post: "/v1beta2/projects/{project_id}/regions/{region}/jobs:submit" body: "*" }; + option (google.api.method_signature) = "project_id, region, job"; + } + + // Submits job to a cluster. + rpc SubmitJobAsOperation(SubmitJobRequest) returns (google.longrunning.Operation) { + option (google.api.http) = { + post: "/v1beta2/projects/{project_id}/regions/{region}/jobs:submitAsOperation" + body: "*" + }; + option (google.api.method_signature) = "project_id, region, job"; + option (google.longrunning.operation_info) = { + response_type: "Job" + metadata_type: "JobMetadata" + }; } // Gets the resource representation for a job in a project. @@ -42,6 +61,7 @@ service JobController { option (google.api.http) = { get: "/v1beta2/projects/{project_id}/regions/{region}/jobs/{job_id}" }; + option (google.api.method_signature) = "project_id, region, job_id"; } // Lists regions/{region}/jobs in a project. @@ -49,6 +69,8 @@ service JobController { option (google.api.http) = { get: "/v1beta2/projects/{project_id}/regions/{region}/jobs" }; + option (google.api.method_signature) = "project_id, region"; + option (google.api.method_signature) = "project_id, region, filter"; } // Updates a job in a project. @@ -61,14 +83,15 @@ service JobController { // Starts a job cancellation request. To access the job resource // after cancellation, call - // [regions/{region}/jobs.list](/dataproc/docs/reference/rest/v1beta2/projects.regions.jobs/list) + // [regions/{region}/jobs.list](https://cloud.google.com/dataproc/docs/reference/rest/v1beta2/projects.regions.jobs/list) // or - // [regions/{region}/jobs.get](/dataproc/docs/reference/rest/v1beta2/projects.regions.jobs/get). + // [regions/{region}/jobs.get](https://cloud.google.com/dataproc/docs/reference/rest/v1beta2/projects.regions.jobs/get). rpc CancelJob(CancelJobRequest) returns (Job) { option (google.api.http) = { post: "/v1beta2/projects/{project_id}/regions/{region}/jobs/{job_id}:cancel" body: "*" }; + option (google.api.method_signature) = "project_id, region, job_id"; } // Deletes the job from the project. If the job is active, the delete fails, @@ -77,6 +100,7 @@ service JobController { option (google.api.http) = { delete: "/v1beta2/projects/{project_id}/regions/{region}/jobs/{job_id}" }; + option (google.api.method_signature) = "project_id, region, job_id"; } } @@ -121,7 +145,7 @@ message LoggingConfig { map driver_log_levels = 2; } -// A Cloud Dataproc job for running +// A Dataproc job for running // [Apache Hadoop // MapReduce](https://hadoop.apache.org/docs/current/hadoop-mapreduce-client/hadoop-mapreduce-client-core/MapReduceTutorial.html) // jobs on [Apache Hadoop @@ -148,40 +172,40 @@ message HadoopJob { // include arguments, such as `-libjars` or `-Dfoo=bar`, that can be set as // job properties, since a collision may occur that causes an incorrect job // submission. - repeated string args = 3; + repeated string args = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. Jar file URIs to add to the CLASSPATHs of the // Hadoop driver and tasks. - repeated string jar_file_uris = 4; + repeated string jar_file_uris = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS (Hadoop Compatible Filesystem) URIs of files to be copied // to the working directory of Hadoop drivers and distributed tasks. Useful // for naively parallel tasks. - repeated string file_uris = 5; + repeated string file_uris = 5 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS URIs of archives to be extracted in the working directory of // Hadoop drivers and tasks. Supported file types: // .jar, .tar, .tar.gz, .tgz, or .zip. - repeated string archive_uris = 6; + repeated string archive_uris = 6 [(google.api.field_behavior) = OPTIONAL]; // Optional. A mapping of property names to values, used to configure Hadoop. - // Properties that conflict with values set by the Cloud Dataproc API may be + // Properties that conflict with values set by the Dataproc API may be // overwritten. Can include properties set in /etc/hadoop/conf/*-site and // classes in user code. - map properties = 7; + map properties = 7 [(google.api.field_behavior) = OPTIONAL]; // Optional. The runtime log config for job execution. - LoggingConfig logging_config = 8; + LoggingConfig logging_config = 8 [(google.api.field_behavior) = OPTIONAL]; } -// A Cloud Dataproc job for running [Apache Spark](http://spark.apache.org/) +// A Dataproc job for running [Apache Spark](http://spark.apache.org/) // applications on YARN. +// The specification of the main method to call to drive the job. +// Specify either the jar file that contains the main class or the main class +// name. To pass both a main jar and a main class in that jar, add the jar to +// `CommonJob.jar_file_uris`, and then specify the main class name in +// `main_class`. message SparkJob { - // Required. The specification of the main method to call to drive the job. - // Specify either the jar file that contains the main class or the main class - // name. To pass both a main jar and a main class in that jar, add the jar to - // `CommonJob.jar_file_uris`, and then specify the main class name in - // `main_class`. oneof driver { // The HCFS URI of the jar file that contains the main class. string main_jar_file_uri = 1; @@ -194,69 +218,69 @@ message SparkJob { // Optional. The arguments to pass to the driver. Do not include arguments, // such as `--conf`, that can be set as job properties, since a collision may // occur that causes an incorrect job submission. - repeated string args = 3; + repeated string args = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS URIs of jar files to add to the CLASSPATHs of the // Spark driver and tasks. - repeated string jar_file_uris = 4; + repeated string jar_file_uris = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS URIs of files to be copied to the working directory of // Spark drivers and distributed tasks. Useful for naively parallel tasks. - repeated string file_uris = 5; + repeated string file_uris = 5 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS URIs of archives to be extracted in the working directory // of Spark drivers and tasks. Supported file types: // .jar, .tar, .tar.gz, .tgz, and .zip. - repeated string archive_uris = 6; + repeated string archive_uris = 6 [(google.api.field_behavior) = OPTIONAL]; // Optional. A mapping of property names to values, used to configure Spark. - // Properties that conflict with values set by the Cloud Dataproc API may be + // Properties that conflict with values set by the Dataproc API may be // overwritten. Can include properties set in // /etc/spark/conf/spark-defaults.conf and classes in user code. - map properties = 7; + map properties = 7 [(google.api.field_behavior) = OPTIONAL]; // Optional. The runtime log config for job execution. - LoggingConfig logging_config = 8; + LoggingConfig logging_config = 8 [(google.api.field_behavior) = OPTIONAL]; } -// A Cloud Dataproc job for running +// A Dataproc job for running // [Apache // PySpark](https://spark.apache.org/docs/0.9.0/python-programming-guide.html) // applications on YARN. message PySparkJob { // Required. The HCFS URI of the main Python file to use as the driver. Must // be a .py file. - string main_python_file_uri = 1; + string main_python_file_uri = 1 [(google.api.field_behavior) = REQUIRED]; // Optional. The arguments to pass to the driver. Do not include arguments, // such as `--conf`, that can be set as job properties, since a collision may // occur that causes an incorrect job submission. - repeated string args = 2; + repeated string args = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS file URIs of Python files to pass to the PySpark // framework. Supported file types: .py, .egg, and .zip. - repeated string python_file_uris = 3; + repeated string python_file_uris = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS URIs of jar files to add to the CLASSPATHs of the // Python driver and tasks. - repeated string jar_file_uris = 4; + repeated string jar_file_uris = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS URIs of files to be copied to the working directory of // Python drivers and distributed tasks. Useful for naively parallel tasks. - repeated string file_uris = 5; + repeated string file_uris = 5 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS URIs of archives to be extracted in the working directory of // .jar, .tar, .tar.gz, .tgz, and .zip. - repeated string archive_uris = 6; + repeated string archive_uris = 6 [(google.api.field_behavior) = OPTIONAL]; // Optional. A mapping of property names to values, used to configure PySpark. - // Properties that conflict with values set by the Cloud Dataproc API may be + // Properties that conflict with values set by the Dataproc API may be // overwritten. Can include properties set in // /etc/spark/conf/spark-defaults.conf and classes in user code. - map properties = 7; + map properties = 7 [(google.api.field_behavior) = OPTIONAL]; // Optional. The runtime log config for job execution. - LoggingConfig logging_config = 8; + LoggingConfig logging_config = 8 [(google.api.field_behavior) = OPTIONAL]; } // A list of queries to run on a cluster. @@ -275,10 +299,10 @@ message QueryList { // ] // } // } - repeated string queries = 1; + repeated string queries = 1 [(google.api.field_behavior) = REQUIRED]; } -// A Cloud Dataproc job for running [Apache Hive](https://hive.apache.org/) +// A Dataproc job for running [Apache Hive](https://hive.apache.org/) // queries on YARN. message HiveJob { // Required. The sequence of Hive queries to execute, specified as either @@ -294,25 +318,25 @@ message HiveJob { // Optional. Whether to continue executing queries if a query fails. // The default value is `false`. Setting to `true` can be useful when // executing independent parallel queries. - bool continue_on_failure = 3; + bool continue_on_failure = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. Mapping of query variable names to values (equivalent to the // Hive command: `SET name="value";`). - map script_variables = 4; + map script_variables = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. A mapping of property names and values, used to configure Hive. - // Properties that conflict with values set by the Cloud Dataproc API may be + // Properties that conflict with values set by the Dataproc API may be // overwritten. Can include properties set in /etc/hadoop/conf/*-site.xml, // /etc/hive/conf/hive-site.xml, and classes in user code. - map properties = 5; + map properties = 5 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS URIs of jar files to add to the CLASSPATH of the // Hive server and Hadoop MapReduce (MR) tasks. Can contain Hive SerDes // and UDFs. - repeated string jar_file_uris = 6; + repeated string jar_file_uris = 6 [(google.api.field_behavior) = OPTIONAL]; } -// A Cloud Dataproc job for running [Apache Spark +// A Dataproc job for running [Apache Spark // SQL](http://spark.apache.org/sql/) queries. message SparkSqlJob { // Required. The sequence of Spark SQL queries to execute, specified as @@ -327,21 +351,21 @@ message SparkSqlJob { // Optional. Mapping of query variable names to values (equivalent to the // Spark SQL command: SET `name="value";`). - map script_variables = 3; + map script_variables = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. A mapping of property names to values, used to configure // Spark SQL's SparkConf. Properties that conflict with values set by the - // Cloud Dataproc API may be overwritten. - map properties = 4; + // Dataproc API may be overwritten. + map properties = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS URIs of jar files to be added to the Spark CLASSPATH. - repeated string jar_file_uris = 56; + repeated string jar_file_uris = 56 [(google.api.field_behavior) = OPTIONAL]; // Optional. The runtime log config for job execution. - LoggingConfig logging_config = 6; + LoggingConfig logging_config = 6 [(google.api.field_behavior) = OPTIONAL]; } -// A Cloud Dataproc job for running [Apache Pig](https://pig.apache.org/) +// A Dataproc job for running [Apache Pig](https://pig.apache.org/) // queries on YARN. message PigJob { // Required. The sequence of Pig queries to execute, specified as an HCFS @@ -357,69 +381,105 @@ message PigJob { // Optional. Whether to continue executing queries if a query fails. // The default value is `false`. Setting to `true` can be useful when // executing independent parallel queries. - bool continue_on_failure = 3; + bool continue_on_failure = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. Mapping of query variable names to values (equivalent to the Pig // command: `name=[value]`). - map script_variables = 4; + map script_variables = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. A mapping of property names to values, used to configure Pig. - // Properties that conflict with values set by the Cloud Dataproc API may be + // Properties that conflict with values set by the Dataproc API may be // overwritten. Can include properties set in /etc/hadoop/conf/*-site.xml, // /etc/pig/conf/pig.properties, and classes in user code. - map properties = 5; + map properties = 5 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS URIs of jar files to add to the CLASSPATH of // the Pig Client and Hadoop MapReduce (MR) tasks. Can contain Pig UDFs. - repeated string jar_file_uris = 6; + repeated string jar_file_uris = 6 [(google.api.field_behavior) = OPTIONAL]; // Optional. The runtime log config for job execution. - LoggingConfig logging_config = 7; + LoggingConfig logging_config = 7 [(google.api.field_behavior) = OPTIONAL]; } -// A Cloud Dataproc job for running +// A Dataproc job for running // [Apache SparkR](https://spark.apache.org/docs/latest/sparkr.html) // applications on YARN. message SparkRJob { // Required. The HCFS URI of the main R file to use as the driver. // Must be a .R file. - string main_r_file_uri = 1; + string main_r_file_uri = 1 [(google.api.field_behavior) = REQUIRED]; // Optional. The arguments to pass to the driver. Do not include arguments, // such as `--conf`, that can be set as job properties, since a collision may // occur that causes an incorrect job submission. - repeated string args = 2; + repeated string args = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS URIs of files to be copied to the working directory of // R drivers and distributed tasks. Useful for naively parallel tasks. - repeated string file_uris = 3; + repeated string file_uris = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. HCFS URIs of archives to be extracted in the working directory of // Spark drivers and tasks. Supported file types: // .jar, .tar, .tar.gz, .tgz, and .zip. - repeated string archive_uris = 4; + repeated string archive_uris = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. A mapping of property names to values, used to configure SparkR. - // Properties that conflict with values set by the Cloud Dataproc API may be + // Properties that conflict with values set by the Dataproc API may be // overwritten. Can include properties set in // /etc/spark/conf/spark-defaults.conf and classes in user code. - map properties = 5; + map properties = 5 [(google.api.field_behavior) = OPTIONAL]; // Optional. The runtime log config for job execution. - LoggingConfig logging_config = 6; + LoggingConfig logging_config = 6 [(google.api.field_behavior) = OPTIONAL]; } -// Cloud Dataproc job config. +// A Dataproc job for running [Presto](https://prestosql.io/) queries. +// **IMPORTANT**: The [Dataproc Presto Optional +// Component](/dataproc/docs/concepts/components/presto) must be enabled when +// the cluster is created to submit a Presto job to the cluster. +message PrestoJob { + // Required. The sequence of Presto queries to execute, specified as + // either an HCFS file URI or as a list of queries. + oneof queries { + // The HCFS URI of the script that contains SQL queries. + string query_file_uri = 1; + + // A list of queries. + QueryList query_list = 2; + } + + // Optional. Whether to continue executing queries if a query fails. + // The default value is `false`. Setting to `true` can be useful when + // executing independent parallel queries. + bool continue_on_failure = 3 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The format in which query output will be displayed. See the + // Presto documentation for supported output formats + string output_format = 4 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Presto client tags to attach to this query + repeated string client_tags = 5 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. A mapping of property names to values. Used to set Presto + // [session properties](https://prestodb.io/docs/current/sql/set-session.html) + // Equivalent to using the --session flag in the Presto CLI + map properties = 6 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The runtime log config for job execution. + LoggingConfig logging_config = 7 [(google.api.field_behavior) = OPTIONAL]; +} + +// Dataproc job config. message JobPlacement { // Required. The name of the cluster where the job will be submitted. - string cluster_name = 1; + string cluster_name = 1 [(google.api.field_behavior) = REQUIRED]; - // Output only. A cluster UUID generated by the Cloud Dataproc service when + // Output only. A cluster UUID generated by the Dataproc service when // the job is submitted. - string cluster_uuid = 2; + string cluster_uuid = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } -// Cloud Dataproc job status. +// Dataproc job status. message JobStatus { // The job state. enum State { @@ -477,7 +537,7 @@ message JobStatus { QUEUED = 2; // The agent-reported status is out of date, which may be caused by a - // loss of communication between the agent and Cloud Dataproc. If the + // loss of communication between the agent and Dataproc. If the // agent does not send a timely update, the job will fail. // // Applies to RUNNING state. @@ -485,33 +545,32 @@ message JobStatus { } // Output only. A state message specifying the overall job state. - State state = 1; + State state = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Output only. Optional job state details, such as an error + // Output only. Optional Job state details, such as an error // description if the state is ERROR. - string details = 2; + string details = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The time when this state was entered. - google.protobuf.Timestamp state_start_time = 6; + google.protobuf.Timestamp state_start_time = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Additional state information, which includes // status reported by the agent. - Substate substate = 7; + Substate substate = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Encapsulates the full scoping used to reference a job. message JobReference { // Required. The ID of the Google Cloud Platform project that the job // belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; // Optional. The job ID, which must be unique within the project. - // // The ID must contain only letters (a-z, A-Z), numbers (0-9), // underscores (_), or hyphens (-). The maximum length is 100 characters. // // If not specified by the caller, the job ID will be provided by the server. - string job_id = 2; + string job_id = 2 [(google.api.field_behavior) = OPTIONAL]; } // A YARN application created by a job. Application information is a subset of @@ -551,84 +610,87 @@ message YarnApplication { KILLED = 8; } - // Required. The application name. - string name = 1; + // Output only. The application name. + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Required. The application state. - State state = 2; + // Output only. The application state. + State state = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Required. The numerical progress of the application, from 1 to 100. - float progress = 3; + // Output only. The numerical progress of the application, from 1 to 100. + float progress = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; - // Optional. The HTTP URL of the ApplicationMaster, HistoryServer, or + // Output only. The HTTP URL of the ApplicationMaster, HistoryServer, or // TimelineServer that provides application-specific information. The URL uses // the internal hostname, and requires a proxy server for resolution and, // possibly, access. - string tracking_url = 4; + string tracking_url = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; } -// A Cloud Dataproc job resource. +// A Dataproc job resource. message Job { // Optional. The fully qualified reference to the job, which can be used to // obtain the equivalent REST path of the job resource. If this property // is not specified when a job is created, the server generates a // job_id. - JobReference reference = 1; + JobReference reference = 1 [(google.api.field_behavior) = OPTIONAL]; // Required. Job information, including how, when, and where to // run the job. - JobPlacement placement = 2; + JobPlacement placement = 2 [(google.api.field_behavior) = REQUIRED]; // Required. The application/framework-specific portion of the job. oneof type_job { - // Job is a Hadoop job. - HadoopJob hadoop_job = 3; + // Optional. Job is a Hadoop job. + HadoopJob hadoop_job = 3 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Job is a Spark job. + SparkJob spark_job = 4 [(google.api.field_behavior) = OPTIONAL]; - // Job is a Spark job. - SparkJob spark_job = 4; + // Optional. Job is a PySpark job. + PySparkJob pyspark_job = 5 [(google.api.field_behavior) = OPTIONAL]; - // Job is a Pyspark job. - PySparkJob pyspark_job = 5; + // Optional. Job is a Hive job. + HiveJob hive_job = 6 [(google.api.field_behavior) = OPTIONAL]; - // Job is a Hive job. - HiveJob hive_job = 6; + // Optional. Job is a Pig job. + PigJob pig_job = 7 [(google.api.field_behavior) = OPTIONAL]; - // Job is a Pig job. - PigJob pig_job = 7; + // Optional. Job is a SparkR job. + SparkRJob spark_r_job = 21 [(google.api.field_behavior) = OPTIONAL]; - // Job is a SparkR job. - SparkRJob spark_r_job = 21; + // Optional. Job is a SparkSql job. + SparkSqlJob spark_sql_job = 12 [(google.api.field_behavior) = OPTIONAL]; - // Job is a SparkSql job. - SparkSqlJob spark_sql_job = 12; + // Optional. Job is a Presto job. + PrestoJob presto_job = 23 [(google.api.field_behavior) = OPTIONAL]; } // Output only. The job status. Additional application-specific // status information may be contained in the type_job // and yarn_applications fields. - JobStatus status = 8; + JobStatus status = 8 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The previous job status. - repeated JobStatus status_history = 13; + repeated JobStatus status_history = 13 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The collection of YARN applications spun up by this job. // // **Beta** Feature: This report is available for testing purposes only. It // may be changed before final release. - repeated YarnApplication yarn_applications = 9; + repeated YarnApplication yarn_applications = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The email address of the user submitting the job. For jobs // submitted on the cluster, the address is username@hostname. - string submitted_by = 10; + string submitted_by = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. A URI pointing to the location of the stdout of the job's // driver program. - string driver_output_resource_uri = 17; + string driver_output_resource_uri = 17 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. If present, the location of miscellaneous control files // which may be used as part of job setup and handling. If not present, // control files may be placed in the same location as `driver_output_uri`. - string driver_control_files_uri = 15; + string driver_control_files_uri = 15 [(google.api.field_behavior) = OUTPUT_ONLY]; // Optional. The labels to associate with this job. // Label **keys** must contain 1 to 63 characters, and must conform to @@ -637,15 +699,21 @@ message Job { // characters, and must conform to [RFC // 1035](https://www.ietf.org/rfc/rfc1035.txt). No more than 32 labels can be // associated with a job. - map labels = 18; + map labels = 18 [(google.api.field_behavior) = OPTIONAL]; // Optional. Job scheduling configuration. - JobScheduling scheduling = 20; + JobScheduling scheduling = 20 [(google.api.field_behavior) = OPTIONAL]; // Output only. A UUID that uniquely identifies a job within the project // over time. This is in contrast to a user-settable reference.job_id that // may be reused over time. - string job_uuid = 22; + string job_uuid = 22 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Indicates whether the job is completed. If the value is `false`, + // the job is still in progress. If `true`, the job is completed, and + // `status.state` field will indicate if it was successful, failed, + // or cancelled. + bool done = 24 [(google.api.field_behavior) = OUTPUT_ONLY]; } // Job scheduling options. @@ -658,20 +726,35 @@ message JobScheduling { // 4 times within 10 minute window. // // Maximum value is 10. - int32 max_failures_per_hour = 1; + int32 max_failures_per_hour = 1 [(google.api.field_behavior) = OPTIONAL]; +} + +// Job Operation metadata. +message JobMetadata { + // Output only. The job id. + string job_id = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Most recent job status. + JobStatus status = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Operation type. + string operation_type = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. Job submission time. + google.protobuf.Timestamp start_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; } // A request to submit a job. message SubmitJobRequest { // Required. The ID of the Google Cloud Platform project that the job // belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The Cloud Dataproc region in which to handle the request. - string region = 3; + // Required. The Dataproc region in which to handle the request. + string region = 3 [(google.api.field_behavior) = REQUIRED]; // Required. The job resource. - Job job = 2; + Job job = 2 [(google.api.field_behavior) = REQUIRED]; // Optional. A unique id used to identify the request. If the server // receives two [SubmitJobRequest][google.cloud.dataproc.v1beta2.SubmitJobRequest] requests with the same @@ -684,20 +767,20 @@ message SubmitJobRequest { // // The id must contain only letters (a-z, A-Z), numbers (0-9), // underscores (_), and hyphens (-). The maximum length is 40 characters. - string request_id = 4; + string request_id = 4 [(google.api.field_behavior) = OPTIONAL]; } // A request to get the resource representation for a job in a project. message GetJobRequest { // Required. The ID of the Google Cloud Platform project that the job // belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The Cloud Dataproc region in which to handle the request. - string region = 3; + // Required. The Dataproc region in which to handle the request. + string region = 3 [(google.api.field_behavior) = REQUIRED]; // Required. The job ID. - string job_id = 2; + string job_id = 2 [(google.api.field_behavior) = REQUIRED]; } // A request to list jobs in a project. @@ -717,27 +800,27 @@ message ListJobsRequest { // Required. The ID of the Google Cloud Platform project that the job // belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The Cloud Dataproc region in which to handle the request. - string region = 6; + // Required. The Dataproc region in which to handle the request. + string region = 6 [(google.api.field_behavior) = REQUIRED]; // Optional. The number of results to return in each response. - int32 page_size = 2; + int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. The page token, returned by a previous call, to request the // next page of results. - string page_token = 3; + string page_token = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. If set, the returned jobs list includes only jobs that were // submitted to the named cluster. - string cluster_name = 4; + string cluster_name = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. Specifies enumerated categories of jobs to list. // (default = match ALL jobs). // // If `filter` is provided, `jobStateMatcher` will be ignored. - JobStateMatcher job_state_matcher = 5; + JobStateMatcher job_state_matcher = 5 [(google.api.field_behavior) = OPTIONAL]; // Optional. A filter constraining the jobs to list. Filters are // case-sensitive and have the following syntax: @@ -753,23 +836,23 @@ message ListJobsRequest { // Example filter: // // status.state = ACTIVE AND labels.env = staging AND labels.starred = * - string filter = 7; + string filter = 7 [(google.api.field_behavior) = OPTIONAL]; } // A request to update a job. message UpdateJobRequest { // Required. The ID of the Google Cloud Platform project that the job // belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The Cloud Dataproc region in which to handle the request. - string region = 2; + // Required. The Dataproc region in which to handle the request. + string region = 2 [(google.api.field_behavior) = REQUIRED]; // Required. The job ID. - string job_id = 3; + string job_id = 3 [(google.api.field_behavior) = REQUIRED]; // Required. The changes to the job. - Job job = 4; + Job job = 4 [(google.api.field_behavior) = REQUIRED]; // Required. Specifies the path, relative to Job, of // the field to update. For example, to update the labels of a Job the @@ -777,42 +860,42 @@ message UpdateJobRequest { // labels, and the `PATCH` request body would specify the new // value. Note: Currently, labels is the only // field that can be updated. - google.protobuf.FieldMask update_mask = 5; + google.protobuf.FieldMask update_mask = 5 [(google.api.field_behavior) = REQUIRED]; } // A list of jobs in a project. message ListJobsResponse { // Output only. Jobs list. - repeated Job jobs = 1; + repeated Job jobs = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Optional. This token is included in the response if there are more results // to fetch. To fetch additional results, provide this value as the // `page_token` in a subsequent ListJobsRequest. - string next_page_token = 2; + string next_page_token = 2 [(google.api.field_behavior) = OPTIONAL]; } // A request to cancel a job. message CancelJobRequest { // Required. The ID of the Google Cloud Platform project that the job // belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The Cloud Dataproc region in which to handle the request. - string region = 3; + // Required. The Dataproc region in which to handle the request. + string region = 3 [(google.api.field_behavior) = REQUIRED]; // Required. The job ID. - string job_id = 2; + string job_id = 2 [(google.api.field_behavior) = REQUIRED]; } // A request to delete a job. message DeleteJobRequest { // Required. The ID of the Google Cloud Platform project that the job // belongs to. - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The Cloud Dataproc region in which to handle the request. - string region = 3; + // Required. The Dataproc region in which to handle the request. + string region = 3 [(google.api.field_behavior) = REQUIRED]; // Required. The job ID. - string job_id = 2; + string job_id = 2 [(google.api.field_behavior) = REQUIRED]; } diff --git a/third_party/googleapis/google/cloud/dataproc/v1beta2/operations.proto b/third_party/googleapis/google/cloud/dataproc/v1beta2/operations.proto index 8f9252a46..2e98fb82a 100644 --- a/third_party/googleapis/google/cloud/dataproc/v1beta2/operations.proto +++ b/third_party/googleapis/google/cloud/dataproc/v1beta2/operations.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,14 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.dataproc.v1beta2; -import "google/api/annotations.proto"; import "google/protobuf/timestamp.proto"; +import "google/api/annotations.proto"; option go_package = "google.golang.org/genproto/googleapis/cloud/dataproc/v1beta2;dataproc"; option java_multiple_files = true; diff --git a/third_party/googleapis/google/cloud/dataproc/v1beta2/shared.proto b/third_party/googleapis/google/cloud/dataproc/v1beta2/shared.proto index de1130d9c..130ae554d 100644 --- a/third_party/googleapis/google/cloud/dataproc/v1beta2/shared.proto +++ b/third_party/googleapis/google/cloud/dataproc/v1beta2/shared.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -32,9 +31,15 @@ enum Component { // The Anaconda python distribution. ANACONDA = 5; + // Docker + DOCKER = 13; + // The Druid query engine. DRUID = 9; + // Flink + FLINK = 14; + // The Hive Web HCatalog (the REST service for accessing HCatalog). HIVE_WEBHCAT = 3; @@ -47,6 +52,12 @@ enum Component { // The Presto query engine. PRESTO = 6; + // The Ranger service. + RANGER = 12; + + // The Solr service. + SOLR = 10; + // The Zeppelin notebook. ZEPPELIN = 4; diff --git a/third_party/googleapis/google/cloud/dataproc/v1beta2/workflow_templates.proto b/third_party/googleapis/google/cloud/dataproc/v1beta2/workflow_templates.proto index edaf357cc..e5ef680bd 100644 --- a/third_party/googleapis/google/cloud/dataproc/v1beta2/workflow_templates.proto +++ b/third_party/googleapis/google/cloud/dataproc/v1beta2/workflow_templates.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,15 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.dataproc.v1beta2; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/cloud/dataproc/v1beta2/clusters.proto"; import "google/cloud/dataproc/v1beta2/jobs.proto"; import "google/longrunning/operations.proto"; @@ -30,8 +32,11 @@ option java_outer_classname = "WorkflowTemplatesProto"; option java_package = "com.google.cloud.dataproc.v1beta2"; // The API interface for managing Workflow Templates in the -// Cloud Dataproc API. +// Dataproc API. service WorkflowTemplateService { + option (google.api.default_host) = "dataproc.googleapis.com"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; + // Creates new workflow template. rpc CreateWorkflowTemplate(CreateWorkflowTemplateRequest) returns (WorkflowTemplate) { option (google.api.http) = { @@ -42,6 +47,7 @@ service WorkflowTemplateService { body: "template" } }; + option (google.api.method_signature) = "parent, template"; } // Retrieves the latest workflow template. @@ -55,6 +61,7 @@ service WorkflowTemplateService { get: "/v1beta2/{name=projects/*/locations/*/workflowTemplates/*}" } }; + option (google.api.method_signature) = "name"; } // Instantiates a template and begins execution. @@ -70,7 +77,9 @@ service WorkflowTemplateService { // clusters to be deleted. // // The [Operation.metadata][google.longrunning.Operation.metadata] will be - // [WorkflowMetadata][google.cloud.dataproc.v1beta2.WorkflowMetadata]. + // [WorkflowMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1beta2#workflowmetadata). + // Also see [Using + // WorkflowMetadata](https://cloud.google.com/dataproc/docs/concepts/workflows/debugging#using_workflowmetadata). // // On successful completion, // [Operation.response][google.longrunning.Operation.response] will be @@ -84,6 +93,12 @@ service WorkflowTemplateService { body: "*" } }; + option (google.api.method_signature) = "name"; + option (google.api.method_signature) = "name, parameters"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "WorkflowMetadata" + }; } // Instantiates a template and begins execution. @@ -103,7 +118,9 @@ service WorkflowTemplateService { // clusters to be deleted. // // The [Operation.metadata][google.longrunning.Operation.metadata] will be - // [WorkflowMetadata][google.cloud.dataproc.v1beta2.WorkflowMetadata]. + // [WorkflowMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#workflowmetadata). + // Also see [Using + // WorkflowMetadata](https://cloud.google.com/dataproc/docs/concepts/workflows/debugging#using_workflowmetadata). // // On successful completion, // [Operation.response][google.longrunning.Operation.response] will be @@ -117,6 +134,11 @@ service WorkflowTemplateService { body: "template" } }; + option (google.api.method_signature) = "parent, template"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "WorkflowMetadata" + }; } // Updates (replaces) workflow template. The updated template @@ -130,6 +152,7 @@ service WorkflowTemplateService { body: "template" } }; + option (google.api.method_signature) = "template"; } // Lists workflows that match the specified filter in the request. @@ -140,6 +163,7 @@ service WorkflowTemplateService { get: "/v1beta2/{parent=projects/*/locations/*}/workflowTemplates" } }; + option (google.api.method_signature) = "parent"; } // Deletes a workflow template. It does not cancel in-progress workflows. @@ -150,11 +174,19 @@ service WorkflowTemplateService { delete: "/v1beta2/{name=projects/*/locations/*/workflowTemplates/*}" } }; + option (google.api.method_signature) = "name"; } } -// A Cloud Dataproc workflow template resource. +// A Dataproc workflow template resource. message WorkflowTemplate { + option (google.api.resource) = { + type: "dataproc.googleapis.com/WorkflowTemplate" + pattern: "projects/{project}/regions/{region}/workflowTemplates/{workflow_template}" + pattern: "projects/{project}/locations/{location}/workflowTemplates/{workflow_template}" + history: ORIGINALLY_SINGLE_PATTERN + }; + // Required. The template id. // // The id must contain only letters (a-z, A-Z), numbers (0-9), @@ -162,12 +194,19 @@ message WorkflowTemplate { // or hyphen. Must consist of between 3 and 50 characters. // // . - string id = 2; + string id = 2 [(google.api.field_behavior) = REQUIRED]; - // Output only. The "resource name" of the template, as described - // in https://cloud.google.com/apis/design/resource_names of the form - // `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}` - string name = 1; + // Output only. The resource name of the workflow template, as described + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.workflowTemplates`, the resource name of the + // template has the following format: + // `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}` + // + // * For `projects.locations.workflowTemplates`, the resource name of the + // template has the following format: + // `projects/{project_id}/locations/{location}/workflowTemplates/{template_id}` + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Optional. Used to perform a consistent read-modify-write. // @@ -178,13 +217,13 @@ message WorkflowTemplate { // the current template with the `version` field filled in with the // current server version. The user updates other fields in the template, // then returns it as part of the `UpdateWorkflowTemplate` request. - int32 version = 3; + int32 version = 3 [(google.api.field_behavior) = OPTIONAL]; // Output only. The time template was created. - google.protobuf.Timestamp create_time = 4; + google.protobuf.Timestamp create_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The time template was last updated. - google.protobuf.Timestamp update_time = 5; + google.protobuf.Timestamp update_time = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; // Optional. The labels to associate with this template. These labels // will be propagated to all jobs and clusters created by the workflow @@ -198,7 +237,7 @@ message WorkflowTemplate { // [RFC 1035](https://www.ietf.org/rfc/rfc1035.txt). // // No more than 32 labels can be associated with a template. - map labels = 6; + map labels = 6 [(google.api.field_behavior) = OPTIONAL]; // Required. WorkflowTemplate scheduling information. WorkflowTemplatePlacement placement = 7; @@ -209,7 +248,7 @@ message WorkflowTemplate { // Optional. Template parameters whose values are substituted into the // template. Values for parameters must be provided when the template is // instantiated. - repeated TemplateParameter parameters = 9; + repeated TemplateParameter parameters = 9 [(google.api.field_behavior) = OPTIONAL]; } // Specifies workflow execution target. @@ -283,27 +322,27 @@ message OrderedJob { // The id must contain only letters (a-z, A-Z), numbers (0-9), // underscores (_), and hyphens (-). Cannot begin or end with underscore // or hyphen. Must consist of between 3 and 50 characters. - string step_id = 1; + string step_id = 1 [(google.api.field_behavior) = REQUIRED]; // Required. The job definition. oneof job_type { - // Job is a Hadoop job. HadoopJob hadoop_job = 2; - // Job is a Spark job. SparkJob spark_job = 3; - // Job is a Pyspark job. PySparkJob pyspark_job = 4; - // Job is a Hive job. HiveJob hive_job = 5; - // Job is a Pig job. PigJob pig_job = 6; - // Job is a SparkSql job. + // Spark R job + SparkRJob spark_r_job = 11; + SparkSqlJob spark_sql_job = 7; + + // Presto job + PrestoJob presto_job = 12; } // Optional. The labels to associate with this job. @@ -316,14 +355,14 @@ message OrderedJob { // the following regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63} // // No more than 32 labels can be associated with a given job. - map labels = 8; + map labels = 8 [(google.api.field_behavior) = OPTIONAL]; // Optional. Job scheduling configuration. - JobScheduling scheduling = 9; + JobScheduling scheduling = 9 [(google.api.field_behavior) = OPTIONAL]; // Optional. The optional list of prerequisite job step_ids. // If not specified, the job will start at the beginning of workflow. - repeated string prerequisite_step_ids = 10; + repeated string prerequisite_step_ids = 10 [(google.api.field_behavior) = OPTIONAL]; } // A configurable parameter that replaces one or more fields in the template. @@ -336,7 +375,7 @@ message OrderedJob { // - Main class (in HadoopJob and SparkJob) // - Zone (in ClusterSelector) message TemplateParameter { - // Required. Parameter name. + // Required. Parameter name. // The parameter name is used as the key, and paired with the // parameter value, which are passed to the template when the template // is instantiated. @@ -425,7 +464,7 @@ message ValueValidation { repeated string values = 1; } -// A Cloud Dataproc workflow template resource. +// A Dataproc workflow template resource. message WorkflowMetadata { // The operation state. enum State { @@ -442,57 +481,66 @@ message WorkflowMetadata { DONE = 3; } - // Output only. The "resource name" of the template. - string template = 1; + // Output only. The resource name of the workflow template as described + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.workflowTemplates`, the resource name of the + // template has the following format: + // `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}` + // + // * For `projects.locations.workflowTemplates`, the resource name of the + // template has the following format: + // `projects/{project_id}/locations/{location}/workflowTemplates/{template_id}` + string template = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The version of template at the time of // workflow instantiation. - int32 version = 2; + int32 version = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The create cluster operation metadata. - ClusterOperation create_cluster = 3; + ClusterOperation create_cluster = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The workflow graph. - WorkflowGraph graph = 4; + WorkflowGraph graph = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The delete cluster operation metadata. - ClusterOperation delete_cluster = 5; + ClusterOperation delete_cluster = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The workflow state. - State state = 6; + State state = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The name of the target cluster. - string cluster_name = 7; + string cluster_name = 7 [(google.api.field_behavior) = OUTPUT_ONLY]; // Map from parameter names to values that were used for those parameters. map parameters = 8; // Output only. Workflow start time. - google.protobuf.Timestamp start_time = 9; + google.protobuf.Timestamp start_time = 9 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Workflow end time. - google.protobuf.Timestamp end_time = 10; + google.protobuf.Timestamp end_time = 10 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The UUID of target cluster. - string cluster_uuid = 11; + string cluster_uuid = 11 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The cluster operation triggered by a workflow. message ClusterOperation { // Output only. The id of the cluster operation. - string operation_id = 1; + string operation_id = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Error, if operation failed. - string error = 2; + string error = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Indicates the operation is done. - bool done = 3; + bool done = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The workflow graph. message WorkflowGraph { // Output only. The workflow nodes. - repeated WorkflowNode nodes = 1; + repeated WorkflowNode nodes = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; } // The workflow node. @@ -520,41 +568,65 @@ message WorkflowNode { } // Output only. The name of the node. - string step_id = 1; + string step_id = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. Node's prerequisite nodes. - repeated string prerequisite_step_ids = 2; + repeated string prerequisite_step_ids = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The job id; populated after the node enters RUNNING state. - string job_id = 3; + string job_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The node state. - NodeState state = 5; + NodeState state = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. The error detail. - string error = 6; + string error = 6 [(google.api.field_behavior) = OUTPUT_ONLY]; } // A request to create a workflow template. message CreateWorkflowTemplateRequest { - // Required. The "resource name" of the region, as described - // in https://cloud.google.com/apis/design/resource_names of the form - // `projects/{project_id}/regions/{region}` - string parent = 1; + // Required. The resource name of the region or location, as described + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.workflowTemplates,create`, the resource name of the + // region has the following format: + // `projects/{project_id}/regions/{region}` + // + // * For `projects.locations.workflowTemplates.create`, the resource name of + // the location has the following format: + // `projects/{project_id}/locations/{location}` + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dataproc.googleapis.com/WorkflowTemplate" + } + ]; // Required. The Dataproc workflow template to create. - WorkflowTemplate template = 2; + WorkflowTemplate template = 2 [(google.api.field_behavior) = REQUIRED]; } // A request to fetch a workflow template. message GetWorkflowTemplateRequest { - // Required. The "resource name" of the workflow template, as described - // in https://cloud.google.com/apis/design/resource_names of the form - // `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}` - string name = 1; + // Required. The resource name of the workflow template, as described + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.workflowTemplates.get`, the resource name of the + // template has the following format: + // `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}` + // + // * For `projects.locations.workflowTemplates.get`, the resource name of the + // template has the following format: + // `projects/{project_id}/locations/{location}/workflowTemplates/{template_id}` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "dataproc.googleapis.com/WorkflowTemplate" + } + ]; // Optional. The version of workflow template to retrieve. Only previously - // instatiated versions can be retrieved. + // instantiated versions can be retrieved. // // If unspecified, retrieves the current version. int32 version = 2; @@ -562,10 +634,22 @@ message GetWorkflowTemplateRequest { // A request to instantiate a workflow template. message InstantiateWorkflowTemplateRequest { - // Required. The "resource name" of the workflow template, as described - // in https://cloud.google.com/apis/design/resource_names of the form - // `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}` - string name = 1; + // Required. The resource name of the workflow template, as described + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.workflowTemplates.instantiate`, the resource name + // of the template has the following format: + // `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}` + // + // * For `projects.locations.workflowTemplates.instantiate`, the resource name + // of the template has the following format: + // `projects/{project_id}/locations/{location}/workflowTemplates/{template_id}` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "dataproc.googleapis.com/WorkflowTemplate" + } + ]; // Optional. The version of workflow template to instantiate. If specified, // the workflow will be instantiated only if the current version of @@ -596,13 +680,25 @@ message InstantiateWorkflowTemplateRequest { // A request to instantiate an inline workflow template. message InstantiateInlineWorkflowTemplateRequest { - // Required. The "resource name" of the workflow template region, as described - // in https://cloud.google.com/apis/design/resource_names of the form - // `projects/{project_id}/regions/{region}` - string parent = 1; + // Required. The resource name of the region or location, as described + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.workflowTemplates,instantiateinline`, the resource + // name of the region has the following format: + // `projects/{project_id}/regions/{region}` + // + // * For `projects.locations.workflowTemplates.instantiateinline`, the + // resource name of the location has the following format: + // `projects/{project_id}/locations/{location}` + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dataproc.googleapis.com/WorkflowTemplate" + } + ]; // Required. The workflow template to instantiate. - WorkflowTemplate template = 2; + WorkflowTemplate template = 2 [(google.api.field_behavior) = REQUIRED]; // Deprecated. Please use `request_id` field instead. string instance_id = 3; @@ -624,15 +720,27 @@ message UpdateWorkflowTemplateRequest { // Required. The updated workflow template. // // The `template.version` field must match the current version. - WorkflowTemplate template = 1; + WorkflowTemplate template = 1 [(google.api.field_behavior) = REQUIRED]; } // A request to list workflow templates in a project. message ListWorkflowTemplatesRequest { - // Required. The "resource name" of the region, as described - // in https://cloud.google.com/apis/design/resource_names of the form - // `projects/{project_id}/regions/{region}` - string parent = 1; + // Required. The resource name of the region or location, as described + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.workflowTemplates,list`, the resource + // name of the region has the following format: + // `projects/{project_id}/regions/{region}` + // + // * For `projects.locations.workflowTemplates.list`, the + // resource name of the location has the following format: + // `projects/{project_id}/locations/{location}` + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dataproc.googleapis.com/WorkflowTemplate" + } + ]; // Optional. The maximum number of results to return in each response. int32 page_size = 2; @@ -645,22 +753,34 @@ message ListWorkflowTemplatesRequest { // A response to a request to list workflow templates in a project. message ListWorkflowTemplatesResponse { // Output only. WorkflowTemplates list. - repeated WorkflowTemplate templates = 1; + repeated WorkflowTemplate templates = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; // Output only. This token is included in the response if there are more // results to fetch. To fetch additional results, provide this value as the // page_token in a subsequent ListWorkflowTemplatesRequest. - string next_page_token = 2; + string next_page_token = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; } // A request to delete a workflow template. // // Currently started workflows will remain running. message DeleteWorkflowTemplateRequest { - // Required. The "resource name" of the workflow template, as described - // in https://cloud.google.com/apis/design/resource_names of the form - // `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}` - string name = 1; + // Required. The resource name of the workflow template, as described + // in https://cloud.google.com/apis/design/resource_names. + // + // * For `projects.regions.workflowTemplates.delete`, the resource name + // of the template has the following format: + // `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}` + // + // * For `projects.locations.workflowTemplates.instantiate`, the resource name + // of the template has the following format: + // `projects/{project_id}/locations/{location}/workflowTemplates/{template_id}` + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "dataproc.googleapis.com/WorkflowTemplate" + } + ]; // Optional. The version of workflow template to delete. If specified, // will only delete the template if the current server version matches diff --git a/third_party/googleapis/google/cloud/dialogflow/BUILD.bazel b/third_party/googleapis/google/cloud/dialogflow/BUILD.bazel index 1e5b8c2af..a87c57fec 100644 --- a/third_party/googleapis/google/cloud/dialogflow/BUILD.bazel +++ b/third_party/googleapis/google/cloud/dialogflow/BUILD.bazel @@ -1 +1 @@ -exports_files(glob(["*.yaml"])) \ No newline at end of file +exports_files(glob(["*.yaml"])) diff --git a/third_party/googleapis/google/cloud/dialogflow/v2/BUILD.bazel b/third_party/googleapis/google/cloud/dialogflow/v2/BUILD.bazel index dffd1c7b1..3bdb813b1 100644 --- a/third_party/googleapis/google/cloud/dialogflow/v2/BUILD.bazel +++ b/third_party/googleapis/google/cloud/dialogflow/v2/BUILD.bazel @@ -1,9 +1,12 @@ +# This file was automatically generated by BuildFileGenerator + # This is an API workspace, having public visibility by default makes perfect sense. package(default_visibility = ["//visibility:public"]) ############################################################################## # Common ############################################################################## +load("@rules_proto//proto:defs.bzl", "proto_library") load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info") proto_library( @@ -13,14 +16,17 @@ proto_library( "audio_config.proto", "context.proto", "entity_type.proto", + "environment.proto", "intent.proto", "session.proto", "session_entity_type.proto", + "validation_result.proto", "webhook.proto", ], deps = [ "//google/api:annotations_proto", "//google/api:client_proto", + "//google/api:field_behavior_proto", "//google/api:resource_proto", "//google/longrunning:operations_proto", "//google/rpc:status_proto", @@ -35,7 +41,10 @@ proto_library( proto_library_with_info( name = "dialogflow_proto_with_info", - deps = [":dialogflow_proto"], + deps = [ + ":dialogflow_proto", + "//google/cloud:common_resources_proto", + ], ) ############################################################################## @@ -43,18 +52,13 @@ proto_library_with_info( ############################################################################## load( "@com_google_googleapis_imports//:imports.bzl", - "java_grpc_library", - "java_gapic_library", "java_gapic_assembly_gradle_pkg", + "java_gapic_library", + "java_gapic_test", + "java_grpc_library", "java_proto_library", - "java_resource_name_proto_library", - "java_test", ) -_JAVA_GRPC_DEPS = [ - "@com_google_api_grpc_proto_google_common_protos//jar", -] - java_proto_library( name = "dialogflow_java_proto", deps = [":dialogflow_proto"], @@ -63,56 +67,46 @@ java_proto_library( java_grpc_library( name = "dialogflow_java_grpc", srcs = [":dialogflow_proto"], - deps = [":dialogflow_java_proto"] + _JAVA_GRPC_DEPS, -) - -java_resource_name_proto_library( - name = "dialogflow_resource_name_java_proto", - gapic_yaml = "dialogflow_gapic.yaml", - deps = [":dialogflow_proto"], + deps = [":dialogflow_java_proto"], ) java_gapic_library( name = "dialogflow_java_gapic", src = ":dialogflow_proto_with_info", gapic_yaml = "dialogflow_gapic.yaml", - service_yaml = "//google/cloud/dialogflow:dialogflow_v2.yaml", - test_deps = [":dialogflow_java_grpc"], + package = "google.cloud.dialogflow.v2", + service_yaml = "dialogflow_v2.yaml", + test_deps = [ + ":dialogflow_java_grpc", + ], deps = [ ":dialogflow_java_proto", - ":dialogflow_resource_name_java_proto", - ] + _JAVA_GRPC_DEPS, -) - -[java_test( - name = test_name, - test_class = test_name, - runtime_deps = [ - ":dialogflow_java_gapic_test", - ], -) for test_name in [ - "com.google.cloud.dialogflow.v2.AgentsClientTest", - "com.google.cloud.dialogflow.v2.ContextsClientTest", - "com.google.cloud.dialogflow.v2.EntityTypesClientTest", - "com.google.cloud.dialogflow.v2.IntentsClientTest", - "com.google.cloud.dialogflow.v2.SessionEntityTypesClientTest", - "com.google.cloud.dialogflow.v2.SessionsClientTest", -]] - -# Opensource Packages + ], +) + +java_gapic_test( + name = "dialogflow_java_gapic_test_suite", + test_classes = [ + "com.google.cloud.dialogflow.v2.AgentsClientTest", + "com.google.cloud.dialogflow.v2.ContextsClientTest", + "com.google.cloud.dialogflow.v2.EntityTypesClientTest", + "com.google.cloud.dialogflow.v2.EnvironmentsClientTest", + "com.google.cloud.dialogflow.v2.IntentsClientTest", + "com.google.cloud.dialogflow.v2.SessionEntityTypesClientTest", + "com.google.cloud.dialogflow.v2.SessionsClientTest", + ], + runtime_deps = [":dialogflow_java_gapic_test"], +) + +# Open Source Packages java_gapic_assembly_gradle_pkg( name = "google-cloud-dialogflow-v2-java", - client_deps = [":dialogflow_java_gapic"], - client_group = "com.google.cloud", - client_test_deps = [":dialogflow_java_gapic_test"], - grpc_deps = [":dialogflow_java_grpc"], - grpc_group = "com.google.api.grpc", - proto_deps = [ + deps = [ + ":dialogflow_java_gapic", + ":dialogflow_java_grpc", ":dialogflow_java_proto", ":dialogflow_proto", - ":dialogflow_resource_name_java_proto", - ] + _JAVA_GRPC_DEPS, - version = "0.0.0-SNAPSHOT", + ], ) ############################################################################## @@ -120,10 +114,10 @@ java_gapic_assembly_gradle_pkg( ############################################################################## load( "@com_google_googleapis_imports//:imports.bzl", + "go_gapic_assembly_pkg", + "go_gapic_library", "go_proto_library", "go_test", - "go_gapic_library", - "go_gapic_assembly_pkg", ) go_proto_library( @@ -141,15 +135,17 @@ go_proto_library( go_gapic_library( name = "dialogflow_go_gapic", - src = ":dialogflow_proto_with_info", - gapic_yaml = "dialogflow_gapic.yaml", - importpath = "cloud.google.com/go/dialogflow/apiv2", - service_yaml = "//google/cloud/dialogflow:dialogflow_v2.yaml", + srcs = [":dialogflow_proto_with_info"], + grpc_service_config = "dialogflow_grpc_service_config.json", + importpath = "cloud.google.com/go/dialogflow/apiv2;dialogflow", + service_yaml = "dialogflow_v2.yaml", deps = [ ":dialogflow_go_proto", "//google/longrunning:longrunning_go_gapic", "//google/longrunning:longrunning_go_proto", "@com_google_cloud_go//longrunning:go_default_library", + "@com_google_cloud_go//longrunning/autogen:go_default_library", + "@io_bazel_rules_go//proto/wkt:duration_go_proto", "@io_bazel_rules_go//proto/wkt:struct_go_proto", ], ) @@ -161,26 +157,90 @@ go_test( importpath = "cloud.google.com/go/dialogflow/apiv2", ) -# Opensource Packages +# Open Source Packages go_gapic_assembly_pkg( name = "gapi-cloud-dialogflow-v2-go", deps = [ ":dialogflow_go_gapic", - ":dialogflow_go_gapic_srcjar-smoke-test.srcjar", ":dialogflow_go_gapic_srcjar-test.srcjar", ":dialogflow_go_proto", ], ) +############################################################################## +# Python +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "moved_proto_library", + "py_gapic_assembly_pkg", + "py_gapic_library", + "py_grpc_library", + "py_proto_library", +) + +moved_proto_library( + name = "dialogflow_moved_proto", + srcs = [":dialogflow_proto"], + deps = [ + "//google/api:annotations_proto", + "//google/api:client_proto", + "//google/api:field_behavior_proto", + "//google/api:resource_proto", + "//google/longrunning:operations_proto", + "//google/rpc:status_proto", + "//google/type:latlng_proto", + "@com_google_protobuf//:duration_proto", + "@com_google_protobuf//:empty_proto", + "@com_google_protobuf//:field_mask_proto", + "@com_google_protobuf//:struct_proto", + "@com_google_protobuf//:timestamp_proto", + ], +) + +py_proto_library( + name = "dialogflow_py_proto", + plugin = "@protoc_docs_plugin//:docs_plugin", + deps = [":dialogflow_moved_proto"], +) + +py_grpc_library( + name = "dialogflow_py_grpc", + srcs = [":dialogflow_moved_proto"], + deps = [":dialogflow_py_proto"], +) + +py_gapic_library( + name = "dialogflow_py_gapic", + src = ":dialogflow_proto_with_info", + gapic_yaml = "dialogflow_gapic.yaml", + package = "google.cloud.dialogflow.v2", + service_yaml = "dialogflow_v2.yaml", + deps = [ + ":dialogflow_py_grpc", + ":dialogflow_py_proto", + ], +) + +# Open Source Packages +py_gapic_assembly_pkg( + name = "dialogflow-v2-py", + deps = [ + ":dialogflow_py_gapic", + ":dialogflow_py_grpc", + ":dialogflow_py_proto", + ], +) + ############################################################################## # PHP ############################################################################## load( "@com_google_googleapis_imports//:imports.bzl", - "php_proto_library", - "php_grpc_library", - "php_gapic_library", "php_gapic_assembly_pkg", + "php_gapic_library", + "php_grpc_library", + "php_proto_library", ) php_proto_library( @@ -198,14 +258,15 @@ php_gapic_library( name = "dialogflow_php_gapic", src = ":dialogflow_proto_with_info", gapic_yaml = "dialogflow_gapic.yaml", - service_yaml = "//google/cloud/dialogflow:dialogflow_v2.yaml", + package = "google.cloud.dialogflow.v2", + service_yaml = "dialogflow_v2.yaml", deps = [ ":dialogflow_php_grpc", ":dialogflow_php_proto", ], ) -# Opensource Packages +# Open Source Packages php_gapic_assembly_pkg( name = "google-cloud-dialogflow-v2-php", deps = [ @@ -220,15 +281,16 @@ php_gapic_assembly_pkg( ############################################################################## load( "@com_google_googleapis_imports//:imports.bzl", - "nodejs_gapic_library", "nodejs_gapic_assembly_pkg", + "nodejs_gapic_library", ) nodejs_gapic_library( name = "dialogflow_nodejs_gapic", src = ":dialogflow_proto_with_info", gapic_yaml = "dialogflow_gapic.yaml", - service_yaml = "//google/cloud/dialogflow:dialogflow_v2.yaml", + package = "google.cloud.dialogflow.v2", + service_yaml = "dialogflow_v2.yaml", deps = [], ) @@ -239,3 +301,96 @@ nodejs_gapic_assembly_pkg( ":dialogflow_proto", ], ) + +############################################################################## +# Ruby +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "ruby_gapic_assembly_pkg", + "ruby_gapic_library", + "ruby_grpc_library", + "ruby_proto_library", +) + +ruby_proto_library( + name = "dialogflow_ruby_proto", + deps = [":dialogflow_proto"], +) + +ruby_grpc_library( + name = "dialogflow_ruby_grpc", + srcs = [":dialogflow_proto"], + deps = [":dialogflow_ruby_proto"], +) + +ruby_gapic_library( + name = "dialogflow_ruby_gapic", + src = ":dialogflow_proto_with_info", + gapic_yaml = "dialogflow_gapic.yaml", + package = "google.cloud.dialogflow.v2", + service_yaml = "dialogflow_v2.yaml", + deps = [ + ":dialogflow_ruby_grpc", + ":dialogflow_ruby_proto", + ], +) + +# Open Source Packages +ruby_gapic_assembly_pkg( + name = "google-cloud-dialogflow-v2-ruby", + deps = [ + ":dialogflow_ruby_gapic", + ":dialogflow_ruby_grpc", + ":dialogflow_ruby_proto", + ], +) + +############################################################################## +# C# +############################################################################## +load( + "@com_google_googleapis_imports//:imports.bzl", + "csharp_gapic_assembly_pkg", + "csharp_gapic_library", + "csharp_grpc_library", + "csharp_proto_library", +) + +csharp_proto_library( + name = "dialogflow_csharp_proto", + deps = [":dialogflow_proto"], +) + +csharp_grpc_library( + name = "dialogflow_csharp_grpc", + srcs = [":dialogflow_proto"], + deps = [":dialogflow_csharp_proto"], +) + +csharp_gapic_library( + name = "dialogflow_csharp_gapic", + src = ":dialogflow_proto_with_info", + gapic_yaml = "dialogflow_gapic.yaml", + package = "google.cloud.dialogflow.v2", + service_yaml = "dialogflow_v2.yaml", + deps = [ + ":dialogflow_csharp_grpc", + ":dialogflow_csharp_proto", + ], +) + +# Open Source Packages +csharp_gapic_assembly_pkg( + name = "google-cloud-dialogflow-v2-csharp", + deps = [ + ":dialogflow_csharp_gapic", + ":dialogflow_csharp_grpc", + ":dialogflow_csharp_proto", + ], +) + +############################################################################## +# C++ +############################################################################## +# Put your C++ rules here diff --git a/third_party/googleapis/google/cloud/dialogflow/v2/agent.proto b/third_party/googleapis/google/cloud/dialogflow/v2/agent.proto index 0ec81e436..23a3d44f0 100644 --- a/third_party/googleapis/google/cloud/dialogflow/v2/agent.proto +++ b/third_party/googleapis/google/cloud/dialogflow/v2/agent.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,17 +11,19 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.dialogflow.v2; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/cloud/dialogflow/v2/validation_result.proto"; import "google/longrunning/operations.proto"; import "google/protobuf/empty.proto"; import "google/protobuf/field_mask.proto"; -import "google/api/client.proto"; option cc_enable_arenas = true; option csharp_namespace = "Google.Cloud.Dialogflow.V2"; @@ -70,6 +72,7 @@ service Agents { option (google.api.http) = { get: "/v2/{parent=projects/*}/agent" }; + option (google.api.method_signature) = "parent"; } // Creates/updates the specified agent. @@ -78,6 +81,7 @@ service Agents { post: "/v2/{agent.parent=projects/*}/agent" body: "agent" }; + option (google.api.method_signature) = "agent"; } // Deletes the specified agent. @@ -85,6 +89,7 @@ service Agents { option (google.api.http) = { delete: "/v2/{parent=projects/*}/agent" }; + option (google.api.method_signature) = "parent"; } // Returns the list of agents. @@ -98,6 +103,7 @@ service Agents { option (google.api.http) = { get: "/v2/{parent=projects/*}/agent:search" }; + option (google.api.method_signature) = "parent"; } // Trains the specified agent. @@ -108,6 +114,11 @@ service Agents { post: "/v2/{parent=projects/*}/agent:train" body: "*" }; + option (google.api.method_signature) = "parent"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "google.protobuf.Struct" + }; } // Exports the specified agent to a ZIP file. @@ -118,6 +129,11 @@ service Agents { post: "/v2/{parent=projects/*}/agent:export" body: "*" }; + option (google.api.method_signature) = "parent"; + option (google.longrunning.operation_info) = { + response_type: "google.cloud.dialogflow.v2.ExportAgentResponse" + metadata_type: "google.protobuf.Struct" + }; } // Imports the specified agent from a ZIP file. @@ -132,6 +148,10 @@ service Agents { post: "/v2/{parent=projects/*}/agent:import" body: "*" }; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "google.protobuf.Struct" + }; } // Restores the specified agent from a ZIP file. @@ -145,11 +165,28 @@ service Agents { post: "/v2/{parent=projects/*}/agent:restore" body: "*" }; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "google.protobuf.Struct" + }; + } + + // Gets agent validation result. Agent validation is performed during + // training time and is updated automatically when training is completed. + rpc GetValidationResult(GetValidationResultRequest) returns (ValidationResult) { + option (google.api.http) = { + get: "/v2/{parent=projects/*}/agent/validationResult" + }; } } // Represents a conversational agent. message Agent { + option (google.api.resource) = { + type: "dialogflow.googleapis.com/Agent" + pattern: "projects/{project}/agent" + }; + // Match mode determines how intents are detected from user queries. enum MatchMode { // Not specified. @@ -160,7 +197,7 @@ message Agent { MATCH_MODE_HYBRID = 1; // Can be used for agents with a large number of examples in intents, - // especially the ones using @sys.any or very large developer entities. + // especially the ones using @sys.any or very large custom entities. MATCH_MODE_ML_ONLY = 2; } @@ -196,43 +233,48 @@ message Agent { // Required. The project of this agent. // Format: `projects/`. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "cloudresourcemanager.googleapis.com/Project" + } + ]; // Required. The name of this agent. - string display_name = 2; + string display_name = 2 [(google.api.field_behavior) = REQUIRED]; // Required. The default language of the agent as a language tag. See // [Language // Support](https://cloud.google.com/dialogflow/docs/reference/language) // for a list of the currently supported language codes. This field cannot be // set by the `Update` method. - string default_language_code = 3; + string default_language_code = 3 [(google.api.field_behavior) = REQUIRED]; // Optional. The list of all languages supported by this agent (except for the // `default_language_code`). - repeated string supported_language_codes = 4; + repeated string supported_language_codes = 4 [(google.api.field_behavior) = OPTIONAL]; // Required. The time zone of this agent from the // [time zone database](https://www.iana.org/time-zones), e.g., // America/New_York, Europe/Paris. - string time_zone = 5; + string time_zone = 5 [(google.api.field_behavior) = REQUIRED]; // Optional. The description of this agent. // The maximum length is 500 characters. If exceeded, the request is rejected. - string description = 6; + string description = 6 [(google.api.field_behavior) = OPTIONAL]; // Optional. The URI of the agent's avatar. // Avatars are used throughout the Dialogflow console and in the self-hosted // [Web // Demo](https://cloud.google.com/dialogflow/docs/integrations/web-demo) // integration. - string avatar_uri = 7; + string avatar_uri = 7 [(google.api.field_behavior) = OPTIONAL]; // Optional. Determines whether this agent should log conversation queries. - bool enable_logging = 8; + bool enable_logging = 8 [(google.api.field_behavior) = OPTIONAL]; // Optional. Determines how intents are detected from user queries. - MatchMode match_mode = 9; + MatchMode match_mode = 9 [(google.api.field_behavior) = OPTIONAL]; // Optional. To filter out false positive results and still get variety in // matched natural language inputs for your agent, you can tune the machine @@ -241,52 +283,67 @@ message Agent { // are no fallback intents defined, no intent will be triggered. The score // values range from 0.0 (completely uncertain) to 1.0 (completely certain). // If set to 0.0, the default of 0.3 is used. - float classification_threshold = 10; + float classification_threshold = 10 [(google.api.field_behavior) = OPTIONAL]; // Optional. API version displayed in Dialogflow console. If not specified, // V2 API is assumed. Clients are free to query different service endpoints // for different API versions. However, bots connectors and webhook calls will // follow the specified API version. - ApiVersion api_version = 14; + ApiVersion api_version = 14 [(google.api.field_behavior) = OPTIONAL]; // Optional. The agent tier. If not specified, TIER_STANDARD is assumed. - Tier tier = 15; + Tier tier = 15 [(google.api.field_behavior) = OPTIONAL]; } // The request message for [Agents.GetAgent][google.cloud.dialogflow.v2.Agents.GetAgent]. message GetAgentRequest { // Required. The project that the agent to fetch is associated with. // Format: `projects/`. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dialogflow.googleapis.com/Agent" + } + ]; } // The request message for [Agents.SetAgent][google.cloud.dialogflow.v2.Agents.SetAgent]. message SetAgentRequest { // Required. The agent to update. - Agent agent = 1; + Agent agent = 1 [(google.api.field_behavior) = REQUIRED]; // Optional. The mask to control which fields get updated. - google.protobuf.FieldMask update_mask = 2; + google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = OPTIONAL]; } // The request message for [Agents.DeleteAgent][google.cloud.dialogflow.v2.Agents.DeleteAgent]. message DeleteAgentRequest { // Required. The project that the agent to delete is associated with. // Format: `projects/`. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dialogflow.googleapis.com/Agent" + } + ]; } // The request message for [Agents.SearchAgents][google.cloud.dialogflow.v2.Agents.SearchAgents]. message SearchAgentsRequest { // Required. The project to list agents from. // Format: `projects/`. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dialogflow.googleapis.com/Agent" + } + ]; // Optional. The maximum number of items to return in a single page. By // default 100 and at most 1000. - int32 page_size = 2; + int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; - // Optional. The next_page_token value returned from a previous list request. + // The next_page_token value returned from a previous list request. string page_token = 3; } @@ -305,45 +362,41 @@ message SearchAgentsResponse { message TrainAgentRequest { // Required. The project that the agent to train is associated with. // Format: `projects/`. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dialogflow.googleapis.com/Agent" + } + ]; } // The request message for [Agents.ExportAgent][google.cloud.dialogflow.v2.Agents.ExportAgent]. message ExportAgentRequest { // Required. The project that the agent to export is associated with. // Format: `projects/`. - string parent = 1; - - // Optional. The - // [Google Cloud Storage](https://cloud.google.com/storage/docs/) + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dialogflow.googleapis.com/Agent" + } + ]; + + // Required. The [Google Cloud Storage](https://cloud.google.com/storage/docs/) // URI to export the agent to. // The format of this URI must be `gs:///`. // If left unspecified, the serialized agent is returned inline. - string agent_uri = 2; + string agent_uri = 2 [(google.api.field_behavior) = REQUIRED]; } // The response message for [Agents.ExportAgent][google.cloud.dialogflow.v2.Agents.ExportAgent]. message ExportAgentResponse { - // Required. The exported agent. + // The exported agent. oneof agent { // The URI to a file containing the exported agent. This field is populated // only if `agent_uri` is specified in `ExportAgentRequest`. string agent_uri = 1; - // The exported agent. - // - // Example for how to export an agent to a zip file via a command line: - // 
curl \
-    //   'https://dialogflow.googleapis.com/v2/projects/<project_name>/agent:export'\
-    //   -X POST \
-    //   -H 'Authorization: Bearer '$(gcloud auth application-default
-    //   print-access-token) \
-    //   -H 'Accept: application/json' \
-    //   -H 'Content-Type: application/json' \
-    //   --compressed \
-    //   --data-binary '{}' \
-    // | grep agentContent | sed -e 's/.*"agentContent": "\([^"]*\)".*/\1/' \
-    // | base64 --decode > <agent zip file>
+ // Zip compressed raw byte content for agent. bytes agent_content = 2; } } @@ -352,7 +405,12 @@ message ExportAgentResponse { message ImportAgentRequest { // Required. The project that the agent to import is associated with. // Format: `projects/`. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dialogflow.googleapis.com/Agent" + } + ]; // Required. The agent to import. oneof agent { @@ -360,20 +418,7 @@ message ImportAgentRequest { // Note: The URI must start with "gs://". string agent_uri = 2; - // The agent to import. - // - // Example for how to import an agent via the command line: - // 
curl \
-    //   'https://dialogflow.googleapis.com/v2/projects/<project_name>/agent:import\
-    //    -X POST \
-    //    -H 'Authorization: Bearer '$(gcloud auth application-default
-    //    print-access-token) \
-    //    -H 'Accept: application/json' \
-    //    -H 'Content-Type: application/json' \
-    //    --compressed \
-    //    --data-binary "{
-    //       'agentContent': '$(cat <agent zip file> | base64 -w 0)'
-    //    }"
+ // Zip compressed raw byte content for agent. bytes agent_content = 3; } } @@ -382,7 +427,12 @@ message ImportAgentRequest { message RestoreAgentRequest { // Required. The project that the agent to restore is associated with. // Format: `projects/`. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dialogflow.googleapis.com/Agent" + } + ]; // Required. The agent to restore. oneof agent { @@ -390,20 +440,26 @@ message RestoreAgentRequest { // Note: The URI must start with "gs://". string agent_uri = 2; - // The agent to restore. - // - // Example for how to restore an agent via the command line: - // 
curl \
-    //   'https://dialogflow.googleapis.com/v2/projects/<project_name>/agent:restore\
-    //    -X POST \
-    //    -H 'Authorization: Bearer '$(gcloud auth application-default
-    //    print-access-token) \
-    //    -H 'Accept: application/json' \
-    //    -H 'Content-Type: application/json' \
-    //    --compressed \
-    //    --data-binary "{
-    //        'agentContent': '$(cat <agent zip file> | base64 -w 0)'
-    //    }"
+ // Zip compressed raw byte content for agent. bytes agent_content = 3; } } + +// The request message for [Agents.GetValidationResult][google.cloud.dialogflow.v2.Agents.GetValidationResult]. +message GetValidationResultRequest { + // Required. The project that the agent is associated with. + // Format: `projects/`. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dialogflow.googleapis.com/Agent" + } + ]; + + // Optional. The language for which you want a validation result. If not + // specified, the agent's default language is used. [Many + // languages](https://cloud.google.com/dialogflow/docs/reference/language) + // are supported. Note: languages must be enabled in the agent before they can + // be used. + string language_code = 3 [(google.api.field_behavior) = OPTIONAL]; +} diff --git a/third_party/googleapis/google/cloud/dialogflow/artman_dialogflow_v2.yaml b/third_party/googleapis/google/cloud/dialogflow/v2/artman_dialogflow_v2.yaml similarity index 92% rename from third_party/googleapis/google/cloud/dialogflow/artman_dialogflow_v2.yaml rename to third_party/googleapis/google/cloud/dialogflow/v2/artman_dialogflow_v2.yaml index c3c4c92c1..66b7b21bf 100644 --- a/third_party/googleapis/google/cloud/dialogflow/artman_dialogflow_v2.yaml +++ b/third_party/googleapis/google/cloud/dialogflow/v2/artman_dialogflow_v2.yaml @@ -5,9 +5,9 @@ common: proto_deps: - name: google-common-protos src_proto_paths: - - v2 + - . service_yaml: dialogflow_v2.yaml - gapic_yaml: v2/dialogflow_gapic.yaml + gapic_yaml: dialogflow_gapic.yaml artifacts: - name: gapic_config type: GAPIC_CONFIG diff --git a/third_party/googleapis/google/cloud/dialogflow/v2/audio_config.proto b/third_party/googleapis/google/cloud/dialogflow/v2/audio_config.proto index 3a1c600c5..975ea69a6 100644 --- a/third_party/googleapis/google/cloud/dialogflow/v2/audio_config.proto +++ b/third_party/googleapis/google/cloud/dialogflow/v2/audio_config.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,13 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.dialogflow.v2; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/duration.proto"; import "google/api/annotations.proto"; @@ -77,47 +78,33 @@ enum AudioEncoding { AUDIO_ENCODING_SPEEX_WITH_HEADER_BYTE = 7; } -// Instructs the speech recognizer how to process the audio content. -message InputAudioConfig { - // Required. Audio encoding of the audio content to process. - AudioEncoding audio_encoding = 1; - - // Required. Sample rate (in Hertz) of the audio content sent in the query. - // Refer to - // [Cloud Speech API - // documentation](https://cloud.google.com/speech-to-text/docs/basics) for - // more details. - int32 sample_rate_hertz = 2; - - // Required. The language of the supplied audio. Dialogflow does not do - // translations. See [Language - // Support](https://cloud.google.com/dialogflow/docs/reference/language) - // for a list of the currently supported language codes. Note that queries in - // the same session do not necessarily need to specify the same language. - string language_code = 3; - +// Hints for the speech recognizer to help with recognition in a specific +// conversation state. +message SpeechContext { // Optional. A list of strings containing words and phrases that the speech // recognizer should recognize with higher likelihood. // - // See [the Cloud Speech - // documentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-hints) - // for more details. - repeated string phrase_hints = 4; - - // Optional. Which variant of the [Speech model][google.cloud.dialogflow.v2.InputAudioConfig.model] to use. - SpeechModelVariant model_variant = 10; + // This list can be used to: + // * improve accuracy for words and phrases you expect the user to say, + // e.g. typical commands for your Dialogflow agent + // * add additional words to the speech recognizer vocabulary + // * ... + // + // See the [Cloud Speech + // documentation](https://cloud.google.com/speech-to-text/quotas) for usage + // limits. + repeated string phrases = 1; - // Optional. If `false` (default), recognition does not cease until the - // client closes the stream. - // If `true`, the recognizer will detect a single spoken utterance in input - // audio. Recognition ceases when it detects the audio's voice has - // stopped or paused. In this case, once a detected intent is received, the - // client should close the stream and start a new request with a new stream as - // needed. - // Note: This setting is relevant only for streaming methods. - // Note: When specified, InputAudioConfig.single_utterance takes precedence - // over StreamingDetectIntentRequest.single_utterance. - bool single_utterance = 8; + // Optional. Boost for this context compared to other contexts: + // + // * If the boost is positive, Dialogflow will increase the probability that + // the phrases in this context are recognized over similar sounding phrases. + // * If the boost is unspecified or non-positive, Dialogflow will not apply + // any boost. + // + // Dialogflow recommends that you use boosts in the range (0, 20] and that you + // find a value that fits your use case with binary search. + float boost = 2; } // Variant of the specified [Speech model][google.cloud.dialogflow.v2.InputAudioConfig.model] to use. @@ -163,15 +150,131 @@ enum SpeechModelVariant { USE_ENHANCED = 3; } +// Information for a word recognized by the speech recognizer. +message SpeechWordInfo { + // The word this info is for. + string word = 3; + + // Time offset relative to the beginning of the audio that corresponds to the + // start of the spoken word. This is an experimental feature and the accuracy + // of the time offset can vary. + google.protobuf.Duration start_offset = 1; + + // Time offset relative to the beginning of the audio that corresponds to the + // end of the spoken word. This is an experimental feature and the accuracy of + // the time offset can vary. + google.protobuf.Duration end_offset = 2; + + // The Speech confidence between 0.0 and 1.0 for this word. A higher number + // indicates an estimated greater likelihood that the recognized word is + // correct. The default of 0.0 is a sentinel value indicating that confidence + // was not set. + // + // This field is not guaranteed to be fully stable over time for the same + // audio input. Users should also not rely on it to always be provided. + float confidence = 4; +} + +// Instructs the speech recognizer how to process the audio content. +message InputAudioConfig { + // Required. Audio encoding of the audio content to process. + AudioEncoding audio_encoding = 1; + + // Required. Sample rate (in Hertz) of the audio content sent in the query. + // Refer to + // [Cloud Speech API + // documentation](https://cloud.google.com/speech-to-text/docs/basics) for + // more details. + int32 sample_rate_hertz = 2; + + // Required. The language of the supplied audio. Dialogflow does not do + // translations. See [Language + // Support](https://cloud.google.com/dialogflow/docs/reference/language) + // for a list of the currently supported language codes. Note that queries in + // the same session do not necessarily need to specify the same language. + string language_code = 3; + + // If `true`, Dialogflow returns [SpeechWordInfo][google.cloud.dialogflow.v2.SpeechWordInfo] in + // [StreamingRecognitionResult][google.cloud.dialogflow.v2.StreamingRecognitionResult] with information about the recognized speech + // words, e.g. start and end time offsets. If false or unspecified, Speech + // doesn't return any word-level information. + bool enable_word_info = 13; + + // A list of strings containing words and phrases that the speech + // recognizer should recognize with higher likelihood. + // + // See [the Cloud Speech + // documentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-hints) + // for more details. + // + // This field is deprecated. Please use [speech_contexts]() instead. If you + // specify both [phrase_hints]() and [speech_contexts](), Dialogflow will + // treat the [phrase_hints]() as a single additional [SpeechContext](). + repeated string phrase_hints = 4 [deprecated = true]; + + // Context information to assist speech recognition. + // + // See [the Cloud Speech + // documentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-hints) + // for more details. + repeated SpeechContext speech_contexts = 11; + + // Which Speech model to select for the given request. Select the + // model best suited to your domain to get best results. If a model is not + // explicitly specified, then we auto-select a model based on the parameters + // in the InputAudioConfig. + // If enhanced speech model is enabled for the agent and an enhanced + // version of the specified model for the language does not exist, then the + // speech is recognized using the standard version of the specified model. + // Refer to + // [Cloud Speech API + // documentation](https://cloud.google.com/speech-to-text/docs/basics#select-model) + // for more details. + string model = 7; + + // Which variant of the [Speech model][google.cloud.dialogflow.v2.InputAudioConfig.model] to use. + SpeechModelVariant model_variant = 10; + + // If `false` (default), recognition does not cease until the + // client closes the stream. + // If `true`, the recognizer will detect a single spoken utterance in input + // audio. Recognition ceases when it detects the audio's voice has + // stopped or paused. In this case, once a detected intent is received, the + // client should close the stream and start a new request with a new stream as + // needed. + // Note: This setting is relevant only for streaming methods. + // Note: When specified, InputAudioConfig.single_utterance takes precedence + // over StreamingDetectIntentRequest.single_utterance. + bool single_utterance = 8; +} + +// Gender of the voice as described in +// [SSML voice element](https://www.w3.org/TR/speech-synthesis11/#edef_voice). +enum SsmlVoiceGender { + // An unspecified gender, which means that the client doesn't care which + // gender the selected voice will have. + SSML_VOICE_GENDER_UNSPECIFIED = 0; + + // A male voice. + SSML_VOICE_GENDER_MALE = 1; + + // A female voice. + SSML_VOICE_GENDER_FEMALE = 2; + + // A gender-neutral voice. + SSML_VOICE_GENDER_NEUTRAL = 3; +} + // Description of which voice to use for speech synthesis. message VoiceSelectionParams { // Optional. The name of the voice. If not set, the service will choose a - // voice based on the other parameters such as language_code and gender. + // voice based on the other parameters such as language_code and + // [ssml_gender][google.cloud.dialogflow.v2.VoiceSelectionParams.ssml_gender]. string name = 1; // Optional. The preferred gender of the voice. If not set, the service will // choose a voice based on the other parameters such as language_code and - // name. Note that this is only a preference, not requirement. If a + // [name][google.cloud.dialogflow.v2.VoiceSelectionParams.name]. Note that this is only a preference, not requirement. If a // voice of the appropriate gender is not available, the synthesizer should // substitute a voice with a different gender rather than failing the request. SsmlVoiceGender ssml_gender = 2; @@ -209,39 +312,6 @@ message SynthesizeSpeechConfig { VoiceSelectionParams voice = 4; } -// Gender of the voice as described in -// [SSML voice element](https://www.w3.org/TR/speech-synthesis11/#edef_voice). -enum SsmlVoiceGender { - // An unspecified gender, which means that the client doesn't care which - // gender the selected voice will have. - SSML_VOICE_GENDER_UNSPECIFIED = 0; - - // A male voice. - SSML_VOICE_GENDER_MALE = 1; - - // A female voice. - SSML_VOICE_GENDER_FEMALE = 2; - - // A gender-neutral voice. - SSML_VOICE_GENDER_NEUTRAL = 3; -} - -// Instructs the speech synthesizer on how to generate the output audio content. -message OutputAudioConfig { - // Required. Audio encoding of the synthesized audio content. - OutputAudioEncoding audio_encoding = 1; - - // Optional. The synthesis sample rate (in hertz) for this audio. If not - // provided, then the synthesizer will use the default sample rate based on - // the audio encoding. If this is different from the voice's natural sample - // rate, then the synthesizer will honor this request by converting to the - // desired sample rate (which might result in worse audio quality). - int32 sample_rate_hertz = 2; - - // Optional. Configuration of how speech should be synthesized. - SynthesizeSpeechConfig synthesize_speech_config = 3; -} - // Audio encoding of the output audio format in Text-To-Speech. enum OutputAudioEncoding { // Not specified. @@ -251,7 +321,7 @@ enum OutputAudioEncoding { // Audio content returned as LINEAR16 also contains a WAV header. OUTPUT_AUDIO_ENCODING_LINEAR_16 = 1; - // MP3 audio. + // MP3 audio at 32kbps. OUTPUT_AUDIO_ENCODING_MP3 = 2; // Opus encoded audio wrapped in an ogg container. The result will be a @@ -260,3 +330,21 @@ enum OutputAudioEncoding { // than MP3 while using approximately the same bitrate. OUTPUT_AUDIO_ENCODING_OGG_OPUS = 3; } + +// Instructs the speech synthesizer on how to generate the output audio content. +// If this audio config is supplied in a request, it overrides all existing +// text-to-speech settings applied to the agent. +message OutputAudioConfig { + // Required. Audio encoding of the synthesized audio content. + OutputAudioEncoding audio_encoding = 1 [(google.api.field_behavior) = REQUIRED]; + + // The synthesis sample rate (in hertz) for this audio. If not + // provided, then the synthesizer will use the default sample rate based on + // the audio encoding. If this is different from the voice's natural sample + // rate, then the synthesizer will honor this request by converting to the + // desired sample rate (which might result in worse audio quality). + int32 sample_rate_hertz = 2; + + // Configuration of how speech should be synthesized. + SynthesizeSpeechConfig synthesize_speech_config = 3; +} diff --git a/third_party/googleapis/google/cloud/dialogflow/v2/context.proto b/third_party/googleapis/google/cloud/dialogflow/v2/context.proto index 1df6f7695..e647c4ff9 100644 --- a/third_party/googleapis/google/cloud/dialogflow/v2/context.proto +++ b/third_party/googleapis/google/cloud/dialogflow/v2/context.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,17 +11,18 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.dialogflow.v2; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/protobuf/empty.proto"; import "google/protobuf/field_mask.proto"; import "google/protobuf/struct.proto"; -import "google/api/client.proto"; option cc_enable_arenas = true; option csharp_namespace = "Google.Cloud.Dialogflow.V2"; @@ -59,14 +60,22 @@ service Contexts { rpc ListContexts(ListContextsRequest) returns (ListContextsResponse) { option (google.api.http) = { get: "/v2/{parent=projects/*/agent/sessions/*}/contexts" + additional_bindings { + get: "/v2/{parent=projects/*/agent/environments/*/users/*/sessions/*}/contexts" + } }; + option (google.api.method_signature) = "parent"; } // Retrieves the specified context. rpc GetContext(GetContextRequest) returns (Context) { option (google.api.http) = { get: "/v2/{name=projects/*/agent/sessions/*/contexts/*}" + additional_bindings { + get: "/v2/{name=projects/*/agent/environments/*/users/*/sessions/*/contexts/*}" + } }; + option (google.api.method_signature) = "name"; } // Creates a context. @@ -76,7 +85,12 @@ service Contexts { option (google.api.http) = { post: "/v2/{parent=projects/*/agent/sessions/*}/contexts" body: "context" + additional_bindings { + post: "/v2/{parent=projects/*/agent/environments/*/users/*/sessions/*}/contexts" + body: "context" + } }; + option (google.api.method_signature) = "parent,context"; } // Updates the specified context. @@ -84,58 +98,109 @@ service Contexts { option (google.api.http) = { patch: "/v2/{context.name=projects/*/agent/sessions/*/contexts/*}" body: "context" + additional_bindings { + patch: "/v2/{context.name=projects/*/agent/environments/*/users/*/sessions/*/contexts/*}" + body: "context" + } }; + option (google.api.method_signature) = "context,update_mask"; } // Deletes the specified context. rpc DeleteContext(DeleteContextRequest) returns (google.protobuf.Empty) { option (google.api.http) = { delete: "/v2/{name=projects/*/agent/sessions/*/contexts/*}" + additional_bindings { + delete: "/v2/{name=projects/*/agent/environments/*/users/*/sessions/*/contexts/*}" + } }; + option (google.api.method_signature) = "name"; } // Deletes all active contexts in the specified session. rpc DeleteAllContexts(DeleteAllContextsRequest) returns (google.protobuf.Empty) { option (google.api.http) = { delete: "/v2/{parent=projects/*/agent/sessions/*}/contexts" + additional_bindings { + delete: "/v2/{parent=projects/*/agent/environments/*/users/*/sessions/*}/contexts" + } }; + option (google.api.method_signature) = "parent"; } } // Represents a context. message Context { + option (google.api.resource) = { + type: "dialogflow.googleapis.com/Context" + pattern: "projects/{project}/agent/sessions/{session}/contexts/{context}" + pattern: "projects/{project}/agent/environments/{environment}/users/{user}/sessions/{session}/contexts/{context}" + }; + // Required. The unique identifier of the context. Format: - // `projects//agent/sessions//contexts/`. + // `projects//agent/sessions//contexts/`, + // or `projects//agent/environments//users//sessions//contexts/`. // // The `Context ID` is always converted to lowercase, may only contain - // characters in [a-zA-Z0-9_-%] and may be at most 250 bytes long. - string name = 1; + // characters in a-zA-Z0-9_-% and may be at most 250 bytes long. + // + // If `Environment ID` is not specified, we assume default 'draft' + // environment. If `User ID` is not specified, we assume default '-' user. + // + // The following context names are reserved for internal use by Dialogflow. + // You should not use these contexts or create contexts with these names: + // + // * `__system_counters__` + // * `*_id_dialog_context` + // * `*_dialog_params_size` + string name = 1 [(google.api.field_behavior) = REQUIRED]; // Optional. The number of conversational query requests after which the - // context expires. If set to `0` (the default) the context expires + // context expires. The default is `0`. If set to `0`, the context expires // immediately. Contexts expire automatically after 20 minutes if there // are no matching queries. - int32 lifespan_count = 2; + int32 lifespan_count = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. The collection of parameters associated with this context. - // Refer to [this - // doc](https://cloud.google.com/dialogflow/docs/intents-actions-parameters) - // for syntax. - google.protobuf.Struct parameters = 3; + // + // Depending on your protocol or client library language, this is a + // map, associative array, symbol table, dictionary, or JSON object + // composed of a collection of (MapKey, MapValue) pairs: + // + // - MapKey type: string + // - MapKey value: parameter name + // - MapValue type: + // - If parameter's entity type is a composite entity: map + // - Else: string or number, depending on parameter value type + // - MapValue value: + // - If parameter's entity type is a composite entity: + // map from composite entity property names to property values + // - Else: parameter value + google.protobuf.Struct parameters = 3 [(google.api.field_behavior) = OPTIONAL]; } // The request message for [Contexts.ListContexts][google.cloud.dialogflow.v2.Contexts.ListContexts]. message ListContextsRequest { // Required. The session to list all contexts from. - // Format: `projects//agent/sessions/`. - string parent = 1; + // Format: `projects//agent/sessions/` or + // `projects//agent/environments//users//sessions/`. + // If `Environment ID` is not specified, we assume default 'draft' + // environment. If `User ID` is not specified, we assume default '-' user. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dialogflow.googleapis.com/Context" + } + ]; // Optional. The maximum number of items to return in a single page. By // default 100 and at most 1000. - int32 page_size = 2; + int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. The next_page_token value returned from a previous list request. - string page_token = 3; + string page_token = 3 [(google.api.field_behavior) = OPTIONAL]; } // The response message for [Contexts.ListContexts][google.cloud.dialogflow.v2.Contexts.ListContexts]. @@ -152,39 +217,75 @@ message ListContextsResponse { // The request message for [Contexts.GetContext][google.cloud.dialogflow.v2.Contexts.GetContext]. message GetContextRequest { // Required. The name of the context. Format: - // `projects//agent/sessions//contexts/`. - string name = 1; + // `projects//agent/sessions//contexts/` + // or `projects//agent/environments//users//sessions//contexts/`. + // If `Environment ID` is not specified, we assume default 'draft' + // environment. If `User ID` is not specified, we assume default '-' user. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "dialogflow.googleapis.com/Context" + } + ]; } // The request message for [Contexts.CreateContext][google.cloud.dialogflow.v2.Contexts.CreateContext]. message CreateContextRequest { // Required. The session to create a context for. - // Format: `projects//agent/sessions/`. - string parent = 1; + // Format: `projects//agent/sessions/` or + // `projects//agent/environments//users//sessions/`. + // If `Environment ID` is not specified, we assume default 'draft' + // environment. If `User ID` is not specified, we assume default '-' user. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dialogflow.googleapis.com/Context" + } + ]; // Required. The context to create. - Context context = 2; + Context context = 2 [(google.api.field_behavior) = REQUIRED]; } // The request message for [Contexts.UpdateContext][google.cloud.dialogflow.v2.Contexts.UpdateContext]. message UpdateContextRequest { // Required. The context to update. - Context context = 1; + Context context = 1 [(google.api.field_behavior) = REQUIRED]; // Optional. The mask to control which fields get updated. - google.protobuf.FieldMask update_mask = 2; + google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = OPTIONAL]; } // The request message for [Contexts.DeleteContext][google.cloud.dialogflow.v2.Contexts.DeleteContext]. message DeleteContextRequest { // Required. The name of the context to delete. Format: - // `projects//agent/sessions//contexts/`. - string name = 1; + // `projects//agent/sessions//contexts/` + // or `projects//agent/environments//users//sessions//contexts/`. + // If `Environment ID` is not specified, we assume default 'draft' + // environment. If `User ID` is not specified, we assume default '-' user. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "dialogflow.googleapis.com/Context" + } + ]; } // The request message for [Contexts.DeleteAllContexts][google.cloud.dialogflow.v2.Contexts.DeleteAllContexts]. message DeleteAllContextsRequest { // Required. The name of the session to delete all contexts from. Format: - // `projects//agent/sessions/`. - string parent = 1; + // `projects//agent/sessions/` or `projects//agent/environments//users//sessions/`. + // If `Environment ID` is not specified we assume default 'draft' environment. + // If `User ID` is not specified, we assume default '-' user. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dialogflow.googleapis.com/Context" + } + ]; } diff --git a/third_party/googleapis/google/cloud/dialogflow/v2/dialogflow_gapic.legacy.yaml b/third_party/googleapis/google/cloud/dialogflow/v2/dialogflow_gapic.legacy.yaml new file mode 100644 index 000000000..fa25d16a5 --- /dev/null +++ b/third_party/googleapis/google/cloud/dialogflow/v2/dialogflow_gapic.legacy.yaml @@ -0,0 +1,1359 @@ +type: com.google.api.codegen.ConfigProto +config_schema_version: 1.0.0 +# The settings of generated code in a specific language. +language_settings: + java: + package_name: com.google.cloud.dialogflow.v2 + python: + package_name: google.cloud.dialogflow_v2.gapic + go: + package_name: cloud.google.com/go/dialogflow/apiv2 + release_level: GA + csharp: + package_name: Google.Cloud.Dialogflow.V2 + ruby: + package_name: Google::Cloud::Dialogflow::V2 + php: + package_name: Google\Cloud\Dialogflow\V2 + nodejs: + package_name: dialogflow.v2 + domain_layer_location: google-cloud +# A list of API interface configurations. +interfaces: +# The fully qualified name of the API interface. +- name: google.cloud.dialogflow.v2.Agents + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: + - name_pattern: projects/{project} + entity_name: project + language_overrides: + - language: csharp + common_resource_name: Google.Api.Gax.ResourceNames.ProjectName + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - UNAVAILABLE + - DEADLINE_EXCEEDED + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # name - The simple name of the method. + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce + # method overloads which allow a client to directly pass request message + # fields as method parameters. This information may or may not be used, + # depending on the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request + # message. + # required_fields - Fields that are always required for a request to be + # valid. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a + # paging list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It + # defines which fields match the paging pattern in the request. The + # request consists of a page_size_field and a token_field. The + # page_size_field is the name of the optional field specifying the + # maximum number of elements to be returned in the response. The + # token_field is the name of the field in the request containing the + # page token. + # The response specifies response information of the list method. It + # defines which fields match the paging pattern in the response. The + # response consists of a token_field and a resources_field. The + # token_field is the name of the field in the response containing the + # next page token. The resources_field is the name of the field in the + # response containing the list of resources belonging to the page. + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: SetAgent + flattening: + groups: + - parameters: + - agent + required_fields: + - agent + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + agent.parent: project + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES + - name: DeleteAgent + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: project + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES + - name: GetAgent + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: project + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES + - name: SearchAgents + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: agents + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: project + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES + - name: TrainAgent + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: project + timeout_millis: 60000 + long_running: + # LINT.IfChange(train_agent_long_running_operation) + return_type: google.protobuf.Empty + metadata_type: google.protobuf.Struct + # LINT.ThenChange() + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + resource_name_treatment: STATIC_TYPES + - name: ExportAgent + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: project + timeout_millis: 60000 + long_running: + # LINT.IfChange(export_agent_long_running_operation) + return_type: google.cloud.dialogflow.v2.ExportAgentResponse + metadata_type: google.protobuf.Struct + # LINT.ThenChange() + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + resource_name_treatment: STATIC_TYPES + - name: ImportAgent + required_fields: + - parent + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: project + timeout_millis: 60000 + long_running: + # LINT.IfChange(import_agent_long_running_operation) + return_type: google.protobuf.Empty + metadata_type: google.protobuf.Struct + # LINT.ThenChange() + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + resource_name_treatment: STATIC_TYPES + - name: RestoreAgent + + required_fields: + - parent + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: project + timeout_millis: 60000 + long_running: + # LINT.IfChange(restore_agent_long_running_operation) + return_type: google.protobuf.Empty + metadata_type: google.protobuf.Struct + # LINT.ThenChange() + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + resource_name_treatment: STATIC_TYPES +# The fully qualified name of the API interface. +- name: google.cloud.dialogflow.v2.Contexts + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: + - name_pattern: projects/{project}/agent/sessions/{session} + entity_name: session + - name_pattern: projects/{project}/agent/sessions/{session}/contexts/{context} + entity_name: context + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - UNAVAILABLE + - DEADLINE_EXCEEDED + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # name - The simple name of the method. + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce + # method overloads which allow a client to directly pass request message + # fields as method parameters. This information may or may not be used, + # depending on the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request + # message. + # required_fields - Fields that are always required for a request to be + # valid. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a + # paging list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It + # defines which fields match the paging pattern in the request. The + # request consists of a page_size_field and a token_field. The + # page_size_field is the name of the optional field specifying the + # maximum number of elements to be returned in the response. The + # token_field is the name of the field in the request containing the + # page token. + # The response specifies response information of the list method. It + # defines which fields match the paging pattern in the response. The + # response consists of a token_field and a resources_field. The + # token_field is the name of the field in the response containing the + # next page token. The resources_field is the name of the field in the + # response containing the list of resources belonging to the page. + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: ListContexts + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: contexts + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: session + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES + - name: GetContext + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: context + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES + - name: CreateContext + flattening: + groups: + - parameters: + - parent + - context + required_fields: + - parent + - context + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: session + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES + - name: UpdateContext + flattening: + groups: + - parameters: + - context + required_fields: + - context + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + context.name: context + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES + - name: DeleteContext + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: context + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES + - name: DeleteAllContexts + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: session + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES +# The fully qualified name of the API interface. +- name: google.cloud.dialogflow.v2.EntityTypes + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: + - name_pattern: projects/{project}/agent + entity_name: project_agent + - name_pattern: projects/{project}/agent/entityTypes/{entity_type} + entity_name: entity_type + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - UNAVAILABLE + - DEADLINE_EXCEEDED + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # name - The simple name of the method. + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce + # method overloads which allow a client to directly pass request message + # fields as method parameters. This information may or may not be used, + # depending on the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request + # message. + # required_fields - Fields that are always required for a request to be + # valid. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a + # paging list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It + # defines which fields match the paging pattern in the request. The + # request consists of a page_size_field and a token_field. The + # page_size_field is the name of the optional field specifying the + # maximum number of elements to be returned in the response. The + # token_field is the name of the field in the request containing the + # page token. + # The response specifies response information of the list method. It + # defines which fields match the paging pattern in the response. The + # response consists of a token_field and a resources_field. The + # token_field is the name of the field in the response containing the + # next page token. The resources_field is the name of the field in the + # response containing the list of resources belonging to the page. + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: ListEntityTypes + flattening: + groups: + - parameters: + - parent + - parameters: + - parent + - language_code + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: entity_types + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: project_agent + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES + - name: GetEntityType + flattening: + groups: + - parameters: + - name + - parameters: + - name + - language_code + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: entity_type + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES + - name: CreateEntityType + flattening: + groups: + - parameters: + - parent + - entity_type + - parameters: + - parent + - entity_type + - language_code + required_fields: + - parent + - entity_type + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: project_agent + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES + - name: UpdateEntityType + flattening: + groups: + - parameters: + - entity_type + - parameters: + - entity_type + - language_code + required_fields: + - entity_type + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + entity_type.name: entity_type + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES + - name: DeleteEntityType + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: entity_type + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES + - name: BatchUpdateEntityTypes + required_fields: + - parent + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: project_agent + timeout_millis: 60000 + long_running: + # LINT.IfChange(batch_update_entity_types_long_running_operation) + return_type: google.cloud.dialogflow.v2.BatchUpdateEntityTypesResponse + metadata_type: google.protobuf.Struct + # LINT.ThenChange() + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + resource_name_treatment: STATIC_TYPES + - name: BatchDeleteEntityTypes + flattening: + groups: + - parameters: + - parent + - entity_type_names + required_fields: + - parent + - entity_type_names + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: project_agent + timeout_millis: 60000 + long_running: + # LINT.IfChange(batch_delete_entity_types_long_running_operation) + return_type: google.protobuf.Empty + metadata_type: google.protobuf.Struct + # LINT.ThenChange() + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + resource_name_treatment: STATIC_TYPES + - name: BatchCreateEntities + flattening: + groups: + - parameters: + - parent + - entities + - parameters: + - parent + - entities + - language_code + required_fields: + - parent + - entities + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: entity_type + timeout_millis: 60000 + long_running: + # LINT.IfChange(batch_create_entities_long_running_operation) + return_type: google.protobuf.Empty + metadata_type: google.protobuf.Struct + # LINT.ThenChange() + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + resource_name_treatment: STATIC_TYPES + - name: BatchUpdateEntities + flattening: + groups: + - parameters: + - parent + - entities + - parameters: + - parent + - entities + - language_code + required_fields: + - parent + - entities + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: entity_type + timeout_millis: 60000 + long_running: + # LINT.IfChange(batch_update_entities_long_running_operation) + return_type: google.protobuf.Empty + metadata_type: google.protobuf.Struct + # LINT.ThenChange() + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + resource_name_treatment: STATIC_TYPES + - name: BatchDeleteEntities + flattening: + groups: + - parameters: + - parent + - entity_values + - parameters: + - parent + - entity_values + - language_code + required_fields: + - parent + - entity_values + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: entity_type + timeout_millis: 60000 + long_running: + # LINT.IfChange(batch_delete_entities_long_running_operation) + return_type: google.protobuf.Empty + metadata_type: google.protobuf.Struct + # LINT.ThenChange() + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + resource_name_treatment: STATIC_TYPES +# The fully qualified name of the API interface. +- name: google.cloud.dialogflow.v2.Intents + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: + - name_pattern: projects/{project}/agent + entity_name: project_agent + - name_pattern: projects/{project}/agent/intents/{intent} + entity_name: intent + - name_pattern: projects/{project}/agents/{agent} + entity_name: agent + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - UNAVAILABLE + - DEADLINE_EXCEEDED + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # name - The simple name of the method. + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce + # method overloads which allow a client to directly pass request message + # fields as method parameters. This information may or may not be used, + # depending on the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request + # message. + # required_fields - Fields that are always required for a request to be + # valid. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a + # paging list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It + # defines which fields match the paging pattern in the request. The + # request consists of a page_size_field and a token_field. The + # page_size_field is the name of the optional field specifying the + # maximum number of elements to be returned in the response. The + # token_field is the name of the field in the request containing the + # page token. + # The response specifies response information of the list method. It + # defines which fields match the paging pattern in the response. The + # response consists of a token_field and a resources_field. The + # token_field is the name of the field in the response containing the + # next page token. The resources_field is the name of the field in the + # response containing the list of resources belonging to the page. + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: ListIntents + flattening: + groups: + - parameters: + - parent + - parameters: + - parent + - language_code + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: intents + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: project_agent + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES + - name: GetIntent + flattening: + groups: + - parameters: + - name + - parameters: + - name + - language_code + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: intent + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES + - name: CreateIntent + flattening: + groups: + - parameters: + - parent + - intent + - parameters: + - parent + - intent + - language_code + required_fields: + - parent + - intent + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: project_agent + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES + - name: UpdateIntent + flattening: + groups: + - parameters: + - intent + - language_code + - parameters: + - intent + - language_code + - update_mask + required_fields: + - intent + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + intent.name: intent + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES + - name: DeleteIntent + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: intent + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES + - name: BatchUpdateIntents + required_fields: + - parent + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: project_agent + timeout_millis: 60000 + long_running: + # LINT.IfChange(batch_update_intents_long_running_operation) + return_type: google.cloud.dialogflow.v2.BatchUpdateIntentsResponse + metadata_type: google.protobuf.Struct + # LINT.ThenChange() + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + resource_name_treatment: STATIC_TYPES + - name: BatchDeleteIntents + flattening: + groups: + - parameters: + - parent + - intents + required_fields: + - parent + - intents + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: project_agent + timeout_millis: 60000 + long_running: + # LINT.IfChange(batch_delete_intents_long_running_operation) + return_type: google.protobuf.Empty + metadata_type: google.protobuf.Struct + # LINT.ThenChange() + initial_poll_delay_millis: 500 + poll_delay_multiplier: 1.5 + max_poll_delay_millis: 5000 + total_poll_timeout_millis: 300000 + resource_name_treatment: STATIC_TYPES +# The fully qualified name of the API interface. +- name: google.cloud.dialogflow.v2.SessionEntityTypes + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: + - name_pattern: projects/{project}/agent/sessions/{session} + entity_name: session + - name_pattern: projects/{project}/agent/sessions/{session}/entityTypes/{entity_type} + entity_name: session_entity_type + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - UNAVAILABLE + - DEADLINE_EXCEEDED + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # name - The simple name of the method. + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce + # method overloads which allow a client to directly pass request message + # fields as method parameters. This information may or may not be used, + # depending on the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request + # message. + # required_fields - Fields that are always required for a request to be + # valid. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a + # paging list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It + # defines which fields match the paging pattern in the request. The + # request consists of a page_size_field and a token_field. The + # page_size_field is the name of the optional field specifying the + # maximum number of elements to be returned in the response. The + # token_field is the name of the field in the request containing the + # page token. + # The response specifies response information of the list method. It + # defines which fields match the paging pattern in the response. The + # response consists of a token_field and a resources_field. The + # token_field is the name of the field in the response containing the + # next page token. The resources_field is the name of the field in the + # response containing the list of resources belonging to the page. + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: ListSessionEntityTypes + flattening: + groups: + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: session_entity_types + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: session + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES + - name: GetSessionEntityType + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: session_entity_type + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES + - name: CreateSessionEntityType + flattening: + groups: + - parameters: + - parent + - session_entity_type + required_fields: + - parent + - session_entity_type + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + parent: session + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES + - name: UpdateSessionEntityType + flattening: + groups: + - parameters: + - session_entity_type + required_fields: + - session_entity_type + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + session_entity_type.name: session_entity_type + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES + - name: DeleteSessionEntityType + flattening: + groups: + - parameters: + - name + required_fields: + - name + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + name: session_entity_type + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES +# The fully qualified name of the API interface. +- name: google.cloud.dialogflow.v2.Sessions + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: + - name_pattern: projects/{project}/agent/sessions/{session} + entity_name: session + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - UNAVAILABLE + - DEADLINE_EXCEEDED + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # name - The simple name of the method. + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce + # method overloads which allow a client to directly pass request message + # fields as method parameters. This information may or may not be used, + # depending on the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request + # message. + # required_fields - Fields that are always required for a request to be + # valid. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a + # paging list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It + # defines which fields match the paging pattern in the request. The + # request consists of a page_size_field and a token_field. The + # page_size_field is the name of the optional field specifying the + # maximum number of elements to be returned in the response. The + # token_field is the name of the field in the request containing the + # page token. + # The response specifies response information of the list method. It + # defines which fields match the paging pattern in the response. The + # response consists of a token_field and a resources_field. The + # token_field is the name of the field in the response containing the + # next page token. The resources_field is the name of the field in the + # response containing the list of resources belonging to the page. + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: DetectIntent + flattening: + groups: + - parameters: + - session + - query_input + required_fields: + - session + - query_input + retry_codes_name: non_idempotent + retry_params_name: default + field_name_patterns: + session: session + timeout_millis: 220000 + resource_name_treatment: STATIC_TYPES + - name: StreamingDetectIntent + required_fields: + - session + - query_input + retry_codes_name: non_idempotent + retry_params_name: default + timeout_millis: 220000 +# The fully qualified name of the API interface. +- name: google.cloud.dialogflow.v2.Environments + # A list of resource collection configurations. + # Consists of a name_pattern and an entity_name. + # The name_pattern is a pattern to describe the names of the resources of this + # collection, using the platform's conventions for URI patterns. A generator + # may use this to generate methods to compose and decompose such names. The + # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; + # those will be taken as hints for the parameter names of the generated + # methods. If empty, no name methods are generated. + # The entity_name is the name to be used as a basis for generated methods and + # classes. + collections: + - name_pattern: projects/{project}/agent + entity_name: project_agent + - name_pattern: projects/{project}/agent/environments/{environment} + entity_name: environment + # Definition for retryable codes. + retry_codes_def: + - name: idempotent + retry_codes: + - UNAVAILABLE + - INTERNAL + - name: non_idempotent + retry_codes: [] + # Definition for retry/backoff parameters. + retry_params_def: + - name: default + initial_retry_delay_millis: 100 + retry_delay_multiplier: 1.3 + max_retry_delay_millis: 60000 + initial_rpc_timeout_millis: 20000 + rpc_timeout_multiplier: 1 + max_rpc_timeout_millis: 20000 + total_timeout_millis: 600000 + # A list of method configurations. + # Common properties: + # name - The simple name of the method. + # flattening - Specifies the configuration for parameter flattening. + # Describes the parameter groups for which a generator should produce + # method overloads which allow a client to directly pass request message + # fields as method parameters. This information may or may not be used, + # depending on the target language. + # Consists of groups, which each represent a list of parameters to be + # flattened. Each parameter listed must be a field of the request + # message. + # required_fields - Fields that are always required for a request to be + # valid. + # + # page_streaming - Specifies the configuration for paging. + # Describes information for generating a method which transforms a + # paging list RPC into a stream of resources. + # Consists of a request and a response. + # The request specifies request information of the list method. It + # defines which fields match the paging pattern in the request. The + # request consists of a page_size_field and a token_field. The + # page_size_field is the name of the optional field specifying the + # maximum number of elements to be returned in the response. The + # token_field is the name of the field in the request containing the + # page token. + # The response specifies response information of the list method. It + # defines which fields match the paging pattern in the response. The + # response consists of a token_field and a resources_field. The + # token_field is the name of the field in the response containing the + # next page token. The resources_field is the name of the field in the + # response containing the list of resources belonging to the page. + # retry_codes_name - Specifies the configuration for retryable codes. The + # name must be defined in interfaces.retry_codes_def. + # retry_params_name - Specifies the configuration for retry/backoff + # parameters. The name must be defined in interfaces.retry_params_def. + # field_name_patterns - Maps the field name of the request type to + # entity_name of interfaces.collections. + # Specifies the string pattern that the field must follow. + # timeout_millis - Specifies the default timeout for a non-retrying call. If + # the call is retrying, refer to retry_params_name instead. + methods: + - name: ListEnvironments + flattening: + groups: + - parameters: + - parent + - parameters: + - parent + required_fields: + - parent + page_streaming: + request: + page_size_field: page_size + token_field: page_token + response: + token_field: next_page_token + resources_field: environments + retry_codes_name: idempotent + retry_params_name: default + field_name_patterns: + parent: project_agent + timeout_millis: 60000 + resource_name_treatment: STATIC_TYPES +resource_name_generation: +- message_name: SetAgentRequest + field_entity_map: + agent.parent: project +- message_name: DeleteAgentRequest + field_entity_map: + parent: project +- message_name: GetAgentRequest + field_entity_map: + parent: project +- message_name: SearchAgentsRequest + field_entity_map: + parent: project +- message_name: TrainAgentRequest + field_entity_map: + parent: project +- message_name: ExportAgentRequest + field_entity_map: + parent: project +- message_name: ImportAgentRequest + field_entity_map: + parent: project +- message_name: RestoreAgentRequest + field_entity_map: + parent: project +- message_name: ListContextsRequest + field_entity_map: + parent: session +- message_name: GetContextRequest + field_entity_map: + name: context +- message_name: CreateContextRequest + field_entity_map: + parent: session +- message_name: Context + field_entity_map: + name: context +- message_name: DeleteContextRequest + field_entity_map: + name: context +- message_name: DeleteAllContextsRequest + field_entity_map: + parent: session +- message_name: ListEntityTypesRequest + field_entity_map: + parent: project_agent +- message_name: GetEntityTypeRequest + field_entity_map: + name: entity_type +- message_name: CreateEntityTypeRequest + field_entity_map: + parent: project_agent +- message_name: EntityType + field_entity_map: + name: entity_type +- message_name: DeleteEntityTypeRequest + field_entity_map: + name: entity_type +- message_name: BatchUpdateEntityTypesRequest + field_entity_map: + parent: project_agent +- message_name: BatchDeleteEntityTypesRequest + field_entity_map: + parent: project_agent +- message_name: BatchCreateEntitiesRequest + field_entity_map: + parent: entity_type +- message_name: BatchUpdateEntitiesRequest + field_entity_map: + parent: entity_type +- message_name: BatchDeleteEntitiesRequest + field_entity_map: + parent: entity_type +- message_name: ListIntentsRequest + field_entity_map: + parent: project_agent +- message_name: GetIntentRequest + field_entity_map: + name: intent +- message_name: CreateIntentRequest + field_entity_map: + parent: project_agent +- message_name: Intent + field_entity_map: + name: intent +- message_name: DeleteIntentRequest + field_entity_map: + name: intent +- message_name: BatchUpdateIntentsRequest + field_entity_map: + parent: project_agent +- message_name: BatchDeleteIntentsRequest + field_entity_map: + parent: project_agent +- message_name: ListSessionEntityTypesRequest + field_entity_map: + parent: session +- message_name: GetSessionEntityTypeRequest + field_entity_map: + name: session_entity_type +- message_name: CreateSessionEntityTypeRequest + field_entity_map: + parent: session +- message_name: SessionEntityType + field_entity_map: + name: session_entity_type +- message_name: DeleteSessionEntityTypeRequest + field_entity_map: + name: session_entity_type +- message_name: DetectIntentRequest + field_entity_map: + session: session +- message_name: ListEnvironmentsRequest + field_entity_map: + parent: project_agent diff --git a/third_party/googleapis/google/cloud/dialogflow/v2/dialogflow_gapic.yaml b/third_party/googleapis/google/cloud/dialogflow/v2/dialogflow_gapic.yaml index 0c9077039..b110289ba 100644 --- a/third_party/googleapis/google/cloud/dialogflow/v2/dialogflow_gapic.yaml +++ b/third_party/googleapis/google/cloud/dialogflow/v2/dialogflow_gapic.yaml @@ -1,6 +1,5 @@ type: com.google.api.codegen.ConfigProto -config_schema_version: 1.0.0 -# The settings of generated code in a specific language. +config_schema_version: 2.0.0 language_settings: java: package_name: com.google.cloud.dialogflow.v2 @@ -8,6 +7,7 @@ language_settings: package_name: google.cloud.dialogflow_v2.gapic go: package_name: cloud.google.com/go/dialogflow/apiv2 + release_level: GA csharp: package_name: Google.Cloud.Dialogflow.V2 ruby: @@ -17,1243 +17,48 @@ language_settings: nodejs: package_name: dialogflow.v2 domain_layer_location: google-cloud -# A list of API interface configurations. interfaces: - # The fully qualified name of the API interface. - name: google.cloud.dialogflow.v2.Agents - # A list of resource collection configurations. - # Consists of a name_pattern and an entity_name. - # The name_pattern is a pattern to describe the names of the resources of this - # collection, using the platform's conventions for URI patterns. A generator - # may use this to generate methods to compose and decompose such names. The - # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; - # those will be taken as hints for the parameter names of the generated - # methods. If empty, no name methods are generated. - # The entity_name is the name to be used as a basis for generated methods and - # classes. - collections: - - name_pattern: projects/{project} - entity_name: project - language_overrides: - - language: csharp - common_resource_name: Google.Api.Gax.ResourceNames.ProjectName - # Definition for retryable codes. - retry_codes_def: - - name: idempotent - retry_codes: - - UNAVAILABLE - - DEADLINE_EXCEEDED - - name: non_idempotent - retry_codes: [] - # Definition for retry/backoff parameters. - retry_params_def: - - name: default - initial_retry_delay_millis: 100 - retry_delay_multiplier: 1.3 - max_retry_delay_millis: 60000 - initial_rpc_timeout_millis: 20000 - rpc_timeout_multiplier: 1 - max_rpc_timeout_millis: 20000 - total_timeout_millis: 600000 - # A list of method configurations. - # Common properties: - # name - The simple name of the method. - # flattening - Specifies the configuration for parameter flattening. - # Describes the parameter groups for which a generator should produce - # method overloads which allow a client to directly pass request message - # fields as method parameters. This information may or may not be used, - # depending on the target language. - # Consists of groups, which each represent a list of parameters to be - # flattened. Each parameter listed must be a field of the request - # message. - # required_fields - Fields that are always required for a request to be - # valid. - # - # page_streaming - Specifies the configuration for paging. - # Describes information for generating a method which transforms a - # paging list RPC into a stream of resources. - # Consists of a request and a response. - # The request specifies request information of the list method. It - # defines which fields match the paging pattern in the request. The - # request consists of a page_size_field and a token_field. The - # page_size_field is the name of the optional field specifying the - # maximum number of elements to be returned in the response. The - # token_field is the name of the field in the request containing the - # page token. - # The response specifies response information of the list method. It - # defines which fields match the paging pattern in the response. The - # response consists of a token_field and a resources_field. The - # token_field is the name of the field in the response containing the - # next page token. The resources_field is the name of the field in the - # response containing the list of resources belonging to the page. - # retry_codes_name - Specifies the configuration for retryable codes. The - # name must be defined in interfaces.retry_codes_def. - # retry_params_name - Specifies the configuration for retry/backoff - # parameters. The name must be defined in interfaces.retry_params_def. - # field_name_patterns - Maps the field name of the request type to - # entity_name of interfaces.collections. - # Specifies the string pattern that the field must follow. - # timeout_millis - Specifies the default timeout for a non-retrying call. If - # the call is retrying, refer to retry_params_name instead. methods: - name: SetAgent - flattening: - groups: - - parameters: - - agent - required_fields: - - agent retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - agent.parent: project - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - name: DeleteAgent - flattening: - groups: - - parameters: - - parent - required_fields: - - parent retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: project - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - - name: GetAgent - flattening: - groups: - - parameters: - - parent - required_fields: - - parent - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: project - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - name: SearchAgents - flattening: - groups: - - parameters: - - parent - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: agents retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: project - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - name: TrainAgent - flattening: - groups: - - parameters: - - parent - required_fields: - - parent retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: project - timeout_millis: 60000 - long_running: - # LINT.IfChange(train_agent_long_running_operation) - return_type: google.protobuf.Empty - metadata_type: google.protobuf.Struct - # LINT.ThenChange() - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - resource_name_treatment: STATIC_TYPES - name: ExportAgent - flattening: - groups: - - parameters: - - parent - required_fields: - - parent retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: project - timeout_millis: 60000 - long_running: - # LINT.IfChange(export_agent_long_running_operation) - return_type: google.cloud.dialogflow.v2.ExportAgentResponse - metadata_type: google.protobuf.Struct - # LINT.ThenChange() - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - resource_name_treatment: STATIC_TYPES - - name: ImportAgent - required_fields: - - parent - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: project - timeout_millis: 60000 - long_running: - # LINT.IfChange(import_agent_long_running_operation) - return_type: google.protobuf.Empty - metadata_type: google.protobuf.Struct - # LINT.ThenChange() - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - resource_name_treatment: STATIC_TYPES - name: RestoreAgent - - required_fields: - - parent retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: project - timeout_millis: 60000 - long_running: - # LINT.IfChange(restore_agent_long_running_operation) - return_type: google.protobuf.Empty - metadata_type: google.protobuf.Struct - # LINT.ThenChange() - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - resource_name_treatment: STATIC_TYPES - # The fully qualified name of the API interface. - name: google.cloud.dialogflow.v2.Contexts - # A list of resource collection configurations. - # Consists of a name_pattern and an entity_name. - # The name_pattern is a pattern to describe the names of the resources of this - # collection, using the platform's conventions for URI patterns. A generator - # may use this to generate methods to compose and decompose such names. The - # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; - # those will be taken as hints for the parameter names of the generated - # methods. If empty, no name methods are generated. - # The entity_name is the name to be used as a basis for generated methods and - # classes. - collections: - - name_pattern: projects/{project}/agent/sessions/{session} - entity_name: session - - name_pattern: projects/{project}/agent/sessions/{session}/contexts/{context} - entity_name: context - # Definition for retryable codes. - retry_codes_def: - - name: idempotent - retry_codes: - - UNAVAILABLE - - DEADLINE_EXCEEDED - - name: non_idempotent - retry_codes: [] - # Definition for retry/backoff parameters. - retry_params_def: - - name: default - initial_retry_delay_millis: 100 - retry_delay_multiplier: 1.3 - max_retry_delay_millis: 60000 - initial_rpc_timeout_millis: 20000 - rpc_timeout_multiplier: 1 - max_rpc_timeout_millis: 20000 - total_timeout_millis: 600000 - # A list of method configurations. - # Common properties: - # name - The simple name of the method. - # flattening - Specifies the configuration for parameter flattening. - # Describes the parameter groups for which a generator should produce - # method overloads which allow a client to directly pass request message - # fields as method parameters. This information may or may not be used, - # depending on the target language. - # Consists of groups, which each represent a list of parameters to be - # flattened. Each parameter listed must be a field of the request - # message. - # required_fields - Fields that are always required for a request to be - # valid. - # - # page_streaming - Specifies the configuration for paging. - # Describes information for generating a method which transforms a - # paging list RPC into a stream of resources. - # Consists of a request and a response. - # The request specifies request information of the list method. It - # defines which fields match the paging pattern in the request. The - # request consists of a page_size_field and a token_field. The - # page_size_field is the name of the optional field specifying the - # maximum number of elements to be returned in the response. The - # token_field is the name of the field in the request containing the - # page token. - # The response specifies response information of the list method. It - # defines which fields match the paging pattern in the response. The - # response consists of a token_field and a resources_field. The - # token_field is the name of the field in the response containing the - # next page token. The resources_field is the name of the field in the - # response containing the list of resources belonging to the page. - # retry_codes_name - Specifies the configuration for retryable codes. The - # name must be defined in interfaces.retry_codes_def. - # retry_params_name - Specifies the configuration for retry/backoff - # parameters. The name must be defined in interfaces.retry_params_def. - # field_name_patterns - Maps the field name of the request type to - # entity_name of interfaces.collections. - # Specifies the string pattern that the field must follow. - # timeout_millis - Specifies the default timeout for a non-retrying call. If - # the call is retrying, refer to retry_params_name instead. methods: - - name: ListContexts - flattening: - groups: - - parameters: - - parent - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: contexts - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: session - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - - name: GetContext - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: context - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - - name: CreateContext - flattening: - groups: - - parameters: - - parent - - context - required_fields: - - parent - - context - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: session - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - - name: UpdateContext - flattening: - groups: - - parameters: - - context - required_fields: - - context - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - context.name: context - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - name: DeleteContext - flattening: - groups: - - parameters: - - name - required_fields: - - name retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: context - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - name: DeleteAllContexts - flattening: - groups: - - parameters: - - parent - required_fields: - - parent retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: session - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - # The fully qualified name of the API interface. - name: google.cloud.dialogflow.v2.EntityTypes - # A list of resource collection configurations. - # Consists of a name_pattern and an entity_name. - # The name_pattern is a pattern to describe the names of the resources of this - # collection, using the platform's conventions for URI patterns. A generator - # may use this to generate methods to compose and decompose such names. The - # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; - # those will be taken as hints for the parameter names of the generated - # methods. If empty, no name methods are generated. - # The entity_name is the name to be used as a basis for generated methods and - # classes. - collections: - - name_pattern: projects/{project}/agent - entity_name: project_agent - - name_pattern: projects/{project}/agent/entityTypes/{entity_type} - entity_name: entity_type - # Definition for retryable codes. - retry_codes_def: - - name: idempotent - retry_codes: - - UNAVAILABLE - - DEADLINE_EXCEEDED - - name: non_idempotent - retry_codes: [] - # Definition for retry/backoff parameters. - retry_params_def: - - name: default - initial_retry_delay_millis: 100 - retry_delay_multiplier: 1.3 - max_retry_delay_millis: 60000 - initial_rpc_timeout_millis: 20000 - rpc_timeout_multiplier: 1 - max_rpc_timeout_millis: 20000 - total_timeout_millis: 600000 - # A list of method configurations. - # Common properties: - # name - The simple name of the method. - # flattening - Specifies the configuration for parameter flattening. - # Describes the parameter groups for which a generator should produce - # method overloads which allow a client to directly pass request message - # fields as method parameters. This information may or may not be used, - # depending on the target language. - # Consists of groups, which each represent a list of parameters to be - # flattened. Each parameter listed must be a field of the request - # message. - # required_fields - Fields that are always required for a request to be - # valid. - # - # page_streaming - Specifies the configuration for paging. - # Describes information for generating a method which transforms a - # paging list RPC into a stream of resources. - # Consists of a request and a response. - # The request specifies request information of the list method. It - # defines which fields match the paging pattern in the request. The - # request consists of a page_size_field and a token_field. The - # page_size_field is the name of the optional field specifying the - # maximum number of elements to be returned in the response. The - # token_field is the name of the field in the request containing the - # page token. - # The response specifies response information of the list method. It - # defines which fields match the paging pattern in the response. The - # response consists of a token_field and a resources_field. The - # token_field is the name of the field in the response containing the - # next page token. The resources_field is the name of the field in the - # response containing the list of resources belonging to the page. - # retry_codes_name - Specifies the configuration for retryable codes. The - # name must be defined in interfaces.retry_codes_def. - # retry_params_name - Specifies the configuration for retry/backoff - # parameters. The name must be defined in interfaces.retry_params_def. - # field_name_patterns - Maps the field name of the request type to - # entity_name of interfaces.collections. - # Specifies the string pattern that the field must follow. - # timeout_millis - Specifies the default timeout for a non-retrying call. If - # the call is retrying, refer to retry_params_name instead. methods: - - name: ListEntityTypes - flattening: - groups: - - parameters: - - parent - - parameters: - - parent - - language_code - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: entity_types - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: project_agent - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - - name: GetEntityType - flattening: - groups: - - parameters: - - name - - parameters: - - name - - language_code - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: entity_type - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - - name: CreateEntityType - flattening: - groups: - - parameters: - - parent - - entity_type - - parameters: - - parent - - entity_type - - language_code - required_fields: - - parent - - entity_type - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: project_agent - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - - name: UpdateEntityType - flattening: - groups: - - parameters: - - entity_type - - parameters: - - entity_type - - language_code - required_fields: - - entity_type - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - entity_type.name: entity_type - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - name: DeleteEntityType - flattening: - groups: - - parameters: - - name - required_fields: - - name retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: entity_type - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - - name: BatchUpdateEntityTypes - required_fields: - - parent - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: project_agent - timeout_millis: 60000 - long_running: - # LINT.IfChange(batch_update_entity_types_long_running_operation) - return_type: google.cloud.dialogflow.v2.BatchUpdateEntityTypesResponse - metadata_type: google.protobuf.Struct - # LINT.ThenChange() - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - resource_name_treatment: STATIC_TYPES - name: BatchDeleteEntityTypes - flattening: - groups: - - parameters: - - parent - - entity_type_names - required_fields: - - parent - - entity_type_names retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: project_agent - timeout_millis: 60000 - long_running: - # LINT.IfChange(batch_delete_entity_types_long_running_operation) - return_type: google.protobuf.Empty - metadata_type: google.protobuf.Struct - # LINT.ThenChange() - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - resource_name_treatment: STATIC_TYPES - - name: BatchCreateEntities - flattening: - groups: - - parameters: - - parent - - entities - - parameters: - - parent - - entities - - language_code - required_fields: - - parent - - entities - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: entity_type - timeout_millis: 60000 - long_running: - # LINT.IfChange(batch_create_entities_long_running_operation) - return_type: google.protobuf.Empty - metadata_type: google.protobuf.Struct - # LINT.ThenChange() - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - resource_name_treatment: STATIC_TYPES - - name: BatchUpdateEntities - flattening: - groups: - - parameters: - - parent - - entities - - parameters: - - parent - - entities - - language_code - required_fields: - - parent - - entities - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: entity_type - timeout_millis: 60000 - long_running: - # LINT.IfChange(batch_update_entities_long_running_operation) - return_type: google.protobuf.Empty - metadata_type: google.protobuf.Struct - # LINT.ThenChange() - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - resource_name_treatment: STATIC_TYPES - name: BatchDeleteEntities - flattening: - groups: - - parameters: - - parent - - entity_values - - parameters: - - parent - - entity_values - - language_code - required_fields: - - parent - - entity_values retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: entity_type - timeout_millis: 60000 - long_running: - # LINT.IfChange(batch_delete_entities_long_running_operation) - return_type: google.protobuf.Empty - metadata_type: google.protobuf.Struct - # LINT.ThenChange() - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - resource_name_treatment: STATIC_TYPES - # The fully qualified name of the API interface. -- name: google.cloud.dialogflow.v2.Intents - # A list of resource collection configurations. - # Consists of a name_pattern and an entity_name. - # The name_pattern is a pattern to describe the names of the resources of this - # collection, using the platform's conventions for URI patterns. A generator - # may use this to generate methods to compose and decompose such names. The - # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; - # those will be taken as hints for the parameter names of the generated - # methods. If empty, no name methods are generated. - # The entity_name is the name to be used as a basis for generated methods and - # classes. - collections: - - name_pattern: projects/{project}/agent - entity_name: project_agent - - name_pattern: projects/{project}/agent/intents/{intent} - entity_name: intent - - name_pattern: projects/{project}/agents/{agent} - entity_name: agent - # Definition for retryable codes. +- name: google.cloud.dialogflow.v2.Environments retry_codes_def: - name: idempotent retry_codes: - UNAVAILABLE - - DEADLINE_EXCEEDED - - name: non_idempotent - retry_codes: [] - # Definition for retry/backoff parameters. - retry_params_def: - - name: default - initial_retry_delay_millis: 100 - retry_delay_multiplier: 1.3 - max_retry_delay_millis: 60000 - initial_rpc_timeout_millis: 20000 - rpc_timeout_multiplier: 1 - max_rpc_timeout_millis: 20000 - total_timeout_millis: 600000 - # A list of method configurations. - # Common properties: - # name - The simple name of the method. - # flattening - Specifies the configuration for parameter flattening. - # Describes the parameter groups for which a generator should produce - # method overloads which allow a client to directly pass request message - # fields as method parameters. This information may or may not be used, - # depending on the target language. - # Consists of groups, which each represent a list of parameters to be - # flattened. Each parameter listed must be a field of the request - # message. - # required_fields - Fields that are always required for a request to be - # valid. - # - # page_streaming - Specifies the configuration for paging. - # Describes information for generating a method which transforms a - # paging list RPC into a stream of resources. - # Consists of a request and a response. - # The request specifies request information of the list method. It - # defines which fields match the paging pattern in the request. The - # request consists of a page_size_field and a token_field. The - # page_size_field is the name of the optional field specifying the - # maximum number of elements to be returned in the response. The - # token_field is the name of the field in the request containing the - # page token. - # The response specifies response information of the list method. It - # defines which fields match the paging pattern in the response. The - # response consists of a token_field and a resources_field. The - # token_field is the name of the field in the response containing the - # next page token. The resources_field is the name of the field in the - # response containing the list of resources belonging to the page. - # retry_codes_name - Specifies the configuration for retryable codes. The - # name must be defined in interfaces.retry_codes_def. - # retry_params_name - Specifies the configuration for retry/backoff - # parameters. The name must be defined in interfaces.retry_params_def. - # field_name_patterns - Maps the field name of the request type to - # entity_name of interfaces.collections. - # Specifies the string pattern that the field must follow. - # timeout_millis - Specifies the default timeout for a non-retrying call. If - # the call is retrying, refer to retry_params_name instead. + - INTERNAL +- name: google.cloud.dialogflow.v2.Intents methods: - - name: ListIntents - flattening: - groups: - - parameters: - - parent - - parameters: - - parent - - language_code - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: intents - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: project_agent - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - - name: GetIntent - flattening: - groups: - - parameters: - - name - - parameters: - - name - - language_code - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: intent - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - - name: CreateIntent - flattening: - groups: - - parameters: - - parent - - intent - - parameters: - - parent - - intent - - language_code - required_fields: - - parent - - intent - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: project_agent - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - - name: UpdateIntent - flattening: - groups: - - parameters: - - intent - - language_code - - parameters: - - intent - - language_code - - update_mask - required_fields: - - intent - - language_code - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - intent.name: intent - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - name: DeleteIntent - flattening: - groups: - - parameters: - - name - required_fields: - - name retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: intent - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - - name: BatchUpdateIntents - required_fields: - - parent - - language_code - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: project_agent - timeout_millis: 60000 - long_running: - # LINT.IfChange(batch_update_intents_long_running_operation) - return_type: google.cloud.dialogflow.v2.BatchUpdateIntentsResponse - metadata_type: google.protobuf.Struct - # LINT.ThenChange() - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - resource_name_treatment: STATIC_TYPES - name: BatchDeleteIntents - flattening: - groups: - - parameters: - - parent - - intents - required_fields: - - parent - - intents retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: project_agent - timeout_millis: 60000 - long_running: - # LINT.IfChange(batch_delete_intents_long_running_operation) - return_type: google.protobuf.Empty - metadata_type: google.protobuf.Struct - # LINT.ThenChange() - initial_poll_delay_millis: 500 - poll_delay_multiplier: 1.5 - max_poll_delay_millis: 5000 - total_poll_timeout_millis: 300000 - resource_name_treatment: STATIC_TYPES - # The fully qualified name of the API interface. - name: google.cloud.dialogflow.v2.SessionEntityTypes - # A list of resource collection configurations. - # Consists of a name_pattern and an entity_name. - # The name_pattern is a pattern to describe the names of the resources of this - # collection, using the platform's conventions for URI patterns. A generator - # may use this to generate methods to compose and decompose such names. The - # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; - # those will be taken as hints for the parameter names of the generated - # methods. If empty, no name methods are generated. - # The entity_name is the name to be used as a basis for generated methods and - # classes. - collections: - - name_pattern: projects/{project}/agent/sessions/{session} - entity_name: session - - name_pattern: projects/{project}/agent/sessions/{session}/entityTypes/{entity_type} - entity_name: session_entity_type - # Definition for retryable codes. - retry_codes_def: - - name: idempotent - retry_codes: - - UNAVAILABLE - - DEADLINE_EXCEEDED - - name: non_idempotent - retry_codes: [] - # Definition for retry/backoff parameters. - retry_params_def: - - name: default - initial_retry_delay_millis: 100 - retry_delay_multiplier: 1.3 - max_retry_delay_millis: 60000 - initial_rpc_timeout_millis: 20000 - rpc_timeout_multiplier: 1 - max_rpc_timeout_millis: 20000 - total_timeout_millis: 600000 - # A list of method configurations. - # Common properties: - # name - The simple name of the method. - # flattening - Specifies the configuration for parameter flattening. - # Describes the parameter groups for which a generator should produce - # method overloads which allow a client to directly pass request message - # fields as method parameters. This information may or may not be used, - # depending on the target language. - # Consists of groups, which each represent a list of parameters to be - # flattened. Each parameter listed must be a field of the request - # message. - # required_fields - Fields that are always required for a request to be - # valid. - # - # page_streaming - Specifies the configuration for paging. - # Describes information for generating a method which transforms a - # paging list RPC into a stream of resources. - # Consists of a request and a response. - # The request specifies request information of the list method. It - # defines which fields match the paging pattern in the request. The - # request consists of a page_size_field and a token_field. The - # page_size_field is the name of the optional field specifying the - # maximum number of elements to be returned in the response. The - # token_field is the name of the field in the request containing the - # page token. - # The response specifies response information of the list method. It - # defines which fields match the paging pattern in the response. The - # response consists of a token_field and a resources_field. The - # token_field is the name of the field in the response containing the - # next page token. The resources_field is the name of the field in the - # response containing the list of resources belonging to the page. - # retry_codes_name - Specifies the configuration for retryable codes. The - # name must be defined in interfaces.retry_codes_def. - # retry_params_name - Specifies the configuration for retry/backoff - # parameters. The name must be defined in interfaces.retry_params_def. - # field_name_patterns - Maps the field name of the request type to - # entity_name of interfaces.collections. - # Specifies the string pattern that the field must follow. - # timeout_millis - Specifies the default timeout for a non-retrying call. If - # the call is retrying, refer to retry_params_name instead. methods: - - name: ListSessionEntityTypes - flattening: - groups: - - parameters: - - parent - required_fields: - - parent - page_streaming: - request: - page_size_field: page_size - token_field: page_token - response: - token_field: next_page_token - resources_field: session_entity_types - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - parent: session - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - - name: GetSessionEntityType - flattening: - groups: - - parameters: - - name - required_fields: - - name - retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: session_entity_type - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - - name: CreateSessionEntityType - flattening: - groups: - - parameters: - - parent - - session_entity_type - required_fields: - - parent - - session_entity_type - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - parent: session - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - - name: UpdateSessionEntityType - flattening: - groups: - - parameters: - - session_entity_type - required_fields: - - session_entity_type - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - session_entity_type.name: session_entity_type - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - name: DeleteSessionEntityType - flattening: - groups: - - parameters: - - name - required_fields: - - name retry_codes_name: idempotent - retry_params_name: default - field_name_patterns: - name: session_entity_type - timeout_millis: 60000 - resource_name_treatment: STATIC_TYPES - # The fully qualified name of the API interface. -- name: google.cloud.dialogflow.v2.Sessions - # A list of resource collection configurations. - # Consists of a name_pattern and an entity_name. - # The name_pattern is a pattern to describe the names of the resources of this - # collection, using the platform's conventions for URI patterns. A generator - # may use this to generate methods to compose and decompose such names. The - # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`; - # those will be taken as hints for the parameter names of the generated - # methods. If empty, no name methods are generated. - # The entity_name is the name to be used as a basis for generated methods and - # classes. - collections: - - name_pattern: projects/{project}/agent/sessions/{session} - entity_name: session - # Definition for retryable codes. - retry_codes_def: - - name: idempotent - retry_codes: - - UNAVAILABLE - - DEADLINE_EXCEEDED - - name: non_idempotent - retry_codes: [] - # Definition for retry/backoff parameters. - retry_params_def: - - name: default - initial_retry_delay_millis: 100 - retry_delay_multiplier: 1.3 - max_retry_delay_millis: 60000 - initial_rpc_timeout_millis: 20000 - rpc_timeout_multiplier: 1 - max_rpc_timeout_millis: 20000 - total_timeout_millis: 600000 - # A list of method configurations. - # Common properties: - # name - The simple name of the method. - # flattening - Specifies the configuration for parameter flattening. - # Describes the parameter groups for which a generator should produce - # method overloads which allow a client to directly pass request message - # fields as method parameters. This information may or may not be used, - # depending on the target language. - # Consists of groups, which each represent a list of parameters to be - # flattened. Each parameter listed must be a field of the request - # message. - # required_fields - Fields that are always required for a request to be - # valid. - # - # page_streaming - Specifies the configuration for paging. - # Describes information for generating a method which transforms a - # paging list RPC into a stream of resources. - # Consists of a request and a response. - # The request specifies request information of the list method. It - # defines which fields match the paging pattern in the request. The - # request consists of a page_size_field and a token_field. The - # page_size_field is the name of the optional field specifying the - # maximum number of elements to be returned in the response. The - # token_field is the name of the field in the request containing the - # page token. - # The response specifies response information of the list method. It - # defines which fields match the paging pattern in the response. The - # response consists of a token_field and a resources_field. The - # token_field is the name of the field in the response containing the - # next page token. The resources_field is the name of the field in the - # response containing the list of resources belonging to the page. - # retry_codes_name - Specifies the configuration for retryable codes. The - # name must be defined in interfaces.retry_codes_def. - # retry_params_name - Specifies the configuration for retry/backoff - # parameters. The name must be defined in interfaces.retry_params_def. - # field_name_patterns - Maps the field name of the request type to - # entity_name of interfaces.collections. - # Specifies the string pattern that the field must follow. - # timeout_millis - Specifies the default timeout for a non-retrying call. If - # the call is retrying, refer to retry_params_name instead. - methods: - - name: DetectIntent - flattening: - groups: - - parameters: - - session - - query_input - required_fields: - - session - - query_input - retry_codes_name: non_idempotent - retry_params_name: default - field_name_patterns: - session: session - timeout_millis: 220000 - resource_name_treatment: STATIC_TYPES - - name: StreamingDetectIntent - required_fields: - - session - - query_input - retry_codes_name: non_idempotent - retry_params_name: default - timeout_millis: 220000 -resource_name_generation: -- message_name: SetAgentRequest - field_entity_map: - agent.parent: project -- message_name: DeleteAgentRequest - field_entity_map: - parent: project -- message_name: GetAgentRequest - field_entity_map: - parent: project -- message_name: SearchAgentsRequest - field_entity_map: - parent: project -- message_name: TrainAgentRequest - field_entity_map: - parent: project -- message_name: ExportAgentRequest - field_entity_map: - parent: project -- message_name: ImportAgentRequest - field_entity_map: - parent: project -- message_name: RestoreAgentRequest - field_entity_map: - parent: project -- message_name: ListContextsRequest - field_entity_map: - parent: session -- message_name: GetContextRequest - field_entity_map: - name: context -- message_name: CreateContextRequest - field_entity_map: - parent: session -- message_name: Context - field_entity_map: - name: context -- message_name: DeleteContextRequest - field_entity_map: - name: context -- message_name: DeleteAllContextsRequest - field_entity_map: - parent: session -- message_name: ListEntityTypesRequest - field_entity_map: - parent: project_agent -- message_name: GetEntityTypeRequest - field_entity_map: - name: entity_type -- message_name: CreateEntityTypeRequest - field_entity_map: - parent: project_agent -- message_name: EntityType - field_entity_map: - name: entity_type -- message_name: DeleteEntityTypeRequest - field_entity_map: - name: entity_type -- message_name: BatchUpdateEntityTypesRequest - field_entity_map: - parent: project_agent -- message_name: BatchDeleteEntityTypesRequest - field_entity_map: - parent: project_agent -- message_name: BatchCreateEntitiesRequest - field_entity_map: - parent: entity_type -- message_name: BatchUpdateEntitiesRequest - field_entity_map: - parent: entity_type -- message_name: BatchDeleteEntitiesRequest - field_entity_map: - parent: entity_type -- message_name: ListIntentsRequest - field_entity_map: - parent: project_agent -- message_name: GetIntentRequest - field_entity_map: - name: intent -- message_name: CreateIntentRequest - field_entity_map: - parent: project_agent -- message_name: Intent - field_entity_map: - name: intent -- message_name: DeleteIntentRequest - field_entity_map: - name: intent -- message_name: BatchUpdateIntentsRequest - field_entity_map: - parent: project_agent -- message_name: BatchDeleteIntentsRequest - field_entity_map: - parent: project_agent -- message_name: ListSessionEntityTypesRequest - field_entity_map: - parent: session -- message_name: GetSessionEntityTypeRequest - field_entity_map: - name: session_entity_type -- message_name: CreateSessionEntityTypeRequest - field_entity_map: - parent: session -- message_name: SessionEntityType - field_entity_map: - name: session_entity_type -- message_name: DeleteSessionEntityTypeRequest - field_entity_map: - name: session_entity_type -- message_name: DetectIntentRequest - field_entity_map: - session: session diff --git a/third_party/googleapis/google/cloud/dialogflow/v2/dialogflow_grpc_service_config.json b/third_party/googleapis/google/cloud/dialogflow/v2/dialogflow_grpc_service_config.json new file mode 100755 index 000000000..10cc1d83a --- /dev/null +++ b/third_party/googleapis/google/cloud/dialogflow/v2/dialogflow_grpc_service_config.json @@ -0,0 +1,580 @@ +{ + "methodConfig": [ + { + "name": [ + { + "service": "google.cloud.dialogflow.v2.EntityTypes", + "method": "ListEntityTypes" + }, + { + "service": "google.cloud.dialogflow.v2.EntityTypes", + "method": "GetEntityType" + }, + { + "service": "google.cloud.dialogflow.v2.EntityTypes", + "method": "DeleteEntityType" + }, + { + "service": "google.cloud.dialogflow.v2.EntityTypes", + "method": "BatchDeleteEntityTypes" + }, + { + "service": "google.cloud.dialogflow.v2.EntityTypes", + "method": "BatchDeleteEntities" + } + ], + "timeout": "60s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dialogflow.v2.Intents", + "method": "ListIntents" + }, + { + "service": "google.cloud.dialogflow.v2.Intents", + "method": "GetIntent" + }, + { + "service": "google.cloud.dialogflow.v2.Intents", + "method": "DeleteIntent" + }, + { + "service": "google.cloud.dialogflow.v2.Intents", + "method": "BatchDeleteIntents" + } + ], + "timeout": "60s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dialogflow.v2.SessionEntityTypes", + "method": "ListSessionEntityTypes" + }, + { + "service": "google.cloud.dialogflow.v2.SessionEntityTypes", + "method": "GetSessionEntityType" + }, + { + "service": "google.cloud.dialogflow.v2.SessionEntityTypes", + "method": "DeleteSessionEntityType" + } + ], + "timeout": "60s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dialogflow.v2.SessionEntityTypes", + "method": "CreateSessionEntityType" + }, + { + "service": "google.cloud.dialogflow.v2.SessionEntityTypes", + "method": "UpdateSessionEntityType" + } + ], + "timeout": "60s" + }, + { + "name": [ + { + "service": "google.cloud.dialogflow.v2.Sessions", + "method": "DetectIntent" + }, + { + "service": "google.cloud.dialogflow.v2.Sessions", + "method": "StreamingDetectIntent" + } + ], + "timeout": "220s" + }, + { + "name": [ + { + "service": "google.cloud.dialogflow.v2.Contexts", + "method": "ListContexts" + }, + { + "service": "google.cloud.dialogflow.v2.Contexts", + "method": "GetContext" + }, + { + "service": "google.cloud.dialogflow.v2.Contexts", + "method": "DeleteContext" + }, + { + "service": "google.cloud.dialogflow.v2.Contexts", + "method": "DeleteAllContexts" + } + ], + "timeout": "60s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dialogflow.v2.Contexts", + "method": "CreateContext" + }, + { + "service": "google.cloud.dialogflow.v2.Contexts", + "method": "UpdateContext" + } + ], + "timeout": "60s" + }, + { + "name": [ + { + "service": "google.cloud.dialogflow.v2.EntityTypes", + "method": "CreateEntityType" + }, + { + "service": "google.cloud.dialogflow.v2.EntityTypes", + "method": "UpdateEntityType" + }, + { + "service": "google.cloud.dialogflow.v2.EntityTypes", + "method": "BatchUpdateEntityTypes" + }, + { + "service": "google.cloud.dialogflow.v2.EntityTypes", + "method": "BatchCreateEntities" + }, + { + "service": "google.cloud.dialogflow.v2.EntityTypes", + "method": "BatchUpdateEntities" + } + ], + "timeout": "60s" + }, + { + "name": [ + { + "service": "google.cloud.dialogflow.v2.Intents", + "method": "CreateIntent" + }, + { + "service": "google.cloud.dialogflow.v2.Intents", + "method": "UpdateIntent" + }, + { + "service": "google.cloud.dialogflow.v2.Intents", + "method": "BatchUpdateIntents" + } + ], + "timeout": "60s" + }, + { + "name": [ + { + "service": "google.cloud.dialogflow.v2.Agents", + "method": "SetAgent" + }, + { + "service": "google.cloud.dialogflow.v2.Agents", + "method": "DeleteAgent" + }, + { + "service": "google.cloud.dialogflow.v2.Agents", + "method": "GetAgent" + }, + { + "service": "google.cloud.dialogflow.v2.Agents", + "method": "SearchAgents" + }, + { + "service": "google.cloud.dialogflow.v2.Agents", + "method": "TrainAgent" + }, + { + "service": "google.cloud.dialogflow.v2.Agents", + "method": "ExportAgent" + }, + { + "service": "google.cloud.dialogflow.v2.Agents", + "method": "RestoreAgent" + } + ], + "timeout": "60s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dialogflow.v2.Agents", + "method": "ImportAgent" + } + ], + "timeout": "60s" + }, + { + "name": [ + { + "service": "google.cloud.dialogflow.v2.AnswerRecords", + "method": "ListAnswerRecords" + }, + { + "service": "google.cloud.dialogflow.v2.AnswerRecords", + "method": "UpdateAnswerRecord" + }, + { + "service": "google.cloud.dialogflow.v2.AnswerRecords", + "method": "DeleteAnswerRecord" + } + ], + "timeout": "60s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dialogflow.v2.Conversations", + "method": "CreateConversation" + }, + { + "service": "google.cloud.dialogflow.v2.Conversations", + "method": "ListConversations" + }, + { + "service": "google.cloud.dialogflow.v2.Conversations", + "method": "GetConversation" + }, + { + "service": "google.cloud.dialogflow.v2.Conversations", + "method": "AddConversationPhoneNumber" + }, + { + "service": "google.cloud.dialogflow.v2.Conversations", + "method": "CompleteConversation" + }, + { + "service": "google.cloud.dialogflow.v2.Conversations", + "method": "CreateCallMatcher" + }, + { + "service": "google.cloud.dialogflow.v2.Conversations", + "method": "ListCallMatchers" + }, + { + "service": "google.cloud.dialogflow.v2.Conversations", + "method": "ListCallMatchers" + }, + { + "service": "google.cloud.dialogflow.v2.Conversations", + "method": "ListMessages" + } + ], + "timeout": "60s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dialogflow.v2.ConversationProfiles", + "method": "ListConversationProfiles" + }, + { + "service": "google.cloud.dialogflow.v2.ConversationProfiles", + "method": "GetConversationProfile" + }, + { + "service": "google.cloud.dialogflow.v2.ConversationProfiles", + "method": "CreateConversationProfile" + }, + { + "service": "google.cloud.dialogflow.v2.ConversationProfiles", + "method": "UpdateConversationProfile" + }, + { + "service": "google.cloud.dialogflow.v2.ConversationProfiles", + "method": "DeleteConversationProfile" + } + ], + "timeout": "60s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dialogflow.v2.Documents", + "method": "ListDocuments" + }, + { + "service": "google.cloud.dialogflow.v2.Documents", + "method": "GetDocument" + }, + { + "service": "google.cloud.dialogflow.v2.Documents", + "method": "CreateDocument" + }, + { + "service": "google.cloud.dialogflow.v2.Documents", + "method": "DeleteDocument" + }, + { + "service": "google.cloud.dialogflow.v2.Documents", + "method": "UpdateDocument" + }, + { + "service": "google.cloud.dialogflow.v2.Documents", + "method": "ReloadDocument" + } + ], + "timeout": "60s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dialogflow.v2.KnowledgeBases", + "method": "ListKnowledgeBases" + }, + { + "service": "google.cloud.dialogflow.v2.KnowledgeBases", + "method": "GetKnowledgeBase" + }, + { + "service": "google.cloud.dialogflow.v2.KnowledgeBases", + "method": "CreateKnowledgeBase" + }, + { + "service": "google.cloud.dialogflow.v2.KnowledgeBases", + "method": "DeleteKnowledgeBase" + }, + { + "service": "google.cloud.dialogflow.v2.KnowledgeBases", + "method": "UpdateKnowledgeBase" + } + ], + "timeout": "60s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dialogflow.v2.PhoneNumbers", + "method": "ListPhoneNumbers" + }, + { + "service": "google.cloud.dialogflow.v2.PhoneNumbers", + "method": "UpdatePhoneNumber" + }, + { + "service": "google.cloud.dialogflow.v2.PhoneNumbers", + "method": "DeletePhoneNumber" + }, + { + "service": "google.cloud.dialogflow.v2.PhoneNumbers", + "method": "UndeletePhoneNumber" + } + ], + "timeout": "60s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dialogflow.v2.PhoneNumberOrders", + "method": "CreatePhoneNumberOrder" + }, + { + "service": "google.cloud.dialogflow.v2.PhoneNumberOrders", + "method": "GetPhoneNumberOrder" + }, + { + "service": "google.cloud.dialogflow.v2.PhoneNumberOrders", + "method": "ListPhoneNumberOrders" + }, + { + "service": "google.cloud.dialogflow.v2.PhoneNumberOrders", + "method": "UpdatePhoneNumberOrder" + }, + { + "service": "google.cloud.dialogflow.v2.PhoneNumberOrders", + "method": "CancelPhoneNumberOrder" + } + ], + "timeout": "60s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dialogflow.v2.Participants", + "method": "CreateParticipant" + }, + { + "service": "google.cloud.dialogflow.v2.Participants", + "method": "GetParticipant" + }, + { + "service": "google.cloud.dialogflow.v2.Participants", + "method": "ListParticipants" + }, + { + "service": "google.cloud.dialogflow.v2.Participants", + "method": "UpdateParticipant" + }, + { + "service": "google.cloud.dialogflow.v2.Participants", + "method": "AnalyzeContent" + }, + { + "service": "google.cloud.dialogflow.v2.Participants", + "method": "SuggestArticles" + }, + { + "service": "google.cloud.dialogflow.v2.Participants", + "method": "SuggestFaqAnswers" + } + ], + "timeout": "60s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dialogflow.v2.Participants", + "method": "StreamingAnalyzeContent" + } + ], + "timeout": "1800s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE", + "DEADLINE_EXCEEDED" + ] + } + }, + { + "name": [ + { + "service": "google.cloud.dialogflow.v2.Environments", + "method": "ListEnvironments" + } + ], + "timeout": "60s", + "retryPolicy": { + "initialBackoff": "0.100s", + "maxBackoff": "60s", + "backoffMultiplier": 1.3, + "retryableStatusCodes": [ + "UNAVAILABLE", + "INTERNAL" + ] + } + } + ] +} diff --git a/third_party/googleapis/google/cloud/dialogflow/dialogflow_v2.yaml b/third_party/googleapis/google/cloud/dialogflow/v2/dialogflow_v2.yaml similarity index 59% rename from third_party/googleapis/google/cloud/dialogflow/dialogflow_v2.yaml rename to third_party/googleapis/google/cloud/dialogflow/v2/dialogflow_v2.yaml index 2efbd3fef..a8d105e43 100644 --- a/third_party/googleapis/google/cloud/dialogflow/dialogflow_v2.yaml +++ b/third_party/googleapis/google/cloud/dialogflow/v2/dialogflow_v2.yaml @@ -7,6 +7,7 @@ apis: - name: google.cloud.dialogflow.v2.Agents - name: google.cloud.dialogflow.v2.Contexts - name: google.cloud.dialogflow.v2.EntityTypes +- name: google.cloud.dialogflow.v2.Environments - name: google.cloud.dialogflow.v2.Intents - name: google.cloud.dialogflow.v2.SessionEntityTypes - name: google.cloud.dialogflow.v2.Sessions @@ -24,46 +25,20 @@ documentation: Builds conversational interfaces (for example, chatbots, and voice-powered apps and devices). overview: |- - [Dialogflow](http://dialogflow.com/) is a natural language - understanding platform that makes it easy for you to design and integrate - a conversational user interface into your mobile app, web application, - device, bot, and so on. Using Dialogflow you can provide users new and - engaging ways to interact with your product using both voice recognition - and text input. + Dialogflow is + a natural language understanding platform that makes it easy + to design and integrate a conversational user interface into your mobile + app, web application, device, bot, interactive voice response system, and + so on. Using Dialogflow, you can provide new and engaging ways for + users to interact with your product. - For information on how Dialogflow agents, intents, entities, and so on - work, see the [Dialogflow getting - started - guide](https://dialogflow.com/docs/getting-started/basics) in the - dialogflow.com documentation. + Dialogflow can analyze multiple types of input from your customers, + including text or audio inputs (like from a phone or voice recording). + It can also respond to your customers in a couple of ways, either through + text or with synthetic speech. - ## Dialogflow Editions - - Dialogflow is available in two editions: Standard and Enterprise. For - information on the difference in Dialogflow editions, see [Dialogflow - Editions](https://cloud.google.com/dialogflow-enterprise/docs/editions). - - ## The Dialogflow API - - The Dialogflow API provides a REST and gRPC API that you can use to - incorporate the Dialogflow into your product. After you have created a - Google Cloud project and a Dialogflow agent, you can use the API to create - intents, entities, and so on, and then pass user input to your Dialogflow - agent to determine user intent using - the - [detectIntent](https://cloud.google.com/dialogflow-enterprise/docs/reference/rest/v2beta1/projects.agent.sessions/detectIntent) REST - API, or the - [StreamingDetectIntentRequest](https://cloud.google.com/dialogflow-enterprise/docs/reference/rpc/google.cloud.dialogflow.v2beta1#google.cloud.dialogflow.v2beta1.StreamingDetectIntentRequest) gRPC - API. - - ## Getting Started - - * For information on setting up a Google Cloud Platform project and - creating an agent using the Dialogflow Enterprise Edition, see - [Quickstart](https://cloud.google.com/dialogflow-enterprise/docs/quickstart). * - For information on creating an agent using the Dialogflow Standard - Edition, see [Building Your First - Agent](https://dialogflow.com/docs/getting-started/building-your-first-agent) + For more information, see the + [Dialogflow documentation](https://cloud.google.com/dialogflow/docs). backend: rules: @@ -73,14 +48,16 @@ backend: deadline: 60.0 - selector: 'google.cloud.dialogflow.v2.EntityTypes.*' deadline: 60.0 + - selector: google.cloud.dialogflow.v2.Environments.ListEnvironments + deadline: 60.0 - selector: 'google.cloud.dialogflow.v2.Intents.*' deadline: 60.0 - selector: 'google.cloud.dialogflow.v2.SessionEntityTypes.*' deadline: 60.0 - selector: google.cloud.dialogflow.v2.Sessions.DetectIntent - deadline: 230.0 + deadline: 220.0 - selector: google.cloud.dialogflow.v2.Sessions.StreamingDetectIntent - deadline: 230.0 + deadline: 220.0 - selector: 'google.longrunning.Operations.*' deadline: 60.0 @@ -101,6 +78,11 @@ authentication: canonical_scopes: |- https://www.googleapis.com/auth/cloud-platform, https://www.googleapis.com/auth/dialogflow + - selector: google.cloud.dialogflow.v2.Environments.ListEnvironments + oauth: + canonical_scopes: |- + https://www.googleapis.com/auth/cloud-platform, + https://www.googleapis.com/auth/dialogflow - selector: 'google.cloud.dialogflow.v2.Intents.*' oauth: canonical_scopes: |- diff --git a/third_party/googleapis/google/cloud/dialogflow/v2/entity_type.proto b/third_party/googleapis/google/cloud/dialogflow/v2/entity_type.proto index c694a0c2a..5c0273724 100644 --- a/third_party/googleapis/google/cloud/dialogflow/v2/entity_type.proto +++ b/third_party/googleapis/google/cloud/dialogflow/v2/entity_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,17 +11,18 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.dialogflow.v2; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/longrunning/operations.proto"; import "google/protobuf/empty.proto"; import "google/protobuf/field_mask.proto"; -import "google/api/client.proto"; option cc_enable_arenas = true; option csharp_namespace = "Google.Cloud.Dialogflow.V2"; @@ -45,11 +46,11 @@ option objc_class_prefix = "DF"; // data types such as date, time, currency, and so on. A system entity is // represented by the `EntityType` type. // -// * **Developer** - entities that are defined by you that represent +// * **Custom** - entities that are defined by you that represent // actionable data that is meaningful to your application. For example, // you could define a `pizza.sauce` entity for red or white pizza sauce, // a `pizza.cheese` entity for the different types of cheese on a pizza, -// a `pizza.topping` entity for different toppings, and so on. A developer +// a `pizza.topping` entity for different toppings, and so on. A custom // entity is represented by the `EntityType` type. // // * **User** - entities that are built for an individual user such as @@ -70,6 +71,8 @@ service EntityTypes { option (google.api.http) = { get: "/v2/{parent=projects/*/agent}/entityTypes" }; + option (google.api.method_signature) = "parent"; + option (google.api.method_signature) = "parent,language_code"; } // Retrieves the specified entity type. @@ -77,6 +80,8 @@ service EntityTypes { option (google.api.http) = { get: "/v2/{name=projects/*/agent/entityTypes/*}" }; + option (google.api.method_signature) = "name"; + option (google.api.method_signature) = "name,language_code"; } // Creates an entity type in the specified agent. @@ -85,6 +90,8 @@ service EntityTypes { post: "/v2/{parent=projects/*/agent}/entityTypes" body: "entity_type" }; + option (google.api.method_signature) = "parent,entity_type"; + option (google.api.method_signature) = "parent,entity_type,language_code"; } // Updates the specified entity type. @@ -93,6 +100,8 @@ service EntityTypes { patch: "/v2/{entity_type.name=projects/*/agent/entityTypes/*}" body: "entity_type" }; + option (google.api.method_signature) = "entity_type"; + option (google.api.method_signature) = "entity_type,language_code"; } // Deletes the specified entity type. @@ -100,6 +109,7 @@ service EntityTypes { option (google.api.http) = { delete: "/v2/{name=projects/*/agent/entityTypes/*}" }; + option (google.api.method_signature) = "name"; } // Updates/Creates multiple entity types in the specified agent. @@ -110,6 +120,10 @@ service EntityTypes { post: "/v2/{parent=projects/*/agent}/entityTypes:batchUpdate" body: "*" }; + option (google.longrunning.operation_info) = { + response_type: "google.cloud.dialogflow.v2.BatchUpdateEntityTypesResponse" + metadata_type: "google.protobuf.Struct" + }; } // Deletes entity types in the specified agent. @@ -120,6 +134,11 @@ service EntityTypes { post: "/v2/{parent=projects/*/agent}/entityTypes:batchDelete" body: "*" }; + option (google.api.method_signature) = "parent,entity_type_names"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "google.protobuf.Struct" + }; } // Creates multiple new entities in the specified entity type. @@ -130,28 +149,48 @@ service EntityTypes { post: "/v2/{parent=projects/*/agent/entityTypes/*}/entities:batchCreate" body: "*" }; + option (google.api.method_signature) = "parent,entities"; + option (google.api.method_signature) = "parent,entities,language_code"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "google.protobuf.Struct" + }; } // Updates or creates multiple entities in the specified entity type. This // method does not affect entities in the entity type that aren't explicitly // specified in the request. // + // // Operation rpc BatchUpdateEntities(BatchUpdateEntitiesRequest) returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v2/{parent=projects/*/agent/entityTypes/*}/entities:batchUpdate" body: "*" }; + option (google.api.method_signature) = "parent,entities"; + option (google.api.method_signature) = "parent,entities,language_code"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "google.protobuf.Struct" + }; } // Deletes entities in the specified entity type. // + // // Operation rpc BatchDeleteEntities(BatchDeleteEntitiesRequest) returns (google.longrunning.Operation) { option (google.api.http) = { post: "/v2/{parent=projects/*/agent/entityTypes/*}/entities:batchDelete" body: "*" }; + option (google.api.method_signature) = "parent,entity_values"; + option (google.api.method_signature) = "parent,entity_values,language_code"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "google.protobuf.Struct" + }; } } @@ -159,6 +198,11 @@ service EntityTypes { // Entity types serve as a tool for extracting parameter values from natural // language queries. message EntityType { + option (google.api.resource) = { + type: "dialogflow.googleapis.com/EntityType" + pattern: "projects/{project}/agent/entityTypes/{entity_type}" + }; + // An **entity entry** for an associated entity type. message Entity { // Required. The primary value associated with this entity entry. @@ -167,13 +211,13 @@ message EntityType { // // For `KIND_MAP` entity types: // - // * A canonical value to be used in place of synonyms. + // * A reference value to be used in place of synonyms. // // For `KIND_LIST` entity types: // // * A string that can contain references to other entity types (with or // without aliases). - string value = 1; + string value = 1 [(google.api.field_behavior) = REQUIRED]; // Required. A collection of value synonyms. For example, if the entity type // is *vegetable*, and `value` is *scallions*, a synonym could be *green @@ -182,7 +226,7 @@ message EntityType { // For `KIND_LIST` entity types: // // * This collection must contain exactly one synonym equal to `value`. - repeated string synonyms = 2; + repeated string synonyms = 2 [(google.api.field_behavior) = REQUIRED]; } // Represents kinds of entities. @@ -190,14 +234,18 @@ message EntityType { // Not specified. This value should be never used. KIND_UNSPECIFIED = 0; - // Map entity types allow mapping of a group of synonyms to a canonical + // Map entity types allow mapping of a group of synonyms to a reference // value. KIND_MAP = 1; - // List entity types contain a set of entries that do not map to canonical + // List entity types contain a set of entries that do not map to reference // values. However, list entity types can contain references to other entity // types (with or without aliases). KIND_LIST = 2; + + // Regexp entity types allow to specify regular expressions in entries + // values. + KIND_REGEXP = 3; } // Represents different entity type expansion modes. Automated expansion @@ -219,39 +267,46 @@ message EntityType { string name = 1; // Required. The name of the entity type. - string display_name = 2; + string display_name = 2 [(google.api.field_behavior) = REQUIRED]; // Required. Indicates the kind of entity type. - Kind kind = 3; + Kind kind = 3 [(google.api.field_behavior) = REQUIRED]; // Optional. Indicates whether the entity type can be automatically // expanded. - AutoExpansionMode auto_expansion_mode = 4; + AutoExpansionMode auto_expansion_mode = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. The collection of entity entries associated with the entity type. - repeated Entity entities = 6; + repeated Entity entities = 6 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Enables fuzzy entity extraction during classification. + bool enable_fuzzy_extraction = 7 [(google.api.field_behavior) = OPTIONAL]; } // The request message for [EntityTypes.ListEntityTypes][google.cloud.dialogflow.v2.EntityTypes.ListEntityTypes]. message ListEntityTypesRequest { // Required. The agent to list all entity types from. // Format: `projects//agent`. - string parent = 1; - - // Optional. The language to list entity synonyms for. If not specified, - // the agent's default language is used. - // [Many - // languages](https://cloud.google.com/dialogflow/docs/reference/language) - // are supported. Note: languages must be enabled in the agent before they can - // be used. - string language_code = 2; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dialogflow.googleapis.com/EntityType" + } + ]; + + // Optional. The language used to access language-specific data. + // If not specified, the agent's default language is used. + // For more information, see + // [Multilingual intent and entity + // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). + string language_code = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. The maximum number of items to return in a single page. By // default 100 and at most 1000. - int32 page_size = 3; + int32 page_size = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. The next_page_token value returned from a previous list request. - string page_token = 4; + string page_token = 4 [(google.api.field_behavior) = OPTIONAL]; } // The response message for [EntityTypes.ListEntityTypes][google.cloud.dialogflow.v2.EntityTypes.ListEntityTypes]. @@ -269,66 +324,83 @@ message ListEntityTypesResponse { message GetEntityTypeRequest { // Required. The name of the entity type. // Format: `projects//agent/entityTypes/`. - string name = 1; - - // Optional. The language to retrieve entity synonyms for. If not specified, - // the agent's default language is used. - // [Many - // languages](https://cloud.google.com/dialogflow/docs/reference/language) - // are supported. Note: languages must be enabled in the agent before they can - // be used. - string language_code = 2; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "dialogflow.googleapis.com/EntityType" + } + ]; + + // Optional. The language used to access language-specific data. + // If not specified, the agent's default language is used. + // For more information, see + // [Multilingual intent and entity + // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). + string language_code = 2 [(google.api.field_behavior) = OPTIONAL]; } // The request message for [EntityTypes.CreateEntityType][google.cloud.dialogflow.v2.EntityTypes.CreateEntityType]. message CreateEntityTypeRequest { // Required. The agent to create a entity type for. // Format: `projects//agent`. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dialogflow.googleapis.com/EntityType" + } + ]; // Required. The entity type to create. - EntityType entity_type = 2; - - // Optional. The language of entity synonyms defined in `entity_type`. If not - // specified, the agent's default language is used. - // [Many - // languages](https://cloud.google.com/dialogflow/docs/reference/language) - // are supported. Note: languages must be enabled in the agent before they can - // be used. - string language_code = 3; + EntityType entity_type = 2 [(google.api.field_behavior) = REQUIRED]; + + // Optional. The language used to access language-specific data. + // If not specified, the agent's default language is used. + // For more information, see + // [Multilingual intent and entity + // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). + string language_code = 3 [(google.api.field_behavior) = OPTIONAL]; } // The request message for [EntityTypes.UpdateEntityType][google.cloud.dialogflow.v2.EntityTypes.UpdateEntityType]. message UpdateEntityTypeRequest { // Required. The entity type to update. - EntityType entity_type = 1; + EntityType entity_type = 1 [(google.api.field_behavior) = REQUIRED]; - // Optional. The language of entity synonyms defined in `entity_type`. If not - // specified, the agent's default language is used. - // [Many - // languages](https://cloud.google.com/dialogflow/docs/reference/language) - // are supported. Note: languages must be enabled in the agent before they can - // be used. - string language_code = 2; + // Optional. The language used to access language-specific data. + // If not specified, the agent's default language is used. + // For more information, see + // [Multilingual intent and entity + // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). + string language_code = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. The mask to control which fields get updated. - google.protobuf.FieldMask update_mask = 3; + google.protobuf.FieldMask update_mask = 3 [(google.api.field_behavior) = OPTIONAL]; } // The request message for [EntityTypes.DeleteEntityType][google.cloud.dialogflow.v2.EntityTypes.DeleteEntityType]. message DeleteEntityTypeRequest { // Required. The name of the entity type to delete. // Format: `projects//agent/entityTypes/`. - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "dialogflow.googleapis.com/EntityType" + } + ]; } // The request message for [EntityTypes.BatchUpdateEntityTypes][google.cloud.dialogflow.v2.EntityTypes.BatchUpdateEntityTypes]. message BatchUpdateEntityTypesRequest { // Required. The name of the agent to update or create entity types in. // Format: `projects//agent`. - string parent = 1; - - // Required. The source of the entity type batch. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dialogflow.googleapis.com/EntityType" + } + ]; + + // The source of the entity type batch. // // For each entity type in the batch: // @@ -345,16 +417,15 @@ message BatchUpdateEntityTypesRequest { EntityTypeBatch entity_type_batch_inline = 3; } - // Optional. The language of entity synonyms defined in `entity_types`. If not - // specified, the agent's default language is used. - // [Many - // languages](https://cloud.google.com/dialogflow/docs/reference/language) - // are supported. Note: languages must be enabled in the agent before they can - // be used. - string language_code = 4; + // Optional. The language used to access language-specific data. + // If not specified, the agent's default language is used. + // For more information, see + // [Multilingual intent and entity + // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). + string language_code = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. The mask to control which fields get updated. - google.protobuf.FieldMask update_mask = 5; + google.protobuf.FieldMask update_mask = 5 [(google.api.field_behavior) = OPTIONAL]; } // The response message for [EntityTypes.BatchUpdateEntityTypes][google.cloud.dialogflow.v2.EntityTypes.BatchUpdateEntityTypes]. @@ -367,70 +438,87 @@ message BatchUpdateEntityTypesResponse { message BatchDeleteEntityTypesRequest { // Required. The name of the agent to delete all entities types for. Format: // `projects//agent`. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dialogflow.googleapis.com/EntityType" + } + ]; // Required. The names entity types to delete. All names must point to the // same agent as `parent`. - repeated string entity_type_names = 2; + repeated string entity_type_names = 2 [(google.api.field_behavior) = REQUIRED]; } // The request message for [EntityTypes.BatchCreateEntities][google.cloud.dialogflow.v2.EntityTypes.BatchCreateEntities]. message BatchCreateEntitiesRequest { // Required. The name of the entity type to create entities in. Format: // `projects//agent/entityTypes/`. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "dialogflow.googleapis.com/EntityType" + } + ]; // Required. The entities to create. - repeated EntityType.Entity entities = 2; - - // Optional. The language of entity synonyms defined in `entities`. If not - // specified, the agent's default language is used. - // [Many - // languages](https://cloud.google.com/dialogflow/docs/reference/language) - // are supported. Note: languages must be enabled in the agent before they can - // be used. - string language_code = 3; + repeated EntityType.Entity entities = 2 [(google.api.field_behavior) = REQUIRED]; + + // Optional. The language used to access language-specific data. + // If not specified, the agent's default language is used. + // For more information, see + // [Multilingual intent and entity + // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). + string language_code = 3 [(google.api.field_behavior) = OPTIONAL]; } // The request message for [EntityTypes.BatchUpdateEntities][google.cloud.dialogflow.v2.EntityTypes.BatchUpdateEntities]. message BatchUpdateEntitiesRequest { // Required. The name of the entity type to update or create entities in. // Format: `projects//agent/entityTypes/`. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "dialogflow.googleapis.com/EntityType" + } + ]; // Required. The entities to update or create. - repeated EntityType.Entity entities = 2; + repeated EntityType.Entity entities = 2 [(google.api.field_behavior) = REQUIRED]; - // Optional. The language of entity synonyms defined in `entities`. If not - // specified, the agent's default language is used. - // [Many - // languages](https://cloud.google.com/dialogflow/docs/reference/language) - // are supported. Note: languages must be enabled in the agent before they can - // be used. - string language_code = 3; + // Optional. The language used to access language-specific data. + // If not specified, the agent's default language is used. + // For more information, see + // [Multilingual intent and entity + // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). + string language_code = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. The mask to control which fields get updated. - google.protobuf.FieldMask update_mask = 4; + google.protobuf.FieldMask update_mask = 4 [(google.api.field_behavior) = OPTIONAL]; } // The request message for [EntityTypes.BatchDeleteEntities][google.cloud.dialogflow.v2.EntityTypes.BatchDeleteEntities]. message BatchDeleteEntitiesRequest { // Required. The name of the entity type to delete entries for. Format: // `projects//agent/entityTypes/`. - string parent = 1; - - // Required. The canonical `values` of the entities to delete. Note that + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "dialogflow.googleapis.com/EntityType" + } + ]; + + // Required. The reference `values` of the entities to delete. Note that // these are not fully-qualified names, i.e. they don't start with // `projects/`. - repeated string entity_values = 2; - - // Optional. The language of entity synonyms defined in `entities`. If not - // specified, the agent's default language is used. - // [Many - // languages](https://cloud.google.com/dialogflow/docs/reference/language) - // are supported. Note: languages must be enabled in the agent before they can - // be used. - string language_code = 3; + repeated string entity_values = 2 [(google.api.field_behavior) = REQUIRED]; + + // Optional. The language used to access language-specific data. + // If not specified, the agent's default language is used. + // For more information, see + // [Multilingual intent and entity + // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). + string language_code = 3 [(google.api.field_behavior) = OPTIONAL]; } // This message is a wrapper around a collection of entity types. diff --git a/third_party/googleapis/google/cloud/dialogflow/v2/environment.proto b/third_party/googleapis/google/cloud/dialogflow/v2/environment.proto new file mode 100644 index 000000000..5bb7413f6 --- /dev/null +++ b/third_party/googleapis/google/cloud/dialogflow/v2/environment.proto @@ -0,0 +1,126 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.dialogflow.v2; + +import "google/api/annotations.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; +import "google/protobuf/empty.proto"; +import "google/protobuf/field_mask.proto"; +import "google/protobuf/timestamp.proto"; +import "google/api/client.proto"; + +option cc_enable_arenas = true; +option csharp_namespace = "Google.Cloud.Dialogflow.V2"; +option go_package = "google.golang.org/genproto/googleapis/cloud/dialogflow/v2;dialogflow"; +option java_multiple_files = true; +option java_outer_classname = "EnvironmentProto"; +option java_package = "com.google.cloud.dialogflow.v2"; +option objc_class_prefix = "DF"; + +// Manages agent environments. +service Environments { + option (google.api.default_host) = "dialogflow.googleapis.com"; + option (google.api.oauth_scopes) = + "https://www.googleapis.com/auth/cloud-platform," + "https://www.googleapis.com/auth/dialogflow"; + + // Returns the list of all non-draft environments of the specified agent. + rpc ListEnvironments(ListEnvironmentsRequest) returns (ListEnvironmentsResponse) { + option (google.api.http) = { + get: "/v2/{parent=projects/*/agent}/environments" + }; + } +} + +// Represents an agent environment. +message Environment { + option (google.api.resource) = { + type: "dialogflow.googleapis.com/Environment" + pattern: "projects/{project}/agent/environments/{environment}" + }; + + // Represents an environment state. When an environment is pointed to a new + // agent version, the environment is temporarily set to the `LOADING` state. + // During that time, the environment keeps on serving the previous version of + // the agent. After the new agent version is done loading, the environment is + // set back to the `RUNNING` state. + enum State { + // Not specified. This value is not used. + STATE_UNSPECIFIED = 0; + + // Stopped. + STOPPED = 1; + + // Loading. + LOADING = 2; + + // Running. + RUNNING = 3; + } + + // Output only. The unique identifier of this agent environment. + // Format: `projects//agent/environments/`. + // For Environment ID, "-" is reserved for 'draft' environment. + string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Optional. The developer-provided description for this environment. + // The maximum length is 500 characters. If exceeded, the request is rejected. + string description = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The agent version loaded into this environment. + // Format: `projects//agent/versions/`. + string agent_version = 3 [(google.api.field_behavior) = OPTIONAL]; + + // Output only. The state of this environment. This field is read-only, i.e., it cannot be + // set by create and update methods. + State state = 4 [(google.api.field_behavior) = OUTPUT_ONLY]; + + // Output only. The last update time of this environment. This field is read-only, i.e., it + // cannot be set by create and update methods. + google.protobuf.Timestamp update_time = 5 [(google.api.field_behavior) = OUTPUT_ONLY]; +} + +// The request message for [Environments.ListEnvironments][google.cloud.dialogflow.v2.Environments.ListEnvironments]. +message ListEnvironmentsRequest { + // Required. The agent to list all environments from. + // Format: `projects//agent`. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dialogflow.googleapis.com/Environment" + } + ]; + + // Optional. The maximum number of items to return in a single page. By default 100 and + // at most 1000. + int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. The next_page_token value returned from a previous list request. + string page_token = 3 [(google.api.field_behavior) = OPTIONAL]; +} + +// The response message for [Environments.ListEnvironments][google.cloud.dialogflow.v2.Environments.ListEnvironments]. +message ListEnvironmentsResponse { + // The list of agent environments. There will be a maximum number of items + // returned based on the page_size field in the request. + repeated Environment environments = 1; + + // Token to retrieve the next page of results, or empty if there are no + // more results in the list. + string next_page_token = 2; +} diff --git a/third_party/googleapis/google/cloud/dialogflow/v2/intent.proto b/third_party/googleapis/google/cloud/dialogflow/v2/intent.proto index 6cdcd73ec..6a176c35c 100644 --- a/third_party/googleapis/google/cloud/dialogflow/v2/intent.proto +++ b/third_party/googleapis/google/cloud/dialogflow/v2/intent.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,13 +11,15 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.dialogflow.v2; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/cloud/dialogflow/v2/audio_config.proto"; import "google/cloud/dialogflow/v2/context.proto"; import "google/longrunning/operations.proto"; @@ -25,7 +27,6 @@ import "google/protobuf/duration.proto"; import "google/protobuf/empty.proto"; import "google/protobuf/field_mask.proto"; import "google/protobuf/struct.proto"; -import "google/api/client.proto"; option cc_enable_arenas = true; option csharp_namespace = "Google.Cloud.Dialogflow.V2"; @@ -78,6 +79,8 @@ service Intents { option (google.api.http) = { get: "/v2/{parent=projects/*/agent}/intents" }; + option (google.api.method_signature) = "parent"; + option (google.api.method_signature) = "parent,language_code"; } // Retrieves the specified intent. @@ -85,6 +88,8 @@ service Intents { option (google.api.http) = { get: "/v2/{name=projects/*/agent/intents/*}" }; + option (google.api.method_signature) = "name"; + option (google.api.method_signature) = "name,language_code"; } // Creates an intent in the specified agent. @@ -93,6 +98,8 @@ service Intents { post: "/v2/{parent=projects/*/agent}/intents" body: "intent" }; + option (google.api.method_signature) = "parent,intent"; + option (google.api.method_signature) = "parent,intent,language_code"; } // Updates the specified intent. @@ -101,6 +108,8 @@ service Intents { patch: "/v2/{intent.name=projects/*/agent/intents/*}" body: "intent" }; + option (google.api.method_signature) = "intent,language_code"; + option (google.api.method_signature) = "intent,language_code,update_mask"; } // Deletes the specified intent and its direct or indirect followup intents. @@ -108,6 +117,7 @@ service Intents { option (google.api.http) = { delete: "/v2/{name=projects/*/agent/intents/*}" }; + option (google.api.method_signature) = "name"; } // Updates/Creates multiple intents in the specified agent. @@ -118,6 +128,12 @@ service Intents { post: "/v2/{parent=projects/*/agent}/intents:batchUpdate" body: "*" }; + option (google.api.method_signature) = "parent,intent_batch_uri"; + option (google.api.method_signature) = "parent,intent_batch_inline"; + option (google.longrunning.operation_info) = { + response_type: "google.cloud.dialogflow.v2.BatchUpdateIntentsResponse" + metadata_type: "google.protobuf.Struct" + }; } // Deletes intents in the specified agent. @@ -128,6 +144,11 @@ service Intents { post: "/v2/{parent=projects/*/agent}/intents:batchDelete" body: "*" }; + option (google.api.method_signature) = "parent,intents"; + option (google.longrunning.operation_info) = { + response_type: "google.protobuf.Empty" + metadata_type: "google.protobuf.Struct" + }; } } @@ -135,6 +156,11 @@ service Intents { // Intents convert a number of user expressions or patterns into an action. An // action is an extraction of a user command or sentence semantics. message Intent { + option (google.api.resource) = { + type: "dialogflow.googleapis.com/Intent" + pattern: "projects/{project}/agent/intents/{intent}" + }; + // Represents an example that the agent is trained on. message TrainingPhrase { // Represents a part of a training phrase. @@ -144,18 +170,18 @@ message Intent { // Optional. The entity type name prefixed with `@`. // This field is required for annotated parts of the training phrase. - string entity_type = 2; + string entity_type = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. The parameter name for the value extracted from the // annotated part of the example. // This field is required for annotated parts of the training phrase. - string alias = 3; + string alias = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. Indicates whether the text was manually annotated. // This field is set to true when the Dialogflow Console is used to // manually annotate the part. When creating an annotated part with the // API, you must set this to true. - bool user_defined = 4; + bool user_defined = 4 [(google.api.field_behavior) = OPTIONAL]; } // Represents different types of training phrases. @@ -180,7 +206,7 @@ message Intent { string name = 1; // Required. The type of the training phrase. - Type type = 2; + Type type = 2 [(google.api.field_behavior) = REQUIRED]; // Required. The ordered list of training phrase parts. // The parts are concatenated in order to form the training phrase. @@ -201,12 +227,12 @@ message Intent { // - `Part.text` is set to a part of the phrase that you want to annotate, // and the `entity_type`, `alias`, and `user_defined` fields are all // set. - repeated Part parts = 3; + repeated Part parts = 3 [(google.api.field_behavior) = REQUIRED]; // Optional. Indicates how many times this example was added to // the intent. Each time a developer adds an existing sample by editing an // intent or training, this counter is increased. - int32 times_added_count = 4; + int32 times_added_count = 4 [(google.api.field_behavior) = OPTIONAL]; } // Represents intent parameters. @@ -218,87 +244,92 @@ message Intent { string display_name = 2; // Optional. The definition of the parameter value. It can be: + // // - a constant string, // - a parameter value defined as `$parameter_name`, // - an original parameter value defined as `$parameter_name.original`, // - a parameter value from some context defined as // `#context_name.parameter_name`. - string value = 3; + string value = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. The default value to use when the `value` yields an empty // result. // Default values can be extracted from contexts by using the following // syntax: `#context_name.parameter_name`. - string default_value = 4; + string default_value = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. The name of the entity type, prefixed with `@`, that // describes values of the parameter. If the parameter is // required, this must be provided. - string entity_type_display_name = 5; + string entity_type_display_name = 5 [(google.api.field_behavior) = OPTIONAL]; // Optional. Indicates whether the parameter is required. That is, // whether the intent cannot be completed without collecting the parameter // value. - bool mandatory = 6; + bool mandatory = 6 [(google.api.field_behavior) = OPTIONAL]; // Optional. The collection of prompts that the agent can present to the // user in order to collect a value for the parameter. - repeated string prompts = 7; + repeated string prompts = 7 [(google.api.field_behavior) = OPTIONAL]; // Optional. Indicates whether the parameter represents a list of values. - bool is_list = 8; + bool is_list = 8 [(google.api.field_behavior) = OPTIONAL]; } - // Corresponds to the `Response` field in the Dialogflow console. + // A rich response message. + // Corresponds to the intent `Response` field in the Dialogflow console. + // For more information, see + // [Rich response + // messages](https://cloud.google.com/dialogflow/docs/intents-rich-messages). message Message { // The text response message. message Text { // Optional. The collection of the agent's responses. - repeated string text = 1; + repeated string text = 1 [(google.api.field_behavior) = OPTIONAL]; } // The image response message. message Image { // Optional. The public URI to an image file. - string image_uri = 1; + string image_uri = 1 [(google.api.field_behavior) = OPTIONAL]; // Optional. A text description of the image to be used for accessibility, // e.g., screen readers. - string accessibility_text = 2; + string accessibility_text = 2 [(google.api.field_behavior) = OPTIONAL]; } // The quick replies response message. message QuickReplies { // Optional. The title of the collection of quick replies. - string title = 1; + string title = 1 [(google.api.field_behavior) = OPTIONAL]; // Optional. The collection of quick replies. - repeated string quick_replies = 2; + repeated string quick_replies = 2 [(google.api.field_behavior) = OPTIONAL]; } // The card response message. message Card { - // Optional. Contains information about a button. + // Contains information about a button. message Button { // Optional. The text to show on the button. - string text = 1; + string text = 1 [(google.api.field_behavior) = OPTIONAL]; // Optional. The text to send back to the Dialogflow API or a URI to // open. - string postback = 2; + string postback = 2 [(google.api.field_behavior) = OPTIONAL]; } // Optional. The title of the card. - string title = 1; + string title = 1 [(google.api.field_behavior) = OPTIONAL]; // Optional. The subtitle of the card. - string subtitle = 2; + string subtitle = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. The public URI to an image file for the card. - string image_uri = 3; + string image_uri = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. The collection of card buttons. - repeated Button buttons = 4; + repeated Button buttons = 4 [(google.api.field_behavior) = OPTIONAL]; } // The simple response message containing speech or text. @@ -313,7 +344,7 @@ message Intent { string ssml = 2; // Optional. The text to display. - string display_text = 3; + string display_text = 3 [(google.api.field_behavior) = OPTIONAL]; } // The collection of simple response candidates. @@ -322,7 +353,7 @@ message Intent { // `SimpleResponse`. message SimpleResponses { // Required. The list of simple responses. - repeated SimpleResponse simple_responses = 1; + repeated SimpleResponse simple_responses = 1 [(google.api.field_behavior) = REQUIRED]; } // The basic card message. Useful for displaying information. @@ -339,47 +370,47 @@ message Intent { string title = 1; // Required. Action to take when a user taps on the button. - OpenUriAction open_uri_action = 2; + OpenUriAction open_uri_action = 2 [(google.api.field_behavior) = REQUIRED]; } // Optional. The title of the card. - string title = 1; + string title = 1 [(google.api.field_behavior) = OPTIONAL]; // Optional. The subtitle of the card. - string subtitle = 2; + string subtitle = 2 [(google.api.field_behavior) = OPTIONAL]; // Required, unless image is present. The body text of the card. string formatted_text = 3; // Optional. The image for the card. - Image image = 4; + Image image = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. The collection of card buttons. - repeated Button buttons = 5; + repeated Button buttons = 5 [(google.api.field_behavior) = OPTIONAL]; } // The suggestion chip message that the user can tap to quickly post a reply // to the conversation. message Suggestion { // Required. The text shown the in the suggestion chip. - string title = 1; + string title = 1 [(google.api.field_behavior) = REQUIRED]; } // The collection of suggestions. message Suggestions { // Required. The list of suggested replies. - repeated Suggestion suggestions = 1; + repeated Suggestion suggestions = 1 [(google.api.field_behavior) = REQUIRED]; } // The suggestion chip message that allows the user to jump out to the app // or website associated with this agent. message LinkOutSuggestion { // Required. The name of the app or site this chip is linking to. - string destination_name = 1; + string destination_name = 1 [(google.api.field_behavior) = REQUIRED]; // Required. The URI of the app or site to open when the user taps the // suggestion chip. - string uri = 2; + string uri = 2 [(google.api.field_behavior) = REQUIRED]; } // The card for presenting a list of options to select from. @@ -387,23 +418,26 @@ message Intent { // An item in the list. message Item { // Required. Additional information about this option. - SelectItemInfo info = 1; + SelectItemInfo info = 1 [(google.api.field_behavior) = REQUIRED]; // Required. The title of the list item. - string title = 2; + string title = 2 [(google.api.field_behavior) = REQUIRED]; // Optional. The main text describing the item. - string description = 3; + string description = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. The image to display. - Image image = 4; + Image image = 4 [(google.api.field_behavior) = OPTIONAL]; } // Optional. The overall title of the list. - string title = 1; + string title = 1 [(google.api.field_behavior) = OPTIONAL]; // Required. List items. - repeated Item items = 2; + repeated Item items = 2 [(google.api.field_behavior) = REQUIRED]; + + // Optional. Subtitle of the list. + string subtitle = 3 [(google.api.field_behavior) = OPTIONAL]; } // The card for presenting a carousel of options to select from. @@ -411,20 +445,20 @@ message Intent { // An item in the carousel. message Item { // Required. Additional info about the option item. - SelectItemInfo info = 1; + SelectItemInfo info = 1 [(google.api.field_behavior) = REQUIRED]; // Required. Title of the carousel item. - string title = 2; + string title = 2 [(google.api.field_behavior) = REQUIRED]; // Optional. The body text of the card. - string description = 3; + string description = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. The image to display. - Image image = 4; + Image image = 4 [(google.api.field_behavior) = OPTIONAL]; } // Required. Carousel items. - repeated Item items = 1; + repeated Item items = 1 [(google.api.field_behavior) = REQUIRED]; } // Additional info about the select item for when it is triggered in a @@ -432,16 +466,200 @@ message Intent { message SelectItemInfo { // Required. A unique key that will be sent back to the agent if this // response is given. - string key = 1; + string key = 1 [(google.api.field_behavior) = REQUIRED]; // Optional. A list of synonyms that can also be used to trigger this // item in dialog. - repeated string synonyms = 2; + repeated string synonyms = 2 [(google.api.field_behavior) = OPTIONAL]; } - // Represents different platforms that a rich message can be intended for. + // The media content card for Actions on Google. + message MediaContent { + // Response media object for media content card. + message ResponseMediaObject { + // Required. Name of media card. + string name = 1; + + // Optional. Description of media card. + string description = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Image to show with the media card. + oneof image { + // Optional. Image to display above media content. + Image large_image = 3 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Icon to display above media content. + Image icon = 4 [(google.api.field_behavior) = OPTIONAL]; + } + + // Required. Url where the media is stored. + string content_url = 5; + } + + // Format of response media type. + enum ResponseMediaType { + // Unspecified. + RESPONSE_MEDIA_TYPE_UNSPECIFIED = 0; + + // Response media type is audio. + AUDIO = 1; + } + + // Optional. What type of media is the content (ie "audio"). + ResponseMediaType media_type = 1 [(google.api.field_behavior) = OPTIONAL]; + + // Required. List of media objects. + repeated ResponseMediaObject media_objects = 2; + } + + // Browse Carousel Card for Actions on Google. + // https://developers.google.com/actions/assistant/responses#browsing_carousel + message BrowseCarouselCard { + // Browsing carousel tile + message BrowseCarouselCardItem { + // Actions on Google action to open a given url. + message OpenUrlAction { + // Type of the URI. + enum UrlTypeHint { + // Unspecified + URL_TYPE_HINT_UNSPECIFIED = 0; + + // Url would be an amp action + AMP_ACTION = 1; + + // URL that points directly to AMP content, or to a canonical URL + // which refers to AMP content via . + AMP_CONTENT = 2; + } + + // Required. URL + string url = 1; + + // Optional. Specifies the type of viewer that is used when opening + // the URL. Defaults to opening via web browser. + UrlTypeHint url_type_hint = 3 [(google.api.field_behavior) = OPTIONAL]; + } + + // Required. Action to present to the user. + OpenUrlAction open_uri_action = 1; + + // Required. Title of the carousel item. Maximum of two lines of text. + string title = 2; + + // Optional. Description of the carousel item. Maximum of four lines of + // text. + string description = 3 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Hero image for the carousel item. + Image image = 4 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Text that appears at the bottom of the Browse Carousel + // Card. Maximum of one line of text. + string footer = 5 [(google.api.field_behavior) = OPTIONAL]; + } + + // Image display options for Actions on Google. This should be used for + // when the image's aspect ratio does not match the image container's + // aspect ratio. + enum ImageDisplayOptions { + // Fill the gaps between the image and the image container with gray + // bars. + IMAGE_DISPLAY_OPTIONS_UNSPECIFIED = 0; + + // Fill the gaps between the image and the image container with gray + // bars. + GRAY = 1; + + // Fill the gaps between the image and the image container with white + // bars. + WHITE = 2; + + // Image is scaled such that the image width and height match or exceed + // the container dimensions. This may crop the top and bottom of the + // image if the scaled image height is greater than the container + // height, or crop the left and right of the image if the scaled image + // width is greater than the container width. This is similar to "Zoom + // Mode" on a widescreen TV when playing a 4:3 video. + CROPPED = 3; + + // Pad the gaps between image and image frame with a blurred copy of the + // same image. + BLURRED_BACKGROUND = 4; + } + + // Required. List of items in the Browse Carousel Card. Minimum of two + // items, maximum of ten. + repeated BrowseCarouselCardItem items = 1; + + // Optional. Settings for displaying the image. Applies to every image in + // [items][google.cloud.dialogflow.v2.Intent.Message.BrowseCarouselCard.items]. + ImageDisplayOptions image_display_options = 2 [(google.api.field_behavior) = OPTIONAL]; + } + + // Table card for Actions on Google. + message TableCard { + // Required. Title of the card. + string title = 1; + + // Optional. Subtitle to the title. + string subtitle = 2 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Image which should be displayed on the card. + Image image = 3 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Display properties for the columns in this table. + repeated ColumnProperties column_properties = 4 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Rows in this table of data. + repeated TableCardRow rows = 5 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. List of buttons for the card. + repeated BasicCard.Button buttons = 6 [(google.api.field_behavior) = OPTIONAL]; + } + + // Column properties for [TableCard][google.cloud.dialogflow.v2.Intent.Message.TableCard]. + message ColumnProperties { + // Text alignments within a cell. + enum HorizontalAlignment { + // Text is aligned to the leading edge of the column. + HORIZONTAL_ALIGNMENT_UNSPECIFIED = 0; + + // Text is aligned to the leading edge of the column. + LEADING = 1; + + // Text is centered in the column. + CENTER = 2; + + // Text is aligned to the trailing edge of the column. + TRAILING = 3; + } + + // Required. Column heading. + string header = 1; + + // Optional. Defines text alignment for all cells in this column. + HorizontalAlignment horizontal_alignment = 2 [(google.api.field_behavior) = OPTIONAL]; + } + + // Row of [TableCard][google.cloud.dialogflow.v2.Intent.Message.TableCard]. + message TableCardRow { + // Optional. List of cells that make up this row. + repeated TableCardCell cells = 1 [(google.api.field_behavior) = OPTIONAL]; + + // Optional. Whether to add a visual divider after this row. + bool divider_after = 2 [(google.api.field_behavior) = OPTIONAL]; + } + + // Cell of [TableCardRow][google.cloud.dialogflow.v2.Intent.Message.TableCardRow]. + message TableCardCell { + // Required. Text in this cell. + string text = 1; + } + + // The rich response message integration platform. See + // [Integrations](https://cloud.google.com/dialogflow/docs/integrations). enum Platform { - // Not specified. + // Default platform. PLATFORM_UNSPECIFIED = 0; // Facebook. @@ -465,67 +683,9 @@ message Intent { // Viber. VIBER = 7; - // Actions on Google. - // When using Actions on Google, you can choose one of the specific - // Intent.Message types that mention support for Actions on Google, - // or you can use the advanced Intent.Message.payload field. - // The payload field provides access to AoG features not available in the - // specific message types. - // If using the Intent.Message.payload field, it should have a structure - // similar to the JSON message shown here. For more information, see - // [Actions on Google Webhook - // Format](https://developers.google.com/actions/dialogflow/webhook) - // 
{
-      //   "expectUserResponse": true,
-      //   "isSsml": false,
-      //   "noInputPrompts": [],
-      //   "richResponse": {
-      //     "items": [
-      //       {
-      //         "simpleResponse": {
-      //           "displayText": "hi",
-      //           "textToSpeech": "hello"
-      //         }
-      //       }
-      //     ],
-      //     "suggestions": [
-      //       {
-      //         "title": "Say this"
-      //       },
-      //       {
-      //         "title": "or this"
-      //       }
-      //     ]
-      //   },
-      //   "systemIntent": {
-      //     "data": {
-      //       "@type": "type.googleapis.com/google.actions.v2.OptionValueSpec",
-      //       "listSelect": {
-      //         "items": [
-      //           {
-      //             "optionInfo": {
-      //               "key": "key1",
-      //               "synonyms": [
-      //                 "key one"
-      //               ]
-      //             },
-      //             "title": "must not be empty, but unique"
-      //           },
-      //           {
-      //             "optionInfo": {
-      //               "key": "key2",
-      //               "synonyms": [
-      //                 "key two"
-      //               ]
-      //             },
-      //             "title": "must not be empty, but unique"
-      //           }
-      //         ]
-      //       }
-      //     },
-      //     "intent": "actions.intent.OPTION"
-      //   }
-      // }
+ // Google Assistant + // See [Dialogflow webhook + // format](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json) ACTIONS_ON_GOOGLE = 8; // Google Hangouts. @@ -546,9 +706,7 @@ message Intent { // The card response. Card card = 4; - // Returns a response containing a custom, platform-specific payload. - // See the Intent.Message.Platform type for a description of the - // structure that may be required for your platform. + // A custom platform-specific response. google.protobuf.Struct payload = 5; // The voice and text-only responses for Actions on Google. @@ -568,10 +726,19 @@ message Intent { // The carousel card response for Actions on Google. CarouselSelect carousel_select = 12; + + // Browse carousel card for Actions on Google. + BrowseCarouselCard browse_carousel_card = 22; + + // Table card for Actions on Google. + TableCard table_card = 23; + + // The media content card for Actions on Google. + MediaContent media_content = 24; } // Optional. The platform that this message is intended for. - Platform platform = 6; + Platform platform = 6 [(google.api.field_behavior) = OPTIONAL]; } // Represents a single followup intent in the chain. @@ -598,73 +765,77 @@ message Intent { WEBHOOK_STATE_ENABLED_FOR_SLOT_FILLING = 2; } - // The unique identifier of this intent. + // Optional. The unique identifier of this intent. // Required for [Intents.UpdateIntent][google.cloud.dialogflow.v2.Intents.UpdateIntent] and [Intents.BatchUpdateIntents][google.cloud.dialogflow.v2.Intents.BatchUpdateIntents] // methods. // Format: `projects//agent/intents/`. - string name = 1; + string name = 1 [(google.api.field_behavior) = OPTIONAL]; // Required. The name of this intent. - string display_name = 2; + string display_name = 2 [(google.api.field_behavior) = REQUIRED]; // Optional. Indicates whether webhooks are enabled for the intent. - WebhookState webhook_state = 6; + WebhookState webhook_state = 6 [(google.api.field_behavior) = OPTIONAL]; // Optional. The priority of this intent. Higher numbers represent higher - // priorities. If this is zero or unspecified, we use the default - // priority 500000. + // priorities. // - // Negative numbers mean that the intent is disabled. - int32 priority = 3; + // - If the supplied value is unspecified or 0, the service + // translates the value to 500,000, which corresponds to the + // `Normal` priority in the console. + // - If the supplied value is negative, the intent is ignored + // in runtime detect intent requests. + int32 priority = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. Indicates whether this is a fallback intent. - bool is_fallback = 4; + bool is_fallback = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. Indicates whether Machine Learning is disabled for the intent. - // Note: If `ml_diabled` setting is set to true, then this intent is not + // Note: If `ml_disabled` setting is set to true, then this intent is not // taken into account during inference in `ML ONLY` match mode. Also, // auto-markup in the UI is turned off. - bool ml_disabled = 19; + bool ml_disabled = 19 [(google.api.field_behavior) = OPTIONAL]; // Optional. The list of context names required for this intent to be // triggered. // Format: `projects//agent/sessions/-/contexts/`. - repeated string input_context_names = 7; + repeated string input_context_names = 7 [(google.api.field_behavior) = OPTIONAL]; // Optional. The collection of event names that trigger the intent. // If the collection of input contexts is not empty, all of the contexts must // be present in the active user session for an event to trigger this intent. - repeated string events = 8; + // Event names are limited to 150 characters. + repeated string events = 8 [(google.api.field_behavior) = OPTIONAL]; // Optional. The collection of examples that the agent is // trained on. - repeated TrainingPhrase training_phrases = 9; + repeated TrainingPhrase training_phrases = 9 [(google.api.field_behavior) = OPTIONAL]; // Optional. The name of the action associated with the intent. // Note: The action name must not contain whitespaces. - string action = 10; + string action = 10 [(google.api.field_behavior) = OPTIONAL]; // Optional. The collection of contexts that are activated when the intent // is matched. Context messages in this collection should not set the // parameters field. Setting the `lifespan_count` to 0 will reset the context // when the intent is matched. // Format: `projects//agent/sessions/-/contexts/`. - repeated Context output_contexts = 11; + repeated Context output_contexts = 11 [(google.api.field_behavior) = OPTIONAL]; // Optional. Indicates whether to delete all contexts in the current // session when this intent is matched. - bool reset_contexts = 12; + bool reset_contexts = 12 [(google.api.field_behavior) = OPTIONAL]; // Optional. The collection of parameters associated with the intent. - repeated Parameter parameters = 13; + repeated Parameter parameters = 13 [(google.api.field_behavior) = OPTIONAL]; // Optional. The collection of rich messages corresponding to the // `Response` field in the Dialogflow console. - repeated Message messages = 14; + repeated Message messages = 14 [(google.api.field_behavior) = OPTIONAL]; // Optional. The list of platforms for which the first responses will be // copied from the messages in PLATFORM_UNSPECIFIED (i.e. default platform). - repeated Message.Platform default_response_platforms = 15; + repeated Message.Platform default_response_platforms = 15 [(google.api.field_behavior) = OPTIONAL]; // Read-only. The unique identifier of the root intent in the chain of // followup intents. It identifies the correct followup intents chain for @@ -675,8 +846,9 @@ message Intent { // Read-only after creation. The unique identifier of the parent intent in the // chain of followup intents. You can set this field when creating an intent, - // for example with [CreateIntent][] or [BatchUpdateIntents][], in order to - // make this intent a followup intent. + // for example with [CreateIntent][google.cloud.dialogflow.v2.Intents.CreateIntent] or + // [BatchUpdateIntents][google.cloud.dialogflow.v2.Intents.BatchUpdateIntents], in order to make this + // intent a followup intent. // // It identifies the parent followup intent. // Format: `projects//agent/intents/`. @@ -691,25 +863,29 @@ message Intent { message ListIntentsRequest { // Required. The agent to list all intents from. // Format: `projects//agent`. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dialogflow.googleapis.com/Intent" + } + ]; - // Optional. The language to list training phrases, parameters and rich - // messages for. If not specified, the agent's default language is used. - // [Many - // languages](https://cloud.google.com/dialogflow/docs/reference/language) - // are supported. Note: languages must be enabled in the agent before they can - // be used. - string language_code = 2; + // Optional. The language used to access language-specific data. + // If not specified, the agent's default language is used. + // For more information, see + // [Multilingual intent and entity + // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). + string language_code = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. The resource view to apply to the returned intent. - IntentView intent_view = 3; + IntentView intent_view = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. The maximum number of items to return in a single page. By // default 100 and at most 1000. - int32 page_size = 4; + int32 page_size = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. The next_page_token value returned from a previous list request. - string page_token = 5; + string page_token = 5 [(google.api.field_behavior) = OPTIONAL]; } // The response message for [Intents.ListIntents][google.cloud.dialogflow.v2.Intents.ListIntents]. @@ -727,59 +903,66 @@ message ListIntentsResponse { message GetIntentRequest { // Required. The name of the intent. // Format: `projects//agent/intents/`. - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "dialogflow.googleapis.com/Intent" + } + ]; - // Optional. The language to retrieve training phrases, parameters and rich - // messages for. If not specified, the agent's default language is used. - // [Many - // languages](https://cloud.google.com/dialogflow/docs/reference/language) - // are supported. Note: languages must be enabled in the agent before they can - // be used. - string language_code = 2; + // Optional. The language used to access language-specific data. + // If not specified, the agent's default language is used. + // For more information, see + // [Multilingual intent and entity + // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). + string language_code = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. The resource view to apply to the returned intent. - IntentView intent_view = 3; + IntentView intent_view = 3 [(google.api.field_behavior) = OPTIONAL]; } // The request message for [Intents.CreateIntent][google.cloud.dialogflow.v2.Intents.CreateIntent]. message CreateIntentRequest { // Required. The agent to create a intent for. // Format: `projects//agent`. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dialogflow.googleapis.com/Intent" + } + ]; // Required. The intent to create. - Intent intent = 2; + Intent intent = 2 [(google.api.field_behavior) = REQUIRED]; - // Optional. The language of training phrases, parameters and rich messages - // defined in `intent`. If not specified, the agent's default language is - // used. [Many - // languages](https://cloud.google.com/dialogflow/docs/reference/language) - // are supported. Note: languages must be enabled in the agent before they can - // be used. - string language_code = 3; + // Optional. The language used to access language-specific data. + // If not specified, the agent's default language is used. + // For more information, see + // [Multilingual intent and entity + // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). + string language_code = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. The resource view to apply to the returned intent. - IntentView intent_view = 4; + IntentView intent_view = 4 [(google.api.field_behavior) = OPTIONAL]; } // The request message for [Intents.UpdateIntent][google.cloud.dialogflow.v2.Intents.UpdateIntent]. message UpdateIntentRequest { // Required. The intent to update. - Intent intent = 1; + Intent intent = 1 [(google.api.field_behavior) = REQUIRED]; - // Optional. The language of training phrases, parameters and rich messages - // defined in `intent`. If not specified, the agent's default language is - // used. [Many - // languages](https://cloud.google.com/dialogflow/docs/reference/language) - // are supported. Note: languages must be enabled in the agent before they can - // be used. - string language_code = 2; + // Optional. The language used to access language-specific data. + // If not specified, the agent's default language is used. + // For more information, see + // [Multilingual intent and entity + // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). + string language_code = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. The mask to control which fields get updated. - google.protobuf.FieldMask update_mask = 3; + google.protobuf.FieldMask update_mask = 3 [(google.api.field_behavior) = OPTIONAL]; // Optional. The resource view to apply to the returned intent. - IntentView intent_view = 4; + IntentView intent_view = 4 [(google.api.field_behavior) = OPTIONAL]; } // The request message for [Intents.DeleteIntent][google.cloud.dialogflow.v2.Intents.DeleteIntent]. @@ -787,16 +970,25 @@ message DeleteIntentRequest { // Required. The name of the intent to delete. If this intent has direct or // indirect followup intents, we also delete them. // Format: `projects//agent/intents/`. - string name = 1; + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "dialogflow.googleapis.com/Intent" + } + ]; } -// The request message for [Intents.BatchUpdateIntents][google.cloud.dialogflow.v2.Intents.BatchUpdateIntents]. message BatchUpdateIntentsRequest { // Required. The name of the agent to update or create intents in. // Format: `projects//agent`. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dialogflow.googleapis.com/Intent" + } + ]; - // Required. The source of the intent batch. + // The source of the intent batch. oneof intent_batch { // The URI to a Google Cloud Storage file containing intents to update or // create. The file format can either be a serialized proto (of IntentBatch @@ -807,19 +999,18 @@ message BatchUpdateIntentsRequest { IntentBatch intent_batch_inline = 3; } - // Optional. The language of training phrases, parameters and rich messages - // defined in `intents`. If not specified, the agent's default language is - // used. [Many - // languages](https://cloud.google.com/dialogflow/docs/reference/language) - // are supported. Note: languages must be enabled in the agent before they can - // be used. - string language_code = 4; + // Optional. The language used to access language-specific data. + // If not specified, the agent's default language is used. + // For more information, see + // [Multilingual intent and entity + // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity). + string language_code = 4 [(google.api.field_behavior) = OPTIONAL]; // Optional. The mask to control which fields get updated. - google.protobuf.FieldMask update_mask = 5; + google.protobuf.FieldMask update_mask = 5 [(google.api.field_behavior) = OPTIONAL]; // Optional. The resource view to apply to the returned intent. - IntentView intent_view = 6; + IntentView intent_view = 6 [(google.api.field_behavior) = OPTIONAL]; } // The response message for [Intents.BatchUpdateIntents][google.cloud.dialogflow.v2.Intents.BatchUpdateIntents]. @@ -832,11 +1023,16 @@ message BatchUpdateIntentsResponse { message BatchDeleteIntentsRequest { // Required. The name of the agent to delete all entities types for. Format: // `projects//agent`. - string parent = 1; + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dialogflow.googleapis.com/Intent" + } + ]; // Required. The collection of intents to delete. Only intent `name` must be // filled in. - repeated Intent intents = 2; + repeated Intent intents = 2 [(google.api.field_behavior) = REQUIRED]; } // This message is a wrapper around a collection of intents. diff --git a/third_party/googleapis/google/cloud/dialogflow/v2/session.proto b/third_party/googleapis/google/cloud/dialogflow/v2/session.proto index 815b40878..9e3d9442d 100644 --- a/third_party/googleapis/google/cloud/dialogflow/v2/session.proto +++ b/third_party/googleapis/google/cloud/dialogflow/v2/session.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,22 +11,24 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.dialogflow.v2; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/cloud/dialogflow/v2/audio_config.proto"; import "google/cloud/dialogflow/v2/context.proto"; import "google/cloud/dialogflow/v2/intent.proto"; import "google/cloud/dialogflow/v2/session_entity_type.proto"; import "google/protobuf/duration.proto"; +import "google/protobuf/field_mask.proto"; import "google/protobuf/struct.proto"; import "google/rpc/status.proto"; import "google/type/latlng.proto"; -import "google/api/client.proto"; option cc_enable_arenas = true; option csharp_namespace = "Google.Cloud.Dialogflow.V2"; @@ -35,6 +37,11 @@ option java_multiple_files = true; option java_outer_classname = "SessionProto"; option java_package = "com.google.cloud.dialogflow.v2"; option objc_class_prefix = "DF"; +option (google.api.resource_definition) = { + type: "dialogflow.googleapis.com/Session" + pattern: "projects/{project}/agent/sessions/{session}" + pattern: "projects/{project}/agent/environments/{environment}/users/{user}/sessions/{session}" +}; // A session represents an interaction with a user. You retrieve user input // and pass it to the [DetectIntent][google.cloud.dialogflow.v2.Sessions.DetectIntent] (or @@ -54,7 +61,12 @@ service Sessions { option (google.api.http) = { post: "/v2/{session=projects/*/agent/sessions/*}:detectIntent" body: "*" + additional_bindings { + post: "/v2/{session=projects/*/agent/environments/*/users/*/sessions/*}:detectIntent" + body: "*" + } }; + option (google.api.method_signature) = "session,query_input"; } // Processes a natural language query in audio format in a streaming fashion @@ -67,13 +79,22 @@ service Sessions { // The request to detect user's intent. message DetectIntentRequest { // Required. The name of the session this query is sent to. Format: - // `projects//agent/sessions/`. It's up to the API - // caller to choose an appropriate session ID. It can be a random number or - // some type of user identifier (preferably hashed). The length of the session - // ID must not exceed 36 bytes. - string session = 1; - - // Optional. The parameters of this query. + // `projects//agent/sessions/`, or + // `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume + // default 'draft' environment. If `User ID` is not specified, we are using + // "-". It's up to the API caller to choose an appropriate `Session ID` and + // `User Id`. They can be a random number or some type of user and session + // identifiers (preferably hashed). The length of the `Session ID` and + // `User ID` must not exceed 36 characters. + string session = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "dialogflow.googleapis.com/Session" + } + ]; + + // The parameters of this query. QueryParameters query_params = 2; // Required. The input specification. It can be set to: @@ -84,14 +105,22 @@ message DetectIntentRequest { // 2. a conversational query in the form of text, or // // 3. an event that specifies which intent to trigger. - QueryInput query_input = 3; + QueryInput query_input = 3 [(google.api.field_behavior) = REQUIRED]; - // Optional. Instructs the speech synthesizer how to generate the output + // Instructs the speech synthesizer how to generate the output // audio. If this field is not set and agent-level speech synthesizer is not // configured, no output audio is generated. OutputAudioConfig output_audio_config = 4; - // Optional. The natural language speech audio to be processed. This field + // Mask for [output_audio_config][google.cloud.dialogflow.v2.DetectIntentRequest.output_audio_config] indicating which settings in this + // request-level config should override speech synthesizer settings defined at + // agent-level. + // + // If unspecified or empty, [output_audio_config][google.cloud.dialogflow.v2.DetectIntentRequest.output_audio_config] replaces the agent-level + // config in its entirety. + google.protobuf.FieldMask output_audio_config_mask = 7; + + // The natural language speech audio to be processed. This field // should be populated iff `query_input` is set to an input audio config. // A single request can contain up to 1 minute of speech audio data. bytes input_audio = 5; @@ -116,6 +145,10 @@ message DetectIntentResponse { // multiple default text responses exist, they will be concatenated when // generating audio. If no default platform text responses exist, the // generated audio content will be empty. + // + // In some scenarios, multiple output audio fields may be present in the + // response structure. In these cases, only the top-most-level audio output + // has content. bytes output_audio = 4; // The config used by the speech synthesizer to generate the output audio. @@ -124,33 +157,36 @@ message DetectIntentResponse { // Represents the parameters of the conversational query. message QueryParameters { - // Optional. The time zone of this conversational query from the + // The time zone of this conversational query from the // [time zone database](https://www.iana.org/time-zones), e.g., // America/New_York, Europe/Paris. If not provided, the time zone specified in // agent settings is used. string time_zone = 1; - // Optional. The geo location of this conversational query. + // The geo location of this conversational query. google.type.LatLng geo_location = 2; - // Optional. The collection of contexts to be activated before this query is + // The collection of contexts to be activated before this query is // executed. repeated Context contexts = 3; - // Optional. Specifies whether to delete all contexts in the current session + // Specifies whether to delete all contexts in the current session // before the new ones are activated. bool reset_contexts = 4; - // Optional. Additional session entity types to replace or extend developer + // Additional session entity types to replace or extend developer // entity types with. The entity synonyms apply to all languages and persist // for the session of this query. repeated SessionEntityType session_entity_types = 5; - // Optional. This field can be used to pass custom data into the webhook - // associated with the agent. Arbitrary JSON objects are supported. + // This field can be used to pass custom data to your webhook. + // Arbitrary JSON objects are supported. + // If supplied, the value is used to populate the + // `WebhookRequest.original_detect_intent_request.payload` + // field sent to your webhook. google.protobuf.Struct payload = 6; - // Optional. Configures the type of sentiment analysis to perform. If not + // Configures the type of sentiment analysis to perform. If not // provided, sentiment analysis is not performed. SentimentAnalysisRequestConfig sentiment_analysis_request_config = 10; } @@ -211,6 +247,20 @@ message QueryResult { string action = 3; // The collection of extracted parameters. + // + // Depending on your protocol or client library language, this is a + // map, associative array, symbol table, dictionary, or JSON object + // composed of a collection of (MapKey, MapValue) pairs: + // + // - MapKey type: string + // - MapKey value: parameter name + // - MapValue type: + // - If parameter's entity type is a composite entity: map + // - Else: string or number, depending on parameter value type + // - MapValue value: + // - If parameter's entity type is a composite entity: + // map from composite entity property names to property values + // - Else: parameter value google.protobuf.Struct parameters = 4; // This field is set to: @@ -244,7 +294,7 @@ message QueryResult { // The intent that matched the conversational query. Some, not // all fields are filled in this message, including but not limited to: - // `name`, `display_name` and `webhook_state`. + // `name`, `display_name`, `end_interaction` and `is_fallback`. Intent intent = 11; // The intent detection confidence. Values range from 0.0 @@ -257,9 +307,13 @@ message QueryResult { // the greatest `knowledgeAnswers.match_confidence` value in the list. float intent_detection_confidence = 12; - // The free-form diagnostic info. For example, this field could contain - // webhook call latency. The string keys of the Struct's fields map can change - // without notice. + // Free-form diagnostic information for the associated detect intent request. + // The fields of this data can change without notice, so you should not write + // code that depends on its structure. + // The data may contain: + // + // - webhook call latency + // - webhook errors google.protobuf.Struct diagnostic_info = 14; // The sentiment analysis result, which depends on the @@ -268,26 +322,54 @@ message QueryResult { } // The top-level message sent by the client to the -// `StreamingDetectIntent` method. +// [Sessions.StreamingDetectIntent][google.cloud.dialogflow.v2.Sessions.StreamingDetectIntent] method. // // Multiple request messages should be sent in order: // -// 1. The first message must contain `session`, `query_input` plus optionally -// `query_params`. The message must not contain `input_audio`. +// 1. The first message must contain +// [session][google.cloud.dialogflow.v2.StreamingDetectIntentRequest.session], +// [query_input][google.cloud.dialogflow.v2.StreamingDetectIntentRequest.query_input] plus optionally +// [query_params][google.cloud.dialogflow.v2.StreamingDetectIntentRequest.query_params]. If the client +// wants to receive an audio response, it should also contain +// [output_audio_config][google.cloud.dialogflow.v2.StreamingDetectIntentRequest.output_audio_config]. +// The message must not contain +// [input_audio][google.cloud.dialogflow.v2.StreamingDetectIntentRequest.input_audio]. +// 2. If [query_input][google.cloud.dialogflow.v2.StreamingDetectIntentRequest.query_input] was set to +// [query_input.audio_config][google.cloud.dialogflow.v2.InputAudioConfig], all subsequent +// messages must contain +// [input_audio][google.cloud.dialogflow.v2.StreamingDetectIntentRequest.input_audio] to continue with +// Speech recognition. +// If you decide to rather detect an intent from text input after you +// already started Speech recognition, please send a message with +// [query_input.text][google.cloud.dialogflow.v2.QueryInput.text]. // -// 2. If `query_input` was set to a streaming input audio config, -// all subsequent messages must contain only `input_audio`. -// Otherwise, finish the request stream. +// However, note that: +// +// * Dialogflow will bill you for the audio duration so far. +// * Dialogflow discards all Speech recognition results in favor of the +// input text. +// * Dialogflow will use the language code from the first message. +// +// After you sent all input, you must half-close or abort the request stream. message StreamingDetectIntentRequest { // Required. The name of the session the query is sent to. // Format of the session name: - // `projects//agent/sessions/`. It's up to the API - // caller to choose an appropriate `Session ID`. It can be a random number or - // some type of user identifier (preferably hashed). The length of the session - // ID must not exceed 36 characters. - string session = 1; - - // Optional. The parameters of this query. + // `projects//agent/sessions/`, or + // `projects//agent/environments//users//sessions/`. If `Environment ID` is not specified, we assume + // default 'draft' environment. If `User ID` is not specified, we are using + // "-". It's up to the API caller to choose an appropriate `Session ID` and + // `User Id`. They can be a random number or some type of user and session + // identifiers (preferably hashed). The length of the `Session ID` and + // `User ID` must not exceed 36 characters. + string session = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "dialogflow.googleapis.com/Session" + } + ]; + + // The parameters of this query. QueryParameters query_params = 2; // Required. The input specification. It can be set to: @@ -298,10 +380,10 @@ message StreamingDetectIntentRequest { // 2. a conversational query in the form of text, or // // 3. an event that specifies which intent to trigger. - QueryInput query_input = 3; + QueryInput query_input = 3 [(google.api.field_behavior) = REQUIRED]; - // DEPRECATED. Please use [InputAudioConfig.single_utterance][google.cloud.dialogflow.v2.InputAudioConfig.single_utterance] instead. - // Optional. If `false` (default), recognition does not cease until + // Please use [InputAudioConfig.single_utterance][google.cloud.dialogflow.v2.InputAudioConfig.single_utterance] instead. + // If `false` (default), recognition does not cease until // the client closes the stream. If `true`, the recognizer will detect a // single spoken utterance in input audio. Recognition ceases when it detects // the audio's voice has stopped or paused. In this case, once a detected @@ -310,12 +392,20 @@ message StreamingDetectIntentRequest { // This setting is ignored when `query_input` is a piece of text or an event. bool single_utterance = 4 [deprecated = true]; - // Optional. Instructs the speech synthesizer how to generate the output + // Instructs the speech synthesizer how to generate the output // audio. If this field is not set and agent-level speech synthesizer is not // configured, no output audio is generated. OutputAudioConfig output_audio_config = 5; - // Optional. The input audio content to be recognized. Must be sent if + // Mask for [output_audio_config][google.cloud.dialogflow.v2.StreamingDetectIntentRequest.output_audio_config] indicating which settings in this + // request-level config should override speech synthesizer settings defined at + // agent-level. + // + // If unspecified or empty, [output_audio_config][google.cloud.dialogflow.v2.StreamingDetectIntentRequest.output_audio_config] replaces the agent-level + // config in its entirety. + google.protobuf.FieldMask output_audio_config_mask = 7; + + // The input audio content to be recognized. Must be sent if // `query_input` was set to a streaming input audio config. The complete audio // over all streaming messages must not exceed 1 minute. bytes input_audio = 6; @@ -353,6 +443,10 @@ message StreamingDetectIntentResponse { // multiple default text responses exist, they will be concatenated when // generating audio. If no default platform text responses exist, the // generated audio content will be empty. + // + // In some scenarios, multiple output audio fields may be present in the + // response structure. In these cases, only the top-most-level audio output + // has content. bytes output_audio = 5; // The config used by the speech synthesizer to generate the output audio. @@ -432,19 +526,28 @@ message StreamingRecognitionResult { // This field is typically only provided if `is_final` is true and you should // not rely on it being accurate or even set. float confidence = 4; + + // Word-specific information for the words recognized by Speech in + // [transcript][google.cloud.dialogflow.v2.StreamingRecognitionResult.transcript]. Populated if and only if `message_type` = `TRANSCRIPT` and + // [InputAudioConfig.enable_word_info] is set. + repeated SpeechWordInfo speech_word_info = 7; + + // Time offset of the end of this Speech recognition result relative to the + // beginning of the audio. Only populated for `message_type` = `TRANSCRIPT`. + google.protobuf.Duration speech_end_offset = 8; } // Represents the natural language text to be processed. message TextInput { // Required. The UTF-8 encoded natural language text to be processed. // Text length must not exceed 256 characters. - string text = 1; + string text = 1 [(google.api.field_behavior) = REQUIRED]; // Required. The language of this conversational query. See [Language // Support](https://cloud.google.com/dialogflow/docs/reference/language) // for a list of the currently supported language codes. Note that queries in // the same session do not necessarily need to specify the same language. - string language_code = 2; + string language_code = 2 [(google.api.field_behavior) = REQUIRED]; } // Events allow for matching intents by event name instead of the natural @@ -454,21 +557,35 @@ message TextInput { // `"Hello #welcome_event.name! What can I do for you today?"`. message EventInput { // Required. The unique identifier of the event. - string name = 1; + string name = 1 [(google.api.field_behavior) = REQUIRED]; - // Optional. The collection of parameters associated with the event. + // The collection of parameters associated with the event. + // + // Depending on your protocol or client library language, this is a + // map, associative array, symbol table, dictionary, or JSON object + // composed of a collection of (MapKey, MapValue) pairs: + // + // - MapKey type: string + // - MapKey value: parameter name + // - MapValue type: + // - If parameter's entity type is a composite entity: map + // - Else: string or number, depending on parameter value type + // - MapValue value: + // - If parameter's entity type is a composite entity: + // map from composite entity property names to property values + // - Else: parameter value google.protobuf.Struct parameters = 2; // Required. The language of this query. See [Language // Support](https://cloud.google.com/dialogflow/docs/reference/language) // for a list of the currently supported language codes. Note that queries in // the same session do not necessarily need to specify the same language. - string language_code = 3; + string language_code = 3 [(google.api.field_behavior) = REQUIRED]; } // Configures the types of sentiment analysis to perform. message SentimentAnalysisRequestConfig { - // Optional. Instructs the service to perform sentiment analysis on + // Instructs the service to perform sentiment analysis on // `query_text`. If not provided, sentiment analysis is not performed on // `query_text`. bool analyze_query_text_sentiment = 1; diff --git a/third_party/googleapis/google/cloud/dialogflow/v2/session_entity_type.proto b/third_party/googleapis/google/cloud/dialogflow/v2/session_entity_type.proto index 8714152aa..9a16a5583 100644 --- a/third_party/googleapis/google/cloud/dialogflow/v2/session_entity_type.proto +++ b/third_party/googleapis/google/cloud/dialogflow/v2/session_entity_type.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,17 +11,18 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.dialogflow.v2; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; +import "google/api/resource.proto"; import "google/cloud/dialogflow/v2/entity_type.proto"; import "google/protobuf/empty.proto"; import "google/protobuf/field_mask.proto"; -import "google/api/client.proto"; option cc_enable_arenas = true; option csharp_namespace = "Google.Cloud.Dialogflow.V2"; @@ -41,6 +42,10 @@ option objc_class_prefix = "DF"; // favorites, preferences, playlists, and so on. You can redefine a session // entity type at the session level. // +// Session entity methods do not work with Google Assistant integration. +// Contact Dialogflow support if you need to use session entities +// with Google Assistant integration. +// // For more information about entity types, see the // [Dialogflow // documentation](https://cloud.google.com/dialogflow/docs/entities-overview). @@ -51,104 +56,166 @@ service SessionEntityTypes { "https://www.googleapis.com/auth/dialogflow"; // Returns the list of all session entity types in the specified session. + // + // This method doesn't work with Google Assistant integration. + // Contact Dialogflow support if you need to use session entities + // with Google Assistant integration. rpc ListSessionEntityTypes(ListSessionEntityTypesRequest) returns (ListSessionEntityTypesResponse) { option (google.api.http) = { get: "/v2/{parent=projects/*/agent/sessions/*}/entityTypes" + additional_bindings { + get: "/v2/{parent=projects/*/agent/environments/*/users/*/sessions/*}/entityTypes" + } }; + option (google.api.method_signature) = "parent"; } // Retrieves the specified session entity type. + // + // This method doesn't work with Google Assistant integration. + // Contact Dialogflow support if you need to use session entities + // with Google Assistant integration. rpc GetSessionEntityType(GetSessionEntityTypeRequest) returns (SessionEntityType) { option (google.api.http) = { get: "/v2/{name=projects/*/agent/sessions/*/entityTypes/*}" + additional_bindings { + get: "/v2/{name=projects/*/agent/environments/*/users/*/sessions/*/entityTypes/*}" + } }; + option (google.api.method_signature) = "name"; } // Creates a session entity type. // // If the specified session entity type already exists, overrides the session // entity type. + // + // This method doesn't work with Google Assistant integration. + // Contact Dialogflow support if you need to use session entities + // with Google Assistant integration. rpc CreateSessionEntityType(CreateSessionEntityTypeRequest) returns (SessionEntityType) { option (google.api.http) = { post: "/v2/{parent=projects/*/agent/sessions/*}/entityTypes" body: "session_entity_type" + additional_bindings { + post: "/v2/{parent=projects/*/agent/environments/*/users/*/sessions/*}/entityTypes" + body: "session_entity_type" + } }; + option (google.api.method_signature) = "parent,session_entity_type"; } // Updates the specified session entity type. + // + // This method doesn't work with Google Assistant integration. + // Contact Dialogflow support if you need to use session entities + // with Google Assistant integration. rpc UpdateSessionEntityType(UpdateSessionEntityTypeRequest) returns (SessionEntityType) { option (google.api.http) = { patch: "/v2/{session_entity_type.name=projects/*/agent/sessions/*/entityTypes/*}" body: "session_entity_type" + additional_bindings { + patch: "/v2/{session_entity_type.name=projects/*/agent/environments/*/users/*/sessions/*/entityTypes/*}" + body: "session_entity_type" + } }; + option (google.api.method_signature) = "session_entity_type"; + option (google.api.method_signature) = "session_entity_type,update_mask"; } // Deletes the specified session entity type. + // + // This method doesn't work with Google Assistant integration. + // Contact Dialogflow support if you need to use session entities + // with Google Assistant integration. rpc DeleteSessionEntityType(DeleteSessionEntityTypeRequest) returns (google.protobuf.Empty) { option (google.api.http) = { delete: "/v2/{name=projects/*/agent/sessions/*/entityTypes/*}" + additional_bindings { + delete: "/v2/{name=projects/*/agent/environments/*/users/*/sessions/*/entityTypes/*}" + } }; + option (google.api.method_signature) = "name"; } } // Represents a session entity type. // -// Extends or replaces a developer entity type at the user session level (we -// refer to the entity types defined at the agent level as "developer entity +// Extends or replaces a custom entity type at the user session level (we +// refer to the entity types defined at the agent level as "custom entity // types"). // // Note: session entity types apply to all queries, regardless of the language. message SessionEntityType { + option (google.api.resource) = { + type: "dialogflow.googleapis.com/SessionEntityType" + pattern: "projects/{project}/agent/sessions/{session}/entityTypes/{entity_type}" + pattern: "projects/{project}/agent/environments/{environment}/users/{user}/sessions/{session}/entityTypes/{entity_type}" + }; + // The types of modifications for a session entity type. enum EntityOverrideMode { // Not specified. This value should be never used. ENTITY_OVERRIDE_MODE_UNSPECIFIED = 0; // The collection of session entities overrides the collection of entities - // in the corresponding developer entity type. + // in the corresponding custom entity type. ENTITY_OVERRIDE_MODE_OVERRIDE = 1; // The collection of session entities extends the collection of entities in - // the corresponding developer entity type. + // the corresponding custom entity type. // // Note: Even in this override mode calls to `ListSessionEntityTypes`, // `GetSessionEntityType`, `CreateSessionEntityType` and // `UpdateSessionEntityType` only return the additional entities added in // this session entity type. If you want to get the supplemented list, - // please call [EntityTypes.GetEntityType][google.cloud.dialogflow.v2.EntityTypes.GetEntityType] on the developer entity type + // please call [EntityTypes.GetEntityType][google.cloud.dialogflow.v2.EntityTypes.GetEntityType] on the custom entity type // and merge. ENTITY_OVERRIDE_MODE_SUPPLEMENT = 2; } // Required. The unique identifier of this session entity type. Format: // `projects//agent/sessions//entityTypes/`. + // Display Name>`, or `projects//agent/environments//users//sessions//entityTypes/`. + // If `Environment ID` is not specified, we assume default 'draft' + // environment. If `User ID` is not specified, we assume default '-' user. // // `` must be the display name of an existing entity // type in the same agent that will be overridden or supplemented. - string name = 1; + string name = 1 [(google.api.field_behavior) = REQUIRED]; // Required. Indicates whether the additional data should override or - // supplement the developer entity type definition. - EntityOverrideMode entity_override_mode = 2; + // supplement the custom entity type definition. + EntityOverrideMode entity_override_mode = 2 [(google.api.field_behavior) = REQUIRED]; // Required. The collection of entities associated with this session entity // type. - repeated EntityType.Entity entities = 3; + repeated EntityType.Entity entities = 3 [(google.api.field_behavior) = REQUIRED]; } // The request message for [SessionEntityTypes.ListSessionEntityTypes][google.cloud.dialogflow.v2.SessionEntityTypes.ListSessionEntityTypes]. message ListSessionEntityTypesRequest { // Required. The session to list all session entity types from. - // Format: `projects//agent/sessions/`. - string parent = 1; + // Format: `projects//agent/sessions/` or + // `projects//agent/environments//users// + // sessions/`. + // If `Environment ID` is not specified, we assume default 'draft' + // environment. If `User ID` is not specified, we assume default '-' user. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dialogflow.googleapis.com/SessionEntityType" + } + ]; // Optional. The maximum number of items to return in a single page. By // default 100 and at most 1000. - int32 page_size = 2; + int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL]; // Optional. The next_page_token value returned from a previous list request. - string page_token = 3; + string page_token = 3 [(google.api.field_behavior) = OPTIONAL]; } // The response message for [SessionEntityTypes.ListSessionEntityTypes][google.cloud.dialogflow.v2.SessionEntityTypes.ListSessionEntityTypes]. @@ -166,35 +233,60 @@ message ListSessionEntityTypesResponse { message GetSessionEntityTypeRequest { // Required. The name of the session entity type. Format: // `projects//agent/sessions//entityTypes/`. - string name = 1; + // Display Name>` or `projects//agent/environments//users//sessions//entityTypes/`. + // If `Environment ID` is not specified, we assume default 'draft' + // environment. If `User ID` is not specified, we assume default '-' user. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "dialogflow.googleapis.com/SessionEntityType" + } + ]; } // The request message for [SessionEntityTypes.CreateSessionEntityType][google.cloud.dialogflow.v2.SessionEntityTypes.CreateSessionEntityType]. message CreateSessionEntityTypeRequest { // Required. The session to create a session entity type for. - // Format: `projects//agent/sessions/`. - string parent = 1; + // Format: `projects//agent/sessions/` or + // `projects//agent/environments//users// + // sessions/`. + // If `Environment ID` is not specified, we assume default 'draft' + // environment. If `User ID` is not specified, we assume default '-' user. + string parent = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + child_type: "dialogflow.googleapis.com/SessionEntityType" + } + ]; // Required. The session entity type to create. - SessionEntityType session_entity_type = 2; + SessionEntityType session_entity_type = 2 [(google.api.field_behavior) = REQUIRED]; } // The request message for [SessionEntityTypes.UpdateSessionEntityType][google.cloud.dialogflow.v2.SessionEntityTypes.UpdateSessionEntityType]. message UpdateSessionEntityTypeRequest { - // Required. The entity type to update. Format: - // `projects//agent/sessions//entityTypes/`. - SessionEntityType session_entity_type = 1; + // Required. The session entity type to update. + SessionEntityType session_entity_type = 1 [(google.api.field_behavior) = REQUIRED]; // Optional. The mask to control which fields get updated. - google.protobuf.FieldMask update_mask = 2; + google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = OPTIONAL]; } // The request message for [SessionEntityTypes.DeleteSessionEntityType][google.cloud.dialogflow.v2.SessionEntityTypes.DeleteSessionEntityType]. message DeleteSessionEntityTypeRequest { // Required. The name of the entity type to delete. Format: // `projects//agent/sessions//entityTypes/`. - string name = 1; + // Display Name>` or `projects//agent/environments//users//sessions//entityTypes/`. + // If `Environment ID` is not specified, we assume default 'draft' + // environment. If `User ID` is not specified, we assume default '-' user. + string name = 1 [ + (google.api.field_behavior) = REQUIRED, + (google.api.resource_reference) = { + type: "dialogflow.googleapis.com/SessionEntityType" + } + ]; } diff --git a/third_party/googleapis/google/cloud/dialogflow/v2/validation_result.proto b/third_party/googleapis/google/cloud/dialogflow/v2/validation_result.proto new file mode 100644 index 000000000..e499c1462 --- /dev/null +++ b/third_party/googleapis/google/cloud/dialogflow/v2/validation_result.proto @@ -0,0 +1,76 @@ +// Copyright 2020 Google LLC +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +syntax = "proto3"; + +package google.cloud.dialogflow.v2; + +import "google/api/annotations.proto"; + +option cc_enable_arenas = true; +option csharp_namespace = "Google.Cloud.Dialogflow.V2"; +option go_package = "google.golang.org/genproto/googleapis/cloud/dialogflow/v2;dialogflow"; +option java_multiple_files = true; +option java_outer_classname = "ValidationResultProto"; +option java_package = "com.google.cloud.dialogflow.v2"; +option objc_class_prefix = "DF"; + +// Represents a single validation error. +message ValidationError { + // Represents a level of severity. + enum Severity { + // Not specified. This value should never be used. + SEVERITY_UNSPECIFIED = 0; + + // The agent doesn't follow Dialogflow best practicies. + INFO = 1; + + // The agent may not behave as expected. + WARNING = 2; + + // The agent may experience partial failures. + ERROR = 3; + + // The agent may completely fail. + CRITICAL = 4; + } + + // The severity of the error. + Severity severity = 1; + + // The names of the entries that the error is associated with. + // Format: + // + // - "projects//agent", if the error is associated with the entire + // agent. + // - "projects//agent/intents/", if the error is + // associated with certain intents. + // - "projects//agent/intents//trainingPhrases/", if the + // error is associated with certain intent training phrases. + // - "projects//agent/intents//parameters/", if the error is associated with certain intent parameters. + // - "projects//agent/entities/", if the error is + // associated with certain entities. + repeated string entries = 3; + + // The detailed error messsage. + string error_message = 4; +} + +// Represents the output of agent validation. +message ValidationResult { + // Contains all validation errors. + repeated ValidationError validation_errors = 1; +} diff --git a/third_party/googleapis/google/cloud/dialogflow/v2/webhook.proto b/third_party/googleapis/google/cloud/dialogflow/v2/webhook.proto index 056f4615c..509649a74 100644 --- a/third_party/googleapis/google/cloud/dialogflow/v2/webhook.proto +++ b/third_party/googleapis/google/cloud/dialogflow/v2/webhook.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -55,52 +54,66 @@ message WebhookRequest { } // The response message for a webhook call. +// +// This response is validated by the Dialogflow server. If validation fails, +// an error will be returned in the [QueryResult.diagnostic_info][google.cloud.dialogflow.v2.QueryResult.diagnostic_info] field. +// Setting JSON fields to an empty value with the wrong type is a common error. +// To avoid this error: +// +// - Use `""` for empty strings +// - Use `{}` or `null` for empty objects +// - Use `[]` or `null` for empty arrays +// +// For more information, see the +// [Protocol Buffers Language +// Guide](https://developers.google.com/protocol-buffers/docs/proto3#json). message WebhookResponse { - // Optional. The text to be shown on the screen. This value is passed directly - // to `QueryResult.fulfillment_text`. + // Optional. The text response message intended for the end-user. + // It is recommended to use `fulfillment_messages.text.text[0]` instead. + // When provided, Dialogflow uses this field to populate + // [QueryResult.fulfillment_text][google.cloud.dialogflow.v2.QueryResult.fulfillment_text] sent to the integration or API caller. string fulfillment_text = 1; - // Optional. The collection of rich messages to present to the user. This - // value is passed directly to `QueryResult.fulfillment_messages`. + // Optional. The rich response messages intended for the end-user. + // When provided, Dialogflow uses this field to populate + // [QueryResult.fulfillment_messages][google.cloud.dialogflow.v2.QueryResult.fulfillment_messages] sent to the integration or API caller. repeated Intent.Message fulfillment_messages = 2; - // Optional. This value is passed directly to `QueryResult.webhook_source`. + // Optional. A custom field used to identify the webhook source. + // Arbitrary strings are supported. + // When provided, Dialogflow uses this field to populate + // [QueryResult.webhook_source][google.cloud.dialogflow.v2.QueryResult.webhook_source] sent to the integration or API caller. string source = 3; - // Optional. This value is passed directly to `QueryResult.webhook_payload`. - // See the related `fulfillment_messages[i].payload field`, which may be used - // as an alternative to this field. - // - // This field can be used for Actions on Google responses. - // It should have a structure similar to the JSON message shown here. For more - // information, see - // [Actions on Google Webhook - // Format](https://developers.google.com/actions/dialogflow/webhook) - // 
{
-  //   "google": {
-  //     "expectUserResponse": true,
-  //     "richResponse": {
-  //       "items": [
-  //         {
-  //           "simpleResponse": {
-  //             "textToSpeech": "this is a simple response"
-  //           }
-  //         }
-  //       ]
-  //     }
-  //   }
-  // }
+ // Optional. This field can be used to pass custom data from your webhook to the + // integration or API caller. Arbitrary JSON objects are supported. + // When provided, Dialogflow uses this field to populate + // [QueryResult.webhook_payload][google.cloud.dialogflow.v2.QueryResult.webhook_payload] sent to the integration or API caller. + // This field is also used by the + // [Google Assistant + // integration](https://cloud.google.com/dialogflow/docs/integrations/aog) + // for rich response messages. + // See the format definition at [Google Assistant Dialogflow webhook + // format](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json) google.protobuf.Struct payload = 4; - // Optional. The collection of output contexts. This value is passed directly - // to `QueryResult.output_contexts`. + // Optional. The collection of output contexts that will overwrite currently + // active contexts for the session and reset their lifespans. + // When provided, Dialogflow uses this field to populate + // [QueryResult.output_contexts][google.cloud.dialogflow.v2.QueryResult.output_contexts] sent to the integration or API caller. repeated Context output_contexts = 5; - // Optional. Makes the platform immediately invoke another `DetectIntent` call - // internally with the specified event as input. + // Optional. Invokes the supplied events. // When this field is set, Dialogflow ignores the `fulfillment_text`, // `fulfillment_messages`, and `payload` fields. EventInput followup_event_input = 6; + + // Optional. Additional session entity types to replace or extend developer + // entity types with. The entity synonyms apply to all languages and persist + // for the session. Setting this data from a webhook overwrites + // the session entity types that have been set using `detectIntent`, + // `streamingDetectIntent` or [SessionEntityType][google.cloud.dialogflow.v2.SessionEntityType] management methods. + repeated SessionEntityType session_entity_types = 10; } // Represents the contents of the original request that was passed to @@ -118,7 +131,8 @@ message OriginalDetectIntentRequest { // field passed in the request. Some integrations that query a Dialogflow // agent may provide additional information in the payload. // - // In particular for the Telephony Gateway this field has the form: + // In particular, for the Dialogflow Phone Gateway integration, this field has + // the form: // 
{
   //  "telephony": {
   //    "caller_id": "+18558363987"
diff --git a/third_party/googleapis/google/cloud/dialogflow/v2beta1/BUILD.bazel b/third_party/googleapis/google/cloud/dialogflow/v2beta1/BUILD.bazel
index 336995642..424bf53b2 100644
--- a/third_party/googleapis/google/cloud/dialogflow/v2beta1/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/dialogflow/v2beta1/BUILD.bazel
@@ -1,9 +1,12 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
@@ -14,15 +17,19 @@ proto_library(
         "context.proto",
         "document.proto",
         "entity_type.proto",
+        "environment.proto",
+        "gcs.proto",
         "intent.proto",
         "knowledge_base.proto",
         "session.proto",
         "session_entity_type.proto",
+        "validation_result.proto",
         "webhook.proto",
     ],
     deps = [
         "//google/api:annotations_proto",
         "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
         "//google/api:resource_proto",
         "//google/longrunning:operations_proto",
         "//google/rpc:status_proto",
@@ -37,7 +44,10 @@ proto_library(
 
 proto_library_with_info(
     name = "dialogflow_proto_with_info",
-    deps = [":dialogflow_proto"],
+    deps = [
+        ":dialogflow_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -45,18 +55,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
     name = "dialogflow_java_proto",
     deps = [":dialogflow_proto"],
@@ -65,58 +70,48 @@ java_proto_library(
 java_grpc_library(
     name = "dialogflow_java_grpc",
     srcs = [":dialogflow_proto"],
-    deps = [":dialogflow_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "dialogflow_resource_name_java_proto",
-    gapic_yaml = "dialogflow_gapic.yaml",
-    deps = [":dialogflow_proto"],
+    deps = [":dialogflow_java_proto"],
 )
 
 java_gapic_library(
     name = "dialogflow_java_gapic",
     src = ":dialogflow_proto_with_info",
     gapic_yaml = "dialogflow_gapic.yaml",
-    service_yaml = "//google/cloud/dialogflow:dialogflow_v2beta1.yaml",
-    test_deps = [":dialogflow_java_grpc"],
+    package = "google.cloud.dialogflow.v2beta1",
+    service_yaml = "dialogflow_v2beta1.yaml",
+    test_deps = [
+        ":dialogflow_java_grpc",
+    ],
     deps = [
         ":dialogflow_java_proto",
-        ":dialogflow_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-)
-
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":dialogflow_java_gapic_test",
-    ],
-) for test_name in [
-    "com.google.cloud.dialogflow.v2beta1.AgentsClientTest",
-    "com.google.cloud.dialogflow.v2beta1.ContextsClientTest",
-    "com.google.cloud.dialogflow.v2beta1.EntityTypesClientTest",
-    "com.google.cloud.dialogflow.v2beta1.DocumentsClientTest",
-    "com.google.cloud.dialogflow.v2beta1.IntentsClientTest",
-    "com.google.cloud.dialogflow.v2beta1.SessionEntityTypesClientTest",
-    "com.google.cloud.dialogflow.v2beta1.SessionsClientTest",
-    "com.google.cloud.dialogflow.v2beta1.KnowledgeBasesClientTest",
-]]
-
-# Opensource Packages
+    ],
+)
+
+java_gapic_test(
+    name = "dialogflow_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.dialogflow.v2beta1.AgentsClientTest",
+        "com.google.cloud.dialogflow.v2beta1.ContextsClientTest",
+        "com.google.cloud.dialogflow.v2beta1.DocumentsClientTest",
+        "com.google.cloud.dialogflow.v2beta1.EntityTypesClientTest",
+        "com.google.cloud.dialogflow.v2beta1.EnvironmentsClientTest",
+        "com.google.cloud.dialogflow.v2beta1.IntentsClientTest",
+        "com.google.cloud.dialogflow.v2beta1.KnowledgeBasesClientTest",
+        "com.google.cloud.dialogflow.v2beta1.SessionEntityTypesClientTest",
+        "com.google.cloud.dialogflow.v2beta1.SessionsClientTest",
+    ],
+    runtime_deps = [":dialogflow_java_gapic_test"],
+)
+
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-dialogflow-v2beta1-java",
-    client_deps = [":dialogflow_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":dialogflow_java_gapic_test"],
-    grpc_deps = [":dialogflow_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":dialogflow_java_gapic",
+        ":dialogflow_java_grpc",
         ":dialogflow_java_proto",
         ":dialogflow_proto",
-        ":dialogflow_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -124,10 +119,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -143,35 +138,264 @@ go_proto_library(
     ],
 )
 
-go_gapic_library(
-    name = "dialogflow_go_gapic",
+# go_gapic_library(
+#     name = "dialogflow_go_gapic",
+#     srcs = [":dialogflow_proto_with_info"],
+#     grpc_service_config = "dialogflow_grpc_service_config.json",
+#     importpath = "cloud.google.com/go/cloud/dialogflow/apiv2beta1;dialogflow",
+#     service_yaml = "dialogflow_v2beta1.yaml",
+#     deps = [
+#         ":dialogflow_go_proto",
+#         "//google/longrunning:longrunning_go_gapic",
+#         "//google/longrunning:longrunning_go_proto",
+#         "@com_google_cloud_go//longrunning:go_default_library",
+#         "@com_google_cloud_go//longrunning/autogen:go_default_library",
+#         "@io_bazel_rules_go//proto/wkt:duration_go_proto",
+#         "@io_bazel_rules_go//proto/wkt:struct_go_proto",
+#     ],
+# )
+#
+# go_test(
+#     name = "dialogflow_go_gapic_test",
+#     srcs = [":dialogflow_go_gapic_srcjar_test"],
+#     embed = [":dialogflow_go_gapic"],
+#     importpath = "cloud.google.com/go/cloud/dialogflow/apiv2beta1",
+# )
+#
+# # Open Source Packages
+# go_gapic_assembly_pkg(
+#     name = "gapi-cloud-dialogflow-v2beta1-go",
+#     deps = [
+#         ":dialogflow_go_gapic",
+#         ":dialogflow_go_gapic_srcjar-test.srcjar",
+#         ":dialogflow_go_proto",
+#     ],
+# )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "dialogflow_moved_proto",
+    srcs = [":dialogflow_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/longrunning:operations_proto",
+        "//google/rpc:status_proto",
+        "//google/type:latlng_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:struct_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "dialogflow_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":dialogflow_moved_proto"],
+)
+
+py_grpc_library(
+    name = "dialogflow_py_grpc",
+    srcs = [":dialogflow_moved_proto"],
+    deps = [":dialogflow_py_proto"],
+)
+
+py_gapic_library(
+    name = "dialogflow_py_gapic",
     src = ":dialogflow_proto_with_info",
     gapic_yaml = "dialogflow_gapic.yaml",
-    importpath = "cloud.google.com/go/cloud/dialogflow/apiv2beta1",
-    service_yaml = "//google/cloud/dialogflow:dialogflow_v2beta1.yaml",
+    package = "google.cloud.dialogflow.v2beta1",
+    service_yaml = "dialogflow_v2beta1.yaml",
     deps = [
-        ":dialogflow_go_proto",
-        "//google/longrunning:longrunning_go_gapic",
-        "//google/longrunning:longrunning_go_proto",
-        "@com_google_cloud_go//longrunning:go_default_library",
-        "@io_bazel_rules_go//proto/wkt:struct_go_proto",
+        ":dialogflow_py_grpc",
+        ":dialogflow_py_proto",
     ],
 )
 
-go_test(
-    name = "dialogflow_go_gapic_test",
-    srcs = [":dialogflow_go_gapic_srcjar_test"],
-    embed = [":dialogflow_go_gapic"],
-    importpath = "cloud.google.com/go/cloud/dialogflow/apiv2beta1",
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "dialogflow-v2beta1-py",
+    deps = [
+        ":dialogflow_py_gapic",
+        ":dialogflow_py_grpc",
+        ":dialogflow_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "dialogflow_php_proto",
+    deps = [":dialogflow_proto"],
+)
+
+php_grpc_library(
+    name = "dialogflow_php_grpc",
+    srcs = [":dialogflow_proto"],
+    deps = [":dialogflow_php_proto"],
 )
 
-# Opensource Packages
-go_gapic_assembly_pkg(
-    name = "gapi-cloud-dialogflow-v2beta1-go",
+php_gapic_library(
+    name = "dialogflow_php_gapic",
+    src = ":dialogflow_proto_with_info",
+    gapic_yaml = "dialogflow_gapic.yaml",
+    package = "google.cloud.dialogflow.v2beta1",
+    service_yaml = "dialogflow_v2beta1.yaml",
+    deps = [
+        ":dialogflow_php_grpc",
+        ":dialogflow_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-dialogflow-v2beta1-php",
+    deps = [
+        ":dialogflow_php_gapic",
+        ":dialogflow_php_grpc",
+        ":dialogflow_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "dialogflow_nodejs_gapic",
+    src = ":dialogflow_proto_with_info",
+    gapic_yaml = "dialogflow_gapic.yaml",
+    package = "google.cloud.dialogflow.v2beta1",
+    service_yaml = "dialogflow_v2beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "dialogflow-v2beta1-nodejs",
+    deps = [
+        ":dialogflow_nodejs_gapic",
+        ":dialogflow_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "dialogflow_ruby_proto",
+    deps = [":dialogflow_proto"],
+)
+
+ruby_grpc_library(
+    name = "dialogflow_ruby_grpc",
+    srcs = [":dialogflow_proto"],
+    deps = [":dialogflow_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "dialogflow_ruby_gapic",
+    src = ":dialogflow_proto_with_info",
+    gapic_yaml = "dialogflow_gapic.yaml",
+    package = "google.cloud.dialogflow.v2beta1",
+    service_yaml = "dialogflow_v2beta1.yaml",
+    deps = [
+        ":dialogflow_ruby_grpc",
+        ":dialogflow_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-dialogflow-v2beta1-ruby",
+    deps = [
+        ":dialogflow_ruby_gapic",
+        ":dialogflow_ruby_grpc",
+        ":dialogflow_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "dialogflow_csharp_proto",
+    deps = [":dialogflow_proto"],
+)
+
+csharp_grpc_library(
+    name = "dialogflow_csharp_grpc",
+    srcs = [":dialogflow_proto"],
+    deps = [":dialogflow_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "dialogflow_csharp_gapic",
+    src = ":dialogflow_proto_with_info",
+    gapic_yaml = "dialogflow_gapic.yaml",
+    package = "google.cloud.dialogflow.v2beta1",
+    service_yaml = "dialogflow_v2beta1.yaml",
+    deps = [
+        ":dialogflow_csharp_grpc",
+        ":dialogflow_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-dialogflow-v2beta1-csharp",
     deps = [
-        ":dialogflow_go_gapic",
-        ":dialogflow_go_gapic_srcjar-smoke-test.srcjar",
-        ":dialogflow_go_gapic_srcjar-test.srcjar",
-        ":dialogflow_go_proto",
+        ":dialogflow_csharp_gapic",
+        ":dialogflow_csharp_grpc",
+        ":dialogflow_csharp_proto",
     ],
 )
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/dialogflow/v2beta1/agent.proto b/third_party/googleapis/google/cloud/dialogflow/v2beta1/agent.proto
index b1a1fb6c2..7bfedab4f 100644
--- a/third_party/googleapis/google/cloud/dialogflow/v2beta1/agent.proto
+++ b/third_party/googleapis/google/cloud/dialogflow/v2beta1/agent.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,16 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.dialogflow.v2beta1;
 
 import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/dialogflow/v2beta1/environment.proto";
+import "google/cloud/dialogflow/v2beta1/validation_result.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
@@ -69,6 +72,9 @@ service Agents {
   rpc GetAgent(GetAgentRequest) returns (Agent) {
     option (google.api.http) = {
       get: "/v2beta1/{parent=projects/*}/agent"
+      additional_bindings {
+        get: "/v2beta1/{parent=projects/*/locations/*}/agent"
+      }
     };
   }
 
@@ -77,6 +83,10 @@ service Agents {
     option (google.api.http) = {
       post: "/v2beta1/{agent.parent=projects/*}/agent"
       body: "agent"
+      additional_bindings {
+        post: "/v2beta1/{agent.parent=projects/*/locations/*}/agent"
+        body: "agent"
+      }
     };
   }
 
@@ -84,6 +94,9 @@ service Agents {
   rpc DeleteAgent(DeleteAgentRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v2beta1/{parent=projects/*}/agent"
+      additional_bindings {
+        delete: "/v2beta1/{parent=projects/*/locations/*}/agent"
+      }
     };
   }
 
@@ -108,6 +121,10 @@ service Agents {
     option (google.api.http) = {
       post: "/v2beta1/{parent=projects/*}/agent:train"
       body: "*"
+      additional_bindings {
+        post: "/v2beta1/{parent=projects/*/locations/*}/agent:train"
+        body: "*"
+      }
     };
   }
 
@@ -119,6 +136,10 @@ service Agents {
     option (google.api.http) = {
       post: "/v2beta1/{parent=projects/*}/agent:export"
       body: "*"
+      additional_bindings {
+        post: "/v2beta1/{parent=projects/*/locations/*}/agent:export"
+        body: "*"
+      }
     };
   }
 
@@ -134,6 +155,10 @@ service Agents {
     option (google.api.http) = {
       post: "/v2beta1/{parent=projects/*}/agent:import"
       body: "*"
+      additional_bindings {
+        post: "/v2beta1/{parent=projects/*/locations/*}/agent:import"
+        body: "*"
+      }
     };
   }
 
@@ -148,12 +173,30 @@ service Agents {
     option (google.api.http) = {
       post: "/v2beta1/{parent=projects/*}/agent:restore"
       body: "*"
+      additional_bindings {
+        post: "/v2beta1/{parent=projects/*/locations/*}/agent:restore"
+        body: "*"
+      }
+    };
+  }
+
+  // Gets agent validation result. Agent validation is performed during
+  // training time and is updated automatically when training is completed.
+  rpc GetValidationResult(GetValidationResultRequest) returns (ValidationResult) {
+    option (google.api.http) = {
+      get: "/v2beta1/{parent=projects/*}/agent/validationResult"
     };
   }
 }
 
 // Represents a conversational agent.
 message Agent {
+  option (google.api.resource) = {
+    type: "dialogflow.googleapis.com/Agent"
+    pattern: "projects/{project}/agent"
+    pattern: "projects/{project}/locations/{location}/agent"
+  };
+
   // Match mode determines how intents are detected from user queries.
   enum MatchMode {
     // Not specified.
@@ -164,7 +207,7 @@ message Agent {
     MATCH_MODE_HYBRID = 1;
 
     // Can be used for agents with a large number of examples in intents,
-    // especially the ones using @sys.any or very large developer entities.
+    // especially the ones using @sys.any or very large custom entities.
     MATCH_MODE_ML_ONLY = 2;
   }
 
@@ -280,6 +323,18 @@ message DeleteAgentRequest {
   string parent = 1;
 }
 
+// Contains basic configuration for a sub-agent.
+message SubAgent {
+  // Required. The project of this agent.
+  // Format: `projects/`.
+  string project = 1;
+
+  // Optional. The unique identifier (`environment name` in dialogflow console)
+  // of this sub-agent environment. Assumes draft environment if `environment`
+  // is not set.
+  string environment = 2;
+}
+
 // The request message for [Agents.SearchAgents][google.cloud.dialogflow.v2beta1.Agents.SearchAgents].
 message SearchAgentsRequest {
   // Required. The project to list agents from.
@@ -328,26 +383,13 @@ message ExportAgentRequest {
 
 // The response message for [Agents.ExportAgent][google.cloud.dialogflow.v2beta1.Agents.ExportAgent].
 message ExportAgentResponse {
-  // Required. The exported agent.
+  // The exported agent.
   oneof agent {
     // The URI to a file containing the exported agent. This field is populated
     // only if `agent_uri` is specified in `ExportAgentRequest`.
     string agent_uri = 1;
 
-    // The exported agent.
-    //
-    // Example for how to export an agent to a zip file via a command line:
-    // 
curl \
-    //   'https://dialogflow.googleapis.com/v2beta1/projects/<project_name>/agent:export'\
-    //   -X POST \
-    //   -H 'Authorization: Bearer '$(gcloud auth application-default
-    //   print-access-token) \
-    //   -H 'Accept: application/json' \
-    //   -H 'Content-Type: application/json' \
-    //   --compressed \
-    //   --data-binary '{}' \
-    // | grep agentContent | sed -e 's/.*"agentContent": "\([^"]*\)".*/\1/' \
-    // | base64 --decode > <agent zip file>

+    // Zip compressed raw byte content for agent.
     bytes agent_content = 2;
   }
 }
@@ -364,20 +406,7 @@ message ImportAgentRequest {
     // Note: The URI must start with "gs://".
     string agent_uri = 2;
 
-    // The agent to import.
-    //
-    // Example for how to import an agent via the command line:
-    // 
curl \
-    //   'https://dialogflow.googleapis.com/v2beta1/projects/<project_name>/agent:import\
-    //    -X POST \
-    //    -H 'Authorization: Bearer '$(gcloud auth application-default
-    //    print-access-token) \
-    //    -H 'Accept: application/json' \
-    //    -H 'Content-Type: application/json' \
-    //    --compressed \
-    //    --data-binary "{
-    //       'agentContent': '$(cat <agent zip file> | base64 -w 0)'
-    //    }"

+    // Zip compressed raw byte content for agent.
     bytes agent_content = 3;
   }
 }
@@ -394,20 +423,21 @@ message RestoreAgentRequest {
     // Note: The URI must start with "gs://".
     string agent_uri = 2;
 
-    // The agent to restore.
-    //
-    // Example for how to restore an agent via the command line:
-    // 
curl \
-    //   'https://dialogflow.googleapis.com/v2beta1/projects/<project_name>/agent:restore\
-    //    -X POST \
-    //    -H 'Authorization: Bearer '$(gcloud auth application-default
-    //    print-access-token) \
-    //    -H 'Accept: application/json' \
-    //    -H 'Content-Type: application/json' \
-    //    --compressed \
-    //    --data-binary "{
-    //        'agentContent': '$(cat <agent zip file> | base64 -w 0)'
-    //    }"

+    // Zip compressed raw byte content for agent.
     bytes agent_content = 3;
   }
 }
+
+// The request message for [Agents.GetValidationResult][google.cloud.dialogflow.v2beta1.Agents.GetValidationResult].
+message GetValidationResultRequest {
+  // Required. The project that the agent is associated with.
+  // Format: `projects/`.
+  string parent = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The language for which you want a validation result. If not
+  // specified, the agent's default language is used. [Many
+  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
+  // are supported. Note: languages must be enabled in the agent before they can
+  // be used.
+  string language_code = 3 [(google.api.field_behavior) = OPTIONAL];
+}
diff --git a/third_party/googleapis/google/cloud/dialogflow/artman_dialogflow_v2beta1.yaml b/third_party/googleapis/google/cloud/dialogflow/v2beta1/artman_dialogflow_v2beta1.yaml
similarity index 90%
rename from third_party/googleapis/google/cloud/dialogflow/artman_dialogflow_v2beta1.yaml
rename to third_party/googleapis/google/cloud/dialogflow/v2beta1/artman_dialogflow_v2beta1.yaml
index 4a94bb0aa..c1a6a555f 100644
--- a/third_party/googleapis/google/cloud/dialogflow/artman_dialogflow_v2beta1.yaml
+++ b/third_party/googleapis/google/cloud/dialogflow/v2beta1/artman_dialogflow_v2beta1.yaml
@@ -4,9 +4,9 @@ common:
   proto_deps:
     - name: google-common-protos
   src_proto_paths:
-  - v2beta1
+  - .
   service_yaml: dialogflow_v2beta1.yaml
-  gapic_yaml: v2beta1/dialogflow_gapic.yaml
+  gapic_yaml: dialogflow_gapic.yaml
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/cloud/dialogflow/artman_dialogflow_v2beta1_java.yaml b/third_party/googleapis/google/cloud/dialogflow/v2beta1/artman_dialogflow_v2beta1_java.yaml
similarity index 83%
rename from third_party/googleapis/google/cloud/dialogflow/artman_dialogflow_v2beta1_java.yaml
rename to third_party/googleapis/google/cloud/dialogflow/v2beta1/artman_dialogflow_v2beta1_java.yaml
index 9f13a0416..05fc9bc91 100644
--- a/third_party/googleapis/google/cloud/dialogflow/artman_dialogflow_v2beta1_java.yaml
+++ b/third_party/googleapis/google/cloud/dialogflow/v2beta1/artman_dialogflow_v2beta1_java.yaml
@@ -5,9 +5,9 @@ common:
   proto_deps:
     - name: google-common-protos
   src_proto_paths:
-  - v2beta1
+  - .
   service_yaml: dialogflow_v2beta1.yaml
-  gapic_yaml: v2beta1/dialogflow_gapic.yaml
+  gapic_yaml: dialogflow_gapic.yaml
 artifacts:
 - name: java_gapic
   type: GAPIC
diff --git a/third_party/googleapis/google/cloud/dialogflow/v2beta1/audio_config.proto b/third_party/googleapis/google/cloud/dialogflow/v2beta1/audio_config.proto
index 3de27b941..15ac78d21 100644
--- a/third_party/googleapis/google/cloud/dialogflow/v2beta1/audio_config.proto
+++ b/third_party/googleapis/google/cloud/dialogflow/v2beta1/audio_config.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,15 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.dialogflow.v2beta1;
 
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/protobuf/duration.proto";
+import "google/protobuf/field_mask.proto";
 import "google/api/annotations.proto";
 
 option cc_enable_arenas = true;
@@ -77,29 +79,32 @@ enum AudioEncoding {
   AUDIO_ENCODING_SPEEX_WITH_HEADER_BYTE = 7;
 }
 
-// Information for a word recognized by the speech recognizer.
-message SpeechWordInfo {
-  // The word this info is for.
-  string word = 3;
-
-  // Time offset relative to the beginning of the audio that corresponds to the
-  // start of the spoken word. This is an experimental feature and the accuracy
-  // of the time offset can vary.
-  google.protobuf.Duration start_offset = 1;
-
-  // Time offset relative to the beginning of the audio that corresponds to the
-  // end of the spoken word. This is an experimental feature and the accuracy of
-  // the time offset can vary.
-  google.protobuf.Duration end_offset = 2;
-
-  // The Speech confidence between 0.0 and 1.0 for this word. A higher number
-  // indicates an estimated greater likelihood that the recognized word is
-  // correct. The default of 0.0 is a sentinel value indicating that confidence
-  // was not set.
+// Hints for the speech recognizer to help with recognition in a specific
+// conversation state.
+message SpeechContext {
+  // Optional. A list of strings containing words and phrases that the speech
+  // recognizer should recognize with higher likelihood.
   //
-  // This field is not guaranteed to be fully stable over time for the same
-  // audio input. Users should also not rely on it to always be provided.
-  float confidence = 4;
+  // This list can be used to:
+  // * improve accuracy for words and phrases you expect the user to say,
+  //   e.g. typical commands for your Dialogflow agent
+  // * add additional words to the speech recognizer vocabulary
+  // * ...
+  //
+  // See the [Cloud Speech
+  // documentation](https://cloud.google.com/speech-to-text/quotas) for usage
+  // limits.
+  repeated string phrases = 1;
+
+  // Optional. Boost for this context compared to other contexts:
+  // * If the boost is positive, Dialogflow will increase the probability that
+  //   the phrases in this context are recognized over similar sounding phrases.
+  // * If the boost is unspecified or non-positive, Dialogflow will not apply
+  //   any boost.
+  //
+  // Dialogflow recommends that you use boosts in the range (0, 20] and that you
+  // find a value that fits your use case with binary search.
+  float boost = 2;
 }
 
 // Variant of the specified [Speech model][google.cloud.dialogflow.v2beta1.InputAudioConfig.model] to use.
@@ -145,6 +150,31 @@ enum SpeechModelVariant {
   USE_ENHANCED = 3;
 }
 
+// Information for a word recognized by the speech recognizer.
+message SpeechWordInfo {
+  // The word this info is for.
+  string word = 3;
+
+  // Time offset relative to the beginning of the audio that corresponds to the
+  // start of the spoken word. This is an experimental feature and the accuracy
+  // of the time offset can vary.
+  google.protobuf.Duration start_offset = 1;
+
+  // Time offset relative to the beginning of the audio that corresponds to the
+  // end of the spoken word. This is an experimental feature and the accuracy of
+  // the time offset can vary.
+  google.protobuf.Duration end_offset = 2;
+
+  // The Speech confidence between 0.0 and 1.0 for this word. A higher number
+  // indicates an estimated greater likelihood that the recognized word is
+  // correct. The default of 0.0 is a sentinel value indicating that confidence
+  // was not set.
+  //
+  // This field is not guaranteed to be fully stable over time for the same
+  // audio input. Users should also not rely on it to always be provided.
+  float confidence = 4;
+}
+
 // Instructs the speech recognizer on how to process the audio content.
 message InputAudioConfig {
   // Required. Audio encoding of the audio content to process.
@@ -164,21 +194,32 @@ message InputAudioConfig {
   // the same session do not necessarily need to specify the same language.
   string language_code = 3;
 
-  // Optional. If `true`, Dialogflow returns [SpeechWordInfo][google.cloud.dialogflow.v2beta1.SpeechWordInfo] in
+  // If `true`, Dialogflow returns [SpeechWordInfo][google.cloud.dialogflow.v2beta1.SpeechWordInfo] in
   // [StreamingRecognitionResult][google.cloud.dialogflow.v2beta1.StreamingRecognitionResult] with information about the recognized speech
   // words, e.g. start and end time offsets. If false or unspecified, Speech
   // doesn't return any word-level information.
   bool enable_word_info = 13;
 
-  // Optional. A list of strings containing words and phrases that the speech
+  // A list of strings containing words and phrases that the speech
   // recognizer should recognize with higher likelihood.
   //
   // See [the Cloud Speech
   // documentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-hints)
   // for more details.
-  repeated string phrase_hints = 4;
+  //
+  // This field is deprecated. Please use [speech_contexts]() instead. If you
+  // specify both [phrase_hints]() and [speech_contexts](), Dialogflow will
+  // treat the [phrase_hints]() as a single additional [SpeechContext]().
+  repeated string phrase_hints = 4 [deprecated = true];
 
-  // Optional. Which Speech model to select for the given request. Select the
+  // Context information to assist speech recognition.
+  //
+  // See [the Cloud Speech
+  // documentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-hints)
+  // for more details.
+  repeated SpeechContext speech_contexts = 11;
+
+  // Which Speech model to select for the given request. Select the
   // model best suited to your domain to get best results. If a model is not
   // explicitly specified, then we auto-select a model based on the parameters
   // in the InputAudioConfig.
@@ -191,10 +232,10 @@ message InputAudioConfig {
   // for more details.
   string model = 7;
 
-  // Optional. Which variant of the [Speech model][google.cloud.dialogflow.v2beta1.InputAudioConfig.model] to use.
+  // Which variant of the [Speech model][google.cloud.dialogflow.v2beta1.InputAudioConfig.model] to use.
   SpeechModelVariant model_variant = 10;
 
-  // Optional. If `false` (default), recognition does not cease until the
+  // If `false` (default), recognition does not cease until the
   // client closes the stream.
   // If `true`, the recognizer will detect a single spoken utterance in input
   // audio. Recognition ceases when it detects the audio's voice has
@@ -207,20 +248,6 @@ message InputAudioConfig {
   bool single_utterance = 8;
 }
 
-// Description of which voice to use for speech synthesis.
-message VoiceSelectionParams {
-  // Optional. The name of the voice. If not set, the service will choose a
-  // voice based on the other parameters such as language_code and gender.
-  string name = 1;
-
-  // Optional. The preferred gender of the voice. If not set, the service will
-  // choose a voice based on the other parameters such as language_code and
-  // name. Note that this is only a preference, not requirement. If a
-  // voice of the appropriate gender is not available, the synthesizer should
-  // substitute a voice with a different gender rather than failing the request.
-  SsmlVoiceGender ssml_gender = 2;
-}
-
 // Gender of the voice as described in
 // [SSML voice element](https://www.w3.org/TR/speech-synthesis11/#edef_voice).
 enum SsmlVoiceGender {
@@ -238,6 +265,21 @@ enum SsmlVoiceGender {
   SSML_VOICE_GENDER_NEUTRAL = 3;
 }
 
+// Description of which voice to use for speech synthesis.
+message VoiceSelectionParams {
+  // Optional. The name of the voice. If not set, the service will choose a
+  // voice based on the other parameters such as language_code and
+  // [ssml_gender][google.cloud.dialogflow.v2beta1.VoiceSelectionParams.ssml_gender].
+  string name = 1;
+
+  // Optional. The preferred gender of the voice. If not set, the service will
+  // choose a voice based on the other parameters such as language_code and
+  // [name][google.cloud.dialogflow.v2beta1.VoiceSelectionParams.name]. Note that this is only a preference, not requirement. If a
+  // voice of the appropriate gender is not available, the synthesizer should
+  // substitute a voice with a different gender rather than failing the request.
+  SsmlVoiceGender ssml_gender = 2;
+}
+
 // Configuration of how speech should be synthesized.
 message SynthesizeSpeechConfig {
   // Optional. Speaking rate/speed, in the range [0.25, 4.0]. 1.0 is the normal
@@ -270,22 +312,6 @@ message SynthesizeSpeechConfig {
   VoiceSelectionParams voice = 4;
 }
 
-// Instructs the speech synthesizer how to generate the output audio content.
-message OutputAudioConfig {
-  // Required. Audio encoding of the synthesized audio content.
-  OutputAudioEncoding audio_encoding = 1;
-
-  // Optional. The synthesis sample rate (in hertz) for this audio. If not
-  // provided, then the synthesizer will use the default sample rate based on
-  // the audio encoding. If this is different from the voice's natural sample
-  // rate, then the synthesizer will honor this request by converting to the
-  // desired sample rate (which might result in worse audio quality).
-  int32 sample_rate_hertz = 2;
-
-  // Optional. Configuration of how speech should be synthesized.
-  SynthesizeSpeechConfig synthesize_speech_config = 3;
-}
-
 // Audio encoding of the output audio format in Text-To-Speech.
 enum OutputAudioEncoding {
   // Not specified.
@@ -295,7 +321,7 @@ enum OutputAudioEncoding {
   // Audio content returned as LINEAR16 also contains a WAV header.
   OUTPUT_AUDIO_ENCODING_LINEAR_16 = 1;
 
-  // MP3 audio.
+  // MP3 audio at 32kbps.
   OUTPUT_AUDIO_ENCODING_MP3 = 2;
 
   // Opus encoded audio wrapped in an ogg container. The result will be a
@@ -304,3 +330,21 @@ enum OutputAudioEncoding {
   // than MP3 while using approximately the same bitrate.
   OUTPUT_AUDIO_ENCODING_OGG_OPUS = 3;
 }
+
+// Instructs the speech synthesizer how to generate the output audio content.
+// If this audio config is supplied in a request, it overrides all existing
+// text-to-speech settings applied to the agent.
+message OutputAudioConfig {
+  // Required. Audio encoding of the synthesized audio content.
+  OutputAudioEncoding audio_encoding = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // The synthesis sample rate (in hertz) for this audio. If not
+  // provided, then the synthesizer will use the default sample rate based on
+  // the audio encoding. If this is different from the voice's natural sample
+  // rate, then the synthesizer will honor this request by converting to the
+  // desired sample rate (which might result in worse audio quality).
+  int32 sample_rate_hertz = 2;
+
+  // Configuration of how speech should be synthesized.
+  SynthesizeSpeechConfig synthesize_speech_config = 3;
+}
diff --git a/third_party/googleapis/google/cloud/dialogflow/v2beta1/context.proto b/third_party/googleapis/google/cloud/dialogflow/v2beta1/context.proto
index 97db7c0fe..fb1c3cee3 100644
--- a/third_party/googleapis/google/cloud/dialogflow/v2beta1/context.proto
+++ b/third_party/googleapis/google/cloud/dialogflow/v2beta1/context.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -62,6 +61,12 @@ service Contexts {
       additional_bindings {
         get: "/v2beta1/{parent=projects/*/agent/environments/*/users/*/sessions/*}/contexts"
       }
+      additional_bindings {
+        get: "/v2beta1/{parent=projects/*/locations/*/agent/sessions/*}/contexts"
+      }
+      additional_bindings {
+        get: "/v2beta1/{parent=projects/*/locations/*/agent/environments/*/users/*/sessions/*}/contexts"
+      }
     };
   }
 
@@ -72,6 +77,12 @@ service Contexts {
       additional_bindings {
         get: "/v2beta1/{name=projects/*/agent/environments/*/users/*/sessions/*/contexts/*}"
       }
+      additional_bindings {
+        get: "/v2beta1/{name=projects/*/locations/*/agent/sessions/*/contexts/*}"
+      }
+      additional_bindings {
+        get: "/v2beta1/{name=projects/*/locations/*/agent/environments/*/users/*/sessions/*/contexts/*}"
+      }
     };
   }
 
@@ -86,6 +97,14 @@ service Contexts {
         post: "/v2beta1/{parent=projects/*/agent/environments/*/users/*/sessions/*}/contexts"
         body: "context"
       }
+      additional_bindings {
+        post: "/v2beta1/{parent=projects/*/locations/*/agent/sessions/*}/contexts"
+        body: "context"
+      }
+      additional_bindings {
+        post: "/v2beta1/{parent=projects/*/locations/*/agent/environments/*/users/*/sessions/*}/contexts"
+        body: "context"
+      }
     };
   }
 
@@ -98,6 +117,14 @@ service Contexts {
         patch: "/v2beta1/{context.name=projects/*/agent/environments/*/users/*/sessions/*/contexts/*}"
         body: "context"
       }
+      additional_bindings {
+        patch: "/v2beta1/{context.name=projects/*/locations/*/agent/sessions/*/contexts/*}"
+        body: "context"
+      }
+      additional_bindings {
+        patch: "/v2beta1/{context.name=projects/*/locations/*/agent/environments/*/users/*/sessions/*/contexts/*}"
+        body: "context"
+      }
     };
   }
 
@@ -108,6 +135,12 @@ service Contexts {
       additional_bindings {
         delete: "/v2beta1/{name=projects/*/agent/environments/*/users/*/sessions/*/contexts/*}"
       }
+      additional_bindings {
+        delete: "/v2beta1/{name=projects/*/locations/*/agent/sessions/*/contexts/*}"
+      }
+      additional_bindings {
+        delete: "/v2beta1/{name=projects/*/locations/*/agent/environments/*/users/*/sessions/*/contexts/*}"
+      }
     };
   }
 
@@ -118,6 +151,12 @@ service Contexts {
       additional_bindings {
         delete: "/v2beta1/{parent=projects/*/agent/environments/*/users/*/sessions/*}/contexts"
       }
+      additional_bindings {
+        delete: "/v2beta1/{parent=projects/*/locations/*/agent/sessions/*}/contexts"
+      }
+      additional_bindings {
+        delete: "/v2beta1/{parent=projects/*/locations/*/agent/environments/*/users/*/sessions/*}/contexts"
+      }
     };
   }
 }
@@ -134,18 +173,36 @@ message Context {
   //
   // If `Environment ID` is not specified, we assume default 'draft'
   // environment. If `User ID` is not specified, we assume default '-' user.
+  //
+  // The following context names are reserved for internal use by Dialogflow.
+  // You should not use these contexts or create contexts with these names:
+  //
+  // * `__system_counters__`
+  // * `*_id_dialog_context`
+  // * `*_dialog_params_size`
   string name = 1;
 
   // Optional. The number of conversational query requests after which the
-  // context expires. If set to `0` (the default) the context expires
+  // context expires. The default is `0`. If set to `0`, the context expires
   // immediately. Contexts expire automatically after 20 minutes if there
   // are no matching queries.
   int32 lifespan_count = 2;
 
   // Optional. The collection of parameters associated with this context.
-  // Refer to [this
-  // doc](https://cloud.google.com/dialogflow/docs/intents-actions-parameters)
-  // for syntax.
+  //
+  // Depending on your protocol or client library language, this is a
+  // map, associative array, symbol table, dictionary, or JSON object
+  // composed of a collection of (MapKey, MapValue) pairs:
+  //
+  // -   MapKey type: string
+  // -   MapKey value: parameter name
+  // -   MapValue type:
+  //     -   If parameter's entity type is a composite entity: map
+  //     -   Else: string or number, depending on parameter value type
+  // -   MapValue value:
+  //     -   If parameter's entity type is a composite entity:
+  //         map from composite entity property names to property values
+  //     -   Else: parameter value
   google.protobuf.Struct parameters = 3;
 }
 
diff --git a/third_party/googleapis/google/cloud/dialogflow/v2beta1/dialogflow_gapic.yaml b/third_party/googleapis/google/cloud/dialogflow/v2beta1/dialogflow_gapic.yaml
index ae0f269b1..0c46cf3e2 100644
--- a/third_party/googleapis/google/cloud/dialogflow/v2beta1/dialogflow_gapic.yaml
+++ b/third_party/googleapis/google/cloud/dialogflow/v2beta1/dialogflow_gapic.yaml
@@ -20,7 +20,7 @@ language_settings:
     domain_layer_location: google-cloud
 # A list of API interface configurations.
 interfaces:
-  # The fully qualified name of the API interface.
+# The fully qualified name of the API interface.
 - name: google.cloud.dialogflow.v2beta1.Agents
   # A list of resource collection configurations.
   # Consists of a name_pattern and an entity_name.
@@ -233,7 +233,7 @@ interfaces:
       max_poll_delay_millis: 5000
       total_poll_timeout_millis: 300000
     resource_name_treatment: STATIC_TYPES
-  # The fully qualified name of the API interface.
+# The fully qualified name of the API interface.
 - name: google.cloud.dialogflow.v2beta1.Contexts
   # A list of resource collection configurations.
   # Consists of a name_pattern and an entity_name.
@@ -400,7 +400,7 @@ interfaces:
       parent: session
     timeout_millis: 60000
     resource_name_treatment: STATIC_TYPES
-  # The fully qualified name of the API interface.
+# The fully qualified name of the API interface.
 - name: google.cloud.dialogflow.v2beta1.EntityTypes
   # A list of resource collection configurations.
   # Consists of a name_pattern and an entity_name.
@@ -689,7 +689,7 @@ interfaces:
       max_poll_delay_millis: 5000
       total_poll_timeout_millis: 300000
     resource_name_treatment: STATIC_TYPES
-  # The fully qualified name of the API interface.
+# The fully qualified name of the API interface.
 - name: google.cloud.dialogflow.v2beta1.Intents
   # A list of resource collection configurations.
   # Consists of a name_pattern and an entity_name.
@@ -835,7 +835,6 @@ interfaces:
         - update_mask
     required_fields:
     - intent
-    - language_code
     retry_codes_name: non_idempotent
     retry_params_name: default
     field_name_patterns:
@@ -858,7 +857,6 @@ interfaces:
   - name: BatchUpdateIntents
     required_fields:
     - parent
-    - language_code
     retry_codes_name: non_idempotent
     retry_params_name: default
     field_name_patterns:
@@ -898,7 +896,7 @@ interfaces:
       max_poll_delay_millis: 5000
       total_poll_timeout_millis: 300000
     resource_name_treatment: STATIC_TYPES
-  # The fully qualified name of the API interface.
+# The fully qualified name of the API interface.
 - name: google.cloud.dialogflow.v2beta1.SessionEntityTypes
   # A list of resource collection configurations.
   # Consists of a name_pattern and an entity_name.
@@ -1052,7 +1050,7 @@ interfaces:
       name: session_entity_type
     timeout_millis: 60000
     resource_name_treatment: STATIC_TYPES
-  # The fully qualified name of the API interface.
+# The fully qualified name of the API interface.
 - name: google.cloud.dialogflow.v2beta1.Sessions
   # A list of resource collection configurations.
   # Consists of a name_pattern and an entity_name.
@@ -1150,7 +1148,7 @@ interfaces:
     retry_codes_name: non_idempotent
     retry_params_name: default
     timeout_millis: 220000
-  # The fully qualified name of the API interface.
+# The fully qualified name of the API interface.
 - name: google.cloud.dialogflow.v2beta1.KnowledgeBases
   # A list of resource collection configurations.
   # Consists of a name_pattern and an entity_name.
@@ -1314,7 +1312,7 @@ interfaces:
       knowledge_base.name: knowledge_base
     timeout_millis: 60000
     resource_name_treatment: STATIC_TYPES
-  # The fully qualified name of the API interface.
+# The fully qualified name of the API interface.
 - name: google.cloud.dialogflow.v2beta1.Documents
   # A list of resource collection configurations.
   # Consists of a name_pattern and an entity_name.
@@ -1505,6 +1503,104 @@ interfaces:
       max_poll_delay_millis: 5000
       total_poll_timeout_millis: 300000
     resource_name_treatment: STATIC_TYPES
+# The fully qualified name of the API interface.
+- name: google.cloud.dialogflow.v2beta1.Environments
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}/agent
+    entity_name: project_agent
+  - name_pattern: projects/{project}/agent/environments/{environment}
+    entity_name: environment
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - INTERNAL
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #   name - The simple name of the method.
+  #   flattening - Specifies the configuration for parameter flattening.
+  #       Describes the parameter groups for which a generator should produce
+  #       method overloads which allow a client to directly pass request message
+  #       fields as method parameters. This information may or may not be used,
+  #       depending on the target language.
+  #       Consists of groups, which each represent a list of parameters to be
+  #       flattened. Each parameter listed must be a field of the request
+  #       message.
+  #   required_fields - Fields that are always required for a request to be
+  #       valid.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #       Describes information for generating a method which transforms a
+  #       paging list RPC into a stream of resources.
+  #       Consists of a request and a response.
+  #       The request specifies request information of the list method. It
+  #       defines which fields match the paging pattern in the request. The
+  #       request consists of a page_size_field and a token_field. The
+  #       page_size_field is the name of the optional field specifying the
+  #       maximum number of elements to be returned in the response. The
+  #       token_field is the name of the field in the request containing the
+  #       page token.
+  #       The response specifies response information of the list method. It
+  #       defines which fields match the paging pattern in the response. The
+  #       response consists of a token_field and a resources_field. The
+  #       token_field is the name of the field in the response containing the
+  #       next page token. The resources_field is the name of the field in the
+  #       response containing the list of resources belonging to the page.
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #       name must be defined in interfaces.retry_codes_def.
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #       parameters. The name must be defined in interfaces.retry_params_def.
+  #   field_name_patterns - Maps the field name of the request type to
+  #       entity_name of interfaces.collections.
+  #       Specifies the string pattern that the field must follow.
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #       the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ListEnvironments
+    flattening:
+      groups:
+      - parameters:
+        - parent
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: environments
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project_agent
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
 resource_name_generation:
 - message_name: SetAgentRequest
   field_entity_map:
@@ -1653,3 +1749,6 @@ resource_name_generation:
 - message_name: DeleteDocumentRequest
   field_entity_map:
     name: document
+- message_name: ListEnvironmentsRequest
+  field_entity_map:
+    parent: project_agent
diff --git a/third_party/googleapis/google/cloud/dialogflow/v2beta1/dialogflow_grpc_service_config.json b/third_party/googleapis/google/cloud/dialogflow/v2beta1/dialogflow_grpc_service_config.json
new file mode 100755
index 000000000..dcf6791c0
--- /dev/null
+++ b/third_party/googleapis/google/cloud/dialogflow/v2beta1/dialogflow_grpc_service_config.json
@@ -0,0 +1,680 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.dialogflow.v2beta1.EntityTypes",
+          "method": "ListEntityTypes"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.EntityTypes",
+          "method": "GetEntityType"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.EntityTypes",
+          "method": "DeleteEntityType"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.EntityTypes",
+          "method": "BatchDeleteEntityTypes"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.EntityTypes",
+          "method": "BatchDeleteEntities"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Intents",
+          "method": "ListIntents"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Intents",
+          "method": "GetIntent"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Intents",
+          "method": "DeleteIntent"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Intents",
+          "method": "BatchDeleteIntents"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.dialogflow.v2beta1.SessionEntityTypes",
+          "method": "ListSessionEntityTypes"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.SessionEntityTypes",
+          "method": "GetSessionEntityType"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.SessionEntityTypes",
+          "method": "DeleteSessionEntityType"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.dialogflow.v2beta1.SessionEntityTypes",
+          "method": "CreateSessionEntityType"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.SessionEntityTypes",
+          "method": "UpdateSessionEntityType"
+        }
+      ],
+      "timeout": "60s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Sessions",
+          "method": "DetectIntent"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Sessions",
+          "method": "StreamingDetectIntent"
+        }
+      ],
+      "timeout": "220s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Contexts",
+          "method": "ListContexts"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Contexts",
+          "method": "GetContext"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Contexts",
+          "method": "DeleteContext"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Contexts",
+          "method": "DeleteAllContexts"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Contexts",
+          "method": "CreateContext"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Contexts",
+          "method": "UpdateContext"
+        }
+      ],
+      "timeout": "60s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.dialogflow.v2beta1.EntityTypes",
+          "method": "CreateEntityType"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.EntityTypes",
+          "method": "UpdateEntityType"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.EntityTypes",
+          "method": "BatchUpdateEntityTypes"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.EntityTypes",
+          "method": "BatchCreateEntities"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.EntityTypes",
+          "method": "BatchUpdateEntities"
+        }
+      ],
+      "timeout": "60s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Intents",
+          "method": "CreateIntent"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Intents",
+          "method": "UpdateIntent"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Intents",
+          "method": "BatchUpdateIntents"
+        }
+      ],
+      "timeout": "60s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Agents",
+          "method": "SetAgent"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Agents",
+          "method": "DeleteAgent"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Agents",
+          "method": "GetAgent"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Agents",
+          "method": "SearchAgents"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Agents",
+          "method": "TrainAgent"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Agents",
+          "method": "ExportAgent"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Agents",
+          "method": "RestoreAgent"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Agents",
+          "method": "ImportAgent"
+        }
+      ],
+      "timeout": "60s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.dialogflow.v2beta1.AnswerRecords",
+          "method": "ListAnswerRecords"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.AnswerRecords",
+          "method": "UpdateAnswerRecord"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.AnswerRecords",
+          "method": "DeleteAnswerRecord"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Conversations",
+          "method": "CreateConversation"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Conversations",
+          "method": "ListConversations"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Conversations",
+          "method": "GetConversation"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Conversations",
+          "method": "AddConversationPhoneNumber"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Conversations",
+          "method": "CompleteConversation"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Conversations",
+          "method": "CreateCallMatcher"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Conversations",
+          "method": "ListCallMatchers"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Conversations",
+          "method": "ListCallMatchers"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Conversations",
+          "method": "ListMessages"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.dialogflow.v2beta1.ConversationDatasets",
+          "method": "CreateConversationDataset"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.ConversationDatasets",
+          "method": "GetConversationDataset"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.ConversationDatasets",
+          "method": "ListConversationDatasets"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.ConversationDatasets",
+          "method": "DeleteConversationDataset"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.ConversationDatasets",
+          "method": "GetAnnotatedConversationDataset"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.ConversationDatasets",
+          "method": "GetAnnotatedConversationDataset"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.ConversationDatasets",
+          "method": "ListAnnotatedConversationDatasets"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.ConversationDatasets",
+          "method": "DeleteAnnotatedConversationDataset"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.ConversationDatasets",
+          "method": "ImportConversationData"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.ConversationDatasets",
+          "method": "LabelConversation"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.dialogflow.v2beta1.ConversationModels",
+          "method": "CreateConversationModel"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.ConversationModels",
+          "method": "GetConversationModel"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.ConversationModels",
+          "method": "ListConversationModels"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.ConversationModels",
+          "method": "DeleteConversationModel"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.ConversationModels",
+          "method": "DeployConversationModel"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.ConversationModels",
+          "method": "UndeployConversationModel"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.ConversationModels",
+          "method": "GetConversationModelEvaluation"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.ConversationModels",
+          "method": "ListConversationModelEvaluations"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.dialogflow.v2beta1.ConversationProfiles",
+          "method": "ListConversationProfiles"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.ConversationProfiles",
+          "method": "GetConversationProfile"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.ConversationProfiles",
+          "method": "CreateConversationProfile"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.ConversationProfiles",
+          "method": "UpdateConversationProfile"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.ConversationProfiles",
+          "method": "DeleteConversationProfile"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Documents",
+          "method": "ListDocuments"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Documents",
+          "method": "GetDocument"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Documents",
+          "method": "CreateDocument"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Documents",
+          "method": "DeleteDocument"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Documents",
+          "method": "UpdateDocument"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Documents",
+          "method": "ReloadDocument"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.dialogflow.v2beta1.KnowledgeBases",
+          "method": "ListKnowledgeBases"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.KnowledgeBases",
+          "method": "GetKnowledgeBase"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.KnowledgeBases",
+          "method": "CreateKnowledgeBase"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.KnowledgeBases",
+          "method": "DeleteKnowledgeBase"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.KnowledgeBases",
+          "method": "UpdateKnowledgeBase"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.dialogflow.v2beta1.PhoneNumbers",
+          "method": "ListPhoneNumbers"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.PhoneNumbers",
+          "method": "UpdatePhoneNumber"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.PhoneNumbers",
+          "method": "DeletePhoneNumber"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.PhoneNumbers",
+          "method": "UndeletePhoneNumber"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.dialogflow.v2beta1.PhoneNumberOrders",
+          "method": "CreatePhoneNumberOrder"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.PhoneNumberOrders",
+          "method": "GetPhoneNumberOrder"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.PhoneNumberOrders",
+          "method": "ListPhoneNumberOrders"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.PhoneNumberOrders",
+          "method": "UpdatePhoneNumberOrder"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.PhoneNumberOrders",
+          "method": "CancelPhoneNumberOrder"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Participants",
+          "method": "CreateParticipant"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Participants",
+          "method": "GetParticipant"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Participants",
+          "method": "ListParticipants"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Participants",
+          "method": "UpdateParticipant"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Participants",
+          "method": "AnalyzeContent"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Participants",
+          "method": "SuggestArticles"
+        },
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Participants",
+          "method": "SuggestFaqAnswers"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Participants",
+          "method": "StreamingAnalyzeContent"
+        }
+      ],
+      "timeout": "1800s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.dialogflow.v2beta1.Environments",
+          "method": "ListEnvironments"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "INTERNAL"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/dialogflow/dialogflow_v2beta1.yaml b/third_party/googleapis/google/cloud/dialogflow/v2beta1/dialogflow_v2beta1.yaml
similarity index 66%
rename from third_party/googleapis/google/cloud/dialogflow/dialogflow_v2beta1.yaml
rename to third_party/googleapis/google/cloud/dialogflow/v2beta1/dialogflow_v2beta1.yaml
index c526f7614..64c2b6172 100644
--- a/third_party/googleapis/google/cloud/dialogflow/dialogflow_v2beta1.yaml
+++ b/third_party/googleapis/google/cloud/dialogflow/v2beta1/dialogflow_v2beta1.yaml
@@ -8,6 +8,7 @@ apis:
 - name: google.cloud.dialogflow.v2beta1.Contexts
 - name: google.cloud.dialogflow.v2beta1.Documents
 - name: google.cloud.dialogflow.v2beta1.EntityTypes
+- name: google.cloud.dialogflow.v2beta1.Environments
 - name: google.cloud.dialogflow.v2beta1.Intents
 - name: google.cloud.dialogflow.v2beta1.KnowledgeBases
 - name: google.cloud.dialogflow.v2beta1.SessionEntityTypes
@@ -27,46 +28,20 @@ documentation:
     Builds conversational interfaces (for example, chatbots, and voice-powered
     apps and devices).
   overview: |-
-    [Dialogflow](http://dialogflow.com/) is a natural language
-    understanding platform that makes it easy for you to design and integrate
-    a conversational user interface into your mobile app, web application,
-    device, bot, and so on. Using Dialogflow you can provide users new and
-    engaging ways to interact with your product using both voice recognition
-    and text input.
+     Dialogflow is
+    a natural language understanding platform that makes it easy
+    to design and integrate a conversational user interface into your mobile
+    app, web application, device, bot, interactive voice response system, and
+    so on. Using Dialogflow, you can provide new and engaging ways for
+    users to interact with your product.
 
-    For information on how Dialogflow agents, intents, entities, and so on
-    work, see the [Dialogflow getting
-    started
-    guide](https://dialogflow.com/docs/getting-started/basics) in the
-    dialogflow.com documentation.
+    Dialogflow can analyze multiple types of input from your customers,
+    including text or audio inputs (like from a phone or voice recording).
+    It can also respond to your customers in a couple of ways, either through
+    text or with synthetic speech.
 
-    ## Dialogflow Editions
-
-    Dialogflow is available in two editions: Standard and Enterprise. For
-    information on the difference in Dialogflow editions, see [Dialogflow
-    Editions](https://cloud.google.com/dialogflow-enterprise/docs/editions).
-
-    ## The Dialogflow API
-
-    The Dialogflow API provides a REST and gRPC API that you can use to
-    incorporate the Dialogflow into your product. After you have created a
-    Google Cloud project and a Dialogflow agent, you can use the API to create
-    intents, entities, and so on, and then pass user input to your Dialogflow
-    agent to determine user intent using
-    the
-    [detectIntent](https://cloud.google.com/dialogflow-enterprise/docs/reference/rest/v2beta1/projects.agent.sessions/detectIntent) REST
-    API, or the
-    [StreamingDetectIntentRequest](https://cloud.google.com/dialogflow-enterprise/docs/reference/rpc/google.cloud.dialogflow.v2beta1#google.cloud.dialogflow.v2beta1.StreamingDetectIntentRequest) gRPC
-    API.
-
-    ## Getting Started
-
-    *   For information on setting up a Google Cloud Platform project and
-    creating     an agent using the Dialogflow Enterprise Edition, see
-    [Quickstart](https://cloud.google.com/dialogflow-enterprise/docs/quickstart). *
-    For information on creating an agent using the Dialogflow Standard
-    Edition,     see [Building Your First
-    Agent](https://dialogflow.com/docs/getting-started/building-your-first-agent)
+    For more information, see the
+    [Dialogflow documentation](https://cloud.google.com/dialogflow/docs).
 
 backend:
   rules:
@@ -78,6 +53,8 @@ backend:
     deadline: 60.0
   - selector: 'google.cloud.dialogflow.v2beta1.EntityTypes.*'
     deadline: 60.0
+  - selector: google.cloud.dialogflow.v2beta1.Environments.ListEnvironments
+    deadline: 60.0
   - selector: 'google.cloud.dialogflow.v2beta1.Intents.*'
     deadline: 60.0
   - selector: 'google.cloud.dialogflow.v2beta1.KnowledgeBases.*'
@@ -85,18 +62,26 @@ backend:
   - selector: 'google.cloud.dialogflow.v2beta1.SessionEntityTypes.*'
     deadline: 60.0
   - selector: google.cloud.dialogflow.v2beta1.Sessions.DetectIntent
-    deadline: 230.0
+    deadline: 220.0
   - selector: google.cloud.dialogflow.v2beta1.Sessions.StreamingDetectIntent
-    deadline: 230.0
+    deadline: 220.0
   - selector: 'google.longrunning.Operations.*'
     deadline: 60.0
 
 http:
   rules:
+  - selector: google.longrunning.Operations.CancelOperation
+    post: '/v2beta1/{name=projects/*/operations/*}:cancel'
+    additional_bindings:
+    - post: '/v2beta1/{name=projects/*/locations/*/operations/*}:cancel'
   - selector: google.longrunning.Operations.GetOperation
     get: '/v2beta1/{name=projects/*/operations/*}'
+    additional_bindings:
+    - get: '/v2beta1/{name=projects/*/locations/*/operations/*}'
   - selector: google.longrunning.Operations.ListOperations
     get: '/v2beta1/{name=projects/*}/operations'
+    additional_bindings:
+    - get: '/v2beta1/{name=projects/*/locations/*}/operations'
 
 authentication:
   rules:
@@ -120,6 +105,11 @@ authentication:
       canonical_scopes: |-
         https://www.googleapis.com/auth/cloud-platform,
         https://www.googleapis.com/auth/dialogflow
+  - selector: google.cloud.dialogflow.v2beta1.Environments.ListEnvironments
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/dialogflow
   - selector: 'google.cloud.dialogflow.v2beta1.Intents.*'
     oauth:
       canonical_scopes: |-
diff --git a/third_party/googleapis/google/cloud/dialogflow/v2beta1/document.proto b/third_party/googleapis/google/cloud/dialogflow/v2beta1/document.proto
index 5daf85593..02b6e4e81 100644
--- a/third_party/googleapis/google/cloud/dialogflow/v2beta1/document.proto
+++ b/third_party/googleapis/google/cloud/dialogflow/v2beta1/document.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,14 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.dialogflow.v2beta1;
 
 import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/cloud/dialogflow/v2beta1/gcs.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
@@ -70,9 +71,6 @@ service Documents {
   //
   // Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
   // only use `projects.knowledgeBases.documents`.
-  //
-  // Operation 
   rpc CreateDocument(CreateDocumentRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v2beta1/{parent=projects/*/knowledgeBases/*}/documents"
@@ -82,15 +80,16 @@ service Documents {
         body: "document"
       }
     };
+    option (google.longrunning.operation_info) = {
+      response_type: "Document"
+      metadata_type: "KnowledgeOperationMetadata"
+    };
   }
 
   // Deletes the specified document.
   //
   // Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
   // only use `projects.knowledgeBases.documents`.
-  //
-  // Operation 
   rpc DeleteDocument(DeleteDocumentRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       delete: "/v2beta1/{name=projects/*/knowledgeBases/*/documents/*}"
@@ -98,15 +97,16 @@ service Documents {
         delete: "/v2beta1/{name=projects/*/agent/knowledgeBases/*/documents/*}"
       }
     };
+    option (google.longrunning.operation_info) = {
+      response_type: "google.protobuf.Empty"
+      metadata_type: "KnowledgeOperationMetadata"
+    };
   }
 
   // Updates the specified document.
   //
   // Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
   // only use `projects.knowledgeBases.documents`.
-  //
-  // Operation 
   rpc UpdateDocument(UpdateDocumentRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       patch: "/v2beta1/{document.name=projects/*/knowledgeBases/*/documents/*}"
@@ -116,6 +116,10 @@ service Documents {
         body: "document"
       }
     };
+    option (google.longrunning.operation_info) = {
+      response_type: "Document"
+      metadata_type: "KnowledgeOperationMetadata"
+    };
   }
 
   // Reloads the specified document from its specified source, content_uri or
@@ -125,9 +129,6 @@ service Documents {
   //
   // Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
   // only use `projects.knowledgeBases.documents`.
-  //
-  // Operation 
   rpc ReloadDocument(ReloadDocumentRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v2beta1/{name=projects/*/knowledgeBases/*/documents/*}:reload"
@@ -137,6 +138,10 @@ service Documents {
         body: "*"
       }
     };
+    option (google.longrunning.operation_info) = {
+      response_type: "Document"
+      metadata_type: "KnowledgeOperationMetadata"
+    };
   }
 }
 
@@ -293,4 +298,13 @@ message ReloadDocumentRequest {
   // Format: `projects//knowledgeBases//documents/`
   string name = 1;
+
+  // The source for document reloading.
+  // Optional. If provided, the service will load the contents from the source
+  // and update document in the knowledge base.
+  oneof source {
+    // Optional. The path for a Cloud Storage source file for reloading document content.
+    // If not provided, the Document's existing source will be reloaded.
+    GcsSource gcs_source = 3;
+  }
 }
diff --git a/third_party/googleapis/google/cloud/dialogflow/v2beta1/entity_type.proto b/third_party/googleapis/google/cloud/dialogflow/v2beta1/entity_type.proto
index 0ef132062..0f0932d2d 100644
--- a/third_party/googleapis/google/cloud/dialogflow/v2beta1/entity_type.proto
+++ b/third_party/googleapis/google/cloud/dialogflow/v2beta1/entity_type.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,14 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.dialogflow.v2beta1;
 
 import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
@@ -45,11 +46,11 @@ option objc_class_prefix = "DF";
 //     data types such as date, time, currency, and so on. A system entity is
 //     represented by the `EntityType` type.
 //
-// *   **Developer** - entities that are defined by you that represent
+// *   **Custom** - entities that are defined by you that represent
 //     actionable data that is meaningful to your application. For example,
 //     you could define a `pizza.sauce` entity for red or white pizza sauce,
 //     a `pizza.cheese` entity for the different types of cheese on a pizza,
-//     a `pizza.topping` entity for different toppings, and so on. A developer
+//     a `pizza.topping` entity for different toppings, and so on. A custom
 //     entity is represented by the `EntityType` type.
 //
 // *   **User** - entities that are built for an individual user such as
@@ -69,6 +70,9 @@ service EntityTypes {
   rpc ListEntityTypes(ListEntityTypesRequest) returns (ListEntityTypesResponse) {
     option (google.api.http) = {
       get: "/v2beta1/{parent=projects/*/agent}/entityTypes"
+      additional_bindings {
+        get: "/v2beta1/{parent=projects/*/locations/*/agent}/entityTypes"
+      }
     };
   }
 
@@ -76,6 +80,9 @@ service EntityTypes {
   rpc GetEntityType(GetEntityTypeRequest) returns (EntityType) {
     option (google.api.http) = {
       get: "/v2beta1/{name=projects/*/agent/entityTypes/*}"
+      additional_bindings {
+        get: "/v2beta1/{name=projects/*/locations/*/agent/entityTypes/*}"
+      }
     };
   }
 
@@ -84,6 +91,10 @@ service EntityTypes {
     option (google.api.http) = {
       post: "/v2beta1/{parent=projects/*/agent}/entityTypes"
       body: "entity_type"
+      additional_bindings {
+        post: "/v2beta1/{parent=projects/*/locations/*/agent}/entityTypes"
+        body: "entity_type"
+      }
     };
   }
 
@@ -92,6 +103,10 @@ service EntityTypes {
     option (google.api.http) = {
       patch: "/v2beta1/{entity_type.name=projects/*/agent/entityTypes/*}"
       body: "entity_type"
+      additional_bindings {
+        patch: "/v2beta1/{entity_type.name=projects/*/locations/*/agent/entityTypes/*}"
+        body: "entity_type"
+      }
     };
   }
 
@@ -99,6 +114,9 @@ service EntityTypes {
   rpc DeleteEntityType(DeleteEntityTypeRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v2beta1/{name=projects/*/agent/entityTypes/*}"
+      additional_bindings {
+        delete: "/v2beta1/{name=projects/*/locations/*/agent/entityTypes/*}"
+      }
     };
   }
 
@@ -109,6 +127,10 @@ service EntityTypes {
     option (google.api.http) = {
       post: "/v2beta1/{parent=projects/*/agent}/entityTypes:batchUpdate"
       body: "*"
+      additional_bindings {
+        post: "/v2beta1/{parent=projects/*/locations/*/agent}/entityTypes:batchUpdate"
+        body: "*"
+      }
     };
   }
 
@@ -119,6 +141,10 @@ service EntityTypes {
     option (google.api.http) = {
       post: "/v2beta1/{parent=projects/*/agent}/entityTypes:batchDelete"
       body: "*"
+      additional_bindings {
+        post: "/v2beta1/{parent=projects/*/locations/*/agent}/entityTypes:batchDelete"
+        body: "*"
+      }
     };
   }
 
@@ -129,6 +155,10 @@ service EntityTypes {
     option (google.api.http) = {
       post: "/v2beta1/{parent=projects/*/agent/entityTypes/*}/entities:batchCreate"
       body: "*"
+      additional_bindings {
+        post: "/v2beta1/{parent=projects/*/locations/*/agent/entityTypes/*}/entities:batchCreate"
+        body: "*"
+      }
     };
   }
 
@@ -141,6 +171,10 @@ service EntityTypes {
     option (google.api.http) = {
       post: "/v2beta1/{parent=projects/*/agent/entityTypes/*}/entities:batchUpdate"
       body: "*"
+      additional_bindings {
+        post: "/v2beta1/{parent=projects/*/locations/*/agent/entityTypes/*}/entities:batchUpdate"
+        body: "*"
+      }
     };
   }
 
@@ -151,6 +185,10 @@ service EntityTypes {
     option (google.api.http) = {
       post: "/v2beta1/{parent=projects/*/agent/entityTypes/*}/entities:batchDelete"
       body: "*"
+      additional_bindings {
+        post: "/v2beta1/{parent=projects/*/locations/*/agent/entityTypes/*}/entities:batchDelete"
+        body: "*"
+      }
     };
   }
 }
@@ -167,7 +205,7 @@ message EntityType {
     //
     // For `KIND_MAP` entity types:
     //
-    // *   A canonical value to be used in place of synonyms.
+    // *   A reference value to be used in place of synonyms.
     //
     // For `KIND_LIST` entity types:
     //
@@ -190,14 +228,18 @@ message EntityType {
     // Not specified. This value should be never used.
     KIND_UNSPECIFIED = 0;
 
-    // Map entity types allow mapping of a group of synonyms to a canonical
+    // Map entity types allow mapping of a group of synonyms to a reference
     // value.
     KIND_MAP = 1;
 
-    // List entity types contain a set of entries that do not map to canonical
+    // List entity types contain a set of entries that do not map to reference
     // values. However, list entity types can contain references to other entity
     // types (with or without aliases).
     KIND_LIST = 2;
+
+    // Regexp entity types allow to specify regular expressions in entries
+    // values.
+    KIND_REGEXP = 3;
   }
 
   // Represents different entity type expansion modes. Automated expansion
@@ -230,6 +272,9 @@ message EntityType {
 
   // Optional. The collection of entity entries associated with the entity type.
   repeated Entity entities = 6;
+
+  // Optional. Enables fuzzy entity extraction during classification.
+  bool enable_fuzzy_extraction = 7;
 }
 
 // The request message for [EntityTypes.ListEntityTypes][google.cloud.dialogflow.v2beta1.EntityTypes.ListEntityTypes].
@@ -238,13 +283,12 @@ message ListEntityTypesRequest {
   // Format: `projects//agent`.
   string parent = 1;
 
-  // Optional. The language to list entity synonyms for. If not specified,
-  // the agent's default language is used.
-  // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
-  // are supported. Note: languages must be enabled in the agent before they can
-  // be used.
-  string language_code = 2;
+  // Optional. The language used to access language-specific data.
+  // If not specified, the agent's default language is used.
+  // For more information, see
+  // [Multilingual intent and entity
+  // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
+  string language_code = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The maximum number of items to return in a single page. By
   // default 100 and at most 1000.
@@ -271,13 +315,12 @@ message GetEntityTypeRequest {
   // Format: `projects//agent/entityTypes/`.
   string name = 1;
 
-  // Optional. The language to retrieve entity synonyms for. If not specified,
-  // the agent's default language is used.
-  // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
-  // are supported. Note: languages must be enabled in the agent before they can
-  // be used.
-  string language_code = 2;
+  // Optional. The language used to access language-specific data.
+  // If not specified, the agent's default language is used.
+  // For more information, see
+  // [Multilingual intent and entity
+  // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
+  string language_code = 2 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // The request message for [EntityTypes.CreateEntityType][google.cloud.dialogflow.v2beta1.EntityTypes.CreateEntityType].
@@ -289,13 +332,12 @@ message CreateEntityTypeRequest {
   // Required. The entity type to create.
   EntityType entity_type = 2;
 
-  // Optional. The language of entity synonyms defined in `entity_type`. If not
-  // specified, the agent's default language is used.
-  // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
-  // are supported. Note: languages must be enabled in the agent before they can
-  // be used.
-  string language_code = 3;
+  // Optional. The language used to access language-specific data.
+  // If not specified, the agent's default language is used.
+  // For more information, see
+  // [Multilingual intent and entity
+  // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
+  string language_code = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // The request message for [EntityTypes.UpdateEntityType][google.cloud.dialogflow.v2beta1.EntityTypes.UpdateEntityType].
@@ -303,13 +345,12 @@ message UpdateEntityTypeRequest {
   // Required. The entity type to update.
   EntityType entity_type = 1;
 
-  // Optional. The language of entity synonyms defined in `entity_type`. If not
-  // specified, the agent's default language is used.
-  // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
-  // are supported. Note: languages must be enabled in the agent before they can
-  // be used.
-  string language_code = 2;
+  // Optional. The language used to access language-specific data.
+  // If not specified, the agent's default language is used.
+  // For more information, see
+  // [Multilingual intent and entity
+  // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
+  string language_code = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The mask to control which fields get updated.
   google.protobuf.FieldMask update_mask = 3;
@@ -345,13 +386,12 @@ message BatchUpdateEntityTypesRequest {
     EntityTypeBatch entity_type_batch_inline = 3;
   }
 
-  // Optional. The language of entity synonyms defined in `entity_types`. If not
-  // specified, the agent's default language is used.
-  // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
-  // are supported. Note: languages must be enabled in the agent before they can
-  // be used.
-  string language_code = 4;
+  // Optional. The language used to access language-specific data.
+  // If not specified, the agent's default language is used.
+  // For more information, see
+  // [Multilingual intent and entity
+  // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
+  string language_code = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The mask to control which fields get updated.
   google.protobuf.FieldMask update_mask = 5;
@@ -383,13 +423,12 @@ message BatchCreateEntitiesRequest {
   // Required. The entities to create.
   repeated EntityType.Entity entities = 2;
 
-  // Optional. The language of entity synonyms defined in `entities`. If not
-  // specified, the agent's default language is used.
-  // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
-  // are supported. Note: languages must be enabled in the agent before they can
-  // be used.
-  string language_code = 3;
+  // Optional. The language used to access language-specific data.
+  // If not specified, the agent's default language is used.
+  // For more information, see
+  // [Multilingual intent and entity
+  // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
+  string language_code = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // The request message for [EntityTypes.BatchUpdateEntities][google.cloud.dialogflow.v2beta1.EntityTypes.BatchUpdateEntities].
@@ -401,13 +440,12 @@ message BatchUpdateEntitiesRequest {
   // Required. The entities to update or create.
   repeated EntityType.Entity entities = 2;
 
-  // Optional. The language of entity synonyms defined in `entities`. If not
-  // specified, the agent's default language is used.
-  // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
-  // are supported. Note: languages must be enabled in the agent before they can
-  // be used.
-  string language_code = 3;
+  // Optional. The language used to access language-specific data.
+  // If not specified, the agent's default language is used.
+  // For more information, see
+  // [Multilingual intent and entity
+  // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
+  string language_code = 3 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The mask to control which fields get updated.
   google.protobuf.FieldMask update_mask = 4;
@@ -419,18 +457,17 @@ message BatchDeleteEntitiesRequest {
   // `projects//agent/entityTypes/`.
   string parent = 1;
 
-  // Required. The canonical `values` of the entities to delete. Note that
+  // Required. The reference `values` of the entities to delete. Note that
   // these are not fully-qualified names, i.e. they don't start with
   // `projects/`.
   repeated string entity_values = 2;
 
-  // Optional. The language of entity synonyms defined in `entities`. If not
-  // specified, the agent's default language is used.
-  // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
-  // are supported. Note: languages must be enabled in the agent before they can
-  // be used.
-  string language_code = 3;
+  // Optional. The language used to access language-specific data.
+  // If not specified, the agent's default language is used.
+  // For more information, see
+  // [Multilingual intent and entity
+  // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
+  string language_code = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // This message is a wrapper around a collection of entity types.
diff --git a/third_party/googleapis/google/cloud/dialogflow/v2beta1/environment.proto b/third_party/googleapis/google/cloud/dialogflow/v2beta1/environment.proto
new file mode 100644
index 000000000..386c014d6
--- /dev/null
+++ b/third_party/googleapis/google/cloud/dialogflow/v2beta1/environment.proto
@@ -0,0 +1,135 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.dialogflow.v2beta1;
+
+import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/dialogflow/v2beta1/audio_config.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/client.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.Dialogflow.V2beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/dialogflow/v2beta1;dialogflow";
+option java_multiple_files = true;
+option java_outer_classname = "EnvironmentProto";
+option java_package = "com.google.cloud.dialogflow.v2beta1";
+option objc_class_prefix = "DF";
+
+// Manages agent environments.
+service Environments {
+  option (google.api.default_host) = "dialogflow.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/dialogflow";
+
+  // Returns the list of all non-draft environments of the specified agent.
+  rpc ListEnvironments(ListEnvironmentsRequest) returns (ListEnvironmentsResponse) {
+    option (google.api.http) = {
+      get: "/v2beta1/{parent=projects/*/agent}/environments"
+      additional_bindings {
+        get: "/v2beta1/{parent=projects/*/locations/*/agent}/environments"
+      }
+    };
+  }
+}
+
+// Represents an agent environment.
+message Environment {
+  option (google.api.resource) = {
+    type: "dialogflow.googleapis.com/Environment"
+    pattern: "projects/{project}/agent/environments/{environment}"
+  };
+
+  // Represents an environment state. When a environment is pointed to a new
+  // agent version, the environment is temporarily set to the `LOADING` state.
+  // During that time, the environment keeps on serving the previous version of
+  // the agent. After the new agent version is done loading, the environment is
+  // set back to the `RUNNING` state.
+  enum State {
+    // Not specified. This value is not used.
+    STATE_UNSPECIFIED = 0;
+
+    // Stopped.
+    STOPPED = 1;
+
+    // Loading.
+    LOADING = 2;
+
+    // Running.
+    RUNNING = 3;
+  }
+
+  // Output only. The unique identifier of this agent environment.
+  // Format: `projects//agent/environments/`.
+  // For Environment ID, "-" is reserved for 'draft' environment.
+  string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Optional. The developer-provided description for this environment.
+  // The maximum length is 500 characters. If exceeded, the request is rejected.
+  string description = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The agent version loaded into this environment.
+  // Format: `projects//agent/versions/`.
+  string agent_version = 3 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "dialogflow.googleapis.com/Version"
+    }
+  ];
+
+  // Output only. The state of this environment. This field is read-only, i.e., it cannot be
+  // set by create and update methods.
+  State state = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The last update time of this environment. This field is read-only, i.e., it
+  // cannot be set by create and update methods.
+  google.protobuf.Timestamp update_time = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// The request message for [Environments.ListEnvironments][google.cloud.dialogflow.v2beta1.Environments.ListEnvironments].
+message ListEnvironmentsRequest {
+  // Required. The agent to list all environments from.
+  // Format: `projects//agent`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "dialogflow.googleapis.com/Environment"
+    }
+  ];
+
+  // Optional. The maximum number of items to return in a single page. By default 100 and
+  // at most 1000.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The next_page_token value returned from a previous list request.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// The response message for [Environments.ListEnvironments][google.cloud.dialogflow.v2beta1.Environments.ListEnvironments].
+message ListEnvironmentsResponse {
+  // The list of agent environments. There will be a maximum number of items
+  // returned based on the page_size field in the request.
+  repeated Environment environments = 1;
+
+  // Token to retrieve the next page of results, or empty if there are no
+  // more results in the list.
+  string next_page_token = 2;
+}
diff --git a/third_party/googleapis/google/cloud/dialogflow/v2beta1/gcs.proto b/third_party/googleapis/google/cloud/dialogflow/v2beta1/gcs.proto
new file mode 100644
index 000000000..866b81cb0
--- /dev/null
+++ b/third_party/googleapis/google/cloud/dialogflow/v2beta1/gcs.proto
@@ -0,0 +1,36 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.dialogflow.v2beta1;
+
+import "google/api/annotations.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.Dialogflow.V2beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/dialogflow/v2beta1;dialogflow";
+option java_multiple_files = true;
+option java_outer_classname = "GcsProto";
+option java_package = "com.google.cloud.dialogflow.v2beta1";
+option objc_class_prefix = "DF";
+
+// Google Cloud Storage location for single input.
+message GcsSource {
+  // Required. The Google Cloud Storage URIs for the inputs. A URI is of the
+  // form:
+  //   gs://bucket/object-prefix-or-name
+  // Whether a prefix or name is used depends on the use case.
+  string uri = 1;
+}
diff --git a/third_party/googleapis/google/cloud/dialogflow/v2beta1/intent.proto b/third_party/googleapis/google/cloud/dialogflow/v2beta1/intent.proto
index ddd1234b1..1b1687262 100644
--- a/third_party/googleapis/google/cloud/dialogflow/v2beta1/intent.proto
+++ b/third_party/googleapis/google/cloud/dialogflow/v2beta1/intent.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,14 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.dialogflow.v2beta1;
 
 import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/dialogflow/v2beta1/audio_config.proto";
 import "google/cloud/dialogflow/v2beta1/context.proto";
 import "google/longrunning/operations.proto";
@@ -77,6 +78,9 @@ service Intents {
   rpc ListIntents(ListIntentsRequest) returns (ListIntentsResponse) {
     option (google.api.http) = {
       get: "/v2beta1/{parent=projects/*/agent}/intents"
+      additional_bindings {
+        get: "/v2beta1/{parent=projects/*/locations/*/agent}/intents"
+      }
     };
   }
 
@@ -84,6 +88,9 @@ service Intents {
   rpc GetIntent(GetIntentRequest) returns (Intent) {
     option (google.api.http) = {
       get: "/v2beta1/{name=projects/*/agent/intents/*}"
+      additional_bindings {
+        get: "/v2beta1/{name=projects/*/locations/*/agent/intents/*}"
+      }
     };
   }
 
@@ -92,6 +99,10 @@ service Intents {
     option (google.api.http) = {
       post: "/v2beta1/{parent=projects/*/agent}/intents"
       body: "intent"
+      additional_bindings {
+        post: "/v2beta1/{parent=projects/*/locations/*/agent}/intents"
+        body: "intent"
+      }
     };
   }
 
@@ -100,6 +111,10 @@ service Intents {
     option (google.api.http) = {
       patch: "/v2beta1/{intent.name=projects/*/agent/intents/*}"
       body: "intent"
+      additional_bindings {
+        patch: "/v2beta1/{intent.name=projects/*/locations/*/agent/intents/*}"
+        body: "intent"
+      }
     };
   }
 
@@ -107,6 +122,9 @@ service Intents {
   rpc DeleteIntent(DeleteIntentRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v2beta1/{name=projects/*/agent/intents/*}"
+      additional_bindings {
+        delete: "/v2beta1/{name=projects/*/locations/*/agent/intents/*}"
+      }
     };
   }
 
@@ -117,6 +135,10 @@ service Intents {
     option (google.api.http) = {
       post: "/v2beta1/{parent=projects/*/agent}/intents:batchUpdate"
       body: "*"
+      additional_bindings {
+        post: "/v2beta1/{parent=projects/*/locations/*/agent}/intents:batchUpdate"
+        body: "*"
+      }
     };
   }
 
@@ -127,6 +149,10 @@ service Intents {
     option (google.api.http) = {
       post: "/v2beta1/{parent=projects/*/agent}/intents:batchDelete"
       body: "*"
+      additional_bindings {
+        post: "/v2beta1/{parent=projects/*/locations/*/agent}/intents:batchDelete"
+        body: "*"
+      }
     };
   }
 }
@@ -135,6 +161,12 @@ service Intents {
 // Intents convert a number of user expressions or patterns into an action. An
 // action is an extraction of a user command or sentence semantics.
 message Intent {
+  option (google.api.resource) = {
+    type: "dialogflow.googleapis.com/Intent"
+    pattern: "projects/{project}/agent/intents/{intent}"
+    pattern: "projects/{project}/locations/{location}/agent/intents/{intent}"
+  };
+
   // Represents an example that the agent is trained on.
   message TrainingPhrase {
     // Represents a part of a training phrase.
@@ -404,6 +436,9 @@ message Intent {
 
       // Required. List items.
       repeated Item items = 2;
+
+      // Optional. Subtitle of the list.
+      string subtitle = 3 [(google.api.field_behavior) = OPTIONAL];
     }
 
     // The card for presenting a carousel of options to select from.
@@ -574,21 +609,21 @@ message Intent {
       // Rich Business Messaging (RBM) Media displayed in Cards
       // The following media-types are currently supported:
       //
-      // ## Image Types
+      // Image Types
       //
-      //  image/jpeg
-      //  image/jpg'
-      //  image/gif
-      //  image/png
+      // * image/jpeg
+      // * image/jpg'
+      // * image/gif
+      // * image/png
       //
-      // ## Video Types
+      // Video Types
       //
-      //  video/h263
-      //  video/m4v
-      //  video/mp4
-      //  video/mpeg
-      //  video/mpeg4
-      //  video/webm
+      // * video/h263
+      // * video/m4v
+      // * video/mp4
+      // * video/mpeg
+      // * video/mpeg4
+      // * video/webm
       message RbmMedia {
         // Media height
         enum Height {
@@ -719,6 +754,189 @@ message Intent {
       }
     }
 
+    // The media content card for Actions on Google.
+    message MediaContent {
+      // Response media object for media content card.
+      message ResponseMediaObject {
+        // Required. Name of media card.
+        string name = 1;
+
+        // Optional. Description of media card.
+        string description = 2;
+
+        // Image to show with the media card.
+        oneof image {
+          // Optional. Image to display above media content.
+          Image large_image = 3;
+
+          // Optional. Icon to display above media content.
+          Image icon = 4;
+        }
+
+        // Required. Url where the media is stored.
+        string content_url = 5;
+      }
+
+      // Format of response media type.
+      enum ResponseMediaType {
+        // Unspecified.
+        RESPONSE_MEDIA_TYPE_UNSPECIFIED = 0;
+
+        // Response media type is audio.
+        AUDIO = 1;
+      }
+
+      // Optional. What type of media is the content (ie "audio").
+      ResponseMediaType media_type = 1;
+
+      // Required. List of media objects.
+      repeated ResponseMediaObject media_objects = 2;
+    }
+
+    // Browse Carousel Card for Actions on Google.
+    // https://developers.google.com/actions/assistant/responses#browsing_carousel
+    message BrowseCarouselCard {
+      // Browsing carousel tile
+      message BrowseCarouselCardItem {
+        // Actions on Google action to open a given url.
+        message OpenUrlAction {
+          // Type of the URI.
+          enum UrlTypeHint {
+            // Unspecified
+            URL_TYPE_HINT_UNSPECIFIED = 0;
+
+            // Url would be an amp action
+            AMP_ACTION = 1;
+
+            // URL that points directly to AMP content, or to a canonical URL
+            // which refers to AMP content via .
+            AMP_CONTENT = 2;
+          }
+
+          // Required. URL
+          string url = 1;
+
+          // Optional. Specifies the type of viewer that is used when opening
+          // the URL. Defaults to opening via web browser.
+          UrlTypeHint url_type_hint = 3;
+        }
+
+        // Required. Action to present to the user.
+        OpenUrlAction open_uri_action = 1;
+
+        // Required. Title of the carousel item. Maximum of two lines of text.
+        string title = 2;
+
+        // Optional. Description of the carousel item. Maximum of four lines of
+        // text.
+        string description = 3;
+
+        // Optional. Hero image for the carousel item.
+        Image image = 4;
+
+        // Optional. Text that appears at the bottom of the Browse Carousel
+        // Card. Maximum of one line of text.
+        string footer = 5;
+      }
+
+      // Image display options for Actions on Google. This should be used for
+      // when the image's aspect ratio does not match the image container's
+      // aspect ratio.
+      enum ImageDisplayOptions {
+        // Fill the gaps between the image and the image container with gray
+        // bars.
+        IMAGE_DISPLAY_OPTIONS_UNSPECIFIED = 0;
+
+        // Fill the gaps between the image and the image container with gray
+        // bars.
+        GRAY = 1;
+
+        // Fill the gaps between the image and the image container with white
+        // bars.
+        WHITE = 2;
+
+        // Image is scaled such that the image width and height match or exceed
+        // the container dimensions. This may crop the top and bottom of the
+        // image if the scaled image height is greater than the container
+        // height, or crop the left and right of the image if the scaled image
+        // width is greater than the container width. This is similar to "Zoom
+        // Mode" on a widescreen TV when playing a 4:3 video.
+        CROPPED = 3;
+
+        // Pad the gaps between image and image frame with a blurred copy of the
+        // same image.
+        BLURRED_BACKGROUND = 4;
+      }
+
+      // Required. List of items in the Browse Carousel Card. Minimum of two
+      // items, maximum of ten.
+      repeated BrowseCarouselCardItem items = 1;
+
+      // Optional. Settings for displaying the image. Applies to every image in
+      // [items][google.cloud.dialogflow.v2beta1.Intent.Message.BrowseCarouselCard.items].
+      ImageDisplayOptions image_display_options = 2;
+    }
+
+    // Table card for Actions on Google.
+    message TableCard {
+      // Required. Title of the card.
+      string title = 1;
+
+      // Optional. Subtitle to the title.
+      string subtitle = 2;
+
+      // Optional. Image which should be displayed on the card.
+      Image image = 3;
+
+      // Optional. Display properties for the columns in this table.
+      repeated ColumnProperties column_properties = 4;
+
+      // Optional. Rows in this table of data.
+      repeated TableCardRow rows = 5;
+
+      // Optional. List of buttons for the card.
+      repeated BasicCard.Button buttons = 6;
+    }
+
+    // Column properties for [TableCard][google.cloud.dialogflow.v2beta1.Intent.Message.TableCard].
+    message ColumnProperties {
+      // Text alignments within a cell.
+      enum HorizontalAlignment {
+        // Text is aligned to the leading edge of the column.
+        HORIZONTAL_ALIGNMENT_UNSPECIFIED = 0;
+
+        // Text is aligned to the leading edge of the column.
+        LEADING = 1;
+
+        // Text is centered in the column.
+        CENTER = 2;
+
+        // Text is aligned to the trailing edge of the column.
+        TRAILING = 3;
+      }
+
+      // Required. Column heading.
+      string header = 1;
+
+      // Optional. Defines text alignment for all cells in this column.
+      HorizontalAlignment horizontal_alignment = 2;
+    }
+
+    // Row of [TableCard][google.cloud.dialogflow.v2beta1.Intent.Message.TableCard].
+    message TableCardRow {
+      // Optional. List of cells that make up this row.
+      repeated TableCardCell cells = 1;
+
+      // Optional. Whether to add a visual divider after this row.
+      bool divider_after = 2;
+    }
+
+    // Cell of [TableCardRow][google.cloud.dialogflow.v2beta1.Intent.Message.TableCardRow].
+    message TableCardCell {
+      // Required. Text in this cell.
+      string text = 1;
+    }
+
     // Represents different platforms that a rich message can be intended for.
     enum Platform {
       // Not specified.
@@ -745,67 +963,9 @@ message Intent {
       // Viber.
       VIBER = 7;
 
-      // Actions on Google.
-      // When using Actions on Google, you can choose one of the specific
-      // Intent.Message types that mention support for Actions on Google,
-      // or you can use the advanced Intent.Message.payload field.
-      // The payload field provides access to AoG features not available in the
-      // specific message types.
-      // If using the Intent.Message.payload field, it should have a structure
-      // similar to the JSON message shown here. For more information, see
-      // [Actions on Google Webhook
-      // Format](https://developers.google.com/actions/dialogflow/webhook)
-      // 
{
-      //   "expectUserResponse": true,
-      //   "isSsml": false,
-      //   "noInputPrompts": [],
-      //   "richResponse": {
-      //     "items": [
-      //       {
-      //         "simpleResponse": {
-      //           "displayText": "hi",
-      //           "textToSpeech": "hello"
-      //         }
-      //       }
-      //     ],
-      //     "suggestions": [
-      //       {
-      //         "title": "Say this"
-      //       },
-      //       {
-      //         "title": "or this"
-      //       }
-      //     ]
-      //   },
-      //   "systemIntent": {
-      //     "data": {
-      //       "@type": "type.googleapis.com/google.actions.v2.OptionValueSpec",
-      //       "listSelect": {
-      //         "items": [
-      //           {
-      //             "optionInfo": {
-      //               "key": "key1",
-      //               "synonyms": [
-      //                 "key one"
-      //               ]
-      //             },
-      //             "title": "must not be empty, but unique"
-      //           },
-      //           {
-      //             "optionInfo": {
-      //               "key": "key2",
-      //               "synonyms": [
-      //                 "key two"
-      //               ]
-      //             },
-      //             "title": "must not be empty, but unique"
-      //           }
-      //         ]
-      //       }
-      //     },
-      //     "intent": "actions.intent.OPTION"
-      //   }
-      // }

+      // Google Assistant
+      // See [Dialogflow webhook
+      // format](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)
       ACTIONS_ON_GOOGLE = 8;
 
       // Telephony Gateway.
@@ -829,9 +989,7 @@ message Intent {
       // Displays a card.
       Card card = 4;
 
-      // Returns a response containing a custom, platform-specific payload.
-      // See the Intent.Message.Platform type for a description of the
-      // structure that may be required for your platform.
+      // A custom platform-specific response.
       google.protobuf.Struct payload = 5;
 
       // Returns a voice or text-only response for Actions on Google.
@@ -872,6 +1030,15 @@ message Intent {
 
       // Rich Business Messaging (RBM) carousel rich card response.
       RbmCarouselCard rbm_carousel_rich_card = 20;
+
+      // Browse carousel card for Actions on Google.
+      BrowseCarouselCard browse_carousel_card = 22;
+
+      // Table card for Actions on Google.
+      TableCard table_card = 23;
+
+      // The media content card for Actions on Google.
+      MediaContent media_content = 24;
     }
 
     // Optional. The platform that this message is intended for.
@@ -914,11 +1081,14 @@ message Intent {
   // Optional. Indicates whether webhooks are enabled for the intent.
   WebhookState webhook_state = 6;
 
-  // Optional. The priority of this intent. Higher numbers represent higher
-  // priorities. If this is zero or unspecified, we use the default
-  // priority 500000.
+  // The priority of this intent. Higher numbers represent higher
+  // priorities.
   //
-  // Negative numbers mean that the intent is disabled.
+  // - If the supplied value is unspecified or 0, the service
+  //   translates the value to 500,000, which corresponds to the
+  //   `Normal` priority in the console.
+  // - If the supplied value is negative, the intent is ignored
+  //   in runtime detect intent requests.
   int32 priority = 3;
 
   // Optional. Indicates whether this is a fallback intent.
@@ -956,6 +1126,7 @@ message Intent {
   // Optional. The collection of event names that trigger the intent.
   // If the collection of input contexts is not empty, all of the contexts must
   // be present in the active user session for an event to trigger this intent.
+  // Event names are limited to 150 characters.
   repeated string events = 8;
 
   // Optional. The collection of examples that the agent is
@@ -997,8 +1168,9 @@ message Intent {
 
   // Read-only after creation. The unique identifier of the parent intent in the
   // chain of followup intents. You can set this field when creating an intent,
-  // for example with [CreateIntent][] or [BatchUpdateIntents][], in order to
-  // make this intent a followup intent.
+  // for example with [CreateIntent][google.cloud.dialogflow.v2beta1.Intents.CreateIntent] or
+  // [BatchUpdateIntents][google.cloud.dialogflow.v2beta1.Intents.BatchUpdateIntents], in order to make this
+  // intent a followup intent.
   //
   // It identifies the parent followup intent.
   // Format: `projects//agent/intents/`.
@@ -1015,13 +1187,12 @@ message ListIntentsRequest {
   // Format: `projects//agent`.
   string parent = 1;
 
-  // Optional. The language to list training phrases, parameters and rich
-  // messages for. If not specified, the agent's default language is used.
-  // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
-  // are supported. Note: languages must be enabled in the agent before they can
-  // be used.
-  string language_code = 2;
+  // Optional. The language used to access language-specific data.
+  // If not specified, the agent's default language is used.
+  // For more information, see
+  // [Multilingual intent and entity
+  // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
+  string language_code = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The resource view to apply to the returned intent.
   IntentView intent_view = 3;
@@ -1051,13 +1222,12 @@ message GetIntentRequest {
   // Format: `projects//agent/intents/`.
   string name = 1;
 
-  // Optional. The language to retrieve training phrases, parameters and rich
-  // messages for. If not specified, the agent's default language is used.
-  // [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
-  // are supported. Note: languages must be enabled in the agent before they can
-  // be used.
-  string language_code = 2;
+  // Optional. The language used to access language-specific data.
+  // If not specified, the agent's default language is used.
+  // For more information, see
+  // [Multilingual intent and entity
+  // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
+  string language_code = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The resource view to apply to the returned intent.
   IntentView intent_view = 3;
@@ -1072,13 +1242,12 @@ message CreateIntentRequest {
   // Required. The intent to create.
   Intent intent = 2;
 
-  // Optional. The language of training phrases, parameters and rich messages
-  // defined in `intent`. If not specified, the agent's default language is
-  // used. [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
-  // are supported. Note: languages must be enabled in the agent before they can
-  // be used.
-  string language_code = 3;
+  // Optional. The language used to access language-specific data.
+  // If not specified, the agent's default language is used.
+  // For more information, see
+  // [Multilingual intent and entity
+  // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
+  string language_code = 3 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The resource view to apply to the returned intent.
   IntentView intent_view = 4;
@@ -1089,13 +1258,12 @@ message UpdateIntentRequest {
   // Required. The intent to update.
   Intent intent = 1;
 
-  // Optional. The language of training phrases, parameters and rich messages
-  // defined in `intent`. If not specified, the agent's default language is
-  // used. [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
-  // are supported. Note: languages must be enabled in the agent before they can
-  // be used.
-  string language_code = 2;
+  // Optional. The language used to access language-specific data.
+  // If not specified, the agent's default language is used.
+  // For more information, see
+  // [Multilingual intent and entity
+  // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
+  string language_code = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The mask to control which fields get updated.
   google.protobuf.FieldMask update_mask = 3;
@@ -1120,6 +1288,11 @@ message BatchUpdateIntentsRequest {
   string parent = 1;
 
   // Required. The source of the intent batch.
+  //
+  // For each intent in the batch:
+  //
+  // *    If `name` is specified, we update an existing intent.
+  // *    If `name` is not specified, we create a new intent.
   oneof intent_batch {
     // The URI to a Google Cloud Storage file containing intents to update or
     // create. The file format can either be a serialized proto (of IntentBatch
@@ -1130,13 +1303,12 @@ message BatchUpdateIntentsRequest {
     IntentBatch intent_batch_inline = 3;
   }
 
-  // Optional. The language of training phrases, parameters and rich messages
-  // defined in `intents`. If not specified, the agent's default language is
-  // used. [Many
-  // languages](https://cloud.google.com/dialogflow/docs/reference/language)
-  // are supported. Note: languages must be enabled in the agent before they can
-  // be used.
-  string language_code = 4;
+  // Optional. The language used to access language-specific data.
+  // If not specified, the agent's default language is used.
+  // For more information, see
+  // [Multilingual intent and entity
+  // data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-entity).
+  string language_code = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The mask to control which fields get updated.
   google.protobuf.FieldMask update_mask = 5;
diff --git a/third_party/googleapis/google/cloud/dialogflow/v2beta1/knowledge_base.proto b/third_party/googleapis/google/cloud/dialogflow/v2beta1/knowledge_base.proto
index ce992dde4..fa6d32698 100644
--- a/third_party/googleapis/google/cloud/dialogflow/v2beta1/knowledge_base.proto
+++ b/third_party/googleapis/google/cloud/dialogflow/v2beta1/knowledge_base.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -122,6 +121,11 @@ message KnowledgeBase {
   // Required. The display name of the knowledge base. The name must be 1024
   // bytes or less; otherwise, the creation request fails.
   string display_name = 2;
+
+  // Language which represents the KnowledgeBase. When the KnowledgeBase is
+  // created/updated, this is populated for all non en-us languages. If not
+  // populated, the default language en-us applies.
+  string language_code = 4;
 }
 
 // Request message for [KnowledgeBases.ListKnowledgeBases][google.cloud.dialogflow.v2beta1.KnowledgeBases.ListKnowledgeBases].
@@ -148,7 +152,7 @@ message ListKnowledgeBasesResponse {
   string next_page_token = 2;
 }
 
-// Request message for [KnowledgeBase.GetDocument][].
+// Request message for [KnowledgeBases.GetKnowledgeBase][google.cloud.dialogflow.v2beta1.KnowledgeBases.GetKnowledgeBase].
 message GetKnowledgeBaseRequest {
   // Required. The name of the knowledge base to retrieve.
   // Format `projects//knowledgeBases/`.
diff --git a/third_party/googleapis/google/cloud/dialogflow/v2beta1/session.proto b/third_party/googleapis/google/cloud/dialogflow/v2beta1/session.proto
index 8d0f91f45..ae25c967d 100644
--- a/third_party/googleapis/google/cloud/dialogflow/v2beta1/session.proto
+++ b/third_party/googleapis/google/cloud/dialogflow/v2beta1/session.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,19 +11,21 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.dialogflow.v2beta1;
 
 import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/dialogflow/v2beta1/agent.proto";
 import "google/cloud/dialogflow/v2beta1/audio_config.proto";
 import "google/cloud/dialogflow/v2beta1/context.proto";
 import "google/cloud/dialogflow/v2beta1/intent.proto";
 import "google/cloud/dialogflow/v2beta1/session_entity_type.proto";
 import "google/protobuf/duration.proto";
+import "google/protobuf/field_mask.proto";
 import "google/protobuf/struct.proto";
 import "google/rpc/status.proto";
 import "google/type/latlng.proto";
@@ -36,6 +38,11 @@ option java_multiple_files = true;
 option java_outer_classname = "SessionProto";
 option java_package = "com.google.cloud.dialogflow.v2beta1";
 option objc_class_prefix = "DF";
+option (google.api.resource_definition) = {
+  type: "dialogflow.googleapis.com/Session"
+  pattern: "projects/{project}/locations/{location}/agent/sessions/{session}"
+  pattern: "projects/{project}/agent/sessions/{session}"
+};
 
 // A session represents an interaction with a user. You retrieve user input
 // and pass it to the [DetectIntent][google.cloud.dialogflow.v2beta1.Sessions.DetectIntent] (or
@@ -59,6 +66,14 @@ service Sessions {
         post: "/v2beta1/{session=projects/*/agent/environments/*/users/*/sessions/*}:detectIntent"
         body: "*"
       }
+      additional_bindings {
+        post: "/v2beta1/{session=projects/*/locations/*/agent/sessions/*}:detectIntent"
+        body: "*"
+      }
+      additional_bindings {
+        post: "/v2beta1/{session=projects/*/locations/*/agent/environments/*/users/*/sessions/*}:detectIntent"
+        body: "*"
+      }
     };
   }
 
@@ -80,9 +95,11 @@ message DetectIntentRequest {
   // `User Id`. They can be a random number or some type of user and session
   // identifiers (preferably hashed). The length of the `Session ID` and
   // `User ID` must not exceed 36 characters.
-  string session = 1;
+  string session = 1 [(google.api.resource_reference) = {
+                        type: "dialogflow.googleapis.com/Session"
+                      }];
 
-  // Optional. The parameters of this query.
+  // The parameters of this query.
   QueryParameters query_params = 2;
 
   // Required. The input specification. It can be set to:
@@ -95,12 +112,20 @@ message DetectIntentRequest {
   // 3.  an event that specifies which intent to trigger.
   QueryInput query_input = 3;
 
-  // Optional. Instructs the speech synthesizer how to generate the output
+  // Instructs the speech synthesizer how to generate the output
   // audio. If this field is not set and agent-level speech synthesizer is not
   // configured, no output audio is generated.
   OutputAudioConfig output_audio_config = 4;
 
-  // Optional. The natural language speech audio to be processed. This field
+  // Mask for [output_audio_config][google.cloud.dialogflow.v2beta1.DetectIntentRequest.output_audio_config] indicating which settings in this
+  // request-level config should override speech synthesizer settings defined at
+  // agent-level.
+  //
+  // If unspecified or empty, [output_audio_config][google.cloud.dialogflow.v2beta1.DetectIntentRequest.output_audio_config] replaces the agent-level
+  // config in its entirety.
+  google.protobuf.FieldMask output_audio_config_mask = 7;
+
+  // The natural language speech audio to be processed. This field
   // should be populated iff `query_input` is set to an input audio config.
   // A single request can contain up to 1 minute of speech audio data.
   bytes input_audio = 5;
@@ -143,42 +168,61 @@ message DetectIntentResponse {
 
 // Represents the parameters of the conversational query.
 message QueryParameters {
-  // Optional. The time zone of this conversational query from the
+  // The time zone of this conversational query from the
   // [time zone database](https://www.iana.org/time-zones), e.g.,
   // America/New_York, Europe/Paris. If not provided, the time zone specified in
   // agent settings is used.
   string time_zone = 1;
 
-  // Optional. The geo location of this conversational query.
+  // The geo location of this conversational query.
   google.type.LatLng geo_location = 2;
 
-  // Optional. The collection of contexts to be activated before this query is
+  // The collection of contexts to be activated before this query is
   // executed.
   repeated Context contexts = 3;
 
-  // Optional. Specifies whether to delete all contexts in the current session
+  // Specifies whether to delete all contexts in the current session
   // before the new ones are activated.
   bool reset_contexts = 4;
 
-  // Optional. Additional session entity types to replace or extend developer
+  // Additional session entity types to replace or extend developer
   // entity types with. The entity synonyms apply to all languages and persist
   // for the session of this query.
   repeated SessionEntityType session_entity_types = 5;
 
-  // Optional. This field can be used to pass custom data into the webhook
-  // associated with the agent. Arbitrary JSON objects are supported.
+  // This field can be used to pass custom data to your webhook.
+  // Arbitrary JSON objects are supported.
+  // If supplied, the value is used to populate the
+  // `WebhookRequest.original_detect_intent_request.payload`
+  // field sent to your webhook.
   google.protobuf.Struct payload = 6;
 
-  // Optional. KnowledgeBases to get alternative results from. If not set, the
+  // KnowledgeBases to get alternative results from. If not set, the
   // KnowledgeBases enabled in the agent (through UI) will be used.
   // Format:  `projects//knowledgeBases/`.
   repeated string knowledge_base_names = 12;
 
-  // Optional. Configures the type of sentiment analysis to perform. If not
+  // Configures the type of sentiment analysis to perform. If not
   // provided, sentiment analysis is not performed.
   // Note: Sentiment Analysis is only currently available for Enterprise Edition
   // agents.
   SentimentAnalysisRequestConfig sentiment_analysis_request_config = 10;
+
+  // For mega agent query, directly specify which sub agents to query.
+  // If any specified sub agent is not linked to the mega agent, an error will
+  // be returned. If empty, Dialogflow will decide which sub agents to query.
+  // If specified for a non-mega-agent query, will be silently ignored.
+  repeated SubAgent sub_agents = 13;
+
+  // This field can be used to pass HTTP headers for a webhook
+  // call. These headers will be sent to webhook alone with the headers that
+  // have been configured through Dialogflow web console. The headers defined
+  // within this field will overwrite the headers configured through Dialogflow
+  // console if there is a conflict. Header names are case-insensitive.
+  // Google's specified headers are not allowed. Including: "Host",
+  // "Content-Length", "Connection", "From", "User-Agent", "Accept-Encoding",
+  // "If-Modified-Since", "If-None-Match", "X-Forwarded-For", etc.
+  map webhook_headers = 14;
 }
 
 // Represents the query input. It can contain either:
@@ -237,6 +281,20 @@ message QueryResult {
   string action = 3;
 
   // The collection of extracted parameters.
+  //
+  // Depending on your protocol or client library language, this is a
+  // map, associative array, symbol table, dictionary, or JSON object
+  // composed of a collection of (MapKey, MapValue) pairs:
+  //
+  // -   MapKey type: string
+  // -   MapKey value: parameter name
+  // -   MapValue type:
+  //     -   If parameter's entity type is a composite entity: map
+  //     -   Else: string or number, depending on parameter value type
+  // -   MapValue value:
+  //     -   If parameter's entity type is a composite entity:
+  //         map from composite entity property names to property values
+  //     -   Else: parameter value
   google.protobuf.Struct parameters = 4;
 
   // This field is set to:
@@ -270,7 +328,7 @@ message QueryResult {
 
   // The intent that matched the conversational query. Some, not
   // all fields are filled in this message, including but not limited to:
-  // `name`, `display_name` and `webhook_state`.
+  // `name`, `display_name`, `end_interaction` and `is_fallback`.
   Intent intent = 11;
 
   // The intent detection confidence. Values range from 0.0
@@ -283,9 +341,13 @@ message QueryResult {
   // the greatest `knowledgeAnswers.match_confidence` value in the list.
   float intent_detection_confidence = 12;
 
-  // The free-form diagnostic info. For example, this field could contain
-  // webhook call latency. The string keys of the Struct's fields map can change
-  // without notice.
+  // Free-form diagnostic information for the associated detect intent request.
+  // The fields of this data can change without notice, so you should not write
+  // code that depends on its structure.
+  // The data may contain:
+  //
+  // - webhook call latency
+  // - webhook errors
   google.protobuf.Struct diagnostic_info = 14;
 
   // The sentiment analysis result, which depends on the
@@ -320,7 +382,9 @@ message KnowledgeAnswers {
     // Indicates which Knowledge Document this answer was extracted from.
     // Format: `projects//knowledgeBases//documents/`.
-    string source = 1;
+    string source = 1 [(google.api.resource_reference) = {
+                         type: "dialogflow.googleapis.com/Document"
+                       }];
 
     // The corresponding FAQ question if the answer was extracted from a FAQ
     // Document, empty otherwise.
@@ -354,16 +418,35 @@ message KnowledgeAnswers {
 }
 
 // The top-level message sent by the client to the
-// `StreamingDetectIntent` method.
+// [Sessions.StreamingDetectIntent][google.cloud.dialogflow.v2beta1.Sessions.StreamingDetectIntent] method.
 //
 // Multiple request messages should be sent in order:
 //
-// 1.  The first message must contain `session`, `query_input` plus optionally
-//     `query_params`. If the client wants to receive an audio response, it
-//     should also contain `output_audio_config`. The message must not contain
-//     `input_audio`.
-// 2.  If `query_input` was set to a streaming input audio config,
-//     all subsequent messages must contain `input_audio`. Otherwise, finish the request stream.
+// 1.  The first message must contain
+// [session][google.cloud.dialogflow.v2beta1.StreamingDetectIntentRequest.session],
+//     [query_input][google.cloud.dialogflow.v2beta1.StreamingDetectIntentRequest.query_input] plus optionally
+//     [query_params][google.cloud.dialogflow.v2beta1.StreamingDetectIntentRequest.query_params]. If the client
+//     wants to receive an audio response, it should also contain
+//     [output_audio_config][google.cloud.dialogflow.v2beta1.StreamingDetectIntentRequest.output_audio_config].
+//     The message must not contain
+//     [input_audio][google.cloud.dialogflow.v2beta1.StreamingDetectIntentRequest.input_audio].
+// 2.  If [query_input][google.cloud.dialogflow.v2beta1.StreamingDetectIntentRequest.query_input] was set to
+//     [query_input.audio_config][google.cloud.dialogflow.v2beta1.InputAudioConfig], all subsequent
+//     messages must contain
+//     [input_audio][google.cloud.dialogflow.v2beta1.StreamingDetectIntentRequest.input_audio] to continue with
+//     Speech recognition.
+//     If you decide to rather detect an intent from text input after you
+//     already started Speech recognition, please send a message with
+//     [query_input.text][google.cloud.dialogflow.v2beta1.QueryInput.text].
+//
+//     However, note that:
+//
+//     * Dialogflow will bill you for the audio duration so far.
+//     * Dialogflow discards all Speech recognition results in favor of the
+//       input text.
+//     * Dialogflow will use the language code from the first message.
+//
+// After you sent all input, you must half-close or abort the request stream.
 message StreamingDetectIntentRequest {
   // Required. The name of the session the query is sent to.
   // Format of the session name:
@@ -377,7 +460,7 @@ message StreamingDetectIntentRequest {
   // `User ID` must not exceed 36 characters.
   string session = 1;
 
-  // Optional. The parameters of this query.
+  // The parameters of this query.
   QueryParameters query_params = 2;
 
   // Required. The input specification. It can be set to:
@@ -391,7 +474,7 @@ message StreamingDetectIntentRequest {
   QueryInput query_input = 3;
 
   // DEPRECATED. Please use [InputAudioConfig.single_utterance][google.cloud.dialogflow.v2beta1.InputAudioConfig.single_utterance] instead.
-  // Optional. If `false` (default), recognition does not cease until the
+  // If `false` (default), recognition does not cease until the
   // client closes the stream.
   // If `true`, the recognizer will detect a single spoken utterance in input
   // audio. Recognition ceases when it detects the audio's voice has
@@ -401,12 +484,20 @@ message StreamingDetectIntentRequest {
   // This setting is ignored when `query_input` is a piece of text or an event.
   bool single_utterance = 4;
 
-  // Optional. Instructs the speech synthesizer how to generate the output
+  // Instructs the speech synthesizer how to generate the output
   // audio. If this field is not set and agent-level speech synthesizer is not
   // configured, no output audio is generated.
   OutputAudioConfig output_audio_config = 5;
 
-  // Optional. The input audio content to be recognized. Must be sent if
+  // Mask for [output_audio_config][google.cloud.dialogflow.v2beta1.StreamingDetectIntentRequest.output_audio_config] indicating which settings in this
+  // request-level config should override speech synthesizer settings defined at
+  // agent-level.
+  //
+  // If unspecified or empty, [output_audio_config][google.cloud.dialogflow.v2beta1.StreamingDetectIntentRequest.output_audio_config] replaces the agent-level
+  // config in its entirety.
+  google.protobuf.FieldMask output_audio_config_mask = 7;
+
+  // The input audio content to be recognized. Must be sent if
   // `query_input` was set to a streaming input audio config. The complete audio
   // over all streaming messages must not exceed 1 minute.
   bytes input_audio = 6;
@@ -581,7 +672,21 @@ message EventInput {
   // Required. The unique identifier of the event.
   string name = 1;
 
-  // Optional. The collection of parameters associated with the event.
+  // The collection of parameters associated with the event.
+  //
+  // Depending on your protocol or client library language, this is a
+  // map, associative array, symbol table, dictionary, or JSON object
+  // composed of a collection of (MapKey, MapValue) pairs:
+  //
+  // -   MapKey type: string
+  // -   MapKey value: parameter name
+  // -   MapValue type:
+  //     -   If parameter's entity type is a composite entity: map
+  //     -   Else: string or number, depending on parameter value type
+  // -   MapValue value:
+  //     -   If parameter's entity type is a composite entity:
+  //         map from composite entity property names to property values
+  //     -   Else: parameter value
   google.protobuf.Struct parameters = 2;
 
   // Required. The language of this query. See [Language
@@ -593,7 +698,7 @@ message EventInput {
 
 // Configures the types of sentiment analysis to perform.
 message SentimentAnalysisRequestConfig {
-  // Optional. Instructs the service to perform sentiment analysis on
+  // Instructs the service to perform sentiment analysis on
   // `query_text`. If not provided, sentiment analysis is not performed on
   // `query_text`.
   bool analyze_query_text_sentiment = 1;
diff --git a/third_party/googleapis/google/cloud/dialogflow/v2beta1/session_entity_type.proto b/third_party/googleapis/google/cloud/dialogflow/v2beta1/session_entity_type.proto
index a8bd153e4..90b8849a6 100644
--- a/third_party/googleapis/google/cloud/dialogflow/v2beta1/session_entity_type.proto
+++ b/third_party/googleapis/google/cloud/dialogflow/v2beta1/session_entity_type.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -41,6 +40,10 @@ option objc_class_prefix = "DF";
 // favorites, preferences, playlists, and so on. You can redefine a session
 // entity type at the session level.
 //
+// Session entity methods do not work with Google Assistant integration.
+// Contact Dialogflow support if you need to use session entities
+// with Google Assistant integration.
+//
 // For more information about entity types, see the
 // [Dialogflow
 // documentation](https://cloud.google.com/dialogflow/docs/entities-overview).
@@ -51,22 +54,42 @@ service SessionEntityTypes {
       "https://www.googleapis.com/auth/dialogflow";
 
   // Returns the list of all session entity types in the specified session.
+  //
+  // This method doesn't work with Google Assistant integration.
+  // Contact Dialogflow support if you need to use session entities
+  // with Google Assistant integration.
   rpc ListSessionEntityTypes(ListSessionEntityTypesRequest) returns (ListSessionEntityTypesResponse) {
     option (google.api.http) = {
       get: "/v2beta1/{parent=projects/*/agent/sessions/*}/entityTypes"
       additional_bindings {
         get: "/v2beta1/{parent=projects/*/agent/environments/*/users/*/sessions/*}/entityTypes"
       }
+      additional_bindings {
+        get: "/v2beta1/{parent=projects/*/locations/*/agent/sessions/*}/entityTypes"
+      }
+      additional_bindings {
+        get: "/v2beta1/{parent=projects/*/locations/*/agent/environments/*/users/*/sessions/*}/entityTypes"
+      }
     };
   }
 
   // Retrieves the specified session entity type.
+  //
+  // This method doesn't work with Google Assistant integration.
+  // Contact Dialogflow support if you need to use session entities
+  // with Google Assistant integration.
   rpc GetSessionEntityType(GetSessionEntityTypeRequest) returns (SessionEntityType) {
     option (google.api.http) = {
       get: "/v2beta1/{name=projects/*/agent/sessions/*/entityTypes/*}"
       additional_bindings {
         get: "/v2beta1/{name=projects/*/agent/environments/*/users/*/sessions/*/entityTypes/*}"
       }
+      additional_bindings {
+        get: "/v2beta1/{name=projects/*/locations/*/agent/sessions/*/entityTypes/*}"
+      }
+      additional_bindings {
+        get: "/v2beta1/{name=projects/*/locations/*/agent/environments/*/users/*/sessions/*/entityTypes/*}"
+      }
     };
   }
 
@@ -74,6 +97,10 @@ service SessionEntityTypes {
   //
   // If the specified session entity type already exists, overrides the
   // session entity type.
+  //
+  // This method doesn't work with Google Assistant integration.
+  // Contact Dialogflow support if you need to use session entities
+  // with Google Assistant integration.
   rpc CreateSessionEntityType(CreateSessionEntityTypeRequest) returns (SessionEntityType) {
     option (google.api.http) = {
       post: "/v2beta1/{parent=projects/*/agent/sessions/*}/entityTypes"
@@ -82,10 +109,22 @@ service SessionEntityTypes {
         post: "/v2beta1/{parent=projects/*/agent/environments/*/users/*/sessions/*}/entityTypes"
         body: "session_entity_type"
       }
+      additional_bindings {
+        post: "/v2beta1/{parent=projects/*/locations/*/agent/sessions/*}/entityTypes"
+        body: "session_entity_type"
+      }
+      additional_bindings {
+        post: "/v2beta1/{parent=projects/*/locations/*/agent/environments/*/users/*/sessions/*}/entityTypes"
+        body: "session_entity_type"
+      }
     };
   }
 
   // Updates the specified session entity type.
+  //
+  // This method doesn't work with Google Assistant integration.
+  // Contact Dialogflow support if you need to use session entities
+  // with Google Assistant integration.
   rpc UpdateSessionEntityType(UpdateSessionEntityTypeRequest) returns (SessionEntityType) {
     option (google.api.http) = {
       patch: "/v2beta1/{session_entity_type.name=projects/*/agent/sessions/*/entityTypes/*}"
@@ -94,24 +133,42 @@ service SessionEntityTypes {
         patch: "/v2beta1/{session_entity_type.name=projects/*/agent/environments/*/users/*/sessions/*/entityTypes/*}"
         body: "session_entity_type"
       }
+      additional_bindings {
+        patch: "/v2beta1/{session_entity_type.name=projects/*/locations/*/agent/sessions/*/entityTypes/*}"
+        body: "session_entity_type"
+      }
+      additional_bindings {
+        patch: "/v2beta1/{session_entity_type.name=projects/*/locations/*/agent/environments/*/users/*/sessions/*/entityTypes/*}"
+        body: "session_entity_type"
+      }
     };
   }
 
   // Deletes the specified session entity type.
+  //
+  // This method doesn't work with Google Assistant integration.
+  // Contact Dialogflow support if you need to use session entities
+  // with Google Assistant integration.
   rpc DeleteSessionEntityType(DeleteSessionEntityTypeRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v2beta1/{name=projects/*/agent/sessions/*/entityTypes/*}"
       additional_bindings {
         delete: "/v2beta1/{name=projects/*/agent/environments/*/users/*/sessions/*/entityTypes/*}"
       }
+      additional_bindings {
+        delete: "/v2beta1/{name=projects/*/locations/*/agent/sessions/*/entityTypes/*}"
+      }
+      additional_bindings {
+        delete: "/v2beta1/{name=projects/*/locations/*/agent/environments/*/users/*/sessions/*/entityTypes/*}"
+      }
     };
   }
 }
 
 // Represents a session entity type.
 //
-// Extends or replaces a developer entity type at the user session level (we
-// refer to the entity types defined at the agent level as "developer entity
+// Extends or replaces a custom entity type at the user session level (we
+// refer to the entity types defined at the agent level as "custom entity
 // types").
 //
 // Note: session entity types apply to all queries, regardless of the language.
@@ -122,17 +179,17 @@ message SessionEntityType {
     ENTITY_OVERRIDE_MODE_UNSPECIFIED = 0;
 
     // The collection of session entities overrides the collection of entities
-    // in the corresponding developer entity type.
+    // in the corresponding custom entity type.
     ENTITY_OVERRIDE_MODE_OVERRIDE = 1;
 
     // The collection of session entities extends the collection of entities in
-    // the corresponding developer entity type.
+    // the corresponding custom entity type.
     //
     // Note: Even in this override mode calls to `ListSessionEntityTypes`,
     // `GetSessionEntityType`, `CreateSessionEntityType` and
     // `UpdateSessionEntityType` only return the additional entities added in
     // this session entity type. If you want to get the supplemented list,
-    // please call [EntityTypes.GetEntityType][google.cloud.dialogflow.v2beta1.EntityTypes.GetEntityType] on the developer entity type
+    // please call [EntityTypes.GetEntityType][google.cloud.dialogflow.v2beta1.EntityTypes.GetEntityType] on the custom entity type
     // and merge.
     ENTITY_OVERRIDE_MODE_SUPPLEMENT = 2;
   }
@@ -150,7 +207,7 @@ message SessionEntityType {
   string name = 1;
 
   // Required. Indicates whether the additional data should override or
-  // supplement the developer entity type definition.
+  // supplement the custom entity type definition.
   EntityOverrideMode entity_override_mode = 2;
 
   // Required. The collection of entities associated with this session entity
@@ -214,12 +271,7 @@ message CreateSessionEntityTypeRequest {
 
 // The request message for [SessionEntityTypes.UpdateSessionEntityType][google.cloud.dialogflow.v2beta1.SessionEntityTypes.UpdateSessionEntityType].
 message UpdateSessionEntityTypeRequest {
-  // Required. The entity type to update. Format:
-  // `projects//agent/sessions//entityTypes/` or `projects//agent/environments//users//sessions//entityTypes/`. If `Environment ID` is not specified, we assume default 'draft'
-  // environment. If `User ID` is not specified, we assume default '-' user.
+  // Required. The session entity type to update.
   SessionEntityType session_entity_type = 1;
 
   // Optional. The mask to control which fields get updated.
diff --git a/third_party/googleapis/google/cloud/dialogflow/v2beta1/validation_result.proto b/third_party/googleapis/google/cloud/dialogflow/v2beta1/validation_result.proto
new file mode 100644
index 000000000..9ab491f7b
--- /dev/null
+++ b/third_party/googleapis/google/cloud/dialogflow/v2beta1/validation_result.proto
@@ -0,0 +1,76 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.dialogflow.v2beta1;
+
+import "google/api/annotations.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.Dialogflow.V2beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/dialogflow/v2beta1;dialogflow";
+option java_multiple_files = true;
+option java_outer_classname = "ValidationResultProto";
+option java_package = "com.google.cloud.dialogflow.v2beta1";
+option objc_class_prefix = "DF";
+
+// Represents a single validation error.
+message ValidationError {
+  // Represents a level of severity.
+  enum Severity {
+    // Not specified. This value should never be used.
+    SEVERITY_UNSPECIFIED = 0;
+
+    // The agent doesn't follow Dialogflow best practicies.
+    INFO = 1;
+
+    // The agent may not behave as expected.
+    WARNING = 2;
+
+    // The agent may experience partial failures.
+    ERROR = 3;
+
+    // The agent may completely fail.
+    CRITICAL = 4;
+  }
+
+  // The severity of the error.
+  Severity severity = 1;
+
+  // The names of the entries that the error is associated with.
+  // Format:
+  //
+  // - "projects//agent", if the error is associated with the entire
+  // agent.
+  // - "projects//agent/intents/", if the error is
+  // associated with certain intents.
+  // - "projects//agent/intents//trainingPhrases/", if the
+  // error is associated with certain intent training phrases.
+  // - "projects//agent/intents//parameters/", if the error is associated with certain intent parameters.
+  // - "projects//agent/entities/", if the error is
+  // associated with certain entities.
+  repeated string entries = 3;
+
+  // The detailed error messsage.
+  string error_message = 4;
+}
+
+// Represents the output of agent validation.
+message ValidationResult {
+  // Contains all validation errors.
+  repeated ValidationError validation_errors = 1;
+}
diff --git a/third_party/googleapis/google/cloud/dialogflow/v2beta1/webhook.proto b/third_party/googleapis/google/cloud/dialogflow/v2beta1/webhook.proto
index cdf630102..9e5d2a4c4 100644
--- a/third_party/googleapis/google/cloud/dialogflow/v2beta1/webhook.proto
+++ b/third_party/googleapis/google/cloud/dialogflow/v2beta1/webhook.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -58,49 +57,56 @@ message WebhookRequest {
 }
 
 // The response message for a webhook call.
+//
+// This response is validated by the Dialogflow server. If validation fails,
+// an error will be returned in the [QueryResult.diagnostic_info][google.cloud.dialogflow.v2beta1.QueryResult.diagnostic_info] field.
+// Setting JSON fields to an empty value with the wrong type is a common error.
+// To avoid this error:
+//
+// - Use `""` for empty strings
+// - Use `{}` or `null` for empty objects
+// - Use `[]` or `null` for empty arrays
+//
+// For more information, see the
+// [Protocol Buffers Language
+// Guide](https://developers.google.com/protocol-buffers/docs/proto3#json).
 message WebhookResponse {
-  // Optional. The text to be shown on the screen. This value is passed directly
-  // to `QueryResult.fulfillment_text`.
+  // Optional. The text response message intended for the end-user.
+  // It is recommended to use `fulfillment_messages.text.text[0]` instead.
+  // When provided, Dialogflow uses this field to populate
+  // [QueryResult.fulfillment_text][google.cloud.dialogflow.v2beta1.QueryResult.fulfillment_text] sent to the integration or API caller.
   string fulfillment_text = 1;
 
-  // Optional. The collection of rich messages to present to the user. This
-  // value is passed directly to `QueryResult.fulfillment_messages`.
+  // Optional. The rich response messages intended for the end-user.
+  // When provided, Dialogflow uses this field to populate
+  // [QueryResult.fulfillment_messages][google.cloud.dialogflow.v2beta1.QueryResult.fulfillment_messages] sent to the integration or API caller.
   repeated Intent.Message fulfillment_messages = 2;
 
-  // Optional. This value is passed directly to `QueryResult.webhook_source`.
+  // Optional. A custom field used to identify the webhook source.
+  // Arbitrary strings are supported.
+  // When provided, Dialogflow uses this field to populate
+  // [QueryResult.webhook_source][google.cloud.dialogflow.v2beta1.QueryResult.webhook_source] sent to the integration or API caller.
   string source = 3;
 
-  // Optional. This value is passed directly to `QueryResult.webhook_payload`.
-  // See the related `fulfillment_messages[i].payload field`, which may be used
-  // as an alternative to this field.
-  //
-  // This field can be used for Actions on Google responses.
-  // It should have a structure similar to the JSON message shown here. For more
-  // information, see
-  // [Actions on Google Webhook
-  // Format](https://developers.google.com/actions/dialogflow/webhook)
-  // 
{
-  //   "google": {
-  //     "expectUserResponse": true,
-  //     "richResponse": {
-  //       "items": [
-  //         {
-  //           "simpleResponse": {
-  //             "textToSpeech": "this is a simple response"
-  //           }
-  //         }
-  //       ]
-  //     }
-  //   }
-  // }

+  // Optional. This field can be used to pass custom data from your webhook to the
+  // integration or API caller. Arbitrary JSON objects are supported.
+  // When provided, Dialogflow uses this field to populate
+  // [QueryResult.webhook_payload][google.cloud.dialogflow.v2beta1.QueryResult.webhook_payload] sent to the integration or API caller.
+  // This field is also used by the
+  // [Google Assistant
+  // integration](https://cloud.google.com/dialogflow/docs/integrations/aog)
+  // for rich response messages.
+  // See the format definition at [Google Assistant Dialogflow webhook
+  // format](https://developers.google.com/assistant/actions/build/json/dialogflow-webhook-json)
   google.protobuf.Struct payload = 4;
 
-  // Optional. The collection of output contexts. This value is passed directly
-  // to `QueryResult.output_contexts`.
+  // Optional. The collection of output contexts that will overwrite currently
+  // active contexts for the session and reset their lifespans.
+  // When provided, Dialogflow uses this field to populate
+  // [QueryResult.output_contexts][google.cloud.dialogflow.v2beta1.QueryResult.output_contexts] sent to the integration or API caller.
   repeated Context output_contexts = 5;
 
-  // Optional. Makes the platform immediately invoke another `DetectIntent` call
-  // internally with the specified event as input.
+  // Optional. Invokes the supplied events.
   // When this field is set, Dialogflow ignores the `fulfillment_text`,
   // `fulfillment_messages`, and `payload` fields.
   EventInput followup_event_input = 6;
@@ -109,6 +115,13 @@ message WebhookResponse {
   // (e.g., Actions on Google or Dialogflow phone gateway) use this information
   // to close interaction with an end user. Default is false.
   bool end_interaction = 8;
+
+  // Optional. Additional session entity types to replace or extend developer
+  // entity types with. The entity synonyms apply to all languages and persist
+  // for the session. Setting this data from a webhook overwrites
+  // the session entity types that have been set using `detectIntent`,
+  // `streamingDetectIntent` or [SessionEntityType][google.cloud.dialogflow.v2beta1.SessionEntityType] management methods.
+  repeated SessionEntityType session_entity_types = 10;
 }
 
 // Represents the contents of the original request that was passed to
@@ -126,7 +139,8 @@ message OriginalDetectIntentRequest {
   // field passed in the request. Some integrations that query a Dialogflow
   // agent may provide additional information in the payload.
   //
-  // In particular for the Telephony Gateway this field has the form:
+  // In particular, for the Dialogflow Phone Gateway integration, this field has
+  // the form:
   // 
{
   //  "telephony": {
   //    "caller_id": "+18558363987"
diff --git a/third_party/googleapis/google/cloud/documentai/BUILD.bazel b/third_party/googleapis/google/cloud/documentai/BUILD.bazel
new file mode 100644
index 000000000..a87c57fec
--- /dev/null
+++ b/third_party/googleapis/google/cloud/documentai/BUILD.bazel
@@ -0,0 +1 @@
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/cloud/texttospeech/artman_texttospeech.yaml b/third_party/googleapis/google/cloud/documentai/artman_documentai_v1beta1.yaml
similarity index 78%
rename from third_party/googleapis/google/cloud/texttospeech/artman_texttospeech.yaml
rename to third_party/googleapis/google/cloud/documentai/artman_documentai_v1beta1.yaml
index 83b8d2fd2..ae8ab02fc 100644
--- a/third_party/googleapis/google/cloud/texttospeech/artman_texttospeech.yaml
+++ b/third_party/googleapis/google/cloud/documentai/artman_documentai_v1beta1.yaml
@@ -1,13 +1,13 @@
 common:
-  api_name: texttospeech
+  api_name: documentai
   api_version: v1beta1
   organization_name: google-cloud
   proto_deps:
-    - name: google-common-protos
+  - name: google-common-protos
   src_proto_paths:
   - v1beta1
-  service_yaml: tts.yaml
-  gapic_yaml: v1beta1/texttospeech_gapic.yaml
+  service_yaml: documentai_v1beta1.yaml
+  gapic_yaml: v1beta1/documentai_gapic.yaml
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/cloud/documentai/documentai_v1beta1.yaml b/third_party/googleapis/google/cloud/documentai/documentai_v1beta1.yaml
new file mode 100644
index 000000000..78865689c
--- /dev/null
+++ b/third_party/googleapis/google/cloud/documentai/documentai_v1beta1.yaml
@@ -0,0 +1,29 @@
+type: google.api.Service
+config_version: 3
+name: documentai.googleapis.com
+title: Cloud Document AI API
+
+apis:
+- name: google.cloud.documentai.v1beta1.DocumentUnderstandingService
+
+types:
+- name: google.cloud.documentai.v1beta1.BatchProcessDocumentsResponse
+- name: google.cloud.documentai.v1beta1.Document
+- name: google.cloud.documentai.v1beta1.OperationMetadata
+
+documentation:
+  summary: |-
+    Service to parse structured information from unstructured or
+    semi-structured documents using state-of-the-art Google AI such as natural
+    language, computer vision, translation, and AutoML.
+
+authentication:
+  rules:
+  - selector: google.cloud.documentai.v1beta1.DocumentUnderstandingService.BatchProcessDocuments
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/documentai/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/documentai/v1beta1/BUILD.bazel
new file mode 100644
index 000000000..2c499ccd4
--- /dev/null
+++ b/third_party/googleapis/google/cloud/documentai/v1beta1/BUILD.bazel
@@ -0,0 +1,371 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "documentai_proto",
+    srcs = [
+        "document.proto",
+        "document_understanding.proto",
+        "geometry.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/longrunning:operations_proto",
+        "//google/rpc:status_proto",
+        "//google/type:color_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "documentai_proto_with_info",
+    deps = [
+        ":documentai_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "documentai_java_proto",
+    deps = [":documentai_proto"],
+)
+
+java_grpc_library(
+    name = "documentai_java_grpc",
+    srcs = [":documentai_proto"],
+    deps = [":documentai_java_proto"],
+)
+
+java_gapic_library(
+    name = "documentai_java_gapic",
+    src = ":documentai_proto_with_info",
+    gapic_yaml = "documentai_gapic.yaml",
+    package = "google.cloud.documentai.v1beta1",
+    service_yaml = "//google/cloud/documentai:documentai_v1beta1.yaml",
+    test_deps = [
+        ":documentai_java_grpc",
+    ],
+    deps = [
+        ":documentai_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "documentai_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.documentai.v1beta1.DocumentUnderstandingServiceClientTest",
+    ],
+    runtime_deps = [":documentai_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-documentai-v1beta1-java",
+    deps = [
+        ":documentai_java_gapic",
+        ":documentai_java_grpc",
+        ":documentai_java_proto",
+        ":documentai_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "documentai_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/documentai/v1beta1",
+    protos = [":documentai_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/longrunning:longrunning_go_proto",
+        "//google/rpc:status_go_proto",
+        "//google/type:color_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "documentai_go_gapic",
+    srcs = [":documentai_proto_with_info"],
+    grpc_service_config = "documentai_grpc_service_config.json",
+    importpath = "cloud.google.com/go/documentai/apiv1beta1;documentai",
+    service_yaml = "//google/cloud/documentai:documentai_v1beta1.yaml",
+    deps = [
+        ":documentai_go_proto",
+        "//google/longrunning:longrunning_go_gapic",
+        "//google/longrunning:longrunning_go_proto",
+        "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
+    ],
+)
+
+go_test(
+    name = "documentai_go_gapic_test",
+    srcs = [":documentai_go_gapic_srcjar_test"],
+    embed = [":documentai_go_gapic"],
+    importpath = "cloud.google.com/go/documentai/apiv1beta1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-documentai-v1beta1-go",
+    deps = [
+        ":documentai_go_gapic",
+        ":documentai_go_gapic_srcjar-test.srcjar",
+        ":documentai_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "documentai_moved_proto",
+    srcs = [":documentai_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/longrunning:operations_proto",
+        "//google/rpc:status_proto",
+        "//google/type:color_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "documentai_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":documentai_moved_proto"],
+)
+
+py_grpc_library(
+    name = "documentai_py_grpc",
+    srcs = [":documentai_moved_proto"],
+    deps = [":documentai_py_proto"],
+)
+
+py_gapic_library(
+    name = "documentai_py_gapic",
+    src = ":documentai_proto_with_info",
+    gapic_yaml = "documentai_gapic.yaml",
+    package = "google.cloud.documentai.v1beta1",
+    service_yaml = "//google/cloud/documentai:documentai_v1beta1.yaml",
+    deps = [
+        ":documentai_py_grpc",
+        ":documentai_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "documentai-v1beta1-py",
+    deps = [
+        ":documentai_py_gapic",
+        ":documentai_py_grpc",
+        ":documentai_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "documentai_php_proto",
+    deps = [":documentai_proto"],
+)
+
+php_grpc_library(
+    name = "documentai_php_grpc",
+    srcs = [":documentai_proto"],
+    deps = [":documentai_php_proto"],
+)
+
+php_gapic_library(
+    name = "documentai_php_gapic",
+    src = ":documentai_proto_with_info",
+    gapic_yaml = "documentai_gapic.yaml",
+    package = "google.cloud.documentai.v1beta1",
+    service_yaml = "//google/cloud/documentai:documentai_v1beta1.yaml",
+    deps = [
+        ":documentai_php_grpc",
+        ":documentai_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-documentai-v1beta1-php",
+    deps = [
+        ":documentai_php_gapic",
+        ":documentai_php_grpc",
+        ":documentai_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "documentai_nodejs_gapic",
+    src = ":documentai_proto_with_info",
+    gapic_yaml = "documentai_gapic.yaml",
+    package = "google.cloud.documentai.v1beta1",
+    service_yaml = "//google/cloud/documentai:documentai_v1beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "documentai-v1beta1-nodejs",
+    deps = [
+        ":documentai_nodejs_gapic",
+        ":documentai_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "documentai_ruby_proto",
+    deps = [":documentai_proto"],
+)
+
+ruby_grpc_library(
+    name = "documentai_ruby_grpc",
+    srcs = [":documentai_proto"],
+    deps = [":documentai_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "documentai_ruby_gapic",
+    src = ":documentai_proto_with_info",
+    gapic_yaml = "documentai_gapic.yaml",
+    package = "google.cloud.documentai.v1beta1",
+    service_yaml = "//google/cloud/documentai:documentai_v1beta1.yaml",
+    deps = [
+        ":documentai_ruby_grpc",
+        ":documentai_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-documentai-v1beta1-ruby",
+    deps = [
+        ":documentai_ruby_gapic",
+        ":documentai_ruby_grpc",
+        ":documentai_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "documentai_csharp_proto",
+    deps = [":documentai_proto"],
+)
+
+csharp_grpc_library(
+    name = "documentai_csharp_grpc",
+    srcs = [":documentai_proto"],
+    deps = [":documentai_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "documentai_csharp_gapic",
+    src = ":documentai_proto_with_info",
+    gapic_yaml = "documentai_gapic.yaml",
+    package = "google.cloud.documentai.v1beta1",
+    service_yaml = "//google/cloud/documentai:documentai_v1beta1.yaml",
+    deps = [
+        ":documentai_csharp_grpc",
+        ":documentai_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-documentai-v1beta1-csharp",
+    deps = [
+        ":documentai_csharp_gapic",
+        ":documentai_csharp_grpc",
+        ":documentai_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/documentai/v1beta1/document.proto b/third_party/googleapis/google/cloud/documentai/v1beta1/document.proto
new file mode 100644
index 000000000..1303c32dd
--- /dev/null
+++ b/third_party/googleapis/google/cloud/documentai/v1beta1/document.proto
@@ -0,0 +1,446 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.documentai.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/documentai/v1beta1/geometry.proto";
+import "google/rpc/status.proto";
+import "google/type/color.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/documentai/v1beta1;documentai";
+option java_multiple_files = true;
+option java_outer_classname = "DocumentProto";
+option java_package = "com.google.cloud.documentai.v1beta1";
+
+// Document represents the canonical document resource in Document Understanding
+// AI.
+// It is an interchange format that provides insights into documents and allows
+// for collaboration between users and Document Understanding AI to iterate and
+// optimize for quality.
+message Document {
+  // For a large document, sharding may be performed to produce several
+  // document shards. Each document shard contains this field to detail which
+  // shard it is.
+  message ShardInfo {
+    // The 0-based index of this shard.
+    int64 shard_index = 1;
+
+    // Total number of shards.
+    int64 shard_count = 2;
+
+    // The index of the first character in
+    // [Document.text][google.cloud.documentai.v1beta1.Document.text] in the
+    // overall document global text.
+    int64 text_offset = 3;
+  }
+
+  // Annotation for common text style attributes. This adheres to CSS
+  // conventions as much as possible.
+  message Style {
+    // Font size with unit.
+    message FontSize {
+      // Font size for the text.
+      float size = 1;
+
+      // Unit for the font size. Follows CSS naming (in, px, pt, etc.).
+      string unit = 2;
+    }
+
+    // Text anchor indexing into the
+    // [Document.text][google.cloud.documentai.v1beta1.Document.text].
+    TextAnchor text_anchor = 1;
+
+    // Text color.
+    google.type.Color color = 2;
+
+    // Text background color.
+    google.type.Color background_color = 3;
+
+    // Font weight. Possible values are normal, bold, bolder, and lighter.
+    // https://www.w3schools.com/cssref/pr_font_weight.asp
+    string font_weight = 4;
+
+    // Text style. Possible values are normal, italic, and oblique.
+    // https://www.w3schools.com/cssref/pr_font_font-style.asp
+    string text_style = 5;
+
+    // Text decoration. Follows CSS standard.
+    //   
+    // https://www.w3schools.com/cssref/pr_text_text-decoration.asp
+    string text_decoration = 6;
+
+    // Font size.
+    FontSize font_size = 7;
+  }
+
+  // A page in a [Document][google.cloud.documentai.v1beta1.Document].
+  message Page {
+    // Dimension for the page.
+    message Dimension {
+      // Page width.
+      float width = 1;
+
+      // Page height.
+      float height = 2;
+
+      // Dimension unit.
+      string unit = 3;
+    }
+
+    // Visual element describing a layout unit on a page.
+    message Layout {
+      // Detected human reading orientation.
+      enum Orientation {
+        // Unspecified orientation.
+        ORIENTATION_UNSPECIFIED = 0;
+
+        // Orientation is aligned with page up.
+        PAGE_UP = 1;
+
+        // Orientation is aligned with page right.
+        // Turn the head 90 degrees clockwise from upright to read.
+        PAGE_RIGHT = 2;
+
+        // Orientation is aligned with page down.
+        // Turn the head 180 degrees from upright to read.
+        PAGE_DOWN = 3;
+
+        // Orientation is aligned with page left.
+        // Turn the head 90 degrees counterclockwise from upright to read.
+        PAGE_LEFT = 4;
+      }
+
+      // Text anchor indexing into the
+      // [Document.text][google.cloud.documentai.v1beta1.Document.text].
+      TextAnchor text_anchor = 1;
+
+      // Confidence of the current
+      // [Layout][google.cloud.documentai.v1beta1.Document.Page.Layout] within
+      // context of the object this layout is for. e.g. confidence can be for a
+      // single token, a table, a visual element, etc. depending on context.
+      // Range [0, 1].
+      float confidence = 2;
+
+      // The bounding polygon for the
+      // [Layout][google.cloud.documentai.v1beta1.Document.Page.Layout].
+      BoundingPoly bounding_poly = 3;
+
+      // Detected orientation for the
+      // [Layout][google.cloud.documentai.v1beta1.Document.Page.Layout].
+      Orientation orientation = 4;
+    }
+
+    // A block has a set of lines (collected into paragraphs) that have a
+    // common line-spacing and orientation.
+    message Block {
+      // [Layout][google.cloud.documentai.v1beta1.Document.Page.Layout] for
+      // [Block][google.cloud.documentai.v1beta1.Document.Page.Block].
+      Layout layout = 1;
+
+      // A list of detected languages together with confidence.
+      repeated DetectedLanguage detected_languages = 2;
+    }
+
+    // A collection of lines that a human would perceive as a paragraph.
+    message Paragraph {
+      // [Layout][google.cloud.documentai.v1beta1.Document.Page.Layout] for
+      // [Paragraph][google.cloud.documentai.v1beta1.Document.Page.Paragraph].
+      Layout layout = 1;
+
+      // A list of detected languages together with confidence.
+      repeated DetectedLanguage detected_languages = 2;
+    }
+
+    // A collection of tokens that a human would perceive as a line.
+    // Does not cross column boundaries, can be horizontal, vertical, etc.
+    message Line {
+      // [Layout][google.cloud.documentai.v1beta1.Document.Page.Layout] for
+      // [Line][google.cloud.documentai.v1beta1.Document.Page.Line].
+      Layout layout = 1;
+
+      // A list of detected languages together with confidence.
+      repeated DetectedLanguage detected_languages = 2;
+    }
+
+    // A detected token.
+    message Token {
+      // Detected break at the end of a
+      // [Token][google.cloud.documentai.v1beta1.Document.Page.Token].
+      message DetectedBreak {
+        // Enum to denote the type of break found.
+        enum Type {
+          // Unspecified break type.
+          TYPE_UNSPECIFIED = 0;
+
+          // A single whitespace.
+          SPACE = 1;
+
+          // A wider whitespace.
+          WIDE_SPACE = 2;
+
+          // A hyphen that indicates that a token has been split across lines.
+          HYPHEN = 3;
+        }
+
+        // Detected break type.
+        Type type = 1;
+      }
+
+      // [Layout][google.cloud.documentai.v1beta1.Document.Page.Layout] for
+      // [Token][google.cloud.documentai.v1beta1.Document.Page.Token].
+      Layout layout = 1;
+
+      // Detected break at the end of a
+      // [Token][google.cloud.documentai.v1beta1.Document.Page.Token].
+      DetectedBreak detected_break = 2;
+
+      // A list of detected languages together with confidence.
+      repeated DetectedLanguage detected_languages = 3;
+    }
+
+    // Detected non-text visual elements e.g. checkbox, signature etc. on the
+    // page.
+    message VisualElement {
+      // [Layout][google.cloud.documentai.v1beta1.Document.Page.Layout] for
+      // [Token][google.cloud.documentai.v1beta1.Document.Page.Token].
+      Layout layout = 1;
+
+      // Type of the
+      // [VisualElement][google.cloud.documentai.v1beta1.Document.Page.VisualElement].
+      string type = 2;
+
+      // A list of detected languages together with confidence.
+      repeated DetectedLanguage detected_languages = 3;
+    }
+
+    // A table representation similar to HTML table structure.
+    message Table {
+      // A row of table cells.
+      message TableRow {
+        // Cells that make up this row.
+        repeated TableCell cells = 1;
+      }
+
+      // A cell representation inside the table.
+      message TableCell {
+        // [Layout][google.cloud.documentai.v1beta1.Document.Page.Layout] for
+        // [TableCell][google.cloud.documentai.v1beta1.Document.Page.Table.TableCell].
+        Layout layout = 1;
+
+        // How many rows this cell spans.
+        int32 row_span = 2;
+
+        // How many columns this cell spans.
+        int32 col_span = 3;
+
+        // A list of detected languages together with confidence.
+        repeated DetectedLanguage detected_languages = 4;
+      }
+
+      // [Layout][google.cloud.documentai.v1beta1.Document.Page.Layout] for
+      // [Table][google.cloud.documentai.v1beta1.Document.Page.Table].
+      Layout layout = 1;
+
+      // Header rows of the table.
+      repeated TableRow header_rows = 2;
+
+      // Body rows of the table.
+      repeated TableRow body_rows = 3;
+
+      // A list of detected languages together with confidence.
+      repeated DetectedLanguage detected_languages = 4;
+    }
+
+    // A form field detected on the page.
+    message FormField {
+      // [Layout][google.cloud.documentai.v1beta1.Document.Page.Layout] for the
+      // [FormField][google.cloud.documentai.v1beta1.Document.Page.FormField]
+      // name. e.g. `Address`, `Email`, `Grand total`, `Phone number`, etc.
+      Layout field_name = 1;
+
+      // [Layout][google.cloud.documentai.v1beta1.Document.Page.Layout] for the
+      // [FormField][google.cloud.documentai.v1beta1.Document.Page.FormField]
+      // value.
+      Layout field_value = 2;
+
+      // A list of detected languages for name together with confidence.
+      repeated DetectedLanguage name_detected_languages = 3;
+
+      // A list of detected languages for value together with confidence.
+      repeated DetectedLanguage value_detected_languages = 4;
+    }
+
+    // Detected language for a structural component.
+    message DetectedLanguage {
+      // The BCP-47 language code, such as "en-US" or "sr-Latn". For more
+      // information, see
+      // http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
+      string language_code = 1;
+
+      // Confidence of detected language. Range [0, 1].
+      float confidence = 2;
+    }
+
+    // 1-based index for current
+    // [Page][google.cloud.documentai.v1beta1.Document.Page] in a parent
+    // [Document][google.cloud.documentai.v1beta1.Document]. Useful when a page
+    // is taken out of a [Document][google.cloud.documentai.v1beta1.Document]
+    // for individual processing.
+    int32 page_number = 1;
+
+    // Physical dimension of the page.
+    Dimension dimension = 2;
+
+    // [Layout][google.cloud.documentai.v1beta1.Document.Page.Layout] for the
+    // page.
+    Layout layout = 3;
+
+    // A list of detected languages together with confidence.
+    repeated DetectedLanguage detected_languages = 4;
+
+    // A list of visually detected text blocks on the page.
+    // A block has a set of lines (collected into paragraphs) that have a common
+    // line-spacing and orientation.
+    repeated Block blocks = 5;
+
+    // A list of visually detected text paragraphs on the page.
+    // A collection of lines that a human would perceive as a paragraph.
+    repeated Paragraph paragraphs = 6;
+
+    // A list of visually detected text lines on the page.
+    // A collection of tokens that a human would perceive as a line.
+    repeated Line lines = 7;
+
+    // A list of visually detected tokens on the page.
+    repeated Token tokens = 8;
+
+    // A list of detected non-text visual elements e.g. checkbox,
+    // signature etc. on the page.
+    repeated VisualElement visual_elements = 9;
+
+    // A list of visually detected tables on the page.
+    repeated Table tables = 10;
+
+    // A list of visually detected form fields on the page.
+    repeated FormField form_fields = 11;
+  }
+
+  // A phrase in the text that is a known entity type, such as a person, an
+  // organization, or location.
+  message Entity {
+    // Provenance of the entity.
+    // Text anchor indexing into the
+    // [Document.text][google.cloud.documentai.v1beta1.Document.text].
+    TextAnchor text_anchor = 1;
+
+    // Entity type from a schema e.g. `Address`.
+    string type = 2;
+
+    // Text value in the document e.g. `1600 Amphitheatre Pkwy`.
+    string mention_text = 3;
+
+    // Canonical mention name. This will be a unique value in the entity list
+    // for this document.
+    string mention_id = 4;
+  }
+
+  // Relationship between
+  // [Entities][google.cloud.documentai.v1beta1.Document.Entity].
+  message EntityRelation {
+    // Subject entity mention_id.
+    string subject_id = 1;
+
+    // Object entity mention_id.
+    string object_id = 2;
+
+    // Relationship description.
+    string relation = 3;
+  }
+
+  // Text reference indexing into the
+  // [Document.text][google.cloud.documentai.v1beta1.Document.text].
+  message TextAnchor {
+    // A text segment in the
+    // [Document.text][google.cloud.documentai.v1beta1.Document.text]. The
+    // indices may be out of bounds which indicate that the text extends into
+    // another document shard for large sharded documents. See
+    // [ShardInfo.text_offset][google.cloud.documentai.v1beta1.Document.ShardInfo.text_offset]
+    message TextSegment {
+      // [TextSegment][google.cloud.documentai.v1beta1.Document.TextAnchor.TextSegment]
+      // start UTF-8 char index in the
+      // [Document.text][google.cloud.documentai.v1beta1.Document.text].
+      int64 start_index = 1;
+
+      // [TextSegment][google.cloud.documentai.v1beta1.Document.TextAnchor.TextSegment]
+      // half open end UTF-8 char index in the
+      // [Document.text][google.cloud.documentai.v1beta1.Document.text].
+      int64 end_index = 2;
+    }
+
+    // The text segments from the
+    // [Document.text][google.cloud.documentai.v1beta1.Document.text].
+    repeated TextSegment text_segments = 1;
+  }
+
+  // Original source document from the user.
+  oneof source {
+    // Currently supports Google Cloud Storage URI of the form
+    //    `gs://bucket_name/object_name`. Object versioning is not supported.
+    //    See [Google Cloud Storage Request
+    //    URIs](https://cloud.google.com/storage/docs/reference-uris) for more
+    //    info.
+    string uri = 1;
+
+    // Inline document content, represented as a stream of bytes.
+    // Note: As with all `bytes` fields, protobuffers use a pure binary
+    // representation, whereas JSON representations use base64.
+    bytes content = 2;
+  }
+
+  // An IANA published MIME type (also referred to as media type). For more
+  // information, see
+  // https://www.iana.org/assignments/media-types/media-types.xhtml.
+  string mime_type = 3;
+
+  // UTF-8 encoded text in reading order from the document.
+  string text = 4;
+
+  // Styles for the
+  // [Document.text][google.cloud.documentai.v1beta1.Document.text].
+  repeated Style text_styles = 5;
+
+  // Visual page layout for the
+  // [Document][google.cloud.documentai.v1beta1.Document].
+  repeated Page pages = 6;
+
+  // A list of entities detected on
+  // [Document.text][google.cloud.documentai.v1beta1.Document.text]. For
+  // document shards, entities in this list may cross shard boundaries.
+  repeated Entity entities = 7;
+
+  // Relationship among
+  // [Document.entities][google.cloud.documentai.v1beta1.Document.entities].
+  repeated EntityRelation entity_relations = 8;
+
+  // Information about the sharding if this document is sharded part of a larger
+  // document. If the document is not sharded, this message is not specified.
+  ShardInfo shard_info = 9;
+
+  // Any error that occurred while processing this document.
+  google.rpc.Status error = 10;
+}
diff --git a/third_party/googleapis/google/cloud/documentai/v1beta1/document_understanding.proto b/third_party/googleapis/google/cloud/documentai/v1beta1/document_understanding.proto
new file mode 100644
index 000000000..4f8dfb722
--- /dev/null
+++ b/third_party/googleapis/google/cloud/documentai/v1beta1/document_understanding.proto
@@ -0,0 +1,299 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.documentai.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/cloud/documentai/v1beta1/geometry.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/documentai/v1beta1;documentai";
+option java_multiple_files = true;
+option java_outer_classname = "DocumentAiProto";
+option java_package = "com.google.cloud.documentai.v1beta1";
+
+// Service to parse structured information from unstructured or semi-structured
+// documents using state-of-the-art Google AI such as natural language,
+// computer vision, and translation.
+service DocumentUnderstandingService {
+  option (google.api.default_host) = "documentai.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform";
+
+  // LRO endpoint to batch process many documents.
+  rpc BatchProcessDocuments(BatchProcessDocumentsRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/locations/*}/documents:batchProcess"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/{parent=projects/*}/documents:batchProcess"
+        body: "*"
+      }
+    };
+    option (google.api.method_signature) = "requests";
+    option (google.longrunning.operation_info) = {
+      response_type: "BatchProcessDocumentsResponse"
+      metadata_type: "OperationMetadata"
+    };
+  }
+}
+
+// Request to batch process documents as an asynchronous operation.
+message BatchProcessDocumentsRequest {
+  // Required. Individual requests for each document.
+  repeated ProcessDocumentRequest requests = 1
+      [(google.api.field_behavior) = REQUIRED];
+
+  // Target project and location to make a call.
+  //
+  // Format: `projects/{project-id}/locations/{location-id}`.
+  //
+  // If no location is specified, a region will be chosen automatically.
+  string parent = 2;
+}
+
+// Request to process one document.
+message ProcessDocumentRequest {
+  // Required. Information about the input file.
+  InputConfig input_config = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The desired output location.
+  OutputConfig output_config = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Specifies a known document type for deeper structure detection. Valid
+  // values are currently "general" and "invoice". If not provided, "general"\
+  // is used as default. If any other value is given, the request is rejected.
+  string document_type = 3;
+
+  // Controls table extraction behavior. If not specified, the system will
+  // decide reasonable defaults.
+  TableExtractionParams table_extraction_params = 4;
+
+  // Controls form extraction behavior. If not specified, the system will
+  // decide reasonable defaults.
+  FormExtractionParams form_extraction_params = 5;
+
+  // Controls entity extraction behavior. If not specified, the system will
+  // decide reasonable defaults.
+  EntityExtractionParams entity_extraction_params = 6;
+
+  // Controls OCR behavior. If not specified, the system will decide reasonable
+  // defaults.
+  OcrParams ocr_params = 7;
+}
+
+// Response to an batch document processing request. This is returned in
+// the LRO Operation after the operation is complete.
+message BatchProcessDocumentsResponse {
+  // Responses for each individual document.
+  repeated ProcessDocumentResponse responses = 1;
+}
+
+// Response to a single document processing request.
+message ProcessDocumentResponse {
+  // Information about the input file. This is the same as the corresponding
+  // input config in the request.
+  InputConfig input_config = 1;
+
+  // The output location of the parsed responses. The responses are written to
+  // this location as JSON-serialized `Document` objects.
+  OutputConfig output_config = 2;
+}
+
+// Parameters to control Optical Character Recognition (OCR) behavior.
+message OcrParams {
+  // List of languages to use for OCR. In most cases, an empty value
+  // yields the best results since it enables automatic language detection. For
+  // languages based on the Latin alphabet, setting `language_hints` is not
+  // needed. In rare cases, when the language of the text in the image is known,
+  // setting a hint will help get better results (although it will be a
+  // significant hindrance if the hint is wrong). Document processing returns an
+  // error if one or more of the specified languages is not one of the
+  // supported languages.
+  repeated string language_hints = 1;
+}
+
+// Parameters to control table extraction behavior.
+message TableExtractionParams {
+  // Whether to enable table extraction.
+  bool enabled = 1;
+
+  // Optional. Table bounding box hints that can be provided to complex cases
+  // which our algorithm cannot locate the table(s) in.
+  repeated TableBoundHint table_bound_hints = 2
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Table header hints. The extraction will bias towards producing
+  // these terms as table headers, which may improve accuracy.
+  repeated string header_hints = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Model version of the table extraction system. Default is "builtin/stable".
+  // Specify "builtin/latest" for the latest model.
+  string model_version = 4;
+}
+
+// A hint for a table bounding box on the page for table parsing.
+message TableBoundHint {
+  // Optional. Page number for multi-paged inputs this hint applies to. If not
+  // provided, this hint will apply to all pages by default. This value is
+  // 1-based.
+  int32 page_number = 1 [(google.api.field_behavior) = OPTIONAL];
+
+  // Bounding box hint for a table on this page. The coordinates must be
+  // normalized to [0,1] and the bounding box must be an axis-aligned rectangle.
+  BoundingPoly bounding_box = 2;
+}
+
+// Parameters to control form extraction behavior.
+message FormExtractionParams {
+  // Whether to enable form extraction.
+  bool enabled = 1;
+
+  // User can provide pairs of (key text, value type) to improve the parsing
+  // result.
+  //
+  // For example, if a document has a field called "Date" that holds a date
+  // value and a field called "Amount" that may hold either a currency value
+  // (e.g., "$500.00") or a simple number value (e.g., "20"), you could use the
+  // following hints: [ {"key": "Date", value_types: [ "DATE"]}, {"key":
+  // "Amount", "value_types": [ "PRICE", "NUMBER" ]} ]
+  //
+  // If the value type is unknown, but you want to provide hints for the keys,
+  // you can leave the value_types field blank. e.g. {"key": "Date",
+  // "value_types": []}
+  repeated KeyValuePairHint key_value_pair_hints = 2;
+
+  // Model version of the form extraction system. Default is
+  // "builtin/stable". Specify "builtin/latest" for the latest model.
+  string model_version = 3;
+}
+
+// User-provided hint for key value pair.
+message KeyValuePairHint {
+  // The key text for the hint.
+  string key = 1;
+
+  // Type of the value. This is case-insensitive, and could be one of:
+  // ADDRESS, LOCATION, ORGANIZATION, PERSON, PHONE_NUMBER,
+  // ID, NUMBER, EMAIL, PRICE, TERMS, DATE, NAME. Types not in this list will
+  // be ignored.
+  repeated string value_types = 2;
+}
+
+// Parameters to control entity extraction behavior.
+message EntityExtractionParams {
+  // Whether to enable entity extraction.
+  bool enabled = 1;
+
+  // Model version of the entity extraction. Default is
+  // "builtin/stable". Specify "builtin/latest" for the latest model.
+  string model_version = 2;
+}
+
+// The desired input location and metadata.
+message InputConfig {
+  // Required.
+  oneof source {
+    // The Google Cloud Storage location to read the input from. This must be a
+    // single file.
+    GcsSource gcs_source = 1;
+  }
+
+  // Required. Mimetype of the input. Current supported mimetypes are
+  // application/pdf, image/tiff, and image/gif.
+  string mime_type = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The desired output location and metadata.
+message OutputConfig {
+  // Required.
+  oneof destination {
+    // The Google Cloud Storage location to write the output to.
+    GcsDestination gcs_destination = 1;
+  }
+
+  // The max number of pages to include into each output Document shard JSON on
+  // Google Cloud Storage.
+  //
+  // The valid range is [1, 100]. If not specified, the default value is 20.
+  //
+  // For example, for one pdf file with 100 pages, 100 parsed pages will be
+  // produced. If `pages_per_shard` = 20, then 5 Document shard JSON files each
+  // containing 20 parsed pages will be written under the prefix
+  // [OutputConfig.gcs_destination.uri][] and suffix pages-x-to-y.json where
+  // x and y are 1-indexed page numbers.
+  //
+  // Example GCS outputs with 157 pages and pages_per_shard = 50:
+  //
+  // pages-001-to-050.json
+  // pages-051-to-100.json
+  // pages-101-to-150.json
+  // pages-151-to-157.json
+  int32 pages_per_shard = 2;
+}
+
+// The Google Cloud Storage location where the input file will be read from.
+message GcsSource {
+  string uri = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The Google Cloud Storage location where the output file will be written to.
+message GcsDestination {
+  string uri = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Contains metadata for the BatchProcessDocuments operation.
+message OperationMetadata {
+  enum State {
+    // The default value. This value is used if the state is omitted.
+    STATE_UNSPECIFIED = 0;
+
+    // Request is received.
+    ACCEPTED = 1;
+
+    // Request operation is waiting for scheduling.
+    WAITING = 2;
+
+    // Request is being processed.
+    RUNNING = 3;
+
+    // The batch processing completed successfully.
+    SUCCEEDED = 4;
+
+    // The batch processing was cancelled.
+    CANCELLED = 5;
+
+    // The batch processing has failed.
+    FAILED = 6;
+  }
+
+  // The state of the current batch processing.
+  State state = 1;
+
+  // A message providing more details about the current state of processing.
+  string state_message = 2;
+
+  // The creation time of the operation.
+  google.protobuf.Timestamp create_time = 3;
+
+  // The last update time of the operation.
+  google.protobuf.Timestamp update_time = 4;
+}
diff --git a/third_party/googleapis/google/cloud/documentai/v1beta1/documentai_gapic.legacy.yaml b/third_party/googleapis/google/cloud/documentai/v1beta1/documentai_gapic.legacy.yaml
new file mode 100644
index 000000000..7da3881ac
--- /dev/null
+++ b/third_party/googleapis/google/cloud/documentai/v1beta1/documentai_gapic.legacy.yaml
@@ -0,0 +1,115 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.documentai.v1beta1
+  python:
+    package_name: google.cloud.documentai_v1beta1.gapic
+  go:
+    package_name: cloud.google.com/go/documentai/apiv1beta1
+  csharp:
+    package_name: Google.Cloud.DocumentAi.V1beta1
+  ruby:
+    package_name: Google::Cloud::DocumentAi::V1beta1
+  php:
+    package_name: Google\Cloud\DocumentAi\V1beta1
+  nodejs:
+    package_name: documentai.v1beta1
+    domain_layer_location: google-cloud
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: google.cloud.documentai.v1beta1.DocumentUnderstandingService
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections: []
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: BatchProcessDocuments
+    flattening:
+      groups:
+      - parameters:
+        - requests
+    required_fields:
+    - requests
+    retry_codes_name: idempotent
+    retry_params_name: default
+    long_running:
+      return_type: google.cloud.documentai.v1beta1.BatchProcessDocumentsResponse
+      metadata_type: google.cloud.documentai.v1beta1.OperationMetadata
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/documentai/v1beta1/documentai_gapic.yaml b/third_party/googleapis/google/cloud/documentai/v1beta1/documentai_gapic.yaml
new file mode 100644
index 000000000..99f20ce18
--- /dev/null
+++ b/third_party/googleapis/google/cloud/documentai/v1beta1/documentai_gapic.yaml
@@ -0,0 +1,45 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 2.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.documentai.v1beta1
+  python:
+    package_name: google.cloud.documentai_v1beta1.gapic
+  go:
+    package_name: cloud.google.com/go/documentai/apiv1beta1
+  csharp:
+    package_name: Google.Cloud.DocumentAi.V1beta1
+  ruby:
+    package_name: Google::Cloud::DocumentAi::V1beta1
+  php:
+    package_name: Google\Cloud\DocumentAi\V1beta1
+  nodejs:
+    package_name: documentai.v1beta1
+    domain_layer_location: google-cloud
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: google.cloud.documentai.v1beta1.DocumentUnderstandingService
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+
+  methods:
+  - name: BatchProcessDocuments
+    retry_codes_name: idempotent
diff --git a/third_party/googleapis/google/cloud/documentai/v1beta1/documentai_grpc_service_config.json b/third_party/googleapis/google/cloud/documentai/v1beta1/documentai_grpc_service_config.json
new file mode 100755
index 000000000..00e77aa3c
--- /dev/null
+++ b/third_party/googleapis/google/cloud/documentai/v1beta1/documentai_grpc_service_config.json
@@ -0,0 +1,22 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.documentai.v1beta1.DocumentUnderstandingService",
+          "method": "BatchProcessDocuments"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/documentai/v1beta1/geometry.proto b/third_party/googleapis/google/cloud/documentai/v1beta1/geometry.proto
new file mode 100644
index 000000000..9dbe2b78b
--- /dev/null
+++ b/third_party/googleapis/google/cloud/documentai/v1beta1/geometry.proto
@@ -0,0 +1,55 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.documentai.v1beta1;
+
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/documentai/v1beta1;documentai";
+option java_multiple_files = true;
+option java_outer_classname = "GeometryProto";
+option java_package = "com.google.cloud.documentai.v1beta1";
+
+// A vertex represents a 2D point in the image.
+// NOTE: the vertex coordinates are in the same scale as the original image.
+message Vertex {
+  // X coordinate.
+  int32 x = 1;
+
+  // Y coordinate.
+  int32 y = 2;
+}
+
+// A vertex represents a 2D point in the image.
+// NOTE: the normalized vertex coordinates are relative to the original image
+// and range from 0 to 1.
+message NormalizedVertex {
+  // X coordinate.
+  float x = 1;
+
+  // Y coordinate.
+  float y = 2;
+}
+
+// A bounding polygon for the detected image annotation.
+message BoundingPoly {
+  // The bounding polygon vertices.
+  repeated Vertex vertices = 1;
+
+  // The bounding polygon normalized vertices.
+  repeated NormalizedVertex normalized_vertices = 2;
+}
diff --git a/third_party/googleapis/google/cloud/documentai/v1beta2/BUILD.bazel b/third_party/googleapis/google/cloud/documentai/v1beta2/BUILD.bazel
new file mode 100644
index 000000000..85970d3ee
--- /dev/null
+++ b/third_party/googleapis/google/cloud/documentai/v1beta2/BUILD.bazel
@@ -0,0 +1,334 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "documentai_proto",
+    srcs = [
+        "document.proto",
+        "document_understanding.proto",
+        "geometry.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/longrunning:operations_proto",
+        "//google/rpc:status_proto",
+        "//google/type:color_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "documentai_proto_with_info",
+    deps = [
+        ":documentai_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "documentai_java_proto",
+    deps = [":documentai_proto"],
+)
+
+java_grpc_library(
+    name = "documentai_java_grpc",
+    srcs = [":documentai_proto"],
+    deps = [":documentai_java_proto"],
+)
+
+java_gapic_library(
+    name = "documentai_java_gapic",
+    src = ":documentai_proto_with_info",
+    gapic_yaml = "documentai_gapic.yaml",
+    package = "google.cloud.documentai.v1beta2",
+    service_yaml = "documentai_v1beta2.yaml",
+    test_deps = [
+        ":documentai_java_grpc",
+    ],
+    deps = [
+        ":documentai_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "documentai_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.documentai.v1beta2.DocumentUnderstandingServiceClientTest",
+    ],
+    runtime_deps = [":documentai_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-documentai-v1beta2-java",
+    deps = [
+        ":documentai_java_gapic",
+        ":documentai_java_grpc",
+        ":documentai_java_proto",
+        ":documentai_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "documentai_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/documentai/v1beta2",
+    protos = [":documentai_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/longrunning:longrunning_go_proto",
+        "//google/rpc:status_go_proto",
+        "//google/type:color_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "documentai_go_gapic",
+    srcs = [":documentai_proto_with_info"],
+    grpc_service_config = "documentai_v1beta2_grpc_service_config.json",
+    importpath = "cloud.google.com/go/documentai/apiv1beta2;documentai",
+    service_yaml = "documentai_v1beta2.yaml",
+    deps = [
+        ":documentai_go_proto",
+        "//google/longrunning:longrunning_go_gapic",
+        "//google/longrunning:longrunning_go_proto",
+        "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
+    ],
+)
+
+go_test(
+    name = "documentai_go_gapic_test",
+    srcs = [":documentai_go_gapic_srcjar_test"],
+    embed = [":documentai_go_gapic"],
+    importpath = "cloud.google.com/go/documentai/apiv1beta2",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-documentai-v1beta2-go",
+    deps = [
+        ":documentai_go_gapic",
+        ":documentai_go_gapic_srcjar-test.srcjar",
+        ":documentai_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+# This library is using Python microgenerator.
+# DO NOT OVERRIDE this Python section with autogenerated rules.
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    py_gapic_assembly_pkg = "py_gapic_assembly_pkg2",
+    py_gapic_library = "py_gapic_library2",
+)
+
+py_gapic_library(
+    name = "documentai_py_gapic",
+    srcs = [":documentai_proto"],
+)
+
+py_gapic_assembly_pkg(
+    name = "documentai-v1beta2-py",
+    deps = [
+        ":documentai_py_gapic",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "documentai_php_proto",
+    deps = [":documentai_proto"],
+)
+
+php_grpc_library(
+    name = "documentai_php_grpc",
+    srcs = [":documentai_proto"],
+    deps = [":documentai_php_proto"],
+)
+
+php_gapic_library(
+    name = "documentai_php_gapic",
+    src = ":documentai_proto_with_info",
+    gapic_yaml = "documentai_gapic.yaml",
+    package = "google.cloud.documentai.v1beta2",
+    service_yaml = "documentai_v1beta2.yaml",
+    deps = [
+        ":documentai_php_grpc",
+        ":documentai_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-documentai-v1beta2-php",
+    deps = [
+        ":documentai_php_gapic",
+        ":documentai_php_grpc",
+        ":documentai_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "documentai_nodejs_gapic",
+    src = ":documentai_proto_with_info",
+    gapic_yaml = "documentai_gapic.yaml",
+    package = "google.cloud.documentai.v1beta2",
+    service_yaml = "documentai_v1beta2.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "documentai-v1beta2-nodejs",
+    deps = [
+        ":documentai_nodejs_gapic",
+        ":documentai_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "documentai_ruby_proto",
+    deps = [":documentai_proto"],
+)
+
+ruby_grpc_library(
+    name = "documentai_ruby_grpc",
+    srcs = [":documentai_proto"],
+    deps = [":documentai_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "documentai_ruby_gapic",
+    src = ":documentai_proto_with_info",
+    gapic_yaml = "documentai_gapic.yaml",
+    package = "google.cloud.documentai.v1beta2",
+    service_yaml = "documentai_v1beta2.yaml",
+    deps = [
+        ":documentai_ruby_grpc",
+        ":documentai_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-documentai-v1beta2-ruby",
+    deps = [
+        ":documentai_ruby_gapic",
+        ":documentai_ruby_grpc",
+        ":documentai_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "documentai_csharp_proto",
+    deps = [":documentai_proto"],
+)
+
+csharp_grpc_library(
+    name = "documentai_csharp_grpc",
+    srcs = [":documentai_proto"],
+    deps = [":documentai_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "documentai_csharp_gapic",
+    src = ":documentai_proto_with_info",
+    gapic_yaml = "documentai_gapic.yaml",
+    package = "google.cloud.documentai.v1beta2",
+    service_yaml = "documentai_v1beta2.yaml",
+    deps = [
+        ":documentai_csharp_grpc",
+        ":documentai_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-documentai-v1beta2-csharp",
+    deps = [
+        ":documentai_csharp_gapic",
+        ":documentai_csharp_grpc",
+        ":documentai_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/documentai/v1beta2/document.proto b/third_party/googleapis/google/cloud/documentai/v1beta2/document.proto
new file mode 100644
index 000000000..d50320b12
--- /dev/null
+++ b/third_party/googleapis/google/cloud/documentai/v1beta2/document.proto
@@ -0,0 +1,516 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.documentai.v1beta2;
+
+import "google/api/field_behavior.proto";
+import "google/cloud/documentai/v1beta2/geometry.proto";
+import "google/rpc/status.proto";
+import "google/type/color.proto";
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/documentai/v1beta2;documentai";
+option java_multiple_files = true;
+option java_outer_classname = "DocumentProto";
+option java_package = "com.google.cloud.documentai.v1beta2";
+
+// Document represents the canonical document resource in Document Understanding
+// AI.
+// It is an interchange format that provides insights into documents and allows
+// for collaboration between users and Document Understanding AI to iterate and
+// optimize for quality.
+message Document {
+  // For a large document, sharding may be performed to produce several
+  // document shards. Each document shard contains this field to detail which
+  // shard it is.
+  message ShardInfo {
+    // The 0-based index of this shard.
+    int64 shard_index = 1;
+
+    // Total number of shards.
+    int64 shard_count = 2;
+
+    // The index of the first character in [Document.text][google.cloud.documentai.v1beta2.Document.text] in the overall
+    // document global text.
+    int64 text_offset = 3;
+  }
+
+  // Label attaches schema information and/or other metadata to segments within
+  // a [Document][google.cloud.documentai.v1beta2.Document]. Multiple [Label][google.cloud.documentai.v1beta2.Document.Label]s on a single field can denote either
+  // different labels, different instances of the same label created at
+  // different times, or some combination of both.
+  message Label {
+    // Provenance of the label.
+    oneof source {
+      // Label is generated AutoML model. This field stores the full resource
+      // name of the AutoML model.
+      //
+      // Format:
+      // `projects/{project-id}/locations/{location-id}/models/{model-id}`
+      string automl_model = 2;
+    }
+
+    // Name of the label.
+    //
+    // When the label is generated from AutoML Text Classification model, this
+    // field represents the name of the category.
+    string name = 1;
+
+    // Confidence score between 0 and 1 for label assignment.
+    float confidence = 3;
+  }
+
+  // Annotation for common text style attributes. This adheres to CSS
+  // conventions as much as possible.
+  message Style {
+    // Font size with unit.
+    message FontSize {
+      // Font size for the text.
+      float size = 1;
+
+      // Unit for the font size. Follows CSS naming (in, px, pt, etc.).
+      string unit = 2;
+    }
+
+    // Text anchor indexing into the [Document.text][google.cloud.documentai.v1beta2.Document.text].
+    TextAnchor text_anchor = 1;
+
+    // Text color.
+    google.type.Color color = 2;
+
+    // Text background color.
+    google.type.Color background_color = 3;
+
+    // Font weight. Possible values are normal, bold, bolder, and lighter.
+    // https://www.w3schools.com/cssref/pr_font_weight.asp
+    string font_weight = 4;
+
+    // Text style. Possible values are normal, italic, and oblique.
+    // https://www.w3schools.com/cssref/pr_font_font-style.asp
+    string text_style = 5;
+
+    // Text decoration. Follows CSS standard.
+    //   
+    // https://www.w3schools.com/cssref/pr_text_text-decoration.asp
+    string text_decoration = 6;
+
+    // Font size.
+    FontSize font_size = 7;
+  }
+
+  // A page in a [Document][google.cloud.documentai.v1beta2.Document].
+  message Page {
+    // Dimension for the page.
+    message Dimension {
+      // Page width.
+      float width = 1;
+
+      // Page height.
+      float height = 2;
+
+      // Dimension unit.
+      string unit = 3;
+    }
+
+    // Visual element describing a layout unit on a page.
+    message Layout {
+      // Detected human reading orientation.
+      enum Orientation {
+        // Unspecified orientation.
+        ORIENTATION_UNSPECIFIED = 0;
+
+        // Orientation is aligned with page up.
+        PAGE_UP = 1;
+
+        // Orientation is aligned with page right.
+        // Turn the head 90 degrees clockwise from upright to read.
+        PAGE_RIGHT = 2;
+
+        // Orientation is aligned with page down.
+        // Turn the head 180 degrees from upright to read.
+        PAGE_DOWN = 3;
+
+        // Orientation is aligned with page left.
+        // Turn the head 90 degrees counterclockwise from upright to read.
+        PAGE_LEFT = 4;
+      }
+
+      // Text anchor indexing into the [Document.text][google.cloud.documentai.v1beta2.Document.text].
+      TextAnchor text_anchor = 1;
+
+      // Confidence of the current [Layout][google.cloud.documentai.v1beta2.Document.Page.Layout] within context of the object this
+      // layout is for. e.g. confidence can be for a single token, a table,
+      // a visual element, etc. depending on context. Range [0, 1].
+      float confidence = 2;
+
+      // The bounding polygon for the [Layout][google.cloud.documentai.v1beta2.Document.Page.Layout].
+      BoundingPoly bounding_poly = 3;
+
+      // Detected orientation for the [Layout][google.cloud.documentai.v1beta2.Document.Page.Layout].
+      Orientation orientation = 4;
+
+      // Optional. This is the identifier used by referencing [PageAnchor][google.cloud.documentai.v1beta2.Document.PageAnchor]s.
+      string id = 5 [(google.api.field_behavior) = OPTIONAL];
+    }
+
+    // A block has a set of lines (collected into paragraphs) that have a
+    // common line-spacing and orientation.
+    message Block {
+      // [Layout][google.cloud.documentai.v1beta2.Document.Page.Layout] for [Block][google.cloud.documentai.v1beta2.Document.Page.Block].
+      Layout layout = 1;
+
+      // A list of detected languages together with confidence.
+      repeated DetectedLanguage detected_languages = 2;
+    }
+
+    // A collection of lines that a human would perceive as a paragraph.
+    message Paragraph {
+      // [Layout][google.cloud.documentai.v1beta2.Document.Page.Layout] for [Paragraph][google.cloud.documentai.v1beta2.Document.Page.Paragraph].
+      Layout layout = 1;
+
+      // A list of detected languages together with confidence.
+      repeated DetectedLanguage detected_languages = 2;
+    }
+
+    // A collection of tokens that a human would perceive as a line.
+    // Does not cross column boundaries, can be horizontal, vertical, etc.
+    message Line {
+      // [Layout][google.cloud.documentai.v1beta2.Document.Page.Layout] for [Line][google.cloud.documentai.v1beta2.Document.Page.Line].
+      Layout layout = 1;
+
+      // A list of detected languages together with confidence.
+      repeated DetectedLanguage detected_languages = 2;
+    }
+
+    // A detected token.
+    message Token {
+      // Detected break at the end of a [Token][google.cloud.documentai.v1beta2.Document.Page.Token].
+      message DetectedBreak {
+        // Enum to denote the type of break found.
+        enum Type {
+          // Unspecified break type.
+          TYPE_UNSPECIFIED = 0;
+
+          // A single whitespace.
+          SPACE = 1;
+
+          // A wider whitespace.
+          WIDE_SPACE = 2;
+
+          // A hyphen that indicates that a token has been split across lines.
+          HYPHEN = 3;
+        }
+
+        // Detected break type.
+        Type type = 1;
+      }
+
+      // [Layout][google.cloud.documentai.v1beta2.Document.Page.Layout] for [Token][google.cloud.documentai.v1beta2.Document.Page.Token].
+      Layout layout = 1;
+
+      // Detected break at the end of a [Token][google.cloud.documentai.v1beta2.Document.Page.Token].
+      DetectedBreak detected_break = 2;
+
+      // A list of detected languages together with confidence.
+      repeated DetectedLanguage detected_languages = 3;
+    }
+
+    // Detected non-text visual elements e.g. checkbox, signature etc. on the
+    // page.
+    message VisualElement {
+      // [Layout][google.cloud.documentai.v1beta2.Document.Page.Layout] for [VisualElement][google.cloud.documentai.v1beta2.Document.Page.VisualElement].
+      Layout layout = 1;
+
+      // Type of the [VisualElement][google.cloud.documentai.v1beta2.Document.Page.VisualElement].
+      string type = 2;
+
+      // A list of detected languages together with confidence.
+      repeated DetectedLanguage detected_languages = 3;
+    }
+
+    // A table representation similar to HTML table structure.
+    message Table {
+      // A row of table cells.
+      message TableRow {
+        // Cells that make up this row.
+        repeated TableCell cells = 1;
+      }
+
+      // A cell representation inside the table.
+      message TableCell {
+        // [Layout][google.cloud.documentai.v1beta2.Document.Page.Layout] for [TableCell][google.cloud.documentai.v1beta2.Document.Page.Table.TableCell].
+        Layout layout = 1;
+
+        // How many rows this cell spans.
+        int32 row_span = 2;
+
+        // How many columns this cell spans.
+        int32 col_span = 3;
+
+        // A list of detected languages together with confidence.
+        repeated DetectedLanguage detected_languages = 4;
+      }
+
+      // [Layout][google.cloud.documentai.v1beta2.Document.Page.Layout] for [Table][google.cloud.documentai.v1beta2.Document.Page.Table].
+      Layout layout = 1;
+
+      // Header rows of the table.
+      repeated TableRow header_rows = 2;
+
+      // Body rows of the table.
+      repeated TableRow body_rows = 3;
+
+      // A list of detected languages together with confidence.
+      repeated DetectedLanguage detected_languages = 4;
+    }
+
+    // A form field detected on the page.
+    message FormField {
+      // [Layout][google.cloud.documentai.v1beta2.Document.Page.Layout] for the [FormField][google.cloud.documentai.v1beta2.Document.Page.FormField] name. e.g. `Address`, `Email`,
+      // `Grand total`, `Phone number`, etc.
+      Layout field_name = 1;
+
+      // [Layout][google.cloud.documentai.v1beta2.Document.Page.Layout] for the [FormField][google.cloud.documentai.v1beta2.Document.Page.FormField] value.
+      Layout field_value = 2;
+
+      // A list of detected languages for name together with confidence.
+      repeated DetectedLanguage name_detected_languages = 3;
+
+      // A list of detected languages for value together with confidence.
+      repeated DetectedLanguage value_detected_languages = 4;
+
+      // If the value is non-textual, this field represents the type. Current
+      // valid values are:
+      // - blank (this indicates the field_value is normal text)
+      // - "unfilled_checkbox"
+      // - "filled_checkbox"
+      string value_type = 5;
+
+      // An internal field, created for Labeling UI to export key text.
+      string corrected_key_text = 6;
+
+      // An internal field, created for Labeling UI to export value text.
+      string corrected_value_text = 7;
+    }
+
+    // Detected language for a structural component.
+    message DetectedLanguage {
+      // The BCP-47 language code, such as "en-US" or "sr-Latn". For more
+      // information, see
+      // http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
+      string language_code = 1;
+
+      // Confidence of detected language. Range [0, 1].
+      float confidence = 2;
+    }
+
+    // 1-based index for current [Page][google.cloud.documentai.v1beta2.Document.Page] in a parent [Document][google.cloud.documentai.v1beta2.Document].
+    // Useful when a page is taken out of a [Document][google.cloud.documentai.v1beta2.Document] for individual
+    // processing.
+    int32 page_number = 1;
+
+    // Physical dimension of the page.
+    Dimension dimension = 2;
+
+    // [Layout][google.cloud.documentai.v1beta2.Document.Page.Layout] for the page.
+    Layout layout = 3;
+
+    // A list of detected languages together with confidence.
+    repeated DetectedLanguage detected_languages = 4;
+
+    // A list of visually detected text blocks on the page.
+    // A block has a set of lines (collected into paragraphs) that have a common
+    // line-spacing and orientation.
+    repeated Block blocks = 5;
+
+    // A list of visually detected text paragraphs on the page.
+    // A collection of lines that a human would perceive as a paragraph.
+    repeated Paragraph paragraphs = 6;
+
+    // A list of visually detected text lines on the page.
+    // A collection of tokens that a human would perceive as a line.
+    repeated Line lines = 7;
+
+    // A list of visually detected tokens on the page.
+    repeated Token tokens = 8;
+
+    // A list of detected non-text visual elements e.g. checkbox,
+    // signature etc. on the page.
+    repeated VisualElement visual_elements = 9;
+
+    // A list of visually detected tables on the page.
+    repeated Table tables = 10;
+
+    // A list of visually detected form fields on the page.
+    repeated FormField form_fields = 11;
+  }
+
+  // A phrase in the text that is a known entity type, such as a person, an
+  // organization, or location.
+  message Entity {
+    // Provenance of the entity.
+    // Text anchor indexing into the [Document.text][google.cloud.documentai.v1beta2.Document.text].
+    TextAnchor text_anchor = 1;
+
+    // Entity type from a schema e.g. `Address`.
+    string type = 2;
+
+    // Text value in the document e.g. `1600 Amphitheatre Pkwy`.
+    string mention_text = 3;
+
+    // Deprecated.  Use `id` field instead.
+    string mention_id = 4;
+
+    // Optional. Confidence of detected Schema entity. Range [0, 1].
+    float confidence = 5 [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. Represents the provenance of this entity wrt. the location on the
+    // page where it was found.
+    PageAnchor page_anchor = 6 [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. Canonical id. This will be a unique value in the entity list
+    // for this document.
+    string id = 7 [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. Temporary field to store the bounding poly for short-term POCs. Used by
+    // the frontend only. Do not use before you talk to ybo@ and lukasr@.
+    BoundingPoly bounding_poly_for_demo_frontend = 8 [(google.api.field_behavior) = OPTIONAL];
+  }
+
+  // Relationship between [Entities][google.cloud.documentai.v1beta2.Document.Entity].
+  message EntityRelation {
+    // Subject entity id.
+    string subject_id = 1;
+
+    // Object entity id.
+    string object_id = 2;
+
+    // Relationship description.
+    string relation = 3;
+  }
+
+  // Text reference indexing into the [Document.text][google.cloud.documentai.v1beta2.Document.text].
+  message TextAnchor {
+    // A text segment in the [Document.text][google.cloud.documentai.v1beta2.Document.text]. The indices may be out of bounds
+    // which indicate that the text extends into another document shard for
+    // large sharded documents. See [ShardInfo.text_offset][google.cloud.documentai.v1beta2.Document.ShardInfo.text_offset]
+    message TextSegment {
+      // [TextSegment][google.cloud.documentai.v1beta2.Document.TextAnchor.TextSegment] start UTF-8 char index in the [Document.text][google.cloud.documentai.v1beta2.Document.text].
+      int64 start_index = 1;
+
+      // [TextSegment][google.cloud.documentai.v1beta2.Document.TextAnchor.TextSegment] half open end UTF-8 char index in the
+      // [Document.text][google.cloud.documentai.v1beta2.Document.text].
+      int64 end_index = 2;
+    }
+
+    // The text segments from the [Document.text][google.cloud.documentai.v1beta2.Document.text].
+    repeated TextSegment text_segments = 1;
+  }
+
+  // Referencing elements in [Document.pages][google.cloud.documentai.v1beta2.Document.pages].
+  message PageAnchor {
+    // Represents a weak reference to a page element within a document.
+    message PageRef {
+      // The type of layout that is being referenced.
+      enum LayoutType {
+        // Layout Unspecified.
+        LAYOUT_TYPE_UNSPECIFIED = 0;
+
+        // References a [Page.blocks][google.cloud.documentai.v1beta2.Document.Page.blocks] element.
+        BLOCK = 1;
+
+        // References a [Page.paragraphs][google.cloud.documentai.v1beta2.Document.Page.paragraphs] element.
+        PARAGRAPH = 2;
+
+        // References a [Page.lines][google.cloud.documentai.v1beta2.Document.Page.lines] element.
+        LINE = 3;
+
+        // References a [Page.tokens][google.cloud.documentai.v1beta2.Document.Page.tokens] element.
+        TOKEN = 4;
+
+        // References a [Page.visual_elements][google.cloud.documentai.v1beta2.Document.Page.visual_elements] element.
+        VISUAL_ELEMENT = 5;
+
+        // Refrrences a [Page.tables][google.cloud.documentai.v1beta2.Document.Page.tables] element.
+        TABLE = 6;
+
+        // References a [Page.form_fields][google.cloud.documentai.v1beta2.Document.Page.form_fields] element.
+        FORM_FIELD = 7;
+      }
+
+      // Required. Index into the [Document.pages][google.cloud.documentai.v1beta2.Document.pages] element
+      int64 page = 1 [(google.api.field_behavior) = REQUIRED];
+
+      // Optional. The type of the layout element that is being referenced.  If not
+      // specified the whole page is assumed to be referenced.
+      LayoutType layout_type = 2 [(google.api.field_behavior) = OPTIONAL];
+
+      // Optional. The [Page.Layout.id][google.cloud.documentai.v1beta2.Document.Page.Layout.id] on the page that this element
+      // references.  If [LayoutRef.type][] is specified this id must also be
+      // specified.
+      string layout_id = 3 [(google.api.field_behavior) = OPTIONAL];
+    }
+
+    // One or more references to visual page elements
+    repeated PageRef page_refs = 1;
+  }
+
+  // Original source document from the user.
+  oneof source {
+    // Currently supports Google Cloud Storage URI of the form
+    //    `gs://bucket_name/object_name`. Object versioning is not supported.
+    //    See [Google Cloud Storage Request
+    //    URIs](https://cloud.google.com/storage/docs/reference-uris) for more
+    //    info.
+    string uri = 1;
+
+    // Inline document content, represented as a stream of bytes.
+    // Note: As with all `bytes` fields, protobuffers use a pure binary
+    // representation, whereas JSON representations use base64.
+    bytes content = 2;
+  }
+
+  // An IANA published MIME type (also referred to as media type). For more
+  // information, see
+  // https://www.iana.org/assignments/media-types/media-types.xhtml.
+  string mime_type = 3;
+
+  // UTF-8 encoded text in reading order from the document.
+  string text = 4;
+
+  // Styles for the [Document.text][google.cloud.documentai.v1beta2.Document.text].
+  repeated Style text_styles = 5;
+
+  // Visual page layout for the [Document][google.cloud.documentai.v1beta2.Document].
+  repeated Page pages = 6;
+
+  // A list of entities detected on [Document.text][google.cloud.documentai.v1beta2.Document.text]. For document shards,
+  // entities in this list may cross shard boundaries.
+  repeated Entity entities = 7;
+
+  // Relationship among [Document.entities][google.cloud.documentai.v1beta2.Document.entities].
+  repeated EntityRelation entity_relations = 8;
+
+  // Information about the sharding if this document is sharded part of a larger
+  // document. If the document is not sharded, this message is not specified.
+  ShardInfo shard_info = 9;
+
+  // [Label][google.cloud.documentai.v1beta2.Document.Label]s for this document.
+  repeated Label labels = 11;
+
+  // Any error that occurred while processing this document.
+  google.rpc.Status error = 10;
+}
diff --git a/third_party/googleapis/google/cloud/documentai/v1beta2/document_understanding.proto b/third_party/googleapis/google/cloud/documentai/v1beta2/document_understanding.proto
new file mode 100644
index 000000000..e0f94aa22
--- /dev/null
+++ b/third_party/googleapis/google/cloud/documentai/v1beta2/document_understanding.proto
@@ -0,0 +1,343 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.documentai.v1beta2;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/cloud/documentai/v1beta2/document.proto";
+import "google/cloud/documentai/v1beta2/geometry.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/documentai/v1beta2;documentai";
+option java_multiple_files = true;
+option java_outer_classname = "DocumentAiProto";
+option java_package = "com.google.cloud.documentai.v1beta2";
+
+// Service to parse structured information from unstructured or semi-structured
+// documents using state-of-the-art Google AI such as natural language,
+// computer vision, and translation.
+service DocumentUnderstandingService {
+  option (google.api.default_host) = "us-documentai.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // LRO endpoint to batch process many documents. The output is written
+  // to Cloud Storage as JSON in the [Document] format.
+  rpc BatchProcessDocuments(BatchProcessDocumentsRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta2/{parent=projects/*/locations/*}/documents:batchProcess"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta2/{parent=projects/*}/documents:batchProcess"
+        body: "*"
+      }
+    };
+    option (google.api.method_signature) = "requests";
+    option (google.longrunning.operation_info) = {
+      response_type: "BatchProcessDocumentsResponse"
+      metadata_type: "OperationMetadata"
+    };
+  }
+
+  // Processes a single document.
+  rpc ProcessDocument(ProcessDocumentRequest) returns (Document) {
+    option (google.api.http) = {
+      post: "/v1beta2/{parent=projects/*/locations/*}/documents:process"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta2/{parent=projects/*}/documents:process"
+        body: "*"
+      }
+    };
+  }
+}
+
+// Request to batch process documents as an asynchronous operation. The output
+// is written to Cloud Storage as JSON in the [Document] format.
+message BatchProcessDocumentsRequest {
+  // Required. Individual requests for each document.
+  repeated ProcessDocumentRequest requests = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Target project and location to make a call.
+  //
+  // Format: `projects/{project-id}/locations/{location-id}`.
+  //
+  // If no location is specified, a region will be chosen automatically.
+  string parent = 2;
+}
+
+// Request to process one document.
+message ProcessDocumentRequest {
+  // Target project and location to make a call.
+  //
+  // Format: `projects/{project-id}/locations/{location-id}`.
+  //
+  // If no location is specified, a region will be chosen automatically.
+  // This field is only populated when used in ProcessDocument method.
+  string parent = 9;
+
+  // Required. Information about the input file.
+  InputConfig input_config = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The desired output location. This field is only needed in
+  // BatchProcessDocumentsRequest.
+  OutputConfig output_config = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Specifies a known document type for deeper structure detection. Valid
+  // values are currently "general" and "invoice". If not provided, "general"\
+  // is used as default. If any other value is given, the request is rejected.
+  string document_type = 3;
+
+  // Controls table extraction behavior. If not specified, the system will
+  // decide reasonable defaults.
+  TableExtractionParams table_extraction_params = 4;
+
+  // Controls form extraction behavior. If not specified, the system will
+  // decide reasonable defaults.
+  FormExtractionParams form_extraction_params = 5;
+
+  // Controls entity extraction behavior. If not specified, the system will
+  // decide reasonable defaults.
+  EntityExtractionParams entity_extraction_params = 6;
+
+  // Controls OCR behavior. If not specified, the system will decide reasonable
+  // defaults.
+  OcrParams ocr_params = 7;
+
+  // Controls AutoML model prediction behavior. AutoMlParams cannot be used
+  // together with other Params.
+  AutoMlParams automl_params = 8;
+}
+
+// Response to an batch document processing request. This is returned in
+// the LRO Operation after the operation is complete.
+message BatchProcessDocumentsResponse {
+  // Responses for each individual document.
+  repeated ProcessDocumentResponse responses = 1;
+}
+
+// Response to a single document processing request.
+message ProcessDocumentResponse {
+  // Information about the input file. This is the same as the corresponding
+  // input config in the request.
+  InputConfig input_config = 1;
+
+  // The output location of the parsed responses. The responses are written to
+  // this location as JSON-serialized `Document` objects.
+  OutputConfig output_config = 2;
+}
+
+// Parameters to control Optical Character Recognition (OCR) behavior.
+message OcrParams {
+  // List of languages to use for OCR. In most cases, an empty value
+  // yields the best results since it enables automatic language detection. For
+  // languages based on the Latin alphabet, setting `language_hints` is not
+  // needed. In rare cases, when the language of the text in the image is known,
+  // setting a hint will help get better results (although it will be a
+  // significant hindrance if the hint is wrong). Document processing returns an
+  // error if one or more of the specified languages is not one of the
+  // supported languages.
+  repeated string language_hints = 1;
+}
+
+// Parameters to control table extraction behavior.
+message TableExtractionParams {
+  // Whether to enable table extraction.
+  bool enabled = 1;
+
+  // Optional. Table bounding box hints that can be provided to complex cases
+  // which our algorithm cannot locate the table(s) in.
+  repeated TableBoundHint table_bound_hints = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Table header hints. The extraction will bias towards producing
+  // these terms as table headers, which may improve accuracy.
+  repeated string header_hints = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Model version of the table extraction system. Default is "builtin/stable".
+  // Specify "builtin/latest" for the latest model.
+  string model_version = 4;
+}
+
+// A hint for a table bounding box on the page for table parsing.
+message TableBoundHint {
+  // Optional. Page number for multi-paged inputs this hint applies to. If not
+  // provided, this hint will apply to all pages by default. This value is
+  // 1-based.
+  int32 page_number = 1 [(google.api.field_behavior) = OPTIONAL];
+
+  // Bounding box hint for a table on this page. The coordinates must be
+  // normalized to [0,1] and the bounding box must be an axis-aligned rectangle.
+  BoundingPoly bounding_box = 2;
+}
+
+// Parameters to control form extraction behavior.
+message FormExtractionParams {
+  // Whether to enable form extraction.
+  bool enabled = 1;
+
+  // User can provide pairs of (key text, value type) to improve the parsing
+  // result.
+  //
+  // For example, if a document has a field called "Date" that holds a date
+  // value and a field called "Amount" that may hold either a currency value
+  // (e.g., "$500.00") or a simple number value (e.g., "20"), you could use the
+  // following hints: [ {"key": "Date", value_types: [ "DATE"]}, {"key":
+  // "Amount", "value_types": [ "PRICE", "NUMBER" ]} ]
+  //
+  // If the value type is unknown, but you want to provide hints for the keys,
+  // you can leave the value_types field blank. e.g. {"key": "Date",
+  // "value_types": []}
+  repeated KeyValuePairHint key_value_pair_hints = 2;
+
+  // Model version of the form extraction system. Default is
+  // "builtin/stable". Specify "builtin/latest" for the latest model.
+  // For custom form models, specify: “custom/{model_name}". Model name
+  // format is "bucket_name/path/to/modeldir" corresponding to
+  // "gs://bucket_name/path/to/modeldir" where annotated examples are stored.
+  string model_version = 3;
+}
+
+// User-provided hint for key value pair.
+message KeyValuePairHint {
+  // The key text for the hint.
+  string key = 1;
+
+  // Type of the value. This is case-insensitive, and could be one of:
+  // ADDRESS, LOCATION, ORGANIZATION, PERSON, PHONE_NUMBER,
+  // ID, NUMBER, EMAIL, PRICE, TERMS, DATE, NAME. Types not in this list will
+  // be ignored.
+  repeated string value_types = 2;
+}
+
+// Parameters to control entity extraction behavior.
+message EntityExtractionParams {
+  // Whether to enable entity extraction.
+  bool enabled = 1;
+
+  // Model version of the entity extraction. Default is
+  // "builtin/stable". Specify "builtin/latest" for the latest model.
+  string model_version = 2;
+}
+
+// Parameters to control AutoML model prediction behavior.
+message AutoMlParams {
+  // Resource name of the AutoML model.
+  //
+  // Format: `projects/{project-id}/locations/{location-id}/models/{model-id}`.
+  string model = 1;
+}
+
+// The desired input location and metadata.
+message InputConfig {
+  // Required.
+  oneof source {
+    // The Google Cloud Storage location to read the input from. This must be a
+    // single file.
+    GcsSource gcs_source = 1;
+
+    // Content in bytes, represented as a stream of bytes.
+    // Note: As with all `bytes` fields, proto buffer messages use a pure binary
+    // representation, whereas JSON representations use base64.
+    //
+    // This field only works for synchronous ProcessDocument method.
+    bytes contents = 3;
+  }
+
+  // Required. Mimetype of the input. Current supported mimetypes are application/pdf,
+  // image/tiff, and image/gif.
+  // In addition, application/json type is supported for requests with
+  // [ProcessDocumentRequest.automl_params][google.cloud.documentai.v1beta2.ProcessDocumentRequest.automl_params] field set. The JSON file needs to
+  // be in [Document][google.cloud.documentai.v1beta2.Document] format.
+  string mime_type = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The desired output location and metadata.
+message OutputConfig {
+  // Required.
+  oneof destination {
+    // The Google Cloud Storage location to write the output to.
+    GcsDestination gcs_destination = 1;
+  }
+
+  // The max number of pages to include into each output Document shard JSON on
+  // Google Cloud Storage.
+  //
+  // The valid range is [1, 100]. If not specified, the default value is 20.
+  //
+  // For example, for one pdf file with 100 pages, 100 parsed pages will be
+  // produced. If `pages_per_shard` = 20, then 5 Document shard JSON files each
+  // containing 20 parsed pages will be written under the prefix
+  // [OutputConfig.gcs_destination.uri][] and suffix pages-x-to-y.json where
+  // x and y are 1-indexed page numbers.
+  //
+  // Example GCS outputs with 157 pages and pages_per_shard = 50:
+  //
+  // pages-001-to-050.json
+  // pages-051-to-100.json
+  // pages-101-to-150.json
+  // pages-151-to-157.json
+  int32 pages_per_shard = 2;
+}
+
+// The Google Cloud Storage location where the input file will be read from.
+message GcsSource {
+  string uri = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The Google Cloud Storage location where the output file will be written to.
+message GcsDestination {
+  string uri = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Contains metadata for the BatchProcessDocuments operation.
+message OperationMetadata {
+  enum State {
+    // The default value. This value is used if the state is omitted.
+    STATE_UNSPECIFIED = 0;
+
+    // Request is received.
+    ACCEPTED = 1;
+
+    // Request operation is waiting for scheduling.
+    WAITING = 2;
+
+    // Request is being processed.
+    RUNNING = 3;
+
+    // The batch processing completed successfully.
+    SUCCEEDED = 4;
+
+    // The batch processing was cancelled.
+    CANCELLED = 5;
+
+    // The batch processing has failed.
+    FAILED = 6;
+  }
+
+  // The state of the current batch processing.
+  State state = 1;
+
+  // A message providing more details about the current state of processing.
+  string state_message = 2;
+
+  // The creation time of the operation.
+  google.protobuf.Timestamp create_time = 3;
+
+  // The last update time of the operation.
+  google.protobuf.Timestamp update_time = 4;
+}
diff --git a/third_party/googleapis/google/cloud/documentai/v1beta2/documentai_gapic.legacy.yaml b/third_party/googleapis/google/cloud/documentai/v1beta2/documentai_gapic.legacy.yaml
new file mode 100644
index 000000000..fe7f7e2d9
--- /dev/null
+++ b/third_party/googleapis/google/cloud/documentai/v1beta2/documentai_gapic.legacy.yaml
@@ -0,0 +1,118 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.documentai.v1beta2
+  python:
+    package_name: google.cloud.documentai_v1beta2.gapic
+  go:
+    package_name: cloud.google.com/go/documentai/apiv1beta2
+  csharp:
+    package_name: Google.Cloud.DocumentAi.V1beta2
+  ruby:
+    package_name: Google::Cloud::DocumentAi::V1beta2
+  php:
+    package_name: Google\Cloud\DocumentAi\V1beta2
+  nodejs:
+    package_name: documentai.v1beta2
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: google.cloud.documentai.v1beta2.DocumentUnderstandingService
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections: []
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: BatchProcessDocuments
+    flattening:
+      groups:
+      - parameters:
+        - requests
+    required_fields:
+    - requests
+    retry_codes_name: idempotent
+    retry_params_name: default
+    long_running:
+      return_type: google.cloud.documentai.v1beta2.BatchProcessDocumentsResponse
+      metadata_type: google.cloud.documentai.v1beta2.OperationMetadata
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+    timeout_millis: 60000
+  - name: ProcessDocument
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/documentai/v1beta2/documentai_gapic.yaml b/third_party/googleapis/google/cloud/documentai/v1beta2/documentai_gapic.yaml
new file mode 100644
index 000000000..fe23b39d6
--- /dev/null
+++ b/third_party/googleapis/google/cloud/documentai/v1beta2/documentai_gapic.yaml
@@ -0,0 +1,47 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 2.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.documentai.v1beta2
+  python:
+    package_name: google.cloud.documentai_v1beta2.gapic
+  go:
+    package_name: cloud.google.com/go/documentai/apiv1beta2
+  csharp:
+    package_name: Google.Cloud.DocumentAi.V1beta2
+  ruby:
+    package_name: Google::Cloud::DocumentAi::V1beta2
+  php:
+    package_name: Google\Cloud\DocumentAi\V1beta2
+  nodejs:
+    package_name: documentai.v1beta2
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: google.cloud.documentai.v1beta2.DocumentUnderstandingService
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+
+
+  methods:
+  - name: BatchProcessDocuments
+    retry_codes_name: idempotent
+  - name: ProcessDocument
+    retry_codes_name: idempotent
diff --git a/third_party/googleapis/google/cloud/documentai/v1beta2/documentai_v1beta2.yaml b/third_party/googleapis/google/cloud/documentai/v1beta2/documentai_v1beta2.yaml
new file mode 100644
index 000000000..1b068dcbc
--- /dev/null
+++ b/third_party/googleapis/google/cloud/documentai/v1beta2/documentai_v1beta2.yaml
@@ -0,0 +1,33 @@
+type: google.api.Service
+config_version: 3
+name: documentai.googleapis.com
+title: Cloud Document AI API
+
+apis:
+- name: google.cloud.documentai.v1beta2.DocumentUnderstandingService
+
+types:
+- name: google.cloud.documentai.v1beta2.BatchProcessDocumentsResponse
+- name: google.cloud.documentai.v1beta2.Document
+- name: google.cloud.documentai.v1beta2.OperationMetadata
+
+documentation:
+  summary: |-
+    Service to parse structured information from unstructured or
+    semi-structured documents using state-of-the-art Google AI such as natural
+    language, computer vision, translation, and AutoML.
+
+authentication:
+  rules:
+  - selector: google.cloud.documentai.v1beta2.DocumentUnderstandingService.BatchProcessDocuments
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: google.cloud.documentai.v1beta2.DocumentUnderstandingService.ProcessDocument
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/documentai/v1beta2/documentai_v1beta2_grpc_service_config.json b/third_party/googleapis/google/cloud/documentai/v1beta2/documentai_v1beta2_grpc_service_config.json
new file mode 100644
index 000000000..f7f137863
--- /dev/null
+++ b/third_party/googleapis/google/cloud/documentai/v1beta2/documentai_v1beta2_grpc_service_config.json
@@ -0,0 +1,26 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.documentai.v1beta2.DocumentUnderstandingService",
+          "method": "BatchProcessDocuments"
+        },
+        {
+          "service": "google.cloud.documentai.v1beta2.DocumentUnderstandingService",
+          "method": "ProcessDocument"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/documentai/v1beta2/geometry.proto b/third_party/googleapis/google/cloud/documentai/v1beta2/geometry.proto
new file mode 100644
index 000000000..7f53217fe
--- /dev/null
+++ b/third_party/googleapis/google/cloud/documentai/v1beta2/geometry.proto
@@ -0,0 +1,54 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.documentai.v1beta2;
+
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/documentai/v1beta2;documentai";
+option java_multiple_files = true;
+option java_outer_classname = "GeometryProto";
+option java_package = "com.google.cloud.documentai.v1beta2";
+
+// A vertex represents a 2D point in the image.
+// NOTE: the vertex coordinates are in the same scale as the original image.
+message Vertex {
+  // X coordinate.
+  int32 x = 1;
+
+  // Y coordinate.
+  int32 y = 2;
+}
+
+// A vertex represents a 2D point in the image.
+// NOTE: the normalized vertex coordinates are relative to the original image
+// and range from 0 to 1.
+message NormalizedVertex {
+  // X coordinate.
+  float x = 1;
+
+  // Y coordinate.
+  float y = 2;
+}
+
+// A bounding polygon for the detected image annotation.
+message BoundingPoly {
+  // The bounding polygon vertices.
+  repeated Vertex vertices = 1;
+
+  // The bounding polygon normalized vertices.
+  repeated NormalizedVertex normalized_vertices = 2;
+}
diff --git a/third_party/googleapis/google/cloud/functions/artman_functions.yaml b/third_party/googleapis/google/cloud/functions/artman_functions.yaml
index d23f76de3..24385f291 100644
--- a/third_party/googleapis/google/cloud/functions/artman_functions.yaml
+++ b/third_party/googleapis/google/cloud/functions/artman_functions.yaml
@@ -2,8 +2,9 @@ common:
   api_name: functions
   api_version: v1beta2
   organization_name: google-cloud
-  service_yaml: functions.yaml
+  service_yaml: v1beta2/cloudfunctions_v1beta2.yaml
   gapic_yaml: v1beta2/functions_gapic.yaml
+  proto_package: google.cloud.functions.v1beta2
   src_proto_paths:
   - v1beta2
   proto_deps:
diff --git a/third_party/googleapis/google/cloud/functions/functions.yaml b/third_party/googleapis/google/cloud/functions/functions.yaml
deleted file mode 100644
index 01c703bcd..000000000
--- a/third_party/googleapis/google/cloud/functions/functions.yaml
+++ /dev/null
@@ -1,20 +0,0 @@
-type: google.api.Service
-config_version: 0
-name: cloudfunctions.googleapis.com
-title: Google Cloud Functions API
-
-apis:
-- name: google.cloud.functions.v1beta2.CloudFunctionsService
-
-documentation:
-  summary:
-    'Google Cloud Functions is a lightweight, event-based, asynchronous compute
-    solution that allows you to create small, single-purpose functions that
-    respond to cloud events without the need to manage a server or a runtime
-    environment.'
-
-authentication:
-  rules:
-    - selector: '*'
-      oauth:
-        canonical_scopes: https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/functions/v1beta2/BUILD.bazel b/third_party/googleapis/google/cloud/functions/v1beta2/BUILD.bazel
new file mode 100644
index 000000000..4b4c5d778
--- /dev/null
+++ b/third_party/googleapis/google/cloud/functions/v1beta2/BUILD.bazel
@@ -0,0 +1,372 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "functions_proto",
+    srcs = [
+        "functions.proto",
+        "operations.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:any_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "functions_proto_with_info",
+    deps = [
+        ":functions_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "functions_java_proto",
+    deps = [":functions_proto"],
+)
+
+java_grpc_library(
+    name = "functions_java_grpc",
+    srcs = [":functions_proto"],
+    deps = [":functions_java_proto"],
+)
+
+java_gapic_library(
+    name = "functions_java_gapic",
+    src = ":functions_proto_with_info",
+    gapic_yaml = "functions_gapic.yaml",
+    package = "google.cloud.functions.v1beta2",
+    service_yaml = "cloudfunctions_v1beta2.yaml",
+    test_deps = [
+        ":functions_java_grpc",
+    ],
+    deps = [
+        ":functions_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "functions_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.functions.v1beta2.CloudFunctionsServiceClientTest",
+    ],
+    runtime_deps = [":functions_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-functions-v1beta2-java",
+    deps = [
+        ":functions_java_gapic",
+        ":functions_java_grpc",
+        ":functions_java_proto",
+        ":functions_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "functions_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/functions/v1beta2",
+    protos = [":functions_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/longrunning:longrunning_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "functions_go_gapic",
+    srcs = [":functions_proto_with_info"],
+    grpc_service_config = "functions_grpc_service_config.json",
+    importpath = "cloud.google.com/go/cloud/functions/apiv1beta2;functions",
+    service_yaml = "cloudfunctions_v1beta2.yaml",
+    deps = [
+        ":functions_go_proto",
+        "//google/longrunning:longrunning_go_gapic",
+        "//google/longrunning:longrunning_go_proto",
+        "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
+        "@io_bazel_rules_go//proto/wkt:any_go_proto",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
+    ],
+)
+
+go_test(
+    name = "functions_go_gapic_test",
+    srcs = [":functions_go_gapic_srcjar_test"],
+    embed = [":functions_go_gapic"],
+    importpath = "cloud.google.com/go/cloud/functions/apiv1beta2",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-functions-v1beta2-go",
+    deps = [
+        ":functions_go_gapic",
+        ":functions_go_gapic_srcjar-test.srcjar",
+        ":functions_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "functions_moved_proto",
+    srcs = [":functions_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:any_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "functions_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":functions_moved_proto"],
+)
+
+py_grpc_library(
+    name = "functions_py_grpc",
+    srcs = [":functions_moved_proto"],
+    deps = [":functions_py_proto"],
+)
+
+py_gapic_library(
+    name = "functions_py_gapic",
+    src = ":functions_proto_with_info",
+    gapic_yaml = "functions_gapic.yaml",
+    package = "google.cloud.functions.v1beta2",
+    service_yaml = "cloudfunctions_v1beta2.yaml",
+    deps = [
+        ":functions_py_grpc",
+        ":functions_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "functions-v1beta2-py",
+    deps = [
+        ":functions_py_gapic",
+        ":functions_py_grpc",
+        ":functions_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "functions_php_proto",
+    deps = [":functions_proto"],
+)
+
+php_grpc_library(
+    name = "functions_php_grpc",
+    srcs = [":functions_proto"],
+    deps = [":functions_php_proto"],
+)
+
+php_gapic_library(
+    name = "functions_php_gapic",
+    src = ":functions_proto_with_info",
+    gapic_yaml = "functions_gapic.yaml",
+    package = "google.cloud.functions.v1beta2",
+    service_yaml = "cloudfunctions_v1beta2.yaml",
+    deps = [
+        ":functions_php_grpc",
+        ":functions_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-functions-v1beta2-php",
+    deps = [
+        ":functions_php_gapic",
+        ":functions_php_grpc",
+        ":functions_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "functions_nodejs_gapic",
+    src = ":functions_proto_with_info",
+    gapic_yaml = "functions_gapic.yaml",
+    package = "google.cloud.functions.v1beta2",
+    service_yaml = "cloudfunctions_v1beta2.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "functions-v1beta2-nodejs",
+    deps = [
+        ":functions_nodejs_gapic",
+        ":functions_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "functions_ruby_proto",
+    deps = [":functions_proto"],
+)
+
+ruby_grpc_library(
+    name = "functions_ruby_grpc",
+    srcs = [":functions_proto"],
+    deps = [":functions_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "functions_ruby_gapic",
+    src = ":functions_proto_with_info",
+    gapic_yaml = "functions_gapic.yaml",
+    package = "google.cloud.functions.v1beta2",
+    service_yaml = "cloudfunctions_v1beta2.yaml",
+    deps = [
+        ":functions_ruby_grpc",
+        ":functions_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-functions-v1beta2-ruby",
+    deps = [
+        ":functions_ruby_gapic",
+        ":functions_ruby_grpc",
+        ":functions_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "functions_csharp_proto",
+    deps = [":functions_proto"],
+)
+
+csharp_grpc_library(
+    name = "functions_csharp_grpc",
+    srcs = [":functions_proto"],
+    deps = [":functions_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "functions_csharp_gapic",
+    src = ":functions_proto_with_info",
+    gapic_yaml = "functions_gapic.yaml",
+    package = "google.cloud.functions.v1beta2",
+    service_yaml = "cloudfunctions_v1beta2.yaml",
+    deps = [
+        ":functions_csharp_grpc",
+        ":functions_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-functions-v1beta2-csharp",
+    deps = [
+        ":functions_csharp_gapic",
+        ":functions_csharp_grpc",
+        ":functions_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/functions/v1beta2/cloudfunctions_v1beta2.yaml b/third_party/googleapis/google/cloud/functions/v1beta2/cloudfunctions_v1beta2.yaml
new file mode 100644
index 000000000..3c243186a
--- /dev/null
+++ b/third_party/googleapis/google/cloud/functions/v1beta2/cloudfunctions_v1beta2.yaml
@@ -0,0 +1,73 @@
+type: google.api.Service
+config_version: 3
+name: cloudfunctions.googleapis.com
+title: Cloud Functions API
+
+apis:
+- name: google.cloud.functions.v1beta2.CloudFunctionsService
+
+types:
+- name: google.cloud.functions.v1beta2.OperationMetadataV1Beta2
+
+documentation:
+  summary: 'Manages lightweight user-provided functions executed in response to events.'
+  overview: 'Manages lightweight user-provided functions executed in response to
+events.'
+  rules:
+  - selector: google.iam.v1.IAMPolicy.GetIamPolicy
+    description: |-
+      Gets the access control policy for a resource. Returns an empty policy
+      if the resource exists and does not have a policy set.
+
+  - selector: google.iam.v1.IAMPolicy.SetIamPolicy
+    description: |-
+      Sets the access control policy on the specified resource. Replaces
+      any existing policy.
+
+      Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and
+      PERMISSION_DENIED
+
+  - selector: google.iam.v1.IAMPolicy.TestIamPermissions
+    description: |-
+      Returns permissions that a caller has on the specified resource. If the
+      resource does not exist, this will return an empty set of
+      permissions, not a NOT_FOUND error.
+
+      Note: This operation is designed to be used for building
+      permission-aware UIs and command-line tools, not for authorization
+      checking. This operation may "fail open" without warning.
+
+backend:
+  rules:
+  - selector: 'google.cloud.functions.v1beta2.CloudFunctionsService.*'
+    deadline: 30.0
+  - selector: google.cloud.functions.v1beta2.CloudFunctionsService.CallFunction
+    deadline: 600.0
+  - selector: google.cloud.functions.v1beta2.CloudFunctionsService.GenerateUploadUrl
+    deadline: 120.0
+  - selector: 'google.iam.v1.IAMPolicy.*'
+    deadline: 30.0
+  - selector: 'google.longrunning.Operations.*'
+    deadline: 30.0
+
+http:
+  rules:
+  - selector: google.longrunning.Operations.GetOperation
+    get: '/v1beta2/{name=operations/*}'
+  - selector: google.longrunning.Operations.ListOperations
+    get: /v1beta2/operations
+
+authentication:
+  rules:
+  - selector: 'google.cloud.functions.v1beta2.CloudFunctionsService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.iam.v1.IAMPolicy.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/functions/v1beta2/functions.proto b/third_party/googleapis/google/cloud/functions/v1beta2/functions.proto
index 77a66841a..4d07ed1e5 100644
--- a/third_party/googleapis/google/cloud/functions/v1beta2/functions.proto
+++ b/third_party/googleapis/google/cloud/functions/v1beta2/functions.proto
@@ -1,4 +1,4 @@
-// Copyright 2017 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,14 +11,16 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.functions.v1beta2;
 
 import "google/api/annotations.proto";
-import "google/api/auth.proto";
-import "google/cloud/functions/v1beta2/operations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
@@ -31,11 +33,15 @@ option objc_class_prefix = "GCF";
 
 // A service that application uses to manipulate triggers and functions.
 service CloudFunctionsService {
+  option (google.api.default_host) = "cloudfunctions.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Returns a list of functions that belong to the requested project.
   rpc ListFunctions(ListFunctionsRequest) returns (ListFunctionsResponse) {
     option (google.api.http) = {
       get: "/v1beta2/{location=projects/*/locations/*}/functions"
     };
+    option (google.api.method_signature) = "location";
   }
 
   // Returns a function with the given name from the requested project.
@@ -43,63 +49,147 @@ service CloudFunctionsService {
     option (google.api.http) = {
       get: "/v1beta2/{name=projects/*/locations/*/functions/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates a new function. If a function with the given name already exists in
   // the specified project, the long running operation will return
   // `ALREADY_EXISTS` error.
-  rpc CreateFunction(CreateFunctionRequest)
-      returns (google.longrunning.Operation) {
+  rpc CreateFunction(CreateFunctionRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v1beta2/{location=projects/*/locations/*}/functions"
       body: "function"
     };
+    option (google.api.method_signature) = "location,function";
+    option (google.longrunning.operation_info) = {
+      response_type: "CloudFunction"
+      metadata_type: "OperationMetadataV1Beta2"
+    };
   }
 
   // Updates existing function.
-  rpc UpdateFunction(UpdateFunctionRequest)
-      returns (google.longrunning.Operation) {
+  rpc UpdateFunction(UpdateFunctionRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       put: "/v1beta2/{name=projects/*/locations/*/functions/*}"
       body: "function"
     };
+    option (google.api.method_signature) = "name,function";
+    option (google.longrunning.operation_info) = {
+      response_type: "CloudFunction"
+      metadata_type: "OperationMetadataV1Beta2"
+    };
   }
 
   // Deletes a function with the given name from the specified project. If the
   // given function is used by some trigger, the trigger will be updated to
   // remove this function.
-  rpc DeleteFunction(DeleteFunctionRequest)
-      returns (google.longrunning.Operation) {
+  rpc DeleteFunction(DeleteFunctionRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       delete: "/v1beta2/{name=projects/*/locations/*/functions/*}"
     };
+    option (google.api.method_signature) = "name";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.protobuf.Empty"
+      metadata_type: "OperationMetadataV1Beta2"
+    };
   }
 
-  // Invokes synchronously deployed function. To be used for testing, very
-  // limited traffic allowed.
+  // Synchronously invokes a deployed Cloud Function. To be used for testing
+  // purposes as very limited traffic is allowed. For more information on
+  // the actual limits refer to [API Calls](
+  // https://cloud.google.com/functions/quotas#rate_limits).
   rpc CallFunction(CallFunctionRequest) returns (CallFunctionResponse) {
     option (google.api.http) = {
       post: "/v1beta2/{name=projects/*/locations/*/functions/*}:call"
       body: "*"
     };
+    option (google.api.method_signature) = "name,data";
+  }
+
+  // Returns a signed URL for uploading a function source code.
+  // For more information about the signed URL usage see:
+  // https://cloud.google.com/storage/docs/access-control/signed-urls
+  // Once the function source code upload is complete, the used signed
+  // URL should be provided in CreateFunction or UpdateFunction request
+  // as a reference to the function source code.
+  //
+  // When uploading source code to the generated signed URL, please follow
+  // these restrictions:
+  //
+  // * Source file type should be a zip file.
+  // * Source file size should not exceed 100MB limit.
+  // * No credentials should be attached - the signed URLs provide access to the
+  //   target bucket using internal service identity; if credentials were
+  //   attached, the identity from the credentials would be used, but that
+  //   identity does not have permissions to upload files to the URL.
+  //
+  // When making a HTTP PUT request, these two headers need to be specified:
+  //
+  // * `content-type: application/zip`
+  // * `x-goog-content-length-range: 0,104857600`
+  //
+  // And this header SHOULD NOT be specified:
+  //
+  // * `Authorization: Bearer YOUR_TOKEN`
+  rpc GenerateUploadUrl(GenerateUploadUrlRequest) returns (GenerateUploadUrlResponse) {
+    option (google.api.http) = {
+      post: "/v1beta2/{parent=projects/*/locations/*}/functions:generateUploadUrl"
+      body: "*"
+    };
+  }
+
+  // Returns a signed URL for downloading deployed function source code.
+  // The URL is only valid for a limited period and should be used within
+  // minutes after generation.
+  // For more information about the signed URL usage see:
+  // https://cloud.google.com/storage/docs/access-control/signed-urls
+  rpc GenerateDownloadUrl(GenerateDownloadUrlRequest) returns (GenerateDownloadUrlResponse) {
+    option (google.api.http) = {
+      post: "/v1beta2/{name=projects/*/locations/*/functions/*}:generateDownloadUrl"
+      body: "*"
+    };
   }
 }
 
 // Describes a Cloud Function that contains user computation executed in
 // response to an event. It encapsulate function and triggers configurations.
 message CloudFunction {
+  option (google.api.resource) = {
+    type: "cloudfunctions.googleapis.com/CloudFunction"
+    pattern: "projects/{project}/locations/{location}/functions/{function}"
+  };
+
   // A user-defined name of the function. Function names must be unique
   // globally and match pattern `projects/*/locations/*/functions/*`
   string name = 1;
 
   // The location of the function source code.
   oneof source_code {
-    // The URL, starting with gs://, pointing to the zip archive which contains
-    // the function.
+    // The Google Cloud Storage URL, starting with gs://, pointing to the zip
+    // archive which contains the function.
     string source_archive_url = 14;
 
     // The hosted repository where the function is defined.
     SourceRepository source_repository = 3;
+
+    // The URL pointing to the hosted repository where the function is defined.
+    // There are supported Cloud Source Repository URLs in the following
+    // formats:
+    //
+    // To refer to a specific commit:
+    // `https://source.developers.google.com/projects/*/repos/*/revisions/*/paths/*`
+    // To refer to a moveable alias (branch):
+    // `https://source.developers.google.com/projects/*/repos/*/moveable-aliases/*/paths/*`
+    // In particular, to refer to HEAD use `master` moveable alias.
+    // To refer to a specific fixed alias (tag):
+    // `https://source.developers.google.com/projects/*/repos/*/fixed-aliases/*/paths/*`
+    //
+    // You may omit `paths/*` if you want to use the main directory.
+    string source_repository_url = 18;
+
+    // The Google Cloud Storage signed URL used for source uploading, generated
+    // by [google.cloud.functions.v1beta2.GenerateUploadUrl][]
+    string source_upload_url = 16;
   }
 
   // An event that triggers the function.
@@ -112,12 +202,12 @@ message CloudFunction {
   }
 
   // Output only. Status of the function deployment.
-  CloudFunctionStatus status = 7;
+  CloudFunctionStatus status = 7 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Name of the most recent operation modifying the function. If
   // the function status is `DEPLOYING` or `DELETING`, then it points to the
   // active operation.
-  string latest_operation = 8;
+  string latest_operation = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // The name of the function (as defined in source code) that will be
   // executed. Defaults to the resource name suffix, if not specified. For
@@ -127,6 +217,13 @@ message CloudFunction {
   // in `source_location`.
   string entry_point = 9;
 
+  // The runtime in which to run the function. Required when deploying a new
+  // function, optional when updating an existing function. For a complete
+  // list of possible choices, see the
+  // [`gcloud` command
+  // reference](/sdk/gcloud/reference/functions/deploy#--runtime).
+  string runtime = 23;
+
   // The function execution timeout. Execution is considered failed and
   // can be terminated if the function is not completed at the end of the
   // timeout period. Defaults to 60 seconds.
@@ -136,17 +233,60 @@ message CloudFunction {
   // Defaults to 256MB.
   int32 available_memory_mb = 11;
 
-  // Output only. The service account of the function.
+  // The email of the function's service account. If empty, defaults to
+  // `{project_id}@appspot.gserviceaccount.com`.
   string service_account = 13;
 
   // Output only. The last update timestamp of a Cloud Function.
-  google.protobuf.Timestamp update_time = 15;
+  google.protobuf.Timestamp update_time = 15 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The version identifier of the Cloud Function. Each deployment attempt
+  // results in a new version of a function being created.
+  int64 version_id = 20 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Labels associated with this Cloud Function.
+  map labels = 21;
+
+  // Environment variables that shall be available during function execution.
+  map environment_variables = 22;
+
+  // The limit on the maximum number of function instances that may coexist at a
+  // given time.
+  int32 max_instances = 24;
+
+  // The VPC Network that this cloud function can connect to. It can be
+  // either the fully-qualified URI, or the short name of the network resource.
+  // If the short network name is used, the network must belong to the same
+  // project. Otherwise, it must belong to a project within the same
+  // organization. The format of this field is either
+  // `projects/{project}/global/networks/{network}` or `{network}`, where
+  // {project} is a project id where the network is defined, and {network} is
+  // the short name of the network.
+  //
+  // This field is mutually exclusive with `vpc_connector` and will be replaced
+  // by it.
+  //
+  // See [the VPC documentation](https://cloud.google.com/compute/docs/vpc) for
+  // more information on connecting Cloud projects.
+  string network = 25;
+
+  // The VPC Network Connector that this cloud function can connect to. It can
+  // be either the fully-qualified URI, or the short name of the network
+  // connector resource. The format of this field is
+  // `projects/*/locations/*/connectors/*`
+  //
+  // This field is mutually exclusive with `network` field and will eventually
+  // replace it.
+  //
+  // See [the VPC documentation](https://cloud.google.com/compute/docs/vpc) for
+  // more information on connecting Cloud projects.
+  string vpc_connector = 26;
 }
 
 // Describes HTTPSTrigger, could be used to connect web hooks to function.
 message HTTPSTrigger {
   // Output only. The deployed url for the function.
-  string url = 1;
+  string url = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Describes EventTrigger, used to request events be sent from another
@@ -155,13 +295,13 @@ message EventTrigger {
   // `event_type` names contain the service that is sending an event and the
   // kind of event that was fired. Must be of the form
   // `providers/*/eventTypes/*` e.g. Directly handle a Message published to
-  // Google Cloud Pub/Sub `providers/cloud.pubsub/eventTypes/topic.publish`
+  // Google Cloud Pub/Sub `providers/cloud.pubsub/eventTypes/topic.publish`.
   //
-  //      Handle an object changing in Google Cloud Storage
-  //      `providers/cloud.storage/eventTypes/object.change`
+  // Handle an object changing in Google Cloud Storage:
+  // `providers/cloud.storage/eventTypes/object.change`
   //
-  //      Handle a write to the Firebase Realtime Database
-  //      `providers/firebase.database/eventTypes/data.write`
+  // Handle a write to the Firebase Realtime Database:
+  // `providers/google.firebase.database/eventTypes/ref.write`
   string event_type = 1;
 
   // Which instance of the source's service should send events. E.g. for Pub/Sub
@@ -170,6 +310,16 @@ message EventTrigger {
   // that only supports one instance per-project, this should be the name of the
   // project (`projects/*`)
   string resource = 2;
+
+  // The hostname of the service that should be observed.
+  //
+  // If no string is provided, the default service implementing the API will
+  // be used. For example, `storage.googleapis.com` is the default for all
+  // event types in the `google.storage` namespace.
+  string service = 6;
+
+  // Specifies policy for failed executions.
+  FailurePolicy failure_policy = 5;
 }
 
 // Describes the location of the function source in a remote repository.
@@ -205,41 +355,100 @@ message SourceRepository {
   // branch, it will be the revision id of the latest change on this branch at
   // that time. If user deployed from revision then this value will be always
   // equal to the revision specified by the user.
-  string deployed_revision = 6;
+  string deployed_revision = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// Describes the policy in case of function's execution failure.
+// If empty, then defaults to ignoring failures (i.e. not retrying them).
+message FailurePolicy {
+  // Describes the retry policy in case of function's execution failure.
+  // A function execution will be retried on any failure.
+  // A failed execution will be retried up to 7 days with an exponential backoff
+  // (capped at 10 seconds).
+  // Retried execution is charged as any other execution.
+  message Retry {
+
+  }
+
+  // Defines the action taken in case of a function execution failure.
+  oneof action {
+    // If specified, then the function will be retried in case of a failure.
+    Retry retry = 1;
+  }
 }
 
 // Request for the `CreateFunction` method.
 message CreateFunctionRequest {
-  // The project and location in which the function should be created, specified
+  // Required. The project and location in which the function should be created, specified
   // in the format `projects/*/locations/*`
-  string location = 1;
-
-  // Function to be created.
-  CloudFunction function = 2;
+  string location = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // Required. Function to be created.
+  CloudFunction function = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for the `UpdateFunction` method.
 message UpdateFunctionRequest {
-  // The name of the function to be updated.
-  string name = 1;
+  // Required. The name of the function to be updated.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudfunctions.googleapis.com/CloudFunction"
+    }];
+
+  // Required. New version of the function.
+  CloudFunction function = 2 [(google.api.field_behavior) = REQUIRED];
+}
 
-  // New version of the function.
-  CloudFunction function = 2;
+// Describes the current stage of a deployment.
+enum CloudFunctionStatus {
+  // Status not specified.
+  STATUS_UNSPECIFIED = 0;
+
+  // Successfully deployed.
+  READY = 1;
+
+  // Not deployed correctly - behavior is undefined. The item should be updated
+  // or deleted to move it out of this state.
+  FAILED = 2;
+
+  // Creation or update in progress.
+  DEPLOYING = 3;
+
+  // Deletion in progress.
+  DELETING = 4;
 }
 
 // Request for the `GetFunction` method.
 message GetFunctionRequest {
-  // The name of the function which details should be obtained.
-  string name = 1;
+  // Required. The name of the function which details should be obtained.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudfunctions.googleapis.com/CloudFunction"
+    }
+  ];
 }
 
 // Request for the `ListFunctions` method.
 message ListFunctionsRequest {
-  // The project and location from which the function should be listed,
+  // Required. The project and location from which the function should be listed,
   // specified in the format `projects/*/locations/*`
   // If you want to list functions in all locations, use "-" in place of a
-  // location.
-  string location = 1;
+  // location. When listing functions in all locations, if one or more
+  // location(s) are unreachable, the response will contain functions from all
+  // reachable locations along with the names of any unreachable locations.
+  string location = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
   // Maximum number of functions to return per call.
   int32 page_size = 2;
@@ -258,24 +467,38 @@ message ListFunctionsResponse {
 
   // If not empty, indicates that there may be more functions that match
   // the request; this value should be passed in a new
-  // [google.cloud.functions.v1beta2.ListFunctionsRequest][]
+  // [google.cloud.functions.v1beta2.ListFunctionsRequest][google.cloud.functions.v1beta2.ListFunctionsRequest]
   // to get more functions.
   string next_page_token = 2;
+
+  // Locations that could not be reached. The response does not include any
+  // functions from these locations.
+  repeated string unreachable = 3;
 }
 
 // Request for the `DeleteFunction` method.
 message DeleteFunctionRequest {
-  // The name of the function which should be deleted.
-  string name = 1;
+  // Required. The name of the function which should be deleted.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudfunctions.googleapis.com/CloudFunction"
+    }
+  ];
 }
 
 // Request for the `CallFunction` method.
 message CallFunctionRequest {
-  // The name of the function to be called.
-  string name = 1;
-
-  // Input to be passed to the function.
-  string data = 2;
+  // Required. The name of the function to be called.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudfunctions.googleapis.com/CloudFunction"
+    }
+  ];
+
+  // Required. Input to be passed to the function.
+  string data = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response of `CallFunction` method.
@@ -292,21 +515,34 @@ message CallFunctionResponse {
   string error = 3;
 }
 
-// Describes the current stage of a deployment.
-enum CloudFunctionStatus {
-  // Status not specified.
-  STATUS_UNSPECIFIED = 0;
+// Request of `GenerateUploadUrl` method.
+message GenerateUploadUrlRequest {
+  // The project and location in which the Google Cloud Storage signed URL
+  // should be generated, specified in the format `projects/*/locations/*`.
+  string parent = 1;
+}
 
-  // Successfully deployed.
-  READY = 1;
+// Response of `GenerateUploadUrl` method.
+message GenerateUploadUrlResponse {
+  // The generated Google Cloud Storage signed URL that should be used for a
+  // function source code upload. The uploaded file should be a zip archive
+  // which contains a function.
+  string upload_url = 1;
+}
 
-  // Not deployed correctly - behavior is undefined. The item should be updated
-  // or deleted to move it out of this state.
-  FAILED = 2;
+// Request of `GenerateDownloadUrl` method.
+message GenerateDownloadUrlRequest {
+  // The name of function for which source code Google Cloud Storage signed
+  // URL should be generated.
+  string name = 1;
 
-  // Creation or update in progress.
-  DEPLOYING = 3;
+  // The optional version of function.
+  uint64 version_id = 2;
+}
 
-  // Deletion in progress.
-  DELETING = 4;
+// Response of `GenerateDownloadUrl` method.
+message GenerateDownloadUrlResponse {
+  // The generated Google Cloud Storage signed URL that should be used for
+  // function source code download.
+  string download_url = 1;
 }
diff --git a/third_party/googleapis/google/cloud/functions/v1beta2/functions_gapic.legacy.yaml b/third_party/googleapis/google/cloud/functions/v1beta2/functions_gapic.legacy.yaml
new file mode 100644
index 000000000..3f7e53ade
--- /dev/null
+++ b/third_party/googleapis/google/cloud/functions/v1beta2/functions_gapic.legacy.yaml
@@ -0,0 +1,148 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.functions.v1beta2
+  python:
+    package_name: google.cloud.functions_v1beta2.gapic
+  go:
+    package_name: cloud.google.com/go/cloud/functions/apiv1beta2
+  csharp:
+    package_name: Google.Cloud.Functions.V1Beta2
+  ruby:
+    package_name: Google::Cloud::Functions::V1beta2
+  php:
+    package_name: Google\Cloud\Functions\V1beta2
+  nodejs:
+    package_name: functions.v1beta2
+    domain_layer_location: google-cloud
+interfaces:
+- name: google.cloud.functions.v1beta2.CloudFunctionsService
+  collections:
+  - name_pattern: projects/{project}/locations/{location}
+    entity_name: location
+  - name_pattern: projects/{project}/locations/{location}/functions/{function}
+    entity_name: function
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  methods:
+  - name: ListFunctions
+    flattening:
+      groups:
+      - parameters:
+        - location
+    required_fields:
+    - location
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: functions
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      location: location
+    timeout_millis: 60000
+  - name: GetFunction
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: function
+    timeout_millis: 60000
+  - name: CreateFunction
+    flattening:
+      groups:
+      - parameters:
+        - location
+        - function
+    required_fields:
+    - location
+    - function
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      location: location
+    timeout_millis: 60000
+    long_running:
+      return_type: google.cloud.functions.v1beta2.CloudFunction
+      metadata_type: google.cloud.functions.v1beta2.OperationMetadataV1Beta2
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+  - name: UpdateFunction
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - function
+    required_fields:
+    - name
+    - function
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: function
+    timeout_millis: 60000
+    long_running:
+      return_type: google.cloud.functions.v1beta2.CloudFunction
+      metadata_type: google.cloud.functions.v1beta2.OperationMetadataV1Beta2
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+  - name: DeleteFunction
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: function
+    timeout_millis: 60000
+    long_running:
+      return_type: google.protobuf.Empty
+      metadata_type: google.cloud.functions.v1beta2.OperationMetadataV1Beta2
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+  - name: CallFunction
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - data
+    required_fields:
+    - name
+    - data
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: function
+    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/functions/v1beta2/functions_gapic.yaml b/third_party/googleapis/google/cloud/functions/v1beta2/functions_gapic.yaml
index 3f7e53ade..2a3cf0075 100644
--- a/third_party/googleapis/google/cloud/functions/v1beta2/functions_gapic.yaml
+++ b/third_party/googleapis/google/cloud/functions/v1beta2/functions_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.functions.v1beta2
@@ -16,133 +16,3 @@ language_settings:
   nodejs:
     package_name: functions.v1beta2
     domain_layer_location: google-cloud
-interfaces:
-- name: google.cloud.functions.v1beta2.CloudFunctionsService
-  collections:
-  - name_pattern: projects/{project}/locations/{location}
-    entity_name: location
-  - name_pattern: projects/{project}/locations/{location}/functions/{function}
-    entity_name: function
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  methods:
-  - name: ListFunctions
-    flattening:
-      groups:
-      - parameters:
-        - location
-    required_fields:
-    - location
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: functions
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      location: location
-    timeout_millis: 60000
-  - name: GetFunction
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: function
-    timeout_millis: 60000
-  - name: CreateFunction
-    flattening:
-      groups:
-      - parameters:
-        - location
-        - function
-    required_fields:
-    - location
-    - function
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      location: location
-    timeout_millis: 60000
-    long_running:
-      return_type: google.cloud.functions.v1beta2.CloudFunction
-      metadata_type: google.cloud.functions.v1beta2.OperationMetadataV1Beta2
-      initial_poll_delay_millis: 20000
-      poll_delay_multiplier: 1.5
-      max_poll_delay_millis: 45000
-      total_poll_timeout_millis: 86400000
-  - name: UpdateFunction
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - function
-    required_fields:
-    - name
-    - function
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: function
-    timeout_millis: 60000
-    long_running:
-      return_type: google.cloud.functions.v1beta2.CloudFunction
-      metadata_type: google.cloud.functions.v1beta2.OperationMetadataV1Beta2
-      initial_poll_delay_millis: 20000
-      poll_delay_multiplier: 1.5
-      max_poll_delay_millis: 45000
-      total_poll_timeout_millis: 86400000
-  - name: DeleteFunction
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: function
-    timeout_millis: 60000
-    long_running:
-      return_type: google.protobuf.Empty
-      metadata_type: google.cloud.functions.v1beta2.OperationMetadataV1Beta2
-      initial_poll_delay_millis: 20000
-      poll_delay_multiplier: 1.5
-      max_poll_delay_millis: 45000
-      total_poll_timeout_millis: 86400000
-  - name: CallFunction
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - data
-    required_fields:
-    - name
-    - data
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: function
-    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/functions/v1beta2/functions_grpc_service_config.json b/third_party/googleapis/google/cloud/functions/v1beta2/functions_grpc_service_config.json
new file mode 100755
index 000000000..1def2eb5b
--- /dev/null
+++ b/third_party/googleapis/google/cloud/functions/v1beta2/functions_grpc_service_config.json
@@ -0,0 +1,47 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.functions.v1beta2.CloudFunctionsService",
+          "method": "ListFunctions"
+        },
+        {
+          "service": "google.cloud.functions.v1beta2.CloudFunctionsService",
+          "method": "GetFunction"
+        },
+        {
+          "service": "google.cloud.functions.v1beta2.CloudFunctionsService",
+          "method": "UpdateFunction"
+        },
+        {
+          "service": "google.cloud.functions.v1beta2.CloudFunctionsService",
+          "method": "DeleteFunction"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.functions.v1beta2.CloudFunctionsService",
+          "method": "CreateFunction"
+        },
+        {
+          "service": "google.cloud.functions.v1beta2.CloudFunctionsService",
+          "method": "CallFunction"
+        }
+      ],
+      "timeout": "600s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/functions/v1beta2/operations.proto b/third_party/googleapis/google/cloud/functions/v1beta2/operations.proto
index 1456a924e..222f2828b 100644
--- a/third_party/googleapis/google/cloud/functions/v1beta2/operations.proto
+++ b/third_party/googleapis/google/cloud/functions/v1beta2/operations.proto
@@ -1,4 +1,4 @@
-// Copyright 2017 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,32 +11,21 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.functions.v1beta2;
 
-import "google/api/annotations.proto";
 import "google/protobuf/any.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/functions/v1beta2;functions";
 option java_multiple_files = true;
 option java_outer_classname = "FunctionsOperationsProto";
 option java_package = "com.google.cloud.functions.v1beta2";
 
-// Metadata describing an [Operation][google.longrunning.Operation]
-message OperationMetadataV1Beta2 {
-  // Target of the operation - for example
-  // projects/project-1/locations/region-1/functions/function-1
-  string target = 1;
-
-  // Type of operation.
-  OperationType type = 2;
-
-  // The original request that started the operation.
-  google.protobuf.Any request = 3;
-}
-
 // A type of an operation.
 enum OperationType {
   // Unknown operation type.
@@ -51,3 +40,23 @@ enum OperationType {
   // Triggered by DeleteFunction call.
   DELETE_FUNCTION = 3;
 }
+
+// Metadata describing an [Operation][google.longrunning.Operation]
+message OperationMetadataV1Beta2 {
+  // Target of the operation - for example
+  // projects/project-1/locations/region-1/functions/function-1
+  string target = 1;
+
+  // Type of operation.
+  OperationType type = 2;
+
+  // The original request that started the operation.
+  google.protobuf.Any request = 3;
+
+  // Version id of the function created or updated by an API call.
+  // This field is only populated for Create and Update operations.
+  int64 version_id = 4;
+
+  // The last update timestamp of the operation.
+  google.protobuf.Timestamp update_time = 5;
+}
diff --git a/third_party/googleapis/google/cloud/gaming/v1beta/BUILD.bazel b/third_party/googleapis/google/cloud/gaming/v1beta/BUILD.bazel
new file mode 100644
index 000000000..cce3a1e8d
--- /dev/null
+++ b/third_party/googleapis/google/cloud/gaming/v1beta/BUILD.bazel
@@ -0,0 +1,381 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "gaming_proto",
+    srcs = [
+        "common.proto",
+        "game_server_clusters.proto",
+        "game_server_clusters_service.proto",
+        "game_server_configs.proto",
+        "game_server_configs_service.proto",
+        "game_server_deployments.proto",
+        "game_server_deployments_service.proto",
+        "realms.proto",
+        "realms_service.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "gaming_proto_with_info",
+    deps = [
+        ":gaming_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "gaming_java_proto",
+    deps = [":gaming_proto"],
+)
+
+java_grpc_library(
+    name = "gaming_java_grpc",
+    srcs = [":gaming_proto"],
+    deps = [":gaming_java_proto"],
+)
+
+java_gapic_library(
+    name = "gaming_java_gapic",
+    src = ":gaming_proto_with_info",
+    gapic_yaml = "gaming_gapic.yaml",
+    package = "google.cloud.gaming.v1beta",
+    service_yaml = "gameservices_v1beta.yaml",
+    test_deps = [
+        ":gaming_java_grpc",
+    ],
+    deps = [
+        ":gaming_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "gaming_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.gaming.v1beta.GameServerClustersServiceClientTest",
+        "com.google.cloud.gaming.v1beta.GameServerConfigsServiceClientTest",
+        "com.google.cloud.gaming.v1beta.GameServerDeploymentsServiceClientTest",
+        "com.google.cloud.gaming.v1beta.RealmsServiceClientTest",
+    ],
+    runtime_deps = [":gaming_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-gaming-v1beta-java",
+    deps = [
+        ":gaming_java_gapic",
+        ":gaming_java_grpc",
+        ":gaming_java_proto",
+        ":gaming_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "gaming_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/gaming/v1beta",
+    protos = [":gaming_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/longrunning:longrunning_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "gaming_go_gapic",
+    srcs = [":gaming_proto_with_info"],
+    grpc_service_config = "",
+    importpath = "cloud.google.com/go/gaming/apiv1beta;gaming",
+    service_yaml = "gameservices_v1beta.yaml",
+    deps = [
+        ":gaming_go_proto",
+        "//google/longrunning:longrunning_go_gapic",
+        "//google/longrunning:longrunning_go_proto",
+        "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
+    ],
+)
+
+go_test(
+    name = "gaming_go_gapic_test",
+    srcs = [":gaming_go_gapic_srcjar_test"],
+    embed = [":gaming_go_gapic"],
+    importpath = "cloud.google.com/go/gaming/apiv1beta",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-gaming-v1beta-go",
+    deps = [
+        ":gaming_go_gapic",
+        ":gaming_go_gapic_srcjar-test.srcjar",
+        ":gaming_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "gaming_moved_proto",
+    srcs = [":gaming_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "gaming_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":gaming_moved_proto"],
+)
+
+py_grpc_library(
+    name = "gaming_py_grpc",
+    srcs = [":gaming_moved_proto"],
+    deps = [":gaming_py_proto"],
+)
+
+py_gapic_library(
+    name = "gaming_py_gapic",
+    src = ":gaming_proto_with_info",
+    gapic_yaml = "gaming_gapic.yaml",
+    package = "google.cloud.gaming.v1beta",
+    service_yaml = "gameservices_v1beta.yaml",
+    deps = [
+        ":gaming_py_grpc",
+        ":gaming_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "gaming-v1beta-py",
+    deps = [
+        ":gaming_py_gapic",
+        ":gaming_py_grpc",
+        ":gaming_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "gaming_php_proto",
+    deps = [":gaming_proto"],
+)
+
+php_grpc_library(
+    name = "gaming_php_grpc",
+    srcs = [":gaming_proto"],
+    deps = [":gaming_php_proto"],
+)
+
+php_gapic_library(
+    name = "gaming_php_gapic",
+    src = ":gaming_proto_with_info",
+    gapic_yaml = "gaming_gapic.yaml",
+    package = "google.cloud.gaming.v1beta",
+    service_yaml = "gameservices_v1beta.yaml",
+    deps = [
+        ":gaming_php_grpc",
+        ":gaming_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-gaming-v1beta-php",
+    deps = [
+        ":gaming_php_gapic",
+        ":gaming_php_grpc",
+        ":gaming_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "gaming_nodejs_gapic",
+    src = ":gaming_proto_with_info",
+    gapic_yaml = "gaming_gapic.yaml",
+    package = "google.cloud.gaming.v1beta",
+    service_yaml = "gameservices_v1beta.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "gaming-v1beta-nodejs",
+    deps = [
+        ":gaming_nodejs_gapic",
+        ":gaming_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "gaming_ruby_proto",
+    deps = [":gaming_proto"],
+)
+
+ruby_grpc_library(
+    name = "gaming_ruby_grpc",
+    srcs = [":gaming_proto"],
+    deps = [":gaming_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "gaming_ruby_gapic",
+    src = ":gaming_proto_with_info",
+    gapic_yaml = "gaming_gapic.yaml",
+    package = "google.cloud.gaming.v1beta",
+    service_yaml = "gameservices_v1beta.yaml",
+    deps = [
+        ":gaming_ruby_grpc",
+        ":gaming_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-gaming-v1beta-ruby",
+    deps = [
+        ":gaming_ruby_gapic",
+        ":gaming_ruby_grpc",
+        ":gaming_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "gaming_csharp_proto",
+    deps = [":gaming_proto"],
+)
+
+csharp_grpc_library(
+    name = "gaming_csharp_grpc",
+    srcs = [":gaming_proto"],
+    deps = [":gaming_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "gaming_csharp_gapic",
+    src = ":gaming_proto_with_info",
+    gapic_yaml = "gaming_gapic.yaml",
+    package = "google.cloud.gaming.v1beta",
+    service_yaml = "gameservices_v1beta.yaml",
+    deps = [
+        ":gaming_csharp_grpc",
+        ":gaming_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-gaming-v1beta-csharp",
+    deps = [
+        ":gaming_csharp_gapic",
+        ":gaming_csharp_grpc",
+        ":gaming_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/gaming/v1beta/common.proto b/third_party/googleapis/google/cloud/gaming/v1beta/common.proto
new file mode 100644
index 000000000..027272cf3
--- /dev/null
+++ b/third_party/googleapis/google/cloud/gaming/v1beta/common.proto
@@ -0,0 +1,241 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.gaming.v1beta;
+
+import "google/api/field_behavior.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/gaming/v1beta;gaming";
+
+option java_multiple_files = true;
+option java_package = "com.google.cloud.gaming.v1beta";
+
+// Represents the metadata of the long-running operation.
+message OperationMetadata {
+  // Output only. The time the operation was created.
+  google.protobuf.Timestamp create_time = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The time the operation finished running.
+  google.protobuf.Timestamp end_time = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Server-defined resource path for the target of the operation.
+  string target = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Name of the verb executed by the operation.
+  string verb = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Human-readable status of the operation, if any.
+  string status_message = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Identifies whether the user has requested cancellation
+  // of the operation. Operations that have successfully been cancelled
+  // have [Operation.error][] value with a [google.rpc.Status.code][google.rpc.Status.code] of 1,
+  // corresponding to `Code.CANCELLED`.
+  bool requested_cancellation = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. API version used to start the operation.
+  string api_version = 7 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. List of Locations that could not be reached.
+  repeated string unreachable = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Operation status for gameservices API operations. Operation status is in
+  // the form of key-value pairs where keys are resource IDs and the values show
+  // the status of the operation. In case of failures, the value includes an
+  // error code and error message.
+  map operation_status = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+message OperationStatus {
+  enum ErrorCode {
+    ERROR_CODE_UNSPECIFIED = 0;
+
+    INTERNAL_ERROR = 1;
+
+    PERMISSION_DENIED = 2;
+
+    CLUSTER_CONNECTION = 3;
+  }
+
+  // Output only. Whether the operation is done or still in progress.
+  bool done = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // The error code in case of failures.
+  ErrorCode error_code = 2;
+
+  // The human-readable error message.
+  string error_message = 3;
+}
+
+// The label selector, used to group labels on the resources.
+message LabelSelector {
+  // Resource labels for this selector.
+  map labels = 1;
+}
+
+// The Realm selector, used to match Realm resources.
+message RealmSelector {
+  // List of Realms to match.
+  repeated string realms = 1;
+}
+
+// The schedule of a recurring or one time event. The event's time span is
+// specified by start_time and end_time. If the scheduled event's timespan is
+// larger than the cron_spec + cron_job_duration, the event will be recurring.
+// If only cron_spec + cron_job_duration are specified, the event is effective
+// starting at the local time specified by cron_spec, and is recurring.
+//
+//   start_time|-------[cron job]-------[cron job]-------[cron job]---|end_time
+//   cron job: cron spec start time + duration
+message Schedule {
+  // The start time of the event.
+  google.protobuf.Timestamp start_time = 1;
+
+  // The end time of the event.
+  google.protobuf.Timestamp end_time = 2;
+
+  // The duration for the cron job event. The duration of the event is effective
+  // after the cron job's start time.
+  google.protobuf.Duration cron_job_duration = 3;
+
+  // The cron definition of the scheduled event. See
+  // https://en.wikipedia.org/wiki/Cron. Cron spec specifies the local time as
+  // defined by the Realm.
+  string cron_spec = 4;
+}
+
+// Encapsulates Agones fleet spec and Agones autoscaler spec sources.
+message SpecSource {
+  // The Game Server Config resource. Uses the form:
+  //
+  // `projects/{project}/locations/{location}/gameServerDeployments/{deployment_id}/configs/{config_id}`.
+  string game_server_config_name = 1;
+
+  // The name of the Agones leet config or Agones scaling config used to derive
+  // the Agones fleet or Agones autoscaler spec.
+  string name = 2;
+}
+
+// Details about the Agones resources.
+message TargetDetails {
+  // Details of the target Agones fleet.
+  message TargetFleetDetails {
+    // Target Agones fleet specification.
+    message TargetFleet {
+      // The name of the Agones fleet.
+      string name = 1;
+
+      // Encapsulates the source of the Agones fleet spec.
+      // The Agones fleet spec source.
+      SpecSource spec_source = 2;
+    }
+
+    // Target Agones autoscaler policy reference.
+    message TargetFleetAutoscaler {
+      // The name of the Agones autoscaler.
+      string name = 1;
+
+      // Encapsulates the source of the Agones fleet spec.
+      // Details about the Agones autoscaler spec.
+      SpecSource spec_source = 2;
+    }
+
+    // Reference to target Agones fleet.
+    TargetFleet fleet = 1;
+
+    // Reference to target Agones fleet autoscaling policy.
+    TargetFleetAutoscaler autoscaler = 2;
+  }
+
+  // The Game Server Cluster name. Uses the form:
+  //
+  // `projects/{project}/locations/{location}/realms/{realm}/gameServerClusters/{cluster}`.
+  string game_server_cluster_name = 1;
+
+  // The Game Server Deployment name. Uses the form:
+  //
+  // `projects/{project}/locations/{location}/gameServerDeployments/{deployment_id}`.
+  string game_server_deployment_name = 2;
+
+  // Agones fleet details for Game Server Clusters and Game Server Deployments.
+  repeated TargetFleetDetails fleet_details = 3;
+}
+
+// Encapsulates the Target state.
+message TargetState {
+  // Details about Agones fleets.
+  repeated TargetDetails details = 1;
+}
+
+// Details of the deployed Agones fleet.
+message DeployedFleetDetails {
+  // Agones fleet specification and details.
+  message DeployedFleet {
+    // DeployedFleetStatus has details about the Agones fleets such as how many
+    // are running, how many allocated, and so on.
+    message DeployedFleetStatus {
+      // The number of GameServer replicas in the READY state in this fleet.
+      int64 ready_replicas = 1;
+
+      // The number of GameServer replicas in the ALLOCATED state in this fleet.
+      int64 allocated_replicas = 2;
+
+      // The number of GameServer replicas in the RESERVED state in this fleet.
+      // Reserved instances won't be deleted on scale down, but won't cause
+      // an autoscaler to scale up.
+      int64 reserved_replicas = 3;
+
+      // The total number of current GameServer replicas in this fleet.
+      int64 replicas = 4;
+    }
+
+    // The name of the Agones fleet.
+    string fleet = 1;
+
+    // The fleet spec retrieved from the Agones fleet.
+    string fleet_spec = 2;
+
+    // The source spec that is used to create the Agones fleet.
+    // The GameServerConfig resource may no longer exist in the system.
+    SpecSource spec_source = 3;
+
+    // The current status of the Agones fleet.
+    // Includes count of game servers in various states.
+    DeployedFleetStatus status = 5;
+  }
+
+  // Details about the Agones autoscaler.
+  message DeployedFleetAutoscaler {
+    // The name of the Agones autoscaler.
+    string autoscaler = 1;
+
+    // The source spec that is used to create the autoscaler.
+    // The GameServerConfig resource may no longer exist in the system.
+    SpecSource spec_source = 4;
+
+    // The autoscaler spec retrieved from Agones.
+    string fleet_autoscaler_spec = 3;
+  }
+
+  // Information about the Agones fleet.
+  DeployedFleet deployed_fleet = 1;
+
+  // Information about the Agones autoscaler for that fleet.
+  DeployedFleetAutoscaler deployed_autoscaler = 2;
+}
diff --git a/third_party/googleapis/google/cloud/gaming/v1beta/game_server_clusters.proto b/third_party/googleapis/google/cloud/gaming/v1beta/game_server_clusters.proto
new file mode 100644
index 000000000..fd67a112b
--- /dev/null
+++ b/third_party/googleapis/google/cloud/gaming/v1beta/game_server_clusters.proto
@@ -0,0 +1,275 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.gaming.v1beta;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/gaming/v1beta/common.proto";
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/gaming/v1beta;gaming";
+
+option java_multiple_files = true;
+option java_package = "com.google.cloud.gaming.v1beta";
+
+// Request message for GameServerClustersService.ListGameServerClusters.
+message ListGameServerClustersRequest {
+  // Required. The parent resource name. Uses the form:
+  // "projects/{project}/locations/{location}/realms/{realm}".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "gameservices.googleapis.com/GameServerCluster"
+    }
+  ];
+
+  // Optional. The maximum number of items to return.  If unspecified, server
+  // will pick an appropriate default. Server may return fewer items than
+  // requested. A caller should only rely on response's
+  // [next_page_token][google.cloud.gaming.v1beta.ListGameServerClustersResponse.next_page_token] to
+  // determine if there are more GameServerClusters left to be queried.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The next_page_token value returned from a previous List request, if any.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The filter to apply to list results.
+  string filter = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Specifies the ordering of results following syntax at
+  // https://cloud.google.com/apis/design/design_patterns#sorting_order.
+  string order_by = 5 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response message for GameServerClustersService.ListGameServerClusters.
+message ListGameServerClustersResponse {
+  // The list of Game Server Clusters.
+  repeated GameServerCluster game_server_clusters = 1;
+
+  // Token to retrieve the next page of results, or empty if there are no more
+  // results in the list.
+  string next_page_token = 2;
+
+  // List of Locations that could not be reached.
+  repeated string unreachable = 4;
+}
+
+// Request message for GameServerClustersService.GetGameServerCluster.
+message GetGameServerClusterRequest {
+  // Required. The name of the Game Server Cluster to retrieve. Uses the form:
+  //
+  // `projects/{project}/locations/{location}/realms/{realm-id}/gameServerClusters/{cluster}`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "gameservices.googleapis.com/GameServerCluster"
+    }
+  ];
+}
+
+// Request message for GameServerClustersService.CreateGameServerCluster.
+message CreateGameServerClusterRequest {
+  // Required. The parent resource name. Uses the form:
+  // `projects/{project}/locations/{location}/realms/{realm-id}`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "gameservices.googleapis.com/GameServerCluster"
+    }
+  ];
+
+  // Required. The ID of the Game Server Cluster resource to be created.
+  string game_server_cluster_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The Game Server Cluster resource to be created.
+  GameServerCluster game_server_cluster = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for GameServerClustersService.PreviewCreateGameServerCluster.
+message PreviewCreateGameServerClusterRequest {
+  // Required. The parent resource name. Uses the form:
+  // `projects/{project}/locations/{location}/realms/{realm}`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "gameservices.googleapis.com/GameServerCluster"
+    }
+  ];
+
+  // Required. The ID of the Game Server Cluster resource to be created.
+  string game_server_cluster_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The Game Server Cluster resource to be created.
+  GameServerCluster game_server_cluster = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The target timestamp to compute the preview.
+  google.protobuf.Timestamp preview_time = 4 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response message for
+// GameServerClustersService.PreviewCreateGameServerCluster.
+message PreviewCreateGameServerClusterResponse {
+  // The ETag of the game server cluster.
+  string etag = 2;
+
+  // The target state.
+  TargetState target_state = 3;
+}
+
+// Request message for GameServerClustersService.DeleteGameServerCluster.
+message DeleteGameServerClusterRequest {
+  // Required. The name of the Game Server Cluster to delete. Uses the form:
+  // `projects/{project}/locations/{location}/gameServerClusters/{cluster}`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "gameservices.googleapis.com/GameServerCluster"
+    }
+  ];
+}
+
+// Request message for GameServerClustersService.PreviewDeleteGameServerCluster.
+message PreviewDeleteGameServerClusterRequest {
+  // Required. The name of the Game Server Cluster to delete. Uses the form:
+  // `projects/{project}/locations/{location}/gameServerClusters/{cluster}`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "gameservices.googleapis.com/GameServerCluster"
+    }
+  ];
+
+  // Optional. The target timestamp to compute the preview.
+  google.protobuf.Timestamp preview_time = 2 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response message for
+// GameServerClustersService.PreviewDeleteGameServerCluster.
+message PreviewDeleteGameServerClusterResponse {
+  // The ETag of the game server cluster.
+  string etag = 2;
+
+  // The target state.
+  TargetState target_state = 3;
+}
+
+// Request message for GameServerClustersService.UpdateGameServerCluster.
+message UpdateGameServerClusterRequest {
+  // Required. The Game Server Cluster to be updated.
+  // Only fields specified in update_mask are updated.
+  GameServerCluster game_server_cluster = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Mask of fields to update. At least one path must be supplied in
+  // this field. For the `FieldMask` definition, see
+  //
+  // https:
+  // //developers.google.com/protocol-buffers
+  // // /docs/reference/google.protobuf#fieldmask
+  google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for GameServerClustersService.UpdateGameServerCluster.
+message PreviewUpdateGameServerClusterRequest {
+  // Required. The Game Server Cluster to be updated.
+  // Only fields specified in update_mask are updated.
+  GameServerCluster game_server_cluster = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Mask of fields to update. At least one path must be supplied in
+  // this field. For the `FieldMask` definition, see
+  //
+  // https:
+  // //developers.google.com/protocol-buffers
+  // // /docs/reference/google.protobuf#fieldmask
+  google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The target timestamp to compute the preview.
+  google.protobuf.Timestamp preview_time = 3 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response message for GameServerClustersService.PreviewUpdateGameServerCluster
+message PreviewUpdateGameServerClusterResponse {
+  // The ETag of the game server cluster.
+  string etag = 2;
+
+  // The target state.
+  TargetState target_state = 3;
+}
+
+// The Game Server Cluster connection information.
+message GameServerClusterConnectionInfo {
+  // The location of the Kubernetes cluster.
+  oneof cluster_reference {
+    // Reference to the GKE cluster where the game servers are installed.
+    GkeClusterReference gke_cluster_reference = 7;
+  }
+
+  // Namespace designated on the Game Server Cluster where the Agones game
+  // server instances will be created. Existence of the namespace will be
+  // validated during creation.
+  string namespace = 5;
+}
+
+// A reference to a GKE cluster.
+message GkeClusterReference {
+  // The full or partial name of a GKE cluster, using one of the following
+  // forms:
+  //  * `projects/{project}/locations/{location}/clusters/{cluster}`
+  //  * `locations/{location}/clusters/{cluster}`
+  //  * `{cluster}`
+  // If project and location are not specified, the project and location of the
+  // GameServerCluster resource are used to generate the full name of the
+  // GKE cluster.
+  string cluster = 1;
+}
+
+// A Game Server Cluster resource.
+message GameServerCluster {
+  option (google.api.resource) = {
+    type: "gameservices.googleapis.com/GameServerCluster"
+    pattern: "projects/{project}/locations/{location}/realms/{realm}/gameServerClusters/{cluster}"
+  };
+
+  // Required. The resource name of the Game Server Cluster. Uses the form:
+  //
+  // `projects/{project}/locations/{location}/realms/{realm}/gameServerClusters/{cluster}`.
+  // For example,
+  //
+  // `projects/my-project/locations/{location}/realms/zanzibar/gameServerClusters/my-onprem-cluster`.
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Output only. The creation time.
+  google.protobuf.Timestamp create_time = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The last-modified time.
+  google.protobuf.Timestamp update_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // The labels associated with this Game Server Cluster. Each label is a
+  // key-value pair.
+  map labels = 4;
+
+  // Game Server Cluster connection information. This information is used to
+  // manage Game Server Clusters.
+  GameServerClusterConnectionInfo connection_info = 5;
+
+  // ETag of the resource.
+  string etag = 6;
+
+  // Human readable description of the cluster.
+  string description = 7;
+}
diff --git a/third_party/googleapis/google/cloud/gaming/v1beta/game_server_clusters_service.proto b/third_party/googleapis/google/cloud/gaming/v1beta/game_server_clusters_service.proto
new file mode 100644
index 000000000..2d81c4382
--- /dev/null
+++ b/third_party/googleapis/google/cloud/gaming/v1beta/game_server_clusters_service.proto
@@ -0,0 +1,112 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.gaming.v1beta;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/cloud/gaming/v1beta/game_server_clusters.proto";
+import "google/longrunning/operations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/gaming/v1beta;gaming";
+
+option java_multiple_files = true;
+option java_package = "com.google.cloud.gaming.v1beta";
+
+// The game server cluster maps to Kubernetes clusters running Agones and is
+// used to manage fleets within clusters.
+service GameServerClustersService {
+  option (google.api.default_host) = "gameservices.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // Lists Game Server Clusters in a given project and location.
+  rpc ListGameServerClusters(ListGameServerClustersRequest) returns (ListGameServerClustersResponse) {
+    option (google.api.http) = {
+      get: "/v1beta/{parent=projects/*/locations/*/realms/*}/gameServerClusters"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Gets details of a single game server cluster.
+  rpc GetGameServerCluster(GetGameServerClusterRequest) returns (GameServerCluster) {
+    option (google.api.http) = {
+      get: "/v1beta/{name=projects/*/locations/*/realms/*/gameServerClusters/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Creates a new game server cluster in a given project and location.
+  rpc CreateGameServerCluster(CreateGameServerClusterRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta/{parent=projects/*/locations/*/realms/*}/gameServerClusters"
+      body: "game_server_cluster"
+    };
+    option (google.api.method_signature) = "parent,game_server_cluster,game_server_cluster_id";
+    option (google.longrunning.operation_info) = {
+      response_type: "GameServerCluster"
+      metadata_type: "OperationMetadata"
+    };
+  }
+
+  // Previews creation of a new game server cluster in a given project and
+  // location.
+  rpc PreviewCreateGameServerCluster(PreviewCreateGameServerClusterRequest) returns (PreviewCreateGameServerClusterResponse) {
+    option (google.api.http) = {
+      post: "/v1beta/{parent=projects/*/locations/*/realms/*}/gameServerClusters:previewCreate"
+      body: "game_server_cluster"
+    };
+  }
+
+  // Deletes a single game server cluster.
+  rpc DeleteGameServerCluster(DeleteGameServerClusterRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      delete: "/v1beta/{name=projects/*/locations/*/realms/*/gameServerClusters/*}"
+    };
+    option (google.api.method_signature) = "name";
+    option (google.longrunning.operation_info) = {
+      response_type: "GameServerCluster"
+      metadata_type: "OperationMetadata"
+    };
+  }
+
+  // Previews deletion of a single game server cluster.
+  rpc PreviewDeleteGameServerCluster(PreviewDeleteGameServerClusterRequest) returns (PreviewDeleteGameServerClusterResponse) {
+    option (google.api.http) = {
+      delete: "/v1beta/{name=projects/*/locations/*/realms/*/gameServerClusters/*}:previewDelete"
+    };
+  }
+
+  // Patches a single game server cluster.
+  rpc UpdateGameServerCluster(UpdateGameServerClusterRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      patch: "/v1beta/{game_server_cluster.name=projects/*/locations/*/realms/*/gameServerClusters/*}"
+      body: "game_server_cluster"
+    };
+    option (google.api.method_signature) = "game_server_cluster,update_mask";
+    option (google.longrunning.operation_info) = {
+      response_type: "GameServerCluster"
+      metadata_type: "OperationMetadata"
+    };
+  }
+
+  // Previews updating a GameServerCluster.
+  rpc PreviewUpdateGameServerCluster(PreviewUpdateGameServerClusterRequest) returns (PreviewUpdateGameServerClusterResponse) {
+    option (google.api.http) = {
+      patch: "/v1beta/{game_server_cluster.name=projects/*/locations/*/realms/*/gameServerClusters/*}:previewUpdate"
+      body: "game_server_cluster"
+    };
+  }
+}
diff --git a/third_party/googleapis/google/cloud/gaming/v1beta/game_server_configs.proto b/third_party/googleapis/google/cloud/gaming/v1beta/game_server_configs.proto
new file mode 100644
index 000000000..ea0820bd7
--- /dev/null
+++ b/third_party/googleapis/google/cloud/gaming/v1beta/game_server_configs.proto
@@ -0,0 +1,180 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.gaming.v1beta;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/gaming/v1beta/common.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/gaming/v1beta;gaming";
+
+option java_multiple_files = true;
+option java_package = "com.google.cloud.gaming.v1beta";
+
+// Request message for GameServerConfigsService.ListGameServerConfigs.
+message ListGameServerConfigsRequest {
+  // Required. The parent resource name. Uses the form:
+  //
+  // `projects/{project}/locations/{location}/gameServerDeployments/{deployment}/configs/*`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "gameservices.googleapis.com/GameServerConfig"
+    }
+  ];
+
+  // Optional. The maximum number of items to return.  If unspecified, server
+  // will pick an appropriate default. Server may return fewer items than
+  // requested. A caller should only rely on response's
+  // [next_page_token][google.cloud.gaming.v1beta.ListGameServerConfigsResponse.next_page_token] to
+  // determine if there are more GameServerConfigs left to be queried.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The next_page_token value returned from a previous List request, if any.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The filter to apply to list results.
+  string filter = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Specifies the ordering of results following syntax at
+  // https://cloud.google.com/apis/design/design_patterns#sorting_order.
+  string order_by = 5 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response message for GameServerConfigsService.ListGameServerConfigs.
+message ListGameServerConfigsResponse {
+  // The list of Game Server Configs.
+  repeated GameServerConfig game_server_configs = 1;
+
+  // Token to retrieve the next page of results, or empty if there are no more
+  // results in the list.
+  string next_page_token = 2;
+
+  // List of Locations that could not be reached.
+  repeated string unreachable = 4;
+}
+
+// Request message for GameServerConfigsService.GetGameServerConfig.
+message GetGameServerConfigRequest {
+  // Required. The name of the Game Server Config to retrieve. Uses the form:
+  //
+  // `projects/{project}/locations/{location}/gameServerDeployments/{deployment}/configs/{config}`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "gameservices.googleapis.com/GameServerConfig"
+    }
+  ];
+}
+
+// Request message for GameServerConfigsService.CreateGameServerConfig.
+message CreateGameServerConfigRequest {
+  // Required. The parent resource name. Uses the form:
+  //
+  // `projects/{project}/locations/{location}/gameServerDeployments/{deployment}/`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "gameservices.googleapis.com/GameServerConfig"
+    }
+  ];
+
+  // Required. The ID of the Game Server Config resource to be created.
+  string config_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The Game Server Config resource to be created.
+  GameServerConfig game_server_config = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for GameServerConfigsService.DeleteGameServerConfig.
+message DeleteGameServerConfigRequest {
+  // Required. The name of the Game Server Config to delete. Uses the form:
+  //
+  // `projects/{project}/locations/{location}/gameServerDeployments/{deployment}/configs/{config}`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "gameservices.googleapis.com/GameServerConfig"
+    }
+  ];
+}
+
+// Autoscaling config for an Agones fleet.
+message ScalingConfig {
+  // Required. The name of the Scaling Config
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Agones fleet autoscaler spec. Example spec:
+  // https://agones.dev/site/docs/reference/fleetautoscaler/
+  string fleet_autoscaler_spec = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Labels used to identify the Game Server Clusters to which this Agones
+  // scaling config applies. A Game Server Cluster is subject to this Agones
+  // scaling config if its labels match any of the selector entries.
+  repeated LabelSelector selectors = 4;
+
+  // The schedules to which this Scaling Config applies.
+  repeated Schedule schedules = 5;
+}
+
+// Fleet configs for Agones.
+message FleetConfig {
+  // Agones fleet spec. Example spec:
+  // `https://agones.dev/site/docs/reference/fleet/`.
+  string fleet_spec = 1;
+
+  // The name of the FleetConfig.
+  string name = 2;
+}
+
+// A Game Server Config resource.
+message GameServerConfig {
+  option (google.api.resource) = {
+    type: "gameservices.googleapis.com/GameServerConfig"
+    pattern: "projects/{project}/locations/{location}/gameServerDeployments/{deployment}/configs/{config}"
+  };
+
+  // The resource name of the Game Server Config. Uses the form:
+  //
+  // `projects/{project}/locations/{location}/gameServerDeployments/{deployment}/configs/{config}`.
+  // For example,
+  //
+  // `projects/my-project/locations/global/gameServerDeployments/my-game/configs/my-config`.
+  string name = 1;
+
+  // Output only. The creation time.
+  google.protobuf.Timestamp create_time = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The last-modified time.
+  google.protobuf.Timestamp update_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // The labels associated with this Game Server Config. Each label is a
+  // key-value pair.
+  map labels = 4;
+
+  // FleetConfig contains a list of Agones fleet specs. Only one FleetConfig
+  // is allowed.
+  repeated FleetConfig fleet_configs = 5;
+
+  // The autoscaling settings.
+  repeated ScalingConfig scaling_configs = 6;
+
+  // The description of the Game Server Config.
+  string description = 7;
+}
diff --git a/third_party/googleapis/google/cloud/gaming/v1beta/game_server_configs_service.proto b/third_party/googleapis/google/cloud/gaming/v1beta/game_server_configs_service.proto
new file mode 100644
index 000000000..29e886c50
--- /dev/null
+++ b/third_party/googleapis/google/cloud/gaming/v1beta/game_server_configs_service.proto
@@ -0,0 +1,78 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.gaming.v1beta;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/cloud/gaming/v1beta/game_server_configs.proto";
+import "google/longrunning/operations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/gaming/v1beta;gaming";
+
+option java_multiple_files = true;
+option java_package = "com.google.cloud.gaming.v1beta";
+
+// The Game Server Config configures the game servers in an Agones fleet.
+service GameServerConfigsService {
+  option (google.api.default_host) = "gameservices.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // Lists Game Server Configs in a given project, Location, and Game Server
+  // Deployment.
+  rpc ListGameServerConfigs(ListGameServerConfigsRequest) returns (ListGameServerConfigsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta/{parent=projects/*/locations/*/gameServerDeployments/*}/configs"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Gets details of a single Game Server Config.
+  rpc GetGameServerConfig(GetGameServerConfigRequest) returns (GameServerConfig) {
+    option (google.api.http) = {
+      get: "/v1beta/{name=projects/*/locations/*/gameServerDeployments/*/configs/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Creates a new Game Server Config in a given project, Location, and Game
+  // Server Deployment. Game Server Configs are immutable, and are not applied
+  // until referenced in the Game Server Deployment Rollout resource.
+  rpc CreateGameServerConfig(CreateGameServerConfigRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta/{parent=projects/*/locations/*/gameServerDeployments/*}/configs"
+      body: "game_server_config"
+    };
+    option (google.api.method_signature) = "parent,game_server_config";
+    option (google.longrunning.operation_info) = {
+      response_type: "GameServerConfig"
+      metadata_type: "OperationMetadata"
+    };
+  }
+
+  // Deletes a single Game Server Config. The deletion will fail if the Game
+  // Server Config is referenced in a Game Server Deployment Rollout.
+  rpc DeleteGameServerConfig(DeleteGameServerConfigRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      delete: "/v1beta/{name=projects/*/locations/*/gameServerDeployments/*/configs/*}"
+    };
+    option (google.api.method_signature) = "name";
+    option (google.longrunning.operation_info) = {
+      response_type: "GameServerConfig"
+      metadata_type: "OperationMetadata"
+    };
+  }
+}
diff --git a/third_party/googleapis/google/cloud/gaming/v1beta/game_server_deployments.proto b/third_party/googleapis/google/cloud/gaming/v1beta/game_server_deployments.proto
new file mode 100644
index 000000000..2e87e386c
--- /dev/null
+++ b/third_party/googleapis/google/cloud/gaming/v1beta/game_server_deployments.proto
@@ -0,0 +1,305 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.gaming.v1beta;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/gaming/v1beta/common.proto";
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/gaming/v1beta;gaming";
+
+option java_multiple_files = true;
+option java_package = "com.google.cloud.gaming.v1beta";
+
+// Request message for GameServerDeploymentsService.ListGameServerDeployments.
+message ListGameServerDeploymentsRequest {
+  // Required. The parent resource name. Uses the form:
+  // `projects/{project}/locations/{location}`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "gameservices.googleapis.com/GameServerDeployment"
+    }
+  ];
+
+  // Optional. The maximum number of items to return.  If unspecified, server
+  // will pick an appropriate default. Server may return fewer items than
+  // requested. A caller should only rely on response's
+  // [next_page_token][google.cloud.gaming.v1beta.ListGameServerDeploymentsResponse.next_page_token] to
+  // determine if there are more GameServerDeployments left to be queried.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The next_page_token value returned from a previous List request,
+  // if any.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The filter to apply to list results.
+  string filter = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Specifies the ordering of results following syntax at
+  // https://cloud.google.com/apis/design/design_patterns#sorting_order.
+  string order_by = 5 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response message for GameServerDeploymentsService.ListGameServerDeployments.
+message ListGameServerDeploymentsResponse {
+  // The list of Game Server Delpoyments.
+  repeated GameServerDeployment game_server_deployments = 1;
+
+  // Token to retrieve the next page of results, or empty if there are no more
+  // results in the list.
+  string next_page_token = 2;
+
+  // List of Locations that could not be reached.
+  repeated string unreachable = 4;
+}
+
+// Request message for GameServerDeploymentsService.GetGameServerDeployment.
+message GetGameServerDeploymentRequest {
+  // Required. The name of the Game Server Deployment to retrieve. Uses the form:
+  //
+  // `projects/{project}/locations/{location}/gameServerDeployments/{deployment}`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "gameservices.googleapis.com/GameServerDeployment"
+    }
+  ];
+}
+
+// Request message for
+// GameServerDeploymentsService.GetGameServerDeploymentRollout.
+message GetGameServerDeploymentRolloutRequest {
+  // Required. The name of the Game Server Deployment to retrieve. Uses the form:
+  //
+  // `projects/{project}/locations/{location}/gameServerDeployments/{deployment}/rollout`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "gameservices.googleapis.com/GameServerDeployment"
+    }
+  ];
+}
+
+// Request message for GameServerDeploymentsService.CreateGameServerDeployment.
+message CreateGameServerDeploymentRequest {
+  // Required. The parent resource name. Uses the form:
+  // `projects/{project}/locations/{location}`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "gameservices.googleapis.com/GameServerDeployment"
+    }
+  ];
+
+  // Required. The ID of the Game Server Deployment resource to be created.
+  string deployment_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The Game Server Deployment resource to be created.
+  GameServerDeployment game_server_deployment = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for GameServerDeploymentsService.DeleteGameServerDeployment.
+message DeleteGameServerDeploymentRequest {
+  // Required. The name of the Game Server Deployment to delete. Uses the form:
+  //
+  // `projects/{project}/locations/{location}/gameServerDeployments/{deployment}`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "gameservices.googleapis.com/GameServerDeployment"
+    }
+  ];
+}
+
+// Request message for GameServerDeploymentsService.UpdateGameServerDeployment.
+// Only allows updates for labels.
+message UpdateGameServerDeploymentRequest {
+  // Required. The Game Server Deployment to be updated.
+  // Only fields specified in update_mask are updated.
+  GameServerDeployment game_server_deployment = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Mask of fields to update. At least one path must be supplied in
+  // this field. For the `FieldMask` definition, see
+  //
+  // https:
+  // //developers.google.com/protocol-buffers
+  // // /docs/reference/google.protobuf#fieldmask
+  google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for
+// GameServerDeploymentsService.UpdateGameServerRolloutDeployment.
+message UpdateGameServerDeploymentRolloutRequest {
+  // Required. The Game Server Deployment Rollout to be updated.
+  // Only fields specified in update_mask are updated.
+  GameServerDeploymentRollout rollout = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Mask of fields to update. At least one path must be supplied in
+  // this field. For the `FieldMask` definition, see
+  //
+  // https:
+  // //developers.google.com/protocol-buffers
+  // // /docs/reference/google.protobuf#fieldmask
+  google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for GameServerDeploymentsService.FetchDeploymentState.
+message FetchDeploymentStateRequest {
+  // Required. The name of the Game Server Deployment. Uses the form:
+  //
+  // `projects/{project}/locations/{location}/gameServerDeployments/{deployment}`.
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Response message for GameServerDeploymentsService.FetchDeploymentState.
+message FetchDeploymentStateResponse {
+  // The Game Server Cluster changes made by the Game Server Deployment.
+  message DeployedClusterState {
+    // The name of the cluster.
+    string cluster = 1;
+
+    // The details about the Agones fleets and autoscalers created in the
+    // Game Server Cluster.
+    repeated DeployedFleetDetails fleet_details = 2;
+  }
+
+  // The state of the Game Server Deployment in each Game Server Cluster.
+  repeated DeployedClusterState cluster_state = 1;
+
+  // List of Locations that could not be reached.
+  repeated string unavailable = 2;
+}
+
+// A Game Server Deployment resource.
+message GameServerDeployment {
+  option (google.api.resource) = {
+    type: "gameservices.googleapis.com/GameServerDeployment"
+    pattern: "projects/{project}/locations/{location}/gameServerDeployments/{deployment}"
+  };
+
+  // The resource name of the Game Server Deployment. Uses the form:
+  //
+  // `projects/{project}/locations/{location}/gameServerDeployments/{deployment}`.
+  // For example,
+  //
+  // `projects/my-project/locations/{location}/gameServerDeployments/my-deployment`.
+  string name = 1;
+
+  // Output only. The creation time.
+  google.protobuf.Timestamp create_time = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The last-modified time.
+  google.protobuf.Timestamp update_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // The labels associated with this Game Server Deployment. Each label is a
+  // key-value pair.
+  map labels = 4;
+
+  // ETag of the resource.
+  string etag = 7;
+
+  // Human readable description of the Game Server Deployment.
+  string description = 8;
+}
+
+// A Game Server Config override.
+message GameServerConfigOverride {
+  // Selector chooses the Game Server Config targets.
+  oneof selector {
+    // Selector for choosing applicable realms.
+    RealmSelector realms_selector = 1;
+  }
+
+  // Selects the Game Server Config and how it should be applied.
+  oneof change {
+    // The game server config for this override.
+    string config_version = 100;
+  }
+}
+
+// The Game Server Deployment Rollout which represents the desired rollout
+// state.
+message GameServerDeploymentRollout {
+  option (google.api.resource) = {
+    type: "gameservices.googleapis.com/GameServerDeploymentRollout"
+    pattern: "projects/{project}/locations/{location}/gameServerDeployments/{deployment}/rollout"
+  };
+
+  // The resource name of the Game Server Deployment Rollout. Uses the form:
+  //
+  // `projects/{project}/locations/{location}/gameServerDeployments/{deployment}/rollout`.
+  // For example,
+  //
+  // `projects/my-project/locations/{location}/gameServerDeployments/my-deployment/rollout`.
+  string name = 1;
+
+  // Output only. The creation time.
+  google.protobuf.Timestamp create_time = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The last-modified time.
+  google.protobuf.Timestamp update_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // The default Game Server Config is applied to all Realms unless overridden
+  // in the Rollout. For example,
+  //
+  // `projects/my-project/locations/global/gameServerDeployments/my-game/configs/my-config`.
+  string default_game_server_config = 4;
+
+  // Contains the Game Server Config Rollout overrides. Overrides are processed
+  // in the order they are listed. Once a match is found for a Realm, the rest
+  // of the list is not processed.
+  repeated GameServerConfigOverride game_server_config_overrides = 5;
+
+  // ETag of the resource.
+  string etag = 6;
+}
+
+// Request message for PreviewGameServerDeploymentRollout.
+message PreviewGameServerDeploymentRolloutRequest {
+  // Required. The Game Server Deployment Rollout to be updated.
+  // Only fields specified in update_mask are updated.
+  GameServerDeploymentRollout rollout = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Mask of fields to update. At least one path must be supplied in
+  // this field. For the `FieldMask` definition, see
+  //
+  // https:
+  // //developers.google.com/protocol-buffers
+  // // /docs/reference/google.protobuf#fieldmask
+  google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The target timestamp to compute the preview. Defaults to the immediately
+  // after the proposed Rollout completes.
+  google.protobuf.Timestamp preview_time = 3 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response message for PreviewGameServerDeploymentRollout.
+// This has details about the Agones fleet and autoscaler to be actuated.
+message PreviewGameServerDeploymentRolloutResponse {
+  // Locations that could not be reached on this request.
+  repeated string unavailable = 2;
+
+  // ETag of the Game Server Deployment.
+  string etag = 3;
+
+  // The target state.
+  TargetState target_state = 4;
+}
diff --git a/third_party/googleapis/google/cloud/gaming/v1beta/game_server_deployments_service.proto b/third_party/googleapis/google/cloud/gaming/v1beta/game_server_deployments_service.proto
new file mode 100644
index 000000000..ccacfbacd
--- /dev/null
+++ b/third_party/googleapis/google/cloud/gaming/v1beta/game_server_deployments_service.proto
@@ -0,0 +1,133 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.gaming.v1beta;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/cloud/gaming/v1beta/game_server_deployments.proto";
+import "google/longrunning/operations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/gaming/v1beta;gaming";
+
+option java_multiple_files = true;
+option java_package = "com.google.cloud.gaming.v1beta";
+
+// The Game Server Deployment is used to control the deployment of Agones
+// fleets.
+service GameServerDeploymentsService {
+  option (google.api.default_host) = "gameservices.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // Lists Game Server Deployments in a given project and Location.
+  rpc ListGameServerDeployments(ListGameServerDeploymentsRequest) returns (ListGameServerDeploymentsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta/{parent=projects/*/locations/*}/gameServerDeployments"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Gets details of a single Game Server Deployment.
+  rpc GetGameServerDeployment(GetGameServerDeploymentRequest) returns (GameServerDeployment) {
+    option (google.api.http) = {
+      get: "/v1beta/{name=projects/*/locations/*/gameServerDeployments/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Creates a new Game Server Deployment in a given project and Location.
+  rpc CreateGameServerDeployment(CreateGameServerDeploymentRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta/{parent=projects/*/locations/*}/gameServerDeployments"
+      body: "game_server_deployment"
+    };
+    option (google.api.method_signature) = "parent,game_server_deployment";
+    option (google.longrunning.operation_info) = {
+      response_type: "GameServerDeployment"
+      metadata_type: "OperationMetadata"
+    };
+  }
+
+  // Deletes a single Game Server Deployment.
+  rpc DeleteGameServerDeployment(DeleteGameServerDeploymentRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      delete: "/v1beta/{name=projects/*/locations/*/gameServerDeployments/*}"
+    };
+    option (google.api.method_signature) = "name";
+    option (google.longrunning.operation_info) = {
+      response_type: "GameServerDeployment"
+      metadata_type: "OperationMetadata"
+    };
+  }
+
+  // Patches a Game Server Deployment.
+  rpc UpdateGameServerDeployment(UpdateGameServerDeploymentRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      patch: "/v1beta/{game_server_deployment.name=projects/*/locations/*/gameServerDeployments/*}"
+      body: "game_server_deployment"
+    };
+    option (google.api.method_signature) = "game_server_deployment,update_mask";
+    option (google.longrunning.operation_info) = {
+      response_type: "GameServerDeployment"
+      metadata_type: "OperationMetadata"
+    };
+  }
+
+  // Gets details a single Game Server Deployment Rollout.
+  rpc GetGameServerDeploymentRollout(GetGameServerDeploymentRolloutRequest) returns (GameServerDeploymentRollout) {
+    option (google.api.http) = {
+      get: "/v1beta/{name=projects/*/locations/*/gameServerDeployments/*}/rollout"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Patches a single Game Server Deployment Rollout.
+  // The method will not return an error if the update does not affect any
+  // existing realms. For example - if the default_game_server_config is changed
+  // but all existing realms use the override, that is valid. Similarly, if a
+  // non existing realm is explicitly called out in game_server_config_overrides
+  // field, that will also not result in an error.
+  rpc UpdateGameServerDeploymentRollout(UpdateGameServerDeploymentRolloutRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      patch: "/v1beta/{rollout.name=projects/*/locations/*/gameServerDeployments/*}/rollout"
+      body: "rollout"
+    };
+    option (google.api.method_signature) = "rollout,update_mask";
+    option (google.longrunning.operation_info) = {
+      response_type: "GameServerDeployment"
+      metadata_type: "OperationMetadata"
+    };
+  }
+
+  // Previews the Game Server Deployment Rollout. This API does not mutate the
+  // Rollout resource.
+  rpc PreviewGameServerDeploymentRollout(PreviewGameServerDeploymentRolloutRequest) returns (PreviewGameServerDeploymentRolloutResponse) {
+    option (google.api.http) = {
+      patch: "/v1beta/{rollout.name=projects/*/locations/*/gameServerDeployments/*}/rollout:preview"
+      body: "rollout"
+    };
+  }
+
+  // Retrieves information about the current state of the Game Server
+  // Ddeployment. Gathers all the Agones fleets and Agones autoscalers,
+  // including fleets running an older version of the Game Server Deployment.
+  rpc FetchDeploymentState(FetchDeploymentStateRequest) returns (FetchDeploymentStateResponse) {
+    option (google.api.http) = {
+      post: "/v1beta/{name=projects/*/locations/*/gameServerDeployments/*}:fetchDeploymentState"
+      body: "*"
+    };
+  }
+}
diff --git a/third_party/googleapis/google/cloud/gaming/v1beta/gameservices_v1beta.yaml b/third_party/googleapis/google/cloud/gaming/v1beta/gameservices_v1beta.yaml
new file mode 100644
index 000000000..dd3360396
--- /dev/null
+++ b/third_party/googleapis/google/cloud/gaming/v1beta/gameservices_v1beta.yaml
@@ -0,0 +1,85 @@
+type: google.api.Service
+config_version: 3
+name: gameservices.googleapis.com
+title: Game Servers API
+
+apis:
+- name: google.cloud.gaming.v1beta.GameServerClustersService
+- name: google.cloud.gaming.v1beta.GameServerConfigsService
+- name: google.cloud.gaming.v1beta.GameServerDeploymentsService
+- name: google.cloud.gaming.v1beta.RealmsService
+
+types:
+- name: google.cloud.gaming.v1beta.LabelSelector
+- name: google.cloud.gaming.v1beta.OperationMetadata
+- name: google.cloud.gaming.v1beta.Schedule
+
+documentation:
+  summary: Deploy and manage infrastructure for global multiplayer gaming experiences.
+  rules:
+  - selector: google.iam.v1.IAMPolicy.GetIamPolicy
+    description: |-
+      Gets the access control policy for a resource. Returns an empty policy
+      if the resource exists and does not have a policy set.
+
+  - selector: google.iam.v1.IAMPolicy.SetIamPolicy
+    description: |-
+      Sets the access control policy on the specified resource. Replaces
+      any existing policy.
+
+      Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and
+      PERMISSION_DENIED
+
+  - selector: google.iam.v1.IAMPolicy.TestIamPermissions
+    description: |-
+      Returns permissions that a caller has on the specified resource. If the
+      resource does not exist, this will return an empty set of
+      permissions, not a NOT_FOUND error.
+
+      Note: This operation is designed to be used for building
+      permission-aware UIs and command-line tools, not for authorization
+      checking. This operation may "fail open" without warning.
+
+backend:
+  rules:
+  - selector: 'google.cloud.gaming.v1beta.GameServerClustersService.*'
+    deadline: 60.0
+  - selector: 'google.cloud.gaming.v1beta.GameServerConfigsService.*'
+    deadline: 60.0
+  - selector: 'google.cloud.gaming.v1beta.GameServerDeploymentsService.*'
+    deadline: 60.0
+  - selector: 'google.cloud.gaming.v1beta.RealmsService.*'
+    deadline: 60.0
+  - selector: 'google.iam.v1.IAMPolicy.*'
+    deadline: 60.0
+  - selector: 'google.longrunning.Operations.*'
+    deadline: 60.0
+  - selector: google.longrunning.Operations.GetOperation
+    deadline: 5.0
+
+authentication:
+  rules:
+  - selector: 'google.cloud.gaming.v1beta.GameServerClustersService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.cloud.gaming.v1beta.GameServerConfigsService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.cloud.gaming.v1beta.GameServerDeploymentsService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.cloud.gaming.v1beta.RealmsService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.iam.v1.IAMPolicy.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/gaming/v1beta/gaming_gapic.yaml b/third_party/googleapis/google/cloud/gaming/v1beta/gaming_gapic.yaml
new file mode 100644
index 000000000..ae7bbe0a4
--- /dev/null
+++ b/third_party/googleapis/google/cloud/gaming/v1beta/gaming_gapic.yaml
@@ -0,0 +1,19 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 2.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.gaming.v1beta
+  python:
+    package_name: google.cloud.gaming_v1beta.gapic
+  ruby:
+    package_name: Google::Cloud::Gaming::V1Beta
+  php:
+    package_name: Google\Cloud\Gaming\V1Beta
+  go:
+    package_name: cloud.google.com/go/gaming/apiv1beta
+  csharp:
+    package_name: Google.Cloud.Gaming.V1Beta
+  nodejs:
+    package_name: gaming.v1beta
+    domain_layer_location: google-cloud
diff --git a/third_party/googleapis/google/cloud/gaming/v1beta/realms.proto b/third_party/googleapis/google/cloud/gaming/v1beta/realms.proto
new file mode 100644
index 000000000..c1fa9982f
--- /dev/null
+++ b/third_party/googleapis/google/cloud/gaming/v1beta/realms.proto
@@ -0,0 +1,189 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.gaming.v1beta;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/gaming/v1beta/common.proto";
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/gaming/v1beta;gaming";
+
+option java_multiple_files = true;
+option java_package = "com.google.cloud.gaming.v1beta";
+
+// Request message for RealmsService.ListRealms.
+message ListRealmsRequest {
+  // Required. The parent resource name. Uses the form:
+  // `projects/{project}/locations/{location}`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "gameservices.googleapis.com/Realm"
+    }
+  ];
+
+  // Optional. The maximum number of items to return.  If unspecified, server
+  // will pick an appropriate default. Server may return fewer items than
+  // requested. A caller should only rely on response's
+  // [next_page_token][google.cloud.gaming.v1beta.ListRealmsResponse.next_page_token] to
+  // determine if there are more Realms left to be queried.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The next_page_token value returned from a previous List request,
+  // if any.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The filter to apply to list results.
+  string filter = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Specifies the ordering of results following syntax at
+  // https://cloud.google.com/apis/design/design_patterns#sorting_order.
+  string order_by = 5 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response message for RealmsService.ListRealms.
+message ListRealmsResponse {
+  // The list of Realms.
+  repeated Realm realms = 1;
+
+  // Token to retrieve the next page of results, or empty if there are no more
+  // results in the list.
+  string next_page_token = 2;
+
+  // List of Locations that could not be reached.
+  repeated string unreachable = 3;
+}
+
+// Request message for RealmsService.GetRealm.
+message GetRealmRequest {
+  // Required. The name of the Realm to retrieve. Uses the form:
+  // `projects/{project}/locations/{location}/realms/{realm}`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "gameservices.googleapis.com/Realm"
+    }
+  ];
+}
+
+// Request message for RealmsService.CreateRealm.
+message CreateRealmRequest {
+  // Required. The parent resource name. Uses the form:
+  // `projects/{project}/locations/{location}`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "gameservices.googleapis.com/Realm"
+    }
+  ];
+
+  // Required. The ID of the Realm resource to be created.
+  string realm_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The Realm resource to be created.
+  Realm realm = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for RealmsService.DeleteRealm.
+message DeleteRealmRequest {
+  // Required. The name of the Realm to delete. Uses the form:
+  // `projects/{project}/locations/{location}/realms/{realm}`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "gameservices.googleapis.com/Realm"
+    }
+  ];
+}
+
+// Request message for RealmsService.UpdateRealm.
+message UpdateRealmRequest {
+  // Required. The Realm to be updated.
+  // Only fields specified in update_mask are updated.
+  Realm realm = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The update mask applies to the resource. For the `FieldMask`
+  // definition, see
+  //
+  // https:
+  // //developers.google.com/protocol-buffers
+  // // /docs/reference/google.protobuf#fieldmask
+  google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for RealmsService.PreviewRealmUpdate.
+message PreviewRealmUpdateRequest {
+  // Required. The Realm to be updated.
+  // Only fields specified in update_mask are updated.
+  Realm realm = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The update mask applies to the resource. For the `FieldMask`
+  // definition, see
+  //
+  // https:
+  // //developers.google.com/protocol-buffers
+  // // /docs/reference/google.protobuf#fieldmask
+  google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The target timestamp to compute the preview.
+  google.protobuf.Timestamp preview_time = 3 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response message for RealmsService.PreviewRealmUpdate.
+message PreviewRealmUpdateResponse {
+  // ETag of the realm.
+  string etag = 2;
+
+  // The target state.
+  TargetState target_state = 3;
+}
+
+// A Realm resource.
+message Realm {
+  option (google.api.resource) = {
+    type: "gameservices.googleapis.com/Realm"
+    pattern: "projects/{project}/locations/{location}/realms/{realm}"
+  };
+
+  // The resource name of the Realm. Uses the form:
+  // `projects/{project}/locations/{location}/realms/{realm}`. For
+  // example, `projects/my-project/locations/{location}/realms/my-realm`.
+  string name = 1;
+
+  // Output only. The creation time.
+  google.protobuf.Timestamp create_time = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The last-modified time.
+  google.protobuf.Timestamp update_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // The labels associated with this Realm. Each label is a key-value pair.
+  map labels = 4;
+
+  // Required. Time zone where all policies targeting this Realm are evaluated. The value
+  // of this field must be from the IANA time zone database:
+  // https://www.iana.org/time-zones.
+  string time_zone = 6 [(google.api.field_behavior) = REQUIRED];
+
+  // ETag of the resource.
+  string etag = 7;
+
+  // Human readable description of the Realm.
+  string description = 8;
+}
diff --git a/third_party/googleapis/google/cloud/gaming/v1beta/realms_service.proto b/third_party/googleapis/google/cloud/gaming/v1beta/realms_service.proto
new file mode 100644
index 000000000..4c87cac3d
--- /dev/null
+++ b/third_party/googleapis/google/cloud/gaming/v1beta/realms_service.proto
@@ -0,0 +1,96 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.gaming.v1beta;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/cloud/gaming/v1beta/realms.proto";
+import "google/longrunning/operations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/gaming/v1beta;gaming";
+
+option java_multiple_files = true;
+option java_package = "com.google.cloud.gaming.v1beta";
+
+// A Realm is a grouping of Game Server Clusters that are considered
+// interchangeable.
+service RealmsService {
+  option (google.api.default_host) = "gameservices.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // Lists Realms in a given project and Location.
+  rpc ListRealms(ListRealmsRequest) returns (ListRealmsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta/{parent=projects/*/locations/*}/realms"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Gets details of a single Realm.
+  rpc GetRealm(GetRealmRequest) returns (Realm) {
+    option (google.api.http) = {
+      get: "/v1beta/{name=projects/*/locations/*/realms/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Creates a new Realm in a given project and Location.
+  rpc CreateRealm(CreateRealmRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta/{parent=projects/*/locations/*}/realms"
+      body: "realm"
+    };
+    option (google.api.method_signature) = "parent,realm,realm_id";
+    option (google.longrunning.operation_info) = {
+      response_type: "Realm"
+      metadata_type: "OperationMetadata"
+    };
+  }
+
+  // Deletes a single Realm.
+  rpc DeleteRealm(DeleteRealmRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      delete: "/v1beta/{name=projects/*/locations/*/realms/*}"
+    };
+    option (google.api.method_signature) = "name";
+    option (google.longrunning.operation_info) = {
+      response_type: "Realm"
+      metadata_type: "OperationMetadata"
+    };
+  }
+
+  // Patches a single Realm.
+  rpc UpdateRealm(UpdateRealmRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      patch: "/v1beta/{realm.name=projects/*/locations/*/realms/*}"
+      body: "realm"
+    };
+    option (google.api.method_signature) = "realm,update_mask";
+    option (google.longrunning.operation_info) = {
+      response_type: "Realm"
+      metadata_type: "OperationMetadata"
+    };
+  }
+
+  // Previews patches to a single Realm.
+  rpc PreviewRealmUpdate(PreviewRealmUpdateRequest) returns (PreviewRealmUpdateResponse) {
+    option (google.api.http) = {
+      patch: "/v1beta/{realm.name=projects/*/locations/*/realms/*}:previewUpdate"
+      body: "realm"
+    };
+  }
+}
diff --git a/third_party/googleapis/google/cloud/iot/BUILD.bazel b/third_party/googleapis/google/cloud/iot/BUILD.bazel
index 1e5b8c2af..a87c57fec 100644
--- a/third_party/googleapis/google/cloud/iot/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/iot/BUILD.bazel
@@ -1 +1 @@
-exports_files(glob(["*.yaml"]))
\ No newline at end of file
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/cloud/iot/artman_cloudiot.yaml b/third_party/googleapis/google/cloud/iot/artman_cloudiot.yaml
index 4ff6d9a40..a52a9a284 100644
--- a/third_party/googleapis/google/cloud/iot/artman_cloudiot.yaml
+++ b/third_party/googleapis/google/cloud/iot/artman_cloudiot.yaml
@@ -3,13 +3,14 @@ common:
   api_version: v1
   organization_name: google-cloud
   proto_deps:
-    - name: google-common-protos
-    - name: google-iam-v1
-      proto_path: google/iam/v1
+  - name: google-common-protos
+  - name: google-iam-v1
+    proto_path: google/iam/v1
   src_proto_paths:
   - v1
-  service_yaml: cloudiot.yaml
+  service_yaml: v1/cloudiot_v1.yaml
   gapic_yaml: v1/cloudiot_gapic.yaml
+  proto_package: google.cloud.iot.v1
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/cloud/iot/v1/BUILD.bazel b/third_party/googleapis/google/cloud/iot/v1/BUILD.bazel
index b7a137950..4e582b59d 100644
--- a/third_party/googleapis/google/cloud/iot/v1/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/iot/v1/BUILD.bazel
@@ -1,9 +1,12 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
@@ -14,10 +17,12 @@ proto_library(
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
         "//google/iam/v1:iam_policy_proto",
         "//google/iam/v1:policy_proto",
         "//google/rpc:status_proto",
-        "@com_google_protobuf//:duration_proto",
         "@com_google_protobuf//:empty_proto",
         "@com_google_protobuf//:field_mask_proto",
         "@com_google_protobuf//:timestamp_proto",
@@ -26,7 +31,10 @@ proto_library(
 
 proto_library_with_info(
     name = "iot_proto_with_info",
-    deps = [":iot_proto"],
+    deps = [
+        ":iot_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -34,19 +42,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-    "@com_google_api_grpc_proto_google_iam_v1//jar",
-]
-
 java_proto_library(
     name = "iot_java_proto",
     deps = [":iot_proto"],
@@ -55,51 +57,42 @@ java_proto_library(
 java_grpc_library(
     name = "iot_java_grpc",
     srcs = [":iot_proto"],
-    deps = [":iot_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "iot_resource_name_java_proto",
-    gapic_yaml = "cloudiot_gapic.yaml",
-    deps = [":iot_proto"],
+    deps = [":iot_java_proto"],
 )
 
 java_gapic_library(
     name = "iot_java_gapic",
     src = ":iot_proto_with_info",
     gapic_yaml = "cloudiot_gapic.yaml",
-    service_yaml = "//google/cloud/iot:cloudiot.yaml",
-    test_deps = [":iot_java_grpc"],
+    package = "google.cloud.iot.v1",
+    service_yaml = "cloudiot_v1.yaml",
+    test_deps = [
+        ":iot_java_grpc",
+        "//google/iam/v1:iam_java_grpc",
+    ],
     deps = [
         ":iot_java_proto",
-        ":iot_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+        "//google/iam/v1:iam_java_proto",
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":iot_java_gapic_test",
+java_gapic_test(
+    name = "iot_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.iot.v1.DeviceManagerClientTest",
     ],
-) for test_name in [
-    "com.google.cloud.iot.v1.DeviceManagerClientTest",
-]]
+    runtime_deps = [":iot_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-iot-v1-java",
-    client_deps = [":iot_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":iot_java_gapic_test"],
-    grpc_deps = [":iot_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":iot_java_gapic",
+        ":iot_java_grpc",
         ":iot_java_proto",
         ":iot_proto",
-        ":iot_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -107,10 +100,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -127,10 +120,10 @@ go_proto_library(
 
 go_gapic_library(
     name = "iot_go_gapic",
-    src = ":iot_proto_with_info",
-    gapic_yaml = "cloudiot_gapic.yaml",
-    importpath = "cloud.google.com/go/iot/apiv1",
-    service_yaml = "//google/cloud/iot:cloudiot.yaml",
+    srcs = [":iot_proto_with_info"],
+    grpc_service_config = "cloudiot_grpc_service_config.json",
+    importpath = "cloud.google.com/go/iot/apiv1;iot",
+    service_yaml = "cloudiot_v1.yaml",
     deps = [
         ":iot_go_proto",
         "//google/iam/v1:iam_go_proto",
@@ -144,13 +137,238 @@ go_test(
     importpath = "cloud.google.com/go/iot/apiv1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-iot-v1-go",
     deps = [
         ":iot_go_gapic",
-        ":iot_go_gapic_srcjar-smoke-test.srcjar",
         ":iot_go_gapic_srcjar-test.srcjar",
         ":iot_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "iot_moved_proto",
+    srcs = [":iot_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/iam/v1:iam_policy_proto",
+        "//google/iam/v1:policy_proto",
+        "//google/rpc:status_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "iot_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":iot_moved_proto"],
+)
+
+py_grpc_library(
+    name = "iot_py_grpc",
+    srcs = [":iot_moved_proto"],
+    deps = [":iot_py_proto"],
+)
+
+py_gapic_library(
+    name = "iot_py_gapic",
+    src = ":iot_proto_with_info",
+    gapic_yaml = "cloudiot_gapic.yaml",
+    package = "google.cloud.iot.v1",
+    service_yaml = "cloudiot_v1.yaml",
+    deps = [
+        ":iot_py_grpc",
+        ":iot_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "iot-v1-py",
+    deps = [
+        ":iot_py_gapic",
+        ":iot_py_grpc",
+        ":iot_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "iot_php_proto",
+    deps = [":iot_proto"],
+)
+
+php_grpc_library(
+    name = "iot_php_grpc",
+    srcs = [":iot_proto"],
+    deps = [":iot_php_proto"],
+)
+
+php_gapic_library(
+    name = "iot_php_gapic",
+    src = ":iot_proto_with_info",
+    gapic_yaml = "cloudiot_gapic.yaml",
+    package = "google.cloud.iot.v1",
+    service_yaml = "cloudiot_v1.yaml",
+    deps = [
+        ":iot_php_grpc",
+        ":iot_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-iot-v1-php",
+    deps = [
+        ":iot_php_gapic",
+        ":iot_php_grpc",
+        ":iot_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "iot_nodejs_gapic",
+    src = ":iot_proto_with_info",
+    gapic_yaml = "cloudiot_gapic.yaml",
+    package = "google.cloud.iot.v1",
+    service_yaml = "cloudiot_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "iot-v1-nodejs",
+    deps = [
+        ":iot_nodejs_gapic",
+        ":iot_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "iot_ruby_proto",
+    deps = [":iot_proto"],
+)
+
+ruby_grpc_library(
+    name = "iot_ruby_grpc",
+    srcs = [":iot_proto"],
+    deps = [":iot_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "iot_ruby_gapic",
+    src = ":iot_proto_with_info",
+    gapic_yaml = "cloudiot_gapic.yaml",
+    package = "google.cloud.iot.v1",
+    service_yaml = "cloudiot_v1.yaml",
+    deps = [
+        ":iot_ruby_grpc",
+        ":iot_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-iot-v1-ruby",
+    deps = [
+        ":iot_ruby_gapic",
+        ":iot_ruby_grpc",
+        ":iot_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "iot_csharp_proto",
+    deps = [":iot_proto"],
+)
+
+csharp_grpc_library(
+    name = "iot_csharp_grpc",
+    srcs = [":iot_proto"],
+    deps = [":iot_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "iot_csharp_gapic",
+    src = ":iot_proto_with_info",
+    gapic_yaml = "cloudiot_gapic.yaml",
+    package = "google.cloud.iot.v1",
+    service_yaml = "cloudiot_v1.yaml",
+    deps = [
+        ":iot_csharp_grpc",
+        ":iot_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-iot-v1-csharp",
+    deps = [
+        ":iot_csharp_gapic",
+        ":iot_csharp_grpc",
+        ":iot_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/iot/v1/cloudiot_gapic.legacy.yaml b/third_party/googleapis/google/cloud/iot/v1/cloudiot_gapic.legacy.yaml
new file mode 100644
index 000000000..56a230dfe
--- /dev/null
+++ b/third_party/googleapis/google/cloud/iot/v1/cloudiot_gapic.legacy.yaml
@@ -0,0 +1,513 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.iot.v1
+  python:
+    package_name: google.cloud.iot_v1.gapic
+  go:
+    package_name: cloud.google.com/go/iot/apiv1
+  csharp:
+    package_name: Google.Cloud.Iot.V1
+  ruby:
+    package_name: Google::Cloud::Iot::V1
+  php:
+    package_name: Google\Cloud\Iot\V1
+  nodejs:
+    package_name: iot.v1
+    domain_layer_location: google-cloud
+# A list of API interface configurations.
+interfaces:
+- name: google.cloud.iot.v1.DeviceManager
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}/locations/{location}
+    entity_name: location
+  - name_pattern: projects/{project}/locations/{location}/registries/{registry}
+    entity_name: registry
+  - name_pattern: projects/{project}/locations/{location}/registries/{registry}/devices/{device}
+    entity_name: device
+  # Definition for smoke test.
+  smoke_test:
+    method: ListDeviceRegistries
+    init_fields:
+    - parent%project=$PROJECT_ID
+    - parent%location="us-central1"
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  - name: rate_limited_aware
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+    - RESOURCE_EXHAUSTED
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 120000
+  - name: rate_limited_aware
+    initial_retry_delay_millis: 1000
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 120000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: CreateDeviceRegistry
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - device_registry
+    required_fields:
+    - parent
+    - device_registry
+    header_request_params:
+    - parent
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: GetDeviceRegistry
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: registry
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: UpdateDeviceRegistry
+    flattening:
+      groups:
+      - parameters:
+        - device_registry
+        - update_mask
+    required_fields:
+    - device_registry
+    - update_mask
+    header_request_params:
+    - device_registry.name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      device_registry.name: registry
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: DeleteDeviceRegistry
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: registry
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: ListDeviceRegistries
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    header_request_params:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: device_registries
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: CreateDevice
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - device
+    required_fields:
+    - parent
+    - device
+    header_request_params:
+    - parent
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: registry
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: GetDevice
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: device
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: UpdateDevice
+    flattening:
+      groups:
+      - parameters:
+        - device
+        - update_mask
+    required_fields:
+    - device
+    - update_mask
+    header_request_params:
+    - device.name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      device.name: device
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: DeleteDevice
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: device
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: ListDevices
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    header_request_params:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: devices
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: registry
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: ModifyCloudToDeviceConfig
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - binary_data
+    required_fields:
+    - name
+    - binary_data
+    header_request_params:
+    - name
+    retry_codes_name: rate_limited_aware
+    retry_params_name: rate_limited_aware
+    field_name_patterns:
+      name: device
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: ListDeviceConfigVersions
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: device
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: ListDeviceStates
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: device
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: SetIamPolicy
+    flattening:
+      groups:
+      - parameters:
+        - resource
+        - policy
+    required_fields:
+    - resource
+    - policy
+    header_request_params:
+    - resource
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: registry
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: GetIamPolicy
+    flattening:
+      groups:
+      - parameters:
+        - resource
+    required_fields:
+    - resource
+    header_request_params:
+    - resource
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: registry
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: TestIamPermissions
+    flattening:
+      groups:
+      - parameters:
+        - resource
+        - permissions
+    required_fields:
+    - resource
+    - permissions
+    header_request_params:
+    - resource
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: registry
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: SendCommandToDevice
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - binary_data
+        - subfolder
+    required_fields:
+    - name
+    - binary_data
+    header_request_params:
+    - name
+    retry_codes_name: rate_limited_aware
+    retry_params_name: rate_limited_aware
+    field_name_patterns:
+      name: device
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: BindDeviceToGateway
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - gateway_id
+        - device_id
+    required_fields:
+    - parent
+    - gateway_id
+    - device_id
+    header_request_params:
+    - parent
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: registry
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: UnbindDeviceFromGateway
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - gateway_id
+        - device_id
+    required_fields:
+    - parent
+    - gateway_id
+    - device_id
+    header_request_params:
+    - parent
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: registry
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+resource_name_generation:
+- message_name: google.iam.v1.SetIamPolicyRequest
+  field_entity_map:
+    resource: "*"
+- message_name: google.iam.v1.GetIamPolicyRequest
+  field_entity_map:
+    resource: "*"
+- message_name: google.iam.v1.TestIamPermissionsRequest
+  field_entity_map:
+    resource: "*"
+- message_name: CreateDeviceRegistryRequest
+  field_entity_map:
+    parent: location
+- message_name: GetDeviceRegistryRequest
+  field_entity_map:
+    name: registry
+- message_name: DeleteDeviceRegistryRequest
+  field_entity_map:
+    name: registry
+- message_name: ListDeviceRegistriesRequest
+  field_entity_map:
+    parent: location
+- message_name: CreateDeviceRequest
+  field_entity_map:
+    parent: registry
+- message_name: GetDeviceRequest
+  field_entity_map:
+    name: device
+- message_name: DeleteDeviceRequest
+  field_entity_map:
+    name: device
+- message_name: ListDevicesRequest
+  field_entity_map:
+    parent: registry
+- message_name: ModifyCloudToDeviceConfigRequest
+  field_entity_map:
+    name: device
+- message_name: ListDeviceConfigVersionsRequest
+  field_entity_map:
+    name: device
+- message_name: ListDeviceStatesRequest
+  field_entity_map:
+    name: device
+- message_name: SendCommandToDeviceRequest
+  field_entity_map:
+    name: device
+- message_name: BindDeviceToGatewayRequest
+  field_entity_map:
+    parent: registry
+- message_name: UnbindDeviceFromGatewayRequest
+  field_entity_map:
+    parent: registry
+- message_name: Device
+  field_entity_map:
+    name: device
+- message_name: DeviceRegistry
+  field_entity_map:
+    name: registry
diff --git a/third_party/googleapis/google/cloud/iot/v1/cloudiot_gapic.yaml b/third_party/googleapis/google/cloud/iot/v1/cloudiot_gapic.yaml
index 72ed2c09b..37fef5cac 100644
--- a/third_party/googleapis/google/cloud/iot/v1/cloudiot_gapic.yaml
+++ b/third_party/googleapis/google/cloud/iot/v1/cloudiot_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -8,6 +8,7 @@ language_settings:
     package_name: google.cloud.iot_v1.gapic
   go:
     package_name: cloud.google.com/go/iot/apiv1
+    release_level: GA
   csharp:
     package_name: Google.Cloud.Iot.V1
   ruby:
@@ -17,41 +18,14 @@ language_settings:
   nodejs:
     package_name: iot.v1
     domain_layer_location: google-cloud
-# A list of API interface configurations.
 interfaces:
-  # The fully qualified name of the API interface.
 - name: google.cloud.iot.v1.DeviceManager
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections:
-  - name_pattern: projects/{project}/locations/{location}
-    entity_name: location
-  - name_pattern: projects/{project}/locations/{location}/registries/{registry}
-    entity_name: registry
-  - name_pattern: projects/{project}/locations/{location}/registries/{registry}/devices/{device}
-    entity_name: device
-  # Definition for smoke test.
   smoke_test:
     method: ListDeviceRegistries
     init_fields:
     - parent%project=$PROJECT_ID
     - parent%location="us-central1"
-  # Definition for retryable codes.
   retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
   - name: rate_limited_aware
     retry_codes:
     - UNAVAILABLE
@@ -75,440 +49,14 @@ interfaces:
     rpc_timeout_multiplier: 1
     max_rpc_timeout_millis: 20000
     total_timeout_millis: 120000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
   methods:
-  - name: CreateDeviceRegistry
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - device_registry
-    required_fields:
-    - parent
-    - device_registry
-    header_request_params:
-    - parent
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: GetDeviceRegistry
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: registry
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: UpdateDeviceRegistry
-    flattening:
-      groups:
-      - parameters:
-        - device_registry
-        - update_mask
-    required_fields:
-    - device_registry
-    - update_mask
-    header_request_params:
-    - device_registry.name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      device_registry.name: registry
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
   - name: DeleteDeviceRegistry
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: registry
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: ListDeviceRegistries
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    header_request_params:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: device_registries
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: CreateDevice
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - device
-    required_fields:
-    - parent
-    - device
-    header_request_params:
-    - parent
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: registry
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: GetDevice
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: device
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: UpdateDevice
-    flattening:
-      groups:
-      - parameters:
-        - device
-        - update_mask
-    required_fields:
-    - device
-    - update_mask
-    header_request_params:
-    - device.name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      device.name: device
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
   - name: DeleteDevice
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: device
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: ListDevices
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    header_request_params:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: devices
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: registry
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
   - name: ModifyCloudToDeviceConfig
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - binary_data
-    required_fields:
-    - name
-    - binary_data
-    header_request_params:
-    - name
     retry_codes_name: rate_limited_aware
     retry_params_name: rate_limited_aware
-    field_name_patterns:
-      name: device
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: ListDeviceConfigVersions
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: device
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: ListDeviceStates
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: device
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: SetIamPolicy
-    flattening:
-      groups:
-      - parameters:
-        - resource
-        - policy
-    required_fields:
-    - resource
-    - policy
-    header_request_params:
-    - resource
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      resource: registry
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: GetIamPolicy
-    flattening:
-      groups:
-      - parameters:
-        - resource
-    required_fields:
-    - resource
-    header_request_params:
-    - resource
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      resource: registry
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: TestIamPermissions
-    flattening:
-      groups:
-      - parameters:
-        - resource
-        - permissions
-    required_fields:
-    - resource
-    - permissions
-    header_request_params:
-    - resource
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      resource: registry
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
   - name: SendCommandToDevice
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - binary_data
-        - subfolder
-    required_fields:
-    - name
-    - binary_data
-    header_request_params:
-    - name
     retry_codes_name: rate_limited_aware
     retry_params_name: rate_limited_aware
-    field_name_patterns:
-      name: device
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: BindDeviceToGateway
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - gateway_id
-        - device_id
-    required_fields:
-    - parent
-    - gateway_id
-    - device_id
-    header_request_params:
-    - parent
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: registry
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: UnbindDeviceFromGateway
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - gateway_id
-        - device_id
-    required_fields:
-    - parent
-    - gateway_id
-    - device_id
-    header_request_params:
-    - parent
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: registry
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-resource_name_generation:
-- message_name: google.iam.v1.SetIamPolicyRequest
-  field_entity_map:
-    resource: "*"
-- message_name: google.iam.v1.GetIamPolicyRequest
-  field_entity_map:
-    resource: "*"
-- message_name: google.iam.v1.TestIamPermissionsRequest
-  field_entity_map:
-    resource: "*"
-- message_name: CreateDeviceRegistryRequest
-  field_entity_map:
-    parent: location
-- message_name: GetDeviceRegistryRequest
-  field_entity_map:
-    name: registry
-- message_name: DeleteDeviceRegistryRequest
-  field_entity_map:
-    name: registry
-- message_name: ListDeviceRegistriesRequest
-  field_entity_map:
-    parent: location
-- message_name: CreateDeviceRequest
-  field_entity_map:
-    parent: registry
-- message_name: GetDeviceRequest
-  field_entity_map:
-    name: device
-- message_name: DeleteDeviceRequest
-  field_entity_map:
-    name: device
-- message_name: ListDevicesRequest
-  field_entity_map:
-    parent: registry
-- message_name: ModifyCloudToDeviceConfigRequest
-  field_entity_map:
-    name: device
-- message_name: ListDeviceConfigVersionsRequest
-  field_entity_map:
-    name: device
-- message_name: ListDeviceStatesRequest
-  field_entity_map:
-    name: device
-- message_name: SendCommandToDeviceRequest
-  field_entity_map:
-    name: device
-- message_name: BindDeviceToGatewayRequest
-  field_entity_map:
-    parent: registry
-- message_name: UnbindDeviceFromGatewayRequest
-  field_entity_map:
-    parent: registry
-- message_name: Device
-  field_entity_map:
-    name: device
-- message_name: DeviceRegistry
-  field_entity_map:
-    name: registry
diff --git a/third_party/googleapis/google/cloud/iot/v1/cloudiot_grpc_service_config.json b/third_party/googleapis/google/cloud/iot/v1/cloudiot_grpc_service_config.json
new file mode 100755
index 000000000..29a978646
--- /dev/null
+++ b/third_party/googleapis/google/cloud/iot/v1/cloudiot_grpc_service_config.json
@@ -0,0 +1,114 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.iot.v1.DeviceManager",
+          "method": "CreateDeviceRegistry"
+        },
+        {
+          "service": "google.cloud.iot.v1.DeviceManager",
+          "method": "UpdateDeviceRegistry"
+        },
+        {
+          "service": "google.cloud.iot.v1.DeviceManager",
+          "method": "CreateDevice"
+        },
+        {
+          "service": "google.cloud.iot.v1.DeviceManager",
+          "method": "UpdateDevice"
+        },
+        {
+          "service": "google.cloud.iot.v1.DeviceManager",
+          "method": "SetIamPolicy"
+        },
+        {
+          "service": "google.cloud.iot.v1.DeviceManager",
+          "method": "GetIamPolicy"
+        },
+        {
+          "service": "google.cloud.iot.v1.DeviceManager",
+          "method": "TestIamPermissions"
+        },
+        {
+          "service": "google.cloud.iot.v1.DeviceManager",
+          "method": "BindDeviceToGateway"
+        },
+        {
+          "service": "google.cloud.iot.v1.DeviceManager",
+          "method": "UnbindDeviceFromGateway"
+        }
+      ],
+      "timeout": "120s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.iot.v1.DeviceManager",
+          "method": "GetDeviceRegistry"
+        },
+        {
+          "service": "google.cloud.iot.v1.DeviceManager",
+          "method": "DeleteDeviceRegistry"
+        },
+        {
+          "service": "google.cloud.iot.v1.DeviceManager",
+          "method": "ListDeviceRegistries"
+        },
+        {
+          "service": "google.cloud.iot.v1.DeviceManager",
+          "method": "GetDevice"
+        },
+        {
+          "service": "google.cloud.iot.v1.DeviceManager",
+          "method": "DeleteDevice"
+        },
+        {
+          "service": "google.cloud.iot.v1.DeviceManager",
+          "method": "ListDevices"
+        },
+        {
+          "service": "google.cloud.iot.v1.DeviceManager",
+          "method": "ListDeviceConfigVersions"
+        },
+        {
+          "service": "google.cloud.iot.v1.DeviceManager",
+          "method": "ListDeviceStates"
+        }
+      ],
+      "timeout": "120s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.iot.v1.DeviceManager",
+          "method": "ModifyCloudToDeviceConfig"
+        },
+        {
+          "service": "google.cloud.iot.v1.DeviceManager",
+          "method": "SendCommandToDevice"
+        }
+      ],
+      "timeout": "120s",
+      "retryPolicy": {
+        "initialBackoff": "1s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED",
+          "RESOURCE_EXHAUSTED"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/iot/cloudiot.yaml b/third_party/googleapis/google/cloud/iot/v1/cloudiot_v1.yaml
similarity index 73%
rename from third_party/googleapis/google/cloud/iot/cloudiot.yaml
rename to third_party/googleapis/google/cloud/iot/v1/cloudiot_v1.yaml
index 2529f622a..efb20dbd3 100644
--- a/third_party/googleapis/google/cloud/iot/cloudiot.yaml
+++ b/third_party/googleapis/google/cloud/iot/v1/cloudiot_v1.yaml
@@ -11,9 +11,14 @@ documentation:
     Registers and manages IoT (Internet of Things) devices that connect to the
     Google Cloud Platform.
 
+backend:
+  rules:
+  - selector: google.cloud.iot.v1.DeviceManager.SendCommandToDevice
+    deadline: 60.0
+
 authentication:
   rules:
-  - selector: '*'
+  - selector: 'google.cloud.iot.v1.DeviceManager.*'
     oauth:
       canonical_scopes: |-
         https://www.googleapis.com/auth/cloud-platform,
diff --git a/third_party/googleapis/google/cloud/iot/v1/device_manager.proto b/third_party/googleapis/google/cloud/iot/v1/device_manager.proto
index 27ec0f030..44d11afe6 100644
--- a/third_party/googleapis/google/cloud/iot/v1/device_manager.proto
+++ b/third_party/googleapis/google/cloud/iot/v1/device_manager.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,13 +18,14 @@ syntax = "proto3";
 package google.cloud.iot.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/iot/v1/resources.proto";
 import "google/iam/v1/iam_policy.proto";
 import "google/iam/v1/policy.proto";
-import "google/protobuf/duration.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
-import "google/protobuf/timestamp.proto";
 import "google/rpc/status.proto";
 
 option cc_enable_arenas = true;
@@ -35,13 +36,18 @@ option java_package = "com.google.cloud.iot.v1";
 
 // Internet of Things (IoT) service. Securely connect and manage IoT devices.
 service DeviceManager {
+  option (google.api.default_host) = "cloudiot.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/cloudiot";
+
   // Creates a device registry that contains devices.
-  rpc CreateDeviceRegistry(CreateDeviceRegistryRequest)
-      returns (DeviceRegistry) {
+  rpc CreateDeviceRegistry(CreateDeviceRegistryRequest) returns (DeviceRegistry) {
     option (google.api.http) = {
       post: "/v1/{parent=projects/*/locations/*}/registries"
       body: "device_registry"
     };
+    option (google.api.method_signature) = "parent,device_registry";
   }
 
   // Gets a device registry configuration.
@@ -49,31 +55,32 @@ service DeviceManager {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/locations/*/registries/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Updates a device registry configuration.
-  rpc UpdateDeviceRegistry(UpdateDeviceRegistryRequest)
-      returns (DeviceRegistry) {
+  rpc UpdateDeviceRegistry(UpdateDeviceRegistryRequest) returns (DeviceRegistry) {
     option (google.api.http) = {
       patch: "/v1/{device_registry.name=projects/*/locations/*/registries/*}"
       body: "device_registry"
     };
+    option (google.api.method_signature) = "device_registry,update_mask";
   }
 
   // Deletes a device registry configuration.
-  rpc DeleteDeviceRegistry(DeleteDeviceRegistryRequest)
-      returns (google.protobuf.Empty) {
+  rpc DeleteDeviceRegistry(DeleteDeviceRegistryRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v1/{name=projects/*/locations/*/registries/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists device registries.
-  rpc ListDeviceRegistries(ListDeviceRegistriesRequest)
-      returns (ListDeviceRegistriesResponse) {
+  rpc ListDeviceRegistries(ListDeviceRegistriesRequest) returns (ListDeviceRegistriesResponse) {
     option (google.api.http) = {
       get: "/v1/{parent=projects/*/locations/*}/registries"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Creates a device in a device registry.
@@ -82,6 +89,7 @@ service DeviceManager {
       post: "/v1/{parent=projects/*/locations/*/registries/*}/devices"
       body: "device"
     };
+    option (google.api.method_signature) = "parent,device";
   }
 
   // Gets details about a device.
@@ -92,6 +100,7 @@ service DeviceManager {
         get: "/v1/{name=projects/*/locations/*/registries/*/groups/*/devices/*}"
       }
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Updates a device.
@@ -104,6 +113,7 @@ service DeviceManager {
         body: "device"
       }
     };
+    option (google.api.method_signature) = "device,update_mask";
   }
 
   // Deletes a device.
@@ -111,6 +121,7 @@ service DeviceManager {
     option (google.api.http) = {
       delete: "/v1/{name=projects/*/locations/*/registries/*/devices/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // List devices in a device registry.
@@ -121,13 +132,13 @@ service DeviceManager {
         get: "/v1/{parent=projects/*/locations/*/registries/*/groups/*}/devices"
       }
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Modifies the configuration for the device, which is eventually sent from
   // the Cloud IoT Core servers. Returns the modified configuration version and
   // its metadata.
-  rpc ModifyCloudToDeviceConfig(ModifyCloudToDeviceConfigRequest)
-      returns (DeviceConfig) {
+  rpc ModifyCloudToDeviceConfig(ModifyCloudToDeviceConfigRequest) returns (DeviceConfig) {
     option (google.api.http) = {
       post: "/v1/{name=projects/*/locations/*/registries/*/devices/*}:modifyCloudToDeviceConfig"
       body: "*"
@@ -136,36 +147,36 @@ service DeviceManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "name,binary_data";
   }
 
   // Lists the last few versions of the device configuration in descending
   // order (i.e.: newest first).
-  rpc ListDeviceConfigVersions(ListDeviceConfigVersionsRequest)
-      returns (ListDeviceConfigVersionsResponse) {
+  rpc ListDeviceConfigVersions(ListDeviceConfigVersionsRequest) returns (ListDeviceConfigVersionsResponse) {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/locations/*/registries/*/devices/*}/configVersions"
       additional_bindings {
         get: "/v1/{name=projects/*/locations/*/registries/*/groups/*/devices/*}/configVersions"
       }
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists the last few versions of the device state in descending order (i.e.:
   // newest first).
-  rpc ListDeviceStates(ListDeviceStatesRequest)
-      returns (ListDeviceStatesResponse) {
+  rpc ListDeviceStates(ListDeviceStatesRequest) returns (ListDeviceStatesResponse) {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/locations/*/registries/*/devices/*}/states"
       additional_bindings {
         get: "/v1/{name=projects/*/locations/*/registries/*/groups/*/devices/*}/states"
       }
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Sets the access control policy on the specified resource. Replaces any
   // existing policy.
-  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest)
-      returns (google.iam.v1.Policy) {
+  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) returns (google.iam.v1.Policy) {
     option (google.api.http) = {
       post: "/v1/{resource=projects/*/locations/*/registries/*}:setIamPolicy"
       body: "*"
@@ -174,13 +185,13 @@ service DeviceManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "resource,policy";
   }
 
   // Gets the access control policy for a resource.
   // Returns an empty policy if the resource exists and does not have a policy
   // set.
-  rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest)
-      returns (google.iam.v1.Policy) {
+  rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) returns (google.iam.v1.Policy) {
     option (google.api.http) = {
       post: "/v1/{resource=projects/*/locations/*/registries/*}:getIamPolicy"
       body: "*"
@@ -189,13 +200,13 @@ service DeviceManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "resource";
   }
 
   // Returns permissions that a caller has on the specified resource.
   // If the resource does not exist, this will return an empty set of
   // permissions, not a NOT_FOUND error.
-  rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest)
-      returns (google.iam.v1.TestIamPermissionsResponse) {
+  rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest) returns (google.iam.v1.TestIamPermissionsResponse) {
     option (google.api.http) = {
       post: "/v1/{resource=projects/*/locations/*/registries/*}:testIamPermissions"
       body: "*"
@@ -204,6 +215,7 @@ service DeviceManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "resource,permissions";
   }
 
   // Sends a command to the specified device. In order for a device to be able
@@ -219,8 +231,7 @@ service DeviceManager {
   // method will return FAILED_PRECONDITION. Otherwise, this method will
   // return OK. If the subscription is QoS 1, at least once delivery will be
   // guaranteed; for QoS 0, no acknowledgment will be expected from the device.
-  rpc SendCommandToDevice(SendCommandToDeviceRequest)
-      returns (SendCommandToDeviceResponse) {
+  rpc SendCommandToDevice(SendCommandToDeviceRequest) returns (SendCommandToDeviceResponse) {
     option (google.api.http) = {
       post: "/v1/{name=projects/*/locations/*/registries/*/devices/*}:sendCommandToDevice"
       body: "*"
@@ -229,11 +240,12 @@ service DeviceManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "name,binary_data";
+    option (google.api.method_signature) = "name,binary_data,subfolder";
   }
 
   // Associates the device with the gateway.
-  rpc BindDeviceToGateway(BindDeviceToGatewayRequest)
-      returns (BindDeviceToGatewayResponse) {
+  rpc BindDeviceToGateway(BindDeviceToGatewayRequest) returns (BindDeviceToGatewayResponse) {
     option (google.api.http) = {
       post: "/v1/{parent=projects/*/locations/*/registries/*}:bindDeviceToGateway"
       body: "*"
@@ -242,11 +254,11 @@ service DeviceManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "parent,gateway_id,device_id";
   }
 
   // Deletes the association between the device and the gateway.
-  rpc UnbindDeviceFromGateway(UnbindDeviceFromGatewayRequest)
-      returns (UnbindDeviceFromGatewayResponse) {
+  rpc UnbindDeviceFromGateway(UnbindDeviceFromGatewayRequest) returns (UnbindDeviceFromGatewayResponse) {
     option (google.api.http) = {
       post: "/v1/{parent=projects/*/locations/*/registries/*}:unbindDeviceFromGateway"
       body: "*"
@@ -255,55 +267,76 @@ service DeviceManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "parent,gateway_id,device_id";
   }
 }
 
 // Request for `CreateDeviceRegistry`.
 message CreateDeviceRegistryRequest {
-  // The project and cloud region where this device registry must be created.
+  // Required. The project and cloud region where this device registry must be created.
   // For example, `projects/example-project/locations/us-central1`.
-  string parent = 1;
-
-  // The device registry. The field `name` must be empty. The server will
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // Required. The device registry. The field `name` must be empty. The server will
   // generate that field from the device registry `id` provided and the
   // `parent` field.
-  DeviceRegistry device_registry = 2;
+  DeviceRegistry device_registry = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for `GetDeviceRegistry`.
 message GetDeviceRegistryRequest {
-  // The name of the device registry. For example,
+  // Required. The name of the device registry. For example,
   // `projects/example-project/locations/us-central1/registries/my-registry`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudiot.googleapis.com/Registry"
+    }
+  ];
 }
 
 // Request for `DeleteDeviceRegistry`.
 message DeleteDeviceRegistryRequest {
-  // The name of the device registry. For example,
+  // Required. The name of the device registry. For example,
   // `projects/example-project/locations/us-central1/registries/my-registry`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudiot.googleapis.com/Registry"
+    }
+  ];
 }
 
 // Request for `UpdateDeviceRegistry`.
 message UpdateDeviceRegistryRequest {
-  // The new values for the device registry. The `id` field must be empty, and
+  // Required. The new values for the device registry. The `id` field must be empty, and
   // the `name` field must indicate the path of the resource. For example,
   // `projects/example-project/locations/us-central1/registries/my-registry`.
-  DeviceRegistry device_registry = 1;
+  DeviceRegistry device_registry = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Only updates the `device_registry` fields indicated by this mask.
+  // Required. Only updates the `device_registry` fields indicated by this mask.
   // The field mask must not be empty, and it must not contain fields that
   // are immutable or only set by the server.
   // Mutable top-level fields: `event_notification_config`, `http_config`,
   // `mqtt_config`, and `state_notification_config`.
-  google.protobuf.FieldMask update_mask = 2;
+  google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for `ListDeviceRegistries`.
 message ListDeviceRegistriesRequest {
-  // The project and cloud region path. For example,
+  // Required. The project and cloud region path. For example,
   // `projects/example-project/locations/us-central1`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
   // The maximum number of registries to return in the response. If this value
   // is zero, the service will select a default size. A call may return fewer
@@ -330,23 +363,33 @@ message ListDeviceRegistriesResponse {
 
 // Request for `CreateDevice`.
 message CreateDeviceRequest {
-  // The name of the device registry where this device should be created.
+  // Required. The name of the device registry where this device should be created.
   // For example,
   // `projects/example-project/locations/us-central1/registries/my-registry`.
-  string parent = 1;
-
-  // The device registration details. The field `name` must be empty. The server
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudiot.googleapis.com/Registry"
+    }
+  ];
+
+  // Required. The device registration details. The field `name` must be empty. The server
   // generates `name` from the device registry `id` and the
   // `parent` field.
-  Device device = 2;
+  Device device = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for `GetDevice`.
 message GetDeviceRequest {
-  // The name of the device. For example,
+  // Required. The name of the device. For example,
   // `projects/p0/locations/us-central1/registries/registry0/devices/device0` or
   // `projects/p0/locations/us-central1/registries/registry0/devices/{num_id}`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudiot.googleapis.com/Device"
+    }
+  ];
 
   // The fields of the `Device` resource to be returned in the response. If the
   // field mask is unset or empty, all fields are returned.
@@ -355,32 +398,42 @@ message GetDeviceRequest {
 
 // Request for `UpdateDevice`.
 message UpdateDeviceRequest {
-  // The new values for the device. The `id` and `num_id` fields must
+  // Required. The new values for the device. The `id` and `num_id` fields must
   // be empty, and the field `name` must specify the name path. For example,
   // `projects/p0/locations/us-central1/registries/registry0/devices/device0`or
   // `projects/p0/locations/us-central1/registries/registry0/devices/{num_id}`.
-  Device device = 2;
+  Device device = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Only updates the `device` fields indicated by this mask.
+  // Required. Only updates the `device` fields indicated by this mask.
   // The field mask must not be empty, and it must not contain fields that
   // are immutable or only set by the server.
   // Mutable top-level fields: `credentials`, `blocked`, and `metadata`
-  google.protobuf.FieldMask update_mask = 3;
+  google.protobuf.FieldMask update_mask = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for `DeleteDevice`.
 message DeleteDeviceRequest {
-  // The name of the device. For example,
+  // Required. The name of the device. For example,
   // `projects/p0/locations/us-central1/registries/registry0/devices/device0` or
   // `projects/p0/locations/us-central1/registries/registry0/devices/{num_id}`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudiot.googleapis.com/Device"
+    }
+  ];
 }
 
 // Request for `ListDevices`.
 message ListDevicesRequest {
-  // The device registry path. Required. For example,
+  // Required. The device registry path. Required. For example,
   // `projects/my-project/locations/us-central1/registries/my-registry`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudiot.googleapis.com/Registry"
+    }
+  ];
 
   // A list of device numeric IDs. If empty, this field is ignored. Maximum
   // IDs: 10,000.
@@ -446,10 +499,15 @@ message ListDevicesResponse {
 
 // Request for `ModifyCloudToDeviceConfig`.
 message ModifyCloudToDeviceConfigRequest {
-  // The name of the device. For example,
+  // Required. The name of the device. For example,
   // `projects/p0/locations/us-central1/registries/registry0/devices/device0` or
   // `projects/p0/locations/us-central1/registries/registry0/devices/{num_id}`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudiot.googleapis.com/Device"
+    }
+  ];
 
   // The version number to update. If this value is zero, it will not check the
   // version number of the server and will always update the current version;
@@ -458,16 +516,21 @@ message ModifyCloudToDeviceConfigRequest {
   // simultaneous updates without losing data.
   int64 version_to_update = 2;
 
-  // The configuration data for the device.
-  bytes binary_data = 3;
+  // Required. The configuration data for the device.
+  bytes binary_data = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for `ListDeviceConfigVersions`.
 message ListDeviceConfigVersionsRequest {
-  // The name of the device. For example,
+  // Required. The name of the device. For example,
   // `projects/p0/locations/us-central1/registries/registry0/devices/device0` or
   // `projects/p0/locations/us-central1/registries/registry0/devices/{num_id}`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudiot.googleapis.com/Device"
+    }
+  ];
 
   // The number of versions to list. Versions are listed in decreasing order of
   // the version number. The maximum number of versions retained is 10. If this
@@ -484,10 +547,15 @@ message ListDeviceConfigVersionsResponse {
 
 // Request for `ListDeviceStates`.
 message ListDeviceStatesRequest {
-  // The name of the device. For example,
+  // Required. The name of the device. For example,
   // `projects/p0/locations/us-central1/registries/registry0/devices/device0` or
   // `projects/p0/locations/us-central1/registries/registry0/devices/{num_id}`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudiot.googleapis.com/Device"
+    }
+  ];
 
   // The number of states to list. States are listed in descending order of
   // update time. The maximum number of states retained is 10. If this
@@ -504,13 +572,18 @@ message ListDeviceStatesResponse {
 
 // Request for `SendCommandToDevice`.
 message SendCommandToDeviceRequest {
-  // The name of the device. For example,
+  // Required. The name of the device. For example,
   // `projects/p0/locations/us-central1/registries/registry0/devices/device0` or
   // `projects/p0/locations/us-central1/registries/registry0/devices/{num_id}`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudiot.googleapis.com/Device"
+    }
+  ];
 
-  // The command data to send to the device.
-  bytes binary_data = 2;
+  // Required. The command data to send to the device.
+  bytes binary_data = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Optional subfolder for the command. If empty, the command will be delivered
   // to the /devices/{device-id}/commands topic, otherwise it will be delivered
@@ -521,42 +594,58 @@ message SendCommandToDeviceRequest {
 }
 
 // Response for `SendCommandToDevice`.
-message SendCommandToDeviceResponse {}
+message SendCommandToDeviceResponse {
+
+}
 
 // Request for `BindDeviceToGateway`.
 message BindDeviceToGatewayRequest {
-  // The name of the registry. For example,
+  // Required. The name of the registry. For example,
   // `projects/example-project/locations/us-central1/registries/my-registry`.
-  string parent = 1;
-
-  // The value of `gateway_id` can be either the device numeric ID or the
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudiot.googleapis.com/Registry"
+    }
+  ];
+
+  // Required. The value of `gateway_id` can be either the device numeric ID or the
   // user-defined device identifier.
-  string gateway_id = 2;
+  string gateway_id = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // The device to associate with the specified gateway. The value of
+  // Required. The device to associate with the specified gateway. The value of
   // `device_id` can be either the device numeric ID or the user-defined device
   // identifier.
-  string device_id = 3;
+  string device_id = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response for `BindDeviceToGateway`.
-message BindDeviceToGatewayResponse {}
+message BindDeviceToGatewayResponse {
+
+}
 
 // Request for `UnbindDeviceFromGateway`.
 message UnbindDeviceFromGatewayRequest {
-  // The name of the registry. For example,
+  // Required. The name of the registry. For example,
   // `projects/example-project/locations/us-central1/registries/my-registry`.
-  string parent = 1;
-
-  // The value of `gateway_id` can be either the device numeric ID or the
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudiot.googleapis.com/Registry"
+    }
+  ];
+
+  // Required. The value of `gateway_id` can be either the device numeric ID or the
   // user-defined device identifier.
-  string gateway_id = 2;
+  string gateway_id = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // The device to disassociate from the specified gateway. The value of
+  // Required. The device to disassociate from the specified gateway. The value of
   // `device_id` can be either the device numeric ID or the user-defined device
   // identifier.
-  string device_id = 3;
+  string device_id = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response for `UnbindDeviceFromGateway`.
-message UnbindDeviceFromGatewayResponse {}
+message UnbindDeviceFromGatewayResponse {
+
+}
diff --git a/third_party/googleapis/google/cloud/iot/v1/resources.proto b/third_party/googleapis/google/cloud/iot/v1/resources.proto
index 2a91e989e..2201d3302 100644
--- a/third_party/googleapis/google/cloud/iot/v1/resources.proto
+++ b/third_party/googleapis/google/cloud/iot/v1/resources.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -17,7 +17,7 @@ syntax = "proto3";
 
 package google.cloud.iot.v1;
 
-import "google/api/annotations.proto";
+import "google/api/resource.proto";
 import "google/protobuf/timestamp.proto";
 import "google/rpc/status.proto";
 
@@ -29,6 +29,11 @@ option java_package = "com.google.cloud.iot.v1";
 
 // The device resource.
 message Device {
+  option (google.api.resource) = {
+    type: "cloudiot.googleapis.com/Device"
+    pattern: "projects/{project}/locations/{location}/registries/{registry}/devices/{device}"
+  };
+
   // The user-defined device identifier. The device ID must be unique
   // within a device registry.
   string id = 1;
@@ -149,6 +154,11 @@ message GatewayConfig {
 
 // A container for a group of devices.
 message DeviceRegistry {
+  option (google.api.resource) = {
+    type: "cloudiot.googleapis.com/Registry"
+    pattern: "projects/{project}/locations/{location}/registries/{registry}"
+  };
+
   // The identifier of this device registry. For example, `myRegistry`.
   string id = 1;
 
@@ -208,6 +218,19 @@ message MqttConfig {
   MqttState mqtt_enabled_state = 1;
 }
 
+// Indicates whether an MQTT connection is enabled or disabled. See the field
+// description for details.
+enum MqttState {
+  // No MQTT state specified. If not specified, MQTT will be enabled by default.
+  MQTT_STATE_UNSPECIFIED = 0;
+
+  // Enables a MQTT connection.
+  MQTT_ENABLED = 1;
+
+  // Disables a MQTT connection.
+  MQTT_DISABLED = 2;
+}
+
 // The configuration of the HTTP bridge for a device registry.
 message HttpConfig {
   // If enabled, allows devices to use DeviceService via the HTTP protocol.
@@ -215,6 +238,77 @@ message HttpConfig {
   HttpState http_enabled_state = 1;
 }
 
+// Indicates whether DeviceService (HTTP) is enabled or disabled for the
+// registry. See the field description for details.
+enum HttpState {
+  // No HTTP state specified. If not specified, DeviceService will be
+  // enabled by default.
+  HTTP_STATE_UNSPECIFIED = 0;
+
+  // Enables DeviceService (HTTP) service for the registry.
+  HTTP_ENABLED = 1;
+
+  // Disables DeviceService (HTTP) service for the registry.
+  HTTP_DISABLED = 2;
+}
+
+// **Beta Feature**
+//
+// The logging verbosity for device activity. Specifies which events should be
+// written to logs. For example, if the LogLevel is ERROR, only events that
+// terminate in errors will be logged. LogLevel is inclusive; enabling INFO
+// logging will also enable ERROR logging.
+enum LogLevel {
+  // No logging specified. If not specified, logging will be disabled.
+  LOG_LEVEL_UNSPECIFIED = 0;
+
+  // Disables logging.
+  NONE = 10;
+
+  // Error events will be logged.
+  ERROR = 20;
+
+  // Informational events will be logged, such as connections and
+  // disconnections.
+  INFO = 30;
+
+  // All events will be logged.
+  DEBUG = 40;
+}
+
+// Gateway type.
+enum GatewayType {
+  // If unspecified, the device is considered a non-gateway device.
+  GATEWAY_TYPE_UNSPECIFIED = 0;
+
+  // The device is a gateway.
+  GATEWAY = 1;
+
+  // The device is not a gateway.
+  NON_GATEWAY = 2;
+}
+
+// The gateway authorization/authentication method. This setting determines how
+// Cloud IoT Core authorizes/authenticate devices to access the gateway.
+enum GatewayAuthMethod {
+  // No authentication/authorization method specified. No devices are allowed to
+  // access the gateway.
+  GATEWAY_AUTH_METHOD_UNSPECIFIED = 0;
+
+  // The device is authenticated through the gateway association only. Device
+  // credentials are ignored even if provided.
+  ASSOCIATION_ONLY = 1;
+
+  // The device is authenticated through its own credentials. Gateway
+  // association is not checked.
+  DEVICE_AUTH_TOKEN_ONLY = 2;
+
+  // The device is authenticated through both device credentials and gateway
+  // association. The device must be bound to the gateway and must provide its
+  // own credentials.
+  ASSOCIATION_AND_DEVICE_AUTH_TOKEN = 3;
+}
+
 // The configuration for forwarding telemetry events.
 message EventNotificationConfig {
   // If the subfolder name matches this string exactly, this configuration will
@@ -277,6 +371,18 @@ message PublicKeyCertificate {
   X509CertificateDetails x509_details = 3;
 }
 
+// The supported formats for the public key.
+enum PublicKeyCertificateFormat {
+  // The format has not been specified. This is an invalid default value and
+  // must not be used.
+  UNSPECIFIED_PUBLIC_KEY_CERTIFICATE_FORMAT = 0;
+
+  // An X.509v3 certificate ([RFC5280](https://www.ietf.org/rfc/rfc5280.txt)),
+  // encoded in base64, and wrapped by `-----BEGIN CERTIFICATE-----` and
+  // `-----END CERTIFICATE-----`.
+  X509_CERTIFICATE_PEM = 1;
+}
+
 // A server-stored device credential used for authentication.
 message DeviceCredential {
   // The credential data. Reserved for expansion in the future.
@@ -310,6 +416,36 @@ message PublicKeyCredential {
   string key = 2;
 }
 
+// The supported formats for the public key.
+enum PublicKeyFormat {
+  // The format has not been specified. This is an invalid default value and
+  // must not be used.
+  UNSPECIFIED_PUBLIC_KEY_FORMAT = 0;
+
+  // An RSA public key encoded in base64, and wrapped by
+  // `-----BEGIN PUBLIC KEY-----` and `-----END PUBLIC KEY-----`. This can be
+  // used to verify `RS256` signatures in JWT tokens ([RFC7518](
+  // https://www.ietf.org/rfc/rfc7518.txt)).
+  RSA_PEM = 3;
+
+  // As RSA_PEM, but wrapped in an X.509v3 certificate ([RFC5280](
+  // https://www.ietf.org/rfc/rfc5280.txt)), encoded in base64, and wrapped by
+  // `-----BEGIN CERTIFICATE-----` and `-----END CERTIFICATE-----`.
+  RSA_X509_PEM = 1;
+
+  // Public key for the ECDSA algorithm using P-256 and SHA-256, encoded in
+  // base64, and wrapped by `-----BEGIN PUBLIC KEY-----` and `-----END
+  // PUBLIC KEY-----`. This can be used to verify JWT tokens with the `ES256`
+  // algorithm ([RFC7518](https://www.ietf.org/rfc/rfc7518.txt)). This curve is
+  // defined in [OpenSSL](https://www.openssl.org/) as the `prime256v1` curve.
+  ES256_PEM = 2;
+
+  // As ES256_PEM, but wrapped in an X.509v3 certificate ([RFC5280](
+  // https://www.ietf.org/rfc/rfc5280.txt)), encoded in base64, and wrapped by
+  // `-----BEGIN CERTIFICATE-----` and `-----END CERTIFICATE-----`.
+  ES256_X509_PEM = 4;
+}
+
 // The device configuration. Eventually delivered to devices.
 message DeviceConfig {
   // [Output only] The version of this update. The version number is assigned by
@@ -346,129 +482,3 @@ message DeviceState {
   // The device state data.
   bytes binary_data = 2;
 }
-
-// Indicates whether an MQTT connection is enabled or disabled. See the field
-// description for details.
-enum MqttState {
-  // No MQTT state specified. If not specified, MQTT will be enabled by default.
-  MQTT_STATE_UNSPECIFIED = 0;
-
-  // Enables a MQTT connection.
-  MQTT_ENABLED = 1;
-
-  // Disables a MQTT connection.
-  MQTT_DISABLED = 2;
-}
-
-// Indicates whether DeviceService (HTTP) is enabled or disabled for the
-// registry. See the field description for details.
-enum HttpState {
-  // No HTTP state specified. If not specified, DeviceService will be
-  // enabled by default.
-  HTTP_STATE_UNSPECIFIED = 0;
-
-  // Enables DeviceService (HTTP) service for the registry.
-  HTTP_ENABLED = 1;
-
-  // Disables DeviceService (HTTP) service for the registry.
-  HTTP_DISABLED = 2;
-}
-
-// **Beta Feature**
-//
-// The logging verbosity for device activity. Specifies which events should be
-// written to logs. For example, if the LogLevel is ERROR, only events that
-// terminate in errors will be logged. LogLevel is inclusive; enabling INFO
-// logging will also enable ERROR logging.
-enum LogLevel {
-  // No logging specified. If not specified, logging will be disabled.
-  LOG_LEVEL_UNSPECIFIED = 0;
-
-  // Disables logging.
-  NONE = 10;
-
-  // Error events will be logged.
-  ERROR = 20;
-
-  // Informational events will be logged, such as connections and
-  // disconnections.
-  INFO = 30;
-
-  // All events will be logged.
-  DEBUG = 40;
-}
-
-// Gateway type.
-enum GatewayType {
-  // If unspecified, the device is considered a non-gateway device.
-  GATEWAY_TYPE_UNSPECIFIED = 0;
-
-  // The device is a gateway.
-  GATEWAY = 1;
-
-  // The device is not a gateway.
-  NON_GATEWAY = 2;
-}
-
-// The gateway authorization/authentication method. This setting determines how
-// Cloud IoT Core authorizes/authenticate devices to access the gateway.
-enum GatewayAuthMethod {
-  // No authentication/authorization method specified. No devices are allowed to
-  // access the gateway.
-  GATEWAY_AUTH_METHOD_UNSPECIFIED = 0;
-
-  // The device is authenticated through the gateway association only. Device
-  // credentials are ignored even if provided.
-  ASSOCIATION_ONLY = 1;
-
-  // The device is authenticated through its own credentials. Gateway
-  // association is not checked.
-  DEVICE_AUTH_TOKEN_ONLY = 2;
-
-  // The device is authenticated through both device credentials and gateway
-  // association. The device must be bound to the gateway and must provide its
-  // own credentials.
-  ASSOCIATION_AND_DEVICE_AUTH_TOKEN = 3;
-}
-
-// The supported formats for the public key.
-enum PublicKeyCertificateFormat {
-  // The format has not been specified. This is an invalid default value and
-  // must not be used.
-  UNSPECIFIED_PUBLIC_KEY_CERTIFICATE_FORMAT = 0;
-
-  // An X.509v3 certificate ([RFC5280](https://www.ietf.org/rfc/rfc5280.txt)),
-  // encoded in base64, and wrapped by `-----BEGIN CERTIFICATE-----` and
-  // `-----END CERTIFICATE-----`.
-  X509_CERTIFICATE_PEM = 1;
-}
-
-// The supported formats for the public key.
-enum PublicKeyFormat {
-  // The format has not been specified. This is an invalid default value and
-  // must not be used.
-  UNSPECIFIED_PUBLIC_KEY_FORMAT = 0;
-
-  // An RSA public key encoded in base64, and wrapped by
-  // `-----BEGIN PUBLIC KEY-----` and `-----END PUBLIC KEY-----`. This can be
-  // used to verify `RS256` signatures in JWT tokens ([RFC7518](
-  // https://www.ietf.org/rfc/rfc7518.txt)).
-  RSA_PEM = 3;
-
-  // As RSA_PEM, but wrapped in an X.509v3 certificate ([RFC5280](
-  // https://www.ietf.org/rfc/rfc5280.txt)), encoded in base64, and wrapped by
-  // `-----BEGIN CERTIFICATE-----` and `-----END CERTIFICATE-----`.
-  RSA_X509_PEM = 1;
-
-  // Public key for the ECDSA algorithm using P-256 and SHA-256, encoded in
-  // base64, and wrapped by `-----BEGIN PUBLIC KEY-----` and `-----END
-  // PUBLIC KEY-----`. This can be used to verify JWT tokens with the `ES256`
-  // algorithm ([RFC7518](https://www.ietf.org/rfc/rfc7518.txt)). This curve is
-  // defined in [OpenSSL](https://www.openssl.org/) as the `prime256v1` curve.
-  ES256_PEM = 2;
-
-  // As ES256_PEM, but wrapped in an X.509v3 certificate ([RFC5280](
-  // https://www.ietf.org/rfc/rfc5280.txt)), encoded in base64, and wrapped by
-  // `-----BEGIN CERTIFICATE-----` and `-----END CERTIFICATE-----`.
-  ES256_X509_PEM = 4;
-}
diff --git a/third_party/googleapis/google/cloud/irm/BUILD.bazel b/third_party/googleapis/google/cloud/irm/BUILD.bazel
new file mode 100644
index 000000000..a87c57fec
--- /dev/null
+++ b/third_party/googleapis/google/cloud/irm/BUILD.bazel
@@ -0,0 +1 @@
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/cloud/irm/v1alpha2/BUILD.bazel b/third_party/googleapis/google/cloud/irm/v1alpha2/BUILD.bazel
new file mode 100644
index 000000000..a39af0fa1
--- /dev/null
+++ b/third_party/googleapis/google/cloud/irm/v1alpha2/BUILD.bazel
@@ -0,0 +1,363 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "irm_proto",
+    srcs = [
+        "incidents.proto",
+        "incidents_service.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "irm_proto_with_info",
+    deps = [
+        ":irm_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "irm_java_proto",
+    deps = [":irm_proto"],
+)
+
+java_grpc_library(
+    name = "irm_java_grpc",
+    srcs = [":irm_proto"],
+    deps = [":irm_java_proto"],
+)
+
+java_gapic_library(
+    name = "irm_java_gapic",
+    src = ":irm_proto_with_info",
+    gapic_yaml = "irm_gapic.yaml",
+    package = "google.cloud.irm.v1alpha2",
+    service_yaml = "//google/cloud/irm:irm_v1alpha2.yaml",
+    test_deps = [
+        ":irm_java_grpc",
+    ],
+    deps = [
+        ":irm_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "irm_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.irm.v1alpha2.IncidentServiceClientTest",
+    ],
+    runtime_deps = [":irm_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-irm-v1alpha2-java",
+    deps = [
+        ":irm_java_gapic",
+        ":irm_java_grpc",
+        ":irm_java_proto",
+        ":irm_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "irm_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/irm/v1alpha2",
+    protos = [":irm_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "irm_go_gapic",
+    srcs = [":irm_proto_with_info"],
+    grpc_service_config = "irm_grpc_service_config.json",
+    importpath = "cloud.google.com/go/irm/apiv1alpha2;irm",
+    service_yaml = "//google/cloud/irm:irm_v1alpha2.yaml",
+    deps = [
+        ":irm_go_proto",
+    ],
+)
+
+go_test(
+    name = "irm_go_gapic_test",
+    srcs = [":irm_go_gapic_srcjar_test"],
+    embed = [":irm_go_gapic"],
+    importpath = "cloud.google.com/go/irm/apiv1alpha2",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-irm-v1alpha2-go",
+    deps = [
+        ":irm_go_gapic",
+        ":irm_go_gapic_srcjar-test.srcjar",
+        ":irm_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "irm_moved_proto",
+    srcs = [":irm_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "irm_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":irm_moved_proto"],
+)
+
+py_grpc_library(
+    name = "irm_py_grpc",
+    srcs = [":irm_moved_proto"],
+    deps = [":irm_py_proto"],
+)
+
+py_gapic_library(
+    name = "irm_py_gapic",
+    src = ":irm_proto_with_info",
+    gapic_yaml = "irm_gapic.yaml",
+    package = "google.cloud.irm.v1alpha2",
+    service_yaml = "//google/cloud/irm:irm_v1alpha2.yaml",
+    deps = [
+        ":irm_py_grpc",
+        ":irm_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "irm-v1alpha2-py",
+    deps = [
+        ":irm_py_gapic",
+        ":irm_py_grpc",
+        ":irm_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "irm_php_proto",
+    deps = [":irm_proto"],
+)
+
+php_grpc_library(
+    name = "irm_php_grpc",
+    srcs = [":irm_proto"],
+    deps = [":irm_php_proto"],
+)
+
+php_gapic_library(
+    name = "irm_php_gapic",
+    src = ":irm_proto_with_info",
+    gapic_yaml = "irm_gapic.yaml",
+    package = "google.cloud.irm.v1alpha2",
+    service_yaml = "//google/cloud/irm:irm_v1alpha2.yaml",
+    deps = [
+        ":irm_php_grpc",
+        ":irm_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-irm-v1alpha2-php",
+    deps = [
+        ":irm_php_gapic",
+        ":irm_php_grpc",
+        ":irm_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "irm_nodejs_gapic",
+    src = ":irm_proto_with_info",
+    gapic_yaml = "irm_gapic.yaml",
+    package = "google.cloud.irm.v1alpha2",
+    service_yaml = "//google/cloud/irm:irm_v1alpha2.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "irm-v1alpha2-nodejs",
+    deps = [
+        ":irm_nodejs_gapic",
+        ":irm_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "irm_ruby_proto",
+    deps = [":irm_proto"],
+)
+
+ruby_grpc_library(
+    name = "irm_ruby_grpc",
+    srcs = [":irm_proto"],
+    deps = [":irm_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "irm_ruby_gapic",
+    src = ":irm_proto_with_info",
+    gapic_yaml = "irm_gapic.yaml",
+    package = "google.cloud.irm.v1alpha2",
+    service_yaml = "//google/cloud/irm:irm_v1alpha2.yaml",
+    deps = [
+        ":irm_ruby_grpc",
+        ":irm_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-irm-v1alpha2-ruby",
+    deps = [
+        ":irm_ruby_gapic",
+        ":irm_ruby_grpc",
+        ":irm_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "irm_csharp_proto",
+    deps = [":irm_proto"],
+)
+
+csharp_grpc_library(
+    name = "irm_csharp_grpc",
+    srcs = [":irm_proto"],
+    deps = [":irm_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "irm_csharp_gapic",
+    src = ":irm_proto_with_info",
+    gapic_yaml = "irm_gapic.yaml",
+    package = "google.cloud.irm.v1alpha2",
+    service_yaml = "//google/cloud/irm:irm_v1alpha2.yaml",
+    deps = [
+        ":irm_csharp_grpc",
+        ":irm_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-irm-v1alpha2-csharp",
+    deps = [
+        ":irm_csharp_gapic",
+        ":irm_csharp_grpc",
+        ":irm_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/irm/v1alpha2/incidents.proto b/third_party/googleapis/google/cloud/irm/v1alpha2/incidents.proto
index 78972ae03..e4eb3b30f 100644
--- a/third_party/googleapis/google/cloud/irm/v1alpha2/incidents.proto
+++ b/third_party/googleapis/google/cloud/irm/v1alpha2/incidents.proto
@@ -18,6 +18,8 @@ syntax = "proto3";
 package google.cloud.irm.v1alpha2;
 
 import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/protobuf/timestamp.proto";
 
 option cc_enable_arenas = true;
@@ -45,6 +47,11 @@ message User {
 // A signal is a message calling attention to a (potential) incident. An example
 // is a page based on a Stackdriver Alerting policy.
 message Signal {
+  option (google.api.resource) = {
+    type: "irm.googleapis.com/Signal"
+    pattern: "projects/{project}/signals/{signal}"
+  };
+
   // An artifact associated with the Signal.
   message SignalArtifact {
     // The type of resource linked to
@@ -70,7 +77,7 @@ message Signal {
   }
 
   // Resource name of the signal, for example,
-  // "projects/{project_id}/signals/{signal_id}".
+  // "projects/{project_id_or_number}/signals/{signal_id}".
   string name = 1;
 
   // Etag to validate the object is unchanged for a read-modify-write operation.
@@ -123,8 +130,13 @@ message Signal {
 
 // A text annotation by a user.
 message Annotation {
+  option (google.api.resource) = {
+    type: "irm.googleapis.com/Annotation"
+    pattern: "projects/{project}/incidents/{incident}/annotations/{annotation}"
+  };
+
   // Resource name of the annotation, for example,
-  // "projects/{project_id}/incidents/{incident_id}/annotations/{annotation_id}".
+  // "projects/{project_id_or_number}/incidents/{incident_id}/annotations/{annotation_id}".
   string name = 1;
 
   // Output only. Author of the annotation.
@@ -133,18 +145,23 @@ message Annotation {
   // Output only. Time the annotation was created.
   google.protobuf.Timestamp create_time = 3;
 
-  // Content of the annotation. Immutable.
+  // Content of the annotation.
   string content = 4;
 
   // Content type of the annotation, for example, 'text/plain'
-  // or 'text/markdown'. Immutable.
+  // or 'text/markdown'.
   string content_type = 5;
 }
 
 // A tag by a user.
 message Tag {
+  option (google.api.resource) = {
+    type: "irm.googleapis.com/Tag"
+    pattern: "projects/{project}/incidents/{incident}/tags/{tag}"
+  };
+
   // Resource name of a tag, for example,
-  // "projects/{project_id}/incidents/{incident_id}/tags/{tag_id}"
+  // "projects/{project_id_or_number}/incidents/{incident_id}/tags/{tag_id}"
   string name = 1;
 
   // Display name of the resource (for example, "cause:rollout"). Immutable.
@@ -170,6 +187,11 @@ message Synopsis {
 
 // Representation of an incident.
 message Incident {
+  option (google.api.resource) = {
+    type: "irm.googleapis.com/Incident"
+    pattern: "projects/{project}/incidents/{incident}"
+  };
+
   // CommunicationVenue is a record of where conversations about an incident
   // are happening.
   message CommunicationVenue {
@@ -259,8 +281,8 @@ message Incident {
   }
 
   // Output only. Resource name of the incident, for example,
-  // "projects/{project_id}/incidents/{incident_id}".
-  string name = 1;
+  // "projects/{project_id_or_number}/incidents/{incident_id}".
+  string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // One-line summary of the incident.
   string title = 2;
@@ -338,18 +360,23 @@ message IncidentRole {
   // type can only be used once per incident, except for TYPE_OTHER.
   Type type = 1;
 
-  // Output only unless TYPE_OTHER is used. Title of the role. For TYPE_OTHER,
-  // must be unique within an incident.
+  // Output only and empty unless TYPE_OTHER is used. Title of the role. For
+  // TYPE_OTHER, must be unique within an incident.
   string title = 2;
 
-  // Output only unless TYPE_OTHER is used. Description of the role.
+  // Output only and empty unless TYPE_OTHER is used. Description of the role.
   string description = 3;
 }
 
 // Stores the assignee of a role as well as the proposed next assignee.
 message IncidentRoleAssignment {
+  option (google.api.resource) = {
+    type: "irm.googleapis.com/IncidentRoleAssignment"
+    pattern: "projects/{project_id_or_number}/incidents/{incident_id}/role_assignments/{role_id}"
+  };
+
   // Output only. Resource name such as
-  // "projects/{project_id}/incidents/{incident_id}/role_assignments/{role_id}".
+  // "projects/{project_id_or_number}/incidents/{incident_id}/role_assignments/{role_id}".
   string name = 1;
 
   // Output only. Etag for this version of the resource. Must be specified in
@@ -390,6 +417,11 @@ message IncidentRoleAssignment {
 
 // External artifact associated to an incident.
 message Artifact {
+  option (google.api.resource) = {
+    type: "irm.googleapis.com/Artifact"
+    pattern: "projects/{project}/incidents/{incident}/artifacts/{artifact}"
+  };
+
   // Possible types of an artifact.
   enum Type {
     // External type is unspecified.
@@ -403,7 +435,7 @@ message Artifact {
   }
 
   // Output only. Resource name such as
-  // "projects/{project_id}/incidents/{incident_id}/artifacts/{artifact_id}".
+  // "projects/{project_id_or_number}/incidents/{incident_id}/artifacts/{artifact_id}".
   string name = 1;
 
   // User provided name of an artifact.
@@ -450,6 +482,11 @@ message CommunicationChannel {
 // A subscription allows users to get notifications about changes to
 // an incident.
 message Subscription {
+  option (google.api.resource) = {
+    type: "irm.googleapis.com/Subscription"
+    pattern: "projects/{project}/incidents/{incident}/subscriptions/{subscription}"
+  };
+
   // Types of changes that users can subscribe to in an incident.
   enum EventType {
     // An event_type that's not specified is an error.
@@ -475,7 +512,7 @@ message Subscription {
   }
 
   // Output only. Resource name such as
-  // "projects/{project_id}/incidents/{incident_id}/subscriptions/{subscription_id}".
+  // "projects/{project_id_or_number}/incidents/{incident_id}/subscriptions/{subscription_id}".
   string name = 1;
 
   // Output only. Etag for this version of the resource. Must be specified in
diff --git a/third_party/googleapis/google/cloud/irm/v1alpha2/incidents_service.proto b/third_party/googleapis/google/cloud/irm/v1alpha2/incidents_service.proto
index 76cc3ae38..8546d42b6 100644
--- a/third_party/googleapis/google/cloud/irm/v1alpha2/incidents_service.proto
+++ b/third_party/googleapis/google/cloud/irm/v1alpha2/incidents_service.proto
@@ -19,6 +19,8 @@ package google.cloud.irm.v1alpha2;
 
 import "google/api/annotations.proto";
 import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/irm/v1alpha2/incidents.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
@@ -32,8 +34,7 @@ option java_package = "com.google.irm.service.v1alpha2.api";
 // The Incident API for Incident Response & Management.
 service IncidentService {
   option (google.api.default_host) = "irm.googleapis.com";
-  option (google.api.oauth_scopes) =
-      "https://www.googleapis.com/auth/cloud-platform";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
 
   // Creates a new incident.
   rpc CreateIncident(CreateIncidentRequest) returns (Incident) {
@@ -41,6 +42,7 @@ service IncidentService {
       post: "/v1alpha2/{parent=projects/*}/incidents"
       body: "incident"
     };
+    option (google.api.method_signature) = "incident,parent";
   }
 
   // Returns an incident by name.
@@ -48,6 +50,7 @@ service IncidentService {
     option (google.api.http) = {
       get: "/v1alpha2/{name=projects/*/incidents/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Returns a list of incidents.
@@ -57,6 +60,7 @@ service IncidentService {
     option (google.api.http) = {
       get: "/v1alpha2/{parent=projects/*}/incidents:search"
     };
+    option (google.api.method_signature) = "parent,query,time_zone";
   }
 
   // Updates an existing incident.
@@ -65,19 +69,20 @@ service IncidentService {
       patch: "/v1alpha2/{incident.name=projects/*/incidents/*}"
       body: "incident"
     };
+    option (google.api.method_signature) = "incident,update_mask";
   }
 
   // Returns a list of incidents that are "similar" to the specified incident
   // or signal. This functionality is provided on a best-effort basis and the
   // definition of "similar" is subject to change.
-  rpc SearchSimilarIncidents(SearchSimilarIncidentsRequest)
-      returns (SearchSimilarIncidentsResponse) {
+  rpc SearchSimilarIncidents(SearchSimilarIncidentsRequest) returns (SearchSimilarIncidentsResponse) {
     option (google.api.http) = {
       get: "/v1alpha2/{name=projects/*/incidents/*}:searchSimilar"
       additional_bindings {
         get: "/v1alpha2/{name=projects/*/signals/*}:searchSimilarIncidents"
       }
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates an annotation on an existing incident. Only 'text/plain' and
@@ -87,15 +92,16 @@ service IncidentService {
       post: "/v1alpha2/{parent=projects/*/incidents/*}/annotations"
       body: "annotation"
     };
+    option (google.api.method_signature) = "parent,annotation";
   }
 
   // Lists annotations that are part of an incident. No assumptions should be
   // made on the content-type of the annotation returned.
-  rpc ListAnnotations(ListAnnotationsRequest)
-      returns (ListAnnotationsResponse) {
+  rpc ListAnnotations(ListAnnotationsRequest) returns (ListAnnotationsResponse) {
     option (google.api.http) = {
       get: "/v1alpha2/{parent=projects/*/incidents/*}/annotations"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Creates a tag on an existing incident.
@@ -104,6 +110,7 @@ service IncidentService {
       post: "/v1alpha2/{parent=projects/*/incidents/*}/tags"
       body: "tag"
     };
+    option (google.api.method_signature) = "parent,tag";
   }
 
   // Deletes an existing tag.
@@ -111,6 +118,7 @@ service IncidentService {
     option (google.api.http) = {
       delete: "/v1alpha2/{name=projects/*/incidents/*/tags/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists tags that are part of an incident.
@@ -118,6 +126,7 @@ service IncidentService {
     option (google.api.http) = {
       get: "/v1alpha2/{parent=projects/*/incidents/*}/tags"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Creates a new signal.
@@ -126,14 +135,19 @@ service IncidentService {
       post: "/v1alpha2/{parent=projects/*}/signals"
       body: "signal"
     };
+    option (google.api.method_signature) = "parent,signal";
   }
 
   // Lists signals that are part of an incident.
   // Signals are returned in reverse chronological order.
+  // Note that search should not be relied on for critical functionality.  It
+  // has lower availability guarantees and might fail to return valid results.
+  // Returned results might include stale or extraneous entries.
   rpc SearchSignals(SearchSignalsRequest) returns (SearchSignalsResponse) {
     option (google.api.http) = {
       get: "/v1alpha2/{parent=projects/*}/signals:search"
     };
+    option (google.api.method_signature) = "parent,query";
   }
 
   // Finds a signal by other unique IDs.
@@ -148,6 +162,7 @@ service IncidentService {
     option (google.api.http) = {
       get: "/v1alpha2/{name=projects/*/signals/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Updates an existing signal (for example, to assign/unassign it to an
@@ -157,11 +172,11 @@ service IncidentService {
       patch: "/v1alpha2/{signal.name=projects/*/signals/*}"
       body: "signal"
     };
+    option (google.api.method_signature) = "signal,update_mask";
   }
 
   // Escalates an incident.
-  rpc EscalateIncident(EscalateIncidentRequest)
-      returns (EscalateIncidentResponse) {
+  rpc EscalateIncident(EscalateIncidentRequest) returns (EscalateIncidentResponse) {
     option (google.api.http) = {
       post: "/v1alpha2/{incident.name=projects/*/incidents/*}:escalate"
       body: "*"
@@ -174,6 +189,7 @@ service IncidentService {
       post: "/v1alpha2/{parent=projects/*/incidents/*}/artifacts"
       body: "artifact"
     };
+    option (google.api.method_signature) = "parent,artifact";
   }
 
   // Returns a list of artifacts for an incident.
@@ -181,6 +197,7 @@ service IncidentService {
     option (google.api.http) = {
       get: "/v1alpha2/{parent=projects/*/incidents/*}/artifacts"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Updates an existing artifact.
@@ -189,6 +206,7 @@ service IncidentService {
       patch: "/v1alpha2/{artifact.name=projects/*/incidents/*/artifacts/*}"
       body: "artifact"
     };
+    option (google.api.method_signature) = "artifact,update_mask";
   }
 
   // Deletes an existing artifact.
@@ -196,11 +214,11 @@ service IncidentService {
     option (google.api.http) = {
       delete: "/v1alpha2/{name=projects/*/incidents/*/artifacts/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Sends a summary of the shift for oncall handoff.
-  rpc SendShiftHandoff(SendShiftHandoffRequest)
-      returns (SendShiftHandoffResponse) {
+  rpc SendShiftHandoff(SendShiftHandoffRequest) returns (SendShiftHandoffResponse) {
     option (google.api.http) = {
       post: "/v1alpha2/{parent=projects/*}/shiftHandoff:send"
       body: "*"
@@ -216,6 +234,7 @@ service IncidentService {
       post: "/v1alpha2/{parent=projects/*/incidents/*}/subscriptions"
       body: "subscription"
     };
+    option (google.api.method_signature) = "parent,subscription";
   }
 
   // Updates a subscription.
@@ -224,22 +243,23 @@ service IncidentService {
       patch: "/v1alpha2/{subscription.name=projects/*/incidents/*/subscriptions/*}"
       body: "subscription"
     };
+    option (google.api.method_signature) = "subscription,update_mask";
   }
 
   // Returns a list of subscriptions for an incident.
-  rpc ListSubscriptions(ListSubscriptionsRequest)
-      returns (ListSubscriptionsResponse) {
+  rpc ListSubscriptions(ListSubscriptionsRequest) returns (ListSubscriptionsResponse) {
     option (google.api.http) = {
       get: "/v1alpha2/{parent=projects/*/incidents/*}/subscriptions"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Deletes an existing subscription.
-  rpc DeleteSubscription(DeleteSubscriptionRequest)
-      returns (google.protobuf.Empty) {
+  rpc DeleteSubscription(DeleteSubscriptionRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v1alpha2/{name=projects/*/incidents/*/subscriptions/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates a role assignment on an existing incident. Normally, the user field
@@ -247,100 +267,112 @@ service IncidentService {
   // set when proposing another user as the assignee. Setting the next field
   // directly to a user other than oneself is equivalent to proposing and
   // force-assigning the role to the user.
-  rpc CreateIncidentRoleAssignment(CreateIncidentRoleAssignmentRequest)
-      returns (IncidentRoleAssignment) {
+  rpc CreateIncidentRoleAssignment(CreateIncidentRoleAssignmentRequest) returns (IncidentRoleAssignment) {
     option (google.api.http) = {
       post: "/v1alpha2/{parent=projects/*/incidents/*}/roleAssignments"
       body: "*"
     };
+    option (google.api.method_signature) = "parent,incident_role_assignment";
   }
 
   // Deletes an existing role assignment.
-  rpc DeleteIncidentRoleAssignment(DeleteIncidentRoleAssignmentRequest)
-      returns (google.protobuf.Empty) {
+  rpc DeleteIncidentRoleAssignment(DeleteIncidentRoleAssignmentRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v1alpha2/{name=projects/*/incidents/*/roleAssignments/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists role assignments that are part of an incident.
-  rpc ListIncidentRoleAssignments(ListIncidentRoleAssignmentsRequest)
-      returns (ListIncidentRoleAssignmentsResponse) {
+  rpc ListIncidentRoleAssignments(ListIncidentRoleAssignmentsRequest) returns (ListIncidentRoleAssignmentsResponse) {
     option (google.api.http) = {
       get: "/v1alpha2/{parent=projects/*/incidents/*}/roleAssignments"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Starts a role handover. The proposed assignee will receive an email
   // notifying them of the assignment. This will fail if a role handover is
   // already pending.
-  rpc RequestIncidentRoleHandover(RequestIncidentRoleHandoverRequest)
-      returns (IncidentRoleAssignment) {
+  // Handover to an oncall ladder is not permitted. Use
+  // CreateIncidentRoleAssignment instead.
+  rpc RequestIncidentRoleHandover(RequestIncidentRoleHandoverRequest) returns (IncidentRoleAssignment) {
     option (google.api.http) = {
       post: "/v1alpha2/{name=projects/*/incidents/*/roleAssignments/*}:requestHandover"
       body: "*"
     };
+    option (google.api.method_signature) = "name,new_assignee";
   }
 
   // Confirms a role handover. This will fail if the 'proposed_assignee' field
   // of the IncidentRoleAssignment is not equal to the 'new_assignee' field of
   // the request. If the caller is not the new_assignee,
   // ForceIncidentRoleHandover should be used instead.
-  rpc ConfirmIncidentRoleHandover(ConfirmIncidentRoleHandoverRequest)
-      returns (IncidentRoleAssignment) {
+  rpc ConfirmIncidentRoleHandover(ConfirmIncidentRoleHandoverRequest) returns (IncidentRoleAssignment) {
     option (google.api.http) = {
       post: "/v1alpha2/{name=projects/*/incidents/*/roleAssignments/*}:confirmHandover"
       body: "*"
     };
+    option (google.api.method_signature) = "name,new_assignee";
   }
 
   // Forces a role handover. This will fail if the 'proposed_assignee' field of
   // the IncidentRoleAssignment is not equal to the 'new_assignee' field of the
   // request. If the caller is the new_assignee, ConfirmIncidentRoleHandover
   // should be used instead.
-  rpc ForceIncidentRoleHandover(ForceIncidentRoleHandoverRequest)
-      returns (IncidentRoleAssignment) {
+  rpc ForceIncidentRoleHandover(ForceIncidentRoleHandoverRequest) returns (IncidentRoleAssignment) {
     option (google.api.http) = {
       post: "/v1alpha2/{name=projects/*/incidents/*/roleAssignments/*}:forceHandover"
       body: "*"
     };
+    option (google.api.method_signature) = "name,new_assignee";
   }
 
   // Cancels a role handover. This will fail if the 'proposed_assignee' field of
   // the IncidentRoleAssignment is not equal to the 'new_assignee' field of the
   // request.
-  rpc CancelIncidentRoleHandover(CancelIncidentRoleHandoverRequest)
-      returns (IncidentRoleAssignment) {
+  rpc CancelIncidentRoleHandover(CancelIncidentRoleHandoverRequest) returns (IncidentRoleAssignment) {
     option (google.api.http) = {
       post: "/v1alpha2/{name=projects/*/incidents/*/roleAssignments/*}:cancelHandover"
       body: "*"
     };
+    option (google.api.method_signature) = "name,new_assignee";
   }
 }
 
 // Request for the CreateIncident method.
 message CreateIncidentRequest {
-  // The incident to create.
-  Incident incident = 1;
+  // Required. The incident to create.
+  Incident incident = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // The resource name of the hosting Stackdriver project which the incident
+  // Required. The resource name of the hosting Stackdriver project which the incident
   // belongs to.
   // The name is of the form `projects/{project_id_or_number}`
   // .
-  string parent = 2;
+  string parent = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 }
 
 // Request for the GetIncident method.
 message GetIncidentRequest {
-  // Resource name of the incident, for example,
-  // "projects/{project_id}/incidents/{incident_id}".
-  string name = 1;
+  // Required. Resource name of the incident, for example,
+  // "projects/{project_id_or_number}/incidents/{incident_id}".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "irm.googleapis.com/Incident"
+    }
+  ];
 }
 
 // Request for the UpdateIncident method.
 message UpdateIncidentRequest {
-  // The incident to update with the new values.
-  Incident incident = 1;
+  // Required. The incident to update with the new values.
+  Incident incident = 1 [(google.api.field_behavior) = REQUIRED];
 
   // List of fields that should be updated.
   google.protobuf.FieldMask update_mask = 2;
@@ -348,9 +380,14 @@ message UpdateIncidentRequest {
 
 // Request for the SearchSimilarIncidents method.
 message SearchSimilarIncidentsRequest {
-  // Resource name of the incident or signal, for example,
-  // "projects/{project_id}/incidents/{incident_id}".
-  string name = 1;
+  // Required. Resource name of the incident or signal, for example,
+  // "projects/{project_id_or_number}/incidents/{incident_id}".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "irm.googleapis.com/Incident"
+    }
+  ];
 
   // Number of similar incidents to return.
   int32 page_size = 2;
@@ -378,19 +415,30 @@ message SearchSimilarIncidentsResponse {
 
 // Request for the CreateAnnotation method.
 message CreateAnnotationRequest {
-  // Resource name of the incident, for example,
-  // "projects/{project_id}/incidents/{incident_id}".
-  string parent = 1;
-
-  // Only annotation.content is an input argument.
-  Annotation annotation = 2;
+  // Required. Resource name of the incident, for example,
+  // "projects/{project_id_or_number}/incidents/{incident_id}".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "irm.googleapis.com/Incident"
+    }
+  ];
+
+  // Required. Only annotation.content is an input argument.
+  Annotation annotation = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
+
 // Request for the ListAnnotations method.
 message ListAnnotationsRequest {
-  // Resource name of the incident, for example,
-  // "projects/{project_id}/incidents/{incident_id}".
-  string parent = 1;
+  // Required. Resource name of the incident, for example,
+  // "projects/{project_id_or_number}/incidents/{incident_id}".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "irm.googleapis.com/Incident"
+    }
+  ];
 
   // Number of annotations to return.
   int32 page_size = 2;
@@ -410,25 +458,40 @@ message ListAnnotationsResponse {
 
 // Request for the CreateTag method.
 message CreateTagRequest {
-  // Resource name of the incident, for example,
-  // "projects/{project_id}/incidents/{incident_id}".
-  string parent = 1;
-
-  // Tag to create. Only tag.display_name is an input argument.
-  Tag tag = 2;
+  // Required. Resource name of the incident, for example,
+  // "projects/{project_id_or_number}/incidents/{incident_id}".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "irm.googleapis.com/Incident"
+    }
+  ];
+
+  // Required. Tag to create. Only tag.display_name is an input argument.
+  Tag tag = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for the DeleteTag method.
 message DeleteTagRequest {
-  // Resource name of the tag.
-  string name = 1;
+  // Required. Resource name of the tag.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "irm.googleapis.com/Tag"
+    }
+  ];
 }
 
 // Request for the ListTagsForIncident method.
 message ListTagsRequest {
-  // Resource name of the incident, for example,
-  // "projects/{project_id}/incidents/{incident_id}".
-  string parent = 1;
+  // Required. Resource name of the incident, for example,
+  // "projects/{project_id_or_number}/incidents/{incident_id}".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "irm.googleapis.com/Incident"
+    }
+  ];
 
   // Number of tags to return.
   int32 page_size = 2;
@@ -448,19 +511,29 @@ message ListTagsResponse {
 
 // Request for the CreateSignal method.
 message CreateSignalRequest {
-  // The resource name of the hosting Stackdriver project which requested
+  // Required. The resource name of the hosting Stackdriver project which requested
   // signal belongs to.
-  string parent = 1;
-
-  // The signal to create.
-  Signal signal = 2;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
+
+  // Required. The signal to create.
+  Signal signal = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for the SearchSignals method.
 message SearchSignalsRequest {
-  // The resource name of the hosting Stackdriver project which requested
+  // Required. The resource name of the hosting Stackdriver project which requested
   // incidents belong to.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
   // An expression that defines which signals to return.
   //
@@ -542,16 +615,21 @@ message SearchSignalsResponse {
 
 // Request for the GetSignal method.
 message GetSignalRequest {
-  // Resource name of the Signal resource, for example,
-  // "projects/{project_id}/signals/{signal_id}".
-  string name = 1;
+  // Required. Resource name of the Signal resource, for example,
+  // "projects/{project_id_or_number}/signals/{signal_id}".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "irm.googleapis.com/Signal"
+    }
+  ];
 }
 
 // Request for the LookupSignal method.
 message LookupSignalRequest {
-  // Required. The ID to use for lookup.
+  // The ID to use for lookup.
   oneof alternate_id {
-    // Full resource name of the CSCC finding id this signal refers to (e.g.
+    // Required. Full resource name of the CSCC finding id this signal refers to (e.g.
     // "organizations/abc/sources/123/findings/xyz")
     string cscc_finding = 2;
 
@@ -562,8 +640,8 @@ message LookupSignalRequest {
 
 // Request for the UpdateSignal method.
 message UpdateSignalRequest {
-  // The signal to update with the new values.
-  Signal signal = 1;
+  // Required. The signal to update with the new values.
+  Signal signal = 1 [(google.api.field_behavior) = REQUIRED];
 
   // List of fields that should be updated.
   google.protobuf.FieldMask update_mask = 2;
@@ -571,9 +649,14 @@ message UpdateSignalRequest {
 
 // Request for the SearchIncidents method.
 message SearchIncidentsRequest {
-  // The resource name of the hosting Stackdriver project which requested
+  // Required. The resource name of the hosting Stackdriver project which requested
   // incidents belong to.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
   // An expression that defines which incidents to return.
   //
@@ -652,8 +735,8 @@ message SearchIncidentsResponse {
 
 // Request to escalate an incident.
 message EscalateIncidentRequest {
-  // The incident to escalate with the new values.
-  Incident incident = 1;
+  // Required. The incident to escalate with the new values.
+  Incident incident = 1 [(google.api.field_behavior) = REQUIRED];
 
   // List of fields that should be updated.
   google.protobuf.FieldMask update_mask = 2;
@@ -693,19 +776,29 @@ message EscalateIncidentResponse {
 
 // Request for the CreateArtifact method.
 message CreateArtifactRequest {
-  // Resource name of the incident, for example,
-  // "projects/{project_id}/incidents/{incident_id}".
-  string parent = 1;
-
-  // The artifact to create.
-  Artifact artifact = 2;
+  // Required. Resource name of the incident, for example,
+  // "projects/{project_id_or_number}/incidents/{incident_id}".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "irm.googleapis.com/Incident"
+    }
+  ];
+
+  // Required. The artifact to create.
+  Artifact artifact = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for the ListArtifacts method.
 message ListArtifactsRequest {
-  // Resource name of the incident, for example,
-  // "projects/{project_id}/incidents/{incident_id}".
-  string parent = 1;
+  // Required. Resource name of the incident, for example,
+  // "projects/{project_id_or_number}/incidents/{incident_id}".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "irm.googleapis.com/Incident"
+    }
+  ];
 
   // Number of artifacts to return.
   int32 page_size = 2;
@@ -725,8 +818,8 @@ message ListArtifactsResponse {
 
 // Request for the UpdateArtifact method.
 message UpdateArtifactRequest {
-  // The artifact to update with the new values.
-  Artifact artifact = 1;
+  // Required. The artifact to update with the new values.
+  Artifact artifact = 1 [(google.api.field_behavior) = REQUIRED];
 
   // List of fields that should be updated.
   google.protobuf.FieldMask update_mask = 2;
@@ -734,8 +827,13 @@ message UpdateArtifactRequest {
 
 // Request for deleting an artifact.
 message DeleteArtifactRequest {
-  // Resource name of the artifact.
-  string name = 1;
+  // Required. Resource name of the artifact.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "irm.googleapis.com/Artifact"
+    }
+  ];
 }
 
 // SendShiftHandoff and PreviewShiftHandoff RPC request.
@@ -745,32 +843,39 @@ message SendShiftHandoffRequest {
   // attaching additional data to each incident in the future.
   message Incident {
     // Resource name of the incident, for example,
-    // "projects/{project_id}/incidents/{incident_id}".
-    string name = 1;
+    // "projects/{project_id_or_number}/incidents/{incident_id}".
+    string name = 1 [(google.api.resource_reference) = {
+                       type: "irm.googleapis.com/Incident"
+                     }];
   }
 
-  // The resource name of the Stackdriver project that the handoff is being sent
-  // from. for example, `projects/{project_id}`
-  string parent = 1;
+  // Required. The resource name of the Stackdriver project that the handoff is being sent
+  // from. for example, `projects/{project_id_or_number}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
-  // Email addresses of the recipients of the handoff, for example,
+  // Required. Email addresses of the recipients of the handoff, for example,
   // "user@example.com". Must contain at least one entry.
-  repeated string recipients = 2;
+  repeated string recipients = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Email addresses that should be CC'd on the handoff. Optional.
-  repeated string cc = 3;
+  // Optional. Email addresses that should be CC'd on the handoff.
+  repeated string cc = 3 [(google.api.field_behavior) = OPTIONAL];
 
-  // The subject of the email. Required.
-  string subject = 4;
+  // Required. The subject of the email.
+  string subject = 4 [(google.api.field_behavior) = REQUIRED];
 
   // Content type string, for example, 'text/plain' or 'text/html'.
   string notes_content_type = 5;
 
-  // Additional notes to be included in the handoff. Optional.
-  string notes_content = 6;
+  // Optional. Additional notes to be included in the handoff.
+  string notes_content = 6 [(google.api.field_behavior) = OPTIONAL];
 
-  // The set of incidents that should be included in the handoff. Optional.
-  repeated Incident incidents = 7;
+  // Optional. The set of incidents that should be included in the handoff.
+  repeated Incident incidents = 7 [(google.api.field_behavior) = OPTIONAL];
 
   // If set to true a ShiftHandoffResponse will be returned but the handoff
   // will not actually be sent.
@@ -790,18 +895,23 @@ message SendShiftHandoffResponse {
 
 // Request for the CreateSubscription method.
 message CreateSubscriptionRequest {
-  // Resource name of the incident, for example,
-  // "projects/{project_id}/incidents/{incident_id}".
-  string parent = 1;
-
-  // The subscription to create.
-  Subscription subscription = 2;
+  // Required. Resource name of the incident, for example,
+  // "projects/{project_id_or_number}/incidents/{incident_id}".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "irm.googleapis.com/Incident"
+    }
+  ];
+
+  // Required. The subscription to create.
+  Subscription subscription = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for the UpdateSubscription method.
 message UpdateSubscriptionRequest {
-  // The subscription to update, with new values.
-  Subscription subscription = 1;
+  // Required. The subscription to update, with new values.
+  Subscription subscription = 1 [(google.api.field_behavior) = REQUIRED];
 
   // List of fields that should be updated.
   google.protobuf.FieldMask update_mask = 2;
@@ -809,9 +919,14 @@ message UpdateSubscriptionRequest {
 
 // Request for the ListSubscriptions method.
 message ListSubscriptionsRequest {
-  // Resource name of the incident, for example,
-  // "projects/{project_id}/incidents/{incident_id}".
-  string parent = 1;
+  // Required. Resource name of the incident, for example,
+  // "projects/{project_id_or_number}/incidents/{incident_id}".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "irm.googleapis.com/Incident"
+    }
+  ];
 
   // Number of subscriptions to return.
   int32 page_size = 2;
@@ -831,31 +946,51 @@ message ListSubscriptionsResponse {
 
 // Request for deleting a subscription.
 message DeleteSubscriptionRequest {
-  // Resource name of the subscription.
-  string name = 1;
+  // Required. Resource name of the subscription.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "irm.googleapis.com/Subscription"
+    }
+  ];
 }
 
 // Request for creating a role assignment.
 message CreateIncidentRoleAssignmentRequest {
-  // Resource name of the incident, for example,
-  // "projects/{project_id}/incidents/{incident_id}".
-  string parent = 1;
-
-  // Role assignment to create.
-  IncidentRoleAssignment incident_role_assignment = 2;
+  // Required. Resource name of the incident, for example,
+  // "projects/{project_id_or_number}/incidents/{incident_id}".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "irm.googleapis.com/Incident"
+    }
+  ];
+
+  // Required. Role assignment to create.
+  IncidentRoleAssignment incident_role_assignment = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for deleting a role assignment.
 message DeleteIncidentRoleAssignmentRequest {
-  // Resource name of the role assignment.
-  string name = 1;
+  // Required. Resource name of the role assignment.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "irm.googleapis.com/Incident"
+    }
+  ];
 }
 
 // Request to list role assignments of an incident.
 message ListIncidentRoleAssignmentsRequest {
-  // Resource name of the incident, for example,
-  // "projects/{project_id}/incidents/{incident_id}".
-  string parent = 1;
+  // Required. Resource name of the incident, for example,
+  // "projects/{project_id_or_number}/incidents/{incident_id}".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "irm.googleapis.com/Incident"
+    }
+  ];
 
   // Number of assignments to return.
   int32 page_size = 2;
@@ -875,40 +1010,55 @@ message ListIncidentRoleAssignmentsResponse {
 
 // Request to start a role handover.
 message RequestIncidentRoleHandoverRequest {
-  // Resource name of the role assignment.
-  string name = 1;
+  // Required. Resource name of the role assignment.
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // The proposed assignee.
-  User new_assignee = 2;
+  // Required. The proposed assignee.
+  User new_assignee = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request to confirm a role handover.
 message ConfirmIncidentRoleHandoverRequest {
-  // Resource name of the role assignment.
-  string name = 1;
-
-  // The proposed assignee, who will now be the assignee. This should be the
+  // Required. Resource name of the role assignment.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "irm.googleapis.com/IncidentRoleAssignment"
+    }
+  ];
+
+  // Required. The proposed assignee, who will now be the assignee. This should be the
   // current user; otherwise ForceRoleHandover should be called.
-  User new_assignee = 2;
+   User new_assignee = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request to force a role handover.
 message ForceIncidentRoleHandoverRequest {
-  // Resource name of the role assignment.
-  string name = 1;
-
-  // The proposed assignee, who will now be the assignee. This should not be
+  // Required. Resource name of the role assignment.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "irm.googleapis.com/IncidentRoleAssignment"
+    }
+  ];
+
+  // Required. The proposed assignee, who will now be the assignee. This should not be
   // the current user; otherwise ConfirmRoleHandover should be called.
-  User new_assignee = 2;
+  User new_assignee = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request to cancel a role handover.
 message CancelIncidentRoleHandoverRequest {
-  // Resource name of the role assignment.
-  string name = 1;
-
-  // Person who was proposed as the next assignee (i.e.
+  // Required. Resource name of the role assignment.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "irm.googleapis.com/IncidentRoleAssignment"
+    }
+  ];
+
+  // Required. Person who was proposed as the next assignee (i.e.
   // IncidentRoleAssignment.proposed_assignee) and whose proposal is being
   // cancelled.
-  User new_assignee = 2;
+  User new_assignee = 2 [(google.api.field_behavior) = REQUIRED];
 }
diff --git a/third_party/googleapis/google/cloud/irm/v1alpha2/irm_gapic.legacy.yaml b/third_party/googleapis/google/cloud/irm/v1alpha2/irm_gapic.legacy.yaml
new file mode 100644
index 000000000..f09e8e415
--- /dev/null
+++ b/third_party/googleapis/google/cloud/irm/v1alpha2/irm_gapic.legacy.yaml
@@ -0,0 +1,723 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.irm.v1alpha2
+  python:
+    package_name: google.cloud.irm_v1alpha2.gapic
+  go:
+    package_name: cloud.google.com/go/irm/apiv1alpha2
+  csharp:
+    package_name: Google.Cloud.Irm.V1Alpha2
+  ruby:
+    package_name: Google::Cloud::Irm::V1alpha2
+  php:
+    package_name: Google\Cloud\Irm\V1alpha2
+  nodejs:
+    package_name: irm.v1alpha2
+    domain_layer_location: google-cloud
+# A list of API interface configurations.
+interfaces:
+  # The fully qualified name of the API interface.
+- name: google.cloud.irm.v1alpha2.IncidentService
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}
+    entity_name: project
+    language_overrides:
+    - language: csharp
+      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
+  - name_pattern: projects/{project}/incidents/{incident}
+    entity_name: incident
+  - name_pattern: projects/{project}/incidents/{incident}/annotations/{annotation}
+    entity_name: annotation
+  - name_pattern: projects/{project}/incidents/{incident}/artifacts/{artifact}
+    entity_name: artifact
+  - name_pattern: projects/{project}/incidents/{incident}/roleAssignments/{role_assignment}
+    entity_name: role_assignment
+  - name_pattern: projects/{project}/incidents/{incident}/subscriptions/{subscription}
+    entity_name: subscription
+  - name_pattern: projects/{project}/incidents/{incident}/tags/{tag}
+    entity_name: tag
+  - name_pattern: projects/{project}/signals/{signal}
+    entity_name: signal
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: CreateIncident
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - incident
+        - parent
+    required_fields:
+    - incident
+    - parent
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 60000
+  - name: GetIncident
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: incident
+    timeout_millis: 60000
+  - name: SearchIncidents
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - query
+        - time_zone
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: incidents
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 60000
+  - name: UpdateIncident
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - incident
+        - update_mask
+    required_fields:
+    - incident
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      incident.name: incident
+    timeout_millis: 60000
+  - name: SearchSimilarIncidents
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: results
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: incident
+    timeout_millis: 60000
+  - name: CreateAnnotation
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - annotation
+    required_fields:
+    - parent
+    - annotation
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: incident
+    timeout_millis: 60000
+  - name: ListAnnotations
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: annotations
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: incident
+    timeout_millis: 60000
+  - name: CreateTag
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - tag
+    required_fields:
+    - parent
+    - tag
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: incident
+    timeout_millis: 60000
+  - name: DeleteTag
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: tag
+    timeout_millis: 60000
+  - name: ListTags
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: tags
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: incident
+    timeout_millis: 60000
+  - name: CreateSignal
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - signal
+    required_fields:
+    - parent
+    - signal
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 60000
+  - name: SearchSignals
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - query
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: signals
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 60000
+  - name: GetSignal
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: signal
+    timeout_millis: 60000
+  - name: LookupSignal
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: UpdateSignal
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - signal
+        - update_mask
+    required_fields:
+    - signal
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      signal.name: signal
+    timeout_millis: 60000
+  - name: EscalateIncident
+    resource_name_treatment: STATIC_TYPES
+    required_fields:
+    - incident
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      incident.name: incident
+    timeout_millis: 60000
+  - name: CreateArtifact
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - artifact
+    required_fields:
+    - parent
+    - artifact
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: incident
+    timeout_millis: 60000
+  - name: ListArtifacts
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: artifacts
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: incident
+    timeout_millis: 60000
+  - name: UpdateArtifact
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - artifact
+        - update_mask
+    required_fields:
+    - artifact
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      artifact.name: artifact
+    timeout_millis: 60000
+  - name: DeleteArtifact
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: artifact
+    timeout_millis: 60000
+  - name: SendShiftHandoff
+    resource_name_treatment: STATIC_TYPES
+    required_fields:
+    - parent
+    - recipients
+    - subject
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 60000
+  - name: CreateSubscription
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - subscription
+    required_fields:
+    - parent
+    - subscription
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: incident
+    timeout_millis: 60000
+  - name: UpdateSubscription
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - subscription
+        - update_mask
+    required_fields:
+    - subscription
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      subscription.name: subscription
+    timeout_millis: 60000
+  - name: ListSubscriptions
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: subscriptions
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: incident
+    timeout_millis: 60000
+  - name: DeleteSubscription
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: subscription
+    timeout_millis: 60000
+  - name: CreateIncidentRoleAssignment
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - incident_role_assignment
+    required_fields:
+    - parent
+    - incident_role_assignment
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: incident
+    timeout_millis: 60000
+  - name: DeleteIncidentRoleAssignment
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: role_assignment
+    timeout_millis: 60000
+  - name: ListIncidentRoleAssignments
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: incident_role_assignments
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: incident
+    timeout_millis: 60000
+  - name: RequestIncidentRoleHandover
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - new_assignee
+    required_fields:
+    - name
+    - new_assignee
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: role_assignment
+    timeout_millis: 60000
+  - name: ConfirmIncidentRoleHandover
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - new_assignee
+    required_fields:
+    - name
+    - new_assignee
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: role_assignment
+    timeout_millis: 60000
+  - name: ForceIncidentRoleHandover
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - new_assignee
+    required_fields:
+    - name
+    - new_assignee
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: role_assignment
+    timeout_millis: 60000
+  - name: CancelIncidentRoleHandover
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - new_assignee
+    required_fields:
+    - name
+    - new_assignee
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: role_assignment
+    timeout_millis: 60000
+resource_name_generation:
+- message_name: Annotation
+  field_entity_map:
+    name: annotation
+- message_name: Artifact
+  field_entity_map:
+    name: artifact
+- message_name: Incident
+  field_entity_map:
+    name: incident
+- message_name: IncidentRoleAssignment
+  field_entity_map:
+    name: role_assignment
+- message_name: Signal
+  field_entity_map:
+    name: signal
+- message_name: Subscription
+  field_entity_map:
+    name: subscription
+- message_name: Tag
+  field_entity_map:
+    name: tag
+- message_name: CreateIncidentRequest
+  field_entity_map:
+    parent: project
+- message_name: GetIncidentRequest
+  field_entity_map:
+    name: incident
+- message_name: SearchIncidentsRequest
+  field_entity_map:
+    parent: project
+- message_name: UpdateIncidentRequest
+  field_entity_map:
+    incident.name: incident
+- message_name: EscalateIncidentRequest
+  field_entity_map:
+    incident.name: incident
+- message_name: CreateSignalRequest
+  field_entity_map:
+    parent: project
+- message_name: GetSignalRequest
+  field_entity_map:
+    name: signal
+- message_name: SearchSignalsRequest
+  field_entity_map:
+    parent: project
+- message_name: UpdateSignalRequest
+  field_entity_map:
+    signal.name: signal
+- message_name: CreateArtifactRequest
+  field_entity_map:
+    parent: incident
+- message_name: ListArtifactsRequest
+  field_entity_map:
+    parent: incident
+- message_name: UpdateArtifactRequest
+  field_entity_map:
+    artifact.name: artifact
+- message_name: DeleteArtifactRequest
+  field_entity_map:
+    name: artifact
+- message_name: CreateIncidentRoleAssignmentRequest
+  field_entity_map:
+    parent: incident
+- message_name: ListIncidentRoleAssignmentsRequest
+  field_entity_map:
+    parent: incident
+- message_name: DeleteIncidentRoleAssignmentRequest
+  field_entity_map:
+    name: role_assignment
+- message_name: RequestIncidentRoleHandoverRequest
+  field_entity_map:
+    name: role_assignment
+- message_name: ConfirmIncidentRoleHandoverRequest
+  field_entity_map:
+    name: role_assignment
+- message_name: ForceIncidentRoleHandoverRequest
+  field_entity_map:
+    name: role_assignment
+- message_name: CancelIncidentRoleHandoverRequest
+  field_entity_map:
+    name: role_assignment
+- message_name: CreateSubscriptionRequest
+  field_entity_map:
+    parent: incident
+- message_name: ListSubscriptionsRequest
+  field_entity_map:
+    parent: incident
+- message_name: UpdateSubscriptionRequest
+  field_entity_map:
+    subscription.name: subscription
+- message_name: DeleteSubscriptionRequest
+  field_entity_map:
+    name: subscription
+- message_name: CreateTagRequest
+  field_entity_map:
+    parent: incident
+- message_name: ListTagsRequest
+  field_entity_map:
+    parent: incident
+- message_name: DeleteTagRequest
+  field_entity_map:
+    name: tag
+- message_name: CreateAnnotationRequest
+  field_entity_map:
+    parent: incident
+- message_name: ListAnnotationsRequest
+  field_entity_map:
+    parent: incident
+- message_name: SendShiftHandoffRequest
+  field_entity_map:
+    parent: project
diff --git a/third_party/googleapis/google/cloud/irm/v1alpha2/irm_gapic.yaml b/third_party/googleapis/google/cloud/irm/v1alpha2/irm_gapic.yaml
index f09e8e415..969e9d2ab 100644
--- a/third_party/googleapis/google/cloud/irm/v1alpha2/irm_gapic.yaml
+++ b/third_party/googleapis/google/cloud/irm/v1alpha2/irm_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -21,54 +21,6 @@ language_settings:
 interfaces:
   # The fully qualified name of the API interface.
 - name: google.cloud.irm.v1alpha2.IncidentService
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections:
-  - name_pattern: projects/{project}
-    entity_name: project
-    language_overrides:
-    - language: csharp
-      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
-  - name_pattern: projects/{project}/incidents/{incident}
-    entity_name: incident
-  - name_pattern: projects/{project}/incidents/{incident}/annotations/{annotation}
-    entity_name: annotation
-  - name_pattern: projects/{project}/incidents/{incident}/artifacts/{artifact}
-    entity_name: artifact
-  - name_pattern: projects/{project}/incidents/{incident}/roleAssignments/{role_assignment}
-    entity_name: role_assignment
-  - name_pattern: projects/{project}/incidents/{incident}/subscriptions/{subscription}
-    entity_name: subscription
-  - name_pattern: projects/{project}/incidents/{incident}/tags/{tag}
-    entity_name: tag
-  - name_pattern: projects/{project}/signals/{signal}
-    entity_name: signal
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
   # A list of method configurations.
   # Common properties:
   #
@@ -124,600 +76,11 @@ interfaces:
   #   timeout_millis - Specifies the default timeout for a non-retrying call. If
   #   the call is retrying, refer to retry_params_name instead.
   methods:
-  - name: CreateIncident
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - incident
-        - parent
-    required_fields:
-    - incident
-    - parent
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: project
-    timeout_millis: 60000
-  - name: GetIncident
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: incident
-    timeout_millis: 60000
-  - name: SearchIncidents
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - query
-        - time_zone
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: incidents
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: project
-    timeout_millis: 60000
-  - name: UpdateIncident
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - incident
-        - update_mask
-    required_fields:
-    - incident
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      incident.name: incident
-    timeout_millis: 60000
-  - name: SearchSimilarIncidents
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: results
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: incident
-    timeout_millis: 60000
-  - name: CreateAnnotation
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - annotation
-    required_fields:
-    - parent
-    - annotation
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: incident
-    timeout_millis: 60000
-  - name: ListAnnotations
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: annotations
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: incident
-    timeout_millis: 60000
-  - name: CreateTag
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - tag
-    required_fields:
-    - parent
-    - tag
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: incident
-    timeout_millis: 60000
-  - name: DeleteTag
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: tag
-    timeout_millis: 60000
-  - name: ListTags
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: tags
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: incident
-    timeout_millis: 60000
-  - name: CreateSignal
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - signal
-    required_fields:
-    - parent
-    - signal
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: project
-    timeout_millis: 60000
-  - name: SearchSignals
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - query
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: signals
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: project
-    timeout_millis: 60000
-  - name: GetSignal
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: signal
-    timeout_millis: 60000
-  - name: LookupSignal
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-  - name: UpdateSignal
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - signal
-        - update_mask
-    required_fields:
-    - signal
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      signal.name: signal
-    timeout_millis: 60000
-  - name: EscalateIncident
-    resource_name_treatment: STATIC_TYPES
-    required_fields:
-    - incident
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      incident.name: incident
-    timeout_millis: 60000
-  - name: CreateArtifact
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - artifact
-    required_fields:
-    - parent
-    - artifact
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: incident
-    timeout_millis: 60000
-  - name: ListArtifacts
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: artifacts
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: incident
-    timeout_millis: 60000
-  - name: UpdateArtifact
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - artifact
-        - update_mask
-    required_fields:
-    - artifact
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      artifact.name: artifact
-    timeout_millis: 60000
   - name: DeleteArtifact
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: artifact
-    timeout_millis: 60000
-  - name: SendShiftHandoff
-    resource_name_treatment: STATIC_TYPES
-    required_fields:
-    - parent
-    - recipients
-    - subject
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: project
-    timeout_millis: 60000
-  - name: CreateSubscription
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - subscription
-    required_fields:
-    - parent
-    - subscription
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: incident
-    timeout_millis: 60000
-  - name: UpdateSubscription
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - subscription
-        - update_mask
-    required_fields:
-    - subscription
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      subscription.name: subscription
-    timeout_millis: 60000
-  - name: ListSubscriptions
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: subscriptions
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: incident
-    timeout_millis: 60000
-  - name: DeleteSubscription
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: subscription
-    timeout_millis: 60000
-  - name: CreateIncidentRoleAssignment
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - incident_role_assignment
-    required_fields:
-    - parent
-    - incident_role_assignment
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: incident
-    timeout_millis: 60000
-  - name: DeleteIncidentRoleAssignment
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: role_assignment
-    timeout_millis: 60000
-  - name: ListIncidentRoleAssignments
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: incident_role_assignments
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: incident
-    timeout_millis: 60000
   - name: RequestIncidentRoleHandover
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - new_assignee
-    required_fields:
-    - name
-    - new_assignee
     retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: role_assignment
-    timeout_millis: 60000
   - name: ConfirmIncidentRoleHandover
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - new_assignee
-    required_fields:
-    - name
-    - new_assignee
     retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: role_assignment
-    timeout_millis: 60000
   - name: ForceIncidentRoleHandover
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - new_assignee
-    required_fields:
-    - name
-    - new_assignee
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: role_assignment
-    timeout_millis: 60000
-  - name: CancelIncidentRoleHandover
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - new_assignee
-    required_fields:
-    - name
-    - new_assignee
     retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: role_assignment
-    timeout_millis: 60000
-resource_name_generation:
-- message_name: Annotation
-  field_entity_map:
-    name: annotation
-- message_name: Artifact
-  field_entity_map:
-    name: artifact
-- message_name: Incident
-  field_entity_map:
-    name: incident
-- message_name: IncidentRoleAssignment
-  field_entity_map:
-    name: role_assignment
-- message_name: Signal
-  field_entity_map:
-    name: signal
-- message_name: Subscription
-  field_entity_map:
-    name: subscription
-- message_name: Tag
-  field_entity_map:
-    name: tag
-- message_name: CreateIncidentRequest
-  field_entity_map:
-    parent: project
-- message_name: GetIncidentRequest
-  field_entity_map:
-    name: incident
-- message_name: SearchIncidentsRequest
-  field_entity_map:
-    parent: project
-- message_name: UpdateIncidentRequest
-  field_entity_map:
-    incident.name: incident
-- message_name: EscalateIncidentRequest
-  field_entity_map:
-    incident.name: incident
-- message_name: CreateSignalRequest
-  field_entity_map:
-    parent: project
-- message_name: GetSignalRequest
-  field_entity_map:
-    name: signal
-- message_name: SearchSignalsRequest
-  field_entity_map:
-    parent: project
-- message_name: UpdateSignalRequest
-  field_entity_map:
-    signal.name: signal
-- message_name: CreateArtifactRequest
-  field_entity_map:
-    parent: incident
-- message_name: ListArtifactsRequest
-  field_entity_map:
-    parent: incident
-- message_name: UpdateArtifactRequest
-  field_entity_map:
-    artifact.name: artifact
-- message_name: DeleteArtifactRequest
-  field_entity_map:
-    name: artifact
-- message_name: CreateIncidentRoleAssignmentRequest
-  field_entity_map:
-    parent: incident
-- message_name: ListIncidentRoleAssignmentsRequest
-  field_entity_map:
-    parent: incident
-- message_name: DeleteIncidentRoleAssignmentRequest
-  field_entity_map:
-    name: role_assignment
-- message_name: RequestIncidentRoleHandoverRequest
-  field_entity_map:
-    name: role_assignment
-- message_name: ConfirmIncidentRoleHandoverRequest
-  field_entity_map:
-    name: role_assignment
-- message_name: ForceIncidentRoleHandoverRequest
-  field_entity_map:
-    name: role_assignment
-- message_name: CancelIncidentRoleHandoverRequest
-  field_entity_map:
-    name: role_assignment
-- message_name: CreateSubscriptionRequest
-  field_entity_map:
-    parent: incident
-- message_name: ListSubscriptionsRequest
-  field_entity_map:
-    parent: incident
-- message_name: UpdateSubscriptionRequest
-  field_entity_map:
-    subscription.name: subscription
-- message_name: DeleteSubscriptionRequest
-  field_entity_map:
-    name: subscription
-- message_name: CreateTagRequest
-  field_entity_map:
-    parent: incident
-- message_name: ListTagsRequest
-  field_entity_map:
-    parent: incident
-- message_name: DeleteTagRequest
-  field_entity_map:
-    name: tag
-- message_name: CreateAnnotationRequest
-  field_entity_map:
-    parent: incident
-- message_name: ListAnnotationsRequest
-  field_entity_map:
-    parent: incident
-- message_name: SendShiftHandoffRequest
-  field_entity_map:
-    parent: project
diff --git a/third_party/googleapis/google/cloud/irm/v1alpha2/irm_grpc_service_config.json b/third_party/googleapis/google/cloud/irm/v1alpha2/irm_grpc_service_config.json
new file mode 100755
index 000000000..bbc4d9582
--- /dev/null
+++ b/third_party/googleapis/google/cloud/irm/v1alpha2/irm_grpc_service_config.json
@@ -0,0 +1,151 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "CreateIncident"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "UpdateIncident"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "CreateAnnotation"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "CreateTag"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "CreateSignal"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "UpdateSignal"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "EscalateIncident"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "CreateArtifact"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "UpdateArtifact"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "SendShiftHandoff"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "CreateSubscription"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "UpdateSubscription"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "CreateIncidentRoleAssignment"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "RequestIncidentRoleHandover"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "ConfirmIncidentRoleHandover"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "ForceIncidentRoleHandover"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "CancelIncidentRoleHandover"
+        }
+      ],
+      "timeout": "600s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "GetIncident"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "SearchIncidents"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "SearchSimilarIncidents"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "ListAnnotations"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "DeleteTag"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "ListTags"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "SearchSignals"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "GetSignal"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "LookupSignal"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "ListArtifacts"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "DeleteArtifact"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "ListSubscriptions"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "DeleteSubscription"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "DeleteIncidentRoleAssignment"
+        },
+        {
+          "service": "google.cloud.irm.v1alpha2.IncidentService",
+          "method": "ListIncidentRoleAssignments"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/irm/v1alpha2/irm_v1alpha2.yaml b/third_party/googleapis/google/cloud/irm/v1alpha2/irm_v1alpha2.yaml
new file mode 100644
index 000000000..361cfff60
--- /dev/null
+++ b/third_party/googleapis/google/cloud/irm/v1alpha2/irm_v1alpha2.yaml
@@ -0,0 +1,23 @@
+type: google.api.Service
+config_version: 3
+name: irm.googleapis.com
+title: Stackdriver Incident Response & Management API
+
+apis:
+- name: google.cloud.irm.v1alpha2.IncidentService
+
+documentation:
+  overview: |-
+    The Stackdriver Incident Response & Management API allows users of
+    Stackdriver to retrieve their signals, group signals into incidents,
+    retrieve and modify existing incidents, and manage user roles. It also
+    provides access to functionality related to the incident management
+    process such as escalating incidents and performing handoffs at the end of
+    an oncall shift.
+
+authentication:
+  rules:
+  - selector: 'google.cloud.irm.v1alpha2.IncidentService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/kms/BUILD.bazel b/third_party/googleapis/google/cloud/kms/BUILD.bazel
index 1e5b8c2af..a87c57fec 100644
--- a/third_party/googleapis/google/cloud/kms/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/kms/BUILD.bazel
@@ -1 +1 @@
-exports_files(glob(["*.yaml"]))
\ No newline at end of file
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/cloud/kms/artman_cloudkms.yaml b/third_party/googleapis/google/cloud/kms/artman_cloudkms.yaml
index 4e2192ac1..26c2f2b91 100644
--- a/third_party/googleapis/google/cloud/kms/artman_cloudkms.yaml
+++ b/third_party/googleapis/google/cloud/kms/artman_cloudkms.yaml
@@ -2,8 +2,9 @@ common:
   api_name: kms
   api_version: v1
   organization_name: google-cloud
-  service_yaml: cloudkms.yaml
+  service_yaml: v1/cloudkms_v1.yaml
   gapic_yaml: v1/cloudkms_gapic.yaml
+  proto_package: google.cloud.kms.v1
   src_proto_paths:
   - v1
   proto_deps:
diff --git a/third_party/googleapis/google/cloud/kms/v1/BUILD.bazel b/third_party/googleapis/google/cloud/kms/v1/BUILD.bazel
index 88fd22db5..704a79fd3 100644
--- a/third_party/googleapis/google/cloud/kms/v1/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/kms/v1/BUILD.bazel
@@ -1,3 +1,5 @@
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
@@ -15,6 +17,8 @@ proto_library(
     deps = [
         "//google/api:annotations_proto",
         "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
         "@com_google_protobuf//:duration_proto",
         "@com_google_protobuf//:field_mask_proto",
         "@com_google_protobuf//:struct_proto",
@@ -27,6 +31,7 @@ proto_library_with_info(
     name = "kms_proto_with_info",
     deps = [
         ":kms_proto",
+        "//google/cloud:common_resources_proto",
         "//google/iam/v1:iam_policy_proto",
         "//google/iam/v1:policy_proto",
     ],
@@ -37,19 +42,14 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
     "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-    "@com_google_api_grpc_proto_google_iam_v1//jar",
-]
-
 java_proto_library(
     name = "kms_java_proto",
     deps = [":kms_proto"],
@@ -58,54 +58,54 @@ java_proto_library(
 java_grpc_library(
     name = "kms_java_grpc",
     srcs = [":kms_proto"],
-    deps = [":kms_java_proto"] + _JAVA_GRPC_DEPS,
+    deps = [":kms_java_proto"],
 )
 
 java_resource_name_proto_library(
-    name = "kms_resource_name_java_proto",
+    name = "kms_java_gapic_resource_name",
     gapic_yaml = "cloudkms_gapic.yaml",
-    deps = [":kms_proto"],
+    deps = [
+        ":kms_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 java_gapic_library(
     name = "kms_java_gapic",
     src = ":kms_proto_with_info",
     gapic_yaml = "cloudkms_gapic.yaml",
-    service_yaml = "//google/cloud/kms:cloudkms.yaml",
+    gen_resource_name = False,
+    package = "google.cloud.kms.v1",
+    service_yaml = "cloudkms_v1.yaml",
     test_deps = [
         ":kms_java_grpc",
-        "@com_google_api_grpc_grpc_google_iam_v1//jar",
+        "//google/iam/v1:iam_java_grpc",
     ],
     deps = [
+        ":kms_java_gapic_resource_name",
         ":kms_java_proto",
-        ":kms_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+        "//google/iam/v1:iam_java_proto",
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":kms_java_gapic_test",
+java_gapic_test(
+    name = "kms_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.kms.v1.KeyManagementServiceClientTest",
     ],
-) for test_name in [
-    "com.google.cloud.kms.v1.KeyManagementServiceClientTest",
-]]
+    runtime_deps = [":kms_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-kms-v1-java",
-    client_deps = [":kms_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":kms_java_gapic_test"],
-    grpc_deps = [":kms_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":kms_java_gapic",
+        ":kms_java_gapic_resource_name",
+        ":kms_java_grpc",
         ":kms_java_proto",
         ":kms_proto",
-        ":kms_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -113,10 +113,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -132,10 +132,10 @@ go_proto_library(
 
 go_gapic_library(
     name = "kms_go_gapic",
-    src = ":kms_proto_with_info",
-    gapic_yaml = "cloudkms_gapic.yaml",
-    importpath = "cloud.google.com/go/kms/apiv1",
-    service_yaml = "//google/cloud/kms:cloudkms.yaml",
+    srcs = [":kms_proto_with_info"],
+    grpc_service_config = "cloudkms_grpc_service_config.json",
+    importpath = "cloud.google.com/go/kms/apiv1;kms",
+    service_yaml = "cloudkms_v1.yaml",
     deps = [
         ":kms_go_proto",
         "//google/iam/v1:iam_go_proto",
@@ -150,13 +150,251 @@ go_test(
     importpath = "cloud.google.com/go/kms/apiv1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-kms-v1-go",
     deps = [
         ":kms_go_gapic",
-        ":kms_go_gapic_srcjar-smoke-test.srcjar",
         ":kms_go_gapic_srcjar-test.srcjar",
         ":kms_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "kms_moved_proto",
+    srcs = [":kms_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "kms_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":kms_moved_proto"],
+)
+
+py_grpc_library(
+    name = "kms_py_grpc",
+    srcs = [":kms_moved_proto"],
+    deps = [":kms_py_proto"],
+)
+
+py_gapic_library(
+    name = "kms_py_gapic",
+    src = ":kms_proto_with_info",
+    gapic_yaml = "cloudkms_gapic.yaml",
+    package = "google.cloud.kms.v1",
+    service_yaml = "cloudkms_v1.yaml",
+    deps = [
+        ":kms_py_grpc",
+        ":kms_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "kms-v1-py",
+    deps = [
+        ":kms_py_gapic",
+        ":kms_py_grpc",
+        ":kms_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "kms_php_proto",
+    deps = [":kms_proto"],
+)
+
+php_grpc_library(
+    name = "kms_php_grpc",
+    srcs = [":kms_proto"],
+    deps = [":kms_php_proto"],
+)
+
+php_gapic_library(
+    name = "kms_php_gapic",
+    src = ":kms_proto_with_info",
+    gapic_yaml = "cloudkms_gapic.legacy.yaml",
+    package = "google.cloud.kms.v1",
+    service_yaml = "cloudkms_v1.yaml",
+    deps = [
+        ":kms_php_grpc",
+        ":kms_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-kms-v1-php",
+    deps = [
+        ":kms_php_gapic",
+        ":kms_php_grpc",
+        ":kms_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "kms_nodejs_gapic",
+    src = ":kms_proto_with_info",
+    gapic_yaml = "cloudkms_gapic.yaml",
+    package = "google.cloud.kms.v1",
+    service_yaml = "cloudkms_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "kms-v1-nodejs",
+    deps = [
+        ":kms_nodejs_gapic",
+        ":kms_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "kms_ruby_proto",
+    deps = [":kms_proto"],
+)
+
+ruby_grpc_library(
+    name = "kms_ruby_grpc",
+    srcs = [":kms_proto"],
+    deps = [":kms_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "kms_ruby_gapic",
+    src = ":kms_proto_with_info",
+    gapic_yaml = "cloudkms_gapic.yaml",
+    package = "google.cloud.kms.v1",
+    service_yaml = "cloudkms_v1.yaml",
+    deps = [
+        ":kms_ruby_grpc",
+        ":kms_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-kms-v1-ruby",
+    deps = [
+        ":kms_ruby_gapic",
+        ":kms_ruby_grpc",
+        ":kms_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "kms_csharp_proto",
+    deps = [":kms_proto"],
+)
+
+csharp_grpc_library(
+    name = "kms_csharp_grpc",
+    srcs = [":kms_proto"],
+    deps = [":kms_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "kms_csharp_gapic",
+    src = ":kms_proto_with_info",
+    gapic_yaml = "cloudkms_gapic.yaml",
+    package = "google.cloud.kms.v1",
+    service_yaml = "cloudkms_v1.yaml",
+    deps = [
+        ":kms_csharp_grpc",
+        ":kms_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-kms-v1-csharp",
+    deps = [
+        ":kms_csharp_gapic",
+        ":kms_csharp_grpc",
+        ":kms_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "cc_grpc_library",
+    "cc_proto_library",
+)
+
+cc_proto_library(
+    name = "kms_cc_proto",
+    deps = [":kms_proto"],
+)
+
+cc_grpc_library(
+    name = "kms_cc_grpc",
+    srcs = [":kms_proto"],
+    grpc_only = True,
+    deps = [":kms_cc_proto"],
+)
diff --git a/third_party/googleapis/google/cloud/kms/v1/cloudkms_gapic.legacy.yaml b/third_party/googleapis/google/cloud/kms/v1/cloudkms_gapic.legacy.yaml
new file mode 100644
index 000000000..e459cacd7
--- /dev/null
+++ b/third_party/googleapis/google/cloud/kms/v1/cloudkms_gapic.legacy.yaml
@@ -0,0 +1,683 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.kms.v1
+  python:
+    package_name: google.cloud.kms_v1.gapic
+  go:
+    package_name: cloud.google.com/go/kms/apiv1
+    release_level: GA
+  csharp:
+    package_name: Google.Cloud.Kms.V1
+  ruby:
+    package_name: Google::Cloud::Kms::V1
+    release_level: GA
+  php:
+    package_name: Google\Cloud\Kms\V1
+  nodejs:
+    package_name: kms.v1
+    domain_layer_location: google-cloud
+collection_oneofs:
+- oneof_name: key_oneof
+  collection_names:
+  - key_ring
+  - crypto_key
+interfaces:
+  # The fully qualified name of the API interface.
+- name: google.cloud.kms.v1.KeyManagementService
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}/locations/{location}/keyRings/{key_ring}
+    entity_name: key_ring
+  - name_pattern: projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key_path=**}
+    entity_name: crypto_key_path
+  - name_pattern: projects/{project}/locations/{location}
+    entity_name: location
+  - name_pattern: projects/{project}/locations/{location}/keyRings/{key_ring}/importJobs/{import_job}
+    entity_name: import_job
+  - name_pattern: projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}
+    entity_name: crypto_key
+  - name_pattern: projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}
+    entity_name: crypto_key_version
+  # Definition for retryable codes.
+  # The only operations that should not be retried are those where retrying
+  # could result in a system state that the caller did not intend (for example,
+  # duplicate resources created). See go/gapic-retry-guidance.
+  retry_codes_def:
+  - name: retryable
+    retry_codes:
+    - INTERNAL
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_retryable
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+    # A list of method configurations.
+    # Common properties:
+    #
+    #   name - The simple name of the method.
+    #
+    #   flattening - Specifies the configuration for parameter flattening.
+    #   Describes the parameter groups for which a generator should produce method
+    #   overloads which allow a client to directly pass request message fields as
+    #   method parameters. This information may or may not be used, depending on
+    #   the target language.
+    #   Consists of groups, which each represent a list of parameters to be
+    #   flattened. Each parameter listed must be a field of the request message.
+    #
+    #   required_fields - Fields that are always required for a request to be
+    #   valid.
+    #
+    #   resource_name_treatment - An enum that specifies how to treat the resource
+    #   name formats defined in the field_name_patterns and
+    #   response_field_name_patterns fields.
+    #   UNSET: default value
+    #   NONE: the collection configs will not be used by the generated code.
+    #   VALIDATE: string fields will be validated by the client against the
+    #   specified resource name formats.
+    #   STATIC_TYPES: the client will use generated types for resource names.
+    #
+    #   page_streaming - Specifies the configuration for paging.
+    #   Describes information for generating a method which transforms a paging
+    #   list RPC into a stream of resources.
+    #   Consists of a request and a response.
+    #   The request specifies request information of the list method. It defines
+    #   which fields match the paging pattern in the request. The request consists
+    #   of a page_size_field and a token_field. The page_size_field is the name of
+    #   the optional field specifying the maximum number of elements to be
+    #   returned in the response. The token_field is the name of the field in the
+    #   request containing the page token.
+    #   The response specifies response information of the list method. It defines
+    #   which fields match the paging pattern in the response. The response
+    #   consists of a token_field and a resources_field. The token_field is the
+    #   name of the field in the response containing the next page token. The
+    #   resources_field is the name of the field in the response containing the
+    #   list of resources belonging to the page.
+    #
+    #   retry_codes_name - Specifies the configuration for retryable codes. The
+    #   name must be defined in interfaces.retry_codes_def.
+    #
+    #   retry_params_name - Specifies the configuration for retry/backoff
+    #   parameters. The name must be defined in interfaces.retry_params_def.
+    #
+    #   field_name_patterns - Maps the field name of the request type to
+    #   entity_name of interfaces.collections.
+    #   Specifies the string pattern that the field must follow.
+    #
+    #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+    #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ListKeyRings
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    header_request_params:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: key_rings
+    retry_codes_name: retryable
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: ListImportJobs
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    header_request_params:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: import_jobs
+    retry_codes_name: retryable
+    retry_params_name: default
+    field_name_patterns:
+      parent: key_ring
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: ListCryptoKeys
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    header_request_params:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: crypto_keys
+    retry_codes_name: retryable
+    retry_params_name: default
+    field_name_patterns:
+      parent: key_ring
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: ListCryptoKeyVersions
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    header_request_params:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: crypto_key_versions
+    retry_codes_name: retryable
+    retry_params_name: default
+    field_name_patterns:
+      parent: crypto_key
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: GetKeyRing
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: retryable
+    retry_params_name: default
+    field_name_patterns:
+      name: key_ring
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: GetImportJob
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: retryable
+    retry_params_name: default
+    field_name_patterns:
+      name: import_job
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: GetCryptoKey
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: retryable
+    retry_params_name: default
+    field_name_patterns:
+      name: crypto_key
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: GetCryptoKeyVersion
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: retryable
+    retry_params_name: default
+    field_name_patterns:
+      name: crypto_key_version
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: CreateKeyRing
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - key_ring_id
+        - key_ring
+    required_fields:
+    - parent
+    - key_ring_id
+    - key_ring
+    header_request_params:
+    - parent
+    retry_codes_name: retryable
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: CreateImportJob
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - import_job_id
+        - import_job
+    required_fields:
+    - parent
+    - import_job_id
+    - import_job
+    header_request_params:
+    - parent
+    retry_codes_name: retryable
+    retry_params_name: default
+    field_name_patterns:
+      parent: key_ring
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+    sample_code_init_fields:
+    - import_job_id=my-import-job
+    - import_job.import_method=RSA_OAEP_3072_SHA1_AES_256
+    - import_job.protection_level=HSM
+  - name: CreateCryptoKey
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - crypto_key_id
+        - crypto_key
+    required_fields:
+    - parent
+    - crypto_key_id
+    - crypto_key
+    header_request_params:
+    - parent
+    retry_codes_name: retryable
+    retry_params_name: default
+    field_name_patterns:
+      parent: key_ring
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+    sample_code_init_fields:
+    - crypto_key_id=my-app-key
+    - crypto_key.purpose=ENCRYPT_DECRYPT
+    - crypto_key.next_rotation_time.seconds=2147483647
+    - crypto_key.rotation_period.seconds=604800
+  - name: CreateCryptoKeyVersion
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - crypto_key_version
+    required_fields:
+    - parent
+    - crypto_key_version
+    header_request_params:
+    - parent
+    retry_codes_name: non_retryable
+    retry_params_name: default
+    field_name_patterns:
+      parent: crypto_key
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: ImportCryptoKeyVersion
+    required_fields:
+    - parent
+    - algorithm
+    - import_job
+    header_request_params:
+    - parent
+    retry_codes_name: non_retryable
+    retry_params_name: default
+    field_name_patterns:
+      parent: crypto_key
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: UpdateCryptoKey
+    flattening:
+      groups:
+      - parameters:
+        - crypto_key
+        - update_mask
+    required_fields:
+    - crypto_key
+    - update_mask
+    header_request_params:
+    - crypto_key.name
+    retry_codes_name: retryable
+    retry_params_name: default
+    field_name_patterns:
+      crypto_key.name: crypto_key
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: UpdateCryptoKeyVersion
+    flattening:
+      groups:
+      - parameters:
+        - crypto_key_version
+        - update_mask
+    required_fields:
+    - crypto_key_version
+    - update_mask
+    header_request_params:
+    - crypto_key_version.name
+    retry_codes_name: retryable
+    retry_params_name: default
+    field_name_patterns:
+      crypto_key_version.name: crypto_key_version
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: Encrypt
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - plaintext
+    required_fields:
+    - name
+    - plaintext
+    header_request_params:
+    - name
+    retry_codes_name: retryable
+    retry_params_name: default
+    field_name_patterns:
+      name: crypto_key_path
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: Decrypt
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - ciphertext
+    required_fields:
+    - name
+    - ciphertext
+    header_request_params:
+    - name
+    retry_codes_name: retryable
+    retry_params_name: default
+    field_name_patterns:
+      name: crypto_key
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: UpdateCryptoKeyPrimaryVersion
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - crypto_key_version_id
+    required_fields:
+    - name
+    - crypto_key_version_id
+    header_request_params:
+    - name
+    retry_codes_name: retryable
+    retry_params_name: default
+    field_name_patterns:
+      name: crypto_key
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: DestroyCryptoKeyVersion
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: retryable
+    retry_params_name: default
+    field_name_patterns:
+      name: crypto_key_version
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: RestoreCryptoKeyVersion
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: retryable
+    retry_params_name: default
+    field_name_patterns:
+      name: crypto_key_version
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: GetPublicKey
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: retryable
+    retry_params_name: default
+    field_name_patterns:
+      name: crypto_key_version
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: AsymmetricDecrypt
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - ciphertext
+    required_fields:
+    - name
+    - ciphertext
+    header_request_params:
+    - name
+    retry_codes_name: retryable
+    retry_params_name: default
+    field_name_patterns:
+      name: crypto_key_version
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: AsymmetricSign
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - digest
+    required_fields:
+    - name
+    - digest
+    header_request_params:
+    - name
+    retry_codes_name: retryable
+    retry_params_name: default
+    field_name_patterns:
+      name: crypto_key_version
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: SetIamPolicy
+    flattening:
+      groups:
+      - parameters:
+        - resource
+        - policy
+    required_fields:
+    - resource
+    - policy
+    header_request_params:
+    - resource
+    field_name_patterns:
+      resource: key_oneof
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: retryable
+    retry_params_name: default
+    timeout_millis: 60000
+    reroute_to_grpc_interface: google.iam.v1.IAMPolicy
+    surface_treatments:
+    - include_languages:
+      - go
+      visibility: DISABLED
+  - name: GetIamPolicy
+    flattening:
+      groups:
+      - parameters:
+        - resource
+    required_fields:
+    - resource
+    header_request_params:
+    - resource
+    field_name_patterns:
+      resource: key_oneof
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: retryable
+    retry_params_name: default
+    timeout_millis: 60000
+    reroute_to_grpc_interface: google.iam.v1.IAMPolicy
+    surface_treatments:
+    - include_languages:
+      - go
+      visibility: DISABLED
+  - name: TestIamPermissions
+    flattening:
+      groups:
+      - parameters:
+        - resource
+        - permissions
+    required_fields:
+    - resource
+    - permissions
+    header_request_params:
+    - resource
+    field_name_patterns:
+      resource: key_oneof
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: retryable
+    retry_params_name: default
+    timeout_millis: 60000
+    reroute_to_grpc_interface: google.iam.v1.IAMPolicy
+    surface_treatments:
+    - include_languages:
+      - go
+      visibility: DISABLED
+resource_name_generation:
+- message_name: google.iam.v1.SetIamPolicyRequest
+  field_entity_map:
+    resource: "*"
+- message_name: google.iam.v1.GetIamPolicyRequest
+  field_entity_map:
+    resource: "*"
+- message_name: google.iam.v1.TestIamPermissionsRequest
+  field_entity_map:
+    resource: "*"
+- message_name: KeyRing
+  field_entity_map:
+    name: key_ring
+- message_name: CryptoKey #UpdateCryptoKeyRequest
+  field_entity_map:
+    name: crypto_key
+- message_name: CryptoKeyVersion #UpdateCryptoKeyVersionRequest
+  field_entity_map:
+    name: crypto_key_version
+- message_name: ListKeyRingsRequest
+  field_entity_map:
+    parent: location
+- message_name: ListImportJobsRequest
+  field_entity_map:
+    parent: key_ring
+- message_name: ListCryptoKeysRequest
+  field_entity_map:
+    parent: key_ring
+- message_name: ListCryptoKeyVersionsRequest
+  field_entity_map:
+    parent: crypto_key
+- message_name: GetKeyRingRequest
+  field_entity_map:
+    name: key_ring
+- message_name: GetImportJobRequest
+  field_entity_map:
+    name: import_job
+- message_name: GetCryptoKeyRequest
+  field_entity_map:
+    name: crypto_key
+- message_name: GetCryptoKeyVersionRequest
+  field_entity_map:
+    name: crypto_key_version
+- message_name: CreateKeyRingRequest
+  field_entity_map:
+    parent: location
+- message_name: CreateImportJobRequest
+  field_entity_map:
+    parent: key_ring
+- message_name: CreateCryptoKeyRequest
+  field_entity_map:
+    parent: key_ring
+- message_name: CreateCryptoKeyVersionRequest
+  field_entity_map:
+    parent: crypto_key
+- message_name: ImportCryptoKeyVersionRequest
+  field_entity_map:
+    parent: crypto_key
+- message_name: EncryptRequest
+  field_entity_map:
+    name: crypto_key_path
+- message_name: DecryptRequest
+  field_entity_map:
+    name: crypto_key
+- message_name: UpdateCryptoKeyPrimaryVersionRequest
+  field_entity_map:
+    name: crypto_key
+- message_name: DestroyCryptoKeyVersionRequest
+  field_entity_map:
+    name: crypto_key_version
+- message_name: RestoreCryptoKeyVersionRequest
+  field_entity_map:
+    name: crypto_key_version
+- message_name: GetPublicKeyRequest
+  field_entity_map:
+    name: crypto_key_version
+- message_name: AsymmetricSignRequest
+  field_entity_map:
+    name: crypto_key_version
+- message_name: AsymmetricDecryptRequest
+  field_entity_map:
+    name: crypto_key_version
diff --git a/third_party/googleapis/google/cloud/kms/v1/cloudkms_gapic.yaml b/third_party/googleapis/google/cloud/kms/v1/cloudkms_gapic.yaml
index c0211a9af..9e2703d41 100644
--- a/third_party/googleapis/google/cloud/kms/v1/cloudkms_gapic.yaml
+++ b/third_party/googleapis/google/cloud/kms/v1/cloudkms_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -19,661 +19,91 @@ language_settings:
   nodejs:
     package_name: kms.v1
     domain_layer_location: google-cloud
-collection_oneofs:
-- oneof_name: key_oneof
-  collection_names:
-  - key_ring
-  - crypto_key
 interfaces:
   # The fully qualified name of the API interface.
 - name: google.cloud.kms.v1.KeyManagementService
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections:
-  - name_pattern: projects/{project}/locations/{location}/keyRings/{key_ring}
-    entity_name: key_ring
-  - name_pattern: projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key_path=**}
-    entity_name: crypto_key_path
-  - name_pattern: projects/{project}/locations/{location}
-    entity_name: location
-  - name_pattern: projects/{project}/locations/{location}/keyRings/{key_ring}/importJobs/{import_job}
-    entity_name: import_job
-  - name_pattern: projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}
-    entity_name: crypto_key
-  - name_pattern: projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}
-    entity_name: crypto_key_version
-  # Definition for retryable codes.
   retry_codes_def:
-  - name: idempotent
+  - name: retryable
     retry_codes:
+    - INTERNAL
     - UNAVAILABLE
     - DEADLINE_EXCEEDED
-  - name: non_idempotent
+  - name: non_retryable
     retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-    # A list of method configurations.
-    # Common properties:
-    #
-    #   name - The simple name of the method.
-    #
-    #   flattening - Specifies the configuration for parameter flattening.
-    #   Describes the parameter groups for which a generator should produce method
-    #   overloads which allow a client to directly pass request message fields as
-    #   method parameters. This information may or may not be used, depending on
-    #   the target language.
-    #   Consists of groups, which each represent a list of parameters to be
-    #   flattened. Each parameter listed must be a field of the request message.
-    #
-    #   required_fields - Fields that are always required for a request to be
-    #   valid.
-    #
-    #   resource_name_treatment - An enum that specifies how to treat the resource
-    #   name formats defined in the field_name_patterns and
-    #   response_field_name_patterns fields.
-    #   UNSET: default value
-    #   NONE: the collection configs will not be used by the generated code.
-    #   VALIDATE: string fields will be validated by the client against the
-    #   specified resource name formats.
-    #   STATIC_TYPES: the client will use generated types for resource names.
-    #
-    #   page_streaming - Specifies the configuration for paging.
-    #   Describes information for generating a method which transforms a paging
-    #   list RPC into a stream of resources.
-    #   Consists of a request and a response.
-    #   The request specifies request information of the list method. It defines
-    #   which fields match the paging pattern in the request. The request consists
-    #   of a page_size_field and a token_field. The page_size_field is the name of
-    #   the optional field specifying the maximum number of elements to be
-    #   returned in the response. The token_field is the name of the field in the
-    #   request containing the page token.
-    #   The response specifies response information of the list method. It defines
-    #   which fields match the paging pattern in the response. The response
-    #   consists of a token_field and a resources_field. The token_field is the
-    #   name of the field in the response containing the next page token. The
-    #   resources_field is the name of the field in the response containing the
-    #   list of resources belonging to the page.
-    #
-    #   retry_codes_name - Specifies the configuration for retryable codes. The
-    #   name must be defined in interfaces.retry_codes_def.
-    #
-    #   retry_params_name - Specifies the configuration for retry/backoff
-    #   parameters. The name must be defined in interfaces.retry_params_def.
-    #
-    #   field_name_patterns - Maps the field name of the request type to
-    #   entity_name of interfaces.collections.
-    #   Specifies the string pattern that the field must follow.
-    #
-    #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-    #   the call is retrying, refer to retry_params_name instead.
   methods:
   - name: ListKeyRings
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    header_request_params:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: key_rings
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+    retry_codes_name: retryable
   - name: ListImportJobs
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    header_request_params:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: import_jobs
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: key_ring
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+    retry_codes_name: retryable
   - name: ListCryptoKeys
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    header_request_params:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: crypto_keys
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: key_ring
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+    retry_codes_name: retryable
   - name: ListCryptoKeyVersions
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    header_request_params:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: crypto_key_versions
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: crypto_key
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+    retry_codes_name: retryable
   - name: GetKeyRing
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: key_ring
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+    retry_codes_name: retryable
   - name: GetImportJob
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: import_job
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+    retry_codes_name: retryable
   - name: GetCryptoKey
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: crypto_key
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+    retry_codes_name: retryable
   - name: GetCryptoKeyVersion
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: crypto_key_version
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+    retry_codes_name: retryable
   - name: CreateKeyRing
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - key_ring_id
-        - key_ring
-    required_fields:
-    - parent
-    - key_ring_id
-    - key_ring
-    header_request_params:
-    - parent
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+    retry_codes_name: retryable
   - name: CreateImportJob
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - import_job_id
-        - import_job
-    required_fields:
-    - parent
-    - import_job_id
-    - import_job
-    header_request_params:
-    - parent
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: key_ring
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+    retry_codes_name: retryable
     sample_code_init_fields:
     - import_job_id=my-import-job
     - import_job.import_method=RSA_OAEP_3072_SHA1_AES_256
     - import_job.protection_level=HSM
   - name: CreateCryptoKey
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - crypto_key_id
-        - crypto_key
-    required_fields:
-    - parent
-    - crypto_key_id
-    - crypto_key
-    header_request_params:
-    - parent
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: key_ring
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+    retry_codes_name: retryable
     sample_code_init_fields:
     - crypto_key_id=my-app-key
     - crypto_key.purpose=ENCRYPT_DECRYPT
     - crypto_key.next_rotation_time.seconds=2147483647
     - crypto_key.rotation_period.seconds=604800
   - name: CreateCryptoKeyVersion
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - crypto_key_version
-    required_fields:
-    - parent
-    - crypto_key_version
-    header_request_params:
-    - parent
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: crypto_key
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+    retry_codes_name: non_retryable
   - name: ImportCryptoKeyVersion
-    required_fields:
-    - parent
-    - algorithm
-    - import_job
-    header_request_params:
-    - parent
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: crypto_key
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+    retry_codes_name: non_retryable
   - name: UpdateCryptoKey
-    flattening:
-      groups:
-      - parameters:
-        - crypto_key
-        - update_mask
-    required_fields:
-    - crypto_key
-    - update_mask
-    header_request_params:
-    - crypto_key.name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      crypto_key.name: crypto_key
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+    retry_codes_name: retryable
   - name: UpdateCryptoKeyVersion
-    flattening:
-      groups:
-      - parameters:
-        - crypto_key_version
-        - update_mask
-    required_fields:
-    - crypto_key_version
-    - update_mask
-    header_request_params:
-    - crypto_key_version.name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      crypto_key_version.name: crypto_key_version
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+    retry_codes_name: retryable
   - name: Encrypt
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - plaintext
-    required_fields:
-    - name
-    - plaintext
-    header_request_params:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: crypto_key_path
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+    retry_codes_name: retryable
   - name: Decrypt
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - ciphertext
-    required_fields:
-    - name
-    - ciphertext
-    header_request_params:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: crypto_key
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+    retry_codes_name: retryable
   - name: UpdateCryptoKeyPrimaryVersion
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - crypto_key_version_id
-    required_fields:
-    - name
-    - crypto_key_version_id
-    header_request_params:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: crypto_key
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+    retry_codes_name: retryable
   - name: DestroyCryptoKeyVersion
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: crypto_key_version
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+    retry_codes_name: retryable
   - name: RestoreCryptoKeyVersion
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: crypto_key_version
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+    retry_codes_name: retryable
   - name: GetPublicKey
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: crypto_key_version
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+    retry_codes_name: retryable
   - name: AsymmetricDecrypt
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - ciphertext
-    required_fields:
-    - name
-    - ciphertext
-    header_request_params:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: crypto_key_version
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+    retry_codes_name: retryable
   - name: AsymmetricSign
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - digest
-    required_fields:
-    - name
-    - digest
-    header_request_params:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: crypto_key_version
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+    retry_codes_name: retryable
   - name: SetIamPolicy
-    flattening:
-      groups:
-      - parameters:
-        - resource
-        - policy
-    required_fields:
-    - resource
-    - policy
-    header_request_params:
-    - resource
-    field_name_patterns:
-      resource: key_oneof
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
+    retry_codes_name: retryable
     reroute_to_grpc_interface: google.iam.v1.IAMPolicy
     surface_treatments:
     - include_languages:
       - go
       visibility: DISABLED
   - name: GetIamPolicy
-    flattening:
-      groups:
-      - parameters:
-        - resource
-    required_fields:
-    - resource
-    header_request_params:
-    - resource
-    field_name_patterns:
-      resource: key_oneof
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 60000
+    retry_codes_name: retryable
     reroute_to_grpc_interface: google.iam.v1.IAMPolicy
     surface_treatments:
     - include_languages:
       - go
       visibility: DISABLED
   - name: TestIamPermissions
-    flattening:
-      groups:
-      - parameters:
-        - resource
-        - permissions
-    required_fields:
-    - resource
-    - permissions
-    header_request_params:
-    - resource
-    field_name_patterns:
-      resource: key_oneof
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
+    retry_codes_name: retryable
     reroute_to_grpc_interface: google.iam.v1.IAMPolicy
     surface_treatments:
     - include_languages:
       - go
       visibility: DISABLED
-resource_name_generation:
-- message_name: google.iam.v1.SetIamPolicyRequest
-  field_entity_map:
-    resource: "*"
-- message_name: google.iam.v1.GetIamPolicyRequest
-  field_entity_map:
-    resource: "*"
-- message_name: google.iam.v1.TestIamPermissionsRequest
-  field_entity_map:
-    resource: "*"
-- message_name: KeyRing
-  field_entity_map:
-    name: key_ring
-- message_name: CryptoKey #UpdateCryptoKeyRequest
-  field_entity_map:
-    name: crypto_key
-- message_name: CryptoKeyVersion #UpdateCryptoKeyVersionRequest
-  field_entity_map:
-    name: crypto_key_version
-- message_name: ListKeyRingsRequest
-  field_entity_map:
-    parent: location
-- message_name: ListImportJobsRequest
-  field_entity_map:
-    parent: key_ring
-- message_name: ListCryptoKeysRequest
-  field_entity_map:
-    parent: key_ring
-- message_name: ListCryptoKeyVersionsRequest
-  field_entity_map:
-    parent: crypto_key
-- message_name: GetKeyRingRequest
-  field_entity_map:
-    name: key_ring
-- message_name: GetImportJobRequest
-  field_entity_map:
-    name: import_job
-- message_name: GetCryptoKeyRequest
-  field_entity_map:
-    name: crypto_key
-- message_name: GetCryptoKeyVersionRequest
-  field_entity_map:
-    name: crypto_key_version
-- message_name: CreateKeyRingRequest
-  field_entity_map:
-    parent: location
-- message_name: CreateImportJobRequest
-  field_entity_map:
-    parent: key_ring
-- message_name: CreateCryptoKeyRequest
-  field_entity_map:
-    parent: key_ring
-- message_name: CreateCryptoKeyVersionRequest
-  field_entity_map:
-    parent: crypto_key
-- message_name: ImportCryptoKeyVersionRequest
-  field_entity_map:
-    parent: crypto_key
-- message_name: EncryptRequest
-  field_entity_map:
-    name: crypto_key_path
-- message_name: DecryptRequest
-  field_entity_map:
-    name: crypto_key
-- message_name: UpdateCryptoKeyPrimaryVersionRequest
-  field_entity_map:
-    name: crypto_key
-- message_name: DestroyCryptoKeyVersionRequest
-  field_entity_map:
-    name: crypto_key_version
-- message_name: RestoreCryptoKeyVersionRequest
-  field_entity_map:
-    name: crypto_key_version
-- message_name: GetPublicKeyRequest
-  field_entity_map:
-    name: crypto_key_version
-- message_name: AsymmetricSignRequest
-  field_entity_map:
-    name: crypto_key_version
-- message_name: AsymmetricDecryptRequest
-  field_entity_map:
-    name: crypto_key_version
diff --git a/third_party/googleapis/google/cloud/kms/v1/cloudkms_grpc_service_config.json b/third_party/googleapis/google/cloud/kms/v1/cloudkms_grpc_service_config.json
new file mode 100755
index 000000000..e65ebb1ee
--- /dev/null
+++ b/third_party/googleapis/google/cloud/kms/v1/cloudkms_grpc_service_config.json
@@ -0,0 +1,128 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "CreateCryptoKeyVersion"
+        },
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "ImportCryptoKeyVersion"
+        }
+      ],
+      "timeout": "60s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "ListKeyRings"
+        },
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "ListImportJobs"
+        },
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "ListCryptoKeys"
+        },
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "ListCryptoKeyVersions"
+        },
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "GetKeyRing"
+        },
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "GetImportJob"
+        },
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "GetCryptoKey"
+        },
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "GetCryptoKeyVersion"
+        },
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "CreateKeyRing"
+        },
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "CreateImportJob"
+        },
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "CreateCryptoKey"
+        },
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "UpdateCryptoKey"
+        },
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "UpdateCryptoKeyVersion"
+        },
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "Encrypt"
+        },
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "Decrypt"
+        },
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "UpdateCryptoKeyPrimaryVersion"
+        },
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "DestroyCryptoKeyVersion"
+        },
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "RestoreCryptoKeyVersion"
+        },
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "GetPublicKey"
+        },
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "AsymmetricDecrypt"
+        },
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "AsymmetricSign"
+        },
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "SetIamPolicy"
+        },
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "GetIamPolicy"
+        },
+        {
+          "service": "google.cloud.kms.v1.KeyManagementService",
+          "method": "TestIamPermissions"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "INTERNAL",
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/kms/cloudkms.yaml b/third_party/googleapis/google/cloud/kms/v1/cloudkms_v1.yaml
similarity index 96%
rename from third_party/googleapis/google/cloud/kms/cloudkms.yaml
rename to third_party/googleapis/google/cloud/kms/v1/cloudkms_v1.yaml
index 3a4c2360e..502026406 100644
--- a/third_party/googleapis/google/cloud/kms/cloudkms.yaml
+++ b/third_party/googleapis/google/cloud/kms/v1/cloudkms_v1.yaml
@@ -24,6 +24,9 @@ documentation:
       Sets the access control policy on the specified resource. Replaces
       any existing policy.
 
+      Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and
+      PERMISSION_DENIED
+
   - selector: google.iam.v1.IAMPolicy.TestIamPermissions
     description: |-
       Returns permissions that a caller has on the specified resource. If the
diff --git a/third_party/googleapis/google/cloud/kms/v1/resources.proto b/third_party/googleapis/google/cloud/kms/v1/resources.proto
index 09baaf1be..b2b7ab919 100644
--- a/third_party/googleapis/google/cloud/kms/v1/resources.proto
+++ b/third_party/googleapis/google/cloud/kms/v1/resources.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,15 +11,16 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.kms.v1;
 
-import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
 
 option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.Kms.V1";
@@ -31,12 +32,17 @@ option php_namespace = "Google\\Cloud\\Kms\\V1";
 
 // A [KeyRing][google.cloud.kms.v1.KeyRing] is a toplevel logical grouping of [CryptoKeys][google.cloud.kms.v1.CryptoKey].
 message KeyRing {
+  option (google.api.resource) = {
+    type: "cloudkms.googleapis.com/KeyRing"
+    pattern: "projects/{project}/locations/{location}/keyRings/{key_ring}"
+  };
+
   // Output only. The resource name for the [KeyRing][google.cloud.kms.v1.KeyRing] in the format
   // `projects/*/locations/*/keyRings/*`.
-  string name = 1;
+  string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The time at which this [KeyRing][google.cloud.kms.v1.KeyRing] was created.
-  google.protobuf.Timestamp create_time = 2;
+  google.protobuf.Timestamp create_time = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // A [CryptoKey][google.cloud.kms.v1.CryptoKey] represents a logical key that can be used for cryptographic
@@ -45,6 +51,11 @@ message KeyRing {
 // A [CryptoKey][google.cloud.kms.v1.CryptoKey] is made up of one or more [versions][google.cloud.kms.v1.CryptoKeyVersion], which
 // represent the actual key material used in cryptographic operations.
 message CryptoKey {
+  option (google.api.resource) = {
+    type: "cloudkms.googleapis.com/CryptoKey"
+    pattern: "projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}"
+  };
+
   // [CryptoKeyPurpose][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose] describes the cryptographic capabilities of a
   // [CryptoKey][google.cloud.kms.v1.CryptoKey]. A given key can only be used for the operations allowed by
   // its purpose. For more information, see
@@ -71,7 +82,7 @@ message CryptoKey {
 
   // Output only. The resource name for this [CryptoKey][google.cloud.kms.v1.CryptoKey] in the format
   // `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
-  string name = 1;
+  string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. A copy of the "primary" [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] that will be used
   // by [Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt] when this [CryptoKey][google.cloud.kms.v1.CryptoKey] is given
@@ -80,16 +91,16 @@ message CryptoKey {
   // The [CryptoKey][google.cloud.kms.v1.CryptoKey]'s primary version can be updated via
   // [UpdateCryptoKeyPrimaryVersion][google.cloud.kms.v1.KeyManagementService.UpdateCryptoKeyPrimaryVersion].
   //
-  // All keys with [purpose][google.cloud.kms.v1.CryptoKey.purpose]
-  // [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT] have a
+  // Keys with [purpose][google.cloud.kms.v1.CryptoKey.purpose]
+  // [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT] may have a
   // primary. For other keys, this field will be omitted.
-  CryptoKeyVersion primary = 2;
+  CryptoKeyVersion primary = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // The immutable purpose of this [CryptoKey][google.cloud.kms.v1.CryptoKey].
-  CryptoKeyPurpose purpose = 3;
+  // Immutable. The immutable purpose of this [CryptoKey][google.cloud.kms.v1.CryptoKey].
+  CryptoKeyPurpose purpose = 3 [(google.api.field_behavior) = IMMUTABLE];
 
   // Output only. The time at which this [CryptoKey][google.cloud.kms.v1.CryptoKey] was created.
-  google.protobuf.Timestamp create_time = 5;
+  google.protobuf.Timestamp create_time = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // At [next_rotation_time][google.cloud.kms.v1.CryptoKey.next_rotation_time], the Key Management Service will automatically:
   //
@@ -109,7 +120,8 @@ message CryptoKey {
   // Controls the rate of automatic rotation.
   oneof rotation_schedule {
     // [next_rotation_time][google.cloud.kms.v1.CryptoKey.next_rotation_time] will be advanced by this period when the service
-    // automatically rotates a key. Must be at least one day.
+    // automatically rotates a key. Must be at least 24 hours and at most
+    // 876,000 hours.
     //
     // If [rotation_period][google.cloud.kms.v1.CryptoKey.rotation_period] is set, [next_rotation_time][google.cloud.kms.v1.CryptoKey.next_rotation_time] must also be set.
     //
@@ -145,7 +157,7 @@ message CryptoKeyVersionTemplate {
   // For backwards compatibility, GOOGLE_SYMMETRIC_ENCRYPTION is implied if both
   // this field is omitted and [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] is
   // [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT].
-  CryptoKeyVersion.CryptoKeyVersionAlgorithm algorithm = 3;
+  CryptoKeyVersion.CryptoKeyVersionAlgorithm algorithm = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Contains an HSM-generated attestation about a key operation. For more
@@ -167,11 +179,11 @@ message KeyOperationAttestation {
   }
 
   // Output only. The format of the attestation data.
-  AttestationFormat format = 4;
+  AttestationFormat format = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The attestation data provided by the HSM when the key
   // operation was performed.
-  bytes content = 5;
+  bytes content = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // A [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] represents an individual cryptographic key, and the
@@ -185,6 +197,11 @@ message KeyOperationAttestation {
 // encrypt, decrypt, or sign data when an authorized user or application invokes
 // Cloud KMS.
 message CryptoKeyVersion {
+  option (google.api.resource) = {
+    type: "cloudkms.googleapis.com/CryptoKeyVersion"
+    pattern: "projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}"
+  };
+
   // The algorithm of the [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion], indicating what
   // parameters must be used for each cryptographic operation.
   //
@@ -267,6 +284,9 @@ message CryptoKeyVersion {
 
     // ECDSA on the NIST P-384 curve with a SHA384 digest.
     EC_SIGN_P384_SHA384 = 13;
+
+    // Algorithm representing symmetric encryption by an external key manager.
+    EXTERNAL_SYMMETRIC_ENCRYPTION = 18;
   }
 
   // The state of a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion], indicating if it can be used.
@@ -324,60 +344,70 @@ message CryptoKeyVersion {
 
   // Output only. The resource name for this [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] in the format
   // `projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*`.
-  string name = 1;
+  string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // The current state of the [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion].
   CryptoKeyVersionState state = 3;
 
   // Output only. The [ProtectionLevel][google.cloud.kms.v1.ProtectionLevel] describing how crypto operations are
   // performed with this [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion].
-  ProtectionLevel protection_level = 7;
+  ProtectionLevel protection_level = 7 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The [CryptoKeyVersionAlgorithm][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionAlgorithm] that this
   // [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] supports.
-  CryptoKeyVersionAlgorithm algorithm = 10;
+  CryptoKeyVersionAlgorithm algorithm = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Statement that was generated and signed by the HSM at key
   // creation time. Use this statement to verify attributes of the key as stored
   // on the HSM, independently of Google. Only provided for key versions with
   // [protection_level][google.cloud.kms.v1.CryptoKeyVersion.protection_level] [HSM][google.cloud.kms.v1.ProtectionLevel.HSM].
-  KeyOperationAttestation attestation = 8;
+  KeyOperationAttestation attestation = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The time at which this [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] was created.
-  google.protobuf.Timestamp create_time = 4;
+  google.protobuf.Timestamp create_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The time this [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]'s key material was
   // generated.
-  google.protobuf.Timestamp generate_time = 11;
+  google.protobuf.Timestamp generate_time = 11 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The time this [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]'s key material is scheduled
   // for destruction. Only present if [state][google.cloud.kms.v1.CryptoKeyVersion.state] is
   // [DESTROY_SCHEDULED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROY_SCHEDULED].
-  google.protobuf.Timestamp destroy_time = 5;
+  google.protobuf.Timestamp destroy_time = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The time this CryptoKeyVersion's key material was
   // destroyed. Only present if [state][google.cloud.kms.v1.CryptoKeyVersion.state] is
   // [DESTROYED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROYED].
-  google.protobuf.Timestamp destroy_event_time = 6;
+  google.protobuf.Timestamp destroy_event_time = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The name of the [ImportJob][google.cloud.kms.v1.ImportJob] used to import this
   // [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]. Only present if the underlying key material was
   // imported.
-  string import_job = 14;
+  string import_job = 14 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The time at which this [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]'s key material
   // was imported.
-  google.protobuf.Timestamp import_time = 15;
+  google.protobuf.Timestamp import_time = 15 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The root cause of an import failure. Only present if
   // [state][google.cloud.kms.v1.CryptoKeyVersion.state] is
   // [IMPORT_FAILED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.IMPORT_FAILED].
-  string import_failure_reason = 16;
+  string import_failure_reason = 16 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // ExternalProtectionLevelOptions stores a group of additional fields for
+  // configuring a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] that are specific to the
+  // [EXTERNAL][google.cloud.kms.v1.ProtectionLevel.EXTERNAL] protection level.
+  ExternalProtectionLevelOptions external_protection_level_options = 17;
 }
 
 // The public key for a given [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]. Obtained via
 // [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey].
 message PublicKey {
+  option (google.api.resource) = {
+    type: "cloudkms.googleapis.com/PublicKey"
+    pattern: "projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}/publicKey"
+  };
+
   // The public key, encoded in PEM format. For more information, see the
   // [RFC 7468](https://tools.ietf.org/html/rfc7468) sections for
   // [General Considerations](https://tools.ietf.org/html/rfc7468#section-2) and
@@ -390,20 +420,6 @@ message PublicKey {
   CryptoKeyVersion.CryptoKeyVersionAlgorithm algorithm = 2;
 }
 
-// [ProtectionLevel][google.cloud.kms.v1.ProtectionLevel] specifies how cryptographic operations are performed.
-// For more information, see [Protection levels]
-// (https://cloud.google.com/kms/docs/algorithms#protection_levels).
-enum ProtectionLevel {
-  // Not specified.
-  PROTECTION_LEVEL_UNSPECIFIED = 0;
-
-  // Crypto operations are performed in software.
-  SOFTWARE = 1;
-
-  // Crypto operations are performed in a Hardware Security Module.
-  HSM = 2;
-}
-
 // An [ImportJob][google.cloud.kms.v1.ImportJob] can be used to create [CryptoKeys][google.cloud.kms.v1.CryptoKey] and
 // [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion] using pre-existing key material,
 // generated outside of Cloud KMS.
@@ -432,6 +448,11 @@ enum ProtectionLevel {
 // For more information, see
 // [Importing a key](https://cloud.google.com/kms/docs/importing-a-key).
 message ImportJob {
+  option (google.api.resource) = {
+    type: "cloudkms.googleapis.com/ImportJob"
+    pattern: "projects/{project}/locations/{location}/keyRings/{key_ring}/importJobs/{import_job}"
+  };
+
   // The public key component of the wrapping key. For details of the type of
   // key this public key corresponds to, see the [ImportMethod][google.cloud.kms.v1.ImportJob.ImportMethod].
   message WrappingPublicKey {
@@ -488,46 +509,75 @@ message ImportJob {
 
   // Output only. The resource name for this [ImportJob][google.cloud.kms.v1.ImportJob] in the format
   // `projects/*/locations/*/keyRings/*/importJobs/*`.
-  string name = 1;
+  string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // Required and immutable. The wrapping method to be used for incoming
-  // key material.
-  ImportMethod import_method = 2;
+  // Required. Immutable. The wrapping method to be used for incoming key material.
+  ImportMethod import_method = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.field_behavior) = IMMUTABLE
+  ];
 
-  // Required and immutable. The protection level of the [ImportJob][google.cloud.kms.v1.ImportJob]. This
-  // must match the
+  // Required. Immutable. The protection level of the [ImportJob][google.cloud.kms.v1.ImportJob]. This must match the
   // [protection_level][google.cloud.kms.v1.CryptoKeyVersionTemplate.protection_level] of the
   // [version_template][google.cloud.kms.v1.CryptoKey.version_template] on the [CryptoKey][google.cloud.kms.v1.CryptoKey] you
   // attempt to import into.
-  ProtectionLevel protection_level = 9;
+  ProtectionLevel protection_level = 9 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.field_behavior) = IMMUTABLE
+  ];
 
   // Output only. The time at which this [ImportJob][google.cloud.kms.v1.ImportJob] was created.
-  google.protobuf.Timestamp create_time = 3;
+  google.protobuf.Timestamp create_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The time this [ImportJob][google.cloud.kms.v1.ImportJob]'s key material was generated.
-  google.protobuf.Timestamp generate_time = 4;
+  google.protobuf.Timestamp generate_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The time at which this [ImportJob][google.cloud.kms.v1.ImportJob] is scheduled for
   // expiration and can no longer be used to import key material.
-  google.protobuf.Timestamp expire_time = 5;
+  google.protobuf.Timestamp expire_time = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The time this [ImportJob][google.cloud.kms.v1.ImportJob] expired. Only present if
   // [state][google.cloud.kms.v1.ImportJob.state] is [EXPIRED][google.cloud.kms.v1.ImportJob.ImportJobState.EXPIRED].
-  google.protobuf.Timestamp expire_event_time = 10;
+  google.protobuf.Timestamp expire_event_time = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The current state of the [ImportJob][google.cloud.kms.v1.ImportJob], indicating if it can
   // be used.
-  ImportJobState state = 6;
+  ImportJobState state = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The public key with which to wrap key material prior to
   // import. Only returned if [state][google.cloud.kms.v1.ImportJob.state] is
   // [ACTIVE][google.cloud.kms.v1.ImportJob.ImportJobState.ACTIVE].
-  WrappingPublicKey public_key = 7;
+  WrappingPublicKey public_key = 7 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Statement that was generated and signed by the key creator
   // (for example, an HSM) at key creation time. Use this statement to verify
   // attributes of the key as stored on the HSM, independently of Google.
   // Only present if the chosen [ImportMethod][google.cloud.kms.v1.ImportJob.ImportMethod] is one with a protection
   // level of [HSM][google.cloud.kms.v1.ProtectionLevel.HSM].
-  KeyOperationAttestation attestation = 8;
+  KeyOperationAttestation attestation = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// [ProtectionLevel][google.cloud.kms.v1.ProtectionLevel] specifies how cryptographic operations are performed.
+// For more information, see [Protection levels]
+// (https://cloud.google.com/kms/docs/algorithms#protection_levels).
+enum ProtectionLevel {
+  // Not specified.
+  PROTECTION_LEVEL_UNSPECIFIED = 0;
+
+  // Crypto operations are performed in software.
+  SOFTWARE = 1;
+
+  // Crypto operations are performed in a Hardware Security Module.
+  HSM = 2;
+
+  // Crypto operations are performed by an external key manager.
+  EXTERNAL = 3;
+}
+
+// ExternalProtectionLevelOptions stores a group of additional fields for
+// configuring a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] that are specific to the
+// [EXTERNAL][google.cloud.kms.v1.ProtectionLevel.EXTERNAL] protection level.
+message ExternalProtectionLevelOptions {
+  // The URI for an external resource that this [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] represents.
+  string external_key_uri = 1;
 }
diff --git a/third_party/googleapis/google/cloud/kms/v1/service.proto b/third_party/googleapis/google/cloud/kms/v1/service.proto
index 0f1266dfe..d0c8949cb 100644
--- a/third_party/googleapis/google/cloud/kms/v1/service.proto
+++ b/third_party/googleapis/google/cloud/kms/v1/service.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,16 +11,17 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.kms.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/kms/v1/resources.proto";
 import "google/protobuf/field_mask.proto";
-import "google/api/client.proto";
 
 option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.Kms.V1";
@@ -38,6 +39,7 @@ option php_namespace = "Google\\Cloud\\Kms\\V1";
 // * [KeyRing][google.cloud.kms.v1.KeyRing]
 // * [CryptoKey][google.cloud.kms.v1.CryptoKey]
 // * [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]
+// * [ImportJob][google.cloud.kms.v1.ImportJob]
 //
 // If you are using manual gRPC libraries, see
 // [Using gRPC with Cloud KMS](https://cloud.google.com/kms/docs/grpc).
@@ -52,6 +54,7 @@ service KeyManagementService {
     option (google.api.http) = {
       get: "/v1/{parent=projects/*/locations/*}/keyRings"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Lists [CryptoKeys][google.cloud.kms.v1.CryptoKey].
@@ -59,6 +62,7 @@ service KeyManagementService {
     option (google.api.http) = {
       get: "/v1/{parent=projects/*/locations/*/keyRings/*}/cryptoKeys"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Lists [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion].
@@ -66,6 +70,7 @@ service KeyManagementService {
     option (google.api.http) = {
       get: "/v1/{parent=projects/*/locations/*/keyRings/*/cryptoKeys/*}/cryptoKeyVersions"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Lists [ImportJobs][google.cloud.kms.v1.ImportJob].
@@ -73,6 +78,7 @@ service KeyManagementService {
     option (google.api.http) = {
       get: "/v1/{parent=projects/*/locations/*/keyRings/*}/importJobs"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Returns metadata for a given [KeyRing][google.cloud.kms.v1.KeyRing].
@@ -80,6 +86,7 @@ service KeyManagementService {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/locations/*/keyRings/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Returns metadata for a given [CryptoKey][google.cloud.kms.v1.CryptoKey], as well as its
@@ -88,6 +95,7 @@ service KeyManagementService {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Returns metadata for a given [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion].
@@ -95,6 +103,7 @@ service KeyManagementService {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Returns the public key for the given [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]. The
@@ -105,6 +114,7 @@ service KeyManagementService {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}/publicKey"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Returns metadata for a given [ImportJob][google.cloud.kms.v1.ImportJob].
@@ -112,6 +122,7 @@ service KeyManagementService {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/locations/*/keyRings/*/importJobs/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Create a new [KeyRing][google.cloud.kms.v1.KeyRing] in a given Project and Location.
@@ -120,6 +131,7 @@ service KeyManagementService {
       post: "/v1/{parent=projects/*/locations/*}/keyRings"
       body: "key_ring"
     };
+    option (google.api.method_signature) = "parent,key_ring_id,key_ring";
   }
 
   // Create a new [CryptoKey][google.cloud.kms.v1.CryptoKey] within a [KeyRing][google.cloud.kms.v1.KeyRing].
@@ -132,6 +144,7 @@ service KeyManagementService {
       post: "/v1/{parent=projects/*/locations/*/keyRings/*}/cryptoKeys"
       body: "crypto_key"
     };
+    option (google.api.method_signature) = "parent,crypto_key_id,crypto_key";
   }
 
   // Create a new [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] in a [CryptoKey][google.cloud.kms.v1.CryptoKey].
@@ -144,6 +157,7 @@ service KeyManagementService {
       post: "/v1/{parent=projects/*/locations/*/keyRings/*/cryptoKeys/*}/cryptoKeyVersions"
       body: "crypto_key_version"
     };
+    option (google.api.method_signature) = "parent,crypto_key_version";
   }
 
   // Imports a new [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] into an existing [CryptoKey][google.cloud.kms.v1.CryptoKey] using the
@@ -166,6 +180,7 @@ service KeyManagementService {
       post: "/v1/{parent=projects/*/locations/*/keyRings/*}/importJobs"
       body: "import_job"
     };
+    option (google.api.method_signature) = "parent,import_job_id,import_job";
   }
 
   // Update a [CryptoKey][google.cloud.kms.v1.CryptoKey].
@@ -174,6 +189,7 @@ service KeyManagementService {
       patch: "/v1/{crypto_key.name=projects/*/locations/*/keyRings/*/cryptoKeys/*}"
       body: "crypto_key"
     };
+    option (google.api.method_signature) = "crypto_key,update_mask";
   }
 
   // Update a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]'s metadata.
@@ -188,6 +204,7 @@ service KeyManagementService {
       patch: "/v1/{crypto_key_version.name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}"
       body: "crypto_key_version"
     };
+    option (google.api.method_signature) = "crypto_key_version,update_mask";
   }
 
   // Encrypts data, so that it can only be recovered by a call to [Decrypt][google.cloud.kms.v1.KeyManagementService.Decrypt].
@@ -198,6 +215,7 @@ service KeyManagementService {
       post: "/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/**}:encrypt"
       body: "*"
     };
+    option (google.api.method_signature) = "name,plaintext";
   }
 
   // Decrypts data that was protected by [Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt]. The [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose]
@@ -207,6 +225,7 @@ service KeyManagementService {
       post: "/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*}:decrypt"
       body: "*"
     };
+    option (google.api.method_signature) = "name,ciphertext";
   }
 
   // Signs data using a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] with [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose]
@@ -217,6 +236,7 @@ service KeyManagementService {
       post: "/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}:asymmetricSign"
       body: "*"
     };
+    option (google.api.method_signature) = "name,digest";
   }
 
   // Decrypts data that was encrypted with a public key retrieved from
@@ -227,6 +247,7 @@ service KeyManagementService {
       post: "/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}:asymmetricDecrypt"
       body: "*"
     };
+    option (google.api.method_signature) = "name,ciphertext";
   }
 
   // Update the version of a [CryptoKey][google.cloud.kms.v1.CryptoKey] that will be used in [Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt].
@@ -237,6 +258,7 @@ service KeyManagementService {
       post: "/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*}:updatePrimaryVersion"
       body: "*"
     };
+    option (google.api.method_signature) = "name,crypto_key_version_id";
   }
 
   // Schedule a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] for destruction.
@@ -256,6 +278,7 @@ service KeyManagementService {
       post: "/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}:destroy"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Restore a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] in the
@@ -270,6 +293,7 @@ service KeyManagementService {
       post: "/v1/{name=projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*}:restore"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 }
 
@@ -277,103 +301,143 @@ service KeyManagementService {
 message ListKeyRingsRequest {
   // Required. The resource name of the location associated with the
   // [KeyRings][google.cloud.kms.v1.KeyRing], in the format `projects/*/locations/*`.
-  string parent = 1;
-
-  // Optional limit on the number of [KeyRings][google.cloud.kms.v1.KeyRing] to include in the
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // Optional. Optional limit on the number of [KeyRings][google.cloud.kms.v1.KeyRing] to include in the
   // response.  Further [KeyRings][google.cloud.kms.v1.KeyRing] can subsequently be obtained by
   // including the [ListKeyRingsResponse.next_page_token][google.cloud.kms.v1.ListKeyRingsResponse.next_page_token] in a subsequent
   // request.  If unspecified, the server will pick an appropriate default.
-  int32 page_size = 2;
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional pagination token, returned earlier via
+  // Optional. Optional pagination token, returned earlier via
   // [ListKeyRingsResponse.next_page_token][google.cloud.kms.v1.ListKeyRingsResponse.next_page_token].
-  string page_token = 3;
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. Only include resources that match the filter in the response.
-  string filter = 4;
+  // Optional. Only include resources that match the filter in the response. For
+  // more information, see
+  // [Sorting and filtering list
+  // results](https://cloud.google.com/kms/docs/sorting-and-filtering).
+  string filter = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Specify how the results should be sorted. If not specified, the
-  // results will be sorted in the default order.
-  string order_by = 5;
+  // results will be sorted in the default order.  For more information, see
+  // [Sorting and filtering list
+  // results](https://cloud.google.com/kms/docs/sorting-and-filtering).
+  string order_by = 5 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request message for [KeyManagementService.ListCryptoKeys][google.cloud.kms.v1.KeyManagementService.ListCryptoKeys].
 message ListCryptoKeysRequest {
   // Required. The resource name of the [KeyRing][google.cloud.kms.v1.KeyRing] to list, in the format
   // `projects/*/locations/*/keyRings/*`.
-  string parent = 1;
-
-  // Optional limit on the number of [CryptoKeys][google.cloud.kms.v1.CryptoKey] to include in the
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudkms.googleapis.com/KeyRing"
+    }
+  ];
+
+  // Optional. Optional limit on the number of [CryptoKeys][google.cloud.kms.v1.CryptoKey] to include in the
   // response.  Further [CryptoKeys][google.cloud.kms.v1.CryptoKey] can subsequently be obtained by
   // including the [ListCryptoKeysResponse.next_page_token][google.cloud.kms.v1.ListCryptoKeysResponse.next_page_token] in a subsequent
   // request.  If unspecified, the server will pick an appropriate default.
-  int32 page_size = 2;
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional pagination token, returned earlier via
+  // Optional. Optional pagination token, returned earlier via
   // [ListCryptoKeysResponse.next_page_token][google.cloud.kms.v1.ListCryptoKeysResponse.next_page_token].
-  string page_token = 3;
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
 
   // The fields of the primary version to include in the response.
   CryptoKeyVersion.CryptoKeyVersionView version_view = 4;
 
-  // Optional. Only include resources that match the filter in the response.
-  string filter = 5;
+  // Optional. Only include resources that match the filter in the response. For
+  // more information, see
+  // [Sorting and filtering list
+  // results](https://cloud.google.com/kms/docs/sorting-and-filtering).
+  string filter = 5 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Specify how the results should be sorted. If not specified, the
-  // results will be sorted in the default order.
-  string order_by = 6;
+  // results will be sorted in the default order. For more information, see
+  // [Sorting and filtering list
+  // results](https://cloud.google.com/kms/docs/sorting-and-filtering).
+  string order_by = 6 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request message for [KeyManagementService.ListCryptoKeyVersions][google.cloud.kms.v1.KeyManagementService.ListCryptoKeyVersions].
 message ListCryptoKeyVersionsRequest {
   // Required. The resource name of the [CryptoKey][google.cloud.kms.v1.CryptoKey] to list, in the format
   // `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
-  string parent = 1;
-
-  // Optional limit on the number of [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion] to
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudkms.googleapis.com/CryptoKey"
+    }
+  ];
+
+  // Optional. Optional limit on the number of [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion] to
   // include in the response. Further [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion] can
   // subsequently be obtained by including the
   // [ListCryptoKeyVersionsResponse.next_page_token][google.cloud.kms.v1.ListCryptoKeyVersionsResponse.next_page_token] in a subsequent request.
   // If unspecified, the server will pick an appropriate default.
-  int32 page_size = 2;
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional pagination token, returned earlier via
+  // Optional. Optional pagination token, returned earlier via
   // [ListCryptoKeyVersionsResponse.next_page_token][google.cloud.kms.v1.ListCryptoKeyVersionsResponse.next_page_token].
-  string page_token = 3;
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
 
   // The fields to include in the response.
   CryptoKeyVersion.CryptoKeyVersionView view = 4;
 
-  // Optional. Only include resources that match the filter in the response.
-  string filter = 5;
+  // Optional. Only include resources that match the filter in the response. For
+  // more information, see
+  // [Sorting and filtering list
+  // results](https://cloud.google.com/kms/docs/sorting-and-filtering).
+  string filter = 5 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Specify how the results should be sorted. If not specified, the
-  // results will be sorted in the default order.
-  string order_by = 6;
+  // results will be sorted in the default order. For more information, see
+  // [Sorting and filtering list
+  // results](https://cloud.google.com/kms/docs/sorting-and-filtering).
+  string order_by = 6 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request message for [KeyManagementService.ListImportJobs][google.cloud.kms.v1.KeyManagementService.ListImportJobs].
 message ListImportJobsRequest {
   // Required. The resource name of the [KeyRing][google.cloud.kms.v1.KeyRing] to list, in the format
   // `projects/*/locations/*/keyRings/*`.
-  string parent = 1;
-
-  // Optional limit on the number of [ImportJobs][google.cloud.kms.v1.ImportJob] to include in the
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudkms.googleapis.com/KeyRing"
+    }
+  ];
+
+  // Optional. Optional limit on the number of [ImportJobs][google.cloud.kms.v1.ImportJob] to include in the
   // response. Further [ImportJobs][google.cloud.kms.v1.ImportJob] can subsequently be obtained by
   // including the [ListImportJobsResponse.next_page_token][google.cloud.kms.v1.ListImportJobsResponse.next_page_token] in a subsequent
   // request. If unspecified, the server will pick an appropriate default.
-  int32 page_size = 2;
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional pagination token, returned earlier via
+  // Optional. Optional pagination token, returned earlier via
   // [ListImportJobsResponse.next_page_token][google.cloud.kms.v1.ListImportJobsResponse.next_page_token].
-  string page_token = 3;
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. Only include resources that match the filter in the response.
-  string filter = 4;
+  // Optional. Only include resources that match the filter in the response. For
+  // more information, see
+  // [Sorting and filtering list
+  // results](https://cloud.google.com/kms/docs/sorting-and-filtering).
+  string filter = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Specify how the results should be sorted. If not specified, the
-  // results will be sorted in the default order.
-  string order_by = 5;
+  // results will be sorted in the default order. For more information, see
+  // [Sorting and filtering list
+  // results](https://cloud.google.com/kms/docs/sorting-and-filtering).
+  string order_by = 5 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response message for [KeyManagementService.ListKeyRings][google.cloud.kms.v1.KeyManagementService.ListKeyRings].
@@ -432,61 +496,96 @@ message ListImportJobsResponse {
 
 // Request message for [KeyManagementService.GetKeyRing][google.cloud.kms.v1.KeyManagementService.GetKeyRing].
 message GetKeyRingRequest {
-  // The [name][google.cloud.kms.v1.KeyRing.name] of the [KeyRing][google.cloud.kms.v1.KeyRing] to get.
-  string name = 1;
+  // Required. The [name][google.cloud.kms.v1.KeyRing.name] of the [KeyRing][google.cloud.kms.v1.KeyRing] to get.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudkms.googleapis.com/KeyRing"
+    }
+  ];
 }
 
 // Request message for [KeyManagementService.GetCryptoKey][google.cloud.kms.v1.KeyManagementService.GetCryptoKey].
 message GetCryptoKeyRequest {
-  // The [name][google.cloud.kms.v1.CryptoKey.name] of the [CryptoKey][google.cloud.kms.v1.CryptoKey] to get.
-  string name = 1;
+  // Required. The [name][google.cloud.kms.v1.CryptoKey.name] of the [CryptoKey][google.cloud.kms.v1.CryptoKey] to get.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudkms.googleapis.com/CryptoKey"
+    }
+  ];
 }
 
 // Request message for [KeyManagementService.GetCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.GetCryptoKeyVersion].
 message GetCryptoKeyVersionRequest {
-  // The [name][google.cloud.kms.v1.CryptoKeyVersion.name] of the [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] to get.
-  string name = 1;
+  // Required. The [name][google.cloud.kms.v1.CryptoKeyVersion.name] of the [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] to get.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudkms.googleapis.com/CryptoKeyVersion"
+    }
+  ];
 }
 
 // Request message for [KeyManagementService.GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey].
 message GetPublicKeyRequest {
-  // The [name][google.cloud.kms.v1.CryptoKeyVersion.name] of the [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] public key to
+  // Required. The [name][google.cloud.kms.v1.CryptoKeyVersion.name] of the [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] public key to
   // get.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudkms.googleapis.com/CryptoKeyVersion"
+    }
+  ];
 }
 
 // Request message for [KeyManagementService.GetImportJob][google.cloud.kms.v1.KeyManagementService.GetImportJob].
 message GetImportJobRequest {
-  // The [name][google.cloud.kms.v1.ImportJob.name] of the [ImportJob][google.cloud.kms.v1.ImportJob] to get.
-  string name = 1;
+  // Required. The [name][google.cloud.kms.v1.ImportJob.name] of the [ImportJob][google.cloud.kms.v1.ImportJob] to get.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudkms.googleapis.com/ImportJob"
+    }
+  ];
 }
 
 // Request message for [KeyManagementService.CreateKeyRing][google.cloud.kms.v1.KeyManagementService.CreateKeyRing].
 message CreateKeyRingRequest {
   // Required. The resource name of the location associated with the
   // [KeyRings][google.cloud.kms.v1.KeyRing], in the format `projects/*/locations/*`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
   // Required. It must be unique within a location and match the regular
   // expression `[a-zA-Z0-9_-]{1,63}`
-  string key_ring_id = 2;
+  string key_ring_id = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // A [KeyRing][google.cloud.kms.v1.KeyRing] with initial field values.
-  KeyRing key_ring = 3;
+  // Required. A [KeyRing][google.cloud.kms.v1.KeyRing] with initial field values.
+  KeyRing key_ring = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request message for [KeyManagementService.CreateCryptoKey][google.cloud.kms.v1.KeyManagementService.CreateCryptoKey].
 message CreateCryptoKeyRequest {
   // Required. The [name][google.cloud.kms.v1.KeyRing.name] of the KeyRing associated with the
   // [CryptoKeys][google.cloud.kms.v1.CryptoKey].
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudkms.googleapis.com/KeyRing"
+    }
+  ];
 
   // Required. It must be unique within a KeyRing and match the regular
   // expression `[a-zA-Z0-9_-]{1,63}`
-  string crypto_key_id = 2;
+  string crypto_key_id = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // A [CryptoKey][google.cloud.kms.v1.CryptoKey] with initial field values.
-  CryptoKey crypto_key = 3;
+  // Required. A [CryptoKey][google.cloud.kms.v1.CryptoKey] with initial field values.
+  CryptoKey crypto_key = 3 [(google.api.field_behavior) = REQUIRED];
 
   // If set to true, the request will create a [CryptoKey][google.cloud.kms.v1.CryptoKey] without any
   // [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion]. You must manually call
@@ -500,27 +599,37 @@ message CreateCryptoKeyRequest {
 message CreateCryptoKeyVersionRequest {
   // Required. The [name][google.cloud.kms.v1.CryptoKey.name] of the [CryptoKey][google.cloud.kms.v1.CryptoKey] associated with
   // the [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion].
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudkms.googleapis.com/CryptoKey"
+    }
+  ];
 
-  // A [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] with initial field values.
-  CryptoKeyVersion crypto_key_version = 2;
+  // Required. A [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] with initial field values.
+  CryptoKeyVersion crypto_key_version = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request message for [KeyManagementService.ImportCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.ImportCryptoKeyVersion].
 message ImportCryptoKeyVersionRequest {
   // Required. The [name][google.cloud.kms.v1.CryptoKey.name] of the [CryptoKey][google.cloud.kms.v1.CryptoKey] to
   // be imported into.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudkms.googleapis.com/CryptoKey"
+    }
+  ];
 
   // Required. The [algorithm][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionAlgorithm] of
   // the key being imported. This does not need to match the
   // [version_template][google.cloud.kms.v1.CryptoKey.version_template] of the [CryptoKey][google.cloud.kms.v1.CryptoKey] this
   // version imports into.
-  CryptoKeyVersion.CryptoKeyVersionAlgorithm algorithm = 2;
+  CryptoKeyVersion.CryptoKeyVersionAlgorithm algorithm = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Required. The [name][google.cloud.kms.v1.ImportJob.name] of the [ImportJob][google.cloud.kms.v1.ImportJob] that was used to
   // wrap this key material.
-  string import_job = 4;
+  string import_job = 4 [(google.api.field_behavior) = REQUIRED];
 
   // Required. The incoming wrapped key material that is to be imported.
   oneof wrapped_key_material {
@@ -540,6 +649,11 @@ message ImportCryptoKeyVersionRequest {
     //   
     // 
     //
+    // If importing symmetric key material, it is expected that the unwrapped
+    // key contains plain bytes. If importing asymmetric key material, it is
+    // expected that the unwrapped key is in PKCS#8-encoded DER format (the
+    // PrivateKeyInfo structure from RFC 5208).
+    //
     // This format is the same as the format produced by PKCS#11 mechanism
     // CKM_RSA_AES_KEY_WRAP.
     bytes rsa_aes_wrapped_key = 5;
@@ -550,32 +664,37 @@ message ImportCryptoKeyVersionRequest {
 message CreateImportJobRequest {
   // Required. The [name][google.cloud.kms.v1.KeyRing.name] of the [KeyRing][google.cloud.kms.v1.KeyRing] associated with the
   // [ImportJobs][google.cloud.kms.v1.ImportJob].
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudkms.googleapis.com/KeyRing"
+    }
+  ];
 
   // Required. It must be unique within a KeyRing and match the regular
   // expression `[a-zA-Z0-9_-]{1,63}`
-  string import_job_id = 2;
+  string import_job_id = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Required. An [ImportJob][google.cloud.kms.v1.ImportJob] with initial field values.
-  ImportJob import_job = 3;
+  ImportJob import_job = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request message for [KeyManagementService.UpdateCryptoKey][google.cloud.kms.v1.KeyManagementService.UpdateCryptoKey].
 message UpdateCryptoKeyRequest {
-  // [CryptoKey][google.cloud.kms.v1.CryptoKey] with updated values.
-  CryptoKey crypto_key = 1;
+  // Required. [CryptoKey][google.cloud.kms.v1.CryptoKey] with updated values.
+  CryptoKey crypto_key = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Required list of fields to be updated in this request.
-  google.protobuf.FieldMask update_mask = 2;
+  // Required. List of fields to be updated in this request.
+  google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request message for [KeyManagementService.UpdateCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.UpdateCryptoKeyVersion].
 message UpdateCryptoKeyVersionRequest {
-  // [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] with updated values.
-  CryptoKeyVersion crypto_key_version = 1;
+  // Required. [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] with updated values.
+  CryptoKeyVersion crypto_key_version = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Required list of fields to be updated in this request.
-  google.protobuf.FieldMask update_mask = 2;
+  // Required. List of fields to be updated in this request.
+  google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request message for [KeyManagementService.Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt].
@@ -585,7 +704,12 @@ message EncryptRequest {
   //
   // If a [CryptoKey][google.cloud.kms.v1.CryptoKey] is specified, the server will use its
   // [primary version][google.cloud.kms.v1.CryptoKey.primary].
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "*"
+    }
+  ];
 
   // Required. The data to encrypt. Must be no larger than 64KiB.
   //
@@ -595,9 +719,9 @@ message EncryptRequest {
   // than 64KiB. For [HSM][google.cloud.kms.v1.ProtectionLevel.HSM] keys, the combined length of the
   // plaintext and additional_authenticated_data fields must be no larger than
   // 8KiB.
-  bytes plaintext = 2;
+  bytes plaintext = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional data that, if specified, must also be provided during decryption
+  // Optional. Optional data that, if specified, must also be provided during decryption
   // through [DecryptRequest.additional_authenticated_data][google.cloud.kms.v1.DecryptRequest.additional_authenticated_data].
   //
   // The maximum size depends on the key version's
@@ -606,44 +730,59 @@ message EncryptRequest {
   // 64KiB. For [HSM][google.cloud.kms.v1.ProtectionLevel.HSM] keys, the combined length of the
   // plaintext and additional_authenticated_data fields must be no larger than
   // 8KiB.
-  bytes additional_authenticated_data = 3;
+  bytes additional_authenticated_data = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request message for [KeyManagementService.Decrypt][google.cloud.kms.v1.KeyManagementService.Decrypt].
 message DecryptRequest {
   // Required. The resource name of the [CryptoKey][google.cloud.kms.v1.CryptoKey] to use for decryption.
   // The server will choose the appropriate version.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudkms.googleapis.com/CryptoKey"
+    }
+  ];
 
   // Required. The encrypted data originally returned in
   // [EncryptResponse.ciphertext][google.cloud.kms.v1.EncryptResponse.ciphertext].
-  bytes ciphertext = 2;
+  bytes ciphertext = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional data that must match the data originally supplied in
+  // Optional. Optional data that must match the data originally supplied in
   // [EncryptRequest.additional_authenticated_data][google.cloud.kms.v1.EncryptRequest.additional_authenticated_data].
-  bytes additional_authenticated_data = 3;
+  bytes additional_authenticated_data = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request message for [KeyManagementService.AsymmetricSign][google.cloud.kms.v1.KeyManagementService.AsymmetricSign].
 message AsymmetricSignRequest {
   // Required. The resource name of the [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] to use for signing.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudkms.googleapis.com/CryptoKeyVersion"
+    }
+  ];
 
   // Required. The digest of the data to sign. The digest must be produced with
   // the same digest algorithm as specified by the key version's
   // [algorithm][google.cloud.kms.v1.CryptoKeyVersion.algorithm].
-  Digest digest = 3;
+  Digest digest = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request message for [KeyManagementService.AsymmetricDecrypt][google.cloud.kms.v1.KeyManagementService.AsymmetricDecrypt].
 message AsymmetricDecryptRequest {
   // Required. The resource name of the [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] to use for
   // decryption.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudkms.googleapis.com/CryptoKeyVersion"
+    }
+  ];
 
   // Required. The data encrypted with the named [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]'s public
   // key using OAEP.
-  bytes ciphertext = 3;
+  bytes ciphertext = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response message for [KeyManagementService.Decrypt][google.cloud.kms.v1.KeyManagementService.Decrypt].
@@ -654,7 +793,8 @@ message DecryptResponse {
 
 // Response message for [KeyManagementService.Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt].
 message EncryptResponse {
-  // The resource name of the [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] used in encryption.
+  // The resource name of the [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] used in encryption. Check
+  // this field to verify that the intended resource was used for encryption.
   string name = 1;
 
   // The encrypted data.
@@ -675,23 +815,38 @@ message AsymmetricDecryptResponse {
 
 // Request message for [KeyManagementService.UpdateCryptoKeyPrimaryVersion][google.cloud.kms.v1.KeyManagementService.UpdateCryptoKeyPrimaryVersion].
 message UpdateCryptoKeyPrimaryVersionRequest {
-  // The resource name of the [CryptoKey][google.cloud.kms.v1.CryptoKey] to update.
-  string name = 1;
+  // Required. The resource name of the [CryptoKey][google.cloud.kms.v1.CryptoKey] to update.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudkms.googleapis.com/CryptoKey"
+    }
+  ];
 
-  // The id of the child [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] to use as primary.
-  string crypto_key_version_id = 2;
+  // Required. The id of the child [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] to use as primary.
+  string crypto_key_version_id = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request message for [KeyManagementService.DestroyCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.DestroyCryptoKeyVersion].
 message DestroyCryptoKeyVersionRequest {
-  // The resource name of the [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] to destroy.
-  string name = 1;
+  // Required. The resource name of the [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] to destroy.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudkms.googleapis.com/CryptoKeyVersion"
+    }
+  ];
 }
 
 // Request message for [KeyManagementService.RestoreCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.RestoreCryptoKeyVersion].
 message RestoreCryptoKeyVersionRequest {
-  // The resource name of the [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] to restore.
-  string name = 1;
+  // Required. The resource name of the [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] to restore.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudkms.googleapis.com/CryptoKeyVersion"
+    }
+  ];
 }
 
 // A [Digest][google.cloud.kms.v1.Digest] holds a cryptographic message digest.
@@ -715,4 +870,9 @@ message LocationMetadata {
   // [protection_level][google.cloud.kms.v1.CryptoKeyVersionTemplate.protection_level]
   // [HSM][google.cloud.kms.v1.ProtectionLevel.HSM] can be created in this location.
   bool hsm_available = 1;
+
+  // Indicates whether [CryptoKeys][google.cloud.kms.v1.CryptoKey] with
+  // [protection_level][google.cloud.kms.v1.CryptoKeyVersionTemplate.protection_level]
+  // [EXTERNAL][google.cloud.kms.v1.ProtectionLevel.EXTERNAL] can be created in this location.
+  bool ekm_available = 2;
 }
diff --git a/third_party/googleapis/google/cloud/language/artman_language_v1.yaml b/third_party/googleapis/google/cloud/language/artman_language_v1.yaml
index 56c301dd1..199014460 100644
--- a/third_party/googleapis/google/cloud/language/artman_language_v1.yaml
+++ b/third_party/googleapis/google/cloud/language/artman_language_v1.yaml
@@ -3,11 +3,12 @@ common:
   api_version: v1
   organization_name: google-cloud
   proto_deps:
-    - name: google-common-protos
+  - name: google-common-protos
   src_proto_paths:
   - v1
   service_yaml: language_v1.yaml
   gapic_yaml: v1/language_gapic.yaml
+  samples: v1/samples
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/cloud/language/v1/BUILD.bazel b/third_party/googleapis/google/cloud/language/v1/BUILD.bazel
index 5766b6440..23f50c44c 100644
--- a/third_party/googleapis/google/cloud/language/v1/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/language/v1/BUILD.bazel
@@ -1,14 +1,19 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
     name = "language_proto",
-    srcs = ["language_service.proto"],
+    srcs = [
+        "language_service.proto",
+    ],
     deps = [
         "//google/api:annotations_proto",
         "//google/api:client_proto",
@@ -18,7 +23,10 @@ proto_library(
 
 proto_library_with_info(
     name = "language_proto_with_info",
-    deps = [":language_proto"],
+    deps = [
+        ":language_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -26,17 +34,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
     name = "language_java_proto",
     deps = [":language_proto"],
@@ -45,39 +49,40 @@ java_proto_library(
 java_grpc_library(
     name = "language_java_grpc",
     srcs = [":language_proto"],
-    deps = [":language_java_proto"] + _JAVA_GRPC_DEPS,
+    deps = [":language_java_proto"],
 )
 
 java_gapic_library(
     name = "language_java_gapic",
     src = ":language_proto_with_info",
     gapic_yaml = "language_gapic.yaml",
+    package = "google.cloud.language.v1",
     service_yaml = "//google/cloud/language:language_v1.yaml",
-    test_deps = [":language_java_grpc"],
-    deps = [":language_java_proto"] + _JAVA_GRPC_DEPS,
+    test_deps = [
+        ":language_java_grpc",
+    ],
+    deps = [
+        ":language_java_proto",
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
+java_gapic_test(
+    name = "language_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.language.v1.LanguageServiceClientTest",
+    ],
     runtime_deps = [":language_java_gapic_test"],
-) for test_name in [
-    "com.google.cloud.language.v1.LanguageServiceClientTest",
-]]
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-language-v1-java",
-    client_deps = [":language_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":language_java_gapic_test"],
-    grpc_deps = [":language_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":language_java_gapic",
+        ":language_java_grpc",
         ":language_java_proto",
         ":language_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -85,10 +90,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -96,16 +101,20 @@ go_proto_library(
     compilers = ["@io_bazel_rules_go//proto:go_grpc"],
     importpath = "google.golang.org/genproto/googleapis/cloud/language/v1",
     protos = [":language_proto"],
-    deps = ["//google/api:annotations_go_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
 )
 
 go_gapic_library(
     name = "language_go_gapic",
-    src = ":language_proto_with_info",
-    gapic_yaml = "language_gapic.yaml",
-    importpath = "cloud.google.com/go/language/apiv1",
+    srcs = [":language_proto_with_info"],
+    grpc_service_config = "language_grpc_service_config.json",
+    importpath = "cloud.google.com/go/language/apiv1;language",
     service_yaml = "//google/cloud/language:language_v1.yaml",
-    deps = [":language_go_proto"],
+    deps = [
+        ":language_go_proto",
+    ],
 )
 
 go_test(
@@ -115,26 +124,81 @@ go_test(
     importpath = "cloud.google.com/go/language/apiv1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-language-v1-go",
     deps = [
         ":language_go_gapic",
-        ":language_go_gapic_srcjar-smoke-test.srcjar",
         ":language_go_gapic_srcjar-test.srcjar",
         ":language_go_proto",
     ],
 )
 
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "language_moved_proto",
+    srcs = [":language_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+    ],
+)
+
+py_proto_library(
+    name = "language_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":language_moved_proto"],
+)
+
+py_grpc_library(
+    name = "language_py_grpc",
+    srcs = [":language_moved_proto"],
+    deps = [":language_py_proto"],
+)
+
+py_gapic_library(
+    name = "language_py_gapic",
+    src = ":language_proto_with_info",
+    gapic_yaml = "language_gapic.yaml",
+    package = "google.cloud.language.v1",
+    service_yaml = "//google/cloud/language:language_v1.yaml",
+    deps = [
+        ":language_py_grpc",
+        ":language_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "language-v1-py",
+    deps = [
+        ":language_py_gapic",
+        ":language_py_grpc",
+        ":language_py_proto",
+    ],
+)
+
 ##############################################################################
 # PHP
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "php_proto_library",
-    "php_grpc_library",
-    "php_gapic_library",
     "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
 )
 
 php_proto_library(
@@ -152,14 +216,15 @@ php_gapic_library(
     name = "language_php_gapic",
     src = ":language_proto_with_info",
     gapic_yaml = "language_gapic.yaml",
+    package = "google.cloud.language.v1",
     service_yaml = "//google/cloud/language:language_v1.yaml",
     deps = [
-        ":langauge_php_grpc",
+        ":language_php_grpc",
         ":language_php_proto",
     ],
 )
 
-# Opensource Packages
+# Open Source Packages
 php_gapic_assembly_pkg(
     name = "google-cloud-language-v1-php",
     deps = [
@@ -174,14 +239,15 @@ php_gapic_assembly_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "nodejs_gapic_library",
     "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
 )
 
 nodejs_gapic_library(
     name = "language_nodejs_gapic",
     src = ":language_proto_with_info",
     gapic_yaml = "language_gapic.yaml",
+    package = "google.cloud.language.v1",
     service_yaml = "//google/cloud/language:language_v1.yaml",
     deps = [],
 )
@@ -194,3 +260,95 @@ nodejs_gapic_assembly_pkg(
     ],
 )
 
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "language_ruby_proto",
+    deps = [":language_proto"],
+)
+
+ruby_grpc_library(
+    name = "language_ruby_grpc",
+    srcs = [":language_proto"],
+    deps = [":language_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "language_ruby_gapic",
+    src = ":language_proto_with_info",
+    gapic_yaml = "language_gapic.yaml",
+    package = "google.cloud.language.v1",
+    service_yaml = "//google/cloud/language:language_v1.yaml",
+    deps = [
+        ":language_ruby_grpc",
+        ":language_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-language-v1-ruby",
+    deps = [
+        ":language_ruby_gapic",
+        ":language_ruby_grpc",
+        ":language_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "language_csharp_proto",
+    deps = [":language_proto"],
+)
+
+csharp_grpc_library(
+    name = "language_csharp_grpc",
+    srcs = [":language_proto"],
+    deps = [":language_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "language_csharp_gapic",
+    src = ":language_proto_with_info",
+    gapic_yaml = "language_gapic.yaml",
+    package = "google.cloud.language.v1",
+    service_yaml = "//google/cloud/language:language_v1.yaml",
+    deps = [
+        ":language_csharp_grpc",
+        ":language_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-language-v1-csharp",
+    deps = [
+        ":language_csharp_gapic",
+        ":language_csharp_grpc",
+        ":language_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/language/v1/language.tests.yaml b/third_party/googleapis/google/cloud/language/v1/language.tests.yaml
deleted file mode 100644
index d133b04f6..000000000
--- a/third_party/googleapis/google/cloud/language/v1/language.tests.yaml
+++ /dev/null
@@ -1,123 +0,0 @@
-test:
-  suites:
-  - name: Natural Language V1
-    cases:
-
-    - name: Analyze Syntax
-      spec:
-      - call: {sample: language_syntax_text}
-      - assert_contains:
-        - literal: "Text: This"
-        - literal: "Text: is"
-        - literal: "Text: short"
-        - literal: "Text: sentence"
-        - literal: "Text: ."
-
-    - name: Analyze Syntax – GCS
-      spec:
-      - call:
-          sample: language_syntax_gcs
-      - assert_contains:
-        - literal: "Text: This"
-        - literal: "Text: is"
-        - literal: "Text: short"
-        - literal: "Text: sentence"
-        - literal: "Text: ."
-
-    - name: Analyze Sentiment
-      spec:
-      - call: {sample: language_sentiment_text}
-      - assert_contains:
-        # Default message should return positive: 'I am so happy and joyful'
-        - literal: "Sentiment score: 0."
-        - literal: "Magnitude: 0."
-
-    - name: Analyze Sentiment – Negative
-      spec:
-      - call:
-          sample: language_sentiment_text
-          params:
-            text_content:
-              literal: "I am so sad and upset."
-      - assert_contains:
-        - literal: "Sentiment score: -0."
-        - literal: "Magnitude: 0."
-
-    - name: Analyze Sentiment – GCS
-      spec:
-      - call: {sample: language_sentiment_gcs}
-      - assert_contains:
-        # Default message should return positive: 'I am so happy and joyful'
-        - literal: "Sentiment score: 0."
-        - literal: "Magnitude: 0."
-
-    - name: Analyze Sentiment – GCS – Negative
-      spec:
-      - call:
-          sample: language_sentiment_gcs
-          params:
-            gcs_uri:
-              literal: "gs://cloud-samples-data/language/sentiment-negative.txt"
-      - assert_contains:
-        - literal: "Sentiment score: -0."
-        - literal: "Magnitude: 0."
-
-    - name: Analyze Entities
-      spec:
-      - call: {sample: language_entities_text}
-      - assert_contains:
-        - literal: "Entity name: California"
-        - literal: "Entity salience score: 1"
-        - literal: "Mention: California"
-        - literal: "Mention: state"
-
-    - name: Analyze Entities – GCS
-      spec:
-      - call: {sample: language_entities_gcs}
-      - assert_contains:
-        - literal: "Entity name: California"
-        - literal: "Entity salience score: 1"
-        - literal: "Mention: California"
-        - literal: "Mention: state"
-
-    - name: Analyze Entity Sentiment
-      spec:
-      - call: {sample: language_entity_sentiment_text}
-      - assert_contains:
-        - literal: "Entity name: Grapes"
-        - literal: "Entity sentiment score: 0."
-        - literal: "Mention: Grapes"
-        - literal: "Mention sentiment score: 0."
-        - literal: "Mention sentiment magnitude: 0."
-        - literal: "Entity name: Bananas"
-        - literal: "Entity sentiment score: -0."
-        - literal: "Mention: Bananas"
-        - literal: "Mention sentiment score: -0."
-
-    - name: Analyze Entity Sentiment – GCS
-      spec:
-      - call: {sample: language_entity_sentiment_gcs}
-      - assert_contains:
-        - literal: "Entity name: Grapes"
-        - literal: "Entity sentiment score: 0."
-        - literal: "Mention: Grapes"
-        - literal: "Mention sentiment score: 0."
-        - literal: "Mention sentiment magnitude: 0."
-        - literal: "Entity name: Bananas"
-        - literal: "Entity sentiment score: -0."
-        - literal: "Mention: Bananas"
-        - literal: "Mention sentiment score: -0."
-
-    - name: Classify Text
-      spec:
-      - call: {sample: language_classify_text}
-      - assert_contains:
-        - literal: "Category name: /Arts & Entertainment"
-        - literal: "Confidence: 0."
-
-    - name: Classify Text – GCS
-      spec:
-      - call: {sample: language_classify_gcs}
-      - assert_contains:
-        - literal: "Category name: /Arts & Entertainment"
-        - literal: "Confidence: 0."
diff --git a/third_party/googleapis/google/cloud/language/v1/language_gapic.legacy.yaml b/third_party/googleapis/google/cloud/language/v1/language_gapic.legacy.yaml
new file mode 100644
index 000000000..2b05e8be2
--- /dev/null
+++ b/third_party/googleapis/google/cloud/language/v1/language_gapic.legacy.yaml
@@ -0,0 +1,185 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.language.v1
+  python:
+    package_name: google.cloud.language_v1.gapic
+  go:
+    package_name: cloud.google.com/go/language/apiv1
+  csharp:
+    package_name: Google.Cloud.Language.V1
+  ruby:
+    package_name: Google::Cloud::Language::V1
+  php:
+    package_name: Google\Cloud\Language\V1
+  nodejs:
+    package_name: language.v1
+    domain_layer_location: google-cloud
+# A list of API interface configurations.
+interfaces:
+  # The fully qualified name of the API interface.
+- name: google.cloud.language.v1.LanguageService
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections: []
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: AnalyzeSentiment
+    flattening:
+      groups:
+      - parameters:
+        - document
+        - encoding_type
+      - parameters:
+        - document
+    required_fields:
+    - document
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: AnalyzeEntities
+    flattening:
+      groups:
+      - parameters:
+        - document
+        - encoding_type
+      - parameters:
+        - document
+    required_fields:
+    - document
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: AnalyzeEntitySentiment
+    flattening:
+      groups:
+      - parameters:
+        - document
+        - encoding_type
+      - parameters:
+        - document
+    required_fields:
+    - document
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: AnalyzeSyntax
+    flattening:
+      groups:
+      - parameters:
+        - document
+        - encoding_type
+      - parameters:
+        - document
+    required_fields:
+    - document
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: ClassifyText
+    flattening:
+      groups:
+      - parameters:
+        - document
+    required_fields:
+    - document
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: AnnotateText
+    flattening:
+      groups:
+      - parameters:
+        - document
+        - features
+        - encoding_type
+      - parameters:
+        - document
+        - features
+    required_fields:
+    - document
+    - features
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/language/v1/language_gapic.yaml b/third_party/googleapis/google/cloud/language/v1/language_gapic.yaml
index a3796fc94..bf6b0bf7a 100644
--- a/third_party/googleapis/google/cloud/language/v1/language_gapic.yaml
+++ b/third_party/googleapis/google/cloud/language/v1/language_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -21,25 +21,6 @@ language_settings:
 interfaces:
   # The fully qualified name of the API interface.
 - name: google.cloud.language.v1.LanguageService
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections: []
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
   # Definition for retry/backoff parameters.
   retry_params_def:
   - name: default
@@ -55,364 +36,30 @@ interfaces:
   #
   #   name - The simple name of the method.
   #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
   #   retry_codes_name - Specifies the configuration for retryable codes. The
   #   name must be defined in interfaces.retry_codes_def.
   #
   #   retry_params_name - Specifies the configuration for retry/backoff
   #   parameters. The name must be defined in interfaces.retry_params_def.
   #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
   #   timeout_millis - Specifies the default timeout for a non-retrying call. If
   #   the call is retrying, refer to retry_params_name instead.
   methods:
   - name: AnalyzeSentiment
-    flattening:
-      groups:
-      - parameters:
-        - document
-        - encoding_type
-      - parameters:
-        - document
-    required_fields:
-    - document
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
-    samples:
-      standalone:
-      - value_sets: [language_sentiment_text]
-        region_tag: language_sentiment_text
-      - value_sets: [language_sentiment_gcs]
-        region_tag: language_sentiment_gcs
-      - region_tag: analyze_text_sentiment
-        value_sets: [analyze_text_sentiment]
-    sample_value_sets:
-    - id: analyze_text_sentiment
-      description: This sample demonstrates analyzing the sentiment of text
-      parameters:
-        defaults:
-        - document.type=PLAIN_TEXT
-        - document.content="I am so happy"
-    - id: language_sentiment_text
-      description: "Analyze sentiment of text"
-      parameters:
-        defaults:
-        - document.type=PLAIN_TEXT
-        - document.content="I am so happy and joyful."
-        attributes:
-        - parameter: document.content
-          sample_argument_name: text_content
-      on_success:
-      - define: sentiment=$resp.document_sentiment
-      - print: ["Sentiment score: %s", sentiment.score]
-      - print: ["Magnitude: %s", sentiment.magnitude]
-    - id: language_sentiment_gcs
-      description: "Analyze sentiment of text stored in GCS"
-      parameters:
-        defaults:
-        - document.type=PLAIN_TEXT
-        - document.gcs_content_uri="gs://cloud-samples-data/language/sentiment-positive.txt"
-        attributes:
-        - parameter: document.gcs_content_uri
-          sample_argument_name: gcs_uri
-      on_success:
-      - define: sentiment=$resp.document_sentiment
-      - print: ["Sentiment score: %s", sentiment.score]
-      - print: ["Magnitude: %s", sentiment.magnitude]
   - name: AnalyzeEntities
-    flattening:
-      groups:
-      - parameters:
-        - document
-        - encoding_type
-      - parameters:
-        - document
-    required_fields:
-    - document
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
-    samples:
-      standalone:
-      - value_sets: [language_entities_text]
-        region_tag: language_entities_text
-      - value_sets: [language_entities_gcs]
-        region_tag: language_entities_gcs
-    sample_value_sets:
-    - id: language_entities_text
-      description: "Analyze entities in text"
-      parameters:
-        defaults:
-        - document.type=PLAIN_TEXT
-        - document.content="California is a state."
-        attributes:
-        - parameter: document.content
-          sample_argument_name: text_content
-      on_success:
-      - loop:
-          collection: $resp.entities
-          variable: entity
-          body:
-          - print: ["Entity name: %s", entity.name]
-          - print: ["Entity type: %s", entity.type]
-          - print: ["Entity salience score: %s", entity.salience]
-          - loop:
-              collection: entity.mentions
-              variable: mention
-              body:
-              - print: ["Mention: %s", mention.text.content]
-              - print: ["Mention type: %s", mention.type]
-    - id: language_entities_gcs
-      description: "Analyze entities in text stored in GCS"
-      parameters:
-        defaults:
-        - document.type=PLAIN_TEXT
-        - document.gcs_content_uri="gs://cloud-samples-data/language/entity.txt"
-        attributes:
-        - parameter: document.gcs_content_uri
-          sample_argument_name: gcs_ur
-      on_success:
-      - loop:
-          collection: $resp.entities
-          variable: entity
-          body:
-          - print: ["Entity name: %s", entity.name]
-          - print: ["Entity type: %s", entity.type]
-          - print: ["Entity salience score: %s", entity.salience]
-          - loop:
-              collection: entity.mentions
-              variable: mention
-              body:
-              - print: ["Mention: %s", mention.text.content]
-              - print: ["Mention type: %s", mention.type]
   - name: AnalyzeEntitySentiment
-    flattening:
-      groups:
-      - parameters:
-        - document
-        - encoding_type
-      - parameters:
-        - document
-    required_fields:
-    - document
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
-    samples:
-      standalone:
-      - value_sets: [language_entity_sentiment_text]
-        region_tag: language_entity_sentiment_text
-      - value_sets: [language_entity_sentiment_gcs]
-        region_tag: language_entity_sentiment_gcs
-    sample_value_sets:
-    - id: language_entity_sentiment_text
-      description: "Analyze Sentiment of Entities in Text"
-      parameters:
-        defaults:
-        - document.type=PLAIN_TEXT
-        - document.content="Grapes are good. Bananas are bad."
-        attributes:
-        - parameter: document.content
-          sample_argument_name: text_content
-      on_success:
-      - loop:
-          collection: $resp.entities
-          variable: entity
-          body:
-          - print: ["Entity name: %s", entity.name]
-          - print: ["Entity sentiment score: %s", entity.sentiment.score]
-          - loop:
-              collection: entity.mentions
-              variable: mention
-              body:
-              - print: ["Mention: %s", mention.text.content]
-              - print: ["Mention type: %s", mention.type]
-              - print: ["Mention sentiment score: %s", mention.sentiment.score]
-              - print:
-                - "Mention sentiment magnitude: %s"
-                - mention.sentiment.magnitude
-    - id: language_entity_sentiment_gcs
-      description: "Analyze Sentiment of Entities in Text stored in GCS"
-      parameters:
-        defaults:
-        - document.type=PLAIN_TEXT
-        - document.gcs_content_uri="gs://cloud-samples-data/language/entity-sentiment.txt"
-        attributes:
-        - parameter: document.gcs_content_uri
-          sample_argument_name: gcs_ur
-      on_success:
-      - loop:
-          collection: $resp.entities
-          variable: entity
-          body:
-          - print: ["Entity name: %s", entity.name]
-          - print: ["Entity sentiment score: %s", entity.sentiment.score]
-          - loop:
-              collection: entity.mentions
-              variable: mention
-              body:
-              - print: ["Mention: %s", mention.text.content]
-              - print: ["Mention type: %s", mention.type]
-              - print: ["Mention sentiment score: %s", mention.sentiment.score]
-              - print:
-                - "Mention sentiment magnitude: %s"
-                - mention.sentiment.magnitude
   - name: AnalyzeSyntax
-    flattening:
-      groups:
-      - parameters:
-        - document
-        - encoding_type
-      - parameters:
-        - document
-    required_fields:
-    - document
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
-    samples:
-      standalone:
-      - value_sets: [language_syntax_text]
-        region_tag: language_syntax_text
-      - value_sets: [language_syntax_gcs]
-        region_tag: language_syntax_gcs
-    sample_value_sets:
-    - id: language_syntax_text
-      description: "Analyze syntax of text"
-      parameters:
-        defaults:
-        - document.type=PLAIN_TEXT
-        - document.content="This is a short sentence."
-        attributes:
-        - parameter: document.content
-          sample_argument_name: text_content
-      on_success:
-      - define: tokens=$resp.tokens
-      - loop:
-          variable: token
-          collection: tokens
-          body:
-          - print: ["Part of speech: %s", token.part_of_speech.tag]
-          - print: ["Text: %s", token.text.content]
-    - id: language_syntax_gcs
-      description: "Analyze syntax of text in GCS"
-      parameters:
-        defaults:
-        - document.type=PLAIN_TEXT
-        - document.gcs_content_uri="gs://cloud-samples-data/language/syntax-sentence.txt"
-        attributes:
-        - parameter: document.gcs_content_uri
-          sample_argument_name: gcs_urs
-      on_success:
-      - define: tokens=$resp.tokens
-      - loop:
-          variable: token
-          collection: tokens
-          body:
-          - print: ["Part of speech: %s", token.part_of_speech.tag]
-          - print: ["Text: %s", token.text.content]
   - name: ClassifyText
-    flattening:
-      groups:
-      - parameters:
-        - document
-    required_fields:
-    - document
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
-    samples:
-      standalone:
-      - value_sets: [language_classify_text]
-        region_tag: language_classify_text
-      - value_sets: [language_classify_gcs]
-        region_tag: language_classify_gcs
-    sample_value_sets:
-    - id: language_classify_text
-      description: "Classify text"
-      parameters:
-        defaults:
-        - document.type=PLAIN_TEXT
-        - document.content="This is about film and movies and television and acting and movie theatres and theatre and drama and entertainment and the arts."
-        attributes:
-        - parameter: document.content
-          sample_argument_name: text_content
-      on_success:
-      - loop:
-          collection: $resp.categories
-          variable: category
-          body:
-          - print: ["Category name: %s", category.name]
-          - print: ["Confidence: %s", category.confidence]
-    - id: language_classify_gcs
-      description: "Classify text in GCS"
-      parameters:
-        defaults:
-        - document.type=PLAIN_TEXT
-        - document.gcs_content_uri="gs://cloud-samples-data/language/classify-entertainment.txt"
-        attributes:
-        - parameter: document.gcs_content_uri
-          sample_argument_name: gcs_urs
-      on_success:
-      - loop:
-          collection: $resp.categories
-          variable: category
-          body:
-          - print: ["Category name: %s", category.name]
-          - print: ["Confidence: %s", category.confidence]
   - name: AnnotateText
-    flattening:
-      groups:
-      - parameters:
-        - document
-        - features
-        - encoding_type
-      - parameters:
-        - document
-        - features
-    required_fields:
-    - document
-    - features
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/language/v1/language_grpc_service_config.json b/third_party/googleapis/google/cloud/language/v1/language_grpc_service_config.json
new file mode 100755
index 000000000..83786e8f0
--- /dev/null
+++ b/third_party/googleapis/google/cloud/language/v1/language_grpc_service_config.json
@@ -0,0 +1,42 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.language.v1.LanguageService",
+          "method": "AnalyzeSentiment"
+        },
+        {
+          "service": "google.cloud.language.v1.LanguageService",
+          "method": "AnalyzeEntities"
+        },
+        {
+          "service": "google.cloud.language.v1.LanguageService",
+          "method": "AnalyzeEntitySentiment"
+        },
+        {
+          "service": "google.cloud.language.v1.LanguageService",
+          "method": "AnalyzeSyntax"
+        },
+        {
+          "service": "google.cloud.language.v1.LanguageService",
+          "method": "ClassifyText"
+        },
+        {
+          "service": "google.cloud.language.v1.LanguageService",
+          "method": "AnnotateText"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/third_party/googleapis/google/cloud/language/v1/language_service.proto b/third_party/googleapis/google/cloud/language/v1/language_service.proto
index 41d92f344..e8e4fd8d0 100644
--- a/third_party/googleapis/google/cloud/language/v1/language_service.proto
+++ b/third_party/googleapis/google/cloud/language/v1/language_service.proto
@@ -137,11 +137,11 @@ message Document {
   // The language of the document (if not specified, the language is
   // automatically detected). Both ISO and BCP-47 language codes are
   // accepted.

-  // [Language Support](/natural-language/docs/languages)
-  // lists currently supported languages for each API method.
-  // If the language (either specified by the caller or automatically detected)
-  // is not supported by the called API method, an `INVALID_ARGUMENT` error
-  // is returned.
+  // [Language
+  // Support](https://cloud.google.com/natural-language/docs/languages) lists
+  // currently supported languages for each API method. If the language (either
+  // specified by the caller or automatically detected) is not supported by the
+  // called API method, an `INVALID_ARGUMENT` error is returned.
   string language = 4;
 }
 
@@ -954,7 +954,7 @@ message TextSpan {
 // Represents a category returned from the text classifier.
 message ClassificationCategory {
   // The name of the category representing the document, from the [predefined
-  // taxonomy](/natural-language/docs/categories).
+  // taxonomy](https://cloud.google.com/natural-language/docs/categories).
   string name = 1;
 
   // The classifier's confidence of the category. Number represents how certain
diff --git a/third_party/googleapis/google/cloud/language/v1/samples/language_classify_gcs.yaml b/third_party/googleapis/google/cloud/language/v1/samples/language_classify_gcs.yaml
new file mode 100644
index 000000000..a542d8485
--- /dev/null
+++ b/third_party/googleapis/google/cloud/language/v1/samples/language_classify_gcs.yaml
@@ -0,0 +1,42 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
+samples:
+- region_tag: language_classify_gcs
+  title: Classify Content (GCS)
+  description: Classifying Content in text file stored in Cloud Storage
+  service: google.cloud.language.v1.LanguageService
+  rpc: ClassifyText
+  request:
+  - field: document.gcs_content_uri
+    value: gs://cloud-samples-data/language/classify-entertainment.txt
+    comment: |
+      Google Cloud Storage URI where the file content is located.
+      e.g. gs://[Your Bucket]/[Path to File]
+      The text file must include at least 20 words.
+    input_parameter: gcs_content_uri
+  - field: document.type
+    value: PLAIN_TEXT
+    comment: "Available types: PLAIN_TEXT, HTML"
+  - field: document.language
+    value: en
+    comment: |
+      Optional. If not specified, the language is automatically detected.
+      For list of supported languages:
+        https://cloud.google.com/natural-language/docs/languages
+  response:
+  - comment: ["Loop through classified categories returned from the API"]
+  - loop:
+      collection: $resp.categories
+      variable: category
+      body:
+      - comment:
+        - |
+            Get the name of the category representing the document.
+            See the predefined taxonomy of categories:
+            https://cloud.google.com/natural-language/docs/categories
+      - print: ["Category name: %s", category.name]
+      - comment:
+        - |
+            Get the confidence. Number representing how certain the classifier
+            is that this category represents the provided text.
+      - print: ["Confidence: %s", category.confidence]
diff --git a/third_party/googleapis/google/cloud/language/v1/samples/language_classify_text.yaml b/third_party/googleapis/google/cloud/language/v1/samples/language_classify_text.yaml
new file mode 100644
index 000000000..e53e85585
--- /dev/null
+++ b/third_party/googleapis/google/cloud/language/v1/samples/language_classify_text.yaml
@@ -0,0 +1,39 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
+samples:
+- region_tag: language_classify_text
+  title: Classify Content
+  description: Classifying Content in a String
+  service: google.cloud.language.v1.LanguageService
+  rpc: ClassifyText
+  request:
+  - field: document.content
+    value: "That actor on TV makes movies in Hollywood and also stars in a variety of popular new TV shows."
+    comment: The text content to analyze. Must include at least 20 words.
+    input_parameter: text_content
+  - field: document.type
+    value: PLAIN_TEXT
+    comment: "Available types: PLAIN_TEXT, HTML"
+  - field: document.language
+    value: en
+    comment: |
+      Optional. If not specified, the language is automatically detected.
+      For list of supported languages:
+        https://cloud.google.com/natural-language/docs/languages
+  response:
+  - comment: ["Loop through classified categories returned from the API"]
+  - loop:
+      collection: $resp.categories
+      variable: category
+      body:
+      - comment:
+        - |
+            Get the name of the category representing the document.
+            See the predefined taxonomy of categories:
+            https://cloud.google.com/natural-language/docs/categories
+      - print: ["Category name: %s", category.name]
+      - comment:
+        - |
+            Get the confidence. Number representing how certain the classifier
+            is that this category represents the provided text.
+      - print: ["Confidence: %s", category.confidence]
diff --git a/third_party/googleapis/google/cloud/language/v1/samples/language_entities_gcs.yaml b/third_party/googleapis/google/cloud/language/v1/samples/language_entities_gcs.yaml
new file mode 100644
index 000000000..b914c3bd5
--- /dev/null
+++ b/third_party/googleapis/google/cloud/language/v1/samples/language_entities_gcs.yaml
@@ -0,0 +1,67 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
+samples:
+- region_tag: language_entities_gcs
+  title: Analyzing Entities (GCS)
+  description: Analyzing Entities in text file stored in Cloud Storage
+  service: google.cloud.language.v1.LanguageService
+  rpc: AnalyzeEntities
+  request:
+  - field: document.gcs_content_uri
+    value: gs://cloud-samples-data/language/entity.txt
+    comment: |
+      Google Cloud Storage URI where the file content is located.
+      e.g. gs://[Your Bucket]/[Path to File]
+    input_parameter: gcs_content_uri
+  - field: document.type
+    value: PLAIN_TEXT
+    comment: "Available types: PLAIN_TEXT, HTML"
+  - field: document.language
+    value: en
+    comment: |
+      Optional. If not specified, the language is automatically detected.
+      For list of supported languages:
+        https://cloud.google.com/natural-language/docs/languages
+  - field: encoding_type
+    value: UTF8
+    comment: "Available values: NONE, UTF8, UTF16, UTF32"
+  response:
+  - comment: ["Loop through entitites returned from the API"]
+  - loop:
+      collection: $resp.entities
+      variable: entity
+      body:
+      - print: ["Representative name for the entity: %s", entity.name]
+      - comment: ["Get entity type, e.g. PERSON, LOCATION, ADDRESS, NUMBER, et al"]
+      - print: ["Entity type: %s", entity.type]
+      - comment: ["Get the salience score associated with the entity in the [0, 1.0] range"]
+      - print: ["Salience score: %s", entity.salience]
+      - comment:
+        - |
+            Loop over the metadata associated with entity. For many known entities,
+            the metadata is a Wikipedia URL (wikipedia_url) and Knowledge Graph MID (mid).
+            Some entity types may have additional metadata, e.g. ADDRESS entities
+            may have metadata for the address street_name, postal_code, et al.
+      - loop:
+          map: entity.metadata
+          key: metadata_name
+          value: metadata_value
+          body:
+          - print: ["%s: %s", metadata_name, metadata_value]
+      - comment:
+        - |
+            Loop over the mentions of this entity in the input document.
+            The API currently supports proper noun mentions.
+      - loop:
+          collection: entity.mentions
+          variable: mention
+          body:
+          - print: ["Mention text: %s", mention.text.content]
+          - comment: ["Get the mention type, e.g. PROPER for proper noun"]
+          - print: ["Mention type: %s", mention.type]
+  - comment:
+    - |
+        Get the language of the text, which will be the same as
+        the language specified in the request or, if not specified,
+        the automatically-detected language.
+  - print: ["Language of the text: %s", $resp.language]
diff --git a/third_party/googleapis/google/cloud/language/v1/samples/language_entities_text.yaml b/third_party/googleapis/google/cloud/language/v1/samples/language_entities_text.yaml
new file mode 100644
index 000000000..ad39c42c5
--- /dev/null
+++ b/third_party/googleapis/google/cloud/language/v1/samples/language_entities_text.yaml
@@ -0,0 +1,65 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
+samples:
+- region_tag: language_entities_text
+  title: Analyzing Entities
+  description: Analyzing Entities in a String
+  service: google.cloud.language.v1.LanguageService
+  rpc: AnalyzeEntities
+  request:
+  - field: document.content
+    value: "California is a state."
+    comment: The text content to analyze
+    input_parameter: text_content
+  - field: document.type
+    value: PLAIN_TEXT
+    comment: "Available types: PLAIN_TEXT, HTML"
+  - field: document.language
+    value: en
+    comment: |
+      Optional. If not specified, the language is automatically detected.
+      For list of supported languages:
+        https://cloud.google.com/natural-language/docs/languages
+  - field: encoding_type
+    value: UTF8
+    comment: "Available values: NONE, UTF8, UTF16, UTF32"
+  response:
+  - comment: ["Loop through entitites returned from the API"]
+  - loop:
+      collection: $resp.entities
+      variable: entity
+      body:
+      - print: ["Representative name for the entity: %s", entity.name]
+      - comment: ["Get entity type, e.g. PERSON, LOCATION, ADDRESS, NUMBER, et al"]
+      - print: ["Entity type: %s", entity.type]
+      - comment: ["Get the salience score associated with the entity in the [0, 1.0] range"]
+      - print: ["Salience score: %s", entity.salience]
+      - comment:
+        - |
+            Loop over the metadata associated with entity. For many known entities,
+            the metadata is a Wikipedia URL (wikipedia_url) and Knowledge Graph MID (mid).
+            Some entity types may have additional metadata, e.g. ADDRESS entities
+            may have metadata for the address street_name, postal_code, et al.
+      - loop:
+          map: entity.metadata
+          key: metadata_name
+          value: metadata_value
+          body:
+          - print: ["%s: %s", metadata_name, metadata_value]
+      - comment:
+        - |
+            Loop over the mentions of this entity in the input document.
+            The API currently supports proper noun mentions.
+      - loop:
+          collection: entity.mentions
+          variable: mention
+          body:
+          - print: ["Mention text: %s", mention.text.content]
+          - comment: ["Get the mention type, e.g. PROPER for proper noun"]
+          - print: ["Mention type: %s", mention.type]
+  - comment:
+    - |
+        Get the language of the text, which will be the same as
+        the language specified in the request or, if not specified,
+        the automatically-detected language.
+  - print: ["Language of the text: %s", $resp.language]
diff --git a/third_party/googleapis/google/cloud/language/v1/samples/language_entity_sentiment_gcs.yaml b/third_party/googleapis/google/cloud/language/v1/samples/language_entity_sentiment_gcs.yaml
new file mode 100644
index 000000000..358a1d515
--- /dev/null
+++ b/third_party/googleapis/google/cloud/language/v1/samples/language_entity_sentiment_gcs.yaml
@@ -0,0 +1,71 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
+samples:
+- region_tag: language_entity_sentiment_gcs
+  title: Analyzing Entity Sentiment (GCS)
+  description: Analyzing Entity Sentiment in text file stored in Cloud Storage
+  service: google.cloud.language.v1.LanguageService
+  rpc: AnalyzeEntitySentiment
+  request:
+  - field: document.gcs_content_uri
+    value: gs://cloud-samples-data/language/entity-sentiment.txt
+    comment: |
+      Google Cloud Storage URI where the file content is located.
+      e.g. gs://[Your Bucket]/[Path to File]
+    input_parameter: gcs_content_uri
+  - field: document.type
+    value: PLAIN_TEXT
+    comment: "Available types: PLAIN_TEXT, HTML"
+  - field: document.language
+    value: en
+    comment: |
+      Optional. If not specified, the language is automatically detected.
+      For list of supported languages:
+        https://cloud.google.com/natural-language/docs/languages
+  - field: encoding_type
+    value: UTF8
+    comment: "Available values: NONE, UTF8, UTF16, UTF32"
+  response:
+  - comment: Loop through entitites returned from the API
+  - loop:
+      collection: $resp.entities
+      variable: entity
+      body:
+      - print: ["Representative name for the entity: %s", entity.name]
+      - comment: ["Get entity type, e.g. PERSON, LOCATION, ADDRESS, NUMBER, et al"]
+      - print: ["Entity type: %s", entity.type]
+      - comment: ["Get the salience score associated with the entity in the [0, 1.0] range"]
+      - print: ["Salience score: %s", entity.salience]
+      - comment: ["Get the aggregate sentiment expressed for this entity in the provided document."]
+      - define: sentiment = entity.sentiment
+      - print: ["Entity sentiment score: %s", sentiment.score]
+      - print: ["Entity sentiment magnitude: %s", sentiment.magnitude]
+      - comment:
+        - |
+            Loop over the metadata associated with entity. For many known entities,
+            the metadata is a Wikipedia URL (wikipedia_url) and Knowledge Graph MID (mid).
+            Some entity types may have additional metadata, e.g. ADDRESS entities
+            may have metadata for the address street_name, postal_code, et al.
+      - loop:
+          map: entity.metadata
+          key: metadata_name
+          value: metadata_value
+          body:
+          - print: ["%s = %s", metadata_name, metadata_value]
+      - comment:
+        - |
+            Loop over the mentions of this entity in the input document.
+            The API currently supports proper noun mentions.
+      - loop:
+          collection: entity.mentions
+          variable: mention
+          body:
+          - print: ["Mention text: %s", mention.text.content]
+          - comment: ["Get the mention type, e.g. PROPER for proper noun"]
+          - print: ["Mention type: %s", mention.type]
+  - comment:
+    - |
+        Get the language of the text, which will be the same as
+        the language specified in the request or, if not specified,
+        the automatically-detected language.
+  - print: ["Language of the text: %s", $resp.language]
diff --git a/third_party/googleapis/google/cloud/language/v1/samples/language_entity_sentiment_text.yaml b/third_party/googleapis/google/cloud/language/v1/samples/language_entity_sentiment_text.yaml
new file mode 100644
index 000000000..25b344f6a
--- /dev/null
+++ b/third_party/googleapis/google/cloud/language/v1/samples/language_entity_sentiment_text.yaml
@@ -0,0 +1,69 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
+samples:
+- region_tag: language_entity_sentiment_text
+  title: Analyzing Entity Sentiment
+  description: Analyzing Entity Sentiment in a String
+  service: google.cloud.language.v1.LanguageService
+  rpc: AnalyzeEntitySentiment
+  request:
+  - field: document.content
+    value: "Grapes are good. Bananas are bad."
+    comment: The text content to analyze
+    input_parameter: text_content
+  - field: document.type
+    value: PLAIN_TEXT
+    comment: "Available types: PLAIN_TEXT, HTML"
+  - field: document.language
+    value: en
+    comment: |
+      Optional. If not specified, the language is automatically detected.
+      For list of supported languages:
+        https://cloud.google.com/natural-language/docs/languages
+  - field: encoding_type
+    value: UTF8
+    comment: "Available values: NONE, UTF8, UTF16, UTF32"
+  response:
+  - comment: ["Loop through entitites returned from the API"]
+  - loop:
+      collection: $resp.entities
+      variable: entity
+      body:
+      - print: ["Representative name for the entity: %s", entity.name]
+      - comment: ["Get entity type, e.g. PERSON, LOCATION, ADDRESS, NUMBER, et al"]
+      - print: ["Entity type: %s", entity.type]
+      - comment: ["Get the salience score associated with the entity in the [0, 1.0] range"]
+      - print: ["Salience score: %s", entity.salience]
+      - comment: ["Get the aggregate sentiment expressed for this entity in the provided document."]
+      - define: sentiment = entity.sentiment
+      - print: ["Entity sentiment score: %s", sentiment.score]
+      - print: ["Entity sentiment magnitude: %s", sentiment.magnitude]
+      - comment:
+        - |
+            Loop over the metadata associated with entity. For many known entities,
+            the metadata is a Wikipedia URL (wikipedia_url) and Knowledge Graph MID (mid).
+            Some entity types may have additional metadata, e.g. ADDRESS entities
+            may have metadata for the address street_name, postal_code, et al.
+      - loop:
+          map: entity.metadata
+          key: metadata_name
+          value: metadata_value
+          body:
+          - print: ["%s = %s", metadata_name, metadata_value]
+      - comment:
+        - |
+            Loop over the mentions of this entity in the input document.
+            The API currently supports proper noun mentions.
+      - loop:
+          collection: entity.mentions
+          variable: mention
+          body:
+          - print: ["Mention text: %s", mention.text.content]
+          - comment: ["Get the mention type, e.g. PROPER for proper noun"]
+          - print: ["Mention type: %s", mention.type]
+  - comment:
+    - |
+        Get the language of the text, which will be the same as
+        the language specified in the request or, if not specified,
+        the automatically-detected language.
+  - print: ["Language of the text: %s", $resp.language]
diff --git a/third_party/googleapis/google/cloud/language/v1/samples/language_sentiment_gcs.yaml b/third_party/googleapis/google/cloud/language/v1/samples/language_sentiment_gcs.yaml
new file mode 100644
index 000000000..ad85c30aa
--- /dev/null
+++ b/third_party/googleapis/google/cloud/language/v1/samples/language_sentiment_gcs.yaml
@@ -0,0 +1,45 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
+samples:
+- region_tag: language_sentiment_gcs
+  title: Analyzing Sentiment (GCS)
+  description: Analyzing Sentiment in text file stored in Cloud Storage
+  service: google.cloud.language.v1.LanguageService
+  rpc: AnalyzeSentiment
+  request:
+  - field: document.gcs_content_uri
+    value: gs://cloud-samples-data/language/sentiment-positive.txt
+    comment: |
+      Google Cloud Storage URI where the file content is located.
+      e.g. gs://[Your Bucket]/[Path to File]
+    input_parameter: gcs_content_uri
+  - field: document.type
+    value: PLAIN_TEXT
+    comment: "Available types: PLAIN_TEXT, HTML"
+  - field: document.language
+    value: en
+    comment: |
+      Optional. If not specified, the language is automatically detected.
+      For list of supported languages:
+        https://cloud.google.com/natural-language/docs/languages
+  - field: encoding_type
+    value: UTF8
+    comment: "Available values: NONE, UTF8, UTF16, UTF32"
+  response:
+  - comment: ["Get overall sentiment of the input document"]
+  - print: ["Document sentiment score: %s", $resp.document_sentiment.score]
+  - print: ["Document sentiment magnitude: %s", $resp.document_sentiment.magnitude]
+  - comment: ["Get sentiment for all sentences in the document"]
+  - loop:
+      collection: $resp.sentences
+      variable: sentence
+      body:
+      - print: ["Sentence text: %s", sentence.text.content]
+      - print: ["Sentence sentiment score: %s", sentence.sentiment.score]
+      - print: ["Sentence sentiment magnitude: %s", sentence.sentiment.magnitude]
+  - comment:
+    - |
+        Get the language of the text, which will be the same as
+        the language specified in the request or, if not specified,
+        the automatically-detected language.
+  - print: ["Language of the text: %s", $resp.language]
diff --git a/third_party/googleapis/google/cloud/language/v1/samples/language_sentiment_text.yaml b/third_party/googleapis/google/cloud/language/v1/samples/language_sentiment_text.yaml
new file mode 100644
index 000000000..08d1114ec
--- /dev/null
+++ b/third_party/googleapis/google/cloud/language/v1/samples/language_sentiment_text.yaml
@@ -0,0 +1,43 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
+samples:
+- region_tag: language_sentiment_text
+  title: Analyzing Sentiment
+  description: Analyzing Sentiment in a String
+  service: google.cloud.language.v1.LanguageService
+  rpc: AnalyzeSentiment
+  request:
+  - field: document.content
+    value: "I am so happy and joyful."
+    comment: The text content to analyze
+    input_parameter: text_content
+  - field: document.type
+    value: PLAIN_TEXT
+    comment: "Available types: PLAIN_TEXT, HTML"
+  - field: document.language
+    value: en
+    comment: |
+      Optional. If not specified, the language is automatically detected.
+      For list of supported languages:
+        https://cloud.google.com/natural-language/docs/languages
+  - field: encoding_type
+    value: UTF8
+    comment: "Available values: NONE, UTF8, UTF16, UTF32"
+  response:
+  - comment: ["Get overall sentiment of the input document"]
+  - print: ["Document sentiment score: %s", $resp.document_sentiment.score]
+  - print: ["Document sentiment magnitude: %s", $resp.document_sentiment.magnitude]
+  - comment: ["Get sentiment for all sentences in the document"]
+  - loop:
+      collection: $resp.sentences
+      variable: sentence
+      body:
+      - print: ["Sentence text: %s", sentence.text.content]
+      - print: ["Sentence sentiment score: %s", sentence.sentiment.score]
+      - print: ["Sentence sentiment magnitude: %s", sentence.sentiment.magnitude]
+  - comment:
+    - |
+        Get the language of the text, which will be the same as
+        the language specified in the request or, if not specified,
+        the automatically-detected language.
+  - print: ["Language of the text: %s", $resp.language]
diff --git a/third_party/googleapis/google/cloud/language/v1/samples/language_syntax_gcs.yaml b/third_party/googleapis/google/cloud/language/v1/samples/language_syntax_gcs.yaml
new file mode 100644
index 000000000..58ae881ad
--- /dev/null
+++ b/third_party/googleapis/google/cloud/language/v1/samples/language_syntax_gcs.yaml
@@ -0,0 +1,69 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
+samples:
+- region_tag: language_syntax_gcs
+  title: Analyzing Syntax (GCS)
+  description: Analyzing Syntax in text file stored in Cloud Storage
+  service: google.cloud.language.v1.LanguageService
+  rpc: AnalyzeSyntax
+  request:
+  - field: document.gcs_content_uri
+    value: gs://cloud-samples-data/language/syntax-sentence.txt
+    comment: |
+      Google Cloud Storage URI where the file content is located.
+      e.g. gs://[Your Bucket]/[Path to File]
+    input_parameter: gcs_content_uri
+  - field: document.type
+    value: PLAIN_TEXT
+    comment: "Available types: PLAIN_TEXT, HTML"
+  - field: document.language
+    value: en
+    comment: |
+      Optional. If not specified, the language is automatically detected.
+      For list of supported languages:
+        https://cloud.google.com/natural-language/docs/languages
+  - field: encoding_type
+    value: UTF8
+    comment: "Available values: NONE, UTF8, UTF16, UTF32"
+  response:
+  - comment: ["Loop through tokens returned from the API"]
+  - loop:
+      collection: $resp.tokens
+      variable: token
+      body:
+      - comment: ["Get the text content of this token. Usually a word or punctuation."]
+      - define: text = token.text
+      - print: ["Token text: %s", text.content]
+      - print: ["Location of this token in overall document: %s", text.begin_offset]
+      - comment:
+        - |
+            Get the part of speech information for this token.
+            Parts of spech are as defined in:
+            http://www.lrec-conf.org/proceedings/lrec2012/pdf/274_Paper.pdf
+      - define: part_of_speech = token.part_of_speech
+      - comment: ["Get the tag, e.g. NOUN, ADJ for Adjective, et al."]
+      - print: ["Part of Speech tag: %s", part_of_speech.tag]
+      - comment: ["Get the voice, e.g. ACTIVE or PASSIVE"]
+      - print: ["Voice: %s", part_of_speech.voice]
+      - comment: ["Get the tense, e.g. PAST, FUTURE, PRESENT, et al."]
+      - print: ["Tense: %s", part_of_speech.tense]
+      - comment: ["See API reference for additional Part of Speech information available"]
+      - comment:
+        - |
+            Get the lemma of the token. Wikipedia lemma description
+            https://en.wikipedia.org/wiki/Lemma_(morphology)
+      - print: ["Lemma: %s", token.lemma]
+      - comment:
+        - |
+            Get the dependency tree parse information for this token.
+            For more information on dependency labels:
+            http://www.aclweb.org/anthology/P13-2017
+      - define: dependency_edge = token.dependency_edge
+      - print: ["Head token index: %s", dependency_edge.head_token_index]
+      - print: ["Label: %s", dependency_edge.label]
+  - comment:
+    - |
+        Get the language of the text, which will be the same as
+        the language specified in the request or, if not specified,
+        the automatically-detected language.
+  - print: ["Language of the text: %s", $resp.language]
diff --git a/third_party/googleapis/google/cloud/language/v1/samples/language_syntax_text.yaml b/third_party/googleapis/google/cloud/language/v1/samples/language_syntax_text.yaml
new file mode 100644
index 000000000..0e7de5bcd
--- /dev/null
+++ b/third_party/googleapis/google/cloud/language/v1/samples/language_syntax_text.yaml
@@ -0,0 +1,67 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
+samples:
+- region_tag: language_syntax_text
+  title: Analyzing Syntax
+  description: Analyzing Syntax in a String
+  service: google.cloud.language.v1.LanguageService
+  rpc: AnalyzeSyntax
+  request:
+  - field: document.content
+    value: "This is a short sentence."
+    comment: The text content to analyze
+    input_parameter: text_content
+  - field: document.type
+    value: PLAIN_TEXT
+    comment: "Available types: PLAIN_TEXT, HTML"
+  - field: document.language
+    value: en
+    comment: |
+      Optional. If not specified, the language is automatically detected.
+      For list of supported languages:
+        https://cloud.google.com/natural-language/docs/languages
+  - field: encoding_type
+    value: UTF8
+    comment: "Available values: NONE, UTF8, UTF16, UTF32"
+  response:
+  - comment: ["Loop through tokens returned from the API"]
+  - loop:
+      collection: $resp.tokens
+      variable: token
+      body:
+      - comment: ["Get the text content of this token. Usually a word or punctuation."]
+      - define: text = token.text
+      - print: ["Token text: %s", text.content]
+      - print: ["Location of this token in overall document: %s", text.begin_offset]
+      - comment:
+        - |
+            Get the part of speech information for this token.
+            Parts of spech are as defined in:
+            http://www.lrec-conf.org/proceedings/lrec2012/pdf/274_Paper.pdf
+      - define: part_of_speech = token.part_of_speech
+      - comment: ["Get the tag, e.g. NOUN, ADJ for Adjective, et al."]
+      - print: ["Part of Speech tag: %s", part_of_speech.tag]
+      - comment: ["Get the voice, e.g. ACTIVE or PASSIVE"]
+      - print: ["Voice: %s", part_of_speech.voice]
+      - comment: ["Get the tense, e.g. PAST, FUTURE, PRESENT, et al."]
+      - print: ["Tense: %s", part_of_speech.tense]
+      - comment: ["See API reference for additional Part of Speech information available"]
+      - comment:
+        - |
+            Get the lemma of the token. Wikipedia lemma description
+            https://en.wikipedia.org/wiki/Lemma_(morphology)
+      - print: ["Lemma: %s", token.lemma]
+      - comment:
+        - |
+            Get the dependency tree parse information for this token.
+            For more information on dependency labels:
+            http://www.aclweb.org/anthology/P13-2017
+      - define: dependency_edge = token.dependency_edge
+      - print: ["Head token index: %s", dependency_edge.head_token_index]
+      - print: ["Label: %s", dependency_edge.label]
+  - comment:
+    - |
+        Get the language of the text, which will be the same as
+        the language specified in the request or, if not specified,
+        the automatically-detected language.
+  - print: ["Language of the text: %s", $resp.language]
diff --git a/third_party/googleapis/google/cloud/language/v1/samples/test/analyzing_entities.test.yaml b/third_party/googleapis/google/cloud/language/v1/samples/test/analyzing_entities.test.yaml
new file mode 100644
index 000000000..5fafd01ea
--- /dev/null
+++ b/third_party/googleapis/google/cloud/language/v1/samples/test/analyzing_entities.test.yaml
@@ -0,0 +1,101 @@
+type: test/samples
+schema_version: 1
+test:
+  suites:
+  - name: "Analyzing Entities [code sample tests]"
+    cases:
+
+    - name: language_entities_text - Analyzing the Entities of a text string (default value)
+      spec:
+      # Default value: "California is a state."
+      - call: {sample: language_entities_text}
+      - assert_contains:
+        - {literal: "Representative name for the entity: California"}
+        - {literal: "Entity type: LOCATION"}
+        - {literal: "Salience score:"}
+        - {literal: "wikipedia_url: https://en.wikipedia.org/wiki/California"}
+        - {literal: "mid: /m/01n7q"}
+        - {literal: "Mention text: California"}
+        - {literal: "Mention type: PROPER"}
+        - {literal: "Mention text: state"}
+        - {literal: "Mention type: COMMON"}
+        - {literal: "Language of the text: en"}
+
+    - name: language_entities_text - Analyzing the Entities of a text string (*custom value*)
+      spec:
+      # Custom value: "Alice is a person. She lives in California."
+      - call:
+          sample: language_entities_text
+          params:
+            text_content: {literal: "Alice is a person. She lives in California."}
+      - assert_contains:
+        - {literal: "Representative name for the entity: Alice"}
+        - {literal: "Entity type: PERSON"}
+        - {literal: "Mention text: Alice"}
+        - {literal: "Mention type: PROPER"}
+        - {literal: "Mention text: person"}
+        - {literal: "Mention type: COMMON"}
+        - {literal: "Representative name for the entity: California"}
+        - {literal: "Entity type: LOCATION"}
+        - {literal: "wikipedia_url: https://en.wikipedia.org/wiki/California"}
+        - {literal: "mid: /m/01n7q"}
+        - {literal: "Language of the text: en"}
+
+    - name: language_entities_text - Analyzing the Entities of a text string (*metadata attributes*)
+      spec:
+      # Try out some of the metadata attributes which should be available for dates, addresses, etc.
+      # In case fake (555) area code numbers don't work, using United States Naval Observatory number.
+      # Custom value: "I called 202-762-1401 on January 31, 2019 from 1600 Amphitheatre Parkway, Mountain View, CA."
+      - call:
+          sample: language_entities_text
+          params:
+            text_content:
+              literal: "I called 202-762-1401 on January 31, 2019 from 1600 Amphitheatre Parkway, Mountain View, CA."
+      # The results may change, but it's fair to say that at least one of the following types were detected:
+      - assert_contains_any:
+        - literal: "Entity type: DATE"
+        - literal: "Entity type: ADDRESS"
+        - literal: "Entity type: PHONE_NUMBER"
+      # Check that at least some of the supporting metadata for an entity was present in the response
+      - assert_contains_any:
+        - literal: "month: 1"
+        - literal: "day: 31"
+        - literal: "year: 2019"
+        - literal: "street_number: 1600"
+        - literal: "street_name: Amphitheatre Parkway"
+        - literal: "area_code: 202"
+        - literal: "number: 7621401"
+
+    - name: language_entities_gcs - Analyzing the Entities of text file in GCS (default value)
+      spec:
+      # Default value: gs://cloud-samples-data/language/entity.txt
+      # => "California is a state."
+      - call: {sample: language_entities_gcs}
+      - assert_contains:
+        - {literal: "Representative name for the entity: California"}
+        - {literal: "Entity type: LOCATION"}
+        - {literal: "Salience score:"}
+        - {literal: "wikipedia_url: https://en.wikipedia.org/wiki/California"}
+        - {literal: "mid: /m/01n7q"}
+        - {literal: "Mention text: California"}
+        - {literal: "Mention type: PROPER"}
+        - {literal: "Mention text: state"}
+        - {literal: "Mention type: COMMON"}
+        - {literal: "Language of the text: en"}
+
+    - name: language_entities_gcs - Analyzing the Entities of text file in GCS (*custom value*)
+      spec:
+      # Use different file: gs://cloud-samples-data/language/entity-sentiment.txt
+      # => "Grapes are good. Bananas are bad."
+      - call:
+          sample: language_entities_gcs
+          params:
+            gcs_content_uri:
+              literal: "gs://cloud-samples-data/language/entity-sentiment.txt"
+      - assert_contains:
+        - {literal: "Representative name for the entity: Grapes"}
+        - {literal: "Mention text: Grapes"}
+        - {literal: "Mention type: COMMON"}
+        - {literal: "Representative name for the entity: Bananas"}
+        - {literal: "Mention text: Bananas"}
+        - {literal: "Language of the text: en"}
diff --git a/third_party/googleapis/google/cloud/language/v1/samples/test/analyzing_entity_sentiment.test.yaml b/third_party/googleapis/google/cloud/language/v1/samples/test/analyzing_entity_sentiment.test.yaml
new file mode 100644
index 000000000..beb8fb4a8
--- /dev/null
+++ b/third_party/googleapis/google/cloud/language/v1/samples/test/analyzing_entity_sentiment.test.yaml
@@ -0,0 +1,63 @@
+type: test/samples
+schema_version: 1
+test:
+  suites:
+  - name: "Analyzing Entity Sentiment [code sample tests]"
+    cases:
+
+    - name: language_entity_sentiment_text - Analyzing Entity Sentiment of a text string (default value)
+      spec:
+      # Default value: "Grapes are good. Bananas are bad."
+      - call: {sample: language_entity_sentiment_text}
+      - assert_contains:
+        - {literal: "Representative name for the entity: Grapes"}
+        - {literal: "Entity sentiment score: 0."}
+        - {literal: "Representative name for the entity: Bananas"}
+        - {literal: "Entity sentiment score: -0."}
+        - {literal: "Entity sentiment magnitude: 0."}
+        - {literal: "Language of the text: en"}
+
+    - name: language_entity_sentiment_text - Analyzing Entity Sentiment of a text string (*custom value*)
+      spec:
+      # Custom value: "Grapes are actually not very good. But Bananas are great."
+      - call:
+          sample: language_entity_sentiment_text
+          params:
+            text_content: {literal: "Grapes are actually not very good. But Bananas are great."}
+      - assert_contains:
+        - {literal: "Representative name for the entity: Grapes"}
+        - {literal: "Entity sentiment score: -0."}
+        - {literal: "Representative name for the entity: Bananas"}
+        - {literal: "Entity sentiment score: 0."}
+        - {literal: "Entity sentiment magnitude: 0."}
+        - {literal: "Language of the text: en"}
+
+    - name: language_entity_sentiment_gcs - Analyzing Entity Sentiment of text file in GCS (default value)
+      spec:
+      # Default value: gs://cloud-samples-data/language/entity-sentiment.txt
+      # => "Grapes are good. Bananas are bad."
+      - call: {sample: language_entity_sentiment_gcs}
+      - assert_contains:
+        - {literal: "Representative name for the entity: Grapes"}
+        - {literal: "Entity sentiment score: -0."}
+        - {literal: "Representative name for the entity: Bananas"}
+        - {literal: "Entity sentiment score: 0."}
+        - {literal: "Entity sentiment magnitude: 0."}
+        - {literal: "Language of the text: en"}
+
+    - name: language_entity_sentiment_gcs - Analyzing Entity Sentiment of text file in GCS (*custom value*)
+      spec:
+      # Use different file: gs://cloud-samples-data/language/entity-sentiment-reverse.txt
+      # => "Grapes are actually not very good. But Bananas are great."
+      - call:
+          sample: language_entity_sentiment_gcs
+          params:
+            gcs_content_uri:
+              literal: "gs://cloud-samples-data/language/entity-sentiment-reverse.txt"
+      - assert_contains:
+        - {literal: "Representative name for the entity: Grapes"}
+        - {literal: "Entity sentiment score: -0."}
+        - {literal: "Representative name for the entity: Bananas"}
+        - {literal: "Entity sentiment score: 0."}
+        - {literal: "Entity sentiment magnitude: 0."}
+        - {literal: "Language of the text: en"}
diff --git a/third_party/googleapis/google/cloud/language/v1/samples/test/analyzing_sentiment.test.yaml b/third_party/googleapis/google/cloud/language/v1/samples/test/analyzing_sentiment.test.yaml
new file mode 100644
index 000000000..55b5fdcb2
--- /dev/null
+++ b/third_party/googleapis/google/cloud/language/v1/samples/test/analyzing_sentiment.test.yaml
@@ -0,0 +1,74 @@
+type: test/samples
+schema_version: 1
+test:
+  suites:
+  - name: "Analyzing Sentiment [code sample tests]"
+    cases:
+
+    - name: language_sentiment_text - Analyzing the sentiment of a text string (default value)
+      spec:
+      # Default value: "I am so happy and joyful."
+      - call: {sample: language_sentiment_text}
+      - assert_contains:
+        - {literal: "Document sentiment score: 0."}
+        - {literal: "Document sentiment magnitude: 0."}
+        - {literal: "Sentence text: I am so happy and joyful."}
+        - {literal: "Sentence sentiment score: 0."}
+        - {literal: "Sentence sentiment magnitude: 0."}
+        - {literal: "Language of the text: en"}
+      # There should be no negative sentiment scores for this value.
+      - assert_not_contains:
+        - {literal: "Document sentiment score: -0."}
+        - {literal: "Sentence sentiment score: -0."}
+
+    - name: language_sentiment_text - Analyzing the sentiment of a text string (*custom value*)
+      spec:
+      # Custom value: "I am very happy. I am angry and sad."
+      - call:
+          sample: language_sentiment_text
+          params:
+            text_content: {literal: "I am very happy. I am angry and sad."}
+      - assert_contains:
+        - {literal: "Sentence text: I am very happy"}
+        - {literal: "Sentence sentiment score: 0."}
+        - {literal: "Sentence text: I am angry and sad"}
+        - {literal: "Sentence sentiment score: -0."}
+        - {literal: "Language of the text: en"}
+
+    - name: language_sentiment_gcs - Analyzing the sentiment of text file in GCS (default value)
+      spec:
+      # Default value: gs://cloud-samples-data/language/sentiment-positive.txt
+      # => "I am so happy and joyful."
+      - call: {sample: language_sentiment_gcs}
+      - assert_contains:
+        - {literal: "Document sentiment score: 0."}
+        - {literal: "Document sentiment magnitude: 0."}
+        - {literal: "Sentence text: I am so happy and joyful."}
+        - {literal: "Sentence sentiment score: 0."}
+        - {literal: "Sentence sentiment magnitude: 0."}
+        - {literal: "Language of the text: en"}
+      # There should be no negative sentiment scores for this value.
+      - assert_not_contains:
+        - {literal: "Document sentiment score: -0."}
+        - {literal: "Sentence sentiment score: -0."}
+
+    - name: language_sentiment_gcs - Analyzing the sentiment of text file in GCS (*custom value*)
+      spec:
+      # Use different file: gs://cloud-samples-data/language/sentiment-negative.txt
+      # => "I am so sad and upset."
+      - call:
+          sample: language_sentiment_gcs
+          params:
+            gcs_content_uri:
+              literal: "gs://cloud-samples-data/language/sentiment-negative.txt"
+      - assert_contains:
+        - {literal: "Document sentiment score: -0."}
+        - {literal: "Document sentiment magnitude: 0."}
+        - {literal: "Sentence text: I am so sad and upset."}
+        - {literal: "Sentence sentiment score: -0."}
+        - {literal: "Sentence sentiment magnitude: 0."}
+        - {literal: "Language of the text: en"}
+      # There should be no positive sentiment scores for this value.
+      - assert_not_contains:
+        - {literal: "Document sentiment score: 0."}
+        - {literal: "Sentence sentiment score: 0."}
diff --git a/third_party/googleapis/google/cloud/language/v1/samples/test/analyzing_syntax.test.yaml b/third_party/googleapis/google/cloud/language/v1/samples/test/analyzing_syntax.test.yaml
new file mode 100644
index 000000000..e89d465c1
--- /dev/null
+++ b/third_party/googleapis/google/cloud/language/v1/samples/test/analyzing_syntax.test.yaml
@@ -0,0 +1,72 @@
+type: test/samples
+schema_version: 1
+test:
+  suites:
+  - name: "Analyzing Syntax [code sample tests]"
+    cases:
+
+    - name: language_syntax_text - Analyzing the syntax of a text string (default value)
+      spec:
+      # Default value: "This is a short sentence."
+      - call: {sample: language_syntax_text}
+      - assert_contains:
+        - {literal: "Token text: is"}
+        - {literal: "Part of Speech tag: VERB"}
+        - {literal: "Tense: PRESENT"}
+        - {literal: "Lemma: be"}
+        - {literal: "Token text: short"}
+        - {literal: "Part of Speech tag: ADJ"}
+        - {literal: "Lemma: short"}
+        - {literal: "Language of the text: en"}
+
+    - name: language_syntax_text - Analyzing the syntax of a text string (*custom value*)
+      spec:
+      # Custom value: "Alice runs. Bob ran."
+      - call:
+          sample: language_syntax_text
+          params:
+            text_content: {literal: "Alice runs. Bob ran."}
+      - assert_contains:
+        - {literal: "Token text: Alice"}
+        - {literal: "Location of this token in overall document: 0"}
+        - {literal: "Part of Speech tag: NOUN"}
+        - {literal: "Label: NSUBJ"}
+        - {literal: "Token text: runs"}
+        - {literal: "Part of Speech tag: VERB"}
+        - {literal: "Tense: PRESENT"}
+        - {literal: "Lemma: run"}
+        - {literal: "Token text: ran"}
+        - {literal: "Tense: PAST"}
+        - {literal: "Language of the text: en"}
+
+    - name: language_syntax_gcs - Analyzing the syntax of text file in GCS (default value)
+      spec:
+      # Default value: gs://cloud-samples-data/language/syntax-sentence.txt
+      # => "This is a short sentence."
+      - call: {sample: language_syntax_gcs}
+      - assert_contains:
+        - {literal: "Token text: is"}
+        - {literal: "Part of Speech tag: VERB"}
+        - {literal: "Tense: PRESENT"}
+        - {literal: "Lemma: be"}
+        - {literal: "Token text: short"}
+        - {literal: "Part of Speech tag: ADJ"}
+        - {literal: "Lemma: short"}
+        - {literal: "Language of the text: en"}
+
+    - name: language_syntax_gcs - Analyzing the syntax of text file in GCS (*custom value*)
+      spec:
+      # Use different file: gs://cloud-samples-data/language/hello.txt
+      # => "Hello, world!"
+      - call:
+          sample: language_syntax_gcs
+          params:
+            gcs_content_uri:
+              literal: "gs://cloud-samples-data/language/hello.txt"
+      - assert_contains:
+        - {literal: "Token text: Hello"}
+        - {literal: "Token text: World"}
+        - {literal: "Part of Speech tag: NOUN"}
+        - {literal: "Token text: !"}
+        - {literal: "Part of Speech tag: PUNCT"}
+        - {literal: "Language of the text: en"}
diff --git a/third_party/googleapis/google/cloud/language/v1/samples/test/classifying_content.test.yaml b/third_party/googleapis/google/cloud/language/v1/samples/test/classifying_content.test.yaml
new file mode 100644
index 000000000..5cfc76696
--- /dev/null
+++ b/third_party/googleapis/google/cloud/language/v1/samples/test/classifying_content.test.yaml
@@ -0,0 +1,51 @@
+type: test/samples
+schema_version: 1
+test:
+  suites:
+  - name: "Classifying Content [code sample tests]"
+    cases:
+
+    - name: language_classify_text - Classifying Content of a text string (default value)
+      spec:
+      # Default value: "That actor on TV makes movies in Hollywood and also stars in a variety of popular new TV shows."
+      - call: {sample: language_classify_text}
+      - assert_contains_any:
+        - {literal: "TV"}
+        - {literal: "Movies"}
+        - {literal: "Entertainment"}
+
+    - name: language_classify_text - Classifying Content of a text string (*custom value*)
+      spec:
+      # Custom value: "Let's drink coffee and eat bagels at a coffee shop. I want muffins, croisants, coffee and baked goods."
+      - call:
+          sample: language_classify_text
+          params:
+            text_content: {literal: "Let's drink coffee and eat bagels at a coffee shop. I want muffins, croisants, coffee and baked goods."}
+      - assert_contains_any:
+        - {literal: "Food"}
+        - {literal: "Drink"}
+        - {literal: "Coffee"}
+
+    - name: language_classify_gcs - Classifying Content of text file in GCS (default value)
+      spec:
+      # Default value: gs://cloud-samples-data/language/classify-entertainment.txt
+      # => "This is about film and movies and television and acting and movie theatres and theatre and drama and entertainment and the arts."
+      - call: {sample: language_classify_gcs}
+      - assert_contains_any:
+        - {literal: "TV"}
+        - {literal: "Movies"}
+        - {literal: "Entertainment"}
+
+    - name: language_classify_gcs - Classifying Content of text file in GCS (*custom value*)
+      spec:
+      # Use different file: gs://cloud-samples-data/language/android.txt
+      # => "Android is a mobile operating system developed by Google, based on the Linux kernel and..."
+      - call:
+          sample: language_classify_gcs
+          params:
+            gcs_content_uri:
+              literal: "gs://cloud-samples-data/language/android.txt"
+      - assert_contains_any:
+        - {literal: "Mobile"}
+        - {literal: "Phone"}
+        - {literal: "Internet"}
diff --git a/third_party/googleapis/google/cloud/language/v1beta1/language_gapic.yaml b/third_party/googleapis/google/cloud/language/v1beta1/language_gapic.legacy.yaml
similarity index 100%
rename from third_party/googleapis/google/cloud/language/v1beta1/language_gapic.yaml
rename to third_party/googleapis/google/cloud/language/v1beta1/language_gapic.legacy.yaml
diff --git a/third_party/googleapis/google/cloud/language/v1beta2/BUILD.bazel b/third_party/googleapis/google/cloud/language/v1beta2/BUILD.bazel
index 1ce9261d4..cb3e79e86 100644
--- a/third_party/googleapis/google/cloud/language/v1beta2/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/language/v1beta2/BUILD.bazel
@@ -1,25 +1,33 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
     name = "language_proto",
-    srcs = ["language_service.proto"],
+    srcs = [
+        "language_service.proto",
+    ],
     deps = [
         "//google/api:annotations_proto",
-        "//google/longrunning:operations_proto",
-        "//google/rpc:status_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
         "@com_google_protobuf//:timestamp_proto",
     ],
 )
 
 proto_library_with_info(
     name = "language_proto_with_info",
-    deps = [":language_proto"],
+    deps = [
+        ":language_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -27,17 +35,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
     name = "language_java_proto",
     deps = [":language_proto"],
@@ -46,39 +50,40 @@ java_proto_library(
 java_grpc_library(
     name = "language_java_grpc",
     srcs = [":language_proto"],
-    deps = [":language_java_proto"] + _JAVA_GRPC_DEPS,
+    deps = [":language_java_proto"],
 )
 
 java_gapic_library(
     name = "language_java_gapic",
     src = ":language_proto_with_info",
     gapic_yaml = "language_gapic.yaml",
-    service_yaml = "//google/cloud/language:language_v1beta2.yaml",
-    test_deps = [":language_java_grpc"],
-    deps = [":language_java_proto"] + _JAVA_GRPC_DEPS,
+    package = "google.cloud.language.v1beta2",
+    service_yaml = "language_v1beta2.yaml",
+    test_deps = [
+        ":language_java_grpc",
+    ],
+    deps = [
+        ":language_java_proto",
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
+java_gapic_test(
+    name = "language_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.language.v1beta2.LanguageServiceClientTest",
+    ],
     runtime_deps = [":language_java_gapic_test"],
-) for test_name in [
-    "com.google.cloud.language.v1beta2.LanguageServiceClientTest",
-]]
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-language-v1beta2-java",
-    client_deps = [":language_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":language_java_gapic_test"],
-    grpc_deps = [":language_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":language_java_gapic",
+        ":language_java_grpc",
         ":language_java_proto",
         ":language_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -86,10 +91,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -99,18 +104,18 @@ go_proto_library(
     protos = [":language_proto"],
     deps = [
         "//google/api:annotations_go_proto",
-        "//google/longrunning:longrunning_go_proto",
-        "//google/rpc:status_go_proto",
     ],
 )
 
 go_gapic_library(
     name = "language_go_gapic",
-    src = ":language_proto_with_info",
-    gapic_yaml = "language_gapic.yaml",
-    importpath = "cloud.google.com/go/language/apiv1beta2",
-    service_yaml = "//google/cloud/language:language_v1beta2.yaml",
-    deps = [":language_go_proto"],
+    srcs = [":language_proto_with_info"],
+    grpc_service_config = "language_grpc_service_config.json",
+    importpath = "cloud.google.com/go/language/apiv1beta2;language",
+    service_yaml = "language_v1beta2.yaml",
+    deps = [
+        ":language_go_proto",
+    ],
 )
 
 go_test(
@@ -120,13 +125,232 @@ go_test(
     importpath = "cloud.google.com/go/language/apiv1beta2",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-language-v1beta2-go",
     deps = [
         ":language_go_gapic",
-        ":language_go_gapic_srcjar-smoke-test.srcjar",
         ":language_go_gapic_srcjar-test.srcjar",
         ":language_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "language_moved_proto",
+    srcs = [":language_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "language_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":language_moved_proto"],
+)
+
+py_grpc_library(
+    name = "language_py_grpc",
+    srcs = [":language_moved_proto"],
+    deps = [":language_py_proto"],
+)
+
+py_gapic_library(
+    name = "language_py_gapic",
+    src = ":language_proto_with_info",
+    gapic_yaml = "language_gapic.yaml",
+    package = "google.cloud.language.v1beta2",
+    service_yaml = "language_v1beta2.yaml",
+    deps = [
+        ":language_py_grpc",
+        ":language_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "language-v1beta2-py",
+    deps = [
+        ":language_py_gapic",
+        ":language_py_grpc",
+        ":language_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "language_php_proto",
+    deps = [":language_proto"],
+)
+
+php_grpc_library(
+    name = "language_php_grpc",
+    srcs = [":language_proto"],
+    deps = [":language_php_proto"],
+)
+
+php_gapic_library(
+    name = "language_php_gapic",
+    src = ":language_proto_with_info",
+    gapic_yaml = "language_gapic.yaml",
+    package = "google.cloud.language.v1beta2",
+    service_yaml = "language_v1beta2.yaml",
+    deps = [
+        ":language_php_grpc",
+        ":language_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-language-v1beta2-php",
+    deps = [
+        ":language_php_gapic",
+        ":language_php_grpc",
+        ":language_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "language_nodejs_gapic",
+    src = ":language_proto_with_info",
+    gapic_yaml = "language_gapic.yaml",
+    package = "google.cloud.language.v1beta2",
+    service_yaml = "language_v1beta2.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "language-v1beta2-nodejs",
+    deps = [
+        ":language_nodejs_gapic",
+        ":language_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "language_ruby_proto",
+    deps = [":language_proto"],
+)
+
+ruby_grpc_library(
+    name = "language_ruby_grpc",
+    srcs = [":language_proto"],
+    deps = [":language_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "language_ruby_gapic",
+    src = ":language_proto_with_info",
+    gapic_yaml = "language_gapic.yaml",
+    package = "google.cloud.language.v1beta2",
+    service_yaml = "language_v1beta2.yaml",
+    deps = [
+        ":language_ruby_grpc",
+        ":language_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-language-v1beta2-ruby",
+    deps = [
+        ":language_ruby_gapic",
+        ":language_ruby_grpc",
+        ":language_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "language_csharp_proto",
+    deps = [":language_proto"],
+)
+
+csharp_grpc_library(
+    name = "language_csharp_grpc",
+    srcs = [":language_proto"],
+    deps = [":language_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "language_csharp_gapic",
+    src = ":language_proto_with_info",
+    gapic_yaml = "language_gapic.yaml",
+    package = "google.cloud.language.v1beta2",
+    service_yaml = "language_v1beta2.yaml",
+    deps = [
+        ":language_csharp_grpc",
+        ":language_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-language-v1beta2-csharp",
+    deps = [
+        ":language_csharp_gapic",
+        ":language_csharp_grpc",
+        ":language_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/language/v1beta2/language_gapic.legacy.yaml b/third_party/googleapis/google/cloud/language/v1beta2/language_gapic.legacy.yaml
new file mode 100644
index 000000000..7fcf68f14
--- /dev/null
+++ b/third_party/googleapis/google/cloud/language/v1beta2/language_gapic.legacy.yaml
@@ -0,0 +1,109 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.language.v1beta2
+  python:
+    package_name: google.cloud.language_v1beta2.gapic
+  go:
+    package_name: cloud.google.com/go/language/apiv1beta2
+  csharp:
+    package_name: Google.Cloud.Language.V1Beta2
+  ruby:
+    package_name: Google::Cloud::Language::V1beta2
+  php:
+    package_name: Google\Cloud\Language\V1beta2
+  nodejs:
+    package_name: language.v1beta2
+    domain_layer_location: google-cloud
+interfaces:
+- name: google.cloud.language.v1beta2.LanguageService
+  smoke_test:
+    method: AnalyzeSentiment
+    init_fields:
+    - document.content="Hello, world!"
+    - document.type=PLAIN_TEXT
+  collections: []
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 60000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 60000
+    total_timeout_millis: 600000
+  methods:
+  - name: AnalyzeSentiment
+    flattening:
+      groups:
+      - parameters:
+        - document
+    required_fields:
+    - document
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 30000
+  - name: AnalyzeEntities
+    flattening:
+      groups:
+      - parameters:
+        - document
+        - encoding_type
+    required_fields:
+    - document
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 30000
+  - name: AnalyzeEntitySentiment
+    flattening:
+      groups:
+      - parameters:
+        - document
+        - encoding_type
+    required_fields:
+    - document
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 30000
+  - name: AnalyzeSyntax
+    flattening:
+      groups:
+      - parameters:
+        - document
+        - encoding_type
+    required_fields:
+    - document
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 30000
+  - name: ClassifyText
+    flattening:
+      groups:
+      - parameters:
+        - document
+    required_fields:
+    - document
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 30000
+  - name: AnnotateText
+    flattening:
+      groups:
+      - parameters:
+        - document
+        - features
+        - encoding_type
+    required_fields:
+    - document
+    - features
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 30000
diff --git a/third_party/googleapis/google/cloud/language/v1beta2/language_gapic.yaml b/third_party/googleapis/google/cloud/language/v1beta2/language_gapic.yaml
index 7fcf68f14..c1c1afd1b 100644
--- a/third_party/googleapis/google/cloud/language/v1beta2/language_gapic.yaml
+++ b/third_party/googleapis/google/cloud/language/v1beta2/language_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.language.v1beta2
@@ -23,14 +23,6 @@ interfaces:
     init_fields:
     - document.content="Hello, world!"
     - document.type=PLAIN_TEXT
-  collections: []
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 100
@@ -42,68 +34,20 @@ interfaces:
     total_timeout_millis: 600000
   methods:
   - name: AnalyzeSentiment
-    flattening:
-      groups:
-      - parameters:
-        - document
-    required_fields:
-    - document
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 30000
   - name: AnalyzeEntities
-    flattening:
-      groups:
-      - parameters:
-        - document
-        - encoding_type
-    required_fields:
-    - document
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 30000
   - name: AnalyzeEntitySentiment
-    flattening:
-      groups:
-      - parameters:
-        - document
-        - encoding_type
-    required_fields:
-    - document
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 30000
   - name: AnalyzeSyntax
-    flattening:
-      groups:
-      - parameters:
-        - document
-        - encoding_type
-    required_fields:
-    - document
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 30000
   - name: ClassifyText
-    flattening:
-      groups:
-      - parameters:
-        - document
-    required_fields:
-    - document
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 30000
   - name: AnnotateText
-    flattening:
-      groups:
-      - parameters:
-        - document
-        - features
-        - encoding_type
-    required_fields:
-    - document
-    - features
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 30000
diff --git a/third_party/googleapis/google/cloud/language/v1beta2/language_grpc_service_config.json b/third_party/googleapis/google/cloud/language/v1beta2/language_grpc_service_config.json
new file mode 100755
index 000000000..13406d73d
--- /dev/null
+++ b/third_party/googleapis/google/cloud/language/v1beta2/language_grpc_service_config.json
@@ -0,0 +1,42 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.language.v1beta2.LanguageService",
+          "method": "AnalyzeSentiment"
+        },
+        {
+          "service": "google.cloud.language.v1beta2.LanguageService",
+          "method": "AnalyzeEntities"
+        },
+        {
+          "service": "google.cloud.language.v1beta2.LanguageService",
+          "method": "AnalyzeEntitySentiment"
+        },
+        {
+          "service": "google.cloud.language.v1beta2.LanguageService",
+          "method": "AnalyzeSyntax"
+        },
+        {
+          "service": "google.cloud.language.v1beta2.LanguageService",
+          "method": "ClassifyText"
+        },
+        {
+          "service": "google.cloud.language.v1beta2.LanguageService",
+          "method": "AnnotateText"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    }
+  ]
+}
\ No newline at end of file
diff --git a/third_party/googleapis/google/cloud/language/v1beta2/language_service.proto b/third_party/googleapis/google/cloud/language/v1beta2/language_service.proto
index 0263be04a..afca1205c 100644
--- a/third_party/googleapis/google/cloud/language/v1beta2/language_service.proto
+++ b/third_party/googleapis/google/cloud/language/v1beta2/language_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2017 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,15 +11,16 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.language.v1beta2;
 
 import "google/api/annotations.proto";
-import "google/longrunning/operations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/protobuf/timestamp.proto";
-import "google/rpc/status.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/language/v1beta2;language";
 option java_multiple_files = true;
@@ -29,46 +30,54 @@ option java_package = "com.google.cloud.language.v1beta2";
 // Provides text analysis operations such as sentiment analysis and entity
 // recognition.
 service LanguageService {
+  option (google.api.default_host) = "language.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-language,"
+      "https://www.googleapis.com/auth/cloud-platform";
+
   // Analyzes the sentiment of the provided text.
-  rpc AnalyzeSentiment(AnalyzeSentimentRequest)
-      returns (AnalyzeSentimentResponse) {
+  rpc AnalyzeSentiment(AnalyzeSentimentRequest) returns (AnalyzeSentimentResponse) {
     option (google.api.http) = {
       post: "/v1beta2/documents:analyzeSentiment"
       body: "*"
     };
+    option (google.api.method_signature) = "document,encoding_type";
+    option (google.api.method_signature) = "document";
   }
 
   // Finds named entities (currently proper names and common nouns) in the text
   // along with entity types, salience, mentions for each entity, and
   // other properties.
-  rpc AnalyzeEntities(AnalyzeEntitiesRequest)
-      returns (AnalyzeEntitiesResponse) {
+  rpc AnalyzeEntities(AnalyzeEntitiesRequest) returns (AnalyzeEntitiesResponse) {
     option (google.api.http) = {
       post: "/v1beta2/documents:analyzeEntities"
       body: "*"
     };
+    option (google.api.method_signature) = "document,encoding_type";
+    option (google.api.method_signature) = "document";
   }
 
-  // Finds entities, similar to
-  // [AnalyzeEntities][google.cloud.language.v1beta2.LanguageService.AnalyzeEntities]
-  // in the text and analyzes sentiment associated with each entity and its
-  // mentions.
-  rpc AnalyzeEntitySentiment(AnalyzeEntitySentimentRequest)
-      returns (AnalyzeEntitySentimentResponse) {
+  // Finds entities, similar to [AnalyzeEntities][google.cloud.language.v1beta2.LanguageService.AnalyzeEntities] in the text and analyzes
+  // sentiment associated with each entity and its mentions.
+  rpc AnalyzeEntitySentiment(AnalyzeEntitySentimentRequest) returns (AnalyzeEntitySentimentResponse) {
     option (google.api.http) = {
       post: "/v1beta2/documents:analyzeEntitySentiment"
       body: "*"
     };
+    option (google.api.method_signature) = "document,encoding_type";
+    option (google.api.method_signature) = "document";
   }
 
   // Analyzes the syntax of the text and provides sentence boundaries and
-  // tokenization along with part of speech tags, dependency trees, and other
+  // tokenization along with part-of-speech tags, dependency trees, and other
   // properties.
   rpc AnalyzeSyntax(AnalyzeSyntaxRequest) returns (AnalyzeSyntaxResponse) {
     option (google.api.http) = {
       post: "/v1beta2/documents:analyzeSyntax"
       body: "*"
     };
+    option (google.api.method_signature) = "document,encoding_type";
+    option (google.api.method_signature) = "document";
   }
 
   // Classifies a document into categories.
@@ -77,6 +86,7 @@ service LanguageService {
       post: "/v1beta2/documents:classifyText"
       body: "*"
     };
+    option (google.api.method_signature) = "document";
   }
 
   // A convenience method that provides all syntax, sentiment, entity, and
@@ -86,6 +96,8 @@ service LanguageService {
       post: "/v1beta2/documents:annotateText"
       body: "*"
     };
+    option (google.api.method_signature) = "document,features,encoding_type";
+    option (google.api.method_signature) = "document,features";
   }
 }
 
@@ -113,6 +125,7 @@ message Document {
   // Google Cloud Storage URI.
   oneof source {
     // The content of the input in string format.
+    // Cloud audit logging exempt since it is based on user data.
     string content = 2;
 
     // The Google Cloud Storage URI where the file content is located.
@@ -125,11 +138,11 @@ message Document {
   // The language of the document (if not specified, the language is
   // automatically detected). Both ISO and BCP-47 language codes are
   // accepted.

-  // [Language Support](/natural-language/docs/languages)
-  // lists currently supported languages for each API method.
-  // If the language (either specified by the caller or automatically detected)
-  // is not supported by the called API method, an `INVALID_ARGUMENT` error
-  // is returned.
+  // [Language
+  // Support](https://cloud.google.com/natural-language/docs/languages) lists
+  // currently supported languages for each API method. If the language (either
+  // specified by the caller or automatically detected) is not supported by the
+  // called API method, an `INVALID_ARGUMENT` error is returned.
   string language = 4;
 }
 
@@ -139,8 +152,8 @@ message Sentence {
   TextSpan text = 1;
 
   // For calls to [AnalyzeSentiment][] or if
-  // [AnnotateTextRequest.Features.extract_document_sentiment][google.cloud.language.v1beta2.AnnotateTextRequest.Features.extract_document_sentiment]
-  // is set to true, this field will contain the sentiment for the sentence.
+  // [AnnotateTextRequest.Features.extract_document_sentiment][google.cloud.language.v1beta2.AnnotateTextRequest.Features.extract_document_sentiment] is set to
+  // true, this field will contain the sentiment for the sentence.
   Sentiment sentiment = 2;
 }
 
@@ -148,7 +161,10 @@ message Sentence {
 // a person, an organization, or location. The API associates information, such
 // as salience and mentions, with entities.
 message Entity {
-  // The type of the entity.
+  // The type of the entity. For most entity types, the associated metadata is a
+  // Wikipedia URL (`wikipedia_url`) and Knowledge Graph MID (`mid`). The table
+  // below lists the associated fields for entities that have different
+  // metadata.
   enum Type {
     // Unknown
     UNKNOWN = 0;
@@ -165,14 +181,63 @@ message Entity {
     // Event
     EVENT = 4;
 
-    // Work of art
+    // Artwork
     WORK_OF_ART = 5;
 
-    // Consumer goods
+    // Consumer product
     CONSUMER_GOOD = 6;
 
-    // Other types
+    // Other types of entities
     OTHER = 7;
+
+    // Phone number
+    //
+    // The metadata lists the phone number, formatted according to local
+    // convention, plus whichever additional elements appear in the text:
+    //
+    // * `number` - the actual number, broken down into sections as per local
+    // convention
+    // * `national_prefix` - country code, if detected
+    // * `area_code` - region or area code, if detected
+    // * `extension` - phone extension (to be dialed after connection), if
+    // detected
+    PHONE_NUMBER = 9;
+
+    // Address
+    //
+    // The metadata identifies the street number and locality plus whichever
+    // additional elements appear in the text:
+    //
+    // * `street_number` - street number
+    // * `locality` - city or town
+    // * `street_name` - street/route name, if detected
+    // * `postal_code` - postal code, if detected
+    // * `country` - country, if detected<
+    // * `broad_region` - administrative area, such as the state, if detected
+    // * `narrow_region` - smaller administrative area, such as county, if
+    // detected
+    // * `sublocality` - used in Asian addresses to demark a district within a
+    // city, if detected
+    ADDRESS = 10;
+
+    // Date
+    //
+    // The metadata identifies the components of the date:
+    //
+    // * `year` - four digit year, if detected
+    // * `month` - two digit month number, if detected
+    // * `day` - two digit day number, if detected
+    DATE = 11;
+
+    // Number
+    //
+    // The metadata is the number itself.
+    NUMBER = 12;
+
+    // Price
+    //
+    // The metadata identifies the `value` and `currency`.
+    PRICE = 13;
   }
 
   // The representative name for the entity.
@@ -183,8 +248,9 @@ message Entity {
 
   // Metadata associated with the entity.
   //
-  // Currently, Wikipedia URLs and Knowledge Graph MIDs are provided, if
-  // available. The associated keys are "wikipedia_url" and "mid", respectively.
+  // For most entity types, the metadata is a Wikipedia URL (`wikipedia_url`)
+  // and Knowledge Graph MID (`mid`), if they are available. For the metadata
+  // associated with other entity types, see the Type table below.
   map metadata = 3;
 
   // The salience score associated with the entity in the [0, 1.0] range.
@@ -200,9 +266,9 @@ message Entity {
   repeated EntityMention mentions = 5;
 
   // For calls to [AnalyzeEntitySentiment][] or if
-  // [AnnotateTextRequest.Features.extract_entity_sentiment][google.cloud.language.v1beta2.AnnotateTextRequest.Features.extract_entity_sentiment]
-  // is set to true, this field will contain the aggregate sentiment expressed
-  // for this entity in the provided document.
+  // [AnnotateTextRequest.Features.extract_entity_sentiment][google.cloud.language.v1beta2.AnnotateTextRequest.Features.extract_entity_sentiment] is set to
+  // true, this field will contain the aggregate sentiment expressed for this
+  // entity in the provided document.
   Sentiment sentiment = 6;
 }
 
@@ -221,8 +287,35 @@ message Token {
   string lemma = 4;
 }
 
+// Represents the text encoding that the caller uses to process the output.
+// Providing an `EncodingType` is recommended because the API provides the
+// beginning offsets for various outputs, such as tokens and mentions, and
+// languages that natively use different text encodings may access offsets
+// differently.
+enum EncodingType {
+  // If `EncodingType` is not specified, encoding-dependent information (such as
+  // `begin_offset`) will be set at `-1`.
+  NONE = 0;
+
+  // Encoding-dependent information (such as `begin_offset`) is calculated based
+  // on the UTF-8 encoding of the input. C++ and Go are examples of languages
+  // that use this encoding natively.
+  UTF8 = 1;
+
+  // Encoding-dependent information (such as `begin_offset`) is calculated based
+  // on the UTF-16 encoding of the input. Java and JavaScript are examples of
+  // languages that use this encoding natively.
+  UTF16 = 2;
+
+  // Encoding-dependent information (such as `begin_offset`) is calculated based
+  // on the UTF-32 encoding of the input. Python is an example of a language
+  // that uses this encoding natively.
+  UTF32 = 3;
+}
+
 // Represents the feeling associated with the entire text or entities in
 // the text.
+// Next ID: 6
 message Sentiment {
   // A non-negative number in the [0, +inf) range, which represents
   // the absolute magnitude of sentiment regardless of score (positive or
@@ -849,9 +942,9 @@ message EntityMention {
   Type type = 2;
 
   // For calls to [AnalyzeEntitySentiment][] or if
-  // [AnnotateTextRequest.Features.extract_entity_sentiment][google.cloud.language.v1beta2.AnnotateTextRequest.Features.extract_entity_sentiment]
-  // is set to true, this field will contain the sentiment expressed for this
-  // mention of the entity in the provided document.
+  // [AnnotateTextRequest.Features.extract_entity_sentiment][google.cloud.language.v1beta2.AnnotateTextRequest.Features.extract_entity_sentiment] is set to
+  // true, this field will contain the sentiment expressed for this mention of
+  // the entity in the provided document.
   Sentiment sentiment = 3;
 }
 
@@ -861,15 +954,14 @@ message TextSpan {
   string content = 1;
 
   // The API calculates the beginning offset of the content in the original
-  // document according to the
-  // [EncodingType][google.cloud.language.v1beta2.EncodingType] specified in the
-  // API request.
+  // document according to the [EncodingType][google.cloud.language.v1beta2.EncodingType] specified in the API request.
   int32 begin_offset = 2;
 }
 
 // Represents a category returned from the text classifier.
 message ClassificationCategory {
-  // The name of the category representing the document.
+  // The name of the category representing the document, from the [predefined
+  // taxonomy](https://cloud.google.com/natural-language/docs/categories).
   string name = 1;
 
   // The classifier's confidence of the category. Number represents how certain
@@ -879,8 +971,8 @@ message ClassificationCategory {
 
 // The sentiment analysis request message.
 message AnalyzeSentimentRequest {
-  // Input document.
-  Document document = 1;
+  // Required. Input document.
+  Document document = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The encoding type used by the API to calculate sentence offsets for the
   // sentence sentiment.
@@ -894,8 +986,7 @@ message AnalyzeSentimentResponse {
 
   // The language of the text, which will be the same as the language specified
   // in the request or, if not specified, the automatically-detected language.
-  // See [Document.language][google.cloud.language.v1beta2.Document.language]
-  // field for more details.
+  // See [Document.language][google.cloud.language.v1beta2.Document.language] field for more details.
   string language = 2;
 
   // The sentiment for all the sentences in the document.
@@ -904,8 +995,8 @@ message AnalyzeSentimentResponse {
 
 // The entity-level sentiment analysis request message.
 message AnalyzeEntitySentimentRequest {
-  // Input document.
-  Document document = 1;
+  // Required. Input document.
+  Document document = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The encoding type used by the API to calculate offsets.
   EncodingType encoding_type = 2;
@@ -918,15 +1009,14 @@ message AnalyzeEntitySentimentResponse {
 
   // The language of the text, which will be the same as the language specified
   // in the request or, if not specified, the automatically-detected language.
-  // See [Document.language][google.cloud.language.v1beta2.Document.language]
-  // field for more details.
+  // See [Document.language][google.cloud.language.v1beta2.Document.language] field for more details.
   string language = 2;
 }
 
 // The entity analysis request message.
 message AnalyzeEntitiesRequest {
-  // Input document.
-  Document document = 1;
+  // Required. Input document.
+  Document document = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The encoding type used by the API to calculate offsets.
   EncodingType encoding_type = 2;
@@ -939,15 +1029,14 @@ message AnalyzeEntitiesResponse {
 
   // The language of the text, which will be the same as the language specified
   // in the request or, if not specified, the automatically-detected language.
-  // See [Document.language][google.cloud.language.v1beta2.Document.language]
-  // field for more details.
+  // See [Document.language][google.cloud.language.v1beta2.Document.language] field for more details.
   string language = 2;
 }
 
 // The syntax analysis request message.
 message AnalyzeSyntaxRequest {
-  // Input document.
-  Document document = 1;
+  // Required. Input document.
+  Document document = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The encoding type used by the API to calculate offsets.
   EncodingType encoding_type = 2;
@@ -963,15 +1052,14 @@ message AnalyzeSyntaxResponse {
 
   // The language of the text, which will be the same as the language specified
   // in the request or, if not specified, the automatically-detected language.
-  // See [Document.language][google.cloud.language.v1beta2.Document.language]
-  // field for more details.
+  // See [Document.language][google.cloud.language.v1beta2.Document.language] field for more details.
   string language = 3;
 }
 
 // The document classification request message.
 message ClassifyTextRequest {
-  // Input document.
-  Document document = 1;
+  // Required. Input document.
+  Document document = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The document classification response message.
@@ -985,6 +1073,7 @@ message ClassifyTextResponse {
 message AnnotateTextRequest {
   // All available features for sentiment, syntax, and semantic analysis.
   // Setting each one to true will enable that specific analysis for the input.
+  // Next ID: 10
   message Features {
     // Extract syntax information.
     bool extract_syntax = 1;
@@ -998,15 +1087,18 @@ message AnnotateTextRequest {
     // Extract entities and their associated sentiment.
     bool extract_entity_sentiment = 4;
 
-    // Classify the full document into categories.
+    // Classify the full document into categories. If this is true,
+    // the API will use the default model which classifies into a
+    // [predefined
+    // taxonomy](https://cloud.google.com/natural-language/docs/categories).
     bool classify_text = 6;
   }
 
-  // Input document.
-  Document document = 1;
+  // Required. Input document.
+  Document document = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // The enabled features.
-  Features features = 2;
+  // Required. The enabled features.
+  Features features = 2 [(google.api.field_behavior) = REQUIRED];
 
   // The encoding type used by the API to calculate offsets.
   EncodingType encoding_type = 3;
@@ -1034,36 +1126,9 @@ message AnnotateTextResponse {
 
   // The language of the text, which will be the same as the language specified
   // in the request or, if not specified, the automatically-detected language.
-  // See [Document.language][google.cloud.language.v1beta2.Document.language]
-  // field for more details.
+  // See [Document.language][google.cloud.language.v1beta2.Document.language] field for more details.
   string language = 5;
 
   // Categories identified in the input document.
   repeated ClassificationCategory categories = 6;
 }
-
-// Represents the text encoding that the caller uses to process the output.
-// Providing an `EncodingType` is recommended because the API provides the
-// beginning offsets for various outputs, such as tokens and mentions, and
-// languages that natively use different text encodings may access offsets
-// differently.
-enum EncodingType {
-  // If `EncodingType` is not specified, encoding-dependent information (such as
-  // `begin_offset`) will be set at `-1`.
-  NONE = 0;
-
-  // Encoding-dependent information (such as `begin_offset`) is calculated based
-  // on the UTF-8 encoding of the input. C++ and Go are examples of languages
-  // that use this encoding natively.
-  UTF8 = 1;
-
-  // Encoding-dependent information (such as `begin_offset`) is calculated based
-  // on the UTF-16 encoding of the input. Java and Javascript are examples of
-  // languages that use this encoding natively.
-  UTF16 = 2;
-
-  // Encoding-dependent information (such as `begin_offset`) is calculated based
-  // on the UTF-32 encoding of the input. Python is an example of a language
-  // that uses this encoding natively.
-  UTF32 = 3;
-}
diff --git a/third_party/googleapis/google/cloud/language/v1beta2/language_v1beta2.yaml b/third_party/googleapis/google/cloud/language/v1beta2/language_v1beta2.yaml
new file mode 100644
index 000000000..bb383eb0a
--- /dev/null
+++ b/third_party/googleapis/google/cloud/language/v1beta2/language_v1beta2.yaml
@@ -0,0 +1,21 @@
+type: google.api.Service
+config_version: 3
+name: language.googleapis.com
+title: Cloud Natural Language API
+
+apis:
+- name: google.cloud.language.v1beta2.LanguageService
+
+documentation:
+  summary: |-
+    Provides natural language understanding technologies, such as sentiment
+    analysis, entity recognition, entity sentiment analysis, and other text
+    annotations, to developers.
+
+authentication:
+  rules:
+  - selector: 'google.cloud.language.v1beta2.LanguageService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-language,
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/managedidentities/v1/BUILD.bazel b/third_party/googleapis/google/cloud/managedidentities/v1/BUILD.bazel
new file mode 100644
index 000000000..f6d9664cc
--- /dev/null
+++ b/third_party/googleapis/google/cloud/managedidentities/v1/BUILD.bazel
@@ -0,0 +1,368 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "managedidentities_proto",
+    srcs = [
+        "managed_identities_service.proto",
+        "resource.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "managedidentities_proto_with_info",
+    deps = [
+        ":managedidentities_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "managedidentities_java_proto",
+    deps = [":managedidentities_proto"],
+)
+
+java_grpc_library(
+    name = "managedidentities_java_grpc",
+    srcs = [":managedidentities_proto"],
+    deps = [":managedidentities_java_proto"],
+)
+
+java_gapic_library(
+    name = "managedidentities_java_gapic",
+    src = ":managedidentities_proto_with_info",
+    gapic_yaml = "managedidentities_gapic.yaml",
+    package = "google.cloud.managedidentities.v1",
+    service_yaml = "managedidentities_v1.yaml",
+    test_deps = [
+        ":managedidentities_java_grpc",
+    ],
+    deps = [
+        ":managedidentities_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "managedidentities_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.managedidentities.v1.ManagedIdentitiesServiceClientTest",
+    ],
+    runtime_deps = [":managedidentities_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-managedidentities-v1-java",
+    deps = [
+        ":managedidentities_java_gapic",
+        ":managedidentities_java_grpc",
+        ":managedidentities_java_proto",
+        ":managedidentities_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "managedidentities_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/managedidentities/v1",
+    protos = [":managedidentities_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/longrunning:longrunning_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "managedidentities_go_gapic",
+    srcs = [":managedidentities_proto_with_info"],
+    grpc_service_config = "managedidentities_grpc_service_config.json",
+    importpath = "cloud.google.com/go/managedidentities/apiv1;managedidentities",
+    service_yaml = "managedidentities_v1.yaml",
+    deps = [
+        ":managedidentities_go_proto",
+        "//google/longrunning:longrunning_go_gapic",
+        "//google/longrunning:longrunning_go_proto",
+        "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
+    ],
+)
+
+go_test(
+    name = "managedidentities_go_gapic_test",
+    srcs = [":managedidentities_go_gapic_srcjar_test"],
+    embed = [":managedidentities_go_gapic"],
+    importpath = "cloud.google.com/go/managedidentities/apiv1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-managedidentities-v1-go",
+    deps = [
+        ":managedidentities_go_gapic",
+        ":managedidentities_go_gapic_srcjar-test.srcjar",
+        ":managedidentities_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "managedidentities_moved_proto",
+    srcs = [":managedidentities_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "managedidentities_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":managedidentities_moved_proto"],
+)
+
+py_grpc_library(
+    name = "managedidentities_py_grpc",
+    srcs = [":managedidentities_moved_proto"],
+    deps = [":managedidentities_py_proto"],
+)
+
+py_gapic_library(
+    name = "managedidentities_py_gapic",
+    src = ":managedidentities_proto_with_info",
+    gapic_yaml = "managedidentities_gapic.yaml",
+    package = "google.cloud.managedidentities.v1",
+    service_yaml = "managedidentities_v1.yaml",
+    deps = [
+        ":managedidentities_py_grpc",
+        ":managedidentities_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "managedidentities-v1-py",
+    deps = [
+        ":managedidentities_py_gapic",
+        ":managedidentities_py_grpc",
+        ":managedidentities_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "managedidentities_php_proto",
+    deps = [":managedidentities_proto"],
+)
+
+php_grpc_library(
+    name = "managedidentities_php_grpc",
+    srcs = [":managedidentities_proto"],
+    deps = [":managedidentities_php_proto"],
+)
+
+php_gapic_library(
+    name = "managedidentities_php_gapic",
+    src = ":managedidentities_proto_with_info",
+    gapic_yaml = "managedidentities_gapic.yaml",
+    package = "google.cloud.managedidentities.v1",
+    service_yaml = "managedidentities_v1.yaml",
+    deps = [
+        ":managedidentities_php_grpc",
+        ":managedidentities_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-managedidentities-v1-php",
+    deps = [
+        ":managedidentities_php_gapic",
+        ":managedidentities_php_grpc",
+        ":managedidentities_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "managedidentities_nodejs_gapic",
+    src = ":managedidentities_proto_with_info",
+    gapic_yaml = "managedidentities_gapic.yaml",
+    package = "google.cloud.managedidentities.v1",
+    service_yaml = "managedidentities_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "managedidentities-v1-nodejs",
+    deps = [
+        ":managedidentities_nodejs_gapic",
+        ":managedidentities_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "managedidentities_ruby_proto",
+    deps = [":managedidentities_proto"],
+)
+
+ruby_grpc_library(
+    name = "managedidentities_ruby_grpc",
+    srcs = [":managedidentities_proto"],
+    deps = [":managedidentities_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "managedidentities_ruby_gapic",
+    src = ":managedidentities_proto_with_info",
+    gapic_yaml = "managedidentities_gapic.yaml",
+    package = "google.cloud.managedidentities.v1",
+    service_yaml = "managedidentities_v1.yaml",
+    deps = [
+        ":managedidentities_ruby_grpc",
+        ":managedidentities_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-managedidentities-v1-ruby",
+    deps = [
+        ":managedidentities_ruby_gapic",
+        ":managedidentities_ruby_grpc",
+        ":managedidentities_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "managedidentities_csharp_proto",
+    deps = [":managedidentities_proto"],
+)
+
+csharp_grpc_library(
+    name = "managedidentities_csharp_grpc",
+    srcs = [":managedidentities_proto"],
+    deps = [":managedidentities_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "managedidentities_csharp_gapic",
+    src = ":managedidentities_proto_with_info",
+    gapic_yaml = "managedidentities_gapic.yaml",
+    package = "google.cloud.managedidentities.v1",
+    service_yaml = "managedidentities_v1.yaml",
+    deps = [
+        ":managedidentities_csharp_grpc",
+        ":managedidentities_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-managedidentities-v1-csharp",
+    deps = [
+        ":managedidentities_csharp_gapic",
+        ":managedidentities_csharp_grpc",
+        ":managedidentities_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/managedidentities/v1/artman_managedidentities_v1.yaml b/third_party/googleapis/google/cloud/managedidentities/v1/artman_managedidentities_v1.yaml
new file mode 100644
index 000000000..baab530ed
--- /dev/null
+++ b/third_party/googleapis/google/cloud/managedidentities/v1/artman_managedidentities_v1.yaml
@@ -0,0 +1,35 @@
+common:
+  api_name: managedidentities
+  api_version: v1
+  organization_name: google-cloud
+  proto_deps:
+  - name: google-common-protos
+  src_proto_paths:
+  - .
+  service_yaml: managedidentities_v1.yaml
+  gapic_yaml: managedidentities_gapic.yaml
+  proto_package: google.cloud.managedidentities.v1
+artifacts:
+- name: gapic_config
+  type: GAPIC_CONFIG
+- name: java_gapic
+  type: GAPIC
+  language: JAVA
+- name: python_gapic
+  type: GAPIC
+  language: PYTHON
+- name: nodejs_gapic
+  type: GAPIC
+  language: NODEJS
+- name: php_gapic
+  type: GAPIC
+  language: PHP
+- name: go_gapic
+  type: GAPIC
+  language: GO
+- name: ruby_gapic
+  type: GAPIC
+  language: RUBY
+- name: csharp_gapic
+  type: GAPIC
+  language: CSHARP
diff --git a/third_party/googleapis/google/cloud/managedidentities/v1/managed_identities_service.proto b/third_party/googleapis/google/cloud/managedidentities/v1/managed_identities_service.proto
new file mode 100644
index 000000000..06ffa3f38
--- /dev/null
+++ b/third_party/googleapis/google/cloud/managedidentities/v1/managed_identities_service.proto
@@ -0,0 +1,421 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.managedidentities.v1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/managedidentities/v1/resource.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.ManagedIdentities.V1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/managedidentities/v1;managedidentities";
+option java_multiple_files = true;
+option java_outer_classname = "ManagedIdentitiesServiceProto";
+option java_package = "com.google.cloud.managedidentities.v1";
+option objc_class_prefix = "GCMI";
+option php_namespace = "Google\\Cloud\\ManagedIdentities\\V1";
+
+// ## API Overview
+//
+// The `managedidentites.googleapis.com` service implements the Google Cloud
+// Managed Identites API for identity services
+// (e.g. Microsoft Active Directory).
+//
+// The Managed Identities service provides methods to manage
+// (create/read/update/delete) domains, reset managed identities admin password,
+// add/remove domain controllers in GCP regions and add/remove VPC peering.
+//
+// ## Data Model
+//
+// The Managed Identities service exposes the following resources:
+//
+// * Locations as global, named as follows:
+//   `projects/{project_id}/locations/global`.
+//
+// * Domains, named as follows:
+//   `/projects/{project_id}/locations/global/domain/{domain_name}`.
+//
+// The `{domain_name}` refers to fully qualified domain name in the customer
+// project e.g. mydomain.myorganization.com, with the following restrictions:
+//
+//  * Must contain only lowercase letters, numbers, periods and hyphens.
+//  * Must start with a letter.
+//  * Must contain between 2-64 characters.
+//  * Must end with a number or a letter.
+//  * Must not start with period.
+//  * First segement length (mydomain form example above) shouldn't exceed
+//    15 chars.
+//  * The last segment cannot be fully numeric.
+//  * Must be unique within the customer project.
+service ManagedIdentitiesService {
+  option (google.api.default_host) = "managedidentities.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // Creates a Microsoft AD domain.
+  rpc CreateMicrosoftAdDomain(CreateMicrosoftAdDomainRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/global}/domains"
+      body: "domain"
+    };
+    option (google.api.method_signature) = "parent,domain_name,domain";
+    option (google.longrunning.operation_info) = {
+      response_type: "Domain"
+      metadata_type: "OpMetadata"
+    };
+  }
+
+  // Resets a domain's administrator password.
+  rpc ResetAdminPassword(ResetAdminPasswordRequest) returns (ResetAdminPasswordResponse) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/global/domains/*}:resetAdminPassword"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Lists domains in a project.
+  rpc ListDomains(ListDomainsRequest) returns (ListDomainsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/locations/global}/domains"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Gets information about a domain.
+  rpc GetDomain(GetDomainRequest) returns (Domain) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/global/domains/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Updates the metadata and configuration of a domain.
+  rpc UpdateDomain(UpdateDomainRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      patch: "/v1/{domain.name=projects/*/locations/global/domains/*}"
+      body: "domain"
+    };
+    option (google.api.method_signature) = "domain,update_mask";
+    option (google.longrunning.operation_info) = {
+      response_type: "Domain"
+      metadata_type: "OpMetadata"
+    };
+  }
+
+  // Deletes a domain.
+  rpc DeleteDomain(DeleteDomainRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/locations/global/domains/*}"
+    };
+    option (google.api.method_signature) = "name";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.protobuf.Empty"
+      metadata_type: "OpMetadata"
+    };
+  }
+
+  // Adds an AD trust to a domain.
+  rpc AttachTrust(AttachTrustRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/global/domains/*}:attachTrust"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name,trust";
+    option (google.longrunning.operation_info) = {
+      response_type: "Domain"
+      metadata_type: "OpMetadata"
+    };
+  }
+
+  // Updates the DNS conditional forwarder.
+  rpc ReconfigureTrust(ReconfigureTrustRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/global/domains/*}:reconfigureTrust"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name,target_domain_name,target_dns_ip_addresses";
+    option (google.longrunning.operation_info) = {
+      response_type: "Domain"
+      metadata_type: "OpMetadata"
+    };
+  }
+
+  // Removes an AD trust.
+  rpc DetachTrust(DetachTrustRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/global/domains/*}:detachTrust"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name,trust";
+    option (google.longrunning.operation_info) = {
+      response_type: "Domain"
+      metadata_type: "OpMetadata"
+    };
+  }
+
+  // Validates a trust state, that the target domain is reachable, and that the
+  // target domain is able to accept incoming trust requests.
+  rpc ValidateTrust(ValidateTrustRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/global/domains/*}:validateTrust"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name,trust";
+    option (google.longrunning.operation_info) = {
+      response_type: "Domain"
+      metadata_type: "OpMetadata"
+    };
+  }
+}
+
+// Represents the metadata of the long-running operation.
+message OpMetadata {
+  // Output only. The time the operation was created.
+  google.protobuf.Timestamp create_time = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The time the operation finished running.
+  google.protobuf.Timestamp end_time = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Server-defined resource path for the target of the operation.
+  string target = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Name of the verb executed by the operation.
+  string verb = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Identifies whether the user has requested cancellation
+  // of the operation. Operations that have successfully been cancelled
+  // have [Operation.error][] value with a [google.rpc.Status.code][google.rpc.Status.code] of 1,
+  // corresponding to `Code.CANCELLED`.
+  bool requested_cancellation = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. API version used to start the operation.
+  string api_version = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// Request message for
+// [CreateMicrosoftAdDomain][google.cloud.managedidentities.v1.CreateMicrosoftAdDomain]
+message CreateMicrosoftAdDomainRequest {
+  // Required. The resource project name and location using the form:
+  // `projects/{project_id}/locations/global`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "managedidentities.googleapis.com/Domain"
+    }
+  ];
+
+  // Required. The fully qualified domain name.
+  // e.g. mydomain.myorganization.com, with the following restrictions:
+  //
+  //  * Must contain only lowercase letters, numbers, periods and hyphens.
+  //  * Must start with a letter.
+  //  * Must contain between 2-64 characters.
+  //  * Must end with a number or a letter.
+  //  * Must not start with period.
+  //  * First segement length (mydomain form example above) shouldn't exceed
+  //    15 chars.
+  //  * The last segment cannot be fully numeric.
+  //  * Must be unique within the customer project.
+  string domain_name = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. A Managed Identity domain resource.
+  Domain domain = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for
+// [ResetAdminPassword][google.cloud.managedidentities.v1.ResetAdminPassword]
+message ResetAdminPasswordRequest {
+  // Required. The domain resource name using the form:
+  // `projects/{project_id}/locations/global/domains/{domain_name}`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "managedidentities.googleapis.com/Domain"
+    }
+  ];
+}
+
+// Response message for
+// [ResetAdminPassword][google.cloud.managedidentities.v1.ResetAdminPassword]
+message ResetAdminPasswordResponse {
+  // A random password. See [admin][google.cloud.managedidentities.v1.Domain.admin] for more information.
+  string password = 1;
+}
+
+// Request message for
+// [ListDomains][google.cloud.managedidentities.v1.ListDomains]
+message ListDomainsRequest {
+  // Required. The resource name of the domain location using the form:
+  // `projects/{project_id}/locations/global`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "managedidentities.googleapis.com/Domain"
+    }
+  ];
+
+  // Optional. The maximum number of items to return.
+  // If not specified, a default value of 1000 will be used.
+  // Regardless of the page_size value, the response may include a partial list.
+  // Callers should rely on a response's
+  // [next_page_token][google.cloud.managedidentities.v1.ListDomainsResponse.next_page_token]
+  // to determine if there are additional results to list.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The `next_page_token` value returned from a previous ListDomainsRequest
+  // request, if any.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A filter specifying constraints of a list operation.
+  // For example, `Domain.fqdn="mydomain.myorginization"`.
+  string filter = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Specifies the ordering of results. See
+  // [Sorting
+  // order](https://cloud.google.com/apis/design/design_patterns#sorting_order)
+  // for more information.
+  string order_by = 5 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response message for
+// [ListDomains][google.cloud.managedidentities.v1.ListDomains]
+message ListDomainsResponse {
+  // A list of Managed Identities Service domains in the project.
+  repeated Domain domains = 1;
+
+  // A token to retrieve the next page of results, or empty if there are no more
+  // results in the list.
+  string next_page_token = 2;
+
+  // A list of locations that could not be reached.
+  repeated string unreachable = 3;
+}
+
+// Request message for [GetDomain][google.cloud.managedidentities.v1.GetDomain]
+message GetDomainRequest {
+  // Required. The domain resource name using the form:
+  // `projects/{project_id}/locations/global/domains/{domain_name}`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "managedidentities.googleapis.com/Domain"
+    }
+  ];
+}
+
+// Request message for
+// [UpdateDomain][google.cloud.managedidentities.v1.UpdateDomain]
+message UpdateDomainRequest {
+  // Required. Mask of fields to update. At least one path must be supplied in this
+  // field. The elements of the repeated paths field may only include
+  // fields from [Domain][google.cloud.managedidentities.v1.Domain]:
+  //  * `labels`
+  //  * `locations`
+  //  * `authorized_networks`
+  google.protobuf.FieldMask update_mask = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Domain message with updated fields. Only supported fields specified in
+  // update_mask are updated.
+  Domain domain = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for
+// [DeleteDomain][google.cloud.managedidentities.v1.DeleteDomain]
+message DeleteDomainRequest {
+  // Required. The domain resource name using the form:
+  // `projects/{project_id}/locations/global/domains/{domain_name}`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "managedidentities.googleapis.com/Domain"
+    }
+  ];
+}
+
+// Request message for
+// [AttachTrust][google.cloud.managedidentities.v1.AttachTrust]
+message AttachTrustRequest {
+  // Required. The resource domain name, project name and location using the form:
+  // `projects/{project_id}/locations/global/domains/{domain_name}`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "managedidentities.googleapis.com/Domain"
+    }
+  ];
+
+  // Required. The domain trust resource.
+  Trust trust = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for
+// [ReconfigureTrust][google.cloud.managedidentities.v1.ReconfigureTrust]
+message ReconfigureTrustRequest {
+  // Required. The resource domain name, project name and location using the form:
+  // `projects/{project_id}/locations/global/domains/{domain_name}`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "managedidentities.googleapis.com/Domain"
+    }
+  ];
+
+  // Required. The fully-qualified target domain name which will be in trust with current
+  // domain.
+  string target_domain_name = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The target DNS server IP addresses to resolve the remote domain involved
+  // in the trust.
+  repeated string target_dns_ip_addresses = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for
+// [DetachTrust][google.cloud.managedidentities.v1.DetachTrust]
+message DetachTrustRequest {
+  // Required. The resource domain name, project name, and location using the form:
+  // `projects/{project_id}/locations/global/domains/{domain_name}`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "managedidentities.googleapis.com/Domain"
+    }
+  ];
+
+  // Required. The domain trust resource to removed.
+  Trust trust = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for
+// [ValidateTrust][google.cloud.managedidentities.v1.ValidateTrust]
+message ValidateTrustRequest {
+  // Required. The resource domain name, project name, and location using the form:
+  // `projects/{project_id}/locations/global/domains/{domain_name}`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "managedidentities.googleapis.com/Domain"
+    }
+  ];
+
+  // Required. The domain trust to validate trust state for.
+  Trust trust = 2 [(google.api.field_behavior) = REQUIRED];
+}
diff --git a/third_party/googleapis/google/cloud/managedidentities/v1/managedidentities_gapic.yaml b/third_party/googleapis/google/cloud/managedidentities/v1/managedidentities_gapic.yaml
new file mode 100644
index 000000000..307c02c58
--- /dev/null
+++ b/third_party/googleapis/google/cloud/managedidentities/v1/managedidentities_gapic.yaml
@@ -0,0 +1,18 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 2.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.managedidentities.v1
+  python:
+    package_name: google.cloud.managedidentities_v1.gapic
+  go:
+    package_name: cloud.google.com/go/managedidentities/apiv1
+  csharp:
+    package_name: Google.Cloud.ManagedIdentities.V1
+  ruby:
+    package_name: Google::Cloud::ManagedIdentities::V1
+  php:
+    package_name: Google\Cloud\ManagedIdentities\V1
+  nodejs:
+    package_name: managedidentities.v1
diff --git a/third_party/googleapis/google/cloud/managedidentities/v1/managedidentities_grpc_service_config.json b/third_party/googleapis/google/cloud/managedidentities/v1/managedidentities_grpc_service_config.json
new file mode 100644
index 000000000..53a941b01
--- /dev/null
+++ b/third_party/googleapis/google/cloud/managedidentities/v1/managedidentities_grpc_service_config.json
@@ -0,0 +1,49 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.managedidentities.v1.ManagedIdentitiesService",
+          "method": "CreateMicrosoftAdDomain"
+        },
+        {
+          "service": "google.cloud.managedidentities.v1.ManagedIdentitiesService",
+          "method": "ResetAdminPassword"
+        },
+        {
+          "service": "google.cloud.managedidentities.v1.ManagedIdentitiesService",
+          "method": "ListDomains"
+        },
+        {
+          "service": "google.cloud.managedidentities.v1.ManagedIdentitiesService",
+          "method": "GetDomain"
+        },
+        {
+          "service": "google.cloud.managedidentities.v1.ManagedIdentitiesService",
+          "method": "UpdateDomain"
+        },
+        {
+          "service": "google.cloud.managedidentities.v1.ManagedIdentitiesService",
+          "method": "DeleteDomain"
+        },
+        {
+          "service": "google.cloud.managedidentities.v1.ManagedIdentitiesService",
+          "method": "AttachTrust"
+        },
+        {
+          "service": "google.cloud.managedidentities.v1.ManagedIdentitiesService",
+          "method": "ReconfigureTrust"
+        },
+        {
+          "service": "google.cloud.managedidentities.v1.ManagedIdentitiesService",
+          "method": "DetachTrust"
+        },
+        {
+          "service": "google.cloud.managedidentities.v1.ManagedIdentitiesService",
+          "method": "ValidateTrust"
+        }
+      ],
+      "timeout": "60s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/managedidentities/v1/managedidentities_v1.yaml b/third_party/googleapis/google/cloud/managedidentities/v1/managedidentities_v1.yaml
new file mode 100644
index 000000000..eac6504ab
--- /dev/null
+++ b/third_party/googleapis/google/cloud/managedidentities/v1/managedidentities_v1.yaml
@@ -0,0 +1,65 @@
+type: google.api.Service
+config_version: 3
+name: managedidentities.googleapis.com
+title: Managed Service for Microsoft Active Directory API
+
+apis:
+- name: google.cloud.managedidentities.v1.ManagedIdentitiesService
+
+types:
+- name: google.cloud.managedidentities.v1.OpMetadata
+
+documentation:
+  summary: |-
+    The Managed Service for Microsoft Active Directory API is used for managing
+    a highly available, hardened service running Microsoft Active Directory
+    (AD).
+  rules:
+  - selector: google.iam.v1.IAMPolicy.GetIamPolicy
+    description: |-
+      Gets the access control policy for a resource. Returns an empty policy
+      if the resource exists and does not have a policy set.
+
+  - selector: google.iam.v1.IAMPolicy.SetIamPolicy
+    description: |-
+      Sets the access control policy on the specified resource. Replaces
+      any existing policy.
+
+      Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and
+      PERMISSION_DENIED
+
+  - selector: google.iam.v1.IAMPolicy.TestIamPermissions
+    description: |-
+      Returns permissions that a caller has on the specified resource. If the
+      resource does not exist, this will return an empty set of
+      permissions, not a NOT_FOUND error.
+
+      Note: This operation is designed to be used for building
+      permission-aware UIs and command-line tools, not for authorization
+      checking. This operation may "fail open" without warning.
+
+backend:
+  rules:
+  - selector: 'google.cloud.managedidentities.v1.ManagedIdentitiesService.*'
+    deadline: 60.0
+  - selector: 'google.iam.v1.IAMPolicy.*'
+    deadline: 60.0
+  - selector: 'google.longrunning.Operations.*'
+    deadline: 60.0
+  - selector: google.longrunning.Operations.GetOperation
+    deadline: 5.0
+
+authentication:
+  rules:
+  - selector: 'google.cloud.managedidentities.v1.ManagedIdentitiesService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.iam.v1.IAMPolicy.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/managedidentities/v1/resource.proto b/third_party/googleapis/google/cloud/managedidentities/v1/resource.proto
new file mode 100644
index 000000000..8fc5f9384
--- /dev/null
+++ b/third_party/googleapis/google/cloud/managedidentities/v1/resource.proto
@@ -0,0 +1,211 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.managedidentities.v1;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.ManagedIdentities.V1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/managedidentities/v1;managedidentities";
+option java_multiple_files = true;
+option java_outer_classname = "ResourceProto";
+option java_package = "com.google.cloud.managedidentities.v1";
+
+// Represents a managed Microsoft Active Directory domain.
+message Domain {
+  option (google.api.resource) = {
+    type: "managedidentities.googleapis.com/Domain"
+    pattern: "projects/{project}/locations/{location}/domains/{domain}"
+  };
+
+  // Represents the different states of a managed domain.
+  enum State {
+    // Not set.
+    STATE_UNSPECIFIED = 0;
+
+    // The domain is being created.
+    CREATING = 1;
+
+    // The domain has been created and is fully usable.
+    READY = 2;
+
+    // The domain's configuration is being updated.
+    UPDATING = 3;
+
+    // The domain is being deleted.
+    DELETING = 4;
+
+    // The domain is being repaired and may be unusable. Details
+    // can be found in the `status_message` field.
+    REPAIRING = 5;
+
+    // The domain is undergoing maintenance.
+    PERFORMING_MAINTENANCE = 6;
+
+    // The domain is not serving requests.
+    UNAVAILABLE = 7;
+  }
+
+  // Required. The unique name of the domain using the form:
+  // `projects/{project_id}/locations/global/domains/{domain_name}`.
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Resource labels that can contain user-provided metadata.
+  map labels = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The full names of the Google Compute Engine
+  // [networks](/compute/docs/networks-and-firewalls#networks) the domain
+  // instance is connected to. Networks can be added using UpdateDomain.
+  // The domain is only available on networks listed in `authorized_networks`.
+  // If CIDR subnets overlap between networks, domain creation will fail.
+  repeated string authorized_networks = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. The CIDR range of internal addresses that are reserved for this
+  // domain. Reserved networks must be /24 or larger. Ranges must be
+  // unique and non-overlapping with existing subnets in
+  // [Domain].[authorized_networks].
+  string reserved_ip_range = 4 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Locations where domain needs to be provisioned.
+  // [regions][compute/docs/regions-zones/]
+  // e.g. us-west1 or us-east4
+  // Service supports up to 4 locations at once. Each location will use a /26
+  // block.
+  repeated string locations = 5 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The name of delegated administrator account used to perform
+  // Active Directory operations. If not specified, `setupadmin` will be used.
+  string admin = 6 [(google.api.field_behavior) = OPTIONAL];
+
+  // Output only. The fully-qualified domain name of the exposed domain used by
+  // clients to connect to the service. Similar to what would be chosen for an
+  // Active Directory set up on an internal network.
+  string fqdn = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The time the instance was created.
+  google.protobuf.Timestamp create_time = 11 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The last update time.
+  google.protobuf.Timestamp update_time = 12 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The current state of this domain.
+  State state = 13 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Additional information about the current status of this
+  // domain, if available.
+  string status_message = 14 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The current trusts associated with the domain.
+  repeated Trust trusts = 15 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// Represents a relationship between two domains. This allows a controller in
+// one domain to authenticate a user in another domain.
+message Trust {
+  // Represents the different states of a domain trust.
+  enum State {
+    // Not set.
+    STATE_UNSPECIFIED = 0;
+
+    // The domain trust is being created.
+    CREATING = 1;
+
+    // The domain trust is being updated.
+    UPDATING = 2;
+
+    // The domain trust is being deleted.
+    DELETING = 3;
+
+    // The domain trust is connected.
+    CONNECTED = 4;
+
+    // The domain trust is disconnected.
+    DISCONNECTED = 5;
+  }
+
+  // Represents the different inter-forest trust types.
+  enum TrustType {
+    // Not set.
+    TRUST_TYPE_UNSPECIFIED = 0;
+
+    // The forest trust.
+    FOREST = 1;
+
+    // The external domain trust.
+    EXTERNAL = 2;
+  }
+
+  // Represents the direction of trust.
+  // See
+  // [System.DirectoryServices.ActiveDirectory.TrustDirection](https://docs.microsoft.com/en-us/dotnet/api/system.directoryservices.activedirectory.trustdirection?view=netframework-4.7.2)
+  // for more information.
+  enum TrustDirection {
+    // Not set.
+    TRUST_DIRECTION_UNSPECIFIED = 0;
+
+    // The inbound direction represents the trusting side.
+    INBOUND = 1;
+
+    // The outboud direction represents the trusted side.
+    OUTBOUND = 2;
+
+    // The bidirectional direction represents the trusted / trusting side.
+    BIDIRECTIONAL = 3;
+  }
+
+  // Required. The fully qualified target domain name which will be in trust with the
+  // current domain.
+  string target_domain_name = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The type of trust represented by the trust resource.
+  TrustType trust_type = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The trust direction, which decides if the current domain is trusted,
+  // trusting, or both.
+  TrustDirection trust_direction = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The trust authentication type, which decides whether the trusted side has
+  // forest/domain wide access or selective access to an approved set of
+  // resources.
+  bool selective_authentication = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. The target DNS server IP addresses which can resolve the remote domain
+  // involved in the trust.
+  repeated string target_dns_ip_addresses = 5 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The trust secret used for the handshake with the target domain. This will
+  // not be stored.
+  string trust_handshake_secret = 6 [(google.api.field_behavior) = REQUIRED];
+
+  // Output only. The time the instance was created.
+  google.protobuf.Timestamp create_time = 7 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The last update time.
+  google.protobuf.Timestamp update_time = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The current state of the trust.
+  State state = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Additional information about the current state of the trust, if available.
+  string state_description = 11 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The last heartbeat time when the trust was known to be connected.
+  google.protobuf.Timestamp last_trust_heartbeat_time = 12 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
diff --git a/third_party/googleapis/google/cloud/managedidentities/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/managedidentities/v1beta1/BUILD.bazel
new file mode 100644
index 000000000..7d26d9b3d
--- /dev/null
+++ b/third_party/googleapis/google/cloud/managedidentities/v1beta1/BUILD.bazel
@@ -0,0 +1,366 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "managedidentities_proto",
+    srcs = [
+        "managed_identities_service.proto",
+        "resource.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "managedidentities_proto_with_info",
+    deps = [
+        ":managedidentities_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "managedidentities_java_proto",
+    deps = [":managedidentities_proto"],
+)
+
+java_grpc_library(
+    name = "managedidentities_java_grpc",
+    srcs = [":managedidentities_proto"],
+    deps = [":managedidentities_java_proto"],
+)
+
+java_gapic_library(
+    name = "managedidentities_java_gapic",
+    src = ":managedidentities_proto_with_info",
+    gapic_yaml = "managedidentities_gapic.yaml",
+    package = "google.cloud.managedidentities.v1beta1",
+    service_yaml = "managedidentities_v1beta1.yaml",
+    test_deps = [
+        ":managedidentities_java_grpc",
+    ],
+    deps = [
+        ":managedidentities_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "managedidentities_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.managedidentities.v1beta1.ManagedIdentitiesServiceClientTest",
+    ],
+    runtime_deps = [":managedidentities_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-managedidentities-v1beta1-java",
+    deps = [
+        ":managedidentities_java_gapic",
+        ":managedidentities_java_grpc",
+        ":managedidentities_java_proto",
+        ":managedidentities_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "managedidentities_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/managedidentities/v1beta1",
+    protos = [":managedidentities_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/longrunning:longrunning_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "managedidentities_go_gapic",
+    srcs = [":managedidentities_proto_with_info"],
+    grpc_service_config = "",
+    importpath = "cloud.google.com/go/managedidentities/apiv1beta1;managedidentities",
+    service_yaml = "managedidentities_v1beta1.yaml",
+    deps = [
+        ":managedidentities_go_proto",
+        "//google/longrunning:longrunning_go_gapic",
+        "//google/longrunning:longrunning_go_proto",
+        "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
+    ],
+)
+
+go_test(
+    name = "managedidentities_go_gapic_test",
+    srcs = [":managedidentities_go_gapic_srcjar_test"],
+    embed = [":managedidentities_go_gapic"],
+    importpath = "cloud.google.com/go/managedidentities/apiv1beta1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-managedidentities-v1beta1-go",
+    deps = [
+        ":managedidentities_go_gapic",
+        ":managedidentities_go_gapic_srcjar-test.srcjar",
+        ":managedidentities_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "managedidentities_moved_proto",
+    srcs = [":managedidentities_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "managedidentities_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":managedidentities_moved_proto"],
+)
+
+py_grpc_library(
+    name = "managedidentities_py_grpc",
+    srcs = [":managedidentities_moved_proto"],
+    deps = [":managedidentities_py_proto"],
+)
+
+py_gapic_library(
+    name = "managedidentities_py_gapic",
+    src = ":managedidentities_proto_with_info",
+    gapic_yaml = "managedidentities_gapic.yaml",
+    package = "google.cloud.managedidentities.v1beta1",
+    service_yaml = "managedidentities_v1beta1.yaml",
+    deps = [
+        ":managedidentities_py_grpc",
+        ":managedidentities_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "managedidentities-v1beta1-py",
+    deps = [
+        ":managedidentities_py_gapic",
+        ":managedidentities_py_grpc",
+        ":managedidentities_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "managedidentities_php_proto",
+    deps = [":managedidentities_proto"],
+)
+
+php_grpc_library(
+    name = "managedidentities_php_grpc",
+    srcs = [":managedidentities_proto"],
+    deps = [":managedidentities_php_proto"],
+)
+
+php_gapic_library(
+    name = "managedidentities_php_gapic",
+    src = ":managedidentities_proto_with_info",
+    gapic_yaml = "managedidentities_gapic.yaml",
+    package = "google.cloud.managedidentities.v1beta1",
+    service_yaml = "managedidentities_v1beta1.yaml",
+    deps = [
+        ":managedidentities_php_grpc",
+        ":managedidentities_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-managedidentities-v1beta1-php",
+    deps = [
+        ":managedidentities_php_gapic",
+        ":managedidentities_php_grpc",
+        ":managedidentities_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "managedidentities_nodejs_gapic",
+    src = ":managedidentities_proto_with_info",
+    gapic_yaml = "managedidentities_gapic.yaml",
+    package = "google.cloud.managedidentities.v1beta1",
+    service_yaml = "managedidentities_v1beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "managedidentities-v1beta1-nodejs",
+    deps = [
+        ":managedidentities_nodejs_gapic",
+        ":managedidentities_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "managedidentities_ruby_proto",
+    deps = [":managedidentities_proto"],
+)
+
+ruby_grpc_library(
+    name = "managedidentities_ruby_grpc",
+    srcs = [":managedidentities_proto"],
+    deps = [":managedidentities_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "managedidentities_ruby_gapic",
+    src = ":managedidentities_proto_with_info",
+    gapic_yaml = "managedidentities_gapic.yaml",
+    package = "google.cloud.managedidentities.v1beta1",
+    service_yaml = "managedidentities_v1beta1.yaml",
+    deps = [
+        ":managedidentities_ruby_grpc",
+        ":managedidentities_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-managedidentities-v1beta1-ruby",
+    deps = [
+        ":managedidentities_ruby_gapic",
+        ":managedidentities_ruby_grpc",
+        ":managedidentities_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "managedidentities_csharp_proto",
+    deps = [":managedidentities_proto"],
+)
+
+csharp_grpc_library(
+    name = "managedidentities_csharp_grpc",
+    srcs = [":managedidentities_proto"],
+    deps = [":managedidentities_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "managedidentities_csharp_gapic",
+    src = ":managedidentities_proto_with_info",
+    gapic_yaml = "managedidentities_gapic.yaml",
+    package = "google.cloud.managedidentities.v1beta1",
+    service_yaml = "managedidentities_v1beta1.yaml",
+    deps = [
+        ":managedidentities_csharp_grpc",
+        ":managedidentities_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-managedidentities-v1beta1-csharp",
+    deps = [
+        ":managedidentities_csharp_gapic",
+        ":managedidentities_csharp_grpc",
+        ":managedidentities_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/managedidentities/v1beta1/artman_managedidentities_v1beta1.yaml b/third_party/googleapis/google/cloud/managedidentities/v1beta1/artman_managedidentities_v1beta1.yaml
new file mode 100644
index 000000000..3b1ef2d30
--- /dev/null
+++ b/third_party/googleapis/google/cloud/managedidentities/v1beta1/artman_managedidentities_v1beta1.yaml
@@ -0,0 +1,34 @@
+common:
+  api_name: managedidentities
+  api_version: v1beta1
+  organization_name: google-cloud
+  proto_deps:
+  - name: google-common-protos
+  src_proto_paths:
+  - .
+  service_yaml: managedidentities_v1beta1.yaml
+  gapic_yaml: managedidentities_gapic.yaml
+artifacts:
+- name: gapic_config
+  type: GAPIC_CONFIG
+- name: java_gapic
+  type: GAPIC
+  language: JAVA
+- name: python_gapic
+  type: GAPIC
+  language: PYTHON
+- name: nodejs_gapic
+  type: GAPIC
+  language: NODEJS
+- name: php_gapic
+  type: GAPIC
+  language: PHP
+- name: go_gapic
+  type: GAPIC
+  language: GO
+- name: ruby_gapic
+  type: GAPIC
+  language: RUBY
+- name: csharp_gapic
+  type: GAPIC
+  language: CSHARP
diff --git a/third_party/googleapis/google/cloud/managedidentities/v1beta1/managed_identities_service.proto b/third_party/googleapis/google/cloud/managedidentities/v1beta1/managed_identities_service.proto
new file mode 100644
index 000000000..e67e55e47
--- /dev/null
+++ b/third_party/googleapis/google/cloud/managedidentities/v1beta1/managed_identities_service.proto
@@ -0,0 +1,332 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.managedidentities.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/cloud/managedidentities/v1beta1/resource.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/client.proto";
+
+option csharp_namespace = "Google.Cloud.ManagedIdentities.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/managedidentities/v1beta1;managedidentities";
+option java_multiple_files = true;
+option java_outer_classname = "ManagedIdentitiesServiceProto";
+option java_package = "com.google.cloud.managedidentities.v1beta1";
+option objc_class_prefix = "GCMI";
+option php_namespace = "Google\\Cloud\\ManagedIdentities\\V1beta1";
+
+service ManagedIdentitiesService {
+  option (google.api.default_host) = "managedidentities.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // Creates a Microsoft AD domain.
+  rpc CreateMicrosoftAdDomain(CreateMicrosoftAdDomainRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/locations/global}/domains"
+      body: "domain"
+    };
+    option (google.longrunning.operation_info) = {
+      response_type: "Domain"
+      metadata_type: "OpMetadata"
+    };
+  }
+
+  // Resets a domain's administrator password.
+  rpc ResetAdminPassword(ResetAdminPasswordRequest) returns (ResetAdminPasswordResponse) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/global/domains/*}:resetAdminPassword"
+      body: "*"
+    };
+  }
+
+  // Lists domains in a project.
+  rpc ListDomains(ListDomainsRequest) returns (ListDomainsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/locations/global}/domains"
+    };
+  }
+
+  // Gets information about a domain.
+  rpc GetDomain(GetDomainRequest) returns (Domain) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/locations/global/domains/*}"
+    };
+  }
+
+  // Updates the metadata and configuration of a domain.
+  rpc UpdateDomain(UpdateDomainRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      patch: "/v1beta1/{domain.name=projects/*/locations/global/domains/*}"
+      body: "domain"
+    };
+    option (google.longrunning.operation_info) = {
+      response_type: "Domain"
+      metadata_type: "OpMetadata"
+    };
+  }
+
+  // Deletes a domain.
+  rpc DeleteDomain(DeleteDomainRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/locations/global/domains/*}"
+    };
+    option (google.longrunning.operation_info) = {
+      response_type: "google.protobuf.Empty"
+      metadata_type: "OpMetadata"
+    };
+  }
+
+  // Adds an AD trust to a domain.
+  rpc AttachTrust(AttachTrustRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/global/domains/*}:attachTrust"
+      body: "*"
+    };
+    option (google.longrunning.operation_info) = {
+      response_type: "Domain"
+      metadata_type: "OpMetadata"
+    };
+  }
+
+  // Updates the DNS conditional forwarder.
+  rpc ReconfigureTrust(ReconfigureTrustRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/global/domains/*}:reconfigureTrust"
+      body: "*"
+    };
+    option (google.longrunning.operation_info) = {
+      response_type: "Domain"
+      metadata_type: "OpMetadata"
+    };
+  }
+
+  // Removes an AD trust.
+  rpc DetachTrust(DetachTrustRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/global/domains/*}:detachTrust"
+      body: "*"
+    };
+    option (google.longrunning.operation_info) = {
+      response_type: "Domain"
+      metadata_type: "OpMetadata"
+    };
+  }
+
+  // Validates a trust state, that the target domain is reachable, and that the
+  // target domain is able to accept incoming trust requests.
+  rpc ValidateTrust(ValidateTrustRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/global/domains/*}:validateTrust"
+      body: "*"
+    };
+    option (google.longrunning.operation_info) = {
+      response_type: "Domain"
+      metadata_type: "OpMetadata"
+    };
+  }
+}
+
+// Represents the metadata of the long-running operation.
+message OpMetadata {
+  // Output only. The time the operation was created.
+  google.protobuf.Timestamp create_time = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The time the operation finished running.
+  google.protobuf.Timestamp end_time = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Server-defined resource path for the target of the operation.
+  string target = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Name of the verb executed by the operation.
+  string verb = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Identifies whether the user has requested cancellation
+  // of the operation. Operations that have successfully been cancelled
+  // have [Operation.error][] value with a [google.rpc.Status.code][google.rpc.Status.code] of 1,
+  // corresponding to `Code.CANCELLED`.
+  bool requested_cancellation = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. API version used to start the operation.
+  string api_version = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// Request message for
+// [CreateMicrosoftAdDomain][google.cloud.managedidentities.v1beta1.CreateMicrosoftAdDomain]
+message CreateMicrosoftAdDomainRequest {
+  // The resource project name and location using the form:
+  // `projects/{project_id}/locations/global`
+  string parent = 1;
+
+  // A domain name, e.g. mydomain.myorg.com, with the following restrictions:
+  //  * Must contain only lowercase letters, numbers, periods and hyphens.
+  //  * Must start with a letter.
+  //  * Must contain between 2-64 characters.
+  //  * Must end with a number or a letter.
+  //  * Must not start with period.
+  //  * First segement length (mydomain form example above) shouldn't exceed
+  //    15 chars.
+  //  * The last segment cannot be fully numeric.
+  //  * Must be unique within the customer project.
+  string domain_name = 2;
+
+  // A Managed Identity domain resource.
+  Domain domain = 3;
+}
+
+// Request message for
+// [ResetAdminPassword][google.cloud.managedidentities.v1beta1.ResetAdminPassword]
+message ResetAdminPasswordRequest {
+  // The domain resource name using the form:
+  // `projects/{project_id}/locations/global/domains/{domain_name}`
+  string name = 1;
+}
+
+// Response message for
+// [ResetAdminPassword][google.cloud.managedidentities.v1beta1.ResetAdminPassword]
+message ResetAdminPasswordResponse {
+  // A random password. See [admin][google.cloud.managedidentities.v1beta1.Domain.admin] for more information.
+  string password = 1;
+}
+
+// Request message for
+// [ListDomains][google.cloud.managedidentities.v1beta1.ListDomains]
+message ListDomainsRequest {
+  // Required. The resource name of the domain location using the form:
+  // `projects/{project_id}/locations/global`
+  string parent = 1;
+
+  // Optional. The maximum number of items to return.
+  // If not specified, a default value of 1000 will be used.
+  // Regardless of the page_size value, the response may include a partial list.
+  // Callers should rely on a response's
+  // [next_page_token][google.cloud.managedidentities.v1beta1.ListDomainsResponse.next_page_token]
+  // to determine if there are additional results to list.
+  int32 page_size = 2;
+
+  // The `next_page_token` value returned from a previous ListDomainsRequest
+  // request, if any.
+  string page_token = 3;
+
+  // Optional. A filter specifying constraints of a list operation.
+  // For example, `Domain.fqdn="mydomain.myorginization"`.
+  string filter = 4;
+
+  // Optional. Specifies the ordering of results. See
+  // [Sorting
+  // order](https://cloud.google.com/apis/design/design_patterns#sorting_order)
+  // for more information.
+  string order_by = 5;
+}
+
+// Response message for
+// [ListDomains][google.cloud.managedidentities.v1beta1.ListDomains]
+message ListDomainsResponse {
+  // A list of Managed Identities Service domains in the project.
+  repeated Domain domains = 1;
+
+  // A token to retrieve the next page of results, or empty if there are no more
+  // results in the list.
+  string next_page_token = 2;
+
+  // A list of locations that could not be reached.
+  repeated string unreachable = 3;
+}
+
+// Request message for
+// [GetDomain][google.cloud.managedidentities.v1beta1.GetDomain]
+message GetDomainRequest {
+  // The domain resource name using the form:
+  // `projects/{project_id}/locations/global/domains/{domain_name}`
+  string name = 1;
+}
+
+// Request message for
+// [UpdateDomain][google.cloud.managedidentities.v1beta1.UpdateDomain]
+message UpdateDomainRequest {
+  // Mask of fields to update. At least one path must be supplied in this
+  // field. The elements of the repeated paths field may only include
+  // fields from [Domain][google.cloud.managedidentities.v1beta1.Domain]:
+  //  * `labels`
+  //  * `locations`
+  //  * `authorized_networks`
+  google.protobuf.FieldMask update_mask = 1;
+
+  // Domain message with updated fields. Only supported fields specified in
+  // update_mask are updated.
+  Domain domain = 2;
+}
+
+// Request message for
+// [DeleteDomain][google.cloud.managedidentities.v1beta1.DeleteDomain]
+message DeleteDomainRequest {
+  // The domain resource name using the form:
+  // `projects/{project_id}/locations/global/domains/{domain_name}`
+  string name = 1;
+}
+
+// Request message for
+// [AttachTrust][google.cloud.managedidentities.v1beta1.AttachTrust]
+message AttachTrustRequest {
+  // The resource domain name, project name and location using the form:
+  // `projects/{project_id}/locations/global/domains/{domain_name}`
+  string name = 1;
+
+  // The domain trust resource.
+  Trust trust = 2;
+}
+
+// Request message for
+// [ReconfigureTrust][google.cloud.managedidentities.v1beta1.ReconfigureTrust]
+message ReconfigureTrustRequest {
+  // The resource domain name, project name and location using the form:
+  // `projects/{project_id}/locations/global/domains/{domain_name}`
+  string name = 1;
+
+  // The fully-qualified target domain name which will be in trust with current
+  // domain.
+  string target_domain_name = 2;
+
+  // The target DNS server IP addresses to resolve the remote domain involved
+  // in the trust.
+  repeated string target_dns_ip_addresses = 3;
+}
+
+// Request message for
+// [DetachTrust][google.cloud.managedidentities.v1beta1.DetachTrust]
+message DetachTrustRequest {
+  // The resource domain name, project name, and location using the form:
+  // `projects/{project_id}/locations/global/domains/{domain_name}`
+  string name = 1;
+
+  // The domain trust resource to removed.
+  Trust trust = 2;
+}
+
+// Request message for
+// [ValidateTrust][google.cloud.managedidentities.v1beta1.ValidateTrust]
+message ValidateTrustRequest {
+  // The resource domain name, project name, and location using the form:
+  // `projects/{project_id}/locations/global/domains/{domain_name}`
+  string name = 1;
+
+  // The domain trust to validate trust state for.
+  Trust trust = 2;
+}
diff --git a/third_party/googleapis/google/cloud/managedidentities/v1beta1/managedidentities_gapic.legacy.yaml b/third_party/googleapis/google/cloud/managedidentities/v1beta1/managedidentities_gapic.legacy.yaml
new file mode 100644
index 000000000..7c234ad3c
--- /dev/null
+++ b/third_party/googleapis/google/cloud/managedidentities/v1beta1/managedidentities_gapic.legacy.yaml
@@ -0,0 +1,295 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.managedidentities.v1beta1
+  python:
+    package_name: google.cloud.managedidentities_v1beta1.gapic
+  go:
+    package_name: cloud.google.com/go/managedidentities/apiv1beta1
+  csharp:
+    package_name: Google.Cloud.Managedidentities.V1Beta1
+  ruby:
+    package_name: Google::Cloud::Managedidentities::V1beta1
+  php:
+    package_name: Google\Cloud\Managedidentities\V1beta1
+  nodejs:
+    package_name: managedidentities.v1beta1
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: google.cloud.managedidentities.v1beta1.ManagedIdentitiesService
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}/locations/global
+    entity_name: project_locations
+  - name_pattern: projects/{project}/locations/global/domains/{domain}
+    entity_name: domain
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: CreateMicrosoftAdDomain
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - domain_name
+        - domain
+    required_fields:
+    - parent
+    - domain_name
+    - domain
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project_locations
+    long_running:
+      return_type: google.cloud.managedidentities.v1beta1.Domain
+      metadata_type: google.cloud.managedidentities.v1beta1.OpMetadata
+      initial_poll_delay_millis: 60000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 360000
+      total_poll_timeout_millis: 54000000
+    timeout_millis: 60000
+  - name: ResetAdminPassword
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: domain
+    timeout_millis: 60000
+  - name: ListDomains
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - filter
+        - order_by
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: domains
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project_locations
+    timeout_millis: 60000
+  - name: GetDomain
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: domain
+    timeout_millis: 60000
+  - name: UpdateDomain
+    flattening:
+      groups:
+      - parameters:
+        - domain
+        - update_mask
+    required_fields:
+    - domain
+    - update_mask
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      domain.name: domain
+    long_running:
+      return_type: google.cloud.managedidentities.v1beta1.Domain
+      metadata_type: google.cloud.managedidentities.v1beta1.OpMetadata
+      initial_poll_delay_millis: 60000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 360000
+      total_poll_timeout_millis: 54000000
+    timeout_millis: 60000
+  - name: DeleteDomain
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: domain
+    long_running:
+      return_type: google.protobuf.Empty
+      metadata_type: google.cloud.managedidentities.v1beta1.OpMetadata
+      initial_poll_delay_millis: 10000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 60000
+      total_poll_timeout_millis: 900000
+    timeout_millis: 60000
+  - name: AttachTrust
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - trust
+    required_fields:
+    - name
+    - trust
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: domain
+    long_running:
+      return_type: google.cloud.managedidentities.v1beta1.Domain
+      metadata_type: google.cloud.managedidentities.v1beta1.OpMetadata
+      initial_poll_delay_millis: 10000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 60000
+      total_poll_timeout_millis: 600000
+    timeout_millis: 60000
+  - name: ReconfigureTrust
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - target_domain_name
+        - target_dns_ip_addresses
+    required_fields:
+    - name
+    - target_domain_name
+    - target_dns_ip_addresses
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: domain
+    long_running:
+      return_type: google.cloud.managedidentities.v1beta1.Domain
+      metadata_type: google.cloud.managedidentities.v1beta1.OpMetadata
+      initial_poll_delay_millis: 10000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 60000
+      total_poll_timeout_millis: 600000
+    timeout_millis: 60000
+  - name: DetachTrust
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - trust
+    required_fields:
+    - name
+    - trust
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: domain
+    long_running:
+      return_type: google.cloud.managedidentities.v1beta1.Domain
+      metadata_type: google.cloud.managedidentities.v1beta1.OpMetadata
+      initial_poll_delay_millis: 10000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 60000
+      total_poll_timeout_millis: 600000
+    timeout_millis: 60000
+  - name: ValidateTrust
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - trust
+    required_fields:
+    - name
+    - trust
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: domain
+    long_running:
+      return_type: google.cloud.managedidentities.v1beta1.Domain
+      metadata_type: google.cloud.managedidentities.v1beta1.OpMetadata
+      initial_poll_delay_millis: 10000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 60000
+      total_poll_timeout_millis: 600000
+    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/managedidentities/v1beta1/managedidentities_gapic.yaml b/third_party/googleapis/google/cloud/managedidentities/v1beta1/managedidentities_gapic.yaml
new file mode 100644
index 000000000..7134da6f1
--- /dev/null
+++ b/third_party/googleapis/google/cloud/managedidentities/v1beta1/managedidentities_gapic.yaml
@@ -0,0 +1,35 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 2.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.managedidentities.v1beta1
+  python:
+    package_name: google.cloud.managedidentities_v1beta1.gapic
+  go:
+    package_name: cloud.google.com/go/managedidentities/apiv1beta1
+  csharp:
+    package_name: Google.Cloud.Managedidentities.V1Beta1
+  ruby:
+    package_name: Google::Cloud::Managedidentities::V1beta1
+  php:
+    package_name: Google\Cloud\Managedidentities\V1beta1
+  nodejs:
+    package_name: managedidentities.v1beta1
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: google.cloud.managedidentities.v1beta1.ManagedIdentitiesService
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  methods:
+  - name: DeleteDomain
+    retry_codes_name: idempotent
diff --git a/third_party/googleapis/google/cloud/managedidentities/v1beta1/managedidentities_v1beta1.yaml b/third_party/googleapis/google/cloud/managedidentities/v1beta1/managedidentities_v1beta1.yaml
new file mode 100644
index 000000000..464c64f17
--- /dev/null
+++ b/third_party/googleapis/google/cloud/managedidentities/v1beta1/managedidentities_v1beta1.yaml
@@ -0,0 +1,65 @@
+type: google.api.Service
+config_version: 3
+name: managedidentities.googleapis.com
+title: Managed Service for Microsoft Active Directory API
+
+apis:
+- name: google.cloud.managedidentities.v1beta1.ManagedIdentitiesService
+
+types:
+- name: google.cloud.managedidentities.v1beta1.OpMetadata
+
+documentation:
+  summary: |-
+    The Managed Service for Microsoft Active Directory API is used for managing
+    a highly available, hardened service running Microsoft Active Directory
+    (AD).
+  rules:
+  - selector: google.iam.v1.IAMPolicy.GetIamPolicy
+    description: |-
+      Gets the access control policy for a resource. Returns an empty policy
+      if the resource exists and does not have a policy set.
+
+  - selector: google.iam.v1.IAMPolicy.SetIamPolicy
+    description: |-
+      Sets the access control policy on the specified resource. Replaces
+      any existing policy.
+
+      Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and
+      PERMISSION_DENIED
+
+  - selector: google.iam.v1.IAMPolicy.TestIamPermissions
+    description: |-
+      Returns permissions that a caller has on the specified resource. If the
+      resource does not exist, this will return an empty set of
+      permissions, not a NOT_FOUND error.
+
+      Note: This operation is designed to be used for building
+      permission-aware UIs and command-line tools, not for authorization
+      checking. This operation may "fail open" without warning.
+
+backend:
+  rules:
+  - selector: 'google.cloud.managedidentities.v1beta1.ManagedIdentitiesService.*'
+    deadline: 60.0
+  - selector: 'google.iam.v1.IAMPolicy.*'
+    deadline: 60.0
+  - selector: 'google.longrunning.Operations.*'
+    deadline: 60.0
+  - selector: google.longrunning.Operations.GetOperation
+    deadline: 5.0
+
+authentication:
+  rules:
+  - selector: 'google.cloud.managedidentities.v1beta1.ManagedIdentitiesService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.iam.v1.IAMPolicy.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/managedidentities/v1beta1/resource.proto b/third_party/googleapis/google/cloud/managedidentities/v1beta1/resource.proto
new file mode 100644
index 000000000..deee9eb82
--- /dev/null
+++ b/third_party/googleapis/google/cloud/managedidentities/v1beta1/resource.proto
@@ -0,0 +1,206 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.managedidentities.v1beta1;
+
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.ManagedIdentities.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/managedidentities/v1beta1;managedidentities";
+option java_multiple_files = true;
+option java_outer_classname = "ResourceProto";
+option java_package = "com.google.cloud.managedidentities.v1beta1";
+
+// Represents a managed Microsoft Active Directory domain.
+message Domain {
+  // Represents the different states of a managed domain.
+  enum State {
+    // Not set.
+    STATE_UNSPECIFIED = 0;
+
+    // The domain is being created.
+    CREATING = 1;
+
+    // The domain has been created and is fully usable.
+    READY = 2;
+
+    // The domain's configuration is being updated.
+    UPDATING = 3;
+
+    // The domain is being deleted.
+    DELETING = 4;
+
+    // The domain is being repaired and may be unusable. Details
+    // can be found in the `status_message` field.
+    REPAIRING = 5;
+
+    // The domain is undergoing maintenance.
+    PERFORMING_MAINTENANCE = 6;
+
+    // The domain is not serving requests.
+    UNAVAILABLE = 7;
+  }
+
+  // Output only. The unique name of the domain using the form:
+  // `projects/{project_id}/locations/global/domains/{domain_name}`.
+  string name = 1;
+
+  // Optional. Resource labels that can contain user-provided metadata.
+  map labels = 2;
+
+  // Optional. The full names of the Google Compute Engine
+  // [networks](/compute/docs/networks-and-firewalls#networks) the domain
+  // instance is connected to. Networks can be added using UpdateDomain.
+  // The domain is only available on networks listed in `authorized_networks`.
+  // If CIDR subnets overlap between networks, domain creation will fail.
+  repeated string authorized_networks = 3;
+
+  // Required. The CIDR range of internal addresses that are reserved for this
+  // domain. Reserved networks must be /24 or larger. Ranges must be
+  // unique and non-overlapping with existing subnets in
+  // [Domain].[authorized_networks].
+  string reserved_ip_range = 4;
+
+  // Required. Locations where domain needs to be provisioned.
+  // [regions][compute/docs/regions-zones/]
+  // e.g. us-west1 or us-east4
+  // Service supports up to 4 locations at once. Each location will use a /26
+  // block.
+  repeated string locations = 5;
+
+  // Optional. The name of delegated administrator account used to perform
+  // Active Directory operations. If not specified, `setupadmin` will be used.
+  string admin = 6;
+
+  // Output only. The fully-qualified domain name of the exposed domain used by
+  // clients to connect to the service. Similar to what would be chosen for an
+  // Active Directory set up on an internal network.
+  string fqdn = 10;
+
+  // Output only. The time the instance was created.
+  google.protobuf.Timestamp create_time = 11;
+
+  // Output only. The last update time.
+  google.protobuf.Timestamp update_time = 12;
+
+  // Output only. The current state of this domain.
+  State state = 13;
+
+  // Output only. Additional information about the current status of this
+  // domain, if available.
+  string status_message = 14;
+
+  // Output only. The current trusts associated with the domain.
+  repeated Trust trusts = 15;
+}
+
+// Represents a relationship between two domains. This allows a controller in
+// one domain to authenticate a user in another domain.
+message Trust {
+  // Represents the different states of a domain trust.
+  enum State {
+    // Not set.
+    STATE_UNSPECIFIED = 0;
+
+    // The domain trust is being created.
+    CREATING = 1;
+
+    // The domain trust is being updated.
+    UPDATING = 2;
+
+    // The domain trust is being deleted.
+    DELETING = 3;
+
+    // The domain trust is connected.
+    CONNECTED = 4;
+
+    // The domain trust is disconnected.
+    DISCONNECTED = 5;
+  }
+
+  // Represents the different inter-forest trust types.
+  enum TrustType {
+    // Not set.
+    TRUST_TYPE_UNSPECIFIED = 0;
+
+    // The forest trust.
+    FOREST = 1;
+
+    // The external domain trust.
+    EXTERNAL = 2;
+  }
+
+  // Represents the direction of trust.
+  // See
+  // [System.DirectoryServices.ActiveDirectory.TrustDirection](https://docs.microsoft.com/en-us/dotnet/api/system.directoryservices.activedirectory.trustdirection?view=netframework-4.7.2)
+  // for more information.
+  enum TrustDirection {
+    // Not set.
+    TRUST_DIRECTION_UNSPECIFIED = 0;
+
+    // The inbound direction represents the trusting side.
+    INBOUND = 1;
+
+    // The outboud direction represents the trusted side.
+    OUTBOUND = 2;
+
+    // The bidirectional direction represents the trusted / trusting side.
+    BIDIRECTIONAL = 3;
+  }
+
+  // The fully qualified target domain name which will be in trust with the
+  // current domain.
+  string target_domain_name = 1;
+
+  // The type of trust represented by the trust resource.
+  TrustType trust_type = 2;
+
+  // The trust direction, which decides if the current domain is trusted,
+  // trusting, or both.
+  TrustDirection trust_direction = 3;
+
+  // The trust authentication type, which decides whether the trusted side has
+  // forest/domain wide access or selective access to an approved set of
+  // resources.
+  bool selective_authentication = 4;
+
+  // The target DNS server IP addresses which can resolve the remote domain
+  // involved in the trust.
+  repeated string target_dns_ip_addresses = 5;
+
+  // Input only, and will not be stored. The trust secret used for the handshake
+  // with the target domain.
+  string trust_handshake_secret = 6;
+
+  // Output only. The time the instance was created.
+  google.protobuf.Timestamp create_time = 7;
+
+  // Output only. The last update time.
+  google.protobuf.Timestamp update_time = 8;
+
+  // Output only. The current state of the trust.
+  State state = 9;
+
+  // Output only. Additional information about the current state of the
+  // trust, if available.
+  string state_description = 11;
+
+  // Output only. The last heartbeat time when the trust was known to be
+  // connected.
+  google.protobuf.Timestamp last_trust_heartbeat_time = 12;
+}
diff --git a/third_party/googleapis/google/cloud/mediatranslation/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/mediatranslation/v1beta1/BUILD.bazel
new file mode 100644
index 000000000..4ccba1e41
--- /dev/null
+++ b/third_party/googleapis/google/cloud/mediatranslation/v1beta1/BUILD.bazel
@@ -0,0 +1,355 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "mediatranslation_proto",
+    srcs = [
+        "media_translation.proto",
+    ],
+    deps = [
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/rpc:status_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "mediatranslation_proto_with_info",
+    deps = [
+        ":mediatranslation_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "mediatranslation_java_proto",
+    deps = [":mediatranslation_proto"],
+)
+
+java_grpc_library(
+    name = "mediatranslation_java_grpc",
+    srcs = [":mediatranslation_proto"],
+    deps = [":mediatranslation_java_proto"],
+)
+
+java_gapic_library(
+    name = "mediatranslation_java_gapic",
+    src = ":mediatranslation_proto_with_info",
+    gapic_yaml = "mediatranslation_gapic.yaml",
+    package = "google.cloud.mediatranslation.v1beta1",
+    service_yaml = "mediatranslation_v1beta1.yaml",
+    test_deps = [
+        ":mediatranslation_java_grpc",
+    ],
+    deps = [
+        ":mediatranslation_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "mediatranslation_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.mediatranslation.v1beta1.SpeechTranslationServiceClientTest",
+    ],
+    runtime_deps = [":mediatranslation_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-mediatranslation-v1beta1-java",
+    deps = [
+        ":mediatranslation_java_gapic",
+        ":mediatranslation_java_grpc",
+        ":mediatranslation_java_proto",
+        ":mediatranslation_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "mediatranslation_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/mediatranslation/v1beta1",
+    protos = [":mediatranslation_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/rpc:status_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "mediatranslation_go_gapic",
+    srcs = [":mediatranslation_proto_with_info"],
+    grpc_service_config = "mediatranslation_grpc_service_config.json",
+    importpath = "cloud.google.com/go/mediatranslation/apiv1beta1;mediatranslation",
+    service_yaml = "mediatranslation_v1beta1.yaml",
+    deps = [
+        ":mediatranslation_go_proto",
+    ],
+)
+
+go_test(
+    name = "mediatranslation_go_gapic_test",
+    srcs = [":mediatranslation_go_gapic_srcjar_test"],
+    embed = [":mediatranslation_go_gapic"],
+    importpath = "cloud.google.com/go/mediatranslation/apiv1beta1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-mediatranslation-v1beta1-go",
+    deps = [
+        ":mediatranslation_go_gapic",
+        ":mediatranslation_go_gapic_srcjar-test.srcjar",
+        ":mediatranslation_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "mediatranslation_moved_proto",
+    srcs = [":mediatranslation_proto"],
+    deps = [
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/rpc:status_proto",
+    ],
+)
+
+py_proto_library(
+    name = "mediatranslation_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":mediatranslation_moved_proto"],
+)
+
+py_grpc_library(
+    name = "mediatranslation_py_grpc",
+    srcs = [":mediatranslation_moved_proto"],
+    deps = [":mediatranslation_py_proto"],
+)
+
+py_gapic_library(
+    name = "mediatranslation_py_gapic",
+    src = ":mediatranslation_proto_with_info",
+    gapic_yaml = "mediatranslation_gapic.yaml",
+    package = "google.cloud.mediatranslation.v1beta1",
+    service_yaml = "mediatranslation_v1beta1.yaml",
+    deps = [
+        ":mediatranslation_py_grpc",
+        ":mediatranslation_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "mediatranslation-v1beta1-py",
+    deps = [
+        ":mediatranslation_py_gapic",
+        ":mediatranslation_py_grpc",
+        ":mediatranslation_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "mediatranslation_php_proto",
+    deps = [":mediatranslation_proto"],
+)
+
+php_grpc_library(
+    name = "mediatranslation_php_grpc",
+    srcs = [":mediatranslation_proto"],
+    deps = [":mediatranslation_php_proto"],
+)
+
+php_gapic_library(
+    name = "mediatranslation_php_gapic",
+    src = ":mediatranslation_proto_with_info",
+    gapic_yaml = "mediatranslation_gapic.yaml",
+    package = "google.cloud.mediatranslation.v1beta1",
+    service_yaml = "mediatranslation_v1beta1.yaml",
+    deps = [
+        ":mediatranslation_php_grpc",
+        ":mediatranslation_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-mediatranslation-v1beta1-php",
+    deps = [
+        ":mediatranslation_php_gapic",
+        ":mediatranslation_php_grpc",
+        ":mediatranslation_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "mediatranslation_nodejs_gapic",
+    src = ":mediatranslation_proto_with_info",
+    gapic_yaml = "mediatranslation_gapic.yaml",
+    package = "google.cloud.mediatranslation.v1beta1",
+    service_yaml = "mediatranslation_v1beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "mediatranslation-v1beta1-nodejs",
+    deps = [
+        ":mediatranslation_nodejs_gapic",
+        ":mediatranslation_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "mediatranslation_ruby_proto",
+    deps = [":mediatranslation_proto"],
+)
+
+ruby_grpc_library(
+    name = "mediatranslation_ruby_grpc",
+    srcs = [":mediatranslation_proto"],
+    deps = [":mediatranslation_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "mediatranslation_ruby_gapic",
+    src = ":mediatranslation_proto_with_info",
+    gapic_yaml = "mediatranslation_gapic.yaml",
+    package = "google.cloud.mediatranslation.v1beta1",
+    service_yaml = "mediatranslation_v1beta1.yaml",
+    deps = [
+        ":mediatranslation_ruby_grpc",
+        ":mediatranslation_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-mediatranslation-v1beta1-ruby",
+    deps = [
+        ":mediatranslation_ruby_gapic",
+        ":mediatranslation_ruby_grpc",
+        ":mediatranslation_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "mediatranslation_csharp_proto",
+    deps = [":mediatranslation_proto"],
+)
+
+csharp_grpc_library(
+    name = "mediatranslation_csharp_grpc",
+    srcs = [":mediatranslation_proto"],
+    deps = [":mediatranslation_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "mediatranslation_csharp_gapic",
+    src = ":mediatranslation_proto_with_info",
+    gapic_yaml = "mediatranslation_gapic.yaml",
+    package = "google.cloud.mediatranslation.v1beta1",
+    service_yaml = "mediatranslation_v1beta1.yaml",
+    deps = [
+        ":mediatranslation_csharp_grpc",
+        ":mediatranslation_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-mediatranslation-v1beta1-csharp",
+    deps = [
+        ":mediatranslation_csharp_gapic",
+        ":mediatranslation_csharp_grpc",
+        ":mediatranslation_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/mediatranslation/v1beta1/media_translation.proto b/third_party/googleapis/google/cloud/mediatranslation/v1beta1/media_translation.proto
new file mode 100644
index 000000000..88eed82ab
--- /dev/null
+++ b/third_party/googleapis/google/cloud/mediatranslation/v1beta1/media_translation.proto
@@ -0,0 +1,197 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.mediatranslation.v1beta1;
+
+import "google/api/field_behavior.proto";
+import "google/rpc/status.proto";
+import "google/api/client.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/mediatranslation/v1beta1;mediatranslation";
+option java_multiple_files = true;
+option java_outer_classname = "MediaTranslationProto";
+option java_package = "com.google.cloud.mediatranslation.v1beta1";
+option csharp_namespace = "Google.Cloud.MediaTranslation.V1Beta1";
+option ruby_package = "Google::Cloud::MediaTranslation::V1beta1";
+option php_namespace = "Google\\Cloud\\MediaTranslation\\V1beta1";
+
+// Provides translation from/to media types.
+service SpeechTranslationService {
+  option (google.api.default_host) = "mediatranslation.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // Performs bidirectional streaming speech translation: receive results while
+  // sending audio. This method is only available via the gRPC API (not REST).
+  rpc StreamingTranslateSpeech(stream StreamingTranslateSpeechRequest) returns (stream StreamingTranslateSpeechResponse) {
+  }
+}
+
+// Provides information to the speech translation that specifies how to process
+// the request.
+message TranslateSpeechConfig {
+  // Required. Encoding of audio data.
+  // Supported formats:
+  //
+  // - `linear16`
+  //
+  //   Uncompressed 16-bit signed little-endian samples (Linear PCM).
+  //
+  //
+  string audio_encoding = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Source language code (BCP-47) of the input audio.
+  string source_language_code = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. A list of up to 3 additional language codes (BCP-47), listing possible
+  // alternative languages of the supplied audio. If alternative source
+  // languages are listed, speech translation result will translate in the most
+  // likely language detected including the main source_language_code. The
+  // translated result will include the language code of the language detected
+  // in the audio.
+  repeated string alternative_source_language_codes = 6 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. Target language code (BCP-47) of the output.
+  string target_language_code = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Sample rate in Hertz of the audio data. Valid values are:
+  // 8000-48000. 16000 is optimal. For best results, set the sampling rate of
+  // the audio source to 16000 Hz. If that's not possible, use the native sample
+  // rate of the audio source (instead of re-sampling). This field can only be
+  // omitted for `FLAC` and `WAV` audio files.
+  int32 sample_rate_hertz = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional.
+  string model = 5 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Config used for streaming translation.
+message StreamingTranslateSpeechConfig {
+  // Required. The common config for all the following audio contents.
+  TranslateSpeechConfig audio_config = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. If `false` or omitted, the system performs
+  // continuous translation (continuing to wait for and process audio even if
+  // the user pauses speaking) until the client closes the input stream (gRPC
+  // API) or until the maximum time limit has been reached. May return multiple
+  // `StreamingTranslateSpeechResult`s with the `is_final` flag set to `true`.
+  //
+  // If `true`, the speech translator will detect a single spoken utterance.
+  // When it detects that the user has paused or stopped speaking, it will
+  // return an `END_OF_SINGLE_UTTERANCE` event and cease translation.
+  // When the client receives 'END_OF_SINGLE_UTTERANCE' event, the client should
+  // stop sending the requests. However, clients should keep receiving remaining
+  // responses until the stream is terminated. To construct the complete
+  // sentence in a streaming way, one should override (if 'is_final' of previous
+  // response is false), or append (if 'is_final' of previous response is true).
+  bool single_utterance = 2 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// The top-level message sent by the client for the `StreamingTranslateSpeech`
+// method. Multiple `StreamingTranslateSpeechRequest` messages are sent. The
+// first message must contain a `streaming_config` message and must not contain
+// `audio_content` data. All subsequent messages must contain `audio_content`
+// data and must not contain a `streaming_config` message.
+message StreamingTranslateSpeechRequest {
+  // The streaming request, which is either a streaming config or content.
+  oneof streaming_request {
+    // Provides information to the recognizer that specifies how to process the
+    // request. The first `StreamingTranslateSpeechRequest` message must contain
+    // a `streaming_config` message.
+    StreamingTranslateSpeechConfig streaming_config = 1;
+
+    // The audio data to be translated. Sequential chunks of audio data are sent
+    // in sequential `StreamingTranslateSpeechRequest` messages. The first
+    // `StreamingTranslateSpeechRequest` message must not contain
+    // `audio_content` data and all subsequent `StreamingTranslateSpeechRequest`
+    // messages must contain `audio_content` data. The audio bytes must be
+    // encoded as specified in `StreamingTranslateSpeechConfig`. Note: as with
+    // all bytes fields, protobuffers use a pure binary representation (not
+    // base64).
+    bytes audio_content = 2;
+  }
+}
+
+// A streaming speech translation result corresponding to a portion of the audio
+// that is currently being processed.
+message StreamingTranslateSpeechResult {
+  // Text translation result.
+  message TextTranslationResult {
+    // Output only. The translated sentence.
+    string translation = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. If `false`, this `StreamingTranslateSpeechResult` represents
+    // an interim result that may change. If `true`, this is the final time the
+    // translation service will return this particular
+    // `StreamingTranslateSpeechResult`, the streaming translator will not
+    // return any further hypotheses for this portion of the transcript and
+    // corresponding audio.
+    bool is_final = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. The source language code (BCP-47) detected in the audio. Speech
+    // translation result will translate in the most likely language detected
+    // including the alternative source languages and main source_language_code.
+    string detected_source_language_code = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+  }
+
+  // Translation result.
+  //
+  // Use oneof field to reserve for future tts result.
+  oneof result {
+    // Text translation result.
+    TextTranslationResult text_translation_result = 1;
+  }
+
+  // Output only. The debug only recognition result in original language. This field is debug
+  // only and will be set to empty string if not available.
+  // This is implementation detail and will not be backward compatible.
+  //
+  // Still need to decide whether to expose this field by default.
+  string recognition_result = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// A streaming speech translation response corresponding to a portion of
+// the audio currently processed.
+message StreamingTranslateSpeechResponse {
+  // Indicates the type of speech event.
+  enum SpeechEventType {
+    // No speech event specified.
+    SPEECH_EVENT_TYPE_UNSPECIFIED = 0;
+
+    // This event indicates that the server has detected the end of the user's
+    // speech utterance and expects no additional speech. Therefore, the server
+    // will not process additional audio (although it may subsequently return
+    // additional results). When the client receives 'END_OF_SINGLE_UTTERANCE'
+    // event, the client should stop sending the requests. However, clients
+    // should keep receiving remaining responses until the stream is terminated.
+    // To construct the complete sentence in a streaming way, one should
+    // override (if 'is_final' of previous response is false), or append (if
+    // 'is_final' of previous response is true). This event is only sent if
+    // `single_utterance` was set to `true`, and is not used otherwise.
+    END_OF_SINGLE_UTTERANCE = 1;
+  }
+
+  // Output only. If set, returns a [google.rpc.Status][google.rpc.Status] message that
+  // specifies the error for the operation.
+  google.rpc.Status error = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The translation result that is currently being processed (is_final could be
+  // true or false).
+  StreamingTranslateSpeechResult result = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Indicates the type of speech event.
+  SpeechEventType speech_event_type = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
diff --git a/third_party/googleapis/google/cloud/mediatranslation/v1beta1/mediatranslation_gapic.yaml b/third_party/googleapis/google/cloud/mediatranslation/v1beta1/mediatranslation_gapic.yaml
new file mode 100644
index 000000000..16eefc404
--- /dev/null
+++ b/third_party/googleapis/google/cloud/mediatranslation/v1beta1/mediatranslation_gapic.yaml
@@ -0,0 +1,18 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 2.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.mediatranslation.v1beta1
+  python:
+    package_name: google.cloud.mediatranslation_v1beta1.gapic
+  go:
+    package_name: cloud.google.com/go/mediatranslation/apiv1beta1
+  csharp:
+    package_name: Google.Cloud.MediaTranslation.V1Beta1
+  ruby:
+    package_name: Google::Cloud::MediaTranslation::V1beta1
+  php:
+    package_name: Google\Cloud\MediaTranslation\V1beta1
+  nodejs:
+    package_name: mediatranslation.v1beta1
+    domain_layer_location: google-cloud
diff --git a/third_party/googleapis/google/cloud/mediatranslation/v1beta1/mediatranslation_grpc_service_config.json b/third_party/googleapis/google/cloud/mediatranslation/v1beta1/mediatranslation_grpc_service_config.json
new file mode 100644
index 000000000..beb0dde71
--- /dev/null
+++ b/third_party/googleapis/google/cloud/mediatranslation/v1beta1/mediatranslation_grpc_service_config.json
@@ -0,0 +1,19 @@
+{
+  "methodConfig": [{
+    "name": [{ "service": "google.cloud.mediatranslation.v1beta1.SpeechTranslationService" }],
+    "timeout": "400s",
+    "retryPolicy": {
+      "maxAttempts": 5,
+      "initialBackoff": "1s",
+      "maxBackoff": "60s",
+      "backoffMultiplier": 1.3,
+      "retryableStatusCodes": ["UNAVAILABLE", "UNKNOWN", "DEADLINE_EXCEEDED"]
+    }
+  },
+  {
+    "name": [
+      { "service": "google.cloud.mediatranslation.v1beta1.SpeechTranslationService", "method": "StreamingTranslateSpeech" }
+    ],
+    "timeout": "400s"
+  }]
+}
diff --git a/third_party/googleapis/google/cloud/mediatranslation/v1beta1/mediatranslation_v1beta1.yaml b/third_party/googleapis/google/cloud/mediatranslation/v1beta1/mediatranslation_v1beta1.yaml
new file mode 100644
index 000000000..f4f9a37ab
--- /dev/null
+++ b/third_party/googleapis/google/cloud/mediatranslation/v1beta1/mediatranslation_v1beta1.yaml
@@ -0,0 +1,19 @@
+type: google.api.Service
+config_version: 3
+name: mediatranslation.googleapis.com
+title: Media Translation API
+
+apis:
+- name: google.cloud.mediatranslation.v1beta1.SpeechTranslationService
+
+backend:
+  rules:
+  - selector: google.cloud.mediatranslation.v1beta1.SpeechTranslationService.StreamingTranslateSpeech
+    deadline: 355.0
+
+authentication:
+  rules:
+  - selector: google.cloud.mediatranslation.v1beta1.SpeechTranslationService.StreamingTranslateSpeech
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/memcache/v1beta2/BUILD.bazel b/third_party/googleapis/google/cloud/memcache/v1beta2/BUILD.bazel
new file mode 100644
index 000000000..e95cb420e
--- /dev/null
+++ b/third_party/googleapis/google/cloud/memcache/v1beta2/BUILD.bazel
@@ -0,0 +1,367 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "memcache_proto",
+    srcs = [
+        "cloud_memcache.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "memcache_proto_with_info",
+    deps = [
+        ":memcache_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "memcache_java_proto",
+    deps = [":memcache_proto"],
+)
+
+java_grpc_library(
+    name = "memcache_java_grpc",
+    srcs = [":memcache_proto"],
+    deps = [":memcache_java_proto"],
+)
+
+java_gapic_library(
+    name = "memcache_java_gapic",
+    src = ":memcache_proto_with_info",
+    gapic_yaml = "memcache_gapic.yaml",
+    package = "google.cloud.memcache.v1beta2",
+    service_yaml = "memcache_v1beta2.yaml",
+    test_deps = [
+        ":memcache_java_grpc",
+    ],
+    deps = [
+        ":memcache_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "memcache_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.memcache.v1beta2.CloudMemcacheClientTest",
+    ],
+    runtime_deps = [":memcache_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-memcache-v1beta2-java",
+    deps = [
+        ":memcache_java_gapic",
+        ":memcache_java_grpc",
+        ":memcache_java_proto",
+        ":memcache_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "memcache_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/memcache/v1beta2",
+    protos = [":memcache_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/longrunning:longrunning_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "memcache_go_gapic",
+    srcs = [":memcache_proto_with_info"],
+    grpc_service_config = "memcache_grpc_service_config.json",
+    importpath = "cloud.google.com/go/memcache/apiv1beta2;memcache",
+    service_yaml = "memcache_v1beta2.yaml",
+    deps = [
+        ":memcache_go_proto",
+        "//google/longrunning:longrunning_go_gapic",
+        "//google/longrunning:longrunning_go_proto",
+        "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
+    ],
+)
+
+go_test(
+    name = "memcache_go_gapic_test",
+    srcs = [":memcache_go_gapic_srcjar_test"],
+    embed = [":memcache_go_gapic"],
+    importpath = "cloud.google.com/go/memcache/apiv1beta2",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-memcache-v1beta2-go",
+    deps = [
+        ":memcache_go_gapic",
+        ":memcache_go_gapic_srcjar-test.srcjar",
+        ":memcache_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "memcache_moved_proto",
+    srcs = [":memcache_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "memcache_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":memcache_moved_proto"],
+)
+
+py_grpc_library(
+    name = "memcache_py_grpc",
+    srcs = [":memcache_moved_proto"],
+    deps = [":memcache_py_proto"],
+)
+
+py_gapic_library(
+    name = "memcache_py_gapic",
+    src = ":memcache_proto_with_info",
+    gapic_yaml = "memcache_gapic.yaml",
+    package = "google.cloud.memcache.v1beta2",
+    service_yaml = "memcache_v1beta2.yaml",
+    deps = [
+        ":memcache_py_grpc",
+        ":memcache_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "memcache-v1beta2-py",
+    deps = [
+        ":memcache_py_gapic",
+        ":memcache_py_grpc",
+        ":memcache_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "memcache_php_proto",
+    deps = [":memcache_proto"],
+)
+
+php_grpc_library(
+    name = "memcache_php_grpc",
+    srcs = [":memcache_proto"],
+    deps = [":memcache_php_proto"],
+)
+
+php_gapic_library(
+    name = "memcache_php_gapic",
+    src = ":memcache_proto_with_info",
+    gapic_yaml = "memcache_gapic.yaml",
+    package = "google.cloud.memcache.v1beta2",
+    service_yaml = "memcache_v1beta2.yaml",
+    deps = [
+        ":memcache_php_grpc",
+        ":memcache_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-memcache-v1beta2-php",
+    deps = [
+        ":memcache_php_gapic",
+        ":memcache_php_grpc",
+        ":memcache_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "memcache_nodejs_gapic",
+    src = ":memcache_proto_with_info",
+    gapic_yaml = "memcache_gapic.yaml",
+    package = "google.cloud.memcache.v1beta2",
+    service_yaml = "memcache_v1beta2.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "memcache-v1beta2-nodejs",
+    deps = [
+        ":memcache_nodejs_gapic",
+        ":memcache_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "memcache_ruby_proto",
+    deps = [":memcache_proto"],
+)
+
+ruby_grpc_library(
+    name = "memcache_ruby_grpc",
+    srcs = [":memcache_proto"],
+    deps = [":memcache_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "memcache_ruby_gapic",
+    src = ":memcache_proto_with_info",
+    gapic_yaml = "memcache_gapic.yaml",
+    package = "google.cloud.memcache.v1beta2",
+    service_yaml = "memcache_v1beta2.yaml",
+    deps = [
+        ":memcache_ruby_grpc",
+        ":memcache_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-memcache-v1beta2-ruby",
+    deps = [
+        ":memcache_ruby_gapic",
+        ":memcache_ruby_grpc",
+        ":memcache_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "memcache_csharp_proto",
+    deps = [":memcache_proto"],
+)
+
+csharp_grpc_library(
+    name = "memcache_csharp_grpc",
+    srcs = [":memcache_proto"],
+    deps = [":memcache_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "memcache_csharp_gapic",
+    src = ":memcache_proto_with_info",
+    gapic_yaml = "memcache_gapic.yaml",
+    package = "google.cloud.memcache.v1beta2",
+    service_yaml = "memcache_v1beta2.yaml",
+    deps = [
+        ":memcache_csharp_grpc",
+        ":memcache_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-memcache-v1beta2-csharp",
+    deps = [
+        ":memcache_csharp_gapic",
+        ":memcache_csharp_grpc",
+        ":memcache_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/memcache/v1beta2/cloud_memcache.proto b/third_party/googleapis/google/cloud/memcache/v1beta2/cloud_memcache.proto
new file mode 100644
index 000000000..5d75ae49e
--- /dev/null
+++ b/third_party/googleapis/google/cloud/memcache/v1beta2/cloud_memcache.proto
@@ -0,0 +1,503 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.memcache.v1beta2;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/memcache/v1beta2;memcache";
+option java_multiple_files = true;
+option java_outer_classname = "CloudMemcacheProto";
+option java_package = "com.google.cloud.memcache.v1beta2";
+
+// Configures and manages Cloud Memorystore for Memcached instances.
+//
+//
+// The `memcache.googleapis.com` service implements the Google Cloud Memorystore
+// for Memcached API and defines the following resource model for managing
+// Memorystore Memcached (also called Memcached below) instances:
+// * The service works with a collection of cloud projects, named: `/projects/*`
+// * Each project has a collection of available locations, named: `/locations/*`
+// * Each location has a collection of Memcached instances, named:
+// `/instances/*`
+// * As such, Memcached instances are resources of the form:
+//   `/projects/{project_id}/locations/{location_id}/instances/{instance_id}`
+//
+// Note that location_id must be refering to a GCP `region`; for example:
+// * `projects/my-memcached-project/locations/us-central1/instances/my-memcached`
+service CloudMemcache {
+  option (google.api.default_host) = "memcache.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // Lists Instances in a given project and location.
+  rpc ListInstances(ListInstancesRequest) returns (ListInstancesResponse) {
+    option (google.api.http) = {
+      get: "/v1beta2/{parent=projects/*/locations/*}/instances"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Gets details of a single Instance.
+  rpc GetInstance(GetInstanceRequest) returns (Instance) {
+    option (google.api.http) = {
+      get: "/v1beta2/{name=projects/*/locations/*/instances/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Creates a new Instance in a given project and location.
+  rpc CreateInstance(CreateInstanceRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta2/{parent=projects/*/locations/*}/instances"
+      body: "resource"
+    };
+    option (google.api.method_signature) = "parent,instance_id,resource";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.cloud.memcache.v1beta2.Instance"
+      metadata_type: "google.cloud.memcache.v1beta2.OperationMetadata"
+    };
+  }
+
+  // Updates an existing Instance in a given project and location.
+  rpc UpdateInstance(UpdateInstanceRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      patch: "/v1beta2/{resource.name=projects/*/locations/*/instances/*}"
+      body: "resource"
+    };
+    option (google.api.method_signature) = "update_mask,resource";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.cloud.memcache.v1beta2.Instance"
+      metadata_type: "google.cloud.memcache.v1beta2.OperationMetadata"
+    };
+  }
+
+  // Updates the defined Memcached Parameters for an existing Instance.
+  // This method only stages the parameters, it must be followed by
+  // ApplyParameters to apply the parameters to nodes of the Memcached Instance.
+  rpc UpdateParameters(UpdateParametersRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      patch: "/v1beta2/{name=projects/*/locations/*/instances/*}:updateParameters"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name,update_mask,parameters";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.cloud.memcache.v1beta2.Instance"
+      metadata_type: "google.cloud.memcache.v1beta2.OperationMetadata"
+    };
+  }
+
+  // Deletes a single Instance.
+  rpc DeleteInstance(DeleteInstanceRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      delete: "/v1beta2/{name=projects/*/locations/*/instances/*}"
+    };
+    option (google.api.method_signature) = "name";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.protobuf.Empty"
+      metadata_type: "google.cloud.memcache.v1beta2.OperationMetadata"
+    };
+  }
+
+  // ApplyParameters will update current set of Parameters to the set of
+  // specified nodes of the Memcached Instance.
+  rpc ApplyParameters(ApplyParametersRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta2/{name=projects/*/locations/*/instances/*}:applyParameters"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name,node_ids,apply_all";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.cloud.memcache.v1beta2.Instance"
+      metadata_type: "google.cloud.memcache.v1beta2.OperationMetadata"
+    };
+  }
+}
+
+message Instance {
+  option (google.api.resource) = {
+    type: "memcache.googleapis.com/Instance"
+    pattern: "projects/{project}/locations/{location}/instances/{instance}"
+  };
+
+  // Configuration for a Memcached Node.
+  message NodeConfig {
+    // Required. Number of cpus per Memcached node.
+    int32 cpu_count = 1 [(google.api.field_behavior) = REQUIRED];
+
+    // Required. Memory size in MiB for each Memcached node.
+    int32 memory_size_mb = 2 [(google.api.field_behavior) = REQUIRED];
+  }
+
+  message Node {
+    // Different states of a Memcached node.
+    // LINT.IfChange
+    enum State {
+      // Node state is not set.
+      STATE_UNSPECIFIED = 0;
+
+      // Node is being created.
+      CREATING = 1;
+
+      // Node has been created and ready to be used.
+      READY = 2;
+
+      // Node is being deleted.
+      DELETING = 3;
+
+      // Node is being updated.
+      UPDATING = 4;
+    }
+
+    // Output only. Identifier of the Memcached node. The node id does not
+    // include project or location like the Memcached instance name.
+    string node_id = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. Location (GCP Zone) for the Memcached node.
+    string zone = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. Current state of the Memcached node.
+    State state = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. Hostname or IP address of the Memcached node used by the
+    // clients to connect to the Memcached server on this node.
+    string host = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. The port number of the Memcached server on this node.
+    int32 port = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // User defined parameters currently applied to the node.
+    MemcacheParameters parameters = 6;
+  }
+
+  message InstanceMessage {
+    enum Code {
+      // Message Code not set.
+      CODE_UNSPECIFIED = 0;
+
+      // Memcached nodes are distributed unevenly.
+      ZONE_DISTRIBUTION_UNBALANCED = 1;
+    }
+
+    // A code that correspond to one type of user-facing message.
+    Code code = 1;
+
+    // Message on memcached instance which will be exposed to users.
+    string message = 2;
+  }
+
+  // Different states of a Memcached instance.
+  // LINT.IfChange
+  enum State {
+    // State not set.
+    STATE_UNSPECIFIED = 0;
+
+    // Memcached instance is being created.
+    CREATING = 1;
+
+    // Memcached instance has been created and ready to be used.
+    READY = 2;
+
+    // Memcached instance is being deleted.
+    DELETING = 4;
+
+    // Memcached instance is going through maintenance, e.g. data plane rollout.
+    PERFORMING_MAINTENANCE = 5;
+  }
+
+  // Required. Unique name of the resource in this scope including project and
+  // location using the form:
+  //     `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
+  //
+  // Note: Memcached instances are managed and addressed at regional level so
+  // location_id here refers to a GCP region; however, users may choose which
+  // zones Memcached nodes within an instances should be provisioned in.
+  // Refer to [zones] field for more details.
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. User provided name for the instance only used for display
+  // purposes. Cannot be more than 80 characters.
+  string display_name = 2;
+
+  // Optional. Resource labels to represent user-provided metadata.
+  // Refer to cloud documentation on labels for more details.
+  // https://cloud.google.com/compute/docs/labeling-resources
+  map labels = 3;
+
+  // Optional. The full name of the Google Compute Engine
+  // [network](/compute/docs/networks-and-firewalls#networks) to which the
+  // instance is connected. If left unspecified, the `default` network
+  // will be used.
+  string authorized_network = 4;
+
+  // Optional. Zones where Memcached nodes should be provisioned in.
+  // Memcached nodes will be equally distributed across these zones. If not
+  // provided, the service will by default create nodes in all zones in the
+  // region for the instance.
+  repeated string zones = 5;
+
+  // Required. Number of nodes in the Memcached instance.
+  int32 node_count = 6 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Configuration for Memcached nodes.
+  NodeConfig node_config = 7 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The major version of Memcached software.
+  // If not provided, latest supported version will be used. Currently the
+  // latest supported major version is MEMCACHE_1_5.
+  // The minor version will be automatically determined by our system based on
+  // the latest supported minor version.
+  MemcacheVersion memcache_version = 9;
+
+  // Optional: User defined parameters to apply to the memcached process
+  // on each node.
+  MemcacheParameters parameters = 11;
+
+  // Output only. List of Memcached nodes.
+  // Refer to [Node] message for more details.
+  repeated Node memcache_nodes = 12 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The time the instance was created.
+  google.protobuf.Timestamp create_time = 13 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The time the instance was updated.
+  google.protobuf.Timestamp update_time = 14 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The state of this Memcached instance.
+  State state = 15 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The full version of memcached server running on this instance.
+  // System automatically determines the full memcached version for an instance
+  // based on the input MemcacheVersion.
+  // The full version format will be "memcached-1.5.16".
+  string memcache_full_version = 18 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // List of messages that describe current statuses of memcached instance.
+  repeated InstanceMessage instance_messages = 19;
+
+  // Output only. Endpoint for Discovery API
+  string discovery_endpoint = 20 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// Request for [ListInstances][google.cloud.memcache.v1beta2.CloudMemcache.ListInstances].
+message ListInstancesRequest {
+  // Required. The resource name of the instance location using the form:
+  //     `projects/{project_id}/locations/{location_id}`
+  // where `location_id` refers to a GCP region
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // The maximum number of items to return.
+  //
+  // If not specified, a default value of 1000 will be used by the service.
+  // Regardless of the page_size value, the response may include a partial list
+  // and a caller should only rely on response's
+  // [next_page_token][CloudMemcache.ListInstancesResponse.next_page_token]
+  // to determine if there are more instances left to be queried.
+  int32 page_size = 2;
+
+  // The next_page_token value returned from a previous List request,
+  // if any.
+  string page_token = 3;
+
+  // List filter. For example, exclude all Memcached instances with name as
+  // my-instance by specifying "name != my-instance".
+  string filter = 4;
+
+  // Sort results. Supported values are "name", "name desc" or "" (unsorted).
+  string order_by = 5;
+}
+
+// Response for [ListInstances][google.cloud.memcache.v1beta2.CloudMemcache.ListInstances].
+message ListInstancesResponse {
+  // A list of Memcached instances in the project in the specified location,
+  // or across all locations.
+  //
+  // If the `location_id` in the parent field of the request is "-", all regions
+  // available to the project are queried, and the results aggregated.
+  repeated Instance resources = 1;
+
+  // Token to retrieve the next page of results, or empty if there are no more
+  // results in the list.
+  string next_page_token = 2;
+
+  // Locations that could not be reached.
+  repeated string unreachable = 3;
+}
+
+// Request for [GetInstance][google.cloud.memcache.v1beta2.CloudMemcache.GetInstance].
+message GetInstanceRequest {
+  // Required. Memcached instance resource name in the format:
+  //     `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
+  // where `location_id` refers to a GCP region
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "memcache.googleapis.com/Instance"
+    }
+  ];
+}
+
+// Request for [CreateInstance][google.cloud.memcache.v1beta2.CloudMemcache.CreateInstance].
+message CreateInstanceRequest {
+  // Required. The resource name of the instance location using the form:
+  //     `projects/{project_id}/locations/{location_id}`
+  // where `location_id` refers to a GCP region
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // Required. The logical name of the Memcached instance in the user
+  // project with the following restrictions:
+  //
+  // * Must contain only lowercase letters, numbers, and hyphens.
+  // * Must start with a letter.
+  // * Must be between 1-40 characters.
+  // * Must end with a number or a letter.
+  // * Must be unique within the user project / location
+  string instance_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. A Memcached [Instance] resource
+  Instance resource = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request for [UpdateInstance][google.cloud.memcache.v1beta2.CloudMemcache.UpdateInstance].
+message UpdateInstanceRequest {
+  // Required. Mask of fields to update.
+  //  *   `displayName`
+  google.protobuf.FieldMask update_mask = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. A Memcached [Instance] resource.
+  // Only fields specified in update_mask are updated.
+  Instance resource = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request for [DeleteInstance][google.cloud.memcache.v1beta2.CloudMemcache.DeleteInstance].
+message DeleteInstanceRequest {
+  // Memcached instance resource name in the format:
+  //     `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
+  // where `location_id` refers to a GCP region
+  string name = 1;
+}
+
+// Request for [ApplyParameters][google.cloud.memcache.v1beta2.CloudMemcache.ApplyParameters].
+message ApplyParametersRequest {
+  // Required. Resource name of the Memcached instance for which parameter group updates
+  // should be applied.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "memcache.googleapis.com/Instance"
+    }
+  ];
+
+  // Nodes to which we should apply the instance-level parameter group.
+  repeated string node_ids = 2;
+
+  // Whether to apply instance-level parameter group to all nodes. If set to
+  // true, will explicitly restrict users from specifying any nodes, and apply
+  // parameter group updates to all nodes within the instance.
+  bool apply_all = 3;
+}
+
+// Request for [UpdateParameters][google.cloud.memcache.v1beta2.CloudMemcache.UpdateParameters].
+message UpdateParametersRequest {
+  // Required. Resource name of the Memcached instance for which the parameters should be
+  // updated.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "memcache.googleapis.com/Instance"
+    }
+  ];
+
+  // Required. Mask of fields to update.
+  google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // The parameters to apply to the instance.
+  MemcacheParameters parameters = 3;
+}
+
+message MemcacheParameters {
+  // Output only. The unique ID associated with this set of parameters. Users
+  // can use this id to determine if the parameters associated with the instance
+  // differ from the parameters associated with the nodes and any action needs
+  // to be taken to apply parameters on nodes.
+  string id = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // User defined set of parameters to use in the memcached process.
+  map params = 3;
+}
+
+// Represents the metadata of a long-running operation.
+message OperationMetadata {
+  // Time when the operation was created.
+  google.protobuf.Timestamp create_time = 1;
+
+  // Time when the operation finished running.
+  google.protobuf.Timestamp end_time = 2;
+
+  // Server-defined resource path for the target of the operation.
+  string target = 3;
+
+  // Name of the verb executed by the operation.
+  string verb = 4;
+
+  // Human-readable status of the operation, if any.
+  string status_detail = 5;
+
+  // Identifies whether the user has requested cancellation
+  // of the operation. Operations that have successfully been cancelled
+  // have [Operation.error][] value with a [google.rpc.Status.code][google.rpc.Status.code] of 1,
+  // corresponding to `Code.CANCELLED`.
+  bool cancel_requested = 6;
+
+  // API version used to start the operation.
+  string api_version = 7;
+}
+
+// Memcached versions supported by our service.
+enum MemcacheVersion {
+  MEMCACHE_VERSION_UNSPECIFIED = 0;
+
+  // Memcached 1.5 version.
+  MEMCACHE_1_5 = 1;
+}
+
+// Metadata for the given [google.cloud.location.Location][google.cloud.location.Location].
+message LocationMetadata {
+  // Output only. The set of available zones in the location. The map is keyed
+  // by the lowercase ID of each zone, as defined by GCE. These keys can be
+  // specified in the `zones` field when creating a Memcached instance.
+  map available_zones = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+message ZoneMetadata {
+
+}
diff --git a/third_party/googleapis/google/cloud/memcache/v1beta2/memcache_gapic.yaml b/third_party/googleapis/google/cloud/memcache/v1beta2/memcache_gapic.yaml
new file mode 100644
index 000000000..87a6dbdab
--- /dev/null
+++ b/third_party/googleapis/google/cloud/memcache/v1beta2/memcache_gapic.yaml
@@ -0,0 +1,19 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 2.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.memcache.v1beta2
+  python:
+    package_name: google.cloud.memcache_v1beta2.gapic
+  go:
+    package_name: cloud.google.com/go/memcache/apiv1beta2
+  csharp:
+    package_name: Google.Cloud.Memcache.V1Beta2
+  ruby:
+    package_name: Google::Cloud::Memcache::V1beta2
+  php:
+    package_name: Google\Cloud\Memcache\V1beta2
+  nodejs:
+    package_name: memcache.v1beta2
+    domain_layer_location: google-cloud
diff --git a/third_party/googleapis/google/cloud/memcache/v1beta2/memcache_grpc_service_config.json b/third_party/googleapis/google/cloud/memcache/v1beta2/memcache_grpc_service_config.json
new file mode 100644
index 000000000..6817c8b4f
--- /dev/null
+++ b/third_party/googleapis/google/cloud/memcache/v1beta2/memcache_grpc_service_config.json
@@ -0,0 +1,37 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.memcache.v1beta2.CloudMemcache",
+          "method": "ListInstances"
+        },
+        {
+          "service": "google.cloud.memcache.v1beta2.CloudMemcache",
+          "method": "GetInstance"
+        },
+        {
+          "service": "google.cloud.memcache.v1beta2.CloudMemcache",
+          "method": "CreateInstance"
+        },
+        {
+          "service": "google.cloud.memcache.v1beta2.CloudMemcache",
+          "method": "UpdateInstance"
+        },
+        {
+          "service": "google.cloud.memcache.v1beta2.CloudMemcache",
+          "method": "UpdateParameters"
+        },
+        {
+          "service": "google.cloud.memcache.v1beta2.CloudMemcache",
+          "method": "ApplyParameters"
+        },
+        {
+          "service": "google.cloud.memcache.v1beta2.CloudMemcache",
+          "method": "DeleteInstance"
+        }
+      ],
+      "timeout": "1200s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/memcache/v1beta2/memcache_v1beta2.yaml b/third_party/googleapis/google/cloud/memcache/v1beta2/memcache_v1beta2.yaml
new file mode 100644
index 000000000..ae598c6a6
--- /dev/null
+++ b/third_party/googleapis/google/cloud/memcache/v1beta2/memcache_v1beta2.yaml
@@ -0,0 +1,87 @@
+type: google.api.Service
+config_version: 3
+name: memcache.googleapis.com
+title: Cloud Memorystore for Memcached API
+
+apis:
+- name: google.cloud.memcache.v1beta2.CloudMemcache
+
+types:
+- name: google.cloud.memcache.v1beta2.LocationMetadata
+- name: google.cloud.memcache.v1beta2.OperationMetadata
+
+documentation:
+  summary: |-
+    Google Cloud Memorystore for Memcached API is used for creating and
+    managing Memcached instances in GCP.
+  rules:
+  - selector: google.iam.v1.IAMPolicy.GetIamPolicy
+    description: |-
+      Gets the access control policy for a resource. Returns an empty policy
+      if the resource exists and does not have a policy set.
+
+  - selector: google.iam.v1.IAMPolicy.SetIamPolicy
+    description: |-
+      Sets the access control policy on the specified resource. Replaces
+      any existing policy.
+
+      Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and
+      PERMISSION_DENIED
+
+  - selector: google.iam.v1.IAMPolicy.TestIamPermissions
+    description: |-
+      Returns permissions that a caller has on the specified resource. If the
+      resource does not exist, this will return an empty set of
+      permissions, not a NOT_FOUND error.
+
+      Note: This operation is designed to be used for building
+      permission-aware UIs and command-line tools, not for authorization
+      checking. This operation may "fail open" without warning.
+
+backend:
+  rules:
+  - selector: google.cloud.memcache.v1beta2.CloudMemcache.GetInstance
+    deadline: 60.0
+  - selector: google.cloud.memcache.v1beta2.CloudMemcache.ListInstances
+    deadline: 60.0
+  - selector: 'google.iam.v1.IAMPolicy.*'
+    deadline: 60.0
+  - selector: 'google.longrunning.Operations.*'
+    deadline: 60.0
+  - selector: google.longrunning.Operations.GetOperation
+    deadline: 5.0
+
+http:
+  rules:
+  - selector: google.iam.v1.IAMPolicy.GetIamPolicy
+    get: '/v1beta2/{resource=projects/*/locations/*/instances/*}:getIamPolicy'
+  - selector: google.iam.v1.IAMPolicy.SetIamPolicy
+    post: '/v1beta2/{resource=projects/*/locations/*/instances/*}:setIamPolicy'
+    body: '*'
+  - selector: google.iam.v1.IAMPolicy.TestIamPermissions
+    post: '/v1beta2/{resource=projects/*/locations/*/instances/*}:testIamPermissions'
+    body: '*'
+  - selector: google.longrunning.Operations.CancelOperation
+    post: '/v1beta2/{name=projects/*/locations/*/operations/*}:cancel'
+    body: '*'
+  - selector: google.longrunning.Operations.DeleteOperation
+    delete: '/v1beta2/{name=projects/*/locations/*/operations/*}'
+  - selector: google.longrunning.Operations.GetOperation
+    get: '/v1beta2/{name=projects/*/locations/*/operations/*}'
+  - selector: google.longrunning.Operations.ListOperations
+    get: '/v1beta2/{name=projects/*/locations/*}/operations'
+
+authentication:
+  rules:
+  - selector: 'google.cloud.memcache.v1beta2.CloudMemcache.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.iam.v1.IAMPolicy.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/orgpolicy/v1/BUILD.bazel b/third_party/googleapis/google/cloud/orgpolicy/v1/BUILD.bazel
new file mode 100644
index 000000000..35ac2f458
--- /dev/null
+++ b/third_party/googleapis/google/cloud/orgpolicy/v1/BUILD.bazel
@@ -0,0 +1,189 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
+proto_library(
+    name = "orgpolicy_proto",
+    srcs = [
+        "orgpolicy.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_grpc_library",
+    "java_proto_library",
+    "java_gapic_assembly_gradle_pkg",
+)
+
+java_proto_library(
+    name = "orgpolicy_java_proto",
+    deps = [":orgpolicy_proto"],
+)
+
+java_grpc_library(
+    name = "orgpolicy_java_grpc",
+    srcs = [":orgpolicy_proto"],
+    deps = [":orgpolicy_java_proto"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-orgpolicy-v1-java",
+    deps = [
+        ":orgpolicy_java_grpc",
+        ":orgpolicy_java_proto",
+        ":orgpolicy_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_proto_library",
+)
+
+go_proto_library(
+    name = "orgpolicy_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/orgpolicy/v1",
+    protos = [":orgpolicy_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_grpc_library",
+    "py_proto_library",
+    "py_gapic_assembly_pkg",
+)
+
+moved_proto_library(
+    name = "orgpolicy_moved_proto",
+    srcs = [":orgpolicy_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "orgpolicy_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":orgpolicy_moved_proto"],
+)
+
+py_grpc_library(
+    name = "orgpolicy_py_grpc",
+    srcs = [":orgpolicy_moved_proto"],
+    deps = [":orgpolicy_py_proto"],
+)
+
+# Open Source Packages
+# DO NOT REMOVE, this is needed to generate a Python package
+# with the orgpolicy protos.
+py_gapic_assembly_pkg(
+    name = "orgpolicy-v1-py",
+    deps = [
+        ":orgpolicy_py_grpc",
+        ":orgpolicy_py_proto",
+        ":orgpolicy_proto",
+    ],
+)
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "orgpolicy_php_proto",
+    deps = [":orgpolicy_proto"],
+)
+
+php_grpc_library(
+    name = "orgpolicy_php_grpc",
+    srcs = [":orgpolicy_proto"],
+    deps = [":orgpolicy_php_proto"],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "orgpolicy_ruby_proto",
+    deps = [":orgpolicy_proto"],
+)
+
+ruby_grpc_library(
+    name = "orgpolicy_ruby_grpc",
+    srcs = [":orgpolicy_proto"],
+    deps = [":orgpolicy_ruby_proto"],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "orgpolicy_csharp_proto",
+    deps = [":orgpolicy_proto"],
+)
+
+csharp_grpc_library(
+    name = "orgpolicy_csharp_grpc",
+    srcs = [":orgpolicy_proto"],
+    deps = [":orgpolicy_csharp_proto"],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ code here
diff --git a/third_party/googleapis/google/cloud/orgpolicy/v1/orgpolicy.proto b/third_party/googleapis/google/cloud/orgpolicy/v1/orgpolicy.proto
new file mode 100644
index 000000000..fbd62df6f
--- /dev/null
+++ b/third_party/googleapis/google/cloud/orgpolicy/v1/orgpolicy.proto
@@ -0,0 +1,315 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.orgpolicy.v1;
+
+import "google/protobuf/empty.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.OrgPolicy.V1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/orgpolicy/v1;orgpolicy";
+option java_multiple_files = true;
+option java_outer_classname = "OrgPolicyProto";
+option java_package = "com.google.cloud.orgpolicy.v1";
+option php_namespace = "Google\\Cloud\\OrgPolicy\\V1";
+option ruby_package = "Google::Cloud::OrgPolicy::V1";
+
+// Defines a Cloud Organization `Policy` which is used to specify `Constraints`
+// for configurations of Cloud Platform resources.
+message Policy {
+  // Used in `policy_type` to specify how `list_policy` behaves at this
+  // resource.
+  //
+  // `ListPolicy` can define specific values and subtrees of Cloud Resource
+  // Manager resource hierarchy (`Organizations`, `Folders`, `Projects`) that
+  // are allowed or denied by setting the `allowed_values` and `denied_values`
+  // fields. This is achieved by using the `under:` and optional `is:` prefixes.
+  // The `under:` prefix is used to denote resource subtree values.
+  // The `is:` prefix is used to denote specific values, and is required only
+  // if the value contains a ":". Values prefixed with "is:" are treated the
+  // same as values with no prefix.
+  // Ancestry subtrees must be in one of the following formats:
+  //     - "projects/", e.g. "projects/tokyo-rain-123"
+  //     - "folders/", e.g. "folders/1234"
+  //     - "organizations/", e.g. "organizations/1234"
+  // The `supports_under` field of the associated `Constraint`  defines whether
+  // ancestry prefixes can be used. You can set `allowed_values` and
+  // `denied_values` in the same `Policy` if `all_values` is
+  // `ALL_VALUES_UNSPECIFIED`. `ALLOW` or `DENY` are used to allow or deny all
+  // values. If `all_values` is set to either `ALLOW` or `DENY`,
+  // `allowed_values` and `denied_values` must be unset.
+  message ListPolicy {
+    // This enum can be used to set `Policies` that apply to all possible
+    // configuration values rather than specific values in `allowed_values` or
+    // `denied_values`.
+    //
+    // Settting this to `ALLOW` will mean this `Policy` allows all values.
+    // Similarly, setting it to `DENY` will mean no values are allowed. If
+    // set to either `ALLOW` or `DENY,  `allowed_values` and `denied_values`
+    // must be unset. Setting this to `ALL_VALUES_UNSPECIFIED` allows for
+    // setting `allowed_values` and `denied_values`.
+    enum AllValues {
+      // Indicates that allowed_values or denied_values must be set.
+      ALL_VALUES_UNSPECIFIED = 0;
+
+      // A policy with this set allows all values.
+      ALLOW = 1;
+
+      // A policy with this set denies all values.
+      DENY = 2;
+    }
+
+    // List of values allowed  at this resource. Can only be set if `all_values`
+    // is set to `ALL_VALUES_UNSPECIFIED`.
+    repeated string allowed_values = 1;
+
+    // List of values denied at this resource. Can only be set if `all_values`
+    // is set to `ALL_VALUES_UNSPECIFIED`.
+    repeated string denied_values = 2;
+
+    // The policy all_values state.
+    AllValues all_values = 3;
+
+    // Optional. The Google Cloud Console will try to default to a configuration
+    // that matches the value specified in this `Policy`. If `suggested_value`
+    // is not set, it will inherit the value specified higher in the hierarchy,
+    // unless `inherit_from_parent` is `false`.
+    string suggested_value = 4;
+
+    // Determines the inheritance behavior for this `Policy`.
+    //
+    // By default, a `ListPolicy` set at a resource supercedes any `Policy` set
+    // anywhere up the resource hierarchy. However, if `inherit_from_parent` is
+    // set to `true`, then the values from the effective `Policy` of the parent
+    // resource are inherited, meaning the values set in this `Policy` are
+    // added to the values inherited up the hierarchy.
+    //
+    // Setting `Policy` hierarchies that inherit both allowed values and denied
+    // values isn't recommended in most circumstances to keep the configuration
+    // simple and understandable. However, it is possible to set a `Policy` with
+    // `allowed_values` set that inherits a `Policy` with `denied_values` set.
+    // In this case, the values that are allowed must be in `allowed_values` and
+    // not present in `denied_values`.
+    //
+    // For example, suppose you have a `Constraint`
+    // `constraints/serviceuser.services`, which has a `constraint_type` of
+    // `list_constraint`, and with `constraint_default` set to `ALLOW`.
+    // Suppose that at the Organization level, a `Policy` is applied that
+    // restricts the allowed API activations to {`E1`, `E2`}. Then, if a
+    // `Policy` is applied to a project below the Organization that has
+    // `inherit_from_parent` set to `false` and field all_values set to DENY,
+    // then an attempt to activate any API will be denied.
+    //
+    // The following examples demonstrate different possible layerings for
+    // `projects/bar` parented by `organizations/foo`:
+    //
+    // Example 1 (no inherited values):
+    //   `organizations/foo` has a `Policy` with values:
+    //     {allowed_values: "E1" allowed_values:"E2"}
+    //   `projects/bar` has `inherit_from_parent` `false` and values:
+    //     {allowed_values: "E3" allowed_values: "E4"}
+    // The accepted values at `organizations/foo` are `E1`, `E2`.
+    // The accepted values at `projects/bar` are `E3`, and `E4`.
+    //
+    // Example 2 (inherited values):
+    //   `organizations/foo` has a `Policy` with values:
+    //     {allowed_values: "E1" allowed_values:"E2"}
+    //   `projects/bar` has a `Policy` with values:
+    //     {value: "E3" value: "E4" inherit_from_parent: true}
+    // The accepted values at `organizations/foo` are `E1`, `E2`.
+    // The accepted values at `projects/bar` are `E1`, `E2`, `E3`, and `E4`.
+    //
+    // Example 3 (inheriting both allowed and denied values):
+    //   `organizations/foo` has a `Policy` with values:
+    //     {allowed_values: "E1" allowed_values: "E2"}
+    //   `projects/bar` has a `Policy` with:
+    //     {denied_values: "E1"}
+    // The accepted values at `organizations/foo` are `E1`, `E2`.
+    // The value accepted at `projects/bar` is `E2`.
+    //
+    // Example 4 (RestoreDefault):
+    //   `organizations/foo` has a `Policy` with values:
+    //     {allowed_values: "E1" allowed_values:"E2"}
+    //   `projects/bar` has a `Policy` with values:
+    //     {RestoreDefault: {}}
+    // The accepted values at `organizations/foo` are `E1`, `E2`.
+    // The accepted values at `projects/bar` are either all or none depending on
+    // the value of `constraint_default` (if `ALLOW`, all; if
+    // `DENY`, none).
+    //
+    // Example 5 (no policy inherits parent policy):
+    //   `organizations/foo` has no `Policy` set.
+    //   `projects/bar` has no `Policy` set.
+    // The accepted values at both levels are either all or none depending on
+    // the value of `constraint_default` (if `ALLOW`, all; if
+    // `DENY`, none).
+    //
+    // Example 6 (ListConstraint allowing all):
+    //   `organizations/foo` has a `Policy` with values:
+    //     {allowed_values: "E1" allowed_values: "E2"}
+    //   `projects/bar` has a `Policy` with:
+    //     {all: ALLOW}
+    // The accepted values at `organizations/foo` are `E1`, E2`.
+    // Any value is accepted at `projects/bar`.
+    //
+    // Example 7 (ListConstraint allowing none):
+    //   `organizations/foo` has a `Policy` with values:
+    //     {allowed_values: "E1" allowed_values: "E2"}
+    //   `projects/bar` has a `Policy` with:
+    //     {all: DENY}
+    // The accepted values at `organizations/foo` are `E1`, E2`.
+    // No value is accepted at `projects/bar`.
+    //
+    // Example 10 (allowed and denied subtrees of Resource Manager hierarchy):
+    // Given the following resource hierarchy
+    //   O1->{F1, F2}; F1->{P1}; F2->{P2, P3},
+    //   `organizations/foo` has a `Policy` with values:
+    //     {allowed_values: "under:organizations/O1"}
+    //   `projects/bar` has a `Policy` with:
+    //     {allowed_values: "under:projects/P3"}
+    //     {denied_values: "under:folders/F2"}
+    // The accepted values at `organizations/foo` are `organizations/O1`,
+    //   `folders/F1`, `folders/F2`, `projects/P1`, `projects/P2`,
+    //   `projects/P3`.
+    // The accepted values at `projects/bar` are `organizations/O1`,
+    //   `folders/F1`, `projects/P1`.
+    bool inherit_from_parent = 5;
+  }
+
+  // Used in `policy_type` to specify how `boolean_policy` will behave at this
+  // resource.
+  message BooleanPolicy {
+    // If `true`, then the `Policy` is enforced. If `false`, then any
+    // configuration is acceptable.
+    //
+    // Suppose you have a `Constraint`
+    // `constraints/compute.disableSerialPortAccess` with `constraint_default`
+    // set to `ALLOW`. A `Policy` for that `Constraint` exhibits the following
+    // behavior:
+    //   - If the `Policy` at this resource has enforced set to `false`, serial
+    //     port connection attempts will be allowed.
+    //   - If the `Policy` at this resource has enforced set to `true`, serial
+    //     port connection attempts will be refused.
+    //   - If the `Policy` at this resource is `RestoreDefault`, serial port
+    //     connection attempts will be allowed.
+    //   - If no `Policy` is set at this resource or anywhere higher in the
+    //     resource hierarchy, serial port connection attempts will be allowed.
+    //   - If no `Policy` is set at this resource, but one exists higher in the
+    //     resource hierarchy, the behavior is as if the`Policy` were set at
+    //     this resource.
+    //
+    // The following examples demonstrate the different possible layerings:
+    //
+    // Example 1 (nearest `Constraint` wins):
+    //   `organizations/foo` has a `Policy` with:
+    //     {enforced: false}
+    //   `projects/bar` has no `Policy` set.
+    // The constraint at `projects/bar` and `organizations/foo` will not be
+    // enforced.
+    //
+    // Example 2 (enforcement gets replaced):
+    //   `organizations/foo` has a `Policy` with:
+    //     {enforced: false}
+    //   `projects/bar` has a `Policy` with:
+    //     {enforced: true}
+    // The constraint at `organizations/foo` is not enforced.
+    // The constraint at `projects/bar` is enforced.
+    //
+    // Example 3 (RestoreDefault):
+    //   `organizations/foo` has a `Policy` with:
+    //     {enforced: true}
+    //   `projects/bar` has a `Policy` with:
+    //     {RestoreDefault: {}}
+    // The constraint at `organizations/foo` is enforced.
+    // The constraint at `projects/bar` is not enforced, because
+    // `constraint_default` for the `Constraint` is `ALLOW`.
+    bool enforced = 1;
+  }
+
+  // Ignores policies set above this resource and restores the
+  // `constraint_default` enforcement behavior of the specific `Constraint` at
+  // this resource.
+  //
+  // Suppose that `constraint_default` is set to `ALLOW` for the
+  // `Constraint` `constraints/serviceuser.services`. Suppose that organization
+  // foo.com sets a `Policy` at their Organization resource node that restricts
+  // the allowed service activations to deny all service activations. They
+  // could then set a `Policy` with the `policy_type` `restore_default` on
+  // several experimental projects, restoring the `constraint_default`
+  // enforcement of the `Constraint` for only those projects, allowing those
+  // projects to have all services activated.
+  message RestoreDefault {
+
+  }
+
+  // Version of the `Policy`. Default version is 0;
+  int32 version = 1;
+
+  // The name of the `Constraint` the `Policy` is configuring, for example,
+  // `constraints/serviceuser.services`.
+  //
+  // Immutable after creation.
+  string constraint = 2;
+
+  // An opaque tag indicating the current version of the `Policy`, used for
+  // concurrency control.
+  //
+  // When the `Policy` is returned from either a `GetPolicy` or a
+  // `ListOrgPolicy` request, this `etag` indicates the version of the current
+  // `Policy` to use when executing a read-modify-write loop.
+  //
+  // When the `Policy` is returned from a `GetEffectivePolicy` request, the
+  // `etag` will be unset.
+  //
+  // When the `Policy` is used in a `SetOrgPolicy` method, use the `etag` value
+  // that was returned from a `GetOrgPolicy` request as part of a
+  // read-modify-write loop for concurrency control. Not setting the `etag`in a
+  // `SetOrgPolicy` request will result in an unconditional write of the
+  // `Policy`.
+  bytes etag = 3;
+
+  // The time stamp the `Policy` was previously updated. This is set by the
+  // server, not specified by the caller, and represents the last time a call to
+  // `SetOrgPolicy` was made for that `Policy`. Any value set by the client will
+  // be ignored.
+  google.protobuf.Timestamp update_time = 4;
+
+  // The field to populate is based on the `constraint_type` value in the
+  // `Constraint`.
+  //   `list_constraint` => `list_policy`
+  //   `boolean_constraint` => `boolean_policy`
+  //
+  //  A `restore_default` message may be used with any `Constraint` type.
+  //
+  // Providing a *_policy that is incompatible with the `constraint_type` will
+  // result in an `invalid_argument` error.
+  //
+  // Attempting to set a `Policy` with a `policy_type` not set will result in an
+  // `invalid_argument` error.
+  oneof policy_type {
+    // List of values either allowed or disallowed.
+    ListPolicy list_policy = 5;
+
+    // For boolean `Constraints`, whether to enforce the `Constraint` or not.
+    BooleanPolicy boolean_policy = 6;
+
+    // Restores the default behavior of the constraint; independent of
+    // `Constraint` type.
+    RestoreDefault restore_default = 7;
+  }
+}
diff --git a/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1/BUILD.bazel b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1/BUILD.bazel
new file mode 100644
index 000000000..bcd5045e3
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1/BUILD.bazel
@@ -0,0 +1,354 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "agentendpoint_proto",
+    srcs = [
+        "agentendpoint.proto",
+        "patch_jobs.proto",
+        "tasks.proto",
+    ],
+    deps = [
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "agentendpoint_proto_with_info",
+    deps = [
+        ":agentendpoint_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "agentendpoint_java_proto",
+    deps = [":agentendpoint_proto"],
+)
+
+java_grpc_library(
+    name = "agentendpoint_java_grpc",
+    srcs = [":agentendpoint_proto"],
+    deps = [":agentendpoint_java_proto"],
+)
+
+java_gapic_library(
+    name = "agentendpoint_java_gapic",
+    src = ":agentendpoint_proto_with_info",
+    gapic_yaml = "osconfig_gapic.yaml",
+    package = "google.cloud.osconfig.agentendpoint.v1",
+    service_yaml = "osconfig_v1.yaml",
+    test_deps = [
+        ":agentendpoint_java_grpc",
+    ],
+    deps = [
+        ":agentendpoint_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "agentendpoint_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.osconfig.agentendpoint.v1.AgentEndpointServiceClientTest",
+    ],
+    runtime_deps = [":agentendpoint_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-osconfig-agentendpoint-v1-java",
+    deps = [
+        ":agentendpoint_java_gapic",
+        ":agentendpoint_java_grpc",
+        ":agentendpoint_java_proto",
+        ":agentendpoint_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "agentendpoint_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/osconfig/agentendpoint/v1",
+    protos = [":agentendpoint_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "agentendpoint_go_gapic",
+    srcs = [":agentendpoint_proto_with_info"],
+    grpc_service_config = "agentendpoint_grpc_service_config.json",
+    importpath = "cloud.google.com/go/osconfig/agentendpoint/apiv1;agentendpoint",
+    service_yaml = "osconfig_v1.yaml",
+    deps = [
+        ":agentendpoint_go_proto",
+    ],
+)
+
+go_test(
+    name = "agentendpoint_go_gapic_test",
+    srcs = [":agentendpoint_go_gapic_srcjar_test"],
+    embed = [":agentendpoint_go_gapic"],
+    importpath = "cloud.google.com/go/osconfig/agentendpoint/apiv1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-osconfig-agentendpoint-v1-go",
+    deps = [
+        ":agentendpoint_go_gapic",
+        ":agentendpoint_go_gapic_srcjar-test.srcjar",
+        ":agentendpoint_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "agentendpoint_moved_proto",
+    srcs = [":agentendpoint_proto"],
+    deps = [
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+    ],
+)
+
+py_proto_library(
+    name = "agentendpoint_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":agentendpoint_moved_proto"],
+)
+
+py_grpc_library(
+    name = "agentendpoint_py_grpc",
+    srcs = [":agentendpoint_moved_proto"],
+    deps = [":agentendpoint_py_proto"],
+)
+
+py_gapic_library(
+    name = "agentendpoint_py_gapic",
+    src = ":agentendpoint_proto_with_info",
+    gapic_yaml = "osconfig_gapic.yaml",
+    package = "google.cloud.osconfig.agentendpoint.v1",
+    service_yaml = "osconfig_v1.yaml",
+    deps = [
+        ":agentendpoint_py_grpc",
+        ":agentendpoint_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "osconfig-agentendpoint-v1-py",
+    deps = [
+        ":agentendpoint_py_gapic",
+        ":agentendpoint_py_grpc",
+        ":agentendpoint_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+# load(
+#     "@com_google_googleapis_imports//:imports.bzl",
+#     "php_gapic_assembly_pkg",
+#     "php_gapic_library",
+#     "php_grpc_library",
+#     "php_proto_library",
+# )
+#
+# php_proto_library(
+#     name = "agentendpoint_php_proto",
+#     deps = [":agentendpoint_proto"],
+# )
+#
+# php_grpc_library(
+#     name = "agentendpoint_php_grpc",
+#     srcs = [":agentendpoint_proto"],
+#     deps = [":agentendpoint_php_proto"],
+# )
+#
+# php_gapic_library(
+#     name = "agentendpoint_php_gapic",
+#     src = ":agentendpoint_proto_with_info",
+#     gapic_yaml = "osconfig_gapic.yaml",
+#     package = "google.cloud.osconfig.agentendpoint.v1",
+#     service_yaml = "osconfig_v1.yaml",
+#     deps = [
+#         ":agentendpoint_php_grpc",
+#         ":agentendpoint_php_proto",
+#     ],
+# )
+#
+# # Open Source Packages
+# php_gapic_assembly_pkg(
+#     name = "google-cloud-osconfig-agentendpoint-v1-php",
+#     deps = [
+#         ":agentendpoint_php_gapic",
+#         ":agentendpoint_php_grpc",
+#         ":agentendpoint_php_proto",
+#     ],
+# )
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "agentendpoint_nodejs_gapic",
+    src = ":agentendpoint_proto_with_info",
+    gapic_yaml = "osconfig_gapic.yaml",
+    package = "google.cloud.osconfig.agentendpoint.v1",
+    service_yaml = "osconfig_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "osconfig-agentendpoint-v1-nodejs",
+    deps = [
+        ":agentendpoint_nodejs_gapic",
+        ":agentendpoint_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "agentendpoint_ruby_proto",
+    deps = [":agentendpoint_proto"],
+)
+
+ruby_grpc_library(
+    name = "agentendpoint_ruby_grpc",
+    srcs = [":agentendpoint_proto"],
+    deps = [":agentendpoint_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "agentendpoint_ruby_gapic",
+    src = ":agentendpoint_proto_with_info",
+    gapic_yaml = "osconfig_gapic.yaml",
+    package = "google.cloud.osconfig.agentendpoint.v1",
+    service_yaml = "osconfig_v1.yaml",
+    deps = [
+        ":agentendpoint_ruby_grpc",
+        ":agentendpoint_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-osconfig-agentendpoint-v1-ruby",
+    deps = [
+        ":agentendpoint_ruby_gapic",
+        ":agentendpoint_ruby_grpc",
+        ":agentendpoint_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "agentendpoint_csharp_proto",
+    deps = [":agentendpoint_proto"],
+)
+
+csharp_grpc_library(
+    name = "agentendpoint_csharp_grpc",
+    srcs = [":agentendpoint_proto"],
+    deps = [":agentendpoint_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "agentendpoint_csharp_gapic",
+    src = ":agentendpoint_proto_with_info",
+    gapic_yaml = "osconfig_gapic.yaml",
+    package = "google.cloud.osconfig.agentendpoint.v1",
+    service_yaml = "osconfig_v1.yaml",
+    deps = [
+        ":agentendpoint_csharp_grpc",
+        ":agentendpoint_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-osconfig-agentendpoint-v1-csharp",
+    deps = [
+        ":agentendpoint_csharp_gapic",
+        ":agentendpoint_csharp_grpc",
+        ":agentendpoint_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1/agentendpoint.proto b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1/agentendpoint.proto
new file mode 100644
index 000000000..58b9cb4d6
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1/agentendpoint.proto
@@ -0,0 +1,180 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.osconfig.agentendpoint.v1;
+
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/cloud/osconfig/agentendpoint/v1/tasks.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/osconfig/agentendpoint/v1;agentendpoint";
+option java_multiple_files = true;
+option java_outer_classname = "AgentEndpointProto";
+option java_package = "com.google.cloud.osconfig.agentendpoint.v1";
+
+// OS Config agent endpoint API.
+service AgentEndpointService {
+  option (google.api.default_host) = "osconfig.googleapis.com";
+
+  // Stream established by client to receive Task notifications.
+  rpc ReceiveTaskNotification(ReceiveTaskNotificationRequest) returns (stream ReceiveTaskNotificationResponse) {
+    option (google.api.method_signature) = "instance_id_token,agent_version";
+  }
+
+  // Signals the start of a task execution and returns the task info.
+  rpc StartNextTask(StartNextTaskRequest) returns (StartNextTaskResponse) {
+    option (google.api.method_signature) = "instance_id_token";
+  }
+
+  // Signals an intermediary progress checkpoint in task execution.
+  rpc ReportTaskProgress(ReportTaskProgressRequest) returns (ReportTaskProgressResponse) {
+    option (google.api.method_signature) = "instance_id_token,task_id,task_type";
+  }
+
+  // Signals that the task execution is complete and optionally returns the next
+  // task.
+  rpc ReportTaskComplete(ReportTaskCompleteRequest) returns (ReportTaskCompleteResponse) {
+    option (google.api.method_signature) = "instance_id_token,task_id,task_type,error_message";
+  }
+
+  // Registers the agent running on the VM.
+  rpc RegisterAgent(RegisterAgentRequest) returns (RegisterAgentResponse) {
+    option (google.api.method_signature) = "instance_id_token,agent_version,supported_capabilities";
+  }
+}
+
+// A request message to receive task notifications.
+message ReceiveTaskNotificationRequest {
+  // Required. This is the Compute Engine instance identity token described in
+  // https://cloud.google.com/compute/docs/instances/verifying-instance-identity
+  // where the audience is 'osconfig.googleapis.com' and the format is 'full'.
+  string instance_id_token = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The version of the agent making the request.
+  string agent_version = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The streaming rpc message that notifies the agent when it has a task
+// that it needs to perform on the VM instance.
+message ReceiveTaskNotificationResponse {
+
+}
+
+// A request message for signaling the start of a task execution.
+message StartNextTaskRequest {
+  // Required. This is the Compute Engine instance identity token described in
+  // https://cloud.google.com/compute/docs/instances/verifying-instance-identity
+  // where the audience is 'osconfig.googleapis.com' and the format is 'full'.
+  string instance_id_token = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// A response message that contains the details of the task to work on.
+message StartNextTaskResponse {
+  // The details of the task that should be worked on.  Can be empty if there
+  // is no new task to work on.
+  Task task = 1;
+}
+
+// A request message for reporting the progress of current task.
+message ReportTaskProgressRequest {
+  // Required. This is the Compute Engine instance identity token described in
+  // https://cloud.google.com/compute/docs/instances/verifying-instance-identity
+  // where the audience is 'osconfig.googleapis.com' and the format is 'full'.
+  string instance_id_token = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Unique identifier of the task this applies to.
+  string task_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The type of task to report progress on.
+  //
+  // Progress must include the appropriate message based on this enum as
+  // specified below:
+  // APPLY_PATCHES = ApplyPatchesTaskProgress
+  // EXEC_STEP = Progress not supported for this type.
+  TaskType task_type = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Intermediate progress of the current task.
+  oneof progress {
+    // Details about the progress of the apply patches task.
+    ApplyPatchesTaskProgress apply_patches_task_progress = 4;
+
+    // Details about the progress of the exec step task.
+    ExecStepTaskProgress exec_step_task_progress = 5;
+  }
+}
+
+// The response message after the agent reported the current task progress.
+message ReportTaskProgressResponse {
+  // Instructs agent to continue or not.
+  TaskDirective task_directive = 1;
+}
+
+// A request message for signaling the completion of a task execution.
+message ReportTaskCompleteRequest {
+  // Required. This is the Compute Engine instance identity token described in
+  // https://cloud.google.com/compute/docs/instances/verifying-instance-identity
+  // where the audience is 'osconfig.googleapis.com' and the format is 'full'.
+  string instance_id_token = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Unique identifier of the task this applies to.
+  string task_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The type of task to report completed.
+  //
+  // The output must include the appropriate message based on the following
+  // enum values:
+  // APPLY_PATCHES = ApplyPatchesTaskOutput
+  // EXEC_STEP = ExecStepTaskOutput
+  TaskType task_type = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Descriptive error message if the task execution ended in error.
+  string error_message = 4;
+
+  // Final output details of the current task.
+  oneof output {
+    // Final output details of the apply patches task;
+    ApplyPatchesTaskOutput apply_patches_task_output = 5;
+
+    // Final output details of the exec step task;
+    ExecStepTaskOutput exec_step_task_output = 6;
+  }
+}
+
+// The response message after the agent signaled the current task complete.
+message ReportTaskCompleteResponse {
+
+}
+
+// The request message for registering the agent.
+message RegisterAgentRequest {
+  // Required. This is the Compute Engine instance identity token described in
+  // https://cloud.google.com/compute/docs/instances/verifying-instance-identity
+  // where the audience is 'osconfig.googleapis.com' and the format is 'full'.
+  string instance_id_token = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The version of the agent.
+  string agent_version = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The capabilities supported by the agent. Supported values are:
+  // PATCH_GA
+  // GUEST_POLICY_BETA
+  repeated string supported_capabilities = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The response message after the agent registered.
+message RegisterAgentResponse {
+
+}
diff --git a/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1/agentendpoint_grpc_service_config.json b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1/agentendpoint_grpc_service_config.json
new file mode 100644
index 000000000..38756d46e
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1/agentendpoint_grpc_service_config.json
@@ -0,0 +1,34 @@
+{
+  "methodConfig": [{
+    "name": [{ "service": "google.cloud.osconfig.agentendpoint.v1.AgentEndpointService" }],
+    "timeout": "60s",
+    "retryPolicy": {
+      "maxAttempts": 5,
+      "initialBackoff": "1s",
+      "maxBackoff": "60s",
+      "backoffMultiplier": 1.3,
+      "retryableStatusCodes": ["UNAVAILABLE"]
+    }
+  },{
+      "name": [
+        {
+          "service": "google.cloud.osconfig.agentendpoint.v1.AgentEndpointService",
+          "method": "ReceiveTaskNotification"
+        }
+      ],
+      "timeout": "3600s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "1s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "CANCELLED",
+          "ABORTED",
+          "INTERNAL",
+          "UNAVAILABLE"
+        ]
+      }
+    }]
+}
diff --git a/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1/osconfig_gapic.legacy.yaml b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1/osconfig_gapic.legacy.yaml
new file mode 100644
index 000000000..6e6362512
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1/osconfig_gapic.legacy.yaml
@@ -0,0 +1,148 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.osconfig.agentendpoint.v1
+  python:
+    package_name: google.cloud.osconfig.agentendpoint_v1.gapic
+  go:
+    package_name: cloud.google.com/go/osconfig/agentendpoint/apiv1
+  csharp:
+    package_name: Google.Cloud.OsConfig.Agentendpoint.V1
+  ruby:
+    package_name: Google::Cloud::OsConfig::Agentendpoint::V1
+  php:
+    package_name: Google\Cloud\OsConfig\Agentendpoint\V1
+  nodejs:
+    package_name: agentendpoint.v1
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: google.cloud.osconfig.agentendpoint.v1.AgentEndpointService
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections: []
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ReceiveTaskNotification
+    flattening:
+      groups:
+      - parameters:
+        - instance_id_token
+        - agent_version
+    required_fields:
+    - instance_id_token
+    - agent_version
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: StartNextTask
+    flattening:
+      groups:
+      - parameters:
+        - instance_id_token
+    required_fields:
+    - instance_id_token
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: ReportTaskProgress
+    flattening:
+      groups:
+      - parameters:
+        - instance_id_token
+        - task_id
+        - task_type
+    required_fields:
+    - instance_id_token
+    - task_id
+    - task_type
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: ReportTaskComplete
+    flattening:
+      groups:
+      - parameters:
+        - instance_id_token
+        - task_id
+        - task_type
+        - error_message
+    required_fields:
+    - instance_id_token
+    - task_id
+    - task_type
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1/osconfig_gapic.yaml b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1/osconfig_gapic.yaml
new file mode 100644
index 000000000..40ddcf764
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1/osconfig_gapic.yaml
@@ -0,0 +1,22 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 2.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.osconfig.agentendpoint.v1
+  python:
+    package_name: google.cloud.osconfig.agentendpoint_v1.gapic
+  go:
+    package_name: cloud.google.com/go/osconfig/agentendpoint/apiv1
+  csharp:
+    package_name: Google.Cloud.OsConfig.Agentendpoint.V1
+  ruby:
+    package_name: Google::Cloud::OsConfig::Agentendpoint::V1
+  php:
+    package_name: Google\Cloud\OsConfig\Agentendpoint\V1
+  nodejs:
+    package_name: agentendpoint.v1
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: google.cloud.osconfig.agentendpoint.v1.AgentEndpointService
diff --git a/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1/osconfig_v1.yaml b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1/osconfig_v1.yaml
new file mode 100644
index 000000000..f3f7d4432
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1/osconfig_v1.yaml
@@ -0,0 +1,19 @@
+type: google.api.Service
+config_version: 3
+name: osconfig.googleapis.com
+title: Cloud OS Config API
+
+apis:
+- name: google.cloud.osconfig.agentendpoint.v1.AgentEndpointService
+
+documentation:
+  summary: |-
+    OS management tools that can be used for patch management, patch
+    compliance, and configuration management on VM instances.
+
+backend:
+  rules:
+  - selector: 'google.cloud.osconfig.agentendpoint.v1.AgentEndpointService.*'
+    deadline: 30.0
+  - selector: google.cloud.osconfig.agentendpoint.v1.AgentEndpointService.ReceiveTaskNotification
+    deadline: 3600.0
diff --git a/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1/patch_jobs.proto b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1/patch_jobs.proto
new file mode 100644
index 000000000..8f37db3f8
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1/patch_jobs.proto
@@ -0,0 +1,288 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.osconfig.agentendpoint.v1;
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/osconfig/agentendpoint/v1;agentendpoint";
+option java_outer_classname = "PatchJobs";
+option java_package = "com.google.cloud.osconfig.agentendpoint.v1";
+
+// Patch configuration specifications. Contains details on how to
+// apply patches to a VM instance.
+message PatchConfig {
+  // Post-patch reboot settings.
+  enum RebootConfig {
+    // The default behavior is DEFAULT.
+    REBOOT_CONFIG_UNSPECIFIED = 0;
+
+    // The agent decides if a reboot is necessary by checking
+    // signals such as registry keys on Windows or `/var/run/reboot-required` on
+    // APT based systems. On RPM based systems, a set of core system package
+    // install times are compared with system boot time.
+    DEFAULT = 1;
+
+    // Always reboot the machine after the update completes.
+    ALWAYS = 2;
+
+    // Never reboot the machine after the update completes.
+    NEVER = 3;
+  }
+
+  // Post-patch reboot settings.
+  RebootConfig reboot_config = 1;
+
+  // Retry strategy can be defined to have the agent retry patching
+  // during the window if patching fails. If omitted, the agent will use its
+  // default retry strategy.
+  RetryStrategy retry_strategy = 2;
+
+  // Apt update settings. Use this override the default apt patch rules.
+  AptSettings apt = 3;
+
+  // Yum update settings. Use this override the default yum patch rules.
+  YumSettings yum = 4;
+
+  // Goo update settings. Use this override the default goo patch rules.
+  GooSettings goo = 5;
+
+  // Zypper update settings. Use this override the default zypper patch rules.
+  ZypperSettings zypper = 6;
+
+  // Windows update settings. Use this override the default windows patch rules.
+  WindowsUpdateSettings windows_update = 7;
+
+  // The ExecStep to run before the patch update.
+  ExecStep pre_step = 8;
+
+  // The ExecStep to run after the patch update.
+  ExecStep post_step = 9;
+}
+
+// Apt patching will be performed by executing `apt-get update && apt-get
+// upgrade`. Additional options can be set to control how this is executed.
+message AptSettings {
+  // Apt patch type.
+  enum Type {
+    // By default, upgrade will be performed.
+    TYPE_UNSPECIFIED = 0;
+
+    // Runs `apt-get dist-upgrade`.
+    DIST = 1;
+
+    // Runs `apt-get upgrade`.
+    UPGRADE = 2;
+  }
+
+  // By changing the type to DIST, the patching will be performed
+  // using `apt-get dist-upgrade` instead.
+  Type type = 1;
+
+  // List of packages to exclude from update.
+  repeated string excludes = 2;
+
+  // An exclusive list of packages to be updated. These are the only packages
+  // that will be updated. If these packages are not installed, they will be
+  // ignored. This field cannot be specified with any other patch configuration
+  // fields.
+  repeated string exclusive_packages = 3;
+}
+
+// Yum patching will be performed by executing `yum update`. Additional options
+// can be set to control how this is executed.
+//
+// Note that not all settings are supported on all platforms.
+message YumSettings {
+  // Adds the `--security` flag to `yum update`. Not supported on
+  // all platforms.
+  bool security = 1;
+
+  // Will cause patch to run `yum update-minimal` instead.
+  bool minimal = 2;
+
+  // List of packages to exclude from update. These packages will be excluded by
+  // using the yum `--exclude` flag.
+  repeated string excludes = 3;
+
+  // An exclusive list of packages to be updated. These are the only packages
+  // that will be updated. If these packages are not installed, they will be
+  // ignored. This field must not be specified with any other patch
+  // configuration fields.
+  repeated string exclusive_packages = 4;
+}
+
+// Googet patching is performed by running `googet update`.
+message GooSettings {
+
+}
+
+// Zypper patching is performed by running `zypper patch`.
+// See also https://en.opensuse.org/SDB:Zypper_manual.
+message ZypperSettings {
+  // Adds the `--with-optional` flag to `zypper patch`.
+  bool with_optional = 1;
+
+  // Adds the `--with-update` flag, to `zypper patch`.
+  bool with_update = 2;
+
+  // Install only patches with these categories.
+  // Common categories include security, recommended, and feature.
+  repeated string categories = 3;
+
+  // Install only patches with these severities.
+  // Common severities include critical, important, moderate, and low.
+  repeated string severities = 4;
+
+  // List of patches to exclude from update.
+  repeated string excludes = 5;
+
+  // An exclusive list of patches to be updated. These are the only patches
+  // that will be installed using 'zypper patch patch:' command.
+  // This field must not be used with any other patch configuration fields.
+  repeated string exclusive_patches = 6;
+}
+
+// Windows patching is performed using the Windows Update Agent.
+message WindowsUpdateSettings {
+  // Microsoft Windows update classifications as defined in
+  // [1]
+  // https://support.microsoft.com/en-us/help/824684/description-of-the-standard-terminology-that-is-used-to-describe-micro
+  enum Classification {
+    // Invalid. If classifications are included, they must be specified.
+    CLASSIFICATION_UNSPECIFIED = 0;
+
+    // "A widely released fix for a specific problem that addresses a critical,
+    // non-security-related bug." [1]
+    CRITICAL = 1;
+
+    // "A widely released fix for a product-specific, security-related
+    // vulnerability. Security vulnerabilities are rated by their severity. The
+    // severity rating is indicated in the Microsoft security bulletin as
+    // critical, important, moderate, or low." [1]
+    SECURITY = 2;
+
+    // "A widely released and frequent software update that contains additions
+    // to a product’s definition database. Definition databases are often used
+    // to detect objects that have specific attributes, such as malicious code,
+    // phishing websites, or junk mail." [1]
+    DEFINITION = 3;
+
+    // "Software that controls the input and output of a device." [1]
+    DRIVER = 4;
+
+    // "New product functionality that is first distributed outside the context
+    // of a product release and that is typically included in the next full
+    // product release." [1]
+    FEATURE_PACK = 5;
+
+    // "A tested, cumulative set of all hotfixes, security updates, critical
+    // updates, and updates. Additionally, service packs may contain additional
+    // fixes for problems that are found internally since the release of the
+    // product. Service packs my also contain a limited number of
+    // customer-requested design changes or features." [1]
+    SERVICE_PACK = 6;
+
+    // "A utility or feature that helps complete a task or set of tasks." [1]
+    TOOL = 7;
+
+    // "A tested, cumulative set of hotfixes, security updates, critical
+    // updates, and updates that are packaged together for easy deployment. A
+    // rollup generally targets a specific area, such as security, or a
+    // component of a product, such as Internet Information Services (IIS)." [1]
+    UPDATE_ROLLUP = 8;
+
+    // "A widely released fix for a specific problem. An update addresses a
+    // noncritical, non-security-related bug." [1]
+    UPDATE = 9;
+  }
+
+  // Only apply updates of these windows update classifications. If empty, all
+  // updates will be applied.
+  repeated Classification classifications = 1;
+
+  // List of KBs to exclude from update.
+  repeated string excludes = 2;
+
+  // An exclusive list of kbs to be updated. These are the only patches
+  // that will be updated. This field must not be used with other
+  // patch configurations.
+  repeated string exclusive_patches = 3;
+}
+
+// The strategy for retrying failed patches during the patch window.
+message RetryStrategy {
+  // If true, the agent will continue to try and patch until the window has
+  // ended.
+  bool enabled = 1;
+}
+
+// A step that runs an executable for a PatchJob.
+message ExecStep {
+  // The ExecStepConfig for all Linux VMs targeted by the PatchJob.
+  ExecStepConfig linux_exec_step_config = 1;
+
+  // The ExecStepConfig for all Windows VMs targeted by the PatchJob.
+  ExecStepConfig windows_exec_step_config = 2;
+}
+
+// Common configurations for an ExecStep.
+message ExecStepConfig {
+  // The interpreter used to execute the a file.
+  enum Interpreter {
+    // Invalid for a Windows ExecStepConfig. For a Linux ExecStepConfig, the
+    // interpreter will be parsed from the shebang line of the script if
+    // unspecified.
+    INTERPRETER_UNSPECIFIED = 0;
+
+    // Indicates that the script will be run with /bin/sh on Linux and cmd
+    // on windows.
+    SHELL = 1;
+
+    // Indicates that the file will be run with PowerShell.
+    POWERSHELL = 2;
+  }
+
+  // Location of the executable.
+  oneof executable {
+    // An absolute path to the executable on the VM.
+    string local_path = 1;
+
+    // A GCS object containing the executable.
+    GcsObject gcs_object = 2;
+  }
+
+  // Defaults to [0]. A list of possible return values that the
+  // execution can return to indicate a success.
+  repeated int32 allowed_success_codes = 3;
+
+  // The script interpreter to use to run the script. If no interpreter is
+  // specified the script will be executed directly, which will likely
+  // only succeed for scripts with shebang lines.
+  // [Wikipedia shebang](https://en.wikipedia.org/wiki/Shebang_(Unix)).
+  Interpreter interpreter = 4;
+}
+
+// GCS object representation.
+message GcsObject {
+  // Bucket of the GCS object.
+  string bucket = 1;
+
+  // Name of the GCS object.
+  string object = 2;
+
+  // Generation number of the GCS object. This is used to ensure that the
+  // ExecStep specified by this PatchJob does not change.
+  int64 generation_number = 3;
+}
diff --git a/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1/tasks.proto b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1/tasks.proto
new file mode 100644
index 000000000..426dc22f1
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1/tasks.proto
@@ -0,0 +1,179 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.osconfig.agentendpoint.v1;
+
+import "google/api/field_behavior.proto";
+import "google/cloud/osconfig/agentendpoint/v1/patch_jobs.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/osconfig/agentendpoint/v1;agentendpoint";
+option java_outer_classname = "Tasks";
+option java_package = "com.google.cloud.osconfig.agentendpoint.v1";
+
+// Specifies the current agent behavior.
+enum TaskDirective {
+  // Unspecified is invalid.
+  TASK_DIRECTIVE_UNSPECIFIED = 0;
+
+  // The task should continue to progress.
+  CONTINUE = 1;
+
+  // Task should not be started, or if already in progress, should stop
+  // at first safe stopping point.  Task should be considered done and will
+  // never repeat.
+  STOP = 2;
+}
+
+// Specifies the type of task to perform.
+enum TaskType {
+  // Unspecified is invalid.
+  TASK_TYPE_UNSPECIFIED = 0;
+
+  // The apply patches task.
+  APPLY_PATCHES = 1;
+
+  // The exec step task.
+  EXEC_STEP_TASK = 2;
+}
+
+// A unit of work to be performed by the agent.
+message Task {
+  // Unique task id.
+  string task_id = 1;
+
+  // The type of task to perform.
+  //
+  // Task details must include the appropriate message based on this enum as
+  // specified below:
+  // APPLY_PATCHES = ApplyPatchesTask
+  // EXEC_STEP = ExecStepTask;
+  TaskType task_type = 2;
+
+  // Current directive to the agent.
+  TaskDirective task_directive = 3;
+
+  // Specific details about the current task to perform.
+  oneof task_details {
+    // Details about the apply patches task to perform.
+    ApplyPatchesTask apply_patches_task = 4;
+
+    // Details about the exec step task to perform.
+    ExecStepTask exec_step_task = 5;
+  }
+
+  // Labels describing the task.  Used for logging by the agent.
+  map service_labels = 6;
+}
+
+// Message which instructs agent to apply patches.
+message ApplyPatchesTask {
+  // Specific information about how patches should be applied.
+  PatchConfig patch_config = 1;
+
+  // If true, the agent will report its status as it goes through the motions
+  // but won't actually run any updates or perform any reboots.
+  bool dry_run = 3;
+}
+
+// Information reported from the agent about applying patches execution.
+message ApplyPatchesTaskProgress {
+  // The intermediate states of applying patches.
+  enum State {
+    // Unspecified is invalid.
+    STATE_UNSPECIFIED = 0;
+
+    // The agent has started the patch task.
+    STARTED = 4;
+
+    // The agent is currently downloading patches.
+    DOWNLOADING_PATCHES = 1;
+
+    // The agent is currently applying patches.
+    APPLYING_PATCHES = 2;
+
+    // The agent is currently rebooting the VM instance.
+    REBOOTING = 3;
+  }
+
+  // Required. The current state of this patch execution.
+  State state = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Information reported from the agent about applying patches execution.
+message ApplyPatchesTaskOutput {
+  // The final states of applying patches.
+  enum State {
+    // Unspecified is invalid.
+    STATE_UNSPECIFIED = 0;
+
+    // Applying patches completed successfully.
+    SUCCEEDED = 1;
+
+    // Applying patches completed successfully, but a reboot is required.
+    SUCCEEDED_REBOOT_REQUIRED = 2;
+
+    // Applying patches failed.
+    FAILED = 3;
+  }
+
+  // Required. The final state of this task.
+  State state = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Message which instructs agent to execute the following command.
+message ExecStepTask {
+  // Details of the exec step to run.
+  ExecStep exec_step = 1;
+}
+
+// Information reported from the agent about the exec step execution.
+message ExecStepTaskProgress {
+  // The intermediate states of exec steps.
+  enum State {
+    // Unspecified is invalid.
+    STATE_UNSPECIFIED = 0;
+
+    // The agent has started the exec step task.
+    STARTED = 1;
+  }
+
+  // Required. The current state of this exec step.
+  State state = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Information reported from the agent about the exec step execution.
+message ExecStepTaskOutput {
+  // The final states of exec steps.
+  enum State {
+    // Unspecified is invalid.
+    STATE_UNSPECIFIED = 0;
+
+    // The exec step completed normally.
+    COMPLETED = 1;
+
+    // The exec step was terminated because it took too long.
+    TIMED_OUT = 2;
+
+    // The exec step task was cancelled before it started.
+    CANCELLED = 3;
+  }
+
+  // Required. The final state of the exec step.
+  State state = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The exit code received from the script which ran as part of the exec step.
+  int32 exit_code = 2 [(google.api.field_behavior) = REQUIRED];
+}
diff --git a/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/BUILD.bazel b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/BUILD.bazel
new file mode 100644
index 000000000..f1d590e9b
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/BUILD.bazel
@@ -0,0 +1,357 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "agentendpoint_proto",
+    srcs = [
+        "agentendpoint.proto",
+        "guest_policies.proto",
+        "patch_jobs.proto",
+        "tasks.proto",
+    ],
+    deps = [
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "agentendpoint_proto_with_info",
+    deps = [
+        ":agentendpoint_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "agentendpoint_java_proto",
+    deps = [":agentendpoint_proto"],
+)
+
+java_grpc_library(
+    name = "agentendpoint_java_grpc",
+    srcs = [":agentendpoint_proto"],
+    deps = [":agentendpoint_java_proto"],
+)
+
+java_gapic_library(
+    name = "agentendpoint_java_gapic",
+    src = ":agentendpoint_proto_with_info",
+    gapic_yaml = "osconfig_gapic.yaml",
+    package = "google.cloud.osconfig.agentendpoint.v1beta",
+    service_yaml = "osconfig_v1beta.yaml",
+    test_deps = [
+        ":agentendpoint_java_grpc",
+    ],
+    deps = [
+        ":agentendpoint_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "agentendpoint_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.osconfig.agentendpoint.v1beta.AgentEndpointServiceClientTest",
+    ],
+    runtime_deps = [":agentendpoint_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-osconfig-agentendpoint-v1beta-java",
+    deps = [
+        ":agentendpoint_java_gapic",
+        ":agentendpoint_java_grpc",
+        ":agentendpoint_java_proto",
+        ":agentendpoint_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "agentendpoint_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/osconfig/agentendpoint/v1beta",
+    protos = [":agentendpoint_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "agentendpoint_go_gapic",
+    srcs = [":agentendpoint_proto_with_info"],
+    grpc_service_config = "agentendpoint_grpc_service_config.json",
+    importpath = "cloud.google.com/go/osconfig/agentendpoint/apiv1beta;agentendpoint",
+    service_yaml = "osconfig_v1beta.yaml",
+    deps = [
+        ":agentendpoint_go_proto",
+    ],
+)
+
+go_test(
+    name = "agentendpoint_go_gapic_test",
+    srcs = [":agentendpoint_go_gapic_srcjar_test"],
+    embed = [":agentendpoint_go_gapic"],
+    importpath = "cloud.google.com/go/osconfig/agentendpoint/apiv1beta",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-osconfig-agentendpoint-v1beta-go",
+    deps = [
+        ":agentendpoint_go_gapic",
+        ":agentendpoint_go_gapic_srcjar-test.srcjar",
+        ":agentendpoint_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "agentendpoint_moved_proto",
+    srcs = [":agentendpoint_proto"],
+    deps = [
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+    ],
+)
+
+py_proto_library(
+    name = "agentendpoint_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":agentendpoint_moved_proto"],
+)
+
+py_grpc_library(
+    name = "agentendpoint_py_grpc",
+    srcs = [":agentendpoint_moved_proto"],
+    deps = [":agentendpoint_py_proto"],
+)
+
+py_gapic_library(
+    name = "agentendpoint_py_gapic",
+    src = ":agentendpoint_proto_with_info",
+    gapic_yaml = "osconfig_gapic.yaml",
+    package = "google.cloud.osconfig.agentendpoint.v1beta",
+    service_yaml = "osconfig_v1beta.yaml",
+    deps = [
+        ":agentendpoint_py_grpc",
+        ":agentendpoint_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "osconfig-agentendpoint-v1beta-py",
+    deps = [
+        ":agentendpoint_py_gapic",
+        ":agentendpoint_py_grpc",
+        ":agentendpoint_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "agentendpoint_php_proto",
+    deps = [":agentendpoint_proto"],
+)
+
+php_grpc_library(
+    name = "agentendpoint_php_grpc",
+    srcs = [":agentendpoint_proto"],
+    deps = [":agentendpoint_php_proto"],
+)
+
+# Add api.http options to all RPCs in the services to enable PHP GAPIC
+#  generation
+#php_gapic_library(
+#    name = "agentendpoint_php_gapic",
+#    src = ":agentendpoint_proto_with_info",
+#    gapic_yaml = "osconfig_gapic.yaml",
+#    package = "google.cloud.osconfig.agentendpoint.v1beta",
+#    service_yaml = "osconfig_v1beta.yaml",
+#    deps = [
+#        ":agentendpoint_php_grpc",
+#        ":agentendpoint_php_proto",
+#    ],
+#)
+#
+## Open Source Packages
+#php_gapic_assembly_pkg(
+#    name = "google-cloud-osconfig-agentendpoint-v1beta-php",
+#    deps = [
+#        ":agentendpoint_php_gapic",
+#        ":agentendpoint_php_grpc",
+#        ":agentendpoint_php_proto",
+#    ],
+#)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "agentendpoint_nodejs_gapic",
+    src = ":agentendpoint_proto_with_info",
+    gapic_yaml = "osconfig_gapic.yaml",
+    package = "google.cloud.osconfig.agentendpoint.v1beta",
+    service_yaml = "osconfig_v1beta.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "osconfig-agentendpoint-v1beta-nodejs",
+    deps = [
+        ":agentendpoint_nodejs_gapic",
+        ":agentendpoint_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "agentendpoint_ruby_proto",
+    deps = [":agentendpoint_proto"],
+)
+
+ruby_grpc_library(
+    name = "agentendpoint_ruby_grpc",
+    srcs = [":agentendpoint_proto"],
+    deps = [":agentendpoint_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "agentendpoint_ruby_gapic",
+    src = ":agentendpoint_proto_with_info",
+    gapic_yaml = "osconfig_gapic.yaml",
+    package = "google.cloud.osconfig.agentendpoint.v1beta",
+    service_yaml = "osconfig_v1beta.yaml",
+    deps = [
+        ":agentendpoint_ruby_grpc",
+        ":agentendpoint_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-osconfig-agentendpoint-v1beta-ruby",
+    deps = [
+        ":agentendpoint_ruby_gapic",
+        ":agentendpoint_ruby_grpc",
+        ":agentendpoint_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "agentendpoint_csharp_proto",
+    deps = [":agentendpoint_proto"],
+)
+
+csharp_grpc_library(
+    name = "agentendpoint_csharp_grpc",
+    srcs = [":agentendpoint_proto"],
+    deps = [":agentendpoint_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "agentendpoint_csharp_gapic",
+    src = ":agentendpoint_proto_with_info",
+    gapic_yaml = "osconfig_gapic.yaml",
+    package = "google.cloud.osconfig.agentendpoint.v1beta",
+    service_yaml = "osconfig_v1beta.yaml",
+    deps = [
+        ":agentendpoint_csharp_grpc",
+        ":agentendpoint_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-osconfig-agentendpoint-v1beta-csharp",
+    deps = [
+        ":agentendpoint_csharp_gapic",
+        ":agentendpoint_csharp_grpc",
+        ":agentendpoint_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/agentendpoint.proto b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/agentendpoint.proto
new file mode 100644
index 000000000..88982c7c2
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/agentendpoint.proto
@@ -0,0 +1,187 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.osconfig.agentendpoint.v1beta;
+
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/cloud/osconfig/agentendpoint/v1beta/guest_policies.proto";
+import "google/cloud/osconfig/agentendpoint/v1beta/tasks.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/osconfig/agentendpoint/v1beta;agentendpoint";
+option java_multiple_files = true;
+option java_outer_classname = "AgentEndpointProto";
+option java_package = "com.google.cloud.osconfig.agentendpoint.v1beta";
+
+// OS Config agent endpoint API.
+service AgentEndpointService {
+  option (google.api.default_host) = "osconfig.googleapis.com";
+
+  // Stream established by client to receive Task notifications.
+  rpc ReceiveTaskNotification(ReceiveTaskNotificationRequest) returns (stream ReceiveTaskNotificationResponse) {
+    option (google.api.method_signature) = "instance_id_token,agent_version";
+  }
+
+  // Signals the start of a task execution and returns the task info.
+  rpc StartNextTask(StartNextTaskRequest) returns (StartNextTaskResponse) {
+    option (google.api.method_signature) = "instance_id_token";
+  }
+
+  // Signals an intermediary progress checkpoint in task execution.
+  rpc ReportTaskProgress(ReportTaskProgressRequest) returns (ReportTaskProgressResponse) {
+    option (google.api.method_signature) = "instance_id_token,task_id,task_type";
+  }
+
+  // Signals that the task execution is complete and optionally returns the next
+  // task.
+  rpc ReportTaskComplete(ReportTaskCompleteRequest) returns (ReportTaskCompleteResponse) {
+    option (google.api.method_signature) = "instance_id_token,task_id,task_type,error_message";
+  }
+
+  // Lookup the effective guest policy that applies to a VM instance. This
+  // lookup merges all policies that are assigned to the instance ancestry.
+  rpc LookupEffectiveGuestPolicy(LookupEffectiveGuestPolicyRequest) returns (EffectiveGuestPolicy) {
+    option (google.api.method_signature) = "instance_id_token,os_short_name,os_version,os_architecture";
+  }
+
+  // Registers the agent running on the VM.
+  rpc RegisterAgent(RegisterAgentRequest) returns (RegisterAgentResponse) {
+    option (google.api.method_signature) = "instance_id_token,agent_version,supported_capabilities";
+  }
+}
+
+// A request message to receive task notifications.
+message ReceiveTaskNotificationRequest {
+  // Required. This is the Compute Engine instance identity token described in
+  // https://cloud.google.com/compute/docs/instances/verifying-instance-identity
+  // where the audience is 'osconfig.googleapis.com' and the format is 'full'.
+  string instance_id_token = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The version of the agent making the request.
+  string agent_version = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The streaming rpc message that notifies the agent when it has a task
+// that it needs to perform on the VM instance.
+message ReceiveTaskNotificationResponse {
+
+}
+
+// A request message for signaling the start of a task execution.
+message StartNextTaskRequest {
+  // Required. This is the Compute Engine instance identity token described in
+  // https://cloud.google.com/compute/docs/instances/verifying-instance-identity
+  // where the audience is 'osconfig.googleapis.com' and the format is 'full'.
+  string instance_id_token = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// A response message that contains the details of the task to work on.
+message StartNextTaskResponse {
+  // The details of the task that should be worked on.  Can be empty if there
+  // is no new task to work on.
+  Task task = 1;
+}
+
+// A request message for reporting the progress of current task.
+message ReportTaskProgressRequest {
+  // Required. This is the Compute Engine instance identity token described in
+  // https://cloud.google.com/compute/docs/instances/verifying-instance-identity
+  // where the audience is 'osconfig.googleapis.com' and the format is 'full'.
+  string instance_id_token = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Unique identifier of the task this applies to.
+  string task_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The type of task to report progress on.
+  //
+  // Progress must include the appropriate message based on this enum as
+  // specified below:
+  // APPLY_PATCHES = ApplyPatchesTaskProgress
+  // EXEC_STEP = Progress not supported for this type.
+  TaskType task_type = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Intermediate progress of the current task.
+  oneof progress {
+    // Details about the progress of the apply patches task.
+    ApplyPatchesTaskProgress apply_patches_task_progress = 4;
+
+    // Details about the progress of the exec step task.
+    ExecStepTaskProgress exec_step_task_progress = 5;
+  }
+}
+
+// The response message after the agent reported the current task progress.
+message ReportTaskProgressResponse {
+  // Instructs agent to continue or not.
+  TaskDirective task_directive = 1;
+}
+
+// A request message for signaling the completion of a task execution.
+message ReportTaskCompleteRequest {
+  // Required. This is the Compute Engine instance identity token described in
+  // https://cloud.google.com/compute/docs/instances/verifying-instance-identity
+  // where the audience is 'osconfig.googleapis.com' and the format is 'full'.
+  string instance_id_token = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Unique identifier of the task this applies to.
+  string task_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The type of task to report completed.
+  //
+  // The output must include the appropriate message based on the following
+  // enum values:
+  // APPLY_PATCHES = ApplyPatchesTaskOutput
+  // EXEC_STEP = ExecStepTaskOutput
+  TaskType task_type = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Descriptive error message if the task execution ended in error.
+  string error_message = 4;
+
+  // Final output details of the current task.
+  oneof output {
+    // Final output details of the apply patches task;
+    ApplyPatchesTaskOutput apply_patches_task_output = 5;
+
+    // Final output details of the exec step task;
+    ExecStepTaskOutput exec_step_task_output = 6;
+  }
+}
+
+// The response message after the agent signaled the current task complete.
+message ReportTaskCompleteResponse {
+
+}
+
+// The request message for registering the agent.
+message RegisterAgentRequest {
+  // Required. This is the Compute Engine instance identity token described in
+  // https://cloud.google.com/compute/docs/instances/verifying-instance-identity
+  // where the audience is 'osconfig.googleapis.com' and the format is 'full'.
+  string instance_id_token = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The version of the agent.
+  string agent_version = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The capabilities supported by the agent. Supported values are:
+  // PATCH_GA
+  // GUEST_POLICY_BETA
+  repeated string supported_capabilities = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The response message after the agent registered.
+message RegisterAgentResponse {
+
+}
diff --git a/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/agentendpoint_grpc_service_config.json b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/agentendpoint_grpc_service_config.json
new file mode 100644
index 000000000..0831402de
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/agentendpoint_grpc_service_config.json
@@ -0,0 +1,34 @@
+{
+  "methodConfig": [{
+    "name": [{ "service": "google.cloud.osconfig.agentendpoint.v1beta.AgentEndpointService" }],
+    "timeout": "60s",
+    "retryPolicy": {
+      "maxAttempts": 5,
+      "initialBackoff": "1s",
+      "maxBackoff": "60s",
+      "backoffMultiplier": 1.3,
+      "retryableStatusCodes": ["UNAVAILABLE"]
+    }
+  },{
+      "name": [
+        {
+          "service": "google.cloud.osconfig.agentendpoint.v1beta.AgentEndpointService",
+          "method": "ReceiveTaskNotification"
+        }
+      ],
+      "timeout": "3600s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "1s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "CANCELLED",
+          "ABORTED",
+          "INTERNAL",
+          "UNAVAILABLE"
+        ]
+      }
+    }]
+}
diff --git a/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/artman_osconfig_v1beta.yaml b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/artman_osconfig_v1beta.yaml
new file mode 100644
index 000000000..383d1f242
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/artman_osconfig_v1beta.yaml
@@ -0,0 +1,16 @@
+common:
+  api_name: osconfig
+  api_version: v1beta
+  organization_name: google-cloud
+  proto_deps:
+  - name: google-common-protos
+  src_proto_paths:
+  - .
+  service_yaml: osconfig_v1beta.yaml
+  gapic_yaml: osconfig_gapic.yaml
+artifacts:
+- name: gapic_config
+  type: GAPIC_CONFIG
+- name: go_gapic
+  type: GAPIC
+  language: GO
diff --git a/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/guest_policies.proto b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/guest_policies.proto
new file mode 100644
index 000000000..cb0d2fe83
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/guest_policies.proto
@@ -0,0 +1,561 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.osconfig.agentendpoint.v1beta;
+
+import "google/api/field_behavior.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/osconfig/agentendpoint/v1beta;agentendpoint";
+option java_outer_classname = "GuestPolicies";
+option java_package = "com.google.cloud.osconfig.agentendpoint.v1beta";
+
+// The desired state that the OS Config agent will maintain on the VM.
+enum DesiredState {
+  // The default is to ensure the package is installed.
+  DESIRED_STATE_UNSPECIFIED = 0;
+
+  // The agent ensures that the package is installed.
+  INSTALLED = 1;
+
+  // The agent ensures that the package is installed and
+  // periodically checks for and install any updates.
+  UPDATED = 2;
+
+  // The agent ensures that the package is not installed and uninstall it
+  // if detected.
+  REMOVED = 3;
+}
+
+// Package is a reference to the software package to be installed or removed.
+// The agent on the VM instance uses the system package manager to apply the
+// config.
+//
+//
+// These are the commands that the agent uses to install or remove
+// packages.
+//
+// Apt
+// install: `apt-get update && apt-get -y install package1 package2 package3`
+// remove: `apt-get -y remove package1 package2 package3`
+//
+// Yum
+// install: `yum -y install package1 package2 package3`
+// remove: `yum -y remove package1 package2 package3`
+//
+// Zypper
+// install: `zypper install package1 package2 package3`
+// remove: `zypper rm package1 package2`
+//
+// Googet
+// install: `googet -noconfirm install package1 package2 package3`
+// remove: `googet -noconfirm remove package1 package2 package3`
+message Package {
+  // Types of package managers that may be used to manage this package.
+  enum Manager {
+    // The default behavior is ANY.
+    MANAGER_UNSPECIFIED = 0;
+
+    // Apply this package config using the default system package manager.
+    ANY = 1;
+
+    // Apply this package config only if Apt is available on the system.
+    APT = 2;
+
+    // Apply this package config only if Yum is available on the system.
+    YUM = 3;
+
+    // Apply this package config only if Zypper is available on the system.
+    ZYPPER = 4;
+
+    // Apply this package config only if GooGet is available on the system.
+    GOO = 5;
+  }
+
+  // The name of the package. A package is uniquely identified for conflict
+  // validation by checking the package name and the manager(s) that the
+  // package targets.
+  string name = 1;
+
+  // The desired_state the agent should maintain for this package. The
+  // default is to ensure the package is installed.
+  DesiredState desired_state = 2;
+
+  // Type of package manager that can be used to install this package.
+  // If a system does not have the package manager, the package is not
+  // installed or removed no error message is returned. By default,
+  // or if you specify `ANY`,
+  // the agent attempts to install and remove this package using the default
+  // package manager. This is useful when creating a policy that applies to
+  // different types of systems.
+  //
+  // The default behavior is ANY.
+  Manager manager = 3;
+}
+
+// Represents a single Apt package repository. This repository is added to
+// a repo file that is stored at
+// `/etc/apt/sources.list.d/google_osconfig.list`.
+message AptRepository {
+  // Type of archive.
+  enum ArchiveType {
+    // Unspecified.
+    ARCHIVE_TYPE_UNSPECIFIED = 0;
+
+    // DEB indicates that the archive contains binary files.
+    DEB = 1;
+
+    // DEB_SRC indicates that the archive contains source files.
+    DEB_SRC = 2;
+  }
+
+  // Type of archive files in this repository. The default behavior is DEB.
+  ArchiveType archive_type = 1;
+
+  // URI for this repository.
+  string uri = 2;
+
+  // Distribution of this repository.
+  string distribution = 3;
+
+  // List of components for this repository. Must contain at least one item.
+  repeated string components = 4;
+
+  // URI of the key file for this repository. The agent maintains
+  // a keyring at `/etc/apt/trusted.gpg.d/osconfig_agent_managed.gpg` containing
+  // all the keys in any applied guest policy.
+  string gpg_key = 5;
+}
+
+// Represents a single Yum package repository. This repository is added to a
+// repo file that is stored at `/etc/yum.repos.d/google_osconfig.repo`.
+message YumRepository {
+  // A one word, unique name for this repository. This is
+  // the `repo id` in the Yum config file and also the `display_name` if
+  // `display_name` is omitted. This id is also used as the unique identifier
+  // when checking for guest policy conflicts.
+  string id = 1;
+
+  // The display name of the repository.
+  string display_name = 2;
+
+  // The location of the repository directory.
+  string base_url = 3;
+
+  // URIs of GPG keys.
+  repeated string gpg_keys = 4;
+}
+
+// Represents a single Zypper package repository. This repository is added to a
+// repo file that is stored at `/etc/zypp/repos.d/google_osconfig.repo`.
+message ZypperRepository {
+  // A one word, unique name for this repository. This is
+  // the `repo id` in the zypper config file and also the `display_name` if
+  // `display_name` is omitted. This id is also used as the unique identifier
+  // when checking for guest policy conflicts.
+  string id = 1;
+
+  // The display name of the repository.
+  string display_name = 2;
+
+  // The location of the repository directory.
+  string base_url = 3;
+
+  // URIs of GPG keys.
+  repeated string gpg_keys = 4;
+}
+
+// Represents a Goo package repository. These is added to a repo file
+// that is stored at C:/ProgramData/GooGet/repos/google_osconfig.repo.
+message GooRepository {
+  // The name of the repository.
+  string name = 1;
+
+  // The url of the repository.
+  string url = 2;
+}
+
+// A package repository.
+message PackageRepository {
+  // A specific type of repository.
+  oneof repository {
+    // An Apt Repository.
+    AptRepository apt = 1;
+
+    // A Yum Repository.
+    YumRepository yum = 2;
+
+    // A Zypper Repository.
+    ZypperRepository zypper = 3;
+
+    // A Goo Repository.
+    GooRepository goo = 4;
+  }
+}
+
+// A software recipe is a set of instructions for installing and configuring a
+// piece of software. It consists of a set of artifacts that are
+// downloaded, and a set of steps that install, configure, and/or update the
+// software.
+//
+// Recipes support installing and updating software from artifacts in the
+// following formats:
+// Zip archive, Tar archive, Windows MSI, Debian package, and RPM package.
+//
+// Additionally, recipes support executing a script (either defined in a file or
+// directly in this api) in bash, sh, cmd, and powershell.
+//
+// Updating a software recipe
+//
+// If a recipe is assigned to an instance and there is a recipe with the same
+// name but a lower version already installed and the assigned state
+// of the recipe is `INSTALLED_KEEP_UPDATED`, then the recipe is updated to
+// the new version.
+//
+// Script Working Directories
+//
+// Each script or execution step is run in its own temporary directory which
+// is deleted after completing the step.
+message SoftwareRecipe {
+  // Specifies a resource to be used in the recipe.
+  message Artifact {
+    // Specifies an artifact available via some URI.
+    message Remote {
+      // URI from which to fetch the object. It should contain both the protocol
+      // and path following the format {protocol}://{location}.
+      string uri = 1;
+
+      // Must be provided if `allow_insecure` is `false`.
+      // SHA256 checksum in hex format, to compare to the checksum of the
+      // artifact. If the checksum is not empty and it doesn't match the
+      // artifact then the recipe installation fails before running any of the
+      // steps.
+      string checksum = 2;
+    }
+
+    // Specifies an artifact available as a Cloud Storage object.
+    message Gcs {
+      // Bucket of the Cloud Storage object.
+      // Given an example URL:
+      // `https://storage.googleapis.com/my-bucket/foo/bar#1234567`
+      // this value would be `my-bucket`.
+      string bucket = 1;
+
+      // Name of the Cloud Storage object.
+      // As specified [here]
+      // (https://cloud.google.com/storage/docs/naming#objectnames)
+      // Given an example URL:
+      // `https://storage.googleapis.com/my-bucket/foo/bar#1234567`
+      // this value would be `foo/bar`.
+      string object = 2;
+
+      // Must be provided if allow_insecure is false.
+      // Generation number of the Cloud Storage object.
+      // `https://storage.googleapis.com/my-bucket/foo/bar#1234567`
+      // this value would be `1234567`.
+      int64 generation = 3;
+    }
+
+    // Id of the artifact, which the installation and update steps of this
+    // recipe can reference. Artifacts in a recipe cannot have the same id.
+    string id = 1;
+
+    // A specific type of artifact.
+    oneof artifact {
+      // A generic remote artifact.
+      Remote remote = 2;
+
+      // A Cloud Storage artifact.
+      Gcs gcs = 3;
+    }
+
+    // Defaults to false. When false, recipes are subject to validations
+    // based on the artifact type:
+    //
+    // Remote: A checksum must be specified, and only protocols with
+    //         transport-layer security are permitted.
+    // GCS:    An object generation number must be specified.
+    bool allow_insecure = 4;
+  }
+
+  // An action that can be taken as part of installing or updating a recipe.
+  message Step {
+    // Copies the artifact to the specified path on the instance.
+    message CopyFile {
+      // The id of the relevant artifact in the recipe.
+      string artifact_id = 1;
+
+      // The absolute path on the instance to put the file.
+      string destination = 2;
+
+      // Whether to allow this step to overwrite existing files. If this is
+      // false and the file already exists the file is not overwritten
+      // and the step is considered a success. Defaults to false.
+      bool overwrite = 3;
+
+      // Consists of three octal digits which represent, in
+      // order, the permissions of the owner, group, and other users for the
+      // file (similarly to the numeric mode used in the linux chmod utility).
+      // Each digit represents a three bit number with the 4 bit
+      // corresponding to the read permissions, the 2 bit corresponds to the
+      // write bit, and the one bit corresponds to the execute permission.
+      // Default behavior is 755.
+      //
+      // Below are some examples of permissions and their associated values:
+      // read, write, and execute: 7
+      // read and execute: 5
+      // read and write: 6
+      // read only: 4
+      string permissions = 4;
+    }
+
+    // Extracts an archive of the type specified in the specified directory.
+    message ExtractArchive {
+      // Specifying the type of archive.
+      enum ArchiveType {
+        // Indicates that the archive type isn't specified.
+        ARCHIVE_TYPE_UNSPECIFIED = 0;
+
+        // Indicates that the archive is a tar archive with no encryption.
+        TAR = 1;
+
+        // Indicates that the archive is a tar archive with gzip encryption.
+        TAR_GZIP = 2;
+
+        // Indicates that the archive is a tar archive with bzip encryption.
+        TAR_BZIP = 3;
+
+        // Indicates that the archive is a tar archive with lzma encryption.
+        TAR_LZMA = 4;
+
+        // Indicates that the archive is a tar archive with xz encryption.
+        TAR_XZ = 5;
+
+        // Indicates that the archive is a zip archive.
+        ZIP = 11;
+      }
+
+      // The id of the relevant artifact in the recipe.
+      string artifact_id = 1;
+
+      // Directory to extract archive to.
+      // Defaults to `/` on Linux or `C:\` on Windows.
+      string destination = 2;
+
+      // The type of the archive to extract.
+      ArchiveType type = 3;
+    }
+
+    // Installs an MSI file.
+    message InstallMsi {
+      // The id of the relevant artifact in the recipe.
+      string artifact_id = 1;
+
+      // The flags to use when installing the MSI
+      // defaults to ["/i"] (i.e. the install flag).
+      repeated string flags = 2;
+
+      // Return codes that indicate that the software installed or updated
+      // successfully. Behaviour defaults to [0]
+      repeated int32 allowed_exit_codes = 3;
+    }
+
+    // Installs a deb via dpkg.
+    message InstallDpkg {
+      // The id of the relevant artifact in the recipe.
+      string artifact_id = 1;
+    }
+
+    // Installs an rpm file via the rpm utility.
+    message InstallRpm {
+      // The id of the relevant artifact in the recipe.
+      string artifact_id = 1;
+    }
+
+    // Executes an artifact or local file.
+    message ExecFile {
+      // Location of the file to execute.
+      oneof location_type {
+        // The id of the relevant artifact in the recipe.
+        string artifact_id = 1;
+
+        // The absolute path of the file on the local filesystem.
+        string local_path = 2;
+      }
+
+      // Arguments to be passed to the provided executable.
+      repeated string args = 3;
+
+      // Defaults to [0]. A list of possible return values that the program
+      // can return to indicate a success.
+      repeated int32 allowed_exit_codes = 4;
+    }
+
+    // Runs a script through an interpreter.
+    message RunScript {
+      // The interpreter used to execute a script.
+      enum Interpreter {
+        // Default value for ScriptType.
+        INTERPRETER_UNSPECIFIED = 0;
+
+        // Indicates that the script is run with `/bin/sh` on Linux and `cmd`
+        // on windows.
+        SHELL = 1;
+
+        // Indicates that the script is run with powershell.
+        POWERSHELL = 3;
+      }
+
+      // The shell script to be executed.
+      string script = 1;
+
+      // Return codes that indicate that the software installed or updated
+      // successfully. Behaviour defaults to [0]
+      repeated int32 allowed_exit_codes = 2;
+
+      // The script interpreter to use to run the script. If no interpreter is
+      // specified the script is executed directly, which likely
+      // only succeed for scripts with
+      // [shebang lines](https://en.wikipedia.org/wiki/Shebang_(Unix)).
+      Interpreter interpreter = 3;
+    }
+
+    // A specific type of step.
+    oneof step {
+      // Copies a file onto the instance.
+      CopyFile file_copy = 1;
+
+      // Extracts an archive into the specified directory.
+      ExtractArchive archive_extraction = 2;
+
+      // Installs an MSI file.
+      InstallMsi msi_installation = 3;
+
+      // Installs a deb file via dpkg.
+      InstallDpkg dpkg_installation = 4;
+
+      // Installs an rpm file via the rpm utility.
+      InstallRpm rpm_installation = 5;
+
+      // Executes an artifact or local file.
+      ExecFile file_exec = 6;
+
+      // Runs commands in a shell.
+      RunScript script_run = 7;
+    }
+  }
+
+  // Unique identifier for the recipe. Only one recipe with a given name is
+  // installed on an instance.
+  //
+  // Names are also used to identify resources which helps to determine whether
+  // guest policies have conflicts. This means that requests to create multiple
+  // recipes with the same name and version are rejected since they
+  // could potentially have conflicting assignments.
+  string name = 1;
+
+  // The version of this software recipe. Version can be up to 4 period
+  // separated numbers (e.g. 12.34.56.78).
+  string version = 2;
+
+  // Resources available to be used in the steps in the recipe.
+  repeated Artifact artifacts = 3;
+
+  // Actions to be taken for installing this recipe. On failure it stops
+  // executing steps and does not attempt another installation. Any steps taken
+  // (including partially completed steps) are not rolled back.  Install steps
+  // must be specified and are used on first installation.
+  repeated Step install_steps = 4;
+
+  // Actions to be taken for updating this recipe. On failure it stops
+  // executing steps and  does not attempt another update for this recipe. Any
+  // steps taken (including partially completed steps) are not rolled back.
+  // Upgrade steps are not mandatory and are only used when upgrading.
+  repeated Step update_steps = 5;
+
+  // Default is INSTALLED. The desired state the agent should maintain for this
+  // recipe.
+  //
+  // INSTALLED: The software recipe is installed on the instance but won't be
+  //                         updated to new versions.
+  // UPDATED: The software recipe is installed on the instance. The recipe is
+  //                         updated to a higher version, if a higher version of
+  //                         the recipe is assigned to this instance.
+  // REMOVE: Remove is unsupported for software recipes and attempts to
+  //         create or update a recipe to the REMOVE state is rejected.
+  DesiredState desired_state = 6;
+}
+
+// A request message for getting effective policy assigned to the instance.
+message LookupEffectiveGuestPolicyRequest {
+  // Required. This is the GCE instance identity token described in
+  // https://cloud.google.com/compute/docs/instances/verifying-instance-identity
+  // where the audience is 'osconfig.googleapis.com' and the format is 'full'.
+  string instance_id_token = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Short name of the OS running on the instance. The OS Config agent only
+  // provideS this field for targeting if OS Inventory is enabled for that
+  // instance.
+  string os_short_name = 2;
+
+  // Version of the OS running on the instance. The OS Config agent only
+  // provide this field for targeting if OS Inventory is enabled for that
+  // VM instance.
+  string os_version = 3;
+
+  // Architecture of OS running on the instance. The OS Config agent only
+  // provide this field for targeting if OS Inventory is enabled for that
+  // instance.
+  string os_architecture = 4;
+}
+
+// The effective guest policy assigned to the instance.
+message EffectiveGuestPolicy {
+  // A guest policy package including its source.
+  message SourcedPackage {
+    // Name of the guest policy providing this config.
+    string source = 1;
+
+    // A software package to configure on the VM instance.
+    Package package = 2;
+  }
+
+  // A guest policy package repository including its source.
+  message SourcedPackageRepository {
+    // Name of the guest policy providing this config.
+    string source = 1;
+
+    // A software package repository to configure on the VM instance.
+    PackageRepository package_repository = 2;
+  }
+
+  // A guest policy recipe including its source.
+  message SourcedSoftwareRecipe {
+    // Name of the guest policy providing this config.
+    string source = 1;
+
+    // A software recipe to configure on the VM instance.
+    SoftwareRecipe software_recipe = 2;
+  }
+
+  // List of package configurations assigned to the VM instance.
+  repeated SourcedPackage packages = 1;
+
+  // List of package repository configurations assigned to the VM instance.
+  repeated SourcedPackageRepository package_repositories = 2;
+
+  // List of recipes assigned to the VM instance.
+  repeated SourcedSoftwareRecipe software_recipes = 3;
+}
diff --git a/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/osconfig_gapic.legacy.yaml b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/osconfig_gapic.legacy.yaml
new file mode 100644
index 000000000..08c8ca3ba
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/osconfig_gapic.legacy.yaml
@@ -0,0 +1,148 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.osconfig.agentendpoint.v1beta
+  python:
+    package_name: google.cloud.osconfig.agentendpoint_v1beta.gapic
+  go:
+    package_name: cloud.google.com/go/osconfig/agentendpoint/apiv1beta
+  csharp:
+    package_name: Google.Cloud.OsConfig.Agentendpoint.V1beta
+  ruby:
+    package_name: Google::Cloud::OsConfig::Agentendpoint::V1beta
+  php:
+    package_name: Google\Cloud\OsConfig\Agentendpoint\V1beta
+  nodejs:
+    package_name: agentendpoint.v1beta
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: google.cloud.osconfig.agentendpoint.v1beta.AgentEndpointService
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections: []
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ReceiveTaskNotification
+    flattening:
+      groups:
+      - parameters:
+        - instance_id_token
+        - agent_version
+    required_fields:
+    - instance_id_token
+    - agent_version
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: StartNextTask
+    flattening:
+      groups:
+      - parameters:
+        - instance_id_token
+    required_fields:
+    - instance_id_token
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: ReportTaskProgress
+    flattening:
+      groups:
+      - parameters:
+        - instance_id_token
+        - task_id
+        - task_type
+    required_fields:
+    - instance_id_token
+    - task_id
+    - task_type
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: ReportTaskComplete
+    flattening:
+      groups:
+      - parameters:
+        - instance_id_token
+        - task_id
+        - task_type
+        - error_message
+    required_fields:
+    - instance_id_token
+    - task_id
+    - task_type
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/osconfig_gapic.yaml b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/osconfig_gapic.yaml
new file mode 100644
index 000000000..d7beb5840
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/osconfig_gapic.yaml
@@ -0,0 +1,42 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 2.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.osconfig.agentendpoint.v1beta
+  python:
+    package_name: google.cloud.osconfig.agentendpoint_v1beta.gapic
+  go:
+    package_name: cloud.google.com/go/osconfig/agentendpoint/apiv1beta
+  csharp:
+    package_name: Google.Cloud.OsConfig.Agentendpoint.V1beta
+  ruby:
+    package_name: Google::Cloud::OsConfig::Agentendpoint::V1beta
+  php:
+    package_name: Google\Cloud\OsConfig\Agentendpoint\V1beta
+  nodejs:
+    package_name: agentendpoint.v1beta
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: google.cloud.osconfig.agentendpoint.v1beta.AgentEndpointService
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  methods:
+  - name: ReceiveTaskNotification
+    retry_codes_name: idempotent
+  - name: StartNextTask
+    retry_codes_name: idempotent
+  - name: ReportTaskProgress
+    retry_codes_name: idempotent
+  - name: ReportTaskComplete
+    retry_codes_name: idempotent
+  - name: LookupEffectiveGuestPolicy
+    retry_codes_name: idempotent
+  - name: RegisterAgent
+    retry_codes_name: idempotent
diff --git a/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/osconfig_v1beta.yaml b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/osconfig_v1beta.yaml
new file mode 100644
index 000000000..18814a339
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/osconfig_v1beta.yaml
@@ -0,0 +1,19 @@
+type: google.api.Service
+config_version: 3
+name: osconfig.googleapis.com
+title: Cloud OS Config API
+
+apis:
+- name: google.cloud.osconfig.agentendpoint.v1beta.AgentEndpointService
+
+documentation:
+  summary: |-
+    OS management tools that can be used for patch management, patch
+    compliance, and configuration management on VM instances.
+
+backend:
+  rules:
+  - selector: 'google.cloud.osconfig.agentendpoint.v1beta.AgentEndpointService.*'
+    deadline: 30.0
+  - selector: google.cloud.osconfig.agentendpoint.v1beta.AgentEndpointService.ReceiveTaskNotification
+    deadline: 3600.0
diff --git a/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/patch_jobs.proto b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/patch_jobs.proto
new file mode 100644
index 000000000..73d67305a
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/patch_jobs.proto
@@ -0,0 +1,288 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.osconfig.agentendpoint.v1beta;
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/osconfig/agentendpoint/v1beta;agentendpoint";
+option java_outer_classname = "PatchJobs";
+option java_package = "com.google.cloud.osconfig.agentendpoint.v1beta";
+
+// Patch configuration specifications. Contains details on how to
+// apply patches to a VM instance.
+message PatchConfig {
+  // Post-patch reboot settings.
+  enum RebootConfig {
+    // The default behavior is DEFAULT.
+    REBOOT_CONFIG_UNSPECIFIED = 0;
+
+    // The agent decides if a reboot is necessary by checking
+    // signals such as registry keys on Windows or `/var/run/reboot-required` on
+    // APT based systems. On RPM based systems, a set of core system package
+    // install times are compared with system boot time.
+    DEFAULT = 1;
+
+    // Always reboot the machine after the update completes.
+    ALWAYS = 2;
+
+    // Never reboot the machine after the update completes.
+    NEVER = 3;
+  }
+
+  // Post-patch reboot settings.
+  RebootConfig reboot_config = 1;
+
+  // Retry strategy can be defined to have the agent retry patching
+  // during the window if patching fails. If omitted, the agent will use its
+  // default retry strategy.
+  RetryStrategy retry_strategy = 2;
+
+  // Apt update settings. Use this override the default apt patch rules.
+  AptSettings apt = 3;
+
+  // Yum update settings. Use this override the default yum patch rules.
+  YumSettings yum = 4;
+
+  // Goo update settings. Use this override the default goo patch rules.
+  GooSettings goo = 5;
+
+  // Zypper update settings. Use this override the default zypper patch rules.
+  ZypperSettings zypper = 6;
+
+  // Windows update settings. Use this override the default windows patch rules.
+  WindowsUpdateSettings windows_update = 7;
+
+  // The ExecStep to run before the patch update.
+  ExecStep pre_step = 8;
+
+  // The ExecStep to run after the patch update.
+  ExecStep post_step = 9;
+}
+
+// Apt patching will be performed by executing `apt-get update && apt-get
+// upgrade`. Additional options can be set to control how this is executed.
+message AptSettings {
+  // Apt patch type.
+  enum Type {
+    // By default, upgrade will be performed.
+    TYPE_UNSPECIFIED = 0;
+
+    // Runs `apt-get dist-upgrade`.
+    DIST = 1;
+
+    // Runs `apt-get upgrade`.
+    UPGRADE = 2;
+  }
+
+  // By changing the type to DIST, the patching will be performed
+  // using `apt-get dist-upgrade` instead.
+  Type type = 1;
+
+  // List of packages to exclude from update.
+  repeated string excludes = 2;
+
+  // An exclusive list of packages to be updated. These are the only packages
+  // that will be updated. If these packages are not installed, they will be
+  // ignored. This field cannot be specified with any other patch configuration
+  // fields.
+  repeated string exclusive_packages = 3;
+}
+
+// Yum patching will be performed by executing `yum update`. Additional options
+// can be set to control how this is executed.
+//
+// Note that not all settings are supported on all platforms.
+message YumSettings {
+  // Adds the `--security` flag to `yum update`. Not supported on
+  // all platforms.
+  bool security = 1;
+
+  // Will cause patch to run `yum update-minimal` instead.
+  bool minimal = 2;
+
+  // List of packages to exclude from update. These packages will be excluded by
+  // using the yum `--exclude` flag.
+  repeated string excludes = 3;
+
+  // An exclusive list of packages to be updated. These are the only packages
+  // that will be updated. If these packages are not installed, they will be
+  // ignored. This field must not be specified with any other patch
+  // configuration fields.
+  repeated string exclusive_packages = 4;
+}
+
+// Googet patching is performed by running `googet update`.
+message GooSettings {
+
+}
+
+// Zypper patching is performed by running `zypper patch`.
+// See also https://en.opensuse.org/SDB:Zypper_manual.
+message ZypperSettings {
+  // Adds the `--with-optional` flag to `zypper patch`.
+  bool with_optional = 1;
+
+  // Adds the `--with-update` flag, to `zypper patch`.
+  bool with_update = 2;
+
+  // Install only patches with these categories.
+  // Common categories include security, recommended, and feature.
+  repeated string categories = 3;
+
+  // Install only patches with these severities.
+  // Common severities include critical, important, moderate, and low.
+  repeated string severities = 4;
+
+  // List of patches to exclude from update.
+  repeated string excludes = 5;
+
+  // An exclusive list of patches to be updated. These are the only patches
+  // that will be installed using 'zypper patch patch:' command.
+  // This field must not be used with any other patch configuration fields.
+  repeated string exclusive_patches = 6;
+}
+
+// Windows patching is performed using the Windows Update Agent.
+message WindowsUpdateSettings {
+  // Microsoft Windows update classifications as defined in
+  // [1]
+  // https://support.microsoft.com/en-us/help/824684/description-of-the-standard-terminology-that-is-used-to-describe-micro
+  enum Classification {
+    // Invalid. If classifications are included, they must be specified.
+    CLASSIFICATION_UNSPECIFIED = 0;
+
+    // "A widely released fix for a specific problem that addresses a critical,
+    // non-security-related bug." [1]
+    CRITICAL = 1;
+
+    // "A widely released fix for a product-specific, security-related
+    // vulnerability. Security vulnerabilities are rated by their severity. The
+    // severity rating is indicated in the Microsoft security bulletin as
+    // critical, important, moderate, or low." [1]
+    SECURITY = 2;
+
+    // "A widely released and frequent software update that contains additions
+    // to a product’s definition database. Definition databases are often used
+    // to detect objects that have specific attributes, such as malicious code,
+    // phishing websites, or junk mail." [1]
+    DEFINITION = 3;
+
+    // "Software that controls the input and output of a device." [1]
+    DRIVER = 4;
+
+    // "New product functionality that is first distributed outside the context
+    // of a product release and that is typically included in the next full
+    // product release." [1]
+    FEATURE_PACK = 5;
+
+    // "A tested, cumulative set of all hotfixes, security updates, critical
+    // updates, and updates. Additionally, service packs may contain additional
+    // fixes for problems that are found internally since the release of the
+    // product. Service packs my also contain a limited number of
+    // customer-requested design changes or features." [1]
+    SERVICE_PACK = 6;
+
+    // "A utility or feature that helps complete a task or set of tasks." [1]
+    TOOL = 7;
+
+    // "A tested, cumulative set of hotfixes, security updates, critical
+    // updates, and updates that are packaged together for easy deployment. A
+    // rollup generally targets a specific area, such as security, or a
+    // component of a product, such as Internet Information Services (IIS)." [1]
+    UPDATE_ROLLUP = 8;
+
+    // "A widely released fix for a specific problem. An update addresses a
+    // noncritical, non-security-related bug." [1]
+    UPDATE = 9;
+  }
+
+  // Only apply updates of these windows update classifications. If empty, all
+  // updates will be applied.
+  repeated Classification classifications = 1;
+
+  // List of KBs to exclude from update.
+  repeated string excludes = 2;
+
+  // An exclusive list of kbs to be updated. These are the only patches
+  // that will be updated. This field must not be used with other
+  // patch configurations.
+  repeated string exclusive_patches = 3;
+}
+
+// The strategy for retrying failed patches during the patch window.
+message RetryStrategy {
+  // If true, the agent will continue to try and patch until the window has
+  // ended.
+  bool enabled = 1;
+}
+
+// A step that runs an executable for a PatchJob.
+message ExecStep {
+  // The ExecStepConfig for all Linux VMs targeted by the PatchJob.
+  ExecStepConfig linux_exec_step_config = 1;
+
+  // The ExecStepConfig for all Windows VMs targeted by the PatchJob.
+  ExecStepConfig windows_exec_step_config = 2;
+}
+
+// Common configurations for an ExecStep.
+message ExecStepConfig {
+  // The interpreter used to execute the a file.
+  enum Interpreter {
+    // Invalid for a Windows ExecStepConfig. For a Linux ExecStepConfig, the
+    // interpreter will be parsed from the shebang line of the script if
+    // unspecified.
+    INTERPRETER_UNSPECIFIED = 0;
+
+    // Indicates that the script will be run with /bin/sh on Linux and cmd
+    // on windows.
+    SHELL = 1;
+
+    // Indicates that the file will be run with PowerShell.
+    POWERSHELL = 2;
+  }
+
+  // Location of the executable.
+  oneof executable {
+    // An absolute path to the executable on the VM.
+    string local_path = 1;
+
+    // A GCS object containing the executable.
+    GcsObject gcs_object = 2;
+  }
+
+  // Defaults to [0]. A list of possible return values that the
+  // execution can return to indicate a success.
+  repeated int32 allowed_success_codes = 3;
+
+  // The script interpreter to use to run the script. If no interpreter is
+  // specified the script will be executed directly, which will likely
+  // only succeed for scripts with shebang lines.
+  // [Wikipedia shebang](https://en.wikipedia.org/wiki/Shebang_(Unix)).
+  Interpreter interpreter = 4;
+}
+
+// GCS object representation.
+message GcsObject {
+  // Bucket of the GCS object.
+  string bucket = 1;
+
+  // Name of the GCS object.
+  string object = 2;
+
+  // Generation number of the GCS object. This is used to ensure that the
+  // ExecStep specified by this PatchJob does not change.
+  int64 generation_number = 3;
+}
diff --git a/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/tasks.proto b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/tasks.proto
new file mode 100644
index 000000000..e5ad39f83
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/agentendpoint/v1beta/tasks.proto
@@ -0,0 +1,179 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.osconfig.agentendpoint.v1beta;
+
+import "google/api/field_behavior.proto";
+import "google/cloud/osconfig/agentendpoint/v1beta/patch_jobs.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/osconfig/agentendpoint/v1beta;agentendpoint";
+option java_outer_classname = "Tasks";
+option java_package = "com.google.cloud.osconfig.agentendpoint.v1beta";
+
+// Specifies the current agent behavior.
+enum TaskDirective {
+  // Unspecified is invalid.
+  TASK_DIRECTIVE_UNSPECIFIED = 0;
+
+  // The task should continue to progress.
+  CONTINUE = 1;
+
+  // Task should not be started, or if already in progress, should stop
+  // at first safe stopping point.  Task should be considered done and will
+  // never repeat.
+  STOP = 2;
+}
+
+// Specifies the type of task to perform.
+enum TaskType {
+  // Unspecified is invalid.
+  TASK_TYPE_UNSPECIFIED = 0;
+
+  // The apply patches task.
+  APPLY_PATCHES = 1;
+
+  // The exec step task.
+  EXEC_STEP_TASK = 2;
+}
+
+// A unit of work to be performed by the agent.
+message Task {
+  // Unique task id.
+  string task_id = 1;
+
+  // The type of task to perform.
+  //
+  // Task details must include the appropriate message based on this enum as
+  // specified below:
+  // APPLY_PATCHES = ApplyPatchesTask
+  // EXEC_STEP = ExecStepTask;
+  TaskType task_type = 2;
+
+  // Current directive to the agent.
+  TaskDirective task_directive = 3;
+
+  // Specific details about the current task to perform.
+  oneof task_details {
+    // Details about the apply patches task to perform.
+    ApplyPatchesTask apply_patches_task = 4;
+
+    // Details about the exec step task to perform.
+    ExecStepTask exec_step_task = 5;
+  }
+
+  // Labels describing the task.  Used for logging by the agent.
+  map service_labels = 6;
+}
+
+// Message which instructs agent to apply patches.
+message ApplyPatchesTask {
+  // Specific information about how patches should be applied.
+  PatchConfig patch_config = 1;
+
+  // If true, the agent will report its status as it goes through the motions
+  // but won't actually run any updates or perform any reboots.
+  bool dry_run = 3;
+}
+
+// Information reported from the agent about applying patches execution.
+message ApplyPatchesTaskProgress {
+  // The intermediate states of applying patches.
+  enum State {
+    // Unspecified is invalid.
+    STATE_UNSPECIFIED = 0;
+
+    // The agent has started the patch task.
+    STARTED = 4;
+
+    // The agent is currently downloading patches.
+    DOWNLOADING_PATCHES = 1;
+
+    // The agent is currently applying patches.
+    APPLYING_PATCHES = 2;
+
+    // The agent is currently rebooting the VM instance.
+    REBOOTING = 3;
+  }
+
+  // Required. The current state of this patch execution.
+  State state = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Information reported from the agent about applying patches execution.
+message ApplyPatchesTaskOutput {
+  // The final states of applying patches.
+  enum State {
+    // Unspecified is invalid.
+    STATE_UNSPECIFIED = 0;
+
+    // Applying patches completed successfully.
+    SUCCEEDED = 1;
+
+    // Applying patches completed successfully, but a reboot is required.
+    SUCCEEDED_REBOOT_REQUIRED = 2;
+
+    // Applying patches failed.
+    FAILED = 3;
+  }
+
+  // Required. The final state of this task.
+  State state = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Message which instructs agent to execute the following command.
+message ExecStepTask {
+  // Details of the exec step to run.
+  ExecStep exec_step = 1;
+}
+
+// Information reported from the agent about the exec step execution.
+message ExecStepTaskProgress {
+  // The intermediate states of exec steps.
+  enum State {
+    // Unspecified is invalid.
+    STATE_UNSPECIFIED = 0;
+
+    // The agent has started the exec step task.
+    STARTED = 1;
+  }
+
+  // Required. The current state of this exec step.
+  State state = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Information reported from the agent about the exec step execution.
+message ExecStepTaskOutput {
+  // The final states of exec steps.
+  enum State {
+    // Unspecified is invalid.
+    STATE_UNSPECIFIED = 0;
+
+    // The exec step completed normally.
+    COMPLETED = 1;
+
+    // The exec step was terminated because it took too long.
+    TIMED_OUT = 2;
+
+    // The exec step task was cancelled before it started.
+    CANCELLED = 3;
+  }
+
+  // Required. The final state of the exec step.
+  State state = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The exit code received from the script which ran as part of the exec step.
+  int32 exit_code = 2 [(google.api.field_behavior) = REQUIRED];
+}
diff --git a/third_party/googleapis/google/cloud/osconfig/v1/BUILD.bazel b/third_party/googleapis/google/cloud/osconfig/v1/BUILD.bazel
new file mode 100644
index 000000000..6dc29a2c0
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/v1/BUILD.bazel
@@ -0,0 +1,374 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "osconfig_proto",
+    srcs = [
+        "osconfig_service.proto",
+        "patch_deployments.proto",
+        "patch_jobs.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/type:datetime_proto",
+        "//google/type:dayofweek_proto",
+        "//google/type:timeofday_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "osconfig_proto_with_info",
+    deps = [
+        ":osconfig_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "osconfig_java_proto",
+    deps = [":osconfig_proto"],
+)
+
+java_grpc_library(
+    name = "osconfig_java_grpc",
+    srcs = [":osconfig_proto"],
+    deps = [":osconfig_java_proto"],
+)
+
+java_gapic_library(
+    name = "osconfig_java_gapic",
+    src = ":osconfig_proto_with_info",
+    gapic_yaml = "osconfig_gapic.yaml",
+    package = "google.cloud.osconfig.v1",
+    service_yaml = "osconfig_v1.yaml",
+    test_deps = [
+        ":osconfig_java_grpc",
+    ],
+    deps = [
+        ":osconfig_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "osconfig_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.osconfig.v1.OsConfigServiceClientTest",
+    ],
+    runtime_deps = [":osconfig_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-osconfig-v1-java",
+    deps = [
+        ":osconfig_java_gapic",
+        ":osconfig_java_grpc",
+        ":osconfig_java_proto",
+        ":osconfig_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "osconfig_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/osconfig/v1",
+    protos = [":osconfig_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/type:datetime_go_proto",
+        "//google/type:dayofweek_go_proto",
+        "//google/type:timeofday_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "osconfig_go_gapic",
+    srcs = [":osconfig_proto_with_info"],
+    grpc_service_config = "osconfig_grpc_service_config.json",
+    importpath = "cloud.google.com/go/osconfig/apiv1;osconfig",
+    service_yaml = "osconfig_v1.yaml",
+    deps = [
+        ":osconfig_go_proto",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
+    ],
+)
+
+go_test(
+    name = "osconfig_go_gapic_test",
+    srcs = [":osconfig_go_gapic_srcjar_test"],
+    embed = [":osconfig_go_gapic"],
+    importpath = "cloud.google.com/go/osconfig/apiv1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-osconfig-v1-go",
+    deps = [
+        ":osconfig_go_gapic",
+        ":osconfig_go_gapic_srcjar-test.srcjar",
+        ":osconfig_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "osconfig_moved_proto",
+    srcs = [":osconfig_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/type:datetime_proto",
+        "//google/type:dayofweek_proto",
+        "//google/type:timeofday_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "osconfig_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":osconfig_moved_proto"],
+)
+
+py_grpc_library(
+    name = "osconfig_py_grpc",
+    srcs = [":osconfig_moved_proto"],
+    deps = [":osconfig_py_proto"],
+)
+
+py_gapic_library(
+    name = "osconfig_py_gapic",
+    src = ":osconfig_proto_with_info",
+    gapic_yaml = "osconfig_gapic.yaml",
+    package = "google.cloud.osconfig.v1",
+    service_yaml = "osconfig_v1.yaml",
+    deps = [
+        ":osconfig_py_grpc",
+        ":osconfig_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "osconfig-v1-py",
+    deps = [
+        ":osconfig_py_gapic",
+        ":osconfig_py_grpc",
+        ":osconfig_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "osconfig_php_proto",
+    deps = [":osconfig_proto"],
+)
+
+php_grpc_library(
+    name = "osconfig_php_grpc",
+    srcs = [":osconfig_proto"],
+    deps = [":osconfig_php_proto"],
+)
+
+php_gapic_library(
+    name = "osconfig_php_gapic",
+    src = ":osconfig_proto_with_info",
+    gapic_yaml = "osconfig_gapic.yaml",
+    package = "google.cloud.osconfig.v1",
+    service_yaml = "osconfig_v1.yaml",
+    deps = [
+        ":osconfig_php_grpc",
+        ":osconfig_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-osconfig-v1-php",
+    deps = [
+        ":osconfig_php_gapic",
+        ":osconfig_php_grpc",
+        ":osconfig_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "osconfig_nodejs_gapic",
+    src = ":osconfig_proto_with_info",
+    gapic_yaml = "osconfig_gapic.yaml",
+    package = "google.cloud.osconfig.v1",
+    service_yaml = "osconfig_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "osconfig-v1-nodejs",
+    deps = [
+        ":osconfig_nodejs_gapic",
+        ":osconfig_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "osconfig_ruby_proto",
+    deps = [":osconfig_proto"],
+)
+
+ruby_grpc_library(
+    name = "osconfig_ruby_grpc",
+    srcs = [":osconfig_proto"],
+    deps = [":osconfig_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "osconfig_ruby_gapic",
+    src = ":osconfig_proto_with_info",
+    gapic_yaml = "osconfig_gapic.yaml",
+    package = "google.cloud.osconfig.v1",
+    service_yaml = "osconfig_v1.yaml",
+    deps = [
+        ":osconfig_ruby_grpc",
+        ":osconfig_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-osconfig-v1-ruby",
+    deps = [
+        ":osconfig_ruby_gapic",
+        ":osconfig_ruby_grpc",
+        ":osconfig_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "osconfig_csharp_proto",
+    deps = [":osconfig_proto"],
+)
+
+csharp_grpc_library(
+    name = "osconfig_csharp_grpc",
+    srcs = [":osconfig_proto"],
+    deps = [":osconfig_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "osconfig_csharp_gapic",
+    src = ":osconfig_proto_with_info",
+    gapic_yaml = "osconfig_gapic.yaml",
+    package = "google.cloud.osconfig.v1",
+    service_yaml = "osconfig_v1.yaml",
+    deps = [
+        ":osconfig_csharp_grpc",
+        ":osconfig_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-osconfig-v1-csharp",
+    deps = [
+        ":osconfig_csharp_gapic",
+        ":osconfig_csharp_grpc",
+        ":osconfig_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/osconfig/v1/osconfig_gapic.legacy.yaml b/third_party/googleapis/google/cloud/osconfig/v1/osconfig_gapic.legacy.yaml
new file mode 100644
index 000000000..099916fbe
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/v1/osconfig_gapic.legacy.yaml
@@ -0,0 +1,19 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.osconfig.v1
+  python:
+    package_name: google.cloud.osconfig_v1.gapic
+  go:
+    package_name: cloud.google.com/go/osconfig/apiv1
+  csharp:
+    package_name: Google.Cloud.OsConfig.V1
+  ruby:
+    package_name: Google::Cloud::OsConfig::V1
+  php:
+    package_name: Google\Cloud\OsConfig\V1
+  nodejs:
+    package_name: osconfig.v1
+    domain_layer_location: google-cloud
diff --git a/third_party/googleapis/google/cloud/osconfig/v1/osconfig_gapic.yaml b/third_party/googleapis/google/cloud/osconfig/v1/osconfig_gapic.yaml
new file mode 100644
index 000000000..dd81d6a9d
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/v1/osconfig_gapic.yaml
@@ -0,0 +1,19 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 2.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.osconfig.v1
+  python:
+    package_name: google.cloud.osconfig_v1.gapic
+  go:
+    package_name: cloud.google.com/go/osconfig/apiv1
+  csharp:
+    package_name: Google.Cloud.OsConfig.V1
+  ruby:
+    package_name: Google::Cloud::OsConfig::V1
+  php:
+    package_name: Google\Cloud\OsConfig\V1
+  nodejs:
+    package_name: osconfig.v1
+    domain_layer_location: google-cloud
diff --git a/third_party/googleapis/google/cloud/osconfig/v1/osconfig_grpc_service_config.json b/third_party/googleapis/google/cloud/osconfig/v1/osconfig_grpc_service_config.json
new file mode 100644
index 000000000..4e198ad14
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/v1/osconfig_grpc_service_config.json
@@ -0,0 +1,13 @@
+{
+  "methodConfig": [{
+    "name": [{ "service": "google.cloud.osconfig.v1.OsConfigService" }],
+    "timeout": "60s",
+    "retryPolicy": {
+      "maxAttempts": 5,
+      "initialBackoff": "1s",
+      "maxBackoff": "60s",
+      "backoffMultiplier": 1.3,
+      "retryableStatusCodes": ["UNAVAILABLE"]
+    }
+  }]
+}
diff --git a/third_party/googleapis/google/cloud/osconfig/v1/osconfig_service.proto b/third_party/googleapis/google/cloud/osconfig/v1/osconfig_service.proto
new file mode 100644
index 000000000..2a654eaa2
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/v1/osconfig_service.proto
@@ -0,0 +1,119 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.osconfig.v1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/resource.proto";
+import "google/cloud/osconfig/v1/patch_deployments.proto";
+import "google/cloud/osconfig/v1/patch_jobs.proto";
+import "google/protobuf/empty.proto";
+
+option csharp_namespace = "Google.Cloud.OsConfig.V1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/osconfig/v1;osconfig";
+option java_outer_classname = "OsConfigProto";
+option java_package = "com.google.cloud.osconfig.v1";
+option php_namespace = "Google\\Cloud\\OsConfig\\V1";
+option ruby_package = "Google::Cloud::OsConfig::V1";
+option (google.api.resource_definition) = {
+  type: "compute.googleapis.com/Instance"
+  pattern: "projects/{project}/zones/{zone}/instances/{instance}"
+};
+
+// OS Config API
+//
+// The OS Config service is a server-side component that you can use to
+// manage package installations and patch jobs for virtual machine instances.
+service OsConfigService {
+  option (google.api.default_host) = "osconfig.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // Patch VM instances by creating and running a patch job.
+  rpc ExecutePatchJob(ExecutePatchJobRequest) returns (PatchJob) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*}/patchJobs:execute"
+      body: "*"
+    };
+  }
+
+  // Get the patch job. This can be used to track the progress of an
+  // ongoing patch job or review the details of completed jobs.
+  rpc GetPatchJob(GetPatchJobRequest) returns (PatchJob) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/patchJobs/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Cancel a patch job. The patch job must be active. Canceled patch jobs
+  // cannot be restarted.
+  rpc CancelPatchJob(CancelPatchJobRequest) returns (PatchJob) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/patchJobs/*}:cancel"
+      body: "*"
+    };
+  }
+
+  // Get a list of patch jobs.
+  rpc ListPatchJobs(ListPatchJobsRequest) returns (ListPatchJobsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*}/patchJobs"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Get a list of instance details for a given patch job.
+  rpc ListPatchJobInstanceDetails(ListPatchJobInstanceDetailsRequest) returns (ListPatchJobInstanceDetailsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/patchJobs/*}/instanceDetails"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Create an OS Config patch deployment.
+  rpc CreatePatchDeployment(CreatePatchDeploymentRequest) returns (PatchDeployment) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*}/patchDeployments"
+      body: "patch_deployment"
+    };
+    option (google.api.method_signature) = "parent,patch_deployment,patch_deployment_id";
+  }
+
+  // Get an OS Config patch deployment.
+  rpc GetPatchDeployment(GetPatchDeploymentRequest) returns (PatchDeployment) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/patchDeployments/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Get a page of OS Config patch deployments.
+  rpc ListPatchDeployments(ListPatchDeploymentsRequest) returns (ListPatchDeploymentsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*}/patchDeployments"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Delete an OS Config patch deployment.
+  rpc DeletePatchDeployment(DeletePatchDeploymentRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/patchDeployments/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+}
diff --git a/third_party/googleapis/google/cloud/osconfig/v1/osconfig_v1.yaml b/third_party/googleapis/google/cloud/osconfig/v1/osconfig_v1.yaml
new file mode 100644
index 000000000..32fa1aeaa
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/v1/osconfig_v1.yaml
@@ -0,0 +1,24 @@
+type: google.api.Service
+config_version: 3
+name: osconfig.googleapis.com
+title: Cloud OS Config API
+
+apis:
+- name: google.cloud.osconfig.v1.OsConfigService
+
+documentation:
+  summary: |-
+    OS management tools that can be used for patch management, patch
+    compliance, and configuration management on VM instances.
+
+backend:
+  rules:
+  - selector: 'google.cloud.osconfig.v1.OsConfigService.*'
+    deadline: 30.0
+
+authentication:
+  rules:
+  - selector: 'google.cloud.osconfig.v1.OsConfigService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/osconfig/v1/patch_deployments.proto b/third_party/googleapis/google/cloud/osconfig/v1/patch_deployments.proto
new file mode 100644
index 000000000..7d6992222
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/v1/patch_deployments.proto
@@ -0,0 +1,251 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.osconfig.v1;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/osconfig/v1/patch_jobs.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+import "google/type/datetime.proto";
+import "google/type/dayofweek.proto";
+import "google/type/timeofday.proto";
+
+option csharp_namespace = "Google.Cloud.OsConfig.V1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/osconfig/v1;osconfig";
+option java_outer_classname = "PatchDeployments";
+option java_package = "com.google.cloud.osconfig.v1";
+option php_namespace = "Google\\Cloud\\OsConfig\\V1";
+option ruby_package = "Google::Cloud::OsConfig::V1";
+
+// Patch deployments are configurations that individual patch jobs use to
+// complete a patch. These configurations include instance filter, package
+// repository settings, and a schedule. For more information about creating and
+// managing patch deployments, see [Scheduling patch
+// jobs](https://cloud.google.com/compute/docs/os-patch-management/schedule-patch-jobs).
+message PatchDeployment {
+  option (google.api.resource) = {
+    type: "osconfig.googleapis.com/PatchDeployment"
+    pattern: "projects/{project}/patchDeployments/{patch_deployment}"
+  };
+
+  // Unique name for the patch deployment resource in a project. The patch
+  // deployment name is in the form:
+  // `projects/{project_id}/patchDeployments/{patch_deployment_id}`.
+  // This field is ignored when you create a new patch deployment.
+  string name = 1;
+
+  // Optional. Description of the patch deployment. Length of the description is limited
+  // to 1024 characters.
+  string description = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. VM instances to patch.
+  PatchInstanceFilter instance_filter = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Patch configuration that is applied.
+  PatchConfig patch_config = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Duration of the patch. After the duration ends, the patch times out.
+  google.protobuf.Duration duration = 5 [(google.api.field_behavior) = OPTIONAL];
+
+  // Schedule for the patch.
+  oneof schedule {
+    // Required. Schedule a one-time execution.
+    OneTimeSchedule one_time_schedule = 6 [(google.api.field_behavior) = REQUIRED];
+
+    // Required. Schedule recurring executions.
+    RecurringSchedule recurring_schedule = 7 [(google.api.field_behavior) = REQUIRED];
+  }
+
+  // Output only. Time the patch deployment was created. Timestamp is in
+  // [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+  google.protobuf.Timestamp create_time = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Time the patch deployment was last updated. Timestamp is in
+  // [RFC3339]("https://www.ietf.org/rfc/rfc3339.txt) text format.
+  google.protobuf.Timestamp update_time = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The last time a patch job was started by this deployment.
+  // Timestamp is in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text
+  // format.
+  google.protobuf.Timestamp last_execute_time = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// Sets the time for a one time patch deployment. Timestamp is in
+// [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+message OneTimeSchedule {
+  // Required. The desired patch job execution time.
+  google.protobuf.Timestamp execute_time = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Sets the time for recurring patch deployments.
+message RecurringSchedule {
+  // Specifies the frequency of the recurring patch deployments.
+  enum Frequency {
+    // Invalid. A frequency must be specified.
+    FREQUENCY_UNSPECIFIED = 0;
+
+    // Indicates that the frequency should be expressed in terms of
+    // weeks.
+    WEEKLY = 1;
+
+    // Indicates that the frequency should be expressed in terms of
+    // months.
+    MONTHLY = 2;
+  }
+
+  // Required. Defines the time zone that `time_of_day` is relative to.
+  // The rules for daylight saving time are determined by the chosen time zone.
+  google.type.TimeZone time_zone = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The time that the recurring schedule becomes effective.
+  // Defaults to `create_time` of the patch deployment.
+  google.protobuf.Timestamp start_time = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The end time at which a recurring patch deployment schedule is no longer
+  // active.
+  google.protobuf.Timestamp end_time = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. Time of the day to run a recurring deployment.
+  google.type.TimeOfDay time_of_day = 4 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The frequency unit of this recurring schedule.
+  Frequency frequency = 5 [(google.api.field_behavior) = REQUIRED];
+
+  // Configurations for this recurring schedule.
+  // Configurations must match frequency.
+  oneof schedule_config {
+    // Required. Schedule with weekly executions.
+    WeeklySchedule weekly = 6 [(google.api.field_behavior) = REQUIRED];
+
+    // Required. Schedule with monthly executions.
+    MonthlySchedule monthly = 7 [(google.api.field_behavior) = REQUIRED];
+  }
+
+  // Output only. The time the last patch job ran successfully.
+  google.protobuf.Timestamp last_execute_time = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The time the next patch job is scheduled to run.
+  google.protobuf.Timestamp next_execute_time = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// Represents a weekly schedule.
+message WeeklySchedule {
+  // Required. Day of the week.
+  google.type.DayOfWeek day_of_week = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Represents a monthly schedule. An example of a valid monthly schedule is
+// "on the third Tuesday of the month" or "on the 15th of the month".
+message MonthlySchedule {
+  // One day in a month.
+  oneof day_of_month {
+    // Required. Week day in a month.
+    WeekDayOfMonth week_day_of_month = 1 [(google.api.field_behavior) = REQUIRED];
+
+    // Required. One day of the month. 1-31 indicates the 1st to the 31st day. -1
+    // indicates the last day of the month.
+    // Months without the target day will be skipped. For example, a schedule to
+    // run "every month on the 31st" will not run in February, April, June, etc.
+    int32 month_day = 2 [(google.api.field_behavior) = REQUIRED];
+  }
+}
+
+// Represents one week day in a month. An example is "the 4th Sunday".
+message WeekDayOfMonth {
+  // Required. Week number in a month. 1-4 indicates the 1st to 4th week of the month. -1
+  // indicates the last week of the month.
+  int32 week_ordinal = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. A day of the week.
+  google.type.DayOfWeek day_of_week = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// A request message for creating a patch deployment.
+message CreatePatchDeploymentRequest {
+  // Required. The project to apply this patch deployment to in the form `projects/*`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
+
+  // Required. A name for the patch deployment in the project. When creating a name
+  // the following rules apply:
+  // * Must contain only lowercase letters, numbers, and hyphens.
+  // * Must start with a letter.
+  // * Must be between 1-63 characters.
+  // * Must end with a number or a letter.
+  // * Must be unique within the project.
+  string patch_deployment_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The patch deployment to create.
+  PatchDeployment patch_deployment = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// A request message for retrieving a patch deployment.
+message GetPatchDeploymentRequest {
+  // Required. The resource name of the patch deployment in the form
+  // `projects/*/patchDeployments/*`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "osconfig.googleapis.com/PatchDeployment"
+    }
+  ];
+}
+
+// A request message for listing patch deployments.
+message ListPatchDeploymentsRequest {
+  // Required. The resource name of the parent in the form `projects/*`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
+
+  // Optional. The maximum number of patch deployments to return. Default is 100.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A pagination token returned from a previous call to ListPatchDeployments
+  // that indicates where this listing should continue from.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// A response message for listing patch deployments.
+message ListPatchDeploymentsResponse {
+  // The list of patch deployments.
+  repeated PatchDeployment patch_deployments = 1;
+
+  // A pagination token that can be used to get the next page of patch
+  // deployments.
+  string next_page_token = 2;
+}
+
+// A request message for deleting a patch deployment.
+message DeletePatchDeploymentRequest {
+  // Required. The resource name of the patch deployment in the form
+  // `projects/*/patchDeployments/*`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "osconfig.googleapis.com/PatchDeployment"
+    }
+  ];
+}
diff --git a/third_party/googleapis/google/cloud/osconfig/v1/patch_jobs.proto b/third_party/googleapis/google/cloud/osconfig/v1/patch_jobs.proto
new file mode 100644
index 000000000..cd274d646
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/v1/patch_jobs.proto
@@ -0,0 +1,685 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.osconfig.v1;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.OsConfig.V1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/osconfig/v1;osconfig";
+option java_outer_classname = "PatchJobs";
+option java_package = "com.google.cloud.osconfig.v1";
+option php_namespace = "Google\\Cloud\\OsConfig\\V1";
+option ruby_package = "Google::Cloud::OsConfig::V1";
+
+// A request message to initiate patching across Compute Engine
+// instances.
+message ExecutePatchJobRequest {
+  // Required. The project in which to run this patch in the form `projects/*`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
+
+  // Description of the patch job. Length of the description is limited
+  // to 1024 characters.
+  string description = 2;
+
+  // Required. Instances to patch, either explicitly or filtered by some criteria such
+  // as zone or labels.
+  PatchInstanceFilter instance_filter = 7 [(google.api.field_behavior) = REQUIRED];
+
+  // Patch configuration being applied. If omitted, instances are
+  // patched using the default configurations.
+  PatchConfig patch_config = 4;
+
+  // Duration of the patch job. After the duration ends, the patch job
+  // times out.
+  google.protobuf.Duration duration = 5;
+
+  // If this patch is a dry-run only, instances are contacted but
+  // will do nothing.
+  bool dry_run = 6;
+
+  // Display name for this patch job. This does not have to be unique.
+  string display_name = 8;
+}
+
+// Request to get an active or completed patch job.
+message GetPatchJobRequest {
+  // Required. Name of the patch in the form `projects/*/patchJobs/*`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "osconfig.googleapis.com/PatchJob"
+    }
+  ];
+}
+
+// Request to list details for all instances that are part of a patch job.
+message ListPatchJobInstanceDetailsRequest {
+  // Required. The parent for the instances are in the form of `projects/*/patchJobs/*`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "osconfig.googleapis.com/PatchJob"
+    }
+  ];
+
+  // The maximum number of instance details records to return.  Default is 100.
+  int32 page_size = 2;
+
+  // A pagination token returned from a previous call
+  // that indicates where this listing should continue from.
+  string page_token = 3;
+
+  // A filter expression that filters results listed in the response. This
+  // field supports filtering results by instance zone, name, state, or
+  // `failure_reason`.
+  string filter = 4;
+}
+
+// A response message for listing the instances details for a patch job.
+message ListPatchJobInstanceDetailsResponse {
+  // A list of instance status.
+  repeated PatchJobInstanceDetails patch_job_instance_details = 1;
+
+  // A pagination token that can be used to get the next page of results.
+  string next_page_token = 2;
+}
+
+// Patch details for a VM instance. For more information about reviewing VM
+// instance details, see
+// [Listing all VM instance details for a specific patch
+// job](https://cloud.google.com/compute/docs/os-patch-management/manage-patch-jobs#list-instance-details).
+message PatchJobInstanceDetails {
+  // The instance name in the form `projects/*/zones/*/instances/*`
+  string name = 1 [(google.api.resource_reference) = {
+                     type: "compute.googleapis.com/Instance"
+                   }];
+
+  // The unique identifier for the instance. This identifier is
+  // defined by the server.
+  string instance_system_id = 2;
+
+  // Current state of instance patch.
+  Instance.PatchState state = 3;
+
+  // If the patch fails, this field provides the reason.
+  string failure_reason = 4;
+
+  // The number of times the agent that the agent attempts to apply the patch.
+  int64 attempt_count = 5;
+}
+
+// A request message for listing patch jobs.
+message ListPatchJobsRequest {
+  // Required. In the form of `projects/*`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
+
+  // The maximum number of instance status to return.
+  int32 page_size = 2;
+
+  // A pagination token returned from a previous call
+  // that indicates where this listing should continue from.
+  string page_token = 3;
+
+  // If provided, this field specifies the criteria that must be met by patch
+  // jobs to be included in the response.
+  // Currently, filtering is only available on the patch_deployment field.
+  string filter = 4;
+}
+
+// A response message for listing patch jobs.
+message ListPatchJobsResponse {
+  // The list of patch jobs.
+  repeated PatchJob patch_jobs = 1;
+
+  // A pagination token that can be used to get the next page of results.
+  string next_page_token = 2;
+}
+
+// A high level representation of a patch job that is either in progress
+// or has completed.
+//
+// Instances details are not included in the job. To paginate through instance
+// details, use ListPatchJobInstanceDetails.
+//
+// For more information about patch jobs, see
+// [Creating patch
+// jobs](https://cloud.google.com/compute/docs/os-patch-management/create-patch-job).
+message PatchJob {
+  option (google.api.resource) = {
+    type: "osconfig.googleapis.com/PatchJob"
+    pattern: "projects/{project}/patchJobs/{patch_job}"
+  };
+
+  // A summary of the current patch state across all instances that this patch
+  // job affects. Contains counts of instances in different states. These states
+  // map to `InstancePatchState`. List patch job instance details to see the
+  // specific states of each instance.
+  message InstanceDetailsSummary {
+    // Number of instances pending patch job.
+    int64 pending_instance_count = 1;
+
+    // Number of instances that are inactive.
+    int64 inactive_instance_count = 2;
+
+    // Number of instances notified about patch job.
+    int64 notified_instance_count = 3;
+
+    // Number of instances that have started.
+    int64 started_instance_count = 4;
+
+    // Number of instances that are downloading patches.
+    int64 downloading_patches_instance_count = 5;
+
+    // Number of instances that are applying patches.
+    int64 applying_patches_instance_count = 6;
+
+    // Number of instances rebooting.
+    int64 rebooting_instance_count = 7;
+
+    // Number of instances that have completed successfully.
+    int64 succeeded_instance_count = 8;
+
+    // Number of instances that require reboot.
+    int64 succeeded_reboot_required_instance_count = 9;
+
+    // Number of instances that failed.
+    int64 failed_instance_count = 10;
+
+    // Number of instances that have acked and will start shortly.
+    int64 acked_instance_count = 11;
+
+    // Number of instances that exceeded the time out while applying the patch.
+    int64 timed_out_instance_count = 12;
+
+    // Number of instances that are running the pre-patch step.
+    int64 pre_patch_step_instance_count = 13;
+
+    // Number of instances that are running the post-patch step.
+    int64 post_patch_step_instance_count = 14;
+
+    // Number of instances that do not appear to be running the agent. Check to
+    // ensure that the agent is installed, running, and able to communicate with
+    // the service.
+    int64 no_agent_detected_instance_count = 15;
+  }
+
+  // Enumeration of the various states a patch job passes through as it
+  // executes.
+  enum State {
+    // State must be specified.
+    STATE_UNSPECIFIED = 0;
+
+    // The patch job was successfully initiated.
+    STARTED = 1;
+
+    // The patch job is looking up instances to run the patch on.
+    INSTANCE_LOOKUP = 2;
+
+    // Instances are being patched.
+    PATCHING = 3;
+
+    // Patch job completed successfully.
+    SUCCEEDED = 4;
+
+    // Patch job completed but there were errors.
+    COMPLETED_WITH_ERRORS = 5;
+
+    // The patch job was canceled.
+    CANCELED = 6;
+
+    // The patch job timed out.
+    TIMED_OUT = 7;
+  }
+
+  // Unique identifier for this patch job in the form
+  // `projects/*/patchJobs/*`
+  string name = 1;
+
+  // Display name for this patch job. This is not a unique identifier.
+  string display_name = 14;
+
+  // Description of the patch job. Length of the description is limited
+  // to 1024 characters.
+  string description = 2;
+
+  // Time this patch job was created.
+  google.protobuf.Timestamp create_time = 3;
+
+  // Last time this patch job was updated.
+  google.protobuf.Timestamp update_time = 4;
+
+  // The current state of the PatchJob .
+  State state = 5;
+
+  // Instances to patch.
+  PatchInstanceFilter instance_filter = 13;
+
+  // Patch configuration being applied.
+  PatchConfig patch_config = 7;
+
+  // Duration of the patch job. After the duration ends, the
+  // patch job times out.
+  google.protobuf.Duration duration = 8;
+
+  // Summary of instance details.
+  InstanceDetailsSummary instance_details_summary = 9;
+
+  // If this patch job is a dry run, the agent reports that it has
+  // finished without running any updates on the VM instance.
+  bool dry_run = 10;
+
+  // If this patch job failed, this message provides information about the
+  // failure.
+  string error_message = 11;
+
+  // Reflects the overall progress of the patch job in the range of
+  // 0.0 being no progress to 100.0 being complete.
+  double percent_complete = 12;
+
+  // Output only. Name of the patch deployment that created this patch job.
+  string patch_deployment = 15 [
+    (google.api.field_behavior) = OUTPUT_ONLY,
+    (google.api.resource_reference) = {
+      type: "osconfig.googleapis.com/PatchDeployment"
+    }
+  ];
+}
+
+// Patch configuration specifications. Contains details on how to apply the
+// patch(es) to a VM instance.
+message PatchConfig {
+  // Post-patch reboot settings.
+  enum RebootConfig {
+    // The default behavior is DEFAULT.
+    REBOOT_CONFIG_UNSPECIFIED = 0;
+
+    // The agent decides if a reboot is necessary by checking signals such as
+    // registry keys on Windows or `/var/run/reboot-required` on APT based
+    // systems. On RPM based systems, a set of core system package install times
+    // are compared with system boot time.
+    DEFAULT = 1;
+
+    // Always reboot the machine after the update completes.
+    ALWAYS = 2;
+
+    // Never reboot the machine after the update completes.
+    NEVER = 3;
+  }
+
+  // Post-patch reboot settings.
+  RebootConfig reboot_config = 1;
+
+  // Apt update settings. Use this setting to override the default `apt` patch
+  // rules.
+  AptSettings apt = 3;
+
+  // Yum update settings. Use this setting to override the default `yum` patch
+  // rules.
+  YumSettings yum = 4;
+
+  // Goo update settings. Use this setting to override the default `goo` patch
+  // rules.
+  GooSettings goo = 5;
+
+  // Zypper update settings. Use this setting to override the default `zypper`
+  // patch rules.
+  ZypperSettings zypper = 6;
+
+  // Windows update settings. Use this override the default windows patch rules.
+  WindowsUpdateSettings windows_update = 7;
+
+  // The `ExecStep` to run before the patch update.
+  ExecStep pre_step = 8;
+
+  // The `ExecStep` to run after the patch update.
+  ExecStep post_step = 9;
+}
+
+// Namespace for instance state enums.
+message Instance {
+  // Patch state of an instance.
+  enum PatchState {
+    // Unspecified.
+    PATCH_STATE_UNSPECIFIED = 0;
+
+    // The instance is not yet notified.
+    PENDING = 1;
+
+    // Instance is inactive and cannot be patched.
+    INACTIVE = 2;
+
+    // The instance is notified that it should be patched.
+    NOTIFIED = 3;
+
+    // The instance has started the patching process.
+    STARTED = 4;
+
+    // The instance is downloading patches.
+    DOWNLOADING_PATCHES = 5;
+
+    // The instance is applying patches.
+    APPLYING_PATCHES = 6;
+
+    // The instance is rebooting.
+    REBOOTING = 7;
+
+    // The instance has completed applying patches.
+    SUCCEEDED = 8;
+
+    // The instance has completed applying patches but a reboot is required.
+    SUCCEEDED_REBOOT_REQUIRED = 9;
+
+    // The instance has failed to apply the patch.
+    FAILED = 10;
+
+    // The instance acked the notification and will start shortly.
+    ACKED = 11;
+
+    // The instance exceeded the time out while applying the patch.
+    TIMED_OUT = 12;
+
+    // The instance is running the pre-patch step.
+    RUNNING_PRE_PATCH_STEP = 13;
+
+    // The instance is running the post-patch step.
+    RUNNING_POST_PATCH_STEP = 14;
+
+    // The service could not detect the presence of the agent. Check to ensure
+    // that the agent is installed, running, and able to communicate with the
+    // service.
+    NO_AGENT_DETECTED = 15;
+  }
+
+
+}
+
+// Message for canceling a patch job.
+message CancelPatchJobRequest {
+  // Required. Name of the patch in the form `projects/*/patchJobs/*`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "osconfig.googleapis.com/PatchJob"
+    }
+  ];
+}
+
+// Apt patching is completed by executing `apt-get update && apt-get
+// upgrade`. Additional options can be set to control how this is executed.
+message AptSettings {
+  // Apt patch type.
+  enum Type {
+    // By default, upgrade will be performed.
+    TYPE_UNSPECIFIED = 0;
+
+    // Runs `apt-get dist-upgrade`.
+    DIST = 1;
+
+    // Runs `apt-get upgrade`.
+    UPGRADE = 2;
+  }
+
+  // By changing the type to DIST, the patching is performed
+  // using `apt-get dist-upgrade` instead.
+  Type type = 1;
+
+  // List of packages to exclude from update. These packages will be excluded
+  repeated string excludes = 2;
+
+  // An exclusive list of packages to be updated. These are the only packages
+  // that will be updated. If these packages are not installed, they will be
+  // ignored. This field cannot be specified with any other patch configuration
+  // fields.
+  repeated string exclusive_packages = 3;
+}
+
+// Yum patching is performed by executing `yum update`. Additional options
+// can be set to control how this is executed.
+//
+// Note that not all settings are supported on all platforms.
+message YumSettings {
+  // Adds the `--security` flag to `yum update`. Not supported on
+  // all platforms.
+  bool security = 1;
+
+  // Will cause patch to run `yum update-minimal` instead.
+  bool minimal = 2;
+
+  // List of packages to exclude from update. These packages are excluded by
+  // using the yum `--exclude` flag.
+  repeated string excludes = 3;
+
+  // An exclusive list of packages to be updated. These are the only packages
+  // that will be updated. If these packages are not installed, they will be
+  // ignored. This field must not be specified with any other patch
+  // configuration fields.
+  repeated string exclusive_packages = 4;
+}
+
+// Googet patching is performed by running `googet update`.
+message GooSettings {
+
+}
+
+// Zypper patching is performed by running `zypper patch`.
+// See also https://en.opensuse.org/SDB:Zypper_manual.
+message ZypperSettings {
+  // Adds the `--with-optional` flag to `zypper patch`.
+  bool with_optional = 1;
+
+  // Adds the `--with-update` flag, to `zypper patch`.
+  bool with_update = 2;
+
+  // Install only patches with these categories.
+  // Common categories include security, recommended, and feature.
+  repeated string categories = 3;
+
+  // Install only patches with these severities.
+  // Common severities include critical, important, moderate, and low.
+  repeated string severities = 4;
+
+  // List of patches to exclude from update.
+  repeated string excludes = 5;
+
+  // An exclusive list of patches to be updated. These are the only patches
+  // that will be installed using 'zypper patch patch:' command.
+  // This field must not be used with any other patch configuration fields.
+  repeated string exclusive_patches = 6;
+}
+
+// Windows patching is performed using the Windows Update Agent.
+message WindowsUpdateSettings {
+  // Microsoft Windows update classifications as defined in
+  // [1]
+  // https://support.microsoft.com/en-us/help/824684/description-of-the-standard-terminology-that-is-used-to-describe-micro
+  enum Classification {
+    // Invalid. If classifications are included, they must be specified.
+    CLASSIFICATION_UNSPECIFIED = 0;
+
+    // "A widely released fix for a specific problem that addresses a critical,
+    // non-security-related bug." [1]
+    CRITICAL = 1;
+
+    // "A widely released fix for a product-specific, security-related
+    // vulnerability. Security vulnerabilities are rated by their severity. The
+    // severity rating is indicated in the Microsoft security bulletin as
+    // critical, important, moderate, or low." [1]
+    SECURITY = 2;
+
+    // "A widely released and frequent software update that contains additions
+    // to a product's definition database. Definition databases are often used
+    // to detect objects that have specific attributes, such as malicious code,
+    // phishing websites, or junk mail." [1]
+    DEFINITION = 3;
+
+    // "Software that controls the input and output of a device." [1]
+    DRIVER = 4;
+
+    // "New product functionality that is first distributed outside the context
+    // of a product release and that is typically included in the next full
+    // product release." [1]
+    FEATURE_PACK = 5;
+
+    // "A tested, cumulative set of all hotfixes, security updates, critical
+    // updates, and updates. Additionally, service packs may contain additional
+    // fixes for problems that are found internally since the release of the
+    // product. Service packs my also contain a limited number of
+    // customer-requested design changes or features." [1]
+    SERVICE_PACK = 6;
+
+    // "A utility or feature that helps complete a task or set of tasks." [1]
+    TOOL = 7;
+
+    // "A tested, cumulative set of hotfixes, security updates, critical
+    // updates, and updates that are packaged together for easy deployment. A
+    // rollup generally targets a specific area, such as security, or a
+    // component of a product, such as Internet Information Services (IIS)." [1]
+    UPDATE_ROLLUP = 8;
+
+    // "A widely released fix for a specific problem. An update addresses a
+    // noncritical, non-security-related bug." [1]
+    UPDATE = 9;
+  }
+
+  // Only apply updates of these windows update classifications. If empty, all
+  // updates are applied.
+  repeated Classification classifications = 1;
+
+  // List of KBs to exclude from update.
+  repeated string excludes = 2;
+
+  // An exclusive list of kbs to be updated. These are the only patches
+  // that will be updated. This field must not be used with other
+  // patch configurations.
+  repeated string exclusive_patches = 3;
+}
+
+// A step that runs an executable for a PatchJob.
+message ExecStep {
+  // The ExecStepConfig for all Linux VMs targeted by the PatchJob.
+  ExecStepConfig linux_exec_step_config = 1;
+
+  // The ExecStepConfig for all Windows VMs targeted by the PatchJob.
+  ExecStepConfig windows_exec_step_config = 2;
+}
+
+// Common configurations for an ExecStep.
+message ExecStepConfig {
+  // The interpreter used to execute the a file.
+  enum Interpreter {
+    // Invalid for a Windows ExecStepConfig. For a Linux ExecStepConfig, the
+    // interpreter will be parsed from the shebang line of the script if
+    // unspecified.
+    INTERPRETER_UNSPECIFIED = 0;
+
+    // Indicates that the script is run with `/bin/sh` on Linux and `cmd`
+    // on Windows.
+    SHELL = 1;
+
+    // Indicates that the file is run with PowerShell flags
+    // `-NonInteractive`, `-NoProfile`, and `-ExecutionPolicy Bypass`.
+    POWERSHELL = 2;
+  }
+
+  // Location of the executable.
+  oneof executable {
+    // An absolute path to the executable on the VM.
+    string local_path = 1;
+
+    // A Cloud Storage object containing the executable.
+    GcsObject gcs_object = 2;
+  }
+
+  // Defaults to [0]. A list of possible return values that the
+  // execution can return to indicate a success.
+  repeated int32 allowed_success_codes = 3;
+
+  // The script interpreter to use to run the script. If no interpreter is
+  // specified the script will be executed directly, which will likely
+  // only succeed for scripts with [shebang lines]
+  // (https://en.wikipedia.org/wiki/Shebang_\(Unix\)).
+  Interpreter interpreter = 4;
+}
+
+// Cloud Storage object representation.
+message GcsObject {
+  // Required. Bucket of the Cloud Storage object.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Name of the Cloud Storage object.
+  string object = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Generation number of the Cloud Storage object. This is used to
+  // ensure that the ExecStep specified by this PatchJob does not change.
+  int64 generation_number = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// A filter to target VM instances for patching. The targeted
+// VMs must meet all criteria specified. So if both labels and zones are
+// specified, the patch job targets only VMs with those labels and in those
+// zones.
+message PatchInstanceFilter {
+  // Targets a group of VM instances by using their [assigned
+  // labels](https://cloud.google.com/compute/docs/labeling-resources). Labels
+  // are key-value pairs. A `GroupLabel` is a combination of labels
+  // that is used to target VMs for a patch job.
+  //
+  // For example, a patch job can target VMs that have the following
+  // `GroupLabel`: `{"env":"test", "app":"web"}`. This means that the patch job
+  // is applied to VMs that have both the labels `env=test` and `app=web`.
+  message GroupLabel {
+    // Compute Engine instance labels that must be present for a VM
+    // instance to be targeted by this filter.
+    map labels = 1;
+  }
+
+  // Target all VM instances in the project. If true, no other criteria is
+  // permitted.
+  bool all = 1;
+
+  // Targets VM instances matching ANY of these GroupLabels. This allows
+  // targeting of disparate groups of VM instances.
+  repeated GroupLabel group_labels = 2;
+
+  // Targets VM instances in ANY of these zones. Leave empty to target VM
+  // instances in any zone.
+  repeated string zones = 3;
+
+  // Targets any of the VM instances specified. Instances are specified by their
+  // URI in the form `zones/[ZONE]/instances/[INSTANCE_NAME],
+  // `projects/[PROJECT_ID]/zones/[ZONE]/instances/[INSTANCE_NAME]`, or
+  // `https://www.googleapis.com/compute/v1/projects/[PROJECT_ID]/zones/[ZONE]/instances/[INSTANCE_NAME]`
+  repeated string instances = 4;
+
+  // Targets VMs whose name starts with one of these prefixes. Similar to
+  // labels, this is another way to group VMs when targeting configs, for
+  // example prefix="prod-".
+  repeated string instance_name_prefixes = 5;
+}
diff --git a/third_party/googleapis/google/cloud/osconfig/v1beta/BUILD.bazel b/third_party/googleapis/google/cloud/osconfig/v1beta/BUILD.bazel
new file mode 100644
index 000000000..5fed2fba8
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/v1beta/BUILD.bazel
@@ -0,0 +1,377 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "osconfig_proto",
+    srcs = [
+        "guest_policies.proto",
+        "osconfig_service.proto",
+        "patch_deployments.proto",
+        "patch_jobs.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/type:datetime_proto",
+        "//google/type:dayofweek_proto",
+        "//google/type:timeofday_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "osconfig_proto_with_info",
+    deps = [
+        ":osconfig_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "osconfig_java_proto",
+    deps = [":osconfig_proto"],
+)
+
+java_grpc_library(
+    name = "osconfig_java_grpc",
+    srcs = [":osconfig_proto"],
+    deps = [":osconfig_java_proto"],
+)
+
+java_gapic_library(
+    name = "osconfig_java_gapic",
+    src = ":osconfig_proto_with_info",
+    gapic_yaml = "osconfig_gapic.yaml",
+    package = "google.cloud.osconfig.v1beta",
+    service_yaml = "osconfig_v1beta.yaml",
+    test_deps = [
+        ":osconfig_java_grpc",
+    ],
+    deps = [
+        ":osconfig_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "osconfig_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.osconfig.v1beta.OsConfigServiceClientTest",
+    ],
+    runtime_deps = [":osconfig_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-osconfig-v1beta-java",
+    deps = [
+        ":osconfig_java_gapic",
+        ":osconfig_java_grpc",
+        ":osconfig_java_proto",
+        ":osconfig_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "osconfig_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/osconfig/v1beta",
+    protos = [":osconfig_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/type:datetime_go_proto",
+        "//google/type:dayofweek_go_proto",
+        "//google/type:timeofday_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "osconfig_go_gapic",
+    srcs = [":osconfig_proto_with_info"],
+    grpc_service_config = "osconfig_grpc_service_config.json",
+    importpath = "cloud.google.com/go/osconfig/apiv1beta;osconfig",
+    service_yaml = "osconfig_v1beta.yaml",
+    deps = [
+        ":osconfig_go_proto",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
+    ],
+)
+
+go_test(
+    name = "osconfig_go_gapic_test",
+    srcs = [":osconfig_go_gapic_srcjar_test"],
+    embed = [":osconfig_go_gapic"],
+    importpath = "cloud.google.com/go/osconfig/apiv1beta",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-osconfig-v1beta-go",
+    deps = [
+        ":osconfig_go_gapic",
+        ":osconfig_go_gapic_srcjar-test.srcjar",
+        ":osconfig_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "osconfig_moved_proto",
+    srcs = [":osconfig_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/type:datetime_proto",
+        "//google/type:dayofweek_proto",
+        "//google/type:timeofday_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "osconfig_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":osconfig_moved_proto"],
+)
+
+py_grpc_library(
+    name = "osconfig_py_grpc",
+    srcs = [":osconfig_moved_proto"],
+    deps = [":osconfig_py_proto"],
+)
+
+py_gapic_library(
+    name = "osconfig_py_gapic",
+    src = ":osconfig_proto_with_info",
+    gapic_yaml = "osconfig_gapic.yaml",
+    package = "google.cloud.osconfig.v1beta",
+    service_yaml = "osconfig_v1beta.yaml",
+    deps = [
+        ":osconfig_py_grpc",
+        ":osconfig_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "osconfig-v1beta-py",
+    deps = [
+        ":osconfig_py_gapic",
+        ":osconfig_py_grpc",
+        ":osconfig_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "osconfig_php_proto",
+    deps = [":osconfig_proto"],
+)
+
+php_grpc_library(
+    name = "osconfig_php_grpc",
+    srcs = [":osconfig_proto"],
+    deps = [":osconfig_php_proto"],
+)
+
+php_gapic_library(
+    name = "osconfig_php_gapic",
+    src = ":osconfig_proto_with_info",
+    gapic_yaml = "osconfig_gapic.yaml",
+    package = "google.cloud.osconfig.v1beta",
+    service_yaml = "osconfig_v1beta.yaml",
+    deps = [
+        ":osconfig_php_grpc",
+        ":osconfig_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-osconfig-v1beta-php",
+    deps = [
+        ":osconfig_php_gapic",
+        ":osconfig_php_grpc",
+        ":osconfig_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "osconfig_nodejs_gapic",
+    src = ":osconfig_proto_with_info",
+    gapic_yaml = "osconfig_gapic.yaml",
+    package = "google.cloud.osconfig.v1beta",
+    service_yaml = "osconfig_v1beta.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "osconfig-v1beta-nodejs",
+    deps = [
+        ":osconfig_nodejs_gapic",
+        ":osconfig_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "osconfig_ruby_proto",
+    deps = [":osconfig_proto"],
+)
+
+ruby_grpc_library(
+    name = "osconfig_ruby_grpc",
+    srcs = [":osconfig_proto"],
+    deps = [":osconfig_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "osconfig_ruby_gapic",
+    src = ":osconfig_proto_with_info",
+    gapic_yaml = "osconfig_gapic.yaml",
+    package = "google.cloud.osconfig.v1beta",
+    service_yaml = "osconfig_v1beta.yaml",
+    deps = [
+        ":osconfig_ruby_grpc",
+        ":osconfig_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-osconfig-v1beta-ruby",
+    deps = [
+        ":osconfig_ruby_gapic",
+        ":osconfig_ruby_grpc",
+        ":osconfig_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "osconfig_csharp_proto",
+    deps = [":osconfig_proto"],
+)
+
+csharp_grpc_library(
+    name = "osconfig_csharp_grpc",
+    srcs = [":osconfig_proto"],
+    deps = [":osconfig_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "osconfig_csharp_gapic",
+    src = ":osconfig_proto_with_info",
+    gapic_yaml = "osconfig_gapic.yaml",
+    package = "google.cloud.osconfig.v1beta",
+    service_yaml = "osconfig_v1beta.yaml",
+    deps = [
+        ":osconfig_csharp_grpc",
+        ":osconfig_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-osconfig-v1beta-csharp",
+    deps = [
+        ":osconfig_csharp_gapic",
+        ":osconfig_csharp_grpc",
+        ":osconfig_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/osconfig/v1beta/artman_osconfig_v1beta.yaml b/third_party/googleapis/google/cloud/osconfig/v1beta/artman_osconfig_v1beta.yaml
new file mode 100644
index 000000000..54e44bbaf
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/v1beta/artman_osconfig_v1beta.yaml
@@ -0,0 +1,34 @@
+common:
+  api_name: osconfig
+  api_version: v1beta
+  organization_name: google-cloud
+  proto_deps:
+  - name: google-common-protos
+  src_proto_paths:
+  - .
+  service_yaml: osconfig_v1beta.yaml
+  gapic_yaml: osconfig_gapic.yaml
+artifacts:
+- name: gapic_config
+  type: GAPIC_CONFIG
+- name: java_gapic
+  type: GAPIC
+  language: JAVA
+- name: python_gapic
+  type: GAPIC
+  language: PYTHON
+- name: nodejs_gapic
+  type: GAPIC
+  language: NODEJS
+- name: php_gapic
+  type: GAPIC
+  language: PHP
+- name: go_gapic
+  type: GAPIC
+  language: GO
+- name: ruby_gapic
+  type: GAPIC
+  language: RUBY
+- name: csharp_gapic
+  type: GAPIC
+  language: CSHARP
diff --git a/third_party/googleapis/google/cloud/osconfig/v1beta/guest_policies.proto b/third_party/googleapis/google/cloud/osconfig/v1beta/guest_policies.proto
new file mode 100644
index 000000000..f7fd0747d
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/v1beta/guest_policies.proto
@@ -0,0 +1,773 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.osconfig.v1beta;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/osconfig/v1beta;osconfig";
+option java_outer_classname = "GuestPolicies";
+option java_package = "com.google.cloud.osconfig.v1beta";
+
+// An OS Config resource representing a guest configuration policy. These
+// policies represent the desired state for VM instance guest environments
+// including packages to install or remove, package repository configurations,
+// and software to install.
+message GuestPolicy {
+  option (google.api.resource) = {
+    type: "osconfig.googleapis.com/GuestPolicy"
+    pattern: "projects/{project}/guestPolicies/{guest_policy}"
+  };
+
+  // Required. Unique name of the resource in this project using one of the following
+  // forms:
+  // `projects/{project_number}/guestPolicies/{guest_policy_id}`.
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Description of the guest policy. Length of the description is limited
+  // to 1024 characters.
+  string description = 2;
+
+  // Output only. Time this guest policy was created.
+  google.protobuf.Timestamp create_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Last time this guest policy was updated.
+  google.protobuf.Timestamp update_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Required. Specifies the VM instances that are assigned to this policy. This allows
+  // you to target sets or groups of VM instances by different parameters such
+  // as labels, names, OS, or zones.
+  //
+  // If left empty, all VM instances underneath this policy are targeted.
+  //
+  // At the same level in the resource hierarchy (that is within a project), the
+  // service prevents the creation of multiple policies that conflict with
+  // each other. For more information, see how the service [handles assignment
+  // conflicts](/compute/docs/os-config-management/create-guest-policy#handle-conflicts).
+  Assignment assignment = 6 [(google.api.field_behavior) = REQUIRED];
+
+  // The software packages to be managed by this policy.
+  repeated Package packages = 7;
+
+  // A list of package repositories to configure on the VM instance. This is
+  // done before any other configs are applied so they can use these repos.
+  // Package repositories are only configured if the corresponding package
+  // manager(s) are available.
+  repeated PackageRepository package_repositories = 8;
+
+  // A list of Recipes to install on the VM instance.
+  repeated SoftwareRecipe recipes = 9;
+
+  // The etag for this guest policy.
+  // If this is provided on update, it must match the server's etag.
+  string etag = 10;
+}
+
+// An assignment represents the group or groups of VM instances that the policy
+// applies to.
+//
+// If an assignment is empty, it applies to all VM instances. Otherwise, the
+// targeted VM instances must meet all the criteria specified. So if both
+// labels and zones are specified, the policy applies to VM instances with those
+// labels and in those zones.
+message Assignment {
+  // Represents a group of VM intances that can be identified as having all
+  // these labels, for example "env=prod and app=web".
+  message GroupLabel {
+    // Google Compute Engine instance labels that must be present for an
+    // instance to be included in this assignment group.
+    map labels = 1;
+  }
+
+  // Defines the criteria for selecting VM Instances by OS type.
+  message OsType {
+    // Targets VM instances with OS Inventory enabled and having the following
+    // OS short name, for example "debian" or "windows".
+    string os_short_name = 1;
+
+    // Targets VM instances with OS Inventory enabled and having the following
+    // following OS version.
+    string os_version = 2;
+
+    // Targets VM instances with OS Inventory enabled and having the following
+    // OS architecture.
+    string os_architecture = 3;
+  }
+
+  // Targets instances matching at least one of these label sets. This allows
+  // an assignment to target disparate groups, for example "env=prod or
+  // env=staging".
+  repeated GroupLabel group_labels = 1;
+
+  // Targets instances in any of these zones. Leave empty to target instances
+  // in any zone.
+  //
+  // Zonal targeting is uncommon and is supported to facilitate the management
+  // of changes by zone.
+  repeated string zones = 2;
+
+  // Targets any of the instances specified. Instances are specified by their
+  // URI in the form `zones/[ZONE]/instances/[INSTANCE_NAME]`.
+  //
+  // Instance targeting is uncommon and is supported to facilitate the
+  // management of changes by the instance or to target specific VM instances
+  // for development and testing.
+  //
+  // Only supported for project-level policies and must reference instances
+  // within this project.
+  repeated string instances = 3;
+
+  // Targets VM instances whose name starts with one of these prefixes.
+  //
+  // Like labels, this is another way to group VM instances when targeting
+  // configs, for example prefix="prod-".
+  //
+  // Only supported for project-level policies.
+  repeated string instance_name_prefixes = 4;
+
+  // Targets VM instances matching at least one of the following OS types.
+  //
+  // VM instances must match all supplied criteria for a given OsType to be
+  // included.
+  repeated OsType os_types = 5;
+}
+
+// Package is a reference to the software package to be installed or removed.
+// The agent on the VM instance uses the system package manager to apply the
+// config.
+//
+//
+// These are the commands that the agent uses to install or remove
+// packages.
+//
+// Apt
+// install: `apt-get update && apt-get -y install package1 package2 package3`
+// remove: `apt-get -y remove package1 package2 package3`
+//
+// Yum
+// install: `yum -y install package1 package2 package3`
+// remove: `yum -y remove package1 package2 package3`
+//
+// Zypper
+// install: `zypper install package1 package2 package3`
+// remove: `zypper rm package1 package2`
+//
+// Googet
+// install: `googet -noconfirm install package1 package2 package3`
+// remove: `googet -noconfirm remove package1 package2 package3`
+message Package {
+  // Types of package managers that may be used to manage this package.
+  enum Manager {
+    // The default behavior is ANY.
+    MANAGER_UNSPECIFIED = 0;
+
+    // Apply this package config using the default system package manager.
+    ANY = 1;
+
+    // Apply this package config only if Apt is available on the system.
+    APT = 2;
+
+    // Apply this package config only if Yum is available on the system.
+    YUM = 3;
+
+    // Apply this package config only if Zypper is available on the system.
+    ZYPPER = 4;
+
+    // Apply this package config only if GooGet is available on the system.
+    GOO = 5;
+  }
+
+  // Required. The name of the package. A package is uniquely identified for conflict
+  // validation by checking the package name and the manager(s) that the
+  // package targets.
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // The desired_state the agent should maintain for this package. The
+  // default is to ensure the package is installed.
+  DesiredState desired_state = 2;
+
+  // Type of package manager that can be used to install this package.
+  // If a system does not have the package manager, the package is not
+  // installed or removed no error message is returned. By default,
+  // or if you specify `ANY`,
+  // the agent attempts to install and remove this package using the default
+  // package manager. This is useful when creating a policy that applies to
+  // different types of systems.
+  //
+  // The default behavior is ANY.
+  Manager manager = 3;
+}
+
+// Represents a single Apt package repository. This repository is added to
+// a repo file that is stored at
+// `/etc/apt/sources.list.d/google_osconfig.list`.
+message AptRepository {
+  // Type of archive.
+  enum ArchiveType {
+    // Unspecified.
+    ARCHIVE_TYPE_UNSPECIFIED = 0;
+
+    // DEB indicates that the archive contains binary files.
+    DEB = 1;
+
+    // DEB_SRC indicates that the archive contains source files.
+    DEB_SRC = 2;
+  }
+
+  // Type of archive files in this repository. The default behavior is DEB.
+  ArchiveType archive_type = 1;
+
+  // Required. URI for this repository.
+  string uri = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Distribution of this repository.
+  string distribution = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. List of components for this repository. Must contain at least one item.
+  repeated string components = 4 [(google.api.field_behavior) = REQUIRED];
+
+  // URI of the key file for this repository. The agent maintains
+  // a keyring at `/etc/apt/trusted.gpg.d/osconfig_agent_managed.gpg` containing
+  // all the keys in any applied guest policy.
+  string gpg_key = 5;
+}
+
+// Represents a single Yum package repository. This repository is added to a
+// repo file that is stored at `/etc/yum.repos.d/google_osconfig.repo`.
+message YumRepository {
+  // Required. A one word, unique name for this repository. This is
+  // the `repo id` in the Yum config file and also the `display_name` if
+  // `display_name` is omitted. This id is also used as the unique identifier
+  // when checking for guest policy conflicts.
+  string id = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // The display name of the repository.
+  string display_name = 2;
+
+  // Required. The location of the repository directory.
+  string base_url = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // URIs of GPG keys.
+  repeated string gpg_keys = 4;
+}
+
+// Represents a single Zypper package repository. This repository is added to a
+// repo file that is stored at `/etc/zypp/repos.d/google_osconfig.repo`.
+message ZypperRepository {
+  // Required. A one word, unique name for this repository. This is
+  // the `repo id` in the zypper config file and also the `display_name` if
+  // `display_name` is omitted. This id is also used as the unique identifier
+  // when checking for guest policy conflicts.
+  string id = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // The display name of the repository.
+  string display_name = 2;
+
+  // Required. The location of the repository directory.
+  string base_url = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // URIs of GPG keys.
+  repeated string gpg_keys = 4;
+}
+
+// Represents a Goo package repository. These is added to a repo file
+// that is stored at C:/ProgramData/GooGet/repos/google_osconfig.repo.
+message GooRepository {
+  // Required. The name of the repository.
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The url of the repository.
+  string url = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The desired state that the OS Config agent maintains on the VM instance.
+enum DesiredState {
+  // The default is to ensure the package is installed.
+  DESIRED_STATE_UNSPECIFIED = 0;
+
+  // The agent ensures that the package is installed.
+  INSTALLED = 1;
+
+  // The agent ensures that the package is installed and
+  // periodically checks for and install any updates.
+  UPDATED = 2;
+
+  // The agent ensures that the package is not installed and uninstall it
+  // if detected.
+  REMOVED = 3;
+}
+
+// A package repository.
+message PackageRepository {
+  // A specific type of repository.
+  oneof repository {
+    // An Apt Repository.
+    AptRepository apt = 1;
+
+    // A Yum Repository.
+    YumRepository yum = 2;
+
+    // A Zypper Repository.
+    ZypperRepository zypper = 3;
+
+    // A Goo Repository.
+    GooRepository goo = 4;
+  }
+}
+
+// A software recipe is a set of instructions for installing and configuring a
+// piece of software. It consists of a set of artifacts that are
+// downloaded, and a set of steps that install, configure, and/or update the
+// software.
+//
+// Recipes support installing and updating software from artifacts in the
+// following formats:
+// Zip archive, Tar archive, Windows MSI, Debian package, and RPM package.
+//
+// Additionally, recipes support executing a script (either defined in a file or
+// directly in this api) in bash, sh, cmd, and powershell.
+//
+// Updating a software recipe
+//
+// If a recipe is assigned to an instance and there is a recipe with the same
+// name but a lower version already installed and the assigned state
+// of the recipe is `INSTALLED_KEEP_UPDATED`, then the recipe is updated to
+// the new version.
+//
+// Script Working Directories
+//
+// Each script or execution step is run in its own temporary directory which
+// is deleted after completing the step.
+message SoftwareRecipe {
+  // Specifies a resource to be used in the recipe.
+  message Artifact {
+    // Specifies an artifact available via some URI.
+    message Remote {
+      // URI from which to fetch the object. It should contain both the protocol
+      // and path following the format {protocol}://{location}.
+      string uri = 1;
+
+      // Must be provided if `allow_insecure` is `false`.
+      // SHA256 checksum in hex format, to compare to the checksum of the
+      // artifact. If the checksum is not empty and it doesn't match the
+      // artifact then the recipe installation fails before running any of the
+      // steps.
+      string checksum = 2;
+    }
+
+    // Specifies an artifact available as a Google Cloud Storage object.
+    message Gcs {
+      // Bucket of the Google Cloud Storage object.
+      // Given an example URL:
+      // `https://storage.googleapis.com/my-bucket/foo/bar#1234567`
+      // this value would be `my-bucket`.
+      string bucket = 1;
+
+      // Name of the Google Cloud Storage object.
+      // As specified [here]
+      // (https://cloud.google.com/storage/docs/naming#objectnames)
+      // Given an example URL:
+      // `https://storage.googleapis.com/my-bucket/foo/bar#1234567`
+      // this value would be `foo/bar`.
+      string object = 2;
+
+      // Must be provided if allow_insecure is false.
+      // Generation number of the Google Cloud Storage object.
+      // `https://storage.googleapis.com/my-bucket/foo/bar#1234567`
+      // this value would be `1234567`.
+      int64 generation = 3;
+    }
+
+    // Required. Id of the artifact, which the installation and update steps of this
+    // recipe can reference. Artifacts in a recipe cannot have the same id.
+    string id = 1 [(google.api.field_behavior) = REQUIRED];
+
+    // A specific type of artifact.
+    oneof artifact {
+      // A generic remote artifact.
+      Remote remote = 2;
+
+      // A Google Cloud Storage artifact.
+      Gcs gcs = 3;
+    }
+
+    // Defaults to false. When false, recipes are subject to validations
+    // based on the artifact type:
+    //
+    // Remote: A checksum must be specified, and only protocols with
+    // transport-layer security are permitted.
+    // GCS:    An object generation number must be specified.
+    bool allow_insecure = 4;
+  }
+
+  // An action that can be taken as part of installing or updating a recipe.
+  message Step {
+    // Copies the artifact to the specified path on the instance.
+    message CopyFile {
+      // Required. The id of the relevant artifact in the recipe.
+      string artifact_id = 1 [(google.api.field_behavior) = REQUIRED];
+
+      // Required. The absolute path on the instance to put the file.
+      string destination = 2 [(google.api.field_behavior) = REQUIRED];
+
+      // Whether to allow this step to overwrite existing files. If this is
+      // false and the file already exists the file is not overwritten
+      // and the step is considered a success. Defaults to false.
+      bool overwrite = 3;
+
+      // Consists of three octal digits which represent, in
+      // order, the permissions of the owner, group, and other users for the
+      // file (similarly to the numeric mode used in the linux chmod utility).
+      // Each digit represents a three bit number with the 4 bit
+      // corresponding to the read permissions, the 2 bit corresponds to the
+      // write bit, and the one bit corresponds to the execute permission.
+      // Default behavior is 755.
+      //
+      // Below are some examples of permissions and their associated values:
+      // read, write, and execute: 7
+      // read and execute: 5
+      // read and write: 6
+      // read only: 4
+      string permissions = 4;
+    }
+
+    // Extracts an archive of the type specified in the specified directory.
+    message ExtractArchive {
+      // Specifying the type of archive.
+      enum ArchiveType {
+        // Indicates that the archive type isn't specified.
+        ARCHIVE_TYPE_UNSPECIFIED = 0;
+
+        // Indicates that the archive is a tar archive with no encryption.
+        TAR = 1;
+
+        // Indicates that the archive is a tar archive with gzip encryption.
+        TAR_GZIP = 2;
+
+        // Indicates that the archive is a tar archive with bzip encryption.
+        TAR_BZIP = 3;
+
+        // Indicates that the archive is a tar archive with lzma encryption.
+        TAR_LZMA = 4;
+
+        // Indicates that the archive is a tar archive with xz encryption.
+        TAR_XZ = 5;
+
+        // Indicates that the archive is a zip archive.
+        ZIP = 11;
+      }
+
+      // Required. The id of the relevant artifact in the recipe.
+      string artifact_id = 1 [(google.api.field_behavior) = REQUIRED];
+
+      // Directory to extract archive to.
+      // Defaults to `/` on Linux or `C:\` on Windows.
+      string destination = 2;
+
+      // Required. The type of the archive to extract.
+      ArchiveType type = 3 [(google.api.field_behavior) = REQUIRED];
+    }
+
+    // Installs an MSI file.
+    message InstallMsi {
+      // Required. The id of the relevant artifact in the recipe.
+      string artifact_id = 1 [(google.api.field_behavior) = REQUIRED];
+
+      // The flags to use when installing the MSI
+      // defaults to ["/i"] (i.e. the install flag).
+      repeated string flags = 2;
+
+      // Return codes that indicate that the software installed or updated
+      // successfully. Behaviour defaults to [0]
+      repeated int32 allowed_exit_codes = 3;
+    }
+
+    // Installs a deb via dpkg.
+    message InstallDpkg {
+      // Required. The id of the relevant artifact in the recipe.
+      string artifact_id = 1 [(google.api.field_behavior) = REQUIRED];
+    }
+
+    // Installs an rpm file via the rpm utility.
+    message InstallRpm {
+      // Required. The id of the relevant artifact in the recipe.
+      string artifact_id = 1 [(google.api.field_behavior) = REQUIRED];
+    }
+
+    // Executes an artifact or local file.
+    message ExecFile {
+      // Location of the file to execute.
+      oneof location_type {
+        // The id of the relevant artifact in the recipe.
+        string artifact_id = 1;
+
+        // The absolute path of the file on the local filesystem.
+        string local_path = 2;
+      }
+
+      // Arguments to be passed to the provided executable.
+      repeated string args = 3;
+
+      // Defaults to [0]. A list of possible return values that the program
+      // can return to indicate a success.
+      repeated int32 allowed_exit_codes = 4;
+    }
+
+    // Runs a script through an interpreter.
+    message RunScript {
+      // The interpreter used to execute a script.
+      enum Interpreter {
+        // Default value for ScriptType.
+        INTERPRETER_UNSPECIFIED = 0;
+
+        // Indicates that the script is run with `/bin/sh` on Linux and `cmd`
+        // on windows.
+        SHELL = 1;
+
+        // Indicates that the script is run with powershell.
+        POWERSHELL = 3;
+      }
+
+      // Required. The shell script to be executed.
+      string script = 1 [(google.api.field_behavior) = REQUIRED];
+
+      // Return codes that indicate that the software installed or updated
+      // successfully. Behaviour defaults to [0]
+      repeated int32 allowed_exit_codes = 2;
+
+      // The script interpreter to use to run the script. If no interpreter is
+      // specified the script is executed directly, which likely
+      // only succeed for scripts with
+      // [shebang lines](https://en.wikipedia.org/wiki/Shebang_\(Unix\)).
+      Interpreter interpreter = 3;
+    }
+
+    // A specific type of step.
+    oneof step {
+      // Copies a file onto the instance.
+      CopyFile file_copy = 1;
+
+      // Extracts an archive into the specified directory.
+      ExtractArchive archive_extraction = 2;
+
+      // Installs an MSI file.
+      InstallMsi msi_installation = 3;
+
+      // Installs a deb file via dpkg.
+      InstallDpkg dpkg_installation = 4;
+
+      // Installs an rpm file via the rpm utility.
+      InstallRpm rpm_installation = 5;
+
+      // Executes an artifact or local file.
+      ExecFile file_exec = 6;
+
+      // Runs commands in a shell.
+      RunScript script_run = 7;
+    }
+  }
+
+  // Required. Unique identifier for the recipe. Only one recipe with a given name is
+  // installed on an instance.
+  //
+  // Names are also used to identify resources which helps to determine whether
+  // guest policies have conflicts. This means that requests to create multiple
+  // recipes with the same name and version are rejected since they
+  // could potentially have conflicting assignments.
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // The version of this software recipe. Version can be up to 4 period
+  // separated numbers (e.g. 12.34.56.78).
+  string version = 2;
+
+  // Resources available to be used in the steps in the recipe.
+  repeated Artifact artifacts = 3;
+
+  // Actions to be taken for installing this recipe. On failure it stops
+  // executing steps and does not attempt another installation. Any steps taken
+  // (including partially completed steps) are not rolled back.
+  repeated Step install_steps = 4;
+
+  // Actions to be taken for updating this recipe. On failure it stops
+  // executing steps and  does not attempt another update for this recipe. Any
+  // steps taken (including partially completed steps) are not rolled back.
+  repeated Step update_steps = 5;
+
+  // Default is INSTALLED. The desired state the agent should maintain for this
+  // recipe.
+  //
+  // INSTALLED: The software recipe is installed on the instance but
+  //            won't be updated to new versions.
+  // INSTALLED_KEEP_UPDATED: The software recipe is installed on the
+  //                         instance. The recipe is updated to a higher
+  //                         version, if a higher version of the recipe is
+  //                         assigned to this instance.
+  // REMOVE: Remove is unsupported for software recipes and attempts to
+  //         create or update a recipe to the REMOVE state is rejected.
+  DesiredState desired_state = 6;
+}
+
+// A request message for creating a guest policy.
+message CreateGuestPolicyRequest {
+  // Required. The resource name of the parent using one of the following forms:
+  // `projects/{project_number}`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "osconfig.googleapis.com/GuestPolicy"
+    }
+  ];
+
+  // Required. The logical name of the guest policy in the project
+  // with the following restrictions:
+  //
+  // * Must contain only lowercase letters, numbers, and hyphens.
+  // * Must start with a letter.
+  // * Must be between 1-63 characters.
+  // * Must end with a number or a letter.
+  // * Must be unique within the project.
+  string guest_policy_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The GuestPolicy to create.
+  GuestPolicy guest_policy = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// A request message for retrieving a guest policy.
+message GetGuestPolicyRequest {
+  // Required. The resource name of the guest policy using one of the following forms:
+  // `projects/{project_number}/guestPolicies/{guest_policy_id}`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "osconfig.googleapis.com/GuestPolicy"
+    }
+  ];
+}
+
+// A request message for listing guest policies.
+message ListGuestPoliciesRequest {
+  // Required. The resource name of the parent using one of the following forms:
+  // `projects/{project_number}`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "osconfig.googleapis.com/GuestPolicy"
+    }
+  ];
+
+  // The maximum number of guest policies to return.
+  int32 page_size = 2;
+
+  // A pagination token returned from a previous call to `ListGuestPolicies`
+  // that indicates where this listing should continue from.
+  string page_token = 3;
+}
+
+// A response message for listing guest policies.
+message ListGuestPoliciesResponse {
+  // The list of GuestPolicies.
+  repeated GuestPolicy guest_policies = 1;
+
+  // A pagination token that can be used to get the next page
+  // of guest policies.
+  string next_page_token = 2;
+}
+
+// A request message for updating a guest policy.
+message UpdateGuestPolicyRequest {
+  // Required. The updated GuestPolicy.
+  GuestPolicy guest_policy = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Field mask that controls which fields of the guest policy should be
+  // updated.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// A request message for deleting a guest policy.
+message DeleteGuestPolicyRequest {
+  // Required. The resource name of the guest policy  using one of the following forms:
+  // `projects/{project_number}/guestPolicies/{guest_policy_id}`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "osconfig.googleapis.com/GuestPolicy"
+    }
+  ];
+}
+
+// A request message for getting the effective guest policy assigned to the
+// instance.
+message LookupEffectiveGuestPolicyRequest {
+  // Required. The VM instance whose policies are being looked up.
+  string instance = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Short name of the OS running on the instance. The OS Config agent only
+  // provides this field for targeting if OS Inventory is enabled for that
+  // instance.
+  string os_short_name = 2;
+
+  // Version of the OS running on the instance. The OS Config agent only
+  // provides this field for targeting if OS Inventory is enabled for that
+  // VM instance.
+  string os_version = 3;
+
+  // Architecture of OS running on the instance. The OS Config agent only
+  // provides this field for targeting if OS Inventory is enabled for that
+  // instance.
+  string os_architecture = 4;
+}
+
+// The effective guest policy that applies to a VM instance.
+message EffectiveGuestPolicy {
+  // A guest policy package including its source.
+  message SourcedPackage {
+    // Name of the guest policy providing this config.
+    string source = 1;
+
+    // A software package to configure on the VM instance.
+    Package package = 2;
+  }
+
+  // A guest policy package repository including its source.
+  message SourcedPackageRepository {
+    // Name of the guest policy providing this config.
+    string source = 1;
+
+    // A software package repository to configure on the VM instance.
+    PackageRepository package_repository = 2;
+  }
+
+  // A guest policy recipe including its source.
+  message SourcedSoftwareRecipe {
+    // Name of the guest policy providing this config.
+    string source = 1;
+
+    // A software recipe to configure on the VM instance.
+    SoftwareRecipe software_recipe = 2;
+  }
+
+  // List of package configurations assigned to the VM instance.
+  repeated SourcedPackage packages = 1;
+
+  // List of package repository configurations assigned to the VM instance.
+  repeated SourcedPackageRepository package_repositories = 2;
+
+  // List of recipes assigned to the VM instance.
+  repeated SourcedSoftwareRecipe software_recipes = 3;
+}
diff --git a/third_party/googleapis/google/cloud/osconfig/v1beta/osconfig_gapic.legacy.yaml b/third_party/googleapis/google/cloud/osconfig/v1beta/osconfig_gapic.legacy.yaml
new file mode 100644
index 000000000..2f000180f
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/v1beta/osconfig_gapic.legacy.yaml
@@ -0,0 +1,337 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.osconfig.v1beta
+  python:
+    package_name: google.cloud.osconfig_v1beta.gapic
+  go:
+    package_name: cloud.google.com/go/osconfig/apiv1beta
+  csharp:
+    package_name: Google.Cloud.OsConfig.V1beta
+  ruby:
+    package_name: Google::Cloud::OsConfig::V1beta
+  php:
+    package_name: Google\Cloud\OsConfig\V1beta
+  nodejs:
+    package_name: osconfig.v1beta
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: google.cloud.osconfig.v1beta.OsConfigService
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}
+    entity_name: project
+  - name_pattern: projects/{project}/guestPolicies/{guest_policy}
+    entity_name: guest_policy
+  - name_pattern: projects/{project}/patchDeployments/{patch_deployment}
+    entity_name: patch_deployment
+  - name_pattern: projects/{project}/patchJobs/{patch_job}
+    entity_name: patch_job
+  - name_pattern: projects/{project}/zones/{zone}/instances/{instance}
+    entity_name: instance
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ExecutePatchJob
+    required_fields:
+    - parent
+    - description
+    - instance_filter
+    - patch_config
+    - duration
+    - dry_run
+    - display_name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 60000
+  - name: GetPatchJob
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: patch_job
+    timeout_millis: 60000
+  - name: CancelPatchJob
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: patch_job
+    timeout_millis: 60000
+  - name: ListPatchJobs
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - filter
+    required_fields:
+    - parent
+    - filter
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: patch_jobs
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 60000
+  - name: ListPatchJobInstanceDetails
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - filter
+    required_fields:
+    - parent
+    - filter
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: patch_job_instance_details
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: patch_job
+    timeout_millis: 60000
+  - name: CreatePatchDeployment
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - patch_deployment_id
+        - patch_deployment
+    required_fields:
+    - parent
+    - patch_deployment_id
+    - patch_deployment
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 60000
+  - name: GetPatchDeployment
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: patch_deployment
+    timeout_millis: 60000
+  - name: ListPatchDeployments
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: patch_deployments
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 60000
+  - name: DeletePatchDeployment
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: patch_deployment
+    timeout_millis: 60000
+  - name: CreateGuestPolicy
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - guest_policy_id
+        - guest_policy
+    required_fields:
+    - parent
+    - guest_policy_id
+    - guest_policy
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 60000
+  - name: GetGuestPolicy
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: guest_policy
+    timeout_millis: 60000
+  - name: ListGuestPolicies
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: guest_policies
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 60000
+  - name: UpdateGuestPolicy
+    flattening:
+      groups:
+      - parameters:
+        - guest_policy
+        - update_mask
+    required_fields:
+    - guest_policy
+    - update_mask
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      guest_policy.name: guest_policy
+    timeout_millis: 60000
+  - name: DeleteGuestPolicy
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: guest_policy
+    timeout_millis: 60000
+  - name: LookupEffectiveGuestPolicy
+    flattening:
+      groups:
+      - parameters:
+        - instance
+        - os_short_name
+        - os_version
+        - os_architecture
+    required_fields:
+    - instance
+    - os_short_name
+    - os_version
+    - os_architecture
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      instance: instance
+    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/osconfig/v1beta/osconfig_gapic.yaml b/third_party/googleapis/google/cloud/osconfig/v1beta/osconfig_gapic.yaml
new file mode 100644
index 000000000..56e155e7a
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/v1beta/osconfig_gapic.yaml
@@ -0,0 +1,33 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 2.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.osconfig.v1beta
+  python:
+    package_name: google.cloud.osconfig_v1beta.gapic
+  go:
+    package_name: cloud.google.com/go/osconfig/apiv1beta
+  csharp:
+    package_name: Google.Cloud.OsConfig.V1beta
+  ruby:
+    package_name: Google::Cloud::OsConfig::V1beta
+  php:
+    package_name: Google\Cloud\OsConfig\V1beta
+  nodejs:
+    package_name: osconfig.v1beta
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: google.cloud.osconfig.v1beta.OsConfigService
+  # A list of method configurations.
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  methods:
+  - name: DeletePatchDeployment
+    retry_codes_name: idempotent
+  - name: DeleteGuestPolicy
+    retry_codes_name: idempotent
diff --git a/third_party/googleapis/google/cloud/osconfig/v1beta/osconfig_grpc_service_config.json b/third_party/googleapis/google/cloud/osconfig/v1beta/osconfig_grpc_service_config.json
new file mode 100644
index 000000000..72072c4c1
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/v1beta/osconfig_grpc_service_config.json
@@ -0,0 +1,13 @@
+{
+  "methodConfig": [{
+    "name": [{ "service": "google.cloud.osconfig.v1beta.OsConfigService" }],
+    "timeout": "60s",
+    "retryPolicy": {
+      "maxAttempts": 5,
+      "initialBackoff": "1s",
+      "maxBackoff": "60s",
+      "backoffMultiplier": 1.3,
+      "retryableStatusCodes": ["UNAVAILABLE"]
+    }
+  }]
+}
diff --git a/third_party/googleapis/google/cloud/osconfig/v1beta/osconfig_service.proto b/third_party/googleapis/google/cloud/osconfig/v1beta/osconfig_service.proto
new file mode 100644
index 000000000..2211d8350
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/v1beta/osconfig_service.proto
@@ -0,0 +1,157 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.osconfig.v1beta;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/cloud/osconfig/v1beta/guest_policies.proto";
+import "google/cloud/osconfig/v1beta/patch_deployments.proto";
+import "google/cloud/osconfig/v1beta/patch_jobs.proto";
+import "google/protobuf/empty.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/osconfig/v1beta;osconfig";
+option java_outer_classname = "OsConfigProto";
+option java_package = "com.google.cloud.osconfig.v1beta";
+
+// OS Config API
+//
+// The OS Config service is a server-side component that you can use to
+// manage package installations and patch jobs for virtual machine instances.
+service OsConfigService {
+  option (google.api.default_host) = "osconfig.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // Patch VM instances by creating and running a patch job.
+  rpc ExecutePatchJob(ExecutePatchJobRequest) returns (PatchJob) {
+    option (google.api.http) = {
+      post: "/v1beta/{parent=projects/*}/patchJobs:execute"
+      body: "*"
+    };
+  }
+
+  // Get the patch job. This can be used to track the progress of an
+  // ongoing patch job or review the details of completed jobs.
+  rpc GetPatchJob(GetPatchJobRequest) returns (PatchJob) {
+    option (google.api.http) = {
+      get: "/v1beta/{name=projects/*/patchJobs/*}"
+    };
+  }
+
+  // Cancel a patch job. The patch job must be active. Canceled patch jobs
+  // cannot be restarted.
+  rpc CancelPatchJob(CancelPatchJobRequest) returns (PatchJob) {
+    option (google.api.http) = {
+      post: "/v1beta/{name=projects/*/patchJobs/*}:cancel"
+      body: "*"
+    };
+  }
+
+  // Get a list of patch jobs.
+  rpc ListPatchJobs(ListPatchJobsRequest) returns (ListPatchJobsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta/{parent=projects/*}/patchJobs"
+    };
+  }
+
+  // Get a list of instance details for a given patch job.
+  rpc ListPatchJobInstanceDetails(ListPatchJobInstanceDetailsRequest) returns (ListPatchJobInstanceDetailsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta/{parent=projects/*/patchJobs/*}/instanceDetails"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Create an OS Config patch deployment.
+  rpc CreatePatchDeployment(CreatePatchDeploymentRequest) returns (PatchDeployment) {
+    option (google.api.http) = {
+      post: "/v1beta/{parent=projects/*}/patchDeployments"
+      body: "patch_deployment"
+    };
+  }
+
+  // Get an OS Config patch deployment.
+  rpc GetPatchDeployment(GetPatchDeploymentRequest) returns (PatchDeployment) {
+    option (google.api.http) = {
+      get: "/v1beta/{name=projects/*/patchDeployments/*}"
+    };
+  }
+
+  // Get a page of OS Config patch deployments.
+  rpc ListPatchDeployments(ListPatchDeploymentsRequest) returns (ListPatchDeploymentsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta/{parent=projects/*}/patchDeployments"
+    };
+  }
+
+  // Delete an OS Config patch deployment.
+  rpc DeletePatchDeployment(DeletePatchDeploymentRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta/{name=projects/*/patchDeployments/*}"
+    };
+  }
+
+  // Create an OS Config guest policy.
+  rpc CreateGuestPolicy(CreateGuestPolicyRequest) returns (GuestPolicy) {
+    option (google.api.http) = {
+      post: "/v1beta/{parent=projects/*}/guestPolicies"
+      body: "guest_policy"
+    };
+    option (google.api.method_signature) = "parent, guest_policy";
+  }
+
+  // Get an OS Config guest policy.
+  rpc GetGuestPolicy(GetGuestPolicyRequest) returns (GuestPolicy) {
+    option (google.api.http) = {
+      get: "/v1beta/{name=projects/*/guestPolicies/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Get a page of OS Config guest policies.
+  rpc ListGuestPolicies(ListGuestPoliciesRequest) returns (ListGuestPoliciesResponse) {
+    option (google.api.http) = {
+      get: "/v1beta/{parent=projects/*}/guestPolicies"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Update an OS Config guest policy.
+  rpc UpdateGuestPolicy(UpdateGuestPolicyRequest) returns (GuestPolicy) {
+    option (google.api.http) = {
+      patch: "/v1beta/{guest_policy.name=projects/*/guestPolicies/*}"
+      body: "guest_policy"
+    };
+    option (google.api.method_signature) = "guest_policy,update_mask";
+  }
+
+  // Delete an OS Config guest policy.
+  rpc DeleteGuestPolicy(DeleteGuestPolicyRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta/{name=projects/*/guestPolicies/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Lookup the effective guest policy that applies to a VM instance. This
+  // lookup merges all policies that are assigned to the instance ancestry.
+  rpc LookupEffectiveGuestPolicy(LookupEffectiveGuestPolicyRequest) returns (EffectiveGuestPolicy) {
+    option (google.api.http) = {
+      post: "/v1beta/{instance=projects/*/zones/*/instances/*}:lookupEffectiveGuestPolicy"
+      body: "*"
+    };
+  }
+}
diff --git a/third_party/googleapis/google/cloud/osconfig/v1beta/osconfig_v1beta.yaml b/third_party/googleapis/google/cloud/osconfig/v1beta/osconfig_v1beta.yaml
new file mode 100644
index 000000000..cfe6e7bb7
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/v1beta/osconfig_v1beta.yaml
@@ -0,0 +1,24 @@
+type: google.api.Service
+config_version: 3
+name: osconfig.googleapis.com
+title: Cloud OS Config API
+
+apis:
+- name: google.cloud.osconfig.v1beta.OsConfigService
+
+documentation:
+  summary: |-
+    OS management tools that can be used for patch management, patch
+    compliance, and configuration management on VM instances.
+
+backend:
+  rules:
+  - selector: 'google.cloud.osconfig.v1beta.OsConfigService.*'
+    deadline: 30.0
+
+authentication:
+  rules:
+  - selector: 'google.cloud.osconfig.v1beta.OsConfigService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/osconfig/v1beta/patch_deployments.proto b/third_party/googleapis/google/cloud/osconfig/v1beta/patch_deployments.proto
new file mode 100644
index 000000000..a98f4b3ff
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/v1beta/patch_deployments.proto
@@ -0,0 +1,227 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.osconfig.v1beta;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/osconfig/v1beta/patch_jobs.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+import "google/type/datetime.proto";
+import "google/type/dayofweek.proto";
+import "google/type/timeofday.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/osconfig/v1beta;osconfig";
+option java_outer_classname = "PatchDeployments";
+option java_package = "com.google.cloud.osconfig.v1beta";
+
+// Patch deployments are configurations that individual patch jobs use to
+// complete a patch. These configurations include instance filter, package
+// repository settings, and a schedule. For more information about creating and
+// managing patch deployments, see [Scheduling patch
+// jobs](/compute/docs/os-patch-management/schedule-patch-jobs).
+message PatchDeployment {
+  // Unique name for the patch deployment resource in a project. The patch
+  // deployment name is in the form:
+  // `projects/{project_id}/patchDeployments/{patch_deployment_id}`.
+  // This field is ignored when you create a new patch deployment.
+  string name = 1;
+
+  // Optional. Description of the patch deployment. Length of the description is limited
+  // to 1024 characters.
+  string description = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. VM instances to patch.
+  PatchInstanceFilter instance_filter = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Patch configuration that is applied.
+  PatchConfig patch_config = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Duration of the patch. After the duration ends, the patch times out.
+  google.protobuf.Duration duration = 5 [(google.api.field_behavior) = OPTIONAL];
+
+  // Schedule for the patch.
+  oneof schedule {
+    // Required. Schedule a one-time execution.
+    OneTimeSchedule one_time_schedule = 6 [(google.api.field_behavior) = REQUIRED];
+
+    // Required. Schedule recurring executions.
+    RecurringSchedule recurring_schedule = 7 [(google.api.field_behavior) = REQUIRED];
+  }
+
+  // Output only. Time the patch deployment was created. Timestamp is in
+  // RFC3339
+  // text format.
+  google.protobuf.Timestamp create_time = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Time the patch deployment was last updated. Timestamp is in
+  // RFC3339
+  // text format.
+  google.protobuf.Timestamp update_time = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The last time a patch job was started by this deployment.
+  // Timestamp is in
+  // RFC3339
+  // text format.
+  google.protobuf.Timestamp last_execute_time = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// Sets the time for a one time patch deployment. Timestamp is in
+// RFC3339
+// text format.
+message OneTimeSchedule {
+  // Required. The desired patch job execution time.
+  google.protobuf.Timestamp execute_time = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Sets the time for recurring patch deployments.
+message RecurringSchedule {
+  // Specifies the frequency of the recurring patch deployments.
+  enum Frequency {
+    // Invalid. A frequency must be specified.
+    FREQUENCY_UNSPECIFIED = 0;
+
+    // Indicates that the frequency should be expressed in terms of
+    // weeks.
+    WEEKLY = 1;
+
+    // Indicates that the frequency should be expressed in terms of
+    // months.
+    MONTHLY = 2;
+  }
+
+  // Required. Defines the time zone that `time_of_day` is relative to.
+  // The rules for daylight saving time are determined by the chosen time zone.
+  google.type.TimeZone time_zone = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The time that the recurring schedule becomes effective.
+  // Defaults to `create_time` of the patch deployment.
+  google.protobuf.Timestamp start_time = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The end time at which a recurring patch deployment schedule is no longer
+  // active.
+  google.protobuf.Timestamp end_time = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. Time of the day to run a recurring deployment.
+  google.type.TimeOfDay time_of_day = 4 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The frequency unit of this recurring schedule.
+  Frequency frequency = 5 [(google.api.field_behavior) = REQUIRED];
+
+  // Configurations for this recurring schedule.
+  // Configurations must match frequency.
+  oneof schedule_config {
+    // Required. Schedule with weekly executions.
+    WeeklySchedule weekly = 6 [(google.api.field_behavior) = REQUIRED];
+
+    // Required. Schedule with monthly executions.
+    MonthlySchedule monthly = 7 [(google.api.field_behavior) = REQUIRED];
+  }
+
+  // Output only. The time the last patch job ran successfully.
+  google.protobuf.Timestamp last_execute_time = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The time the next patch job is scheduled to run.
+  google.protobuf.Timestamp next_execute_time = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// Represents a weekly schedule.
+message WeeklySchedule {
+  // Required. Day of the week.
+  google.type.DayOfWeek day_of_week = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Represents a monthly schedule. An example of a valid monthly schedule is
+// "on the third Tuesday of the month" or "on the 15th of the month".
+message MonthlySchedule {
+  // One day in a month.
+  oneof day_of_month {
+    // Required. Week day in a month.
+    WeekDayOfMonth week_day_of_month = 1 [(google.api.field_behavior) = REQUIRED];
+
+    // Required. One day of the month. 1-31 indicates the 1st to the 31st day. -1
+    // indicates the last day of the month.
+    // Months without the target day will be skipped. For example, a schedule to
+    // run "every month on the 31st" will not run in February, April, June, etc.
+    int32 month_day = 2 [(google.api.field_behavior) = REQUIRED];
+  }
+}
+
+// Represents one week day in a month. An example is "the 4th Sunday".
+message WeekDayOfMonth {
+  // Required. Week number in a month. 1-4 indicates the 1st to 4th week of the month. -1
+  // indicates the last week of the month.
+  int32 week_ordinal = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. A day of the week.
+  google.type.DayOfWeek day_of_week = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// A request message for creating a patch deployment.
+message CreatePatchDeploymentRequest {
+  // Required. The project to apply this patch deployment to in the form `projects/*`.
+  string parent = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. A name for the patch deployment in the project. When creating a name
+  // the following rules apply:
+  // * Must contain only lowercase letters, numbers, and hyphens.
+  // * Must start with a letter.
+  // * Must be between 1-63 characters.
+  // * Must end with a number or a letter.
+  // * Must be unique within the project.
+  string patch_deployment_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The patch deployment to create.
+  PatchDeployment patch_deployment = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// A request message for retrieving a patch deployment.
+message GetPatchDeploymentRequest {
+  // Required. The resource name of the patch deployment in the form
+  // `projects/*/patchDeployments/*`.
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// A request message for listing patch deployments.
+message ListPatchDeploymentsRequest {
+  // Required. The resource name of the parent in the form `projects/*`.
+  string parent = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The maximum number of patch deployments to return. Default is 100.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A pagination token returned from a previous call to ListPatchDeployments
+  // that indicates where this listing should continue from.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// A response message for listing patch deployments.
+message ListPatchDeploymentsResponse {
+  // The list of patch deployments.
+  repeated PatchDeployment patch_deployments = 1;
+
+  // A pagination token that can be used to get the next page of patch
+  // deployments.
+  string next_page_token = 2;
+}
+
+// A request message for deleting a patch deployment.
+message DeletePatchDeploymentRequest {
+  // Required. The resource name of the patch deployment in the form
+  // `projects/*/patchDeployments/*`.
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
+}
diff --git a/third_party/googleapis/google/cloud/osconfig/v1beta/patch_jobs.proto b/third_party/googleapis/google/cloud/osconfig/v1beta/patch_jobs.proto
new file mode 100644
index 000000000..b7263b0f7
--- /dev/null
+++ b/third_party/googleapis/google/cloud/osconfig/v1beta/patch_jobs.proto
@@ -0,0 +1,638 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.osconfig.v1beta;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/osconfig/v1beta;osconfig";
+option java_outer_classname = "PatchJobs";
+option java_package = "com.google.cloud.osconfig.v1beta";
+
+// A request message to initiate patching across Google Compute Engine
+// instances.
+message ExecutePatchJobRequest {
+  // Required. The project in which to run this patch in the form `projects/*`
+  string parent = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Description of the patch job. Length of the description is limited
+  // to 1024 characters.
+  string description = 2;
+
+  // Required. Instances to patch, either explicitly or filtered by some criteria such
+  // as zone or labels.
+  PatchInstanceFilter instance_filter = 7 [(google.api.field_behavior) = REQUIRED];
+
+  // Patch configuration being applied. If omitted, instances are
+  // patched using the default configurations.
+  PatchConfig patch_config = 4;
+
+  // Duration of the patch job. After the duration ends, the patch job
+  // times out.
+  google.protobuf.Duration duration = 5;
+
+  // If this patch is a dry-run only, instances are contacted but
+  // will do nothing.
+  bool dry_run = 6;
+
+  // Display name for this patch job. This does not have to be unique.
+  string display_name = 8;
+}
+
+// Request to get an active or completed patch job.
+message GetPatchJobRequest {
+  // Required. Name of the patch in the form `projects/*/patchJobs/*`
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request to list details for all instances that are part of a patch job.
+message ListPatchJobInstanceDetailsRequest {
+  // Required. The parent for the instances are in the form of `projects/*/patchJobs/*`.
+  string parent = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // The maximum number of instance details records to return.  Default is 100.
+  int32 page_size = 2;
+
+  // A pagination token returned from a previous call
+  // that indicates where this listing should continue from.
+  string page_token = 3;
+
+  // A filter expression that filters results listed in the response. This
+  // field supports filtering results by instance zone, name, state, or
+  // `failure_reason`.
+  string filter = 4;
+}
+
+// A response message for listing the instances details for a patch job.
+message ListPatchJobInstanceDetailsResponse {
+  // A list of instance status.
+  repeated PatchJobInstanceDetails patch_job_instance_details = 1;
+
+  // A pagination token that can be used to get the next page of results.
+  string next_page_token = 2;
+}
+
+// Patch details for a VM instance. For more information about reviewing VM
+// instance details, see
+// [Listing all VM instance details for a specific patch
+// job](/compute/docs/os-patch-management/manage-patch-jobs#list-instance-details).
+message PatchJobInstanceDetails {
+  // The instance name in the form `projects/*/zones/*/instances/*`
+  string name = 1;
+
+  // The unique identifier for the instance. This identifier is
+  // defined by the server.
+  string instance_system_id = 2;
+
+  // Current state of instance patch.
+  Instance.PatchState state = 3;
+
+  // If the patch fails, this field provides the reason.
+  string failure_reason = 4;
+
+  // The number of times the agent that the agent attempts to apply the patch.
+  int64 attempt_count = 5;
+}
+
+// A request message for listing patch jobs.
+message ListPatchJobsRequest {
+  // Required. In the form of `projects/*`
+  string parent = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // The maximum number of instance status to return.
+  int32 page_size = 2;
+
+  // A pagination token returned from a previous call
+  // that indicates where this listing should continue from.
+  string page_token = 3;
+
+  // If provided, this field specifies the criteria that must be met by patch
+  // jobs to be included in the response.
+  // Currently, filtering is only available on the patch_deployment field.
+  string filter = 4;
+}
+
+// A response message for listing patch jobs.
+message ListPatchJobsResponse {
+  // The list of patch jobs.
+  repeated PatchJob patch_jobs = 1;
+
+  // A pagination token that can be used to get the next page of results.
+  string next_page_token = 2;
+}
+
+// A high level representation of a patch job that is either in progress
+// or has completed.
+//
+// Instances details are not included in the job. To paginate through instance
+// details, use ListPatchJobInstanceDetails.
+//
+// For more information about patch jobs, see
+// [Creating patch jobs](/compute/docs/os-patch-management/create-patch-job).
+message PatchJob {
+  // A summary of the current patch state across all instances that this patch
+  // job affects. Contains counts of instances in different states. These states
+  // map to `InstancePatchState`. List patch job instance details to see the
+  // specific states of each instance.
+  message InstanceDetailsSummary {
+    // Number of instances pending patch job.
+    int64 pending_instance_count = 1;
+
+    // Number of instances that are inactive.
+    int64 inactive_instance_count = 2;
+
+    // Number of instances notified about patch job.
+    int64 notified_instance_count = 3;
+
+    // Number of instances that have started.
+    int64 started_instance_count = 4;
+
+    // Number of instances that are downloading patches.
+    int64 downloading_patches_instance_count = 5;
+
+    // Number of instances that are applying patches.
+    int64 applying_patches_instance_count = 6;
+
+    // Number of instances rebooting.
+    int64 rebooting_instance_count = 7;
+
+    // Number of instances that have completed successfully.
+    int64 succeeded_instance_count = 8;
+
+    // Number of instances that require reboot.
+    int64 succeeded_reboot_required_instance_count = 9;
+
+    // Number of instances that failed.
+    int64 failed_instance_count = 10;
+
+    // Number of instances that have acked and will start shortly.
+    int64 acked_instance_count = 11;
+
+    // Number of instances that exceeded the time out while applying the patch.
+    int64 timed_out_instance_count = 12;
+
+    // Number of instances that are running the pre-patch step.
+    int64 pre_patch_step_instance_count = 13;
+
+    // Number of instances that are running the post-patch step.
+    int64 post_patch_step_instance_count = 14;
+
+    // Number of instances that do not appear to be running the agent. Check to
+    // ensure that the agent is installed, running, and able to communicate with
+    // the service.
+    int64 no_agent_detected_instance_count = 15;
+  }
+
+  // Enumeration of the various states a patch job passes through as it
+  // executes.
+  enum State {
+    // State must be specified.
+    STATE_UNSPECIFIED = 0;
+
+    // The patch job was successfully initiated.
+    STARTED = 1;
+
+    // The patch job is looking up instances to run the patch on.
+    INSTANCE_LOOKUP = 2;
+
+    // Instances are being patched.
+    PATCHING = 3;
+
+    // Patch job completed successfully.
+    SUCCEEDED = 4;
+
+    // Patch job completed but there were errors.
+    COMPLETED_WITH_ERRORS = 5;
+
+    // The patch job was canceled.
+    CANCELED = 6;
+
+    // The patch job timed out.
+    TIMED_OUT = 7;
+  }
+
+  // Unique identifier for this patch job in the form
+  // `projects/*/patchJobs/*`
+  string name = 1;
+
+  // Display name for this patch job. This is not a unique identifier.
+  string display_name = 14;
+
+  // Description of the patch job. Length of the description is limited
+  // to 1024 characters.
+  string description = 2;
+
+  // Time this patch job was created.
+  google.protobuf.Timestamp create_time = 3;
+
+  // Last time this patch job was updated.
+  google.protobuf.Timestamp update_time = 4;
+
+  // The current state of the PatchJob .
+  State state = 5;
+
+  // Instances to patch.
+  PatchInstanceFilter instance_filter = 13;
+
+  // Patch configuration being applied.
+  PatchConfig patch_config = 7;
+
+  // Duration of the patch job. After the duration ends, the
+  // patch job times out.
+  google.protobuf.Duration duration = 8;
+
+  // Summary of instance details.
+  InstanceDetailsSummary instance_details_summary = 9;
+
+  // If this patch job is a dry run, the agent reports that it has
+  // finished without running any updates on the VM instance.
+  bool dry_run = 10;
+
+  // If this patch job failed, this message provides information about the
+  // failure.
+  string error_message = 11;
+
+  // Reflects the overall progress of the patch job in the range of
+  // 0.0 being no progress to 100.0 being complete.
+  double percent_complete = 12;
+
+  // Output only. Name of the patch deployment that created this patch job.
+  string patch_deployment = 15 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// Patch configuration specifications. Contains details on how to apply the
+// patch(es) to a VM instance.
+message PatchConfig {
+  // Post-patch reboot settings.
+  enum RebootConfig {
+    // The default behavior is DEFAULT.
+    REBOOT_CONFIG_UNSPECIFIED = 0;
+
+    // The agent decides if a reboot is necessary by checking signals such as
+    // registry keys on Windows or `/var/run/reboot-required` on APT based
+    // systems. On RPM based systems, a set of core system package install times
+    // are compared with system boot time.
+    DEFAULT = 1;
+
+    // Always reboot the machine after the update completes.
+    ALWAYS = 2;
+
+    // Never reboot the machine after the update completes.
+    NEVER = 3;
+  }
+
+  // Post-patch reboot settings.
+  RebootConfig reboot_config = 1;
+
+  // Apt update settings. Use this setting to override the default `apt` patch
+  // rules.
+  AptSettings apt = 3;
+
+  // Yum update settings. Use this setting to override the default `yum` patch
+  // rules.
+  YumSettings yum = 4;
+
+  // Goo update settings. Use this setting to override the default `goo` patch
+  // rules.
+  GooSettings goo = 5;
+
+  // Zypper update settings. Use this setting to override the default `zypper`
+  // patch rules.
+  ZypperSettings zypper = 6;
+
+  // Windows update settings. Use this override the default windows patch rules.
+  WindowsUpdateSettings windows_update = 7;
+
+  // The `ExecStep` to run before the patch update.
+  ExecStep pre_step = 8;
+
+  // The `ExecStep` to run after the patch update.
+  ExecStep post_step = 9;
+}
+
+// Namespace for instance state enums.
+message Instance {
+  // Patch state of an instance.
+  enum PatchState {
+    // Unspecified.
+    PATCH_STATE_UNSPECIFIED = 0;
+
+    // The instance is not yet notified.
+    PENDING = 1;
+
+    // Instance is inactive and cannot be patched.
+    INACTIVE = 2;
+
+    // The instance is notified that it should be patched.
+    NOTIFIED = 3;
+
+    // The instance has started the patching process.
+    STARTED = 4;
+
+    // The instance is downloading patches.
+    DOWNLOADING_PATCHES = 5;
+
+    // The instance is applying patches.
+    APPLYING_PATCHES = 6;
+
+    // The instance is rebooting.
+    REBOOTING = 7;
+
+    // The instance has completed applying patches.
+    SUCCEEDED = 8;
+
+    // The instance has completed applying patches but a reboot is required.
+    SUCCEEDED_REBOOT_REQUIRED = 9;
+
+    // The instance has failed to apply the patch.
+    FAILED = 10;
+
+    // The instance acked the notification and will start shortly.
+    ACKED = 11;
+
+    // The instance exceeded the time out while applying the patch.
+    TIMED_OUT = 12;
+
+    // The instance is running the pre-patch step.
+    RUNNING_PRE_PATCH_STEP = 13;
+
+    // The instance is running the post-patch step.
+    RUNNING_POST_PATCH_STEP = 14;
+
+    // The service could not detect the presence of the agent. Check to ensure
+    // that the agent is installed, running, and able to communicate with the
+    // service.
+    NO_AGENT_DETECTED = 15;
+  }
+
+
+}
+
+// Message for canceling a patch job.
+message CancelPatchJobRequest {
+  // Required. Name of the patch in the form `projects/*/patchJobs/*`
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Apt patching is completed by executing `apt-get update && apt-get
+// upgrade`. Additional options can be set to control how this is executed.
+message AptSettings {
+  // Apt patch type.
+  enum Type {
+    // By default, upgrade will be performed.
+    TYPE_UNSPECIFIED = 0;
+
+    // Runs `apt-get dist-upgrade`.
+    DIST = 1;
+
+    // Runs `apt-get upgrade`.
+    UPGRADE = 2;
+  }
+
+  // By changing the type to DIST, the patching is performed
+  // using `apt-get dist-upgrade` instead.
+  Type type = 1;
+
+  // List of packages to exclude from update. These packages will be excluded
+  repeated string excludes = 2;
+
+  // An exclusive list of packages to be updated. These are the only packages
+  // that will be updated. If these packages are not installed, they will be
+  // ignored. This field cannot be specified with any other patch configuration
+  // fields.
+  repeated string exclusive_packages = 3;
+}
+
+// Yum patching is performed by executing `yum update`. Additional options
+// can be set to control how this is executed.
+//
+// Note that not all settings are supported on all platforms.
+message YumSettings {
+  // Adds the `--security` flag to `yum update`. Not supported on
+  // all platforms.
+  bool security = 1;
+
+  // Will cause patch to run `yum update-minimal` instead.
+  bool minimal = 2;
+
+  // List of packages to exclude from update. These packages are excluded by
+  // using the yum `--exclude` flag.
+  repeated string excludes = 3;
+
+  // An exclusive list of packages to be updated. These are the only packages
+  // that will be updated. If these packages are not installed, they will be
+  // ignored. This field must not be specified with any other patch
+  // configuration fields.
+  repeated string exclusive_packages = 4;
+}
+
+// Googet patching is performed by running `googet update`.
+message GooSettings {
+
+}
+
+// Zypper patching is performed by running `zypper patch`.
+// See also https://en.opensuse.org/SDB:Zypper_manual.
+message ZypperSettings {
+  // Adds the `--with-optional` flag to `zypper patch`.
+  bool with_optional = 1;
+
+  // Adds the `--with-update` flag, to `zypper patch`.
+  bool with_update = 2;
+
+  // Install only patches with these categories.
+  // Common categories include security, recommended, and feature.
+  repeated string categories = 3;
+
+  // Install only patches with these severities.
+  // Common severities include critical, important, moderate, and low.
+  repeated string severities = 4;
+
+  // List of patches to exclude from update.
+  repeated string excludes = 5;
+
+  // An exclusive list of patches to be updated. These are the only patches
+  // that will be installed using 'zypper patch patch:' command.
+  // This field must not be used with any other patch configuration fields.
+  repeated string exclusive_patches = 6;
+}
+
+// Windows patching is performed using the Windows Update Agent.
+message WindowsUpdateSettings {
+  // Microsoft Windows update classifications as defined in
+  // [1]
+  // https://support.microsoft.com/en-us/help/824684/description-of-the-standard-terminology-that-is-used-to-describe-micro
+  enum Classification {
+    // Invalid. If classifications are included, they must be specified.
+    CLASSIFICATION_UNSPECIFIED = 0;
+
+    // "A widely released fix for a specific problem that addresses a critical,
+    // non-security-related bug." [1]
+    CRITICAL = 1;
+
+    // "A widely released fix for a product-specific, security-related
+    // vulnerability. Security vulnerabilities are rated by their severity. The
+    // severity rating is indicated in the Microsoft security bulletin as
+    // critical, important, moderate, or low." [1]
+    SECURITY = 2;
+
+    // "A widely released and frequent software update that contains additions
+    // to a product's definition database. Definition databases are often used
+    // to detect objects that have specific attributes, such as malicious code,
+    // phishing websites, or junk mail." [1]
+    DEFINITION = 3;
+
+    // "Software that controls the input and output of a device." [1]
+    DRIVER = 4;
+
+    // "New product functionality that is first distributed outside the context
+    // of a product release and that is typically included in the next full
+    // product release." [1]
+    FEATURE_PACK = 5;
+
+    // "A tested, cumulative set of all hotfixes, security updates, critical
+    // updates, and updates. Additionally, service packs may contain additional
+    // fixes for problems that are found internally since the release of the
+    // product. Service packs my also contain a limited number of
+    // customer-requested design changes or features." [1]
+    SERVICE_PACK = 6;
+
+    // "A utility or feature that helps complete a task or set of tasks." [1]
+    TOOL = 7;
+
+    // "A tested, cumulative set of hotfixes, security updates, critical
+    // updates, and updates that are packaged together for easy deployment. A
+    // rollup generally targets a specific area, such as security, or a
+    // component of a product, such as Internet Information Services (IIS)." [1]
+    UPDATE_ROLLUP = 8;
+
+    // "A widely released fix for a specific problem. An update addresses a
+    // noncritical, non-security-related bug." [1]
+    UPDATE = 9;
+  }
+
+  // Only apply updates of these windows update classifications. If empty, all
+  // updates are applied.
+  repeated Classification classifications = 1;
+
+  // List of KBs to exclude from update.
+  repeated string excludes = 2;
+
+  // An exclusive list of kbs to be updated. These are the only patches
+  // that will be updated. This field must not be used with other
+  // patch configurations.
+  repeated string exclusive_patches = 3;
+}
+
+// A step that runs an executable for a PatchJob.
+message ExecStep {
+  // The ExecStepConfig for all Linux VMs targeted by the PatchJob.
+  ExecStepConfig linux_exec_step_config = 1;
+
+  // The ExecStepConfig for all Windows VMs targeted by the PatchJob.
+  ExecStepConfig windows_exec_step_config = 2;
+}
+
+// Common configurations for an ExecStep.
+message ExecStepConfig {
+  // The interpreter used to execute the a file.
+  enum Interpreter {
+    // Invalid for a Windows ExecStepConfig. For a Linux ExecStepConfig, the
+    // interpreter will be parsed from the shebang line of the script if
+    // unspecified.
+    INTERPRETER_UNSPECIFIED = 0;
+
+    // Indicates that the script is run with `/bin/sh` on Linux and `cmd`
+    // on Windows.
+    SHELL = 1;
+
+    // Indicates that the file is run with PowerShell flags
+    // `-NonInteractive`, `-NoProfile`, and `-ExecutionPolicy Bypass`.
+    POWERSHELL = 2;
+  }
+
+  // Location of the executable.
+  oneof executable {
+    // An absolute path to the executable on the VM.
+    string local_path = 1;
+
+    // A Google Cloud Storage object containing the executable.
+    GcsObject gcs_object = 2;
+  }
+
+  // Defaults to [0]. A list of possible return values that the
+  // execution can return to indicate a success.
+  repeated int32 allowed_success_codes = 3;
+
+  // The script interpreter to use to run the script. If no interpreter is
+  // specified the script will be executed directly, which will likely
+  // only succeed for scripts with [shebang lines]
+  // (https://en.wikipedia.org/wiki/Shebang_\(Unix\)).
+  Interpreter interpreter = 4;
+}
+
+// Google Cloud Storage object representation.
+message GcsObject {
+  // Required. Bucket of the Google Cloud Storage object.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Name of the Google Cloud Storage object.
+  string object = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Generation number of the Google Cloud Storage object. This is used to
+  // ensure that the ExecStep specified by this PatchJob does not change.
+  int64 generation_number = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// A filter to target VM instances for patching. The targeted
+// VMs must meet all criteria specified. So if both labels and zones are
+// specified, the patch job targets only VMs with those labels and in those
+// zones.
+message PatchInstanceFilter {
+  // Represents a group of VMs that can be identified as having all these
+  // labels, for example "env=prod and app=web".
+  message GroupLabel {
+    // Google Compute Engine instance labels that must be present for a VM
+    // instance to be targeted by this filter.
+    map labels = 1;
+  }
+
+  // Target all VM instances in the project. If true, no other criteria is
+  // permitted.
+  bool all = 1;
+
+  // Targets VM instances matching at least one of these label sets. This allows
+  // targeting of disparate groups, for example "env=prod or env=staging".
+  repeated GroupLabel group_labels = 2;
+
+  // Targets VM instances in ANY of these zones. Leave empty to target VM
+  // instances in any zone.
+  repeated string zones = 3;
+
+  // Targets any of the VM instances specified. Instances are specified by their
+  // URI in the form `zones/[ZONE]/instances/[INSTANCE_NAME],
+  // `projects/[PROJECT_ID]/zones/[ZONE]/instances/[INSTANCE_NAME]`, or
+  // `https://www.googleapis.com/compute/v1/projects/[PROJECT_ID]/zones/[ZONE]/instances/[INSTANCE_NAME]`
+  repeated string instances = 4;
+
+  // Targets VMs whose name starts with one of these prefixes. Similar to
+  // labels, this is another way to group VMs when targeting configs, for
+  // example prefix="prod-".
+  repeated string instance_name_prefixes = 5;
+}
diff --git a/third_party/googleapis/google/cloud/oslogin/artman_oslogin_v1.yaml b/third_party/googleapis/google/cloud/oslogin/artman_oslogin_v1.yaml
index 70e9022e2..6903dfc27 100644
--- a/third_party/googleapis/google/cloud/oslogin/artman_oslogin_v1.yaml
+++ b/third_party/googleapis/google/cloud/oslogin/artman_oslogin_v1.yaml
@@ -7,8 +7,9 @@ common:
   src_proto_paths:
   - common
   - v1
-  service_yaml: oslogin_v1.yaml
+  service_yaml: v1/oslogin_v1.yaml
   gapic_yaml: v1/oslogin_gapic.yaml
+  proto_package: google.cloud.oslogin.v1
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/cloud/oslogin/common/BUILD.bazel b/third_party/googleapis/google/cloud/oslogin/common/BUILD.bazel
index 8b02bf5ff..32e6e8c73 100644
--- a/third_party/googleapis/google/cloud/oslogin/common/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/oslogin/common/BUILD.bazel
@@ -1,3 +1,5 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
@@ -12,13 +14,16 @@ proto_library(
         "common.proto",
     ],
     deps = [
-        "//google/api:annotations_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
     ],
 )
 
 proto_library_with_info(
     name = "common_proto_with_info",
-    deps = [":common_proto"],
+    deps = [
+      ":common_proto",
+    ],
 )
 
 ##############################################################################
@@ -27,7 +32,7 @@ proto_library_with_info(
 load(
     "@com_google_googleapis_imports//:imports.bzl",
     "java_grpc_library",
-    "java_resource_name_proto_library",
+    "java_proto_library",
 )
 
 java_proto_library(
@@ -41,21 +46,128 @@ java_grpc_library(
     deps = [":common_java_proto"],
 )
 
-java_resource_name_proto_library(
-    name = "common_resource_name_java_proto",
-    gapic_yaml = "//google/logging/v2:logging_gapic.yaml",
-    deps = [":common_proto"],
-)
-
 ##############################################################################
 # Go
 ##############################################################################
-load("@com_google_googleapis_imports//:imports.bzl", "go_proto_library")
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_proto_library",
+)
 
 go_proto_library(
     name = "common_go_proto",
     compilers = ["@io_bazel_rules_go//proto:go_grpc"],
     importpath = "google.golang.org/genproto/googleapis/cloud/oslogin/common",
     protos = [":common_proto"],
-    deps = ["//google/api:annotations_go_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "common_moved_proto",
+    srcs = [":common_proto"],
+    strip_import_prefix = "google/cloud/oslogin/common",
+    import_prefix = "google/cloud/oslogin/common",
+    deps = [
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+    ],
+)
+
+py_proto_library(
+    name = "common_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":common_moved_proto"],
+)
+
+py_grpc_library(
+    name = "common_py_grpc",
+    srcs = [":common_moved_proto"],
+    deps = [":common_py_proto"],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "common_php_proto",
+    deps = [":common_proto"],
+)
+
+php_grpc_library(
+    name = "common_php_grpc",
+    srcs = [":common_proto"],
+    deps = [":common_php_proto"],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "common_ruby_proto",
+    deps = [":common_proto"],
+)
+
+ruby_grpc_library(
+    name = "common_ruby_grpc",
+    srcs = [":common_proto"],
+    deps = [":common_ruby_proto"],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "common_csharp_proto",
+    deps = [":common_proto"],
+)
+
+csharp_grpc_library(
+    name = "common_csharp_grpc",
+    srcs = [":common_proto"],
+    deps = [":common_csharp_proto"],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ code here
diff --git a/third_party/googleapis/google/cloud/oslogin/common/common.proto b/third_party/googleapis/google/cloud/oslogin/common/common.proto
index 6c45ebb6d..4d9755f0d 100644
--- a/third_party/googleapis/google/cloud/oslogin/common/common.proto
+++ b/third_party/googleapis/google/cloud/oslogin/common/common.proto
@@ -1,4 +1,4 @@
-// Copyright 2017 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,21 +11,48 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.oslogin.common;
 
-import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 
 option csharp_namespace = "Google.Cloud.OsLogin.Common";
 option go_package = "google.golang.org/genproto/googleapis/cloud/oslogin/common;common";
 option java_outer_classname = "OsLoginProto";
 option java_package = "com.google.cloud.oslogin.common";
 option php_namespace = "Google\\Cloud\\OsLogin\\Common";
+option ruby_package = "Google::Cloud::OsLogin::Common";
+
+// Define a "User" resource owned by OS Login.
+option (google.api.resource_definition) = {
+  type: "oslogin.googleapis.com/User"
+  pattern: "users/{user}"
+};
+
+// The operating system options for account entries.
+enum OperatingSystemType {
+  // The operating system type associated with the user account information is
+  // unspecified.
+  OPERATING_SYSTEM_TYPE_UNSPECIFIED = 0;
+
+  // Linux user account information.
+  LINUX = 1;
+
+  // Windows user account information.
+  WINDOWS = 2;
+}
 
 // The POSIX account information associated with a Google account.
 message PosixAccount {
+  option (google.api.resource) = {
+    type: "oslogin.googleapis.com/PosixAccount"
+    pattern: "users/{user}/projects/{project}"
+  };
+
   // Only one POSIX account can be marked as primary.
   bool primary = 1;
 
@@ -52,11 +79,22 @@ message PosixAccount {
   string system_id = 8;
 
   // Output only. A POSIX account identifier.
-  string account_id = 9;
+  string account_id = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // The operating system type where this account applies.
+  OperatingSystemType operating_system_type = 10;
+
+  // Output only. The canonical resource name.
+  string name = 11 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // The SSH public key information associated with a Google account.
 message SshPublicKey {
+  option (google.api.resource) = {
+    type: "oslogin.googleapis.com/SshPublicKey"
+    pattern: "users/{user}/sshPublicKeys/{fingerprint}"
+  };
+
   // Public key text in SSH format, defined by
   // RFC4253
   // section 6.6.
@@ -66,5 +104,8 @@ message SshPublicKey {
   int64 expiration_time_usec = 2;
 
   // Output only. The SHA-256 fingerprint of the SSH public key.
-  string fingerprint = 3;
+  string fingerprint = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The canonical resource name.
+  string name = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
diff --git a/third_party/googleapis/google/cloud/oslogin/oslogin_v1.yaml b/third_party/googleapis/google/cloud/oslogin/oslogin_v1.yaml
deleted file mode 100644
index ae1e989cf..000000000
--- a/third_party/googleapis/google/cloud/oslogin/oslogin_v1.yaml
+++ /dev/null
@@ -1,40 +0,0 @@
-type: google.api.Service
-config_version: 3
-name: oslogin.googleapis.com
-title: Google Cloud OS Login API
-
-apis:
-- name: google.cloud.oslogin.v1.OsLoginService
-
-documentation:
-  summary: Manages OS login configuration for Google account users.
-
-backend:
-  rules:
-  - selector: google.cloud.oslogin.v1.OsLoginService.DeletePosixAccount
-    deadline: 10.0
-  - selector: google.cloud.oslogin.v1.OsLoginService.DeleteSshPublicKey
-    deadline: 10.0
-  - selector: google.cloud.oslogin.v1.OsLoginService.GetLoginProfile
-    deadline: 10.0
-  - selector: google.cloud.oslogin.v1.OsLoginService.GetSshPublicKey
-    deadline: 10.0
-  - selector: google.cloud.oslogin.v1.OsLoginService.ImportSshPublicKey
-    deadline: 10.0
-  - selector: google.cloud.oslogin.v1.OsLoginService.UpdateSshPublicKey
-    deadline: 10.0
-
-authentication:
-  rules:
-  - selector: '*'
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform,
-        https://www.googleapis.com/auth/compute
-  - selector: google.cloud.oslogin.v1.OsLoginService.GetLoginProfile
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform,
-        https://www.googleapis.com/auth/cloud-platform.read-only,
-        https://www.googleapis.com/auth/compute,
-        https://www.googleapis.com/auth/compute.readonly
diff --git a/third_party/googleapis/google/cloud/oslogin/v1/BUILD.bazel b/third_party/googleapis/google/cloud/oslogin/v1/BUILD.bazel
index bcee7033f..ba92c5804 100644
--- a/third_party/googleapis/google/cloud/oslogin/v1/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/oslogin/v1/BUILD.bazel
@@ -1,9 +1,12 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 _PROTO_SUBPACKAGE_DEPS = [
@@ -17,6 +20,9 @@ proto_library(
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
         "@com_google_protobuf//:empty_proto",
         "@com_google_protobuf//:field_mask_proto",
     ] + _PROTO_SUBPACKAGE_DEPS,
@@ -24,7 +30,10 @@ proto_library(
 
 proto_library_with_info(
     name = "oslogin_proto_with_info",
-    deps = [":oslogin_proto"],
+    deps = [
+        ":oslogin_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -32,18 +41,14 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
     "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 _JAVA_PROTO_SUBPACKAGE_DEPS = [
     "//google/cloud/oslogin/common:common_java_proto",
 ]
@@ -52,10 +57,6 @@ _JAVA_GRPC_SUBPACKAGE_DEPS = [
     "//google/cloud/oslogin/common:common_java_grpc",
 ]
 
-_RESOURCE_NAME_JAVA_PROTO_SUBPACKAGE_DEPS = [
-    "//google/cloud/oslogin/common:common_resource_name_java_proto",
-]
-
 java_proto_library(
     name = "oslogin_java_proto",
     deps = [":oslogin_proto"],
@@ -64,51 +65,52 @@ java_proto_library(
 java_grpc_library(
     name = "oslogin_java_grpc",
     srcs = [":oslogin_proto"],
-    deps = [":oslogin_java_proto"] + _JAVA_GRPC_DEPS + _JAVA_PROTO_SUBPACKAGE_DEPS,
+    deps = [":oslogin_java_proto"] + _JAVA_PROTO_SUBPACKAGE_DEPS,
 )
 
 java_resource_name_proto_library(
-    name = "oslogin_resource_name_java_proto",
-    gapic_yaml = "oslogin_gapic.yaml",
-    deps = [":oslogin_proto"],
+    name = "oslogin_java_gapic_resource_name",
+    gapic_yaml = "//google/cloud/oslogin/v1:oslogin_gapic.yaml",
+    deps = [
+        ":oslogin_proto",
+        "//google/cloud:common_resources_proto",
+    ] + _PROTO_SUBPACKAGE_DEPS,
 )
 
 java_gapic_library(
     name = "oslogin_java_gapic",
     src = ":oslogin_proto_with_info",
     gapic_yaml = "oslogin_gapic.yaml",
-    service_yaml = "//google/cloud/oslogin:oslogin_v1.yaml",
+    gen_resource_name = False,
+    package = "google.cloud.oslogin.v1",
+    service_yaml = ":oslogin_v1.yaml",
     test_deps = [
         ":oslogin_java_grpc",
     ] + _JAVA_GRPC_SUBPACKAGE_DEPS,
     deps = [
         ":oslogin_java_proto",
-        ":oslogin_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS + _JAVA_PROTO_SUBPACKAGE_DEPS,
+        ":oslogin_java_gapic_resource_name",
+    ] + _JAVA_PROTO_SUBPACKAGE_DEPS,
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
+java_gapic_test(
+    name = "oslogin_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.oslogin.v1.OsLoginServiceClientTest",
+    ],
     runtime_deps = [":oslogin_java_gapic_test"],
-) for test_name in [
-    "com.google.cloud.oslogin.v1.OsLoginServiceClientTest",
-]]
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-oslogin-v1-java",
-    client_deps = [":oslogin_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":oslogin_java_gapic_test"],
-    grpc_deps = [":oslogin_java_grpc"] + _JAVA_GRPC_SUBPACKAGE_DEPS,
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":oslogin_java_gapic",
+        ":oslogin_java_grpc",
         ":oslogin_java_proto",
         ":oslogin_proto",
-        ":oslogin_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS + _JAVA_PROTO_SUBPACKAGE_DEPS + _PROTO_SUBPACKAGE_DEPS + _RESOURCE_NAME_JAVA_PROTO_SUBPACKAGE_DEPS,
-    version = "0.0.0-SNAPSHOT",
+        ":oslogin_java_gapic_resource_name",
+    ] + _JAVA_PROTO_SUBPACKAGE_DEPS + _PROTO_SUBPACKAGE_DEPS + _JAVA_GRPC_SUBPACKAGE_DEPS,
 )
 
 ##############################################################################
@@ -116,10 +118,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -135,10 +137,10 @@ go_proto_library(
 
 go_gapic_library(
     name = "oslogin_go_gapic",
-    src = ":oslogin_proto_with_info",
-    gapic_yaml = "oslogin_gapic.yaml",
-    importpath = "cloud.google.com/go/oslogin/apiv1",
-    service_yaml = "//google/cloud/oslogin:oslogin_v1.yaml",
+    srcs = [":oslogin_proto_with_info"],
+    grpc_service_config = "oslogin_grpc_service_config.json",
+    importpath = "cloud.google.com/go/oslogin/apiv1;oslogin",
+    service_yaml = "oslogin_v1.yaml",
     deps = [
         ":oslogin_go_proto",
         "//google/cloud/oslogin/common:common_go_proto",
@@ -152,14 +154,255 @@ go_test(
     importpath = "cloud.google.com/go/oslogin/apiv1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-oslogin-v1-go",
     deps = [
         ":oslogin_go_gapic",
-        ":oslogin_go_gapic_srcjar-smoke-test.srcjar",
         ":oslogin_go_gapic_srcjar-test.srcjar",
         ":oslogin_go_proto",
         "//google/cloud/oslogin/common:common_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+_PY_SUBPACKAGE_DEPS = [
+    "//google/cloud/oslogin/common:common_py_proto",
+    "//google/cloud/oslogin/common:common_py_grpc",
+]
+
+moved_proto_library(
+    name = "oslogin_moved_proto",
+    srcs = [":oslogin_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+    ] + _PROTO_SUBPACKAGE_DEPS,
+)
+
+py_proto_library(
+    name = "oslogin_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":oslogin_moved_proto"],
+)
+
+py_grpc_library(
+    name = "oslogin_py_grpc",
+    srcs = [":oslogin_moved_proto"],
+    deps = [":oslogin_py_proto"],
+)
+
+py_gapic_library(
+    name = "oslogin_py_gapic",
+    src = ":oslogin_proto_with_info",
+    gapic_yaml = "oslogin_gapic.yaml",
+    package = "google.cloud.oslogin.v1",
+    service_yaml = "oslogin_v1.yaml",
+    deps = [
+        ":oslogin_py_grpc",
+        ":oslogin_py_proto",
+    ] + _PY_SUBPACKAGE_DEPS,
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "oslogin-v1-py",
+    deps = [
+        ":oslogin_py_gapic",
+        ":oslogin_py_grpc",
+        ":oslogin_py_proto",
+    ] + _PY_SUBPACKAGE_DEPS,
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+_PHP_SUBPACKAGE_DEPS = [
+    "//google/cloud/oslogin/common:common_php_proto",
+    "//google/cloud/oslogin/common:common_php_grpc",
+]
+
+php_proto_library(
+    name = "oslogin_php_proto",
+    deps = [":oslogin_proto"],
+)
+
+php_grpc_library(
+    name = "oslogin_php_grpc",
+    srcs = [":oslogin_proto"],
+    deps = [":oslogin_php_proto"],
+)
+
+php_gapic_library(
+    name = "oslogin_php_gapic",
+    src = ":oslogin_proto_with_info",
+    gapic_yaml = "oslogin_gapic.yaml",
+    package = "google.cloud.oslogin.v1",
+    service_yaml = "oslogin_v1.yaml",
+    deps = [
+        ":oslogin_php_grpc",
+        ":oslogin_php_proto",
+    ] + _PHP_SUBPACKAGE_DEPS,
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-oslogin-v1-php",
+    deps = [
+        ":oslogin_php_gapic",
+        ":oslogin_php_grpc",
+        ":oslogin_php_proto",
+    ] + _PHP_SUBPACKAGE_DEPS,
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "oslogin_nodejs_gapic",
+    src = ":oslogin_proto_with_info",
+    gapic_yaml = "oslogin_gapic.yaml",
+    package = "google.cloud.oslogin.v1",
+    service_yaml = "oslogin_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "oslogin-v1-nodejs",
+    deps = [
+        ":oslogin_nodejs_gapic",
+        ":oslogin_proto",
+    ] + _PROTO_SUBPACKAGE_DEPS,
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+_RUBY_SUBPACKAGE_DEPS = [
+    "//google/cloud/oslogin/common:common_ruby_proto",
+    "//google/cloud/oslogin/common:common_ruby_grpc",
+]
+
+ruby_proto_library(
+    name = "oslogin_ruby_proto",
+    deps = [":oslogin_proto"],
+)
+
+ruby_grpc_library(
+    name = "oslogin_ruby_grpc",
+    srcs = [":oslogin_proto"],
+    deps = [":oslogin_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "oslogin_ruby_gapic",
+    src = ":oslogin_proto_with_info",
+    gapic_yaml = "oslogin_gapic.yaml",
+    package = "google.cloud.oslogin.v1",
+    service_yaml = "oslogin_v1.yaml",
+    deps = [
+        ":oslogin_ruby_grpc",
+        ":oslogin_ruby_proto",
+    ] + _RUBY_SUBPACKAGE_DEPS,
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-oslogin-v1-ruby",
+    deps = [
+        ":oslogin_ruby_gapic",
+        ":oslogin_ruby_grpc",
+        ":oslogin_ruby_proto",
+    ] + _RUBY_SUBPACKAGE_DEPS,
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+_CSHARP_SUBPACKAGE_DEPS = [
+    "//google/cloud/oslogin/common:common_csharp_proto",
+    "//google/cloud/oslogin/common:common_csharp_grpc",
+]
+
+csharp_proto_library(
+    name = "oslogin_csharp_proto",
+    deps = [":oslogin_proto"],
+)
+
+csharp_grpc_library(
+    name = "oslogin_csharp_grpc",
+    srcs = [":oslogin_proto"],
+    deps = [":oslogin_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "oslogin_csharp_gapic",
+    src = ":oslogin_proto_with_info",
+    gapic_yaml = "oslogin_gapic.yaml",
+    package = "google.cloud.oslogin.v1",
+    service_yaml = "oslogin_v1.yaml",
+    deps = [
+        ":oslogin_csharp_grpc",
+        ":oslogin_csharp_proto",
+    ] + _CSHARP_SUBPACKAGE_DEPS,
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-oslogin-v1-csharp",
+    deps = [
+        ":oslogin_csharp_gapic",
+        ":oslogin_csharp_grpc",
+        ":oslogin_csharp_proto",
+    ] + _CSHARP_SUBPACKAGE_DEPS,
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/oslogin/v1/oslogin.proto b/third_party/googleapis/google/cloud/oslogin/v1/oslogin.proto
index d76bd47e6..25e9be0a0 100644
--- a/third_party/googleapis/google/cloud/oslogin/v1/oslogin.proto
+++ b/third_party/googleapis/google/cloud/oslogin/v1/oslogin.proto
@@ -1,4 +1,4 @@
-// Copyright 2017 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,12 +11,16 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.oslogin.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/oslogin/common/common.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
@@ -27,26 +31,32 @@ option java_multiple_files = true;
 option java_outer_classname = "OsLoginProto";
 option java_package = "com.google.cloud.oslogin.v1";
 option php_namespace = "Google\\Cloud\\OsLogin\\V1";
+option ruby_package = "Google::Cloud::OsLogin::V1";
 
 // Cloud OS Login API
 //
 // The Cloud OS Login API allows you to manage users and their associated SSH
 // public keys for logging into virtual machines on Google Cloud Platform.
 service OsLoginService {
+  option (google.api.default_host) = "oslogin.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/compute";
+
   // Deletes a POSIX account.
-  rpc DeletePosixAccount(DeletePosixAccountRequest)
-      returns (google.protobuf.Empty) {
+  rpc DeletePosixAccount(DeletePosixAccountRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v1/{name=users/*/projects/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Deletes an SSH public key.
-  rpc DeleteSshPublicKey(DeleteSshPublicKeyRequest)
-      returns (google.protobuf.Empty) {
+  rpc DeleteSshPublicKey(DeleteSshPublicKeyRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v1/{name=users/*/sshPublicKeys/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Retrieves the profile information used for logging in to a virtual machine
@@ -55,92 +65,122 @@ service OsLoginService {
     option (google.api.http) = {
       get: "/v1/{name=users/*}/loginProfile"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Retrieves an SSH public key.
-  rpc GetSshPublicKey(GetSshPublicKeyRequest)
-      returns (google.cloud.oslogin.common.SshPublicKey) {
+  rpc GetSshPublicKey(GetSshPublicKeyRequest) returns (google.cloud.oslogin.common.SshPublicKey) {
     option (google.api.http) = {
       get: "/v1/{name=users/*/sshPublicKeys/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Adds an SSH public key and returns the profile information. Default POSIX
   // account information is set when no username and UID exist as part of the
   // login profile.
-  rpc ImportSshPublicKey(ImportSshPublicKeyRequest)
-      returns (ImportSshPublicKeyResponse) {
+  rpc ImportSshPublicKey(ImportSshPublicKeyRequest) returns (ImportSshPublicKeyResponse) {
     option (google.api.http) = {
       post: "/v1/{parent=users/*}:importSshPublicKey"
       body: "ssh_public_key"
     };
+    option (google.api.method_signature) = "parent,ssh_public_key";
+    option (google.api.method_signature) = "parent,ssh_public_key,project_id";
   }
 
   // Updates an SSH public key and returns the profile information. This method
   // supports patch semantics.
-  rpc UpdateSshPublicKey(UpdateSshPublicKeyRequest)
-      returns (google.cloud.oslogin.common.SshPublicKey) {
+  rpc UpdateSshPublicKey(UpdateSshPublicKeyRequest) returns (google.cloud.oslogin.common.SshPublicKey) {
     option (google.api.http) = {
       patch: "/v1/{name=users/*/sshPublicKeys/*}"
       body: "ssh_public_key"
     };
+    option (google.api.method_signature) = "name,ssh_public_key";
+    option (google.api.method_signature) = "name,ssh_public_key,update_mask";
   }
 }
 
 // The user profile information used for logging in to a virtual machine on
 // Google Compute Engine.
 message LoginProfile {
-  // The primary email address that uniquely identifies the user.
-  string name = 1;
+  // Required. A unique user ID.
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The list of POSIX accounts associated with the user.
   repeated google.cloud.oslogin.common.PosixAccount posix_accounts = 2;
 
   // A map from SSH public key fingerprint to the associated key object.
   map ssh_public_keys = 3;
-
-  // Indicates if the user is suspended. A suspended user cannot log in but
-  // their profile information is retained.
-  bool suspended = 4;
 }
 
 // A request message for deleting a POSIX account entry.
 message DeletePosixAccountRequest {
-  // A reference to the POSIX account to update. POSIX accounts are identified
+  // Required. A reference to the POSIX account to update. POSIX accounts are identified
   // by the project ID they are associated with. A reference to the POSIX
   // account is in format `users/{user}/projects/{project}`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "oslogin.googleapis.com/PosixAccount"
+    }
+  ];
 }
 
 // A request message for deleting an SSH public key.
 message DeleteSshPublicKeyRequest {
-  // The fingerprint of the public key to update. Public keys are identified by
+  // Required. The fingerprint of the public key to update. Public keys are identified by
   // their SHA-256 fingerprint. The fingerprint of the public key is in format
   // `users/{user}/sshPublicKeys/{fingerprint}`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "oslogin.googleapis.com/SshPublicKey"
+    }
+  ];
 }
 
 // A request message for retrieving the login profile information for a user.
 message GetLoginProfileRequest {
-  // The unique ID for the user in format `users/{user}`.
-  string name = 1;
+  // Required. The unique ID for the user in format `users/{user}`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "oslogin.googleapis.com/PosixAccount"
+    }
+  ];
+
+  // The project ID of the Google Cloud Platform project.
+  string project_id = 2;
+
+  // A system ID for filtering the results of the request.
+  string system_id = 3;
 }
 
 // A request message for retrieving an SSH public key.
 message GetSshPublicKeyRequest {
-  // The fingerprint of the public key to retrieve. Public keys are identified
+  // Required. The fingerprint of the public key to retrieve. Public keys are identified
   // by their SHA-256 fingerprint. The fingerprint of the public key is in
   // format `users/{user}/sshPublicKeys/{fingerprint}`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "oslogin.googleapis.com/SshPublicKey"
+    }
+  ];
 }
 
 // A request message for importing an SSH public key.
 message ImportSshPublicKeyRequest {
-  // The unique ID for the user in format `users/{user}`.
-  string parent = 1;
+  // Required. The unique ID for the user in format `users/{user}`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "oslogin.googleapis.com/SshPublicKey"
+    }
+  ];
 
-  // The SSH public key and expiration time.
-  google.cloud.oslogin.common.SshPublicKey ssh_public_key = 2;
+  // Optional. The SSH public key and expiration time.
+  google.cloud.oslogin.common.SshPublicKey ssh_public_key = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // The project ID of the Google Cloud Platform project.
   string project_id = 3;
@@ -154,13 +194,18 @@ message ImportSshPublicKeyResponse {
 
 // A request message for updating an SSH public key.
 message UpdateSshPublicKeyRequest {
-  // The fingerprint of the public key to update. Public keys are identified by
+  // Required. The fingerprint of the public key to update. Public keys are identified by
   // their SHA-256 fingerprint. The fingerprint of the public key is in format
   // `users/{user}/sshPublicKeys/{fingerprint}`.
-  string name = 1;
-
-  // The SSH public key and expiration time.
-  google.cloud.oslogin.common.SshPublicKey ssh_public_key = 2;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "oslogin.googleapis.com/SshPublicKey"
+    }
+  ];
+
+  // Required. The SSH public key and expiration time.
+  google.cloud.oslogin.common.SshPublicKey ssh_public_key = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Mask to control which fields get updated. Updates all if not present.
   google.protobuf.FieldMask update_mask = 3;
diff --git a/third_party/googleapis/google/cloud/oslogin/v1/oslogin_gapic.legacy.yaml b/third_party/googleapis/google/cloud/oslogin/v1/oslogin_gapic.legacy.yaml
new file mode 100644
index 000000000..3aff8851c
--- /dev/null
+++ b/third_party/googleapis/google/cloud/oslogin/v1/oslogin_gapic.legacy.yaml
@@ -0,0 +1,221 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.oslogin.v1
+  python:
+    package_name: google.cloud.oslogin_v1.gapic
+  go:
+    package_name: cloud.google.com/go/oslogin/apiv1
+  csharp:
+    package_name: Google.Cloud.OsLogin.V1
+  ruby:
+    package_name: Google::Cloud::OsLogin::V1
+  php:
+    package_name: Google\Cloud\OsLogin\V1
+  nodejs:
+    package_name: os-login.v1
+    domain_layer_location: google-cloud
+# A list of API interface configurations.
+interfaces:
+- name: google.cloud.oslogin.v1.OsLoginService
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: users/{user}
+    entity_name: user
+  - name_pattern: users/{user}/projects/{project}
+    entity_name: project
+  - name_pattern: users/{user}/sshPublicKeys/{fingerprint}
+    entity_name: fingerprint
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 10000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 10000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: DeletePosixAccount
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: project
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 10000
+  - name: DeleteSshPublicKey
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: fingerprint
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 10000
+  - name: GetLoginProfile
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: user
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 10000
+  - name: GetSshPublicKey
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: fingerprint
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 10000
+  - name: ImportSshPublicKey
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - ssh_public_key
+      - parameters:
+        - parent
+        - ssh_public_key
+        - project_id
+    required_fields:
+    - parent
+    - ssh_public_key
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: user
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 10000
+  - name: UpdateSshPublicKey
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - ssh_public_key
+      - parameters:
+        - name
+        - ssh_public_key
+        - update_mask
+    required_fields:
+    - name
+    - ssh_public_key
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: fingerprint
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 10000
+resource_name_generation:
+- message_name: DeletePosixAccountRequest
+  field_entity_map:
+    name: project
+- message_name: DeleteSshPublicKeyRequest
+  field_entity_map:
+    name: fingerprint
+- message_name: GetLoginProfileRequest
+  field_entity_map:
+    name: user
+- message_name: GetSshPublicKeyRequest
+  field_entity_map:
+    name: fingerprint
+- message_name: ImportSshPublicKeyRequest
+  field_entity_map:
+    parent: user
+- message_name: UpdateSshPublicKeyRequest
+  field_entity_map:
+    name: fingerprint
diff --git a/third_party/googleapis/google/cloud/oslogin/v1/oslogin_gapic.yaml b/third_party/googleapis/google/cloud/oslogin/v1/oslogin_gapic.yaml
index 167c821f3..fc163107c 100644
--- a/third_party/googleapis/google/cloud/oslogin/v1/oslogin_gapic.yaml
+++ b/third_party/googleapis/google/cloud/oslogin/v1/oslogin_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -17,36 +17,8 @@ language_settings:
   nodejs:
     package_name: os-login.v1
     domain_layer_location: google-cloud
-# A list of API interface configurations.
 interfaces:
-  # The fully qualified name of the API interface.
 - name: google.cloud.oslogin.v1.OsLoginService
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections:
-  - name_pattern: users/{user}
-    entity_name: user
-  - name_pattern: users/{user}/projects/{project}
-    entity_name: project
-  - name_pattern: users/{user}/sshPublicKeys/{fingerprint}
-    entity_name: fingerprint
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 100
@@ -56,167 +28,12 @@ interfaces:
     rpc_timeout_multiplier: 1
     max_rpc_timeout_millis: 10000
     total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
   methods:
   - name: DeletePosixAccount
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: project
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 10000
   - name: DeleteSshPublicKey
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: fingerprint
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 10000
-  - name: GetLoginProfile
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: user
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 10000
-  - name: GetSshPublicKey
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: fingerprint
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 10000
   - name: ImportSshPublicKey
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - ssh_public_key
-      - parameters:
-        - parent
-        - ssh_public_key
-        - project_id
-    required_fields:
-    - parent
-    - ssh_public_key
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: user
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 10000
   - name: UpdateSshPublicKey
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - ssh_public_key
-      - parameters:
-        - name
-        - ssh_public_key
-        - update_mask
-    required_fields:
-    - name
-    - ssh_public_key
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: fingerprint
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 10000
-resource_name_generation:
-- message_name: DeletePosixAccountRequest
-  field_entity_map:
-    name: project
-- message_name: DeleteSshPublicKeyRequest
-  field_entity_map:
-    name: fingerprint
-- message_name: GetLoginProfileRequest
-  field_entity_map:
-    name: user
-- message_name: GetSshPublicKeyRequest
-  field_entity_map:
-    name: fingerprint
-- message_name: ImportSshPublicKeyRequest
-  field_entity_map:
-    parent: user
-- message_name: UpdateSshPublicKeyRequest
-  field_entity_map:
-    name: fingerprint
diff --git a/third_party/googleapis/google/cloud/oslogin/v1/oslogin_grpc_service_config.json b/third_party/googleapis/google/cloud/oslogin/v1/oslogin_grpc_service_config.json
new file mode 100644
index 000000000..b574fcaad
--- /dev/null
+++ b/third_party/googleapis/google/cloud/oslogin/v1/oslogin_grpc_service_config.json
@@ -0,0 +1,42 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.oslogin.v1.OsLoginService",
+          "method": "DeletePosixAccount"
+        },
+        {
+          "service": "google.cloud.oslogin.v1.OsLoginService",
+          "method": "DeleteSshPublicKey"
+        },
+        {
+          "service": "google.cloud.oslogin.v1.OsLoginService",
+          "method": "GetLoginProfile"
+        },
+        {
+          "service": "google.cloud.oslogin.v1.OsLoginService",
+          "method": "GetSshPublicKey"
+        },
+        {
+          "service": "google.cloud.oslogin.v1.OsLoginService",
+          "method": "ImportSshPublicKey"
+        },
+        {
+          "service": "google.cloud.oslogin.v1.OsLoginService",
+          "method": "UpdateSshPublicKey"
+        }
+      ],
+      "timeout": "10s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/oslogin/v1/oslogin_v1.yaml b/third_party/googleapis/google/cloud/oslogin/v1/oslogin_v1.yaml
new file mode 100644
index 000000000..8d345ed2b
--- /dev/null
+++ b/third_party/googleapis/google/cloud/oslogin/v1/oslogin_v1.yaml
@@ -0,0 +1,23 @@
+type: google.api.Service
+config_version: 3
+name: oslogin.googleapis.com
+title: Cloud OS Login API
+
+apis:
+- name: google.cloud.oslogin.v1.OsLoginService
+
+documentation:
+  summary: You can use OS Login to manage access to your VM instances using IAM roles.
+
+backend:
+  rules:
+  - selector: 'google.cloud.oslogin.v1.OsLoginService.*'
+    deadline: 10.0
+
+authentication:
+  rules:
+  - selector: 'google.cloud.oslogin.v1.OsLoginService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/compute
diff --git a/third_party/googleapis/google/cloud/oslogin/v1beta/BUILD.bazel b/third_party/googleapis/google/cloud/oslogin/v1beta/BUILD.bazel
index b93768497..ff1e42d5e 100644
--- a/third_party/googleapis/google/cloud/oslogin/v1beta/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/oslogin/v1beta/BUILD.bazel
@@ -1,3 +1,5 @@
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
@@ -17,6 +19,9 @@ proto_library(
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
         "@com_google_protobuf//:empty_proto",
         "@com_google_protobuf//:field_mask_proto",
     ] + _PROTO_SUBPACKAGE_DEPS,
@@ -24,7 +29,10 @@ proto_library(
 
 proto_library_with_info(
     name = "oslogin_proto_with_info",
-    deps = [":oslogin_proto"],
+    deps = [
+        ":oslogin_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -32,18 +40,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 _JAVA_PROTO_SUBPACKAGE_DEPS = [
     "//google/cloud/oslogin/common:common_java_proto",
 ]
@@ -52,10 +55,6 @@ _JAVA_GRPC_SUBPACKAGE_DEPS = [
     "//google/cloud/oslogin/common:common_java_grpc",
 ]
 
-_RESOURCE_NAME_JAVA_PROTO_SUBPACKAGE_DEPS = [
-    "//google/cloud/oslogin/common:common_resource_name_java_proto",
-]
-
 java_proto_library(
     name = "oslogin_java_proto",
     deps = [":oslogin_proto"],
@@ -64,13 +63,7 @@ java_proto_library(
 java_grpc_library(
     name = "oslogin_java_grpc",
     srcs = [":oslogin_proto"],
-    deps = [":oslogin_java_proto"] + _JAVA_GRPC_DEPS + _JAVA_PROTO_SUBPACKAGE_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "oslogin_resource_name_java_proto",
-    gapic_yaml = "oslogin_gapic.yaml",
-    deps = [":oslogin_proto"],
+    deps = [":oslogin_java_proto"] + _JAVA_PROTO_SUBPACKAGE_DEPS,
 )
 
 java_gapic_library(
@@ -78,37 +71,29 @@ java_gapic_library(
     src = ":oslogin_proto_with_info",
     gapic_yaml = "oslogin_gapic.yaml",
     service_yaml = "//google/cloud/oslogin:oslogin_v1beta.yaml",
-    test_deps = [
-        ":oslogin_java_grpc",
-    ] + _JAVA_GRPC_SUBPACKAGE_DEPS,
+    test_deps = [":oslogin_java_grpc"],
     deps = [
         ":oslogin_java_proto",
-        ":oslogin_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS + _JAVA_PROTO_SUBPACKAGE_DEPS,
+    ] + _JAVA_PROTO_SUBPACKAGE_DEPS,
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
+java_gapic_test(
+    name = "oslogin_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.oslogin.v1beta.OsLoginServiceClientTest",
+    ],
     runtime_deps = [":oslogin_java_gapic_test"],
-) for test_name in [
-    "com.google.cloud.oslogin.v1beta.OsLoginServiceClientTest",
-]]
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-oslogin-v1beta-java",
-    client_deps = [":oslogin_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":oslogin_java_gapic_test"],
-    grpc_deps = [":oslogin_java_grpc"] + _JAVA_GRPC_SUBPACKAGE_DEPS,
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":oslogin_java_gapic",
+        ":oslogin_java_grpc",
         ":oslogin_java_proto",
         ":oslogin_proto",
-        ":oslogin_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS + _JAVA_PROTO_SUBPACKAGE_DEPS + _PROTO_SUBPACKAGE_DEPS + _RESOURCE_NAME_JAVA_PROTO_SUBPACKAGE_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ] + _JAVA_PROTO_SUBPACKAGE_DEPS + _PROTO_SUBPACKAGE_DEPS,
 )
 
 ##############################################################################
@@ -116,10 +101,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -135,9 +120,9 @@ go_proto_library(
 
 go_gapic_library(
     name = "oslogin_go_gapic",
-    src = ":oslogin_proto_with_info",
-    gapic_yaml = "oslogin_gapic.yaml",
-    importpath = "cloud.google.com/go/oslogin/apiv1beta",
+    srcs = [":oslogin_proto_with_info"],
+    grpc_service_config = "oslogin_grpc_service_config.json",
+    importpath = "cloud.google.com/go/oslogin/apiv1beta;oslogin",
     service_yaml = "//google/cloud/oslogin:oslogin_v1beta.yaml",
     deps = [
         ":oslogin_go_proto",
@@ -152,14 +137,255 @@ go_test(
     importpath = "cloud.google.com/go/oslogin/apiv1beta",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-oslogin-v1beta-go",
     deps = [
         ":oslogin_go_gapic",
-        ":oslogin_go_gapic_srcjar-smoke-test.srcjar",
         ":oslogin_go_gapic_srcjar-test.srcjar",
         ":oslogin_go_proto",
         "//google/cloud/oslogin/common:common_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+_PY_SUBPACKAGE_DEPS = [
+    "//google/cloud/oslogin/common:common_py_proto",
+    "//google/cloud/oslogin/common:common_py_grpc",
+]
+
+moved_proto_library(
+    name = "oslogin_moved_proto",
+    srcs = [":oslogin_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+    ] + _PROTO_SUBPACKAGE_DEPS,
+)
+
+py_proto_library(
+    name = "oslogin_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":oslogin_moved_proto"],
+)
+
+py_grpc_library(
+    name = "oslogin_py_grpc",
+    srcs = [":oslogin_moved_proto"],
+    deps = [":oslogin_py_proto"],
+)
+
+py_gapic_library(
+    name = "oslogin_py_gapic",
+    src = ":oslogin_proto_with_info",
+    gapic_yaml = "oslogin_gapic.yaml",
+    package = "google.cloud.oslogin.v1beta",
+    service_yaml = "oslogin_v1beta.yaml",
+    deps = [
+        ":oslogin_py_grpc",
+        ":oslogin_py_proto",
+    ] + _PY_SUBPACKAGE_DEPS,
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "oslogin-v1beta-py",
+    deps = [
+        ":oslogin_py_gapic",
+        ":oslogin_py_grpc",
+        ":oslogin_py_proto",
+    ] + _PY_SUBPACKAGE_DEPS,
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+_PHP_SUBPACKAGE_DEPS = [
+    "//google/cloud/oslogin/common:common_php_proto",
+    "//google/cloud/oslogin/common:common_php_grpc",
+]
+
+php_proto_library(
+    name = "oslogin_php_proto",
+    deps = [":oslogin_proto"],
+)
+
+php_grpc_library(
+    name = "oslogin_php_grpc",
+    srcs = [":oslogin_proto"],
+    deps = [":oslogin_php_proto"],
+)
+
+php_gapic_library(
+    name = "oslogin_php_gapic",
+    src = ":oslogin_proto_with_info",
+    gapic_yaml = "oslogin_gapic.yaml",
+    package = "google.cloud.oslogin.v1beta",
+    service_yaml = "oslogin_v1beta.yaml",
+    deps = [
+        ":oslogin_php_grpc",
+        ":oslogin_php_proto",
+    ] + _PHP_SUBPACKAGE_DEPS,
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-oslogin-v1beta-php",
+    deps = [
+        ":oslogin_php_gapic",
+        ":oslogin_php_grpc",
+        ":oslogin_php_proto",
+    ] + _PHP_SUBPACKAGE_DEPS,
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "oslogin_nodejs_gapic",
+    src = ":oslogin_proto_with_info",
+    gapic_yaml = "oslogin_gapic.yaml",
+    package = "google.cloud.oslogin.v1beta",
+    service_yaml = "oslogin_v1beta.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "oslogin-v1beta-nodejs",
+    deps = [
+        ":oslogin_nodejs_gapic",
+        ":oslogin_proto",
+    ] + _PROTO_SUBPACKAGE_DEPS,
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+_RUBY_SUBPACKAGE_DEPS = [
+    "//google/cloud/oslogin/common:common_ruby_proto",
+    "//google/cloud/oslogin/common:common_ruby_grpc",
+]
+
+ruby_proto_library(
+    name = "oslogin_ruby_proto",
+    deps = [":oslogin_proto"],
+)
+
+ruby_grpc_library(
+    name = "oslogin_ruby_grpc",
+    srcs = [":oslogin_proto"],
+    deps = [":oslogin_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "oslogin_ruby_gapic",
+    src = ":oslogin_proto_with_info",
+    gapic_yaml = "oslogin_gapic.yaml",
+    package = "google.cloud.oslogin.v1beta",
+    service_yaml = "oslogin_v1beta.yaml",
+    deps = [
+        ":oslogin_ruby_grpc",
+        ":oslogin_ruby_proto",
+    ] + _RUBY_SUBPACKAGE_DEPS,
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-oslogin-v1beta-ruby",
+    deps = [
+        ":oslogin_ruby_gapic",
+        ":oslogin_ruby_grpc",
+        ":oslogin_ruby_proto",
+    ] + _RUBY_SUBPACKAGE_DEPS,
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+_CSHARP_SUBPACKAGE_DEPS = [
+    "//google/cloud/oslogin/common:common_csharp_proto",
+    "//google/cloud/oslogin/common:common_csharp_grpc",
+]
+
+csharp_proto_library(
+    name = "oslogin_csharp_proto",
+    deps = [":oslogin_proto"],
+)
+
+csharp_grpc_library(
+    name = "oslogin_csharp_grpc",
+    srcs = [":oslogin_proto"],
+    deps = [":oslogin_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "oslogin_csharp_gapic",
+    src = ":oslogin_proto_with_info",
+    gapic_yaml = "oslogin_gapic.yaml",
+    package = "google.cloud.oslogin.v1beta",
+    service_yaml = "oslogin_v1beta.yaml",
+    deps = [
+        ":oslogin_csharp_grpc",
+        ":oslogin_csharp_proto",
+    ] + _CSHARP_SUBPACKAGE_DEPS,
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-oslogin-v1beta-csharp",
+    deps = [
+        ":oslogin_csharp_gapic",
+        ":oslogin_csharp_grpc",
+        ":oslogin_csharp_proto",
+    ] + _CSHARP_SUBPACKAGE_DEPS,
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/oslogin/v1beta/oslogin.proto b/third_party/googleapis/google/cloud/oslogin/v1beta/oslogin.proto
index 304c4d9f6..a5d784746 100644
--- a/third_party/googleapis/google/cloud/oslogin/v1beta/oslogin.proto
+++ b/third_party/googleapis/google/cloud/oslogin/v1beta/oslogin.proto
@@ -1,4 +1,4 @@
-// Copyright 2017 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,12 +11,16 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.oslogin.v1beta;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/oslogin/common/common.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
@@ -27,26 +31,34 @@ option java_multiple_files = true;
 option java_outer_classname = "OsLoginProto";
 option java_package = "com.google.cloud.oslogin.v1beta";
 option php_namespace = "Google\\Cloud\\OsLogin\\V1beta";
+option ruby_package = "Google::Cloud::OsLogin::V1beta";
 
 // Cloud OS Login API
 //
 // The Cloud OS Login API allows you to manage users and their associated SSH
 // public keys for logging into virtual machines on Google Cloud Platform.
 service OsLoginService {
+  option (google.api.default_host) = "oslogin.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/cloud-platform.read-only,"
+      "https://www.googleapis.com/auth/compute,"
+      "https://www.googleapis.com/auth/compute.readonly";
+
   // Deletes a POSIX account.
-  rpc DeletePosixAccount(DeletePosixAccountRequest)
-      returns (google.protobuf.Empty) {
+  rpc DeletePosixAccount(DeletePosixAccountRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v1beta/{name=users/*/projects/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Deletes an SSH public key.
-  rpc DeleteSshPublicKey(DeleteSshPublicKeyRequest)
-      returns (google.protobuf.Empty) {
+  rpc DeleteSshPublicKey(DeleteSshPublicKeyRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v1beta/{name=users/*/sshPublicKeys/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Retrieves the profile information used for logging in to a virtual machine
@@ -55,92 +67,116 @@ service OsLoginService {
     option (google.api.http) = {
       get: "/v1beta/{name=users/*}/loginProfile"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Retrieves an SSH public key.
-  rpc GetSshPublicKey(GetSshPublicKeyRequest)
-      returns (google.cloud.oslogin.common.SshPublicKey) {
+  rpc GetSshPublicKey(GetSshPublicKeyRequest) returns (google.cloud.oslogin.common.SshPublicKey) {
     option (google.api.http) = {
       get: "/v1beta/{name=users/*/sshPublicKeys/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Adds an SSH public key and returns the profile information. Default POSIX
   // account information is set when no username and UID exist as part of the
   // login profile.
-  rpc ImportSshPublicKey(ImportSshPublicKeyRequest)
-      returns (ImportSshPublicKeyResponse) {
+  rpc ImportSshPublicKey(ImportSshPublicKeyRequest) returns (ImportSshPublicKeyResponse) {
     option (google.api.http) = {
       post: "/v1beta/{parent=users/*}:importSshPublicKey"
       body: "ssh_public_key"
     };
+    option (google.api.method_signature) = "parent,ssh_public_key";
+    option (google.api.method_signature) = "parent,ssh_public_key,project_id";
   }
 
   // Updates an SSH public key and returns the profile information. This method
   // supports patch semantics.
-  rpc UpdateSshPublicKey(UpdateSshPublicKeyRequest)
-      returns (google.cloud.oslogin.common.SshPublicKey) {
+  rpc UpdateSshPublicKey(UpdateSshPublicKeyRequest) returns (google.cloud.oslogin.common.SshPublicKey) {
     option (google.api.http) = {
       patch: "/v1beta/{name=users/*/sshPublicKeys/*}"
       body: "ssh_public_key"
     };
+    option (google.api.method_signature) = "name,ssh_public_key";
+    option (google.api.method_signature) = "name,ssh_public_key,update_mask";
   }
 }
 
 // The user profile information used for logging in to a virtual machine on
 // Google Compute Engine.
 message LoginProfile {
-  // The primary email address that uniquely identifies the user.
-  string name = 1;
+  // Required. A unique user ID.
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The list of POSIX accounts associated with the user.
   repeated google.cloud.oslogin.common.PosixAccount posix_accounts = 2;
 
   // A map from SSH public key fingerprint to the associated key object.
   map ssh_public_keys = 3;
-
-  // Indicates if the user is suspended. A suspended user cannot log in but
-  // their profile information is retained.
-  bool suspended = 4;
 }
 
 // A request message for deleting a POSIX account entry.
 message DeletePosixAccountRequest {
-  // A reference to the POSIX account to update. POSIX accounts are identified
+  // Required. A reference to the POSIX account to update. POSIX accounts are identified
   // by the project ID they are associated with. A reference to the POSIX
   // account is in format `users/{user}/projects/{project}`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "oslogin.googleapis.com/PosixAccount"
+    }
+  ];
 }
 
 // A request message for deleting an SSH public key.
 message DeleteSshPublicKeyRequest {
-  // The fingerprint of the public key to update. Public keys are identified by
+  // Required. The fingerprint of the public key to update. Public keys are identified by
   // their SHA-256 fingerprint. The fingerprint of the public key is in format
   // `users/{user}/sshPublicKeys/{fingerprint}`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "oslogin.googleapis.com/SshPublicKey"
+    }
+  ];
 }
 
 // A request message for retrieving the login profile information for a user.
 message GetLoginProfileRequest {
-  // The unique ID for the user in format `users/{user}`.
-  string name = 1;
+  // Required. The unique ID for the user in format `users/{user}`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference).type = "oslogin.googleapis.com/User"];
+
+  // The project ID of the Google Cloud Platform project.
+  string project_id = 2;
+
+  // A system ID for filtering the results of the request.
+  string system_id = 3;
 }
 
 // A request message for retrieving an SSH public key.
 message GetSshPublicKeyRequest {
-  // The fingerprint of the public key to retrieve. Public keys are identified
+  // Required. The fingerprint of the public key to retrieve. Public keys are identified
   // by their SHA-256 fingerprint. The fingerprint of the public key is in
   // format `users/{user}/sshPublicKeys/{fingerprint}`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "oslogin.googleapis.com/SshPublicKey"
+    }
+  ];
 }
 
 // A request message for importing an SSH public key.
 message ImportSshPublicKeyRequest {
   // The unique ID for the user in format `users/{user}`.
-  string parent = 1;
+  string parent = 1 [(google.api.resource_reference) = {
+                       child_type: "oslogin.googleapis.com/SshPublicKey"
+                     }];
 
-  // The SSH public key and expiration time.
-  google.cloud.oslogin.common.SshPublicKey ssh_public_key = 2;
+  // Required. The SSH public key and expiration time.
+  google.cloud.oslogin.common.SshPublicKey ssh_public_key = 2 [(google.api.field_behavior) = REQUIRED];
 
   // The project ID of the Google Cloud Platform project.
   string project_id = 3;
@@ -154,13 +190,18 @@ message ImportSshPublicKeyResponse {
 
 // A request message for updating an SSH public key.
 message UpdateSshPublicKeyRequest {
-  // The fingerprint of the public key to update. Public keys are identified by
+  // Required. The fingerprint of the public key to update. Public keys are identified by
   // their SHA-256 fingerprint. The fingerprint of the public key is in format
   // `users/{user}/sshPublicKeys/{fingerprint}`.
-  string name = 1;
-
-  // The SSH public key and expiration time.
-  google.cloud.oslogin.common.SshPublicKey ssh_public_key = 2;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "oslogin.googleapis.com/SshPublicKey"
+    }
+  ];
+
+  // Required. The SSH public key and expiration time.
+  google.cloud.oslogin.common.SshPublicKey ssh_public_key = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Mask to control which fields get updated. Updates all if not present.
   google.protobuf.FieldMask update_mask = 3;
diff --git a/third_party/googleapis/google/cloud/oslogin/v1beta/oslogin_grpc_service_config.json b/third_party/googleapis/google/cloud/oslogin/v1beta/oslogin_grpc_service_config.json
new file mode 100644
index 000000000..6ef06eb9f
--- /dev/null
+++ b/third_party/googleapis/google/cloud/oslogin/v1beta/oslogin_grpc_service_config.json
@@ -0,0 +1,42 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.oslogin.v1beta.OsLoginService",
+          "method": "DeletePosixAccount"
+        },
+        {
+          "service": "google.cloud.oslogin.v1beta.OsLoginService",
+          "method": "DeleteSshPublicKey"
+        },
+        {
+          "service": "google.cloud.oslogin.v1beta.OsLoginService",
+          "method": "GetLoginProfile"
+        },
+        {
+          "service": "google.cloud.oslogin.v1beta.OsLoginService",
+          "method": "GetSshPublicKey"
+        },
+        {
+          "service": "google.cloud.oslogin.v1beta.OsLoginService",
+          "method": "ImportSshPublicKey"
+        },
+        {
+          "service": "google.cloud.oslogin.v1beta.OsLoginService",
+          "method": "UpdateSshPublicKey"
+        }
+      ],
+      "timeout": "10s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/oslogin/v1beta/oslogin_v1beta.yaml b/third_party/googleapis/google/cloud/oslogin/v1beta/oslogin_v1beta.yaml
new file mode 100644
index 000000000..eea7d547a
--- /dev/null
+++ b/third_party/googleapis/google/cloud/oslogin/v1beta/oslogin_v1beta.yaml
@@ -0,0 +1,23 @@
+type: google.api.Service
+config_version: 3
+name: oslogin.googleapis.com
+title: Cloud OS Login API
+
+apis:
+- name: google.cloud.oslogin.v1beta.OsLoginService
+
+documentation:
+  summary: You can use OS Login to manage access to your VM instances using IAM roles.
+
+backend:
+  rules:
+  - selector: 'google.cloud.oslogin.v1beta.OsLoginService.*'
+    deadline: 10.0
+
+authentication:
+  rules:
+  - selector: 'google.cloud.oslogin.v1beta.OsLoginService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/compute
diff --git a/third_party/googleapis/google/cloud/phishingprotection/artman_phishingprotection_v1beta1.yaml b/third_party/googleapis/google/cloud/phishingprotection/artman_phishingprotection_v1beta1.yaml
index 547e0fa99..b2727a765 100644
--- a/third_party/googleapis/google/cloud/phishingprotection/artman_phishingprotection_v1beta1.yaml
+++ b/third_party/googleapis/google/cloud/phishingprotection/artman_phishingprotection_v1beta1.yaml
@@ -6,8 +6,9 @@ common:
   - name: google-common-protos
   src_proto_paths:
   - v1beta1
-  service_yaml: phishingprotection.yaml
+  service_yaml: v1beta1/phishingprotection_v1beta1.yaml
   gapic_yaml: v1beta1/phishingprotection_gapic.yaml
+  proto_package: google.cloud.phishingprotection.v1beta1
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/cloud/phishingprotection/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/phishingprotection/v1beta1/BUILD.bazel
new file mode 100644
index 000000000..8daf4df24
--- /dev/null
+++ b/third_party/googleapis/google/cloud/phishingprotection/v1beta1/BUILD.bazel
@@ -0,0 +1,356 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "phishingprotection_proto",
+    srcs = [
+        "phishingprotection.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "phishingprotection_proto_with_info",
+    deps = [
+        ":phishingprotection_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "phishingprotection_java_proto",
+    deps = [":phishingprotection_proto"],
+)
+
+java_grpc_library(
+    name = "phishingprotection_java_grpc",
+    srcs = [":phishingprotection_proto"],
+    deps = [":phishingprotection_java_proto"],
+)
+
+java_gapic_library(
+    name = "phishingprotection_java_gapic",
+    src = ":phishingprotection_proto_with_info",
+    gapic_yaml = "phishingprotection_gapic.yaml",
+    package = "google.cloud.phishingprotection.v1beta1",
+    service_yaml = "phishingprotection_v1beta1.yaml",
+    test_deps = [
+        ":phishingprotection_java_grpc",
+    ],
+    deps = [
+        ":phishingprotection_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "phishingprotection_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.phishingprotection.v1beta1.PhishingProtectionServiceV1Beta1ClientTest",
+    ],
+    runtime_deps = [":phishingprotection_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-phishingprotection-v1beta1-java",
+    deps = [
+        ":phishingprotection_java_gapic",
+        ":phishingprotection_java_grpc",
+        ":phishingprotection_java_proto",
+        ":phishingprotection_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "phishingprotection_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/phishingprotection/v1beta1",
+    protos = [":phishingprotection_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "phishingprotection_go_gapic",
+    srcs = [":phishingprotection_proto_with_info"],
+    grpc_service_config = "phishingprotection_grpc_service_config.json",
+    importpath = "cloud.google.com/go/phishingprotection/apiv1beta1;phishingprotection",
+    service_yaml = "phishingprotection_v1beta1.yaml",
+    deps = [
+        ":phishingprotection_go_proto",
+    ],
+)
+
+go_test(
+    name = "phishingprotection_go_gapic_test",
+    srcs = [":phishingprotection_go_gapic_srcjar_test"],
+    embed = [":phishingprotection_go_gapic"],
+    importpath = "cloud.google.com/go/phishingprotection/apiv1beta1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-phishingprotection-v1beta1-go",
+    deps = [
+        ":phishingprotection_go_gapic",
+        ":phishingprotection_go_gapic_srcjar-test.srcjar",
+        ":phishingprotection_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "phishingprotection_moved_proto",
+    srcs = [":phishingprotection_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+    ],
+)
+
+py_proto_library(
+    name = "phishingprotection_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":phishingprotection_moved_proto"],
+)
+
+py_grpc_library(
+    name = "phishingprotection_py_grpc",
+    srcs = [":phishingprotection_moved_proto"],
+    deps = [":phishingprotection_py_proto"],
+)
+
+py_gapic_library(
+    name = "phishingprotection_py_gapic",
+    src = ":phishingprotection_proto_with_info",
+    gapic_yaml = "phishingprotection_gapic.yaml",
+    package = "google.cloud.phishingprotection.v1beta1",
+    service_yaml = "phishingprotection_v1beta1.yaml",
+    deps = [
+        ":phishingprotection_py_grpc",
+        ":phishingprotection_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "phishingprotection-v1beta1-py",
+    deps = [
+        ":phishingprotection_py_gapic",
+        ":phishingprotection_py_grpc",
+        ":phishingprotection_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "phishingprotection_php_proto",
+    deps = [":phishingprotection_proto"],
+)
+
+php_grpc_library(
+    name = "phishingprotection_php_grpc",
+    srcs = [":phishingprotection_proto"],
+    deps = [":phishingprotection_php_proto"],
+)
+
+php_gapic_library(
+    name = "phishingprotection_php_gapic",
+    src = ":phishingprotection_proto_with_info",
+    gapic_yaml = "phishingprotection_gapic.yaml",
+    package = "google.cloud.phishingprotection.v1beta1",
+    service_yaml = "phishingprotection_v1beta1.yaml",
+    deps = [
+        ":phishingprotection_php_grpc",
+        ":phishingprotection_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-phishingprotection-v1beta1-php",
+    deps = [
+        ":phishingprotection_php_gapic",
+        ":phishingprotection_php_grpc",
+        ":phishingprotection_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "phishingprotection_nodejs_gapic",
+    src = ":phishingprotection_proto_with_info",
+    gapic_yaml = "phishingprotection_gapic.yaml",
+    package = "google.cloud.phishingprotection.v1beta1",
+    service_yaml = "phishingprotection_v1beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "phishingprotection-v1beta1-nodejs",
+    deps = [
+        ":phishingprotection_nodejs_gapic",
+        ":phishingprotection_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "phishingprotection_ruby_proto",
+    deps = [":phishingprotection_proto"],
+)
+
+ruby_grpc_library(
+    name = "phishingprotection_ruby_grpc",
+    srcs = [":phishingprotection_proto"],
+    deps = [":phishingprotection_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "phishingprotection_ruby_gapic",
+    src = ":phishingprotection_proto_with_info",
+    gapic_yaml = "phishingprotection_gapic.yaml",
+    package = "google.cloud.phishingprotection.v1beta1",
+    service_yaml = "phishingprotection_v1beta1.yaml",
+    deps = [
+        ":phishingprotection_ruby_grpc",
+        ":phishingprotection_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-phishingprotection-v1beta1-ruby",
+    deps = [
+        ":phishingprotection_ruby_gapic",
+        ":phishingprotection_ruby_grpc",
+        ":phishingprotection_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "phishingprotection_csharp_proto",
+    deps = [":phishingprotection_proto"],
+)
+
+csharp_grpc_library(
+    name = "phishingprotection_csharp_grpc",
+    srcs = [":phishingprotection_proto"],
+    deps = [":phishingprotection_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "phishingprotection_csharp_gapic",
+    src = ":phishingprotection_proto_with_info",
+    gapic_yaml = "phishingprotection_gapic.yaml",
+    package = "google.cloud.phishingprotection.v1beta1",
+    service_yaml = "phishingprotection_v1beta1.yaml",
+    deps = [
+        ":phishingprotection_csharp_grpc",
+        ":phishingprotection_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-phishingprotection-v1beta1-csharp",
+    deps = [
+        ":phishingprotection_csharp_gapic",
+        ":phishingprotection_csharp_grpc",
+        ":phishingprotection_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/phishingprotection/v1beta1/phishingprotection.proto b/third_party/googleapis/google/cloud/phishingprotection/v1beta1/phishingprotection.proto
index 62a9fd03e..01a89ec2b 100644
--- a/third_party/googleapis/google/cloud/phishingprotection/v1beta1/phishingprotection.proto
+++ b/third_party/googleapis/google/cloud/phishingprotection/v1beta1/phishingprotection.proto
@@ -18,6 +18,9 @@ syntax = "proto3";
 package google.cloud.phishingprotection.v1beta1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 
 option csharp_namespace = "Google.Cloud.PhishingProtection.V1Beta1";
 option go_package = "google.golang.org/genproto/googleapis/cloud/phishingprotection/v1beta1;phishingprotection";
@@ -26,20 +29,26 @@ option java_outer_classname = "PhishingProtectionProto";
 option java_package = "com.google.phishingprotection.v1beta1";
 option objc_class_prefix = "GCPP";
 option php_namespace = "Google\\Cloud\\PhishingProtection\\V1beta1";
+option ruby_package = "Google::Cloud::PhishingProtection::V1beta1";
 
 // Service to report phishing URIs.
 service PhishingProtectionServiceV1Beta1 {
+  option (google.api.default_host) = "phishingprotection.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Reports a URI suspected of containing phishing content to be reviewed. Once
-  // the report review is completed, if its result verifies the existince of
-  // malicious phishing content, the site will be added the to [Google's Social
-  // Engineering lists](https://support.google.com/webmasters/answer/6350487/)
-  // in order to protect users that could get exposed to this threat in
-  // the future.
+  // the report review is complete, its result can be found in the Cloud
+  // Security Command Center findings dashboard for Phishing Protection. If the
+  // result verifies the existence of malicious phishing content, the site will
+  // be added the to [Google's Social Engineering
+  // lists](https://support.google.com/webmasters/answer/6350487/) in order to
+  // protect users that could get exposed to this threat in the future.
   rpc ReportPhishing(ReportPhishingRequest) returns (ReportPhishingResponse) {
     option (google.api.http) = {
       post: "/v1beta1/{parent=projects/*}/phishing:report"
       body: "*"
     };
+    option (google.api.method_signature) = "parent,uri";
   }
 }
 
@@ -47,11 +56,18 @@ service PhishingProtectionServiceV1Beta1 {
 message ReportPhishingRequest {
   // Required. The name of the project for which the report will be created,
   // in the format "projects/{project_number}".
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
-  // The URI that is being reported for phishing content to be analyzed.
-  string uri = 2;
+  // Required. The URI that is being reported for phishing content to be analyzed.
+  string uri = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The ReportPhishing (empty) response message.
-message ReportPhishingResponse {}
+message ReportPhishingResponse {
+
+}
diff --git a/third_party/googleapis/google/cloud/phishingprotection/v1beta1/phishingprotection_gapic.legacy.yaml b/third_party/googleapis/google/cloud/phishingprotection/v1beta1/phishingprotection_gapic.legacy.yaml
new file mode 100644
index 000000000..02d430412
--- /dev/null
+++ b/third_party/googleapis/google/cloud/phishingprotection/v1beta1/phishingprotection_gapic.legacy.yaml
@@ -0,0 +1,135 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.phishingprotection.v1beta1
+  python:
+    package_name: google.cloud.phishingprotection_v1beta1.gapic
+  go:
+    package_name: cloud.google.com/go/phishingprotection/apiv1beta1
+  csharp:
+    package_name: Google.Cloud.PhishingProtection.V1Beta1
+  ruby:
+    package_name: Google::Cloud::PhishingProtection::V1beta1
+  php:
+    package_name: Google\Cloud\PhishingProtection\V1beta1
+  nodejs:
+    package_name: phishingprotection.v1beta1
+# The configuration for the license header to put on generated files.
+license_header:
+  # The file containing the copyright line(s).
+  copyright_file: copyright-google.txt
+  # The file containing the raw license header without any copyright line(s).
+  license_file: license-header-apache-2.0.txt
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: google.cloud.phishingprotection.v1beta1.PhishingProtectionServiceV1Beta1
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}
+    entity_name: project
+    language_overrides:
+    - language: csharp
+      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ReportPhishing
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - uri
+    required_fields:
+    - parent
+    - uri
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 60000
+resource_name_generation:
+- message_name: ReportPhishingRequest
+  field_entity_map:
+    parent: project
diff --git a/third_party/googleapis/google/cloud/phishingprotection/v1beta1/phishingprotection_gapic.yaml b/third_party/googleapis/google/cloud/phishingprotection/v1beta1/phishingprotection_gapic.yaml
index 02d430412..a029ac350 100644
--- a/third_party/googleapis/google/cloud/phishingprotection/v1beta1/phishingprotection_gapic.yaml
+++ b/third_party/googleapis/google/cloud/phishingprotection/v1beta1/phishingprotection_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -16,120 +16,7 @@ language_settings:
     package_name: Google\Cloud\PhishingProtection\V1beta1
   nodejs:
     package_name: phishingprotection.v1beta1
-# The configuration for the license header to put on generated files.
-license_header:
-  # The file containing the copyright line(s).
-  copyright_file: copyright-google.txt
-  # The file containing the raw license header without any copyright line(s).
-  license_file: license-header-apache-2.0.txt
 # A list of API interface configurations.
 interfaces:
 # The fully qualified name of the API interface.
 - name: google.cloud.phishingprotection.v1beta1.PhishingProtectionServiceV1Beta1
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections:
-  - name_pattern: projects/{project}
-    entity_name: project
-    language_overrides:
-    - language: csharp
-      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
-  methods:
-  - name: ReportPhishing
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - uri
-    required_fields:
-    - parent
-    - uri
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: project
-    timeout_millis: 60000
-resource_name_generation:
-- message_name: ReportPhishingRequest
-  field_entity_map:
-    parent: project
diff --git a/third_party/googleapis/google/cloud/phishingprotection/v1beta1/phishingprotection_grpc_service_config.json b/third_party/googleapis/google/cloud/phishingprotection/v1beta1/phishingprotection_grpc_service_config.json
new file mode 100755
index 000000000..cd1c5d40f
--- /dev/null
+++ b/third_party/googleapis/google/cloud/phishingprotection/v1beta1/phishingprotection_grpc_service_config.json
@@ -0,0 +1,13 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.phishingprotection.v1beta1.PhishingProtectionServiceV1Beta1",
+          "method": "ReportPhishing"
+        }
+      ],
+      "timeout": "600s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/phishingprotection/phishingprotection.yaml b/third_party/googleapis/google/cloud/phishingprotection/v1beta1/phishingprotection_v1beta1.yaml
similarity index 75%
rename from third_party/googleapis/google/cloud/phishingprotection/phishingprotection.yaml
rename to third_party/googleapis/google/cloud/phishingprotection/v1beta1/phishingprotection_v1beta1.yaml
index 7adec2ebb..6f56340ca 100644
--- a/third_party/googleapis/google/cloud/phishingprotection/phishingprotection.yaml
+++ b/third_party/googleapis/google/cloud/phishingprotection/v1beta1/phishingprotection_v1beta1.yaml
@@ -8,7 +8,7 @@ apis:
 
 authentication:
   rules:
-  - selector: '*'
+  - selector: google.cloud.phishingprotection.v1beta1.PhishingProtectionServiceV1Beta1.ReportPhishing
     oauth:
       canonical_scopes: |-
         https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/policytroubleshooter/v1/checker.proto b/third_party/googleapis/google/cloud/policytroubleshooter/v1/checker.proto
new file mode 100644
index 000000000..6fae32d15
--- /dev/null
+++ b/third_party/googleapis/google/cloud/policytroubleshooter/v1/checker.proto
@@ -0,0 +1,71 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.policytroubleshooter.v1;
+
+import public "google/cloud/policytroubleshooter/v1/explanations.proto";
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/policytroubleshooter/v1;policytroubleshooter";
+option java_multiple_files = true;
+option java_outer_classname = "IAMCheckerProto";
+option java_package = "com.google.cloud.policytroubleshooter.v1";
+
+// IAM Policy Troubleshooter service.
+//
+// This service helps you troubleshoot access issues for Google Cloud resources.
+service IamChecker {
+  option (google.api.default_host) = "policytroubleshooter.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // Checks whether a member has a specific permission for a specific resource,
+  // and explains why the member does or does not have that permission.
+  rpc TroubleshootIamPolicy(TroubleshootIamPolicyRequest) returns (TroubleshootIamPolicyResponse) {
+    option (google.api.http) = {
+      post: "/v1/iam:troubleshoot"
+      body: "*"
+    };
+  }
+}
+
+// Request for [TroubleshootIamPolicy][google.cloud.policytroubleshooter.v1.IamChecker.TroubleshootIamPolicy].
+message TroubleshootIamPolicyRequest {
+  // The information to use for checking whether a member has a permission for a
+  // resource.
+  AccessTuple access_tuple = 1;
+}
+
+// Response for [TroubleshootIamPolicy][google.cloud.policytroubleshooter.v1.IamChecker.TroubleshootIamPolicy].
+message TroubleshootIamPolicyResponse {
+  // Indicates whether the member has the specified permission for the specified
+  // resource, based on evaluating all of the applicable IAM policies.
+  AccessState access = 1;
+
+  // List of IAM policies that were evaluated to check the member's permissions,
+  // with annotations to indicate how each policy contributed to the final
+  // result.
+  //
+  // The list of policies can include the policy for the resource itself. It can
+  // also include policies that are inherited from higher levels of the resource
+  // hierarchy, including the organization, the folder, and the project.
+  //
+  // To learn more about the resource hierarchy, see
+  // https://cloud.google.com/iam/help/resource-hierarchy.
+  repeated ExplainedPolicy explained_policies = 2;
+}
diff --git a/third_party/googleapis/google/cloud/policytroubleshooter/v1/checker_grpc_service_config.json b/third_party/googleapis/google/cloud/policytroubleshooter/v1/checker_grpc_service_config.json
new file mode 100644
index 000000000..10d589ba5
--- /dev/null
+++ b/third_party/googleapis/google/cloud/policytroubleshooter/v1/checker_grpc_service_config.json
@@ -0,0 +1,19 @@
+{
+  "methodConfig": [{
+    "name": [{ "service": "google.cloud.policytroubleshooter.v1.IamChecker" }],
+    "timeout": "60s",
+    "retryPolicy": {
+      "maxAttempts": 5,
+      "initialBackoff": "1s",
+      "maxBackoff": "60s",
+      "backoffMultiplier": 1.3,
+      "retryableStatusCodes": ["UNAVAILABLE", "UNKNOWN"]
+    }
+  },
+  {
+    "name": [
+      { "service": "google.cloud.policytroubleshooter.v1.IamChecker", "method": "TroubleshootIamPolicy" }
+    ],
+    "timeout": "60s"
+  }]
+}
diff --git a/third_party/googleapis/google/cloud/policytroubleshooter/v1/explanations.proto b/third_party/googleapis/google/cloud/policytroubleshooter/v1/explanations.proto
new file mode 100644
index 000000000..7fe736897
--- /dev/null
+++ b/third_party/googleapis/google/cloud/policytroubleshooter/v1/explanations.proto
@@ -0,0 +1,242 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.policytroubleshooter.v1;
+
+import "google/api/field_behavior.proto";
+import "google/iam/v1/policy.proto";
+import "google/type/expr.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/policytroubleshooter/v1;policytroubleshooter";
+
+// Information about the member, resource, and permission to check.
+message AccessTuple {
+  // Required. The member, or principal, whose access you want to check, in the form of
+  // the email address that represents that member. For example,
+  // `alice@example.com` or
+  // `my-service-account@my-project.iam.gserviceaccount.com`.
+  //
+  // The member must be a Google Account or a service account. Other types of
+  // members are not supported.
+  string principal = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The full resource name that identifies the resource. For example,
+  // `//compute.googleapis.com/projects/my-project/zones/us-central1-a/instances/my-instance`.
+  //
+  // For examples of full resource names for Google Cloud services, see
+  // https://cloud.google.com/iam/help/troubleshooter/full-resource-names.
+  string full_resource_name = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The IAM permission to check for the specified member and resource.
+  //
+  // For a complete list of IAM permissions, see
+  // https://cloud.google.com/iam/help/permissions/reference.
+  //
+  // For a complete list of predefined IAM roles and the permissions in each
+  // role, see https://cloud.google.com/iam/help/roles/reference.
+  string permission = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Details about how a specific IAM [Policy][google.iam.v1.Policy] contributed
+// to the access check.
+message ExplainedPolicy {
+  // Indicates whether _this policy_ provides the specified permission to the
+  // specified member for the specified resource.
+  //
+  // This field does _not_ indicate whether the member actually has the
+  // permission for the resource. There might be another policy that overrides
+  // this policy. To determine whether the member actually has the permission,
+  // use the `access` field in the
+  // [TroubleshootIamPolicyResponse][IamChecker.TroubleshootIamPolicyResponse].
+  AccessState access = 1;
+
+  // The full resource name that identifies the resource. For example,
+  // `//compute.googleapis.com/projects/my-project/zones/us-central1-a/instances/my-instance`.
+  //
+  // If the sender of the request does not have access to the policy, this field
+  // is omitted.
+  //
+  // For examples of full resource names for Google Cloud services, see
+  // https://cloud.google.com/iam/help/troubleshooter/full-resource-names.
+  string full_resource_name = 2;
+
+  // The IAM policy attached to the resource.
+  //
+  // If the sender of the request does not have access to the policy, this field
+  // is empty.
+  google.iam.v1.Policy policy = 3;
+
+  // Details about how each binding in the policy affects the member's ability,
+  // or inability, to use the permission for the resource.
+  //
+  // If the sender of the request does not have access to the policy, this field
+  // is omitted.
+  repeated BindingExplanation binding_explanations = 4;
+
+  // The relevance of this policy to the overall determination in the
+  // [TroubleshootIamPolicyResponse][IamChecker.TroubleshootIamPolicyResponse].
+  //
+  // If the sender of the request does not have access to the policy, this field
+  // is omitted.
+  HeuristicRelevance relevance = 5;
+}
+
+// Details about how a binding in a policy affects a member's ability to use a
+// permission.
+message BindingExplanation {
+  // Details about whether the binding includes the member.
+  message AnnotatedMembership {
+    // Indicates whether the binding includes the member.
+    Membership membership = 1;
+
+    // The relevance of the member's status to the overall determination for the
+    // binding.
+    HeuristicRelevance relevance = 2;
+  }
+
+  // Whether a role includes a specific permission.
+  enum RolePermission {
+    // Reserved for future use.
+    ROLE_PERMISSION_UNSPECIFIED = 0;
+
+    // The permission is included in the role.
+    ROLE_PERMISSION_INCLUDED = 1;
+
+    // The permission is not included in the role.
+    ROLE_PERMISSION_NOT_INCLUDED = 2;
+
+    // The sender of the request is not allowed to access the binding.
+    ROLE_PERMISSION_UNKNOWN_INFO_DENIED = 3;
+  }
+
+  // Whether the binding includes the member.
+  enum Membership {
+    // Reserved for future use.
+    MEMBERSHIP_UNSPECIFIED = 0;
+
+    // The binding includes the member. The member can be included directly
+    // or indirectly. For example:
+    //
+    // * A member is included directly if that member is listed in the binding.
+    // * A member is included indirectly if that member is in a Google group or
+    //   G Suite domain that is listed in the binding.
+    MEMBERSHIP_INCLUDED = 1;
+
+    // The binding does not include the member.
+    MEMBERSHIP_NOT_INCLUDED = 2;
+
+    // The sender of the request is not allowed to access the binding.
+    MEMBERSHIP_UNKNOWN_INFO_DENIED = 3;
+
+    // The member is an unsupported type. Only Google Accounts and service
+    // accounts are supported.
+    MEMBERSHIP_UNKNOWN_UNSUPPORTED = 4;
+  }
+
+  // Required. Indicates whether _this binding_ provides the specified permission to the
+  // specified member for the specified resource.
+  //
+  // This field does _not_ indicate whether the member actually has the
+  // permission for the resource. There might be another binding that overrides
+  // this binding. To determine whether the member actually has the permission,
+  // use the `access` field in the
+  // [TroubleshootIamPolicyResponse][IamChecker.TroubleshootIamPolicyResponse].
+  AccessState access = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // The role that this binding grants. For example,
+  // `roles/compute.serviceAgent`.
+  //
+  // For a complete list of predefined IAM roles, as well as the permissions in
+  // each role, see https://cloud.google.com/iam/help/roles/reference.
+  string role = 2;
+
+  // Indicates whether the role granted by this binding contains the specified
+  // permission.
+  RolePermission role_permission = 3;
+
+  // The relevance of the permission's existence, or nonexistence, in the role
+  // to the overall determination for the entire policy.
+  HeuristicRelevance role_permission_relevance = 4;
+
+  // Indicates whether each member in the binding includes the member specified
+  // in the request, either directly or indirectly. Each key identifies a member
+  // in the binding, and each value indicates whether the member in the binding
+  // includes the member in the request.
+  //
+  // For example, suppose that a binding includes the following members:
+  //
+  // * `user:alice@example.com`
+  // * `group:product-eng@example.com`
+  //
+  // You want to troubleshoot access for `user:bob@example.com`. This user is a
+  // member of the group `group:product-eng@example.com`.
+  //
+  // For the first member in the binding, the key is `user:alice@example.com`,
+  // and the `membership` field in the value is set to
+  // `MEMBERSHIP_NOT_INCLUDED`.
+  //
+  // For the second member in the binding, the key is
+  // `group:product-eng@example.com`, and the `membership` field in the value is
+  // set to `MEMBERSHIP_INCLUDED`.
+  map memberships = 5;
+
+  // The relevance of this binding to the overall determination for the entire
+  // policy.
+  HeuristicRelevance relevance = 6;
+
+  // A condition expression that prevents access unless the expression evaluates
+  // to `true`.
+  //
+  // To learn about IAM Conditions, see
+  // http://cloud.google.com/iam/help/conditions/overview.
+  google.type.Expr condition = 7;
+}
+
+// Whether a member has a permission for a resource.
+enum AccessState {
+  // Reserved for future use.
+  ACCESS_STATE_UNSPECIFIED = 0;
+
+  // The member has the permission.
+  GRANTED = 1;
+
+  // The member does not have the permission.
+  NOT_GRANTED = 2;
+
+  // The member has the permission only if a condition expression evaluates to
+  // `true`.
+  UNKNOWN_CONDITIONAL = 3;
+
+  // The sender of the request does not have access to all of the policies that
+  // Policy Troubleshooter needs to evaluate.
+  UNKNOWN_INFO_DENIED = 4;
+}
+
+// The extent to which a single data point contributes to an overall
+// determination.
+enum HeuristicRelevance {
+  // Reserved for future use.
+  HEURISTIC_RELEVANCE_UNSPECIFIED = 0;
+
+  // The data point has a limited effect on the result. Changing the data point
+  // is unlikely to affect the overall determination.
+  NORMAL = 1;
+
+  // The data point has a strong effect on the result. Changing the data point
+  // is likely to affect the overall determination.
+  HIGH = 2;
+}
diff --git a/third_party/googleapis/google/cloud/policytroubleshooter/v1/policytroubleshooter_v1.yaml b/third_party/googleapis/google/cloud/policytroubleshooter/v1/policytroubleshooter_v1.yaml
new file mode 100644
index 000000000..ea5bbb479
--- /dev/null
+++ b/third_party/googleapis/google/cloud/policytroubleshooter/v1/policytroubleshooter_v1.yaml
@@ -0,0 +1,19 @@
+type: google.api.Service
+config_version: 3
+name: policytroubleshooter.googleapis.com
+title: Policy Troubleshooter API
+
+apis:
+- name: google.cloud.policytroubleshooter.v1.IamChecker
+
+backend:
+  rules:
+  - selector: google.cloud.policytroubleshooter.v1.IamChecker.TroubleshootIamPolicy
+    deadline: 20.0
+
+authentication:
+  rules:
+  - selector: google.cloud.policytroubleshooter.v1.IamChecker.TroubleshootIamPolicy
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/recaptchaenterprise/BUILD.bazel b/third_party/googleapis/google/cloud/recaptchaenterprise/BUILD.bazel
new file mode 100644
index 000000000..a87c57fec
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recaptchaenterprise/BUILD.bazel
@@ -0,0 +1 @@
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/cloud/recaptchaenterprise/artman_recaptchaenterprise_v1beta1.yaml b/third_party/googleapis/google/cloud/recaptchaenterprise/artman_recaptchaenterprise_v1beta1.yaml
index 9303e71b4..03b0ba9ac 100644
--- a/third_party/googleapis/google/cloud/recaptchaenterprise/artman_recaptchaenterprise_v1beta1.yaml
+++ b/third_party/googleapis/google/cloud/recaptchaenterprise/artman_recaptchaenterprise_v1beta1.yaml
@@ -6,8 +6,9 @@ common:
   - name: google-common-protos
   src_proto_paths:
   - v1beta1
-  service_yaml: recaptchaenterprise_v1beta1.yaml
+  service_yaml: v1beta1/recaptchaenterprise_v1beta1.yaml
   gapic_yaml: v1beta1/recaptchaenterprise_gapic.yaml
+  proto_package: google.cloud.recaptchaenterprise.v1beta1
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/cloud/recaptchaenterprise/v1/BUILD.bazel b/third_party/googleapis/google/cloud/recaptchaenterprise/v1/BUILD.bazel
new file mode 100644
index 000000000..965399a66
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recaptchaenterprise/v1/BUILD.bazel
@@ -0,0 +1,362 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "recaptchaenterprise_proto",
+    srcs = [
+        "recaptchaenterprise.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "recaptchaenterprise_proto_with_info",
+    deps = [
+        ":recaptchaenterprise_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "recaptchaenterprise_java_proto",
+    deps = [":recaptchaenterprise_proto"],
+)
+
+java_grpc_library(
+    name = "recaptchaenterprise_java_grpc",
+    srcs = [":recaptchaenterprise_proto"],
+    deps = [":recaptchaenterprise_java_proto"],
+)
+
+java_gapic_library(
+    name = "recaptchaenterprise_java_gapic",
+    src = ":recaptchaenterprise_proto_with_info",
+    gapic_yaml = "recaptchaenterprise_gapic.yaml",
+    package = "google.cloud.recaptchaenterprise.v1",
+    service_yaml = "recaptchaenterprise_v1.yaml",
+    test_deps = [
+        ":recaptchaenterprise_java_grpc",
+    ],
+    deps = [
+        ":recaptchaenterprise_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "recaptchaenterprise_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.recaptchaenterprise.v1.RecaptchaEnterpriseServiceClientTest",
+    ],
+    runtime_deps = [":recaptchaenterprise_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-recaptchaenterprise-v1-java",
+    deps = [
+        ":recaptchaenterprise_java_gapic",
+        ":recaptchaenterprise_java_grpc",
+        ":recaptchaenterprise_java_proto",
+        ":recaptchaenterprise_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "recaptchaenterprise_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/recaptchaenterprise/v1",
+    protos = [":recaptchaenterprise_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "recaptchaenterprise_go_gapic",
+    srcs = [":recaptchaenterprise_proto_with_info"],
+    grpc_service_config = "recaptchaenterprise_grpc_service_config.json",
+    importpath = "cloud.google.com/go/recaptchaenterprise/apiv1;recaptchaenterprise",
+    service_yaml = "recaptchaenterprise_v1.yaml",
+    deps = [
+        ":recaptchaenterprise_go_proto",
+    ],
+)
+
+go_test(
+    name = "recaptchaenterprise_go_gapic_test",
+    srcs = [":recaptchaenterprise_go_gapic_srcjar_test"],
+    embed = [":recaptchaenterprise_go_gapic"],
+    importpath = "cloud.google.com/go/recaptchaenterprise/apiv1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-recaptchaenterprise-v1-go",
+    deps = [
+        ":recaptchaenterprise_go_gapic",
+        ":recaptchaenterprise_go_gapic_srcjar-test.srcjar",
+        ":recaptchaenterprise_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "recaptchaenterprise_moved_proto",
+    srcs = [":recaptchaenterprise_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "recaptchaenterprise_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":recaptchaenterprise_moved_proto"],
+)
+
+py_grpc_library(
+    name = "recaptchaenterprise_py_grpc",
+    srcs = [":recaptchaenterprise_moved_proto"],
+    deps = [":recaptchaenterprise_py_proto"],
+)
+
+py_gapic_library(
+    name = "recaptchaenterprise_py_gapic",
+    src = ":recaptchaenterprise_proto_with_info",
+    gapic_yaml = "recaptchaenterprise_gapic.yaml",
+    package = "google.cloud.recaptchaenterprise.v1",
+    service_yaml = "recaptchaenterprise_v1.yaml",
+    deps = [
+        ":recaptchaenterprise_py_grpc",
+        ":recaptchaenterprise_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "recaptchaenterprise-v1-py",
+    deps = [
+        ":recaptchaenterprise_py_gapic",
+        ":recaptchaenterprise_py_grpc",
+        ":recaptchaenterprise_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "recaptchaenterprise_php_proto",
+    deps = [":recaptchaenterprise_proto"],
+)
+
+php_grpc_library(
+    name = "recaptchaenterprise_php_grpc",
+    srcs = [":recaptchaenterprise_proto"],
+    deps = [":recaptchaenterprise_php_proto"],
+)
+
+php_gapic_library(
+    name = "recaptchaenterprise_php_gapic",
+    src = ":recaptchaenterprise_proto_with_info",
+    gapic_yaml = "recaptchaenterprise_gapic.yaml",
+    package = "google.cloud.recaptchaenterprise.v1",
+    service_yaml = "recaptchaenterprise_v1.yaml",
+    deps = [
+        ":recaptchaenterprise_php_grpc",
+        ":recaptchaenterprise_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-recaptchaenterprise-v1-php",
+    deps = [
+        ":recaptchaenterprise_php_gapic",
+        ":recaptchaenterprise_php_grpc",
+        ":recaptchaenterprise_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "recaptchaenterprise_nodejs_gapic",
+    src = ":recaptchaenterprise_proto_with_info",
+    gapic_yaml = "recaptchaenterprise_gapic.yaml",
+    package = "google.cloud.recaptchaenterprise.v1",
+    service_yaml = "recaptchaenterprise_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "recaptchaenterprise-v1-nodejs",
+    deps = [
+        ":recaptchaenterprise_nodejs_gapic",
+        ":recaptchaenterprise_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "recaptchaenterprise_ruby_proto",
+    deps = [":recaptchaenterprise_proto"],
+)
+
+ruby_grpc_library(
+    name = "recaptchaenterprise_ruby_grpc",
+    srcs = [":recaptchaenterprise_proto"],
+    deps = [":recaptchaenterprise_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "recaptchaenterprise_ruby_gapic",
+    src = ":recaptchaenterprise_proto_with_info",
+    gapic_yaml = "recaptchaenterprise_gapic.yaml",
+    package = "google.cloud.recaptchaenterprise.v1",
+    service_yaml = "recaptchaenterprise_v1.yaml",
+    deps = [
+        ":recaptchaenterprise_ruby_grpc",
+        ":recaptchaenterprise_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-recaptchaenterprise-v1-ruby",
+    deps = [
+        ":recaptchaenterprise_ruby_gapic",
+        ":recaptchaenterprise_ruby_grpc",
+        ":recaptchaenterprise_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "recaptchaenterprise_csharp_proto",
+    deps = [":recaptchaenterprise_proto"],
+)
+
+csharp_grpc_library(
+    name = "recaptchaenterprise_csharp_grpc",
+    srcs = [":recaptchaenterprise_proto"],
+    deps = [":recaptchaenterprise_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "recaptchaenterprise_csharp_gapic",
+    src = ":recaptchaenterprise_proto_with_info",
+    gapic_yaml = "recaptchaenterprise_gapic.yaml",
+    package = "google.cloud.recaptchaenterprise.v1",
+    service_yaml = "recaptchaenterprise_v1.yaml",
+    deps = [
+        ":recaptchaenterprise_csharp_grpc",
+        ":recaptchaenterprise_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-recaptchaenterprise-v1-csharp",
+    deps = [
+        ":recaptchaenterprise_csharp_gapic",
+        ":recaptchaenterprise_csharp_grpc",
+        ":recaptchaenterprise_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/recaptchaenterprise/v1/recaptchaenterprise.proto b/third_party/googleapis/google/cloud/recaptchaenterprise/v1/recaptchaenterprise.proto
new file mode 100644
index 000000000..9b60fcef7
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recaptchaenterprise/v1/recaptchaenterprise.proto
@@ -0,0 +1,460 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.recaptchaenterprise.v1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.RecaptchaEnterprise.V1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/recaptchaenterprise/v1;recaptchaenterprise";
+option java_multiple_files = true;
+option java_outer_classname = "RecaptchaEnterpriseProto";
+option java_package = "com.google.recaptchaenterprise.v1";
+option objc_class_prefix = "GCRE";
+option php_namespace = "Google\\Cloud\\RecaptchaEnterprise\\V1";
+option ruby_package = "Google::Cloud::RecaptchaEnterprise::V1";
+
+// Service to determine the likelihood an event is legitimate.
+service RecaptchaEnterpriseService {
+  option (google.api.default_host) = "recaptchaenterprise.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // Creates an Assessment of the likelihood an event is legitimate.
+  rpc CreateAssessment(CreateAssessmentRequest) returns (Assessment) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*}/assessments"
+      body: "assessment"
+    };
+    option (google.api.method_signature) = "parent,assessment";
+  }
+
+  // Annotates a previously created Assessment to provide additional information
+  // on whether the event turned out to be authentic or fradulent.
+  rpc AnnotateAssessment(AnnotateAssessmentRequest) returns (AnnotateAssessmentResponse) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/assessments/*}:annotate"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name,annotation";
+  }
+
+  // Creates a new reCAPTCHA Enterprise key.
+  rpc CreateKey(CreateKeyRequest) returns (Key) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*}/keys"
+      body: "key"
+    };
+  }
+
+  // Returns the list of all keys that belong to a project.
+  rpc ListKeys(ListKeysRequest) returns (ListKeysResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*}/keys"
+    };
+  }
+
+  // Returns the specified key.
+  rpc GetKey(GetKeyRequest) returns (Key) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/keys/*}"
+    };
+  }
+
+  // Updates the specified key.
+  rpc UpdateKey(UpdateKeyRequest) returns (Key) {
+    option (google.api.http) = {
+      patch: "/v1/{key.name=projects/*/keys/*}"
+      body: "key"
+    };
+  }
+
+  // Deletes the specified key.
+  rpc DeleteKey(DeleteKeyRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/keys/*}"
+    };
+  }
+}
+
+// The create assessment request message.
+message CreateAssessmentRequest {
+  // Required. The name of the project in which the assessment will be created,
+  // in the format "projects/{project}".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
+
+  // Required. The assessment details.
+  Assessment assessment = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The request message to annotate an Assessment.
+message AnnotateAssessmentRequest {
+  // Enum that reprensents the types of annotations.
+  enum Annotation {
+    // Default unspecified type.
+    ANNOTATION_UNSPECIFIED = 0;
+
+    // Provides information that the event turned out to be legitimate.
+    LEGITIMATE = 1;
+
+    // Provides information that the event turned out to be fraudulent.
+    FRAUDULENT = 2;
+
+    // Provides information that the event was related to a login event in which
+    // the user typed the correct password.
+    PASSWORD_CORRECT = 3;
+
+    // Provides information that the event was related to a login event in which
+    // the user typed the incorrect password.
+    PASSWORD_INCORRECT = 4;
+  }
+
+  // Required. The resource name of the Assessment, in the format
+  // "projects/{project}/assessments/{assessment}".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recaptchaenterprise.googleapis.com/Assessment"
+    }
+  ];
+
+  // Required. The annotation that will be assigned to the Event.
+  Annotation annotation = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Empty response for AnnotateAssessment.
+message AnnotateAssessmentResponse {
+
+}
+
+// A recaptcha assessment resource.
+message Assessment {
+  option (google.api.resource) = {
+    type: "recaptchaenterprise.googleapis.com/Assessment"
+    pattern: "projects/{project}/assessments/{assessment}"
+  };
+
+  // Output only. The resource name for the Assessment in the format
+  // "projects/{project}/assessments/{assessment}".
+  string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // The event being assessed.
+  Event event = 2;
+
+  // Output only. The risk analysis result for the event being assessed.
+  RiskAnalysis risk_analysis = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Properties of the provided event token.
+  TokenProperties token_properties = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+message Event {
+  // Optional. The user response token provided by the reCAPTCHA client-side integration
+  // on your site.
+  string token = 1 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The site key that was used to invoke reCAPTCHA on your site and generate
+  // the token.
+  string site_key = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The user agent present in the request from the user's device related to
+  // this event.
+  string user_agent = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The IP address in the request from the user's device related to this event.
+  string user_ip_address = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The expected action for this type of event. This should be the same action
+  // provided at token generation time on client-side platforms already
+  // integrated with recaptcha enterprise.
+  string expected_action = 5 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Risk analysis result for an event.
+message RiskAnalysis {
+  // LINT.IfChange(classification_reason)
+  // Reasons contributing to the risk analysis verdict.
+  enum ClassificationReason {
+    // Default unspecified type.
+    CLASSIFICATION_REASON_UNSPECIFIED = 0;
+
+    // Interactions matched the behavior of an automated agent.
+    AUTOMATION = 1;
+
+    // The event originated from an illegitimate environment.
+    UNEXPECTED_ENVIRONMENT = 2;
+
+    // Traffic volume from the event source is higher than normal.
+    TOO_MUCH_TRAFFIC = 3;
+
+    // Interactions with the site were significantly different than expected
+    // patterns.
+    UNEXPECTED_USAGE_PATTERNS = 4;
+
+    // Too little traffic has been received from this site thus far to generate
+    // quality risk analysis.
+    LOW_CONFIDENCE_SCORE = 5;
+  }
+
+  // Legitimate event score from 0.0 to 1.0.
+  // (1.0 means very likely legitimate traffic while 0.0 means very likely
+  // non-legitimate traffic).
+  float score = 1;
+
+  // Reasons contributing to the risk analysis verdict.
+  repeated ClassificationReason reasons = 2;
+}
+
+message TokenProperties {
+  // LINT.IfChange
+  // Enum that represents the types of invalid token reasons.
+  enum InvalidReason {
+    // Default unspecified type.
+    INVALID_REASON_UNSPECIFIED = 0;
+
+    // If the failure reason was not accounted for.
+    UNKNOWN_INVALID_REASON = 1;
+
+    // The provided user verification token was malformed.
+    MALFORMED = 2;
+
+    // The user verification token had expired.
+    EXPIRED = 3;
+
+    // The user verification had already been seen.
+    DUPE = 4;
+
+    // The user verification token was not present.
+    MISSING = 5;
+  }
+
+  // Whether the provided user response token is valid. When valid = false, the
+  // reason could be specified in invalid_reason or it could also be due to
+  // a user failing to solve a challenge or a sitekey mismatch (i.e the sitekey
+  // used to generate the token was different than the one specified in the
+  // assessment).
+  bool valid = 1;
+
+  // Reason associated with the response when valid = false.
+  InvalidReason invalid_reason = 2;
+
+  // The timestamp corresponding to the generation of the token.
+  google.protobuf.Timestamp create_time = 3;
+
+  // The hostname of the page on which the token was generated.
+  string hostname = 4;
+
+  // Action name provided at token generation.
+  string action = 5;
+}
+
+// The create key request message.
+message CreateKeyRequest {
+  // Required. The name of the project in which the key will be created, in the
+  // format "projects/{project}".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
+
+  // Required. Information to create a reCAPTCHA Enterprise key.
+  Key key = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The list keys request message.
+message ListKeysRequest {
+  // Required. The name of the project that contains the keys that will be
+  // listed, in the format "projects/{project}".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
+
+  // Optional. The maximum number of keys to return. Default is 10. Max limit is
+  // 1000.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The next_page_token value returned from a previous.
+  // ListKeysRequest, if any.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response to request to list keys in a project.
+message ListKeysResponse {
+  // Key details.
+  repeated Key keys = 1;
+
+  // Token to retrieve the next page of results. It is set to empty if no keys
+  // remain in results.
+  string next_page_token = 2;
+}
+
+// The get key request message.
+message GetKeyRequest {
+  // Required. The name of the requested key, in the format
+  // "projects/{project}/keys/{key}".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recaptchaenterprise.googleapis.com/Key"
+    }
+  ];
+}
+
+// The update key request message.
+message UpdateKeyRequest {
+  // Required. The key to update.
+  Key key = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The mask to control which field of the key get updated. If the mask is not
+  // present, all fields will be updated.
+  google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// The delete key request message.
+message DeleteKeyRequest {
+  // Required. The name of the key to be deleted, in the format
+  // "projects/{project}/keys/{key}".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recaptchaenterprise.googleapis.com/Key"
+    }
+  ];
+}
+
+// A key used to identify and configure applications (web and/or mobile) that
+// use reCAPTCHA Enterprise.
+message Key {
+  option (google.api.resource) = {
+    type: "recaptchaenterprise.googleapis.com/Key"
+    pattern: "projects/{project}/keys/{key}"
+  };
+
+  // The resource name for the Key in the format
+  // "projects/{project}/keys/{key}".
+  string name = 1;
+
+  // Human-readable display name of this key. Modifiable by user.
+  string display_name = 2;
+
+  // Platform specific settings for this key. The key can only be used on one
+  // platform, the one it has settings for.
+  oneof platform_settings {
+    // Settings for keys that can be used by websites.
+    WebKeySettings web_settings = 3;
+
+    // Settings for keys that can be used by Android apps.
+    AndroidKeySettings android_settings = 4;
+
+    // Settings for keys that can be used by iOS apps.
+    IOSKeySettings ios_settings = 5;
+  }
+
+  // Optional. See 
+  // Creating and managing labels.
+  map labels = 6 [(google.api.field_behavior) = OPTIONAL];
+
+  // The timestamp corresponding to the creation of this Key.
+  google.protobuf.Timestamp create_time = 7;
+}
+
+// Settings specific to keys that can be used by websites.
+message WebKeySettings {
+  // Enum that represents the integration types for web keys.
+  enum IntegrationType {
+    // Default type that indicates this enum hasn't been specified. This is not
+    // a valid IntegrationType, one of the other types must be specified
+    // instead.
+    INTEGRATION_TYPE_UNSPECIFIED = 0;
+
+    // Only used to produce scores. It doesn't display the "I'm not a robot"
+    // checkbox and never shows captcha challenges.
+    SCORE = 1;
+
+    // Displays the "I'm not a robot" checkbox and may show captcha challenges
+    // after it is checked.
+    CHECKBOX = 2;
+
+    // Doesn't display the "I'm not a robot" checkbox, but may show captcha
+    // challenges after risk analysis.
+    INVISIBLE = 3;
+  }
+
+  // Enum that represents the possible challenge frequency and difficulty
+  // configurations for a web key.
+  enum ChallengeSecurityPreference {
+    // Default type that indicates this enum hasn't been specified.
+    CHALLENGE_SECURITY_PREFERENCE_UNSPECIFIED = 0;
+
+    // Key tends to show fewer and easier challenges.
+    USABILITY = 1;
+
+    // Key tends to show balanced (in amount and difficulty) challenges.
+    BALANCE = 2;
+
+    // Key tends to show more and harder challenges.
+    SECURITY = 3;
+  }
+
+  // If set to true, it means allowed_domains will not be enforced.
+  bool allow_all_domains = 3;
+
+  // Domains or subdomains of websites allowed to use the key. All subdomains
+  // of an allowed domain are automatically allowed. A valid domain requires a
+  // host and must not include any path, port, query or fragment.
+  // Examples: 'example.com' or 'subdomain.example.com'
+  repeated string allowed_domains = 1;
+
+  // Required. Whether this key can be used on AMP (Accelerated Mobile Pages) websites.
+  bool allow_amp_traffic = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Describes how this key is integrated with the website.
+  IntegrationType integration_type = 4 [(google.api.field_behavior) = REQUIRED];
+
+  // Settings for the frequency and difficulty at which this key triggers
+  // captcha challenges. This should only be specified for IntegrationTypes
+  // CHECKBOX and INVISIBLE.
+  ChallengeSecurityPreference challenge_security_preference = 5;
+}
+
+// Settings specific to keys that can be used by Android apps.
+message AndroidKeySettings {
+  // Android package names of apps allowed to use the key.
+  // Example: 'com.companyname.appname'
+  repeated string allowed_package_names = 1;
+}
+
+// Settings specific to keys that can be used by iOS apps.
+message IOSKeySettings {
+  // iOS bundle ids of apps allowed to use the key.
+  // Example: 'com.companyname.productname.appname'
+  repeated string allowed_bundle_ids = 1;
+}
diff --git a/third_party/googleapis/google/cloud/recaptchaenterprise/v1/recaptchaenterprise_gapic.yaml b/third_party/googleapis/google/cloud/recaptchaenterprise/v1/recaptchaenterprise_gapic.yaml
new file mode 100644
index 000000000..b2efd3cad
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recaptchaenterprise/v1/recaptchaenterprise_gapic.yaml
@@ -0,0 +1,24 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 2.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.recaptchaenterprise.v1
+  python:
+    package_name: google.cloud.recaptcha_enterprise_v1.gapic
+  go:
+    package_name: cloud.google.com/go/recaptchaenterprise/apiv1
+  csharp:
+    package_name: Google.Cloud.RecaptchaEnterprise.V1
+  ruby:
+    package_name: Google::Cloud::RecaptchaEnterprise::V1
+  php:
+    package_name: Google\Cloud\RecaptchaEnterprise\V1
+  nodejs:
+    package_name: recaptchaenterprise.v1
+    domain_layer_location: google-cloud
+collections:
+- entity_name: project
+  language_overrides:
+  - language: csharp
+    common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
diff --git a/third_party/googleapis/google/cloud/recaptchaenterprise/v1/recaptchaenterprise_grpc_service_config.json b/third_party/googleapis/google/cloud/recaptchaenterprise/v1/recaptchaenterprise_grpc_service_config.json
new file mode 100755
index 000000000..edd0c8e6c
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recaptchaenterprise/v1/recaptchaenterprise_grpc_service_config.json
@@ -0,0 +1,37 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.recaptchaenterprise.v1.RecaptchaEnterpriseService",
+          "method": "CreateAssessment"
+        },
+        {
+          "service": "google.cloud.recaptchaenterprise.v1.RecaptchaEnterpriseService",
+          "method": "AnnotateAssessment"
+        },
+        {
+          "service": "google.cloud.recaptchaenterprise.v1.RecaptchaEnterpriseService",
+          "method": "CreateKey"
+        },
+        {
+          "service": "google.cloud.recaptchaenterprise.v1.RecaptchaEnterpriseService",
+          "method": "ListKeys"
+        },
+        {
+          "service": "google.cloud.recaptchaenterprise.v1.RecaptchaEnterpriseService",
+          "method": "GetKey"
+        },
+        {
+          "service": "google.cloud.recaptchaenterprise.v1.RecaptchaEnterpriseService",
+          "method": "DeleteKey"
+        },
+        {
+          "service": "google.cloud.recaptchaenterprise.v1.RecaptchaEnterpriseService",
+          "method": "UpdateKey"
+        }
+      ],
+      "timeout": "600s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/recaptchaenterprise/v1/recaptchaenterprise_v1.yaml b/third_party/googleapis/google/cloud/recaptchaenterprise/v1/recaptchaenterprise_v1.yaml
new file mode 100644
index 000000000..aa45595c8
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recaptchaenterprise/v1/recaptchaenterprise_v1.yaml
@@ -0,0 +1,14 @@
+type: google.api.Service
+config_version: 3
+name: recaptchaenterprise.googleapis.com
+title: reCAPTCHA Enterprise API
+
+apis:
+- name: google.cloud.recaptchaenterprise.v1.RecaptchaEnterpriseService
+
+authentication:
+  rules:
+  - selector: 'google.cloud.recaptchaenterprise.v1.RecaptchaEnterpriseService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/recaptchaenterprise/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/recaptchaenterprise/v1beta1/BUILD.bazel
new file mode 100644
index 000000000..3586a8443
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recaptchaenterprise/v1beta1/BUILD.bazel
@@ -0,0 +1,362 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "recaptchaenterprise_proto",
+    srcs = [
+        "recaptchaenterprise.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "recaptchaenterprise_proto_with_info",
+    deps = [
+        ":recaptchaenterprise_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "recaptchaenterprise_java_proto",
+    deps = [":recaptchaenterprise_proto"],
+)
+
+java_grpc_library(
+    name = "recaptchaenterprise_java_grpc",
+    srcs = [":recaptchaenterprise_proto"],
+    deps = [":recaptchaenterprise_java_proto"],
+)
+
+java_gapic_library(
+    name = "recaptchaenterprise_java_gapic",
+    src = ":recaptchaenterprise_proto_with_info",
+    gapic_yaml = "recaptchaenterprise_gapic.yaml",
+    package = "google.cloud.recaptchaenterprise.v1beta1",
+    service_yaml = "recaptchaenterprise_v1beta1.yaml",
+    test_deps = [
+        ":recaptchaenterprise_java_grpc",
+    ],
+    deps = [
+        ":recaptchaenterprise_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "recaptchaenterprise_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.recaptchaenterprise.v1beta1.RecaptchaEnterpriseServiceV1Beta1ClientTest",
+    ],
+    runtime_deps = [":recaptchaenterprise_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-recaptchaenterprise-v1beta1-java",
+    deps = [
+        ":recaptchaenterprise_java_gapic",
+        ":recaptchaenterprise_java_grpc",
+        ":recaptchaenterprise_java_proto",
+        ":recaptchaenterprise_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "recaptchaenterprise_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/recaptchaenterprise/v1beta1",
+    protos = [":recaptchaenterprise_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "recaptchaenterprise_go_gapic",
+    srcs = [":recaptchaenterprise_proto_with_info"],
+    grpc_service_config = "recaptchaenterprise_grpc_service_config.json",
+    importpath = "cloud.google.com/go/recaptchaenterprise/apiv1beta1;recaptchaenterprise",
+    service_yaml = "recaptchaenterprise_v1beta1.yaml",
+    deps = [
+        ":recaptchaenterprise_go_proto",
+    ],
+)
+
+go_test(
+    name = "recaptchaenterprise_go_gapic_test",
+    srcs = [":recaptchaenterprise_go_gapic_srcjar_test"],
+    embed = [":recaptchaenterprise_go_gapic"],
+    importpath = "cloud.google.com/go/recaptchaenterprise/apiv1beta1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-recaptchaenterprise-v1beta1-go",
+    deps = [
+        ":recaptchaenterprise_go_gapic",
+        ":recaptchaenterprise_go_gapic_srcjar-test.srcjar",
+        ":recaptchaenterprise_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "recaptchaenterprise_moved_proto",
+    srcs = [":recaptchaenterprise_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "recaptchaenterprise_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":recaptchaenterprise_moved_proto"],
+)
+
+py_grpc_library(
+    name = "recaptchaenterprise_py_grpc",
+    srcs = [":recaptchaenterprise_moved_proto"],
+    deps = [":recaptchaenterprise_py_proto"],
+)
+
+py_gapic_library(
+    name = "recaptchaenterprise_py_gapic",
+    src = ":recaptchaenterprise_proto_with_info",
+    gapic_yaml = "recaptchaenterprise_gapic.yaml",
+    package = "google.cloud.recaptchaenterprise.v1beta1",
+    service_yaml = "recaptchaenterprise_v1beta1.yaml",
+    deps = [
+        ":recaptchaenterprise_py_grpc",
+        ":recaptchaenterprise_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "recaptchaenterprise-v1beta1-py",
+    deps = [
+        ":recaptchaenterprise_py_gapic",
+        ":recaptchaenterprise_py_grpc",
+        ":recaptchaenterprise_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "recaptchaenterprise_php_proto",
+    deps = [":recaptchaenterprise_proto"],
+)
+
+php_grpc_library(
+    name = "recaptchaenterprise_php_grpc",
+    srcs = [":recaptchaenterprise_proto"],
+    deps = [":recaptchaenterprise_php_proto"],
+)
+
+php_gapic_library(
+    name = "recaptchaenterprise_php_gapic",
+    src = ":recaptchaenterprise_proto_with_info",
+    gapic_yaml = "recaptchaenterprise_gapic.yaml",
+    package = "google.cloud.recaptchaenterprise.v1beta1",
+    service_yaml = "recaptchaenterprise_v1beta1.yaml",
+    deps = [
+        ":recaptchaenterprise_php_grpc",
+        ":recaptchaenterprise_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-recaptchaenterprise-v1beta1-php",
+    deps = [
+        ":recaptchaenterprise_php_gapic",
+        ":recaptchaenterprise_php_grpc",
+        ":recaptchaenterprise_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "recaptchaenterprise_nodejs_gapic",
+    src = ":recaptchaenterprise_proto_with_info",
+    gapic_yaml = "recaptchaenterprise_gapic.yaml",
+    package = "google.cloud.recaptchaenterprise.v1beta1",
+    service_yaml = "recaptchaenterprise_v1beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "recaptchaenterprise-v1beta1-nodejs",
+    deps = [
+        ":recaptchaenterprise_nodejs_gapic",
+        ":recaptchaenterprise_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "recaptchaenterprise_ruby_proto",
+    deps = [":recaptchaenterprise_proto"],
+)
+
+ruby_grpc_library(
+    name = "recaptchaenterprise_ruby_grpc",
+    srcs = [":recaptchaenterprise_proto"],
+    deps = [":recaptchaenterprise_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "recaptchaenterprise_ruby_gapic",
+    src = ":recaptchaenterprise_proto_with_info",
+    gapic_yaml = "recaptchaenterprise_gapic.yaml",
+    package = "google.cloud.recaptchaenterprise.v1beta1",
+    service_yaml = "recaptchaenterprise_v1beta1.yaml",
+    deps = [
+        ":recaptchaenterprise_ruby_grpc",
+        ":recaptchaenterprise_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-recaptchaenterprise-v1beta1-ruby",
+    deps = [
+        ":recaptchaenterprise_ruby_gapic",
+        ":recaptchaenterprise_ruby_grpc",
+        ":recaptchaenterprise_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "recaptchaenterprise_csharp_proto",
+    deps = [":recaptchaenterprise_proto"],
+)
+
+csharp_grpc_library(
+    name = "recaptchaenterprise_csharp_grpc",
+    srcs = [":recaptchaenterprise_proto"],
+    deps = [":recaptchaenterprise_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "recaptchaenterprise_csharp_gapic",
+    src = ":recaptchaenterprise_proto_with_info",
+    gapic_yaml = "recaptchaenterprise_gapic.yaml",
+    package = "google.cloud.recaptchaenterprise.v1beta1",
+    service_yaml = "recaptchaenterprise_v1beta1.yaml",
+    deps = [
+        ":recaptchaenterprise_csharp_grpc",
+        ":recaptchaenterprise_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-recaptchaenterprise-v1beta1-csharp",
+    deps = [
+        ":recaptchaenterprise_csharp_gapic",
+        ":recaptchaenterprise_csharp_grpc",
+        ":recaptchaenterprise_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/recaptchaenterprise/v1beta1/recaptchaenterprise.proto b/third_party/googleapis/google/cloud/recaptchaenterprise/v1beta1/recaptchaenterprise.proto
index 188f99f6f..099d3041f 100644
--- a/third_party/googleapis/google/cloud/recaptchaenterprise/v1beta1/recaptchaenterprise.proto
+++ b/third_party/googleapis/google/cloud/recaptchaenterprise/v1beta1/recaptchaenterprise.proto
@@ -18,6 +18,11 @@ syntax = "proto3";
 package google.cloud.recaptchaenterprise.v1beta1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
 import "google/protobuf/timestamp.proto";
 
 option csharp_namespace = "Google.Cloud.RecaptchaEnterprise.V1Beta1";
@@ -27,16 +32,20 @@ option java_outer_classname = "RecaptchaEnterpriseProto";
 option java_package = "com.google.recaptchaenterprise.v1beta1";
 option objc_class_prefix = "GCRE";
 option php_namespace = "Google\\Cloud\\RecaptchaEnterprise\\V1beta1";
-
+option ruby_package = "Google::Cloud::RecaptchaEnterprise::V1beta1";
 
 // Service to determine the likelihood an event is legitimate.
 service RecaptchaEnterpriseServiceV1Beta1 {
+  option (google.api.default_host) = "recaptchaenterprise.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Creates an Assessment of the likelihood an event is legitimate.
   rpc CreateAssessment(CreateAssessmentRequest) returns (Assessment) {
     option (google.api.http) = {
       post: "/v1beta1/{parent=projects/*}/assessments"
       body: "assessment"
     };
+    option (google.api.method_signature) = "parent,assessment";
   }
 
   // Annotates a previously created Assessment to provide additional information
@@ -46,6 +55,44 @@ service RecaptchaEnterpriseServiceV1Beta1 {
       post: "/v1beta1/{name=projects/*/assessments/*}:annotate"
       body: "*"
     };
+    option (google.api.method_signature) = "name,annotation";
+  }
+
+  // Creates a new reCAPTCHA Enterprise key.
+  rpc CreateKey(CreateKeyRequest) returns (Key) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*}/keys"
+      body: "key"
+    };
+  }
+
+  // Returns the list of all keys that belong to a project.
+  rpc ListKeys(ListKeysRequest) returns (ListKeysResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*}/keys"
+    };
+  }
+
+  // Returns the specified key.
+  rpc GetKey(GetKeyRequest) returns (Key) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/keys/*}"
+    };
+  }
+
+  // Updates the specified key.
+  rpc UpdateKey(UpdateKeyRequest) returns (Key) {
+    option (google.api.http) = {
+      patch: "/v1beta1/{key.name=projects/*/keys/*}"
+      body: "key"
+    };
+  }
+
+  // Deletes the specified key.
+  rpc DeleteKey(DeleteKeyRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/keys/*}"
+    };
   }
 }
 
@@ -53,10 +100,15 @@ service RecaptchaEnterpriseServiceV1Beta1 {
 message CreateAssessmentRequest {
   // Required. The name of the project in which the assessment will be created,
   // in the format "projects/{project_number}".
-  string parent = 1;
-
-  // The asessment details.
-  Assessment assessment = 2;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
+
+  // Required. The assessment details.
+  Assessment assessment = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The request message to annotate an Assessment.
@@ -75,10 +127,15 @@ message AnnotateAssessmentRequest {
 
   // Required. The resource name of the Assessment, in the format
   // "projects/{project_number}/assessments/{assessment_id}".
-  string name = 1;
-
-  // The annotation that will be assigned to the Event.
-  Annotation annotation = 2;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recaptchaenterprise.googleapis.com/Assessment"
+    }
+  ];
+
+  // Required. The annotation that will be assigned to the Event.
+  Annotation annotation = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Empty response for AnnotateAssessment.
@@ -88,30 +145,38 @@ message AnnotateAssessmentResponse {
 
 // A recaptcha assessment resource.
 message Assessment {
+  option (google.api.resource) = {
+    type: "recaptchaenterprise.googleapis.com/Assessment"
+    pattern: "projects/{project}/assessments/{assessment}"
+  };
+
   // LINT.IfChange(classification_reason)
   // Reasons contributing to the risk analysis verdict.
   enum ClassificationReason {
     // Default unspecified type.
     CLASSIFICATION_REASON_UNSPECIFIED = 0;
 
-    // The event appeared to be automated.
+    // Interactions matched the behavior of an automated agent.
     AUTOMATION = 1;
 
-    // The event was not made from the proper context on the real site.
+    // The event originated from an illegitimate environment.
     UNEXPECTED_ENVIRONMENT = 2;
 
-    // Browsing behavior leading up to the event was generated was out of the
-    // ordinary.
+    // Traffic volume from the event source is higher than normal.
+    TOO_MUCH_TRAFFIC = 3;
+
+    // Interactions with the site were significantly different than expected
+    // patterns.
     UNEXPECTED_USAGE_PATTERNS = 4;
 
     // Too little traffic has been received from this site thus far to generate
     // quality risk analysis.
-    PROVISIONAL_RISK_ANALYSIS = 5;
+    LOW_CONFIDENCE_SCORE = 5;
   }
 
   // Output only. The resource name for the Assessment in the format
   // "projects/{project_number}/assessments/{assessment_id}".
-  string name = 1;
+  string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // The event being assessed.
   Event event = 2;
@@ -119,26 +184,39 @@ message Assessment {
   // Output only. Legitimate event score from 0.0 to 1.0.
   // (1.0 means very likely legitimate traffic while 0.0 means very likely
   // non-legitimate traffic).
-  float score = 3;
+  float score = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Properties of the provided event token.
-  TokenProperties token_properties = 4;
+  TokenProperties token_properties = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Reasons contributing to the risk analysis verdict.
-  repeated ClassificationReason reasons = 5;
+  repeated ClassificationReason reasons = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 message Event {
-  // The user response token provided by the reCAPTCHA client-side integration
+  // Optional. The user response token provided by the reCAPTCHA client-side integration
   // on your site.
-  string token = 1;
+  string token = 1 [(google.api.field_behavior) = OPTIONAL];
 
-  // The site key that was used to invoke reCAPTCHA on your site and generate
+  // Optional. The site key that was used to invoke reCAPTCHA on your site and generate
   // the token.
-  string site_key = 2;
+  string site_key = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The user agent present in the request from the user's device related to
+  // this event.
+  string user_agent = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The IP address in the request from the user's device related to this event.
+  string user_ip_address = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The expected action for this type of event. This should be the same action
+  // provided at token generation time on client-side platforms already
+  // integrated with recaptcha enterprise.
+  string expected_action = 5 [(google.api.field_behavior) = OPTIONAL];
 }
 
 message TokenProperties {
+  // LINT.IfChange
   // Enum that represents the types of invalid token reasons.
   enum InvalidReason {
     // Default unspecified type.
@@ -156,7 +234,7 @@ message TokenProperties {
     // The user verification had already been seen.
     DUPE = 4;
 
-    // The user verification token did not match the provided site secret.
+    // The user verification token did not match the provided site key.
     // This may be a configuration error (e.g. development keys used in
     // production) or end users trying to use verification tokens from other
     // sites.
@@ -166,18 +244,199 @@ message TokenProperties {
     MISSING = 6;
   }
 
-  // Output only. Whether the provided user response token is valid.
+  // Whether the provided user response token is valid.
   bool valid = 1;
 
-  // Output only. Reason associated with the response when valid = false.
+  // Reason associated with the response when valid = false.
   InvalidReason invalid_reason = 2;
 
-  // Output only. The timestamp corresponding to the generation of the token.
+  // The timestamp corresponding to the generation of the token.
   google.protobuf.Timestamp create_time = 3;
 
-  // Output only. The hostname of the page on which the token was generated.
+  // The hostname of the page on which the token was generated.
   string hostname = 4;
 
-  // Output only. Action name provided at token generation.
+  // Action name provided at token generation.
   string action = 5;
 }
+
+// The create key request message.
+message CreateKeyRequest {
+  // Required. The name of the project in which the key will be created, in the
+  // format "projects/{project_number}".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
+
+  // Required. Information to create a reCAPTCHA Enterprise key.
+  Key key = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The list keys request message.
+message ListKeysRequest {
+  // Required. The name of the project that contains the keys that will be
+  // listed, in the format "projects/{project_number}".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
+
+  // Optional. The maximum number of keys to return. Default is 10. Max limit is
+  // 1000.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The next_page_token value returned from a previous.
+  // ListKeysRequest, if any.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response to request to list keys in a project.
+message ListKeysResponse {
+  // Key details.
+  repeated Key keys = 1;
+
+  // Token to retrieve the next page of results. It is set to empty if no keys
+  // remain in results.
+  string next_page_token = 2;
+}
+
+// The get key request message.
+message GetKeyRequest {
+  // Required. The name of the requested key, in the format
+  // "projects/{project_number}/keys/{key_id}".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recaptchaenterprise.googleapis.com/Key"
+    }
+  ];
+}
+
+// The update key request message.
+message UpdateKeyRequest {
+  // Required. The key to update.
+  Key key = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The mask to control which field of the key get updated. If the mask is not
+  // present, all fields will be updated.
+  google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// The delete key request message.
+message DeleteKeyRequest {
+  // Required. The name of the key to be deleted, in the format
+  // "projects/{project_number}/keys/{key_id}".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recaptchaenterprise.googleapis.com/Key"
+    }
+  ];
+}
+
+// A key used to identify and configure applications (web and/or mobile) that
+// use reCAPTCHA Enterprise.
+message Key {
+  option (google.api.resource) = {
+    type: "recaptchaenterprise.googleapis.com/Key"
+    pattern: "projects/{project}/keys/{key}"
+  };
+
+  // The resource name for the Key in the format
+  // "projects/{project_number}/keys/{key_id}".
+  string name = 1;
+
+  // Human-readable display name of this key. Modifiable by user.
+  string display_name = 2;
+
+  // Platform specific settings for this key. The key can only be used on one
+  // platform, the one it has settings for.
+  oneof platform_settings {
+    // Settings for keys that can be used by websites.
+    WebKeySettings web_settings = 3;
+
+    // Settings for keys that can be used by Android apps.
+    AndroidKeySettings android_settings = 4;
+
+    // Settings for keys that can be used by iOS apps.
+    IOSKeySettings ios_settings = 5;
+  }
+}
+
+// Settings specific to keys that can be used by websites.
+message WebKeySettings {
+  // Enum that represents the integration types for web keys.
+  enum IntegrationType {
+    // Default type that indicates this enum hasn't been specified. This is not
+    // a valid IntegrationType, one of the other types must be specified
+    // instead.
+    INTEGRATION_TYPE_UNSPECIFIED = 0;
+
+    // Only used to produce scores. It doesn't display the "I'm not a robot"
+    // checkbox and never shows captcha challenges.
+    SCORE_ONLY = 1;
+
+    // Displays the "I'm not a robot" checkbox and may show captcha challenges
+    // after it is checked.
+    CHECKBOX_CHALLENGE = 2;
+
+    // Doesn't display the "I'm not a robot" checkbox, but may show captcha
+    // challenges after risk analysis.
+    INVISIBLE_CHALLENGE = 3;
+  }
+
+  // Enum that represents the possible challenge frequency and difficulty
+  // configurations for a web key.
+  enum ChallengeSecurityPreference {
+    // Default type that indicates this enum hasn't been specified.
+    CHALLENGE_SECURITY_PREFERENCE_UNSPECIFIED = 0;
+
+    // Key tends to show fewer and easier challenges.
+    USABILITY = 1;
+
+    // Key tends to show balanced (in amount and difficulty) challenges.
+    BALANCED = 2;
+
+    // Key tends to show more and harder challenges.
+    SECURITY = 3;
+  }
+
+  // Whether allowed_domains is enforced or not.
+  bool enforce_allowed_domains = 3;
+
+  // Domains or subdomains of websites allowed to use the key. All subdomains
+  // of an allowed domain are automatically allowed. A valid domain requires a
+  // host and must not include any path, port, query or fragment.
+  // Examples: 'example.com' or 'subdomain.example.com'
+  repeated string allowed_domains = 1;
+
+  // Whether this key can be used on AMP (Accelerated Mobile Pages) websites.
+  bool allow_amp_traffic = 2;
+
+  // Required. Describes how this key is integrated with the website.
+  IntegrationType integration_type = 4 [(google.api.field_behavior) = REQUIRED];
+
+  // Settings for the frequency and difficulty at which this key triggers
+  // captcha challenges. This should only be specified for IntegrationTypes
+  // CHECKBOX_CHALLENGE and INVISIBLE_CHALLENGE.
+  ChallengeSecurityPreference challenge_security_preference = 5;
+}
+
+// Settings specific to keys that can be used by Android apps.
+message AndroidKeySettings {
+  // Android package names of apps allowed to use the key.
+  // Example: 'com.companyname.appname'
+  repeated string allowed_package_names = 1;
+}
+
+// Settings specific to keys that can be used by iOS apps.
+message IOSKeySettings {
+  // iOS bundle ids of apps allowed to use the key.
+  // Example: 'com.companyname.productname.appname'
+  repeated string allowed_bundle_ids = 1;
+}
diff --git a/third_party/googleapis/google/cloud/recaptchaenterprise/v1beta1/recaptchaenterprise_gapic.legacy.yaml b/third_party/googleapis/google/cloud/recaptchaenterprise/v1beta1/recaptchaenterprise_gapic.legacy.yaml
new file mode 100644
index 000000000..7973f096c
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recaptchaenterprise/v1beta1/recaptchaenterprise_gapic.legacy.yaml
@@ -0,0 +1,155 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.recaptchaenterprise.v1beta1
+  python:
+    package_name: google.cloud.recaptcha_enterprise_v1beta1.gapic
+  go:
+    package_name: cloud.google.com/go/recaptchaenterprise/apiv1beta1
+  csharp:
+    package_name: Google.Cloud.RecaptchaEnterprise.V1Beta1
+  ruby:
+    package_name: Google::Cloud::RecaptchaEnterprise::V1beta1
+  php:
+    package_name: Google\Cloud\RecaptchaEnterprise\V1beta1
+  nodejs:
+    package_name: recaptchaenterprise.v1beta1
+    domain_layer_location: google-cloud
+# The configuration for the license header to put on generated files.
+license_header:
+  # The file containing the copyright line(s).
+  copyright_file: copyright-google.txt
+  # The file containing the raw license header without any copyright line(s).
+  license_file: license-header-apache-2.0.txt
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: google.cloud.recaptchaenterprise.v1beta1.RecaptchaEnterpriseServiceV1Beta1
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}
+    entity_name: project
+    language_overrides:
+    - language: csharp
+      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
+  - name_pattern: projects/{project}/assessments/{assessment}
+    entity_name: assessment
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: CreateAssessment
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - assessment
+    required_fields:
+    - parent
+    - assessment
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 60000
+  - name: AnnotateAssessment
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - annotation
+    required_fields:
+    - name
+    - annotation
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: assessment
+    timeout_millis: 60000
+resource_name_generation:
+- message_name: CreateAssessmentRequest
+  field_entity_map:
+    parent: project
+- message_name: AnnotateAssessmentRequest
+  field_entity_map:
+    name: assessment
diff --git a/third_party/googleapis/google/cloud/recaptchaenterprise/v1beta1/recaptchaenterprise_gapic.yaml b/third_party/googleapis/google/cloud/recaptchaenterprise/v1beta1/recaptchaenterprise_gapic.yaml
index 7973f096c..3871a3262 100644
--- a/third_party/googleapis/google/cloud/recaptchaenterprise/v1beta1/recaptchaenterprise_gapic.yaml
+++ b/third_party/googleapis/google/cloud/recaptchaenterprise/v1beta1/recaptchaenterprise_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -17,139 +17,8 @@ language_settings:
   nodejs:
     package_name: recaptchaenterprise.v1beta1
     domain_layer_location: google-cloud
-# The configuration for the license header to put on generated files.
-license_header:
-  # The file containing the copyright line(s).
-  copyright_file: copyright-google.txt
-  # The file containing the raw license header without any copyright line(s).
-  license_file: license-header-apache-2.0.txt
-# A list of API interface configurations.
-interfaces:
-# The fully qualified name of the API interface.
-- name: google.cloud.recaptchaenterprise.v1beta1.RecaptchaEnterpriseServiceV1Beta1
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections:
-  - name_pattern: projects/{project}
-    entity_name: project
-    language_overrides:
-    - language: csharp
-      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
-  - name_pattern: projects/{project}/assessments/{assessment}
-    entity_name: assessment
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
-  methods:
-  - name: CreateAssessment
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - assessment
-    required_fields:
-    - parent
-    - assessment
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: project
-    timeout_millis: 60000
-  - name: AnnotateAssessment
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - annotation
-    required_fields:
-    - name
-    - annotation
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: assessment
-    timeout_millis: 60000
-resource_name_generation:
-- message_name: CreateAssessmentRequest
-  field_entity_map:
-    parent: project
-- message_name: AnnotateAssessmentRequest
-  field_entity_map:
-    name: assessment
+collections:
+- entity_name: project
+  language_overrides:
+  - language: csharp
+    common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
diff --git a/third_party/googleapis/google/cloud/recaptchaenterprise/v1beta1/recaptchaenterprise_grpc_service_config.json b/third_party/googleapis/google/cloud/recaptchaenterprise/v1beta1/recaptchaenterprise_grpc_service_config.json
new file mode 100755
index 000000000..be075f419
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recaptchaenterprise/v1beta1/recaptchaenterprise_grpc_service_config.json
@@ -0,0 +1,37 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.recaptchaenterprise.v1beta1.RecaptchaEnterpriseServiceV1Beta1",
+          "method": "CreateAssessment"
+        },
+        {
+          "service": "google.cloud.recaptchaenterprise.v1beta1.RecaptchaEnterpriseServiceV1Beta1",
+          "method": "AnnotateAssessment"
+        },
+        {
+          "service": "google.cloud.recaptchaenterprise.v1beta1.RecaptchaEnterpriseServiceV1Beta1",
+          "method": "CreateKey"
+        },
+        {
+          "service": "google.cloud.recaptchaenterprise.v1beta1.RecaptchaEnterpriseServiceV1Beta1",
+          "method": "ListKeys"
+        },
+        {
+          "service": "google.cloud.recaptchaenterprise.v1beta1.RecaptchaEnterpriseServiceV1Beta1",
+          "method": "GetKey"
+        },
+        {
+          "service": "google.cloud.recaptchaenterprise.v1beta1.RecaptchaEnterpriseServiceV1Beta1",
+          "method": "DeleteKey"
+        },
+        {
+          "service": "google.cloud.recaptchaenterprise.v1beta1.RecaptchaEnterpriseServiceV1Beta1",
+          "method": "UpdateKey"
+        }
+      ],
+      "timeout": "600s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/recaptchaenterprise/recaptchaenterprise_v1beta1.yaml b/third_party/googleapis/google/cloud/recaptchaenterprise/v1beta1/recaptchaenterprise_v1beta1.yaml
similarity index 51%
rename from third_party/googleapis/google/cloud/recaptchaenterprise/recaptchaenterprise_v1beta1.yaml
rename to third_party/googleapis/google/cloud/recaptchaenterprise/v1beta1/recaptchaenterprise_v1beta1.yaml
index 4996c5a4f..fc95bdf73 100644
--- a/third_party/googleapis/google/cloud/recaptchaenterprise/recaptchaenterprise_v1beta1.yaml
+++ b/third_party/googleapis/google/cloud/recaptchaenterprise/v1beta1/recaptchaenterprise_v1beta1.yaml
@@ -8,11 +8,7 @@ apis:
 
 authentication:
   rules:
-  - selector: google.cloud.recaptchaenterprise.v1beta1.RecaptchaEnterpriseServiceV1Beta1.AnnotateAssessment
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform
-  - selector: google.cloud.recaptchaenterprise.v1beta1.RecaptchaEnterpriseServiceV1Beta1.CreateAssessment
+  - selector: 'google.cloud.recaptchaenterprise.v1beta1.RecaptchaEnterpriseServiceV1Beta1.*'
     oauth:
       canonical_scopes: |-
         https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/recommendationengine/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/BUILD.bazel
new file mode 100644
index 000000000..f60a1cb14
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/BUILD.bazel
@@ -0,0 +1,351 @@
+# This file was automatically generated by BuildFileGenerator
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+    "moved_proto_library",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+    "proto_library_with_info",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+proto_library(
+    name = "recommendationengine_proto",
+    srcs = [
+        "catalog.proto",
+        "catalog_service.proto",
+        "common.proto",
+        "import.proto",
+        "prediction_apikey_registry_service.proto",
+        "prediction_service.proto",
+        "recommendationengine_resources.proto",
+        "user_event.proto",
+        "user_event_service.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:httpbody_proto",
+        "//google/api:resource_proto",
+        "//google/longrunning:operations_proto",
+        "//google/rpc:status_proto",
+        "//google/type:date_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:struct_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "recommendationengine_proto_with_info",
+    deps = [
+        ":recommendationengine_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+java_proto_library(
+    name = "recommendationengine_java_proto",
+    deps = [
+        ":recommendationengine_proto",
+        "//google/api:httpbody_proto",
+    ],
+)
+
+java_grpc_library(
+    name = "recommendationengine_java_grpc",
+    srcs = [":recommendationengine_proto"],
+    deps = [":recommendationengine_java_proto"],
+)
+
+java_gapic_library(
+    name = "recommendationengine_java_gapic",
+    src = ":recommendationengine_proto_with_info",
+    gapic_yaml = "recommendationengine_gapic.yaml",
+    package = "google.cloud.recommendationengine.v1beta1",
+    service_yaml = "recommendationengine_v1beta1.yaml",
+    test_deps = [
+        ":recommendationengine_java_grpc",
+    ],
+    deps = [
+        ":recommendationengine_java_proto",
+        "//google/api:httpbody_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "recommendationengine_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.recommendationengine.v1beta1.CatalogServiceClientTest",
+        "com.google.cloud.recommendationengine.v1beta1.PredictionApiKeyRegistryClientTest",
+        "com.google.cloud.recommendationengine.v1beta1.PredictionServiceClientTest",
+        "com.google.cloud.recommendationengine.v1beta1.UserEventServiceClientTest",
+    ],
+    runtime_deps = [":recommendationengine_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-recommendationengine-v1beta1-java",
+    deps = [
+        ":recommendationengine_java_gapic",
+        ":recommendationengine_java_grpc",
+        ":recommendationengine_java_proto",
+        ":recommendationengine_proto",
+    ],
+)
+
+go_proto_library(
+    name = "recommendationengine_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/recommendationengine/v1beta1",
+    protos = [":recommendationengine_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/api:httpbody_go_proto",
+        "//google/longrunning:longrunning_go_proto",
+        "//google/rpc:status_go_proto",
+        "//google/type:date_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "recommendationengine_go_gapic",
+    srcs = [":recommendationengine_proto_with_info"],
+    grpc_service_config = "recommendationengine_grpc_service_config.json",
+    importpath = "cloud.google.com/go/recommendationengine/apiv1beta1;recommendationengine",
+    service_yaml = "recommendationengine_v1beta1.yaml",
+    deps = [
+        ":recommendationengine_go_proto",
+        "//google/api:httpbody_go_proto",
+        "//google/longrunning:longrunning_go_gapic",
+        "//google/longrunning:longrunning_go_proto",
+        "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
+        "@io_bazel_rules_go//proto/wkt:struct_go_proto",
+    ],
+)
+
+go_test(
+    name = "recommendationengine_go_gapic_test",
+    srcs = [":recommendationengine_go_gapic_srcjar_test"],
+    embed = [":recommendationengine_go_gapic"],
+    importpath = "cloud.google.com/go/recommendationengine/apiv1beta1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-recommendationengine-v1beta1-go",
+    deps = [
+        ":recommendationengine_go_gapic",
+        ":recommendationengine_go_gapic_srcjar-test.srcjar",
+        ":recommendationengine_go_proto",
+    ],
+)
+
+moved_proto_library(
+    name = "recommendationengine_moved_proto",
+    srcs = [":recommendationengine_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:httpbody_proto",
+        "//google/api:resource_proto",
+        "//google/longrunning:operations_proto",
+        "//google/rpc:status_proto",
+        "//google/type:date_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:struct_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "recommendationengine_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":recommendationengine_moved_proto"],
+)
+
+py_grpc_library(
+    name = "recommendationengine_py_grpc",
+    srcs = [":recommendationengine_moved_proto"],
+    deps = [":recommendationengine_py_proto"],
+)
+
+py_gapic_library(
+    name = "recommendationengine_py_gapic",
+    src = ":recommendationengine_proto_with_info",
+    gapic_yaml = "recommendationengine_gapic.yaml",
+    package = "google.cloud.recommendationengine.v1beta1",
+    service_yaml = "recommendationengine_v1beta1.yaml",
+    deps = [
+        ":recommendationengine_py_grpc",
+        ":recommendationengine_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "recommendationengine-v1beta1-py",
+    deps = [
+        ":recommendationengine_py_gapic",
+        ":recommendationengine_py_grpc",
+        ":recommendationengine_py_proto",
+    ],
+)
+
+php_proto_library(
+    name = "recommendationengine_php_proto",
+    deps = [":recommendationengine_proto"],
+)
+
+php_grpc_library(
+    name = "recommendationengine_php_grpc",
+    srcs = [":recommendationengine_proto"],
+    deps = [":recommendationengine_php_proto"],
+)
+
+php_gapic_library(
+    name = "recommendationengine_php_gapic",
+    src = ":recommendationengine_proto_with_info",
+    gapic_yaml = "recommendationengine_gapic.yaml",
+    package = "google.cloud.recommendationengine.v1beta1",
+    service_yaml = "recommendationengine_v1beta1.yaml",
+    deps = [
+        ":recommendationengine_php_grpc",
+        ":recommendationengine_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-recommendationengine-v1beta1-php",
+    deps = [
+        ":recommendationengine_php_gapic",
+        ":recommendationengine_php_grpc",
+        ":recommendationengine_php_proto",
+    ],
+)
+
+nodejs_gapic_library(
+    name = "recommendationengine_nodejs_gapic",
+    src = ":recommendationengine_proto_with_info",
+    gapic_yaml = "recommendationengine_gapic.yaml",
+    package = "google.cloud.recommendationengine.v1beta1",
+    service_yaml = "recommendationengine_v1beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "recommendationengine-v1beta1-nodejs",
+    deps = [
+        ":recommendationengine_nodejs_gapic",
+        ":recommendationengine_proto",
+    ],
+)
+
+ruby_proto_library(
+    name = "recommendationengine_ruby_proto",
+    deps = [":recommendationengine_proto"],
+)
+
+ruby_grpc_library(
+    name = "recommendationengine_ruby_grpc",
+    srcs = [":recommendationengine_proto"],
+    deps = [":recommendationengine_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "recommendationengine_ruby_gapic",
+    src = ":recommendationengine_proto_with_info",
+    gapic_yaml = "recommendationengine_gapic.yaml",
+    package = "google.cloud.recommendationengine.v1beta1",
+    service_yaml = "recommendationengine_v1beta1.yaml",
+    deps = [
+        ":recommendationengine_ruby_grpc",
+        ":recommendationengine_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-recommendationengine-v1beta1-ruby",
+    deps = [
+        ":recommendationengine_ruby_gapic",
+        ":recommendationengine_ruby_grpc",
+        ":recommendationengine_ruby_proto",
+    ],
+)
+
+csharp_proto_library(
+    name = "recommendationengine_csharp_proto",
+    deps = [":recommendationengine_proto"],
+)
+
+csharp_grpc_library(
+    name = "recommendationengine_csharp_grpc",
+    srcs = [":recommendationengine_proto"],
+    deps = [":recommendationengine_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "recommendationengine_csharp_gapic",
+    src = ":recommendationengine_proto_with_info",
+    gapic_yaml = "recommendationengine_gapic.yaml",
+    package = "google.cloud.recommendationengine.v1beta1",
+    service_yaml = "recommendationengine_v1beta1.yaml",
+    deps = [
+        ":recommendationengine_csharp_grpc",
+        ":recommendationengine_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-recommendationengine-v1beta1-csharp",
+    deps = [
+        ":recommendationengine_csharp_gapic",
+        ":recommendationengine_csharp_grpc",
+        ":recommendationengine_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/recommendationengine/v1beta1/artman_recommendationengine_v1beta1.yaml b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/artman_recommendationengine_v1beta1.yaml
new file mode 100644
index 000000000..9e1b2c80a
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/artman_recommendationengine_v1beta1.yaml
@@ -0,0 +1,34 @@
+common:
+  api_name: recommendationengine
+  api_version: v1beta1
+  organization_name: google-cloud
+  proto_deps:
+  - name: google-common-protos
+  src_proto_paths:
+  - .
+  service_yaml: recommendationengine_v1beta1.yaml
+  gapic_yaml: recommendationengine_gapic.yaml
+artifacts:
+- name: gapic_config
+  type: GAPIC_CONFIG
+- name: java_gapic
+  type: GAPIC
+  language: JAVA
+- name: python_gapic
+  type: GAPIC
+  language: PYTHON
+- name: nodejs_gapic
+  type: GAPIC
+  language: NODEJS
+- name: php_gapic
+  type: GAPIC
+  language: PHP
+- name: go_gapic
+  type: GAPIC
+  language: GO
+- name: ruby_gapic
+  type: GAPIC
+  language: RUBY
+- name: csharp_gapic
+  type: GAPIC
+  language: CSHARP
diff --git a/third_party/googleapis/google/cloud/recommendationengine/v1beta1/catalog.proto b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/catalog.proto
new file mode 100644
index 000000000..9a0c163dc
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/catalog.proto
@@ -0,0 +1,199 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.recommendationengine.v1beta1;
+
+import "google/api/field_behavior.proto";
+import "google/cloud/recommendationengine/v1beta1/common.proto";
+import "google/protobuf/struct.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.RecommendationEngine.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/recommendationengine/v1beta1;recommendationengine";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.recommendationengine.v1beta1";
+option objc_class_prefix = "RECAI";
+option php_namespace = "Google\\Cloud\\RecommendationEngine\\V1beta1";
+option ruby_package = "Google::Cloud::RecommendationEngine::V1beta1";
+
+// CatalogItem captures all metadata information of items to be recommended.
+message CatalogItem {
+  // Category represents catalog item category hierarchy.
+  message CategoryHierarchy {
+    // Required. Catalog item categories. Each category should be a UTF-8
+    // encoded string with a length limit of 2 KiB.
+    //
+    // Note that the order in the list denotes the specificity (from least to
+    // most specific).
+    repeated string categories = 1 [(google.api.field_behavior) = REQUIRED];
+  }
+
+  // Required. Catalog item identifier. UTF-8 encoded string with a length limit
+  // of 128 bytes.
+  //
+  // This id must be unique among all catalog items within the same catalog. It
+  // should also be used when logging user events in order for the user events
+  // to be joined with the Catalog.
+  string id = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Catalog item categories. This field is repeated for supporting
+  // one catalog item belonging to several parallel category hierarchies.
+  //
+  // For example, if a shoes product belongs to both
+  // ["Shoes & Accessories" -> "Shoes"] and
+  // ["Sports & Fitness" -> "Athletic Clothing" -> "Shoes"], it could be
+  // represented as:
+  //
+  //      "categoryHierarchies": [
+  //        { "categories": ["Shoes & Accessories", "Shoes"]},
+  //        { "categories": ["Sports & Fitness", "Athletic Clothing", "Shoes"] }
+  //      ]
+  repeated CategoryHierarchy category_hierarchies = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Catalog item title. UTF-8 encoded string with a length limit of 1
+  // KiB.
+  string title = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Catalog item description. UTF-8 encoded string with a length
+  // limit of 5 KiB.
+  string description = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Highly encouraged. Extra catalog item attributes to be
+  // included in the recommendation model. For example, for retail products,
+  // this could include the store name, vendor, style, color, etc. These are
+  // very strong signals for recommendation model, thus we highly recommend
+  // providing the item attributes here.
+  FeatureMap item_attributes = 5 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Language of the title/description/item_attributes. Use language
+  // tags defined by BCP 47. https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Our
+  // supported language codes include 'en', 'es', 'fr', 'de', 'ar', 'fa', 'zh',
+  // 'ja', 'ko', 'sv', 'ro', 'nl'. For other languages, contact
+  // your Google account manager.
+  string language_code = 6 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Filtering tags associated with the catalog item. Each tag should
+  // be a UTF-8 encoded string with a length limit of 1 KiB.
+  //
+  // This tag can be used for filtering recommendation results by passing the
+  // tag as part of the predict request filter.
+  repeated string tags = 8 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Variant group identifier for prediction results. UTF-8 encoded
+  // string with a length limit of 128 bytes.
+  //
+  // This field must be enabled before it can be used. [Learn
+  // more](/recommendations-ai/docs/catalog#item-group-id).
+  string item_group_id = 9 [(google.api.field_behavior) = OPTIONAL];
+
+  // Extra catalog item metadata for different recommendation types.
+  oneof recommendation_type {
+    // Optional. Metadata specific to retail products.
+    ProductCatalogItem product_metadata = 10 [(google.api.field_behavior) = OPTIONAL];
+  }
+}
+
+// ProductCatalogItem captures item metadata specific to retail products.
+message ProductCatalogItem {
+  // Exact product price.
+  message ExactPrice {
+    // Optional. Display price of the product.
+    float display_price = 1 [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. Price of the product without any discount. If zero, by default
+    // set to be the 'displayPrice'.
+    float original_price = 2 [(google.api.field_behavior) = OPTIONAL];
+  }
+
+  // Product price range when there are a range of prices for different
+  // variations of the same product.
+  message PriceRange {
+    // Required. The minimum product price.
+    float min = 1 [(google.api.field_behavior) = REQUIRED];
+
+    // Required. The maximum product price.
+    float max = 2 [(google.api.field_behavior) = REQUIRED];
+  }
+
+  // Item stock state. If this field is unspecified, the item is
+  // assumed to be in stock.
+  enum StockState {
+    option allow_alias = true;
+
+    // Default item stock status. Should never be used.
+    STOCK_STATE_UNSPECIFIED = 0;
+
+    // Item in stock.
+    IN_STOCK = 0;
+
+    // Item out of stock.
+    OUT_OF_STOCK = 1;
+
+    // Item that is in pre-order state.
+    PREORDER = 2;
+
+    // Item that is back-ordered (i.e. temporarily out of stock).
+    BACKORDER = 3;
+  }
+
+  // Product price. Only one of 'exactPrice'/'priceRange' can be provided.
+  oneof price {
+    // Optional. The exact product price.
+    ExactPrice exact_price = 1 [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. The product price range.
+    PriceRange price_range = 2 [(google.api.field_behavior) = OPTIONAL];
+  }
+
+  // Optional. A map to pass the costs associated with the product.
+  //
+  // For example:
+  // {"manufacturing": 45.5} The profit of selling this item is computed like
+  // so:
+  //
+  // * If 'exactPrice' is provided, profit = displayPrice - sum(costs)
+  // * If 'priceRange' is provided, profit = minPrice - sum(costs)
+  map costs = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Only required if the price is set. Currency code for price/costs. Use
+  // three-character ISO-4217 code.
+  string currency_code = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Online stock state of the catalog item. Default is `IN_STOCK`.
+  StockState stock_state = 5 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The available quantity of the item.
+  int64 available_quantity = 6 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Canonical URL directly linking to the item detail page with a
+  // length limit of 5 KiB..
+  string canonical_product_uri = 7 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Product images for the catalog item.
+  repeated Image images = 8 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Catalog item thumbnail/detail image.
+message Image {
+  // Required. URL of the image with a length limit of 5 KiB.
+  string uri = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Height of the image in number of pixels.
+  int32 height = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Width of the image in number of pixels.
+  int32 width = 3 [(google.api.field_behavior) = OPTIONAL];
+}
diff --git a/third_party/googleapis/google/cloud/recommendationengine/v1beta1/catalog_service.proto b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/catalog_service.proto
new file mode 100644
index 000000000..5d38d0c8d
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/catalog_service.proto
@@ -0,0 +1,199 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.recommendationengine.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/recommendationengine/v1beta1/catalog.proto";
+import "google/cloud/recommendationengine/v1beta1/import.proto";
+import "google/cloud/recommendationengine/v1beta1/recommendationengine_resources.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+
+option csharp_namespace = "Google.Cloud.RecommendationEngine.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/recommendationengine/v1beta1;recommendationengine";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.recommendationengine.v1beta1";
+option objc_class_prefix = "RECAI";
+option php_namespace = "Google\\Cloud\\RecommendationEngine\\V1beta1";
+option ruby_package = "Google::Cloud::RecommendationEngine::V1beta1";
+
+// Service for ingesting catalog information of the customer's website.
+service CatalogService {
+  option (google.api.default_host) = "recommendationengine.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform";
+
+  // Creates a catalog item.
+  rpc CreateCatalogItem(CreateCatalogItemRequest) returns (CatalogItem) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/locations/*/catalogs/*}/catalogItems"
+      body: "catalog_item"
+    };
+    option (google.api.method_signature) = "parent,catalog_item";
+  }
+
+  // Gets a specific catalog item.
+  rpc GetCatalogItem(GetCatalogItemRequest) returns (CatalogItem) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/locations/*/catalogs/*/catalogItems/**}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Gets a list of catalog items.
+  rpc ListCatalogItems(ListCatalogItemsRequest)
+      returns (ListCatalogItemsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/locations/*/catalogs/*}/catalogItems"
+    };
+    option (google.api.method_signature) = "parent,filter";
+  }
+
+  // Updates a catalog item. Partial updating is supported. Non-existing
+  // items will be created.
+  rpc UpdateCatalogItem(UpdateCatalogItemRequest) returns (CatalogItem) {
+    option (google.api.http) = {
+      patch: "/v1beta1/{name=projects/*/locations/*/catalogs/*/catalogItems/**}"
+      body: "catalog_item"
+    };
+    option (google.api.method_signature) = "name,catalog_item,update_mask";
+  }
+
+  // Deletes a catalog item.
+  rpc DeleteCatalogItem(DeleteCatalogItemRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/locations/*/catalogs/*/catalogItems/**}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Bulk import of multiple catalog items. Request processing may be
+  // synchronous. No partial updating supported. Non-existing items will be
+  // created.
+  //
+  // Operation.response is of type ImportResponse. Note that it is
+  // possible for a subset of the items to be successfully updated.
+  rpc ImportCatalogItems(ImportCatalogItemsRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/locations/*/catalogs/*}/catalogItems:import"
+      body: "*"
+    };
+    option (google.longrunning.operation_info) = {
+      response_type: "google.cloud.recommendationengine.v1beta1.ImportCatalogItemsResponse"
+      metadata_type: "google.cloud.recommendationengine.v1beta1.ImportMetadata"
+    };
+    option (google.api.method_signature) =
+        "parent,request_id,input_config,errors_config";
+  }
+}
+
+// Request message for CreateCatalogItem method.
+message CreateCatalogItemRequest {
+  // Required. The parent catalog resource name, such as
+  // "projects/*/locations/global/catalogs/default_catalog".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommendationengine.googleapis.com/Catalog"
+    }
+  ];
+
+  // Required. The catalog item to create.
+  CatalogItem catalog_item = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for GetCatalogItem method.
+message GetCatalogItemRequest {
+  // Required. Full resource name of catalog item, such as
+  // "projects/*/locations/global/catalogs/default_catalog/catalogitems/some_catalog_item_id".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommendationengine.googleapis.com/CatalogItemPath"
+    }
+  ];
+}
+
+// Request message for ListCatalogItems method.
+message ListCatalogItemsRequest {
+  // Required. The parent catalog resource name, such as
+  // "projects/*/locations/global/catalogs/default_catalog".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommendationengine.googleapis.com/Catalog"
+    }
+  ];
+
+  // Optional. Maximum number of results to return per page. If zero, the
+  // service will choose a reasonable default.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The previous ListCatalogItemsResponse.next_page_token.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A filter to apply on the list results.
+  string filter = 4 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response message for ListCatalogItems method.
+message ListCatalogItemsResponse {
+  // The catalog items.
+  repeated CatalogItem catalog_items = 1;
+
+  // If empty, the list is complete. If nonempty, the token to pass to the next
+  // request's ListCatalogItemRequest.page_token.
+  string next_page_token = 2;
+}
+
+// Request message for UpdateCatalogItem method.
+message UpdateCatalogItemRequest {
+  // Required. Full resource name of catalog item, such as
+  // "projects/*/locations/global/catalogs/default_catalog/catalogItems/some_catalog_item_id".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommendationengine.googleapis.com/CatalogItemPath"
+    }
+  ];
+
+  // Required. The catalog item to update/create. The 'catalog_item_id' field
+  // has to match that in the 'name'.
+  CatalogItem catalog_item = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Indicates which fields in the provided 'item' to update. If not
+  // set, will by default update all fields.
+  google.protobuf.FieldMask update_mask = 3;
+}
+
+// Request message for DeleteCatalogItem method.
+message DeleteCatalogItemRequest {
+  // Required. Full resource name of catalog item, such as
+  // "projects/*/locations/global/catalogs/default_catalog/catalogItems/some_catalog_item_id".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommendationengine.googleapis.com/CatalogItemPath"
+    }
+  ];
+}
diff --git a/third_party/googleapis/google/cloud/recommendationengine/v1beta1/common.proto b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/common.proto
new file mode 100644
index 000000000..1ca1bab87
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/common.proto
@@ -0,0 +1,63 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.recommendationengine.v1beta1;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.RecommendationEngine.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/recommendationengine/v1beta1;recommendationengine";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.recommendationengine.v1beta1";
+option objc_class_prefix = "RECAI";
+option php_namespace = "Google\\Cloud\\RecommendationEngine\\V1beta1";
+option ruby_package = "Google::Cloud::RecommendationEngine::V1beta1";
+
+// FeatureMap represents extra features that customers want to include in the
+// recommendation model for catalogs/user events as categorical/numerical
+// features.
+message FeatureMap {
+  // A list of string features.
+  message StringList {
+    // String feature value with a length limit of 128 bytes.
+    repeated string value = 1;
+  }
+
+  // A list of float features.
+  message FloatList {
+    // Float feature value.
+    repeated float value = 1;
+  }
+
+  // Categorical features that can take on one of a limited number of possible
+  // values. Some examples would be the brand/maker of a product, or country of
+  // a customer.
+  //
+  // Feature names and values must be UTF-8 encoded strings.
+  //
+  // For example: `{ "colors": {"value": ["yellow", "green"]},
+  //                 "sizes": {"value":["S", "M"]}`
+  map categorical_features = 1;
+
+  // Numerical features. Some examples would be the height/weight of a product,
+  // or age of a customer.
+  //
+  // Feature names must be UTF-8 encoded strings.
+  //
+  // For example: `{ "lengths_cm": {"value":[2.3, 15.4]},
+  //                 "heights_cm": {"value":[8.1, 6.4]} }`
+  map numerical_features = 2;
+}
diff --git a/third_party/googleapis/google/cloud/recommendationengine/v1beta1/import.proto b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/import.proto
new file mode 100644
index 000000000..fc288c36a
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/import.proto
@@ -0,0 +1,198 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.recommendationengine.v1beta1;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/recommendationengine/v1beta1/catalog.proto";
+import "google/cloud/recommendationengine/v1beta1/user_event.proto";
+import "google/cloud/recommendationengine/v1beta1/recommendationengine_resources.proto";
+import "google/protobuf/timestamp.proto";
+import "google/rpc/status.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.RecommendationEngine.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/recommendationengine/v1beta1;recommendationengine";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.recommendationengine.v1beta1";
+option objc_class_prefix = "RECAI";
+option php_namespace = "Google\\Cloud\\RecommendationEngine\\V1beta1";
+option ruby_package = "Google::Cloud::RecommendationEngine::V1beta1";
+
+// Google Cloud Storage location for input content.
+// format.
+message GcsSource {
+  // Required. Google Cloud Storage URIs to input files. URI can be up to
+  // 2000 characters long. URIs can match the full object path (for example,
+  // gs://bucket/directory/object.json) or a pattern matching one or more
+  // files, such as gs://bucket/directory/*.json. A request can
+  // contain at most 100 files, and each file can be up to 2 GB. See
+  // [Importing catalog information](/recommendations-ai/docs/upload-catalog)
+  // for the expected file format and setup instructions.
+  repeated string input_uris = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The inline source for the input config for ImportCatalogItems method.
+message CatalogInlineSource {
+  // Optional. A list of catalog items to update/create. Recommended max of 10k
+  // items.
+  repeated CatalogItem catalog_items = 1
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// The inline source for the input config for ImportUserEvents method.
+message UserEventInlineSource {
+  // Optional. A list of user events to import. Recommended max of 10k items.
+  repeated UserEvent user_events = 1 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Configuration of destination for Import related errors.
+message ImportErrorsConfig {
+  // Required. Errors destination.
+  oneof destination {
+    // Google Cloud Storage path for import errors. This must be an empty,
+    // existing Cloud Storage bucket. Import errors will be written to a file in
+    // this bucket, one per line, as a JSON-encoded
+    // `google.rpc.Status` message.
+    string gcs_prefix = 1;
+  }
+}
+
+// Request message for Import methods.
+message ImportCatalogItemsRequest {
+  // Required. "projects/1234/locations/global/catalogs/default_catalog"
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommendationengine.googleapis.com/Catalog"
+    }
+  ];
+
+  // Optional. Unique identifier provided by client, within the ancestor
+  // dataset scope. Ensures idempotency and used for request deduplication.
+  // Server-generated if unspecified. Up to 128 characters long. This is
+  // returned as google.longrunning.Operation.name in the response.
+  string request_id = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. The desired input location of the data.
+  InputConfig input_config = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The desired location of errors incurred during the Import.
+  ImportErrorsConfig errors_config = 4 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Request message for the ImportUserEvents request.
+message ImportUserEventsRequest {
+  // Required.
+  // "projects/1234/locations/global/catalogs/default_catalog/eventStores/default_event_store"
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommendationengine.googleapis.com/EventStore"
+    }
+  ];
+
+  // Optional. Unique identifier provided by client, within the ancestor
+  // dataset scope. Ensures idempotency for expensive long running operations.
+  // Server-generated if unspecified. Up to 128 characters long. This is
+  // returned as google.longrunning.Operation.name in the response. Note that
+  // this field must not be set if the desired input config is
+  // catalog_inline_source.
+  string request_id = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. The desired input location of the data.
+  InputConfig input_config = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The desired location of errors incurred during the Import.
+  ImportErrorsConfig errors_config = 4 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// The input config source.
+message InputConfig {
+  // Required. The source of the input.
+  oneof source {
+    // The Inline source for the input content for Catalog items.
+    CatalogInlineSource catalog_inline_source = 1;
+
+    // Google Cloud Storage location for the input content.
+    GcsSource gcs_source = 2;
+
+    // The Inline source for the input content for UserEvents.
+    UserEventInlineSource user_event_inline_source = 3;
+  }
+}
+
+// Metadata related to the progress of the Import operation. This will be
+// returned by the google.longrunning.Operation.metadata field.
+message ImportMetadata {
+  // Name of the operation.
+  string operation_name = 5;
+
+  // Id of the request / operation. This is parroting back the requestId that
+  // was passed in the request.
+  string request_id = 3;
+
+  // Operation create time.
+  google.protobuf.Timestamp create_time = 4;
+
+  // Count of entries that were processed successfully.
+  int64 success_count = 1;
+
+  // Count of entries that encountered errors while processing.
+  int64 failure_count = 2;
+
+  // Operation last update time. If the operation is done, this is also the
+  // finish time.
+  google.protobuf.Timestamp update_time = 6;
+}
+
+// Response of the ImportCatalogItemsRequest. If the long running
+// operation is done, then this message is returned by the
+// google.longrunning.Operations.response field if the operation was successful.
+message ImportCatalogItemsResponse {
+  // A sample of errors encountered while processing the request.
+  repeated google.rpc.Status error_samples = 1;
+
+  // Echoes the destination for the complete errors in the request if set.
+  ImportErrorsConfig errors_config = 2;
+}
+
+// Response of the ImportUserEventsRequest. If the long running
+// operation was successful, then this message is returned by the
+// google.longrunning.Operations.response field if the operation was successful.
+message ImportUserEventsResponse {
+  // A sample of errors encountered while processing the request.
+  repeated google.rpc.Status error_samples = 1;
+
+  // Echoes the destination for the complete errors if this field was set in
+  // the request.
+  ImportErrorsConfig errors_config = 2;
+
+  // Aggregated statistics of user event import status.
+  UserEventImportSummary import_summary = 3;
+}
+
+// A summary of import result. The UserEventImportSummary summarizes
+// the import status for user events.
+message UserEventImportSummary {
+  // Count of user events imported with complete existing catalog information.
+  int64 joined_events_count = 1;
+
+  // Count of user events imported, but with catalog information not found
+  // in the imported catalog.
+  int64 unjoined_events_count = 2;
+}
diff --git a/third_party/googleapis/google/cloud/recommendationengine/v1beta1/prediction_apikey_registry_service.proto b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/prediction_apikey_registry_service.proto
new file mode 100644
index 000000000..2dbc98e64
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/prediction_apikey_registry_service.proto
@@ -0,0 +1,138 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.recommendationengine.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/protobuf/empty.proto";
+import "google/api/client.proto";
+import "google/cloud/recommendationengine/v1beta1/recommendationengine_resources.proto";
+
+option csharp_namespace = "Google.Cloud.RecommendationEngine.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/recommendationengine/v1beta1;recommendationengine";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.recommendationengine.v1beta1";
+option objc_class_prefix = "RECAI";
+option php_namespace = "Google\\Cloud\\RecommendationEngine\\V1beta1";
+option ruby_package = "Google::Cloud::RecommendationEngine::V1beta1";
+
+// Service for registering API keys for use with the `predict` method. If you
+// use an API key to request predictions, you must first register the API key.
+// Otherwise, your prediction request is rejected. If you use OAuth to
+// authenticate your `predict` method call, you do not need to register an API
+// key. You can register up to 20 API keys per project.
+service PredictionApiKeyRegistry {
+  option (google.api.default_host) = "recommendationengine.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform";
+
+  // Register an API key for use with predict method.
+  rpc CreatePredictionApiKeyRegistration(
+      CreatePredictionApiKeyRegistrationRequest)
+      returns (PredictionApiKeyRegistration) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/locations/*/catalogs/*/eventStores/*}/predictionApiKeyRegistrations"
+      body: "*"
+    };
+    option (google.api.method_signature) =
+        "parent,prediction_api_key_registration";
+  }
+
+  // List the registered apiKeys for use with predict method.
+  rpc ListPredictionApiKeyRegistrations(
+      ListPredictionApiKeyRegistrationsRequest)
+      returns (ListPredictionApiKeyRegistrationsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/locations/*/catalogs/*/eventStores/*}/predictionApiKeyRegistrations"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Unregister an apiKey from using for predict method.
+  rpc DeletePredictionApiKeyRegistration(
+      DeletePredictionApiKeyRegistrationRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/locations/*/catalogs/*/eventStores/*/predictionApiKeyRegistrations/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+}
+
+// Registered Api Key.
+message PredictionApiKeyRegistration {
+  // The API key.
+  string api_key = 1;
+}
+
+// Request message for the `CreatePredictionApiKeyRegistration` method.
+message CreatePredictionApiKeyRegistrationRequest {
+  // Required. The parent resource path.
+  // "projects/*/locations/global/catalogs/default_catalog/eventStores/default_event_store".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommendationengine.googleapis.com/EventStore"
+    }
+  ];
+
+  // Required. The prediction API key registration.
+  PredictionApiKeyRegistration prediction_api_key_registration = 2
+      [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for the `ListPredictionApiKeyRegistrations`.
+message ListPredictionApiKeyRegistrationsRequest {
+  // Required. The parent placement resource name such as
+  // "projects/1234/locations/global/catalogs/default_catalog/eventStores/default_event_store"
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommendationengine.googleapis.com/EventStore"
+    }
+  ];
+
+  // Optional. Maximum number of results to return per page. If unset, the
+  // service will choose a reasonable default.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The previous `ListPredictionApiKeyRegistration.nextPageToken`.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response message for the `ListPredictionApiKeyRegistrations`.
+message ListPredictionApiKeyRegistrationsResponse {
+  // The list of registered API keys.
+  repeated PredictionApiKeyRegistration prediction_api_key_registrations = 1;
+
+  // If empty, the list is complete. If nonempty, pass the token to the next
+  // request's `ListPredictionApiKeysRegistrationsRequest.pageToken`.
+  string next_page_token = 2;
+}
+
+// Request message for `DeletePredictionApiKeyRegistration` method.
+message DeletePredictionApiKeyRegistrationRequest {
+  // Required. The API key to unregister including full resource path.
+  // "projects/*/locations/global/catalogs/default_catalog/eventStores/default_event_store/predictionApiKeyRegistrations/"
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommendationengine.googleapis.com/PredictionApiKeyRegistration"
+    }
+  ];
+}
diff --git a/third_party/googleapis/google/cloud/recommendationengine/v1beta1/prediction_service.proto b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/prediction_service.proto
new file mode 100644
index 000000000..1f5e77f4d
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/prediction_service.proto
@@ -0,0 +1,198 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.recommendationengine.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/recommendationengine/v1beta1/user_event.proto";
+import "google/protobuf/struct.proto";
+import "google/api/client.proto";
+
+option csharp_namespace = "Google.Cloud.RecommendationEngine.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/recommendationengine/v1beta1;recommendationengine";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.recommendationengine.v1beta1";
+option objc_class_prefix = "RECAI";
+option php_namespace = "Google\\Cloud\\RecommendationEngine\\V1beta1";
+option ruby_package = "Google::Cloud::RecommendationEngine::V1beta1";
+
+// Service for making recommendation prediction.
+service PredictionService {
+  option (google.api.default_host) = "recommendationengine.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform";
+
+  // Makes a recommendation prediction. If using API Key based authentication,
+  // the API Key must be registered using the
+  // [PredictionApiKeyRegistry][google.cloud.recommendationengine.v1beta1.PredictionApiKeyRegistry]
+  // service. [Learn more](/recommendations-ai/docs/setting-up#register-key).
+  rpc Predict(PredictRequest) returns (PredictResponse) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/catalogs/*/eventStores/*/placements/*}:predict"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name,user_event";
+  }
+}
+
+// Request message for Predict method.
+message PredictRequest {
+  // Required. Full resource name of the format:
+  // {name=projects/*/locations/global/catalogs/default_catalog/eventStores/default_event_store/placements/*}
+  // The id of the recommendation engine placement. This id is used to identify
+  // the set of models that will be used to make the prediction.
+  //
+  // We currently support three placements with the following IDs by default:
+  //
+  // * `shopping_cart`: Predicts items frequently bought together with one or
+  //   more catalog items in the same shopping session. Commonly displayed after
+  //   `add-to-cart` events, on product detail pages, or on the shopping cart
+  //   page.
+  //
+  // * `home_page`: Predicts the next product that a user will most likely
+  //   engage with or purchase based on the shopping or viewing history of the
+  //   specified `userId` or `visitorId`. For example - Recommendations for you.
+  //
+  // * `product_detail`: Predicts the next product that a user will most likely
+  //   engage with or purchase. The prediction is based on the shopping or
+  //   viewing history of the specified `userId` or `visitorId` and its
+  //   relevance to a specified `CatalogItem`. Typically used on product detail
+  //   pages. For example - More items like this.
+  //
+  // * `recently_viewed_default`: Returns up to 75 items recently viewed by the
+  //   specified `userId` or `visitorId`, most recent ones first. Returns
+  //   nothing if neither of them has viewed any items yet. For example -
+  //   Recently viewed.
+  //
+  // The full list of available placements can be seen at
+  // https://console.cloud.google.com/recommendation/datafeeds/default_catalog/dashboard
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommendationengine.googleapis.com/Placement"
+    }
+  ];
+
+  // Required. Context about the user, what they are looking at and what action
+  // they took to trigger the predict request. Note that this user event detail
+  // won't be ingested to userEvent logs. Thus, a separate userEvent write
+  // request is required for event logging.
+  UserEvent user_event = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Maximum number of results to return per page. Set this property
+  // to the number of prediction results required. If zero, the service will
+  // choose a reasonable default.
+  int32 page_size = 7 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The previous PredictResponse.next_page_token.
+  string page_token = 8 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Filter for restricting prediction results. Accepts values for
+  // tags and the `filterOutOfStockItems` flag.
+  //
+  //  * Tag expressions. Restricts predictions to items that match all of the
+  //    specified tags. Boolean operators `OR` and `NOT` are supported if the
+  //    expression is enclosed in parentheses, and must be separated from the
+  //    tag values by a space. `-"tagA"` is also supported and is equivalent to
+  //    `NOT "tagA"`. Tag values must be double quoted UTF-8 encoded strings
+  //    with a size limit of 1 KiB.
+  //
+  //  * filterOutOfStockItems. Restricts predictions to items that do not have a
+  //    stockState value of OUT_OF_STOCK.
+  //
+  // Examples:
+  //
+  //  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
+  //  * filterOutOfStockItems  tag=(-"promotional")
+  //  * filterOutOfStockItems
+  string filter = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Use dryRun mode for this prediction query. If set to true, a
+  // dummy model will be used that returns arbitrary catalog items.
+  // Note that the dryRun mode should only be used for testing the API, or if
+  // the model is not ready.
+  bool dry_run = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Additional domain specific parameters for the predictions.
+  //
+  // Allowed values:
+  //
+  // * `returnCatalogItem`: Boolean. If set to true, the associated catalogItem
+  //    object will be returned in the
+  //   `PredictResponse.PredictionResult.itemMetadata` object in the method
+  //    response.
+  // * `returnItemScore`: Boolean. If set to true, the prediction 'score'
+  //    corresponding to each returned item will be set in the `metadata`
+  //    field in the prediction response. The given 'score' indicates the
+  //    probability of an item being clicked/purchased given the user's context
+  //    and history.
+  map params = 6
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The labels for the predict request.
+  //
+  //  * Label keys can contain lowercase letters, digits and hyphens, must start
+  //    with a letter, and must end with a letter or digit.
+  //  * Non-zero label values can contain lowercase letters, digits and hyphens,
+  //    must start with a letter, and must end with a letter or digit.
+  //  * No more than 64 labels can be associated with a given request.
+  //
+  // See https://goo.gl/xmQnxf for more information on and examples of labels.
+  map labels = 9 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response message for predict method.
+message PredictResponse {
+  // PredictionResult represents the recommendation prediction results.
+  message PredictionResult {
+    // ID of the recommended catalog item
+    string id = 1;
+
+    // Additional item metadata / annotations.
+    //
+    // Possible values:
+    //
+    // * `catalogItem`: JSON representation of the catalogItem. Will be set if
+    //   `returnCatalogItem` is set to true in `PredictRequest.params`.
+    // * `score`: Prediction score in double value. Will be set if
+    //   `returnItemScore` is set to true in `PredictRequest.params`.
+    map item_metadata = 2;
+  }
+
+  // A list of recommended items. The order represents the ranking (from the
+  // most relevant item to the least).
+  repeated PredictionResult results = 1;
+
+  // A unique recommendation token. This should be included in the user event
+  // logs resulting from this recommendation, which enables accurate attribution
+  // of recommendation model performance.
+  string recommendation_token = 2;
+
+  // IDs of items in the request that were missing from the catalog.
+  repeated string items_missing_in_catalog = 3;
+
+  // True if the dryRun property was set in the request.
+  bool dry_run = 4;
+
+  // Additional domain specific prediction response metadata.
+  map metadata = 5;
+
+  // If empty, the list is complete. If nonempty, the token to pass to the next
+  // request's PredictRequest.page_token.
+  string next_page_token = 6;
+}
diff --git a/third_party/googleapis/google/devtools/resultstore/v2/resultstore_gapic.yaml b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/recommendationengine_gapic.legacy.yaml
similarity index 60%
rename from third_party/googleapis/google/devtools/resultstore/v2/resultstore_gapic.yaml
rename to third_party/googleapis/google/cloud/recommendationengine/v1beta1/recommendationengine_gapic.legacy.yaml
index fadd4131e..90910159f 100644
--- a/third_party/googleapis/google/devtools/resultstore/v2/resultstore_gapic.yaml
+++ b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/recommendationengine_gapic.legacy.yaml
@@ -3,23 +3,23 @@ config_schema_version: 1.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
-    package_name: com.google.cloud.devtools.resultstore.v2
+    package_name: com.google.cloud.recommendationengine.v1beta1
   python:
-    package_name: google.cloud.devtools.resultstore_v2.gapic
+    package_name: google.cloud.recommendationengine_v1beta1.gapic
   go:
-    package_name: cloud.google.com/go/devtools/resultstore/apiv2
+    package_name: cloud.google.com/go/recommendationengine/apiv1beta1
   csharp:
-    package_name: Google.Devtools.Resultstore.V2
+    package_name: Google.Cloud.Recommendationengine.V1beta1
   ruby:
-    package_name: Google::Cloud::Devtools::Resultstore::V2
+    package_name: Google::Cloud::Recommendationengine::V1beta1
   php:
-    package_name: Google\Cloud\Devtools\Resultstore\V2
+    package_name: Google\Cloud\Recommendationengine\V1beta1
   nodejs:
-    package_name: resultstore.v2
+    package_name: recommendationengine.v1beta1
 # A list of API interface configurations.
 interfaces:
-  # The fully qualified name of the API interface.
-- name: google.devtools.resultstore.v2.ResultStoreDownload
+# The fully qualified name of the API interface.
+- name: google.cloud.recommendationengine.v1beta1.CatalogService
   # A list of resource collection configurations.
   # Consists of a name_pattern and an entity_name.
   # The name_pattern is a pattern to describe the names of the resources of this
@@ -31,24 +31,16 @@ interfaces:
   # The entity_name is the name to be used as a basis for generated methods and
   # classes.
   collections:
-  - name_pattern: invocations/{invocation}
-    entity_name: invocation
-  - name_pattern: invocations/{invocation}/configs/{config}
-    entity_name: config
-  - name_pattern: invocations/{invocation}/fileSets/{file_set}
-    entity_name: file_set
-  - name_pattern: invocations/{invocation}/targets/{target}
-    entity_name: target
-  - name_pattern: invocations/{invocation}/targets/{target}/configuredTargets/{configured_target}
-    entity_name: configured_target
-  - name_pattern: invocations/{invocation}/targets/{target}/configuredTargets/{configured_target}/actions/{action}
-    entity_name: action
+  - name_pattern: projects/{project}/locations/{location}/catalogs/{catalog}
+    entity_name: catalog
+  - name_pattern: projects/{project}/locations/{location}/catalogs/{catalog}/catalogItems/{catalog_item_path=**}
+    entity_name: catalog_item_path
   # Definition for retryable codes.
   retry_codes_def:
   - name: idempotent
     retry_codes:
-    - UNAVAILABLE
     - DEADLINE_EXCEEDED
+    - UNAVAILABLE
   - name: non_idempotent
     retry_codes: []
   # Definition for retry/backoff parameters.
@@ -77,15 +69,6 @@ interfaces:
   #   required_fields - Fields that are always required for a request to be
   #   valid.
   #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
   #   page_streaming - Specifies the configuration for paging.
   #   Describes information for generating a method which transforms a paging
   #   list RPC into a stream of resources.
@@ -116,38 +99,21 @@ interfaces:
   #   timeout_millis - Specifies the default timeout for a non-retrying call. If
   #   the call is retrying, refer to retry_params_name instead.
   methods:
-  - name: GetInvocation
+  - name: CreateCatalogItem
     flattening:
       groups:
       - parameters:
-        - name
+        - parent
+        - catalog_item
     required_fields:
-    - name
-    retry_codes_name: idempotent
+    - parent
+    - catalog_item
+    retry_codes_name: non_idempotent
     retry_params_name: default
     field_name_patterns:
-      name: invocation
+      parent: catalog
     timeout_millis: 60000
-  - name: SearchInvocations
-    flattening:
-      groups:
-      - parameters:
-        - query
-        - project_id
-    required_fields:
-    - query
-    - project_id
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: invocations
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-  - name: GetConfiguration
+  - name: GetCatalogItem
     flattening:
       groups:
       - parameters:
@@ -157,13 +123,14 @@ interfaces:
     retry_codes_name: idempotent
     retry_params_name: default
     field_name_patterns:
-      name: config
+      name: catalog_item_path
     timeout_millis: 60000
-  - name: ListConfigurations
+  - name: ListCatalogItems
     flattening:
       groups:
       - parameters:
         - parent
+        - filter
     required_fields:
     - parent
     page_streaming:
@@ -172,44 +139,27 @@ interfaces:
         token_field: page_token
       response:
         token_field: next_page_token
-        resources_field: configurations
+        resources_field: catalog_items
     retry_codes_name: idempotent
     retry_params_name: default
     field_name_patterns:
-      parent: invocation
-    timeout_millis: 60000
-  - name: GetTarget
+      parent: catalog
+    timeout_millis: 300000
+  - name: UpdateCatalogItem
     flattening:
       groups:
       - parameters:
         - name
+        - catalog_item
     required_fields:
     - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: target
-    timeout_millis: 60000
-  - name: ListTargets
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: targets
-    retry_codes_name: idempotent
+    - catalog_item
+    retry_codes_name: non_idempotent
     retry_params_name: default
     field_name_patterns:
-      parent: invocation
+      name: catalog_item_path
     timeout_millis: 60000
-  - name: GetConfiguredTarget
+  - name: DeleteCatalogItem
     flattening:
       groups:
       - parameters:
@@ -219,40 +169,127 @@ interfaces:
     retry_codes_name: idempotent
     retry_params_name: default
     field_name_patterns:
-      name: configured_target
+      name: catalog_item_path
     timeout_millis: 60000
-  - name: ListConfiguredTargets
+  - name: ImportCatalogItems
     flattening:
       groups:
       - parameters:
         - parent
+        - request_id
+        - input_config
+        - errors_config
     required_fields:
     - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: configured_targets
-    retry_codes_name: idempotent
+    - input_config
+    retry_codes_name: non_idempotent
     retry_params_name: default
     field_name_patterns:
-      parent: target
-    timeout_millis: 60000
-  - name: GetAction
+      parent: catalog
+    long_running:
+      return_type: google.cloud.recommendationengine.v1beta1.ImportCatalogItemsResponse
+      metadata_type: google.cloud.recommendationengine.v1beta1.ImportMetadata
+      initial_poll_delay_millis: 500
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 5000
+      total_poll_timeout_millis: 300000
+    timeout_millis: 300000
+# The fully qualified name of the API interface.
+- name: google.cloud.recommendationengine.v1beta1.PredictionApiKeyRegistry
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}/locations/{location}/catalogs/{catalog}/eventStores/{event_store}
+    entity_name: event_store
+  - name_pattern: projects/{project}/locations/{location}/catalogs/{catalog}/eventStores/{event_store}/predictionApiKeyRegistrations/{prediction_api_key_registration}
+    entity_name: prediction_api_key_registration
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: CreatePredictionApiKeyRegistration
     flattening:
       groups:
       - parameters:
-        - name
+        - parent
+        - prediction_api_key_registration
     required_fields:
-    - name
-    retry_codes_name: idempotent
+    - parent
+    - prediction_api_key_registration
+    retry_codes_name: non_idempotent
     retry_params_name: default
     field_name_patterns:
-      name: action
+      parent: event_store
     timeout_millis: 60000
-  - name: ListActions
+  - name: ListPredictionApiKeyRegistrations
     flattening:
       groups:
       - parameters:
@@ -265,13 +302,13 @@ interfaces:
         token_field: page_token
       response:
         token_field: next_page_token
-        resources_field: actions
+        resources_field: prediction_api_key_registrations
     retry_codes_name: idempotent
     retry_params_name: default
     field_name_patterns:
-      parent: configured_target
+      parent: event_store
     timeout_millis: 60000
-  - name: GetFileSet
+  - name: DeletePredictionApiKeyRegistration
     flattening:
       groups:
       - parameters:
@@ -281,29 +318,10 @@ interfaces:
     retry_codes_name: idempotent
     retry_params_name: default
     field_name_patterns:
-      name: file_set
+      name: prediction_api_key_registration
     timeout_millis: 60000
-  - name: ListFileSets
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: file_sets
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: invocation
-    timeout_millis: 60000
-  # The fully qualified name of the API interface.
-- name: google.devtools.resultstore.v2.ResultStoreFileDownload
+# The fully qualified name of the API interface.
+- name: google.cloud.recommendationengine.v1beta1.PredictionService
   # A list of resource collection configurations.
   # Consists of a name_pattern and an entity_name.
   # The name_pattern is a pattern to describe the names of the resources of this
@@ -315,16 +333,14 @@ interfaces:
   # The entity_name is the name to be used as a basis for generated methods and
   # classes.
   collections:
-  - name_pattern: file/tail/{tail}
-    entity_name: tail
-  - name_pattern: file/{file}
-    entity_name: file
+  - name_pattern: projects/{project}/locations/{location}/catalogs/{catalog}/eventStores/{event_store}/placements/{placement}
+    entity_name: placement
   # Definition for retryable codes.
   retry_codes_def:
   - name: idempotent
     retry_codes:
-    - UNAVAILABLE
     - DEADLINE_EXCEEDED
+    - UNAVAILABLE
   - name: non_idempotent
     retry_codes: []
   # Definition for retry/backoff parameters.
@@ -353,15 +369,6 @@ interfaces:
   #   required_fields - Fields that are always required for a request to be
   #   valid.
   #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
   #   page_streaming - Specifies the configuration for paging.
   #   Describes information for generating a method which transforms a paging
   #   list RPC into a stream of resources.
@@ -392,36 +399,24 @@ interfaces:
   #   timeout_millis - Specifies the default timeout for a non-retrying call. If
   #   the call is retrying, refer to retry_params_name instead.
   methods:
-  - name: GetFile
-    flattening:
-      groups:
-      - parameters:
-        - uri
-        - read_offset
-        - read_limit
+  - name: Predict
     required_fields:
-    - uri
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      uri: file
-    timeout_millis: 60000
-  - name: GetFileTail
-    flattening:
-      groups:
-      - parameters:
-        - uri
-        - read_offset
-        - read_limit
-    required_fields:
-    - uri
-    retry_codes_name: idempotent
+    - name
+    - user_event
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: results
+    retry_codes_name: non_idempotent
     retry_params_name: default
     field_name_patterns:
-      uri: tail
+      name: placement
     timeout_millis: 60000
 # The fully qualified name of the API interface.
-- name: google.devtools.resultstore.v2.ResultStoreUpload
+- name: google.cloud.recommendationengine.v1beta1.UserEventService
   # A list of resource collection configurations.
   # Consists of a name_pattern and an entity_name.
   # The name_pattern is a pattern to describe the names of the resources of this
@@ -433,18 +428,8 @@ interfaces:
   # The entity_name is the name to be used as a basis for generated methods and
   # classes.
   collections:
-  - name_pattern: invocations/{invocation}
-    entity_name: invocation
-  - name_pattern: invocations/{invocation}/configs/{config}
-    entity_name: config
-  - name_pattern: invocations/{invocation}/fileSets/{file_set}
-    entity_name: file_set
-  - name_pattern: invocations/{invocation}/targets/{target}
-    entity_name: target
-  - name_pattern: invocations/{invocation}/targets/{target}/configuredTargets/{configured_target}
-    entity_name: configured_target
-  - name_pattern: invocations/{invocation}/targets/{target}/configuredTargets/{configured_target}/actions/{action}
-    entity_name: action
+  - name_pattern: projects/{project}/locations/{location}/catalogs/{catalog}/eventStores/{event_store}
+    entity_name: event_store
   # Definition for retryable codes.
   retry_codes_def:
   - name: idempotent
@@ -479,15 +464,6 @@ interfaces:
   #   required_fields - Fields that are always required for a request to be
   #   valid.
   #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
   #   page_streaming - Specifies the configuration for paging.
   #   Describes information for generating a method which transforms a paging
   #   list RPC into a stream of resources.
@@ -518,204 +494,98 @@ interfaces:
   #   timeout_millis - Specifies the default timeout for a non-retrying call. If
   #   the call is retrying, refer to retry_params_name instead.
   methods:
-  - name: CreateInvocation
-    required_fields:
-    - request_id
-    - invocation
-    - authorization_token
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-  - name: UpdateInvocation
-    flattening:
-      groups:
-      - parameters:
-        - update_mask
-        - authorization_token
-    required_fields:
-    - invocation
-    - update_mask
-    - authorization_token
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      invocation.name: invocation
-    timeout_millis: 60000
-  - name: FinishInvocation
+  - name: WriteUserEvent
     flattening:
       groups:
       - parameters:
-        - name
-        - authorization_token
-    required_fields:
-    - name
-    - authorization_token
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: invocation
-    timeout_millis: 60000
-  - name: CreateTarget
+        - parent
+        - user_event
     required_fields:
-    - request_id
     - parent
-    - target_id
-    - target
-    - authorization_token
+    - user_event
     retry_codes_name: non_idempotent
     retry_params_name: default
     field_name_patterns:
-      parent: invocation
-    timeout_millis: 60000
-  - name: UpdateTarget
-    flattening:
-      groups:
-      - parameters:
-        - update_mask
-        - authorization_token
-    required_fields:
-    - target
-    - update_mask
-    - authorization_token
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      target.name: target
+      parent: event_store
     timeout_millis: 60000
-  - name: FinishTarget
+  - name: CollectUserEvent
     flattening:
       groups:
       - parameters:
-        - name
-        - authorization_token
-    required_fields:
-    - name
-    - authorization_token
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: target
-    timeout_millis: 60000
-  - name: CreateConfiguredTarget
+        - parent
+        - user_event
+        - uri
+        - ets
     required_fields:
-    - request_id
     - parent
-    - config_id
-    - configured_target
-    - authorization_token
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: target
-    timeout_millis: 60000
-  - name: UpdateConfiguredTarget
-    flattening:
-      groups:
-      - parameters:
-        - update_mask
-        - authorization_token
-    required_fields:
-    - configured_target
-    - update_mask
-    - authorization_token
+    - user_event
     retry_codes_name: idempotent
     retry_params_name: default
     field_name_patterns:
-      configured_target.name: configured_target
+      parent: event_store
     timeout_millis: 60000
-  - name: FinishConfiguredTarget
+  - name: ListUserEvents
     flattening:
       groups:
       - parameters:
-        - name
-        - authorization_token
-    required_fields:
-    - name
-    - authorization_token
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: configured_target
-    timeout_millis: 60000
-  - name: CreateAction
+        - parent
+        - filter
     required_fields:
-    - request_id
     - parent
-    - action_id
-    - action
-    - authorization_token
-    retry_codes_name: non_idempotent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: user_events
+    retry_codes_name: idempotent
     retry_params_name: default
     field_name_patterns:
-      parent: configured_target
-    timeout_millis: 60000
-  - name: UpdateAction
+      parent: event_store
+    timeout_millis: 300000
+  - name: PurgeUserEvents
     flattening:
       groups:
       - parameters:
-        - update_mask
-        - authorization_token
-    required_fields:
-    - action
-    - update_mask
-    - authorization_token
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      action.name: action
-    timeout_millis: 60000
-  - name: CreateConfiguration
+        - parent
+        - filter
+        - force
     required_fields:
-    - request_id
     - parent
-    - config_id
-    - configuration
-    - authorization_token
+    - filter
     retry_codes_name: non_idempotent
     retry_params_name: default
     field_name_patterns:
-      parent: invocation
+      parent: event_store
+    long_running:
+      return_type: google.cloud.recommendationengine.v1beta1.PurgeUserEventsResponse
+      metadata_type: google.cloud.recommendationengine.v1beta1.PurgeUserEventsMetadata
+      initial_poll_delay_millis: 500
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 5000
+      total_poll_timeout_millis: 300000
     timeout_millis: 60000
-  - name: UpdateConfiguration
+  - name: ImportUserEvents
     flattening:
       groups:
       - parameters:
-        - update_mask
-        - authorization_token
-    required_fields:
-    - configuration
-    - update_mask
-    - authorization_token
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      configuration.name: config
-    timeout_millis: 60000
-  - name: CreateFileSet
+        - parent
+        - request_id
+        - input_config
+        - errors_config
     required_fields:
-    - request_id
     - parent
-    - file_set_id
-    - file_set
-    - authorization_token
+    - input_config
     retry_codes_name: non_idempotent
     retry_params_name: default
     field_name_patterns:
-      parent: invocation
-    timeout_millis: 60000
-  - name: UpdateFileSet
-    flattening:
-      groups:
-      - parameters:
-        - update_mask
-        - authorization_token
-    required_fields:
-    - file_set
-    - update_mask
-    - authorization_token
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      file_set.name: file_set
-    timeout_millis: 60000
-
+      parent: event_store
+    long_running:
+      return_type: google.cloud.recommendationengine.v1beta1.ImportUserEventsResponse
+      metadata_type: google.cloud.recommendationengine.v1beta1.ImportMetadata
+      initial_poll_delay_millis: 500
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 5000
+      total_poll_timeout_millis: 300000
+    timeout_millis: 300000
diff --git a/third_party/googleapis/google/cloud/recommendationengine/v1beta1/recommendationengine_gapic.yaml b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/recommendationengine_gapic.yaml
new file mode 100644
index 000000000..385c7da70
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/recommendationengine_gapic.yaml
@@ -0,0 +1,53 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 2.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.recommendationengine.v1beta1
+  python:
+    package_name: google.cloud.recommendationengine_v1beta1.gapic
+  go:
+    package_name: cloud.google.com/go/recommendationengine/apiv1beta1
+  csharp:
+    package_name: Google.Cloud.Recommendationengine.V1beta1
+  ruby:
+    package_name: Google::Cloud::Recommendationengine::V1beta1
+  php:
+    package_name: Google\Cloud\Recommendationengine\V1beta1
+  nodejs:
+    package_name: recommendationengine.v1beta1
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: google.cloud.recommendationengine.v1beta1.CatalogService
+  methods:
+  - name: DeleteCatalogItem
+    retry_codes_name: idempotent
+  - name: ImportCatalogItems
+    long_running:
+      initial_poll_delay_millis: 500
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 5000
+      total_poll_timeout_millis: 300000
+
+- name: google.cloud.recommendationengine.v1beta1.PredictionApiKeyRegistry
+  methods:
+  - name: DeletePredictionApiKeyRegistration
+    retry_codes_name: idempotent
+
+- name: google.cloud.recommendationengine.v1beta1.PredictionService
+
+- name: google.cloud.recommendationengine.v1beta1.UserEventService
+  methods:
+  - name: PurgeUserEvents
+    long_running:
+      initial_poll_delay_millis: 500
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 5000
+      total_poll_timeout_millis: 300000
+  - name: ImportUserEvents
+    long_running:
+      initial_poll_delay_millis: 500
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 5000
+      total_poll_timeout_millis: 300000
diff --git a/third_party/googleapis/google/cloud/recommendationengine/v1beta1/recommendationengine_grpc_service_config.json b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/recommendationengine_grpc_service_config.json
new file mode 100644
index 000000000..f3516f741
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/recommendationengine_grpc_service_config.json
@@ -0,0 +1,78 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "com.google.cloud.recommendationengine.v1beta1.CatalogService",
+          "method": "CreateCatalogItem"
+        },
+        {
+          "service": "com.google.cloud.recommendationengine.v1beta1.CatalogService",
+          "method": "GetCatalogItem"
+        },
+        {
+          "service": "com.google.cloud.recommendationengine.v1beta1.CatalogService",
+          "method": "ListCatalogItems"
+        },
+        {
+          "service": "com.google.cloud.recommendationengine.v1beta1.CatalogService",
+          "method": "UpdateCatalogItem"
+        },
+        {
+          "service": "com.google.cloud.recommendationengine.v1beta1.CatalogService",
+          "method": "DeleteCatalogItem"
+        },
+        {
+          "service": "com.google.cloud.recommendationengine.v1beta1.CatalogService",
+          "method": "ImportCatalogItems"
+        },
+        {
+          "service": "com.google.cloud.recommendationengine.v1beta1.PredictionApiKeyRegistry",
+          "method": "CreatePredictionApiKeyRegistration"
+        },
+        {
+          "service": "com.google.cloud.recommendationengine.v1beta1.PredictionApiKeyRegistry",
+          "method": "ListPredictionApiKeyRegistrations"
+        },
+        {
+          "service": "com.google.cloud.recommendationengine.v1beta1.PredictionApiKeyRegistry",
+          "method": "DeletePredictionApiKeyRegistration"
+        },
+        {
+          "service": "com.google.cloud.recommendationengine.v1beta1.PredictionService",
+          "method": "Predict"
+        },
+        {
+          "service": "com.google.cloud.recommendationengine.v1beta1.UserEventService",
+          "method": "WriteUserEvent"
+        },
+        {
+          "service": "com.google.cloud.recommendationengine.v1beta1.UserEventService",
+          "method": "CollectUserEvent"
+        },
+        {
+          "service": "com.google.cloud.recommendationengine.v1beta1.UserEventService",
+          "method": "ListUserEvents"
+        },
+        {
+          "service": "com.google.cloud.recommendationengine.v1beta1.UserEventService",
+          "method": "PurgeUserEvents"
+        },
+        {
+          "service": "com.google.cloud.recommendationengine.v1beta1.UserEventService",
+          "method": "ImportUserEvents"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/recommendationengine/v1beta1/recommendationengine_resources.proto b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/recommendationengine_resources.proto
new file mode 100644
index 000000000..dce1e2fa5
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/recommendationengine_resources.proto
@@ -0,0 +1,46 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// Contains common resources for recommendationengine/v1beta1.
+
+syntax = "proto3";
+
+package google.cloud.recommendationengine.v1beta1;
+
+import "google/api/resource.proto";
+
+option (google.api.resource_definition) = {
+  type: "recommendationengine.googleapis.com/Catalog"
+  pattern: "projects/{project}/locations/{location}/catalogs/{catalog}"
+};
+
+option (google.api.resource_definition) = {
+  type: "recommendationengine.googleapis.com/CatalogItemPath"
+  pattern: "projects/{project}/locations/{location}/catalogs/{catalog}/catalogItems/{catalog_item_path=**}"
+};
+
+option (google.api.resource_definition) = {
+  type: "recommendationengine.googleapis.com/EventStore"
+  pattern: "projects/{project}/locations/{location}/catalogs/{catalog}/eventStores/{event_store}"
+};
+
+option (google.api.resource_definition) = {
+  type: "recommendationengine.googleapis.com/PredictionApiKeyRegistration"
+  pattern: "projects/{project}/locations/{location}/catalogs/{catalog}/eventStores/{event_store}/predictionApiKeyRegistrations/{prediction_api_key_registration}"
+};
+
+option (google.api.resource_definition) = {
+  type: "recommendationengine.googleapis.com/Placement"
+  pattern: "projects/{project}/locations/{location}/catalogs/{catalog}/eventStores/{event_store}/placements/{placement}"
+};
diff --git a/third_party/googleapis/google/cloud/recommendationengine/v1beta1/recommendationengine_v1beta1.yaml b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/recommendationengine_v1beta1.yaml
new file mode 100644
index 000000000..cf3a27db3
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/recommendationengine_v1beta1.yaml
@@ -0,0 +1,69 @@
+type: google.api.Service
+config_version: 3
+name: recommendationengine.googleapis.com
+title: Recommendations AI
+
+apis:
+- name: google.cloud.recommendationengine.v1beta1.CatalogService
+- name: google.cloud.recommendationengine.v1beta1.PredictionApiKeyRegistry
+- name: google.cloud.recommendationengine.v1beta1.PredictionService
+- name: google.cloud.recommendationengine.v1beta1.UserEventService
+
+types:
+- name: google.cloud.recommendationengine.v1beta1.ImportCatalogItemsResponse
+- name: google.cloud.recommendationengine.v1beta1.ImportErrorsConfig
+- name: google.cloud.recommendationengine.v1beta1.ImportMetadata
+- name: google.cloud.recommendationengine.v1beta1.ImportUserEventsResponse
+- name: google.cloud.recommendationengine.v1beta1.PurgeUserEventsMetadata
+- name: google.cloud.recommendationengine.v1beta1.PurgeUserEventsResponse
+
+documentation:
+  summary: |-
+    Recommendations AI service enables customers to build end-to-end
+    personalized recommendation systems without requiring a high level of
+    expertise in machine learning, recommendation system, or Google Cloud.
+
+backend:
+  rules:
+  - selector: google.cloud.recommendationengine.v1beta1.CatalogService.ImportCatalogItems
+    deadline: 300.0
+  - selector: google.cloud.recommendationengine.v1beta1.CatalogService.ListCatalogItems
+    deadline: 300.0
+  - selector: google.cloud.recommendationengine.v1beta1.UserEventService.ImportUserEvents
+    deadline: 300.0
+  - selector: google.cloud.recommendationengine.v1beta1.UserEventService.ListUserEvents
+    deadline: 300.0
+
+http:
+  rules:
+  - selector: google.longrunning.Operations.GetOperation
+    get: '/v1beta1/{name=projects/*/locations/*/catalogs/*/operations/*}'
+    additional_bindings:
+    - get: '/v1beta1/{name=projects/*/locations/*/catalogs/*/eventStores/*/operations/*}'
+  - selector: google.longrunning.Operations.ListOperations
+    get: '/v1beta1/{name=projects/*/locations/*/catalogs/*}/operations'
+    additional_bindings:
+    - get: '/v1beta1/{name=projects/*/locations/*/catalogs/*/eventStores/*}/operations'
+
+authentication:
+  rules:
+  - selector: 'google.cloud.recommendationengine.v1beta1.CatalogService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.cloud.recommendationengine.v1beta1.PredictionApiKeyRegistry.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: google.cloud.recommendationengine.v1beta1.PredictionService.Predict
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.cloud.recommendationengine.v1beta1.UserEventService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/recommendationengine/v1beta1/user_event.proto b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/user_event.proto
new file mode 100644
index 000000000..da3fc3e04
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/user_event.proto
@@ -0,0 +1,336 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.recommendationengine.v1beta1;
+
+import "google/api/field_behavior.proto";
+import "google/cloud/recommendationengine/v1beta1/catalog.proto";
+import "google/cloud/recommendationengine/v1beta1/common.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.RecommendationEngine.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/recommendationengine/v1beta1;recommendationengine";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.recommendationengine.v1beta1";
+option objc_class_prefix = "RECAI";
+option php_namespace = "Google\\Cloud\\RecommendationEngine\\V1beta1";
+option ruby_package = "Google::Cloud::RecommendationEngine::V1beta1";
+
+// UserEvent captures all metadata information recommendation engine needs to
+// know about how end users interact with customers' website.
+message UserEvent {
+  // User event source.
+  enum EventSource {
+    // Unspecified event source.
+    EVENT_SOURCE_UNSPECIFIED = 0;
+
+    // The event is ingested via a javascript pixel or Recommendations AI Tag
+    // through automl datalayer or JS Macros.
+    AUTOML = 1;
+
+    // The event is ingested via Recommendations AI Tag through Enhanced
+    // Ecommerce datalayer.
+    ECOMMERCE = 2;
+
+    // The event is ingested via Import user events API.
+    BATCH_UPLOAD = 3;
+  }
+
+  // Required. User event type. Allowed values are:
+  //
+  // * `add-to-cart` Products being added to cart.
+  // * `add-to-list` Items being added to a list (shopping list, favorites
+  //   etc).
+  // * `category-page-view` Special pages such as sale or promotion pages
+  //   viewed.
+  // * `checkout-start` User starting a checkout process.
+  // * `detail-page-view` Products detail page viewed.
+  // * `home-page-view` Homepage viewed.
+  // * `page-visit` Generic page visits not included in the event types above.
+  // * `purchase-complete` User finishing a purchase.
+  // * `refund` Purchased items being refunded or returned.
+  // * `remove-from-cart` Products being removed from cart.
+  // * `remove-from-list` Items being removed from a list.
+  // * `search` Product search.
+  // * `shopping-cart-page-view` User viewing a shopping cart.
+  // * `impression` List of items displayed. Used by Google Tag Manager.
+  string event_type = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. User information.
+  UserInfo user_info = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. User event detailed information common across different
+  // recommendation types.
+  EventDetail event_detail = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Retail product specific user event metadata.
+  //
+  // This field is required for the following event types:
+  //
+  // * `add-to-cart`
+  // * `add-to-list`
+  // * `category-page-view`
+  // * `checkout-start`
+  // * `detail-page-view`
+  // * `purchase-complete`
+  // * `refund`
+  // * `remove-from-cart`
+  // * `remove-from-list`
+  // * `search`
+  //
+  // This field is optional for the following event types:
+  //
+  // * `page-visit`
+  // * `shopping-cart-page-view` - note that 'product_event_detail' should be
+  //   set for this unless the shopping cart is empty.
+  //
+  // This field is not allowed for the following event types:
+  //
+  // * `home-page-view`
+  ProductEventDetail product_event_detail = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Only required for ImportUserEvents method. Timestamp of user
+  // event created.
+  google.protobuf.Timestamp event_time = 5 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. This field should *not* be set when using JavaScript pixel
+  // or the Recommendations AI Tag. Defaults to `EVENT_SOURCE_UNSPECIFIED`.
+  EventSource event_source = 6 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Information of end users.
+message UserInfo {
+  // Required. A unique identifier for tracking visitors with a length limit of
+  // 128 bytes.
+  //
+  // For example, this could be implemented with a http cookie, which should be
+  // able to uniquely identify a visitor on a single device. This unique
+  // identifier should not change if the visitor log in/out of the website.
+  // Maximum length 128 bytes. Cannot be empty.
+  string visitor_id = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Unique identifier for logged-in user with a length limit of 128
+  // bytes. Required only for logged-in users.
+  string user_id = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. IP address of the user. This could be either IPv4 (e.g. 104.133.9.80) or
+  // IPv6 (e.g. 2001:0db8:85a3:0000:0000:8a2e:0370:7334). This should *not* be
+  // set when using the javascript pixel or if `direct_user_request` is set.
+  // Used to extract location information for personalization.
+  string ip_address = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. User agent as included in the HTTP header. UTF-8 encoded string
+  // with a length limit of 1 KiB.
+  //
+  // This should *not* be set when using the JavaScript pixel or if
+  // `directUserRequest` is set.
+  string user_agent = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Indicates if the request is made directly from the end user
+  // in which case the user_agent and ip_address fields can be populated
+  // from the HTTP request. This should *not* be set when using the javascript
+  // pixel. This flag should be set only if the API request is made directly
+  // from the end user such as a mobile app (and not if a gateway or a server is
+  // processing and pushing the user events).
+  bool direct_user_request = 5 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// User event details shared by all recommendation types.
+message EventDetail {
+  // Optional. Complete url (window.location.href) of the user's current page.
+  // When using the JavaScript pixel, this value is filled in automatically.
+  // Maximum length 5KB.
+  string uri = 1 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The referrer url of the current page. When using
+  // the JavaScript pixel, this value is filled in automatically.
+  string referrer_uri = 6 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A unique id of a web page view.
+  // This should be kept the same for all user events triggered from the same
+  // pageview. For example, an item detail page view could trigger multiple
+  // events as the user is browsing the page.
+  // The `pageViewId` property should be kept the same for all these events so
+  // that they can be grouped together properly. This `pageViewId` will be
+  // automatically generated if using the JavaScript pixel.
+  string page_view_id = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A list of identifiers for the independent experiment groups
+  // this user event belongs to. This is used to distinguish between user events
+  // associated with different experiment setups (e.g. using Recommendation
+  // Engine system, using different recommendation models).
+  repeated string experiment_ids = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Recommendation token included in the recommendation prediction
+  // response.
+  //
+  // This field enables accurate attribution of recommendation model
+  // performance.
+  //
+  // This token enables us to accurately attribute page view or purchase back to
+  // the event and the particular predict response containing this
+  // clicked/purchased item. If user clicks on product K in the recommendation
+  // results, pass the `PredictResponse.recommendationToken` property as a url
+  // parameter to product K's page. When recording events on product K's page,
+  // log the PredictResponse.recommendation_token to this field.
+  //
+  // Optional, but highly encouraged for user events that are the result of a
+  // recommendation prediction query.
+  string recommendation_token = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Extra user event features to include in the recommendation
+  // model.
+  //
+  // For product recommendation, an example of extra user information is
+  // traffic_channel, i.e. how user arrives at the site. Users can arrive
+  // at the site by coming to the site directly, or coming through Google
+  // search, and etc.
+  FeatureMap event_attributes = 5 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// ProductEventDetail captures user event information specific to retail
+// products.
+message ProductEventDetail {
+  // Required for `search` events. Other event types should not set this field.
+  // The user's search query as UTF-8 encoded text with a length limit of 5 KiB.
+  string search_query = 1;
+
+  // Required for `category-page-view` events. Other event types should not set
+  // this field.
+  // The categories associated with a category page.
+  // Category pages include special pages such as sales or promotions. For
+  // instance, a special sale page may have the category hierarchy:
+  // categories : ["Sales", "2017 Black Friday Deals"].
+  repeated CatalogItem.CategoryHierarchy page_categories = 2;
+
+  // The main product details related to the event.
+  //
+  // This field is required for the following event types:
+  //
+  // * `add-to-cart`
+  // * `add-to-list`
+  // * `checkout-start`
+  // * `detail-page-view`
+  // * `purchase-complete`
+  // * `refund`
+  // * `remove-from-cart`
+  // * `remove-from-list`
+  //
+  // This field is optional for the following event types:
+  //
+  // * `page-visit`
+  // * `shopping-cart-page-view` - note that 'product_details' should be set for
+  //   this unless the shopping cart is empty.
+  //
+  // This field is not allowed for the following event types:
+  //
+  // * `category-page-view`
+  // * `home-page-view`
+  // * `search`
+  repeated ProductDetail product_details = 3;
+
+  // Required for `add-to-list` and `remove-from-list` events. The id or name of
+  // the list that the item is being added to or removed from. Other event types
+  // should not set this field.
+  string list_id = 4;
+
+  // Optional. The id or name of the associated shopping cart. This id is used
+  // to associate multiple items added or present in the cart before purchase.
+  //
+  // This can only be set for `add-to-cart`, `remove-from-cart`,
+  // `checkout-start`, `purchase-complete`, or `shopping-cart-page-view` events.
+  string cart_id = 5 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A transaction represents the entire purchase transaction.
+  // Required for `purchase-complete` events. Optional for `checkout-start`
+  // events. Other event types should not set this field.
+  PurchaseTransaction purchase_transaction = 6 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// A transaction represents the entire purchase transaction.
+message PurchaseTransaction {
+  // Optional. The transaction ID with a length limit of 128 bytes.
+  string id = 1 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. Total revenue or grand total associated with the transaction.
+  // This value include shipping, tax, or other adjustments to total revenue
+  // that you want to include as part of your revenue calculations. This field
+  // is not required if the event type is `refund`.
+  float revenue = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. All the taxes associated with the transaction.
+  map taxes = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. All the costs associated with the product. These can be
+  // manufacturing costs, shipping expenses not borne by the end user, or any
+  // other costs.
+  //
+  // Total product cost such that
+  //   profit = revenue - (sum(taxes) + sum(costs))
+  // If product_cost is not set, then
+  //   profit = revenue - tax - shipping - sum(CatalogItem.costs).
+  //
+  // If CatalogItem.cost is not specified for one of the items, CatalogItem.cost
+  // based profit *cannot* be calculated for this Transaction.
+  map costs = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. Currency code. Use three-character ISO-4217 code. This field
+  // is not required if the event type is `refund`.
+  string currency_code = 6 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Detailed product information associated with a user event.
+message ProductDetail {
+  // Required. Catalog item ID. UTF-8 encoded string with a length limit of 128
+  // characters.
+  string id = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Currency code for price/costs. Use three-character ISO-4217
+  // code. Required only if originalPrice or displayPrice is set.
+  string currency_code = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Original price of the product. If provided, this will override
+  // the original price in Catalog for this product.
+  float original_price = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Display price of the product (e.g. discounted price). If
+  // provided, this will override the display price in Catalog for this product.
+  float display_price = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Item stock state. If provided, this overrides the stock state
+  // in Catalog for items in this event.
+  ProductCatalogItem.StockState stock_state = 5 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Quantity of the product associated with the user event. For
+  // example, this field will be 2 if two products are added to the shopping
+  // cart for `add-to-cart` event. Required for `add-to-cart`, `add-to-list`,
+  // `remove-from-cart`, `checkout-start`, `purchase-complete`, `refund` event
+  // types.
+  int32 quantity = 6 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Quantity of the products in stock when a user event happens.
+  // Optional. If provided, this overrides the available quantity in Catalog for
+  // this event. and can only be set if `stock_status` is set to `IN_STOCK`.
+  //
+  // Note that if an item is out of stock, you must set the `stock_state` field
+  // to be `OUT_OF_STOCK`. Leaving this field unspecified / as zero is not
+  // sufficient to mark the item out of stock.
+  int32 available_quantity = 7 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Extra features associated with a product in the user event.
+  FeatureMap item_attributes = 8 [(google.api.field_behavior) = OPTIONAL];
+}
diff --git a/third_party/googleapis/google/cloud/recommendationengine/v1beta1/user_event_service.proto b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/user_event_service.proto
new file mode 100644
index 000000000..8ea6f551d
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommendationengine/v1beta1/user_event_service.proto
@@ -0,0 +1,274 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.recommendationengine.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/api/httpbody.proto";
+import "google/api/resource.proto";
+import "google/cloud/recommendationengine/v1beta1/import.proto";
+import "google/cloud/recommendationengine/v1beta1/user_event.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/timestamp.proto";
+import "google/type/date.proto";
+import "google/api/client.proto";
+
+option csharp_namespace = "Google.Cloud.RecommendationEngine.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/recommendationengine/v1beta1;recommendationengine";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.recommendationengine.v1beta1";
+option objc_class_prefix = "RECAI";
+option php_namespace = "Google\\Cloud\\RecommendationEngine\\V1beta1";
+option ruby_package = "Google::Cloud::RecommendationEngine::V1beta1";
+
+// Service for ingesting end user actions on the customer website.
+service UserEventService {
+  option (google.api.default_host) = "recommendationengine.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform";
+
+  // Writes a single user event.
+  rpc WriteUserEvent(WriteUserEventRequest) returns (UserEvent) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/locations/*/catalogs/*/eventStores/*}/userEvents:write"
+      body: "user_event"
+    };
+    option (google.api.method_signature) = "parent,user_event";
+  }
+
+  // Writes a single user event from the browser. This uses a GET request to
+  // due to browser restriction of POST-ing to a 3rd party domain.
+  //
+  // This method is used only by the Recommendations AI JavaScript pixel.
+  // Users should not call this method directly.
+  rpc CollectUserEvent(CollectUserEventRequest) returns (google.api.HttpBody) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/locations/*/catalogs/*/eventStores/*}/userEvents:collect"
+    };
+    option (google.api.method_signature) = "parent,user_event,uri,ets";
+  }
+
+  // Gets a list of user events within a time range, with potential filtering.
+  rpc ListUserEvents(ListUserEventsRequest) returns (ListUserEventsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/locations/*/catalogs/*/eventStores/*}/userEvents"
+    };
+    option (google.api.method_signature) = "parent,filter";
+  }
+
+  // Deletes permanently all user events specified by the filter provided.
+  // Depending on the number of events specified by the filter, this operation
+  // could take hours or days to complete. To test a filter, use the list
+  // command first.
+  rpc PurgeUserEvents(PurgeUserEventsRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/locations/*/catalogs/*/eventStores/*}/userEvents:purge"
+      body: "*"
+    };
+    option (google.longrunning.operation_info) = {
+      response_type: "google.cloud.recommendationengine.v1beta1.PurgeUserEventsResponse"
+      metadata_type: "google.cloud.recommendationengine.v1beta1.PurgeUserEventsMetadata"
+    };
+    option (google.api.method_signature) = "parent,filter,force";
+  }
+
+  // Bulk import of User events. Request processing might be
+  // synchronous. Events that already exist are skipped.
+  // Use this method for backfilling historical user events.
+  //
+  // Operation.response is of type ImportResponse. Note that it is
+  // possible for a subset of the items to be successfully inserted.
+  // Operation.metadata is of type ImportMetadata.
+  rpc ImportUserEvents(ImportUserEventsRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/locations/*/catalogs/*/eventStores/*}/userEvents:import"
+      body: "*"
+    };
+    option (google.longrunning.operation_info) = {
+      response_type: "google.cloud.recommendationengine.v1beta1.ImportUserEventsResponse"
+      metadata_type: "google.cloud.recommendationengine.v1beta1.ImportMetadata"
+    };
+    option (google.api.method_signature) =
+        "parent,request_id,input_config,errors_config";
+  }
+}
+
+// Request message for PurgeUserEvents method.
+message PurgeUserEventsRequest {
+  // Required. The resource name of the event_store under which the events are
+  // created. The format is
+  // "projects/${projectId}/locations/global/catalogs/${catalogId}/eventStores/${eventStoreId}"
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommendationengine.googleapis.com/EventStore"
+    }
+  ];
+
+  // Required. The filter string to specify the events to be deleted. Empty
+  // string filter is not allowed. This filter can also be used with
+  // ListUserEvents API to list events that will be deleted. The eligible fields
+  // for filtering are:
+  // * eventType - UserEvent.eventType field of type string.
+  // * eventTime - in ISO 8601 "zulu" format.
+  // * visitorId - field of type string. Specifying this will delete all events
+  // associated with a visitor.
+  // * userId - field of type string. Specifying this will delete all events
+  // associated with a user.
+  // Example 1: Deleting all events in a time range.
+  // `eventTime > "2012-04-23T18:25:43.511Z" eventTime <
+  // "2012-04-23T18:30:43.511Z"`
+  // Example 2: Deleting specific eventType in time range.
+  // `eventTime > "2012-04-23T18:25:43.511Z" eventType = "detail-page-view"`
+  // Example 3: Deleting all events for a specific visitor
+  // `visitorId = visitor1024`
+  // The filtering fields are assumed to have an implicit AND.
+  string filter = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The default value is false. Override this flag to true to
+  // actually perform the purge. If the field is not set to true, a sampling of
+  // events to be deleted will be returned.
+  bool force = 3 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Metadata related to the progress of the PurgeUserEvents operation.
+// This will be returned by the google.longrunning.Operation.metadata field.
+message PurgeUserEventsMetadata {
+  // The ID of the request / operation.
+  string operation_name = 1;
+
+  // Operation create time.
+  google.protobuf.Timestamp create_time = 2;
+}
+
+// Response of the PurgeUserEventsRequest. If the long running operation is
+// successfully done, then this message is returned by the
+// google.longrunning.Operations.response field.
+message PurgeUserEventsResponse {
+  // The total count of events purged as a result of the operation.
+  int64 purged_events_count = 1;
+
+  // A sampling of events deleted (or will be deleted) depending on the `force`
+  // property in the request. Max of 500 items will be returned.
+  repeated UserEvent user_events_sample = 2;
+}
+
+// Request message for WriteUserEvent method.
+message WriteUserEventRequest {
+  // Required. The parent eventStore resource name, such as
+  // "projects/1234/locations/global/catalogs/default_catalog/eventStores/default_event_store".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommendationengine.googleapis.com/EventStore"
+    }
+  ];
+
+  // Required. User event to write.
+  UserEvent user_event = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for CollectUserEvent method.
+message CollectUserEventRequest {
+  // Required. The parent eventStore name, such as
+  // "projects/1234/locations/global/catalogs/default_catalog/eventStores/default_event_store".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommendationengine.googleapis.com/EventStore"
+    }
+  ];
+
+  // Required. URL encoded UserEvent proto.
+  string user_event = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The url including cgi-parameters but excluding the hash fragment.
+  // The URL must be truncated to 1.5K bytes to conservatively be under the 2K
+  // bytes. This is often more useful than the referer url, because many
+  // browsers only send the domain for 3rd party requests.
+  string uri = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The event timestamp in milliseconds. This prevents browser
+  // caching of otherwise identical get requests. The name is abbreviated to
+  // reduce the payload bytes.
+  int64 ets = 4 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Request message for ListUserEvents method.
+message ListUserEventsRequest {
+  // Required. The parent eventStore resource name, such as
+  // "projects/*/locations/*/catalogs/default_catalog/eventStores/default_event_store".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommendationengine.googleapis.com/EventStore"
+    }
+  ];
+
+  // Optional. Maximum number of results to return per page. If zero, the
+  // service will choose a reasonable default.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The previous ListUserEventsResponse.next_page_token.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Filtering expression to specify restrictions over
+  // returned events. This is a sequence of terms, where each term applies some
+  // kind of a restriction to the returned user events. Use this expression to
+  // restrict results to a specific time range, or filter events by eventType.
+  //    eg: eventTime > "2012-04-23T18:25:43.511Z" eventsMissingCatalogItems
+  //    eventTime<"2012-04-23T18:25:43.511Z" eventType=search
+  //
+  //   We expect only 3 types of fields:
+  //
+  //    * eventTime: this can be specified a maximum of 2 times, once with a
+  //      less than operator and once with a greater than operator. The
+  //      eventTime restrict should result in one contiguous valid eventTime
+  //      range.
+  //
+  //    * eventType: only 1 eventType restriction can be specified.
+  //
+  //    * eventsMissingCatalogItems: specififying this will restrict results
+  //      to events for which catalog items were not found in the catalog. The
+  //      default behavior is to return only those events for which catalog
+  //      items were found.
+  //
+  //   Some examples of valid filters expressions:
+  //
+  //   * Example 1: eventTime > "2012-04-23T18:25:43.511Z"
+  //             eventTime < "2012-04-23T18:30:43.511Z"
+  //   * Example 2: eventTime > "2012-04-23T18:25:43.511Z"
+  //             eventType = detail-page-view
+  //   * Example 3: eventsMissingCatalogItems
+  //             eventType = search eventTime < "2018-04-23T18:30:43.511Z"
+  //   * Example 4: eventTime > "2012-04-23T18:25:43.511Z"
+  //   * Example 5: eventType = search
+  //   * Example 6: eventsMissingCatalogItems
+  string filter = 4 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response message for ListUserEvents method.
+message ListUserEventsResponse {
+  // The user events.
+  repeated UserEvent user_events = 1;
+
+  // If empty, the list is complete. If nonempty, the token to pass to the next
+  // request's ListUserEvents.page_token.
+  string next_page_token = 2;
+}
diff --git a/third_party/googleapis/google/cloud/recommender/BUILD.bazel b/third_party/googleapis/google/cloud/recommender/BUILD.bazel
new file mode 100644
index 000000000..a87c57fec
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommender/BUILD.bazel
@@ -0,0 +1 @@
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/cloud/recommender/logging/v1/BUILD.bazel b/third_party/googleapis/google/cloud/recommender/logging/v1/BUILD.bazel
new file mode 100644
index 000000000..901386cd6
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommender/logging/v1/BUILD.bazel
@@ -0,0 +1,162 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
+proto_library(
+    name = "logging_proto",
+    srcs = [
+        "action_log.proto",
+    ],
+    deps = [
+        "//google/cloud/recommender/v1:recommender_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "logging_java_proto",
+    deps = [":logging_proto"],
+)
+
+java_grpc_library(
+    name = "logging_java_grpc",
+    srcs = [":logging_proto"],
+    deps = [":logging_java_proto"],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_proto_library",
+)
+
+go_proto_library(
+    name = "logging_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/recommender/logging/v1",
+    protos = [":logging_proto"],
+    deps = [
+        "//google/cloud/recommender/v1:recommender_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "logging_moved_proto",
+    srcs = [":logging_proto"],
+    deps = [
+        "//google/cloud/recommender/v1:recommender_proto",
+    ],
+)
+
+py_proto_library(
+    name = "logging_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":logging_moved_proto"],
+)
+
+py_grpc_library(
+    name = "logging_py_grpc",
+    srcs = [":logging_moved_proto"],
+    deps = [":logging_py_proto"],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "logging_php_proto",
+    deps = [":logging_proto"],
+)
+
+php_grpc_library(
+    name = "logging_php_grpc",
+    srcs = [":logging_proto"],
+    deps = [":logging_php_proto"],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "logging_ruby_proto",
+    deps = [":logging_proto"],
+)
+
+ruby_grpc_library(
+    name = "logging_ruby_grpc",
+    srcs = [":logging_proto"],
+    deps = [":logging_ruby_proto"],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "logging_csharp_proto",
+    deps = [":logging_proto"],
+)
+
+csharp_grpc_library(
+    name = "logging_csharp_grpc",
+    srcs = [":logging_proto"],
+    deps = [":logging_csharp_proto"],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ code here
diff --git a/third_party/googleapis/google/cloud/recommender/logging/v1/action_log.proto b/third_party/googleapis/google/cloud/recommender/logging/v1/action_log.proto
new file mode 100644
index 000000000..d9c751fc9
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommender/logging/v1/action_log.proto
@@ -0,0 +1,41 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.recommender.logging.v1;
+
+import "google/cloud/recommender/v1/recommendation.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/recommender/logging/v1;logging";
+option java_multiple_files = true;
+option java_outer_classname = "ActionLogProto";
+option java_package = "com.google.cloud.recommender.logging.v1";
+
+// Log content of an action on a recommendation. This includes Mark* actions, as
+// well as ApplyRule actions.
+message ActionLog {
+  // Required. User that executed this action. Eg, foo@gmail.com
+  string actor = 1;
+
+  // Required. Action that was taken by the actor. Eg, MarkCompleted.
+  google.cloud.recommender.v1.RecommendationStateInfo.State state = 2;
+
+  // Optional. Metadata that was included with the action that was taken.
+  map state_metadata = 3;
+
+  // Required. Name of the recommendation which was acted on. Eg, :
+  // 'projects/foo/locations/global/recommenders/roleReco/recommendations/r1'
+  string recommendation_name = 4;
+}
diff --git a/third_party/googleapis/google/cloud/recommender/logging/v1/recommender.yaml b/third_party/googleapis/google/cloud/recommender/logging/v1/recommender.yaml
new file mode 100644
index 000000000..bf4364427
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommender/logging/v1/recommender.yaml
@@ -0,0 +1,7 @@
+type: google.api.Service
+config_version: 3
+name: recommender.googleapis.com
+title: Recommender API Logging
+
+types:
+- name: google.cloud.recommender.logging.v1.ActionLog
diff --git a/third_party/googleapis/google/cloud/recommender/logging/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/recommender/logging/v1beta1/BUILD.bazel
new file mode 100644
index 000000000..67532523c
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommender/logging/v1beta1/BUILD.bazel
@@ -0,0 +1,165 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
+proto_library(
+    name = "logging_proto",
+    srcs = [
+        "action_log.proto",
+    ],
+    deps = [
+        "//google/api:field_behavior_proto",
+        "//google/cloud/recommender/v1beta1:recommender_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "logging_java_proto",
+    deps = [":logging_proto"],
+)
+
+java_grpc_library(
+    name = "logging_java_grpc",
+    srcs = [":logging_proto"],
+    deps = [":logging_java_proto"],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_proto_library",
+)
+
+go_proto_library(
+    name = "logging_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/recommender/logging/v1beta1",
+    protos = [":logging_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/cloud/recommender/v1beta1:recommender_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "logging_moved_proto",
+    srcs = [":logging_proto"],
+    deps = [
+        "//google/api:field_behavior_proto",
+        "//google/cloud/recommender/v1beta1:recommender_proto",
+    ],
+)
+
+py_proto_library(
+    name = "logging_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":logging_moved_proto"],
+)
+
+py_grpc_library(
+    name = "logging_py_grpc",
+    srcs = [":logging_moved_proto"],
+    deps = [":logging_py_proto"],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "logging_php_proto",
+    deps = [":logging_proto"],
+)
+
+php_grpc_library(
+    name = "logging_php_grpc",
+    srcs = [":logging_proto"],
+    deps = [":logging_php_proto"],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "logging_ruby_proto",
+    deps = [":logging_proto"],
+)
+
+ruby_grpc_library(
+    name = "logging_ruby_grpc",
+    srcs = [":logging_proto"],
+    deps = [":logging_ruby_proto"],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "logging_csharp_proto",
+    deps = [":logging_proto"],
+)
+
+csharp_grpc_library(
+    name = "logging_csharp_grpc",
+    srcs = [":logging_proto"],
+    deps = [":logging_csharp_proto"],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ code here
diff --git a/third_party/googleapis/google/cloud/recommender/logging/v1beta1/action_log.proto b/third_party/googleapis/google/cloud/recommender/logging/v1beta1/action_log.proto
new file mode 100644
index 000000000..960ed33ba
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommender/logging/v1beta1/action_log.proto
@@ -0,0 +1,58 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.recommender.logging.v1beta1;
+
+import "google/api/field_behavior.proto";
+import "google/cloud/recommender/v1beta1/insight.proto";
+import "google/cloud/recommender/v1beta1/recommendation.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/recommender/logging/v1beta1;logging";
+option java_multiple_files = true;
+option java_outer_classname = "ActionLogProto";
+option java_package = "com.google.cloud.recommender.logging.v1beta1";
+
+// Log content of an action on a recommendation. This includes Mark* actions.
+message ActionLog {
+  // Required. User that executed this action. Eg, foo@gmail.com
+  string actor = 1;
+
+  // Required. State change that was made by the actor. Eg, SUCCEEDED.
+  google.cloud.recommender.v1beta1.RecommendationStateInfo.State state = 2;
+
+  // Optional. Metadata that was included with the action that was taken.
+  map state_metadata = 3;
+
+  // Required. Name of the recommendation which was acted on. Eg, :
+  // 'projects/foo/locations/global/recommenders/roleReco/recommendations/r1'
+  string recommendation_name = 4;
+}
+
+// Log content of an action on an insight. This includes Mark* actions.
+message InsightActionLog {
+  // Required. User that executed this action. Eg, foo@gmail.com
+  string actor = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. State change that was made by the actor. Eg, ACCEPTED.
+  google.cloud.recommender.v1beta1.InsightStateInfo.State state = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Metadata that was included with the action that was taken.
+  map state_metadata = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. Name of the insight which was acted on. Eg, :
+  // 'projects/foo/locations/global/insightTypes/roleInsight/insights/i1'
+  string insight = 4 [(google.api.field_behavior) = REQUIRED];
+}
diff --git a/third_party/googleapis/google/cloud/recommender/logging/v1beta1/recommender.yaml b/third_party/googleapis/google/cloud/recommender/logging/v1beta1/recommender.yaml
new file mode 100644
index 000000000..f143a7bf6
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommender/logging/v1beta1/recommender.yaml
@@ -0,0 +1,8 @@
+type: google.api.Service
+config_version: 3
+name: recommender.googleapis.com
+title: Recommender API Logging
+
+types:
+- name: google.cloud.recommender.logging.v1beta1.ActionLog
+- name: google.cloud.recommender.logging.v1beta1.InsightActionLog
diff --git a/third_party/googleapis/google/cloud/recommender/v1/BUILD.bazel b/third_party/googleapis/google/cloud/recommender/v1/BUILD.bazel
new file mode 100644
index 000000000..0ac31fe6f
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommender/v1/BUILD.bazel
@@ -0,0 +1,367 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "recommender_proto",
+    srcs = [
+        "recommendation.proto",
+        "recommender_service.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/type:money_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:struct_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "recommender_proto_with_info",
+    deps = [
+        ":recommender_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "recommender_java_proto",
+    deps = [":recommender_proto"],
+)
+
+java_grpc_library(
+    name = "recommender_java_grpc",
+    srcs = [":recommender_proto"],
+    deps = [":recommender_java_proto"],
+)
+
+java_gapic_library(
+    name = "recommender_java_gapic",
+    src = ":recommender_proto_with_info",
+    gapic_yaml = "recommender_gapic.yaml",
+    package = "google.cloud.recommender.v1",
+    service_yaml = "recommender_v1.yaml",
+    test_deps = [
+        ":recommender_java_grpc",
+    ],
+    deps = [
+        ":recommender_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "recommender_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.recommender.v1.RecommenderClientTest",
+    ],
+    runtime_deps = [":recommender_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-recommender-v1-java",
+    deps = [
+        ":recommender_java_gapic",
+        ":recommender_java_grpc",
+        ":recommender_java_proto",
+        ":recommender_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "recommender_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/recommender/v1",
+    protos = [":recommender_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/type:money_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "recommender_go_gapic",
+    srcs = [":recommender_proto_with_info"],
+    grpc_service_config = "recommender_grpc_service_config.json",
+    importpath = "cloud.google.com/go/recommender/apiv1;recommender",
+    service_yaml = "recommender_v1.yaml",
+    deps = [
+        ":recommender_go_proto",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
+    ],
+)
+
+go_test(
+    name = "recommender_go_gapic_test",
+    srcs = [":recommender_go_gapic_srcjar_test"],
+    embed = [":recommender_go_gapic"],
+    importpath = "cloud.google.com/go/recommender/apiv1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-recommender-v1-go",
+    deps = [
+        ":recommender_go_gapic",
+        ":recommender_go_gapic_srcjar-test.srcjar",
+        ":recommender_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "recommender_moved_proto",
+    srcs = [":recommender_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/type:money_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:struct_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "recommender_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":recommender_moved_proto"],
+)
+
+py_grpc_library(
+    name = "recommender_py_grpc",
+    srcs = [":recommender_moved_proto"],
+    deps = [":recommender_py_proto"],
+)
+
+py_gapic_library(
+    name = "recommender_py_gapic",
+    src = ":recommender_proto_with_info",
+    gapic_yaml = "recommender_gapic.yaml",
+    package = "google.cloud.recommender.v1",
+    service_yaml = "recommender_v1.yaml",
+    deps = [
+        ":recommender_py_grpc",
+        ":recommender_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "recommender-v1-py",
+    deps = [
+        ":recommender_py_gapic",
+        ":recommender_py_grpc",
+        ":recommender_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "recommender_php_proto",
+    deps = [":recommender_proto"],
+)
+
+php_grpc_library(
+    name = "recommender_php_grpc",
+    srcs = [":recommender_proto"],
+    deps = [":recommender_php_proto"],
+)
+
+php_gapic_library(
+    name = "recommender_php_gapic",
+    src = ":recommender_proto_with_info",
+    gapic_yaml = "recommender_gapic.yaml",
+    package = "google.cloud.recommender.v1",
+    service_yaml = "recommender_v1.yaml",
+    deps = [
+        ":recommender_php_grpc",
+        ":recommender_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-recommender-v1-php",
+    deps = [
+        ":recommender_php_gapic",
+        ":recommender_php_grpc",
+        ":recommender_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "recommender_nodejs_gapic",
+    src = ":recommender_proto_with_info",
+    gapic_yaml = "recommender_gapic.yaml",
+    package = "google.cloud.recommender.v1",
+    service_yaml = "recommender_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "recommender-v1-nodejs",
+    deps = [
+        ":recommender_nodejs_gapic",
+        ":recommender_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "recommender_ruby_proto",
+    deps = [":recommender_proto"],
+)
+
+ruby_grpc_library(
+    name = "recommender_ruby_grpc",
+    srcs = [":recommender_proto"],
+    deps = [":recommender_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "recommender_ruby_gapic",
+    src = ":recommender_proto_with_info",
+    gapic_yaml = "recommender_gapic.yaml",
+    package = "google.cloud.recommender.v1",
+    service_yaml = "recommender_v1.yaml",
+    deps = [
+        ":recommender_ruby_grpc",
+        ":recommender_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-recommender-v1-ruby",
+    deps = [
+        ":recommender_ruby_gapic",
+        ":recommender_ruby_grpc",
+        ":recommender_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "recommender_csharp_proto",
+    deps = [":recommender_proto"],
+)
+
+csharp_grpc_library(
+    name = "recommender_csharp_grpc",
+    srcs = [":recommender_proto"],
+    deps = [":recommender_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "recommender_csharp_gapic",
+    src = ":recommender_proto_with_info",
+    gapic_yaml = "recommender_gapic.yaml",
+    package = "google.cloud.recommender.v1",
+    service_yaml = "recommender_v1.yaml",
+    deps = [
+        ":recommender_csharp_grpc",
+        ":recommender_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-recommender-v1-csharp",
+    deps = [
+        ":recommender_csharp_gapic",
+        ":recommender_csharp_grpc",
+        ":recommender_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/recommender/v1/artman_recommender_v1.yaml b/third_party/googleapis/google/cloud/recommender/v1/artman_recommender_v1.yaml
new file mode 100644
index 000000000..f5b86dfc7
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommender/v1/artman_recommender_v1.yaml
@@ -0,0 +1,35 @@
+common:
+  api_name: recommender
+  api_version: v1
+  organization_name: google-cloud
+  proto_deps:
+  - name: google-common-protos
+  src_proto_paths:
+  - .
+  service_yaml: recommender_v1.yaml
+  gapic_yaml: recommender_gapic.yaml
+  proto_package: google.cloud.recommender.v1
+artifacts:
+- name: gapic_config
+  type: GAPIC_CONFIG
+- name: java_gapic
+  type: GAPIC
+  language: JAVA
+- name: python_gapic
+  type: GAPIC
+  language: PYTHON
+- name: nodejs_gapic
+  type: GAPIC
+  language: NODEJS
+- name: php_gapic
+  type: GAPIC
+  language: PHP
+- name: go_gapic
+  type: GAPIC
+  language: GO
+- name: ruby_gapic
+  type: GAPIC
+  language: RUBY
+- name: csharp_gapic
+  type: GAPIC
+  language: CSHARP
diff --git a/third_party/googleapis/google/cloud/recommender/v1/recommendation.proto b/third_party/googleapis/google/cloud/recommender/v1/recommendation.proto
new file mode 100644
index 000000000..15e2bca18
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommender/v1/recommendation.proto
@@ -0,0 +1,277 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.recommender.v1;
+
+import "google/api/resource.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/struct.proto";
+import "google/protobuf/timestamp.proto";
+import "google/type/money.proto";
+
+option csharp_namespace = "Google.Cloud.Recommender.V1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/recommender/v1;recommender";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.recommender.v1";
+option objc_class_prefix = "CREC";
+option (google.api.resource_definition) = {
+  type: "recommender.googleapis.com/Recommender"
+  pattern: "projects/{project}/locations/{location}/recommenders/{recommender}"
+};
+
+// A recommendation along with a suggested action. E.g., a rightsizing
+// recommendation for an underutilized VM, IAM role recommendations, etc
+message Recommendation {
+  option (google.api.resource) = {
+    type: "recommender.googleapis.com/Recommendation"
+    pattern: "projects/{project}/locations/{location}/recommenders/{recommender}/recommendations/{recommendation}"
+  };
+
+  // Name of recommendation.
+  string name = 1;
+
+  // Free-form human readable summary in English. The maximum length is 500
+  // characters.
+  string description = 2;
+
+  // Contains an identifier for a subtype of recommendations produced for the
+  // same recommender. Subtype is a function of content and impact, meaning a
+  // new subtype might be added when significant changes to `content` or
+  // `primary_impact.category` are introduced. See the Recommenders section
+  // to see a list of subtypes for a given Recommender.
+  //
+  // Examples:
+  //   For recommender = "google.iam.policy.Recommender",
+  //   recommender_subtype can be one of "REMOVE_ROLE"/"REPLACE_ROLE"
+  string recommender_subtype = 12;
+
+  // Last time this recommendation was refreshed by the system that created it
+  // in the first place.
+  google.protobuf.Timestamp last_refresh_time = 4;
+
+  // The primary impact that this recommendation can have while trying to
+  // optimize for one category.
+  Impact primary_impact = 5;
+
+  // Optional set of additional impact that this recommendation may have when
+  // trying to optimize for the primary category. These may be positive
+  // or negative.
+  repeated Impact additional_impact = 6;
+
+  // Content of the recommendation describing recommended changes to resources.
+  RecommendationContent content = 7;
+
+  // Information for state. Contains state and metadata.
+  RecommendationStateInfo state_info = 10;
+
+  // Fingerprint of the Recommendation. Provides optimistic locking when
+  // updating states.
+  string etag = 11;
+}
+
+// Contains what resources are changing and how they are changing.
+message RecommendationContent {
+  // Operations to one or more Google Cloud resources grouped in such a way
+  // that, all operations within one group are expected to be performed
+  // atomically and in an order.
+  repeated OperationGroup operation_groups = 2;
+}
+
+// Group of operations that need to be performed atomically.
+message OperationGroup {
+  // List of operations across one or more resources that belong to this group.
+  // Loosely based on RFC6902 and should be performed in the order they appear.
+  repeated Operation operations = 1;
+}
+
+// Contains an operation for a resource loosely based on the JSON-PATCH format
+// with support for:
+//
+// * Custom filters for describing partial array patch.
+// * Extended path values for describing nested arrays.
+// * Custom fields for describing the resource for which the operation is being
+//   described.
+// * Allows extension to custom operations not natively supported by RFC6902.
+// See https://tools.ietf.org/html/rfc6902 for details on the original RFC.
+message Operation {
+  // Type of this operation. Contains one of 'and', 'remove', 'replace', 'move',
+  // 'copy', 'test' and custom operations. This field is case-insensitive and
+  // always populated.
+  string action = 1;
+
+  // Type of GCP resource being modified/tested. This field is always populated.
+  // Example: cloudresourcemanager.googleapis.com/Project,
+  // compute.googleapis.com/Instance
+  string resource_type = 2;
+
+  // Contains the fully qualified resource name. This field is always populated.
+  // ex: //cloudresourcemanager.googleapis.com/projects/foo.
+  string resource = 3;
+
+  // Path to the target field being operated on. If the operation is at the
+  // resource level, then path should be "/". This field is always populated.
+  string path = 4;
+
+  // Can be set with action 'copy' to copy resource configuration across
+  // different resources of the same type. Example: A resource clone can be
+  // done via action = 'copy', path = "/", from = "/",
+  // source_resource =  and resource_name = .
+  // This field is empty for all other values of `action`.
+  string source_resource = 5;
+
+  // Can be set with action 'copy' or 'move' to indicate the source field within
+  // resource or source_resource, ignored if provided for other operation types.
+  string source_path = 6;
+
+  // One of the fields in the following block will be set and intend to
+  // describe a value for 'path' field.
+  oneof path_value {
+    // Value for the `path` field. Will be set for actions:'add'/'replace'.
+    // Maybe set for action: 'test'. Either this or `value_matcher` will be set
+    // for 'test' operation. An exact match must be performed.
+    google.protobuf.Value value = 7;
+
+    // Can be set for action 'test' for advanced matching for the value of
+    // 'path' field. Either this or `value` will be set for 'test' operation.
+    ValueMatcher value_matcher = 10;
+  }
+
+  // Set of filters to apply if `path` refers to array elements or nested array
+  // elements in order to narrow down to a single unique element that is being
+  // tested/modified.
+  // This is intended to be an exact match per filter. To perform advanced
+  // matching, use path_value_matchers.
+  //
+  // * Example: {
+  //   "/versions/*/name" : "it-123"
+  //   "/versions/*/targetSize/percent": 20
+  //  }
+  // * Example: {
+  //   "/bindings/*/role": "roles/admin"
+  //   "/bindings/*/condition" : null
+  //  }
+  // * Example: {
+  //   "/bindings/*/role": "roles/admin"
+  //   "/bindings/*/members/*" : ["x@google.com", "y@google.com"]
+  //  }
+  // When both path_filters and path_value_matchers are set, an implicit AND
+  // must be performed.
+  map path_filters = 8;
+
+  // Similar to path_filters, this contains set of filters to apply if `path`
+  // field referes to array elements. This is meant to support value matching
+  // beyond exact match. To perform exact match, use path_filters.
+  // When both path_filters and path_value_matchers are set, an implicit AND
+  // must be performed.
+  map path_value_matchers = 11;
+}
+
+// Contains various matching options for values for a GCP resource field.
+message ValueMatcher {
+  oneof match_variant {
+    // To be used for full regex matching. The regular expression is using the
+    // Google RE2 syntax (https://github.com/google/re2/wiki/Syntax), so to be
+    // used with RE2::FullMatch
+    string matches_pattern = 1;
+  }
+}
+
+// Contains metadata about how much money a recommendation can save or incur.
+message CostProjection {
+  // An approximate projection on amount saved or amount incurred. Negative cost
+  // units indicate cost savings and positive cost units indicate increase.
+  // See google.type.Money documentation for positive/negative units.
+  google.type.Money cost = 1;
+
+  // Duration for which this cost applies.
+  google.protobuf.Duration duration = 2;
+}
+
+// Contains the impact a recommendation can have for a given category.
+message Impact {
+  // The category of the impact.
+  enum Category {
+    // Default unspecified category. Don't use directly.
+    CATEGORY_UNSPECIFIED = 0;
+
+    // Indicates a potential increase or decrease in cost.
+    COST = 1;
+
+    // Indicates a potential increase or decrease in security.
+    SECURITY = 2;
+
+    // Indicates a potential increase or decrease in performance.
+    PERFORMANCE = 3;
+
+    // Indicates a potential increase or decrease in manageability.
+    MANAGEABILITY = 4;
+  }
+
+  // Category that is being targeted.
+  Category category = 1;
+
+  // Contains projections (if any) for this category.
+  oneof projection {
+    // Use with CategoryType.COST
+    CostProjection cost_projection = 100;
+  }
+}
+
+// Information for state. Contains state and metadata.
+message RecommendationStateInfo {
+  // Represents Recommendation State
+  enum State {
+    // Default state. Don't use directly.
+    STATE_UNSPECIFIED = 0;
+
+    // Recommendation is active and can be applied. Recommendations content can
+    // be updated by Google.
+    //
+    // ACTIVE recommendations can be marked as CLAIMED, SUCCEEDED, or FAILED.
+    ACTIVE = 1;
+
+    // Recommendation is in claimed state. Recommendations content is
+    // immutable and cannot be updated by Google.
+    //
+    // CLAIMED recommendations can be marked as CLAIMED, SUCCEEDED, or FAILED.
+    CLAIMED = 6;
+
+    // Recommendation is in succeeded state. Recommendations content is
+    // immutable and cannot be updated by Google.
+    //
+    // SUCCEEDED recommendations can be marked as SUCCEEDED, or FAILED.
+    SUCCEEDED = 3;
+
+    // Recommendation is in failed state. Recommendations content is immutable
+    // and cannot be updated by Google.
+    //
+    // FAILED recommendations can be marked as SUCCEEDED, or FAILED.
+    FAILED = 4;
+
+    // Recommendation is in dismissed state. Recommendation content can be
+    // updated by Google.
+    //
+    // DISMISSED recommendations can be marked as ACTIVE.
+    DISMISSED = 5;
+  }
+
+  // The state of the recommendation, Eg ACTIVE, SUCCEEDED, FAILED.
+  State state = 1;
+
+  // A map of metadata for the state, provided by user or automations systems.
+  map state_metadata = 2;
+}
diff --git a/third_party/googleapis/google/cloud/recommender/v1/recommender_gapic.yaml b/third_party/googleapis/google/cloud/recommender/v1/recommender_gapic.yaml
new file mode 100644
index 000000000..7d60eb9d7
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommender/v1/recommender_gapic.yaml
@@ -0,0 +1,18 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 2.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.recommender.v1
+  python:
+    package_name: google.cloud.recommender_v1.gapic
+  go:
+    package_name: cloud.google.com/go/recommender/apiv1
+  csharp:
+    package_name: Google.Cloud.Recommender.V1
+  ruby:
+    package_name: Google::Cloud::Recommender::V1
+  php:
+    package_name: Google\Cloud\Recommender\V1
+  nodejs:
+    package_name: recommender.v1
diff --git a/third_party/googleapis/google/cloud/recommender/v1/recommender_grpc_service_config.json b/third_party/googleapis/google/cloud/recommender/v1/recommender_grpc_service_config.json
new file mode 100644
index 000000000..b21bddfe7
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommender/v1/recommender_grpc_service_config.json
@@ -0,0 +1,44 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.recommender.v1.Recommender",
+          "method": "ListRecommendations"
+        },
+        {
+          "service": "google.cloud.recommender.v1.Recommender",
+          "method": "GetRecommendation"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.recommender.v1.Recommender",
+          "method": "MarkRecommendationClaimed"
+        },
+        {
+          "service": "google.cloud.recommender.v1.Recommender",
+          "method": "MarkRecommendationSucceeded"
+        },
+        {
+          "service": "google.cloud.recommender.v1.Recommender",
+          "method": "MarkRecommendationFailed"
+        }
+      ],
+      "timeout": "60s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/recommender/v1/recommender_service.proto b/third_party/googleapis/google/cloud/recommender/v1/recommender_service.proto
new file mode 100644
index 000000000..97a04f5ac
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommender/v1/recommender_service.proto
@@ -0,0 +1,228 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.recommender.v1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/recommender/v1/recommendation.proto";
+
+option csharp_namespace = "Google.Cloud.Recommender.V1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/recommender/v1;recommender";
+option java_multiple_files = true;
+option java_outer_classname = "RecommenderProto";
+option java_package = "com.google.cloud.recommender.v1";
+option objc_class_prefix = "CREC";
+
+// Provides recommendations for cloud customers for various categories like
+// performance optimization, cost savings, reliability, feature discovery, etc.
+// These recommendations are generated automatically based on analysis of user
+// resources, configuration and monitoring metrics.
+service Recommender {
+  option (google.api.default_host) = "recommender.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // Lists recommendations for a Cloud project. Requires the recommender.*.list
+  // IAM permission for the specified recommender.
+  rpc ListRecommendations(ListRecommendationsRequest) returns (ListRecommendationsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/locations/*/recommenders/*}/recommendations"
+    };
+    option (google.api.method_signature) = "parent";
+    option (google.api.method_signature) = "parent,filter";
+  }
+
+  // Gets the requested recommendation. Requires the recommender.*.get
+  // IAM permission for the specified recommender.
+  rpc GetRecommendation(GetRecommendationRequest) returns (Recommendation) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/*/recommenders/*/recommendations/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Mark the Recommendation State as Claimed. Users can use this method to
+  // indicate to the Recommender API that they are starting to apply the
+  // recommendation themselves. This stops the recommendation content from being
+  // updated.
+  //
+  // MarkRecommendationClaimed can be applied to recommendations in CLAIMED,
+  // SUCCEEDED, FAILED, or ACTIVE state.
+  //
+  // Requires the recommender.*.update IAM permission for the specified
+  // recommender.
+  rpc MarkRecommendationClaimed(MarkRecommendationClaimedRequest) returns (Recommendation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/recommenders/*/recommendations/*}:markClaimed"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name,state_metadata,etag";
+  }
+
+  // Mark the Recommendation State as Succeeded. Users can use this method to
+  // indicate to the Recommender API that they have applied the recommendation
+  // themselves, and the operation was successful. This stops the recommendation
+  // content from being updated.
+  //
+  // MarkRecommendationSucceeded can be applied to recommendations in ACTIVE,
+  // CLAIMED, SUCCEEDED, or FAILED state.
+  //
+  // Requires the recommender.*.update IAM permission for the specified
+  // recommender.
+  rpc MarkRecommendationSucceeded(MarkRecommendationSucceededRequest) returns (Recommendation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/recommenders/*/recommendations/*}:markSucceeded"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name,state_metadata,etag";
+  }
+
+  // Mark the Recommendation State as Failed. Users can use this method to
+  // indicate to the Recommender API that they have applied the recommendation
+  // themselves, and the operation failed. This stops the recommendation content
+  // from being updated.
+  //
+  // MarkRecommendationFailed can be applied to recommendations in ACTIVE,
+  // CLAIMED, SUCCEEDED, or FAILED state.
+  //
+  // Requires the recommender.*.update IAM permission for the specified
+  // recommender.
+  rpc MarkRecommendationFailed(MarkRecommendationFailedRequest) returns (Recommendation) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*/recommenders/*/recommendations/*}:markFailed"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name,state_metadata,etag";
+  }
+}
+
+// Request for the `ListRecommendations` method.
+message ListRecommendationsRequest {
+  // Required. The container resource on which to execute the request.
+  // Acceptable formats:
+  //
+  // 1.
+  // "projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]",
+  //
+  // LOCATION here refers to GCP Locations:
+  // https://cloud.google.com/about/locations/
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommender.googleapis.com/Recommender"
+    }
+  ];
+
+  // Optional. The maximum number of results to return from this request.  Non-positive
+  // values are ignored. If not specified, the server will determine the number
+  // of results to return.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. If present, retrieves the next batch of results from the preceding call to
+  // this method. `page_token` must be the value of `next_page_token` from the
+  // previous response. The values of other method parameters must be identical
+  // to those in the previous call.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Filter expression to restrict the recommendations returned. Supported
+  // filter fields: state_info.state
+  // Eg: `state_info.state:"DISMISSED" or state_info.state:"FAILED"
+  string filter = 5;
+}
+
+// Response to the `ListRecommendations` method.
+message ListRecommendationsResponse {
+  // The set of recommendations for the `parent` resource.
+  repeated Recommendation recommendations = 1;
+
+  // A token that can be used to request the next page of results. This field is
+  // empty if there are no additional results.
+  string next_page_token = 2;
+}
+
+// Request to the `GetRecommendation` method.
+message GetRecommendationRequest {
+  // Required. Name of the recommendation.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommender.googleapis.com/Recommendation"
+    }
+  ];
+}
+
+// Request for the `MarkRecommendationClaimed` Method.
+message MarkRecommendationClaimedRequest {
+  // Required. Name of the recommendation.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommender.googleapis.com/Recommendation"
+    }
+  ];
+
+  // State properties to include with this state. Overwrites any existing
+  // `state_metadata`.
+  // Keys must match the regex /^[a-z0-9][a-z0-9_.-]{0,62}$/.
+  // Values must match the regex /^[a-zA-Z0-9_./-]{0,255}$/.
+  map state_metadata = 2;
+
+  // Required. Fingerprint of the Recommendation. Provides optimistic locking.
+  string etag = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request for the `MarkRecommendationSucceeded` Method.
+message MarkRecommendationSucceededRequest {
+  // Required. Name of the recommendation.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommender.googleapis.com/Recommendation"
+    }
+  ];
+
+  // State properties to include with this state. Overwrites any existing
+  // `state_metadata`.
+  // Keys must match the regex /^[a-z0-9][a-z0-9_.-]{0,62}$/.
+  // Values must match the regex /^[a-zA-Z0-9_./-]{0,255}$/.
+  map state_metadata = 2;
+
+  // Required. Fingerprint of the Recommendation. Provides optimistic locking.
+  string etag = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request for the `MarkRecommendationFailed` Method.
+message MarkRecommendationFailedRequest {
+  // Required. Name of the recommendation.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommender.googleapis.com/Recommendation"
+    }
+  ];
+
+  // State properties to include with this state. Overwrites any existing
+  // `state_metadata`.
+  // Keys must match the regex /^[a-z0-9][a-z0-9_.-]{0,62}$/.
+  // Values must match the regex /^[a-zA-Z0-9_./-]{0,255}$/.
+  map state_metadata = 2;
+
+  // Required. Fingerprint of the Recommendation. Provides optimistic locking.
+  string etag = 3 [(google.api.field_behavior) = REQUIRED];
+}
diff --git a/third_party/googleapis/google/cloud/recommender/v1/recommender_v1.yaml b/third_party/googleapis/google/cloud/recommender/v1/recommender_v1.yaml
new file mode 100644
index 000000000..3fd9f6eb2
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommender/v1/recommender_v1.yaml
@@ -0,0 +1,19 @@
+type: google.api.Service
+config_version: 3
+name: recommender.googleapis.com
+title: Recommender API
+
+apis:
+- name: google.cloud.recommender.v1.Recommender
+
+backend:
+  rules:
+  - selector: 'google.cloud.recommender.v1.Recommender.*'
+    deadline: 30.0
+
+authentication:
+  rules:
+  - selector: 'google.cloud.recommender.v1.Recommender.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/recommender/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/recommender/v1beta1/BUILD.bazel
new file mode 100644
index 000000000..73a2466e1
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommender/v1beta1/BUILD.bazel
@@ -0,0 +1,368 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "recommender_proto",
+    srcs = [
+        "insight.proto",
+        "recommendation.proto",
+        "recommender_service.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/type:money_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:struct_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "recommender_proto_with_info",
+    deps = [
+        ":recommender_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "recommender_java_proto",
+    deps = [":recommender_proto"],
+)
+
+java_grpc_library(
+    name = "recommender_java_grpc",
+    srcs = [":recommender_proto"],
+    deps = [":recommender_java_proto"],
+)
+
+java_gapic_library(
+    name = "recommender_java_gapic",
+    src = ":recommender_proto_with_info",
+    gapic_yaml = "recommender_gapic.yaml",
+    package = "google.cloud.recommender.v1beta1",
+    service_yaml = "recommender_v1beta1.yaml",
+    test_deps = [
+        ":recommender_java_grpc",
+    ],
+    deps = [
+        ":recommender_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "recommender_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.recommender.v1beta1.RecommenderClientTest",
+    ],
+    runtime_deps = [":recommender_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-recommender-v1beta1-java",
+    deps = [
+        ":recommender_java_gapic",
+        ":recommender_java_grpc",
+        ":recommender_java_proto",
+        ":recommender_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "recommender_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/recommender/v1beta1",
+    protos = [":recommender_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/type:money_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "recommender_go_gapic",
+    srcs = [":recommender_proto_with_info"],
+    grpc_service_config = "recommender_grpc_service_config.json",
+    importpath = "cloud.google.com/go/recommender/apiv1beta1;recommender",
+    service_yaml = "recommender_v1beta1.yaml",
+    deps = [
+        ":recommender_go_proto",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
+    ],
+)
+
+go_test(
+    name = "recommender_go_gapic_test",
+    srcs = [":recommender_go_gapic_srcjar_test"],
+    embed = [":recommender_go_gapic"],
+    importpath = "cloud.google.com/go/recommender/apiv1beta1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-recommender-v1beta1-go",
+    deps = [
+        ":recommender_go_gapic",
+        ":recommender_go_gapic_srcjar-test.srcjar",
+        ":recommender_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "recommender_moved_proto",
+    srcs = [":recommender_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/type:money_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:struct_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "recommender_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":recommender_moved_proto"],
+)
+
+py_grpc_library(
+    name = "recommender_py_grpc",
+    srcs = [":recommender_moved_proto"],
+    deps = [":recommender_py_proto"],
+)
+
+py_gapic_library(
+    name = "recommender_py_gapic",
+    src = ":recommender_proto_with_info",
+    gapic_yaml = "recommender_gapic.yaml",
+    package = "google.cloud.recommender.v1beta1",
+    service_yaml = "recommender_v1beta1.yaml",
+    deps = [
+        ":recommender_py_grpc",
+        ":recommender_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "recommender-v1beta1-py",
+    deps = [
+        ":recommender_py_gapic",
+        ":recommender_py_grpc",
+        ":recommender_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "recommender_php_proto",
+    deps = [":recommender_proto"],
+)
+
+php_grpc_library(
+    name = "recommender_php_grpc",
+    srcs = [":recommender_proto"],
+    deps = [":recommender_php_proto"],
+)
+
+php_gapic_library(
+    name = "recommender_php_gapic",
+    src = ":recommender_proto_with_info",
+    gapic_yaml = "recommender_gapic.yaml",
+    package = "google.cloud.recommender.v1beta1",
+    service_yaml = "recommender_v1beta1.yaml",
+    deps = [
+        ":recommender_php_grpc",
+        ":recommender_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-recommender-v1beta1-php",
+    deps = [
+        ":recommender_php_gapic",
+        ":recommender_php_grpc",
+        ":recommender_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "recommender_nodejs_gapic",
+    src = ":recommender_proto_with_info",
+    gapic_yaml = "recommender_gapic.yaml",
+    package = "google.cloud.recommender.v1beta1",
+    service_yaml = "recommender_v1beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "recommender-v1beta1-nodejs",
+    deps = [
+        ":recommender_nodejs_gapic",
+        ":recommender_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "recommender_ruby_proto",
+    deps = [":recommender_proto"],
+)
+
+ruby_grpc_library(
+    name = "recommender_ruby_grpc",
+    srcs = [":recommender_proto"],
+    deps = [":recommender_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "recommender_ruby_gapic",
+    src = ":recommender_proto_with_info",
+    gapic_yaml = "recommender_gapic.yaml",
+    package = "google.cloud.recommender.v1beta1",
+    service_yaml = "recommender_v1beta1.yaml",
+    deps = [
+        ":recommender_ruby_grpc",
+        ":recommender_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-recommender-v1beta1-ruby",
+    deps = [
+        ":recommender_ruby_gapic",
+        ":recommender_ruby_grpc",
+        ":recommender_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "recommender_csharp_proto",
+    deps = [":recommender_proto"],
+)
+
+csharp_grpc_library(
+    name = "recommender_csharp_grpc",
+    srcs = [":recommender_proto"],
+    deps = [":recommender_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "recommender_csharp_gapic",
+    src = ":recommender_proto_with_info",
+    gapic_yaml = "recommender_gapic.yaml",
+    package = "google.cloud.recommender.v1beta1",
+    service_yaml = "recommender_v1beta1.yaml",
+    deps = [
+        ":recommender_csharp_grpc",
+        ":recommender_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-recommender-v1beta1-csharp",
+    deps = [
+        ":recommender_csharp_gapic",
+        ":recommender_csharp_grpc",
+        ":recommender_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/recommender/artman_recommender_v1beta1.yaml b/third_party/googleapis/google/cloud/recommender/v1beta1/artman_recommender_v1beta1.yaml
similarity index 84%
rename from third_party/googleapis/google/cloud/recommender/artman_recommender_v1beta1.yaml
rename to third_party/googleapis/google/cloud/recommender/v1beta1/artman_recommender_v1beta1.yaml
index e66456bf0..603f1ca7c 100644
--- a/third_party/googleapis/google/cloud/recommender/artman_recommender_v1beta1.yaml
+++ b/third_party/googleapis/google/cloud/recommender/v1beta1/artman_recommender_v1beta1.yaml
@@ -5,9 +5,11 @@ common:
   proto_deps:
   - name: google-common-protos
   src_proto_paths:
-  - v1beta1
+  - .
   service_yaml: recommender_v1beta1.yaml
-  gapic_yaml: v1beta1/recommender_gapic.yaml
+  gapic_yaml: recommender_gapic.yaml
+  proto_package: google.cloud.recommender.v1beta1
+  samples: samples
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/cloud/recommender/v1beta1/insight.proto b/third_party/googleapis/google/cloud/recommender/v1beta1/insight.proto
new file mode 100644
index 000000000..f968bd118
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommender/v1beta1/insight.proto
@@ -0,0 +1,134 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.recommender.v1beta1;
+
+import "google/api/resource.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/struct.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.Recommender.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/recommender/v1beta1;recommender";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.recommender.v1beta1";
+option objc_class_prefix = "CREC";
+option (google.api.resource_definition) = {
+  type: "recommender.googleapis.com/InsightType"
+  pattern: "projects/{project}/locations/{location}/insightTypes/{insight_type}"
+};
+
+// An insight along with the information used to derive the insight. The insight
+// may have associated recomendations as well.
+message Insight {
+  option (google.api.resource) = {
+    type: "recommender.googleapis.com/Insight"
+    pattern: "projects/{project}/locations/{location}/insightTypes/{insight_type}/insights/{insight}"
+  };
+
+  // Reference to an associated recommendation.
+  message RecommendationReference {
+    // Recommendation resource name, e.g.
+    // projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/recommendations/[RECOMMENDATION_ID]
+    string recommendation = 1;
+  }
+
+  // Insight category.
+  enum Category {
+    // Unspecified category.
+    CATEGORY_UNSPECIFIED = 0;
+
+    // The insight is related to cost.
+    COST = 1;
+
+    // The insight is related to security.
+    SECURITY = 2;
+
+    // The insight is related to performance.
+    PERFORMANCE = 3;
+
+    // This insight is related to manageability.
+    MANAGEABILITY = 4;
+  }
+
+  // Name of the insight.
+  string name = 1;
+
+  // Free-form human readable summary in English. The maximum length is 500
+  // characters.
+  string description = 2;
+
+  // Fully qualified resource names that this insight is targeting.
+  repeated string target_resources = 9;
+
+  // Insight subtype. Insight content schema will be stable for a given subtype.
+  string insight_subtype = 10;
+
+  // A struct of custom fields to explain the insight.
+  // Example: "grantedPermissionsCount": "1000"
+  google.protobuf.Struct content = 3;
+
+  // Timestamp of the latest data used to generate the insight.
+  google.protobuf.Timestamp last_refresh_time = 4;
+
+  // Observation period that led to the insight. The source data used to
+  // generate the insight ends at last_refresh_time and begins at
+  // (last_refresh_time - observation_period).
+  google.protobuf.Duration observation_period = 5;
+
+  // Information state and metadata.
+  InsightStateInfo state_info = 6;
+
+  // Category being targeted by the insight.
+  Category category = 7;
+
+  // Fingerprint of the Insight. Provides optimistic locking when updating
+  // states.
+  string etag = 11;
+
+  // Recommendations derived from this insight.
+  repeated RecommendationReference associated_recommendations = 8;
+}
+
+// Information related to insight state.
+message InsightStateInfo {
+  // Represents insight state.
+  enum State {
+    // Unspecified state.
+    STATE_UNSPECIFIED = 0;
+
+    // Insight is active. Content for ACTIVE insights can be updated by Google.
+    // ACTIVE insights can be marked DISMISSED OR ACCEPTED.
+    ACTIVE = 1;
+
+    // Some action has been taken based on this insight. Insights become
+    // accepted when a recommendation derived from the insight has been marked
+    // CLAIMED, SUCCEEDED, or FAILED. ACTIVE insights can also be marked
+    // ACCEPTED explicitly. Content for ACCEPTED insights is immutable. ACCEPTED
+    // insights can only be marked ACCEPTED (which may update state metadata).
+    ACCEPTED = 2;
+
+    // Insight is dismissed. Content for DISMISSED insights can be updated by
+    // Google. DISMISSED insights can be marked as ACTIVE.
+    DISMISSED = 3;
+  }
+
+  // Insight state.
+  State state = 1;
+
+  // A map of metadata for the state, provided by user or automations systems.
+  map state_metadata = 2;
+}
diff --git a/third_party/googleapis/google/cloud/recommender/v1beta1/recommendation.proto b/third_party/googleapis/google/cloud/recommender/v1beta1/recommendation.proto
index 8980de0c4..79c4afee8 100644
--- a/third_party/googleapis/google/cloud/recommender/v1beta1/recommendation.proto
+++ b/third_party/googleapis/google/cloud/recommender/v1beta1/recommendation.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,12 +11,12 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.recommender.v1beta1;
 
+import "google/api/resource.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/struct.proto";
 import "google/protobuf/timestamp.proto";
@@ -27,14 +27,27 @@ option go_package = "google.golang.org/genproto/googleapis/cloud/recommender/v1b
 option java_multiple_files = true;
 option java_package = "com.google.cloud.recommender.v1beta1";
 option objc_class_prefix = "CREC";
+option (google.api.resource_definition) = {
+  type: "recommender.googleapis.com/Recommender"
+  pattern: "projects/{project}/locations/{location}/recommenders/{recommender}"
+};
 
 // A recommendation along with a suggested action. E.g., a rightsizing
 // recommendation for an underutilized VM, IAM role recommendations, etc
 message Recommendation {
+  option (google.api.resource) = {
+    type: "recommender.googleapis.com/Recommendation"
+    pattern: "projects/{project}/locations/{location}/recommenders/{recommender}/recommendations/{recommendation}"
+  };
+
+  // Reference to an associated insight.
+  message InsightReference {
+    // Insight resource name, e.g.
+    // projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/insights/[INSIGHT_ID]
+    string insight = 1;
+  }
+
   // Name of recommendation.
-  //
-  // A project recommendation is represented as
-  //   projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/recommendations/[RECOMMENDATION_ID]
   string name = 1;
 
   // Free-form human readable summary in English. The maximum length is 500
@@ -43,11 +56,12 @@ message Recommendation {
 
   // Contains an identifier for a subtype of recommendations produced for the
   // same recommender. Subtype is a function of content and impact, meaning a
-  // new subtype will be added when either content or primary impact category
-  // changes.
+  // new subtype might be added when significant changes to `content` or
+  // `primary_impact.category` are introduced. See the Recommenders section
+  // to see a list of subtypes for a given Recommender.
   //
   // Examples:
-  //   For recommender = "google.iam.policy.RoleRecommender",
+  //   For recommender = "google.iam.policy.Recommender",
   //   recommender_subtype can be one of "REMOVE_ROLE"/"REPLACE_ROLE"
   string recommender_subtype = 12;
 
@@ -73,6 +87,9 @@ message Recommendation {
   // Fingerprint of the Recommendation. Provides optimistic locking when
   // updating states.
   string etag = 11;
+
+  // Insights that led to this recommendation.
+  repeated InsightReference associated_insights = 14;
 }
 
 // Contains what resources are changing and how they are changing.
@@ -90,8 +107,9 @@ message OperationGroup {
   repeated Operation operations = 1;
 }
 
-// Contains an operation for a resource inspired by the JSON-PATCH format with
-// support for:
+// Contains an operation for a resource loosely based on the JSON-PATCH format
+// with support for:
+//
 // * Custom filters for describing partial array patch.
 // * Extended path values for describing nested arrays.
 // * Custom fields for describing the resource for which the operation is being
@@ -100,7 +118,7 @@ message OperationGroup {
 // See https://tools.ietf.org/html/rfc6902 for details on the original RFC.
 message Operation {
   // Type of this operation. Contains one of 'and', 'remove', 'replace', 'move',
-  // 'copy', 'test' and custom operations. This field is case-insensitive and
+  // 'copy', 'test' and 'custom' operations. This field is case-insensitive and
   // always populated.
   string action = 1;
 
@@ -128,26 +146,57 @@ message Operation {
   // resource or source_resource, ignored if provided for other operation types.
   string source_path = 6;
 
-  // Value for the `path` field. Set if action is 'add'/'replace'/'test'.
-  google.protobuf.Value value = 7;
+  // One of the fields in the following block will be set and intend to
+  // describe a value for 'path' field.
+  oneof path_value {
+    // Value for the `path` field. Will be set for actions:'add'/'replace'.
+    // Maybe set for action: 'test'. Either this or `value_matcher` will be set
+    // for 'test' operation. An exact match must be performed.
+    google.protobuf.Value value = 7;
+
+    // Can be set for action 'test' for advanced matching for the value of
+    // 'path' field. Either this or `value` will be set for 'test' operation.
+    ValueMatcher value_matcher = 10;
+  }
 
   // Set of filters to apply if `path` refers to array elements or nested array
   // elements in order to narrow down to a single unique element that is being
   // tested/modified.
-  // Note that this is intended to be an exact match per filter.
-  // Example: {
+  // This is intended to be an exact match per filter. To perform advanced
+  // matching, use path_value_matchers.
+  //
+  // * Example: {
   //   "/versions/*/name" : "it-123"
   //   "/versions/*/targetSize/percent": 20
-  // }
-  // Example: {
+  //   }
+  // * Example: {
   //   "/bindings/*/role": "roles/admin"
   //   "/bindings/*/condition" : null
-  // }
-  // Example: {
+  //   }
+  // * Example: {
   //   "/bindings/*/role": "roles/admin"
   //   "/bindings/*/members/*" : ["x@google.com", "y@google.com"]
-  // }
+  //   }
+  // When both path_filters and path_value_matchers are set, an implicit AND
+  // must be performed.
   map path_filters = 8;
+
+  // Similar to path_filters, this contains set of filters to apply if `path`
+  // field referes to array elements. This is meant to support value matching
+  // beyond exact match. To perform exact match, use path_filters.
+  // When both path_filters and path_value_matchers are set, an implicit AND
+  // must be performed.
+  map path_value_matchers = 11;
+}
+
+// Contains various matching options for values for a GCP resource field.
+message ValueMatcher {
+  oneof match_variant {
+    // To be used for full regex matching. The regular expression is using the
+    // Google RE2 syntax (https://github.com/google/re2/wiki/Syntax), so to be
+    // used with RE2::FullMatch
+    string matches_pattern = 1;
+  }
 }
 
 // Contains metadata about how much money a recommendation can save or incur.
@@ -176,6 +225,9 @@ message Impact {
 
     // Indicates a potential increase or decrease in performance.
     PERFORMANCE = 3;
+
+    // Indicates a potential increase or decrease in manageability.
+    MANAGEABILITY = 4;
   }
 
   // Category that is being targeted.
@@ -190,7 +242,7 @@ message Impact {
 
 // Information for state. Contains state and metadata.
 message RecommendationStateInfo {
-  // Represents Recommendation State
+  // Represents Recommendation State.
   enum State {
     // Default state. Don't use directly.
     STATE_UNSPECIFIED = 0;
diff --git a/third_party/googleapis/google/cloud/recommender/v1beta1/recommender_gapic.legacy.yaml b/third_party/googleapis/google/cloud/recommender/v1beta1/recommender_gapic.legacy.yaml
new file mode 100644
index 000000000..e19916a41
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommender/v1beta1/recommender_gapic.legacy.yaml
@@ -0,0 +1,178 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.recommender.v1beta1
+  python:
+    package_name: google.cloud.recommender_v1beta1.gapic
+  go:
+    package_name: cloud.google.com/go/recommender/apiv1beta1
+  csharp:
+    package_name: Google.Cloud.Recommender.V1Beta1
+  ruby:
+    package_name: Google::Cloud::Recommender::V1beta1
+  php:
+    package_name: Google\Cloud\Recommender\V1beta1
+  nodejs:
+    package_name: recommender.v1beta1
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: google.cloud.recommender.v1beta1.Recommender
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}/locations/{location}/recommenders/{recommender}
+    entity_name: recommender
+  - name_pattern: projects/{project}/locations/{location}/recommenders/{recommender}/recommendations/{recommendation}
+    entity_name: recommendation
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ListRecommendations
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - filter
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: recommendations
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: recommender
+    timeout_millis: 60000
+  - name: GetRecommendation
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: recommendation
+    timeout_millis: 60000
+  - name: MarkRecommendationClaimed
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - state_metadata
+        - etag
+    required_fields:
+    - name
+    - etag
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: recommendation
+    timeout_millis: 60000
+  - name: MarkRecommendationSucceeded
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - state_metadata
+        - etag
+    required_fields:
+    - name
+    - etag
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: recommendation
+    timeout_millis: 60000
+  - name: MarkRecommendationFailed
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - state_metadata
+        - etag
+    required_fields:
+    - name
+    - etag
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: recommendation
+    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/recommender/v1beta1/recommender_gapic.yaml b/third_party/googleapis/google/cloud/recommender/v1beta1/recommender_gapic.yaml
index 2acecf311..174c69519 100644
--- a/third_party/googleapis/google/cloud/recommender/v1beta1/recommender_gapic.yaml
+++ b/third_party/googleapis/google/cloud/recommender/v1beta1/recommender_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -9,166 +9,10 @@ language_settings:
   go:
     package_name: cloud.google.com/go/recommender/apiv1beta1
   csharp:
-    package_name: Google.Cloud.Recommender.V1beta1
+    package_name: Google.Cloud.Recommender.V1Beta1
   ruby:
     package_name: Google::Cloud::Recommender::V1beta1
   php:
     package_name: Google\Cloud\Recommender\V1beta1
   nodejs:
     package_name: recommender.v1beta1
-# A list of API interface configurations.
-interfaces:
-# The fully qualified name of the API interface.
-- name: google.cloud.recommender.v1beta1.Recommender
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections:
-  - name_pattern: projects/{project}/locations/{location}/recommenders/{recommender}
-    entity_name: recommender
-  - name_pattern: projects/{project}/locations/{location}/recommenders/{recommender}/recommendations/{recommendation}
-    entity_name: recommendation
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
-  methods:
-  - name: ListRecommendations
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: recommendations
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: recommender
-    timeout_millis: 60000
-  - name: GetRecommendation
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: recommendation
-    timeout_millis: 60000
-  - name: MarkRecommendationClaimed
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - etag
-    required_fields:
-    - name
-    - etag
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: recommendation
-    timeout_millis: 60000
-  - name: MarkRecommendationSucceeded
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - etag
-    required_fields:
-    - name
-    - etag
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: recommendation
-    timeout_millis: 60000
-  - name: MarkRecommendationFailed
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - etag
-    required_fields:
-    - name
-    - etag
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: recommendation
-    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/recommender/v1beta1/recommender_grpc_service_config.json b/third_party/googleapis/google/cloud/recommender/v1beta1/recommender_grpc_service_config.json
new file mode 100644
index 000000000..e9ce1b197
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommender/v1beta1/recommender_grpc_service_config.json
@@ -0,0 +1,56 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.recommender.v1beta1.Recommender",
+          "method": "ListInsights"
+        },
+        {
+          "service": "google.cloud.recommender.v1beta1.Recommender",
+          "method": "GetInsight"
+        },
+        {
+          "service": "google.cloud.recommender.v1beta1.Recommender",
+          "method": "ListRecommendations"
+        },
+        {
+          "service": "google.cloud.recommender.v1beta1.Recommender",
+          "method": "GetRecommendation"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.recommender.v1beta1.Recommender",
+          "method": "MarkInsightAccepted"
+        },
+        {
+          "service": "google.cloud.recommender.v1beta1.Recommender",
+          "method": "MarkRecommendationClaimed"
+        },
+        {
+          "service": "google.cloud.recommender.v1beta1.Recommender",
+          "method": "MarkRecommendationSucceeded"
+        },
+        {
+          "service": "google.cloud.recommender.v1beta1.Recommender",
+          "method": "MarkRecommendationFailed"
+        }
+      ],
+      "timeout": "60s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/recommender/v1beta1/recommender_service.proto b/third_party/googleapis/google/cloud/recommender/v1beta1/recommender_service.proto
index 49a076ae7..8f4df1a7d 100644
--- a/third_party/googleapis/google/cloud/recommender/v1beta1/recommender_service.proto
+++ b/third_party/googleapis/google/cloud/recommender/v1beta1/recommender_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,38 +11,72 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.recommender.v1beta1;
 
 import "google/api/annotations.proto";
-import "google/cloud/recommender/v1beta1/recommendation.proto";
-import "google/longrunning/operations.proto";
 import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/recommender/v1beta1/insight.proto";
+import "google/cloud/recommender/v1beta1/recommendation.proto";
 
-option csharp_namespace = "Google.Cloud.Recommmender.V1Beta1";
+option csharp_namespace = "Google.Cloud.Recommender.V1Beta1";
 option go_package = "google.golang.org/genproto/googleapis/cloud/recommender/v1beta1;recommender";
 option java_multiple_files = true;
 option java_outer_classname = "RecommenderProto";
 option java_package = "com.google.cloud.recommender.v1beta1";
 option objc_class_prefix = "CREC";
 
-// Provides recommendations for cloud customers for various categories like
-// performance optimization, cost savings, reliability, feature discovery, etc.
-// These recommendations are generated automatically based on analysis of user
-// resources, configuration and monitoring metrics.
+// Provides insights and recommendations for cloud customers for various
+// categories like performance optimization, cost savings, reliability, feature
+// discovery, etc. Insights and recommendations are generated automatically
+// based on analysis of user resources, configuration and monitoring metrics.
 service Recommender {
   option (google.api.default_host) = "recommender.googleapis.com";
   option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
 
+  // Lists insights for a Cloud project. Requires the recommender.*.list IAM
+  // permission for the specified insight type.
+  rpc ListInsights(ListInsightsRequest) returns (ListInsightsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/locations/*/insightTypes/*}/insights"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Gets the requested insight. Requires the recommender.*.get IAM permission
+  // for the specified insight type.
+  rpc GetInsight(GetInsightRequest) returns (Insight) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/locations/*/insightTypes/*/insights/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Marks the Insight State as Accepted. Users can use this method to
+  // indicate to the Recommender API that they have applied some action based
+  // on the insight. This stops the insight content from being updated.
+  //
+  // MarkInsightAccepted can be applied to insights in ACTIVE state. Requires
+  // the recommender.*.update IAM permission for the specified insight.
+  rpc MarkInsightAccepted(MarkInsightAcceptedRequest) returns (Insight) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/insightTypes/*/insights/*}:markAccepted"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name,state_metadata,etag";
+  }
+
   // Lists recommendations for a Cloud project. Requires the recommender.*.list
   // IAM permission for the specified recommender.
   rpc ListRecommendations(ListRecommendationsRequest) returns (ListRecommendationsResponse) {
     option (google.api.http) = {
       get: "/v1beta1/{parent=projects/*/locations/*/recommenders/*}/recommendations"
     };
+    option (google.api.method_signature) = "parent,filter";
   }
 
   // Gets the requested recommendation. Requires the recommender.*.get
@@ -51,15 +85,16 @@ service Recommender {
     option (google.api.http) = {
       get: "/v1beta1/{name=projects/*/locations/*/recommenders/*/recommendations/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
-  // Mark the Recommendation State as Claimed. Users can use this method to
+  // Marks the Recommendation State as Claimed. Users can use this method to
   // indicate to the Recommender API that they are starting to apply the
   // recommendation themselves. This stops the recommendation content from being
-  // updated.
+  // updated. Associated insights are frozen and placed in the ACCEPTED state.
   //
-  // MarkRecommendationClaimed can be applied to recommendations in CLAIMED,
-  // SUCCEEDED, FAILED, or ACTIVE state.
+  // MarkRecommendationClaimed can be applied to recommendations in CLAIMED or
+  // ACTIVE state.
   //
   // Requires the recommender.*.update IAM permission for the specified
   // recommender.
@@ -68,12 +103,14 @@ service Recommender {
       post: "/v1beta1/{name=projects/*/locations/*/recommenders/*/recommendations/*}:markClaimed"
       body: "*"
     };
+    option (google.api.method_signature) = "name,state_metadata,etag";
   }
 
-  // Mark the Recommendation State as Succeeded. Users can use this method to
+  // Marks the Recommendation State as Succeeded. Users can use this method to
   // indicate to the Recommender API that they have applied the recommendation
   // themselves, and the operation was successful. This stops the recommendation
-  // content from being updated.
+  // content from being updated. Associated insights are frozen and placed in
+  // the ACCEPTED state.
   //
   // MarkRecommendationSucceeded can be applied to recommendations in ACTIVE,
   // CLAIMED, SUCCEEDED, or FAILED state.
@@ -85,12 +122,14 @@ service Recommender {
       post: "/v1beta1/{name=projects/*/locations/*/recommenders/*/recommendations/*}:markSucceeded"
       body: "*"
     };
+    option (google.api.method_signature) = "name,state_metadata,etag";
   }
 
-  // Mark the Recommendation State as Failed. Users can use this method to
+  // Marks the Recommendation State as Failed. Users can use this method to
   // indicate to the Recommender API that they have applied the recommendation
   // themselves, and the operation failed. This stops the recommendation content
-  // from being updated.
+  // from being updated. Associated insights are frozen and placed in the
+  // ACCEPTED state.
   //
   // MarkRecommendationFailed can be applied to recommendations in ACTIVE,
   // CLAIMED, SUCCEEDED, or FAILED state.
@@ -102,9 +141,83 @@ service Recommender {
       post: "/v1beta1/{name=projects/*/locations/*/recommenders/*/recommendations/*}:markFailed"
       body: "*"
     };
+    option (google.api.method_signature) = "name,state_metadata,etag";
   }
 }
 
+// Request for the `ListInsights` method.
+message ListInsightsRequest {
+  // Required. The container resource on which to execute the request.
+  // Acceptable formats:
+  //
+  // 1.
+  // "projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]",
+  //
+  // LOCATION here refers to GCP Locations:
+  // https://cloud.google.com/about/locations/
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommender.googleapis.com/InsightType"
+    }
+  ];
+
+  // Optional. The maximum number of results to return from this request.  Non-positive
+  // values are ignored. If not specified, the server will determine the number
+  // of results to return.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. If present, retrieves the next batch of results from the preceding call to
+  // this method. `page_token` must be the value of `next_page_token` from the
+  // previous response. The values of other method parameters must be identical
+  // to those in the previous call.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Filter expression to restrict the insights returned. Supported
+  // filter fields: state
+  // Eg: `state:"DISMISSED" or state:"ACTIVE"
+  string filter = 4 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response to the `ListInsights` method.
+message ListInsightsResponse {
+  // The set of insights for the `parent` resource.
+  repeated Insight insights = 1;
+
+  // A token that can be used to request the next page of results. This field is
+  // empty if there are no additional results.
+  string next_page_token = 2;
+}
+
+// Request to the `GetInsight` method.
+message GetInsightRequest {
+  // Required. Name of the insight.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommender.googleapis.com/Insight"
+    }
+  ];
+}
+
+// Request for the `MarkInsightAccepted` method.
+message MarkInsightAcceptedRequest {
+  // Required. Name of the insight.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommender.googleapis.com/Insight"
+    }
+  ];
+
+  // Optional. State properties user wish to include with this state.  Full replace of the
+  // current state_metadata.
+  map state_metadata = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. Fingerprint of the Insight. Provides optimistic locking.
+  string etag = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
 // Request for the `ListRecommendations` method.
 message ListRecommendationsRequest {
   // Required. The container resource on which to execute the request.
@@ -115,18 +228,23 @@ message ListRecommendationsRequest {
   //
   // LOCATION here refers to GCP Locations:
   // https://cloud.google.com/about/locations/
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommender.googleapis.com/Recommender"
+    }
+  ];
 
-  // Optional. The maximum number of results to return from this request.
-  // Non-positive values are ignored. If not specified, the server will
-  // determine the number of results to return.
-  int32 page_size = 2;
+  // Optional. The maximum number of results to return from this request.  Non-positive
+  // values are ignored. If not specified, the server will determine the number
+  // of results to return.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. If present, retrieves the next batch of results from the
-  // preceding call to this method. `page_token` must be the value of
-  // `next_page_token` from the previous response. The values of other method
-  // parameters must be identical to those in the previous call.
-  string page_token = 3;
+  // Optional. If present, retrieves the next batch of results from the preceding call to
+  // this method. `page_token` must be the value of `next_page_token` from the
+  // previous response. The values of other method parameters must be identical
+  // to those in the previous call.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
 
   // Filter expression to restrict the recommendations returned. Supported
   // filter fields: state_info.state
@@ -146,45 +264,71 @@ message ListRecommendationsResponse {
 
 // Request to the `GetRecommendation` method.
 message GetRecommendationRequest {
-  // Name of the recommendation.
-  string name = 1;
+  // Required. Name of the recommendation.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommender.googleapis.com/Recommendation"
+    }
+  ];
 }
 
 // Request for the `MarkRecommendationClaimed` Method.
 message MarkRecommendationClaimedRequest {
-  // Name of the recommendation.
-  string name = 1;
+  // Required. Name of the recommendation.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommender.googleapis.com/Recommendation"
+    }
+  ];
 
   // State properties to include with this state. Overwrites any existing
   // `state_metadata`.
+  // Keys must match the regex /^[a-z0-9][a-z0-9_.-]{0,62}$/.
+  // Values must match the regex /^[a-zA-Z0-9_./-]{0,255}$/.
   map state_metadata = 2;
 
-  // Fingerprint of the Recommendation. Provides optimistic locking.
-  string etag = 3;
+  // Required. Fingerprint of the Recommendation. Provides optimistic locking.
+  string etag = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for the `MarkRecommendationSucceeded` Method.
 message MarkRecommendationSucceededRequest {
-  // Name of the recommendation.
-  string name = 1;
+  // Required. Name of the recommendation.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommender.googleapis.com/Recommendation"
+    }
+  ];
 
   // State properties to include with this state. Overwrites any existing
   // `state_metadata`.
+  // Keys must match the regex /^[a-z0-9][a-z0-9_.-]{0,62}$/.
+  // Values must match the regex /^[a-zA-Z0-9_./-]{0,255}$/.
   map state_metadata = 2;
 
-  // Fingerprint of the Recommendation. Provides optimistic locking.
-  string etag = 3;
+  // Required. Fingerprint of the Recommendation. Provides optimistic locking.
+  string etag = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for the `MarkRecommendationFailed` Method.
 message MarkRecommendationFailedRequest {
-  // Name of the recommendation.
-  string name = 1;
+  // Required. Name of the recommendation.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "recommender.googleapis.com/Recommendation"
+    }
+  ];
 
   // State properties to include with this state. Overwrites any existing
   // `state_metadata`.
+  // Keys must match the regex /^[a-z0-9][a-z0-9_.-]{0,62}$/.
+  // Values must match the regex /^[a-zA-Z0-9_./-]{0,255}$/.
   map state_metadata = 2;
 
-  // Fingerprint of the Recommendation. Provides optimistic locking.
-  string etag = 3;
+  // Required. Fingerprint of the Recommendation. Provides optimistic locking.
+  string etag = 3 [(google.api.field_behavior) = REQUIRED];
 }
diff --git a/third_party/googleapis/google/cloud/recommender/recommender_v1beta1.yaml b/third_party/googleapis/google/cloud/recommender/v1beta1/recommender_v1beta1.yaml
similarity index 95%
rename from third_party/googleapis/google/cloud/recommender/recommender_v1beta1.yaml
rename to third_party/googleapis/google/cloud/recommender/v1beta1/recommender_v1beta1.yaml
index d72478e8e..9b53d26d3 100644
--- a/third_party/googleapis/google/cloud/recommender/recommender_v1beta1.yaml
+++ b/third_party/googleapis/google/cloud/recommender/v1beta1/recommender_v1beta1.yaml
@@ -9,7 +9,7 @@ apis:
 backend:
   rules:
   - selector: 'google.cloud.recommender.v1beta1.Recommender.*'
-    deadline: 30.0
+    deadline: 3.0
 
 authentication:
   rules:
diff --git a/third_party/googleapis/google/cloud/recommender/v1beta1/samples/list_recommendations.yaml b/third_party/googleapis/google/cloud/recommender/v1beta1/samples/list_recommendations.yaml
new file mode 100644
index 000000000..b3086c07d
--- /dev/null
+++ b/third_party/googleapis/google/cloud/recommender/v1beta1/samples/list_recommendations.yaml
@@ -0,0 +1,18 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
+samples:
+- title: List Recommendations
+  service: google.cloud.recommender.v1beta1.Recommender
+  description: |
+    List recommendations for a specified project, location, and recommender.
+  rpc: ListRecommendations
+  request:
+  - field: parent
+    value: "projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER]"
+  response:
+  - define: recommendation = $resp
+  - print: ["Recommendation name: %s", recommendation.name]
+  - print: ["- description: %s", recommendation.description]
+  - print: ["- primary_impact.category: %s", recommendation.primary_impact.category]
+  - print: ["- state_info.state: %s", recommendation.state_info.state]
+  - print: ["- last_refresh_time: %s", recommendation.last_refresh_time]
diff --git a/third_party/googleapis/google/cloud/redis/BUILD.bazel b/third_party/googleapis/google/cloud/redis/BUILD.bazel
index 1e5b8c2af..a87c57fec 100644
--- a/third_party/googleapis/google/cloud/redis/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/redis/BUILD.bazel
@@ -1 +1 @@
-exports_files(glob(["*.yaml"]))
\ No newline at end of file
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/cloud/redis/v1/BUILD.bazel b/third_party/googleapis/google/cloud/redis/v1/BUILD.bazel
index 1f6917e05..dec68f01e 100644
--- a/third_party/googleapis/google/cloud/redis/v1/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/redis/v1/BUILD.bazel
@@ -1,9 +1,12 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
@@ -14,6 +17,7 @@ proto_library(
     deps = [
         "//google/api:annotations_proto",
         "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
         "//google/api:resource_proto",
         "//google/longrunning:operations_proto",
         "@com_google_protobuf//:field_mask_proto",
@@ -23,7 +27,10 @@ proto_library(
 
 proto_library_with_info(
     name = "redis_proto_with_info",
-    deps = [":redis_proto"],
+    deps = [
+        ":redis_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -31,18 +38,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
     name = "redis_java_proto",
     deps = [":redis_proto"],
@@ -51,51 +53,40 @@ java_proto_library(
 java_grpc_library(
     name = "redis_java_grpc",
     srcs = [":redis_proto"],
-    deps = [":redis_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "redis_resource_name_java_proto",
-    gapic_yaml = "redis_gapic.yaml",
-    deps = [":redis_proto"],
+    deps = [":redis_java_proto"],
 )
 
 java_gapic_library(
     name = "redis_java_gapic",
     src = ":redis_proto_with_info",
     gapic_yaml = "redis_gapic.yaml",
-    service_yaml = "//google/cloud/redis:redis_v1.yaml",
-    test_deps = [":redis_java_grpc"],
+    package = "google.cloud.redis.v1",
+    service_yaml = "redis_v1.yaml",
+    test_deps = [
+        ":redis_java_grpc",
+    ],
     deps = [
         ":redis_java_proto",
-        ":redis_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":redis_java_gapic_test",
+java_gapic_test(
+    name = "redis_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.redis.v1.CloudRedisClientTest",
     ],
-) for test_name in [
-    "com.google.cloud.redis.v1.CloudRedisClientTest",
-]]
+    runtime_deps = [":redis_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-redis-v1-java",
-    client_deps = [":redis_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":redis_java_gapic_test"],
-    grpc_deps = [":redis_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":redis_java_gapic",
+        ":redis_java_grpc",
         ":redis_java_proto",
         ":redis_proto",
-        ":redis_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -103,10 +94,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -122,15 +113,16 @@ go_proto_library(
 
 go_gapic_library(
     name = "redis_go_gapic",
-    src = ":redis_proto_with_info",
-    gapic_yaml = "redis_gapic.yaml",
-    importpath = "cloud.google.com/go/redis/apiv1",
-    service_yaml = "//google/cloud/redis:redis_v1.yaml",
+    srcs = [":redis_proto_with_info"],
+    grpc_service_config = "redis_grpc_service_config.json",
+    importpath = "cloud.google.com/go/redis/apiv1;redis",
+    service_yaml = "redis_v1.yaml",
     deps = [
         ":redis_go_proto",
         "//google/longrunning:longrunning_go_gapic",
         "//google/longrunning:longrunning_go_proto",
         "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
     ],
 )
 
@@ -141,13 +133,235 @@ go_test(
     importpath = "cloud.google.com/go/redis/apiv1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-redis-v1-go",
     deps = [
         ":redis_go_gapic",
-        ":redis_go_gapic_srcjar-smoke-test.srcjar",
         ":redis_go_gapic_srcjar-test.srcjar",
         ":redis_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "redis_moved_proto",
+    srcs = [":redis_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "redis_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":redis_moved_proto"],
+)
+
+py_grpc_library(
+    name = "redis_py_grpc",
+    srcs = [":redis_moved_proto"],
+    deps = [":redis_py_proto"],
+)
+
+py_gapic_library(
+    name = "redis_py_gapic",
+    src = ":redis_proto_with_info",
+    gapic_yaml = "redis_gapic.yaml",
+    package = "google.cloud.redis.v1",
+    service_yaml = "redis_v1.yaml",
+    deps = [
+        ":redis_py_grpc",
+        ":redis_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "redis-v1-py",
+    deps = [
+        ":redis_py_gapic",
+        ":redis_py_grpc",
+        ":redis_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "redis_php_proto",
+    deps = [":redis_proto"],
+)
+
+php_grpc_library(
+    name = "redis_php_grpc",
+    srcs = [":redis_proto"],
+    deps = [":redis_php_proto"],
+)
+
+php_gapic_library(
+    name = "redis_php_gapic",
+    src = ":redis_proto_with_info",
+    gapic_yaml = "redis_gapic.yaml",
+    package = "google.cloud.redis.v1",
+    service_yaml = "redis_v1.yaml",
+    deps = [
+        ":redis_php_grpc",
+        ":redis_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-redis-v1-php",
+    deps = [
+        ":redis_php_gapic",
+        ":redis_php_grpc",
+        ":redis_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "redis_nodejs_gapic",
+    src = ":redis_proto_with_info",
+    gapic_yaml = "redis_gapic.yaml",
+    package = "google.cloud.redis.v1",
+    service_yaml = "redis_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "redis-v1-nodejs",
+    deps = [
+        ":redis_nodejs_gapic",
+        ":redis_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "redis_ruby_proto",
+    deps = [":redis_proto"],
+)
+
+ruby_grpc_library(
+    name = "redis_ruby_grpc",
+    srcs = [":redis_proto"],
+    deps = [":redis_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "redis_ruby_gapic",
+    src = ":redis_proto_with_info",
+    gapic_yaml = "redis_gapic.yaml",
+    package = "google.cloud.redis.v1",
+    service_yaml = "redis_v1.yaml",
+    deps = [
+        ":redis_ruby_grpc",
+        ":redis_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-redis-v1-ruby",
+    deps = [
+        ":redis_ruby_gapic",
+        ":redis_ruby_grpc",
+        ":redis_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "redis_csharp_proto",
+    deps = [":redis_proto"],
+)
+
+csharp_grpc_library(
+    name = "redis_csharp_grpc",
+    srcs = [":redis_proto"],
+    deps = [":redis_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "redis_csharp_gapic",
+    src = ":redis_proto_with_info",
+    gapic_yaml = "redis_gapic.yaml",
+    package = "google.cloud.redis.v1",
+    service_yaml = "redis_v1.yaml",
+    deps = [
+        ":redis_csharp_grpc",
+        ":redis_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-redis-v1-csharp",
+    deps = [
+        ":redis_csharp_gapic",
+        ":redis_csharp_grpc",
+        ":redis_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/redis/v1/cloud_redis.proto b/third_party/googleapis/google/cloud/redis/v1/cloud_redis.proto
index 65366ca43..1b4669451 100644
--- a/third_party/googleapis/google/cloud/redis/v1/cloud_redis.proto
+++ b/third_party/googleapis/google/cloud/redis/v1/cloud_redis.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,17 +11,18 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.redis.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/field_mask.proto";
 import "google/protobuf/timestamp.proto";
-import "google/api/client.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/redis/v1;redis";
 option java_multiple_files = true;
@@ -45,11 +46,13 @@ option java_package = "com.google.cloud.redis.v1";
 // * `projects/redpepper-1290/locations/us-central1/instances/my-redis`
 service CloudRedis {
   option (google.api.default_host) = "redis.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
 
   // Lists all Redis instances owned by a project in either the specified
   // location (region) or all locations.
   //
   // The location should have the following format:
+  //
   // * `projects/{project_id}/locations/{location_id}`
   //
   // If `location_id` is specified as `-` (wildcard), then all regions
@@ -58,6 +61,7 @@ service CloudRedis {
     option (google.api.http) = {
       get: "/v1/{parent=projects/*/locations/*}/instances"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets the details of a specific Redis instance.
@@ -65,6 +69,7 @@ service CloudRedis {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/locations/*/instances/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates a Redis instance based on the specified tier and memory size.
@@ -84,6 +89,11 @@ service CloudRedis {
       post: "/v1/{parent=projects/*/locations/*}/instances"
       body: "instance"
     };
+    option (google.api.method_signature) = "parent,instance_id,instance";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.cloud.redis.v1.Instance"
+      metadata_type: "google.cloud.redis.v1.OperationMetadata"
+    };
   }
 
   // Updates the metadata and configuration of a specific Redis instance.
@@ -96,6 +106,11 @@ service CloudRedis {
       patch: "/v1/{instance.name=projects/*/locations/*/instances/*}"
       body: "instance"
     };
+    option (google.api.method_signature) = "update_mask,instance";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.cloud.redis.v1.Instance"
+      metadata_type: "google.cloud.redis.v1.OperationMetadata"
+    };
   }
 
   // Import a Redis RDB snapshot file from Cloud Storage into a Redis instance.
@@ -111,6 +126,11 @@ service CloudRedis {
       post: "/v1/{name=projects/*/locations/*/instances/*}:import"
       body: "*"
     };
+    option (google.api.method_signature) = "name,input_config";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.cloud.redis.v1.Instance"
+      metadata_type: "google.cloud.redis.v1.OperationMetadata"
+    };
   }
 
   // Export Redis instance data into a Redis RDB format file in Cloud Storage.
@@ -124,6 +144,11 @@ service CloudRedis {
       post: "/v1/{name=projects/*/locations/*/instances/*}:export"
       body: "*"
     };
+    option (google.api.method_signature) = "name,output_config";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.cloud.redis.v1.Instance"
+      metadata_type: "google.cloud.redis.v1.OperationMetadata"
+    };
   }
 
   // Initiates a failover of the master node to current replica node for a
@@ -133,6 +158,11 @@ service CloudRedis {
       post: "/v1/{name=projects/*/locations/*/instances/*}:failover"
       body: "*"
     };
+    option (google.api.method_signature) = "name,data_protection_mode";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.cloud.redis.v1.Instance"
+      metadata_type: "google.cloud.redis.v1.OperationMetadata"
+    };
   }
 
   // Deletes a specific Redis instance.  Instance stops serving and data is
@@ -141,11 +171,21 @@ service CloudRedis {
     option (google.api.http) = {
       delete: "/v1/{name=projects/*/locations/*/instances/*}"
     };
+    option (google.api.method_signature) = "name";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.protobuf.Empty"
+      metadata_type: "google.cloud.redis.v1.OperationMetadata"
+    };
   }
 }
 
 // A Google Cloud Redis instance.
 message Instance {
+  option (google.api.resource) = {
+    type: "redis.googleapis.com/Instance"
+    pattern: "projects/{project}/locations/{location}/instances/{instance}"
+  };
+
   // Represents the different states of a Redis instance.
   enum State {
     // Not set.
@@ -190,6 +230,19 @@ message Instance {
     STANDARD_HA = 3;
   }
 
+  // Available connection modes.
+  enum ConnectMode {
+    // Not set.
+    CONNECT_MODE_UNSPECIFIED = 0;
+
+    // Connect via directly peering with memorystore redis hosted service.
+    DIRECT_PEERING = 1;
+
+    // Connect with google via private service access and share connection
+    // across google managed services.
+    PRIVATE_SERVICE_ACCESS = 2;
+  }
+
   // Required. Unique name of the resource in this scope including project and
   // location using the form:
   //     `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
@@ -197,9 +250,9 @@ message Instance {
   // Note: Redis instances are managed and addressed at regional level so
   // location_id here refers to a GCP region; however, users may choose which
   // specific zone (or collection of zones for cross-zone instances) an instance
-  // should be provisioned in. Refer to [location_id] and
-  // [alternative_location_id] fields for more details.
-  string name = 1;
+  // should be provisioned in. Refer to [location_id][google.cloud.redis.v1.Instance.location_id] and
+  // [alternative_location_id][google.cloud.redis.v1.Instance.alternative_location_id] fields for more details.
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
 
   // An arbitrary and optional user-provided name for the instance.
   string display_name = 2;
@@ -210,88 +263,99 @@ message Instance {
   // Optional. The zone where the instance will be provisioned. If not provided,
   // the service will choose a zone for the instance. For STANDARD_HA tier,
   // instances will be created across two zones for protection against zonal
-  // failures. If [alternative_location_id] is also provided, it must be
-  // different from [location_id].
-  string location_id = 4;
+  // failures. If [alternative_location_id][google.cloud.redis.v1.Instance.alternative_location_id] is also provided, it must be
+  // different from [location_id][google.cloud.redis.v1.Instance.location_id].
+  string location_id = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Only applicable to STANDARD_HA tier which protects the instance
   // against zonal failures by provisioning it across two zones. If provided, it
-  // must be a different zone from the one provided in [location_id].
-  string alternative_location_id = 5;
+  // must be a different zone from the one provided in [location_id][google.cloud.redis.v1.Instance.location_id].
+  string alternative_location_id = 5 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The version of Redis software.
-  // If not provided, latest supported version will be used. Updating the
-  // version will perform an upgrade/downgrade to the new version. Currently,
-  // the supported values are:
+  // If not provided, latest supported version will be used. Currently, the
+  // supported values are:
   //
-  //  *   `REDIS_4_0` for Redis 4.0 compatibility (default)
   //  *   `REDIS_3_2` for Redis 3.2 compatibility
-  string redis_version = 7;
+  //  *   `REDIS_4_0` for Redis 4.0 compatibility (default)
+  //  *   `REDIS_5_0` for Redis 5.0 compatibility
+  string redis_version = 7 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The CIDR range of internal addresses that are reserved for this
   // instance. If not provided, the service will choose an unused /29 block,
   // for example, 10.0.0.0/29 or 192.168.0.0/29. Ranges must be unique
   // and non-overlapping with existing subnets in an authorized network.
-  string reserved_ip_range = 9;
+  string reserved_ip_range = 9 [(google.api.field_behavior) = OPTIONAL];
 
   // Output only. Hostname or IP address of the exposed Redis endpoint used by
   // clients to connect to the service.
-  string host = 10;
+  string host = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The port number of the exposed Redis endpoint.
-  int32 port = 11;
+  int32 port = 11 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The current zone where the Redis endpoint is placed. For Basic
-  // Tier instances, this will always be the same as the [location_id]
+  // Tier instances, this will always be the same as the [location_id][google.cloud.redis.v1.Instance.location_id]
   // provided by the user at creation time. For Standard Tier instances,
-  // this can be either [location_id] or [alternative_location_id] and can
+  // this can be either [location_id][google.cloud.redis.v1.Instance.location_id] or [alternative_location_id][google.cloud.redis.v1.Instance.alternative_location_id] and can
   // change after a failover event.
-  string current_location_id = 12;
+  string current_location_id = 12 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The time the instance was created.
-  google.protobuf.Timestamp create_time = 13;
+  google.protobuf.Timestamp create_time = 13 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The current state of this instance.
-  State state = 14;
+  State state = 14 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Additional information about the current status of this
   // instance, if available.
-  string status_message = 15;
+  string status_message = 15 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Optional. Redis configuration parameters, according to
   // http://redis.io/topics/config. Currently, the only supported parameters
   // are:
   //
-  //  Redis 3.2 and above:
+  //  Redis version 3.2 and newer:
   //
   //  *   maxmemory-policy
   //  *   notify-keyspace-events
   //
-  //  Redis 4.0 and above:
+  //  Redis version 4.0 and newer:
   //
   //  *   activedefrag
-  //  *   lfu-log-factor
   //  *   lfu-decay-time
-  map redis_configs = 16;
+  //  *   lfu-log-factor
+  //  *   maxmemory-gb
+  //
+  //  Redis version 5.0 and newer:
+  //
+  //  *   stream-node-max-bytes
+  //  *   stream-node-max-entries
+  map redis_configs = 16 [(google.api.field_behavior) = OPTIONAL];
 
   // Required. The service tier of the instance.
-  Tier tier = 17;
+  Tier tier = 17 [(google.api.field_behavior) = REQUIRED];
 
   // Required. Redis memory size in GiB.
-  int32 memory_size_gb = 18;
+  int32 memory_size_gb = 18 [(google.api.field_behavior) = REQUIRED];
 
   // Optional. The full name of the Google Compute Engine
   // [network](/compute/docs/networks-and-firewalls#networks) to which the
   // instance is connected. If left unspecified, the `default` network
   // will be used.
-  string authorized_network = 20;
+  string authorized_network = 20 [(google.api.field_behavior) = OPTIONAL];
 
   // Output only. Cloud IAM identity used by import / export operations to
   // transfer data to/from Cloud Storage. Format is
   // "serviceAccount:". The value may change over time
   // for a given instance so should be checked before each import/export
   // operation.
-  string persistence_iam_identity = 21;
+  string persistence_iam_identity = 21 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Optional. The connect mode of Redis instance.
+  // If not provided, default one will be used.
+  // Current default: DIRECT_PEERING.
+  ConnectMode connect_mode = 22 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request for [ListInstances][google.cloud.redis.v1.CloudRedis.ListInstances].
@@ -299,19 +363,24 @@ message ListInstancesRequest {
   // Required. The resource name of the instance location using the form:
   //     `projects/{project_id}/locations/{location_id}`
   // where `location_id` refers to a GCP region.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
   // The maximum number of items to return.
   //
   // If not specified, a default value of 1000 will be used by the service.
   // Regardless of the page_size value, the response may include a partial list
   // and a caller should only rely on response's
-  // [next_page_token][CloudRedis.ListInstancesResponse.next_page_token]
+  // [`next_page_token`][google.cloud.redis.v1.ListInstancesResponse.next_page_token]
   // to determine if there are more instances left to be queried.
   int32 page_size = 2;
 
-  // The next_page_token value returned from a previous List request,
-  // if any.
+  // The `next_page_token` value returned from a previous
+  // [ListInstances][google.cloud.redis.v1.CloudRedis.ListInstances] request, if any.
   string page_token = 3;
 }
 
@@ -323,10 +392,10 @@ message ListInstancesResponse {
   // If the `location_id` in the parent field of the request is "-", all regions
   // available to the project are queried, and the results aggregated.
   // If in such an aggregated query a location is unavailable, a dummy Redis
-  // entry is included in the response with the "name" field set to a value of
-  // the form projects/{project_id}/locations/{location_id}/instances/- and the
-  // "status" field set to ERROR and "status_message" field set to "location not
-  // available for ListInstances".
+  // entry is included in the response with the `name` field set to a value of
+  // the form `projects/{project_id}/locations/{location_id}/instances/`- and
+  // the `status` field set to ERROR and `status_message` field set to "location
+  // not available for ListInstances".
   repeated Instance instances = 1;
 
   // Token to retrieve the next page of results, or empty if there are no more
@@ -342,7 +411,12 @@ message GetInstanceRequest {
   // Required. Redis instance resource name using the form:
   //     `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
   // where `location_id` refers to a GCP region.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "redis.googleapis.com/Instance"
+    }
+  ];
 }
 
 // Request for [CreateInstance][google.cloud.redis.v1.CloudRedis.CreateInstance].
@@ -350,7 +424,12 @@ message CreateInstanceRequest {
   // Required. The resource name of the instance location using the form:
   //     `projects/{project_id}/locations/{location_id}`
   // where `location_id` refers to a GCP region.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
   // Required. The logical name of the Redis instance in the customer project
   // with the following restrictions:
@@ -360,27 +439,27 @@ message CreateInstanceRequest {
   // * Must be between 1-40 characters.
   // * Must end with a number or a letter.
   // * Must be unique within the customer project / location
-  string instance_id = 2;
+  string instance_id = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Required. A Redis [Instance] resource
-  Instance instance = 3;
+  Instance instance = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for [UpdateInstance][google.cloud.redis.v1.CloudRedis.UpdateInstance].
 message UpdateInstanceRequest {
   // Required. Mask of fields to update. At least one path must be supplied in
   // this field. The elements of the repeated paths field may only include these
-  // fields from [Instance][CloudRedis.Instance]:
+  // fields from [Instance][google.cloud.redis.v1.Instance]:
   //
   //  *   `displayName`
   //  *   `labels`
   //  *   `memorySizeGb`
   //  *   `redisConfig`
-  google.protobuf.FieldMask update_mask = 1;
+  google.protobuf.FieldMask update_mask = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Required. Update description.
   // Only fields specified in update_mask are updated.
-  Instance instance = 2;
+  Instance instance = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for [DeleteInstance][google.cloud.redis.v1.CloudRedis.DeleteInstance].
@@ -388,13 +467,18 @@ message DeleteInstanceRequest {
   // Required. Redis instance resource name using the form:
   //     `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
   // where `location_id` refers to a GCP region.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "redis.googleapis.com/Instance"
+    }
+  ];
 }
 
 // The Cloud Storage location for the input content
 message GcsSource {
   // Required. Source data URI. (e.g. 'gs://my_bucket/my_object').
-  string uri = 1;
+  string uri = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The input content
@@ -411,17 +495,17 @@ message ImportInstanceRequest {
   // Required. Redis instance resource name using the form:
   //     `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
   // where `location_id` refers to a GCP region.
-  string name = 1;
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Required. Specify data to be imported.
-  InputConfig input_config = 3;
+  InputConfig input_config = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The Cloud Storage location for the output content
 message GcsDestination {
   // Required. Data destination URI (e.g.
   // 'gs://my_bucket/my_object'). Existing files will be overwritten.
-  string uri = 1;
+  string uri = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The output content
@@ -438,14 +522,15 @@ message ExportInstanceRequest {
   // Required. Redis instance resource name using the form:
   //     `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
   // where `location_id` refers to a GCP region.
-  string name = 1;
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Required. Specify data to be exported.
-  OutputConfig output_config = 3;
+  OutputConfig output_config = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for [Failover][google.cloud.redis.v1.CloudRedis.FailoverInstance].
 message FailoverInstanceRequest {
+  // Specifies different modes of operation in relation to the data retention.
   enum DataProtectionMode {
     // Defaults to LIMITED_DATA_LOSS if a data protection mode is not
     // specified.
@@ -464,11 +549,16 @@ message FailoverInstanceRequest {
   // Required. Redis instance resource name using the form:
   //     `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
   // where `location_id` refers to a GCP region.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "redis.googleapis.com/Instance"
+    }
+  ];
 
   // Optional. Available data protection modes that the user can choose. If it's
   // unspecified, data protection mode will be LIMITED_DATA_LOSS by default.
-  DataProtectionMode data_protection_mode = 2;
+  DataProtectionMode data_protection_mode = 2 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Represents the v1 metadata of the long-running operation.
@@ -504,7 +594,7 @@ message LocationMetadata {
   // by the lowercase ID of each zone, as defined by GCE. These keys can be
   // specified in `location_id` or `alternative_location_id` fields when
   // creating a Redis instance.
-  map available_zones = 1;
+  map available_zones = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Defines specific information for a particular zone. Currently empty and
diff --git a/third_party/googleapis/google/cloud/redis/v1/redis_gapic.legacy.yaml b/third_party/googleapis/google/cloud/redis/v1/redis_gapic.legacy.yaml
new file mode 100644
index 000000000..664c96908
--- /dev/null
+++ b/third_party/googleapis/google/cloud/redis/v1/redis_gapic.legacy.yaml
@@ -0,0 +1,298 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.redis.v1
+  python:
+    package_name: google.cloud.redis_v1.gapic
+  go:
+    package_name: cloud.google.com/go/redis/apiv1
+  csharp:
+    package_name: Google.Cloud.Redis.V1
+  ruby:
+    package_name: Google::Cloud::Redis::V1
+  php:
+    package_name: Google\Cloud\Redis\V1
+  nodejs:
+    package_name: redis.v1
+    domain_layer_location: google-cloud
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: google.cloud.redis.v1.CloudRedis
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}/locations/{location}
+    entity_name: location
+  - name_pattern: projects/{project}/locations/{location}/instances/{instance}
+    entity_name: instance
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ListInstances
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: instances
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 60000
+  - name: GetInstance
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: instance
+    timeout_millis: 60000
+  - name: CreateInstance
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - instance_id
+        - instance
+    required_fields:
+    - parent
+    - instance_id
+    - instance
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    long_running:
+      return_type: google.cloud.redis.v1.Instance
+      metadata_type: google.cloud.redis.v1.OperationMetadata
+      initial_poll_delay_millis: 60000  # 1 minutes
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 360000  # 6 minutes
+      total_poll_timeout_millis: 1200000  # 20 minutes
+    timeout_millis: 60000
+    sample_code_init_fields:
+    - instance_id="test_instance"
+    - instance.tier="BASIC"
+    - instance.memory_size_gb=1
+  - name: UpdateInstance
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - update_mask
+        - instance
+    required_fields:
+    - update_mask
+    - instance
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      instance.name: instance
+    long_running:
+      return_type: google.cloud.redis.v1.Instance
+      metadata_type: google.cloud.redis.v1.OperationMetadata
+      initial_poll_delay_millis: 60000  # 1 minutes
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 360000  # 6 minutes
+      total_poll_timeout_millis: 7200000  # 120 minutes
+    timeout_millis: 60000
+    sample_code_init_fields:
+    - update_mask.paths[0]="display_name"
+    - update_mask.paths[1]="memory_size_gb"
+    - instance.display_name="UpdatedDisplayName"
+      - instance.memory_size_gb=4
+  - name: ImportInstance
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - input_config
+    required_fields:
+    - name
+    - input_config
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: instance
+    long_running:
+      return_type: google.cloud.redis.v1.Instance
+      metadata_type: google.cloud.redis.v1.OperationMetadata
+      initial_poll_delay_millis: 60000  # 1 minutes
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 360000  # 6 minutes
+      total_poll_timeout_millis: 18000000  # 300 minutes
+    timeout_millis: 60000
+  - name: ExportInstance
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - output_config
+    required_fields:
+    - name
+    - output_config
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: instance
+    long_running:
+      return_type: google.cloud.redis.v1.Instance
+      metadata_type: google.cloud.redis.v1.OperationMetadata
+      initial_poll_delay_millis: 60000  # 1 minutes
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 360000  # 6 minutes
+      total_poll_timeout_millis: 18000000  # 300 minutes
+    timeout_millis: 60000
+  - name: FailoverInstance
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - data_protection_mode
+    required_fields:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: instance
+    resource_name_treatment: STATIC_TYPES
+    long_running:
+      return_type: google.cloud.redis.v1.Instance
+      metadata_type: google.cloud.redis.v1.OperationMetadata
+      initial_poll_delay_millis: 60000  # 1 minutes
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 360000  # 6 minutes
+      total_poll_timeout_millis: 1200000  # 20 minutes
+    timeout_millis: 60000
+  - name: DeleteInstance
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: instance
+    long_running:
+      return_type: google.protobuf.Empty
+      metadata_type: google.cloud.redis.v1.OperationMetadata
+      initial_poll_delay_millis: 60000  # 1 minutes
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 360000  # 6 minutes
+      total_poll_timeout_millis: 1200000  # 20 minutes
+    timeout_millis: 60000
+resource_name_generation:
+- message_name: ListInstancesRequest
+  field_entity_map:
+    parent: location
+- message_name: GetInstanceRequest
+  field_entity_map:
+    name: instance
+- message_name: CreateInstanceRequest
+  field_entity_map:
+    parent: location
+- message_name: DeleteInstanceRequest
+  field_entity_map:
+    name: instance
+- message_name: FailoverInstanceRequest
+  field_entity_map:
+    name: instance
diff --git a/third_party/googleapis/google/cloud/redis/v1/redis_gapic.yaml b/third_party/googleapis/google/cloud/redis/v1/redis_gapic.yaml
index bfff68c58..f94350faa 100644
--- a/third_party/googleapis/google/cloud/redis/v1/redis_gapic.yaml
+++ b/third_party/googleapis/google/cloud/redis/v1/redis_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -21,22 +21,6 @@ language_settings:
 interfaces:
 # The fully qualified name of the API interface.
 - name: google.cloud.redis.v1.CloudRedis
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections:
-  - name_pattern: projects/{project}/locations/{location}
-    entity_name: location
-  - name_pattern: projects/{project}/locations/{location}/instances/{instance}
-    entity_name: instance
-  # Definition for retryable codes.
   retry_codes_def:
   - name: idempotent
     retry_codes:
@@ -54,246 +38,56 @@ interfaces:
     rpc_timeout_multiplier: 1
     max_rpc_timeout_millis: 20000
     total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
   methods:
   - name: ListInstances
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: instances
     retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      parent: location
-    timeout_millis: 60000
   - name: GetInstance
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: instance
-    timeout_millis: 60000
   - name: CreateInstance
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - instance_id
-        - instance
-    required_fields:
-    - parent
-    - instance_id
-    - instance
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    long_running:
-      return_type: google.cloud.redis.v1.Instance
-      metadata_type: google.cloud.redis.v1.OperationMetadata
-      initial_poll_delay_millis: 60000  # 1 minutes
-      poll_delay_multiplier: 1.5
-      max_poll_delay_millis: 360000  # 6 minutes
-      total_poll_timeout_millis: 1200000  # 20 minutes
-    timeout_millis: 60000
     sample_code_init_fields:
     - instance_id="test_instance"
     - instance.tier="BASIC"
     - instance.memory_size_gb=1
-  - name: UpdateInstance
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - update_mask
-        - instance
-    required_fields:
-    - update_mask
-    - instance
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      instance.name: instance
     long_running:
-      return_type: google.cloud.redis.v1.Instance
-      metadata_type: google.cloud.redis.v1.OperationMetadata
       initial_poll_delay_millis: 60000  # 1 minutes
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 360000  # 6 minutes
       total_poll_timeout_millis: 7200000  # 120 minutes
-    timeout_millis: 60000
+  - name: UpdateInstance
     sample_code_init_fields:
     - update_mask.paths[0]="display_name"
     - update_mask.paths[1]="memory_size_gb"
     - instance.display_name="UpdatedDisplayName"
-      - instance.memory_size_gb=4
+    - instance.name="projects//locations//instances/"
+    - instance.memory_size_gb=4
+    long_running:
+      initial_poll_delay_millis: 60000  # 1 minutes
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 360000  # 6 minutes
+      total_poll_timeout_millis: 7200000  # 120 minutes
   - name: ImportInstance
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - input_config
-    required_fields:
-    - name
-    - input_config
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: instance
     long_running:
-      return_type: google.cloud.redis.v1.Instance
-      metadata_type: google.cloud.redis.v1.OperationMetadata
       initial_poll_delay_millis: 60000  # 1 minutes
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 360000  # 6 minutes
       total_poll_timeout_millis: 18000000  # 300 minutes
-    timeout_millis: 60000
   - name: ExportInstance
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - output_config
-    required_fields:
-    - name
-    - output_config
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: instance
     long_running:
-      return_type: google.cloud.redis.v1.Instance
-      metadata_type: google.cloud.redis.v1.OperationMetadata
       initial_poll_delay_millis: 60000  # 1 minutes
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 360000  # 6 minutes
       total_poll_timeout_millis: 18000000  # 300 minutes
-    timeout_millis: 60000
   - name: FailoverInstance
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - data_protection_mode
-    required_fields:
-    - name
-    - data_protection_mode
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: instance
-    resource_name_treatment: STATIC_TYPES
     long_running:
-      return_type: google.cloud.redis.v1.Instance
-      metadata_type: google.cloud.redis.v1.OperationMetadata
       initial_poll_delay_millis: 60000  # 1 minutes
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 360000  # 6 minutes
       total_poll_timeout_millis: 1200000  # 20 minutes
-    timeout_millis: 60000
   - name: DeleteInstance
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: instance
     long_running:
-      return_type: google.protobuf.Empty
-      metadata_type: google.cloud.redis.v1.OperationMetadata
       initial_poll_delay_millis: 60000  # 1 minutes
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 360000  # 6 minutes
       total_poll_timeout_millis: 1200000  # 20 minutes
-    timeout_millis: 60000
-resource_name_generation:
-- message_name: ListInstancesRequest
-  field_entity_map:
-    parent: location
-- message_name: GetInstanceRequest
-  field_entity_map:
-    name: instance
-- message_name: CreateInstanceRequest
-  field_entity_map:
-    parent: location
-- message_name: DeleteInstanceRequest
-  field_entity_map:
-    name: instance
-- message_name: FailoverInstanceRequest
-  field_entity_map:
-    name: instance
diff --git a/third_party/googleapis/google/cloud/redis/v1/redis_grpc_service_config.json b/third_party/googleapis/google/cloud/redis/v1/redis_grpc_service_config.json
new file mode 100755
index 000000000..ecd12cc81
--- /dev/null
+++ b/third_party/googleapis/google/cloud/redis/v1/redis_grpc_service_config.json
@@ -0,0 +1,45 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.redis.v1.CloudRedis",
+          "method": "ListInstances"
+        },
+        {
+          "service": "google.cloud.redis.v1.CloudRedis",
+          "method": "GetInstance"
+        },
+        {
+          "service": "google.cloud.redis.v1.CloudRedis",
+          "method": "CreateInstance"
+        },
+        {
+          "service": "google.cloud.redis.v1.CloudRedis",
+          "method": "UpdateInstance"
+        },
+        {
+          "service": "google.cloud.redis.v1.CloudRedis",
+          "method": "UpgradeInstance"
+        },
+        {
+          "service": "google.cloud.redis.v1.CloudRedis",
+          "method": "ImportInstance"
+        },
+        {
+          "service": "google.cloud.redis.v1.CloudRedis",
+          "method": "ExportInstance"
+        },
+        {
+          "service": "google.cloud.redis.v1.CloudRedis",
+          "method": "FailoverInstance"
+        },
+        {
+          "service": "google.cloud.redis.v1.CloudRedis",
+          "method": "DeleteInstance"
+        }
+      ],
+      "timeout": "600s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/redis/v1/redis_v1.yaml b/third_party/googleapis/google/cloud/redis/v1/redis_v1.yaml
new file mode 100644
index 000000000..baee17fa0
--- /dev/null
+++ b/third_party/googleapis/google/cloud/redis/v1/redis_v1.yaml
@@ -0,0 +1,47 @@
+type: google.api.Service
+config_version: 3
+name: redis.googleapis.com
+title: Google Cloud Memorystore for Redis API
+
+apis:
+- name: google.cloud.redis.v1.CloudRedis
+
+types:
+- name: google.cloud.redis.v1.LocationMetadata
+- name: google.cloud.redis.v1.OperationMetadata
+- name: google.cloud.redis.v1.ZoneMetadata
+
+documentation:
+  summary: Creates and manages Redis instances on the Google Cloud Platform.
+
+backend:
+  rules:
+  - selector: 'google.cloud.redis.v1.CloudRedis.*'
+    deadline: 60.0
+  - selector: 'google.longrunning.Operations.*'
+    deadline: 60.0
+
+http:
+  rules:
+  - selector: google.longrunning.Operations.ListOperations
+    get: '/v1/{name=projects/*/locations/*}/operations'
+
+  - selector: google.longrunning.Operations.GetOperation
+    get: '/v1/{name=projects/*/locations/*/operations/*}'
+
+  - selector: google.longrunning.Operations.DeleteOperation
+    delete: '/v1/{name=projects/*/locations/*/operations/*}'
+
+  - selector: google.longrunning.Operations.CancelOperation
+    post: '/v1/{name=projects/*/locations/*/operations/*}:cancel'
+
+authentication:
+  rules:
+  - selector: 'google.cloud.redis.v1.CloudRedis.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/redis/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/redis/v1beta1/BUILD.bazel
index cedc6e83d..4e4aac709 100644
--- a/third_party/googleapis/google/cloud/redis/v1beta1/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/redis/v1beta1/BUILD.bazel
@@ -1,9 +1,12 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
@@ -14,9 +17,9 @@ proto_library(
     deps = [
         "//google/api:annotations_proto",
         "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
         "//google/api:resource_proto",
         "//google/longrunning:operations_proto",
-        "//google/rpc:status_proto",
         "@com_google_protobuf//:field_mask_proto",
         "@com_google_protobuf//:timestamp_proto",
     ],
@@ -24,7 +27,10 @@ proto_library(
 
 proto_library_with_info(
     name = "redis_proto_with_info",
-    deps = [":redis_proto"],
+    deps = [
+        ":redis_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -32,18 +38,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
     name = "redis_java_proto",
     deps = [":redis_proto"],
@@ -52,51 +53,40 @@ java_proto_library(
 java_grpc_library(
     name = "redis_java_grpc",
     srcs = [":redis_proto"],
-    deps = [":redis_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "redis_resource_name_java_proto",
-    gapic_yaml = "redis_gapic.yaml",
-    deps = [":redis_proto"],
+    deps = [":redis_java_proto"],
 )
 
 java_gapic_library(
     name = "redis_java_gapic",
     src = ":redis_proto_with_info",
     gapic_yaml = "redis_gapic.yaml",
-    service_yaml = "//google/cloud/redis:redis_v1beta1.yaml",
-    test_deps = [":redis_java_grpc"],
+    package = "google.cloud.redis.v1beta1",
+    service_yaml = "redis_v1beta1.yaml",
+    test_deps = [
+        ":redis_java_grpc",
+    ],
     deps = [
         ":redis_java_proto",
-        ":redis_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":redis_java_gapic_test",
+java_gapic_test(
+    name = "redis_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.redis.v1beta1.CloudRedisClientTest",
     ],
-) for test_name in [
-    "com.google.cloud.redis.v1beta1.CloudRedisClientTest",
-]]
+    runtime_deps = [":redis_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-redis-v1beta1-java",
-    client_deps = [":redis_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":redis_java_gapic_test"],
-    grpc_deps = [":redis_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":redis_java_gapic",
+        ":redis_java_grpc",
         ":redis_java_proto",
         ":redis_proto",
-        ":redis_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -104,10 +94,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -123,15 +113,16 @@ go_proto_library(
 
 go_gapic_library(
     name = "redis_go_gapic",
-    src = ":redis_proto_with_info",
-    gapic_yaml = "redis_gapic.yaml",
-    importpath = "cloud.google.com/go/redis/apiv1beta1",
-    service_yaml = "//google/cloud/redis:redis_v1beta1.yaml",
+    srcs = [":redis_proto_with_info"],
+    grpc_service_config = "redis_grpc_service_config.json",
+    importpath = "cloud.google.com/go/redis/apiv1beta1;redis",
+    service_yaml = "redis_v1beta1.yaml",
     deps = [
         ":redis_go_proto",
         "//google/longrunning:longrunning_go_gapic",
         "//google/longrunning:longrunning_go_proto",
         "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
         "@io_bazel_rules_go//proto/wkt:any_go_proto",
     ],
 )
@@ -143,13 +134,235 @@ go_test(
     importpath = "cloud.google.com/go/redis/apiv1beta1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-redis-v1beta1-go",
     deps = [
         ":redis_go_gapic",
-        ":redis_go_gapic_srcjar-smoke-test.srcjar",
         ":redis_go_gapic_srcjar-test.srcjar",
         ":redis_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "redis_moved_proto",
+    srcs = [":redis_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "redis_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":redis_moved_proto"],
+)
+
+py_grpc_library(
+    name = "redis_py_grpc",
+    srcs = [":redis_moved_proto"],
+    deps = [":redis_py_proto"],
+)
+
+py_gapic_library(
+    name = "redis_py_gapic",
+    src = ":redis_proto_with_info",
+    gapic_yaml = "redis_gapic.yaml",
+    package = "google.cloud.redis.v1beta1",
+    service_yaml = "redis_v1beta1.yaml",
+    deps = [
+        ":redis_py_grpc",
+        ":redis_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "redis-v1beta1-py",
+    deps = [
+        ":redis_py_gapic",
+        ":redis_py_grpc",
+        ":redis_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "redis_php_proto",
+    deps = [":redis_proto"],
+)
+
+php_grpc_library(
+    name = "redis_php_grpc",
+    srcs = [":redis_proto"],
+    deps = [":redis_php_proto"],
+)
+
+php_gapic_library(
+    name = "redis_php_gapic",
+    src = ":redis_proto_with_info",
+    gapic_yaml = "redis_gapic.yaml",
+    package = "google.cloud.redis.v1beta1",
+    service_yaml = "redis_v1beta1.yaml",
+    deps = [
+        ":redis_php_grpc",
+        ":redis_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-redis-v1beta1-php",
+    deps = [
+        ":redis_php_gapic",
+        ":redis_php_grpc",
+        ":redis_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "redis_nodejs_gapic",
+    src = ":redis_proto_with_info",
+    gapic_yaml = "redis_gapic.yaml",
+    package = "google.cloud.redis.v1beta1",
+    service_yaml = "redis_v1beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "redis-v1beta1-nodejs",
+    deps = [
+        ":redis_nodejs_gapic",
+        ":redis_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "redis_ruby_proto",
+    deps = [":redis_proto"],
+)
+
+ruby_grpc_library(
+    name = "redis_ruby_grpc",
+    srcs = [":redis_proto"],
+    deps = [":redis_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "redis_ruby_gapic",
+    src = ":redis_proto_with_info",
+    gapic_yaml = "redis_gapic.yaml",
+    package = "google.cloud.redis.v1beta1",
+    service_yaml = "redis_v1beta1.yaml",
+    deps = [
+        ":redis_ruby_grpc",
+        ":redis_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-redis-v1beta1-ruby",
+    deps = [
+        ":redis_ruby_gapic",
+        ":redis_ruby_grpc",
+        ":redis_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "redis_csharp_proto",
+    deps = [":redis_proto"],
+)
+
+csharp_grpc_library(
+    name = "redis_csharp_grpc",
+    srcs = [":redis_proto"],
+    deps = [":redis_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "redis_csharp_gapic",
+    src = ":redis_proto_with_info",
+    gapic_yaml = "redis_gapic.yaml",
+    package = "google.cloud.redis.v1beta1",
+    service_yaml = "redis_v1beta1.yaml",
+    deps = [
+        ":redis_csharp_grpc",
+        ":redis_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-redis-v1beta1-csharp",
+    deps = [
+        ":redis_csharp_gapic",
+        ":redis_csharp_grpc",
+        ":redis_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/redis/v1beta1/cloud_redis.proto b/third_party/googleapis/google/cloud/redis/v1beta1/cloud_redis.proto
index 699df83fa..47d9a6fef 100644
--- a/third_party/googleapis/google/cloud/redis/v1beta1/cloud_redis.proto
+++ b/third_party/googleapis/google/cloud/redis/v1beta1/cloud_redis.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,17 +11,18 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.redis.v1beta1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/field_mask.proto";
 import "google/protobuf/timestamp.proto";
-import "google/api/client.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/redis/v1beta1;redis";
 option java_multiple_files = true;
@@ -45,11 +46,13 @@ option java_package = "com.google.cloud.redis.v1beta1";
 // * `projects/redpepper-1290/locations/us-central1/instances/my-redis`
 service CloudRedis {
   option (google.api.default_host) = "redis.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
 
   // Lists all Redis instances owned by a project in either the specified
   // location (region) or all locations.
   //
   // The location should have the following format:
+  //
   // * `projects/{project_id}/locations/{location_id}`
   //
   // If `location_id` is specified as `-` (wildcard), then all regions
@@ -58,6 +61,7 @@ service CloudRedis {
     option (google.api.http) = {
       get: "/v1beta1/{parent=projects/*/locations/*}/instances"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets the details of a specific Redis instance.
@@ -65,6 +69,7 @@ service CloudRedis {
     option (google.api.http) = {
       get: "/v1beta1/{name=projects/*/locations/*/instances/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates a Redis instance based on the specified tier and memory size.
@@ -84,6 +89,11 @@ service CloudRedis {
       post: "/v1beta1/{parent=projects/*/locations/*}/instances"
       body: "instance"
     };
+    option (google.api.method_signature) = "parent,instance_id,instance";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.cloud.redis.v1beta1.Instance"
+      metadata_type: "google.protobuf.Any"
+    };
   }
 
   // Updates the metadata and configuration of a specific Redis instance.
@@ -96,6 +106,25 @@ service CloudRedis {
       patch: "/v1beta1/{instance.name=projects/*/locations/*/instances/*}"
       body: "instance"
     };
+    option (google.api.method_signature) = "update_mask,instance";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.cloud.redis.v1beta1.Instance"
+      metadata_type: "google.protobuf.Any"
+    };
+  }
+
+  // Upgrades Redis instance to the newer Redis version specified in the
+  // request.
+  rpc UpgradeInstance(UpgradeInstanceRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/instances/*}:upgrade"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name,redis_version";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.cloud.redis.v1beta1.Instance"
+      metadata_type: "google.protobuf.Any"
+    };
   }
 
   // Import a Redis RDB snapshot file from Cloud Storage into a Redis instance.
@@ -111,6 +140,11 @@ service CloudRedis {
       post: "/v1beta1/{name=projects/*/locations/*/instances/*}:import"
       body: "*"
     };
+    option (google.api.method_signature) = "name,input_config";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.cloud.redis.v1beta1.Instance"
+      metadata_type: "google.protobuf.Any"
+    };
   }
 
   // Export Redis instance data into a Redis RDB format file in Cloud Storage.
@@ -124,6 +158,11 @@ service CloudRedis {
       post: "/v1beta1/{name=projects/*/locations/*/instances/*}:export"
       body: "*"
     };
+    option (google.api.method_signature) = "name,output_config";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.cloud.redis.v1beta1.Instance"
+      metadata_type: "google.protobuf.Any"
+    };
   }
 
   // Initiates a failover of the master node to current replica node for a
@@ -133,6 +172,11 @@ service CloudRedis {
       post: "/v1beta1/{name=projects/*/locations/*/instances/*}:failover"
       body: "*"
     };
+    option (google.api.method_signature) = "name,data_protection_mode";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.cloud.redis.v1beta1.Instance"
+      metadata_type: "google.protobuf.Any"
+    };
   }
 
   // Deletes a specific Redis instance.  Instance stops serving and data is
@@ -141,11 +185,21 @@ service CloudRedis {
     option (google.api.http) = {
       delete: "/v1beta1/{name=projects/*/locations/*/instances/*}"
     };
+    option (google.api.method_signature) = "name";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.protobuf.Empty"
+      metadata_type: "google.protobuf.Any"
+    };
   }
 }
 
 // A Google Cloud Redis instance.
 message Instance {
+  option (google.api.resource) = {
+    type: "redis.googleapis.com/Instance"
+    pattern: "projects/{project}/locations/{location}/instances/{instance}"
+  };
+
   // Represents the different states of a Redis instance.
   enum State {
     // Not set.
@@ -190,6 +244,19 @@ message Instance {
     STANDARD_HA = 3;
   }
 
+  // Available connection modes.
+  enum ConnectMode {
+    // Not set.
+    CONNECT_MODE_UNSPECIFIED = 0;
+
+    // Connect via directly peering with memorystore redis hosted service.
+    DIRECT_PEERING = 1;
+
+    // Connect with google via private service access and share connection
+    // across google managed services.
+    PRIVATE_SERVICE_ACCESS = 2;
+  }
+
   // Required. Unique name of the resource in this scope including project and
   // location using the form:
   //     `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
@@ -197,9 +264,9 @@ message Instance {
   // Note: Redis instances are managed and addressed at regional level so
   // location_id here refers to a GCP region; however, users may choose which
   // specific zone (or collection of zones for cross-zone instances) an instance
-  // should be provisioned in. Refer to [location_id] and
-  // [alternative_location_id] fields for more details.
-  string name = 1;
+  // should be provisioned in. Refer to [location_id][google.cloud.redis.v1beta1.Instance.location_id] and
+  // [alternative_location_id][google.cloud.redis.v1beta1.Instance.alternative_location_id] fields for more details.
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
 
   // An arbitrary and optional user-provided name for the instance.
   string display_name = 2;
@@ -210,88 +277,99 @@ message Instance {
   // Optional. The zone where the instance will be provisioned. If not provided,
   // the service will choose a zone for the instance. For STANDARD_HA tier,
   // instances will be created across two zones for protection against zonal
-  // failures. If [alternative_location_id] is also provided, it must be
-  // different from [location_id].
-  string location_id = 4;
+  // failures. If [alternative_location_id][google.cloud.redis.v1beta1.Instance.alternative_location_id] is also provided, it must be
+  // different from [location_id][google.cloud.redis.v1beta1.Instance.location_id].
+  string location_id = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Only applicable to STANDARD_HA tier which protects the instance
   // against zonal failures by provisioning it across two zones. If provided, it
-  // must be a different zone from the one provided in [location_id].
-  string alternative_location_id = 5;
+  // must be a different zone from the one provided in [location_id][google.cloud.redis.v1beta1.Instance.location_id].
+  string alternative_location_id = 5 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The version of Redis software.
-  // If not provided, latest supported version will be used. Updating the
-  // version will perform an upgrade/downgrade to the new version. Currently,
-  // the supported values are:
+  // If not provided, latest supported version will be used. Currently, the
+  // supported values are:
   //
-  //  *   `REDIS_4_0` for Redis 4.0 compatibility (default)
   //  *   `REDIS_3_2` for Redis 3.2 compatibility
-  string redis_version = 7;
+  //  *   `REDIS_4_0` for Redis 4.0 compatibility (default)
+  //  *   `REDIS_5_0` for Redis 5.0 compatibility
+  string redis_version = 7 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The CIDR range of internal addresses that are reserved for this
   // instance. If not provided, the service will choose an unused /29 block,
   // for example, 10.0.0.0/29 or 192.168.0.0/29. Ranges must be unique
   // and non-overlapping with existing subnets in an authorized network.
-  string reserved_ip_range = 9;
+  string reserved_ip_range = 9 [(google.api.field_behavior) = OPTIONAL];
 
   // Output only. Hostname or IP address of the exposed Redis endpoint used by
   // clients to connect to the service.
-  string host = 10;
+  string host = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The port number of the exposed Redis endpoint.
-  int32 port = 11;
+  int32 port = 11 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The current zone where the Redis endpoint is placed. For Basic
-  // Tier instances, this will always be the same as the [location_id]
+  // Tier instances, this will always be the same as the [location_id][google.cloud.redis.v1beta1.Instance.location_id]
   // provided by the user at creation time. For Standard Tier instances,
-  // this can be either [location_id] or [alternative_location_id] and can
+  // this can be either [location_id][google.cloud.redis.v1beta1.Instance.location_id] or [alternative_location_id][google.cloud.redis.v1beta1.Instance.alternative_location_id] and can
   // change after a failover event.
-  string current_location_id = 12;
+  string current_location_id = 12 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The time the instance was created.
-  google.protobuf.Timestamp create_time = 13;
+  google.protobuf.Timestamp create_time = 13 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The current state of this instance.
-  State state = 14;
+  State state = 14 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Additional information about the current status of this
   // instance, if available.
-  string status_message = 15;
+  string status_message = 15 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Optional. Redis configuration parameters, according to
   // http://redis.io/topics/config. Currently, the only supported parameters
   // are:
   //
-  //  Redis 3.2 and above:
+  //  Redis version 3.2 and newer:
   //
   //  *   maxmemory-policy
   //  *   notify-keyspace-events
   //
-  //  Redis 4.0 and above:
+  //  Redis version 4.0 and newer:
   //
   //  *   activedefrag
-  //  *   lfu-log-factor
   //  *   lfu-decay-time
-  map redis_configs = 16;
+  //  *   lfu-log-factor
+  //  *   maxmemory-gb
+  //
+  //  Redis version 5.0 and newer:
+  //
+  //  *   stream-node-max-bytes
+  //  *   stream-node-max-entries
+  map redis_configs = 16 [(google.api.field_behavior) = OPTIONAL];
 
   // Required. The service tier of the instance.
-  Tier tier = 17;
+  Tier tier = 17 [(google.api.field_behavior) = REQUIRED];
 
   // Required. Redis memory size in GiB.
-  int32 memory_size_gb = 18;
+  int32 memory_size_gb = 18 [(google.api.field_behavior) = REQUIRED];
 
   // Optional. The full name of the Google Compute Engine
   // [network](/compute/docs/networks-and-firewalls#networks) to which the
   // instance is connected. If left unspecified, the `default` network
   // will be used.
-  string authorized_network = 20;
+  string authorized_network = 20 [(google.api.field_behavior) = OPTIONAL];
 
   // Output only. Cloud IAM identity used by import / export operations to
   // transfer data to/from Cloud Storage. Format is
   // "serviceAccount:". The value may change over time
   // for a given instance so should be checked before each import/export
   // operation.
-  string persistence_iam_identity = 21;
+  string persistence_iam_identity = 21 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Optional. The connect mode of Redis instance.
+  // If not provided, default one will be used.
+  // Current default: DIRECT_PEERING.
+  ConnectMode connect_mode = 22 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request for [ListInstances][google.cloud.redis.v1beta1.CloudRedis.ListInstances].
@@ -299,19 +377,24 @@ message ListInstancesRequest {
   // Required. The resource name of the instance location using the form:
   //     `projects/{project_id}/locations/{location_id}`
   // where `location_id` refers to a GCP region.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
   // The maximum number of items to return.
   //
   // If not specified, a default value of 1000 will be used by the service.
   // Regardless of the page_size value, the response may include a partial list
   // and a caller should only rely on response's
-  // [next_page_token][CloudRedis.ListInstancesResponse.next_page_token]
+  // [`next_page_token`][google.cloud.redis.v1beta1.ListInstancesResponse.next_page_token]
   // to determine if there are more instances left to be queried.
   int32 page_size = 2;
 
-  // The next_page_token value returned from a previous List request,
-  // if any.
+  // The `next_page_token` value returned from a previous
+  // [ListInstances][google.cloud.redis.v1beta1.CloudRedis.ListInstances] request, if any.
   string page_token = 3;
 }
 
@@ -323,10 +406,10 @@ message ListInstancesResponse {
   // If the `location_id` in the parent field of the request is "-", all regions
   // available to the project are queried, and the results aggregated.
   // If in such an aggregated query a location is unavailable, a dummy Redis
-  // entry is included in the response with the "name" field set to a value of
-  // the form projects/{project_id}/locations/{location_id}/instances/- and the
-  // "status" field set to ERROR and "status_message" field set to "location not
-  // available for ListInstances".
+  // entry is included in the response with the `name` field set to a value of
+  // the form `projects/{project_id}/locations/{location_id}/instances/`- and
+  // the `status` field set to ERROR and `status_message` field set to "location
+  // not available for ListInstances".
   repeated Instance instances = 1;
 
   // Token to retrieve the next page of results, or empty if there are no more
@@ -342,7 +425,12 @@ message GetInstanceRequest {
   // Required. Redis instance resource name using the form:
   //     `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
   // where `location_id` refers to a GCP region.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "redis.googleapis.com/Instance"
+    }
+  ];
 }
 
 // Request for [CreateInstance][google.cloud.redis.v1beta1.CloudRedis.CreateInstance].
@@ -350,7 +438,12 @@ message CreateInstanceRequest {
   // Required. The resource name of the instance location using the form:
   //     `projects/{project_id}/locations/{location_id}`
   // where `location_id` refers to a GCP region.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
   // Required. The logical name of the Redis instance in the customer project
   // with the following restrictions:
@@ -360,10 +453,10 @@ message CreateInstanceRequest {
   // * Must be between 1-40 characters.
   // * Must end with a number or a letter.
   // * Must be unique within the customer project / location
-  string instance_id = 2;
+  string instance_id = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Required. A Redis [Instance] resource
-  Instance instance = 3;
+  Instance instance = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for [UpdateInstance][google.cloud.redis.v1beta1.CloudRedis.UpdateInstance].
@@ -376,11 +469,27 @@ message UpdateInstanceRequest {
   //  *   `labels`
   //  *   `memorySizeGb`
   //  *   `redisConfig`
-  google.protobuf.FieldMask update_mask = 1;
+  google.protobuf.FieldMask update_mask = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Required. Update description.
   // Only fields specified in update_mask are updated.
-  Instance instance = 2;
+  Instance instance = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request for [UpgradeInstance][google.cloud.redis.v1beta1.CloudRedis.UpgradeInstance].
+message UpgradeInstanceRequest {
+  // Required. Redis instance resource name using the form:
+  //     `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
+  // where `location_id` refers to a GCP region.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "redis.googleapis.com/Instance"
+    }
+  ];
+
+  // Required. Specifies the target version of Redis software to upgrade to.
+  string redis_version = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for [DeleteInstance][google.cloud.redis.v1beta1.CloudRedis.DeleteInstance].
@@ -388,13 +497,18 @@ message DeleteInstanceRequest {
   // Required. Redis instance resource name using the form:
   //     `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
   // where `location_id` refers to a GCP region.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "redis.googleapis.com/Instance"
+    }
+  ];
 }
 
 // The Cloud Storage location for the input content
 message GcsSource {
   // Required. Source data URI. (e.g. 'gs://my_bucket/my_object').
-  string uri = 1;
+  string uri = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The input content
@@ -411,17 +525,17 @@ message ImportInstanceRequest {
   // Required. Redis instance resource name using the form:
   //     `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
   // where `location_id` refers to a GCP region.
-  string name = 1;
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Required. Specify data to be imported.
-  InputConfig input_config = 3;
+  InputConfig input_config = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The Cloud Storage location for the output content
 message GcsDestination {
   // Required. Data destination URI (e.g.
   // 'gs://my_bucket/my_object'). Existing files will be overwritten.
-  string uri = 1;
+  string uri = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The output content
@@ -438,14 +552,15 @@ message ExportInstanceRequest {
   // Required. Redis instance resource name using the form:
   //     `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
   // where `location_id` refers to a GCP region.
-  string name = 1;
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Required. Specify data to be exported.
-  OutputConfig output_config = 3;
+  OutputConfig output_config = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for [Failover][google.cloud.redis.v1beta1.CloudRedis.FailoverInstance].
 message FailoverInstanceRequest {
+  // Specifies different modes of operation in relation to the data retention.
   enum DataProtectionMode {
     // Defaults to LIMITED_DATA_LOSS if a data protection mode is not
     // specified.
@@ -464,11 +579,16 @@ message FailoverInstanceRequest {
   // Required. Redis instance resource name using the form:
   //     `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
   // where `location_id` refers to a GCP region.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "redis.googleapis.com/Instance"
+    }
+  ];
 
   // Optional. Available data protection modes that the user can choose. If it's
   // unspecified, data protection mode will be LIMITED_DATA_LOSS by default.
-  DataProtectionMode data_protection_mode = 2;
+  DataProtectionMode data_protection_mode = 2 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // This location metadata represents additional configuration options for a
@@ -480,7 +600,7 @@ message LocationMetadata {
   // by the lowercase ID of each zone, as defined by GCE. These keys can be
   // specified in `location_id` or `alternative_location_id` fields when
   // creating a Redis instance.
-  map available_zones = 1;
+  map available_zones = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Defines specific information for a particular zone. Currently empty and
diff --git a/third_party/googleapis/google/cloud/redis/v1beta1/redis_gapic.legacy.yaml b/third_party/googleapis/google/cloud/redis/v1beta1/redis_gapic.legacy.yaml
new file mode 100644
index 000000000..3882ea049
--- /dev/null
+++ b/third_party/googleapis/google/cloud/redis/v1beta1/redis_gapic.legacy.yaml
@@ -0,0 +1,293 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.redis.v1beta1
+  python:
+    package_name: google.cloud.redis_v1beta1.gapic
+  go:
+    package_name: cloud.google.com/go/redis/apiv1beta1
+  csharp:
+    package_name: Google.Cloud.Redis.V1Beta1
+  ruby:
+    package_name: Google::Cloud::Redis::V1beta1
+  php:
+    package_name: Google\Cloud\Redis\V1beta1
+  nodejs:
+    package_name: redis.v1beta1
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: google.cloud.redis.v1beta1.CloudRedis
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}/locations/{location}
+    entity_name: location
+  - name_pattern: projects/{project}/locations/{location}/instances/{instance}
+    entity_name: instance
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ListInstances
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: instances
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 60000
+  - name: GetInstance
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: instance
+    timeout_millis: 60000
+  - name: CreateInstance
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - instance_id
+        - instance
+    required_fields:
+    - parent
+    - instance_id
+    - instance
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    long_running:
+      return_type: google.cloud.redis.v1beta1.Instance
+      metadata_type: google.protobuf.Any
+      initial_poll_delay_millis: 60000  # 1 minutes
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 360000  # 6 minutes
+      total_poll_timeout_millis: 1200000  # 20 minutes
+    timeout_millis: 60000
+    sample_code_init_fields:
+    - instance_id="test_instance"
+    - instance.tier="BASIC"
+    - instance.memory_size_gb=1
+  - name: UpdateInstance
+    flattening:
+      groups:
+      - parameters:
+        - update_mask
+        - instance
+    required_fields:
+    - update_mask
+    - instance
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      instance.name: instance
+    resource_name_treatment: STATIC_TYPES
+    long_running:
+      return_type: google.cloud.redis.v1beta1.Instance
+      metadata_type: google.protobuf.Any
+      initial_poll_delay_millis: 60000  # 1 minutes
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 360000  # 6 minutes
+      total_poll_timeout_millis: 7200000  # 120 minutes
+    timeout_millis: 60000
+    sample_code_init_fields:
+    - update_mask.paths[0]="display_name"
+    - update_mask.paths[1]="memory_size_gb"
+    - instance.display_name="UpdatedDisplayName"
+    - instance.memory_size_gb=4
+  - name: ImportInstance
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - input_config
+    required_fields:
+    - name
+    - input_config
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: instance
+    long_running:
+      return_type: google.cloud.redis.v1beta1.Instance
+      metadata_type: google.protobuf.Any
+      initial_poll_delay_millis: 60000  # 1 minutes
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 360000  # 6 minutes
+      total_poll_timeout_millis: 18000000  # 300 minutes
+    timeout_millis: 60000
+  - name: ExportInstance
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - output_config
+    required_fields:
+    - name
+    - output_config
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: instance
+    long_running:
+      return_type: google.cloud.redis.v1beta1.Instance
+      metadata_type: google.protobuf.Any
+      initial_poll_delay_millis: 60000  # 1 minutes
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 360000  # 6 minutes
+      total_poll_timeout_millis: 18000000  # 300 minutes
+    timeout_millis: 60000
+  - name: FailoverInstance
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - data_protection_mode
+    required_fields:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: instance
+    long_running:
+      return_type: google.cloud.redis.v1beta1.Instance
+      metadata_type: google.protobuf.Any
+      initial_poll_delay_millis: 60000  # 1 minutes
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 360000  # 6 minutes
+      total_poll_timeout_millis: 1200000  # 20 minutes
+    timeout_millis: 60000
+  - name: DeleteInstance
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: instance
+    long_running:
+      return_type: google.protobuf.Empty
+      metadata_type: google.protobuf.Any
+      initial_poll_delay_millis: 60000  # 1 minutes
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 360000  # 6 minutes
+      total_poll_timeout_millis: 1200000  # 20 minutes
+    timeout_millis: 60000
+resource_name_generation:
+- message_name: ListInstancesRequest
+  field_entity_map:
+    parent: location
+- message_name: GetInstanceRequest
+  field_entity_map:
+    name: instance
+- message_name: CreateInstanceRequest
+  field_entity_map:
+    parent: location
+- message_name: DeleteInstanceRequest
+  field_entity_map:
+    name: instance
diff --git a/third_party/googleapis/google/cloud/redis/v1beta1/redis_gapic.yaml b/third_party/googleapis/google/cloud/redis/v1beta1/redis_gapic.yaml
index 855a5356c..a6844b243 100644
--- a/third_party/googleapis/google/cloud/redis/v1beta1/redis_gapic.yaml
+++ b/third_party/googleapis/google/cloud/redis/v1beta1/redis_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -20,22 +20,6 @@ language_settings:
 interfaces:
 # The fully qualified name of the API interface.
 - name: google.cloud.redis.v1beta1.CloudRedis
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections:
-  - name_pattern: projects/{project}/locations/{location}
-    entity_name: location
-  - name_pattern: projects/{project}/locations/{location}/instances/{instance}
-    entity_name: instance
-  # Definition for retryable codes.
   retry_codes_def:
   - name: idempotent
     retry_codes:
@@ -53,242 +37,56 @@ interfaces:
     rpc_timeout_multiplier: 1
     max_rpc_timeout_millis: 20000
     total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
   methods:
   - name: ListInstances
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: instances
     retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      parent: location
-    timeout_millis: 60000
   - name: GetInstance
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: instance
-    timeout_millis: 60000
   - name: CreateInstance
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - instance_id
-        - instance
-    required_fields:
-    - parent
-    - instance_id
-    - instance
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    long_running:
-      return_type: google.cloud.redis.v1beta1.Instance
-      metadata_type: google.protobuf.Any
-      initial_poll_delay_millis: 60000  # 1 minutes
-      poll_delay_multiplier: 1.5
-      max_poll_delay_millis: 360000  # 6 minutes
-      total_poll_timeout_millis: 1200000  # 20 minutes
-    timeout_millis: 60000
     sample_code_init_fields:
     - instance_id="test_instance"
     - instance.tier="BASIC"
     - instance.memory_size_gb=1
-  - name: UpdateInstance
-    flattening:
-      groups:
-      - parameters:
-        - update_mask
-        - instance
-    required_fields:
-    - update_mask
-    - instance
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      instance.name: instance
-    resource_name_treatment: STATIC_TYPES
     long_running:
-      return_type: google.cloud.redis.v1beta1.Instance
-      metadata_type: google.protobuf.Any
       initial_poll_delay_millis: 60000  # 1 minutes
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 360000  # 6 minutes
-      total_poll_timeout_millis: 7200000  # 120 minutes
-    timeout_millis: 60000
+      total_poll_timeout_millis: 1200000  # 20 minutes
+  - name: UpdateInstance
     sample_code_init_fields:
     - update_mask.paths[0]="display_name"
     - update_mask.paths[1]="memory_size_gb"
     - instance.display_name="UpdatedDisplayName"
+    - instance.name="projects//locations//instances/"
     - instance.memory_size_gb=4
+    long_running:
+      initial_poll_delay_millis: 60000  # 1 minutes
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 360000  # 6 minutes
+      total_poll_timeout_millis: 7200000  # 120 minutes
   - name: ImportInstance
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - input_config
-    required_fields:
-    - name
-    - input_config
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: instance
     long_running:
-      return_type: google.cloud.redis.v1beta1.Instance
-      metadata_type: google.protobuf.Any
       initial_poll_delay_millis: 60000  # 1 minutes
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 360000  # 6 minutes
       total_poll_timeout_millis: 18000000  # 300 minutes
-    timeout_millis: 60000
   - name: ExportInstance
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - output_config
-    required_fields:
-    - name
-    - output_config
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: instance
     long_running:
-      return_type: google.cloud.redis.v1beta1.Instance
-      metadata_type: google.protobuf.Any
       initial_poll_delay_millis: 60000  # 1 minutes
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 360000  # 6 minutes
       total_poll_timeout_millis: 18000000  # 300 minutes
-    timeout_millis: 60000
   - name: FailoverInstance
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - data_protection_mode
-    required_fields:
-    - name
-    - data_protection_mode
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: instance
     long_running:
-      return_type: google.cloud.redis.v1beta1.Instance
-      metadata_type: google.protobuf.Any
       initial_poll_delay_millis: 60000  # 1 minutes
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 360000  # 6 minutes
       total_poll_timeout_millis: 1200000  # 20 minutes
-    timeout_millis: 60000
   - name: DeleteInstance
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: instance
     long_running:
-      return_type: google.protobuf.Empty
-      metadata_type: google.protobuf.Any
       initial_poll_delay_millis: 60000  # 1 minutes
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 360000  # 6 minutes
       total_poll_timeout_millis: 1200000  # 20 minutes
-    timeout_millis: 60000
-resource_name_generation:
-- message_name: ListInstancesRequest
-  field_entity_map:
-    parent: location
-- message_name: GetInstanceRequest
-  field_entity_map:
-    name: instance
-- message_name: CreateInstanceRequest
-  field_entity_map:
-    parent: location
-- message_name: DeleteInstanceRequest
-  field_entity_map:
-    name: instance
diff --git a/third_party/googleapis/google/cloud/redis/v1beta1/redis_grpc_service_config.json b/third_party/googleapis/google/cloud/redis/v1beta1/redis_grpc_service_config.json
new file mode 100755
index 000000000..014350bf5
--- /dev/null
+++ b/third_party/googleapis/google/cloud/redis/v1beta1/redis_grpc_service_config.json
@@ -0,0 +1,45 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.redis.v1beta1.CloudRedis",
+          "method": "ListInstances"
+        },
+        {
+          "service": "google.cloud.redis.v1beta1.CloudRedis",
+          "method": "GetInstance"
+        },
+        {
+          "service": "google.cloud.redis.v1beta1.CloudRedis",
+          "method": "CreateInstance"
+        },
+        {
+          "service": "google.cloud.redis.v1beta1.CloudRedis",
+          "method": "UpdateInstance"
+        },
+        {
+          "service": "google.cloud.redis.v1beta1.CloudRedis",
+          "method": "UpgradeInstance"
+        },
+        {
+          "service": "google.cloud.redis.v1beta1.CloudRedis",
+          "method": "ImportInstance"
+        },
+        {
+          "service": "google.cloud.redis.v1beta1.CloudRedis",
+          "method": "ExportInstance"
+        },
+        {
+          "service": "google.cloud.redis.v1beta1.CloudRedis",
+          "method": "FailoverInstance"
+        },
+        {
+          "service": "google.cloud.redis.v1beta1.CloudRedis",
+          "method": "DeleteInstance"
+        }
+      ],
+      "timeout": "600s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/redis/v1beta1/redis_v1beta1.yaml b/third_party/googleapis/google/cloud/redis/v1beta1/redis_v1beta1.yaml
new file mode 100644
index 000000000..b9e101404
--- /dev/null
+++ b/third_party/googleapis/google/cloud/redis/v1beta1/redis_v1beta1.yaml
@@ -0,0 +1,43 @@
+type: google.api.Service
+config_version: 3
+name: redis.googleapis.com
+title: Google Cloud Memorystore for Redis API
+
+apis:
+- name: google.cloud.redis.v1beta1.CloudRedis
+
+types:
+- name: google.cloud.redis.v1beta1.LocationMetadata
+- name: google.cloud.redis.v1beta1.ZoneMetadata
+
+documentation:
+  summary: Creates and manages Redis instances on the Google Cloud Platform.
+
+backend:
+  rules:
+  - selector: 'google.cloud.redis.v1beta1.CloudRedis.*'
+    deadline: 60.0
+  - selector: 'google.longrunning.Operations.*'
+    deadline: 60.0
+
+http:
+  rules:
+  - selector: google.longrunning.Operations.CancelOperation
+    post: '/v1beta1/{name=projects/*/locations/*/operations/*}:cancel'
+  - selector: google.longrunning.Operations.DeleteOperation
+    delete: '/v1beta1/{name=projects/*/locations/*/operations/*}'
+  - selector: google.longrunning.Operations.GetOperation
+    get: '/v1beta1/{name=projects/*/locations/*/operations/*}'
+  - selector: google.longrunning.Operations.ListOperations
+    get: '/v1beta1/{name=projects/*/locations/*}/operations'
+
+authentication:
+  rules:
+  - selector: 'google.cloud.redis.v1beta1.CloudRedis.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/resourcemanager/artman_cloudresourcemanager.yaml b/third_party/googleapis/google/cloud/resourcemanager/artman_cloudresourcemanager.yaml
index c3d61249c..d69802e85 100644
--- a/third_party/googleapis/google/cloud/resourcemanager/artman_cloudresourcemanager.yaml
+++ b/third_party/googleapis/google/cloud/resourcemanager/artman_cloudresourcemanager.yaml
@@ -3,13 +3,14 @@ common:
   api_version: v2
   organization_name: google-cloud
   proto_deps:
-    - name: google-common-protos
-    - name: google-iam-v1
-      proto_path: google/iam/v1
+  - name: google-common-protos
+  - name: google-iam-v1
+    proto_path: google/iam/v1
   src_proto_paths:
   - v2
-  service_yaml: cloudresourcemanager.yaml
-  gapic_yaml: v2/cloudresourcemanager_gapic.yaml
+  service_yaml: v2/cloudresourcemanager_v2.yaml
+  gapic_yaml: v2/cloudresourcemanager_gapic.legacy.yaml
+  proto_package: google.cloud.resourcemanager.v2
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/cloud/resourcemanager/cloudresourcemanager.yaml b/third_party/googleapis/google/cloud/resourcemanager/cloudresourcemanager.yaml
deleted file mode 100644
index 7780c301d..000000000
--- a/third_party/googleapis/google/cloud/resourcemanager/cloudresourcemanager.yaml
+++ /dev/null
@@ -1,56 +0,0 @@
-type: google.api.Service
-config_version: 1
-name: cloudresourcemanager.googleapis.com
-title: Google Cloud Resource Manager API
-
-apis:
-- name: google.cloud.resourcemanager.v2.Folders
-
-types:
-- name: google.cloud.resourcemanager.v2.FolderOperation
-
-documentation:
-  summary: |-
-    The Google Cloud Resource Manager API provides methods for creating,
-    reading, and updating project metadata.
-
-backend:
-  rules:
-  - selector: google.cloud.resourcemanager.v2.Folders.ListFolders
-    deadline: 30.0
-  - selector: google.cloud.resourcemanager.v2.Folders.SearchFolders
-    deadline: 30.0
-  - selector: google.cloud.resourcemanager.v2.Folders.GetFolder
-    deadline: 30.0
-  - selector: google.cloud.resourcemanager.v2.Folders.CreateFolder
-    deadline: 30.0
-  - selector: google.cloud.resourcemanager.v2.Folders.UpdateFolder
-    deadline: 30.0
-  - selector: google.cloud.resourcemanager.v2.Folders.MoveFolder
-    deadline: 30.0
-  - selector: google.cloud.resourcemanager.v2.Folders.DeleteFolder
-    deadline: 30.0
-  - selector: google.cloud.resourcemanager.v2.Folders.UndeleteFolder
-    deadline: 30.0
-  - selector: google.cloud.resourcemanager.v2.Folders.GetIamPolicy
-    deadline: 30.0
-  - selector: google.cloud.resourcemanager.v2.Folders.SetIamPolicy
-    deadline: 30.0
-  - selector: google.cloud.resourcemanager.v2.Folders.TestIamPermissions
-    deadline: 30.0
-
-authentication:
-  rules:
-  - selector: '*'
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform
-  - selector: |-
-      google.cloud.resourcemanager.v2.Folders.GetFolder,
-      google.cloud.resourcemanager.v2.Folders.GetIamPolicy,
-      google.cloud.resourcemanager.v2.Folders.ListFolders,
-      google.cloud.resourcemanager.v2.Folders.SearchFolders
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform,
-        https://www.googleapis.com/auth/cloud-platform.read-only
diff --git a/third_party/googleapis/google/cloud/resourcemanager/v2/BUILD.bazel b/third_party/googleapis/google/cloud/resourcemanager/v2/BUILD.bazel
new file mode 100644
index 000000000..590122c0d
--- /dev/null
+++ b/third_party/googleapis/google/cloud/resourcemanager/v2/BUILD.bazel
@@ -0,0 +1,175 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "resourcemanager_proto",
+    srcs = [
+        "folders.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/iam/v1:iam_policy_proto",
+        "//google/iam/v1:policy_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "resourcemanager_proto_with_info",
+    deps = [
+        ":resourcemanager_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "resourcemanager_java_proto",
+    deps = [":resourcemanager_proto"],
+)
+
+java_grpc_library(
+    name = "resourcemanager_java_grpc",
+    srcs = [":resourcemanager_proto"],
+    deps = [":resourcemanager_java_proto"],
+)
+
+#############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "resourcemanager_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/resourcemanager/v2",
+    protos = [":resourcemanager_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/iam/v1:iam_go_proto",
+        "//google/longrunning:longrunning_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "resourcemanager_moved_proto",
+    srcs = [":resourcemanager_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/iam/v1:iam_policy_proto",
+        "//google/iam/v1:policy_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "resourcemanager_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":resourcemanager_moved_proto"],
+)
+
+py_grpc_library(
+    name = "resourcemanager_py_grpc",
+    srcs = [":resourcemanager_moved_proto"],
+    deps = [":resourcemanager_py_proto"],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "resourcemanager_php_proto",
+    deps = [":resourcemanager_proto"],
+)
+
+php_grpc_library(
+    name = "resourcemanager_php_grpc",
+    srcs = [":resourcemanager_proto"],
+    deps = [":resourcemanager_php_proto"],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "resourcemanager_ruby_proto",
+    deps = [":resourcemanager_proto"],
+)
+
+ruby_grpc_library(
+    name = "resourcemanager_ruby_grpc",
+    srcs = [":resourcemanager_proto"],
+    deps = [":resourcemanager_ruby_proto"],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "resourcemanager_csharp_proto",
+    deps = [":resourcemanager_proto"],
+)
+
+csharp_grpc_library(
+    name = "resourcemanager_csharp_grpc",
+    srcs = [":resourcemanager_proto"],
+    deps = [":resourcemanager_csharp_proto"],
+)
diff --git a/third_party/googleapis/google/cloud/resourcemanager/v2/cloudresourcemanager_gapic.yaml b/third_party/googleapis/google/cloud/resourcemanager/v2/cloudresourcemanager_gapic.legacy.yaml
similarity index 99%
rename from third_party/googleapis/google/cloud/resourcemanager/v2/cloudresourcemanager_gapic.yaml
rename to third_party/googleapis/google/cloud/resourcemanager/v2/cloudresourcemanager_gapic.legacy.yaml
index 49a394d39..e31826013 100644
--- a/third_party/googleapis/google/cloud/resourcemanager/v2/cloudresourcemanager_gapic.yaml
+++ b/third_party/googleapis/google/cloud/resourcemanager/v2/cloudresourcemanager_gapic.legacy.yaml
@@ -24,7 +24,6 @@ collection_oneofs:
   - folder
 # A list of API interface configurations.
 interfaces:
-  # The fully qualified name of the API interface.
 - name: google.cloud.resourcemanager.v2.Folders
   # A list of resource collection configurations.
   # Consists of a name_pattern and an entity_name.
diff --git a/third_party/googleapis/google/cloud/resourcemanager/v2/cloudresourcemanager_v2.yaml b/third_party/googleapis/google/cloud/resourcemanager/v2/cloudresourcemanager_v2.yaml
new file mode 100644
index 000000000..daf8c6d2b
--- /dev/null
+++ b/third_party/googleapis/google/cloud/resourcemanager/v2/cloudresourcemanager_v2.yaml
@@ -0,0 +1,47 @@
+type: google.api.Service
+config_version: 1
+name: cloudresourcemanager.googleapis.com
+title: Cloud Resource Manager API
+
+apis:
+- name: google.cloud.resourcemanager.v2.Folders
+
+types:
+- name: google.cloud.resourcemanager.v2.FolderOperation
+
+documentation:
+  summary: |-
+    Creates, reads, and updates metadata for Google Cloud Platform resource
+    containers.
+
+backend:
+  rules:
+  - selector: 'google.cloud.resourcemanager.v2.Folders.*'
+    deadline: 30.0
+
+authentication:
+  rules:
+  - selector: 'google.cloud.resourcemanager.v2.Folders.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: google.cloud.resourcemanager.v2.Folders.GetFolder
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-platform.read-only
+  - selector: google.cloud.resourcemanager.v2.Folders.GetIamPolicy
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-platform.read-only
+  - selector: google.cloud.resourcemanager.v2.Folders.ListFolders
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-platform.read-only
+  - selector: google.cloud.resourcemanager.v2.Folders.SearchFolders
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-platform.read-only
diff --git a/third_party/googleapis/google/cloud/resourcemanager/v2/folders.proto b/third_party/googleapis/google/cloud/resourcemanager/v2/folders.proto
index b231babfd..f8e9d2bc8 100644
--- a/third_party/googleapis/google/cloud/resourcemanager/v2/folders.proto
+++ b/third_party/googleapis/google/cloud/resourcemanager/v2/folders.proto
@@ -1,4 +1,4 @@
-// Copyright 2017 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,29 +11,38 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.resourcemanager.v2;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/iam/v1/iam_policy.proto";
 import "google/iam/v1/policy.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/field_mask.proto";
 import "google/protobuf/timestamp.proto";
 
+option csharp_namespace = "Google.Cloud.ResourceManager.V2";
 option go_package = "google.golang.org/genproto/googleapis/cloud/resourcemanager/v2;resourcemanager";
 option java_multiple_files = true;
 option java_outer_classname = "FoldersProto";
 option java_package = "com.google.cloud.resourcemanager.v2";
-option csharp_namespace = "Google.Cloud.ResourceManager.V2";
 option php_namespace = "Google\\Cloud\\ResourceManager\\V2";
 
 // Manages Cloud Resource Folders.
 // Cloud Resource Folders can be used to organize the resources under an
 // organization and to control the IAM policies applied to groups of resources.
 service Folders {
+  option (google.api.default_host) = "cloudresourcemanager.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/cloud-platform.read-only";
+
   // Lists the Folders that are direct descendants of supplied parent resource.
   // List provides a strongly consistent view of the Folders underneath
   // the specified parent resource.
@@ -45,6 +54,7 @@ service Folders {
     option (google.api.http) = {
       get: "/v2/folders"
     };
+    option (google.api.method_signature) = "parent,show_deleted";
   }
 
   // Search for folders that match specific filter criteria.
@@ -58,6 +68,7 @@ service Folders {
       post: "/v2/folders:search"
       body: "*"
     };
+    option (google.api.method_signature) = "query";
   }
 
   // Retrieves a Folder identified by the supplied resource name.
@@ -69,6 +80,7 @@ service Folders {
     option (google.api.http) = {
       get: "/v2/{name=folders/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates a Folder in the resource hierarchy.
@@ -79,6 +91,7 @@ service Folders {
   //
   // In order to succeed, the addition of this new Folder must not violate
   // the Folder naming, height or fanout constraints.
+  //
   // + The Folder's display_name must be distinct from all other Folder's that
   // share its parent.
   // + The addition of the Folder must not cause the active Folder hierarchy
@@ -88,12 +101,12 @@ service Folders {
   // + The addition of the Folder must not cause the total number of Folders
   // under its parent to exceed 100.
   //
-  // If the operation fails due to a folder constraint violation,
-  // a PreconditionFailure explaining the violation will be returned.
-  // If the failure occurs synchronously then the PreconditionFailure
-  // will be returned via the Status.details field and if it occurs
-  // asynchronously then the PreconditionFailure will be returned
-  // via the Operation.error field.
+  // If the operation fails due to a folder constraint violation, some errors
+  // may be returned by the CreateFolder request, with status code
+  // FAILED_PRECONDITION and an error description. Other folder constraint
+  // violations will be communicated in the Operation, with the specific
+  // PreconditionFailure returned via the details list in the Operation.error
+  // field.
   //
   // The caller must have `resourcemanager.folders.create` permission on the
   // identified parent.
@@ -102,16 +115,22 @@ service Folders {
       post: "/v2/folders"
       body: "folder"
     };
+    option (google.api.method_signature) = "parent,folder";
+    option (google.longrunning.operation_info) = {
+      response_type: "Folder"
+      metadata_type: "FolderOperation"
+    };
   }
 
   // Updates a Folder, changing its display_name.
   // Changes to the folder display_name will be rejected if they violate either
   // the display_name formatting rules or naming constraints described in
-  // the [CreateFolder] documentation.
-  // + The Folder's display name must start and end with a letter or digit,
+  // the [CreateFolder][google.cloud.resourcemanager.v2.Folders.CreateFolder] documentation.
+  //
+  // The Folder's display name must start and end with a letter or digit,
   // may contain letters, digits, spaces, hyphens and underscores and can be
   // no longer than 30 characters. This is captured by the regular expression:
-  // [\p{L}\p{N}]({\p{L}\p{N}_- ]{0,28}[\p{L}\p{N}])?.
+  // [\p{L}\p{N}]([\p{L}\p{N}_- ]{0,28}[\p{L}\p{N}])?.
   // The caller must have `resourcemanager.folders.update` permission on the
   // identified folder.
   //
@@ -123,6 +142,7 @@ service Folders {
       patch: "/v2/{folder.name=folders/*}"
       body: "folder"
     };
+    option (google.api.method_signature) = "folder,update_mask";
   }
 
   // Moves a Folder under a new resource parent.
@@ -134,11 +154,12 @@ service Folders {
   // be returned - if the failure occurs synchronously then the
   // FolderOperationError will be returned via the Status.details field
   // and if it occurs asynchronously then the FolderOperation will be returned
-  // via the the Operation.error field.
+  // via the Operation.error field.
   // In addition, the Operation.metadata field will be populated with a
   // FolderOperation message as an aid to stateless clients.
   // Folder moves will be rejected if they violate either the naming, height
-  // or fanout constraints described in the [CreateFolder] documentation.
+  // or fanout constraints described in the
+  // [CreateFolder][google.cloud.resourcemanager.v2.Folders.CreateFolder] documentation.
   // The caller must have `resourcemanager.folders.move` permission on the
   // folder's current and proposed new parent.
   rpc MoveFolder(MoveFolderRequest) returns (google.longrunning.Operation) {
@@ -146,27 +167,38 @@ service Folders {
       post: "/v2/{name=folders/*}:move"
       body: "*"
     };
+    option (google.api.method_signature) = "name,destination_parent";
+    option (google.longrunning.operation_info) = {
+      response_type: "Folder"
+      metadata_type: "FolderOperation"
+    };
   }
 
   // Requests deletion of a Folder. The Folder is moved into the
-  // [DELETE_REQUESTED] state immediately, and is deleted approximately 30 days
-  // later. This method may only be called on an empty Folder in the [ACTIVE]
-  // state, where a Folder is empty if it doesn't contain any Folders or
-  // Projects in the [ACTIVE] state.
+  // [DELETE_REQUESTED][google.cloud.resourcemanager.v2.Folder.LifecycleState.DELETE_REQUESTED] state
+  // immediately, and is deleted approximately 30 days later. This method may
+  // only be called on an empty Folder in the
+  // [ACTIVE][google.cloud.resourcemanager.v2.Folder.LifecycleState.ACTIVE] state, where a Folder is empty if
+  // it doesn't contain any Folders or Projects in the
+  // [ACTIVE][google.cloud.resourcemanager.v2.Folder.LifecycleState.ACTIVE] state.
   // The caller must have `resourcemanager.folders.delete` permission on the
   // identified folder.
   rpc DeleteFolder(DeleteFolderRequest) returns (Folder) {
     option (google.api.http) = {
       delete: "/v2/{name=folders/*}"
     };
+    option (google.api.method_signature) = "name";
+    option (google.api.method_signature) = "name,recursive_delete";
   }
 
   // Cancels the deletion request for a Folder. This method may only be
-  // called on a Folder in the [DELETE_REQUESTED] state.
-  // In order to succeed, the Folder's parent must be in the [ACTIVE] state.
+  // called on a Folder in the
+  // [DELETE_REQUESTED][google.cloud.resourcemanager.v2.Folder.LifecycleState.DELETE_REQUESTED] state.
+  // In order to succeed, the Folder's parent must be in the
+  // [ACTIVE][google.cloud.resourcemanager.v2.Folder.LifecycleState.ACTIVE] state.
   // In addition, reintroducing the folder into the tree must not violate
   // folder naming, height and fanout constraints described in the
-  // [CreateFolder] documentation.
+  // [CreateFolder][google.cloud.resourcemanager.v2.Folders.CreateFolder] documentation.
   // The caller must have `resourcemanager.folders.undelete` permission on the
   // identified folder.
   rpc UndeleteFolder(UndeleteFolderRequest) returns (Folder) {
@@ -174,6 +206,7 @@ service Folders {
       post: "/v2/{name=folders/*}:undelete"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Gets the access control policy for a Folder. The returned policy may be
@@ -181,12 +214,12 @@ service Folders {
   // be the Folder's resource name, e.g. "folders/1234".
   // The caller must have `resourcemanager.folders.getIamPolicy` permission
   // on the identified folder.
-  rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest)
-      returns (google.iam.v1.Policy) {
+  rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) returns (google.iam.v1.Policy) {
     option (google.api.http) = {
       post: "/v2/{resource=folders/*}:getIamPolicy"
       body: "*"
     };
+    option (google.api.method_signature) = "resource";
   }
 
   // Sets the access control policy on a Folder, replacing any existing policy.
@@ -194,12 +227,12 @@ service Folders {
   // "folders/1234".
   // The caller must have `resourcemanager.folders.setIamPolicy` permission
   // on the identified folder.
-  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest)
-      returns (google.iam.v1.Policy) {
+  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) returns (google.iam.v1.Policy) {
     option (google.api.http) = {
       post: "/v2/{resource=folders/*}:setIamPolicy"
       body: "*"
     };
+    option (google.api.method_signature) = "resource,policy";
   }
 
   // Returns permissions that a caller has on the specified Folder.
@@ -207,18 +240,23 @@ service Folders {
   // e.g. "folders/1234".
   //
   // There are no permissions required for making this API call.
-  rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest)
-      returns (google.iam.v1.TestIamPermissionsResponse) {
+  rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest) returns (google.iam.v1.TestIamPermissionsResponse) {
     option (google.api.http) = {
       post: "/v2/{resource=folders/*}:testIamPermissions"
       body: "*"
     };
+    option (google.api.method_signature) = "resource,permissions";
   }
 }
 
 // A Folder in an Organization's resource hierarchy, used to
 // organize that Organization's resources.
 message Folder {
+  option (google.api.resource) = {
+    type: "cloudresourcemanager.googleapis.com/Folder"
+    pattern: "folders/{folder}"
+  };
+
   // Folder lifecycle states.
   enum LifecycleState {
     // Unspecified state.
@@ -233,11 +271,12 @@ message Folder {
 
   // Output only. The resource name of the Folder.
   // Its format is `folders/{folder_id}`, for example: "folders/1234".
-  string name = 1;
+  string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // The Folder’s parent's resource name.
-  // Updates to the folder's parent must be performed via [MoveFolders].
-  string parent = 2;
+  // Required. The Folder’s parent's resource name.
+  // Updates to the folder's parent must be performed via
+  // [MoveFolder][google.cloud.resourcemanager.v2.Folders.MoveFolder].
+  string parent = 2 [(google.api.field_behavior) = REQUIRED];
 
   // The folder’s display name.
   // A folder’s display name must be unique amongst its siblings, e.g.
@@ -245,42 +284,47 @@ message Folder {
   // The display name must start and end with a letter or digit, may contain
   // letters, digits, spaces, hyphens and underscores and can be no longer
   // than 30 characters. This is captured by the regular expression:
-  // [\p{L}\p{N}]({\p{L}\p{N}_- ]{0,28}[\p{L}\p{N}])?.
+  // [\p{L}\p{N}]([\p{L}\p{N}_- ]{0,28}[\p{L}\p{N}])?.
   string display_name = 3;
 
-  // Output only.  The lifecycle state of the folder.
+  // Output only. The lifecycle state of the folder.
   // Updates to the lifecycle_state must be performed via
-  // [DeleteFolder] and [UndeleteFolder].
-  LifecycleState lifecycle_state = 4;
+  // [DeleteFolder][google.cloud.resourcemanager.v2.Folders.DeleteFolder] and
+  // [UndeleteFolder][google.cloud.resourcemanager.v2.Folders.UndeleteFolder].
+  LifecycleState lifecycle_state = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Timestamp when the Folder was created. Assigned by the server.
-  google.protobuf.Timestamp create_time = 5;
+  google.protobuf.Timestamp create_time = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Timestamp when the Folder was last modified.
-  google.protobuf.Timestamp update_time = 6;
+  google.protobuf.Timestamp update_time = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // The ListFolders request message.
 message ListFoldersRequest {
-  // The resource name of the Organization or Folder whose Folders are
+  // Required. The resource name of the Organization or Folder whose Folders are
   // being listed.
   // Must be of the form `folders/{folder_id}` or `organizations/{org_id}`.
   // Access to this method is controlled by checking the
   // `resourcemanager.folders.list` permission on the `parent`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "*"
+    }
+  ];
 
-  // The maximum number of Folders to return in the response.
-  // This field is optional.
-  int32 page_size = 2;
+  // Optional. The maximum number of Folders to return in the response.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // A pagination token returned from a previous call to `ListFolders`
+  // Optional. A pagination token returned from a previous call to `ListFolders`
   // that indicates where this listing should continue from.
-  // This field is optional.
-  string page_token = 3;
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
 
-  // Controls whether Folders in the [DELETE_REQUESTED} state should
-  // be returned.
-  bool show_deleted = 4;
+  // Optional. Controls whether Folders in the
+  // [DELETE_REQUESTED][google.cloud.resourcemanager.v2.Folder.LifecycleState.DELETE_REQUESTED]
+  // state should be returned. Defaults to false.
+  bool show_deleted = 4 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // The ListFolders response message.
@@ -291,20 +335,17 @@ message ListFoldersResponse {
 
   // A pagination token returned from a previous call to `ListFolders`
   // that indicates from where listing should continue.
-  // This field is optional.
   string next_page_token = 2;
 }
 
 // The request message for searching folders.
 message SearchFoldersRequest {
-  // The maximum number of folders to return in the response.
-  // This field is optional.
-  int32 page_size = 1;
+  // Optional. The maximum number of folders to return in the response.
+  int32 page_size = 1 [(google.api.field_behavior) = OPTIONAL];
 
-  // A pagination token returned from a previous call to `SearchFolders`
+  // Optional. A pagination token returned from a previous call to `SearchFolders`
   // that indicates from where search should continue.
-  // This field is optional.
-  string page_token = 2;
+  string page_token = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // Search criteria used to select the Folders to return.
   // If no search criteria is specified then all accessible folders will be
@@ -314,14 +355,21 @@ message SearchFoldersRequest {
   // lifecycleState and parent, where the operators `=`, `NOT`, `AND` and `OR`
   // can be used along with the suffix wildcard symbol `*`.
   //
+  // The displayName field in a query expression should use escaped quotes
+  // for values that include whitespace to prevent unexpected behavior.
+  //
   // Some example queries are:
-  // |Query|Description|
-  // |------|-----------|
-  // |displayName=Test*|Folders whose display name starts with "Test".|
-  // |lifecycleState=ACTIVE|Folders whose lifecycleState is ACTIVE.|
-  // |parent=folders/123|Folders whose parent is "folders/123".|
-  // |parent=folders/123 AND lifecycleState=ACTIVE|Active folders whose
-  // parent is "folders/123".|
+  //
+  // * Query `displayName=Test*` returns Folder resources whose display name
+  // starts with "Test".
+  // * Query `lifecycleState=ACTIVE` returns Folder resources with
+  // `lifecycleState` set to `ACTIVE`.
+  // * Query `parent=folders/123` returns Folder resources that have
+  // `folders/123` as a parent resource.
+  // * Query `parent=folders/123 AND lifecycleState=ACTIVE` returns active
+  // Folder resources that have `folders/123` as a parent resource.
+  // * Query `displayName=\\"Test String\\"` returns Folder resources with
+  // display names that include both "Test" and "String".
   string query = 3;
 }
 
@@ -333,57 +381,81 @@ message SearchFoldersResponse {
 
   // A pagination token returned from a previous call to `SearchFolders`
   // that indicates from where searching should continue.
-  // This field is optional.
   string next_page_token = 2;
 }
 
 // The GetFolder request message.
 message GetFolderRequest {
-  // The resource name of the Folder to retrieve.
+  // Required. The resource name of the Folder to retrieve.
   // Must be of the form `folders/{folder_id}`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Folder"
+    }
+  ];
 }
 
 // The CreateFolder request message.
 message CreateFolderRequest {
-  // The resource name of the new Folder's parent.
+  // Required. The resource name of the new Folder's parent.
   // Must be of the form `folders/{folder_id}` or `organizations/{org_id}`.
-  string parent = 1;
-
-  // The Folder being created, only the display name will be consulted.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "*"
+    }
+  ];
+
+  // Required. The Folder being created, only the display name will be consulted.
   // All other fields will be ignored.
-  Folder folder = 2;
+  Folder folder = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The MoveFolder request message.
 message MoveFolderRequest {
-  // The resource name of the Folder to move.
+  // Required. The resource name of the Folder to move.
   // Must be of the form folders/{folder_id}
-  string name = 1;
-
-  // The resource name of the Folder or Organization to reparent
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Folder"
+    }
+  ];
+
+  // Required. The resource name of the Folder or Organization to reparent
   // the folder under.
   // Must be of the form `folders/{folder_id}` or `organizations/{org_id}`.
-  string destination_parent = 2;
+  string destination_parent = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "*"
+    }
+  ];
 }
 
 // The request message for updating a folder's display name.
 message UpdateFolderRequest {
-  // The new definition of the Folder. It must include a
+  // Required. The new definition of the Folder. It must include a
   // a `name` and `display_name` field. The other fields
   // will be ignored.
-  Folder folder = 1;
+  Folder folder = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Fields to be updated.
+  // Required. Fields to be updated.
   // Only the `display_name` can be updated.
-  google.protobuf.FieldMask update_mask = 2;
+  google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The DeleteFolder request message.
 message DeleteFolderRequest {
-  // the resource name of the Folder to be deleted.
+  // Required. The resource name of the Folder to be deleted.
   // Must be of the form `folders/{folder_id}`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Folder"
+    }
+  ];
 
   // Instructs DeleteFolderAction to delete a folder even when the folder is not
   // empty.
@@ -392,9 +464,14 @@ message DeleteFolderRequest {
 
 // The UndeleteFolder request message.
 message UndeleteFolderRequest {
-  // The resource name of the Folder to undelete.
+  // Required. The resource name of the Folder to undelete.
   // Must be of the form `folders/{folder_id}`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Folder"
+    }
+  ];
 }
 
 // Metadata describing a long running folder operation
diff --git a/third_party/googleapis/google/cloud/scheduler/BUILD.bazel b/third_party/googleapis/google/cloud/scheduler/BUILD.bazel
index 1e5b8c2af..a87c57fec 100644
--- a/third_party/googleapis/google/cloud/scheduler/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/scheduler/BUILD.bazel
@@ -1 +1 @@
-exports_files(glob(["*.yaml"]))
\ No newline at end of file
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/cloud/scheduler/artman_cloudscheduler_v1.yaml b/third_party/googleapis/google/cloud/scheduler/artman_cloudscheduler_v1.yaml
index ab2c4fa10..01fb41055 100644
--- a/third_party/googleapis/google/cloud/scheduler/artman_cloudscheduler_v1.yaml
+++ b/third_party/googleapis/google/cloud/scheduler/artman_cloudscheduler_v1.yaml
@@ -3,11 +3,12 @@ common:
   api_version: v1
   organization_name: google-cloud
   proto_deps:
-    - name: google-common-protos
+  - name: google-common-protos
   src_proto_paths:
   - v1
-  service_yaml: cloudscheduler_v1.yaml
+  service_yaml: v1/cloudscheduler_v1.yaml
   gapic_yaml: v1/cloudscheduler_gapic.yaml
+  proto_package: google.cloud.scheduler.v1
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/cloud/scheduler/artman_cloudscheduler_v1beta1.yaml b/third_party/googleapis/google/cloud/scheduler/artman_cloudscheduler_v1beta1.yaml
index 44313ae1b..212875919 100644
--- a/third_party/googleapis/google/cloud/scheduler/artman_cloudscheduler_v1beta1.yaml
+++ b/third_party/googleapis/google/cloud/scheduler/artman_cloudscheduler_v1beta1.yaml
@@ -3,11 +3,12 @@ common:
   api_version: v1beta1
   organization_name: google-cloud
   proto_deps:
-    - name: google-common-protos
+  - name: google-common-protos
   src_proto_paths:
   - v1beta1
-  service_yaml: cloudscheduler_v1beta1.yaml
+  service_yaml: v1beta1/cloudscheduler_v1beta1.yaml
   gapic_yaml: v1beta1/cloudscheduler_gapic.yaml
+  proto_package: google.cloud.scheduler.v1beta1
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/cloud/scheduler/v1/BUILD.bazel b/third_party/googleapis/google/cloud/scheduler/v1/BUILD.bazel
new file mode 100644
index 000000000..7c1d2ccfa
--- /dev/null
+++ b/third_party/googleapis/google/cloud/scheduler/v1/BUILD.bazel
@@ -0,0 +1,369 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "scheduler_proto",
+    srcs = [
+        "cloudscheduler.proto",
+        "job.proto",
+        "target.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/rpc:status_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "scheduler_proto_with_info",
+    deps = [
+        ":scheduler_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "scheduler_java_proto",
+    deps = [":scheduler_proto"],
+)
+
+java_grpc_library(
+    name = "scheduler_java_grpc",
+    srcs = [":scheduler_proto"],
+    deps = [":scheduler_java_proto"],
+)
+
+java_gapic_library(
+    name = "scheduler_java_gapic",
+    src = ":scheduler_proto_with_info",
+    gapic_yaml = "cloudscheduler_gapic.yaml",
+    package = "google.cloud.scheduler.v1",
+    service_yaml = "cloudscheduler_v1.yaml",
+    test_deps = [
+        ":scheduler_java_grpc",
+    ],
+    deps = [
+        ":scheduler_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "scheduler_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.scheduler.v1.CloudSchedulerClientTest",
+    ],
+    runtime_deps = [":scheduler_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-scheduler-v1-java",
+    deps = [
+        ":scheduler_java_gapic",
+        ":scheduler_java_grpc",
+        ":scheduler_java_proto",
+        ":scheduler_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "scheduler_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/scheduler/v1",
+    protos = [":scheduler_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/rpc:status_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "scheduler_go_gapic",
+    srcs = [":scheduler_proto_with_info"],
+    grpc_service_config = "cloudscheduler_grpc_service_config.json",
+    importpath = "cloud.google.com/go/scheduler/apiv1;scheduler",
+    service_yaml = "cloudscheduler_v1.yaml",
+    deps = [
+        ":scheduler_go_proto",
+    ],
+)
+
+go_test(
+    name = "scheduler_go_gapic_test",
+    srcs = [":scheduler_go_gapic_srcjar_test"],
+    embed = [":scheduler_go_gapic"],
+    importpath = "cloud.google.com/go/scheduler/apiv1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-scheduler-v1-go",
+    deps = [
+        ":scheduler_go_gapic",
+        ":scheduler_go_gapic_srcjar-test.srcjar",
+        ":scheduler_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "scheduler_moved_proto",
+    srcs = [":scheduler_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/rpc:status_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "scheduler_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":scheduler_moved_proto"],
+)
+
+py_grpc_library(
+    name = "scheduler_py_grpc",
+    srcs = [":scheduler_moved_proto"],
+    deps = [":scheduler_py_proto"],
+)
+
+py_gapic_library(
+    name = "scheduler_py_gapic",
+    src = ":scheduler_proto_with_info",
+    gapic_yaml = "cloudscheduler_gapic.yaml",
+    package = "google.cloud.scheduler.v1",
+    service_yaml = "cloudscheduler_v1.yaml",
+    deps = [
+        ":scheduler_py_grpc",
+        ":scheduler_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "scheduler-v1-py",
+    deps = [
+        ":scheduler_py_gapic",
+        ":scheduler_py_grpc",
+        ":scheduler_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "scheduler_php_proto",
+    deps = [":scheduler_proto"],
+)
+
+php_grpc_library(
+    name = "scheduler_php_grpc",
+    srcs = [":scheduler_proto"],
+    deps = [":scheduler_php_proto"],
+)
+
+php_gapic_library(
+    name = "scheduler_php_gapic",
+    src = ":scheduler_proto_with_info",
+    gapic_yaml = "cloudscheduler_gapic.yaml",
+    package = "google.cloud.scheduler.v1",
+    service_yaml = "cloudscheduler_v1.yaml",
+    deps = [
+        ":scheduler_php_grpc",
+        ":scheduler_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-scheduler-v1-php",
+    deps = [
+        ":scheduler_php_gapic",
+        ":scheduler_php_grpc",
+        ":scheduler_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "scheduler_nodejs_gapic",
+    src = ":scheduler_proto_with_info",
+    gapic_yaml = "cloudscheduler_gapic.yaml",
+    package = "google.cloud.scheduler.v1",
+    service_yaml = "cloudscheduler_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "scheduler-v1-nodejs",
+    deps = [
+        ":scheduler_nodejs_gapic",
+        ":scheduler_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "scheduler_ruby_proto",
+    deps = [":scheduler_proto"],
+)
+
+ruby_grpc_library(
+    name = "scheduler_ruby_grpc",
+    srcs = [":scheduler_proto"],
+    deps = [":scheduler_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "scheduler_ruby_gapic",
+    src = ":scheduler_proto_with_info",
+    gapic_yaml = "cloudscheduler_gapic.yaml",
+    package = "google.cloud.scheduler.v1",
+    service_yaml = "cloudscheduler_v1.yaml",
+    deps = [
+        ":scheduler_ruby_grpc",
+        ":scheduler_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-scheduler-v1-ruby",
+    deps = [
+        ":scheduler_ruby_gapic",
+        ":scheduler_ruby_grpc",
+        ":scheduler_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "scheduler_csharp_proto",
+    deps = [":scheduler_proto"],
+)
+
+csharp_grpc_library(
+    name = "scheduler_csharp_grpc",
+    srcs = [":scheduler_proto"],
+    deps = [":scheduler_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "scheduler_csharp_gapic",
+    src = ":scheduler_proto_with_info",
+    gapic_yaml = "cloudscheduler_gapic.yaml",
+    package = "google.cloud.scheduler.v1",
+    service_yaml = "cloudscheduler_v1.yaml",
+    deps = [
+        ":scheduler_csharp_grpc",
+        ":scheduler_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-scheduler-v1-csharp",
+    deps = [
+        ":scheduler_csharp_gapic",
+        ":scheduler_csharp_grpc",
+        ":scheduler_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/scheduler/v1/cloudscheduler.proto b/third_party/googleapis/google/cloud/scheduler/v1/cloudscheduler.proto
index a68446235..89ce8cbd3 100644
--- a/third_party/googleapis/google/cloud/scheduler/v1/cloudscheduler.proto
+++ b/third_party/googleapis/google/cloud/scheduler/v1/cloudscheduler.proto
@@ -18,6 +18,8 @@ syntax = "proto3";
 package google.cloud.scheduler.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/cloud/scheduler/v1/job.proto";
 import "google/protobuf/empty.proto";
@@ -32,11 +34,15 @@ option objc_class_prefix = "SCHEDULER";
 // The Cloud Scheduler API allows external entities to reliably
 // schedule asynchronous jobs.
 service CloudScheduler {
+  option (google.api.default_host) = "cloudscheduler.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Lists jobs.
   rpc ListJobs(ListJobsRequest) returns (ListJobsResponse) {
     option (google.api.http) = {
       get: "/v1/{parent=projects/*/locations/*}/jobs"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets a job.
@@ -44,6 +50,7 @@ service CloudScheduler {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/locations/*/jobs/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates a job.
@@ -52,6 +59,7 @@ service CloudScheduler {
       post: "/v1/{parent=projects/*/locations/*}/jobs"
       body: "job"
     };
+    option (google.api.method_signature) = "parent,job";
   }
 
   // Updates a job.
@@ -68,6 +76,7 @@ service CloudScheduler {
       patch: "/v1/{job.name=projects/*/locations/*/jobs/*}"
       body: "job"
     };
+    option (google.api.method_signature) = "job,update_mask";
   }
 
   // Deletes a job.
@@ -75,6 +84,7 @@ service CloudScheduler {
     option (google.api.http) = {
       delete: "/v1/{name=projects/*/locations/*/jobs/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Pauses a job.
@@ -89,6 +99,7 @@ service CloudScheduler {
       post: "/v1/{name=projects/*/locations/*/jobs/*}:pause"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Resume a job.
@@ -102,6 +113,7 @@ service CloudScheduler {
       post: "/v1/{name=projects/*/locations/*/jobs/*}:resume"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Forces a job to run now.
@@ -113,16 +125,20 @@ service CloudScheduler {
       post: "/v1/{name=projects/*/locations/*/jobs/*}:run"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 }
 
 // Request message for listing jobs using [ListJobs][google.cloud.scheduler.v1.CloudScheduler.ListJobs].
 message ListJobsRequest {
-  // Required.
-  //
-  // The location name. For example:
+  // Required. The location name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "cloudscheduler.googleapis.com/Job"
+    }
+  ];
 
   // Requested page size.
   //
@@ -159,79 +175,94 @@ message ListJobsResponse {
 
 // Request message for [GetJob][google.cloud.scheduler.v1.CloudScheduler.GetJob].
 message GetJobRequest {
-  // Required.
-  //
-  // The job name. For example:
+  // Required. The job name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudscheduler.googleapis.com/Job"
+    }
+  ];
 }
 
 // Request message for [CreateJob][google.cloud.scheduler.v1.CloudScheduler.CreateJob].
 message CreateJobRequest {
-  // Required.
-  //
-  // The location name. For example:
+  // Required. The location name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "cloudscheduler.googleapis.com/Job"
+    }
+  ];
 
-  // Required.
-  //
-  // The job to add. The user can optionally specify a name for the
+  // Required. The job to add. The user can optionally specify a name for the
   // job in [name][google.cloud.scheduler.v1.Job.name]. [name][google.cloud.scheduler.v1.Job.name] cannot be the same as an
   // existing job. If a name is not specified then the system will
   // generate a random unique name that will be returned
   // ([name][google.cloud.scheduler.v1.Job.name]) in the response.
-  Job job = 2;
+  Job job = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request message for [UpdateJob][google.cloud.scheduler.v1.CloudScheduler.UpdateJob].
 message UpdateJobRequest {
-  // Required.
-  //
-  // The new job properties. [name][google.cloud.scheduler.v1.Job.name] must be specified.
+  // Required. The new job properties. [name][google.cloud.scheduler.v1.Job.name] must be specified.
   //
   // Output only fields cannot be modified using UpdateJob.
   // Any value specified for an output only field will be ignored.
-  Job job = 1;
+  Job job = 1 [(google.api.field_behavior) = REQUIRED];
 
   // A  mask used to specify which fields of the job are being updated.
-  google.protobuf.FieldMask update_mask = 2;
+  google.protobuf.FieldMask update_mask = 2
+    [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request message for deleting a job using
 // [DeleteJob][google.cloud.scheduler.v1.CloudScheduler.DeleteJob].
 message DeleteJobRequest {
-  // Required.
-  //
-  // The job name. For example:
+  // Required. The job name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudscheduler.googleapis.com/Job"
+    }
+  ];
 }
 
 // Request message for [PauseJob][google.cloud.scheduler.v1.CloudScheduler.PauseJob].
 message PauseJobRequest {
-  // Required.
-  //
-  // The job name. For example:
+  // Required. The job name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudscheduler.googleapis.com/Job"
+    }
+  ];
 }
 
 // Request message for [ResumeJob][google.cloud.scheduler.v1.CloudScheduler.ResumeJob].
 message ResumeJobRequest {
-  // Required.
-  //
-  // The job name. For example:
+  // Required. The job name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudscheduler.googleapis.com/Job"
+    }
+  ];
 }
 
 // Request message for forcing a job to run now using
 // [RunJob][google.cloud.scheduler.v1.CloudScheduler.RunJob].
 message RunJobRequest {
-  // Required.
-  //
-  // The job name. For example:
+  // Required. The job name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudscheduler.googleapis.com/Job"
+    }
+  ];
 }
diff --git a/third_party/googleapis/google/cloud/scheduler/v1/cloudscheduler_gapic.legacy.yaml b/third_party/googleapis/google/cloud/scheduler/v1/cloudscheduler_gapic.legacy.yaml
new file mode 100644
index 000000000..e3055f0b5
--- /dev/null
+++ b/third_party/googleapis/google/cloud/scheduler/v1/cloudscheduler_gapic.legacy.yaml
@@ -0,0 +1,261 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.scheduler.v1
+  python:
+    package_name: google.cloud.scheduler_v1.gapic
+  go:
+    package_name: cloud.google.com/go/scheduler/apiv1
+    release_level: GA
+  csharp:
+    package_name: Google.Cloud.Scheduler.V1
+    release_level: GA
+  ruby:
+    package_name: Google::Cloud::Scheduler::V1
+    release_level: GA
+  php:
+    package_name: Google\Cloud\Scheduler\V1
+  nodejs:
+    package_name: scheduler.v1
+    domain_layer_location: google-cloud
+# A list of API interface configurations.
+interfaces:
+- name: google.cloud.scheduler.v1.CloudScheduler
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}
+    entity_name: project
+    language_overrides:
+    - language: csharp
+      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
+  - name_pattern: projects/{project}/locations/{location}
+    entity_name: location
+  - name_pattern: projects/{project}/locations/{location}/jobs/{job}
+    entity_name: job
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ListJobs
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: jobs
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 30000
+  - name: GetJob
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: job
+    timeout_millis: 30000
+  - name: CreateJob
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - job
+    required_fields:
+    - parent
+    - job
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 30000
+  - name: UpdateJob
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - job
+        - update_mask
+    required_fields:
+    - job
+    - update_mask
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      job.name: job
+    timeout_millis: 30000
+  - name: DeleteJob
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: job
+    timeout_millis: 30000
+  - name: PauseJob
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: job
+    timeout_millis: 30000
+  - name: ResumeJob
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: job
+    timeout_millis: 30000
+  - name: RunJob
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: job
+    timeout_millis: 30000
+resource_name_generation:
+- message_name: Job
+  field_entity_map:
+    name: job
+- message_name: ListJobsRequest
+  field_entity_map:
+    parent: location
+- message_name: GetJobRequest
+  field_entity_map:
+    name: job
+- message_name: CreateJobRequest
+  field_entity_map:
+    parent: location
+- message_name: UpdateJobRequest
+  field_entity_map:
+    job.name: job
+- message_name: DeleteJobRequest
+  field_entity_map:
+    name: job
+- message_name: PauseJobRequest
+  field_entity_map:
+    name: job
+- message_name: ResumeJobRequest
+  field_entity_map:
+    name: job
+- message_name: RunJobRequest
+  field_entity_map:
+    name: job
diff --git a/third_party/googleapis/google/cloud/scheduler/v1/cloudscheduler_gapic.yaml b/third_party/googleapis/google/cloud/scheduler/v1/cloudscheduler_gapic.yaml
index c3ee26568..be8c0d404 100644
--- a/third_party/googleapis/google/cloud/scheduler/v1/cloudscheduler_gapic.yaml
+++ b/third_party/googleapis/google/cloud/scheduler/v1/cloudscheduler_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -20,243 +20,8 @@ language_settings:
   nodejs:
     package_name: scheduler.v1
     domain_layer_location: google-cloud
-# A list of API interface configurations.
 interfaces:
-  # The fully qualified name of the API interface.
 - name: google.cloud.scheduler.v1.CloudScheduler
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections:
-  - name_pattern: projects/{project}
-    entity_name: project
-    language_overrides:
-    - language: csharp
-      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
-  - name_pattern: projects/{project}/locations/{location}
-    entity_name: location
-  - name_pattern: projects/{project}/locations/{location}/jobs/{job}
-    entity_name: job
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
   methods:
-  - name: ListJobs
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: jobs
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    timeout_millis: 30000
-  - name: GetJob
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: job
-    timeout_millis: 30000
-  - name: CreateJob
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - job
-    required_fields:
-    - parent
-    - job
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    timeout_millis: 30000
-  - name: UpdateJob
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - job
-        - update_mask
-    required_fields:
-    - job
-    - update_mask
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      job.name: job
-    timeout_millis: 30000
   - name: DeleteJob
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: job
-    timeout_millis: 30000
-  - name: PauseJob
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: job
-    timeout_millis: 30000
-  - name: ResumeJob
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: job
-    timeout_millis: 30000
-  - name: RunJob
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: job
-    timeout_millis: 30000
-resource_name_generation:
-- message_name: Job
-  field_entity_map:
-    name: job
-- message_name: ListJobsRequest
-  field_entity_map:
-    parent: location
-- message_name: GetJobRequest
-  field_entity_map:
-    name: job
-- message_name: CreateJobRequest
-  field_entity_map:
-    parent: location
-- message_name: UpdateJobRequest
-  field_entity_map:
-    job.name: job
-- message_name: DeleteJobRequest
-  field_entity_map:
-    name: job
-- message_name: PauseJobRequest
-  field_entity_map:
-    name: job
-- message_name: ResumeJobRequest
-  field_entity_map:
-    name: job
-- message_name: RunJobRequest
-  field_entity_map:
-    name: job
diff --git a/third_party/googleapis/google/cloud/scheduler/v1/cloudscheduler_grpc_service_config.json b/third_party/googleapis/google/cloud/scheduler/v1/cloudscheduler_grpc_service_config.json
new file mode 100755
index 000000000..87980d856
--- /dev/null
+++ b/third_party/googleapis/google/cloud/scheduler/v1/cloudscheduler_grpc_service_config.json
@@ -0,0 +1,55 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.scheduler.v1.CloudScheduler",
+          "method": "ListJobs"
+        },
+        {
+          "service": "google.cloud.scheduler.v1.CloudScheduler",
+          "method": "GetJob"
+        },
+        {
+          "service": "google.cloud.scheduler.v1.CloudScheduler",
+          "method": "DeleteJob"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.scheduler.v1.CloudScheduler",
+          "method": "CreateJob"
+        },
+        {
+          "service": "google.cloud.scheduler.v1.CloudScheduler",
+          "method": "UpdateJob"
+        },
+        {
+          "service": "google.cloud.scheduler.v1.CloudScheduler",
+          "method": "PauseJob"
+        },
+        {
+          "service": "google.cloud.scheduler.v1.CloudScheduler",
+          "method": "ResumeJob"
+        },
+        {
+          "service": "google.cloud.scheduler.v1.CloudScheduler",
+          "method": "RunJob"
+        }
+      ],
+      "timeout": "600s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/scheduler/cloudscheduler_v1.yaml b/third_party/googleapis/google/cloud/scheduler/v1/cloudscheduler_v1.yaml
similarity index 100%
rename from third_party/googleapis/google/cloud/scheduler/cloudscheduler_v1.yaml
rename to third_party/googleapis/google/cloud/scheduler/v1/cloudscheduler_v1.yaml
diff --git a/third_party/googleapis/google/cloud/scheduler/v1/job.proto b/third_party/googleapis/google/cloud/scheduler/v1/job.proto
index 60b472631..d26070266 100644
--- a/third_party/googleapis/google/cloud/scheduler/v1/job.proto
+++ b/third_party/googleapis/google/cloud/scheduler/v1/job.proto
@@ -17,12 +17,12 @@ syntax = "proto3";
 
 package google.cloud.scheduler.v1;
 
-import "google/api/annotations.proto";
 import "google/api/resource.proto";
 import "google/cloud/scheduler/v1/target.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
 import "google/rpc/status.proto";
+import "google/api/annotations.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/scheduler/v1;scheduler";
 option java_multiple_files = true;
@@ -32,6 +32,11 @@ option java_package = "com.google.cloud.scheduler.v1";
 // Configuration for a job.
 // The maximum allowed size for a job is 100KB.
 message Job {
+  option (google.api.resource) = {
+    type: "cloudscheduler.googleapis.com/Job"
+    pattern: "projects/{project}/locations/{location}/jobs/{job}"
+  };
+
   // State of the job.
   enum State {
     // Unspecified state.
diff --git a/third_party/googleapis/google/cloud/scheduler/v1/target.proto b/third_party/googleapis/google/cloud/scheduler/v1/target.proto
index e33b1558e..9a8f32f7c 100644
--- a/third_party/googleapis/google/cloud/scheduler/v1/target.proto
+++ b/third_party/googleapis/google/cloud/scheduler/v1/target.proto
@@ -17,8 +17,8 @@ syntax = "proto3";
 
 package google.cloud.scheduler.v1;
 
+import "google/api/resource.proto";
 import "google/api/annotations.proto";
-import "google/protobuf/any.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/scheduler/v1;scheduler";
 option java_multiple_files = true;
@@ -32,9 +32,7 @@ option java_package = "com.google.cloud.scheduler.v1";
 // constitutes a failed execution. For a redirected request, the response
 // returned by the redirected request is considered.
 message HttpTarget {
-  // Required.
-  //
-  // The full URI path that the request will be sent to. This string
+  // Required. The full URI path that the request will be sent to. This string
   // must begin with either "http://" or "https://". Some examples of
   // valid values for [uri][google.cloud.scheduler.v1.HttpTarget.uri] are:
   // `http://acme.com` and `https://acme.com/sales:8080`. Cloud Scheduler will
@@ -77,8 +75,8 @@ message HttpTarget {
     // will be generated and attached as an `Authorization` header in the HTTP
     // request.
     //
-    // This type of authorization should be used when sending requests to a GCP
-    // endpoint.
+    // This type of authorization should generally only be used when calling
+    // Google APIs hosted on *.googleapis.com.
     OAuthToken oauth_token = 5;
 
     // If specified, an
@@ -86,8 +84,9 @@ message HttpTarget {
     // token will be generated and attached as an `Authorization` header in the
     // HTTP request.
     //
-    // This type of authorization should be used when sending requests to third
-    // party endpoints or Cloud Run.
+    // This type of authorization can be used for many scenarios, including
+    // calling Cloud Run, or endpoints where you intend to validate the token
+    // yourself.
     OidcToken oidc_token = 6;
   }
 }
@@ -162,16 +161,16 @@ message AppEngineHttpTarget {
 // Pub/Sub target. The job will be delivered by publishing a message to
 // the given Pub/Sub topic.
 message PubsubTarget {
-  // Required.
-  //
-  // The name of the Cloud Pub/Sub topic to which messages will
+  // Required. The name of the Cloud Pub/Sub topic to which messages will
   // be published when a job is delivered. The topic name must be in the
   // same format as required by PubSub's
   // [PublishRequest.name](https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#publishrequest),
   // for example `projects/PROJECT_ID/topics/TOPIC_ID`.
   //
   // The topic must be in the same project as the Cloud Scheduler job.
-  string topic_name = 1;
+  string topic_name = 1 [(google.api.resource_reference) = {
+                           type: "pubsub.googleapis.com/Topic"
+                         }];
 
   // The message payload for PubsubMessage.
   //
@@ -315,8 +314,8 @@ enum HttpMethod {
 
 // Contains information needed for generating an
 // [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
-// This type of authorization should be used when sending requests to a GCP
-// endpoint.
+// This type of authorization should generally only be used when calling Google
+// APIs hosted on *.googleapis.com.
 message OAuthToken {
   // [Service account email](https://cloud.google.com/iam/docs/service-accounts)
   // to be used for generating OAuth token.
@@ -332,9 +331,10 @@ message OAuthToken {
 
 // Contains information needed for generating an
 // [OpenID Connect
-// token](https://developers.google.com/identity/protocols/OpenIDConnect). This
-// type of authorization should be used when sending requests to third party
-// endpoints or Cloud Run.
+// token](https://developers.google.com/identity/protocols/OpenIDConnect).
+// This type of authorization can be used for many scenarios, including
+// calling Cloud Run, or endpoints where you intend to validate the token
+// yourself.
 message OidcToken {
   // [Service account email](https://cloud.google.com/iam/docs/service-accounts)
   // to be used for generating OIDC token.
@@ -346,3 +346,11 @@ message OidcToken {
   // specified in target will be used.
   string audience = 2;
 }
+
+// The Pub/Sub Topic resource definition is in google/cloud/pubsub/v1/,
+// but we do not import that proto directly; therefore, we redefine the
+// pattern here.
+option (google.api.resource_definition) = {
+  type: "pubsub.googleapis.com/Topic"
+  pattern: "projects/{project}/topics/{topic}"
+};
diff --git a/third_party/googleapis/google/cloud/scheduler/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/scheduler/v1beta1/BUILD.bazel
index 33ac91119..617077d96 100644
--- a/third_party/googleapis/google/cloud/scheduler/v1beta1/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/scheduler/v1beta1/BUILD.bazel
@@ -1,9 +1,12 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
@@ -15,9 +18,10 @@ proto_library(
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
         "//google/api:resource_proto",
         "//google/rpc:status_proto",
-        "@com_google_protobuf//:any_proto",
         "@com_google_protobuf//:duration_proto",
         "@com_google_protobuf//:empty_proto",
         "@com_google_protobuf//:field_mask_proto",
@@ -27,7 +31,10 @@ proto_library(
 
 proto_library_with_info(
     name = "scheduler_proto_with_info",
-    deps = [":scheduler_proto"],
+    deps = [
+        ":scheduler_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -35,18 +42,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
     name = "scheduler_java_proto",
     deps = [":scheduler_proto"],
@@ -55,48 +57,40 @@ java_proto_library(
 java_grpc_library(
     name = "scheduler_java_grpc",
     srcs = [":scheduler_proto"],
-    deps = [":scheduler_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "scheduler_resource_name_java_proto",
-    gapic_yaml = "cloudscheduler_gapic.yaml",
-    deps = [":scheduler_proto"],
+    deps = [":scheduler_java_proto"],
 )
 
 java_gapic_library(
     name = "scheduler_java_gapic",
     src = ":scheduler_proto_with_info",
     gapic_yaml = "cloudscheduler_gapic.yaml",
-    service_yaml = "//google/cloud/scheduler:cloudscheduler_v1beta1.yaml",
-    test_deps = [":scheduler_java_grpc"],
+    package = "google.cloud.scheduler.v1beta1",
+    service_yaml = "cloudscheduler_v1beta1.yaml",
+    test_deps = [
+        ":scheduler_java_grpc",
+    ],
     deps = [
         ":scheduler_java_proto",
-        "scheduler_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
+java_gapic_test(
+    name = "scheduler_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.scheduler.v1beta1.CloudSchedulerClientTest",
+    ],
     runtime_deps = [":scheduler_java_gapic_test"],
-) for test_name in [
-    "com.google.cloud.scheduler.v1beta1.CloudSchedulerClientTest",
-]]
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-scheduler-v1beta1-java",
-    client_deps = [":scheduler_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":scheduler_java_gapic_test"],
-    grpc_deps = [":scheduler_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":scheduler_java_gapic",
+        ":scheduler_java_grpc",
         ":scheduler_java_proto",
         ":scheduler_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -104,10 +98,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -123,11 +117,13 @@ go_proto_library(
 
 go_gapic_library(
     name = "scheduler_go_gapic",
-    src = ":scheduler_proto_with_info",
-    gapic_yaml = "cloudscheduler_gapic.yaml",
-    importpath = "cloud.google.com/go/scheduler/apiv1beta1",
-    service_yaml = "//google/cloud/scheduler:cloudscheduler_v1beta1.yaml",
-    deps = [":scheduler_go_proto"],
+    srcs = [":scheduler_proto_with_info"],
+    grpc_service_config = "cloudscheduler_grpc_service_config.json",
+    importpath = "cloud.google.com/go/scheduler/apiv1beta1;scheduler",
+    service_yaml = "cloudscheduler_v1beta1.yaml",
+    deps = [
+        ":scheduler_go_proto",
+    ],
 )
 
 go_test(
@@ -137,13 +133,237 @@ go_test(
     importpath = "cloud.google.com/go/scheduler/apiv1beta1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-scheduler-v1beta1-go",
     deps = [
         ":scheduler_go_gapic",
-        ":scheduler_go_gapic_srcjar-smoke-test.srcjar",
         ":scheduler_go_gapic_srcjar-test.srcjar",
         ":scheduler_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "scheduler_moved_proto",
+    srcs = [":scheduler_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/rpc:status_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "scheduler_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":scheduler_moved_proto"],
+)
+
+py_grpc_library(
+    name = "scheduler_py_grpc",
+    srcs = [":scheduler_moved_proto"],
+    deps = [":scheduler_py_proto"],
+)
+
+py_gapic_library(
+    name = "scheduler_py_gapic",
+    src = ":scheduler_proto_with_info",
+    gapic_yaml = "cloudscheduler_gapic.yaml",
+    package = "google.cloud.scheduler.v1beta1",
+    service_yaml = "cloudscheduler_v1beta1.yaml",
+    deps = [
+        ":scheduler_py_grpc",
+        ":scheduler_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "scheduler-v1beta1-py",
+    deps = [
+        ":scheduler_py_gapic",
+        ":scheduler_py_grpc",
+        ":scheduler_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "scheduler_php_proto",
+    deps = [":scheduler_proto"],
+)
+
+php_grpc_library(
+    name = "scheduler_php_grpc",
+    srcs = [":scheduler_proto"],
+    deps = [":scheduler_php_proto"],
+)
+
+php_gapic_library(
+    name = "scheduler_php_gapic",
+    src = ":scheduler_proto_with_info",
+    gapic_yaml = "cloudscheduler_gapic.yaml",
+    package = "google.cloud.scheduler.v1beta1",
+    service_yaml = "cloudscheduler_v1beta1.yaml",
+    deps = [
+        ":scheduler_php_grpc",
+        ":scheduler_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-scheduler-v1beta1-php",
+    deps = [
+        ":scheduler_php_gapic",
+        ":scheduler_php_grpc",
+        ":scheduler_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "scheduler_nodejs_gapic",
+    src = ":scheduler_proto_with_info",
+    gapic_yaml = "cloudscheduler_gapic.yaml",
+    package = "google.cloud.scheduler.v1beta1",
+    service_yaml = "cloudscheduler_v1beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "scheduler-v1beta1-nodejs",
+    deps = [
+        ":scheduler_nodejs_gapic",
+        ":scheduler_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "scheduler_ruby_proto",
+    deps = [":scheduler_proto"],
+)
+
+ruby_grpc_library(
+    name = "scheduler_ruby_grpc",
+    srcs = [":scheduler_proto"],
+    deps = [":scheduler_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "scheduler_ruby_gapic",
+    src = ":scheduler_proto_with_info",
+    gapic_yaml = "cloudscheduler_gapic.yaml",
+    package = "google.cloud.scheduler.v1beta1",
+    service_yaml = "cloudscheduler_v1beta1.yaml",
+    deps = [
+        ":scheduler_ruby_grpc",
+        ":scheduler_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-scheduler-v1beta1-ruby",
+    deps = [
+        ":scheduler_ruby_gapic",
+        ":scheduler_ruby_grpc",
+        ":scheduler_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "scheduler_csharp_proto",
+    deps = [":scheduler_proto"],
+)
+
+csharp_grpc_library(
+    name = "scheduler_csharp_grpc",
+    srcs = [":scheduler_proto"],
+    deps = [":scheduler_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "scheduler_csharp_gapic",
+    src = ":scheduler_proto_with_info",
+    gapic_yaml = "cloudscheduler_gapic.yaml",
+    package = "google.cloud.scheduler.v1beta1",
+    service_yaml = "cloudscheduler_v1beta1.yaml",
+    deps = [
+        ":scheduler_csharp_grpc",
+        ":scheduler_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-scheduler-v1beta1-csharp",
+    deps = [
+        ":scheduler_csharp_gapic",
+        ":scheduler_csharp_grpc",
+        ":scheduler_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/scheduler/v1beta1/cloudscheduler.proto b/third_party/googleapis/google/cloud/scheduler/v1beta1/cloudscheduler.proto
index 4c1d96618..4f86b7a56 100644
--- a/third_party/googleapis/google/cloud/scheduler/v1beta1/cloudscheduler.proto
+++ b/third_party/googleapis/google/cloud/scheduler/v1beta1/cloudscheduler.proto
@@ -18,6 +18,8 @@ syntax = "proto3";
 package google.cloud.scheduler.v1beta1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/cloud/scheduler/v1beta1/job.proto";
 import "google/protobuf/empty.proto";
@@ -32,11 +34,15 @@ option objc_class_prefix = "SCHEDULER";
 // The Cloud Scheduler API allows external entities to reliably
 // schedule asynchronous jobs.
 service CloudScheduler {
+  option (google.api.default_host) = "cloudscheduler.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Lists jobs.
   rpc ListJobs(ListJobsRequest) returns (ListJobsResponse) {
     option (google.api.http) = {
       get: "/v1beta1/{parent=projects/*/locations/*}/jobs"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets a job.
@@ -44,6 +50,7 @@ service CloudScheduler {
     option (google.api.http) = {
       get: "/v1beta1/{name=projects/*/locations/*/jobs/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates a job.
@@ -52,6 +59,7 @@ service CloudScheduler {
       post: "/v1beta1/{parent=projects/*/locations/*}/jobs"
       body: "job"
     };
+    option (google.api.method_signature) = "parent,job";
   }
 
   // Updates a job.
@@ -68,6 +76,7 @@ service CloudScheduler {
       patch: "/v1beta1/{job.name=projects/*/locations/*/jobs/*}"
       body: "job"
     };
+    option (google.api.method_signature) = "job,update_mask";
   }
 
   // Deletes a job.
@@ -75,6 +84,7 @@ service CloudScheduler {
     option (google.api.http) = {
       delete: "/v1beta1/{name=projects/*/locations/*/jobs/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Pauses a job.
@@ -89,6 +99,7 @@ service CloudScheduler {
       post: "/v1beta1/{name=projects/*/locations/*/jobs/*}:pause"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Resume a job.
@@ -102,6 +113,7 @@ service CloudScheduler {
       post: "/v1beta1/{name=projects/*/locations/*/jobs/*}:resume"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Forces a job to run now.
@@ -113,16 +125,20 @@ service CloudScheduler {
       post: "/v1beta1/{name=projects/*/locations/*/jobs/*}:run"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 }
 
 // Request message for listing jobs using [ListJobs][google.cloud.scheduler.v1beta1.CloudScheduler.ListJobs].
 message ListJobsRequest {
-  // Required.
-  //
-  // The location name. For example:
+  // Required. The location name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "cloudscheduler.googleapis.com/Job"
+    }
+  ];
 
   // Requested page size.
   //
@@ -159,40 +175,42 @@ message ListJobsResponse {
 
 // Request message for [GetJob][google.cloud.scheduler.v1beta1.CloudScheduler.GetJob].
 message GetJobRequest {
-  // Required.
-  //
-  // The job name. For example:
+  // Required. The job name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudscheduler.googleapis.com/Job"
+    }
+  ];
 }
 
 // Request message for [CreateJob][google.cloud.scheduler.v1beta1.CloudScheduler.CreateJob].
 message CreateJobRequest {
-  // Required.
-  //
-  // The location name. For example:
+  // Required. The location name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "cloudscheduler.googleapis.com/Job"
+    }
+  ];
 
-  // Required.
-  //
-  // The job to add. The user can optionally specify a name for the
+  // Required. The job to add. The user can optionally specify a name for the
   // job in [name][google.cloud.scheduler.v1beta1.Job.name]. [name][google.cloud.scheduler.v1beta1.Job.name] cannot be the same as an
   // existing job. If a name is not specified then the system will
   // generate a random unique name that will be returned
   // ([name][google.cloud.scheduler.v1beta1.Job.name]) in the response.
-  Job job = 2;
+  Job job = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request message for [UpdateJob][google.cloud.scheduler.v1beta1.CloudScheduler.UpdateJob].
 message UpdateJobRequest {
-  // Required.
-  //
-  // The new job properties. [name][google.cloud.scheduler.v1beta1.Job.name] must be specified.
+  // Required. The new job properties. [name][google.cloud.scheduler.v1beta1.Job.name] must be specified.
   //
   // Output only fields cannot be modified using UpdateJob.
   // Any value specified for an output only field will be ignored.
-  Job job = 1;
+  Job job = 1 [(google.api.field_behavior) = REQUIRED];
 
   // A  mask used to specify which fields of the job are being updated.
   google.protobuf.FieldMask update_mask = 2;
@@ -201,37 +219,49 @@ message UpdateJobRequest {
 // Request message for deleting a job using
 // [DeleteJob][google.cloud.scheduler.v1beta1.CloudScheduler.DeleteJob].
 message DeleteJobRequest {
-  // Required.
-  //
-  // The job name. For example:
+  // Required. The job name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudscheduler.googleapis.com/Job"
+    }
+  ];
 }
 
 // Request message for [PauseJob][google.cloud.scheduler.v1beta1.CloudScheduler.PauseJob].
 message PauseJobRequest {
-  // Required.
-  //
-  // The job name. For example:
+  // Required. The job name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudscheduler.googleapis.com/Job"
+    }
+  ];
 }
 
 // Request message for [ResumeJob][google.cloud.scheduler.v1beta1.CloudScheduler.ResumeJob].
 message ResumeJobRequest {
-  // Required.
-  //
-  // The job name. For example:
+  // Required. The job name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudscheduler.googleapis.com/Job"
+    }
+  ];
 }
 
 // Request message for forcing a job to run now using
 // [RunJob][google.cloud.scheduler.v1beta1.CloudScheduler.RunJob].
 message RunJobRequest {
-  // Required.
-  //
-  // The job name. For example:
+  // Required. The job name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudscheduler.googleapis.com/Job"
+    }
+  ];
 }
diff --git a/third_party/googleapis/google/cloud/scheduler/v1beta1/cloudscheduler_gapic.legacy.yaml b/third_party/googleapis/google/cloud/scheduler/v1beta1/cloudscheduler_gapic.legacy.yaml
new file mode 100644
index 000000000..07d2fa0f3
--- /dev/null
+++ b/third_party/googleapis/google/cloud/scheduler/v1beta1/cloudscheduler_gapic.legacy.yaml
@@ -0,0 +1,257 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.scheduler.v1beta1
+  python:
+    package_name: google.cloud.scheduler_v1beta1.gapic
+  go:
+    package_name: cloud.google.com/go/scheduler/apiv1beta1
+  csharp:
+    package_name: Google.Cloud.Scheduler.V1Beta1
+  ruby:
+    package_name: Google::Cloud::Scheduler::V1beta1
+  php:
+    package_name: Google\Cloud\Scheduler\V1beta1
+  nodejs:
+    package_name: scheduler.v1beta1
+    domain_layer_location: google-cloud
+# A list of API interface configurations.
+interfaces:
+- name: google.cloud.scheduler.v1beta1.CloudScheduler
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}
+    entity_name: project
+    language_overrides:
+    - language: csharp
+      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
+  - name_pattern: projects/{project}/locations/{location}
+    entity_name: location
+  - name_pattern: projects/{project}/locations/{location}/jobs/{job}
+    entity_name: job
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ListJobs
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: jobs
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 10000
+  - name: GetJob
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: job
+    timeout_millis: 10000
+  - name: CreateJob
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - job
+    required_fields:
+    - parent
+    - job
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 10000
+  - name: UpdateJob
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - job
+        - update_mask
+    required_fields:
+    - job
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      job.name: job
+    timeout_millis: 10000
+  - name: DeleteJob
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: job
+    timeout_millis: 10000
+  - name: PauseJob
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: job
+    timeout_millis: 10000
+  - name: ResumeJob
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: job
+    timeout_millis: 10000
+  - name: RunJob
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: job
+    timeout_millis: 10000
+resource_name_generation:
+- message_name: Job
+  field_entity_map:
+    name: job
+- message_name: ListJobsRequest
+  field_entity_map:
+    parent: location
+- message_name: GetJobRequest
+  field_entity_map:
+    name: job
+- message_name: CreateJobRequest
+  field_entity_map:
+    parent: location
+- message_name: UpdateJobRequest
+  field_entity_map:
+    job.name: job
+- message_name: DeleteJobRequest
+  field_entity_map:
+    name: job
+- message_name: PauseJobRequest
+  field_entity_map:
+    name: job
+- message_name: ResumeJobRequest
+  field_entity_map:
+    name: job
+- message_name: RunJobRequest
+  field_entity_map:
+    name: job
diff --git a/third_party/googleapis/google/cloud/scheduler/v1beta1/cloudscheduler_gapic.yaml b/third_party/googleapis/google/cloud/scheduler/v1beta1/cloudscheduler_gapic.yaml
index abc706b61..c2d196bb6 100644
--- a/third_party/googleapis/google/cloud/scheduler/v1beta1/cloudscheduler_gapic.yaml
+++ b/third_party/googleapis/google/cloud/scheduler/v1beta1/cloudscheduler_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -17,242 +17,12 @@ language_settings:
   nodejs:
     package_name: scheduler.v1beta1
     domain_layer_location: google-cloud
-# A list of API interface configurations.
 interfaces:
-  # The fully qualified name of the API interface.
 - name: google.cloud.scheduler.v1beta1.CloudScheduler
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections:
-  - name_pattern: projects/{project}
-    entity_name: project
-    language_overrides:
-    - language: csharp
-      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
-  - name_pattern: projects/{project}/locations/{location}
-    entity_name: location
-  - name_pattern: projects/{project}/locations/{location}/jobs/{job}
-    entity_name: job
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
   methods:
-  - name: ListJobs
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: jobs
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    timeout_millis: 10000
-  - name: GetJob
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: job
-    timeout_millis: 10000
-  - name: CreateJob
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - job
-    required_fields:
-    - parent
-    - job
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    timeout_millis: 10000
-  - name: UpdateJob
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - job
-        - update_mask
-    required_fields:
-    - job
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      job.name: job
-    timeout_millis: 10000
   - name: DeleteJob
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: job
-    timeout_millis: 10000
   - name: PauseJob
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: job
-    timeout_millis: 10000
   - name: ResumeJob
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: job
-    timeout_millis: 10000
-  - name: RunJob
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: job
-    timeout_millis: 10000
-resource_name_generation:
-- message_name: Job
-  field_entity_map:
-    name: job
-- message_name: ListJobsRequest
-  field_entity_map:
-    parent: location
-- message_name: GetJobRequest
-  field_entity_map:
-    name: job
-- message_name: CreateJobRequest
-  field_entity_map:
-    parent: location
-- message_name: UpdateJobRequest
-  field_entity_map:
-    job.name: job
-- message_name: DeleteJobRequest
-  field_entity_map:
-    name: job
-- message_name: PauseJobRequest
-  field_entity_map:
-    name: job
-- message_name: ResumeJobRequest
-  field_entity_map:
-    name: job
-- message_name: RunJobRequest
-  field_entity_map:
-    name: job
diff --git a/third_party/googleapis/google/cloud/scheduler/v1beta1/cloudscheduler_grpc_service_config.json b/third_party/googleapis/google/cloud/scheduler/v1beta1/cloudscheduler_grpc_service_config.json
new file mode 100755
index 000000000..547377650
--- /dev/null
+++ b/third_party/googleapis/google/cloud/scheduler/v1beta1/cloudscheduler_grpc_service_config.json
@@ -0,0 +1,55 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.scheduler.v1beta1.CloudScheduler",
+          "method": "ListJobs"
+        },
+        {
+          "service": "google.cloud.scheduler.v1beta1.CloudScheduler",
+          "method": "GetJob"
+        },
+        {
+          "service": "google.cloud.scheduler.v1beta1.CloudScheduler",
+          "method": "DeleteJob"
+        },
+        {
+          "service": "google.cloud.scheduler.v1beta1.CloudScheduler",
+          "method": "PauseJob"
+        },
+        {
+          "service": "google.cloud.scheduler.v1beta1.CloudScheduler",
+          "method": "ResumeJob"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.scheduler.v1beta1.CloudScheduler",
+          "method": "CreateJob"
+        },
+        {
+          "service": "google.cloud.scheduler.v1beta1.CloudScheduler",
+          "method": "UpdateJob"
+        },
+        {
+          "service": "google.cloud.scheduler.v1beta1.CloudScheduler",
+          "method": "RunJob"
+        }
+      ],
+      "timeout": "600s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/scheduler/cloudscheduler_v1beta1.yaml b/third_party/googleapis/google/cloud/scheduler/v1beta1/cloudscheduler_v1beta1.yaml
similarity index 100%
rename from third_party/googleapis/google/cloud/scheduler/cloudscheduler_v1beta1.yaml
rename to third_party/googleapis/google/cloud/scheduler/v1beta1/cloudscheduler_v1beta1.yaml
diff --git a/third_party/googleapis/google/cloud/scheduler/v1beta1/job.proto b/third_party/googleapis/google/cloud/scheduler/v1beta1/job.proto
index ddf910b03..ddfda31ed 100644
--- a/third_party/googleapis/google/cloud/scheduler/v1beta1/job.proto
+++ b/third_party/googleapis/google/cloud/scheduler/v1beta1/job.proto
@@ -17,12 +17,12 @@ syntax = "proto3";
 
 package google.cloud.scheduler.v1beta1;
 
-import "google/api/annotations.proto";
 import "google/api/resource.proto";
 import "google/cloud/scheduler/v1beta1/target.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
 import "google/rpc/status.proto";
+import "google/api/annotations.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/scheduler/v1beta1;scheduler";
 option java_multiple_files = true;
@@ -32,6 +32,11 @@ option java_package = "com.google.cloud.scheduler.v1beta1";
 // Configuration for a job.
 // The maximum allowed size for a job is 100KB.
 message Job {
+  option (google.api.resource) = {
+    type: "cloudscheduler.googleapis.com/Job"
+    pattern: "projects/{project}/locations/{location}/jobs/{job}"
+  };
+
   // State of the job.
   enum State {
     // Unspecified state.
diff --git a/third_party/googleapis/google/cloud/scheduler/v1beta1/target.proto b/third_party/googleapis/google/cloud/scheduler/v1beta1/target.proto
index 3bb44a1fb..4b47e3567 100644
--- a/third_party/googleapis/google/cloud/scheduler/v1beta1/target.proto
+++ b/third_party/googleapis/google/cloud/scheduler/v1beta1/target.proto
@@ -17,8 +17,8 @@ syntax = "proto3";
 
 package google.cloud.scheduler.v1beta1;
 
+import "google/api/resource.proto";
 import "google/api/annotations.proto";
-import "google/protobuf/any.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/scheduler/v1beta1;scheduler";
 option java_multiple_files = true;
@@ -32,9 +32,7 @@ option java_package = "com.google.cloud.scheduler.v1beta1";
 // constitutes a failed execution. For a redirected request, the response
 // returned by the redirected request is considered.
 message HttpTarget {
-  // Required.
-  //
-  // The full URI path that the request will be sent to. This string
+  // Required. The full URI path that the request will be sent to. This string
   // must begin with either "http://" or "https://". Some examples of
   // valid values for [uri][google.cloud.scheduler.v1beta1.HttpTarget.uri] are:
   // `http://acme.com` and `https://acme.com/sales:8080`. Cloud Scheduler will
@@ -77,8 +75,8 @@ message HttpTarget {
     // will be generated and attached as an `Authorization` header in the HTTP
     // request.
     //
-    // This type of authorization should be used when sending requests to a GCP
-    // endpoint.
+    // This type of authorization should generally only be used when calling
+    // Google APIs hosted on *.googleapis.com.
     OAuthToken oauth_token = 5;
 
     // If specified, an
@@ -86,8 +84,9 @@ message HttpTarget {
     // token will be generated and attached as an `Authorization` header in the
     // HTTP request.
     //
-    // This type of authorization should be used when sending requests to third
-    // party endpoints.
+    // This type of authorization can be used for many scenarios, including
+    // calling Cloud Run, or endpoints where you intend to validate the token
+    // yourself.
     OidcToken oidc_token = 6;
   }
 }
@@ -162,16 +161,16 @@ message AppEngineHttpTarget {
 // Pub/Sub target. The job will be delivered by publishing a message to
 // the given Pub/Sub topic.
 message PubsubTarget {
-  // Required.
-  //
-  // The name of the Cloud Pub/Sub topic to which messages will
+  // Required. The name of the Cloud Pub/Sub topic to which messages will
   // be published when a job is delivered. The topic name must be in the
   // same format as required by PubSub's
   // [PublishRequest.name](https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#publishrequest),
   // for example `projects/PROJECT_ID/topics/TOPIC_ID`.
   //
   // The topic must be in the same project as the Cloud Scheduler job.
-  string topic_name = 1;
+  string topic_name = 1 [(google.api.resource_reference) = {
+                           type: "pubsub.googleapis.com/Topic"
+                         }];
 
   // The message payload for PubsubMessage.
   //
@@ -315,8 +314,8 @@ enum HttpMethod {
 
 // Contains information needed for generating an
 // [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
-// This type of authorization should be used when sending requests to a GCP
-// endpoint.
+// This type of authorization should generally only be used when calling Google
+// APIs hosted on *.googleapis.com.
 message OAuthToken {
   // [Service account email](https://cloud.google.com/iam/docs/service-accounts)
   // to be used for generating OAuth token.
@@ -332,9 +331,10 @@ message OAuthToken {
 
 // Contains information needed for generating an
 // [OpenID Connect
-// token](https://developers.google.com/identity/protocols/OpenIDConnect). This
-// type of authorization should be used when sending requests to third party
-// endpoints.
+// token](https://developers.google.com/identity/protocols/OpenIDConnect).
+// This type of authorization can be used for many scenarios, including
+// calling Cloud Run, or endpoints where you intend to validate the token
+// yourself.
 message OidcToken {
   // [Service account email](https://cloud.google.com/iam/docs/service-accounts)
   // to be used for generating OIDC token.
@@ -346,3 +346,11 @@ message OidcToken {
   // specified in target will be used.
   string audience = 2;
 }
+
+// The Pub/Sub Topic resource definition is in google/cloud/pubsub/v1/,
+// but we do not import that proto directly; therefore, we redefine the
+// pattern here.
+option (google.api.resource_definition) = {
+  type: "pubsub.googleapis.com/Topic"
+  pattern: "projects/{project}/topics/{topic}"
+};
diff --git a/third_party/googleapis/google/cloud/secretmanager/v1/BUILD.bazel b/third_party/googleapis/google/cloud/secretmanager/v1/BUILD.bazel
new file mode 100644
index 000000000..9fbe04c97
--- /dev/null
+++ b/third_party/googleapis/google/cloud/secretmanager/v1/BUILD.bazel
@@ -0,0 +1,371 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "secretmanager_proto",
+    srcs = [
+        "resources.proto",
+        "service.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/iam/v1:iam_policy_proto",
+        "//google/iam/v1:policy_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "secretmanager_proto_with_info",
+    deps = [
+        ":secretmanager_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "secretmanager_java_proto",
+    deps = [":secretmanager_proto"],
+)
+
+java_grpc_library(
+    name = "secretmanager_java_grpc",
+    srcs = [":secretmanager_proto"],
+    deps = [":secretmanager_java_proto"],
+)
+
+java_gapic_library(
+    name = "secretmanager_java_gapic",
+    src = ":secretmanager_proto_with_info",
+    gapic_yaml = "secretmanager_gapic.yaml",
+    package = "google.cloud.secretmanager.v1",
+    service_yaml = "secretmanager_v1.yaml",
+    test_deps = [
+        ":secretmanager_java_grpc",
+        "//google/iam/v1:iam_java_grpc",
+    ],
+    deps = [
+        ":secretmanager_java_proto",
+        "//google/iam/v1:iam_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "secretmanager_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.secretmanager.v1.SecretManagerServiceClientTest",
+    ],
+    runtime_deps = [":secretmanager_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-secretmanager-v1-java",
+    deps = [
+        ":secretmanager_java_gapic",
+        ":secretmanager_java_grpc",
+        ":secretmanager_java_proto",
+        ":secretmanager_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "secretmanager_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/secretmanager/v1",
+    protos = [":secretmanager_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/iam/v1:iam_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "secretmanager_go_gapic",
+    srcs = [":secretmanager_proto_with_info"],
+    grpc_service_config = "secretmanager_grpc_service_config.json",
+    importpath = "cloud.google.com/go/secretmanager/apiv1;secretmanager",
+    service_yaml = "secretmanager_v1.yaml",
+    deps = [
+        ":secretmanager_go_proto",
+        "//google/iam/v1:iam_go_proto",
+    ],
+)
+
+go_test(
+    name = "secretmanager_go_gapic_test",
+    srcs = [":secretmanager_go_gapic_srcjar_test"],
+    embed = [":secretmanager_go_gapic"],
+    importpath = "cloud.google.com/go/secretmanager/apiv1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-secretmanager-v1-go",
+    deps = [
+        ":secretmanager_go_gapic",
+        ":secretmanager_go_gapic_srcjar-test.srcjar",
+        ":secretmanager_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "secretmanager_moved_proto",
+    srcs = [":secretmanager_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/iam/v1:iam_policy_proto",
+        "//google/iam/v1:policy_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "secretmanager_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":secretmanager_moved_proto"],
+)
+
+py_grpc_library(
+    name = "secretmanager_py_grpc",
+    srcs = [":secretmanager_moved_proto"],
+    deps = [":secretmanager_py_proto"],
+)
+
+py_gapic_library(
+    name = "secretmanager_py_gapic",
+    src = ":secretmanager_proto_with_info",
+    gapic_yaml = "secretmanager_gapic.yaml",
+    package = "google.cloud.secretmanager.v1",
+    service_yaml = "secretmanager_v1.yaml",
+    deps = [
+        ":secretmanager_py_grpc",
+        ":secretmanager_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "secretmanager-v1-py",
+    deps = [
+        ":secretmanager_py_gapic",
+        ":secretmanager_py_grpc",
+        ":secretmanager_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "secretmanager_php_proto",
+    deps = [":secretmanager_proto"],
+)
+
+php_grpc_library(
+    name = "secretmanager_php_grpc",
+    srcs = [":secretmanager_proto"],
+    deps = [":secretmanager_php_proto"],
+)
+
+php_gapic_library(
+    name = "secretmanager_php_gapic",
+    src = ":secretmanager_proto_with_info",
+    gapic_yaml = "secretmanager_gapic.yaml",
+    package = "google.cloud.secretmanager.v1",
+    service_yaml = "secretmanager_v1.yaml",
+    deps = [
+        ":secretmanager_php_grpc",
+        ":secretmanager_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-secretmanager-v1-php",
+    deps = [
+        ":secretmanager_php_gapic",
+        ":secretmanager_php_grpc",
+        ":secretmanager_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "secretmanager_nodejs_gapic",
+    src = ":secretmanager_proto_with_info",
+    gapic_yaml = "secretmanager_gapic.yaml",
+    package = "google.cloud.secretmanager.v1",
+    service_yaml = "secretmanager_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "secretmanager-v1-nodejs",
+    deps = [
+        ":secretmanager_nodejs_gapic",
+        ":secretmanager_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "secretmanager_ruby_proto",
+    deps = [":secretmanager_proto"],
+)
+
+ruby_grpc_library(
+    name = "secretmanager_ruby_grpc",
+    srcs = [":secretmanager_proto"],
+    deps = [":secretmanager_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "secretmanager_ruby_gapic",
+    src = ":secretmanager_proto_with_info",
+    gapic_yaml = "secretmanager_gapic.yaml",
+    package = "google.cloud.secretmanager.v1",
+    service_yaml = "secretmanager_v1.yaml",
+    deps = [
+        ":secretmanager_ruby_grpc",
+        ":secretmanager_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-secretmanager-v1-ruby",
+    deps = [
+        ":secretmanager_ruby_gapic",
+        ":secretmanager_ruby_grpc",
+        ":secretmanager_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "secretmanager_csharp_proto",
+    deps = [":secretmanager_proto"],
+)
+
+csharp_grpc_library(
+    name = "secretmanager_csharp_grpc",
+    srcs = [":secretmanager_proto"],
+    deps = [":secretmanager_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "secretmanager_csharp_gapic",
+    src = ":secretmanager_proto_with_info",
+    gapic_yaml = "secretmanager_gapic.yaml",
+    package = "google.cloud.secretmanager.v1",
+    service_yaml = "secretmanager_v1.yaml",
+    deps = [
+        ":secretmanager_csharp_grpc",
+        ":secretmanager_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-secretmanager-v1-csharp",
+    deps = [
+        ":secretmanager_csharp_gapic",
+        ":secretmanager_csharp_grpc",
+        ":secretmanager_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/secretmanager/v1/resources.proto b/third_party/googleapis/google/cloud/secretmanager/v1/resources.proto
new file mode 100644
index 000000000..d4bf4b7e6
--- /dev/null
+++ b/third_party/googleapis/google/cloud/secretmanager/v1/resources.proto
@@ -0,0 +1,157 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.secretmanager.v1;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.SecretManager.V1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/secretmanager/v1;secretmanager";
+option java_multiple_files = true;
+option java_outer_classname = "ResourcesProto";
+option java_package = "com.google.cloud.secretmanager.v1";
+option objc_class_prefix = "GSM";
+option php_namespace = "Google\\Cloud\\SecretManager\\V1";
+option ruby_package = "Google::Cloud::SecretManager::V1";
+
+// A [Secret][google.cloud.secretmanager.v1.Secret] is a logical secret whose value and versions can
+// be accessed.
+//
+// A [Secret][google.cloud.secretmanager.v1.Secret] is made up of zero or more [SecretVersions][google.cloud.secretmanager.v1.SecretVersion] that
+// represent the secret data.
+message Secret {
+  option (google.api.resource) = {
+    type: "secretmanager.googleapis.com/Secret"
+    pattern: "projects/{project}/secrets/{secret}"
+  };
+
+  // Output only. The resource name of the [Secret][google.cloud.secretmanager.v1.Secret] in the format `projects/*/secrets/*`.
+  string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Required. Immutable. The replication policy of the secret data attached to the [Secret][google.cloud.secretmanager.v1.Secret].
+  //
+  // The replication policy cannot be changed after the Secret has been created.
+  Replication replication = 2 [
+    (google.api.field_behavior) = IMMUTABLE,
+    (google.api.field_behavior) = REQUIRED
+  ];
+
+  // Output only. The time at which the [Secret][google.cloud.secretmanager.v1.Secret] was created.
+  google.protobuf.Timestamp create_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // The labels assigned to this Secret.
+  //
+  // Label keys must be between 1 and 63 characters long, have a UTF-8 encoding
+  // of maximum 128 bytes, and must conform to the following PCRE regular
+  // expression: `[\p{Ll}\p{Lo}][\p{Ll}\p{Lo}\p{N}_-]{0,62}`
+  //
+  // Label values must be between 0 and 63 characters long, have a UTF-8
+  // encoding of maximum 128 bytes, and must conform to the following PCRE
+  // regular expression: `[\p{Ll}\p{Lo}\p{N}_-]{0,63}`
+  //
+  // No more than 64 labels can be assigned to a given resource.
+  map labels = 4;
+}
+
+// A secret version resource in the Secret Manager API.
+message SecretVersion {
+  option (google.api.resource) = {
+    type: "secretmanager.googleapis.com/SecretVersion"
+    pattern: "projects/{project}/secrets/{secret}/versions/{secret_version}"
+  };
+
+  // The state of a [SecretVersion][google.cloud.secretmanager.v1.SecretVersion], indicating if it can be accessed.
+  enum State {
+    // Not specified. This value is unused and invalid.
+    STATE_UNSPECIFIED = 0;
+
+    // The [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] may be accessed.
+    ENABLED = 1;
+
+    // The [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] may not be accessed, but the secret data
+    // is still available and can be placed back into the [ENABLED][google.cloud.secretmanager.v1.SecretVersion.State.ENABLED]
+    // state.
+    DISABLED = 2;
+
+    // The [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] is destroyed and the secret data is no longer
+    // stored. A version may not leave this state once entered.
+    DESTROYED = 3;
+  }
+
+  // Output only. The resource name of the [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] in the
+  // format `projects/*/secrets/*/versions/*`.
+  //
+  // [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] IDs in a [Secret][google.cloud.secretmanager.v1.Secret] start at 1 and
+  // are incremented for each subsequent version of the secret.
+  string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The time at which the [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] was created.
+  google.protobuf.Timestamp create_time = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The time this [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] was destroyed.
+  // Only present if [state][google.cloud.secretmanager.v1.SecretVersion.state] is
+  // [DESTROYED][google.cloud.secretmanager.v1.SecretVersion.State.DESTROYED].
+  google.protobuf.Timestamp destroy_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The current state of the [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
+  State state = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// A policy that defines the replication configuration of data.
+//
+message Replication {
+  // A replication policy that replicates the [Secret][google.cloud.secretmanager.v1.Secret] payload without any
+  // restrictions.
+  message Automatic {
+
+  }
+
+  // A replication policy that replicates the [Secret][google.cloud.secretmanager.v1.Secret] payload into the
+  // locations specified in [Secret.replication.user_managed.replicas][]
+  message UserManaged {
+    // Represents a Replica for this [Secret][google.cloud.secretmanager.v1.Secret].
+    message Replica {
+      // The canonical IDs of the location to replicate data.
+      // For example: `"us-east1"`.
+      string location = 1;
+    }
+
+    // Required. The list of Replicas for this [Secret][google.cloud.secretmanager.v1.Secret].
+    //
+    // Cannot be empty.
+    repeated Replica replicas = 1 [(google.api.field_behavior) = REQUIRED];
+  }
+
+  // The replication policy for this secret.
+  oneof replication {
+    // The [Secret][google.cloud.secretmanager.v1.Secret] will automatically be replicated without any restrictions.
+    Automatic automatic = 1;
+
+    // The [Secret][google.cloud.secretmanager.v1.Secret] will only be replicated into the locations specified.
+    UserManaged user_managed = 2;
+  }
+}
+
+// A secret payload resource in the Secret Manager API. This contains the
+// sensitive secret payload that is associated with a [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
+message SecretPayload {
+  // The secret data. Must be no larger than 64KiB.
+  bytes data = 1;
+}
diff --git a/third_party/googleapis/google/cloud/secretmanager/v1/secretmanager_gapic.yaml b/third_party/googleapis/google/cloud/secretmanager/v1/secretmanager_gapic.yaml
new file mode 100644
index 000000000..1e4b0785e
--- /dev/null
+++ b/third_party/googleapis/google/cloud/secretmanager/v1/secretmanager_gapic.yaml
@@ -0,0 +1,19 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 2.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.secretmanager.v1
+  python:
+    package_name: google.cloud.secretmanager_v1.gapic
+  go:
+    package_name: cloud.google.com/go/secretmanager/apiv1
+  csharp:
+    package_name: Google.Cloud.SecretManager.V1
+  ruby:
+    package_name: Google::Cloud::SecretManager::V1
+  php:
+    package_name: Google\Cloud\SecretManager\V1
+  nodejs:
+    package_name: secretmanager.v1
+    domain_layer_location: google-cloud
diff --git a/third_party/googleapis/google/cloud/secretmanager/v1/secretmanager_grpc_service_config.json b/third_party/googleapis/google/cloud/secretmanager/v1/secretmanager_grpc_service_config.json
new file mode 100644
index 000000000..5574d48fa
--- /dev/null
+++ b/third_party/googleapis/google/cloud/secretmanager/v1/secretmanager_grpc_service_config.json
@@ -0,0 +1,83 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.secretmanager.v1.SecretManagerService",
+          "method": "ListSecrets"
+        },
+        {
+          "service": "google.cloud.secretmanager.v1.SecretManagerService",
+          "method": "CreateSecret"
+        },
+        {
+          "service": "google.cloud.secretmanager.v1.SecretManagerService",
+          "method": "AddSecretVersion"
+        },
+        {
+          "service": "google.cloud.secretmanager.v1.SecretManagerService",
+          "method": "GetSecret"
+        },
+        {
+          "service": "google.cloud.secretmanager.v1.SecretManagerService",
+          "method": "UpdateSecret"
+        },
+        {
+          "service": "google.cloud.secretmanager.v1.SecretManagerService",
+          "method": "DeleteSecret"
+        },
+        {
+          "service": "google.cloud.secretmanager.v1.SecretManagerService",
+          "method": "ListSecretVersions"
+        },
+        {
+          "service": "google.cloud.secretmanager.v1.SecretManagerService",
+          "method": "GetSecretVersion"
+        },
+        {
+          "service": "google.cloud.secretmanager.v1.SecretManagerService",
+          "method": "DisableSecretVersion"
+        },
+        {
+          "service": "google.cloud.secretmanager.v1.SecretManagerService",
+          "method": "EnableSecretVersion"
+        },
+        {
+          "service": "google.cloud.secretmanager.v1.SecretManagerService",
+          "method": "DestroySecretVersion"
+        },
+        {
+          "service": "google.cloud.secretmanager.v1.SecretManagerService",
+          "method": "SetIamPolicy"
+        },
+        {
+          "service": "google.cloud.secretmanager.v1.SecretManagerService",
+          "method": "GetIamPolicy"
+        },
+        {
+          "service": "google.cloud.secretmanager.v1.SecretManagerService",
+          "method": "TestIamPermissions"
+        }
+      ],
+      "timeout": "60s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.secretmanager.v1.SecretManagerService",
+          "method": "AccessSecretVersion"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "initialBackoff": "1s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "UNKNOWN"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/secretmanager/v1/secretmanager_v1.yaml b/third_party/googleapis/google/cloud/secretmanager/v1/secretmanager_v1.yaml
new file mode 100644
index 000000000..b2f76829e
--- /dev/null
+++ b/third_party/googleapis/google/cloud/secretmanager/v1/secretmanager_v1.yaml
@@ -0,0 +1,25 @@
+type: google.api.Service
+config_version: 3
+name: secretmanager.googleapis.com
+title: Secret Manager API
+
+apis:
+- name: google.cloud.secretmanager.v1.SecretManagerService
+
+documentation:
+  summary: |-
+    Stores sensitive data such as API keys, passwords, and certificates.
+    Provides convenience while improving security.
+  overview: Secret Manager Overview
+
+backend:
+  rules:
+  - selector: 'google.cloud.secretmanager.v1.SecretManagerService.*'
+    deadline: 10.0
+
+authentication:
+  rules:
+  - selector: 'google.cloud.secretmanager.v1.SecretManagerService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/secretmanager/v1/service.proto b/third_party/googleapis/google/cloud/secretmanager/v1/service.proto
new file mode 100644
index 000000000..4bf5c6b69
--- /dev/null
+++ b/third_party/googleapis/google/cloud/secretmanager/v1/service.proto
@@ -0,0 +1,420 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.secretmanager.v1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/secretmanager/v1/resources.proto";
+import "google/iam/v1/iam_policy.proto";
+import "google/iam/v1/policy.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.SecretManager.V1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/secretmanager/v1;secretmanager";
+option java_multiple_files = true;
+option java_outer_classname = "ServiceProto";
+option java_package = "com.google.cloud.secretmanager.v1";
+option objc_class_prefix = "GSM";
+option php_namespace = "Google\\Cloud\\SecretManager\\V1";
+option ruby_package = "Google::Cloud::SecretManager::V1";
+
+// `projects/*/secrets/*/versions/latest` is an alias to the `latest`
+// [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
+
+// Secret Manager Service
+//
+// Manages secrets and operations using those secrets. Implements a REST
+// model with the following objects:
+//
+// * [Secret][google.cloud.secretmanager.v1.Secret]
+// * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion]
+service SecretManagerService {
+  option (google.api.default_host) = "secretmanager.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // Lists [Secrets][google.cloud.secretmanager.v1.Secret].
+  rpc ListSecrets(ListSecretsRequest) returns (ListSecretsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*}/secrets"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Creates a new [Secret][google.cloud.secretmanager.v1.Secret] containing no [SecretVersions][google.cloud.secretmanager.v1.SecretVersion].
+  rpc CreateSecret(CreateSecretRequest) returns (Secret) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*}/secrets"
+      body: "secret"
+    };
+    option (google.api.method_signature) = "parent,secret_id,secret";
+  }
+
+  // Creates a new [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] containing secret data and attaches
+  // it to an existing [Secret][google.cloud.secretmanager.v1.Secret].
+  rpc AddSecretVersion(AddSecretVersionRequest) returns (SecretVersion) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/secrets/*}:addVersion"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent,payload";
+  }
+
+  // Gets metadata for a given [Secret][google.cloud.secretmanager.v1.Secret].
+  rpc GetSecret(GetSecretRequest) returns (Secret) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/secrets/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Updates metadata of an existing [Secret][google.cloud.secretmanager.v1.Secret].
+  rpc UpdateSecret(UpdateSecretRequest) returns (Secret) {
+    option (google.api.http) = {
+      patch: "/v1/{secret.name=projects/*/secrets/*}"
+      body: "secret"
+    };
+    option (google.api.method_signature) = "secret,update_mask";
+  }
+
+  // Deletes a [Secret][google.cloud.secretmanager.v1.Secret].
+  rpc DeleteSecret(DeleteSecretRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/secrets/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Lists [SecretVersions][google.cloud.secretmanager.v1.SecretVersion]. This call does not return secret
+  // data.
+  rpc ListSecretVersions(ListSecretVersionsRequest) returns (ListSecretVersionsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/secrets/*}/versions"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Gets metadata for a [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
+  //
+  // `projects/*/secrets/*/versions/latest` is an alias to the `latest`
+  // [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
+  rpc GetSecretVersion(GetSecretVersionRequest) returns (SecretVersion) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/secrets/*/versions/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Accesses a [SecretVersion][google.cloud.secretmanager.v1.SecretVersion]. This call returns the secret data.
+  //
+  // `projects/*/secrets/*/versions/latest` is an alias to the `latest`
+  // [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
+  rpc AccessSecretVersion(AccessSecretVersionRequest) returns (AccessSecretVersionResponse) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/secrets/*/versions/*}:access"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Disables a [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
+  //
+  // Sets the [state][google.cloud.secretmanager.v1.SecretVersion.state] of the [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to
+  // [DISABLED][google.cloud.secretmanager.v1.SecretVersion.State.DISABLED].
+  rpc DisableSecretVersion(DisableSecretVersionRequest) returns (SecretVersion) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/secrets/*/versions/*}:disable"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Enables a [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
+  //
+  // Sets the [state][google.cloud.secretmanager.v1.SecretVersion.state] of the [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to
+  // [ENABLED][google.cloud.secretmanager.v1.SecretVersion.State.ENABLED].
+  rpc EnableSecretVersion(EnableSecretVersionRequest) returns (SecretVersion) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/secrets/*/versions/*}:enable"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Destroys a [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
+  //
+  // Sets the [state][google.cloud.secretmanager.v1.SecretVersion.state] of the [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to
+  // [DESTROYED][google.cloud.secretmanager.v1.SecretVersion.State.DESTROYED] and irrevocably destroys the
+  // secret data.
+  rpc DestroySecretVersion(DestroySecretVersionRequest) returns (SecretVersion) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/secrets/*/versions/*}:destroy"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Sets the access control policy on the specified secret. Replaces any
+  // existing policy.
+  //
+  // Permissions on [SecretVersions][google.cloud.secretmanager.v1.SecretVersion] are enforced according
+  // to the policy set on the associated [Secret][google.cloud.secretmanager.v1.Secret].
+  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) returns (google.iam.v1.Policy) {
+    option (google.api.http) = {
+      post: "/v1/{resource=projects/*/secrets/*}:setIamPolicy"
+      body: "*"
+    };
+  }
+
+  // Gets the access control policy for a secret.
+  // Returns empty policy if the secret exists and does not have a policy set.
+  rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) returns (google.iam.v1.Policy) {
+    option (google.api.http) = {
+      get: "/v1/{resource=projects/*/secrets/*}:getIamPolicy"
+    };
+  }
+
+  // Returns permissions that a caller has for the specified secret.
+  // If the secret does not exist, this call returns an empty set of
+  // permissions, not a NOT_FOUND error.
+  //
+  // Note: This operation is designed to be used for building permission-aware
+  // UIs and command-line tools, not for authorization checking. This operation
+  // may "fail open" without warning.
+  rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest) returns (google.iam.v1.TestIamPermissionsResponse) {
+    option (google.api.http) = {
+      post: "/v1/{resource=projects/*/secrets/*}:testIamPermissions"
+      body: "*"
+    };
+  }
+}
+
+// Request message for [SecretManagerService.ListSecrets][google.cloud.secretmanager.v1.SecretManagerService.ListSecrets].
+message ListSecretsRequest {
+  // Required. The resource name of the project associated with the
+  // [Secrets][google.cloud.secretmanager.v1.Secret], in the format `projects/*`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
+
+  // Optional. The maximum number of results to be returned in a single page. If
+  // set to 0, the server decides the number of results to return. If the
+  // number is greater than 25000, it is capped at 25000.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Pagination token, returned earlier via
+  // [ListSecretsResponse.next_page_token][google.cloud.secretmanager.v1.ListSecretsResponse.next_page_token].
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response message for [SecretManagerService.ListSecrets][google.cloud.secretmanager.v1.SecretManagerService.ListSecrets].
+message ListSecretsResponse {
+  // The list of [Secrets][google.cloud.secretmanager.v1.Secret] sorted in reverse by create_time (newest
+  // first).
+  repeated Secret secrets = 1;
+
+  // A token to retrieve the next page of results. Pass this value in
+  // [ListSecretsRequest.page_token][google.cloud.secretmanager.v1.ListSecretsRequest.page_token] to retrieve the next page.
+  string next_page_token = 2;
+
+  // The total number of [Secrets][google.cloud.secretmanager.v1.Secret].
+  int32 total_size = 3;
+}
+
+// Request message for [SecretManagerService.CreateSecret][google.cloud.secretmanager.v1.SecretManagerService.CreateSecret].
+message CreateSecretRequest {
+  // Required. The resource name of the project to associate with the
+  // [Secret][google.cloud.secretmanager.v1.Secret], in the format `projects/*`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
+
+  // Required. This must be unique within the project.
+  //
+  // A secret ID is a string with a maximum length of 255 characters and can
+  // contain uppercase and lowercase letters, numerals, and the hyphen (`-`) and
+  // underscore (`_`) characters.
+  string secret_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. A [Secret][google.cloud.secretmanager.v1.Secret] with initial field values.
+  Secret secret = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for [SecretManagerService.AddSecretVersion][google.cloud.secretmanager.v1.SecretManagerService.AddSecretVersion].
+message AddSecretVersionRequest {
+  // Required. The resource name of the [Secret][google.cloud.secretmanager.v1.Secret] to associate with the
+  // [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] in the format `projects/*/secrets/*`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "secretmanager.googleapis.com/Secret"
+    }
+  ];
+
+  // Required. The secret payload of the [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
+  SecretPayload payload = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for [SecretManagerService.GetSecret][google.cloud.secretmanager.v1.SecretManagerService.GetSecret].
+message GetSecretRequest {
+  // Required. The resource name of the [Secret][google.cloud.secretmanager.v1.Secret], in the format `projects/*/secrets/*`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "secretmanager.googleapis.com/Secret"
+    }
+  ];
+}
+
+// Request message for [SecretManagerService.ListSecretVersions][google.cloud.secretmanager.v1.SecretManagerService.ListSecretVersions].
+message ListSecretVersionsRequest {
+  // Required. The resource name of the [Secret][google.cloud.secretmanager.v1.Secret] associated with the
+  // [SecretVersions][google.cloud.secretmanager.v1.SecretVersion] to list, in the format
+  // `projects/*/secrets/*`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "secretmanager.googleapis.com/Secret"
+    }
+  ];
+
+  // Optional. The maximum number of results to be returned in a single page. If
+  // set to 0, the server decides the number of results to return. If the
+  // number is greater than 25000, it is capped at 25000.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Pagination token, returned earlier via
+  // ListSecretVersionsResponse.next_page_token][].
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response message for [SecretManagerService.ListSecretVersions][google.cloud.secretmanager.v1.SecretManagerService.ListSecretVersions].
+message ListSecretVersionsResponse {
+  // The list of [SecretVersions][google.cloud.secretmanager.v1.SecretVersion] sorted in reverse by
+  // create_time (newest first).
+  repeated SecretVersion versions = 1;
+
+  // A token to retrieve the next page of results. Pass this value in
+  // [ListSecretVersionsRequest.page_token][google.cloud.secretmanager.v1.ListSecretVersionsRequest.page_token] to retrieve the next page.
+  string next_page_token = 2;
+
+  // The total number of [SecretVersions][google.cloud.secretmanager.v1.SecretVersion].
+  int32 total_size = 3;
+}
+
+// Request message for [SecretManagerService.GetSecretVersion][google.cloud.secretmanager.v1.SecretManagerService.GetSecretVersion].
+message GetSecretVersionRequest {
+  // Required. The resource name of the [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] in the format
+  // `projects/*/secrets/*/versions/*`.
+  // `projects/*/secrets/*/versions/latest` is an alias to the `latest`
+  // [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "secretmanager.googleapis.com/SecretVersion"
+    }
+  ];
+}
+
+// Request message for [SecretManagerService.UpdateSecret][google.cloud.secretmanager.v1.SecretManagerService.UpdateSecret].
+message UpdateSecretRequest {
+  // Required. [Secret][google.cloud.secretmanager.v1.Secret] with updated field values.
+  Secret secret = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Specifies the fields to be updated.
+  google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for [SecretManagerService.AccessSecretVersion][google.cloud.secretmanager.v1.SecretManagerService.AccessSecretVersion].
+message AccessSecretVersionRequest {
+  // Required. The resource name of the [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] in the format
+  // `projects/*/secrets/*/versions/*`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "secretmanager.googleapis.com/SecretVersion"
+    }
+  ];
+}
+
+// Response message for [SecretManagerService.AccessSecretVersion][google.cloud.secretmanager.v1.SecretManagerService.AccessSecretVersion].
+message AccessSecretVersionResponse {
+  // The resource name of the [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] in the format
+  // `projects/*/secrets/*/versions/*`.
+  string name = 1 [(google.api.resource_reference) = {
+                     type: "secretmanager.googleapis.com/SecretVersion"
+                   }];
+
+  // Secret payload
+  SecretPayload payload = 2;
+}
+
+// Request message for [SecretManagerService.DeleteSecret][google.cloud.secretmanager.v1.SecretManagerService.DeleteSecret].
+message DeleteSecretRequest {
+  // Required. The resource name of the [Secret][google.cloud.secretmanager.v1.Secret] to delete in the format
+  // `projects/*/secrets/*`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "secretmanager.googleapis.com/Secret"
+    }
+  ];
+}
+
+// Request message for [SecretManagerService.DisableSecretVersion][google.cloud.secretmanager.v1.SecretManagerService.DisableSecretVersion].
+message DisableSecretVersionRequest {
+  // Required. The resource name of the [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to disable in the format
+  // `projects/*/secrets/*/versions/*`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "secretmanager.googleapis.com/SecretVersion"
+    }
+  ];
+}
+
+// Request message for [SecretManagerService.EnableSecretVersion][google.cloud.secretmanager.v1.SecretManagerService.EnableSecretVersion].
+message EnableSecretVersionRequest {
+  // Required. The resource name of the [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to enable in the format
+  // `projects/*/secrets/*/versions/*`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "secretmanager.googleapis.com/SecretVersion"
+    }
+  ];
+}
+
+// Request message for [SecretManagerService.DestroySecretVersion][google.cloud.secretmanager.v1.SecretManagerService.DestroySecretVersion].
+message DestroySecretVersionRequest {
+  // Required. The resource name of the [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to destroy in the format
+  // `projects/*/secrets/*/versions/*`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "secretmanager.googleapis.com/SecretVersion"
+    }
+  ];
+}
diff --git a/third_party/googleapis/google/devtools/containeranalysis/artman_containeranalysis.yaml b/third_party/googleapis/google/cloud/secrets/artman_secretmanager_v1beta1.yaml
similarity index 72%
rename from third_party/googleapis/google/devtools/containeranalysis/artman_containeranalysis.yaml
rename to third_party/googleapis/google/cloud/secrets/artman_secretmanager_v1beta1.yaml
index 67172bc9a..e2a8e4210 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/artman_containeranalysis.yaml
+++ b/third_party/googleapis/google/cloud/secrets/artman_secretmanager_v1beta1.yaml
@@ -1,15 +1,15 @@
 common:
-  api_name: containeranalysis
-  api_version: v1alpha1
+  api_name: secretmanager
+  api_version: v1beta1
   organization_name: google-cloud
   proto_deps:
   - name: google-common-protos
   - name: google-iam-v1
-    proto_path: google/iam/v1
   src_proto_paths:
-  - v1alpha1
-  service_yaml: containeranalysis.yaml
-  gapic_yaml: v1alpha1/containeranalysis_gapic.yaml
+  - v1beta1
+  service_yaml: v1beta1/secretmanager_v1beta1.yaml
+  gapic_yaml: v1beta1/secretmanager_gapic.yaml
+  proto_package: google.cloud.secrets.v1beta1
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/cloud/secrets/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/secrets/v1beta1/BUILD.bazel
new file mode 100644
index 000000000..01128a1d3
--- /dev/null
+++ b/third_party/googleapis/google/cloud/secrets/v1beta1/BUILD.bazel
@@ -0,0 +1,369 @@
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "secretmanager_proto",
+    srcs = [
+        "service.proto",
+        "resources.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/iam/v1:iam_policy_proto",
+        "//google/iam/v1:policy_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "secretmanager_proto_with_info",
+    deps = [
+        ":secretmanager_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "secretmanager_java_proto",
+    deps = [":secretmanager_proto"],
+)
+
+java_grpc_library(
+    name = "secretmanager_java_grpc",
+    srcs = [":secretmanager_proto"],
+    deps = [":secretmanager_java_proto"],
+)
+
+java_gapic_library(
+    name = "secretmanager_java_gapic",
+    src = ":secretmanager_proto_with_info",
+    gapic_yaml = "secretmanager_gapic.yaml",
+    package = "google.cloud.secrets.v1beta1",
+    service_yaml = "//google/cloud/secrets/v1beta1:secretmanager_v1beta1.yaml",
+    test_deps = [
+        ":secretmanager_java_grpc",
+        "//google/iam/v1:iam_java_grpc",
+    ],
+    deps = [
+        ":secretmanager_java_proto",
+        "//google/iam/v1:iam_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "secretmanager_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.secretmanager.v1beta1.SecretManagerServiceClientTest",
+    ],
+    runtime_deps = [":secretmanager_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-secretmanager-v1beta1-java",
+    deps = [
+        ":secretmanager_java_gapic",
+        ":secretmanager_java_grpc",
+        ":secretmanager_java_proto",
+        ":secretmanager_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "secretmanager_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/secretmanager/v1beta1",
+    protos = [":secretmanager_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/iam/v1:iam_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "secretmanager_go_gapic",
+    srcs = [":secretmanager_proto_with_info"],
+    grpc_service_config = "secretmanager_grpc_service_config.json",
+    importpath = "cloud.google.com/go/secretmanager/apiv1beta1;secretmanager",
+    service_yaml = "//google/cloud/secrets/v1beta1:secretmanager_v1beta1.yaml",
+    deps = [
+        ":secretmanager_go_proto",
+        "//google/iam/v1:iam_go_proto",
+    ],
+)
+
+go_test(
+    name = "secretmanager_go_gapic_test",
+    srcs = [":secretmanager_go_gapic_srcjar_test"],
+    embed = [":secretmanager_go_gapic"],
+    importpath = "cloud.google.com/go/secretmanager/apiv1beta1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-secretmanager-v1beta1-go",
+    deps = [
+        ":secretmanager_go_gapic",
+        ":secretmanager_go_gapic_srcjar-test.srcjar",
+        ":secretmanager_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "secretmanager_moved_proto",
+    srcs = [":secretmanager_proto"],
+    deps = [
+      "//google/api:annotations_proto",
+      "//google/api:client_proto",
+      "//google/api:field_behavior_proto",
+      "//google/iam/v1:iam_policy_proto",
+      "//google/iam/v1:policy_proto",
+      "//google/api:resource_proto",
+      "@com_google_protobuf//:empty_proto",
+      "@com_google_protobuf//:field_mask_proto",
+      "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "secretmanager_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":secretmanager_moved_proto"],
+)
+
+py_grpc_library(
+    name = "secretmanager_py_grpc",
+    srcs = [":secretmanager_moved_proto"],
+    deps = [":secretmanager_py_proto"],
+)
+
+py_gapic_library(
+    name = "secretmanager_py_gapic",
+    src = ":secretmanager_proto_with_info",
+    gapic_yaml = "secretmanager_gapic.yaml",
+    package = "google.cloud.secrets.v1beta1",
+    service_yaml = "//google/cloud/secrets/v1beta1:secretmanager_v1beta1.yaml",
+    deps = [
+        ":secretmanager_py_grpc",
+        ":secretmanager_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "secretmanager-v1beta1-py",
+    deps = [
+        ":secretmanager_py_gapic",
+        ":secretmanager_py_grpc",
+        ":secretmanager_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "secretmanager_php_proto",
+    deps = [":secretmanager_proto"],
+)
+
+php_grpc_library(
+    name = "secretmanager_php_grpc",
+    srcs = [":secretmanager_proto"],
+    deps = [":secretmanager_php_proto"],
+)
+
+php_gapic_library(
+    name = "secretmanager_php_gapic",
+    src = ":secretmanager_proto_with_info",
+    gapic_yaml = "secretmanager_gapic.yaml",
+    package = "google.cloud.secrets.v1beta1",
+    service_yaml = "//google/cloud/secrets/v1beta1:secretmanager_v1beta1.yaml",
+    deps = [
+        ":secretmanager_php_grpc",
+        ":secretmanager_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-secretmanager-v1beta1-php",
+    deps = [
+        ":secretmanager_php_gapic",
+        ":secretmanager_php_grpc",
+        ":secretmanager_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "secretmanager_nodejs_gapic",
+    src = ":secretmanager_proto_with_info",
+    gapic_yaml = "secretmanager_gapic.yaml",
+    package = "google.cloud.secrets.v1beta1",
+    service_yaml = "//google/cloud/secrets/v1beta1:secretmanager_v1beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "secretmanager-v1beta1-nodejs",
+    deps = [
+        ":secretmanager_nodejs_gapic",
+        ":secretmanager_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "secretmanager_ruby_proto",
+    deps = [":secretmanager_proto"],
+)
+
+ruby_grpc_library(
+    name = "secretmanager_ruby_grpc",
+    srcs = [":secretmanager_proto"],
+    deps = [":secretmanager_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "secretmanager_ruby_gapic",
+    src = ":secretmanager_proto_with_info",
+    gapic_yaml = "secretmanager_gapic.yaml",
+    package = "google.cloud.secrets.v1beta1",
+    service_yaml = "//google/cloud/secrets/v1beta1:secretmanager_v1beta1.yaml",
+    deps = [
+        ":secretmanager_ruby_grpc",
+        ":secretmanager_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-secretmanager-v1beta1-ruby",
+    deps = [
+        ":secretmanager_ruby_gapic",
+        ":secretmanager_ruby_grpc",
+        ":secretmanager_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "secretmanager_csharp_proto",
+    deps = [":secretmanager_proto"],
+)
+
+csharp_grpc_library(
+    name = "secretmanager_csharp_grpc",
+    srcs = [":secretmanager_proto"],
+    deps = [":secretmanager_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "secretmanager_csharp_gapic",
+    src = ":secretmanager_proto_with_info",
+    gapic_yaml = "secretmanager_gapic.yaml",
+    package = "google.cloud.secrets.v1beta1",
+    service_yaml = "//google/cloud/secrets/v1beta1:secretmanager_v1beta1.yaml",
+    deps = [
+        ":secretmanager_csharp_grpc",
+        ":secretmanager_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-secretmanager-v1beta1-csharp",
+    deps = [
+        ":secretmanager_csharp_gapic",
+        ":secretmanager_csharp_grpc",
+        ":secretmanager_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/secrets/v1beta1/resources.proto b/third_party/googleapis/google/cloud/secrets/v1beta1/resources.proto
new file mode 100644
index 000000000..4819addd5
--- /dev/null
+++ b/third_party/googleapis/google/cloud/secrets/v1beta1/resources.proto
@@ -0,0 +1,156 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.secrets.v1beta1;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.SecretManager.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/secretmanager/v1beta1;secretmanager";
+option java_multiple_files = true;
+option java_outer_classname = "ResourcesProto";
+option java_package = "com.google.cloud.secretmanager.v1beta1";
+option objc_class_prefix = "GSM";
+option php_namespace = "Google\\Cloud\\SecretManager\\V1beta1";
+option ruby_package = "Google::Cloud::SecretManager::V1beta1";
+
+// A [Secret][google.cloud.secrets.v1beta1.Secret] is a logical secret whose value and versions can
+// be accessed.
+//
+// A [Secret][google.cloud.secrets.v1beta1.Secret] is made up of zero or more [SecretVersions][google.cloud.secrets.v1beta1.SecretVersion] that
+// represent the secret data.
+message Secret {
+  option (google.api.resource) = {
+    type: "secretmanager.googleapis.com/Secret"
+    pattern: "projects/{project}/secrets/{secret}"
+  };
+
+  // Output only. The resource name of the [Secret][google.cloud.secrets.v1beta1.Secret] in the format `projects/*/secrets/*`.
+  string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Required. Immutable. The replication policy of the secret data attached to the [Secret][google.cloud.secrets.v1beta1.Secret].
+  //
+  // The replication policy cannot be changed after the Secret has been created.
+  Replication replication = 2 [
+    (google.api.field_behavior) = IMMUTABLE,
+    (google.api.field_behavior) = REQUIRED
+  ];
+
+  // Output only. The time at which the [Secret][google.cloud.secrets.v1beta1.Secret] was created.
+  google.protobuf.Timestamp create_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // The labels assigned to this Secret.
+  //
+  // Label keys must be between 1 and 63 characters long, have a UTF-8 encoding
+  // of maximum 128 bytes, and must conform to the following PCRE regular
+  // expression: `[\p{Ll}\p{Lo}][\p{Ll}\p{Lo}\p{N}_-]{0,62}`
+  //
+  // Label values must be between 0 and 63 characters long, have a UTF-8
+  // encoding of maximum 128 bytes, and must conform to the following PCRE
+  // regular expression: `[\p{Ll}\p{Lo}\p{N}_-]{0,63}`
+  //
+  // No more than 64 labels can be assigned to a given resource.
+  map labels = 4;
+}
+
+// A secret version resource in the Secret Manager API.
+message SecretVersion {
+  option (google.api.resource) = {
+    type: "secretmanager.googleapis.com/SecretVersion"
+    pattern: "projects/{project}/secrets/{secret}/versions/{secret_version}"
+  };
+
+  // The state of a [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion], indicating if it can be accessed.
+  enum State {
+    // Not specified. This value is unused and invalid.
+    STATE_UNSPECIFIED = 0;
+
+    // The [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] may be accessed.
+    ENABLED = 1;
+
+    // The [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] may not be accessed, but the secret data
+    // is still available and can be placed back into the [ENABLED][google.cloud.secrets.v1beta1.SecretVersion.State.ENABLED]
+    // state.
+    DISABLED = 2;
+
+    // The [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] is destroyed and the secret data is no longer
+    // stored. A version may not leave this state once entered.
+    DESTROYED = 3;
+  }
+
+  // Output only. The resource name of the [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] in the
+  // format `projects/*/secrets/*/versions/*`.
+  //
+  // [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] IDs in a [Secret][google.cloud.secrets.v1beta1.Secret] start at 1 and
+  // are incremented for each subsequent version of the secret.
+  string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The time at which the [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] was created.
+  google.protobuf.Timestamp create_time = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The time this [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] was destroyed.
+  // Only present if [state][google.cloud.secrets.v1beta1.SecretVersion.state] is
+  // [DESTROYED][google.cloud.secrets.v1beta1.SecretVersion.State.DESTROYED].
+  google.protobuf.Timestamp destroy_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The current state of the [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion].
+  State state = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// A policy that defines the replication configuration of data.
+message Replication {
+  // A replication policy that replicates the [Secret][google.cloud.secrets.v1beta1.Secret] payload without any
+  // restrictions.
+  message Automatic {
+
+  }
+
+  // A replication policy that replicates the [Secret][google.cloud.secrets.v1beta1.Secret] payload into the
+  // locations specified in [Secret.replication.user_managed.replicas][]
+  message UserManaged {
+    // Represents a Replica for this [Secret][google.cloud.secrets.v1beta1.Secret].
+    message Replica {
+      // The canonical IDs of the location to replicate data.
+      // For example: `"us-east1"`.
+      string location = 1;
+    }
+
+    // Required. The list of Replicas for this [Secret][google.cloud.secrets.v1beta1.Secret].
+    //
+    // Cannot be empty.
+    repeated Replica replicas = 1 [(google.api.field_behavior) = REQUIRED];
+  }
+
+  // The replication policy for this secret.
+  oneof replication {
+    // The [Secret][google.cloud.secrets.v1beta1.Secret] will automatically be replicated without any restrictions.
+    Automatic automatic = 1;
+
+    // The [Secret][google.cloud.secrets.v1beta1.Secret] will only be replicated into the locations specified.
+    UserManaged user_managed = 2;
+  }
+}
+
+// A secret payload resource in the Secret Manager API. This contains the
+// sensitive secret data that is associated with a [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion].
+message SecretPayload {
+  // The secret data. Must be no larger than 64KiB.
+  bytes data = 1;
+}
diff --git a/third_party/googleapis/google/cloud/secrets/v1beta1/secretmanager_gapic.yaml b/third_party/googleapis/google/cloud/secrets/v1beta1/secretmanager_gapic.yaml
new file mode 100644
index 000000000..a72e23637
--- /dev/null
+++ b/third_party/googleapis/google/cloud/secrets/v1beta1/secretmanager_gapic.yaml
@@ -0,0 +1,19 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 2.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.secretmanager.v1beta1
+  python:
+    package_name: google.cloud.secretmanager_v1beta1.gapic
+  go:
+    package_name: cloud.google.com/go/secretmanager/apiv1beta1
+  csharp:
+    package_name: Google.Cloud.SecretManager.V1Beta1
+  ruby:
+    package_name: Google::Cloud::SecretManager::V1beta1
+  php:
+    package_name: Google\Cloud\SecretManager\V1beta1
+  nodejs:
+    package_name: secretmanager.v1beta1
+    domain_layer_location: google-cloud
diff --git a/third_party/googleapis/google/cloud/secrets/v1beta1/secretmanager_grpc_service_config.json b/third_party/googleapis/google/cloud/secrets/v1beta1/secretmanager_grpc_service_config.json
new file mode 100644
index 000000000..bd52ecaa6
--- /dev/null
+++ b/third_party/googleapis/google/cloud/secrets/v1beta1/secretmanager_grpc_service_config.json
@@ -0,0 +1,83 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.secrets.v1beta1.SecretManagerService",
+          "method": "ListSecrets"
+        },
+        {
+          "service": "google.cloud.secrets.v1beta1.SecretManagerService",
+          "method": "CreateSecret"
+        },
+        {
+          "service": "google.cloud.secrets.v1beta1.SecretManagerService",
+          "method": "AddSecretVersion"
+        },
+        {
+          "service": "google.cloud.secrets.v1beta1.SecretManagerService",
+          "method": "GetSecret"
+        },
+        {
+          "service": "google.cloud.secrets.v1beta1.SecretManagerService",
+          "method": "UpdateSecret"
+        },
+        {
+          "service": "google.cloud.secrets.v1beta1.SecretManagerService",
+          "method": "DeleteSecret"
+        },
+        {
+          "service": "google.cloud.secrets.v1beta1.SecretManagerService",
+          "method": "ListSecretVersions"
+        },
+        {
+          "service": "google.cloud.secrets.v1beta1.SecretManagerService",
+          "method": "GetSecretVersion"
+        },
+        {
+          "service": "google.cloud.secrets.v1beta1.SecretManagerService",
+          "method": "DisableSecretVersion"
+        },
+        {
+          "service": "google.cloud.secrets.v1beta1.SecretManagerService",
+          "method": "EnableSecretVersion"
+        },
+        {
+          "service": "google.cloud.secrets.v1beta1.SecretManagerService",
+          "method": "DestroySecretVersion"
+        },
+        {
+          "service": "google.cloud.secrets.v1beta1.SecretManagerService",
+          "method": "SetIamPolicy"
+        },
+        {
+          "service": "google.cloud.secrets.v1beta1.SecretManagerService",
+          "method": "GetIamPolicy"
+        },
+        {
+          "service": "google.cloud.secrets.v1beta1.SecretManagerService",
+          "method": "TestIamPermissions"
+        }
+      ],
+      "timeout": "60s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.secrets.v1beta1.SecretManagerService",
+          "method": "AccessSecretVersion"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "initialBackoff": "1s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "UNKNOWN"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/secrets/v1beta1/secretmanager_v1beta1.yaml b/third_party/googleapis/google/cloud/secrets/v1beta1/secretmanager_v1beta1.yaml
new file mode 100644
index 000000000..6a0beccc7
--- /dev/null
+++ b/third_party/googleapis/google/cloud/secrets/v1beta1/secretmanager_v1beta1.yaml
@@ -0,0 +1,25 @@
+type: google.api.Service
+config_version: 3
+name: secretmanager.googleapis.com
+title: Secret Manager API
+
+apis:
+- name: google.cloud.secrets.v1beta1.SecretManagerService
+
+documentation:
+  summary: |-
+    Stores sensitive data such as API keys, passwords, and certificates.
+    Provides convenience while improving security.
+  overview: Secret Manager Overview
+
+backend:
+  rules:
+  - selector: 'google.cloud.secrets.v1beta1.SecretManagerService.*'
+    deadline: 10.0
+
+authentication:
+  rules:
+  - selector: 'google.cloud.secrets.v1beta1.SecretManagerService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/secrets/v1beta1/service.proto b/third_party/googleapis/google/cloud/secrets/v1beta1/service.proto
new file mode 100644
index 000000000..9efb8cfcc
--- /dev/null
+++ b/third_party/googleapis/google/cloud/secrets/v1beta1/service.proto
@@ -0,0 +1,420 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.secrets.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/secrets/v1beta1/resources.proto";
+import "google/iam/v1/iam_policy.proto";
+import "google/iam/v1/policy.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.SecretManager.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/secretmanager/v1beta1;secretmanager";
+option java_multiple_files = true;
+option java_outer_classname = "ServiceProto";
+option java_package = "com.google.cloud.secretmanager.v1beta1";
+option objc_class_prefix = "GSM";
+option php_namespace = "Google\\Cloud\\SecretManager\\V1beta1";
+option ruby_package = "Google::Cloud::SecretManager::V1beta1";
+
+// `projects/*/secrets/*/versions/latest` is an alias to the `latest`
+// [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion].
+
+// Secret Manager Service
+//
+// Manages secrets and operations using those secrets. Implements a REST
+// model with the following objects:
+//
+// * [Secret][google.cloud.secrets.v1beta1.Secret]
+// * [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion]
+service SecretManagerService {
+  option (google.api.default_host) = "secretmanager.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // Lists [Secrets][google.cloud.secrets.v1beta1.Secret].
+  rpc ListSecrets(ListSecretsRequest) returns (ListSecretsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*}/secrets"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Creates a new [Secret][google.cloud.secrets.v1beta1.Secret] containing no [SecretVersions][google.cloud.secrets.v1beta1.SecretVersion].
+  rpc CreateSecret(CreateSecretRequest) returns (Secret) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*}/secrets"
+      body: "secret"
+    };
+    option (google.api.method_signature) = "parent,secret_id,secret";
+  }
+
+  // Creates a new [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] containing secret data and attaches
+  // it to an existing [Secret][google.cloud.secrets.v1beta1.Secret].
+  rpc AddSecretVersion(AddSecretVersionRequest) returns (SecretVersion) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/secrets/*}:addVersion"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent,payload";
+  }
+
+  // Gets metadata for a given [Secret][google.cloud.secrets.v1beta1.Secret].
+  rpc GetSecret(GetSecretRequest) returns (Secret) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/secrets/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Updates metadata of an existing [Secret][google.cloud.secrets.v1beta1.Secret].
+  rpc UpdateSecret(UpdateSecretRequest) returns (Secret) {
+    option (google.api.http) = {
+      patch: "/v1beta1/{secret.name=projects/*/secrets/*}"
+      body: "secret"
+    };
+    option (google.api.method_signature) = "secret,update_mask";
+  }
+
+  // Deletes a [Secret][google.cloud.secrets.v1beta1.Secret].
+  rpc DeleteSecret(DeleteSecretRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/secrets/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Lists [SecretVersions][google.cloud.secrets.v1beta1.SecretVersion]. This call does not return secret
+  // data.
+  rpc ListSecretVersions(ListSecretVersionsRequest) returns (ListSecretVersionsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/secrets/*}/versions"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Gets metadata for a [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion].
+  //
+  // `projects/*/secrets/*/versions/latest` is an alias to the `latest`
+  // [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion].
+  rpc GetSecretVersion(GetSecretVersionRequest) returns (SecretVersion) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/secrets/*/versions/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Accesses a [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion]. This call returns the secret data.
+  //
+  // `projects/*/secrets/*/versions/latest` is an alias to the `latest`
+  // [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion].
+  rpc AccessSecretVersion(AccessSecretVersionRequest) returns (AccessSecretVersionResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/secrets/*/versions/*}:access"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Disables a [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion].
+  //
+  // Sets the [state][google.cloud.secrets.v1beta1.SecretVersion.state] of the [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to
+  // [DISABLED][google.cloud.secrets.v1beta1.SecretVersion.State.DISABLED].
+  rpc DisableSecretVersion(DisableSecretVersionRequest) returns (SecretVersion) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/secrets/*/versions/*}:disable"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Enables a [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion].
+  //
+  // Sets the [state][google.cloud.secrets.v1beta1.SecretVersion.state] of the [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to
+  // [ENABLED][google.cloud.secrets.v1beta1.SecretVersion.State.ENABLED].
+  rpc EnableSecretVersion(EnableSecretVersionRequest) returns (SecretVersion) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/secrets/*/versions/*}:enable"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Destroys a [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion].
+  //
+  // Sets the [state][google.cloud.secrets.v1beta1.SecretVersion.state] of the [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to
+  // [DESTROYED][google.cloud.secrets.v1beta1.SecretVersion.State.DESTROYED] and irrevocably destroys the
+  // secret data.
+  rpc DestroySecretVersion(DestroySecretVersionRequest) returns (SecretVersion) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/secrets/*/versions/*}:destroy"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Sets the access control policy on the specified secret. Replaces any
+  // existing policy.
+  //
+  // Permissions on [SecretVersions][google.cloud.secrets.v1beta1.SecretVersion] are enforced according
+  // to the policy set on the associated [Secret][google.cloud.secrets.v1beta1.Secret].
+  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) returns (google.iam.v1.Policy) {
+    option (google.api.http) = {
+      post: "/v1beta1/{resource=projects/*/secrets/*}:setIamPolicy"
+      body: "*"
+    };
+  }
+
+  // Gets the access control policy for a secret.
+  // Returns empty policy if the secret exists and does not have a policy set.
+  rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) returns (google.iam.v1.Policy) {
+    option (google.api.http) = {
+      get: "/v1beta1/{resource=projects/*/secrets/*}:getIamPolicy"
+    };
+  }
+
+  // Returns permissions that a caller has for the specified secret.
+  // If the secret does not exist, this call returns an empty set of
+  // permissions, not a NOT_FOUND error.
+  //
+  // Note: This operation is designed to be used for building permission-aware
+  // UIs and command-line tools, not for authorization checking. This operation
+  // may "fail open" without warning.
+  rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest) returns (google.iam.v1.TestIamPermissionsResponse) {
+    option (google.api.http) = {
+      post: "/v1beta1/{resource=projects/*/secrets/*}:testIamPermissions"
+      body: "*"
+    };
+  }
+}
+
+// Request message for [SecretManagerService.ListSecrets][google.cloud.secrets.v1beta1.SecretManagerService.ListSecrets].
+message ListSecretsRequest {
+  // Required. The resource name of the project associated with the
+  // [Secrets][google.cloud.secrets.v1beta1.Secret], in the format `projects/*`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
+
+  // Optional. The maximum number of results to be returned in a single page. If
+  // set to 0, the server decides the number of results to return. If the
+  // number is greater than 25000, it is capped at 25000.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Pagination token, returned earlier via
+  // [ListSecretsResponse.next_page_token][google.cloud.secrets.v1beta1.ListSecretsResponse.next_page_token].
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response message for [SecretManagerService.ListSecrets][google.cloud.secrets.v1beta1.SecretManagerService.ListSecrets].
+message ListSecretsResponse {
+  // The list of [Secrets][google.cloud.secrets.v1beta1.Secret] sorted in reverse by create_time (newest
+  // first).
+  repeated Secret secrets = 1;
+
+  // A token to retrieve the next page of results. Pass this value in
+  // [ListSecretsRequest.page_token][google.cloud.secrets.v1beta1.ListSecretsRequest.page_token] to retrieve the next page.
+  string next_page_token = 2;
+
+  // The total number of [Secrets][google.cloud.secrets.v1beta1.Secret].
+  int32 total_size = 3;
+}
+
+// Request message for [SecretManagerService.CreateSecret][google.cloud.secrets.v1beta1.SecretManagerService.CreateSecret].
+message CreateSecretRequest {
+  // Required. The resource name of the project to associate with the
+  // [Secret][google.cloud.secrets.v1beta1.Secret], in the format `projects/*`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
+
+  // Required. This must be unique within the project.
+  //
+  // A secret ID is a string with a maximum length of 255 characters and can
+  // contain uppercase and lowercase letters, numerals, and the hyphen (`-`) and
+  // underscore (`_`) characters.
+  string secret_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. A [Secret][google.cloud.secrets.v1beta1.Secret] with initial field values.
+  Secret secret = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for [SecretManagerService.AddSecretVersion][google.cloud.secrets.v1beta1.SecretManagerService.AddSecretVersion].
+message AddSecretVersionRequest {
+  // Required. The resource name of the [Secret][google.cloud.secrets.v1beta1.Secret] to associate with the
+  // [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] in the format `projects/*/secrets/*`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "secretmanager.googleapis.com/Secret"
+    }
+  ];
+
+  // Required. The secret payload of the [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion].
+  SecretPayload payload = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for [SecretManagerService.GetSecret][google.cloud.secrets.v1beta1.SecretManagerService.GetSecret].
+message GetSecretRequest {
+  // Required. The resource name of the [Secret][google.cloud.secrets.v1beta1.Secret], in the format `projects/*/secrets/*`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "secretmanager.googleapis.com/Secret"
+    }
+  ];
+}
+
+// Request message for [SecretManagerService.ListSecretVersions][google.cloud.secrets.v1beta1.SecretManagerService.ListSecretVersions].
+message ListSecretVersionsRequest {
+  // Required. The resource name of the [Secret][google.cloud.secrets.v1beta1.Secret] associated with the
+  // [SecretVersions][google.cloud.secrets.v1beta1.SecretVersion] to list, in the format
+  // `projects/*/secrets/*`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "secretmanager.googleapis.com/Secret"
+    }
+  ];
+
+  // Optional. The maximum number of results to be returned in a single page. If
+  // set to 0, the server decides the number of results to return. If the
+  // number is greater than 25000, it is capped at 25000.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Pagination token, returned earlier via
+  // ListSecretVersionsResponse.next_page_token][].
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response message for [SecretManagerService.ListSecretVersions][google.cloud.secrets.v1beta1.SecretManagerService.ListSecretVersions].
+message ListSecretVersionsResponse {
+  // The list of [SecretVersions][google.cloud.secrets.v1beta1.SecretVersion] sorted in reverse by
+  // create_time (newest first).
+  repeated SecretVersion versions = 1;
+
+  // A token to retrieve the next page of results. Pass this value in
+  // [ListSecretVersionsRequest.page_token][google.cloud.secrets.v1beta1.ListSecretVersionsRequest.page_token] to retrieve the next page.
+  string next_page_token = 2;
+
+  // The total number of [SecretVersions][google.cloud.secrets.v1beta1.SecretVersion].
+  int32 total_size = 3;
+}
+
+// Request message for [SecretManagerService.GetSecretVersion][google.cloud.secrets.v1beta1.SecretManagerService.GetSecretVersion].
+message GetSecretVersionRequest {
+  // Required. The resource name of the [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] in the format
+  // `projects/*/secrets/*/versions/*`.
+  // `projects/*/secrets/*/versions/latest` is an alias to the `latest`
+  // [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion].
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "secretmanager.googleapis.com/SecretVersion"
+    }
+  ];
+}
+
+// Request message for [SecretManagerService.UpdateSecret][google.cloud.secrets.v1beta1.SecretManagerService.UpdateSecret].
+message UpdateSecretRequest {
+  // Required. [Secret][google.cloud.secrets.v1beta1.Secret] with updated field values.
+  Secret secret = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Specifies the fields to be updated.
+  google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for [SecretManagerService.AccessSecretVersion][google.cloud.secrets.v1beta1.SecretManagerService.AccessSecretVersion].
+message AccessSecretVersionRequest {
+  // Required. The resource name of the [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] in the format
+  // `projects/*/secrets/*/versions/*`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "secretmanager.googleapis.com/SecretVersion"
+    }
+  ];
+}
+
+// Response message for [SecretManagerService.AccessSecretVersion][google.cloud.secrets.v1beta1.SecretManagerService.AccessSecretVersion].
+message AccessSecretVersionResponse {
+  // The resource name of the [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] in the format
+  // `projects/*/secrets/*/versions/*`.
+  string name = 1 [(google.api.resource_reference) = {
+                     type: "secretmanager.googleapis.com/SecretVersion"
+                   }];
+
+  // Secret payload
+  SecretPayload payload = 2;
+}
+
+// Request message for [SecretManagerService.DeleteSecret][google.cloud.secrets.v1beta1.SecretManagerService.DeleteSecret].
+message DeleteSecretRequest {
+  // Required. The resource name of the [Secret][google.cloud.secrets.v1beta1.Secret] to delete in the format
+  // `projects/*/secrets/*`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "secretmanager.googleapis.com/Secret"
+    }
+  ];
+}
+
+// Request message for [SecretManagerService.DisableSecretVersion][google.cloud.secrets.v1beta1.SecretManagerService.DisableSecretVersion].
+message DisableSecretVersionRequest {
+  // Required. The resource name of the [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to disable in the format
+  // `projects/*/secrets/*/versions/*`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "secretmanager.googleapis.com/SecretVersion"
+    }
+  ];
+}
+
+// Request message for [SecretManagerService.EnableSecretVersion][google.cloud.secrets.v1beta1.SecretManagerService.EnableSecretVersion].
+message EnableSecretVersionRequest {
+  // Required. The resource name of the [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to enable in the format
+  // `projects/*/secrets/*/versions/*`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "secretmanager.googleapis.com/SecretVersion"
+    }
+  ];
+}
+
+// Request message for [SecretManagerService.DestroySecretVersion][google.cloud.secrets.v1beta1.SecretManagerService.DestroySecretVersion].
+message DestroySecretVersionRequest {
+  // Required. The resource name of the [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to destroy in the format
+  // `projects/*/secrets/*/versions/*`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "secretmanager.googleapis.com/SecretVersion"
+    }
+  ];
+}
diff --git a/third_party/googleapis/google/cloud/securitycenter/BUILD.bazel b/third_party/googleapis/google/cloud/securitycenter/BUILD.bazel
index 1e5b8c2af..a87c57fec 100644
--- a/third_party/googleapis/google/cloud/securitycenter/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/securitycenter/BUILD.bazel
@@ -1 +1 @@
-exports_files(glob(["*.yaml"]))
\ No newline at end of file
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/cloud/securitycenter/artman_securitycenter_v1.yaml b/third_party/googleapis/google/cloud/securitycenter/artman_securitycenter_v1.yaml
index 733df0f92..8a160cebc 100644
--- a/third_party/googleapis/google/cloud/securitycenter/artman_securitycenter_v1.yaml
+++ b/third_party/googleapis/google/cloud/securitycenter/artman_securitycenter_v1.yaml
@@ -3,13 +3,14 @@ common:
   api_version: v1
   organization_name: google-cloud
   proto_deps:
-    - name: google-common-protos
-    - name: google-iam-v1
-      proto_path: google/iam/v1
+  - name: google-common-protos
+  - name: google-iam-v1
+    proto_path: google/iam/v1
   src_proto_paths:
   - v1
-  service_yaml: securitycenter_v1.yaml
+  service_yaml: v1/securitycenter_v1.yaml
   gapic_yaml: v1/securitycenter_gapic.yaml
+  proto_package: google.cloud.securitycenter.v1
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/cloud/securitycenter/artman_securitycenter_v1p1beta1.yaml b/third_party/googleapis/google/cloud/securitycenter/artman_securitycenter_v1p1beta1.yaml
new file mode 100644
index 000000000..ec98bc9d5
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/artman_securitycenter_v1p1beta1.yaml
@@ -0,0 +1,37 @@
+common:
+  api_name: securitycenter
+  api_version: v1p1beta1
+  organization_name: google-cloud
+  proto_deps:
+  - name: google-common-protos
+  - name: google-iam-v1
+    proto_path: google/iam/v1
+  src_proto_paths:
+  - v1p1beta1
+  service_yaml: v1p1beta1/securitycenter_v1p1beta1.yaml
+  gapic_yaml: v1p1beta1/securitycenter_gapic.yaml
+  proto_package: google.cloud.securitycenter.v1p1beta1
+artifacts:
+- name: gapic_config
+  type: GAPIC_CONFIG
+- name: java_gapic
+  type: GAPIC
+  language: JAVA
+- name: python_gapic
+  type: GAPIC
+  language: PYTHON
+- name: nodejs_gapic
+  type: GAPIC
+  language: NODEJS
+- name: php_gapic
+  type: GAPIC
+  language: PHP
+- name: go_gapic
+  type: GAPIC
+  language: GO
+- name: ruby_gapic
+  type: GAPIC
+  language: RUBY
+- name: csharp_gapic
+  type: GAPIC
+  language: CSHARP
diff --git a/third_party/googleapis/google/cloud/securitycenter/securitycenter_v1.yaml b/third_party/googleapis/google/cloud/securitycenter/securitycenter_v1.yaml
deleted file mode 100644
index bb3084313..000000000
--- a/third_party/googleapis/google/cloud/securitycenter/securitycenter_v1.yaml
+++ /dev/null
@@ -1,80 +0,0 @@
-type: google.api.Service
-config_version: 3
-name: securitycenter.googleapis.com
-title: Cloud Security Command Center API
-
-apis:
-- name: google.cloud.securitycenter.v1.SecurityCenter
-
-types:
-- name: google.cloud.securitycenter.v1.RunAssetDiscoveryResponse
-
-documentation:
-  summary: |-
-    Cloud Security Command Center API provides access to temporal views of
-    assets and findings within an organization.
-
-backend:
-  rules:
-  - selector: google.cloud.securitycenter.v1.SecurityCenter.CreateSource
-    deadline: 60.0
-  - selector: google.cloud.securitycenter.v1.SecurityCenter.CreateFinding
-    deadline: 60.0
-  - selector: google.cloud.securitycenter.v1.SecurityCenter.GetIamPolicy
-    deadline: 60.0
-  - selector: google.cloud.securitycenter.v1.SecurityCenter.GetOrganizationSettings
-    deadline: 60.0
-  - selector: google.cloud.securitycenter.v1.SecurityCenter.GetSource
-    deadline: 60.0
-  - selector: google.cloud.securitycenter.v1.SecurityCenter.GroupAssets
-    deadline: 60.0
-  - selector: google.cloud.securitycenter.v1.SecurityCenter.GroupFindings
-    deadline: 60.0
-  - selector: google.cloud.securitycenter.v1.SecurityCenter.ListAssets
-    deadline: 60.0
-  - selector: google.cloud.securitycenter.v1.SecurityCenter.ListFindings
-    deadline: 60.0
-  - selector: google.cloud.securitycenter.v1.SecurityCenter.ListSources
-    deadline: 60.0
-  - selector: google.cloud.securitycenter.v1.SecurityCenter.RunAssetDiscovery
-    deadline: 60.0
-  - selector: google.cloud.securitycenter.v1.SecurityCenter.SetFindingState
-    deadline: 60.0
-  - selector: google.cloud.securitycenter.v1.SecurityCenter.SetIamPolicy
-    deadline: 60.0
-  - selector: google.cloud.securitycenter.v1.SecurityCenter.TestIamPermissions
-    deadline: 60.0
-  - selector: google.cloud.securitycenter.v1.SecurityCenter.UpdateFinding
-    deadline: 60.0
-  - selector: google.cloud.securitycenter.v1.SecurityCenter.UpdateOrganizationSettings
-    deadline: 60.0
-  - selector: google.cloud.securitycenter.v1.SecurityCenter.UpdateSource
-    deadline: 60.0
-  - selector: google.cloud.securitycenter.v1.SecurityCenter.UpdateSecurityMarks
-    deadline: 60.0
-
-http:
-  rules:
-  - selector: google.longrunning.Operations.ListOperations
-    get: '/v1/{name=organizations/*/operations}'
-
-  - selector: google.longrunning.Operations.GetOperation
-    get: '/v1/{name=organizations/*/operations/*}'
-
-  - selector: google.longrunning.Operations.DeleteOperation
-    delete: '/v1/{name=organizations/*/operations/*}'
-
-  - selector: google.longrunning.Operations.CancelOperation
-    post: '/v1/{name=organizations/*/operations/*}:cancel'
-    body: '*'
-
-authentication:
-  rules:
-  - selector: 'google.cloud.securitycenter.v1.SecurityCenter.*'
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform
-  - selector: 'google.longrunning.Operations.*'
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/BUILD.bazel
new file mode 100644
index 000000000..08abb81c3
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/BUILD.bazel
@@ -0,0 +1,367 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "settings_proto",
+    srcs = [
+        "billing_settings.proto",
+        "component_settings.proto",
+        "detector.proto",
+        "securitycenter_settings_service.proto",
+        "settings.proto",
+        "sink_settings.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "settings_proto_with_info",
+    deps = [
+        ":settings_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "settings_java_proto",
+    deps = [":settings_proto"],
+)
+
+java_grpc_library(
+    name = "settings_java_grpc",
+    srcs = [":settings_proto"],
+    deps = [":settings_java_proto"],
+)
+
+java_gapic_library(
+    name = "settings_java_gapic",
+    src = ":settings_proto_with_info",
+    gapic_yaml = "securitycenter_settings_gapic.yaml",
+    package = "google.cloud.securitycenter.settings.v1beta1",
+    service_yaml = "securitycenter_settings.yaml",
+    test_deps = [
+        ":settings_java_grpc",
+    ],
+    deps = [
+        ":settings_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "settings_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.securitycenter.settings.v1beta1.SecurityCenterSettingsServiceClientTest",
+    ],
+    runtime_deps = [":settings_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-securitycenter-settings-v1beta1-java",
+    deps = [
+        ":settings_java_gapic",
+        ":settings_java_grpc",
+        ":settings_java_proto",
+        ":settings_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "settings_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/securitycenter/settings/v1beta1",
+    protos = [":settings_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "settings_go_gapic",
+    srcs = [":settings_proto_with_info"],
+    grpc_service_config = "securitycenter_settings_grpc_service_config.json",
+    importpath = "cloud.google.com/go/securitycenter/settings/apiv1beta1;settings",
+    service_yaml = "securitycenter_settings.yaml",
+    deps = [
+        ":settings_go_proto",
+    ],
+)
+
+go_test(
+    name = "settings_go_gapic_test",
+    srcs = [":settings_go_gapic_srcjar_test"],
+    embed = [":settings_go_gapic"],
+    importpath = "cloud.google.com/go/securitycenter/settings/apiv1beta1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-securitycenter-settings-v1beta1-go",
+    deps = [
+        ":settings_go_gapic",
+        ":settings_go_gapic_srcjar-test.srcjar",
+        ":settings_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "settings_moved_proto",
+    srcs = [":settings_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "settings_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":settings_moved_proto"],
+)
+
+py_grpc_library(
+    name = "settings_py_grpc",
+    srcs = [":settings_moved_proto"],
+    deps = [":settings_py_proto"],
+)
+
+py_gapic_library(
+    name = "settings_py_gapic",
+    src = ":settings_proto_with_info",
+    gapic_yaml = "securitycenter_settings_gapic.yaml",
+    package = "google.cloud.securitycenter.settings.v1beta1",
+    service_yaml = "securitycenter_settings.yaml",
+    deps = [
+        ":settings_py_grpc",
+        ":settings_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "securitycenter-settings-v1beta1-py",
+    deps = [
+        ":settings_py_gapic",
+        ":settings_py_grpc",
+        ":settings_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "settings_php_proto",
+    deps = [":settings_proto"],
+)
+
+php_grpc_library(
+    name = "settings_php_grpc",
+    srcs = [":settings_proto"],
+    deps = [":settings_php_proto"],
+)
+
+php_gapic_library(
+    name = "settings_php_gapic",
+    src = ":settings_proto_with_info",
+    gapic_yaml = "securitycenter_settings_gapic.yaml",
+    package = "google.cloud.securitycenter.settings.v1beta1",
+    service_yaml = "securitycenter_settings.yaml",
+    deps = [
+        ":settings_php_grpc",
+        ":settings_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-securitycenter-settings-v1beta1-php",
+    deps = [
+        ":settings_php_gapic",
+        ":settings_php_grpc",
+        ":settings_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "settings_nodejs_gapic",
+    src = ":settings_proto_with_info",
+    gapic_yaml = "securitycenter_settings_gapic.yaml",
+    package = "google.cloud.securitycenter.settings.v1beta1",
+    service_yaml = "securitycenter_settings.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "securitycenter-settings-v1beta1-nodejs",
+    deps = [
+        ":settings_nodejs_gapic",
+        ":settings_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "settings_ruby_proto",
+    deps = [":settings_proto"],
+)
+
+ruby_grpc_library(
+    name = "settings_ruby_grpc",
+    srcs = [":settings_proto"],
+    deps = [":settings_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "settings_ruby_gapic",
+    src = ":settings_proto_with_info",
+    gapic_yaml = "securitycenter_settings_gapic.yaml",
+    package = "google.cloud.securitycenter.settings.v1beta1",
+    service_yaml = "securitycenter_settings.yaml",
+    deps = [
+        ":settings_ruby_grpc",
+        ":settings_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-securitycenter-settings-v1beta1-ruby",
+    deps = [
+        ":settings_ruby_gapic",
+        ":settings_ruby_grpc",
+        ":settings_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "settings_csharp_proto",
+    deps = [":settings_proto"],
+)
+
+csharp_grpc_library(
+    name = "settings_csharp_grpc",
+    srcs = [":settings_proto"],
+    deps = [":settings_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "settings_csharp_gapic",
+    src = ":settings_proto_with_info",
+    gapic_yaml = "securitycenter_settings_gapic.yaml",
+    package = "google.cloud.securitycenter.settings.v1beta1",
+    service_yaml = "securitycenter_settings.yaml",
+    deps = [
+        ":settings_csharp_grpc",
+        ":settings_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-securitycenter-settings-v1beta1-csharp",
+    deps = [
+        ":settings_csharp_gapic",
+        ":settings_csharp_grpc",
+        ":settings_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/billing_settings.proto b/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/billing_settings.proto
new file mode 100644
index 000000000..149e32fcd
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/billing_settings.proto
@@ -0,0 +1,79 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.securitycenter.settings.v1beta1;
+
+import "google/api/field_behavior.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.SecurityCenter.Settings.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/settings/v1beta1;settings";
+option java_multiple_files = true;
+option java_outer_classname = "BillingSettingsProto";
+option java_package = "com.google.cloud.securitycenter.settings.v1beta1";
+option php_namespace = "Google\\Cloud\\SecurityCenter\\Settings\\V1beta1";
+option ruby_package = "Google::Cloud::SecurityCenter::Settings::V1beta1";
+
+// If this field is populated and billing_tier is STANDARD, this is
+// indication of a point in the _past_ when a PREMIUM access ended.
+
+// Billing settings
+message BillingSettings {
+  // Output only. Billing tier selected by customer
+  BillingTier billing_tier = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Type of billing method
+  BillingType billing_type = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The absolute point in time when the subscription became effective.
+  // Can be compared to expire_time value to determine full contract duration
+  google.protobuf.Timestamp start_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The absolute point in time when the subscription expires.
+  //
+  // If this field is populated and billing_tier is STANDARD, this is
+  // indication of a point in the _past_ when a PREMIUM access ended.
+  google.protobuf.Timestamp expire_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// Billing tier options
+enum BillingTier {
+  // Default value. This value is unused.
+  BILLING_TIER_UNSPECIFIED = 0;
+
+  // The standard billing tier.
+  STANDARD = 1;
+
+  // The premium billing tier.
+  PREMIUM = 2;
+}
+
+// Billing type
+enum BillingType {
+  // Default billing type
+  BILLING_TYPE_UNSPECIFIED = 0;
+
+  // Subscription for Premium billing tier
+  SUBSCRIPTION = 1;
+
+  // Trial subscription for Premium billing tier
+  TRIAL_SUBSCRIPTION = 2;
+
+  // Alpha customer for Premium billing tier
+  ALPHA = 3;
+}
diff --git a/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/component_settings.proto b/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/component_settings.proto
new file mode 100644
index 000000000..efeb831f0
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/component_settings.proto
@@ -0,0 +1,171 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.securitycenter.settings.v1beta1;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.SecurityCenter.Settings.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/settings/v1beta1;settings";
+option java_multiple_files = true;
+option java_outer_classname = "ComponentSettingsProto";
+option java_package = "com.google.cloud.securitycenter.settings.v1beta1";
+option php_namespace = "Google\\Cloud\\SecurityCenter\\Settings\\V1beta1";
+option ruby_package = "Google::Cloud::SecurityCenter::Settings::V1beta1";
+
+// Component Settings for Security Command Center
+message ComponentSettings {
+  option (google.api.resource) = {
+    type: "securitycenter.googleapis.com/ComponentSettings"
+    pattern: "organizations/{organization}/components/{component}/settings"
+    pattern: "folders/{folder}/components/{component}/settings"
+    pattern: "projects/{project}/components/{component}/settings"
+    pattern: "projects/{project}/locations/{location}/clusters/{cluster}/components/{component}/settings"
+    pattern: "projects/{project}/regions/{region}/clusters/{cluster}/components/{component}/settings"
+    pattern: "projects/{project}/zones/{zone}/clusters/{cluster}/components/{component}/settings"
+  };
+
+  // Settings for each detector.
+  message DetectorSettings {
+    // ENABLE to enable component, DISABLE to disable and INHERIT to inherit
+    // setting from ancestors.
+    ComponentEnablementState state = 1;
+  }
+
+  // The relative resource name of the component settings.
+  // Formats:
+  //  * `organizations/{organization}/components/{component}/settings`
+  //  * `folders/{folder}/components/{component}/settings`
+  //  * `projects/{project}/components/{component}/settings`
+  //  * `projects/{project}/locations/{location}/clusters/{cluster}/components/{component}/settings`
+  //  * `projects/{project}/regions/{region}/clusters/{cluster}/components/{component}/settings`
+  //  * `projects/{project}/zones/{zone}/clusters/{cluster}/components/{component}/settings`
+  string name = 1;
+
+  // ENABLE to enable component, DISABLE to disable and INHERIT to inherit
+  // setting from ancestors.
+  ComponentEnablementState state = 2;
+
+  // Output only. The service account to be used for security center component.
+  // The component must have permission to "act as" the service account.
+  string project_service_account = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Settings for detectors.  Not all detectors must have settings present at
+  // each and every level in the hierarchy.  If it is not present the setting
+  // will be inherited from its ancestors folders, organizations or the
+  // defaults.
+  map detector_settings = 4;
+
+  // Output only. An fingerprint used for optimistic concurrency. If none is provided
+  // on updates then the existing metadata will be blindly overwritten.
+  string etag = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The time these settings were last updated.
+  google.protobuf.Timestamp update_time = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Component specific settings.  This must match the component value.
+  oneof specific_settings {
+    // Container Threate Detection specific settings
+    // For component, expect CONTAINER_THREAT_DETECTION
+    ContainerThreatDetectionSettings container_threat_detection_settings = 41;
+
+    // Event Threat Detection specific settings
+    // For component, expect EVENT_THREAT_DETECTION
+    EventThreatDetectionSettings event_threat_detection_settings = 42;
+
+    // Security Health Analytics specific settings
+    // For component, expect SECURITY_HEALTH_ANALYTICS
+    SecurityHealthAnalyticsSettings security_health_analytics_settings = 44;
+
+    // Web Security Scanner specific settings
+    // For component, expect WEB_SECURITY_SCANNER
+    WebSecurityScanner web_security_scanner_settings = 40;
+  }
+}
+
+// User specified settings for Web Security Scanner
+message WebSecurityScanner {
+
+}
+
+// User specified settings for KTD
+message ContainerThreatDetectionSettings {
+
+}
+
+// User specified settings for ETD
+message EventThreatDetectionSettings {
+
+}
+
+// User specified settings for Security Health Analytics
+message SecurityHealthAnalyticsSettings {
+  // Settings for "NON_ORG_IAM_MEMBER" scanner.
+  message NonOrgIamMemberSettings {
+    // User emails ending in the provided identities are allowed to have IAM
+    // permissions on a project or the organization. Otherwise a finding will
+    // be created.
+    // A valid identity can be:
+    //   *  a domain that starts with "@", e.g. "@yourdomain.com".
+    //   *  a fully specified email address that does not start with "@", e.g.
+    //   "abc@gmail.com"
+    // Regular expressions are not supported.
+    // Service accounts are not examined by the scanner and will be omitted if
+    // added to the list.
+    // If not specified, only Gmail accounts will be considered as non-approved.
+    repeated string approved_identities = 1;
+  }
+
+  // Settings for "ADMIN_SERVICE_ACCOUNT" scanner.
+  message AdminServiceAccountSettings {
+    // User-created service accounts ending in the provided identities are
+    // allowed to have Admin, Owner or Editor roles granted to them. Otherwise
+    // a finding will be created.
+    // A valid identity can be:
+    //   *  a partilly specified service account that starts with "@", e.g.
+    //   "@myproject.iam.gserviceaccount.com". This approves all the service
+    //   accounts suffixed with the specified identity.
+    //   *  a fully specified service account that does not start with "@", e.g.
+    //   "myadmin@myproject.iam.gserviceaccount.com".
+    // Google-created service accounts are all approved.
+    repeated string approved_identities = 1;
+  }
+
+  // Settings for "NON_ORG_IAM_MEMBER" scanner.
+  NonOrgIamMemberSettings non_org_iam_member_settings = 1;
+
+  // Settings for "ADMIN_SERVICE_ACCOUNT" scanner.
+  AdminServiceAccountSettings admin_service_account_settings = 2;
+}
+
+// Valid states for a component
+enum ComponentEnablementState {
+  // No state specified, equivalent of INHERIT
+  COMPONENT_ENABLEMENT_STATE_UNSPECIFIED = 0;
+
+  // Disable the component
+  DISABLE = 1;
+
+  // Enable the component
+  ENABLE = 2;
+
+  // Inherit the state from resources parent folder or organization.
+  INHERIT = 3;
+}
diff --git a/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/detector.proto b/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/detector.proto
new file mode 100644
index 000000000..c7c42bc33
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/detector.proto
@@ -0,0 +1,57 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.securitycenter.settings.v1beta1;
+
+import "google/api/field_behavior.proto";
+import "google/cloud/securitycenter/settings/v1beta1/billing_settings.proto";
+import "google/api/annotations.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.SecurityCenter.Settings.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/settings/v1beta1;settings";
+option java_multiple_files = true;
+option java_outer_classname = "DetectorsProto";
+option java_package = "com.google.cloud.securitycenter.settings.v1beta1";
+option php_namespace = "Google\\Cloud\\SecurityCenter\\Settings\\V1beta1";
+option ruby_package = "Google::Cloud::SecurityCenter::Settings::V1beta1";
+
+// Detector is a set of detectors or scanners act as individual checks done
+// within a component e.g. bad IP, bad domains, IAM anomaly, cryptomining, open
+// firewall, etc. Detector is independent of Organization, meaning each detector
+// must be defined for a given Security Center component under a specified
+// billing tier. Organizations can configure the list of detectors based on
+// their subscribed billing tier.
+//
+// Defines a detector, its billing tier and any applicable labels.
+message Detector {
+  // Output only. Detector Identifier
+  string detector = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Component that supports detector type.  Multiple components may support the
+  // same detector.
+  string component = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The billing tier may be different for a detector of the same name in
+  // another component.
+  BillingTier billing_tier = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Google curated detector labels. These are alphanumeric tags that are not
+  // necessarily human readable. Labels can be used to group detectors together
+  // in the future. An example might be tagging all detectors “PCI” that help
+  // with PCI compliance.
+  repeated string detector_labels = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
diff --git a/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/securitycenter_settings.yaml b/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/securitycenter_settings.yaml
new file mode 100644
index 000000000..ba2059581
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/securitycenter_settings.yaml
@@ -0,0 +1,29 @@
+type: google.api.Service
+config_version: 3
+name: securitycenter.googleapis.com
+title: Cloud Security Command Center API
+
+apis:
+- name: google.cloud.securitycenter.settings.v1beta1.SecurityCenterSettingsService
+
+documentation:
+  summary: |-
+    Cloud Security Command Center Settings API provides functionality to retrieve and update configurations.
+
+backend:
+  rules:
+  - selector: 'google.cloud.securitycenter.settings.v1beta1.SecurityCenterSettingsService.*'
+    deadline: 480.0
+  - selector: 'google.longrunning.Operations.*'
+    deadline: 60.0
+
+authentication:
+  rules:
+  - selector: 'google.cloud.securitycenter.settings.v1beta1.SecurityCenterSettingsService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/securitycenter_settings_gapic.yaml b/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/securitycenter_settings_gapic.yaml
new file mode 100644
index 000000000..79f79eaae
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/securitycenter_settings_gapic.yaml
@@ -0,0 +1,18 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 2.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.securitycenter.settings.v1beta1
+  python:
+    package_name: google.cloud.securitycenter.settings_v1beta1.gapic
+  go:
+    package_name: cloud.google.com/go/securitycenter/settings/apiv1beta1
+  csharp:
+    package_name: Google.Cloud.SecurityCenter.Settings.V1Beta1
+  ruby:
+    package_name: Google::Cloud::SecurityCenter::Settings::V1beta1
+  php:
+    package_name: Google\Cloud\SecurityCenter\Settings\V1beta1
+  nodejs:
+    package_name: security-center.settings.v1beta1
+    domain_layer_location: google-cloud
diff --git a/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/securitycenter_settings_grpc_service_config.json b/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/securitycenter_settings_grpc_service_config.json
new file mode 100644
index 000000000..83b7fc8b7
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/securitycenter_settings_grpc_service_config.json
@@ -0,0 +1,70 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.securitycenter.settings.v1beta1.SecurityCenterSettingsService",
+          "method": "GetServiceAccount"
+        },
+        {
+          "service": "google.cloud.securitycenter.settings.v1beta1.SecurityCenterSettingsService",
+          "method": "GetSettings"
+        },
+        {
+          "service": "google.cloud.securitycenter.settings.v1beta1.SecurityCenterSettingsService",
+          "method": "UpdateSettings"
+        },
+        {
+          "service": "google.cloud.securitycenter.settings.v1beta1.SecurityCenterSettingsService",
+          "method": "ResetSettings"
+        },
+        {
+          "service": "google.cloud.securitycenter.settings.v1beta1.SecurityCenterSettingsService",
+          "method": "BatchGetSettings"
+        },
+        {
+          "service": "google.cloud.securitycenter.settings.v1beta1.SecurityCenterSettingsService",
+          "method": "CalculateEffectiveSettings"
+        },
+        {
+          "service": "google.cloud.securitycenter.settings.v1beta1.SecurityCenterSettingsService",
+          "method": "BatchCalculateEffectiveSettings"
+        },
+        {
+          "service": "google.cloud.securitycenter.settings.v1beta1.SecurityCenterSettingsService",
+          "method": "GetComponentSettings"
+        },
+        {
+          "service": "google.cloud.securitycenter.settings.v1beta1.SecurityCenterSettingsService",
+          "method": "UpdateComponentSettings"
+        },
+        {
+          "service": "google.cloud.securitycenter.settings.v1beta1.SecurityCenterSettingsService",
+          "method": "ResetComponentSettings"
+        },
+        {
+          "service": "google.cloud.securitycenter.settings.v1beta1.SecurityCenterSettingsService",
+          "method": "CalculateEffectiveComponentSettings"
+        },
+        {
+          "service": "google.cloud.securitycenter.settings.v1beta1.SecurityCenterSettingsService",
+          "method": "ListDetectors"
+        },
+        {
+          "service": "google.cloud.securitycenter.settings.v1beta1.SecurityCenterSettingsService",
+          "method": "ListComponents"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/securitycenter_settings_service.proto b/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/securitycenter_settings_service.proto
new file mode 100644
index 000000000..e5263695d
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/securitycenter_settings_service.proto
@@ -0,0 +1,650 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.securitycenter.settings.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/securitycenter/settings/v1beta1/component_settings.proto";
+import "google/cloud/securitycenter/settings/v1beta1/detector.proto";
+import "google/cloud/securitycenter/settings/v1beta1/settings.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.SecurityCenter.Settings.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/settings/v1beta1;settings";
+option java_multiple_files = true;
+option java_outer_classname = "SettingsServiceProto";
+option java_package = "com.google.cloud.securitycenter.settings.v1beta1";
+option php_namespace = "Google\\Cloud\\SecurityCenter\\Settings\\V1beta1";
+option ruby_package = "Google::Cloud::SecurityCenter::Settings::V1beta1";
+
+// ## API Overview
+//
+// The SecurityCenterSettingsService is a sub-api of
+// `securitycenter.googleapis.com`. The service provides methods to manage
+// Security Center Settings, and Component Settings for GCP organizations,
+// folders, projects, and clusters.
+service SecurityCenterSettingsService {
+  option (google.api.default_host) = "securitycenter.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // Retrieves the organizations service account, if it exists, otherwise it
+  // creates the organization service account. This API is idempotent and
+  // will only create a service account once. On subsequent calls it will
+  // return the previously created service account.  SHA, SCC and CTD Infra
+  // Automation will use this SA.  This SA will not have any permissions when
+  // created.  The UI will provision this via IAM or the user will using
+  // their own internal process. This API only creates SAs on the organization.
+  // Folders are not supported and projects will use per-project SAs associated
+  // with APIs enabled on a project. This API will be called by the UX
+  // onboarding workflow.
+  rpc GetServiceAccount(GetServiceAccountRequest) returns (ServiceAccount) {
+    option (google.api.http) = {
+      get: "/settings/v1beta1/{name=organizations/*/serviceAccount}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Gets the Settings.
+  rpc GetSettings(GetSettingsRequest) returns (Settings) {
+    option (google.api.http) = {
+      get: "/settings/v1beta1/{name=organizations/*/settings}"
+      additional_bindings {
+        get: "/settings/v1beta1/{name=folders/*/settings}"
+      }
+      additional_bindings {
+        get: "/settings/v1beta1/{name=projects/*/settings}"
+      }
+      additional_bindings {
+        get: "/settings/v1beta1/{name=projects/*/locations/*/clusters/*/settings}"
+      }
+      additional_bindings {
+        get: "/settings/v1beta1/{name=projects/*/regions/*/clusters/*/settings}"
+      }
+      additional_bindings {
+        get: "/settings/v1beta1/{name=projects/*/zones/*/clusters/*/settings}"
+      }
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Updates the Settings.
+  rpc UpdateSettings(UpdateSettingsRequest) returns (Settings) {
+    option (google.api.http) = {
+      patch: "/settings/v1beta1/{settings.name=organizations/*/settings}"
+      body: "settings"
+      additional_bindings {
+        patch: "/settings/v1beta1/{settings.name=folders/*/settings}"
+        body: "settings"
+      }
+      additional_bindings {
+        patch: "/settings/v1beta1/{settings.name=projects/*/settings}"
+        body: "settings"
+      }
+      additional_bindings {
+        patch: "/settings/v1beta1/{settings.name=projects/*/locations/*/clusters/*/settings}"
+        body: "settings"
+      }
+      additional_bindings {
+        patch: "/settings/v1beta1/{settings.name=projects/*/regions/*/clusters/*/settings}"
+        body: "settings"
+      }
+      additional_bindings {
+        patch: "/settings/v1beta1/{settings.name=projects/*/zones/*/clusters/*/settings}"
+        body: "settings"
+      }
+    };
+    option (google.api.method_signature) = "settings,update_mask";
+  }
+
+  // Reset the organization, folder or project's settings and return
+  // the settings of just that resource to the default.
+  //
+  // Settings are present at the organization, folder, project, and cluster
+  // levels. Using Reset on a sub-organization level will remove that resource's
+  // override and result in the parent's settings being used (eg: if Reset on a
+  // cluster, project settings will be used).
+  //
+  // Using Reset on organization will remove the override that was set and
+  // result in default settings being used.
+  rpc ResetSettings(ResetSettingsRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/settings/v1beta1/{name=organizations/*/settings}:reset"
+      body: "*"
+      additional_bindings {
+        post: "/settings/v1beta1/{name=folders/*/settings}:reset"
+        body: "*"
+      }
+      additional_bindings {
+        post: "/settings/v1beta1/{name=projects/*/settings}:reset"
+        body: "*"
+      }
+      additional_bindings {
+        post: "/settings/v1beta1/{name=projects/*/locations/*/clusters/*/settings}:reset"
+        body: "*"
+      }
+      additional_bindings {
+        post: "/settings/v1beta1/{name=projects/*/regions/*/clusters/*/settings}:reset"
+        body: "*"
+      }
+      additional_bindings {
+        post: "/settings/v1beta1/{name=projects/*/zones/*/clusters/*/settings}:reset"
+        body: "*"
+      }
+    };
+  }
+
+  // Gets a list of settings.
+  rpc BatchGetSettings(BatchGetSettingsRequest) returns (BatchGetSettingsResponse) {
+    option (google.api.http) = {
+      get: "/settings/v1beta1/{parent=organizations/*}/settings:batchGet"
+    };
+  }
+
+  // CalculateEffectiveSettings looks up all of the Security Center
+  // Settings resources in the GCP resource hierarchy, and calculates the
+  // effective settings on that resource by applying the following rules:
+  //  * Settings provided closer to the target resource take precedence over
+  //    those further away (e.g. folder will override organization level
+  //    settings).
+  //  * Product defaults can be overridden at org, folder, project, and cluster
+  //  levels.
+  //  * Detectors will be filtered out if they belong to a billing tier the
+  //  customer
+  //    has not configured.
+  rpc CalculateEffectiveSettings(CalculateEffectiveSettingsRequest) returns (Settings) {
+    option (google.api.http) = {
+      get: "/settings/v1beta1/{name=organizations/*/effectiveSettings}:calculate"
+      additional_bindings {
+        get: "/settings/v1beta1/{name=folders/*/effectiveSettings}:calculate"
+      }
+      additional_bindings {
+        get: "/settings/v1beta1/{name=projects/*/effectiveSettings}:calculate"
+      }
+      additional_bindings {
+        get: "/settings/v1beta1/{name=projects/*/locations/*/clusters/*/effectiveSettings}:calculate"
+      }
+      additional_bindings {
+        get: "/settings/v1beta1/{name=projects/*/regions/*/clusters/*/effectiveSettings}:calculate"
+      }
+      additional_bindings {
+        get: "/settings/v1beta1/{name=projects/*/zones/*/clusters/*/effectiveSettings}:calculate"
+      }
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Gets a list of effective settings.
+  rpc BatchCalculateEffectiveSettings(BatchCalculateEffectiveSettingsRequest) returns (BatchCalculateEffectiveSettingsResponse) {
+    option (google.api.http) = {
+      post: "/settings/v1beta1/{parent=organizations/*}/effectiveSettings:batchCalculate"
+      body: "*"
+    };
+  }
+
+  // Gets the Component Settings.
+  rpc GetComponentSettings(GetComponentSettingsRequest) returns (ComponentSettings) {
+    option (google.api.http) = {
+      get: "/settings/v1beta1/{name=organizations/*/components/*/settings}"
+      additional_bindings {
+        get: "/settings/v1beta1/{name=folders/*/components/*/settings}"
+      }
+      additional_bindings {
+        get: "/settings/v1beta1/{name=projects/*/components/*/settings}"
+      }
+      additional_bindings {
+        get: "/settings/v1beta1/{name=projects/*/locations/*/clusters/*/components/*/settings}"
+      }
+      additional_bindings {
+        get: "/settings/v1beta1/{name=projects/*/regions/*/clusters/*/components/*/settings}"
+      }
+      additional_bindings {
+        get: "/settings/v1beta1/{name=projects/*/zones/*/clusters/*/components/*/settings}"
+      }
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Updates the Component Settings.
+  rpc UpdateComponentSettings(UpdateComponentSettingsRequest) returns (ComponentSettings) {
+    option (google.api.http) = {
+      patch: "/settings/v1beta1/{component_settings.name=organizations/*/components/*/settings}"
+      body: "component_settings"
+      additional_bindings {
+        patch: "/settings/v1beta1/{component_settings.name=folders/*/components/*/settings}"
+        body: "component_settings"
+      }
+      additional_bindings {
+        patch: "/settings/v1beta1/{component_settings.name=projects/*/components/*/settings}"
+        body: "component_settings"
+      }
+      additional_bindings {
+        patch: "/settings/v1beta1/{component_settings.name=projects/*/locations/*/clusters/*/components/*/settings}"
+        body: "component_settings"
+      }
+      additional_bindings {
+        patch: "/settings/v1beta1/{component_settings.name=projects/*/regions/*/clusters/*/components/*/settings}"
+        body: "component_settings"
+      }
+      additional_bindings {
+        patch: "/settings/v1beta1/{component_settings.name=projects/*/zones/*/clusters/*/components/*/settings}"
+        body: "component_settings"
+      }
+    };
+    option (google.api.method_signature) = "component_settings,update_mask";
+  }
+
+  // Reset the organization, folder or project's component settings and return
+  // the settings to the default. Settings are present at the
+  // organization, folder and project levels. Using Reset for a folder or
+  // project will remove the override that was set and result in the
+  // organization-level settings being used.
+  rpc ResetComponentSettings(ResetComponentSettingsRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/settings/v1beta1/{name=organizations/*/components/*/settings}:reset"
+      body: "*"
+      additional_bindings {
+        post: "/settings/v1beta1/{name=folders/*/components/*/settings}:reset"
+        body: "*"
+      }
+      additional_bindings {
+        post: "/settings/v1beta1/{name=projects/*/components/*/settings}:reset"
+        body: "*"
+      }
+      additional_bindings {
+        post: "/settings/v1beta1/{name=projects/*/locations/*/clusters/*/components/*/settings}:reset"
+        body: "*"
+      }
+      additional_bindings {
+        post: "/settings/v1beta1/{name=projects/*/regions/*/clusters/*/components/*/settings}:reset"
+        body: "*"
+      }
+      additional_bindings {
+        post: "/settings/v1beta1/{name=projects/*/zones/*/clusters/*/components/*/settings}:reset"
+        body: "*"
+      }
+    };
+  }
+
+  // Gets the Effective Component Settings.
+  rpc CalculateEffectiveComponentSettings(CalculateEffectiveComponentSettingsRequest) returns (ComponentSettings) {
+    option (google.api.http) = {
+      get: "/settings/v1beta1/{name=organizations/*/components/*/effectiveSettings}:calculate"
+      additional_bindings {
+        get: "/settings/v1beta1/{name=folders/*/components/*/effectiveSettings}:calculate"
+      }
+      additional_bindings {
+        get: "/settings/v1beta1/{name=projects/*/components/*/effectiveSettings}:calculate"
+      }
+      additional_bindings {
+        get: "/settings/v1beta1/{name=projects/*/locations/*/clusters/*/components/*/effectiveSettings}:calculate"
+      }
+      additional_bindings {
+        get: "/settings/v1beta1/{name=projects/*/regions/*/clusters/*/components/*/effectiveSettings}:calculate"
+      }
+      additional_bindings {
+        get: "/settings/v1beta1/{name=projects/*/zones/*/clusters/*/components/*/effectiveSettings}:calculate"
+      }
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Retrieves an unordered list of available detectors.
+  rpc ListDetectors(ListDetectorsRequest) returns (ListDetectorsResponse) {
+    option (google.api.http) = {
+      get: "/settings/v1beta1/{parent=organizations/*}/detectors"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Retrieves an unordered list of available SCC components.
+  rpc ListComponents(ListComponentsRequest) returns (ListComponentsResponse) {
+    option (google.api.http) = {
+      get: "/settings/v1beta1/{parent=organizations/*}/components"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+}
+
+// Request message for GetServiceAccount.
+message GetServiceAccountRequest {
+  // Required. The relative resource name of the service account resource.
+  // Format:
+  //  * `organizations/{organization}/serviceAccount`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/ServiceAccount"
+    }
+  ];
+}
+
+// An organization-level service account to be used by threat detection
+// components.
+message ServiceAccount {
+  option (google.api.resource) = {
+    type: "securitycenter.googleapis.com/ServiceAccount"
+    pattern: "organizations/{organization}/serviceAccount"
+  };
+
+  // The relative resource name of the service account resource.
+  // Format:
+  //  * `organizations/{organization}/serviceAccount`
+  string name = 1;
+
+  // Security Center managed service account for the organization
+  // example service-org-1234@scc.iam.gserviceaccount.com
+  // This service_account will be stored in the ComponentSettings field for the
+  // SCC, SHA, and Infra Automation components.
+  string service_account = 2;
+}
+
+// Request message for GetSettings.
+message GetSettingsRequest {
+  // Required. The name of the settings to retrieve.
+  // Formats:
+  //  * `organizations/{organization}/settings`
+  //  * `folders/{folder}/settings`
+  //  * `projects/{project}/settings`
+  //  * `projects/{project}/locations/{location}/clusters/{cluster}/settings`
+  //  * `projects/{project}/regions/{region}/clusters/{cluster}/settings`
+  //  * `projects/{project}/zones/{zone}/clusters/{cluster}/settings`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/Settings"
+    }
+  ];
+}
+
+// Request message for UpdateSettings.
+message UpdateSettingsRequest {
+  // Required. The settings to update.
+  //
+  // The settings' `name` field is used to identify the settings to be updated.
+  // Formats:
+  //  * `organizations/{organization}/settings`
+  //  * `folders/{folder}/settings`
+  //  * `projects/{project}/settings`
+  //  * `projects/{project}/locations/{location}/clusters/{cluster}/settings`
+  //  * `projects/{project}/regions/{region}/clusters/{cluster}/settings`
+  //  * `projects/{project}/zones/{zone}/clusters/{cluster}/settings`
+  Settings settings = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // The list of fields to be updated on the settings.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for ResetSettings.
+message ResetSettingsRequest {
+  // Required. The name of the settings to reset.
+  // Formats:
+  //  * `organizations/{organization}/settings`
+  //  * `folders/{folder}/settings`
+  //  * `projects/{project}/settings`
+  //  * `projects/{project}/locations/{location}/clusters/{cluster}/settings`
+  //  * `projects/{project}/regions/{region}/clusters/{cluster}/settings`
+  //  * `projects/{project}/zones/{zone}/clusters/{cluster}/settings`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/Settings"
+    }
+  ];
+
+  // A fingerprint used for optimistic concurrency. If none is provided,
+  // then the existing settings will be blindly overwritten.
+  string etag = 2;
+}
+
+// Request message for BatchGetSettings.
+message BatchGetSettingsRequest {
+  // Required. The relative resource name of the organization shared by all of the
+  // settings being retrieved.
+  // Format:
+  //  * `organizations/{organization}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Organization"
+    }
+  ];
+
+  // The names of the settings to retrieve.
+  // A maximum of 1000 settings can be retrieved in a batch.
+  // Formats:
+  //  * `organizations/{organization}/settings`
+  //  * `folders/{folder}/settings`
+  //  * `projects/{project}/settings`
+  //  * `projects/{project}/locations/{location}/clusters/{cluster}/settings`
+  //  * `projects/{project}/regions/{region}/clusters/{cluster}/settings`
+  //  * `projects/{project}/zones/{zone}/clusters/{cluster}/settings`
+  repeated string names = 2;
+}
+
+// Response message for BatchGetSettings.
+message BatchGetSettingsResponse {
+  // Settings requested.
+  repeated Settings settings = 1;
+}
+
+// Request message for CalculateEffectiveSettings.
+message CalculateEffectiveSettingsRequest {
+  // Required. The name of the effective settings to retrieve.
+  // Formats:
+  //  * `organizations/{organization}/effectiveSettings`
+  //  * `folders/{folder}/effectiveSettings`
+  //  * `projects/{project}/effectiveSettings`
+  //  * `projects/{project}/locations/{location}/clusters/{cluster}/effectiveSettings`
+  //  * `projects/{project}/regions/{region}/clusters/{cluster}/effectiveSettings`
+  //  * `projects/{project}/zones/{zone}/clusters/{cluster}/effectiveSettings`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/Settings"
+    }
+  ];
+}
+
+// Request message for BatchGetEffectiveSettings.
+message BatchCalculateEffectiveSettingsRequest {
+  // Required. The relative resource name of the organization shared by all of the
+  // settings being retrieved.
+  // Format:
+  //  * `organizations/{organization}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Organization"
+    }
+  ];
+
+  // The requests specifying the effective settings to retrieve.
+  // A maximum of 1000 effective settings can be retrieved in a batch.
+  repeated CalculateEffectiveSettingsRequest requests = 2;
+}
+
+// Response message for BatchGetEffectiveSettings.
+message BatchCalculateEffectiveSettingsResponse {
+  // Settings requested.
+  repeated Settings settings = 1;
+}
+
+// Request message for GetComponentSettings.
+message GetComponentSettingsRequest {
+  // Required. The component settings to retrieve.
+  //
+  // Formats:
+  //  * `organizations/{organization}/components/{component}/settings`
+  //  * `folders/{folder}/components/{component}/settings`
+  //  * `projects/{project}/components/{component}/settings`
+  //  * `projects/{project}/locations/{location}/clusters/{cluster}/components/{component}/settings`
+  //  * `projects/{project}/regions/{region}/clusters/{cluster}/components/{component}/settings`
+  //  * `projects/{project}/zones/{zone}/clusters/{cluster}/components/{component}/settings`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/ComponentSettings"
+    }
+  ];
+}
+
+// Request message for UpdateComponentSettings.
+message UpdateComponentSettingsRequest {
+  // Required. The component settings to update.
+  //
+  // The component settings' `name` field is used to identify the component
+  // settings to be updated. Formats:
+  //  * `organizations/{organization}/components/{component}/settings`
+  //  * `folders/{folder}/components/{component}/settings`
+  //  * `projects/{project}/components/{component}/settings`
+  //  * `projects/{project}/locations/{location}/clusters/{cluster}/components/{component}/settings`
+  //  * `projects/{project}/regions/{region}/clusters/{cluster}/components/{component}/settings`
+  //  * `projects/{project}/zones/{zone}/clusters/{cluster}/components/{component}/settings`
+  ComponentSettings component_settings = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // The list of fields to be updated on the component settings resource.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for ResetComponentSettings.
+message ResetComponentSettingsRequest {
+  // Required. The component settings to reset.
+  //
+  // Formats:
+  //  * `organizations/{organization}/components/{component}/settings`
+  //  * `folders/{folder}/components/{component}/settings`
+  //  * `projects/{project}/components/{component}/settings`
+  //  * `projects/{project}/locations/{location}/clusters/{cluster}/components/{component}/settings`
+  //  * `projects/{project}/regions/{region}/clusters/{cluster}/components/{component}/settings`
+  //  * `projects/{project}/zones/{zone}/clusters/{cluster}/components/{component}/settings`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/ComponentSettings"
+    }
+  ];
+
+  // An fingerprint used for optimistic concurrency. If none is provided,
+  // then the existing settings will be blindly overwritten.
+  string etag = 2;
+}
+
+// Request message for CalculateEffectiveComponentSettings.
+message CalculateEffectiveComponentSettingsRequest {
+  // Required. The effective component settings to retrieve.
+  //
+  // Formats:
+  //  * `organizations/{organization}/components/{component}/settings`
+  //  * `folders/{folder}/components/{component}/settings`
+  //  * `projects/{project}/components/{component}/settings`
+  //  * `projects/{project}/locations/{location}/clusters/{cluster}/components/{component}/settings`
+  //  * `projects/{project}/regions/{region}/clusters/{cluster}/components/{component}/settings`
+  //  * `projects/{project}/zones/{zone}/clusters/{cluster}/components/{component}/settings`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/ComponentSettings"
+    }
+  ];
+}
+
+// Request message for ListDetectors.
+message ListDetectorsRequest {
+  // Required. The parent, which owns this collection of detectors.
+  // Format:
+  //  * `organizations/{organization}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Organization"
+    }
+  ];
+
+  // Filters to apply on the response. Filters can be applied on:
+  //  * components
+  //  * labels
+  //  * billing tiers
+  //
+  // Component filters will retrieve only detectors for the components
+  // specified. Label filters will retrieve only detectors that match one of the
+  // labels specified. Billing tier filters will retrieve only detectors for
+  // that billing tier.
+  //
+  // The filters
+  string filter = 2;
+
+  // The maximum number of detectors to return. The service may return fewer
+  // than this value. If unspecified, at most 100 detectors will be returned.
+  // The maximum value is 1000; values above 1000 will be coerced to 1000.
+  int32 page_size = 3;
+
+  // A page token, received from a previous `ListDetectors` call.
+  // Provide this to retrieve the subsequent page.
+  //
+  // When paginating, all other parameters provided to `ListDetectors` must
+  // match the call that provided the page token.
+  string page_token = 4;
+}
+
+// Response message for ListDetectors.
+message ListDetectorsResponse {
+  // The detectors from the specified organization.
+  repeated Detector detectors = 1;
+
+  // A token that can be sent as `page_token` to retrieve the next page.
+  // If this field is omitted, there are no subsequent pages.
+  string next_page_token = 2;
+}
+
+// Request message for ListComponents.
+message ListComponentsRequest {
+  // Required. The parent, which owns this collection of components.
+  // Format:
+  //  * `organizations/{organization}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Organization"
+    }
+  ];
+
+  // The maximum number of components to return. The service may return fewer
+  // than this value. If unspecified, at most 100 components will be returned.
+  // The maximum value is 1000; values above 1000 will be coerced to 1000.
+  int32 page_size = 2;
+
+  // A page token, received from a previous `ListComponents` call.
+  // Provide this to retrieve the subsequent page.
+  //
+  // When paginating, all other parameters provided to `ListComponents` must
+  // match the call that provided the page token.
+  string page_token = 3;
+}
+
+// Response message for ListComponents.
+message ListComponentsResponse {
+  // The components from the specified organization.
+  repeated string components = 1;
+
+  // A token that can be sent as `page_token` to retrieve the next page.
+  // If this field is omitted, there are no subsequent pages.
+  string next_page_token = 2;
+}
diff --git a/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/settings.proto b/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/settings.proto
new file mode 100644
index 000000000..1e99eacca
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/settings.proto
@@ -0,0 +1,121 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.securitycenter.settings.v1beta1;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/securitycenter/settings/v1beta1/billing_settings.proto";
+import "google/cloud/securitycenter/settings/v1beta1/component_settings.proto";
+import "google/cloud/securitycenter/settings/v1beta1/sink_settings.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.SecurityCenter.Settings.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/settings/v1beta1;settings";
+option java_multiple_files = true;
+option java_outer_classname = "SettingsProto";
+option java_package = "com.google.cloud.securitycenter.settings.v1beta1";
+option php_namespace = "Google\\Cloud\\SecurityCenter\\Settings\\V1beta1";
+option ruby_package = "Google::Cloud::SecurityCenter::Settings::V1beta1";
+
+// Common configuration settings for all of Security Center.
+message Settings {
+  option (google.api.resource) = {
+    type: "securitycenter.googleapis.com/Settings"
+    pattern: "organizations/{organization}/settings"
+    pattern: "folders/{folder}/settings"
+    pattern: "projects/{project}/settings"
+    pattern: "projects/{project}/locations/{location}/clusters/{cluster}/settings"
+    pattern: "projects/{project}/regions/{region}/clusters/{cluster}/settings"
+    pattern: "projects/{project}/zones/{zone}/clusters/{cluster}/settings"
+  };
+
+  // The DetectorGroupSettings define the configuration for a detector group.
+  message DetectorGroupSettings {
+    // The state determines if the group is enabled or not.
+    ComponentEnablementState state = 1;
+  }
+
+  // Defines the onboarding states for SCC
+  //
+  // Potentially is just an indicator that a user has reviewed some subset of
+  // our configuration surface, even if it's still currently set to its
+  // API-default state.
+  enum OnboardingState {
+    // No onboarding state has been set. Should not be seen in practice, but
+    // should be functionally equivalent to DISABLED.
+    ONBOARDING_STATE_UNSPECIFIED = 0;
+
+    // SCC is fully on boarded
+    ENABLED = 1;
+
+    // SCC has been disabled after being on boarded
+    DISABLED = 2;
+
+    // SCC's onboarding tier has been explicitly set
+    BILLING_SELECTED = 3;
+
+    // SCC's CTD FindingsProviders have been chosen
+    PROVIDERS_SELECTED = 4;
+
+    // SCC's Service-Resource mappings have been set
+    RESOURCES_SELECTED = 5;
+
+    // SCC's core Service Account was created
+    ORG_SERVICE_ACCOUNT_CREATED = 6;
+  }
+
+  // The relative resource name of the settings resource.
+  // Formats:
+  //  * `organizations/{organization}/settings`
+  //  * `folders/{folder}/settings`
+  //  * `projects/{project}/settings`
+  //  * `projects/{project}/locations/{location}/clusters/{cluster}/settings`
+  //  * `projects/{project}/regions/{region}/clusters/{cluster}/settings`
+  //  * `projects/{project}/zones/{zone}/clusters/{cluster}/settings`
+  string name = 1;
+
+  // Billing settings
+  BillingSettings billing_settings = 2;
+
+  // An enum representing the current on boarding state of SCC.
+  OnboardingState state = 3;
+
+  // Output only. The organization-level service account to be used for security center
+  // components. The component must have permission to "act as" the service
+  // account.
+  string org_service_account = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Sink settings.
+  SinkSettings sink_settings = 6;
+
+  // The settings for detectors and/or scanners.
+  map component_settings = 7;
+
+  // Detector group settings for all Security Center components.
+  // The key is the name of the detector group and the value is the settings for
+  // that group.
+  map detector_group_settings = 8;
+
+  // A fingerprint used for optimistic concurrency. If none is provided
+  // on updates then the existing metadata will be blindly overwritten.
+  string etag = 9;
+
+  // Output only. The time these settings were last updated.
+  google.protobuf.Timestamp update_time = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
diff --git a/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/sink_settings.proto b/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/sink_settings.proto
new file mode 100644
index 000000000..388e375c3
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/settings/v1beta1/sink_settings.proto
@@ -0,0 +1,38 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.securitycenter.settings.v1beta1;
+
+import "google/api/annotations.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.SecurityCenter.Settings.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/settings/v1beta1;settings";
+option java_multiple_files = true;
+option java_outer_classname = "SinkProto";
+option java_package = "com.google.cloud.securitycenter.settings.v1beta1";
+option php_namespace = "Google\\Cloud\\SecurityCenter\\Settings\\V1beta1";
+option ruby_package = "Google::Cloud::SecurityCenter::Settings::V1beta1";
+
+// Sink Settings for Security Command Center
+message SinkSettings {
+  // The resource name of the project to send logs to. This project must be
+  // part of the same organization where the Security Center API is
+  // enabled. The format is `projects/{project}`. If it is empty, we do
+  // not output logs. If a project ID is provided it will be normalized to a
+  // project number.
+  string logging_sink_project = 1;
+}
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1/BUILD.bazel b/third_party/googleapis/google/cloud/securitycenter/v1/BUILD.bazel
new file mode 100644
index 000000000..4b1154c97
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/v1/BUILD.bazel
@@ -0,0 +1,386 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "securitycenter_proto",
+    srcs = [
+        "asset.proto",
+        "finding.proto",
+        "notification_config.proto",
+        "notification_message.proto",
+        "organization_settings.proto",
+        "run_asset_discovery_response.proto",
+        "security_marks.proto",
+        "securitycenter_service.proto",
+        "source.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/iam/v1:iam_policy_proto",
+        "//google/iam/v1:policy_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:struct_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "securitycenter_proto_with_info",
+    deps = [
+        ":securitycenter_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "securitycenter_java_proto",
+    deps = [":securitycenter_proto"],
+)
+
+java_grpc_library(
+    name = "securitycenter_java_grpc",
+    srcs = [":securitycenter_proto"],
+    deps = [":securitycenter_java_proto"],
+)
+
+java_gapic_library(
+    name = "securitycenter_java_gapic",
+    src = ":securitycenter_proto_with_info",
+    gapic_yaml = "securitycenter_gapic.yaml",
+    package = "google.cloud.securitycenter.v1",
+    service_yaml = "securitycenter_v1.yaml",
+    test_deps = [
+        ":securitycenter_java_grpc",
+        "//google/iam/v1:iam_java_grpc",
+    ],
+    deps = [
+        ":securitycenter_java_proto",
+        "//google/iam/v1:iam_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "securitycenter_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.securitycenter.v1.SecurityCenterClientTest",
+    ],
+    runtime_deps = [":securitycenter_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-securitycenter-v1-java",
+    deps = [
+        ":securitycenter_java_gapic",
+        ":securitycenter_java_grpc",
+        ":securitycenter_java_proto",
+        ":securitycenter_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "securitycenter_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1",
+    protos = [":securitycenter_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/iam/v1:iam_go_proto",
+        "//google/longrunning:longrunning_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "securitycenter_go_gapic",
+    srcs = [":securitycenter_proto_with_info"],
+    grpc_service_config = "securitycenter_grpc_service_config.json",
+    importpath = "cloud.google.com/go/securitycenter/apiv1;securitycenter",
+    service_yaml = "securitycenter_v1.yaml",
+    deps = [
+        ":securitycenter_go_proto",
+        "//google/iam/v1:iam_go_proto",
+        "//google/longrunning:longrunning_go_gapic",
+        "//google/longrunning:longrunning_go_proto",
+        "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
+        "@io_bazel_rules_go//proto/wkt:struct_go_proto",
+    ],
+)
+
+go_test(
+    name = "securitycenter_go_gapic_test",
+    srcs = [":securitycenter_go_gapic_srcjar_test"],
+    embed = [":securitycenter_go_gapic"],
+    importpath = "cloud.google.com/go/securitycenter/apiv1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-securitycenter-v1-go",
+    deps = [
+        ":securitycenter_go_gapic",
+        ":securitycenter_go_gapic_srcjar-test.srcjar",
+        ":securitycenter_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "securitycenter_moved_proto",
+    srcs = [":securitycenter_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/iam/v1:iam_policy_proto",
+        "//google/iam/v1:policy_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:struct_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "securitycenter_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":securitycenter_moved_proto"],
+)
+
+py_grpc_library(
+    name = "securitycenter_py_grpc",
+    srcs = [":securitycenter_moved_proto"],
+    deps = [":securitycenter_py_proto"],
+)
+
+py_gapic_library(
+    name = "securitycenter_py_gapic",
+    src = ":securitycenter_proto_with_info",
+    gapic_yaml = "securitycenter_gapic.yaml",
+    package = "google.cloud.securitycenter.v1",
+    service_yaml = "securitycenter_v1.yaml",
+    deps = [
+        ":securitycenter_py_grpc",
+        ":securitycenter_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "securitycenter-v1-py",
+    deps = [
+        ":securitycenter_py_gapic",
+        ":securitycenter_py_grpc",
+        ":securitycenter_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "securitycenter_php_proto",
+    deps = [":securitycenter_proto"],
+)
+
+php_grpc_library(
+    name = "securitycenter_php_grpc",
+    srcs = [":securitycenter_proto"],
+    deps = [":securitycenter_php_proto"],
+)
+
+php_gapic_library(
+    name = "securitycenter_php_gapic",
+    src = ":securitycenter_proto_with_info",
+    gapic_yaml = "securitycenter_gapic.yaml",
+    package = "google.cloud.securitycenter.v1",
+    service_yaml = "securitycenter_v1.yaml",
+    deps = [
+        ":securitycenter_php_grpc",
+        ":securitycenter_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-securitycenter-v1-php",
+    deps = [
+        ":securitycenter_php_gapic",
+        ":securitycenter_php_grpc",
+        ":securitycenter_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "securitycenter_nodejs_gapic",
+    src = ":securitycenter_proto_with_info",
+    gapic_yaml = "securitycenter_gapic.yaml",
+    package = "google.cloud.securitycenter.v1",
+    service_yaml = "securitycenter_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "securitycenter-v1-nodejs",
+    deps = [
+        ":securitycenter_nodejs_gapic",
+        ":securitycenter_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "securitycenter_ruby_proto",
+    deps = [":securitycenter_proto"],
+)
+
+ruby_grpc_library(
+    name = "securitycenter_ruby_grpc",
+    srcs = [":securitycenter_proto"],
+    deps = [":securitycenter_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "securitycenter_ruby_gapic",
+    src = ":securitycenter_proto_with_info",
+    gapic_yaml = "securitycenter_gapic.yaml",
+    package = "google.cloud.securitycenter.v1",
+    service_yaml = "securitycenter_v1.yaml",
+    deps = [
+        ":securitycenter_ruby_grpc",
+        ":securitycenter_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-securitycenter-v1-ruby",
+    deps = [
+        ":securitycenter_ruby_gapic",
+        ":securitycenter_ruby_grpc",
+        ":securitycenter_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "securitycenter_csharp_proto",
+    deps = [":securitycenter_proto"],
+)
+
+csharp_grpc_library(
+    name = "securitycenter_csharp_grpc",
+    srcs = [":securitycenter_proto"],
+    deps = [":securitycenter_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "securitycenter_csharp_gapic",
+    src = ":securitycenter_proto_with_info",
+    gapic_yaml = "securitycenter_gapic.yaml",
+    package = "google.cloud.securitycenter.v1",
+    service_yaml = "securitycenter_v1.yaml",
+    deps = [
+        ":securitycenter_csharp_grpc",
+        ":securitycenter_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-securitycenter-v1-csharp",
+    deps = [
+        ":securitycenter_csharp_gapic",
+        ":securitycenter_csharp_grpc",
+        ":securitycenter_csharp_proto",
+    ],
+)
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1/asset.proto b/third_party/googleapis/google/cloud/securitycenter/v1/asset.proto
index 74ec9b213..b079e5c5d 100644
--- a/third_party/googleapis/google/cloud/securitycenter/v1/asset.proto
+++ b/third_party/googleapis/google/cloud/securitycenter/v1/asset.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,13 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.securitycenter.v1;
 
 import "google/api/annotations.proto";
+import "google/api/resource.proto";
 import "google/cloud/securitycenter/v1/security_marks.proto";
 import "google/protobuf/struct.proto";
 import "google/protobuf/timestamp.proto";
@@ -36,6 +36,11 @@ option ruby_package = "Google::Cloud::SecurityCenter::V1";
 // GCP resource. All modifications to an Asset are only within the context of
 // Cloud SCC and don't affect the referenced GCP resource.
 message Asset {
+  option (google.api.resource) = {
+    type: "securitycenter.googleapis.com/Asset"
+    pattern: "organizations/{organization}/assets/{asset}"
+  };
+
   // Cloud SCC managed properties. These properties are managed by Cloud SCC and
   // cannot be modified by the user.
   message SecurityCenterProperties {
@@ -60,6 +65,15 @@ message Asset {
 
     // Owners of the Google Cloud resource.
     repeated string resource_owners = 5;
+
+    // The user defined display name for this resource.
+    string resource_display_name = 6;
+
+    // The user defined display name for the parent of this resource.
+    string resource_parent_display_name = 7;
+
+    // The user defined display name for the project of this resource.
+    string resource_project_display_name = 8;
   }
 
   // IAM Policy information associated with the GCP resource described by the
@@ -75,7 +89,7 @@ message Asset {
   // The relative resource name of this asset. See:
   // https://cloud.google.com/apis/design/resource_names#relative_resource_name
   // Example:
-  // "organizations/123/assets/456".
+  // "organizations/{organization_id}/assets/{asset_id}".
   string name = 1;
 
   // Cloud SCC managed properties. These properties are managed by
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1/finding.proto b/third_party/googleapis/google/cloud/securitycenter/v1/finding.proto
index e75247e88..9a3261c4c 100644
--- a/third_party/googleapis/google/cloud/securitycenter/v1/finding.proto
+++ b/third_party/googleapis/google/cloud/securitycenter/v1/finding.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,14 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.securitycenter.v1;
 
 import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/securitycenter/v1/security_marks.proto";
 import "google/protobuf/struct.proto";
 import "google/protobuf/timestamp.proto";
@@ -31,11 +32,17 @@ option ruby_package = "Google::Cloud::SecurityCenter::V1";
 
 // Cloud Security Command Center (Cloud SCC) finding.
 //
-// A finding is a record of assessment data (security, risk, health or privacy)
-// ingested into Cloud SCC for presentation, notification, analysis,
-// policy testing, and enforcement. For example, an XSS vulnerability in an
-// App Engine application is a finding.
+// A finding is a record of assessment data like security, risk, health, or
+// privacy, that is ingested into Cloud SCC for presentation, notification,
+// analysis, policy testing, and enforcement. For example, a
+// cross-site scripting (XSS) vulnerability in an App Engine application is a
+// finding.
 message Finding {
+  option (google.api.resource) = {
+    type: "securitycenter.googleapis.com/Finding"
+    pattern: "organizations/{organization}/sources/{source}/findings/{finding}"
+  };
+
   // The state of the finding.
   enum State {
     // Unspecified state.
@@ -52,19 +59,21 @@ message Finding {
   // The relative resource name of this finding. See:
   // https://cloud.google.com/apis/design/resource_names#relative_resource_name
   // Example:
-  // "organizations/123/sources/456/findings/789"
+  // "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}"
   string name = 1;
 
   // The relative resource name of the source the finding belongs to. See:
   // https://cloud.google.com/apis/design/resource_names#relative_resource_name
   // This field is immutable after creation time.
   // For example:
-  // "organizations/123/sources/456"
+  // "organizations/{organization_id}/sources/{source_id}"
   string parent = 2;
 
-  // The full resource name of the Google Cloud Platform (GCP) resource this
-  // finding is for. See:
+  // For findings on Google Cloud Platform (GCP) resources, the full resource
+  // name of the GCP resource this finding is for. See:
   // https://cloud.google.com/apis/design/resource_names#full_resource_name
+  // When the finding is for a non-GCP resource, the resourceName can be a
+  // customer or partner defined string.
   // This field is immutable after creation time.
   string resource_name = 3;
 
@@ -90,11 +99,11 @@ message Finding {
   // Output only. User specified security marks. These marks are entirely
   // managed by the user and come from the SecurityMarks resource that belongs
   // to the finding.
-  SecurityMarks security_marks = 8;
+  SecurityMarks security_marks = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // The time at which the event took place. For example, if the finding
-  // represents an open firewall it would capture the time the open firewall was
-  // detected.
+  // represents an open firewall it would capture the time the detector believes
+  // the firewall became open. The accuracy is determined by the detector.
   google.protobuf.Timestamp event_time = 9;
 
   // The time at which the finding was created in Cloud SCC.
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1/notification_config.proto b/third_party/googleapis/google/cloud/securitycenter/v1/notification_config.proto
new file mode 100644
index 000000000..90bd83c3a
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/v1/notification_config.proto
@@ -0,0 +1,96 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.securitycenter.v1;
+
+import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+
+option csharp_namespace = "Google.Cloud.SecurityCenter.V1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1;securitycenter";
+option java_multiple_files = true;
+option java_outer_classname = "NotificationConfigProto";
+option java_package = "com.google.cloud.securitycenter.v1";
+option php_namespace = "Google\\Cloud\\SecurityCenter\\V1";
+option ruby_package = "Google::Cloud::SecurityCenter::V1";
+option (google.api.resource_definition) = {
+  type: "pubsub.googleapis.com/Topic"
+  pattern: "projects/{project}/topics/{topic}"
+};
+
+// Cloud Security Command Center (Cloud SCC) notification configs.
+//
+// A notification config is a Cloud SCC resource that contains the configuration
+// to send notifications for create/update events of findings, assets and etc.
+message NotificationConfig {
+  option (google.api.resource) = {
+    type: "securitycenter.googleapis.com/NotificationConfig"
+    pattern: "organizations/{organization}/notificationConfigs/{notification_config}"
+  };
+
+  // The config for streaming-based notifications, which send each event as soon
+  // as it is detected.
+  message StreamingConfig {
+    // Expression that defines the filter to apply across create/update events
+    // of assets or findings as specified by the event type. The expression is a
+    // list of zero or more restrictions combined via logical operators `AND`
+    // and `OR`. Parentheses are supported, and `OR` has higher precedence than
+    // `AND`.
+    //
+    // Restrictions have the form `  ` and may have a
+    // `-` character in front of them to indicate negation. The fields map to
+    // those defined in the corresponding resource.
+    //
+    // The supported operators are:
+    //
+    // * `=` for all value types.
+    // * `>`, `<`, `>=`, `<=` for integer values.
+    // * `:`, meaning substring matching, for strings.
+    //
+    // The supported value types are:
+    //
+    // * string literals in quotes.
+    // * integer literals without quotes.
+    // * boolean literals `true` and `false` without quotes.
+    string filter = 1;
+  }
+
+  // The relative resource name of this notification config. See:
+  // https://cloud.google.com/apis/design/resource_names#relative_resource_name
+  // Example:
+  // "organizations/{organization_id}/notificationConfigs/notify_public_bucket".
+  string name = 1;
+
+  // The description of the notification config (max of 1024 characters).
+  string description = 2;
+
+  // The PubSub topic to send notifications to. Its format is
+  // "projects/[project_id]/topics/[topic]".
+  string pubsub_topic = 3 [
+    (google.api.resource_reference) = { type: "pubsub.googleapis.com/Topic" }
+  ];
+
+  // Output only. The service account that needs "pubsub.topics.publish"
+  // permission to publish to the PubSub topic.
+  string service_account = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // The config for triggering notifications.
+  oneof notify_config {
+    // The config for triggering streaming-based notifications.
+    StreamingConfig streaming_config = 5;
+  }
+}
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1/notification_message.proto b/third_party/googleapis/google/cloud/securitycenter/v1/notification_message.proto
new file mode 100644
index 000000000..b9dfb171b
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/v1/notification_message.proto
@@ -0,0 +1,41 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.securitycenter.v1;
+
+import "google/api/annotations.proto";
+import "google/cloud/securitycenter/v1/finding.proto";
+
+option csharp_namespace = "Google.Cloud.SecurityCenter.V1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1;securitycenter";
+option java_multiple_files = true;
+option java_outer_classname = "NotificationMessageProto";
+option java_package = "com.google.cloud.securitycenter.v1";
+option php_namespace = "Google\\Cloud\\SecurityCenter\\V1";
+option ruby_package = "Google::Cloud::SecurityCenter::V1";
+
+// Cloud SCC's Notification
+message NotificationMessage {
+  // Name of the notification config that generated current notification.
+  string notification_config_name = 1;
+
+  // Notification Event.
+  oneof event {
+    // If it's a Finding based notification config, this field will be
+    // populated.
+    Finding finding = 2;
+  }
+}
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1/organization_settings.proto b/third_party/googleapis/google/cloud/securitycenter/v1/organization_settings.proto
index e975e566c..d9d9aed79 100644
--- a/third_party/googleapis/google/cloud/securitycenter/v1/organization_settings.proto
+++ b/third_party/googleapis/google/cloud/securitycenter/v1/organization_settings.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,13 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.securitycenter.v1;
 
 import "google/api/annotations.proto";
+import "google/api/resource.proto";
 
 option csharp_namespace = "Google.Cloud.SecurityCenter.V1";
 option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1;securitycenter";
@@ -29,6 +29,11 @@ option ruby_package = "Google::Cloud::SecurityCenter::V1";
 // User specified settings that are attached to the Cloud Security Command
 // Center (Cloud SCC) organization.
 message OrganizationSettings {
+  option (google.api.resource) = {
+    type: "securitycenter.googleapis.com/OrganizationSettings"
+    pattern: "organizations/{organization}/organizationSettings"
+  };
+
   // The configuration used for Asset Discovery runs.
   message AssetDiscoveryConfig {
     // The mode of inclusion when running Asset Discovery.
@@ -63,7 +68,7 @@ message OrganizationSettings {
   // The relative resource name of the settings. See:
   // https://cloud.google.com/apis/design/resource_names#relative_resource_name
   // Example:
-  // "organizations/123/organizationSettings".
+  // "organizations/{organization_id}/organizationSettings".
   string name = 1;
 
   // A flag that indicates if Asset Discovery should be enabled. If the flag is
@@ -74,6 +79,4 @@ message OrganizationSettings {
 
   // The configuration used for Asset Discovery runs.
   AssetDiscoveryConfig asset_discovery_config = 3;
-
-  reserved 4, 5;
 }
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1/run_asset_discovery_response.proto b/third_party/googleapis/google/cloud/securitycenter/v1/run_asset_discovery_response.proto
index 1cbba38e7..4f09d9c0a 100644
--- a/third_party/googleapis/google/cloud/securitycenter/v1/run_asset_discovery_response.proto
+++ b/third_party/googleapis/google/cloud/securitycenter/v1/run_asset_discovery_response.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,15 +11,13 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.securitycenter.v1;
 
-import "google/protobuf/duration.proto";
-import "google/protobuf/timestamp.proto";
 import "google/api/annotations.proto";
+import "google/protobuf/duration.proto";
 
 option csharp_namespace = "Google.Cloud.SecurityCenter.V1";
 option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1;securitycenter";
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1/security_marks.proto b/third_party/googleapis/google/cloud/securitycenter/v1/security_marks.proto
index 97b3f9377..229aff32d 100644
--- a/third_party/googleapis/google/cloud/securitycenter/v1/security_marks.proto
+++ b/third_party/googleapis/google/cloud/securitycenter/v1/security_marks.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,13 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.securitycenter.v1;
 
 import "google/api/annotations.proto";
+import "google/api/resource.proto";
 
 option csharp_namespace = "Google.Cloud.SecurityCenter.V1";
 option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1;securitycenter";
@@ -31,19 +31,26 @@ option ruby_package = "Google::Cloud::SecurityCenter::V1";
 // SCC organization -- they can be modified and viewed by all users who have
 // proper permissions on the organization.
 message SecurityMarks {
+  option (google.api.resource) = {
+    type: "securitycenter.googleapis.com/SecurityMarks"
+    pattern: "organizations/{organization}/assets/{asset}/securityMarks"
+    pattern: "organizations/{organization}/sources/{source}/findings/{finding}/securityMarks"
+  };
+
   // The relative resource name of the SecurityMarks. See:
   // https://cloud.google.com/apis/design/resource_names#relative_resource_name
   // Examples:
-  // "organizations/123/assets/456/securityMarks"
-  // "organizations/123/sources/456/findings/789/securityMarks".
+  // "organizations/{organization_id}/assets/{asset_id}/securityMarks"
+  // "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}/securityMarks".
   string name = 1;
 
   // Mutable user specified security marks belonging to the parent resource.
   // Constraints are as follows:
-  //   - Keys and values are treated as case insensitive
-  //   - Keys must be between 1 - 256 characters (inclusive)
-  //   - Keys must be letters, numbers, underscores, or dashes
-  //   - Values have leading and trailing whitespace trimmed, remaining
+  //
+  //   * Keys and values are treated as case insensitive
+  //   * Keys must be between 1 - 256 characters (inclusive)
+  //   * Keys must be letters, numbers, underscores, or dashes
+  //   * Values have leading and trailing whitespace trimmed, remaining
   //     characters must be between 1 - 4096 characters (inclusive)
   map marks = 2;
 }
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1/securitycenter_gapic.legacy.yaml b/third_party/googleapis/google/cloud/securitycenter/v1/securitycenter_gapic.legacy.yaml
new file mode 100644
index 000000000..4ad8a0e3b
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/v1/securitycenter_gapic.legacy.yaml
@@ -0,0 +1,478 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.securitycenter.v1
+  python:
+    package_name: google.cloud.securitycenter_v1.gapic
+  go:
+    package_name: cloud.google.com/go/securitycenter/apiv1
+  csharp:
+    package_name: Google.Cloud.SecurityCenter.V1
+  ruby:
+    package_name: Google::Cloud::SecurityCenter::V1
+  php:
+    package_name: Google\Cloud\SecurityCenter\V1
+  nodejs:
+    package_name: security-center.v1
+    domain_layer_location: google-cloud
+# A list of API interface configurations.
+interfaces:
+  # The fully qualified name of the API interface.
+- name: google.cloud.securitycenter.v1.SecurityCenter
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: organizations/{organization}
+    entity_name: organization
+  - name_pattern: organizations/{organization}/organizationSettings
+    entity_name: organization_settings
+  - name_pattern: organizations/{organization}/assets/{asset}
+    entity_name: asset
+  - name_pattern: organizations/{organization}/assets/{asset}/securityMarks
+    entity_name: asset_security_marks
+  - name_pattern: organizations/{organization}/sources/{source}
+    entity_name: source
+  - name_pattern: organizations/{organization}/sources/-
+    entity_name: organization_sources
+  - name_pattern: organizations/{organization}/sources/{source}/findings/{finding}
+    entity_name: finding
+  - name_pattern: organizations/{organization}/sources/{source}/findings/{finding}/securityMarks
+    entity_name: finding_security_marks
+
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 480000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 480000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: CreateSource
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - source
+    required_fields:
+    - parent
+    - source
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    resource_name_treatment: STATIC_TYPES
+    field_name_patterns:
+      parent: organization
+    timeout_millis: 60000
+  - name: CreateFinding
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - finding_id
+        - finding
+    required_fields:
+    - parent
+    - finding_id
+    - finding
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    resource_name_treatment: STATIC_TYPES
+    field_name_patterns:
+      parent: source
+    timeout_millis: 60000
+  - name: GetIamPolicy
+    flattening:
+      groups:
+      - parameters:
+        - resource
+    required_fields:
+    - resource
+    retry_codes_name: idempotent
+    retry_params_name: default
+    resource_name_treatment: STATIC_TYPES
+    field_name_patterns:
+      resource: source
+    timeout_millis: 60000
+  - name: GetOrganizationSettings
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    resource_name_treatment: STATIC_TYPES
+    field_name_patterns:
+      name: organization_settings
+    timeout_millis: 60000
+  - name: GetSource
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    resource_name_treatment: STATIC_TYPES
+    field_name_patterns:
+      name: source
+    timeout_millis: 60000
+  - name: GroupAssets
+    required_fields:
+    - parent
+    - group_by
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: group_by_results
+    retry_codes_name: idempotent
+    retry_params_name: default
+    resource_name_treatment: STATIC_TYPES
+    field_name_patterns:
+      parent: organization
+    timeout_millis: 60000
+  - name: GroupFindings
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - group_by
+    required_fields:
+    - parent
+    - group_by
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: group_by_results
+    retry_codes_name: idempotent
+    retry_params_name: default
+    resource_name_treatment: STATIC_TYPES
+    field_name_patterns:
+      parent: source
+    timeout_millis: 60000
+  - name: ListAssets
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: list_assets_results
+    retry_codes_name: idempotent
+    retry_params_name: default
+    resource_name_treatment: STATIC_TYPES
+    field_name_patterns:
+      parent: organization
+    timeout_millis: 60000
+  - name: ListFindings
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: list_findings_results
+    retry_codes_name: idempotent
+    retry_params_name: default
+    resource_name_treatment: STATIC_TYPES
+    field_name_patterns:
+      parent: source
+    timeout_millis: 60000
+  - name: ListSources
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: sources
+    retry_codes_name: idempotent
+    retry_params_name: default
+    resource_name_treatment: STATIC_TYPES
+    field_name_patterns:
+      parent: organization
+    timeout_millis: 60000
+  - name: RunAssetDiscovery
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    resource_name_treatment: STATIC_TYPES
+    field_name_patterns:
+      parent: organization
+    long_running:
+      return_type: google.cloud.securitycenter.v1.RunAssetDiscoveryResponse
+      metadata_type: google.protobuf.Empty
+      initial_poll_delay_millis: 500
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 5000
+      total_poll_timeout_millis: 300000
+    timeout_millis: 60000
+  - name: SetFindingState
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - state
+        - start_time
+    required_fields:
+    - name
+    - state
+    - start_time
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    resource_name_treatment: STATIC_TYPES
+    field_name_patterns:
+      name: finding
+    timeout_millis: 60000
+  - name: SetIamPolicy
+    flattening:
+      groups:
+      - parameters:
+        - resource
+        - policy
+    required_fields:
+    - resource
+    - policy
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    resource_name_treatment: STATIC_TYPES
+    field_name_patterns:
+      resource: source
+    timeout_millis: 60000
+  - name: TestIamPermissions
+    flattening:
+      groups:
+      - parameters:
+        - resource
+        - permissions
+    required_fields:
+    - resource
+    - permissions
+    retry_codes_name: idempotent
+    retry_params_name: default
+    resource_name_treatment: STATIC_TYPES
+    field_name_patterns:
+      resource: source
+    timeout_millis: 60000
+  - name: UpdateFinding
+    flattening:
+      groups:
+      - parameters:
+        - finding
+    required_fields:
+    - finding
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    resource_name_treatment: STATIC_TYPES
+    field_name_patterns:
+      finding.name: finding
+    timeout_millis: 60000
+  - name: UpdateOrganizationSettings
+    flattening:
+      groups:
+      - parameters:
+        - organization_settings
+    required_fields:
+    - organization_settings
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    resource_name_treatment: STATIC_TYPES
+    field_name_patterns:
+      organization_settings.name: organization_settings
+    timeout_millis: 60000
+  - name: UpdateSource
+    flattening:
+      groups:
+      - parameters:
+        - source
+    required_fields:
+    - source
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    resource_name_treatment: STATIC_TYPES
+    field_name_patterns:
+      source.name: source
+    timeout_millis: 60000
+  - name: UpdateSecurityMarks
+    flattening:
+      groups:
+      - parameters:
+        - security_marks
+    required_fields:
+    - security_marks
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    resource_name_treatment: STATIC_TYPES
+    field_name_patterns:
+      security_marks.name: securitymarks_oneof
+    timeout_millis: 60000
+
+# Mappings for STATIC_TYPES
+# See https://docs.google.com/document/d/1meVVWXYOGRApOH_fKQf48qjce4ewDv_ZiDRClmmCs2w/edit
+#
+collection_oneofs:
+ - oneof_name: securitymarks_oneof
+   collection_names:
+     - asset_security_marks
+     - finding_security_marks
+resource_name_generation:
+- message_name: Asset
+  field_entity_map:
+    name: asset
+- message_name: CreateSourceRequest
+  field_entity_map:
+    parent: organization
+- message_name: CreateFindingRequest
+  field_entity_map:
+    parent: source
+- message_name: Finding
+  field_entity_map:
+    name: finding
+- message_name: google.iam.v1.GetIamPolicyRequest
+  field_entity_map:
+    resource: "*"
+- message_name: GetOrganizationSettingsRequest
+  field_entity_map:
+    name: organization_settings
+- message_name: GetSourceRequest
+  field_entity_map:
+    name: source
+- message_name: GroupAssetsRequest
+  field_entity_map:
+    parent: organization
+- message_name: GroupFindingsRequest
+  field_entity_map:
+    parent: source
+- message_name: ListAssetsRequest
+  field_entity_map:
+    parent: organization
+- message_name: ListFindingsRequest
+  field_entity_map:
+    parent: source
+- message_name: ListSourcesRequest
+  field_entity_map:
+    parent: organization
+- message_name: RunAssetDiscoveryRequest
+  field_entity_map:
+    parent: organization
+- message_name: SetFindingStateRequest
+  field_entity_map:
+    name: finding
+- message_name: google.iam.v1.SetIamPolicyRequest
+  field_entity_map:
+    resource: "*"
+- message_name: Source
+  field_entity_map:
+    name: source
+- message_name: google.iam.v1.TestIamPermissionsRequest
+  field_entity_map:
+    resource: "*"
+- message_name: UpdateFindingRequest
+  field_entity_map:
+    name: finding
+- message_name: UpdateOrganizationSettingsRequest
+  field_entity_map:
+    name: organization_settings
+- message_name: UpdateSourceRequest
+  field_entity_map:
+    name: source
+- message_name: UpdateSecurityMarksRequest
+  field_entity_map:
+    name: securitymarks_oneof
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1/securitycenter_gapic.yaml b/third_party/googleapis/google/cloud/securitycenter/v1/securitycenter_gapic.yaml
index 248968254..c9ab2f3f2 100644
--- a/third_party/googleapis/google/cloud/securitycenter/v1/securitycenter_gapic.yaml
+++ b/third_party/googleapis/google/cloud/securitycenter/v1/securitycenter_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -19,460 +19,28 @@ language_settings:
     domain_layer_location: google-cloud
 # A list of API interface configurations.
 interfaces:
-  # The fully qualified name of the API interface.
+# The fully qualified name of the API interface.
 - name: google.cloud.securitycenter.v1.SecurityCenter
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections:
-  - name_pattern: organizations/{organization}
-    entity_name: organization
-  - name_pattern: organizations/{organization}/organizationSettings
-    entity_name: organization_settings
-  - name_pattern: organizations/{organization}/assets/{asset}
-    entity_name: asset
+  deprecated_collections:
   - name_pattern: organizations/{organization}/assets/{asset}/securityMarks
     entity_name: asset_security_marks
-  - name_pattern: organizations/{organization}/sources/{source}
-    entity_name: source
-  - name_pattern: organizations/{organization}/sources/-
-    entity_name: organization_sources
-  - name_pattern: organizations/{organization}/sources/{source}/findings/{finding}
-    entity_name: finding
   - name_pattern: organizations/{organization}/sources/{source}/findings/{finding}/securityMarks
     entity_name: finding_security_marks
-
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 100
     retry_delay_multiplier: 1.3
     max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
+    initial_rpc_timeout_millis: 480000
     rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
+    max_rpc_timeout_millis: 480000
     total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
   methods:
-  - name: CreateSource
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - source
-    required_fields:
-    - parent
-    - source
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    resource_name_treatment: STATIC_TYPES
-    field_name_patterns:
-      parent: organization
-    timeout_millis: 60000
-  - name: CreateFinding
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - finding_id
-        - finding
-    required_fields:
-    - parent
-    - finding_id
-    - finding
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    resource_name_treatment: STATIC_TYPES
-    field_name_patterns:
-      parent: source
-    timeout_millis: 60000
   - name: GetIamPolicy
-    flattening:
-      groups:
-      - parameters:
-        - resource
-    required_fields:
-    - resource
     retry_codes_name: idempotent
-    retry_params_name: default
-    resource_name_treatment: STATIC_TYPES
-    field_name_patterns:
-      resource: source
-    timeout_millis: 60000
-  - name: GetOrganizationSettings
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    resource_name_treatment: STATIC_TYPES
-    field_name_patterns:
-      name: organization_settings
-    timeout_millis: 60000
-  - name: GetSource
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    resource_name_treatment: STATIC_TYPES
-    field_name_patterns:
-      name: source
-    timeout_millis: 60000
   - name: GroupAssets
-    required_fields:
-    - parent
-    - group_by
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: group_by_results
     retry_codes_name: idempotent
-    retry_params_name: default
-    resource_name_treatment: STATIC_TYPES
-    field_name_patterns:
-      parent: organization
-    timeout_millis: 60000
   - name: GroupFindings
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - group_by
-    required_fields:
-    - parent
-    - group_by
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: group_by_results
-    retry_codes_name: idempotent
-    retry_params_name: default
-    resource_name_treatment: STATIC_TYPES
-    field_name_patterns:
-      parent: source
-    timeout_millis: 60000
-  - name: ListAssets
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: list_assets_results
-    retry_codes_name: idempotent
-    retry_params_name: default
-    resource_name_treatment: STATIC_TYPES
-    field_name_patterns:
-      parent: organization
-    timeout_millis: 60000
-  - name: ListFindings
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: list_findings_results
-    retry_codes_name: idempotent
-    retry_params_name: default
-    resource_name_treatment: STATIC_TYPES
-    field_name_patterns:
-      parent: source
-    timeout_millis: 60000
-  - name: ListSources
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: sources
     retry_codes_name: idempotent
-    retry_params_name: default
-    resource_name_treatment: STATIC_TYPES
-    field_name_patterns:
-      parent: organization
-    timeout_millis: 60000
-  - name: RunAssetDiscovery
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    resource_name_treatment: STATIC_TYPES
-    field_name_patterns:
-      parent: organization
-    long_running:
-      return_type: google.cloud.securitycenter.v1.RunAssetDiscoveryResponse
-      metadata_type: google.protobuf.Empty
-      initial_poll_delay_millis: 500
-      poll_delay_multiplier: 1.5
-      max_poll_delay_millis: 5000
-      total_poll_timeout_millis: 300000
-    timeout_millis: 60000
-  - name: SetFindingState
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - state
-        - start_time
-    required_fields:
-    - name
-    - state
-    - start_time
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    resource_name_treatment: STATIC_TYPES
-    field_name_patterns:
-      name: finding
-    timeout_millis: 60000
-  - name: SetIamPolicy
-    flattening:
-      groups:
-      - parameters:
-        - resource
-        - policy
-    required_fields:
-    - resource
-    - policy
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    resource_name_treatment: STATIC_TYPES
-    field_name_patterns:
-      resource: source
-    timeout_millis: 60000
   - name: TestIamPermissions
-    flattening:
-      groups:
-      - parameters:
-        - resource
-        - permissions
-    required_fields:
-    - resource
-    - permissions
     retry_codes_name: idempotent
-    retry_params_name: default
-    resource_name_treatment: STATIC_TYPES
-    field_name_patterns:
-      resource: source
-    timeout_millis: 60000
-  - name: UpdateFinding
-    flattening:
-      groups:
-      - parameters:
-        - finding
-    required_fields:
-    - finding
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    resource_name_treatment: STATIC_TYPES
-    field_name_patterns:
-      finding.name: finding
-    timeout_millis: 60000
-  - name: UpdateOrganizationSettings
-    flattening:
-      groups:
-      - parameters:
-        - organization_settings
-    required_fields:
-    - organization_settings
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    resource_name_treatment: STATIC_TYPES
-    field_name_patterns:
-      organization_settings.name: organization_settings
-    timeout_millis: 60000
-  - name: UpdateSource
-    flattening:
-      groups:
-      - parameters:
-        - source
-    required_fields:
-    - source
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    resource_name_treatment: STATIC_TYPES
-    field_name_patterns:
-      source.name: source
-    timeout_millis: 60000
-  - name: UpdateSecurityMarks
-    flattening:
-      groups:
-      - parameters:
-        - security_marks
-    required_fields:
-    - security_marks
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    resource_name_treatment: STATIC_TYPES
-    field_name_patterns:
-      security_marks.name: securitymarks_oneof
-    timeout_millis: 60000
-
-# Mappings for STATIC_TYPES
-# See https://docs.google.com/document/d/1meVVWXYOGRApOH_fKQf48qjce4ewDv_ZiDRClmmCs2w/edit
-#
-collection_oneofs:
- - oneof_name: securitymarks_oneof
-   collection_names:
-     - asset_security_marks
-     - finding_security_marks
-resource_name_generation:
-- message_name: Asset
-  field_entity_map:
-    name: asset
-- message_name: CreateSourceRequest
-  field_entity_map:
-    parent: organization
-- message_name: CreateFindingRequest
-  field_entity_map:
-    parent: source
-- message_name: Finding
-  field_entity_map:
-    name: finding
-- message_name: google.iam.v1.GetIamPolicyRequest
-  field_entity_map:
-    resource: "*"
-- message_name: GetOrganizationSettingsRequest
-  field_entity_map:
-    name: organization_settings
-- message_name: GetSourceRequest
-  field_entity_map:
-    name: source
-- message_name: GroupAssetsRequest
-  field_entity_map:
-    parent: organization
-- message_name: GroupFindingsRequest
-  field_entity_map:
-    parent: source
-- message_name: ListAssetsRequest
-  field_entity_map:
-    parent: organization
-- message_name: ListFindingsRequest
-  field_entity_map:
-    parent: source
-- message_name: ListSourcesRequest
-  field_entity_map:
-    parent: organization
-- message_name: RunAssetDiscoveryRequest
-  field_entity_map:
-    parent: organization
-- message_name: SetFindingStateRequest
-  field_entity_map:
-    name: finding
-- message_name: google.iam.v1.SetIamPolicyRequest
-  field_entity_map:
-    resource: "*"
-- message_name: Source
-  field_entity_map:
-    name: source
-- message_name: google.iam.v1.TestIamPermissionsRequest
-  field_entity_map:
-    resource: "*"
-- message_name: UpdateFindingRequest
-  field_entity_map:
-    name: finding
-- message_name: UpdateOrganizationSettingsRequest
-  field_entity_map:
-    name: organization_settings
-- message_name: UpdateSourceRequest
-  field_entity_map:
-    name: source
-- message_name: UpdateSecurityMarksRequest
-  field_entity_map:
-    name: securitymarks_oneof
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1/securitycenter_grpc_service_config.json b/third_party/googleapis/google/cloud/securitycenter/v1/securitycenter_grpc_service_config.json
new file mode 100755
index 000000000..1633464c6
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/v1/securitycenter_grpc_service_config.json
@@ -0,0 +1,116 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.securitycenter.v1.SecurityCenter",
+          "method": "CreateSource"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1.SecurityCenter",
+          "method": "CreateFinding"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1.SecurityCenter",
+          "method": "CreateNotificationConfig"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1.SecurityCenter",
+          "method": "DeleteNotificationConfig"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1.SecurityCenter",
+          "method": "RunAssetDiscovery"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1.SecurityCenter",
+          "method": "SetFindingState"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1.SecurityCenter",
+          "method": "SetIamPolicy"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1.SecurityCenter",
+          "method": "UpdateFinding"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1.SecurityCenter",
+          "method": "UpdateNotificationConfig"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1.SecurityCenter",
+          "method": "UpdateOrganizationSettings"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1.SecurityCenter",
+          "method": "UpdateSource"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1.SecurityCenter",
+          "method": "UpdateSecurityMarks"
+        }
+      ],
+      "timeout": "60s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.securitycenter.v1.SecurityCenter",
+          "method": "GetIamPolicy"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1.SecurityCenter",
+          "method": "GetNotificationConfig"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1.SecurityCenter",
+          "method": "GetOrganizationSettings"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1.SecurityCenter",
+          "method": "GetSource"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1.SecurityCenter",
+          "method": "GroupAssets"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1.SecurityCenter",
+          "method": "GroupFindings"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1.SecurityCenter",
+          "method": "ListAssets"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1.SecurityCenter",
+          "method": "ListFindings"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1.SecurityCenter",
+          "method": "ListNotificationConfigs"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1.SecurityCenter",
+          "method": "ListSources"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1.SecurityCenter",
+          "method": "TestIamPermissions"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1/securitycenter_service.proto b/third_party/googleapis/google/cloud/securitycenter/v1/securitycenter_service.proto
index bcb4e863d..bb9a82849 100644
--- a/third_party/googleapis/google/cloud/securitycenter/v1/securitycenter_service.proto
+++ b/third_party/googleapis/google/cloud/securitycenter/v1/securitycenter_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,17 +11,21 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.securitycenter.v1;
 
+import public "google/cloud/securitycenter/v1/run_asset_discovery_response.proto";
+
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/securitycenter/v1/asset.proto";
 import "google/cloud/securitycenter/v1/finding.proto";
+import "google/cloud/securitycenter/v1/notification_config.proto";
 import "google/cloud/securitycenter/v1/organization_settings.proto";
-import "google/cloud/securitycenter/v1/run_asset_discovery_response.proto";
 import "google/cloud/securitycenter/v1/security_marks.proto";
 import "google/cloud/securitycenter/v1/source.proto";
 import "google/iam/v1/iam_policy.proto";
@@ -42,12 +46,17 @@ option ruby_package = "Google::Cloud::SecurityCenter::V1";
 
 // V1 APIs for Security Center service.
 service SecurityCenter {
+  option (google.api.default_host) = "securitycenter.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform";
+
   // Creates a source.
   rpc CreateSource(CreateSourceRequest) returns (Source) {
     option (google.api.http) = {
       post: "/v1/{parent=organizations/*}/sources"
       body: "source"
     };
+    option (google.api.method_signature) = "parent,source";
   }
 
   // Creates a finding. The corresponding source must exist for finding creation
@@ -57,6 +66,28 @@ service SecurityCenter {
       post: "/v1/{parent=organizations/*/sources/*}/findings"
       body: "finding"
     };
+    option (google.api.method_signature) = "parent,finding_id,finding";
+  }
+
+  // Creates a notification config.
+  rpc CreateNotificationConfig(CreateNotificationConfigRequest)
+      returns (NotificationConfig) {
+    option (google.api.http) = {
+      post: "/v1/{parent=organizations/*}/notificationConfigs"
+      body: "notification_config"
+    };
+    option (google.api.method_signature) =
+        "parent,config_id,notification_config";
+    option (google.api.method_signature) = "parent,notification_config";
+  }
+
+  // Deletes a notification config.
+  rpc DeleteNotificationConfig(DeleteNotificationConfigRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=organizations/*/notificationConfigs/*}"
+    };
+    option (google.api.method_signature) = "name";
   }
 
   // Gets the access control policy on the specified Source.
@@ -66,6 +97,16 @@ service SecurityCenter {
       post: "/v1/{resource=organizations/*/sources/*}:getIamPolicy"
       body: "*"
     };
+    option (google.api.method_signature) = "resource";
+  }
+
+  // Gets a notification config.
+  rpc GetNotificationConfig(GetNotificationConfigRequest)
+      returns (NotificationConfig) {
+    option (google.api.http) = {
+      get: "/v1/{name=organizations/*/notificationConfigs/*}"
+    };
+    option (google.api.method_signature) = "name";
   }
 
   // Gets the settings for an organization.
@@ -74,6 +115,7 @@ service SecurityCenter {
     option (google.api.http) = {
       get: "/v1/{name=organizations/*/organizationSettings}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Gets a source.
@@ -81,6 +123,7 @@ service SecurityCenter {
     option (google.api.http) = {
       get: "/v1/{name=organizations/*/sources/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Filters an organization's assets and  groups them by their specified
@@ -96,12 +139,13 @@ service SecurityCenter {
   // specified properties.
   //
   // To group across all sources provide a `-` as the source id.
-  // Example: /v1/organizations/123/sources/-/findings
+  // Example: /v1/organizations/{organization_id}/sources/-/findings
   rpc GroupFindings(GroupFindingsRequest) returns (GroupFindingsResponse) {
     option (google.api.http) = {
       post: "/v1/{parent=organizations/*/sources/*}/findings:group"
       body: "*"
     };
+    option (google.api.method_signature) = "parent,group_by";
   }
 
   // Lists an organization's assets.
@@ -114,18 +158,28 @@ service SecurityCenter {
   // Lists an organization or source's findings.
   //
   // To list across all sources provide a `-` as the source id.
-  // Example: /v1/organizations/123/sources/-/findings
+  // Example: /v1/organizations/{organization_id}/sources/-/findings
   rpc ListFindings(ListFindingsRequest) returns (ListFindingsResponse) {
     option (google.api.http) = {
       get: "/v1/{parent=organizations/*/sources/*}/findings"
     };
   }
 
+  // Lists notification configs.
+  rpc ListNotificationConfigs(ListNotificationConfigsRequest)
+      returns (ListNotificationConfigsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=organizations/*}/notificationConfigs"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
   // Lists all sources belonging to an organization.
   rpc ListSources(ListSourcesRequest) returns (ListSourcesResponse) {
     option (google.api.http) = {
       get: "/v1/{parent=organizations/*}/sources"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Runs asset discovery. The discovery is tracked with a long-running
@@ -140,6 +194,11 @@ service SecurityCenter {
       post: "/v1/{parent=organizations/*}/assets:runDiscovery"
       body: "*"
     };
+    option (google.api.method_signature) = "parent";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.cloud.securitycenter.v1.RunAssetDiscoveryResponse"
+      metadata_type: "google.protobuf.Empty"
+    };
   }
 
   // Updates the state of a finding.
@@ -148,6 +207,7 @@ service SecurityCenter {
       post: "/v1/{name=organizations/*/sources/*/findings/*}:setState"
       body: "*"
     };
+    option (google.api.method_signature) = "name,state,start_time";
   }
 
   // Sets the access control policy on the specified Source.
@@ -157,6 +217,7 @@ service SecurityCenter {
       post: "/v1/{resource=organizations/*/sources/*}:setIamPolicy"
       body: "*"
     };
+    option (google.api.method_signature) = "resource,policy";
   }
 
   // Returns the permissions that a caller has on the specified source.
@@ -166,6 +227,7 @@ service SecurityCenter {
       post: "/v1/{resource=organizations/*/sources/*}:testIamPermissions"
       body: "*"
     };
+    option (google.api.method_signature) = "resource,permissions";
   }
 
   // Creates or updates a finding. The corresponding source must exist for a
@@ -175,6 +237,19 @@ service SecurityCenter {
       patch: "/v1/{finding.name=organizations/*/sources/*/findings/*}"
       body: "finding"
     };
+    option (google.api.method_signature) = "finding";
+  }
+
+  //
+  // Updates a notification config.
+  rpc UpdateNotificationConfig(UpdateNotificationConfigRequest)
+      returns (NotificationConfig) {
+    option (google.api.http) = {
+      patch: "/v1/{notification_config.name=organizations/*/notificationConfigs/*}"
+      body: "notification_config"
+    };
+    option (google.api.method_signature) = "notification_config";
+    option (google.api.method_signature) = "notification_config,update_mask";
   }
 
   // Updates an organization's settings.
@@ -184,6 +259,7 @@ service SecurityCenter {
       patch: "/v1/{organization_settings.name=organizations/*/organizationSettings}"
       body: "organization_settings"
     };
+    option (google.api.method_signature) = "organization_settings";
   }
 
   // Updates a source.
@@ -192,6 +268,7 @@ service SecurityCenter {
       patch: "/v1/{source.name=organizations/*/sources/*}"
       body: "source"
     };
+    option (google.api.method_signature) = "source";
   }
 
   // Updates security marks.
@@ -204,55 +281,129 @@ service SecurityCenter {
         body: "security_marks"
       }
     };
+    option (google.api.method_signature) = "security_marks";
   }
 }
 
 // Request message for creating a finding.
 message CreateFindingRequest {
-  // Resource name of the new finding's parent. Its format should be
+  // Required. Resource name of the new finding's parent. Its format should be
   // "organizations/[organization_id]/sources/[source_id]".
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/Source"
+    }
+  ];
 
-  // Unique identifier provided by the client within the parent scope.
+  // Required. Unique identifier provided by the client within the parent scope.
   // It must be alphanumeric and less than or equal to 32 characters and
   // greater than 0 characters in length.
-  string finding_id = 2;
+  string finding_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The Finding being created. The name and security_marks will be
+  // ignored as they are both output only fields on this resource.
+  Finding finding = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for creating a notification config.
+message CreateNotificationConfigRequest {
+  // Required. Resource name of the new notification config's parent. Its format
+  // is "organizations/[organization_id]".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Organization"
+    }
+  ];
 
-  // The Finding being created. The name and security_marks will be ignored as
-  // they are both output only fields on this resource.
-  Finding finding = 3;
+  // Required.
+  // Unique identifier provided by the client within the parent scope.
+  // It must be between 1 and 128 characters, and contains alphanumeric
+  // characters, underscores or hyphens only.
+  string config_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The notification config being created. The name and the service
+  // account will be ignored as they are both output only fields on this
+  // resource.
+  NotificationConfig notification_config = 3
+      [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request message for creating a source.
 message CreateSourceRequest {
-  // Resource name of the new source's parent. Its format should be
+  // Required. Resource name of the new source's parent. Its format should be
   // "organizations/[organization_id]".
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Organization"
+    }
+  ];
 
-  // The Source being created, only the display_name and description will be
-  // used. All other fields will be ignored.
-  Source source = 2;
+  // Required. The Source being created, only the display_name and description
+  // will be used. All other fields will be ignored.
+  Source source = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for deleting a notification config.
+message DeleteNotificationConfigRequest {
+  // Required. Name of the notification config to delete. Its format is
+  // "organizations/[organization_id]/notificationConfigs/[config_id]".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/NotificationConfig"
+    }
+  ];
+}
+
+// Request message for getting a notification config.
+message GetNotificationConfigRequest {
+  // Required. Name of the notification config to get. Its format is
+  // "organizations/[organization_id]/notificationConfigs/[config_id]".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/NotificationConfig"
+    }
+  ];
 }
 
 // Request message for getting organization settings.
 message GetOrganizationSettingsRequest {
-  // Name of the organization to get organization settings for. Its format is
-  // "organizations/[organization_id]/organizationSettings".
-  string name = 1;
+  // Required. Name of the organization to get organization settings for. Its
+  // format is "organizations/[organization_id]/organizationSettings".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/OrganizationSettings"
+    }
+  ];
 }
 
 // Request message for getting a source.
 message GetSourceRequest {
-  // Relative resource name of the source. Its format is
+  // Required. Relative resource name of the source. Its format is
   // "organizations/[organization_id]/source/[source_id]".
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/Source"
+    }
+  ];
 }
 
 // Request message for grouping by assets.
 message GroupAssetsRequest {
-  // Name of the organization to groupBy. Its format is
+  // Required. Name of the organization to groupBy. Its format is
   // "organizations/[organization_id]".
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Organization"
+    }
+  ];
 
   // Expression that defines the filter to apply across assets.
   // The expression is a list of zero or more restrictions combined via logical
@@ -281,36 +432,56 @@ message GroupAssetsRequest {
   // * boolean literals `true` and `false` without quotes.
   //
   // The following field and operator combinations are supported:
-  // name | '='
-  // update_time | '>', '<', '>=', '<=', '='
-  // create_time | '>', '<', '>=', '<=', '='
-  // iam_policy.policy_blob | '=', ':'
-  // resource_properties | '=', ':', '>', '<', '>=', '<='
-  // security_marks | '=', ':'
-  // security_center_properties.resource_name | '=', ':'
-  // security_center_properties.resource_type | '=', ':'
-  // security_center_properties.resource_parent | '=', ':'
-  // security_center_properties.resource_project | '=', ':'
-  // security_center_properties.resource_owners | '=', ':'
+  //
+  // * name: `=`
+  // * update_time: `=`, `>`, `<`, `>=`, `<=`
+  //
+  //   Usage: This should be milliseconds since epoch or an RFC3339 string.
+  //   Examples:
+  //     "update_time = \"2019-06-10T16:07:18-07:00\""
+  //     "update_time = 1560208038000"
+  //
+  // * create_time: `=`, `>`, `<`, `>=`, `<=`
+  //
+  //   Usage: This should be milliseconds since epoch or an RFC3339 string.
+  //   Examples:
+  //     "create_time = \"2019-06-10T16:07:18-07:00\""
+  //     "create_time = 1560208038000"
+  //
+  // * iam_policy.policy_blob: `=`, `:`
+  // * resource_properties: `=`, `:`, `>`, `<`, `>=`, `<=`
+  // * security_marks.marks: `=`, `:`
+  // * security_center_properties.resource_name: `=`, `:`
+  // * security_center_properties.resource_display_name: `=`, `:`
+  // * security_center_properties.resource_type: `=`, `:`
+  // * security_center_properties.resource_parent: `=`, `:`
+  // * security_center_properties.resource_parent_display_name: `=`, `:`
+  // * security_center_properties.resource_project: `=`, `:`
+  // * security_center_properties.resource_project_display_name: `=`, `:`
+  // * security_center_properties.resource_owners: `=`, `:`
   //
   // For example, `resource_properties.size = 100` is a valid filter string.
   string filter = 2;
 
-  // Expression that defines what assets fields to use for grouping. The string
-  // value should follow SQL syntax: comma separated list of fields. For
-  // example:
+  // Required. Expression that defines what assets fields to use for grouping.
+  // The string value should follow SQL syntax: comma separated list of fields.
+  // For example:
   // "security_center_properties.resource_project,security_center_properties.project".
   //
   // The following fields are supported when compare_duration is not set:
   //
   // * security_center_properties.resource_project
+  // * security_center_properties.resource_project_display_name
   // * security_center_properties.resource_type
   // * security_center_properties.resource_parent
+  // * security_center_properties.resource_parent_display_name
   //
   // The following fields are supported when compare_duration is set:
   //
   // * security_center_properties.resource_type
-  string group_by = 3;
+  // * security_center_properties.resource_project_display_name
+  // * security_center_properties.resource_parent_display_name
+  string group_by = 3 [(google.api.field_behavior) = REQUIRED];
 
   // When compare_duration is set, the GroupResult's "state_change" property is
   // updated to indicate whether the asset was added, removed, or remained
@@ -355,8 +526,6 @@ message GroupAssetsRequest {
   // The maximum number of results to return in a single response. Default is
   // 10, minimum is 1, maximum is 1000.
   int32 page_size = 8;
-
-  reserved 6;
 }
 
 // Response message for grouping by assets.
@@ -379,11 +548,16 @@ message GroupAssetsResponse {
 
 // Request message for grouping by findings.
 message GroupFindingsRequest {
-  // Name of the source to groupBy. Its format is
+  // Required. Name of the source to groupBy. Its format is
   // "organizations/[organization_id]/sources/[source_id]". To groupBy across
   // all sources provide a source_id of `-`. For example:
-  // organizations/123/sources/-
-  string parent = 1;
+  // organizations/{organization_id}/sources/-
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/Source"
+    }
+  ];
 
   // Expression that defines the filter to apply across findings.
   // The expression is a list of one or more restrictions combined via logical
@@ -410,22 +584,29 @@ message GroupFindingsRequest {
   // * boolean literals `true` and `false` without quotes.
   //
   // The following field and operator combinations are supported:
-  // name | `=`
-  // parent | '=', ':'
-  // resource_name | '=', ':'
-  // state | '=', ':'
-  // category | '=', ':'
-  // external_uri | '=', ':'
-  // event_time | `>`, `<`, `>=`, `<=`
-  // security_marks | '=', ':'
-  // source_properties | '=', ':', `>`, `<`, `>=`, `<=`
+  //
+  // * name: `=`
+  // * parent: `=`, `:`
+  // * resource_name: `=`, `:`
+  // * state: `=`, `:`
+  // * category: `=`, `:`
+  // * external_uri: `=`, `:`
+  // * event_time: `=`, `>`, `<`, `>=`, `<=`
+  //
+  //   Usage: This should be milliseconds since epoch or an RFC3339 string.
+  //   Examples:
+  //     "event_time = \"2019-06-10T16:07:18-07:00\""
+  //     "event_time = 1560208038000"
+  //
+  // * security_marks.marks: `=`, `:`
+  // * source_properties: `=`, `:`, `>`, `<`, `>=`, `<=`
   //
   // For example, `source_properties.size = 100` is a valid filter string.
   string filter = 2;
 
-  // Expression that defines what assets fields to use for grouping (including
-  // `state_change`). The string value should follow SQL syntax: comma separated
-  // list of fields. For example: "parent,resource_name".
+  // Required. Expression that defines what assets fields to use for grouping
+  // (including `state_change`). The string value should follow SQL syntax:
+  // comma separated list of fields. For example: "parent,resource_name".
   //
   // The following fields are supported:
   //
@@ -437,7 +618,7 @@ message GroupFindingsRequest {
   // The following fields are supported when compare_duration is set:
   //
   // * state_change
-  string group_by = 3;
+  string group_by = 3 [(google.api.field_behavior) = REQUIRED];
 
   // Time used as a reference point when filtering findings. The filter is
   // limited to findings existing at the supplied time and their values are
@@ -458,12 +639,18 @@ message GroupFindingsRequest {
   //
   // Possible "state_change" values when compare_duration is specified:
   //
-  // * "CHANGED":   indicates that the finding was present at the start of
-  //                  compare_duration, but changed its state at read_time.
-  // * "UNCHANGED": indicates that the finding was present at the start of
-  //                  compare_duration and did not change state at read_time.
-  // * "ADDED":     indicates that the finding was not present at the start
-  //                  of compare_duration, but was present at read_time.
+  // * "CHANGED":   indicates that the finding was present and matched the given
+  //                  filter at the start of compare_duration, but changed its
+  //                  state at read_time.
+  // * "UNCHANGED": indicates that the finding was present and matched the given
+  //                  filter at the start of compare_duration and did not change
+  //                  state at read_time.
+  // * "ADDED":     indicates that the finding did not match the given filter or
+  //                  was not present at the start of compare_duration, but was
+  //                  present at read_time.
+  // * "REMOVED":   indicates that the finding was present and matched the
+  //                  filter at the start of compare_duration, but did not match
+  //                  the filter at read_time.
   //
   // If compare_duration is not specified, then the only possible state_change
   // is "UNUSED",  which will be the state_change set for all findings present
@@ -481,8 +668,6 @@ message GroupFindingsRequest {
   // The maximum number of results to return in a single response. Default is
   // 10, minimum is 1, maximum is 1000.
   int32 page_size = 8;
-
-  reserved 6;
 }
 
 // Response message for group by findings.
@@ -512,11 +697,47 @@ message GroupResult {
   int64 count = 2;
 }
 
+// Request message for listing notification configs.
+message ListNotificationConfigsRequest {
+  // Required. Name of the organization to list notification configs.
+  // Its format is "organizations/[organization_id]".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Organization"
+    }
+  ];
+
+  // The value returned by the last `ListNotificationConfigsResponse`; indicates
+  // that this is a continuation of a prior `ListNotificationConfigs` call, and
+  // that the system should return the next page of data.
+  string page_token = 2;
+
+  // The maximum number of results to return in a single response. Default is
+  // 10, minimum is 1, maximum is 1000.
+  int32 page_size = 3;
+}
+
+// Response message for listing notification configs.
+message ListNotificationConfigsResponse {
+  // Notification configs belonging to the requested parent.
+  repeated NotificationConfig notification_configs = 1;
+
+  // Token to retrieve the next page of results, or empty if there are no more
+  // results.
+  string next_page_token = 2;
+}
+
 // Request message for listing sources.
 message ListSourcesRequest {
-  // Resource name of the parent of sources to list. Its format should be
-  // "organizations/[organization_id]".
-  string parent = 1;
+  // Required. Resource name of the parent of sources to list. Its format should
+  // be "organizations/[organization_id]".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Organization"
+    }
+  ];
 
   // The value returned by the last `ListSourcesResponse`; indicates
   // that this is a continuation of a prior `ListSources` call, and
@@ -540,9 +761,14 @@ message ListSourcesResponse {
 
 // Request message for listing assets.
 message ListAssetsRequest {
-  // Name of the organization assets should belong to. Its format is
+  // Required. Name of the organization assets should belong to. Its format is
   // "organizations/[organization_id]".
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Organization"
+    }
+  ];
 
   // Expression that defines the filter to apply across assets.
   // The expression is a list of zero or more restrictions combined via logical
@@ -571,16 +797,33 @@ message ListAssetsRequest {
   // * boolean literals `true` and `false` without quotes.
   //
   // The following are the allowed field and operator combinations:
-  // name | `=`
-  // update_time | `>`, `<`, `>=`, `<=`
-  // iam_policy.policy_blob | '=', ':'
-  // resource_properties | '=', ':', `>`, `<`, `>=`, `<=`
-  // security_marks | '=', ':'
-  // security_center_properties.resource_name | '=', ':'
-  // security_center_properties.resource_type | '=', ':'
-  // security_center_properties.resource_parent | '=', ':'
-  // security_center_properties.resource_project | '=', ':'
-  // security_center_properties.resource_owners | '=', ':'
+  //
+  // * name: `=`
+  // * update_time: `=`, `>`, `<`, `>=`, `<=`
+  //
+  //   Usage: This should be milliseconds since epoch or an RFC3339 string.
+  //   Examples:
+  //     "update_time = \"2019-06-10T16:07:18-07:00\""
+  //     "update_time = 1560208038000"
+  //
+  // * create_time: `=`, `>`, `<`, `>=`, `<=`
+  //
+  //   Usage: This should be milliseconds since epoch or an RFC3339 string.
+  //   Examples:
+  //     "create_time = \"2019-06-10T16:07:18-07:00\""
+  //     "create_time = 1560208038000"
+  //
+  // * iam_policy.policy_blob: `=`, `:`
+  // * resource_properties: `=`, `:`, `>`, `<`, `>=`, `<=`
+  // * security_marks.marks: `=`, `:`
+  // * security_center_properties.resource_name: `=`, `:`
+  // * security_center_properties.resource_display_name: `=`, `:`
+  // * security_center_properties.resource_type: `=`, `:`
+  // * security_center_properties.resource_parent: `=`, `:`
+  // * security_center_properties.resource_parent_display_name: `=`, `:`
+  // * security_center_properties.resource_project: `=`, `:`
+  // * security_center_properties.resource_project_display_name: `=`, `:`
+  // * security_center_properties.resource_owners: `=`, `:`
   //
   // For example, `resource_properties.size = 100` is a valid filter string.
   string filter = 2;
@@ -598,10 +841,13 @@ message ListAssetsRequest {
   // name
   // update_time
   // resource_properties
-  // security_marks
+  // security_marks.marks
   // security_center_properties.resource_name
+  // security_center_properties.resource_display_name
   // security_center_properties.resource_parent
+  // security_center_properties.resource_parent_display_name
   // security_center_properties.resource_project
+  // security_center_properties.resource_project_display_name
   // security_center_properties.resource_type
   string order_by = 3;
 
@@ -637,12 +883,10 @@ message ListAssetsRequest {
   // read_time.
   google.protobuf.Duration compare_duration = 5;
 
-  // Optional.
-  //
-  // A field mask to specify the ListAssetsResult fields to be listed in the
-  // response.
-  // An empty field mask will list all fields.
-  google.protobuf.FieldMask field_mask = 7;
+  // Optional. A field mask to specify the ListAssetsResult fields to be listed
+  // in the response. An empty field mask will list all fields.
+  google.protobuf.FieldMask field_mask = 7
+      [(google.api.field_behavior) = OPTIONAL];
 
   // The value returned by the last `ListAssetsResponse`; indicates
   // that this is a continuation of a prior `ListAssets` call, and
@@ -652,8 +896,6 @@ message ListAssetsRequest {
   // The maximum number of results to return in a single response. Default is
   // 10, minimum is 1, maximum is 1000.
   int32 page_size = 9;
-
-  reserved 6;
 }
 
 // Response message for listing assets.
@@ -703,11 +945,16 @@ message ListAssetsResponse {
 
 // Request message for listing findings.
 message ListFindingsRequest {
-  // Name of the source the findings belong to. Its format is
+  // Required. Name of the source the findings belong to. Its format is
   // "organizations/[organization_id]/sources/[source_id]". To list across all
   // sources provide a source_id of `-`. For example:
-  // organizations/123/sources/-
-  string parent = 1;
+  // organizations/{organization_id}/sources/-
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/Source"
+    }
+  ];
 
   // Expression that defines the filter to apply across findings.
   // The expression is a list of one or more restrictions combined via logical
@@ -734,15 +981,22 @@ message ListFindingsRequest {
   // * boolean literals `true` and `false` without quotes.
   //
   // The following field and operator combinations are supported:
-  // name | `=`
-  // parent | '=', ':'
-  // resource_name | '=', ':'
-  // state | '=', ':'
-  // category | '=', ':'
-  // external_uri | '=', ':'
-  // event_time | `>`, `<`, `>=`, `<=`
-  // security_marks | '=', ':'
-  // source_properties | '=', ':', `>`, `<`, `>=`, `<=`
+  //
+  // name: `=`
+  // parent: `=`, `:`
+  // resource_name: `=`, `:`
+  // state: `=`, `:`
+  // category: `=`, `:`
+  // external_uri: `=`, `:`
+  // event_time: `=`, `>`, `<`, `>=`, `<=`
+  //
+  //   Usage: This should be milliseconds since epoch or an RFC3339 string.
+  //   Examples:
+  //     "event_time = \"2019-06-10T16:07:18-07:00\""
+  //     "event_time = 1560208038000"
+  //
+  // security_marks.marks: `=`, `:`
+  // source_properties: `=`, `:`, `>`, `<`, `>=`, `<=`
   //
   // For example, `source_properties.size = 100` is a valid filter string.
   string filter = 2;
@@ -764,7 +1018,7 @@ message ListFindingsRequest {
   // resource_name
   // event_time
   // source_properties
-  // security_marks
+  // security_marks.marks
   string order_by = 3;
 
   // Time used as a reference point when filtering findings. The filter is
@@ -787,23 +1041,28 @@ message ListFindingsRequest {
   //
   // Possible "state_change" values when compare_duration is specified:
   //
-  // * "CHANGED":   indicates that the finding was present at the start of
-  //                  compare_duration, but changed its state at read_time.
-  // * "UNCHANGED": indicates that the finding was present at the start of
-  //                  compare_duration and did not change state at read_time.
-  // * "ADDED":     indicates that the finding was not present at the start
-  //                  of compare_duration, but was present at read_time.
+  // * "CHANGED":   indicates that the finding was present and matched the given
+  //                  filter at the start of compare_duration, but changed its
+  //                  state at read_time.
+  // * "UNCHANGED": indicates that the finding was present and matched the given
+  //                  filter at the start of compare_duration and did not change
+  //                  state at read_time.
+  // * "ADDED":     indicates that the finding did not match the given filter or
+  //                  was not present at the start of compare_duration, but was
+  //                  present at read_time.
+  // * "REMOVED":   indicates that the finding was present and matched the
+  //                  filter at the start of compare_duration, but did not match
+  //                  the filter at read_time.
   //
   // If compare_duration is not specified, then the only possible state_change
   // is "UNUSED", which will be the state_change set for all findings present at
   // read_time.
   google.protobuf.Duration compare_duration = 5;
 
-  // Optional.
-  //
-  // A field mask to specify the Finding fields to be listed in the response.
-  // An empty field mask will list all fields.
-  google.protobuf.FieldMask field_mask = 7;
+  // Optional. A field mask to specify the Finding fields to be listed in the
+  // response. An empty field mask will list all fields.
+  google.protobuf.FieldMask field_mask = 7
+      [(google.api.field_behavior) = OPTIONAL];
 
   // The value returned by the last `ListFindingsResponse`; indicates
   // that this is a continuation of a prior `ListFindings` call, and
@@ -813,14 +1072,32 @@ message ListFindingsRequest {
   // The maximum number of results to return in a single response. Default is
   // 10, minimum is 1, maximum is 1000.
   int32 page_size = 9;
-
-  reserved 6;
 }
 
 // Response message for listing findings.
 message ListFindingsResponse {
   // Result containing the Finding and its StateChange.
   message ListFindingsResult {
+    // Information related to the Google Cloud Platform (GCP) resource that is
+    // associated with this finding.
+    message Resource {
+      // The full resource name of the resource. See:
+      // https://cloud.google.com/apis/design/resource_names#full_resource_name
+      string name = 1;
+
+      // The full resource name of project that the resource belongs to.
+      string project_name = 2;
+
+      // The human readable name of project that the resource belongs to.
+      string project_display_name = 3;
+
+      // The full resource name of resource's parent.
+      string parent_name = 4;
+
+      // The human readable name of resource's parent.
+      string parent_display_name = 5;
+    }
+
     // The change in state of the finding.
     //
     // When querying across two points in time this describes
@@ -854,6 +1131,9 @@ message ListFindingsResponse {
 
     // State change of the finding between the points in time.
     StateChange state_change = 2;
+
+    // Output only. Resource that is associated with this finding.
+    Resource resource = 3;
   }
 
   // Findings matching the list request.
@@ -872,35 +1152,46 @@ message ListFindingsResponse {
 
 // Request message for updating a finding's state.
 message SetFindingStateRequest {
-  // The relative resource name of the finding. See:
+  // Required. The relative resource name of the finding. See:
   // https://cloud.google.com/apis/design/resource_names#relative_resource_name
   // Example:
-  // "organizations/123/sources/456/finding/789".
-  string name = 1;
+  // "organizations/{organization_id}/sources/{source_id}/finding/{finding_id}".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/Finding"
+    }
+  ];
 
-  // The desired State of the finding.
-  Finding.State state = 2;
+  // Required. The desired State of the finding.
+  Finding.State state = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // The time at which the updated state takes effect.
-  google.protobuf.Timestamp start_time = 3;
+  // Required. The time at which the updated state takes effect.
+  google.protobuf.Timestamp start_time = 3
+      [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request message for running asset discovery for an organization.
 message RunAssetDiscoveryRequest {
-  // Name of the organization to run asset discovery for. Its format is
-  // "organizations/[organization_id]".
-  string parent = 1;
+  // Required. Name of the organization to run asset discovery for. Its format
+  // is "organizations/[organization_id]".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Organization"
+    }
+  ];
 }
 
 // Request message for updating or creating a finding.
 message UpdateFindingRequest {
-  // The finding resource to update or create if it does not already exist.
-  // parent, security_marks, and update_time will be ignored.
+  // Required. The finding resource to update or create if it does not already
+  // exist. parent, security_marks, and update_time will be ignored.
   //
   // In the case of creation, the finding id portion of the name must be
   // alphanumeric and less than or equal to 32 characters and greater than 0
   // characters in length.
-  Finding finding = 1;
+  Finding finding = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The FieldMask to use when updating the finding resource. This field should
   // not be specified when creating a finding.
@@ -912,10 +1203,23 @@ message UpdateFindingRequest {
   google.protobuf.FieldMask update_mask = 2;
 }
 
+// Request message for updating a notification config.
+message UpdateNotificationConfigRequest {
+  // Required. The notification config to update.
+  NotificationConfig notification_config = 1
+      [(google.api.field_behavior) = REQUIRED];
+
+  // The FieldMask to use when updating the notification config.
+  //
+  // If empty all mutable fields will be updated.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
 // Request message for updating an organization's settings.
 message UpdateOrganizationSettingsRequest {
-  // The organization settings resource to update.
-  OrganizationSettings organization_settings = 1;
+  // Required. The organization settings resource to update.
+  OrganizationSettings organization_settings = 1
+      [(google.api.field_behavior) = REQUIRED];
 
   // The FieldMask to use when updating the settings resource.
   //
@@ -925,8 +1229,8 @@ message UpdateOrganizationSettingsRequest {
 
 // Request message for updating a source.
 message UpdateSourceRequest {
-  // The source resource to update.
-  Source source = 1;
+  // Required. The source resource to update.
+  Source source = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The FieldMask to use when updating the source resource.
   //
@@ -936,8 +1240,8 @@ message UpdateSourceRequest {
 
 // Request message for updating a SecurityMarks resource.
 message UpdateSecurityMarksRequest {
-  // The security marks resource to update.
-  SecurityMarks security_marks = 1;
+  // Required. The security marks resource to update.
+  SecurityMarks security_marks = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The FieldMask to use when updating the security marks resource.
   //
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1/securitycenter_v1.yaml b/third_party/googleapis/google/cloud/securitycenter/v1/securitycenter_v1.yaml
new file mode 100644
index 000000000..52db2f613
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/v1/securitycenter_v1.yaml
@@ -0,0 +1,49 @@
+type: google.api.Service
+config_version: 3
+name: securitycenter.googleapis.com
+title: Cloud Security Command Center API
+
+apis:
+- name: google.cloud.securitycenter.v1.SecurityCenter
+
+types:
+- name: google.cloud.securitycenter.v1.NotificationMessage
+- name: google.cloud.securitycenter.v1.RunAssetDiscoveryResponse
+
+documentation:
+  summary: |-
+    Cloud Security Command Center API provides access to temporal views of
+    assets and findings within an organization.
+
+backend:
+  rules:
+  - selector: 'google.cloud.securitycenter.v1.SecurityCenter.*'
+    deadline: 480.0
+  - selector: 'google.longrunning.Operations.*'
+    deadline: 60.0
+
+http:
+  rules:
+  - selector: google.longrunning.Operations.ListOperations
+    get: '/v1/{name=organizations/*/operations}'
+
+  - selector: google.longrunning.Operations.GetOperation
+    get: '/v1/{name=organizations/*/operations/*}'
+
+  - selector: google.longrunning.Operations.DeleteOperation
+    delete: '/v1/{name=organizations/*/operations/*}'
+
+  - selector: google.longrunning.Operations.CancelOperation
+    post: '/v1/{name=organizations/*/operations/*}:cancel'
+    body: '*'
+
+authentication:
+  rules:
+  - selector: 'google.cloud.securitycenter.v1.SecurityCenter.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1/source.proto b/third_party/googleapis/google/cloud/securitycenter/v1/source.proto
index 26b0d5a64..6fca821b8 100644
--- a/third_party/googleapis/google/cloud/securitycenter/v1/source.proto
+++ b/third_party/googleapis/google/cloud/securitycenter/v1/source.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,13 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.securitycenter.v1;
 
 import "google/api/annotations.proto";
+import "google/api/resource.proto";
 
 option csharp_namespace = "Google.Cloud.SecurityCenter.V1";
 option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1;securitycenter";
@@ -28,31 +28,33 @@ option ruby_package = "Google::Cloud::SecurityCenter::V1";
 
 // Cloud Security Command Center's (Cloud SCC) finding source. A finding source
 // is an entity or a mechanism that can produce a finding. A source is like a
-// container of findings that come from the same scanner, logger, monitor, etc.
+// container of findings that come from the same scanner, logger, monitor, and
+// other tools.
 message Source {
+  option (google.api.resource) = {
+    type: "securitycenter.googleapis.com/Source"
+    pattern: "organizations/{organization}/sources/{source}"
+  };
+
   // The relative resource name of this source. See:
   // https://cloud.google.com/apis/design/resource_names#relative_resource_name
   // Example:
-  // "organizations/123/sources/456"
+  // "organizations/{organization_id}/sources/{source_id}"
   string name = 1;
 
-  // The source’s display name.
-  // A source’s display name must be unique amongst its siblings, for example,
+  // The source's display name.
+  // A source's display name must be unique amongst its siblings, for example,
   // two sources with the same parent can't share the same display name.
-  // The display name must start and end with a letter or digit, may contain
-  // letters, digits, spaces, hyphens, and underscores, and can be no longer
-  // than 32 characters. This is captured by the regular expression:
-  // [\p{L}\p{N}]({\p{L}\p{N}_- ]{0,30}[\p{L}\p{N}])?.
+  // The display name must have a length between 1 and 64 characters
+  // (inclusive).
   string display_name = 2;
 
   // The description of the source (max of 1024 characters).
   // Example:
-  // "Cloud Security Scanner is a web security scanner for common
+  // "Web Security Scanner is a web security scanner for common
   // vulnerabilities in App Engine applications. It can automatically
   // scan and detect four common vulnerabilities, including cross-site-scripting
   // (XSS), Flash injection, mixed content (HTTP in HTTPS), and
-  // outdated/insecure libraries."
+  // outdated or insecure libraries."
   string description = 3;
-
-  reserved 4;
 }
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/securitycenter/v1beta1/BUILD.bazel
index 6226c357a..2891e7af6 100644
--- a/third_party/googleapis/google/cloud/securitycenter/v1beta1/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/securitycenter/v1beta1/BUILD.bazel
@@ -1,9 +1,12 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
@@ -12,16 +15,19 @@ proto_library(
         "asset.proto",
         "finding.proto",
         "organization_settings.proto",
+        "run_asset_discovery_response.proto",
         "security_marks.proto",
         "securitycenter_service.proto",
         "source.proto",
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
         "//google/iam/v1:iam_policy_proto",
         "//google/iam/v1:policy_proto",
         "//google/longrunning:operations_proto",
-        "//google/rpc:status_proto",
         "@com_google_protobuf//:duration_proto",
         "@com_google_protobuf//:empty_proto",
         "@com_google_protobuf//:field_mask_proto",
@@ -32,7 +38,10 @@ proto_library(
 
 proto_library_with_info(
     name = "securitycenter_proto_with_info",
-    deps = [":securitycenter_proto"],
+    deps = [
+        ":securitycenter_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -40,19 +49,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-    "@com_google_api_grpc_proto_google_iam_v1//jar",
-]
-
 java_proto_library(
     name = "securitycenter_java_proto",
     deps = [":securitycenter_proto"],
@@ -61,48 +64,42 @@ java_proto_library(
 java_grpc_library(
     name = "securitycenter_java_grpc",
     srcs = [":securitycenter_proto"],
-    deps = [":securitycenter_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "securitycenter_resource_name_java_proto",
-    gapic_yaml = "securitycenter_gapic.yaml",
-    deps = [":securitycenter_proto"],
+    deps = [":securitycenter_java_proto"],
 )
 
 java_gapic_library(
     name = "securitycenter_java_gapic",
     src = ":securitycenter_proto_with_info",
     gapic_yaml = "securitycenter_gapic.yaml",
-    service_yaml = "//google/cloud/securitycenter:securitycenter_v1beta1.yaml",
-    test_deps = [":securitycenter_java_grpc"],
+    package = "google.cloud.securitycenter.v1beta1",
+    service_yaml = "securitycenter_v1beta1.yaml",
+    test_deps = [
+        ":securitycenter_java_grpc",
+        "//google/iam/v1:iam_java_grpc",
+    ],
     deps = [
         ":securitycenter_java_proto",
-        "securitycenter_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+        "//google/iam/v1:iam_java_proto",
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
+java_gapic_test(
+    name = "securitycenter_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.securitycenter.v1beta1.SecurityCenterClientTest",
+    ],
     runtime_deps = [":securitycenter_java_gapic_test"],
-) for test_name in [
-    "com.google.cloud.securitycenter.v1beta1.SecurityCenterClientTest",
-]]
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-securitycenter-v1beta1-java",
-    client_deps = [":securitycenter_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":securitycenter_java_gapic_test"],
-    grpc_deps = [":securitycenter_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":securitycenter_java_gapic",
+        ":securitycenter_java_grpc",
         ":securitycenter_java_proto",
         ":securitycenter_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -110,10 +107,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -125,22 +122,24 @@ go_proto_library(
         "//google/api:annotations_go_proto",
         "//google/iam/v1:iam_go_proto",
         "//google/longrunning:longrunning_go_proto",
-        "//google/rpc:status_go_proto",
     ],
 )
 
 go_gapic_library(
     name = "securitycenter_go_gapic",
-    src = ":securitycenter_proto_with_info",
-    gapic_yaml = "securitycenter_gapic.yaml",
-    importpath = "cloud.google.com/go/securitycenter/apiv1beta1",
-    service_yaml = "//google/cloud/securitycenter:securitycenter_v1beta1.yaml",
+    srcs = [":securitycenter_proto_with_info"],
+    grpc_service_config = "securitycenter_grpc_service_config.json",
+    importpath = "cloud.google.com/go/securitycenter/apiv1beta1;securitycenter",
+    service_yaml = "securitycenter_v1beta1.yaml",
     deps = [
         ":securitycenter_go_proto",
         "//google/iam/v1:iam_go_proto",
         "//google/longrunning:longrunning_go_gapic",
         "//google/longrunning:longrunning_go_proto",
         "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
+        "@io_bazel_rules_go//proto/wkt:struct_go_proto",
     ],
 )
 
@@ -151,13 +150,235 @@ go_test(
     importpath = "cloud.google.com/go/securitycenter/apiv1beta1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-securitycenter-v1beta1-go",
     deps = [
         ":securitycenter_go_gapic",
-        ":securitycenter_go_gapic_srcjar-smoke-test.srcjar",
         ":securitycenter_go_gapic_srcjar-test.srcjar",
         ":securitycenter_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "securitycenter_moved_proto",
+    srcs = [":securitycenter_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/iam/v1:iam_policy_proto",
+        "//google/iam/v1:policy_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:struct_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "securitycenter_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":securitycenter_moved_proto"],
+)
+
+py_grpc_library(
+    name = "securitycenter_py_grpc",
+    srcs = [":securitycenter_moved_proto"],
+    deps = [":securitycenter_py_proto"],
+)
+
+py_gapic_library(
+    name = "securitycenter_py_gapic",
+    src = ":securitycenter_proto_with_info",
+    gapic_yaml = "securitycenter_gapic.yaml",
+    package = "google.cloud.securitycenter.v1beta1",
+    service_yaml = "securitycenter_v1beta1.yaml",
+    deps = [
+        ":securitycenter_py_grpc",
+        ":securitycenter_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "securitycenter-v1beta1-py",
+    deps = [
+        ":securitycenter_py_gapic",
+        ":securitycenter_py_grpc",
+        ":securitycenter_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "securitycenter_php_proto",
+    deps = [":securitycenter_proto"],
+)
+
+php_grpc_library(
+    name = "securitycenter_php_grpc",
+    srcs = [":securitycenter_proto"],
+    deps = [":securitycenter_php_proto"],
+)
+
+php_gapic_library(
+    name = "securitycenter_php_gapic",
+    src = ":securitycenter_proto_with_info",
+    gapic_yaml = "securitycenter_gapic.yaml",
+    package = "google.cloud.securitycenter.v1beta1",
+    service_yaml = "securitycenter_v1beta1.yaml",
+    deps = [
+        ":securitycenter_php_grpc",
+        ":securitycenter_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-securitycenter-v1beta1-php",
+    deps = [
+        ":securitycenter_php_gapic",
+        ":securitycenter_php_grpc",
+        ":securitycenter_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "securitycenter_nodejs_gapic",
+    src = ":securitycenter_proto_with_info",
+    gapic_yaml = "securitycenter_gapic.yaml",
+    package = "google.cloud.securitycenter.v1beta1",
+    service_yaml = "securitycenter_v1beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "securitycenter-v1beta1-nodejs",
+    deps = [
+        ":securitycenter_nodejs_gapic",
+        ":securitycenter_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "securitycenter_ruby_proto",
+    deps = [":securitycenter_proto"],
+)
+
+ruby_grpc_library(
+    name = "securitycenter_ruby_grpc",
+    srcs = [":securitycenter_proto"],
+    deps = [":securitycenter_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "securitycenter_ruby_gapic",
+    src = ":securitycenter_proto_with_info",
+    gapic_yaml = "securitycenter_gapic.yaml",
+    package = "google.cloud.securitycenter.v1beta1",
+    service_yaml = "securitycenter_v1beta1.yaml",
+    deps = [
+        ":securitycenter_ruby_grpc",
+        ":securitycenter_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-securitycenter-v1beta1-ruby",
+    deps = [
+        ":securitycenter_ruby_gapic",
+        ":securitycenter_ruby_grpc",
+        ":securitycenter_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "securitycenter_csharp_proto",
+    deps = [":securitycenter_proto"],
+)
+
+csharp_grpc_library(
+    name = "securitycenter_csharp_grpc",
+    srcs = [":securitycenter_proto"],
+    deps = [":securitycenter_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "securitycenter_csharp_gapic",
+    src = ":securitycenter_proto_with_info",
+    gapic_yaml = "securitycenter_gapic.yaml",
+    package = "google.cloud.securitycenter.v1beta1",
+    service_yaml = "securitycenter_v1beta1.yaml",
+    deps = [
+        ":securitycenter_csharp_grpc",
+        ":securitycenter_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-securitycenter-v1beta1-csharp",
+    deps = [
+        ":securitycenter_csharp_gapic",
+        ":securitycenter_csharp_grpc",
+        ":securitycenter_csharp_proto",
+    ],
+)
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1beta1/asset.proto b/third_party/googleapis/google/cloud/securitycenter/v1beta1/asset.proto
index 3dd5b3581..85d0e0900 100644
--- a/third_party/googleapis/google/cloud/securitycenter/v1beta1/asset.proto
+++ b/third_party/googleapis/google/cloud/securitycenter/v1beta1/asset.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -17,10 +17,11 @@ syntax = "proto3";
 
 package google.cloud.securitycenter.v1beta1;
 
-import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
 import "google/cloud/securitycenter/v1beta1/security_marks.proto";
 import "google/protobuf/struct.proto";
 import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1beta1;securitycenter";
 option java_multiple_files = true;
@@ -36,10 +37,10 @@ message Asset {
   // Cloud SCC managed properties. These properties are managed by Cloud SCC and
   // cannot be modified by the user.
   message SecurityCenterProperties {
-    // The full resource name of the GCP resource this asset
+    // Immutable. The full resource name of the GCP resource this asset
     // represents. This field is immutable after create time. See:
     // https://cloud.google.com/apis/design/resource_names#full_resource_name
-    string resource_name = 1;
+    string resource_name = 1 [(google.api.field_behavior) = IMMUTABLE];
 
     // The type of the GCP resource. Examples include: APPLICATION,
     // PROJECT, and ORGANIZATION. This is a case insensitive field defined by
@@ -62,7 +63,7 @@ message Asset {
   // The relative resource name of this asset. See:
   // https://cloud.google.com/apis/design/resource_names#relative_resource_name
   // Example:
-  // "organizations/123/assets/456".
+  // "organizations/{organization_id}/assets/{asset_id}".
   string name = 1;
 
   // Cloud SCC managed properties. These properties are managed by
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1beta1/finding.proto b/third_party/googleapis/google/cloud/securitycenter/v1beta1/finding.proto
index 21dfdd561..e582e6de3 100644
--- a/third_party/googleapis/google/cloud/securitycenter/v1beta1/finding.proto
+++ b/third_party/googleapis/google/cloud/securitycenter/v1beta1/finding.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -17,10 +17,12 @@ syntax = "proto3";
 
 package google.cloud.securitycenter.v1beta1;
 
-import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/securitycenter/v1beta1/security_marks.proto";
 import "google/protobuf/struct.proto";
 import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1beta1;securitycenter";
 option java_multiple_files = true;
@@ -33,6 +35,11 @@ option java_package = "com.google.cloud.securitycenter.v1beta1";
 // policy testing, and enforcement. For example, an XSS vulnerability in an
 // App Engine application is a finding.
 message Finding {
+  option (google.api.resource) = {
+    type: "securitycenter.googleapis.com/Finding"
+    pattern: "organizations/{organization}/sources/{source}/findings/{finding}"
+  };
+
   // The state of the finding.
   enum State {
     // Unspecified state.
@@ -49,19 +56,21 @@ message Finding {
   // The relative resource name of this finding. See:
   // https://cloud.google.com/apis/design/resource_names#relative_resource_name
   // Example:
-  // "organizations/123/sources/456/findings/789"
+  // "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}"
   string name = 1;
 
-  // The relative resource name of the source the finding belongs to. See:
+  // Immutable. The relative resource name of the source the finding belongs to. See:
   // https://cloud.google.com/apis/design/resource_names#relative_resource_name
   // This field is immutable after creation time.
   // For example:
-  // "organizations/123/sources/456"
-  string parent = 2;
+  // "organizations/{organization_id}/sources/{source_id}"
+  string parent = 2 [(google.api.field_behavior) = IMMUTABLE];
 
-  // The full resource name of the Google Cloud Platform (GCP) resource this
-  // finding is for. See:
+  // For findings on Google Cloud Platform (GCP) resources, the full resource
+  // name of the GCP resource this finding is for. See:
   // https://cloud.google.com/apis/design/resource_names#full_resource_name
+  // When the finding is for a non-GCP resource, the resourceName can be a
+  // customer or partner defined string.
   // This field is immutable after creation time.
   string resource_name = 3;
 
@@ -87,11 +96,11 @@ message Finding {
   // Output only. User specified security marks. These marks are entirely
   // managed by the user and come from the SecurityMarks resource that belongs
   // to the finding.
-  SecurityMarks security_marks = 8;
+  SecurityMarks security_marks = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // The time at which the event took place. For example, if the finding
-  // represents an open firewall it would capture the time the open firewall was
-  // detected.
+  // represents an open firewall it would capture the time the detector believes
+  // the firewall became open. The accuracy is determined by the detector.
   google.protobuf.Timestamp event_time = 9;
 
   // The time at which the finding was created in Cloud SCC.
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1beta1/organization_settings.proto b/third_party/googleapis/google/cloud/securitycenter/v1beta1/organization_settings.proto
index ca9be1145..9f7f2b0ed 100644
--- a/third_party/googleapis/google/cloud/securitycenter/v1beta1/organization_settings.proto
+++ b/third_party/googleapis/google/cloud/securitycenter/v1beta1/organization_settings.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -17,6 +17,7 @@ syntax = "proto3";
 
 package google.cloud.securitycenter.v1beta1;
 
+import "google/api/resource.proto";
 import "google/api/annotations.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1beta1;securitycenter";
@@ -26,6 +27,11 @@ option java_package = "com.google.cloud.securitycenter.v1beta1";
 // User specified settings that are attached to the Cloud Security Command
 // Center (Cloud SCC) organization.
 message OrganizationSettings {
+  option (google.api.resource) = {
+    type: "securitycenter.googleapis.com/OrganizationSettings"
+    pattern: "organizations/{organization}/organizationSettings"
+  };
+
   // The configuration used for Asset Discovery runs.
   message AssetDiscoveryConfig {
     // The mode of inclusion when running Asset Discovery.
@@ -60,7 +66,7 @@ message OrganizationSettings {
   // The relative resource name of the settings. See:
   // https://cloud.google.com/apis/design/resource_names#relative_resource_name
   // Example:
-  // "organizations/123/organizationSettings".
+  // "organizations/{organization_id}/organizationSettings".
   string name = 1;
 
   // A flag that indicates if Asset Discovery should be enabled. If the flag is
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1beta1/run_asset_discovery_response.proto b/third_party/googleapis/google/cloud/securitycenter/v1beta1/run_asset_discovery_response.proto
new file mode 100644
index 000000000..53ba02ef0
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/v1beta1/run_asset_discovery_response.proto
@@ -0,0 +1,50 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.securitycenter.v1beta1;
+
+import "google/protobuf/duration.proto";
+import "google/api/annotations.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1beta1;securitycenter";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.securitycenter.v1beta1";
+
+// Response of asset discovery run
+message RunAssetDiscoveryResponse {
+  // The state of an asset discovery run.
+  enum State {
+    // Asset discovery run state was unspecified.
+    STATE_UNSPECIFIED = 0;
+
+    // Asset discovery run completed successfully.
+    COMPLETED = 1;
+
+    // Asset discovery run was cancelled with tasks still pending, as another
+    // run for the same organization was started with a higher priority.
+    SUPERSEDED = 2;
+
+    // Asset discovery run was killed and terminated.
+    TERMINATED = 3;
+  }
+
+  // The state of an asset discovery run.
+  State state = 1;
+
+  // The duration between asset discovery run start and end
+  google.protobuf.Duration duration = 2;
+}
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1beta1/security_marks.proto b/third_party/googleapis/google/cloud/securitycenter/v1beta1/security_marks.proto
index cfcb5f7dc..97baf2479 100644
--- a/third_party/googleapis/google/cloud/securitycenter/v1beta1/security_marks.proto
+++ b/third_party/googleapis/google/cloud/securitycenter/v1beta1/security_marks.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -17,6 +17,7 @@ syntax = "proto3";
 
 package google.cloud.securitycenter.v1beta1;
 
+import "google/api/resource.proto";
 import "google/api/annotations.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1beta1;securitycenter";
@@ -28,18 +29,26 @@ option java_package = "com.google.cloud.securitycenter.v1beta1";
 // SCC organization -- they can be modified and viewed by all users who have
 // proper permissions on the organization.
 message SecurityMarks {
+  option (google.api.resource) = {
+    type: "securitycenter.googleapis.com/SecurityMarks"
+    pattern: "organizations/{organization}/assets/{asset}/securityMarks"
+    pattern: "organizations/{organization}/sources/{source}/findings/{finding}/securityMarks"
+  };
+
   // The relative resource name of the SecurityMarks. See:
   // https://cloud.google.com/apis/design/resource_names#relative_resource_name
   // Examples:
-  // "organizations/123/assets/456/securityMarks"
-  // "organizations/123/sources/456/findings/789/securityMarks".
+  // "organizations/{organization_id}/assets/{asset_id}/securityMarks"
+  // "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}/securityMarks".
   string name = 1;
 
   // Mutable user specified security marks belonging to the parent resource.
   // Constraints are as follows:
-  //   - Keys and values are treated as case insensitive
-  //   - Keys must be alphanumeric and between 1 - 256 characters (inclusive)
-  //   - Values have leading and trailing whitespace trimmed, remaining
+  //
+  //   * Keys and values are treated as case insensitive
+  //   * Keys must be between 1 - 256 characters (inclusive)
+  //   * Keys must be letters, numbers, underscores, or dashes
+  //   * Values have leading and trailing whitespace trimmed, remaining
   //     characters must be between 1 - 4096 characters (inclusive)
   map marks = 2;
 }
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1beta1/securitycenter_grpc_service_config.json b/third_party/googleapis/google/cloud/securitycenter/v1beta1/securitycenter_grpc_service_config.json
new file mode 100755
index 000000000..1b42ae38c
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/v1beta1/securitycenter_grpc_service_config.json
@@ -0,0 +1,96 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.securitycenter.v1beta1.SecurityCenter",
+          "method": "CreateSource"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1beta1.SecurityCenter",
+          "method": "CreateFinding"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1beta1.SecurityCenter",
+          "method": "RunAssetDiscovery"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1beta1.SecurityCenter",
+          "method": "SetFindingState"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1beta1.SecurityCenter",
+          "method": "SetIamPolicy"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1beta1.SecurityCenter",
+          "method": "UpdateFinding"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1beta1.SecurityCenter",
+          "method": "UpdateOrganizationSettings"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1beta1.SecurityCenter",
+          "method": "UpdateSource"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1beta1.SecurityCenter",
+          "method": "UpdateSecurityMarks"
+        }
+      ],
+      "timeout": "60s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.securitycenter.v1beta1.SecurityCenter",
+          "method": "GetIamPolicy"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1beta1.SecurityCenter",
+          "method": "GetOrganizationSettings"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1beta1.SecurityCenter",
+          "method": "GetSource"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1beta1.SecurityCenter",
+          "method": "GroupAssets"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1beta1.SecurityCenter",
+          "method": "GroupFindings"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1beta1.SecurityCenter",
+          "method": "ListAssets"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1beta1.SecurityCenter",
+          "method": "ListFindings"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1beta1.SecurityCenter",
+          "method": "ListSources"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1beta1.SecurityCenter",
+          "method": "TestIamPermissions"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1beta1/securitycenter_service.proto b/third_party/googleapis/google/cloud/securitycenter/v1beta1/securitycenter_service.proto
index dafce562d..ba2edf4ee 100644
--- a/third_party/googleapis/google/cloud/securitycenter/v1beta1/securitycenter_service.proto
+++ b/third_party/googleapis/google/cloud/securitycenter/v1beta1/securitycenter_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,6 +18,9 @@ syntax = "proto3";
 package google.cloud.securitycenter.v1beta1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/securitycenter/v1beta1/asset.proto";
 import "google/cloud/securitycenter/v1beta1/finding.proto";
 import "google/cloud/securitycenter/v1beta1/organization_settings.proto";
@@ -38,12 +41,16 @@ option java_package = "com.google.cloud.securitycenter.v1beta1";
 
 // V1 Beta APIs for Security Center service.
 service SecurityCenter {
+  option (google.api.default_host) = "securitycenter.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Creates a source.
   rpc CreateSource(CreateSourceRequest) returns (Source) {
     option (google.api.http) = {
       post: "/v1beta1/{parent=organizations/*}/sources"
       body: "source"
     };
+    option (google.api.method_signature) = "parent,source";
   }
 
   // Creates a finding. The corresponding source must exist for finding creation
@@ -53,23 +60,24 @@ service SecurityCenter {
       post: "/v1beta1/{parent=organizations/*/sources/*}/findings"
       body: "finding"
     };
+    option (google.api.method_signature) = "parent,finding_id,finding";
   }
 
   // Gets the access control policy on the specified Source.
-  rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest)
-      returns (google.iam.v1.Policy) {
+  rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) returns (google.iam.v1.Policy) {
     option (google.api.http) = {
       post: "/v1beta1/{resource=organizations/*/sources/*}:getIamPolicy"
       body: "*"
     };
+    option (google.api.method_signature) = "resource";
   }
 
   // Gets the settings for an organization.
-  rpc GetOrganizationSettings(GetOrganizationSettingsRequest)
-      returns (OrganizationSettings) {
+  rpc GetOrganizationSettings(GetOrganizationSettingsRequest) returns (OrganizationSettings) {
     option (google.api.http) = {
       get: "/v1beta1/{name=organizations/*/organizationSettings}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Gets a source.
@@ -77,6 +85,7 @@ service SecurityCenter {
     option (google.api.http) = {
       get: "/v1beta1/{name=organizations/*/sources/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Filters an organization's assets and  groups them by their specified
@@ -92,12 +101,13 @@ service SecurityCenter {
   // specified properties.
   //
   // To group across all sources provide a `-` as the source id.
-  // Example: /v1beta1/organizations/123/sources/-/findings
+  // Example: /v1beta1/organizations/{organization_id}/sources/-/findings
   rpc GroupFindings(GroupFindingsRequest) returns (GroupFindingsResponse) {
     option (google.api.http) = {
       post: "/v1beta1/{parent=organizations/*/sources/*}/findings:group"
       body: "*"
     };
+    option (google.api.method_signature) = "parent,group_by";
   }
 
   // Lists an organization's assets.
@@ -110,7 +120,7 @@ service SecurityCenter {
   // Lists an organization or source's findings.
   //
   // To list across all sources provide a `-` as the source id.
-  // Example: /v1beta1/organizations/123/sources/-/findings
+  // Example: /v1beta1/organizations/{organization_id}/sources/-/findings
   rpc ListFindings(ListFindingsRequest) returns (ListFindingsResponse) {
     option (google.api.http) = {
       get: "/v1beta1/{parent=organizations/*/sources/*}/findings"
@@ -122,6 +132,7 @@ service SecurityCenter {
     option (google.api.http) = {
       get: "/v1beta1/{parent=organizations/*}/sources"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Runs asset discovery. The discovery is tracked with a long-running
@@ -130,12 +141,16 @@ service SecurityCenter {
   // This API can only be called with limited frequency for an organization. If
   // it is called too frequently the caller will receive a TOO_MANY_REQUESTS
   // error.
-  rpc RunAssetDiscovery(RunAssetDiscoveryRequest)
-      returns (google.longrunning.Operation) {
+  rpc RunAssetDiscovery(RunAssetDiscoveryRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v1beta1/{parent=organizations/*}/assets:runDiscovery"
       body: "*"
     };
+    option (google.api.method_signature) = "parent";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.protobuf.Empty"
+      metadata_type: "google.protobuf.Empty"
+    };
   }
 
   // Updates the state of a finding.
@@ -144,24 +159,25 @@ service SecurityCenter {
       post: "/v1beta1/{name=organizations/*/sources/*/findings/*}:setState"
       body: "*"
     };
+    option (google.api.method_signature) = "name,state,start_time";
   }
 
   // Sets the access control policy on the specified Source.
-  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest)
-      returns (google.iam.v1.Policy) {
+  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) returns (google.iam.v1.Policy) {
     option (google.api.http) = {
       post: "/v1beta1/{resource=organizations/*/sources/*}:setIamPolicy"
       body: "*"
     };
+    option (google.api.method_signature) = "resource,policy";
   }
 
   // Returns the permissions that a caller has on the specified source.
-  rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest)
-      returns (google.iam.v1.TestIamPermissionsResponse) {
+  rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest) returns (google.iam.v1.TestIamPermissionsResponse) {
     option (google.api.http) = {
       post: "/v1beta1/{resource=organizations/*/sources/*}:testIamPermissions"
       body: "*"
     };
+    option (google.api.method_signature) = "resource,permissions";
   }
 
   // Creates or updates a finding. The corresponding source must exist for a
@@ -171,15 +187,16 @@ service SecurityCenter {
       patch: "/v1beta1/{finding.name=organizations/*/sources/*/findings/*}"
       body: "finding"
     };
+    option (google.api.method_signature) = "finding";
   }
 
   // Updates an organization's settings.
-  rpc UpdateOrganizationSettings(UpdateOrganizationSettingsRequest)
-      returns (OrganizationSettings) {
+  rpc UpdateOrganizationSettings(UpdateOrganizationSettingsRequest) returns (OrganizationSettings) {
     option (google.api.http) = {
       patch: "/v1beta1/{organization_settings.name=organizations/*/organizationSettings}"
       body: "organization_settings"
     };
+    option (google.api.method_signature) = "organization_settings";
   }
 
   // Updates a source.
@@ -188,6 +205,7 @@ service SecurityCenter {
       patch: "/v1beta1/{source.name=organizations/*/sources/*}"
       body: "source"
     };
+    option (google.api.method_signature) = "source";
   }
 
   // Updates security marks.
@@ -200,55 +218,81 @@ service SecurityCenter {
         body: "security_marks"
       }
     };
+    option (google.api.method_signature) = "security_marks";
   }
 }
 
 // Request message for creating a finding.
 message CreateFindingRequest {
-  // Resource name of the new finding's parent. Its format should be
+  // Required. Resource name of the new finding's parent. Its format should be
   // "organizations/[organization_id]/sources/[source_id]".
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/Source"
+    }
+  ];
 
-  // Unique identifier provided by the client within the parent scope.
+  // Required. Unique identifier provided by the client within the parent scope.
   // It must be alphanumeric and less than or equal to 32 characters and
   // greater than 0 characters in length.
-  string finding_id = 2;
+  string finding_id = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // The Finding being created. The name and security_marks will be ignored as
+  // Required. The Finding being created. The name and security_marks will be ignored as
   // they are both output only fields on this resource.
-  Finding finding = 3;
+  Finding finding = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request message for creating a source.
 message CreateSourceRequest {
-  // Resource name of the new source's parent. Its format should be
+  // Required. Resource name of the new source's parent. Its format should be
   // "organizations/[organization_id]".
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Organization"
+    }
+  ];
 
-  // The Source being created, only the display_name and description will be
+  // Required. The Source being created, only the display_name and description will be
   // used. All other fields will be ignored.
-  Source source = 2;
+  Source source = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request message for getting organization settings.
 message GetOrganizationSettingsRequest {
-  // Name of the organization to get organization settings for. Its format is
+  // Required. Name of the organization to get organization settings for. Its format is
   // "organizations/[organization_id]/organizationSettings".
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/OrganizationSettings"
+    }
+  ];
 }
 
 // Request message for getting a source.
 message GetSourceRequest {
-  // Relative resource name of the source. Its format is
+  // Required. Relative resource name of the source. Its format is
   // "organizations/[organization_id]/source/[source_id]".
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/Source"
+    }
+  ];
 }
 
 // Request message for grouping by assets.
 message GroupAssetsRequest {
-  // Name of the organization to groupBy. Its format is
+  // Required. Name of the organization to groupBy. Its format is
   // "organizations/[organization_id]".
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Organization"
+    }
+  ];
 
   // Expression that defines the filter to apply across assets.
   // The expression is a list of zero or more restrictions combined via logical
@@ -279,7 +323,7 @@ message GroupAssetsRequest {
   // For example, `resource_properties.size = 100` is a valid filter string.
   string filter = 2;
 
-  // Expression that defines what assets fields to use for grouping. The string
+  // Required. Expression that defines what assets fields to use for grouping. The string
   // value should follow SQL syntax: comma separated list of fields. For
   // example:
   // "security_center_properties.resource_project,security_center_properties.project".
@@ -293,7 +337,7 @@ message GroupAssetsRequest {
   // The following fields are supported when compare_duration is set:
   //
   // * security_center_properties.resource_type
-  string group_by = 3;
+  string group_by = 3 [(google.api.field_behavior) = REQUIRED];
 
   // When compare_duration is set, the Asset's "state" property is updated to
   // indicate whether the asset was added, removed, or remained present during
@@ -351,11 +395,16 @@ message GroupAssetsResponse {
 
 // Request message for grouping by findings.
 message GroupFindingsRequest {
-  // Name of the source to groupBy. Its format is
+  // Required. Name of the source to groupBy. Its format is
   // "organizations/[organization_id]/sources/[source_id]". To groupBy across
   // all sources provide a source_id of `-`. For example:
-  // organizations/123/sources/-
-  string parent = 1;
+  // organizations/{organization_id}/sources/-
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/Source"
+    }
+  ];
 
   // Expression that defines the filter to apply across findings.
   // The expression is a list of one or more restrictions combined via logical
@@ -384,7 +433,7 @@ message GroupFindingsRequest {
   // For example, `source_properties.size = 100` is a valid filter string.
   string filter = 2;
 
-  // Expression that defines what assets fields to use for grouping (including
+  // Required. Expression that defines what assets fields to use for grouping (including
   // `state`). The string value should follow SQL syntax: comma separated list
   // of fields. For example:
   // "parent,resource_name".
@@ -395,7 +444,7 @@ message GroupFindingsRequest {
   // * category
   // * state
   // * parent
-  string group_by = 3;
+  string group_by = 3 [(google.api.field_behavior) = REQUIRED];
 
   // Time used as a reference point when filtering findings. The filter is
   // limited to findings existing at the supplied time and their values are
@@ -439,9 +488,14 @@ message GroupResult {
 
 // Request message for listing sources.
 message ListSourcesRequest {
-  // Resource name of the parent of sources to list. Its format should be
+  // Required. Resource name of the parent of sources to list. Its format should be
   // "organizations/[organization_id]".
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Organization"
+    }
+  ];
 
   // The value returned by the last `ListSourcesResponse`; indicates
   // that this is a continuation of a prior `ListSources` call, and
@@ -465,9 +519,14 @@ message ListSourcesResponse {
 
 // Request message for listing assets.
 message ListAssetsRequest {
-  // Name of the organization assets should belong to. Its format is
+  // Required. Name of the organization assets should belong to. Its format is
   // "organizations/[organization_id]".
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Organization"
+    }
+  ];
 
   // Expression that defines the filter to apply across assets.
   // The expression is a list of zero or more restrictions combined via logical
@@ -539,12 +598,10 @@ message ListAssetsRequest {
   // "UNUSED", which indicates that the asset is present at read_time.
   google.protobuf.Duration compare_duration = 5;
 
-  // Optional.
-  //
-  // A field mask to specify the ListAssetsResult fields to be listed in the
+  // Optional. A field mask to specify the ListAssetsResult fields to be listed in the
   // response.
   // An empty field mask will list all fields.
-  google.protobuf.FieldMask field_mask = 7;
+  google.protobuf.FieldMask field_mask = 7 [(google.api.field_behavior) = OPTIONAL];
 
   // The value returned by the last `ListAssetsResponse`; indicates
   // that this is a continuation of a prior `ListAssets` call, and
@@ -606,11 +663,16 @@ message ListAssetsResponse {
 
 // Request message for listing findings.
 message ListFindingsRequest {
-  // Name of the source the findings belong to. Its format is
+  // Required. Name of the source the findings belong to. Its format is
   // "organizations/[organization_id]/sources/[source_id]". To list across all
   // sources provide a source_id of `-`. For example:
-  // organizations/123/sources/-
-  string parent = 1;
+  // organizations/{organization_id}/sources/-
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/Source"
+    }
+  ];
 
   // Expression that defines the filter to apply across findings.
   // The expression is a list of one or more restrictions combined via logical
@@ -655,11 +717,9 @@ message ListFindingsRequest {
   // API's version of NOW.
   google.protobuf.Timestamp read_time = 4;
 
-  // Optional.
-  //
-  // A field mask to specify the Finding fields to be listed in the response.
+  // Optional. A field mask to specify the Finding fields to be listed in the response.
   // An empty field mask will list all fields.
-  google.protobuf.FieldMask field_mask = 5;
+  google.protobuf.FieldMask field_mask = 5 [(google.api.field_behavior) = OPTIONAL];
 
   // The value returned by the last `ListFindingsResponse`; indicates
   // that this is a continuation of a prior `ListFindings` call, and
@@ -689,35 +749,45 @@ message ListFindingsResponse {
 
 // Request message for updating a finding's state.
 message SetFindingStateRequest {
-  // The relative resource name of the finding. See:
+  // Required. The relative resource name of the finding. See:
   // https://cloud.google.com/apis/design/resource_names#relative_resource_name
   // Example:
-  // "organizations/123/sources/456/finding/789".
-  string name = 1;
+  // "organizations/{organization_id}/sources/{source_id}/finding/{finding_id}".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/Finding"
+    }
+  ];
 
-  // The desired State of the finding.
-  Finding.State state = 2;
+  // Required. The desired State of the finding.
+  Finding.State state = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // The time at which the updated state takes effect.
-  google.protobuf.Timestamp start_time = 3;
+  // Required. The time at which the updated state takes effect.
+  google.protobuf.Timestamp start_time = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request message for running asset discovery for an organization.
 message RunAssetDiscoveryRequest {
-  // Name of the organization to run asset discovery for. Its format is
+  // Required. Name of the organization to run asset discovery for. Its format is
   // "organizations/[organization_id]".
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Organization"
+    }
+  ];
 }
 
 // Request message for updating or creating a finding.
 message UpdateFindingRequest {
-  // The finding resource to update or create if it does not already exist.
+  // Required. The finding resource to update or create if it does not already exist.
   // parent, security_marks, and update_time will be ignored.
   //
   // In the case of creation, the finding id portion of the name must
   // alphanumeric and less than or equal to 32 characters and greater than 0
   // characters in length.
-  Finding finding = 1;
+  Finding finding = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The FieldMask to use when updating the finding resource. This field should
   // not be specified when creating a finding.
@@ -726,8 +796,8 @@ message UpdateFindingRequest {
 
 // Request message for updating an organization's settings.
 message UpdateOrganizationSettingsRequest {
-  // The organization settings resource to update.
-  OrganizationSettings organization_settings = 1;
+  // Required. The organization settings resource to update.
+  OrganizationSettings organization_settings = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The FieldMask to use when updating the settings resource.
   google.protobuf.FieldMask update_mask = 2;
@@ -735,8 +805,8 @@ message UpdateOrganizationSettingsRequest {
 
 // Request message for updating a source.
 message UpdateSourceRequest {
-  // The source resource to update.
-  Source source = 1;
+  // Required. The source resource to update.
+  Source source = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The FieldMask to use when updating the source resource.
   google.protobuf.FieldMask update_mask = 2;
@@ -744,8 +814,8 @@ message UpdateSourceRequest {
 
 // Request message for updating a SecurityMarks resource.
 message UpdateSecurityMarksRequest {
-  // The security marks resource to update.
-  SecurityMarks security_marks = 1;
+  // Required. The security marks resource to update.
+  SecurityMarks security_marks = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The FieldMask to use when updating the security marks resource.
   google.protobuf.FieldMask update_mask = 2;
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1beta1/securitycenter_v1beta1.yaml b/third_party/googleapis/google/cloud/securitycenter/v1beta1/securitycenter_v1beta1.yaml
new file mode 100644
index 000000000..7bc8e0f23
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/v1beta1/securitycenter_v1beta1.yaml
@@ -0,0 +1,45 @@
+type: google.api.Service
+config_version: 3
+name: securitycenter.googleapis.com
+title: Cloud Security Command Center API
+
+apis:
+- name: google.cloud.securitycenter.v1beta1.SecurityCenter
+
+types:
+- name: google.cloud.securitycenter.v1beta1.RunAssetDiscoveryResponse
+
+documentation:
+  summary: |-
+    Cloud Security Command Center API provides access to temporal views of
+    assets and findings within an organization.
+
+backend:
+  rules:
+  - selector: 'google.cloud.securitycenter.v1beta1.SecurityCenter.*'
+    deadline: 60.0
+  - selector: 'google.longrunning.Operations.*'
+    deadline: 60.0
+
+http:
+  rules:
+  - selector: google.longrunning.Operations.CancelOperation
+    post: '/v1beta1/{name=organizations/*/operations/*}:cancel'
+    body: '*'
+  - selector: google.longrunning.Operations.DeleteOperation
+    delete: '/v1beta1/{name=organizations/*/operations/*}'
+  - selector: google.longrunning.Operations.GetOperation
+    get: '/v1beta1/{name=organizations/*/operations/*}'
+  - selector: google.longrunning.Operations.ListOperations
+    get: '/v1beta1/{name=organizations/*/operations}'
+
+authentication:
+  rules:
+  - selector: 'google.cloud.securitycenter.v1beta1.SecurityCenter.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1beta1/source.proto b/third_party/googleapis/google/cloud/securitycenter/v1beta1/source.proto
index cc1fae6ea..98025bca2 100644
--- a/third_party/googleapis/google/cloud/securitycenter/v1beta1/source.proto
+++ b/third_party/googleapis/google/cloud/securitycenter/v1beta1/source.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -17,6 +17,7 @@ syntax = "proto3";
 
 package google.cloud.securitycenter.v1beta1;
 
+import "google/api/resource.proto";
 import "google/api/annotations.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1beta1;securitycenter";
@@ -27,19 +28,22 @@ option java_package = "com.google.cloud.securitycenter.v1beta1";
 // is an entity or a mechanism that can produce a finding. A source is like a
 // container of findings that come from the same scanner, logger, monitor, etc.
 message Source {
+  option (google.api.resource) = {
+    type: "securitycenter.googleapis.com/Source"
+    pattern: "organizations/{organization}/sources/{source}"
+  };
+
   // The relative resource name of this source. See:
   // https://cloud.google.com/apis/design/resource_names#relative_resource_name
   // Example:
-  // "organizations/123/sources/456"
+  // "organizations/{organization_id}/sources/{source_id}"
   string name = 1;
 
   // The source's display name.
   // A source's display name must be unique amongst its siblings, for example,
   // two sources with the same parent can't share the same display name.
-  // The display name must start and end with a letter or digit, may contain
-  // letters, digits, spaces, hyphens, and underscores, and can be no longer
-  // than 32 characters. This is captured by the regular expression:
-  // [\p{L}\p{N}]({\p{L}\p{N}_- ]{0,30}[\p{L}\p{N}])?.
+  // The display name must have a length between 1 and 64 characters
+  // (inclusive).
   string display_name = 2;
 
   // The description of the source (max of 1024 characters).
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/BUILD.bazel
new file mode 100644
index 000000000..4bfe84008
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/BUILD.bazel
@@ -0,0 +1,386 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "securitycenter_proto",
+    srcs = [
+        "asset.proto",
+        "finding.proto",
+        "notification_config.proto",
+        "notification_message.proto",
+        "organization_settings.proto",
+        "run_asset_discovery_response.proto",
+        "security_marks.proto",
+        "securitycenter_service.proto",
+        "source.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/iam/v1:iam_policy_proto",
+        "//google/iam/v1:policy_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:struct_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "securitycenter_proto_with_info",
+    deps = [
+        ":securitycenter_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "securitycenter_java_proto",
+    deps = [":securitycenter_proto"],
+)
+
+java_grpc_library(
+    name = "securitycenter_java_grpc",
+    srcs = [":securitycenter_proto"],
+    deps = [":securitycenter_java_proto"],
+)
+
+java_gapic_library(
+    name = "securitycenter_java_gapic",
+    src = ":securitycenter_proto_with_info",
+    gapic_yaml = "securitycenter_gapic.yaml",
+    package = "google.cloud.securitycenter.v1p1beta1",
+    service_yaml = "securitycenter_v1p1beta1.yaml",
+    test_deps = [
+        ":securitycenter_java_grpc",
+        "//google/iam/v1:iam_java_grpc",
+    ],
+    deps = [
+        ":securitycenter_java_proto",
+        "//google/iam/v1:iam_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "securitycenter_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.securitycenter.v1p1beta1.SecurityCenterClientTest",
+    ],
+    runtime_deps = [":securitycenter_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-securitycenter-v1p1beta1-java",
+    deps = [
+        ":securitycenter_java_gapic",
+        ":securitycenter_java_grpc",
+        ":securitycenter_java_proto",
+        ":securitycenter_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "securitycenter_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1p1beta1",
+    protos = [":securitycenter_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/iam/v1:iam_go_proto",
+        "//google/longrunning:longrunning_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "securitycenter_go_gapic",
+    srcs = [":securitycenter_proto_with_info"],
+    grpc_service_config = "securitycenter_grpc_service_config.json",
+    importpath = "cloud.google.com/go/securitycenter/apiv1p1beta1;securitycenter",
+    service_yaml = "securitycenter_v1p1beta1.yaml",
+    deps = [
+        ":securitycenter_go_proto",
+        "//google/iam/v1:iam_go_proto",
+        "//google/longrunning:longrunning_go_gapic",
+        "//google/longrunning:longrunning_go_proto",
+        "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
+        "@io_bazel_rules_go//proto/wkt:struct_go_proto",
+    ],
+)
+
+go_test(
+    name = "securitycenter_go_gapic_test",
+    srcs = [":securitycenter_go_gapic_srcjar_test"],
+    embed = [":securitycenter_go_gapic"],
+    importpath = "cloud.google.com/go/securitycenter/apiv1p1beta1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-securitycenter-v1p1beta1-go",
+    deps = [
+        ":securitycenter_go_gapic",
+        ":securitycenter_go_gapic_srcjar-test.srcjar",
+        ":securitycenter_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "securitycenter_moved_proto",
+    srcs = [":securitycenter_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/iam/v1:iam_policy_proto",
+        "//google/iam/v1:policy_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:struct_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "securitycenter_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":securitycenter_moved_proto"],
+)
+
+py_grpc_library(
+    name = "securitycenter_py_grpc",
+    srcs = [":securitycenter_moved_proto"],
+    deps = [":securitycenter_py_proto"],
+)
+
+py_gapic_library(
+    name = "securitycenter_py_gapic",
+    src = ":securitycenter_proto_with_info",
+    gapic_yaml = "securitycenter_gapic.yaml",
+    package = "google.cloud.securitycenter.v1p1beta1",
+    service_yaml = "securitycenter_v1p1beta1.yaml",
+    deps = [
+        ":securitycenter_py_grpc",
+        ":securitycenter_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "securitycenter-v1p1beta1-py",
+    deps = [
+        ":securitycenter_py_gapic",
+        ":securitycenter_py_grpc",
+        ":securitycenter_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "securitycenter_php_proto",
+    deps = [":securitycenter_proto"],
+)
+
+php_grpc_library(
+    name = "securitycenter_php_grpc",
+    srcs = [":securitycenter_proto"],
+    deps = [":securitycenter_php_proto"],
+)
+
+php_gapic_library(
+    name = "securitycenter_php_gapic",
+    src = ":securitycenter_proto_with_info",
+    gapic_yaml = "securitycenter_gapic.yaml",
+    package = "google.cloud.securitycenter.v1p1beta1",
+    service_yaml = "securitycenter_v1p1beta1.yaml",
+    deps = [
+        ":securitycenter_php_grpc",
+        ":securitycenter_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-securitycenter-v1p1beta1-php",
+    deps = [
+        ":securitycenter_php_gapic",
+        ":securitycenter_php_grpc",
+        ":securitycenter_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "securitycenter_nodejs_gapic",
+    src = ":securitycenter_proto_with_info",
+    gapic_yaml = "securitycenter_gapic.yaml",
+    package = "google.cloud.securitycenter.v1p1beta1",
+    service_yaml = "securitycenter_v1p1beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "securitycenter-v1p1beta1-nodejs",
+    deps = [
+        ":securitycenter_nodejs_gapic",
+        ":securitycenter_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "securitycenter_ruby_proto",
+    deps = [":securitycenter_proto"],
+)
+
+ruby_grpc_library(
+    name = "securitycenter_ruby_grpc",
+    srcs = [":securitycenter_proto"],
+    deps = [":securitycenter_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "securitycenter_ruby_gapic",
+    src = ":securitycenter_proto_with_info",
+    gapic_yaml = "securitycenter_gapic.yaml",
+    package = "google.cloud.securitycenter.v1p1beta1",
+    service_yaml = "securitycenter_v1p1beta1.yaml",
+    deps = [
+        ":securitycenter_ruby_grpc",
+        ":securitycenter_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-securitycenter-v1p1beta1-ruby",
+    deps = [
+        ":securitycenter_ruby_gapic",
+        ":securitycenter_ruby_grpc",
+        ":securitycenter_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "securitycenter_csharp_proto",
+    deps = [":securitycenter_proto"],
+)
+
+csharp_grpc_library(
+    name = "securitycenter_csharp_grpc",
+    srcs = [":securitycenter_proto"],
+    deps = [":securitycenter_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "securitycenter_csharp_gapic",
+    src = ":securitycenter_proto_with_info",
+    gapic_yaml = "securitycenter_gapic.yaml",
+    package = "google.cloud.securitycenter.v1p1beta1",
+    service_yaml = "securitycenter_v1p1beta1.yaml",
+    deps = [
+        ":securitycenter_csharp_grpc",
+        ":securitycenter_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-securitycenter-v1p1beta1-csharp",
+    deps = [
+        ":securitycenter_csharp_gapic",
+        ":securitycenter_csharp_grpc",
+        ":securitycenter_csharp_proto",
+    ],
+)
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/asset.proto b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/asset.proto
new file mode 100644
index 000000000..aaa18bcba
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/asset.proto
@@ -0,0 +1,119 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.securitycenter.v1p1beta1;
+
+import "google/api/annotations.proto";
+import "google/api/resource.proto";
+import "google/cloud/securitycenter/v1p1beta1/security_marks.proto";
+import "google/protobuf/struct.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.SecurityCenter.V1P1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1p1beta1;securitycenter";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.securitycenter.v1p1beta1";
+option php_namespace = "Google\\Cloud\\SecurityCenter\\V1p1beta1";
+option ruby_package = "Google::Cloud::SecurityCenter::V1p1beta1";
+
+// Cloud Security Command Center's (Cloud SCC) representation of a Google Cloud
+// Platform (GCP) resource.
+//
+// The Asset is a Cloud SCC resource that captures information about a single
+// GCP resource. All modifications to an Asset are only within the context of
+// Cloud SCC and don't affect the referenced GCP resource.
+message Asset {
+  option (google.api.resource) = {
+    type: "securitycenter.googleapis.com/Asset"
+    pattern: "organizations/{organization}/assets/{asset}"
+  };
+
+  // Cloud SCC managed properties. These properties are managed by Cloud SCC and
+  // cannot be modified by the user.
+  message SecurityCenterProperties {
+    // The full resource name of the GCP resource this asset
+    // represents. This field is immutable after create time. See:
+    // https://cloud.google.com/apis/design/resource_names#full_resource_name
+    string resource_name = 1;
+
+    // The type of the GCP resource. Examples include: APPLICATION,
+    // PROJECT, and ORGANIZATION. This is a case insensitive field defined by
+    // Cloud SCC and/or the producer of the resource and is immutable
+    // after create time.
+    string resource_type = 2;
+
+    // The full resource name of the immediate parent of the resource. See:
+    // https://cloud.google.com/apis/design/resource_names#full_resource_name
+    string resource_parent = 3;
+
+    // The full resource name of the project the resource belongs to. See:
+    // https://cloud.google.com/apis/design/resource_names#full_resource_name
+    string resource_project = 4;
+
+    // Owners of the Google Cloud resource.
+    repeated string resource_owners = 5;
+
+    // The user defined display name for this resource.
+    string resource_display_name = 6;
+
+    // The user defined display name for the parent of this resource.
+    string resource_parent_display_name = 7;
+
+    // The user defined display name for the project of this resource.
+    string resource_project_display_name = 8;
+  }
+
+  // IAM Policy information associated with the GCP resource described by the
+  // Cloud SCC asset. This information is managed and defined by the GCP
+  // resource and cannot be modified by the user.
+  message IamPolicy {
+    // The JSON representation of the Policy associated with the asset.
+    // See https://cloud.google.com/iam/reference/rest/v1/Policy for
+    // format details.
+    string policy_blob = 1;
+  }
+
+  // The relative resource name of this asset. See:
+  // https://cloud.google.com/apis/design/resource_names#relative_resource_name
+  // Example:
+  // "organizations/{organization_id}/assets/{asset_id}".
+  string name = 1;
+
+  // Cloud SCC managed properties. These properties are managed by
+  // Cloud SCC and cannot be modified by the user.
+  SecurityCenterProperties security_center_properties = 2;
+
+  // Resource managed properties. These properties are managed and defined by
+  // the GCP resource and cannot be modified by the user.
+  map resource_properties = 7;
+
+  // User specified security marks. These marks are entirely managed by the user
+  // and come from the SecurityMarks resource that belongs to the asset.
+  SecurityMarks security_marks = 8;
+
+  // The time at which the asset was created in Cloud SCC.
+  google.protobuf.Timestamp create_time = 9;
+
+  // The time at which the asset was last updated, added, or deleted in Cloud
+  // SCC.
+  google.protobuf.Timestamp update_time = 10;
+
+  // IAM Policy information associated with the GCP resource described by the
+  // Cloud SCC asset. This information is managed and defined by the GCP
+  // resource and cannot be modified by the user.
+  IamPolicy iam_policy = 11;
+}
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/finding.proto b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/finding.proto
new file mode 100644
index 000000000..6428027df
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/finding.proto
@@ -0,0 +1,111 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.securitycenter.v1p1beta1;
+
+import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/securitycenter/v1p1beta1/security_marks.proto";
+import "google/protobuf/struct.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.SecurityCenter.V1P1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1p1beta1;securitycenter";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.securitycenter.v1p1beta1";
+option php_namespace = "Google\\Cloud\\SecurityCenter\\V1p1beta1";
+option ruby_package = "Google::Cloud::SecurityCenter::V1p1beta1";
+
+// Cloud Security Command Center (Cloud SCC) finding.
+//
+// A finding is a record of assessment data (security, risk, health or privacy)
+// ingested into Cloud SCC for presentation, notification, analysis,
+// policy testing, and enforcement. For example, an XSS vulnerability in an
+// App Engine application is a finding.
+message Finding {
+  option (google.api.resource) = {
+    type: "securitycenter.googleapis.com/Finding"
+    pattern: "organizations/{organization}/sources/{source}/findings/{finding}"
+  };
+
+  // The state of the finding.
+  enum State {
+    // Unspecified state.
+    STATE_UNSPECIFIED = 0;
+
+    // The finding requires attention and has not been addressed yet.
+    ACTIVE = 1;
+
+    // The finding has been fixed, triaged as a non-issue or otherwise addressed
+    // and is no longer active.
+    INACTIVE = 2;
+  }
+
+  // The relative resource name of this finding. See:
+  // https://cloud.google.com/apis/design/resource_names#relative_resource_name
+  // Example:
+  // "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}"
+  string name = 1;
+
+  // The relative resource name of the source the finding belongs to. See:
+  // https://cloud.google.com/apis/design/resource_names#relative_resource_name
+  // This field is immutable after creation time.
+  // For example:
+  // "organizations/{organization_id}/sources/{source_id}"
+  string parent = 2;
+
+  // For findings on Google Cloud Platform (GCP) resources, the full resource
+  // name of the GCP resource this finding is for. See:
+  // https://cloud.google.com/apis/design/resource_names#full_resource_name
+  // When the finding is for a non-GCP resource, the resourceName can be a
+  // customer or partner defined string.
+  // This field is immutable after creation time.
+  string resource_name = 3;
+
+  // The state of the finding.
+  State state = 4;
+
+  // The additional taxonomy group within findings from a given source.
+  // This field is immutable after creation time.
+  // Example: "XSS_FLASH_INJECTION"
+  string category = 5;
+
+  // The URI that, if available, points to a web page outside of Cloud SCC
+  // where additional information about the finding can be found. This field is
+  // guaranteed to be either empty or a well formed URL.
+  string external_uri = 6;
+
+  // Source specific properties. These properties are managed by the source
+  // that writes the finding. The key names in the source_properties map must be
+  // between 1 and 255 characters, and must start with a letter and contain
+  // alphanumeric characters or underscores only.
+  map source_properties = 7;
+
+  // Output only. User specified security marks. These marks are entirely
+  // managed by the user and come from the SecurityMarks resource that belongs
+  // to the finding.
+  SecurityMarks security_marks = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // The time at which the event took place. For example, if the finding
+  // represents an open firewall it would capture the time the detector believes
+  // the firewall became open. The accuracy is determined by the detector.
+  google.protobuf.Timestamp event_time = 9;
+
+  // The time at which the finding was created in Cloud SCC.
+  google.protobuf.Timestamp create_time = 10;
+}
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/notification_config.proto b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/notification_config.proto
new file mode 100644
index 000000000..7cbb87b24
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/notification_config.proto
@@ -0,0 +1,112 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.securitycenter.v1p1beta1;
+
+import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+
+option csharp_namespace = "Google.Cloud.SecurityCenter.V1P1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1p1beta1;securitycenter";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.securitycenter.v1p1beta1";
+option php_namespace = "Google\\Cloud\\SecurityCenter\\V1p1beta1";
+option ruby_package = "Google::Cloud::SecurityCenter::V1p1beta1";
+
+// The Pub/Sub Topic resource definition is in google/cloud/pubsub/v1/,
+// but we do not import that proto directly; therefore, we redefine the
+// pattern here.
+option (google.api.resource_definition) = {
+  type: "pubsub.googleapis.com/Topic"
+  pattern: "projects/{project}/topics/{topic}"
+};
+
+// Cloud Security Command Center (Cloud SCC) notification configs.
+//
+// A notification config is a Cloud SCC resource that contains the configuration
+// to send notifications for create/update events of findings, assets and etc.
+message NotificationConfig {
+  option (google.api.resource) = {
+    type: "securitycenter.googleapis.com/NotificationConfig"
+    pattern: "organizations/{organization}/notificationConfigs/{notification_config}"
+  };
+
+  // The config for streaming-based notifications, which send each event as soon
+  // as it is detected.
+  message StreamingConfig {
+    // Expression that defines the filter to apply across create/update events
+    // of assets or findings as specified by the event type. The expression is a
+    // list of zero or more restrictions combined via logical operators `AND`
+    // and `OR`. Parentheses are supported, and `OR` has higher precedence than
+    // `AND`.
+    //
+    // Restrictions have the form `  ` and may have a
+    // `-` character in front of them to indicate negation. The fields map to
+    // those defined in the corresponding resource.
+    //
+    // The supported operators are:
+    //
+    // * `=` for all value types.
+    // * `>`, `<`, `>=`, `<=` for integer values.
+    // * `:`, meaning substring matching, for strings.
+    //
+    // The supported value types are:
+    //
+    // * string literals in quotes.
+    // * integer literals without quotes.
+    // * boolean literals `true` and `false` without quotes.
+    string filter = 1;
+  }
+
+  // The type of events.
+  enum EventType {
+    // Unspecified event type.
+    EVENT_TYPE_UNSPECIFIED = 0;
+
+    // Events for findings.
+    FINDING = 1;
+  }
+
+  // The relative resource name of this notification config. See:
+  // https://cloud.google.com/apis/design/resource_names#relative_resource_name
+  // Example:
+  // "organizations/{organization_id}/notificationConfigs/notify_public_bucket".
+  string name = 1;
+
+  // The description of the notification config (max of 1024 characters).
+  string description = 2;
+
+  // The type of events the config is for, e.g. FINDING.
+  EventType event_type = 3;
+
+  // The PubSub topic to send notifications to. Its format is
+  // "projects/[project_id]/topics/[topic]".
+  string pubsub_topic = 4 [
+    (google.api.resource_reference) = { type: "pubsub.googleapis.com/Topic" }
+  ];
+
+  // Output only. The service account that needs "pubsub.topics.publish"
+  // permission to publish to the PubSub topic.
+  string service_account = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // The config for triggering notifications.
+  oneof notify_config {
+    // The config for triggering streaming-based notifications.
+    StreamingConfig streaming_config = 6;
+  }
+}
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/notification_message.proto b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/notification_message.proto
new file mode 100644
index 000000000..3abbcef32
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/notification_message.proto
@@ -0,0 +1,42 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.securitycenter.v1p1beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/securitycenter/v1p1beta1/asset.proto";
+import "google/cloud/securitycenter/v1p1beta1/finding.proto";
+
+option csharp_namespace = "Google.Cloud.SecurityCenter.V1P1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1p1beta1;securitycenter";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.securitycenter.v1p1beta1";
+option php_namespace = "Google\\Cloud\\SecurityCenter\\V1p1beta1";
+option ruby_package = "Google::Cloud::SecurityCenter::V1p1beta1";
+
+// Cloud SCC's Notification
+message NotificationMessage {
+  // Name of the notification config that generated current notification.
+  string notification_config_name = 1;
+
+  // Notification Event.
+  oneof event {
+    // If it's a Finding based notification config, this field will be
+    // populated.
+    Finding finding = 2;
+  }
+}
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/organization_settings.proto b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/organization_settings.proto
new file mode 100644
index 000000000..9c38b87ba
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/organization_settings.proto
@@ -0,0 +1,83 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.securitycenter.v1p1beta1;
+
+import "google/api/annotations.proto";
+import "google/api/resource.proto";
+
+option csharp_namespace = "Google.Cloud.SecurityCenter.V1P1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1p1beta1;securitycenter";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.securitycenter.v1p1beta1";
+option php_namespace = "Google\\Cloud\\SecurityCenter\\V1p1beta1";
+option ruby_package = "Google::Cloud::SecurityCenter::V1p1beta1";
+
+// User specified settings that are attached to the Cloud Security Command
+// Center (Cloud SCC) organization.
+message OrganizationSettings {
+  option (google.api.resource) = {
+    type: "securitycenter.googleapis.com/OrganizationSettings"
+    pattern: "organizations/{organization}/organizationSettings"
+  };
+
+  // The configuration used for Asset Discovery runs.
+  message AssetDiscoveryConfig {
+    // The mode of inclusion when running Asset Discovery.
+    // Asset discovery can be limited by explicitly identifying projects to be
+    // included or excluded. If INCLUDE_ONLY is set, then only those projects
+    // within the organization and their children are discovered during asset
+    // discovery. If EXCLUDE is set, then projects that don't match those
+    // projects are discovered during asset discovery. If neither are set, then
+    // all projects within the organization are discovered during asset
+    // discovery.
+    enum InclusionMode {
+      // Unspecified. Setting the mode with this value will disable
+      // inclusion/exclusion filtering for Asset Discovery.
+      INCLUSION_MODE_UNSPECIFIED = 0;
+
+      // Asset Discovery will capture only the resources within the projects
+      // specified. All other resources will be ignored.
+      INCLUDE_ONLY = 1;
+
+      // Asset Discovery will ignore all resources under the projects specified.
+      // All other resources will be retrieved.
+      EXCLUDE = 2;
+    }
+
+    // The project ids to use for filtering asset discovery.
+    repeated string project_ids = 1;
+
+    // The mode to use for filtering asset discovery.
+    InclusionMode inclusion_mode = 2;
+  }
+
+  // The relative resource name of the settings. See:
+  // https://cloud.google.com/apis/design/resource_names#relative_resource_name
+  // Example:
+  // "organizations/{organization_id}/organizationSettings".
+  string name = 1;
+
+  // A flag that indicates if Asset Discovery should be enabled. If the flag is
+  // set to `true`, then discovery of assets will occur. If it is set to `false,
+  // all historical assets will remain, but discovery of future assets will not
+  // occur.
+  bool enable_asset_discovery = 2;
+
+  // The configuration used for Asset Discovery runs.
+  AssetDiscoveryConfig asset_discovery_config = 3;
+}
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/run_asset_discovery_response.proto b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/run_asset_discovery_response.proto
new file mode 100644
index 000000000..b8b9ea489
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/run_asset_discovery_response.proto
@@ -0,0 +1,53 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.securitycenter.v1p1beta1;
+
+import "google/api/annotations.proto";
+import "google/protobuf/duration.proto";
+
+option csharp_namespace = "Google.Cloud.SecurityCenter.V1P1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1p1beta1;securitycenter";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.securitycenter.v1p1beta1";
+option php_namespace = "Google\\Cloud\\SecurityCenter\\V1p1beta1";
+option ruby_package = "Google::Cloud::SecurityCenter::V1p1beta1";
+
+// Response of asset discovery run
+message RunAssetDiscoveryResponse {
+  // The state of an asset discovery run.
+  enum State {
+    // Asset discovery run state was unspecified.
+    STATE_UNSPECIFIED = 0;
+
+    // Asset discovery run completed successfully.
+    COMPLETED = 1;
+
+    // Asset discovery run was cancelled with tasks still pending, as another
+    // run for the same organization was started with a higher priority.
+    SUPERSEDED = 2;
+
+    // Asset discovery run was killed and terminated.
+    TERMINATED = 3;
+  }
+
+  // The state of an asset discovery run.
+  State state = 1;
+
+  // The duration between asset discovery run start and end
+  google.protobuf.Duration duration = 2;
+}
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/security_marks.proto b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/security_marks.proto
new file mode 100644
index 000000000..ac54bc19a
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/security_marks.proto
@@ -0,0 +1,57 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.securitycenter.v1p1beta1;
+
+import "google/api/annotations.proto";
+import "google/api/resource.proto";
+
+option csharp_namespace = "Google.Cloud.SecurityCenter.V1P1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1p1beta1;securitycenter";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.securitycenter.v1p1beta1";
+option php_namespace = "Google\\Cloud\\SecurityCenter\\V1p1beta1";
+option ruby_package = "Google::Cloud::SecurityCenter::V1p1beta1";
+
+// User specified security marks that are attached to the parent Cloud Security
+// Command Center (Cloud SCC) resource. Security marks are scoped within a Cloud
+// SCC organization -- they can be modified and viewed by all users who have
+// proper permissions on the organization.
+message SecurityMarks {
+  option (google.api.resource) = {
+    type: "securitycenter.googleapis.com/SecurityMarks"
+    pattern: "organizations/{organization}/assets/{asset}/securityMarks"
+    pattern: "organizations/{organization}/sources/{source}/findings/{finding}/securityMarks"
+  };
+
+  // The relative resource name of the SecurityMarks. See:
+  // https://cloud.google.com/apis/design/resource_names#relative_resource_name
+  // Examples:
+  // "organizations/{organization_id}/assets/{asset_id}/securityMarks"
+  // "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}/securityMarks".
+  string name = 1;
+
+  // Mutable user specified security marks belonging to the parent resource.
+  // Constraints are as follows:
+  //
+  //   * Keys and values are treated as case insensitive
+  //   * Keys must be between 1 - 256 characters (inclusive)
+  //   * Keys must be letters, numbers, underscores, or dashes
+  //   * Values have leading and trailing whitespace trimmed, remaining
+  //     characters must be between 1 - 4096 characters (inclusive)
+  map marks = 2;
+}
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/securitycenter_gapic.yaml b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/securitycenter_gapic.yaml
new file mode 100644
index 000000000..2669af7ea
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/securitycenter_gapic.yaml
@@ -0,0 +1,18 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 2.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.securitycenter.v1p1beta1
+  python:
+    package_name: google.cloud.securitycenter_v1p1beta1.gapic
+  go:
+    package_name: cloud.google.com/go/securitycenter/apiv1p1beta1
+  csharp:
+    package_name: Google.Cloud.SecurityCenter.V1P1Beta1
+  ruby:
+    package_name: Google::Cloud::SecurityCenter::V1p1beta1
+  php:
+    package_name: Google\Cloud\SecurityCenter\V1p1beta1
+  nodejs:
+    package_name: security-center.v1p1beta1
+    domain_layer_location: google-cloud
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/securitycenter_grpc_service_config.json b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/securitycenter_grpc_service_config.json
new file mode 100755
index 000000000..1e1d6a1b4
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/securitycenter_grpc_service_config.json
@@ -0,0 +1,116 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.securitycenter.v1p1beta1.SecurityCenter",
+          "method": "CreateSource"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1p1beta1.SecurityCenter",
+          "method": "CreateFinding"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1p1beta1.SecurityCenter",
+          "method": "CreateNotificationConfig"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1p1beta1.SecurityCenter",
+          "method": "DeleteNotificationConfig"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1p1beta1.SecurityCenter",
+          "method": "RunAssetDiscovery"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1p1beta1.SecurityCenter",
+          "method": "SetFindingState"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1p1beta1.SecurityCenter",
+          "method": "SetIamPolicy"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1p1beta1.SecurityCenter",
+          "method": "UpdateFinding"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1p1beta1.SecurityCenter",
+          "method": "UpdateNotificationConfig"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1p1beta1.SecurityCenter",
+          "method": "UpdateOrganizationSettings"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1p1beta1.SecurityCenter",
+          "method": "UpdateSource"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1p1beta1.SecurityCenter",
+          "method": "UpdateSecurityMarks"
+        }
+      ],
+      "timeout": "60s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.securitycenter.v1p1beta1.SecurityCenter",
+          "method": "GetIamPolicy"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1p1beta1.SecurityCenter",
+          "method": "GetNotificationConfig"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1p1beta1.SecurityCenter",
+          "method": "GetOrganizationSettings"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1p1beta1.SecurityCenter",
+          "method": "GetSource"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1p1beta1.SecurityCenter",
+          "method": "GroupAssets"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1p1beta1.SecurityCenter",
+          "method": "GroupFindings"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1p1beta1.SecurityCenter",
+          "method": "ListAssets"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1p1beta1.SecurityCenter",
+          "method": "ListFindings"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1p1beta1.SecurityCenter",
+          "method": "ListNotificationConfigs"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1p1beta1.SecurityCenter",
+          "method": "ListSources"
+        },
+        {
+          "service": "google.cloud.securitycenter.v1p1beta1.SecurityCenter",
+          "method": "TestIamPermissions"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/securitycenter_service.proto b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/securitycenter_service.proto
new file mode 100644
index 000000000..dcd9af683
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/securitycenter_service.proto
@@ -0,0 +1,1277 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.securitycenter.v1p1beta1;
+
+import public "google/cloud/securitycenter/v1p1beta1/run_asset_discovery_response.proto";
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/securitycenter/v1p1beta1/asset.proto";
+import "google/cloud/securitycenter/v1p1beta1/finding.proto";
+import "google/cloud/securitycenter/v1p1beta1/notification_config.proto";
+import "google/cloud/securitycenter/v1p1beta1/organization_settings.proto";
+import "google/cloud/securitycenter/v1p1beta1/security_marks.proto";
+import "google/cloud/securitycenter/v1p1beta1/source.proto";
+import "google/iam/v1/iam_policy.proto";
+import "google/iam/v1/policy.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/struct.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.SecurityCenter.V1P1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1p1beta1;securitycenter";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.securitycenter.v1p1beta1";
+option php_namespace = "Google\\Cloud\\SecurityCenter\\V1p1beta1";
+option ruby_package = "Google::Cloud::SecurityCenter::V1p1beta1";
+
+// V1p1Beta1 APIs for Security Center service.
+service SecurityCenter {
+  option (google.api.default_host) = "securitycenter.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform";
+
+  // Creates a source.
+  rpc CreateSource(CreateSourceRequest) returns (Source) {
+    option (google.api.http) = {
+      post: "/v1p1beta1/{parent=organizations/*}/sources"
+      body: "source"
+    };
+    option (google.api.method_signature) = "parent,source";
+  }
+
+  //
+  // Creates a finding. The corresponding source must exist for finding
+  // creation to succeed.
+  rpc CreateFinding(CreateFindingRequest) returns (Finding) {
+    option (google.api.http) = {
+      post: "/v1p1beta1/{parent=organizations/*/sources/*}/findings"
+      body: "finding"
+    };
+    option (google.api.method_signature) = "parent,finding_id,finding";
+    option (google.api.method_signature) = "parent,finding,finding_id";
+  }
+
+  // Creates a notification config.
+  rpc CreateNotificationConfig(CreateNotificationConfigRequest)
+      returns (NotificationConfig) {
+    option (google.api.http) = {
+      post: "/v1p1beta1/{parent=organizations/*}/notificationConfigs"
+      body: "notification_config"
+    };
+    option (google.api.method_signature) =
+        "parent,config_id,notification_config";
+    option (google.api.method_signature) = "parent,notification_config";
+  }
+
+  // Deletes a notification config.
+  rpc DeleteNotificationConfig(DeleteNotificationConfigRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1p1beta1/{name=organizations/*/notificationConfigs/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Gets the access control policy on the specified Source.
+  rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest)
+      returns (google.iam.v1.Policy) {
+    option (google.api.http) = {
+      post: "/v1p1beta1/{resource=organizations/*/sources/*}:getIamPolicy"
+      body: "*"
+    };
+    option (google.api.method_signature) = "resource";
+  }
+
+  // Gets a notification config.
+  rpc GetNotificationConfig(GetNotificationConfigRequest)
+      returns (NotificationConfig) {
+    option (google.api.http) = {
+      get: "/v1p1beta1/{name=organizations/*/notificationConfigs/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Gets the settings for an organization.
+  rpc GetOrganizationSettings(GetOrganizationSettingsRequest)
+      returns (OrganizationSettings) {
+    option (google.api.http) = {
+      get: "/v1p1beta1/{name=organizations/*/organizationSettings}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Gets a source.
+  rpc GetSource(GetSourceRequest) returns (Source) {
+    option (google.api.http) = {
+      get: "/v1p1beta1/{name=organizations/*/sources/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Filters an organization's assets and  groups them by their specified
+  // properties.
+  rpc GroupAssets(GroupAssetsRequest) returns (GroupAssetsResponse) {
+    option (google.api.http) = {
+      post: "/v1p1beta1/{parent=organizations/*}/assets:group"
+      body: "*"
+    };
+  }
+
+  // Filters an organization or source's findings and  groups them by their
+  // specified properties.
+  //
+  // To group across all sources provide a `-` as the source id.
+  // Example: /v1p1beta1/organizations/{organization_id}/sources/-/findings
+  rpc GroupFindings(GroupFindingsRequest) returns (GroupFindingsResponse) {
+    option (google.api.http) = {
+      post: "/v1p1beta1/{parent=organizations/*/sources/*}/findings:group"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent,group_by";
+  }
+
+  // Lists an organization's assets.
+  rpc ListAssets(ListAssetsRequest) returns (ListAssetsResponse) {
+    option (google.api.http) = {
+      get: "/v1p1beta1/{parent=organizations/*}/assets"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Lists an organization or source's findings.
+  //
+  // To list across all sources provide a `-` as the source id.
+  // Example: /v1p1beta1/organizations/{organization_id}/sources/-/findings
+  rpc ListFindings(ListFindingsRequest) returns (ListFindingsResponse) {
+    option (google.api.http) = {
+      get: "/v1p1beta1/{parent=organizations/*/sources/*}/findings"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Lists notification configs.
+  rpc ListNotificationConfigs(ListNotificationConfigsRequest)
+      returns (ListNotificationConfigsResponse) {
+    option (google.api.http) = {
+      get: "/v1p1beta1/{parent=organizations/*}/notificationConfigs"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Lists all sources belonging to an organization.
+  rpc ListSources(ListSourcesRequest) returns (ListSourcesResponse) {
+    option (google.api.http) = {
+      get: "/v1p1beta1/{parent=organizations/*}/sources"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Runs asset discovery. The discovery is tracked with a long-running
+  // operation.
+  //
+  // This API can only be called with limited frequency for an organization. If
+  // it is called too frequently the caller will receive a TOO_MANY_REQUESTS
+  // error.
+  rpc RunAssetDiscovery(RunAssetDiscoveryRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1p1beta1/{parent=organizations/*}/assets:runDiscovery"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.cloud.securitycenter.v1p1beta1.RunAssetDiscoveryResponse"
+      metadata_type: "google.protobuf.Empty"
+    };
+  }
+
+  //
+  // Updates the state of a finding.
+  rpc SetFindingState(SetFindingStateRequest) returns (Finding) {
+    option (google.api.http) = {
+      post: "/v1p1beta1/{name=organizations/*/sources/*/findings/*}:setState"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name,state,start_time";
+  }
+
+  // Sets the access control policy on the specified Source.
+  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest)
+      returns (google.iam.v1.Policy) {
+    option (google.api.http) = {
+      post: "/v1p1beta1/{resource=organizations/*/sources/*}:setIamPolicy"
+      body: "*"
+    };
+    option (google.api.method_signature) = "resource,policy";
+  }
+
+  // Returns the permissions that a caller has on the specified source.
+  rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest)
+      returns (google.iam.v1.TestIamPermissionsResponse) {
+    option (google.api.http) = {
+      post: "/v1p1beta1/{resource=organizations/*/sources/*}:testIamPermissions"
+      body: "*"
+    };
+    option (google.api.method_signature) = "resource,permissions";
+  }
+
+  //
+  // Creates or updates a finding. The corresponding source must exist for a
+  // finding creation to succeed.
+  rpc UpdateFinding(UpdateFindingRequest) returns (Finding) {
+    option (google.api.http) = {
+      patch: "/v1p1beta1/{finding.name=organizations/*/sources/*/findings/*}"
+      body: "finding"
+    };
+    option (google.api.method_signature) = "finding";
+    option (google.api.method_signature) = "finding,update_mask";
+  }
+
+  // Updates a notification config.
+  rpc UpdateNotificationConfig(UpdateNotificationConfigRequest)
+      returns (NotificationConfig) {
+    option (google.api.http) = {
+      patch: "/v1p1beta1/{notification_config.name=organizations/*/notificationConfigs/*}"
+      body: "notification_config"
+    };
+    option (google.api.method_signature) = "notification_config";
+    option (google.api.method_signature) = "notification_config,update_mask";
+  }
+
+  // Updates an organization's settings.
+  rpc UpdateOrganizationSettings(UpdateOrganizationSettingsRequest)
+      returns (OrganizationSettings) {
+    option (google.api.http) = {
+      patch: "/v1p1beta1/{organization_settings.name=organizations/*/organizationSettings}"
+      body: "organization_settings"
+    };
+    option (google.api.method_signature) = "organization_settings";
+  }
+
+  // Updates a source.
+  rpc UpdateSource(UpdateSourceRequest) returns (Source) {
+    option (google.api.http) = {
+      patch: "/v1p1beta1/{source.name=organizations/*/sources/*}"
+      body: "source"
+    };
+    option (google.api.method_signature) = "source";
+    option (google.api.method_signature) = "source,update_mask";
+  }
+
+  // Updates security marks.
+  rpc UpdateSecurityMarks(UpdateSecurityMarksRequest) returns (SecurityMarks) {
+    option (google.api.http) = {
+      patch: "/v1p1beta1/{security_marks.name=organizations/*/assets/*/securityMarks}"
+      body: "security_marks"
+      additional_bindings {
+        patch: "/v1p1beta1/{security_marks.name=organizations/*/sources/*/findings/*/securityMarks}"
+        body: "security_marks"
+      }
+    };
+    option (google.api.method_signature) = "security_marks";
+    option (google.api.method_signature) = "security_marks,update_mask";
+  }
+}
+
+// Request message for creating a finding.
+message CreateFindingRequest {
+  // Required. Resource name of the new finding's parent. Its format should be
+  // "organizations/[organization_id]/sources/[source_id]".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/Source"
+    }
+  ];
+
+  // Required. Unique identifier provided by the client within the parent scope.
+  // It must be alphanumeric and less than or equal to 32 characters and
+  // greater than 0 characters in length.
+  string finding_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The Finding being created. The name and security_marks will be
+  // ignored as they are both output only fields on this resource.
+  Finding finding = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for creating a notification config.
+message CreateNotificationConfigRequest {
+  // Required. Resource name of the new notification config's parent. Its format
+  // is "organizations/[organization_id]".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Organization"
+    }
+  ];
+
+  // Required.
+  // Unique identifier provided by the client within the parent scope.
+  // It must be between 1 and 128 characters, and contains alphanumeric
+  // characters, underscores or hyphens only.
+  string config_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The notification config being created. The name and the service
+  // account will be ignored as they are both output only fields on this
+  // resource.
+  NotificationConfig notification_config = 3
+      [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for creating a source.
+message CreateSourceRequest {
+  // Required. Resource name of the new source's parent. Its format should be
+  // "organizations/[organization_id]".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Organization"
+    }
+  ];
+
+  // Required. The Source being created, only the display_name and description
+  // will be used. All other fields will be ignored.
+  Source source = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for deleting a notification config.
+message DeleteNotificationConfigRequest {
+  // Required. Name of the notification config to delete. Its format is
+  // "organizations/[organization_id]/notificationConfigs/[config_id]".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/NotificationConfig"
+    }
+  ];
+}
+
+// Request message for getting a notification config.
+message GetNotificationConfigRequest {
+  // Required. Name of the notification config to get. Its format is
+  // "organizations/[organization_id]/notificationConfigs/[config_id]".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/NotificationConfig"
+    }
+  ];
+}
+
+// Request message for getting organization settings.
+message GetOrganizationSettingsRequest {
+  // Required. Name of the organization to get organization settings for. Its
+  // format is "organizations/[organization_id]/organizationSettings".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/OrganizationSettings"
+    }
+  ];
+}
+
+// Request message for getting a source.
+message GetSourceRequest {
+  // Required. Relative resource name of the source. Its format is
+  // "organizations/[organization_id]/source/[source_id]".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/Source"
+    }
+  ];
+}
+
+// Request message for grouping by assets.
+message GroupAssetsRequest {
+  // Required. Name of the organization to groupBy. Its format is
+  // "organizations/[organization_id]".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Organization"
+    }
+  ];
+
+  // Expression that defines the filter to apply across assets.
+  // The expression is a list of zero or more restrictions combined via logical
+  // operators `AND` and `OR`.
+  // Parentheses are supported, and `OR` has higher precedence than `AND`.
+  //
+  // Restrictions have the form `  ` and may have a `-`
+  // character in front of them to indicate negation. The fields map to those
+  // defined in the Asset resource. Examples include:
+  //
+  // * name
+  // * security_center_properties.resource_name
+  // * resource_properties.a_property
+  // * security_marks.marks.marka
+  //
+  // The supported operators are:
+  //
+  // * `=` for all value types.
+  // * `>`, `<`, `>=`, `<=` for integer values.
+  // * `:`, meaning substring matching, for strings.
+  //
+  // The supported value types are:
+  //
+  // * string literals in quotes.
+  // * integer literals without quotes.
+  // * boolean literals `true` and `false` without quotes.
+  //
+  // The following field and operator combinations are supported:
+  //
+  // * name: `=`
+  // * update_time: `=`, `>`, `<`, `>=`, `<=`
+  //
+  //   Usage: This should be milliseconds since epoch or an RFC3339 string.
+  //   Examples:
+  //     "update_time = \"2019-06-10T16:07:18-07:00\""
+  //     "update_time = 1560208038000"
+  //
+  // * create_time: `=`, `>`, `<`, `>=`, `<=`
+  //
+  //   Usage: This should be milliseconds since epoch or an RFC3339 string.
+  //   Examples:
+  //     "create_time = \"2019-06-10T16:07:18-07:00\""
+  //     "create_time = 1560208038000"
+  //
+  // * iam_policy.policy_blob: `=`, `:`
+  // * resource_properties: `=`, `:`, `>`, `<`, `>=`, `<=`
+  // * security_marks.marks: `=`, `:`
+  // * security_center_properties.resource_name: `=`, `:`
+  // * security_center_properties.resource_name_display_name: `=`, `:`
+  // * security_center_properties.resource_type: `=`, `:`
+  // * security_center_properties.resource_parent: `=`, `:`
+  // * security_center_properties.resource_parent_display_name: `=`, `:`
+  // * security_center_properties.resource_project: `=`, `:`
+  // * security_center_properties.resource_project_display_name: `=`, `:`
+  // * security_center_properties.resource_owners: `=`, `:`
+  //
+  // For example, `resource_properties.size = 100` is a valid filter string.
+  string filter = 2;
+
+  // Required. Expression that defines what assets fields to use for grouping.
+  // The string value should follow SQL syntax: comma separated list of fields.
+  // For example:
+  // "security_center_properties.resource_project,security_center_properties.project".
+  //
+  // The following fields are supported when compare_duration is not set:
+  //
+  // * security_center_properties.resource_project
+  // * security_center_properties.resource_project_display_name
+  // * security_center_properties.resource_type
+  // * security_center_properties.resource_parent
+  // * security_center_properties.resource_parent_display_name
+  //
+  // The following fields are supported when compare_duration is set:
+  //
+  // * security_center_properties.resource_type
+  // * security_center_properties.resource_project_display_name
+  // * security_center_properties.resource_parent_display_name
+  string group_by = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // When compare_duration is set, the GroupResult's "state_change" property is
+  // updated to indicate whether the asset was added, removed, or remained
+  // present during the compare_duration period of time that precedes the
+  // read_time. This is the time between (read_time - compare_duration) and
+  // read_time.
+  //
+  // The state change value is derived based on the presence of the asset at the
+  // two points in time. Intermediate state changes between the two times don't
+  // affect the result. For example, the results aren't affected if the asset is
+  // removed and re-created again.
+  //
+  // Possible "state_change" values when compare_duration is specified:
+  //
+  // * "ADDED":   indicates that the asset was not present at the start of
+  //                compare_duration, but present at reference_time.
+  // * "REMOVED": indicates that the asset was present at the start of
+  //                compare_duration, but not present at reference_time.
+  // * "ACTIVE":  indicates that the asset was present at both the
+  //                start and the end of the time period defined by
+  //                compare_duration and reference_time.
+  //
+  // If compare_duration is not specified, then the only possible state_change
+  // is "UNUSED", which will be the state_change set for all assets present at
+  // read_time.
+  //
+  // If this field is set then `state_change` must be a specified field in
+  // `group_by`.
+  google.protobuf.Duration compare_duration = 4;
+
+  // Time used as a reference point when filtering assets. The filter is limited
+  // to assets existing at the supplied time and their values are those at that
+  // specific time. Absence of this field will default to the API's version of
+  // NOW.
+  google.protobuf.Timestamp read_time = 5;
+
+  // Filter that specifies what fields to further filter on *after* the query
+  // filter has been executed. Currently only `state_change` is supported and
+  // requires compare_duration to be specified.
+  string having = 6;
+
+  // The value returned by the last `GroupAssetsResponse`; indicates
+  // that this is a continuation of a prior `GroupAssets` call, and that the
+  // system should return the next page of data.
+  string page_token = 7;
+
+  // The maximum number of results to return in a single response. Default is
+  // 10, minimum is 1, maximum is 1000.
+  int32 page_size = 8;
+}
+
+// Response message for grouping by assets.
+message GroupAssetsResponse {
+  // Group results. There exists an element for each existing unique
+  // combination of property/values. The element contains a count for the number
+  // of times those specific property/values appear.
+  repeated GroupResult group_by_results = 1;
+
+  // Time used for executing the groupBy request.
+  google.protobuf.Timestamp read_time = 2;
+
+  // Token to retrieve the next page of results, or empty if there are no more
+  // results.
+  string next_page_token = 3;
+
+  // The total number of results matching the query.
+  int32 total_size = 4;
+}
+
+// Request message for grouping by findings.
+message GroupFindingsRequest {
+  // Required. Name of the source to groupBy. Its format is
+  // "organizations/[organization_id]/sources/[source_id]". To groupBy across
+  // all sources provide a source_id of `-`. For example:
+  // organizations/{organization_id}/sources/-
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/Source"
+    }
+  ];
+
+  // Expression that defines the filter to apply across findings.
+  // The expression is a list of one or more restrictions combined via logical
+  // operators `AND` and `OR`.
+  // Parentheses are supported, and `OR` has higher precedence than `AND`.
+  //
+  // Restrictions have the form `  ` and may have a `-`
+  // character in front of them to indicate negation. Examples include:
+  //
+  //  * name
+  //  * source_properties.a_property
+  //  * security_marks.marks.marka
+  //
+  // The supported operators are:
+  //
+  // * `=` for all value types.
+  // * `>`, `<`, `>=`, `<=` for integer values.
+  // * `:`, meaning substring matching, for strings.
+  //
+  // The supported value types are:
+  //
+  // * string literals in quotes.
+  // * integer literals without quotes.
+  // * boolean literals `true` and `false` without quotes.
+  //
+  // The following field and operator combinations are supported:
+  //
+  // * name: `=`
+  // * parent: `=`, `:`
+  // * resource_name: `=`, `:`
+  // * state: `=`, `:`
+  // * category: `=`, `:`
+  // * external_uri: `=`, `:`
+  // * event_time: `=`, `>`, `<`, `>=`, `<=`
+  //
+  //   Usage: This should be milliseconds since epoch or an RFC3339 string.
+  //   Examples:
+  //     "event_time = \"2019-06-10T16:07:18-07:00\""
+  //     "event_time = 1560208038000"
+  //
+  // * security_marks.marks: `=`, `:`
+  // * source_properties: `=`, `:`, `>`, `<`, `>=`, `<=`
+  //
+  // For example, `source_properties.size = 100` is a valid filter string.
+  string filter = 2;
+
+  // Required. Expression that defines what assets fields to use for grouping
+  // (including `state_change`). The string value should follow SQL syntax:
+  // comma separated list of fields. For example: "parent,resource_name".
+  //
+  // The following fields are supported:
+  //
+  // * resource_name
+  // * category
+  // * state
+  // * parent
+  //
+  // The following fields are supported when compare_duration is set:
+  //
+  // * state_change
+  string group_by = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Time used as a reference point when filtering findings. The filter is
+  // limited to findings existing at the supplied time and their values are
+  // those at that specific time. Absence of this field will default to the
+  // API's version of NOW.
+  google.protobuf.Timestamp read_time = 4;
+
+  // When compare_duration is set, the GroupResult's "state_change" attribute is
+  // updated to indicate whether the finding had its state changed, the
+  // finding's state remained unchanged, or if the finding was added during the
+  // compare_duration period of time that precedes the read_time. This is the
+  // time between (read_time - compare_duration) and read_time.
+  //
+  // The state_change value is derived based on the presence and state of the
+  // finding at the two points in time. Intermediate state changes between the
+  // two times don't affect the result. For example, the results aren't affected
+  // if the finding is made inactive and then active again.
+  //
+  // Possible "state_change" values when compare_duration is specified:
+  //
+  // * "CHANGED":   indicates that the finding was present at the start of
+  //                  compare_duration, but changed its state at read_time.
+  // * "UNCHANGED": indicates that the finding was present at the start of
+  //                  compare_duration and did not change state at read_time.
+  // * "ADDED":     indicates that the finding was not present at the start
+  //                  of compare_duration, but was present at read_time.
+  //
+  // If compare_duration is not specified, then the only possible state_change
+  // is "UNUSED",  which will be the state_change set for all findings present
+  // at read_time.
+  //
+  // If this field is set then `state_change` must be a specified field in
+  // `group_by`.
+  google.protobuf.Duration compare_duration = 5;
+
+  // Filter that specifies what fields to further filter on *after* the query
+  // filter has been executed. Currently only `finding.state` and `state_change`
+  // are supported and requires compare_duration to be specified.
+  string having = 6;
+
+  // The value returned by the last `GroupFindingsResponse`; indicates
+  // that this is a continuation of a prior `GroupFindings` call, and
+  // that the system should return the next page of data.
+  string page_token = 7;
+
+  // The maximum number of results to return in a single response. Default is
+  // 10, minimum is 1, maximum is 1000.
+  int32 page_size = 8;
+}
+
+// Response message for group by findings.
+message GroupFindingsResponse {
+  // Group results. There exists an element for each existing unique
+  // combination of property/values. The element contains a count for the number
+  // of times those specific property/values appear.
+  repeated GroupResult group_by_results = 1;
+
+  // Time used for executing the groupBy request.
+  google.protobuf.Timestamp read_time = 2;
+
+  // Token to retrieve the next page of results, or empty if there are no more
+  // results.
+  string next_page_token = 3;
+
+  // The total number of results matching the query.
+  int32 total_size = 4;
+}
+
+// Result containing the properties and count of a groupBy request.
+message GroupResult {
+  // Properties matching the groupBy fields in the request.
+  map properties = 1;
+
+  // Total count of resources for the given properties.
+  int64 count = 2;
+}
+
+// Request message for listing notification configs.
+message ListNotificationConfigsRequest {
+  // Required. Name of the organization to list notification configs.
+  // Its format is "organizations/[organization_id]".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Organization"
+    }
+  ];
+
+  // The value returned by the last `ListNotificationConfigsResponse`; indicates
+  // that this is a continuation of a prior `ListNotificationConfigs` call, and
+  // that the system should return the next page of data.
+  string page_token = 2;
+
+  // The maximum number of results to return in a single response. Default is
+  // 10, minimum is 1, maximum is 1000.
+  int32 page_size = 3;
+}
+
+// Response message for listing notification configs.
+message ListNotificationConfigsResponse {
+  // Notification configs belonging to the requested parent.
+  repeated NotificationConfig notification_configs = 1;
+
+  // Token to retrieve the next page of results, or empty if there are no more
+  // results.
+  string next_page_token = 2;
+}
+
+// Request message for listing sources.
+message ListSourcesRequest {
+  // Required. Resource name of the parent of sources to list. Its format should
+  // be "organizations/[organization_id]".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Organization"
+    }
+  ];
+
+  // The value returned by the last `ListSourcesResponse`; indicates
+  // that this is a continuation of a prior `ListSources` call, and
+  // that the system should return the next page of data.
+  string page_token = 2;
+
+  // The maximum number of results to return in a single response. Default is
+  // 10, minimum is 1, maximum is 1000.
+  int32 page_size = 7;
+}
+
+// Response message for listing sources.
+message ListSourcesResponse {
+  // Sources belonging to the requested parent.
+  repeated Source sources = 1;
+
+  // Token to retrieve the next page of results, or empty if there are no more
+  // results.
+  string next_page_token = 2;
+}
+
+// Request message for listing assets.
+message ListAssetsRequest {
+  // Required. Name of the organization assets should belong to. Its format is
+  // "organizations/[organization_id]".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Organization"
+    }
+  ];
+
+  // Expression that defines the filter to apply across assets.
+  // The expression is a list of zero or more restrictions combined via logical
+  // operators `AND` and `OR`.
+  // Parentheses are supported, and `OR` has higher precedence than `AND`.
+  //
+  // Restrictions have the form `  ` and may have a `-`
+  // character in front of them to indicate negation. The fields map to those
+  // defined in the Asset resource. Examples include:
+  //
+  // * name
+  // * security_center_properties.resource_name
+  // * resource_properties.a_property
+  // * security_marks.marks.marka
+  //
+  // The supported operators are:
+  //
+  // * `=` for all value types.
+  // * `>`, `<`, `>=`, `<=` for integer values.
+  // * `:`, meaning substring matching, for strings.
+  //
+  // The supported value types are:
+  //
+  // * string literals in quotes.
+  // * integer literals without quotes.
+  // * boolean literals `true` and `false` without quotes.
+  //
+  // The following are the allowed field and operator combinations:
+  //
+  // * name: `=`
+  // * update_time: `=`, `>`, `<`, `>=`, `<=`
+  //
+  //   Usage: This should be milliseconds since epoch or an RFC3339 string.
+  //   Examples:
+  //     "update_time = \"2019-06-10T16:07:18-07:00\""
+  //     "update_time = 1560208038000"
+  //
+  // * create_time: `=`, `>`, `<`, `>=`, `<=`
+  //
+  //   Usage: This should be milliseconds since epoch or an RFC3339 string.
+  //   Examples:
+  //     "create_time = \"2019-06-10T16:07:18-07:00\""
+  //     "create_time = 1560208038000"
+  //
+  // * iam_policy.policy_blob: `=`, `:`
+  // * resource_properties: `=`, `:`, `>`, `<`, `>=`, `<=`
+  // * security_marks.marks: `=`, `:`
+  // * security_center_properties.resource_name: `=`, `:`
+  // * security_center_properties.resource_display_name: `=`, `:`
+  // * security_center_properties.resource_type: `=`, `:`
+  // * security_center_properties.resource_parent: `=`, `:`
+  // * security_center_properties.resource_parent_display_name: `=`, `:`
+  // * security_center_properties.resource_project: `=`, `:`
+  // * security_center_properties.resource_project_display_name: `=`, `:`
+  // * security_center_properties.resource_owners: `=`, `:`
+  //
+  // For example, `resource_properties.size = 100` is a valid filter string.
+  string filter = 2;
+
+  // Expression that defines what fields and order to use for sorting. The
+  // string value should follow SQL syntax: comma separated list of fields. For
+  // example: "name,resource_properties.a_property". The default sorting order
+  // is ascending. To specify descending order for a field, a suffix " desc"
+  // should be appended to the field name. For example: "name
+  // desc,resource_properties.a_property". Redundant space characters in the
+  // syntax are insignificant. "name desc,resource_properties.a_property" and "
+  // name     desc  ,   resource_properties.a_property  " are equivalent.
+  //
+  // The following fields are supported:
+  // name
+  // update_time
+  // resource_properties
+  // security_marks.marks
+  // security_center_properties.resource_name
+  // security_center_properties.resource_display_name
+  // security_center_properties.resource_parent
+  // security_center_properties.resource_parent_display_name
+  // security_center_properties.resource_project
+  // security_center_properties.resource_project_display_name
+  // security_center_properties.resource_type
+  string order_by = 3;
+
+  // Time used as a reference point when filtering assets. The filter is limited
+  // to assets existing at the supplied time and their values are those at that
+  // specific time. Absence of this field will default to the API's version of
+  // NOW.
+  google.protobuf.Timestamp read_time = 4;
+
+  // When compare_duration is set, the ListAssetsResult's "state_change"
+  // attribute is updated to indicate whether the asset was added, removed, or
+  // remained present during the compare_duration period of time that precedes
+  // the read_time. This is the time between (read_time - compare_duration) and
+  // read_time.
+  //
+  // The state_change value is derived based on the presence of the asset at the
+  // two points in time. Intermediate state changes between the two times don't
+  // affect the result. For example, the results aren't affected if the asset is
+  // removed and re-created again.
+  //
+  // Possible "state_change" values when compare_duration is specified:
+  //
+  // * "ADDED":   indicates that the asset was not present at the start of
+  //                compare_duration, but present at read_time.
+  // * "REMOVED": indicates that the asset was present at the start of
+  //                compare_duration, but not present at read_time.
+  // * "ACTIVE":  indicates that the asset was present at both the
+  //                start and the end of the time period defined by
+  //                compare_duration and read_time.
+  //
+  // If compare_duration is not specified, then the only possible state_change
+  // is "UNUSED",  which will be the state_change set for all assets present at
+  // read_time.
+  google.protobuf.Duration compare_duration = 5;
+
+  // Filter that specifies what fields to further filter on *after* the query
+  // filter has been executed. Currently only `state_change` is supported and
+  // requires compare_duration to be specified.
+  string having = 6;
+
+  // Optional.
+  // A field mask to specify the ListAssetsResult fields to be listed in the
+  // response.
+  // An empty field mask will list all fields.
+  google.protobuf.FieldMask field_mask = 7
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // The value returned by the last `ListAssetsResponse`; indicates
+  // that this is a continuation of a prior `ListAssets` call, and
+  // that the system should return the next page of data.
+  string page_token = 8;
+
+  // The maximum number of results to return in a single response. Default is
+  // 10, minimum is 1, maximum is 1000.
+  int32 page_size = 9;
+}
+
+// Response message for listing assets.
+message ListAssetsResponse {
+  // Result containing the Asset and its State.
+  message ListAssetsResult {
+    // The change in state of the asset.
+    //
+    // When querying across two points in time this describes
+    // the change between the two points: ADDED, REMOVED, or ACTIVE.
+    // If there was no compare_duration supplied in the request the state change
+    // will be: UNUSED
+    enum StateChange {
+      // State change is unused, this is the canonical default for this enum.
+      UNUSED = 0;
+
+      // Asset was added between the points in time.
+      ADDED = 1;
+
+      // Asset was removed between the points in time.
+      REMOVED = 2;
+
+      // Asset was present at both point(s) in time.
+      ACTIVE = 3;
+    }
+
+    // Asset matching the search request.
+    Asset asset = 1;
+
+    // State change of the asset between the points in time.
+    StateChange state_change = 2;
+  }
+
+  // Assets matching the list request.
+  repeated ListAssetsResult list_assets_results = 1;
+
+  // Time used for executing the list request.
+  google.protobuf.Timestamp read_time = 2;
+
+  // Token to retrieve the next page of results, or empty if there are no more
+  // results.
+  string next_page_token = 3;
+
+  // The total number of assets matching the query.
+  int32 total_size = 4;
+}
+
+// Request message for listing findings.
+message ListFindingsRequest {
+  // Required. Name of the source the findings belong to. Its format is
+  // "organizations/[organization_id]/sources/[source_id]". To list across all
+  // sources provide a source_id of `-`. For example:
+  // organizations/{organization_id}/sources/-
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/Source"
+    }
+  ];
+
+  // Expression that defines the filter to apply across findings.
+  // The expression is a list of one or more restrictions combined via logical
+  // operators `AND` and `OR`.
+  // Parentheses are supported, and `OR` has higher precedence than `AND`.
+  //
+  // Restrictions have the form `  ` and may have a `-`
+  // character in front of them to indicate negation. Examples include:
+  //
+  //  * name
+  //  * source_properties.a_property
+  //  * security_marks.marks.marka
+  //
+  // The supported operators are:
+  //
+  // * `=` for all value types.
+  // * `>`, `<`, `>=`, `<=` for integer values.
+  // * `:`, meaning substring matching, for strings.
+  //
+  // The supported value types are:
+  //
+  // * string literals in quotes.
+  // * integer literals without quotes.
+  // * boolean literals `true` and `false` without quotes.
+  //
+  // The following field and operator combinations are supported:
+  //
+  // name: `=`
+  // parent: `=`, `:`
+  // resource_name: `=`, `:`
+  // state: `=`, `:`
+  // category: `=`, `:`
+  // external_uri: `=`, `:`
+  // event_time: `=`, `>`, `<`, `>=`, `<=`
+  //
+  //   Usage: This should be milliseconds since epoch or an RFC3339 string.
+  //   Examples:
+  //     "event_time = \"2019-06-10T16:07:18-07:00\""
+  //     "event_time = 1560208038000"
+  //
+  // security_marks.marks: `=`, `:`
+  // source_properties: `=`, `:`, `>`, `<`, `>=`, `<=`
+  //
+  // For example, `source_properties.size = 100` is a valid filter string.
+  string filter = 2;
+
+  // Expression that defines what fields and order to use for sorting. The
+  // string value should follow SQL syntax: comma separated list of fields. For
+  // example: "name,resource_properties.a_property". The default sorting order
+  // is ascending. To specify descending order for a field, a suffix " desc"
+  // should be appended to the field name. For example: "name
+  // desc,source_properties.a_property". Redundant space characters in the
+  // syntax are insignificant. "name desc,source_properties.a_property" and "
+  // name     desc  ,   source_properties.a_property  " are equivalent.
+  //
+  // The following fields are supported:
+  // name
+  // parent
+  // state
+  // category
+  // resource_name
+  // event_time
+  // source_properties
+  // security_marks.marks
+  string order_by = 3;
+
+  // Time used as a reference point when filtering findings. The filter is
+  // limited to findings existing at the supplied time and their values are
+  // those at that specific time. Absence of this field will default to the
+  // API's version of NOW.
+  google.protobuf.Timestamp read_time = 4;
+
+  // When compare_duration is set, the ListFindingsResult's "state_change"
+  // attribute is updated to indicate whether the finding had its state changed,
+  // the finding's state remained unchanged, or if the finding was added in any
+  // state during the compare_duration period of time that precedes the
+  // read_time. This is the time between (read_time - compare_duration) and
+  // read_time.
+  //
+  // The state_change value is derived based on the presence and state of the
+  // finding at the two points in time. Intermediate state changes between the
+  // two times don't affect the result. For example, the results aren't affected
+  // if the finding is made inactive and then active again.
+  //
+  // Possible "state_change" values when compare_duration is specified:
+  //
+  // * "CHANGED":   indicates that the finding was present at the start of
+  //                  compare_duration, but changed its state at read_time.
+  // * "UNCHANGED": indicates that the finding was present at the start of
+  //                  compare_duration and did not change state at read_time.
+  // * "ADDED":     indicates that the finding was not present at the start
+  //                  of compare_duration, but was present at read_time.
+  //
+  // If compare_duration is not specified, then the only possible state_change
+  // is "UNUSED", which will be the state_change set for all findings present at
+  // read_time.
+  google.protobuf.Duration compare_duration = 5;
+
+  // Filter that specifies what fields to further filter on *after* the query
+  // filter has been executed. Currently only `finding.state` and `state_change`
+  // are supported and requires compare_duration to be specified.
+  string having = 6;
+
+  // Optional.
+  // A field mask to specify the Finding fields to be listed in the response.
+  // An empty field mask will list all fields.
+  google.protobuf.FieldMask field_mask = 7
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // The value returned by the last `ListFindingsResponse`; indicates
+  // that this is a continuation of a prior `ListFindings` call, and
+  // that the system should return the next page of data.
+  string page_token = 8;
+
+  // The maximum number of results to return in a single response. Default is
+  // 10, minimum is 1, maximum is 1000.
+  int32 page_size = 9;
+}
+
+// Response message for listing findings.
+message ListFindingsResponse {
+  // Result containing the Finding and its StateChange.
+  message ListFindingsResult {
+    // Information related to the Google Cloud Platform (GCP) resource that is
+    // associated with this finding.
+    message Resource {
+      // The full resource name of the resource. See:
+      // https://cloud.google.com/apis/design/resource_names#full_resource_name
+      string name = 1;
+
+      // The full resource name of project that the resource belongs to.
+      string project_name = 2;
+
+      // The human readable name of project that the resource belongs to.
+      string project_display_name = 3;
+
+      // The full resource name of resource's parent.
+      string parent_name = 4;
+
+      // The human readable name of resource's parent.
+      string parent_display_name = 5;
+    }
+
+    // The change in state of the finding.
+    //
+    // When querying across two points in time this describes
+    // the change in the finding between the two points: CHANGED, UNCHANGED,
+    // ADDED, or REMOVED. Findings can not be deleted, so REMOVED implies that
+    // the finding at timestamp does not match the filter specified, but it did
+    // at timestamp - compare_duration. If there was no compare_duration
+    // supplied in the request the state change will be: UNUSED
+    enum StateChange {
+      // State change is unused, this is the canonical default for this enum.
+      UNUSED = 0;
+
+      // The finding has changed state in some way between the points in time
+      // and existed at both points.
+      CHANGED = 1;
+
+      // The finding has not changed state between the points in time and
+      // existed at both points.
+      UNCHANGED = 2;
+
+      // The finding was created between the points in time.
+      ADDED = 3;
+
+      // The finding at timestamp does not match the filter specified, but it
+      // did at timestamp - compare_duration.
+      REMOVED = 4;
+    }
+
+    // Finding matching the search request.
+    Finding finding = 1;
+
+    // State change of the finding between the points in time.
+    StateChange state_change = 2;
+
+    // Output only. Resource that is associated with this finding.
+    Resource resource = 3;
+  }
+
+  // Findings matching the list request.
+  repeated ListFindingsResult list_findings_results = 1;
+
+  // Time used for executing the list request.
+  google.protobuf.Timestamp read_time = 2;
+
+  // Token to retrieve the next page of results, or empty if there are no more
+  // results.
+  string next_page_token = 3;
+
+  // The total number of findings matching the query.
+  int32 total_size = 4;
+}
+
+// Request message for updating a finding's state.
+message SetFindingStateRequest {
+  // Required. The relative resource name of the finding. See:
+  // https://cloud.google.com/apis/design/resource_names#relative_resource_name
+  // Example:
+  // "organizations/{organization_id}/sources/{source_id}/finding/{finding_id}".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "securitycenter.googleapis.com/Finding"
+    }
+  ];
+
+  // Required. The desired State of the finding.
+  Finding.State state = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The time at which the updated state takes effect.
+  google.protobuf.Timestamp start_time = 3
+      [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for running asset discovery for an organization.
+message RunAssetDiscoveryRequest {
+  // Required. Name of the organization to run asset discovery for. Its format
+  // is "organizations/[organization_id]".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Organization"
+    }
+  ];
+}
+
+// Request message for updating or creating a finding.
+message UpdateFindingRequest {
+  // Required. The finding resource to update or create if it does not already
+  // exist. parent, security_marks, and update_time will be ignored.
+  //
+  // In the case of creation, the finding id portion of the name must be
+  // alphanumeric and less than or equal to 32 characters and greater than 0
+  // characters in length.
+  Finding finding = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // The FieldMask to use when updating the finding resource. This field should
+  // not be specified when creating a finding.
+  //
+  // When updating a finding, an empty mask is treated as updating all mutable
+  // fields and replacing source_properties.  Individual source_properties can
+  // be added/updated by using "source_properties." in the field
+  // mask.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for updating a notification config.
+message UpdateNotificationConfigRequest {
+  // Required. The notification config to update.
+  NotificationConfig notification_config = 1
+      [(google.api.field_behavior) = REQUIRED];
+
+  // The FieldMask to use when updating the notification config.
+  //
+  // If empty all mutable fields will be updated.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for updating an organization's settings.
+message UpdateOrganizationSettingsRequest {
+  // Required. The organization settings resource to update.
+  OrganizationSettings organization_settings = 1
+      [(google.api.field_behavior) = REQUIRED];
+
+  // The FieldMask to use when updating the settings resource.
+  //
+  //  If empty all mutable fields will be updated.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for updating a source.
+message UpdateSourceRequest {
+  // Required. The source resource to update.
+  Source source = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // The FieldMask to use when updating the source resource.
+  //
+  // If empty all mutable fields will be updated.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// Request message for updating a SecurityMarks resource.
+message UpdateSecurityMarksRequest {
+  // Required. The security marks resource to update.
+  SecurityMarks security_marks = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // The FieldMask to use when updating the security marks resource.
+  //
+  // The field mask must not contain duplicate fields.
+  // If empty or set to "marks", all marks will be replaced.  Individual
+  // marks can be updated using "marks.".
+  google.protobuf.FieldMask update_mask = 2;
+
+  // The time at which the updated SecurityMarks take effect.
+  // If not set uses current server time.  Updates will be applied to the
+  // SecurityMarks that are active immediately preceding this time.
+  google.protobuf.Timestamp start_time = 3;
+}
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/securitycenter_v1p1beta1.yaml b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/securitycenter_v1p1beta1.yaml
new file mode 100644
index 000000000..3c7319584
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/securitycenter_v1p1beta1.yaml
@@ -0,0 +1,49 @@
+type: google.api.Service
+config_version: 3
+name: securitycenter.googleapis.com
+title: Cloud Security Command Center API
+
+apis:
+- name: google.cloud.securitycenter.v1p1beta1.SecurityCenter
+
+types:
+- name: google.cloud.securitycenter.v1p1beta1.NotificationMessage
+- name: google.cloud.securitycenter.v1p1beta1.RunAssetDiscoveryResponse
+
+documentation:
+  summary: |-
+    Cloud Security Command Center API provides access to temporal views of
+    assets and findings within an organization.
+
+backend:
+  rules:
+  - selector: 'google.cloud.securitycenter.v1p1beta1.SecurityCenter.*'
+    deadline: 480.0
+  - selector: 'google.longrunning.Operations.*'
+    deadline: 60.0
+
+http:
+  rules:
+  - selector: google.longrunning.Operations.ListOperations
+    get: '/v1p1beta1/{name=organizations/*/operations}'
+
+  - selector: google.longrunning.Operations.GetOperation
+    get: '/v1p1beta1/{name=organizations/*/operations/*}'
+
+  - selector: google.longrunning.Operations.DeleteOperation
+    delete: '/v1p1beta1/{name=organizations/*/operations/*}'
+
+  - selector: google.longrunning.Operations.CancelOperation
+    post: '/v1p1beta1/{name=organizations/*/operations/*}:cancel'
+    body: '*'
+
+authentication:
+  rules:
+  - selector: 'google.cloud.securitycenter.v1p1beta1.SecurityCenter.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/source.proto b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/source.proto
new file mode 100644
index 000000000..d591a05cc
--- /dev/null
+++ b/third_party/googleapis/google/cloud/securitycenter/v1p1beta1/source.proto
@@ -0,0 +1,60 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.securitycenter.v1p1beta1;
+
+import "google/api/annotations.proto";
+import "google/api/resource.proto";
+
+option csharp_namespace = "Google.Cloud.SecurityCenter.V1P1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/securitycenter/v1p1beta1;securitycenter";
+option java_multiple_files = true;
+option java_package = "com.google.cloud.securitycenter.v1p1beta1";
+option php_namespace = "Google\\Cloud\\SecurityCenter\\V1p1beta1";
+option ruby_package = "Google::Cloud::SecurityCenter::V1p1beta1";
+
+// Cloud Security Command Center's (Cloud SCC) finding source. A finding source
+// is an entity or a mechanism that can produce a finding. A source is like a
+// container of findings that come from the same scanner, logger, monitor, etc.
+message Source {
+  option (google.api.resource) = {
+    type: "securitycenter.googleapis.com/Source"
+    pattern: "organizations/{organization}/sources/{source}"
+  };
+
+  // The relative resource name of this source. See:
+  // https://cloud.google.com/apis/design/resource_names#relative_resource_name
+  // Example:
+  // "organizations/{organization_id}/sources/{source_id}"
+  string name = 1;
+
+  // The source's display name.
+  // A source's display name must be unique amongst its siblings, for example,
+  // two sources with the same parent can't share the same display name.
+  // The display name must have a length between 1 and 64 characters
+  // (inclusive).
+  string display_name = 2;
+
+  // The description of the source (max of 1024 characters).
+  // Example:
+  // "Cloud Security Scanner is a web security scanner for common
+  // vulnerabilities in App Engine applications. It can automatically
+  // scan and detect four common vulnerabilities, including cross-site-scripting
+  // (XSS), Flash injection, mixed content (HTTP in HTTPS), and
+  // outdated/insecure libraries."
+  string description = 3;
+}
diff --git a/third_party/googleapis/google/cloud/servicedirectory/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/servicedirectory/v1beta1/BUILD.bazel
new file mode 100644
index 000000000..13efb63ed
--- /dev/null
+++ b/third_party/googleapis/google/cloud/servicedirectory/v1beta1/BUILD.bazel
@@ -0,0 +1,368 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "servicedirectory_proto",
+    srcs = [
+        "endpoint.proto",
+        "lookup_service.proto",
+        "namespace.proto",
+        "registration_service.proto",
+        "service.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/iam/v1:iam_policy_proto",
+        "//google/iam/v1:policy_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "servicedirectory_proto_with_info",
+    deps = [
+        ":servicedirectory_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "servicedirectory_java_proto",
+    deps = [":servicedirectory_proto"],
+)
+
+java_grpc_library(
+    name = "servicedirectory_java_grpc",
+    srcs = [":servicedirectory_proto"],
+    deps = [":servicedirectory_java_proto"],
+)
+
+java_gapic_library(
+    name = "servicedirectory_java_gapic",
+    src = ":servicedirectory_proto_with_info",
+    gapic_yaml = "servicedirectory_gapic.yaml",
+    package = "google.cloud.servicedirectory.v1beta1",
+    service_yaml = "servicedirectory_v1beta1.yaml",
+    test_deps = [
+        ":servicedirectory_java_grpc",
+        "//google/iam/v1:iam_java_grpc",
+    ],
+    deps = [
+        ":servicedirectory_java_proto",
+        "//google/iam/v1:iam_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "servicedirectory_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.servicedirectory.v1beta1.LookupServiceClientTest",
+        "com.google.cloud.servicedirectory.v1beta1.RegistrationServiceClientTest",
+    ],
+    runtime_deps = [":servicedirectory_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-servicedirectory-v1beta1-java",
+    deps = [
+        ":servicedirectory_java_gapic",
+        ":servicedirectory_java_grpc",
+        ":servicedirectory_java_proto",
+        ":servicedirectory_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "servicedirectory_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/servicedirectory/v1beta1",
+    protos = [":servicedirectory_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/iam/v1:iam_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "servicedirectory_go_gapic",
+    srcs = [":servicedirectory_proto_with_info"],
+    grpc_service_config = "servicedirectory_grpc_service_config.json",
+    importpath = "cloud.google.com/go/servicedirectory/apiv1beta1;servicedirectory",
+    service_yaml = "servicedirectory_v1beta1.yaml",
+    deps = [
+        ":servicedirectory_go_proto",
+        "//google/iam/v1:iam_go_proto",
+    ],
+)
+
+go_test(
+    name = "servicedirectory_go_gapic_test",
+    srcs = [":servicedirectory_go_gapic_srcjar_test"],
+    embed = [":servicedirectory_go_gapic"],
+    importpath = "cloud.google.com/go/servicedirectory/apiv1beta1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-servicedirectory-v1beta1-go",
+    deps = [
+        ":servicedirectory_go_gapic",
+        ":servicedirectory_go_gapic_srcjar-test.srcjar",
+        ":servicedirectory_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "servicedirectory_moved_proto",
+    srcs = [":servicedirectory_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/iam/v1:iam_policy_proto",
+        "//google/iam/v1:policy_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+    ],
+)
+
+py_proto_library(
+    name = "servicedirectory_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":servicedirectory_moved_proto"],
+)
+
+py_grpc_library(
+    name = "servicedirectory_py_grpc",
+    srcs = [":servicedirectory_moved_proto"],
+    deps = [":servicedirectory_py_proto"],
+)
+
+py_gapic_library(
+    name = "servicedirectory_py_gapic",
+    src = ":servicedirectory_proto_with_info",
+    gapic_yaml = "servicedirectory_gapic.yaml",
+    package = "google.cloud.servicedirectory.v1beta1",
+    service_yaml = "servicedirectory_v1beta1.yaml",
+    deps = [
+        ":servicedirectory_py_grpc",
+        ":servicedirectory_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "servicedirectory-v1beta1-py",
+    deps = [
+        ":servicedirectory_py_gapic",
+        ":servicedirectory_py_grpc",
+        ":servicedirectory_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "servicedirectory_php_proto",
+    deps = [":servicedirectory_proto"],
+)
+
+php_grpc_library(
+    name = "servicedirectory_php_grpc",
+    srcs = [":servicedirectory_proto"],
+    deps = [":servicedirectory_php_proto"],
+)
+
+php_gapic_library(
+    name = "servicedirectory_php_gapic",
+    src = ":servicedirectory_proto_with_info",
+    gapic_yaml = "servicedirectory_gapic.yaml",
+    package = "google.cloud.servicedirectory.v1beta1",
+    service_yaml = "servicedirectory_v1beta1.yaml",
+    deps = [
+        ":servicedirectory_php_grpc",
+        ":servicedirectory_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-servicedirectory-v1beta1-php",
+    deps = [
+        ":servicedirectory_php_gapic",
+        ":servicedirectory_php_grpc",
+        ":servicedirectory_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "servicedirectory_nodejs_gapic",
+    src = ":servicedirectory_proto_with_info",
+    gapic_yaml = "servicedirectory_gapic.yaml",
+    package = "google.cloud.servicedirectory.v1beta1",
+    service_yaml = "servicedirectory_v1beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "servicedirectory-v1beta1-nodejs",
+    deps = [
+        ":servicedirectory_nodejs_gapic",
+        ":servicedirectory_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "servicedirectory_ruby_proto",
+    deps = [":servicedirectory_proto"],
+)
+
+ruby_grpc_library(
+    name = "servicedirectory_ruby_grpc",
+    srcs = [":servicedirectory_proto"],
+    deps = [":servicedirectory_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "servicedirectory_ruby_gapic",
+    src = ":servicedirectory_proto_with_info",
+    gapic_yaml = "servicedirectory_gapic.yaml",
+    package = "google.cloud.servicedirectory.v1beta1",
+    service_yaml = "servicedirectory_v1beta1.yaml",
+    deps = [
+        ":servicedirectory_ruby_grpc",
+        ":servicedirectory_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-servicedirectory-v1beta1-ruby",
+    deps = [
+        ":servicedirectory_ruby_gapic",
+        ":servicedirectory_ruby_grpc",
+        ":servicedirectory_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "servicedirectory_csharp_proto",
+    deps = [":servicedirectory_proto"],
+)
+
+csharp_grpc_library(
+    name = "servicedirectory_csharp_grpc",
+    srcs = [":servicedirectory_proto"],
+    deps = [":servicedirectory_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "servicedirectory_csharp_gapic",
+    src = ":servicedirectory_proto_with_info",
+    gapic_yaml = "servicedirectory_gapic.yaml",
+    package = "google.cloud.servicedirectory.v1beta1",
+    service_yaml = "servicedirectory_v1beta1.yaml",
+    deps = [
+        ":servicedirectory_csharp_grpc",
+        ":servicedirectory_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-servicedirectory-v1beta1-csharp",
+    deps = [
+        ":servicedirectory_csharp_gapic",
+        ":servicedirectory_csharp_grpc",
+        ":servicedirectory_csharp_proto",
+    ],
+)
diff --git a/third_party/googleapis/google/cloud/servicedirectory/v1beta1/endpoint.proto b/third_party/googleapis/google/cloud/servicedirectory/v1beta1/endpoint.proto
new file mode 100644
index 000000000..5a4bede2a
--- /dev/null
+++ b/third_party/googleapis/google/cloud/servicedirectory/v1beta1/endpoint.proto
@@ -0,0 +1,63 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.servicedirectory.v1beta1;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/api/annotations.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.ServiceDirectory.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/servicedirectory/v1beta1;servicedirectory";
+option java_multiple_files = true;
+option java_outer_classname = "EndpointProto";
+option java_package = "com.google.cloud.servicedirectory.v1beta1";
+option php_namespace = "Google\\Cloud\\ServiceDirectory\\V1beta1";
+option ruby_package = "Google::Cloud::ServiceDirectory::V1beta1";
+
+// An individual endpoint that provides a
+// [service][google.cloud.servicedirectory.v1beta1.Service]. The service must
+// already exist to create an endpoint.
+message Endpoint {
+  option (google.api.resource) = {
+    type: "servicedirectory.googleapis.com/Endpoint"
+    pattern: "projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}/endpoints/{endpoint}"
+  };
+
+  // Immutable. The resource name for the endpoint in the format
+  // 'projects/*/locations/*/namespaces/*/services/*/endpoints/*'.
+  string name = 1 [(google.api.field_behavior) = IMMUTABLE];
+
+  // Optional. An IPv4 or IPv6 address. Service Directory will reject bad
+  // addresses like:
+  //   "8.8.8"
+  //   "8.8.8.8:53"
+  //   "test:bad:address"
+  //   "[::1]"
+  //   "[::1]:8080"
+  // Limited to 45 characters.
+  string address = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Service Directory will reject values outside of [0, 65535].
+  int32 port = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Metadata for the endpoint. This data can be consumed by service
+  // clients.  The entire metadata dictionary may contain up to 512 characters,
+  // spread accoss all key-value pairs. Metadata that goes beyond any these
+  // limits will be rejected.
+  map metadata = 4 [(google.api.field_behavior) = OPTIONAL];
+}
diff --git a/third_party/googleapis/google/cloud/servicedirectory/v1beta1/lookup_service.proto b/third_party/googleapis/google/cloud/servicedirectory/v1beta1/lookup_service.proto
new file mode 100644
index 000000000..24c6c8fc2
--- /dev/null
+++ b/third_party/googleapis/google/cloud/servicedirectory/v1beta1/lookup_service.proto
@@ -0,0 +1,90 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.servicedirectory.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/servicedirectory/v1beta1/service.proto";
+import "google/api/client.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.ServiceDirectory.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/servicedirectory/v1beta1;servicedirectory";
+option java_multiple_files = true;
+option java_outer_classname = "LookupServiceProto";
+option java_package = "com.google.cloud.servicedirectory.v1beta1";
+option php_namespace = "Google\\Cloud\\ServiceDirectory\\V1beta1";
+option ruby_package = "Google::Cloud::ServiceDirectory::V1beta1";
+
+// Service Directory API for looking up service data at runtime.
+service LookupService {
+  option (google.api.default_host) = "servicedirectory.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // Returns a [service][google.cloud.servicedirectory.v1beta1.Service] and its
+  // associated endpoints.
+  // Resolving a service is not considered an active developer method.
+  rpc ResolveService(ResolveServiceRequest) returns (ResolveServiceResponse) {
+    option (google.api.http) = {
+      post: "/v1beta1/{name=projects/*/locations/*/namespaces/*/services/*}:resolve"
+      body: "*"
+    };
+  }
+}
+
+// The request message for [LookupService.ResolveService][google.cloud.servicedirectory.v1beta1.LookupService.ResolveService].
+// Looks up a service by its name, returns the service and its endpoints.
+message ResolveServiceRequest {
+  // Required. The name of the service to resolve.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "servicedirectory.googleapis.com/Service"
+    }
+  ];
+
+  // Optional. The maximum number of endpoints to return. Defaults to 25. Maximum is 100.
+  // If a value less than one is specified, the Default is used.
+  // If a value greater than the Maximum is specified, the Maximum is used.
+  int32 max_endpoints = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The filter applied to the endpoints of the resolved service.
+  //
+  // General filter string syntax:
+  //    ()
+  //  can be "name" or "metadata." for map field.
+  //  can be "<, >, <=, >=, !=, =, :". Of which ":" means HAS and is
+  // roughly the same as "=".
+  //  must be the same data type as the field.
+  //  can be "AND, OR, NOT".
+  //
+  // Examples of valid filters:
+  // * "metadata.owner" returns Endpoints that have a label with the
+  //   key "owner", this is the same as "metadata:owner"
+  // * "metadata.protocol=gRPC" returns Endpoints that have key/value
+  //   "protocol=gRPC"
+  // * "metadata.owner!=sd AND metadata.foo=bar" returns
+  //   Endpoints that have "owner" field in metadata with a value that is not
+  //   "sd" AND have the key/value foo=bar.
+  string endpoint_filter = 3 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// The response message for [LookupService.ResolveService][google.cloud.servicedirectory.v1beta1.LookupService.ResolveService].
+message ResolveServiceResponse {
+  Service service = 1;
+}
diff --git a/third_party/googleapis/google/cloud/servicedirectory/v1beta1/namespace.proto b/third_party/googleapis/google/cloud/servicedirectory/v1beta1/namespace.proto
new file mode 100644
index 000000000..3e5722206
--- /dev/null
+++ b/third_party/googleapis/google/cloud/servicedirectory/v1beta1/namespace.proto
@@ -0,0 +1,49 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.servicedirectory.v1beta1;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/api/annotations.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.ServiceDirectory.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/servicedirectory/v1beta1;servicedirectory";
+option java_multiple_files = true;
+option java_outer_classname = "NamespaceProto";
+option java_package = "com.google.cloud.servicedirectory.v1beta1";
+option php_namespace = "Google\\Cloud\\ServiceDirectory\\V1beta1";
+option ruby_package = "Google::Cloud::ServiceDirectory::V1beta1";
+
+// A container for [services][google.cloud.servicedirectory.v1beta1.Service].
+// Namespaces allow administrators to group services together and define
+// permissions for a collection of services.
+message Namespace {
+  option (google.api.resource) = {
+    type: "servicedirectory.googleapis.com/Namespace"
+    pattern: "projects/{project}/locations/{location}/namespaces/{namespace}"
+  };
+
+  // Immutable. The resource name for the namespace in the format
+  // 'projects/*/locations/*/namespaces/*'.
+  string name = 1 [(google.api.field_behavior) = IMMUTABLE];
+
+  // Optional. Resource labels associated with this Namespace.
+  // No more than 64 user labels can be associated with a given resource.  Label
+  // keys and values can be no longer than 63 characters.
+  map labels = 2 [(google.api.field_behavior) = OPTIONAL];
+}
diff --git a/third_party/googleapis/google/cloud/servicedirectory/v1beta1/registration_service.proto b/third_party/googleapis/google/cloud/servicedirectory/v1beta1/registration_service.proto
new file mode 100644
index 000000000..2c6dc8d40
--- /dev/null
+++ b/third_party/googleapis/google/cloud/servicedirectory/v1beta1/registration_service.proto
@@ -0,0 +1,569 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.servicedirectory.v1beta1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/servicedirectory/v1beta1/endpoint.proto";
+import "google/cloud/servicedirectory/v1beta1/namespace.proto";
+import "google/cloud/servicedirectory/v1beta1/service.proto";
+import "google/iam/v1/iam_policy.proto";
+import "google/iam/v1/policy.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.ServiceDirectory.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/servicedirectory/v1beta1;servicedirectory";
+option java_multiple_files = true;
+option java_outer_classname = "RegistrationServiceProto";
+option java_package = "com.google.cloud.servicedirectory.v1beta1";
+option php_namespace = "Google\\Cloud\\ServiceDirectory\\V1beta1";
+option ruby_package = "Google::Cloud::ServiceDirectory::V1beta1";
+
+// Service Directory API for registering services. It defines the following
+// resource model:
+//
+// - The API has a collection of
+// [Namespace][google.cloud.servicedirectory.v1beta1.Namespace]
+// resources, named `projects/*/locations/*/namespaces/*`.
+//
+// - Each Namespace has a collection of
+// [Service][google.cloud.servicedirectory.v1beta1.Service] resources, named
+// `projects/*/locations/*/namespaces/*/services/*`.
+//
+// - Each Service has a collection of
+// [Endpoint][google.cloud.servicedirectory.v1beta1.Endpoint]
+// resources, named
+// `projects/*/locations/*/namespaces/*/services/*/endpoints/*`.
+service RegistrationService {
+  option (google.api.default_host) = "servicedirectory.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // Creates a namespace, and returns the new Namespace.
+  rpc CreateNamespace(CreateNamespaceRequest) returns (Namespace) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/locations/*}/namespaces"
+      body: "namespace"
+    };
+    option (google.api.method_signature) = "parent,namespace,namespace_id";
+  }
+
+  // Lists all namespaces.
+  rpc ListNamespaces(ListNamespacesRequest) returns (ListNamespacesResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/locations/*}/namespaces"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Gets a namespace.
+  rpc GetNamespace(GetNamespaceRequest) returns (Namespace) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/locations/*/namespaces/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Updates a namespace.
+  rpc UpdateNamespace(UpdateNamespaceRequest) returns (Namespace) {
+    option (google.api.http) = {
+      patch: "/v1beta1/{namespace.name=projects/*/locations/*/namespaces/*}"
+      body: "namespace"
+    };
+    option (google.api.method_signature) = "namespace,update_mask";
+  }
+
+  // Deletes a namespace. This also deletes all services and endpoints in
+  // the namespace.
+  rpc DeleteNamespace(DeleteNamespaceRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/locations/*/namespaces/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Creates a service, and returns the new Service.
+  rpc CreateService(CreateServiceRequest) returns (Service) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/locations/*/namespaces/*}/services"
+      body: "service"
+    };
+    option (google.api.method_signature) = "parent,service,service_id";
+  }
+
+  // Lists all services belonging to a namespace.
+  rpc ListServices(ListServicesRequest) returns (ListServicesResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/locations/*/namespaces/*}/services"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Gets a service.
+  rpc GetService(GetServiceRequest) returns (Service) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/locations/*/namespaces/*/services/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Updates a service.
+  rpc UpdateService(UpdateServiceRequest) returns (Service) {
+    option (google.api.http) = {
+      patch: "/v1beta1/{service.name=projects/*/locations/*/namespaces/*/services/*}"
+      body: "service"
+    };
+    option (google.api.method_signature) = "service,update_mask";
+  }
+
+  // Deletes a service. This also deletes all endpoints associated with
+  // the service.
+  rpc DeleteService(DeleteServiceRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/locations/*/namespaces/*/services/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Creates a endpoint, and returns the new Endpoint.
+  rpc CreateEndpoint(CreateEndpointRequest) returns (Endpoint) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/locations/*/namespaces/*/services/*}/endpoints"
+      body: "endpoint"
+    };
+    option (google.api.method_signature) = "parent,endpoint,endpoint_id";
+  }
+
+  // Lists all endpoints.
+  rpc ListEndpoints(ListEndpointsRequest) returns (ListEndpointsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta1/{parent=projects/*/locations/*/namespaces/*/services/*}/endpoints"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Gets a endpoint.
+  rpc GetEndpoint(GetEndpointRequest) returns (Endpoint) {
+    option (google.api.http) = {
+      get: "/v1beta1/{name=projects/*/locations/*/namespaces/*/services/*/endpoints/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Updates a endpoint.
+  rpc UpdateEndpoint(UpdateEndpointRequest) returns (Endpoint) {
+    option (google.api.http) = {
+      patch: "/v1beta1/{endpoint.name=projects/*/locations/*/namespaces/*/services/*/endpoints/*}"
+      body: "endpoint"
+    };
+    option (google.api.method_signature) = "endpoint,update_mask";
+  }
+
+  // Deletes a endpoint.
+  rpc DeleteEndpoint(DeleteEndpointRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1beta1/{name=projects/*/locations/*/namespaces/*/services/*/endpoints/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Gets the IAM Policy for a resource (namespace or service only).
+  rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) returns (google.iam.v1.Policy) {
+    option (google.api.http) = {
+      post: "/v1beta1/{resource=projects/*/locations/*/namespaces/*}:getIamPolicy"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/{resource=projects/*/locations/*/namespaces/*/services/*}:getIamPolicy"
+        body: "*"
+      }
+    };
+  }
+
+  // Sets the IAM Policy for a resource (namespace or service only).
+  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) returns (google.iam.v1.Policy) {
+    option (google.api.http) = {
+      post: "/v1beta1/{resource=projects/*/locations/*/namespaces/*}:setIamPolicy"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/{resource=projects/*/locations/*/namespaces/*/services/*}:setIamPolicy"
+        body: "*"
+      }
+    };
+  }
+
+  // Tests IAM permissions for a resource (namespace or service only).
+  rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest) returns (google.iam.v1.TestIamPermissionsResponse) {
+    option (google.api.http) = {
+      post: "/v1beta1/{resource=projects/*/locations/*/namespaces/*}:testIamPermissions"
+      body: "*"
+      additional_bindings {
+        post: "/v1beta1/{resource=projects/*/locations/*/namespaces/*/services/*}:testIamPermissions"
+        body: "*"
+      }
+    };
+  }
+}
+
+// The request message for [RegistrationService.CreateNamespace][google.cloud.servicedirectory.v1beta1.RegistrationService.CreateNamespace].
+message CreateNamespaceRequest {
+  // Required. The resource name of the project and location the namespace
+  // will be created in.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // Required. The Resource ID must be 1-63 characters long, and comply with
+  // RFC1035.
+  // Specifically, the name must be 1-63 characters long and match the regular
+  // expression `[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?` which means the first
+  // character must be a lowercase letter, and all following characters must
+  // be a dash, lowercase letter, or digit, except the last character, which
+  // cannot be a dash.
+  string namespace_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. A namespace with initial fields set.
+  Namespace namespace = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The request message for [RegistrationService.ListNamespaces][google.cloud.servicedirectory.v1beta1.RegistrationService.ListNamespaces].
+message ListNamespacesRequest {
+  // Required. The resource name of the project and location whose namespaces we'd like to
+  // list.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // Optional. The maximum number of items to return.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The next_page_token value returned from a previous List request, if any.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The filter to list result by.
+  //
+  // General filter string syntax:
+  //    ()
+  //  can be "name", or "labels." for map field.
+  //  can be "<, >, <=, >=, !=, =, :". Of which ":" means HAS, and
+  // is roughly the same as "=".
+  //  must be the same data type as field.
+  //  can be "AND, OR, NOT".
+  //
+  // Examples of valid filters:
+  // * "labels.owner" returns Namespaces that have a label with the key "owner"
+  //   this is the same as "labels:owner".
+  // * "labels.protocol=gRPC" returns Namespaces that have key/value
+  //   "protocol=gRPC".
+  // * "name>projects/my-project/locations/us-east/namespaces/namespace-c"
+  //   returns Namespaces that have name that is alphabetically later than the
+  //   string, so "namespace-e" will be returned but "namespace-a" will not be.
+  // * "labels.owner!=sd AND labels.foo=bar" returns Namespaces that have
+  //   "owner" in label key but value is not "sd" AND have key/value foo=bar.
+  // * "doesnotexist.foo=bar" returns an empty list. Note that Namespace doesn't
+  //   have a field called "doesnotexist". Since the filter does not match any
+  //   Namespaces, it returns no results.
+  string filter = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The order to list result by.
+  //
+  // General order by string syntax:
+  //  () (,)
+  //  allows values {"name"}
+  //  ascending or descending order by . If this is left
+  // blank, "asc" is used.
+  // Note that an empty order_by string result in default order, which is order
+  // by name in ascending order.
+  string order_by = 5 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// The response message for [RegistrationService.ListNamespaces][google.cloud.servicedirectory.v1beta1.RegistrationService.ListNamespaces].
+message ListNamespacesResponse {
+  // The list of namespaces.
+  repeated Namespace namespaces = 1;
+
+  // Token to retrieve the next page of results, or empty if there are no
+  // more results in the list.
+  string next_page_token = 2;
+}
+
+// The request message for [RegistrationService.GetNamespace][google.cloud.servicedirectory.v1beta1.RegistrationService.GetNamespace].
+message GetNamespaceRequest {
+  // Required. The name of the namespace to retrieve.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "servicedirectory.googleapis.com/Namespace"
+    }
+  ];
+}
+
+// The request message for [RegistrationService.UpdateNamespace][google.cloud.servicedirectory.v1beta1.RegistrationService.UpdateNamespace].
+message UpdateNamespaceRequest {
+  // Required. The updated namespace.
+  Namespace namespace = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. List of fields to be updated in this request.
+  google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The request message for [RegistrationService.DeleteNamespace][google.cloud.servicedirectory.v1beta1.RegistrationService.DeleteNamespace].
+message DeleteNamespaceRequest {
+  // Required. The name of the namespace to delete.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "servicedirectory.googleapis.com/Namespace"
+    }
+  ];
+}
+
+// The request message for [RegistrationService.CreateService][google.cloud.servicedirectory.v1beta1.RegistrationService.CreateService].
+message CreateServiceRequest {
+  // Required. The resource name of the namespace this service will belong to.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "servicedirectory.googleapis.com/Namespace"
+    }
+  ];
+
+  // Required. The Resource ID must be 1-63 characters long, and comply with
+  // RFC1035.
+  // Specifically, the name must be 1-63 characters long and match the regular
+  // expression `[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?` which means the first
+  // character must be a lowercase letter, and all following characters must
+  // be a dash, lowercase letter, or digit, except the last character, which
+  // cannot be a dash.
+  string service_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. A service  with initial fields set.
+  Service service = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The request message for [RegistrationService.ListServices][google.cloud.servicedirectory.v1beta1.RegistrationService.ListServices].
+message ListServicesRequest {
+  // Required. The resource name of the namespace whose services we'd
+  // like to list.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "servicedirectory.googleapis.com/Namespace"
+    }
+  ];
+
+  // Optional. The maximum number of items to return.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The next_page_token value returned from a previous List request,
+  // if any.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The filter to list result by.
+  //
+  // General filter string syntax:
+  //    ()
+  //  can be "name", or "metadata." for map field.
+  //  can be "<, >, <=, >=, !=, =, :". Of which ":" means HAS, and
+  // is roughly the same as "=".
+  //  must be the same data type as field.
+  //  can be "AND, OR, NOT".
+  //
+  // Examples of valid filters:
+  // * "metadata.owner" returns Services that have a label with the key "owner"
+  //   this is the same as "metadata:owner".
+  // * "metadata.protocol=gRPC" returns Services that have key/value
+  //   "protocol=gRPC".
+  // * "name>projects/my-project/locations/us-east/namespaces/my-namespace/services/service-c"
+  //   returns Services that have name that is alphabetically later than the
+  //   string, so "service-e" will be returned but "service-a" will not be.
+  // * "metadata.owner!=sd AND metadata.foo=bar" returns Services that have
+  //   "owner" in label key but value is not "sd" AND have key/value foo=bar.
+  // * "doesnotexist.foo=bar" returns an empty list. Note that Service doesn't
+  //   have a field called "doesnotexist". Since the filter does not match any
+  //   Services, it returns no results.
+  string filter = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The order to list result by.
+  string order_by = 5 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// The response message for [RegistrationService.ListServices][google.cloud.servicedirectory.v1beta1.RegistrationService.ListServices].
+message ListServicesResponse {
+  // The list of services.
+  repeated Service services = 1;
+
+  // Token to retrieve the next page of results, or empty if there are no
+  // more results in the list.
+  string next_page_token = 2;
+}
+
+// The request message for [RegistrationService.GetService][google.cloud.servicedirectory.v1beta1.RegistrationService.GetService].
+// This should not be used for looking up a service. Insead, use the `resolve`
+// method as it will contain all endpoints and associated metadata.
+message GetServiceRequest {
+  // Required. The name of the service to get.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "servicedirectory.googleapis.com/Service"
+    }
+  ];
+}
+
+// The request message for [RegistrationService.UpdateService][google.cloud.servicedirectory.v1beta1.RegistrationService.UpdateService].
+message UpdateServiceRequest {
+  // Required. The updated service.
+  Service service = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. List of fields to be updated in this request.
+  google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The request message for [RegistrationService.DeleteService][google.cloud.servicedirectory.v1beta1.RegistrationService.DeleteService].
+message DeleteServiceRequest {
+  // Required. The name of the service to delete.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "servicedirectory.googleapis.com/Service"
+    }
+  ];
+}
+
+// The request message for [RegistrationService.CreateEndpoint][google.cloud.servicedirectory.v1beta1.RegistrationService.CreateEndpoint].
+message CreateEndpointRequest {
+  // Required. The resource name of the service that this endpoint provides.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "servicedirectory.googleapis.com/Service"
+    }
+  ];
+
+  // Required. The Resource ID must be 1-63 characters long, and comply with
+  // RFC1035.
+  // Specifically, the name must be 1-63 characters long and match the regular
+  // expression `[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?` which means the first
+  // character must be a lowercase letter, and all following characters must
+  // be a dash, lowercase letter, or digit, except the last character, which
+  // cannot be a dash.
+  string endpoint_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. A endpoint with initial fields set.
+  Endpoint endpoint = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The request message for [RegistrationService.ListEndpoints][google.cloud.servicedirectory.v1beta1.RegistrationService.ListEndpoints].
+message ListEndpointsRequest {
+  // Required. The resource name of the service whose endpoints we'd like to
+  // list.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "servicedirectory.googleapis.com/Service"
+    }
+  ];
+
+  // Optional. The maximum number of items to return.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The next_page_token value returned from a previous List request,
+  // if any.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The filter to list result by.
+  //
+  // General filter string syntax:
+  //    ()
+  //  can be "name", "address", "port" or "metadata." for map field.
+  //  can be "<, >, <=, >=, !=, =, :". Of which ":" means HAS, and
+  // is roughly the same as "=".
+  //  must be the same data type as field.
+  //  can be "AND, OR, NOT".
+  //
+  // Examples of valid filters:
+  // * "metadata.owner" returns Endpoints that have a label with the key "owner"
+  //   this is the same as "metadata:owner".
+  // * "metadata.protocol=gRPC" returns Endpoints that have key/value
+  //   "protocol=gRPC".
+  // * "address=192.108.1.105" returns Endpoints that have this address.
+  // * "port>8080" returns Endpoints that have port number larger than 8080.
+  // * "name>projects/my-project/locations/us-east/namespaces/my-namespace/services/my-service/endpoints/endpoint-c"
+  //   returns Endpoints that have name that is alphabetically later than the
+  //   string, so "endpoint-e" will be returned but "endpoint-a" will not be.
+  // * "metadata.owner!=sd AND metadata.foo=bar" returns Endpoints that have
+  //   "owner" in label key but value is not "sd" AND have key/value foo=bar.
+  // * "doesnotexist.foo=bar" returns an empty list. Note that Endpoint doesn't
+  //   have a field called "doesnotexist". Since the filter does not match any
+  //   Endpoints, it returns no results.
+  string filter = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The order to list result by.
+  string order_by = 5 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// The response message for [RegistrationService.ListEndpoints][google.cloud.servicedirectory.v1beta1.RegistrationService.ListEndpoints].
+message ListEndpointsResponse {
+  // The list of endpoints.
+  repeated Endpoint endpoints = 1;
+
+  // Token to retrieve the next page of results, or empty if there are no
+  // more results in the list.
+  string next_page_token = 2;
+}
+
+// The request message for [RegistrationService.GetEndpoint][google.cloud.servicedirectory.v1beta1.RegistrationService.GetEndpoint].
+// This should not be used to lookup endpoints at runtime. Instead, use
+// the `resolve` method.
+message GetEndpointRequest {
+  // Required. The name of the endpoint to get.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "servicedirectory.googleapis.com/Endpoint"
+    }
+  ];
+}
+
+// The request message for [RegistrationService.UpdateEndpoint][google.cloud.servicedirectory.v1beta1.RegistrationService.UpdateEndpoint].
+message UpdateEndpointRequest {
+  // Required. The updated endpoint.
+  Endpoint endpoint = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. List of fields to be updated in this request.
+  google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The request message for [RegistrationService.DeleteEndpoint][google.cloud.servicedirectory.v1beta1.RegistrationService.DeleteEndpoint].
+message DeleteEndpointRequest {
+  // Required. The name of the endpoint to delete.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "servicedirectory.googleapis.com/Endpoint"
+    }
+  ];
+}
diff --git a/third_party/googleapis/google/cloud/servicedirectory/v1beta1/service.proto b/third_party/googleapis/google/cloud/servicedirectory/v1beta1/service.proto
new file mode 100644
index 000000000..3e712ccd1
--- /dev/null
+++ b/third_party/googleapis/google/cloud/servicedirectory/v1beta1/service.proto
@@ -0,0 +1,56 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.servicedirectory.v1beta1;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/servicedirectory/v1beta1/endpoint.proto";
+import "google/api/annotations.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.ServiceDirectory.V1Beta1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/servicedirectory/v1beta1;servicedirectory";
+option java_multiple_files = true;
+option java_outer_classname = "ServiceProto";
+option java_package = "com.google.cloud.servicedirectory.v1beta1";
+option php_namespace = "Google\\Cloud\\ServiceDirectory\\V1beta1";
+option ruby_package = "Google::Cloud::ServiceDirectory::V1beta1";
+
+// An individual service. A service contains a name and optional metadata.
+// A service must exist before
+// [endpoints][google.cloud.servicedirectory.v1beta1.Endpoint] can be
+// added to it.
+message Service {
+  option (google.api.resource) = {
+    type: "servicedirectory.googleapis.com/Service"
+    pattern: "projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}"
+  };
+
+  // Immutable. The resource name for the service in the format
+  // 'projects/*/locations/*/namespaces/*/services/*'.
+  string name = 1 [(google.api.field_behavior) = IMMUTABLE];
+
+  // Optional. Metadata for the service. This data can be consumed by service
+  // clients.  The entire metadata dictionary may contain up to 2000 characters,
+  // spread across all key-value pairs. Metadata that goes beyond any these
+  // limits will be rejected.
+  map metadata = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Output only. Endpoints associated with this service. Returned on LookupService.Resolve.
+  // Control plane clients should use RegistrationService.ListEndpoints.
+  repeated Endpoint endpoints = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
diff --git a/third_party/googleapis/google/cloud/servicedirectory/v1beta1/servicedirectory_gapic.yaml b/third_party/googleapis/google/cloud/servicedirectory/v1beta1/servicedirectory_gapic.yaml
new file mode 100644
index 000000000..369d2fbcc
--- /dev/null
+++ b/third_party/googleapis/google/cloud/servicedirectory/v1beta1/servicedirectory_gapic.yaml
@@ -0,0 +1,18 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 2.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.servicedirectory.v1beta1
+  python:
+    package_name: google.cloud.servicedirectory_v1beta1.gapic
+  go:
+    package_name: cloud.google.com/go/servicedirectory/apiv1beta1
+  csharp:
+    package_name: Google.Cloud.ServiceDirectory.V1Beta1
+  ruby:
+    package_name: Google::Cloud::ServiceDirectory::V1beta1
+  php:
+    package_name: Google\Cloud\ServiceDirectory\V1beta1
+  nodejs:
+    package_name: servicedirectory.v1beta1
+    domain_layer_location: google-cloud
diff --git a/third_party/googleapis/google/cloud/servicedirectory/v1beta1/servicedirectory_grpc_service_config.json b/third_party/googleapis/google/cloud/servicedirectory/v1beta1/servicedirectory_grpc_service_config.json
new file mode 100644
index 000000000..b93b84f8c
--- /dev/null
+++ b/third_party/googleapis/google/cloud/servicedirectory/v1beta1/servicedirectory_grpc_service_config.json
@@ -0,0 +1,26 @@
+{
+  "methodConfig": [
+    {
+      "name": [{ "service": "google.cloud.servicedirectory.v1beta1.RegistrationService" }],
+      "timeout": "15s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "1s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": ["UNAVAILABLE", "UNKNOWN"]
+      }
+    },
+    {
+      "name": [{ "service": "google.cloud.servicedirectory.v1beta1.LookupService" }],
+      "timeout": "15s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "1s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": ["UNAVAILABLE", "UNKNOWN"]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/servicedirectory/v1beta1/servicedirectory_v1beta1.yaml b/third_party/googleapis/google/cloud/servicedirectory/v1beta1/servicedirectory_v1beta1.yaml
new file mode 100644
index 000000000..d9903063f
--- /dev/null
+++ b/third_party/googleapis/google/cloud/servicedirectory/v1beta1/servicedirectory_v1beta1.yaml
@@ -0,0 +1,22 @@
+type: google.api.Service
+config_version: 3
+name: servicedirectory.googleapis.com
+title: Service Directory API
+
+apis:
+- name: google.cloud.servicedirectory.v1beta1.LookupService
+- name: google.cloud.servicedirectory.v1beta1.RegistrationService
+
+documentation:
+  summary: Allows the registration and lookup of services.
+
+authentication:
+  rules:
+  - selector: google.cloud.servicedirectory.v1beta1.LookupService.ResolveService
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.cloud.servicedirectory.v1beta1.RegistrationService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/speech/BUILD.bazel b/third_party/googleapis/google/cloud/speech/BUILD.bazel
index 1e5b8c2af..a87c57fec 100644
--- a/third_party/googleapis/google/cloud/speech/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/speech/BUILD.bazel
@@ -1 +1 @@
-exports_files(glob(["*.yaml"]))
\ No newline at end of file
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/cloud/speech/artman_speech_v1.yaml b/third_party/googleapis/google/cloud/speech/artman_speech_v1.yaml
index c781940ea..7054bef52 100644
--- a/third_party/googleapis/google/cloud/speech/artman_speech_v1.yaml
+++ b/third_party/googleapis/google/cloud/speech/artman_speech_v1.yaml
@@ -3,11 +3,13 @@ common:
   api_version: v1
   organization_name: google-cloud
   proto_deps:
-    - name: google-common-protos
+  - name: google-common-protos
   src_proto_paths:
   - v1
-  service_yaml: speech_v1.yaml
+  service_yaml: v1/speech_v1.yaml
   gapic_yaml: v1/speech_gapic.yaml
+  samples: v1/samples
+  proto_package: google.cloud.speech.v1
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/cloud/speech/artman_speech_v1p1beta1.yaml b/third_party/googleapis/google/cloud/speech/artman_speech_v1p1beta1.yaml
index fa2685425..63f659587 100644
--- a/third_party/googleapis/google/cloud/speech/artman_speech_v1p1beta1.yaml
+++ b/third_party/googleapis/google/cloud/speech/artman_speech_v1p1beta1.yaml
@@ -3,11 +3,13 @@ common:
   api_version: v1p1beta1
   organization_name: google-cloud
   proto_deps:
-    - name: google-common-protos
+  - name: google-common-protos
   src_proto_paths:
   - v1p1beta1
-  service_yaml: speech_v1p1beta1.yaml
+  service_yaml: v1p1beta1/speech_v1p1beta1.yaml
   gapic_yaml: v1p1beta1/speech_gapic.yaml
+  samples: v1p1beta1/samples
+  proto_package: google.cloud.speech.v1p1beta1
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/cloud/speech/sample_resources.yaml b/third_party/googleapis/google/cloud/speech/sample_resources.yaml
index 5c00fc694..afd4b7eab 100644
--- a/third_party/googleapis/google/cloud/speech/sample_resources.yaml
+++ b/third_party/googleapis/google/cloud/speech/sample_resources.yaml
@@ -1,5 +1,8 @@
 # Canonical GCS paths to resource files used by samples and sample system tests
 sample_resources:
+- uri: gs://cloud-samples-data/speech/brooklyn_bridge.mp3
+  description: |
+    44100 Hz, 2 channels, English, "How old is the Brooklyn Bridge?"
 - uri: gs://cloud-samples-data/speech/brooklyn_bridge.raw
   description: |
     16000 Hz, 1 channel, English, "How old is the Brooklyn Bridge?"
@@ -8,7 +11,7 @@ sample_resources:
     44100 Hz, 1 channel, English, "How old is the Brooklyn Bridge?"
 - uri: gs://cloud-samples-data/speech/brooklyn_bridge.wav
   description: |
-    16000 Hz, 2 channel (only first contains audio data), English, "How old is the Brooklyn Bridge?"
+    16000 Hz, 2 channels (only first contains audio data), English, "How old is the Brooklyn Bridge?"
 - uri: gs://cloud-samples-data/speech/hello.raw
   description: |
     16000 Hz, 1 channel, English, "Hello"
diff --git a/third_party/googleapis/google/cloud/speech/speech_v1p1beta1.yaml b/third_party/googleapis/google/cloud/speech/speech_v1p1beta1.yaml
deleted file mode 100644
index 8fefdf6ff..000000000
--- a/third_party/googleapis/google/cloud/speech/speech_v1p1beta1.yaml
+++ /dev/null
@@ -1,50 +0,0 @@
-type: google.api.Service
-config_version: 3
-name: speech.googleapis.com
-title: Cloud Speech API
-
-apis:
-- name: google.cloud.speech.v1p1beta1.Speech
-
-documentation:
-  summary: Converts audio to text by applying powerful neural network models.
-  overview: |-
-    # Introduction
-
-    Google Cloud Speech API provides speech recognition as a service.
-
-backend:
-  rules:
-  - selector: google.longrunning.Operations.ListOperations
-    deadline: 200.0
-  - selector: google.longrunning.Operations.GetOperation
-    deadline: 200.0
-  - selector: google.longrunning.Operations.WaitOperation
-    deadline: 200.0
-  - selector: google.cloud.speech.v1p1beta1.Speech.Recognize
-    deadline: 200.0
-  - selector: google.cloud.speech.v1p1beta1.Speech.LongRunningRecognize
-    deadline: 200.0
-  - selector: google.cloud.speech.v1p1beta1.Speech.StreamingRecognize
-    deadline: 905.0
-
-http:
-  rules:
-  - selector: google.longrunning.Operations.ListOperations
-    get: /v1/operations
-    additional_bindings:
-    - get: /v1beta1/operations
-  - selector: google.longrunning.Operations.GetOperation
-    get: '/v1/operations/{name=*}'
-    additional_bindings:
-    - get: '/v1beta1/operations/{name=*}'
-
-    - get: '/v1p1beta1/operations/{name=*}'
-
-
-authentication:
-  rules:
-  - selector: '*'
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/speech/v1/BUILD.bazel b/third_party/googleapis/google/cloud/speech/v1/BUILD.bazel
index 06dafe724..691de9b37 100644
--- a/third_party/googleapis/google/cloud/speech/v1/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/speech/v1/BUILD.bazel
@@ -1,9 +1,12 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
@@ -13,18 +16,22 @@ proto_library(
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
         "//google/longrunning:operations_proto",
         "//google/rpc:status_proto",
         "@com_google_protobuf//:any_proto",
         "@com_google_protobuf//:duration_proto",
-        "@com_google_protobuf//:empty_proto",
         "@com_google_protobuf//:timestamp_proto",
     ],
 )
 
 proto_library_with_info(
     name = "speech_proto_with_info",
-    deps = [":speech_proto"],
+    deps = [
+        ":speech_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -32,18 +39,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
     name = "speech_java_proto",
     deps = [":speech_proto"],
@@ -52,51 +54,40 @@ java_proto_library(
 java_grpc_library(
     name = "speech_java_grpc",
     srcs = [":speech_proto"],
-    deps = [":speech_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "speech_resource_name_java_proto",
-    gapic_yaml = "speech_gapic.yaml",
-    deps = [":speech_proto"],
+    deps = [":speech_java_proto"],
 )
 
 java_gapic_library(
     name = "speech_java_gapic",
     src = ":speech_proto_with_info",
     gapic_yaml = "speech_gapic.yaml",
-    service_yaml = "//google/cloud/speech:speech_v1.yaml",
-    test_deps = [":speech_java_grpc"],
+    package = "google.cloud.speech.v1",
+    service_yaml = "speech_v1.yaml",
+    test_deps = [
+        ":speech_java_grpc",
+    ],
     deps = [
         ":speech_java_proto",
-        ":speech_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":speech_java_gapic_test",
+java_gapic_test(
+    name = "speech_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.speech.v1.SpeechClientTest",
     ],
-) for test_name in [
-    "com.google.cloud.speech.v1.SpeechClientTest",
-]]
+    runtime_deps = [":speech_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-speech-v1-java",
-    client_deps = [":speech_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":speech_java_gapic_test"],
-    grpc_deps = [":speech_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":speech_java_gapic",
+        ":speech_java_grpc",
         ":speech_java_proto",
         ":speech_proto",
-        ":speech_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -104,10 +95,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -124,15 +115,18 @@ go_proto_library(
 
 go_gapic_library(
     name = "speech_go_gapic",
-    src = ":speech_proto_with_info",
-    gapic_yaml = "speech_gapic.yaml",
-    importpath = "cloud.google.com/go/speech/apiv1",
-    service_yaml = "//google/cloud/speech:speech_v1.yaml",
+    srcs = [":speech_proto_with_info"],
+    grpc_service_config = "speech_grpc_service_config.json",
+    importpath = "cloud.google.com/go/speech/apiv1;speech",
+    service_yaml = "speech_v1.yaml",
     deps = [
         ":speech_go_proto",
         "//google/longrunning:longrunning_go_gapic",
         "//google/longrunning:longrunning_go_proto",
         "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
+        "@io_bazel_rules_go//proto/wkt:any_go_proto",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
     ],
 )
 
@@ -143,13 +137,236 @@ go_test(
     importpath = "cloud.google.com/go/speech/apiv1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-speech-v1-go",
     deps = [
         ":speech_go_gapic",
-        ":speech_go_gapic_srcjar-smoke-test.srcjar",
         ":speech_go_gapic_srcjar-test.srcjar",
         ":speech_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "speech_moved_proto",
+    srcs = [":speech_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/longrunning:operations_proto",
+        "//google/rpc:status_proto",
+        "@com_google_protobuf//:any_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "speech_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":speech_moved_proto"],
+)
+
+py_grpc_library(
+    name = "speech_py_grpc",
+    srcs = [":speech_moved_proto"],
+    deps = [":speech_py_proto"],
+)
+
+py_gapic_library(
+    name = "speech_py_gapic",
+    src = ":speech_proto_with_info",
+    gapic_yaml = "speech_gapic.yaml",
+    package = "google.cloud.speech.v1",
+    service_yaml = "speech_v1.yaml",
+    deps = [
+        ":speech_py_grpc",
+        ":speech_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "speech-v1-py",
+    deps = [
+        ":speech_py_gapic",
+        ":speech_py_grpc",
+        ":speech_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "speech_php_proto",
+    deps = [":speech_proto"],
+)
+
+php_grpc_library(
+    name = "speech_php_grpc",
+    srcs = [":speech_proto"],
+    deps = [":speech_php_proto"],
+)
+
+php_gapic_library(
+    name = "speech_php_gapic",
+    src = ":speech_proto_with_info",
+    gapic_yaml = "speech_gapic.yaml",
+    package = "google.cloud.speech.v1",
+    service_yaml = "speech_v1.yaml",
+    deps = [
+        ":speech_php_grpc",
+        ":speech_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-speech-v1-php",
+    deps = [
+        ":speech_php_gapic",
+        ":speech_php_grpc",
+        ":speech_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "speech_nodejs_gapic",
+    src = ":speech_proto_with_info",
+    gapic_yaml = "speech_gapic.yaml",
+    package = "google.cloud.speech.v1",
+    service_yaml = "speech_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "speech-v1-nodejs",
+    deps = [
+        ":speech_nodejs_gapic",
+        ":speech_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "speech_ruby_proto",
+    deps = [":speech_proto"],
+)
+
+ruby_grpc_library(
+    name = "speech_ruby_grpc",
+    srcs = [":speech_proto"],
+    deps = [":speech_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "speech_ruby_gapic",
+    src = ":speech_proto_with_info",
+    gapic_yaml = "speech_gapic.yaml",
+    package = "google.cloud.speech.v1",
+    service_yaml = "speech_v1.yaml",
+    deps = [
+        ":speech_ruby_grpc",
+        ":speech_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-speech-v1-ruby",
+    deps = [
+        ":speech_ruby_gapic",
+        ":speech_ruby_grpc",
+        ":speech_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "speech_csharp_proto",
+    deps = [":speech_proto"],
+)
+
+csharp_grpc_library(
+    name = "speech_csharp_grpc",
+    srcs = [":speech_proto"],
+    deps = [":speech_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "speech_csharp_gapic",
+    src = ":speech_proto_with_info",
+    gapic_yaml = "speech_gapic.yaml",
+    package = "google.cloud.speech.v1",
+    service_yaml = "speech_v1.yaml",
+    deps = [
+        ":speech_csharp_grpc",
+        ":speech_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-speech-v1-csharp",
+    deps = [
+        ":speech_csharp_gapic",
+        ":speech_csharp_grpc",
+        ":speech_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/speech/v1/cloud_speech.proto b/third_party/googleapis/google/cloud/speech/v1/cloud_speech.proto
index 90ff515b5..f343fa21d 100644
--- a/third_party/googleapis/google/cloud/speech/v1/cloud_speech.proto
+++ b/third_party/googleapis/google/cloud/speech/v1/cloud_speech.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,7 +18,10 @@ syntax = "proto3";
 package google.cloud.speech.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/longrunning/operations.proto";
+import "google/protobuf/any.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
 import "google/rpc/status.proto";
@@ -28,9 +31,13 @@ option go_package = "google.golang.org/genproto/googleapis/cloud/speech/v1;speec
 option java_multiple_files = true;
 option java_outer_classname = "SpeechProto";
 option java_package = "com.google.cloud.speech.v1";
+option objc_class_prefix = "GCS";
 
 // Service that implements Google Cloud Speech API.
 service Speech {
+  option (google.api.default_host) = "speech.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Performs synchronous speech recognition: receive results after all audio
   // has been sent and processed.
   rpc Recognize(RecognizeRequest) returns (RecognizeResponse) {
@@ -38,52 +45,59 @@ service Speech {
       post: "/v1/speech:recognize"
       body: "*"
     };
+    option (google.api.method_signature) = "config,audio";
   }
 
   // Performs asynchronous speech recognition: receive results via the
   // google.longrunning.Operations interface. Returns either an
   // `Operation.error` or an `Operation.response` which contains
   // a `LongRunningRecognizeResponse` message.
-  rpc LongRunningRecognize(LongRunningRecognizeRequest)
-      returns (google.longrunning.Operation) {
+  // For more information on asynchronous speech recognition, see the
+  // [how-to](https://cloud.google.com/speech-to-text/docs/async-recognize).
+  rpc LongRunningRecognize(LongRunningRecognizeRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v1/speech:longrunningrecognize"
       body: "*"
     };
+    option (google.api.method_signature) = "config,audio";
+    option (google.longrunning.operation_info) = {
+      response_type: "LongRunningRecognizeResponse"
+      metadata_type: "LongRunningRecognizeMetadata"
+    };
   }
 
   // Performs bidirectional streaming speech recognition: receive results while
   // sending audio. This method is only available via the gRPC API (not REST).
-  rpc StreamingRecognize(stream StreamingRecognizeRequest)
-      returns (stream StreamingRecognizeResponse) {}
+  rpc StreamingRecognize(stream StreamingRecognizeRequest) returns (stream StreamingRecognizeResponse) {
+  }
 }
 
 // The top-level message sent by the client for the `Recognize` method.
 message RecognizeRequest {
-  // *Required* Provides information to the recognizer that specifies how to
+  // Required. Provides information to the recognizer that specifies how to
   // process the request.
-  RecognitionConfig config = 1;
+  RecognitionConfig config = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // *Required* The audio data to be recognized.
-  RecognitionAudio audio = 2;
+  // Required. The audio data to be recognized.
+  RecognitionAudio audio = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The top-level message sent by the client for the `LongRunningRecognize`
 // method.
 message LongRunningRecognizeRequest {
-  // *Required* Provides information to the recognizer that specifies how to
+  // Required. Provides information to the recognizer that specifies how to
   // process the request.
-  RecognitionConfig config = 1;
+  RecognitionConfig config = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // *Required* The audio data to be recognized.
-  RecognitionAudio audio = 2;
+  // Required. The audio data to be recognized.
+  RecognitionAudio audio = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The top-level message sent by the client for the `StreamingRecognize` method.
 // Multiple `StreamingRecognizeRequest` messages are sent. The first message
-// must contain a `streaming_config` message and must not contain `audio` data.
-// All subsequent messages must contain `audio` data and must not contain a
-// `streaming_config` message.
+// must contain a `streaming_config` message and must not contain
+// `audio_content`. All subsequent messages must contain `audio_content` and
+// must not contain a `streaming_config` message.
 message StreamingRecognizeRequest {
   // The streaming request, which is either a streaming config or audio content.
   oneof streaming_request {
@@ -97,9 +111,9 @@ message StreamingRecognizeRequest {
     // `StreamingRecognizeRequest` message must not contain `audio_content` data
     // and all subsequent `StreamingRecognizeRequest` messages must contain
     // `audio_content` data. The audio bytes must be encoded as specified in
-    // `RecognitionConfig`. Note: as with all bytes fields, protobuffers use a
+    // `RecognitionConfig`. Note: as with all bytes fields, proto buffers use a
     // pure binary representation (not base64). See
-    // [content limits](/speech-to-text/quotas#content).
+    // [content limits](https://cloud.google.com/speech-to-text/quotas#content).
     bytes audio_content = 2;
   }
 }
@@ -107,11 +121,11 @@ message StreamingRecognizeRequest {
 // Provides information to the recognizer that specifies how to process the
 // request.
 message StreamingRecognitionConfig {
-  // *Required* Provides information to the recognizer that specifies how to
+  // Required. Provides information to the recognizer that specifies how to
   // process the request.
-  RecognitionConfig config = 1;
+  RecognitionConfig config = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // *Optional* If `false` or omitted, the recognizer will perform continuous
+  // If `false` or omitted, the recognizer will perform continuous
   // recognition (continuing to wait for and process audio even if the user
   // pauses speaking) until the client closes the input stream (gRPC API) or
   // until the maximum time limit has been reached. May return multiple
@@ -124,7 +138,7 @@ message StreamingRecognitionConfig {
   // `true`.
   bool single_utterance = 2;
 
-  // *Optional* If `true`, interim results (tentative hypotheses) may be
+  // If `true`, interim results (tentative hypotheses) may be
   // returned as they become available (these interim results are indicated with
   // the `is_final=false` flag).
   // If `false` or omitted, only `is_final=true` result(s) are returned.
@@ -136,13 +150,15 @@ message StreamingRecognitionConfig {
 message RecognitionConfig {
   // The encoding of the audio data sent in the request.
   //
-  // All encodings support only 1 channel (mono) audio.
+  // All encodings support only 1 channel (mono) audio, unless the
+  // `audio_channel_count` and `enable_separate_recognition_per_channel` fields
+  // are set.
   //
   // For best results, the audio source should be captured and transmitted using
   // a lossless encoding (`FLAC` or `LINEAR16`). The accuracy of the speech
   // recognition can be reduced if lossy codecs are used to capture or transmit
   // audio, particularly if background noise is present. Lossy codecs include
-  // `MULAW`, `AMR`, `AMR_WB`, `OGG_OPUS`, and `SPEEX_WITH_HEADER_BYTE`.
+  // `MULAW`, `AMR`, `AMR_WB`, `OGG_OPUS`, `SPEEX_WITH_HEADER_BYTE`, and `MP3`.
   //
   // The `FLAC` and `WAV` audio file formats include a header that describes the
   // included audio content. You can request recognition for `WAV` files that
@@ -153,8 +169,7 @@ message RecognitionConfig {
   // an `AudioEncoding` when you send  send `FLAC` or `WAV` audio, the
   // encoding configuration must match the encoding described in the audio
   // header; otherwise the request returns an
-  // [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT] error
-  // code.
+  // [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT] error code.
   enum AudioEncoding {
     // Not specified.
     ENCODING_UNSPECIFIED = 0;
@@ -202,8 +217,7 @@ message RecognitionConfig {
 
   // Encoding of audio data sent in all `RecognitionAudio` messages.
   // This field is optional for `FLAC` and `WAV` audio files and required
-  // for all other audio formats. For details, see
-  // [AudioEncoding][google.cloud.speech.v1.RecognitionConfig.AudioEncoding].
+  // for all other audio formats. For details, see [AudioEncoding][google.cloud.speech.v1.RecognitionConfig.AudioEncoding].
   AudioEncoding encoding = 1;
 
   // Sample rate in Hertz of the audio data sent in all
@@ -211,12 +225,11 @@ message RecognitionConfig {
   // 16000 is optimal. For best results, set the sampling rate of the audio
   // source to 16000 Hz. If that's not possible, use the native sample rate of
   // the audio source (instead of re-sampling).
-  // This field is optional for `FLAC` and `WAV` audio files and required
-  // for all other audio formats. For details, see
-  // [AudioEncoding][google.cloud.speech.v1.RecognitionConfig.AudioEncoding].
+  // This field is optional for FLAC and WAV audio files, but is
+  // required for all other audio formats. For details, see [AudioEncoding][google.cloud.speech.v1.RecognitionConfig.AudioEncoding].
   int32 sample_rate_hertz = 2;
 
-  // *Optional* The number of channels in the input audio data.
+  // The number of channels in the input audio data.
   // ONLY set this for MULTI-CHANNEL recognition.
   // Valid values for LINEAR16 and FLAC are `1`-`8`.
   // Valid values for OGG_OPUS are '1'-'254'.
@@ -235,14 +248,15 @@ message RecognitionConfig {
   // `audio_channel_count` multiplied by the length of the audio.
   bool enable_separate_recognition_per_channel = 12;
 
-  // *Required* The language of the supplied audio as a
+  // Required. The language of the supplied audio as a
   // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag.
   // Example: "en-US".
-  // See [Language Support](/speech-to-text/docs/languages)
-  // for a list of the currently supported language codes.
-  string language_code = 3;
+  // See [Language
+  // Support](https://cloud.google.com/speech-to-text/docs/languages) for a list
+  // of the currently supported language codes.
+  string language_code = 3 [(google.api.field_behavior) = REQUIRED];
 
-  // *Optional* Maximum number of recognition hypotheses to be returned.
+  // Maximum number of recognition hypotheses to be returned.
   // Specifically, the maximum number of `SpeechRecognitionAlternative` messages
   // within each `SpeechRecognitionResult`.
   // The server may return fewer than `max_alternatives`.
@@ -250,24 +264,26 @@ message RecognitionConfig {
   // one. If omitted, will return a maximum of one.
   int32 max_alternatives = 4;
 
-  // *Optional* If set to `true`, the server will attempt to filter out
+  // If set to `true`, the server will attempt to filter out
   // profanities, replacing all but the initial character in each filtered word
   // with asterisks, e.g. "f***". If set to `false` or omitted, profanities
   // won't be filtered out.
   bool profanity_filter = 5;
 
-  // *Optional* array of [SpeechContext][google.cloud.speech.v1.SpeechContext].
+  // Array of [SpeechContext][google.cloud.speech.v1.SpeechContext].
   // A means to provide context to assist the speech recognition. For more
-  // information, see [Phrase Hints](/speech-to-text/docs/basics#phrase-hints).
+  // information, see
+  // [speech
+  // adaptation](https://cloud.google.com/speech-to-text/docs/context-strength).
   repeated SpeechContext speech_contexts = 6;
 
-  // *Optional* If `true`, the top result includes a list of words and
+  // If `true`, the top result includes a list of words and
   // the start and end time offsets (timestamps) for those words. If
   // `false`, no word-level time offset information is returned. The default is
   // `false`.
   bool enable_word_time_offsets = 8;
 
-  // *Optional* If 'true', adds punctuation to recognition result hypotheses.
+  // If 'true', adds punctuation to recognition result hypotheses.
   // This feature is only available in select languages. Setting this for
   // requests in other languages has no effect at all.
   // The default 'false' value does not add punctuation to result hypotheses.
@@ -276,10 +292,20 @@ message RecognitionConfig {
   // premium feature.
   bool enable_automatic_punctuation = 11;
 
-  // *Optional* Metadata regarding this request.
+  // Config to enable speaker diarization and set additional
+  // parameters to make diarization better suited for your application.
+  // Note: When this is enabled, we send all the words from the beginning of the
+  // audio for the top alternative in every consecutive STREAMING responses.
+  // This is done in order to improve our speaker tags as our models learn to
+  // identify the speakers in the conversation over time.
+  // For non-streaming requests, the diarization results will be provided only
+  // in the top alternative of the FINAL SpeechRecognitionResult.
+  SpeakerDiarizationConfig diarization_config = 19;
+
+  // Metadata regarding this request.
   RecognitionMetadata metadata = 9;
 
-  // *Optional* Which model to select for the given request. Select the model
+  // Which model to select for the given request. Select the model
   // best suited to your domain to get best results. If a model is not
   // explicitly specified, then we auto-select a model based on the parameters
   // in the RecognitionConfig.
@@ -313,7 +339,7 @@ message RecognitionConfig {
   // 
   string model = 13;
 
-  // *Optional* Set to true to use an enhanced model for speech recognition.
+  // Set to true to use an enhanced model for speech recognition.
   // If `use_enhanced` is set to true and the `model` field is not set, then
   // an appropriate enhanced model is chosen if an enhanced model exists for
   // the audio.
@@ -324,6 +350,28 @@ message RecognitionConfig {
   bool use_enhanced = 14;
 }
 
+// Config to enable speaker diarization.
+message SpeakerDiarizationConfig {
+  // If 'true', enables speaker detection for each recognized word in
+  // the top alternative of the recognition result using a speaker_tag provided
+  // in the WordInfo.
+  bool enable_speaker_diarization = 1;
+
+  // Minimum number of speakers in the conversation. This range gives you more
+  // flexibility by allowing the system to automatically determine the correct
+  // number of speakers. If not set, the default value is 2.
+  int32 min_speaker_count = 2;
+
+  // Maximum number of speakers in the conversation. This range gives you more
+  // flexibility by allowing the system to automatically determine the correct
+  // number of speakers. If not set, the default value is 6.
+  int32 max_speaker_count = 3;
+
+  // Unused.
+  int32 speaker_tag = 5
+      [(google.api.field_behavior) = OUTPUT_ONLY, deprecated = true];
+}
+
 // Description of audio data to be recognized.
 message RecognitionMetadata {
   // Use case categories that the audio recognition request can be described
@@ -364,15 +412,6 @@ message RecognitionMetadata {
     DICTATION = 8;
   }
 
-  // The use case most closely describing the audio content to be recognized.
-  InteractionType interaction_type = 1;
-
-  // The industry vertical to which this speech recognition request most
-  // closely applies. This is most indicative of the topics contained
-  // in the audio.  Use the 6-digit NAICS code to identify the industry
-  // vertical - see https://www.naics.com/search/.
-  uint32 industry_naics_code_of_audio = 3;
-
   // Enumerates the types of capture settings describing an audio file.
   enum MicrophoneDistance {
     // Audio type is not known.
@@ -390,9 +429,6 @@ message RecognitionMetadata {
     FARFIELD = 3;
   }
 
-  // The audio type that most closely describes the audio being recognized.
-  MicrophoneDistance microphone_distance = 4;
-
   // The original media the speech was recorded on.
   enum OriginalMediaType {
     // Unknown original media type.
@@ -405,9 +441,6 @@ message RecognitionMetadata {
     VIDEO = 2;
   }
 
-  // The original media the speech was recorded on.
-  OriginalMediaType original_media_type = 5;
-
   // The type of device the speech was recorded with.
   enum RecordingDeviceType {
     // The recording device is unknown.
@@ -432,6 +465,21 @@ message RecognitionMetadata {
     OTHER_INDOOR_DEVICE = 6;
   }
 
+  // The use case most closely describing the audio content to be recognized.
+  InteractionType interaction_type = 1;
+
+  // The industry vertical to which this speech recognition request most
+  // closely applies. This is most indicative of the topics contained
+  // in the audio.  Use the 6-digit NAICS code to identify the industry
+  // vertical - see https://www.naics.com/search/.
+  uint32 industry_naics_code_of_audio = 3;
+
+  // The audio type that most closely describes the audio being recognized.
+  MicrophoneDistance microphone_distance = 4;
+
+  // The original media the speech was recorded on.
+  OriginalMediaType original_media_type = 5;
+
   // The type of device the speech was recorded with.
   RecordingDeviceType recording_device_type = 6;
 
@@ -454,25 +502,31 @@ message RecognitionMetadata {
 // Provides "hints" to the speech recognizer to favor specific words and phrases
 // in the results.
 message SpeechContext {
-  // *Optional* A list of strings containing words and phrases "hints" so that
+  // A list of strings containing words and phrases "hints" so that
   // the speech recognition is more likely to recognize them. This can be used
   // to improve the accuracy for specific words and phrases, for example, if
   // specific commands are typically spoken by the user. This can also be used
   // to add additional words to the vocabulary of the recognizer. See
-  // [usage limits](/speech-to-text/quotas#content).
+  // [usage limits](https://cloud.google.com/speech-to-text/quotas#content).
+  //
+  // List items can also be set to classes for groups of words that represent
+  // common concepts that occur in natural language. For example, rather than
+  // providing phrase hints for every month of the year, using the $MONTH class
+  // improves the likelihood of correctly transcribing audio that includes
+  // months.
   repeated string phrases = 1;
 }
 
 // Contains audio data in the encoding specified in the `RecognitionConfig`.
 // Either `content` or `uri` must be supplied. Supplying both or neither
-// returns [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT].
-// See [content limits](/speech-to-text/quotas#content).
+// returns [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]. See
+// [content limits](https://cloud.google.com/speech-to-text/quotas#content).
 message RecognitionAudio {
   // The audio source, which is either inline content or a Google Cloud
   // Storage uri.
   oneof audio_source {
     // The audio data bytes encoded as specified in
-    // `RecognitionConfig`. Note: as with all bytes fields, protobuffers use a
+    // `RecognitionConfig`. Note: as with all bytes fields, proto buffers use a
     // pure binary representation, whereas JSON representations use base64.
     bytes content = 1;
 
@@ -481,9 +535,8 @@ message RecognitionAudio {
     // Currently, only Google Cloud Storage URIs are
     // supported, which must be specified in the following format:
     // `gs://bucket_name/object_name` (other URI formats return
-    // [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]).
-    // For more information, see [Request
-    // URIs](https://cloud.google.com/storage/docs/reference-uris).
+    // [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For more information, see
+    // [Request URIs](https://cloud.google.com/storage/docs/reference-uris).
     string uri = 2;
   }
 }
@@ -492,7 +545,7 @@ message RecognitionAudio {
 // contains the result as zero or more sequential `SpeechRecognitionResult`
 // messages.
 message RecognizeResponse {
-  // Output only. Sequential list of transcription results corresponding to
+  // Sequential list of transcription results corresponding to
   // sequential portions of audio.
   repeated SpeechRecognitionResult results = 2;
 }
@@ -503,7 +556,7 @@ message RecognizeResponse {
 // returned by the `GetOperation` call of the `google::longrunning::Operations`
 // service.
 message LongRunningRecognizeResponse {
-  // Output only. Sequential list of transcription results corresponding to
+  // Sequential list of transcription results corresponding to
   // sequential portions of audio.
   repeated SpeechRecognitionResult results = 2;
 }
@@ -588,44 +641,44 @@ message StreamingRecognizeResponse {
     END_OF_SINGLE_UTTERANCE = 1;
   }
 
-  // Output only. If set, returns a [google.rpc.Status][google.rpc.Status]
-  // message that specifies the error for the operation.
+  // If set, returns a [google.rpc.Status][google.rpc.Status] message that
+  // specifies the error for the operation.
   google.rpc.Status error = 1;
 
-  // Output only. This repeated list contains zero or more results that
+  // This repeated list contains zero or more results that
   // correspond to consecutive portions of the audio currently being processed.
   // It contains zero or one `is_final=true` result (the newly settled portion),
   // followed by zero or more `is_final=false` results (the interim results).
   repeated StreamingRecognitionResult results = 2;
 
-  // Output only. Indicates the type of speech event.
+  // Indicates the type of speech event.
   SpeechEventType speech_event_type = 4;
 }
 
 // A streaming speech recognition result corresponding to a portion of the audio
 // that is currently being processed.
 message StreamingRecognitionResult {
-  // Output only. May contain one or more recognition hypotheses (up to the
+  // May contain one or more recognition hypotheses (up to the
   // maximum specified in `max_alternatives`).
   // These alternatives are ordered in terms of accuracy, with the top (first)
   // alternative being the most probable, as ranked by the recognizer.
   repeated SpeechRecognitionAlternative alternatives = 1;
 
-  // Output only. If `false`, this `StreamingRecognitionResult` represents an
+  // If `false`, this `StreamingRecognitionResult` represents an
   // interim result that may change. If `true`, this is the final time the
   // speech service will return this particular `StreamingRecognitionResult`,
   // the recognizer will not return any further hypotheses for this portion of
   // the transcript and corresponding audio.
   bool is_final = 2;
 
-  // Output only. An estimate of the likelihood that the recognizer will not
+  // An estimate of the likelihood that the recognizer will not
   // change its guess about this interim result. Values range from 0.0
   // (completely unstable) to 1.0 (completely stable).
   // This field is only provided for interim results (`is_final=false`).
   // The default of 0.0 is a sentinel value indicating `stability` was not set.
   float stability = 3;
 
-  // Output only. Time offset of the end of this result relative to the
+  // Time offset of the end of this result relative to the
   // beginning of the audio.
   google.protobuf.Duration result_end_time = 4;
 
@@ -634,16 +687,16 @@ message StreamingRecognitionResult {
   // For audio_channel_count = N, its output values can range from '1' to 'N'.
   int32 channel_tag = 5;
 
-  // Output only. The
-  // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the
-  // language in this result. This language code was detected to have the most
-  // likelihood of being spoken in the audio.
-  string language_code = 6;
+  // The [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of
+  // the language in this result. This language code was detected to have the
+  // most likelihood of being spoken in the audio.
+  string language_code = 6
+    [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // A speech recognition result corresponding to a portion of the audio.
 message SpeechRecognitionResult {
-  // Output only. May contain one or more recognition hypotheses (up to the
+  // May contain one or more recognition hypotheses (up to the
   // maximum specified in `max_alternatives`).
   // These alternatives are ordered in terms of accuracy, with the top (first)
   // alternative being the most probable, as ranked by the recognizer.
@@ -657,10 +710,10 @@ message SpeechRecognitionResult {
 
 // Alternative hypotheses (a.k.a. n-best list).
 message SpeechRecognitionAlternative {
-  // Output only. Transcript text representing the words that the user spoke.
+  // Transcript text representing the words that the user spoke.
   string transcript = 1;
 
-  // Output only. The confidence estimate between 0.0 and 1.0. A higher number
+  // The confidence estimate between 0.0 and 1.0. A higher number
   // indicates an estimated greater likelihood that the recognized words are
   // correct. This field is set only for the top alternative of a non-streaming
   // result or, of a streaming result where `is_final=true`.
@@ -669,7 +722,7 @@ message SpeechRecognitionAlternative {
   // The default of 0.0 is a sentinel value indicating `confidence` was not set.
   float confidence = 2;
 
-  // Output only. A list of word-specific information for each recognized word.
+  // A list of word-specific information for each recognized word.
   // Note: When `enable_speaker_diarization` is true, you will see all the words
   // from the beginning of the audio.
   repeated WordInfo words = 3;
@@ -677,7 +730,7 @@ message SpeechRecognitionAlternative {
 
 // Word-specific information for recognized words.
 message WordInfo {
-  // Output only. Time offset relative to the beginning of the audio,
+  // Time offset relative to the beginning of the audio,
   // and corresponding to the start of the spoken word.
   // This field is only set if `enable_word_time_offsets=true` and only
   // in the top hypothesis.
@@ -685,7 +738,7 @@ message WordInfo {
   // vary.
   google.protobuf.Duration start_time = 1;
 
-  // Output only. Time offset relative to the beginning of the audio,
+  // Time offset relative to the beginning of the audio,
   // and corresponding to the end of the spoken word.
   // This field is only set if `enable_word_time_offsets=true` and only
   // in the top hypothesis.
@@ -693,6 +746,14 @@ message WordInfo {
   // vary.
   google.protobuf.Duration end_time = 2;
 
-  // Output only. The word corresponding to this set of information.
+  // The word corresponding to this set of information.
   string word = 3;
+
+  // A distinct integer value is assigned for every speaker within
+  // the audio. This field specifies which one of those speakers was detected to
+  // have spoken this word. Value ranges from '1' to diarization_speaker_count.
+  // speaker_tag is set if enable_speaker_diarization = 'true' and only in the
+  // top alternative.
+  int32 speaker_tag = 5
+    [(google.api.field_behavior) = OUTPUT_ONLY];
 }
diff --git a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_async.yaml b/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_async.yaml
index 97cd71095..f798bb46a 100644
--- a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_async.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_async.yaml
@@ -1,35 +1,36 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
 samples:
-- id: speech_transcribe_async
+- region_tag: speech_transcribe_async
   title: Transcribe Audio File using Long Running Operation (Local File) (LRO)
   description: Transcribe a long audio file using asynchronous speech recognition
   rpc: LongRunningRecognize
   service: google.cloud.speech.v1.Speech
-  parameters:
-    defaults:
-    - audio.content = "resources/brooklyn_bridge.raw"
-    - config.language_code = "en-US"
-    - config.sample_rate_hertz = 16000
-    - config.encoding = LINEAR16
-    attributes:
-    - parameter: audio.content
-      sample_argument_name: local_file_path
-      read_file: true
-      description: "Path to local audio file, e.g. /path/audio.wav"
-    - parameter: config.language_code
-      description: "The language of the supplied audio"
-    - parameter: config.sample_rate_hertz
-      description: Sample rate in Hertz of the audio data sent
-    - parameter: config.encoding
-      description: |
-        Encoding of audio data sent. This sample sets this explicitly.
-        This field is optional for FLAC and WAV audio formats.
-  on_success:
+  request:
+  - field: audio.content
+    value: "resources/brooklyn_bridge.raw"
+    input_parameter: local_file_path
+    comment: Path to local audio file, e.g. /path/audio.wav
+    value_is_file: true
+  - field: config.language_code
+    value: "en-US"
+    comment: The language of the supplied audio
+  - field: config.sample_rate_hertz
+    value: 16000
+    comment: Sample rate in Hertz of the audio data sent
+  - field: config.encoding
+    value: LINEAR16
+    comment: |
+      Encoding of audio data sent. This sample sets this explicitly.
+      This field is optional for FLAC and WAV audio formats.
+  response:
   - loop:
       variable: result
       collection: $resp.results
       body:
-      - comment: ["First alternative is the most probable result"]
-      - define: alternative=result.alternatives[0]
+      - comment:
+        - First alternative is the most probable result
+      - define: alternative = result.alternatives[0]
       - print:
         - "Transcript: %s"
         - alternative.transcript
diff --git a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_async_gcs.yaml b/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_async_gcs.yaml
index f4bce2bc7..cb39d7b3c 100644
--- a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_async_gcs.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_async_gcs.yaml
@@ -1,35 +1,35 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
 samples:
-- id: speech_transcribe_async_gcs
+- region_tag: speech_transcribe_async_gcs
   title: Transcript Audio File using Long Running Operation (Cloud Storage) (LRO)
-  description: |
-    Transcribe long audio file from Cloud Storage using asynchronous speech recognition
+  description: Transcribe long audio file from Cloud Storage using asynchronous speech recognition
   rpc: LongRunningRecognize
   service: google.cloud.speech.v1.Speech
-  parameters:
-    defaults:
-    - audio.uri = "gs://cloud-samples-data/speech/brooklyn_bridge.raw"
-    - config.sample_rate_hertz = 16000
-    - config.language_code = "en-US"
-    - config.encoding = LINEAR16
-    attributes:
-    - parameter: audio.uri
-      sample_argument_name: storage_uri
-      description: "URI for audio file in Cloud Storage, e.g. gs://[BUCKET]/[FILE]"
-    - parameter: config.language_code
-      description: "The language of the supplied audio"
-    - parameter: config.sample_rate_hertz
-      description: Sample rate in Hertz of the audio data sent
-    - parameter: config.encoding
-      description: |
-        Encoding of audio data sent. This sample sets this explicitly.
-        This field is optional for FLAC and WAV audio formats.
-  on_success:
+  request:
+  - field: audio.uri
+    value: "gs://cloud-samples-data/speech/brooklyn_bridge.raw"
+    input_parameter: storage_uri
+    comment: URI for audio file in Cloud Storage, e.g. gs://[BUCKET]/[FILE]
+  - field: config.sample_rate_hertz
+    value: 16000
+    comment: Sample rate in Hertz of the audio data sent
+  - field: config.language_code
+    value: "en-US"
+    comment: The language of the supplied audio
+  - field: config.encoding
+    value: LINEAR16
+    comment: |
+      Encoding of audio data sent. This sample sets this explicitly.
+      This field is optional for FLAC and WAV audio formats.
+  response:
   - loop:
       variable: result
       collection: $resp.results
       body:
-      - comment: ["First alternative is the most probable result"]
-      - define: alternative=result.alternatives[0]
+      - comment:
+        - First alternative is the most probable result
+      - define: alternative = result.alternatives[0]
       - print:
         - "Transcript: %s"
         - alternative.transcript
diff --git a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_async_word_time_offsets_gcs.yaml b/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_async_word_time_offsets_gcs.yaml
index e40d83d8b..33695b069 100644
--- a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_async_word_time_offsets_gcs.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_async_word_time_offsets_gcs.yaml
@@ -1,38 +1,48 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
 samples:
-- id: speech_transcribe_async_word_time_offsets_gcs
+- region_tag: speech_transcribe_async_word_time_offsets_gcs
   title: Getting word timestamps (Cloud Storage) (LRO)
-  description: |
-    Print start and end time of each word spoken in audio file from Cloud Storage
+  description: Print start and end time of each word spoken in audio file from Cloud Storage
   rpc: LongRunningRecognize
   service: google.cloud.speech.v1.Speech
-  parameters:
-    defaults:
-    - audio.uri = "gs://cloud-samples-data/speech/brooklyn_bridge.flac"
-    - config.enable_word_time_offsets = True
-    - config.language_code = "en-US"
-    attributes:
-    - parameter: audio.uri
-      sample_argument_name: storage_uri
-      description: "URI for audio file in Cloud Storage, e.g. gs://[BUCKET]/[FILE]"
-    - parameter: config.enable_word_time_offsets
-      description: |
-        When enabled, the first result returned by the API will include a list
-        of words and the start and end time offsets (timestamps) for those words.
-    - parameter: config.language_code
-      description: "The language of the supplied audio"
-  on_success:
-  - comment: ["The first result includes start and end time word offsets"]
-  - define: result=$resp.results[0]
-  - comment: ["First alternative is the most probable result"]
-  - define: alternative=result.alternatives[0]
+  request:
+  - field: audio.uri
+    value: "gs://cloud-samples-data/speech/brooklyn_bridge.flac"
+    input_parameter: storage_uri
+    comment: URI for audio file in Cloud Storage, e.g. gs://[BUCKET]/[FILE]
+  - field: config.enable_word_time_offsets
+    value: true
+    comment: |
+      When enabled, the first result returned by the API will include a list
+      of words and the start and end time offsets (timestamps) for those words.
+  - field: config.language_code
+    value: "en-US"
+    comment: The language of the supplied audio
+  response:
+  - comment:
+    - The first result includes start and end time word offsets
+  - define: result = $resp.results[0]
+  - comment:
+    - First alternative is the most probable result
+  - define: alternative = result.alternatives[0]
   - print:
     - "Transcript: %s"
     - alternative.transcript
-  - comment: ["Print the start and end time of each word"]
+  - comment:
+    - Print the start and end time of each word
   - loop:
       collection: alternative.words
       variable: word
       body:
-      - print: ["Word: %s", word.word]
-      - print: ["Start time: %s seconds %s nanos", word.start_time.seconds, word.start_time.nanos]
-      - print: ["End time: %s seconds %s nanos", word.end_time.seconds, word.end_time.nanos]
+      - print:
+        - "Word: %s"
+        - word.word
+      - print:
+        - "Start time: %s seconds %s nanos"
+        - word.start_time.seconds
+        - word.start_time.nanos
+      - print:
+        - "End time: %s seconds %s nanos"
+        - word.end_time.seconds
+        - word.end_time.nanos
diff --git a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_enhanced_model.yaml b/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_enhanced_model.yaml
index adfb7ccaa..fa051b1c8 100644
--- a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_enhanced_model.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_enhanced_model.yaml
@@ -1,38 +1,38 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
 samples:
-- id: speech_transcribe_enhanced_model
+- region_tag: speech_transcribe_enhanced_model
   title: Using Enhanced Models (Local File)
   description: Transcribe a short audio file using an enhanced model
   rpc: Recognize
   service: google.cloud.speech.v1.Speech
-  parameters:
-    defaults:
-    - audio.content = "resources/hello.wav"
-    - config.model = "phone_call"
-    - config.use_enhanced = True
-    - config.language_code = "en-US"
-    attributes:
-    - parameter: audio.content
-      sample_argument_name: local_file_path
-      read_file: true
-      description: "Path to local audio file, e.g. /path/audio.wav"
-    - parameter: config.model
-      description: |
-        The enhanced model to use, e.g. phone_call
-        Currently phone_call is the only model available as an enhanced model.
-    - parameter: config.use_enhanced
-      description: |
-        Use an enhanced model for speech recognition (when set to true).
-        Project must be eligible for requesting enhanced models.
-        Enhanced speech models require that you opt-in to data logging.
-    - parameter: config.language_code
-      description: "The language of the supplied audio"
-  on_success:
+  request:
+  - field: audio.content
+    value: "resources/hello.wav"
+    input_parameter: local_file_path
+    comment: Path to local audio file, e.g. /path/audio.wav
+    value_is_file: true
+  - field: config.model
+    value: "phone_call"
+    comment: |
+      The enhanced model to use, e.g. phone_call
+  - field: config.use_enhanced
+    value: true
+    comment: |
+      Use an enhanced model for speech recognition (when set to true).
+      Project must be eligible for requesting enhanced models.
+      Enhanced speech models require that you opt-in to data logging.
+  - field: config.language_code
+    value: "en-US"
+    comment: The language of the supplied audio
+  response:
   - loop:
       variable: result
       collection: $resp.results
       body:
-      - comment: ["First alternative is the most probable result"]
-      - define: alternative=result.alternatives[0]
+      - comment:
+        - First alternative is the most probable result
+      - define: alternative = result.alternatives[0]
       - print:
         - "Transcript: %s"
         - alternative.transcript
diff --git a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_model_selection.yaml b/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_model_selection.yaml
index 1ff649a6d..b206f8bfb 100644
--- a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_model_selection.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_model_selection.yaml
@@ -1,34 +1,35 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
 samples:
-- id: speech_transcribe_model_selection
+- region_tag: speech_transcribe_model_selection
   title: Selecting a Transcription Model (Local File)
   description: Transcribe a short audio file using a specified transcription model
   rpc: Recognize
   service: google.cloud.speech.v1.Speech
-  parameters:
-    defaults:
-    - audio.content = "resources/hello.wav"
-    - config.model = "phone_call"
-    - config.language_code = "en-US"
-    attributes:
-    - parameter: audio.content
-      sample_argument_name: local_file_path
-      read_file: true
-      description: "Path to local audio file, e.g. /path/audio.wav"
-    - parameter: config.model
-      sample_argument_name: model
-      description: |
-        The transcription model to use, e.g. video, phone_call, default
-        For a list of available transcription models, see:
-        https://cloud.google.com/speech-to-text/docs/transcription-model#transcription_models
-    - parameter: config.language_code
-      description: "The language of the supplied audio"
-  on_success:
+  request:
+  - field: audio.content
+    value: "resources/hello.wav"
+    input_parameter: local_file_path
+    comment: Path to local audio file, e.g. /path/audio.wav
+    value_is_file: true
+  - field: config.model
+    value: "phone_call"
+    input_parameter: model
+    comment: |
+      The transcription model to use, e.g. video, phone_call, default
+      For a list of available transcription models, see:
+      https://cloud.google.com/speech-to-text/docs/transcription-model#transcription_models
+  - field: config.language_code
+    value: "en-US"
+    comment: The language of the supplied audio
+  response:
   - loop:
       variable: result
       collection: $resp.results
       body:
-      - comment: ["First alternative is the most probable result"]
-      - define: alternative=result.alternatives[0]
+      - comment:
+        - First alternative is the most probable result
+      - define: alternative = result.alternatives[0]
       - print:
         - "Transcript: %s"
         - alternative.transcript
diff --git a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_model_selection_gcs.yaml b/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_model_selection_gcs.yaml
index a16c37444..a6e3bde67 100644
--- a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_model_selection_gcs.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_model_selection_gcs.yaml
@@ -1,34 +1,35 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
 samples:
-- id: speech_transcribe_model_selection_gcs
+- region_tag: speech_transcribe_model_selection_gcs
   title: Selecting a Transcription Model (Cloud Storage)
   description: |
     Transcribe a short audio file from Cloud Storage using a specified transcription model
   rpc: Recognize
   service: google.cloud.speech.v1.Speech
-  parameters:
-    defaults:
-    - audio.uri = "gs://cloud-samples-data/speech/hello.wav"
-    - config.model = "phone_call"
-    - config.language_code = "en-US"
-    attributes:
-    - parameter: audio.uri
-      sample_argument_name: storage_uri
-      description: "URI for audio file in Cloud Storage, e.g. gs://[BUCKET]/[FILE]"
-    - parameter: config.model
-      sample_argument_name: model
-      description: |
-        The transcription model to use, e.g. video, phone_call, default
-        For a list of available transcription models, see:
-        https://cloud.google.com/speech-to-text/docs/transcription-model#transcription_models
-    - parameter: config.language_code
-      description: "The language of the supplied audio"
-  on_success:
+  request:
+  - field: audio.uri
+    value: "gs://cloud-samples-data/speech/hello.wav"
+    input_parameter: storage_uri
+    comment: URI for audio file in Cloud Storage, e.g. gs://[BUCKET]/[FILE]
+  - field: config.model
+    value: "phone_call"
+    input_parameter: model
+    comment: |
+      The transcription model to use, e.g. video, phone_call, default
+      For a list of available transcription models, see:
+      https://cloud.google.com/speech-to-text/docs/transcription-model#transcription_models
+  - field: config.language_code
+    value: "en-US"
+    comment: The language of the supplied audio
+  response:
   - loop:
       variable: result
       collection: $resp.results
       body:
-      - comment: ["First alternative is the most probable result"]
-      - define: alternative=result.alternatives[0]
+      - comment:
+        - First alternative is the most probable result
+      - define: alternative = result.alternatives[0]
       - print:
         - "Transcript: %s"
         - alternative.transcript
diff --git a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_multichannel.yaml b/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_multichannel.yaml
index 68d56a786..6de5ce075 100644
--- a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_multichannel.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_multichannel.yaml
@@ -1,30 +1,30 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
 samples:
-- id: speech_transcribe_multichannel
+- region_tag: speech_transcribe_multichannel
   title: Multi-Channel Audio Transcription (Local File)
   description: Transcribe a short audio file with multiple channels
   rpc: Recognize
   service: google.cloud.speech.v1.Speech
-  parameters:
-    defaults:
-    - audio.content = "resources/multi.wav"
-    - config.audio_channel_count = 2
-    - config.enable_separate_recognition_per_channel = True
-    - config.language_code = "en-US"
-    attributes:
-    - parameter: audio.content
-      sample_argument_name: local_file_path
-      read_file: true
-      description: "Path to local audio file, e.g. /path/audio.wav"
-    - parameter: config.audio_channel_count
-      description: The number of channels in the input audio file (optional)
-    - parameter: config.enable_separate_recognition_per_channel
-      description: |
-        When set to true, each audio channel will be recognized separately.
-        The recognition result will contain a channel_tag field to state which
-        channel that result belongs to
-    - parameter: config.language_code
-      description: "The language of the supplied audio"
-  on_success:
+  request:
+  - field: audio.content
+    value: "resources/multi.wav"
+    input_parameter: local_file_path
+    comment: Path to local audio file, e.g. /path/audio.wav
+    value_is_file: true
+  - field: config.audio_channel_count
+    value: 2
+    comment: The number of channels in the input audio file (optional)
+  - field: config.enable_separate_recognition_per_channel
+    value: true
+    comment: |
+      When set to true, each audio channel will be recognized separately.
+      The recognition result will contain a channel_tag field to state which
+      channel that result belongs to
+  - field: config.language_code
+    value: "en-US"
+    comment: The language of the supplied audio
+  response:
   - loop:
       variable: result
       collection: $resp.results
@@ -32,9 +32,12 @@ samples:
       - comment:
         - "%s to recognize which audio channel this result is for"
         - channel_tag
-      - print: ["Channel tag: %s", result.channel_tag]
-      - comment: ["First alternative is the most probable result"]
-      - define: alternative=result.alternatives[0]
+      - print:
+        - "Channel tag: %s"
+        - result.channel_tag
+      - comment:
+        - First alternative is the most probable result
+      - define: alternative = result.alternatives[0]
       - print:
         - "Transcript: %s"
         - alternative.transcript
diff --git a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_multichannel_gcs.yaml b/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_multichannel_gcs.yaml
index f09b7cdd0..dc0d7c58b 100644
--- a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_multichannel_gcs.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_multichannel_gcs.yaml
@@ -1,30 +1,29 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
 samples:
-- id: speech_transcribe_multichannel_gcs
+- region_tag: speech_transcribe_multichannel_gcs
   title: Multi-Channel Audio Transcription (Cloud Storage)
-  description: |
-    Transcribe a short audio file from Cloud Storage with multiple channels
+  description: Transcribe a short audio file from Cloud Storage with multiple channels
   rpc: Recognize
   service: google.cloud.speech.v1.Speech
-  parameters:
-    defaults:
-    - audio.uri = "gs://cloud-samples-data/speech/multi.wav"
-    - config.audio_channel_count = 2
-    - config.enable_separate_recognition_per_channel = True
-    - config.language_code = "en-US"
-    attributes:
-    - parameter: audio.uri
-      sample_argument_name: storage_uri
-      description: "URI for audio file in Cloud Storage, e.g. gs://[BUCKET]/[FILE]"
-    - parameter: config.audio_channel_count
-      description: The number of channels in the input audio file (optional)
-    - parameter: config.enable_separate_recognition_per_channel
-      description: |
-        When set to true, each audio channel will be recognized separately.
-        The recognition result will contain a channel_tag field to state which
-        channel that result belongs to
-    - parameter: config.language_code
-      description: "The language of the supplied audio"
-  on_success:
+  request:
+  - field: audio.uri
+    value: "gs://cloud-samples-data/speech/multi.wav"
+    input_parameter: storage_uri
+    comment: URI for audio file in Cloud Storage, e.g. gs://[BUCKET]/[FILE]
+  - field: config.audio_channel_count
+    value: 2
+    comment: The number of channels in the input audio file (optional)
+  - field: config.enable_separate_recognition_per_channel
+    value: true
+    comment: |
+      When set to true, each audio channel will be recognized separately.
+      The recognition result will contain a channel_tag field to state which
+      channel that result belongs to
+  - field: config.language_code
+    value: "en-US"
+    comment: The language of the supplied audio
+  response:
   - loop:
       variable: result
       collection: $resp.results
@@ -32,9 +31,12 @@ samples:
       - comment:
         - "%s to recognize which audio channel this result is for"
         - channel_tag
-      - print: ["Channel tag: %s", result.channel_tag]
-      - comment: ["First alternative is the most probable result"]
-      - define: alternative=result.alternatives[0]
+      - print:
+        - "Channel tag: %s"
+        - result.channel_tag
+      - comment:
+        - First alternative is the most probable result
+      - define: alternative = result.alternatives[0]
       - print:
         - "Transcript: %s"
         - alternative.transcript
diff --git a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_sync.yaml b/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_sync.yaml
index 0529a2874..9b53ba4f4 100644
--- a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_sync.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_sync.yaml
@@ -1,35 +1,36 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
 samples:
-- id: speech_transcribe_sync
+- region_tag: speech_transcribe_sync
   title: Transcribe Audio File (Local File)
   description: Transcribe a short audio file using synchronous speech recognition
   rpc: Recognize
   service: google.cloud.speech.v1.Speech
-  parameters:
-    defaults:
-    - audio.content = "resources/brooklyn_bridge.raw"
-    - config.language_code = "en-US"
-    - config.sample_rate_hertz = 16000
-    - config.encoding = LINEAR16
-    attributes:
-    - parameter: audio.content
-      sample_argument_name: local_file_path
-      read_file: true
-      description: "Path to local audio file, e.g. /path/audio.wav"
-    - parameter: config.language_code
-      description: "The language of the supplied audio"
-    - parameter: config.sample_rate_hertz
-      description: Sample rate in Hertz of the audio data sent
-    - parameter: config.encoding
-      description: |
-        Encoding of audio data sent. This sample sets this explicitly.
-        This field is optional for FLAC and WAV audio formats.
-  on_success:
+  request:
+  - field: audio.content
+    value: "resources/brooklyn_bridge.raw"
+    input_parameter: local_file_path
+    comment: Path to local audio file, e.g. /path/audio.wav
+    value_is_file: true
+  - field: config.language_code
+    value: "en-US"
+    comment: The language of the supplied audio
+  - field: config.sample_rate_hertz
+    value: 16000
+    comment: Sample rate in Hertz of the audio data sent
+  - field: config.encoding
+    value: LINEAR16
+    comment: |
+      Encoding of audio data sent. This sample sets this explicitly.
+      This field is optional for FLAC and WAV audio formats.
+  response:
   - loop:
       variable: result
       collection: $resp.results
       body:
-      - comment: ["First alternative is the most probable result"]
-      - define: alternative=result.alternatives[0]
+      - comment:
+        - First alternative is the most probable result
+      - define: alternative = result.alternatives[0]
       - print:
         - "Transcript: %s"
         - alternative.transcript
diff --git a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_sync_gcs.yaml b/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_sync_gcs.yaml
index 6ebb1d2a5..fc571b154 100644
--- a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_sync_gcs.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_sync_gcs.yaml
@@ -1,35 +1,35 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
 samples:
-- id: speech_transcribe_sync_gcs
+- region_tag: speech_transcribe_sync_gcs
   title: Transcript Audio File (Cloud Storage)
-  description: |
-    Transcribe short audio file from Cloud Storage using synchronous speech recognition
+  description: Transcribe short audio file from Cloud Storage using synchronous speech recognition
   rpc: Recognize
   service: google.cloud.speech.v1.Speech
-  parameters:
-    defaults:
-    - audio.uri = "gs://cloud-samples-data/speech/brooklyn_bridge.raw"
-    - config.sample_rate_hertz = 16000
-    - config.language_code = "en-US"
-    - config.encoding = LINEAR16
-    attributes:
-    - parameter: audio.uri
-      sample_argument_name: storage_uri
-      description: "URI for audio file in Cloud Storage, e.g. gs://[BUCKET]/[FILE]"
-    - parameter: config.language_code
-      description: "The language of the supplied audio"
-    - parameter: config.sample_rate_hertz
-      description: Sample rate in Hertz of the audio data sent
-    - parameter: config.encoding
-      description: |
-        Encoding of audio data sent. This sample sets this explicitly.
-        This field is optional for FLAC and WAV audio formats.
-  on_success:
+  request:
+  - field: audio.uri
+    value: "gs://cloud-samples-data/speech/brooklyn_bridge.raw"
+    input_parameter: storage_uri
+    comment: URI for audio file in Cloud Storage, e.g. gs://[BUCKET]/[FILE]
+  - field: config.sample_rate_hertz
+    value: 16000
+    comment: Sample rate in Hertz of the audio data sent
+  - field: config.language_code
+    value: "en-US"
+    comment: The language of the supplied audio
+  - field: config.encoding
+    value: LINEAR16
+    comment: |
+      Encoding of audio data sent. This sample sets this explicitly.
+      This field is optional for FLAC and WAV audio formats.
+  response:
   - loop:
       variable: result
       collection: $resp.results
       body:
-      - comment: ["First alternative is the most probable result"]
-      - define: alternative=result.alternatives[0]
+      - comment:
+        - First alternative is the most probable result
+      - define: alternative = result.alternatives[0]
       - print:
         - "Transcript: %s"
         - alternative.transcript
diff --git a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_async.test.yaml b/third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_async.test.yaml
similarity index 95%
rename from third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_async.test.yaml
rename to third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_async.test.yaml
index 387e4b7e2..f26cfbabc 100644
--- a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_async.test.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_async.test.yaml
@@ -1,3 +1,5 @@
+type: test/samples
+schema_version: 1
 test:
   suites:
   - name: Transcribe Audio File using Long Running Operation (Local File) (LRO)
diff --git a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_async_gcs.test.yaml b/third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_async_gcs.test.yaml
similarity index 96%
rename from third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_async_gcs.test.yaml
rename to third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_async_gcs.test.yaml
index 146fb5c51..d3d83133e 100644
--- a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_async_gcs.test.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_async_gcs.test.yaml
@@ -1,3 +1,5 @@
+type: test/samples
+schema_version: 1
 test:
   suites:
   - name: Transcript Audio File using Long Running Operation (Cloud Storage) (LRO)
diff --git a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_async_word_time_offsets_gcs.test.yaml b/third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_async_word_time_offsets_gcs.test.yaml
similarity index 97%
rename from third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_async_word_time_offsets_gcs.test.yaml
rename to third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_async_word_time_offsets_gcs.test.yaml
index 5528d025c..11784726d 100644
--- a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_async_word_time_offsets_gcs.test.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_async_word_time_offsets_gcs.test.yaml
@@ -1,3 +1,5 @@
+type: test/samples
+schema_version: 1
 test:
   suites:
   - name: Getting word timestamps (Cloud Storage) (LRO)
diff --git a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_enhanced_model.test.yaml b/third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_enhanced_model.test.yaml
similarity index 96%
rename from third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_enhanced_model.test.yaml
rename to third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_enhanced_model.test.yaml
index 36ee3f348..6eab33b52 100644
--- a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_enhanced_model.test.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_enhanced_model.test.yaml
@@ -1,3 +1,5 @@
+type: test/samples
+schema_version: 1
 test:
   suites:
   - name: Using Enhanced Models (Local File)
diff --git a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_model_selection.test.yaml b/third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_model_selection.test.yaml
similarity index 97%
rename from third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_model_selection.test.yaml
rename to third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_model_selection.test.yaml
index d5f3ff577..b5ec2d902 100644
--- a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_model_selection.test.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_model_selection.test.yaml
@@ -1,3 +1,5 @@
+type: test/samples
+schema_version: 1
 test:
   suites:
   - name: Selecting a Transcription Model (Local File)
diff --git a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_model_selection_gcs.test.yaml b/third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_model_selection_gcs.test.yaml
similarity index 97%
rename from third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_model_selection_gcs.test.yaml
rename to third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_model_selection_gcs.test.yaml
index 323079da3..60c45c975 100644
--- a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_model_selection_gcs.test.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_model_selection_gcs.test.yaml
@@ -1,3 +1,5 @@
+type: test/samples
+schema_version: 1
 test:
   suites:
   - name: Selecting a Transcription Model (Cloud Storage)
diff --git a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_multichannel.test.yaml b/third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_multichannel.test.yaml
similarity index 96%
rename from third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_multichannel.test.yaml
rename to third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_multichannel.test.yaml
index 18e77c69b..9d5379dc9 100644
--- a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_multichannel.test.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_multichannel.test.yaml
@@ -1,3 +1,5 @@
+type: test/samples
+schema_version: 1
 test:
   suites:
   - name: Multi-Channel Audio Transcription (Local File)
diff --git a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_multichannel_gcs.test.yaml b/third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_multichannel_gcs.test.yaml
similarity index 96%
rename from third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_multichannel_gcs.test.yaml
rename to third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_multichannel_gcs.test.yaml
index 6186121b8..64c9340ce 100644
--- a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_multichannel_gcs.test.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_multichannel_gcs.test.yaml
@@ -1,3 +1,5 @@
+type: test/samples
+schema_version: 1
 test:
   suites:
   - name: Multi-Channel Audio Transcription (Cloud Storage)
diff --git a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_sync.test.yaml b/third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_sync.test.yaml
similarity index 95%
rename from third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_sync.test.yaml
rename to third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_sync.test.yaml
index aeb321194..47cc8c1a4 100644
--- a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_sync.test.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_sync.test.yaml
@@ -1,3 +1,5 @@
+type: test/samples
+schema_version: 1
 test:
   suites:
   - name: Transcribe Audio File (Local File)
diff --git a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_sync_gcs.test.yaml b/third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_sync_gcs.test.yaml
similarity index 95%
rename from third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_sync_gcs.test.yaml
rename to third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_sync_gcs.test.yaml
index 2e50f3602..3defdf289 100644
--- a/third_party/googleapis/google/cloud/speech/v1/samples/speech_transcribe_sync_gcs.test.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1/samples/test/speech_transcribe_sync_gcs.test.yaml
@@ -1,3 +1,5 @@
+type: test/samples
+schema_version: 1
 test:
   suites:
   - name: Transcript Audio File (Cloud Storage)
diff --git a/third_party/googleapis/google/cloud/speech/v1/speech_gapic.legacy.yaml b/third_party/googleapis/google/cloud/speech/v1/speech_gapic.legacy.yaml
new file mode 100644
index 000000000..1e2d456c0
--- /dev/null
+++ b/third_party/googleapis/google/cloud/speech/v1/speech_gapic.legacy.yaml
@@ -0,0 +1,92 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.speech.v1
+  python:
+    package_name: google.cloud.speech_v1.gapic
+  go:
+    package_name: cloud.google.com/go/speech/apiv1
+    release_level: GA
+  csharp:
+    package_name: Google.Cloud.Speech.V1
+    release_level: GA
+  ruby:
+    package_name: Google::Cloud::Speech::V1
+  php:
+    package_name: Google\Cloud\Speech\V1
+  nodejs:
+    package_name: speech.v1
+    domain_layer_location: google-cloud
+interfaces:
+- name: google.cloud.speech.v1.Speech
+  smoke_test:
+    method: Recognize
+    init_fields:
+    - config.language_code="en-US"
+    - config.sample_rate_hertz=44100
+    - config.encoding=FLAC
+    - audio.uri="gs://gapic-toolkit/hello.flac"
+  collections: []
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 1000000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 1000000
+    total_timeout_millis: 5000000
+  methods:
+  - name: Recognize
+    flattening:
+      groups:
+      - parameters:
+        - config
+        - audio
+    required_fields:
+    - config
+    - audio
+    sample_code_init_fields:
+    - config.encoding=FLAC
+    - config.sample_rate_hertz=44100
+    - config.language_code="en-US"
+    - audio.uri=gs://bucket_name/file_name.flac
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 1000000
+  - name: LongRunningRecognize
+    flattening:
+      groups:
+      - parameters:
+        - config
+        - audio
+    required_fields:
+    - config
+    - audio
+    sample_code_init_fields:
+    - config.encoding=FLAC
+    - config.sample_rate_hertz=44100
+    - config.language_code="en-US"
+    - audio.uri=gs://bucket_name/file_name.flac
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    long_running:
+      return_type: google.cloud.speech.v1.LongRunningRecognizeResponse
+      metadata_type: google.cloud.speech.v1.LongRunningRecognizeMetadata
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+  - name: StreamingRecognize
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 1000000
diff --git a/third_party/googleapis/google/cloud/speech/v1/speech_gapic.yaml b/third_party/googleapis/google/cloud/speech/v1/speech_gapic.yaml
index 1edeb9984..24fdf272e 100644
--- a/third_party/googleapis/google/cloud/speech/v1/speech_gapic.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1/speech_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.speech.v1
@@ -26,15 +26,7 @@ interfaces:
     - config.language_code="en-US"
     - config.sample_rate_hertz=44100
     - config.encoding=FLAC
-    - audio.uri="gs://gapic-toolkit/hello.flac"
-  collections: []
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
+    - audio.uri="gs://cloud-samples-data/speech/brooklyn_bridge.flac"
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 100
@@ -46,454 +38,17 @@ interfaces:
     total_timeout_millis: 5000000
   methods:
   - name: Recognize
-    flattening:
-      groups:
-      - parameters:
-        - config
-        - audio
-    required_fields:
-    - config
-    - audio
+    retry_codes_name: idempotent
     sample_code_init_fields:
     - config.encoding=FLAC
     - config.sample_rate_hertz=44100
     - config.language_code="en-US"
     - audio.uri=gs://bucket_name/file_name.flac
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 1000000
-    samples:
-      standalone:
-      - region_tag: speech_transcribe_sync_gcs
-        value_sets:
-        - speech_transcribe_sync_gcs
-      - region_tag: speech_transcribe_sync
-        value_sets:
-        - speech_transcribe_sync
-      - region_tag: speech_transcribe_multichannel
-        value_sets:
-        - speech_transcribe_multichannel
-      - region_tag: speech_transcribe_model_selection_gcs
-        value_sets:
-        - speech_transcribe_model_selection_gcs
-      - region_tag: speech_transcribe_async_word_time_offsets_gcs
-        value_sets:
-        - speech_transcribe_async_word_time_offsets_gcs
-      - region_tag: speech_transcribe_model_selection
-        value_sets:
-        - speech_transcribe_model_selection
-      - region_tag: speech_transcribe_multichannel_gcs
-        value_sets:
-        - speech_transcribe_multichannel_gcs
-      - region_tag: speech_transcribe_enhanced_model
-        value_sets:
-        - speech_transcribe_enhanced_model
-    sample_value_sets:
-    - id: speech_transcribe_model_selection_gcs
-      title: Selecting a Transcription Model (Cloud Storage)
-      description: 'Transcribe a short audio file from Cloud Storage using a specified
-        transcription model
-
-'
-      parameters:
-        defaults:
-        - audio.uri = "gs://cloud-samples-data/speech/hello.wav"
-        - config.model = "phone_call"
-        - config.language_code = "en-US"
-        attributes:
-        - parameter: audio.uri
-          sample_argument_name: storage_uri
-          description: URI for audio file in Cloud Storage, e.g. gs://[BUCKET]/[FILE]
-        - parameter: config.model
-          sample_argument_name: model
-          description: |
-            The transcription model to use, e.g. video, phone_call, default
-            For a list of available transcription models, see:
-            https://cloud.google.com/speech-to-text/docs/transcription-model#transcription_models
-        - parameter: config.language_code
-          description: The language of the supplied audio
-      on_success:
-      - loop:
-          variable: result
-          collection: "$resp.results"
-          body:
-          - comment:
-            - First alternative is the most probable result
-          - define: alternative=result.alternatives[0]
-          - print:
-            - 'Transcript: %s'
-            - alternative.transcript
-    - id: speech_transcribe_sync_gcs
-      title: Transcript Audio File (Cloud Storage)
-      description: 'Transcribe short audio file from Cloud Storage using synchronous
-        speech recognition
-
-'
-      parameters:
-        defaults:
-        - audio.uri = "gs://cloud-samples-data/speech/brooklyn_bridge.raw"
-        - config.sample_rate_hertz = 16000
-        - config.language_code = "en-US"
-        - config.encoding = LINEAR16
-        attributes:
-        - parameter: audio.uri
-          sample_argument_name: storage_uri
-          description: URI for audio file in Cloud Storage, e.g. gs://[BUCKET]/[FILE]
-        - parameter: config.language_code
-          description: The language of the supplied audio
-        - parameter: config.sample_rate_hertz
-          description: Sample rate in Hertz of the audio data sent
-        - parameter: config.encoding
-          description: |
-            Encoding of audio data sent. This sample sets this explicitly.
-            This field is optional for FLAC and WAV audio formats.
-      on_success:
-      - loop:
-          variable: result
-          collection: "$resp.results"
-          body:
-          - comment:
-            - First alternative is the most probable result
-          - define: alternative=result.alternatives[0]
-          - print:
-            - 'Transcript: %s'
-            - alternative.transcript
-    - id: speech_transcribe_sync
-      title: Transcribe Audio File (Local File)
-      description: Transcribe a short audio file using synchronous speech recognition
-      parameters:
-        defaults:
-        - audio.content = "resources/brooklyn_bridge.raw"
-        - config.language_code = "en-US"
-        - config.sample_rate_hertz = 16000
-        - config.encoding = LINEAR16
-        attributes:
-        - parameter: audio.content
-          sample_argument_name: local_file_path
-          read_file: true
-          description: Path to local audio file, e.g. /path/audio.wav
-        - parameter: config.language_code
-          description: The language of the supplied audio
-        - parameter: config.sample_rate_hertz
-          description: Sample rate in Hertz of the audio data sent
-        - parameter: config.encoding
-          description: |
-            Encoding of audio data sent. This sample sets this explicitly.
-            This field is optional for FLAC and WAV audio formats.
-      on_success:
-      - loop:
-          variable: result
-          collection: "$resp.results"
-          body:
-          - comment:
-            - First alternative is the most probable result
-          - define: alternative=result.alternatives[0]
-          - print:
-            - 'Transcript: %s'
-            - alternative.transcript
-    - id: speech_transcribe_model_selection
-      title: Selecting a Transcription Model (Local File)
-      description: Transcribe a short audio file using a specified transcription model
-      parameters:
-        defaults:
-        - audio.content = "resources/hello.wav"
-        - config.model = "phone_call"
-        - config.language_code = "en-US"
-        attributes:
-        - parameter: audio.content
-          sample_argument_name: local_file_path
-          read_file: true
-          description: Path to local audio file, e.g. /path/audio.wav
-        - parameter: config.model
-          sample_argument_name: model
-          description: |
-            The transcription model to use, e.g. video, phone_call, default
-            For a list of available transcription models, see:
-            https://cloud.google.com/speech-to-text/docs/transcription-model#transcription_models
-        - parameter: config.language_code
-          description: The language of the supplied audio
-      on_success:
-      - loop:
-          variable: result
-          collection: "$resp.results"
-          body:
-          - comment:
-            - First alternative is the most probable result
-          - define: alternative=result.alternatives[0]
-          - print:
-            - 'Transcript: %s'
-            - alternative.transcript
-    - id: speech_transcribe_multichannel_gcs
-      title: Multi-Channel Audio Transcription (Cloud Storage)
-      description: 'Transcribe a short audio file from Cloud Storage with multiple
-        channels
-
-'
-      parameters:
-        defaults:
-        - audio.uri = "gs://cloud-samples-data/speech/multi.wav"
-        - config.audio_channel_count = 2
-        - config.enable_separate_recognition_per_channel = True
-        - config.language_code = "en-US"
-        attributes:
-        - parameter: audio.uri
-          sample_argument_name: storage_uri
-          description: URI for audio file in Cloud Storage, e.g. gs://[BUCKET]/[FILE]
-        - parameter: config.audio_channel_count
-          description: The number of channels in the input audio file (optional)
-        - parameter: config.enable_separate_recognition_per_channel
-          description: |
-            When set to true, each audio channel will be recognized separately.
-            The recognition result will contain a channel_tag field to state which
-            channel that result belongs to
-        - parameter: config.language_code
-          description: The language of the supplied audio
-      on_success:
-      - loop:
-          variable: result
-          collection: "$resp.results"
-          body:
-          - comment:
-            - "%s to recognize which audio channel this result is for"
-            - channel_tag
-          - print:
-            - 'Channel tag: %s'
-            - result.channel_tag
-          - comment:
-            - First alternative is the most probable result
-          - define: alternative=result.alternatives[0]
-          - print:
-            - 'Transcript: %s'
-            - alternative.transcript
-    - id: speech_transcribe_multichannel
-      title: Multi-Channel Audio Transcription (Local File)
-      description: Transcribe a short audio file with multiple channels
-      parameters:
-        defaults:
-        - audio.content = "resources/multi.wav"
-        - config.audio_channel_count = 2
-        - config.enable_separate_recognition_per_channel = True
-        - config.language_code = "en-US"
-        attributes:
-        - parameter: audio.content
-          sample_argument_name: local_file_path
-          read_file: true
-          description: Path to local audio file, e.g. /path/audio.wav
-        - parameter: config.audio_channel_count
-          description: The number of channels in the input audio file (optional)
-        - parameter: config.enable_separate_recognition_per_channel
-          description: |
-            When set to true, each audio channel will be recognized separately.
-            The recognition result will contain a channel_tag field to state which
-            channel that result belongs to
-        - parameter: config.language_code
-          description: The language of the supplied audio
-      on_success:
-      - loop:
-          variable: result
-          collection: "$resp.results"
-          body:
-          - comment:
-            - "%s to recognize which audio channel this result is for"
-            - channel_tag
-          - print:
-            - 'Channel tag: %s'
-            - result.channel_tag
-          - comment:
-            - First alternative is the most probable result
-          - define: alternative=result.alternatives[0]
-          - print:
-            - 'Transcript: %s'
-            - alternative.transcript
-    - id: speech_transcribe_enhanced_model
-      title: Using Enhanced Models (Local File)
-      description: Transcribe a short audio file using an enhanced model
-      parameters:
-        defaults:
-        - audio.content = "resources/hello.wav"
-        - config.model = "phone_call"
-        - config.use_enhanced = True
-        - config.language_code = "en-US"
-        attributes:
-        - parameter: audio.content
-          sample_argument_name: local_file_path
-          read_file: true
-          description: Path to local audio file, e.g. /path/audio.wav
-        - parameter: config.model
-          description: |
-            The enhanced model to use, e.g. phone_call
-            Currently phone_call is the only model available as an enhanced model.
-        - parameter: config.use_enhanced
-          description: |
-            Use an enhanced model for speech recognition (when set to true).
-            Project must be eligible for requesting enhanced models.
-            Enhanced speech models require that you opt-in to data logging.
-        - parameter: config.language_code
-          description: The language of the supplied audio
-      on_success:
-      - loop:
-          variable: result
-          collection: "$resp.results"
-          body:
-          - comment:
-            - First alternative is the most probable result
-          - define: alternative=result.alternatives[0]
-          - print:
-            - 'Transcript: %s'
-            - alternative.transcript
   - name: LongRunningRecognize
-    flattening:
-      groups:
-      - parameters:
-        - config
-        - audio
-    required_fields:
-    - config
-    - audio
     sample_code_init_fields:
     - config.encoding=FLAC
     - config.sample_rate_hertz=44100
     - config.language_code="en-US"
     - audio.uri=gs://bucket_name/file_name.flac
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-    long_running:
-      return_type: google.cloud.speech.v1.LongRunningRecognizeResponse
-      metadata_type: google.cloud.speech.v1.LongRunningRecognizeMetadata
-      initial_poll_delay_millis: 20000
-      poll_delay_multiplier: 1.5
-      max_poll_delay_millis: 45000
-      total_poll_timeout_millis: 86400000
-    samples:
-      standalone:
-      - region_tag: speech_transcribe_async_gcs
-        value_sets:
-        - speech_transcribe_async_gcs
-      - region_tag: speech_transcribe_async
-        value_sets:
-        - speech_transcribe_async
-      - region_tag: speech_transcribe_async_word_time_offsets_gcs
-        value_sets:
-        - speech_transcribe_async_word_time_offsets_gcs
-    sample_value_sets:
-    - id: speech_transcribe_async_gcs
-      title: Transcript Audio File using Long Running Operation (Cloud Storage) (LRO)
-      description: 'Transcribe long audio file from Cloud Storage using asynchronous
-        speech recognition
-
-'
-      parameters:
-        defaults:
-        - audio.uri = "gs://cloud-samples-data/speech/brooklyn_bridge.raw"
-        - config.sample_rate_hertz = 16000
-        - config.language_code = "en-US"
-        - config.encoding = LINEAR16
-        attributes:
-        - parameter: audio.uri
-          sample_argument_name: storage_uri
-          description: URI for audio file in Cloud Storage, e.g. gs://[BUCKET]/[FILE]
-        - parameter: config.language_code
-          description: The language of the supplied audio
-        - parameter: config.sample_rate_hertz
-          description: Sample rate in Hertz of the audio data sent
-        - parameter: config.encoding
-          description: |
-            Encoding of audio data sent. This sample sets this explicitly.
-            This field is optional for FLAC and WAV audio formats.
-      on_success:
-      - loop:
-          variable: result
-          collection: "$resp.results"
-          body:
-          - comment:
-            - First alternative is the most probable result
-          - define: alternative=result.alternatives[0]
-          - print:
-            - 'Transcript: %s'
-            - alternative.transcript
-    - id: speech_transcribe_async
-      title: Transcribe Audio File using Long Running Operation (Local File) (LRO)
-      description: Transcribe a long audio file using asynchronous speech recognition
-      parameters:
-        defaults:
-        - audio.content = "resources/brooklyn_bridge.raw"
-        - config.language_code = "en-US"
-        - config.sample_rate_hertz = 16000
-        - config.encoding = LINEAR16
-        attributes:
-        - parameter: audio.content
-          sample_argument_name: local_file_path
-          read_file: true
-          description: Path to local audio file, e.g. /path/audio.wav
-        - parameter: config.language_code
-          description: The language of the supplied audio
-        - parameter: config.sample_rate_hertz
-          description: Sample rate in Hertz of the audio data sent
-        - parameter: config.encoding
-          description: |
-            Encoding of audio data sent. This sample sets this explicitly.
-            This field is optional for FLAC and WAV audio formats.
-      on_success:
-      - loop:
-          variable: result
-          collection: "$resp.results"
-          body:
-          - comment:
-            - First alternative is the most probable result
-          - define: alternative=result.alternatives[0]
-          - print:
-            - 'Transcript: %s'
-            - alternative.transcript
-    - id: speech_transcribe_async_word_time_offsets_gcs
-      title: Getting word timestamps (Cloud Storage) (LRO)
-      description: 'Print start and end time of each word spoken in audio file from
-        Cloud Storage
-
-'
-      parameters:
-        defaults:
-        - audio.uri = "gs://cloud-samples-data/speech/brooklyn_bridge.flac"
-        - config.enable_word_time_offsets = True
-        - config.language_code = "en-US"
-        attributes:
-        - parameter: audio.uri
-          sample_argument_name: storage_uri
-          description: URI for audio file in Cloud Storage, e.g. gs://[BUCKET]/[FILE]
-        - parameter: config.enable_word_time_offsets
-          description: |
-            When enabled, the first result returned by the API will include a list
-            of words and the start and end time offsets (timestamps) for those words.
-        - parameter: config.language_code
-          description: The language of the supplied audio
-      on_success:
-      - comment:
-        - The first result includes start and end time word offsets
-      - define: result=$resp.results[0]
-      - comment:
-        - First alternative is the most probable result
-      - define: alternative=result.alternatives[0]
-      - print:
-        - 'Transcript: %s'
-        - alternative.transcript
-      - comment:
-        - Print the start and end time of each word
-      - loop:
-          collection: alternative.words
-          variable: word
-          body:
-          - print:
-            - 'Word: %s'
-            - word.word
-          - print:
-            - 'Start time: %s seconds %s nanos'
-            - word.start_time.seconds
-            - word.start_time.nanos
-          - print:
-            - 'End time: %s seconds %s nanos'
-            - word.end_time.seconds
-            - word.end_time.nanos
   - name: StreamingRecognize
     retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 1000000
diff --git a/third_party/googleapis/google/cloud/speech/v1/speech_grpc_service_config.json b/third_party/googleapis/google/cloud/speech/v1/speech_grpc_service_config.json
new file mode 100755
index 000000000..007414d80
--- /dev/null
+++ b/third_party/googleapis/google/cloud/speech/v1/speech_grpc_service_config.json
@@ -0,0 +1,35 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.speech.v1.Speech",
+          "method": "Recognize"
+        },
+        {
+          "service": "google.cloud.speech.v1.Speech",
+          "method": "StreamingRecognize"
+        }
+      ],
+      "timeout": "5000s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.speech.v1.Speech",
+          "method": "LongRunningRecognize"
+        }
+      ],
+      "timeout": "5000s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/speech/speech_v1.yaml b/third_party/googleapis/google/cloud/speech/v1/speech_v1.yaml
similarity index 53%
rename from third_party/googleapis/google/cloud/speech/speech_v1.yaml
rename to third_party/googleapis/google/cloud/speech/v1/speech_v1.yaml
index 4cb4b7b2c..db88fe7b6 100644
--- a/third_party/googleapis/google/cloud/speech/speech_v1.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1/speech_v1.yaml
@@ -1,7 +1,7 @@
 type: google.api.Service
 config_version: 3
 name: speech.googleapis.com
-title: Cloud Speech API
+title: Cloud Speech-to-Text API
 
 apis:
 - name: google.cloud.speech.v1.Speech
@@ -19,47 +19,29 @@ documentation:
 
 backend:
   rules:
-  - selector: google.longrunning.Operations.ListOperations
-    deadline: 200.0
-  - selector: google.longrunning.Operations.GetOperation
-    deadline: 200.0
-  - selector: google.longrunning.Operations.WaitOperation
-    deadline: 200.0
-  - selector: google.cloud.speech.v1.Speech.Recognize
-    deadline: 200.0
-  - selector: google.cloud.speech.v1.Speech.LongRunningRecognize
-    deadline: 200.0
-  - selector: google.cloud.speech.v1.Speech.StreamingRecognize
-    deadline: 200.0
+  - selector: 'google.cloud.speech.v1.Speech.*'
+    deadline: 355.0
+  - selector: 'google.longrunning.Operations.*'
+    deadline: 355.0
 
 http:
   rules:
-  - selector: google.longrunning.Operations.ListOperations
-    get: /v1/operations
-    additional_bindings:
-    - get: /v1beta1/operations
-
-    - get: /v1p1beta1/operations
-
-    - get: '/v1p1beta1/{name=projects/*/locations/*}/operations'
-
-    - get: '/v1/{name=projects/*/locations/*}/operations'
-
   - selector: google.longrunning.Operations.GetOperation
     get: '/v1/operations/{name=**}'
     additional_bindings:
-    - get: '/v1beta1/operations/{name=**}'
-
-    - get: '/v1p1beta1/operations/{name=**}'
-
     - get: '/v1/{name=projects/*/locations/*/operations/*}'
-
-    - get: '/v1p1beta1/{name=projects/*/locations/*/operations/*}'
-
+  - selector: google.longrunning.Operations.ListOperations
+    get: /v1/operations
+    additional_bindings:
+    - get: '/v1/{name=projects/*/locations/*}/operations'
 
 authentication:
   rules:
-  - selector: '*'
+  - selector: 'google.cloud.speech.v1.Speech.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.longrunning.Operations.*'
     oauth:
       canonical_scopes: |-
         https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/speech/v1p1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/speech/v1p1beta1/BUILD.bazel
index e2001e02f..14fd48bb4 100644
--- a/third_party/googleapis/google/cloud/speech/v1p1beta1/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/speech/v1p1beta1/BUILD.bazel
@@ -1,30 +1,39 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
     name = "speech_proto",
     srcs = [
         "cloud_speech.proto",
+        "resource.proto",
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
         "//google/longrunning:operations_proto",
         "//google/rpc:status_proto",
         "@com_google_protobuf//:any_proto",
         "@com_google_protobuf//:duration_proto",
-        "@com_google_protobuf//:empty_proto",
         "@com_google_protobuf//:timestamp_proto",
     ],
 )
 
 proto_library_with_info(
     name = "speech_proto_with_info",
-    deps = [":speech_proto"],
+    deps = [
+        ":speech_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -32,18 +41,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
     name = "speech_java_proto",
     deps = [":speech_proto"],
@@ -52,51 +56,40 @@ java_proto_library(
 java_grpc_library(
     name = "speech_java_grpc",
     srcs = [":speech_proto"],
-    deps = [":speech_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "speech_resource_name_java_proto",
-    gapic_yaml = "speech_gapic.yaml",
-    deps = [":speech_proto"],
+    deps = [":speech_java_proto"],
 )
 
 java_gapic_library(
     name = "speech_java_gapic",
     src = ":speech_proto_with_info",
     gapic_yaml = "speech_gapic.yaml",
-    service_yaml = "//google/cloud/speech:speech_v1p1beta1.yaml",
-    test_deps = [":speech_java_grpc"],
+    package = "google.cloud.speech.v1p1beta1",
+    service_yaml = "speech_v1p1beta1.yaml",
+    test_deps = [
+        ":speech_java_grpc",
+    ],
     deps = [
         ":speech_java_proto",
-        ":speech_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":speech_java_gapic_test",
+java_gapic_test(
+    name = "speech_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.speech.v1p1beta1.SpeechClientTest",
     ],
-) for test_name in [
-    "com.google.cloud.speech.v1p1beta1.SpeechClientTest",
-]]
+    runtime_deps = [":speech_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-speech-v1p1beta1-java",
-    client_deps = [":speech_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":speech_java_gapic_test"],
-    grpc_deps = [":speech_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":speech_java_gapic",
+        ":speech_java_grpc",
         ":speech_java_proto",
         ":speech_proto",
-        ":speech_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -104,10 +97,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -124,15 +117,18 @@ go_proto_library(
 
 go_gapic_library(
     name = "speech_go_gapic",
-    src = ":speech_proto_with_info",
-    gapic_yaml = "speech_gapic.yaml",
-    importpath = "cloud.google.com/go/speech/apiv1p1beta1",
-    service_yaml = "//google/cloud/speech:speech_v1p1beta1.yaml",
+    srcs = [":speech_proto_with_info"],
+    grpc_service_config = "speech_grpc_service_config.json",
+    importpath = "cloud.google.com/go/speech/apiv1p1beta1;speech",
+    service_yaml = "speech_v1p1beta1.yaml",
     deps = [
         ":speech_go_proto",
         "//google/longrunning:longrunning_go_gapic",
         "//google/longrunning:longrunning_go_proto",
         "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
+        "@io_bazel_rules_go//proto/wkt:any_go_proto",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
     ],
 )
 
@@ -143,13 +139,237 @@ go_test(
     importpath = "cloud.google.com/go/speech/apiv1p1beta1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-speech-v1p1beta1-go",
     deps = [
         ":speech_go_gapic",
-        ":speech_go_gapic_srcjar-smoke-test.srcjar",
         ":speech_go_gapic_srcjar-test.srcjar",
         ":speech_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "speech_moved_proto",
+    srcs = [":speech_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/longrunning:operations_proto",
+        "//google/rpc:status_proto",
+        "@com_google_protobuf//:any_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "speech_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":speech_moved_proto"],
+)
+
+py_grpc_library(
+    name = "speech_py_grpc",
+    srcs = [":speech_moved_proto"],
+    deps = [":speech_py_proto"],
+)
+
+py_gapic_library(
+    name = "speech_py_gapic",
+    src = ":speech_proto_with_info",
+    gapic_yaml = "speech_gapic.yaml",
+    package = "google.cloud.speech.v1p1beta1",
+    service_yaml = "speech_v1p1beta1.yaml",
+    deps = [
+        ":speech_py_grpc",
+        ":speech_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "speech-v1p1beta1-py",
+    deps = [
+        ":speech_py_gapic",
+        ":speech_py_grpc",
+        ":speech_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "speech_php_proto",
+    deps = [":speech_proto"],
+)
+
+php_grpc_library(
+    name = "speech_php_grpc",
+    srcs = [":speech_proto"],
+    deps = [":speech_php_proto"],
+)
+
+php_gapic_library(
+    name = "speech_php_gapic",
+    src = ":speech_proto_with_info",
+    gapic_yaml = "speech_gapic.yaml",
+    package = "google.cloud.speech.v1p1beta1",
+    service_yaml = "speech_v1p1beta1.yaml",
+    deps = [
+        ":speech_php_grpc",
+        ":speech_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-speech-v1p1beta1-php",
+    deps = [
+        ":speech_php_gapic",
+        ":speech_php_grpc",
+        ":speech_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "speech_nodejs_gapic",
+    src = ":speech_proto_with_info",
+    gapic_yaml = "speech_gapic.yaml",
+    package = "google.cloud.speech.v1p1beta1",
+    service_yaml = "speech_v1p1beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "speech-v1p1beta1-nodejs",
+    deps = [
+        ":speech_nodejs_gapic",
+        ":speech_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "speech_ruby_proto",
+    deps = [":speech_proto"],
+)
+
+ruby_grpc_library(
+    name = "speech_ruby_grpc",
+    srcs = [":speech_proto"],
+    deps = [":speech_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "speech_ruby_gapic",
+    src = ":speech_proto_with_info",
+    gapic_yaml = "speech_gapic.yaml",
+    package = "google.cloud.speech.v1p1beta1",
+    service_yaml = "speech_v1p1beta1.yaml",
+    deps = [
+        ":speech_ruby_grpc",
+        ":speech_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-speech-v1p1beta1-ruby",
+    deps = [
+        ":speech_ruby_gapic",
+        ":speech_ruby_grpc",
+        ":speech_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "speech_csharp_proto",
+    deps = [":speech_proto"],
+)
+
+csharp_grpc_library(
+    name = "speech_csharp_grpc",
+    srcs = [":speech_proto"],
+    deps = [":speech_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "speech_csharp_gapic",
+    src = ":speech_proto_with_info",
+    gapic_yaml = "speech_gapic.yaml",
+    package = "google.cloud.speech.v1p1beta1",
+    service_yaml = "speech_v1p1beta1.yaml",
+    deps = [
+        ":speech_csharp_grpc",
+        ":speech_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-speech-v1p1beta1-csharp",
+    deps = [
+        ":speech_csharp_gapic",
+        ":speech_csharp_grpc",
+        ":speech_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/speech/v1p1beta1/cloud_speech.proto b/third_party/googleapis/google/cloud/speech/v1p1beta1/cloud_speech.proto
index dd557c5fd..7bb12866b 100644
--- a/third_party/googleapis/google/cloud/speech/v1p1beta1/cloud_speech.proto
+++ b/third_party/googleapis/google/cloud/speech/v1p1beta1/cloud_speech.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,17 +11,19 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.speech.v1p1beta1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/speech/v1p1beta1/resource.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/any.proto";
 import "google/protobuf/duration.proto";
-import "google/protobuf/empty.proto";
 import "google/protobuf/timestamp.proto";
 import "google/rpc/status.proto";
 
@@ -30,9 +32,14 @@ option go_package = "google.golang.org/genproto/googleapis/cloud/speech/v1p1beta
 option java_multiple_files = true;
 option java_outer_classname = "SpeechProto";
 option java_package = "com.google.cloud.speech.v1p1beta1";
+option objc_class_prefix = "GCS";
 
 // Service that implements Google Cloud Speech API.
 service Speech {
+  option (google.api.default_host) = "speech.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform";
+
   // Performs synchronous speech recognition: receive results after all audio
   // has been sent and processed.
   rpc Recognize(RecognizeRequest) returns (RecognizeResponse) {
@@ -40,18 +47,26 @@ service Speech {
       post: "/v1p1beta1/speech:recognize"
       body: "*"
     };
+    option (google.api.method_signature) = "config,audio";
   }
 
   // Performs asynchronous speech recognition: receive results via the
   // google.longrunning.Operations interface. Returns either an
   // `Operation.error` or an `Operation.response` which contains
   // a `LongRunningRecognizeResponse` message.
+  // For more information on asynchronous speech recognition, see the
+  // [how-to](https://cloud.google.com/speech-to-text/docs/async-recognize).
   rpc LongRunningRecognize(LongRunningRecognizeRequest)
       returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v1p1beta1/speech:longrunningrecognize"
       body: "*"
     };
+    option (google.api.method_signature) = "config,audio";
+    option (google.longrunning.operation_info) = {
+      response_type: "LongRunningRecognizeResponse"
+      metadata_type: "LongRunningRecognizeMetadata"
+    };
   }
 
   // Performs bidirectional streaming speech recognition: receive results while
@@ -62,30 +77,30 @@ service Speech {
 
 // The top-level message sent by the client for the `Recognize` method.
 message RecognizeRequest {
-  // *Required* Provides information to the recognizer that specifies how to
+  // Required. Provides information to the recognizer that specifies how to
   // process the request.
-  RecognitionConfig config = 1;
+  RecognitionConfig config = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // *Required* The audio data to be recognized.
-  RecognitionAudio audio = 2;
+  // Required. The audio data to be recognized.
+  RecognitionAudio audio = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The top-level message sent by the client for the `LongRunningRecognize`
 // method.
 message LongRunningRecognizeRequest {
-  // *Required* Provides information to the recognizer that specifies how to
+  // Required. Provides information to the recognizer that specifies how to
   // process the request.
-  RecognitionConfig config = 1;
+  RecognitionConfig config = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // *Required* The audio data to be recognized.
-  RecognitionAudio audio = 2;
+  // Required. The audio data to be recognized.
+  RecognitionAudio audio = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The top-level message sent by the client for the `StreamingRecognize` method.
 // Multiple `StreamingRecognizeRequest` messages are sent. The first message
-// must contain a `streaming_config` message and must not contain `audio` data.
-// All subsequent messages must contain `audio` data and must not contain a
-// `streaming_config` message.
+// must contain a `streaming_config` message and must not contain
+// `audio_content`. All subsequent messages must contain `audio_content` and
+// must not contain a `streaming_config` message.
 message StreamingRecognizeRequest {
   // The streaming request, which is either a streaming config or audio content.
   oneof streaming_request {
@@ -99,9 +114,9 @@ message StreamingRecognizeRequest {
     // `StreamingRecognizeRequest` message must not contain `audio_content` data
     // and all subsequent `StreamingRecognizeRequest` messages must contain
     // `audio_content` data. The audio bytes must be encoded as specified in
-    // `RecognitionConfig`. Note: as with all bytes fields, protobuffers use a
+    // `RecognitionConfig`. Note: as with all bytes fields, proto buffers use a
     // pure binary representation (not base64). See
-    // [content limits](/speech-to-text/quotas#content).
+    // [content limits](https://cloud.google.com/speech-to-text/quotas#content).
     bytes audio_content = 2;
   }
 }
@@ -109,11 +124,11 @@ message StreamingRecognizeRequest {
 // Provides information to the recognizer that specifies how to process the
 // request.
 message StreamingRecognitionConfig {
-  // *Required* Provides information to the recognizer that specifies how to
+  // Required. Provides information to the recognizer that specifies how to
   // process the request.
-  RecognitionConfig config = 1;
+  RecognitionConfig config = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // *Optional* If `false` or omitted, the recognizer will perform continuous
+  // If `false` or omitted, the recognizer will perform continuous
   // recognition (continuing to wait for and process audio even if the user
   // pauses speaking) until the client closes the input stream (gRPC API) or
   // until the maximum time limit has been reached. May return multiple
@@ -126,7 +141,7 @@ message StreamingRecognitionConfig {
   // `true`.
   bool single_utterance = 2;
 
-  // *Optional* If `true`, interim results (tentative hypotheses) may be
+  // If `true`, interim results (tentative hypotheses) may be
   // returned as they become available (these interim results are indicated with
   // the `is_final=false` flag).
   // If `false` or omitted, only `is_final=true` result(s) are returned.
@@ -138,13 +153,15 @@ message StreamingRecognitionConfig {
 message RecognitionConfig {
   // The encoding of the audio data sent in the request.
   //
-  // All encodings support only 1 channel (mono) audio.
+  // All encodings support only 1 channel (mono) audio, unless the
+  // `audio_channel_count` and `enable_separate_recognition_per_channel` fields
+  // are set.
   //
   // For best results, the audio source should be captured and transmitted using
   // a lossless encoding (`FLAC` or `LINEAR16`). The accuracy of the speech
   // recognition can be reduced if lossy codecs are used to capture or transmit
   // audio, particularly if background noise is present. Lossy codecs include
-  // `MULAW`, `AMR`, `AMR_WB`, `OGG_OPUS`, and `SPEEX_WITH_HEADER_BYTE`.
+  // `MULAW`, `AMR`, `AMR_WB`, `OGG_OPUS`, `SPEEX_WITH_HEADER_BYTE`, and `MP3`.
   //
   // The `FLAC` and `WAV` audio file formats include a header that describes the
   // included audio content. You can request recognition for `WAV` files that
@@ -202,8 +219,8 @@ message RecognitionConfig {
     SPEEX_WITH_HEADER_BYTE = 7;
 
     // MP3 audio. Support all standard MP3 bitrates (which range from 32-320
-    // kbps). When using this encoding, `sample_rate_hertz` can be optionally
-    // unset if not known.
+    // kbps). When using this encoding, `sample_rate_hertz` has to match the
+    // sample rate of the file being used.
     MP3 = 8;
   }
 
@@ -218,12 +235,12 @@ message RecognitionConfig {
   // 16000 is optimal. For best results, set the sampling rate of the audio
   // source to 16000 Hz. If that's not possible, use the native sample rate of
   // the audio source (instead of re-sampling).
-  // This field is optional for `FLAC` and `WAV` audio files and required
-  // for all other audio formats. For details, see
+  // This field is optional for FLAC and WAV audio files, but is
+  // required for all other audio formats. For details, see
   // [AudioEncoding][google.cloud.speech.v1p1beta1.RecognitionConfig.AudioEncoding].
   int32 sample_rate_hertz = 2;
 
-  // *Optional* The number of channels in the input audio data.
+  // The number of channels in the input audio data.
   // ONLY set this for MULTI-CHANNEL recognition.
   // Valid values for LINEAR16 and FLAC are `1`-`8`.
   // Valid values for OGG_OPUS are '1'-'254'.
@@ -234,7 +251,7 @@ message RecognitionConfig {
   // `enable_separate_recognition_per_channel` to 'true'.
   int32 audio_channel_count = 7;
 
-  // This needs to be set to ‘true’ explicitly and `audio_channel_count` > 1
+  // This needs to be set to `true` explicitly and `audio_channel_count` > 1
   // to get each channel recognized separately. The recognition result will
   // contain a `channel_tag` field to state which channel that result belongs
   // to. If this is not true, we will only recognize the first channel. The
@@ -242,28 +259,29 @@ message RecognitionConfig {
   // `audio_channel_count` multiplied by the length of the audio.
   bool enable_separate_recognition_per_channel = 12;
 
-  // *Required* The language of the supplied audio as a
+  // Required. The language of the supplied audio as a
   // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag.
   // Example: "en-US".
-  // See [Language Support](/speech-to-text/docs/languages)
-  // for a list of the currently supported language codes.
-  string language_code = 3;
+  // See [Language
+  // Support](https://cloud.google.com/speech-to-text/docs/languages) for a list
+  // of the currently supported language codes.
+  string language_code = 3 [(google.api.field_behavior) = REQUIRED];
 
-  // *Optional* A list of up to 3 additional
+  // A list of up to 3 additional
   // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tags,
   // listing possible alternative languages of the supplied audio.
-  // See [Language Support](/speech-to-text/docs/languages)
-  // for a list of the currently supported language codes.
-  // If alternative languages are listed, recognition result will contain
-  // recognition in the most likely language detected including the main
-  // language_code. The recognition result will include the language tag
-  // of the language detected in the audio.
-  // Note: This feature is only supported for Voice Command and Voice Search
-  // use cases and performance may vary for other use cases (e.g., phone call
+  // See [Language
+  // Support](https://cloud.google.com/speech-to-text/docs/languages) for a list
+  // of the currently supported language codes. If alternative languages are
+  // listed, recognition result will contain recognition in the most likely
+  // language detected including the main language_code. The recognition result
+  // will include the language tag of the language detected in the audio. Note:
+  // This feature is only supported for Voice Command and Voice Search use cases
+  // and performance may vary for other use cases (e.g., phone call
   // transcription).
   repeated string alternative_language_codes = 18;
 
-  // *Optional* Maximum number of recognition hypotheses to be returned.
+  // Maximum number of recognition hypotheses to be returned.
   // Specifically, the maximum number of `SpeechRecognitionAlternative` messages
   // within each `SpeechRecognitionResult`.
   // The server may return fewer than `max_alternatives`.
@@ -271,59 +289,68 @@ message RecognitionConfig {
   // one. If omitted, will return a maximum of one.
   int32 max_alternatives = 4;
 
-  // *Optional* If set to `true`, the server will attempt to filter out
+  // If set to `true`, the server will attempt to filter out
   // profanities, replacing all but the initial character in each filtered word
   // with asterisks, e.g. "f***". If set to `false` or omitted, profanities
   // won't be filtered out.
   bool profanity_filter = 5;
 
-  // *Optional* array of
-  // [SpeechContext][google.cloud.speech.v1p1beta1.SpeechContext]. A means to
-  // provide context to assist the speech recognition. For more information, see
-  // [Phrase Hints](/speech-to-text/docs/basics#phrase-hints).
+  // Speech adaptation configuration improves the accuracy of speech
+  // recognition. When speech adaptation is set it supersedes the
+  // `speech_contexts` field. For more information, see the [speech
+  // adaptation](https://cloud.google.com/speech-to-text/docs/context-strength)
+  // documentation.
+  SpeechAdaptation adaptation = 20;
+
+  // Array of [SpeechContext][google.cloud.speech.v1p1beta1.SpeechContext].
+  // A means to provide context to assist the speech recognition. For more
+  // information, see
+  // [speech
+  // adaptation](https://cloud.google.com/speech-to-text/docs/context-strength).
   repeated SpeechContext speech_contexts = 6;
 
-  // *Optional* If `true`, the top result includes a list of words and
+  // If `true`, the top result includes a list of words and
   // the start and end time offsets (timestamps) for those words. If
   // `false`, no word-level time offset information is returned. The default is
   // `false`.
   bool enable_word_time_offsets = 8;
 
-  // *Optional* If `true`, the top result includes a list of words and the
+  // If `true`, the top result includes a list of words and the
   // confidence for those words. If `false`, no word-level confidence
   // information is returned. The default is `false`.
   bool enable_word_confidence = 15;
 
-  // *Optional* If 'true', adds punctuation to recognition result hypotheses.
+  // If 'true', adds punctuation to recognition result hypotheses.
   // This feature is only available in select languages. Setting this for
   // requests in other languages has no effect at all.
   // The default 'false' value does not add punctuation to result hypotheses.
-  // Note: This is currently offered as an experimental service, complimentary
-  // to all users. In the future this may be exclusively available as a
-  // premium feature.
   bool enable_automatic_punctuation = 11;
 
-  // *Optional* If 'true', enables speaker detection for each recognized word in
+  // If 'true', enables speaker detection for each recognized word in
   // the top alternative of the recognition result using a speaker_tag provided
   // in the WordInfo.
-  // Note: When this is true, we send all the words from the beginning of the
+  // Note: Use diarization_config instead.
+  bool enable_speaker_diarization = 16 [deprecated = true];
+
+  // If set, specifies the estimated number of speakers in the conversation.
+  // Defaults to '2'. Ignored unless enable_speaker_diarization is set to true.
+  // Note: Use diarization_config instead.
+  int32 diarization_speaker_count = 17 [deprecated = true];
+
+  // Config to enable speaker diarization and set additional
+  // parameters to make diarization better suited for your application.
+  // Note: When this is enabled, we send all the words from the beginning of the
   // audio for the top alternative in every consecutive STREAMING responses.
   // This is done in order to improve our speaker tags as our models learn to
   // identify the speakers in the conversation over time.
   // For non-streaming requests, the diarization results will be provided only
   // in the top alternative of the FINAL SpeechRecognitionResult.
-  bool enable_speaker_diarization = 16;
-
-  // *Optional*
-  // If set, specifies the estimated number of speakers in the conversation.
-  // If not set, defaults to '2'.
-  // Ignored unless enable_speaker_diarization is set to true."
-  int32 diarization_speaker_count = 17;
+  SpeakerDiarizationConfig diarization_config = 19;
 
-  // *Optional* Metadata regarding this request.
+  // Metadata regarding this request.
   RecognitionMetadata metadata = 9;
 
-  // *Optional* Which model to select for the given request. Select the model
+  // Which model to select for the given request. Select the model
   // best suited to your domain to get best results. If a model is not
   // explicitly specified, then we auto-select a model based on the parameters
   // in the RecognitionConfig.
@@ -357,7 +384,7 @@ message RecognitionConfig {
   // 
   string model = 13;
 
-  // *Optional* Set to true to use an enhanced model for speech recognition.
+  // Set to true to use an enhanced model for speech recognition.
   // If `use_enhanced` is set to true and the `model` field is not set, then
   // an appropriate enhanced model is chosen if an enhanced model exists for
   // the audio.
@@ -368,6 +395,28 @@ message RecognitionConfig {
   bool use_enhanced = 14;
 }
 
+// Config to enable speaker diarization.
+message SpeakerDiarizationConfig {
+  // If 'true', enables speaker detection for each recognized word in
+  // the top alternative of the recognition result using a speaker_tag provided
+  // in the WordInfo.
+  bool enable_speaker_diarization = 1;
+
+  // Minimum number of speakers in the conversation. This range gives you more
+  // flexibility by allowing the system to automatically determine the correct
+  // number of speakers. If not set, the default value is 2.
+  int32 min_speaker_count = 2;
+
+  // Maximum number of speakers in the conversation. This range gives you more
+  // flexibility by allowing the system to automatically determine the correct
+  // number of speakers. If not set, the default value is 6.
+  int32 max_speaker_count = 3;
+
+  // Output only. Unused.
+  int32 speaker_tag = 5
+      [deprecated = true, (google.api.field_behavior) = OUTPUT_ONLY];
+}
+
 // Description of audio data to be recognized.
 message RecognitionMetadata {
   // Use case categories that the audio recognition request can be described
@@ -492,7 +541,7 @@ message RecognitionMetadata {
 
   // Obfuscated (privacy-protected) ID of the user, to identify number of
   // unique users using the service.
-  int64 obfuscated_id = 9;
+  int64 obfuscated_id = 9 [deprecated = true];
 
   // Description of the content. Eg. "Recordings of federal supreme court
   // hearings from 2012".
@@ -502,12 +551,12 @@ message RecognitionMetadata {
 // Provides "hints" to the speech recognizer to favor specific words and phrases
 // in the results.
 message SpeechContext {
-  // *Optional* A list of strings containing words and phrases "hints" so that
+  // A list of strings containing words and phrases "hints" so that
   // the speech recognition is more likely to recognize them. This can be used
   // to improve the accuracy for specific words and phrases, for example, if
   // specific commands are typically spoken by the user. This can also be used
   // to add additional words to the vocabulary of the recognizer. See
-  // [usage limits](/speech-to-text/quotas#content).
+  // [usage limits](https://cloud.google.com/speech-to-text/quotas#content).
   //
   // List items can also be set to classes for groups of words that represent
   // common concepts that occur in natural language. For example, rather than
@@ -530,13 +579,13 @@ message SpeechContext {
 // Contains audio data in the encoding specified in the `RecognitionConfig`.
 // Either `content` or `uri` must be supplied. Supplying both or neither
 // returns [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT].
-// See [content limits](/speech-to-text/quotas#content).
+// See [content limits](https://cloud.google.com/speech-to-text/quotas#content).
 message RecognitionAudio {
   // The audio source, which is either inline content or a Google Cloud
   // Storage uri.
   oneof audio_source {
     // The audio data bytes encoded as specified in
-    // `RecognitionConfig`. Note: as with all bytes fields, protobuffers use a
+    // `RecognitionConfig`. Note: as with all bytes fields, proto buffers use a
     // pure binary representation, whereas JSON representations use base64.
     bytes content = 1;
 
@@ -556,7 +605,7 @@ message RecognitionAudio {
 // contains the result as zero or more sequential `SpeechRecognitionResult`
 // messages.
 message RecognizeResponse {
-  // Output only. Sequential list of transcription results corresponding to
+  // Sequential list of transcription results corresponding to
   // sequential portions of audio.
   repeated SpeechRecognitionResult results = 2;
 }
@@ -567,7 +616,7 @@ message RecognizeResponse {
 // returned by the `GetOperation` call of the `google::longrunning::Operations`
 // service.
 message LongRunningRecognizeResponse {
-  // Output only. Sequential list of transcription results corresponding to
+  // Sequential list of transcription results corresponding to
   // sequential portions of audio.
   repeated SpeechRecognitionResult results = 2;
 }
@@ -585,6 +634,10 @@ message LongRunningRecognizeMetadata {
 
   // Time of the most recent processing update.
   google.protobuf.Timestamp last_update_time = 3;
+
+  // The URI of the audio file being transcribed. Empty if the audio was sent
+  // as byte content.
+  string uri = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // `StreamingRecognizeResponse` is the only message returned to the client by
@@ -652,44 +705,44 @@ message StreamingRecognizeResponse {
     END_OF_SINGLE_UTTERANCE = 1;
   }
 
-  // Output only. If set, returns a [google.rpc.Status][google.rpc.Status]
-  // message that specifies the error for the operation.
+  // If set, returns a [google.rpc.Status][google.rpc.Status] message that
+  // specifies the error for the operation.
   google.rpc.Status error = 1;
 
-  // Output only. This repeated list contains zero or more results that
+  // This repeated list contains zero or more results that
   // correspond to consecutive portions of the audio currently being processed.
   // It contains zero or one `is_final=true` result (the newly settled portion),
   // followed by zero or more `is_final=false` results (the interim results).
   repeated StreamingRecognitionResult results = 2;
 
-  // Output only. Indicates the type of speech event.
+  // Indicates the type of speech event.
   SpeechEventType speech_event_type = 4;
 }
 
 // A streaming speech recognition result corresponding to a portion of the audio
 // that is currently being processed.
 message StreamingRecognitionResult {
-  // Output only. May contain one or more recognition hypotheses (up to the
+  // May contain one or more recognition hypotheses (up to the
   // maximum specified in `max_alternatives`).
   // These alternatives are ordered in terms of accuracy, with the top (first)
   // alternative being the most probable, as ranked by the recognizer.
   repeated SpeechRecognitionAlternative alternatives = 1;
 
-  // Output only. If `false`, this `StreamingRecognitionResult` represents an
+  // If `false`, this `StreamingRecognitionResult` represents an
   // interim result that may change. If `true`, this is the final time the
   // speech service will return this particular `StreamingRecognitionResult`,
   // the recognizer will not return any further hypotheses for this portion of
   // the transcript and corresponding audio.
   bool is_final = 2;
 
-  // Output only. An estimate of the likelihood that the recognizer will not
+  // An estimate of the likelihood that the recognizer will not
   // change its guess about this interim result. Values range from 0.0
   // (completely unstable) to 1.0 (completely stable).
   // This field is only provided for interim results (`is_final=false`).
   // The default of 0.0 is a sentinel value indicating `stability` was not set.
   float stability = 3;
 
-  // Output only. Time offset of the end of this result relative to the
+  // Time offset of the end of this result relative to the
   // beginning of the audio.
   google.protobuf.Duration result_end_time = 4;
 
@@ -698,16 +751,15 @@ message StreamingRecognitionResult {
   // For audio_channel_count = N, its output values can range from '1' to 'N'.
   int32 channel_tag = 5;
 
-  // Output only. The
-  // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the
-  // language in this result. This language code was detected to have the most
-  // likelihood of being spoken in the audio.
-  string language_code = 6;
+  // Output only. The [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt)
+  // language tag of the language in this result. This language code was
+  // detected to have the most likelihood of being spoken in the audio.
+  string language_code = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // A speech recognition result corresponding to a portion of the audio.
 message SpeechRecognitionResult {
-  // Output only. May contain one or more recognition hypotheses (up to the
+  // May contain one or more recognition hypotheses (up to the
   // maximum specified in `max_alternatives`).
   // These alternatives are ordered in terms of accuracy, with the top (first)
   // alternative being the most probable, as ranked by the recognizer.
@@ -718,19 +770,18 @@ message SpeechRecognitionResult {
   // For audio_channel_count = N, its output values can range from '1' to 'N'.
   int32 channel_tag = 2;
 
-  // Output only. The
-  // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the
-  // language in this result. This language code was detected to have the most
-  // likelihood of being spoken in the audio.
-  string language_code = 5;
+  // Output only. The [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt)
+  // language tag of the language in this result. This language code was
+  // detected to have the most likelihood of being spoken in the audio.
+  string language_code = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Alternative hypotheses (a.k.a. n-best list).
 message SpeechRecognitionAlternative {
-  // Output only. Transcript text representing the words that the user spoke.
+  // Transcript text representing the words that the user spoke.
   string transcript = 1;
 
-  // Output only. The confidence estimate between 0.0 and 1.0. A higher number
+  // The confidence estimate between 0.0 and 1.0. A higher number
   // indicates an estimated greater likelihood that the recognized words are
   // correct. This field is set only for the top alternative of a non-streaming
   // result or, of a streaming result where `is_final=true`.
@@ -739,7 +790,7 @@ message SpeechRecognitionAlternative {
   // The default of 0.0 is a sentinel value indicating `confidence` was not set.
   float confidence = 2;
 
-  // Output only. A list of word-specific information for each recognized word.
+  // A list of word-specific information for each recognized word.
   // Note: When `enable_speaker_diarization` is true, you will see all the words
   // from the beginning of the audio.
   repeated WordInfo words = 3;
@@ -747,7 +798,7 @@ message SpeechRecognitionAlternative {
 
 // Word-specific information for recognized words.
 message WordInfo {
-  // Output only. Time offset relative to the beginning of the audio,
+  // Time offset relative to the beginning of the audio,
   // and corresponding to the start of the spoken word.
   // This field is only set if `enable_word_time_offsets=true` and only
   // in the top hypothesis.
@@ -755,7 +806,7 @@ message WordInfo {
   // vary.
   google.protobuf.Duration start_time = 1;
 
-  // Output only. Time offset relative to the beginning of the audio,
+  // Time offset relative to the beginning of the audio,
   // and corresponding to the end of the spoken word.
   // This field is only set if `enable_word_time_offsets=true` and only
   // in the top hypothesis.
@@ -763,10 +814,10 @@ message WordInfo {
   // vary.
   google.protobuf.Duration end_time = 2;
 
-  // Output only. The word corresponding to this set of information.
+  // The word corresponding to this set of information.
   string word = 3;
 
-  // Output only. The confidence estimate between 0.0 and 1.0. A higher number
+  // The confidence estimate between 0.0 and 1.0. A higher number
   // indicates an estimated greater likelihood that the recognized words are
   // correct. This field is set only for the top alternative of a non-streaming
   // result or, of a streaming result where `is_final=true`.
@@ -780,5 +831,5 @@ message WordInfo {
   // have spoken this word. Value ranges from '1' to diarization_speaker_count.
   // speaker_tag is set if enable_speaker_diarization = 'true' and only in the
   // top alternative.
-  int32 speaker_tag = 5;
+  int32 speaker_tag = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
diff --git a/third_party/googleapis/google/cloud/speech/v1p1beta1/resource.proto b/third_party/googleapis/google/cloud/speech/v1p1beta1/resource.proto
new file mode 100644
index 000000000..5bb379ff1
--- /dev/null
+++ b/third_party/googleapis/google/cloud/speech/v1p1beta1/resource.proto
@@ -0,0 +1,129 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.speech.v1p1beta1;
+
+import "google/api/annotations.proto";
+import "google/api/resource.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/speech/v1p1beta1;speech";
+option java_multiple_files = true;
+option java_outer_classname = "SpeechResourceProto";
+option java_package = "com.google.cloud.speech.v1p1beta1";
+option objc_class_prefix = "GCS";
+
+// A set of words or phrases that represents a common concept likely to appear
+// in your audio, for example a list of passenger ship names. CustomClass items
+// can be substituted into placeholders that you set in PhraseSet phrases.
+message CustomClass {
+  option (google.api.resource) = {
+    type: "speech.googleapis.com/CustomClass"
+    pattern: "projects/{project}/locations/{location}/customClasses/{custom_class}"
+  };
+
+  // An item of the class.
+  message ClassItem {
+    // The class item's value.
+    string value = 1;
+  }
+
+  // The resource name of the custom class.
+  string name = 1;
+
+  // If this custom class is a resource, the custom_class_id is the resource id
+  // of the CustomClass.
+  string custom_class_id = 2;
+
+  // A collection of class items.
+  repeated ClassItem items = 3;
+}
+
+// Provides "hints" to the speech recognizer to favor specific words and phrases
+// in the results.
+message PhraseSet {
+  option (google.api.resource) = {
+    type: "speech.googleapis.com/PhraseSet"
+    pattern: "projects/{project}/locations/{location}/phraseSets/{phrase_set}"
+  };
+
+  // A phrases containing words and phrase "hints" so that
+  // the speech recognition is more likely to recognize them. This can be used
+  // to improve the accuracy for specific words and phrases, for example, if
+  // specific commands are typically spoken by the user. This can also be used
+  // to add additional words to the vocabulary of the recognizer. See
+  // [usage limits](https://cloud.google.com/speech-to-text/quotas#content).
+  //
+  // List items can also include pre-built or custom classes containing groups
+  // of words that represent common concepts that occur in natural language. For
+  // example, rather than providing a phrase hint for every month of the
+  // year (e.g. "i was born in january", "i was born in febuary", ...), use the
+  // pre-built `$MONTH` class improves the likelihood of correctly transcribing
+  // audio that includes months (e.g. "i was born in $month").
+  // To refer to pre-built classes, use the class' symbol prepended with `$`
+  // e.g. `$MONTH`. To refer to custom classes that were defined inline in the
+  // request, set the class's `custom_class_id` to a string unique to all class
+  // resources and inline classes. Then use the class' id wrapped in $`{...}`
+  // e.g. "${my-months}". To refer to custom classes resources, use the class'
+  // id wrapped in `${}` (e.g. `${my-months}`).
+  message Phrase {
+    // The phrase itself.
+    string value = 1;
+
+    // Hint Boost. Overrides the boost set at the phrase set level.
+    // Positive value will increase the probability that a specific phrase will
+    // be recognized over other similar sounding phrases. The higher the boost,
+    // the higher the chance of false positive recognition as well. Negative
+    // boost values would correspond to anti-biasing. Anti-biasing is not
+    // enabled, so negative boost will simply be ignored. Though `boost` can
+    // accept a wide range of positive values, most use cases are best served
+    // with values between 0 and 20. We recommend using a binary search approach
+    // to finding the optimal value for your use case. Speech recognition
+    // will skip PhraseSets with a boost value of 0.
+    float boost = 2;
+  }
+
+  // The resource name of the phrase set.
+  string name = 1;
+
+  // A list of word and phrases.
+  repeated Phrase phrases = 2;
+
+  // Hint Boost. Positive value will increase the probability that a specific
+  // phrase will be recognized over other similar sounding phrases. The higher
+  // the boost, the higher the chance of false positive recognition as well.
+  // Negative boost values would correspond to anti-biasing. Anti-biasing is not
+  // enabled, so negative boost will simply be ignored. Though `boost` can
+  // accept a wide range of positive values, most use cases are best served with
+  // values between 0 (exclusive) and 20. We recommend using a binary search
+  // approach to finding the optimal value for your use case. Speech recognition
+  // will skip PhraseSets with a boost value of 0.
+  float boost = 4;
+}
+
+// Speech adaptation configuration.
+message SpeechAdaptation {
+  // A collection of phrase sets. To specify the hints inline, leave the
+  // phrase set's `name` blank and fill in the rest of its fields. Any
+  // phrase set can use any custom class.
+  repeated PhraseSet phrase_sets = 1;
+
+  // A collection of custom classes. To specify the classes inline, leave the
+  // class' `name` blank and fill in the rest of its fields, giving it a unique
+  // `custom_class_id`. Refer to the inline defined class in phrase hints by its
+  // `custom_class_id`.
+  repeated CustomClass custom_classes = 2;
+}
diff --git a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_adaptation_beta.yaml b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_adaptation_beta.yaml
new file mode 100644
index 000000000..b687bd592
--- /dev/null
+++ b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_adaptation_beta.yaml
@@ -0,0 +1,49 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
+samples:
+- region_tag: speech_adaptation_beta
+  title: Speech Adaptation (Cloud Storage)
+  description: Transcribe a short audio file with speech adaptation.
+  rpc: Recognize
+  service: google.cloud.speech.v1p1beta1.Speech
+  request:
+  - field: audio.uri
+    value: "gs://cloud-samples-data/speech/brooklyn_bridge.mp3"
+    input_parameter: storage_uri
+    comment: URI for audio file in Cloud Storage, e.g. gs://[BUCKET]/[FILE]
+  - field: config.speech_contexts[0].phrases[0]
+    value: "Brooklyn Bridge"
+    input_parameter: phrase
+    comment: |
+      Phrase "hints" help recognize the specified phrases from your audio.
+  - field: config.speech_contexts[0].boost
+    value: 20.0
+    comment: |
+      Hint Boost. This value increases the probability that a specific
+      phrase will be recognized over other similar sounding phrases.
+      The higher the boost, the higher the chance of false positive
+      recognition as well. Can accept wide range of positive values.
+      Most use cases are best served with values between 0 and 20.
+      Using a binary search happroach may help you find the optimal value.
+  - field: config.sample_rate_hertz
+    value: 44100
+    comment: Sample rate in Hertz of the audio data sent
+  - field: config.language_code
+    value: "en-US"
+    comment: The language of the supplied audio
+  - field: config.encoding
+    value: MP3
+    comment: |
+      Encoding of audio data sent. This sample sets this explicitly.
+      This field is optional for FLAC and WAV audio formats.
+  response:
+  - loop:
+      variable: result
+      collection: $resp.results
+      body:
+      - comment:
+        - First alternative is the most probable result
+      - define: alternative = result.alternatives[0]
+      - print:
+        - "Transcript: %s"
+        - alternative.transcript
diff --git a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_contexts_classes_beta.yaml b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_contexts_classes_beta.yaml
new file mode 100644
index 000000000..1103f362b
--- /dev/null
+++ b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_contexts_classes_beta.yaml
@@ -0,0 +1,43 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
+samples:
+- region_tag: speech_contexts_classes_beta
+  title: Using Context Classes (Cloud Storage)
+  description: Transcribe a short audio file with static context classes.
+  rpc: Recognize
+  service: google.cloud.speech.v1p1beta1.Speech
+  request:
+  - field: audio.uri
+    value: "gs://cloud-samples-data/speech/time.mp3"
+    input_parameter: storage_uri
+    comment: URI for audio file in Cloud Storage, e.g. gs://[BUCKET]/[FILE]
+  - field: config.speech_contexts[0].phrases[0]
+    value: "$TIME"
+    input_parameter: phrase
+    comment: |
+      Phrase "hints" help recognize the specified phrases from your audio.
+      In this sample we are using a static class phrase ($TIME).
+      Classes represent groups of words that represent common concepts
+      that occur in natural language.
+  - field: config.language_code
+    value: "en-US"
+    comment: The language of the supplied audio
+  - field: config.sample_rate_hertz
+    value: 24000
+    comment: Sample rate in Hertz of the audio data sent
+  - field: config.encoding
+    value: MP3
+    comment: |
+      Encoding of audio data sent. This sample sets this explicitly.
+      This field is optional for FLAC and WAV audio formats.
+  response:
+  - loop:
+      variable: result
+      collection: $resp.results
+      body:
+      - comment:
+        - First alternative is the most probable result
+      - define: alternative = result.alternatives[0]
+      - print:
+        - "Transcript: %s"
+        - alternative.transcript
diff --git a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_quickstart_beta.yaml b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_quickstart_beta.yaml
new file mode 100644
index 000000000..44aff9cf8
--- /dev/null
+++ b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_quickstart_beta.yaml
@@ -0,0 +1,35 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
+samples:
+- region_tag: speech_quickstart_beta
+  title: Quickstart Beta
+  description: Performs synchronous speech recognition on an audio file
+  rpc: Recognize
+  service: google.cloud.speech.v1p1beta1.Speech
+  request:
+  - field: audio.uri
+    value: "gs://cloud-samples-data/speech/brooklyn_bridge.mp3"
+    input_parameter: storage_uri
+    comment: URI for audio file in Cloud Storage, e.g. gs://[BUCKET]/[FILE]
+  - field: config.language_code
+    value: "en-US"
+    comment: The language of the supplied audio
+  - field: config.sample_rate_hertz
+    value: 44100
+    comment: Sample rate in Hertz of the audio data sent
+  - field: config.encoding
+    value: MP3
+    comment: |
+      Encoding of audio data sent. This sample sets this explicitly.
+      This field is optional for FLAC and WAV audio formats.
+  response:
+  - loop:
+      variable: result
+      collection: $resp.results
+      body:
+      - comment:
+        - First alternative is the most probable result
+      - define: alternative = result.alternatives[0]
+      - print:
+        - "Transcript: %s"
+        - alternative.transcript
diff --git a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_auto_punctuation_beta.yaml b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_auto_punctuation_beta.yaml
index 2093ab0d3..636d61cac 100644
--- a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_auto_punctuation_beta.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_auto_punctuation_beta.yaml
@@ -1,34 +1,35 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
 samples:
-- id: speech_transcribe_auto_punctuation_beta
+- region_tag: speech_transcribe_auto_punctuation_beta
   title: Getting punctuation in results (Local File) (Beta)
-  description: |
-    Transcribe a short audio file with punctuation
+  description: Transcribe a short audio file with punctuation
   rpc: Recognize
   service: google.cloud.speech.v1p1beta1.Speech
-  parameters:
-    defaults:
-    - audio.content = "resources/commercial_mono.wav"
-    - config.enable_automatic_punctuation = True
-    - config.language_code = "en-US"
-    attributes:
-    - parameter: audio.content
-      sample_argument_name: local_file_path
-      read_file: true
-      description: "Path to local audio file, e.g. /path/audio.wav"
-    - parameter: config.enable_automatic_punctuation
-      description: |
-        When enabled, trascription results may include punctuation (available for select languages).
-    - parameter: config.language_code
-      description: |
-        The language of the supplied audio. Even though additional languages are
-        provided by alternative_language_codes, a primary language is still required.
-  on_success:
+  request:
+  - field: audio.content
+    value: "resources/commercial_mono.wav"
+    input_parameter: local_file_path
+    comment: Path to local audio file, e.g. /path/audio.wav
+    value_is_file: true
+  - field: config.enable_automatic_punctuation
+    value: true
+    comment: |
+      When enabled, trascription results may include punctuation
+      (available for select languages).
+  - field: config.language_code
+    value: "en-US"
+    comment: |
+      The language of the supplied audio. Even though additional languages are
+      provided by alternative_language_codes, a primary language is still required.
+  response:
   - loop:
       variable: result
       collection: $resp.results
       body:
-      - comment: ["First alternative is the most probable result"]
-      - define: alternative=result.alternatives[0]
+      - comment:
+        - First alternative is the most probable result
+      - define: alternative = result.alternatives[0]
       - print:
         - "Transcript: %s"
         - alternative.transcript
diff --git a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_diarization_beta.yaml b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_diarization_beta.yaml
index 4e2eb66ba..55c150336 100644
--- a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_diarization_beta.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_diarization_beta.yaml
@@ -1,46 +1,51 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
 samples:
-# TODO: this id should include "async" (calls LongRunningRecognize async rpc)
-- id: speech_transcribe_diarization_beta
+- region_tag: speech_transcribe_diarization_beta
   title: Separating different speakers (Local File) (LRO) (Beta)
   description: |
     Print confidence level for individual words in a transcription of a short audio file
     Separating different speakers in an audio file recording
   rpc: LongRunningRecognize
   service: google.cloud.speech.v1p1beta1.Speech
-  parameters:
-    defaults:
-    - audio.content = "resources/commercial_mono.wav"
-    - config.enable_speaker_diarization = True
-    - config.diarization_speaker_count = 2
-    - config.language_code = "en-US"
-    attributes:
-    - parameter: audio.content
-      sample_argument_name: local_file_path
-      read_file: true
-      description: "Path to local audio file, e.g. /path/audio.wav"
-    - parameter: config.enable_speaker_diarization
-      description: |
-        If enabled, each word in the first alternative of each result will be
-        tagged with a speaker tag to identify the speaker.
-    - parameter: config.diarization_speaker_count
-      description: |
-        Optional. Specifies the estimated number of speakers in the conversation.
-    - parameter: config.language_code
-      description: "The language of the supplied audio"
-  on_success:
+  request:
+  - field: audio.content
+    value: "resources/commercial_mono.wav"
+    input_parameter: local_file_path
+    comment: Path to local audio file, e.g. /path/audio.wav
+    value_is_file: true
+  - field: config.enable_speaker_diarization
+    value: true
+    comment: |
+      If enabled, each word in the first alternative of each result will be
+      tagged with a speaker tag to identify the speaker.
+  - field: config.diarization_speaker_count
+    value: 2
+    comment: Optional. Specifies the estimated number of speakers in the conversation.
+  - field: config.language_code
+    value: "en-US"
+    comment: The language of the supplied audio
+  response:
   - loop:
       collection: $resp.results
       variable: result
       body:
-      - comment: ["First alternative has words tagged with speakers"]
-      - define: alternative=result.alternatives[0]
+      - comment:
+        - First alternative has words tagged with speakers
+      - define: alternative = result.alternatives[0]
       - print:
         - "Transcript: %s"
         - alternative.transcript
-      - comment: ["Print the %s of each word", speaker_tag]
+      - comment:
+        - Print the %s of each word
+        - speaker_tag
       - loop:
           collection: alternative.words
           variable: word
           body:
-          - print: ["Word: %s", word.word]
-          - print: ["Speaker tag: %s", word.speaker_tag]
+          - print:
+            - 'Word: %s'
+            - word.word
+          - print:
+            - 'Speaker tag: %s'
+            - word.speaker_tag
diff --git a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_multilanguage_beta.yaml b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_multilanguage_beta.yaml
index 7852d51e8..3cbf84914 100644
--- a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_multilanguage_beta.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_multilanguage_beta.yaml
@@ -1,37 +1,44 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
 samples:
-- id: speech_transcribe_multilanguage_beta
+- region_tag: speech_transcribe_multilanguage_beta
   title: Detecting language spoken automatically (Local File) (Beta)
   description: |
     Transcribe a short audio file with language detected from a list of possible languages
   rpc: Recognize
   service: google.cloud.speech.v1p1beta1.Speech
-  parameters:
-    defaults:
-    - audio.content = "resources/brooklyn_bridge.flac"
-    - config.language_code = "fr"
-    - config.alternative_language_codes[0] = "es"
-    - config.alternative_language_codes[1] = "en"
-    attributes:
-    - parameter: audio.content
-      sample_argument_name: local_file_path
-      read_file: true
-      description: "Path to local audio file, e.g. /path/audio.wav"
-    - parameter: config.alternative_language_codes[0]
-      description: |
-        Specify up to 3 additional languages as possible alternative languages of the supplied audio.
-    - parameter: config.language_code
-      description: |
-        The language of the supplied audio. Even though additional languages are
-        provided by alternative_language_codes, a primary language is still required.
-  on_success:
+  request:
+  - field: audio.content
+    value: resources/brooklyn_bridge.flac
+    input_parameter: local_file_path
+    comment: Path to local audio file, e.g. /path/audio.wav
+    value_is_file: true
+  - field: config.language_code
+    value: "fr"
+    comment: |
+      The language of the supplied audio. Even though additional languages are
+      provided by alternative_language_codes, a primary language is still required.
+  - field: config.alternative_language_codes[0]
+    value: "es"
+    comment: |
+      Specify up to 3 additional languages as possible alternative languages
+      of the supplied audio.
+  - field: config.alternative_language_codes[1]
+    value: "en"
+  response:
   - loop:
       variable: result
       collection: $resp.results
       body:
-      - comment: ["The %s which was detected as the most likely being spoken in the audio", language_code]
-      - print: ["Detected language: %s", result.language_code]
-      - comment: ["First alternative is the most probable result"]
-      - define: alternative=result.alternatives[0]
+      - comment:
+        - The %s which was detected as the most likely being spoken in the audio
+        - language_code
+      - print:
+        - "Detected language: %s"
+        - result.language_code
+      - comment:
+        - First alternative is the most probable result
+      - define: alternative = result.alternatives[0]
       - print:
         - "Transcript: %s"
         - alternative.transcript
diff --git a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_recognition_metadata_beta.yaml b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_recognition_metadata_beta.yaml
index 70dba7257..9517f6460 100644
--- a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_recognition_metadata_beta.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_recognition_metadata_beta.yaml
@@ -1,42 +1,41 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
 samples:
-- id: speech_transcribe_recognition_metadata_beta
+- region_tag: speech_transcribe_recognition_metadata_beta
   title: Adding recognition metadata (Local File) (Beta)
-  description: |
-    Adds additional details short audio file included in this recognition request
+  description: Adds additional details short audio file included in this recognition request
   rpc: Recognize
   service: google.cloud.speech.v1p1beta1.Speech
-  parameters:
-    defaults:
-    - audio.content = "resources/commercial_mono.wav"
-    - config.metadata.interaction_type = VOICE_SEARCH
-    - config.metadata.recording_device_type = SMARTPHONE
-    - config.metadata.recording_device_name = "Pixel 3"
-    - config.language_code = "en-US"
-    attributes:
-    - parameter: audio.content
-      sample_argument_name: local_file_path
-      read_file: true
-      description: "Path to local audio file, e.g. /path/audio.wav"
-    - parameter: config.metadata.interaction_type
-      description: |
-        The use case of the audio, e.g. PHONE_CALL, DISCUSSION, PRESENTATION, et al.
-    - parameter: config.metadata.recording_device_type
-      description: The kind of device used to capture the audio
-    - parameter: config.metadata.recording_device_name
-      description: |
-        The device used to make the recording.
-        Arbitrary string, e.g. 'Pixel XL', 'VoIP', 'Cardioid Microphone', or other value.
-    - parameter: config.language_code
-      description: |
-        The language of the supplied audio. Even though additional languages are
-        provided by alternative_language_codes, a primary language is still required.
-  on_success:
+  request:
+  - field: audio.content
+    value: "resources/commercial_mono.wav"
+    input_parameter: local_file_path
+    comment: Path to local audio file, e.g. /path/audio.wav
+    value_is_file: true
+  - field: config.metadata.interaction_type
+    value: VOICE_SEARCH
+    comment: The use case of the audio, e.g. PHONE_CALL, DISCUSSION, PRESENTATION, et al.
+  - field: config.metadata.recording_device_type
+    value: SMARTPHONE
+    comment: The kind of device used to capture the audio
+  - field: config.metadata.recording_device_name
+    value: "Pixel 3"
+    comment: |
+      The device used to make the recording.
+      Arbitrary string, e.g. 'Pixel XL', 'VoIP', 'Cardioid Microphone', or other value.
+  - field: config.language_code
+    value: "en-US"
+    comment: |
+      The language of the supplied audio. Even though additional languages are
+      provided by alternative_language_codes, a primary language is still required.
+  response:
   - loop:
       variable: result
       collection: $resp.results
       body:
-      - comment: ["First alternative is the most probable result"]
-      - define: alternative=result.alternatives[0]
+      - comment:
+        - First alternative is the most probable result
+      - define: alternative = result.alternatives[0]
       - print:
         - "Transcript: %s"
         - alternative.transcript
diff --git a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_word_level_confidence_beta.yaml b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_word_level_confidence_beta.yaml
index 66978a5d9..bc085b3a6 100644
--- a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_word_level_confidence_beta.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_word_level_confidence_beta.yaml
@@ -1,38 +1,45 @@
+type: com.google.api.codegen.samplegen.v1p2.SampleConfigProto
+schema_version: 1.2.0
 samples:
-- id: speech_transcribe_word_level_confidence_beta
+- region_tag: speech_transcribe_word_level_confidence_beta
   title: Enabling word-level confidence (Local File) (Beta)
   description: |
-    Print confidence level for individual words in a transcription of a short audio file
+    Print confidence level for individual words in a transcription of a short audio file.
   rpc: Recognize
   service: google.cloud.speech.v1p1beta1.Speech
-  parameters:
-    defaults:
-    - audio.content = "resources/brooklyn_bridge.flac"
-    - config.enable_word_confidence = True
-    - config.language_code = "en-US"
-    attributes:
-    - parameter: audio.content
-      sample_argument_name: local_file_path
-      read_file: true
-      description: "Path to local audio file, e.g. /path/audio.wav"
-    - parameter: config.enable_word_confidence
-      description: |
-        When enabled, the first result returned by the API will include a list
-        of words and the confidence level for each of those words.
-    - parameter: config.language_code
-      description: "The language of the supplied audio"
-  on_success:
-  - comment: ["The first result includes confidence levels per word"]
-  - define: result=$resp.results[0]
-  - comment: ["First alternative is the most probable result"]
-  - define: alternative=result.alternatives[0]
+  request:
+  - field: audio.content
+    value: "resources/brooklyn_bridge.flac"
+    input_parameter: local_file_path
+    comment: Path to local audio file, e.g. /path/audio.wav
+    value_is_file: true
+  - field: config.enable_word_confidence
+    value: true
+    comment: |
+      When enabled, the first result returned by the API will include a list
+      of words and the confidence level for each of those words.
+  - field: config.language_code
+    value: "en-US"
+    comment: The language of the supplied audio
+  response:
+  - comment:
+    - The first result includes confidence levels per word
+  - define: result = $resp.results[0]
+  - comment:
+    - First alternative is the most probable result
+  - define: alternative = result.alternatives[0]
   - print:
     - "Transcript: %s"
     - alternative.transcript
-  - comment: ["Print the confidence level of each word"]
+  - comment:
+    - Print the confidence level of each word
   - loop:
       collection: alternative.words
       variable: word
       body:
-      - print: ["Word: %s", word.word]
-      - print: ["Confidence: %s", word.confidence]
+      - print:
+        - "Word: %s"
+        - word.word
+      - print:
+        - "Confidence: %s"
+        - word.confidence
diff --git a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_adaptation_beta.test.yaml b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_adaptation_beta.test.yaml
similarity index 87%
rename from third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_adaptation_beta.test.yaml
rename to third_party/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_adaptation_beta.test.yaml
index a5be2cba3..4efe8e83f 100644
--- a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_adaptation_beta.test.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_adaptation_beta.test.yaml
@@ -1,3 +1,5 @@
+type: test/samples
+schema_version: 1
 test:
   suites:
   - name: Speech-to-Text Sample Tests For Speech Adaptation
diff --git a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_contexts_classes_beta.test.yaml b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_contexts_classes_beta.test.yaml
similarity index 88%
rename from third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_contexts_classes_beta.test.yaml
rename to third_party/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_contexts_classes_beta.test.yaml
index 6525a4beb..b6dccfc71 100644
--- a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_contexts_classes_beta.test.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_contexts_classes_beta.test.yaml
@@ -1,3 +1,5 @@
+type: test/samples
+schema_version: 1
 test:
   suites:
   - name: Speech-to-Text Sample Tests For Speech Contexts Static Classes
diff --git a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_quickstart_beta.test.yaml b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_quickstart_beta.test.yaml
similarity index 87%
rename from third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_quickstart_beta.test.yaml
rename to third_party/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_quickstart_beta.test.yaml
index 10ec749de..bd5bf6700 100644
--- a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_quickstart_beta.test.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_quickstart_beta.test.yaml
@@ -1,3 +1,5 @@
+type: test/samples
+schema_version: 1
 test:
   suites:
   - name: Speech-to-Text Sample Tests For Quickstart
diff --git a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_auto_punctuation_beta.test.yaml b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_transcribe_auto_punctuation_beta.test.yaml
similarity index 93%
rename from third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_auto_punctuation_beta.test.yaml
rename to third_party/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_transcribe_auto_punctuation_beta.test.yaml
index cb49b8c76..1ab5f79a0 100644
--- a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_auto_punctuation_beta.test.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_transcribe_auto_punctuation_beta.test.yaml
@@ -1,3 +1,5 @@
+type: test/samples
+schema_version: 1
 test:
   suites:
   - name: Getting punctuation in results (Local File) (Beta)
@@ -12,7 +14,7 @@ test:
         # Simply assert that actual punctuation is present from commercial_mono.wav
         - literal: "?"
         - literal: ","
-        - literal: "'"
+        - literal: ""
 
     # Confirm that another file can be transcribed (use another file)
     - name: speech_transcribe_auto_punctuation_beta (--local_file_path)
diff --git a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_diarization_beta.test.yaml b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_transcribe_diarization_beta.test.yaml
similarity index 97%
rename from third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_diarization_beta.test.yaml
rename to third_party/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_transcribe_diarization_beta.test.yaml
index f752efa53..409e4b54b 100644
--- a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_diarization_beta.test.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_transcribe_diarization_beta.test.yaml
@@ -1,3 +1,5 @@
+type: test/samples
+schema_version: 1
 test:
   suites:
   - name: Separating different speakers (Local File) (LRO) (Beta)
diff --git a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_multilanguage_beta.test.yaml b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_transcribe_multilanguage_beta.test.yaml
similarity index 97%
rename from third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_multilanguage_beta.test.yaml
rename to third_party/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_transcribe_multilanguage_beta.test.yaml
index a9b0dd547..d9f2d7109 100644
--- a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_multilanguage_beta.test.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_transcribe_multilanguage_beta.test.yaml
@@ -1,3 +1,5 @@
+type: test/samples
+schema_version: 1
 test:
   suites:
   - name: Detecting language spoken automatically (Local File) (Beta)
diff --git a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_recognition_metadata_beta.test.yaml b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_transcribe_recognition_metadata_beta.test.yaml
similarity index 95%
rename from third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_recognition_metadata_beta.test.yaml
rename to third_party/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_transcribe_recognition_metadata_beta.test.yaml
index 7bcf7740c..57cf24a1d 100644
--- a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_recognition_metadata_beta.test.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_transcribe_recognition_metadata_beta.test.yaml
@@ -1,3 +1,5 @@
+type: test/samples
+schema_version: 1
 test:
   suites:
   - name: Adding recognition metadata (Local File) (Beta)
diff --git a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_word_level_confidence_beta.test.yaml b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_transcribe_word_level_confidence_beta.test.yaml
similarity index 96%
rename from third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_word_level_confidence_beta.test.yaml
rename to third_party/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_transcribe_word_level_confidence_beta.test.yaml
index d5ab8f18c..0d7d60570 100644
--- a/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/speech_transcribe_word_level_confidence_beta.test.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1p1beta1/samples/test/speech_transcribe_word_level_confidence_beta.test.yaml
@@ -1,3 +1,5 @@
+type: test/samples
+schema_version: 1
 test:
   suites:
   - name: Enabling word-level confidence (Local File) (Beta)
diff --git a/third_party/googleapis/google/cloud/speech/v1p1beta1/speech_gapic.legacy.yaml b/third_party/googleapis/google/cloud/speech/v1p1beta1/speech_gapic.legacy.yaml
new file mode 100644
index 000000000..0d778cd94
--- /dev/null
+++ b/third_party/googleapis/google/cloud/speech/v1p1beta1/speech_gapic.legacy.yaml
@@ -0,0 +1,90 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.speech.v1p1beta1
+  python:
+    package_name: google.cloud.speech_v1p1beta1.gapic
+  go:
+    package_name: cloud.google.com/go/speech/apiv1p1beta1
+  csharp:
+    package_name: Google.Cloud.Speech.V1P1Beta1
+  ruby:
+    package_name: Google::Cloud::Speech::V1p1beta1
+  php:
+    package_name: Google\Cloud\Speech\V1p1beta1
+  nodejs:
+    package_name: speech.v1p1beta1
+    domain_layer_location: google-cloud
+interfaces:
+- name: google.cloud.speech.v1p1beta1.Speech
+  smoke_test:
+    method: Recognize
+    init_fields:
+    - config.language_code="en-US"
+    - config.sample_rate_hertz=44100
+    - config.encoding=FLAC
+    - audio.uri="gs://gapic-toolkit/hello.flac"
+  collections: []
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 1000000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 1000000
+    total_timeout_millis: 5000000
+  methods:
+  - name: Recognize
+    flattening:
+      groups:
+      - parameters:
+        - config
+        - audio
+    required_fields:
+    - config
+    - audio
+    sample_code_init_fields:
+    - config.encoding=FLAC
+    - config.sample_rate_hertz=44100
+    - config.language_code="en-US"
+    - audio.uri=gs://bucket_name/file_name.flac
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 1000000
+  - name: LongRunningRecognize
+    flattening:
+      groups:
+      - parameters:
+        - config
+        - audio
+    required_fields:
+    - config
+    - audio
+    sample_code_init_fields:
+    - config.encoding=FLAC
+    - config.sample_rate_hertz=44100
+    - config.language_code="en-US"
+    - audio.uri=gs://bucket_name/file_name.flac
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    long_running:
+      return_type: google.cloud.speech.v1p1beta1.LongRunningRecognizeResponse
+      metadata_type: google.cloud.speech.v1p1beta1.LongRunningRecognizeMetadata
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+  - name: StreamingRecognize
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 1000000
diff --git a/third_party/googleapis/google/cloud/speech/v1p1beta1/speech_gapic.yaml b/third_party/googleapis/google/cloud/speech/v1p1beta1/speech_gapic.yaml
index d5312d129..f77b1a3fe 100644
--- a/third_party/googleapis/google/cloud/speech/v1p1beta1/speech_gapic.yaml
+++ b/third_party/googleapis/google/cloud/speech/v1p1beta1/speech_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.speech.v1p1beta1
@@ -24,15 +24,7 @@ interfaces:
     - config.language_code="en-US"
     - config.sample_rate_hertz=44100
     - config.encoding=FLAC
-    - audio.uri="gs://gapic-toolkit/hello.flac"
-  collections: []
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
+    - audio.uri="gs://cloud-samples-data/speech/brooklyn_bridge.flac"
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 100
@@ -44,387 +36,17 @@ interfaces:
     total_timeout_millis: 5000000
   methods:
   - name: Recognize
-    flattening:
-      groups:
-      - parameters:
-        - config
-        - audio
-    required_fields:
-    - config
-    - audio
+    retry_codes_name: idempotent
     sample_code_init_fields:
     - config.encoding=FLAC
     - config.sample_rate_hertz=44100
     - config.language_code="en-US"
     - audio.uri=gs://bucket_name/file_name.flac
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 1000000
-    samples:
-      standalone:
-      - region_tag: speech_transcribe_word_level_confidence_beta
-        value_sets:
-        - speech_transcribe_word_level_confidence_beta
-      - region_tag: speech_transcribe_multilanguage_beta
-        value_sets:
-        - speech_transcribe_multilanguage_beta
-      - region_tag: speech_transcribe_recognition_metadata_beta
-        value_sets:
-        - speech_transcribe_recognition_metadata_beta
-      - region_tag: speech_transcribe_auto_punctuation_beta
-        value_sets:
-        - speech_transcribe_auto_punctuation_beta
-      - region_tag: speech_quickstart_beta
-        value_sets:
-        - speech_quickstart_beta
-      - region_tag: speech_adaptation_beta
-        value_sets:
-        - speech_adaptation_beta
-      - region_tag: speech_contexts_classes_beta
-        value_sets:
-        - speech_contexts_classes_beta
-    sample_value_sets:
-    - id: speech_transcribe_word_level_confidence_beta
-      title: Enabling word-level confidence (Local File) (Beta)
-      description: 'Print confidence level for individual words in a transcription
-        of a short audio file
-
-'
-      parameters:
-        defaults:
-        - audio.content = "resources/brooklyn_bridge.flac"
-        - config.enable_word_confidence = True
-        - config.language_code = "en-US"
-        attributes:
-        - parameter: audio.content
-          sample_argument_name: local_file_path
-          read_file: true
-          description: Path to local audio file, e.g. /path/audio.wav
-        - parameter: config.enable_word_confidence
-          description: |
-            When enabled, the first result returned by the API will include a list
-            of words and the confidence level for each of those words.
-        - parameter: config.language_code
-          description: The language of the supplied audio
-      on_success:
-      - comment:
-        - The first result includes confidence levels per word
-      - define: result=$resp.results[0]
-      - comment:
-        - First alternative is the most probable result
-      - define: alternative=result.alternatives[0]
-      - print:
-        - 'Transcript: %s'
-        - alternative.transcript
-      - comment:
-        - Print the confidence level of each word
-      - loop:
-          collection: alternative.words
-          variable: word
-          body:
-          - print:
-            - 'Word: %s'
-            - word.word
-          - print:
-            - 'Confidence: %s'
-            - word.confidence
-    - id: speech_transcribe_multilanguage_beta
-      title: Detecting language spoken automatically (Local File) (Beta)
-      description: 'Transcribe a short audio file with language detected from a list
-        of possible languages
-
-'
-      parameters:
-        defaults:
-        - audio.content = "resources/brooklyn_bridge.flac"
-        - config.language_code = "fr"
-        - config.alternative_language_codes[0] = "es"
-        - config.alternative_language_codes[1] = "en"
-        attributes:
-        - parameter: audio.content
-          sample_argument_name: local_file_path
-          read_file: true
-          description: Path to local audio file, e.g. /path/audio.wav
-        - parameter: config.alternative_language_codes[0]
-          description: 'Specify up to 3 additional languages as possible alternative
-            languages of the supplied audio.
-
-'
-        - parameter: config.language_code
-          description: |
-            The language of the supplied audio. Even though additional languages are
-            provided by alternative_language_codes, a primary language is still required.
-      on_success:
-      - loop:
-          variable: result
-          collection: "$resp.results"
-          body:
-          - comment:
-            - The %s which was detected as the most likely being spoken in the audio
-            - language_code
-          - print:
-            - 'Detected language: %s'
-            - result.language_code
-          - comment:
-            - First alternative is the most probable result
-          - define: alternative=result.alternatives[0]
-          - print:
-            - 'Transcript: %s'
-            - alternative.transcript
-    - id: speech_transcribe_auto_punctuation_beta
-      title: Getting punctuation in results (Local File) (Beta)
-      description: 'Transcribe a short audio file with punctuation
-
-'
-      parameters:
-        defaults:
-        - audio.content = "resources/commercial_mono.wav"
-        - config.enable_automatic_punctuation = True
-        - config.language_code = "en-US"
-        attributes:
-        - parameter: audio.content
-          sample_argument_name: local_file_path
-          read_file: true
-          description: Path to local audio file, e.g. /path/audio.wav
-        - parameter: config.enable_automatic_punctuation
-          description: 'When enabled, trascription results may include punctuation
-            (available for select languages).
-
-'
-        - parameter: config.language_code
-          description: |
-            The language of the supplied audio. Even though additional languages are
-            provided by alternative_language_codes, a primary language is still required.
-      on_success:
-      - loop:
-          variable: result
-          collection: "$resp.results"
-          body:
-          - comment:
-            - First alternative is the most probable result
-          - define: alternative=result.alternatives[0]
-          - print:
-            - 'Transcript: %s'
-            - alternative.transcript
-    - id: speech_transcribe_recognition_metadata_beta
-      title: Adding recognition metadata (Local File) (Beta)
-      description: "Adds additional details short audio file included in this recognition
-        request \n"
-      parameters:
-        defaults:
-        - audio.content = "resources/commercial_mono.wav"
-        - config.metadata.interaction_type = VOICE_SEARCH
-        - config.metadata.recording_device_type = SMARTPHONE
-        - config.metadata.recording_device_name = "Pixel 3"
-        - config.language_code = "en-US"
-        attributes:
-        - parameter: audio.content
-          sample_argument_name: local_file_path
-          read_file: true
-          description: Path to local audio file, e.g. /path/audio.wav
-        - parameter: config.metadata.interaction_type
-          description: 'The use case of the audio, e.g. PHONE_CALL, DISCUSSION, PRESENTATION,
-            et al.
-
-'
-        - parameter: config.metadata.recording_device_type
-          description: The kind of device used to capture the audio
-        - parameter: config.metadata.recording_device_name
-          description: |
-            The device used to make the recording.
-            Arbitrary string, e.g. 'Pixel XL', 'VoIP', 'Cardioid Microphone', or other value.
-        - parameter: config.language_code
-          description: |
-            The language of the supplied audio. Even though additional languages are
-            provided by alternative_language_codes, a primary language is still required.
-      on_success:
-      - loop:
-          variable: result
-          collection: "$resp.results"
-          body:
-          - comment:
-            - First alternative is the most probable result
-          - define: alternative=result.alternatives[0]
-          - print:
-            - 'Transcript: %s'
-            - alternative.transcript
-    - id: speech_quickstart_beta
-      description: "Performs synchronous speech recognition on an audio file."
-      parameters:
-        defaults:
-        - config.encoding=MP3
-        - config.sample_rate_hertz=44100
-        - config.language_code="en-US"
-        - audio.uri="gs://cloud-samples-data/speech/brooklyn_bridge.mp3"
-        attributes:
-        - parameter: config.sample_rate_hertz
-          sample_argument_name: sample_rate_hertz
-          description: "Sample rate in Hertz of the audio data sent in all `RecognitionAudio` messages. Valid values are: 8000-48000."
-        - parameter: config.language_code
-          sample_argument_name: language_code
-          description: The language of the supplied audio.
-        - parameter: audio.uri
-          sample_argument_name: uri_path
-          description: Path to the audio file stored on GCS.
-      on_success:
-      - loop:
-          collection: $resp.results
-          variable: result
-          body:
-          - define: transcript=result.alternatives[0].transcript
-          - print: ["Transcript: %s", transcript]
-    - id: speech_adaptation_beta
-      description: "Performs synchronous speech recognition with speech adaptation."
-      parameters:
-        defaults:
-        - config.encoding=MP3
-        - config.sample_rate_hertz=44100
-        - config.language_code="en-US"
-        - config.speech_contexts[0].phrases[0]="Brooklyn Bridge"
-        - config.speech_contexts[0].boost=20
-        - audio.uri="gs://cloud-samples-data/speech/brooklyn_bridge.mp3"
-        attributes:
-        - parameter: config.sample_rate_hertz
-          sample_argument_name: sample_rate_hertz
-          description: "Sample rate in Hertz of the audio data sent in all `RecognitionAudio` messages. Valid values are: 8000-48000."
-        - parameter: config.language_code
-          sample_argument_name: language_code
-          description: The language of the supplied audio.
-        - parameter: config.speech_contexts[0].phrases[0]
-          sample_argument_name: phrase
-          description: Phrase "hints" help Speech-to-Text API recognize the specified phrases from your audio data.
-        - parameter: config.speech_contexts[0].boost
-          sample_argument_name: boost
-          description: Positive value will increase the probability that a specific phrase will be recognized over other similar sounding phrases.
-        - parameter: audio.uri
-          sample_argument_name: uri_path
-          description: Path to the audio file stored on GCS.
-      on_success:
-      - loop:
-          variable: result
-          collection: "$resp.results"
-          body:
-          - comment:
-            - First alternative is the most probable result
-          - define: alternative=result.alternatives[0]
-          - print:
-            - 'Transcript: %s'
-            - alternative.transcript
-    - id: speech_contexts_classes_beta
-      description: "Performs synchronous speech recognition with static context classes."
-      parameters:
-        defaults:
-        - config.encoding=MP3
-        - config.sample_rate_hertz=24000
-        - config.language_code="en-US"
-        - config.speech_contexts[0].phrases[0]="$TIME"
-        - audio.uri="gs://cloud-samples-data/speech/time.mp3"
-        attributes:
-        - parameter: config.sample_rate_hertz
-          sample_argument_name: sample_rate_hertz
-          description: "Sample rate in Hertz of the audio data sent in all `RecognitionAudio` messages. Valid values are: 8000-48000."
-        - parameter: config.language_code
-          sample_argument_name: language_code
-          description: The language of the supplied audio.
-        - parameter: config.speech_contexts[0].phrases[0]
-          sample_argument_name: phrase
-          description: Phrase "hints" help Speech-to-Text API recognize the specified phrases from your audio data. In this sample we are using a static class phrase ($TIME). Classes represent groups of words that represent common concepts that occur in natural language. We recommend checking out the docs page for more info on static classes.
-        - parameter: audio.uri
-          sample_argument_name: uri_path
-          description: Path to the audio file stored on GCS.
-      on_success:
-      - loop:
-          variable: result
-          collection: "$resp.results"
-          body:
-          - comment:
-            - First alternative is the most probable result
-          - define: alternative=result.alternatives[0]
-          - print:
-            - 'Transcript: %s'
-            - alternative.transcript
   - name: LongRunningRecognize
-    flattening:
-      groups:
-      - parameters:
-        - config
-        - audio
-    required_fields:
-    - config
-    - audio
     sample_code_init_fields:
     - config.encoding=FLAC
     - config.sample_rate_hertz=44100
     - config.language_code="en-US"
     - audio.uri=gs://bucket_name/file_name.flac
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-    long_running:
-      return_type: google.cloud.speech.v1p1beta1.LongRunningRecognizeResponse
-      metadata_type: google.cloud.speech.v1p1beta1.LongRunningRecognizeMetadata
-      initial_poll_delay_millis: 20000
-      poll_delay_multiplier: 1.5
-      max_poll_delay_millis: 45000
-      total_poll_timeout_millis: 86400000
-    samples:
-      standalone:
-      - region_tag: speech_transcribe_diarization_beta
-        value_sets:
-        - speech_transcribe_diarization_beta
-    sample_value_sets:
-    - id: speech_transcribe_diarization_beta
-      title: Separating different speakers (Local File) (LRO) (Beta)
-      description: |
-        Print confidence level for individual words in a transcription of a short audio file
-        Separating different speakers in an audio file recording
-      parameters:
-        defaults:
-        - audio.content = "resources/commercial_mono.wav"
-        - config.enable_speaker_diarization = True
-        - config.diarization_speaker_count = 2
-        - config.language_code = "en-US"
-        attributes:
-        - parameter: audio.content
-          sample_argument_name: local_file_path
-          read_file: true
-          description: Path to local audio file, e.g. /path/audio.wav
-        - parameter: config.enable_speaker_diarization
-          description: |
-            If enabled, each word in the first alternative of each result will be
-            tagged with a speaker tag to identify the speaker.
-        - parameter: config.diarization_speaker_count
-          description: 'Optional. Specifies the estimated number of speakers in the
-            conversation.
-
-'
-        - parameter: config.language_code
-          description: The language of the supplied audio
-      on_success:
-      - loop:
-          collection: "$resp.results"
-          variable: result
-          body:
-          - comment:
-            - First alternative has words tagged with speakers
-          - define: alternative=result.alternatives[0]
-          - print:
-            - 'Transcript: %s'
-            - alternative.transcript
-          - comment:
-            - Print the %s of each word
-            - speaker_tag
-          - loop:
-              collection: alternative.words
-              variable: word
-              body:
-              - print:
-                - 'Word: %s'
-                - word.word
-              - print:
-                - 'Speaker tag: %s'
-                - word.speaker_tag
   - name: StreamingRecognize
     retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 1000000
diff --git a/third_party/googleapis/google/cloud/speech/v1p1beta1/speech_grpc_service_config.json b/third_party/googleapis/google/cloud/speech/v1p1beta1/speech_grpc_service_config.json
new file mode 100755
index 000000000..abc988ca4
--- /dev/null
+++ b/third_party/googleapis/google/cloud/speech/v1p1beta1/speech_grpc_service_config.json
@@ -0,0 +1,35 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.speech.v1p1beta1.Speech",
+          "method": "Recognize"
+        },
+        {
+          "service": "google.cloud.speech.v1p1beta1.Speech",
+          "method": "StreamingRecognize"
+        }
+      ],
+      "timeout": "5000s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.speech.v1p1beta1.Speech",
+          "method": "LongRunningRecognize"
+        }
+      ],
+      "timeout": "5000s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/speech/v1p1beta1/speech_v1p1beta1.yaml b/third_party/googleapis/google/cloud/speech/v1p1beta1/speech_v1p1beta1.yaml
new file mode 100644
index 000000000..9d5e374b7
--- /dev/null
+++ b/third_party/googleapis/google/cloud/speech/v1p1beta1/speech_v1p1beta1.yaml
@@ -0,0 +1,47 @@
+type: google.api.Service
+config_version: 3
+name: speech.googleapis.com
+title: Cloud Speech-to-Text API
+
+apis:
+- name: google.cloud.speech.v1p1beta1.Speech
+
+types:
+- name: google.cloud.speech.v1p1beta1.LongRunningRecognizeMetadata
+- name: google.cloud.speech.v1p1beta1.LongRunningRecognizeResponse
+
+documentation:
+  summary: Converts audio to text by applying powerful neural network models.
+  overview: |-
+    # Introduction
+
+    Google Cloud Speech API provides speech recognition as a service.
+
+backend:
+  rules:
+  - selector: 'google.cloud.speech.v1p1beta1.Speech.*'
+    deadline: 355.0
+  - selector: 'google.longrunning.Operations.*'
+    deadline: 355.0
+
+http:
+  rules:
+  - selector: google.longrunning.Operations.GetOperation
+    get: '/v1p1beta1/operations/{name=**}'
+    additional_bindings:
+    - get: '/v1p1beta1/{name=projects/*/locations/*/operations/*}'
+  - selector: google.longrunning.Operations.ListOperations
+    get: '/v1p1beta1/operations'
+    additional_bindings:
+    - get: '/v1p1beta1/{name=projects/*/locations/*}/operations'
+
+authentication:
+  rules:
+  - selector: 'google.cloud.speech.v1p1beta1.Speech.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/talent/BUILD.bazel b/third_party/googleapis/google/cloud/talent/BUILD.bazel
new file mode 100644
index 000000000..a87c57fec
--- /dev/null
+++ b/third_party/googleapis/google/cloud/talent/BUILD.bazel
@@ -0,0 +1 @@
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/cloud/talent/talent_v4beta1.yaml b/third_party/googleapis/google/cloud/talent/talent_v4beta1.yaml
index 01a300b79..d418c1ac9 100644
--- a/third_party/googleapis/google/cloud/talent/talent_v4beta1.yaml
+++ b/third_party/googleapis/google/cloud/talent/talent_v4beta1.yaml
@@ -51,6 +51,11 @@ backend:
   - selector: 'google.longrunning.Operations.*'
     deadline: 30.0
 
+http:
+  rules:
+  - selector: google.longrunning.Operations.GetOperation
+    get: '/v4beta1/{name=projects/*/operations/*}'
+
 authentication:
   rules:
   - selector: 'google.cloud.talent.v4beta1.ApplicationService.*'
diff --git a/third_party/googleapis/google/cloud/talent/v4beta1/BUILD.bazel b/third_party/googleapis/google/cloud/talent/v4beta1/BUILD.bazel
new file mode 100644
index 000000000..9cf7d3dc8
--- /dev/null
+++ b/third_party/googleapis/google/cloud/talent/v4beta1/BUILD.bazel
@@ -0,0 +1,417 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "talent_proto",
+    srcs = [
+        "application.proto",
+        "application_service.proto",
+        "batch.proto",
+        "common.proto",
+        "company.proto",
+        "company_service.proto",
+        "completion_service.proto",
+        "event.proto",
+        "event_service.proto",
+        "filters.proto",
+        "histogram.proto",
+        "job.proto",
+        "job_service.proto",
+        "profile.proto",
+        "profile_service.proto",
+        "tenant.proto",
+        "tenant_service.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/longrunning:operations_proto",
+        "//google/rpc:status_proto",
+        "//google/type:date_proto",
+        "//google/type:latlng_proto",
+        "//google/type:money_proto",
+        "//google/type:postal_address_proto",
+        "//google/type:timeofday_proto",
+        "@com_google_protobuf//:any_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+        "@com_google_protobuf//:wrappers_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "talent_proto_with_info",
+    deps = [
+        ":talent_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "talent_java_proto",
+    deps = [":talent_proto"],
+)
+
+java_grpc_library(
+    name = "talent_java_grpc",
+    srcs = [":talent_proto"],
+    deps = [":talent_java_proto"],
+)
+
+java_gapic_library(
+    name = "talent_java_gapic",
+    src = ":talent_proto_with_info",
+    gapic_yaml = "talent_gapic.yaml",
+    package = "google.cloud.talent.v4beta1",
+    service_yaml = "//google/cloud/talent:talent_v4beta1.yaml",
+    test_deps = [
+        ":talent_java_grpc",
+    ],
+    deps = [
+        ":talent_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "talent_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.talent.v4beta1.ApplicationServiceClientTest",
+        "com.google.cloud.talent.v4beta1.CompanyServiceClientTest",
+        "com.google.cloud.talent.v4beta1.CompletionClientTest",
+        "com.google.cloud.talent.v4beta1.EventServiceClientTest",
+        "com.google.cloud.talent.v4beta1.JobServiceClientTest",
+        "com.google.cloud.talent.v4beta1.ProfileServiceClientTest",
+        "com.google.cloud.talent.v4beta1.TenantServiceClientTest",
+    ],
+    runtime_deps = [":talent_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-talent-v4beta1-java",
+    deps = [
+        ":talent_java_gapic",
+        ":talent_java_grpc",
+        ":talent_java_proto",
+        ":talent_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "talent_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1",
+    protos = [":talent_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/longrunning:longrunning_go_proto",
+        "//google/rpc:status_go_proto",
+        "//google/type:date_go_proto",
+        "//google/type:latlng_go_proto",
+        "//google/type:money_go_proto",
+        "//google/type:postaladdress_go_proto",
+        "//google/type:timeofday_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "talent_go_gapic",
+    srcs = [":talent_proto_with_info"],
+    grpc_service_config = "talent_grpc_service_config.json",
+    importpath = "cloud.google.com/go/talent/apiv4beta1;talent",
+    service_yaml = "//google/cloud/talent:talent_v4beta1.yaml",
+    deps = [
+        ":talent_go_proto",
+        "//google/longrunning:longrunning_go_gapic",
+        "//google/longrunning:longrunning_go_proto",
+        "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
+        "@io_bazel_rules_go//proto/wkt:any_go_proto",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
+    ],
+)
+
+go_test(
+    name = "talent_go_gapic_test",
+    srcs = [":talent_go_gapic_srcjar_test"],
+    embed = [":talent_go_gapic"],
+    importpath = "cloud.google.com/go/talent/apiv4beta1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-talent-v4beta1-go",
+    deps = [
+        ":talent_go_gapic",
+        ":talent_go_gapic_srcjar-test.srcjar",
+        ":talent_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "talent_moved_proto",
+    srcs = [":talent_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/longrunning:operations_proto",
+        "//google/rpc:status_proto",
+        "//google/type:date_proto",
+        "//google/type:latlng_proto",
+        "//google/type:money_proto",
+        "//google/type:postal_address_proto",
+        "//google/type:timeofday_proto",
+        "@com_google_protobuf//:any_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+        "@com_google_protobuf//:wrappers_proto",
+    ],
+)
+
+py_proto_library(
+    name = "talent_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":talent_moved_proto"],
+)
+
+py_grpc_library(
+    name = "talent_py_grpc",
+    srcs = [":talent_moved_proto"],
+    deps = [":talent_py_proto"],
+)
+
+py_gapic_library(
+    name = "talent_py_gapic",
+    src = ":talent_proto_with_info",
+    gapic_yaml = "talent_gapic.yaml",
+    package = "google.cloud.talent.v4beta1",
+    service_yaml = "//google/cloud/talent:talent_v4beta1.yaml",
+    deps = [
+        ":talent_py_grpc",
+        ":talent_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "talent-v4beta1-py",
+    deps = [
+        ":talent_py_gapic",
+        ":talent_py_grpc",
+        ":talent_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "talent_php_proto",
+    deps = [":talent_proto"],
+)
+
+php_grpc_library(
+    name = "talent_php_grpc",
+    srcs = [":talent_proto"],
+    deps = [":talent_php_proto"],
+)
+
+php_gapic_library(
+    name = "talent_php_gapic",
+    src = ":talent_proto_with_info",
+    gapic_yaml = "talent_gapic.yaml",
+    package = "google.cloud.talent.v4beta1",
+    service_yaml = "//google/cloud/talent:talent_v4beta1.yaml",
+    deps = [
+        ":talent_php_grpc",
+        ":talent_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-talent-v4beta1-php",
+    deps = [
+        ":talent_php_gapic",
+        ":talent_php_grpc",
+        ":talent_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "talent_nodejs_gapic",
+    src = ":talent_proto_with_info",
+    gapic_yaml = "talent_gapic.yaml",
+    package = "google.cloud.talent.v4beta1",
+    service_yaml = "//google/cloud/talent:talent_v4beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "talent-v4beta1-nodejs",
+    deps = [
+        ":talent_nodejs_gapic",
+        ":talent_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "talent_ruby_proto",
+    deps = [":talent_proto"],
+)
+
+ruby_grpc_library(
+    name = "talent_ruby_grpc",
+    srcs = [":talent_proto"],
+    deps = [":talent_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "talent_ruby_gapic",
+    src = ":talent_proto_with_info",
+    gapic_yaml = "talent_gapic.yaml",
+    package = "google.cloud.talent.v4beta1",
+    service_yaml = "//google/cloud/talent:talent_v4beta1.yaml",
+    deps = [
+        ":talent_ruby_grpc",
+        ":talent_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-talent-v4beta1-ruby",
+    deps = [
+        ":talent_ruby_gapic",
+        ":talent_ruby_grpc",
+        ":talent_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "talent_csharp_proto",
+    deps = [":talent_proto"],
+)
+
+csharp_grpc_library(
+    name = "talent_csharp_grpc",
+    srcs = [":talent_proto"],
+    deps = [":talent_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "talent_csharp_gapic",
+    src = ":talent_proto_with_info",
+    gapic_yaml = "talent_gapic.yaml",
+    package = "google.cloud.talent.v4beta1",
+    service_yaml = "//google/cloud/talent:talent_v4beta1.yaml",
+    deps = [
+        ":talent_csharp_grpc",
+        ":talent_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-talent-v4beta1-csharp",
+    deps = [
+        ":talent_csharp_gapic",
+        ":talent_csharp_grpc",
+        ":talent_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/talent/v4beta1/application.proto b/third_party/googleapis/google/cloud/talent/v4beta1/application.proto
index 30ce2fed8..ccb492089 100644
--- a/third_party/googleapis/google/cloud/talent/v4beta1/application.proto
+++ b/third_party/googleapis/google/cloud/talent/v4beta1/application.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,14 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.talent.v4beta1;
 
 import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/talent/v4beta1/common.proto";
 import "google/protobuf/timestamp.proto";
 import "google/protobuf/wrappers.proto";
@@ -31,6 +32,11 @@ option objc_class_prefix = "CTS";
 
 // Resource that represents a job application record of a candidate.
 message Application {
+  option (google.api.resource) = {
+    type: "jobs.googleapis.com/Application"
+    pattern: "projects/{project}/tenants/{tenant}/profiles/{profile}/applications/{application}"
+  };
+
   // Enum that represents the application status.
   enum ApplicationState {
     // Default value.
@@ -92,85 +98,86 @@ message Application {
   // Resource name assigned to an application by the API.
   //
   // The format is
-  // "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}/applications/{application_id}",
-  // for example,
-  // "projects/api-test-project/tenants/foo/profiles/bar/applications/baz".
+  // "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}/applications/{application_id}".
+  // For example, "projects/foo/tenants/bar/profiles/baz/applications/qux".
   string name = 1;
 
   // Required. Client side application identifier, used to uniquely identify the
   // application.
   //
   // The maximum number of allowed characters is 255.
-  string external_id = 31;
+  string external_id = 31 [(google.api.field_behavior) = REQUIRED];
 
   // Output only. Resource name of the candidate of this application.
   //
   // The format is
-  // "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}",
-  // for example, "projects/api-test-project/tenants/foo/profiles/bar".
-  string profile = 2;
+  // "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}".
+  // For example, "projects/foo/tenants/bar/profiles/baz".
+  string profile = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // One of either a job or a company is required.
-  //
-  // Resource name of the job which the candidate applied for.
+  // Required. Resource name of the job which the candidate applied for.
   //
   // The format is
-  // "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}",
-  // for example, "projects/api-test-project/tenants/foo/jobs/bar".
-  string job = 4;
+  // "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". For example,
+  // "projects/foo/tenants/bar/jobs/baz".
+  string job = 4 [
+    (google.api.resource_reference).type = "jobs.googleapis.com/Job",
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // One of either a job or a company is required.
-  //
   // Resource name of the company which the candidate applied for.
   //
   // The format is
-  // "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}",
-  // for example, "projects/api-test-project/tenants/foo/companies/bar".
-  string company = 5;
+  // "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}".
+  // For example, "projects/foo/tenants/bar/companies/baz".
+  string company = 5 [
+    (google.api.resource_reference) = { type: "jobs.googleapis.com/Company" }
+  ];
 
-  // Optional. The application date.
+  // The application date.
   google.type.Date application_date = 7;
 
   // Required. What is the most recent stage of the application (that is, new,
   // screen, send cv, hired, finished work)?  This field is intentionally not
   // comprehensive of every possible status, but instead, represents statuses
   // that would be used to indicate to the ML models good / bad matches.
-  ApplicationStage stage = 11;
+  ApplicationStage stage = 11 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional. The application state.
+  // The application state.
   ApplicationState state = 13;
 
-  // Optional. All interviews (screen, onsite, and so on) conducted as part of
-  // this application (includes details such as user conducting the interview,
+  // All interviews (screen, onsite, and so on) conducted as part of this
+  // application (includes details such as user conducting the interview,
   // timestamp, feedback, and so on).
   repeated Interview interviews = 16;
 
-  // Optional. If the candidate is referred by a employee.
+  // If the candidate is referred by a employee.
   google.protobuf.BoolValue referral = 18;
 
   // Required. Reflects the time that the application was created.
-  google.protobuf.Timestamp create_time = 19;
+  google.protobuf.Timestamp create_time = 19
+      [(google.api.field_behavior) = REQUIRED];
 
-  // Optional. The last update timestamp.
+  // The last update timestamp.
   google.protobuf.Timestamp update_time = 20;
 
-  // Optional. Free text reason behind the recruitement outcome (for example,
-  // reason for withdraw / reject, reason for an unsuccessful finish, and so
-  // on).
+  // Free text reason behind the recruitement outcome (for example, reason for
+  // withdraw / reject, reason for an unsuccessful finish, and so on).
   //
   // Number of characters allowed is 100.
   string outcome_notes = 21;
 
-  // Optional. Outcome positiveness shows how positive the outcome is.
+  // Outcome positiveness shows how positive the outcome is.
   Outcome outcome = 22;
 
   // Output only. Indicates whether this job application is a match to
   // application related filters. This value is only applicable in profile
   // search response.
-  google.protobuf.BoolValue is_match = 28;
+  google.protobuf.BoolValue is_match = 28
+      [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Job title snippet shows how the job title is related to a
   // search query. It's empty if the job title isn't related to the search
   // query.
-  string job_title_snippet = 29;
+  string job_title_snippet = 29 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
diff --git a/third_party/googleapis/google/cloud/talent/v4beta1/application_service.proto b/third_party/googleapis/google/cloud/talent/v4beta1/application_service.proto
index 48e4f9500..c9f990dab 100644
--- a/third_party/googleapis/google/cloud/talent/v4beta1/application_service.proto
+++ b/third_party/googleapis/google/cloud/talent/v4beta1/application_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -19,6 +18,8 @@ package google.cloud.talent.v4beta1;
 
 import "google/api/annotations.proto";
 import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/talent/v4beta1/application.proto";
 import "google/cloud/talent/v4beta1/common.proto";
 import "google/protobuf/empty.proto";
@@ -44,6 +45,7 @@ service ApplicationService {
       post: "/v4beta1/{parent=projects/*/tenants/*/profiles/*}/applications"
       body: "*"
     };
+    option (google.api.method_signature) = "parent,application";
   }
 
   // Retrieves specified application.
@@ -51,6 +53,7 @@ service ApplicationService {
     option (google.api.http) = {
       get: "/v4beta1/{name=projects/*/tenants/*/profiles/*/applications/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Updates specified application.
@@ -59,37 +62,42 @@ service ApplicationService {
       patch: "/v4beta1/{application.name=projects/*/tenants/*/profiles/*/applications/*}"
       body: "*"
     };
+    option (google.api.method_signature) = "application";
   }
 
   // Deletes specified application.
-  rpc DeleteApplication(DeleteApplicationRequest)
-      returns (google.protobuf.Empty) {
+  rpc DeleteApplication(DeleteApplicationRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v4beta1/{name=projects/*/tenants/*/profiles/*/applications/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists all applications associated with the profile.
-  rpc ListApplications(ListApplicationsRequest)
-      returns (ListApplicationsResponse) {
+  rpc ListApplications(ListApplicationsRequest) returns (ListApplicationsResponse) {
     option (google.api.http) = {
       get: "/v4beta1/{parent=projects/*/tenants/*/profiles/*}/applications"
     };
+    option (google.api.method_signature) = "parent";
   }
 }
 
 // The Request of the CreateApplication method.
 message CreateApplicationRequest {
-  // Required. Resource name of the profile under which the application is
-  // created.
+  // Required. Resource name of the profile under which the application is created.
   //
   // The format is
-  // "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}", for
-  // example, "projects/test-project/tenants/test-tenant/profiles/test-profile".
-  string parent = 1;
+  // "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}".
+  // For example, "projects/foo/tenants/bar/profiles/baz".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "jobs.googleapis.com/Profile"
+    }
+  ];
 
   // Required. The application to be created.
-  Application application = 2;
+  Application application = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for getting a application by name.
@@ -97,30 +105,28 @@ message GetApplicationRequest {
   // Required. The resource name of the application to be retrieved.
   //
   // The format is
-  // "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}/applications/{application_id}",
-  // for example,
-  // "projects/test-project/tenants/test-tenant/profiles/test-profile/applications/test-application".
-  string name = 1;
+  // "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}/applications/{application_id}".
+  // For example, "projects/foo/tenants/bar/profiles/baz/applications/qux".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "jobs.googleapis.com/Application"
+    }
+  ];
 }
 
 // Request for updating a specified application.
 message UpdateApplicationRequest {
-  // Required. The application resource to replace the current resource in the
-  // system.
-  Application application = 1;
+  // Required. The application resource to replace the current resource in the system.
+  Application application = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional but strongly recommended for the best service
-  // experience.
+  // Strongly recommended for the best service experience.
   //
-  // If
-  // [update_mask][google.cloud.talent.v4beta1.UpdateApplicationRequest.update_mask]
-  // is provided, only the specified fields in
-  // [application][google.cloud.talent.v4beta1.UpdateApplicationRequest.application]
-  // are updated. Otherwise all the fields are updated.
+  // If [update_mask][google.cloud.talent.v4beta1.UpdateApplicationRequest.update_mask] is provided, only the specified fields in
+  // [application][google.cloud.talent.v4beta1.UpdateApplicationRequest.application] are updated. Otherwise all the fields are updated.
   //
   // A field mask to specify the application fields to be updated. Only
-  // top level fields of [Application][google.cloud.talent.v4beta1.Application]
-  // are supported.
+  // top level fields of [Application][google.cloud.talent.v4beta1.Application] are supported.
   google.protobuf.FieldMask update_mask = 2;
 }
 
@@ -129,32 +135,38 @@ message DeleteApplicationRequest {
   // Required. The resource name of the application to be deleted.
   //
   // The format is
-  // "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}/applications/{application_id}",
-  // for example,
-  // "projects/test-project/tenants/test-tenant/profiles/test-profile/applications/test-application".
-  string name = 1;
+  // "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}/applications/{application_id}".
+  // For example, "projects/foo/tenants/bar/profiles/baz/applications/qux".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "jobs.googleapis.com/Application"
+    }
+  ];
 }
 
 // List applications for which the client has ACL visibility.
 message ListApplicationsRequest {
-  // Required. Resource name of the profile under which the application is
-  // created.
+  // Required. Resource name of the profile under which the application is created.
   //
   // The format is
   // "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}", for
-  // example, "projects/test-project/tenants/test-tenant/profiles/test-profile".
-  string parent = 1;
-
-  // Optional. The starting indicator from which to return results.
+  // example, "projects/foo/tenants/bar/profiles/baz".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "jobs.googleapis.com/Profile"
+    }
+  ];
+
+  // The starting indicator from which to return results.
   string page_token = 2;
 
-  // Optional. The maximum number of applications to be returned, at most 100.
+  // The maximum number of applications to be returned, at most 100.
   // Default is 100 if a non-positive number is provided.
   int32 page_size = 3;
 }
 
-// Output only.
-//
 // The List applications response object.
 message ListApplicationsResponse {
   // Applications for the current client.
diff --git a/third_party/googleapis/google/cloud/talent/v4beta1/batch.proto b/third_party/googleapis/google/cloud/talent/v4beta1/batch.proto
index 5eeeff57c..074e87050 100644
--- a/third_party/googleapis/google/cloud/talent/v4beta1/batch.proto
+++ b/third_party/googleapis/google/cloud/talent/v4beta1/batch.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,111 +11,15 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.talent.v4beta1;
 
 import "google/api/annotations.proto";
-import "google/cloud/talent/v4beta1/job.proto";
-import "google/protobuf/timestamp.proto";
-import "google/rpc/status.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
 option java_multiple_files = true;
 option java_outer_classname = "BatchProto";
 option java_package = "com.google.cloud.talent.v4beta1";
 option objc_class_prefix = "CTS";
-
-// Output only.
-//
-// Metadata used for long running operations returned by CTS batch APIs.
-// It's used to replace
-// [google.longrunning.Operation.metadata][google.longrunning.Operation.metadata].
-message BatchOperationMetadata {
-  enum State {
-    // Default value.
-    STATE_UNSPECIFIED = 0;
-
-    // The batch operation is being prepared for processing.
-    INITIALIZING = 1;
-
-    // The batch operation is actively being processed.
-    PROCESSING = 2;
-
-    // The batch operation is processed, and at least one item has been
-    // successfully processed.
-    SUCCEEDED = 3;
-
-    // The batch operation is done and no item has been successfully processed.
-    FAILED = 4;
-
-    // The batch operation is in the process of cancelling after
-    // [google.longrunning.Operation.CancelOperation] is called.
-    CANCELLING = 5;
-
-    // The batch operation is done after
-    // [google.longrunning.Operation.CancelOperation] is called. Any items
-    // processed before cancelling are returned in the response.
-    CANCELLED = 6;
-  }
-
-  // The state of a long running operation.
-  State state = 1;
-
-  // More detailed information about operation state.
-  string state_description = 2;
-
-  // Count of successful item(s) inside an operation.
-  int32 success_count = 3;
-
-  // Count of failed item(s) inside an operation.
-  int32 failure_count = 4;
-
-  // Count of total item(s) inside an operation.
-  int32 total_count = 5;
-
-  // The time when the batch operation is created.
-  google.protobuf.Timestamp create_time = 6;
-
-  // The time when the batch operation status is updated. The metadata and the
-  // [update_time][google.cloud.talent.v4beta1.BatchOperationMetadata.update_time]
-  // is refreshed every minute otherwise cached data is returned.
-  google.protobuf.Timestamp update_time = 7;
-
-  // The time when the batch operation is finished and
-  // [google.longrunning.Operation.done][google.longrunning.Operation.done] is
-  // set to `true`.
-  google.protobuf.Timestamp end_time = 8;
-}
-
-// Output only.
-//
-// The result of [BatchCreateJobs][] or [BatchUpdateJobs][] APIs. It's used to
-// replace
-// [google.longrunning.Operation.response][google.longrunning.Operation.response]
-// in case of success.
-message JobOperationResult {
-  // Mutation result of a job.
-  message JobResult {
-    // Here [Job][google.cloud.talent.v4beta1.Job] only contains basic
-    // information including [name][google.cloud.talent.v4beta1.Job.name],
-    // [company][google.cloud.talent.v4beta1.Job.company],
-    // [language_code][google.cloud.talent.v4beta1.Job.language_code] and
-    // [requisition_id][google.cloud.talent.v4beta1.Job.requisition_id], use
-    // getJob method to retrieve detailed information of the created/updated
-    // job.
-    Job job = 1;
-
-    // The status of the job processed. This field is populated if the
-    // processing of the
-    // [job][google.cloud.talent.v4beta1.JobOperationResult.JobResult.job]
-    // fails.
-    google.rpc.Status status = 2;
-  }
-
-  // List of job mutation results from a batch mutate operation. It can change
-  // until operation status is FINISHED, FAILED or CANCELLED.
-  repeated JobResult job_results = 1;
-}
diff --git a/third_party/googleapis/google/cloud/talent/v4beta1/common.proto b/third_party/googleapis/google/cloud/talent/v4beta1/common.proto
index 1513d795c..13f774217 100644
--- a/third_party/googleapis/google/cloud/talent/v4beta1/common.proto
+++ b/third_party/googleapis/google/cloud/talent/v4beta1/common.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,12 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.talent.v4beta1;
 
-import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
 import "google/protobuf/timestamp.proto";
 import "google/protobuf/wrappers.proto";
 import "google/type/date.proto";
@@ -25,6 +24,7 @@ import "google/type/latlng.proto";
 import "google/type/money.proto";
 import "google/type/postal_address.proto";
 import "google/type/timeofday.proto";
+import "google/api/annotations.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
 option java_multiple_files = true;
@@ -41,8 +41,7 @@ message TimestampRange {
   google.protobuf.Timestamp end_time = 2;
 }
 
-// Output only. A resource that represents a location with full geographic
-// information.
+// A resource that represents a location with full geographic information.
 message Location {
   // An enum which represents the type of a location.
   enum LocationType {
@@ -85,11 +84,9 @@ message Location {
   }
 
   // The type of a location, which corresponds to the address lines field of
-  // [google.type.PostalAddress][google.type.PostalAddress]. For example,
-  // "Downtown, Atlanta, GA, USA" has a type of
-  // [LocationType.NEIGHBORHOOD][google.cloud.talent.v4beta1.Location.LocationType.NEIGHBORHOOD],
-  // and "Kansas City, KS, USA" has a type of
-  // [LocationType.LOCALITY][google.cloud.talent.v4beta1.Location.LocationType.LOCALITY].
+  // [google.type.PostalAddress][google.type.PostalAddress]. For example, "Downtown, Atlanta, GA, USA"
+  // has a type of [LocationType.NEIGHBORHOOD][google.cloud.talent.v4beta1.Location.LocationType.NEIGHBORHOOD], and "Kansas City, KS, USA"
+  // has a type of [LocationType.LOCALITY][google.cloud.talent.v4beta1.Location.LocationType.LOCALITY].
   LocationType location_type = 1;
 
   // Postal address of the location that includes human readable information,
@@ -103,9 +100,10 @@ message Location {
 
   // Radius in miles of the job location. This value is derived from the
   // location bounding box in which a circle with the specified radius
-  // centered from [google.type.LatLng][google.type.LatLng] covers the area
-  // associated with the job location. For example, currently, "Mountain View,
-  // CA, USA" has a radius of 6.17 miles.
+  // centered from [google.type.LatLng][google.type.LatLng] covers the area associated with the
+  // job location.
+  // For example, currently, "Mountain View, CA, USA" has a radius of
+  // 6.17 miles.
   double radius_miles = 4;
 }
 
@@ -256,8 +254,7 @@ enum EmploymentType {
   // The job is offered as a contracted position with the understanding
   // that it's converted into a full-time position at the end of the
   // contract. Jobs of this type are also returned by a search for
-  // [EmploymentType.CONTRACTOR][google.cloud.talent.v4beta1.EmploymentType.CONTRACTOR]
-  // jobs.
+  // [EmploymentType.CONTRACTOR][google.cloud.talent.v4beta1.EmploymentType.CONTRACTOR] jobs.
   CONTRACT_TO_HIRE = 4;
 
   // The job is offered as a temporary employment opportunity, usually
@@ -417,11 +414,10 @@ enum PostingRegion {
   POSTING_REGION_UNSPECIFIED = 0;
 
   // In addition to exact location matching, job posting is returned when the
-  // [LocationFilter][google.cloud.talent.v4beta1.LocationFilter] in the search
-  // query is in the same administrative area as the returned job posting. For
-  // example, if a `ADMINISTRATIVE_AREA` job is posted in "CA, USA", it's
-  // returned if [LocationFilter][google.cloud.talent.v4beta1.LocationFilter]
-  // has "Mountain View".
+  // [LocationFilter][google.cloud.talent.v4beta1.LocationFilter] in the search query is in the same administrative area
+  // as the returned job posting. For example, if a `ADMINISTRATIVE_AREA` job
+  // is posted in "CA, USA", it's returned if [LocationFilter][google.cloud.talent.v4beta1.LocationFilter] has
+  // "Mountain View".
   //
   // Administrative area refers to top-level administrative subdivision of this
   // country. For example, US state, IT region, UK constituent nation and
@@ -429,11 +425,9 @@ enum PostingRegion {
   ADMINISTRATIVE_AREA = 1;
 
   // In addition to exact location matching, job is returned when
-  // [LocationFilter][google.cloud.talent.v4beta1.LocationFilter] in search
-  // query is in the same country as this job. For example, if a `NATION_WIDE`
-  // job is posted in "USA", it's returned if
-  // [LocationFilter][google.cloud.talent.v4beta1.LocationFilter] has 'Mountain
-  // View'.
+  // [LocationFilter][google.cloud.talent.v4beta1.LocationFilter] in search query is in the same country as this job.
+  // For example, if a `NATION_WIDE` job is posted in "USA", it's
+  // returned if [LocationFilter][google.cloud.talent.v4beta1.LocationFilter] has 'Mountain View'.
   NATION = 2;
 
   // Job allows employees to work remotely (telecommute).
@@ -442,8 +436,12 @@ enum PostingRegion {
   TELECOMMUTE = 3;
 }
 
+// Deprecated. All resources are only visible to the owner.
+//
 // An enum that represents who has view access to the resource.
 enum Visibility {
+  option deprecated = true;
+
   // Default value.
   VISIBILITY_UNSPECIFIED = 0;
 
@@ -474,8 +472,6 @@ enum ContactInfoUsage {
   SCHOOL = 3;
 }
 
-// Input only.
-//
 // Option for HTML content sanitization on user input fields, for example, job
 // description. By setting this option, user can determine whether and how
 // sanitization is performed on these fields.
@@ -510,15 +506,11 @@ enum CommuteMethod {
   CYCLING = 4;
 }
 
-// Input only.
-//
 // Meta information related to the job searcher or entity
 // conducting the job search. This information is used to improve the
 // performance of the service.
 message RequestMetadata {
-  // Required if
-  // [allow_missing_ids][google.cloud.talent.v4beta1.RequestMetadata.allow_missing_ids]
-  // is unset or `false`.
+  // Required if [allow_missing_ids][google.cloud.talent.v4beta1.RequestMetadata.allow_missing_ids] is unset or `false`.
   //
   // The client-defined scope or source of the service call, which typically
   // is the domain on
@@ -535,9 +527,7 @@ message RequestMetadata {
   // The maximum number of allowed characters is 255.
   string domain = 1;
 
-  // Required if
-  // [allow_missing_ids][google.cloud.talent.v4beta1.RequestMetadata.allow_missing_ids]
-  // is unset or `false`.
+  // Required if [allow_missing_ids][google.cloud.talent.v4beta1.RequestMetadata.allow_missing_ids] is unset or `false`.
   //
   // A unique session identification string. A session is defined as the
   // duration of an end user's interaction with the service over a certain
@@ -551,9 +541,7 @@ message RequestMetadata {
   // The maximum number of allowed characters is 255.
   string session_id = 2;
 
-  // Required if
-  // [allow_missing_ids][google.cloud.talent.v4beta1.RequestMetadata.allow_missing_ids]
-  // is unset or `false`.
+  // Required if [allow_missing_ids][google.cloud.talent.v4beta1.RequestMetadata.allow_missing_ids] is unset or `false`.
   //
   // A unique user identification string, as determined by the client.
   // To have the strongest positive impact on search quality
@@ -567,25 +555,18 @@ message RequestMetadata {
   // The maximum number of allowed characters is 255.
   string user_id = 3;
 
-  // Optional. If set to `true`,
-  // [domain][google.cloud.talent.v4beta1.RequestMetadata.domain],
-  // [session_id][google.cloud.talent.v4beta1.RequestMetadata.session_id] and
-  // [user_id][google.cloud.talent.v4beta1.RequestMetadata.user_id] are
-  // optional. Only set when any of these fields isn't available for some
-  // reason. It is highly recommended not to set this field and provide accurate
-  // [domain][google.cloud.talent.v4beta1.RequestMetadata.domain],
-  // [session_id][google.cloud.talent.v4beta1.RequestMetadata.session_id] and
-  // [user_id][google.cloud.talent.v4beta1.RequestMetadata.user_id] for the best
-  // service experience.
+  // Only set when any of [domain][google.cloud.talent.v4beta1.RequestMetadata.domain], [session_id][google.cloud.talent.v4beta1.RequestMetadata.session_id] and [user_id][google.cloud.talent.v4beta1.RequestMetadata.user_id] isn't
+  // available for some reason. It is highly recommended not to set this field
+  // and provide accurate [domain][google.cloud.talent.v4beta1.RequestMetadata.domain], [session_id][google.cloud.talent.v4beta1.RequestMetadata.session_id] and [user_id][google.cloud.talent.v4beta1.RequestMetadata.user_id] for the
+  // best service experience.
   bool allow_missing_ids = 4;
 
-  // Optional. The type of device used by the job seeker at the time of the call
-  // to the service.
+  // The type of device used by the job seeker at the time of the call to the
+  // service.
   DeviceInfo device_info = 5;
 }
 
-// Output only. Additional information returned to client, such as debugging
-// information.
+// Additional information returned to client, such as debugging information.
 message ResponseMetadata {
   // A unique id associated with this call.
   // This id is logged for tracking purposes.
@@ -623,52 +604,44 @@ message DeviceInfo {
     OTHER = 6;
   }
 
-  // Optional. Type of the device.
+  // Type of the device.
   DeviceType device_type = 1;
 
-  // Optional. A device-specific ID. The ID must be a unique identifier that
+  // A device-specific ID. The ID must be a unique identifier that
   // distinguishes the device from other devices.
   string id = 2;
 }
 
 // Custom attribute values that are either filterable or non-filterable.
 message CustomAttribute {
-  // Optional but exactly one of
-  // [string_values][google.cloud.talent.v4beta1.CustomAttribute.string_values]
-  // or [long_values][google.cloud.talent.v4beta1.CustomAttribute.long_values]
-  // must be specified.
+  // Exactly one of [string_values][google.cloud.talent.v4beta1.CustomAttribute.string_values] or [long_values][google.cloud.talent.v4beta1.CustomAttribute.long_values] must be specified.
   //
   // This field is used to perform a string match (`CASE_SENSITIVE_MATCH` or
   // `CASE_INSENSITIVE_MATCH`) search.
   // For filterable `string_value`s, a maximum total number of 200 values
   // is allowed, with each `string_value` has a byte size of no more than
-  // 255B. For unfilterable `string_values`, the maximum total byte size of
+  // 500B. For unfilterable `string_values`, the maximum total byte size of
   // unfilterable `string_values` is 50KB.
   //
   // Empty string isn't allowed.
   repeated string string_values = 1;
 
-  // Optional but exactly one of
-  // [string_values][google.cloud.talent.v4beta1.CustomAttribute.string_values]
-  // or [long_values][google.cloud.talent.v4beta1.CustomAttribute.long_values]
-  // must be specified.
+  // Exactly one of [string_values][google.cloud.talent.v4beta1.CustomAttribute.string_values] or [long_values][google.cloud.talent.v4beta1.CustomAttribute.long_values] must be specified.
   //
   // This field is used to perform number range search.
   // (`EQ`, `GT`, `GE`, `LE`, `LT`) over filterable `long_value`.
   //
-  // Currently at most 1
-  // [long_values][google.cloud.talent.v4beta1.CustomAttribute.long_values] is
-  // supported.
+  // Currently at most 1 [long_values][google.cloud.talent.v4beta1.CustomAttribute.long_values] is supported.
   repeated int64 long_values = 2;
 
-  // Optional. If the `filterable` flag is true, custom field values are
-  // searchable. If false, values are not searchable.
+  // If the `filterable` flag is true, custom field values are searchable.
+  // If false, values are not searchable.
   //
   // Default is false.
   bool filterable = 3;
 }
 
-// Output only. Spell check result.
+// Spell check result.
 message SpellingCorrection {
   // Indicates if the query was corrected by the spell checker.
   bool corrected = 1;
@@ -692,52 +665,38 @@ message CompensationInfo {
   // as base pay, bonus, or other compensation type.
   //
   // Annualization: One compensation entry can be annualized if
-  // - it contains valid
-  // [amount][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.amount]
-  // or
-  // [range][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.range].
-  // - and its
-  // [expected_units_per_year][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.expected_units_per_year]
-  // is set or can be derived. Its annualized range is determined as
-  // ([amount][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.amount]
-  // or
-  // [range][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.range])
-  // times
+  // - it contains valid [amount][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.amount] or [range][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.range].
+  // - and its [expected_units_per_year][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.expected_units_per_year] is set or can be derived.
+  // Its annualized range is determined as ([amount][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.amount] or [range][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.range]) times
   // [expected_units_per_year][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.expected_units_per_year].
   message CompensationEntry {
-    // Optional. Compensation type.
+    // Compensation type.
     //
-    // Default is
-    // [CompensationType.COMPENSATION_TYPE_UNSPECIFIED][google.cloud.talent.v4beta1.CompensationInfo.CompensationType.COMPENSATION_TYPE_UNSPECIFIED].
+    // Default is [CompensationType.COMPENSATION_TYPE_UNSPECIFIED][google.cloud.talent.v4beta1.CompensationInfo.CompensationType.COMPENSATION_TYPE_UNSPECIFIED].
     CompensationType type = 1;
 
-    // Optional. Frequency of the specified amount.
+    // Frequency of the specified amount.
     //
-    // Default is
-    // [CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED][google.cloud.talent.v4beta1.CompensationInfo.CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED].
+    // Default is [CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED][google.cloud.talent.v4beta1.CompensationInfo.CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED].
     CompensationUnit unit = 2;
 
-    // Optional.
-    //
     // Compensation amount. It could be a fixed amount or a floating range.
     oneof compensation_amount {
-      // Optional. Compensation amount.
+      // Compensation amount.
       google.type.Money amount = 3;
 
-      // Optional. Compensation range.
+      // Compensation range.
       CompensationRange range = 4;
     }
 
-    // Optional. Compensation description.  For example, could
+    // Compensation description.  For example, could
     // indicate equity terms or provide additional context to an estimated
     // bonus.
     string description = 5;
 
-    // Optional. Expected number of units paid each year. If not specified, when
-    // [Job.employment_types][google.cloud.talent.v4beta1.Job.employment_types]
-    // is FULLTIME, a default value is inferred based on
-    // [unit][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.unit].
-    // Default values:
+    // Expected number of units paid each year. If not specified, when
+    // [Job.employment_types][google.cloud.talent.v4beta1.Job.employment_types] is FULLTIME, a default value is inferred
+    // based on [unit][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.unit]. Default values:
     // - HOURLY: 2080
     // - DAILY: 260
     // - WEEKLY: 52
@@ -748,44 +707,34 @@ message CompensationInfo {
 
   // Compensation range.
   message CompensationRange {
-    // Optional. The maximum amount of compensation. If left empty, the value is
-    // set to a maximal compensation value and the currency code is set to match
-    // the [currency code][google.type.Money.currency_code] of min_compensation.
+    // The maximum amount of compensation. If left empty, the value is set
+    // to a maximal compensation value and the currency code is set to
+    // match the [currency code][google.type.Money.currency_code] of
+    // min_compensation.
     google.type.Money max_compensation = 2;
 
-    // Optional. The minimum amount of compensation. If left empty, the value is
-    // set to zero and the currency code is set to match the [currency
-    // code][google.type.Money.currency_code] of max_compensation.
+    // The minimum amount of compensation. If left empty, the value is set
+    // to zero and the currency code is set to match the
+    // [currency code][google.type.Money.currency_code] of max_compensation.
     google.type.Money min_compensation = 1;
   }
 
   // The type of compensation.
   //
   // For compensation amounts specified in non-monetary amounts,
-  // describe the compensation scheme in the
-  // [CompensationEntry.description][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.description].
+  // describe the compensation scheme in the [CompensationEntry.description][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.description].
   //
   // For example, tipping format is described in
-  // [CompensationEntry.description][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.description]
-  // (for example, "expect 15-20% tips based on customer bill.") and an estimate
-  // of the tips provided in
-  // [CompensationEntry.amount][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.amount]
-  // or
-  // [CompensationEntry.range][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.range]
-  // ($10 per hour).
-  //
-  // For example, equity is described in
-  // [CompensationEntry.description][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.description]
+  // [CompensationEntry.description][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.description] (for example, "expect 15-20% tips based
+  // on customer bill.") and an estimate of the tips provided in
+  // [CompensationEntry.amount][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.amount] or [CompensationEntry.range][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.range] ($10 per hour).
+  //
+  // For example, equity is described in [CompensationEntry.description][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.description]
   // (for example, "1% - 2% equity vesting over 4 years, 1 year cliff") and
-  // value estimated in
-  // [CompensationEntry.amount][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.amount]
-  // or
-  // [CompensationEntry.range][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.range].
-  // If no value estimate is possible, units are
-  // [CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED][google.cloud.talent.v4beta1.CompensationInfo.CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED]
-  // and then further clarified in
-  // [CompensationEntry.description][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.description]
-  // field.
+  // value estimated in [CompensationEntry.amount][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.amount] or
+  // [CompensationEntry.range][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.range]. If no value estimate is possible, units are
+  // [CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED][google.cloud.talent.v4beta1.CompensationInfo.CompensationUnit.COMPENSATION_UNIT_UNSPECIFIED] and then further
+  // clarified in [CompensationEntry.description][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.description] field.
   enum CompensationType {
     // Default value.
     COMPENSATION_TYPE_UNSPECIFIED = 0;
@@ -845,55 +794,47 @@ message CompensationInfo {
     OTHER_COMPENSATION_UNIT = 7;
   }
 
-  // Optional. Job compensation information.
+  // Job compensation information.
   //
   // At most one entry can be of type
-  // [CompensationInfo.CompensationType.BASE][google.cloud.talent.v4beta1.CompensationInfo.CompensationType.BASE],
-  // which is referred as **base compensation entry** for the job.
+  // [CompensationInfo.CompensationType.BASE][google.cloud.talent.v4beta1.CompensationInfo.CompensationType.BASE], which is
+  // referred as **base compensation entry** for the job.
   repeated CompensationEntry entries = 1;
 
-  // Output only. Annualized base compensation range. Computed as
-  // base compensation entry's
-  // [CompensationEntry.amount][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.amount]
-  // times
+  // Output only. Annualized base compensation range. Computed as base compensation entry's
+  // [CompensationEntry.amount][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.amount] times
   // [CompensationEntry.expected_units_per_year][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.expected_units_per_year].
   //
-  // See
-  // [CompensationEntry][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry]
-  // for explanation on compensation annualization.
-  CompensationRange annualized_base_compensation_range = 2;
+  // See [CompensationEntry][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry] for explanation on compensation annualization.
+  CompensationRange annualized_base_compensation_range = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // Output only. Annualized total compensation range. Computed as
-  // all compensation entries'
-  // [CompensationEntry.amount][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.amount]
-  // times
+  // Output only. Annualized total compensation range. Computed as all compensation entries'
+  // [CompensationEntry.amount][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.amount] times
   // [CompensationEntry.expected_units_per_year][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry.expected_units_per_year].
   //
-  // See
-  // [CompensationEntry][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry]
-  // for explanation on compensation annualization.
-  CompensationRange annualized_total_compensation_range = 3;
+  // See [CompensationEntry][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry] for explanation on compensation annualization.
+  CompensationRange annualized_total_compensation_range = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Resource that represents a license or certification.
 message Certification {
-  // Optional. Name of license or certification.
+  // Name of license or certification.
   //
   // Number of characters allowed is 100.
   string display_name = 1;
 
-  // Optional. Acquisition date or effective date of license or certification.
+  // Acquisition date or effective date of license or certification.
   google.type.Date acquire_date = 2;
 
-  // Optional. Expiration date of license of certification.
+  // Expiration date of license of certification.
   google.type.Date expire_date = 3;
 
-  // Optional. Authority of license, such as government.
+  // Authority of license, such as government.
   //
   // Number of characters allowed is 100.
   string authority = 4;
 
-  // Optional. Description of license or certification.
+  // Description of license or certification.
   //
   // Number of characters allowed is 100,000.
   string description = 5;
@@ -901,41 +842,39 @@ message Certification {
 
 // Resource that represents a skill of a candidate.
 message Skill {
-  // Optional. Skill display name.
+  // Skill display name.
   //
   // For example, "Java", "Python".
   //
   // Number of characters allowed is 100.
   string display_name = 1;
 
-  // Optional. The last time this skill was used.
+  // The last time this skill was used.
   google.type.Date last_used_date = 2;
 
-  // Optional. Skill proficiency level which indicates how proficient the
-  // candidate is at this skill.
+  // Skill proficiency level which indicates how proficient the candidate is at
+  // this skill.
   SkillProficiencyLevel level = 3;
 
-  // Optional. A paragraph describes context of this skill.
+  // A paragraph describes context of this skill.
   //
   // Number of characters allowed is 100,000.
   string context = 4;
 
-  // Output only. Skill name snippet shows how the
-  // [display_name][google.cloud.talent.v4beta1.Skill.display_name] is related
-  // to a search query. It's empty if the
-  // [display_name][google.cloud.talent.v4beta1.Skill.display_name] isn't
-  // related to the search query.
-  string skill_name_snippet = 5;
+  // Output only. Skill name snippet shows how the [display_name][google.cloud.talent.v4beta1.Skill.display_name] is related to a search
+  // query. It's empty if the [display_name][google.cloud.talent.v4beta1.Skill.display_name] isn't related to the search
+  // query.
+  string skill_name_snippet = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Details of an interview.
 message Interview {
-  // Optional. The rating on this interview.
+  // The rating on this interview.
   Rating rating = 6;
 
-  // Required. The overall decision resulting from this interview (positive,
-  // negative, nuetral).
-  Outcome outcome = 7;
+  // Required. The overall decision resulting from this interview (positive, negative,
+  // nuetral).
+  Outcome outcome = 7 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The details of the score received for an assessment or interview.
@@ -954,6 +893,64 @@ message Rating {
   double interval = 4;
 }
 
+// Metadata used for long running operations returned by CTS batch APIs.
+// It's used to replace [google.longrunning.Operation.metadata][google.longrunning.Operation.metadata].
+message BatchOperationMetadata {
+  enum State {
+    // Default value.
+    STATE_UNSPECIFIED = 0;
+
+    // The batch operation is being prepared for processing.
+    INITIALIZING = 1;
+
+    // The batch operation is actively being processed.
+    PROCESSING = 2;
+
+    // The batch operation is processed, and at least one item has been
+    // successfully processed.
+    SUCCEEDED = 3;
+
+    // The batch operation is done and no item has been successfully processed.
+    FAILED = 4;
+
+    // The batch operation is in the process of cancelling after
+    // [google.longrunning.Operations.CancelOperation][google.longrunning.Operations.CancelOperation] is called.
+    CANCELLING = 5;
+
+    // The batch operation is done after
+    // [google.longrunning.Operations.CancelOperation][google.longrunning.Operations.CancelOperation] is called. Any items
+    // processed before cancelling are returned in the response.
+    CANCELLED = 6;
+  }
+
+  // The state of a long running operation.
+  State state = 1;
+
+  // More detailed information about operation state.
+  string state_description = 2;
+
+  // Count of successful item(s) inside an operation.
+  int32 success_count = 3;
+
+  // Count of failed item(s) inside an operation.
+  int32 failure_count = 4;
+
+  // Count of total item(s) inside an operation.
+  int32 total_count = 5;
+
+  // The time when the batch operation is created.
+  google.protobuf.Timestamp create_time = 6;
+
+  // The time when the batch operation status is updated. The metadata and the
+  // [update_time][google.cloud.talent.v4beta1.BatchOperationMetadata.update_time] is refreshed every minute otherwise cached data is
+  // returned.
+  google.protobuf.Timestamp update_time = 7;
+
+  // The time when the batch operation is finished and
+  // [google.longrunning.Operation.done][google.longrunning.Operation.done] is set to `true`.
+  google.protobuf.Timestamp end_time = 8;
+}
+
 // Enum that represents the skill proficiency level.
 enum SkillProficiencyLevel {
   // Default value.
@@ -1004,3 +1001,73 @@ enum Outcome {
   // candidate did not complete assessment).
   OUTCOME_NOT_AVAILABLE = 4;
 }
+
+// The type of candidate availability signal.
+enum AvailabilitySignalType {
+  // Default value.
+  AVAILABILITY_SIGNAL_TYPE_UNSPECIFIED = 0;
+
+  // Job application signal.
+  //
+  // In the context of [Profile.availability_signals][google.cloud.talent.v4beta1.Profile.availability_signals], this signal is related
+  // to the candidate's most recent application.
+  // [last_update_time][google.cloud.talent.v4beta1.AvailabilitySignal.last_update_time] is
+  // calculated from max([Application.create_time][google.cloud.talent.v4beta1.Application.create_time]) from all [Application][google.cloud.talent.v4beta1.Application]
+  // records where [Application.source][google.cloud.talent.v4beta1.Application.source] is any of the following:
+  //  [APPLY_DIRECT_WEB][google.cloud.talent.v4beta1.Application.ApplicationSource.APPLY_DIRECT_WEB]
+  //  [APPLY_DIRECT_MOBILE_WEB][google.cloud.talent.v4beta1.Application.ApplicationSource.APPLY_DIRECT_MOBILE_WEB]
+  //  [APPLY_DIRECT_MOBILE_APP][google.cloud.talent.v4beta1.Application.ApplicationSource.APPLY_DIRECT_MOBILE_APP]
+  //  [APPLY_DIRECT_IN_PERSON][google.cloud.talent.v4beta1.Application.ApplicationSource.APPLY_DIRECT_IN_PERSON]
+  //  [APPLY_INDIRECT][google.cloud.talent.v4beta1.Application.ApplicationSource.APPLY_INDIRECT]
+  //
+  // In the context of [AvailabilityFilter][google.cloud.talent.v4beta1.AvailabilityFilter], the filter is applied on
+  // [Profile.availability_signals][google.cloud.talent.v4beta1.Profile.availability_signals] where
+  // [type][google.cloud.talent.v4beta1.AvailabilitySignal.type] is JOB_APPLICATION.
+  JOB_APPLICATION = 1;
+
+  // Resume update signal.
+  //
+  // In the context of [Profile.availability_signals][google.cloud.talent.v4beta1.Profile.availability_signals], this signal is related
+  // to the candidate's most recent update to their resume.
+  // For a [SummarizedProfile.summary][google.cloud.talent.v4beta1.SummarizedProfile.summary],
+  // [last_update_time][google.cloud.talent.v4beta1.AvailabilitySignal.last_update_time] is
+  // calculated from max([Profile.resume_update_time][google.cloud.talent.v4beta1.Profile.resume_update_time]) from all
+  // [SummarizedProfile.profiles][google.cloud.talent.v4beta1.SummarizedProfile.profiles].
+  //
+  // In the context of [AvailabilityFilter][google.cloud.talent.v4beta1.AvailabilityFilter], the filter is applied on
+  // [Profile.availability_signals][google.cloud.talent.v4beta1.Profile.availability_signals] where
+  // [type][google.cloud.talent.v4beta1.AvailabilitySignal.type] is RESUME_UPDATE.
+  RESUME_UPDATE = 2;
+
+  // Candidate update signal.
+  //
+  // In the context of [Profile.availability_signals][google.cloud.talent.v4beta1.Profile.availability_signals], this signal is related
+  // to the candidate's most recent update to their profile.
+  // For a [SummarizedProfile.summary][google.cloud.talent.v4beta1.SummarizedProfile.summary],
+  // [last_update_time][google.cloud.talent.v4beta1.AvailabilitySignal.last_update_time] is
+  // calculated from max([Profile.candidate_update_time][google.cloud.talent.v4beta1.Profile.candidate_update_time]) from all
+  // [SummarizedProfile.profiles][google.cloud.talent.v4beta1.SummarizedProfile.profiles].
+  //
+  // In the context of [AvailabilityFilter][google.cloud.talent.v4beta1.AvailabilityFilter], the filter is applied on
+  // [Profile.availability_signals][google.cloud.talent.v4beta1.Profile.availability_signals] where
+  // [type][google.cloud.talent.v4beta1.AvailabilitySignal.type] is CANDIDATE_UPDATE.
+  CANDIDATE_UPDATE = 3;
+
+  // Client submission signal.
+  //
+  // In the context of [Profile.availability_signals][google.cloud.talent.v4beta1.Profile.availability_signals], this signal is related
+  // to the candidate's most recent submission.
+  // [last_update_time][google.cloud.talent.v4beta1.AvailabilitySignal.last_update_time] is
+  // calculated from max([Application.create_time][google.cloud.talent.v4beta1.Application.create_time]) from all [Application][google.cloud.talent.v4beta1.Application]
+  // records where [Application.stage][google.cloud.talent.v4beta1.Application.stage] is any of the following:
+  //  [HIRING_MANAGER_REVIEW][google.cloud.talent.v4beta1.Application.ApplicationStage.HIRING_MANAGER_REVIEW]
+  //  [INTERVIEW][google.cloud.talent.v4beta1.Application.ApplicationStage.INTERVIEW]
+  //  [OFFER_EXTENDED][google.cloud.talent.v4beta1.Application.ApplicationStage.OFFER_EXTENDED]
+  //  [OFFER_ACCEPTED][google.cloud.talent.v4beta1.Application.ApplicationStage.OFFER_ACCEPTED]
+  //  [STARTED][google.cloud.talent.v4beta1.Application.ApplicationStage.STARTED]
+  //
+  // In the context of [AvailabilityFilter][google.cloud.talent.v4beta1.AvailabilityFilter], the filter is applied on
+  // [Profile.availability_signals][google.cloud.talent.v4beta1.Profile.availability_signals] where
+  // [type][google.cloud.talent.v4beta1.AvailabilitySignal.type] is CLIENT_SUBMISSION.
+  CLIENT_SUBMISSION = 4;
+}
diff --git a/third_party/googleapis/google/cloud/talent/v4beta1/company.proto b/third_party/googleapis/google/cloud/talent/v4beta1/company.proto
index 928a43822..c68945723 100644
--- a/third_party/googleapis/google/cloud/talent/v4beta1/company.proto
+++ b/third_party/googleapis/google/cloud/talent/v4beta1/company.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,14 +11,15 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.talent.v4beta1;
 
-import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/talent/v4beta1/common.proto";
+import "google/api/annotations.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
 option java_multiple_files = true;
@@ -30,11 +31,16 @@ option objc_class_prefix = "CTS";
 // entity that owns job postings, that is, the hiring entity responsible for
 // employing applicants for the job position.
 message Company {
+  option (google.api.resource) = {
+    type: "jobs.googleapis.com/Company"
+    pattern: "projects/{project}/tenants/{tenant}/companies/{company}"
+    pattern: "projects/{project}/companies/{company}"
+  };
+
   // Derived details about the company.
   message DerivedInfo {
     // A structured headquarters location of the company, resolved from
-    // [Company.headquarters_address][google.cloud.talent.v4beta1.Company.headquarters_address]
-    // if provided.
+    // [Company.headquarters_address][google.cloud.talent.v4beta1.Company.headquarters_address] if provided.
     Location headquarters_location = 1;
   }
 
@@ -45,60 +51,58 @@ message Company {
   //
   // The format is
   // "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for
-  // example, "projects/api-test-project/tenants/foo/companies/bar".
+  // example, "projects/foo/tenants/bar/companies/baz".
   //
-  // Tenant id is optional and the default tenant is used if unspecified, for
-  // example, "projects/api-test-project/companies/bar".
+  // If tenant id is unspecified, the default tenant is used. For
+  // example, "projects/foo/companies/bar".
   string name = 1;
 
-  // Required. The display name of the company, for example, "Google, LLC".
-  string display_name = 2;
+  // Required. The display name of the company, for example, "Google LLC".
+  string display_name = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Required. Client side company identifier, used to uniquely identify the
   // company.
   //
   // The maximum number of allowed characters is 255.
-  string external_id = 3;
+  string external_id = 3 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional. The employer's company size.
+  // The employer's company size.
   CompanySize size = 4;
 
-  // Optional. The street address of the company's main headquarters, which may
-  // be different from the job location. The service attempts to geolocate the
-  // provided address, and populates a more specific location wherever possible
-  // in
-  // [DerivedInfo.headquarters_location][google.cloud.talent.v4beta1.Company.DerivedInfo.headquarters_location].
+  // The street address of the company's main headquarters, which may be
+  // different from the job location. The service attempts
+  // to geolocate the provided address, and populates a more specific
+  // location wherever possible in [DerivedInfo.headquarters_location][google.cloud.talent.v4beta1.Company.DerivedInfo.headquarters_location].
   string headquarters_address = 5;
 
-  // Optional. Set to true if it is the hiring agency that post jobs for other
+  // Set to true if it is the hiring agency that post jobs for other
   // employers.
   //
   // Defaults to false if not provided.
   bool hiring_agency = 6;
 
-  // Optional. Equal Employment Opportunity legal disclaimer text to be
+  // Equal Employment Opportunity legal disclaimer text to be
   // associated with all jobs, and typically to be displayed in all
   // roles.
   //
   // The maximum number of allowed characters is 500.
   string eeo_text = 7;
 
-  // Optional. The URI representing the company's primary web site or home page,
+  // The URI representing the company's primary web site or home page,
   // for example, "https://www.google.com".
   //
   // The maximum number of allowed characters is 255.
   string website_uri = 8;
 
-  // Optional. The URI to employer's career site or careers page on the
-  // employer's web site, for example, "https://careers.google.com".
+  // The URI to employer's career site or careers page on the employer's web
+  // site, for example, "https://careers.google.com".
   string career_site_uri = 9;
 
-  // Optional. A URI that hosts the employer's company logo.
+  // A URI that hosts the employer's company logo.
   string image_uri = 10;
 
-  // Optional. A list of keys of filterable
-  // [Job.custom_attributes][google.cloud.talent.v4beta1.Job.custom_attributes],
-  // whose corresponding `string_values` are used in keyword searches. Jobs with
+  // A list of keys of filterable [Job.custom_attributes][google.cloud.talent.v4beta1.Job.custom_attributes], whose
+  // corresponding `string_values` are used in keyword searches. Jobs with
   // `string_values` under these specified field keys are returned if any
   // of the values match the search keyword. Custom field values with
   // parenthesis, brackets and special symbols are not searchable as-is,
@@ -106,10 +110,10 @@ message Company {
   repeated string keyword_searchable_job_custom_attributes = 11;
 
   // Output only. Derived details about the company.
-  DerivedInfo derived_info = 12;
+  DerivedInfo derived_info = 12 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Indicates whether a company is flagged to be suspended from
   // public availability by the service when job content appears suspicious,
   // abusive, or spammy.
-  bool suspended = 13;
+  bool suspended = 13 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
diff --git a/third_party/googleapis/google/cloud/talent/v4beta1/company_service.proto b/third_party/googleapis/google/cloud/talent/v4beta1/company_service.proto
index 1e48a46cd..ac6a7d744 100644
--- a/third_party/googleapis/google/cloud/talent/v4beta1/company_service.proto
+++ b/third_party/googleapis/google/cloud/talent/v4beta1/company_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -19,6 +18,8 @@ package google.cloud.talent.v4beta1;
 
 import "google/api/annotations.proto";
 import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/talent/v4beta1/common.proto";
 import "google/cloud/talent/v4beta1/company.proto";
 import "google/protobuf/empty.proto";
@@ -47,14 +48,18 @@ service CompanyService {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "parent,company";
   }
 
   // Retrieves specified company.
   rpc GetCompany(GetCompanyRequest) returns (Company) {
     option (google.api.http) = {
       get: "/v4beta1/{name=projects/*/tenants/*/companies/*}"
-      additional_bindings { get: "/v4beta1/{name=projects/*/companies/*}" }
+      additional_bindings {
+        get: "/v4beta1/{name=projects/*/companies/*}"
+      }
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Updates specified company.
@@ -67,6 +72,7 @@ service CompanyService {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "company";
   }
 
   // Deletes specified company.
@@ -74,16 +80,22 @@ service CompanyService {
   rpc DeleteCompany(DeleteCompanyRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v4beta1/{name=projects/*/tenants/*/companies/*}"
-      additional_bindings { delete: "/v4beta1/{name=projects/*/companies/*}" }
+      additional_bindings {
+        delete: "/v4beta1/{name=projects/*/companies/*}"
+      }
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists all companies associated with the project.
   rpc ListCompanies(ListCompaniesRequest) returns (ListCompaniesResponse) {
     option (google.api.http) = {
       get: "/v4beta1/{parent=projects/*/tenants/*}/companies"
-      additional_bindings { get: "/v4beta1/{parent=projects/*}/companies" }
+      additional_bindings {
+        get: "/v4beta1/{parent=projects/*}/companies"
+      }
     };
+    option (google.api.method_signature) = "parent";
   }
 }
 
@@ -92,14 +104,17 @@ message CreateCompanyRequest {
   // Required. Resource name of the tenant under which the company is created.
   //
   // The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-  // "projects/api-test-project/tenant/foo".
-  //
-  // Tenant id is optional and a default tenant is created if unspecified, for
-  // example, "projects/api-test-project".
-  string parent = 1;
+  // "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant
+  // is created, for example, "projects/foo".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "jobs.googleapis.com/Company"
+    }
+  ];
 
   // Required. The company to be created.
-  Company company = 2;
+  Company company = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for getting a company by name.
@@ -110,29 +125,28 @@ message GetCompanyRequest {
   // "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for
   // example, "projects/api-test-project/tenants/foo/companies/bar".
   //
-  // Tenant id is optional and the default tenant is used if unspecified, for
+  // If tenant id is unspecified, the default tenant is used, for
   // example, "projects/api-test-project/companies/bar".
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "jobs.googleapis.com/Company"
+    }
+  ];
 }
 
 // Request for updating a specified company.
 message UpdateCompanyRequest {
-  // Required. The company resource to replace the current resource in the
-  // system.
-  Company company = 1;
+  // Required. The company resource to replace the current resource in the system.
+  Company company = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional but strongly recommended for the best service
-  // experience.
+  // Strongly recommended for the best service experience.
   //
-  // If
-  // [update_mask][google.cloud.talent.v4beta1.UpdateCompanyRequest.update_mask]
-  // is provided, only the specified fields in
-  // [company][google.cloud.talent.v4beta1.UpdateCompanyRequest.company] are
-  // updated. Otherwise all the fields are updated.
+  // If [update_mask][google.cloud.talent.v4beta1.UpdateCompanyRequest.update_mask] is provided, only the specified fields in
+  // [company][google.cloud.talent.v4beta1.UpdateCompanyRequest.company] are updated. Otherwise all the fields are updated.
   //
   // A field mask to specify the company fields to be updated. Only
-  // top level fields of [Company][google.cloud.talent.v4beta1.Company] are
-  // supported.
+  // top level fields of [Company][google.cloud.talent.v4beta1.Company] are supported.
   google.protobuf.FieldMask update_mask = 2;
 }
 
@@ -142,11 +156,16 @@ message DeleteCompanyRequest {
   //
   // The format is
   // "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for
-  // example, "projects/api-test-project/tenants/foo/companies/bar".
+  // example, "projects/foo/tenants/bar/companies/baz".
   //
-  // Tenant id is optional and the default tenant is used if unspecified, for
-  // example, "projects/api-test-project/companies/bar".
-  string name = 1;
+  // If tenant id is unspecified, the default tenant is used, for
+  // example, "projects/foo/companies/bar".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "jobs.googleapis.com/Company"
+    }
+  ];
 }
 
 // List companies for which the client has ACL visibility.
@@ -154,31 +173,33 @@ message ListCompaniesRequest {
   // Required. Resource name of the tenant under which the company is created.
   //
   // The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-  // "projects/api-test-project/tenant/foo".
+  // "projects/foo/tenant/bar".
   //
-  // Tenant id is optional and the default tenant is used if unspecified, for
-  // example, "projects/api-test-project".
-  string parent = 1;
-
-  // Optional. The starting indicator from which to return results.
+  // If tenant id is unspecified, the default tenant will be used, for
+  // example, "projects/foo".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "jobs.googleapis.com/Company"
+    }
+  ];
+
+  // The starting indicator from which to return results.
   string page_token = 2;
 
-  // Optional. The maximum number of companies to be returned, at most 100.
+  // The maximum number of companies to be returned, at most 100.
   // Default is 100 if a non-positive number is provided.
   int32 page_size = 3;
 
-  // Optional. Set to true if the companies requested must have open jobs.
+  // Set to true if the companies requested must have open jobs.
   //
   // Defaults to false.
   //
-  // If true, at most
-  // [page_size][google.cloud.talent.v4beta1.ListCompaniesRequest.page_size] of
-  // companies are fetched, among which only those with open jobs are returned.
+  // If true, at most [page_size][google.cloud.talent.v4beta1.ListCompaniesRequest.page_size] of companies are fetched, among which
+  // only those with open jobs are returned.
   bool require_open_jobs = 4;
 }
 
-// Output only.
-//
 // The List companies response object.
 message ListCompaniesResponse {
   // Companies for the current client.
diff --git a/third_party/googleapis/google/cloud/talent/v4beta1/completion_service.proto b/third_party/googleapis/google/cloud/talent/v4beta1/completion_service.proto
index 2b105c24b..2e45ac7d5 100644
--- a/third_party/googleapis/google/cloud/talent/v4beta1/completion_service.proto
+++ b/third_party/googleapis/google/cloud/talent/v4beta1/completion_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,15 +11,16 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.talent.v4beta1;
 
 import "google/api/annotations.proto";
-import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/talent/v4beta1/common.proto";
+import "google/api/client.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
 option java_multiple_files = true;
@@ -39,13 +40,13 @@ service Completion {
   rpc CompleteQuery(CompleteQueryRequest) returns (CompleteQueryResponse) {
     option (google.api.http) = {
       get: "/v4beta1/{parent=projects/*/tenants/*}:complete"
-      additional_bindings { get: "/v4beta1/{parent=projects/*}:complete" }
+      additional_bindings {
+        get: "/v4beta1/{parent=projects/*}:complete"
+      }
     };
   }
 }
 
-// Input only.
-//
 // Auto-complete parameters.
 message CompleteQueryRequest {
   // Enum to specify the scope of completion.
@@ -66,88 +67,80 @@ message CompleteQueryRequest {
     // Default value.
     COMPLETION_TYPE_UNSPECIFIED = 0;
 
-    // Only suggest job titles.
+    // Suggest job titles for jobs autocomplete.
+    //
+    // For [CompletionType.JOB_TITLE][google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionType.JOB_TITLE] type, only open jobs with the same
+    // [language_codes][google.cloud.talent.v4beta1.CompleteQueryRequest.language_codes] are returned.
     JOB_TITLE = 1;
 
-    // Only suggest company names.
+    // Suggest company names for jobs autocomplete.
+    //
+    // For [CompletionType.COMPANY_NAME][google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionType.COMPANY_NAME] type,
+    // only companies having open jobs with the same [language_codes][google.cloud.talent.v4beta1.CompleteQueryRequest.language_codes] are
+    // returned.
     COMPANY_NAME = 2;
 
-    // Suggest both job titles and company names.
+    // Suggest both job titles and company names for jobs autocomplete.
+    //
+    // For [CompletionType.COMBINED][google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionType.COMBINED] type, only open jobs with the same
+    // [language_codes][google.cloud.talent.v4beta1.CompleteQueryRequest.language_codes] or companies having open jobs with the same
+    // [language_codes][google.cloud.talent.v4beta1.CompleteQueryRequest.language_codes] are returned.
     COMBINED = 3;
   }
 
   // Required. Resource name of tenant the completion is performed within.
   //
   // The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-  // "projects/api-test-project/tenant/foo".
+  // "projects/foo/tenant/bar".
   //
-  // Tenant id is optional and the default tenant is used if unspecified, for
-  // example, "projects/api-test-project".
-  string parent = 1;
+  // If tenant id is unspecified, the default tenant is used, for
+  // example, "projects/foo".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "jobs.googleapis.com/Company"
+    }
+  ];
 
   // Required. The query used to generate suggestions.
   //
   // The maximum number of allowed characters is 255.
-  string query = 2;
+  string query = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional. The list of languages of the query. This is
+  // The list of languages of the query. This is
   // the BCP-47 language code, such as "en-US" or "sr-Latn".
   // For more information, see
   // [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47).
   //
-  // For
-  // [CompletionType.JOB_TITLE][google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionType.JOB_TITLE]
-  // type, only open jobs with the same
-  // [language_codes][google.cloud.talent.v4beta1.CompleteQueryRequest.language_codes]
-  // are returned.
-  //
-  // For
-  // [CompletionType.COMPANY_NAME][google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionType.COMPANY_NAME]
-  // type, only companies having open jobs with the same
-  // [language_codes][google.cloud.talent.v4beta1.CompleteQueryRequest.language_codes]
-  // are returned.
-  //
-  // For
-  // [CompletionType.COMBINED][google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionType.COMBINED]
-  // type, only open jobs with the same
-  // [language_codes][google.cloud.talent.v4beta1.CompleteQueryRequest.language_codes]
-  // or companies having open jobs with the same
-  // [language_codes][google.cloud.talent.v4beta1.CompleteQueryRequest.language_codes]
-  // are returned.
-  //
   // The maximum number of allowed characters is 255.
   repeated string language_codes = 3;
 
   // Required. Completion result count.
   //
   // The maximum allowed page size is 10.
-  int32 page_size = 4;
+  int32 page_size = 4 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional. If provided, restricts completion to specified company.
+  // If provided, restricts completion to specified company.
   //
   // The format is
   // "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for
-  // example, "projects/api-test-project/tenants/foo/companies/bar".
+  // example, "projects/foo/tenants/bar/companies/baz".
   //
-  // Tenant id is optional and the default tenant is used if unspecified, for
-  // example, "projects/api-test-project/companies/bar".
-  string company = 5;
+  // If tenant id is unspecified, the default tenant is used, for
+  // example, "projects/foo".
+  string company = 5 [(google.api.resource_reference) = {
+                        type: "jobs.googleapis.com/Company"
+                      }];
 
-  // Optional. The scope of the completion. The defaults is
-  // [CompletionScope.PUBLIC][google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionScope.PUBLIC].
+  // The scope of the completion. The defaults is [CompletionScope.PUBLIC][google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionScope.PUBLIC].
   CompletionScope scope = 6;
 
-  // Optional. The completion topic. The default is
-  // [CompletionType.COMBINED][google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionType.COMBINED].
+  // The completion topic. The default is [CompletionType.COMBINED][google.cloud.talent.v4beta1.CompleteQueryRequest.CompletionType.COMBINED].
   CompletionType type = 7;
 }
 
-// Output only.
-//
 // Response of auto-complete query.
 message CompleteQueryResponse {
-  // Output only.
-  //
   // Resource that represents completion results.
   message CompletionResult {
     // The suggestion for the query.
diff --git a/third_party/googleapis/google/cloud/talent/v4beta1/event.proto b/third_party/googleapis/google/cloud/talent/v4beta1/event.proto
index c8ea12581..c5a71553b 100644
--- a/third_party/googleapis/google/cloud/talent/v4beta1/event.proto
+++ b/third_party/googleapis/google/cloud/talent/v4beta1/event.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,14 +11,14 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.talent.v4beta1;
 
-import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
 import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
 option java_multiple_files = true;
@@ -32,17 +32,17 @@ option objc_class_prefix = "CTS";
 // service to perform optimally. The number of events sent must be consistent
 // with other calls, such as job searches, issued to the service by the client.
 message ClientEvent {
-  // Optional but highly recommended.
+  // Strongly recommended for the best service experience.
   //
   // A unique ID generated in the API responses. It can be found in
   // [ResponseMetadata.request_id][google.cloud.talent.v4beta1.ResponseMetadata.request_id].
   string request_id = 1;
 
   // Required. A unique identifier, generated by the client application.
-  string event_id = 2;
+  string event_id = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Required. The timestamp of the event.
-  google.protobuf.Timestamp create_time = 4;
+  google.protobuf.Timestamp create_time = 4 [(google.api.field_behavior) = REQUIRED];
 
   // Required.
   //
@@ -57,8 +57,8 @@ message ClientEvent {
     ProfileEvent profile_event = 6;
   }
 
-  // Optional. Notes about the event provided by recruiters or other users, for
-  // example, feedback on why a profile was bookmarked.
+  // Notes about the event provided by recruiters or other users, for example,
+  // feedback on why a profile was bookmarked.
   string event_notes = 9;
 }
 
@@ -101,9 +101,7 @@ message JobEvent {
     // submitted an application for a job with a single click without
     // entering information. If a job seeker performs this action, send only
     // this event to the service. Do not also send
-    // [JobEventType.APPLICATION_START][google.cloud.talent.v4beta1.JobEvent.JobEventType.APPLICATION_START]
-    // or
-    // [JobEventType.APPLICATION_FINISH][google.cloud.talent.v4beta1.JobEvent.JobEventType.APPLICATION_FINISH]
+    // [JobEventType.APPLICATION_START][google.cloud.talent.v4beta1.JobEvent.JobEventType.APPLICATION_START] or [JobEventType.APPLICATION_FINISH][google.cloud.talent.v4beta1.JobEvent.JobEventType.APPLICATION_FINISH]
     // events.
     APPLICATION_QUICK_SUBMISSION = 6;
 
@@ -123,12 +121,8 @@ message JobEvent {
     // (without viewing the details of the job posting), and is redirected
     // to a different website to complete the application. If a candidate
     // performs this action, send only this event to the service. Do not also
-    // send
-    // [JobEventType.APPLICATION_START][google.cloud.talent.v4beta1.JobEvent.JobEventType.APPLICATION_START],
-    // [JobEventType.APPLICATION_FINISH][google.cloud.talent.v4beta1.JobEvent.JobEventType.APPLICATION_FINISH]
-    // or
-    // [JobEventType.VIEW][google.cloud.talent.v4beta1.JobEvent.JobEventType.VIEW]
-    // events.
+    // send [JobEventType.APPLICATION_START][google.cloud.talent.v4beta1.JobEvent.JobEventType.APPLICATION_START],
+    // [JobEventType.APPLICATION_FINISH][google.cloud.talent.v4beta1.JobEvent.JobEventType.APPLICATION_FINISH] or [JobEventType.VIEW][google.cloud.talent.v4beta1.JobEvent.JobEventType.VIEW] events.
     APPLICATION_REDIRECT_FROM_SEARCH = 9;
 
     // This event should be used when a company submits an application
@@ -165,29 +159,25 @@ message JobEvent {
     INTERVIEW_GRANTED = 15;
   }
 
-  // Required. The type of the event (see
-  // [JobEventType][google.cloud.talent.v4beta1.JobEvent.JobEventType]).
-  JobEventType type = 1;
-
-  // Required. The [job name(s)][google.cloud.talent.v4beta1.Job.name]
-  // associated with this event. For example, if this is an
-  // [impression][google.cloud.talent.v4beta1.JobEvent.JobEventType.IMPRESSION]
-  // event, this field contains the identifiers of all jobs shown to the job
-  // seeker. If this was a
-  // [view][google.cloud.talent.v4beta1.JobEvent.JobEventType.VIEW] event, this
-  // field contains the identifier of the viewed job.
+  // Required. The type of the event (see [JobEventType][google.cloud.talent.v4beta1.JobEvent.JobEventType]).
+  JobEventType type = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The [job name(s)][google.cloud.talent.v4beta1.Job.name] associated with this event.
+  // For example, if this is an [impression][google.cloud.talent.v4beta1.JobEvent.JobEventType.IMPRESSION] event,
+  // this field contains the identifiers of all jobs shown to the job seeker.
+  // If this was a [view][google.cloud.talent.v4beta1.JobEvent.JobEventType.VIEW] event, this field contains the
+  // identifier of the viewed job.
   //
   // The format is
   // "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}", for
-  // example, "projects/api-test-project/tenants/foo/jobs/1234".
-  repeated string jobs = 2;
+  // example, "projects/foo/tenants/bar/jobs/baz".
+  repeated string jobs = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional. The [profile name][google.cloud.talent.v4beta1.Profile.name]
-  // associated with this client event.
+  // The [profile name][google.cloud.talent.v4beta1.Profile.name] associated with this client event.
   //
   // The format is
   // "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}",
-  // for example, "projects/api-test-project/tenants/foo/profiles/bar".
+  // for example, "projects/foo/tenants/bar/profiles/baz".
   string profile = 3;
 }
 
@@ -199,82 +189,25 @@ message ProfileEvent {
     // Default value.
     PROFILE_EVENT_TYPE_UNSPECIFIED = 0;
 
-    // Send this event when a
-    // [ProfileEvent.profiles][google.cloud.talent.v4beta1.ProfileEvent.profiles]
-    // meets all of the following criteria:
-    // * Was sent as a part of a result set for a CTS API call.
-    // * Was rendered in the end user's UI (that is, the
-    // [ProfileEvent.recruiter][google.cloud.talent.v4beta1.ProfileEvent.recruiter]).
-    // * That UI rendering was displayed in the end user's viewport for >=3
-    // seconds.
-    //
-    // In other words, send this event when the end user of the CTS service
-    // actually saw a resulting profile in their viewport.
-    //
-    // To understand how to use this event, consider an example:
-    //
-    // * The customer's UI for interacting with CTS
-    // result sets is accessed by the end user through a web browser.
-    // * The UI calls for a page size of 15 candidates (that is, 15 candidates
-    // are rendered on each page of results).
-    // * However, the UI design calls for only 5 candidates to be shown at any
-    // given time in the viewport (that is, the end user can only see 5 results
-    // at any given time and needs to scroll up or down to view all 15 results).
-    //
-    // To render each page of results, the customer will send a
-    // request to CTS with a page size = 15.
-    //
-    // * User loads page #1 of results.
-    // * User scrolls down to expose results #1 - #5 and dwells on this view for
-    // 30 seconds.
-    // * Send an IMPRESSION event for result 1, 2, 3, 4, 5.
-    // * User scrolls down a bit, exposing results #2 - #6 in the viewport and
-    // dwells on this view for 5 minutes.
-    // * Send an IMPRESSION event for result 6.
-    // * User scrolls to the bottom of the page, with results #7 - #15 shown in
-    // the viewport for ~5 seconds each.
-    // * Specifically, NO IMPRESSION events are sent for result 7, 8, 9, 10, 11,
-    // 12, 13, 14, 15.
-    // * User clicks to the next page and loads page #2 of results.
-    // * Within 2 seconds, user scrolls to expose results #20 - #24 in the
-    // viewport and dwells on this view for 20 mins.
-    // * Send an IMPRESSION event for result 20, 21, 22, 23, 24
-    // * User closes their browser window.
+    // Send this event when a [ProfileEvent.profiles][google.cloud.talent.v4beta1.ProfileEvent.profiles] was sent as a part of
+    // a result set for a CTS API call and was rendered in the end user's UI
+    // (that is, the [ProfileEvent.recruiter][google.cloud.talent.v4beta1.ProfileEvent.recruiter]).
     IMPRESSION = 1;
 
-    // The VIEW event allows CTS to understand if a candidate's profile was
-    // viewed by an end user (that is, recruiter) of the system for >=3 seconds.
-    // This is critical to tracking product metrics and should be sent for every
-    // profile VIEW that happens in the customer's system.
+    // The VIEW event records the action of a candidate's profile being
+    // viewed by an end user. This is critical to tracking product metrics and
+    // should be sent for every profile VIEW that happens in your system,
+    // whether the event is associated with an API call (for example, a
+    // recruiter making a request for a result set and clicking on a profile)
+    // or not (a recruiter using the system to view profile details without
+    // making a request).
     //
-    // VIEW events should be sent whether an end user views a candidate's
-    // profile as a result of seeing that profile in the result set of a
-    // CTS API request or whether the end user
-    // views the profile for some other reason (that is, clicks to the
-    // candidate's profile in the ATS, and so on).
-    //
-    // For a VIEW that happens as a result of seeing the profile in
-    // a CTS API request's result set, the
-    // [ClientEvent.request_id][google.cloud.talent.v4beta1.ClientEvent.request_id]
-    // should be populated.  If the VIEW happens for some other reason, the
-    // [requestId] should not be populated.
+    // For a VIEW events associated with API calls, the
+    // [ClientEvent.request_id][google.cloud.talent.v4beta1.ClientEvent.request_id] should be populated.  If the VIEW is not
+    // associated with an API call, [request_id][google.cloud.talent.v4beta1.ClientEvent.request_id] should
+    // not be populated.
     //
     // This event requires a valid recruiter and one valid ID in profiles.
-    //
-    // To understand how to use this event, consider 2 examples in which a VIEW
-    // event should be sent:
-    // * End user makes a request to the CTS API for a result set.
-    // * Results for the request are shown to the end user.
-    // * End user clicks on one of the candidates that are shown as part of the
-    // results.
-    // * A VIEW event with the
-    // [ClientEvent.request_id][google.cloud.talent.v4beta1.ClientEvent.request_id]
-    // of the API call in the first step of this example is sent.
-    //
-    // * End user browses to a candidate's profile in the ATS.
-    // * A VIEW event without a
-    // [ClientEvent.request_id][google.cloud.talent.v4beta1.ClientEvent.request_id]
-    // is sent.
     VIEW = 2;
 
     // The profile is bookmarked.
@@ -282,22 +215,20 @@ message ProfileEvent {
   }
 
   // Required. Type of event.
-  ProfileEventType type = 1;
+  ProfileEventType type = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Required. The [profile name(s)][google.cloud.talent.v4beta1.Profile.name]
-  // associated with this client event.
+  // Required. The [profile name(s)][google.cloud.talent.v4beta1.Profile.name] associated with this client event.
   //
   // The format is
   // "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}",
-  // for example, "projects/api-test-project/tenants/foo/profiles/bar".
-  repeated string profiles = 2;
+  // for example, "projects/foo/tenants/bar/profiles/baz".
+  repeated string profiles = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional. The [job name(s)][google.cloud.talent.v4beta1.Job.name]
-  // associated with this client event. Leave it empty if the event isn't
-  // associated with a job.
+  // The [job name(s)][google.cloud.talent.v4beta1.Job.name] associated with this client event. Leave it
+  // empty if the event isn't associated with a job.
   //
   // The format is
   // "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}", for
-  // example, "projects/api-test-project/tenants/foo/jobs/1234".
+  // example, "projects/foo/tenants/bar/jobs/baz".
   repeated string jobs = 6;
 }
diff --git a/third_party/googleapis/google/cloud/talent/v4beta1/event_service.proto b/third_party/googleapis/google/cloud/talent/v4beta1/event_service.proto
index 966632e57..4577352e9 100644
--- a/third_party/googleapis/google/cloud/talent/v4beta1/event_service.proto
+++ b/third_party/googleapis/google/cloud/talent/v4beta1/event_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -19,6 +18,8 @@ package google.cloud.talent.v4beta1;
 
 import "google/api/annotations.proto";
 import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/talent/v4beta1/event.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
@@ -50,6 +51,7 @@ service EventService {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "parent,client_event";
   }
 }
 
@@ -58,13 +60,16 @@ message CreateClientEventRequest {
   // Required. Resource name of the tenant under which the event is created.
   //
   // The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-  // "projects/api-test-project/tenant/foo".
-  //
-  // Tenant id is optional and a default tenant is created if unspecified, for
-  // example, "projects/api-test-project".
-  string parent = 1;
+  // "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant
+  // is created, for example, "projects/foo".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "jobs.googleapis.com/Company"
+    }
+  ];
 
-  // Required. Events issued when end user interacts with customer's application
-  // that uses Cloud Talent Solution.
-  ClientEvent client_event = 2;
+  // Required. Events issued when end user interacts with customer's application that
+  // uses Cloud Talent Solution.
+  ClientEvent client_event = 2 [(google.api.field_behavior) = REQUIRED];
 }
diff --git a/third_party/googleapis/google/cloud/talent/v4beta1/filters.proto b/third_party/googleapis/google/cloud/talent/v4beta1/filters.proto
index 0f86b2df6..be457b430 100644
--- a/third_party/googleapis/google/cloud/talent/v4beta1/filters.proto
+++ b/third_party/googleapis/google/cloud/talent/v4beta1/filters.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,23 +11,21 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.talent.v4beta1;
 
-import "google/api/annotations.proto";
-import "google/cloud/talent/v4beta1/application.proto";
+import "google/api/field_behavior.proto";
 import "google/cloud/talent/v4beta1/common.proto";
-import "google/cloud/talent/v4beta1/job.proto";
-import "google/cloud/talent/v4beta1/profile.proto";
 import "google/protobuf/duration.proto";
+import "google/protobuf/field_mask.proto";
 import "google/protobuf/timestamp.proto";
 import "google/protobuf/wrappers.proto";
 import "google/type/date.proto";
 import "google/type/latlng.proto";
 import "google/type/timeofday.proto";
+import "google/api/annotations.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
 option java_multiple_files = true;
@@ -35,17 +33,26 @@ option java_outer_classname = "FiltersProto";
 option java_package = "com.google.cloud.talent.v4beta1";
 option objc_class_prefix = "CTS";
 
-// Input only.
-//
 // The query required to perform a search query.
 message JobQuery {
-  // Optional. The query string that matches against the job title, description,
-  // and location fields.
+  // The query string that matches against the job title, description, and
+  // location fields.
   //
   // The maximum number of allowed characters is 255.
   string query = 1;
 
-  // Optional. This filter specifies the company entities to search against.
+  // The language code of [query][google.cloud.talent.v4beta1.JobQuery.query]. For example, "en-US". This field helps to
+  // better interpret the query.
+  //
+  // If a value isn't specified, the query language code is automatically
+  // detected, which may not be accurate.
+  //
+  // Language code should be in BCP-47 format, such as "en-US" or "sr-Latn".
+  // For more information, see
+  // [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47).
+  string query_language_code = 14;
+
+  // This filter specifies the company entities to search against.
   //
   // If a value isn't specified, jobs are searched for against all
   // companies.
@@ -54,34 +61,31 @@ message JobQuery {
   // companies specified.
   //
   // The format is
-  // "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for
-  // example, "projects/api-test-project/tenants/foo/companies/bar".
+  // "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}". For
+  // example, "projects/foo/tenants/bar/companies/baz".
   //
-  // Tenant id is optional and the default tenant is used if unspecified, for
-  // example, "projects/api-test-project/companies/bar".
+  // If tenant id is unspecified, the default tenant is used. For
+  // example, "projects/foo/companies/bar".
   //
   // At most 20 company filters are allowed.
   repeated string companies = 2;
 
-  // Optional. The location filter specifies geo-regions containing the jobs to
-  // search against. See
-  // [LocationFilter][google.cloud.talent.v4beta1.LocationFilter] for more
-  // information.
+  // The location filter specifies geo-regions containing the jobs to
+  // search against. See [LocationFilter][google.cloud.talent.v4beta1.LocationFilter] for more information.
   //
   // If a location value isn't specified, jobs fitting the other search
   // criteria are retrieved regardless of where they're located.
   //
   // If multiple values are specified, jobs are retrieved from any of the
   // specified locations. If different values are specified for the
-  // [LocationFilter.distance_in_miles][google.cloud.talent.v4beta1.LocationFilter.distance_in_miles]
-  // parameter, the maximum provided distance is used for all locations.
+  // [LocationFilter.distance_in_miles][google.cloud.talent.v4beta1.LocationFilter.distance_in_miles] parameter, the maximum provided
+  // distance is used for all locations.
   //
   // At most 5 location filters are allowed.
   repeated LocationFilter location_filters = 3;
 
-  // Optional. The category filter specifies the categories of jobs to search
-  // against. See [JobCategory][google.cloud.talent.v4beta1.JobCategory] for
-  // more information.
+  // The category filter specifies the categories of jobs to search against.
+  // See [JobCategory][google.cloud.talent.v4beta1.JobCategory] for more information.
   //
   // If a value isn't specified, jobs from any category are searched against.
   //
@@ -89,21 +93,17 @@ message JobQuery {
   // categories are searched against.
   repeated JobCategory job_categories = 4;
 
-  // Optional. Allows filtering jobs by commute time with different travel
-  // methods (for
+  // Allows filtering jobs by commute time with different travel methods (for
   //  example, driving or public transit).
   //
-  // Note: This only works when you specify a
-  // [CommuteMethod][google.cloud.talent.v4beta1.CommuteMethod]. In this case,
-  // [location_filters][google.cloud.talent.v4beta1.JobQuery.location_filters]
-  // is ignored.
+  // Note: This only works when you specify a [CommuteMethod][google.cloud.talent.v4beta1.CommuteMethod]. In this case,
+  // [location_filters][google.cloud.talent.v4beta1.JobQuery.location_filters] is ignored.
   //
   //  Currently we don't support sorting by commute time.
   CommuteFilter commute_filter = 5;
 
-  // Optional. This filter specifies the exact company
-  // [Company.display_name][google.cloud.talent.v4beta1.Company.display_name] of
-  // the jobs to search against.
+  // This filter specifies the exact company [Company.display_name][google.cloud.talent.v4beta1.Company.display_name]
+  // of the jobs to search against.
   //
   // If a value isn't specified, jobs within the search results are
   // associated with any company.
@@ -114,16 +114,15 @@ message JobQuery {
   // At most 20 company display name filters are allowed.
   repeated string company_display_names = 6;
 
-  // Optional. This search filter is applied only to
-  // [Job.compensation_info][google.cloud.talent.v4beta1.Job.compensation_info].
-  // For example, if the filter is specified as "Hourly job with per-hour
-  // compensation > $15", only jobs meeting these criteria are searched. If a
-  // filter isn't defined, all open jobs are searched.
+  // This search filter is applied only to
+  // [Job.compensation_info][google.cloud.talent.v4beta1.Job.compensation_info]. For example, if the filter is specified
+  // as "Hourly job with per-hour compensation > $15", only jobs meeting
+  // these criteria are searched. If a filter isn't defined, all open jobs
+  // are searched.
   CompensationFilter compensation_filter = 7;
 
-  // Optional. This filter specifies a structured syntax to match against the
-  // [Job.custom_attributes][google.cloud.talent.v4beta1.Job.custom_attributes]
-  // marked as `filterable`.
+  // This filter specifies a structured syntax to match against the
+  // [Job.custom_attributes][google.cloud.talent.v4beta1.Job.custom_attributes] marked as `filterable`.
   //
   // The syntax for this expression is a subset of SQL syntax.
   //
@@ -139,23 +138,22 @@ message JobQuery {
   // Boolean expressions (AND/OR/NOT) are supported up to 3 levels of
   // nesting (for example, "((A AND B AND C) OR NOT D) AND E"), a maximum of 100
   // comparisons or functions are allowed in the expression. The expression
-  // must be < 3000 bytes in length.
+  // must be < 6000 bytes in length.
   //
   // Sample Query:
   // `(LOWER(driving_license)="class \"a\"" OR EMPTY(driving_license)) AND
   // driving_years > 10`
   string custom_attribute_filter = 8;
 
-  // Optional. This flag controls the spell-check feature. If false, the
+  // This flag controls the spell-check feature. If false, the
   // service attempts to correct a misspelled query,
   // for example, "enginee" is corrected to "engineer".
   //
   // Defaults to false: a spell check is performed.
   bool disable_spell_check = 9;
 
-  // Optional. The employment type filter specifies the employment type of jobs
-  // to search against, such as
-  // [EmploymentType.FULL_TIME][google.cloud.talent.v4beta1.EmploymentType.FULL_TIME].
+  // The employment type filter specifies the employment type of jobs to
+  // search against, such as [EmploymentType.FULL_TIME][google.cloud.talent.v4beta1.EmploymentType.FULL_TIME].
   //
   // If a value isn't specified, jobs in the search results includes any
   // employment type.
@@ -164,7 +162,7 @@ message JobQuery {
   // any of the specified employment types.
   repeated EmploymentType employment_types = 10;
 
-  // Optional. This filter specifies the locale of jobs to search against,
+  // This filter specifies the locale of jobs to search against,
   // for example, "en-US".
   //
   // If a value isn't specified, the search results can contain jobs in any
@@ -178,12 +176,11 @@ message JobQuery {
   // At most 10 language code filters are allowed.
   repeated string language_codes = 11;
 
-  // Optional. Jobs published within a range specified by this filter are
-  // searched against.
+  // Jobs published within a range specified by this filter are searched
+  // against.
   TimestampRange publish_time_range = 12;
 
-  // Optional. This filter specifies a list of job names to be excluded during
-  // search.
+  // This filter specifies a list of job names to be excluded during search.
   //
   // At most 400 excluded job names are allowed.
   repeated string excluded_jobs = 13;
@@ -191,39 +188,96 @@ message JobQuery {
 
 // Filters to apply when performing the search query.
 message ProfileQuery {
-  // Optional. Keywords to match any text fields of profiles.
+  // Keywords to match any text fields of profiles.
   //
   // For example, "software engineer in Palo Alto".
   string query = 1;
 
-  // Optional. The location filter specifies geo-regions containing the profiles
-  // to search against.
+  // The location filter specifies geo-regions containing the profiles to
+  // search against.
+  //
+  // One of [LocationFilter.address][google.cloud.talent.v4beta1.LocationFilter.address] or [LocationFilter.lat_lng][google.cloud.talent.v4beta1.LocationFilter.lat_lng] must be
+  // provided or an error is thrown. If both [LocationFilter.address][google.cloud.talent.v4beta1.LocationFilter.address] and
+  // [LocationFilter.lat_lng][google.cloud.talent.v4beta1.LocationFilter.lat_lng] are provided, an error is thrown.
+  //
+  // The following logic is used to determine which locations in
+  // the profile to filter against:
+  //
+  // 1. All of the profile's geocoded [Profile.addresses][google.cloud.talent.v4beta1.Profile.addresses] where
+  // [Address.usage][google.cloud.talent.v4beta1.Address.usage] is PERSONAL and [Address.current][google.cloud.talent.v4beta1.Address.current] is true.
+  //
+  // 2. If the above set of locations is empty, all of the profile's geocoded
+  // [Profile.addresses][google.cloud.talent.v4beta1.Profile.addresses] where [Address.usage][google.cloud.talent.v4beta1.Address.usage] is
+  // CONTACT_INFO_USAGE_UNSPECIFIED and [Address.current][google.cloud.talent.v4beta1.Address.current] is true.
+  //
+  // 3. If the above set of locations is empty, all of the profile's geocoded
+  // [Profile.addresses][google.cloud.talent.v4beta1.Profile.addresses] where [Address.usage][google.cloud.talent.v4beta1.Address.usage] is PERSONAL or
+  // CONTACT_INFO_USAGE_UNSPECIFIED and [Address.current][google.cloud.talent.v4beta1.Address.current] is not set.
+  //
+  // This means that any profiles without any [Profile.addresses][google.cloud.talent.v4beta1.Profile.addresses] that match
+  // any of the above criteria will not be included in a search with location
+  // filter. Furthermore, any [Profile.addresses][google.cloud.talent.v4beta1.Profile.addresses] where [Address.usage][google.cloud.talent.v4beta1.Address.usage] is
+  // WORK or SCHOOL or where [Address.current][google.cloud.talent.v4beta1.Address.current] is false are not considered for
+  // location filter.
   //
   // If a location filter isn't specified, profiles fitting the other search
   // criteria are retrieved regardless of where they're located.
   //
-  // If
-  // [LocationFilter.negated][google.cloud.talent.v4beta1.LocationFilter.negated]
-  // is specified, the result doesn't contain profiles from that location.
-  //
-  // For example, search for profiles with addresses in "New York City".
+  // If [LocationFilter.negated][google.cloud.talent.v4beta1.LocationFilter.negated] is specified, the result doesn't contain
+  // profiles from that location.
+  //
+  // If [LocationFilter.address][google.cloud.talent.v4beta1.LocationFilter.address] is provided, the
+  // [LocationType][google.cloud.talent.v4beta1.Location.LocationType], center
+  // point (latitude and longitude), and radius are automatically detected by
+  // the Google Maps Geocoding API and included as well. If
+  // [LocationFilter.address][google.cloud.talent.v4beta1.LocationFilter.address] cannot be geocoded, the filter
+  // falls back to keyword search.
+  //
+  // If the detected
+  // [LocationType][google.cloud.talent.v4beta1.Location.LocationType] is
+  // [LocationType.SUB_ADMINISTRATIVE_AREA][google.cloud.talent.v4beta1.Location.LocationType.SUB_ADMINISTRATIVE_AREA],
+  // [LocationType.ADMINISTRATIVE_AREA][google.cloud.talent.v4beta1.Location.LocationType.ADMINISTRATIVE_AREA],
+  // or
+  // [LocationType.COUNTRY][google.cloud.talent.v4beta1.Location.LocationType.COUNTRY],
+  // the filter is performed against the detected location name (using exact
+  // text matching). Otherwise, the filter is performed against the detected
+  // center point and a radius of detected location radius +
+  // [LocationFilter.distance_in_miles][google.cloud.talent.v4beta1.LocationFilter.distance_in_miles].
+  //
+  // If [LocationFilter.address][google.cloud.talent.v4beta1.LocationFilter.address] is provided,
+  // [LocationFilter.distance_in_miles][google.cloud.talent.v4beta1.LocationFilter.distance_in_miles] is the additional radius on top of the
+  // radius of the location geocoded from [LocationFilter.address][google.cloud.talent.v4beta1.LocationFilter.address]. If
+  // [LocationFilter.lat_lng][google.cloud.talent.v4beta1.LocationFilter.lat_lng] is provided,
+  // [LocationFilter.distance_in_miles][google.cloud.talent.v4beta1.LocationFilter.distance_in_miles] is the only radius that is used.
+  //
+  // [LocationFilter.distance_in_miles][google.cloud.talent.v4beta1.LocationFilter.distance_in_miles] is 10 by default. Note that the value
+  // of [LocationFilter.distance_in_miles][google.cloud.talent.v4beta1.LocationFilter.distance_in_miles] is 0 if it is unset, so the server
+  // does not differentiate [LocationFilter.distance_in_miles][google.cloud.talent.v4beta1.LocationFilter.distance_in_miles] that is
+  // explicitly set to 0 and [LocationFilter.distance_in_miles][google.cloud.talent.v4beta1.LocationFilter.distance_in_miles] that is not
+  // set. Which means that if [LocationFilter.distance_in_miles][google.cloud.talent.v4beta1.LocationFilter.distance_in_miles] is explicitly
+  // set to 0, the server will use the default value of
+  // [LocationFilter.distance_in_miles][google.cloud.talent.v4beta1.LocationFilter.distance_in_miles] which is 10. To work around this and
+  // effectively set [LocationFilter.distance_in_miles][google.cloud.talent.v4beta1.LocationFilter.distance_in_miles] to 0, we recommend
+  // setting [LocationFilter.distance_in_miles][google.cloud.talent.v4beta1.LocationFilter.distance_in_miles] to a very small decimal number
+  // (such as 0.00001).
+  //
+  // If [LocationFilter.distance_in_miles][google.cloud.talent.v4beta1.LocationFilter.distance_in_miles] is negative, an error is thrown.
   repeated LocationFilter location_filters = 2;
 
-  // Optional. Job title filter specifies job titles of profiles to match on.
+  // Job title filter specifies job titles of profiles to match on.
   //
   // If a job title isn't specified, profiles with any titles are retrieved.
   //
   // If multiple values are specified, profiles are retrieved with any of the
   // specified job titles.
   //
-  // If
-  // [JobTitleFilter.negated][google.cloud.talent.v4beta1.JobTitleFilter.negated]
-  // is specified, the result won't contain profiles with the job titles.
+  // If [JobTitleFilter.negated][google.cloud.talent.v4beta1.JobTitleFilter.negated] is specified, the result won't contain
+  // profiles with the job titles.
   //
   // For example, search for profiles with a job title "Product Manager".
   repeated JobTitleFilter job_title_filters = 3;
 
-  // Optional. Employer filter specifies employers of profiles to match on.
+  // Employer filter specifies employers of profiles to match on.
   //
   // If an employer filter isn't specified, profiles with any employers are
   // retrieved.
@@ -231,15 +285,14 @@ message ProfileQuery {
   // If multiple employer filters are specified, profiles with any matching
   // employers are retrieved.
   //
-  // If
-  // [EmployerFilter.negated][google.cloud.talent.v4beta1.EmployerFilter.negated]
-  // is specified, the result won't contain profiles that match the employers.
+  // If [EmployerFilter.negated][google.cloud.talent.v4beta1.EmployerFilter.negated] is specified, the result won't contain
+  // profiles that match the employers.
   //
   // For example, search for profiles that have working experience at "Google
   // LLC".
   repeated EmployerFilter employer_filters = 4;
 
-  // Optional. Education filter specifies education of profiles to match on.
+  // Education filter specifies education of profiles to match on.
   //
   // If an education filter isn't specified, profiles with any education are
   // retrieved.
@@ -247,29 +300,28 @@ message ProfileQuery {
   // If multiple education filters are specified, profiles that match any
   // education filters are retrieved.
   //
-  // If
-  // [EducationFilter.negated][google.cloud.talent.v4beta1.EducationFilter.negated]
-  // is specified, the result won't contain profiles that match the educations.
+  // If [EducationFilter.negated][google.cloud.talent.v4beta1.EducationFilter.negated] is specified, the result won't contain
+  // profiles that match the educations.
   //
   // For example, search for profiles with a master degree.
   repeated EducationFilter education_filters = 5;
 
-  // Optional. Skill filter specifies skill of profiles to match on.
+  // Skill filter specifies skill of profiles to match on.
   //
   // If a skill filter isn't specified, profiles with any skills are retrieved.
   //
   // If multiple skill filters are specified, profiles that match any skill
   // filters are retrieved.
   //
-  // If [SkillFilter.negated][google.cloud.talent.v4beta1.SkillFilter.negated]
-  // is specified, the result won't contain profiles that match the skills.
+  // If [SkillFilter.negated][google.cloud.talent.v4beta1.SkillFilter.negated] is specified, the result won't contain profiles
+  // that match the skills.
   //
   // For example, search for profiles that have "Java" and "Python" in skill
   // list.
   repeated SkillFilter skill_filters = 6;
 
-  // Optional. Work experience filter specifies the total working experience of
-  // profiles to match on.
+  // Work experience filter specifies the total working experience of profiles
+  // to match on.
   //
   // If a work experience filter isn't specified, profiles with any
   // professional experience are retrieved.
@@ -280,31 +332,27 @@ message ProfileQuery {
   // For example, search for profiles with 10 years of work experience.
   repeated WorkExperienceFilter work_experience_filter = 7;
 
-  // Optional. Time filter specifies the create/update timestamp of the profiles
-  // to match on.
+  // Time filter specifies the create/update timestamp of the profiles to match
+  // on.
   //
   // For example, search for profiles created since "2018-1-1".
   repeated TimeFilter time_filters = 8;
 
-  // Optional. The hirable filter specifies the profile's hirable status to
-  // match on.
+  // The hirable filter specifies the profile's hirable status to match on.
   google.protobuf.BoolValue hirable_filter = 9;
 
-  // Optional. The application date filters specify application date ranges to
-  // match on.
+  // The application date filters specify application date ranges to match on.
   repeated ApplicationDateFilter application_date_filters = 10;
 
-  // Optional. The application outcome notes filters specify the notes for the
-  // outcome of the job application.
+  // The application outcome notes filters specify the notes for the outcome of
+  // the job application.
   repeated ApplicationOutcomeNotesFilter application_outcome_notes_filters = 11;
 
-  // Optional. The application job filters specify the job applied for in the
-  // application.
+  // The application job filters specify the job applied for in the application.
   repeated ApplicationJobFilter application_job_filters = 13;
 
-  // Optional. This filter specifies a structured syntax to match against the
-  // [Profile.custom_attributes][google.cloud.talent.v4beta1.Profile.custom_attributes]
-  // that are marked as `filterable`.
+  // This filter specifies a structured syntax to match against the
+  // [Profile.custom_attributes][google.cloud.talent.v4beta1.Profile.custom_attributes] that are marked as `filterable`.
   //
   // The syntax for this expression is a subset of Google SQL syntax.
   //
@@ -329,12 +377,14 @@ message ProfileQuery {
   // (key1 = "TEST" OR LOWER(key1)="test" OR NOT EMPTY(key1))
   string custom_attribute_filter = 15;
 
-  // Optional. The candidate availability filter which filters based on
-  // availability signals.
+  // Deprecated. Use availability_filters instead.
+  //
+  // The candidate availability filter which filters based on availability
+  // signals.
   //
   // Signal 1: Number of days since most recent job application.  See
-  // [Availability.JobApplicationAvailabilitySignal][google.cloud.talent.v4beta1.Availability.JobApplicationAvailabilitySignal]
-  // for the details of this signal.
+  // [Availability.JobApplicationAvailabilitySignal][google.cloud.talent.v4beta1.Availability.JobApplicationAvailabilitySignal] for the details of this
+  // signal.
   //
   // Signal 2: Number of days since last profile update. See
   // [Availability.ProfileUpdateAvailabilitySignal][google.cloud.talent.v4beta1.Availability.ProfileUpdateAvailabilitySignal]
@@ -345,14 +395,35 @@ message ProfileQuery {
   // based on an aggregated set of signals.  Specifically, the intent is NOT to
   // indicate the candidate's potential qualification / interest / close ability
   // for a specific job.
-  CandidateAvailabilityFilter candidate_availability_filter = 16;
+  CandidateAvailabilityFilter candidate_availability_filter = 16 [deprecated = true];
+
+  // The availability filter which filters based on
+  // [Profile.availability_signals][google.cloud.talent.v4beta1.Profile.availability_signals].
+  //
+  // The availability filter helps a recruiter understand if a
+  // specific candidate is likely to be actively seeking new job opportunities
+  // based on an aggregated set of signals.  Specifically, the intent is NOT to
+  // indicate the candidate's potential qualification / interest / close ability
+  // for a specific job.
+  //
+  // There can be at most one [AvailabilityFilter][google.cloud.talent.v4beta1.AvailabilityFilter] per
+  // [signal_type][google.cloud.talent.v4beta1.AvailabilityFilter.signal_type]. If there are multiple
+  // [AvailabilityFilter][google.cloud.talent.v4beta1.AvailabilityFilter] for a [signal_type][google.cloud.talent.v4beta1.AvailabilityFilter.signal_type],
+  // an error is thrown.
+  repeated AvailabilityFilter availability_filters = 18;
+
+  // Person name filter specifies person name of profiles to match on.
+  //
+  // If multiple person name filters are specified, profiles that match any
+  // person name filters are retrieved.
+  //
+  // For example, search for profiles of candidates with name "John Smith".
+  repeated PersonNameFilter person_name_filters = 17;
 }
 
-// Input only.
-//
 // Geographic region of the search.
 message LocationFilter {
-  // Specify whether including telecommute jobs.
+  // Specify whether to include telecommute jobs.
   enum TelecommutePreference {
     // Default value if the telecommute preference isn't specified.
     TELECOMMUTE_PREFERENCE_UNSPECIFIED = 0;
@@ -364,43 +435,41 @@ message LocationFilter {
     TELECOMMUTE_ALLOWED = 2;
   }
 
-  // Optional. The address name, such as "Mountain View" or "Bay Area".
+  // The address name, such as "Mountain View" or "Bay Area".
   string address = 1;
 
-  // Optional. CLDR region code of the country/region of the address. This is
-  // used to address ambiguity of the user-input location, for example,
-  // "Liverpool" against "Liverpool, NY, US" or "Liverpool, UK".
+  // CLDR region code of the country/region of the address. This is used
+  // to address ambiguity of the user-input location, for example, "Liverpool"
+  // against "Liverpool, NY, US" or "Liverpool, UK".
   //
-  // Set this field if all the jobs to search against are from a same region,
-  // or jobs are world-wide, but the job seeker is from a specific region.
+  // Set this field to bias location resolution toward a specific country
+  // or territory. If this field is not set, application behavior is biased
+  // toward the United States by default.
   //
-  // See http://cldr.unicode.org/ and
-  // http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
+  // See https://cldr.unicode.org/ and
+  // https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
   // for details. Example: "CH" for Switzerland.
   // Note that this filter is not applicable for Profile Search related queries.
   string region_code = 2;
 
-  // Optional. The latitude and longitude of the geographic center from which to
-  // search. This field's ignored if `address` is provided.
+  // The latitude and longitude of the geographic center to search from. This
+  // field is ignored if `address` is provided.
   google.type.LatLng lat_lng = 3;
 
-  // Optional. The distance_in_miles is applied when the location being searched
-  // for is identified as a city or smaller. When the location being searched
-  // for is a state or larger, this field is ignored.
+  // The distance_in_miles is applied when the location being searched for is
+  // identified as a city or smaller. This field is ignored if the location
+  // being searched for is a state or larger.
   double distance_in_miles = 4;
 
-  // Optional. Allows the client to return jobs without a
+  // Allows the client to return jobs without a
   // set location, specifically, telecommuting jobs (telecommuting is considered
   // by the service as a special location.
-  // [Job.posting_region][google.cloud.talent.v4beta1.Job.posting_region]
-  // indicates if a job permits telecommuting. If this field is set to
-  // [TelecommutePreference.TELECOMMUTE_ALLOWED][google.cloud.talent.v4beta1.LocationFilter.TelecommutePreference.TELECOMMUTE_ALLOWED],
-  // telecommuting jobs are searched, and
-  // [address][google.cloud.talent.v4beta1.LocationFilter.address] and
-  // [lat_lng][google.cloud.talent.v4beta1.LocationFilter.lat_lng] are ignored.
-  // If not set or set to
-  // [TelecommutePreference.TELECOMMUTE_EXCLUDED][google.cloud.talent.v4beta1.LocationFilter.TelecommutePreference.TELECOMMUTE_EXCLUDED],
-  // telecommute job are not searched.
+  // [Job.posting_region][google.cloud.talent.v4beta1.Job.posting_region] indicates if a job permits telecommuting.
+  // If this field is set to [TelecommutePreference.TELECOMMUTE_ALLOWED][google.cloud.talent.v4beta1.LocationFilter.TelecommutePreference.TELECOMMUTE_ALLOWED],
+  // telecommuting jobs are searched, and [address][google.cloud.talent.v4beta1.LocationFilter.address] and [lat_lng][google.cloud.talent.v4beta1.LocationFilter.lat_lng] are
+  // ignored. If not set or set to
+  // [TelecommutePreference.TELECOMMUTE_EXCLUDED][google.cloud.talent.v4beta1.LocationFilter.TelecommutePreference.TELECOMMUTE_EXCLUDED], telecommute job are not
+  // searched.
   //
   // This filter can be used by itself to search exclusively for telecommuting
   // jobs, or it can be combined with another location
@@ -408,17 +477,17 @@ message LocationFilter {
   // such as "Mountain View" or "telecommuting" jobs. However, when used in
   // combination with other location filters, telecommuting jobs can be
   // treated as less relevant than other jobs in the search response.
+  //
+  // This field is only used for job search requests.
   TelecommutePreference telecommute_preference = 5;
 
-  // Optional. Whether to apply negation to the filter so profiles matching the
-  // filter are excluded.
+  // Whether to apply negation to the filter so profiles matching the filter
+  // are excluded.
   //
   // Currently only supported in profile search.
   bool negated = 6;
 }
 
-// Input only.
-//
 // Filter on job compensation type and amount.
 message CompensationFilter {
   // Specify the type of filtering.
@@ -428,62 +497,50 @@ message CompensationFilter {
 
     // Filter by `base compensation entry's` unit. A job is a match if and
     // only if the job contains a base CompensationEntry and the base
-    // CompensationEntry's unit matches provided
-    // [units][google.cloud.talent.v4beta1.CompensationFilter.units]. Populate
-    // one or more
-    // [units][google.cloud.talent.v4beta1.CompensationFilter.units].
+    // CompensationEntry's unit matches provided [units][google.cloud.talent.v4beta1.CompensationFilter.units].
+    // Populate one or more [units][google.cloud.talent.v4beta1.CompensationFilter.units].
     //
-    // See
-    // [CompensationInfo.CompensationEntry][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry]
-    // for definition of base compensation entry.
+    // See [CompensationInfo.CompensationEntry][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry] for definition of
+    // base compensation entry.
     UNIT_ONLY = 1;
 
     // Filter by `base compensation entry's` unit and amount / range. A job
     // is a match if and only if the job contains a base CompensationEntry, and
     // the base entry's unit matches provided
-    // [CompensationUnit][google.cloud.talent.v4beta1.CompensationInfo.CompensationUnit]
-    // and amount or range overlaps with provided
+    // [CompensationUnit][google.cloud.talent.v4beta1.CompensationInfo.CompensationUnit] and
+    // amount or range overlaps with provided
     // [CompensationRange][google.cloud.talent.v4beta1.CompensationInfo.CompensationRange].
     //
-    // See
-    // [CompensationInfo.CompensationEntry][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry]
-    // for definition of base compensation entry.
+    // See [CompensationInfo.CompensationEntry][google.cloud.talent.v4beta1.CompensationInfo.CompensationEntry] for definition of
+    // base compensation entry.
     //
-    // Set exactly one
-    // [units][google.cloud.talent.v4beta1.CompensationFilter.units] and
-    // populate [range][google.cloud.talent.v4beta1.CompensationFilter.range].
+    // Set exactly one [units][google.cloud.talent.v4beta1.CompensationFilter.units] and populate [range][google.cloud.talent.v4beta1.CompensationFilter.range].
     UNIT_AND_AMOUNT = 2;
 
     // Filter by annualized base compensation amount and `base compensation
-    // entry's` unit. Populate
-    // [range][google.cloud.talent.v4beta1.CompensationFilter.range] and zero or
-    // more [units][google.cloud.talent.v4beta1.CompensationFilter.units].
+    // entry's` unit. Populate [range][google.cloud.talent.v4beta1.CompensationFilter.range] and zero or more [units][google.cloud.talent.v4beta1.CompensationFilter.units].
     ANNUALIZED_BASE_AMOUNT = 3;
 
     // Filter by annualized total compensation amount and `base compensation
-    // entry's` unit . Populate
-    // [range][google.cloud.talent.v4beta1.CompensationFilter.range] and zero or
-    // more [units][google.cloud.talent.v4beta1.CompensationFilter.units].
+    // entry's` unit . Populate [range][google.cloud.talent.v4beta1.CompensationFilter.range] and zero or more [units][google.cloud.talent.v4beta1.CompensationFilter.units].
     ANNUALIZED_TOTAL_AMOUNT = 4;
   }
 
   // Required. Type of filter.
-  FilterType type = 1;
+  FilterType type = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Required. Specify desired `base compensation entry's`
   // [CompensationInfo.CompensationUnit][google.cloud.talent.v4beta1.CompensationInfo.CompensationUnit].
-  repeated CompensationInfo.CompensationUnit units = 2;
+  repeated CompensationInfo.CompensationUnit units = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional. Compensation range.
+  // Compensation range.
   CompensationInfo.CompensationRange range = 3;
 
-  // Optional. If set to true, jobs with unspecified compensation range fields
-  // are included.
+  // If set to true, jobs with unspecified compensation range fields are
+  // included.
   bool include_jobs_with_unspecified_compensation_range = 4;
 }
 
-// Input only.
-//
 // Parameters needed for commute search.
 message CommuteFilter {
   // The traffic density to use when calculating commute time.
@@ -498,84 +555,69 @@ message CommuteFilter {
     BUSY_HOUR = 2;
   }
 
-  // Required. The method of transportation for which to calculate the commute
-  // time.
-  CommuteMethod commute_method = 1;
+  // Required. The method of transportation to calculate the commute time for.
+  CommuteMethod commute_method = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Required. The latitude and longitude of the location from which to
-  // calculate the commute time.
-  google.type.LatLng start_coordinates = 2;
+  // Required. The latitude and longitude of the location to calculate the
+  // commute time from.
+  google.type.LatLng start_coordinates = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Required. The maximum travel time in seconds. The maximum allowed value is
-  // `3600s` (one hour). Format is `123s`.
-  google.protobuf.Duration travel_duration = 3;
+  // Required. The maximum travel time in seconds. The maximum allowed value is `3600s`
+  // (one hour). Format is `123s`.
+  google.protobuf.Duration travel_duration = 3 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional. If `true`, jobs without street level addresses may also be
-  // returned. For city level addresses, the city center is used. For state and
-  // coarser level addresses, text matching is used. If this field is set to
-  // `false` or isn't specified, only jobs that include street level addresses
-  // will be returned by commute search.
+  // If `true`, jobs without street level addresses may also be returned.
+  // For city level addresses, the city center is used. For state and coarser
+  // level addresses, text matching is used.
+  // If this field is set to `false` or isn't specified, only jobs that include
+  // street level addresses will be returned by commute search.
   bool allow_imprecise_addresses = 4;
 
-  // Optional.
-  //
   // Traffic factor to take into account while searching by commute.
   oneof traffic_option {
-    // Optional. Specifies the traffic density to use when calculating commute
-    // time.
+    // Specifies the traffic density to use when calculating commute time.
     RoadTraffic road_traffic = 5;
 
-    // Optional. The departure time used to calculate traffic impact,
-    // represented as [google.type.TimeOfDay][google.type.TimeOfDay] in local
-    // time zone.
+    // The departure time used to calculate traffic impact, represented as
+    // [google.type.TimeOfDay][google.type.TimeOfDay] in local time zone.
     //
     // Currently traffic model is restricted to hour level resolution.
     google.type.TimeOfDay departure_time = 6;
   }
 }
 
-// Input only.
-//
 // Job title of the search.
 message JobTitleFilter {
-  // Required. The job title, for example, "Software engineer", or "Product
-  // manager".
-  string job_title = 1;
+  // Required. The job title. For example, "Software engineer", or "Product manager".
+  string job_title = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional. Whether to apply negation to the filter so profiles matching the
-  // filter are excluded.
+  // Whether to apply negation to the filter so profiles matching the filter
+  // are excluded.
   bool negated = 2;
 }
 
-// Input only.
-//
 // Skill filter of the search.
 message SkillFilter {
   // Required. The skill name. For example, "java", "j2ee", and so on.
-  string skill = 1;
+  string skill = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional. Whether to apply negation to the filter so profiles matching the
-  // filter are excluded.
+  // Whether to apply negation to the filter so profiles matching the filter
+  // are excluded.
   bool negated = 2;
 }
 
-// Input only.
-//
 // Employer filter of the search.
 message EmployerFilter {
-  // Enum indicating which set of
-  // [Profile.employment_records][google.cloud.talent.v4beta1.Profile.employment_records]
-  // to search against.
+  // Enum indicating which set of [Profile.employment_records][google.cloud.talent.v4beta1.Profile.employment_records] to search
+  // against.
   enum EmployerFilterMode {
     // Default value.
     EMPLOYER_FILTER_MODE_UNSPECIFIED = 0;
 
-    // Apply to all employers in
-    // [Profile.employment_records][google.cloud.talent.v4beta1.Profile.employment_records].
+    // Apply to all employers in [Profile.employment_records][google.cloud.talent.v4beta1.Profile.employment_records].
     ALL_EMPLOYMENT_RECORDS = 1;
 
-    // Apply only to current employer in
-    // [Profile.employment_records][google.cloud.talent.v4beta1.Profile.employment_records].
+    // Apply only to current employer in [Profile.employment_records][google.cloud.talent.v4beta1.Profile.employment_records].
     CURRENT_EMPLOYMENT_RECORDS_ONLY = 2;
 
     // Apply only to past (not current) employers in
@@ -584,121 +626,92 @@ message EmployerFilter {
   }
 
   // Required. The name of the employer, for example "Google", "Alphabet".
-  string employer = 1;
+  string employer = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional. Define set of
-  // [EmploymentRecord][google.cloud.talent.v4beta1.EmploymentRecord]s to search
-  // against.
+  // Define set of [EmploymentRecord][google.cloud.talent.v4beta1.EmploymentRecord]s to search against.
   //
-  // Defaults to
-  // [EmployerFilterMode.ALL_EMPLOYMENT_RECORDS][google.cloud.talent.v4beta1.EmployerFilter.EmployerFilterMode.ALL_EMPLOYMENT_RECORDS].
+  // Defaults to [EmployerFilterMode.ALL_EMPLOYMENT_RECORDS][google.cloud.talent.v4beta1.EmployerFilter.EmployerFilterMode.ALL_EMPLOYMENT_RECORDS].
   EmployerFilterMode mode = 2;
 
-  // Optional. Whether to apply negation to the filter so profiles matching the
-  // filter is excluded.
+  // Whether to apply negation to the filter so profiles matching the filter
+  // is excluded.
   bool negated = 3;
 }
 
-// Input only.
-//
 // Education filter of the search.
 message EducationFilter {
-  // Optional. The school name. For example "MIT", "University of California,
-  // Berkeley".
+  // The school name. For example "MIT", "University of California, Berkeley".
   string school = 1;
 
-  // Optional. The field of study. This is to search against value provided in
+  // The field of study. This is to search against value provided in
   // [Degree.fields_of_study][google.cloud.talent.v4beta1.Degree.fields_of_study].
   // For example "Computer Science", "Mathematics".
   string field_of_study = 2;
 
-  // Optional. Education degree in ISCED code. Each value in degree covers a
-  // specific level of education, without any expansion to upper nor lower
-  // levels of education degree.
+  // Education degree in ISCED code. Each value in degree covers a specific
+  // level of education, without any expansion to upper nor lower levels of
+  // education degree.
   DegreeType degree_type = 3;
 
-  // Optional. Whether to apply negation to the filter so profiles matching the
-  // filter is excluded.
+  // Whether to apply negation to the filter so profiles matching the filter
+  // is excluded.
   bool negated = 6;
 }
 
-// Input only.
-//
 // Work experience filter.
 //
 // This filter is used to search for profiles with working experience length
-// between
-// [min_experience][google.cloud.talent.v4beta1.WorkExperienceFilter.min_experience]
-// and
-// [max_experience][google.cloud.talent.v4beta1.WorkExperienceFilter.max_experience].
+// between [min_experience][google.cloud.talent.v4beta1.WorkExperienceFilter.min_experience] and [max_experience][google.cloud.talent.v4beta1.WorkExperienceFilter.max_experience].
 message WorkExperienceFilter {
-  // Optional. The minimum duration of the work experience (inclusive).
+  // The minimum duration of the work experience (inclusive).
   google.protobuf.Duration min_experience = 1;
 
-  // Optional. The maximum duration of the work experience (exclusive).
+  // The maximum duration of the work experience (exclusive).
   google.protobuf.Duration max_experience = 2;
 }
 
-// Input only.
-//
 // Application Date Range Filter.
 //
-// The API matches profiles with
-// [Application.application_date][google.cloud.talent.v4beta1.Application.application_date]
-// between start date and end date (both boundaries are inclusive). The filter
-// is ignored if both
-// [start_date][google.cloud.talent.v4beta1.ApplicationDateFilter.start_date]
-// and [end_date][google.cloud.talent.v4beta1.ApplicationDateFilter.end_date]
-// are missing.
+// The API matches profiles with [Application.application_date][google.cloud.talent.v4beta1.Application.application_date] between
+// start date and end date (both boundaries are inclusive). The filter is
+// ignored if both [start_date][google.cloud.talent.v4beta1.ApplicationDateFilter.start_date] and [end_date][google.cloud.talent.v4beta1.ApplicationDateFilter.end_date] are missing.
 message ApplicationDateFilter {
-  // Optional. Start date. If it's missing, The API matches profiles with
-  // application date not after the end date.
+  // Start date. If it's missing, The API matches profiles with application date
+  // not after the end date.
   google.type.Date start_date = 1;
 
-  // Optional. End date. If it's missing, The API matches profiles with
-  // application date not before the start date.
+  // End date. If it's missing, The API matches profiles with application date
+  // not before the start date.
   google.type.Date end_date = 2;
 }
 
-// Input only.
-//
 // Outcome Notes Filter.
 message ApplicationOutcomeNotesFilter {
-  // Required. User entered or selected outcome reason. The API does an exact
-  // match on the
-  // [Application.outcome_notes][google.cloud.talent.v4beta1.Application.outcome_notes]
-  // in profiles.
-  string outcome_notes = 1;
-
-  // Optional. If true, The API excludes all candidates with any
-  // [Application.outcome_notes][google.cloud.talent.v4beta1.Application.outcome_notes]
-  // matching the outcome reason specified in the filter.
+  // Required. User entered or selected outcome reason. The API does an exact match on the
+  // [Application.outcome_notes][google.cloud.talent.v4beta1.Application.outcome_notes] in profiles.
+  string outcome_notes = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // If true, The API excludes all candidates with any
+  // [Application.outcome_notes][google.cloud.talent.v4beta1.Application.outcome_notes] matching the outcome reason specified in
+  // the filter.
   bool negated = 2;
 }
 
-// Input only.
-//
 // Filter on the job information of Application.
 message ApplicationJobFilter {
-  // Optional. The job requisition id in the application. The API does an exact
-  // match on the
-  // [Job.requisition_id][google.cloud.talent.v4beta1.Job.requisition_id] of
-  // [Application.job][google.cloud.talent.v4beta1.Application.job] in profiles.
+  // The job requisition id in the application. The API does an exact match on
+  // the [Job.requisition_id][google.cloud.talent.v4beta1.Job.requisition_id] of [Application.job][google.cloud.talent.v4beta1.Application.job] in profiles.
   string job_requisition_id = 2;
 
-  // Optional. The job title in the application. The API does an exact match on
-  // the [Job.title][google.cloud.talent.v4beta1.Job.title] of
-  // [Application.job][google.cloud.talent.v4beta1.Application.job] in profiles.
+  // The job title in the application. The API does an exact match on the
+  // [Job.title][google.cloud.talent.v4beta1.Job.title] of [Application.job][google.cloud.talent.v4beta1.Application.job] in profiles.
   string job_title = 3;
 
-  // Optional. If true, the API excludes all profiles with any
-  // [Application.job][google.cloud.talent.v4beta1.Application.job] matching the
-  // filters.
+  // If true, the API excludes all profiles with any [Application.job][google.cloud.talent.v4beta1.Application.job]
+  // matching the filters.
   bool negated = 4;
 }
 
-// Input only.
-//
 // Filter on create timestamp or update timestamp of profiles.
 message TimeFilter {
   // Time fields can be used in TimeFilter.
@@ -713,28 +726,55 @@ message TimeFilter {
     UPDATE_TIME = 2;
   }
 
-  // Optional. Start timestamp, matching profiles with the start time. If this
-  // field missing, The API matches profiles with create / update timestamp
-  // before the end timestamp.
+  // Start timestamp, matching profiles with the start time. If this field
+  // missing, The API matches profiles with create / update timestamp before the
+  // end timestamp.
   google.protobuf.Timestamp start_time = 1;
 
-  // Optional. End timestamp, matching profiles with the end time. If this field
+  // End timestamp, matching profiles with the end time. If this field
   // missing, The API matches profiles with create / update timestamp after the
   // start timestamp.
   google.protobuf.Timestamp end_time = 2;
 
-  // Optional. Specifies which time field to filter profiles.
+  // Specifies which time field to filter profiles.
   //
-  // Defaults to
-  // [TimeField.CREATE_TIME][google.cloud.talent.v4beta1.TimeFilter.TimeField.CREATE_TIME].
+  // Defaults to [TimeField.CREATE_TIME][google.cloud.talent.v4beta1.TimeFilter.TimeField.CREATE_TIME].
   TimeField time_field = 3;
 }
 
-// Input only
+// Deprecated. Use AvailabilityFilter instead.
 //
 // Filter on availability signals.
 message CandidateAvailabilityFilter {
-  // Optional. It is false by default. If true, API excludes all the potential
-  // available profiles.
+  option deprecated = true;
+
+  // It is false by default. If true, API excludes all the potential available
+  // profiles.
   bool negated = 1;
 }
+
+// Filter on availability signals.
+message AvailabilityFilter {
+  // Required. Type of signal to apply filter on.
+  AvailabilitySignalType signal_type = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Range of times to filter candidate signals by.
+  TimestampRange range = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // If multiple [AvailabilityFilter][google.cloud.talent.v4beta1.AvailabilityFilter] are provided, the default
+  // behavior is to OR all filters, but if this field is set to true, this
+  // particular [AvailabilityFilter][google.cloud.talent.v4beta1.AvailabilityFilter] will be AND'ed against other
+  // [AvailabilityFilter][google.cloud.talent.v4beta1.AvailabilityFilter].
+  bool required = 3;
+}
+
+// Filter on person name.
+message PersonNameFilter {
+  // Required. The person name. For example, "John Smith".
+  //
+  // Can be any combination of [PersonName.structured_name.given_name][],
+  // [PersonName.structured_name.middle_initial][],
+  // [PersonName.structured_name.family_name][], and
+  // [PersonName.formatted_name][google.cloud.talent.v4beta1.PersonName.formatted_name].
+  string person_name = 1 [(google.api.field_behavior) = REQUIRED];
+}
diff --git a/third_party/googleapis/google/cloud/talent/v4beta1/histogram.proto b/third_party/googleapis/google/cloud/talent/v4beta1/histogram.proto
index a4dfdd4e6..109386904 100644
--- a/third_party/googleapis/google/cloud/talent/v4beta1/histogram.proto
+++ b/third_party/googleapis/google/cloud/talent/v4beta1/histogram.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,14 +11,12 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.talent.v4beta1;
 
 import "google/api/annotations.proto";
-import "google/protobuf/wrappers.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
 option java_multiple_files = true;
@@ -26,26 +24,17 @@ option java_outer_classname = "HistogramProto";
 option java_package = "com.google.cloud.talent.v4beta1";
 option objc_class_prefix = "CTS";
 
-// Input Only.
-//
 // The histogram request.
 message HistogramQuery {
   // An expression specifies a histogram request against matching resources
   // (for example, jobs, profiles) for searches.
   //
-  // See
-  // [SearchJobsRequest.histogram_queries][google.cloud.talent.v4beta1.SearchJobsRequest.histogram_queries]
-  // and
-  // [SearchProfilesRequest.histogram_queries][google.cloud.talent.v4beta1.SearchProfilesRequest.histogram_queries]
-  // for details about syntax.
+  // See [SearchJobsRequest.histogram_queries][google.cloud.talent.v4beta1.SearchJobsRequest.histogram_queries] and
+  // [SearchProfilesRequest.histogram_queries][google.cloud.talent.v4beta1.SearchProfilesRequest.histogram_queries] for details about syntax.
   string histogram_query = 1;
 }
 
-// Output only.
-//
-// Histogram result that matches
-// [HistogramQuery][google.cloud.talent.v4beta1.HistogramQuery] specified in
-// searches.
+// Histogram result that matches [HistogramQuery][google.cloud.talent.v4beta1.HistogramQuery] specified in searches.
 message HistogramQueryResult {
   // Requested histogram expression.
   string histogram_query = 1;
diff --git a/third_party/googleapis/google/cloud/talent/v4beta1/job.proto b/third_party/googleapis/google/cloud/talent/v4beta1/job.proto
index 711a4b5be..b2ffa2bc8 100644
--- a/third_party/googleapis/google/cloud/talent/v4beta1/job.proto
+++ b/third_party/googleapis/google/cloud/talent/v4beta1/job.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,17 +11,17 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.talent.v4beta1;
 
-import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/talent/v4beta1/common.proto";
 import "google/protobuf/timestamp.proto";
-import "google/protobuf/wrappers.proto";
 import "google/type/postal_address.proto";
+import "google/api/annotations.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
 option java_multiple_files = true;
@@ -30,20 +30,25 @@ option java_package = "com.google.cloud.talent.v4beta1";
 option objc_class_prefix = "CTS";
 
 // A Job resource represents a job posting (also referred to as a "job listing"
-// or "job requisition"). A job belongs to a
-// [Company][google.cloud.talent.v4beta1.Company], which is the hiring entity
-// responsible for the job.
+// or "job requisition"). A job belongs to a [Company][google.cloud.talent.v4beta1.Company], which is the hiring
+// entity responsible for the job.
 message Job {
+  option (google.api.resource) = {
+    type: "jobs.googleapis.com/Job"
+    pattern: "projects/{project}/tenants/{tenant}/jobs/{job}"
+    pattern: "projects/{project}/jobs/{job}"
+  };
+
   // Application related details of a job posting.
   message ApplicationInfo {
-    // Optional. Use this field to specify email address(es) to which resumes or
+    // Use this field to specify email address(es) to which resumes or
     // applications can be sent.
     //
     // The maximum number of allowed characters for each entry is 255.
     repeated string emails = 1;
 
-    // Optional. Use this field to provide instructions, such as "Mail your
-    // application to ...", that a candidate can follow to apply for the job.
+    // Use this field to provide instructions, such as "Mail your application
+    // to ...", that a candidate can follow to apply for the job.
     //
     // This field accepts and sanitizes HTML input, and also accepts
     // bold, italic, ordered list, and unordered list markup tags.
@@ -51,41 +56,32 @@ message Job {
     // The maximum number of allowed characters is 3,000.
     string instruction = 2;
 
-    // Optional. Use this URI field to direct an applicant to a website, for
-    // example to link to an online application form.
+    // Use this URI field to direct an applicant to a website, for example to
+    // link to an online application form.
     //
     // The maximum number of allowed characters for each entry is 2,000.
     repeated string uris = 3;
   }
 
-  // Output only.
-  //
   // Derived details about the job posting.
   message DerivedInfo {
-    // Structured locations of the job, resolved from
-    // [Job.addresses][google.cloud.talent.v4beta1.Job.addresses].
+    // Structured locations of the job, resolved from [Job.addresses][google.cloud.talent.v4beta1.Job.addresses].
     //
-    // [locations][google.cloud.talent.v4beta1.Job.DerivedInfo.locations] are
-    // exactly matched to
-    // [Job.addresses][google.cloud.talent.v4beta1.Job.addresses] in the same
+    // [locations][google.cloud.talent.v4beta1.Job.DerivedInfo.locations] are exactly matched to [Job.addresses][google.cloud.talent.v4beta1.Job.addresses] in the same
     // order.
     repeated Location locations = 1;
 
-    // Job categories derived from
-    // [Job.title][google.cloud.talent.v4beta1.Job.title] and
-    // [Job.description][google.cloud.talent.v4beta1.Job.description].
+    // Job categories derived from [Job.title][google.cloud.talent.v4beta1.Job.title] and [Job.description][google.cloud.talent.v4beta1.Job.description].
     repeated JobCategory job_categories = 3;
   }
 
-  // Input only.
-  //
   // Options for job processing.
   message ProcessingOptions {
-    // Optional. If set to `true`, the service does not attempt to resolve a
+    // If set to `true`, the service does not attempt to resolve a
     // more precise address for the job.
     bool disable_street_address_resolution = 1;
 
-    // Optional. Option for job HTML content sanitization. Applied fields are:
+    // Option for job HTML content sanitization. Applied fields are:
     //
     // * description
     // * applicationInfo.instruction
@@ -96,8 +92,7 @@ message Job {
     // HTML tags in these fields may be stripped if sanitiazation isn't
     // disabled.
     //
-    // Defaults to
-    // [HtmlSanitization.SIMPLE_FORMATTING_ONLY][google.cloud.talent.v4beta1.HtmlSanitization.SIMPLE_FORMATTING_ONLY].
+    // Defaults to [HtmlSanitization.SIMPLE_FORMATTING_ONLY][google.cloud.talent.v4beta1.HtmlSanitization.SIMPLE_FORMATTING_ONLY].
     HtmlSanitization html_sanitization = 2;
   }
 
@@ -107,57 +102,58 @@ message Job {
   // job is created.
   //
   // The format is
-  // "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}", for
-  // example, "projects/api-test-project/tenants/foo/jobs/1234".
+  // "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". For
+  // example, "projects/foo/tenants/bar/jobs/baz".
   //
-  // Tenant id is optional and the default tenant is used if unspecified, for
-  // example, "projects/api-test-project/jobs/1234".
+  // If tenant id is unspecified, the default tenant is used. For
+  // example, "projects/foo/jobs/bar".
   //
   // Use of this field in job queries and API calls is preferred over the use of
-  // [requisition_id][google.cloud.talent.v4beta1.Job.requisition_id] since this
-  // value is unique.
+  // [requisition_id][google.cloud.talent.v4beta1.Job.requisition_id] since this value is unique.
   string name = 1;
 
   // Required. The resource name of the company listing the job.
   //
   // The format is
-  // "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}", for
-  // example, "projects/api-test-project/tenants/foo/companies/bar".
-  //
-  // Tenant id is optional and the default tenant is used if unspecified, for
-  // example, "projects/api-test-project/companies/bar".
-  string company = 2;
-
-  // Required. The requisition ID, also referred to as the posting ID, is
-  // assigned by the client to identify a job. This field is intended to be used
-  // by clients for client identification and tracking of postings. A job isn't
-  // allowed to be created if there is another job with the same
-  // [company][google.cloud.talent.v4beta1.Job.name],
-  // [language_code][google.cloud.talent.v4beta1.Job.language_code] and
-  // [requisition_id][google.cloud.talent.v4beta1.Job.requisition_id].
+  // "projects/{project_id}/tenants/{tenant_id}/companies/{company_id}". For
+  // example, "projects/foo/tenants/bar/companies/baz".
+  //
+  // If tenant id is unspecified, the default tenant is used. For
+  // example, "projects/foo/companies/bar".
+  string company = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "jobs.googleapis.com/Company"
+    }
+  ];
+
+  // Required. The requisition ID, also referred to as the posting ID, is assigned by the
+  // client to identify a job. This field is intended to be used by clients
+  // for client identification and tracking of postings. A job isn't allowed
+  // to be created if there is another job with the same [company][google.cloud.talent.v4beta1.Job.name],
+  // [language_code][google.cloud.talent.v4beta1.Job.language_code] and [requisition_id][google.cloud.talent.v4beta1.Job.requisition_id].
   //
   // The maximum number of allowed characters is 255.
-  string requisition_id = 3;
+  string requisition_id = 3 [(google.api.field_behavior) = REQUIRED];
 
   // Required. The title of the job, such as "Software Engineer"
   //
   // The maximum number of allowed characters is 500.
-  string title = 4;
+  string title = 4 [(google.api.field_behavior) = REQUIRED];
 
-  // Required. The description of the job, which typically includes a
-  // multi-paragraph description of the company and related information.
-  // Separate fields are provided on the job object for
-  // [responsibilities][google.cloud.talent.v4beta1.Job.responsibilities],
-  // [qualifications][google.cloud.talent.v4beta1.Job.qualifications], and other
-  // job characteristics. Use of these separate job fields is recommended.
+  // Required. The description of the job, which typically includes a multi-paragraph
+  // description of the company and related information. Separate fields are
+  // provided on the job object for [responsibilities][google.cloud.talent.v4beta1.Job.responsibilities],
+  // [qualifications][google.cloud.talent.v4beta1.Job.qualifications], and other job characteristics. Use of
+  // these separate job fields is recommended.
   //
   // This field accepts and sanitizes HTML input, and also accepts
   // bold, italic, ordered list, and unordered list markup tags.
   //
   // The maximum number of allowed characters is 100,000.
-  string description = 5;
+  string description = 5 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional but strongly recommended for the best service experience.
+  // Strongly recommended for the best service experience.
   //
   // Location(s) where the employer is looking to hire for this job posting.
   //
@@ -166,32 +162,28 @@ message Job {
   //
   // At most 50 locations are allowed for best search performance. If a job has
   // more locations, it is suggested to split it into multiple jobs with unique
-  // [requisition_id][google.cloud.talent.v4beta1.Job.requisition_id]s (e.g.
-  // 'ReqA' becomes 'ReqA-1', 'ReqA-2', and so on.) as multiple jobs with the
-  // same [company][google.cloud.talent.v4beta1.Job.company],
-  // [language_code][google.cloud.talent.v4beta1.Job.language_code] and
-  // [requisition_id][google.cloud.talent.v4beta1.Job.requisition_id] are not
-  // allowed. If the original
-  // [requisition_id][google.cloud.talent.v4beta1.Job.requisition_id] must be
-  // preserved, a custom field should be used for storage. It is also suggested
-  // to group the locations that close to each other in the same job for better
-  // search experience.
+  // [requisition_id][google.cloud.talent.v4beta1.Job.requisition_id]s (e.g. 'ReqA' becomes 'ReqA-1', 'ReqA-2', and so on.) as
+  // multiple jobs with the same [company][google.cloud.talent.v4beta1.Job.company], [language_code][google.cloud.talent.v4beta1.Job.language_code] and
+  // [requisition_id][google.cloud.talent.v4beta1.Job.requisition_id] are not allowed. If the original [requisition_id][google.cloud.talent.v4beta1.Job.requisition_id] must
+  // be preserved, a custom field should be used for storage. It is also
+  // suggested to group the locations that close to each other in the same job
+  // for better search experience.
   //
   // The maximum number of allowed characters is 500.
   repeated string addresses = 6;
 
-  // Optional. Job application information.
+  // Job application information.
   ApplicationInfo application_info = 7;
 
-  // Optional. The benefits included with the job.
+  // The benefits included with the job.
   repeated JobBenefit job_benefits = 8;
 
-  // Optional. Job compensation information (a.k.a. "pay rate") i.e., the
-  // compensation that will paid to the employee.
+  // Job compensation information (a.k.a. "pay rate") i.e., the compensation
+  // that will paid to the employee.
   CompensationInfo compensation_info = 9;
 
-  // Optional. A map of fields to hold both filterable and non-filterable custom
-  // job attributes that are not covered by the provided structured fields.
+  // A map of fields to hold both filterable and non-filterable custom job
+  // attributes that are not covered by the provided structured fields.
   //
   // The keys of the map are strings up to 64 bytes and must match the
   // pattern: [a-zA-Z][a-zA-Z0-9_]*. For example, key0LikeThis or
@@ -204,28 +196,27 @@ message Job {
   // is 50KB.
   map custom_attributes = 10;
 
-  // Optional. The desired education degrees for the job, such as Bachelors,
-  // Masters.
+  // The desired education degrees for the job, such as Bachelors, Masters.
   repeated DegreeType degree_types = 11;
 
-  // Optional. The department or functional area within the company with the
-  // open position.
+  // The department or functional area within the company with the open
+  // position.
   //
   // The maximum number of allowed characters is 255.
   string department = 12;
 
-  // Optional. The employment type(s) of a job, for example,
+  // The employment type(s) of a job, for example,
   // [full time][google.cloud.talent.v4beta1.EmploymentType.FULL_TIME] or
   // [part time][google.cloud.talent.v4beta1.EmploymentType.PART_TIME].
   repeated EmploymentType employment_types = 13;
 
-  // Optional. A description of bonus, commission, and other compensation
+  // A description of bonus, commission, and other compensation
   // incentives associated with the job not including salary or pay.
   //
   // The maximum number of allowed characters is 10,000.
   string incentives = 14;
 
-  // Optional. The language of the posting. This field is distinct from
+  // The language of the posting. This field is distinct from
   // any requirements for fluency that are associated with the job.
   //
   // Language codes must be in BCP-47 format, such as "en-US" or "sr-Latn".
@@ -233,18 +224,15 @@ message Job {
   // [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47){:
   // class="external" target="_blank" }.
   //
-  // If this field is unspecified and
-  // [Job.description][google.cloud.talent.v4beta1.Job.description] is present,
-  // detected language code based on
-  // [Job.description][google.cloud.talent.v4beta1.Job.description] is assigned,
-  // otherwise defaults to 'en_US'.
+  // If this field is unspecified and [Job.description][google.cloud.talent.v4beta1.Job.description] is present, detected
+  // language code based on [Job.description][google.cloud.talent.v4beta1.Job.description] is assigned, otherwise
+  // defaults to 'en_US'.
   string language_code = 15;
 
-  // Optional. The experience level associated with the job, such as "Entry
-  // Level".
+  // The experience level associated with the job, such as "Entry Level".
   JobLevel job_level = 16;
 
-  // Optional. A promotion value of the job, as determined by the client.
+  // A promotion value of the job, as determined by the client.
   // The value determines the sort order of the jobs returned when searching for
   // jobs using the featured jobs search call, with higher promotional values
   // being returned first and ties being resolved by relevance sort. Only the
@@ -253,10 +241,9 @@ message Job {
   // Default value is 0, and negative values are treated as 0.
   int32 promotion_value = 17;
 
-  // Optional. A description of the qualifications required to perform the
+  // A description of the qualifications required to perform the
   // job. The use of this field is recommended
-  // as an alternative to using the more general
-  // [description][google.cloud.talent.v4beta1.Job.description] field.
+  // as an alternative to using the more general [description][google.cloud.talent.v4beta1.Job.description] field.
   //
   // This field accepts and sanitizes HTML input, and also accepts
   // bold, italic, ordered list, and unordered list markup tags.
@@ -264,9 +251,9 @@ message Job {
   // The maximum number of allowed characters is 10,000.
   string qualifications = 18;
 
-  // Optional. A description of job responsibilities. The use of this field is
-  // recommended as an alternative to using the more general
-  // [description][google.cloud.talent.v4beta1.Job.description] field.
+  // A description of job responsibilities. The use of this field is
+  // recommended as an alternative to using the more general [description][google.cloud.talent.v4beta1.Job.description]
+  // field.
   //
   // This field accepts and sanitizes HTML input, and also accepts
   // bold, italic, ordered list, and unordered list markup tags.
@@ -274,55 +261,46 @@ message Job {
   // The maximum number of allowed characters is 10,000.
   string responsibilities = 19;
 
-  // Optional. The job
-  // [PostingRegion][google.cloud.talent.v4beta1.PostingRegion] (for example,
-  // state, country) throughout which the job is available. If this field is
-  // set, a [LocationFilter][google.cloud.talent.v4beta1.LocationFilter] in a
-  // search query within the job region finds this job posting if an exact
-  // location match isn't specified. If this field is set to
-  // [PostingRegion.NATION][google.cloud.talent.v4beta1.PostingRegion.NATION] or
-  // [PostingRegion.ADMINISTRATIVE_AREA][google.cloud.talent.v4beta1.PostingRegion.ADMINISTRATIVE_AREA],
-  // setting job [Job.addresses][google.cloud.talent.v4beta1.Job.addresses] to
-  // the same location level as this field is strongly recommended.
+  // The job [PostingRegion][google.cloud.talent.v4beta1.PostingRegion] (for example, state, country) throughout
+  // which the job is available. If this field is set, a [LocationFilter][google.cloud.talent.v4beta1.LocationFilter]
+  // in a search query within the job region finds this job posting if an
+  // exact location match isn't specified. If this field is set to
+  // [PostingRegion.NATION][google.cloud.talent.v4beta1.PostingRegion.NATION] or [PostingRegion.ADMINISTRATIVE_AREA][google.cloud.talent.v4beta1.PostingRegion.ADMINISTRATIVE_AREA],
+  // setting job [Job.addresses][google.cloud.talent.v4beta1.Job.addresses] to the same location level as this field
+  // is strongly recommended.
   PostingRegion posting_region = 20;
 
-  // Optional. The visibility of the job.
+  // Deprecated. The job is only visible to the owner.
   //
-  // Defaults to
-  // [Visibility.ACCOUNT_ONLY][google.cloud.talent.v4beta1.Visibility.ACCOUNT_ONLY]
-  // if not specified.
-  Visibility visibility = 21;
+  // The visibility of the job.
+  //
+  // Defaults to [Visibility.ACCOUNT_ONLY][google.cloud.talent.v4beta1.Visibility.ACCOUNT_ONLY] if not specified.
+  Visibility visibility = 21 [deprecated = true];
 
-  // Optional. The start timestamp of the job in UTC time zone. Typically this
-  // field is used for contracting engagements. Invalid timestamps are ignored.
+  // The start timestamp of the job in UTC time zone. Typically this field
+  // is used for contracting engagements. Invalid timestamps are ignored.
   google.protobuf.Timestamp job_start_time = 22;
 
-  // Optional. The end timestamp of the job. Typically this field is used for
-  // contracting engagements. Invalid timestamps are ignored.
+  // The end timestamp of the job. Typically this field is used for contracting
+  // engagements. Invalid timestamps are ignored.
   google.protobuf.Timestamp job_end_time = 23;
 
-  // Optional. The timestamp this job posting was most recently published. The
-  // default value is the time the request arrives at the server. Invalid
-  // timestamps are ignored.
+  // The timestamp this job posting was most recently published. The default
+  // value is the time the request arrives at the server. Invalid timestamps are
+  // ignored.
   google.protobuf.Timestamp posting_publish_time = 24;
 
-  // Optional but strongly recommended for the best service
-  // experience.
+  // Strongly recommended for the best service experience.
   //
   // The expiration timestamp of the job. After this timestamp, the
   // job is marked as expired, and it no longer appears in search results. The
-  // expired job can't be listed by the
-  // [ListJobs][google.cloud.talent.v4beta1.JobService.ListJobs] API, but it can
-  // be retrieved with the
-  // [GetJob][google.cloud.talent.v4beta1.JobService.GetJob] API or updated with
-  // the [UpdateJob][google.cloud.talent.v4beta1.JobService.UpdateJob] API or
-  // deleted with the
-  // [DeleteJob][google.cloud.talent.v4beta1.JobService.DeleteJob] API. An
-  // expired job can be updated and opened again by using a future expiration
-  // timestamp. Updating an expired job fails if there is another existing open
-  // job with same [company][google.cloud.talent.v4beta1.Job.company],
-  // [language_code][google.cloud.talent.v4beta1.Job.language_code] and
-  // [requisition_id][google.cloud.talent.v4beta1.Job.requisition_id].
+  // expired job can't be listed by the [ListJobs][google.cloud.talent.v4beta1.JobService.ListJobs] API,
+  // but it can be retrieved with the [GetJob][google.cloud.talent.v4beta1.JobService.GetJob] API or
+  // updated with the [UpdateJob][google.cloud.talent.v4beta1.JobService.UpdateJob] API or deleted with
+  // the [DeleteJob][google.cloud.talent.v4beta1.JobService.DeleteJob] API. An expired job can
+  // be updated and opened again by using a future expiration timestamp.
+  // Updating an expired job fails if there is another existing open job with
+  // same [company][google.cloud.talent.v4beta1.Job.company], [language_code][google.cloud.talent.v4beta1.Job.language_code] and [requisition_id][google.cloud.talent.v4beta1.Job.requisition_id].
   //
   // The expired jobs are retained in our system for 90 days. However, the
   // overall expired job count cannot exceed 3 times the maximum number of
@@ -336,13 +314,12 @@ message Job {
   // If the timestamp is before the instant request is made, the job
   // is treated as expired immediately on creation. This kind of job can
   // not be updated. And when creating a job with past timestamp, the
-  // [posting_publish_time][google.cloud.talent.v4beta1.Job.posting_publish_time]
-  // must be set before
-  // [posting_expire_time][google.cloud.talent.v4beta1.Job.posting_expire_time].
-  // The purpose of this feature is to allow other objects, such as
-  // [Application][google.cloud.talent.v4beta1.Application], to refer a job that
-  // didn't exist in the system prior to becoming expired. If you want to modify
-  // a job that was expired on creation, delete it and create a new one.
+  // [posting_publish_time][google.cloud.talent.v4beta1.Job.posting_publish_time] must be set before
+  // [posting_expire_time][google.cloud.talent.v4beta1.Job.posting_expire_time]. The purpose of this feature is
+  // to allow other objects, such as [Application][google.cloud.talent.v4beta1.Application], to refer a job
+  // that didn't exist in the system prior to becoming expired. If you
+  // want to modify a job that was expired on creation,
+  // delete it and create a new one.
   //
   // If this value isn't provided at the time of job creation or is invalid,
   // the job posting expires after 30 days from the job's creation time. For
@@ -350,27 +327,24 @@ message Job {
   // unspecified expiration date, the job expires after 2017/01/31 13:00AM UTC.
   //
   // If this value isn't provided on job update, it depends on the field masks
-  // set by
-  // [UpdateJobRequest.update_mask][google.cloud.talent.v4beta1.UpdateJobRequest.update_mask].
-  // If the field masks include
-  // [job_end_time][google.cloud.talent.v4beta1.Job.job_end_time], or the masks
-  // are empty meaning that every field is updated, the job posting expires
-  // after 30 days from the job's last update time. Otherwise the expiration
-  // date isn't updated.
+  // set by [UpdateJobRequest.update_mask][google.cloud.talent.v4beta1.UpdateJobRequest.update_mask]. If the field masks include
+  // [job_end_time][google.cloud.talent.v4beta1.Job.job_end_time], or the masks are empty meaning that every field is
+  // updated, the job posting expires after 30 days from the job's last
+  // update time. Otherwise the expiration date isn't updated.
   google.protobuf.Timestamp posting_expire_time = 25;
 
   // Output only. The timestamp when this job posting was created.
-  google.protobuf.Timestamp posting_create_time = 26;
+  google.protobuf.Timestamp posting_create_time = 26 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The timestamp when this job posting was last updated.
-  google.protobuf.Timestamp posting_update_time = 27;
+  google.protobuf.Timestamp posting_update_time = 27 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Display name of the company listing the job.
-  string company_display_name = 28;
+  string company_display_name = 28 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Derived details about the job posting.
-  DerivedInfo derived_info = 29;
+  DerivedInfo derived_info = 29 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // Optional. Options for job processing.
+  // Options for job processing.
   ProcessingOptions processing_options = 30;
 }
diff --git a/third_party/googleapis/google/cloud/talent/v4beta1/job_service.proto b/third_party/googleapis/google/cloud/talent/v4beta1/job_service.proto
index 1b0d8bfeb..148e64865 100644
--- a/third_party/googleapis/google/cloud/talent/v4beta1/job_service.proto
+++ b/third_party/googleapis/google/cloud/talent/v4beta1/job_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -19,15 +18,18 @@ package google.cloud.talent.v4beta1;
 
 import "google/api/annotations.proto";
 import "google/api/client.proto";
-import "google/cloud/talent/v4beta1/batch.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/talent/v4beta1/common.proto";
 import "google/cloud/talent/v4beta1/filters.proto";
 import "google/cloud/talent/v4beta1/histogram.proto";
 import "google/cloud/talent/v4beta1/job.proto";
 import "google/longrunning/operations.proto";
+import "google/protobuf/any.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
+import "google/rpc/status.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
 option java_multiple_files = true;
@@ -55,6 +57,24 @@ service JobService {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "parent,job";
+  }
+
+  // Begins executing a batch create jobs operation.
+  rpc BatchCreateJobs(BatchCreateJobsRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v4beta1/{parent=projects/*/tenants/*}/jobs:batchCreate"
+      body: "*"
+      additional_bindings {
+        post: "/v4beta1/{parent=projects/*}/jobs:batchCreate"
+        body: "*"
+      }
+    };
+    option (google.api.method_signature) = "parent,jobs";
+    option (google.longrunning.operation_info) = {
+      response_type: "JobOperationResult"
+      metadata_type: "BatchOperationMetadata"
+    };
   }
 
   // Retrieves the specified job, whose status is OPEN or recently EXPIRED
@@ -62,8 +82,11 @@ service JobService {
   rpc GetJob(GetJobRequest) returns (Job) {
     option (google.api.http) = {
       get: "/v4beta1/{name=projects/*/tenants/*/jobs/*}"
-      additional_bindings { get: "/v4beta1/{name=projects/*/jobs/*}" }
+      additional_bindings {
+        get: "/v4beta1/{name=projects/*/jobs/*}"
+      }
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Updates specified job.
@@ -79,6 +102,24 @@ service JobService {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "job";
+  }
+
+  // Begins executing a batch update jobs operation.
+  rpc BatchUpdateJobs(BatchUpdateJobsRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v4beta1/{parent=projects/*/tenants/*}/jobs:batchUpdate"
+      body: "*"
+      additional_bindings {
+        post: "/v4beta1/{parent=projects/*}/jobs:batchUpdate"
+        body: "*"
+      }
+    };
+    option (google.api.method_signature) = "parent,jobs";
+    option (google.longrunning.operation_info) = {
+      response_type: "JobOperationResult"
+      metadata_type: "BatchOperationMetadata"
+    };
   }
 
   // Deletes the specified job.
@@ -88,16 +129,11 @@ service JobService {
   rpc DeleteJob(DeleteJobRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v4beta1/{name=projects/*/tenants/*/jobs/*}"
-      additional_bindings { delete: "/v4beta1/{name=projects/*/jobs/*}" }
-    };
-  }
-
-  // Lists jobs by filter.
-  rpc ListJobs(ListJobsRequest) returns (ListJobsResponse) {
-    option (google.api.http) = {
-      get: "/v4beta1/{parent=projects/*/tenants/*}/jobs"
-      additional_bindings { get: "/v4beta1/{parent=projects/*}/jobs" }
+      additional_bindings {
+        delete: "/v4beta1/{name=projects/*/jobs/*}"
+      }
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Deletes a list of [Job][google.cloud.talent.v4beta1.Job]s by filter.
@@ -109,15 +145,25 @@ service JobService {
         post: "/v4beta1/{parent=projects/*}/jobs:batchDelete"
       }
     };
+    option (google.api.method_signature) = "parent,filter";
+  }
+
+  // Lists jobs by filter.
+  rpc ListJobs(ListJobsRequest) returns (ListJobsResponse) {
+    option (google.api.http) = {
+      get: "/v4beta1/{parent=projects/*/tenants/*}/jobs"
+      additional_bindings {
+        get: "/v4beta1/{parent=projects/*}/jobs"
+      }
+    };
+    option (google.api.method_signature) = "parent,filter";
   }
 
-  // Searches for jobs using the provided
-  // [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest].
+  // Searches for jobs using the provided [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest].
   //
-  // This call constrains the
-  // [visibility][google.cloud.talent.v4beta1.Job.visibility] of jobs present in
-  // the database, and only returns jobs that the caller has permission to
-  // search against.
+  // This call constrains the [visibility][google.cloud.talent.v4beta1.Job.visibility] of jobs
+  // present in the database, and only returns jobs that the caller has
+  // permission to search against.
   rpc SearchJobs(SearchJobsRequest) returns (SearchJobsResponse) {
     option (google.api.http) = {
       post: "/v4beta1/{parent=projects/*/tenants/*}/jobs:search"
@@ -129,18 +175,16 @@ service JobService {
     };
   }
 
-  // Searches for jobs using the provided
-  // [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest].
+  // Searches for jobs using the provided [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest].
   //
   // This API call is intended for the use case of targeting passive job
   // seekers (for example, job seekers who have signed up to receive email
   // alerts about potential job opportunities), and has different algorithmic
   // adjustments that are targeted to passive job seekers.
   //
-  // This call constrains the
-  // [visibility][google.cloud.talent.v4beta1.Job.visibility] of jobs present in
-  // the database, and only returns jobs the caller has permission to search
-  // against.
+  // This call constrains the [visibility][google.cloud.talent.v4beta1.Job.visibility] of jobs
+  // present in the database, and only returns jobs the caller has
+  // permission to search against.
   rpc SearchJobsForAlert(SearchJobsRequest) returns (SearchJobsResponse) {
     option (google.api.http) = {
       post: "/v4beta1/{parent=projects/*/tenants/*}/jobs:searchForAlert"
@@ -151,113 +195,90 @@ service JobService {
       }
     };
   }
-
-  // Begins executing a batch create jobs operation.
-  rpc BatchCreateJobs(BatchCreateJobsRequest)
-      returns (google.longrunning.Operation) {
-    option (google.api.http) = {
-      post: "/v4beta1/{parent=projects/*/tenants/*}/jobs:batchCreate"
-      body: "*"
-      additional_bindings {
-        post: "/v4beta1/{parent=projects/*}/jobs:batchCreate"
-        body: "*"
-      }
-    };
-  }
-
-  // Begins executing a batch update jobs operation.
-  rpc BatchUpdateJobs(BatchUpdateJobsRequest)
-      returns (google.longrunning.Operation) {
-    option (google.api.http) = {
-      post: "/v4beta1/{parent=projects/*/tenants/*}/jobs:batchUpdate"
-      body: "*"
-      additional_bindings {
-        post: "/v4beta1/{parent=projects/*}/jobs:batchUpdate"
-        body: "*"
-      }
-    };
-  }
 }
 
-// Input only.
-//
 // Create job request.
 message CreateJobRequest {
   // Required. The resource name of the tenant under which the job is created.
   //
-  // The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-  // "projects/api-test-project/tenant/foo".
-  //
-  // Tenant id is optional and a default tenant is created if unspecified, for
-  // example, "projects/api-test-project".
-  string parent = 1;
+  // The format is "projects/{project_id}/tenants/{tenant_id}". For example,
+  // "projects/foo/tenant/bar". If tenant id is unspecified a default tenant
+  // is created. For example, "projects/foo".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "jobs.googleapis.com/Job"
+    }
+  ];
 
   // Required. The Job to be created.
-  Job job = 2;
+  Job job = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
-// Input only.
-//
 // Get job request.
 message GetJobRequest {
   // Required. The resource name of the job to retrieve.
   //
   // The format is
-  // "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}", for
-  // example, "projects/api-test-project/tenants/foo/jobs/1234".
-  //
-  // Tenant id is optional and the default tenant is used if unspecified, for
-  // example, "projects/api-test-project/jobs/1234".
-  string name = 1;
+  // "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". For
+  // example, "projects/foo/tenants/bar/jobs/baz".
+  //
+  // If tenant id is unspecified, the default tenant is used. For
+  // example, "projects/foo/jobs/bar".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "jobs.googleapis.com/Job"
+    }
+  ];
 }
 
-// Input only.
-//
 // Update job request.
 message UpdateJobRequest {
   // Required. The Job to be updated.
-  Job job = 1;
+  Job job = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional but strongly recommended to be provided for the best service
-  // experience.
+  // Strongly recommended for the best service experience.
   //
-  // If [update_mask][google.cloud.talent.v4beta1.UpdateJobRequest.update_mask]
-  // is provided, only the specified fields in
-  // [job][google.cloud.talent.v4beta1.UpdateJobRequest.job] are updated.
-  // Otherwise all the fields are updated.
+  // If [update_mask][google.cloud.talent.v4beta1.UpdateJobRequest.update_mask] is provided, only the specified fields in
+  // [job][google.cloud.talent.v4beta1.UpdateJobRequest.job] are updated. Otherwise all the fields are updated.
   //
   // A field mask to restrict the fields that are updated. Only
   // top level fields of [Job][google.cloud.talent.v4beta1.Job] are supported.
   google.protobuf.FieldMask update_mask = 2;
 }
 
-// Input only.
-//
 // Delete job request.
 message DeleteJobRequest {
   // Required. The resource name of the job to be deleted.
   //
   // The format is
-  // "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}", for
-  // example, "projects/api-test-project/tenants/foo/jobs/1234".
-  //
-  // Tenant id is optional and the default tenant is used if unspecified, for
-  // example, "projects/api-test-project/jobs/1234".
-  string name = 1;
+  // "projects/{project_id}/tenants/{tenant_id}/jobs/{job_id}". For
+  // example, "projects/foo/tenants/bar/jobs/baz".
+  //
+  // If tenant id is unspecified, the default tenant is used. For
+  // example, "projects/foo/jobs/bar".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "jobs.googleapis.com/Job"
+    }
+  ];
 }
 
-// Input only.
-//
 // Batch delete jobs request.
 message BatchDeleteJobsRequest {
   // Required. The resource name of the tenant under which the job is created.
   //
-  // The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-  // "projects/api-test-project/tenant/foo".
-  //
-  // Tenant id is optional and the default tenant is used if unspecified, for
-  // example, "projects/api-test-project".
-  string parent = 1;
+  // The format is "projects/{project_id}/tenants/{tenant_id}". For example,
+  // "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant
+  // is created. For example, "projects/foo".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "jobs.googleapis.com/Job"
+    }
+  ];
 
   // Required. The filter string specifies the jobs to be deleted.
   //
@@ -268,23 +289,24 @@ message BatchDeleteJobsRequest {
   // * `companyName` (Required)
   // * `requisitionId` (Required)
   //
-  // Sample Query: companyName = "projects/api-test-project/companies/123" AND
+  // Sample Query: companyName = "projects/foo/companies/bar" AND
   // requisitionId = "req-1"
-  string filter = 2;
+  string filter = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
-// Input only.
-//
 // List jobs request.
 message ListJobsRequest {
   // Required. The resource name of the tenant under which the job is created.
   //
-  // The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-  // "projects/api-test-project/tenant/foo".
-  //
-  // Tenant id is optional and the default tenant is used if unspecified, for
-  // example, "projects/api-test-project".
-  string parent = 1;
+  // The format is "projects/{project_id}/tenants/{tenant_id}". For example,
+  // "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant
+  // is created. For example, "projects/foo".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "jobs.googleapis.com/Job"
+    }
+  ];
 
   // Required. The filter string specifies the jobs to be enumerated.
   //
@@ -293,80 +315,62 @@ message ListJobsRequest {
   // The fields eligible for filtering are:
   //
   // * `companyName` (Required)
-  // * `requisitionId` (Optional)
-  // * `status` (Optional) Available values: OPEN, EXPIRED, ALL. Defaults to
+  // * `requisitionId`
+  // * `status` Available values: OPEN, EXPIRED, ALL. Defaults to
   // OPEN if no value is specified.
   //
   // Sample Query:
   //
-  // * companyName = "projects/api-test-project/tenants/foo/companies/bar"
-  // * companyName = "projects/api-test-project/tenants/foo/companies/bar" AND
+  // * companyName = "projects/foo/tenants/bar/companies/baz"
+  // * companyName = "projects/foo/tenants/bar/companies/baz" AND
   // requisitionId = "req-1"
-  // * companyName = "projects/api-test-project/tenants/foo/companies/bar" AND
+  // * companyName = "projects/foo/tenants/bar/companies/baz" AND
   // status = "EXPIRED"
-  string filter = 2;
+  string filter = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional. The starting point of a query result.
+  // The starting point of a query result.
   string page_token = 3;
 
-  // Optional. The maximum number of jobs to be returned per page of results.
+  // The maximum number of jobs to be returned per page of results.
   //
-  // If [job_view][google.cloud.talent.v4beta1.ListJobsRequest.job_view] is set
-  // to
-  // [JobView.JOB_VIEW_ID_ONLY][google.cloud.talent.v4beta1.JobView.JOB_VIEW_ID_ONLY],
-  // the maximum allowed page size is 1000. Otherwise, the maximum allowed page
-  // size is 100.
+  // If [job_view][google.cloud.talent.v4beta1.ListJobsRequest.job_view] is set to [JobView.JOB_VIEW_ID_ONLY][google.cloud.talent.v4beta1.JobView.JOB_VIEW_ID_ONLY], the maximum allowed
+  // page size is 1000. Otherwise, the maximum allowed page size is 100.
   //
   // Default is 100 if empty or a number < 1 is specified.
   int32 page_size = 4;
 
-  // Optional. The desired job attributes returned for jobs in the
-  // search response. Defaults to
-  // [JobView.JOB_VIEW_FULL][google.cloud.talent.v4beta1.JobView.JOB_VIEW_FULL]
-  // if no value is specified.
+  // The desired job attributes returned for jobs in the
+  // search response. Defaults to [JobView.JOB_VIEW_FULL][google.cloud.talent.v4beta1.JobView.JOB_VIEW_FULL] if no value is
+  // specified.
   JobView job_view = 5;
 }
 
 // An enum that specifies the job attributes that are returned in the
-// [MatchingJob.job][google.cloud.talent.v4beta1.SearchJobsResponse.MatchingJob.job]
-// or [ListJobsResponse.jobs][google.cloud.talent.v4beta1.ListJobsResponse.jobs]
-// fields.
+// [MatchingJob.job][google.cloud.talent.v4beta1.SearchJobsResponse.MatchingJob.job] or
+// [ListJobsResponse.jobs][google.cloud.talent.v4beta1.ListJobsResponse.jobs] fields.
 enum JobView {
   // Default value.
   JOB_VIEW_UNSPECIFIED = 0;
 
   // A ID only view of job, with following attributes:
-  // [Job.name][google.cloud.talent.v4beta1.Job.name],
-  // [Job.requisition_id][google.cloud.talent.v4beta1.Job.requisition_id],
-  // [Job.language_code][google.cloud.talent.v4beta1.Job.language_code].
+  // [Job.name][google.cloud.talent.v4beta1.Job.name], [Job.requisition_id][google.cloud.talent.v4beta1.Job.requisition_id], [Job.language_code][google.cloud.talent.v4beta1.Job.language_code].
   JOB_VIEW_ID_ONLY = 1;
 
   // A minimal view of the job, with the following attributes:
-  // [Job.name][google.cloud.talent.v4beta1.Job.name],
-  // [Job.requisition_id][google.cloud.talent.v4beta1.Job.requisition_id],
-  // [Job.title][google.cloud.talent.v4beta1.Job.title],
-  // [Job.company][google.cloud.talent.v4beta1.Job.company],
-  // [Job.DerivedInfo.locations][google.cloud.talent.v4beta1.Job.DerivedInfo.locations],
-  // [Job.language_code][google.cloud.talent.v4beta1.Job.language_code].
+  // [Job.name][google.cloud.talent.v4beta1.Job.name], [Job.requisition_id][google.cloud.talent.v4beta1.Job.requisition_id], [Job.title][google.cloud.talent.v4beta1.Job.title],
+  // [Job.company][google.cloud.talent.v4beta1.Job.company], [Job.DerivedInfo.locations][google.cloud.talent.v4beta1.Job.DerivedInfo.locations], [Job.language_code][google.cloud.talent.v4beta1.Job.language_code].
   JOB_VIEW_MINIMAL = 2;
 
   // A small view of the job, with the following attributes in the search
-  // results: [Job.name][google.cloud.talent.v4beta1.Job.name],
-  // [Job.requisition_id][google.cloud.talent.v4beta1.Job.requisition_id],
-  // [Job.title][google.cloud.talent.v4beta1.Job.title],
-  // [Job.company][google.cloud.talent.v4beta1.Job.company],
-  // [Job.DerivedInfo.locations][google.cloud.talent.v4beta1.Job.DerivedInfo.locations],
-  // [Job.visibility][google.cloud.talent.v4beta1.Job.visibility],
-  // [Job.language_code][google.cloud.talent.v4beta1.Job.language_code],
-  // [Job.description][google.cloud.talent.v4beta1.Job.description].
+  // results: [Job.name][google.cloud.talent.v4beta1.Job.name], [Job.requisition_id][google.cloud.talent.v4beta1.Job.requisition_id], [Job.title][google.cloud.talent.v4beta1.Job.title],
+  // [Job.company][google.cloud.talent.v4beta1.Job.company], [Job.DerivedInfo.locations][google.cloud.talent.v4beta1.Job.DerivedInfo.locations], [Job.visibility][google.cloud.talent.v4beta1.Job.visibility],
+  // [Job.language_code][google.cloud.talent.v4beta1.Job.language_code], [Job.description][google.cloud.talent.v4beta1.Job.description].
   JOB_VIEW_SMALL = 3;
 
   // All available attributes are included in the search results.
   JOB_VIEW_FULL = 4;
 }
 
-// Output only.
-//
 // List jobs response.
 message ListJobsResponse {
   // The Jobs for a given company.
@@ -383,17 +387,11 @@ message ListJobsResponse {
   ResponseMetadata metadata = 3;
 }
 
-// Input only.
-//
 // The Request body of the `SearchJobs` call.
 message SearchJobsRequest {
-  // Input only.
-  //
-  // Custom ranking information for
-  // [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest].
+  // Custom ranking information for [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest].
   message CustomRankingInfo {
-    // The importance level for
-    // [CustomRankingInfo.ranking_expression][google.cloud.talent.v4beta1.SearchJobsRequest.CustomRankingInfo.ranking_expression].
+    // The importance level for [CustomRankingInfo.ranking_expression][google.cloud.talent.v4beta1.SearchJobsRequest.CustomRankingInfo.ranking_expression].
     enum ImportanceLevel {
       // Default value if the importance level isn't specified.
       IMPORTANCE_LEVEL_UNSPECIFIED = 0;
@@ -430,37 +428,41 @@ message SearchJobsRequest {
     }
 
     // Required. Controls over how important the score of
-    // [CustomRankingInfo.ranking_expression][google.cloud.talent.v4beta1.SearchJobsRequest.CustomRankingInfo.ranking_expression]
-    // gets applied to job's final ranking position.
+    // [CustomRankingInfo.ranking_expression][google.cloud.talent.v4beta1.SearchJobsRequest.CustomRankingInfo.ranking_expression] gets applied to job's final
+    // ranking position.
     //
     // An error is thrown if not specified.
-    ImportanceLevel importance_level = 1;
+    ImportanceLevel importance_level = 1 [(google.api.field_behavior) = REQUIRED];
 
-    // Required. Controls over how job documents get ranked on top of existing
-    // relevance score (determined by API algorithm). The product of ranking
+    // Required. Controls over how job documents get ranked on top of existing relevance
+    // score (determined by API algorithm). A combination of the ranking
     // expression and relevance score is used to determine job's final ranking
     // position.
     //
     // The syntax for this expression is a subset of Google SQL syntax.
     //
     // Supported operators are: +, -, *, /, where the left and right side of
-    // the operator is either a numeric
-    // [Job.custom_attributes][google.cloud.talent.v4beta1.Job.custom_attributes]
-    // key, integer/double value or an expression that can be evaluated to a
-    // number.
+    // the operator is either a numeric [Job.custom_attributes][google.cloud.talent.v4beta1.Job.custom_attributes] key,
+    // integer/double value or an expression that can be evaluated to a number.
     //
     // Parenthesis are supported to adjust calculation precedence. The
     // expression must be < 100 characters in length.
     //
+    // The expression is considered invalid for a job if the expression
+    // references custom attributes that are not populated on the job or if the
+    // expression results in a divide by zero. If an expression is invalid for a
+    // job, that job is demoted to the end of the results.
+    //
     // Sample ranking expression
     // (year + 25) * 0.25 - (freshness / 0.5)
-    string ranking_expression = 2;
+    string ranking_expression = 2 [(google.api.field_behavior) = REQUIRED];
   }
 
   // A string-represented enumeration of the job search mode. The service
   // operate differently for different modes of service.
   enum SearchMode {
-    // The mode of the search method isn't specified.
+    // The mode of the search method isn't specified. The default search
+    // behavior is identical to JOB_SEARCH search behavior.
     SEARCH_MODE_UNSPECIFIED = 0;
 
     // The job search matches against all jobs, and featured jobs
@@ -492,43 +494,47 @@ message SearchJobsRequest {
 
     // Default diversifying behavior. The result list is ordered so that
     // highly similar results are pushed to the end of the last page of search
-    // results.
+    // results. If you are using pageToken to page through the result set,
+    // latency might be lower but we can't guarantee that all results are
+    // returned. If you are using page offset, latency might be higher but all
+    // results are returned.
     SIMPLE = 2;
   }
 
   // Required. The resource name of the tenant to search within.
   //
-  // The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-  // "projects/api-test-project/tenant/foo".
-  //
-  // Tenant id is optional and the default tenant is used if unspecified, for
-  // example, "projects/api-test-project".
-  string parent = 1;
+  // The format is "projects/{project_id}/tenants/{tenant_id}". For example,
+  // "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant
+  // is created. For example, "projects/foo".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "jobs.googleapis.com/Job"
+    }
+  ];
 
-  // Optional. Mode of a search.
+  // Mode of a search.
   //
-  // Defaults to
-  // [SearchMode.JOB_SEARCH][google.cloud.talent.v4beta1.SearchJobsRequest.SearchMode.JOB_SEARCH].
+  // Defaults to [SearchMode.JOB_SEARCH][google.cloud.talent.v4beta1.SearchJobsRequest.SearchMode.JOB_SEARCH].
   SearchMode search_mode = 2;
 
-  // Required. The meta information collected about the job searcher, used to
-  // improve the search quality of the service. The identifiers (such as
-  // `user_id`) are provided by users, and must be unique and consistent.
-  RequestMetadata request_metadata = 3;
+  // Required. The meta information collected about the job searcher, used to improve the
+  // search quality of the service. The identifiers (such as `user_id`) are
+  // provided by users, and must be unique and consistent.
+  RequestMetadata request_metadata = 3 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional. Query used to search against jobs, such as keyword, location
-  // filters, etc.
+  // Query used to search against jobs, such as keyword, location filters, etc.
   JobQuery job_query = 4;
 
-  // Optional. Controls whether to broaden the search when it produces sparse
-  // results. Broadened queries append results to the end of the matching
-  // results list.
+  // Controls whether to broaden the search when it produces sparse results.
+  // Broadened queries append results to the end of the matching results
+  // list.
   //
   // Defaults to false.
   bool enable_broadening = 5;
 
-  // Optional. Controls if the search job request requires the return of a
-  // precise count of the first 300 results. Setting this to `true` ensures
+  // Controls if the search job request requires the return of a precise
+  // count of the first 300 results. Setting this to `true` ensures
   // consistency in the number of results per page. Best practice is to set this
   // value to true if a client allows users to jump directly to a
   // non-sequential search results page.
@@ -538,8 +544,7 @@ message SearchJobsRequest {
   // Defaults to false.
   bool require_precise_result_size = 6;
 
-  // Optional. An expression specifies a histogram request against matching
-  // jobs.
+  // An expression specifies a histogram request against matching jobs.
   //
   // Expression syntax is an aggregation function call with histogram facets and
   // other options.
@@ -571,30 +576,20 @@ message SearchJobsRequest {
   //
   // Job histogram facets:
   //
-  // * company_display_name: histogram by
-  // [Job.company_display_name][google.cloud.talent.v4beta1.Job.company_display_name].
-  // * employment_type: histogram by
-  // [Job.employment_types][google.cloud.talent.v4beta1.Job.employment_types],
-  // for example,
+  // * company_display_name: histogram by [Job.company_display_name][google.cloud.talent.v4beta1.Job.company_display_name].
+  // * employment_type: histogram by [Job.employment_types][google.cloud.talent.v4beta1.Job.employment_types], for example,
   //   "FULL_TIME", "PART_TIME".
-  // * company_size: histogram by
-  // [CompanySize][google.cloud.talent.v4beta1.CompanySize], for example,
-  // "SMALL", "MEDIUM", "BIG".
-  // * publish_time_in_month: histogram by the
-  // [Job.posting_publish_time][google.cloud.talent.v4beta1.Job.posting_publish_time]
+  // * company_size: histogram by [CompanySize][google.cloud.talent.v4beta1.CompanySize], for example, "SMALL",
+  // "MEDIUM", "BIG".
+  // * publish_time_in_month: histogram by the [Job.posting_publish_time][google.cloud.talent.v4beta1.Job.posting_publish_time]
   //   in months.
   //   Must specify list of numeric buckets in spec.
-  // * publish_time_in_year: histogram by the
-  // [Job.posting_publish_time][google.cloud.talent.v4beta1.Job.posting_publish_time]
+  // * publish_time_in_year: histogram by the [Job.posting_publish_time][google.cloud.talent.v4beta1.Job.posting_publish_time]
   //   in years.
   //   Must specify list of numeric buckets in spec.
-  // * degree_types: histogram by the
-  // [Job.degree_types][google.cloud.talent.v4beta1.Job.degree_types], for
-  // example,
+  // * degree_types: histogram by the [Job.degree_types][google.cloud.talent.v4beta1.Job.degree_types], for example,
   //   "Bachelors", "Masters".
-  // * job_level: histogram by the
-  // [Job.job_level][google.cloud.talent.v4beta1.Job.job_level], for example,
-  // "Entry
+  // * job_level: histogram by the [Job.job_level][google.cloud.talent.v4beta1.Job.job_level], for example, "Entry
   //   Level".
   // * country: histogram by the country code of jobs, for example, "US", "FR".
   // * admin1: histogram by the admin1 code of jobs, which is a global
@@ -609,31 +604,25 @@ message SearchJobsRequest {
   //   and longitude), for example, 37.4038522,-122.0987765. Since the
   //   coordinates of a city center can change, customers may need to refresh
   //   them periodically.
-  // * locale: histogram by the
-  // [Job.language_code][google.cloud.talent.v4beta1.Job.language_code], for
-  // example, "en-US",
+  // * locale: histogram by the [Job.language_code][google.cloud.talent.v4beta1.Job.language_code], for example, "en-US",
   //   "fr-FR".
-  // * language: histogram by the language subtag of the
-  // [Job.language_code][google.cloud.talent.v4beta1.Job.language_code],
+  // * language: histogram by the language subtag of the [Job.language_code][google.cloud.talent.v4beta1.Job.language_code],
   //   for example, "en", "fr".
-  // * category: histogram by the
-  // [JobCategory][google.cloud.talent.v4beta1.JobCategory], for example,
+  // * category: histogram by the [JobCategory][google.cloud.talent.v4beta1.JobCategory], for example,
   //   "COMPUTER_AND_IT", "HEALTHCARE".
   // * base_compensation_unit: histogram by the
-  //   [CompensationInfo.CompensationUnit][google.cloud.talent.v4beta1.CompensationInfo.CompensationUnit]
-  //   of base salary, for example, "WEEKLY", "MONTHLY".
+  //   [CompensationInfo.CompensationUnit][google.cloud.talent.v4beta1.CompensationInfo.CompensationUnit] of base
+  //   salary, for example, "WEEKLY", "MONTHLY".
   // * base_compensation: histogram by the base salary. Must specify list of
   //   numeric buckets to group results by.
   // * annualized_base_compensation: histogram by the base annualized salary.
   //   Must specify list of numeric buckets to group results by.
   // * annualized_total_compensation: histogram by the total annualized salary.
   //   Must specify list of numeric buckets to group results by.
-  // * string_custom_attribute: histogram by string
-  // [Job.custom_attributes][google.cloud.talent.v4beta1.Job.custom_attributes].
+  // * string_custom_attribute: histogram by string [Job.custom_attributes][google.cloud.talent.v4beta1.Job.custom_attributes].
   //   Values can be accessed via square bracket notations like
   //   string_custom_attribute["key1"].
-  // * numeric_custom_attribute: histogram by numeric
-  // [Job.custom_attributes][google.cloud.talent.v4beta1.Job.custom_attributes].
+  // * numeric_custom_attribute: histogram by numeric [Job.custom_attributes][google.cloud.talent.v4beta1.Job.custom_attributes].
   //   Values can be accessed via square bracket notations like
   //   numeric_custom_attribute["key1"]. Must specify list of numeric buckets to
   //   group results by.
@@ -648,17 +637,15 @@ message SearchJobsRequest {
   //   [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative"])`
   repeated HistogramQuery histogram_queries = 7;
 
-  // Optional. The desired job attributes returned for jobs in the search
-  // response. Defaults to
-  // [JobView.JOB_VIEW_SMALL][google.cloud.talent.v4beta1.JobView.JOB_VIEW_SMALL]
-  // if no value is specified.
+  // The desired job attributes returned for jobs in the search response.
+  // Defaults to [JobView.JOB_VIEW_SMALL][google.cloud.talent.v4beta1.JobView.JOB_VIEW_SMALL] if no value is specified.
   JobView job_view = 8;
 
-  // Optional. An integer that specifies the current offset (that is, starting
-  // result location, amongst the jobs deemed by the API as relevant) in search
-  // results. This field is only considered if
-  // [page_token][google.cloud.talent.v4beta1.SearchJobsRequest.page_token] is
-  // unset.
+  // An integer that specifies the current offset (that is, starting result
+  // location, amongst the jobs deemed by the API as relevant) in search
+  // results. This field is only considered if [page_token][google.cloud.talent.v4beta1.SearchJobsRequest.page_token] is unset.
+  //
+  // The maximum allowed value is 5000. Otherwise an error is thrown.
   //
   // For example, 0 means to  return results starting from the first matching
   // job, and 10 means to return from the 11th job. This can be used for
@@ -666,19 +653,17 @@ message SearchJobsRequest {
   // from the second page).
   int32 offset = 9;
 
-  // Optional. A limit on the number of jobs returned in the search results.
+  // A limit on the number of jobs returned in the search results.
   // Increasing this value above the default value of 10 can increase search
   // response time. The value can be between 1 and 100.
   int32 page_size = 10;
 
-  // Optional. The token specifying the current offset within
-  // search results. See
-  // [SearchJobsResponse.next_page_token][google.cloud.talent.v4beta1.SearchJobsResponse.next_page_token]
-  // for an explanation of how to obtain the next set of query results.
+  // The token specifying the current offset within
+  // search results. See [SearchJobsResponse.next_page_token][google.cloud.talent.v4beta1.SearchJobsResponse.next_page_token] for
+  // an explanation of how to obtain the next set of query results.
   string page_token = 11;
 
-  // Optional. The criteria determining how search results are sorted. Default
-  // is
+  // The criteria determining how search results are sorted. Default is
   // `"relevance desc"`.
   //
   // Supported options are:
@@ -686,37 +671,33 @@ message SearchJobsRequest {
   // * `"relevance desc"`: By relevance descending, as determined by the API
   //   algorithms. Relevance thresholding of query results is only available
   //   with this ordering.
-  // * `"posting_publish_time desc"`: By
-  // [Job.posting_publish_time][google.cloud.talent.v4beta1.Job.posting_publish_time]
+  // * `"posting_publish_time desc"`: By [Job.posting_publish_time][google.cloud.talent.v4beta1.Job.posting_publish_time]
   //   descending.
-  // * `"posting_update_time desc"`: By
-  // [Job.posting_update_time][google.cloud.talent.v4beta1.Job.posting_update_time]
+  // * `"posting_update_time desc"`: By [Job.posting_update_time][google.cloud.talent.v4beta1.Job.posting_update_time]
   //   descending.
-  // * `"title"`: By [Job.title][google.cloud.talent.v4beta1.Job.title]
-  // ascending.
-  // * `"title desc"`: By [Job.title][google.cloud.talent.v4beta1.Job.title]
-  // descending.
+  // * `"title"`: By [Job.title][google.cloud.talent.v4beta1.Job.title] ascending.
+  // * `"title desc"`: By [Job.title][google.cloud.talent.v4beta1.Job.title] descending.
   // * `"annualized_base_compensation"`: By job's
-  //   [CompensationInfo.annualized_base_compensation_range][google.cloud.talent.v4beta1.CompensationInfo.annualized_base_compensation_range]
-  //   ascending. Jobs whose annualized base compensation is unspecified are put
-  //   at the end of search results.
+  //   [CompensationInfo.annualized_base_compensation_range][google.cloud.talent.v4beta1.CompensationInfo.annualized_base_compensation_range] ascending. Jobs
+  //   whose annualized base compensation is unspecified are put at the end of
+  //   search results.
   // * `"annualized_base_compensation desc"`: By job's
-  //   [CompensationInfo.annualized_base_compensation_range][google.cloud.talent.v4beta1.CompensationInfo.annualized_base_compensation_range]
-  //   descending. Jobs whose annualized base compensation is unspecified are
-  //   put at the end of search results.
+  //   [CompensationInfo.annualized_base_compensation_range][google.cloud.talent.v4beta1.CompensationInfo.annualized_base_compensation_range] descending. Jobs
+  //   whose annualized base compensation is unspecified are put at the end of
+  //   search results.
   // * `"annualized_total_compensation"`: By job's
-  //   [CompensationInfo.annualized_total_compensation_range][google.cloud.talent.v4beta1.CompensationInfo.annualized_total_compensation_range]
-  //   ascending. Jobs whose annualized base compensation is unspecified are put
-  //   at the end of search results.
+  //   [CompensationInfo.annualized_total_compensation_range][google.cloud.talent.v4beta1.CompensationInfo.annualized_total_compensation_range] ascending. Jobs
+  //   whose annualized base compensation is unspecified are put at the end of
+  //   search results.
   // * `"annualized_total_compensation desc"`: By job's
-  //   [CompensationInfo.annualized_total_compensation_range][google.cloud.talent.v4beta1.CompensationInfo.annualized_total_compensation_range]
-  //   descending. Jobs whose annualized base compensation is unspecified are
-  //   put at the end of search results.
+  //   [CompensationInfo.annualized_total_compensation_range][google.cloud.talent.v4beta1.CompensationInfo.annualized_total_compensation_range] descending. Jobs
+  //   whose annualized base compensation is unspecified are put at the end of
+  //   search results.
   // * `"custom_ranking desc"`: By the relevance score adjusted to the
-  //   [SearchJobsRequest.CustomRankingInfo.ranking_expression][google.cloud.talent.v4beta1.SearchJobsRequest.CustomRankingInfo.ranking_expression]
-  //   with weight factor assigned by
-  //   [SearchJobsRequest.CustomRankingInfo.importance_level][google.cloud.talent.v4beta1.SearchJobsRequest.CustomRankingInfo.importance_level]
-  //   in descending order.
+  //   [SearchJobsRequest.CustomRankingInfo.ranking_expression][google.cloud.talent.v4beta1.SearchJobsRequest.CustomRankingInfo.ranking_expression] with weight
+  //   factor assigned by
+  //   [SearchJobsRequest.CustomRankingInfo.importance_level][google.cloud.talent.v4beta1.SearchJobsRequest.CustomRankingInfo.importance_level] in descending
+  //   order.
   // * Location sorting: Use the special syntax to order jobs by distance:

   //   `"distance_from('Hawaii')"`: Order by distance from Hawaii.

   //   `"distance_from(19.89, 155.5)"`: Order by distance from a coordinate.

@@ -734,78 +715,63 @@ message SearchJobsRequest {
   //   [diversification_level][google.cloud.talent.v4beta1.SearchJobsRequest.diversification_level].
   string order_by = 12;
 
-  // Optional. Controls whether highly similar jobs are returned next to each
-  // other in the search results. Jobs are identified as highly similar based on
+  // Controls whether highly similar jobs are returned next to each other in
+  // the search results. Jobs are identified as highly similar based on
   // their titles, job categories, and locations. Highly similar results are
   // clustered so that only one representative job of the cluster is
   // displayed to the job seeker higher up in the results, with the other jobs
   // being displayed lower down in the results.
   //
-  // Defaults to
-  // [DiversificationLevel.SIMPLE][google.cloud.talent.v4beta1.SearchJobsRequest.DiversificationLevel.SIMPLE]
-  // if no value is specified.
+  // Defaults to [DiversificationLevel.SIMPLE][google.cloud.talent.v4beta1.SearchJobsRequest.DiversificationLevel.SIMPLE] if no value
+  // is specified.
   DiversificationLevel diversification_level = 13;
 
-  // Optional. Controls over how job documents get ranked on top of existing
-  // relevance score (determined by API algorithm).
+  // Controls over how job documents get ranked on top of existing relevance
+  // score (determined by API algorithm).
   CustomRankingInfo custom_ranking_info = 14;
 
-  // Optional. Controls whether to disable exact keyword match on
-  // [Job.title][google.cloud.talent.v4beta1.Job.title],
-  // [Job.description][google.cloud.talent.v4beta1.Job.description],
-  // [Job.company_display_name][google.cloud.talent.v4beta1.Job.company_display_name],
-  // [Job.addresses][google.cloud.talent.v4beta1.Job.addresses],
-  // [Job.qualifications][google.cloud.talent.v4beta1.Job.qualifications]. When
-  // disable keyword match is turned off, a keyword match returns jobs that do
-  // not match given category filters when there are matching keywords. For
-  // example, for the query "program manager," a result is returned even if the
-  // job posting has the title "software developer," which doesn't fall into
-  // "program manager" ontology, but does have "program manager" appearing in
-  // its description.
+  // Controls whether to disable exact keyword match on [Job.title][google.cloud.talent.v4beta1.Job.title],
+  // [Job.description][google.cloud.talent.v4beta1.Job.description], [Job.company_display_name][google.cloud.talent.v4beta1.Job.company_display_name], [Job.addresses][google.cloud.talent.v4beta1.Job.addresses],
+  // [Job.qualifications][google.cloud.talent.v4beta1.Job.qualifications]. When disable keyword match is turned off, a
+  // keyword match returns jobs that do not match given category filters when
+  // there are matching keywords. For example, for the query "program manager,"
+  // a result is returned even if the job posting has the title "software
+  // developer," which doesn't fall into "program manager" ontology, but does
+  // have "program manager" appearing in its description.
   //
   // For queries like "cloud" that don't contain title or
   // location specific ontology, jobs with "cloud" keyword matches are returned
   // regardless of this flag's value.
   //
-  // Use
-  // [Company.keyword_searchable_job_custom_attributes][google.cloud.talent.v4beta1.Company.keyword_searchable_job_custom_attributes]
-  // if company-specific globally matched custom field/attribute string values
-  // are needed. Enabling keyword match improves recall of subsequent search
+  // Use [Company.keyword_searchable_job_custom_attributes][google.cloud.talent.v4beta1.Company.keyword_searchable_job_custom_attributes] if
+  // company-specific globally matched custom field/attribute string values are
+  // needed. Enabling keyword match improves recall of subsequent search
   // requests.
   //
   // Defaults to false.
   bool disable_keyword_match = 16;
 }
 
-// Output only.
-//
 // Response for SearchJob method.
 message SearchJobsResponse {
-  // Output only.
-  //
-  // Job entry with metadata inside
-  // [SearchJobsResponse][google.cloud.talent.v4beta1.SearchJobsResponse].
+  // Job entry with metadata inside [SearchJobsResponse][google.cloud.talent.v4beta1.SearchJobsResponse].
   message MatchingJob {
-    // Job resource that matches the specified
-    // [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest].
+    // Job resource that matches the specified [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest].
     Job job = 1;
 
     // A summary of the job with core information that's displayed on the search
     // results listing page.
     string job_summary = 2;
 
-    // Contains snippets of text from the
-    // [Job.title][google.cloud.talent.v4beta1.Job.title] field most closely
-    // matching a search query's keywords, if available. The matching query
-    // keywords are enclosed in HTML bold tags.
+    // Contains snippets of text from the [Job.title][google.cloud.talent.v4beta1.Job.title] field most
+    // closely matching a search query's keywords, if available. The matching
+    // query keywords are enclosed in HTML bold tags.
     string job_title_snippet = 3;
 
-    // Contains snippets of text from the
-    // [Job.description][google.cloud.talent.v4beta1.Job.description] and
-    // similar fields that most closely match a search query's keywords, if
-    // available. All HTML tags in the original fields are stripped when
-    // returned in this field, and matching query keywords are enclosed in HTML
-    // bold tags.
+    // Contains snippets of text from the [Job.description][google.cloud.talent.v4beta1.Job.description] and similar
+    // fields that most closely match a search query's keywords, if available.
+    // All HTML tags in the original fields are stripped when returned in this
+    // field, and matching query keywords are enclosed in HTML bold tags.
     string search_text_snippet = 4;
 
     // Commute information which is generated based on specified
@@ -813,8 +779,6 @@ message SearchJobsResponse {
     CommuteInfo commute_info = 5;
   }
 
-  // Output only.
-  //
   // Commute details related to this job.
   message CommuteInfo {
     // Location used as the destination in the commute calculation.
@@ -827,8 +791,7 @@ message SearchJobsResponse {
     google.protobuf.Duration travel_duration = 2;
   }
 
-  // The Job entities that match the specified
-  // [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest].
+  // The Job entities that match the specified [SearchJobsRequest][google.cloud.talent.v4beta1.SearchJobsRequest].
   repeated MatchingJob matching_jobs = 1;
 
   // The histogram results that match with specified
@@ -840,23 +803,19 @@ message SearchJobsResponse {
   string next_page_token = 3;
 
   // The location filters that the service applied to the specified query. If
-  // any filters are lat-lng based, the
-  // [Location.location_type][google.cloud.talent.v4beta1.Location.location_type]
-  // is
+  // any filters are lat-lng based, the [Location.location_type][google.cloud.talent.v4beta1.Location.location_type] is
   // [Location.LocationType.LOCATION_TYPE_UNSPECIFIED][google.cloud.talent.v4beta1.Location.LocationType.LOCATION_TYPE_UNSPECIFIED].
   repeated Location location_filters = 4;
 
   // An estimation of the number of jobs that match the specified query.
   //
   // This number isn't guaranteed to be accurate. For accurate results,
-  // see
-  // [SearchJobsRequest.require_precise_result_size][google.cloud.talent.v4beta1.SearchJobsRequest.require_precise_result_size].
+  // see [SearchJobsRequest.require_precise_result_size][google.cloud.talent.v4beta1.SearchJobsRequest.require_precise_result_size].
   int32 estimated_total_size = 5;
 
   // The precise result count, which is available only if the client set
-  // [SearchJobsRequest.require_precise_result_size][google.cloud.talent.v4beta1.SearchJobsRequest.require_precise_result_size]
-  // to `true`, or if the response is the last page of results. Otherwise, the
-  // value is `-1`.
+  // [SearchJobsRequest.require_precise_result_size][google.cloud.talent.v4beta1.SearchJobsRequest.require_precise_result_size] to `true`, or if the
+  // response is the last page of results. Otherwise, the value is `-1`.
   int32 total_size = 6;
 
   // Additional information for the API invocation, such as the request
@@ -880,48 +839,72 @@ message SearchJobsResponse {
 message BatchCreateJobsRequest {
   // Required. The resource name of the tenant under which the job is created.
   //
-  // The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-  // "projects/api-test-project/tenant/foo".
-  //
-  // Tenant id is optional and a default tenant is created if unspecified, for
-  // example, "projects/api-test-project".
-  string parent = 1;
+  // The format is "projects/{project_id}/tenants/{tenant_id}". For example,
+  // "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant
+  // is created. For example, "projects/foo".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "jobs.googleapis.com/Job"
+    }
+  ];
 
   // Required. The jobs to be created.
-  repeated Job jobs = 2;
+  repeated Job jobs = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request to update a batch of jobs.
 message BatchUpdateJobsRequest {
   // Required. The resource name of the tenant under which the job is created.
   //
-  // The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-  // "projects/api-test-project/tenant/foo".
-  //
-  // Tenant id is optional and the default tenant is used if unspecified, for
-  // example, "projects/api-test-project".
-  string parent = 1;
+  // The format is "projects/{project_id}/tenants/{tenant_id}". For example,
+  // "projects/foo/tenant/bar". If tenant id is unspecified, a default tenant
+  // is created. For example, "projects/foo".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "jobs.googleapis.com/Job"
+    }
+  ];
 
   // Required. The jobs to be updated.
-  repeated Job jobs = 2;
+  repeated Job jobs = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional but strongly recommended to be provided for the best service
-  // experience, also increase latency when checking status of batch operation.
+  // Strongly recommended for the best service experience. Be aware that it will
+  // also increase latency when checking the status of a batch operation.
   //
-  // If
-  // [update_mask][google.cloud.talent.v4beta1.BatchUpdateJobsRequest.update_mask]
-  // is provided, only the specified fields in
-  // [Job][google.cloud.talent.v4beta1.Job] are updated. Otherwise all the
-  // fields are updated.
+  // If [update_mask][google.cloud.talent.v4beta1.BatchUpdateJobsRequest.update_mask] is provided, only the specified fields in
+  // [Job][google.cloud.talent.v4beta1.Job] are updated. Otherwise all the fields are updated.
   //
   // A field mask to restrict the fields that are updated. Only
   // top level fields of [Job][google.cloud.talent.v4beta1.Job] are supported.
   //
-  // If
-  // [update_mask][google.cloud.talent.v4beta1.BatchUpdateJobsRequest.update_mask]
-  // is provided, The [Job][google.cloud.talent.v4beta1.Job] inside
-  // [JobResult][] will only contains fields that is updated, plus the Id of the
-  // Job. Otherwise,  [Job][google.cloud.talent.v4beta1.Job] will include all
-  // fields, which can yield a very large response.
+  // If [update_mask][google.cloud.talent.v4beta1.BatchUpdateJobsRequest.update_mask] is provided, The [Job][google.cloud.talent.v4beta1.Job] inside
+  // [JobResult][google.cloud.talent.v4beta1.JobOperationResult.JobResult]
+  // will only contains fields that is updated, plus the Id of the Job.
+  // Otherwise,  [Job][google.cloud.talent.v4beta1.Job] will include all fields, which can yield a very
+  // large response.
   google.protobuf.FieldMask update_mask = 3;
 }
+
+// The result of [JobService.BatchCreateJobs][google.cloud.talent.v4beta1.JobService.BatchCreateJobs] or
+// [JobService.BatchUpdateJobs][google.cloud.talent.v4beta1.JobService.BatchUpdateJobs] APIs. It's used to
+// replace [google.longrunning.Operation.response][google.longrunning.Operation.response] in case of success.
+message JobOperationResult {
+  // Mutation result of a job.
+  message JobResult {
+    // Here [Job][google.cloud.talent.v4beta1.Job] only contains basic information including [name][google.cloud.talent.v4beta1.Job.name],
+    // [company][google.cloud.talent.v4beta1.Job.company], [language_code][google.cloud.talent.v4beta1.Job.language_code]
+    // and [requisition_id][google.cloud.talent.v4beta1.Job.requisition_id], use getJob method to retrieve
+    // detailed information of the created/updated job.
+    Job job = 1;
+
+    // The status of the job processed. This field is populated if the
+    // processing of the [job][google.cloud.talent.v4beta1.JobOperationResult.JobResult.job] fails.
+    google.rpc.Status status = 2;
+  }
+
+  // List of job mutation results from a batch mutate operation. It can change
+  // until operation status is FINISHED, FAILED or CANCELLED.
+  repeated JobResult job_results = 1;
+}
diff --git a/third_party/googleapis/google/cloud/talent/v4beta1/jobs_v4beta1.yaml b/third_party/googleapis/google/cloud/talent/v4beta1/jobs_v4beta1.yaml
new file mode 100644
index 000000000..01a300b79
--- /dev/null
+++ b/third_party/googleapis/google/cloud/talent/v4beta1/jobs_v4beta1.yaml
@@ -0,0 +1,95 @@
+type: google.api.Service
+config_version: 3
+name: jobs.googleapis.com
+title: Cloud Talent Solution API
+
+apis:
+- name: google.cloud.talent.v4beta1.ApplicationService
+- name: google.cloud.talent.v4beta1.CompanyService
+- name: google.cloud.talent.v4beta1.Completion
+- name: google.cloud.talent.v4beta1.EventService
+- name: google.cloud.talent.v4beta1.JobService
+- name: google.cloud.talent.v4beta1.ProfileService
+- name: google.cloud.talent.v4beta1.TenantService
+
+types:
+- name: google.cloud.talent.v4beta1.BatchOperationMetadata
+- name: google.cloud.talent.v4beta1.JobOperationResult
+
+documentation:
+  summary: |-
+    Cloud Talent Solution provides the capability to create, read, update, and
+    delete job postings, as well as search jobs based on keywords and filters.
+  overview: |-
+    # Introduction
+
+    Cloud Talent Solution provides hiring companies and job distributors with
+    the capability to create and manage job postings and organizational
+    information, and perform job search using field based queries. This site
+    contains all of the information you need to integrate Cloud Talent
+    Solution, create company entities that represent employers with intended
+    access control, post and manage jobs on Garage Jobs on behalf of
+    employers, and search jobs where access control permits. For a full list
+    of supported API methods, refer to the [Reference](rest/) section.
+
+backend:
+  rules:
+  - selector: 'google.cloud.talent.v4beta1.ApplicationService.*'
+    deadline: 30.0
+  - selector: 'google.cloud.talent.v4beta1.CompanyService.*'
+    deadline: 30.0
+  - selector: google.cloud.talent.v4beta1.Completion.CompleteQuery
+    deadline: 30.0
+  - selector: google.cloud.talent.v4beta1.EventService.CreateClientEvent
+    deadline: 30.0
+  - selector: 'google.cloud.talent.v4beta1.JobService.*'
+    deadline: 30.0
+  - selector: 'google.cloud.talent.v4beta1.ProfileService.*'
+    deadline: 30.0
+  - selector: 'google.cloud.talent.v4beta1.TenantService.*'
+    deadline: 30.0
+  - selector: 'google.longrunning.Operations.*'
+    deadline: 30.0
+
+authentication:
+  rules:
+  - selector: 'google.cloud.talent.v4beta1.ApplicationService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/jobs
+  - selector: 'google.cloud.talent.v4beta1.CompanyService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/jobs
+  - selector: google.cloud.talent.v4beta1.Completion.CompleteQuery
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/jobs
+  - selector: google.cloud.talent.v4beta1.EventService.CreateClientEvent
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/jobs
+  - selector: 'google.cloud.talent.v4beta1.JobService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/jobs
+  - selector: 'google.cloud.talent.v4beta1.ProfileService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/jobs
+  - selector: 'google.cloud.talent.v4beta1.TenantService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/jobs
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/jobs
diff --git a/third_party/googleapis/google/cloud/talent/v4beta1/profile.proto b/third_party/googleapis/google/cloud/talent/v4beta1/profile.proto
index 268bb433a..e087a8cd3 100644
--- a/third_party/googleapis/google/cloud/talent/v4beta1/profile.proto
+++ b/third_party/googleapis/google/cloud/talent/v4beta1/profile.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,21 +11,20 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.talent.v4beta1;
 
-import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/talent/v4beta1/common.proto";
-import "google/cloud/talent/v4beta1/job.proto";
 import "google/protobuf/duration.proto";
-import "google/protobuf/field_mask.proto";
 import "google/protobuf/timestamp.proto";
 import "google/protobuf/wrappers.proto";
 import "google/type/date.proto";
 import "google/type/postal_address.proto";
+import "google/api/annotations.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
 option java_multiple_files = true;
@@ -38,21 +37,28 @@ option objc_class_prefix = "CTS";
 // A resource that represents the profile for a job candidate (also referred to
 // as a "single-source profile").
 message Profile {
+  option (google.api.resource) = {
+    type: "jobs.googleapis.com/Profile"
+    pattern: "projects/{project}/tenants/{tenant}/profiles/{profile}"
+  };
+
   // Required during profile update.
   //
   // Resource name assigned to a profile by the API.
   //
   // The format is
   // "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}",
-  // for example, "projects/api-test-project/tenants/foo/profiles/bar".
+  // for example, "projects/foo/tenants/bar/profiles/baz".
   string name = 1;
 
-  // Optional. Profile's id in client system if available.
+  // Profile's id in client system, if available. This value is unique for each
+  // profile inside a tenant. An error is thrown if another profile with the
+  // same external_id is created.
   //
   // The maximum number of bytes allowed is 100.
   string external_id = 2;
 
-  // Optional. The source description indicating where the profile is acquired.
+  // The source description indicating where the profile is acquired.
   //
   // For example, if a candidate profile is acquired from a resume, the user can
   // input "resume" here to indicate the source.
@@ -60,14 +66,13 @@ message Profile {
   // The maximum number of bytes allowed is 100.
   string source = 3;
 
-  // Optional. The URI set by clients that links to this profile's client-side
-  // copy.
+  // The URI set by clients that links to this profile's client-side copy.
   //
   // The maximum number of bytes allowed is 4000.
   string uri = 4;
 
-  // Optional. The cluster id of the profile to associate with other profile(s)
-  // for the same candidate.
+  // The cluster id of the profile to associate with other profile(s) for the
+  // same candidate.
   //
   // This field should be generated by the customer. If a value is not provided,
   // a random UUID is assigned to this field of the profile.
@@ -76,106 +81,155 @@ message Profile {
   // a client has a candidate with two profiles, where one was created recently
   // and the other one was created 5 years ago. These two profiles may be very
   // different. The clients can create the first profile and get a generated
-  // [group_id][google.cloud.talent.v4beta1.Profile.group_id], and assign it
-  // when the second profile is created, indicating these two profiles are
-  // referring to the same candidate.
+  // [group_id][google.cloud.talent.v4beta1.Profile.group_id], and assign it when the second profile is created,
+  // indicating these two profiles are referring to the same candidate.
   string group_id = 5;
 
-  // Optional. Indicates the hirable status of the candidate.
+  // Indicates the hirable status of the candidate.
   google.protobuf.BoolValue is_hirable = 6;
 
-  // Optional. The timestamp when the profile was first created at this source.
+  // The timestamp when the profile was first created at this source.
   google.protobuf.Timestamp create_time = 7;
 
-  // Optional. The timestamp when the profile was last updated at this source.
+  // The timestamp when the profile was last updated at this source.
   google.protobuf.Timestamp update_time = 8;
 
-  // Optional. The resume representing this profile.
+  // The timestamp when the profile was last updated as a result of a direct or
+  // indirect action by a candidate.
+  //
+  // These actions include:
+  //
+  // * Direct actions such as the candidate submitting a new resume as part of a
+  // job application to the agency, using a self-service tool such as a website
+  // to update their profile, and so on.
+  // * Indirect actions by the candidate such as uploading a resume to a job
+  // board that is collected by the agency through a feed, providing a resume to
+  // a recruiter who then uploads it into the ATS, and so on.
+  // * Updates made to the candidate's profile by the recruiter as a result of
+  // interacting with the candidate (for example adding a skill or work
+  // preference, and so on). Changes to [recruiting_notes][google.cloud.talent.v4beta1.Profile.recruiting_notes] are specifically
+  // excluded from this action type.
+  //
+  // Note: [candidate_update_time][google.cloud.talent.v4beta1.Profile.candidate_update_time] must be greater than or equal to
+  // [resume_update_time][google.cloud.talent.v4beta1.Profile.resume_update_time] or an error is thrown.
+  google.protobuf.Timestamp candidate_update_time = 67;
+
+  // The timestamp when the candidate's resume was added or updated on the
+  // candidate's profile. Whether that resume was directly uploaded by a
+  // candidate, pulled from a 3rd party job board feed, added by a recruiter,
+  // and so on.
+  //
+  // If this field is updated, it's expected that [resume][google.cloud.talent.v4beta1.Profile.resume] is provided in
+  // the create or update calls.
+  google.protobuf.Timestamp resume_update_time = 68;
+
+  // The resume representing this profile.
   Resume resume = 53;
 
-  // Optional. The names of the candidate this profile references.
+  // The names of the candidate this profile references.
   //
   // Currently only one person name is supported.
   repeated PersonName person_names = 11;
 
-  // Optional. The candidate's postal addresses.
+  // The candidate's postal addresses. It's highly recommended to
+  // input this information as accurately as possible to help improve search
+  // quality. Here are some recommendations:
+  //
+  // * Provide [Address.usage][google.cloud.talent.v4beta1.Address.usage] if possible, especially if the address is
+  // PERSONAL. During a search only personal addresses are considered. If there
+  // is no such address, all addresses with unspecified usage are assumed to be
+  // personal.
+  // * Provide [Address.current][google.cloud.talent.v4beta1.Address.current] for the current address if possible. During
+  // a search, only current addresses are considered. If there is no such
+  // address, all addresses are assumed to be current.
+  //
+  // When displaying a candidate's addresses, it is sometimes desirable to limit
+  // the number of addresses shown. In these cases we recommend that you display
+  // the addresses in the following order of priority:
+  // 1. [Address.usage][google.cloud.talent.v4beta1.Address.usage] is PERSONAL and [Address.current][google.cloud.talent.v4beta1.Address.current] is true.
+  // 2. [Address.usage][google.cloud.talent.v4beta1.Address.usage] is PERSONAL and [Address.current][google.cloud.talent.v4beta1.Address.current] is false or not
+  // set.
+  // 3. [Address.usage][google.cloud.talent.v4beta1.Address.usage] is CONTACT_INFO_USAGE_UNSPECIFIED and
+  // [Address.current][google.cloud.talent.v4beta1.Address.current] is true.
+  // 4. [Address.usage][google.cloud.talent.v4beta1.Address.usage] is CONTACT_INFO_USAGE_UNSPECIFIED and
+  // [Address.current][google.cloud.talent.v4beta1.Address.current] is false or not set.
   repeated Address addresses = 12;
 
-  // Optional. The candidate's email addresses.
+  // The candidate's email addresses.
   repeated Email email_addresses = 13;
 
-  // Optional. The candidate's phone number(s).
+  // The candidate's phone number(s).
   repeated Phone phone_numbers = 14;
 
-  // Optional. The candidate's personal URIs.
+  // The candidate's personal URIs.
   repeated PersonalUri personal_uris = 15;
 
-  // Optional. Available contact information besides
-  // [addresses][google.cloud.talent.v4beta1.Profile.addresses],
-  // [email_addresses][google.cloud.talent.v4beta1.Profile.email_addresses],
-  // [phone_numbers][google.cloud.talent.v4beta1.Profile.phone_numbers] and
-  // [personal_uris][google.cloud.talent.v4beta1.Profile.personal_uris]. For
-  // example, Hang-out, Skype.
+  // Available contact information besides [addresses][google.cloud.talent.v4beta1.Profile.addresses], [email_addresses][google.cloud.talent.v4beta1.Profile.email_addresses],
+  // [phone_numbers][google.cloud.talent.v4beta1.Profile.phone_numbers] and [personal_uris][google.cloud.talent.v4beta1.Profile.personal_uris]. For example, Hang-out, Skype.
   repeated AdditionalContactInfo additional_contact_info = 16;
 
-  // Optional. The employment history records of the candidate. It's highly
-  // recommended to input this information as accurately as possible to help
-  // improve search quality. Here are some recommendations:
+  // The employment history records of the candidate. It's highly recommended
+  // to input this information as accurately as possible to help improve search
+  // quality. Here are some recommendations:
   //
   // * Specify the start and end dates of the employment records.
   // * List different employment types separately, no matter how minor the
   // change is.
   // For example, only job title is changed from "software engineer" to "senior
   // software engineer".
-  // * Provide
-  // [EmploymentRecord.is_current][google.cloud.talent.v4beta1.EmploymentRecord.is_current]
-  // for the current employment if possible. If not, it's inferred from user
-  // inputs.
+  // * Provide [EmploymentRecord.is_current][google.cloud.talent.v4beta1.EmploymentRecord.is_current] for the current employment if
+  // possible. If not, it's inferred from user inputs.
+  //
+  // The limitation for max number of employment records is 100.
   repeated EmploymentRecord employment_records = 17;
 
-  // Optional. The education history record of the candidate. It's highly
-  // recommended to input this information as accurately as possible to help
-  // improve search quality. Here are some recommendations:
+  // The education history record of the candidate. It's highly recommended to
+  // input this information as accurately as possible to help improve search
+  // quality. Here are some recommendations:
   //
   // * Specify the start and end dates of the education records.
   // * List each education type separately, no matter how minor the change is.
   // For example, the profile contains the education experience from the same
   // school but different degrees.
-  // * Provide
-  // [EducationRecord.is_current][google.cloud.talent.v4beta1.EducationRecord.is_current]
-  // for the current education if possible. If not, it's inferred from user
-  // inputs.
+  // * Provide [EducationRecord.is_current][google.cloud.talent.v4beta1.EducationRecord.is_current] for the current education if
+  // possible. If not, it's inferred from user inputs.
+  //
+  // The limitation for max number of education records is 100.
   repeated EducationRecord education_records = 18;
 
-  // Optional. The skill set of the candidate. It's highly recommended to
-  // provide as much information as possible to help improve the search quality.
+  // The skill set of the candidate. It's highly recommended to provide as
+  // much information as possible to help improve the search quality.
+  //
+  // The limitation for max number of skills is 500.
   repeated Skill skills = 19;
 
-  // Optional. The individual or collaborative activities which the candidate
-  // has participated in, for example, open-source projects, class assignments
-  // that aren't listed in
-  // [employment_records][google.cloud.talent.v4beta1.Profile.employment_records].
+  // The individual or collaborative activities which the candidate has
+  // participated in, for example, open-source projects, class assignments that
+  // aren't listed in [employment_records][google.cloud.talent.v4beta1.Profile.employment_records].
+  //
+  // The limitation for max number of activities is 50.
   repeated Activity activities = 20;
 
-  // Optional. The publications published by the candidate.
+  // The publications published by the candidate.
+  //
+  // The limitation for max number of publications is 50.
   repeated Publication publications = 21;
 
-  // Optional. The patents acquired by the candidate.
+  // The patents acquired by the candidate.
   repeated Patent patents = 22;
 
-  // Optional. The certifications acquired by the candidate.
+  // The certifications acquired by the candidate.
   repeated Certification certifications = 23;
 
   // Output only. The resource names of the candidate's applications.
-  repeated string applications = 47;
+  repeated string applications = 47 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. The resource names of the candidate's assignments.
-  repeated string assignments = 48;
+  repeated string assignments = 48 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // Optional. A map of fields to hold both filterable and non-filterable custom
-  // profile attributes that aren't covered by the provided structured fields.
-  // See [CustomAttribute][google.cloud.talent.v4beta1.CustomAttribute] for more
-  // details.
+  // A map of fields to hold both filterable and non-filterable custom profile
+  // attributes that aren't covered by the provided structured fields. See
+  // [CustomAttribute][google.cloud.talent.v4beta1.CustomAttribute] for more details.
   //
   // At most 100 filterable and at most 100 unfilterable keys are supported. If
   // limit is exceeded, an error is thrown. Custom attributes are `unfilterable`
@@ -196,12 +250,37 @@ message Profile {
   // Output only. Indicates if a summarized profile was created as part of the
   // profile creation API call. This flag does not indicate whether a profile is
   // searchable or not.
-  bool processed = 27;
+  bool processed = 27 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Keyword snippet shows how the search result is related to a
-  // search query.  This is only returned in
-  // [SearchProfilesResponse][google.cloud.talent.v4beta1.SearchProfilesResponse].
-  string keyword_snippet = 28;
+  // search query.  This is only returned in [SearchProfilesResponse][google.cloud.talent.v4beta1.SearchProfilesResponse].
+  string keyword_snippet = 28 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Candidate's availability signals.
+  repeated AvailabilitySignal availability_signals = 70 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Derived locations of the profile, resolved from [Profile.addresses][google.cloud.talent.v4beta1.Profile.addresses].
+  //
+  // [derived_addresses][google.cloud.talent.v4beta1.Profile.derived_addresses] are exactly matched to [Profile.addresses][google.cloud.talent.v4beta1.Profile.addresses] in the
+  // same order.
+  repeated Location derived_addresses = 64 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// Candidate availability signal.
+message AvailabilitySignal {
+  // Type of signal.
+  AvailabilitySignalType type = 1;
+
+  // Timestamp of when the given availability activity last happened.
+  google.protobuf.Timestamp last_update_time = 2;
+
+  // Indicates if the [last_update_time][google.cloud.talent.v4beta1.AvailabilitySignal.last_update_time] is within
+  // [AvailabilityFilter.range][google.cloud.talent.v4beta1.AvailabilityFilter.range].
+  //
+  // Returned only in a search response when there is an [AvailabilityFilter][google.cloud.talent.v4beta1.AvailabilityFilter]
+  // in [ProfileQuery.availability_filters][google.cloud.talent.v4beta1.ProfileQuery.availability_filters] where
+  // [signal_type][google.cloud.talent.v4beta1.AvailabilityFilter.signal_type] matches [type][google.cloud.talent.v4beta1.AvailabilitySignal.type].
+  google.protobuf.BoolValue filter_satisfied = 3;
 }
 
 // Resource that represents a resume.
@@ -212,7 +291,7 @@ message Resume {
     RESUME_TYPE_UNSPECIFIED = 0;
 
     // The profile contents in HR-XML format.
-    // See http://schemas.liquid-technologies.com/hr-xml/2007-04-15/ for more
+    // See https://schemas.liquid-technologies.com/hr-xml/2007-04-15/ for more
     // information about Human Resources XML.
     HRXML = 1;
 
@@ -220,24 +299,19 @@ message Resume {
     OTHER_RESUME_TYPE = 2;
   }
 
-  // Optional. Users can create a profile with only this field field, if
-  // [resume_type][google.cloud.talent.v4beta1.Resume.resume_type] is
-  // [HRXML][google.cloud.talent.v4beta1.Resume.ResumeType.HRXML]. For example,
-  // the API parses this field and creates a profile with all structured fields
-  // populated, for example.
-  // [EmploymentRecord][google.cloud.talent.v4beta1.EmploymentRecord],
-  // [EducationRecord][google.cloud.talent.v4beta1.EducationRecord], and so on.
-  // An error is thrown if this field cannot be parsed.
-  //
-  // If this field is provided during profile creation or update,
-  // any other structured data provided in the profile is ignored. The
-  // API populates these fields by parsing this field. Note that the use of the
-  // functionality offered by this field to extract data from resumes is an
-  // Alpha feature and as such is not covered by any SLA.
+  // Users can create a profile with only this field field, if [resume_type][google.cloud.talent.v4beta1.Resume.resume_type]
+  // is [HRXML][google.cloud.talent.v4beta1.Resume.ResumeType.HRXML]. For example, the API parses this field and
+  // creates a profile
+  // with all structured fields populated. [EmploymentRecord][google.cloud.talent.v4beta1.EmploymentRecord],
+  // [EducationRecord][google.cloud.talent.v4beta1.EducationRecord], and so on. An error is thrown if this field cannot be
+  // parsed.
+  //
+  // Note that the use of the functionality offered by this field to extract
+  // data from resumes is an Alpha feature and as such is not covered by any
+  // SLA.
   string structured_resume = 1;
 
-  // Optional. The format of
-  // [structured_resume][google.cloud.talent.v4beta1.Resume.structured_resume].
+  // The format of [structured_resume][google.cloud.talent.v4beta1.Resume.structured_resume].
   ResumeType resume_type = 2;
 }
 
@@ -245,44 +319,38 @@ message Resume {
 message PersonName {
   // Resource that represents a person's structured name.
   message PersonStructuredName {
-    // Optional. Given/first name.
+    // Given/first name.
     //
-    // It's derived from
-    // [formatted_name][google.cloud.talent.v4beta1.PersonName.formatted_name]
-    // if not provided.
+    // It's derived from [formatted_name][google.cloud.talent.v4beta1.PersonName.formatted_name] if not provided.
     //
     // Number of characters allowed is 100.
     string given_name = 1;
 
-    // Optional. Preferred given/first name or nickname.
+    // Preferred given/first name or nickname.
     //
     // Number of characters allowed is 100.
     string preferred_name = 6;
 
-    // Optional. Middle initial.
+    // Middle initial.
     //
-    // It's derived from
-    // [formatted_name][google.cloud.talent.v4beta1.PersonName.formatted_name]
-    // if not provided.
+    // It's derived from [formatted_name][google.cloud.talent.v4beta1.PersonName.formatted_name] if not provided.
     //
     // Number of characters allowed is 20.
     string middle_initial = 2;
 
-    // Optional. Family/last name.
+    // Family/last name.
     //
-    // It's derived from
-    // [formatted_name][google.cloud.talent.v4beta1.PersonName.formatted_name]
-    // if not provided.
+    // It's derived from [formatted_name][google.cloud.talent.v4beta1.PersonName.formatted_name] if not provided.
     //
     // Number of characters allowed is 100.
     string family_name = 3;
 
-    // Optional. Suffixes.
+    // Suffixes.
     //
     // Number of characters allowed is 20.
     repeated string suffixes = 4;
 
-    // Optional. Prefixes.
+    // Prefixes.
     //
     // Number of characters allowed is 20.
     repeated string prefixes = 5;
@@ -292,19 +360,17 @@ message PersonName {
   // [formatted_name][google.cloud.talent.v4beta1.PersonName.formatted_name] or
   // [structured_name][google.cloud.talent.v4beta1.PersonName.structured_name].
   oneof person_name {
-    // Optional. A string represents a person's full name. For example, "Dr.
-    // John Smith".
+    // A string represents a person's full name. For example, "Dr. John Smith".
     //
     // Number of characters allowed is 100.
     string formatted_name = 1;
 
-    // Optional. A person's name in a structured way (last name, first name,
-    // suffix, and so on.)
+    // A person's name in a structured way (last name, first name, suffix, and
+    // so on.)
     PersonStructuredName structured_name = 2;
   }
 
-  // Optional. Preferred name for the person. This field is ignored if
-  // [structured_name][google.cloud.talent.v4beta1.PersonName.structured_name]
+  // Preferred name for the person. This field is ignored if [structured_name][google.cloud.talent.v4beta1.PersonName.structured_name]
   // is provided.
   //
   // Number of characters allowed is 100.
@@ -313,15 +379,14 @@ message PersonName {
 
 // Resource that represents a address.
 message Address {
-  // Optional. The usage of the address. For example, SCHOOL, WORK, PERSONAL.
+  // The usage of the address. For example, SCHOOL, WORK, PERSONAL.
   ContactInfoUsage usage = 1;
 
   // The address of a person. It can be one of
-  // [unstructured_address][google.cloud.talent.v4beta1.Address.unstructured_address]
-  // or
+  // [unstructured_address][google.cloud.talent.v4beta1.Address.unstructured_address] or
   // [structured_address][google.cloud.talent.v4beta1.Address.structured_address].
   oneof address {
-    // Optional. Unstructured address.
+    // Unstructured address.
     //
     // For example, "1600 Amphitheatre Pkwy, Mountain View, CA 94043",
     // "Sunnyvale, California".
@@ -329,22 +394,21 @@ message Address {
     // Number of characters allowed is 100.
     string unstructured_address = 2;
 
-    // Optional. Structured address that contains street address, city, state,
-    // country, and so on.
+    // Structured address that contains street address, city, state, country,
+    // and so on.
     google.type.PostalAddress structured_address = 3;
   }
 
-  // Optional. Indicates if it's the person's current address.
+  // Indicates if it's the person's current address.
   google.protobuf.BoolValue current = 4;
 }
 
 // Resource that represents a person's email address.
 message Email {
-  // Optional. The usage of the email address. For example, SCHOOL, WORK,
-  // PERSONAL.
+  // The usage of the email address. For example, SCHOOL, WORK, PERSONAL.
   ContactInfoUsage usage = 1;
 
-  // Optional. Email address.
+  // Email address.
   //
   // Number of characters allowed is 4,000.
   string email_address = 2;
@@ -378,10 +442,9 @@ message Phone {
     // A virtual telephone number is a number that can be routed to another
     // number and managed by the user via Web, SMS, IVR, and so on.  It is
     // associated with a particular person, and may be routed to either a MOBILE
-    // or LANDLINE number. The [phone
-    // usage][google.cloud.talent.v4beta1.ContactInfoUsage] should be set to
-    // PERSONAL for these phone types. Some more information can be found here:
-    // http://en.wikipedia.org/wiki/Personal_Numbers
+    // or LANDLINE number. The [phone usage][google.cloud.talent.v4beta1.ContactInfoUsage] should
+    // be set to PERSONAL for these phone types. Some more information can be
+    // found here: https://en.wikipedia.org/wiki/Personal_Numbers
     VIRTUAL = 7;
 
     // Voice over IP numbers. This includes TSoIP (Telephony Service over IP).
@@ -392,13 +455,13 @@ message Phone {
     MOBILE_OR_LANDLINE = 9;
   }
 
-  // Optional. The usage of the phone. For example, SCHOOL, WORK, PERSONAL.
+  // The usage of the phone. For example, SCHOOL, WORK, PERSONAL.
   ContactInfoUsage usage = 1;
 
-  // Optional. The phone type. For example, LANDLINE, MOBILE, FAX.
+  // The phone type. For example, LANDLINE, MOBILE, FAX.
   PhoneType type = 2;
 
-  // Optional. Phone number.
+  // Phone number.
   //
   // Any phone formats are supported and only exact matches are performed on
   // searches. For example, if a phone number in profile is provided in the
@@ -408,8 +471,7 @@ message Phone {
   // Number of characters allowed is 20.
   string number = 3;
 
-  // Optional. When this number is available. Any descriptive string is
-  // expected.
+  // When this number is available. Any descriptive string is expected.
   //
   // Number of characters allowed is 100.
   string when_available = 4;
@@ -417,7 +479,7 @@ message Phone {
 
 // Resource that represents a valid URI for a personal use.
 message PersonalUri {
-  // Optional. The personal URI.
+  // The personal URI.
   //
   // Number of characters allowed is 4,000.
   string uri = 1;
@@ -426,18 +488,17 @@ message PersonalUri {
 // Resource that represents contact information other than phone, email,
 // URI and addresses.
 message AdditionalContactInfo {
-  // Optional. The usage of this contact method. For example, SCHOOL, WORK,
-  // PERSONAL.
+  // The usage of this contact method. For example, SCHOOL, WORK, PERSONAL.
   ContactInfoUsage usage = 1;
 
-  // Optional. The name of the contact method.
+  // The name of the contact method.
   //
   // For example, "hangout", "skype".
   //
   // Number of characters allowed is 100.
   string name = 2;
 
-  // Optional. The contact id.
+  // The contact id.
   //
   // Number of characters allowed is 100.
   string contact_id = 3;
@@ -445,145 +506,134 @@ message AdditionalContactInfo {
 
 // Resource that represents an employment record of a candidate.
 message EmploymentRecord {
-  // Optional. Start date of the employment.
+  // Start date of the employment.
   google.type.Date start_date = 1;
 
-  // Optional. End date of the employment.
+  // End date of the employment.
   google.type.Date end_date = 2;
 
-  // Optional. The name of the employer company/organization.
+  // The name of the employer company/organization.
   //
   // For example, "Google", "Alphabet", and so on.
   //
-  // Number of characters allowed is 100.
+  // Number of characters allowed is 250.
   string employer_name = 3;
 
-  // Optional. The division name of the employment.
+  // The division name of the employment.
   //
   // For example, division, department, client, and so on.
   //
   // Number of characters allowed is 100.
   string division_name = 4;
 
-  // Optional. The physical address of the employer.
+  // The physical address of the employer.
   Address address = 5;
 
-  // Optional. The job title of the employment.
+  // The job title of the employment.
   //
   // For example, "Software Engineer", "Data Scientist", and so on.
   //
-  // Number of characters allowed is 100.
+  // Number of characters allowed is 250.
   string job_title = 6;
 
-  // Optional. The description of job content.
+  // The description of job content.
   //
   // Number of characters allowed is 100,000.
   string job_description = 7;
 
-  // Optional. If the jobs is a supervisor position.
+  // If the jobs is a supervisor position.
   google.protobuf.BoolValue is_supervisor = 8;
 
-  // Optional. If this employment is self-employed.
+  // If this employment is self-employed.
   google.protobuf.BoolValue is_self_employed = 9;
 
-  // Optional. If this employment is current.
+  // If this employment is current.
   google.protobuf.BoolValue is_current = 10;
 
-  // Output only. The job title snippet shows how the
-  // [job_title][google.cloud.talent.v4beta1.EmploymentRecord.job_title] is
-  // related to a search query. It's empty if the
-  // [job_title][google.cloud.talent.v4beta1.EmploymentRecord.job_title] isn't
+  // Output only. The job title snippet shows how the [job_title][google.cloud.talent.v4beta1.EmploymentRecord.job_title] is related
+  // to a search query. It's empty if the [job_title][google.cloud.talent.v4beta1.EmploymentRecord.job_title] isn't related to the
+  // search query.
+  string job_title_snippet = 11 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The job description snippet shows how the [job_description][google.cloud.talent.v4beta1.EmploymentRecord.job_description]
+  // is related to a search query. It's empty if the [job_description][google.cloud.talent.v4beta1.EmploymentRecord.job_description] isn't
   // related to the search query.
-  string job_title_snippet = 11;
-
-  // Output only. The job description snippet shows how the
-  // [job_description][google.cloud.talent.v4beta1.EmploymentRecord.job_description]
-  // is related to a search query. It's empty if the
-  // [job_description][google.cloud.talent.v4beta1.EmploymentRecord.job_description]
-  // isn't related to the search query.
-  string job_description_snippet = 12;
-
-  // Output only. The employer name snippet shows how the
-  // [employer_name][google.cloud.talent.v4beta1.EmploymentRecord.employer_name]
-  // is related to a search query. It's empty if the
-  // [employer_name][google.cloud.talent.v4beta1.EmploymentRecord.employer_name]
-  // isn't related to the search query.
-  string employer_name_snippet = 13;
+  string job_description_snippet = 12 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The employer name snippet shows how the [employer_name][google.cloud.talent.v4beta1.EmploymentRecord.employer_name] is
+  // related to a search query. It's empty if the [employer_name][google.cloud.talent.v4beta1.EmploymentRecord.employer_name] isn't
+  // related to the search query.
+  string employer_name_snippet = 13 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Resource that represents an education record of a candidate.
 message EducationRecord {
-  // Optional. The start date of the education.
+  // The start date of the education.
   google.type.Date start_date = 1;
 
-  // Optional. The end date of the education.
+  // The end date of the education.
   google.type.Date end_date = 2;
 
-  // Optional. The expected graduation date if currently pursuing a degree.
+  // The expected graduation date if currently pursuing a degree.
   google.type.Date expected_graduation_date = 3;
 
-  // Optional. The name of the school or institution.
+  // The name of the school or institution.
   //
   // For example, "Stanford University", "UC Berkeley", and so on.
   //
-  // Number of characters allowed is 100.
+  // Number of characters allowed is 250.
   string school_name = 4;
 
-  // Optional. The physical address of the education institution.
+  // The physical address of the education institution.
   Address address = 5;
 
   // The degree information. It can be one of
-  // [degree_description][google.cloud.talent.v4beta1.EducationRecord.degree_description]
-  // or
+  // [degree_description][google.cloud.talent.v4beta1.EducationRecord.degree_description] or
   // [structured_degree][google.cloud.talent.v4beta1.EducationRecord.structured_degree].
   oneof degree {
-    // Optional. The full description of the degree.
+    // The full description of the degree.
     //
     // For example, "Master of Science in Computer Science", "B.S in Math".
     //
     // Number of characters allowed is 100.
     string degree_description = 6;
 
-    // Optional. The structured notation of the degree.
+    // The structured notation of the degree.
     Degree structured_degree = 7;
   }
 
-  // Optional. The description of the education.
+  // The description of the education.
   //
   // Number of characters allowed is 100,000.
   string description = 8;
 
-  // Optional. If this education is current.
+  // If this education is current.
   google.protobuf.BoolValue is_current = 9;
 
-  // Output only. The school name snippet shows how the
-  // [school_name][google.cloud.talent.v4beta1.EducationRecord.school_name] is
-  // related to a search query in search result. It's empty if the
-  // [school_name][google.cloud.talent.v4beta1.EducationRecord.school_name]
-  // isn't related to the search query.
-  string school_name_snippet = 10;
-
-  // Output only. The job description snippet shows how the
-  // [Degree][google.cloud.talent.v4beta1.Degree] is related to a search query
-  // in search result. It's empty if the
-  // [Degree][google.cloud.talent.v4beta1.Degree] isn't related to the search
-  // query.
-  string degree_snippet = 11;
+  // Output only. The school name snippet shows how the [school_name][google.cloud.talent.v4beta1.EducationRecord.school_name] is related to a
+  // search query in search result. It's empty if the [school_name][google.cloud.talent.v4beta1.EducationRecord.school_name] isn't
+  // related to the search query.
+  string school_name_snippet = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The job description snippet shows how the [Degree][google.cloud.talent.v4beta1.Degree] is related to a search
+  // query in search result. It's empty if the [Degree][google.cloud.talent.v4beta1.Degree] isn't related to the
+  // search query.
+  string degree_snippet = 11 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Resource that represents a degree pursuing or acquired by a candidate.
 message Degree {
-  // Optional. ISCED degree type.
+  // ISCED degree type.
   DegreeType degree_type = 1;
 
-  // Optional. Full Degree name.
+  // Full Degree name.
   //
   // For example, "B.S.", "Master of Arts", and so on.
   //
   // Number of characters allowed is 100.
   string degree_name = 2;
 
-  // Optional. Fields of study for the degree.
+  // Fields of study for the degree.
   //
   // For example, "Computer science", "engineering".
   //
@@ -595,98 +645,96 @@ message Degree {
 // in by a candidate, for example, an open-source project, a class assignment,
 // and so on.
 message Activity {
-  // Optional. Activity display name.
+  // Activity display name.
   //
   // Number of characters allowed is 100.
   string display_name = 1;
 
-  // Optional. Activity description.
+  // Activity description.
   //
   // Number of characters allowed is 100,000.
   string description = 2;
 
-  // Optional. Activity URI.
+  // Activity URI.
   //
   // Number of characters allowed is 4,000.
   string uri = 3;
 
-  // Optional. The first creation date of the activity.
+  // The first creation date of the activity.
   google.type.Date create_date = 4;
 
-  // Optional. The last update date of the activity.
+  // The last update date of the activity.
   google.type.Date update_date = 5;
 
-  // Optional. A list of team members involved in this activity.
+  // A list of team members involved in this activity.
   //
   // Number of characters allowed is 100.
+  //
+  // The limitation for max number of team members is 50.
   repeated string team_members = 6;
 
-  // Optional. A list of skills used in this activity.
+  // A list of skills used in this activity.
+  //
+  // The limitation for max number of skills used is 50.
   repeated Skill skills_used = 7;
 
-  // Output only. Activity name snippet shows how the
-  // [display_name][google.cloud.talent.v4beta1.Activity.display_name] is
-  // related to a search query. It's empty if the
-  // [display_name][google.cloud.talent.v4beta1.Activity.display_name] isn't
-  // related to the search query.
-  string activity_name_snippet = 8;
+  // Output only. Activity name snippet shows how the [display_name][google.cloud.talent.v4beta1.Activity.display_name] is related to a search
+  // query. It's empty if the [display_name][google.cloud.talent.v4beta1.Activity.display_name] isn't related to the search
+  // query.
+  string activity_name_snippet = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Activity description snippet shows how the
-  // [description][google.cloud.talent.v4beta1.Activity.description] is related
-  // to a search query. It's empty if the
-  // [description][google.cloud.talent.v4beta1.Activity.description] isn't
-  // related to the search query.
-  string activity_description_snippet = 9;
+  // [description][google.cloud.talent.v4beta1.Activity.description] is related to a search query. It's empty if the
+  // [description][google.cloud.talent.v4beta1.Activity.description] isn't related to the search query.
+  string activity_description_snippet = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Skill used snippet shows how the corresponding
-  // [skills_used][google.cloud.talent.v4beta1.Activity.skills_used] are related
-  // to a search query. It's empty if the corresponding
-  // [skills_used][google.cloud.talent.v4beta1.Activity.skills_used] are not
-  // related to the search query.
-  repeated string skills_used_snippet = 10;
+  // [skills_used][google.cloud.talent.v4beta1.Activity.skills_used] are related to a search query. It's empty if the
+  // corresponding [skills_used][google.cloud.talent.v4beta1.Activity.skills_used] are not related to the search query.
+  repeated string skills_used_snippet = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Resource that represents a publication resource of a candidate.
 message Publication {
-  // Optional. A list of author names.
+  // A list of author names.
   //
   // Number of characters allowed is 100.
   repeated string authors = 1;
 
-  // Optional. The title of the publication.
+  // The title of the publication.
   //
   // Number of characters allowed is 100.
   string title = 2;
 
-  // Optional. The description of the publication.
+  // The description of the publication.
   //
   // Number of characters allowed is 100,000.
   string description = 3;
 
-  // Optional. The journal name of the publication.
+  // The journal name of the publication.
   //
   // Number of characters allowed is 100.
   string journal = 4;
 
-  // Optional. Volume number.
+  // Volume number.
   //
   // Number of characters allowed is 100.
   string volume = 5;
 
-  // Optional. The publisher of the journal.
+  // The publisher of the journal.
   //
   // Number of characters allowed is 100.
   string publisher = 6;
 
-  // Optional. The publication date.
+  // The publication date.
   google.type.Date publication_date = 7;
 
-  // Optional. The publication type.
+  // The publication type.
   //
   // Number of characters allowed is 100.
   string publication_type = 8;
 
-  // Optional. ISBN number.
+  // ISBN number.
   //
   // Number of characters allowed is 100.
   string isbn = 9;
@@ -694,42 +742,42 @@ message Publication {
 
 // Resource that represents the patent acquired by a candidate.
 message Patent {
-  // Optional. Name of the patent.
+  // Name of the patent.
   //
   // Number of characters allowed is 100.
   string display_name = 1;
 
-  // Optional. A list of inventors' names.
+  // A list of inventors' names.
   //
   // Number of characters allowed for each is 100.
   repeated string inventors = 2;
 
-  // Optional. The status of the patent.
+  // The status of the patent.
   //
   // Number of characters allowed is 100.
   string patent_status = 3;
 
-  // Optional. The date the last time the status of the patent was checked.
+  // The date the last time the status of the patent was checked.
   google.type.Date patent_status_date = 4;
 
-  // Optional. The date that the patent was filed.
+  // The date that the patent was filed.
   google.type.Date patent_filing_date = 5;
 
-  // Optional. The name of the patent office.
+  // The name of the patent office.
   //
   // Number of characters allowed is 100.
   string patent_office = 6;
 
-  // Optional. The number of the patent.
+  // The number of the patent.
   //
   // Number of characters allowed is 100.
   string patent_number = 7;
 
-  // Optional. The description of the patent.
+  // The description of the patent.
   //
   // Number of characters allowed is 100,000.
   string patent_description = 8;
 
-  // Optional. The skills used in this patent.
+  // The skills used in this patent.
   repeated Skill skills_used = 9;
 }
diff --git a/third_party/googleapis/google/cloud/talent/v4beta1/profile_service.proto b/third_party/googleapis/google/cloud/talent/v4beta1/profile_service.proto
index 4c759f7e3..4a153fd2e 100644
--- a/third_party/googleapis/google/cloud/talent/v4beta1/profile_service.proto
+++ b/third_party/googleapis/google/cloud/talent/v4beta1/profile_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -19,12 +18,17 @@ package google.cloud.talent.v4beta1;
 
 import "google/api/annotations.proto";
 import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/talent/v4beta1/common.proto";
 import "google/cloud/talent/v4beta1/filters.proto";
 import "google/cloud/talent/v4beta1/histogram.proto";
 import "google/cloud/talent/v4beta1/profile.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/any.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
+import "google/rpc/status.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
 option java_multiple_files = true;
@@ -45,6 +49,7 @@ service ProfileService {
     option (google.api.http) = {
       get: "/v4beta1/{parent=projects/*/tenants/*}/profiles"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Creates and returns a new profile.
@@ -53,6 +58,7 @@ service ProfileService {
       post: "/v4beta1/{parent=projects/*/tenants/*}/profiles"
       body: "*"
     };
+    option (google.api.method_signature) = "parent,profile";
   }
 
   // Gets the specified profile.
@@ -60,6 +66,7 @@ service ProfileService {
     option (google.api.http) = {
       get: "/v4beta1/{name=projects/*/tenants/*/profiles/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Updates the specified profile and returns the updated result.
@@ -68,6 +75,7 @@ service ProfileService {
       patch: "/v4beta1/{profile.name=projects/*/tenants/*/profiles/*}"
       body: "*"
     };
+    option (google.api.method_signature) = "profile";
   }
 
   // Deletes the specified profile.
@@ -77,6 +85,7 @@ service ProfileService {
     option (google.api.http) = {
       delete: "/v4beta1/{name=projects/*/tenants/*/profiles/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Searches for profiles within a tenant.
@@ -84,9 +93,7 @@ service ProfileService {
   // For example, search by raw queries "software engineer in Mountain View" or
   // search by structured filters (location filter, education filter, etc.).
   //
-  // See
-  // [SearchProfilesRequest][google.cloud.talent.v4beta1.SearchProfilesRequest]
-  // for more information.
+  // See [SearchProfilesRequest][google.cloud.talent.v4beta1.SearchProfilesRequest] for more information.
   rpc SearchProfiles(SearchProfilesRequest) returns (SearchProfilesResponse) {
     option (google.api.http) = {
       post: "/v4beta1/{parent=projects/*/tenants/*}:search"
@@ -97,28 +104,49 @@ service ProfileService {
 
 // List profiles request.
 message ListProfilesRequest {
-  // Required. The resource name of the tenant under which the profile is
-  // created.
+  // Required. The resource name of the tenant under which the profile is created.
   //
-  // The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-  // "projects/api-test-project/tenants/foo".
-  string parent = 1;
+  // The format is "projects/{project_id}/tenants/{tenant_id}". For example,
+  // "projects/foo/tenants/bar".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "jobs.googleapis.com/Profile"
+    }
+  ];
 
-  // Optional. The token that specifies the current offset (that is, starting
-  // result).
+  // The filter string specifies the profiles to be enumerated.
+  //
+  // Supported operator: =, AND
+  //
+  // The field(s) eligible for filtering are:
+  //
+  // * `externalId`
+  // * `groupId`
+  //
+  // externalId and groupId cannot be specified at the same time. If both
+  // externalId and groupId are provided, the API will return a bad request
+  // error.
   //
-  // Please set the value to
-  // [ListProfilesResponse.next_page_token][google.cloud.talent.v4beta1.ListProfilesResponse.next_page_token]
-  // to continue the list.
+  // Sample Query:
+  //
+  // * externalId = "externalId-1"
+  // * groupId = "groupId-1"
+  string filter = 5;
+
+  // The token that specifies the current offset (that is, starting result).
+  //
+  // Please set the value to [ListProfilesResponse.next_page_token][google.cloud.talent.v4beta1.ListProfilesResponse.next_page_token] to
+  // continue the list.
   string page_token = 2;
 
-  // Optional. The maximum number of profiles to be returned, at most 100.
+  // The maximum number of profiles to be returned, at most 100.
   //
   // Default is 100 unless a positive number smaller than 100 is specified.
   int32 page_size = 3;
 
-  // Optional. A field mask to specify the profile fields to be listed in
-  // response. All fields are listed if it is unset.
+  // A field mask to specify the profile fields to be listed in response.
+  // All fields are listed if it is unset.
   //
   // Valid values are:
   //
@@ -140,12 +168,17 @@ message ListProfilesResponse {
 message CreateProfileRequest {
   // Required. The name of the tenant this profile belongs to.
   //
-  // The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-  // "projects/api-test-project/tenants/foo".
-  string parent = 1;
+  // The format is "projects/{project_id}/tenants/{tenant_id}". For example,
+  // "projects/foo/tenants/bar".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "jobs.googleapis.com/Tenant"
+    }
+  ];
 
   // Required. The profile to be created.
-  Profile profile = 2;
+  Profile profile = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Get profile request.
@@ -153,45 +186,24 @@ message GetProfileRequest {
   // Required. Resource name of the profile to get.
   //
   // The format is
-  // "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}",
-  // for example, "projects/api-test-project/tenants/foo/profiles/bar".
-  string name = 1;
+  // "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}". For
+  // example, "projects/foo/tenants/bar/profiles/baz".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "jobs.googleapis.com/Profile"
+    }
+  ];
 }
 
 // Update profile request
 message UpdateProfileRequest {
   // Required. Profile to be updated.
-  Profile profile = 1;
+  Profile profile = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional. A field mask to specify the profile fields to update.
+  // A field mask to specify the profile fields to update.
   //
   // A full update is performed if it is unset.
-  //
-  // Valid values are:
-  //
-  // * external_id
-  // * source
-  // * uri
-  // * is_hirable
-  // * create_time
-  // * update_time
-  // * resume
-  // * person_names
-  // * addresses
-  // * email_addresses
-  // * phone_numbers
-  // * personal_uris
-  // * additional_contact_info
-  // * employment_records
-  // * education_records
-  // * skills
-  // * projects
-  // * publications
-  // * patents
-  // * certifications
-  // * recruiting_notes
-  // * custom_attributes
-  // * group_id
   google.protobuf.FieldMask update_mask = 2;
 }
 
@@ -200,47 +212,54 @@ message DeleteProfileRequest {
   // Required. Resource name of the profile to be deleted.
   //
   // The format is
-  // "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}",
-  // for example, "projects/api-test-project/tenants/foo/profiles/bar".
-  string name = 1;
+  // "projects/{project_id}/tenants/{tenant_id}/profiles/{profile_id}". For
+  // example, "projects/foo/tenants/bar/profiles/baz".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "jobs.googleapis.com/Profile"
+    }
+  ];
 }
 
 // The request body of the `SearchProfiles` call.
 message SearchProfilesRequest {
   // Required. The resource name of the tenant to search within.
   //
-  // The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-  // "projects/api-test-project/tenants/foo".
-  string parent = 1;
-
-  // Required. The meta information collected about the profile search user.
-  // This is used to improve the search quality of the service. These values are
-  // provided by users, and must be precise and consistent.
-  RequestMetadata request_metadata = 2;
-
-  // Optional. Search query to execute. See
-  // [ProfileQuery][google.cloud.talent.v4beta1.ProfileQuery] for more details.
+  // The format is "projects/{project_id}/tenants/{tenant_id}". For example,
+  // "projects/foo/tenants/bar".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "jobs.googleapis.com/Tenant"
+    }
+  ];
+
+  // Required. The meta information collected about the profile search user. This is used
+  // to improve the search quality of the service. These values are provided by
+  // users, and must be precise and consistent.
+  RequestMetadata request_metadata = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Search query to execute. See [ProfileQuery][google.cloud.talent.v4beta1.ProfileQuery] for more details.
   ProfileQuery profile_query = 3;
 
-  // Optional. A limit on the number of profiles returned in the search results.
+  // A limit on the number of profiles returned in the search results.
   // A value above the default value 10 can increase search response time.
   //
   // The maximum value allowed is 100. Otherwise an error is thrown.
   int32 page_size = 4;
 
-  // Optional. The pageToken, similar to offset enables users of the API to
-  // paginate through the search results. To retrieve the first page of results,
-  // set the pageToken to empty. The search response includes a
-  // [nextPageToken][google.cloud.talent.v4beta1.SearchProfilesResponse.next_page_token]
-  // field that can be used to populate the pageToken field for the next page of
-  // results. Using pageToken instead of offset increases the performance of the
-  // API, especially compared to larger offset values.
+  // The pageToken, similar to offset enables users of the API to paginate
+  // through the search results. To retrieve the first page of results, set the
+  // pageToken to empty. The search response includes a
+  // [nextPageToken][google.cloud.talent.v4beta1.SearchProfilesResponse.next_page_token] field that can be
+  // used to populate the pageToken field for the next page of results. Using
+  // pageToken instead of offset increases the performance of the API,
+  // especially compared to larger offset values.
   string page_token = 5;
 
-  // Optional. An integer that specifies the current offset (that is, starting
-  // result) in search results. This field is only considered if
-  // [page_token][google.cloud.talent.v4beta1.SearchProfilesRequest.page_token]
-  // is unset.
+  // An integer that specifies the current offset (that is, starting result) in
+  // search results. This field is only considered if [page_token][google.cloud.talent.v4beta1.SearchProfilesRequest.page_token] is unset.
   //
   // The maximum allowed value is 5000. Otherwise an error is thrown.
   //
@@ -249,54 +268,42 @@ message SearchProfilesRequest {
   // pageSize = 10 and offset = 10 means to search from the second page.
   int32 offset = 6;
 
-  // Optional. This flag controls the spell-check feature. If `false`, the
+  // This flag controls the spell-check feature. If `false`, the
   // service attempts to correct a misspelled query.
   //
   // For example, "enginee" is corrected to "engineer".
   bool disable_spell_check = 7;
 
-  // Optional. The criteria that determines how search results are sorted.
+  // The criteria that determines how search results are sorted.
   // Defaults is "relevance desc" if no value is specified.
   //
   // Supported options are:
   //
   // * "relevance desc": By descending relevance, as determined by the API
   //    algorithms.
-  // * "update_time desc": Sort by
-  // [Profile.update_time][google.cloud.talent.v4beta1.Profile.update_time] in
-  // descending order
+  // * "update_date desc": Sort by [Profile.update_time][google.cloud.talent.v4beta1.Profile.update_time] in descending order
   //   (recently updated profiles first).
-  // * "create_time desc": Sort by
-  // [Profile.create_time][google.cloud.talent.v4beta1.Profile.create_time] in
-  // descending order
+  // * "create_date desc": Sort by [Profile.create_time][google.cloud.talent.v4beta1.Profile.create_time] in descending order
   //   (recently created profiles first).
-  // * "first_name": Sort by
-  // [PersonName.PersonStructuredName.given_name][google.cloud.talent.v4beta1.PersonName.PersonStructuredName.given_name]
-  // in
+  // * "first_name": Sort by [PersonName.PersonStructuredName.given_name][google.cloud.talent.v4beta1.PersonName.PersonStructuredName.given_name] in
   //   ascending order.
-  // * "first_name desc": Sort by
-  // [PersonName.PersonStructuredName.given_name][google.cloud.talent.v4beta1.PersonName.PersonStructuredName.given_name]
+  // * "first_name desc": Sort by [PersonName.PersonStructuredName.given_name][google.cloud.talent.v4beta1.PersonName.PersonStructuredName.given_name]
   //   in descending order.
-  // * "last_name": Sort by
-  // [PersonName.PersonStructuredName.family_name][google.cloud.talent.v4beta1.PersonName.PersonStructuredName.family_name]
-  // in
+  // * "last_name": Sort by [PersonName.PersonStructuredName.family_name][google.cloud.talent.v4beta1.PersonName.PersonStructuredName.family_name] in
   //   ascending order.
-  // * "last_name desc": Sort by
-  // [PersonName.PersonStructuredName.family_name][google.cloud.talent.v4beta1.PersonName.PersonStructuredName.family_name]
+  // * "last_name desc": Sort by [PersonName.PersonStructuredName.family_name][google.cloud.talent.v4beta1.PersonName.PersonStructuredName.family_name]
   //   in ascending order.
   string order_by = 8;
 
-  // Optional. When sort by field is based on alphabetical order, sort values
-  // case sensitively (based on ASCII) when the value is set to true. Default
-  // value is case in-sensitive sort (false).
+  // When sort by field is based on alphabetical order, sort values case
+  // sensitively (based on ASCII) when the value is set to true. Default value
+  // is case in-sensitive sort (false).
   bool case_sensitive_sort = 9;
 
-  // Optional. A list of expressions specifies histogram requests against
-  // matching profiles for
-  // [SearchProfilesRequest][google.cloud.talent.v4beta1.SearchProfilesRequest].
+  // A list of expressions specifies histogram requests against matching
+  // profiles for [SearchProfilesRequest][google.cloud.talent.v4beta1.SearchProfilesRequest].
   //
-  // The expression syntax looks like a function definition with optional
-  // parameters.
+  // The expression syntax looks like a function definition with parameters.
   //
   // Function syntax: function_name(histogram_facet[, list of buckets])
   //
@@ -346,19 +353,13 @@ message SearchProfilesRequest {
   // * experience_in_months: experience in months. 0 means 0 month to 1 month
   // (exclusive).
   // * application_date: The application date specifies application start dates.
-  // See
-  // [ApplicationDateFilter][google.cloud.talent.v4beta1.ApplicationDateFilter]
-  // for more details.
+  // See [ApplicationDateFilter][google.cloud.talent.v4beta1.ApplicationDateFilter] for more details.
   // * application_outcome_notes: The application outcome reason specifies the
   // reasons behind the outcome of the job application.
-  // See
-  // [ApplicationOutcomeNotesFilter][google.cloud.talent.v4beta1.ApplicationOutcomeNotesFilter]
-  // for more details.
+  // See [ApplicationOutcomeNotesFilter][google.cloud.talent.v4beta1.ApplicationOutcomeNotesFilter] for more details.
   // * application_job_title: The application job title specifies the job
   // applied for in the application.
-  // See
-  // [ApplicationJobFilter][google.cloud.talent.v4beta1.ApplicationJobFilter]
-  // for more details.
+  // See [ApplicationJobFilter][google.cloud.talent.v4beta1.ApplicationJobFilter] for more details.
   // * hirable_status: Hirable status specifies the profile's hirable status.
   // * string_custom_attribute: String custom attributes. Values can be accessed
   // via square bracket notation like string_custom_attribute["key1"].
@@ -375,33 +376,42 @@ message SearchProfilesRequest {
   // [bucket(MIN, 0, "negative"), bucket(0, MAX, "non-negative")])
   repeated HistogramQuery histogram_queries = 10;
 
-  // Optional. An id that uniquely identifies the result set of a
-  // [SearchProfiles][] call.  The id should be retrieved from the
-  // [SearchProfilesResponse][google.cloud.talent.v4beta1.SearchProfilesResponse]
-  // message returned from a previous invocation of [SearchProfiles][].
+  // An id that uniquely identifies the result set of a
+  // [SearchProfiles][google.cloud.talent.v4beta1.ProfileService.SearchProfiles] call. The id should be
+  // retrieved from the
+  // [SearchProfilesResponse][google.cloud.talent.v4beta1.SearchProfilesResponse] message returned from a previous
+  // invocation of [SearchProfiles][google.cloud.talent.v4beta1.ProfileService.SearchProfiles].
   //
   // A result set is an ordered list of search results.
   //
   // If this field is not set, a new result set is computed based on the
-  // [profile_query][google.cloud.talent.v4beta1.SearchProfilesRequest.profile_query].
-  // A new
-  // [result_set_id][google.cloud.talent.v4beta1.SearchProfilesRequest.result_set_id]
-  // is returned as a handle to access this result set.
+  // [profile_query][google.cloud.talent.v4beta1.SearchProfilesRequest.profile_query].  A new [result_set_id][google.cloud.talent.v4beta1.SearchProfilesRequest.result_set_id] is returned as a handle to
+  // access this result set.
   //
   // If this field is set, the service will ignore the resource and
-  // [profile_query][google.cloud.talent.v4beta1.SearchProfilesRequest.profile_query]
-  // values, and simply retrieve a page of results from the corresponding result
-  // set.  In this case, one and only one of [page_token] or [offset] must be
-  // set.
-  //
-  // A typical use case is to invoke
-  // [SearchProfilesRequest][google.cloud.talent.v4beta1.SearchProfilesRequest]
-  // without this field, then use the resulting
-  // [result_set_id][google.cloud.talent.v4beta1.SearchProfilesRequest.result_set_id]
-  // in
-  // [SearchProfilesResponse][google.cloud.talent.v4beta1.SearchProfilesResponse]
-  // to page through the results.
+  // [profile_query][google.cloud.talent.v4beta1.SearchProfilesRequest.profile_query] values, and simply retrieve a page of results from the
+  // corresponding result set.  In this case, one and only one of [page_token][google.cloud.talent.v4beta1.SearchProfilesRequest.page_token]
+  // or [offset][google.cloud.talent.v4beta1.SearchProfilesRequest.offset] must be set.
+  //
+  // A typical use case is to invoke [SearchProfilesRequest][google.cloud.talent.v4beta1.SearchProfilesRequest] without this
+  // field, then use the resulting [result_set_id][google.cloud.talent.v4beta1.SearchProfilesRequest.result_set_id] in
+  // [SearchProfilesResponse][google.cloud.talent.v4beta1.SearchProfilesResponse] to page through the results.
   string result_set_id = 12;
+
+  // This flag is used to indicate whether the service will attempt to
+  // understand synonyms and terms related to the search query or treat the
+  // query "as is" when it generates a set of results. By default this flag is
+  // set to false, thus allowing expanded results to also be returned. For
+  // example a search for "software engineer" might also return candidates who
+  // have experience in jobs similar to software engineer positions. By setting
+  // this flag to true, the service will only attempt to deliver candidates has
+  // software engineer in his/her global fields by treating "software engineer"
+  // as a keyword.
+  //
+  // It is recommended to provide a feature in the UI (such as a checkbox) to
+  // allow recruiters to set this flag to true if they intend to search for
+  // longer boolean strings.
+  bool strict_keywords_search = 13;
 }
 
 // Response of SearchProfiles method.
@@ -426,32 +436,26 @@ message SearchProfilesResponse {
   // [SearchProfilesRequest.histogram_queries][google.cloud.talent.v4beta1.SearchProfilesRequest.histogram_queries].
   repeated HistogramQueryResult histogram_query_results = 5;
 
-  // The profile entities that match the specified
-  // [SearchProfilesRequest][google.cloud.talent.v4beta1.SearchProfilesRequest].
+  // The profile entities that match the specified [SearchProfilesRequest][google.cloud.talent.v4beta1.SearchProfilesRequest].
   repeated SummarizedProfile summarized_profiles = 6;
 
   // An id that uniquely identifies the result set of a
-  // [SearchProfiles][google.cloud.talent.v4beta1.ProfileService.SearchProfiles]
-  // call for consistent results.
+  // [SearchProfiles][google.cloud.talent.v4beta1.ProfileService.SearchProfiles] call for consistent
+  // results.
   string result_set_id = 7;
 }
 
-// Output only.
-//
-// Profile entry with metadata inside
-// [SearchProfilesResponse][google.cloud.talent.v4beta1.SearchProfilesResponse].
+// Profile entry with metadata inside [SearchProfilesResponse][google.cloud.talent.v4beta1.SearchProfilesResponse].
 message SummarizedProfile {
-  // A list of profiles that are linked by
-  // [Profile.group_id][google.cloud.talent.v4beta1.Profile.group_id].
+  // A list of profiles that are linked by [Profile.group_id][google.cloud.talent.v4beta1.Profile.group_id].
   repeated Profile profiles = 1;
 
   // A profile summary shows the profile summary and how the profile matches the
   // search query.
   //
-  // In profile summary, the profiles with the same
-  // [Profile.group_id][google.cloud.talent.v4beta1.Profile.group_id] are merged
-  // together. Among profiles, same education/employment records may be slightly
-  // different but they are merged into one with best efforts.
+  // In profile summary, the profiles with the same [Profile.group_id][google.cloud.talent.v4beta1.Profile.group_id] are
+  // merged together. Among profiles, same education/employment records may be
+  // slightly different but they are merged into one with best efforts.
   //
   // For example, in one profile the school name is "UC Berkeley" and the field
   // study is "Computer Science" and in another one the school name is
diff --git a/third_party/googleapis/google/cloud/talent/v4beta1/talent_gapic.legacy.yaml b/third_party/googleapis/google/cloud/talent/v4beta1/talent_gapic.legacy.yaml
new file mode 100644
index 000000000..0e3612510
--- /dev/null
+++ b/third_party/googleapis/google/cloud/talent/v4beta1/talent_gapic.legacy.yaml
@@ -0,0 +1,1890 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.talent.v4beta1
+  python:
+    package_name: google.cloud.talent_v4beta1.gapic
+  go:
+    package_name: cloud.google.com/go/talent/apiv4beta1
+  csharp:
+    package_name: Google.Cloud.Talent.V4Beta1
+  ruby:
+    package_name: Google::Cloud::Talent::V4beta1
+  php:
+    package_name: Google\Cloud\Talent\V4beta1
+  nodejs:
+    package_name: talent.v4beta1
+    domain_layer_location: google-cloud
+# A list of resource collection configurations.
+# Consists of a name_pattern and an entity_name.
+# The name_pattern is a pattern to describe the names of the resources of this
+# collection, using the platform's conventions for URI patterns. A generator
+# may use this to generate methods to compose and decompose such names. The
+# pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+# those will be taken as hints for the parameter names of the generated
+# methods. If empty, no name methods are generated.
+# The entity_name is the name to be used as a basis for generated methods and
+# classes.
+collections:
+- name_pattern: projects/{project}
+  entity_name: project
+  language_overrides:
+  - language: csharp
+    common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
+- name_pattern: projects/{project}/companies/{company}
+  entity_name: company_without_tenant
+- name_pattern: projects/{project}/tenants/{tenant}/companies/{company}
+  entity_name: company
+  # Override on Java, or we'll get an exception caused by conflicting with company_oneof:
+  # "CompanyName.java: Tried to write the same file twice".
+  language_overrides:
+  - language: java
+    entity_name: company_with_tenant
+- name_pattern: projects/{project}/jobs/{jobs}
+  entity_name: job_without_tenant
+- name_pattern: projects/{project}/tenants/{tenant}/jobs/{jobs}
+  entity_name: job
+  # Override on Java, or we'll get an exception caused by conflicting with job_oneof:
+  # "JobName.java: Tried to write the same file twice".
+  language_overrides:
+  - language: java
+    entity_name: job_with_tenant
+- name_pattern: projects/{project}/tenants/{tenant}/profiles/{profile}
+  entity_name: profile
+- name_pattern: projects/{project}/tenants/{tenant}/profiles/{profile}/applications/{application}
+  entity_name: application
+- name_pattern: projects/{project}/tenants/{tenant}
+  entity_name: tenant
+
+collection_oneofs:
+- oneof_name: company_oneof
+  collection_names:
+  - company
+  - company_without_tenant
+- oneof_name: job_oneof
+  collection_names:
+  - job
+  - job_without_tenant
+- oneof_name: tenant_or_project
+  collection_names:
+  - tenant
+  - project
+
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: google.cloud.talent.v4beta1.ApplicationService
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: CreateApplication
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - application
+    required_fields:
+    - parent
+    - application
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: profile
+    timeout_millis: 30000
+  - name: GetApplication
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: application
+    timeout_millis: 30000
+  - name: UpdateApplication
+    flattening:
+      groups:
+      - parameters:
+        - application
+    required_fields:
+    - application
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      application.name: application
+    timeout_millis: 30000
+  - name: DeleteApplication
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: application
+    timeout_millis: 30000
+  - name: ListApplications
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: applications
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: profile
+    timeout_millis: 30000
+# The fully qualified name of the API interface.
+- name: google.cloud.talent.v4beta1.CompanyService
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: CreateCompany
+    samples:
+      standalone:
+      - value_sets: [job_search_create_company]
+        region_tag: job_search_create_company
+    sample_value_sets:
+    - id: job_search_create_company
+      description: Create Company
+      parameters:
+        defaults:
+        - parent%project="Your Google Cloud Project ID"
+        - parent%tenant="Your Tenant ID (using tenancy is optional)"
+        - company.display_name="My Company Name"
+        - company.external_id="Identifier of this company in my system"
+        attributes:
+        - parameter: parent%project
+          sample_argument_name: project_id
+          description: Your Google Cloud Project ID
+        - parameter: parent%tenant
+          sample_argument_name: tenant_id
+          description: Identifier of the Tenant
+        - parameter: company.display_name
+          sample_argument_name: display_name
+        - parameter: company.external_id
+          sample_argument_name: external_id
+      on_success:
+      - print: ["Created Company"]
+      - print: ["Name: %s", $resp.name]
+      - print: ["Display Name: %s", $resp.display_name]
+      - print: ["External ID: %s", $resp.external_id]
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - company
+    required_fields:
+    - parent
+    - company
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: tenant_or_project
+    timeout_millis: 30000
+  - name: GetCompany
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: company_oneof
+    timeout_millis: 30000
+    samples:
+      standalone:
+      - value_sets: [job_search_get_company]
+        region_tag: job_search_get_company
+    sample_value_sets:
+    - id: job_search_get_company
+      description: Get Company
+      parameters:
+        defaults:
+        - name%project="Your Google Cloud Project ID"
+        - name%tenant="Your Tenant ID (using tenancy is optional)"
+        - name%company="Company ID"
+        attributes:
+        - parameter: name%project
+          sample_argument_name: project_id
+        - parameter: name%tenant
+          sample_argument_name: tenant_id
+        - parameter: name%company
+          sample_argument_name: company_id
+      on_success:
+      - print: ["Company name: %s", $resp.name]
+      - print: ["Display name: %s", $resp.display_name]
+  - name: UpdateCompany
+    flattening:
+      groups:
+      - parameters:
+        - company
+    required_fields:
+    - company
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      company.name: company_oneof
+    timeout_millis: 30000
+  - name: DeleteCompany
+    samples:
+      standalone:
+      - value_sets: [job_search_delete_company]
+        region_tag: job_search_delete_company
+    sample_value_sets:
+    - id: job_search_delete_company
+      description: Delete Company
+      parameters:
+        defaults:
+        - name%project="Your Google Cloud Project ID"
+        - name%tenant="Your Tenant ID (using tenancy is optional)"
+        - name%company="ID of the company to delete"
+        attributes:
+        - parameter: name%project
+          sample_argument_name: project_id
+        - parameter: name%tenant
+          sample_argument_name: tenant_id
+        - parameter: name%company
+          sample_argument_name: company_id
+      on_success:
+      - print: ["Deleted company"]
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: company_oneof
+    timeout_millis: 30000
+  - name: ListCompanies
+    samples:
+      standalone:
+      - value_sets: [job_search_list_companies]
+        region_tag: job_search_list_companies
+    sample_value_sets:
+    - id: job_search_list_companies
+      description: List Companies
+      parameters:
+        defaults:
+        - parent%project="Your Google Cloud Project ID"
+        - parent%tenant="Your Tenant ID (using tenancy is optional)"
+        attributes:
+        - parameter: parent%project
+          sample_argument_name: project_id
+          description: Your Google Cloud Project ID
+        - parameter: parent%tenant
+          sample_argument_name: tenant_id
+          description: Identifier of the Tenant
+      on_success:
+      - print: ["Company Name: %s", $resp.name]
+      - print: ["Display Name: %s", $resp.display_name]
+      - print: ["External ID: %s", $resp.external_id]
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: companies
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: tenant_or_project
+    timeout_millis: 30000
+# The fully qualified name of the API interface.
+- name: google.cloud.talent.v4beta1.Completion
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: CompleteQuery
+    required_fields:
+    - parent
+    - query
+    - page_size
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: tenant_or_project
+      company: company_oneof
+    timeout_millis: 30000
+    samples:
+      standalone:
+      - value_sets: [job_search_autocomplete_job_title]
+        region_tag: job_search_autocomplete_job_title
+    sample_value_sets:
+    - id: job_search_autocomplete_job_title
+      description: Complete job title given partial text (autocomplete)
+      parameters:
+        defaults:
+        - parent%project="Your Google Cloud Project ID"
+        - parent%tenant="Your Tenant ID (using tenancy is optional)"
+        - query="[partially typed job title]"
+        - page_size=5
+        - language_codes[0]="en-US"
+        attributes:
+        - parameter: parent%project
+          sample_argument_name: project_id
+          description: Your Google Cloud Project ID
+        - parameter: parent%tenant
+          sample_argument_name: tenant_id
+          description: Identifier of the Tenantd
+        - parameter: query
+          sample_argument_name: query
+        - parameter: page_size
+          sample_argument_name: num_results
+        - parameter: language_codes[0]
+          sample_argument_name: language_code
+      on_success:
+      - loop:
+          collection: $resp.completion_results
+          variable: result
+          body:
+          - print:   ["Suggested title: %s", result.suggestion]
+          - comment: ["Suggestion type is JOB_TITLE or COMPANY_TITLE"]
+          - print:   ["Suggestion type: %s", result.type]
+
+# The fully qualified name of the API interface.
+- name: google.cloud.talent.v4beta1.EventService
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: CreateClientEvent
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - client_event
+    required_fields:
+    - parent
+    - client_event
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: tenant_or_project
+    timeout_millis: 30000
+    samples:
+      standalone:
+      - value_sets: [job_search_create_client_event]
+        region_tag: job_search_create_client_event
+    sample_value_sets:
+    - id: job_search_create_client_event
+      description: Creates a client event
+      parameters:
+        defaults:
+        - parent%project="Your Google Cloud Project ID"
+        - parent%tenant="Your Tenant ID (using tenancy is optional)"
+        - client_event.request_id="[request_id from ResponseMetadata]"
+        - client_event.event_id="[Set this to a unique identifier]"
+        #  https://github.com/googleapis/gapic-generator/issues/2762
+        # - client_event.create_time="1972-01-01T10:00:20.021Z"
+        - client_event.create_time.seconds=0
+        - client_event.job_event.type=VIEW
+        - client_event.job_event.jobs[0]="projects/[Project ID]/tenants/[Tenant ID]/jobs/[Job ID]"
+        - client_event.job_event.jobs[1]="projects/[Project ID]/tenants/[Tenant ID]/jobs/[Job ID]"
+        attributes:
+        - parameter: parent%project
+          sample_argument_name: project_id
+          description: Your Google Cloud Project ID
+        - parameter: parent%tenant
+          sample_argument_name: tenant_id
+          description: Identifier of the Tenant
+        - parameter: client_event.request_id
+          sample_argument_name: request_id
+          description: |
+            A unique ID generated in the API responses.
+            Value should be set to the request_id from an API response.
+        - parameter: client_event.event_id
+          sample_argument_name: event_id
+          description: A unique identifier, generated by the client application
+        - parameter: client_event.create_time.seconds
+          description: |
+            The timestamp of the event as seconds of UTC time since Unix epoch
+            For more information on how to create google.protobuf.Timestamps
+            See: https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/timestamp.proto
+        - parameter: client_event.job_event.type
+          description: The type of event attributed to the behavior of the end user
+        - parameter: client_event.job_event.jobs[0]
+          description: List of job names associated with this event
+      on_success:
+      - print: ["Created client event"]
+# The fully qualified name of the API interface.
+- name: google.cloud.talent.v4beta1.JobService
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: CreateJob
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - job
+    required_fields:
+    - parent
+    - job
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: tenant_or_project
+      job.company: company_oneof
+    timeout_millis: 30000
+    samples:
+      standalone:
+      - value_sets: [job_search_create_job]
+        region_tag: job_search_create_job
+      - value_sets: [job_search_create_job_custom_attributes]
+        region_tag: job_search_create_job_custom_attributes
+    sample_value_sets:
+    - id: job_search_create_job
+      description: Create Job
+      parameters:
+        defaults:
+        - parent%project="Your Google Cloud Project ID"
+        - parent%tenant="Your Tenant ID (using tenancy is optional)"
+        ## # Currently cannot generate code which uses the helper methods to generate
+        ## # the company name using the projectId and companyId. Instead the user
+        ## # has to provide the full projects/X/companies/Y string path.
+        ## # See: https://github.com/googleapis/gapic-generator/issues/2621
+        # - job.company.project%project="Your Google Cloud Project ID"
+        # - job.company.company%company="Company ID"
+        - job.company="Company name, e.g. projects/your-project/companies/company-id"
+        ##
+        - job.requisition_id="Job requisition ID, aka Posting ID. Unique per job."
+        - job.title="Software Engineer"
+        - job.description="This is a description of this wonderful job!"
+        - job.application_info.uris[0]="https://www.example.org/job-posting/123"
+        - job.addresses[0]="1600 Amphitheatre Parkway, Mountain View, CA 94043"
+        - job.addresses[1]="111 8th Avenue, New York, NY 10011"
+        - job.language_code="en-US"
+        attributes:
+        - parameter: parent%project
+          sample_argument_name: project_id
+          description: Your Google Cloud Project ID
+        - parameter: parent%tenant
+          sample_argument_name: tenant_id
+          description: Identifier of the Tenant
+        - parameter: job.company
+          sample_argument_name: company_name
+        - parameter: job.requisition_id
+          sample_argument_name: requisition_id
+        - parameter: job.title
+          sample_argument_name: title
+        - parameter: job.description
+          sample_argument_name: description
+        - parameter: job.application_info.uris[0]
+          sample_argument_name: job_application_url
+        - parameter: job.addresses[0]
+          sample_argument_name: address_one
+        - parameter: job.addresses[1]
+          sample_argument_name: address_two
+        - parameter: job.language_code
+          sample_argument_name: language_code
+      on_success:
+      - print:
+        - "Created job: %s"
+        - $resp.name
+    - id: job_search_create_job_custom_attributes
+      description: Create Job with Custom Attributes
+      parameters:
+        defaults:
+        - parent%project="Your Google Cloud Project ID"
+        - parent%tenant="Your Tenant ID (using tenancy is optional)"
+        - job.company="Company name, e.g. projects/your-project/companies/company-id"
+        - job.requisition_id="Job requisition ID, aka Posting ID. Unique per job."
+        - job.language_code="en-US"
+        # - custom_attributes["my_attribute"][0]="My attribute value"
+        attributes:
+        - parameter: parent%project
+          sample_argument_name: project_id
+          description: Your Google Cloud Project ID
+        - parameter: parent%tenant
+          sample_argument_name: tenant_id
+          description: Identifier of the Tenantd
+        - parameter: job.company
+          sample_argument_name: company_name
+        - parameter: job.requisition_id
+          sample_argument_name: requisition_id
+        - parameter: job.language_code
+          sample_argument_name: language_code
+      on_success:
+      - print:
+        - "Created job: %s"
+        - $resp.name
+  - name: GetJob
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: job_oneof
+    timeout_millis: 30000
+    samples:
+      standalone:
+      - value_sets: [job_search_get_job]
+        region_tag: job_search_get_job
+    sample_value_sets:
+    - id: job_search_get_job
+      description: Get Job
+      parameters:
+        defaults:
+        - name%project="Your Google Cloud Project ID"
+        - name%tenant="Your Tenant ID (using tenancy is optional)"
+        - name%jobs="Job ID"
+        attributes:
+        - parameter: name%project
+          sample_argument_name: project_id
+        - parameter: name%tenant
+          sample_argument_name: tenant_id
+        - parameter: name%jobs
+          sample_argument_name: job_id
+      on_success:
+      - print: ["Job name: %s", $resp.name]
+      - print: ["Requisition ID: %s", $resp.requisition_id]
+      - print: ["Title: %s", $resp.title]
+      - print: ["Description: %s", $resp.description]
+      - print: ["Posting language: %s", $resp.language_code]
+      - loop:
+          collection: $resp.addresses
+          variable: address
+          body:
+          - print: ["Address: %s", address]
+      - loop:
+          collection: $resp.application_info.emails
+          variable: email
+          body:
+          - print: ["Email: %s", email]
+      - loop:
+          collection: $resp.application_info.uris
+          variable: website_uri
+          body:
+          - print: ["Website: %s", website_uri]
+  - name: UpdateJob
+    flattening:
+      groups:
+      - parameters:
+        - job
+    required_fields:
+    - job
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      job.name: job_oneof
+      job.company: company_oneof
+    timeout_millis: 30000
+  - name: DeleteJob
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: job_oneof
+    timeout_millis: 30000
+    samples:
+      standalone:
+      - value_sets: [job_search_delete_job]
+        region_tag: job_search_delete_job
+    sample_value_sets:
+    - id: job_search_delete_job
+      description: Delete Job
+      parameters:
+        defaults:
+        - name%project="Your Google Cloud Project ID"
+        - name%tenant="Your Tenant ID (using tenancy is optional)"
+        - name%jobs="Company ID"
+        attributes:
+        - parameter: name%project
+          sample_argument_name: project_id
+        - parameter: name%tenant
+          sample_argument_name: tenant_id
+        - parameter: name%jobs
+          sample_argument_name: job_id
+      on_success:
+      - print:
+        - "Deleted job."
+  - name: ListJobs
+    samples:
+      standalone:
+      - value_sets: [job_search_list_jobs]
+        region_tag: job_search_list_jobs
+    sample_value_sets:
+    - id: job_search_list_jobs
+      description: List Jobs
+      parameters:
+        defaults:
+        - parent%project="Your Google Cloud Project ID"
+        - parent%tenant="Your Tenant ID (using tenancy is optional)"
+        - filter="companyName=projects/my-project/companies/company-id"
+        attributes:
+        - parameter: parent%project
+          sample_argument_name: project_id
+          description: Your Google Cloud Project ID
+        - parameter: parent%tenant
+          sample_argument_name: tenant_id
+          description: Identifier of the Tenant
+        - parameter: filter
+          sample_argument_name: filter
+      on_success:
+      - print:
+        - "Job name: %s"
+        - $resp.name
+      - print:
+        - "Job requisition ID: %s"
+        - $resp.requisition_id
+      - print:
+        - "Job title: %s"
+        - $resp.title
+      - print:
+        - "Job description: %s"
+        - $resp.description
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - filter
+    required_fields:
+    - parent
+    - filter
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: jobs
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: tenant_or_project
+    timeout_millis: 30000
+  - name: BatchDeleteJobs
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - filter
+    required_fields:
+    - parent
+    - filter
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: tenant_or_project
+    timeout_millis: 30000
+    samples:
+      standalone:
+      - value_sets: [job_search_batch_delete_job]
+        region_tag: job_search_batch_delete_job
+    sample_value_sets:
+    - id: job_search_batch_delete_job
+      description: Batch delete jobs using a filter
+      parameters:
+        defaults:
+        - parent%project="Your Google Cloud Project ID"
+        - parent%tenant="Your Tenant ID (using tenancy is optional)"
+        - filter="[Query]"
+        attributes:
+        - parameter: parent%project
+          sample_argument_name: project_id
+          description: Your Google Cloud Project ID
+        - parameter: parent%tenant
+          sample_argument_name: tenant_id
+          description: Identifier of the Tenantd
+        - parameter: filter
+          sample_argument_name: filter
+          description: |
+            The filter string specifies the jobs to be deleted.
+            For example:
+              companyName = "projects/api-test-project/companies/123" AND equisitionId = "req-1"
+      on_success:
+      - print: ["Batch deleted jobs from filter"]
+  - name: SearchJobs
+    required_fields:
+    - parent
+    - request_metadata
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: matching_jobs
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: tenant_or_project
+    timeout_millis: 30000
+    samples:
+      standalone:
+      - value_sets: [job_search_custom_ranking_search]
+        region_tag: job_search_custom_ranking_search
+      - value_sets: [job_search_commute_search]
+        region_tag: job_search_commute_search
+      - value_sets: [job_search_histogram_search]
+        region_tag: job_search_histogram_search
+    sample_value_sets:
+    - id: job_search_custom_ranking_search
+      description: Search Jobs using custom rankings
+      parameters:
+        defaults:
+        - parent%project="Your Google Cloud Project ID"
+        - parent%tenant="Your Tenant ID (using tenancy is optional)"
+        # - job_query.company_names[0]="projects/[Project ID]/companies/[Company ID]"
+        - request_metadata.domain="www.example.com"
+        - request_metadata.session_id="Hashed session identifier"
+        - request_metadata.user_id="Hashed user identifier"
+        - custom_ranking_info.importance_level=EXTREME
+        - custom_ranking_info.ranking_expression="(someFieldLong + 25) * 0.25"
+        - order_by="custom_ranking desc"
+        attributes:
+        - parameter: parent%project
+          sample_argument_name: project_id
+          description: Your Google Cloud Project ID
+        - parameter: parent%tenant
+          sample_argument_name: tenant_id
+          description: Identifier of the Tenantd
+      on_success:
+      - print: ["Job summary: %s", $resp.job_summary]
+      - print: ["Job title snippet: %s", $resp.job_title_snippet]
+      - define: job=$resp.job
+      - print: ["Job name: %s", job.name]
+      - print: ["Job title: %s", job.title]
+    - id: job_search_commute_search
+      description: Search Jobs using commute distance
+      parameters:
+        defaults:
+        - parent%project="Your Google Cloud Project ID"
+        - parent%tenant="Your Tenant ID (using tenancy is optional)"
+        # - job_query.company_names[0]="projects/[Project ID]/companies/[Company ID]"
+        - request_metadata.domain="www.example.com"
+        - request_metadata.session_id="Hashed session identifier"
+        - request_metadata.user_id="Hashed user identifier"
+        - job_query.commute_filter.commute_method=TRANSIT
+        # 30 minutes
+        - job_query.commute_filter.travel_duration.seconds=1800
+        - job_query.commute_filter.start_coordinates.latitude=37.422408
+        - job_query.commute_filter.start_coordinates.longitude=-122.084068
+        attributes:
+        - parameter: parent%project
+          sample_argument_name: project_id
+        - parameter: parent%tenant
+          sample_argument_name: tenant_id
+      on_success:
+      - print: ["Job summary: %s", $resp.job_summary]
+      - print: ["Job title snippet: %s", $resp.job_title_snippet]
+      - define: job=$resp.job
+      - print: ["Job name: %s", job.name]
+      - print: ["Job title: %s", job.title]
+    - id: job_search_histogram_search
+      description: Search Jobs with histogram queries
+      parameters:
+        defaults:
+        - parent%project="Your Google Cloud Project ID"
+        - parent%tenant="Your Tenant ID (using tenancy is optional)"
+        - request_metadata.domain="www.example.com"
+        - request_metadata.session_id="Hashed session identifier"
+        - request_metadata.user_id="Hashed user identifier"
+        - histogram_queries[0].histogram_query="count(base_compensation, [bucket(12, 20)])"
+        attributes:
+        - parameter: parent%project
+          sample_argument_name: project_id
+        - parameter: parent%tenant
+          sample_argument_name: tenant_id
+        - parameter: histogram_queries[0].histogram_query
+          sample_argument_name: query
+          description: |
+            Histogram query
+            More info on histogram facets, constants, and built-in functions:
+            https://godoc.org/google.golang.org/genproto/googleapis/cloud/talent/v4beta1#SearchJobsRequest
+      on_success:
+      - print: ["Job summary: %s", $resp.job_summary]
+      - print: ["Job title snippet: %s", $resp.job_title_snippet]
+      - define: job=$resp.job
+      - print: ["Job name: %s", job.name]
+      - print: ["Job title: %s", job.title]
+  - name: SearchJobsForAlert
+    required_fields:
+    - parent
+    - request_metadata
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: matching_jobs
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: tenant_or_project
+    timeout_millis: 30000
+  - name: BatchCreateJobs
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - jobs
+    required_fields:
+    - parent
+    - jobs
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: tenant
+    long_running:
+      return_type: google.cloud.talent.v4beta1.JobOperationResult
+      metadata_type: google.cloud.talent.v4beta1.BatchOperationMetadata
+      initial_poll_delay_millis: 500
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 5000
+      total_poll_timeout_millis: 300000
+    timeout_millis: 30000
+    samples:
+      standalone:
+      - value_sets: [job_search_batch_create_jobs]
+        region_tag: job_search_batch_create_jobs
+    sample_value_sets:
+    - id: job_search_batch_create_jobs
+      description: Batch Create Jobs
+      parameters:
+        defaults:
+        - parent%project="Your Google Cloud Project ID"
+        - parent%tenant="Your Tenant ID (using tenancy is optional)"
+        ## # Currently cannot generate code which uses the helper methods to generate
+        ## # the company name using the projectId and companyId. Instead the user
+        ## # has to provide the full projects/X/companies/Y string path.
+        ## # See: https://github.com/googleapis/gapic-generator/issues/2621
+        # - job.company.project%project="Your Google Cloud Project ID"
+        # - job.company.company%company="Company ID"
+        - jobs[0].company="Company name, e.g. projects/your-project/companies/company-id"
+        - jobs[0].requisition_id="Job requisition ID, aka Posting ID. Unique per job."
+        - jobs[0].title="Software Engineer"
+        - jobs[0].description="This is a description of this wonderful job!"
+        - jobs[0].application_info.uris[0]="https://www.example.org/job-posting/123"
+        - jobs[0].addresses[0]="1600 Amphitheatre Parkway, Mountain View, CA 94043"
+        - jobs[0].language_code="en-US"
+        - jobs[1].company="Company name, e.g. projects/your-project/companies/company-id"
+        - jobs[1].requisition_id="Job requisition ID, aka Posting ID. Unique per job."
+        - jobs[1].title="Quality Assurance"
+        - jobs[1].description="This is a description of this wonderful job!"
+        - jobs[1].application_info.uris[0]="https://www.example.org/job-posting/123"
+        - jobs[1].addresses[0]="111 8th Avenue, New York, NY 10011"
+        - jobs[1].language_code="en-US"
+        attributes:
+        - parameter: parent%project
+          sample_argument_name: project_id
+          description: Your Google Cloud Project ID
+        - parameter: parent%tenant
+          sample_argument_name: tenant_id
+          description: Identifier of the Tenant
+        - parameter: jobs[0].company
+          sample_argument_name: company_name_one
+        - parameter: jobs[0].requisition_id
+          sample_argument_name: requisition_id_one
+        - parameter: jobs[0].title
+          sample_argument_name: title_one
+        - parameter: jobs[0].description
+          sample_argument_name: description_one
+        - parameter: jobs[0].application_info.uris[0]
+          sample_argument_name: job_application_url_one
+        - parameter: jobs[0].addresses[0]
+          sample_argument_name: address_one
+        - parameter: jobs[0].language_code
+          sample_argument_name: language_code_one
+        - parameter: jobs[1].company
+          sample_argument_name: company_name_two
+        - parameter: jobs[1].requisition_id
+          sample_argument_name: requisition_id_two
+        - parameter: jobs[1].title
+          sample_argument_name: title_two
+        - parameter: jobs[1].description
+          sample_argument_name: description_two
+        - parameter: jobs[1].application_info.uris[0]
+          sample_argument_name: job_application_url_two
+        - parameter: jobs[1].addresses[0]
+          sample_argument_name: address_two
+        - parameter: jobs[1].language_code
+          sample_argument_name: language_code_two
+      on_success:
+      - print:
+        - "Batch response: %s"
+        - $resp
+  - name: BatchUpdateJobs
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - jobs
+    required_fields:
+    - parent
+    - jobs
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: tenant
+    long_running:
+      return_type: google.cloud.talent.v4beta1.JobOperationResult
+      metadata_type: google.cloud.talent.v4beta1.BatchOperationMetadata
+      initial_poll_delay_millis: 500
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 5000
+      total_poll_timeout_millis: 300000
+    timeout_millis: 30000
+    samples:
+      standalone:
+      - value_sets: [job_search_batch_update_jobs]
+        region_tag: job_search_batch_update_jobs
+    sample_value_sets:
+    - id: job_search_batch_update_jobs
+      description: Batch Update Jobs
+      parameters:
+        defaults:
+        - parent%project="Your Google Cloud Project ID"
+        - parent%tenant="Your Tenant ID (using tenancy is optional)"
+        ## # Currently cannot generate code which uses the helper methods to generate
+        ## # the company name using the projectId and companyId. Instead the user
+        ## # has to provide the full projects/X/companies/Y string path.
+        ## # See: https://github.com/googleapis/gapic-generator/issues/2621
+        # - job.company.project%project="Your Google Cloud Project ID"
+        # - job.company.company%company="Company ID"
+        - jobs[0].name = "job name, e.g. projects/your-project/tenants/tenant-id/jobs/job-id"
+        - jobs[0].company="Company name, e.g. projects/your-project/companies/company-id"
+        - jobs[0].requisition_id="Job requisition ID, aka Posting ID. Unique per job."
+        - jobs[0].title="Software Engineer"
+        - jobs[0].description="This is a description of this wonderful job!"
+        - jobs[0].application_info.uris[0]="https://www.example.org/job-posting/123"
+        - jobs[0].addresses[0]="1600 Amphitheatre Parkway, Mountain View, CA 94043"
+        - jobs[0].language_code="en-US"
+        - jobs[1].name = "job name, e.g. projects/your-project/tenants/tenant-id/jobs/job-id"
+        - jobs[1].company="Company name, e.g. projects/your-project/companies/company-id"
+        - jobs[1].requisition_id="Job requisition ID, aka Posting ID. Unique per job."
+        - jobs[1].title="Quality Assurance"
+        - jobs[1].description="This is a description of this wonderful job!"
+        - jobs[1].application_info.uris[0]="https://www.example.org/job-posting/123"
+        - jobs[1].addresses[0]="111 8th Avenue, New York, NY 10011"
+        - jobs[1].language_code="en-US"
+        attributes:
+        - parameter: parent%project
+          sample_argument_name: project_id
+          description: Your Google Cloud Project ID
+        - parameter: parent%tenant
+          sample_argument_name: tenant_id
+          description: Identifier of the Tenant
+        - parameter: jobs[0].name
+          sample_argument_name: job_name_one
+        - parameter: jobs[0].company
+          sample_argument_name: company_name_one
+        - parameter: jobs[0].requisition_id
+          sample_argument_name: requisition_id_one
+        - parameter: jobs[0].title
+          sample_argument_name: title_one
+        - parameter: jobs[0].description
+          sample_argument_name: description_one
+        - parameter: jobs[0].application_info.uris[0]
+          sample_argument_name: job_application_url_one
+        - parameter: jobs[0].addresses[0]
+          sample_argument_name: address_one
+        - parameter: jobs[0].language_code
+          sample_argument_name: language_code_one
+        - parameter: jobs[1].name
+          sample_argument_name: job_name_two
+        - parameter: jobs[1].company
+          sample_argument_name: company_name_two
+        - parameter: jobs[1].requisition_id
+          sample_argument_name: requisition_id_two
+        - parameter: jobs[1].title
+          sample_argument_name: title_two
+        - parameter: jobs[1].description
+          sample_argument_name: description_two
+        - parameter: jobs[1].application_info.uris[0]
+          sample_argument_name: job_application_url_two
+        - parameter: jobs[1].addresses[0]
+          sample_argument_name: address_two
+        - parameter: jobs[1].language_code
+          sample_argument_name: language_code_two
+      on_success:
+      - print:
+        - "Batch response: %s"
+        - $resp
+# The fully qualified name of the API interface.
+- name: google.cloud.talent.v4beta1.ProfileService
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ListProfiles
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: profiles
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: tenant
+    timeout_millis: 30000
+  - name: CreateProfile
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - profile
+    required_fields:
+    - parent
+    - profile
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: tenant
+    timeout_millis: 30000
+  - name: GetProfile
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: profile
+    timeout_millis: 30000
+  - name: UpdateProfile
+    flattening:
+      groups:
+      - parameters:
+        - profile
+    required_fields:
+    - profile
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      profile.name: profile
+    timeout_millis: 30000
+  - name: DeleteProfile
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: profile
+    timeout_millis: 30000
+  - name: SearchProfiles
+    required_fields:
+    - parent
+    - request_metadata
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: summarized_profiles
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: tenant
+    timeout_millis: 30000
+# The fully qualified name of the API interface.
+- name: google.cloud.talent.v4beta1.TenantService
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 300000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: CreateTenant
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - tenant
+    required_fields:
+    - parent
+    - tenant
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 30000
+    samples:
+      standalone:
+      - value_sets: [job_search_create_tenant]
+        region_tag: job_search_create_tenant
+    sample_value_sets:
+    - id: job_search_create_tenant
+      description: Create Tenant for scoping resources, e.g. companies and jobs
+      parameters:
+        defaults:
+        - parent%project="Your Google Cloud Project ID"
+        - tenant.external_id="Your Unique Identifier for Tenant"
+        attributes:
+        - parameter: parent%project
+          sample_argument_name: project_id
+        - parameter: tenant.external_id
+          sample_argument_name: external_id
+      on_success:
+      - print: ["Created Tenant"]
+      - print: ["Name: %s", $resp.name]
+      - print: ["External ID: %s", $resp.external_id]
+  - name: GetTenant
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: tenant
+    timeout_millis: 30000
+    samples:
+      standalone:
+      - value_sets: [job_search_get_tenant]
+        region_tag: job_search_get_tenant
+    sample_value_sets:
+    - id: job_search_get_tenant
+      description: Get Tenant by name
+      parameters:
+        defaults:
+        - name%project="Your Google Cloud Project ID"
+        - name%tenant="Your Tenant ID"
+        attributes:
+        - parameter: name%project
+          sample_argument_name: project_id
+        - parameter: name%tenant
+          sample_argument_name: tenant_id
+      on_success:
+      - print: ["Name: %s", $resp.name]
+      - print: ["External ID: %s", $resp.external_id]
+  - name: UpdateTenant
+    flattening:
+      groups:
+      - parameters:
+        - tenant
+    required_fields:
+    - tenant
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      tenant.name: tenant
+    timeout_millis: 30000
+  - name: DeleteTenant
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: tenant
+    timeout_millis: 30000
+    samples:
+      standalone:
+      - value_sets: [job_search_delete_tenant]
+        region_tag: job_search_delete_tenant
+    sample_value_sets:
+    - id: job_search_delete_tenant
+      description: Delete Tenant
+      parameters:
+        defaults:
+        - name%project="Your Google Cloud Project ID"
+        - name%tenant="Your Tenant ID)"
+        attributes:
+        - parameter: name%project
+          sample_argument_name: project_id
+        - parameter: name%tenant
+          sample_argument_name: tenant_id
+      on_success:
+      - print: ["Deleted Tenant."]
+  - name: ListTenants
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: tenants
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 30000
+    samples:
+      standalone:
+      - value_sets: [job_search_list_tenants]
+        region_tag: job_search_list_tenants
+    sample_value_sets:
+    - id: job_search_list_tenants
+      description: List Tenants
+      parameters:
+        defaults:
+        - parent%project="Your Google Cloud Project ID"
+        - parent%tenant="Your Tenant ID"
+        attributes:
+        - parameter: parent%project
+          sample_argument_name: project_id
+      on_success:
+      - print: ["Tenant Name: %s", $resp.name]
+      - print: ["External ID: %s", $resp.external_id]
+resource_name_generation:
+- message_name: Application
+  field_entity_map:
+    name: application
+- message_name: CreateApplicationRequest
+  field_entity_map:
+    parent: profile
+- message_name: GetApplicationRequest
+  field_entity_map:
+    name: application
+- message_name: DeleteApplicationRequest
+  field_entity_map:
+    name: application
+- message_name: ListApplicationsRequest
+  field_entity_map:
+    parent: profile
+- message_name: Company
+  field_entity_map:
+    name: company_oneof
+- message_name: CreateCompanyRequest
+  field_entity_map:
+    parent: tenant_or_project
+- message_name: GetCompanyRequest
+  field_entity_map:
+    name: company_oneof
+- message_name: DeleteCompanyRequest
+  field_entity_map:
+    name: company_oneof
+- message_name: ListCompaniesRequest
+  field_entity_map:
+    parent: tenant_or_project
+- message_name: CompleteQueryRequest
+  field_entity_map:
+    parent: tenant_or_project
+    company: company_oneof
+- message_name: CreateClientEventRequest
+  field_entity_map:
+    parent: tenant_or_project
+- message_name: Job
+  field_entity_map:
+    name: job_oneof
+    company: company_oneof
+- message_name: CreateJobRequest
+  field_entity_map:
+    parent: tenant_or_project
+    job.company: company_oneof
+- message_name: GetJobRequest
+  field_entity_map:
+    name: job_oneof
+- message_name: DeleteJobRequest
+  field_entity_map:
+    name: job_oneof
+- message_name: ListJobsRequest
+  field_entity_map:
+    parent: tenant_or_project
+- message_name: BatchDeleteJobsRequest
+  field_entity_map:
+    parent: tenant_or_project
+- message_name: SearchJobsRequest
+  field_entity_map:
+    parent: tenant_or_project
+- message_name: SearchJobsForAlertRequest
+  field_entity_map:
+    parent: tenant_or_project
+- message_name: Profile
+  field_entity_map:
+    name: profile
+- message_name: CreateProfileRequest
+  field_entity_map:
+    parent: tenant
+- message_name: GetProfileRequest
+  field_entity_map:
+    name: profile
+- message_name: DeleteProfileRequest
+  field_entity_map:
+    name: profile
+- message_name: ListProfilesRequest
+  field_entity_map:
+    parent: tenant
+- message_name: SearchProfilesRequest
+  field_entity_map:
+    parent: tenant
+- message_name: Tenant
+  field_entity_map:
+    name: tenant
+- message_name: CreateTenantRequest
+  field_entity_map:
+    parent: project
+- message_name: GetTenantRequest
+  field_entity_map:
+    name: tenant
+- message_name: DeleteTenantRequest
+  field_entity_map:
+    name: tenant
+- message_name: ListTenantsRequest
+  field_entity_map:
+    parent: project
diff --git a/third_party/googleapis/google/cloud/talent/v4beta1/talent_gapic.yaml b/third_party/googleapis/google/cloud/talent/v4beta1/talent_gapic.yaml
index d21ea292f..c58dc701e 100644
--- a/third_party/googleapis/google/cloud/talent/v4beta1/talent_gapic.yaml
+++ b/third_party/googleapis/google/cloud/talent/v4beta1/talent_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -17,1546 +17,48 @@ language_settings:
   nodejs:
     package_name: talent.v4beta1
     domain_layer_location: google-cloud
-# A list of resource collection configurations.
-# Consists of a name_pattern and an entity_name.
-# The name_pattern is a pattern to describe the names of the resources of this
-# collection, using the platform's conventions for URI patterns. A generator
-# may use this to generate methods to compose and decompose such names. The
-# pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-# those will be taken as hints for the parameter names of the generated
-# methods. If empty, no name methods are generated.
-# The entity_name is the name to be used as a basis for generated methods and
-# classes.
-collections:
-- name_pattern: projects/{project}
-  entity_name: project
-  language_overrides:
-  - language: csharp
-    common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
-- name_pattern: projects/{project}/companies/{company}
-  entity_name: company_without_tenant
-- name_pattern: projects/{project}/tenants/{tenant}/companies/{company}
-  entity_name: company
-  # Override on Java, or we'll get an exception caused by conflicting with company_oneof:
-  # "CompanyName.java: Tried to write the same file twice".
-  language_overrides:
-  - language: java
-    entity_name: company_with_tenant
-- name_pattern: projects/{project}/jobs/{jobs}
-  entity_name: job_without_tenant
-- name_pattern: projects/{project}/tenants/{tenant}/jobs/{jobs}
-  entity_name: job
-  # Override on Java, or we'll get an exception caused by conflicting with job_oneof:
-  # "JobName.java: Tried to write the same file twice".
-  language_overrides:
-  - language: java
-    entity_name: job_with_tenant
-- name_pattern: projects/{project}/tenants/{tenant}/profiles/{profile}
-  entity_name: profile
-- name_pattern: projects/{project}/tenants/{tenant}/profiles/{profile}/applications/{application}
-  entity_name: application
-- name_pattern: projects/{project}/tenants/{tenant}
-  entity_name: tenant
-
-collection_oneofs:
-- oneof_name: company_oneof
-  collection_names:
-  - company
-  - company_without_tenant
-- oneof_name: job_oneof
-  collection_names:
-  - job
-  - job_without_tenant
-- oneof_name: tenant_or_project
-  collection_names:
-  - tenant
-  - project
-
 # A list of API interface configurations.
 interfaces:
-# The fully qualified name of the API interface.
 - name: google.cloud.talent.v4beta1.ApplicationService
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
   methods:
-  - name: CreateApplication
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - application
-    required_fields:
-    - parent
-    - application
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: profile
-    timeout_millis: 30000
-  - name: GetApplication
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: application
-    timeout_millis: 30000
-  - name: UpdateApplication
-    flattening:
-      groups:
-      - parameters:
-        - application
-    required_fields:
-    - application
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      application.name: application
-    timeout_millis: 30000
   - name: DeleteApplication
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: application
-    timeout_millis: 30000
-  - name: ListApplications
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: applications
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: profile
-    timeout_millis: 30000
-# The fully qualified name of the API interface.
 - name: google.cloud.talent.v4beta1.CompanyService
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
+  deprecated_collections:
+  - name_pattern: projects/{project}/companies/{company}
+    entity_name: company_without_tenant
+  - name_pattern: projects/{project}/tenants/{tenant}/companies/{company}
+    entity_name: company
   methods:
-  - name: CreateCompany
-    samples:
-      standalone:
-      - value_sets: [job_search_create_company]
-        region_tag: job_search_create_company
-    sample_value_sets:
-    - id: job_search_create_company
-      description: Create Company
-      parameters:
-        defaults:
-        - parent%project="Your Google Cloud Project ID"
-        - parent%tenant="Your Tenant ID (using tenancy is optional)"
-        - company.display_name="My Company Name"
-        - company.external_id="Identifier of this company in my system"
-        attributes:
-        - parameter: parent%project
-          sample_argument_name: project_id
-          description: Your Google Cloud Project ID
-        - parameter: parent%tenant
-          sample_argument_name: tenant_id
-          description: Identifier of the Tenant
-        - parameter: company.display_name
-          sample_argument_name: display_name
-        - parameter: company.external_id
-          sample_argument_name: external_id
-      on_success:
-      - print: ["Created Company"]
-      - print: ["Name: %s", $resp.name]
-      - print: ["Display Name: %s", $resp.display_name]
-      - print: ["External ID: %s", $resp.external_id]
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - company
-    required_fields:
-    - parent
-    - company
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: tenant_or_project
-    timeout_millis: 30000
-  - name: GetCompany
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: company_oneof
-    timeout_millis: 30000
-    samples:
-      standalone:
-      - value_sets: [job_search_get_company]
-        region_tag: job_search_get_company
-    sample_value_sets:
-    - id: job_search_get_company
-      description: Get Company
-      parameters:
-        defaults:
-        - name%project="Your Google Cloud Project ID"
-        - name%tenant="Your Tenant ID (using tenancy is optional)"
-        - name%company="Company ID"
-        attributes:
-        - parameter: name%project
-          sample_argument_name: project_id
-        - parameter: name%tenant
-          sample_argument_name: tenant_id
-        - parameter: name%company
-          sample_argument_name: company_id
-      on_success:
-      - print: ["Company name: %s", $resp.name]
-      - print: ["Display name: %s", $resp.display_name]
-  - name: UpdateCompany
-    flattening:
-      groups:
-      - parameters:
-        - company
-    required_fields:
-    - company
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      company.name: company_oneof
-    timeout_millis: 30000
   - name: DeleteCompany
-    samples:
-      standalone:
-      - value_sets: [job_search_delete_company]
-        region_tag: job_search_delete_company
-    sample_value_sets:
-    - id: job_search_delete_company
-      description: Delete Company
-      parameters:
-        defaults:
-        - name%project="Your Google Cloud Project ID"
-        - name%tenant="Your Tenant ID (using tenancy is optional)"
-        - name%company="ID of the company to delete"
-        attributes:
-        - parameter: name%project
-          sample_argument_name: project_id
-        - parameter: name%tenant
-          sample_argument_name: tenant_id
-        - parameter: name%company
-          sample_argument_name: company_id
-      on_success:
-      - print: ["Deleted company"]
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: company_oneof
-    timeout_millis: 30000
-  - name: ListCompanies
-    samples:
-      standalone:
-      - value_sets: [job_search_list_companies]
-        region_tag: job_search_list_companies
-    sample_value_sets:
-    - id: job_search_list_companies
-      description: List Companies
-      parameters:
-        defaults:
-        - parent%project="Your Google Cloud Project ID"
-        - parent%tenant="Your Tenant ID (using tenancy is optional)"
-        attributes:
-        - parameter: parent%project
-          sample_argument_name: project_id
-          description: Your Google Cloud Project ID
-        - parameter: parent%tenant
-          sample_argument_name: tenant_id
-          description: Identifier of the Tenant
-      on_success:
-      - print: ["Company Name: %s", $resp.name]
-      - print: ["Display Name: %s", $resp.display_name]
-      - print: ["External ID: %s", $resp.external_id]
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: companies
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: tenant_or_project
-    timeout_millis: 30000
 # The fully qualified name of the API interface.
 - name: google.cloud.talent.v4beta1.Completion
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
+  deprecated_collections:
+  - name_pattern: projects/{project}/companies/{company}
+    entity_name: company_without_tenant
+  - name_pattern: projects/{project}/tenants/{tenant}/companies/{company}
+    entity_name: company
   methods:
   - name: CompleteQuery
-    required_fields:
-    - parent
-    - query
-    - page_size
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: tenant_or_project
-      company: company_oneof
-    timeout_millis: 30000
-    samples:
-      standalone:
-      - value_sets: [job_search_autocomplete_job_title]
-        region_tag: job_search_autocomplete_job_title
-    sample_value_sets:
-    - id: job_search_autocomplete_job_title
-      description: Complete job title given partial text (autocomplete)
-      parameters:
-        defaults:
-        - parent%project="Your Google Cloud Project ID"
-        - parent%tenant="Your Tenant ID (using tenancy is optional)"
-        - query="[partially typed job title]"
-        - page_size=5
-        - language_codes[0]="en-US"
-        attributes:
-        - parameter: parent%project
-          sample_argument_name: project_id
-          description: Your Google Cloud Project ID
-        - parameter: parent%tenant
-          sample_argument_name: tenant_id
-          description: Identifier of the Tenantd
-        - parameter: query
-          sample_argument_name: query
-        - parameter: page_size
-          sample_argument_name: num_results
-        - parameter: language_codes[0]
-          sample_argument_name: language_code
-      on_success:
-      - loop:
-          collection: $resp.completion_results
-          variable: result
-          body:
-          - print:   ["Suggested title: %s", result.suggestion]
-          - comment: ["Suggestion type is JOB_TITLE or COMPANY_TITLE"]
-          - print:   ["Suggestion type: %s", result.type]
-
-# The fully qualified name of the API interface.
 - name: google.cloud.talent.v4beta1.EventService
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
   methods:
   - name: CreateClientEvent
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - client_event
-    required_fields:
-    - parent
-    - client_event
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: tenant_or_project
-    timeout_millis: 30000
-    samples:
-      standalone:
-      - value_sets: [job_search_create_client_event]
-        region_tag: job_search_create_client_event
-    sample_value_sets:
-    - id: job_search_create_client_event
-      description: Creates a client event
-      parameters:
-        defaults:
-        - parent%project="Your Google Cloud Project ID"
-        - parent%tenant="Your Tenant ID (using tenancy is optional)"
-        - client_event.request_id="[request_id from ResponseMetadata]"
-        - client_event.event_id="[Set this to a unique identifier]"
-        #  https://github.com/googleapis/gapic-generator/issues/2762
-        # - client_event.create_time="1972-01-01T10:00:20.021Z"
-        - client_event.create_time.seconds=0
-        - client_event.job_event.type=VIEW
-        - client_event.job_event.jobs[0]="projects/[Project ID]/tenants/[Tenant ID]/jobs/[Job ID]"
-        - client_event.job_event.jobs[1]="projects/[Project ID]/tenants/[Tenant ID]/jobs/[Job ID]"
-        attributes:
-        - parameter: parent%project
-          sample_argument_name: project_id
-          description: Your Google Cloud Project ID
-        - parameter: parent%tenant
-          sample_argument_name: tenant_id
-          description: Identifier of the Tenant
-        - parameter: client_event.request_id
-          sample_argument_name: request_id
-          description: |
-            A unique ID generated in the API responses.
-            Value should be set to the request_id from an API response.
-        - parameter: client_event.event_id
-          sample_argument_name: event_id
-          description: A unique identifier, generated by the client application
-        - parameter: client_event.create_time.seconds
-          description: |
-            The timestamp of the event as seconds of UTC time since Unix epoch
-            For more information on how to create google.protobuf.Timestamps
-            See: https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/timestamp.proto
-        - parameter: client_event.job_event.type
-          description: The type of event attributed to the behavior of the end user
-        - parameter: client_event.job_event.jobs[0]
-          description: List of job names associated with this event
-      on_success:
-      - print: ["Created client event"]
-# The fully qualified name of the API interface.
 - name: google.cloud.talent.v4beta1.JobService
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
+  deprecated_collections:
+  - name_pattern: projects/{project}/jobs/{job}
+    entity_name: job_without_tenant
+  - name_pattern: projects/{project}/tenants/{tenant}/jobs/{job}
+    entity_name: job
   methods:
-  - name: CreateJob
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - job
-    required_fields:
-    - parent
-    - job
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: tenant_or_project
-      job.company: company_oneof
-    timeout_millis: 30000
-    samples:
-      standalone:
-      - value_sets: [job_search_create_job]
-        region_tag: job_search_create_job
-      - value_sets: [job_search_create_job_custom_attributes]
-        region_tag: job_search_create_job_custom_attributes
-    sample_value_sets:
-    - id: job_search_create_job
-      description: Create Job
-      parameters:
-        defaults:
-        - parent%project="Your Google Cloud Project ID"
-        - parent%tenant="Your Tenant ID (using tenancy is optional)"
-        ## # Currently cannot generate code which uses the helper methods to generate
-        ## # the company name using the projectId and companyId. Instead the user
-        ## # has to provide the full projects/X/companies/Y string path.
-        ## # See: https://github.com/googleapis/gapic-generator/issues/2621
-        # - job.company.project%project="Your Google Cloud Project ID"
-        # - job.company.company%company="Company ID"
-        - job.company="Company name, e.g. projects/your-project/companies/company-id"
-        ##
-        - job.requisition_id="Job requisition ID, aka Posting ID. Unique per job."
-        - job.title="Software Engineer"
-        - job.description="This is a description of this wonderful job!"
-        - job.application_info.uris[0]="https://www.example.org/job-posting/123"
-        - job.addresses[0]="1600 Amphitheatre Parkway, Mountain View, CA 94043"
-        - job.addresses[1]="111 8th Avenue, New York, NY 10011"
-        - job.language_code="en-US"
-        attributes:
-        - parameter: parent%project
-          sample_argument_name: project_id
-          description: Your Google Cloud Project ID
-        - parameter: parent%tenant
-          sample_argument_name: tenant_id
-          description: Identifier of the Tenant
-        - parameter: job.company
-          sample_argument_name: company_name
-        - parameter: job.requisition_id
-          sample_argument_name: requisition_id
-        - parameter: job.title
-          sample_argument_name: title
-        - parameter: job.description
-          sample_argument_name: description
-        - parameter: job.application_info.uris[0]
-          sample_argument_name: job_application_url
-        - parameter: job.addresses[0]
-          sample_argument_name: address_one
-        - parameter: job.addresses[1]
-          sample_argument_name: address_two
-        - parameter: job.language_code
-          sample_argument_name: language_code
-      on_success:
-      - print:
-        - "Created job: %s"
-        - $resp.name
-    - id: job_search_create_job_custom_attributes
-      description: Create Job with Custom Attributes
-      parameters:
-        defaults:
-        - parent%project="Your Google Cloud Project ID"
-        - parent%tenant="Your Tenant ID (using tenancy is optional)"
-        - job.company="Company name, e.g. projects/your-project/companies/company-id"
-        - job.requisition_id="Job requisition ID, aka Posting ID. Unique per job."
-        - job.language_code="en-US"
-        # - custom_attributes["my_attribute"][0]="My attribute value"
-        attributes:
-        - parameter: parent%project
-          sample_argument_name: project_id
-          description: Your Google Cloud Project ID
-        - parameter: parent%tenant
-          sample_argument_name: tenant_id
-          description: Identifier of the Tenantd
-        - parameter: job.company
-          sample_argument_name: company_name
-        - parameter: job.requisition_id
-          sample_argument_name: requisition_id
-        - parameter: job.language_code
-          sample_argument_name: language_code
-      on_success:
-      - print:
-        - "Created job: %s"
-        - $resp.name
-  - name: GetJob
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: job_oneof
-    timeout_millis: 30000
-    samples:
-      standalone:
-      - value_sets: [job_search_get_job]
-        region_tag: job_search_get_job
-    sample_value_sets:
-    - id: job_search_get_job
-      description: Get Job
-      parameters:
-        defaults:
-        - name%project="Your Google Cloud Project ID"
-        - name%tenant="Your Tenant ID (using tenancy is optional)"
-        - name%jobs="Job ID"
-        attributes:
-        - parameter: name%project
-          sample_argument_name: project_id
-        - parameter: name%tenant
-          sample_argument_name: tenant_id
-        - parameter: name%jobs
-          sample_argument_name: job_id
-      on_success:
-      - print: ["Job name: %s", $resp.name]
-      - print: ["Requisition ID: %s", $resp.requisition_id]
-      - print: ["Title: %s", $resp.title]
-      - print: ["Description: %s", $resp.description]
-      - print: ["Posting language: %s", $resp.language_code]
-      - loop:
-          collection: $resp.addresses
-          variable: address
-          body:
-          - print: ["Address: %s", address]
-      - loop:
-          collection: $resp.application_info.emails
-          variable: email
-          body:
-          - print: ["Email: %s", email]
-      - loop:
-          collection: $resp.application_info.uris
-          variable: website_uri
-          body:
-          - print: ["Website: %s", website_uri]
-  - name: UpdateJob
-    flattening:
-      groups:
-      - parameters:
-        - job
-    required_fields:
-    - job
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      job.name: job_oneof
-      job.company: company_oneof
-    timeout_millis: 30000
   - name: DeleteJob
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: job_oneof
-    timeout_millis: 30000
-    samples:
-      standalone:
-      - value_sets: [job_search_delete_job]
-        region_tag: job_search_delete_job
-    sample_value_sets:
-    - id: job_search_delete_job
-      description: Delete Job
-      parameters:
-        defaults:
-        - name%project="Your Google Cloud Project ID"
-        - name%tenant="Your Tenant ID (using tenancy is optional)"
-        - name%jobs="Company ID"
-        attributes:
-        - parameter: name%project
-          sample_argument_name: project_id
-        - parameter: name%tenant
-          sample_argument_name: tenant_id
-        - parameter: name%jobs
-          sample_argument_name: job_id
-      on_success:
-      - print:
-        - "Deleted job."
-  - name: ListJobs
-    samples:
-      standalone:
-      - value_sets: [job_search_list_jobs]
-        region_tag: job_search_list_jobs
-    sample_value_sets:
-    - id: job_search_list_jobs
-      description: List Jobs
-      parameters:
-        defaults:
-        - parent%project="Your Google Cloud Project ID"
-        - parent%tenant="Your Tenant ID (using tenancy is optional)"
-        - filter="companyName=projects/my-project/companies/company-id"
-        attributes:
-        - parameter: parent%project
-          sample_argument_name: project_id
-          description: Your Google Cloud Project ID
-        - parameter: parent%tenant
-          sample_argument_name: tenant_id
-          description: Identifier of the Tenant
-        - parameter: filter
-          sample_argument_name: filter
-      on_success:
-      - print:
-        - "Job name: %s"
-        - $resp.name
-      - print:
-        - "Job requisition ID: %s"
-        - $resp.requisition_id
-      - print:
-        - "Job title: %s"
-        - $resp.title
-      - print:
-        - "Job description: %s"
-        - $resp.description
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - filter
-    required_fields:
-    - parent
-    - filter
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: jobs
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: tenant_or_project
-    timeout_millis: 30000
-  - name: BatchDeleteJobs
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - filter
-    required_fields:
-    - parent
-    - filter
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: tenant_or_project
-    timeout_millis: 30000
-    samples:
-      standalone:
-      - value_sets: [job_search_batch_delete_job]
-        region_tag: job_search_batch_delete_job
-    sample_value_sets:
-    - id: job_search_batch_delete_job
-      description: Batch delete jobs using a filter
-      parameters:
-        defaults:
-        - parent%project="Your Google Cloud Project ID"
-        - parent%tenant="Your Tenant ID (using tenancy is optional)"
-        - filter="[Query]"
-        attributes:
-        - parameter: parent%project
-          sample_argument_name: project_id
-          description: Your Google Cloud Project ID
-        - parameter: parent%tenant
-          sample_argument_name: tenant_id
-          description: Identifier of the Tenantd
-        - parameter: filter
-          sample_argument_name: filter
-          description: |
-            The filter string specifies the jobs to be deleted.
-            For example:
-              companyName = "projects/api-test-project/companies/123" AND equisitionId = "req-1"
-      on_success:
-      - print: ["Batch deleted jobs from filter"]
-  - name: SearchJobs
-    required_fields:
-    - parent
-    - request_metadata
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: matching_jobs
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: tenant_or_project
-    timeout_millis: 30000
-    samples:
-      standalone:
-      - value_sets: [job_search_custom_ranking_search]
-        region_tag: job_search_custom_ranking_search
-      - value_sets: [job_search_commute_search]
-        region_tag: job_search_commute_search
-      - value_sets: [job_search_histogram_search]
-        region_tag: job_search_histogram_search
-    sample_value_sets:
-    - id: job_search_custom_ranking_search
-      description: Search Jobs using custom rankings
-      parameters:
-        defaults:
-        - parent%project="Your Google Cloud Project ID"
-        - parent%tenant="Your Tenant ID (using tenancy is optional)"
-        # - job_query.company_names[0]="projects/[Project ID]/companies/[Company ID]"
-        - request_metadata.domain="www.example.com"
-        - request_metadata.session_id="Hashed session identifier"
-        - request_metadata.user_id="Hashed user identifier"
-        - custom_ranking_info.importance_level=EXTREME
-        - custom_ranking_info.ranking_expression="(someFieldLong + 25) * 0.25"
-        - order_by="custom_ranking desc"
-        attributes:
-        - parameter: parent%project
-          sample_argument_name: project_id
-          description: Your Google Cloud Project ID
-        - parameter: parent%tenant
-          sample_argument_name: tenant_id
-          description: Identifier of the Tenantd
-      on_success:
-      - print: ["Job summary: %s", $resp.job_summary]
-      - print: ["Job title snippet: %s", $resp.job_title_snippet]
-      - define: job=$resp.job
-      - print: ["Job name: %s", job.name]
-      - print: ["Job title: %s", job.title]
-    - id: job_search_commute_search
-      description: Search Jobs using commute distance
-      parameters:
-        defaults:
-        - parent%project="Your Google Cloud Project ID"
-        - parent%tenant="Your Tenant ID (using tenancy is optional)"
-        # - job_query.company_names[0]="projects/[Project ID]/companies/[Company ID]"
-        - request_metadata.domain="www.example.com"
-        - request_metadata.session_id="Hashed session identifier"
-        - request_metadata.user_id="Hashed user identifier"
-        - job_query.commute_filter.commute_method=TRANSIT
-        # 30 minutes
-        - job_query.commute_filter.travel_duration.seconds=1800
-        - job_query.commute_filter.start_coordinates.latitude=37.422408
-        - job_query.commute_filter.start_coordinates.longitude=-122.084068
-        attributes:
-        - parameter: parent%project
-          sample_argument_name: project_id
-        - parameter: parent%tenant
-          sample_argument_name: tenant_id
-      on_success:
-      - print: ["Job summary: %s", $resp.job_summary]
-      - print: ["Job title snippet: %s", $resp.job_title_snippet]
-      - define: job=$resp.job
-      - print: ["Job name: %s", job.name]
-      - print: ["Job title: %s", job.title]
-    - id: job_search_histogram_search
-      description: Search Jobs with histogram queries
-      parameters:
-        defaults:
-        - parent%project="Your Google Cloud Project ID"
-        - parent%tenant="Your Tenant ID (using tenancy is optional)"
-        - request_metadata.domain="www.example.com"
-        - request_metadata.session_id="Hashed session identifier"
-        - request_metadata.user_id="Hashed user identifier"
-        - histogram_queries[0].histogram_query="count(base_compensation, [bucket(12, 20)])"
-        attributes:
-        - parameter: parent%project
-          sample_argument_name: project_id
-        - parameter: parent%tenant
-          sample_argument_name: tenant_id
-        - parameter: histogram_queries[0].histogram_query
-          sample_argument_name: query
-          description: |
-            Histogram query
-            More info on histogram facets, constants, and built-in functions:
-            https://godoc.org/google.golang.org/genproto/googleapis/cloud/talent/v4beta1#SearchJobsRequest
-      on_success:
-      - print: ["Job summary: %s", $resp.job_summary]
-      - print: ["Job title snippet: %s", $resp.job_title_snippet]
-      - define: job=$resp.job
-      - print: ["Job name: %s", job.name]
-      - print: ["Job title: %s", job.title]
-  - name: SearchJobsForAlert
-    required_fields:
-    - parent
-    - request_metadata
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: matching_jobs
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: tenant_or_project
-    timeout_millis: 30000
-  - name: BatchCreateJobs
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - jobs
-    required_fields:
-    - parent
-    - jobs
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: tenant
-    long_running:
-      return_type: google.cloud.talent.v4beta1.JobOperationResult
-      metadata_type: google.cloud.talent.v4beta1.BatchOperationMetadata
-      initial_poll_delay_millis: 500
-      poll_delay_multiplier: 1.5
-      max_poll_delay_millis: 5000
-      total_poll_timeout_millis: 300000
-    timeout_millis: 60000
-    samples:
-      standalone:
-      - value_sets: [job_search_batch_create_jobs]
-        region_tag: job_search_batch_create_jobs
-    sample_value_sets:
-    - id: job_search_batch_create_jobs
-      description: Batch Create Jobs
-      parameters:
-        defaults:
-        - parent%project="Your Google Cloud Project ID"
-        - parent%tenant="Your Tenant ID (using tenancy is optional)"
-        ## # Currently cannot generate code which uses the helper methods to generate
-        ## # the company name using the projectId and companyId. Instead the user
-        ## # has to provide the full projects/X/companies/Y string path.
-        ## # See: https://github.com/googleapis/gapic-generator/issues/2621
-        # - job.company.project%project="Your Google Cloud Project ID"
-        # - job.company.company%company="Company ID"
-        - jobs[0].company="Company name, e.g. projects/your-project/companies/company-id"
-        - jobs[0].requisition_id="Job requisition ID, aka Posting ID. Unique per job."
-        - jobs[0].title="Software Engineer"
-        - jobs[0].description="This is a description of this wonderful job!"
-        - jobs[0].application_info.uris[0]="https://www.example.org/job-posting/123"
-        - jobs[0].addresses[0]="1600 Amphitheatre Parkway, Mountain View, CA 94043"
-        - jobs[0].language_code="en-US"
-        - jobs[1].company="Company name, e.g. projects/your-project/companies/company-id"
-        - jobs[1].requisition_id="Job requisition ID, aka Posting ID. Unique per job."
-        - jobs[1].title="Quality Assurance"
-        - jobs[1].description="This is a description of this wonderful job!"
-        - jobs[1].application_info.uris[0]="https://www.example.org/job-posting/123"
-        - jobs[1].addresses[0]="111 8th Avenue, New York, NY 10011"
-        - jobs[1].language_code="en-US"
-        attributes:
-        - parameter: parent%project
-          sample_argument_name: project_id
-          description: Your Google Cloud Project ID
-        - parameter: parent%tenant
-          sample_argument_name: tenant_id
-          description: Identifier of the Tenant
-        - parameter: jobs[0].company
-          sample_argument_name: company_name_one
-        - parameter: jobs[0].requisition_id
-          sample_argument_name: requisition_id_one
-        - parameter: jobs[0].title
-          sample_argument_name: title_one
-        - parameter: jobs[0].description
-          sample_argument_name: description_one
-        - parameter: jobs[0].application_info.uris[0]
-          sample_argument_name: job_application_url_one
-        - parameter: jobs[0].addresses[0]
-          sample_argument_name: address_one
-        - parameter: jobs[0].language_code
-          sample_argument_name: language_code_one
-        - parameter: jobs[1].company
-          sample_argument_name: company_name_two
-        - parameter: jobs[1].requisition_id
-          sample_argument_name: requisition_id_two
-        - parameter: jobs[1].title
-          sample_argument_name: title_two
-        - parameter: jobs[1].description
-          sample_argument_name: description_two
-        - parameter: jobs[1].application_info.uris[0]
-          sample_argument_name: job_application_url_two
-        - parameter: jobs[1].addresses[0]
-          sample_argument_name: address_two
-        - parameter: jobs[1].language_code
-          sample_argument_name: language_code_two
-      on_success:
-      - print:
-        - "Batch response: %s"
-        - $resp
-  - name: BatchUpdateJobs
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - jobs
-    required_fields:
-    - parent
-    - jobs
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: tenant
-    long_running:
-      return_type: google.cloud.talent.v4beta1.JobOperationResult
-      metadata_type: google.cloud.talent.v4beta1.BatchOperationMetadata
-      initial_poll_delay_millis: 500
-      poll_delay_multiplier: 1.5
-      max_poll_delay_millis: 5000
-      total_poll_timeout_millis: 300000
-    timeout_millis: 60000
-    samples:
-      standalone:
-      - value_sets: [job_search_batch_update_jobs]
-        region_tag: job_search_batch_update_jobs
-    sample_value_sets:
-    - id: job_search_batch_update_jobs
-      description: Batch Update Jobs
-      parameters:
-        defaults:
-        - parent%project="Your Google Cloud Project ID"
-        - parent%tenant="Your Tenant ID (using tenancy is optional)"
-        ## # Currently cannot generate code which uses the helper methods to generate
-        ## # the company name using the projectId and companyId. Instead the user
-        ## # has to provide the full projects/X/companies/Y string path.
-        ## # See: https://github.com/googleapis/gapic-generator/issues/2621
-        # - job.company.project%project="Your Google Cloud Project ID"
-        # - job.company.company%company="Company ID"
-        - jobs[0].name = "job name, e.g. projects/your-project/tenants/tenant-id/jobs/job-id"
-        - jobs[0].company="Company name, e.g. projects/your-project/companies/company-id"
-        - jobs[0].requisition_id="Job requisition ID, aka Posting ID. Unique per job."
-        - jobs[0].title="Software Engineer"
-        - jobs[0].description="This is a description of this wonderful job!"
-        - jobs[0].application_info.uris[0]="https://www.example.org/job-posting/123"
-        - jobs[0].addresses[0]="1600 Amphitheatre Parkway, Mountain View, CA 94043"
-        - jobs[0].language_code="en-US"
-        - jobs[1].name = "job name, e.g. projects/your-project/tenants/tenant-id/jobs/job-id"
-        - jobs[1].company="Company name, e.g. projects/your-project/companies/company-id"
-        - jobs[1].requisition_id="Job requisition ID, aka Posting ID. Unique per job."
-        - jobs[1].title="Quality Assurance"
-        - jobs[1].description="This is a description of this wonderful job!"
-        - jobs[1].application_info.uris[0]="https://www.example.org/job-posting/123"
-        - jobs[1].addresses[0]="111 8th Avenue, New York, NY 10011"
-        - jobs[1].language_code="en-US"
-        attributes:
-        - parameter: parent%project
-          sample_argument_name: project_id
-          description: Your Google Cloud Project ID
-        - parameter: parent%tenant
-          sample_argument_name: tenant_id
-          description: Identifier of the Tenant
-        - parameter: jobs[0].name
-          sample_argument_name: job_name_one
-        - parameter: jobs[0].company
-          sample_argument_name: company_name_one
-        - parameter: jobs[0].requisition_id
-          sample_argument_name: requisition_id_one
-        - parameter: jobs[0].title
-          sample_argument_name: title_one
-        - parameter: jobs[0].description
-          sample_argument_name: description_one
-        - parameter: jobs[0].application_info.uris[0]
-          sample_argument_name: job_application_url_one
-        - parameter: jobs[0].addresses[0]
-          sample_argument_name: address_one
-        - parameter: jobs[0].language_code
-          sample_argument_name: language_code_one
-        - parameter: jobs[1].name
-          sample_argument_name: job_name_two
-        - parameter: jobs[1].company
-          sample_argument_name: company_name_two
-        - parameter: jobs[1].requisition_id
-          sample_argument_name: requisition_id_two
-        - parameter: jobs[1].title
-          sample_argument_name: title_two
-        - parameter: jobs[1].description
-          sample_argument_name: description_two
-        - parameter: jobs[1].application_info.uris[0]
-          sample_argument_name: job_application_url_two
-        - parameter: jobs[1].addresses[0]
-          sample_argument_name: address_two
-        - parameter: jobs[1].language_code
-          sample_argument_name: language_code_two
-      on_success:
-      - print:
-        - "Batch response: %s"
-        - $resp
 # The fully qualified name of the API interface.
 - name: google.cloud.talent.v4beta1.ProfileService
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
   methods:
-  - name: ListProfiles
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: profiles
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: tenant
-    timeout_millis: 30000
-  - name: CreateProfile
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - profile
-    required_fields:
-    - parent
-    - profile
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: tenant
-    timeout_millis: 30000
-  - name: GetProfile
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: profile
-    timeout_millis: 30000
-  - name: UpdateProfile
-    flattening:
-      groups:
-      - parameters:
-        - profile
-    required_fields:
-    - profile
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      profile.name: profile
-    timeout_millis: 30000
   - name: DeleteProfile
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: profile
-    timeout_millis: 30000
   - name: SearchProfiles
-    required_fields:
-    - parent
-    - request_metadata
-    resource_name_treatment: STATIC_TYPES
     page_streaming:
       request:
         page_size_field: page_size
@@ -1564,22 +66,7 @@ interfaces:
       response:
         token_field: next_page_token
         resources_field: summarized_profiles
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: tenant
-    timeout_millis: 30000
-# The fully qualified name of the API interface.
 - name: google.cloud.talent.v4beta1.TenantService
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 100
@@ -1588,303 +75,7 @@ interfaces:
     initial_rpc_timeout_millis: 20000
     rpc_timeout_multiplier: 1
     max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
+    total_timeout_millis: 300000
   methods:
-  - name: CreateTenant
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - tenant
-    required_fields:
-    - parent
-    - tenant
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: project
-    timeout_millis: 30000
-    samples:
-      standalone:
-      - value_sets: [job_search_create_tenant]
-        region_tag: job_search_create_tenant
-    sample_value_sets:
-    - id: job_search_create_tenant
-      description: Create Tenant for scoping resources, e.g. companies and jobs
-      parameters:
-        defaults:
-        - parent%project="Your Google Cloud Project ID"
-        - tenant.external_id="Your Unique Identifier for Tenant"
-        attributes:
-        - parameter: parent%project
-          sample_argument_name: project_id
-        - parameter: tenant.external_id
-          sample_argument_name: external_id
-      on_success:
-      - print: ["Created Tenant"]
-      - print: ["Name: %s", $resp.name]
-      - print: ["External ID: %s", $resp.external_id]
-  - name: GetTenant
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: tenant
-    timeout_millis: 30000
-    samples:
-      standalone:
-      - value_sets: [job_search_get_tenant]
-        region_tag: job_search_get_tenant
-    sample_value_sets:
-    - id: job_search_get_tenant
-      description: Get Tenant by name
-      parameters:
-        defaults:
-        - name%project="Your Google Cloud Project ID"
-        - name%tenant="Your Tenant ID"
-        attributes:
-        - parameter: name%project
-          sample_argument_name: project_id
-        - parameter: name%tenant
-          sample_argument_name: tenant_id
-      on_success:
-      - print: ["Name: %s", $resp.name]
-      - print: ["External ID: %s", $resp.external_id]
-  - name: UpdateTenant
-    flattening:
-      groups:
-      - parameters:
-        - tenant
-    required_fields:
-    - tenant
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      tenant.name: tenant
-    timeout_millis: 30000
   - name: DeleteTenant
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: tenant
-    timeout_millis: 30000
-    samples:
-      standalone:
-      - value_sets: [job_search_delete_tenant]
-        region_tag: job_search_delete_tenant
-    sample_value_sets:
-    - id: job_search_delete_tenant
-      description: Delete Tenant
-      parameters:
-        defaults:
-        - name%project="Your Google Cloud Project ID"
-        - name%tenant="Your Tenant ID)"
-        attributes:
-        - parameter: name%project
-          sample_argument_name: project_id
-        - parameter: name%tenant
-          sample_argument_name: tenant_id
-      on_success:
-      - print: ["Deleted Tenant."]
-  - name: ListTenants
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: tenants
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: project
-    timeout_millis: 30000
-    samples:
-      standalone:
-      - value_sets: [job_search_list_tenants]
-        region_tag: job_search_list_tenants
-    sample_value_sets:
-    - id: job_search_list_tenants
-      description: List Tenants
-      parameters:
-        defaults:
-        - parent%project="Your Google Cloud Project ID"
-        - parent%tenant="Your Tenant ID"
-        attributes:
-        - parameter: parent%project
-          sample_argument_name: project_id
-      on_success:
-      - print: ["Tenant Name: %s", $resp.name]
-      - print: ["External ID: %s", $resp.external_id]
-resource_name_generation:
-- message_name: Application
-  field_entity_map:
-    name: application
-- message_name: CreateApplicationRequest
-  field_entity_map:
-    parent: profile
-- message_name: GetApplicationRequest
-  field_entity_map:
-    name: application
-- message_name: DeleteApplicationRequest
-  field_entity_map:
-    name: application
-- message_name: ListApplicationsRequest
-  field_entity_map:
-    parent: profile
-- message_name: Company
-  field_entity_map:
-    name: company_oneof
-- message_name: CreateCompanyRequest
-  field_entity_map:
-    parent: tenant_or_project
-- message_name: GetCompanyRequest
-  field_entity_map:
-    name: company_oneof
-- message_name: DeleteCompanyRequest
-  field_entity_map:
-    name: company_oneof
-- message_name: ListCompaniesRequest
-  field_entity_map:
-    parent: tenant_or_project
-- message_name: CompleteQueryRequest
-  field_entity_map:
-    parent: tenant_or_project
-    company: company_oneof
-- message_name: CreateClientEventRequest
-  field_entity_map:
-    parent: tenant_or_project
-- message_name: Job
-  field_entity_map:
-    name: job_oneof
-    company: company_oneof
-- message_name: CreateJobRequest
-  field_entity_map:
-    parent: tenant_or_project
-    job.company: company_oneof
-- message_name: GetJobRequest
-  field_entity_map:
-    name: job_oneof
-- message_name: DeleteJobRequest
-  field_entity_map:
-    name: job_oneof
-- message_name: ListJobsRequest
-  field_entity_map:
-    parent: tenant_or_project
-- message_name: BatchDeleteJobsRequest
-  field_entity_map:
-    parent: tenant_or_project
-- message_name: SearchJobsRequest
-  field_entity_map:
-    parent: tenant_or_project
-- message_name: SearchJobsForAlertRequest
-  field_entity_map:
-    parent: tenant_or_project
-- message_name: Profile
-  field_entity_map:
-    name: profile
-- message_name: CreateProfileRequest
-  field_entity_map:
-    parent: tenant
-- message_name: GetProfileRequest
-  field_entity_map:
-    name: profile
-- message_name: DeleteProfileRequest
-  field_entity_map:
-    name: profile
-- message_name: ListProfilesRequest
-  field_entity_map:
-    parent: tenant
-- message_name: SearchProfilesRequest
-  field_entity_map:
-    parent: tenant
-- message_name: Tenant
-  field_entity_map:
-    name: tenant
-- message_name: CreateTenantRequest
-  field_entity_map:
-    parent: project
-- message_name: GetTenantRequest
-  field_entity_map:
-    name: tenant
-- message_name: DeleteTenantRequest
-  field_entity_map:
-    name: tenant
-- message_name: ListTenantsRequest
-  field_entity_map:
-    parent: project
diff --git a/third_party/googleapis/google/cloud/talent/v4beta1/talent_grpc_service_config.json b/third_party/googleapis/google/cloud/talent/v4beta1/talent_grpc_service_config.json
new file mode 100755
index 000000000..55bd28e39
--- /dev/null
+++ b/third_party/googleapis/google/cloud/talent/v4beta1/talent_grpc_service_config.json
@@ -0,0 +1,256 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.talent.v4beta1.TenantService",
+          "method": "GetTenant"
+        },
+        {
+          "service": "google.cloud.talent.v4beta1.TenantService",
+          "method": "DeleteTenant"
+        },
+        {
+          "service": "google.cloud.talent.v4beta1.TenantService",
+          "method": "ListTenants"
+        }
+      ],
+      "timeout": "30s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.talent.v4beta1.ApplicationService",
+          "method": "GetApplication"
+        },
+        {
+          "service": "google.cloud.talent.v4beta1.ApplicationService",
+          "method": "DeleteApplication"
+        },
+        {
+          "service": "google.cloud.talent.v4beta1.ApplicationService",
+          "method": "ListApplications"
+        }
+      ],
+      "timeout": "30s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.talent.v4beta1.EventService",
+          "method": "CreateClientEvent"
+        }
+      ],
+      "timeout": "30s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.talent.v4beta1.JobService",
+          "method": "GetJob"
+        },
+        {
+          "service": "google.cloud.talent.v4beta1.JobService",
+          "method": "DeleteJob"
+        },
+        {
+          "service": "google.cloud.talent.v4beta1.JobService",
+          "method": "ListJobs"
+        }
+      ],
+      "timeout": "30s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.talent.v4beta1.ProfileService",
+          "method": "CreateProfile"
+        },
+        {
+          "service": "google.cloud.talent.v4beta1.ProfileService",
+          "method": "UpdateProfile"
+        },
+        {
+          "service": "google.cloud.talent.v4beta1.ProfileService",
+          "method": "SearchProfiles"
+        }
+      ],
+      "timeout": "30s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.talent.v4beta1.JobService",
+          "method": "CreateJob"
+        },
+        {
+          "service": "google.cloud.talent.v4beta1.JobService",
+          "method": "UpdateJob"
+        },
+        {
+          "service": "google.cloud.talent.v4beta1.JobService",
+          "method": "BatchDeleteJobs"
+        },
+        {
+          "service": "google.cloud.talent.v4beta1.JobService",
+          "method": "SearchJobs"
+        },
+        {
+          "service": "google.cloud.talent.v4beta1.JobService",
+          "method": "SearchJobsForAlert"
+        },
+        {
+          "service": "google.cloud.talent.v4beta1.JobService",
+          "method": "BatchCreateJobs"
+        },
+        {
+          "service": "google.cloud.talent.v4beta1.JobService",
+          "method": "BatchUpdateJobs"
+        }
+      ],
+      "timeout": "30s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.talent.v4beta1.ProfileService",
+          "method": "ListProfiles"
+        },
+        {
+          "service": "google.cloud.talent.v4beta1.ProfileService",
+          "method": "GetProfile"
+        },
+        {
+          "service": "google.cloud.talent.v4beta1.ProfileService",
+          "method": "DeleteProfile"
+        }
+      ],
+      "timeout": "30s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.talent.v4beta1.TenantService",
+          "method": "CreateTenant"
+        },
+        {
+          "service": "google.cloud.talent.v4beta1.TenantService",
+          "method": "UpdateTenant"
+        }
+      ],
+      "timeout": "30s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.talent.v4beta1.ApplicationService",
+          "method": "CreateApplication"
+        },
+        {
+          "service": "google.cloud.talent.v4beta1.ApplicationService",
+          "method": "UpdateApplication"
+        }
+      ],
+      "timeout": "30s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.talent.v4beta1.CompanyService",
+          "method": "CreateCompany"
+        },
+        {
+          "service": "google.cloud.talent.v4beta1.CompanyService",
+          "method": "UpdateCompany"
+        }
+      ],
+      "timeout": "30s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.talent.v4beta1.CompanyService",
+          "method": "GetCompany"
+        },
+        {
+          "service": "google.cloud.talent.v4beta1.CompanyService",
+          "method": "DeleteCompany"
+        },
+        {
+          "service": "google.cloud.talent.v4beta1.CompanyService",
+          "method": "ListCompanies"
+        }
+      ],
+      "timeout": "30s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.talent.v4beta1.Completion",
+          "method": "CompleteQuery"
+        }
+      ],
+      "timeout": "30s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/talent/v4beta1/tenant.proto b/third_party/googleapis/google/cloud/talent/v4beta1/tenant.proto
index 88deddeca..0328c143a 100644
--- a/third_party/googleapis/google/cloud/talent/v4beta1/tenant.proto
+++ b/third_party/googleapis/google/cloud/talent/v4beta1/tenant.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,14 +11,15 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.talent.v4beta1;
 
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/protobuf/timestamp.proto";
 import "google/api/annotations.proto";
-import "google/cloud/talent/v4beta1/common.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/talent/v4beta1;talent";
 option java_multiple_files = true;
@@ -31,6 +32,11 @@ option objc_class_prefix = "CTS";
 // profiles. Customer may create multiple tenants to provide data isolation for
 // different groups.
 message Tenant {
+  option (google.api.resource) = {
+    type: "jobs.googleapis.com/Tenant"
+    pattern: "projects/{project}/tenants/{tenant}"
+  };
+
   // Enum that represents how user data owned by the tenant is used.
   enum DataUsageType {
     // Default value.
@@ -51,27 +57,23 @@ message Tenant {
   // tenant is created.
   //
   // The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-  // "projects/api-test-project/tenants/foo".
+  // "projects/foo/tenants/bar".
   string name = 1;
 
-  // Required. Client side tenant identifier, used to uniquely identify the
-  // tenant.
+  // Required. Client side tenant identifier, used to uniquely identify the tenant.
   //
   // The maximum number of allowed characters is 255.
-  string external_id = 2;
+  string external_id = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional. Indicates whether data owned by this tenant may be used to
-  // provide product improvements across other tenants.
+  // Indicates whether data owned by this tenant may be used to provide product
+  // improvements across other tenants.
   //
-  // Defaults behavior is
-  // [DataUsageType.ISOLATED][google.cloud.talent.v4beta1.Tenant.DataUsageType.ISOLATED]
-  // if it's unset.
+  // Defaults behavior is [DataUsageType.ISOLATED][google.cloud.talent.v4beta1.Tenant.DataUsageType.ISOLATED] if it's unset.
   DataUsageType usage_type = 3;
 
-  // Optional. A list of keys of filterable
-  // [Profile.custom_attributes][google.cloud.talent.v4beta1.Profile.custom_attributes],
-  // whose corresponding `string_values` are used in keyword searches. Profiles
-  // with `string_values` under these specified field keys are returned if any
+  // A list of keys of filterable [Profile.custom_attributes][google.cloud.talent.v4beta1.Profile.custom_attributes], whose
+  // corresponding `string_values` are used in keyword searches. Profiles with
+  // `string_values` under these specified field keys are returned if any
   // of the values match the search keyword. Custom field values with
   // parenthesis, brackets and special symbols are not searchable as-is,
   // and must be surrounded by quotes.
diff --git a/third_party/googleapis/google/cloud/talent/v4beta1/tenant_service.proto b/third_party/googleapis/google/cloud/talent/v4beta1/tenant_service.proto
index 33b7f5384..3eb260d8a 100644
--- a/third_party/googleapis/google/cloud/talent/v4beta1/tenant_service.proto
+++ b/third_party/googleapis/google/cloud/talent/v4beta1/tenant_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -19,6 +18,8 @@ package google.cloud.talent.v4beta1;
 
 import "google/api/annotations.proto";
 import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/talent/v4beta1/common.proto";
 import "google/cloud/talent/v4beta1/tenant.proto";
 import "google/protobuf/empty.proto";
@@ -43,6 +44,7 @@ service TenantService {
       post: "/v4beta1/{parent=projects/*}/tenants"
       body: "*"
     };
+    option (google.api.method_signature) = "parent,tenant";
   }
 
   // Retrieves specified tenant.
@@ -50,6 +52,7 @@ service TenantService {
     option (google.api.http) = {
       get: "/v4beta1/{name=projects/*/tenants/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Updates specified tenant.
@@ -58,6 +61,7 @@ service TenantService {
       patch: "/v4beta1/{tenant.name=projects/*/tenants/*}"
       body: "*"
     };
+    option (google.api.method_signature) = "tenant";
   }
 
   // Deletes specified tenant.
@@ -65,6 +69,7 @@ service TenantService {
     option (google.api.http) = {
       delete: "/v4beta1/{name=projects/*/tenants/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists all tenants associated with the project.
@@ -72,6 +77,7 @@ service TenantService {
     option (google.api.http) = {
       get: "/v4beta1/{parent=projects/*}/tenants"
     };
+    option (google.api.method_signature) = "parent";
   }
 }
 
@@ -80,11 +86,16 @@ message CreateTenantRequest {
   // Required. Resource name of the project under which the tenant is created.
   //
   // The format is "projects/{project_id}", for example,
-  // "projects/api-test-project".
-  string parent = 1;
+  // "projects/foo".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
   // Required. The tenant to be created.
-  Tenant tenant = 2;
+  Tenant tenant = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for getting a tenant by name.
@@ -92,28 +103,27 @@ message GetTenantRequest {
   // Required. The resource name of the tenant to be retrieved.
   //
   // The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-  // "projects/api-test-project/tenants/foo".
-  string name = 1;
+  // "projects/foo/tenants/bar".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "jobs.googleapis.com/Tenant"
+    }
+  ];
 }
 
 // Request for updating a specified tenant.
 message UpdateTenantRequest {
-  // Required. The tenant resource to replace the current resource in the
-  // system.
-  Tenant tenant = 1;
+  // Required. The tenant resource to replace the current resource in the system.
+  Tenant tenant = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional but strongly recommended for the best service
-  // experience.
+  // Strongly recommended for the best service experience.
   //
-  // If
-  // [update_mask][google.cloud.talent.v4beta1.UpdateTenantRequest.update_mask]
-  // is provided, only the specified fields in
-  // [tenant][google.cloud.talent.v4beta1.UpdateTenantRequest.tenant] are
-  // updated. Otherwise all the fields are updated.
+  // If [update_mask][google.cloud.talent.v4beta1.UpdateTenantRequest.update_mask] is provided, only the specified fields in
+  // [tenant][google.cloud.talent.v4beta1.UpdateTenantRequest.tenant] are updated. Otherwise all the fields are updated.
   //
   // A field mask to specify the tenant fields to be updated. Only
-  // top level fields of [Tenant][google.cloud.talent.v4beta1.Tenant] are
-  // supported.
+  // top level fields of [Tenant][google.cloud.talent.v4beta1.Tenant] are supported.
   google.protobuf.FieldMask update_mask = 2;
 }
 
@@ -122,8 +132,13 @@ message DeleteTenantRequest {
   // Required. The resource name of the tenant to be deleted.
   //
   // The format is "projects/{project_id}/tenants/{tenant_id}", for example,
-  // "projects/api-test-project/tenants/foo".
-  string name = 1;
+  // "projects/foo/tenants/bar".
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "jobs.googleapis.com/Tenant"
+    }
+  ];
 }
 
 // List tenants for which the client has ACL visibility.
@@ -131,19 +146,22 @@ message ListTenantsRequest {
   // Required. Resource name of the project under which the tenant is created.
   //
   // The format is "projects/{project_id}", for example,
-  // "projects/api-test-project".
-  string parent = 1;
-
-  // Optional. The starting indicator from which to return results.
+  // "projects/foo".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
+
+  // The starting indicator from which to return results.
   string page_token = 2;
 
-  // Optional. The maximum number of tenants to be returned, at most 100.
+  // The maximum number of tenants to be returned, at most 100.
   // Default is 100 if a non-positive number is provided.
   int32 page_size = 3;
 }
 
-// Output only.
-//
 // The List tenants response object.
 message ListTenantsResponse {
   // Tenants for the current client.
diff --git a/third_party/googleapis/google/cloud/tasks/BUILD.bazel b/third_party/googleapis/google/cloud/tasks/BUILD.bazel
index 1e5b8c2af..a87c57fec 100644
--- a/third_party/googleapis/google/cloud/tasks/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/tasks/BUILD.bazel
@@ -1 +1 @@
-exports_files(glob(["*.yaml"]))
\ No newline at end of file
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/cloud/tasks/artman_cloudtasks_v2.yaml b/third_party/googleapis/google/cloud/tasks/artman_cloudtasks_v2.yaml
index f3af7e6d4..0ab0b07d5 100644
--- a/third_party/googleapis/google/cloud/tasks/artman_cloudtasks_v2.yaml
+++ b/third_party/googleapis/google/cloud/tasks/artman_cloudtasks_v2.yaml
@@ -3,13 +3,14 @@ common:
   api_version: v2
   organization_name: google-cloud
   proto_deps:
-    - name: google-common-protos
-    - name: google-iam-v1
-      proto_path: google/iam/v1
+  - name: google-common-protos
+  - name: google-iam-v1
+    proto_path: google/iam/v1
   src_proto_paths:
   - v2
-  service_yaml: cloudtasks_v2.yaml
+  service_yaml: v2/cloudtasks_v2.yaml
   gapic_yaml: v2/cloudtasks_gapic.yaml
+  proto_package: google.cloud.tasks.v2
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/cloud/tasks/artman_cloudtasks_v2beta2.yaml b/third_party/googleapis/google/cloud/tasks/artman_cloudtasks_v2beta2.yaml
index f19712010..7a8113feb 100644
--- a/third_party/googleapis/google/cloud/tasks/artman_cloudtasks_v2beta2.yaml
+++ b/third_party/googleapis/google/cloud/tasks/artman_cloudtasks_v2beta2.yaml
@@ -3,11 +3,12 @@ common:
   api_version: v2beta2
   organization_name: google-cloud
   proto_deps:
-    - name: google-common-protos
+  - name: google-common-protos
   src_proto_paths:
   - v2beta2
-  service_yaml: cloudtasks_v2beta2.yaml
+  service_yaml: v2beta2/cloudtasks_v2beta2.yaml
   gapic_yaml: v2beta2/cloudtasks_gapic.yaml
+  proto_package: google.cloud.tasks.v2beta2
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/cloud/tasks/artman_cloudtasks_v2beta3.yaml b/third_party/googleapis/google/cloud/tasks/artman_cloudtasks_v2beta3.yaml
index d72d92d8f..0335c5c43 100644
--- a/third_party/googleapis/google/cloud/tasks/artman_cloudtasks_v2beta3.yaml
+++ b/third_party/googleapis/google/cloud/tasks/artman_cloudtasks_v2beta3.yaml
@@ -3,13 +3,14 @@ common:
   api_version: v2beta3
   organization_name: google-cloud
   proto_deps:
-    - name: google-common-protos
-    - name: google-iam-v1
-      proto_path: google/iam/v1
+  - name: google-common-protos
+  - name: google-iam-v1
+    proto_path: google/iam/v1
   src_proto_paths:
   - v2beta3
-  service_yaml: cloudtasks_v2beta3.yaml
+  service_yaml: v2beta3/cloudtasks_v2beta3.yaml
   gapic_yaml: v2beta3/cloudtasks_gapic.yaml
+  proto_package: google.cloud.tasks.v2beta3
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/cloud/tasks/cloudtasks_v2beta2.yaml b/third_party/googleapis/google/cloud/tasks/cloudtasks_v2beta2.yaml
deleted file mode 100644
index 65a96d45c..000000000
--- a/third_party/googleapis/google/cloud/tasks/cloudtasks_v2beta2.yaml
+++ /dev/null
@@ -1,71 +0,0 @@
-type: google.api.Service
-config_version: 3
-name: cloudtasks.googleapis.com
-title: Cloud Tasks API
-
-apis:
-- name: google.cloud.tasks.v2beta2.CloudTasks
-
-enums:
-- name: google.rpc.Code
-
-documentation:
-  summary: Manages the execution of large numbers of distributed requests.
-  overview: |-
-    Cloud Tasks manages the execution of large numbers of distributed requests.
-
-    For more information, see https://cloud.google.com/tasks/.
-
-backend:
-  rules:
-  - selector: google.cloud.location.Locations.ListLocations
-    deadline: 10.0
-  - selector: google.cloud.location.Locations.GetLocation
-    deadline: 10.0
-  - selector: google.cloud.tasks.v2beta2.CloudTasks.ListQueues
-    deadline: 15.0
-  - selector: google.cloud.tasks.v2beta2.CloudTasks.GetQueue
-    deadline: 10.0
-  - selector: google.cloud.tasks.v2beta2.CloudTasks.CreateQueue
-    deadline: 10.0
-  - selector: google.cloud.tasks.v2beta2.CloudTasks.UpdateQueue
-    deadline: 10.0
-  - selector: google.cloud.tasks.v2beta2.CloudTasks.DeleteQueue
-    deadline: 10.0
-  - selector: google.cloud.tasks.v2beta2.CloudTasks.PurgeQueue
-    deadline: 10.0
-  - selector: google.cloud.tasks.v2beta2.CloudTasks.PauseQueue
-    deadline: 10.0
-  - selector: google.cloud.tasks.v2beta2.CloudTasks.ResumeQueue
-    deadline: 10.0
-  - selector: google.cloud.tasks.v2beta2.CloudTasks.GetIamPolicy
-    deadline: 10.0
-  - selector: google.cloud.tasks.v2beta2.CloudTasks.SetIamPolicy
-    deadline: 10.0
-  - selector: google.cloud.tasks.v2beta2.CloudTasks.TestIamPermissions
-    deadline: 10.0
-  - selector: google.cloud.tasks.v2beta2.CloudTasks.ListTasks
-    deadline: 10.0
-  - selector: google.cloud.tasks.v2beta2.CloudTasks.GetTask
-    deadline: 10.0
-  - selector: google.cloud.tasks.v2beta2.CloudTasks.CreateTask
-    deadline: 10.0
-  - selector: google.cloud.tasks.v2beta2.CloudTasks.DeleteTask
-    deadline: 10.0
-  - selector: google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks
-    deadline: 10.0
-  - selector: google.cloud.tasks.v2beta2.CloudTasks.AcknowledgeTask
-    deadline: 10.0
-  - selector: google.cloud.tasks.v2beta2.CloudTasks.RenewLease
-    deadline: 10.0
-  - selector: google.cloud.tasks.v2beta2.CloudTasks.CancelLease
-    deadline: 10.0
-  - selector: google.cloud.tasks.v2beta2.CloudTasks.RunTask
-    deadline: 10.0
-
-authentication:
-  rules:
-  - selector: '*'
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/tasks/v2/BUILD.bazel b/third_party/googleapis/google/cloud/tasks/v2/BUILD.bazel
new file mode 100644
index 000000000..c91328995
--- /dev/null
+++ b/third_party/googleapis/google/cloud/tasks/v2/BUILD.bazel
@@ -0,0 +1,378 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "tasks_proto",
+    srcs = [
+        "cloudtasks.proto",
+        "queue.proto",
+        "target.proto",
+        "task.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/iam/v1:iam_policy_proto",
+        "//google/iam/v1:policy_proto",
+        "//google/rpc:status_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "tasks_proto_with_info",
+    deps = [
+        ":tasks_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "tasks_java_proto",
+    deps = [":tasks_proto"],
+)
+
+java_grpc_library(
+    name = "tasks_java_grpc",
+    srcs = [":tasks_proto"],
+    deps = [":tasks_java_proto"],
+)
+
+java_gapic_library(
+    name = "tasks_java_gapic",
+    src = ":tasks_proto_with_info",
+    gapic_yaml = "cloudtasks_gapic.yaml",
+    package = "google.cloud.tasks.v2",
+    service_yaml = "cloudtasks_v2.yaml",
+    test_deps = [
+        ":tasks_java_grpc",
+        "//google/iam/v1:iam_java_grpc",
+    ],
+    deps = [
+        ":tasks_java_proto",
+        "//google/iam/v1:iam_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "tasks_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.tasks.v2.CloudTasksClientTest",
+    ],
+    runtime_deps = [":tasks_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-tasks-v2-java",
+    deps = [
+        ":tasks_java_gapic",
+        ":tasks_java_grpc",
+        ":tasks_java_proto",
+        ":tasks_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "tasks_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/tasks/v2",
+    protos = [":tasks_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/iam/v1:iam_go_proto",
+        "//google/rpc:status_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "tasks_go_gapic",
+    srcs = [":tasks_proto_with_info"],
+    grpc_service_config = "cloudtasks_grpc_service_config.json",
+    importpath = "cloud.google.com/go/cloudtasks/apiv2;tasks",
+    service_yaml = "cloudtasks_v2.yaml",
+    deps = [
+        ":tasks_go_proto",
+        "//google/iam/v1:iam_go_proto",
+    ],
+)
+
+go_test(
+    name = "tasks_go_gapic_test",
+    srcs = [":tasks_go_gapic_srcjar_test"],
+    embed = [":tasks_go_gapic"],
+    importpath = "cloud.google.com/go/cloudtasks/apiv2",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-tasks-v2-go",
+    deps = [
+        ":tasks_go_gapic",
+        ":tasks_go_gapic_srcjar-test.srcjar",
+        ":tasks_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "tasks_moved_proto",
+    srcs = [":tasks_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/iam/v1:iam_policy_proto",
+        "//google/iam/v1:policy_proto",
+        "//google/rpc:status_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "tasks_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":tasks_moved_proto"],
+)
+
+py_grpc_library(
+    name = "tasks_py_grpc",
+    srcs = [":tasks_moved_proto"],
+    deps = [":tasks_py_proto"],
+)
+
+py_gapic_library(
+    name = "tasks_py_gapic",
+    src = ":tasks_proto_with_info",
+    gapic_yaml = "cloudtasks_gapic.yaml",
+    package = "google.cloud.tasks.v2",
+    service_yaml = "cloudtasks_v2.yaml",
+    deps = [
+        ":tasks_py_grpc",
+        ":tasks_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "tasks-v2-py",
+    deps = [
+        ":tasks_py_gapic",
+        ":tasks_py_grpc",
+        ":tasks_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "tasks_php_proto",
+    deps = [":tasks_proto"],
+)
+
+php_grpc_library(
+    name = "tasks_php_grpc",
+    srcs = [":tasks_proto"],
+    deps = [":tasks_php_proto"],
+)
+
+php_gapic_library(
+    name = "tasks_php_gapic",
+    src = ":tasks_proto_with_info",
+    gapic_yaml = "cloudtasks_gapic.yaml",
+    package = "google.cloud.tasks.v2",
+    service_yaml = "cloudtasks_v2.yaml",
+    deps = [
+        ":tasks_php_grpc",
+        ":tasks_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-tasks-v2-php",
+    deps = [
+        ":tasks_php_gapic",
+        ":tasks_php_grpc",
+        ":tasks_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "tasks_nodejs_gapic",
+    src = ":tasks_proto_with_info",
+    gapic_yaml = "cloudtasks_gapic.yaml",
+    package = "google.cloud.tasks.v2",
+    service_yaml = "cloudtasks_v2.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "tasks-v2-nodejs",
+    deps = [
+        ":tasks_nodejs_gapic",
+        ":tasks_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "tasks_ruby_proto",
+    deps = [":tasks_proto"],
+)
+
+ruby_grpc_library(
+    name = "tasks_ruby_grpc",
+    srcs = [":tasks_proto"],
+    deps = [":tasks_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "tasks_ruby_gapic",
+    src = ":tasks_proto_with_info",
+    gapic_yaml = "cloudtasks_gapic.yaml",
+    package = "google.cloud.tasks.v2",
+    service_yaml = "cloudtasks_v2.yaml",
+    deps = [
+        ":tasks_ruby_grpc",
+        ":tasks_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-tasks-v2-ruby",
+    deps = [
+        ":tasks_ruby_gapic",
+        ":tasks_ruby_grpc",
+        ":tasks_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "tasks_csharp_proto",
+    deps = [":tasks_proto"],
+)
+
+csharp_grpc_library(
+    name = "tasks_csharp_grpc",
+    srcs = [":tasks_proto"],
+    deps = [":tasks_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "tasks_csharp_gapic",
+    src = ":tasks_proto_with_info",
+    gapic_yaml = "cloudtasks_gapic.yaml",
+    package = "google.cloud.tasks.v2",
+    service_yaml = "cloudtasks_v2.yaml",
+    deps = [
+        ":tasks_csharp_grpc",
+        ":tasks_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-tasks-v2-csharp",
+    deps = [
+        ":tasks_csharp_gapic",
+        ":tasks_csharp_grpc",
+        ":tasks_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/tasks/v2/cloudtasks.proto b/third_party/googleapis/google/cloud/tasks/v2/cloudtasks.proto
index e287880c3..d30aae519 100644
--- a/third_party/googleapis/google/cloud/tasks/v2/cloudtasks.proto
+++ b/third_party/googleapis/google/cloud/tasks/v2/cloudtasks.proto
@@ -18,6 +18,8 @@ syntax = "proto3";
 package google.cloud.tasks.v2;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/cloud/tasks/v2/queue.proto";
 import "google/cloud/tasks/v2/task.proto";
@@ -25,7 +27,6 @@ import "google/iam/v1/iam_policy.proto";
 import "google/iam/v1/policy.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
-import "google/rpc/code.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks";
 option java_multiple_files = true;
@@ -36,6 +37,9 @@ option objc_class_prefix = "TASKS";
 // Cloud Tasks allows developers to manage the execution of background
 // work in their applications.
 service CloudTasks {
+  option (google.api.default_host) = "cloudtasks.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Lists queues.
   //
   // Queues are returned in lexicographical order.
@@ -43,6 +47,7 @@ service CloudTasks {
     option (google.api.http) = {
       get: "/v2/{parent=projects/*/locations/*}/queues"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets a queue.
@@ -50,6 +55,7 @@ service CloudTasks {
     option (google.api.http) = {
       get: "/v2/{name=projects/*/locations/*/queues/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates a queue.
@@ -69,6 +75,7 @@ service CloudTasks {
       post: "/v2/{parent=projects/*/locations/*}/queues"
       body: "queue"
     };
+    option (google.api.method_signature) = "parent,queue";
   }
 
   // Updates a queue.
@@ -91,6 +98,7 @@ service CloudTasks {
       patch: "/v2/{queue.name=projects/*/locations/*/queues/*}"
       body: "queue"
     };
+    option (google.api.method_signature) = "queue,update_mask";
   }
 
   // Deletes a queue.
@@ -110,6 +118,7 @@ service CloudTasks {
     option (google.api.http) = {
       delete: "/v2/{name=projects/*/locations/*/queues/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Purges a queue by deleting all of its tasks.
@@ -123,6 +132,7 @@ service CloudTasks {
       post: "/v2/{name=projects/*/locations/*/queues/*}:purge"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Pauses the queue.
@@ -137,6 +147,7 @@ service CloudTasks {
       post: "/v2/{name=projects/*/locations/*/queues/*}:pause"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Resume a queue.
@@ -157,6 +168,7 @@ service CloudTasks {
       post: "/v2/{name=projects/*/locations/*/queues/*}:resume"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Gets the access control policy for a [Queue][google.cloud.tasks.v2.Queue].
@@ -173,6 +185,7 @@ service CloudTasks {
       post: "/v2/{resource=projects/*/locations/*/queues/*}:getIamPolicy"
       body: "*"
     };
+    option (google.api.method_signature) = "resource";
   }
 
   // Sets the access control policy for a [Queue][google.cloud.tasks.v2.Queue]. Replaces any existing
@@ -191,6 +204,7 @@ service CloudTasks {
       post: "/v2/{resource=projects/*/locations/*/queues/*}:setIamPolicy"
       body: "*"
     };
+    option (google.api.method_signature) = "resource,policy";
   }
 
   // Returns permissions that a caller has on a [Queue][google.cloud.tasks.v2.Queue].
@@ -205,6 +219,7 @@ service CloudTasks {
       post: "/v2/{resource=projects/*/locations/*/queues/*}:testIamPermissions"
       body: "*"
     };
+    option (google.api.method_signature) = "resource,permissions";
   }
 
   // Lists the tasks in a queue.
@@ -220,6 +235,7 @@ service CloudTasks {
     option (google.api.http) = {
       get: "/v2/{parent=projects/*/locations/*/queues/*}/tasks"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets a task.
@@ -227,6 +243,7 @@ service CloudTasks {
     option (google.api.http) = {
       get: "/v2/{name=projects/*/locations/*/queues/*/tasks/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates a task and adds it to a queue.
@@ -239,6 +256,7 @@ service CloudTasks {
       post: "/v2/{parent=projects/*/locations/*/queues/*}/tasks"
       body: "*"
     };
+    option (google.api.method_signature) = "parent,task";
   }
 
   // Deletes a task.
@@ -250,6 +268,7 @@ service CloudTasks {
     option (google.api.http) = {
       delete: "/v2/{name=projects/*/locations/*/queues/*/tasks/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Forces a task to run now.
@@ -281,16 +300,20 @@ service CloudTasks {
       post: "/v2/{name=projects/*/locations/*/queues/*/tasks/*}:run"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 }
 
 // Request message for [ListQueues][google.cloud.tasks.v2.CloudTasks.ListQueues].
 message ListQueuesRequest {
-  // Required.
-  //
-  // The location name.
+  // Required. The location name.
   // For example: `projects/PROJECT_ID/locations/LOCATION_ID`
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
 
   // `filter` can be used to specify a subset of queues. Any [Queue][google.cloud.tasks.v2.Queue]
   // field can be used as a filter and several operators as supported.
@@ -344,45 +367,47 @@ message ListQueuesResponse {
 
 // Request message for [GetQueue][google.cloud.tasks.v2.CloudTasks.GetQueue].
 message GetQueueRequest {
-  // Required.
-  //
-  // The resource name of the queue. For example:
+  // Required. The resource name of the queue. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
 }
 
 // Request message for [CreateQueue][google.cloud.tasks.v2.CloudTasks.CreateQueue].
 message CreateQueueRequest {
-  // Required.
-  //
-  // The location name in which the queue will be created.
+  // Required. The location name in which the queue will be created.
   // For example: `projects/PROJECT_ID/locations/LOCATION_ID`
   //
   // The list of allowed locations can be obtained by calling Cloud
   // Tasks' implementation of
   // [ListLocations][google.cloud.location.Locations.ListLocations].
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
 
-  // Required.
-  //
-  // The queue to create.
+  // Required. The queue to create.
   //
   // [Queue's name][google.cloud.tasks.v2.Queue.name] cannot be the same as an existing queue.
-  Queue queue = 2;
+  Queue queue = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request message for [UpdateQueue][google.cloud.tasks.v2.CloudTasks.UpdateQueue].
 message UpdateQueueRequest {
-  // Required.
-  //
-  // The queue to create or update.
+  // Required. The queue to create or update.
   //
   // The queue's [name][google.cloud.tasks.v2.Queue.name] must be specified.
   //
   // Output only fields cannot be modified using UpdateQueue.
   // Any value specified for an output only field will be ignored.
   // The queue's [name][google.cloud.tasks.v2.Queue.name] cannot be changed.
-  Queue queue = 1;
+  Queue queue = 1 [(google.api.field_behavior) = REQUIRED];
 
   // A mask used to specify which fields of the queue are being updated.
   //
@@ -392,47 +417,62 @@ message UpdateQueueRequest {
 
 // Request message for [DeleteQueue][google.cloud.tasks.v2.CloudTasks.DeleteQueue].
 message DeleteQueueRequest {
-  // Required.
-  //
-  // The queue name. For example:
+  // Required. The queue name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
 }
 
 // Request message for [PurgeQueue][google.cloud.tasks.v2.CloudTasks.PurgeQueue].
 message PurgeQueueRequest {
-  // Required.
-  //
-  // The queue name. For example:
+  // Required. The queue name. For example:
   // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
 }
 
 // Request message for [PauseQueue][google.cloud.tasks.v2.CloudTasks.PauseQueue].
 message PauseQueueRequest {
-  // Required.
-  //
-  // The queue name. For example:
+  // Required. The queue name. For example:
   // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
 }
 
 // Request message for [ResumeQueue][google.cloud.tasks.v2.CloudTasks.ResumeQueue].
 message ResumeQueueRequest {
-  // Required.
-  //
-  // The queue name. For example:
+  // Required. The queue name. For example:
   // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
 }
 
 // Request message for listing tasks using [ListTasks][google.cloud.tasks.v2.CloudTasks.ListTasks].
 message ListTasksRequest {
-  // Required.
-  //
-  // The queue name. For example:
+  // Required. The queue name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "cloudtasks.googleapis.com/Task"
+    }
+  ];
 
   // The response_view specifies which subset of the [Task][google.cloud.tasks.v2.Task] will be
   // returned.
@@ -487,11 +527,14 @@ message ListTasksResponse {
 
 // Request message for getting a task using [GetTask][google.cloud.tasks.v2.CloudTasks.GetTask].
 message GetTaskRequest {
-  // Required.
-  //
-  // The task name. For example:
+  // Required. The task name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Task"
+    }
+  ];
 
   // The response_view specifies which subset of the [Task][google.cloud.tasks.v2.Task] will be
   // returned.
@@ -510,17 +553,18 @@ message GetTaskRequest {
 
 // Request message for [CreateTask][google.cloud.tasks.v2.CloudTasks.CreateTask].
 message CreateTaskRequest {
-  // Required.
-  //
-  // The queue name. For example:
+  // Required. The queue name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
   //
   // The queue must already exist.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "cloudtasks.googleapis.com/Task"
+    }
+  ];
 
-  // Required.
-  //
-  // The task to add.
+  // Required. The task to add.
   //
   // Task names have the following format:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`.
@@ -553,7 +597,7 @@ message CreateTaskRequest {
   // task commands. The infrastructure relies on an approximately
   // uniform distribution of task ids to store and serve tasks
   // efficiently.
-  Task task = 2;
+  Task task = 2 [(google.api.field_behavior) = REQUIRED];
 
   // The response_view specifies which subset of the [Task][google.cloud.tasks.v2.Task] will be
   // returned.
@@ -573,21 +617,27 @@ message CreateTaskRequest {
 // Request message for deleting a task using
 // [DeleteTask][google.cloud.tasks.v2.CloudTasks.DeleteTask].
 message DeleteTaskRequest {
-  // Required.
-  //
-  // The task name. For example:
+  // Required. The task name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Task"
+    }
+  ];
 }
 
 // Request message for forcing a task to run now using
 // [RunTask][google.cloud.tasks.v2.CloudTasks.RunTask].
 message RunTaskRequest {
-  // Required.
-  //
-  // The task name. For example:
+  // Required. The task name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Task"
+    }
+  ];
 
   // The response_view specifies which subset of the [Task][google.cloud.tasks.v2.Task] will be
   // returned.
diff --git a/third_party/googleapis/google/cloud/tasks/v2/cloudtasks_gapic.legacy.yaml b/third_party/googleapis/google/cloud/tasks/v2/cloudtasks_gapic.legacy.yaml
new file mode 100644
index 000000000..49373a7b8
--- /dev/null
+++ b/third_party/googleapis/google/cloud/tasks/v2/cloudtasks_gapic.legacy.yaml
@@ -0,0 +1,439 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.tasks.v2
+  python:
+    package_name: google.cloud.tasks_v2.gapic
+    release_level: GA
+  go:
+    package_name: cloud.google.com/go/cloudtasks/apiv2
+    release_level: GA
+  csharp:
+    package_name: Google.Cloud.Tasks.V2
+    release_level: GA
+  ruby:
+    package_name: Google::Cloud::Tasks::V2
+    release_level: GA
+  php:
+    package_name: Google\Cloud\Tasks\V2
+    release_level: GA
+  nodejs:
+    package_name: tasks.v2
+# A list of API interface configurations.
+interfaces:
+- name: google.cloud.tasks.v2.CloudTasks
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}
+    entity_name: project
+    language_overrides:
+    - language: csharp
+      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
+  - name_pattern: projects/{project}/locations/{location}
+    entity_name: location
+  - name_pattern: projects/{project}/locations/{location}/queues/{queue}
+    entity_name: queue
+  - name_pattern: projects/{project}/locations/{location}/queues/{queue}/tasks/{task}
+    entity_name: task
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ListQueues
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    header_request_params:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: queues
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 10000
+  - name: GetQueue
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: queue
+    timeout_millis: 10000
+  - name: CreateQueue
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - queue
+    required_fields:
+    - parent
+    - queue
+    header_request_params:
+    - parent
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 10000
+  - name: UpdateQueue
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - queue
+        - update_mask
+    required_fields:
+    - queue
+    header_request_params:
+    - queue.name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      queue.name: queue
+    timeout_millis: 10000
+  - name: DeleteQueue
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: queue
+    timeout_millis: 10000
+  - name: PurgeQueue
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: queue
+    timeout_millis: 10000
+  - name: PauseQueue
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: queue
+    timeout_millis: 10000
+  - name: ResumeQueue
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: queue
+    timeout_millis: 10000
+  - name: GetIamPolicy
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - resource
+    required_fields:
+    - resource
+    header_request_params:
+    - resource
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: queue
+    timeout_millis: 10000
+  - name: SetIamPolicy
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - resource
+        - policy
+    required_fields:
+    - resource
+    - policy
+    header_request_params:
+    - resource
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: queue
+    timeout_millis: 10000
+  - name: TestIamPermissions
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - resource
+        - permissions
+    required_fields:
+    - resource
+    - permissions
+    header_request_params:
+    - resource
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: queue
+    timeout_millis: 10000
+  - name: ListTasks
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    header_request_params:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: tasks
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: queue
+    timeout_millis: 10000
+  - name: GetTask
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: task
+    timeout_millis: 10000
+  - name: CreateTask
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - task
+    required_fields:
+    - parent
+    - task
+    header_request_params:
+    - parent
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: queue
+    timeout_millis: 10000
+  - name: DeleteTask
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: task
+    timeout_millis: 10000
+  - name: RunTask
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: task
+    timeout_millis: 10000
+resource_name_generation:
+- message_name: Queue
+  field_entity_map:
+    name: queue
+- message_name: Task
+  field_entity_map:
+    name: task
+- message_name: ListQueuesRequest
+  field_entity_map:
+    parent: location
+- message_name: GetQueueRequest
+  field_entity_map:
+    name: queue
+- message_name: CreateQueueRequest
+  field_entity_map:
+    parent: location
+- message_name: UpdateQueueRequest
+  field_entity_map:
+    queue.name: queue
+- message_name: DeleteQueueRequest
+  field_entity_map:
+    name: queue
+- message_name: PurgeQueueRequest
+  field_entity_map:
+    name: queue
+- message_name: PauseQueueRequest
+  field_entity_map:
+    name: queue
+- message_name: ResumeQueueRequest
+  field_entity_map:
+    name: queue
+- message_name: ListTasksRequest
+  field_entity_map:
+    parent: queue
+- message_name: GetTaskRequest
+  field_entity_map:
+    name: task
+- message_name: CreateTaskRequest
+  field_entity_map:
+    parent: queue
+- message_name: DeleteTaskRequest
+  field_entity_map:
+    name: task
+- message_name: RunTaskRequest
+  field_entity_map:
+    name: task
+- message_name: google.iam.v1.GetIamPolicyRequest
+  field_entity_map:
+    resource: "*"
+- message_name: google.iam.v1.SetIamPolicyRequest
+  field_entity_map:
+    resource: "*"
+- message_name: google.iam.v1.TestIamPermissionsRequest
+  field_entity_map:
+    resource: "*"
diff --git a/third_party/googleapis/google/cloud/tasks/v2/cloudtasks_gapic.yaml b/third_party/googleapis/google/cloud/tasks/v2/cloudtasks_gapic.yaml
index e0453b952..ad8a4bd85 100644
--- a/third_party/googleapis/google/cloud/tasks/v2/cloudtasks_gapic.yaml
+++ b/third_party/googleapis/google/cloud/tasks/v2/cloudtasks_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -21,420 +21,46 @@ language_settings:
     release_level: GA
   nodejs:
     package_name: tasks.v2
-# A list of API interface configurations.
 interfaces:
-  # The fully qualified name of the API interface.
 - name: google.cloud.tasks.v2.CloudTasks
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections:
-  - name_pattern: projects/{project}
-    entity_name: project
-    language_overrides:
-    - language: csharp
-      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
-  - name_pattern: projects/{project}/locations/{location}
-    entity_name: location
-  - name_pattern: projects/{project}/locations/{location}/queues/{queue}
-    entity_name: queue
-  - name_pattern: projects/{project}/locations/{location}/queues/{queue}/tasks/{task}
-    entity_name: task
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
   methods:
   - name: ListQueues
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    header_request_params:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: queues
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
     timeout_millis: 10000
   - name: GetQueue
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: queue
     timeout_millis: 10000
   - name: CreateQueue
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - queue
-    required_fields:
-    - parent
-    - queue
-    header_request_params:
-    - parent
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
     timeout_millis: 10000
   - name: UpdateQueue
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - queue
-        - update_mask
-    required_fields:
-    - queue
-    header_request_params:
-    - queue.name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      queue.name: queue
     timeout_millis: 10000
   - name: DeleteQueue
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: queue
     timeout_millis: 10000
   - name: PurgeQueue
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: queue
     timeout_millis: 10000
   - name: PauseQueue
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: queue
     timeout_millis: 10000
   - name: ResumeQueue
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: queue
     timeout_millis: 10000
   - name: GetIamPolicy
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - resource
-    required_fields:
-    - resource
-    header_request_params:
-    - resource
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      resource: queue
     timeout_millis: 10000
   - name: SetIamPolicy
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - resource
-        - policy
-    required_fields:
-    - resource
-    - policy
-    header_request_params:
-    - resource
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      resource: queue
     timeout_millis: 10000
   - name: TestIamPermissions
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - resource
-        - permissions
-    required_fields:
-    - resource
-    - permissions
-    header_request_params:
-    - resource
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      resource: queue
     timeout_millis: 10000
   - name: ListTasks
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    header_request_params:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: tasks
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: queue
     timeout_millis: 10000
   - name: GetTask
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: task
     timeout_millis: 10000
   - name: CreateTask
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - task
-    required_fields:
-    - parent
-    - task
-    header_request_params:
-    - parent
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: queue
     timeout_millis: 10000
   - name: DeleteTask
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: task
     timeout_millis: 10000
   - name: RunTask
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: task
     timeout_millis: 10000
-resource_name_generation:
-- message_name: Queue
-  field_entity_map:
-    name: queue
-- message_name: Task
-  field_entity_map:
-    name: task
-- message_name: ListQueuesRequest
-  field_entity_map:
-    parent: location
-- message_name: GetQueueRequest
-  field_entity_map:
-    name: queue
-- message_name: CreateQueueRequest
-  field_entity_map:
-    parent: location
-- message_name: UpdateQueueRequest
-  field_entity_map:
-    queue.name: queue
-- message_name: DeleteQueueRequest
-  field_entity_map:
-    name: queue
-- message_name: PurgeQueueRequest
-  field_entity_map:
-    name: queue
-- message_name: PauseQueueRequest
-  field_entity_map:
-    name: queue
-- message_name: ResumeQueueRequest
-  field_entity_map:
-    name: queue
-- message_name: ListTasksRequest
-  field_entity_map:
-    parent: queue
-- message_name: GetTaskRequest
-  field_entity_map:
-    name: task
-- message_name: CreateTaskRequest
-  field_entity_map:
-    parent: queue
-- message_name: DeleteTaskRequest
-  field_entity_map:
-    name: task
-- message_name: RunTaskRequest
-  field_entity_map:
-    name: task
-- message_name: google.iam.v1.GetIamPolicyRequest
-  field_entity_map:
-    resource: "*"
-- message_name: google.iam.v1.SetIamPolicyRequest
-  field_entity_map:
-    resource: "*"
-- message_name: google.iam.v1.TestIamPermissionsRequest
-  field_entity_map:
-    resource: "*"
diff --git a/third_party/googleapis/google/cloud/tasks/v2/cloudtasks_grpc_service_config.json b/third_party/googleapis/google/cloud/tasks/v2/cloudtasks_grpc_service_config.json
new file mode 100755
index 000000000..cdad5bd41
--- /dev/null
+++ b/third_party/googleapis/google/cloud/tasks/v2/cloudtasks_grpc_service_config.json
@@ -0,0 +1,87 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.tasks.v2.CloudTasks",
+          "method": "ListQueues"
+        },
+        {
+          "service": "google.cloud.tasks.v2.CloudTasks",
+          "method": "GetQueue"
+        },
+        {
+          "service": "google.cloud.tasks.v2.CloudTasks",
+          "method": "DeleteQueue"
+        },
+        {
+          "service": "google.cloud.tasks.v2.CloudTasks",
+          "method": "GetIamPolicy"
+        },
+        {
+          "service": "google.cloud.tasks.v2.CloudTasks",
+          "method": "TestIamPermissions"
+        },
+        {
+          "service": "google.cloud.tasks.v2.CloudTasks",
+          "method": "ListTasks"
+        },
+        {
+          "service": "google.cloud.tasks.v2.CloudTasks",
+          "method": "GetTask"
+        },
+        {
+          "service": "google.cloud.tasks.v2.CloudTasks",
+          "method": "DeleteTask"
+        }
+      ],
+      "timeout": "10s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "10s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.tasks.v2.CloudTasks",
+          "method": "CreateQueue"
+        },
+        {
+          "service": "google.cloud.tasks.v2.CloudTasks",
+          "method": "UpdateQueue"
+        },
+        {
+          "service": "google.cloud.tasks.v2.CloudTasks",
+          "method": "PurgeQueue"
+        },
+        {
+          "service": "google.cloud.tasks.v2.CloudTasks",
+          "method": "PauseQueue"
+        },
+        {
+          "service": "google.cloud.tasks.v2.CloudTasks",
+          "method": "ResumeQueue"
+        },
+        {
+          "service": "google.cloud.tasks.v2.CloudTasks",
+          "method": "SetIamPolicy"
+        },
+        {
+          "service": "google.cloud.tasks.v2.CloudTasks",
+          "method": "CreateTask"
+        },
+        {
+          "service": "google.cloud.tasks.v2.CloudTasks",
+          "method": "RunTask"
+        }
+      ],
+      "timeout": "10s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/tasks/cloudtasks_v2.yaml b/third_party/googleapis/google/cloud/tasks/v2/cloudtasks_v2.yaml
similarity index 100%
rename from third_party/googleapis/google/cloud/tasks/cloudtasks_v2.yaml
rename to third_party/googleapis/google/cloud/tasks/v2/cloudtasks_v2.yaml
diff --git a/third_party/googleapis/google/cloud/tasks/v2/queue.proto b/third_party/googleapis/google/cloud/tasks/v2/queue.proto
index 05dd03d07..483a1f61f 100644
--- a/third_party/googleapis/google/cloud/tasks/v2/queue.proto
+++ b/third_party/googleapis/google/cloud/tasks/v2/queue.proto
@@ -17,11 +17,11 @@ syntax = "proto3";
 
 package google.cloud.tasks.v2;
 
-import "google/api/annotations.proto";
 import "google/api/resource.proto";
 import "google/cloud/tasks/v2/target.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks";
 option java_multiple_files = true;
@@ -32,6 +32,11 @@ option java_package = "com.google.cloud.tasks.v2";
 // how those tasks are dispatched. Configurable properties include rate limits,
 // retry options, queue types, and others.
 message Queue {
+  option (google.api.resource) = {
+    type: "cloudtasks.googleapis.com/Queue"
+    pattern: "projects/{project}/locations/{location}/queues/{queue}"
+  };
+
   // State of the queue.
   enum State {
     // Unspecified state.
@@ -94,6 +99,7 @@ message Queue {
   // [task-level app_engine_routing][google.cloud.tasks.v2.AppEngineHttpRequest.app_engine_routing].
   // These settings apply only to
   // [App Engine tasks][google.cloud.tasks.v2.AppEngineHttpRequest] in this queue.
+  // [Http tasks][google.cloud.tasks.v2.HttpRequest] are not affected.
   //
   // If set, `app_engine_routing_override` is used for all
   // [App Engine tasks][google.cloud.tasks.v2.AppEngineHttpRequest] in the queue, no matter what the
@@ -160,6 +166,11 @@ message Queue {
   // Purge time will be truncated to the nearest microsecond. Purge
   // time will be unset if the queue has never been purged.
   google.protobuf.Timestamp purge_time = 6;
+
+  // Configuration options for writing logs to
+  // [Stackdriver Logging](https://cloud.google.com/logging/docs/). If this
+  // field is unset, then no logs are written.
+  StackdriverLoggingConfig stackdriver_logging_config = 9;
 }
 
 // Rate limits.
@@ -175,8 +186,7 @@ message RateLimits {
   // If unspecified when the queue is created, Cloud Tasks will pick the
   // default.
   //
-  // * For [App Engine queues][google.cloud.tasks.v2.AppEngineHttpQueue], the maximum allowed value
-  //   is 500.
+  // * The maximum allowed value is 500.
   //
   //
   // This field has the same meaning as
@@ -205,7 +215,7 @@ message RateLimits {
   // value of
   // [max_dispatches_per_second][google.cloud.tasks.v2.RateLimits.max_dispatches_per_second].
   //
-  // For App Engine queues that were created or updated using
+  // For queues that were created or updated using
   // `queue.yaml/xml`, `max_burst_size` is equal to
   // [bucket_size](https://cloud.google.com/appengine/docs/standard/python/config/queueref#bucket_size).
   // Since `max_burst_size` is output only, if
@@ -339,3 +349,13 @@ message RetryConfig {
   // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
   int32 max_doublings = 5;
 }
+
+// Configuration options for writing logs to
+// [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+message StackdriverLoggingConfig {
+  // Specifies the fraction of operations to write to
+  // [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+  // This field may contain any value between 0.0 and 1.0, inclusive.
+  // 0.0 is the default and means that no operations are logged.
+  double sampling_ratio = 1;
+}
diff --git a/third_party/googleapis/google/cloud/tasks/v2/target.proto b/third_party/googleapis/google/cloud/tasks/v2/target.proto
index 2943a4058..558ca4afc 100644
--- a/third_party/googleapis/google/cloud/tasks/v2/target.proto
+++ b/third_party/googleapis/google/cloud/tasks/v2/target.proto
@@ -17,6 +17,7 @@ syntax = "proto3";
 
 package google.cloud.tasks.v2;
 
+import "google/api/field_behavior.proto";
 import "google/api/annotations.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks";
@@ -24,6 +25,112 @@ option java_multiple_files = true;
 option java_outer_classname = "TargetProto";
 option java_package = "com.google.cloud.tasks.v2";
 
+// HTTP request.
+//
+// The task will be pushed to the worker as an HTTP request. If the worker
+// or the redirected worker acknowledges the task by returning a successful HTTP
+// response code ([`200` - `299`]), the task will be removed from the queue. If
+// any other HTTP response code is returned or no response is received, the
+// task will be retried according to the following:
+//
+// * User-specified throttling: [retry configuration][google.cloud.tasks.v2.Queue.retry_config],
+//   [rate limits][google.cloud.tasks.v2.Queue.rate_limits], and the [queue's state][google.cloud.tasks.v2.Queue.state].
+//
+// * System throttling: To prevent the worker from overloading, Cloud Tasks may
+//   temporarily reduce the queue's effective rate. User-specified settings
+//   will not be changed.
+//
+//  System throttling happens because:
+//
+//   * Cloud Tasks backs off on all errors. Normally the backoff specified in
+//     [rate limits][google.cloud.tasks.v2.Queue.rate_limits] will be used. But if the worker returns
+//     `429` (Too Many Requests), `503` (Service Unavailable), or the rate of
+//     errors is high, Cloud Tasks will use a higher backoff rate. The retry
+//     specified in the `Retry-After` HTTP response header is considered.
+//
+//   * To prevent traffic spikes and to smooth sudden increases in traffic,
+//     dispatches ramp up slowly when the queue is newly created or idle and
+//     if large numbers of tasks suddenly become available to dispatch (due to
+//     spikes in create task rates, the queue being unpaused, or many tasks
+//     that are scheduled at the same time).
+message HttpRequest {
+  // Required. The full url path that the request will be sent to.
+  //
+  // This string must begin with either "http://" or "https://". Some examples
+  // are: `http://acme.com` and `https://acme.com/sales:8080`. Cloud Tasks will
+  // encode some characters for safety and compatibility. The maximum allowed
+  // URL length is 2083 characters after encoding.
+  //
+  // The `Location` header response from a redirect response [`300` - `399`]
+  // may be followed. The redirect is not counted as a separate attempt.
+  string url = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // The HTTP method to use for the request. The default is POST.
+  HttpMethod http_method = 2;
+
+  // HTTP request headers.
+  //
+  // This map contains the header field names and values.
+  // Headers can be set when the
+  // [task is created][google.cloud.tasks.v2beta3.CloudTasks.CreateTask].
+  //
+  // These headers represent a subset of the headers that will accompany the
+  // task's HTTP request. Some HTTP request headers will be ignored or replaced.
+  //
+  // A partial list of headers that will be ignored or replaced is:
+  //
+  // * Host: This will be computed by Cloud Tasks and derived from
+  //   [HttpRequest.url][google.cloud.tasks.v2.HttpRequest.url].
+  // * Content-Length: This will be computed by Cloud Tasks.
+  // * User-Agent: This will be set to `"Google-Cloud-Tasks"`.
+  // * X-Google-*: Google use only.
+  // * X-AppEngine-*: Google use only.
+  //
+  // `Content-Type` won't be set by Cloud Tasks. You can explicitly set
+  // `Content-Type` to a media type when the
+  //  [task is created][google.cloud.tasks.v2beta3.CloudTasks.CreateTask].
+  //  For example, `Content-Type` can be set to `"application/octet-stream"` or
+  //  `"application/json"`.
+  //
+  // Headers which can have multiple values (according to RFC2616) can be
+  // specified using comma-separated values.
+  //
+  // The size of the headers must be less than 80KB.
+  map headers = 3;
+
+  // HTTP request body.
+  //
+  // A request body is allowed only if the
+  // [HTTP method][google.cloud.tasks.v2.HttpRequest.http_method] is POST, PUT, or PATCH. It is an
+  // error to set body on a task with an incompatible [HttpMethod][google.cloud.tasks.v2.HttpMethod].
+  bytes body = 4;
+
+  // The mode for generating an `Authorization` header for HTTP requests.
+  //
+  // If specified, all `Authorization` headers in the [HttpRequest.headers][google.cloud.tasks.v2.HttpRequest.headers]
+  // field will be overridden.
+  oneof authorization_header {
+    // If specified, an
+    // [OAuth token](https://developers.google.com/identity/protocols/OAuth2)
+    // will be generated and attached as an `Authorization` header in the HTTP
+    // request.
+    //
+    // This type of authorization should generally only be used when calling
+    // Google APIs hosted on *.googleapis.com.
+    OAuthToken oauth_token = 5;
+
+    // If specified, an
+    // [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect)
+    // token will be generated and attached as an `Authorization` header in the
+    // HTTP request.
+    //
+    // This type of authorization can be used for many scenarios, including
+    // calling Cloud Run, or endpoints where you intend to validate the token
+    // yourself.
+    OidcToken oidc_token = 6;
+  }
+}
+
 // App Engine HTTP request.
 //
 // The message defines the HTTP request that is sent to an App Engine app when
@@ -52,11 +159,10 @@ option java_package = "com.google.cloud.tasks.v2";
 // The [AppEngineRouting][google.cloud.tasks.v2.AppEngineRouting] used to construct the URL that the task is
 // delivered to can be set at the queue-level or task-level:
 //
-// * If set,
-//    [app_engine_routing_override][google.cloud.tasks.v2.AppEngineHttpQueue.app_engine_routing_override]
-//    is used for all tasks in the queue, no matter what the setting
-//    is for the
-//    [task-level app_engine_routing][google.cloud.tasks.v2.AppEngineHttpRequest.app_engine_routing].
+// * If [app_engine_routing_override is set on the
+//    queue][Queue.app_engine_routing_override], this value is used for all
+//    tasks in the queue, no matter what the setting is for the [task-level
+//    app_engine_routing][AppEngineHttpRequest.app_engine_routing].
 //
 //
 // The `url` that the task will be sent to is:
@@ -79,7 +185,7 @@ option java_package = "com.google.cloud.tasks.v2";
 // the app's handler returns a non-2xx response code or Cloud Tasks does
 // not receive response before the [deadline][google.cloud.tasks.v2.Task.dispatch_deadline]. Failed
 // tasks will be retried according to the
-// [retry configuration][Queue.RetryConfig]. `503` (Service Unavailable) is
+// [retry configuration][google.cloud.tasks.v2.Queue.retry_config]. `503` (Service Unavailable) is
 // considered an App Engine system error instead of an application error and
 // will cause Cloud Tasks' traffic congestion control to temporarily throttle
 // the queue's dispatches. Unlike other types of task targets, a `429` (Too Many
@@ -101,10 +207,10 @@ message AppEngineHttpRequest {
 
   // Task-level setting for App Engine routing.
   //
-  // If set,
-  // [app_engine_routing_override][google.cloud.tasks.v2.AppEngineHttpQueue.app_engine_routing_override]
-  // is used for all tasks in the queue, no matter what the setting is for the
-  // [task-level app_engine_routing][google.cloud.tasks.v2.AppEngineHttpRequest.app_engine_routing].
+  // * If [app_engine_routing_override is set on the
+  //    queue][Queue.app_engine_routing_override], this value is used for all
+  //    tasks in the queue, no matter what the setting is for the [task-level
+  //    app_engine_routing][AppEngineHttpRequest.app_engine_routing].
   AppEngineRouting app_engine_routing = 2;
 
   // The relative URI.
@@ -150,7 +256,7 @@ message AppEngineHttpRequest {
   // In addition, Cloud Tasks sets some headers when the task is dispatched,
   // such as headers containing information about the task; see
   // [request
-  // headers](https://cloud.google.com/appengine/docs/python/taskqueue/push/creating-handlers#reading_request_headers).
+  // headers](https://cloud.google.com/tasks/docs/creating-appengine-handlers#reading_request_headers).
   // These headers are set only when the task is dispatched, so they are not
   // visible when the task is returned in a Cloud Tasks response.
   //
@@ -180,6 +286,13 @@ message AppEngineHttpRequest {
 // routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed),
 // and [App Engine Flex request
 // routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
+//
+// Using [AppEngineRouting][google.cloud.tasks.v2.AppEngineRouting] requires
+// [`appengine.applications.get`](https://cloud.google.com/appengine/docs/admin-api/access-control)
+// Google IAM permission for the project
+// and the following scope:
+//
+// `https://www.googleapis.com/auth/cloud-platform`
 message AppEngineRouting {
   // App service.
   //
@@ -272,3 +385,40 @@ enum HttpMethod {
   // HTTP OPTIONS
   OPTIONS = 7;
 }
+
+// Contains information needed for generating an
+// [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
+// This type of authorization should generally only be used when calling Google
+// APIs hosted on *.googleapis.com.
+message OAuthToken {
+  // [Service account email](https://cloud.google.com/iam/docs/service-accounts)
+  // to be used for generating OAuth token.
+  // The service account must be within the same project as the queue. The
+  // caller must have iam.serviceAccounts.actAs permission for the service
+  // account.
+  string service_account_email = 1;
+
+  // OAuth scope to be used for generating OAuth access token.
+  // If not specified, "https://www.googleapis.com/auth/cloud-platform"
+  // will be used.
+  string scope = 2;
+}
+
+// Contains information needed for generating an
+// [OpenID Connect
+// token](https://developers.google.com/identity/protocols/OpenIDConnect).
+// This type of authorization can be used for many scenarios, including
+// calling Cloud Run, or endpoints where you intend to validate the token
+// yourself.
+message OidcToken {
+  // [Service account email](https://cloud.google.com/iam/docs/service-accounts)
+  // to be used for generating OIDC token.
+  // The service account must be within the same project as the queue. The
+  // caller must have iam.serviceAccounts.actAs permission for the service
+  // account.
+  string service_account_email = 1;
+
+  // Audience to be used when generating OIDC token. If not specified, the URI
+  // specified in target will be used.
+  string audience = 2;
+}
diff --git a/third_party/googleapis/google/cloud/tasks/v2/task.proto b/third_party/googleapis/google/cloud/tasks/v2/task.proto
index eefcb378c..70a2baba4 100644
--- a/third_party/googleapis/google/cloud/tasks/v2/task.proto
+++ b/third_party/googleapis/google/cloud/tasks/v2/task.proto
@@ -17,12 +17,12 @@ syntax = "proto3";
 
 package google.cloud.tasks.v2;
 
-import "google/api/annotations.proto";
 import "google/api/resource.proto";
 import "google/cloud/tasks/v2/target.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
 import "google/rpc/status.proto";
+import "google/api/annotations.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks";
 option java_multiple_files = true;
@@ -31,6 +31,11 @@ option java_package = "com.google.cloud.tasks.v2";
 
 // A unit of scheduled work.
 message Task {
+  option (google.api.resource) = {
+    type: "cloudtasks.googleapis.com/Task"
+    pattern: "projects/{project}/locations/{location}/queues/{queue}/tasks/{task}"
+  };
+
   // The view specifies a subset of [Task][google.cloud.tasks.v2.Task] data.
   //
   // When a task is returned in a response, not all
@@ -88,11 +93,14 @@ message Task {
     //
     // An App Engine task is a task that has [AppEngineHttpRequest][google.cloud.tasks.v2.AppEngineHttpRequest] set.
     AppEngineHttpRequest app_engine_http_request = 2;
+
+    // HTTP request that is sent to the worker.
+    //
+    // An HTTP task is a task that has [HttpRequest][google.cloud.tasks.v2.HttpRequest] set.
+    HttpRequest http_request = 3;
   }
 
-  // The time when the task is scheduled to be attempted.
-  //
-  // For App Engine queues, this is when the task will be attempted or retried.
+  // The time when the task is scheduled to be attempted or retried.
   //
   // `schedule_time` will be truncated to the nearest microsecond.
   google.protobuf.Timestamp schedule_time = 4;
@@ -114,6 +122,8 @@ message Task {
   //
   // The default and maximum values depend on the type of request:
   //
+  // * For [HTTP tasks][google.cloud.tasks.v2.HttpRequest], the default is 10 minutes. The deadline
+  //   must be in the interval [15 seconds, 30 minutes].
   //
   // * For [App Engine tasks][google.cloud.tasks.v2.AppEngineHttpRequest], 0 indicates that the
   //   request has the default deadline. The default deadline depends on the
diff --git a/third_party/googleapis/google/cloud/tasks/v2beta2/BUILD.bazel b/third_party/googleapis/google/cloud/tasks/v2beta2/BUILD.bazel
index f10c5e203..d430b1219 100644
--- a/third_party/googleapis/google/cloud/tasks/v2beta2/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/tasks/v2beta2/BUILD.bazel
@@ -1,9 +1,12 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
@@ -16,9 +19,11 @@ proto_library(
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
         "//google/iam/v1:iam_policy_proto",
         "//google/iam/v1:policy_proto",
-        "//google/rpc:code_proto",
         "//google/rpc:status_proto",
         "@com_google_protobuf//:duration_proto",
         "@com_google_protobuf//:empty_proto",
@@ -29,7 +34,10 @@ proto_library(
 
 proto_library_with_info(
     name = "tasks_proto_with_info",
-    deps = [":tasks_proto"],
+    deps = [
+        ":tasks_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -37,19 +45,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-    "@com_google_api_grpc_proto_google_iam_v1//jar",
-]
-
 java_proto_library(
     name = "tasks_java_proto",
     deps = [":tasks_proto"],
@@ -58,51 +60,42 @@ java_proto_library(
 java_grpc_library(
     name = "tasks_java_grpc",
     srcs = [":tasks_proto"],
-    deps = [":tasks_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "tasks_resource_name_java_proto",
-    gapic_yaml = "cloudtasks_gapic.yaml",
-    deps = [":tasks_proto"],
+    deps = [":tasks_java_proto"],
 )
 
 java_gapic_library(
     name = "tasks_java_gapic",
     src = ":tasks_proto_with_info",
     gapic_yaml = "cloudtasks_gapic.yaml",
-    service_yaml = "//google/cloud/tasks:cloudtasks_v2beta2.yaml",
-    test_deps = [":tasks_java_grpc"],
+    package = "google.cloud.tasks.v2beta2",
+    service_yaml = "cloudtasks_v2beta2.yaml",
+    test_deps = [
+        ":tasks_java_grpc",
+        "//google/iam/v1:iam_java_grpc",
+    ],
     deps = [
         ":tasks_java_proto",
-        ":tasks_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+        "//google/iam/v1:iam_java_proto",
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":tasks_java_gapic_test",
+java_gapic_test(
+    name = "tasks_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.tasks.v2beta2.CloudTasksClientTest",
     ],
-) for test_name in [
-    "com.google.cloud.tasks.v2beta2.CloudTasksClientTest",
-]]
+    runtime_deps = [":tasks_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-tasks-v2beta2-java",
-    client_deps = [":tasks_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":tasks_java_gapic_test"],
-    grpc_deps = [":tasks_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":tasks_java_gapic",
+        ":tasks_java_grpc",
         ":tasks_java_proto",
         ":tasks_proto",
-        ":tasks_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -110,10 +103,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -124,17 +117,16 @@ go_proto_library(
     deps = [
         "//google/api:annotations_go_proto",
         "//google/iam/v1:iam_go_proto",
-        "//google/rpc:code_go_proto",
         "//google/rpc:status_go_proto",
     ],
 )
 
 go_gapic_library(
     name = "tasks_go_gapic",
-    src = ":tasks_proto_with_info",
-    gapic_yaml = "cloudtasks_gapic.yaml",
-    importpath = "cloud.google.com/go/cloudtasks/apiv2beta2",
-    service_yaml = "//google/cloud/tasks:cloudtasks_v2beta2.yaml",
+    srcs = [":tasks_proto_with_info"],
+    grpc_service_config = "cloudtasks_grpc_service_config.json",
+    importpath = "cloud.google.com/go/cloudtasks/apiv2beta2;tasks",
+    service_yaml = "cloudtasks_v2beta2.yaml",
     deps = [
         ":tasks_go_proto",
         "//google/iam/v1:iam_go_proto",
@@ -149,13 +141,239 @@ go_test(
     importpath = "cloud.google.com/go/cloudtasks/apiv2beta2",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-tasks-v2beta2-go",
     deps = [
         ":tasks_go_gapic",
-        ":tasks_go_gapic_srcjar-smoke-test.srcjar",
         ":tasks_go_gapic_srcjar-test.srcjar",
         ":tasks_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "tasks_moved_proto",
+    srcs = [":tasks_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/iam/v1:iam_policy_proto",
+        "//google/iam/v1:policy_proto",
+        "//google/rpc:status_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "tasks_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":tasks_moved_proto"],
+)
+
+py_grpc_library(
+    name = "tasks_py_grpc",
+    srcs = [":tasks_moved_proto"],
+    deps = [":tasks_py_proto"],
+)
+
+py_gapic_library(
+    name = "tasks_py_gapic",
+    src = ":tasks_proto_with_info",
+    gapic_yaml = "cloudtasks_gapic.yaml",
+    package = "google.cloud.tasks.v2beta2",
+    service_yaml = "cloudtasks_v2beta2.yaml",
+    deps = [
+        ":tasks_py_grpc",
+        ":tasks_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "tasks-v2beta2-py",
+    deps = [
+        ":tasks_py_gapic",
+        ":tasks_py_grpc",
+        ":tasks_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "tasks_php_proto",
+    deps = [":tasks_proto"],
+)
+
+php_grpc_library(
+    name = "tasks_php_grpc",
+    srcs = [":tasks_proto"],
+    deps = [":tasks_php_proto"],
+)
+
+php_gapic_library(
+    name = "tasks_php_gapic",
+    src = ":tasks_proto_with_info",
+    gapic_yaml = "cloudtasks_gapic.yaml",
+    package = "google.cloud.tasks.v2beta2",
+    service_yaml = "cloudtasks_v2beta2.yaml",
+    deps = [
+        ":tasks_php_grpc",
+        ":tasks_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-tasks-v2beta2-php",
+    deps = [
+        ":tasks_php_gapic",
+        ":tasks_php_grpc",
+        ":tasks_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "tasks_nodejs_gapic",
+    src = ":tasks_proto_with_info",
+    gapic_yaml = "cloudtasks_gapic.yaml",
+    package = "google.cloud.tasks.v2beta2",
+    service_yaml = "cloudtasks_v2beta2.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "tasks-v2beta2-nodejs",
+    deps = [
+        ":tasks_nodejs_gapic",
+        ":tasks_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "tasks_ruby_proto",
+    deps = [":tasks_proto"],
+)
+
+ruby_grpc_library(
+    name = "tasks_ruby_grpc",
+    srcs = [":tasks_proto"],
+    deps = [":tasks_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "tasks_ruby_gapic",
+    src = ":tasks_proto_with_info",
+    gapic_yaml = "cloudtasks_gapic.yaml",
+    package = "google.cloud.tasks.v2beta2",
+    service_yaml = "cloudtasks_v2beta2.yaml",
+    deps = [
+        ":tasks_ruby_grpc",
+        ":tasks_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-tasks-v2beta2-ruby",
+    deps = [
+        ":tasks_ruby_gapic",
+        ":tasks_ruby_grpc",
+        ":tasks_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "tasks_csharp_proto",
+    deps = [":tasks_proto"],
+)
+
+csharp_grpc_library(
+    name = "tasks_csharp_grpc",
+    srcs = [":tasks_proto"],
+    deps = [":tasks_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "tasks_csharp_gapic",
+    src = ":tasks_proto_with_info",
+    gapic_yaml = "cloudtasks_gapic.yaml",
+    package = "google.cloud.tasks.v2beta2",
+    service_yaml = "cloudtasks_v2beta2.yaml",
+    deps = [
+        ":tasks_csharp_grpc",
+        ":tasks_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-tasks-v2beta2-csharp",
+    deps = [
+        ":tasks_csharp_gapic",
+        ":tasks_csharp_grpc",
+        ":tasks_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/tasks/v2beta2/cloudtasks.proto b/third_party/googleapis/google/cloud/tasks/v2beta2/cloudtasks.proto
index 61a6ecdc9..afea6919a 100644
--- a/third_party/googleapis/google/cloud/tasks/v2beta2/cloudtasks.proto
+++ b/third_party/googleapis/google/cloud/tasks/v2beta2/cloudtasks.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,12 +11,16 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.tasks.v2beta2;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/tasks/v2beta2/queue.proto";
 import "google/cloud/tasks/v2beta2/task.proto";
 import "google/iam/v1/iam_policy.proto";
@@ -25,7 +29,6 @@ import "google/protobuf/duration.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
 import "google/protobuf/timestamp.proto";
-import "google/rpc/code.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks";
 option java_multiple_files = true;
@@ -36,6 +39,9 @@ option objc_class_prefix = "TASKS";
 // Cloud Tasks allows developers to manage the execution of background
 // work in their applications.
 service CloudTasks {
+  option (google.api.default_host) = "cloudtasks.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Lists queues.
   //
   // Queues are returned in lexicographical order.
@@ -43,6 +49,7 @@ service CloudTasks {
     option (google.api.http) = {
       get: "/v2beta2/{parent=projects/*/locations/*}/queues"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets a queue.
@@ -50,13 +57,14 @@ service CloudTasks {
     option (google.api.http) = {
       get: "/v2beta2/{name=projects/*/locations/*/queues/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates a queue.
   //
   // Queues created with this method allow tasks to live for a maximum of 31
-  // days. After a task is 31 days old, the task will be deleted regardless of
-  // whether it was dispatched or not.
+  // days. After a task is 31 days old, the task will be deleted regardless of whether
+  // it was dispatched or not.
   //
   // WARNING: Using this method may have unintended side effects if you are
   // using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
@@ -69,6 +77,7 @@ service CloudTasks {
       post: "/v2beta2/{parent=projects/*/locations/*}/queues"
       body: "queue"
     };
+    option (google.api.method_signature) = "parent,queue";
   }
 
   // Updates a queue.
@@ -77,8 +86,8 @@ service CloudTasks {
   // the queue if it does exist.
   //
   // Queues created with this method allow tasks to live for a maximum of 31
-  // days. After a task is 31 days old, the task will be deleted regardless of
-  // whether it was dispatched or not.
+  // days. After a task is 31 days old, the task will be deleted regardless of whether
+  // it was dispatched or not.
   //
   // WARNING: Using this method may have unintended side effects if you are
   // using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
@@ -91,6 +100,7 @@ service CloudTasks {
       patch: "/v2beta2/{queue.name=projects/*/locations/*/queues/*}"
       body: "queue"
     };
+    option (google.api.method_signature) = "queue,update_mask";
   }
 
   // Deletes a queue.
@@ -110,6 +120,7 @@ service CloudTasks {
     option (google.api.http) = {
       delete: "/v2beta2/{name=projects/*/locations/*/queues/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Purges a queue by deleting all of its tasks.
@@ -123,32 +134,31 @@ service CloudTasks {
       post: "/v2beta2/{name=projects/*/locations/*/queues/*}:purge"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Pauses the queue.
   //
   // If a queue is paused then the system will stop dispatching tasks
   // until the queue is resumed via
-  // [ResumeQueue][google.cloud.tasks.v2beta2.CloudTasks.ResumeQueue]. Tasks can
-  // still be added when the queue is paused. A queue is paused if its
-  // [state][google.cloud.tasks.v2beta2.Queue.state] is
-  // [PAUSED][google.cloud.tasks.v2beta2.Queue.State.PAUSED].
+  // [ResumeQueue][google.cloud.tasks.v2beta2.CloudTasks.ResumeQueue]. Tasks can still be added
+  // when the queue is paused. A queue is paused if its
+  // [state][google.cloud.tasks.v2beta2.Queue.state] is [PAUSED][google.cloud.tasks.v2beta2.Queue.State.PAUSED].
   rpc PauseQueue(PauseQueueRequest) returns (Queue) {
     option (google.api.http) = {
       post: "/v2beta2/{name=projects/*/locations/*/queues/*}:pause"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Resume a queue.
   //
   // This method resumes a queue after it has been
   // [PAUSED][google.cloud.tasks.v2beta2.Queue.State.PAUSED] or
-  // [DISABLED][google.cloud.tasks.v2beta2.Queue.State.DISABLED]. The state of a
-  // queue is stored in the queue's
-  // [state][google.cloud.tasks.v2beta2.Queue.state]; after calling this method
-  // it will be set to
-  // [RUNNING][google.cloud.tasks.v2beta2.Queue.State.RUNNING].
+  // [DISABLED][google.cloud.tasks.v2beta2.Queue.State.DISABLED]. The state of a queue is stored
+  // in the queue's [state][google.cloud.tasks.v2beta2.Queue.state]; after calling this method it
+  // will be set to [RUNNING][google.cloud.tasks.v2beta2.Queue.State.RUNNING].
   //
   // WARNING: Resuming many high-QPS queues at the same time can
   // lead to target overloading. If you are resuming high-QPS
@@ -160,27 +170,28 @@ service CloudTasks {
       post: "/v2beta2/{name=projects/*/locations/*/queues/*}:resume"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 
-  // Gets the access control policy for a
-  // [Queue][google.cloud.tasks.v2beta2.Queue]. Returns an empty policy if the
-  // resource exists and does not have a policy set.
+  // Gets the access control policy for a [Queue][google.cloud.tasks.v2beta2.Queue].
+  // Returns an empty policy if the resource exists and does not have a policy
+  // set.
   //
   // Authorization requires the following
   // [Google IAM](https://cloud.google.com/iam) permission on the specified
   // resource parent:
   //
   // * `cloudtasks.queues.getIamPolicy`
-  rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest)
-      returns (google.iam.v1.Policy) {
+  rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) returns (google.iam.v1.Policy) {
     option (google.api.http) = {
       post: "/v2beta2/{resource=projects/*/locations/*/queues/*}:getIamPolicy"
       body: "*"
     };
+    option (google.api.method_signature) = "resource";
   }
 
-  // Sets the access control policy for a
-  // [Queue][google.cloud.tasks.v2beta2.Queue]. Replaces any existing policy.
+  // Sets the access control policy for a [Queue][google.cloud.tasks.v2beta2.Queue]. Replaces any existing
+  // policy.
   //
   // Note: The Cloud Console does not check queue-level IAM permissions yet.
   // Project-level permissions are required to use the Cloud Console.
@@ -190,36 +201,35 @@ service CloudTasks {
   // resource parent:
   //
   // * `cloudtasks.queues.setIamPolicy`
-  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest)
-      returns (google.iam.v1.Policy) {
+  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) returns (google.iam.v1.Policy) {
     option (google.api.http) = {
       post: "/v2beta2/{resource=projects/*/locations/*/queues/*}:setIamPolicy"
       body: "*"
     };
+    option (google.api.method_signature) = "resource,policy";
   }
 
-  // Returns permissions that a caller has on a
-  // [Queue][google.cloud.tasks.v2beta2.Queue]. If the resource does not exist,
-  // this will return an empty set of permissions, not a
-  // [NOT_FOUND][google.rpc.Code.NOT_FOUND] error.
+  // Returns permissions that a caller has on a [Queue][google.cloud.tasks.v2beta2.Queue].
+  // If the resource does not exist, this will return an empty set of
+  // permissions, not a [NOT_FOUND][google.rpc.Code.NOT_FOUND] error.
   //
   // Note: This operation is designed to be used for building permission-aware
   // UIs and command-line tools, not for authorization checking. This operation
   // may "fail open" without warning.
-  rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest)
-      returns (google.iam.v1.TestIamPermissionsResponse) {
+  rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest) returns (google.iam.v1.TestIamPermissionsResponse) {
     option (google.api.http) = {
       post: "/v2beta2/{resource=projects/*/locations/*/queues/*}:testIamPermissions"
       body: "*"
     };
+    option (google.api.method_signature) = "resource,permissions";
   }
 
   // Lists the tasks in a queue.
   //
-  // By default, only the [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC]
-  // view is retrieved due to performance considerations;
-  // [response_view][google.cloud.tasks.v2beta2.ListTasksRequest.response_view]
-  // controls the subset of information which is returned.
+  // By default, only the [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC] view is retrieved
+  // due to performance considerations;
+  // [response_view][google.cloud.tasks.v2beta2.ListTasksRequest.response_view] controls the
+  // subset of information which is returned.
   //
   // The tasks may be returned in any order. The ordering may change at any
   // time.
@@ -227,6 +237,7 @@ service CloudTasks {
     option (google.api.http) = {
       get: "/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets a task.
@@ -234,22 +245,22 @@ service CloudTasks {
     option (google.api.http) = {
       get: "/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates a task and adds it to a queue.
   //
   // Tasks cannot be updated after creation; there is no UpdateTask command.
   //
-  // * For [App Engine queues][google.cloud.tasks.v2beta2.AppEngineHttpTarget],
-  // the maximum task size is
+  // * For [App Engine queues][google.cloud.tasks.v2beta2.AppEngineHttpTarget], the maximum task size is
   //   100KB.
-  // * For [pull queues][google.cloud.tasks.v2beta2.PullTarget], the maximum
-  // task size is 1MB.
+  // * For [pull queues][google.cloud.tasks.v2beta2.PullTarget], the maximum task size is 1MB.
   rpc CreateTask(CreateTaskRequest) returns (Task) {
     option (google.api.http) = {
       post: "/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks"
       body: "*"
     };
+    option (google.api.method_signature) = "parent,task";
   }
 
   // Deletes a task.
@@ -261,6 +272,7 @@ service CloudTasks {
     option (google.api.http) = {
       delete: "/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Leases tasks from a pull queue for
@@ -268,19 +280,18 @@ service CloudTasks {
   //
   // This method is invoked by the worker to obtain a lease. The
   // worker must acknowledge the task via
-  // [AcknowledgeTask][google.cloud.tasks.v2beta2.CloudTasks.AcknowledgeTask]
-  // after they have performed the work associated with the task.
-  //
-  // The [payload][google.cloud.tasks.v2beta2.PullMessage.payload] is intended
-  // to store data that the worker needs to perform the work associated with the
-  // task. To return the payloads in the
-  // [response][google.cloud.tasks.v2beta2.LeaseTasksResponse], set
-  // [response_view][google.cloud.tasks.v2beta2.LeaseTasksRequest.response_view]
-  // to [FULL][google.cloud.tasks.v2beta2.Task.View.FULL].
-  //
-  // A maximum of 10 qps of
-  // [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] requests are
-  // allowed per queue. [RESOURCE_EXHAUSTED][google.rpc.Code.RESOURCE_EXHAUSTED]
+  // [AcknowledgeTask][google.cloud.tasks.v2beta2.CloudTasks.AcknowledgeTask] after they have
+  // performed the work associated with the task.
+  //
+  // The [payload][google.cloud.tasks.v2beta2.PullMessage.payload] is intended to store data that
+  // the worker needs to perform the work associated with the task. To
+  // return the payloads in the [response][google.cloud.tasks.v2beta2.LeaseTasksResponse], set
+  // [response_view][google.cloud.tasks.v2beta2.LeaseTasksRequest.response_view] to
+  // [FULL][google.cloud.tasks.v2beta2.Task.View.FULL].
+  //
+  // A maximum of 10 qps of [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks]
+  // requests are allowed per
+  // queue. [RESOURCE_EXHAUSTED][google.rpc.Code.RESOURCE_EXHAUSTED]
   // is returned when this limit is
   // exceeded. [RESOURCE_EXHAUSTED][google.rpc.Code.RESOURCE_EXHAUSTED]
   // is also returned when
@@ -291,18 +302,18 @@ service CloudTasks {
       post: "/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks:lease"
       body: "*"
     };
+    option (google.api.method_signature) = "parent,lease_duration";
   }
 
   // Acknowledges a pull task.
   //
   // The worker, that is, the entity that
-  // [leased][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] this task must
-  // call this method to indicate that the work associated with the task has
-  // finished.
+  // [leased][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] this task must call this method
+  // to indicate that the work associated with the task has finished.
   //
   // The worker must acknowledge a task within the
-  // [lease_duration][google.cloud.tasks.v2beta2.LeaseTasksRequest.lease_duration]
-  // or the lease will expire and the task will become available to be leased
+  // [lease_duration][google.cloud.tasks.v2beta2.LeaseTasksRequest.lease_duration] or the lease
+  // will expire and the task will become available to be leased
   // again. After the task is acknowledged, it will not be returned
   // by a later [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks],
   // [GetTask][google.cloud.tasks.v2beta2.CloudTasks.GetTask], or
@@ -312,85 +323,88 @@ service CloudTasks {
       post: "/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:acknowledge"
       body: "*"
     };
+    option (google.api.method_signature) = "name,schedule_time";
   }
 
   // Renew the current lease of a pull task.
   //
   // The worker can use this method to extend the lease by a new
   // duration, starting from now. The new task lease will be
-  // returned in the task's
-  // [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time].
+  // returned in the task's [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time].
   rpc RenewLease(RenewLeaseRequest) returns (Task) {
     option (google.api.http) = {
       post: "/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:renewLease"
       body: "*"
     };
+    option (google.api.method_signature) = "name,schedule_time,lease_duration";
   }
 
   // Cancel a pull task's lease.
   //
   // The worker can use this method to cancel a task's lease by
-  // setting its [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time]
-  // to now. This will make the task available to be leased to the next caller
-  // of [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks].
+  // setting its [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] to now. This will
+  // make the task available to be leased to the next caller of
+  // [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks].
   rpc CancelLease(CancelLeaseRequest) returns (Task) {
     option (google.api.http) = {
       post: "/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:cancelLease"
       body: "*"
     };
+    option (google.api.method_signature) = "name,schedule_time";
   }
 
   // Forces a task to run now.
   //
   // When this method is called, Cloud Tasks will dispatch the task, even if
-  // the task is already running, the queue has reached its
-  // [RateLimits][google.cloud.tasks.v2beta2.RateLimits] or is
-  // [PAUSED][google.cloud.tasks.v2beta2.Queue.State.PAUSED].
+  // the task is already running, the queue has reached its [RateLimits][google.cloud.tasks.v2beta2.RateLimits] or
+  // is [PAUSED][google.cloud.tasks.v2beta2.Queue.State.PAUSED].
   //
   // This command is meant to be used for manual debugging. For
-  // example, [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] can be
-  // used to retry a failed task after a fix has been made or to manually force
-  // a task to be dispatched now.
+  // example, [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] can be used to retry a failed
+  // task after a fix has been made or to manually force a task to be
+  // dispatched now.
   //
   // The dispatched task is returned. That is, the task that is returned
-  // contains the [status][google.cloud.tasks.v2beta2.Task.status] after the
-  // task is dispatched but before the task is received by its target.
+  // contains the [status][google.cloud.tasks.v2beta2.Task.status] after the task is dispatched but
+  // before the task is received by its target.
   //
   // If Cloud Tasks receives a successful response from the task's
   // target, then the task will be deleted; otherwise the task's
-  // [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] will be
-  // reset to the time that
-  // [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] was called plus
-  // the retry delay specified in the queue's
-  // [RetryConfig][google.cloud.tasks.v2beta2.RetryConfig].
+  // [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] will be reset to the time that
+  // [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] was called plus the retry delay specified
+  // in the queue's [RetryConfig][google.cloud.tasks.v2beta2.RetryConfig].
   //
   // [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] returns
   // [NOT_FOUND][google.rpc.Code.NOT_FOUND] when it is called on a
   // task that has already succeeded or permanently failed.
   //
-  // [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] cannot be called
-  // on a [pull task][google.cloud.tasks.v2beta2.PullMessage].
+  // [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] cannot be called on a
+  // [pull task][google.cloud.tasks.v2beta2.PullMessage].
   rpc RunTask(RunTaskRequest) returns (Task) {
     option (google.api.http) = {
       post: "/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:run"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 }
 
-// Request message for
-// [ListQueues][google.cloud.tasks.v2beta2.CloudTasks.ListQueues].
+// Request message for [ListQueues][google.cloud.tasks.v2beta2.CloudTasks.ListQueues].
 message ListQueuesRequest {
-  // Required.
-  //
-  // The location name.
+  // Required. The location name.
   // For example: `projects/PROJECT_ID/locations/LOCATION_ID`
-  string parent = 1;
-
-  // `filter` can be used to specify a subset of queues. Any
-  // [Queue][google.cloud.tasks.v2beta2.Queue] field can be used as a filter and
-  // several operators as supported. For example: `<=, <, >=, >, !=, =, :`. The
-  // filter syntax is the same as described in [Stackdriver's Advanced Logs
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
+
+  // `filter` can be used to specify a subset of queues. Any [Queue][google.cloud.tasks.v2beta2.Queue]
+  // field can be used as a filter and several operators as supported.
+  // For example: `<=, <, >=, >, !=, =, :`. The filter syntax is the same as
+  // described in
+  // [Stackdriver's Advanced Logs
   // Filters](https://cloud.google.com/logging/docs/view/advanced_filters).
   //
   // Sample filter "app_engine_http_target: *".
@@ -404,25 +418,22 @@ message ListQueuesRequest {
   // The maximum page size is 9800. If unspecified, the page size will
   // be the maximum. Fewer queues than requested might be returned,
   // even if more queues exist; use the
-  // [next_page_token][google.cloud.tasks.v2beta2.ListQueuesResponse.next_page_token]
-  // in the response to determine if more queues exist.
+  // [next_page_token][google.cloud.tasks.v2beta2.ListQueuesResponse.next_page_token] in the
+  // response to determine if more queues exist.
   int32 page_size = 3;
 
   // A token identifying the page of results to return.
   //
   // To request the first page results, page_token must be empty. To
   // request the next page of results, page_token must be the value of
-  // [next_page_token][google.cloud.tasks.v2beta2.ListQueuesResponse.next_page_token]
-  // returned from the previous call to
-  // [ListQueues][google.cloud.tasks.v2beta2.CloudTasks.ListQueues] method. It
-  // is an error to switch the value of the
-  // [filter][google.cloud.tasks.v2beta2.ListQueuesRequest.filter] while
-  // iterating through pages.
+  // [next_page_token][google.cloud.tasks.v2beta2.ListQueuesResponse.next_page_token] returned
+  // from the previous call to [ListQueues][google.cloud.tasks.v2beta2.CloudTasks.ListQueues]
+  // method. It is an error to switch the value of the
+  // [filter][google.cloud.tasks.v2beta2.ListQueuesRequest.filter] while iterating through pages.
   string page_token = 4;
 }
 
-// Response message for
-// [ListQueues][google.cloud.tasks.v2beta2.CloudTasks.ListQueues].
+// Response message for [ListQueues][google.cloud.tasks.v2beta2.CloudTasks.ListQueues].
 message ListQueuesResponse {
   // The list of queues.
   repeated Queue queues = 1;
@@ -430,8 +441,7 @@ message ListQueuesResponse {
   // A token to retrieve next page of results.
   //
   // To return the next page of results, call
-  // [ListQueues][google.cloud.tasks.v2beta2.CloudTasks.ListQueues] with this
-  // value as the
+  // [ListQueues][google.cloud.tasks.v2beta2.CloudTasks.ListQueues] with this value as the
   // [page_token][google.cloud.tasks.v2beta2.ListQueuesRequest.page_token].
   //
   // If the next_page_token is empty, there are no more results.
@@ -440,53 +450,49 @@ message ListQueuesResponse {
   string next_page_token = 2;
 }
 
-// Request message for
-// [GetQueue][google.cloud.tasks.v2beta2.CloudTasks.GetQueue].
+// Request message for [GetQueue][google.cloud.tasks.v2beta2.CloudTasks.GetQueue].
 message GetQueueRequest {
-  // Required.
-  //
-  // The resource name of the queue. For example:
+  // Required. The resource name of the queue. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
 }
 
-// Request message for
-// [CreateQueue][google.cloud.tasks.v2beta2.CloudTasks.CreateQueue].
+// Request message for [CreateQueue][google.cloud.tasks.v2beta2.CloudTasks.CreateQueue].
 message CreateQueueRequest {
-  // Required.
-  //
-  // The location name in which the queue will be created.
+  // Required. The location name in which the queue will be created.
   // For example: `projects/PROJECT_ID/locations/LOCATION_ID`
   //
   // The list of allowed locations can be obtained by calling Cloud
   // Tasks' implementation of
   // [ListLocations][google.cloud.location.Locations.ListLocations].
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
 
-  // Required.
+  // Required. The queue to create.
   //
-  // The queue to create.
-  //
-  // [Queue's name][google.cloud.tasks.v2beta2.Queue.name] cannot be the same as
-  // an existing queue.
-  Queue queue = 2;
+  // [Queue's name][google.cloud.tasks.v2beta2.Queue.name] cannot be the same as an existing queue.
+  Queue queue = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
-// Request message for
-// [UpdateQueue][google.cloud.tasks.v2beta2.CloudTasks.UpdateQueue].
+// Request message for [UpdateQueue][google.cloud.tasks.v2beta2.CloudTasks.UpdateQueue].
 message UpdateQueueRequest {
-  // Required.
-  //
-  // The queue to create or update.
+  // Required. The queue to create or update.
   //
-  // The queue's [name][google.cloud.tasks.v2beta2.Queue.name] must be
-  // specified.
+  // The queue's [name][google.cloud.tasks.v2beta2.Queue.name] must be specified.
   //
   // Output only fields cannot be modified using UpdateQueue.
   // Any value specified for an output only field will be ignored.
-  // The queue's [name][google.cloud.tasks.v2beta2.Queue.name] cannot be
-  // changed.
-  Queue queue = 1;
+  // The queue's [name][google.cloud.tasks.v2beta2.Queue.name] cannot be changed.
+  Queue queue = 1 [(google.api.field_behavior) = REQUIRED];
 
   // A mask used to specify which fields of the queue are being updated.
   //
@@ -494,93 +500,102 @@ message UpdateQueueRequest {
   google.protobuf.FieldMask update_mask = 2;
 }
 
-// Request message for
-// [DeleteQueue][google.cloud.tasks.v2beta2.CloudTasks.DeleteQueue].
+// Request message for [DeleteQueue][google.cloud.tasks.v2beta2.CloudTasks.DeleteQueue].
 message DeleteQueueRequest {
-  // Required.
-  //
-  // The queue name. For example:
+  // Required. The queue name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
 }
 
-// Request message for
-// [PurgeQueue][google.cloud.tasks.v2beta2.CloudTasks.PurgeQueue].
+// Request message for [PurgeQueue][google.cloud.tasks.v2beta2.CloudTasks.PurgeQueue].
 message PurgeQueueRequest {
-  // Required.
-  //
-  // The queue name. For example:
+  // Required. The queue name. For example:
   // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
 }
 
-// Request message for
-// [PauseQueue][google.cloud.tasks.v2beta2.CloudTasks.PauseQueue].
+// Request message for [PauseQueue][google.cloud.tasks.v2beta2.CloudTasks.PauseQueue].
 message PauseQueueRequest {
-  // Required.
-  //
-  // The queue name. For example:
+  // Required. The queue name. For example:
   // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
 }
 
-// Request message for
-// [ResumeQueue][google.cloud.tasks.v2beta2.CloudTasks.ResumeQueue].
+// Request message for [ResumeQueue][google.cloud.tasks.v2beta2.CloudTasks.ResumeQueue].
 message ResumeQueueRequest {
-  // Required.
-  //
-  // The queue name. For example:
+  // Required. The queue name. For example:
   // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
 }
 
-// Request message for listing tasks using
-// [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks].
+// Request message for listing tasks using [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks].
 message ListTasksRequest {
-  // Required.
-  //
-  // The queue name. For example:
+  // Required. The queue name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
-  string parent = 1;
-
-  // The response_view specifies which subset of the
-  // [Task][google.cloud.tasks.v2beta2.Task] will be returned.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "cloudtasks.googleapis.com/Task"
+    }
+  ];
+
+  // The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta2.Task] will be
+  // returned.
   //
-  // By default response_view is
-  // [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC]; not all information is
-  // retrieved by default because some data, such as payloads, might be
-  // desirable to return only when needed because of its large size or because
-  // of the sensitivity of data that it contains.
+  // By default response_view is [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC]; not all
+  // information is retrieved by default because some data, such as
+  // payloads, might be desirable to return only when needed because
+  // of its large size or because of the sensitivity of data that it
+  // contains.
   //
-  // Authorization for [FULL][google.cloud.tasks.v2beta2.Task.View.FULL]
-  // requires `cloudtasks.tasks.fullView` [Google
-  // IAM](https://cloud.google.com/iam/) permission on the
-  // [Task][google.cloud.tasks.v2beta2.Task] resource.
+  // Authorization for [FULL][google.cloud.tasks.v2beta2.Task.View.FULL] requires
+  // `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+  // permission on the [Task][google.cloud.tasks.v2beta2.Task] resource.
   Task.View response_view = 2;
 
-  // Requested page size. Fewer tasks than requested might be returned.
+  // Maximum page size.
   //
-  // The maximum page size is 1000. If unspecified, the page size will
-  // be the maximum. Fewer tasks than requested might be returned,
-  // even if more tasks exist; use
-  // [next_page_token][google.cloud.tasks.v2beta2.ListTasksResponse.next_page_token]
-  // in the response to determine if more tasks exist.
+  // Fewer tasks than requested might be returned, even if more tasks exist; use
+  // [next_page_token][google.cloud.tasks.v2beta2.ListTasksResponse.next_page_token] in the response to
+  // determine if more tasks exist.
+  //
+  // The maximum page size is 1000. If unspecified, the page size will be the
+  // maximum.
   int32 page_size = 4;
 
   // A token identifying the page of results to return.
   //
   // To request the first page results, page_token must be empty. To
   // request the next page of results, page_token must be the value of
-  // [next_page_token][google.cloud.tasks.v2beta2.ListTasksResponse.next_page_token]
-  // returned from the previous call to
-  // [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks] method.
+  // [next_page_token][google.cloud.tasks.v2beta2.ListTasksResponse.next_page_token] returned
+  // from the previous call to [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks]
+  // method.
   //
   // The page token is valid for only 2 hours.
   string page_token = 5;
 }
 
-// Response message for listing tasks using
-// [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks].
+// Response message for listing tasks using [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks].
 message ListTasksResponse {
   // The list of tasks.
   repeated Task tasks = 1;
@@ -588,63 +603,63 @@ message ListTasksResponse {
   // A token to retrieve next page of results.
   //
   // To return the next page of results, call
-  // [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks] with this
-  // value as the
+  // [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks] with this value as the
   // [page_token][google.cloud.tasks.v2beta2.ListTasksRequest.page_token].
   //
   // If the next_page_token is empty, there are no more results.
   string next_page_token = 2;
 }
 
-// Request message for getting a task using
-// [GetTask][google.cloud.tasks.v2beta2.CloudTasks.GetTask].
+// Request message for getting a task using [GetTask][google.cloud.tasks.v2beta2.CloudTasks.GetTask].
 message GetTaskRequest {
-  // Required.
-  //
-  // The task name. For example:
+  // Required. The task name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
-  string name = 1;
-
-  // The response_view specifies which subset of the
-  // [Task][google.cloud.tasks.v2beta2.Task] will be returned.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Task"
+    }
+  ];
+
+  // The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta2.Task] will be
+  // returned.
   //
-  // By default response_view is
-  // [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC]; not all information is
-  // retrieved by default because some data, such as payloads, might be
-  // desirable to return only when needed because of its large size or because
-  // of the sensitivity of data that it contains.
+  // By default response_view is [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC]; not all
+  // information is retrieved by default because some data, such as
+  // payloads, might be desirable to return only when needed because
+  // of its large size or because of the sensitivity of data that it
+  // contains.
   //
-  // Authorization for [FULL][google.cloud.tasks.v2beta2.Task.View.FULL]
-  // requires `cloudtasks.tasks.fullView` [Google
-  // IAM](https://cloud.google.com/iam/) permission on the
-  // [Task][google.cloud.tasks.v2beta2.Task] resource.
+  // Authorization for [FULL][google.cloud.tasks.v2beta2.Task.View.FULL] requires
+  // `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+  // permission on the [Task][google.cloud.tasks.v2beta2.Task] resource.
   Task.View response_view = 2;
 }
 
-// Request message for
-// [CreateTask][google.cloud.tasks.v2beta2.CloudTasks.CreateTask].
+// Request message for [CreateTask][google.cloud.tasks.v2beta2.CloudTasks.CreateTask].
 message CreateTaskRequest {
-  // Required.
-  //
-  // The queue name. For example:
+  // Required. The queue name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
   //
   // The queue must already exist.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "cloudtasks.googleapis.com/Task"
+    }
+  ];
 
-  // Required.
-  //
-  // The task to add.
+  // Required. The task to add.
   //
   // Task names have the following format:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`.
-  // The user can optionally specify a task
-  // [name][google.cloud.tasks.v2beta2.Task.name]. If a name is not specified
-  // then the system will generate a random unique task id, which will be set in
-  // the task returned in the [response][google.cloud.tasks.v2beta2.Task.name].
+  // The user can optionally specify a task [name][google.cloud.tasks.v2beta2.Task.name]. If a
+  // name is not specified then the system will generate a random
+  // unique task id, which will be set in the task returned in the
+  // [response][google.cloud.tasks.v2beta2.Task.name].
   //
-  // If [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] is not
-  // set or is in the past then Cloud Tasks will set it to the current time.
+  // If [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] is not set or is in the
+  // past then Cloud Tasks will set it to the current time.
   //
   // Task De-duplication:
   //
@@ -659,50 +674,54 @@ message CreateTaskRequest {
   // for ~9days after the original task was deleted or completed.
   //
   // Because there is an extra lookup cost to identify duplicate task
-  // names, these [CreateTask][google.cloud.tasks.v2beta2.CloudTasks.CreateTask]
-  // calls have significantly increased latency. Using hashed strings for the
-  // task id or for the prefix of the task id is recommended. Choosing task ids
-  // that are sequential or have sequential prefixes, for example using a
+  // names, these [CreateTask][google.cloud.tasks.v2beta2.CloudTasks.CreateTask] calls have significantly
+  // increased latency. Using hashed strings for the task id or for
+  // the prefix of the task id is recommended. Choosing task ids that
+  // are sequential or have sequential prefixes, for example using a
   // timestamp, causes an increase in latency and error rates in all
   // task commands. The infrastructure relies on an approximately
   // uniform distribution of task ids to store and serve tasks
   // efficiently.
-  Task task = 2;
+  Task task = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // The response_view specifies which subset of the
-  // [Task][google.cloud.tasks.v2beta2.Task] will be returned.
+  // The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta2.Task] will be
+  // returned.
   //
-  // By default response_view is
-  // [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC]; not all information is
-  // retrieved by default because some data, such as payloads, might be
-  // desirable to return only when needed because of its large size or because
-  // of the sensitivity of data that it contains.
+  // By default response_view is [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC]; not all
+  // information is retrieved by default because some data, such as
+  // payloads, might be desirable to return only when needed because
+  // of its large size or because of the sensitivity of data that it
+  // contains.
   //
-  // Authorization for [FULL][google.cloud.tasks.v2beta2.Task.View.FULL]
-  // requires `cloudtasks.tasks.fullView` [Google
-  // IAM](https://cloud.google.com/iam/) permission on the
-  // [Task][google.cloud.tasks.v2beta2.Task] resource.
+  // Authorization for [FULL][google.cloud.tasks.v2beta2.Task.View.FULL] requires
+  // `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+  // permission on the [Task][google.cloud.tasks.v2beta2.Task] resource.
   Task.View response_view = 3;
 }
 
 // Request message for deleting a task using
 // [DeleteTask][google.cloud.tasks.v2beta2.CloudTasks.DeleteTask].
 message DeleteTaskRequest {
-  // Required.
-  //
-  // The task name. For example:
+  // Required. The task name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Task"
+    }
+  ];
 }
 
-// Request message for leasing tasks using
-// [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks].
+// Request message for leasing tasks using [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks].
 message LeaseTasksRequest {
-  // Required.
-  //
-  // The queue name. For example:
+  // Required. The queue name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "cloudtasks.googleapis.com/Task"
+    }
+  ];
 
   // The maximum number of tasks to lease.
   //
@@ -710,47 +729,57 @@ message LeaseTasksRequest {
   // `max_tasks` as possible.
   //
   // The largest that `max_tasks` can be is 1000.
+  //
+  // The maximum total size of a [lease tasks response][google.cloud.tasks.v2beta2.LeaseTasksResponse] is
+  // 32 MB. If the sum of all task sizes requested reaches this limit,
+  // fewer tasks than requested are returned.
   int32 max_tasks = 2;
 
+  // Required. The duration of the lease.
+  //
+  // Each task returned in the [response][google.cloud.tasks.v2beta2.LeaseTasksResponse] will
+  // have its [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] set to the current
+  // time plus the `lease_duration`. The task is leased until its
+  // [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time]; thus, the task will not be
+  // returned to another [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] call
+  // before its [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time].
+  //
   //
   // After the worker has successfully finished the work associated
   // with the task, the worker must call via
-  // [AcknowledgeTask][google.cloud.tasks.v2beta2.CloudTasks.AcknowledgeTask]
-  // before the [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time].
-  // Otherwise the task will be returned to a later
-  // [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] call so that
-  // another worker can retry it.
+  // [AcknowledgeTask][google.cloud.tasks.v2beta2.CloudTasks.AcknowledgeTask] before the
+  // [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time]. Otherwise the task will be
+  // returned to a later [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] call so
+  // that another worker can retry it.
   //
   // The maximum lease duration is 1 week.
   // `lease_duration` will be truncated to the nearest second.
-  google.protobuf.Duration lease_duration = 3;
+  google.protobuf.Duration lease_duration = 3 [(google.api.field_behavior) = REQUIRED];
 
-  // The response_view specifies which subset of the
-  // [Task][google.cloud.tasks.v2beta2.Task] will be returned.
+  // The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta2.Task] will be
+  // returned.
   //
-  // By default response_view is
-  // [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC]; not all information is
-  // retrieved by default because some data, such as payloads, might be
-  // desirable to return only when needed because of its large size or because
-  // of the sensitivity of data that it contains.
+  // By default response_view is [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC]; not all
+  // information is retrieved by default because some data, such as
+  // payloads, might be desirable to return only when needed because
+  // of its large size or because of the sensitivity of data that it
+  // contains.
   //
-  // Authorization for [FULL][google.cloud.tasks.v2beta2.Task.View.FULL]
-  // requires `cloudtasks.tasks.fullView` [Google
-  // IAM](https://cloud.google.com/iam/) permission on the
-  // [Task][google.cloud.tasks.v2beta2.Task] resource.
+  // Authorization for [FULL][google.cloud.tasks.v2beta2.Task.View.FULL] requires
+  // `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+  // permission on the [Task][google.cloud.tasks.v2beta2.Task] resource.
   Task.View response_view = 4;
 
   // `filter` can be used to specify a subset of tasks to lease.
   //
   // When `filter` is set to `tag=` then the
-  // [response][google.cloud.tasks.v2beta2.LeaseTasksResponse] will contain only
-  // tasks whose [tag][google.cloud.tasks.v2beta2.PullMessage.tag] is equal to
-  // ``. `` must be less than 500 characters.
+  // [response][google.cloud.tasks.v2beta2.LeaseTasksResponse] will contain only tasks whose
+  // [tag][google.cloud.tasks.v2beta2.PullMessage.tag] is equal to ``. `` must be
+  // less than 500 characters.
   //
   // When `filter` is set to `tag_function=oldest_tag()`, only tasks which have
   // the same tag as the task with the oldest
-  // [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] will be
-  // returned.
+  // [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] will be returned.
   //
   // Grammar Syntax:
   //
@@ -768,14 +797,12 @@ message LeaseTasksRequest {
   // [bytes](https://cloud.google.com/appengine/docs/standard/java/javadoc/com/google/appengine/api/taskqueue/TaskOptions.html#tag-byte:A-),
   // only UTF-8 encoded tags can be used in Cloud Tasks. Tag which
   // aren't UTF-8 encoded can't be used in the
-  // [filter][google.cloud.tasks.v2beta2.LeaseTasksRequest.filter] and the
-  // task's [tag][google.cloud.tasks.v2beta2.PullMessage.tag] will be displayed
-  // as empty in Cloud Tasks.
+  // [filter][google.cloud.tasks.v2beta2.LeaseTasksRequest.filter] and the task's
+  // [tag][google.cloud.tasks.v2beta2.PullMessage.tag] will be displayed as empty in Cloud Tasks.
   string filter = 5;
 }
 
-// Response message for leasing tasks using
-// [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks].
+// Response message for leasing tasks using [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks].
 message LeaseTasksResponse {
   // The leased tasks.
   repeated Task tasks = 1;
@@ -784,120 +811,121 @@ message LeaseTasksResponse {
 // Request message for acknowledging a task using
 // [AcknowledgeTask][google.cloud.tasks.v2beta2.CloudTasks.AcknowledgeTask].
 message AcknowledgeTaskRequest {
-  // Required.
-  //
-  // The task name. For example:
+  // Required. The task name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
-  string name = 1;
-
-  // Required.
-  //
-  // The task's current schedule time, available in the
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Task"
+    }
+  ];
+
+  // Required. The task's current schedule time, available in the
   // [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] returned by
   // [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] response or
-  // [RenewLease][google.cloud.tasks.v2beta2.CloudTasks.RenewLease] response.
-  // This restriction is to ensure that your worker currently holds the lease.
-  google.protobuf.Timestamp schedule_time = 2;
+  // [RenewLease][google.cloud.tasks.v2beta2.CloudTasks.RenewLease] response. This restriction is
+  // to ensure that your worker currently holds the lease.
+  google.protobuf.Timestamp schedule_time = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request message for renewing a lease using
 // [RenewLease][google.cloud.tasks.v2beta2.CloudTasks.RenewLease].
 message RenewLeaseRequest {
-  // Required.
-  //
-  // The task name. For example:
+  // Required. The task name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
-  string name = 1;
-
-  // Required.
-  //
-  // The task's current schedule time, available in the
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Task"
+    }
+  ];
+
+  // Required. The task's current schedule time, available in the
   // [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] returned by
   // [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] response or
-  // [RenewLease][google.cloud.tasks.v2beta2.CloudTasks.RenewLease] response.
-  // This restriction is to ensure that your worker currently holds the lease.
-  google.protobuf.Timestamp schedule_time = 2;
+  // [RenewLease][google.cloud.tasks.v2beta2.CloudTasks.RenewLease] response. This restriction is
+  // to ensure that your worker currently holds the lease.
+  google.protobuf.Timestamp schedule_time = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Required.
-  //
-  // The desired new lease duration, starting from now.
+  // Required. The desired new lease duration, starting from now.
   //
   //
   // The maximum lease duration is 1 week.
   // `lease_duration` will be truncated to the nearest second.
-  google.protobuf.Duration lease_duration = 3;
+  google.protobuf.Duration lease_duration = 3 [(google.api.field_behavior) = REQUIRED];
 
-  // The response_view specifies which subset of the
-  // [Task][google.cloud.tasks.v2beta2.Task] will be returned.
+  // The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta2.Task] will be
+  // returned.
   //
-  // By default response_view is
-  // [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC]; not all information is
-  // retrieved by default because some data, such as payloads, might be
-  // desirable to return only when needed because of its large size or because
-  // of the sensitivity of data that it contains.
+  // By default response_view is [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC]; not all
+  // information is retrieved by default because some data, such as
+  // payloads, might be desirable to return only when needed because
+  // of its large size or because of the sensitivity of data that it
+  // contains.
   //
-  // Authorization for [FULL][google.cloud.tasks.v2beta2.Task.View.FULL]
-  // requires `cloudtasks.tasks.fullView` [Google
-  // IAM](https://cloud.google.com/iam/) permission on the
-  // [Task][google.cloud.tasks.v2beta2.Task] resource.
+  // Authorization for [FULL][google.cloud.tasks.v2beta2.Task.View.FULL] requires
+  // `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+  // permission on the [Task][google.cloud.tasks.v2beta2.Task] resource.
   Task.View response_view = 4;
 }
 
 // Request message for canceling a lease using
 // [CancelLease][google.cloud.tasks.v2beta2.CloudTasks.CancelLease].
 message CancelLeaseRequest {
-  // Required.
-  //
-  // The task name. For example:
+  // Required. The task name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
-  string name = 1;
-
-  // Required.
-  //
-  // The task's current schedule time, available in the
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Task"
+    }
+  ];
+
+  // Required. The task's current schedule time, available in the
   // [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] returned by
   // [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] response or
-  // [RenewLease][google.cloud.tasks.v2beta2.CloudTasks.RenewLease] response.
-  // This restriction is to ensure that your worker currently holds the lease.
-  google.protobuf.Timestamp schedule_time = 2;
-
-  // The response_view specifies which subset of the
-  // [Task][google.cloud.tasks.v2beta2.Task] will be returned.
-  //
-  // By default response_view is
-  // [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC]; not all information is
-  // retrieved by default because some data, such as payloads, might be
-  // desirable to return only when needed because of its large size or because
-  // of the sensitivity of data that it contains.
-  //
-  // Authorization for [FULL][google.cloud.tasks.v2beta2.Task.View.FULL]
-  // requires `cloudtasks.tasks.fullView` [Google
-  // IAM](https://cloud.google.com/iam/) permission on the
-  // [Task][google.cloud.tasks.v2beta2.Task] resource.
+  // [RenewLease][google.cloud.tasks.v2beta2.CloudTasks.RenewLease] response. This restriction is
+  // to ensure that your worker currently holds the lease.
+  google.protobuf.Timestamp schedule_time = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta2.Task] will be
+  // returned.
+  //
+  // By default response_view is [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC]; not all
+  // information is retrieved by default because some data, such as
+  // payloads, might be desirable to return only when needed because
+  // of its large size or because of the sensitivity of data that it
+  // contains.
+  //
+  // Authorization for [FULL][google.cloud.tasks.v2beta2.Task.View.FULL] requires
+  // `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+  // permission on the [Task][google.cloud.tasks.v2beta2.Task] resource.
   Task.View response_view = 3;
 }
 
 // Request message for forcing a task to run now using
 // [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask].
 message RunTaskRequest {
-  // Required.
-  //
-  // The task name. For example:
+  // Required. The task name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
-  string name = 1;
-
-  // The response_view specifies which subset of the
-  // [Task][google.cloud.tasks.v2beta2.Task] will be returned.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Task"
+    }
+  ];
+
+  // The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta2.Task] will be
+  // returned.
   //
-  // By default response_view is
-  // [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC]; not all information is
-  // retrieved by default because some data, such as payloads, might be
-  // desirable to return only when needed because of its large size or because
-  // of the sensitivity of data that it contains.
+  // By default response_view is [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC]; not all
+  // information is retrieved by default because some data, such as
+  // payloads, might be desirable to return only when needed because
+  // of its large size or because of the sensitivity of data that it
+  // contains.
   //
-  // Authorization for [FULL][google.cloud.tasks.v2beta2.Task.View.FULL]
-  // requires `cloudtasks.tasks.fullView` [Google
-  // IAM](https://cloud.google.com/iam/) permission on the
-  // [Task][google.cloud.tasks.v2beta2.Task] resource.
+  // Authorization for [FULL][google.cloud.tasks.v2beta2.Task.View.FULL] requires
+  // `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+  // permission on the [Task][google.cloud.tasks.v2beta2.Task] resource.
   Task.View response_view = 2;
 }
diff --git a/third_party/googleapis/google/cloud/tasks/v2beta2/cloudtasks_gapic.legacy.yaml b/third_party/googleapis/google/cloud/tasks/v2beta2/cloudtasks_gapic.legacy.yaml
new file mode 100644
index 000000000..28584daa9
--- /dev/null
+++ b/third_party/googleapis/google/cloud/tasks/v2beta2/cloudtasks_gapic.legacy.yaml
@@ -0,0 +1,511 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.tasks.v2beta2
+  python:
+    package_name: google.cloud.tasks_v2beta2.gapic
+  go:
+    package_name: cloud.google.com/go/cloudtasks/apiv2beta2
+  csharp:
+    package_name: Google.Cloud.Tasks.V2Beta2
+  ruby:
+    package_name: Google::Cloud::Tasks::V2beta2
+  php:
+    package_name: Google\Cloud\Tasks\V2beta2
+  nodejs:
+    package_name: tasks.v2beta2
+# A list of API interface configurations.
+interfaces:
+- name: google.cloud.tasks.v2beta2.CloudTasks
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}
+    entity_name: project
+    language_overrides:
+    - language: csharp
+      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
+  - name_pattern: projects/{project}/locations/{location}
+    entity_name: location
+  - name_pattern: projects/{project}/locations/{location}/queues/{queue}
+    entity_name: queue
+  - name_pattern: projects/{project}/locations/{location}/queues/{queue}/tasks/{task}
+    entity_name: task
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ListQueues
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    header_request_params:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: queues
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 10000
+  - name: GetQueue
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: queue
+    timeout_millis: 10000
+  - name: CreateQueue
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - queue
+    required_fields:
+    - parent
+    - queue
+    header_request_params:
+    - parent
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 10000
+  - name: UpdateQueue
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - queue
+        - update_mask
+    required_fields:
+    - queue
+    header_request_params:
+    - queue.name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      queue.name: queue
+    timeout_millis: 10000
+  - name: DeleteQueue
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: queue
+    timeout_millis: 10000
+  - name: PurgeQueue
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: queue
+    timeout_millis: 10000
+  - name: PauseQueue
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: queue
+    timeout_millis: 10000
+  - name: ResumeQueue
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: queue
+    timeout_millis: 10000
+  - name: GetIamPolicy
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - resource
+    required_fields:
+    - resource
+    header_request_params:
+    - resource
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: queue
+    timeout_millis: 10000
+  - name: SetIamPolicy
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - resource
+        - policy
+    required_fields:
+    - resource
+    - policy
+    header_request_params:
+    - resource
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: queue
+    timeout_millis: 10000
+  - name: TestIamPermissions
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - resource
+        - permissions
+    required_fields:
+    - resource
+    - permissions
+    header_request_params:
+    - resource
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: queue
+    timeout_millis: 10000
+  - name: ListTasks
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    header_request_params:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: tasks
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: queue
+    timeout_millis: 10000
+  - name: GetTask
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: task
+    timeout_millis: 10000
+  - name: CreateTask
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - task
+    required_fields:
+    - parent
+    - task
+    header_request_params:
+    - parent
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: queue
+    timeout_millis: 10000
+  - name: DeleteTask
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: task
+    timeout_millis: 10000
+  - name: LeaseTasks
+    resource_name_treatment: STATIC_TYPES
+    required_fields:
+    - parent
+    - lease_duration
+    header_request_params:
+    - parent
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: queue
+    timeout_millis: 10000
+  - name: AcknowledgeTask
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - schedule_time
+    required_fields:
+    - name
+    - schedule_time
+    header_request_params:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: task
+    timeout_millis: 10000
+  - name: RenewLease
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - schedule_time
+        - lease_duration
+    required_fields:
+    - name
+    - schedule_time
+    - lease_duration
+    header_request_params:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: task
+    timeout_millis: 10000
+  - name: CancelLease
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - schedule_time
+    required_fields:
+    - name
+    - schedule_time
+    header_request_params:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: task
+    timeout_millis: 10000
+  - name: RunTask
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: task
+    timeout_millis: 10000
+resource_name_generation:
+- message_name: Queue
+  field_entity_map:
+    name: queue
+- message_name: Task
+  field_entity_map:
+    name: task
+- message_name: ListQueuesRequest
+  field_entity_map:
+    parent: location
+- message_name: GetQueueRequest
+  field_entity_map:
+    name: queue
+- message_name: CreateQueueRequest
+  field_entity_map:
+    parent: location
+- message_name: UpdateQueueRequest
+  field_entity_map:
+    queue.name: queue
+- message_name: DeleteQueueRequest
+  field_entity_map:
+    name: queue
+- message_name: PurgeQueueRequest
+  field_entity_map:
+    name: queue
+- message_name: PauseQueueRequest
+  field_entity_map:
+    name: queue
+- message_name: ResumeQueueRequest
+  field_entity_map:
+    name: queue
+- message_name: ListTasksRequest
+  field_entity_map:
+    parent: queue
+- message_name: GetTaskRequest
+  field_entity_map:
+    name: task
+- message_name: CreateTaskRequest
+  field_entity_map:
+    parent: queue
+- message_name: DeleteTaskRequest
+  field_entity_map:
+    name: task
+- message_name: LeaseTasksRequest
+  field_entity_map:
+    parent: queue
+- message_name: AcknowledgeTaskRequest
+  field_entity_map:
+    name: task
+- message_name: RenewLeaseRequest
+  field_entity_map:
+    name: task
+- message_name: CancelLeaseRequest
+  field_entity_map:
+    name: task
+- message_name: RunTaskRequest
+  field_entity_map:
+    name: task
+- message_name: google.iam.v1.GetIamPolicyRequest
+  field_entity_map:
+    resource: "*"
+- message_name: google.iam.v1.SetIamPolicyRequest
+  field_entity_map:
+    resource: "*"
+- message_name: google.iam.v1.TestIamPermissionsRequest
+  field_entity_map:
+    resource: "*"
diff --git a/third_party/googleapis/google/cloud/tasks/v2beta2/cloudtasks_gapic.yaml b/third_party/googleapis/google/cloud/tasks/v2beta2/cloudtasks_gapic.yaml
index d0693fe5f..956f2d082 100644
--- a/third_party/googleapis/google/cloud/tasks/v2beta2/cloudtasks_gapic.yaml
+++ b/third_party/googleapis/google/cloud/tasks/v2beta2/cloudtasks_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -16,497 +16,51 @@ language_settings:
     package_name: Google\Cloud\Tasks\V2beta2
   nodejs:
     package_name: tasks.v2beta2
-# A list of API interface configurations.
 interfaces:
-  # The fully qualified name of the API interface.
 - name: google.cloud.tasks.v2beta2.CloudTasks
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections:
-  - name_pattern: projects/{project}
-    entity_name: project
-    language_overrides:
-    - language: csharp
-      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
-  - name_pattern: projects/{project}/locations/{location}
-    entity_name: location
-  - name_pattern: projects/{project}/locations/{location}/queues/{queue}
-    entity_name: queue
-  - name_pattern: projects/{project}/locations/{location}/queues/{queue}/tasks/{task}
-    entity_name: task
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
   methods:
   - name: ListQueues
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    header_request_params:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: queues
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
     timeout_millis: 10000
   - name: GetQueue
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: queue
     timeout_millis: 10000
   - name: CreateQueue
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - queue
-    required_fields:
-    - parent
-    - queue
-    header_request_params:
-    - parent
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
     timeout_millis: 10000
   - name: UpdateQueue
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - queue
-        - update_mask
-    required_fields:
-    - queue
-    header_request_params:
-    - queue.name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      queue.name: queue
     timeout_millis: 10000
   - name: DeleteQueue
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: queue
     timeout_millis: 10000
   - name: PurgeQueue
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: queue
     timeout_millis: 10000
   - name: PauseQueue
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: queue
     timeout_millis: 10000
   - name: ResumeQueue
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: queue
     timeout_millis: 10000
   - name: GetIamPolicy
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - resource
-    required_fields:
-    - resource
-    header_request_params:
-    - resource
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      resource: queue
     timeout_millis: 10000
   - name: SetIamPolicy
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - resource
-        - policy
-    required_fields:
-    - resource
-    - policy
-    header_request_params:
-    - resource
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      resource: queue
     timeout_millis: 10000
   - name: TestIamPermissions
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - resource
-        - permissions
-    required_fields:
-    - resource
-    - permissions
-    header_request_params:
-    - resource
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      resource: queue
     timeout_millis: 10000
   - name: ListTasks
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    header_request_params:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: tasks
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: queue
     timeout_millis: 10000
   - name: GetTask
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: task
     timeout_millis: 10000
   - name: CreateTask
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - task
-    required_fields:
-    - parent
-    - task
-    header_request_params:
-    - parent
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: queue
     timeout_millis: 10000
   - name: DeleteTask
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: task
     timeout_millis: 10000
   - name: LeaseTasks
-    resource_name_treatment: STATIC_TYPES
-    required_fields:
-    - parent
-    - lease_duration
-    header_request_params:
-    - parent
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: queue
     timeout_millis: 10000
   - name: AcknowledgeTask
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - schedule_time
-    required_fields:
-    - name
-    - schedule_time
-    header_request_params:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: task
     timeout_millis: 10000
   - name: RenewLease
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - schedule_time
-        - lease_duration
-    required_fields:
-    - name
-    - schedule_time
-    - lease_duration
-    header_request_params:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: task
     timeout_millis: 10000
   - name: CancelLease
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - schedule_time
-    required_fields:
-    - name
-    - schedule_time
-    header_request_params:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: task
     timeout_millis: 10000
   - name: RunTask
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: task
     timeout_millis: 10000
-resource_name_generation:
-- message_name: Queue
-  field_entity_map:
-    name: queue
-- message_name: Task
-  field_entity_map:
-    name: task
-- message_name: ListQueuesRequest
-  field_entity_map:
-    parent: location
-- message_name: GetQueueRequest
-  field_entity_map:
-    name: queue
-- message_name: CreateQueueRequest
-  field_entity_map:
-    parent: location
-- message_name: UpdateQueueRequest
-  field_entity_map:
-    queue.name: queue
-- message_name: DeleteQueueRequest
-  field_entity_map:
-    name: queue
-- message_name: PurgeQueueRequest
-  field_entity_map:
-    name: queue
-- message_name: PauseQueueRequest
-  field_entity_map:
-    name: queue
-- message_name: ResumeQueueRequest
-  field_entity_map:
-    name: queue
-- message_name: ListTasksRequest
-  field_entity_map:
-    parent: queue
-- message_name: GetTaskRequest
-  field_entity_map:
-    name: task
-- message_name: CreateTaskRequest
-  field_entity_map:
-    parent: queue
-- message_name: DeleteTaskRequest
-  field_entity_map:
-    name: task
-- message_name: LeaseTasksRequest
-  field_entity_map:
-    parent: queue
-- message_name: AcknowledgeTaskRequest
-  field_entity_map:
-    name: task
-- message_name: RenewLeaseRequest
-  field_entity_map:
-    name: task
-- message_name: CancelLeaseRequest
-  field_entity_map:
-    name: task
-- message_name: RunTaskRequest
-  field_entity_map:
-    name: task
-- message_name: google.iam.v1.GetIamPolicyRequest
-  field_entity_map:
-    resource: "*"
-- message_name: google.iam.v1.SetIamPolicyRequest
-  field_entity_map:
-    resource: "*"
-- message_name: google.iam.v1.TestIamPermissionsRequest
-  field_entity_map:
-    resource: "*"
diff --git a/third_party/googleapis/google/cloud/tasks/v2beta2/cloudtasks_grpc_service_config.json b/third_party/googleapis/google/cloud/tasks/v2beta2/cloudtasks_grpc_service_config.json
new file mode 100755
index 000000000..9cb9f37da
--- /dev/null
+++ b/third_party/googleapis/google/cloud/tasks/v2beta2/cloudtasks_grpc_service_config.json
@@ -0,0 +1,103 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.tasks.v2beta2.CloudTasks",
+          "method": "ListQueues"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta2.CloudTasks",
+          "method": "GetQueue"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta2.CloudTasks",
+          "method": "DeleteQueue"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta2.CloudTasks",
+          "method": "GetIamPolicy"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta2.CloudTasks",
+          "method": "TestIamPermissions"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta2.CloudTasks",
+          "method": "ListTasks"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta2.CloudTasks",
+          "method": "GetTask"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta2.CloudTasks",
+          "method": "DeleteTask"
+        }
+      ],
+      "timeout": "10s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "10s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.tasks.v2beta2.CloudTasks",
+          "method": "CreateQueue"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta2.CloudTasks",
+          "method": "UpdateQueue"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta2.CloudTasks",
+          "method": "PurgeQueue"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta2.CloudTasks",
+          "method": "PauseQueue"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta2.CloudTasks",
+          "method": "ResumeQueue"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta2.CloudTasks",
+          "method": "SetIamPolicy"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta2.CloudTasks",
+          "method": "CreateTask"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta2.CloudTasks",
+          "method": "LeaseTasks"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta2.CloudTasks",
+          "method": "AcknowledgeTask"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta2.CloudTasks",
+          "method": "RenewLease"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta2.CloudTasks",
+          "method": "CancelLease"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta2.CloudTasks",
+          "method": "RunTask"
+        }
+      ],
+      "timeout": "10s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/tasks/v2beta2/cloudtasks_v2beta2.yaml b/third_party/googleapis/google/cloud/tasks/v2beta2/cloudtasks_v2beta2.yaml
new file mode 100644
index 000000000..6e29e8ac0
--- /dev/null
+++ b/third_party/googleapis/google/cloud/tasks/v2beta2/cloudtasks_v2beta2.yaml
@@ -0,0 +1,29 @@
+type: google.api.Service
+config_version: 3
+name: cloudtasks.googleapis.com
+title: Cloud Tasks API
+
+apis:
+- name: google.cloud.tasks.v2beta2.CloudTasks
+
+documentation:
+  summary: Manages the execution of large numbers of distributed requests.
+  overview: |-
+    Cloud Tasks manages the execution of large numbers of distributed
+    requests.
+
+    For more information, see https://cloud.google.com/tasks/.
+
+backend:
+  rules:
+  - selector: 'google.cloud.tasks.v2beta2.CloudTasks.*'
+    deadline: 10.0
+  - selector: google.cloud.tasks.v2beta2.CloudTasks.ListQueues
+    deadline: 15.0
+
+authentication:
+  rules:
+  - selector: 'google.cloud.tasks.v2beta2.CloudTasks.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/tasks/v2beta2/queue.proto b/third_party/googleapis/google/cloud/tasks/v2beta2/queue.proto
index 3aa4b80b3..212ab7384 100644
--- a/third_party/googleapis/google/cloud/tasks/v2beta2/queue.proto
+++ b/third_party/googleapis/google/cloud/tasks/v2beta2/queue.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,15 +11,17 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.tasks.v2beta2;
 
-import "google/api/annotations.proto";
+import "google/api/resource.proto";
 import "google/cloud/tasks/v2beta2/target.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks";
 option java_multiple_files = true;
@@ -30,6 +32,11 @@ option java_package = "com.google.cloud.tasks.v2beta2";
 // how those tasks are dispatched. Configurable properties include rate limits,
 // retry options, target types, and others.
 message Queue {
+  option (google.api.resource) = {
+    type: "cloudtasks.googleapis.com/Queue"
+    pattern: "projects/{project}/locations/{location}/queues/{queue}"
+  };
+
   // State of the queue.
   enum State {
     // Unspecified state.
@@ -48,8 +55,8 @@ message Queue {
     // Tasks are paused by the user. If the queue is paused then Cloud
     // Tasks will stop delivering tasks from it, but more tasks can
     // still be added to it by the user. When a pull queue is paused,
-    // all [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] calls
-    // will return a [FAILED_PRECONDITION][google.rpc.Code.FAILED_PRECONDITION].
+    // all [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] calls will return a
+    // [FAILED_PRECONDITION][google.rpc.Code.FAILED_PRECONDITION].
     PAUSED = 2;
 
     // The queue is disabled.
@@ -63,17 +70,16 @@ message Queue {
     //
     // When a queue is disabled, tasks can still be added to a queue
     // but the tasks are not dispatched and
-    // [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] calls
-    // return a `FAILED_PRECONDITION` error.
+    // [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] calls return a
+    // `FAILED_PRECONDITION` error.
     //
     // To permanently delete this queue and all of its tasks, call
     // [DeleteQueue][google.cloud.tasks.v2beta2.CloudTasks.DeleteQueue].
     DISABLED = 3;
   }
 
-  // Caller-specified and required in
-  // [CreateQueue][google.cloud.tasks.v2beta2.CloudTasks.CreateQueue], after
-  // which it becomes output only.
+  // Caller-specified and required in [CreateQueue][google.cloud.tasks.v2beta2.CloudTasks.CreateQueue],
+  // after which it becomes output only.
   //
   // The queue name.
   //
@@ -93,10 +99,9 @@ message Queue {
   //   hyphens (-). The maximum length is 100 characters.
   string name = 1;
 
-  // Caller-specified and required in
-  // [CreateQueue][google.cloud.tasks.v2beta2.CloudTasks.CreateQueue][], after
-  // which the queue config type becomes output only, though fields within the
-  // config are mutable.
+  // Caller-specified and required in [CreateQueue][google.cloud.tasks.v2beta2.CloudTasks.CreateQueue][],
+  // after which the queue config type becomes output only, though fields within
+  // the config are mutable.
   //
   // The queue's target.
   //
@@ -104,34 +109,30 @@ message Queue {
   oneof target_type {
     // App Engine HTTP target.
     //
-    // An App Engine queue is a queue that has an
-    // [AppEngineHttpTarget][google.cloud.tasks.v2beta2.AppEngineHttpTarget].
+    // An App Engine queue is a queue that has an [AppEngineHttpTarget][google.cloud.tasks.v2beta2.AppEngineHttpTarget].
     AppEngineHttpTarget app_engine_http_target = 3;
 
     // Pull target.
     //
-    // A pull queue is a queue that has a
-    // [PullTarget][google.cloud.tasks.v2beta2.PullTarget].
+    // A pull queue is a queue that has a [PullTarget][google.cloud.tasks.v2beta2.PullTarget].
     PullTarget pull_target = 4;
   }
 
   // Rate limits for task dispatches.
   //
   // [rate_limits][google.cloud.tasks.v2beta2.Queue.rate_limits] and
-  // [retry_config][google.cloud.tasks.v2beta2.Queue.retry_config] are related
-  // because they both control task attempts however they control how tasks are
+  // [retry_config][google.cloud.tasks.v2beta2.Queue.retry_config] are related because they both
+  // control task attempts however they control how tasks are
   // attempted in different ways:
   //
-  // * [rate_limits][google.cloud.tasks.v2beta2.Queue.rate_limits] controls the
-  // total rate of
+  // * [rate_limits][google.cloud.tasks.v2beta2.Queue.rate_limits] controls the total rate of
   //   dispatches from a queue (i.e. all traffic dispatched from the
   //   queue, regardless of whether the dispatch is from a first
   //   attempt or a retry).
-  // * [retry_config][google.cloud.tasks.v2beta2.Queue.retry_config] controls
-  // what happens to
+  // * [retry_config][google.cloud.tasks.v2beta2.Queue.retry_config] controls what happens to
   //   particular a task after its first attempt fails. That is,
-  //   [retry_config][google.cloud.tasks.v2beta2.Queue.retry_config] controls
-  //   task retries (the second attempt, third attempt, etc).
+  //   [retry_config][google.cloud.tasks.v2beta2.Queue.retry_config] controls task retries (the
+  //   second attempt, third attempt, etc).
   RateLimits rate_limits = 5;
 
   // Settings that determine the retry behavior.
@@ -150,21 +151,18 @@ message Queue {
   //
   // `state` can only be changed by called
   // [PauseQueue][google.cloud.tasks.v2beta2.CloudTasks.PauseQueue],
-  // [ResumeQueue][google.cloud.tasks.v2beta2.CloudTasks.ResumeQueue], or
-  // uploading
+  // [ResumeQueue][google.cloud.tasks.v2beta2.CloudTasks.ResumeQueue], or uploading
   // [queue.yaml/xml](https://cloud.google.com/appengine/docs/python/config/queueref).
-  // [UpdateQueue][google.cloud.tasks.v2beta2.CloudTasks.UpdateQueue] cannot be
-  // used to change `state`.
+  // [UpdateQueue][google.cloud.tasks.v2beta2.CloudTasks.UpdateQueue] cannot be used to change `state`.
   State state = 7;
 
   // Output only. The last time this queue was purged.
   //
-  // All tasks that were [created][google.cloud.tasks.v2beta2.Task.create_time]
-  // before this time were purged.
+  // All tasks that were [created][google.cloud.tasks.v2beta2.Task.create_time] before this time
+  // were purged.
   //
-  // A queue can be purged using
-  // [PurgeQueue][google.cloud.tasks.v2beta2.CloudTasks.PurgeQueue], the [App
-  // Engine Task Queue SDK, or the Cloud
+  // A queue can be purged using [PurgeQueue][google.cloud.tasks.v2beta2.CloudTasks.PurgeQueue], the
+  // [App Engine Task Queue SDK, or the Cloud
   // Console](https://cloud.google.com/appengine/docs/standard/python/taskqueue/push/deleting-tasks-and-queues#purging_all_tasks_from_a_queue).
   //
   // Purge time will be truncated to the nearest microsecond. Purge
@@ -177,24 +175,19 @@ message Queue {
 // This message determines the maximum rate that tasks can be dispatched by a
 // queue, regardless of whether the dispatch is a first task attempt or a retry.
 //
-// Note: The debugging command,
-// [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask], will run a task
-// even if the queue has reached its
-// [RateLimits][google.cloud.tasks.v2beta2.RateLimits].
+// Note: The debugging command, [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask], will run a task
+// even if the queue has reached its [RateLimits][google.cloud.tasks.v2beta2.RateLimits].
 message RateLimits {
   // The maximum rate at which tasks are dispatched from this queue.
   //
   // If unspecified when the queue is created, Cloud Tasks will pick the
   // default.
   //
-  // * For [App Engine queues][google.cloud.tasks.v2beta2.AppEngineHttpTarget],
-  // the maximum allowed value
+  // * For [App Engine queues][google.cloud.tasks.v2beta2.AppEngineHttpTarget], the maximum allowed value
   //   is 500.
-  // * This field is output only   for [pull
-  // queues][google.cloud.tasks.v2beta2.PullTarget]. In addition to the
+  // * This field is output only   for [pull queues][google.cloud.tasks.v2beta2.PullTarget]. In addition to the
   //   `max_tasks_dispatched_per_second` limit, a maximum of 10 QPS of
-  //   [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] requests
-  //   are allowed per pull queue.
+  //   [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] requests are allowed per pull queue.
   //
   //
   // This field has the same meaning as
@@ -227,9 +220,9 @@ message RateLimits {
   // `queue.yaml/xml`, `max_burst_size` is equal to
   // [bucket_size](https://cloud.google.com/appengine/docs/standard/python/config/queueref#bucket_size).
   // Since `max_burst_size` is output only, if
-  // [UpdateQueue][google.cloud.tasks.v2beta2.CloudTasks.UpdateQueue] is called
-  // on a queue created by `queue.yaml/xml`, `max_burst_size` will be reset
-  // based on the value of
+  // [UpdateQueue][google.cloud.tasks.v2beta2.CloudTasks.UpdateQueue] is called on a queue
+  // created by `queue.yaml/xml`, `max_burst_size` will be reset based
+  // on the value of
   // [max_tasks_dispatched_per_second][google.cloud.tasks.v2beta2.RateLimits.max_tasks_dispatched_per_second],
   // regardless of whether
   // [max_tasks_dispatched_per_second][google.cloud.tasks.v2beta2.RateLimits.max_tasks_dispatched_per_second]
@@ -249,9 +242,8 @@ message RateLimits {
   // The maximum allowed value is 5,000.
   //
   // This field is output only for
-  // [pull queues][google.cloud.tasks.v2beta2.PullTarget] and always -1, which
-  // indicates no limit. No other queue types can have `max_concurrent_tasks`
-  // set to -1.
+  // [pull queues][google.cloud.tasks.v2beta2.PullTarget] and always -1, which indicates no limit. No other
+  // queue types can have `max_concurrent_tasks` set to -1.
   //
   //
   // This field has the same meaning as
@@ -289,17 +281,16 @@ message RetryConfig {
   // If positive, `max_retry_duration` specifies the time limit for
   // retrying a failed task, measured from when the task was first
   // attempted. Once `max_retry_duration` time has passed *and* the
-  // task has been attempted
-  // [max_attempts][google.cloud.tasks.v2beta2.RetryConfig.max_attempts] times,
-  // no further attempts will be made and the task will be deleted.
+  // task has been attempted [max_attempts][google.cloud.tasks.v2beta2.RetryConfig.max_attempts]
+  // times, no further attempts will be made and the task will be
+  // deleted.
   //
   // If zero, then the task age is unlimited.
   //
   // If unspecified when the queue is created, Cloud Tasks will pick the
   // default.
   //
-  // This field is output only for [pull
-  // queues][google.cloud.tasks.v2beta2.PullTarget].
+  // This field is output only for [pull queues][google.cloud.tasks.v2beta2.PullTarget].
   //
   //
   // `max_retry_duration` will be truncated to the nearest second.
@@ -309,19 +300,16 @@ message RetryConfig {
   // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
   google.protobuf.Duration max_retry_duration = 3;
 
-  // A task will be [scheduled][google.cloud.tasks.v2beta2.Task.schedule_time]
-  // for retry between
+  // A task will be [scheduled][google.cloud.tasks.v2beta2.Task.schedule_time] for retry between
   // [min_backoff][google.cloud.tasks.v2beta2.RetryConfig.min_backoff] and
-  // [max_backoff][google.cloud.tasks.v2beta2.RetryConfig.max_backoff] duration
-  // after it fails, if the queue's
-  // [RetryConfig][google.cloud.tasks.v2beta2.RetryConfig] specifies that the
-  // task should be retried.
+  // [max_backoff][google.cloud.tasks.v2beta2.RetryConfig.max_backoff] duration after it fails,
+  // if the queue's [RetryConfig][google.cloud.tasks.v2beta2.RetryConfig] specifies that the task should be
+  // retried.
   //
   // If unspecified when the queue is created, Cloud Tasks will pick the
   // default.
   //
-  // This field is output only for [pull
-  // queues][google.cloud.tasks.v2beta2.PullTarget].
+  // This field is output only for [pull queues][google.cloud.tasks.v2beta2.PullTarget].
   //
   //
   // `min_backoff` will be truncated to the nearest second.
@@ -331,19 +319,16 @@ message RetryConfig {
   // queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).
   google.protobuf.Duration min_backoff = 4;
 
-  // A task will be [scheduled][google.cloud.tasks.v2beta2.Task.schedule_time]
-  // for retry between
+  // A task will be [scheduled][google.cloud.tasks.v2beta2.Task.schedule_time] for retry between
   // [min_backoff][google.cloud.tasks.v2beta2.RetryConfig.min_backoff] and
-  // [max_backoff][google.cloud.tasks.v2beta2.RetryConfig.max_backoff] duration
-  // after it fails, if the queue's
-  // [RetryConfig][google.cloud.tasks.v2beta2.RetryConfig] specifies that the
-  // task should be retried.
+  // [max_backoff][google.cloud.tasks.v2beta2.RetryConfig.max_backoff] duration after it fails,
+  // if the queue's [RetryConfig][google.cloud.tasks.v2beta2.RetryConfig] specifies that the task should be
+  // retried.
   //
   // If unspecified when the queue is created, Cloud Tasks will pick the
   // default.
   //
-  // This field is output only for [pull
-  // queues][google.cloud.tasks.v2beta2.PullTarget].
+  // This field is output only for [pull queues][google.cloud.tasks.v2beta2.PullTarget].
   //
   //
   // `max_backoff` will be truncated to the nearest second.
@@ -356,29 +341,26 @@ message RetryConfig {
   // The time between retries will double `max_doublings` times.
   //
   // A task's retry interval starts at
-  // [min_backoff][google.cloud.tasks.v2beta2.RetryConfig.min_backoff], then
-  // doubles `max_doublings` times, then increases linearly, and finally retries
-  // retries at intervals of
+  // [min_backoff][google.cloud.tasks.v2beta2.RetryConfig.min_backoff], then doubles
+  // `max_doublings` times, then increases linearly, and finally
+  // retries retries at intervals of
   // [max_backoff][google.cloud.tasks.v2beta2.RetryConfig.max_backoff] up to
   // [max_attempts][google.cloud.tasks.v2beta2.RetryConfig.max_attempts] times.
   //
-  // For example, if
-  // [min_backoff][google.cloud.tasks.v2beta2.RetryConfig.min_backoff] is 10s,
-  // [max_backoff][google.cloud.tasks.v2beta2.RetryConfig.max_backoff] is 300s,
-  // and `max_doublings` is 3, then the a task will first be retried in 10s. The
-  // retry interval will double three times, and then increase linearly by 2^3 *
-  // 10s.  Finally, the task will retry at intervals of
-  // [max_backoff][google.cloud.tasks.v2beta2.RetryConfig.max_backoff] until the
-  // task has been attempted
-  // [max_attempts][google.cloud.tasks.v2beta2.RetryConfig.max_attempts] times.
-  // Thus, the requests will retry at 10s, 20s, 40s, 80s, 160s, 240s, 300s,
-  // 300s, ....
+  // For example, if [min_backoff][google.cloud.tasks.v2beta2.RetryConfig.min_backoff] is 10s,
+  // [max_backoff][google.cloud.tasks.v2beta2.RetryConfig.max_backoff] is 300s, and
+  // `max_doublings` is 3, then the a task will first be retried in
+  // 10s. The retry interval will double three times, and then
+  // increase linearly by 2^3 * 10s.  Finally, the task will retry at
+  // intervals of [max_backoff][google.cloud.tasks.v2beta2.RetryConfig.max_backoff] until the
+  // task has been attempted [max_attempts][google.cloud.tasks.v2beta2.RetryConfig.max_attempts]
+  // times. Thus, the requests will retry at 10s, 20s, 40s, 80s, 160s,
+  // 240s, 300s, 300s, ....
   //
   // If unspecified when the queue is created, Cloud Tasks will pick the
   // default.
   //
-  // This field is output only for [pull
-  // queues][google.cloud.tasks.v2beta2.PullTarget].
+  // This field is output only for [pull queues][google.cloud.tasks.v2beta2.PullTarget].
   //
   //
   // This field has the same meaning as
diff --git a/third_party/googleapis/google/cloud/tasks/v2beta2/target.proto b/third_party/googleapis/google/cloud/tasks/v2beta2/target.proto
index ae1b5555d..decdbaf8b 100644
--- a/third_party/googleapis/google/cloud/tasks/v2beta2/target.proto
+++ b/third_party/googleapis/google/cloud/tasks/v2beta2/target.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,13 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.tasks.v2beta2;
 
 import "google/api/annotations.proto";
-import "google/protobuf/duration.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks";
 option java_multiple_files = true;
@@ -25,11 +25,12 @@ option java_outer_classname = "TargetProto";
 option java_package = "com.google.cloud.tasks.v2beta2";
 
 // Pull target.
-message PullTarget {}
+message PullTarget {
+
+}
 
 // The pull message contains data that can be used by the caller of
-// [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] to process the
-// task.
+// [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] to process the task.
 //
 // This proto can only be used for tasks in a queue which has
 // [pull_target][google.cloud.tasks.v2beta2.Queue.pull_target] set.
@@ -41,11 +42,10 @@ message PullMessage {
   //
   // Tags allow similar tasks to be processed in a batch. If you label
   // tasks with a tag, your worker can
-  // [lease tasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] with the
-  // same tag using
-  // [filter][google.cloud.tasks.v2beta2.LeaseTasksRequest.filter]. For example,
-  // if you want to aggregate the events associated with a specific user once a
-  // day, you could tag tasks with the user ID.
+  // [lease tasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] with the same tag using
+  // [filter][google.cloud.tasks.v2beta2.LeaseTasksRequest.filter]. For example, if you want to
+  // aggregate the events associated with a specific user once a day,
+  // you could tag tasks with the user ID.
   //
   // The task's tag can only be set when the
   // [task is created][google.cloud.tasks.v2beta2.CloudTasks.CreateTask].
@@ -63,15 +63,11 @@ message PullMessage {
 // App Engine HTTP target.
 //
 // The task will be delivered to the App Engine application hostname
-// specified by its
-// [AppEngineHttpTarget][google.cloud.tasks.v2beta2.AppEngineHttpTarget] and
-// [AppEngineHttpRequest][google.cloud.tasks.v2beta2.AppEngineHttpRequest]. The
-// documentation for
-// [AppEngineHttpRequest][google.cloud.tasks.v2beta2.AppEngineHttpRequest]
-// explains how the task's host URL is constructed.
+// specified by its [AppEngineHttpTarget][google.cloud.tasks.v2beta2.AppEngineHttpTarget] and [AppEngineHttpRequest][google.cloud.tasks.v2beta2.AppEngineHttpRequest].
+// The documentation for [AppEngineHttpRequest][google.cloud.tasks.v2beta2.AppEngineHttpRequest] explains how the
+// task's host URL is constructed.
 //
-// Using [AppEngineHttpTarget][google.cloud.tasks.v2beta2.AppEngineHttpTarget]
-// requires
+// Using [AppEngineHttpTarget][google.cloud.tasks.v2beta2.AppEngineHttpTarget] requires
 // [`appengine.applications.get`](https://cloud.google.com/appengine/docs/admin-api/access-control)
 // Google IAM permission for the project
 // and the following scope:
@@ -79,13 +75,11 @@ message PullMessage {
 // `https://www.googleapis.com/auth/cloud-platform`
 message AppEngineHttpTarget {
   // Overrides for the
-  // [task-level
-  // app_engine_routing][google.cloud.tasks.v2beta2.AppEngineHttpRequest.app_engine_routing].
+  // [task-level app_engine_routing][google.cloud.tasks.v2beta2.AppEngineHttpRequest.app_engine_routing].
   //
   // If set, `app_engine_routing_override` is used for all tasks in
   // the queue, no matter what the setting is for the
-  // [task-level
-  // app_engine_routing][google.cloud.tasks.v2beta2.AppEngineHttpRequest.app_engine_routing].
+  // [task-level app_engine_routing][google.cloud.tasks.v2beta2.AppEngineHttpRequest.app_engine_routing].
   AppEngineRouting app_engine_routing_override = 1;
 }
 
@@ -95,11 +89,9 @@ message AppEngineHttpTarget {
 // the task is dispatched.
 //
 // This proto can only be used for tasks in a queue which has
-// [app_engine_http_target][google.cloud.tasks.v2beta2.Queue.app_engine_http_target]
-// set.
+// [app_engine_http_target][google.cloud.tasks.v2beta2.Queue.app_engine_http_target] set.
 //
-// Using [AppEngineHttpRequest][google.cloud.tasks.v2beta2.AppEngineHttpRequest]
-// requires
+// Using [AppEngineHttpRequest][google.cloud.tasks.v2beta2.AppEngineHttpRequest] requires
 // [`appengine.applications.get`](https://cloud.google.com/appengine/docs/admin-api/access-control)
 // Google IAM permission for the project
 // and the following scope:
@@ -113,17 +105,20 @@ message AppEngineHttpTarget {
 // and how routing is affected by
 // [dispatch
 // files](https://cloud.google.com/appengine/docs/python/config/dispatchref).
+// Traffic is encrypted during transport and never leaves Google datacenters.
+// Because this traffic is carried over a communication mechanism internal to
+// Google, you cannot explicitly set the protocol (for example, HTTP or HTTPS).
+// The request to the handler, however, will appear to have used the HTTP
+// protocol.
 //
-// The [AppEngineRouting][google.cloud.tasks.v2beta2.AppEngineRouting] used to
-// construct the URL that the task is delivered to can be set at the queue-level
-// or task-level:
+// The [AppEngineRouting][google.cloud.tasks.v2beta2.AppEngineRouting] used to construct the URL that the task is
+// delivered to can be set at the queue-level or task-level:
 //
 // * If set,
 //    [app_engine_routing_override][google.cloud.tasks.v2beta2.AppEngineHttpTarget.app_engine_routing_override]
 //    is used for all tasks in the queue, no matter what the setting
 //    is for the
-//    [task-level
-//    app_engine_routing][google.cloud.tasks.v2beta2.AppEngineHttpRequest.app_engine_routing].
+//    [task-level app_engine_routing][google.cloud.tasks.v2beta2.AppEngineHttpRequest.app_engine_routing].
 //
 //
 // The `url` that the task will be sent to is:
@@ -131,13 +126,27 @@ message AppEngineHttpTarget {
 // * `url =` [host][google.cloud.tasks.v2beta2.AppEngineRouting.host] `+`
 //   [relative_url][google.cloud.tasks.v2beta2.AppEngineHttpRequest.relative_url]
 //
-// The task attempt has succeeded if the app's request handler returns
-// an HTTP response code in the range [`200` - `299`]. `503` is
-// considered an App Engine system error instead of an application
-// error. Requests returning error `503` will be retried regardless of
-// retry configuration and not counted against retry counts.
-// Any other response code or a failure to receive a response before the
-// deadline is a failed attempt.
+// Tasks can be dispatched to secure app handlers, unsecure app handlers, and
+// URIs restricted with
+// [`login:
+// admin`](https://cloud.google.com/appengine/docs/standard/python/config/appref).
+// Because tasks are not run as any user, they cannot be dispatched to URIs
+// restricted with
+// [`login:
+// required`](https://cloud.google.com/appengine/docs/standard/python/config/appref)
+// Task dispatches also do not follow redirects.
+//
+// The task attempt has succeeded if the app's request handler returns an HTTP
+// response code in the range [`200` - `299`]. The task attempt has failed if
+// the app's handler returns a non-2xx response code or Cloud Tasks does
+// not receive response before the [deadline][Task.dispatch_deadline]. Failed
+// tasks will be retried according to the
+// [retry configuration][google.cloud.tasks.v2beta2.Queue.retry_config]. `503` (Service Unavailable) is
+// considered an App Engine system error instead of an application error and
+// will cause Cloud Tasks' traffic congestion control to temporarily throttle
+// the queue's dispatches. Unlike other types of task targets, a `429` (Too Many
+// Requests) response from an app handler does not cause traffic congestion
+// control to throttle the queue.
 message AppEngineHttpRequest {
   // The HTTP method to use for the request. The default is POST.
   //
@@ -157,8 +166,7 @@ message AppEngineHttpRequest {
   // If set,
   // [app_engine_routing_override][google.cloud.tasks.v2beta2.AppEngineHttpTarget.app_engine_routing_override]
   // is used for all tasks in the queue, no matter what the setting is for the
-  // [task-level
-  // app_engine_routing][google.cloud.tasks.v2beta2.AppEngineHttpRequest.app_engine_routing].
+  // [task-level app_engine_routing][google.cloud.tasks.v2beta2.AppEngineHttpRequest.app_engine_routing].
   AppEngineRouting app_engine_routing = 2;
 
   // The relative URL.
@@ -184,8 +192,7 @@ message AppEngineHttpRequest {
   //   `"AppEngine-Google; (+http://code.google.com/appengine)"` to the
   //   modified `User-Agent`.
   //
-  // If the task has a
-  // [payload][google.cloud.tasks.v2beta2.AppEngineHttpRequest.payload], Cloud
+  // If the task has a [payload][google.cloud.tasks.v2beta2.AppEngineHttpRequest.payload], Cloud
   // Tasks sets the following headers:
   //
   // * `Content-Type`: By default, the `Content-Type` header is set to
@@ -210,10 +217,8 @@ message AppEngineHttpRequest {
   // visible when the task is returned in a Cloud Tasks response.
   //
   // Although there is no specific limit for the maximum number of headers or
-  // the size, there is a limit on the maximum size of the
-  // [Task][google.cloud.tasks.v2beta2.Task]. For more information, see the
-  // [CreateTask][google.cloud.tasks.v2beta2.CloudTasks.CreateTask]
-  // documentation.
+  // the size, there is a limit on the maximum size of the [Task][google.cloud.tasks.v2beta2.Task]. For more
+  // information, see the [CreateTask][google.cloud.tasks.v2beta2.CloudTasks.CreateTask] documentation.
   map headers = 4;
 
   // Payload.
@@ -227,6 +232,9 @@ message AppEngineHttpRequest {
 
 // App Engine Routing.
 //
+// Defines routing characteristics specific to App Engine - service, version,
+// and instance.
+//
 // For more information about services, versions, and instances see
 // [An Overview of App
 // Engine](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine),
@@ -243,18 +251,16 @@ message AppEngineRouting {
   // service when the task is attempted.
   //
   // For some queues or tasks which were created using the App Engine
-  // Task Queue API, [host][google.cloud.tasks.v2beta2.AppEngineRouting.host] is
-  // not parsable into
-  // [service][google.cloud.tasks.v2beta2.AppEngineRouting.service],
+  // Task Queue API, [host][google.cloud.tasks.v2beta2.AppEngineRouting.host] is not parsable
+  // into [service][google.cloud.tasks.v2beta2.AppEngineRouting.service],
   // [version][google.cloud.tasks.v2beta2.AppEngineRouting.version], and
-  // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance]. For
-  // example, some tasks which were created using the App Engine SDK use a
-  // custom domain name; custom domains are not parsed by Cloud Tasks. If
-  // [host][google.cloud.tasks.v2beta2.AppEngineRouting.host] is not parsable,
-  // then [service][google.cloud.tasks.v2beta2.AppEngineRouting.service],
+  // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance]. For example, some tasks
+  // which were created using the App Engine SDK use a custom domain
+  // name; custom domains are not parsed by Cloud Tasks. If
+  // [host][google.cloud.tasks.v2beta2.AppEngineRouting.host] is not parsable, then
+  // [service][google.cloud.tasks.v2beta2.AppEngineRouting.service],
   // [version][google.cloud.tasks.v2beta2.AppEngineRouting.version], and
-  // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] are the
-  // empty string.
+  // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] are the empty string.
   string service = 1;
 
   // App version.
@@ -263,18 +269,16 @@ message AppEngineRouting {
   // version when the task is attempted.
   //
   // For some queues or tasks which were created using the App Engine
-  // Task Queue API, [host][google.cloud.tasks.v2beta2.AppEngineRouting.host] is
-  // not parsable into
-  // [service][google.cloud.tasks.v2beta2.AppEngineRouting.service],
+  // Task Queue API, [host][google.cloud.tasks.v2beta2.AppEngineRouting.host] is not parsable
+  // into [service][google.cloud.tasks.v2beta2.AppEngineRouting.service],
   // [version][google.cloud.tasks.v2beta2.AppEngineRouting.version], and
-  // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance]. For
-  // example, some tasks which were created using the App Engine SDK use a
-  // custom domain name; custom domains are not parsed by Cloud Tasks. If
-  // [host][google.cloud.tasks.v2beta2.AppEngineRouting.host] is not parsable,
-  // then [service][google.cloud.tasks.v2beta2.AppEngineRouting.service],
+  // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance]. For example, some tasks
+  // which were created using the App Engine SDK use a custom domain
+  // name; custom domains are not parsed by Cloud Tasks. If
+  // [host][google.cloud.tasks.v2beta2.AppEngineRouting.host] is not parsable, then
+  // [service][google.cloud.tasks.v2beta2.AppEngineRouting.service],
   // [version][google.cloud.tasks.v2beta2.AppEngineRouting.version], and
-  // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] are the
-  // empty string.
+  // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] are the empty string.
   string version = 2;
 
   // App instance.
@@ -315,49 +319,44 @@ message AppEngineRouting {
   //   queue's project ID. Some tasks which were created using the App Engine
   //   SDK use a custom domain name.
   //
-  // * `service =`
-  // [service][google.cloud.tasks.v2beta2.AppEngineRouting.service]
+  // * `service =` [service][google.cloud.tasks.v2beta2.AppEngineRouting.service]
   //
-  // * `version =`
-  // [version][google.cloud.tasks.v2beta2.AppEngineRouting.version]
+  // * `version =` [version][google.cloud.tasks.v2beta2.AppEngineRouting.version]
   //
   // * `version_dot_service =`
   //   [version][google.cloud.tasks.v2beta2.AppEngineRouting.version] `+ '.' +`
   //   [service][google.cloud.tasks.v2beta2.AppEngineRouting.service]
   //
-  // * `instance =`
-  // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance]
+  // * `instance =` [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance]
   //
   // * `instance_dot_service =`
-  //   [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] `+ '.'
-  //   +` [service][google.cloud.tasks.v2beta2.AppEngineRouting.service]
+  //   [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] `+ '.' +`
+  //   [service][google.cloud.tasks.v2beta2.AppEngineRouting.service]
   //
   // * `instance_dot_version =`
-  //   [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] `+ '.'
-  //   +` [version][google.cloud.tasks.v2beta2.AppEngineRouting.version]
+  //   [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] `+ '.' +`
+  //   [version][google.cloud.tasks.v2beta2.AppEngineRouting.version]
   //
   // * `instance_dot_version_dot_service =`
-  //   [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] `+ '.'
-  //   +` [version][google.cloud.tasks.v2beta2.AppEngineRouting.version] `+ '.'
-  //   +` [service][google.cloud.tasks.v2beta2.AppEngineRouting.service]
+  //   [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] `+ '.' +`
+  //   [version][google.cloud.tasks.v2beta2.AppEngineRouting.version] `+ '.' +`
+  //   [service][google.cloud.tasks.v2beta2.AppEngineRouting.service]
   //
-  // If [service][google.cloud.tasks.v2beta2.AppEngineRouting.service] is empty,
-  // then the task will be sent to the service which is the default service when
-  // the task is attempted.
+  // If [service][google.cloud.tasks.v2beta2.AppEngineRouting.service] is empty, then the task will be sent
+  // to the service which is the default service when the task is attempted.
   //
-  // If [version][google.cloud.tasks.v2beta2.AppEngineRouting.version] is empty,
-  // then the task will be sent to the version which is the default version when
-  // the task is attempted.
+  // If [version][google.cloud.tasks.v2beta2.AppEngineRouting.version] is empty, then the task will be sent
+  // to the version which is the default version when the task is attempted.
   //
-  // If [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] is
-  // empty, then the task will be sent to an instance which is available when
-  // the task is attempted.
+  // If [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] is empty, then the task
+  // will be sent to an instance which is available when the task is
+  // attempted.
   //
   // If [service][google.cloud.tasks.v2beta2.AppEngineRouting.service],
   // [version][google.cloud.tasks.v2beta2.AppEngineRouting.version], or
-  // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] is
-  // invalid, then the task will be sent to the default version of the default
-  // service when the task is attempted.
+  // [instance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] is invalid, then the task
+  // will be sent to the default version of the default service when
+  // the task is attempted.
   string host = 4;
 }
 
diff --git a/third_party/googleapis/google/cloud/tasks/v2beta2/task.proto b/third_party/googleapis/google/cloud/tasks/v2beta2/task.proto
index f9e18be49..9a927462c 100644
--- a/third_party/googleapis/google/cloud/tasks/v2beta2/task.proto
+++ b/third_party/googleapis/google/cloud/tasks/v2beta2/task.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,15 +11,17 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.tasks.v2beta2;
 
-import "google/api/annotations.proto";
+import "google/api/resource.proto";
 import "google/cloud/tasks/v2beta2/target.proto";
 import "google/protobuf/timestamp.proto";
 import "google/rpc/status.proto";
+import "google/api/annotations.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks";
 option java_multiple_files = true;
@@ -28,8 +30,12 @@ option java_package = "com.google.cloud.tasks.v2beta2";
 
 // A unit of scheduled work.
 message Task {
-  // The view specifies a subset of [Task][google.cloud.tasks.v2beta2.Task]
-  // data.
+  option (google.api.resource) = {
+    type: "cloudtasks.googleapis.com/Task"
+    pattern: "projects/{project}/locations/{location}/queues/{queue}/tasks/{task}"
+  };
+
+  // The view specifies a subset of [Task][google.cloud.tasks.v2beta2.Task] data.
   //
   // When a task is returned in a response, not all
   // information is retrieved by default because some data, such as
@@ -44,26 +50,22 @@ message Task {
     // sensitive data.
     //
     // This view does not include the
-    // ([payload in
-    // AppEngineHttpRequest][google.cloud.tasks.v2beta2.AppEngineHttpRequest]
-    // and [payload in
-    // PullMessage][google.cloud.tasks.v2beta2.PullMessage.payload]). These
-    // payloads are desirable to return only when needed, because they can be
-    // large and because of the sensitivity of the data that you choose to store
-    // in it.
+    // ([payload in AppEngineHttpRequest][google.cloud.tasks.v2beta2.AppEngineHttpRequest] and
+    // [payload in PullMessage][google.cloud.tasks.v2beta2.PullMessage.payload]). These payloads are
+    // desirable to return only when needed, because they can be large
+    // and because of the sensitivity of the data that you choose to
+    // store in it.
     BASIC = 1;
 
     // All information is returned.
     //
-    // Authorization for [FULL][google.cloud.tasks.v2beta2.Task.View.FULL]
-    // requires `cloudtasks.tasks.fullView` [Google
-    // IAM](https://cloud.google.com/iam/) permission on the
-    // [Queue][google.cloud.tasks.v2beta2.Queue] resource.
+    // Authorization for [FULL][google.cloud.tasks.v2beta2.Task.View.FULL] requires
+    // `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
+    // permission on the [Queue][google.cloud.tasks.v2beta2.Queue] resource.
     FULL = 2;
   }
 
-  // Optionally caller-specified in
-  // [CreateTask][google.cloud.tasks.v2beta2.CloudTasks.CreateTask].
+  // Optionally caller-specified in [CreateTask][google.cloud.tasks.v2beta2.CloudTasks.CreateTask].
   //
   // The task name.
   //
@@ -92,21 +94,16 @@ message Task {
   oneof payload_type {
     // App Engine HTTP request that is sent to the task's target. Can
     // be set only if
-    // [app_engine_http_target][google.cloud.tasks.v2beta2.Queue.app_engine_http_target]
-    // is set on the queue.
+    // [app_engine_http_target][google.cloud.tasks.v2beta2.Queue.app_engine_http_target] is set
+    // on the queue.
     //
-    // An App Engine task is a task that has
-    // [AppEngineHttpRequest][google.cloud.tasks.v2beta2.AppEngineHttpRequest]
-    // set.
+    // An App Engine task is a task that has [AppEngineHttpRequest][google.cloud.tasks.v2beta2.AppEngineHttpRequest] set.
     AppEngineHttpRequest app_engine_http_request = 3;
 
-    // [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] to process
-    // the task. Can be set only if
-    // [pull_target][google.cloud.tasks.v2beta2.Queue.pull_target] is set on the
-    // queue.
+    // [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] to process the task. Can be
+    // set only if [pull_target][google.cloud.tasks.v2beta2.Queue.pull_target] is set on the queue.
     //
-    // A pull task is a task that has
-    // [PullMessage][google.cloud.tasks.v2beta2.PullMessage] set.
+    // A pull task is a task that has [PullMessage][google.cloud.tasks.v2beta2.PullMessage] set.
     PullMessage pull_message = 4;
   }
 
@@ -117,8 +114,7 @@ message Task {
   // For pull queues, this is the time when the task is available to
   // be leased; if a task is currently leased, this is the time when
   // the current lease expires, that is, the time that the task was
-  // leased plus the
-  // [lease_duration][google.cloud.tasks.v2beta2.LeaseTasksRequest.lease_duration].
+  // leased plus the [lease_duration][google.cloud.tasks.v2beta2.LeaseTasksRequest.lease_duration].
   //
   // `schedule_time` will be truncated to the nearest microsecond.
   google.protobuf.Timestamp schedule_time = 5;
@@ -131,8 +127,8 @@ message Task {
   // Output only. The task status.
   TaskStatus status = 7;
 
-  // Output only. The view specifies which subset of the
-  // [Task][google.cloud.tasks.v2beta2.Task] has been returned.
+  // Output only. The view specifies which subset of the [Task][google.cloud.tasks.v2beta2.Task] has
+  // been returned.
   View view = 8;
 }
 
@@ -140,32 +136,26 @@ message Task {
 message TaskStatus {
   // Output only. The number of attempts dispatched.
   //
-  // This count includes tasks which have been dispatched but haven't
+  // This count includes attempts which have been dispatched but haven't
   // received a response.
   int32 attempt_dispatch_count = 1;
 
   // Output only. The number of attempts which have received a response.
   //
-  // This field is not calculated for [pull
-  // tasks][google.cloud.tasks.v2beta2.PullMessage].
+  // This field is not calculated for [pull tasks][google.cloud.tasks.v2beta2.PullMessage].
   int32 attempt_response_count = 2;
 
   // Output only. The status of the task's first attempt.
   //
-  // Only
-  // [dispatch_time][google.cloud.tasks.v2beta2.AttemptStatus.dispatch_time]
-  // will be set. The other
-  // [AttemptStatus][google.cloud.tasks.v2beta2.AttemptStatus] information is
-  // not retained by Cloud Tasks.
+  // Only [dispatch_time][google.cloud.tasks.v2beta2.AttemptStatus.dispatch_time] will be set.
+  // The other [AttemptStatus][google.cloud.tasks.v2beta2.AttemptStatus] information is not retained by Cloud Tasks.
   //
-  // This field is not calculated for [pull
-  // tasks][google.cloud.tasks.v2beta2.PullMessage].
+  // This field is not calculated for [pull tasks][google.cloud.tasks.v2beta2.PullMessage].
   AttemptStatus first_attempt_status = 3;
 
   // Output only. The status of the task's last attempt.
   //
-  // This field is not calculated for [pull
-  // tasks][google.cloud.tasks.v2beta2.PullMessage].
+  // This field is not calculated for [pull tasks][google.cloud.tasks.v2beta2.PullMessage].
   AttemptStatus last_attempt_status = 4;
 }
 
diff --git a/third_party/googleapis/google/cloud/tasks/v2beta3/BUILD.bazel b/third_party/googleapis/google/cloud/tasks/v2beta3/BUILD.bazel
index 2af528f0e..b3477f4a0 100644
--- a/third_party/googleapis/google/cloud/tasks/v2beta3/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/tasks/v2beta3/BUILD.bazel
@@ -1,9 +1,12 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
@@ -16,10 +19,11 @@ proto_library(
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
         "//google/api:resource_proto",
         "//google/iam/v1:iam_policy_proto",
         "//google/iam/v1:policy_proto",
-        "//google/rpc:code_proto",
         "//google/rpc:status_proto",
         "@com_google_protobuf//:duration_proto",
         "@com_google_protobuf//:empty_proto",
@@ -30,7 +34,10 @@ proto_library(
 
 proto_library_with_info(
     name = "tasks_proto_with_info",
-    deps = [":tasks_proto"],
+    deps = [
+        ":tasks_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -38,19 +45,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-    "@com_google_api_grpc_proto_google_iam_v1//jar",
-]
-
 java_proto_library(
     name = "tasks_java_proto",
     deps = [":tasks_proto"],
@@ -59,51 +60,42 @@ java_proto_library(
 java_grpc_library(
     name = "tasks_java_grpc",
     srcs = [":tasks_proto"],
-    deps = [":tasks_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "tasks_resource_name_java_proto",
-    gapic_yaml = "cloudtasks_gapic.yaml",
-    deps = [":tasks_proto"],
+    deps = [":tasks_java_proto"],
 )
 
 java_gapic_library(
     name = "tasks_java_gapic",
     src = ":tasks_proto_with_info",
     gapic_yaml = "cloudtasks_gapic.yaml",
-    service_yaml = "//google/cloud/tasks:cloudtasks_v2beta3.yaml",
-    test_deps = [":tasks_java_grpc"],
+    package = "google.cloud.tasks.v2beta3",
+    service_yaml = "cloudtasks_v2beta3.yaml",
+    test_deps = [
+        ":tasks_java_grpc",
+        "//google/iam/v1:iam_java_grpc",
+    ],
     deps = [
         ":tasks_java_proto",
-        ":tasks_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+        "//google/iam/v1:iam_java_proto",
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":tasks_java_gapic_test",
+java_gapic_test(
+    name = "tasks_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.tasks.v2beta3.CloudTasksClientTest",
     ],
-) for test_name in [
-    "com.google.cloud.tasks.v2beta3.CloudTasksClientTest",
-]]
+    runtime_deps = [":tasks_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-tasks-v2beta3-java",
-    client_deps = [":tasks_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":tasks_java_gapic_test"],
-    grpc_deps = [":tasks_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":tasks_java_gapic",
+        ":tasks_java_grpc",
         ":tasks_java_proto",
         ":tasks_proto",
-        ":tasks_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -111,10 +103,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -125,17 +117,16 @@ go_proto_library(
     deps = [
         "//google/api:annotations_go_proto",
         "//google/iam/v1:iam_go_proto",
-        "//google/rpc:code_go_proto",
         "//google/rpc:status_go_proto",
     ],
 )
 
 go_gapic_library(
     name = "tasks_go_gapic",
-    src = ":tasks_proto_with_info",
-    gapic_yaml = "cloudtasks_gapic.yaml",
-    importpath = "cloud.google.com/go/cloudtasks/apiv2beta3",
-    service_yaml = "//google/cloud/tasks:cloudtasks_v2beta3.yaml",
+    srcs = [":tasks_proto_with_info"],
+    grpc_service_config = "cloudtasks_grpc_service_config.json",
+    importpath = "cloud.google.com/go/cloudtasks/apiv2beta3;tasks",
+    service_yaml = "cloudtasks_v2beta3.yaml",
     deps = [
         ":tasks_go_proto",
         "//google/iam/v1:iam_go_proto",
@@ -150,13 +141,239 @@ go_test(
     importpath = "cloud.google.com/go/cloudtasks/apiv2beta3",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-tasks-v2beta3-go",
     deps = [
         ":tasks_go_gapic",
-        ":tasks_go_gapic_srcjar-smoke-test.srcjar",
         ":tasks_go_gapic_srcjar-test.srcjar",
         ":tasks_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "tasks_moved_proto",
+    srcs = [":tasks_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/iam/v1:iam_policy_proto",
+        "//google/iam/v1:policy_proto",
+        "//google/rpc:status_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "tasks_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":tasks_moved_proto"],
+)
+
+py_grpc_library(
+    name = "tasks_py_grpc",
+    srcs = [":tasks_moved_proto"],
+    deps = [":tasks_py_proto"],
+)
+
+py_gapic_library(
+    name = "tasks_py_gapic",
+    src = ":tasks_proto_with_info",
+    gapic_yaml = "cloudtasks_gapic.yaml",
+    package = "google.cloud.tasks.v2beta3",
+    service_yaml = "cloudtasks_v2beta3.yaml",
+    deps = [
+        ":tasks_py_grpc",
+        ":tasks_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "tasks-v2beta3-py",
+    deps = [
+        ":tasks_py_gapic",
+        ":tasks_py_grpc",
+        ":tasks_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "tasks_php_proto",
+    deps = [":tasks_proto"],
+)
+
+php_grpc_library(
+    name = "tasks_php_grpc",
+    srcs = [":tasks_proto"],
+    deps = [":tasks_php_proto"],
+)
+
+php_gapic_library(
+    name = "tasks_php_gapic",
+    src = ":tasks_proto_with_info",
+    gapic_yaml = "cloudtasks_gapic.yaml",
+    package = "google.cloud.tasks.v2beta3",
+    service_yaml = "cloudtasks_v2beta3.yaml",
+    deps = [
+        ":tasks_php_grpc",
+        ":tasks_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-tasks-v2beta3-php",
+    deps = [
+        ":tasks_php_gapic",
+        ":tasks_php_grpc",
+        ":tasks_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "tasks_nodejs_gapic",
+    src = ":tasks_proto_with_info",
+    gapic_yaml = "cloudtasks_gapic.yaml",
+    package = "google.cloud.tasks.v2beta3",
+    service_yaml = "cloudtasks_v2beta3.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "tasks-v2beta3-nodejs",
+    deps = [
+        ":tasks_nodejs_gapic",
+        ":tasks_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "tasks_ruby_proto",
+    deps = [":tasks_proto"],
+)
+
+ruby_grpc_library(
+    name = "tasks_ruby_grpc",
+    srcs = [":tasks_proto"],
+    deps = [":tasks_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "tasks_ruby_gapic",
+    src = ":tasks_proto_with_info",
+    gapic_yaml = "cloudtasks_gapic.yaml",
+    package = "google.cloud.tasks.v2beta3",
+    service_yaml = "cloudtasks_v2beta3.yaml",
+    deps = [
+        ":tasks_ruby_grpc",
+        ":tasks_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-tasks-v2beta3-ruby",
+    deps = [
+        ":tasks_ruby_gapic",
+        ":tasks_ruby_grpc",
+        ":tasks_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "tasks_csharp_proto",
+    deps = [":tasks_proto"],
+)
+
+csharp_grpc_library(
+    name = "tasks_csharp_grpc",
+    srcs = [":tasks_proto"],
+    deps = [":tasks_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "tasks_csharp_gapic",
+    src = ":tasks_proto_with_info",
+    gapic_yaml = "cloudtasks_gapic.yaml",
+    package = "google.cloud.tasks.v2beta3",
+    service_yaml = "cloudtasks_v2beta3.yaml",
+    deps = [
+        ":tasks_csharp_grpc",
+        ":tasks_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-tasks-v2beta3-csharp",
+    deps = [
+        ":tasks_csharp_gapic",
+        ":tasks_csharp_grpc",
+        ":tasks_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/tasks/v2beta3/cloudtasks.proto b/third_party/googleapis/google/cloud/tasks/v2beta3/cloudtasks.proto
index 66971c3e6..711c7a616 100644
--- a/third_party/googleapis/google/cloud/tasks/v2beta3/cloudtasks.proto
+++ b/third_party/googleapis/google/cloud/tasks/v2beta3/cloudtasks.proto
@@ -18,6 +18,8 @@ syntax = "proto3";
 package google.cloud.tasks.v2beta3;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/cloud/tasks/v2beta3/queue.proto";
 import "google/cloud/tasks/v2beta3/task.proto";
@@ -25,7 +27,6 @@ import "google/iam/v1/iam_policy.proto";
 import "google/iam/v1/policy.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
-import "google/rpc/code.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks";
 option java_multiple_files = true;
@@ -36,6 +37,9 @@ option objc_class_prefix = "TASKS";
 // Cloud Tasks allows developers to manage the execution of background
 // work in their applications.
 service CloudTasks {
+  option (google.api.default_host) = "cloudtasks.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Lists queues.
   //
   // Queues are returned in lexicographical order.
@@ -43,6 +47,7 @@ service CloudTasks {
     option (google.api.http) = {
       get: "/v2beta3/{parent=projects/*/locations/*}/queues"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets a queue.
@@ -50,6 +55,7 @@ service CloudTasks {
     option (google.api.http) = {
       get: "/v2beta3/{name=projects/*/locations/*/queues/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates a queue.
@@ -69,6 +75,7 @@ service CloudTasks {
       post: "/v2beta3/{parent=projects/*/locations/*}/queues"
       body: "queue"
     };
+    option (google.api.method_signature) = "parent,queue";
   }
 
   // Updates a queue.
@@ -91,6 +98,7 @@ service CloudTasks {
       patch: "/v2beta3/{queue.name=projects/*/locations/*/queues/*}"
       body: "queue"
     };
+    option (google.api.method_signature) = "queue,update_mask";
   }
 
   // Deletes a queue.
@@ -110,6 +118,7 @@ service CloudTasks {
     option (google.api.http) = {
       delete: "/v2beta3/{name=projects/*/locations/*/queues/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Purges a queue by deleting all of its tasks.
@@ -123,6 +132,7 @@ service CloudTasks {
       post: "/v2beta3/{name=projects/*/locations/*/queues/*}:purge"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Pauses the queue.
@@ -137,6 +147,7 @@ service CloudTasks {
       post: "/v2beta3/{name=projects/*/locations/*/queues/*}:pause"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Resume a queue.
@@ -157,6 +168,7 @@ service CloudTasks {
       post: "/v2beta3/{name=projects/*/locations/*/queues/*}:resume"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Gets the access control policy for a [Queue][google.cloud.tasks.v2beta3.Queue].
@@ -173,6 +185,7 @@ service CloudTasks {
       post: "/v2beta3/{resource=projects/*/locations/*/queues/*}:getIamPolicy"
       body: "*"
     };
+    option (google.api.method_signature) = "resource";
   }
 
   // Sets the access control policy for a [Queue][google.cloud.tasks.v2beta3.Queue]. Replaces any existing
@@ -191,6 +204,7 @@ service CloudTasks {
       post: "/v2beta3/{resource=projects/*/locations/*/queues/*}:setIamPolicy"
       body: "*"
     };
+    option (google.api.method_signature) = "resource,policy";
   }
 
   // Returns permissions that a caller has on a [Queue][google.cloud.tasks.v2beta3.Queue].
@@ -205,6 +219,7 @@ service CloudTasks {
       post: "/v2beta3/{resource=projects/*/locations/*/queues/*}:testIamPermissions"
       body: "*"
     };
+    option (google.api.method_signature) = "resource,permissions";
   }
 
   // Lists the tasks in a queue.
@@ -220,6 +235,7 @@ service CloudTasks {
     option (google.api.http) = {
       get: "/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets a task.
@@ -227,6 +243,7 @@ service CloudTasks {
     option (google.api.http) = {
       get: "/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates a task and adds it to a queue.
@@ -239,6 +256,7 @@ service CloudTasks {
       post: "/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks"
       body: "*"
     };
+    option (google.api.method_signature) = "parent,task";
   }
 
   // Deletes a task.
@@ -250,6 +268,7 @@ service CloudTasks {
     option (google.api.http) = {
       delete: "/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Forces a task to run now.
@@ -281,16 +300,20 @@ service CloudTasks {
       post: "/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}:run"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 }
 
 // Request message for [ListQueues][google.cloud.tasks.v2beta3.CloudTasks.ListQueues].
 message ListQueuesRequest {
-  // Required.
-  //
-  // The location name.
+  // Required. The location name.
   // For example: `projects/PROJECT_ID/locations/LOCATION_ID`
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
 
   // `filter` can be used to specify a subset of queues. Any [Queue][google.cloud.tasks.v2beta3.Queue]
   // field can be used as a filter and several operators as supported.
@@ -344,45 +367,47 @@ message ListQueuesResponse {
 
 // Request message for [GetQueue][google.cloud.tasks.v2beta3.CloudTasks.GetQueue].
 message GetQueueRequest {
-  // Required.
-  //
-  // The resource name of the queue. For example:
+  // Required. The resource name of the queue. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
 }
 
 // Request message for [CreateQueue][google.cloud.tasks.v2beta3.CloudTasks.CreateQueue].
 message CreateQueueRequest {
-  // Required.
-  //
-  // The location name in which the queue will be created.
+  // Required. The location name in which the queue will be created.
   // For example: `projects/PROJECT_ID/locations/LOCATION_ID`
   //
   // The list of allowed locations can be obtained by calling Cloud
   // Tasks' implementation of
   // [ListLocations][google.cloud.location.Locations.ListLocations].
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
 
-  // Required.
-  //
-  // The queue to create.
+  // Required. The queue to create.
   //
   // [Queue's name][google.cloud.tasks.v2beta3.Queue.name] cannot be the same as an existing queue.
-  Queue queue = 2;
+  Queue queue = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request message for [UpdateQueue][google.cloud.tasks.v2beta3.CloudTasks.UpdateQueue].
 message UpdateQueueRequest {
-  // Required.
-  //
-  // The queue to create or update.
+  // Required. The queue to create or update.
   //
   // The queue's [name][google.cloud.tasks.v2beta3.Queue.name] must be specified.
   //
   // Output only fields cannot be modified using UpdateQueue.
   // Any value specified for an output only field will be ignored.
   // The queue's [name][google.cloud.tasks.v2beta3.Queue.name] cannot be changed.
-  Queue queue = 1;
+  Queue queue = 1 [(google.api.field_behavior) = REQUIRED];
 
   // A mask used to specify which fields of the queue are being updated.
   //
@@ -392,47 +417,62 @@ message UpdateQueueRequest {
 
 // Request message for [DeleteQueue][google.cloud.tasks.v2beta3.CloudTasks.DeleteQueue].
 message DeleteQueueRequest {
-  // Required.
-  //
-  // The queue name. For example:
+  // Required. The queue name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
 }
 
 // Request message for [PurgeQueue][google.cloud.tasks.v2beta3.CloudTasks.PurgeQueue].
 message PurgeQueueRequest {
-  // Required.
-  //
-  // The queue name. For example:
+  // Required. The queue name. For example:
   // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
 }
 
 // Request message for [PauseQueue][google.cloud.tasks.v2beta3.CloudTasks.PauseQueue].
 message PauseQueueRequest {
-  // Required.
-  //
-  // The queue name. For example:
+  // Required. The queue name. For example:
   // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
 }
 
 // Request message for [ResumeQueue][google.cloud.tasks.v2beta3.CloudTasks.ResumeQueue].
 message ResumeQueueRequest {
-  // Required.
-  //
-  // The queue name. For example:
+  // Required. The queue name. For example:
   // `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Queue"
+    }
+  ];
 }
 
 // Request message for listing tasks using [ListTasks][google.cloud.tasks.v2beta3.CloudTasks.ListTasks].
 message ListTasksRequest {
-  // Required.
-  //
-  // The queue name. For example:
+  // Required. The queue name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "cloudtasks.googleapis.com/Task"
+    }
+  ];
 
   // The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta3.Task] will be
   // returned.
@@ -487,11 +527,14 @@ message ListTasksResponse {
 
 // Request message for getting a task using [GetTask][google.cloud.tasks.v2beta3.CloudTasks.GetTask].
 message GetTaskRequest {
-  // Required.
-  //
-  // The task name. For example:
+  // Required. The task name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Task"
+    }
+  ];
 
   // The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta3.Task] will be
   // returned.
@@ -510,17 +553,18 @@ message GetTaskRequest {
 
 // Request message for [CreateTask][google.cloud.tasks.v2beta3.CloudTasks.CreateTask].
 message CreateTaskRequest {
-  // Required.
-  //
-  // The queue name. For example:
+  // Required. The queue name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
   //
   // The queue must already exist.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "cloudtasks.googleapis.com/Task"
+    }
+  ];
 
-  // Required.
-  //
-  // The task to add.
+  // Required. The task to add.
   //
   // Task names have the following format:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`.
@@ -553,7 +597,7 @@ message CreateTaskRequest {
   // task commands. The infrastructure relies on an approximately
   // uniform distribution of task ids to store and serve tasks
   // efficiently.
-  Task task = 2;
+  Task task = 2 [(google.api.field_behavior) = REQUIRED];
 
   // The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta3.Task] will be
   // returned.
@@ -573,21 +617,27 @@ message CreateTaskRequest {
 // Request message for deleting a task using
 // [DeleteTask][google.cloud.tasks.v2beta3.CloudTasks.DeleteTask].
 message DeleteTaskRequest {
-  // Required.
-  //
-  // The task name. For example:
+  // Required. The task name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Task"
+    }
+  ];
 }
 
 // Request message for forcing a task to run now using
 // [RunTask][google.cloud.tasks.v2beta3.CloudTasks.RunTask].
 message RunTaskRequest {
-  // Required.
-  //
-  // The task name. For example:
+  // Required. The task name. For example:
   // `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudtasks.googleapis.com/Task"
+    }
+  ];
 
   // The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta3.Task] will be
   // returned.
diff --git a/third_party/googleapis/google/cloud/tasks/v2beta3/cloudtasks_gapic.legacy.yaml b/third_party/googleapis/google/cloud/tasks/v2beta3/cloudtasks_gapic.legacy.yaml
new file mode 100644
index 000000000..ffcdd5e73
--- /dev/null
+++ b/third_party/googleapis/google/cloud/tasks/v2beta3/cloudtasks_gapic.legacy.yaml
@@ -0,0 +1,434 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.tasks.v2beta3
+  python:
+    package_name: google.cloud.tasks_v2beta3.gapic
+  go:
+    package_name: cloud.google.com/go/cloudtasks/apiv2beta3
+  csharp:
+    package_name: Google.Cloud.Tasks.V2Beta3
+  ruby:
+    package_name: Google::Cloud::Tasks::V2beta3
+  php:
+    package_name: Google\Cloud\Tasks\V2beta3
+  nodejs:
+    package_name: tasks.v2beta3
+# A list of API interface configurations.
+interfaces:
+- name: google.cloud.tasks.v2beta3.CloudTasks
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}
+    entity_name: project
+    language_overrides:
+    - language: csharp
+      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
+  - name_pattern: projects/{project}/locations/{location}
+    entity_name: location
+  - name_pattern: projects/{project}/locations/{location}/queues/{queue}
+    entity_name: queue
+  - name_pattern: projects/{project}/locations/{location}/queues/{queue}/tasks/{task}
+    entity_name: task
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ListQueues
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    header_request_params:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: queues
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 10000
+  - name: GetQueue
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: queue
+    timeout_millis: 10000
+  - name: CreateQueue
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - queue
+    required_fields:
+    - parent
+    - queue
+    header_request_params:
+    - parent
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 10000
+  - name: UpdateQueue
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - queue
+        - update_mask
+    required_fields:
+    - queue
+    header_request_params:
+    - queue.name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      queue.name: queue
+    timeout_millis: 10000
+  - name: DeleteQueue
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: queue
+    timeout_millis: 10000
+  - name: PurgeQueue
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: queue
+    timeout_millis: 10000
+  - name: PauseQueue
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: queue
+    timeout_millis: 10000
+  - name: ResumeQueue
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: queue
+    timeout_millis: 10000
+  - name: GetIamPolicy
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - resource
+    required_fields:
+    - resource
+    header_request_params:
+    - resource
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: queue
+    timeout_millis: 10000
+  - name: SetIamPolicy
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - resource
+        - policy
+    required_fields:
+    - resource
+    - policy
+    header_request_params:
+    - resource
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: queue
+    timeout_millis: 10000
+  - name: TestIamPermissions
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - resource
+        - permissions
+    required_fields:
+    - resource
+    - permissions
+    header_request_params:
+    - resource
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: queue
+    timeout_millis: 10000
+  - name: ListTasks
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    header_request_params:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: tasks
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: queue
+    timeout_millis: 10000
+  - name: GetTask
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: task
+    timeout_millis: 10000
+  - name: CreateTask
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - task
+    required_fields:
+    - parent
+    - task
+    header_request_params:
+    - parent
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: queue
+    timeout_millis: 10000
+  - name: DeleteTask
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: task
+    timeout_millis: 10000
+  - name: RunTask
+    resource_name_treatment: STATIC_TYPES
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    header_request_params:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: task
+    timeout_millis: 10000
+resource_name_generation:
+- message_name: Queue
+  field_entity_map:
+    name: queue
+- message_name: Task
+  field_entity_map:
+    name: task
+- message_name: ListQueuesRequest
+  field_entity_map:
+    parent: location
+- message_name: GetQueueRequest
+  field_entity_map:
+    name: queue
+- message_name: CreateQueueRequest
+  field_entity_map:
+    parent: location
+- message_name: UpdateQueueRequest
+  field_entity_map:
+    queue.name: queue
+- message_name: DeleteQueueRequest
+  field_entity_map:
+    name: queue
+- message_name: PurgeQueueRequest
+  field_entity_map:
+    name: queue
+- message_name: PauseQueueRequest
+  field_entity_map:
+    name: queue
+- message_name: ResumeQueueRequest
+  field_entity_map:
+    name: queue
+- message_name: ListTasksRequest
+  field_entity_map:
+    parent: queue
+- message_name: GetTaskRequest
+  field_entity_map:
+    name: task
+- message_name: CreateTaskRequest
+  field_entity_map:
+    parent: queue
+- message_name: DeleteTaskRequest
+  field_entity_map:
+    name: task
+- message_name: RunTaskRequest
+  field_entity_map:
+    name: task
+- message_name: google.iam.v1.GetIamPolicyRequest
+  field_entity_map:
+    resource: "*"
+- message_name: google.iam.v1.SetIamPolicyRequest
+  field_entity_map:
+    resource: "*"
+- message_name: google.iam.v1.TestIamPermissionsRequest
+  field_entity_map:
+    resource: "*"
diff --git a/third_party/googleapis/google/cloud/tasks/v2beta3/cloudtasks_gapic.yaml b/third_party/googleapis/google/cloud/tasks/v2beta3/cloudtasks_gapic.yaml
index eb88c15fe..1e91efb26 100644
--- a/third_party/googleapis/google/cloud/tasks/v2beta3/cloudtasks_gapic.yaml
+++ b/third_party/googleapis/google/cloud/tasks/v2beta3/cloudtasks_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -16,420 +16,43 @@ language_settings:
     package_name: Google\Cloud\Tasks\V2beta3
   nodejs:
     package_name: tasks.v2beta3
-# A list of API interface configurations.
 interfaces:
-  # The fully qualified name of the API interface.
 - name: google.cloud.tasks.v2beta3.CloudTasks
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections:
-  - name_pattern: projects/{project}
-    entity_name: project
-    language_overrides:
-    - language: csharp
-      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
-  - name_pattern: projects/{project}/locations/{location}
-    entity_name: location
-  - name_pattern: projects/{project}/locations/{location}/queues/{queue}
-    entity_name: queue
-  - name_pattern: projects/{project}/locations/{location}/queues/{queue}/tasks/{task}
-    entity_name: task
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
   methods:
   - name: ListQueues
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    header_request_params:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: queues
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
     timeout_millis: 10000
   - name: GetQueue
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: queue
     timeout_millis: 10000
   - name: CreateQueue
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - queue
-    required_fields:
-    - parent
-    - queue
-    header_request_params:
-    - parent
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
     timeout_millis: 10000
   - name: UpdateQueue
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - queue
-        - update_mask
-    required_fields:
-    - queue
-    header_request_params:
-    - queue.name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      queue.name: queue
     timeout_millis: 10000
   - name: DeleteQueue
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: queue
     timeout_millis: 10000
   - name: PurgeQueue
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: queue
     timeout_millis: 10000
   - name: PauseQueue
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: queue
     timeout_millis: 10000
   - name: ResumeQueue
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: queue
     timeout_millis: 10000
   - name: GetIamPolicy
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - resource
-    required_fields:
-    - resource
-    header_request_params:
-    - resource
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      resource: queue
     timeout_millis: 10000
   - name: SetIamPolicy
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - resource
-        - policy
-    required_fields:
-    - resource
-    - policy
-    header_request_params:
-    - resource
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      resource: queue
     timeout_millis: 10000
   - name: TestIamPermissions
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - resource
-        - permissions
-    required_fields:
-    - resource
-    - permissions
-    header_request_params:
-    - resource
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      resource: queue
     timeout_millis: 10000
   - name: ListTasks
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    header_request_params:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: tasks
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: queue
     timeout_millis: 10000
   - name: GetTask
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: task
     timeout_millis: 10000
   - name: CreateTask
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - task
-    required_fields:
-    - parent
-    - task
-    header_request_params:
-    - parent
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: queue
     timeout_millis: 10000
   - name: DeleteTask
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: task
     timeout_millis: 10000
   - name: RunTask
-    resource_name_treatment: STATIC_TYPES
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    header_request_params:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: task
     timeout_millis: 10000
-resource_name_generation:
-- message_name: Queue
-  field_entity_map:
-    name: queue
-- message_name: Task
-  field_entity_map:
-    name: task
-- message_name: ListQueuesRequest
-  field_entity_map:
-    parent: location
-- message_name: GetQueueRequest
-  field_entity_map:
-    name: queue
-- message_name: CreateQueueRequest
-  field_entity_map:
-    parent: location
-- message_name: UpdateQueueRequest
-  field_entity_map:
-    queue.name: queue
-- message_name: DeleteQueueRequest
-  field_entity_map:
-    name: queue
-- message_name: PurgeQueueRequest
-  field_entity_map:
-    name: queue
-- message_name: PauseQueueRequest
-  field_entity_map:
-    name: queue
-- message_name: ResumeQueueRequest
-  field_entity_map:
-    name: queue
-- message_name: ListTasksRequest
-  field_entity_map:
-    parent: queue
-- message_name: GetTaskRequest
-  field_entity_map:
-    name: task
-- message_name: CreateTaskRequest
-  field_entity_map:
-    parent: queue
-- message_name: DeleteTaskRequest
-  field_entity_map:
-    name: task
-- message_name: RunTaskRequest
-  field_entity_map:
-    name: task
-- message_name: google.iam.v1.GetIamPolicyRequest
-  field_entity_map:
-    resource: "*"
-- message_name: google.iam.v1.SetIamPolicyRequest
-  field_entity_map:
-    resource: "*"
-- message_name: google.iam.v1.TestIamPermissionsRequest
-  field_entity_map:
-    resource: "*"
diff --git a/third_party/googleapis/google/cloud/tasks/v2beta3/cloudtasks_grpc_service_config.json b/third_party/googleapis/google/cloud/tasks/v2beta3/cloudtasks_grpc_service_config.json
new file mode 100755
index 000000000..ed67771cf
--- /dev/null
+++ b/third_party/googleapis/google/cloud/tasks/v2beta3/cloudtasks_grpc_service_config.json
@@ -0,0 +1,87 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.tasks.v2beta3.CloudTasks",
+          "method": "CreateQueue"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta3.CloudTasks",
+          "method": "UpdateQueue"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta3.CloudTasks",
+          "method": "PurgeQueue"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta3.CloudTasks",
+          "method": "PauseQueue"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta3.CloudTasks",
+          "method": "ResumeQueue"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta3.CloudTasks",
+          "method": "SetIamPolicy"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta3.CloudTasks",
+          "method": "CreateTask"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta3.CloudTasks",
+          "method": "RunTask"
+        }
+      ],
+      "timeout": "10s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.tasks.v2beta3.CloudTasks",
+          "method": "ListQueues"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta3.CloudTasks",
+          "method": "GetQueue"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta3.CloudTasks",
+          "method": "DeleteQueue"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta3.CloudTasks",
+          "method": "GetIamPolicy"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta3.CloudTasks",
+          "method": "TestIamPermissions"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta3.CloudTasks",
+          "method": "ListTasks"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta3.CloudTasks",
+          "method": "GetTask"
+        },
+        {
+          "service": "google.cloud.tasks.v2beta3.CloudTasks",
+          "method": "DeleteTask"
+        }
+      ],
+      "timeout": "10s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "10s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/tasks/cloudtasks_v2beta3.yaml b/third_party/googleapis/google/cloud/tasks/v2beta3/cloudtasks_v2beta3.yaml
similarity index 100%
rename from third_party/googleapis/google/cloud/tasks/cloudtasks_v2beta3.yaml
rename to third_party/googleapis/google/cloud/tasks/v2beta3/cloudtasks_v2beta3.yaml
diff --git a/third_party/googleapis/google/cloud/tasks/v2beta3/queue.proto b/third_party/googleapis/google/cloud/tasks/v2beta3/queue.proto
index 264a19eed..777e9b8b4 100644
--- a/third_party/googleapis/google/cloud/tasks/v2beta3/queue.proto
+++ b/third_party/googleapis/google/cloud/tasks/v2beta3/queue.proto
@@ -17,11 +17,11 @@ syntax = "proto3";
 
 package google.cloud.tasks.v2beta3;
 
-import "google/api/annotations.proto";
 import "google/api/resource.proto";
 import "google/cloud/tasks/v2beta3/target.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks";
 option java_multiple_files = true;
@@ -32,6 +32,11 @@ option java_package = "com.google.cloud.tasks.v2beta3";
 // how those tasks are dispatched. Configurable properties include rate limits,
 // retry options, queue types, and others.
 message Queue {
+  option (google.api.resource) = {
+    type: "cloudtasks.googleapis.com/Queue"
+    pattern: "projects/{project}/locations/{location}/queues/{queue}"
+  };
+
   // State of the queue.
   enum State {
     // Unspecified state.
diff --git a/third_party/googleapis/google/cloud/tasks/v2beta3/target.proto b/third_party/googleapis/google/cloud/tasks/v2beta3/target.proto
index 48d7df55f..60eccf350 100644
--- a/third_party/googleapis/google/cloud/tasks/v2beta3/target.proto
+++ b/third_party/googleapis/google/cloud/tasks/v2beta3/target.proto
@@ -28,12 +28,12 @@ option java_package = "com.google.cloud.tasks.v2beta3";
 //
 // The task will be pushed to the worker as an HTTP request. If the worker
 // or the redirected worker acknowledges the task by returning a successful HTTP
-// response code ([`200` - `299`]), the task will removed from the queue. If
+// response code ([`200` - `299`]), the task will be removed from the queue. If
 // any other HTTP response code is returned or no response is received, the
 // task will be retried according to the following:
 //
-// * User-specified throttling: [retry configuration][Queue.RetryConfig],
-//   [rate limits][Queue.RateLimits], and the [queue's state][google.cloud.tasks.v2beta3.Queue.state].
+// * User-specified throttling: [retry configuration][google.cloud.tasks.v2beta3.Queue.retry_config],
+//   [rate limits][google.cloud.tasks.v2beta3.Queue.rate_limits], and the [queue's state][google.cloud.tasks.v2beta3.Queue.state].
 //
 // * System throttling: To prevent the worker from overloading, Cloud Tasks may
 //   temporarily reduce the queue's effective rate. User-specified settings
@@ -41,13 +41,13 @@ option java_package = "com.google.cloud.tasks.v2beta3";
 //
 //  System throttling happens because:
 //
-//   * Cloud Tasks backoffs on all errors. Normally the backoff specified in
-//     [rate limits][Queue.RateLimits] will be used. But if the worker returns
+//   * Cloud Tasks backs off on all errors. Normally the backoff specified in
+//     [rate limits][google.cloud.tasks.v2beta3.Queue.rate_limits] will be used. But if the worker returns
 //     `429` (Too Many Requests), `503` (Service Unavailable), or the rate of
 //     errors is high, Cloud Tasks will use a higher backoff rate. The retry
 //     specified in the `Retry-After` HTTP response header is considered.
 //
-//   * To prevent traffic spikes and to smooth sudden large traffic spikes,
+//   * To prevent traffic spikes and to smooth sudden increases in traffic,
 //     dispatches ramp up slowly when the queue is newly created or idle and
 //     if large numbers of tasks suddenly become available to dispatch (due to
 //     spikes in create task rates, the queue being unpaused, or many tasks
@@ -106,7 +106,7 @@ message HttpRequest {
 
   // The mode for generating an `Authorization` header for HTTP requests.
   //
-  // If specified, all `Authorization` headers in the [HttpTarget.headers][]
+  // If specified, all `Authorization` headers in the [HttpRequest.headers][google.cloud.tasks.v2beta3.HttpRequest.headers]
   // field will be overridden.
   oneof authorization_header {
     // If specified, an
@@ -208,7 +208,7 @@ message AppEngineHttpQueue {
 // the app's handler returns a non-2xx response code or Cloud Tasks does
 // not receive response before the [deadline][google.cloud.tasks.v2beta3.Task.dispatch_deadline]. Failed
 // tasks will be retried according to the
-// [retry configuration][Queue.RetryConfig]. `503` (Service Unavailable) is
+// [retry configuration][google.cloud.tasks.v2beta3.Queue.retry_config]. `503` (Service Unavailable) is
 // considered an App Engine system error instead of an application error and
 // will cause Cloud Tasks' traffic congestion control to temporarily throttle
 // the queue's dispatches. Unlike other types of task targets, a `429` (Too Many
@@ -279,7 +279,7 @@ message AppEngineHttpRequest {
   // In addition, Cloud Tasks sets some headers when the task is dispatched,
   // such as headers containing information about the task; see
   // [request
-  // headers](https://cloud.google.com/appengine/docs/python/taskqueue/push/creating-handlers#reading_request_headers).
+  // headers](https://cloud.google.com/tasks/docs/creating-appengine-handlers#reading_request_headers).
   // These headers are set only when the task is dispatched, so they are not
   // visible when the task is returned in a Cloud Tasks response.
   //
diff --git a/third_party/googleapis/google/cloud/tasks/v2beta3/task.proto b/third_party/googleapis/google/cloud/tasks/v2beta3/task.proto
index 10213ad85..573cc8502 100644
--- a/third_party/googleapis/google/cloud/tasks/v2beta3/task.proto
+++ b/third_party/googleapis/google/cloud/tasks/v2beta3/task.proto
@@ -17,12 +17,12 @@ syntax = "proto3";
 
 package google.cloud.tasks.v2beta3;
 
-import "google/api/annotations.proto";
 import "google/api/resource.proto";
 import "google/cloud/tasks/v2beta3/target.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
 import "google/rpc/status.proto";
+import "google/api/annotations.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks";
 option java_multiple_files = true;
@@ -31,6 +31,11 @@ option java_package = "com.google.cloud.tasks.v2beta3";
 
 // A unit of scheduled work.
 message Task {
+  option (google.api.resource) = {
+    type: "cloudtasks.googleapis.com/Task"
+    pattern: "projects/{project}/locations/{location}/queues/{queue}/tasks/{task}"
+  };
+
   // The view specifies a subset of [Task][google.cloud.tasks.v2beta3.Task] data.
   //
   // When a task is returned in a response, not all
diff --git a/third_party/googleapis/google/cloud/texttospeech/BUILD.bazel b/third_party/googleapis/google/cloud/texttospeech/BUILD.bazel
index 1e5b8c2af..a87c57fec 100644
--- a/third_party/googleapis/google/cloud/texttospeech/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/texttospeech/BUILD.bazel
@@ -1 +1 @@
-exports_files(glob(["*.yaml"]))
\ No newline at end of file
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/cloud/texttospeech/artman_texttospeech_v1.yaml b/third_party/googleapis/google/cloud/texttospeech/artman_texttospeech_v1.yaml
index b5f3d6d28..22f0044c3 100644
--- a/third_party/googleapis/google/cloud/texttospeech/artman_texttospeech_v1.yaml
+++ b/third_party/googleapis/google/cloud/texttospeech/artman_texttospeech_v1.yaml
@@ -8,6 +8,7 @@ common:
   - v1
   service_yaml: tts_v1.yaml
   gapic_yaml: v1/texttospeech_gapic.yaml
+  proto_package: google.cloud.texttospeech.v1
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/cloud/texttospeech/artman_texttospeech_v1beta1.yaml b/third_party/googleapis/google/cloud/texttospeech/artman_texttospeech_v1beta1.yaml
index 91280d64e..8aef988c7 100644
--- a/third_party/googleapis/google/cloud/texttospeech/artman_texttospeech_v1beta1.yaml
+++ b/third_party/googleapis/google/cloud/texttospeech/artman_texttospeech_v1beta1.yaml
@@ -8,6 +8,7 @@ common:
   - v1beta1
   service_yaml: tts_v1beta1.yaml
   gapic_yaml: v1beta1/texttospeech_gapic.yaml
+  proto_package: google.cloud.texttospeech.v1beta1
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/cloud/texttospeech/v1/BUILD.bazel b/third_party/googleapis/google/cloud/texttospeech/v1/BUILD.bazel
index dd89685fe..c5d7bcd8b 100644
--- a/third_party/googleapis/google/cloud/texttospeech/v1/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/texttospeech/v1/BUILD.bazel
@@ -1,9 +1,12 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
@@ -13,12 +16,17 @@ proto_library(
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
     ],
 )
 
 proto_library_with_info(
     name = "texttospeech_proto_with_info",
-    deps = [":texttospeech_proto"],
+    deps = [
+        ":texttospeech_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -26,17 +34,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
     name = "texttospeech_java_proto",
     deps = [":texttospeech_proto"],
@@ -45,39 +49,40 @@ java_proto_library(
 java_grpc_library(
     name = "texttospeech_java_grpc",
     srcs = [":texttospeech_proto"],
-    deps = [":texttospeech_java_proto"] + _JAVA_GRPC_DEPS,
+    deps = [":texttospeech_java_proto"],
 )
 
 java_gapic_library(
     name = "texttospeech_java_gapic",
     src = ":texttospeech_proto_with_info",
     gapic_yaml = "texttospeech_gapic.yaml",
-    service_yaml = "//google/cloud/texttospeech:tts_v1.yaml",
-    test_deps = [":texttospeech_java_grpc"],
-    deps = [":texttospeech_java_proto"] + _JAVA_GRPC_DEPS,
+    package = "google.cloud.texttospeech.v1",
+    service_yaml = "texttospeech_v1.yaml",
+    test_deps = [
+        ":texttospeech_java_grpc",
+    ],
+    deps = [
+        ":texttospeech_java_proto",
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
+java_gapic_test(
+    name = "texttospeech_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.texttospeech.v1.TextToSpeechClientTest",
+    ],
     runtime_deps = [":texttospeech_java_gapic_test"],
-) for test_name in [
-    "com.google.cloud.texttospeech.v1.TextToSpeechClientTest",
-]]
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-texttospeech-v1-java",
-    client_deps = [":texttospeech_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":texttospeech_java_gapic_test"],
-    grpc_deps = [":texttospeech_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":texttospeech_java_gapic",
+        ":texttospeech_java_grpc",
         ":texttospeech_java_proto",
         ":texttospeech_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -85,10 +90,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -96,16 +101,20 @@ go_proto_library(
     compilers = ["@io_bazel_rules_go//proto:go_grpc"],
     importpath = "google.golang.org/genproto/googleapis/cloud/texttospeech/v1",
     protos = [":texttospeech_proto"],
-    deps = ["//google/api:annotations_go_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
 )
 
 go_gapic_library(
     name = "texttospeech_go_gapic",
-    src = ":texttospeech_proto_with_info",
-    gapic_yaml = "texttospeech_gapic.yaml",
-    importpath = "cloud.google.com/go/texttospeech/apiv1",
-    service_yaml = "//google/cloud/texttospeech:tts_v1.yaml",
-    deps = [":texttospeech_go_proto"],
+    srcs = [":texttospeech_proto_with_info"],
+    grpc_service_config = "texttospeech_grpc_service_config.json",
+    importpath = "cloud.google.com/go/texttospeech/apiv1;texttospeech",
+    service_yaml = "texttospeech_v1.yaml",
+    deps = [
+        ":texttospeech_go_proto",
+    ],
 )
 
 go_test(
@@ -115,13 +124,231 @@ go_test(
     importpath = "cloud.google.com/go/texttospeech/apiv1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-texttospeech-v1-go",
     deps = [
         ":texttospeech_go_gapic",
-        ":texttospeech_go_gapic_srcjar-smoke-test.srcjar",
         ":texttospeech_go_gapic_srcjar-test.srcjar",
         ":texttospeech_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "texttospeech_moved_proto",
+    srcs = [":texttospeech_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+    ],
+)
+
+py_proto_library(
+    name = "texttospeech_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":texttospeech_moved_proto"],
+)
+
+py_grpc_library(
+    name = "texttospeech_py_grpc",
+    srcs = [":texttospeech_moved_proto"],
+    deps = [":texttospeech_py_proto"],
+)
+
+py_gapic_library(
+    name = "texttospeech_py_gapic",
+    src = ":texttospeech_proto_with_info",
+    gapic_yaml = "texttospeech_gapic.yaml",
+    package = "google.cloud.texttospeech.v1",
+    service_yaml = "texttospeech_v1.yaml",
+    deps = [
+        ":texttospeech_py_grpc",
+        ":texttospeech_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "texttospeech-v1-py",
+    deps = [
+        ":texttospeech_py_gapic",
+        ":texttospeech_py_grpc",
+        ":texttospeech_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "texttospeech_php_proto",
+    deps = [":texttospeech_proto"],
+)
+
+php_grpc_library(
+    name = "texttospeech_php_grpc",
+    srcs = [":texttospeech_proto"],
+    deps = [":texttospeech_php_proto"],
+)
+
+php_gapic_library(
+    name = "texttospeech_php_gapic",
+    src = ":texttospeech_proto_with_info",
+    gapic_yaml = "texttospeech_gapic.yaml",
+    package = "google.cloud.texttospeech.v1",
+    service_yaml = "texttospeech_v1.yaml",
+    deps = [
+        ":texttospeech_php_grpc",
+        ":texttospeech_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-texttospeech-v1-php",
+    deps = [
+        ":texttospeech_php_gapic",
+        ":texttospeech_php_grpc",
+        ":texttospeech_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "texttospeech_nodejs_gapic",
+    src = ":texttospeech_proto_with_info",
+    gapic_yaml = "texttospeech_gapic.yaml",
+    package = "google.cloud.texttospeech.v1",
+    service_yaml = "texttospeech_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "texttospeech-v1-nodejs",
+    deps = [
+        ":texttospeech_nodejs_gapic",
+        ":texttospeech_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "texttospeech_ruby_proto",
+    deps = [":texttospeech_proto"],
+)
+
+ruby_grpc_library(
+    name = "texttospeech_ruby_grpc",
+    srcs = [":texttospeech_proto"],
+    deps = [":texttospeech_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "texttospeech_ruby_gapic",
+    src = ":texttospeech_proto_with_info",
+    gapic_yaml = "texttospeech_gapic.yaml",
+    package = "google.cloud.texttospeech.v1",
+    service_yaml = "texttospeech_v1.yaml",
+    deps = [
+        ":texttospeech_ruby_grpc",
+        ":texttospeech_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-texttospeech-v1-ruby",
+    deps = [
+        ":texttospeech_ruby_gapic",
+        ":texttospeech_ruby_grpc",
+        ":texttospeech_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "texttospeech_csharp_proto",
+    deps = [":texttospeech_proto"],
+)
+
+csharp_grpc_library(
+    name = "texttospeech_csharp_grpc",
+    srcs = [":texttospeech_proto"],
+    deps = [":texttospeech_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "texttospeech_csharp_gapic",
+    src = ":texttospeech_proto_with_info",
+    gapic_yaml = "texttospeech_gapic.yaml",
+    package = "google.cloud.texttospeech.v1",
+    service_yaml = "texttospeech_v1.yaml",
+    deps = [
+        ":texttospeech_csharp_grpc",
+        ":texttospeech_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-texttospeech-v1-csharp",
+    deps = [
+        ":texttospeech_csharp_gapic",
+        ":texttospeech_csharp_grpc",
+        ":texttospeech_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/texttospeech/v1/cloud_tts.proto b/third_party/googleapis/google/cloud/texttospeech/v1/cloud_tts.proto
index dd9fa6ce2..6134ef640 100644
--- a/third_party/googleapis/google/cloud/texttospeech/v1/cloud_tts.proto
+++ b/third_party/googleapis/google/cloud/texttospeech/v1/cloud_tts.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,6 +18,8 @@ syntax = "proto3";
 package google.cloud.texttospeech.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 
 option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.TextToSpeech.V1";
@@ -26,30 +28,35 @@ option java_multiple_files = true;
 option java_outer_classname = "TextToSpeechProto";
 option java_package = "com.google.cloud.texttospeech.v1";
 option php_namespace = "Google\\Cloud\\TextToSpeech\\V1";
+option ruby_package = "Google::Cloud::TextToSpeech::V1";
 
 // Service that implements Google Cloud Text-to-Speech API.
 service TextToSpeech {
+  option (google.api.default_host) = "texttospeech.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Returns a list of Voice supported for synthesis.
   rpc ListVoices(ListVoicesRequest) returns (ListVoicesResponse) {
     option (google.api.http) = {
       get: "/v1/voices"
     };
+    option (google.api.method_signature) = "language_code";
   }
 
   // Synthesizes speech synchronously: receive results after all text input
   // has been processed.
-  rpc SynthesizeSpeech(SynthesizeSpeechRequest)
-      returns (SynthesizeSpeechResponse) {
+  rpc SynthesizeSpeech(SynthesizeSpeechRequest) returns (SynthesizeSpeechResponse) {
     option (google.api.http) = {
       post: "/v1/text:synthesize"
       body: "*"
     };
+    option (google.api.method_signature) = "input,voice,audio_config";
   }
 }
 
 // The top-level message sent by the client for the `ListVoices` method.
 message ListVoicesRequest {
-  // Optional (but recommended)
+  // Optional. Recommended.
   // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. If
   // specified, the ListVoices call will only return voices that can be used to
   // synthesize this language_code. E.g. when specifying "en-NZ", you will get
@@ -57,7 +64,47 @@ message ListVoicesRequest {
   // "no-*" (Norwegian) and "nb-*" (Norwegian Bokmal) voices; specifying "zh"
   // will also get supported "cmn-*" voices; specifying "zh-hk" will also get
   // supported "yue-*" voices.
-  string language_code = 1;
+  string language_code = 1 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Gender of the voice as described in
+// [SSML voice element](https://www.w3.org/TR/speech-synthesis11/#edef_voice).
+enum SsmlVoiceGender {
+  // An unspecified gender.
+  // In VoiceSelectionParams, this means that the client doesn't care which
+  // gender the selected voice will have. In the Voice field of
+  // ListVoicesResponse, this may mean that the voice doesn't fit any of the
+  // other categories in this enum, or that the gender of the voice isn't known.
+  SSML_VOICE_GENDER_UNSPECIFIED = 0;
+
+  // A male voice.
+  MALE = 1;
+
+  // A female voice.
+  FEMALE = 2;
+
+  // A gender-neutral voice.
+  NEUTRAL = 3;
+}
+
+// Configuration to set up audio encoder. The encoding determines the output
+// audio format that we'd like.
+enum AudioEncoding {
+  // Not specified. Will return result [google.rpc.Code.INVALID_ARGUMENT][].
+  AUDIO_ENCODING_UNSPECIFIED = 0;
+
+  // Uncompressed 16-bit signed little-endian samples (Linear PCM).
+  // Audio content returned as LINEAR16 also contains a WAV header.
+  LINEAR16 = 1;
+
+  // MP3 audio at 32kbps.
+  MP3 = 2;
+
+  // Opus encoded audio wrapped in an ogg container. The result will be a
+  // file which can be played natively on Android, and in browsers (at least
+  // Chrome and Firefox). The quality of the encoding is considerably higher
+  // than MP3 while using approximately the same bitrate.
+  OGG_OPUS = 3;
 }
 
 // The message returned to the client by the `ListVoices` method.
@@ -86,13 +133,13 @@ message Voice {
 // The top-level message sent by the client for the `SynthesizeSpeech` method.
 message SynthesizeSpeechRequest {
   // Required. The Synthesizer requires either plain text or SSML as input.
-  SynthesisInput input = 1;
+  SynthesisInput input = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Required. The desired voice of the synthesized audio.
-  VoiceSelectionParams voice = 2;
+  VoiceSelectionParams voice = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Required. The configuration of the synthesized audio.
-  AudioConfig audio_config = 3;
+  AudioConfig audio_config = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Contains text input to be synthesized. Either `text` or `ssml` must be
@@ -115,9 +162,9 @@ message SynthesisInput {
 
 // Description of which voice to use for a synthesis request.
 message VoiceSelectionParams {
-  // The language (and optionally also the region) of the voice expressed as a
+  // Required. The language (and potentially also the region) of the voice expressed as a
   // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag, e.g.
-  // "en-US". Required. This should not include a script tag (e.g. use
+  // "en-US". This should not include a script tag (e.g. use
   // "cmn-cn" rather than "cmn-Hant-cn"), because the script will be inferred
   // from the input provided in the SynthesisInput.  The TTS service
   // will use this parameter to help choose an appropriate voice.  Note that
@@ -126,13 +173,13 @@ message VoiceSelectionParams {
   // (e.g. using en-US rather than en-CA if there isn't a Canadian voice
   // available), or even a different language, e.g. using "nb" (Norwegian
   // Bokmal) instead of "no" (Norwegian)".
-  string language_code = 1;
+  string language_code = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // The name of the voice. Optional; if not set, the service will choose a
+  // The name of the voice. If not set, the service will choose a
   // voice based on the other parameters such as language_code and gender.
   string name = 2;
 
-  // The preferred gender of the voice. Optional; if not set, the service will
+  // The preferred gender of the voice. If not set, the service will
   // choose a voice based on the other parameters such as language_code and
   // name. Note that this is only a preference, not requirement; if a
   // voice of the appropriate gender is not available, the synthesizer should
@@ -142,94 +189,66 @@ message VoiceSelectionParams {
 
 // Description of audio data to be synthesized.
 message AudioConfig {
-  // Required. The format of the requested audio byte stream.
-  AudioEncoding audio_encoding = 1;
-
-  // Optional speaking rate/speed, in the range [0.25, 4.0]. 1.0 is the normal
-  // native speed supported by the specific voice. 2.0 is twice as fast, and
-  // 0.5 is half as fast. If unset(0.0), defaults to the native 1.0 speed. Any
-  // other values < 0.25 or > 4.0 will return an error.
-  double speaking_rate = 2;
-
-  // Optional speaking pitch, in the range [-20.0, 20.0]. 20 means increase 20
-  // semitones from the original pitch. -20 means decrease 20 semitones from the
-  // original pitch.
-  double pitch = 3;
-
-  // Optional volume gain (in dB) of the normal native volume supported by the
-  // specific voice, in the range [-96.0, 16.0]. If unset, or set to a value of
-  // 0.0 (dB), will play at normal native signal amplitude. A value of -6.0 (dB)
-  // will play at approximately half the amplitude of the normal native signal
-  // amplitude. A value of +6.0 (dB) will play at approximately twice the
-  // amplitude of the normal native signal amplitude. Strongly recommend not to
-  // exceed +10 (dB) as there's usually no effective increase in loudness for
-  // any value greater than that.
-  double volume_gain_db = 4;
-
-  // The synthesis sample rate (in hertz) for this audio. Optional.  If this is
-  // different from the voice's natural sample rate, then the synthesizer will
-  // honor this request by converting to the desired sample rate (which might
-  // result in worse audio quality), unless the specified sample rate is not
-  // supported for the encoding chosen, in which case it will fail the request
-  // and return [google.rpc.Code.INVALID_ARGUMENT][].
-  int32 sample_rate_hertz = 5;
-
-  // An identifier which selects 'audio effects' profiles that are applied on
-  // (post synthesized) text to speech.
-  // Effects are applied on top of each other in the order they are given.
-  // See
-  //
-  // [audio-profiles](https:
-  // //cloud.google.com/text-to-speech/docs/audio-profiles)
-  // for current supported profile ids.
-  repeated string effects_profile_id = 6;
+  // Required. The format of the audio byte stream.
+  AudioEncoding audio_encoding = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Input only. Speaking rate/speed, in the range [0.25, 4.0]. 1.0 is
+  // the normal native speed supported by the specific voice. 2.0 is twice as
+  // fast, and 0.5 is half as fast. If unset(0.0), defaults to the native 1.0
+  // speed. Any other values < 0.25 or > 4.0 will return an error.
+  double speaking_rate = 2 [
+    (google.api.field_behavior) = INPUT_ONLY,
+    (google.api.field_behavior) = OPTIONAL
+  ];
+
+  // Optional. Input only. Speaking pitch, in the range [-20.0, 20.0]. 20 means
+  // increase 20 semitones from the original pitch. -20 means decrease 20
+  // semitones from the original pitch.
+  double pitch = 3 [
+    (google.api.field_behavior) = INPUT_ONLY,
+    (google.api.field_behavior) = OPTIONAL
+  ];
+
+  // Optional. Input only. Volume gain (in dB) of the normal native volume
+  // supported by the specific voice, in the range [-96.0, 16.0]. If unset, or
+  // set to a value of 0.0 (dB), will play at normal native signal amplitude. A
+  // value of -6.0 (dB) will play at approximately half the amplitude of the
+  // normal native signal amplitude. A value of +6.0 (dB) will play at
+  // approximately twice the amplitude of the normal native signal amplitude.
+  // Strongly recommend not to exceed +10 (dB) as there's usually no effective
+  // increase in loudness for any value greater than that.
+  double volume_gain_db = 4 [
+    (google.api.field_behavior) = INPUT_ONLY,
+    (google.api.field_behavior) = OPTIONAL
+  ];
+
+  // Optional. The synthesis sample rate (in hertz) for this audio. When this is
+  // specified in SynthesizeSpeechRequest, if this is different from the voice's
+  // natural sample rate, then the synthesizer will honor this request by
+  // converting to the desired sample rate (which might result in worse audio
+  // quality), unless the specified sample rate is not supported for the
+  // encoding chosen, in which case it will fail the request and return
+  // [google.rpc.Code.INVALID_ARGUMENT][].
+  int32 sample_rate_hertz = 5 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Input only. An identifier which selects 'audio effects' profiles
+  // that are applied on (post synthesized) text to speech. Effects are applied
+  // on top of each other in the order they are given. See
+  // [audio
+  // profiles](https://cloud.google.com/text-to-speech/docs/audio-profiles) for
+  // current supported profile ids.
+  repeated string effects_profile_id = 6 [
+    (google.api.field_behavior) = INPUT_ONLY,
+    (google.api.field_behavior) = OPTIONAL
+  ];
 }
 
 // The message returned to the client by the `SynthesizeSpeech` method.
 message SynthesizeSpeechResponse {
   // The audio data bytes encoded as specified in the request, including the
-  // header (For LINEAR16 audio, we include the WAV header). Note: as
+  // header for encodings that are wrapped in containers (e.g. MP3, OGG_OPUS).
+  // For LINEAR16 audio, we include the WAV header. Note: as
   // with all bytes fields, protobuffers use a pure binary representation,
   // whereas JSON representations use base64.
   bytes audio_content = 1;
 }
-
-// Gender of the voice as described in
-// [SSML voice element](https://www.w3.org/TR/speech-synthesis11/#edef_voice).
-enum SsmlVoiceGender {
-  // An unspecified gender.
-  // In VoiceSelectionParams, this means that the client doesn't care which
-  // gender the selected voice will have. In the Voice field of
-  // ListVoicesResponse, this may mean that the voice doesn't fit any of the
-  // other categories in this enum, or that the gender of the voice isn't known.
-  SSML_VOICE_GENDER_UNSPECIFIED = 0;
-
-  // A male voice.
-  MALE = 1;
-
-  // A female voice.
-  FEMALE = 2;
-
-  // A gender-neutral voice.
-  NEUTRAL = 3;
-}
-
-// Configuration to set up audio encoder. The encoding determines the output
-// audio format that we'd like.
-enum AudioEncoding {
-  // Not specified. Will return result [google.rpc.Code.INVALID_ARGUMENT][].
-  AUDIO_ENCODING_UNSPECIFIED = 0;
-
-  // Uncompressed 16-bit signed little-endian samples (Linear PCM).
-  // Audio content returned as LINEAR16 also contains a WAV header.
-  LINEAR16 = 1;
-
-  // MP3 audio.
-  MP3 = 2;
-
-  // Opus encoded audio wrapped in an ogg container. The result will be a
-  // file which can be played natively on Android, and in browsers (at least
-  // Chrome and Firefox). The quality of the encoding is considerably higher
-  // than MP3 while using approximately the same bitrate.
-  OGG_OPUS = 3;
-}
diff --git a/third_party/googleapis/google/cloud/texttospeech/v1/texttospeech_gapic.legacy.yaml b/third_party/googleapis/google/cloud/texttospeech/v1/texttospeech_gapic.legacy.yaml
new file mode 100644
index 000000000..5f35fcdd4
--- /dev/null
+++ b/third_party/googleapis/google/cloud/texttospeech/v1/texttospeech_gapic.legacy.yaml
@@ -0,0 +1,135 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.texttospeech.v1
+  python:
+    package_name: google.cloud.texttospeech_v1.gapic
+  go:
+    package_name: cloud.google.com/go/texttospeech/apiv1
+  csharp:
+    package_name: Google.Cloud.TextToSpeech.V1
+  ruby:
+    package_name: Google::Cloud::TextToSpeech::V1
+  php:
+    package_name: Google\Cloud\TextToSpeech\V1
+  nodejs:
+    package_name: text-to-speech.v1
+    domain_layer_location: google-cloud
+# A list of API interface configurations.
+interfaces:
+  # The fully qualified name of the API interface.
+- name: google.cloud.texttospeech.v1.TextToSpeech
+  smoke_test:
+    method: SynthesizeSpeech
+    init_fields:
+    - input.text="test"
+    - voice.language_code="en-US"
+    - audio_config.audio_encoding=MP3
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections: []
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ListVoices
+    flattening:
+      groups:
+      - parameters:
+        - language_code
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 30000
+  - name: SynthesizeSpeech
+    flattening:
+      groups:
+      - parameters:
+        - input
+        - voice
+        - audio_config
+    required_fields:
+    - input
+    - voice
+    - audio_config
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/texttospeech/v1/texttospeech_gapic.yaml b/third_party/googleapis/google/cloud/texttospeech/v1/texttospeech_gapic.yaml
index 5f35fcdd4..e760265f8 100644
--- a/third_party/googleapis/google/cloud/texttospeech/v1/texttospeech_gapic.yaml
+++ b/third_party/googleapis/google/cloud/texttospeech/v1/texttospeech_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -17,119 +17,8 @@ language_settings:
   nodejs:
     package_name: text-to-speech.v1
     domain_layer_location: google-cloud
-# A list of API interface configurations.
 interfaces:
-  # The fully qualified name of the API interface.
 - name: google.cloud.texttospeech.v1.TextToSpeech
-  smoke_test:
-    method: SynthesizeSpeech
-    init_fields:
-    - input.text="test"
-    - voice.language_code="en-US"
-    - audio_config.audio_encoding=MP3
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections: []
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
   methods:
-  - name: ListVoices
-    flattening:
-      groups:
-      - parameters:
-        - language_code
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 30000
   - name: SynthesizeSpeech
-    flattening:
-      groups:
-      - parameters:
-        - input
-        - voice
-        - audio_config
-    required_fields:
-    - input
-    - voice
-    - audio_config
     retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/texttospeech/v1/texttospeech_grpc_service_config.json b/third_party/googleapis/google/cloud/texttospeech/v1/texttospeech_grpc_service_config.json
new file mode 100755
index 000000000..aedaab2d1
--- /dev/null
+++ b/third_party/googleapis/google/cloud/texttospeech/v1/texttospeech_grpc_service_config.json
@@ -0,0 +1,26 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.texttospeech.v1.TextToSpeech",
+          "method": "ListVoices"
+        },
+        {
+          "service": "google.cloud.texttospeech.v1.TextToSpeech",
+          "method": "SynthesizeSpeech"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/texttospeech/v1/texttospeech_v1.yaml b/third_party/googleapis/google/cloud/texttospeech/v1/texttospeech_v1.yaml
new file mode 100644
index 000000000..99f5f17d3
--- /dev/null
+++ b/third_party/googleapis/google/cloud/texttospeech/v1/texttospeech_v1.yaml
@@ -0,0 +1,27 @@
+type: google.api.Service
+config_version: 3
+name: texttospeech.googleapis.com
+title: Cloud Text-to-Speech API
+
+apis:
+- name: google.cloud.texttospeech.v1.TextToSpeech
+
+documentation:
+  summary: |-
+    Synthesizes natural-sounding speech by applying powerful neural network
+    models.
+  overview: |-
+    # Introduction
+
+    Google Cloud Text-to-Speech API provides speech synthesis as a service.
+
+authentication:
+  rules:
+  - selector: google.cloud.texttospeech.v1.TextToSpeech.ListVoices
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: google.cloud.texttospeech.v1.TextToSpeech.SynthesizeSpeech
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/texttospeech/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/texttospeech/v1beta1/BUILD.bazel
index 5a9557a2e..d3408680e 100644
--- a/third_party/googleapis/google/cloud/texttospeech/v1beta1/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/texttospeech/v1beta1/BUILD.bazel
@@ -1,9 +1,12 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
@@ -13,12 +16,17 @@ proto_library(
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
     ],
 )
 
 proto_library_with_info(
     name = "texttospeech_proto_with_info",
-    deps = [":texttospeech_proto"],
+    deps = [
+        ":texttospeech_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -26,17 +34,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
     name = "texttospeech_java_proto",
     deps = [":texttospeech_proto"],
@@ -45,39 +49,40 @@ java_proto_library(
 java_grpc_library(
     name = "texttospeech_java_grpc",
     srcs = [":texttospeech_proto"],
-    deps = [":texttospeech_java_proto"] + _JAVA_GRPC_DEPS,
+    deps = [":texttospeech_java_proto"],
 )
 
 java_gapic_library(
     name = "texttospeech_java_gapic",
     src = ":texttospeech_proto_with_info",
     gapic_yaml = "texttospeech_gapic.yaml",
-    service_yaml = "//google/cloud/texttospeech:tts_v1beta1.yaml",
-    test_deps = [":texttospeech_java_grpc"],
-    deps = [":texttospeech_java_proto"] + _JAVA_GRPC_DEPS,
+    package = "google.cloud.texttospeech.v1beta1",
+    service_yaml = "texttospeech_v1beta1.yaml",
+    test_deps = [
+        ":texttospeech_java_grpc",
+    ],
+    deps = [
+        ":texttospeech_java_proto",
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
+java_gapic_test(
+    name = "texttospeech_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.texttospeech.v1beta1.TextToSpeechClientTest",
+    ],
     runtime_deps = [":texttospeech_java_gapic_test"],
-) for test_name in [
-    "com.google.cloud.texttospeech.v1beta1.TextToSpeechClientTest",
-]]
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-texttospeech-v1beta1-java",
-    client_deps = [":texttospeech_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":texttospeech_java_gapic_test"],
-    grpc_deps = [":texttospeech_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":texttospeech_java_gapic",
+        ":texttospeech_java_grpc",
         ":texttospeech_java_proto",
         ":texttospeech_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -85,10 +90,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -96,16 +101,20 @@ go_proto_library(
     compilers = ["@io_bazel_rules_go//proto:go_grpc"],
     importpath = "google.golang.org/genproto/googleapis/cloud/texttospeech/v1beta1",
     protos = [":texttospeech_proto"],
-    deps = ["//google/api:annotations_go_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
 )
 
 go_gapic_library(
     name = "texttospeech_go_gapic",
-    src = ":texttospeech_proto_with_info",
-    gapic_yaml = "texttospeech_gapic.yaml",
-    importpath = "cloud.google.com/go/texttospeech/apiv1beta1",
-    service_yaml = "//google/cloud/texttospeech:tts_v1beta1.yaml",
-    deps = [":texttospeech_go_proto"],
+    srcs = [":texttospeech_proto_with_info"],
+    grpc_service_config = "texttospeech_grpc_service_config.json",
+    importpath = "cloud.google.com/go/texttospeech/apiv1beta1;texttospeech",
+    service_yaml = "texttospeech_v1beta1.yaml",
+    deps = [
+        ":texttospeech_go_proto",
+    ],
 )
 
 go_test(
@@ -115,13 +124,231 @@ go_test(
     importpath = "cloud.google.com/go/texttospeech/apiv1beta1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-texttospeech-v1beta1-go",
     deps = [
         ":texttospeech_go_gapic",
-        ":texttospeech_go_gapic_srcjar-smoke-test.srcjar",
         ":texttospeech_go_gapic_srcjar-test.srcjar",
         ":texttospeech_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "texttospeech_moved_proto",
+    srcs = [":texttospeech_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+    ],
+)
+
+py_proto_library(
+    name = "texttospeech_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":texttospeech_moved_proto"],
+)
+
+py_grpc_library(
+    name = "texttospeech_py_grpc",
+    srcs = [":texttospeech_moved_proto"],
+    deps = [":texttospeech_py_proto"],
+)
+
+py_gapic_library(
+    name = "texttospeech_py_gapic",
+    src = ":texttospeech_proto_with_info",
+    gapic_yaml = "texttospeech_gapic.yaml",
+    package = "google.cloud.texttospeech.v1beta1",
+    service_yaml = "texttospeech_v1beta1.yaml",
+    deps = [
+        ":texttospeech_py_grpc",
+        ":texttospeech_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "texttospeech-v1beta1-py",
+    deps = [
+        ":texttospeech_py_gapic",
+        ":texttospeech_py_grpc",
+        ":texttospeech_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "texttospeech_php_proto",
+    deps = [":texttospeech_proto"],
+)
+
+php_grpc_library(
+    name = "texttospeech_php_grpc",
+    srcs = [":texttospeech_proto"],
+    deps = [":texttospeech_php_proto"],
+)
+
+php_gapic_library(
+    name = "texttospeech_php_gapic",
+    src = ":texttospeech_proto_with_info",
+    gapic_yaml = "texttospeech_gapic.yaml",
+    package = "google.cloud.texttospeech.v1beta1",
+    service_yaml = "texttospeech_v1beta1.yaml",
+    deps = [
+        ":texttospeech_php_grpc",
+        ":texttospeech_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-texttospeech-v1beta1-php",
+    deps = [
+        ":texttospeech_php_gapic",
+        ":texttospeech_php_grpc",
+        ":texttospeech_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "texttospeech_nodejs_gapic",
+    src = ":texttospeech_proto_with_info",
+    gapic_yaml = "texttospeech_gapic.yaml",
+    package = "google.cloud.texttospeech.v1beta1",
+    service_yaml = "texttospeech_v1beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "texttospeech-v1beta1-nodejs",
+    deps = [
+        ":texttospeech_nodejs_gapic",
+        ":texttospeech_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "texttospeech_ruby_proto",
+    deps = [":texttospeech_proto"],
+)
+
+ruby_grpc_library(
+    name = "texttospeech_ruby_grpc",
+    srcs = [":texttospeech_proto"],
+    deps = [":texttospeech_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "texttospeech_ruby_gapic",
+    src = ":texttospeech_proto_with_info",
+    gapic_yaml = "texttospeech_gapic.yaml",
+    package = "google.cloud.texttospeech.v1beta1",
+    service_yaml = "texttospeech_v1beta1.yaml",
+    deps = [
+        ":texttospeech_ruby_grpc",
+        ":texttospeech_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-texttospeech-v1beta1-ruby",
+    deps = [
+        ":texttospeech_ruby_gapic",
+        ":texttospeech_ruby_grpc",
+        ":texttospeech_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "texttospeech_csharp_proto",
+    deps = [":texttospeech_proto"],
+)
+
+csharp_grpc_library(
+    name = "texttospeech_csharp_grpc",
+    srcs = [":texttospeech_proto"],
+    deps = [":texttospeech_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "texttospeech_csharp_gapic",
+    src = ":texttospeech_proto_with_info",
+    gapic_yaml = "texttospeech_gapic.yaml",
+    package = "google.cloud.texttospeech.v1beta1",
+    service_yaml = "texttospeech_v1beta1.yaml",
+    deps = [
+        ":texttospeech_csharp_grpc",
+        ":texttospeech_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-texttospeech-v1beta1-csharp",
+    deps = [
+        ":texttospeech_csharp_gapic",
+        ":texttospeech_csharp_grpc",
+        ":texttospeech_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/texttospeech/v1beta1/cloud_tts.proto b/third_party/googleapis/google/cloud/texttospeech/v1beta1/cloud_tts.proto
index 791499c4d..f8189b3fa 100644
--- a/third_party/googleapis/google/cloud/texttospeech/v1beta1/cloud_tts.proto
+++ b/third_party/googleapis/google/cloud/texttospeech/v1beta1/cloud_tts.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,43 +11,52 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.texttospeech.v1beta1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 
 option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.TextToSpeech.V1beta1";
 option go_package = "google.golang.org/genproto/googleapis/cloud/texttospeech/v1beta1;texttospeech";
 option java_multiple_files = true;
 option java_outer_classname = "TextToSpeechProto";
 option java_package = "com.google.cloud.texttospeech.v1beta1";
+option php_namespace = "Google\\Cloud\\TextToSpeech\\V1beta1";
+option ruby_package = "Google::Cloud::TextToSpeech::V1beta1";
 
 // Service that implements Google Cloud Text-to-Speech API.
 service TextToSpeech {
-  // Returns a list of [Voice][google.cloud.texttospeech.v1beta1.Voice]
-  // supported for synthesis.
+  option (google.api.default_host) = "texttospeech.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // Returns a list of Voice supported for synthesis.
   rpc ListVoices(ListVoicesRequest) returns (ListVoicesResponse) {
     option (google.api.http) = {
       get: "/v1beta1/voices"
     };
+    option (google.api.method_signature) = "language_code";
   }
 
   // Synthesizes speech synchronously: receive results after all text input
   // has been processed.
-  rpc SynthesizeSpeech(SynthesizeSpeechRequest)
-      returns (SynthesizeSpeechResponse) {
+  rpc SynthesizeSpeech(SynthesizeSpeechRequest) returns (SynthesizeSpeechResponse) {
     option (google.api.http) = {
       post: "/v1beta1/text:synthesize"
       body: "*"
     };
+    option (google.api.method_signature) = "input,voice,audio_config";
   }
 }
 
 // The top-level message sent by the client for the `ListVoices` method.
 message ListVoicesRequest {
-  // Optional (but recommended)
+  // Optional. Recommended.
   // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. If
   // specified, the ListVoices call will only return voices that can be used to
   // synthesize this language_code. E.g. when specifying "en-NZ", you will get
@@ -55,7 +64,47 @@ message ListVoicesRequest {
   // "no-*" (Norwegian) and "nb-*" (Norwegian Bokmal) voices; specifying "zh"
   // will also get supported "cmn-*" voices; specifying "zh-hk" will also get
   // supported "yue-*" voices.
-  string language_code = 1;
+  string language_code = 1 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Gender of the voice as described in
+// [SSML voice element](https://www.w3.org/TR/speech-synthesis11/#edef_voice).
+enum SsmlVoiceGender {
+  // An unspecified gender.
+  // In VoiceSelectionParams, this means that the client doesn't care which
+  // gender the selected voice will have. In the Voice field of
+  // ListVoicesResponse, this may mean that the voice doesn't fit any of the
+  // other categories in this enum, or that the gender of the voice isn't known.
+  SSML_VOICE_GENDER_UNSPECIFIED = 0;
+
+  // A male voice.
+  MALE = 1;
+
+  // A female voice.
+  FEMALE = 2;
+
+  // A gender-neutral voice.
+  NEUTRAL = 3;
+}
+
+// Configuration to set up audio encoder. The encoding determines the output
+// audio format that we'd like.
+enum AudioEncoding {
+  // Not specified. Will return result [google.rpc.Code.INVALID_ARGUMENT][].
+  AUDIO_ENCODING_UNSPECIFIED = 0;
+
+  // Uncompressed 16-bit signed little-endian samples (Linear PCM).
+  // Audio content returned as LINEAR16 also contains a WAV header.
+  LINEAR16 = 1;
+
+  // MP3 audio at 32kbps.
+  MP3 = 2;
+
+  // Opus encoded audio wrapped in an ogg container. The result will be a
+  // file which can be played natively on Android, and in browsers (at least
+  // Chrome and Firefox). The quality of the encoding is considerably higher
+  // than MP3 while using approximately the same bitrate.
+  OGG_OPUS = 3;
 }
 
 // The message returned to the client by the `ListVoices` method.
@@ -84,13 +133,13 @@ message Voice {
 // The top-level message sent by the client for the `SynthesizeSpeech` method.
 message SynthesizeSpeechRequest {
   // Required. The Synthesizer requires either plain text or SSML as input.
-  SynthesisInput input = 1;
+  SynthesisInput input = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Required. The desired voice of the synthesized audio.
-  VoiceSelectionParams voice = 2;
+  VoiceSelectionParams voice = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Required. The configuration of the synthesized audio.
-  AudioConfig audio_config = 3;
+  AudioConfig audio_config = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Contains text input to be synthesized. Either `text` or `ssml` must be
@@ -113,9 +162,9 @@ message SynthesisInput {
 
 // Description of which voice to use for a synthesis request.
 message VoiceSelectionParams {
-  // The language (and optionally also the region) of the voice expressed as a
+  // Required. The language (and potentially also the region) of the voice expressed as a
   // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag, e.g.
-  // "en-US". Required. This should not include a script tag (e.g. use
+  // "en-US". This should not include a script tag (e.g. use
   // "cmn-cn" rather than "cmn-Hant-cn"), because the script will be inferred
   // from the input provided in the SynthesisInput.  The TTS service
   // will use this parameter to help choose an appropriate voice.  Note that
@@ -124,13 +173,13 @@ message VoiceSelectionParams {
   // (e.g. using en-US rather than en-CA if there isn't a Canadian voice
   // available), or even a different language, e.g. using "nb" (Norwegian
   // Bokmal) instead of "no" (Norwegian)".
-  string language_code = 1;
+  string language_code = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // The name of the voice. Optional; if not set, the service will choose a
+  // The name of the voice. If not set, the service will choose a
   // voice based on the other parameters such as language_code and gender.
   string name = 2;
 
-  // The preferred gender of the voice. Optional; if not set, the service will
+  // The preferred gender of the voice. If not set, the service will
   // choose a voice based on the other parameters such as language_code and
   // name. Note that this is only a preference, not requirement; if a
   // voice of the appropriate gender is not available, the synthesizer should
@@ -140,89 +189,66 @@ message VoiceSelectionParams {
 
 // Description of audio data to be synthesized.
 message AudioConfig {
-  // Required. The format of the requested audio byte stream.
-  AudioEncoding audio_encoding = 1;
-
-  // Optional speaking rate/speed, in the range [0.25, 4.0]. 1.0 is the normal
-  // native speed supported by the specific voice. 2.0 is twice as fast, and
-  // 0.5 is half as fast. If unset(0.0), defaults to the native 1.0 speed. Any
-  // other values < 0.25 or > 4.0 will return an error.
-  double speaking_rate = 2;
-
-  // Optional speaking pitch, in the range [-20.0, 20.0]. 20 means increase 20
-  // semitones from the original pitch. -20 means decrease 20 semitones from the
-  // original pitch.
-  double pitch = 3;
-
-  // Optional volume gain (in dB) of the normal native volume supported by the
-  // specific voice, in the range [-96.0, 16.0]. If unset, or set to a value of
-  // 0.0 (dB), will play at normal native signal amplitude. A value of -6.0 (dB)
-  // will play at approximately half the amplitude of the normal native signal
-  // amplitude. A value of +6.0 (dB) will play at approximately twice the
-  // amplitude of the normal native signal amplitude. Strongly recommend not to
-  // exceed +10 (dB) as there's usually no effective increase in loudness for
-  // any value greater than that.
-  double volume_gain_db = 4;
-
-  // The synthesis sample rate (in hertz) for this audio. Optional.  If this is
-  // different from the voice's natural sample rate, then the synthesizer will
-  // honor this request by converting to the desired sample rate (which might
-  // result in worse audio quality), unless the specified sample rate is not
-  // supported for the encoding chosen, in which case it will fail the request
-  // and return [google.rpc.Code.INVALID_ARGUMENT][].
-  int32 sample_rate_hertz = 5;
-
-  // An identifier which selects 'audio effects' profiles that are applied on
-  // (post synthesized) text to speech.
-  // Effects are applied on top of each other in the order they are given.
-  repeated string effects_profile_id = 6;
+  // Required. The format of the audio byte stream.
+  AudioEncoding audio_encoding = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Input only. Speaking rate/speed, in the range [0.25, 4.0]. 1.0 is
+  // the normal native speed supported by the specific voice. 2.0 is twice as
+  // fast, and 0.5 is half as fast. If unset(0.0), defaults to the native 1.0
+  // speed. Any other values < 0.25 or > 4.0 will return an error.
+  double speaking_rate = 2 [
+    (google.api.field_behavior) = INPUT_ONLY,
+    (google.api.field_behavior) = OPTIONAL
+  ];
+
+  // Optional. Input only. Speaking pitch, in the range [-20.0, 20.0]. 20 means
+  // increase 20 semitones from the original pitch. -20 means decrease 20
+  // semitones from the original pitch.
+  double pitch = 3 [
+    (google.api.field_behavior) = INPUT_ONLY,
+    (google.api.field_behavior) = OPTIONAL
+  ];
+
+  // Optional. Input only. Volume gain (in dB) of the normal native volume
+  // supported by the specific voice, in the range [-96.0, 16.0]. If unset, or
+  // set to a value of 0.0 (dB), will play at normal native signal amplitude. A
+  // value of -6.0 (dB) will play at approximately half the amplitude of the
+  // normal native signal amplitude. A value of +6.0 (dB) will play at
+  // approximately twice the amplitude of the normal native signal amplitude.
+  // Strongly recommend not to exceed +10 (dB) as there's usually no effective
+  // increase in loudness for any value greater than that.
+  double volume_gain_db = 4 [
+    (google.api.field_behavior) = INPUT_ONLY,
+    (google.api.field_behavior) = OPTIONAL
+  ];
+
+  // Optional. The synthesis sample rate (in hertz) for this audio. When this is
+  // specified in SynthesizeSpeechRequest, if this is different from the voice's
+  // natural sample rate, then the synthesizer will honor this request by
+  // converting to the desired sample rate (which might result in worse audio
+  // quality), unless the specified sample rate is not supported for the
+  // encoding chosen, in which case it will fail the request and return
+  // [google.rpc.Code.INVALID_ARGUMENT][].
+  int32 sample_rate_hertz = 5 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Input only. An identifier which selects 'audio effects' profiles
+  // that are applied on (post synthesized) text to speech. Effects are applied
+  // on top of each other in the order they are given. See
+  // [audio
+  // profiles](https://cloud.google.com/text-to-speech/docs/audio-profiles) for
+  // current supported profile ids.
+  repeated string effects_profile_id = 6 [
+    (google.api.field_behavior) = INPUT_ONLY,
+    (google.api.field_behavior) = OPTIONAL
+  ];
 }
 
 // The message returned to the client by the `SynthesizeSpeech` method.
 message SynthesizeSpeechResponse {
   // The audio data bytes encoded as specified in the request, including the
-  // header (For LINEAR16 audio, we include the WAV header). Note: as
+  // header for encodings that are wrapped in containers (e.g. MP3, OGG_OPUS).
+  // For LINEAR16 audio, we include the WAV header. Note: as
   // with all bytes fields, protobuffers use a pure binary representation,
   // whereas JSON representations use base64.
   bytes audio_content = 1;
 }
-
-// Gender of the voice as described in
-// [SSML voice element](https://www.w3.org/TR/speech-synthesis11/#edef_voice).
-enum SsmlVoiceGender {
-  // An unspecified gender.
-  // In VoiceSelectionParams, this means that the client doesn't care which
-  // gender the selected voice will have. In the Voice field of
-  // ListVoicesResponse, this may mean that the voice doesn't fit any of the
-  // other categories in this enum, or that the gender of the voice isn't known.
-  SSML_VOICE_GENDER_UNSPECIFIED = 0;
-
-  // A male voice.
-  MALE = 1;
-
-  // A female voice.
-  FEMALE = 2;
-
-  // A gender-neutral voice.
-  NEUTRAL = 3;
-}
-
-// Configuration to set up audio encoder. The encoding determines the output
-// audio format that we'd like.
-enum AudioEncoding {
-  // Not specified. Will return result [google.rpc.Code.INVALID_ARGUMENT][].
-  AUDIO_ENCODING_UNSPECIFIED = 0;
-
-  // Uncompressed 16-bit signed little-endian samples (Linear PCM).
-  // Audio content returned as LINEAR16 also contains a WAV header.
-  LINEAR16 = 1;
-
-  // MP3 audio.
-  MP3 = 2;
-
-  // Opus encoded audio wrapped in an ogg container. The result will be a
-  // file which can be played natively on Android, and in browsers (at least
-  // Chrome and Firefox). The quality of the encoding is considerably higher
-  // than MP3 while using approximately the same bitrate.
-  OGG_OPUS = 3;
-}
diff --git a/third_party/googleapis/google/cloud/texttospeech/v1beta1/texttospeech_gapic.legacy.yaml b/third_party/googleapis/google/cloud/texttospeech/v1beta1/texttospeech_gapic.legacy.yaml
new file mode 100644
index 000000000..276f9ed83
--- /dev/null
+++ b/third_party/googleapis/google/cloud/texttospeech/v1beta1/texttospeech_gapic.legacy.yaml
@@ -0,0 +1,135 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.texttospeech.v1beta1
+  python:
+    package_name: google.cloud.texttospeech_v1beta1.gapic
+  go:
+    package_name: cloud.google.com/go/texttospeech/apiv1beta1
+  csharp:
+    package_name: Google.Cloud.TextToSpeech.V1Beta1
+  ruby:
+    package_name: Google::Cloud::TextToSpeech::V1beta1
+  php:
+    package_name: Google\Cloud\TextToSpeech\V1beta1
+  nodejs:
+    package_name: text-to-speech.v1beta1
+    domain_layer_location: google-cloud
+# A list of API interface configurations.
+interfaces:
+  # The fully qualified name of the API interface.
+- name: google.cloud.texttospeech.v1beta1.TextToSpeech
+  smoke_test:
+    method: SynthesizeSpeech
+    init_fields:
+    - input.text="test"
+    - voice.language_code="en-US"
+    - audio_config.audio_encoding=MP3
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections: []
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ListVoices
+    flattening:
+      groups:
+      - parameters:
+        - language_code
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 30000
+  - name: SynthesizeSpeech
+    flattening:
+      groups:
+      - parameters:
+        - input
+        - voice
+        - audio_config
+    required_fields:
+    - input
+    - voice
+    - audio_config
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/texttospeech/v1beta1/texttospeech_gapic.yaml b/third_party/googleapis/google/cloud/texttospeech/v1beta1/texttospeech_gapic.yaml
index 276f9ed83..e02fe4316 100644
--- a/third_party/googleapis/google/cloud/texttospeech/v1beta1/texttospeech_gapic.yaml
+++ b/third_party/googleapis/google/cloud/texttospeech/v1beta1/texttospeech_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -17,119 +17,8 @@ language_settings:
   nodejs:
     package_name: text-to-speech.v1beta1
     domain_layer_location: google-cloud
-# A list of API interface configurations.
 interfaces:
-  # The fully qualified name of the API interface.
 - name: google.cloud.texttospeech.v1beta1.TextToSpeech
-  smoke_test:
-    method: SynthesizeSpeech
-    init_fields:
-    - input.text="test"
-    - voice.language_code="en-US"
-    - audio_config.audio_encoding=MP3
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections: []
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
   methods:
-  - name: ListVoices
-    flattening:
-      groups:
-      - parameters:
-        - language_code
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 30000
   - name: SynthesizeSpeech
-    flattening:
-      groups:
-      - parameters:
-        - input
-        - voice
-        - audio_config
-    required_fields:
-    - input
-    - voice
-    - audio_config
     retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/texttospeech/v1beta1/texttospeech_grpc_service_config.json b/third_party/googleapis/google/cloud/texttospeech/v1beta1/texttospeech_grpc_service_config.json
new file mode 100755
index 000000000..4741d86c9
--- /dev/null
+++ b/third_party/googleapis/google/cloud/texttospeech/v1beta1/texttospeech_grpc_service_config.json
@@ -0,0 +1,26 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.texttospeech.v1beta1.TextToSpeech",
+          "method": "ListVoices"
+        },
+        {
+          "service": "google.cloud.texttospeech.v1beta1.TextToSpeech",
+          "method": "SynthesizeSpeech"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/texttospeech/v1beta1/texttospeech_v1beta1.yaml b/third_party/googleapis/google/cloud/texttospeech/v1beta1/texttospeech_v1beta1.yaml
new file mode 100644
index 000000000..8e5391843
--- /dev/null
+++ b/third_party/googleapis/google/cloud/texttospeech/v1beta1/texttospeech_v1beta1.yaml
@@ -0,0 +1,27 @@
+type: google.api.Service
+config_version: 3
+name: texttospeech.googleapis.com
+title: Cloud Text-to-Speech API
+
+apis:
+- name: google.cloud.texttospeech.v1beta1.TextToSpeech
+
+documentation:
+  summary: |-
+    Synthesizes natural-sounding speech by applying powerful neural network
+    models.
+  overview: |-
+    # Introduction
+
+    Google Cloud Text-to-Speech API provides speech synthesis as a service.
+
+authentication:
+  rules:
+  - selector: google.cloud.texttospeech.v1beta1.TextToSpeech.ListVoices
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: google.cloud.texttospeech.v1beta1.TextToSpeech.SynthesizeSpeech
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/translate/artman_translate_v3.yaml b/third_party/googleapis/google/cloud/translate/artman_translate_v3.yaml
new file mode 100644
index 000000000..9cd1553e5
--- /dev/null
+++ b/third_party/googleapis/google/cloud/translate/artman_translate_v3.yaml
@@ -0,0 +1,35 @@
+common:
+  api_name: translate
+  api_version: v3
+  organization_name: google-cloud
+  proto_deps:
+  - name: google-common-protos
+  src_proto_paths:
+  - v3
+  service_yaml: v3/translate_v3.yaml
+  gapic_yaml: v3/translate_gapic.yaml
+  proto_package: google.cloud.translation.v3
+artifacts:
+- name: gapic_config
+  type: GAPIC_CONFIG
+- name: java_gapic
+  type: GAPIC
+  language: JAVA
+- name: python_gapic
+  type: GAPIC
+  language: PYTHON
+- name: nodejs_gapic
+  type: GAPIC
+  language: NODEJS
+- name: php_gapic
+  type: GAPIC
+  language: PHP
+- name: go_gapic
+  type: GAPIC
+  language: GO
+- name: ruby_gapic
+  type: GAPIC
+  language: RUBY
+- name: csharp_gapic
+  type: GAPIC
+  language: CSHARP
diff --git a/third_party/googleapis/google/cloud/translate/artman_translate_v3beta1.yaml b/third_party/googleapis/google/cloud/translate/artman_translate_v3beta1.yaml
index 5b5e1b8c7..655741031 100644
--- a/third_party/googleapis/google/cloud/translate/artman_translate_v3beta1.yaml
+++ b/third_party/googleapis/google/cloud/translate/artman_translate_v3beta1.yaml
@@ -6,8 +6,9 @@ common:
   - name: google-common-protos
   src_proto_paths:
   - v3beta1
-  service_yaml: translate_v3beta1.yaml
+  service_yaml: v3beta1/translate_v3beta1.yaml
   gapic_yaml: v3beta1/translate_gapic.yaml
+  proto_package: google.cloud.translation.v3beta1
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/cloud/translate/translate_v3beta1.yaml b/third_party/googleapis/google/cloud/translate/translate_v3beta1.yaml
deleted file mode 100644
index 2df789463..000000000
--- a/third_party/googleapis/google/cloud/translate/translate_v3beta1.yaml
+++ /dev/null
@@ -1,68 +0,0 @@
-type: google.api.Service
-config_version: 3
-name: translate.googleapis.com
-title: Cloud Translation API
-
-apis:
-- name: google.cloud.translation.v3beta1.TranslationService
-
-documentation:
-  summary: Integrates text translation into your website or application.
-
-http:
-  rules:
-  - selector: google.iam.v1.IAMPolicy.GetIamPolicy
-    get: '/v3beta1/{resource=projects/*/locations/*}:getIamPolicy'
-    additional_bindings:
-    - get: '/v3beta1/{resource=projects/*/locations/*/glossaries/*}:getIamPolicy'
-    - get: '/v3beta1/{resource=projects/*/locations/*/models/*}:getIamPolicy'
-    - get: '/v3beta1/{resource=projects/*/locations/*/models/general/*}:getIamPolicy'
-    - get: '/v3beta1/{resource=projects/*/locations/*/models/language-detection/*}:getIamPolicy'
-  - selector: google.iam.v1.IAMPolicy.SetIamPolicy
-    post: '/v3beta1/{resource=projects/*/locations/*}:setIamPolicy'
-    body: '*'
-    additional_bindings:
-    - post: '/v3beta1/{resource=projects/*/locations/*/glossaries/*}:setIamPolicy'
-      body: '*'
-    - post: '/v3beta1/{resource=projects/*/locations/*/models/*}:setIamPolicy'
-      body: '*'
-    - post: '/v3beta1/{resource=projects/*/locations/*/models/general/*}:setIamPolicy'
-      body: '*'
-    - post: '/v3beta1/{resource=projects/*/locations/*/models/language-detection/*}:setIamPolicy'
-      body: '*'
-  - selector: google.iam.v1.IAMPolicy.TestIamPermissions
-    post: '/v3beta1/{resource=projects/*/locations/*/**}:testIamPermissions'
-    body: '*'
-  - selector: google.longrunning.Operations.CancelOperation
-    post: '/v3beta1/{name=projects/*/locations/*/operations/*}:cancel'
-    body: '*'
-  - selector: google.longrunning.Operations.DeleteOperation
-    delete: '/v3beta1/{name=projects/*/locations/*/operations/*}'
-  - selector: google.longrunning.Operations.GetOperation
-    get: '/v3beta1/{name=projects/*/locations/*/operations/*}'
-  - selector: google.longrunning.Operations.ListOperations
-    get: '/v3beta1/{name=projects/*/locations/*/operations}'
-  - selector: google.longrunning.Operations.WaitOperation
-    post: '/v3beta1/{name=projects/*/locations/*/operations/*}:wait'
-    body: '*'
-
-authentication:
-  rules:
-  - selector: 'google.cloud.translation.v3beta1.TranslationService.*'
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform,
-        https://www.googleapis.com/auth/cloud-translation
-  - selector: google.cloud.translation.v3beta1.TranslationService.BatchTranslateText
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform
-  - selector: google.cloud.translation.v3beta1.TranslationService.CreateGlossary
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform
-  - selector: 'google.longrunning.Operations.*'
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform,
-        https://www.googleapis.com/auth/cloud-translation
diff --git a/third_party/googleapis/google/cloud/translate/v3/BUILD.bazel b/third_party/googleapis/google/cloud/translate/v3/BUILD.bazel
new file mode 100644
index 000000000..1599dcb2f
--- /dev/null
+++ b/third_party/googleapis/google/cloud/translate/v3/BUILD.bazel
@@ -0,0 +1,365 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "translation_proto",
+    srcs = [
+        "translation_service.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "translation_proto_with_info",
+    deps = [
+        ":translation_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "translation_java_proto",
+    deps = [":translation_proto"],
+)
+
+java_grpc_library(
+    name = "translation_java_grpc",
+    srcs = [":translation_proto"],
+    deps = [":translation_java_proto"],
+)
+
+java_gapic_library(
+    name = "translation_java_gapic",
+    src = ":translation_proto_with_info",
+    gapic_yaml = "translate_gapic.yaml",
+    package = "google.cloud.translation.v3",
+    service_yaml = "translate_v3.yaml",
+    test_deps = [
+        ":translation_java_grpc",
+    ],
+    deps = [
+        ":translation_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "translation_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.translate.v3.TranslationServiceClientTest",
+    ],
+    runtime_deps = [":translation_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-translation-v3-java",
+    deps = [
+        ":translation_java_gapic",
+        ":translation_java_grpc",
+        ":translation_java_proto",
+        ":translation_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "translation_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/translate/v3",
+    protos = [":translation_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/longrunning:longrunning_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "translation_go_gapic",
+    srcs = [":translation_proto_with_info"],
+    grpc_service_config = "translate_grpc_service_config.json",
+    importpath = "cloud.google.com/go/translate/apiv3;translate",
+    service_yaml = "translate_v3.yaml",
+    deps = [
+        ":translation_go_proto",
+        "//google/longrunning:longrunning_go_gapic",
+        "//google/longrunning:longrunning_go_proto",
+        "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
+    ],
+)
+
+go_test(
+    name = "translation_go_gapic_test",
+    srcs = [":translation_go_gapic_srcjar_test"],
+    embed = [":translation_go_gapic"],
+    importpath = "cloud.google.com/go/translate/apiv3",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-translation-v3-go",
+    deps = [
+        ":translation_go_gapic",
+        ":translation_go_gapic_srcjar-test.srcjar",
+        ":translation_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "translation_moved_proto",
+    srcs = [":translation_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "translation_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":translation_moved_proto"],
+)
+
+py_grpc_library(
+    name = "translation_py_grpc",
+    srcs = [":translation_moved_proto"],
+    deps = [":translation_py_proto"],
+)
+
+py_gapic_library(
+    name = "translation_py_gapic",
+    src = ":translation_proto_with_info",
+    gapic_yaml = "translate_gapic.yaml",
+    package = "google.cloud.translation.v3",
+    service_yaml = "translate_v3.yaml",
+    deps = [
+        ":translation_py_grpc",
+        ":translation_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "translation-v3-py",
+    deps = [
+        ":translation_py_gapic",
+        ":translation_py_grpc",
+        ":translation_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "translation_php_proto",
+    deps = [":translation_proto"],
+)
+
+php_grpc_library(
+    name = "translation_php_grpc",
+    srcs = [":translation_proto"],
+    deps = [":translation_php_proto"],
+)
+
+php_gapic_library(
+    name = "translation_php_gapic",
+    src = ":translation_proto_with_info",
+    gapic_yaml = "translate_gapic.yaml",
+    package = "google.cloud.translation.v3",
+    service_yaml = "translate_v3.yaml",
+    deps = [
+        ":translation_php_grpc",
+        ":translation_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-translation-v3-php",
+    deps = [
+        ":translation_php_gapic",
+        ":translation_php_grpc",
+        ":translation_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "translation_nodejs_gapic",
+    src = ":translation_proto_with_info",
+    gapic_yaml = "translate_gapic.yaml",
+    package = "google.cloud.translation.v3",
+    service_yaml = "translate_v3.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "translation-v3-nodejs",
+    deps = [
+        ":translation_nodejs_gapic",
+        ":translation_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "translation_ruby_proto",
+    deps = [":translation_proto"],
+)
+
+ruby_grpc_library(
+    name = "translation_ruby_grpc",
+    srcs = [":translation_proto"],
+    deps = [":translation_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "translation_ruby_gapic",
+    src = ":translation_proto_with_info",
+    gapic_yaml = "translate_gapic.yaml",
+    package = "google.cloud.translation.v3",
+    service_yaml = "translate_v3.yaml",
+    deps = [
+        ":translation_ruby_grpc",
+        ":translation_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-translation-v3-ruby",
+    deps = [
+        ":translation_ruby_gapic",
+        ":translation_ruby_grpc",
+        ":translation_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "translation_csharp_proto",
+    deps = [":translation_proto"],
+)
+
+csharp_grpc_library(
+    name = "translation_csharp_grpc",
+    srcs = [":translation_proto"],
+    deps = [":translation_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "translation_csharp_gapic",
+    src = ":translation_proto_with_info",
+    gapic_yaml = "translate_gapic.yaml",
+    package = "google.cloud.translation.v3",
+    service_yaml = "translate_v3.yaml",
+    deps = [
+        ":translation_csharp_grpc",
+        ":translation_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-translation-v3-csharp",
+    deps = [
+        ":translation_csharp_gapic",
+        ":translation_csharp_grpc",
+        ":translation_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/translate/v3/translate_gapic.legacy.yaml b/third_party/googleapis/google/cloud/translate/v3/translate_gapic.legacy.yaml
new file mode 100644
index 000000000..bcfaed533
--- /dev/null
+++ b/third_party/googleapis/google/cloud/translate/v3/translate_gapic.legacy.yaml
@@ -0,0 +1,244 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.translate.v3
+  python:
+    package_name: google.cloud.translate_v3.gapic
+  go:
+    package_name: cloud.google.com/go/translate/apiv3
+  csharp:
+    package_name: Google.Cloud.Translate.V3
+  ruby:
+    package_name: Google::Cloud::Translate::V3
+  php:
+    package_name: Google\Cloud\Translate\V3
+  nodejs:
+    package_name: translate.v3
+    domain_layer_location: google-cloud
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: google.cloud.translation.v3.TranslationService
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}/locations/{location}
+    entity_name: location
+  - name_pattern: projects/{project}/locations/{location}/glossaries/{glossary}
+    entity_name: glossary
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: TranslateText
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - target_language_code
+        - contents
+      - parameters:
+        - parent
+        - model
+        - mime_type
+        - source_language_code
+        - target_language_code
+        - contents
+    required_fields:
+    - contents
+    - target_language_code
+    - parent
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 60000
+  - name: DetectLanguage
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - model
+        - mime_type
+        - content
+    required_fields:
+    - parent
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 60000
+  - name: GetSupportedLanguages
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - model
+        - display_language_code
+    required_fields:
+    - parent
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 60000
+  - name: BatchTranslateText
+    required_fields:
+    - parent
+    - source_language_code
+    - target_language_codes
+    - input_configs
+    - output_config
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    long_running:
+      return_type: google.cloud.translation.v3.BatchTranslateResponse
+      metadata_type: google.cloud.translation.v3.BatchTranslateMetadata
+      initial_poll_delay_millis: 500
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 5000
+      total_poll_timeout_millis: 300000
+    timeout_millis: 60000
+  - name: CreateGlossary
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - glossary
+    required_fields:
+    - parent
+    - glossary
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    long_running:
+      return_type: google.cloud.translation.v3.Glossary
+      metadata_type: google.cloud.translation.v3.CreateGlossaryMetadata
+      initial_poll_delay_millis: 500
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 5000
+      total_poll_timeout_millis: 300000
+    timeout_millis: 60000
+  - name: ListGlossaries
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: glossaries
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 60000
+  - name: GetGlossary
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: glossary
+    timeout_millis: 60000
+  - name: DeleteGlossary
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: glossary
+    long_running:
+      return_type: google.cloud.translation.v3.DeleteGlossaryResponse
+      metadata_type: google.cloud.translation.v3.DeleteGlossaryMetadata
+      initial_poll_delay_millis: 500
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 5000
+      total_poll_timeout_millis: 300000
+    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/translate/v3/translate_gapic.yaml b/third_party/googleapis/google/cloud/translate/v3/translate_gapic.yaml
new file mode 100644
index 000000000..4532cd522
--- /dev/null
+++ b/third_party/googleapis/google/cloud/translate/v3/translate_gapic.yaml
@@ -0,0 +1,25 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 2.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.translate.v3
+  python:
+    package_name: google.cloud.translate_v3.gapic
+  go:
+    package_name: cloud.google.com/go/translate/apiv3
+    release_level: GA
+  csharp:
+    package_name: Google.Cloud.Translate.V3
+  ruby:
+    package_name: Google::Cloud::Translate::V3
+  php:
+    package_name: Google\Cloud\Translate\V3
+  nodejs:
+    package_name: translate.v3
+    domain_layer_location: google-cloud
+interfaces:
+- name: google.cloud.translation.v3.TranslationService
+  methods:
+  - name: DeleteGlossary
+    retry_codes_name: idempotent
diff --git a/third_party/googleapis/google/cloud/translate/v3/translate_grpc_service_config.json b/third_party/googleapis/google/cloud/translate/v3/translate_grpc_service_config.json
new file mode 100755
index 000000000..657011c12
--- /dev/null
+++ b/third_party/googleapis/google/cloud/translate/v3/translate_grpc_service_config.json
@@ -0,0 +1,55 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.translation.v3.TranslationService",
+          "method": "GetSupportedLanguages"
+        },
+        {
+          "service": "google.cloud.translation.v3.TranslationService",
+          "method": "ListGlossaries"
+        },
+        {
+          "service": "google.cloud.translation.v3.TranslationService",
+          "method": "GetGlossary"
+        },
+        {
+          "service": "google.cloud.translation.v3.TranslationService",
+          "method": "DeleteGlossary"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.translation.v3.TranslationService",
+          "method": "TranslateText"
+        },
+        {
+          "service": "google.cloud.translation.v3.TranslationService",
+          "method": "DetectLanguage"
+        },
+        {
+          "service": "google.cloud.translation.v3.TranslationService",
+          "method": "BatchTranslateText"
+        },
+        {
+          "service": "google.cloud.translation.v3.TranslationService",
+          "method": "CreateGlossary"
+        }
+      ],
+      "timeout": "600s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/translate/v3/translate_v3.yaml b/third_party/googleapis/google/cloud/translate/v3/translate_v3.yaml
new file mode 100644
index 000000000..dad626213
--- /dev/null
+++ b/third_party/googleapis/google/cloud/translate/v3/translate_v3.yaml
@@ -0,0 +1,38 @@
+type: google.api.Service
+config_version: 3
+name: translate.googleapis.com
+title: Cloud Translation API
+
+apis:
+- name: google.cloud.translation.v3.TranslationService
+
+documentation:
+  summary: Integrates text translation into your website or application.
+
+backend:
+  rules:
+  - selector: 'google.longrunning.Operations.*'
+    deadline: 60.0
+  - selector: google.longrunning.Operations.WaitOperation
+    deadline: 120.0
+
+authentication:
+  rules:
+  - selector: 'google.cloud.translation.v3.TranslationService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-translation
+  - selector: google.cloud.translation.v3.TranslationService.BatchTranslateText
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: google.cloud.translation.v3.TranslationService.CreateGlossary
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-translation
diff --git a/third_party/googleapis/google/cloud/translate/v3/translation_service.proto b/third_party/googleapis/google/cloud/translate/v3/translation_service.proto
new file mode 100644
index 000000000..ad43831c2
--- /dev/null
+++ b/third_party/googleapis/google/cloud/translate/v3/translation_service.proto
@@ -0,0 +1,926 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.translation.v3;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/timestamp.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.Translate.V3";
+option go_package = "google.golang.org/genproto/googleapis/cloud/translate/v3;translate";
+option java_multiple_files = true;
+option java_outer_classname = "TranslationServiceProto";
+option java_package = "com.google.cloud.translate.v3";
+option php_namespace = "Google\\Cloud\\Translate\\V3";
+option ruby_package = "Google::Cloud::Translate::V3";
+
+// Proto file for the Cloud Translation API (v3 GA).
+
+// Provides natural language translation operations.
+service TranslationService {
+  option (google.api.default_host) = "translate.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/cloud-translation";
+
+  // Translates input text and returns translated text.
+  rpc TranslateText(TranslateTextRequest) returns (TranslateTextResponse) {
+    option (google.api.http) = {
+      post: "/v3/{parent=projects/*/locations/*}:translateText"
+      body: "*"
+      additional_bindings {
+        post: "/v3/{parent=projects/*}:translateText"
+        body: "*"
+      }
+    };
+    option (google.api.method_signature) =
+        "parent,target_language_code,contents";
+    option (google.api.method_signature) =
+        "parent,model,mime_type,source_language_code,target_language_code,contents";
+  }
+
+  // Detects the language of text within a request.
+  rpc DetectLanguage(DetectLanguageRequest) returns (DetectLanguageResponse) {
+    option (google.api.http) = {
+      post: "/v3/{parent=projects/*/locations/*}:detectLanguage"
+      body: "*"
+      additional_bindings {
+        post: "/v3/{parent=projects/*}:detectLanguage"
+        body: "*"
+      }
+    };
+    option (google.api.method_signature) = "parent,model,mime_type,content";
+  }
+
+  // Returns a list of supported languages for translation.
+  rpc GetSupportedLanguages(GetSupportedLanguagesRequest)
+      returns (SupportedLanguages) {
+    option (google.api.http) = {
+      get: "/v3/{parent=projects/*/locations/*}/supportedLanguages"
+      additional_bindings { get: "/v3/{parent=projects/*}/supportedLanguages" }
+    };
+    option (google.api.method_signature) = "parent,model,display_language_code";
+  }
+
+  // Translates a large volume of text in asynchronous batch mode.
+  // This function provides real-time output as the inputs are being processed.
+  // If caller cancels a request, the partial results (for an input file, it's
+  // all or nothing) may still be available on the specified output location.
+  //
+  // This call returns immediately and you can
+  // use google.longrunning.Operation.name to poll the status of the call.
+  rpc BatchTranslateText(BatchTranslateTextRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v3/{parent=projects/*/locations/*}:batchTranslateText"
+      body: "*"
+    };
+    option (google.longrunning.operation_info) = {
+      response_type: "BatchTranslateResponse"
+      metadata_type: "BatchTranslateMetadata"
+    };
+  }
+
+  // Creates a glossary and returns the long-running operation. Returns
+  // NOT_FOUND, if the project doesn't exist.
+  rpc CreateGlossary(CreateGlossaryRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v3/{parent=projects/*/locations/*}/glossaries"
+      body: "glossary"
+    };
+    option (google.api.method_signature) = "parent,glossary";
+    option (google.longrunning.operation_info) = {
+      response_type: "Glossary"
+      metadata_type: "CreateGlossaryMetadata"
+    };
+  }
+
+  // Lists glossaries in a project. Returns NOT_FOUND, if the project doesn't
+  // exist.
+  rpc ListGlossaries(ListGlossariesRequest) returns (ListGlossariesResponse) {
+    option (google.api.http) = {
+      get: "/v3/{parent=projects/*/locations/*}/glossaries"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Gets a glossary. Returns NOT_FOUND, if the glossary doesn't
+  // exist.
+  rpc GetGlossary(GetGlossaryRequest) returns (Glossary) {
+    option (google.api.http) = {
+      get: "/v3/{name=projects/*/locations/*/glossaries/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Deletes a glossary, or cancels glossary construction
+  // if the glossary isn't created yet.
+  // Returns NOT_FOUND, if the glossary doesn't exist.
+  rpc DeleteGlossary(DeleteGlossaryRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      delete: "/v3/{name=projects/*/locations/*/glossaries/*}"
+    };
+    option (google.api.method_signature) = "name";
+    option (google.longrunning.operation_info) = {
+      response_type: "DeleteGlossaryResponse"
+      metadata_type: "DeleteGlossaryMetadata"
+    };
+  }
+}
+
+// Configures which glossary should be used for a specific target language,
+// and defines options for applying that glossary.
+message TranslateTextGlossaryConfig {
+  // Required. Specifies the glossary used for this translation. Use
+  // this format: projects/*/locations/*/glossaries/*
+  string glossary = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Indicates match is case-insensitive.
+  // Default value is false if missing.
+  bool ignore_case = 2 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// The request message for synchronous translation.
+message TranslateTextRequest {
+  // Required. The content of the input in string format.
+  // We recommend the total content be less than 30k codepoints.
+  // Use BatchTranslateText for larger text.
+  repeated string contents = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The format of the source text, for example, "text/html",
+  //  "text/plain". If left blank, the MIME type defaults to "text/html".
+  string mime_type = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The BCP-47 language code of the input text if
+  // known, for example, "en-US" or "sr-Latn". Supported language codes are
+  // listed in Language Support. If the source language isn't specified, the API
+  // attempts to identify the source language automatically and returns the
+  // source language within the response.
+  string source_language_code = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. The BCP-47 language code to use for translation of the input
+  // text, set to one of the language codes listed in Language Support.
+  string target_language_code = 5 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Project or location to make a call. Must refer to a caller's
+  // project.
+  //
+  // Format: `projects/{project-number-or-id}` or
+  // `projects/{project-number-or-id}/locations/{location-id}`.
+  //
+  // For global calls, use `projects/{project-number-or-id}/locations/global` or
+  // `projects/{project-number-or-id}`.
+  //
+  // Non-global location is required for requests using AutoML models or
+  // custom glossaries.
+  //
+  // Models and glossaries must be within the same region (have same
+  // location-id), otherwise an INVALID_ARGUMENT (400) error is returned.
+  string parent = 8 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // Optional. The `model` type requested for this translation.
+  //
+  // The format depends on model type:
+  //
+  // - AutoML Translation models:
+  //   `projects/{project-number-or-id}/locations/{location-id}/models/{model-id}`
+  //
+  // - General (built-in) models:
+  //   `projects/{project-number-or-id}/locations/{location-id}/models/general/nmt`,
+  //   `projects/{project-number-or-id}/locations/{location-id}/models/general/base`
+  //
+  //
+  // For global (non-regionalized) requests, use `location-id` `global`.
+  // For example,
+  // `projects/{project-number-or-id}/locations/global/models/general/nmt`.
+  //
+  // If missing, the system decides which google base model to use.
+  string model = 6 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Glossary to be applied. The glossary must be
+  // within the same region (have the same location-id) as the model, otherwise
+  // an INVALID_ARGUMENT (400) error is returned.
+  TranslateTextGlossaryConfig glossary_config = 7
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The labels with user-defined metadata for the request.
+  //
+  // Label keys and values can be no longer than 63 characters
+  // (Unicode codepoints), can only contain lowercase letters, numeric
+  // characters, underscores and dashes. International characters are allowed.
+  // Label values are optional. Label keys must start with a letter.
+  //
+  // See https://cloud.google.com/translate/docs/labels for more information.
+  map labels = 10 [(google.api.field_behavior) = OPTIONAL];
+}
+
+message TranslateTextResponse {
+  // Text translation responses with no glossary applied.
+  // This field has the same length as
+  // [`contents`][google.cloud.translation.v3.TranslateTextRequest.contents].
+  repeated Translation translations = 1;
+
+  // Text translation responses if a glossary is provided in the request.
+  // This can be the same as
+  // [`translations`][google.cloud.translation.v3.TranslateTextResponse.translations]
+  // if no terms apply. This field has the same length as
+  // [`contents`][google.cloud.translation.v3.TranslateTextRequest.contents].
+  repeated Translation glossary_translations = 3;
+}
+
+// A single translation response.
+message Translation {
+  // Text translated into the target language.
+  string translated_text = 1;
+
+  // Only present when `model` is present in the request.
+  // `model` here is normalized to have project number.
+  //
+  // For example:
+  // If the `model` requested in TranslationTextRequest is
+  // `projects/{project-id}/locations/{location-id}/models/general/nmt` then
+  // `model` here would be normalized to
+  // `projects/{project-number}/locations/{location-id}/models/general/nmt`.
+  string model = 2;
+
+  // The BCP-47 language code of source text in the initial request, detected
+  // automatically, if no source language was passed within the initial
+  // request. If the source language was passed, auto-detection of the language
+  // does not occur and this field is empty.
+  string detected_language_code = 4;
+
+  // The `glossary_config` used for this translation.
+  TranslateTextGlossaryConfig glossary_config = 3;
+}
+
+// The request message for language detection.
+message DetectLanguageRequest {
+  // Required. Project or location to make a call. Must refer to a caller's
+  // project.
+  //
+  // Format: `projects/{project-number-or-id}/locations/{location-id}` or
+  // `projects/{project-number-or-id}`.
+  //
+  // For global calls, use `projects/{project-number-or-id}/locations/global` or
+  // `projects/{project-number-or-id}`.
+  //
+  // Only models within the same region (has same location-id) can be used.
+  // Otherwise an INVALID_ARGUMENT (400) error is returned.
+  string parent = 5 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // Optional. The language detection model to be used.
+  //
+  // Format:
+  // `projects/{project-number-or-id}/locations/{location-id}/models/language-detection/{model-id}`
+  //
+  // Only one language detection model is currently supported:
+  // `projects/{project-number-or-id}/locations/{location-id}/models/language-detection/default`.
+  //
+  // If not specified, the default model is used.
+  string model = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. The source of the document from which to detect the language.
+  oneof source {
+    // The content of the input stored as a string.
+    string content = 1;
+  }
+
+  // Optional. The format of the source text, for example, "text/html",
+  // "text/plain". If left blank, the MIME type defaults to "text/html".
+  string mime_type = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The labels with user-defined metadata for the request.
+  //
+  // Label keys and values can be no longer than 63 characters
+  // (Unicode codepoints), can only contain lowercase letters, numeric
+  // characters, underscores and dashes. International characters are allowed.
+  // Label values are optional. Label keys must start with a letter.
+  //
+  // See https://cloud.google.com/translate/docs/labels for more information.
+  map labels = 6 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// The response message for language detection.
+message DetectedLanguage {
+  // The BCP-47 language code of source content in the request, detected
+  // automatically.
+  string language_code = 1;
+
+  // The confidence of the detection result for this language.
+  float confidence = 2;
+}
+
+// The response message for language detection.
+message DetectLanguageResponse {
+  // A list of detected languages sorted by detection confidence in descending
+  // order. The most probable language first.
+  repeated DetectedLanguage languages = 1;
+}
+
+// The request message for discovering supported languages.
+message GetSupportedLanguagesRequest {
+  // Required. Project or location to make a call. Must refer to a caller's
+  // project.
+  //
+  // Format: `projects/{project-number-or-id}` or
+  // `projects/{project-number-or-id}/locations/{location-id}`.
+  //
+  // For global calls, use `projects/{project-number-or-id}/locations/global` or
+  // `projects/{project-number-or-id}`.
+  //
+  // Non-global location is required for AutoML models.
+  //
+  // Only models within the same region (have same location-id) can be used,
+  // otherwise an INVALID_ARGUMENT (400) error is returned.
+  string parent = 3 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // Optional. The language to use to return localized, human readable names
+  // of supported languages. If missing, then display names are not returned
+  // in a response.
+  string display_language_code = 1 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Get supported languages of this model.
+  //
+  // The format depends on model type:
+  //
+  // - AutoML Translation models:
+  //   `projects/{project-number-or-id}/locations/{location-id}/models/{model-id}`
+  //
+  // - General (built-in) models:
+  //   `projects/{project-number-or-id}/locations/{location-id}/models/general/nmt`,
+  //   `projects/{project-number-or-id}/locations/{location-id}/models/general/base`
+  //
+  //
+  // Returns languages supported by the specified model.
+  // If missing, we get supported languages of Google general base (PBMT) model.
+  string model = 2 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// The response message for discovering supported languages.
+message SupportedLanguages {
+  // A list of supported language responses. This list contains an entry
+  // for each language the Translation API supports.
+  repeated SupportedLanguage languages = 1;
+}
+
+// A single supported language response corresponds to information related
+// to one supported language.
+message SupportedLanguage {
+  // Supported language code, generally consisting of its ISO 639-1
+  // identifier, for example, 'en', 'ja'. In certain cases, BCP-47 codes
+  // including language and region identifiers are returned (for example,
+  // 'zh-TW' and 'zh-CN')
+  string language_code = 1;
+
+  // Human readable name of the language localized in the display language
+  // specified in the request.
+  string display_name = 2;
+
+  // Can be used as source language.
+  bool support_source = 3;
+
+  // Can be used as target language.
+  bool support_target = 4;
+}
+
+// The Google Cloud Storage location for the input content.
+message GcsSource {
+  // Required. Source data URI. For example, `gs://my_bucket/my_object`.
+  string input_uri = 1;
+}
+
+// Input configuration for BatchTranslateText request.
+message InputConfig {
+  // Optional. Can be "text/plain" or "text/html".
+  // For `.tsv`, "text/html" is used if mime_type is missing.
+  // For `.html`, this field must be "text/html" or empty.
+  // For `.txt`, this field must be "text/plain" or empty.
+  string mime_type = 1 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. Specify the input.
+  oneof source {
+    // Required. Google Cloud Storage location for the source input.
+    // This can be a single file (for example,
+    // `gs://translation-test/input.tsv`) or a wildcard (for example,
+    // `gs://translation-test/*`). If a file extension is `.tsv`, it can
+    // contain either one or two columns. The first column (optional) is the id
+    // of the text request. If the first column is missing, we use the row
+    // number (0-based) from the input file as the ID in the output file. The
+    // second column is the actual text to be
+    //  translated. We recommend each row be <= 10K Unicode codepoints,
+    // otherwise an error might be returned.
+    // Note that the input tsv must be RFC 4180 compliant.
+    //
+    // You could use https://github.com/Clever/csvlint to check potential
+    // formatting errors in your tsv file.
+    // csvlint --delimiter='\t' your_input_file.tsv
+    //
+    // The other supported file extensions are `.txt` or `.html`, which is
+    // treated as a single large chunk of text.
+    GcsSource gcs_source = 2;
+  }
+}
+
+// The Google Cloud Storage location for the output content.
+message GcsDestination {
+  // Required. There must be no files under 'output_uri_prefix'.
+  // 'output_uri_prefix' must end with "/" and start with "gs://", otherwise an
+  // INVALID_ARGUMENT (400) error is returned.
+  string output_uri_prefix = 1;
+}
+
+// Output configuration for BatchTranslateText request.
+message OutputConfig {
+  // Required. The destination of output.
+  oneof destination {
+    // Google Cloud Storage destination for output content.
+    // For every single input file (for example, gs://a/b/c.[extension]), we
+    // generate at most 2 * n output files. (n is the # of target_language_codes
+    // in the BatchTranslateTextRequest).
+    //
+    // Output files (tsv) generated are compliant with RFC 4180 except that
+    // record delimiters are '\n' instead of '\r\n'. We don't provide any way to
+    // change record delimiters.
+    //
+    // While the input files are being processed, we write/update an index file
+    // 'index.csv'  under 'output_uri_prefix' (for example,
+    // gs://translation-test/index.csv) The index file is generated/updated as
+    // new files are being translated. The format is:
+    //
+    // input_file,target_language_code,translations_file,errors_file,
+    // glossary_translations_file,glossary_errors_file
+    //
+    // input_file is one file we matched using gcs_source.input_uri.
+    // target_language_code is provided in the request.
+    // translations_file contains the translations. (details provided below)
+    // errors_file contains the errors during processing of the file. (details
+    // below). Both translations_file and errors_file could be empty
+    // strings if we have no content to output.
+    // glossary_translations_file and glossary_errors_file are always empty
+    // strings if the input_file is tsv. They could also be empty if we have no
+    // content to output.
+    //
+    // Once a row is present in index.csv, the input/output matching never
+    // changes. Callers should also expect all the content in input_file are
+    // processed and ready to be consumed (that is, no partial output file is
+    // written).
+    //
+    // The format of translations_file (for target language code 'trg') is:
+    // gs://translation_test/a_b_c_'trg'_translations.[extension]
+    //
+    // If the input file extension is tsv, the output has the following
+    // columns:
+    // Column 1: ID of the request provided in the input, if it's not
+    // provided in the input, then the input row number is used (0-based).
+    // Column 2: source sentence.
+    // Column 3: translation without applying a glossary. Empty string if there
+    // is an error.
+    // Column 4 (only present if a glossary is provided in the request):
+    // translation after applying the glossary. Empty string if there is an
+    // error applying the glossary. Could be same string as column 3 if there is
+    // no glossary applied.
+    //
+    // If input file extension is a txt or html, the translation is directly
+    // written to the output file. If glossary is requested, a separate
+    // glossary_translations_file has format of
+    // gs://translation_test/a_b_c_'trg'_glossary_translations.[extension]
+    //
+    // The format of errors file (for target language code 'trg') is:
+    // gs://translation_test/a_b_c_'trg'_errors.[extension]
+    //
+    // If the input file extension is tsv, errors_file contains the following:
+    // Column 1: ID of the request provided in the input, if it's not
+    // provided in the input, then the input row number is used (0-based).
+    // Column 2: source sentence.
+    // Column 3: Error detail for the translation. Could be empty.
+    // Column 4 (only present if a glossary is provided in the request):
+    // Error when applying the glossary.
+    //
+    // If the input file extension is txt or html, glossary_error_file will be
+    // generated that contains error details. glossary_error_file has format of
+    // gs://translation_test/a_b_c_'trg'_glossary_errors.[extension]
+    GcsDestination gcs_destination = 1;
+  }
+}
+
+// The batch translation request.
+message BatchTranslateTextRequest {
+  // Required. Location to make a call. Must refer to a caller's project.
+  //
+  // Format: `projects/{project-number-or-id}/locations/{location-id}`.
+  //
+  // The `global` location is not supported for batch translation.
+  //
+  // Only AutoML Translation models or glossaries within the same region (have
+  // the same location-id) can be used, otherwise an INVALID_ARGUMENT (400)
+  // error is returned.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // Required. Source language code.
+  string source_language_code = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Specify up to 10 language codes here.
+  repeated string target_language_codes = 3
+      [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The models to use for translation. Map's key is target language
+  // code. Map's value is model name. Value can be a built-in general model,
+  // or an AutoML Translation model.
+  //
+  // The value format depends on model type:
+  //
+  // - AutoML Translation models:
+  //   `projects/{project-number-or-id}/locations/{location-id}/models/{model-id}`
+  //
+  // - General (built-in) models:
+  //   `projects/{project-number-or-id}/locations/{location-id}/models/general/nmt`,
+  //   `projects/{project-number-or-id}/locations/{location-id}/models/general/base`
+  //
+  //
+  // If the map is empty or a specific model is
+  // not requested for a language pair, then default google model (nmt) is used.
+  map models = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. Input configurations.
+  // The total number of files matched should be <= 1000.
+  // The total content size should be <= 100M Unicode codepoints.
+  // The files must use UTF-8 encoding.
+  repeated InputConfig input_configs = 5
+      [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Output configuration.
+  // If 2 input configs match to the same file (that is, same input path),
+  // we don't generate output for duplicate inputs.
+  OutputConfig output_config = 6 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Glossaries to be applied for translation.
+  // It's keyed by target language code.
+  map glossaries = 7
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The labels with user-defined metadata for the request.
+  //
+  // Label keys and values can be no longer than 63 characters
+  // (Unicode codepoints), can only contain lowercase letters, numeric
+  // characters, underscores and dashes. International characters are allowed.
+  // Label values are optional. Label keys must start with a letter.
+  //
+  // See https://cloud.google.com/translate/docs/labels for more information.
+  map labels = 9 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// State metadata for the batch translation operation.
+message BatchTranslateMetadata {
+  // State of the job.
+  enum State {
+    // Invalid.
+    STATE_UNSPECIFIED = 0;
+
+    // Request is being processed.
+    RUNNING = 1;
+
+    // The batch is processed, and at least one item was successfully
+    // processed.
+    SUCCEEDED = 2;
+
+    // The batch is done and no item was successfully processed.
+    FAILED = 3;
+
+    // Request is in the process of being canceled after caller invoked
+    // longrunning.Operations.CancelOperation on the request id.
+    CANCELLING = 4;
+
+    // The batch is done after the user has called the
+    // longrunning.Operations.CancelOperation. Any records processed before the
+    // cancel command are output as specified in the request.
+    CANCELLED = 5;
+  }
+
+  // The state of the operation.
+  State state = 1;
+
+  // Number of successfully translated characters so far (Unicode codepoints).
+  int64 translated_characters = 2;
+
+  // Number of characters that have failed to process so far (Unicode
+  // codepoints).
+  int64 failed_characters = 3;
+
+  // Total number of characters (Unicode codepoints).
+  // This is the total number of codepoints from input files times the number of
+  // target languages and appears here shortly after the call is submitted.
+  int64 total_characters = 4;
+
+  // Time when the operation was submitted.
+  google.protobuf.Timestamp submit_time = 5;
+}
+
+// Stored in the
+// [google.longrunning.Operation.response][google.longrunning.Operation.response]
+// field returned by BatchTranslateText if at least one sentence is translated
+// successfully.
+message BatchTranslateResponse {
+  // Total number of characters (Unicode codepoints).
+  int64 total_characters = 1;
+
+  // Number of successfully translated characters (Unicode codepoints).
+  int64 translated_characters = 2;
+
+  // Number of characters that have failed to process (Unicode codepoints).
+  int64 failed_characters = 3;
+
+  // Time when the operation was submitted.
+  google.protobuf.Timestamp submit_time = 4;
+
+  // The time when the operation is finished and
+  // [google.longrunning.Operation.done][google.longrunning.Operation.done] is
+  // set to true.
+  google.protobuf.Timestamp end_time = 5;
+}
+
+// Input configuration for glossaries.
+message GlossaryInputConfig {
+  // Required. Specify the input.
+  oneof source {
+    // Required. Google Cloud Storage location of glossary data.
+    // File format is determined based on the filename extension. API returns
+    // [google.rpc.Code.INVALID_ARGUMENT] for unsupported URI-s and file
+    // formats. Wildcards are not allowed. This must be a single file in one of
+    // the following formats:
+    //
+    // For unidirectional glossaries:
+    //
+    // - TSV/CSV (`.tsv`/`.csv`): 2 column file, tab- or comma-separated.
+    //   The first column is source text. The second column is target text.
+    //   The file must not contain headers. That is, the first row is data, not
+    //   column names.
+    //
+    // - TMX (`.tmx`): TMX file with parallel data defining source/target term
+    // pairs.
+    //
+    // For equivalent term sets glossaries:
+    //
+    // - CSV (`.csv`): Multi-column CSV file defining equivalent glossary terms
+    //   in multiple languages. The format is defined for Google Translation
+    //   Toolkit and documented in [Use a
+    //   glossary](https://support.google.com/translatortoolkit/answer/6306379?hl=en).
+    GcsSource gcs_source = 1;
+  }
+}
+
+// Represents a glossary built from user provided data.
+message Glossary {
+  option (google.api.resource) = {
+    type: "translate.googleapis.com/Glossary"
+    pattern: "projects/{project}/locations/{location}/glossaries/{glossary}"
+  };
+
+  // Used with unidirectional glossaries.
+  message LanguageCodePair {
+    // Required. The BCP-47 language code of the input text, for example,
+    // "en-US". Expected to be an exact match for GlossaryTerm.language_code.
+    string source_language_code = 1;
+
+    // Required. The BCP-47 language code for translation output, for example,
+    // "zh-CN". Expected to be an exact match for GlossaryTerm.language_code.
+    string target_language_code = 2;
+  }
+
+  // Used with equivalent term set glossaries.
+  message LanguageCodesSet {
+    // The BCP-47 language code(s) for terms defined in the glossary.
+    // All entries are unique. The list contains at least two entries.
+    // Expected to be an exact match for GlossaryTerm.language_code.
+    repeated string language_codes = 1;
+  }
+
+  // Required. The resource name of the glossary. Glossary names have the form
+  // `projects/{project-number-or-id}/locations/{location-id}/glossaries/{glossary-id}`.
+  string name = 1;
+
+  // Languages supported by the glossary.
+  oneof languages {
+    // Used with unidirectional glossaries.
+    LanguageCodePair language_pair = 3;
+
+    // Used with equivalent term set glossaries.
+    LanguageCodesSet language_codes_set = 4;
+  }
+
+  // Required. Provides examples to build the glossary from.
+  // Total glossary must not exceed 10M Unicode codepoints.
+  GlossaryInputConfig input_config = 5;
+
+  // Output only. The number of entries defined in the glossary.
+  int32 entry_count = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. When CreateGlossary was called.
+  google.protobuf.Timestamp submit_time = 7
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. When the glossary creation was finished.
+  google.protobuf.Timestamp end_time = 8
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// Request message for CreateGlossary.
+message CreateGlossaryRequest {
+  // Required. The project name.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // Required. The glossary to create.
+  Glossary glossary = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for GetGlossary.
+message GetGlossaryRequest {
+  // Required. The name of the glossary to retrieve.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "translate.googleapis.com/Glossary"
+    }
+  ];
+}
+
+// Request message for DeleteGlossary.
+message DeleteGlossaryRequest {
+  // Required. The name of the glossary to delete.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "translate.googleapis.com/Glossary"
+    }
+  ];
+}
+
+// Request message for ListGlossaries.
+message ListGlossariesRequest {
+  // Required. The name of the project from which to list all of the glossaries.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // Optional. Requested page size. The server may return fewer glossaries than
+  // requested. If unspecified, the server picks an appropriate default.
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A token identifying a page of results the server should return.
+  // Typically, this is the value of [ListGlossariesResponse.next_page_token]
+  // returned from the previous call to `ListGlossaries` method.
+  // The first page is returned if `page_token`is empty or missing.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Filter specifying constraints of a list operation.
+  // Filtering is not supported yet, and the parameter currently has no effect.
+  // If missing, no filtering is performed.
+  string filter = 4 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Response message for ListGlossaries.
+message ListGlossariesResponse {
+  // The list of glossaries for a project.
+  repeated Glossary glossaries = 1;
+
+  // A token to retrieve a page of results. Pass this value in the
+  // [ListGlossariesRequest.page_token] field in the subsequent call to
+  // `ListGlossaries` method to retrieve the next page of results.
+  string next_page_token = 2;
+}
+
+// Stored in the
+// [google.longrunning.Operation.metadata][google.longrunning.Operation.metadata]
+// field returned by CreateGlossary.
+message CreateGlossaryMetadata {
+  // Enumerates the possible states that the creation request can be in.
+  enum State {
+    // Invalid.
+    STATE_UNSPECIFIED = 0;
+
+    // Request is being processed.
+    RUNNING = 1;
+
+    // The glossary was successfully created.
+    SUCCEEDED = 2;
+
+    // Failed to create the glossary.
+    FAILED = 3;
+
+    // Request is in the process of being canceled after caller invoked
+    // longrunning.Operations.CancelOperation on the request id.
+    CANCELLING = 4;
+
+    // The glossary creation request was successfully canceled.
+    CANCELLED = 5;
+  }
+
+  // The name of the glossary that is being created.
+  string name = 1;
+
+  // The current state of the glossary creation operation.
+  State state = 2;
+
+  // The time when the operation was submitted to the server.
+  google.protobuf.Timestamp submit_time = 3;
+}
+
+// Stored in the
+// [google.longrunning.Operation.metadata][google.longrunning.Operation.metadata]
+// field returned by DeleteGlossary.
+message DeleteGlossaryMetadata {
+  // Enumerates the possible states that the creation request can be in.
+  enum State {
+    // Invalid.
+    STATE_UNSPECIFIED = 0;
+
+    // Request is being processed.
+    RUNNING = 1;
+
+    // The glossary was successfully deleted.
+    SUCCEEDED = 2;
+
+    // Failed to delete the glossary.
+    FAILED = 3;
+
+    // Request is in the process of being canceled after caller invoked
+    // longrunning.Operations.CancelOperation on the request id.
+    CANCELLING = 4;
+
+    // The glossary deletion request was successfully canceled.
+    CANCELLED = 5;
+  }
+
+  // The name of the glossary that is being deleted.
+  string name = 1;
+
+  // The current state of the glossary deletion operation.
+  State state = 2;
+
+  // The time when the operation was submitted to the server.
+  google.protobuf.Timestamp submit_time = 3;
+}
+
+// Stored in the
+// [google.longrunning.Operation.response][google.longrunning.Operation.response]
+// field returned by DeleteGlossary.
+message DeleteGlossaryResponse {
+  // The name of the deleted glossary.
+  string name = 1;
+
+  // The time when the operation was submitted to the server.
+  google.protobuf.Timestamp submit_time = 2;
+
+  // The time when the glossary deletion is finished and
+  // [google.longrunning.Operation.done][google.longrunning.Operation.done] is
+  // set to true.
+  google.protobuf.Timestamp end_time = 3;
+}
diff --git a/third_party/googleapis/google/cloud/translate/v3beta1/BUILD.bazel b/third_party/googleapis/google/cloud/translate/v3beta1/BUILD.bazel
new file mode 100644
index 000000000..0de75e280
--- /dev/null
+++ b/third_party/googleapis/google/cloud/translate/v3beta1/BUILD.bazel
@@ -0,0 +1,365 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "translation_proto",
+    srcs = [
+        "translation_service.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "translation_proto_with_info",
+    deps = [
+        ":translation_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "translation_java_proto",
+    deps = [":translation_proto"],
+)
+
+java_grpc_library(
+    name = "translation_java_grpc",
+    srcs = [":translation_proto"],
+    deps = [":translation_java_proto"],
+)
+
+java_gapic_library(
+    name = "translation_java_gapic",
+    src = ":translation_proto_with_info",
+    gapic_yaml = "translate_gapic.yaml",
+    package = "google.cloud.translation.v3beta1",
+    service_yaml = "translate_v3beta1.yaml",
+    test_deps = [
+        ":translation_java_grpc",
+    ],
+    deps = [
+        ":translation_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "translation_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.translate.v3beta1.TranslationServiceClientTest",
+    ],
+    runtime_deps = [":translation_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-translation-v3beta1-java",
+    deps = [
+        ":translation_java_gapic",
+        ":translation_java_grpc",
+        ":translation_java_proto",
+        ":translation_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "translation_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/translate/v3beta1",
+    protos = [":translation_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/longrunning:longrunning_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "translation_go_gapic",
+    srcs = [":translation_proto_with_info"],
+    grpc_service_config = "translate_grpc_service_config.json",
+    importpath = "cloud.google.com/go/translate/apiv3beta1;translate",
+    service_yaml = "translate_v3beta1.yaml",
+    deps = [
+        ":translation_go_proto",
+        "//google/longrunning:longrunning_go_gapic",
+        "//google/longrunning:longrunning_go_proto",
+        "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
+    ],
+)
+
+go_test(
+    name = "translation_go_gapic_test",
+    srcs = [":translation_go_gapic_srcjar_test"],
+    embed = [":translation_go_gapic"],
+    importpath = "cloud.google.com/go/translate/apiv3beta1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-translation-v3beta1-go",
+    deps = [
+        ":translation_go_gapic",
+        ":translation_go_gapic_srcjar-test.srcjar",
+        ":translation_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "translation_moved_proto",
+    srcs = [":translation_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "translation_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":translation_moved_proto"],
+)
+
+py_grpc_library(
+    name = "translation_py_grpc",
+    srcs = [":translation_moved_proto"],
+    deps = [":translation_py_proto"],
+)
+
+py_gapic_library(
+    name = "translation_py_gapic",
+    src = ":translation_proto_with_info",
+    gapic_yaml = "translate_gapic.yaml",
+    package = "google.cloud.translation.v3beta1",
+    service_yaml = "translate_v3beta1.yaml",
+    deps = [
+        ":translation_py_grpc",
+        ":translation_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "translation-v3beta1-py",
+    deps = [
+        ":translation_py_gapic",
+        ":translation_py_grpc",
+        ":translation_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "translation_php_proto",
+    deps = [":translation_proto"],
+)
+
+php_grpc_library(
+    name = "translation_php_grpc",
+    srcs = [":translation_proto"],
+    deps = [":translation_php_proto"],
+)
+
+php_gapic_library(
+    name = "translation_php_gapic",
+    src = ":translation_proto_with_info",
+    gapic_yaml = "translate_gapic.yaml",
+    package = "google.cloud.translation.v3beta1",
+    service_yaml = "translate_v3beta1.yaml",
+    deps = [
+        ":translation_php_grpc",
+        ":translation_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-translation-v3beta1-php",
+    deps = [
+        ":translation_php_gapic",
+        ":translation_php_grpc",
+        ":translation_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "translation_nodejs_gapic",
+    src = ":translation_proto_with_info",
+    gapic_yaml = "translate_gapic.yaml",
+    package = "google.cloud.translation.v3beta1",
+    service_yaml = "translate_v3beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "translation-v3beta1-nodejs",
+    deps = [
+        ":translation_nodejs_gapic",
+        ":translation_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "translation_ruby_proto",
+    deps = [":translation_proto"],
+)
+
+ruby_grpc_library(
+    name = "translation_ruby_grpc",
+    srcs = [":translation_proto"],
+    deps = [":translation_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "translation_ruby_gapic",
+    src = ":translation_proto_with_info",
+    gapic_yaml = "translate_gapic.yaml",
+    package = "google.cloud.translation.v3beta1",
+    service_yaml = "translate_v3beta1.yaml",
+    deps = [
+        ":translation_ruby_grpc",
+        ":translation_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-translation-v3beta1-ruby",
+    deps = [
+        ":translation_ruby_gapic",
+        ":translation_ruby_grpc",
+        ":translation_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "translation_csharp_proto",
+    deps = [":translation_proto"],
+)
+
+csharp_grpc_library(
+    name = "translation_csharp_grpc",
+    srcs = [":translation_proto"],
+    deps = [":translation_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "translation_csharp_gapic",
+    src = ":translation_proto_with_info",
+    gapic_yaml = "translate_gapic.yaml",
+    package = "google.cloud.translation.v3beta1",
+    service_yaml = "translate_v3beta1.yaml",
+    deps = [
+        ":translation_csharp_grpc",
+        ":translation_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-translation-v3beta1-csharp",
+    deps = [
+        ":translation_csharp_gapic",
+        ":translation_csharp_grpc",
+        ":translation_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/translate/v3beta1/translate_gapic.legacy.yaml b/third_party/googleapis/google/cloud/translate/v3beta1/translate_gapic.legacy.yaml
new file mode 100644
index 000000000..5a4e25638
--- /dev/null
+++ b/third_party/googleapis/google/cloud/translate/v3beta1/translate_gapic.legacy.yaml
@@ -0,0 +1,235 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.translate.v3beta1
+  python:
+    package_name: google.cloud.translate_v3beta1.gapic
+  go:
+    package_name: cloud.google.com/go/translate/apiv3beta1
+  csharp:
+    package_name: Google.Cloud.Translate.V3Beta1
+  ruby:
+    package_name: Google::Cloud::Translate::V3beta1
+  php:
+    package_name: Google\Cloud\Translate\V3beta1
+  nodejs:
+    package_name: translate.v3beta1
+    domain_layer_location: google-cloud
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: google.cloud.translation.v3beta1.TranslationService
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}/locations/{location}
+    entity_name: location
+  - name_pattern: projects/{project}/locations/{location}/glossaries/{glossary}
+    entity_name: glossary
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: TranslateText
+    required_fields:
+    - contents
+    - target_language_code
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 60000
+  - name: DetectLanguage
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - model
+        - mime_type
+    required_fields:
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 60000
+  - name: GetSupportedLanguages
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - display_language_code
+        - model
+    required_fields:
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 60000
+  - name: BatchTranslateText
+    required_fields:
+    - source_language_code
+    - target_language_codes
+    - input_configs
+    - output_config
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    long_running:
+      return_type: google.cloud.translation.v3beta1.BatchTranslateResponse
+      metadata_type: google.cloud.translation.v3beta1.BatchTranslateMetadata
+      initial_poll_delay_millis: 500
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 5000
+      total_poll_timeout_millis: 300000
+    timeout_millis: 60000
+  - name: CreateGlossary
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - glossary
+    required_fields:
+    - parent
+    - glossary
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    long_running:
+      return_type: google.cloud.translation.v3beta1.Glossary
+      metadata_type: google.cloud.translation.v3beta1.CreateGlossaryMetadata
+      initial_poll_delay_millis: 500
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 5000
+      total_poll_timeout_millis: 300000
+    timeout_millis: 60000
+  - name: ListGlossaries
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - filter
+    required_fields:
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: glossaries
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 60000
+  - name: GetGlossary
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: glossary
+    timeout_millis: 60000
+  - name: DeleteGlossary
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: glossary
+    long_running:
+      return_type: google.cloud.translation.v3beta1.DeleteGlossaryResponse
+      metadata_type: google.cloud.translation.v3beta1.DeleteGlossaryMetadata
+      initial_poll_delay_millis: 500
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 5000
+      total_poll_timeout_millis: 300000
+    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/translate/v3beta1/translate_gapic.yaml b/third_party/googleapis/google/cloud/translate/v3beta1/translate_gapic.yaml
index 5a4e25638..56858501a 100644
--- a/third_party/googleapis/google/cloud/translate/v3beta1/translate_gapic.yaml
+++ b/third_party/googleapis/google/cloud/translate/v3beta1/translate_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -17,219 +17,8 @@ language_settings:
   nodejs:
     package_name: translate.v3beta1
     domain_layer_location: google-cloud
-# A list of API interface configurations.
 interfaces:
-# The fully qualified name of the API interface.
 - name: google.cloud.translation.v3beta1.TranslationService
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections:
-  - name_pattern: projects/{project}/locations/{location}
-    entity_name: location
-  - name_pattern: projects/{project}/locations/{location}/glossaries/{glossary}
-    entity_name: glossary
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
   methods:
-  - name: TranslateText
-    required_fields:
-    - contents
-    - target_language_code
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    timeout_millis: 60000
-  - name: DetectLanguage
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - model
-        - mime_type
-    required_fields:
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    timeout_millis: 60000
-  - name: GetSupportedLanguages
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - display_language_code
-        - model
-    required_fields:
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    timeout_millis: 60000
-  - name: BatchTranslateText
-    required_fields:
-    - source_language_code
-    - target_language_codes
-    - input_configs
-    - output_config
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    long_running:
-      return_type: google.cloud.translation.v3beta1.BatchTranslateResponse
-      metadata_type: google.cloud.translation.v3beta1.BatchTranslateMetadata
-      initial_poll_delay_millis: 500
-      poll_delay_multiplier: 1.5
-      max_poll_delay_millis: 5000
-      total_poll_timeout_millis: 300000
-    timeout_millis: 60000
-  - name: CreateGlossary
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - glossary
-    required_fields:
-    - parent
-    - glossary
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    long_running:
-      return_type: google.cloud.translation.v3beta1.Glossary
-      metadata_type: google.cloud.translation.v3beta1.CreateGlossaryMetadata
-      initial_poll_delay_millis: 500
-      poll_delay_multiplier: 1.5
-      max_poll_delay_millis: 5000
-      total_poll_timeout_millis: 300000
-    timeout_millis: 60000
-  - name: ListGlossaries
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - filter
-    required_fields:
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: glossaries
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    timeout_millis: 60000
-  - name: GetGlossary
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: glossary
-    timeout_millis: 60000
   - name: DeleteGlossary
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: glossary
-    long_running:
-      return_type: google.cloud.translation.v3beta1.DeleteGlossaryResponse
-      metadata_type: google.cloud.translation.v3beta1.DeleteGlossaryMetadata
-      initial_poll_delay_millis: 500
-      poll_delay_multiplier: 1.5
-      max_poll_delay_millis: 5000
-      total_poll_timeout_millis: 300000
-    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/translate/v3beta1/translate_grpc_service_config.json b/third_party/googleapis/google/cloud/translate/v3beta1/translate_grpc_service_config.json
new file mode 100755
index 000000000..2c5292bef
--- /dev/null
+++ b/third_party/googleapis/google/cloud/translate/v3beta1/translate_grpc_service_config.json
@@ -0,0 +1,55 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.translation.v3beta1.TranslationService",
+          "method": "TranslateText"
+        },
+        {
+          "service": "google.cloud.translation.v3beta1.TranslationService",
+          "method": "DetectLanguage"
+        },
+        {
+          "service": "google.cloud.translation.v3beta1.TranslationService",
+          "method": "BatchTranslateText"
+        },
+        {
+          "service": "google.cloud.translation.v3beta1.TranslationService",
+          "method": "CreateGlossary"
+        }
+      ],
+      "timeout": "600s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.translation.v3beta1.TranslationService",
+          "method": "GetSupportedLanguages"
+        },
+        {
+          "service": "google.cloud.translation.v3beta1.TranslationService",
+          "method": "ListGlossaries"
+        },
+        {
+          "service": "google.cloud.translation.v3beta1.TranslationService",
+          "method": "GetGlossary"
+        },
+        {
+          "service": "google.cloud.translation.v3beta1.TranslationService",
+          "method": "DeleteGlossary"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/translate/v3beta1/translate_v3beta1.yaml b/third_party/googleapis/google/cloud/translate/v3beta1/translate_v3beta1.yaml
new file mode 100644
index 000000000..7b1e8a0c8
--- /dev/null
+++ b/third_party/googleapis/google/cloud/translate/v3beta1/translate_v3beta1.yaml
@@ -0,0 +1,44 @@
+type: google.api.Service
+config_version: 3
+name: translate.googleapis.com
+title: Cloud Translation API
+
+apis:
+- name: google.cloud.translation.v3beta1.TranslationService
+
+documentation:
+  summary: Integrates text translation into your website or application.
+
+backend:
+  rules:
+  - selector: 'google.longrunning.Operations.*'
+    deadline: 60.0
+  - selector: google.longrunning.Operations.WaitOperation
+    deadline: 120.0
+
+http:
+  rules:
+  - selector: google.longrunning.Operations.WaitOperation
+    post: '/v3beta1/{name=projects/*/locations/*/operations/*}:wait'
+    body: '*'
+
+authentication:
+  rules:
+  - selector: 'google.cloud.translation.v3beta1.TranslationService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-translation
+  - selector: google.cloud.translation.v3beta1.TranslationService.BatchTranslateText
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: google.cloud.translation.v3beta1.TranslationService.CreateGlossary
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-translation
diff --git a/third_party/googleapis/google/cloud/translate/v3beta1/translation_service.proto b/third_party/googleapis/google/cloud/translate/v3beta1/translation_service.proto
index fa20f0169..e62a50883 100644
--- a/third_party/googleapis/google/cloud/translate/v3beta1/translation_service.proto
+++ b/third_party/googleapis/google/cloud/translate/v3beta1/translation_service.proto
@@ -18,10 +18,11 @@ syntax = "proto3";
 package google.cloud.translation.v3beta1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/timestamp.proto";
-import "google/api/client.proto";
 
 option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.Translate.V3Beta1";
@@ -36,7 +37,10 @@ option ruby_package = "Google::Cloud::Translate::V3beta1";
 
 // Provides natural language translation operations.
 service TranslationService {
-  option (google.api.default_host) = "translation.googleapis.com";
+  option (google.api.default_host) = "translate.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/cloud-translation";
 
   // Translates input text and returns translated text.
   rpc TranslateText(TranslateTextRequest) returns (TranslateTextResponse) {
@@ -60,6 +64,7 @@ service TranslationService {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "parent,model,mime_type";
   }
 
   // Returns a list of supported languages for translation.
@@ -70,6 +75,7 @@ service TranslationService {
         get: "/v3beta1/{parent=projects/*}/supportedLanguages"
       }
     };
+    option (google.api.method_signature) = "parent,display_language_code,model";
   }
 
   // Translates a large volume of text in asynchronous batch mode.
@@ -84,6 +90,10 @@ service TranslationService {
       post: "/v3beta1/{parent=projects/*/locations/*}:batchTranslateText"
       body: "*"
     };
+    option (google.longrunning.operation_info) = {
+      response_type: "BatchTranslateResponse"
+      metadata_type: "BatchTranslateMetadata"
+    };
   }
 
   // Creates a glossary and returns the long-running operation. Returns
@@ -93,6 +103,11 @@ service TranslationService {
       post: "/v3beta1/{parent=projects/*/locations/*}/glossaries"
       body: "glossary"
     };
+    option (google.api.method_signature) = "parent,glossary";
+    option (google.longrunning.operation_info) = {
+      response_type: "Glossary"
+      metadata_type: "CreateGlossaryMetadata"
+    };
   }
 
   // Lists glossaries in a project. Returns NOT_FOUND, if the project doesn't
@@ -101,6 +116,8 @@ service TranslationService {
     option (google.api.http) = {
       get: "/v3beta1/{parent=projects/*/locations/*}/glossaries"
     };
+    option (google.api.method_signature) = "parent";
+    option (google.api.method_signature) = "parent,filter";
   }
 
   // Gets a glossary. Returns NOT_FOUND, if the glossary doesn't
@@ -109,6 +126,7 @@ service TranslationService {
     option (google.api.http) = {
       get: "/v3beta1/{name=projects/*/locations/*/glossaries/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Deletes a glossary, or cancels glossary construction
@@ -118,6 +136,11 @@ service TranslationService {
     option (google.api.http) = {
       delete: "/v3beta1/{name=projects/*/locations/*/glossaries/*}"
     };
+    option (google.api.method_signature) = "name";
+    option (google.longrunning.operation_info) = {
+      response_type: "DeleteGlossaryResponse"
+      metadata_type: "DeleteGlossaryMetadata"
+    };
   }
 }
 
@@ -126,11 +149,11 @@ service TranslationService {
 message TranslateTextGlossaryConfig {
   // Required. Specifies the glossary used for this translation. Use
   // this format: projects/*/locations/*/glossaries/*
-  string glossary = 1;
+  string glossary = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Optional. Indicates match is case-insensitive.
   // Default value is false if missing.
-  bool ignore_case = 2;
+  bool ignore_case = 2 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // The request message for synchronous translation.
@@ -138,32 +161,43 @@ message TranslateTextRequest {
   // Required. The content of the input in string format.
   // We recommend the total content be less than 30k codepoints.
   // Use BatchTranslateText for larger text.
-  repeated string contents = 1;
+  repeated string contents = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Optional. The format of the source text, for example, "text/html",
   //  "text/plain". If left blank, the MIME type defaults to "text/html".
-  string mime_type = 3;
+  string mime_type = 3 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The BCP-47 language code of the input text if
   // known, for example, "en-US" or "sr-Latn". Supported language codes are
   // listed in Language Support. If the source language isn't specified, the API
   // attempts to identify the source language automatically and returns the
   // source language within the response.
-  string source_language_code = 4;
+  string source_language_code = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Required. The BCP-47 language code to use for translation of the input
   // text, set to one of the language codes listed in Language Support.
-  string target_language_code = 5;
+  string target_language_code = 5 [(google.api.field_behavior) = REQUIRED];
 
-  // Required. Location to make a regional or global call.
+  // Required. Project or location to make a call. Must refer to a caller's
+  // project.
   //
-  // Format: `projects/{project-id}/locations/{location-id}`.
+  // Format: `projects/{project-id}` or
+  // `projects/{project-id}/locations/{location-id}`.
   //
-  // For global calls, use `projects/{project-id}/locations/global`.
+  // For global calls, use `projects/{project-id}/locations/global` or
+  // `projects/{project-id}`.
+  //
+  // Non-global location is required for requests using AutoML models or
+  // custom glossaries.
   //
   // Models and glossaries must be within the same region (have same
   // location-id), otherwise an INVALID_ARGUMENT (400) error is returned.
-  string parent = 8;
+  string parent = 8 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
   // Optional. The `model` type requested for this translation.
   //
@@ -182,12 +216,22 @@ message TranslateTextRequest {
   // `projects/{project-id}/locations/global/models/general/nmt`.
   //
   // If missing, the system decides which google base model to use.
-  string model = 6;
+  string model = 6 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Glossary to be applied. The glossary must be
   // within the same region (have the same location-id) as the model, otherwise
   // an INVALID_ARGUMENT (400) error is returned.
-  TranslateTextGlossaryConfig glossary_config = 7;
+  TranslateTextGlossaryConfig glossary_config = 7 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The labels with user-defined metadata for the request.
+  //
+  // Label keys and values can be no longer than 63 characters
+  // (Unicode codepoints), can only contain lowercase letters, numeric
+  // characters, underscores and dashes. International characters are allowed.
+  // Label values are optional. Label keys must start with a letter.
+  //
+  // See https://cloud.google.com/translate/docs/labels for more information.
+  map labels = 10 [(google.api.field_behavior) = OPTIONAL];
 }
 
 message TranslateTextResponse {
@@ -225,15 +269,23 @@ message Translation {
 
 // The request message for language detection.
 message DetectLanguageRequest {
-  // Required. Location to make a regional or global call.
+  // Required. Project or location to make a call. Must refer to a caller's
+  // project.
   //
-  // Format: `projects/{project-id}/locations/{location-id}`.
+  // Format: `projects/{project-id}/locations/{location-id}` or
+  // `projects/{project-id}`.
   //
-  // For global calls, use `projects/{project-id}/locations/global`.
+  // For global calls, use `projects/{project-id}/locations/global` or
+  // `projects/{project-id}`.
   //
   // Only models within the same region (has same location-id) can be used.
   // Otherwise an INVALID_ARGUMENT (400) error is returned.
-  string parent = 5;
+  string parent = 5 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
   // Optional. The language detection model to be used.
   //
@@ -244,7 +296,7 @@ message DetectLanguageRequest {
   // `projects/{project-id}/locations/{location-id}/models/language-detection/default`.
   //
   // If not specified, the default model is used.
-  string model = 4;
+  string model = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Required. The source of the document from which to detect the language.
   oneof source {
@@ -254,7 +306,17 @@ message DetectLanguageRequest {
 
   // Optional. The format of the source text, for example, "text/html",
   // "text/plain". If left blank, the MIME type defaults to "text/html".
-  string mime_type = 3;
+  string mime_type = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The labels with user-defined metadata for the request.
+  //
+  // Label keys and values can be no longer than 63 characters
+  // (Unicode codepoints), can only contain lowercase letters, numeric
+  // characters, underscores and dashes. International characters are allowed.
+  // Label values are optional. Label keys must start with a letter.
+  //
+  // See https://cloud.google.com/translate/docs/labels for more information.
+  map labels = 6;
 }
 
 // The response message for language detection.
@@ -276,20 +338,30 @@ message DetectLanguageResponse {
 
 // The request message for discovering supported languages.
 message GetSupportedLanguagesRequest {
-  // Required. Location to make a regional or global call.
+  // Required. Project or location to make a call. Must refer to a caller's
+  // project.
   //
-  // Format: `projects/{project-id}/locations/{location-id}`.
+  // Format: `projects/{project-id}` or
+  // `projects/{project-id}/locations/{location-id}`.
   //
-  // For global calls, use `projects/{project-id}/locations/global`.
+  // For global calls, use `projects/{project-id}/locations/global` or
+  // `projects/{project-id}`.
+  //
+  // Non-global location is required for AutoML models.
   //
   // Only models within the same region (have same location-id) can be used,
   // otherwise an INVALID_ARGUMENT (400) error is returned.
-  string parent = 3;
+  string parent = 3 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
   // Optional. The language to use to return localized, human readable names
   // of supported languages. If missing, then display names are not returned
   // in a response.
-  string display_language_code = 1;
+  string display_language_code = 1 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Get supported languages of this model.
   //
@@ -305,7 +377,7 @@ message GetSupportedLanguagesRequest {
   //
   // Returns languages supported by the specified model.
   // If missing, we get supported languages of Google general base (PBMT) model.
-  string model = 2;
+  string model = 2 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // The response message for discovering supported languages.
@@ -338,7 +410,7 @@ message SupportedLanguage {
 // The Google Cloud Storage location for the input content.
 message GcsSource {
   // Required. Source data URI. For example, `gs://my_bucket/my_object`.
-  string input_uri = 1;
+  string input_uri = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Input configuration for BatchTranslateText request.
@@ -347,7 +419,7 @@ message InputConfig {
   // For `.tsv`, "text/html" is used if mime_type is missing.
   // For `.html`, this field must be "text/html" or empty.
   // For `.txt`, this field must be "text/plain" or empty.
-  string mime_type = 1;
+  string mime_type = 1 [(google.api.field_behavior) = OPTIONAL];
 
   // Required. Specify the input.
   oneof source {
@@ -373,12 +445,12 @@ message InputConfig {
   }
 }
 
-// The Google Cloud Storage location for the output content
+// The Google Cloud Storage location for the output content.
 message GcsDestination {
   // Required. There must be no files under 'output_uri_prefix'.
-  // 'output_uri_prefix' must end with "/", otherwise an INVALID_ARGUMENT (400)
-  // error is returned..
-  string output_uri_prefix = 1;
+  // 'output_uri_prefix' must end with "/" and start with "gs://", otherwise an
+  // INVALID_ARGUMENT (400) error is returned.
+  string output_uri_prefix = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Output configuration for BatchTranslateText request.
@@ -457,7 +529,7 @@ message OutputConfig {
 
 // The batch translation request.
 message BatchTranslateTextRequest {
-  // Required. Location to make a regional call.
+  // Required. Location to make a call. Must refer to a caller's project.
   //
   // Format: `projects/{project-id}/locations/{location-id}`.
   //
@@ -466,13 +538,18 @@ message BatchTranslateTextRequest {
   // Only AutoML Translation models or glossaries within the same region (have
   // the same location-id) can be used, otherwise an INVALID_ARGUMENT (400)
   // error is returned.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
   // Required. Source language code.
-  string source_language_code = 2;
+  string source_language_code = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Required. Specify up to 10 language codes here.
-  repeated string target_language_codes = 3;
+  repeated string target_language_codes = 3 [(google.api.field_behavior) = REQUIRED];
 
   // Optional. The models to use for translation. Map's key is target language
   // code. Map's value is model name. Value can be a built-in general model,
@@ -490,22 +567,32 @@ message BatchTranslateTextRequest {
   //
   // If the map is empty or a specific model is
   // not requested for a language pair, then default google model (nmt) is used.
-  map models = 4;
+  map models = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Required. Input configurations.
   // The total number of files matched should be <= 1000.
   // The total content size should be <= 100M Unicode codepoints.
   // The files must use UTF-8 encoding.
-  repeated InputConfig input_configs = 5;
+  repeated InputConfig input_configs = 5 [(google.api.field_behavior) = REQUIRED];
 
   // Required. Output configuration.
   // If 2 input configs match to the same file (that is, same input path),
   // we don't generate output for duplicate inputs.
-  OutputConfig output_config = 6;
+  OutputConfig output_config = 6 [(google.api.field_behavior) = REQUIRED];
 
   // Optional. Glossaries to be applied for translation.
   // It's keyed by target language code.
-  map glossaries = 7;
+  map glossaries = 7 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The labels with user-defined metadata for the request.
+  //
+  // Label keys and values can be no longer than 63 characters
+  // (Unicode codepoints), can only contain lowercase letters, numeric
+  // characters, underscores and dashes. International characters are allowed.
+  // Label values are optional. Label keys must start with a letter.
+  //
+  // See https://cloud.google.com/translate/docs/labels for more information.
+  map labels = 9 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // State metadata for the batch translation operation.
@@ -606,6 +693,11 @@ message GlossaryInputConfig {
 
 // Represents a glossary built from user provided data.
 message Glossary {
+  option (google.api.resource) = {
+    type: "translate.googleapis.com/Glossary"
+    pattern: "projects/{project}/locations/{location}/glossaries/{glossary}"
+  };
+
   // Used with unidirectional glossaries.
   message LanguageCodePair {
     // Required. The BCP-47 language code of the input text, for example,
@@ -627,7 +719,7 @@ message Glossary {
 
   // Required. The resource name of the glossary. Glossary names have the form
   // `projects/{project-id}/locations/{location-id}/glossaries/{glossary-id}`.
-  string name = 1;
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Languages supported by the glossary.
   oneof languages {
@@ -643,55 +735,75 @@ message Glossary {
   GlossaryInputConfig input_config = 5;
 
   // Output only. The number of entries defined in the glossary.
-  int32 entry_count = 6;
+  int32 entry_count = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. When CreateGlossary was called.
-  google.protobuf.Timestamp submit_time = 7;
+  google.protobuf.Timestamp submit_time = 7 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. When the glossary creation was finished.
-  google.protobuf.Timestamp end_time = 8;
+  google.protobuf.Timestamp end_time = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Request message for CreateGlossary.
 message CreateGlossaryRequest {
   // Required. The project name.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
   // Required. The glossary to create.
-  Glossary glossary = 2;
+  Glossary glossary = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request message for GetGlossary.
 message GetGlossaryRequest {
   // Required. The name of the glossary to retrieve.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "translate.googleapis.com/Glossary"
+    }
+  ];
 }
 
 // Request message for DeleteGlossary.
 message DeleteGlossaryRequest {
   // Required. The name of the glossary to delete.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "translate.googleapis.com/Glossary"
+    }
+  ];
 }
 
 // Request message for ListGlossaries.
 message ListGlossariesRequest {
   // Required. The name of the project from which to list all of the glossaries.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
   // Optional. Requested page size. The server may return fewer glossaries than
   // requested. If unspecified, the server picks an appropriate default.
-  int32 page_size = 2;
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. A token identifying a page of results the server should return.
   // Typically, this is the value of [ListGlossariesResponse.next_page_token]
   // returned from the previous call to `ListGlossaries` method.
   // The first page is returned if `page_token`is empty or missing.
-  string page_token = 3;
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Filter specifying constraints of a list operation.
   // Filtering is not supported yet, and the parameter currently has no effect.
   // If missing, no filtering is performed.
-  string filter = 4;
+  string filter = 4 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response message for ListGlossaries.
diff --git a/third_party/googleapis/google/cloud/videointelligence/artman_videointelligence_v1.legacy.yaml b/third_party/googleapis/google/cloud/videointelligence/artman_videointelligence_v1.legacy.yaml
new file mode 100644
index 000000000..aa1c83312
--- /dev/null
+++ b/third_party/googleapis/google/cloud/videointelligence/artman_videointelligence_v1.legacy.yaml
@@ -0,0 +1,15 @@
+common:
+  api_name: video-intelligence
+  api_version: v1
+  organization_name: google-cloud
+  service_yaml: v1/videointelligence_v1.yaml
+  gapic_yaml: v1/videointelligence_gapic.legacy.yaml
+  proto_package: google.cloud.videointelligence.v1
+  src_proto_paths:
+  - v1
+  proto_deps:
+  - name: google-common-protos
+artifacts:
+- name: php_gapic
+  type: GAPIC
+  language: PHP
diff --git a/third_party/googleapis/google/cloud/videointelligence/artman_videointelligence_v1.yaml b/third_party/googleapis/google/cloud/videointelligence/artman_videointelligence_v1.yaml
index 7f9520ad5..8c0af51ea 100644
--- a/third_party/googleapis/google/cloud/videointelligence/artman_videointelligence_v1.yaml
+++ b/third_party/googleapis/google/cloud/videointelligence/artman_videointelligence_v1.yaml
@@ -2,8 +2,9 @@ common:
   api_name: video-intelligence
   api_version: v1
   organization_name: google-cloud
-  service_yaml: videointelligence_v1.yaml
+  service_yaml: v1/videointelligence_v1.yaml
   gapic_yaml: v1/videointelligence_gapic.yaml
+  proto_package: google.cloud.videointelligence.v1
   src_proto_paths:
   - v1
   proto_deps:
@@ -15,9 +16,6 @@ artifacts:
 - name: python_gapic
   type: GAPIC
   language: PYTHON
-- name: php_gapic
-  type: GAPIC
-  language: PHP
 - name: ruby_gapic
   type: GAPIC
   language: RUBY
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1/BUILD.bazel b/third_party/googleapis/google/cloud/videointelligence/v1/BUILD.bazel
index b9a3ca592..06c231fe6 100644
--- a/third_party/googleapis/google/cloud/videointelligence/v1/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/videointelligence/v1/BUILD.bazel
@@ -1,18 +1,23 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
-    name = "video_intelligence_proto",
+    name = "videointelligence_proto",
     srcs = [
         "video_intelligence.proto",
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
         "//google/longrunning:operations_proto",
         "//google/rpc:status_proto",
         "@com_google_protobuf//:duration_proto",
@@ -21,8 +26,11 @@ proto_library(
 )
 
 proto_library_with_info(
-    name = "video_intelligence_proto_with_info",
-    deps = [":video_intelligence_proto"],
+    name = "videointelligence_proto_with_info",
+    deps = [
+        ":videointelligence_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -30,71 +38,55 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
-    name = "video_intelligence_java_proto",
-    deps = [":video_intelligence_proto"],
+    name = "videointelligence_java_proto",
+    deps = [":videointelligence_proto"],
 )
 
 java_grpc_library(
-    name = "video_intelligence_java_grpc",
-    srcs = [":video_intelligence_proto"],
-    deps = [":video_intelligence_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "video_intelligence_resource_name_java_proto",
-    gapic_yaml = "videointelligence_gapic.yaml",
-    deps = [":video_intelligence_proto"],
+    name = "videointelligence_java_grpc",
+    srcs = [":videointelligence_proto"],
+    deps = [":videointelligence_java_proto"],
 )
 
 java_gapic_library(
-    name = "video_intelligence_java_gapic",
-    src = ":video_intelligence_proto_with_info",
+    name = "videointelligence_java_gapic",
+    src = ":videointelligence_proto_with_info",
     gapic_yaml = "videointelligence_gapic.yaml",
-    service_yaml = "//google/cloud/videointelligence:videointelligence_v1.yaml",
-    test_deps = [":video_intelligence_java_grpc"],
+    package = "google.cloud.videointelligence.v1",
+    service_yaml = "videointelligence_v1.yaml",
+    test_deps = [
+        ":videointelligence_java_grpc",
+    ],
     deps = [
-        ":video_intelligence_java_proto",
-        ":video_intelligence_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+        ":videointelligence_java_proto",
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":video_intelligence_java_gapic_test",
+java_gapic_test(
+    name = "videointelligence_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.videointelligence.v1.VideoIntelligenceServiceClientTest",
     ],
-) for test_name in [
-    "com.google.cloud.videointelligence.v1.VideoIntelligenceServiceClientTest",
-]]
+    runtime_deps = [":videointelligence_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
-    name = "google-cloud-video-intelligence-v1-java",
-    client_deps = [":video_intelligence_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":video_intelligence_java_gapic_test"],
-    grpc_deps = [":video_intelligence_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
-        ":video_intelligence_java_proto",
-        ":video_intelligence_proto",
-        ":video_intelligence_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    name = "google-cloud-videointelligence-v1-java",
+    deps = [
+        ":videointelligence_java_gapic",
+        ":videointelligence_java_grpc",
+        ":videointelligence_java_proto",
+        ":videointelligence_proto",
+    ],
 )
 
 ##############################################################################
@@ -102,17 +94,17 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
-    name = "video_intelligence_go_proto",
+    name = "videointelligence_go_proto",
     compilers = ["@io_bazel_rules_go//proto:go_grpc"],
     importpath = "google.golang.org/genproto/googleapis/cloud/videointelligence/v1",
-    protos = [":video_intelligence_proto"],
+    protos = [":videointelligence_proto"],
     deps = [
         "//google/api:annotations_go_proto",
         "//google/longrunning:longrunning_go_proto",
@@ -121,33 +113,258 @@ go_proto_library(
 )
 
 go_gapic_library(
-    name = "video_intelligence_go_gapic",
-    src = ":video_intelligence_proto_with_info",
-    gapic_yaml = "videointelligence_gapic.yaml",
-    importpath = "cloud.google.com/go/videointelligence/apiv1",
-    service_yaml = "//google/cloud/videointelligence:videointelligence_v1.yaml",
+    name = "videointelligence_go_gapic",
+    srcs = [":videointelligence_proto_with_info"],
+    grpc_service_config = "videointelligence_grpc_service_config.json",
+    importpath = "cloud.google.com/go/videointelligence/apiv1;videointelligence",
+    service_yaml = "videointelligence_v1.yaml",
     deps = [
-        ":video_intelligence_go_proto",
+        ":videointelligence_go_proto",
         "//google/longrunning:longrunning_go_gapic",
         "//google/longrunning:longrunning_go_proto",
         "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
     ],
 )
 
 go_test(
-    name = "video_intelligence_go_gapic_test",
-    srcs = [":video_intelligence_go_gapic_srcjar_test"],
-    embed = [":video_intelligence_go_gapic"],
+    name = "videointelligence_go_gapic_test",
+    srcs = [":videointelligence_go_gapic_srcjar_test"],
+    embed = [":videointelligence_go_gapic"],
     importpath = "cloud.google.com/go/videointelligence/apiv1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
-    name = "gapi-cloud-video-intelligence-v1-go",
+    name = "gapi-cloud-videointelligence-v1-go",
+    deps = [
+        ":videointelligence_go_gapic",
+        ":videointelligence_go_gapic_srcjar-test.srcjar",
+        ":videointelligence_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "videointelligence_moved_proto",
+    srcs = [":videointelligence_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/longrunning:operations_proto",
+        "//google/rpc:status_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "videointelligence_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":videointelligence_moved_proto"],
+)
+
+py_grpc_library(
+    name = "videointelligence_py_grpc",
+    srcs = [":videointelligence_moved_proto"],
+    deps = [":videointelligence_py_proto"],
+)
+
+py_gapic_library(
+    name = "videointelligence_py_gapic",
+    src = ":videointelligence_proto_with_info",
+    gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1",
+    service_yaml = "videointelligence_v1.yaml",
+    deps = [
+        ":videointelligence_py_grpc",
+        ":videointelligence_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "videointelligence-v1-py",
+    deps = [
+        ":videointelligence_py_gapic",
+        ":videointelligence_py_grpc",
+        ":videointelligence_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "videointelligence_php_proto",
+    deps = [":videointelligence_proto"],
+)
+
+php_grpc_library(
+    name = "videointelligence_php_grpc",
+    srcs = [":videointelligence_proto"],
+    deps = [":videointelligence_php_proto"],
+)
+
+php_gapic_library(
+    name = "videointelligence_php_gapic",
+    src = ":videointelligence_proto_with_info",
+    #Do NOT override with videointelligence_gapic.yaml
+    gapic_yaml = "videointelligence_gapic.legacy.yaml",
+    package = "google.cloud.videointelligence.v1",
+    service_yaml = "videointelligence_v1.yaml",
+    deps = [
+        ":videointelligence_php_grpc",
+        ":videointelligence_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-videointelligence-v1-php",
     deps = [
-        ":video_intelligence_go_gapic",
-        ":video_intelligence_go_gapic_srcjar-smoke-test.srcjar",
-        ":video_intelligence_go_gapic_srcjar-test.srcjar",
-        ":video_intelligence_go_proto",
+        ":videointelligence_php_gapic",
+        ":videointelligence_php_grpc",
+        ":videointelligence_php_proto",
     ],
 )
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "videointelligence_nodejs_gapic",
+    src = ":videointelligence_proto_with_info",
+    gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1",
+    service_yaml = "videointelligence_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "videointelligence-v1-nodejs",
+    deps = [
+        ":videointelligence_nodejs_gapic",
+        ":videointelligence_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "videointelligence_ruby_proto",
+    deps = [":videointelligence_proto"],
+)
+
+ruby_grpc_library(
+    name = "videointelligence_ruby_grpc",
+    srcs = [":videointelligence_proto"],
+    deps = [":videointelligence_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "videointelligence_ruby_gapic",
+    src = ":videointelligence_proto_with_info",
+    gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1",
+    service_yaml = "videointelligence_v1.yaml",
+    deps = [
+        ":videointelligence_ruby_grpc",
+        ":videointelligence_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-videointelligence-v1-ruby",
+    deps = [
+        ":videointelligence_ruby_gapic",
+        ":videointelligence_ruby_grpc",
+        ":videointelligence_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "videointelligence_csharp_proto",
+    deps = [":videointelligence_proto"],
+)
+
+csharp_grpc_library(
+    name = "videointelligence_csharp_grpc",
+    srcs = [":videointelligence_proto"],
+    deps = [":videointelligence_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "videointelligence_csharp_gapic",
+    src = ":videointelligence_proto_with_info",
+    gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1",
+    service_yaml = "videointelligence_v1.yaml",
+    deps = [
+        ":videointelligence_csharp_grpc",
+        ":videointelligence_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-videointelligence-v1-csharp",
+    deps = [
+        ":videointelligence_csharp_gapic",
+        ":videointelligence_csharp_grpc",
+        ":videointelligence_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1/video_intelligence.proto b/third_party/googleapis/google/cloud/videointelligence/v1/video_intelligence.proto
index ce3d8f8c2..9dcfda55e 100644
--- a/third_party/googleapis/google/cloud/videointelligence/v1/video_intelligence.proto
+++ b/third_party/googleapis/google/cloud/videointelligence/v1/video_intelligence.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,14 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.videointelligence.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
@@ -33,16 +34,23 @@ option ruby_package = "Google::Cloud::VideoIntelligence::V1";
 
 // Service that implements Google Cloud Video Intelligence API.
 service VideoIntelligenceService {
+  option (google.api.default_host) = "videointelligence.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Performs asynchronous video annotation. Progress and results can be
   // retrieved through the `google.longrunning.Operations` interface.
   // `Operation.metadata` contains `AnnotateVideoProgress` (progress).
   // `Operation.response` contains `AnnotateVideoResponse` (results).
-  rpc AnnotateVideo(AnnotateVideoRequest)
-      returns (google.longrunning.Operation) {
+  rpc AnnotateVideo(AnnotateVideoRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v1/videos:annotate"
       body: "*"
     };
+    option (google.api.method_signature) = "input_uri,features";
+    option (google.longrunning.operation_info) = {
+      response_type: "AnnotateVideoResponse"
+      metadata_type: "AnnotateVideoProgress"
+    };
   }
 }
 
@@ -52,10 +60,10 @@ message AnnotateVideoRequest {
   // [Google Cloud Storage](https://cloud.google.com/storage/) URIs are
   // supported, which must be specified in the following format:
   // `gs://bucket-id/object-id` (other URI formats return
-  // [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For
-  // more information, see [Request URIs](/storage/docs/reference-uris). A video
-  // URI may include wildcards in `object-id`, and thus identify multiple
-  // videos. Supported wildcards: '*' to match 0 or more characters;
+  // [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For more information, see
+  // [Request URIs](https://cloud.google.com/storage/docs/request-endpoints).
+  // A video URI may include wildcards in `object-id`, and thus identify
+  // multiple videos. Supported wildcards: '*' to match 0 or more characters;
   // '?' to match 1 character. If unset, the input video should be embedded
   // in the request as `input_content`. If set, `input_content` should be unset.
   string input_uri = 1;
@@ -65,24 +73,24 @@ message AnnotateVideoRequest {
   // If set, `input_uri` should be unset.
   bytes input_content = 6;
 
-  // Requested video annotation features.
-  repeated Feature features = 2;
+  // Required. Requested video annotation features.
+  repeated Feature features = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Additional video context and/or feature-specific parameters.
   VideoContext video_context = 3;
 
-  // Optional location where the output (in JSON format) should be stored.
+  // Optional. Location where the output (in JSON format) should be stored.
   // Currently, only [Google Cloud Storage](https://cloud.google.com/storage/)
   // URIs are supported, which must be specified in the following format:
   // `gs://bucket-id/object-id` (other URI formats return
-  // [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For
-  // more information, see [Request URIs](/storage/docs/reference-uris).
-  string output_uri = 4;
+  // [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For more information, see
+  // [Request URIs](https://cloud.google.com/storage/docs/request-endpoints).
+  string output_uri = 4 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional cloud region where annotation should take place. Supported cloud
+  // Optional. Cloud region where annotation should take place. Supported cloud
   // regions: `us-east1`, `us-west1`, `europe-west1`, `asia-east1`. If no region
   // is specified, a region will be determined based on video file location.
-  string location_id = 5;
+  string location_id = 5 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Video context and/or feature-specific parameters.
@@ -114,6 +122,72 @@ message VideoContext {
   ObjectTrackingConfig object_tracking_config = 13;
 }
 
+// Video annotation feature.
+enum Feature {
+  // Unspecified.
+  FEATURE_UNSPECIFIED = 0;
+
+  // Label detection. Detect objects, such as dog or flower.
+  LABEL_DETECTION = 1;
+
+  // Shot change detection.
+  SHOT_CHANGE_DETECTION = 2;
+
+  // Explicit content detection.
+  EXPLICIT_CONTENT_DETECTION = 3;
+
+  // Human face detection and tracking.
+  FACE_DETECTION = 4;
+
+  // Speech transcription.
+  SPEECH_TRANSCRIPTION = 6;
+
+  // OCR text detection and tracking.
+  TEXT_DETECTION = 7;
+
+  // Object detection and tracking.
+  OBJECT_TRACKING = 9;
+
+  // Logo detection, tracking, and recognition.
+  LOGO_RECOGNITION = 12;
+}
+
+// Label detection mode.
+enum LabelDetectionMode {
+  // Unspecified.
+  LABEL_DETECTION_MODE_UNSPECIFIED = 0;
+
+  // Detect shot-level labels.
+  SHOT_MODE = 1;
+
+  // Detect frame-level labels.
+  FRAME_MODE = 2;
+
+  // Detect both shot-level and frame-level labels.
+  SHOT_AND_FRAME_MODE = 3;
+}
+
+// Bucketized representation of likelihood.
+enum Likelihood {
+  // Unspecified likelihood.
+  LIKELIHOOD_UNSPECIFIED = 0;
+
+  // Very unlikely.
+  VERY_UNLIKELY = 1;
+
+  // Unlikely.
+  UNLIKELY = 2;
+
+  // Possible.
+  POSSIBLE = 3;
+
+  // Likely.
+  LIKELY = 4;
+
+  // Very likely.
+  VERY_LIKELY = 5;
+}
+
 // Config for LABEL_DETECTION.
 message LabelDetectionConfig {
   // What labels should be detected with LABEL_DETECTION, in addition to
@@ -156,9 +230,9 @@ message ShotChangeDetectionConfig {
   string model = 1;
 }
 
-// Config for EXPLICIT_CONTENT_DETECTION.
-message ExplicitContentDetectionConfig {
-  // Model to use for explicit content detection.
+// Config for OBJECT_TRACKING.
+message ObjectTrackingConfig {
+  // Model to use for object tracking.
   // Supported values: "builtin/stable" (the default if unset) and
   // "builtin/latest".
   string model = 1;
@@ -175,9 +249,9 @@ message FaceDetectionConfig {
   bool include_bounding_boxes = 2;
 }
 
-// Config for OBJECT_TRACKING.
-message ObjectTrackingConfig {
-  // Model to use for object tracking.
+// Config for EXPLICIT_CONTENT_DETECTION.
+message ExplicitContentDetectionConfig {
+  // Model to use for explicit content detection.
   // Supported values: "builtin/stable" (the default if unset) and
   // "builtin/latest".
   string model = 1;
@@ -325,20 +399,99 @@ message FaceAnnotation {
   repeated FaceFrame frames = 3;
 }
 
+// For tracking related features.
+// An object at time_offset with attributes, and located with
+// normalized_bounding_box.
+message TimestampedObject {
+  // Normalized Bounding box in a frame, where the object is located.
+  NormalizedBoundingBox normalized_bounding_box = 1;
+
+  // Time-offset, relative to the beginning of the video,
+  // corresponding to the video frame for this object.
+  google.protobuf.Duration time_offset = 2;
+
+  // Optional. The attributes of the object in the bounding box.
+  repeated DetectedAttribute attributes = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The detected landmarks.
+  repeated DetectedLandmark landmarks = 4 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// A track of an object instance.
+message Track {
+  // Video segment of a track.
+  VideoSegment segment = 1;
+
+  // The object with timestamp and attributes per frame in the track.
+  repeated TimestampedObject timestamped_objects = 2;
+
+  // Optional. Attributes in the track level.
+  repeated DetectedAttribute attributes = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The confidence score of the tracked object.
+  float confidence = 4 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// A generic detected attribute represented by name in string format.
+message DetectedAttribute {
+  // The name of the attribute, i.e. glasses, dark_glasses, mouth_open etc.
+  // A full list of supported type names will be provided in the document.
+  string name = 1;
+
+  // Detected attribute confidence. Range [0, 1].
+  float confidence = 2;
+
+  // Text value of the detection result. For example, the value for "HairColor"
+  // can be "black", "blonde", etc.
+  string value = 3;
+}
+
+// A generic detected landmark represented by name in string format and a 2D
+// location.
+message DetectedLandmark {
+  // The name of this landmark, i.e. left_hand, right_shoulder.
+  string name = 1;
+
+  // The 2D point of the detected landmark using the normalized image
+  // coordindate system. The normalized coordinates have the range from 0 to 1.
+  NormalizedVertex point = 2;
+
+  // The confidence score of the detected landmark. Range [0, 1].
+  float confidence = 3;
+}
+
 // Annotation results for a single video.
 message VideoAnnotationResults {
   // Video file location in
   // [Google Cloud Storage](https://cloud.google.com/storage/).
   string input_uri = 1;
 
-  // Label annotations on video level or user specified segment level.
+  // Video segment on which the annotation is run.
+  VideoSegment segment = 10;
+
+  // Topical label annotations on video level or user specified segment level.
   // There is exactly one element for each unique label.
   repeated LabelAnnotation segment_label_annotations = 2;
 
-  // Label annotations on shot level.
+  // Presence label annotations on video level or user specified segment level.
+  // There is exactly one element for each unique label. Compared to the
+  // existing topical `segment_label_annotations`, this field presents more
+  // fine-grained, segment-level labels detected in video content and is made
+  // available only when the client sets `LabelDetectionConfig.model` to
+  // "builtin/latest" in the request.
+  repeated LabelAnnotation segment_presence_label_annotations = 23;
+
+  // Topical label annotations on shot level.
   // There is exactly one element for each unique label.
   repeated LabelAnnotation shot_label_annotations = 3;
 
+  // Presence label annotations on shot level. There is exactly one element for
+  // each unique label. Compared to the existing topical
+  // `shot_label_annotations`, this field presents more fine-grained, shot-level
+  // labels detected in video content and is made available only when the client
+  // sets `LabelDetectionConfig.model` to "builtin/latest" in the request.
+  repeated LabelAnnotation shot_presence_label_annotations = 24;
+
   // Label annotations on frame level.
   // There is exactly one element for each unique label.
   repeated LabelAnnotation frame_label_annotations = 4;
@@ -363,6 +516,9 @@ message VideoAnnotationResults {
   // Annotations for list of objects detected and tracked in video.
   repeated ObjectTrackingAnnotation object_annotations = 14;
 
+  // Annotations for list of logos detected, tracked and recognized in video.
+  repeated LogoRecognitionAnnotation logo_recognition_annotations = 19;
+
   // If set, indicates an error. Note that for a single `AnnotateVideoRequest`
   // some videos may succeed and some may fail.
   google.rpc.Status error = 9;
@@ -391,6 +547,14 @@ message VideoAnnotationProgress {
 
   // Time of the most recent update.
   google.protobuf.Timestamp update_time = 4;
+
+  // Specifies which feature is being tracked if the request contains more than
+  // one features.
+  Feature feature = 5;
+
+  // Specifies which segment is being tracked if the request contains more than
+  // one segments.
+  VideoSegment segment = 6;
 }
 
 // Video annotation progress. Included in the `metadata`
@@ -403,72 +567,71 @@ message AnnotateVideoProgress {
 
 // Config for SPEECH_TRANSCRIPTION.
 message SpeechTranscriptionConfig {
-  // *Required* The language of the supplied audio as a
+  // Required. *Required* The language of the supplied audio as a
   // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag.
   // Example: "en-US".
   // See [Language Support](https://cloud.google.com/speech/docs/languages)
   // for a list of the currently supported language codes.
-  string language_code = 1;
+  string language_code = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // *Optional* Maximum number of recognition hypotheses to be returned.
+  // Optional. Maximum number of recognition hypotheses to be returned.
   // Specifically, the maximum number of `SpeechRecognitionAlternative` messages
   // within each `SpeechTranscription`. The server may return fewer than
   // `max_alternatives`. Valid values are `0`-`30`. A value of `0` or `1` will
   // return a maximum of one. If omitted, will return a maximum of one.
-  int32 max_alternatives = 2;
+  int32 max_alternatives = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // *Optional* If set to `true`, the server will attempt to filter out
+  // Optional. If set to `true`, the server will attempt to filter out
   // profanities, replacing all but the initial character in each filtered word
   // with asterisks, e.g. "f***". If set to `false` or omitted, profanities
   // won't be filtered out.
-  bool filter_profanity = 3;
+  bool filter_profanity = 3 [(google.api.field_behavior) = OPTIONAL];
 
-  // *Optional* A means to provide context to assist the speech recognition.
-  repeated SpeechContext speech_contexts = 4;
+  // Optional. A means to provide context to assist the speech recognition.
+  repeated SpeechContext speech_contexts = 4 [(google.api.field_behavior) = OPTIONAL];
 
-  // *Optional* If 'true', adds punctuation to recognition result hypotheses.
+  // Optional. If 'true', adds punctuation to recognition result hypotheses.
   // This feature is only available in select languages. Setting this for
   // requests in other languages has no effect at all. The default 'false' value
   // does not add punctuation to result hypotheses. NOTE: "This is currently
   // offered as an experimental service, complimentary to all users. In the
   // future this may be exclusively available as a premium feature."
-  bool enable_automatic_punctuation = 5;
+  bool enable_automatic_punctuation = 5 [(google.api.field_behavior) = OPTIONAL];
 
-  // *Optional* For file formats, such as MXF or MKV, supporting multiple audio
+  // Optional. For file formats, such as MXF or MKV, supporting multiple audio
   // tracks, specify up to two tracks. Default: track 0.
-  repeated int32 audio_tracks = 6;
+  repeated int32 audio_tracks = 6 [(google.api.field_behavior) = OPTIONAL];
 
-  // *Optional* If 'true', enables speaker detection for each recognized word in
+  // Optional. If 'true', enables speaker detection for each recognized word in
   // the top alternative of the recognition result using a speaker_tag provided
   // in the WordInfo.
   // Note: When this is true, we send all the words from the beginning of the
   // audio for the top alternative in every consecutive responses.
   // This is done in order to improve our speaker tags as our models learn to
   // identify the speakers in the conversation over time.
-  bool enable_speaker_diarization = 7;
+  bool enable_speaker_diarization = 7 [(google.api.field_behavior) = OPTIONAL];
 
-  // *Optional*
-  // If set, specifies the estimated number of speakers in the conversation.
+  // Optional. If set, specifies the estimated number of speakers in the conversation.
   // If not set, defaults to '2'.
   // Ignored unless enable_speaker_diarization is set to true.
-  int32 diarization_speaker_count = 8;
+  int32 diarization_speaker_count = 8 [(google.api.field_behavior) = OPTIONAL];
 
-  // *Optional* If `true`, the top result includes a list of words and the
+  // Optional. If `true`, the top result includes a list of words and the
   // confidence for those words. If `false`, no word-level confidence
   // information is returned. The default is `false`.
-  bool enable_word_confidence = 9;
+  bool enable_word_confidence = 9 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Provides "hints" to the speech recognizer to favor specific words and phrases
 // in the results.
 message SpeechContext {
-  // *Optional* A list of strings containing words and phrases "hints" so that
+  // Optional. A list of strings containing words and phrases "hints" so that
   // the speech recognition is more likely to recognize them. This can be used
   // to improve the accuracy for specific words and phrases, for example, if
   // specific commands are typically spoken by the user. This can also be used
   // to add additional words to the vocabulary of the recognizer. See
   // [usage limits](https://cloud.google.com/speech/limits#content).
-  repeated string phrases = 1;
+  repeated string phrases = 1 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // A speech recognition result corresponding to a portion of the audio.
@@ -479,11 +642,10 @@ message SpeechTranscription {
   // ranked by the recognizer.
   repeated SpeechRecognitionAlternative alternatives = 1;
 
-  // Output only. The
-  // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the
-  // language in this result. This language code was detected to have the most
-  // likelihood of being spoken in the audio.
-  string language_code = 2;
+  // Output only. The [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of
+  // the language in this result. This language code was detected to have the
+  // most likelihood of being spoken in the audio.
+  string language_code = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Alternative hypotheses (a.k.a. n-best list).
@@ -491,16 +653,18 @@ message SpeechRecognitionAlternative {
   // Transcript text representing the words that the user spoke.
   string transcript = 1;
 
-  // The confidence estimate between 0.0 and 1.0. A higher number
+  // Output only. The confidence estimate between 0.0 and 1.0. A higher number
   // indicates an estimated greater likelihood that the recognized words are
-  // correct. This field is typically provided only for the top hypothesis, and
-  // only for `is_final=true` results. Clients should not rely on the
-  // `confidence` field as it is not guaranteed to be accurate or consistent.
+  // correct. This field is set only for the top alternative.
+  // This field is not guaranteed to be accurate and users should not rely on it
+  // to be always provided.
   // The default of 0.0 is a sentinel value indicating `confidence` was not set.
-  float confidence = 2;
+  float confidence = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // A list of word-specific information for each recognized word.
-  repeated WordInfo words = 3;
+  // Output only. A list of word-specific information for each recognized word.
+  // Note: When `enable_speaker_diarization` is true, you will see all the words
+  // from the beginning of the audio.
+  repeated WordInfo words = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Word-specific information for recognized words. Word information is only
@@ -528,13 +692,13 @@ message WordInfo {
   // This field is not guaranteed to be accurate and users should not rely on it
   // to be always provided.
   // The default of 0.0 is a sentinel value indicating `confidence` was not set.
-  float confidence = 4;
+  float confidence = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. A distinct integer value is assigned for every speaker within
   // the audio. This field specifies which one of those speakers was detected to
   // have spoken this word. Value ranges from 1 up to diarization_speaker_count,
   // and is only set if speaker diarization is enabled.
-  int32 speaker_tag = 5;
+  int32 speaker_tag = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // A vertex represents a 2D point in the image.
@@ -646,65 +810,17 @@ message ObjectTrackingAnnotation {
   repeated ObjectTrackingFrame frames = 2;
 }
 
-// Video annotation feature.
-enum Feature {
-  // Unspecified.
-  FEATURE_UNSPECIFIED = 0;
-
-  // Label detection. Detect objects, such as dog or flower.
-  LABEL_DETECTION = 1;
-
-  // Shot change detection.
-  SHOT_CHANGE_DETECTION = 2;
-
-  // Explicit content detection.
-  EXPLICIT_CONTENT_DETECTION = 3;
-
-  // Human face detection and tracking.
-  FACE_DETECTION = 4;
-
-  // Speech transcription.
-  SPEECH_TRANSCRIPTION = 6;
-
-  // OCR text detection and tracking.
-  TEXT_DETECTION = 7;
-
-  // Object detection and tracking.
-  OBJECT_TRACKING = 9;
-}
-
-// Label detection mode.
-enum LabelDetectionMode {
-  // Unspecified.
-  LABEL_DETECTION_MODE_UNSPECIFIED = 0;
-
-  // Detect shot-level labels.
-  SHOT_MODE = 1;
-
-  // Detect frame-level labels.
-  FRAME_MODE = 2;
-
-  // Detect both shot-level and frame-level labels.
-  SHOT_AND_FRAME_MODE = 3;
-}
-
-// Bucketized representation of likelihood.
-enum Likelihood {
-  // Unspecified likelihood.
-  LIKELIHOOD_UNSPECIFIED = 0;
-
-  // Very unlikely.
-  VERY_UNLIKELY = 1;
-
-  // Unlikely.
-  UNLIKELY = 2;
-
-  // Possible.
-  POSSIBLE = 3;
+// Annotation corresponding to one detected, tracked and recognized logo class.
+message LogoRecognitionAnnotation {
+  // Entity category information to specify the logo class that all the logo
+  // tracks within this LogoRecognitionAnnotation are recognized as.
+  Entity entity = 1;
 
-  // Likely.
-  LIKELY = 4;
+  // All logo tracks where the recognized logo appears. Each track corresponds
+  // to one logo instance appearing in consecutive frames.
+  repeated Track tracks = 2;
 
-  // Very likely.
-  VERY_LIKELY = 5;
+  // All video segments where the recognized logo appears. There might be
+  // multiple instances of the same logo class appearing in one VideoSegment.
+  repeated VideoSegment segments = 3;
 }
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1/videointelligence_gapic.legacy.yaml b/third_party/googleapis/google/cloud/videointelligence/v1/videointelligence_gapic.legacy.yaml
new file mode 100644
index 000000000..20843a355
--- /dev/null
+++ b/third_party/googleapis/google/cloud/videointelligence/v1/videointelligence_gapic.legacy.yaml
@@ -0,0 +1,63 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.videointelligence.v1
+  python:
+    package_name: google.cloud.videointelligence_v1.gapic
+  go:
+    package_name: cloud.google.com/go/videointelligence/apiv1
+  csharp:
+    package_name: Google.Cloud.VideoIntelligence.V1
+  ruby:
+    package_name: Google::Cloud::VideoIntelligence::V1
+    release_level: GA
+  php:
+    package_name: Google\Cloud\VideoIntelligence\V1
+  nodejs:
+    package_name: video-intelligence.v1
+    domain_layer_location: google-cloud
+interfaces:
+- name: google.cloud.videointelligence.v1.VideoIntelligenceService
+  smoke_test:
+    method: AnnotateVideo
+    init_fields:
+    - input_uri=gs://cloud-samples-data/video/cat.mp4
+    - features[0]=LABEL_DETECTION
+  collections: []
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 1000
+    retry_delay_multiplier: 2.5
+    max_retry_delay_millis: 120000
+    initial_rpc_timeout_millis: 120000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 120000
+    total_timeout_millis: 600000
+  methods:
+  - name: AnnotateVideo
+    flattening:
+      groups:
+      - parameters:
+        - input_uri
+        - features
+    long_running:
+      return_type: google.cloud.videointelligence.v1.AnnotateVideoResponse
+      metadata_type: google.cloud.videointelligence.v1.AnnotateVideoProgress
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    sample_code_init_fields:
+    - input_uri=gs://cloud-samples-data/video/cat.mp4
+    - features[0]=LABEL_DETECTION
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1/videointelligence_gapic.yaml b/third_party/googleapis/google/cloud/videointelligence/v1/videointelligence_gapic.yaml
index 20843a355..31dbde17d 100644
--- a/third_party/googleapis/google/cloud/videointelligence/v1/videointelligence_gapic.yaml
+++ b/third_party/googleapis/google/cloud/videointelligence/v1/videointelligence_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.videointelligence.v1
@@ -24,14 +24,6 @@ interfaces:
     init_fields:
     - input_uri=gs://cloud-samples-data/video/cat.mp4
     - features[0]=LABEL_DETECTION
-  collections: []
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 1000
@@ -43,21 +35,12 @@ interfaces:
     total_timeout_millis: 600000
   methods:
   - name: AnnotateVideo
-    flattening:
-      groups:
-      - parameters:
-        - input_uri
-        - features
+    retry_codes_name: idempotent
     long_running:
-      return_type: google.cloud.videointelligence.v1.AnnotateVideoResponse
-      metadata_type: google.cloud.videointelligence.v1.AnnotateVideoProgress
       initial_poll_delay_millis: 20000
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 45000
       total_poll_timeout_millis: 86400000
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 60000
     sample_code_init_fields:
     - input_uri=gs://cloud-samples-data/video/cat.mp4
     - features[0]=LABEL_DETECTION
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1/videointelligence_grpc_service_config.json b/third_party/googleapis/google/cloud/videointelligence/v1/videointelligence_grpc_service_config.json
new file mode 100755
index 000000000..2d537341c
--- /dev/null
+++ b/third_party/googleapis/google/cloud/videointelligence/v1/videointelligence_grpc_service_config.json
@@ -0,0 +1,22 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.videointelligence.v1.VideoIntelligenceService",
+          "method": "AnnotateVideo"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "1s",
+        "maxBackoff": "120s",
+        "backoffMultiplier": 2.5,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1/videointelligence_v1.yaml b/third_party/googleapis/google/cloud/videointelligence/v1/videointelligence_v1.yaml
new file mode 100644
index 000000000..963afbf80
--- /dev/null
+++ b/third_party/googleapis/google/cloud/videointelligence/v1/videointelligence_v1.yaml
@@ -0,0 +1,47 @@
+type: google.api.Service
+config_version: 3
+name: videointelligence.googleapis.com
+title: Cloud Video Intelligence API
+
+apis:
+- name: google.cloud.videointelligence.v1.VideoIntelligenceService
+
+types:
+- name: google.cloud.videointelligence.v1.AnnotateVideoProgress
+- name: google.cloud.videointelligence.v1.AnnotateVideoResponse
+- name: google.cloud.videointelligence.v1.VideoSegment
+
+documentation:
+  summary: |-
+    Detects objects, explicit content, and scene changes in videos. It also
+    specifies the region for annotation and transcribes speech to text.
+    Supports both asynchronous API and streaming API.
+
+http:
+  rules:
+  - selector: google.longrunning.Operations.CancelOperation
+    post: '/v1/{name=projects/*/locations/*/operations/*}:cancel'
+    body: '*'
+    additional_bindings:
+    - post: '/v1/operations/{name=projects/*/locations/*/operations/*}:cancel'
+  - selector: google.longrunning.Operations.DeleteOperation
+    delete: '/v1/{name=projects/*/locations/*/operations/*}'
+    additional_bindings:
+    - delete: '/v1/operations/{name=projects/*/locations/*/operations/*}'
+  - selector: google.longrunning.Operations.GetOperation
+    get: '/v1/{name=projects/*/locations/*/operations/*}'
+    additional_bindings:
+    - get: '/v1/operations/{name=projects/*/locations/*/operations/*}'
+  - selector: google.longrunning.Operations.ListOperations
+    get: '/v1/{name=projects/*/locations/*}/operations'
+
+authentication:
+  rules:
+  - selector: google.cloud.videointelligence.v1.VideoIntelligenceService.AnnotateVideo
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/videointelligence/v1beta1/BUILD.bazel
deleted file mode 100644
index 4e2efa857..000000000
--- a/third_party/googleapis/google/cloud/videointelligence/v1beta1/BUILD.bazel
+++ /dev/null
@@ -1,152 +0,0 @@
-# This is an API workspace, having public visibility by default makes perfect sense.
-package(default_visibility = ["//visibility:public"])
-
-##############################################################################
-# Common
-##############################################################################
-load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
-
-proto_library(
-    name = "video_intelligence_proto",
-    srcs = [
-        "video_intelligence.proto",
-    ],
-    deps = [
-        "//google/api:annotations_proto",
-        "//google/longrunning:operations_proto",
-        "//google/rpc:status_proto",
-        "@com_google_protobuf//:timestamp_proto",
-    ],
-)
-
-proto_library_with_info(
-    name = "video_intelligence_proto_with_info",
-    deps = [":video_intelligence_proto"],
-)
-
-##############################################################################
-# Java
-##############################################################################
-load(
-    "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
-    "java_gapic_assembly_gradle_pkg",
-    "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
-)
-
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
-java_proto_library(
-    name = "video_intelligence_java_proto",
-    deps = [":video_intelligence_proto"],
-)
-
-java_grpc_library(
-    name = "video_intelligence_java_grpc",
-    srcs = [":video_intelligence_proto"],
-    deps = [":video_intelligence_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "video_intelligence_resource_name_java_proto",
-    gapic_yaml = "videointelligence_gapic.yaml",
-    deps = [":video_intelligence_proto"],
-)
-
-java_gapic_library(
-    name = "video_intelligence_java_gapic",
-    src = ":video_intelligence_proto_with_info",
-    gapic_yaml = "videointelligence_gapic.yaml",
-    service_yaml = "//google/cloud/videointelligence:videointelligence_v1beta1.yaml",
-    test_deps = [":video_intelligence_java_grpc"],
-    deps = [
-        ":video_intelligence_java_proto",
-        ":video_intelligence_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-)
-
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":video_intelligence_java_gapic_test",
-    ],
-) for test_name in [
-    "com.google.cloud.videointelligence.v1beta1.VideoIntelligenceServiceClientTest",
-]]
-
-# Opensource Packages
-java_gapic_assembly_gradle_pkg(
-    name = "google-cloud-video-intelligence-v1beta1-java",
-    client_deps = [":video_intelligence_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":video_intelligence_java_gapic_test"],
-    grpc_deps = [":video_intelligence_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
-        ":video_intelligence_java_proto",
-        ":video_intelligence_proto",
-        ":video_intelligence_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
-)
-
-##############################################################################
-# Go
-##############################################################################
-load(
-    "@com_google_googleapis_imports//:imports.bzl",
-    "go_proto_library",
-    "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
-)
-
-go_proto_library(
-    name = "video_intelligence_go_proto",
-    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
-    importpath = "google.golang.org/genproto/googleapis/cloud/videointelligence/v1beta1",
-    protos = [":video_intelligence_proto"],
-    deps = [
-        "//google/api:annotations_go_proto",
-        "//google/longrunning:longrunning_go_proto",
-        "//google/rpc:status_go_proto",
-    ],
-)
-
-go_gapic_library(
-    name = "video_intelligence_go_gapic",
-    src = ":video_intelligence_proto_with_info",
-    gapic_yaml = "videointelligence_gapic.yaml",
-    importpath = "cloud.google.com/go/videointelligence/apiv1beta1",
-    service_yaml = "//google/cloud/videointelligence:videointelligence_v1beta1.yaml",
-    deps = [
-        ":video_intelligence_go_proto",
-        "//google/longrunning:longrunning_go_gapic",
-        "//google/longrunning:longrunning_go_proto",
-        "@com_google_cloud_go//longrunning:go_default_library",
-    ],
-)
-
-go_test(
-    name = "video_intelligence_go_gapic_test",
-    srcs = [":video_intelligence_go_gapic_srcjar_test"],
-    embed = [":video_intelligence_go_gapic"],
-    importpath = "cloud.google.com/go/videointelligence/apiv1beta1",
-)
-
-# Opensource Packages
-go_gapic_assembly_pkg(
-    name = "gapi-cloud-video-intelligence-v1beta1-go",
-    deps = [
-        ":video_intelligence_go_gapic",
-        ":video_intelligence_go_gapic_srcjar-smoke-test.srcjar",
-        ":video_intelligence_go_gapic_srcjar-test.srcjar",
-        ":video_intelligence_go_proto",
-    ],
-)
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1beta1/video_intelligence.proto b/third_party/googleapis/google/cloud/videointelligence/v1beta1/video_intelligence.proto
deleted file mode 100644
index 430776bf0..000000000
--- a/third_party/googleapis/google/cloud/videointelligence/v1beta1/video_intelligence.proto
+++ /dev/null
@@ -1,345 +0,0 @@
-// Copyright 2017 Google Inc.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-syntax = "proto3";
-
-package google.cloud.videointelligence.v1beta1;
-
-import "google/api/annotations.proto";
-import "google/longrunning/operations.proto";
-import "google/protobuf/timestamp.proto";
-import "google/rpc/status.proto";
-
-option csharp_namespace = "Google.Cloud.VideoIntelligence.V1Beta1";
-option go_package = "google.golang.org/genproto/googleapis/cloud/videointelligence/v1beta1;videointelligence";
-option java_multiple_files = true;
-option java_outer_classname = "VideoIntelligenceServiceProto";
-option java_package = "com.google.cloud.videointelligence.v1beta1";
-option php_namespace = "Google\\Cloud\\VideoIntelligence\\V1beta1";
-option ruby_package = "Google::Cloud::VideoIntelligence::V1beta1";
-
-// Service that implements Google Cloud Video Intelligence API.
-service VideoIntelligenceService {
-  // Performs asynchronous video annotation. Progress and results can be
-  // retrieved through the `google.longrunning.Operations` interface.
-  // `Operation.metadata` contains `AnnotateVideoProgress` (progress).
-  // `Operation.response` contains `AnnotateVideoResponse` (results).
-  rpc AnnotateVideo(AnnotateVideoRequest)
-      returns (google.longrunning.Operation) {
-    option (google.api.http) = {
-      post: "/v1beta1/videos:annotate"
-      body: "*"
-    };
-  }
-}
-
-// Video annotation request.
-message AnnotateVideoRequest {
-  // Input video location. Currently, only
-  // [Google Cloud Storage](https://cloud.google.com/storage/) URIs are
-  // supported, which must be specified in the following format:
-  // `gs://bucket-id/object-id` (other URI formats return
-  // [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For
-  // more information, see [Request URIs](/storage/docs/reference-uris). A video
-  // URI may include wildcards in `object-id`, and thus identify multiple
-  // videos. Supported wildcards: '*' to match 0 or more characters;
-  // '?' to match 1 character. If unset, the input video should be embedded
-  // in the request as `input_content`. If set, `input_content` should be unset.
-  string input_uri = 1;
-
-  // The video data bytes. Encoding: base64. If unset, the input video(s)
-  // should be specified via `input_uri`. If set, `input_uri` should be unset.
-  string input_content = 6;
-
-  // Requested video annotation features.
-  repeated Feature features = 2;
-
-  // Additional video context and/or feature-specific parameters.
-  VideoContext video_context = 3;
-
-  // Optional location where the output (in JSON format) should be stored.
-  // Currently, only [Google Cloud Storage](https://cloud.google.com/storage/)
-  // URIs are supported, which must be specified in the following format:
-  // `gs://bucket-id/object-id` (other URI formats return
-  // [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For
-  // more information, see [Request URIs](/storage/docs/reference-uris).
-  string output_uri = 4;
-
-  // Optional cloud region where annotation should take place. Supported cloud
-  // regions: `us-east1`, `us-west1`, `europe-west1`, `asia-east1`. If no region
-  // is specified, a region will be determined based on video file location.
-  string location_id = 5;
-}
-
-// Video context and/or feature-specific parameters.
-message VideoContext {
-  // Video segments to annotate. The segments may overlap and are not required
-  // to be contiguous or span the whole video. If unspecified, each video
-  // is treated as a single segment.
-  repeated VideoSegment segments = 1;
-
-  // If label detection has been requested, what labels should be detected
-  // in addition to video-level labels or segment-level labels. If unspecified,
-  // defaults to `SHOT_MODE`.
-  LabelDetectionMode label_detection_mode = 2;
-
-  // Whether the video has been shot from a stationary (i.e. non-moving) camera.
-  // When set to true, might improve detection accuracy for moving objects.
-  bool stationary_camera = 3;
-
-  // Model to use for label detection.
-  // Supported values: "latest" and "stable" (the default).
-  string label_detection_model = 4;
-
-  // Model to use for face detection.
-  // Supported values: "latest" and "stable" (the default).
-  string face_detection_model = 5;
-
-  // Model to use for shot change detection.
-  // Supported values: "latest" and "stable" (the default).
-  string shot_change_detection_model = 6;
-
-  // Model to use for safe search detection.
-  // Supported values: "latest" and "stable" (the default).
-  string safe_search_detection_model = 7;
-}
-
-// Video segment.
-message VideoSegment {
-  // Start offset in microseconds (inclusive). Unset means 0.
-  int64 start_time_offset = 1;
-
-  // End offset in microseconds (inclusive). Unset means 0.
-  int64 end_time_offset = 2;
-}
-
-// Label location.
-message LabelLocation {
-  // Video segment. Set to [-1, -1] for video-level labels.
-  // Set to [timestamp, timestamp] for frame-level labels.
-  // Otherwise, corresponds to one of `AnnotateSpec.segments`
-  // (if specified) or to shot boundaries (if requested).
-  VideoSegment segment = 1;
-
-  // Confidence that the label is accurate. Range: [0, 1].
-  float confidence = 2;
-
-  // Label level.
-  LabelLevel level = 3;
-}
-
-// Label annotation.
-message LabelAnnotation {
-  // Textual description, e.g. `Fixed-gear bicycle`.
-  string description = 1;
-
-  // Language code for `description` in BCP-47 format.
-  string language_code = 2;
-
-  // Where the label was detected and with what confidence.
-  repeated LabelLocation locations = 3;
-}
-
-// Safe search annotation (based on per-frame visual signals only).
-// If no unsafe content has been detected in a frame, no annotations
-// are present for that frame. If only some types of unsafe content
-// have been detected in a frame, the likelihood is set to `UNKNOWN`
-// for all other types of unsafe content.
-message SafeSearchAnnotation {
-  // Likelihood of adult content.
-  Likelihood adult = 1;
-
-  // Likelihood that an obvious modification was made to the original
-  // version to make it appear funny or offensive.
-  Likelihood spoof = 2;
-
-  // Likelihood of medical content.
-  Likelihood medical = 3;
-
-  // Likelihood of violent content.
-  Likelihood violent = 4;
-
-  // Likelihood of racy content.
-  Likelihood racy = 5;
-
-  // Video time offset in microseconds.
-  int64 time_offset = 6;
-}
-
-// Bounding box.
-message BoundingBox {
-  // Left X coordinate.
-  int32 left = 1;
-
-  // Right X coordinate.
-  int32 right = 2;
-
-  // Bottom Y coordinate.
-  int32 bottom = 3;
-
-  // Top Y coordinate.
-  int32 top = 4;
-}
-
-// Face location.
-message FaceLocation {
-  // Bounding box in a frame.
-  BoundingBox bounding_box = 1;
-
-  // Video time offset in microseconds.
-  int64 time_offset = 2;
-}
-
-// Face annotation.
-message FaceAnnotation {
-  // Thumbnail of a representative face view (in JPEG format). Encoding: base64.
-  string thumbnail = 1;
-
-  // All locations where a face was detected.
-  // Faces are detected and tracked on a per-video basis
-  // (as opposed to across multiple videos).
-  repeated VideoSegment segments = 2;
-
-  // Face locations at one frame per second.
-  repeated FaceLocation locations = 3;
-}
-
-// Annotation results for a single video.
-message VideoAnnotationResults {
-  // Video file location in
-  // [Google Cloud Storage](https://cloud.google.com/storage/).
-  string input_uri = 1;
-
-  // Label annotations. There is exactly one element for each unique label.
-  repeated LabelAnnotation label_annotations = 2;
-
-  // Face annotations. There is exactly one element for each unique face.
-  repeated FaceAnnotation face_annotations = 3;
-
-  // Shot annotations. Each shot is represented as a video segment.
-  repeated VideoSegment shot_annotations = 4;
-
-  // Safe search annotations.
-  repeated SafeSearchAnnotation safe_search_annotations = 6;
-
-  // If set, indicates an error. Note that for a single `AnnotateVideoRequest`
-  // some videos may succeed and some may fail.
-  google.rpc.Status error = 5;
-}
-
-// Video annotation response. Included in the `response`
-// field of the `Operation` returned by the `GetOperation`
-// call of the `google::longrunning::Operations` service.
-message AnnotateVideoResponse {
-  // Annotation results for all videos specified in `AnnotateVideoRequest`.
-  repeated VideoAnnotationResults annotation_results = 1;
-}
-
-// Annotation progress for a single video.
-message VideoAnnotationProgress {
-  // Video file location in
-  // [Google Cloud Storage](https://cloud.google.com/storage/).
-  string input_uri = 1;
-
-  // Approximate percentage processed thus far.
-  // Guaranteed to be 100 when fully processed.
-  int32 progress_percent = 2;
-
-  // Time when the request was received.
-  google.protobuf.Timestamp start_time = 3;
-
-  // Time of the most recent update.
-  google.protobuf.Timestamp update_time = 4;
-}
-
-// Video annotation progress. Included in the `metadata`
-// field of the `Operation` returned by the `GetOperation`
-// call of the `google::longrunning::Operations` service.
-message AnnotateVideoProgress {
-  // Progress metadata for all videos specified in `AnnotateVideoRequest`.
-  repeated VideoAnnotationProgress annotation_progress = 1;
-}
-
-// Video annotation feature.
-enum Feature {
-  // Unspecified.
-  FEATURE_UNSPECIFIED = 0;
-
-  // Label detection. Detect objects, such as dog or flower.
-  LABEL_DETECTION = 1;
-
-  // Human face detection and tracking.
-  FACE_DETECTION = 2;
-
-  // Shot change detection.
-  SHOT_CHANGE_DETECTION = 3;
-
-  // Safe search detection.
-  SAFE_SEARCH_DETECTION = 4;
-}
-
-// Label level (scope).
-enum LabelLevel {
-  // Unspecified.
-  LABEL_LEVEL_UNSPECIFIED = 0;
-
-  // Video-level. Corresponds to the whole video.
-  VIDEO_LEVEL = 1;
-
-  // Segment-level. Corresponds to one of `AnnotateSpec.segments`.
-  SEGMENT_LEVEL = 2;
-
-  // Shot-level. Corresponds to a single shot (i.e. a series of frames
-  // without a major camera position or background change).
-  SHOT_LEVEL = 3;
-
-  // Frame-level. Corresponds to a single video frame.
-  FRAME_LEVEL = 4;
-}
-
-// Label detection mode.
-enum LabelDetectionMode {
-  // Unspecified.
-  LABEL_DETECTION_MODE_UNSPECIFIED = 0;
-
-  // Detect shot-level labels.
-  SHOT_MODE = 1;
-
-  // Detect frame-level labels.
-  FRAME_MODE = 2;
-
-  // Detect both shot-level and frame-level labels.
-  SHOT_AND_FRAME_MODE = 3;
-}
-
-// Bucketized representation of likelihood.
-enum Likelihood {
-  // Unknown likelihood.
-  UNKNOWN = 0;
-
-  // Very unlikely.
-  VERY_UNLIKELY = 1;
-
-  // Unlikely.
-  UNLIKELY = 2;
-
-  // Possible.
-  POSSIBLE = 3;
-
-  // Likely.
-  LIKELY = 4;
-
-  // Very likely.
-  VERY_LIKELY = 5;
-}
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1beta1/videointelligence_grpc_service_config.json b/third_party/googleapis/google/cloud/videointelligence/v1beta1/videointelligence_grpc_service_config.json
new file mode 100755
index 000000000..d41c56e6a
--- /dev/null
+++ b/third_party/googleapis/google/cloud/videointelligence/v1beta1/videointelligence_grpc_service_config.json
@@ -0,0 +1,22 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.videointelligence.v1beta1.VideoIntelligenceService",
+          "method": "AnnotateVideo"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "1s",
+        "maxBackoff": "120s",
+        "backoffMultiplier": 2.5,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1beta2/BUILD.bazel b/third_party/googleapis/google/cloud/videointelligence/v1beta2/BUILD.bazel
index acd3c583e..c8edfddc8 100644
--- a/third_party/googleapis/google/cloud/videointelligence/v1beta2/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/videointelligence/v1beta2/BUILD.bazel
@@ -1,18 +1,23 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
-    name = "video_intelligence_proto",
+    name = "videointelligence_proto",
     srcs = [
         "video_intelligence.proto",
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
         "//google/longrunning:operations_proto",
         "//google/rpc:status_proto",
         "@com_google_protobuf//:duration_proto",
@@ -21,8 +26,11 @@ proto_library(
 )
 
 proto_library_with_info(
-    name = "video_intelligence_proto_with_info",
-    deps = [":video_intelligence_proto"],
+    name = "videointelligence_proto_with_info",
+    deps = [
+        ":videointelligence_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -30,71 +38,55 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
-    name = "video_intelligence_java_proto",
-    deps = [":video_intelligence_proto"],
+    name = "videointelligence_java_proto",
+    deps = [":videointelligence_proto"],
 )
 
 java_grpc_library(
-    name = "video_intelligence_java_grpc",
-    srcs = [":video_intelligence_proto"],
-    deps = [":video_intelligence_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "video_intelligence_resource_name_java_proto",
-    gapic_yaml = "videointelligence_gapic.yaml",
-    deps = [":video_intelligence_proto"],
+    name = "videointelligence_java_grpc",
+    srcs = [":videointelligence_proto"],
+    deps = [":videointelligence_java_proto"],
 )
 
 java_gapic_library(
-    name = "video_intelligence_java_gapic",
-    src = ":video_intelligence_proto_with_info",
+    name = "videointelligence_java_gapic",
+    src = ":videointelligence_proto_with_info",
     gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1beta2",
     service_yaml = "//google/cloud/videointelligence:videointelligence_v1beta2.yaml",
-    test_deps = [":video_intelligence_java_grpc"],
+    test_deps = [
+        ":videointelligence_java_grpc",
+    ],
     deps = [
-        ":video_intelligence_java_proto",
-        ":video_intelligence_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+        ":videointelligence_java_proto",
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":video_intelligence_java_gapic_test",
+java_gapic_test(
+    name = "videointelligence_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.videointelligence.v1beta2.VideoIntelligenceServiceClientTest",
     ],
-) for test_name in [
-    "com.google.cloud.videointelligence.v1beta2.VideoIntelligenceServiceClientTest",
-]]
+    runtime_deps = [":videointelligence_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
-    name = "google-cloud-video-intelligence-v1beta2-java",
-    client_deps = [":video_intelligence_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":video_intelligence_java_gapic_test"],
-    grpc_deps = [":video_intelligence_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
-        ":video_intelligence_java_proto",
-        ":video_intelligence_proto",
-        ":video_intelligence_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    name = "google-cloud-videointelligence-v1beta2-java",
+    deps = [
+        ":videointelligence_java_gapic",
+        ":videointelligence_java_grpc",
+        ":videointelligence_java_proto",
+        ":videointelligence_proto",
+    ],
 )
 
 ##############################################################################
@@ -102,17 +94,17 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
-    name = "video_intelligence_go_proto",
+    name = "videointelligence_go_proto",
     compilers = ["@io_bazel_rules_go//proto:go_grpc"],
     importpath = "google.golang.org/genproto/googleapis/cloud/videointelligence/v1beta2",
-    protos = [":video_intelligence_proto"],
+    protos = [":videointelligence_proto"],
     deps = [
         "//google/api:annotations_go_proto",
         "//google/longrunning:longrunning_go_proto",
@@ -121,33 +113,257 @@ go_proto_library(
 )
 
 go_gapic_library(
-    name = "video_intelligence_go_gapic",
-    src = ":video_intelligence_proto_with_info",
-    gapic_yaml = "videointelligence_gapic.yaml",
-    importpath = "cloud.google.com/go/videointelligence/apiv1beta2",
+    name = "videointelligence_go_gapic",
+    srcs = [":videointelligence_proto_with_info"],
+    grpc_service_config = "videointelligence_grpc_service_config.json",
+    importpath = "cloud.google.com/go/videointelligence/apiv1beta2;videointelligence",
     service_yaml = "//google/cloud/videointelligence:videointelligence_v1beta2.yaml",
     deps = [
-        ":video_intelligence_go_proto",
+        ":videointelligence_go_proto",
         "//google/longrunning:longrunning_go_gapic",
         "//google/longrunning:longrunning_go_proto",
         "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
     ],
 )
 
 go_test(
-    name = "video_intelligence_go_gapic_test",
-    srcs = [":video_intelligence_go_gapic_srcjar_test"],
-    embed = [":video_intelligence_go_gapic"],
+    name = "videointelligence_go_gapic_test",
+    srcs = [":videointelligence_go_gapic_srcjar_test"],
+    embed = [":videointelligence_go_gapic"],
     importpath = "cloud.google.com/go/videointelligence/apiv1beta2",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
-    name = "gapi-cloud-video-intelligence-v1beta2-go",
+    name = "gapi-cloud-videointelligence-v1beta2-go",
+    deps = [
+        ":videointelligence_go_gapic",
+        ":videointelligence_go_gapic_srcjar-test.srcjar",
+        ":videointelligence_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "videointelligence_moved_proto",
+    srcs = [":videointelligence_proto"],
     deps = [
-        ":video_intelligence_go_gapic",
-        ":video_intelligence_go_gapic_srcjar-smoke-test.srcjar",
-        ":video_intelligence_go_gapic_srcjar-test.srcjar",
-        ":video_intelligence_go_proto",
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/longrunning:operations_proto",
+        "//google/rpc:status_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "videointelligence_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":videointelligence_moved_proto"],
+)
+
+py_grpc_library(
+    name = "videointelligence_py_grpc",
+    srcs = [":videointelligence_moved_proto"],
+    deps = [":videointelligence_py_proto"],
+)
+
+py_gapic_library(
+    name = "videointelligence_py_gapic",
+    src = ":videointelligence_proto_with_info",
+    gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1beta2",
+    service_yaml = "//google/cloud/videointelligence:videointelligence_v1beta2.yaml",
+    deps = [
+        ":videointelligence_py_grpc",
+        ":videointelligence_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "videointelligence-v1beta2-py",
+    deps = [
+        ":videointelligence_py_gapic",
+        ":videointelligence_py_grpc",
+        ":videointelligence_py_proto",
     ],
 )
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "videointelligence_php_proto",
+    deps = [":videointelligence_proto"],
+)
+
+php_grpc_library(
+    name = "videointelligence_php_grpc",
+    srcs = [":videointelligence_proto"],
+    deps = [":videointelligence_php_proto"],
+)
+
+php_gapic_library(
+    name = "videointelligence_php_gapic",
+    src = ":videointelligence_proto_with_info",
+    gapic_yaml = "videointelligence_gapic.legacy.yaml",
+    package = "google.cloud.videointelligence.v1beta2",
+    service_yaml = "//google/cloud/videointelligence:videointelligence_v1beta2.yaml",
+    deps = [
+        ":videointelligence_php_grpc",
+        ":videointelligence_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-videointelligence-v1beta2-php",
+    deps = [
+        ":videointelligence_php_gapic",
+        ":videointelligence_php_grpc",
+        ":videointelligence_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "videointelligence_nodejs_gapic",
+    src = ":videointelligence_proto_with_info",
+    gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1beta2",
+    service_yaml = "//google/cloud/videointelligence:videointelligence_v1beta2.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "videointelligence-v1beta2-nodejs",
+    deps = [
+        ":videointelligence_nodejs_gapic",
+        ":videointelligence_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "videointelligence_ruby_proto",
+    deps = [":videointelligence_proto"],
+)
+
+ruby_grpc_library(
+    name = "videointelligence_ruby_grpc",
+    srcs = [":videointelligence_proto"],
+    deps = [":videointelligence_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "videointelligence_ruby_gapic",
+    src = ":videointelligence_proto_with_info",
+    gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1beta2",
+    service_yaml = "//google/cloud/videointelligence:videointelligence_v1beta2.yaml",
+    deps = [
+        ":videointelligence_ruby_grpc",
+        ":videointelligence_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-videointelligence-v1beta2-ruby",
+    deps = [
+        ":videointelligence_ruby_gapic",
+        ":videointelligence_ruby_grpc",
+        ":videointelligence_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "videointelligence_csharp_proto",
+    deps = [":videointelligence_proto"],
+)
+
+csharp_grpc_library(
+    name = "videointelligence_csharp_grpc",
+    srcs = [":videointelligence_proto"],
+    deps = [":videointelligence_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "videointelligence_csharp_gapic",
+    src = ":videointelligence_proto_with_info",
+    gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1beta2",
+    service_yaml = "//google/cloud/videointelligence:videointelligence_v1beta2.yaml",
+    deps = [
+        ":videointelligence_csharp_grpc",
+        ":videointelligence_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-videointelligence-v1beta2-csharp",
+    deps = [
+        ":videointelligence_csharp_gapic",
+        ":videointelligence_csharp_grpc",
+        ":videointelligence_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1beta2/video_intelligence.proto b/third_party/googleapis/google/cloud/videointelligence/v1beta2/video_intelligence.proto
index a69c25791..690099751 100644
--- a/third_party/googleapis/google/cloud/videointelligence/v1beta2/video_intelligence.proto
+++ b/third_party/googleapis/google/cloud/videointelligence/v1beta2/video_intelligence.proto
@@ -1,4 +1,4 @@
-// Copyright 2017 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,12 +11,15 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.videointelligence.v1beta2;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
@@ -32,6 +35,10 @@ option ruby_package = "Google::Cloud::VideoIntelligence::V1beta2";
 
 // Service that implements Google Cloud Video Intelligence API.
 service VideoIntelligenceService {
+  option (google.api.default_host) = "videointelligence.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform";
+
   // Performs asynchronous video annotation. Progress and results can be
   // retrieved through the `google.longrunning.Operations` interface.
   // `Operation.metadata` contains `AnnotateVideoProgress` (progress).
@@ -42,6 +49,11 @@ service VideoIntelligenceService {
       post: "/v1beta2/videos:annotate"
       body: "*"
     };
+    option (google.api.method_signature) = "input_uri,features";
+    option (google.longrunning.operation_info) = {
+      response_type: "AnnotateVideoResponse"
+      metadata_type: "AnnotateVideoProgress"
+    };
   }
 }
 
@@ -52,7 +64,7 @@ message AnnotateVideoRequest {
   // supported, which must be specified in the following format:
   // `gs://bucket-id/object-id` (other URI formats return
   // [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For
-  // more information, see [Request URIs](/storage/docs/reference-uris). A video
+  // more information, see [Request URIs](https://cloud.google.com/storage/docs/request-endpoints). A video
   // URI may include wildcards in `object-id`, and thus identify multiple
   // videos. Supported wildcards: '*' to match 0 or more characters;
   // '?' to match 1 character. If unset, the input video should be embedded
@@ -64,31 +76,31 @@ message AnnotateVideoRequest {
   // If set, `input_uri` should be unset.
   bytes input_content = 6;
 
-  // Requested video annotation features.
-  repeated Feature features = 2;
+  // Required. Requested video annotation features.
+  repeated Feature features = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Additional video context and/or feature-specific parameters.
   VideoContext video_context = 3;
 
-  // Optional location where the output (in JSON format) should be stored.
+  // Optional. Location where the output (in JSON format) should be stored.
   // Currently, only [Google Cloud Storage](https://cloud.google.com/storage/)
   // URIs are supported, which must be specified in the following format:
   // `gs://bucket-id/object-id` (other URI formats return
   // [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For
-  // more information, see [Request URIs](/storage/docs/reference-uris).
-  string output_uri = 4;
+  // more information, see [Request URIs](https://cloud.google.com/storage/docs/request-endpoints).
+  string output_uri = 4 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional cloud region where annotation should take place. Supported cloud
+  // Optional. Cloud region where annotation should take place. Supported cloud
   // regions: `us-east1`, `us-west1`, `europe-west1`, `asia-east1`. If no region
   // is specified, a region will be determined based on video file location.
-  string location_id = 5;
+  string location_id = 5 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Video context and/or feature-specific parameters.
 message VideoContext {
   // Video segments to annotate. The segments may overlap and are not required
-  // to be contiguous or span the whole video. If unspecified, each video
-  // is treated as a single segment.
+  // to be contiguous or span the whole video. If unspecified, each video is
+  // treated as a single segment.
   repeated VideoSegment segments = 1;
 
   // Config for LABEL_DETECTION.
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1beta1/videointelligence_gapic.yaml b/third_party/googleapis/google/cloud/videointelligence/v1beta2/videointelligence_gapic.legacy.yaml
similarity index 68%
rename from third_party/googleapis/google/cloud/videointelligence/v1beta1/videointelligence_gapic.yaml
rename to third_party/googleapis/google/cloud/videointelligence/v1beta2/videointelligence_gapic.legacy.yaml
index 931cc445e..8f4de6e6d 100644
--- a/third_party/googleapis/google/cloud/videointelligence/v1beta1/videointelligence_gapic.yaml
+++ b/third_party/googleapis/google/cloud/videointelligence/v1beta2/videointelligence_gapic.legacy.yaml
@@ -2,23 +2,23 @@ type: com.google.api.codegen.ConfigProto
 config_schema_version: 1.0.0
 language_settings:
   java:
-    package_name: com.google.cloud.videointelligence.v1beta1
+    package_name: com.google.cloud.videointelligence.v1beta2
   python:
-    package_name: google.cloud.videointelligence_v1beta1.gapic
+    package_name: google.cloud.videointelligence_v1beta2.gapic
   go:
-    package_name: cloud.google.com/go/videointelligence/apiv1beta1
+    package_name: cloud.google.com/go/videointelligence/apiv1beta2
   csharp:
-    package_name: Google.Cloud.VideoIntelligence.V1Beta1
+    package_name: Google.Cloud.VideoIntelligence.V1Beta2
   ruby:
-    package_name: Google::Cloud::VideoIntelligence::V1beta1
+    package_name: Google::Cloud::VideoIntelligence::V1beta2
     release_level: GA
   php:
-    package_name: Google\Cloud\VideoIntelligence\V1beta1
+    package_name: Google\Cloud\VideoIntelligence\V1beta2
   nodejs:
-    package_name: videointelligence.v1beta1
+    package_name: video-intelligence.v1beta2
     domain_layer_location: google-cloud
 interfaces:
-- name: google.cloud.videointelligence.v1beta1.VideoIntelligenceService
+- name: google.cloud.videointelligence.v1beta2.VideoIntelligenceService
   collections: []
   retry_codes_def:
   - name: idempotent
@@ -44,15 +44,12 @@ interfaces:
         - input_uri
         - features
     long_running:
-      return_type: google.cloud.videointelligence.v1beta1.AnnotateVideoResponse
-      metadata_type: google.cloud.videointelligence.v1beta1.AnnotateVideoProgress
+      return_type: google.cloud.videointelligence.v1beta2.AnnotateVideoResponse
+      metadata_type: google.cloud.videointelligence.v1beta2.AnnotateVideoProgress
       initial_poll_delay_millis: 20000
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 45000
       total_poll_timeout_millis: 86400000
-    required_fields:
-      - input_uri
-      - features
     retry_codes_name: idempotent
     retry_params_name: default
     timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1beta2/videointelligence_gapic.yaml b/third_party/googleapis/google/cloud/videointelligence/v1beta2/videointelligence_gapic.yaml
index 8f4de6e6d..2e7300596 100644
--- a/third_party/googleapis/google/cloud/videointelligence/v1beta2/videointelligence_gapic.yaml
+++ b/third_party/googleapis/google/cloud/videointelligence/v1beta2/videointelligence_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.videointelligence.v1beta2
@@ -19,14 +19,6 @@ language_settings:
     domain_layer_location: google-cloud
 interfaces:
 - name: google.cloud.videointelligence.v1beta2.VideoIntelligenceService
-  collections: []
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 1000
@@ -38,21 +30,13 @@ interfaces:
     total_timeout_millis: 600000
   methods:
   - name: AnnotateVideo
-    flattening:
-      groups:
-      - parameters:
-        - input_uri
-        - features
     long_running:
-      return_type: google.cloud.videointelligence.v1beta2.AnnotateVideoResponse
-      metadata_type: google.cloud.videointelligence.v1beta2.AnnotateVideoProgress
       initial_poll_delay_millis: 20000
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 45000
       total_poll_timeout_millis: 86400000
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
     sample_code_init_fields:
     - input_uri=gs://cloud-samples-data/video/cat.mp4
     - features[0]=LABEL_DETECTION
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1beta2/videointelligence_grpc_service_config.json b/third_party/googleapis/google/cloud/videointelligence/v1beta2/videointelligence_grpc_service_config.json
new file mode 100755
index 000000000..cf66cb592
--- /dev/null
+++ b/third_party/googleapis/google/cloud/videointelligence/v1beta2/videointelligence_grpc_service_config.json
@@ -0,0 +1,22 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.videointelligence.v1beta2.VideoIntelligenceService",
+          "method": "AnnotateVideo"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "1s",
+        "maxBackoff": "120s",
+        "backoffMultiplier": 2.5,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1p1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/videointelligence/v1p1beta1/BUILD.bazel
index 6d5193091..171db7c3d 100644
--- a/third_party/googleapis/google/cloud/videointelligence/v1p1beta1/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/videointelligence/v1p1beta1/BUILD.bazel
@@ -1,18 +1,23 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
-    name = "video_intelligence_proto",
+    name = "videointelligence_proto",
     srcs = [
         "video_intelligence.proto",
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
         "//google/longrunning:operations_proto",
         "//google/rpc:status_proto",
         "@com_google_protobuf//:duration_proto",
@@ -21,8 +26,11 @@ proto_library(
 )
 
 proto_library_with_info(
-    name = "video_intelligence_proto_with_info",
-    deps = [":video_intelligence_proto"],
+    name = "videointelligence_proto_with_info",
+    deps = [
+        ":videointelligence_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -30,71 +38,55 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
-    name = "video_intelligence_java_proto",
-    deps = [":video_intelligence_proto"],
+    name = "videointelligence_java_proto",
+    deps = [":videointelligence_proto"],
 )
 
 java_grpc_library(
-    name = "video_intelligence_java_grpc",
-    srcs = [":video_intelligence_proto"],
-    deps = [":video_intelligence_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "video_intelligence_resource_name_java_proto",
-    gapic_yaml = "videointelligence_gapic.yaml",
-    deps = [":video_intelligence_proto"],
+    name = "videointelligence_java_grpc",
+    srcs = [":videointelligence_proto"],
+    deps = [":videointelligence_java_proto"],
 )
 
 java_gapic_library(
-    name = "video_intelligence_java_gapic",
-    src = ":video_intelligence_proto_with_info",
+    name = "videointelligence_java_gapic",
+    src = ":videointelligence_proto_with_info",
     gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1p1beta1",
     service_yaml = "//google/cloud/videointelligence:videointelligence_v1p1beta1.yaml",
-    test_deps = [":video_intelligence_java_grpc"],
+    test_deps = [
+        ":videointelligence_java_grpc",
+    ],
     deps = [
-        ":video_intelligence_java_proto",
-        ":video_intelligence_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+        ":videointelligence_java_proto",
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":video_intelligence_java_gapic_test",
+java_gapic_test(
+    name = "videointelligence_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.videointelligence.v1p1beta1.VideoIntelligenceServiceClientTest",
     ],
-) for test_name in [
-    "com.google.cloud.videointelligence.v1p1beta1.VideoIntelligenceServiceClientTest",
-]]
+    runtime_deps = [":videointelligence_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
-    name = "google-cloud-video-intelligence-v1p1beta1-java",
-    client_deps = [":video_intelligence_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":video_intelligence_java_gapic_test"],
-    grpc_deps = [":video_intelligence_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
-        ":video_intelligence_java_proto",
-        ":video_intelligence_proto",
-        ":video_intelligence_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    name = "google-cloud-videointelligence-v1p1beta1-java",
+    deps = [
+        ":videointelligence_java_gapic",
+        ":videointelligence_java_grpc",
+        ":videointelligence_java_proto",
+        ":videointelligence_proto",
+    ],
 )
 
 ##############################################################################
@@ -102,17 +94,17 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
-    name = "video_intelligence_go_proto",
+    name = "videointelligence_go_proto",
     compilers = ["@io_bazel_rules_go//proto:go_grpc"],
     importpath = "google.golang.org/genproto/googleapis/cloud/videointelligence/v1p1beta1",
-    protos = [":video_intelligence_proto"],
+    protos = [":videointelligence_proto"],
     deps = [
         "//google/api:annotations_go_proto",
         "//google/longrunning:longrunning_go_proto",
@@ -121,33 +113,257 @@ go_proto_library(
 )
 
 go_gapic_library(
-    name = "video_intelligence_go_gapic",
-    src = ":video_intelligence_proto_with_info",
-    gapic_yaml = "videointelligence_gapic.yaml",
-    importpath = "cloud.google.com/go/videointelligence/apiv1p1beta1",
+    name = "videointelligence_go_gapic",
+    srcs = [":videointelligence_proto_with_info"],
+    grpc_service_config = "videointelligence_grpc_service_config.json",
+    importpath = "cloud.google.com/go/videointelligence/apiv1p1beta1;videointelligence",
     service_yaml = "//google/cloud/videointelligence:videointelligence_v1p1beta1.yaml",
     deps = [
-        ":video_intelligence_go_proto",
+        ":videointelligence_go_proto",
         "//google/longrunning:longrunning_go_gapic",
         "//google/longrunning:longrunning_go_proto",
         "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
     ],
 )
 
 go_test(
-    name = "video_intelligence_go_gapic_test",
-    srcs = [":video_intelligence_go_gapic_srcjar_test"],
-    embed = [":video_intelligence_go_gapic"],
+    name = "videointelligence_go_gapic_test",
+    srcs = [":videointelligence_go_gapic_srcjar_test"],
+    embed = [":videointelligence_go_gapic"],
     importpath = "cloud.google.com/go/videointelligence/apiv1p1beta1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
-    name = "gapi-cloud-video-intelligence-v1p1beta1-go",
+    name = "gapi-cloud-videointelligence-v1p1beta1-go",
+    deps = [
+        ":videointelligence_go_gapic",
+        ":videointelligence_go_gapic_srcjar-test.srcjar",
+        ":videointelligence_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "videointelligence_moved_proto",
+    srcs = [":videointelligence_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/longrunning:operations_proto",
+        "//google/rpc:status_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "videointelligence_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":videointelligence_moved_proto"],
+)
+
+py_grpc_library(
+    name = "videointelligence_py_grpc",
+    srcs = [":videointelligence_moved_proto"],
+    deps = [":videointelligence_py_proto"],
+)
+
+py_gapic_library(
+    name = "videointelligence_py_gapic",
+    src = ":videointelligence_proto_with_info",
+    gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1p1beta1",
+    service_yaml = "//google/cloud/videointelligence:videointelligence_v1p1beta1.yaml",
+    deps = [
+        ":videointelligence_py_grpc",
+        ":videointelligence_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "videointelligence-v1p1beta1-py",
+    deps = [
+        ":videointelligence_py_gapic",
+        ":videointelligence_py_grpc",
+        ":videointelligence_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "videointelligence_php_proto",
+    deps = [":videointelligence_proto"],
+)
+
+php_grpc_library(
+    name = "videointelligence_php_grpc",
+    srcs = [":videointelligence_proto"],
+    deps = [":videointelligence_php_proto"],
+)
+
+php_gapic_library(
+    name = "videointelligence_php_gapic",
+    src = ":videointelligence_proto_with_info",
+    gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1p1beta1",
+    service_yaml = "//google/cloud/videointelligence:videointelligence_v1p1beta1.yaml",
+    deps = [
+        ":videointelligence_php_grpc",
+        ":videointelligence_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-videointelligence-v1p1beta1-php",
+    deps = [
+        ":videointelligence_php_gapic",
+        ":videointelligence_php_grpc",
+        ":videointelligence_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "videointelligence_nodejs_gapic",
+    src = ":videointelligence_proto_with_info",
+    gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1p1beta1",
+    service_yaml = "//google/cloud/videointelligence:videointelligence_v1p1beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "videointelligence-v1p1beta1-nodejs",
+    deps = [
+        ":videointelligence_nodejs_gapic",
+        ":videointelligence_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "videointelligence_ruby_proto",
+    deps = [":videointelligence_proto"],
+)
+
+ruby_grpc_library(
+    name = "videointelligence_ruby_grpc",
+    srcs = [":videointelligence_proto"],
+    deps = [":videointelligence_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "videointelligence_ruby_gapic",
+    src = ":videointelligence_proto_with_info",
+    gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1p1beta1",
+    service_yaml = "//google/cloud/videointelligence:videointelligence_v1p1beta1.yaml",
+    deps = [
+        ":videointelligence_ruby_grpc",
+        ":videointelligence_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-videointelligence-v1p1beta1-ruby",
+    deps = [
+        ":videointelligence_ruby_gapic",
+        ":videointelligence_ruby_grpc",
+        ":videointelligence_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "videointelligence_csharp_proto",
+    deps = [":videointelligence_proto"],
+)
+
+csharp_grpc_library(
+    name = "videointelligence_csharp_grpc",
+    srcs = [":videointelligence_proto"],
+    deps = [":videointelligence_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "videointelligence_csharp_gapic",
+    src = ":videointelligence_proto_with_info",
+    gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1p1beta1",
+    service_yaml = "//google/cloud/videointelligence:videointelligence_v1p1beta1.yaml",
+    deps = [
+        ":videointelligence_csharp_grpc",
+        ":videointelligence_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-videointelligence-v1p1beta1-csharp",
     deps = [
-        ":video_intelligence_go_gapic",
-        ":video_intelligence_go_gapic_srcjar-smoke-test.srcjar",
-        ":video_intelligence_go_gapic_srcjar-test.srcjar",
-        ":video_intelligence_go_proto",
+        ":videointelligence_csharp_gapic",
+        ":videointelligence_csharp_grpc",
+        ":videointelligence_csharp_proto",
     ],
 )
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1p1beta1/video_intelligence.proto b/third_party/googleapis/google/cloud/videointelligence/v1p1beta1/video_intelligence.proto
index 115f362be..a54bddd07 100644
--- a/third_party/googleapis/google/cloud/videointelligence/v1p1beta1/video_intelligence.proto
+++ b/third_party/googleapis/google/cloud/videointelligence/v1p1beta1/video_intelligence.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,12 +11,15 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.videointelligence.v1p1beta1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
@@ -32,16 +35,23 @@ option ruby_package = "Google::Cloud::VideoIntelligence::V1p1beta1";
 
 // Service that implements Google Cloud Video Intelligence API.
 service VideoIntelligenceService {
+  option (google.api.default_host) = "videointelligence.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Performs asynchronous video annotation. Progress and results can be
   // retrieved through the `google.longrunning.Operations` interface.
   // `Operation.metadata` contains `AnnotateVideoProgress` (progress).
   // `Operation.response` contains `AnnotateVideoResponse` (results).
-  rpc AnnotateVideo(AnnotateVideoRequest)
-      returns (google.longrunning.Operation) {
+  rpc AnnotateVideo(AnnotateVideoRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v1p1beta1/videos:annotate"
       body: "*"
     };
+    option (google.api.method_signature) = "input_uri,features";
+    option (google.longrunning.operation_info) = {
+      response_type: "AnnotateVideoResponse"
+      metadata_type: "AnnotateVideoProgress"
+    };
   }
 }
 
@@ -51,10 +61,10 @@ message AnnotateVideoRequest {
   // [Google Cloud Storage](https://cloud.google.com/storage/) URIs are
   // supported, which must be specified in the following format:
   // `gs://bucket-id/object-id` (other URI formats return
-  // [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For
-  // more information, see [Request URIs](/storage/docs/reference-uris). A video
-  // URI may include wildcards in `object-id`, and thus identify multiple
-  // videos. Supported wildcards: '*' to match 0 or more characters;
+  // [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For more information, see
+  // [Request URIs](https://cloud.google.com/storage/docs/request-endpoints).
+  // A video URI may include wildcards in `object-id`, and thus identify
+  // multiple videos. Supported wildcards: '*' to match 0 or more characters;
   // '?' to match 1 character. If unset, the input video should be embedded
   // in the request as `input_content`. If set, `input_content` should be unset.
   string input_uri = 1;
@@ -64,24 +74,24 @@ message AnnotateVideoRequest {
   // If set, `input_uri` should be unset.
   bytes input_content = 6;
 
-  // Requested video annotation features.
-  repeated Feature features = 2;
+  // Required. Requested video annotation features.
+  repeated Feature features = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Additional video context and/or feature-specific parameters.
   VideoContext video_context = 3;
 
-  // Optional location where the output (in JSON format) should be stored.
+  // Optional. Location where the output (in JSON format) should be stored.
   // Currently, only [Google Cloud Storage](https://cloud.google.com/storage/)
   // URIs are supported, which must be specified in the following format:
   // `gs://bucket-id/object-id` (other URI formats return
-  // [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For
-  // more information, see [Request URIs](/storage/docs/reference-uris).
-  string output_uri = 4;
+  // [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For more information, see
+  // [Request URIs](https://cloud.google.com/storage/docs/request-endpoints).
+  string output_uri = 4 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional cloud region where annotation should take place. Supported cloud
+  // Optional. Cloud region where annotation should take place. Supported cloud
   // regions: `us-east1`, `us-west1`, `europe-west1`, `asia-east1`. If no region
   // is specified, a region will be determined based on video file location.
-  string location_id = 5;
+  string location_id = 5 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Video context and/or feature-specific parameters.
@@ -285,60 +295,60 @@ message AnnotateVideoProgress {
 
 // Config for SPEECH_TRANSCRIPTION.
 message SpeechTranscriptionConfig {
-  // *Required* The language of the supplied audio as a
+  // Required. *Required* The language of the supplied audio as a
   // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag.
   // Example: "en-US".
   // See [Language Support](https://cloud.google.com/speech/docs/languages)
   // for a list of the currently supported language codes.
-  string language_code = 1;
+  string language_code = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // *Optional* Maximum number of recognition hypotheses to be returned.
+  // Optional. Maximum number of recognition hypotheses to be returned.
   // Specifically, the maximum number of `SpeechRecognitionAlternative` messages
-  // within each `SpeechRecognitionResult`. The server may return fewer than
+  // within each `SpeechTranscription`. The server may return fewer than
   // `max_alternatives`. Valid values are `0`-`30`. A value of `0` or `1` will
   // return a maximum of one. If omitted, will return a maximum of one.
-  int32 max_alternatives = 2;
+  int32 max_alternatives = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // *Optional* If set to `true`, the server will attempt to filter out
+  // Optional. If set to `true`, the server will attempt to filter out
   // profanities, replacing all but the initial character in each filtered word
   // with asterisks, e.g. "f***". If set to `false` or omitted, profanities
   // won't be filtered out.
-  bool filter_profanity = 3;
+  bool filter_profanity = 3 [(google.api.field_behavior) = OPTIONAL];
 
-  // *Optional* A means to provide context to assist the speech recognition.
-  repeated SpeechContext speech_contexts = 4;
+  // Optional. A means to provide context to assist the speech recognition.
+  repeated SpeechContext speech_contexts = 4 [(google.api.field_behavior) = OPTIONAL];
 
-  // *Optional* If 'true', adds punctuation to recognition result hypotheses.
+  // Optional. If 'true', adds punctuation to recognition result hypotheses.
   // This feature is only available in select languages. Setting this for
   // requests in other languages has no effect at all. The default 'false' value
   // does not add punctuation to result hypotheses. NOTE: "This is currently
   // offered as an experimental service, complimentary to all users. In the
   // future this may be exclusively available as a premium feature."
-  bool enable_automatic_punctuation = 5;
+  bool enable_automatic_punctuation = 5 [(google.api.field_behavior) = OPTIONAL];
 
-  // *Optional* For file formats, such as MXF or MKV, supporting multiple audio
+  // Optional. For file formats, such as MXF or MKV, supporting multiple audio
   // tracks, specify up to two tracks. Default: track 0.
-  repeated int32 audio_tracks = 6;
+  repeated int32 audio_tracks = 6 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Provides "hints" to the speech recognizer to favor specific words and phrases
 // in the results.
 message SpeechContext {
-  // *Optional* A list of strings containing words and phrases "hints" so that
+  // Optional. A list of strings containing words and phrases "hints" so that
   // the speech recognition is more likely to recognize them. This can be used
   // to improve the accuracy for specific words and phrases, for example, if
   // specific commands are typically spoken by the user. This can also be used
   // to add additional words to the vocabulary of the recognizer. See
   // [usage limits](https://cloud.google.com/speech/limits#content).
-  repeated string phrases = 1;
+  repeated string phrases = 1 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // A speech recognition result corresponding to a portion of the audio.
 message SpeechTranscription {
-  // Output only. May contain one or more recognition hypotheses (up to the
-  // maximum specified in `max_alternatives`).
-  // These alternatives are ordered in terms of accuracy, with the top (first)
-  // alternative being the most probable, as ranked by the recognizer.
+  // May contain one or more recognition hypotheses (up to the maximum specified
+  // in `max_alternatives`).  These alternatives are ordered in terms of
+  // accuracy, with the top (first) alternative being the most probable, as
+  // ranked by the recognizer.
   repeated SpeechRecognitionAlternative alternatives = 1;
 }
 
@@ -349,11 +359,11 @@ message SpeechRecognitionAlternative {
 
   // Output only. The confidence estimate between 0.0 and 1.0. A higher number
   // indicates an estimated greater likelihood that the recognized words are
-  // correct. This field is typically provided only for the top hypothesis, and
-  // only for `is_final=true` results. Clients should not rely on the
-  // `confidence` field as it is not guaranteed to be accurate or consistent.
+  // correct. This field is set only for the top alternative.
+  // This field is not guaranteed to be accurate and users should not rely on it
+  // to be always provided.
   // The default of 0.0 is a sentinel value indicating `confidence` was not set.
-  float confidence = 2;
+  float confidence = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. A list of word-specific information for each recognized word.
   repeated WordInfo words = 3;
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1p1beta1/videointelligence_gapic.legacy.yaml b/third_party/googleapis/google/cloud/videointelligence/v1p1beta1/videointelligence_gapic.legacy.yaml
new file mode 100644
index 000000000..dbf690434
--- /dev/null
+++ b/third_party/googleapis/google/cloud/videointelligence/v1p1beta1/videointelligence_gapic.legacy.yaml
@@ -0,0 +1,63 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.videointelligence.v1p1beta1
+  python:
+    package_name: google.cloud.videointelligence_v1p1beta1.gapic
+  go:
+    package_name: cloud.google.com/go/videointelligence/apiv1p1beta1
+  csharp:
+    package_name: Google.Cloud.VideoIntelligence.V1P1Beta1
+  ruby:
+    package_name: Google::Cloud::VideoIntelligence::V1p1beta1
+    release_level: BETA
+  php:
+    package_name: Google\Cloud\VideoIntelligence\V1p1beta1
+  nodejs:
+    package_name: video-intelligence.v1p1beta1
+    domain_layer_location: google-cloud
+interfaces:
+- name: google.cloud.videointelligence.v1p1beta1.VideoIntelligenceService
+  smoke_test:
+    method: AnnotateVideo
+    init_fields:
+    - input_uri=gs://cloud-samples-data/video/cat.mp4
+    - features[0]=LABEL_DETECTION
+  collections: []
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 1000
+    retry_delay_multiplier: 2.5
+    max_retry_delay_millis: 120000
+    initial_rpc_timeout_millis: 120000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 120000
+    total_timeout_millis: 600000
+  methods:
+  - name: AnnotateVideo
+    flattening:
+      groups:
+      - parameters:
+        - input_uri
+        - features
+    long_running:
+      return_type: google.cloud.videointelligence.v1p1beta1.AnnotateVideoResponse
+      metadata_type: google.cloud.videointelligence.v1p1beta1.AnnotateVideoProgress
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    sample_code_init_fields:
+    - input_uri=gs://cloud-samples-data/video/cat.mp4
+    - features[0]=LABEL_DETECTION
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1p1beta1/videointelligence_gapic.yaml b/third_party/googleapis/google/cloud/videointelligence/v1p1beta1/videointelligence_gapic.yaml
index dbf690434..fd08cb97c 100644
--- a/third_party/googleapis/google/cloud/videointelligence/v1p1beta1/videointelligence_gapic.yaml
+++ b/third_party/googleapis/google/cloud/videointelligence/v1p1beta1/videointelligence_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.videointelligence.v1p1beta1
@@ -24,14 +24,6 @@ interfaces:
     init_fields:
     - input_uri=gs://cloud-samples-data/video/cat.mp4
     - features[0]=LABEL_DETECTION
-  collections: []
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 1000
@@ -43,21 +35,13 @@ interfaces:
     total_timeout_millis: 600000
   methods:
   - name: AnnotateVideo
-    flattening:
-      groups:
-      - parameters:
-        - input_uri
-        - features
     long_running:
-      return_type: google.cloud.videointelligence.v1p1beta1.AnnotateVideoResponse
-      metadata_type: google.cloud.videointelligence.v1p1beta1.AnnotateVideoProgress
       initial_poll_delay_millis: 20000
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 45000
       total_poll_timeout_millis: 86400000
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
     sample_code_init_fields:
     - input_uri=gs://cloud-samples-data/video/cat.mp4
     - features[0]=LABEL_DETECTION
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1p1beta1/videointelligence_grpc_service_config.json b/third_party/googleapis/google/cloud/videointelligence/v1p1beta1/videointelligence_grpc_service_config.json
new file mode 100755
index 000000000..8e28530cc
--- /dev/null
+++ b/third_party/googleapis/google/cloud/videointelligence/v1p1beta1/videointelligence_grpc_service_config.json
@@ -0,0 +1,22 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.videointelligence.v1p1beta1.VideoIntelligenceService",
+          "method": "AnnotateVideo"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "1s",
+        "maxBackoff": "120s",
+        "backoffMultiplier": 2.5,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1p2beta1/BUILD.bazel b/third_party/googleapis/google/cloud/videointelligence/v1p2beta1/BUILD.bazel
index 2de852107..cba21e1f1 100644
--- a/third_party/googleapis/google/cloud/videointelligence/v1p2beta1/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/videointelligence/v1p2beta1/BUILD.bazel
@@ -1,18 +1,23 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
-    name = "video_intelligence_proto",
+    name = "videointelligence_proto",
     srcs = [
         "video_intelligence.proto",
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
         "//google/longrunning:operations_proto",
         "//google/rpc:status_proto",
         "@com_google_protobuf//:duration_proto",
@@ -21,8 +26,11 @@ proto_library(
 )
 
 proto_library_with_info(
-    name = "video_intelligence_proto_with_info",
-    deps = [":video_intelligence_proto"],
+    name = "videointelligence_proto_with_info",
+    deps = [
+        ":videointelligence_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -30,71 +38,55 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
-    name = "video_intelligence_java_proto",
-    deps = [":video_intelligence_proto"],
+    name = "videointelligence_java_proto",
+    deps = [":videointelligence_proto"],
 )
 
 java_grpc_library(
-    name = "video_intelligence_java_grpc",
-    srcs = [":video_intelligence_proto"],
-    deps = [":video_intelligence_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "video_intelligence_resource_name_java_proto",
-    gapic_yaml = "videointelligence_gapic.yaml",
-    deps = [":video_intelligence_proto"],
+    name = "videointelligence_java_grpc",
+    srcs = [":videointelligence_proto"],
+    deps = [":videointelligence_java_proto"],
 )
 
 java_gapic_library(
-    name = "video_intelligence_java_gapic",
-    src = ":video_intelligence_proto_with_info",
+    name = "videointelligence_java_gapic",
+    src = ":videointelligence_proto_with_info",
     gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1p2beta1",
     service_yaml = "//google/cloud/videointelligence:videointelligence_v1p2beta1.yaml",
-    test_deps = [":video_intelligence_java_grpc"],
+    test_deps = [
+        ":videointelligence_java_grpc",
+    ],
     deps = [
-        ":video_intelligence_java_proto",
-        ":video_intelligence_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+        ":videointelligence_java_proto",
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":video_intelligence_java_gapic_test",
+java_gapic_test(
+    name = "videointelligence_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.videointelligence.v1p2beta1.VideoIntelligenceServiceClientTest",
     ],
-) for test_name in [
-    "com.google.cloud.videointelligence.v1p2beta1.VideoIntelligenceServiceClientTest",
-]]
+    runtime_deps = [":videointelligence_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
-    name = "google-cloud-video-intelligence-v1p2beta1-java",
-    client_deps = [":video_intelligence_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":video_intelligence_java_gapic_test"],
-    grpc_deps = [":video_intelligence_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
-        ":video_intelligence_java_proto",
-        ":video_intelligence_proto",
-        ":video_intelligence_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    name = "google-cloud-videointelligence-v1p2beta1-java",
+    deps = [
+        ":videointelligence_java_gapic",
+        ":videointelligence_java_grpc",
+        ":videointelligence_java_proto",
+        ":videointelligence_proto",
+    ],
 )
 
 ##############################################################################
@@ -102,17 +94,17 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
-    name = "video_intelligence_go_proto",
+    name = "videointelligence_go_proto",
     compilers = ["@io_bazel_rules_go//proto:go_grpc"],
     importpath = "google.golang.org/genproto/googleapis/cloud/videointelligence/v1p2beta1",
-    protos = [":video_intelligence_proto"],
+    protos = [":videointelligence_proto"],
     deps = [
         "//google/api:annotations_go_proto",
         "//google/longrunning:longrunning_go_proto",
@@ -121,33 +113,257 @@ go_proto_library(
 )
 
 go_gapic_library(
-    name = "video_intelligence_go_gapic",
-    src = ":video_intelligence_proto_with_info",
-    gapic_yaml = "videointelligence_gapic.yaml",
-    importpath = "cloud.google.com/go/videointelligence/apiv1p2beta1",
+    name = "videointelligence_go_gapic",
+    srcs = [":videointelligence_proto_with_info"],
+    grpc_service_config = "videointelligence_grpc_service_config.json",
+    importpath = "cloud.google.com/go/videointelligence/apiv1p2beta1;videointelligence",
     service_yaml = "//google/cloud/videointelligence:videointelligence_v1p2beta1.yaml",
     deps = [
-        ":video_intelligence_go_proto",
+        ":videointelligence_go_proto",
         "//google/longrunning:longrunning_go_gapic",
         "//google/longrunning:longrunning_go_proto",
         "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
     ],
 )
 
 go_test(
-    name = "video_intelligence_go_gapic_test",
-    srcs = [":video_intelligence_go_gapic_srcjar_test"],
-    embed = [":video_intelligence_go_gapic"],
+    name = "videointelligence_go_gapic_test",
+    srcs = [":videointelligence_go_gapic_srcjar_test"],
+    embed = [":videointelligence_go_gapic"],
     importpath = "cloud.google.com/go/videointelligence/apiv1p2beta1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
-    name = "gapi-cloud-video-intelligence-v1p2beta1-go",
+    name = "gapi-cloud-videointelligence-v1p2beta1-go",
+    deps = [
+        ":videointelligence_go_gapic",
+        ":videointelligence_go_gapic_srcjar-test.srcjar",
+        ":videointelligence_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "videointelligence_moved_proto",
+    srcs = [":videointelligence_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/longrunning:operations_proto",
+        "//google/rpc:status_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "videointelligence_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":videointelligence_moved_proto"],
+)
+
+py_grpc_library(
+    name = "videointelligence_py_grpc",
+    srcs = [":videointelligence_moved_proto"],
+    deps = [":videointelligence_py_proto"],
+)
+
+py_gapic_library(
+    name = "videointelligence_py_gapic",
+    src = ":videointelligence_proto_with_info",
+    gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1p2beta1",
+    service_yaml = "//google/cloud/videointelligence:videointelligence_v1p2beta1.yaml",
+    deps = [
+        ":videointelligence_py_grpc",
+        ":videointelligence_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "videointelligence-v1p2beta1-py",
+    deps = [
+        ":videointelligence_py_gapic",
+        ":videointelligence_py_grpc",
+        ":videointelligence_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "videointelligence_php_proto",
+    deps = [":videointelligence_proto"],
+)
+
+php_grpc_library(
+    name = "videointelligence_php_grpc",
+    srcs = [":videointelligence_proto"],
+    deps = [":videointelligence_php_proto"],
+)
+
+php_gapic_library(
+    name = "videointelligence_php_gapic",
+    src = ":videointelligence_proto_with_info",
+    gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1p2beta1",
+    service_yaml = "//google/cloud/videointelligence:videointelligence_v1p2beta1.yaml",
+    deps = [
+        ":videointelligence_php_grpc",
+        ":videointelligence_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-videointelligence-v1p2beta1-php",
+    deps = [
+        ":videointelligence_php_gapic",
+        ":videointelligence_php_grpc",
+        ":videointelligence_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "videointelligence_nodejs_gapic",
+    src = ":videointelligence_proto_with_info",
+    gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1p2beta1",
+    service_yaml = "//google/cloud/videointelligence:videointelligence_v1p2beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "videointelligence-v1p2beta1-nodejs",
+    deps = [
+        ":videointelligence_nodejs_gapic",
+        ":videointelligence_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "videointelligence_ruby_proto",
+    deps = [":videointelligence_proto"],
+)
+
+ruby_grpc_library(
+    name = "videointelligence_ruby_grpc",
+    srcs = [":videointelligence_proto"],
+    deps = [":videointelligence_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "videointelligence_ruby_gapic",
+    src = ":videointelligence_proto_with_info",
+    gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1p2beta1",
+    service_yaml = "//google/cloud/videointelligence:videointelligence_v1p2beta1.yaml",
+    deps = [
+        ":videointelligence_ruby_grpc",
+        ":videointelligence_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-videointelligence-v1p2beta1-ruby",
+    deps = [
+        ":videointelligence_ruby_gapic",
+        ":videointelligence_ruby_grpc",
+        ":videointelligence_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "videointelligence_csharp_proto",
+    deps = [":videointelligence_proto"],
+)
+
+csharp_grpc_library(
+    name = "videointelligence_csharp_grpc",
+    srcs = [":videointelligence_proto"],
+    deps = [":videointelligence_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "videointelligence_csharp_gapic",
+    src = ":videointelligence_proto_with_info",
+    gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1p2beta1",
+    service_yaml = "//google/cloud/videointelligence:videointelligence_v1p2beta1.yaml",
+    deps = [
+        ":videointelligence_csharp_grpc",
+        ":videointelligence_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-videointelligence-v1p2beta1-csharp",
     deps = [
-        ":video_intelligence_go_gapic",
-        ":video_intelligence_go_gapic_srcjar-smoke-test.srcjar",
-        ":video_intelligence_go_gapic_srcjar-test.srcjar",
-        ":video_intelligence_go_proto",
+        ":videointelligence_csharp_gapic",
+        ":videointelligence_csharp_grpc",
+        ":videointelligence_csharp_proto",
     ],
 )
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1p2beta1/video_intelligence.proto b/third_party/googleapis/google/cloud/videointelligence/v1p2beta1/video_intelligence.proto
index 0a16e7afd..3b1d51cd7 100644
--- a/third_party/googleapis/google/cloud/videointelligence/v1p2beta1/video_intelligence.proto
+++ b/third_party/googleapis/google/cloud/videointelligence/v1p2beta1/video_intelligence.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,6 +18,8 @@ syntax = "proto3";
 package google.cloud.videointelligence.v1p2beta1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
@@ -33,16 +35,23 @@ option ruby_package = "Google::Cloud::VideoIntelligence::V1p2beta1";
 
 // Service that implements Google Cloud Video Intelligence API.
 service VideoIntelligenceService {
+  option (google.api.default_host) = "videointelligence.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Performs asynchronous video annotation. Progress and results can be
   // retrieved through the `google.longrunning.Operations` interface.
   // `Operation.metadata` contains `AnnotateVideoProgress` (progress).
   // `Operation.response` contains `AnnotateVideoResponse` (results).
-  rpc AnnotateVideo(AnnotateVideoRequest)
-      returns (google.longrunning.Operation) {
+  rpc AnnotateVideo(AnnotateVideoRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v1p2beta1/videos:annotate"
       body: "*"
     };
+    option (google.api.method_signature) = "input_uri,features";
+    option (google.longrunning.operation_info) = {
+      response_type: "AnnotateVideoResponse"
+      metadata_type: "AnnotateVideoProgress"
+    };
   }
 }
 
@@ -52,10 +61,10 @@ message AnnotateVideoRequest {
   // [Google Cloud Storage](https://cloud.google.com/storage/) URIs are
   // supported, which must be specified in the following format:
   // `gs://bucket-id/object-id` (other URI formats return
-  // [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For
-  // more information, see [Request URIs](/storage/docs/reference-uris). A video
-  // URI may include wildcards in `object-id`, and thus identify multiple
-  // videos. Supported wildcards: '*' to match 0 or more characters;
+  // [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For more information, see
+  // [Request URIs](https://cloud.google.com/storage/docs/request-endpoints).
+  // A video URI may include wildcards in `object-id`, and thus identify
+  // multiple videos. Supported wildcards: '*' to match 0 or more characters;
   // '?' to match 1 character. If unset, the input video should be embedded
   // in the request as `input_content`. If set, `input_content` should be unset.
   string input_uri = 1;
@@ -65,24 +74,24 @@ message AnnotateVideoRequest {
   // If set, `input_uri` should be unset.
   bytes input_content = 6;
 
-  // Requested video annotation features.
-  repeated Feature features = 2;
+  // Required. Requested video annotation features.
+  repeated Feature features = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Additional video context and/or feature-specific parameters.
   VideoContext video_context = 3;
 
-  // Optional location where the output (in JSON format) should be stored.
+  // Optional. Location where the output (in JSON format) should be stored.
   // Currently, only [Google Cloud Storage](https://cloud.google.com/storage/)
   // URIs are supported, which must be specified in the following format:
   // `gs://bucket-id/object-id` (other URI formats return
-  // [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For
-  // more information, see [Request URIs](/storage/docs/reference-uris).
-  string output_uri = 4;
+  // [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For more information, see
+  // [Request URIs](https://cloud.google.com/storage/docs/request-endpoints).
+  string output_uri = 4 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional cloud region where annotation should take place. Supported cloud
+  // Optional. Cloud region where annotation should take place. Supported cloud
   // regions: `us-east1`, `us-west1`, `europe-west1`, `asia-east1`. If no region
   // is specified, a region will be determined based on video file location.
-  string location_id = 5;
+  string location_id = 5 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Video context and/or feature-specific parameters.
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1p2beta1/videointelligence_gapic.legacy.yaml b/third_party/googleapis/google/cloud/videointelligence/v1p2beta1/videointelligence_gapic.legacy.yaml
new file mode 100644
index 000000000..c627a5d1c
--- /dev/null
+++ b/third_party/googleapis/google/cloud/videointelligence/v1p2beta1/videointelligence_gapic.legacy.yaml
@@ -0,0 +1,63 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.videointelligence.v1p2beta1
+  python:
+    package_name: google.cloud.videointelligence_v1p2beta1.gapic
+  go:
+    package_name: cloud.google.com/go/videointelligence/apiv1p2beta1
+  csharp:
+    package_name: Google.Cloud.VideoIntelligence.V1P2Beta1
+  ruby:
+    package_name: Google::Cloud::VideoIntelligence::V1p2beta1
+    release_level: BETA
+  php:
+    package_name: Google\Cloud\VideoIntelligence\V1p2beta1
+  nodejs:
+    package_name: video-intelligence.v1p2beta1
+    domain_layer_location: google-cloud
+interfaces:
+- name: google.cloud.videointelligence.v1p2beta1.VideoIntelligenceService
+  smoke_test:
+    method: AnnotateVideo
+    init_fields:
+    - input_uri=gs://cloud-samples-data/video/cat.mp4
+    - features[0]=LABEL_DETECTION
+  collections: []
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 1000
+    retry_delay_multiplier: 2.5
+    max_retry_delay_millis: 120000
+    initial_rpc_timeout_millis: 120000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 120000
+    total_timeout_millis: 600000
+  methods:
+  - name: AnnotateVideo
+    flattening:
+      groups:
+      - parameters:
+        - input_uri
+        - features
+    long_running:
+      return_type: google.cloud.videointelligence.v1p2beta1.AnnotateVideoResponse
+      metadata_type: google.cloud.videointelligence.v1p2beta1.AnnotateVideoProgress
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    sample_code_init_fields:
+    - input_uri=gs://cloud-samples-data/video/cat.mp4
+    - features[0]=LABEL_DETECTION
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1p2beta1/videointelligence_gapic.yaml b/third_party/googleapis/google/cloud/videointelligence/v1p2beta1/videointelligence_gapic.yaml
index c627a5d1c..5e040d7b8 100644
--- a/third_party/googleapis/google/cloud/videointelligence/v1p2beta1/videointelligence_gapic.yaml
+++ b/third_party/googleapis/google/cloud/videointelligence/v1p2beta1/videointelligence_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.videointelligence.v1p2beta1
@@ -24,14 +24,6 @@ interfaces:
     init_fields:
     - input_uri=gs://cloud-samples-data/video/cat.mp4
     - features[0]=LABEL_DETECTION
-  collections: []
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 1000
@@ -43,21 +35,13 @@ interfaces:
     total_timeout_millis: 600000
   methods:
   - name: AnnotateVideo
-    flattening:
-      groups:
-      - parameters:
-        - input_uri
-        - features
     long_running:
-      return_type: google.cloud.videointelligence.v1p2beta1.AnnotateVideoResponse
-      metadata_type: google.cloud.videointelligence.v1p2beta1.AnnotateVideoProgress
       initial_poll_delay_millis: 20000
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 45000
       total_poll_timeout_millis: 86400000
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
     sample_code_init_fields:
     - input_uri=gs://cloud-samples-data/video/cat.mp4
     - features[0]=LABEL_DETECTION
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1p2beta1/videointelligence_grpc_service_config.json b/third_party/googleapis/google/cloud/videointelligence/v1p2beta1/videointelligence_grpc_service_config.json
new file mode 100755
index 000000000..cdc6efce8
--- /dev/null
+++ b/third_party/googleapis/google/cloud/videointelligence/v1p2beta1/videointelligence_grpc_service_config.json
@@ -0,0 +1,22 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.videointelligence.v1p2beta1.VideoIntelligenceService",
+          "method": "AnnotateVideo"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "1s",
+        "maxBackoff": "120s",
+        "backoffMultiplier": 2.5,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1p3beta1/BUILD.bazel b/third_party/googleapis/google/cloud/videointelligence/v1p3beta1/BUILD.bazel
index 17c796d5c..4adfac734 100644
--- a/third_party/googleapis/google/cloud/videointelligence/v1p3beta1/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/videointelligence/v1p3beta1/BUILD.bazel
@@ -1,18 +1,23 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
-    name = "video_intelligence_proto",
+    name = "videointelligence_proto",
     srcs = [
         "video_intelligence.proto",
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
         "//google/longrunning:operations_proto",
         "//google/rpc:status_proto",
         "@com_google_protobuf//:duration_proto",
@@ -21,99 +26,86 @@ proto_library(
 )
 
 proto_library_with_info(
-    name = "video_intelligence_proto_with_info",
-    deps = [":video_intelligence_proto"],
+    name = "videointelligence_proto_with_info",
+    deps = [
+        ":videointelligence_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
-# TODO: uncomment once https://github.com/googleapis/gapic-generator/issues/1149 is fixed
 ##############################################################################
 # Java
 ##############################################################################
-#load(
-#    "@com_google_googleapis_imports//:imports.bzl",
-#    "java_grpc_library",
-#    "java_gapic_library",
-#    "java_gapic_assembly_gradle_pkg",
-#    "java_proto_library",
-#    "java_resource_name_proto_library",
-#    "java_test",
-#)
-#
-#_JAVA_GRPC_DEPS = [
-#    "@com_google_api_grpc_proto_google_common_protos//jar",
-#]
-#
-#java_proto_library(
-#    name = "video_intelligence_java_proto",
-#    deps = [":video_intelligence_proto"],
-#)
-#
-#java_grpc_library(
-#    name = "video_intelligence_java_grpc",
-#    srcs = [":video_intelligence_proto"],
-#    deps = [":video_intelligence_java_proto"] + _JAVA_GRPC_DEPS,
-#)
-#
-#java_resource_name_proto_library(
-#    name = "video_intelligence_resource_name_java_proto",
-#    gapic_yaml = "videointelligence_gapic.yaml",
-#    deps = [":video_intelligence_proto"],
-#)
-#
-#java_gapic_library(
-#    name = "video_intelligence_java_gapic",
-#    src = ":video_intelligence_proto_with_info",
-#    gapic_yaml = "videointelligence_gapic.yaml",
-#    service_yaml = "//google/cloud/videointelligence:videointelligence_v1p3beta1.yaml",
-#    test_deps = [":video_intelligence_java_grpc"],
-#    deps = [
-#        ":video_intelligence_java_proto",
-#        ":video_intelligence_resource_name_java_proto",
-#    ] + _JAVA_GRPC_DEPS,
-#)
-#
-#[java_test(
-#    name = test_name,
-#    test_class = test_name,
-#    runtime_deps = [
-#        ":video_intelligence_java_gapic_test",
-#    ],
-#) for test_name in [
-#    "com.google.cloud.videointelligence.v1p3beta1.VideoIntelligenceServiceClientTest",
-#]]
-
-## Opensource Packages
-#java_gapic_assembly_gradle_pkg(
-#    name = "google-cloud-video-intelligence-v1p3beta1-java",
-#    client_deps = [":video_intelligence_java_gapic"],
-#    client_group = "com.google.cloud",
-#    client_test_deps = [":video_intelligence_java_gapic_test"],
-#    grpc_deps = [":video_intelligence_java_grpc"],
-#    grpc_group = "com.google.api.grpc",
-#    proto_deps = [
-#        ":video_intelligence_java_proto",
-#        ":video_intelligence_proto",
-#        ":video_intelligence_resource_name_java_proto",
-#    ] + _JAVA_GRPC_DEPS,
-#    version = "0.0.0-SNAPSHOT",
-#)
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "videointelligence_java_proto",
+    deps = [":videointelligence_proto"],
+)
+
+java_grpc_library(
+    name = "videointelligence_java_grpc",
+    srcs = [":videointelligence_proto"],
+    deps = [":videointelligence_java_proto"],
+)
+
+java_gapic_library(
+    name = "videointelligence_java_gapic",
+    src = ":videointelligence_proto_with_info",
+    gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1p3beta1",
+    service_yaml = "//google/cloud/videointelligence:videointelligence_v1p3beta1.yaml",
+    test_deps = [
+        ":videointelligence_java_grpc",
+    ],
+    deps = [
+        ":videointelligence_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "videointelligence_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.videointelligence.v1p3beta1.StreamingVideoIntelligenceServiceClientTest",
+        "com.google.cloud.videointelligence.v1p3beta1.VideoIntelligenceServiceClientTest",
+    ],
+    runtime_deps = [":videointelligence_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-videointelligence-v1p3beta1-java",
+    deps = [
+        ":videointelligence_java_gapic",
+        ":videointelligence_java_grpc",
+        ":videointelligence_java_proto",
+        ":videointelligence_proto",
+    ],
+)
 
 ##############################################################################
 # Go
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
-    name = "video_intelligence_go_proto",
+    name = "videointelligence_go_proto",
     compilers = ["@io_bazel_rules_go//proto:go_grpc"],
     importpath = "google.golang.org/genproto/googleapis/cloud/videointelligence/v1p3beta1",
-    protos = [":video_intelligence_proto"],
+    protos = [":videointelligence_proto"],
     deps = [
         "//google/api:annotations_go_proto",
         "//google/longrunning:longrunning_go_proto",
@@ -122,33 +114,257 @@ go_proto_library(
 )
 
 go_gapic_library(
-    name = "video_intelligence_go_gapic",
-    src = ":video_intelligence_proto_with_info",
-    gapic_yaml = "videointelligence_gapic.yaml",
-    importpath = "cloud.google.com/go/videointelligence/apiv1p3beta1",
+    name = "videointelligence_go_gapic",
+    srcs = [":videointelligence_proto_with_info"],
+    grpc_service_config = "videointelligence_grpc_service_config.json",
+    importpath = "cloud.google.com/go/videointelligence/apiv1p3beta1;videointelligence",
     service_yaml = "//google/cloud/videointelligence:videointelligence_v1p3beta1.yaml",
     deps = [
-        ":video_intelligence_go_proto",
+        ":videointelligence_go_proto",
         "//google/longrunning:longrunning_go_gapic",
         "//google/longrunning:longrunning_go_proto",
         "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
     ],
 )
 
 go_test(
-    name = "video_intelligence_go_gapic_test",
-    srcs = [":video_intelligence_go_gapic_srcjar_test"],
-    embed = [":video_intelligence_go_gapic"],
+    name = "videointelligence_go_gapic_test",
+    srcs = [":videointelligence_go_gapic_srcjar_test"],
+    embed = [":videointelligence_go_gapic"],
     importpath = "cloud.google.com/go/videointelligence/apiv1p3beta1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
-    name = "gapi-cloud-video-intelligence-v1p3beta1-go",
+    name = "gapi-cloud-videointelligence-v1p3beta1-go",
+    deps = [
+        ":videointelligence_go_gapic",
+        ":videointelligence_go_gapic_srcjar-test.srcjar",
+        ":videointelligence_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "videointelligence_moved_proto",
+    srcs = [":videointelligence_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/longrunning:operations_proto",
+        "//google/rpc:status_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "videointelligence_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":videointelligence_moved_proto"],
+)
+
+py_grpc_library(
+    name = "videointelligence_py_grpc",
+    srcs = [":videointelligence_moved_proto"],
+    deps = [":videointelligence_py_proto"],
+)
+
+py_gapic_library(
+    name = "videointelligence_py_gapic",
+    src = ":videointelligence_proto_with_info",
+    gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1p3beta1",
+    service_yaml = "//google/cloud/videointelligence:videointelligence_v1p3beta1.yaml",
+    deps = [
+        ":videointelligence_py_grpc",
+        ":videointelligence_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "videointelligence-v1p3beta1-py",
+    deps = [
+        ":videointelligence_py_gapic",
+        ":videointelligence_py_grpc",
+        ":videointelligence_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "videointelligence_php_proto",
+    deps = [":videointelligence_proto"],
+)
+
+php_grpc_library(
+    name = "videointelligence_php_grpc",
+    srcs = [":videointelligence_proto"],
+    deps = [":videointelligence_php_proto"],
+)
+
+php_gapic_library(
+    name = "videointelligence_php_gapic",
+    src = ":videointelligence_proto_with_info",
+    gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1p3beta1",
+    service_yaml = "//google/cloud/videointelligence:videointelligence_v1p3beta1.yaml",
+    deps = [
+        ":videointelligence_php_grpc",
+        ":videointelligence_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-videointelligence-v1p3beta1-php",
+    deps = [
+        ":videointelligence_php_gapic",
+        ":videointelligence_php_grpc",
+        ":videointelligence_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "videointelligence_nodejs_gapic",
+    src = ":videointelligence_proto_with_info",
+    gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1p3beta1",
+    service_yaml = "//google/cloud/videointelligence:videointelligence_v1p3beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "videointelligence-v1p3beta1-nodejs",
+    deps = [
+        ":videointelligence_nodejs_gapic",
+        ":videointelligence_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "videointelligence_ruby_proto",
+    deps = [":videointelligence_proto"],
+)
+
+ruby_grpc_library(
+    name = "videointelligence_ruby_grpc",
+    srcs = [":videointelligence_proto"],
+    deps = [":videointelligence_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "videointelligence_ruby_gapic",
+    src = ":videointelligence_proto_with_info",
+    gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1p3beta1",
+    service_yaml = "//google/cloud/videointelligence:videointelligence_v1p3beta1.yaml",
+    deps = [
+        ":videointelligence_ruby_grpc",
+        ":videointelligence_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-videointelligence-v1p3beta1-ruby",
+    deps = [
+        ":videointelligence_ruby_gapic",
+        ":videointelligence_ruby_grpc",
+        ":videointelligence_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "videointelligence_csharp_proto",
+    deps = [":videointelligence_proto"],
+)
+
+csharp_grpc_library(
+    name = "videointelligence_csharp_grpc",
+    srcs = [":videointelligence_proto"],
+    deps = [":videointelligence_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "videointelligence_csharp_gapic",
+    src = ":videointelligence_proto_with_info",
+    gapic_yaml = "videointelligence_gapic.yaml",
+    package = "google.cloud.videointelligence.v1p3beta1",
+    service_yaml = "//google/cloud/videointelligence:videointelligence_v1p3beta1.yaml",
+    deps = [
+        ":videointelligence_csharp_grpc",
+        ":videointelligence_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-videointelligence-v1p3beta1-csharp",
     deps = [
-        ":video_intelligence_go_gapic",
-        ":video_intelligence_go_gapic_srcjar-smoke-test.srcjar",
-        ":video_intelligence_go_gapic_srcjar-test.srcjar",
-        ":video_intelligence_go_proto",
+        ":videointelligence_csharp_gapic",
+        ":videointelligence_csharp_grpc",
+        ":videointelligence_csharp_proto",
     ],
 )
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1p3beta1/video_intelligence.proto b/third_party/googleapis/google/cloud/videointelligence/v1p3beta1/video_intelligence.proto
index e37726e0b..6284e0db3 100644
--- a/third_party/googleapis/google/cloud/videointelligence/v1p3beta1/video_intelligence.proto
+++ b/third_party/googleapis/google/cloud/videointelligence/v1p3beta1/video_intelligence.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,14 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.videointelligence.v1p3beta1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
@@ -29,10 +30,13 @@ option java_multiple_files = true;
 option java_outer_classname = "VideoIntelligenceServiceProto";
 option java_package = "com.google.cloud.videointelligence.v1p3beta1";
 option php_namespace = "Google\\Cloud\\VideoIntelligence\\V1p3beta1";
-option ruby_package = "Google::Cloud::VideoIntelligence::V1p3beta1";
 
-// Service that implements Google Cloud Video Intelligence API.
+// Service that implements the Video Intelligence API.
 service VideoIntelligenceService {
+  option (google.api.default_host) = "videointelligence.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform";
+
   // Performs asynchronous video annotation. Progress and results can be
   // retrieved through the `google.longrunning.Operations` interface.
   // `Operation.metadata` contains `AnnotateVideoProgress` (progress).
@@ -43,55 +47,67 @@ service VideoIntelligenceService {
       post: "/v1p3beta1/videos:annotate"
       body: "*"
     };
+    option (google.api.method_signature) = "input_uri,features";
+    option (google.longrunning.operation_info) = {
+      response_type: "AnnotateVideoResponse"
+      metadata_type: "AnnotateVideoProgress"
+    };
   }
 }
 
-// Service that implements Google Cloud Video Intelligence Streaming API.
+// Service that implements streaming Video Intelligence API.
 service StreamingVideoIntelligenceService {
+  option (google.api.default_host) = "videointelligence.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform";
+
   // Performs video annotation with bidirectional streaming: emitting results
   // while sending video/audio bytes.
   // This method is only available via the gRPC API (not REST).
   rpc StreamingAnnotateVideo(stream StreamingAnnotateVideoRequest)
-      returns (stream StreamingAnnotateVideoResponse);
+      returns (stream StreamingAnnotateVideoResponse) {}
 }
 
 // Video annotation request.
 message AnnotateVideoRequest {
   // Input video location. Currently, only
-  // [Google Cloud Storage](https://cloud.google.com/storage/) URIs are
-  // supported, which must be specified in the following format:
+  // [Cloud Storage](https://cloud.google.com/storage/) URIs are
+  // supported. URIs must be specified in the following format:
   // `gs://bucket-id/object-id` (other URI formats return
   // [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For
-  // more information, see [Request URIs](/storage/docs/reference-uris). A video
-  // URI may include wildcards in `object-id`, and thus identify multiple
-  // videos. Supported wildcards: '*' to match 0 or more characters;
+  // more information, see [Request
+  // URIs](https://cloud.google.com/storage/docs/request-endpoints). To identify
+  // multiple videos, a video URI may include wildcards in the `object-id`.
+  // Supported wildcards: '*' to match 0 or more characters;
   // '?' to match 1 character. If unset, the input video should be embedded
-  // in the request as `input_content`. If set, `input_content` should be unset.
+  // in the request as `input_content`. If set, `input_content` must be unset.
   string input_uri = 1;
 
   // The video data bytes.
-  // If unset, the input video(s) should be specified via `input_uri`.
-  // If set, `input_uri` should be unset.
+  // If unset, the input video(s) should be specified via the `input_uri`.
+  // If set, `input_uri` must be unset.
   bytes input_content = 6;
 
-  // Requested video annotation features.
-  repeated Feature features = 2;
+  // Required. Requested video annotation features.
+  repeated Feature features = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Additional video context and/or feature-specific parameters.
   VideoContext video_context = 3;
 
-  // Optional location where the output (in JSON format) should be stored.
-  // Currently, only [Google Cloud Storage](https://cloud.google.com/storage/)
-  // URIs are supported, which must be specified in the following format:
+  // Optional. Location where the output (in JSON format) should be stored.
+  // Currently, only [Cloud Storage](https://cloud.google.com/storage/)
+  // URIs are supported. These must be specified in the following format:
   // `gs://bucket-id/object-id` (other URI formats return
   // [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For
-  // more information, see [Request URIs](/storage/docs/reference-uris).
-  string output_uri = 4;
-
-  // Optional cloud region where annotation should take place. Supported cloud
-  // regions: `us-east1`, `us-west1`, `europe-west1`, `asia-east1`. If no region
-  // is specified, a region will be determined based on video file location.
-  string location_id = 5;
+  // more information, see [Request
+  // URIs](https://cloud.google.com/storage/docs/request-endpoints).
+  string output_uri = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Cloud region where annotation should take place. Supported cloud
+  // regions are: `us-east1`, `us-west1`, `europe-west1`, `asia-east1`. If no
+  // region is specified, the region will be determined based on video file
+  // location.
+  string location_id = 5 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Video context and/or feature-specific parameters.
@@ -110,16 +126,58 @@ message VideoContext {
   // Config for EXPLICIT_CONTENT_DETECTION.
   ExplicitContentDetectionConfig explicit_content_detection_config = 4;
 
+  // Config for FACE_DETECTION.
+  FaceDetectionConfig face_detection_config = 5;
+
   // Config for SPEECH_TRANSCRIPTION.
   SpeechTranscriptionConfig speech_transcription_config = 6;
 
   // Config for TEXT_DETECTION.
   TextDetectionConfig text_detection_config = 8;
 
+  // Config for PERSON_DETECTION.
+  PersonDetectionConfig person_detection_config = 11;
+
   // Config for OBJECT_TRACKING.
   ObjectTrackingConfig object_tracking_config = 13;
 }
 
+// Label detection mode.
+enum LabelDetectionMode {
+  // Unspecified.
+  LABEL_DETECTION_MODE_UNSPECIFIED = 0;
+
+  // Detect shot-level labels.
+  SHOT_MODE = 1;
+
+  // Detect frame-level labels.
+  FRAME_MODE = 2;
+
+  // Detect both shot-level and frame-level labels.
+  SHOT_AND_FRAME_MODE = 3;
+}
+
+// Bucketized representation of likelihood.
+enum Likelihood {
+  // Unspecified likelihood.
+  LIKELIHOOD_UNSPECIFIED = 0;
+
+  // Very unlikely.
+  VERY_UNLIKELY = 1;
+
+  // Unlikely.
+  UNLIKELY = 2;
+
+  // Possible.
+  POSSIBLE = 3;
+
+  // Likely.
+  LIKELY = 4;
+
+  // Very likely.
+  VERY_LIKELY = 5;
+}
+
 // Config for LABEL_DETECTION.
 message LabelDetectionConfig {
   // What labels should be detected with LABEL_DETECTION, in addition to
@@ -127,9 +185,9 @@ message LabelDetectionConfig {
   // If unspecified, defaults to `SHOT_MODE`.
   LabelDetectionMode label_detection_mode = 1;
 
-  // Whether the video has been shot from a stationary (i.e. non-moving) camera.
-  // When set to true, might improve detection accuracy for moving objects.
-  // Should be used with `SHOT_AND_FRAME_MODE` enabled.
+  // Whether the video has been shot from a stationary (i.e., non-moving)
+  // camera. When set to true, might improve detection accuracy for moving
+  // objects. Should be used with `SHOT_AND_FRAME_MODE` enabled.
   bool stationary_camera = 2;
 
   // Model to use for label detection.
@@ -141,19 +199,82 @@ message LabelDetectionConfig {
   // frame-level detection. If not set, it is set to 0.4 by default. The valid
   // range for this threshold is [0.1, 0.9]. Any value set outside of this
   // range will be clipped.
-  // Note: for best results please follow the default threshold. We will update
+  // Note: For best results, follow the default threshold. We will update
   // the default threshold everytime when we release a new model.
   float frame_confidence_threshold = 4;
 
   // The confidence threshold we perform filtering on the labels from
-  // video-level and shot-level detections. If not set, it is set to 0.3 by
+  // video-level and shot-level detections. If not set, it's set to 0.3 by
   // default. The valid range for this threshold is [0.1, 0.9]. Any value set
   // outside of this range will be clipped.
-  // Note: for best results please follow the default threshold. We will update
+  // Note: For best results, follow the default threshold. We will update
   // the default threshold everytime when we release a new model.
   float video_confidence_threshold = 5;
 }
 
+// Streaming video annotation feature.
+enum StreamingFeature {
+  // Unspecified.
+  STREAMING_FEATURE_UNSPECIFIED = 0;
+
+  // Label detection. Detect objects, such as dog or flower.
+  STREAMING_LABEL_DETECTION = 1;
+
+  // Shot change detection.
+  STREAMING_SHOT_CHANGE_DETECTION = 2;
+
+  // Explicit content detection.
+  STREAMING_EXPLICIT_CONTENT_DETECTION = 3;
+
+  // Object detection and tracking.
+  STREAMING_OBJECT_TRACKING = 4;
+
+  // Action recognition based on AutoML model.
+  STREAMING_AUTOML_ACTION_RECOGNITION = 23;
+
+  // Video classification based on AutoML model.
+  STREAMING_AUTOML_CLASSIFICATION = 21;
+
+  // Object detection and tracking based on AutoML model.
+  STREAMING_AUTOML_OBJECT_TRACKING = 22;
+}
+
+// Video annotation feature.
+enum Feature {
+  // Unspecified.
+  FEATURE_UNSPECIFIED = 0;
+
+  // Label detection. Detect objects, such as dog or flower.
+  LABEL_DETECTION = 1;
+
+  // Shot change detection.
+  SHOT_CHANGE_DETECTION = 2;
+
+  // Explicit content detection.
+  EXPLICIT_CONTENT_DETECTION = 3;
+
+  // Human face detection.
+  FACE_DETECTION = 4;
+
+  // Speech transcription.
+  SPEECH_TRANSCRIPTION = 6;
+
+  // OCR text detection and tracking.
+  TEXT_DETECTION = 7;
+
+  // Object detection and tracking.
+  OBJECT_TRACKING = 9;
+
+  // Logo detection, tracking, and recognition.
+  LOGO_RECOGNITION = 12;
+
+  // Celebrity recognition.
+  CELEBRITY_RECOGNITION = 13;
+
+  // Person detection.
+  PERSON_DETECTION = 14;
+}
+
 // Config for SHOT_CHANGE_DETECTION.
 message ShotChangeDetectionConfig {
   // Model to use for shot change detection.
@@ -178,6 +299,38 @@ message ExplicitContentDetectionConfig {
   string model = 1;
 }
 
+// Config for FACE_DETECTION.
+message FaceDetectionConfig {
+  // Model to use for face detection.
+  // Supported values: "builtin/stable" (the default if unset) and
+  // "builtin/latest".
+  string model = 1;
+
+  // Whether bounding boxes are included in the face annotation output.
+  bool include_bounding_boxes = 2;
+
+  // Whether to enable face attributes detection, such as glasses, dark_glasses,
+  // mouth_open etc. Ignored if 'include_bounding_boxes' is set to false.
+  bool include_attributes = 5;
+}
+
+// Config for PERSON_DETECTION.
+message PersonDetectionConfig {
+  // Whether bounding boxes are included in the person detection annotation
+  // output.
+  bool include_bounding_boxes = 1;
+
+  // Whether to enable pose landmarks detection. Ignored if
+  // 'include_bounding_boxes' is set to false.
+  bool include_pose_landmarks = 2;
+
+  // Whether to enable person attributes detection, such as cloth color (black,
+  // blue, etc), type (coat, dress, etc), pattern (plain, floral, etc), hair,
+  // etc.
+  // Ignored if 'include_bounding_boxes' is set to false.
+  bool include_attributes = 3;
+}
+
 // Config for TEXT_DETECTION.
 message TextDetectionConfig {
   // Language hint can be specified if the language to be detected is known a
@@ -230,7 +383,7 @@ message Entity {
   // API](https://developers.google.com/knowledge-graph/).
   string entity_id = 1;
 
-  // Textual description, e.g. `Fixed-gear bicycle`.
+  // Textual description, e.g., `Fixed-gear bicycle`.
   string description = 2;
 
   // Language code for `description` in BCP-47 format.
@@ -243,9 +396,9 @@ message LabelAnnotation {
   Entity entity = 1;
 
   // Common categories for the detected entity.
-  // E.g. when the label is `Terrier` the category is likely `dog`. And in some
-  // cases there might be more than one categories e.g. `Terrier` could also be
-  // a `pet`.
+  // For example, when the label is `Terrier`, the category is likely `dog`. And
+  // in some cases there might be more than one categories e.g., `Terrier` could
+  // also be a `pet`.
   repeated Entity category_entities = 2;
 
   // All video segments where a label was detected.
@@ -290,8 +443,7 @@ message NormalizedBoundingBox {
   float bottom = 4;
 }
 
-// For tracking related features, such as LOGO_RECOGNITION, FACE_DETECTION,
-// CELEBRITY_RECOGNITION, PERSON_DETECTION.
+// For tracking related features.
 // An object at time_offset with attributes, and located with
 // normalized_bounding_box.
 message TimestampedObject {
@@ -303,7 +455,12 @@ message TimestampedObject {
   google.protobuf.Duration time_offset = 2;
 
   // Optional. The attributes of the object in the bounding box.
-  repeated DetectedAttribute attributes = 3;
+  repeated DetectedAttribute attributes = 3
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The detected landmarks.
+  repeated DetectedLandmark landmarks = 4
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // A track of an object instance.
@@ -315,15 +472,16 @@ message Track {
   repeated TimestampedObject timestamped_objects = 2;
 
   // Optional. Attributes in the track level.
-  repeated DetectedAttribute attributes = 3;
+  repeated DetectedAttribute attributes = 3
+      [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The confidence score of the tracked object.
-  float confidence = 4;
+  float confidence = 4 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // A generic detected attribute represented by name in string format.
 message DetectedAttribute {
-  // The name of the attribute, i.e. glasses, dark_glasses, mouth_open etc.
+  // The name of the attribute, for example, glasses, dark_glasses, mouth_open.
   // A full list of supported type names will be provided in the document.
   string name = 1;
 
@@ -335,24 +493,116 @@ message DetectedAttribute {
   string value = 3;
 }
 
+// Celebrity definition.
+message Celebrity {
+  // The resource name of the celebrity. Have the format
+  // `video-intelligence/kg-mid` indicates a celebrity from preloaded gallery.
+  // kg-mid is the id in Google knowledge graph, which is unique for the
+  // celebrity.
+  string name = 1;
+
+  // The celebrity name.
+  string display_name = 2;
+
+  // Textual description of additional information about the celebrity, if
+  // applicable.
+  string description = 3;
+}
+
+// The annotation result of a celebrity face track. RecognizedCelebrity field
+// could be empty if the face track does not have any matched celebrities.
+message CelebrityTrack {
+  // The recognized celebrity with confidence score.
+  message RecognizedCelebrity {
+    // The recognized celebrity.
+    Celebrity celebrity = 1;
+
+    // Recognition confidence. Range [0, 1].
+    float confidence = 2;
+  }
+
+  // Top N match of the celebrities for the face in this track.
+  repeated RecognizedCelebrity celebrities = 1;
+
+  // A track of a person's face.
+  Track face_track = 3;
+}
+
+// Celebrity recognition annotation per video.
+message CelebrityRecognitionAnnotation {
+  // The tracks detected from the input video, including recognized celebrities
+  // and other detected faces in the video.
+  repeated CelebrityTrack celebrity_tracks = 1;
+}
+
+// A generic detected landmark represented by name in string format and a 2D
+// location.
+message DetectedLandmark {
+  // The name of this landmark, for example, left_hand, right_shoulder.
+  string name = 1;
+
+  // The 2D point of the detected landmark using the normalized image
+  // coordindate system. The normalized coordinates have the range from 0 to 1.
+  NormalizedVertex point = 2;
+
+  // The confidence score of the detected landmark. Range [0, 1].
+  float confidence = 3;
+}
+
+// Face detection annotation.
+message FaceDetectionAnnotation {
+  // The face tracks with attributes.
+  repeated Track tracks = 3;
+
+  // The thumbnail of a person's face.
+  bytes thumbnail = 4;
+}
+
+// Person detection annotation per video.
+message PersonDetectionAnnotation {
+  // The detected tracks of a person.
+  repeated Track tracks = 1;
+}
+
 // Annotation results for a single video.
 message VideoAnnotationResults {
   // Video file location in
-  // [Google Cloud Storage](https://cloud.google.com/storage/).
+  // [Cloud Storage](https://cloud.google.com/storage/).
   string input_uri = 1;
 
-  // Label annotations on video level or user specified segment level.
+  // Video segment on which the annotation is run.
+  VideoSegment segment = 10;
+
+  // Topical label annotations on video level or user-specified segment level.
   // There is exactly one element for each unique label.
   repeated LabelAnnotation segment_label_annotations = 2;
 
-  // Label annotations on shot level.
+  // Presence label annotations on video level or user-specified segment level.
+  // There is exactly one element for each unique label. Compared to the
+  // existing topical `segment_label_annotations`, this field presents more
+  // fine-grained, segment-level labels detected in video content and is made
+  // available only when the client sets `LabelDetectionConfig.model` to
+  // "builtin/latest" in the request.
+  repeated LabelAnnotation segment_presence_label_annotations = 23;
+
+  // Topical label annotations on shot level.
   // There is exactly one element for each unique label.
   repeated LabelAnnotation shot_label_annotations = 3;
 
+  // Presence label annotations on shot level. There is exactly one element for
+  // each unique label. Compared to the existing topical
+  // `shot_label_annotations`, this field presents more fine-grained, shot-level
+  // labels detected in video content and is made available only when the client
+  // sets `LabelDetectionConfig.model` to "builtin/latest" in the request.
+  repeated LabelAnnotation shot_presence_label_annotations = 24;
+
   // Label annotations on frame level.
   // There is exactly one element for each unique label.
   repeated LabelAnnotation frame_label_annotations = 4;
 
+  // Face detection annotations.
+  repeated FaceDetectionAnnotation face_detection_annotations = 13;
+
   // Shot annotations. Each shot is represented as a video segment.
   repeated VideoSegment shot_annotations = 6;
 
@@ -373,6 +623,12 @@ message VideoAnnotationResults {
   // Annotations for list of logos detected, tracked and recognized in video.
   repeated LogoRecognitionAnnotation logo_recognition_annotations = 19;
 
+  // Person detection annotations.
+  repeated PersonDetectionAnnotation person_detection_annotations = 20;
+
+  // Celebrity recognition annotations.
+  CelebrityRecognitionAnnotation celebrity_recognition_annotations = 21;
+
   // If set, indicates an error. Note that for a single `AnnotateVideoRequest`
   // some videos may succeed and some may fail.
   google.rpc.Status error = 9;
@@ -389,7 +645,7 @@ message AnnotateVideoResponse {
 // Annotation progress for a single video.
 message VideoAnnotationProgress {
   // Video file location in
-  // [Google Cloud Storage](https://cloud.google.com/storage/).
+  // [Cloud Storage](https://cloud.google.com/storage/).
   string input_uri = 1;
 
   // Approximate percentage processed thus far. Guaranteed to be
@@ -401,6 +657,14 @@ message VideoAnnotationProgress {
 
   // Time of the most recent update.
   google.protobuf.Timestamp update_time = 4;
+
+  // Specifies which feature is being tracked if the request contains more than
+  // one feature.
+  Feature feature = 5;
+
+  // Specifies which segment is being tracked if the request contains more than
+  // one segment.
+  VideoSegment segment = 6;
 }
 
 // Video annotation progress. Included in the `metadata`
@@ -413,72 +677,73 @@ message AnnotateVideoProgress {
 
 // Config for SPEECH_TRANSCRIPTION.
 message SpeechTranscriptionConfig {
-  // *Required* The language of the supplied audio as a
+  // Required. *Required* The language of the supplied audio as a
   // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag.
   // Example: "en-US".
   // See [Language Support](https://cloud.google.com/speech/docs/languages)
   // for a list of the currently supported language codes.
-  string language_code = 1;
+  string language_code = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // *Optional* Maximum number of recognition hypotheses to be returned.
+  // Optional. Maximum number of recognition hypotheses to be returned.
   // Specifically, the maximum number of `SpeechRecognitionAlternative` messages
   // within each `SpeechTranscription`. The server may return fewer than
   // `max_alternatives`. Valid values are `0`-`30`. A value of `0` or `1` will
   // return a maximum of one. If omitted, will return a maximum of one.
-  int32 max_alternatives = 2;
+  int32 max_alternatives = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // *Optional* If set to `true`, the server will attempt to filter out
+  // Optional. If set to `true`, the server will attempt to filter out
   // profanities, replacing all but the initial character in each filtered word
   // with asterisks, e.g. "f***". If set to `false` or omitted, profanities
   // won't be filtered out.
-  bool filter_profanity = 3;
+  bool filter_profanity = 3 [(google.api.field_behavior) = OPTIONAL];
 
-  // *Optional* A means to provide context to assist the speech recognition.
-  repeated SpeechContext speech_contexts = 4;
+  // Optional. A means to provide context to assist the speech recognition.
+  repeated SpeechContext speech_contexts = 4
+      [(google.api.field_behavior) = OPTIONAL];
 
-  // *Optional* If 'true', adds punctuation to recognition result hypotheses.
+  // Optional. If 'true', adds punctuation to recognition result hypotheses.
   // This feature is only available in select languages. Setting this for
   // requests in other languages has no effect at all. The default 'false' value
   // does not add punctuation to result hypotheses. NOTE: "This is currently
   // offered as an experimental service, complimentary to all users. In the
   // future this may be exclusively available as a premium feature."
-  bool enable_automatic_punctuation = 5;
+  bool enable_automatic_punctuation = 5
+      [(google.api.field_behavior) = OPTIONAL];
 
-  // *Optional* For file formats, such as MXF or MKV, supporting multiple audio
+  // Optional. For file formats, such as MXF or MKV, supporting multiple audio
   // tracks, specify up to two tracks. Default: track 0.
-  repeated int32 audio_tracks = 6;
+  repeated int32 audio_tracks = 6 [(google.api.field_behavior) = OPTIONAL];
 
-  // *Optional* If 'true', enables speaker detection for each recognized word in
+  // Optional. If 'true', enables speaker detection for each recognized word in
   // the top alternative of the recognition result using a speaker_tag provided
   // in the WordInfo.
   // Note: When this is true, we send all the words from the beginning of the
-  // audio for the top alternative in every consecutive responses.
+  // audio for the top alternative in every consecutive response.
   // This is done in order to improve our speaker tags as our models learn to
   // identify the speakers in the conversation over time.
-  bool enable_speaker_diarization = 7;
+  bool enable_speaker_diarization = 7 [(google.api.field_behavior) = OPTIONAL];
 
-  // *Optional*
-  // If set, specifies the estimated number of speakers in the conversation.
-  // If not set, defaults to '2'.
-  // Ignored unless enable_speaker_diarization is set to true.
-  int32 diarization_speaker_count = 8;
+  // Optional. If set, specifies the estimated number of speakers in the
+  // conversation. If not set, defaults to '2'. Ignored unless
+  // enable_speaker_diarization is set to true.
+  int32 diarization_speaker_count = 8 [(google.api.field_behavior) = OPTIONAL];
 
-  // *Optional* If `true`, the top result includes a list of words and the
+  // Optional. If `true`, the top result includes a list of words and the
   // confidence for those words. If `false`, no word-level confidence
   // information is returned. The default is `false`.
-  bool enable_word_confidence = 9;
+  bool enable_word_confidence = 9 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Provides "hints" to the speech recognizer to favor specific words and phrases
 // in the results.
 message SpeechContext {
-  // *Optional* A list of strings containing words and phrases "hints" so that
+  // Optional. A list of strings containing words and phrases "hints" so that
   // the speech recognition is more likely to recognize them. This can be used
   // to improve the accuracy for specific words and phrases, for example, if
   // specific commands are typically spoken by the user. This can also be used
   // to add additional words to the vocabulary of the recognizer. See
   // [usage limits](https://cloud.google.com/speech/limits#content).
-  repeated string phrases = 1;
+  repeated string phrases = 1 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // A speech recognition result corresponding to a portion of the audio.
@@ -489,11 +754,10 @@ message SpeechTranscription {
   // ranked by the recognizer.
   repeated SpeechRecognitionAlternative alternatives = 1;
 
-  // Output only. The
-  // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of the
-  // language in this result. This language code was detected to have the most
-  // likelihood of being spoken in the audio.
-  string language_code = 2;
+  // Output only. The [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt)
+  // language tag of the language in this result. This language code was
+  // detected to have the most likelihood of being spoken in the audio.
+  string language_code = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Alternative hypotheses (a.k.a. n-best list).
@@ -501,16 +765,18 @@ message SpeechRecognitionAlternative {
   // Transcript text representing the words that the user spoke.
   string transcript = 1;
 
-  // The confidence estimate between 0.0 and 1.0. A higher number
+  // Output only. The confidence estimate between 0.0 and 1.0. A higher number
   // indicates an estimated greater likelihood that the recognized words are
-  // correct. This field is typically provided only for the top hypothesis, and
-  // only for `is_final=true` results. Clients should not rely on the
-  // `confidence` field as it is not guaranteed to be accurate or consistent.
+  // correct. This field is set only for the top alternative.
+  // This field is not guaranteed to be accurate and users should not rely on it
+  // to be always provided.
   // The default of 0.0 is a sentinel value indicating `confidence` was not set.
-  float confidence = 2;
+  float confidence = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // A list of word-specific information for each recognized word.
-  repeated WordInfo words = 3;
+  // Output only. A list of word-specific information for each recognized word.
+  // Note: When `enable_speaker_diarization` is set to true, you will see all
+  // the words from the beginning of the audio.
+  repeated WordInfo words = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Word-specific information for recognized words. Word information is only
@@ -538,13 +804,13 @@ message WordInfo {
   // This field is not guaranteed to be accurate and users should not rely on it
   // to be always provided.
   // The default of 0.0 is a sentinel value indicating `confidence` was not set.
-  float confidence = 4;
+  float confidence = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. A distinct integer value is assigned for every speaker within
   // the audio. This field specifies which one of those speakers was detected to
   // have spoken this word. Value ranges from 1 up to diarization_speaker_count,
   // and is only set if speaker diarization is enabled.
-  int32 speaker_tag = 5;
+  int32 speaker_tag = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // A vertex represents a 2D point in the image.
@@ -627,24 +893,13 @@ message ObjectTrackingFrame {
 
 // Annotations corresponding to one tracked object.
 message ObjectTrackingAnnotation {
-  // Entity to specify the object category that this track is labeled as.
-  Entity entity = 1;
-
-  // Object category's labeling confidence of this track.
-  float confidence = 4;
-
-  // Information corresponding to all frames where this object track appears.
-  // Non-streaming batch mode: it may be one or multiple ObjectTrackingFrame
-  // messages in frames.
-  // Streaming mode: it can only be one ObjectTrackingFrame message in frames.
-  repeated ObjectTrackingFrame frames = 2;
-
   // Different representation of tracking info in non-streaming batch
   // and streaming modes.
   oneof track_info {
     // Non-streaming batch mode ONLY.
     // Each object track corresponds to one video segment where it appears.
     VideoSegment segment = 3;
+
     // Streaming mode ONLY.
     // In streaming mode, we do not know the end time of a tracked object
     // before it is completed. Hence, there is no VideoSegment info returned.
@@ -653,6 +908,18 @@ message ObjectTrackingAnnotation {
     // ObjectTrackAnnotation of the same track_id over time.
     int64 track_id = 5;
   }
+
+  // Entity to specify the object category that this track is labeled as.
+  Entity entity = 1;
+
+  // Object category's labeling confidence of this track.
+  float confidence = 4;
+
+  // Information corresponding to all frames where this object track appears.
+  // Non-streaming batch mode: it may be one or multiple ObjectTrackingFrame
+  // messages in frames.
+  // Streaming mode: it can only be one ObjectTrackingFrame message in frames.
+  repeated ObjectTrackingFrame frames = 2;
 }
 
 // Annotation corresponding to one detected, tracked and recognized logo class.
@@ -694,101 +961,9 @@ message StreamingAnnotateVideoRequest {
   }
 }
 
-// `StreamingAnnotateVideoResponse` is the only message returned to the client
-// by `StreamingAnnotateVideo`. A series of zero or more
-// `StreamingAnnotateVideoResponse` messages are streamed back to the client.
-message StreamingAnnotateVideoResponse {
-  // If set, returns a [google.rpc.Status][google.rpc.Status] message that
-  // specifies the error for the operation.
-  google.rpc.Status error = 1;
-
-  // Streaming annotation results.
-  StreamingVideoAnnotationResults annotation_results = 2;
-
-  // GCS URI that stores annotation results of one streaming session.
-  // It is a directory that can hold multiple files in JSON format.
-  // Example uri format:
-  // gs://bucket_id/object_id/cloud_project_name-session_id
-  string annotation_results_uri = 3;
-}
-
-// Config for AUTOML_CLASSIFICATION in streaming mode.
-message StreamingAutomlClassificationConfig {
-  // Resource name of AutoML model.
-  // Format: `projects/{project_id}/locations/{location_id}/models/{model_id}`
-  string model_name = 1;
-}
-
-// Config for AUTOML_OBJECT_TRACKING in streaming mode.
-message StreamingAutomlObjectTrackingConfig {
-  // Resource name of AutoML model.
-  // Format: `projects/{project_id}/locations/{location_id}/models/{model_id}`
-  string model_name = 1;
-}
-
-// Config for EXPLICIT_CONTENT_DETECTION in streaming mode.
-message StreamingExplicitContentDetectionConfig {
-  // No customized config support.
-}
-
-// Config for LABEL_DETECTION in streaming mode.
-message StreamingLabelDetectionConfig {
-  // Whether the video has been captured from a stationary (i.e. non-moving)
-  // camera. When set to true, might improve detection accuracy for moving
-  // objects. Default: false.
-  bool stationary_camera = 1;
-}
-
-// Config for STREAMING_OBJECT_TRACKING.
-message StreamingObjectTrackingConfig {
-  // No customized config support.
-}
-
-// Config for SHOT_CHANGE_DETECTION in streaming mode.
-message StreamingShotChangeDetectionConfig {
-  // No customized config support.
-}
-
-// Config for streaming storage option.
-message StreamingStorageConfig {
-  // Enable streaming storage. Default: false.
-  bool enable_storage_annotation_result = 1;
-
-  // GCS URI to store all annotation results for one client. Client should
-  // specify this field as the top-level storage directory. Annotation results
-  // of different sessions will be put into different sub-directories denoted
-  // by project_name and session_id. All sub-directories will be auto generated
-  // by program and will be made accessible to client in response proto.
-  // URIs must be specified in the following format: `gs://bucket-id/object-id`
-  // `bucket-id` should be a valid GCS bucket created by client and bucket
-  // permission shall also be configured properly. `object-id` can be arbitrary
-  // string that make sense to client. Other URI formats will return error and
-  // cause GCS write failure.
-  string annotation_result_storage_directory = 3;
-}
-
-// Streaming annotation results corresponding to a portion of the video
-// that is currently being processed.
-message StreamingVideoAnnotationResults {
-  // Shot annotation results. Each shot is represented as a video segment.
-  repeated VideoSegment shot_annotations = 1;
-
-  // Label annotation results.
-  repeated LabelAnnotation label_annotations = 2;
-
-  // Explicit content annotation results.
-  ExplicitContentAnnotation explicit_annotation = 3;
-
-  // Object tracking results.
-  repeated ObjectTrackingAnnotation object_annotations = 4;
-}
-
 // Provides information to the annotator that specifies how to process the
 // request.
 message StreamingVideoConfig {
-  // Requested annotation feature.
-  StreamingFeature feature = 1;
-
   // Config for requested annotation feature.
   oneof streaming_config {
     // Config for STREAMING_SHOT_CHANGE_DETECTION.
@@ -804,6 +979,10 @@ message StreamingVideoConfig {
     // Config for STREAMING_OBJECT_TRACKING.
     StreamingObjectTrackingConfig object_tracking_config = 5;
 
+    // Config for STREAMING_AUTOML_ACTION_RECOGNITION.
+    StreamingAutomlActionRecognitionConfig automl_action_recognition_config =
+        23;
+
     // Config for STREAMING_AUTOML_CLASSIFICATION.
     StreamingAutomlClassificationConfig automl_classification_config = 21;
 
@@ -811,87 +990,100 @@ message StreamingVideoConfig {
     StreamingAutomlObjectTrackingConfig automl_object_tracking_config = 22;
   }
 
+  // Requested annotation feature.
+  StreamingFeature feature = 1;
+
   // Streaming storage option. By default: storage is disabled.
   StreamingStorageConfig storage_config = 30;
 }
 
-// Video annotation feature.
-enum Feature {
-  // Unspecified.
-  FEATURE_UNSPECIFIED = 0;
-
-  // Label detection. Detect objects, such as dog or flower.
-  LABEL_DETECTION = 1;
+// `StreamingAnnotateVideoResponse` is the only message returned to the client
+// by `StreamingAnnotateVideo`. A series of zero or more
+// `StreamingAnnotateVideoResponse` messages are streamed back to the client.
+message StreamingAnnotateVideoResponse {
+  // If set, returns a [google.rpc.Status][google.rpc.Status] message that
+  // specifies the error for the operation.
+  google.rpc.Status error = 1;
 
-  // Shot change detection.
-  SHOT_CHANGE_DETECTION = 2;
+  // Streaming annotation results.
+  StreamingVideoAnnotationResults annotation_results = 2;
 
-  // Explicit content detection.
-  EXPLICIT_CONTENT_DETECTION = 3;
+  // Google Cloud Storage(GCS) URI that stores annotation results of one
+  // streaming session in JSON format.
+  // It is the annotation_result_storage_directory
+  // from the request followed by '/cloud_project_number-session_id'.
+  string annotation_results_uri = 3;
+}
 
-  // Speech transcription.
-  SPEECH_TRANSCRIPTION = 6;
+// Streaming annotation results corresponding to a portion of the video
+// that is currently being processed.
+message StreamingVideoAnnotationResults {
+  // Shot annotation results. Each shot is represented as a video segment.
+  repeated VideoSegment shot_annotations = 1;
 
-  // OCR text detection and tracking.
-  TEXT_DETECTION = 7;
+  // Label annotation results.
+  repeated LabelAnnotation label_annotations = 2;
 
-  // Object detection and tracking.
-  OBJECT_TRACKING = 9;
+  // Explicit content annotation results.
+  ExplicitContentAnnotation explicit_annotation = 3;
 
-  // Logo detection, tracking, and recognition.
-  LOGO_RECOGNITION = 12;
+  // Object tracking results.
+  repeated ObjectTrackingAnnotation object_annotations = 4;
 }
 
-// Label detection mode.
-enum LabelDetectionMode {
-  // Unspecified.
-  LABEL_DETECTION_MODE_UNSPECIFIED = 0;
-
-  // Detect shot-level labels.
-  SHOT_MODE = 1;
+// Config for STREAMING_SHOT_CHANGE_DETECTION.
+message StreamingShotChangeDetectionConfig {}
 
-  // Detect frame-level labels.
-  FRAME_MODE = 2;
-
-  // Detect both shot-level and frame-level labels.
-  SHOT_AND_FRAME_MODE = 3;
+// Config for STREAMING_LABEL_DETECTION.
+message StreamingLabelDetectionConfig {
+  // Whether the video has been captured from a stationary (i.e. non-moving)
+  // camera. When set to true, might improve detection accuracy for moving
+  // objects. Default: false.
+  bool stationary_camera = 1;
 }
 
-// Bucketized representation of likelihood.
-enum Likelihood {
-  // Unspecified likelihood.
-  LIKELIHOOD_UNSPECIFIED = 0;
-
-  // Very unlikely.
-  VERY_UNLIKELY = 1;
+// Config for STREAMING_EXPLICIT_CONTENT_DETECTION.
+message StreamingExplicitContentDetectionConfig {}
 
-  // Unlikely.
-  UNLIKELY = 2;
+// Config for STREAMING_OBJECT_TRACKING.
+message StreamingObjectTrackingConfig {}
 
-  // Possible.
-  POSSIBLE = 3;
+// Config for STREAMING_AUTOML_ACTION_RECOGNITION.
+message StreamingAutomlActionRecognitionConfig {
+  // Resource name of AutoML model.
+  // Format: `projects/{project_id}/locations/{location_id}/models/{model_id}`
+  string model_name = 1;
+}
 
-  // Likely.
-  LIKELY = 4;
+// Config for STREAMING_AUTOML_CLASSIFICATION.
+message StreamingAutomlClassificationConfig {
+  // Resource name of AutoML model.
+  // Format:
+  // `projects/{project_number}/locations/{location_id}/models/{model_id}`
+  string model_name = 1;
+}
 
-  // Very likely.
-  VERY_LIKELY = 5;
+// Config for STREAMING_AUTOML_OBJECT_TRACKING.
+message StreamingAutomlObjectTrackingConfig {
+  // Resource name of AutoML model.
+  // Format: `projects/{project_id}/locations/{location_id}/models/{model_id}`
+  string model_name = 1;
 }
 
-// Streaming video annotation feature.
-enum StreamingFeature {
-  // Unspecified.
-  STREAMING_FEATURE_UNSPECIFIED = 0;
-  // Label detection. Detect objects, such as dog or flower.
-  STREAMING_LABEL_DETECTION = 1;
-  // Shot change detection.
-  STREAMING_SHOT_CHANGE_DETECTION = 2;
-  // Explicit content detection.
-  STREAMING_EXPLICIT_CONTENT_DETECTION = 3;
-  // Object detection and tracking.
-  STREAMING_OBJECT_TRACKING = 4;
-  // Video classification based on AutoML model.
-  STREAMING_AUTOML_CLASSIFICATION = 21;
-  // Object detection and tracking based on AutoML model.
-  STREAMING_AUTOML_OBJECT_TRACKING = 22;
+// Config for streaming storage option.
+message StreamingStorageConfig {
+  // Enable streaming storage. Default: false.
+  bool enable_storage_annotation_result = 1;
+
+  // Cloud Storage URI to store all annotation results for one client. Client
+  // should specify this field as the top-level storage directory. Annotation
+  // results of different sessions will be put into different sub-directories
+  // denoted by project_name and session_id. All sub-directories will be auto
+  // generated by program and will be made accessible to client in response
+  // proto. URIs must be specified in the following format:
+  // `gs://bucket-id/object-id` `bucket-id` should be a valid Cloud Storage
+  // bucket created by client and bucket permission shall also be configured
+  // properly. `object-id` can be arbitrary string that make sense to client.
+  // Other URI formats will return error and cause Cloud Storage write failure.
+  string annotation_result_storage_directory = 3;
 }
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1p3beta1/videointelligence_gapic.legacy.yaml b/third_party/googleapis/google/cloud/videointelligence/v1p3beta1/videointelligence_gapic.legacy.yaml
new file mode 100644
index 000000000..28ec53f39
--- /dev/null
+++ b/third_party/googleapis/google/cloud/videointelligence/v1p3beta1/videointelligence_gapic.legacy.yaml
@@ -0,0 +1,237 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.videointelligence.v1p3beta1
+  python:
+    package_name: google.cloud.videointelligence_v1p3beta1.gapic
+  go:
+    package_name: cloud.google.com/go/videointelligence/apiv1p3beta1
+  csharp:
+    package_name: Google.Cloud.VideoIntelligence.V1P3Beta1
+  ruby:
+    package_name: Google::Cloud::VideoIntelligence::V1p3beta1
+    release_level: BETA
+  php:
+    package_name: Google\Cloud\VideoIntelligence\V1p3beta1
+  nodejs:
+    package_name: video-intelligence.v1p3beta1
+    domain_layer_location: google-cloud
+interfaces:
+- name: google.cloud.videointelligence.v1p3beta1.VideoIntelligenceService
+  smoke_test:
+    method: AnnotateVideo
+    init_fields:
+    - input_uri=gs://cloud-samples-data/video/cat.mp4
+    - features[0]=LABEL_DETECTION
+  collections: []
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 1000
+    retry_delay_multiplier: 2.5
+    max_retry_delay_millis: 120000
+    initial_rpc_timeout_millis: 120000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 120000
+    total_timeout_millis: 600000
+  methods:
+  - name: AnnotateVideo
+    flattening:
+      groups:
+      - parameters:
+        - input_uri
+        - features
+    long_running:
+      return_type: google.cloud.videointelligence.v1p3beta1.AnnotateVideoResponse
+      metadata_type: google.cloud.videointelligence.v1p3beta1.AnnotateVideoProgress
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    sample_code_init_fields:
+    - input_uri=gs://cloud-samples-data/video/cat.mp4
+    - features[0]=LABEL_DETECTION
+    samples:
+      standalone:
+      - region_tag: video_detect_logo_beta
+        value_sets: [video_detect_logo_beta]
+      - region_tag: video_detect_logo_gcs_beta
+        value_sets: [video_detect_logo_gcs_beta]
+    sample_value_sets:
+    - id: video_detect_logo_beta
+      description: "Performs asynchronous video annotation for logo recognition from inline video content."
+      parameters:
+        defaults:
+        - input_content="resources/googlework_short.mp4"
+        - features[0]=LOGO_RECOGNITION
+        attributes:
+        - parameter: input_content
+          sample_argument_name: local_file_path
+          read_file: true
+          description: Path to local video file, e.g. /path/video.mp4
+      on_success:
+      - comment: ["Get the first response, since we sent only one video."]
+      - define: annotation_result=$resp.annotation_results[0]
+      - comment: ["Annotations for list of logos detected, tracked and recognized in video."]
+      - loop:
+          collection: annotation_result.logo_recognition_annotations
+          variable: logo_recognition_annotation
+          body:
+          - define: entity=logo_recognition_annotation.entity
+          - comment: ["Opaque entity ID. Some IDs may be available in [Google Knowledge Graph Search API](https://developers.google.com/knowledge-graph/)."]
+          - print: ["Entity Id : %s", entity.entity_id]
+          - comment: ["Textual description, e.g. `Google`."]
+          - print: ["Description : %s", entity.description]
+          - comment: ["All logo tracks where the recognized logo appears. Each track corresponds to one logo instance appearing in consecutive frames."]
+          - loop:
+              collection: logo_recognition_annotation.tracks
+              variable: track
+              body:
+              - comment: ["Video segment of a track."]
+              - define: segment=track.segment
+              - define: segment_start_time_offset=segment.start_time_offset
+              - print: ["\n\tStart Time Offset : %s.%s", segment_start_time_offset.seconds, segment_start_time_offset.nanos]
+              - define: segment_end_time_offset=segment.end_time_offset
+              - print: ["\tEnd Time Offset : %s.%s", segment_end_time_offset.seconds, segment_end_time_offset.nanos]
+              - print: ["\tConfidence : %s", track.confidence]
+              - comment: ["The object with timestamp and attributes per frame in the track."]
+              - loop:
+                  collection: track.timestamped_objects
+                  variable: timestamped_object
+                  body:
+                  - comment: ["Normalized Bounding box in a frame, where the object is located."]
+                  - define: normalized_bounding_box=timestamped_object.normalized_bounding_box
+                  - print: ["\n\t\tLeft : %s", normalized_bounding_box.left]
+                  - print: ["\t\tTop : %s", normalized_bounding_box.top]
+                  - print: ["\t\tRight : %s", normalized_bounding_box.right]
+                  - print: ["\t\tBottom : %s", normalized_bounding_box.bottom]
+                  - comment: ["Optional. The attributes of the object in the bounding box."]
+                  - loop:
+                      collection: timestamped_object.attributes
+                      variable: attribute
+                      body:
+                      - print: ["\n\t\t\tName : %s", attribute.name]
+                      - print: ["\t\t\tConfidence : %s", attribute.confidence]
+                      - print: ["\t\t\tValue : %s", attribute.value]
+              - comment: ["Optional. Attributes in the track level."]
+              - loop:
+                  collection: track.attributes
+                  variable: track_attribute
+                  body:
+                  - print: ["\n\t\tName : %s", track_attribute.name]
+                  - print: ["\t\tConfidence : %s", track_attribute.confidence]
+                  - print: ["\t\tValue : %s", track_attribute.value]
+          - comment: ["All video segments where the recognized logo appears. There might be multiple instances of the same logo class appearing in one VideoSegment."]
+          - loop:
+              collection: logo_recognition_annotation.segments
+              variable: logo_recognition_annotation_segment
+              body:
+              - define: logo_recognition_annotation_segment_start_time_offset=logo_recognition_annotation_segment.start_time_offset
+              - print: ["\n\tStart Time Offset : %s.%s", logo_recognition_annotation_segment_start_time_offset.seconds, logo_recognition_annotation_segment_start_time_offset.nanos]
+              - define: logo_recognition_annotation_segment_end_time_offset=logo_recognition_annotation_segment.end_time_offset
+              - print: ["\tEnd Time Offset : %s.%s", logo_recognition_annotation_segment_end_time_offset.seconds, logo_recognition_annotation_segment_end_time_offset.nanos]
+    - id: video_detect_logo_gcs_beta
+      description: "Performs asynchronous video annotation for logo recognition on a file hosted in GCS."
+      parameters:
+        defaults:
+        - input_uri=gs://cloud-samples-data/video/googlework_short.mp4
+        - features[0]=LOGO_RECOGNITION
+      on_success:
+      - comment: ["Get the first response, since we sent only one video."]
+      - define: annotation_result=$resp.annotation_results[0]
+      - comment: ["Annotations for list of logos detected, tracked and recognized in video."]
+      - loop:
+          collection: annotation_result.logo_recognition_annotations
+          variable: logo_recognition_annotation
+          body:
+          - define: entity=logo_recognition_annotation.entity
+          - comment: ["Opaque entity ID. Some IDs may be available in [Google Knowledge Graph Search API](https://developers.google.com/knowledge-graph/)."]
+          - print: ["Entity Id : %s", entity.entity_id]
+          - comment: ["Textual description, e.g. `Google`."]
+          - print: ["Description : %s", entity.description]
+          - comment: ["All logo tracks where the recognized logo appears. Each track corresponds to one logo instance appearing in consecutive frames."]
+          - loop:
+              collection: logo_recognition_annotation.tracks
+              variable: track
+              body:
+              - comment: ["Video segment of a track."]
+              - define: segment=track.segment
+              - define: segment_start_time_offset=segment.start_time_offset
+              - print: ["\n\tStart Time Offset : %s.%s", segment_start_time_offset.seconds, segment_start_time_offset.nanos]
+              - define: segment_end_time_offset=segment.end_time_offset
+              - print: ["\tEnd Time Offset : %s.%s", segment_end_time_offset.seconds, segment_end_time_offset.nanos]
+              - print: ["\tConfidence : %s", track.confidence]
+              - comment: ["The object with timestamp and attributes per frame in the track."]
+              - loop:
+                  collection: track.timestamped_objects
+                  variable: timestamped_object
+                  body:
+                  - comment: ["Normalized Bounding box in a frame, where the object is located."]
+                  - define: normalized_bounding_box=timestamped_object.normalized_bounding_box
+                  - print: ["\n\t\tLeft : %s", normalized_bounding_box.left]
+                  - print: ["\t\tTop : %s", normalized_bounding_box.top]
+                  - print: ["\t\tRight : %s", normalized_bounding_box.right]
+                  - print: ["\t\tBottom : %s", normalized_bounding_box.bottom]
+                  - comment: ["Optional. The attributes of the object in the bounding box."]
+                  - loop:
+                      collection: timestamped_object.attributes
+                      variable: attribute
+                      body:
+                      - print: ["\n\t\t\tName : %s", attribute.name]
+                      - print: ["\t\t\tConfidence : %s", attribute.confidence]
+                      - print: ["\t\t\tValue : %s", attribute.value]
+              - comment: ["Optional. Attributes in the track level."]
+              - loop:
+                  collection: track.attributes
+                  variable: track_attribute
+                  body:
+                  - print: ["\n\t\tName : %s", track_attribute.name]
+                  - print: ["\t\tConfidence : %s", track_attribute.confidence]
+                  - print: ["\t\tValue : %s", track_attribute.value]
+          - comment: ["All video segments where the recognized logo appears. There might be multiple instances of the same logo class appearing in one VideoSegment."]
+          - loop:
+              collection: logo_recognition_annotation.segments
+              variable: logo_recognition_annotation_segment
+              body:
+              - define: logo_recognition_annotation_segment_start_time_offset=logo_recognition_annotation_segment.start_time_offset
+              - print: ["\n\tStart Time Offset : %s.%s", logo_recognition_annotation_segment_start_time_offset.seconds, logo_recognition_annotation_segment_start_time_offset.nanos]
+              - define: logo_recognition_annotation_segment_end_time_offset=logo_recognition_annotation_segment.end_time_offset
+              - print: ["\tEnd Time Offset : %s.%s", logo_recognition_annotation_segment_end_time_offset.seconds, logo_recognition_annotation_segment_end_time_offset.nanos]
+# TODO: This config is currently broken:
+#     https://github.com/googleapis/gapic-generator/issues/1057
+#     https://github.com/googleapis/gapic-generator/issues/1149
+- name: google.cloud.videointelligence.v1p3beta1.StreamingVideoIntelligenceService
+  collections: []
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 10800000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 10800000
+    total_timeout_millis: 10800000
+  methods:
+  - name: StreamingAnnotateVideo
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 10800000
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1p3beta1/videointelligence_gapic.yaml b/third_party/googleapis/google/cloud/videointelligence/v1p3beta1/videointelligence_gapic.yaml
index 9a06190e7..64ced22ca 100644
--- a/third_party/googleapis/google/cloud/videointelligence/v1p3beta1/videointelligence_gapic.yaml
+++ b/third_party/googleapis/google/cloud/videointelligence/v1p3beta1/videointelligence_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.videointelligence.v1p3beta1
@@ -24,14 +24,6 @@ interfaces:
     init_fields:
     - input_uri=gs://cloud-samples-data/video/cat.mp4
     - features[0]=LABEL_DETECTION
-  collections: []
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 1000
@@ -43,37 +35,166 @@ interfaces:
     total_timeout_millis: 600000
   methods:
   - name: AnnotateVideo
-    flattening:
-      groups:
-      - parameters:
-        - input_uri
-        - features
     long_running:
-      return_type: google.cloud.videointelligence.v1p3beta1.AnnotateVideoResponse
-      metadata_type: google.cloud.videointelligence.v1p3beta1.AnnotateVideoProgress
       initial_poll_delay_millis: 20000
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 45000
       total_poll_timeout_millis: 86400000
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
     sample_code_init_fields:
     - input_uri=gs://cloud-samples-data/video/cat.mp4
     - features[0]=LABEL_DETECTION
+    samples:
+      standalone:
+      - region_tag: video_detect_logo_beta
+        value_sets: [video_detect_logo_beta]
+      - region_tag: video_detect_logo_gcs_beta
+        value_sets: [video_detect_logo_gcs_beta]
+    sample_value_sets:
+    - id: video_detect_logo_beta
+      description: "Performs asynchronous video annotation for logo recognition from inline video content."
+      parameters:
+        defaults:
+        - input_content="resources/googlework_short.mp4"
+        - features[0]=LOGO_RECOGNITION
+        attributes:
+        - parameter: input_content
+          sample_argument_name: local_file_path
+          read_file: true
+          description: Path to local video file, e.g. /path/video.mp4
+      on_success:
+      - comment: ["Get the first response, since we sent only one video."]
+      - define: annotation_result=$resp.annotation_results[0]
+      - comment: ["Annotations for list of logos detected, tracked and recognized in video."]
+      - loop:
+          collection: annotation_result.logo_recognition_annotations
+          variable: logo_recognition_annotation
+          body:
+          - define: entity=logo_recognition_annotation.entity
+          - comment: ["Opaque entity ID. Some IDs may be available in [Google Knowledge Graph Search API](https://developers.google.com/knowledge-graph/)."]
+          - print: ["Entity Id : %s", entity.entity_id]
+          - comment: ["Textual description, e.g. `Google`."]
+          - print: ["Description : %s", entity.description]
+          - comment: ["All logo tracks where the recognized logo appears. Each track corresponds to one logo instance appearing in consecutive frames."]
+          - loop:
+              collection: logo_recognition_annotation.tracks
+              variable: track
+              body:
+              - comment: ["Video segment of a track."]
+              - define: segment=track.segment
+              - define: segment_start_time_offset=segment.start_time_offset
+              - print: ["\n\tStart Time Offset : %s.%s", segment_start_time_offset.seconds, segment_start_time_offset.nanos]
+              - define: segment_end_time_offset=segment.end_time_offset
+              - print: ["\tEnd Time Offset : %s.%s", segment_end_time_offset.seconds, segment_end_time_offset.nanos]
+              - print: ["\tConfidence : %s", track.confidence]
+              - comment: ["The object with timestamp and attributes per frame in the track."]
+              - loop:
+                  collection: track.timestamped_objects
+                  variable: timestamped_object
+                  body:
+                  - comment: ["Normalized Bounding box in a frame, where the object is located."]
+                  - define: normalized_bounding_box=timestamped_object.normalized_bounding_box
+                  - print: ["\n\t\tLeft : %s", normalized_bounding_box.left]
+                  - print: ["\t\tTop : %s", normalized_bounding_box.top]
+                  - print: ["\t\tRight : %s", normalized_bounding_box.right]
+                  - print: ["\t\tBottom : %s", normalized_bounding_box.bottom]
+                  - comment: ["Optional. The attributes of the object in the bounding box."]
+                  - loop:
+                      collection: timestamped_object.attributes
+                      variable: attribute
+                      body:
+                      - print: ["\n\t\t\tName : %s", attribute.name]
+                      - print: ["\t\t\tConfidence : %s", attribute.confidence]
+                      - print: ["\t\t\tValue : %s", attribute.value]
+              - comment: ["Optional. Attributes in the track level."]
+              - loop:
+                  collection: track.attributes
+                  variable: track_attribute
+                  body:
+                  - print: ["\n\t\tName : %s", track_attribute.name]
+                  - print: ["\t\tConfidence : %s", track_attribute.confidence]
+                  - print: ["\t\tValue : %s", track_attribute.value]
+          - comment: ["All video segments where the recognized logo appears. There might be multiple instances of the same logo class appearing in one VideoSegment."]
+          - loop:
+              collection: logo_recognition_annotation.segments
+              variable: logo_recognition_annotation_segment
+              body:
+              - define: logo_recognition_annotation_segment_start_time_offset=logo_recognition_annotation_segment.start_time_offset
+              - print: ["\n\tStart Time Offset : %s.%s", logo_recognition_annotation_segment_start_time_offset.seconds, logo_recognition_annotation_segment_start_time_offset.nanos]
+              - define: logo_recognition_annotation_segment_end_time_offset=logo_recognition_annotation_segment.end_time_offset
+              - print: ["\tEnd Time Offset : %s.%s", logo_recognition_annotation_segment_end_time_offset.seconds, logo_recognition_annotation_segment_end_time_offset.nanos]
+    - id: video_detect_logo_gcs_beta
+      description: "Performs asynchronous video annotation for logo recognition on a file hosted in GCS."
+      parameters:
+        defaults:
+        - input_uri=gs://cloud-samples-data/video/googlework_short.mp4
+        - features[0]=LOGO_RECOGNITION
+      on_success:
+      - comment: ["Get the first response, since we sent only one video."]
+      - define: annotation_result=$resp.annotation_results[0]
+      - comment: ["Annotations for list of logos detected, tracked and recognized in video."]
+      - loop:
+          collection: annotation_result.logo_recognition_annotations
+          variable: logo_recognition_annotation
+          body:
+          - define: entity=logo_recognition_annotation.entity
+          - comment: ["Opaque entity ID. Some IDs may be available in [Google Knowledge Graph Search API](https://developers.google.com/knowledge-graph/)."]
+          - print: ["Entity Id : %s", entity.entity_id]
+          - comment: ["Textual description, e.g. `Google`."]
+          - print: ["Description : %s", entity.description]
+          - comment: ["All logo tracks where the recognized logo appears. Each track corresponds to one logo instance appearing in consecutive frames."]
+          - loop:
+              collection: logo_recognition_annotation.tracks
+              variable: track
+              body:
+              - comment: ["Video segment of a track."]
+              - define: segment=track.segment
+              - define: segment_start_time_offset=segment.start_time_offset
+              - print: ["\n\tStart Time Offset : %s.%s", segment_start_time_offset.seconds, segment_start_time_offset.nanos]
+              - define: segment_end_time_offset=segment.end_time_offset
+              - print: ["\tEnd Time Offset : %s.%s", segment_end_time_offset.seconds, segment_end_time_offset.nanos]
+              - print: ["\tConfidence : %s", track.confidence]
+              - comment: ["The object with timestamp and attributes per frame in the track."]
+              - loop:
+                  collection: track.timestamped_objects
+                  variable: timestamped_object
+                  body:
+                  - comment: ["Normalized Bounding box in a frame, where the object is located."]
+                  - define: normalized_bounding_box=timestamped_object.normalized_bounding_box
+                  - print: ["\n\t\tLeft : %s", normalized_bounding_box.left]
+                  - print: ["\t\tTop : %s", normalized_bounding_box.top]
+                  - print: ["\t\tRight : %s", normalized_bounding_box.right]
+                  - print: ["\t\tBottom : %s", normalized_bounding_box.bottom]
+                  - comment: ["Optional. The attributes of the object in the bounding box."]
+                  - loop:
+                      collection: timestamped_object.attributes
+                      variable: attribute
+                      body:
+                      - print: ["\n\t\t\tName : %s", attribute.name]
+                      - print: ["\t\t\tConfidence : %s", attribute.confidence]
+                      - print: ["\t\t\tValue : %s", attribute.value]
+              - comment: ["Optional. Attributes in the track level."]
+              - loop:
+                  collection: track.attributes
+                  variable: track_attribute
+                  body:
+                  - print: ["\n\t\tName : %s", track_attribute.name]
+                  - print: ["\t\tConfidence : %s", track_attribute.confidence]
+                  - print: ["\t\tValue : %s", track_attribute.value]
+          - comment: ["All video segments where the recognized logo appears. There might be multiple instances of the same logo class appearing in one VideoSegment."]
+          - loop:
+              collection: logo_recognition_annotation.segments
+              variable: logo_recognition_annotation_segment
+              body:
+              - define: logo_recognition_annotation_segment_start_time_offset=logo_recognition_annotation_segment.start_time_offset
+              - print: ["\n\tStart Time Offset : %s.%s", logo_recognition_annotation_segment_start_time_offset.seconds, logo_recognition_annotation_segment_start_time_offset.nanos]
+              - define: logo_recognition_annotation_segment_end_time_offset=logo_recognition_annotation_segment.end_time_offset
+              - print: ["\tEnd Time Offset : %s.%s", logo_recognition_annotation_segment_end_time_offset.seconds, logo_recognition_annotation_segment_end_time_offset.nanos]
 # TODO: This config is currently broken:
 #     https://github.com/googleapis/gapic-generator/issues/1057
 #     https://github.com/googleapis/gapic-generator/issues/1149
 - name: google.cloud.videointelligence.v1p3beta1.StreamingVideoIntelligenceService
-  collections: []
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
   # Definition for retry/backoff parameters.
   retry_params_def:
   - name: default
@@ -88,4 +209,3 @@ interfaces:
   - name: StreamingAnnotateVideo
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 10800000
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1p3beta1/videointelligence_grpc_service_config.json b/third_party/googleapis/google/cloud/videointelligence/v1p3beta1/videointelligence_grpc_service_config.json
new file mode 100755
index 000000000..3ded3c9cc
--- /dev/null
+++ b/third_party/googleapis/google/cloud/videointelligence/v1p3beta1/videointelligence_grpc_service_config.json
@@ -0,0 +1,40 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.videointelligence.v1p3beta1.VideoIntelligenceService",
+          "method": "AnnotateVideo"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "1s",
+        "maxBackoff": "120s",
+        "backoffMultiplier": 2.5,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.videointelligence.v1p3beta1.StreamingVideoIntelligenceService",
+          "method": "StreamingAnnotateVideo"
+        }
+      ],
+      "timeout": "10800s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/videointelligence/v1p3beta1/videointelligence_v1p3beta1.yaml b/third_party/googleapis/google/cloud/videointelligence/v1p3beta1/videointelligence_v1p3beta1.yaml
new file mode 100644
index 000000000..3da30f34e
--- /dev/null
+++ b/third_party/googleapis/google/cloud/videointelligence/v1p3beta1/videointelligence_v1p3beta1.yaml
@@ -0,0 +1,35 @@
+type: google.api.Service
+config_version: 3
+name: videointelligence.googleapis.com
+title: Cloud Video Intelligence API
+
+apis:
+- name: google.cloud.videointelligence.v1p3beta1.StreamingVideoIntelligenceService
+- name: google.cloud.videointelligence.v1p3beta1.VideoIntelligenceService
+
+types:
+- name: google.cloud.videointelligence.v1p3beta1.AnnotateVideoProgress
+- name: google.cloud.videointelligence.v1p3beta1.AnnotateVideoResponse
+- name: google.cloud.videointelligence.v1p3beta1.StreamingAnnotateVideoResponse
+- name: google.cloud.videointelligence.v1p3beta1.VideoSegment
+
+documentation:
+  summary: |-
+    Detects objects, explicit content, and scene changes in videos. It also
+    specifies the region for annotation and transcribes speech to text.
+    Supports both asynchronous API and streaming API.
+
+authentication:
+  rules:
+  - selector: google.cloud.videointelligence.v1p3beta1.StreamingVideoIntelligenceService.StreamingAnnotateVideo
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: google.cloud.videointelligence.v1p3beta1.VideoIntelligenceService.AnnotateVideo
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/videointelligence/videointelligence_v1.yaml b/third_party/googleapis/google/cloud/videointelligence/videointelligence_v1.yaml
deleted file mode 100644
index 4de2fb6ad..000000000
--- a/third_party/googleapis/google/cloud/videointelligence/videointelligence_v1.yaml
+++ /dev/null
@@ -1,52 +0,0 @@
-type: google.api.Service
-config_version: 3
-name: videointelligence.googleapis.com
-title: Cloud Video Intelligence API
-
-apis:
-- name: google.cloud.videointelligence.v1.VideoIntelligenceService
-
-types:
-- name: google.cloud.videointelligence.v1.AnnotateVideoResponse
-- name: google.cloud.videointelligence.v1.AnnotateVideoProgress
-- name: google.cloud.videointelligence.v1.VideoSegment
-- name: google.rpc.Status
-
-documentation:
-  summary: Cloud Video Intelligence API.
-
-backend:
-  rules:
-  - selector: google.longrunning.Operations.ListOperations
-    deadline: 600.0
-  - selector: google.longrunning.Operations.GetOperation
-    deadline: 600.0
-  - selector: google.longrunning.Operations.DeleteOperation
-    deadline: 600.0
-  - selector: google.longrunning.Operations.CancelOperation
-    deadline: 600.0
-  - selector: google.cloud.videointelligence.v1.VideoIntelligenceService.AnnotateVideo
-    deadline: 600.0
-
-http:
-  rules:
-  - selector: google.longrunning.Operations.ListOperations
-    get: /v1/operations
-
-  - selector: google.longrunning.Operations.GetOperation
-    get: '/v1/operations/{name=*}'
-
-  - selector: google.longrunning.Operations.DeleteOperation
-    delete: '/v1/operations/{name=*}'
-
-  - selector: google.longrunning.Operations.CancelOperation
-    post: '/v1/operations/{name=*}:cancel'
-    body: '*'
-
-
-authentication:
-  rules:
-  - selector: '*'
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/videointelligence/videointelligence_v1beta1.yaml b/third_party/googleapis/google/cloud/videointelligence/videointelligence_v1beta1.yaml
deleted file mode 100644
index 62e1227a9..000000000
--- a/third_party/googleapis/google/cloud/videointelligence/videointelligence_v1beta1.yaml
+++ /dev/null
@@ -1,35 +0,0 @@
-type: google.api.Service
-config_version: 3
-name: videointelligence.googleapis.com
-title: Google Cloud Video Intelligence API
-
-apis:
-- name: google.cloud.videointelligence.v1beta1.VideoIntelligenceService
-
-documentation:
-  summary:
-    Google Cloud Video Intelligence API.
-
-authentication:
-  rules:
-    - selector: '*'
-      oauth:
-        canonical_scopes: https://www.googleapis.com/auth/cloud-platform
-
-types:
-- name: google.cloud.videointelligence.v1beta1.AnnotateVideoResponse
-- name: google.cloud.videointelligence.v1beta1.AnnotateVideoProgress
-- name: google.cloud.videointelligence.v1beta1.VideoSegment
-- name: google.rpc.Status
-
-http:
-  rules:
-  - selector: google.longrunning.Operations.GetOperation
-    get: '/v1/operations/{name=*}'
-  - selector: google.longrunning.Operations.ListOperations
-    get: '/v1/operations'
-  - selector: google.longrunning.Operations.CancelOperation
-    post: '/v1/operations/{name=*}:cancel'
-    body: '*'
-  - selector: google.longrunning.Operations.DeleteOperation
-    delete: '/v1/operations/{name=*}'
diff --git a/third_party/googleapis/google/cloud/videointelligence/videointelligence_v1beta2.yaml b/third_party/googleapis/google/cloud/videointelligence/videointelligence_v1beta2.yaml
index 37918a95f..513e045b8 100644
--- a/third_party/googleapis/google/cloud/videointelligence/videointelligence_v1beta2.yaml
+++ b/third_party/googleapis/google/cloud/videointelligence/videointelligence_v1beta2.yaml
@@ -7,31 +7,42 @@ apis:
 - name: google.cloud.videointelligence.v1beta2.VideoIntelligenceService
 
 documentation:
-  summary:
-    Google Cloud Video Intelligence API.
+  summary: |-
+    Detects objects, explicit content, and scene changes in videos. It also
+    specifies the region for annotation and transcribes speech to text.
+    Supports both asynchronous API and streaming API.
 
 authentication:
   rules:
-    - selector: '*'
-      allow_without_credential: true
-      oauth:
-        canonical_scopes: https://www.googleapis.com/auth/cloud-platform
+  - selector: '*'
+    allow_without_credential: true
+    oauth:
+      canonical_scopes: https://www.googleapis.com/auth/cloud-platform
 
 types:
-- name: google.cloud.videointelligence.v1beta2.AnnotateVideoResponse
 - name: google.cloud.videointelligence.v1beta2.AnnotateVideoProgress
+- name: google.cloud.videointelligence.v1beta2.AnnotateVideoResponse
 - name: google.cloud.videointelligence.v1beta2.VideoSegment
 - name: google.rpc.Status
 
 # HTTP overrides.
 http:
   rules:
-  - selector: google.longrunning.Operations.GetOperation
-    get: '/v1/operations/{name=*}'
   - selector: google.longrunning.Operations.ListOperations
-    get: '/v1/operations'
+    get: '/v1beta2/{name=projects/*/locations/*}/operations'
+
+  - selector: google.longrunning.Operations.GetOperation
+    get: '/v1beta2/{name=projects/*/locations/*/operations/*}'
+    additional_bindings:
+    - get: '/v1beta2/operations/{name=projects/*/locations/*/operations/*}'
+
+  - selector: google.longrunning.Operations.DeleteOperation
+    delete: '/v1beta2/{name=projects/*/locations/*/operations/*}'
+    additional_bindings:
+    - delete: '/v1beta2/operations/{name=projects/*/locations/*/operations/*}'
+
   - selector: google.longrunning.Operations.CancelOperation
-    post: '/v1/operations/{name=*}:cancel'
+    post: '/v1beta2/{name=projects/*/locations/*/operations/*}:cancel'
     body: '*'
-  - selector: google.longrunning.Operations.DeleteOperation
-    delete: '/v1/operations/{name=*}'
+    additional_bindings:
+    - post: '/v1beta2/operations/{name=projects/*/locations/*/operations/*}:cancel'
diff --git a/third_party/googleapis/google/cloud/videointelligence/videointelligence_v1p1beta1.yaml b/third_party/googleapis/google/cloud/videointelligence/videointelligence_v1p1beta1.yaml
index 1e0caadbb..262d7f184 100644
--- a/third_party/googleapis/google/cloud/videointelligence/videointelligence_v1p1beta1.yaml
+++ b/third_party/googleapis/google/cloud/videointelligence/videointelligence_v1p1beta1.yaml
@@ -7,13 +7,16 @@ apis:
 - name: google.cloud.videointelligence.v1p1beta1.VideoIntelligenceService
 
 types:
-- name: google.cloud.videointelligence.v1p1beta1.AnnotateVideoResponse
 - name: google.cloud.videointelligence.v1p1beta1.AnnotateVideoProgress
+- name: google.cloud.videointelligence.v1p1beta1.AnnotateVideoResponse
 - name: google.cloud.videointelligence.v1p1beta1.VideoSegment
 - name: google.rpc.Status
 
 documentation:
-  summary: Cloud Video Intelligence API.
+  summary: |-
+    Detects objects, explicit content, and scene changes in videos. It also
+    specifies the region for annotation and transcribes speech to text.
+    Supports both asynchronous API and streaming API.
 
 backend:
   rules:
@@ -31,18 +34,23 @@ backend:
 http:
   rules:
   - selector: google.longrunning.Operations.ListOperations
-    get: /v1p1beta1/operations
+    get: '/v1p1beta1/{name=projects/*/locations/*}/operations'
 
   - selector: google.longrunning.Operations.GetOperation
-    get: '/v1p1beta1/operations/{name=*}'
+    get: '/v1p1beta1/{name=projects/*/locations/*/operations/*}'
+    additional_bindings:
+    - get: '/v1p1beta1/operations/{name=projects/*/locations/*/operations/*}'
 
   - selector: google.longrunning.Operations.DeleteOperation
-    delete: '/v1p1beta1/operations/{name=*}'
+    delete: '/v1p1beta1/{name=projects/*/locations/*/operations/*}'
+    additional_bindings:
+    - delete: '/v1p1beta1/operations/{name=projects/*/locations/*/operations/*}'
 
   - selector: google.longrunning.Operations.CancelOperation
-    post: '/v1p1beta1/operations/{name=*}:cancel'
+    post: '/v1p1beta1/{name=projects/*/locations/*/operations/*}:cancel'
     body: '*'
-
+    additional_bindings:
+    - post: '/v1p1beta1/operations/{name=projects/*/locations/*/operations/*}:cancel'
 
 authentication:
   rules:
diff --git a/third_party/googleapis/google/cloud/videointelligence/videointelligence_v1p2beta1.yaml b/third_party/googleapis/google/cloud/videointelligence/videointelligence_v1p2beta1.yaml
index df5da4297..3b4d3434c 100644
--- a/third_party/googleapis/google/cloud/videointelligence/videointelligence_v1p2beta1.yaml
+++ b/third_party/googleapis/google/cloud/videointelligence/videointelligence_v1p2beta1.yaml
@@ -7,13 +7,16 @@ apis:
 - name: google.cloud.videointelligence.v1p2beta1.VideoIntelligenceService
 
 types:
-- name: google.cloud.videointelligence.v1p2beta1.AnnotateVideoResponse
 - name: google.cloud.videointelligence.v1p2beta1.AnnotateVideoProgress
+- name: google.cloud.videointelligence.v1p2beta1.AnnotateVideoResponse
 - name: google.cloud.videointelligence.v1p2beta1.VideoSegment
 - name: google.rpc.Status
 
 documentation:
-  summary: Cloud Video Intelligence API.
+  summary: |-
+    Detects objects, explicit content, and scene changes in videos. It also
+    specifies the region for annotation and transcribes speech to text.
+    Supports both asynchronous API and streaming API.
 
 backend:
   rules:
@@ -31,18 +34,23 @@ backend:
 http:
   rules:
   - selector: google.longrunning.Operations.ListOperations
-    get: /v1p2beta1/operations
+    get: '/v1p2beta1/{name=projects/*/locations/*}/operations'
 
   - selector: google.longrunning.Operations.GetOperation
-    get: '/v1p2beta1/operations/{name=*}'
+    get: '/v1p2beta1/{name=projects/*/locations/*/operations/*}'
+    additional_bindings:
+    - get: '/v1p2beta1/operations/{name=projects/*/locations/*/operations/*}'
 
   - selector: google.longrunning.Operations.DeleteOperation
-    delete: '/v1p2beta1/operations/{name=*}'
+    delete: '/v1p2beta1/{name=projects/*/locations/*/operations/*}'
+    additional_bindings:
+    - delete: '/v1p2beta1/operations/{name=projects/*/locations/*/operations/*}'
 
   - selector: google.longrunning.Operations.CancelOperation
-    post: '/v1p2beta1/operations/{name=*}:cancel'
+    post: '/v1p2beta1/{name=projects/*/locations/*/operations/*}:cancel'
     body: '*'
-
+    additional_bindings:
+    - post: '/v1p2beta1/operations/{name=projects/*/locations/*/operations/*}:cancel'
 
 authentication:
   rules:
diff --git a/third_party/googleapis/google/cloud/videointelligence/videointelligence_v1p3beta1.yaml b/third_party/googleapis/google/cloud/videointelligence/videointelligence_v1p3beta1.yaml
index 6d33be286..145d0fbd2 100644
--- a/third_party/googleapis/google/cloud/videointelligence/videointelligence_v1p3beta1.yaml
+++ b/third_party/googleapis/google/cloud/videointelligence/videointelligence_v1p3beta1.yaml
@@ -8,13 +8,16 @@ apis:
 - name: google.cloud.videointelligence.v1p3beta1.StreamingVideoIntelligenceService
 
 types:
-- name: google.cloud.videointelligence.v1p3beta1.AnnotateVideoResponse
 - name: google.cloud.videointelligence.v1p3beta1.AnnotateVideoProgress
+- name: google.cloud.videointelligence.v1p3beta1.AnnotateVideoResponse
 - name: google.cloud.videointelligence.v1p3beta1.VideoSegment
 - name: google.rpc.Status
 
 documentation:
-  summary: Cloud Video Intelligence API.
+  summary: |-
+    Detects objects, explicit content, and scene changes in videos. It also
+    specifies the region for annotation and transcribes speech to text.
+    Supports both asynchronous API and streaming API.
 
 backend:
   rules:
@@ -34,18 +37,23 @@ backend:
 http:
   rules:
   - selector: google.longrunning.Operations.ListOperations
-    get: /v1p3beta1/operations
+    get: '/v1p3beta1/{name=projects/*/locations/*}/operations'
 
   - selector: google.longrunning.Operations.GetOperation
-    get: '/v1p3beta1/operations/{name=*}'
+    get: '/v1p3beta1/{name=projects/*/locations/*/operations/*}'
+    additional_bindings:
+    - get: '/v1p3beta1/operations/{name=projects/*/locations/*/operations/*}'
 
   - selector: google.longrunning.Operations.DeleteOperation
-    delete: '/v1p3beta1/operations/{name=*}'
+    delete: '/v1p3beta1/{name=projects/*/locations/*/operations/*}'
+    additional_bindings:
+    - delete: '/v1p3beta1/operations/{name=projects/*/locations/*/operations/*}'
 
   - selector: google.longrunning.Operations.CancelOperation
-    post: '/v1p3beta1/operations/{name=*}:cancel'
+    post: '/v1p3beta1/{name=projects/*/locations/*/operations/*}:cancel'
     body: '*'
-
+    additional_bindings:
+    - post: '/v1p3beta1/operations/{name=projects/*/locations/*/operations/*}:cancel'
 
 authentication:
   rules:
diff --git a/third_party/googleapis/google/cloud/vision/artman_vision_v1.yaml b/third_party/googleapis/google/cloud/vision/artman_vision_v1.yaml
index 6b037447e..069edaae0 100644
--- a/third_party/googleapis/google/cloud/vision/artman_vision_v1.yaml
+++ b/third_party/googleapis/google/cloud/vision/artman_vision_v1.yaml
@@ -2,12 +2,13 @@ common:
   api_name: vision
   api_version: v1
   organization_name: google-cloud
-  service_yaml: vision_v1.yaml
+  service_yaml: v1/vision_v1.yaml
   gapic_yaml: v1/vision_gapic.yaml
   src_proto_paths:
   - v1
   proto_deps:
   - name: google-common-protos
+  proto_package: google.cloud.vision.v1
 artifacts:
 - name: java_gapic
   type: GAPIC
diff --git a/third_party/googleapis/google/cloud/vision/v1/BUILD.bazel b/third_party/googleapis/google/cloud/vision/v1/BUILD.bazel
index 049cd6281..5aedae4e1 100644
--- a/third_party/googleapis/google/cloud/vision/v1/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/vision/v1/BUILD.bazel
@@ -1,9 +1,12 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
@@ -18,6 +21,9 @@ proto_library(
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
         "//google/longrunning:operations_proto",
         "//google/rpc:status_proto",
         "//google/type:color_proto",
@@ -30,7 +36,10 @@ proto_library(
 
 proto_library_with_info(
     name = "vision_proto_with_info",
-    deps = [":vision_proto"],
+    deps = [
+        ":vision_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -38,18 +47,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
     name = "vision_java_proto",
     deps = [":vision_proto"],
@@ -58,51 +62,41 @@ java_proto_library(
 java_grpc_library(
     name = "vision_java_grpc",
     srcs = [":vision_proto"],
-    deps = [":vision_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "vision_resource_name_java_proto",
-    gapic_yaml = "vision_gapic.yaml",
-    deps = [":vision_proto"],
+    deps = [":vision_java_proto"],
 )
 
 java_gapic_library(
     name = "vision_java_gapic",
     src = ":vision_proto_with_info",
     gapic_yaml = "vision_gapic.yaml",
-    service_yaml = "//google/cloud/vision:vision_v1.yaml",
-    test_deps = [":vision_java_grpc"],
+    package = "google.cloud.vision.v1",
+    service_yaml = "vision_v1.yaml",
+    test_deps = [
+        ":vision_java_grpc",
+    ],
     deps = [
         ":vision_java_proto",
-        ":vision_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":vision_java_gapic_test",
+java_gapic_test(
+    name = "vision_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.vision.v1.ImageAnnotatorClientTest",
+        "com.google.cloud.vision.v1.ProductSearchClientTest",
     ],
-) for test_name in [
-    "com.google.cloud.vision.v1.ImageAnnotatorClientTest",
-]]
+    runtime_deps = [":vision_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-vision-v1-java",
-    client_deps = [":vision_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":vision_java_gapic_test"],
-    grpc_deps = [":vision_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":vision_java_gapic",
+        ":vision_java_grpc",
         ":vision_java_proto",
         ":vision_proto",
-        ":vision_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -110,10 +104,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -132,15 +126,16 @@ go_proto_library(
 
 go_gapic_library(
     name = "vision_go_gapic",
-    src = ":vision_proto_with_info",
-    gapic_yaml = "vision_gapic.yaml",
-    importpath = "cloud.google.com/go/vision/apiv1",
-    service_yaml = "//google/cloud/vision:vision_v1.yaml",
+    srcs = [":vision_proto_with_info"],
+    grpc_service_config = "vision_grpc_service_config.json",
+    importpath = "cloud.google.com/go/vision/apiv1;vision",
+    service_yaml = "vision_v1.yaml",
     deps = [
         ":vision_go_proto",
         "//google/longrunning:longrunning_go_gapic",
         "//google/longrunning:longrunning_go_proto",
         "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
     ],
 )
 
@@ -151,25 +146,246 @@ go_test(
     importpath = "cloud.google.com/go/vision/apiv1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-vision-v1-go",
     deps = [
         ":vision_go_gapic",
-        ":vision_go_gapic_srcjar-smoke-test.srcjar",
         ":vision_go_gapic_srcjar-test.srcjar",
         ":vision_go_proto",
     ],
 )
 
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "vision_moved_proto",
+    srcs = [":vision_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/longrunning:operations_proto",
+        "//google/rpc:status_proto",
+        "//google/type:color_proto",
+        "//google/type:latlng_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "vision_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":vision_moved_proto"],
+)
+
+py_grpc_library(
+    name = "vision_py_grpc",
+    srcs = [":vision_moved_proto"],
+    deps = [":vision_py_proto"],
+)
+
+py_gapic_library(
+    name = "vision_py_gapic",
+    src = ":vision_proto_with_info",
+    gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1",
+    service_yaml = "vision_v1.yaml",
+    deps = [
+        ":vision_py_grpc",
+        ":vision_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "vision-v1-py",
+    deps = [
+        ":vision_py_gapic",
+        ":vision_py_grpc",
+        ":vision_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "vision_php_proto",
+    deps = [":vision_proto"],
+)
+
+php_grpc_library(
+    name = "vision_php_grpc",
+    srcs = [":vision_proto"],
+    deps = [":vision_php_proto"],
+)
+
+php_gapic_library(
+    name = "vision_php_gapic",
+    src = ":vision_proto_with_info",
+    gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1",
+    service_yaml = "vision_v1.yaml",
+    deps = [
+        ":vision_php_grpc",
+        ":vision_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-vision-v1-php",
+    deps = [
+        ":vision_php_gapic",
+        ":vision_php_grpc",
+        ":vision_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "vision_nodejs_gapic",
+    src = ":vision_proto_with_info",
+    gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1",
+    service_yaml = "vision_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "vision-v1-nodejs",
+    deps = [
+        ":vision_nodejs_gapic",
+        ":vision_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "vision_ruby_proto",
+    deps = [":vision_proto"],
+)
+
+ruby_grpc_library(
+    name = "vision_ruby_grpc",
+    srcs = [":vision_proto"],
+    deps = [":vision_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "vision_ruby_gapic",
+    src = ":vision_proto_with_info",
+    gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1",
+    service_yaml = "vision_v1.yaml",
+    deps = [
+        ":vision_ruby_grpc",
+        ":vision_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-vision-v1-ruby",
+    deps = [
+        ":vision_ruby_gapic",
+        ":vision_ruby_grpc",
+        ":vision_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "vision_csharp_proto",
+    deps = [":vision_proto"],
+)
+
+csharp_grpc_library(
+    name = "vision_csharp_grpc",
+    srcs = [":vision_proto"],
+    deps = [":vision_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "vision_csharp_gapic",
+    src = ":vision_proto_with_info",
+    gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1",
+    service_yaml = "vision_v1.yaml",
+    deps = [
+        ":vision_csharp_grpc",
+        ":vision_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-vision-v1-csharp",
+    deps = [
+        ":vision_csharp_gapic",
+        ":vision_csharp_grpc",
+        ":vision_csharp_proto",
+    ],
+)
+
 ##############################################################################
 # C++
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "cc_gapic_library",
     "cc_grpc_library",
     "cc_proto_library",
-    "cc_gapic_library",
 )
 
 cc_proto_library(
@@ -180,8 +396,9 @@ cc_proto_library(
 cc_grpc_library(
     name = "vision_cc_grpc",
     srcs = [":vision_proto"],
-    deps = [":vision_cc_proto"],
+    generate_mocks = True,
     grpc_only = True,
+    deps = [":vision_cc_proto"],
 )
 
 cc_gapic_library(
@@ -192,4 +409,4 @@ cc_gapic_library(
         ":vision_cc_grpc",
         ":vision_cc_proto",
     ],
-)
\ No newline at end of file
+)
diff --git a/third_party/googleapis/google/cloud/vision/v1/image_annotator.proto b/third_party/googleapis/google/cloud/vision/v1/image_annotator.proto
index 3375345e2..e75ca7660 100644
--- a/third_party/googleapis/google/cloud/vision/v1/image_annotator.proto
+++ b/third_party/googleapis/google/cloud/vision/v1/image_annotator.proto
@@ -18,6 +18,8 @@ syntax = "proto3";
 package google.cloud.vision.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/cloud/vision/v1/geometry.proto";
 import "google/cloud/vision/v1/product_search.proto";
 import "google/cloud/vision/v1/text_annotation.proto";
@@ -40,13 +42,26 @@ option objc_class_prefix = "GCVN";
 // images, such as face, landmark, logo, label, and text detection. The
 // ImageAnnotator service returns detected entities from the images.
 service ImageAnnotator {
+  option (google.api.default_host) = "vision.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/cloud-vision";
+
   // Run image detection and annotation for a batch of images.
-  rpc BatchAnnotateImages(BatchAnnotateImagesRequest)
-      returns (BatchAnnotateImagesResponse) {
+  rpc BatchAnnotateImages(BatchAnnotateImagesRequest) returns (BatchAnnotateImagesResponse) {
     option (google.api.http) = {
       post: "/v1/images:annotate"
       body: "*"
+      additional_bindings {
+        post: "/v1/{parent=projects/*/locations/*}/images:annotate"
+        body: "*"
+      }
+      additional_bindings {
+        post: "/v1/{parent=projects/*}/images:annotate"
+        body: "*"
+      }
     };
+    option (google.api.method_signature) = "requests";
   }
 
   // Service that performs image detection and annotation for a batch of files.
@@ -56,12 +71,20 @@ service ImageAnnotator {
   // AnnotateFileRequest.pages) frames (gif) or pages (pdf or tiff) from each
   // file provided and perform detection and annotation for each image
   // extracted.
-  rpc BatchAnnotateFiles(BatchAnnotateFilesRequest)
-      returns (BatchAnnotateFilesResponse) {
+  rpc BatchAnnotateFiles(BatchAnnotateFilesRequest) returns (BatchAnnotateFilesResponse) {
     option (google.api.http) = {
       post: "/v1/files:annotate"
       body: "*"
+      additional_bindings {
+        post: "/v1/{parent=projects/*/locations/*}/files:annotate"
+        body: "*"
+      }
+      additional_bindings {
+        post: "/v1/{parent=projects/*}/files:annotate"
+        body: "*"
+      }
     };
+    option (google.api.method_signature) = "requests";
   }
 
   // Run asynchronous image detection and annotation for a list of images.
@@ -73,11 +96,23 @@ service ImageAnnotator {
   //
   // This service will write image annotation outputs to json files in customer
   // GCS bucket, each json file containing BatchAnnotateImagesResponse proto.
-  rpc AsyncBatchAnnotateImages(AsyncBatchAnnotateImagesRequest)
-      returns (google.longrunning.Operation) {
+  rpc AsyncBatchAnnotateImages(AsyncBatchAnnotateImagesRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v1/images:asyncBatchAnnotate"
       body: "*"
+      additional_bindings {
+        post: "/v1/{parent=projects/*/locations/*}/images:asyncBatchAnnotate"
+        body: "*"
+      }
+      additional_bindings {
+        post: "/v1/{parent=projects/*}/images:asyncBatchAnnotate"
+        body: "*"
+      }
+    };
+    option (google.api.method_signature) = "requests,output_config";
+    option (google.longrunning.operation_info) = {
+      response_type: "AsyncBatchAnnotateImagesResponse"
+      metadata_type: "OperationMetadata"
     };
   }
 
@@ -87,11 +122,23 @@ service ImageAnnotator {
   // `google.longrunning.Operations` interface.
   // `Operation.metadata` contains `OperationMetadata` (metadata).
   // `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (results).
-  rpc AsyncBatchAnnotateFiles(AsyncBatchAnnotateFilesRequest)
-      returns (google.longrunning.Operation) {
+  rpc AsyncBatchAnnotateFiles(AsyncBatchAnnotateFilesRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v1/files:asyncBatchAnnotate"
       body: "*"
+      additional_bindings {
+        post: "/v1/{parent=projects/*/locations/*}/files:asyncBatchAnnotate"
+        body: "*"
+      }
+      additional_bindings {
+        post: "/v1/{parent=projects/*}/files:asyncBatchAnnotate"
+        body: "*"
+      }
+    };
+    option (google.api.method_signature) = "requests";
+    option (google.longrunning.operation_info) = {
+      response_type: "AsyncBatchAnnotateFilesResponse"
+      metadata_type: "OperationMetadata"
     };
   }
 }
@@ -160,28 +207,6 @@ message Feature {
   string model = 3;
 }
 
-// A bucketized representation of likelihood, which is intended to give clients
-// highly stable results across model upgrades.
-enum Likelihood {
-  // Unknown likelihood.
-  UNKNOWN = 0;
-
-  // It is very unlikely that the image belongs to the specified vertical.
-  VERY_UNLIKELY = 1;
-
-  // It is unlikely that the image belongs to the specified vertical.
-  UNLIKELY = 2;
-
-  // It is possible that the image belongs to the specified vertical.
-  POSSIBLE = 3;
-
-  // It is likely that the image belongs to the specified vertical.
-  LIKELY = 4;
-
-  // It is very likely that the image belongs to the specified vertical.
-  VERY_LIKELY = 5;
-}
-
 // External image source (Google Cloud Storage or web URL image location).
 message ImageSource {
   // **Use `image_uri` instead.**
@@ -225,6 +250,28 @@ message Image {
   ImageSource source = 2;
 }
 
+// A bucketized representation of likelihood, which is intended to give clients
+// highly stable results across model upgrades.
+enum Likelihood {
+  // Unknown likelihood.
+  UNKNOWN = 0;
+
+  // It is very unlikely.
+  VERY_UNLIKELY = 1;
+
+  // It is unlikely.
+  UNLIKELY = 2;
+
+  // It is possible.
+  POSSIBLE = 3;
+
+  // It is likely.
+  LIKELY = 4;
+
+  // It is very likely.
+  VERY_LIKELY = 5;
+}
+
 // A face annotation object contains the results of face detection.
 message FaceAnnotation {
   // A face-specific landmark (for example, a face feature).
@@ -519,6 +566,30 @@ message SafeSearchAnnotation {
   // covered nudity, lewd or provocative poses, or close-ups of sensitive
   // body areas.
   Likelihood racy = 9;
+
+  // Confidence of adult_score. Range [0, 1]. 0 means not confident, 1 means
+  // very confident.
+  float adult_confidence = 16;
+
+  // Confidence of spoof_score. Range [0, 1]. 0 means not confident, 1 means
+  // very confident.
+  float spoof_confidence = 18;
+
+  // Confidence of medical_score. Range [0, 1]. 0 means not confident, 1 means
+  // very confident.
+  float medical_confidence = 20;
+
+  // Confidence of violence_score. Range [0, 1]. 0 means not confident, 1 means
+  // very confident.
+  float violence_confidence = 22;
+
+  // Confidence of racy_score. Range [0, 1]. 0 means not confident, 1 means very
+  // confident.
+  float racy_confidence = 24;
+
+  // Confidence of nsfw_score. Range [0, 1]. 0 means not confident, 1 means very
+  // confident.
+  float nsfw_confidence = 26;
 }
 
 // Rectangle determined by min and max `LatLng` pairs.
@@ -605,7 +676,7 @@ message ImageContext {
   // setting a hint will help get better results (although it will be a
   // significant hindrance if the hint is wrong). Text detection returns an
   // error if one or more of the specified languages is not one of the
-  // [supported languages](/vision/docs/languages).
+  // [supported languages](https://cloud.google.com/vision/docs/languages).
   repeated string language_hints = 2;
 
   // Parameters for crop hints annotation request.
@@ -694,23 +765,24 @@ message AnnotateImageResponse {
   ImageAnnotationContext context = 21;
 }
 
-// Response to a single file annotation request. A file may contain one or more
-// images, which individually have their own responses.
-message AnnotateFileResponse {
-  // Information about the file for which this response is generated.
-  InputConfig input_config = 1;
-
-  // Individual responses to images found within the file.
-  repeated AnnotateImageResponse responses = 2;
-
-  // This field gives the total number of pages in the file.
-  int32 total_pages = 3;
-}
-
 // Multiple image annotation requests are batched into a single service call.
 message BatchAnnotateImagesRequest {
-  // Individual image annotation requests for this batch.
-  repeated AnnotateImageRequest requests = 1;
+  // Required. Individual image annotation requests for this batch.
+  repeated AnnotateImageRequest requests = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Target project and location to make a call.
+  //
+  // Format: `projects/{project-id}/locations/{location-id}`.
+  //
+  // If no parent is specified, a region will be chosen automatically.
+  //
+  // Supported location-ids:
+  //     `us`: USA country only,
+  //     `asia`: East asia areas, like Japan, Taiwan,
+  //     `eu`: The European Union.
+  //
+  // Example: `projects/project-A/locations/eu`.
+  string parent = 4;
 }
 
 // Response to a batch image annotation request.
@@ -747,11 +819,43 @@ message AnnotateFileRequest {
   repeated int32 pages = 4;
 }
 
+// Response to a single file annotation request. A file may contain one or more
+// images, which individually have their own responses.
+message AnnotateFileResponse {
+  // Information about the file for which this response is generated.
+  InputConfig input_config = 1;
+
+  // Individual responses to images found within the file. This field will be
+  // empty if the `error` field is set.
+  repeated AnnotateImageResponse responses = 2;
+
+  // This field gives the total number of pages in the file.
+  int32 total_pages = 3;
+
+  // If set, represents the error message for the failed request. The
+  // `responses` field will not be set in this case.
+  google.rpc.Status error = 4;
+}
+
 // A list of requests to annotate files using the BatchAnnotateFiles API.
 message BatchAnnotateFilesRequest {
-  // The list of file annotation requests. Right now we support only one
+  // Required. The list of file annotation requests. Right now we support only one
   // AnnotateFileRequest in BatchAnnotateFilesRequest.
-  repeated AnnotateFileRequest requests = 1;
+  repeated AnnotateFileRequest requests = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Target project and location to make a call.
+  //
+  // Format: `projects/{project-id}/locations/{location-id}`.
+  //
+  // If no parent is specified, a region will be chosen automatically.
+  //
+  // Supported location-ids:
+  //     `us`: USA country only,
+  //     `asia`: East asia areas, like Japan, Taiwan,
+  //     `eu`: The European Union.
+  //
+  // Example: `projects/project-A/locations/eu`.
+  string parent = 3;
 }
 
 // A list of file annotation responses.
@@ -784,11 +888,25 @@ message AsyncAnnotateFileResponse {
 
 // Request for async image annotation for a list of images.
 message AsyncBatchAnnotateImagesRequest {
-  // Individual image annotation requests for this batch.
-  repeated AnnotateImageRequest requests = 1;
+  // Required. Individual image annotation requests for this batch.
+  repeated AnnotateImageRequest requests = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Required. The desired output location and metadata (e.g. format).
-  OutputConfig output_config = 2;
+  OutputConfig output_config = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Target project and location to make a call.
+  //
+  // Format: `projects/{project-id}/locations/{location-id}`.
+  //
+  // If no parent is specified, a region will be chosen automatically.
+  //
+  // Supported location-ids:
+  //     `us`: USA country only,
+  //     `asia`: East asia areas, like Japan, Taiwan,
+  //     `eu`: The European Union.
+  //
+  // Example: `projects/project-A/locations/eu`.
+  string parent = 4;
 }
 
 // Response to an async batch image annotation request.
@@ -800,8 +918,22 @@ message AsyncBatchAnnotateImagesResponse {
 // Multiple async file annotation requests are batched into a single service
 // call.
 message AsyncBatchAnnotateFilesRequest {
-  // Individual async file annotation requests for this batch.
-  repeated AsyncAnnotateFileRequest requests = 1;
+  // Required. Individual async file annotation requests for this batch.
+  repeated AsyncAnnotateFileRequest requests = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Target project and location to make a call.
+  //
+  // Format: `projects/{project-id}/locations/{location-id}`.
+  //
+  // If no parent is specified, a region will be chosen automatically.
+  //
+  // Supported location-ids:
+  //     `us`: USA country only,
+  //     `asia`: East asia areas, like Japan, Taiwan,
+  //     `eu`: The European Union.
+  //
+  // Example: `projects/project-A/locations/eu`.
+  string parent = 4;
 }
 
 // Response to an async batch file annotation request.
diff --git a/third_party/googleapis/google/cloud/vision/v1/product_search.proto b/third_party/googleapis/google/cloud/vision/v1/product_search.proto
index 9d981ff77..6df694b8b 100644
--- a/third_party/googleapis/google/cloud/vision/v1/product_search.proto
+++ b/third_party/googleapis/google/cloud/vision/v1/product_search.proto
@@ -17,10 +17,11 @@ syntax = "proto3";
 
 package google.cloud.vision.v1;
 
-import "google/api/annotations.proto";
 import "google/cloud/vision/v1/geometry.proto";
 import "google/cloud/vision/v1/product_search_service.proto";
 import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+import "google/api/resource.proto";
 
 option cc_enable_arenas = true;
 option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1;vision";
@@ -35,20 +36,21 @@ message ProductSearchParams {
   // Optional. If it is not specified, system discretion will be applied.
   BoundingPoly bounding_poly = 9;
 
-  // The resource name of a [ProductSet][google.cloud.vision.v1.ProductSet] to
-  // be searched for similar images.
+  // The resource name of a [ProductSet][google.cloud.vision.v1.ProductSet] to be searched for similar images.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
-  string product_set = 6;
+  string product_set = 6 [(google.api.resource_reference) = {
+    type: "vision.googleapis.com/ProductSet"
+  }];
 
   // The list of product categories to search in. Currently, we only consider
-  // the first category, and either "homegoods-v2", "apparel-v2", or "toys-v2"
-  // should be specified. The legacy categories "homegoods", "apparel", and
-  // "toys" are still supported but will be deprecated. For new products, please
-  // use "homegoods-v2", "apparel-v2", or "toys-v2" for better product search
-  // accuracy. It is recommended to migrate existing products to these
-  // categories as well.
+  // the first category, and either "homegoods-v2", "apparel-v2", "toys-v2",
+  // "packagedgoods-v1", or "general-v1" should be specified. The legacy
+  // categories "homegoods", "apparel", and "toys" are still supported but will
+  // be deprecated. For new products, please use "homegoods-v2", "apparel-v2",
+  // or "toys-v2" for better product search accuracy. It is recommended to
+  // migrate existing products to these categories as well.
   repeated string product_categories = 7;
 
   // The filtering expression. This can be used to restrict search results based
@@ -78,6 +80,23 @@ message ProductSearchResults {
     string image = 3;
   }
 
+  // Prediction for what the object in the bounding box is.
+  message ObjectAnnotation {
+    // Object ID that should align with EntityAnnotation mid.
+    string mid = 1;
+
+    // The BCP-47 language code, such as "en-US" or "sr-Latn". For more
+    // information, see
+    // http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
+    string language_code = 2;
+
+    // Object name, expressed in its `language_code` language.
+    string name = 3;
+
+    // Score of the result. Range [0, 1].
+    float score = 4;
+  }
+
   // Information about the products similar to a single product in a query
   // image.
   message GroupedResult {
@@ -86,6 +105,9 @@ message ProductSearchResults {
 
     // List of results, one for each product match.
     repeated Result results = 2;
+
+    // List of generic predictions for the object in the bounding box.
+    repeated ObjectAnnotation object_annotations = 3;
   }
 
   // Timestamp of the index which provided these results. Products added to the
diff --git a/third_party/googleapis/google/cloud/vision/v1/product_search_service.proto b/third_party/googleapis/google/cloud/vision/v1/product_search_service.proto
index 5b36591c2..ecfcdf6c7 100644
--- a/third_party/googleapis/google/cloud/vision/v1/product_search_service.proto
+++ b/third_party/googleapis/google/cloud/vision/v1/product_search_service.proto
@@ -18,6 +18,9 @@ syntax = "proto3";
 package google.cloud.vision.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/vision/v1/geometry.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/empty.proto";
@@ -35,20 +38,23 @@ option objc_class_prefix = "GCVN";
 // Manages Products and ProductSets of reference images for use in product
 // search. It uses the following resource model:
 //
-// - The API has a collection of [ProductSet][google.cloud.vision.v1.ProductSet]
-// resources, named `projects/*/locations/*/productSets/*`, which acts as a way
-// to put different products into groups to limit identification.
+// - The API has a collection of [ProductSet][google.cloud.vision.v1.ProductSet] resources, named
+// `projects/*/locations/*/productSets/*`, which acts as a way to put different
+// products into groups to limit identification.
 //
 // In parallel,
 //
-// - The API has a collection of [Product][google.cloud.vision.v1.Product]
-// resources, named
+// - The API has a collection of [Product][google.cloud.vision.v1.Product] resources, named
 //   `projects/*/locations/*/products/*`
 //
-// - Each [Product][google.cloud.vision.v1.Product] has a collection of
-// [ReferenceImage][google.cloud.vision.v1.ReferenceImage] resources, named
+// - Each [Product][google.cloud.vision.v1.Product] has a collection of [ReferenceImage][google.cloud.vision.v1.ReferenceImage] resources, named
 //   `projects/*/locations/*/products/*/referenceImages/*`
 service ProductSearch {
+  option (google.api.default_host) = "vision.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/cloud-vision";
+
   // Creates and returns a new ProductSet resource.
   //
   // Possible errors:
@@ -60,6 +66,7 @@ service ProductSearch {
       post: "/v1/{parent=projects/*/locations/*}/productSets"
       body: "product_set"
     };
+    option (google.api.method_signature) = "parent,product_set,product_set_id";
   }
 
   // Lists ProductSets in an unspecified order.
@@ -68,11 +75,11 @@ service ProductSearch {
   //
   // * Returns INVALID_ARGUMENT if page_size is greater than 100, or less
   //   than 1.
-  rpc ListProductSets(ListProductSetsRequest)
-      returns (ListProductSetsResponse) {
+  rpc ListProductSets(ListProductSetsRequest) returns (ListProductSetsResponse) {
     option (google.api.http) = {
       get: "/v1/{parent=projects/*/locations/*}/productSets"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets information associated with a ProductSet.
@@ -84,6 +91,7 @@ service ProductSearch {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/locations/*/productSets/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Makes changes to a ProductSet resource.
@@ -99,17 +107,18 @@ service ProductSearch {
       patch: "/v1/{product_set.name=projects/*/locations/*/productSets/*}"
       body: "product_set"
     };
+    option (google.api.method_signature) = "product_set,update_mask";
   }
 
   // Permanently deletes a ProductSet. Products and ReferenceImages in the
   // ProductSet are not deleted.
   //
   // The actual image files are not deleted from Google Cloud Storage.
-  rpc DeleteProductSet(DeleteProductSetRequest)
-      returns (google.protobuf.Empty) {
+  rpc DeleteProductSet(DeleteProductSetRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v1/{name=projects/*/locations/*/productSets/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates and returns a new product resource.
@@ -125,6 +134,7 @@ service ProductSearch {
       post: "/v1/{parent=projects/*/locations/*}/products"
       body: "product"
     };
+    option (google.api.method_signature) = "parent,product,product_id";
   }
 
   // Lists products in an unspecified order.
@@ -136,6 +146,7 @@ service ProductSearch {
     option (google.api.http) = {
       get: "/v1/{parent=projects/*/locations/*}/products"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets information associated with a Product.
@@ -147,6 +158,7 @@ service ProductSearch {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/locations/*/products/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Makes changes to a Product resource.
@@ -169,6 +181,7 @@ service ProductSearch {
       patch: "/v1/{product.name=projects/*/locations/*/products/*}"
       body: "product"
     };
+    option (google.api.method_signature) = "product,update_mask";
   }
 
   // Permanently deletes a product and its reference images.
@@ -180,6 +193,7 @@ service ProductSearch {
     option (google.api.http) = {
       delete: "/v1/{name=projects/*/locations/*/products/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates and returns a new ReferenceImage resource.
@@ -201,12 +215,12 @@ service ProductSearch {
   // * Returns INVALID_ARGUMENT if bounding_poly is not provided, and nothing
   //   compatible with the parent product's product_category is detected.
   // * Returns INVALID_ARGUMENT if bounding_poly contains more than 10 polygons.
-  rpc CreateReferenceImage(CreateReferenceImageRequest)
-      returns (ReferenceImage) {
+  rpc CreateReferenceImage(CreateReferenceImageRequest) returns (ReferenceImage) {
     option (google.api.http) = {
       post: "/v1/{parent=projects/*/locations/*/products/*}/referenceImages"
       body: "reference_image"
     };
+    option (google.api.method_signature) = "parent,reference_image,reference_image_id";
   }
 
   // Permanently deletes a reference image.
@@ -216,11 +230,11 @@ service ProductSearch {
   // caches are refreshed.
   //
   // The actual image files are not deleted from Google Cloud Storage.
-  rpc DeleteReferenceImage(DeleteReferenceImageRequest)
-      returns (google.protobuf.Empty) {
+  rpc DeleteReferenceImage(DeleteReferenceImageRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v1/{name=projects/*/locations/*/products/*/referenceImages/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists reference images.
@@ -230,11 +244,11 @@ service ProductSearch {
   // * Returns NOT_FOUND if the parent product does not exist.
   // * Returns INVALID_ARGUMENT if the page_size is greater than 100, or less
   //   than 1.
-  rpc ListReferenceImages(ListReferenceImagesRequest)
-      returns (ListReferenceImagesResponse) {
+  rpc ListReferenceImages(ListReferenceImagesRequest) returns (ListReferenceImagesResponse) {
     option (google.api.http) = {
       get: "/v1/{parent=projects/*/locations/*/products/*}/referenceImages"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets information associated with a ReferenceImage.
@@ -246,6 +260,7 @@ service ProductSearch {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/locations/*/products/*/referenceImages/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Adds a Product to the specified ProductSet. If the Product is already
@@ -256,21 +271,21 @@ service ProductSearch {
   // Possible errors:
   //
   // * Returns NOT_FOUND if the Product or the ProductSet doesn't exist.
-  rpc AddProductToProductSet(AddProductToProductSetRequest)
-      returns (google.protobuf.Empty) {
+  rpc AddProductToProductSet(AddProductToProductSetRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       post: "/v1/{name=projects/*/locations/*/productSets/*}:addProduct"
       body: "*"
     };
+    option (google.api.method_signature) = "name,product";
   }
 
   // Removes a Product from the specified ProductSet.
-  rpc RemoveProductFromProductSet(RemoveProductFromProductSetRequest)
-      returns (google.protobuf.Empty) {
+  rpc RemoveProductFromProductSet(RemoveProductFromProductSetRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       post: "/v1/{name=projects/*/locations/*/productSets/*}:removeProduct"
       body: "*"
     };
+    option (google.api.method_signature) = "name,product";
   }
 
   // Lists the Products in a ProductSet, in an unspecified order. If the
@@ -280,35 +295,80 @@ service ProductSearch {
   // Possible errors:
   //
   // * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.
-  rpc ListProductsInProductSet(ListProductsInProductSetRequest)
-      returns (ListProductsInProductSetResponse) {
+  rpc ListProductsInProductSet(ListProductsInProductSetRequest) returns (ListProductsInProductSetResponse) {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/locations/*/productSets/*}/products"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Asynchronous API that imports a list of reference images to specified
   // product sets based on a list of image information.
   //
-  // The [google.longrunning.Operation][google.longrunning.Operation] API can be
-  // used to keep track of the progress and results of the request.
+  // The [google.longrunning.Operation][google.longrunning.Operation] API can be used to keep track of the
+  // progress and results of the request.
   // `Operation.metadata` contains `BatchOperationMetadata`. (progress)
   // `Operation.response` contains `ImportProductSetsResponse`. (results)
   //
   // The input source of this method is a csv file on Google Cloud Storage.
   // For the format of the csv file please see
   // [ImportProductSetsGcsSource.csv_file_uri][google.cloud.vision.v1.ImportProductSetsGcsSource.csv_file_uri].
-  rpc ImportProductSets(ImportProductSetsRequest)
-      returns (google.longrunning.Operation) {
+  rpc ImportProductSets(ImportProductSetsRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v1/{parent=projects/*/locations/*}/productSets:import"
       body: "*"
     };
+    option (google.api.method_signature) = "parent,input_config";
+    option (google.longrunning.operation_info) = {
+      response_type: "ImportProductSetsResponse"
+      metadata_type: "BatchOperationMetadata"
+    };
+  }
+
+  // Asynchronous API to delete all Products in a ProductSet or all Products
+  // that are in no ProductSet.
+  //
+  // If a Product is a member of the specified ProductSet in addition to other
+  // ProductSets, the Product will still be deleted.
+  //
+  // It is recommended to not delete the specified ProductSet until after this
+  // operation has completed. It is also recommended to not add any of the
+  // Products involved in the batch delete to a new ProductSet while this
+  // operation is running because those Products may still end up deleted.
+  //
+  // It's not possible to undo the PurgeProducts operation. Therefore, it is
+  // recommended to keep the csv files used in ImportProductSets (if that was
+  // how you originally built the Product Set) before starting PurgeProducts, in
+  // case you need to re-import the data after deletion.
+  //
+  // If the plan is to purge all of the Products from a ProductSet and then
+  // re-use the empty ProductSet to re-import new Products into the empty
+  // ProductSet, you must wait until the PurgeProducts operation has finished
+  // for that ProductSet.
+  //
+  // The [google.longrunning.Operation][google.longrunning.Operation] API can be used to keep track of the
+  // progress and results of the request.
+  // `Operation.metadata` contains `BatchOperationMetadata`. (progress)
+  rpc PurgeProducts(PurgeProductsRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/*}/products:purge"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.protobuf.Empty"
+      metadata_type: "BatchOperationMetadata"
+    };
   }
 }
 
 // A Product contains ReferenceImages.
 message Product {
+  option (google.api.resource) = {
+    type: "vision.googleapis.com/Product"
+    pattern: "projects/{project}/locations/{location}/products/{product}"
+  };
+
   // A product label represented as a key-value pair.
   message KeyValue {
     // The key of the label attached to the product. Cannot be empty and cannot
@@ -336,15 +396,11 @@ message Product {
   // characters long.
   string description = 3;
 
-  // The category for the product identified by the reference image. This should
+  // Immutable. The category for the product identified by the reference image. This should
   // be either "homegoods-v2", "apparel-v2", or "toys-v2". The legacy categories
-  // "homegoods", "apparel", and "toys" are still supported but will be
-  // deprecated. For new products, please use "homegoods-v2", "apparel-v2", or
-  // "toys-v2" for better product search accuracy. It is recommended to migrate
-  // existing products to these categories as well.
-  //
-  // This field is immutable.
-  string product_category = 4;
+  // "homegoods", "apparel", and "toys" are still supported, but these should
+  // not be used for new products.
+  string product_category = 4 [(google.api.field_behavior) = IMMUTABLE];
 
   // Key-value pairs that can be attached to a product. At query time,
   // constraints can be specified based on the product_labels.
@@ -354,7 +410,11 @@ message Product {
   // to be supported soon.
   //
   // Multiple values can be assigned to the same key. One product may have up to
-  // 100 product_labels.
+  // 500 product_labels.
+  //
+  // Notice that the total number of distinct product_labels over all products
+  // in one ProductSet cannot exceed 1M, otherwise the product search pipeline
+  // will refuse to work for that ProductSet.
   repeated KeyValue product_labels = 5;
 }
 
@@ -362,6 +422,11 @@ message Product {
 // million reference images. If the limit is exceeded, periodic indexing will
 // fail.
 message ProductSet {
+  option (google.api.resource) = {
+    type: "vision.googleapis.com/ProductSet"
+    pattern: "projects/{project}/locations/{location}/productSets/{product_set}"
+  };
+
   // The resource name of the ProductSet.
   //
   // Format is:
@@ -380,18 +445,23 @@ message ProductSet {
   // "1970-01-01T00:00:00Z".
   //
   // This field is ignored when creating a ProductSet.
-  google.protobuf.Timestamp index_time = 3;
+  google.protobuf.Timestamp index_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. If there was an error with indexing the product set, the field
   // is populated.
   //
   // This field is ignored when creating a ProductSet.
-  google.rpc.Status index_error = 4;
+  google.rpc.Status index_error = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // A `ReferenceImage` represents a product image and its associated metadata,
 // such as bounding boxes.
 message ReferenceImage {
+  option (google.api.resource) = {
+    type: "vision.googleapis.com/ReferenceImage"
+    pattern: "projects/{project}/locations/{location}/products/{product}/referenceImages/{reference_image}"
+  };
+
   // The resource name of the reference image.
   //
   // Format is:
@@ -401,34 +471,37 @@ message ReferenceImage {
   // This field is ignored when creating a reference image.
   string name = 1;
 
-  // The Google Cloud Storage URI of the reference image.
+  // Required. The Google Cloud Storage URI of the reference image.
   //
   // The URI must start with `gs://`.
-  //
-  // Required.
-  string uri = 2;
+  string uri = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Bounding polygons around the areas of interest in the reference image.
-  // Optional. If this field is empty, the system will try to detect regions of
+  // Optional. Bounding polygons around the areas of interest in the reference image.
+  // If this field is empty, the system will try to detect regions of
   // interest. At most 10 bounding polygons will be used.
   //
   // The provided shape is converted into a non-rotated rectangle. Once
   // converted, the small edge of the rectangle must be greater than or equal
   // to 300 pixels. The aspect ratio must be 1:4 or less (i.e. 1:3 is ok; 1:5
   // is not).
-  repeated BoundingPoly bounding_polys = 3;
+  repeated BoundingPoly bounding_polys = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request message for the `CreateProduct` method.
 message CreateProductRequest {
-  // The project in which the Product should be created.
+  // Required. The project in which the Product should be created.
   //
   // Format is
   // `projects/PROJECT_ID/locations/LOC_ID`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
-  // The product to create.
-  Product product = 2;
+  // Required. The product to create.
+  Product product = 2 [(google.api.field_behavior) = REQUIRED];
 
   // A user-supplied resource id for this Product. If set, the server will
   // attempt to use this value as the resource id. If it is already in use, an
@@ -439,11 +512,16 @@ message CreateProductRequest {
 
 // Request message for the `ListProducts` method.
 message ListProductsRequest {
-  // The project OR ProductSet from which Products should be listed.
+  // Required. The project OR ProductSet from which Products should be listed.
   //
   // Format:
   // `projects/PROJECT_ID/locations/LOC_ID`
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
   // The maximum number of items to return. Default 10, maximum 100.
   int32 page_size = 2;
@@ -464,18 +542,23 @@ message ListProductsResponse {
 
 // Request message for the `GetProduct` method.
 message GetProductRequest {
-  // Resource name of the Product to get.
+  // Required. Resource name of the Product to get.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/Product"
+    }
+  ];
 }
 
 // Request message for the `UpdateProduct` method.
 message UpdateProductRequest {
-  // The Product resource which replaces the one on the server.
+  // Required. The Product resource which replaces the one on the server.
   // product.name is immutable.
-  Product product = 1;
+  Product product = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The [FieldMask][google.protobuf.FieldMask] that specifies which fields
   // to update.
@@ -487,22 +570,32 @@ message UpdateProductRequest {
 
 // Request message for the `DeleteProduct` method.
 message DeleteProductRequest {
-  // Resource name of product to delete.
+  // Required. Resource name of product to delete.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/Product"
+    }
+  ];
 }
 
 // Request message for the `CreateProductSet` method.
 message CreateProductSetRequest {
-  // The project in which the ProductSet should be created.
+  // Required. The project in which the ProductSet should be created.
   //
   // Format is `projects/PROJECT_ID/locations/LOC_ID`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
-  // The ProductSet to create.
-  ProductSet product_set = 2;
+  // Required. The ProductSet to create.
+  ProductSet product_set = 2 [(google.api.field_behavior) = REQUIRED];
 
   // A user-supplied resource id for this ProductSet. If set, the server will
   // attempt to use this value as the resource id. If it is already in use, an
@@ -513,10 +606,15 @@ message CreateProductSetRequest {
 
 // Request message for the `ListProductSets` method.
 message ListProductSetsRequest {
-  // The project from which ProductSets should be listed.
+  // Required. The project from which ProductSets should be listed.
   //
   // Format is `projects/PROJECT_ID/locations/LOC_ID`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
   // The maximum number of items to return. Default 10, maximum 100.
   int32 page_size = 2;
@@ -537,17 +635,22 @@ message ListProductSetsResponse {
 
 // Request message for the `GetProductSet` method.
 message GetProductSetRequest {
-  // Resource name of the ProductSet to get.
+  // Required. Resource name of the ProductSet to get.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOG_ID/productSets/PRODUCT_SET_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/ProductSet"
+    }
+  ];
 }
 
 // Request message for the `UpdateProductSet` method.
 message UpdateProductSetRequest {
-  // The ProductSet resource which replaces the one on the server.
-  ProductSet product_set = 1;
+  // Required. The ProductSet resource which replaces the one on the server.
+  ProductSet product_set = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The [FieldMask][google.protobuf.FieldMask] that specifies which fields to
   // update.
@@ -558,24 +661,34 @@ message UpdateProductSetRequest {
 
 // Request message for the `DeleteProductSet` method.
 message DeleteProductSetRequest {
-  // Resource name of the ProductSet to delete.
+  // Required. Resource name of the ProductSet to delete.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/ProductSet"
+    }
+  ];
 }
 
 // Request message for the `CreateReferenceImage` method.
 message CreateReferenceImageRequest {
-  // Resource name of the product in which to create the reference image.
+  // Required. Resource name of the product in which to create the reference image.
   //
   // Format is
   // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
-  string parent = 1;
-
-  // The reference image to create.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/Product"
+    }
+  ];
+
+  // Required. The reference image to create.
   // If an image ID is specified, it is ignored.
-  ReferenceImage reference_image = 2;
+  ReferenceImage reference_image = 2 [(google.api.field_behavior) = REQUIRED];
 
   // A user-supplied resource id for the ReferenceImage to be added. If set,
   // the server will attempt to use this value as the resource id. If it is
@@ -586,11 +699,16 @@ message CreateReferenceImageRequest {
 
 // Request message for the `ListReferenceImages` method.
 message ListReferenceImagesRequest {
-  // Resource name of the product containing the reference images.
+  // Required. Resource name of the product containing the reference images.
   //
   // Format is
   // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/Product"
+    }
+  ];
 
   // The maximum number of items to return. Default 10, maximum 100.
   int32 page_size = 2;
@@ -616,61 +734,96 @@ message ListReferenceImagesResponse {
 
 // Request message for the `GetReferenceImage` method.
 message GetReferenceImageRequest {
-  // The resource name of the ReferenceImage to get.
+  // Required. The resource name of the ReferenceImage to get.
   //
   // Format is:
   //
   // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/ReferenceImage"
+    }
+  ];
 }
 
 // Request message for the `DeleteReferenceImage` method.
 message DeleteReferenceImageRequest {
-  // The resource name of the reference image to delete.
+  // Required. The resource name of the reference image to delete.
   //
   // Format is:
   //
   // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/ReferenceImage"
+    }
+  ];
 }
 
 // Request message for the `AddProductToProductSet` method.
 message AddProductToProductSetRequest {
-  // The resource name for the ProductSet to modify.
+  // Required. The resource name for the ProductSet to modify.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/ProductSet"
+    }
+  ];
 
-  // The resource name for the Product to be added to this ProductSet.
+  // Required. The resource name for the Product to be added to this ProductSet.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
-  string product = 2;
+  string product = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/Product"
+    }
+  ];
 }
 
 // Request message for the `RemoveProductFromProductSet` method.
 message RemoveProductFromProductSetRequest {
-  // The resource name for the ProductSet to modify.
+  // Required. The resource name for the ProductSet to modify.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/ProductSet"
+    }
+  ];
 
-  // The resource name for the Product to be removed from this ProductSet.
+  // Required. The resource name for the Product to be removed from this ProductSet.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
-  string product = 2;
+  string product = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/Product"
+    }
+  ];
 }
 
 // Request message for the `ListProductsInProductSet` method.
 message ListProductsInProductSetRequest {
-  // The ProductSet resource for which to retrieve Products.
+  // Required. The ProductSet resource for which to retrieve Products.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/ProductSet"
+    }
+  ];
 
   // The maximum number of items to return. Default 10, maximum 100.
   int32 page_size = 2;
@@ -717,17 +870,15 @@ message ImportProductSetsGcsSource {
   // `product-display-name` column refers to
   // [display_name][google.cloud.vision.v1.Product.display_name], the
   // `product-category` column refers to
-  // [product_category][google.cloud.vision.v1.Product.product_category], and
-  // the `labels` column refers to
-  // [product_labels][google.cloud.vision.v1.Product.product_labels].
+  // [product_category][google.cloud.vision.v1.Product.product_category], and the
+  // `labels` column refers to [product_labels][google.cloud.vision.v1.Product.product_labels].
   //
   // The `image-id` column is optional but must be unique if provided. If it is
   // empty, the system will automatically assign a unique id to the image.
   //
   // The `product-display-name` column is optional. If it is empty, the system
-  // sets the [display_name][google.cloud.vision.v1.Product.display_name] field
-  // for the product to a space (" "). You can update the `display_name` later
-  // by using the API.
+  // sets the [display_name][google.cloud.vision.v1.Product.display_name] field for the product to a
+  // space (" "). You can update the `display_name` later by using the API.
   //
   // If a `Product` with the specified `product-id` already exists, then the
   // system ignores the `product-display-name`, `product-category`, and `labels`
@@ -770,22 +921,25 @@ message ImportProductSetsInputConfig {
 
 // Request message for the `ImportProductSets` method.
 message ImportProductSetsRequest {
-  // The project in which the ProductSets should be imported.
+  // Required. The project in which the ProductSets should be imported.
   //
   // Format is `projects/PROJECT_ID/locations/LOC_ID`.
-  string parent = 1;
-
-  // The input content for the list of requests.
-  ImportProductSetsInputConfig input_config = 2;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // Required. The input content for the list of requests.
+  ImportProductSetsInputConfig input_config = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response message for the `ImportProductSets` method.
 //
 // This message is returned by the
-// [google.longrunning.Operations.GetOperation][google.longrunning.Operations.GetOperation]
-// method in the returned
-// [google.longrunning.Operation.response][google.longrunning.Operation.response]
-// field.
+// [google.longrunning.Operations.GetOperation][google.longrunning.Operations.GetOperation] method in the returned
+// [google.longrunning.Operation.response][google.longrunning.Operation.response] field.
 message ImportProductSetsResponse {
   // The list of reference_images that are imported successfully.
   repeated ReferenceImage reference_images = 1;
@@ -832,7 +986,41 @@ message BatchOperationMetadata {
   google.protobuf.Timestamp submit_time = 2;
 
   // The time when the batch request is finished and
-  // [google.longrunning.Operation.done][google.longrunning.Operation.done] is
-  // set to true.
+  // [google.longrunning.Operation.done][google.longrunning.Operation.done] is set to true.
   google.protobuf.Timestamp end_time = 3;
 }
+
+// Config to control which ProductSet contains the Products to be deleted.
+message ProductSetPurgeConfig {
+  // The ProductSet that contains the Products to delete. If a Product is a
+  // member of product_set_id in addition to other ProductSets, the Product will
+  // still be deleted.
+  string product_set_id = 1;
+}
+
+// Request message for the `PurgeProducts` method.
+message PurgeProductsRequest {
+  // The Products to delete.
+  oneof target {
+    // Specify which ProductSet contains the Products to be deleted.
+    ProductSetPurgeConfig product_set_purge_config = 2;
+
+    // If delete_orphan_products is true, all Products that are not in any
+    // ProductSet will be deleted.
+    bool delete_orphan_products = 3;
+  }
+
+  // Required. The project and location in which the Products should be deleted.
+  //
+  // Format is `projects/PROJECT_ID/locations/LOC_ID`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // The default value is false. Override this value to true to actually perform
+  // the purge.
+  bool force = 4;
+}
diff --git a/third_party/googleapis/google/cloud/vision/v1/text_annotation.proto b/third_party/googleapis/google/cloud/vision/v1/text_annotation.proto
index afbebea51..97f9c8fa9 100644
--- a/third_party/googleapis/google/cloud/vision/v1/text_annotation.proto
+++ b/third_party/googleapis/google/cloud/vision/v1/text_annotation.proto
@@ -17,8 +17,8 @@ syntax = "proto3";
 
 package google.cloud.vision.v1;
 
-import "google/api/annotations.proto";
 import "google/cloud/vision/v1/geometry.proto";
+import "google/api/annotations.proto";
 
 option cc_enable_arenas = true;
 option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1;vision";
@@ -32,9 +32,8 @@ option objc_class_prefix = "GCVN";
 //     TextAnnotation -> Page -> Block -> Paragraph -> Word -> Symbol
 // Each structural component, starting from Page, may further have their own
 // properties. Properties describe detected languages, breaks etc.. Please refer
-// to the
-// [TextAnnotation.TextProperty][google.cloud.vision.v1.TextAnnotation.TextProperty]
-// message definition below for more detail.
+// to the [TextAnnotation.TextProperty][google.cloud.vision.v1.TextAnnotation.TextProperty] message definition below for more
+// detail.
 message TextAnnotation {
   // Detected language for a structural component.
   message DetectedLanguage {
@@ -194,7 +193,7 @@ message Paragraph {
   //   and the vertex order will still be (0, 1, 2, 3).
   BoundingPoly bounding_box = 2;
 
-  // List of words in this paragraph.
+  // List of all words in this paragraph.
   repeated Word words = 3;
 
   // Confidence of the OCR results for the paragraph. Range [0, 1].
@@ -250,7 +249,7 @@ message Symbol {
   //      2----3
   //      |    |
   //      1----0
-  //   and the vertice order will still be (0, 1, 2, 3).
+  //   and the vertex order will still be (0, 1, 2, 3).
   BoundingPoly bounding_box = 2;
 
   // The actual UTF-8 representation of the symbol.
diff --git a/third_party/googleapis/google/cloud/vision/v1/vision_gapic.legacy.yaml b/third_party/googleapis/google/cloud/vision/v1/vision_gapic.legacy.yaml
new file mode 100644
index 000000000..62c87c780
--- /dev/null
+++ b/third_party/googleapis/google/cloud/vision/v1/vision_gapic.legacy.yaml
@@ -0,0 +1,640 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.vision.v1
+    release_level: GA
+  python:
+    package_name: google.cloud.vision_v1.gapic
+  go:
+    package_name: cloud.google.com/go/vision/apiv1
+    release_level: GA
+  csharp:
+    package_name: Google.Cloud.Vision.V1
+    release_level: GA
+  ruby:
+    package_name: Google::Cloud::Vision::V1
+  php:
+    package_name: Google\Cloud\Vision\V1
+  nodejs:
+    package_name: vision.v1
+    domain_layer_location: google-cloud
+interfaces:
+- name: google.cloud.vision.v1.ImageAnnotator
+  smoke_test:
+    method: BatchAnnotateImages
+    init_fields:
+    - requests[0].image.source.gcs_image_uri="gs://cloud-samples-data/vision/face_detection/celebrity_recognition/sergey.jpg"
+    - requests[0].features[0].type=FACE_DETECTION
+  collections: []
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 60000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 60000
+    total_timeout_millis: 600000
+  methods:
+  - name: BatchAnnotateImages
+    flattening:
+      groups:
+      - parameters:
+        - requests
+    required_fields:
+    - requests
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: BatchAnnotateFiles
+    flattening:
+      groups:
+      - parameters:
+        - requests
+    required_fields:
+    - requests
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    samples:
+      standalone:
+      - region_tag: vision_batch_annotate_files_gcs
+        value_sets: [vision_batch_annotate_files_gcs]
+      - region_tag: vision_batch_annotate_files
+        value_sets: [vision_batch_annotate_files]
+    sample_value_sets:
+    - id: vision_batch_annotate_files_gcs
+      description: "Perform batch file annotation"
+      parameters:
+        defaults:
+        - requests[0].input_config.gcs_source.uri=gs://cloud-samples-data/vision/document_understanding/kafka.pdf
+        - requests[0].features[0].type=DOCUMENT_TEXT_DETECTION
+        - requests[0].pages[0]=1
+        - requests[0].pages[1]=2
+        - requests[0].pages[2]="-1"
+        attributes:
+        - parameter: requests[0].input_config.gcs_source.uri
+          sample_argument_name: storage_uri
+          description: "Cloud Storage URI to source image in the format gs://[bucket]/[file]"
+        - parameter: requests[0].pages[0]
+          description: |
+            The service can process up to 5 pages per document file.
+            Here we specify the first, second, and last page of the document to be processed.
+      on_success:
+      - loop:
+          collection: $resp.responses[0].responses
+          variable: image_response
+          body:
+          - print: ["Full text: %s", image_response.full_text_annotation.text]
+          - loop:
+              collection: image_response.full_text_annotation.pages
+              variable: page
+              body:
+              - loop:
+                  collection: page.blocks
+                  variable: block
+                  body:
+                  - print: ["\nBlock confidence: %s", block.confidence]
+                  - loop:
+                      collection: block.paragraphs
+                      variable: par
+                      body:
+                      - print: ["\tParagraph confidence: %s", par.confidence]
+                      - loop:
+                          collection: par.words
+                          variable: word
+                          body:
+                          - print: ["\t\tWord confidence: %s", word.confidence]
+                          - loop:
+                              collection: word.symbols
+                              variable: symbol
+                              body:
+                              - print: ["\t\t\tSymbol: %s, (confidence: %s)", symbol.text, symbol.confidence]
+    - id: vision_batch_annotate_files
+      description: "Perform batch file annotation"
+      parameters:
+        defaults:
+        - requests[0].input_config.mime_type="application/pdf"
+        - requests[0].input_config.content="resources/kafka.pdf"
+        - requests[0].features[0].type=DOCUMENT_TEXT_DETECTION
+        - requests[0].pages[0]=1
+        - requests[0].pages[1]=2
+        - requests[0].pages[2]="-1"
+        attributes:
+        - parameter: requests[0].input_config.mime_type
+          description: "Supported mime_type: application/pdf, image/tiff, image/gif"
+        - parameter: requests[0].input_config.content
+          sample_argument_name: file_path
+          read_file: true
+          description: Path to local pdf file, e.g. /path/document.pdf
+        - parameter: requests[0].pages[0]
+          description: "The service can process up to 5 pages per document file. Here we specify the first, second, and last page of the document to be processed."
+      on_success:
+      - loop:
+          collection: $resp.responses[0].responses
+          variable: image_response
+          body:
+          - print: ["Full text: %s", image_response.full_text_annotation.text]
+          - loop:
+              collection: image_response.full_text_annotation.pages
+              variable: page
+              body:
+              - loop:
+                  collection: page.blocks
+                  variable: block
+                  body:
+                  - print: ["\nBlock confidence: %s", block.confidence]
+                  - loop:
+                      collection: block.paragraphs
+                      variable: par
+                      body:
+                      - print: ["\tParagraph confidence: %s", par.confidence]
+                      - loop:
+                          collection: par.words
+                          variable: word
+                          body:
+                          - print: ["\t\tWord confidence: %s", word.confidence]
+                          - loop:
+                              collection: word.symbols
+                              variable: symbol
+                              body:
+                              - print: ["\t\t\tSymbol: %s, (confidence: %s)", symbol.text, symbol.confidence]
+  - name: AsyncBatchAnnotateImages
+    flattening:
+      groups:
+      - parameters:
+        - requests
+        - output_config
+    required_fields:
+    - requests
+    - output_config
+    retry_codes_name: idempotent
+    retry_params_name: default
+    long_running:
+      return_type: google.cloud.vision.v1.AsyncBatchAnnotateImagesResponse
+      metadata_type: google.cloud.vision.v1.OperationMetadata
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+    timeout_millis: 60000
+    samples:
+      standalone:
+      - region_tag: vision_async_batch_annotate_images
+        value_sets: [vision_async_batch_annotate_images]
+    sample_value_sets:
+    - id: vision_async_batch_annotate_images
+      title: Async Batch Image Annotation
+      description: "Perform async batch image annotation"
+      parameters:
+        defaults:
+        - requests[0].image.source.image_uri=gs://cloud-samples-data/vision/label/wakeupcat.jpg
+        - requests[0].features[0].type=LABEL_DETECTION
+        - requests[0].features[1].type=IMAGE_PROPERTIES
+        - output_config.gcs_destination.uri=gs://your-bucket/prefix/
+        - output_config.batch_size=2
+        attributes:
+        - parameter: requests[0].image.source.image_uri
+          sample_argument_name: input_image_uri
+        - parameter: output_config.gcs_destination.uri
+          sample_argument_name: output_uri
+        - parameter: output_config.batch_size
+          description: The max number of responses to output in each JSON file
+      on_success:
+      - comment: ["The output is written to GCS with the provided output_uri as prefix"]
+      - define: gcs_output_uri=$resp.output_config.gcs_destination.uri
+      - print: ["Output written to GCS with prefix: %s", gcs_output_uri]
+  - name: AsyncBatchAnnotateFiles
+    flattening:
+      groups:
+      - parameters:
+        - requests
+    required_fields:
+    - requests
+    retry_codes_name: idempotent
+    retry_params_name: default
+    long_running:
+      return_type: google.cloud.vision.v1.AsyncBatchAnnotateFilesResponse
+      metadata_type: google.cloud.vision.v1.OperationMetadata
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+    timeout_millis: 60000
+- name: google.cloud.vision.v1.ProductSearch
+  collections:
+  - name_pattern: projects/{project}/locations/{location}
+    entity_name: location
+  - name_pattern: projects/{project}/locations/{location}/productSets/{product_set}
+    entity_name: product_set
+  - name_pattern: projects/{project}/locations/{location}/products/{product}
+    entity_name: product
+  - name_pattern: projects/{project}/locations/{location}/products/{product}/referenceImages/{reference_image}
+    entity_name: reference_image
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 60000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 60000
+    total_timeout_millis: 600000
+  methods:
+  - name: CreateProductSet
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - product_set
+        - product_set_id
+    required_fields:
+    - parent
+    - product_set
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    field_name_patterns:
+      parent: location
+  - name: ListProductSets
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: product_sets
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    field_name_patterns:
+      parent: location
+  - name: GetProductSet
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    field_name_patterns:
+      name: product_set
+  - name: UpdateProductSet
+    flattening:
+      groups:
+      - parameters:
+        - product_set
+        - update_mask
+    required_fields:
+    - product_set
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    field_name_patterns:
+      product_set.name: product_set
+  - name: DeleteProductSet
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    field_name_patterns:
+      name: product_set
+  - name: CreateProduct
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - product
+        - product_id
+    required_fields:
+    - parent
+    - product
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    field_name_patterns:
+      parent: location
+  - name: ListProducts
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: products
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    field_name_patterns:
+      parent: location
+  - name: GetProduct
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    field_name_patterns:
+      name: product
+  - name: UpdateProduct
+    flattening:
+      groups:
+      - parameters:
+        - product
+        - update_mask
+    required_fields:
+    - product
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    field_name_patterns:
+      product.name: product
+  - name: DeleteProduct
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    field_name_patterns:
+      name: product
+  - name: CreateReferenceImage
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - reference_image
+        - reference_image_id
+    required_fields:
+    - parent
+    - reference_image
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    field_name_patterns:
+      parent: product
+  - name: DeleteReferenceImage
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: reference_image
+    timeout_millis: 60000
+  - name: ListReferenceImages
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: reference_images
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    field_name_patterns:
+      parent: product
+  - name: GetReferenceImage
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: reference_image
+    timeout_millis: 60000
+  - name: AddProductToProductSet
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - product
+    required_fields:
+    - name
+    - product
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    field_name_patterns:
+      name: product_set
+      product: product
+  - name: RemoveProductFromProductSet
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - product
+    required_fields:
+    - name
+    - product
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    field_name_patterns:
+      name: product_set
+      product: product
+  - name: ListProductsInProductSet
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: products
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    field_name_patterns:
+      name: product_set
+  - name: ImportProductSets
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - input_config
+    required_fields:
+    - parent
+    - input_config
+    long_running:
+      return_type: google.cloud.vision.v1.ImportProductSetsResponse
+      metadata_type: google.cloud.vision.v1.BatchOperationMetadata
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    field_name_patterns:
+      parent: location
+  - name: PurgeProducts
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    long_running:
+      return_type: google.protobuf.Empty
+      metadata_type: google.cloud.vision.v1.BatchOperationMetadata
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    field_name_patterns:
+      parent: location
+# Force string formatting functions to be generated.
+enable_string_format_functions_override: true
+resource_name_generation:
+- message_name: CreateProductSetRequest
+  field_entity_map:
+    parent: location
+- message_name: ListProductSetsRequest
+  field_entity_map:
+    parent: location
+- message_name: GetProductSetRequest
+  field_entity_map:
+    name: product_set
+- message_name: UpdateProductSetRequest
+  field_entity_map:
+    product_set.name: product_set
+- message_name: DeleteProductSetRequest
+  field_entity_map:
+    name: product_set
+- message_name: CreateProductRequest
+  field_entity_map:
+    parent: location
+- message_name: ListProductsRequest
+  field_entity_map:
+    parent: location
+- message_name: GetProductRequest
+  field_entity_map:
+    name: product
+- message_name: UpdateProductRequest
+  field_entity_map:
+    product.name: product
+- message_name: DeleteProductRequest
+  field_entity_map:
+    name: product
+- message_name: CreateReferenceImageRequest
+  field_entity_map:
+    parent: product
+- message_name: DeleteReferenceImageRequest
+  field_entity_map:
+    name: reference_image
+- message_name: ListReferenceImagesRequest
+  field_entity_map:
+    parent: product
+- message_name: GetReferenceImageRequest
+  field_entity_map:
+    name: reference_image
+- message_name: AddProductToProductSetRequest
+  field_entity_map:
+    name: product_set
+    product: product
+- message_name: RemoveProductFromProductSetRequest
+  field_entity_map:
+    name: product_set
+    product: product
+- message_name: ListProductsInProductSetRequest
+  field_entity_map:
+    name: product_set
+- message_name: ImportProductSetsRequest
+  field_entity_map:
+    parent: location
+- message_name: Product
+  field_entity_map:
+    name: product
+- message_name: ProductSet
+  field_entity_map:
+    name: product_set
+- message_name: PurgeProductsRequest
+  field_entity_map:
+    parent: location
+- message_name: ReferenceImage
+  field_entity_map:
+    name: reference_image
+- message_name: ProductSearchParams
+  field_entity_map:
+    product_set: product_set
diff --git a/third_party/googleapis/google/cloud/vision/v1/vision_gapic.yaml b/third_party/googleapis/google/cloud/vision/v1/vision_gapic.yaml
index bf83ed511..d8ef3af1e 100644
--- a/third_party/googleapis/google/cloud/vision/v1/vision_gapic.yaml
+++ b/third_party/googleapis/google/cloud/vision/v1/vision_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.vision.v1
@@ -24,16 +24,8 @@ interfaces:
   smoke_test:
     method: BatchAnnotateImages
     init_fields:
-    - requests[0].image.source.gcs_image_uri="gs://gapic-toolkit/President_Barack_Obama.jpg"
+    - requests[0].image.source.gcs_image_uri="gs://cloud-samples-data/vision/face_detection/celebrity_recognition/sergey.jpg"
     - requests[0].features[0].type=FACE_DETECTION
-  collections: []
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 100
@@ -45,25 +37,11 @@ interfaces:
     total_timeout_millis: 600000
   methods:
   - name: BatchAnnotateImages
-    flattening:
-      groups:
-      - parameters:
-        - requests
-    required_fields:
-    - requests
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
   - name: BatchAnnotateFiles
-    flattening:
-      groups:
-      - parameters:
-        - requests
-    required_fields:
-    - requests
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
     samples:
       standalone:
       - region_tag: vision_batch_annotate_files_gcs
@@ -168,24 +146,13 @@ interfaces:
                               body:
                               - print: ["\t\t\tSymbol: %s, (confidence: %s)", symbol.text, symbol.confidence]
   - name: AsyncBatchAnnotateImages
-    flattening:
-      groups:
-      - parameters:
-        - requests
-        - output_config
-    required_fields:
-    - requests
-    - output_config
     retry_codes_name: idempotent
     retry_params_name: default
     long_running:
-      return_type: google.cloud.vision.v1.AsyncBatchAnnotateImagesResponse
-      metadata_type: google.cloud.vision.v1.OperationMetadata
       initial_poll_delay_millis: 20000
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 45000
       total_poll_timeout_millis: 86400000
-    timeout_millis: 60000
     samples:
       standalone:
       - region_tag: vision_async_batch_annotate_images
@@ -213,39 +180,14 @@ interfaces:
       - define: gcs_output_uri=$resp.output_config.gcs_destination.uri
       - print: ["Output written to GCS with prefix: %s", gcs_output_uri]
   - name: AsyncBatchAnnotateFiles
-    flattening:
-      groups:
-      - parameters:
-        - requests
-    required_fields:
-    - requests
     retry_codes_name: idempotent
     retry_params_name: default
     long_running:
-      return_type: google.cloud.vision.v1.AsyncBatchAnnotateFilesResponse
-      metadata_type: google.cloud.vision.v1.OperationMetadata
       initial_poll_delay_millis: 20000
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 45000
       total_poll_timeout_millis: 86400000
-    timeout_millis: 60000
 - name: google.cloud.vision.v1.ProductSearch
-  collections:
-  - name_pattern: projects/{project}/locations/{location}
-    entity_name: location
-  - name_pattern: projects/{project}/locations/{location}/productSets/{product_set}
-    entity_name: product_set
-  - name_pattern: projects/{project}/locations/{location}/products/{product}
-    entity_name: product
-  - name_pattern: projects/{project}/locations/{location}/products/{product}/referenceImages/{reference_image}
-    entity_name: reference_image
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 100
@@ -257,361 +199,60 @@ interfaces:
     total_timeout_millis: 600000
   methods:
   - name: CreateProductSet
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - product_set
-        - product_set_id
-    required_fields:
-    - parent
-    - product_set
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
     retry_params_name: default
-    timeout_millis: 60000
-    field_name_patterns:
-      parent: location
   - name: ListProductSets
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: product_sets
-    retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
-    field_name_patterns:
-      parent: location
   - name: GetProductSet
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-    field_name_patterns:
-      name: product_set
   - name: UpdateProductSet
-    flattening:
-      groups:
-      - parameters:
-        - product_set
-        - update_mask
-    required_fields:
-    - product_set
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
-    field_name_patterns:
-      product_set.name: product_set
   - name: DeleteProductSet
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
-    field_name_patterns:
-      name: product_set
   - name: CreateProduct
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - product
-        - product_id
-    required_fields:
-    - parent
-    - product
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
     retry_params_name: default
-    timeout_millis: 60000
-    field_name_patterns:
-      parent: location
   - name: ListProducts
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: products
-    retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
-    field_name_patterns:
-      parent: location
   - name: GetProduct
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
-    field_name_patterns:
-      name: product
   - name: UpdateProduct
-    flattening:
-      groups:
-      - parameters:
-        - product
-        - update_mask
-    required_fields:
-    - product
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
-    field_name_patterns:
-      product.name: product
   - name: DeleteProduct
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
-    field_name_patterns:
-      name: product
   - name: CreateReferenceImage
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - reference_image
-        - reference_image_id
-    required_fields:
-    - parent
-    - reference_image
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
     retry_params_name: default
-    timeout_millis: 60000
-    field_name_patterns:
-      parent: product
   - name: DeleteReferenceImage
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: reference_image
-    timeout_millis: 60000
   - name: ListReferenceImages
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: reference_images
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
-    field_name_patterns:
-      parent: product
   - name: GetReferenceImage
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: reference_image
-    timeout_millis: 60000
   - name: AddProductToProductSet
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - product
-    required_fields:
-    - name
-    - product
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
-    field_name_patterns:
-      name: product_set
-      product: product
   - name: RemoveProductFromProductSet
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - product
-    required_fields:
-    - name
-    - product
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
-    field_name_patterns:
-      name: product_set
-      product: product
   - name: ListProductsInProductSet
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: products
-    retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
-    field_name_patterns:
-      name: product_set
   - name: ImportProductSets
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - input_config
-    required_fields:
-    - parent
-    - input_config
     long_running:
-      return_type: google.cloud.vision.v1.ImportProductSetsResponse
-      metadata_type: google.cloud.vision.v1.BatchOperationMetadata
       initial_poll_delay_millis: 20000
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 45000
       total_poll_timeout_millis: 86400000
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
     retry_params_name: default
-    timeout_millis: 60000
-    field_name_patterns:
-      parent: location
+  - name: PurgeProducts
+    long_running:
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+    retry_params_name: default
 # Force string formatting functions to be generated.
 enable_string_format_functions_override: true
-resource_name_generation:
-- message_name: CreateProductSetRequest
-  field_entity_map:
-    parent: location
-- message_name: ListProductSetsRequest
-  field_entity_map:
-    parent: location
-- message_name: GetProductSetRequest
-  field_entity_map:
-    name: product_set
-- message_name: UpdateProductSetRequest
-  field_entity_map:
-    product_set.name: product_set
-- message_name: DeleteProductSetRequest
-  field_entity_map:
-    name: product_set
-- message_name: CreateProductRequest
-  field_entity_map:
-    parent: location
-- message_name: ListProductsRequest
-  field_entity_map:
-    parent: location
-- message_name: GetProductRequest
-  field_entity_map:
-    name: product
-- message_name: UpdateProductRequest
-  field_entity_map:
-    product.name: product
-- message_name: DeleteProductRequest
-  field_entity_map:
-    name: product
-- message_name: CreateReferenceImageRequest
-  field_entity_map:
-    parent: product
-- message_name: DeleteReferenceImageRequest
-  field_entity_map:
-    name: reference_image
-- message_name: ListReferenceImagesRequest
-  field_entity_map:
-    parent: product
-- message_name: GetReferenceImageRequest
-  field_entity_map:
-    name: reference_image
-- message_name: AddProductToProductSetRequest
-  field_entity_map:
-    name: product_set
-    product: product
-- message_name: RemoveProductFromProductSetRequest
-  field_entity_map:
-    name: product_set
-    product: product
-- message_name: ListProductsInProductSetRequest
-  field_entity_map:
-    name: product_set
-- message_name: ImportProductSetsRequest
-  field_entity_map:
-    parent: location
-- message_name: Product
-  field_entity_map:
-    name: product
-- message_name: ProductSet
-  field_entity_map:
-    name: product_set
-- message_name: ReferenceImage
-  field_entity_map:
-    name: reference_image
-- message_name: ProductSearchParams
-  field_entity_map:
-    product_set: product_set
diff --git a/third_party/googleapis/google/cloud/vision/v1/vision_grpc_service_config.json b/third_party/googleapis/google/cloud/vision/v1/vision_grpc_service_config.json
new file mode 100755
index 000000000..93863b5c7
--- /dev/null
+++ b/third_party/googleapis/google/cloud/vision/v1/vision_grpc_service_config.json
@@ -0,0 +1,136 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.vision.v1.ImageAnnotator",
+          "method": "BatchAnnotateImages"
+        },
+        {
+          "service": "google.cloud.vision.v1.ImageAnnotator",
+          "method": "BatchAnnotateFiles"
+        },
+        {
+          "service": "google.cloud.vision.v1.ImageAnnotator",
+          "method": "AsyncBatchAnnotateImages"
+        },
+        {
+          "service": "google.cloud.vision.v1.ImageAnnotator",
+          "method": "AsyncBatchAnnotateFiles"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.vision.v1.ProductSearch",
+          "method": "CreateProductSet"
+        },
+        {
+          "service": "google.cloud.vision.v1.ProductSearch",
+          "method": "CreateProduct"
+        },
+        {
+          "service": "google.cloud.vision.v1.ProductSearch",
+          "method": "CreateReferenceImage"
+        },
+        {
+          "service": "google.cloud.vision.v1.ProductSearch",
+          "method": "ImportProductSets"
+        },
+        {
+          "service": "google.cloud.vision.v1.ProductSearch",
+          "method": "PurgeProducts"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.vision.v1.ProductSearch",
+          "method": "ListProductSets"
+        },
+        {
+          "service": "google.cloud.vision.v1.ProductSearch",
+          "method": "GetProductSet"
+        },
+        {
+          "service": "google.cloud.vision.v1.ProductSearch",
+          "method": "UpdateProductSet"
+        },
+        {
+          "service": "google.cloud.vision.v1.ProductSearch",
+          "method": "DeleteProductSet"
+        },
+        {
+          "service": "google.cloud.vision.v1.ProductSearch",
+          "method": "ListProducts"
+        },
+        {
+          "service": "google.cloud.vision.v1.ProductSearch",
+          "method": "GetProduct"
+        },
+        {
+          "service": "google.cloud.vision.v1.ProductSearch",
+          "method": "UpdateProduct"
+        },
+        {
+          "service": "google.cloud.vision.v1.ProductSearch",
+          "method": "DeleteProduct"
+        },
+        {
+          "service": "google.cloud.vision.v1.ProductSearch",
+          "method": "DeleteReferenceImage"
+        },
+        {
+          "service": "google.cloud.vision.v1.ProductSearch",
+          "method": "ListReferenceImages"
+        },
+        {
+          "service": "google.cloud.vision.v1.ProductSearch",
+          "method": "GetReferenceImage"
+        },
+        {
+          "service": "google.cloud.vision.v1.ProductSearch",
+          "method": "AddProductToProductSet"
+        },
+        {
+          "service": "google.cloud.vision.v1.ProductSearch",
+          "method": "RemoveProductFromProductSet"
+        },
+        {
+          "service": "google.cloud.vision.v1.ProductSearch",
+          "method": "ListProductsInProductSet"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/vision/vision_v1.yaml b/third_party/googleapis/google/cloud/vision/v1/vision_v1.yaml
similarity index 74%
rename from third_party/googleapis/google/cloud/vision/vision_v1.yaml
rename to third_party/googleapis/google/cloud/vision/v1/vision_v1.yaml
index 4169dafe9..4a45e9728 100644
--- a/third_party/googleapis/google/cloud/vision/vision_v1.yaml
+++ b/third_party/googleapis/google/cloud/vision/v1/vision_v1.yaml
@@ -33,7 +33,17 @@ http:
 
 authentication:
   rules:
-  - selector: '*'
+  - selector: 'google.cloud.vision.v1.ImageAnnotator.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-vision
+  - selector: 'google.cloud.vision.v1.ProductSearch.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-vision
+  - selector: 'google.longrunning.Operations.*'
     oauth:
       canonical_scopes: |-
         https://www.googleapis.com/auth/cloud-platform,
diff --git a/third_party/googleapis/google/cloud/vision/v1/web_detection.proto b/third_party/googleapis/google/cloud/vision/v1/web_detection.proto
index f4a22019c..5ba864038 100644
--- a/third_party/googleapis/google/cloud/vision/v1/web_detection.proto
+++ b/third_party/googleapis/google/cloud/vision/v1/web_detection.proto
@@ -50,17 +50,6 @@ message WebDetection {
     float score = 2;
   }
 
-  // Label to provide extra metadata for the web detection.
-  message WebLabel {
-    // Label for extra metadata.
-    string label = 1;
-
-    // The BCP-47 language code for `label`, such as "en-US" or "sr-Latn".
-    // For more information, see
-    // http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
-    string language_code = 2;
-  }
-
   // Metadata for web pages.
   message WebPage {
     // The result web page URL.
@@ -83,6 +72,17 @@ message WebDetection {
     repeated WebImage partial_matching_images = 5;
   }
 
+  // Label to provide extra metadata for the web detection.
+  message WebLabel {
+    // Label for extra metadata.
+    string label = 1;
+
+    // The BCP-47 language code for `label`, such as "en-US" or "sr-Latn".
+    // For more information, see
+    // http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
+    string language_code = 2;
+  }
+
   // Deduced entities from similar images on the Internet.
   repeated WebEntity web_entities = 1;
 
diff --git a/third_party/googleapis/google/cloud/vision/v1p1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/vision/v1p1beta1/BUILD.bazel
index 9e0c8f78c..13f33e046 100644
--- a/third_party/googleapis/google/cloud/vision/v1p1beta1/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/vision/v1p1beta1/BUILD.bazel
@@ -1,9 +1,12 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
@@ -16,7 +19,8 @@ proto_library(
     ],
     deps = [
         "//google/api:annotations_proto",
-        "//google/longrunning:operations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
         "//google/rpc:status_proto",
         "//google/type:color_proto",
         "//google/type:latlng_proto",
@@ -25,7 +29,10 @@ proto_library(
 
 proto_library_with_info(
     name = "vision_proto_with_info",
-    deps = [":vision_proto"],
+    deps = [
+        ":vision_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -33,18 +40,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
     name = "vision_java_proto",
     deps = [":vision_proto"],
@@ -53,51 +55,40 @@ java_proto_library(
 java_grpc_library(
     name = "vision_java_grpc",
     srcs = [":vision_proto"],
-    deps = [":vision_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "vision_resource_name_java_proto",
-    gapic_yaml = "vision_gapic.yaml",
-    deps = [":vision_proto"],
+    deps = [":vision_java_proto"],
 )
 
 java_gapic_library(
     name = "vision_java_gapic",
     src = ":vision_proto_with_info",
     gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1p1beta1",
     service_yaml = "//google/cloud/vision:vision_v1p1beta1.yaml",
-    test_deps = [":vision_java_grpc"],
+    test_deps = [
+        ":vision_java_grpc",
+    ],
     deps = [
         ":vision_java_proto",
-        ":vision_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":vision_java_gapic_test",
+java_gapic_test(
+    name = "vision_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.vision.v1p1beta1.ImageAnnotatorClientTest",
     ],
-) for test_name in [
-    "com.google.cloud.vision.v1p1beta1.ImageAnnotatorClientTest",
-]]
+    runtime_deps = [":vision_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-vision-v1p1beta1-java",
-    client_deps = [":vision_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":vision_java_gapic_test"],
-    grpc_deps = [":vision_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":vision_java_gapic",
+        ":vision_java_grpc",
         ":vision_java_proto",
         ":vision_proto",
-        ":vision_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -105,10 +96,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -118,7 +109,6 @@ go_proto_library(
     protos = [":vision_proto"],
     deps = [
         "//google/api:annotations_go_proto",
-        "//google/longrunning:longrunning_go_proto",
         "//google/rpc:status_go_proto",
         "//google/type:color_go_proto",
         "//google/type:latlng_go_proto",
@@ -127,15 +117,12 @@ go_proto_library(
 
 go_gapic_library(
     name = "vision_go_gapic",
-    src = ":vision_proto_with_info",
-    gapic_yaml = "vision_gapic.yaml",
-    importpath = "cloud.google.com/go/vision/apiv1p1beta1",
+    srcs = [":vision_proto_with_info"],
+    grpc_service_config = "vision_grpc_service_config.json",
+    importpath = "cloud.google.com/go/vision/apiv1p1beta1;vision",
     service_yaml = "//google/cloud/vision:vision_v1p1beta1.yaml",
     deps = [
         ":vision_go_proto",
-        "//google/longrunning:longrunning_go_gapic",
-        "//google/longrunning:longrunning_go_proto",
-        "@com_google_cloud_go//longrunning:go_default_library",
     ],
 )
 
@@ -146,13 +133,234 @@ go_test(
     importpath = "cloud.google.com/go/vision/apiv1p1beta1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-vision-v1p1beta1-go",
     deps = [
         ":vision_go_gapic",
-        ":vision_go_gapic_srcjar-smoke-test.srcjar",
         ":vision_go_gapic_srcjar-test.srcjar",
         ":vision_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "vision_moved_proto",
+    srcs = [":vision_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/rpc:status_proto",
+        "//google/type:color_proto",
+        "//google/type:latlng_proto",
+    ],
+)
+
+py_proto_library(
+    name = "vision_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":vision_moved_proto"],
+)
+
+py_grpc_library(
+    name = "vision_py_grpc",
+    srcs = [":vision_moved_proto"],
+    deps = [":vision_py_proto"],
+)
+
+py_gapic_library(
+    name = "vision_py_gapic",
+    src = ":vision_proto_with_info",
+    gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1p1beta1",
+    service_yaml = "//google/cloud/vision:vision_v1p1beta1.yaml",
+    deps = [
+        ":vision_py_grpc",
+        ":vision_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "vision-v1p1beta1-py",
+    deps = [
+        ":vision_py_gapic",
+        ":vision_py_grpc",
+        ":vision_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "vision_php_proto",
+    deps = [":vision_proto"],
+)
+
+php_grpc_library(
+    name = "vision_php_grpc",
+    srcs = [":vision_proto"],
+    deps = [":vision_php_proto"],
+)
+
+php_gapic_library(
+    name = "vision_php_gapic",
+    src = ":vision_proto_with_info",
+    gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1p1beta1",
+    service_yaml = "//google/cloud/vision:vision_v1p1beta1.yaml",
+    deps = [
+        ":vision_php_grpc",
+        ":vision_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-vision-v1p1beta1-php",
+    deps = [
+        ":vision_php_gapic",
+        ":vision_php_grpc",
+        ":vision_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "vision_nodejs_gapic",
+    src = ":vision_proto_with_info",
+    gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1p1beta1",
+    service_yaml = "//google/cloud/vision:vision_v1p1beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "vision-v1p1beta1-nodejs",
+    deps = [
+        ":vision_nodejs_gapic",
+        ":vision_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "vision_ruby_proto",
+    deps = [":vision_proto"],
+)
+
+ruby_grpc_library(
+    name = "vision_ruby_grpc",
+    srcs = [":vision_proto"],
+    deps = [":vision_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "vision_ruby_gapic",
+    src = ":vision_proto_with_info",
+    gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1p1beta1",
+    service_yaml = "//google/cloud/vision:vision_v1p1beta1.yaml",
+    deps = [
+        ":vision_ruby_grpc",
+        ":vision_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-vision-v1p1beta1-ruby",
+    deps = [
+        ":vision_ruby_gapic",
+        ":vision_ruby_grpc",
+        ":vision_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "vision_csharp_proto",
+    deps = [":vision_proto"],
+)
+
+csharp_grpc_library(
+    name = "vision_csharp_grpc",
+    srcs = [":vision_proto"],
+    deps = [":vision_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "vision_csharp_gapic",
+    src = ":vision_proto_with_info",
+    gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1p1beta1",
+    service_yaml = "//google/cloud/vision:vision_v1p1beta1.yaml",
+    deps = [
+        ":vision_csharp_grpc",
+        ":vision_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-vision-v1p1beta1-csharp",
+    deps = [
+        ":vision_csharp_gapic",
+        ":vision_csharp_grpc",
+        ":vision_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/vision/v1p1beta1/image_annotator.proto b/third_party/googleapis/google/cloud/vision/v1p1beta1/image_annotator.proto
index 4869a3311..4f5ada70d 100644
--- a/third_party/googleapis/google/cloud/vision/v1p1beta1/image_annotator.proto
+++ b/third_party/googleapis/google/cloud/vision/v1p1beta1/image_annotator.proto
@@ -1,4 +1,4 @@
-// Copyright 2017 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,12 +11,15 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.vision.v1p1beta1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/cloud/vision/v1p1beta1/geometry.proto";
 import "google/cloud/vision/v1p1beta1/text_annotation.proto";
 import "google/cloud/vision/v1p1beta1/web_detection.proto";
@@ -34,6 +37,11 @@ option java_package = "com.google.cloud.vision.v1p1beta1";
 // images, such as face, landmark, logo, label, and text detection. The
 // ImageAnnotator service returns detected entities from the images.
 service ImageAnnotator {
+  option (google.api.default_host) = "vision.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/cloud-vision";
+
   // Run image detection and annotation for a batch of images.
   rpc BatchAnnotateImages(BatchAnnotateImagesRequest)
       returns (BatchAnnotateImagesResponse) {
@@ -41,6 +49,7 @@ service ImageAnnotator {
       post: "/v1p1beta1/images:annotate"
       body: "*"
     };
+    option (google.api.method_signature) = "requests";
   }
 }
 
@@ -493,7 +502,7 @@ message ImageContext {
   // setting a hint will help get better results (although it will be a
   // significant hindrance if the hint is wrong). Text detection returns an
   // error if one or more of the specified languages is not one of the
-  // [supported languages](/vision/docs/languages).
+  // [supported languages](https://cloud.google.com/vision/docs/languages).
   repeated string language_hints = 2;
 
   // Parameters for crop hints annotation request.
@@ -559,8 +568,8 @@ message AnnotateImageResponse {
 
 // Multiple image annotation requests are batched into a single service call.
 message BatchAnnotateImagesRequest {
-  // Individual image annotation requests for this batch.
-  repeated AnnotateImageRequest requests = 1;
+  // Required. Individual image annotation requests for this batch.
+  repeated AnnotateImageRequest requests = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response to a batch image annotation request.
diff --git a/third_party/googleapis/google/cloud/vision/v1p1beta1/vision_gapic.legacy.yaml b/third_party/googleapis/google/cloud/vision/v1p1beta1/vision_gapic.legacy.yaml
new file mode 100644
index 000000000..12cfc5cbc
--- /dev/null
+++ b/third_party/googleapis/google/cloud/vision/v1p1beta1/vision_gapic.legacy.yaml
@@ -0,0 +1,55 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.vision.v1p1beta1
+  python:
+    package_name: google.cloud.vision_v1p1beta1.gapic
+  go:
+    package_name: cloud.google.com/go/vision/apiv1p1beta1
+    release_level: BETA
+  csharp:
+    package_name: Google.Cloud.Vision.V1P1Beta1
+    release_level: BETA
+  ruby:
+    package_name: Google::Cloud::Vision::V1p1beta1
+  php:
+    package_name: Google\Cloud\Vision\V1p1beta1
+  nodejs:
+    package_name: vision.v1p1beta1
+    domain_layer_location: google-cloud
+interfaces:
+- name: google.cloud.vision.v1p1beta1.ImageAnnotator
+  smoke_test:
+    method: BatchAnnotateImages
+    init_fields:
+    - requests[0].image.source.gcs_image_uri="gs://cloud-samples-data/vision/face_detection/celebrity_recognition/sergey.jpg"
+    - requests[0].features[0].type=FACE_DETECTION
+  collections: []
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 60000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 60000
+    total_timeout_millis: 600000
+  methods:
+  - name: BatchAnnotateImages
+    flattening:
+      groups:
+      - parameters:
+        - requests
+    required_fields:
+    - requests
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/vision/v1p1beta1/vision_gapic.yaml b/third_party/googleapis/google/cloud/vision/v1p1beta1/vision_gapic.yaml
index 07b9bd9d4..654b8f963 100644
--- a/third_party/googleapis/google/cloud/vision/v1p1beta1/vision_gapic.yaml
+++ b/third_party/googleapis/google/cloud/vision/v1p1beta1/vision_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.vision.v1p1beta1
@@ -23,16 +23,8 @@ interfaces:
   smoke_test:
     method: BatchAnnotateImages
     init_fields:
-    - requests[0].image.source.gcs_image_uri="gs://gapic-toolkit/President_Barack_Obama.jpg"
+    - requests[0].image.source.gcs_image_uri="gs://cloud-samples-data/vision/face_detection/celebrity_recognition/sergey.jpg"
     - requests[0].features[0].type=FACE_DETECTION
-  collections: []
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 100
@@ -44,12 +36,5 @@ interfaces:
     total_timeout_millis: 600000
   methods:
   - name: BatchAnnotateImages
-    flattening:
-      groups:
-      - parameters:
-        - requests
-    required_fields:
-    - requests
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/vision/v1p1beta1/vision_grpc_service_config.json b/third_party/googleapis/google/cloud/vision/v1p1beta1/vision_grpc_service_config.json
new file mode 100755
index 000000000..be169976b
--- /dev/null
+++ b/third_party/googleapis/google/cloud/vision/v1p1beta1/vision_grpc_service_config.json
@@ -0,0 +1,22 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.vision.v1p1beta1.ImageAnnotator",
+          "method": "BatchAnnotateImages"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/vision/v1p1beta1/vision_v1p1beta1.yaml b/third_party/googleapis/google/cloud/vision/v1p1beta1/vision_v1p1beta1.yaml
new file mode 100644
index 000000000..7dc2b552f
--- /dev/null
+++ b/third_party/googleapis/google/cloud/vision/v1p1beta1/vision_v1p1beta1.yaml
@@ -0,0 +1,31 @@
+type: google.api.Service
+config_version: 3
+name: vision.googleapis.com
+title: Cloud Vision API
+
+apis:
+- name: google.cloud.vision.v1p1beta1.ImageAnnotator
+
+types:
+- name: google.cloud.vision.v1p1beta1.AnnotateFileResponse
+- name: google.cloud.vision.v1p1beta1.AsyncBatchAnnotateFilesResponse
+- name: google.cloud.vision.v1p1beta1.OperationMetadata
+
+documentation:
+  summary: |-
+    Integrates Google Vision features, including image labeling, face, logo,
+    and landmark detection, optical character recognition (OCR), and detection
+    of explicit content, into applications.
+
+authentication:
+  rules:
+  - selector: 'google.cloud.vision.v1p1beta1.ImageAnnotator.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-vision
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-vision
diff --git a/third_party/googleapis/google/cloud/vision/v1p2beta1/BUILD.bazel b/third_party/googleapis/google/cloud/vision/v1p2beta1/BUILD.bazel
index 8511d499b..27419a3cb 100644
--- a/third_party/googleapis/google/cloud/vision/v1p2beta1/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/vision/v1p2beta1/BUILD.bazel
@@ -1,9 +1,12 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
@@ -16,6 +19,8 @@ proto_library(
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
         "//google/longrunning:operations_proto",
         "//google/rpc:status_proto",
         "//google/type:color_proto",
@@ -26,7 +31,10 @@ proto_library(
 
 proto_library_with_info(
     name = "vision_proto_with_info",
-    deps = [":vision_proto"],
+    deps = [
+        ":vision_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -34,18 +42,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
     name = "vision_java_proto",
     deps = [":vision_proto"],
@@ -54,51 +57,40 @@ java_proto_library(
 java_grpc_library(
     name = "vision_java_grpc",
     srcs = [":vision_proto"],
-    deps = [":vision_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "vision_resource_name_java_proto",
-    gapic_yaml = "vision_gapic.yaml",
-    deps = [":vision_proto"],
+    deps = [":vision_java_proto"],
 )
 
 java_gapic_library(
     name = "vision_java_gapic",
     src = ":vision_proto_with_info",
     gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1p2beta1",
     service_yaml = "//google/cloud/vision:vision_v1p2beta1.yaml",
-    test_deps = [":vision_java_grpc"],
+    test_deps = [
+        ":vision_java_grpc",
+    ],
     deps = [
         ":vision_java_proto",
-        ":vision_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":vision_java_gapic_test",
+java_gapic_test(
+    name = "vision_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.vision.v1p2beta1.ImageAnnotatorClientTest",
     ],
-) for test_name in [
-    "com.google.cloud.vision.v1p2beta1.ImageAnnotatorClientTest",
-]]
+    runtime_deps = [":vision_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-vision-v1p2beta1-java",
-    client_deps = [":vision_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":vision_java_gapic_test"],
-    grpc_deps = [":vision_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":vision_java_gapic",
+        ":vision_java_grpc",
         ":vision_java_proto",
         ":vision_proto",
-        ":vision_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -106,10 +98,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -128,15 +120,16 @@ go_proto_library(
 
 go_gapic_library(
     name = "vision_go_gapic",
-    src = ":vision_proto_with_info",
-    gapic_yaml = "vision_gapic.yaml",
-    importpath = "cloud.google.com/go/vision/apiv1p2beta1",
+    srcs = [":vision_proto_with_info"],
+    grpc_service_config = "vision_grpc_service_config.json",
+    importpath = "cloud.google.com/go/vision/apiv1p2beta1;vision",
     service_yaml = "//google/cloud/vision:vision_v1p2beta1.yaml",
     deps = [
         ":vision_go_proto",
         "//google/longrunning:longrunning_go_gapic",
         "//google/longrunning:longrunning_go_proto",
         "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
     ],
 )
 
@@ -147,13 +140,236 @@ go_test(
     importpath = "cloud.google.com/go/vision/apiv1p2beta1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-vision-v1p2beta1-go",
     deps = [
         ":vision_go_gapic",
-        ":vision_go_gapic_srcjar-smoke-test.srcjar",
         ":vision_go_gapic_srcjar-test.srcjar",
         ":vision_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "vision_moved_proto",
+    srcs = [":vision_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/longrunning:operations_proto",
+        "//google/rpc:status_proto",
+        "//google/type:color_proto",
+        "//google/type:latlng_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "vision_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":vision_moved_proto"],
+)
+
+py_grpc_library(
+    name = "vision_py_grpc",
+    srcs = [":vision_moved_proto"],
+    deps = [":vision_py_proto"],
+)
+
+py_gapic_library(
+    name = "vision_py_gapic",
+    src = ":vision_proto_with_info",
+    gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1p2beta1",
+    service_yaml = "//google/cloud/vision:vision_v1p2beta1.yaml",
+    deps = [
+        ":vision_py_grpc",
+        ":vision_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "vision-v1p2beta1-py",
+    deps = [
+        ":vision_py_gapic",
+        ":vision_py_grpc",
+        ":vision_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "vision_php_proto",
+    deps = [":vision_proto"],
+)
+
+php_grpc_library(
+    name = "vision_php_grpc",
+    srcs = [":vision_proto"],
+    deps = [":vision_php_proto"],
+)
+
+php_gapic_library(
+    name = "vision_php_gapic",
+    src = ":vision_proto_with_info",
+    gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1p2beta1",
+    service_yaml = "//google/cloud/vision:vision_v1p2beta1.yaml",
+    deps = [
+        ":vision_php_grpc",
+        ":vision_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-vision-v1p2beta1-php",
+    deps = [
+        ":vision_php_gapic",
+        ":vision_php_grpc",
+        ":vision_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "vision_nodejs_gapic",
+    src = ":vision_proto_with_info",
+    gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1p2beta1",
+    service_yaml = "//google/cloud/vision:vision_v1p2beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "vision-v1p2beta1-nodejs",
+    deps = [
+        ":vision_nodejs_gapic",
+        ":vision_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "vision_ruby_proto",
+    deps = [":vision_proto"],
+)
+
+ruby_grpc_library(
+    name = "vision_ruby_grpc",
+    srcs = [":vision_proto"],
+    deps = [":vision_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "vision_ruby_gapic",
+    src = ":vision_proto_with_info",
+    gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1p2beta1",
+    service_yaml = "//google/cloud/vision:vision_v1p2beta1.yaml",
+    deps = [
+        ":vision_ruby_grpc",
+        ":vision_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-vision-v1p2beta1-ruby",
+    deps = [
+        ":vision_ruby_gapic",
+        ":vision_ruby_grpc",
+        ":vision_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "vision_csharp_proto",
+    deps = [":vision_proto"],
+)
+
+csharp_grpc_library(
+    name = "vision_csharp_grpc",
+    srcs = [":vision_proto"],
+    deps = [":vision_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "vision_csharp_gapic",
+    src = ":vision_proto_with_info",
+    gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1p2beta1",
+    service_yaml = "//google/cloud/vision:vision_v1p2beta1.yaml",
+    deps = [
+        ":vision_csharp_grpc",
+        ":vision_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-vision-v1p2beta1-csharp",
+    deps = [
+        ":vision_csharp_gapic",
+        ":vision_csharp_grpc",
+        ":vision_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/vision/v1p2beta1/image_annotator.proto b/third_party/googleapis/google/cloud/vision/v1p2beta1/image_annotator.proto
index c5fce50f9..87ae9f2c6 100644
--- a/third_party/googleapis/google/cloud/vision/v1p2beta1/image_annotator.proto
+++ b/third_party/googleapis/google/cloud/vision/v1p2beta1/image_annotator.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,12 +11,15 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.vision.v1p2beta1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/cloud/vision/v1p2beta1/geometry.proto";
 import "google/cloud/vision/v1p2beta1/text_annotation.proto";
 import "google/cloud/vision/v1p2beta1/web_detection.proto";
@@ -36,13 +39,18 @@ option java_package = "com.google.cloud.vision.v1p2beta1";
 // images, such as face, landmark, logo, label, and text detection. The
 // ImageAnnotator service returns detected entities from the images.
 service ImageAnnotator {
+  option (google.api.default_host) = "vision.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/cloud-vision";
+
   // Run image detection and annotation for a batch of images.
-  rpc BatchAnnotateImages(BatchAnnotateImagesRequest)
-      returns (BatchAnnotateImagesResponse) {
+  rpc BatchAnnotateImages(BatchAnnotateImagesRequest) returns (BatchAnnotateImagesResponse) {
     option (google.api.http) = {
       post: "/v1p2beta1/images:annotate"
       body: "*"
     };
+    option (google.api.method_signature) = "requests";
   }
 
   // Run async image detection and annotation for a list of generic files (e.g.
@@ -51,12 +59,16 @@ service ImageAnnotator {
   // `google.longrunning.Operations` interface.
   // `Operation.metadata` contains `OperationMetadata` (metadata).
   // `Operation.response` contains `AsyncBatchAnnotateFilesResponse` (results).
-  rpc AsyncBatchAnnotateFiles(AsyncBatchAnnotateFilesRequest)
-      returns (google.longrunning.Operation) {
+  rpc AsyncBatchAnnotateFiles(AsyncBatchAnnotateFilesRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v1p2beta1/files:asyncBatchAnnotate"
       body: "*"
     };
+    option (google.api.method_signature) = "requests";
+    option (google.longrunning.operation_info) = {
+      response_type: "AsyncBatchAnnotateFilesResponse"
+      metadata_type: "OperationMetadata"
+    };
   }
 }
 
@@ -521,7 +533,7 @@ message ImageContext {
   // setting a hint will help get better results (although it will be a
   // significant hindrance if the hint is wrong). Text detection returns an
   // error if one or more of the specified languages is not one of the
-  // [supported languages](/vision/docs/languages).
+  // [supported languages](https://cloud.google.com/vision/docs/languages).
   repeated string language_hints = 2;
 
   // Parameters for crop hints annotation request.
@@ -612,8 +624,8 @@ message AnnotateFileResponse {
 
 // Multiple image annotation requests are batched into a single service call.
 message BatchAnnotateImagesRequest {
-  // Individual image annotation requests for this batch.
-  repeated AnnotateImageRequest requests = 1;
+  // Required. Individual image annotation requests for this batch.
+  repeated AnnotateImageRequest requests = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response to a batch image annotation request.
@@ -646,8 +658,8 @@ message AsyncAnnotateFileResponse {
 // Multiple async file annotation requests are batched into a single service
 // call.
 message AsyncBatchAnnotateFilesRequest {
-  // Individual async file annotation requests for this batch.
-  repeated AsyncAnnotateFileRequest requests = 1;
+  // Required. Individual async file annotation requests for this batch.
+  repeated AsyncAnnotateFileRequest requests = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response to an async batch file annotation request.
diff --git a/third_party/googleapis/google/cloud/vision/v1p2beta1/vision_gapic.legacy.yaml b/third_party/googleapis/google/cloud/vision/v1p2beta1/vision_gapic.legacy.yaml
new file mode 100644
index 000000000..6d6699d79
--- /dev/null
+++ b/third_party/googleapis/google/cloud/vision/v1p2beta1/vision_gapic.legacy.yaml
@@ -0,0 +1,72 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.vision.v1p2beta1
+  python:
+    package_name: google.cloud.vision_v1p2beta1.gapic
+  go:
+    package_name: cloud.google.com/go/vision/apiv1p2beta1
+    release_level: BETA
+  csharp:
+    package_name: Google.Cloud.Vision.V1P2Beta1
+    release_level: BETA
+  ruby:
+    package_name: Google::Cloud::Vision::V1p2beta1
+  php:
+    package_name: Google\Cloud\Vision\V1p2beta1
+  nodejs:
+    package_name: vision.v1p2beta1
+    domain_layer_location: google-cloud
+interfaces:
+- name: google.cloud.vision.v1p2beta1.ImageAnnotator
+  smoke_test:
+    method: BatchAnnotateImages
+    init_fields:
+    - requests[0].image.source.gcs_image_uri="gs://cloud-samples-data/vision/face_detection/celebrity_recognition/sergey.jpg"
+    - requests[0].features[0].type=FACE_DETECTION
+  collections: []
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 60000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 60000
+    total_timeout_millis: 600000
+  methods:
+  - name: BatchAnnotateImages
+    flattening:
+      groups:
+      - parameters:
+        - requests
+    required_fields:
+    - requests
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: AsyncBatchAnnotateFiles
+    flattening:
+      groups:
+      - parameters:
+        - requests
+    required_fields:
+    - requests
+    long_running:
+      return_type: google.cloud.vision.v1p2beta1.AsyncBatchAnnotateFilesResponse
+      metadata_type: google.cloud.vision.v1p2beta1.OperationMetadata
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/vision/v1p2beta1/vision_gapic.yaml b/third_party/googleapis/google/cloud/vision/v1p2beta1/vision_gapic.yaml
index 41d5c49b4..31f81e672 100644
--- a/third_party/googleapis/google/cloud/vision/v1p2beta1/vision_gapic.yaml
+++ b/third_party/googleapis/google/cloud/vision/v1p2beta1/vision_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.vision.v1p2beta1
@@ -23,16 +23,8 @@ interfaces:
   smoke_test:
     method: BatchAnnotateImages
     init_fields:
-    - requests[0].image.source.gcs_image_uri="gs://gapic-toolkit/President_Barack_Obama.jpg"
+    - requests[0].image.source.gcs_image_uri="gs://cloud-samples-data/vision/face_detection/celebrity_recognition/sergey.jpg"
     - requests[0].features[0].type=FACE_DETECTION
-  collections: []
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 100
@@ -44,29 +36,13 @@ interfaces:
     total_timeout_millis: 600000
   methods:
   - name: BatchAnnotateImages
-    flattening:
-      groups:
-      - parameters:
-        - requests
-    required_fields:
-    - requests
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
   - name: AsyncBatchAnnotateFiles
-    flattening:
-      groups:
-      - parameters:
-        - requests
-    required_fields:
-    - requests
     long_running:
-      return_type: google.cloud.vision.v1p2beta1.AsyncBatchAnnotateFilesResponse
-      metadata_type: google.cloud.vision.v1p2beta1.OperationMetadata
       initial_poll_delay_millis: 20000
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 45000
       total_poll_timeout_millis: 86400000
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/vision/v1p2beta1/vision_grpc_service_config.json b/third_party/googleapis/google/cloud/vision/v1p2beta1/vision_grpc_service_config.json
new file mode 100755
index 000000000..f4b61a130
--- /dev/null
+++ b/third_party/googleapis/google/cloud/vision/v1p2beta1/vision_grpc_service_config.json
@@ -0,0 +1,26 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.vision.v1p2beta1.ImageAnnotator",
+          "method": "BatchAnnotateImages"
+        },
+        {
+          "service": "google.cloud.vision.v1p2beta1.ImageAnnotator",
+          "method": "AsyncBatchAnnotateFiles"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/vision/v1p2beta1/vision_v1p2beta1.yaml b/third_party/googleapis/google/cloud/vision/v1p2beta1/vision_v1p2beta1.yaml
new file mode 100644
index 000000000..0f43e1439
--- /dev/null
+++ b/third_party/googleapis/google/cloud/vision/v1p2beta1/vision_v1p2beta1.yaml
@@ -0,0 +1,31 @@
+type: google.api.Service
+config_version: 3
+name: vision.googleapis.com
+title: Cloud Vision API
+
+apis:
+- name: google.cloud.vision.v1p2beta1.ImageAnnotator
+
+types:
+- name: google.cloud.vision.v1p2beta1.AnnotateFileResponse
+- name: google.cloud.vision.v1p2beta1.AsyncBatchAnnotateFilesResponse
+- name: google.cloud.vision.v1p2beta1.OperationMetadata
+
+documentation:
+  summary: |-
+    Integrates Google Vision features, including image labeling, face, logo,
+    and landmark detection, optical character recognition (OCR), and detection
+    of explicit content, into applications.
+
+authentication:
+  rules:
+  - selector: 'google.cloud.vision.v1p2beta1.ImageAnnotator.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-vision
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-vision
diff --git a/third_party/googleapis/google/cloud/vision/v1p3beta1/BUILD.bazel b/third_party/googleapis/google/cloud/vision/v1p3beta1/BUILD.bazel
index 371594f03..15d74217d 100644
--- a/third_party/googleapis/google/cloud/vision/v1p3beta1/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/vision/v1p3beta1/BUILD.bazel
@@ -1,9 +1,12 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
@@ -18,6 +21,9 @@ proto_library(
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
         "//google/longrunning:operations_proto",
         "//google/rpc:status_proto",
         "//google/type:color_proto",
@@ -30,7 +36,10 @@ proto_library(
 
 proto_library_with_info(
     name = "vision_proto_with_info",
-    deps = [":vision_proto"],
+    deps = [
+        ":vision_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -38,18 +47,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
     name = "vision_java_proto",
     deps = [":vision_proto"],
@@ -58,51 +62,41 @@ java_proto_library(
 java_grpc_library(
     name = "vision_java_grpc",
     srcs = [":vision_proto"],
-    deps = [":vision_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "vision_resource_name_java_proto",
-    gapic_yaml = "vision_gapic.yaml",
-    deps = [":vision_proto"],
+    deps = [":vision_java_proto"],
 )
 
 java_gapic_library(
     name = "vision_java_gapic",
     src = ":vision_proto_with_info",
     gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1p3beta1",
     service_yaml = "//google/cloud/vision:vision_v1p3beta1.yaml",
-    test_deps = [":vision_java_grpc"],
+    test_deps = [
+        ":vision_java_grpc",
+    ],
     deps = [
         ":vision_java_proto",
-        ":vision_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":vision_java_gapic_test",
+java_gapic_test(
+    name = "vision_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.vision.v1p3beta1.ImageAnnotatorClientTest",
+        "com.google.cloud.vision.v1p3beta1.ProductSearchClientTest",
     ],
-) for test_name in [
-    "com.google.cloud.vision.v1p3beta1.ImageAnnotatorClientTest",
-]]
+    runtime_deps = [":vision_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-vision-v1p3beta1-java",
-    client_deps = [":vision_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":vision_java_gapic_test"],
-    grpc_deps = [":vision_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":vision_java_gapic",
+        ":vision_java_grpc",
         ":vision_java_proto",
         ":vision_proto",
-        ":vision_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -110,10 +104,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -132,15 +126,16 @@ go_proto_library(
 
 go_gapic_library(
     name = "vision_go_gapic",
-    src = ":vision_proto_with_info",
-    gapic_yaml = "vision_gapic.yaml",
-    importpath = "cloud.google.com/go/vision/apiv1p3beta1",
+    srcs = [":vision_proto_with_info"],
+    grpc_service_config = "vision_grpc_service_config.json",
+    importpath = "cloud.google.com/go/vision/apiv1p3beta1;vision",
     service_yaml = "//google/cloud/vision:vision_v1p3beta1.yaml",
     deps = [
         ":vision_go_proto",
         "//google/longrunning:longrunning_go_gapic",
         "//google/longrunning:longrunning_go_proto",
         "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
     ],
 )
 
@@ -151,13 +146,239 @@ go_test(
     importpath = "cloud.google.com/go/vision/apiv1p3beta1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-vision-v1p3beta1-go",
     deps = [
         ":vision_go_gapic",
-        ":vision_go_gapic_srcjar-smoke-test.srcjar",
         ":vision_go_gapic_srcjar-test.srcjar",
         ":vision_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "vision_moved_proto",
+    srcs = [":vision_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/longrunning:operations_proto",
+        "//google/rpc:status_proto",
+        "//google/type:color_proto",
+        "//google/type:latlng_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "vision_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":vision_moved_proto"],
+)
+
+py_grpc_library(
+    name = "vision_py_grpc",
+    srcs = [":vision_moved_proto"],
+    deps = [":vision_py_proto"],
+)
+
+py_gapic_library(
+    name = "vision_py_gapic",
+    src = ":vision_proto_with_info",
+    gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1p3beta1",
+    service_yaml = "//google/cloud/vision:vision_v1p3beta1.yaml",
+    deps = [
+        ":vision_py_grpc",
+        ":vision_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "vision-v1p3beta1-py",
+    deps = [
+        ":vision_py_gapic",
+        ":vision_py_grpc",
+        ":vision_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "vision_php_proto",
+    deps = [":vision_proto"],
+)
+
+php_grpc_library(
+    name = "vision_php_grpc",
+    srcs = [":vision_proto"],
+    deps = [":vision_php_proto"],
+)
+
+php_gapic_library(
+    name = "vision_php_gapic",
+    src = ":vision_proto_with_info",
+    gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1p3beta1",
+    service_yaml = "//google/cloud/vision:vision_v1p3beta1.yaml",
+    deps = [
+        ":vision_php_grpc",
+        ":vision_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-vision-v1p3beta1-php",
+    deps = [
+        ":vision_php_gapic",
+        ":vision_php_grpc",
+        ":vision_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "vision_nodejs_gapic",
+    src = ":vision_proto_with_info",
+    gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1p3beta1",
+    service_yaml = "//google/cloud/vision:vision_v1p3beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "vision-v1p3beta1-nodejs",
+    deps = [
+        ":vision_nodejs_gapic",
+        ":vision_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "vision_ruby_proto",
+    deps = [":vision_proto"],
+)
+
+ruby_grpc_library(
+    name = "vision_ruby_grpc",
+    srcs = [":vision_proto"],
+    deps = [":vision_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "vision_ruby_gapic",
+    src = ":vision_proto_with_info",
+    gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1p3beta1",
+    service_yaml = "//google/cloud/vision:vision_v1p3beta1.yaml",
+    deps = [
+        ":vision_ruby_grpc",
+        ":vision_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-vision-v1p3beta1-ruby",
+    deps = [
+        ":vision_ruby_gapic",
+        ":vision_ruby_grpc",
+        ":vision_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "vision_csharp_proto",
+    deps = [":vision_proto"],
+)
+
+csharp_grpc_library(
+    name = "vision_csharp_grpc",
+    srcs = [":vision_proto"],
+    deps = [":vision_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "vision_csharp_gapic",
+    src = ":vision_proto_with_info",
+    gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1p3beta1",
+    service_yaml = "//google/cloud/vision:vision_v1p3beta1.yaml",
+    deps = [
+        ":vision_csharp_grpc",
+        ":vision_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-vision-v1p3beta1-csharp",
+    deps = [
+        ":vision_csharp_gapic",
+        ":vision_csharp_grpc",
+        ":vision_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/vision/v1p3beta1/image_annotator.proto b/third_party/googleapis/google/cloud/vision/v1p3beta1/image_annotator.proto
index 2ac3ddb8b..b63aa2b25 100644
--- a/third_party/googleapis/google/cloud/vision/v1p3beta1/image_annotator.proto
+++ b/third_party/googleapis/google/cloud/vision/v1p3beta1/image_annotator.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,12 +11,15 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.vision.v1p3beta1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/cloud/vision/v1p3beta1/geometry.proto";
 import "google/cloud/vision/v1p3beta1/product_search.proto";
 import "google/cloud/vision/v1p3beta1/text_annotation.proto";
@@ -37,13 +40,18 @@ option java_package = "com.google.cloud.vision.v1p3beta1";
 // images, such as face, landmark, logo, label, and text detection. The
 // ImageAnnotator service returns detected entities from the images.
 service ImageAnnotator {
+  option (google.api.default_host) = "vision.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/cloud-vision";
+
   // Run image detection and annotation for a batch of images.
-  rpc BatchAnnotateImages(BatchAnnotateImagesRequest)
-      returns (BatchAnnotateImagesResponse) {
+  rpc BatchAnnotateImages(BatchAnnotateImagesRequest) returns (BatchAnnotateImagesResponse) {
     option (google.api.http) = {
       post: "/v1p3beta1/images:annotate"
       body: "*"
     };
+    option (google.api.method_signature) = "requests";
   }
 
   // Run asynchronous image detection and annotation for a list of generic
@@ -58,6 +66,11 @@ service ImageAnnotator {
       post: "/v1p3beta1/files:asyncBatchAnnotate"
       body: "*"
     };
+    option (google.api.method_signature) = "requests";
+    option (google.longrunning.operation_info) = {
+      response_type: "AsyncBatchAnnotateFilesResponse"
+      metadata_type: "OperationMetadata"
+    };
   }
 }
 
@@ -548,7 +561,7 @@ message ImageContext {
   // setting a hint will help get better results (although it will be a
   // significant hindrance if the hint is wrong). Text detection returns an
   // error if one or more of the specified languages is not one of the
-  // [supported languages](/vision/docs/languages).
+  // [supported languages](https://cloud.google.com/vision/docs/languages).
   repeated string language_hints = 2;
 
   // Parameters for crop hints annotation request.
@@ -684,8 +697,8 @@ message AsyncAnnotateFileResponse {
 // Multiple async file annotation requests are batched into a single service
 // call.
 message AsyncBatchAnnotateFilesRequest {
-  // Individual async file annotation requests for this batch.
-  repeated AsyncAnnotateFileRequest requests = 1;
+  // Required. Individual async file annotation requests for this batch.
+  repeated AsyncAnnotateFileRequest requests = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response to an async batch file annotation request.
diff --git a/third_party/googleapis/google/cloud/vision/v1p3beta1/product_search.proto b/third_party/googleapis/google/cloud/vision/v1p3beta1/product_search.proto
index 6a30c0875..6dde477c3 100644
--- a/third_party/googleapis/google/cloud/vision/v1p3beta1/product_search.proto
+++ b/third_party/googleapis/google/cloud/vision/v1p3beta1/product_search.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,12 +11,14 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.vision.v1p3beta1;
 
 import "google/api/annotations.proto";
+import "google/api/resource.proto";
 import "google/cloud/vision/v1p3beta1/geometry.proto";
 import "google/cloud/vision/v1p3beta1/product_search_service.proto";
 import "google/protobuf/timestamp.proto";
@@ -64,7 +66,9 @@ message ProductSearchParams {
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
-  string product_set = 6;
+  string product_set = 6 [(google.api.resource_reference) = {
+                            type: "vision.googleapis.com/ProductSet"
+                          }];
 
   // The list of product categories to search in. Currently, we only consider
   // the first category, and either "homegoods" or "apparel" should be
diff --git a/third_party/googleapis/google/cloud/vision/v1p3beta1/product_search_service.proto b/third_party/googleapis/google/cloud/vision/v1p3beta1/product_search_service.proto
index 23919ee7e..daf1d0ddc 100644
--- a/third_party/googleapis/google/cloud/vision/v1p3beta1/product_search_service.proto
+++ b/third_party/googleapis/google/cloud/vision/v1p3beta1/product_search_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,12 +11,16 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.vision.v1p3beta1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/vision/v1p3beta1/geometry.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/empty.proto";
@@ -33,22 +37,23 @@ option java_package = "com.google.cloud.vision.v1p3beta1";
 // Manages Products and ProductSets of reference images for use in product
 // search. It uses the following resource model:
 //
-// - The API has a collection of
-// [ProductSet][google.cloud.vision.v1p3beta1.ProductSet] resources, named
+// - The API has a collection of [ProductSet][google.cloud.vision.v1p3beta1.ProductSet] resources, named
 // `projects/*/locations/*/productSets/*`, which acts as a way to put different
 // products into groups to limit identification.
 //
 // In parallel,
 //
-// - The API has a collection of
-// [Product][google.cloud.vision.v1p3beta1.Product] resources, named
+// - The API has a collection of [Product][google.cloud.vision.v1p3beta1.Product] resources, named
 //   `projects/*/locations/*/products/*`
 //
-// - Each [Product][google.cloud.vision.v1p3beta1.Product] has a collection of
-// [ReferenceImage][google.cloud.vision.v1p3beta1.ReferenceImage] resources,
-// named
+// - Each [Product][google.cloud.vision.v1p3beta1.Product] has a collection of [ReferenceImage][google.cloud.vision.v1p3beta1.ReferenceImage] resources, named
 //   `projects/*/locations/*/products/*/referenceImages/*`
 service ProductSearch {
+  option (google.api.default_host) = "vision.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/cloud-vision";
+
   // Creates and returns a new ProductSet resource.
   //
   // Possible errors:
@@ -60,6 +65,7 @@ service ProductSearch {
       post: "/v1p3beta1/{parent=projects/*/locations/*}/productSets"
       body: "product_set"
     };
+    option (google.api.method_signature) = "parent,product_set,product_set_id";
   }
 
   // Lists ProductSets in an unspecified order.
@@ -68,11 +74,11 @@ service ProductSearch {
   //
   // * Returns INVALID_ARGUMENT if page_size is greater than 100, or less
   //   than 1.
-  rpc ListProductSets(ListProductSetsRequest)
-      returns (ListProductSetsResponse) {
+  rpc ListProductSets(ListProductSetsRequest) returns (ListProductSetsResponse) {
     option (google.api.http) = {
       get: "/v1p3beta1/{parent=projects/*/locations/*}/productSets"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets information associated with a ProductSet.
@@ -84,6 +90,7 @@ service ProductSearch {
     option (google.api.http) = {
       get: "/v1p3beta1/{name=projects/*/locations/*/productSets/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Makes changes to a ProductSet resource.
@@ -99,6 +106,7 @@ service ProductSearch {
       patch: "/v1p3beta1/{product_set.name=projects/*/locations/*/productSets/*}"
       body: "product_set"
     };
+    option (google.api.method_signature) = "product_set,update_mask";
   }
 
   // Permanently deletes a ProductSet. All Products and ReferenceImages in the
@@ -114,6 +122,7 @@ service ProductSearch {
     option (google.api.http) = {
       delete: "/v1p3beta1/{name=projects/*/locations/*/productSets/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates and returns a new product resource.
@@ -129,6 +138,7 @@ service ProductSearch {
       post: "/v1p3beta1/{parent=projects/*/locations/*}/products"
       body: "product"
     };
+    option (google.api.method_signature) = "parent,product,product_id";
   }
 
   // Lists products in an unspecified order.
@@ -140,6 +150,7 @@ service ProductSearch {
     option (google.api.http) = {
       get: "/v1p3beta1/{parent=projects/*/locations/*}/products"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets information associated with a Product.
@@ -151,6 +162,7 @@ service ProductSearch {
     option (google.api.http) = {
       get: "/v1p3beta1/{name=projects/*/locations/*/products/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Makes changes to a Product resource.
@@ -172,6 +184,7 @@ service ProductSearch {
       patch: "/v1p3beta1/{product.name=projects/*/locations/*/products/*}"
       body: "product"
     };
+    option (google.api.method_signature) = "product,update_mask";
   }
 
   // Permanently deletes a product and its reference images.
@@ -187,6 +200,7 @@ service ProductSearch {
     option (google.api.http) = {
       delete: "/v1p3beta1/{name=projects/*/locations/*/products/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates and returns a new ReferenceImage resource.
@@ -214,6 +228,7 @@ service ProductSearch {
       post: "/v1p3beta1/{parent=projects/*/locations/*/products/*}/referenceImages"
       body: "reference_image"
     };
+    option (google.api.method_signature) = "parent,reference_image,reference_image_id";
   }
 
   // Permanently deletes a reference image.
@@ -232,6 +247,7 @@ service ProductSearch {
     option (google.api.http) = {
       delete: "/v1p3beta1/{name=projects/*/locations/*/products/*/referenceImages/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists reference images.
@@ -246,6 +262,7 @@ service ProductSearch {
     option (google.api.http) = {
       get: "/v1p3beta1/{parent=projects/*/locations/*/products/*}/referenceImages"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets information associated with a ReferenceImage.
@@ -257,6 +274,7 @@ service ProductSearch {
     option (google.api.http) = {
       get: "/v1p3beta1/{name=projects/*/locations/*/products/*/referenceImages/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Adds a Product to the specified ProductSet. If the Product is already
@@ -273,6 +291,7 @@ service ProductSearch {
       post: "/v1p3beta1/{name=projects/*/locations/*/productSets/*}:addProduct"
       body: "*"
     };
+    option (google.api.method_signature) = "name,product";
   }
 
   // Removes a Product from the specified ProductSet.
@@ -286,6 +305,7 @@ service ProductSearch {
       post: "/v1p3beta1/{name=projects/*/locations/*/productSets/*}:removeProduct"
       body: "*"
     };
+    option (google.api.method_signature) = "name,product";
   }
 
   // Lists the Products in a ProductSet, in an unspecified order. If the
@@ -300,6 +320,7 @@ service ProductSearch {
     option (google.api.http) = {
       get: "/v1p3beta1/{name=projects/*/locations/*/productSets/*}/products"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Asynchronous API that imports a list of reference images to specified
@@ -319,11 +340,21 @@ service ProductSearch {
       post: "/v1p3beta1/{parent=projects/*/locations/*}/productSets:import"
       body: "*"
     };
+    option (google.api.method_signature) = "parent,input_config";
+    option (google.longrunning.operation_info) = {
+      response_type: "ImportProductSetsResponse"
+      metadata_type: "BatchOperationMetadata"
+    };
   }
 }
 
 // A Product contains ReferenceImages.
 message Product {
+  option (google.api.resource) = {
+    type: "vision.googleapis.com/Product"
+    pattern: "projects/{project}/locations/{location}/products/{product}"
+  };
+
   // A product label represented as a key-value pair.
   message KeyValue {
     // The key of the label attached to the product. Cannot be empty and cannot
@@ -351,11 +382,11 @@ message Product {
   // characters long.
   string description = 3;
 
-  // The category for the product identified by the reference image. This should
-  // be either "homegoods" or "apparel".
-  //
-  // This field is immutable.
-  string product_category = 4;
+  // Immutable. The category for the product identified by the reference image. This should
+  // be either "homegoods-v2", "apparel-v2", or "toys-v2". The legacy categories
+  // "homegoods", "apparel", and "toys" are still supported, but these should
+  // not be used for new products.
+  string product_category = 4 [(google.api.field_behavior) = IMMUTABLE];
 
   // Key-value pairs that can be attached to a product. At query time,
   // constraints can be specified based on the product_labels.
@@ -373,6 +404,11 @@ message Product {
 // million reference images. If the limit is exceeded, periodic indexing will
 // fail.
 message ProductSet {
+  option (google.api.resource) = {
+    type: "vision.googleapis.com/ProductSet"
+    pattern: "projects/{project}/locations/{location}/productSets/{product_set}"
+  };
+
   // The resource name of the ProductSet.
   //
   // Format is:
@@ -390,18 +426,23 @@ message ProductSet {
   // never been indexed, this field is 0.
   //
   // This field is ignored when creating a ProductSet.
-  google.protobuf.Timestamp index_time = 3;
+  google.protobuf.Timestamp index_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. If there was an error with indexing the product set, the field
   // is populated.
   //
   // This field is ignored when creating a ProductSet.
-  google.rpc.Status index_error = 4;
+  google.rpc.Status index_error = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // A `ReferenceImage` represents a product image and its associated metadata,
 // such as bounding boxes.
 message ReferenceImage {
+  option (google.api.resource) = {
+    type: "vision.googleapis.com/ReferenceImage"
+    pattern: "projects/{project}/locations/{location}/products/{product}/referenceImages/{reference_image}"
+  };
+
   // The resource name of the reference image.
   //
   // Format is:
@@ -411,34 +452,37 @@ message ReferenceImage {
   // This field is ignored when creating a reference image.
   string name = 1;
 
-  // The Google Cloud Storage URI of the reference image.
+  // Required. The Google Cloud Storage URI of the reference image.
   //
   // The URI must start with `gs://`.
-  //
-  // Required.
-  string uri = 2;
+  string uri = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Bounding polygons around the areas of interest in the reference image.
-  // Optional. If this field is empty, the system will try to detect regions of
+  // Optional. Bounding polygons around the areas of interest in the reference image.
+  // If this field is empty, the system will try to detect regions of
   // interest. At most 10 bounding polygons will be used.
   //
   // The provided shape is converted into a non-rotated rectangle. Once
   // converted, the small edge of the rectangle must be greater than or equal
   // to 300 pixels. The aspect ratio must be 1:4 or less (i.e. 1:3 is ok; 1:5
   // is not).
-  repeated BoundingPoly bounding_polys = 3;
+  repeated BoundingPoly bounding_polys = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request message for the `CreateProduct` method.
 message CreateProductRequest {
-  // The project in which the Product should be created.
+  // Required. The project in which the Product should be created.
   //
   // Format is
   // `projects/PROJECT_ID/locations/LOC_ID`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
-  // The product to create.
-  Product product = 2;
+  // Required. The product to create.
+  Product product = 2 [(google.api.field_behavior) = REQUIRED];
 
   // A user-supplied resource id for this Product. If set, the server will
   // attempt to use this value as the resource id. If it is already in use, an
@@ -449,11 +493,16 @@ message CreateProductRequest {
 
 // Request message for the `ListProducts` method.
 message ListProductsRequest {
-  // The project OR ProductSet from which Products should be listed.
+  // Required. The project OR ProductSet from which Products should be listed.
   //
   // Format:
   // `projects/PROJECT_ID/locations/LOC_ID`
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
   // The maximum number of items to return. Default 10, maximum 100.
   int32 page_size = 2;
@@ -474,45 +523,60 @@ message ListProductsResponse {
 
 // Request message for the `GetProduct` method.
 message GetProductRequest {
-  // Resource name of the Product to get.
+  // Required. Resource name of the Product to get.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/Product"
+    }
+  ];
 }
 
 // Request message for the `UpdateProduct` method.
 message UpdateProductRequest {
-  // The Product resource which replaces the one on the server.
+  // Required. The Product resource which replaces the one on the server.
   // product.name is immutable.
-  Product product = 1;
+  Product product = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The [FieldMask][google.protobuf.FieldMask] that specifies which fields
   // to update.
   // If update_mask isn't specified, all mutable fields are to be updated.
-  // Valid mask paths include `product_labels`, `display_name` and
+  // Valid mask paths include `product_labels`, `display_name`, and
   // `description`.
   google.protobuf.FieldMask update_mask = 2;
 }
 
 // Request message for the `DeleteProduct` method.
 message DeleteProductRequest {
-  // Resource name of product to delete.
+  // Required. Resource name of product to delete.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/Product"
+    }
+  ];
 }
 
 // Request message for the `CreateProductSet` method.
 message CreateProductSetRequest {
-  // The project in which the ProductSet should be created.
+  // Required. The project in which the ProductSet should be created.
   //
   // Format is `projects/PROJECT_ID/locations/LOC_ID`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
-  // The ProductSet to create.
-  ProductSet product_set = 2;
+  // Required. The ProductSet to create.
+  ProductSet product_set = 2 [(google.api.field_behavior) = REQUIRED];
 
   // A user-supplied resource id for this ProductSet. If set, the server will
   // attempt to use this value as the resource id. If it is already in use, an
@@ -523,10 +587,15 @@ message CreateProductSetRequest {
 
 // Request message for the `ListProductSets` method.
 message ListProductSetsRequest {
-  // The project from which ProductSets should be listed.
+  // Required. The project from which ProductSets should be listed.
   //
   // Format is `projects/PROJECT_ID/locations/LOC_ID`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
   // The maximum number of items to return. Default 10, maximum 100.
   int32 page_size = 2;
@@ -547,17 +616,22 @@ message ListProductSetsResponse {
 
 // Request message for the `GetProductSet` method.
 message GetProductSetRequest {
-  // Resource name of the ProductSet to get.
+  // Required. Resource name of the ProductSet to get.
   //
   // Format is:
-  // `projects/PROJECT_ID/locations/LOG_ID/productSets/PRODUCT_SET_ID`
-  string name = 1;
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/ProductSet"
+    }
+  ];
 }
 
 // Request message for the `UpdateProductSet` method.
 message UpdateProductSetRequest {
-  // The ProductSet resource which replaces the one on the server.
-  ProductSet product_set = 1;
+  // Required. The ProductSet resource which replaces the one on the server.
+  ProductSet product_set = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The [FieldMask][google.protobuf.FieldMask] that specifies which fields to
   // update.
@@ -568,24 +642,34 @@ message UpdateProductSetRequest {
 
 // Request message for the `DeleteProductSet` method.
 message DeleteProductSetRequest {
-  // Resource name of the ProductSet to delete.
+  // Required. Resource name of the ProductSet to delete.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/ProductSet"
+    }
+  ];
 }
 
 // Request message for the `CreateReferenceImage` method.
 message CreateReferenceImageRequest {
-  // Resource name of the product in which to create the reference image.
+  // Required. Resource name of the product in which to create the reference image.
   //
   // Format is
   // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
-  string parent = 1;
-
-  // The reference image to create.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/Product"
+    }
+  ];
+
+  // Required. The reference image to create.
   // If an image ID is specified, it is ignored.
-  ReferenceImage reference_image = 2;
+  ReferenceImage reference_image = 2 [(google.api.field_behavior) = REQUIRED];
 
   // A user-supplied resource id for the ReferenceImage to be added. If set,
   // the server will attempt to use this value as the resource id. If it is
@@ -596,11 +680,16 @@ message CreateReferenceImageRequest {
 
 // Request message for the `ListReferenceImages` method.
 message ListReferenceImagesRequest {
-  // Resource name of the product containing the reference images.
+  // Required. Resource name of the product containing the reference images.
   //
   // Format is
   // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/Product"
+    }
+  ];
 
   // The maximum number of items to return. Default 10, maximum 100.
   int32 page_size = 2;
@@ -626,61 +715,96 @@ message ListReferenceImagesResponse {
 
 // Request message for the `GetReferenceImage` method.
 message GetReferenceImageRequest {
-  // The resource name of the ReferenceImage to get.
+  // Required. The resource name of the ReferenceImage to get.
   //
   // Format is:
   //
   // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/ReferenceImage"
+    }
+  ];
 }
 
 // Request message for the `DeleteReferenceImage` method.
 message DeleteReferenceImageRequest {
-  // The resource name of the reference image to delete.
+  // Required. The resource name of the reference image to delete.
   //
   // Format is:
   //
   // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/ReferenceImage"
+    }
+  ];
 }
 
 // Request message for the `AddProductToProductSet` method.
 message AddProductToProductSetRequest {
-  // The resource name for the ProductSet to modify.
+  // Required. The resource name for the ProductSet to modify.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/ProductSet"
+    }
+  ];
 
-  // The resource name for the Product to be added to this ProductSet.
+  // Required. The resource name for the Product to be added to this ProductSet.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
-  string product = 2;
+  string product = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/Product"
+    }
+  ];
 }
 
 // Request message for the `RemoveProductFromProductSet` method.
 message RemoveProductFromProductSetRequest {
-  // The resource name for the ProductSet to modify.
+  // Required. The resource name for the ProductSet to modify.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/ProductSet"
+    }
+  ];
 
-  // The resource name for the Product to be removed from this ProductSet.
+  // Required. The resource name for the Product to be removed from this ProductSet.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
-  string product = 2;
+  string product = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/Product"
+    }
+  ];
 }
 
 // Request message for the `ListProductsInProductSet` method.
 message ListProductsInProductSetRequest {
-  // The ProductSet resource for which to retrieve Products.
+  // Required. The ProductSet resource for which to retrieve Products.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/ProductSet"
+    }
+  ];
 
   // The maximum number of items to return. Default 10, maximum 100.
   int32 page_size = 2;
@@ -704,7 +828,7 @@ message ListProductsInProductSetResponse {
 message ImportProductSetsGcsSource {
   // The Google Cloud Storage URI of the input csv file.
   //
-  // The URI must start with gs://
+  // The URI must start with `gs://`.
   //
   // The format of the input csv file should be one image per line.
   // In each line, there are 6 columns.
@@ -774,13 +898,18 @@ message ImportProductSetsInputConfig {
 
 // Request message for the `ImportProductSets` method.
 message ImportProductSetsRequest {
-  // The project in which the ProductSets should be imported.
+  // Required. The project in which the ProductSets should be imported.
   //
   // Format is `projects/PROJECT_ID/locations/LOC_ID`.
-  string parent = 1;
-
-  // The input content for the list of requests.
-  ImportProductSetsInputConfig input_config = 2;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // Required. The input content for the list of requests.
+  ImportProductSetsInputConfig input_config = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response message for the `ImportProductSets` method.
diff --git a/third_party/googleapis/google/cloud/vision/v1p3beta1/vision_gapic.legacy.yaml b/third_party/googleapis/google/cloud/vision/v1p3beta1/vision_gapic.legacy.yaml
new file mode 100644
index 000000000..4a95b19ea
--- /dev/null
+++ b/third_party/googleapis/google/cloud/vision/v1p3beta1/vision_gapic.legacy.yaml
@@ -0,0 +1,444 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.vision.v1p3beta1
+  python:
+    package_name: google.cloud.vision_v1p3beta1.gapic
+  go:
+    package_name: cloud.google.com/go/vision/apiv1p3beta1
+    domain_layer_location: cloud.google.com/go/vision
+  csharp:
+    package_name: Google.Cloud.Vision.V1p3beta1
+  ruby:
+    package_name: Google::Cloud::Vision::V1p3beta1
+  php:
+    package_name: Google\Cloud\Vision\V1p3beta1
+  nodejs:
+    package_name: vision.v1p3beta1
+    domain_layer_location: google-cloud
+interfaces:
+- name: google.cloud.vision.v1p3beta1.ProductSearch
+  collections:
+  - name_pattern: projects/{project}/locations/{location}
+    entity_name: location
+  - name_pattern: projects/{project}/locations/{location}/productSets/{product_set}
+    entity_name: product_set
+  - name_pattern: projects/{project}/locations/{location}/products/{product}
+    entity_name: product
+  - name_pattern: projects/{project}/locations/{location}/products/{product}/referenceImages/{reference_image}
+    entity_name: reference_image
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  methods:
+  - name: CreateProductSet
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - product_set
+        - product_set_id
+    required_fields:
+    - parent
+    - product_set
+    - product_set_id
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 60000
+  - name: ListProductSets
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: product_sets
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 60000
+  - name: GetProductSet
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: product_set
+    timeout_millis: 60000
+  - name: UpdateProductSet
+    flattening:
+      groups:
+      - parameters:
+        - product_set
+        - update_mask
+    required_fields:
+    - product_set
+    - update_mask
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      product_set.name: product_set
+    timeout_millis: 60000
+  - name: DeleteProductSet
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: product_set
+    timeout_millis: 60000
+  - name: CreateProduct
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - product
+        - product_id
+    required_fields:
+    - parent
+    - product
+    - product_id
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 60000
+  - name: ListProducts
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: products
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 60000
+  - name: GetProduct
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: product
+    timeout_millis: 60000
+  - name: UpdateProduct
+    flattening:
+      groups:
+      - parameters:
+        - product
+        - update_mask
+    required_fields:
+    - product
+    - update_mask
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      product.name: product
+    timeout_millis: 60000
+  - name: DeleteProduct
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: product
+    timeout_millis: 60000
+  - name: CreateReferenceImage
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - reference_image
+        - reference_image_id
+    required_fields:
+    - parent
+    - reference_image
+    - reference_image_id
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: product
+    timeout_millis: 60000
+  - name: DeleteReferenceImage
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: reference_image
+    timeout_millis: 60000
+  - name: ListReferenceImages
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: reference_images
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: product
+    timeout_millis: 60000
+  - name: GetReferenceImage
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: reference_image
+    timeout_millis: 60000
+  - name: AddProductToProductSet
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - product
+    required_fields:
+    - name
+    - product
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: product_set
+    timeout_millis: 60000
+  - name: RemoveProductFromProductSet
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - product
+    required_fields:
+    - name
+    - product
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: product_set
+    timeout_millis: 60000
+  - name: ListProductsInProductSet
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: products
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: product_set
+    timeout_millis: 60000
+  - name: ImportProductSets
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - input_config
+    required_fields:
+    - parent
+    - input_config
+    long_running:
+      return_type: google.cloud.vision.v1p3beta1.ImportProductSetsResponse
+      metadata_type: google.cloud.vision.v1p3beta1.BatchOperationMetadata
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 60000
+- name: google.cloud.vision.v1p3beta1.ImageAnnotator
+  smoke_test:
+    method: BatchAnnotateImages
+    init_fields:
+    - requests[0].image.source.gcs_image_uri="gs://cloud-samples-data/vision/face_detection/celebrity_recognition/sergey.jpg"
+    - requests[0].features[0].type=FACE_DETECTION
+  collections: []
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 60000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 60000
+    total_timeout_millis: 600000
+  methods:
+  - name: BatchAnnotateImages
+    flattening:
+      groups:
+      - parameters:
+        - requests
+    required_fields:
+    - requests
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: AsyncBatchAnnotateFiles
+    flattening:
+      groups:
+      - parameters:
+        - requests
+    required_fields:
+    - requests
+    long_running:
+      return_type: google.cloud.vision.v1p3beta1.AsyncBatchAnnotateFilesResponse
+      metadata_type: google.cloud.vision.v1p3beta1.OperationMetadata
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+resource_name_generation:
+- message_name: CreateProductSetRequest
+  field_entity_map:
+    parent: location
+- message_name: ListProductSetsRequest
+  field_entity_map:
+    parent: location
+- message_name: GetProductSetRequest
+  field_entity_map:
+    name: product_set
+- message_name: UpdateProductSetRequest
+  field_entity_map:
+    product_set.name: product_set
+- message_name: DeleteProductSetRequest
+  field_entity_map:
+    name: product_set
+- message_name: CreateProductRequest
+  field_entity_map:
+    parent: location
+- message_name: ListProductsRequest
+  field_entity_map:
+    parent: location
+- message_name: GetProductRequest
+  field_entity_map:
+    name: product
+- message_name: UpdateProductRequest
+  field_entity_map:
+    product.name: product
+- message_name: DeleteProductRequest
+  field_entity_map:
+    name: product
+- message_name: CreateReferenceImageRequest
+  field_entity_map:
+    parent: product
+- message_name: DeleteReferenceImageRequest
+  field_entity_map:
+    name: reference_image
+- message_name: ListReferenceImagesRequest
+  field_entity_map:
+    parent: product
+- message_name: GetReferenceImageRequest
+  field_entity_map:
+    name: reference_image
+- message_name: AddProductToProductSetRequest
+  field_entity_map:
+    name: product_set
+- message_name: RemoveProductFromProductSetRequest
+  field_entity_map:
+    name: product_set
+- message_name: ListProductsInProductSetRequest
+  field_entity_map:
+    name: product_set
+- message_name: ImportProductSetsRequest
+  field_entity_map:
+    parent: location
diff --git a/third_party/googleapis/google/cloud/vision/v1p3beta1/vision_gapic.yaml b/third_party/googleapis/google/cloud/vision/v1p3beta1/vision_gapic.yaml
index 59c695328..882698028 100644
--- a/third_party/googleapis/google/cloud/vision/v1p3beta1/vision_gapic.yaml
+++ b/third_party/googleapis/google/cloud/vision/v1p3beta1/vision_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.vision.v1p3beta1
@@ -19,22 +19,6 @@ language_settings:
     domain_layer_location: google-cloud
 interfaces:
 - name: google.cloud.vision.v1p3beta1.ProductSearch
-  collections:
-  - name_pattern: projects/{project}/locations/{location}
-    entity_name: location
-  - name_pattern: projects/{project}/locations/{location}/productSets/{product_set}
-    entity_name: product_set
-  - name_pattern: projects/{project}/locations/{location}/products/{product}
-    entity_name: product
-  - name_pattern: projects/{project}/locations/{location}/products/{product}/referenceImages/{reference_image}
-    entity_name: reference_image
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 100
@@ -45,311 +29,25 @@ interfaces:
     max_rpc_timeout_millis: 20000
     total_timeout_millis: 600000
   methods:
-  - name: CreateProductSet
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - product_set
-        - product_set_id
-    required_fields:
-    - parent
-    - product_set
-    - product_set_id
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    timeout_millis: 60000
-  - name: ListProductSets
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: product_sets
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    timeout_millis: 60000
-  - name: GetProductSet
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: product_set
-    timeout_millis: 60000
-  - name: UpdateProductSet
-    flattening:
-      groups:
-      - parameters:
-        - product_set
-        - update_mask
-    required_fields:
-    - product_set
-    - update_mask
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      product_set.name: product_set
-    timeout_millis: 60000
   - name: DeleteProductSet
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: product_set
-    timeout_millis: 60000
-  - name: CreateProduct
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - product
-        - product_id
-    required_fields:
-    - parent
-    - product
-    - product_id
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    timeout_millis: 60000
-  - name: ListProducts
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: products
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    timeout_millis: 60000
-  - name: GetProduct
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: product
-    timeout_millis: 60000
-  - name: UpdateProduct
-    flattening:
-      groups:
-      - parameters:
-        - product
-        - update_mask
-    required_fields:
-    - product
-    - update_mask
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      product.name: product
-    timeout_millis: 60000
   - name: DeleteProduct
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: product
-    timeout_millis: 60000
-  - name: CreateReferenceImage
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - reference_image
-        - reference_image_id
-    required_fields:
-    - parent
-    - reference_image
-    - reference_image_id
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: product
-    timeout_millis: 60000
   - name: DeleteReferenceImage
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: reference_image
-    timeout_millis: 60000
-  - name: ListReferenceImages
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: reference_images
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: product
-    timeout_millis: 60000
-  - name: GetReferenceImage
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: reference_image
-    timeout_millis: 60000
-  - name: AddProductToProductSet
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - product
-    required_fields:
-    - name
-    - product
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: product_set
-    timeout_millis: 60000
-  - name: RemoveProductFromProductSet
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - product
-    required_fields:
-    - name
-    - product
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: product_set
-    timeout_millis: 60000
-  - name: ListProductsInProductSet
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: products
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: product_set
-    timeout_millis: 60000
   - name: ImportProductSets
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - input_config
-    required_fields:
-    - parent
-    - input_config
     long_running:
-      return_type: google.cloud.vision.v1p3beta1.ImportProductSetsResponse
-      metadata_type: google.cloud.vision.v1p3beta1.BatchOperationMetadata
       initial_poll_delay_millis: 20000
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 45000
       total_poll_timeout_millis: 86400000
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    timeout_millis: 60000
+
 - name: google.cloud.vision.v1p3beta1.ImageAnnotator
   smoke_test:
     method: BatchAnnotateImages
     init_fields:
-    - requests[0].image.source.gcs_image_uri="gs://gapic-toolkit/President_Barack_Obama.jpg"
+    - requests[0].image.source.gcs_image_uri="gs://cloud-samples-data/vision/face_detection/celebrity_recognition/sergey.jpg"
     - requests[0].features[0].type=FACE_DETECTION
-  collections: []
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 100
@@ -361,84 +59,10 @@ interfaces:
     total_timeout_millis: 600000
   methods:
   - name: BatchAnnotateImages
-    flattening:
-      groups:
-      - parameters:
-        - requests
-    required_fields:
-    - requests
     retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 60000
   - name: AsyncBatchAnnotateFiles
-    flattening:
-      groups:
-      - parameters:
-        - requests
-    required_fields:
-    - requests
     long_running:
-      return_type: google.cloud.vision.v1p3beta1.AsyncBatchAnnotateFilesResponse
-      metadata_type: google.cloud.vision.v1p3beta1.OperationMetadata
       initial_poll_delay_millis: 20000
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 45000
       total_poll_timeout_millis: 86400000
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-resource_name_generation:
-- message_name: CreateProductSetRequest
-  field_entity_map:
-    parent: location
-- message_name: ListProductSetsRequest
-  field_entity_map:
-    parent: location
-- message_name: GetProductSetRequest
-  field_entity_map:
-    name: product_set
-- message_name: UpdateProductSetRequest
-  field_entity_map:
-    product_set.name: product_set
-- message_name: DeleteProductSetRequest
-  field_entity_map:
-    name: product_set
-- message_name: CreateProductRequest
-  field_entity_map:
-    parent: location
-- message_name: ListProductsRequest
-  field_entity_map:
-    parent: location
-- message_name: GetProductRequest
-  field_entity_map:
-    name: product
-- message_name: UpdateProductRequest
-  field_entity_map:
-    product.name: product
-- message_name: DeleteProductRequest
-  field_entity_map:
-    name: product
-- message_name: CreateReferenceImageRequest
-  field_entity_map:
-    parent: product
-- message_name: DeleteReferenceImageRequest
-  field_entity_map:
-    name: reference_image
-- message_name: ListReferenceImagesRequest
-  field_entity_map:
-    parent: product
-- message_name: GetReferenceImageRequest
-  field_entity_map:
-    name: reference_image
-- message_name: AddProductToProductSetRequest
-  field_entity_map:
-    name: product_set
-- message_name: RemoveProductFromProductSetRequest
-  field_entity_map:
-    name: product_set
-- message_name: ListProductsInProductSetRequest
-  field_entity_map:
-    name: product_set
-- message_name: ImportProductSetsRequest
-  field_entity_map:
-    parent: location
diff --git a/third_party/googleapis/google/cloud/vision/v1p3beta1/vision_grpc_service_config.json b/third_party/googleapis/google/cloud/vision/v1p3beta1/vision_grpc_service_config.json
new file mode 100755
index 000000000..f1b79dc06
--- /dev/null
+++ b/third_party/googleapis/google/cloud/vision/v1p3beta1/vision_grpc_service_config.json
@@ -0,0 +1,136 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.vision.v1p3beta1.ImageAnnotator",
+          "method": "AsyncBatchAnnotateFiles"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.vision.v1p3beta1.ProductSearch",
+          "method": "CreateProductSet"
+        },
+        {
+          "service": "google.cloud.vision.v1p3beta1.ProductSearch",
+          "method": "UpdateProductSet"
+        },
+        {
+          "service": "google.cloud.vision.v1p3beta1.ProductSearch",
+          "method": "CreateProduct"
+        },
+        {
+          "service": "google.cloud.vision.v1p3beta1.ProductSearch",
+          "method": "UpdateProduct"
+        },
+        {
+          "service": "google.cloud.vision.v1p3beta1.ProductSearch",
+          "method": "CreateReferenceImage"
+        },
+        {
+          "service": "google.cloud.vision.v1p3beta1.ProductSearch",
+          "method": "AddProductToProductSet"
+        },
+        {
+          "service": "google.cloud.vision.v1p3beta1.ProductSearch",
+          "method": "RemoveProductFromProductSet"
+        },
+        {
+          "service": "google.cloud.vision.v1p3beta1.ProductSearch",
+          "method": "ImportProductSets"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.vision.v1p3beta1.ProductSearch",
+          "method": "ListProductSets"
+        },
+        {
+          "service": "google.cloud.vision.v1p3beta1.ProductSearch",
+          "method": "GetProductSet"
+        },
+        {
+          "service": "google.cloud.vision.v1p3beta1.ProductSearch",
+          "method": "DeleteProductSet"
+        },
+        {
+          "service": "google.cloud.vision.v1p3beta1.ProductSearch",
+          "method": "ListProducts"
+        },
+        {
+          "service": "google.cloud.vision.v1p3beta1.ProductSearch",
+          "method": "GetProduct"
+        },
+        {
+          "service": "google.cloud.vision.v1p3beta1.ProductSearch",
+          "method": "DeleteProduct"
+        },
+        {
+          "service": "google.cloud.vision.v1p3beta1.ProductSearch",
+          "method": "DeleteReferenceImage"
+        },
+        {
+          "service": "google.cloud.vision.v1p3beta1.ProductSearch",
+          "method": "ListReferenceImages"
+        },
+        {
+          "service": "google.cloud.vision.v1p3beta1.ProductSearch",
+          "method": "GetReferenceImage"
+        },
+        {
+          "service": "google.cloud.vision.v1p3beta1.ProductSearch",
+          "method": "ListProductsInProductSet"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.vision.v1p3beta1.ImageAnnotator",
+          "method": "BatchAnnotateImages"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/vision/v1p3beta1/vision_v1p3beta1.yaml b/third_party/googleapis/google/cloud/vision/v1p3beta1/vision_v1p3beta1.yaml
new file mode 100644
index 000000000..65c3b6577
--- /dev/null
+++ b/third_party/googleapis/google/cloud/vision/v1p3beta1/vision_v1p3beta1.yaml
@@ -0,0 +1,39 @@
+type: google.api.Service
+config_version: 3
+name: vision.googleapis.com
+title: Cloud Vision API
+
+apis:
+- name: google.cloud.vision.v1p3beta1.ImageAnnotator
+- name: google.cloud.vision.v1p3beta1.ProductSearch
+
+types:
+- name: google.cloud.vision.v1p3beta1.AnnotateFileResponse
+- name: google.cloud.vision.v1p3beta1.AsyncBatchAnnotateFilesResponse
+- name: google.cloud.vision.v1p3beta1.BatchOperationMetadata
+- name: google.cloud.vision.v1p3beta1.ImportProductSetsResponse
+- name: google.cloud.vision.v1p3beta1.OperationMetadata
+
+documentation:
+  summary: |-
+    Integrates Google Vision features, including image labeling, face, logo,
+    and landmark detection, optical character recognition (OCR), and detection
+    of explicit content, into applications.
+
+authentication:
+  rules:
+  - selector: 'google.cloud.vision.v1p3beta1.ImageAnnotator.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-vision
+  - selector: 'google.cloud.vision.v1p3beta1.ProductSearch.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-vision
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-vision
diff --git a/third_party/googleapis/google/cloud/vision/v1p4beta1/BUILD.bazel b/third_party/googleapis/google/cloud/vision/v1p4beta1/BUILD.bazel
index 1b263fa0f..b454a941f 100644
--- a/third_party/googleapis/google/cloud/vision/v1p4beta1/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/vision/v1p4beta1/BUILD.bazel
@@ -1,14 +1,18 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
     name = "vision_proto",
     srcs = [
+        "face.proto",
         "geometry.proto",
         "image_annotator.proto",
         "product_search.proto",
@@ -18,6 +22,9 @@ proto_library(
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
         "//google/longrunning:operations_proto",
         "//google/rpc:status_proto",
         "//google/type:color_proto",
@@ -30,7 +37,10 @@ proto_library(
 
 proto_library_with_info(
     name = "vision_proto_with_info",
-    deps = [":vision_proto"],
+    deps = [
+        ":vision_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -38,18 +48,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
     name = "vision_java_proto",
     deps = [":vision_proto"],
@@ -58,51 +63,41 @@ java_proto_library(
 java_grpc_library(
     name = "vision_java_grpc",
     srcs = [":vision_proto"],
-    deps = [":vision_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "vision_resource_name_java_proto",
-    gapic_yaml = "vision_gapic.yaml",
-    deps = [":vision_proto"],
+    deps = [":vision_java_proto"],
 )
 
 java_gapic_library(
     name = "vision_java_gapic",
     src = ":vision_proto_with_info",
     gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1p4beta1",
     service_yaml = "//google/cloud/vision:vision_v1p4beta1.yaml",
-    test_deps = [":vision_java_grpc"],
+    test_deps = [
+        ":vision_java_grpc",
+    ],
     deps = [
         ":vision_java_proto",
-        ":vision_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":vision_java_gapic_test",
+java_gapic_test(
+    name = "vision_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.vision.v1p4beta1.ImageAnnotatorClientTest",
+        "com.google.cloud.vision.v1p4beta1.ProductSearchClientTest",
     ],
-) for test_name in [
-    "com.google.cloud.vision.v1p4beta1.ImageAnnotatorClientTest",
-]]
+    runtime_deps = [":vision_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-vision-v1p4beta1-java",
-    client_deps = [":vision_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":vision_java_gapic_test"],
-    grpc_deps = [":vision_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":vision_java_gapic",
+        ":vision_java_grpc",
         ":vision_java_proto",
         ":vision_proto",
-        ":vision_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -110,10 +105,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -132,15 +127,16 @@ go_proto_library(
 
 go_gapic_library(
     name = "vision_go_gapic",
-    src = ":vision_proto_with_info",
-    gapic_yaml = "vision_gapic.yaml",
-    importpath = "cloud.google.com/go/vision/apiv1p4beta1",
+    srcs = [":vision_proto_with_info"],
+    grpc_service_config = "vision_grpc_service_config.json",
+    importpath = "cloud.google.com/go/vision/apiv1p4beta1;vision",
     service_yaml = "//google/cloud/vision:vision_v1p4beta1.yaml",
     deps = [
         ":vision_go_proto",
         "//google/longrunning:longrunning_go_gapic",
         "//google/longrunning:longrunning_go_proto",
         "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
     ],
 )
 
@@ -151,13 +147,239 @@ go_test(
     importpath = "cloud.google.com/go/vision/apiv1p4beta1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-vision-v1p4beta1-go",
     deps = [
         ":vision_go_gapic",
-        ":vision_go_gapic_srcjar-smoke-test.srcjar",
         ":vision_go_gapic_srcjar-test.srcjar",
         ":vision_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "vision_moved_proto",
+    srcs = [":vision_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/longrunning:operations_proto",
+        "//google/rpc:status_proto",
+        "//google/type:color_proto",
+        "//google/type:latlng_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "vision_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":vision_moved_proto"],
+)
+
+py_grpc_library(
+    name = "vision_py_grpc",
+    srcs = [":vision_moved_proto"],
+    deps = [":vision_py_proto"],
+)
+
+py_gapic_library(
+    name = "vision_py_gapic",
+    src = ":vision_proto_with_info",
+    gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1p4beta1",
+    service_yaml = "//google/cloud/vision:vision_v1p4beta1.yaml",
+    deps = [
+        ":vision_py_grpc",
+        ":vision_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "vision-v1p4beta1-py",
+    deps = [
+        ":vision_py_gapic",
+        ":vision_py_grpc",
+        ":vision_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "vision_php_proto",
+    deps = [":vision_proto"],
+)
+
+php_grpc_library(
+    name = "vision_php_grpc",
+    srcs = [":vision_proto"],
+    deps = [":vision_php_proto"],
+)
+
+php_gapic_library(
+    name = "vision_php_gapic",
+    src = ":vision_proto_with_info",
+    gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1p4beta1",
+    service_yaml = "//google/cloud/vision:vision_v1p4beta1.yaml",
+    deps = [
+        ":vision_php_grpc",
+        ":vision_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-vision-v1p4beta1-php",
+    deps = [
+        ":vision_php_gapic",
+        ":vision_php_grpc",
+        ":vision_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "vision_nodejs_gapic",
+    src = ":vision_proto_with_info",
+    gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1p4beta1",
+    service_yaml = "//google/cloud/vision:vision_v1p4beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "vision-v1p4beta1-nodejs",
+    deps = [
+        ":vision_nodejs_gapic",
+        ":vision_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "vision_ruby_proto",
+    deps = [":vision_proto"],
+)
+
+ruby_grpc_library(
+    name = "vision_ruby_grpc",
+    srcs = [":vision_proto"],
+    deps = [":vision_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "vision_ruby_gapic",
+    src = ":vision_proto_with_info",
+    gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1p4beta1",
+    service_yaml = "//google/cloud/vision:vision_v1p4beta1.yaml",
+    deps = [
+        ":vision_ruby_grpc",
+        ":vision_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-vision-v1p4beta1-ruby",
+    deps = [
+        ":vision_ruby_gapic",
+        ":vision_ruby_grpc",
+        ":vision_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "vision_csharp_proto",
+    deps = [":vision_proto"],
+)
+
+csharp_grpc_library(
+    name = "vision_csharp_grpc",
+    srcs = [":vision_proto"],
+    deps = [":vision_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "vision_csharp_gapic",
+    src = ":vision_proto_with_info",
+    gapic_yaml = "vision_gapic.yaml",
+    package = "google.cloud.vision.v1p4beta1",
+    service_yaml = "//google/cloud/vision:vision_v1p4beta1.yaml",
+    deps = [
+        ":vision_csharp_grpc",
+        ":vision_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-vision-v1p4beta1-csharp",
+    deps = [
+        ":vision_csharp_gapic",
+        ":vision_csharp_grpc",
+        ":vision_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/vision/v1p4beta1/face.proto b/third_party/googleapis/google/cloud/vision/v1p4beta1/face.proto
new file mode 100644
index 000000000..1786f26f0
--- /dev/null
+++ b/third_party/googleapis/google/cloud/vision/v1p4beta1/face.proto
@@ -0,0 +1,61 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.cloud.vision.v1p4beta1;
+
+import "google/api/annotations.proto";
+import "google/cloud/vision/v1p4beta1/geometry.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/cloud/vision/v1p4beta1;vision";
+option java_multiple_files = true;
+option java_outer_classname = "CelebrityProto";
+option java_package = "com.google.cloud.vision.v1p4beta1";
+option objc_class_prefix = "GCVN";
+
+// Parameters for a celebrity recognition request.
+message FaceRecognitionParams {
+  // The resource names for one or more
+  // [CelebritySet][google.cloud.vision.v1p4beta1.CelebritySet]s. A celebrity
+  // set is preloaded and can be specified as "builtin/default". If this is
+  // specified, the algorithm will try to match the faces detected in the input
+  // image to the Celebrities in the CelebritySets.
+  repeated string celebrity_set = 1;
+}
+
+// A Celebrity is a group of Faces with an identity.
+message Celebrity {
+  // The resource name of the preloaded Celebrity. Has the format
+  // `builtin/{mid}`.
+  string name = 1;
+
+  // The Celebrity's display name.
+  string display_name = 2;
+
+  // The Celebrity's description.
+  string description = 3;
+}
+
+// Information about a face's identity.
+message FaceRecognitionResult {
+  // The [Celebrity][google.cloud.vision.v1p4beta1.Celebrity] that this face was
+  // matched to.
+  Celebrity celebrity = 1;
+
+  // Recognition confidence. Range [0, 1].
+  float confidence = 2;
+}
diff --git a/third_party/googleapis/google/cloud/vision/v1p4beta1/geometry.proto b/third_party/googleapis/google/cloud/vision/v1p4beta1/geometry.proto
index b0abd329c..18877188f 100644
--- a/third_party/googleapis/google/cloud/vision/v1p4beta1/geometry.proto
+++ b/third_party/googleapis/google/cloud/vision/v1p4beta1/geometry.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/third_party/googleapis/google/cloud/vision/v1p4beta1/image_annotator.proto b/third_party/googleapis/google/cloud/vision/v1p4beta1/image_annotator.proto
index ebbf92c35..9c18cccdf 100644
--- a/third_party/googleapis/google/cloud/vision/v1p4beta1/image_annotator.proto
+++ b/third_party/googleapis/google/cloud/vision/v1p4beta1/image_annotator.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,6 +18,9 @@ syntax = "proto3";
 package google.cloud.vision.v1p4beta1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/cloud/vision/v1p4beta1/face.proto";
 import "google/cloud/vision/v1p4beta1/geometry.proto";
 import "google/cloud/vision/v1p4beta1/product_search.proto";
 import "google/cloud/vision/v1p4beta1/text_annotation.proto";
@@ -40,6 +43,11 @@ option objc_class_prefix = "GCVN";
 // images, such as face, landmark, logo, label, and text detection. The
 // ImageAnnotator service returns detected entities from the images.
 service ImageAnnotator {
+  option (google.api.default_host) = "vision.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/cloud-vision";
+
   // Run image detection and annotation for a batch of images.
   rpc BatchAnnotateImages(BatchAnnotateImagesRequest)
       returns (BatchAnnotateImagesResponse) {
@@ -47,20 +55,23 @@ service ImageAnnotator {
       post: "/v1p4beta1/images:annotate"
       body: "*"
     };
+    option (google.api.method_signature) = "requests";
   }
 
   // Service that performs image detection and annotation for a batch of files.
   // Now only "application/pdf", "image/tiff" and "image/gif" are supported.
   //
-  // This service will extract at most the first 10 frames (gif) or pages
-  // (pdf or tiff) from each file provided and perform detection and annotation
-  // for each image extracted.
+  // This service will extract at most 5 (customers can specify which 5 in
+  // AnnotateFileRequest.pages) frames (gif) or pages (pdf or tiff) from each
+  // file provided and perform detection and annotation for each image
+  // extracted.
   rpc BatchAnnotateFiles(BatchAnnotateFilesRequest)
       returns (BatchAnnotateFilesResponse) {
     option (google.api.http) = {
       post: "/v1p4beta1/files:annotate"
       body: "*"
     };
+    option (google.api.method_signature) = "requests";
   }
 
   // Run asynchronous image detection and annotation for a list of images.
@@ -78,6 +89,11 @@ service ImageAnnotator {
       post: "/v1p4beta1/images:asyncBatchAnnotate"
       body: "*"
     };
+    option (google.api.method_signature) = "requests,output_config";
+    option (google.longrunning.operation_info) = {
+      response_type: "AsyncBatchAnnotateImagesResponse"
+      metadata_type: "OperationMetadata"
+    };
   }
 
   // Run asynchronous image detection and annotation for a list of generic
@@ -92,6 +108,11 @@ service ImageAnnotator {
       post: "/v1p4beta1/files:asyncBatchAnnotate"
       body: "*"
     };
+    option (google.api.method_signature) = "requests";
+    option (google.longrunning.operation_info) = {
+      response_type: "AsyncBatchAnnotateFilesResponse"
+      metadata_type: "OperationMetadata"
+    };
   }
 }
 
@@ -208,19 +229,19 @@ enum Likelihood {
   // Unknown likelihood.
   UNKNOWN = 0;
 
-  // It is very unlikely that the image belongs to the specified vertical.
+  // It is very unlikely.
   VERY_UNLIKELY = 1;
 
-  // It is unlikely that the image belongs to the specified vertical.
+  // It is unlikely.
   UNLIKELY = 2;
 
-  // It is possible that the image belongs to the specified vertical.
+  // It is possible.
   POSSIBLE = 3;
 
-  // It is likely that the image belongs to the specified vertical.
+  // It is likely.
   LIKELY = 4;
 
-  // It is very likely that the image belongs to the specified vertical.
+  // It is very likely.
   VERY_LIKELY = 5;
 }
 
@@ -406,6 +427,13 @@ message FaceAnnotation {
 
   // Headwear likelihood.
   Likelihood headwear_likelihood = 15;
+
+  // Additional recognition information. Only computed if
+  // image_context.face_recognition_params is provided, **and** a match is found
+  // to a [Celebrity][google.cloud.vision.v1p4beta1.Celebrity] in the input
+  // [CelebritySet][google.cloud.vision.v1p4beta1.CelebritySet]. This field is
+  // sorted in order of decreasing confidence values.
+  repeated FaceRecognitionResult recognition_result = 16;
 }
 
 // Detected entity location information.
@@ -604,12 +632,15 @@ message ImageContext {
   // setting a hint will help get better results (although it will be a
   // significant hindrance if the hint is wrong). Text detection returns an
   // error if one or more of the specified languages is not one of the
-  // [supported languages](/vision/docs/languages).
+  // [supported languages](https://cloud.google.com/vision/docs/languages).
   repeated string language_hints = 2;
 
   // Parameters for crop hints annotation request.
   CropHintsParams crop_hints_params = 4;
 
+  // Parameters for face recognition.
+  FaceRecognitionParams face_recognition_params = 10;
+
   // Parameters for product search.
   ProductSearchParams product_search_params = 5;
 
@@ -693,23 +724,10 @@ message AnnotateImageResponse {
   ImageAnnotationContext context = 21;
 }
 
-// Response to a single file annotation request. A file may contain one or more
-// images, which individually have their own responses.
-message AnnotateFileResponse {
-  // Information about the file for which this response is generated.
-  InputConfig input_config = 1;
-
-  // Individual responses to images found within the file.
-  repeated AnnotateImageResponse responses = 2;
-
-  // This field gives the total number of pages in the file.
-  int32 total_pages = 3;
-}
-
 // Multiple image annotation requests are batched into a single service call.
 message BatchAnnotateImagesRequest {
-  // Individual image annotation requests for this batch.
-  repeated AnnotateImageRequest requests = 1;
+  // Required. Individual image annotation requests for this batch.
+  repeated AnnotateImageRequest requests = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response to a batch image annotation request.
@@ -746,11 +764,30 @@ message AnnotateFileRequest {
   repeated int32 pages = 4;
 }
 
+// Response to a single file annotation request. A file may contain one or more
+// images, which individually have their own responses.
+message AnnotateFileResponse {
+  // Information about the file for which this response is generated.
+  InputConfig input_config = 1;
+
+  // Individual responses to images found within the file. This field will be
+  // empty if the `error` field is set.
+  repeated AnnotateImageResponse responses = 2;
+
+  // This field gives the total number of pages in the file.
+  int32 total_pages = 3;
+
+  // If set, represents the error message for the failed request. The
+  // `responses` field will not be set in this case.
+  google.rpc.Status error = 4;
+}
+
 // A list of requests to annotate files using the BatchAnnotateFiles API.
 message BatchAnnotateFilesRequest {
-  // The list of file annotation requests. Right now we support only one
-  // AnnotateFileRequest in BatchAnnotateFilesRequest.
-  repeated AnnotateFileRequest requests = 1;
+  // Required. The list of file annotation requests. Right now we support only
+  // one AnnotateFileRequest in BatchAnnotateFilesRequest.
+  repeated AnnotateFileRequest requests = 1
+      [(google.api.field_behavior) = REQUIRED];
 }
 
 // A list of file annotation responses.
@@ -783,11 +820,12 @@ message AsyncAnnotateFileResponse {
 
 // Request for async image annotation for a list of images.
 message AsyncBatchAnnotateImagesRequest {
-  // Individual image annotation requests for this batch.
-  repeated AnnotateImageRequest requests = 1;
+  // Required. Individual image annotation requests for this batch.
+  repeated AnnotateImageRequest requests = 1
+      [(google.api.field_behavior) = REQUIRED];
 
   // Required. The desired output location and metadata (e.g. format).
-  OutputConfig output_config = 2;
+  OutputConfig output_config = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response to an async batch image annotation request.
@@ -799,8 +837,9 @@ message AsyncBatchAnnotateImagesResponse {
 // Multiple async file annotation requests are batched into a single service
 // call.
 message AsyncBatchAnnotateFilesRequest {
-  // Individual async file annotation requests for this batch.
-  repeated AsyncAnnotateFileRequest requests = 1;
+  // Required. Individual async file annotation requests for this batch.
+  repeated AsyncAnnotateFileRequest requests = 1
+      [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response to an async batch file annotation request.
@@ -823,8 +862,8 @@ message InputConfig {
   // not work for AsyncBatchAnnotateFiles requests.
   bytes content = 3;
 
-  // The type of the file. Currently only "application/pdf" and "image/tiff"
-  // are supported. Wildcards are not supported.
+  // The type of the file. Currently only "application/pdf", "image/tiff" and
+  // "image/gif" are supported. Wildcards are not supported.
   string mime_type = 2;
 }
 
@@ -856,16 +895,23 @@ message GcsSource {
 
 // The Google Cloud Storage location where the output will be written to.
 message GcsDestination {
-  // Google Cloud Storage URI where the results will be stored. Results will
-  // be in JSON format and preceded by its corresponding input URI. This field
-  // can either represent a single file, or a prefix for multiple outputs.
-  // Prefixes must end in a `/`.
+  // Google Cloud Storage URI prefix where the results will be stored. Results
+  // will be in JSON format and preceded by its corresponding input URI prefix.
+  // This field can either represent a gcs file prefix or gcs directory. In
+  // either case, the uri should be unique because in order to get all of the
+  // output files, you will need to do a wildcard gcs search on the uri prefix
+  // you provide.
   //
   // Examples:
   //
-  // *    File: gs://bucket-name/filename.json
-  // *    Prefix: gs://bucket-name/prefix/here/
-  // *    File: gs://bucket-name/prefix/here
+  // *    File Prefix: gs://bucket-name/here/filenameprefix   The output files
+  // will be created in gs://bucket-name/here/ and the names of the
+  // output files will begin with "filenameprefix".
+  //
+  // *    Directory Prefix: gs://bucket-name/some/location/   The output files
+  // will be created in gs://bucket-name/some/location/ and the names of the
+  // output files could be anything because there was no filename prefix
+  // specified.
   //
   // If multiple outputs, each response is still AnnotateFileResponse, each of
   // which contains some subset of the full list of AnnotateImageResponse.
diff --git a/third_party/googleapis/google/cloud/vision/v1p4beta1/product_search.proto b/third_party/googleapis/google/cloud/vision/v1p4beta1/product_search.proto
index 1caf30194..15baed1fd 100644
--- a/third_party/googleapis/google/cloud/vision/v1p4beta1/product_search.proto
+++ b/third_party/googleapis/google/cloud/vision/v1p4beta1/product_search.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,6 +18,7 @@ syntax = "proto3";
 package google.cloud.vision.v1p4beta1;
 
 import "google/api/annotations.proto";
+import "google/api/resource.proto";
 import "google/cloud/vision/v1p4beta1/geometry.proto";
 import "google/cloud/vision/v1p4beta1/product_search_service.proto";
 import "google/protobuf/timestamp.proto";
@@ -32,7 +33,7 @@ option objc_class_prefix = "GCVN";
 // Parameters for a product search request.
 message ProductSearchParams {
   // The bounding polygon around the area of interest in the image.
-  // Optional. If it is not specified, system discretion will be applied.
+  // If it is not specified, system discretion will be applied.
   BoundingPoly bounding_poly = 9;
 
   // The resource name of a
@@ -41,23 +42,27 @@ message ProductSearchParams {
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`.
-  string product_set = 6;
+  string product_set = 6 [(google.api.resource_reference) = {
+    type: "vision.googleapis.com/ProductSet"
+  }];
 
   // The list of product categories to search in. Currently, we only consider
-  // the first category, and either "homegoods-v2", "apparel-v2", "toys-v2", or
-  // "packagedgoods-v1" should be specified. The legacy categories "homegoods",
-  // "apparel", and "toys" are still supported but will be deprecated. For new
-  // products, please use "homegoods-v2", "apparel-v2", or "toys-v2" for better
-  // product search accuracy. It is recommended to migrate existing products to
-  // these categories as well.
+  // the first category, and either "homegoods-v2", "apparel-v2", "toys-v2",
+  // "packagedgoods-v1", or "general-v1" should be specified. The legacy
+  // categories "homegoods", "apparel", and "toys" are still supported but will
+  // be deprecated. For new products, please use "homegoods-v2", "apparel-v2",
+  // or "toys-v2" for better product search accuracy. It is recommended to
+  // migrate existing products to these categories as well.
   repeated string product_categories = 7;
 
   // The filtering expression. This can be used to restrict search results based
   // on Product labels. We currently support an AND of OR of key-value
-  // expressions, where each expression within an OR must have the same key.
+  // expressions, where each expression within an OR must have the same key. An
+  // '=' should be used to connect the key and value.
   //
   // For example, "(color = red OR color = blue) AND brand = Google" is
-  // acceptable, but not "(color = red OR brand = Google)" or "color: red".
+  // acceptable, but "(color = red OR brand = Google)" is not acceptable.
+  // "color: red" is not acceptable because it uses a ':' instead of an '='.
   string filter = 8;
 }
 
@@ -77,6 +82,23 @@ message ProductSearchResults {
     string image = 3;
   }
 
+  // Prediction for what the object in the bounding box is.
+  message ObjectAnnotation {
+    // Object ID that should align with EntityAnnotation mid.
+    string mid = 1;
+
+    // The BCP-47 language code, such as "en-US" or "sr-Latn". For more
+    // information, see
+    // http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
+    string language_code = 2;
+
+    // Object name, expressed in its `language_code` language.
+    string name = 3;
+
+    // Score of the result. Range [0, 1].
+    float score = 4;
+  }
+
   // Information about the products similar to a single product in a query
   // image.
   message GroupedResult {
@@ -85,10 +107,14 @@ message ProductSearchResults {
 
     // List of results, one for each product match.
     repeated Result results = 2;
+
+    // List of generic predictions for the object in the bounding box.
+    repeated ObjectAnnotation object_annotations = 3;
   }
 
-  // Timestamp of the index which provided these results. Changes made after
-  // this time are not reflected in the current results.
+  // Timestamp of the index which provided these results. Products added to the
+  // product set and products removed from the product set after this time are
+  // not reflected in the current results.
   google.protobuf.Timestamp index_time = 2;
 
   // List of results, one for each product match.
diff --git a/third_party/googleapis/google/cloud/vision/v1p4beta1/product_search_service.proto b/third_party/googleapis/google/cloud/vision/v1p4beta1/product_search_service.proto
index 3cbc53573..df7bc7a38 100644
--- a/third_party/googleapis/google/cloud/vision/v1p4beta1/product_search_service.proto
+++ b/third_party/googleapis/google/cloud/vision/v1p4beta1/product_search_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,6 +18,9 @@ syntax = "proto3";
 package google.cloud.vision.v1p4beta1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/vision/v1p4beta1/geometry.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/empty.proto";
@@ -51,6 +54,11 @@ option objc_class_prefix = "GCVN";
 // named
 //   `projects/*/locations/*/products/*/referenceImages/*`
 service ProductSearch {
+  option (google.api.default_host) = "vision.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/cloud-vision";
+
   // Creates and returns a new ProductSet resource.
   //
   // Possible errors:
@@ -62,6 +70,7 @@ service ProductSearch {
       post: "/v1p4beta1/{parent=projects/*/locations/*}/productSets"
       body: "product_set"
     };
+    option (google.api.method_signature) = "parent,product_set,product_set_id";
   }
 
   // Lists ProductSets in an unspecified order.
@@ -75,6 +84,7 @@ service ProductSearch {
     option (google.api.http) = {
       get: "/v1p4beta1/{parent=projects/*/locations/*}/productSets"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets information associated with a ProductSet.
@@ -86,6 +96,7 @@ service ProductSearch {
     option (google.api.http) = {
       get: "/v1p4beta1/{name=projects/*/locations/*/productSets/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Makes changes to a ProductSet resource.
@@ -101,21 +112,19 @@ service ProductSearch {
       patch: "/v1p4beta1/{product_set.name=projects/*/locations/*/productSets/*}"
       body: "product_set"
     };
+    option (google.api.method_signature) = "product_set,update_mask";
   }
 
   // Permanently deletes a ProductSet. Products and ReferenceImages in the
   // ProductSet are not deleted.
   //
   // The actual image files are not deleted from Google Cloud Storage.
-  //
-  // Possible errors:
-  //
-  // * Returns NOT_FOUND if the ProductSet does not exist.
   rpc DeleteProductSet(DeleteProductSetRequest)
       returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v1p4beta1/{name=projects/*/locations/*/productSets/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates and returns a new product resource.
@@ -131,6 +140,7 @@ service ProductSearch {
       post: "/v1p4beta1/{parent=projects/*/locations/*}/products"
       body: "product"
     };
+    option (google.api.method_signature) = "parent,product,product_id";
   }
 
   // Lists products in an unspecified order.
@@ -142,6 +152,7 @@ service ProductSearch {
     option (google.api.http) = {
       get: "/v1p4beta1/{parent=projects/*/locations/*}/products"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets information associated with a Product.
@@ -153,6 +164,7 @@ service ProductSearch {
     option (google.api.http) = {
       get: "/v1p4beta1/{name=projects/*/locations/*/products/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Makes changes to a Product resource.
@@ -175,6 +187,7 @@ service ProductSearch {
       patch: "/v1p4beta1/{product.name=projects/*/locations/*/products/*}"
       body: "product"
     };
+    option (google.api.method_signature) = "product,update_mask";
   }
 
   // Permanently deletes a product and its reference images.
@@ -182,14 +195,11 @@ service ProductSearch {
   // Metadata of the product and all its images will be deleted right away, but
   // search queries against ProductSets containing the product may still work
   // until all related caches are refreshed.
-  //
-  // Possible errors:
-  //
-  // * Returns NOT_FOUND if the product does not exist.
   rpc DeleteProduct(DeleteProductRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v1p4beta1/{name=projects/*/locations/*/products/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates and returns a new ReferenceImage resource.
@@ -217,6 +227,8 @@ service ProductSearch {
       post: "/v1p4beta1/{parent=projects/*/locations/*/products/*}/referenceImages"
       body: "reference_image"
     };
+    option (google.api.method_signature) =
+        "parent,reference_image,reference_image_id";
   }
 
   // Permanently deletes a reference image.
@@ -226,15 +238,12 @@ service ProductSearch {
   // caches are refreshed.
   //
   // The actual image files are not deleted from Google Cloud Storage.
-  //
-  // Possible errors:
-  //
-  // * Returns NOT_FOUND if the reference image does not exist.
   rpc DeleteReferenceImage(DeleteReferenceImageRequest)
       returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v1p4beta1/{name=projects/*/locations/*/products/*/referenceImages/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists reference images.
@@ -249,6 +258,7 @@ service ProductSearch {
     option (google.api.http) = {
       get: "/v1p4beta1/{parent=projects/*/locations/*/products/*}/referenceImages"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets information associated with a ReferenceImage.
@@ -260,6 +270,7 @@ service ProductSearch {
     option (google.api.http) = {
       get: "/v1p4beta1/{name=projects/*/locations/*/products/*/referenceImages/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Adds a Product to the specified ProductSet. If the Product is already
@@ -276,19 +287,17 @@ service ProductSearch {
       post: "/v1p4beta1/{name=projects/*/locations/*/productSets/*}:addProduct"
       body: "*"
     };
+    option (google.api.method_signature) = "name,product";
   }
 
   // Removes a Product from the specified ProductSet.
-  //
-  // Possible errors:
-  //
-  // * Returns NOT_FOUND If the Product is not found under the ProductSet.
   rpc RemoveProductFromProductSet(RemoveProductFromProductSetRequest)
       returns (google.protobuf.Empty) {
     option (google.api.http) = {
       post: "/v1p4beta1/{name=projects/*/locations/*/productSets/*}:removeProduct"
       body: "*"
     };
+    option (google.api.method_signature) = "name,product";
   }
 
   // Lists the Products in a ProductSet, in an unspecified order. If the
@@ -303,6 +312,7 @@ service ProductSearch {
     option (google.api.http) = {
       get: "/v1p4beta1/{name=projects/*/locations/*/productSets/*}/products"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Asynchronous API that imports a list of reference images to specified
@@ -322,11 +332,58 @@ service ProductSearch {
       post: "/v1p4beta1/{parent=projects/*/locations/*}/productSets:import"
       body: "*"
     };
+    option (google.api.method_signature) = "parent,input_config";
+    option (google.longrunning.operation_info) = {
+      response_type: "ImportProductSetsResponse"
+      metadata_type: "BatchOperationMetadata"
+    };
+  }
+
+  // Asynchronous API to delete all Products in a ProductSet or all Products
+  // that are in no ProductSet.
+  //
+  // If a Product is a member of the specified ProductSet in addition to other
+  // ProductSets, the Product will still be deleted.
+  //
+  // It is recommended to not delete the specified ProductSet until after this
+  // operation has completed. It is also recommended to not add any of the
+  // Products involved in the batch delete to a new ProductSet while this
+  // operation is running because those Products may still end up deleted.
+  //
+  // It's not possible to undo the PurgeProducts operation. Therefore, it is
+  // recommended to keep the csv files used in ImportProductSets (if that was
+  // how you originally built the Product Set) before starting PurgeProducts, in
+  // case you need to re-import the data after deletion.
+  //
+  // If the plan is to purge all of the Products from a ProductSet and then
+  // re-use the empty ProductSet to re-import new Products into the empty
+  // ProductSet, you must wait until the PurgeProducts operation has finished
+  // for that ProductSet.
+  //
+  // The [google.longrunning.Operation][google.longrunning.Operation] API can be
+  // used to keep track of the progress and results of the request.
+  // `Operation.metadata` contains `BatchOperationMetadata`. (progress)
+  rpc PurgeProducts(PurgeProductsRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1p4beta1/{parent=projects/*/locations/*}/products:purge"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.protobuf.Empty"
+      metadata_type: "BatchOperationMetadata"
+    };
   }
 }
 
 // A Product contains ReferenceImages.
 message Product {
+  option (google.api.resource) = {
+    type: "vision.googleapis.com/Product"
+    pattern: "projects/{project}/locations/{location}/products/{product}"
+  };
+
   // A product label represented as a key-value pair.
   message KeyValue {
     // The key of the label attached to the product. Cannot be empty and cannot
@@ -354,16 +411,11 @@ message Product {
   // characters long.
   string description = 3;
 
-  // The category for the product identified by the reference image. This should
-  // be either "homegoods-v2", "apparel-v2", "toys-v2", or "packagedgoods-v1".
-  // The legacy categories "homegoods", "apparel", and "toys" are still
-  // supported but will be deprecated. For new products, please use
-  // "homegoods-v2", "apparel-v2", or "toys-v2" for better product search
-  // accuracy. It is recommended to migrate existing products to these
-  // categories as well.
-  //
-  // This field is immutable.
-  string product_category = 4;
+  // Immutable. The category for the product identified by the reference image.
+  // This should be either "homegoods-v2", "apparel-v2", or "toys-v2". The
+  // legacy categories "homegoods", "apparel", and "toys" are still supported,
+  // but these should not be used for new products.
+  string product_category = 4 [(google.api.field_behavior) = IMMUTABLE];
 
   // Key-value pairs that can be attached to a product. At query time,
   // constraints can be specified based on the product_labels.
@@ -373,7 +425,11 @@ message Product {
   // to be supported soon.
   //
   // Multiple values can be assigned to the same key. One product may have up to
-  // 100 product_labels.
+  // 500 product_labels.
+  //
+  // Notice that the total number of distinct product_labels over all products
+  // in one ProductSet cannot exceed 1M, otherwise the product search pipeline
+  // will refuse to work for that ProductSet.
   repeated KeyValue product_labels = 5;
 }
 
@@ -381,6 +437,11 @@ message Product {
 // million reference images. If the limit is exceeded, periodic indexing will
 // fail.
 message ProductSet {
+  option (google.api.resource) = {
+    type: "vision.googleapis.com/ProductSet"
+    pattern: "projects/{project}/locations/{location}/productSets/{product_set}"
+  };
+
   // The resource name of the ProductSet.
   //
   // Format is:
@@ -399,18 +460,24 @@ message ProductSet {
   // "1970-01-01T00:00:00Z".
   //
   // This field is ignored when creating a ProductSet.
-  google.protobuf.Timestamp index_time = 3;
+  google.protobuf.Timestamp index_time = 3
+      [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. If there was an error with indexing the product set, the field
   // is populated.
   //
   // This field is ignored when creating a ProductSet.
-  google.rpc.Status index_error = 4;
+  google.rpc.Status index_error = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // A `ReferenceImage` represents a product image and its associated metadata,
 // such as bounding boxes.
 message ReferenceImage {
+  option (google.api.resource) = {
+    type: "vision.googleapis.com/ReferenceImage"
+    pattern: "projects/{project}/locations/{location}/products/{product}/referenceImages/{reference_image}"
+  };
+
   // The resource name of the reference image.
   //
   // Format is:
@@ -420,34 +487,38 @@ message ReferenceImage {
   // This field is ignored when creating a reference image.
   string name = 1;
 
-  // The Google Cloud Storage URI of the reference image.
+  // Required. The Google Cloud Storage URI of the reference image.
   //
   // The URI must start with `gs://`.
-  //
-  // Required.
-  string uri = 2;
+  string uri = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Bounding polygons around the areas of interest in the reference image.
-  // Optional. If this field is empty, the system will try to detect regions of
+  // Optional. Bounding polygons around the areas of interest in the reference
+  // image. If this field is empty, the system will try to detect regions of
   // interest. At most 10 bounding polygons will be used.
   //
   // The provided shape is converted into a non-rotated rectangle. Once
   // converted, the small edge of the rectangle must be greater than or equal
   // to 300 pixels. The aspect ratio must be 1:4 or less (i.e. 1:3 is ok; 1:5
   // is not).
-  repeated BoundingPoly bounding_polys = 3;
+  repeated BoundingPoly bounding_polys = 3
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request message for the `CreateProduct` method.
 message CreateProductRequest {
-  // The project in which the Product should be created.
+  // Required. The project in which the Product should be created.
   //
   // Format is
   // `projects/PROJECT_ID/locations/LOC_ID`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
-  // The product to create.
-  Product product = 2;
+  // Required. The product to create.
+  Product product = 2 [(google.api.field_behavior) = REQUIRED];
 
   // A user-supplied resource id for this Product. If set, the server will
   // attempt to use this value as the resource id. If it is already in use, an
@@ -458,11 +529,16 @@ message CreateProductRequest {
 
 // Request message for the `ListProducts` method.
 message ListProductsRequest {
-  // The project OR ProductSet from which Products should be listed.
+  // Required. The project OR ProductSet from which Products should be listed.
   //
   // Format:
   // `projects/PROJECT_ID/locations/LOC_ID`
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
   // The maximum number of items to return. Default 10, maximum 100.
   int32 page_size = 2;
@@ -483,18 +559,21 @@ message ListProductsResponse {
 
 // Request message for the `GetProduct` method.
 message GetProductRequest {
-  // Resource name of the Product to get.
+  // Required. Resource name of the Product to get.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "vision.googleapis.com/Product" }
+  ];
 }
 
 // Request message for the `UpdateProduct` method.
 message UpdateProductRequest {
-  // The Product resource which replaces the one on the server.
+  // Required. The Product resource which replaces the one on the server.
   // product.name is immutable.
-  Product product = 1;
+  Product product = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The [FieldMask][google.protobuf.FieldMask] that specifies which fields
   // to update.
@@ -506,22 +585,30 @@ message UpdateProductRequest {
 
 // Request message for the `DeleteProduct` method.
 message DeleteProductRequest {
-  // Resource name of product to delete.
+  // Required. Resource name of product to delete.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "vision.googleapis.com/Product" }
+  ];
 }
 
 // Request message for the `CreateProductSet` method.
 message CreateProductSetRequest {
-  // The project in which the ProductSet should be created.
+  // Required. The project in which the ProductSet should be created.
   //
   // Format is `projects/PROJECT_ID/locations/LOC_ID`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
-  // The ProductSet to create.
-  ProductSet product_set = 2;
+  // Required. The ProductSet to create.
+  ProductSet product_set = 2 [(google.api.field_behavior) = REQUIRED];
 
   // A user-supplied resource id for this ProductSet. If set, the server will
   // attempt to use this value as the resource id. If it is already in use, an
@@ -532,10 +619,15 @@ message CreateProductSetRequest {
 
 // Request message for the `ListProductSets` method.
 message ListProductSetsRequest {
-  // The project from which ProductSets should be listed.
+  // Required. The project from which ProductSets should be listed.
   //
   // Format is `projects/PROJECT_ID/locations/LOC_ID`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
 
   // The maximum number of items to return. Default 10, maximum 100.
   int32 page_size = 2;
@@ -556,17 +648,22 @@ message ListProductSetsResponse {
 
 // Request message for the `GetProductSet` method.
 message GetProductSetRequest {
-  // Resource name of the ProductSet to get.
+  // Required. Resource name of the ProductSet to get.
   //
   // Format is:
-  // `projects/PROJECT_ID/locations/LOG_ID/productSets/PRODUCT_SET_ID`
-  string name = 1;
+  // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/ProductSet"
+    }
+  ];
 }
 
 // Request message for the `UpdateProductSet` method.
 message UpdateProductSetRequest {
-  // The ProductSet resource which replaces the one on the server.
-  ProductSet product_set = 1;
+  // Required. The ProductSet resource which replaces the one on the server.
+  ProductSet product_set = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The [FieldMask][google.protobuf.FieldMask] that specifies which fields to
   // update.
@@ -577,24 +674,33 @@ message UpdateProductSetRequest {
 
 // Request message for the `DeleteProductSet` method.
 message DeleteProductSetRequest {
-  // Resource name of the ProductSet to delete.
+  // Required. Resource name of the ProductSet to delete.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/ProductSet"
+    }
+  ];
 }
 
 // Request message for the `CreateReferenceImage` method.
 message CreateReferenceImageRequest {
-  // Resource name of the product in which to create the reference image.
+  // Required. Resource name of the product in which to create the reference
+  // image.
   //
   // Format is
   // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "vision.googleapis.com/Product" }
+  ];
 
-  // The reference image to create.
+  // Required. The reference image to create.
   // If an image ID is specified, it is ignored.
-  ReferenceImage reference_image = 2;
+  ReferenceImage reference_image = 2 [(google.api.field_behavior) = REQUIRED];
 
   // A user-supplied resource id for the ReferenceImage to be added. If set,
   // the server will attempt to use this value as the resource id. If it is
@@ -605,11 +711,14 @@ message CreateReferenceImageRequest {
 
 // Request message for the `ListReferenceImages` method.
 message ListReferenceImagesRequest {
-  // Resource name of the product containing the reference images.
+  // Required. Resource name of the product containing the reference images.
   //
   // Format is
   // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "vision.googleapis.com/Product" }
+  ];
 
   // The maximum number of items to return. Default 10, maximum 100.
   int32 page_size = 2;
@@ -635,61 +744,93 @@ message ListReferenceImagesResponse {
 
 // Request message for the `GetReferenceImage` method.
 message GetReferenceImageRequest {
-  // The resource name of the ReferenceImage to get.
+  // Required. The resource name of the ReferenceImage to get.
   //
   // Format is:
   //
   // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/ReferenceImage"
+    }
+  ];
 }
 
 // Request message for the `DeleteReferenceImage` method.
 message DeleteReferenceImageRequest {
-  // The resource name of the reference image to delete.
+  // Required. The resource name of the reference image to delete.
   //
   // Format is:
   //
   // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/ReferenceImage"
+    }
+  ];
 }
 
 // Request message for the `AddProductToProductSet` method.
 message AddProductToProductSetRequest {
-  // The resource name for the ProductSet to modify.
+  // Required. The resource name for the ProductSet to modify.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/ProductSet"
+    }
+  ];
 
-  // The resource name for the Product to be added to this ProductSet.
+  // Required. The resource name for the Product to be added to this ProductSet.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
-  string product = 2;
+  string product = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "vision.googleapis.com/Product" }
+  ];
 }
 
 // Request message for the `RemoveProductFromProductSet` method.
 message RemoveProductFromProductSetRequest {
-  // The resource name for the ProductSet to modify.
+  // Required. The resource name for the ProductSet to modify.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/ProductSet"
+    }
+  ];
 
-  // The resource name for the Product to be removed from this ProductSet.
+  // Required. The resource name for the Product to be removed from this
+  // ProductSet.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`
-  string product = 2;
+  string product = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "vision.googleapis.com/Product" }
+  ];
 }
 
 // Request message for the `ListProductsInProductSet` method.
 message ListProductsInProductSetRequest {
-  // The ProductSet resource for which to retrieve Products.
+  // Required. The ProductSet resource for which to retrieve Products.
   //
   // Format is:
   // `projects/PROJECT_ID/locations/LOC_ID/productSets/PRODUCT_SET_ID`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "vision.googleapis.com/ProductSet"
+    }
+  ];
 
   // The maximum number of items to return. Default 10, maximum 100.
   int32 page_size = 2;
@@ -789,13 +930,19 @@ message ImportProductSetsInputConfig {
 
 // Request message for the `ImportProductSets` method.
 message ImportProductSetsRequest {
-  // The project in which the ProductSets should be imported.
+  // Required. The project in which the ProductSets should be imported.
   //
   // Format is `projects/PROJECT_ID/locations/LOC_ID`.
-  string parent = 1;
-
-  // The input content for the list of requests.
-  ImportProductSetsInputConfig input_config = 2;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // Required. The input content for the list of requests.
+  ImportProductSetsInputConfig input_config = 2
+      [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response message for the `ImportProductSets` method.
@@ -855,3 +1002,38 @@ message BatchOperationMetadata {
   // set to true.
   google.protobuf.Timestamp end_time = 3;
 }
+
+// Config to control which ProductSet contains the Products to be deleted.
+message ProductSetPurgeConfig {
+  // The ProductSet that contains the Products to delete. If a Product is a
+  // member of product_set_id in addition to other ProductSets, the Product will
+  // still be deleted.
+  string product_set_id = 1;
+}
+
+// Request message for the `PurgeProducts` method.
+message PurgeProductsRequest {
+  // The Products to delete.
+  oneof target {
+    // Specify which ProductSet contains the Products to be deleted.
+    ProductSetPurgeConfig product_set_purge_config = 2;
+
+    // If delete_orphan_products is true, all Products that are not in any
+    // ProductSet will be deleted.
+    bool delete_orphan_products = 3;
+  }
+
+  // Required. The project and location in which the Products should be deleted.
+  //
+  // Format is `projects/PROJECT_ID/locations/LOC_ID`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // The default value is false. Override this value to true to actually perform
+  // the purge.
+  bool force = 4;
+}
diff --git a/third_party/googleapis/google/cloud/vision/v1p4beta1/text_annotation.proto b/third_party/googleapis/google/cloud/vision/v1p4beta1/text_annotation.proto
index 542677f27..fbc35bb54 100644
--- a/third_party/googleapis/google/cloud/vision/v1p4beta1/text_annotation.proto
+++ b/third_party/googleapis/google/cloud/vision/v1p4beta1/text_annotation.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -194,7 +194,7 @@ message Paragraph {
   //   and the vertex order will still be (0, 1, 2, 3).
   BoundingPoly bounding_box = 2;
 
-  // List of words in this paragraph.
+  // List of all words in this paragraph.
   repeated Word words = 3;
 
   // Confidence of the OCR results for the paragraph. Range [0, 1].
@@ -250,7 +250,7 @@ message Symbol {
   //      2----3
   //      |    |
   //      1----0
-  //   and the vertice order will still be (0, 1, 2, 3).
+  //   and the vertex order will still be (0, 1, 2, 3).
   BoundingPoly bounding_box = 2;
 
   // The actual UTF-8 representation of the symbol.
diff --git a/third_party/googleapis/google/cloud/vision/v1p4beta1/vision_gapic.legacy.yaml b/third_party/googleapis/google/cloud/vision/v1p4beta1/vision_gapic.legacy.yaml
new file mode 100644
index 000000000..90d6f5000
--- /dev/null
+++ b/third_party/googleapis/google/cloud/vision/v1p4beta1/vision_gapic.legacy.yaml
@@ -0,0 +1,603 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.vision.v1p4beta1
+  python:
+    package_name: google.cloud.vision_v1p4beta1.gapic
+  go:
+    package_name: cloud.google.com/go/vision/apiv1p4beta1
+  csharp:
+    package_name: Google.Cloud.Vision.V1p4beta1
+  ruby:
+    package_name: Google::Cloud::Vision::V1p4beta1
+  php:
+    package_name: Google\Cloud\Vision\V1p4beta1
+  nodejs:
+    package_name: vision.v1p4beta1
+# A list of API interface configurations.
+interfaces:
+  # The fully qualified name of the API interface.
+- name: google.cloud.vision.v1p4beta1.ProductSearch
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}/locations/{location}
+    entity_name: location
+  - name_pattern: projects/{project}/locations/{location}/productSets/{product_set}
+    entity_name: product_set
+  - name_pattern: projects/{project}/locations/{location}/products/{product}
+    entity_name: product
+  - name_pattern: projects/{project}/locations/{location}/products/{product}/referenceImages/{reference_image}
+    entity_name: reference_image
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: CreateProductSet
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - product_set
+        - product_set_id
+    required_fields:
+    - parent
+    - product_set
+    - product_set_id
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 60000
+  - name: ListProductSets
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: product_sets
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 60000
+  - name: GetProductSet
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: product_set
+    timeout_millis: 60000
+  - name: UpdateProductSet
+    flattening:
+      groups:
+      - parameters:
+        - product_set
+        - update_mask
+    required_fields:
+    - product_set
+    - update_mask
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      product_set.name: product_set
+    timeout_millis: 60000
+  - name: DeleteProductSet
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: product_set
+    timeout_millis: 60000
+  - name: CreateProduct
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - product
+        - product_id
+    required_fields:
+    - parent
+    - product
+    - product_id
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 60000
+  - name: ListProducts
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: products
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 60000
+  - name: GetProduct
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: product
+    timeout_millis: 60000
+  - name: UpdateProduct
+    # params.
+    flattening:
+      groups:
+      - parameters:
+        - product
+        - update_mask
+    required_fields:
+    - product
+    - update_mask
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      product.name: product
+    timeout_millis: 60000
+  - name: DeleteProduct
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: product
+    timeout_millis: 60000
+  - name: CreateReferenceImage
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - reference_image
+        - reference_image_id
+    required_fields:
+    - parent
+    - reference_image
+    - reference_image_id
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: product
+    timeout_millis: 60000
+  - name: DeleteReferenceImage
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: reference_image
+    timeout_millis: 60000
+  - name: ListReferenceImages
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: reference_images
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: product
+    timeout_millis: 60000
+  - name: GetReferenceImage
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: reference_image
+    timeout_millis: 60000
+  - name: AddProductToProductSet
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - product
+    required_fields:
+    - name
+    - product
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: product_set
+    timeout_millis: 60000
+  - name: RemoveProductFromProductSet
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - product
+    required_fields:
+    - name
+    - product
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: product_set
+    timeout_millis: 60000
+  - name: ListProductsInProductSet
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: products
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: product_set
+    timeout_millis: 60000
+  - name: ImportProductSets
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - input_config
+    required_fields:
+    - parent
+    - input_config
+    long_running:
+      return_type: google.cloud.vision.v1p4beta1.ImportProductSetsResponse
+      metadata_type: google.cloud.vision.v1p4beta1.BatchOperationMetadata
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: location
+    timeout_millis: 60000
+  # The fully qualified name of the API interface.
+- name: google.cloud.vision.v1p4beta1.ImageAnnotator
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections: []
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 60000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 60000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: BatchAnnotateImages
+    flattening:
+      groups:
+      - parameters:
+        - requests
+    required_fields:
+    - requests
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: BatchAnnotateFiles
+    flattening:
+      groups:
+      - parameters:
+        - requests
+    required_fields:
+    - requests
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: AsyncBatchAnnotateImages
+    flattening:
+      groups:
+      - parameters:
+        - requests
+        - output_config
+    required_fields:
+    - requests
+    - output_config
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    long_running:
+      return_type: google.cloud.vision.v1p4beta1.AsyncBatchAnnotateImagesResponse
+      metadata_type: google.cloud.vision.v1p4beta1.OperationMetadata
+      initial_poll_delay_millis: 500
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 5000
+      total_poll_timeout_millis: 300000
+    timeout_millis: 60000
+  - name: AsyncBatchAnnotateFiles
+    flattening:
+      groups:
+      - parameters:
+        - requests
+    required_fields:
+    - requests
+    long_running:
+      return_type: google.cloud.vision.v1p4beta1.AsyncBatchAnnotateFilesResponse
+      metadata_type: google.cloud.vision.v1p4beta1.OperationMetadata
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+resource_name_generation:
+- message_name: CreateProductSetRequest
+  field_entity_map:
+    parent: location
+- message_name: ListProductSetsRequest
+  field_entity_map:
+    parent: location
+- message_name: GetProductSetRequest
+  field_entity_map:
+    name: product_set
+- message_name: UpdateProductSetRequest
+  field_entity_map:
+    product_set.name: product_set
+- message_name: DeleteProductSetRequest
+  field_entity_map:
+    name: product_set
+- message_name: CreateProductRequest
+  field_entity_map:
+    parent: location
+- message_name: ListProductsRequest
+  field_entity_map:
+    parent: location
+- message_name: GetProductRequest
+  field_entity_map:
+    name: product
+- message_name: UpdateProductRequest
+  field_entity_map:
+    product.name: product
+- message_name: DeleteProductRequest
+  field_entity_map:
+    name: product
+- message_name: CreateReferenceImageRequest
+  field_entity_map:
+    parent: product
+- message_name: DeleteReferenceImageRequest
+  field_entity_map:
+    name: reference_image
+- message_name: ListReferenceImagesRequest
+  field_entity_map:
+    parent: product
+- message_name: GetReferenceImageRequest
+  field_entity_map:
+    name: reference_image
+- message_name: AddProductToProductSetRequest
+  field_entity_map:
+    name: product_set
+- message_name: RemoveProductFromProductSetRequest
+  field_entity_map:
+    name: product_set
+- message_name: ListProductsInProductSetRequest
+  field_entity_map:
+    name: product_set
+- message_name: ImportProductSetsRequest
+  field_entity_map:
+    parent: location
diff --git a/third_party/googleapis/google/cloud/vision/v1p4beta1/vision_gapic.yaml b/third_party/googleapis/google/cloud/vision/v1p4beta1/vision_gapic.yaml
index 90d6f5000..92569c0fb 100644
--- a/third_party/googleapis/google/cloud/vision/v1p4beta1/vision_gapic.yaml
+++ b/third_party/googleapis/google/cloud/vision/v1p4beta1/vision_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -20,411 +20,32 @@ language_settings:
 interfaces:
   # The fully qualified name of the API interface.
 - name: google.cloud.vision.v1p4beta1.ProductSearch
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections:
-  - name_pattern: projects/{project}/locations/{location}
-    entity_name: location
-  - name_pattern: projects/{project}/locations/{location}/productSets/{product_set}
-    entity_name: product_set
-  - name_pattern: projects/{project}/locations/{location}/products/{product}
-    entity_name: product
-  - name_pattern: projects/{project}/locations/{location}/products/{product}/referenceImages/{reference_image}
-    entity_name: reference_image
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
   # A list of method configurations.
   # Common properties:
   #
   #   name - The simple name of the method.
   #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
   #   retry_codes_name - Specifies the configuration for retryable codes. The
   #   name must be defined in interfaces.retry_codes_def.
   #
   #   retry_params_name - Specifies the configuration for retry/backoff
   #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
   methods:
-  - name: CreateProductSet
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - product_set
-        - product_set_id
-    required_fields:
-    - parent
-    - product_set
-    - product_set_id
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    timeout_millis: 60000
-  - name: ListProductSets
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: product_sets
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    timeout_millis: 60000
-  - name: GetProductSet
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: product_set
-    timeout_millis: 60000
-  - name: UpdateProductSet
-    flattening:
-      groups:
-      - parameters:
-        - product_set
-        - update_mask
-    required_fields:
-    - product_set
-    - update_mask
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      product_set.name: product_set
-    timeout_millis: 60000
   - name: DeleteProductSet
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: product_set
-    timeout_millis: 60000
-  - name: CreateProduct
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - product
-        - product_id
-    required_fields:
-    - parent
-    - product
-    - product_id
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    timeout_millis: 60000
-  - name: ListProducts
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: products
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    timeout_millis: 60000
-  - name: GetProduct
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: product
-    timeout_millis: 60000
-  - name: UpdateProduct
-    # params.
-    flattening:
-      groups:
-      - parameters:
-        - product
-        - update_mask
-    required_fields:
-    - product
-    - update_mask
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      product.name: product
-    timeout_millis: 60000
   - name: DeleteProduct
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: product
-    timeout_millis: 60000
-  - name: CreateReferenceImage
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - reference_image
-        - reference_image_id
-    required_fields:
-    - parent
-    - reference_image
-    - reference_image_id
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: product
-    timeout_millis: 60000
   - name: DeleteReferenceImage
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: reference_image
-    timeout_millis: 60000
-  - name: ListReferenceImages
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: reference_images
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: product
-    timeout_millis: 60000
-  - name: GetReferenceImage
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: reference_image
-    timeout_millis: 60000
-  - name: AddProductToProductSet
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - product
-    required_fields:
-    - name
-    - product
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: product_set
-    timeout_millis: 60000
-  - name: RemoveProductFromProductSet
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - product
-    required_fields:
-    - name
-    - product
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: product_set
-    timeout_millis: 60000
-  - name: ListProductsInProductSet
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: products
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: product_set
-    timeout_millis: 60000
   - name: ImportProductSets
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - input_config
-    required_fields:
-    - parent
-    - input_config
     long_running:
-      return_type: google.cloud.vision.v1p4beta1.ImportProductSetsResponse
-      metadata_type: google.cloud.vision.v1p4beta1.BatchOperationMetadata
       initial_poll_delay_millis: 20000
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 45000
       total_poll_timeout_millis: 86400000
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: location
-    timeout_millis: 60000
+
   # The fully qualified name of the API interface.
 - name: google.cloud.vision.v1p4beta1.ImageAnnotator
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections: []
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
   # Definition for retry/backoff parameters.
   retry_params_def:
   - name: default
@@ -440,164 +61,27 @@ interfaces:
   #
   #   name - The simple name of the method.
   #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
   #   retry_codes_name - Specifies the configuration for retryable codes. The
   #   name must be defined in interfaces.retry_codes_def.
   #
   #   retry_params_name - Specifies the configuration for retry/backoff
   #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
   methods:
   - name: BatchAnnotateImages
-    flattening:
-      groups:
-      - parameters:
-        - requests
-    required_fields:
-    - requests
-    retry_codes_name: non_idempotent
     retry_params_name: default
-    timeout_millis: 60000
   - name: BatchAnnotateFiles
-    flattening:
-      groups:
-      - parameters:
-        - requests
-    required_fields:
-    - requests
-    retry_codes_name: non_idempotent
     retry_params_name: default
-    timeout_millis: 60000
   - name: AsyncBatchAnnotateImages
-    flattening:
-      groups:
-      - parameters:
-        - requests
-        - output_config
-    required_fields:
-    - requests
-    - output_config
-    retry_codes_name: non_idempotent
     retry_params_name: default
     long_running:
-      return_type: google.cloud.vision.v1p4beta1.AsyncBatchAnnotateImagesResponse
-      metadata_type: google.cloud.vision.v1p4beta1.OperationMetadata
       initial_poll_delay_millis: 500
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 5000
       total_poll_timeout_millis: 300000
-    timeout_millis: 60000
   - name: AsyncBatchAnnotateFiles
-    flattening:
-      groups:
-      - parameters:
-        - requests
-    required_fields:
-    - requests
+    retry_params_name: default
     long_running:
-      return_type: google.cloud.vision.v1p4beta1.AsyncBatchAnnotateFilesResponse
-      metadata_type: google.cloud.vision.v1p4beta1.OperationMetadata
       initial_poll_delay_millis: 20000
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 45000
       total_poll_timeout_millis: 86400000
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-resource_name_generation:
-- message_name: CreateProductSetRequest
-  field_entity_map:
-    parent: location
-- message_name: ListProductSetsRequest
-  field_entity_map:
-    parent: location
-- message_name: GetProductSetRequest
-  field_entity_map:
-    name: product_set
-- message_name: UpdateProductSetRequest
-  field_entity_map:
-    product_set.name: product_set
-- message_name: DeleteProductSetRequest
-  field_entity_map:
-    name: product_set
-- message_name: CreateProductRequest
-  field_entity_map:
-    parent: location
-- message_name: ListProductsRequest
-  field_entity_map:
-    parent: location
-- message_name: GetProductRequest
-  field_entity_map:
-    name: product
-- message_name: UpdateProductRequest
-  field_entity_map:
-    product.name: product
-- message_name: DeleteProductRequest
-  field_entity_map:
-    name: product
-- message_name: CreateReferenceImageRequest
-  field_entity_map:
-    parent: product
-- message_name: DeleteReferenceImageRequest
-  field_entity_map:
-    name: reference_image
-- message_name: ListReferenceImagesRequest
-  field_entity_map:
-    parent: product
-- message_name: GetReferenceImageRequest
-  field_entity_map:
-    name: reference_image
-- message_name: AddProductToProductSetRequest
-  field_entity_map:
-    name: product_set
-- message_name: RemoveProductFromProductSetRequest
-  field_entity_map:
-    name: product_set
-- message_name: ListProductsInProductSetRequest
-  field_entity_map:
-    name: product_set
-- message_name: ImportProductSetsRequest
-  field_entity_map:
-    parent: location
diff --git a/third_party/googleapis/google/cloud/vision/v1p4beta1/vision_grpc_service_config.json b/third_party/googleapis/google/cloud/vision/v1p4beta1/vision_grpc_service_config.json
new file mode 100755
index 000000000..9f39156a2
--- /dev/null
+++ b/third_party/googleapis/google/cloud/vision/v1p4beta1/vision_grpc_service_config.json
@@ -0,0 +1,130 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.vision.v1p4beta1.ImageAnnotator",
+          "method": "BatchAnnotateImages"
+        },
+        {
+          "service": "google.cloud.vision.v1p4beta1.ImageAnnotator",
+          "method": "BatchAnnotateFiles"
+        },
+        {
+          "service": "google.cloud.vision.v1p4beta1.ImageAnnotator",
+          "method": "AsyncBatchAnnotateImages"
+        },
+        {
+          "service": "google.cloud.vision.v1p4beta1.ImageAnnotator",
+          "method": "AsyncBatchAnnotateFiles"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.vision.v1p4beta1.ProductSearch",
+          "method": "CreateProductSet"
+        },
+        {
+          "service": "google.cloud.vision.v1p4beta1.ProductSearch",
+          "method": "UpdateProductSet"
+        },
+        {
+          "service": "google.cloud.vision.v1p4beta1.ProductSearch",
+          "method": "CreateProduct"
+        },
+        {
+          "service": "google.cloud.vision.v1p4beta1.ProductSearch",
+          "method": "UpdateProduct"
+        },
+        {
+          "service": "google.cloud.vision.v1p4beta1.ProductSearch",
+          "method": "CreateReferenceImage"
+        },
+        {
+          "service": "google.cloud.vision.v1p4beta1.ProductSearch",
+          "method": "AddProductToProductSet"
+        },
+        {
+          "service": "google.cloud.vision.v1p4beta1.ProductSearch",
+          "method": "RemoveProductFromProductSet"
+        },
+        {
+          "service": "google.cloud.vision.v1p4beta1.ProductSearch",
+          "method": "ImportProductSets"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.vision.v1p4beta1.ProductSearch",
+          "method": "ListProductSets"
+        },
+        {
+          "service": "google.cloud.vision.v1p4beta1.ProductSearch",
+          "method": "GetProductSet"
+        },
+        {
+          "service": "google.cloud.vision.v1p4beta1.ProductSearch",
+          "method": "DeleteProductSet"
+        },
+        {
+          "service": "google.cloud.vision.v1p4beta1.ProductSearch",
+          "method": "ListProducts"
+        },
+        {
+          "service": "google.cloud.vision.v1p4beta1.ProductSearch",
+          "method": "GetProduct"
+        },
+        {
+          "service": "google.cloud.vision.v1p4beta1.ProductSearch",
+          "method": "DeleteProduct"
+        },
+        {
+          "service": "google.cloud.vision.v1p4beta1.ProductSearch",
+          "method": "DeleteReferenceImage"
+        },
+        {
+          "service": "google.cloud.vision.v1p4beta1.ProductSearch",
+          "method": "ListReferenceImages"
+        },
+        {
+          "service": "google.cloud.vision.v1p4beta1.ProductSearch",
+          "method": "GetReferenceImage"
+        },
+        {
+          "service": "google.cloud.vision.v1p4beta1.ProductSearch",
+          "method": "ListProductsInProductSet"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/vision/v1p4beta1/vision_v1p4beta1.yaml b/third_party/googleapis/google/cloud/vision/v1p4beta1/vision_v1p4beta1.yaml
new file mode 100644
index 000000000..d05e1af38
--- /dev/null
+++ b/third_party/googleapis/google/cloud/vision/v1p4beta1/vision_v1p4beta1.yaml
@@ -0,0 +1,41 @@
+type: google.api.Service
+config_version: 3
+name: vision.googleapis.com
+title: Cloud Vision API
+
+apis:
+- name: google.cloud.vision.v1p4beta1.ImageAnnotator
+- name: google.cloud.vision.v1p4beta1.ProductSearch
+
+types:
+- name: google.cloud.vision.v1p4beta1.AnnotateFileResponse
+- name: google.cloud.vision.v1p4beta1.AsyncBatchAnnotateFilesResponse
+- name: google.cloud.vision.v1p4beta1.AsyncBatchAnnotateImagesResponse
+- name: google.cloud.vision.v1p4beta1.BatchAnnotateFilesResponse
+- name: google.cloud.vision.v1p4beta1.BatchOperationMetadata
+- name: google.cloud.vision.v1p4beta1.ImportProductSetsResponse
+- name: google.cloud.vision.v1p4beta1.OperationMetadata
+
+documentation:
+  summary: |-
+    Integrates Google Vision features, including image labeling, face, logo,
+    and landmark detection, optical character recognition (OCR), and detection
+    of explicit content, into applications.
+
+authentication:
+  rules:
+  - selector: 'google.cloud.vision.v1p4beta1.ImageAnnotator.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-vision
+  - selector: 'google.cloud.vision.v1p4beta1.ProductSearch.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-vision
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-vision
diff --git a/third_party/googleapis/google/cloud/vision/v1p4beta1/web_detection.proto b/third_party/googleapis/google/cloud/vision/v1p4beta1/web_detection.proto
index 15822563b..446a937f1 100644
--- a/third_party/googleapis/google/cloud/vision/v1p4beta1/web_detection.proto
+++ b/third_party/googleapis/google/cloud/vision/v1p4beta1/web_detection.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -50,17 +50,6 @@ message WebDetection {
     float score = 2;
   }
 
-  // Label to provide extra metadata for the web detection.
-  message WebLabel {
-    // Label for extra metadata.
-    string label = 1;
-
-    // The BCP-47 language code for `label`, such as "en-US" or "sr-Latn".
-    // For more information, see
-    // http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
-    string language_code = 2;
-  }
-
   // Metadata for web pages.
   message WebPage {
     // The result web page URL.
@@ -83,6 +72,17 @@ message WebDetection {
     repeated WebImage partial_matching_images = 5;
   }
 
+  // Label to provide extra metadata for the web detection.
+  message WebLabel {
+    // Label for extra metadata.
+    string label = 1;
+
+    // The BCP-47 language code for `label`, such as "en-US" or "sr-Latn".
+    // For more information, see
+    // http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
+    string language_code = 2;
+  }
+
   // Deduced entities from similar images on the Internet.
   repeated WebEntity web_entities = 1;
 
diff --git a/third_party/googleapis/google/cloud/webrisk/artman_webrisk_v1beta1.yaml b/third_party/googleapis/google/cloud/webrisk/artman_webrisk_v1beta1.yaml
index 4e27f0413..47ac5d2c6 100644
--- a/third_party/googleapis/google/cloud/webrisk/artman_webrisk_v1beta1.yaml
+++ b/third_party/googleapis/google/cloud/webrisk/artman_webrisk_v1beta1.yaml
@@ -6,8 +6,9 @@ common:
     - name: google-common-protos
   src_proto_paths:
   - v1beta1
-  service_yaml: webrisk.yaml
+  service_yaml: v1beta1/webrisk_v1beta1.yaml
   gapic_yaml: v1beta1/webrisk_gapic.yaml
+  proto_package: google.cloud.webrisk.v1beta1
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/cloud/webrisk/v1/BUILD.bazel b/third_party/googleapis/google/cloud/webrisk/v1/BUILD.bazel
new file mode 100644
index 000000000..ea879bbae
--- /dev/null
+++ b/third_party/googleapis/google/cloud/webrisk/v1/BUILD.bazel
@@ -0,0 +1,358 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "webrisk_proto",
+    srcs = [
+        "webrisk.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "webrisk_proto_with_info",
+    deps = [
+        ":webrisk_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "webrisk_java_proto",
+    deps = [":webrisk_proto"],
+)
+
+java_grpc_library(
+    name = "webrisk_java_grpc",
+    srcs = [":webrisk_proto"],
+    deps = [":webrisk_java_proto"],
+)
+
+java_gapic_library(
+    name = "webrisk_java_gapic",
+    src = ":webrisk_proto_with_info",
+    gapic_yaml = "webrisk_gapic.yaml",
+    package = "google.cloud.webrisk.v1",
+    service_yaml = "webrisk_v1.yaml",
+    test_deps = [
+        ":webrisk_java_grpc",
+    ],
+    deps = [
+        ":webrisk_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "webrisk_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.webrisk.v1.WebRiskServiceClientTest",
+    ],
+    runtime_deps = [":webrisk_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-webrisk-v1-java",
+    deps = [
+        ":webrisk_java_gapic",
+        ":webrisk_java_grpc",
+        ":webrisk_java_proto",
+        ":webrisk_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "webrisk_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/webrisk/v1",
+    protos = [":webrisk_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "webrisk_go_gapic",
+    srcs = [":webrisk_proto_with_info"],
+    grpc_service_config = "webrisk_grpc_service_config.json",
+    importpath = "cloud.google.com/go/webrisk/apiv1;webrisk",
+    service_yaml = "webrisk_v1.yaml",
+    deps = [
+        ":webrisk_go_proto",
+    ],
+)
+
+go_test(
+    name = "webrisk_go_gapic_test",
+    srcs = [":webrisk_go_gapic_srcjar_test"],
+    embed = [":webrisk_go_gapic"],
+    importpath = "cloud.google.com/go/webrisk/apiv1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-webrisk-v1-go",
+    deps = [
+        ":webrisk_go_gapic",
+        ":webrisk_go_gapic_srcjar-test.srcjar",
+        ":webrisk_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "webrisk_moved_proto",
+    srcs = [":webrisk_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "webrisk_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":webrisk_moved_proto"],
+)
+
+py_grpc_library(
+    name = "webrisk_py_grpc",
+    srcs = [":webrisk_moved_proto"],
+    deps = [":webrisk_py_proto"],
+)
+
+py_gapic_library(
+    name = "webrisk_py_gapic",
+    src = ":webrisk_proto_with_info",
+    gapic_yaml = "webrisk_gapic.yaml",
+    package = "google.cloud.webrisk.v1",
+    service_yaml = "webrisk_v1.yaml",
+    deps = [
+        ":webrisk_py_grpc",
+        ":webrisk_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "webrisk-v1-py",
+    deps = [
+        ":webrisk_py_gapic",
+        ":webrisk_py_grpc",
+        ":webrisk_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "webrisk_php_proto",
+    deps = [":webrisk_proto"],
+)
+
+php_grpc_library(
+    name = "webrisk_php_grpc",
+    srcs = [":webrisk_proto"],
+    deps = [":webrisk_php_proto"],
+)
+
+php_gapic_library(
+    name = "webrisk_php_gapic",
+    src = ":webrisk_proto_with_info",
+    gapic_yaml = "webrisk_gapic.yaml",
+    package = "google.cloud.webrisk.v1",
+    service_yaml = "webrisk_v1.yaml",
+    deps = [
+        ":webrisk_php_grpc",
+        ":webrisk_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-webrisk-v1-php",
+    deps = [
+        ":webrisk_php_gapic",
+        ":webrisk_php_grpc",
+        ":webrisk_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "webrisk_nodejs_gapic",
+    src = ":webrisk_proto_with_info",
+    gapic_yaml = "webrisk_gapic.yaml",
+    package = "google.cloud.webrisk.v1",
+    service_yaml = "webrisk_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "webrisk-v1-nodejs",
+    deps = [
+        ":webrisk_nodejs_gapic",
+        ":webrisk_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "webrisk_ruby_proto",
+    deps = [":webrisk_proto"],
+)
+
+ruby_grpc_library(
+    name = "webrisk_ruby_grpc",
+    srcs = [":webrisk_proto"],
+    deps = [":webrisk_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "webrisk_ruby_gapic",
+    src = ":webrisk_proto_with_info",
+    gapic_yaml = "webrisk_gapic.yaml",
+    package = "google.cloud.webrisk.v1",
+    service_yaml = "webrisk_v1.yaml",
+    deps = [
+        ":webrisk_ruby_grpc",
+        ":webrisk_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-webrisk-v1-ruby",
+    deps = [
+        ":webrisk_ruby_gapic",
+        ":webrisk_ruby_grpc",
+        ":webrisk_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "webrisk_csharp_proto",
+    deps = [":webrisk_proto"],
+)
+
+csharp_grpc_library(
+    name = "webrisk_csharp_grpc",
+    srcs = [":webrisk_proto"],
+    deps = [":webrisk_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "webrisk_csharp_gapic",
+    src = ":webrisk_proto_with_info",
+    gapic_yaml = "webrisk_gapic.yaml",
+    package = "google.cloud.webrisk.v1",
+    service_yaml = "webrisk_v1.yaml",
+    deps = [
+        ":webrisk_csharp_grpc",
+        ":webrisk_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-webrisk-v1-csharp",
+    deps = [
+        ":webrisk_csharp_gapic",
+        ":webrisk_csharp_grpc",
+        ":webrisk_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/webrisk/v1/webrisk.proto b/third_party/googleapis/google/cloud/webrisk/v1/webrisk.proto
new file mode 100644
index 000000000..71b6b44f7
--- /dev/null
+++ b/third_party/googleapis/google/cloud/webrisk/v1/webrisk.proto
@@ -0,0 +1,353 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.webrisk.v1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "Google.Cloud.WebRisk.V1";
+option go_package = "google.golang.org/genproto/googleapis/cloud/webrisk/v1;webrisk";
+option java_multiple_files = true;
+option java_outer_classname = "WebRiskProto";
+option java_package = "com.google.webrisk.v1";
+option objc_class_prefix = "GCWR";
+option php_namespace = "Google\\Cloud\\WebRisk\\V1";
+option ruby_package = "Google::Cloud::WebRisk::V1";
+
+// Web Risk API defines an interface to detect malicious URLs on your
+// website and in client applications.
+service WebRiskService {
+  option (google.api.default_host) = "webrisk.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // Gets the most recent threat list diffs. These diffs should be applied to
+  // a local database of hashes to keep it up-to-date. If the local database is
+  // empty or excessively out-of-date, a complete snapshot of the database will
+  // be returned. This Method only updates a single ThreatList at a time. To
+  // update multiple ThreatList databases, this method needs to be called once
+  // for each list.
+  rpc ComputeThreatListDiff(ComputeThreatListDiffRequest) returns (ComputeThreatListDiffResponse) {
+    option (google.api.http) = {
+      get: "/v1/threatLists:computeDiff"
+    };
+    option (google.api.method_signature) = "threat_type,version_token,constraints";
+  }
+
+  // This method is used to check whether a URI is on a given threatList.
+  // Multiple threatLists may be searched in a single query.
+  // The response will list all requested threatLists the URI was found to
+  // match. If the URI is not found on any of the requested ThreatList an
+  // empty response will be returned.
+  rpc SearchUris(SearchUrisRequest) returns (SearchUrisResponse) {
+    option (google.api.http) = {
+      get: "/v1/uris:search"
+    };
+    option (google.api.method_signature) = "uri,threat_types";
+  }
+
+  // Gets the full hashes that match the requested hash prefix.
+  // This is used after a hash prefix is looked up in a threatList
+  // and there is a match. The client side threatList only holds partial hashes
+  // so the client must query this method to determine if there is a full
+  // hash match of a threat.
+  rpc SearchHashes(SearchHashesRequest) returns (SearchHashesResponse) {
+    option (google.api.http) = {
+      get: "/v1/hashes:search"
+    };
+    option (google.api.method_signature) = "hash_prefix,threat_types";
+  }
+
+  // Creates a Submission of a URI suspected of containing phishing content to
+  // be reviewed. If the result verifies the existence of malicious phishing
+  // content, the site will be added to the [Google's Social Engineering
+  // lists](https://support.google.com/webmasters/answer/6350487/) in order to
+  // protect users that could get exposed to this threat in the future. Only
+  // projects with CREATE_SUBMISSION_USERS visibility can use this method.
+  rpc CreateSubmission(CreateSubmissionRequest) returns (Submission) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*}/submissions"
+      body: "submission"
+    };
+    option (google.api.method_signature) = "parent,submission";
+  }
+}
+
+// Describes an API diff request.
+message ComputeThreatListDiffRequest {
+  // The constraints for this diff.
+  message Constraints {
+    // The maximum size in number of entries. The diff will not contain more
+    // entries than this value.  This should be a power of 2 between 2**10 and
+    // 2**20.  If zero, no diff size limit is set.
+    int32 max_diff_entries = 1;
+
+    // Sets the maximum number of entries that the client is willing to have
+    // in the local database. This should be a power of 2 between 2**10 and
+    // 2**20. If zero, no database size limit is set.
+    int32 max_database_entries = 2;
+
+    // The compression types supported by the client.
+    repeated CompressionType supported_compressions = 3;
+  }
+
+  // Required. The threat list to update. Only a single ThreatType should be specified.
+  ThreatType threat_type = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // The current version token of the client for the requested list (the
+  // client version that was received from the last successful diff).
+  // If the client does not have a version token (this is the first time calling
+  // ComputeThreatListDiff), this may be left empty and a full database
+  // snapshot will be returned.
+  bytes version_token = 2;
+
+  // Required. The constraints associated with this request.
+  Constraints constraints = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+message ComputeThreatListDiffResponse {
+  // The expected state of a client's local database.
+  message Checksum {
+    // The SHA256 hash of the client state; that is, of the sorted list of all
+    // hashes present in the database.
+    bytes sha256 = 1;
+  }
+
+  // The type of response sent to the client.
+  enum ResponseType {
+    // Unknown.
+    RESPONSE_TYPE_UNSPECIFIED = 0;
+
+    // Partial updates are applied to the client's existing local database.
+    DIFF = 1;
+
+    // Full updates resets the client's entire local database. This means
+    // that either the client had no state, was seriously out-of-date,
+    // or the client is believed to be corrupt.
+    RESET = 2;
+  }
+
+  // The type of response. This may indicate that an action must be taken by the
+  // client when the response is received.
+  ResponseType response_type = 4;
+
+  // A set of entries to add to a local threat type's list.
+  ThreatEntryAdditions additions = 5;
+
+  // A set of entries to remove from a local threat type's list.
+  // This field may be empty.
+  ThreatEntryRemovals removals = 6;
+
+  // The new opaque client version token. This should be retained by the client
+  // and passed into the next call of ComputeThreatListDiff as 'version_token'.
+  // A separate version token should be stored and used for each threatList.
+  bytes new_version_token = 7;
+
+  // The expected SHA256 hash of the client state; that is, of the sorted list
+  // of all hashes present in the database after applying the provided diff.
+  // If the client state doesn't match the expected state, the client must
+  // discard this diff and retry later.
+  Checksum checksum = 8;
+
+  // The soonest the client should wait before issuing any diff
+  // request. Querying sooner is unlikely to produce a meaningful diff.
+  // Waiting longer is acceptable considering the use case.
+  // If this field is not set clients may update as soon as they want.
+  google.protobuf.Timestamp recommended_next_diff = 2;
+}
+
+// Request to check URI entries against threatLists.
+message SearchUrisRequest {
+  // Required. The URI to be checked for matches.
+  string uri = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The ThreatLists to search in. Multiple ThreatLists may be specified.
+  repeated ThreatType threat_types = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+message SearchUrisResponse {
+  // Contains threat information on a matching uri.
+  message ThreatUri {
+    // The ThreatList this threat belongs to.
+    repeated ThreatType threat_types = 1;
+
+    // The cache lifetime for the returned match. Clients must not cache this
+    // response past this timestamp to avoid false positives.
+    google.protobuf.Timestamp expire_time = 2;
+  }
+
+  // The threat list matches. This may be empty if the URI is on no list.
+  ThreatUri threat = 1;
+}
+
+// Request to return full hashes matched by the provided hash prefixes.
+message SearchHashesRequest {
+  // A hash prefix, consisting of the most significant 4-32 bytes of a SHA256
+  // hash. For JSON requests, this field is base64-encoded.
+  bytes hash_prefix = 1;
+
+  // Required. The ThreatLists to search in. Multiple ThreatLists may be specified.
+  repeated ThreatType threat_types = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+message SearchHashesResponse {
+  // Contains threat information on a matching hash.
+  message ThreatHash {
+    // The ThreatList this threat belongs to.
+    // This must contain at least one entry.
+    repeated ThreatType threat_types = 1;
+
+    // A 32 byte SHA256 hash. This field is in binary format. For JSON
+    // requests, hashes are base64-encoded.
+    bytes hash = 2;
+
+    // The cache lifetime for the returned match. Clients must not cache this
+    // response past this timestamp to avoid false positives.
+    google.protobuf.Timestamp expire_time = 3;
+  }
+
+  // The full hashes that matched the requested prefixes.
+  // The hash will be populated in the key.
+  repeated ThreatHash threats = 1;
+
+  // For requested entities that did not match the threat list, how long to
+  // cache the response until.
+  google.protobuf.Timestamp negative_expire_time = 2;
+}
+
+// Contains the set of entries to add to a local database.
+// May contain a combination of compressed and raw data in a single response.
+message ThreatEntryAdditions {
+  // The raw SHA256-formatted entries.
+  // Repeated to allow returning sets of hashes with different prefix sizes.
+  repeated RawHashes raw_hashes = 1;
+
+  // The encoded 4-byte prefixes of SHA256-formatted entries, using a
+  // Golomb-Rice encoding. The hashes are converted to uint32, sorted in
+  // ascending order, then delta encoded and stored as encoded_data.
+  RiceDeltaEncoding rice_hashes = 2;
+}
+
+// Contains the set of entries to remove from a local database.
+message ThreatEntryRemovals {
+  // The raw removal indices for a local list.
+  RawIndices raw_indices = 1;
+
+  // The encoded local, lexicographically-sorted list indices, using a
+  // Golomb-Rice encoding. Used for sending compressed removal indices. The
+  // removal indices (uint32) are sorted in ascending order, then delta encoded
+  // and stored as encoded_data.
+  RiceDeltaEncoding rice_indices = 2;
+}
+
+// The type of threat. This maps dirrectly to the threat list a threat may
+// belong to.
+enum ThreatType {
+  // Unknown.
+  THREAT_TYPE_UNSPECIFIED = 0;
+
+  // Malware targeting any platform.
+  MALWARE = 1;
+
+  // Social engineering targeting any platform.
+  SOCIAL_ENGINEERING = 2;
+
+  // Unwanted software targeting any platform.
+  UNWANTED_SOFTWARE = 3;
+}
+
+// The ways in which threat entry sets can be compressed.
+enum CompressionType {
+  // Unknown.
+  COMPRESSION_TYPE_UNSPECIFIED = 0;
+
+  // Raw, uncompressed data.
+  RAW = 1;
+
+  // Rice-Golomb encoded data.
+  RICE = 2;
+}
+
+// A set of raw indices to remove from a local list.
+message RawIndices {
+  // The indices to remove from a lexicographically-sorted local list.
+  repeated int32 indices = 1;
+}
+
+// The uncompressed threat entries in hash format.
+// Hashes can be anywhere from 4 to 32 bytes in size. A large majority are 4
+// bytes, but some hashes are lengthened if they collide with the hash of a
+// popular URI.
+//
+// Used for sending ThreatEntryAdditons to clients that do not support
+// compression, or when sending non-4-byte hashes to clients that do support
+// compression.
+message RawHashes {
+  // The number of bytes for each prefix encoded below.  This field can be
+  // anywhere from 4 (shortest prefix) to 32 (full SHA256 hash).
+  // In practice this is almost always 4, except in exceptional circumstances.
+  int32 prefix_size = 1;
+
+  // The hashes, in binary format, concatenated into one long string. Hashes are
+  // sorted in lexicographic order. For JSON API users, hashes are
+  // base64-encoded.
+  bytes raw_hashes = 2;
+}
+
+// The Rice-Golomb encoded data. Used for sending compressed 4-byte hashes or
+// compressed removal indices.
+message RiceDeltaEncoding {
+  // The offset of the first entry in the encoded data, or, if only a single
+  // integer was encoded, that single integer's value. If the field is empty or
+  // missing, assume zero.
+  int64 first_value = 1;
+
+  // The Golomb-Rice parameter, which is a number between 2 and 28. This field
+  // is missing (that is, zero) if `num_entries` is zero.
+  int32 rice_parameter = 2;
+
+  // The number of entries that are delta encoded in the encoded data. If only a
+  // single integer was encoded, this will be zero and the single value will be
+  // stored in `first_value`.
+  int32 entry_count = 3;
+
+  // The encoded deltas that are encoded using the Golomb-Rice coder.
+  bytes encoded_data = 4;
+}
+
+// Wraps a URI that might be displaying phishing content.
+message Submission {
+  // Required. The URI that is being reported for phishing content to be analyzed.
+  string uri = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request to send a potentially phishy URI to WebRisk.
+message CreateSubmissionRequest {
+  // Required. The name of the project that is making the submission. This string is in
+  // the format "projects/{project_number}".
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
+
+  // Required. The submission that contains the content of the phishing report.
+  Submission submission = 2 [(google.api.field_behavior) = REQUIRED];
+}
diff --git a/third_party/googleapis/google/cloud/webrisk/v1/webrisk_gapic.yaml b/third_party/googleapis/google/cloud/webrisk/v1/webrisk_gapic.yaml
new file mode 100644
index 000000000..c12da8e30
--- /dev/null
+++ b/third_party/googleapis/google/cloud/webrisk/v1/webrisk_gapic.yaml
@@ -0,0 +1,19 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 2.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.webrisk.v1
+  python:
+    package_name: google.cloud.webrisk_v1.gapic
+  go:
+    package_name: cloud.google.com/go/webrisk/apiv1
+  csharp:
+    package_name: Google.Cloud.WebRisk.V1
+  ruby:
+    package_name: Google::Cloud::Webrisk::V1
+  php:
+    package_name: Google\Cloud\WebRisk\V1
+  nodejs:
+    package_name: web-risk.v1
+    domain_layer_location: google-cloud
diff --git a/third_party/googleapis/google/cloud/webrisk/v1/webrisk_grpc_service_config.json b/third_party/googleapis/google/cloud/webrisk/v1/webrisk_grpc_service_config.json
new file mode 100755
index 000000000..3e1707929
--- /dev/null
+++ b/third_party/googleapis/google/cloud/webrisk/v1/webrisk_grpc_service_config.json
@@ -0,0 +1,30 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.webrisk.v1.WebRiskService",
+          "method": "ComputeThreatListDiff"
+        },
+        {
+          "service": "google.cloud.webrisk.v1.WebRiskService",
+          "method": "SearchUris"
+        },
+        {
+          "service": "google.cloud.webrisk.v1.WebRiskService",
+          "method": "SearchHashes"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/webrisk/webrisk.yaml b/third_party/googleapis/google/cloud/webrisk/v1/webrisk_v1.yaml
similarity index 67%
rename from third_party/googleapis/google/cloud/webrisk/webrisk.yaml
rename to third_party/googleapis/google/cloud/webrisk/v1/webrisk_v1.yaml
index f43119679..cfb85a603 100644
--- a/third_party/googleapis/google/cloud/webrisk/webrisk.yaml
+++ b/third_party/googleapis/google/cloud/webrisk/v1/webrisk_v1.yaml
@@ -4,11 +4,11 @@ name: webrisk.googleapis.com
 title: Web Risk API
 
 apis:
-  - name: google.cloud.webrisk.v1beta1.WebRiskServiceV1Beta1
+- name: google.cloud.webrisk.v1.WebRiskService
 
 authentication:
   rules:
-  - selector: '*'
+  - selector: 'google.cloud.webrisk.v1.WebRiskService.*'
     oauth:
       canonical_scopes: |-
         https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/webrisk/v1beta1/BUILD.bazel b/third_party/googleapis/google/cloud/webrisk/v1beta1/BUILD.bazel
new file mode 100644
index 000000000..a42686c83
--- /dev/null
+++ b/third_party/googleapis/google/cloud/webrisk/v1beta1/BUILD.bazel
@@ -0,0 +1,356 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "webrisk_proto",
+    srcs = [
+        "webrisk.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "webrisk_proto_with_info",
+    deps = [
+        ":webrisk_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "webrisk_java_proto",
+    deps = [":webrisk_proto"],
+)
+
+java_grpc_library(
+    name = "webrisk_java_grpc",
+    srcs = [":webrisk_proto"],
+    deps = [":webrisk_java_proto"],
+)
+
+java_gapic_library(
+    name = "webrisk_java_gapic",
+    src = ":webrisk_proto_with_info",
+    gapic_yaml = "webrisk_gapic.yaml",
+    package = "google.cloud.webrisk.v1beta1",
+    service_yaml = "webrisk_v1beta1.yaml",
+    test_deps = [
+        ":webrisk_java_grpc",
+    ],
+    deps = [
+        ":webrisk_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "webrisk_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.webrisk.v1beta1.WebRiskServiceV1Beta1ClientTest",
+    ],
+    runtime_deps = [":webrisk_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-webrisk-v1beta1-java",
+    deps = [
+        ":webrisk_java_gapic",
+        ":webrisk_java_grpc",
+        ":webrisk_java_proto",
+        ":webrisk_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "webrisk_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/webrisk/v1beta1",
+    protos = [":webrisk_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "webrisk_go_gapic",
+    srcs = [":webrisk_proto_with_info"],
+    grpc_service_config = "webrisk_grpc_service_config.json",
+    importpath = "cloud.google.com/go/webrisk/apiv1beta1;webrisk",
+    service_yaml = "webrisk_v1beta1.yaml",
+    deps = [
+        ":webrisk_go_proto",
+    ],
+)
+
+go_test(
+    name = "webrisk_go_gapic_test",
+    srcs = [":webrisk_go_gapic_srcjar_test"],
+    embed = [":webrisk_go_gapic"],
+    importpath = "cloud.google.com/go/webrisk/apiv1beta1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-webrisk-v1beta1-go",
+    deps = [
+        ":webrisk_go_gapic",
+        ":webrisk_go_gapic_srcjar-test.srcjar",
+        ":webrisk_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "webrisk_moved_proto",
+    srcs = [":webrisk_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "webrisk_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":webrisk_moved_proto"],
+)
+
+py_grpc_library(
+    name = "webrisk_py_grpc",
+    srcs = [":webrisk_moved_proto"],
+    deps = [":webrisk_py_proto"],
+)
+
+py_gapic_library(
+    name = "webrisk_py_gapic",
+    src = ":webrisk_proto_with_info",
+    gapic_yaml = "webrisk_gapic.yaml",
+    package = "google.cloud.webrisk.v1beta1",
+    service_yaml = "webrisk_v1beta1.yaml",
+    deps = [
+        ":webrisk_py_grpc",
+        ":webrisk_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "webrisk-v1beta1-py",
+    deps = [
+        ":webrisk_py_gapic",
+        ":webrisk_py_grpc",
+        ":webrisk_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "webrisk_php_proto",
+    deps = [":webrisk_proto"],
+)
+
+php_grpc_library(
+    name = "webrisk_php_grpc",
+    srcs = [":webrisk_proto"],
+    deps = [":webrisk_php_proto"],
+)
+
+php_gapic_library(
+    name = "webrisk_php_gapic",
+    src = ":webrisk_proto_with_info",
+    gapic_yaml = "webrisk_gapic.yaml",
+    package = "google.cloud.webrisk.v1beta1",
+    service_yaml = "webrisk_v1beta1.yaml",
+    deps = [
+        ":webrisk_php_grpc",
+        ":webrisk_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-webrisk-v1beta1-php",
+    deps = [
+        ":webrisk_php_gapic",
+        ":webrisk_php_grpc",
+        ":webrisk_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "webrisk_nodejs_gapic",
+    src = ":webrisk_proto_with_info",
+    gapic_yaml = "webrisk_gapic.yaml",
+    package = "google.cloud.webrisk.v1beta1",
+    service_yaml = "webrisk_v1beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "webrisk-v1beta1-nodejs",
+    deps = [
+        ":webrisk_nodejs_gapic",
+        ":webrisk_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "webrisk_ruby_proto",
+    deps = [":webrisk_proto"],
+)
+
+ruby_grpc_library(
+    name = "webrisk_ruby_grpc",
+    srcs = [":webrisk_proto"],
+    deps = [":webrisk_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "webrisk_ruby_gapic",
+    src = ":webrisk_proto_with_info",
+    gapic_yaml = "webrisk_gapic.yaml",
+    package = "google.cloud.webrisk.v1beta1",
+    service_yaml = "webrisk_v1beta1.yaml",
+    deps = [
+        ":webrisk_ruby_grpc",
+        ":webrisk_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-webrisk-v1beta1-ruby",
+    deps = [
+        ":webrisk_ruby_gapic",
+        ":webrisk_ruby_grpc",
+        ":webrisk_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "webrisk_csharp_proto",
+    deps = [":webrisk_proto"],
+)
+
+csharp_grpc_library(
+    name = "webrisk_csharp_grpc",
+    srcs = [":webrisk_proto"],
+    deps = [":webrisk_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "webrisk_csharp_gapic",
+    src = ":webrisk_proto_with_info",
+    gapic_yaml = "webrisk_gapic.yaml",
+    package = "google.cloud.webrisk.v1beta1",
+    service_yaml = "webrisk_v1beta1.yaml",
+    deps = [
+        ":webrisk_csharp_grpc",
+        ":webrisk_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-webrisk-v1beta1-csharp",
+    deps = [
+        ":webrisk_csharp_gapic",
+        ":webrisk_csharp_grpc",
+        ":webrisk_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/webrisk/v1beta1/webrisk.proto b/third_party/googleapis/google/cloud/webrisk/v1beta1/webrisk.proto
index c6b5f7c90..02264252f 100644
--- a/third_party/googleapis/google/cloud/webrisk/v1beta1/webrisk.proto
+++ b/third_party/googleapis/google/cloud/webrisk/v1beta1/webrisk.proto
@@ -18,6 +18,8 @@ syntax = "proto3";
 package google.cloud.webrisk.v1beta1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/protobuf/timestamp.proto";
 
 option csharp_namespace = "Google.Cloud.WebRisk.V1Beta1";
@@ -27,16 +29,20 @@ option java_outer_classname = "WebRiskProto";
 option java_package = "com.google.webrisk.v1beta1";
 option objc_class_prefix = "GCWR";
 option php_namespace = "Google\\Cloud\\WebRisk\\V1beta1";
+option ruby_package = "Google::Cloud::WebRisk::V1beta1";
 
 // Web Risk v1beta1 API defines an interface to detect malicious URLs on your
 // website and in client applications.
 service WebRiskServiceV1Beta1 {
+  option (google.api.default_host) = "webrisk.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Gets the most recent threat list diffs.
-  rpc ComputeThreatListDiff(ComputeThreatListDiffRequest)
-      returns (ComputeThreatListDiffResponse) {
+  rpc ComputeThreatListDiff(ComputeThreatListDiffRequest) returns (ComputeThreatListDiffResponse) {
     option (google.api.http) = {
       get: "/v1beta1/threatLists:computeDiff"
     };
+    option (google.api.method_signature) = "threat_type,version_token,constraints";
   }
 
   // This method is used to check whether a URI is on a given threatList.
@@ -44,6 +50,7 @@ service WebRiskServiceV1Beta1 {
     option (google.api.http) = {
       get: "/v1beta1/uris:search"
     };
+    option (google.api.method_signature) = "uri,threat_types";
   }
 
   // Gets the full hashes that match the requested hash prefix.
@@ -55,6 +62,7 @@ service WebRiskServiceV1Beta1 {
     option (google.api.http) = {
       get: "/v1beta1/hashes:search"
     };
+    option (google.api.method_signature) = "hash_prefix,threat_types";
   }
 }
 
@@ -76,15 +84,15 @@ message ComputeThreatListDiffRequest {
     repeated CompressionType supported_compressions = 3;
   }
 
-  // Required. The ThreatList to update.
-  ThreatType threat_type = 1;
+  // The ThreatList to update.
+  ThreatType threat_type = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The current version token of the client for the requested list (the
   // client version that was received from the last successful diff).
   bytes version_token = 2;
 
-  // The constraints associated with this request.
-  Constraints constraints = 3;
+  // Required. The constraints associated with this request.
+  Constraints constraints = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 message ComputeThreatListDiffResponse {
@@ -109,7 +117,7 @@ message ComputeThreatListDiffResponse {
     RESET = 2;
   }
 
-  // The type of response. This may indicate that an action is required by the
+  // The type of response. This may indicate that an action must be taken by the
   // client when the response is received.
   ResponseType response_type = 4;
 
@@ -138,11 +146,11 @@ message ComputeThreatListDiffResponse {
 
 // Request to check URI entries against threatLists.
 message SearchUrisRequest {
-  // The URI to be checked for matches.
-  string uri = 1;
+  // Required. The URI to be checked for matches.
+  string uri = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Required. The ThreatLists to search in.
-  repeated ThreatType threat_types = 2;
+  repeated ThreatType threat_types = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 message SearchUrisResponse {
@@ -167,7 +175,7 @@ message SearchHashesRequest {
   bytes hash_prefix = 1;
 
   // Required. The ThreatLists to search in.
-  repeated ThreatType threat_types = 2;
+  repeated ThreatType threat_types = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 message SearchHashesResponse {
diff --git a/third_party/googleapis/google/cloud/webrisk/v1beta1/webrisk_gapic.legacy.yaml b/third_party/googleapis/google/cloud/webrisk/v1beta1/webrisk_gapic.legacy.yaml
new file mode 100644
index 000000000..f9be3b286
--- /dev/null
+++ b/third_party/googleapis/google/cloud/webrisk/v1beta1/webrisk_gapic.legacy.yaml
@@ -0,0 +1,142 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.webrisk.v1beta1
+  python:
+    package_name: google.cloud.webrisk_v1beta1.gapic
+  go:
+    package_name: cloud.google.com/go/webrisk/apiv1beta1
+  csharp:
+    package_name: Google.Cloud.WebRisk.V1Beta1
+  ruby:
+    package_name: Google::Cloud::Webrisk::V1beta1
+  php:
+    package_name: Google\Cloud\WebRisk\V1beta1
+  nodejs:
+    package_name: web-risk.v1beta1
+    domain_layer_location: google-cloud
+# A list of API interface configurations.
+interfaces:
+- name: google.cloud.webrisk.v1beta1.WebRiskServiceV1Beta1
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections: []
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ComputeThreatListDiff
+    flattening:
+      groups:
+      - parameters:
+        - threat_type
+        - version_token
+        - constraints
+    required_fields:
+    - threat_type
+    - constraints
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: SearchUris
+    flattening:
+      groups:
+      - parameters:
+        - uri
+        - threat_types
+    required_fields:
+    - uri
+    - threat_types
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: SearchHashes
+    flattening:
+      groups:
+      - parameters:
+        - hash_prefix
+        - threat_types
+    required_fields:
+    - threat_types
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/webrisk/v1beta1/webrisk_gapic.yaml b/third_party/googleapis/google/cloud/webrisk/v1beta1/webrisk_gapic.yaml
index 4c6d77dd7..6f2b55c66 100644
--- a/third_party/googleapis/google/cloud/webrisk/v1beta1/webrisk_gapic.yaml
+++ b/third_party/googleapis/google/cloud/webrisk/v1beta1/webrisk_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -17,125 +17,3 @@ language_settings:
   nodejs:
     package_name: web-risk.v1beta1
     domain_layer_location: google-cloud
-# A list of API interface configurations.
-interfaces:
-  # The fully qualified name of the API interface.
-- name: google.cloud.webrisk.v1beta1.WebRiskServiceV1Beta1
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections: []
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
-  methods:
-  - name: ComputeThreatListDiff
-    flattening:
-      groups:
-      - parameters:
-        - threat_type
-        - version_token
-        - constraints
-    required_fields:
-    - threat_type
-    - constraints
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-  - name: SearchUris
-    flattening:
-      groups:
-      - parameters:
-        - uri
-        - threat_types
-    required_fields:
-    - uri
-    - threat_types
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-  - name: SearchHashes
-    flattening:
-      groups:
-      - parameters:
-        - hash_prefix
-        - threat_types
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/webrisk/v1beta1/webrisk_grpc_service_config.json b/third_party/googleapis/google/cloud/webrisk/v1beta1/webrisk_grpc_service_config.json
new file mode 100755
index 000000000..497927970
--- /dev/null
+++ b/third_party/googleapis/google/cloud/webrisk/v1beta1/webrisk_grpc_service_config.json
@@ -0,0 +1,30 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.webrisk.v1beta1.WebRiskServiceV1Beta1",
+          "method": "ComputeThreatListDiff"
+        },
+        {
+          "service": "google.cloud.webrisk.v1beta1.WebRiskServiceV1Beta1",
+          "method": "SearchUris"
+        },
+        {
+          "service": "google.cloud.webrisk.v1beta1.WebRiskServiceV1Beta1",
+          "method": "SearchHashes"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/webrisk/v1beta1/webrisk_v1beta1.yaml b/third_party/googleapis/google/cloud/webrisk/v1beta1/webrisk_v1beta1.yaml
new file mode 100644
index 000000000..d9891ccb9
--- /dev/null
+++ b/third_party/googleapis/google/cloud/webrisk/v1beta1/webrisk_v1beta1.yaml
@@ -0,0 +1,14 @@
+type: google.api.Service
+config_version: 3
+name: webrisk.googleapis.com
+title: Web Risk API
+
+apis:
+- name: google.cloud.webrisk.v1beta1.WebRiskServiceV1Beta1
+
+authentication:
+  rules:
+  - selector: 'google.cloud.webrisk.v1beta1.WebRiskServiceV1Beta1.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/BUILD.bazel b/third_party/googleapis/google/cloud/websecurityscanner/BUILD.bazel
index 1e5b8c2af..a87c57fec 100644
--- a/third_party/googleapis/google/cloud/websecurityscanner/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/websecurityscanner/BUILD.bazel
@@ -1 +1 @@
-exports_files(glob(["*.yaml"]))
\ No newline at end of file
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/artman_websecurityscanner_v1alpha.yaml b/third_party/googleapis/google/cloud/websecurityscanner/artman_websecurityscanner_v1alpha.yaml
index 31dceecef..29f59a4bb 100644
--- a/third_party/googleapis/google/cloud/websecurityscanner/artman_websecurityscanner_v1alpha.yaml
+++ b/third_party/googleapis/google/cloud/websecurityscanner/artman_websecurityscanner_v1alpha.yaml
@@ -6,8 +6,9 @@ common:
     - name: google-common-protos
   src_proto_paths:
   - v1alpha
-  service_yaml: web_security_scanner_v1alpha.yaml
+  service_yaml: v1alpha/websecurityscanner_v1alpha.yaml
   gapic_yaml: v1alpha/websecurityscanner_gapic.yaml
+  proto_package: google.cloud.websecurityscanner.v1alpha
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/artman_websecurityscanner_v1beta.yaml b/third_party/googleapis/google/cloud/websecurityscanner/artman_websecurityscanner_v1beta.yaml
index 130084151..34720f709 100644
--- a/third_party/googleapis/google/cloud/websecurityscanner/artman_websecurityscanner_v1beta.yaml
+++ b/third_party/googleapis/google/cloud/websecurityscanner/artman_websecurityscanner_v1beta.yaml
@@ -6,8 +6,9 @@ common:
   - name: google-common-protos
   src_proto_paths:
   - v1beta
-  service_yaml: websecurityscanner_v1beta.yaml
+  service_yaml: v1beta/websecurityscanner_v1beta.yaml
   gapic_yaml: v1beta/websecurityscanner_gapic.yaml
+  proto_package: google.cloud.websecurityscanner.v1beta
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1/BUILD.bazel b/third_party/googleapis/google/cloud/websecurityscanner/v1/BUILD.bazel
new file mode 100644
index 000000000..292f3d473
--- /dev/null
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1/BUILD.bazel
@@ -0,0 +1,371 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "websecurityscanner_proto",
+    srcs = [
+        "crawled_url.proto",
+        "finding.proto",
+        "finding_addon.proto",
+        "finding_type_stats.proto",
+        "scan_config.proto",
+        "scan_config_error.proto",
+        "scan_run.proto",
+        "scan_run_error_trace.proto",
+        "scan_run_warning_trace.proto",
+        "web_security_scanner.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "websecurityscanner_proto_with_info",
+    deps = [
+        ":websecurityscanner_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "websecurityscanner_java_proto",
+    deps = [":websecurityscanner_proto"],
+)
+
+java_grpc_library(
+    name = "websecurityscanner_java_grpc",
+    srcs = [":websecurityscanner_proto"],
+    deps = [":websecurityscanner_java_proto"],
+)
+
+java_gapic_library(
+    name = "websecurityscanner_java_gapic",
+    src = ":websecurityscanner_proto_with_info",
+    gapic_yaml = "websecurityscanner_gapic.yaml",
+    package = "google.cloud.websecurityscanner.v1",
+    service_yaml = "websecurityscanner_v1.yaml",
+    test_deps = [
+        ":websecurityscanner_java_grpc",
+    ],
+    deps = [
+        ":websecurityscanner_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "websecurityscanner_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.websecurityscanner.v1.WebSecurityScannerClientTest",
+    ],
+    runtime_deps = [":websecurityscanner_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-websecurityscanner-v1-java",
+    deps = [
+        ":websecurityscanner_java_gapic",
+        ":websecurityscanner_java_grpc",
+        ":websecurityscanner_java_proto",
+        ":websecurityscanner_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "websecurityscanner_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1",
+    protos = [":websecurityscanner_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "websecurityscanner_go_gapic",
+    srcs = [":websecurityscanner_proto_with_info"],
+    grpc_service_config = "websecurityscanner_grpc_service_config.json",
+    importpath = "cloud.google.com/go/websecurityscanner/apiv1;websecurityscanner",
+    service_yaml = "websecurityscanner_v1.yaml",
+    deps = [
+        ":websecurityscanner_go_proto",
+    ],
+)
+
+go_test(
+    name = "websecurityscanner_go_gapic_test",
+    srcs = [":websecurityscanner_go_gapic_srcjar_test"],
+    embed = [":websecurityscanner_go_gapic"],
+    importpath = "cloud.google.com/go/websecurityscanner/apiv1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-websecurityscanner-v1-go",
+    deps = [
+        ":websecurityscanner_go_gapic",
+        ":websecurityscanner_go_gapic_srcjar-test.srcjar",
+        ":websecurityscanner_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "websecurityscanner_moved_proto",
+    srcs = [":websecurityscanner_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "websecurityscanner_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":websecurityscanner_moved_proto"],
+)
+
+py_grpc_library(
+    name = "websecurityscanner_py_grpc",
+    srcs = [":websecurityscanner_moved_proto"],
+    deps = [":websecurityscanner_py_proto"],
+)
+
+py_gapic_library(
+    name = "websecurityscanner_py_gapic",
+    src = ":websecurityscanner_proto_with_info",
+    gapic_yaml = "websecurityscanner_gapic.yaml",
+    package = "google.cloud.websecurityscanner.v1",
+    service_yaml = "websecurityscanner_v1.yaml",
+    deps = [
+        ":websecurityscanner_py_grpc",
+        ":websecurityscanner_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "websecurityscanner-v1-py",
+    deps = [
+        ":websecurityscanner_py_gapic",
+        ":websecurityscanner_py_grpc",
+        ":websecurityscanner_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "websecurityscanner_php_proto",
+    deps = [":websecurityscanner_proto"],
+)
+
+php_grpc_library(
+    name = "websecurityscanner_php_grpc",
+    srcs = [":websecurityscanner_proto"],
+    deps = [":websecurityscanner_php_proto"],
+)
+
+php_gapic_library(
+    name = "websecurityscanner_php_gapic",
+    src = ":websecurityscanner_proto_with_info",
+    gapic_yaml = "websecurityscanner_gapic.yaml",
+    package = "google.cloud.websecurityscanner.v1",
+    service_yaml = "websecurityscanner_v1.yaml",
+    deps = [
+        ":websecurityscanner_php_grpc",
+        ":websecurityscanner_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-websecurityscanner-v1-php",
+    deps = [
+        ":websecurityscanner_php_gapic",
+        ":websecurityscanner_php_grpc",
+        ":websecurityscanner_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "websecurityscanner_nodejs_gapic",
+    src = ":websecurityscanner_proto_with_info",
+    gapic_yaml = "websecurityscanner_gapic.yaml",
+    package = "google.cloud.websecurityscanner.v1",
+    service_yaml = "websecurityscanner_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "websecurityscanner-v1-nodejs",
+    deps = [
+        ":websecurityscanner_nodejs_gapic",
+        ":websecurityscanner_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "websecurityscanner_ruby_proto",
+    deps = [":websecurityscanner_proto"],
+)
+
+ruby_grpc_library(
+    name = "websecurityscanner_ruby_grpc",
+    srcs = [":websecurityscanner_proto"],
+    deps = [":websecurityscanner_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "websecurityscanner_ruby_gapic",
+    src = ":websecurityscanner_proto_with_info",
+    gapic_yaml = "websecurityscanner_gapic.yaml",
+    package = "google.cloud.websecurityscanner.v1",
+    service_yaml = "websecurityscanner_v1.yaml",
+    deps = [
+        ":websecurityscanner_ruby_grpc",
+        ":websecurityscanner_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-websecurityscanner-v1-ruby",
+    deps = [
+        ":websecurityscanner_ruby_gapic",
+        ":websecurityscanner_ruby_grpc",
+        ":websecurityscanner_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "websecurityscanner_csharp_proto",
+    deps = [":websecurityscanner_proto"],
+)
+
+csharp_grpc_library(
+    name = "websecurityscanner_csharp_grpc",
+    srcs = [":websecurityscanner_proto"],
+    deps = [":websecurityscanner_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "websecurityscanner_csharp_gapic",
+    src = ":websecurityscanner_proto_with_info",
+    gapic_yaml = "websecurityscanner_gapic.yaml",
+    package = "google.cloud.websecurityscanner.v1",
+    service_yaml = "websecurityscanner_v1.yaml",
+    deps = [
+        ":websecurityscanner_csharp_grpc",
+        ":websecurityscanner_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-websecurityscanner-v1-csharp",
+    deps = [
+        ":websecurityscanner_csharp_gapic",
+        ":websecurityscanner_csharp_grpc",
+        ":websecurityscanner_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1/crawled_url.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1/crawled_url.proto
new file mode 100644
index 000000000..b64eb402b
--- /dev/null
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1/crawled_url.proto
@@ -0,0 +1,37 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.websecurityscanner.v1;
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1;websecurityscanner";
+option java_multiple_files = true;
+option java_outer_classname = "CrawledUrlProto";
+option java_package = "com.google.cloud.websecurityscanner.v1";
+
+// A CrawledUrl resource represents a URL that was crawled during a ScanRun. Web
+// Security Scanner Service crawls the web applications, following all links
+// within the scope of sites, to find the URLs to test against.
+message CrawledUrl {
+  // Output only. The http method of the request that was used to visit the URL, in
+  // uppercase.
+  string http_method = 1;
+
+  // Output only. The URL that was crawled.
+  string url = 2;
+
+  // Output only. The body of the request that was used to visit the URL.
+  string body = 3;
+}
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1/finding.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1/finding.proto
new file mode 100644
index 000000000..7a8cdf96e
--- /dev/null
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1/finding.proto
@@ -0,0 +1,116 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.websecurityscanner.v1;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/websecurityscanner/v1/finding_addon.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1;websecurityscanner";
+option java_multiple_files = true;
+option java_outer_classname = "FindingProto";
+option java_package = "com.google.cloud.websecurityscanner.v1";
+
+// A Finding resource represents a vulnerability instance identified during a
+// ScanRun.
+message Finding {
+  option (google.api.resource) = {
+    type: "websecurityscanner.googleapis.com/Finding"
+    pattern: "projects/{project}/scanConfigs/{scan_config}/scanRuns/{scan_run}/findings/{finding}"
+  };
+
+  // The severity level of a vulnerability.
+  enum Severity {
+    // No severity specified. The default value.
+    SEVERITY_UNSPECIFIED = 0;
+
+    // Critical severity.
+    CRITICAL = 1;
+
+    // High severity.
+    HIGH = 2;
+
+    // Medium severity.
+    MEDIUM = 3;
+
+    // Low severity.
+    LOW = 4;
+  }
+
+  // Output only. The resource name of the Finding. The name follows the format of
+  // 'projects/{projectId}/scanConfigs/{scanConfigId}/scanruns/{scanRunId}/findings/{findingId}'.
+  // The finding IDs are generated by the system.
+  string name = 1;
+
+  // Output only. The type of the Finding.
+  // Detailed and up-to-date information on findings can be found here:
+  // https://cloud.google.com/security-command-center/docs/how-to-remediate-web-security-scanner-findings
+  string finding_type = 2;
+
+  // Output only. The severity level of the reported vulnerability.
+  Severity severity = 17 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The http method of the request that triggered the vulnerability, in
+  // uppercase.
+  string http_method = 3;
+
+  // Output only. The URL produced by the server-side fuzzer and used in the request that
+  // triggered the vulnerability.
+  string fuzzed_url = 4;
+
+  // Output only. The body of the request that triggered the vulnerability.
+  string body = 5;
+
+  // Output only. The description of the vulnerability.
+  string description = 6;
+
+  // Output only. The URL containing human-readable payload that user can leverage to
+  // reproduce the vulnerability.
+  string reproduction_url = 7;
+
+  // Output only. If the vulnerability was originated from nested IFrame, the immediate
+  // parent IFrame is reported.
+  string frame_url = 8;
+
+  // Output only. The URL where the browser lands when the vulnerability is detected.
+  string final_url = 9;
+
+  // Output only. The tracking ID uniquely identifies a vulnerability instance across
+  // multiple ScanRuns.
+  string tracking_id = 10;
+
+  // Output only. An addon containing information reported for a vulnerability with an HTML
+  // form, if any.
+  Form form = 16;
+
+  // Output only. An addon containing information about outdated libraries.
+  OutdatedLibrary outdated_library = 11;
+
+  // Output only. An addon containing detailed information regarding any resource causing the
+  // vulnerability such as JavaScript sources, image, audio files, etc.
+  ViolatingResource violating_resource = 12;
+
+  // Output only. An addon containing information about vulnerable or missing HTTP headers.
+  VulnerableHeaders vulnerable_headers = 15;
+
+  // Output only. An addon containing information about request parameters which were found
+  // to be vulnerable.
+  VulnerableParameters vulnerable_parameters = 13;
+
+  // Output only. An addon containing information reported for an XSS, if any.
+  Xss xss = 14;
+}
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1/finding_addon.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1/finding_addon.proto
new file mode 100644
index 000000000..c171ca3b2
--- /dev/null
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1/finding_addon.proto
@@ -0,0 +1,144 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.websecurityscanner.v1;
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1;websecurityscanner";
+option java_multiple_files = true;
+option java_outer_classname = "FindingAddonProto";
+option java_package = "com.google.cloud.websecurityscanner.v1";
+
+// ! Information about a vulnerability with an HTML.
+message Form {
+  // ! The URI where to send the form when it's submitted.
+  string action_uri = 1;
+
+  // ! The names of form fields related to the vulnerability.
+  repeated string fields = 2;
+}
+
+// Information reported for an outdated library.
+message OutdatedLibrary {
+  // The name of the outdated library.
+  string library_name = 1;
+
+  // The version number.
+  string version = 2;
+
+  // URLs to learn more information about the vulnerabilities in the library.
+  repeated string learn_more_urls = 3;
+}
+
+// Information regarding any resource causing the vulnerability such
+// as JavaScript sources, image, audio files, etc.
+message ViolatingResource {
+  // The MIME type of this resource.
+  string content_type = 1;
+
+  // URL of this violating resource.
+  string resource_url = 2;
+}
+
+// Information about vulnerable request parameters.
+message VulnerableParameters {
+  // The vulnerable parameter names.
+  repeated string parameter_names = 1;
+}
+
+// Information about vulnerable or missing HTTP Headers.
+message VulnerableHeaders {
+  // Describes a HTTP Header.
+  message Header {
+    // Header name.
+    string name = 1;
+
+    // Header value.
+    string value = 2;
+  }
+
+  // List of vulnerable headers.
+  repeated Header headers = 1;
+
+  // List of missing headers.
+  repeated Header missing_headers = 2;
+}
+
+// Information reported for an XSS.
+message Xss {
+  // Types of XSS attack vector.
+  enum AttackVector {
+    // Unknown attack vector.
+    ATTACK_VECTOR_UNSPECIFIED = 0;
+
+    // The attack comes from fuzzing the browser's localStorage.
+    LOCAL_STORAGE = 1;
+
+    // The attack comes from fuzzing the browser's sessionStorage.
+    SESSION_STORAGE = 2;
+
+    // The attack comes from fuzzing the window's name property.
+    WINDOW_NAME = 3;
+
+    // The attack comes from fuzzing the referrer property.
+    REFERRER = 4;
+
+    // The attack comes from fuzzing an input element.
+    FORM_INPUT = 5;
+
+    // The attack comes from fuzzing the browser's cookies.
+    COOKIE = 6;
+
+    // The attack comes from hijacking the post messaging mechanism.
+    POST_MESSAGE = 7;
+
+    // The attack comes from fuzzing parameters in the url.
+    GET_PARAMETERS = 8;
+
+    // The attack comes from fuzzing the fragment in the url.
+    URL_FRAGMENT = 9;
+
+    // The attack comes from fuzzing the HTML comments.
+    HTML_COMMENT = 10;
+
+    // The attack comes from fuzzing the POST parameters.
+    POST_PARAMETERS = 11;
+
+    // The attack comes from fuzzing the protocol.
+    PROTOCOL = 12;
+
+    // The attack comes from the server side and is stored.
+    STORED_XSS = 13;
+
+    // The attack is a Same-Origin Method Execution attack via a GET parameter.
+    SAME_ORIGIN = 14;
+
+    // The attack payload is received from a third-party host via a URL that is
+    // user-controllable
+    USER_CONTROLLABLE_URL = 15;
+  }
+
+  // Stack traces leading to the point where the XSS occurred.
+  repeated string stack_traces = 1;
+
+  // An error message generated by a javascript breakage.
+  string error_message = 2;
+
+  // The attack vector of the payload triggering this XSS.
+  AttackVector attack_vector = 3;
+
+  // The reproduction url for the seeding POST request of a Stored XSS.
+  string stored_xss_seeding_url = 4;
+}
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1/finding_type_stats.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1/finding_type_stats.proto
new file mode 100644
index 000000000..66419f761
--- /dev/null
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1/finding_type_stats.proto
@@ -0,0 +1,32 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.websecurityscanner.v1;
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1;websecurityscanner";
+option java_multiple_files = true;
+option java_outer_classname = "FindingTypeStatsProto";
+option java_package = "com.google.cloud.websecurityscanner.v1";
+
+// A FindingTypeStats resource represents stats regarding a specific FindingType
+// of Findings under a given ScanRun.
+message FindingTypeStats {
+  // Output only. The finding type associated with the stats.
+  string finding_type = 1;
+
+  // Output only. The count of findings belonging to this finding type.
+  int32 finding_count = 2;
+}
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1/scan_config.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1/scan_config.proto
new file mode 100644
index 000000000..f5cf4f67f
--- /dev/null
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1/scan_config.proto
@@ -0,0 +1,185 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.websecurityscanner.v1;
+
+import "google/api/field_behavior.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1;websecurityscanner";
+option java_multiple_files = true;
+option java_outer_classname = "ScanConfigProto";
+option java_package = "com.google.cloud.websecurityscanner.v1";
+
+// A ScanConfig resource contains the configurations to launch a scan.
+message ScanConfig {
+  // Scan authentication configuration.
+  message Authentication {
+    // Describes authentication configuration that uses a Google account.
+    message GoogleAccount {
+      // Required. The user name of the Google account.
+      string username = 1;
+
+      // Required. Input only. The password of the Google account. The credential is stored encrypted
+      // and not returned in any response nor included in audit logs.
+      string password = 2;
+    }
+
+    // Describes authentication configuration that uses a custom account.
+    message CustomAccount {
+      // Required. The user name of the custom account.
+      string username = 1;
+
+      // Required. Input only. The password of the custom account. The credential is stored encrypted
+      // and not returned in any response nor included in audit logs.
+      string password = 2;
+
+      // Required. The login form URL of the website.
+      string login_url = 3;
+    }
+
+    // Describes authentication configuration for Identity-Aware-Proxy (IAP).
+    message IapCredential {
+      // Describes authentication configuration when Web-Security-Scanner
+      // service account is added in Identity-Aware-Proxy (IAP) access policies.
+      message IapTestServiceAccountInfo {
+        // Required. Describes OAuth2 client id of resources protected by
+        // Identity-Aware-Proxy (IAP).
+        string target_audience_client_id = 1 [(google.api.field_behavior) = REQUIRED];
+      }
+
+      // Identity-Aware-Proxy (IAP) Authentication Configuration
+      oneof iap_credentials {
+        // Authentication configuration when Web-Security-Scanner service
+        // account is added in Identity-Aware-Proxy (IAP) access policies.
+        IapTestServiceAccountInfo iap_test_service_account_info = 1;
+      }
+    }
+
+    // Required.
+    // Authentication configuration
+    oneof authentication {
+      // Authentication using a Google account.
+      GoogleAccount google_account = 1;
+
+      // Authentication using a custom account.
+      CustomAccount custom_account = 2;
+
+      // Authentication using Identity-Aware-Proxy (IAP).
+      IapCredential iap_credential = 4;
+    }
+  }
+
+  // Scan schedule configuration.
+  message Schedule {
+    // A timestamp indicates when the next run will be scheduled. The value is
+    // refreshed by the server after each run. If unspecified, it will default
+    // to current server time, which means the scan will be scheduled to start
+    // immediately.
+    google.protobuf.Timestamp schedule_time = 1;
+
+    // Required. The duration of time between executions in days.
+    int32 interval_duration_days = 2;
+  }
+
+  // Type of user agents used for scanning.
+  enum UserAgent {
+    // The user agent is unknown. Service will default to CHROME_LINUX.
+    USER_AGENT_UNSPECIFIED = 0;
+
+    // Chrome on Linux. This is the service default if unspecified.
+    CHROME_LINUX = 1;
+
+    // Chrome on Android.
+    CHROME_ANDROID = 2;
+
+    // Safari on IPhone.
+    SAFARI_IPHONE = 3;
+  }
+
+  // Scan risk levels supported by Web Security Scanner. LOW impact
+  // scanning will minimize requests with the potential to modify data. To
+  // achieve the maximum scan coverage, NORMAL risk level is recommended.
+  enum RiskLevel {
+    // Use default, which is NORMAL.
+    RISK_LEVEL_UNSPECIFIED = 0;
+
+    // Normal scanning (Recommended)
+    NORMAL = 1;
+
+    // Lower impact scanning
+    LOW = 2;
+  }
+
+  // Controls export of scan configurations and results to Security
+  // Command Center.
+  enum ExportToSecurityCommandCenter {
+    // Use default, which is ENABLED.
+    EXPORT_TO_SECURITY_COMMAND_CENTER_UNSPECIFIED = 0;
+
+    // Export results of this scan to Security Command Center.
+    ENABLED = 1;
+
+    // Do not export results of this scan to Security Command Center.
+    DISABLED = 2;
+  }
+
+  // The resource name of the ScanConfig. The name follows the format of
+  // 'projects/{projectId}/scanConfigs/{scanConfigId}'. The ScanConfig IDs are
+  // generated by the system.
+  string name = 1;
+
+  // Required. The user provided display name of the ScanConfig.
+  string display_name = 2;
+
+  // The maximum QPS during scanning. A valid value ranges from 5 to 20
+  // inclusively. If the field is unspecified or its value is set 0, server will
+  // default to 15. Other values outside of [5, 20] range will be rejected with
+  // INVALID_ARGUMENT error.
+  int32 max_qps = 3;
+
+  // Required. The starting URLs from which the scanner finds site pages.
+  repeated string starting_urls = 4;
+
+  // The authentication configuration. If specified, service will use the
+  // authentication configuration during scanning.
+  Authentication authentication = 5;
+
+  // The user agent used during scanning.
+  UserAgent user_agent = 6;
+
+  // The excluded URL patterns as described in
+  // https://cloud.google.com/security-command-center/docs/how-to-use-web-security-scanner#excluding_urls
+  repeated string blacklist_patterns = 7;
+
+  // The schedule of the ScanConfig.
+  Schedule schedule = 8;
+
+  // Controls export of scan configurations and results to Security
+  // Command Center.
+  ExportToSecurityCommandCenter export_to_security_command_center = 10;
+
+  // The risk level selected for the scan
+  RiskLevel risk_level = 12;
+
+  // Whether the scan config is managed by Web Security Scanner, output
+  // only.
+  bool managed_scan = 13;
+
+  // Whether the scan configuration has enabled static IP address scan feature.
+  // If enabled, the scanner will access applications from static IP addresses.
+  bool static_ip_scan = 14;
+}
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1/scan_config_error.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1/scan_config_error.proto
new file mode 100644
index 000000000..7618c3935
--- /dev/null
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1/scan_config_error.proto
@@ -0,0 +1,186 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.websecurityscanner.v1;
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1;websecurityscanner";
+option java_multiple_files = true;
+option java_outer_classname = "ScanConfigErrorProto";
+option java_package = "com.google.cloud.websecurityscanner.v1";
+
+// Defines a custom error message used by CreateScanConfig and UpdateScanConfig
+// APIs when scan configuration validation fails. It is also reported as part of
+// a ScanRunErrorTrace message if scan validation fails due to a scan
+// configuration error.
+message ScanConfigError {
+  // Output only.
+  // Defines an error reason code.
+  // Next id: 44
+  enum Code {
+    option allow_alias = true;
+
+    // There is no error.
+    CODE_UNSPECIFIED = 0;
+
+    // There is no error.
+    OK = 0;
+
+    // Indicates an internal server error.
+    // Please DO NOT USE THIS ERROR CODE unless the root cause is truly unknown.
+    INTERNAL_ERROR = 1;
+
+    // One of the seed URLs is an App Engine URL but we cannot validate the scan
+    // settings due to an App Engine API backend error.
+    APPENGINE_API_BACKEND_ERROR = 2;
+
+    // One of the seed URLs is an App Engine URL but we cannot access the
+    // App Engine API to validate scan settings.
+    APPENGINE_API_NOT_ACCESSIBLE = 3;
+
+    // One of the seed URLs is an App Engine URL but the Default Host of the
+    // App Engine is not set.
+    APPENGINE_DEFAULT_HOST_MISSING = 4;
+
+    // Google corporate accounts can not be used for scanning.
+    CANNOT_USE_GOOGLE_COM_ACCOUNT = 6;
+
+    // The account of the scan creator can not be used for scanning.
+    CANNOT_USE_OWNER_ACCOUNT = 7;
+
+    // This scan targets Compute Engine, but we cannot validate scan settings
+    // due to a Compute Engine API backend error.
+    COMPUTE_API_BACKEND_ERROR = 8;
+
+    // This scan targets Compute Engine, but we cannot access the Compute Engine
+    // API to validate the scan settings.
+    COMPUTE_API_NOT_ACCESSIBLE = 9;
+
+    // The Custom Login URL does not belong to the current project.
+    CUSTOM_LOGIN_URL_DOES_NOT_BELONG_TO_CURRENT_PROJECT = 10;
+
+    // The Custom Login URL is malformed (can not be parsed).
+    CUSTOM_LOGIN_URL_MALFORMED = 11;
+
+    // The Custom Login URL is mapped to a non-routable IP address in DNS.
+    CUSTOM_LOGIN_URL_MAPPED_TO_NON_ROUTABLE_ADDRESS = 12;
+
+    // The Custom Login URL is mapped to an IP address which is not reserved for
+    // the current project.
+    CUSTOM_LOGIN_URL_MAPPED_TO_UNRESERVED_ADDRESS = 13;
+
+    // The Custom Login URL has a non-routable IP address.
+    CUSTOM_LOGIN_URL_HAS_NON_ROUTABLE_IP_ADDRESS = 14;
+
+    // The Custom Login URL has an IP address which is not reserved for the
+    // current project.
+    CUSTOM_LOGIN_URL_HAS_UNRESERVED_IP_ADDRESS = 15;
+
+    // Another scan with the same name (case-sensitive) already exists.
+    DUPLICATE_SCAN_NAME = 16;
+
+    // A field is set to an invalid value.
+    INVALID_FIELD_VALUE = 18;
+
+    // There was an error trying to authenticate to the scan target.
+    FAILED_TO_AUTHENTICATE_TO_TARGET = 19;
+
+    // Finding type value is not specified in the list findings request.
+    FINDING_TYPE_UNSPECIFIED = 20;
+
+    // Scan targets Compute Engine, yet current project was not whitelisted for
+    // Google Compute Engine Scanning Alpha access.
+    FORBIDDEN_TO_SCAN_COMPUTE = 21;
+
+    // User tries to update managed scan
+    FORBIDDEN_UPDATE_TO_MANAGED_SCAN = 43;
+
+    // The supplied filter is malformed. For example, it can not be parsed, does
+    // not have a filter type in expression, or the same filter type appears
+    // more than once.
+    MALFORMED_FILTER = 22;
+
+    // The supplied resource name is malformed (can not be parsed).
+    MALFORMED_RESOURCE_NAME = 23;
+
+    // The current project is not in an active state.
+    PROJECT_INACTIVE = 24;
+
+    // A required field is not set.
+    REQUIRED_FIELD = 25;
+
+    // Project id, scanconfig id, scanrun id, or finding id are not consistent
+    // with each other in resource name.
+    RESOURCE_NAME_INCONSISTENT = 26;
+
+    // The scan being requested to start is already running.
+    SCAN_ALREADY_RUNNING = 27;
+
+    // The scan that was requested to be stopped is not running.
+    SCAN_NOT_RUNNING = 28;
+
+    // One of the seed URLs does not belong to the current project.
+    SEED_URL_DOES_NOT_BELONG_TO_CURRENT_PROJECT = 29;
+
+    // One of the seed URLs is malformed (can not be parsed).
+    SEED_URL_MALFORMED = 30;
+
+    // One of the seed URLs is mapped to a non-routable IP address in DNS.
+    SEED_URL_MAPPED_TO_NON_ROUTABLE_ADDRESS = 31;
+
+    // One of the seed URLs is mapped to an IP address which is not reserved
+    // for the current project.
+    SEED_URL_MAPPED_TO_UNRESERVED_ADDRESS = 32;
+
+    // One of the seed URLs has on-routable IP address.
+    SEED_URL_HAS_NON_ROUTABLE_IP_ADDRESS = 33;
+
+    // One of the seed URLs has an IP address that is not reserved
+    // for the current project.
+    SEED_URL_HAS_UNRESERVED_IP_ADDRESS = 35;
+
+    // The Web Security Scanner service account is not configured under the
+    // project.
+    SERVICE_ACCOUNT_NOT_CONFIGURED = 36;
+
+    // A project has reached the maximum number of scans.
+    TOO_MANY_SCANS = 37;
+
+    // Resolving the details of the current project fails.
+    UNABLE_TO_RESOLVE_PROJECT_INFO = 38;
+
+    // One or more blacklist patterns were in the wrong format.
+    UNSUPPORTED_BLACKLIST_PATTERN_FORMAT = 39;
+
+    // The supplied filter is not supported.
+    UNSUPPORTED_FILTER = 40;
+
+    // The supplied finding type is not supported. For example, we do not
+    // provide findings of the given finding type.
+    UNSUPPORTED_FINDING_TYPE = 41;
+
+    // The URL scheme of one or more of the supplied URLs is not supported.
+    UNSUPPORTED_URL_SCHEME = 42;
+  }
+
+  // Output only. Indicates the reason code for a configuration failure.
+  Code code = 1;
+
+  // Output only. Indicates the full name of the ScanConfig field that triggers this error,
+  // for example "scan_config.max_qps". This field is provided for
+  // troubleshooting purposes only and its actual value can change in the
+  // future.
+  string field_name = 2;
+}
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1/scan_run.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1/scan_run.proto
new file mode 100644
index 000000000..42335337e
--- /dev/null
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1/scan_run.proto
@@ -0,0 +1,107 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.websecurityscanner.v1;
+
+import "google/cloud/websecurityscanner/v1/scan_run_error_trace.proto";
+import "google/cloud/websecurityscanner/v1/scan_run_warning_trace.proto";
+import "google/protobuf/timestamp.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1;websecurityscanner";
+option java_multiple_files = true;
+option java_outer_classname = "ScanRunProto";
+option java_package = "com.google.cloud.websecurityscanner.v1";
+
+// A ScanRun is a output-only resource representing an actual run of the scan.
+// Next id: 12
+message ScanRun {
+  // Types of ScanRun execution state.
+  enum ExecutionState {
+    // Represents an invalid state caused by internal server error. This value
+    // should never be returned.
+    EXECUTION_STATE_UNSPECIFIED = 0;
+
+    // The scan is waiting in the queue.
+    QUEUED = 1;
+
+    // The scan is in progress.
+    SCANNING = 2;
+
+    // The scan is either finished or stopped by user.
+    FINISHED = 3;
+  }
+
+  // Types of ScanRun result state.
+  enum ResultState {
+    // Default value. This value is returned when the ScanRun is not yet
+    // finished.
+    RESULT_STATE_UNSPECIFIED = 0;
+
+    // The scan finished without errors.
+    SUCCESS = 1;
+
+    // The scan finished with errors.
+    ERROR = 2;
+
+    // The scan was terminated by user.
+    KILLED = 3;
+  }
+
+  // Output only. The resource name of the ScanRun. The name follows the format of
+  // 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
+  // The ScanRun IDs are generated by the system.
+  string name = 1;
+
+  // Output only. The execution state of the ScanRun.
+  ExecutionState execution_state = 2;
+
+  // Output only. The result state of the ScanRun. This field is only available after the
+  // execution state reaches "FINISHED".
+  ResultState result_state = 3;
+
+  // Output only. The time at which the ScanRun started.
+  google.protobuf.Timestamp start_time = 4;
+
+  // Output only. The time at which the ScanRun reached termination state - that the ScanRun
+  // is either finished or stopped by user.
+  google.protobuf.Timestamp end_time = 5;
+
+  // Output only. The number of URLs crawled during this ScanRun. If the scan is in progress,
+  // the value represents the number of URLs crawled up to now.
+  int64 urls_crawled_count = 6;
+
+  // Output only. The number of URLs tested during this ScanRun. If the scan is in progress,
+  // the value represents the number of URLs tested up to now. The number of
+  // URLs tested is usually larger than the number URLS crawled because
+  // typically a crawled URL is tested with multiple test payloads.
+  int64 urls_tested_count = 7;
+
+  // Output only. Whether the scan run has found any vulnerabilities.
+  bool has_vulnerabilities = 8;
+
+  // Output only. The percentage of total completion ranging from 0 to 100.
+  // If the scan is in queue, the value is 0.
+  // If the scan is running, the value ranges from 0 to 100.
+  // If the scan is finished, the value is 100.
+  int32 progress_percent = 9;
+
+  // Output only. If result_state is an ERROR, this field provides the primary reason for
+  // scan's termination and more details, if such are available.
+  ScanRunErrorTrace error_trace = 10;
+
+  // Output only. A list of warnings, if such are encountered during this scan run.
+  repeated ScanRunWarningTrace warning_traces = 11;
+}
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1/scan_run_error_trace.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1/scan_run_error_trace.proto
new file mode 100644
index 000000000..bae9f8805
--- /dev/null
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1/scan_run_error_trace.proto
@@ -0,0 +1,72 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.websecurityscanner.v1;
+
+import "google/cloud/websecurityscanner/v1/scan_config_error.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1;websecurityscanner";
+option java_multiple_files = true;
+option java_outer_classname = "ScanRunErrorTraceProto";
+option java_package = "com.google.cloud.websecurityscanner.v1";
+
+// Output only.
+// Defines an error trace message for a ScanRun.
+message ScanRunErrorTrace {
+  // Output only.
+  // Defines an error reason code.
+  // Next id: 7
+  enum Code {
+    // Default value is never used.
+    CODE_UNSPECIFIED = 0;
+
+    // Indicates that the scan run failed due to an internal server error.
+    INTERNAL_ERROR = 1;
+
+    // Indicates a scan configuration error, usually due to outdated ScanConfig
+    // settings, such as starting_urls or the DNS configuration.
+    SCAN_CONFIG_ISSUE = 2;
+
+    // Indicates an authentication error, usually due to outdated ScanConfig
+    // authentication settings.
+    AUTHENTICATION_CONFIG_ISSUE = 3;
+
+    // Indicates a scan operation timeout, usually caused by a very large site.
+    TIMED_OUT_WHILE_SCANNING = 4;
+
+    // Indicates that a scan encountered excessive redirects, either to
+    // authentication or some other page outside of the scan scope.
+    TOO_MANY_REDIRECTS = 5;
+
+    // Indicates that a scan encountered numerous errors from the web site
+    // pages. When available, most_common_http_error_code field indicates the
+    // most common HTTP error code encountered during the scan.
+    TOO_MANY_HTTP_ERRORS = 6;
+  }
+
+  // Output only. Indicates the error reason code.
+  Code code = 1;
+
+  // Output only. If the scan encounters SCAN_CONFIG_ISSUE error, this field has the error
+  // message encountered during scan configuration validation that is performed
+  // before each scan run.
+  ScanConfigError scan_config_error = 2;
+
+  // Output only. If the scan encounters TOO_MANY_HTTP_ERRORS, this field indicates the most
+  // common HTTP error code, if such is available. For example, if this code is
+  // 404, the scan has encountered too many NOT_FOUND responses.
+  int32 most_common_http_error_code = 3;
+}
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1/scan_run_warning_trace.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1/scan_run_warning_trace.proto
new file mode 100644
index 000000000..30c8b4f2f
--- /dev/null
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1/scan_run_warning_trace.proto
@@ -0,0 +1,55 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.websecurityscanner.v1;
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1;websecurityscanner";
+option java_multiple_files = true;
+option java_outer_classname = "ScanRunWarningTraceProto";
+option java_package = "com.google.cloud.websecurityscanner.v1";
+
+// Output only.
+// Defines a warning trace message for ScanRun. Warning traces provide customers
+// with useful information that helps make the scanning process more effective.
+message ScanRunWarningTrace {
+  // Output only.
+  // Defines a warning message code.
+  // Next id: 6
+  enum Code {
+    // Default value is never used.
+    CODE_UNSPECIFIED = 0;
+
+    // Indicates that a scan discovered an unexpectedly low number of URLs. This
+    // is sometimes caused by complex navigation features or by using a single
+    // URL for numerous pages.
+    INSUFFICIENT_CRAWL_RESULTS = 1;
+
+    // Indicates that a scan discovered too many URLs to test, or excessive
+    // redundant URLs.
+    TOO_MANY_CRAWL_RESULTS = 2;
+
+    // Indicates that too many tests have been generated for the scan. Customer
+    // should try reducing the number of starting URLs, increasing the QPS rate,
+    // or narrowing down the scope of the scan using the excluded patterns.
+    TOO_MANY_FUZZ_TASKS = 3;
+
+    // Indicates that a scan is blocked by IAP.
+    BLOCKED_BY_IAP = 4;
+  }
+
+  // Output only. Indicates the warning code.
+  Code code = 1;
+}
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1/web_security_scanner.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1/web_security_scanner.proto
new file mode 100644
index 000000000..599557104
--- /dev/null
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1/web_security_scanner.proto
@@ -0,0 +1,334 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.websecurityscanner.v1;
+
+import "google/api/annotations.proto";
+import "google/cloud/websecurityscanner/v1/crawled_url.proto";
+import "google/cloud/websecurityscanner/v1/finding.proto";
+import "google/cloud/websecurityscanner/v1/finding_type_stats.proto";
+import "google/cloud/websecurityscanner/v1/scan_config.proto";
+import "google/cloud/websecurityscanner/v1/scan_run.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+import "google/api/client.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1;websecurityscanner";
+option java_multiple_files = true;
+option java_outer_classname = "WebSecurityScannerProto";
+option java_package = "com.google.cloud.websecurityscanner.v1";
+
+// Web Security Scanner Service identifies security vulnerabilities in web
+// applications hosted on Google Cloud. It crawls your application, and
+// attempts to exercise as many user inputs and event handlers as possible.
+service WebSecurityScanner {
+  option (google.api.default_host) = "websecurityscanner.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // Creates a new ScanConfig.
+  rpc CreateScanConfig(CreateScanConfigRequest) returns (ScanConfig) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*}/scanConfigs"
+      body: "scan_config"
+    };
+  }
+
+  // Deletes an existing ScanConfig and its child resources.
+  rpc DeleteScanConfig(DeleteScanConfigRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/scanConfigs/*}"
+    };
+  }
+
+  // Gets a ScanConfig.
+  rpc GetScanConfig(GetScanConfigRequest) returns (ScanConfig) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/scanConfigs/*}"
+    };
+  }
+
+  // Lists ScanConfigs under a given project.
+  rpc ListScanConfigs(ListScanConfigsRequest) returns (ListScanConfigsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*}/scanConfigs"
+    };
+  }
+
+  // Updates a ScanConfig. This method support partial update of a ScanConfig.
+  rpc UpdateScanConfig(UpdateScanConfigRequest) returns (ScanConfig) {
+    option (google.api.http) = {
+      patch: "/v1/{scan_config.name=projects/*/scanConfigs/*}"
+      body: "scan_config"
+    };
+  }
+
+  // Start a ScanRun according to the given ScanConfig.
+  rpc StartScanRun(StartScanRunRequest) returns (ScanRun) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/scanConfigs/*}:start"
+      body: "*"
+    };
+  }
+
+  // Gets a ScanRun.
+  rpc GetScanRun(GetScanRunRequest) returns (ScanRun) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/scanConfigs/*/scanRuns/*}"
+    };
+  }
+
+  // Lists ScanRuns under a given ScanConfig, in descending order of ScanRun
+  // stop time.
+  rpc ListScanRuns(ListScanRunsRequest) returns (ListScanRunsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/scanConfigs/*}/scanRuns"
+    };
+  }
+
+  // Stops a ScanRun. The stopped ScanRun is returned.
+  rpc StopScanRun(StopScanRunRequest) returns (ScanRun) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/scanConfigs/*/scanRuns/*}:stop"
+      body: "*"
+    };
+  }
+
+  // List CrawledUrls under a given ScanRun.
+  rpc ListCrawledUrls(ListCrawledUrlsRequest) returns (ListCrawledUrlsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/scanConfigs/*/scanRuns/*}/crawledUrls"
+    };
+  }
+
+  // Gets a Finding.
+  rpc GetFinding(GetFindingRequest) returns (Finding) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/scanConfigs/*/scanRuns/*/findings/*}"
+    };
+  }
+
+  // List Findings under a given ScanRun.
+  rpc ListFindings(ListFindingsRequest) returns (ListFindingsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/scanConfigs/*/scanRuns/*}/findings"
+    };
+  }
+
+  // List all FindingTypeStats under a given ScanRun.
+  rpc ListFindingTypeStats(ListFindingTypeStatsRequest) returns (ListFindingTypeStatsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/scanConfigs/*/scanRuns/*}/findingTypeStats"
+    };
+  }
+}
+
+// Request for the `CreateScanConfig` method.
+message CreateScanConfigRequest {
+  // Required. The parent resource name where the scan is created, which should be a
+  // project resource name in the format 'projects/{projectId}'.
+  string parent = 1;
+
+  // Required. The ScanConfig to be created.
+  ScanConfig scan_config = 2;
+}
+
+// Request for the `DeleteScanConfig` method.
+message DeleteScanConfigRequest {
+  // Required. The resource name of the ScanConfig to be deleted. The name follows the
+  // format of 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+  string name = 1;
+}
+
+// Request for the `GetScanConfig` method.
+message GetScanConfigRequest {
+  // Required. The resource name of the ScanConfig to be returned. The name follows the
+  // format of 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+  string name = 1;
+}
+
+// Request for the `ListScanConfigs` method.
+message ListScanConfigsRequest {
+  // Required. The parent resource name, which should be a project resource name in the
+  // format 'projects/{projectId}'.
+  string parent = 1;
+
+  // A token identifying a page of results to be returned. This should be a
+  // `next_page_token` value returned from a previous List request.
+  // If unspecified, the first page of results is returned.
+  string page_token = 2;
+
+  // The maximum number of ScanConfigs to return, can be limited by server.
+  // If not specified or not positive, the implementation will select a
+  // reasonable value.
+  int32 page_size = 3;
+}
+
+// Request for the `UpdateScanConfigRequest` method.
+message UpdateScanConfigRequest {
+  // Required. The ScanConfig to be updated. The name field must be set to identify the
+  // resource to be updated. The values of fields not covered by the mask
+  // will be ignored.
+  ScanConfig scan_config = 2;
+
+  // Required. The update mask applies to the resource. For the `FieldMask` definition,
+  // see
+  // https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask
+  google.protobuf.FieldMask update_mask = 3;
+}
+
+// Response for the `ListScanConfigs` method.
+message ListScanConfigsResponse {
+  // The list of ScanConfigs returned.
+  repeated ScanConfig scan_configs = 1;
+
+  // Token to retrieve the next page of results, or empty if there are no
+  // more results in the list.
+  string next_page_token = 2;
+}
+
+// Request for the `StartScanRun` method.
+message StartScanRunRequest {
+  // Required. The resource name of the ScanConfig to be used. The name follows the
+  // format of 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+  string name = 1;
+}
+
+// Request for the `GetScanRun` method.
+message GetScanRunRequest {
+  // Required. The resource name of the ScanRun to be returned. The name follows the
+  // format of
+  // 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
+  string name = 1;
+}
+
+// Request for the `ListScanRuns` method.
+message ListScanRunsRequest {
+  // Required. The parent resource name, which should be a scan resource name in the
+  // format 'projects/{projectId}/scanConfigs/{scanConfigId}'.
+  string parent = 1;
+
+  // A token identifying a page of results to be returned. This should be a
+  // `next_page_token` value returned from a previous List request.
+  // If unspecified, the first page of results is returned.
+  string page_token = 2;
+
+  // The maximum number of ScanRuns to return, can be limited by server.
+  // If not specified or not positive, the implementation will select a
+  // reasonable value.
+  int32 page_size = 3;
+}
+
+// Response for the `ListScanRuns` method.
+message ListScanRunsResponse {
+  // The list of ScanRuns returned.
+  repeated ScanRun scan_runs = 1;
+
+  // Token to retrieve the next page of results, or empty if there are no
+  // more results in the list.
+  string next_page_token = 2;
+}
+
+// Request for the `StopScanRun` method.
+message StopScanRunRequest {
+  // Required. The resource name of the ScanRun to be stopped. The name follows the
+  // format of
+  // 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
+  string name = 1;
+}
+
+// Request for the `ListCrawledUrls` method.
+message ListCrawledUrlsRequest {
+  // Required. The parent resource name, which should be a scan run resource name in the
+  // format
+  // 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
+  string parent = 1;
+
+  // A token identifying a page of results to be returned. This should be a
+  // `next_page_token` value returned from a previous List request.
+  // If unspecified, the first page of results is returned.
+  string page_token = 2;
+
+  // The maximum number of CrawledUrls to return, can be limited by server.
+  // If not specified or not positive, the implementation will select a
+  // reasonable value.
+  int32 page_size = 3;
+}
+
+// Response for the `ListCrawledUrls` method.
+message ListCrawledUrlsResponse {
+  // The list of CrawledUrls returned.
+  repeated CrawledUrl crawled_urls = 1;
+
+  // Token to retrieve the next page of results, or empty if there are no
+  // more results in the list.
+  string next_page_token = 2;
+}
+
+// Request for the `GetFinding` method.
+message GetFindingRequest {
+  // Required. The resource name of the Finding to be returned. The name follows the
+  // format of
+  // 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}/findings/{findingId}'.
+  string name = 1;
+}
+
+// Request for the `ListFindings` method.
+message ListFindingsRequest {
+  // Required. The parent resource name, which should be a scan run resource name in the
+  // format
+  // 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
+  string parent = 1;
+
+  // The filter expression. The expression must be in the format: 
+  //  .
+  // Supported field: 'finding_type'.
+  // Supported operator: '='.
+  string filter = 2;
+
+  // A token identifying a page of results to be returned. This should be a
+  // `next_page_token` value returned from a previous List request.
+  // If unspecified, the first page of results is returned.
+  string page_token = 3;
+
+  // The maximum number of Findings to return, can be limited by server.
+  // If not specified or not positive, the implementation will select a
+  // reasonable value.
+  int32 page_size = 4;
+}
+
+// Response for the `ListFindings` method.
+message ListFindingsResponse {
+  // The list of Findings returned.
+  repeated Finding findings = 1;
+
+  // Token to retrieve the next page of results, or empty if there are no
+  // more results in the list.
+  string next_page_token = 2;
+}
+
+// Request for the `ListFindingTypeStats` method.
+message ListFindingTypeStatsRequest {
+  // Required. The parent resource name, which should be a scan run resource name in the
+  // format
+  // 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
+  string parent = 1;
+}
+
+// Response for the `ListFindingTypeStats` method.
+message ListFindingTypeStatsResponse {
+  // The list of FindingTypeStats returned.
+  repeated FindingTypeStats finding_type_stats = 1;
+}
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1/websecurityscanner_gapic.yaml b/third_party/googleapis/google/cloud/websecurityscanner/v1/websecurityscanner_gapic.yaml
new file mode 100644
index 000000000..6c634317b
--- /dev/null
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1/websecurityscanner_gapic.yaml
@@ -0,0 +1,19 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 2.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.websecurityscanner.v1
+  python:
+    package_name: google.cloud.websecurityscanner_v1.gapic
+  go:
+    package_name: cloud.google.com/go/websecurityscanner/apiv1
+  csharp:
+    package_name: Google.Cloud.Websecurityscanner.V1
+  ruby:
+    package_name: Google::Cloud::Websecurityscanner::V1
+  php:
+    package_name: Google\Cloud\WebSecurityScanner\V1
+  nodejs:
+    package_name: websecurityscanner.v1
+    domain_layer_location: google-cloud
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1/websecurityscanner_grpc_service_config.json b/third_party/googleapis/google/cloud/websecurityscanner/v1/websecurityscanner_grpc_service_config.json
new file mode 100644
index 000000000..d680c4456
--- /dev/null
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1/websecurityscanner_grpc_service_config.json
@@ -0,0 +1,75 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.websecurityscanner.v1.WebSecurityScanner",
+          "method": "CreateScanConfig"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1.WebSecurityScanner",
+          "method": "UpdateScanConfig"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1.WebSecurityScanner",
+          "method": "StartScanRun"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1.WebSecurityScanner",
+          "method": "StopScanRun"
+        }
+      ],
+      "timeout": "600s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.websecurityscanner.v1.WebSecurityScanner",
+          "method": "DeleteScanConfig"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1.WebSecurityScanner",
+          "method": "GetScanConfig"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1.WebSecurityScanner",
+          "method": "ListScanConfigs"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1.WebSecurityScanner",
+          "method": "GetScanRun"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1.WebSecurityScanner",
+          "method": "ListScanRuns"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1.WebSecurityScanner",
+          "method": "GetFinding"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1.WebSecurityScanner",
+          "method": "ListFindings"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1.WebSecurityScanner",
+          "method": "ListFindingTypeStats"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1.WebSecurityScanner",
+          "method": "ListCrawledUrls"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1/websecurityscanner_v1.yaml b/third_party/googleapis/google/cloud/websecurityscanner/v1/websecurityscanner_v1.yaml
new file mode 100644
index 000000000..b79ef6f20
--- /dev/null
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1/websecurityscanner_v1.yaml
@@ -0,0 +1,22 @@
+type: google.api.Service
+config_version: 3
+name: websecurityscanner.googleapis.com
+title: Web Security Scanner API
+
+apis:
+- name: google.cloud.websecurityscanner.v1.WebSecurityScanner
+
+documentation:
+  summary: Scans your Compute and App Engine apps for common web vulnerabilities.
+
+backend:
+  rules:
+  - selector: 'google.cloud.websecurityscanner.v1.WebSecurityScanner.*'
+    deadline: 60.0
+
+authentication:
+  rules:
+  - selector: 'google.cloud.websecurityscanner.v1.WebSecurityScanner.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/BUILD.bazel b/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/BUILD.bazel
index 33c9e29ff..d94c332d1 100644
--- a/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/BUILD.bazel
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/BUILD.bazel
@@ -1,9 +1,12 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
@@ -19,6 +22,9 @@ proto_library(
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
         "@com_google_protobuf//:empty_proto",
         "@com_google_protobuf//:field_mask_proto",
         "@com_google_protobuf//:timestamp_proto",
@@ -27,7 +33,10 @@ proto_library(
 
 proto_library_with_info(
     name = "websecurityscanner_proto_with_info",
-    deps = [":websecurityscanner_proto"],
+    deps = [
+        ":websecurityscanner_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -35,18 +44,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
     name = "websecurityscanner_java_proto",
     deps = [":websecurityscanner_proto"],
@@ -55,49 +59,40 @@ java_proto_library(
 java_grpc_library(
     name = "websecurityscanner_java_grpc",
     srcs = [":websecurityscanner_proto"],
-    deps = [":websecurityscanner_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "websecurityscanner_resource_name_java_proto",
-    gapic_yaml = "websecurityscanner_gapic.yaml",
-    deps = [":websecurityscanner_proto"],
+    deps = [":websecurityscanner_java_proto"],
 )
 
 java_gapic_library(
     name = "websecurityscanner_java_gapic",
     src = ":websecurityscanner_proto_with_info",
     gapic_yaml = "websecurityscanner_gapic.yaml",
-    service_yaml = "//google/cloud/websecurityscanner:web_security_scanner_v1alpha.yaml",
-    test_deps = [":websecurityscanner_java_grpc"],
+    package = "google.cloud.websecurityscanner.v1alpha",
+    service_yaml = "websecurityscanner_v1alpha.yaml",
+    test_deps = [
+        ":websecurityscanner_java_grpc",
+    ],
     deps = [
         ":websecurityscanner_java_proto",
-        ":websecurityscanner_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
+java_gapic_test(
+    name = "websecurityscanner_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.websecurityscanner.v1alpha.WebSecurityScannerClientTest",
+    ],
     runtime_deps = [":websecurityscanner_java_gapic_test"],
-) for test_name in [
-    "com.google.cloud.websecurityscanner.v1alpha.WebSecurityScannerClientTest",
-]]
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-websecurityscanner-v1alpha-java",
-    client_deps = [":websecurityscanner_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":websecurityscanner_java_gapic_test"],
-    grpc_deps = [":websecurityscanner_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
-        ":websecurityscanner_resource_name_java_proto",
+    deps = [
+        ":websecurityscanner_java_gapic",
+        ":websecurityscanner_java_grpc",
         ":websecurityscanner_java_proto",
         ":websecurityscanner_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -105,10 +100,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -116,16 +111,20 @@ go_proto_library(
     compilers = ["@io_bazel_rules_go//proto:go_grpc"],
     importpath = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1alpha",
     protos = [":websecurityscanner_proto"],
-    deps = ["//google/api:annotations_go_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
 )
 
 go_gapic_library(
     name = "websecurityscanner_go_gapic",
-    src = ":websecurityscanner_proto_with_info",
-    gapic_yaml = "websecurityscanner_gapic.yaml",
-    importpath = "cloud.google.com/go/cloud/websecurityscanner/apiv1alpha",
-    service_yaml = "//google/cloud/websecurityscanner:web_security_scanner_v1alpha.yaml",
-    deps = [":websecurityscanner_go_proto"],
+    srcs = [":websecurityscanner_proto_with_info"],
+    grpc_service_config = "websecurityscanner_grpc_service_config.json",
+    importpath = "cloud.google.com/go/cloud/websecurityscanner/apiv1alpha;websecurityscanner",
+    service_yaml = "websecurityscanner_v1alpha.yaml",
+    deps = [
+        ":websecurityscanner_go_proto",
+    ],
 )
 
 go_test(
@@ -135,13 +134,235 @@ go_test(
     importpath = "cloud.google.com/go/cloud/websecurityscanner/apiv1alpha",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-websecurityscanner-v1alpha-go",
     deps = [
         ":websecurityscanner_go_gapic",
-        ":websecurityscanner_go_gapic_srcjar-smoke-test.srcjar",
         ":websecurityscanner_go_gapic_srcjar-test.srcjar",
         ":websecurityscanner_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "websecurityscanner_moved_proto",
+    srcs = [":websecurityscanner_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "websecurityscanner_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":websecurityscanner_moved_proto"],
+)
+
+py_grpc_library(
+    name = "websecurityscanner_py_grpc",
+    srcs = [":websecurityscanner_moved_proto"],
+    deps = [":websecurityscanner_py_proto"],
+)
+
+py_gapic_library(
+    name = "websecurityscanner_py_gapic",
+    src = ":websecurityscanner_proto_with_info",
+    gapic_yaml = "websecurityscanner_gapic.yaml",
+    package = "google.cloud.websecurityscanner.v1alpha",
+    service_yaml = "websecurityscanner_v1alpha.yaml",
+    deps = [
+        ":websecurityscanner_py_grpc",
+        ":websecurityscanner_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "websecurityscanner-v1alpha-py",
+    deps = [
+        ":websecurityscanner_py_gapic",
+        ":websecurityscanner_py_grpc",
+        ":websecurityscanner_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "websecurityscanner_php_proto",
+    deps = [":websecurityscanner_proto"],
+)
+
+php_grpc_library(
+    name = "websecurityscanner_php_grpc",
+    srcs = [":websecurityscanner_proto"],
+    deps = [":websecurityscanner_php_proto"],
+)
+
+php_gapic_library(
+    name = "websecurityscanner_php_gapic",
+    src = ":websecurityscanner_proto_with_info",
+    gapic_yaml = "websecurityscanner_gapic.yaml",
+    package = "google.cloud.websecurityscanner.v1alpha",
+    service_yaml = "websecurityscanner_v1alpha.yaml",
+    deps = [
+        ":websecurityscanner_php_grpc",
+        ":websecurityscanner_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-websecurityscanner-v1alpha-php",
+    deps = [
+        ":websecurityscanner_php_gapic",
+        ":websecurityscanner_php_grpc",
+        ":websecurityscanner_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "websecurityscanner_nodejs_gapic",
+    src = ":websecurityscanner_proto_with_info",
+    gapic_yaml = "websecurityscanner_gapic.yaml",
+    package = "google.cloud.websecurityscanner.v1alpha",
+    service_yaml = "websecurityscanner_v1alpha.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "websecurityscanner-v1alpha-nodejs",
+    deps = [
+        ":websecurityscanner_nodejs_gapic",
+        ":websecurityscanner_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "websecurityscanner_ruby_proto",
+    deps = [":websecurityscanner_proto"],
+)
+
+ruby_grpc_library(
+    name = "websecurityscanner_ruby_grpc",
+    srcs = [":websecurityscanner_proto"],
+    deps = [":websecurityscanner_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "websecurityscanner_ruby_gapic",
+    src = ":websecurityscanner_proto_with_info",
+    gapic_yaml = "websecurityscanner_gapic.yaml",
+    package = "google.cloud.websecurityscanner.v1alpha",
+    service_yaml = "websecurityscanner_v1alpha.yaml",
+    deps = [
+        ":websecurityscanner_ruby_grpc",
+        ":websecurityscanner_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-websecurityscanner-v1alpha-ruby",
+    deps = [
+        ":websecurityscanner_ruby_gapic",
+        ":websecurityscanner_ruby_grpc",
+        ":websecurityscanner_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "websecurityscanner_csharp_proto",
+    deps = [":websecurityscanner_proto"],
+)
+
+csharp_grpc_library(
+    name = "websecurityscanner_csharp_grpc",
+    srcs = [":websecurityscanner_proto"],
+    deps = [":websecurityscanner_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "websecurityscanner_csharp_gapic",
+    src = ":websecurityscanner_proto_with_info",
+    gapic_yaml = "websecurityscanner_gapic.yaml",
+    package = "google.cloud.websecurityscanner.v1alpha",
+    service_yaml = "websecurityscanner_v1alpha.yaml",
+    deps = [
+        ":websecurityscanner_csharp_grpc",
+        ":websecurityscanner_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-websecurityscanner-v1alpha-csharp",
+    deps = [
+        ":websecurityscanner_csharp_gapic",
+        ":websecurityscanner_csharp_grpc",
+        ":websecurityscanner_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/crawled_url.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/crawled_url.proto
index d4c40eae8..c22f4272f 100644
--- a/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/crawled_url.proto
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/crawled_url.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,12 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.websecurityscanner.v1alpha;
 
-import "google/api/annotations.proto";
-
 option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1alpha;websecurityscanner";
 option java_multiple_files = true;
 option java_outer_classname = "CrawledUrlProto";
@@ -27,16 +26,13 @@ option java_package = "com.google.cloud.websecurityscanner.v1alpha";
 // Security Scanner Service crawls the web applications, following all links
 // within the scope of sites, to find the URLs to test against.
 message CrawledUrl {
-  // Output only.
-  // The http method of the request that was used to visit the URL, in
+  // Output only. The http method of the request that was used to visit the URL, in
   // uppercase.
   string http_method = 1;
 
-  // Output only.
-  // The URL that was crawled.
+  // Output only. The URL that was crawled.
   string url = 2;
 
-  // Output only.
-  // The body of the request that was used to visit the URL.
+  // Output only. The body of the request that was used to visit the URL.
   string body = 3;
 }
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/finding.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/finding.proto
index 07140e276..c02020f34 100644
--- a/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/finding.proto
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/finding.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,12 +11,13 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.websecurityscanner.v1alpha;
 
-import "google/api/annotations.proto";
+import "google/api/resource.proto";
 import "google/cloud/websecurityscanner/v1alpha/finding_addon.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1alpha;websecurityscanner";
@@ -27,6 +28,11 @@ option java_package = "com.google.cloud.websecurityscanner.v1alpha";
 // A Finding resource represents a vulnerability instance identified during a
 // ScanRun.
 message Finding {
+  option (google.api.resource) = {
+    type: "websecurityscanner.googleapis.com/Finding"
+    pattern: "projects/{project}/scanConfigs/{scan_config}/scanRuns/{scan_run}/findings/{finding}"
+  };
+
   // Types of Findings.
   enum FindingType {
     // The invalid finding type.
@@ -71,70 +77,76 @@ message Finding {
     // An application appears to be transmitting a password field in clear text.
     // An attacker can eavesdrop network traffic and sniff the password field.
     CLEAR_TEXT_PASSWORD = 6;
+
+    // An application returns sensitive content with an invalid content type,
+    // or without an 'X-Content-Type-Options: nosniff' header.
+    INVALID_CONTENT_TYPE = 7;
+
+    // A cross-site scripting (XSS) vulnerability in AngularJS module that
+    // occurs when a user-provided string is interpolated by Angular.
+    XSS_ANGULAR_CALLBACK = 8;
+
+    // A malformed or invalid valued header.
+    INVALID_HEADER = 9;
+
+    // Misspelled security header name.
+    MISSPELLED_SECURITY_HEADER_NAME = 10;
+
+    // Mismatching values in a duplicate security header.
+    MISMATCHING_SECURITY_HEADER_VALUES = 11;
   }
 
-  // Output only.
   // The resource name of the Finding. The name follows the format of
   // 'projects/{projectId}/scanConfigs/{scanConfigId}/scanruns/{scanRunId}/findings/{findingId}'.
   // The finding IDs are generated by the system.
   string name = 1;
 
-  // Output only.
   // The type of the Finding.
   FindingType finding_type = 2;
 
-  // Output only.
   // The http method of the request that triggered the vulnerability, in
   // uppercase.
   string http_method = 3;
 
-  // Output only.
   // The URL produced by the server-side fuzzer and used in the request that
   // triggered the vulnerability.
   string fuzzed_url = 4;
 
-  // Output only.
   // The body of the request that triggered the vulnerability.
   string body = 5;
 
-  // Output only.
   // The description of the vulnerability.
   string description = 6;
 
-  // Output only.
   // The URL containing human-readable payload that user can leverage to
   // reproduce the vulnerability.
   string reproduction_url = 7;
 
-  // Output only.
   // If the vulnerability was originated from nested IFrame, the immediate
   // parent IFrame is reported.
   string frame_url = 8;
 
-  // Output only.
   // The URL where the browser lands when the vulnerability is detected.
   string final_url = 9;
 
-  // Output only.
   // The tracking ID uniquely identifies a vulnerability instance across
   // multiple ScanRuns.
   string tracking_id = 10;
 
-  // Output only.
   // An addon containing information about outdated libraries.
   OutdatedLibrary outdated_library = 11;
 
-  // Output only.
   // An addon containing detailed information regarding any resource causing the
   // vulnerability such as JavaScript sources, image, audio files, etc.
   ViolatingResource violating_resource = 12;
 
-  // Output only.
+  // An addon containing information about vulnerable or missing HTTP headers.
+  VulnerableHeaders vulnerable_headers = 15;
+
   // An addon containing information about request parameters which were found
   // to be vulnerable.
   VulnerableParameters vulnerable_parameters = 13;
 
-  // Output only.
   // An addon containing information reported for an XSS, if any.
   Xss xss = 14;
 }
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/finding_addon.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/finding_addon.proto
index a7d344b84..3fafdb402 100644
--- a/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/finding_addon.proto
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/finding_addon.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,12 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.websecurityscanner.v1alpha;
 
-import "google/api/annotations.proto";
-
 option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1alpha;websecurityscanner";
 option java_multiple_files = true;
 option java_outer_classname = "FindingAddonProto";
@@ -51,6 +50,24 @@ message VulnerableParameters {
   repeated string parameter_names = 1;
 }
 
+// Information about vulnerable or missing HTTP Headers.
+message VulnerableHeaders {
+  // Describes a HTTP Header.
+  message Header {
+    // Header name.
+    string name = 1;
+
+    // Header value.
+    string value = 2;
+  }
+
+  // List of vulnerable headers.
+  repeated Header headers = 1;
+
+  // List of missing headers.
+  repeated Header missing_headers = 2;
+}
+
 // Information reported for an XSS.
 message Xss {
   // Stack traces leading to the point where the XSS occurred.
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/finding_type_stats.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/finding_type_stats.proto
index 73115667f..e46b330c6 100644
--- a/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/finding_type_stats.proto
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/finding_type_stats.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,12 +11,12 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.websecurityscanner.v1alpha;
 
-import "google/api/annotations.proto";
 import "google/cloud/websecurityscanner/v1alpha/finding.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1alpha;websecurityscanner";
@@ -27,11 +27,9 @@ option java_package = "com.google.cloud.websecurityscanner.v1alpha";
 // A FindingTypeStats resource represents stats regarding a specific FindingType
 // of Findings under a given ScanRun.
 message FindingTypeStats {
-  // Output only.
   // The finding type associated with the stats.
   Finding.FindingType finding_type = 1;
 
-  // Output only.
   // The count of findings belonging to this finding type.
   int32 finding_count = 2;
 }
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/scan_config.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/scan_config.proto
index 144f7f2b5..5497b1a0f 100644
--- a/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/scan_config.proto
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/scan_config.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,12 +11,15 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.websecurityscanner.v1alpha;
 
-import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/cloud/websecurityscanner/v1alpha/scan_run.proto";
 import "google/protobuf/timestamp.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1alpha;websecurityscanner";
@@ -25,37 +28,42 @@ option java_outer_classname = "ScanConfigProto";
 option java_package = "com.google.cloud.websecurityscanner.v1alpha";
 
 // A ScanConfig resource contains the configurations to launch a scan.
+// next id: 12
 message ScanConfig {
+  option (google.api.resource) = {
+    type: "websecurityscanner.googleapis.com/ScanConfig"
+    pattern: "projects/{project}/scanConfigs/{scan_config}"
+  };
+
   // Scan authentication configuration.
   message Authentication {
     // Describes authentication configuration that uses a Google account.
     message GoogleAccount {
-      // Required.
-      // The user name of the Google account.
-      string username = 1;
-
-      // Input only.
-      // Required.
-      // The password of the Google account. The credential is stored encrypted
-      // and not returned in any response.
-      string password = 2;
+      // Required. The user name of the Google account.
+      string username = 1 [(google.api.field_behavior) = REQUIRED];
+
+      // Required. Input only. The password of the Google account. The credential is stored encrypted
+      // and not returned in any response nor included in audit logs.
+      string password = 2 [
+        (google.api.field_behavior) = REQUIRED,
+        (google.api.field_behavior) = INPUT_ONLY
+      ];
     }
 
     // Describes authentication configuration that uses a custom account.
     message CustomAccount {
-      // Required.
-      // The user name of the custom account.
-      string username = 1;
-
-      // Input only.
-      // Required.
-      // The password of the custom account. The credential is stored encrypted
-      // and not returned in any response.
-      string password = 2;
-
-      // Required.
-      // The login form URL of the website.
-      string login_url = 3;
+      // Required. The user name of the custom account.
+      string username = 1 [(google.api.field_behavior) = REQUIRED];
+
+      // Required. Input only. The password of the custom account. The credential is stored encrypted
+      // and not returned in any response nor included in audit logs.
+      string password = 2 [
+        (google.api.field_behavior) = REQUIRED,
+        (google.api.field_behavior) = INPUT_ONLY
+      ];
+
+      // Required. The login form URL of the website.
+      string login_url = 3 [(google.api.field_behavior) = REQUIRED];
     }
 
     // Required.
@@ -77,9 +85,8 @@ message ScanConfig {
     // immediately.
     google.protobuf.Timestamp schedule_time = 1;
 
-    // Required.
-    // The duration of time between executions in days.
-    int32 interval_duration_days = 2;
+    // Required. The duration of time between executions in days.
+    int32 interval_duration_days = 2 [(google.api.field_behavior) = REQUIRED];
   }
 
   // Type of user agents used for scanning.
@@ -115,9 +122,8 @@ message ScanConfig {
   // generated by the system.
   string name = 1;
 
-  // Required.
-  // The user provided display name of the ScanConfig.
-  string display_name = 2;
+  // Required. The user provided display name of the ScanConfig.
+  string display_name = 2 [(google.api.field_behavior) = REQUIRED];
 
   // The maximum QPS during scanning. A valid value ranges from 5 to 20
   // inclusively. If the field is unspecified or its value is set 0, server will
@@ -125,9 +131,8 @@ message ScanConfig {
   // INVALID_ARGUMENT error.
   int32 max_qps = 3;
 
-  // Required.
-  // The starting URLs from which the scanner finds site pages.
-  repeated string starting_urls = 4;
+  // Required. The starting URLs from which the scanner finds site pages.
+  repeated string starting_urls = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The authentication configuration. If specified, service will use the
   // authentication configuration during scanning.
@@ -146,4 +151,7 @@ message ScanConfig {
   // Set of Cloud Platforms targeted by the scan. If empty, APP_ENGINE will be
   // used as a default.
   repeated TargetPlatform target_platforms = 9;
+
+  // Latest ScanRun if available.
+  ScanRun latest_run = 11;
 }
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/scan_run.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/scan_run.proto
index 36e2d0925..79c541949 100644
--- a/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/scan_run.proto
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/scan_run.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,12 +11,13 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.websecurityscanner.v1alpha;
 
-import "google/api/annotations.proto";
+import "google/api/resource.proto";
 import "google/protobuf/timestamp.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1alpha;websecurityscanner";
@@ -26,6 +27,11 @@ option java_package = "com.google.cloud.websecurityscanner.v1alpha";
 
 // A ScanRun is a output-only resource representing an actual run of the scan.
 message ScanRun {
+  option (google.api.resource) = {
+    type: "websecurityscanner.googleapis.com/ScanRun"
+    pattern: "projects/{project}/scanConfigs/{scan_config}/scanRuns/{scan_run}"
+  };
+
   // Types of ScanRun execution state.
   enum ExecutionState {
     // Represents an invalid state caused by internal server error. This value
@@ -58,47 +64,38 @@ message ScanRun {
     KILLED = 3;
   }
 
-  // Output only.
   // The resource name of the ScanRun. The name follows the format of
   // 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
   // The ScanRun IDs are generated by the system.
   string name = 1;
 
-  // Output only.
   // The execution state of the ScanRun.
   ExecutionState execution_state = 2;
 
-  // Output only.
   // The result state of the ScanRun. This field is only available after the
   // execution state reaches "FINISHED".
   ResultState result_state = 3;
 
-  // Output only.
   // The time at which the ScanRun started.
   google.protobuf.Timestamp start_time = 4;
 
-  // Output only.
   // The time at which the ScanRun reached termination state - that the ScanRun
   // is either finished or stopped by user.
   google.protobuf.Timestamp end_time = 5;
 
-  // Output only.
   // The number of URLs crawled during this ScanRun. If the scan is in progress,
   // the value represents the number of URLs crawled up to now.
   int64 urls_crawled_count = 6;
 
-  // Output only.
   // The number of URLs tested during this ScanRun. If the scan is in progress,
   // the value represents the number of URLs tested up to now. The number of
   // URLs tested is usually larger than the number URLS crawled because
   // typically a crawled URL is tested with multiple test payloads.
   int64 urls_tested_count = 7;
 
-  // Output only.
   // Whether the scan run has found any vulnerabilities.
   bool has_vulnerabilities = 8;
 
-  // Output only.
   // The percentage of total completion ranging from 0 to 100.
   // If the scan is in queue, the value is 0.
   // If the scan is running, the value ranges from 0 to 100.
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/web_security_scanner.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/web_security_scanner.proto
index b07516aaf..f34bd74d5 100644
--- a/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/web_security_scanner.proto
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/web_security_scanner.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,12 +11,16 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.cloud.websecurityscanner.v1alpha;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/websecurityscanner/v1alpha/crawled_url.proto";
 import "google/cloud/websecurityscanner/v1alpha/finding.proto";
 import "google/cloud/websecurityscanner/v1alpha/finding_type_stats.proto";
@@ -34,20 +38,24 @@ option java_package = "com.google.cloud.websecurityscanner.v1alpha";
 // applications hosted on Google Cloud Platform. It crawls your application, and
 // attempts to exercise as many user inputs and event handlers as possible.
 service WebSecurityScanner {
+  option (google.api.default_host) = "websecurityscanner.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Creates a new ScanConfig.
   rpc CreateScanConfig(CreateScanConfigRequest) returns (ScanConfig) {
     option (google.api.http) = {
       post: "/v1alpha/{parent=projects/*}/scanConfigs"
       body: "scan_config"
     };
+    option (google.api.method_signature) = "parent,scan_config";
   }
 
   // Deletes an existing ScanConfig and its child resources.
-  rpc DeleteScanConfig(DeleteScanConfigRequest)
-      returns (google.protobuf.Empty) {
+  rpc DeleteScanConfig(DeleteScanConfigRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v1alpha/{name=projects/*/scanConfigs/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Gets a ScanConfig.
@@ -55,14 +63,15 @@ service WebSecurityScanner {
     option (google.api.http) = {
       get: "/v1alpha/{name=projects/*/scanConfigs/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists ScanConfigs under a given project.
-  rpc ListScanConfigs(ListScanConfigsRequest)
-      returns (ListScanConfigsResponse) {
+  rpc ListScanConfigs(ListScanConfigsRequest) returns (ListScanConfigsResponse) {
     option (google.api.http) = {
       get: "/v1alpha/{parent=projects/*}/scanConfigs"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Updates a ScanConfig. This method support partial update of a ScanConfig.
@@ -71,6 +80,7 @@ service WebSecurityScanner {
       patch: "/v1alpha/{scan_config.name=projects/*/scanConfigs/*}"
       body: "scan_config"
     };
+    option (google.api.method_signature) = "scan_config,update_mask";
   }
 
   // Start a ScanRun according to the given ScanConfig.
@@ -79,6 +89,7 @@ service WebSecurityScanner {
       post: "/v1alpha/{name=projects/*/scanConfigs/*}:start"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Gets a ScanRun.
@@ -86,6 +97,7 @@ service WebSecurityScanner {
     option (google.api.http) = {
       get: "/v1alpha/{name=projects/*/scanConfigs/*/scanRuns/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists ScanRuns under a given ScanConfig, in descending order of ScanRun
@@ -94,6 +106,7 @@ service WebSecurityScanner {
     option (google.api.http) = {
       get: "/v1alpha/{parent=projects/*/scanConfigs/*}/scanRuns"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Stops a ScanRun. The stopped ScanRun is returned.
@@ -102,14 +115,15 @@ service WebSecurityScanner {
       post: "/v1alpha/{name=projects/*/scanConfigs/*/scanRuns/*}:stop"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // List CrawledUrls under a given ScanRun.
-  rpc ListCrawledUrls(ListCrawledUrlsRequest)
-      returns (ListCrawledUrlsResponse) {
+  rpc ListCrawledUrls(ListCrawledUrlsRequest) returns (ListCrawledUrlsResponse) {
     option (google.api.http) = {
       get: "/v1alpha/{parent=projects/*/scanConfigs/*/scanRuns/*}/crawledUrls"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets a Finding.
@@ -117,6 +131,7 @@ service WebSecurityScanner {
     option (google.api.http) = {
       get: "/v1alpha/{name=projects/*/scanConfigs/*/scanRuns/*/findings/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // List Findings under a given ScanRun.
@@ -124,51 +139,67 @@ service WebSecurityScanner {
     option (google.api.http) = {
       get: "/v1alpha/{parent=projects/*/scanConfigs/*/scanRuns/*}/findings"
     };
+    option (google.api.method_signature) = "parent,filter";
   }
 
   // List all FindingTypeStats under a given ScanRun.
-  rpc ListFindingTypeStats(ListFindingTypeStatsRequest)
-      returns (ListFindingTypeStatsResponse) {
+  rpc ListFindingTypeStats(ListFindingTypeStatsRequest) returns (ListFindingTypeStatsResponse) {
     option (google.api.http) = {
       get: "/v1alpha/{parent=projects/*/scanConfigs/*/scanRuns/*}/findingTypeStats"
     };
+    option (google.api.method_signature) = "parent";
   }
 }
 
 // Request for the `CreateScanConfig` method.
 message CreateScanConfigRequest {
-  // Required.
-  // The parent resource name where the scan is created, which should be a
+  // Required. The parent resource name where the scan is created, which should be a
   // project resource name in the format 'projects/{projectId}'.
-  string parent = 1;
-
-  // Required.
-  // The ScanConfig to be created.
-  ScanConfig scan_config = 2;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
+
+  // Required. The ScanConfig to be created.
+  ScanConfig scan_config = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for the `DeleteScanConfig` method.
 message DeleteScanConfigRequest {
-  // Required.
-  // The resource name of the ScanConfig to be deleted. The name follows the
+  // Required. The resource name of the ScanConfig to be deleted. The name follows the
   // format of 'projects/{projectId}/scanConfigs/{scanConfigId}'.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "websecurityscanner.googleapis.com/ScanConfig"
+    }
+  ];
 }
 
 // Request for the `GetScanConfig` method.
 message GetScanConfigRequest {
-  // Required.
-  // The resource name of the ScanConfig to be returned. The name follows the
+  // Required. The resource name of the ScanConfig to be returned. The name follows the
   // format of 'projects/{projectId}/scanConfigs/{scanConfigId}'.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "websecurityscanner.googleapis.com/ScanConfig"
+    }
+  ];
 }
 
 // Request for the `ListScanConfigs` method.
 message ListScanConfigsRequest {
-  // Required.
-  // The parent resource name, which should be a project resource name in the
+  // Required. The parent resource name, which should be a project resource name in the
   // format 'projects/{projectId}'.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
   // A token identifying a page of results to be returned. This should be a
   // `next_page_token` value returned from a previous List request.
@@ -183,17 +214,15 @@ message ListScanConfigsRequest {
 
 // Request for the `UpdateScanConfigRequest` method.
 message UpdateScanConfigRequest {
-  // Required.
-  // The ScanConfig to be updated. The name field must be set to identify the
+  // Required. The ScanConfig to be updated. The name field must be set to identify the
   // resource to be updated. The values of fields not covered by the mask
   // will be ignored.
-  ScanConfig scan_config = 2;
+  ScanConfig scan_config = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Required.
-  // The update mask applies to the resource. For the `FieldMask` definition,
+  // Required. The update mask applies to the resource. For the `FieldMask` definition,
   // see
   // https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask
-  google.protobuf.FieldMask update_mask = 3;
+  google.protobuf.FieldMask update_mask = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response for the `ListScanConfigs` method.
@@ -208,27 +237,39 @@ message ListScanConfigsResponse {
 
 // Request for the `StartScanRun` method.
 message StartScanRunRequest {
-  // Required.
-  // The resource name of the ScanConfig to be used. The name follows the
+  // Required. The resource name of the ScanConfig to be used. The name follows the
   // format of 'projects/{projectId}/scanConfigs/{scanConfigId}'.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "websecurityscanner.googleapis.com/ScanConfig"
+    }
+  ];
 }
 
 // Request for the `GetScanRun` method.
 message GetScanRunRequest {
-  // Required.
-  // The resource name of the ScanRun to be returned. The name follows the
+  // Required. The resource name of the ScanRun to be returned. The name follows the
   // format of
   // 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "websecurityscanner.googleapis.com/ScanRun"
+    }
+  ];
 }
 
 // Request for the `ListScanRuns` method.
 message ListScanRunsRequest {
-  // Required.
-  // The parent resource name, which should be a scan resource name in the
+  // Required. The parent resource name, which should be a scan resource name in the
   // format 'projects/{projectId}/scanConfigs/{scanConfigId}'.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "websecurityscanner.googleapis.com/ScanConfig"
+    }
+  ];
 
   // A token identifying a page of results to be returned. This should be a
   // `next_page_token` value returned from a previous List request.
@@ -253,20 +294,28 @@ message ListScanRunsResponse {
 
 // Request for the `StopScanRun` method.
 message StopScanRunRequest {
-  // Required.
-  // The resource name of the ScanRun to be stopped. The name follows the
+  // Required. The resource name of the ScanRun to be stopped. The name follows the
   // format of
   // 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "websecurityscanner.googleapis.com/ScanRun"
+    }
+  ];
 }
 
 // Request for the `ListCrawledUrls` method.
 message ListCrawledUrlsRequest {
-  // Required.
-  // The parent resource name, which should be a scan run resource name in the
+  // Required. The parent resource name, which should be a scan run resource name in the
   // format
   // 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "websecurityscanner.googleapis.com/ScanRun"
+    }
+  ];
 
   // A token identifying a page of results to be returned. This should be a
   // `next_page_token` value returned from a previous List request.
@@ -291,26 +340,34 @@ message ListCrawledUrlsResponse {
 
 // Request for the `GetFinding` method.
 message GetFindingRequest {
-  // Required.
-  // The resource name of the Finding to be returned. The name follows the
+  // Required. The resource name of the Finding to be returned. The name follows the
   // format of
   // 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}/findings/{findingId}'.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "websecurityscanner.googleapis.com/Finding"
+    }
+  ];
 }
 
 // Request for the `ListFindings` method.
 message ListFindingsRequest {
-  // Required.
-  // The parent resource name, which should be a scan run resource name in the
+  // Required. The parent resource name, which should be a scan run resource name in the
   // format
   // 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
-  string parent = 1;
-
-  // The filter expression. The expression must be in the format: 
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "websecurityscanner.googleapis.com/ScanRun"
+    }
+  ];
+
+  // Required. The filter expression. The expression must be in the format: 
   //  .
   // Supported field: 'finding_type'.
   // Supported operator: '='.
-  string filter = 2;
+  string filter = 2 [(google.api.field_behavior) = REQUIRED];
 
   // A token identifying a page of results to be returned. This should be a
   // `next_page_token` value returned from a previous List request.
@@ -335,11 +392,15 @@ message ListFindingsResponse {
 
 // Request for the `ListFindingTypeStats` method.
 message ListFindingTypeStatsRequest {
-  // Required.
-  // The parent resource name, which should be a scan run resource name in the
+  // Required. The parent resource name, which should be a scan run resource name in the
   // format
   // 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "websecurityscanner.googleapis.com/ScanRun"
+    }
+  ];
 }
 
 // Response for the `ListFindingTypeStats` method.
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/websecurityscanner_gapic.legacy.yaml b/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/websecurityscanner_gapic.legacy.yaml
new file mode 100644
index 000000000..3b2c313c6
--- /dev/null
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/websecurityscanner_gapic.legacy.yaml
@@ -0,0 +1,356 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.websecurityscanner.v1alpha
+  python:
+    package_name: google.cloud.websecurityscanner_v1alpha.gapic
+  go:
+    package_name: cloud.google.com/go/cloud/websecurityscanner/apiv1alpha
+  csharp:
+    package_name: Google.Cloud.Websecurityscanner.V1Alpha
+  ruby:
+    package_name: Google::Cloud::Websecurityscanner::V1alpha
+  php:
+    package_name: Google\Cloud\Websecurityscanner\V1alpha
+  nodejs:
+    package_name: websecurityscanner.v1alpha
+# A list of API interface configurations.
+interfaces:
+  # The fully qualified name of the API interface.
+- name: google.cloud.websecurityscanner.v1alpha.WebSecurityScanner
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}
+    entity_name: project
+    language_overrides:
+    - language: csharp
+      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
+  - name_pattern: projects/{project}/scanConfigs/{scan_config}
+    entity_name: scan_config
+  - name_pattern: projects/{project}/scanConfigs/{scan_config}/scanRuns/{scan_run}
+    entity_name: scan_run
+  - name_pattern: projects/{project}/scanConfigs/{scan_config}/scanRuns/{scan_run}/findings/{finding}
+    entity_name: finding
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: CreateScanConfig
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - scan_config
+    required_fields:
+    - parent
+    - scan_config
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+  - name: DeleteScanConfig
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: scan_config
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+  - name: GetScanConfig
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: scan_config
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+  - name: ListScanConfigs
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: scan_configs
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+  - name: UpdateScanConfig
+    flattening:
+      groups:
+      - parameters:
+        - scan_config
+        - update_mask
+    required_fields:
+    - scan_config
+    - update_mask
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      scan_config.name: scan_config
+    timeout_millis: 60000
+  - name: StartScanRun
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: scan_config
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+  - name: GetScanRun
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: scan_run
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+  - name: ListScanRuns
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: scan_runs
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: scan_config
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+  - name: StopScanRun
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: scan_run
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+  - name: ListCrawledUrls
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: crawled_urls
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: scan_run
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+  - name: GetFinding
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: finding
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+  - name: ListFindings
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - filter
+    required_fields:
+    - parent
+    - filter
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: findings
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: scan_run
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+  - name: ListFindingTypeStats
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: scan_run
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+resource_name_generation:
+- message_name: CreateScanConfigRequest
+  field_entity_map:
+    parent: project
+- message_name: DeleteScanConfigRequest
+  field_entity_map:
+    name: scan_config
+- message_name: GetScanConfigRequest
+  field_entity_map:
+    name: scan_config
+- message_name: ListScanConfigsRequest
+  field_entity_map:
+    parent: project
+- message_name: StartScanRunRequest
+  field_entity_map:
+    name: scan_config
+- message_name: GetScanRunRequest
+  field_entity_map:
+    name: scan_run
+- message_name: ListScanRunsRequest
+  field_entity_map:
+    parent: scan_config
+- message_name: StopScanRunRequest
+  field_entity_map:
+    name: scan_run
+- message_name: ListCrawledUrlsRequest
+  field_entity_map:
+    parent: scan_run
+- message_name: GetFindingRequest
+  field_entity_map:
+    name: finding
+- message_name: ListFindingsRequest
+  field_entity_map:
+    parent: scan_run
+- message_name: ListFindingTypeStatsRequest
+  field_entity_map:
+    parent: scan_run
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/websecurityscanner_gapic.yaml b/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/websecurityscanner_gapic.yaml
index 3b2c313c6..d0dc6de6c 100644
--- a/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/websecurityscanner_gapic.yaml
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/websecurityscanner_gapic.yaml
@@ -1,6 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
-# The settings of generated code in a specific language.
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.websecurityscanner.v1alpha
@@ -16,341 +15,8 @@ language_settings:
     package_name: Google\Cloud\Websecurityscanner\V1alpha
   nodejs:
     package_name: websecurityscanner.v1alpha
-# A list of API interface configurations.
 interfaces:
-  # The fully qualified name of the API interface.
 - name: google.cloud.websecurityscanner.v1alpha.WebSecurityScanner
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections:
-  - name_pattern: projects/{project}
-    entity_name: project
-    language_overrides:
-    - language: csharp
-      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
-  - name_pattern: projects/{project}/scanConfigs/{scan_config}
-    entity_name: scan_config
-  - name_pattern: projects/{project}/scanConfigs/{scan_config}/scanRuns/{scan_run}
-    entity_name: scan_run
-  - name_pattern: projects/{project}/scanConfigs/{scan_config}/scanRuns/{scan_run}/findings/{finding}
-    entity_name: finding
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
   methods:
-  - name: CreateScanConfig
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - scan_config
-    required_fields:
-    - parent
-    - scan_config
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: project
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
   - name: DeleteScanConfig
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: scan_config
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
-  - name: GetScanConfig
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: scan_config
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
-  - name: ListScanConfigs
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: scan_configs
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: project
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
-  - name: UpdateScanConfig
-    flattening:
-      groups:
-      - parameters:
-        - scan_config
-        - update_mask
-    required_fields:
-    - scan_config
-    - update_mask
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      scan_config.name: scan_config
-    timeout_millis: 60000
-  - name: StartScanRun
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: scan_config
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
-  - name: GetScanRun
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: scan_run
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
-  - name: ListScanRuns
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: scan_runs
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: scan_config
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
-  - name: StopScanRun
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: scan_run
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
-  - name: ListCrawledUrls
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: crawled_urls
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: scan_run
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
-  - name: GetFinding
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: finding
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
-  - name: ListFindings
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - filter
-    required_fields:
-    - parent
-    - filter
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: findings
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: scan_run
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
-  - name: ListFindingTypeStats
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: scan_run
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
-resource_name_generation:
-- message_name: CreateScanConfigRequest
-  field_entity_map:
-    parent: project
-- message_name: DeleteScanConfigRequest
-  field_entity_map:
-    name: scan_config
-- message_name: GetScanConfigRequest
-  field_entity_map:
-    name: scan_config
-- message_name: ListScanConfigsRequest
-  field_entity_map:
-    parent: project
-- message_name: StartScanRunRequest
-  field_entity_map:
-    name: scan_config
-- message_name: GetScanRunRequest
-  field_entity_map:
-    name: scan_run
-- message_name: ListScanRunsRequest
-  field_entity_map:
-    parent: scan_config
-- message_name: StopScanRunRequest
-  field_entity_map:
-    name: scan_run
-- message_name: ListCrawledUrlsRequest
-  field_entity_map:
-    parent: scan_run
-- message_name: GetFindingRequest
-  field_entity_map:
-    name: finding
-- message_name: ListFindingsRequest
-  field_entity_map:
-    parent: scan_run
-- message_name: ListFindingTypeStatsRequest
-  field_entity_map:
-    parent: scan_run
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/websecurityscanner_grpc_service_config.json b/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/websecurityscanner_grpc_service_config.json
new file mode 100755
index 000000000..b14900e8d
--- /dev/null
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/websecurityscanner_grpc_service_config.json
@@ -0,0 +1,75 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.websecurityscanner.v1alpha.WebSecurityScanner",
+          "method": "CreateScanConfig"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1alpha.WebSecurityScanner",
+          "method": "UpdateScanConfig"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1alpha.WebSecurityScanner",
+          "method": "StartScanRun"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1alpha.WebSecurityScanner",
+          "method": "StopScanRun"
+        }
+      ],
+      "timeout": "600s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.websecurityscanner.v1alpha.WebSecurityScanner",
+          "method": "DeleteScanConfig"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1alpha.WebSecurityScanner",
+          "method": "GetScanConfig"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1alpha.WebSecurityScanner",
+          "method": "ListScanConfigs"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1alpha.WebSecurityScanner",
+          "method": "GetScanRun"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1alpha.WebSecurityScanner",
+          "method": "ListScanRuns"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1alpha.WebSecurityScanner",
+          "method": "ListCrawledUrls"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1alpha.WebSecurityScanner",
+          "method": "GetFinding"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1alpha.WebSecurityScanner",
+          "method": "ListFindings"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1alpha.WebSecurityScanner",
+          "method": "ListFindingTypeStats"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/web_security_scanner_v1alpha.yaml b/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/websecurityscanner_v1alpha.yaml
similarity index 54%
rename from third_party/googleapis/google/cloud/websecurityscanner/web_security_scanner_v1alpha.yaml
rename to third_party/googleapis/google/cloud/websecurityscanner/v1alpha/websecurityscanner_v1alpha.yaml
index a31df929a..2baa9745c 100644
--- a/third_party/googleapis/google/cloud/websecurityscanner/web_security_scanner_v1alpha.yaml
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1alpha/websecurityscanner_v1alpha.yaml
@@ -7,11 +7,16 @@ apis:
 - name: google.cloud.websecurityscanner.v1alpha.WebSecurityScanner
 
 documentation:
-  summary: Web Security Scanner API (under development).
+  summary: Scans your Compute and App Engine apps for common web vulnerabilities.
+
+backend:
+  rules:
+  - selector: 'google.cloud.websecurityscanner.v1alpha.WebSecurityScanner.*'
+    deadline: 60.0
 
 authentication:
   rules:
-  - selector: '*'
+  - selector: 'google.cloud.websecurityscanner.v1alpha.WebSecurityScanner.*'
     oauth:
       canonical_scopes: |-
         https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1beta/BUILD.bazel b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/BUILD.bazel
new file mode 100644
index 000000000..1bbf53867
--- /dev/null
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/BUILD.bazel
@@ -0,0 +1,371 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "websecurityscanner_proto",
+    srcs = [
+        "crawled_url.proto",
+        "finding.proto",
+        "finding_addon.proto",
+        "finding_type_stats.proto",
+        "scan_config.proto",
+        "scan_config_error.proto",
+        "scan_run.proto",
+        "scan_run_error_trace.proto",
+        "scan_run_warning_trace.proto",
+        "web_security_scanner.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "websecurityscanner_proto_with_info",
+    deps = [
+        ":websecurityscanner_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "websecurityscanner_java_proto",
+    deps = [":websecurityscanner_proto"],
+)
+
+java_grpc_library(
+    name = "websecurityscanner_java_grpc",
+    srcs = [":websecurityscanner_proto"],
+    deps = [":websecurityscanner_java_proto"],
+)
+
+java_gapic_library(
+    name = "websecurityscanner_java_gapic",
+    src = ":websecurityscanner_proto_with_info",
+    gapic_yaml = "websecurityscanner_gapic.yaml",
+    package = "google.cloud.websecurityscanner.v1beta",
+    service_yaml = "websecurityscanner_v1beta.yaml",
+    test_deps = [
+        ":websecurityscanner_java_grpc",
+    ],
+    deps = [
+        ":websecurityscanner_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "websecurityscanner_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.websecurityscanner.v1beta.WebSecurityScannerClientTest",
+    ],
+    runtime_deps = [":websecurityscanner_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-websecurityscanner-v1beta-java",
+    deps = [
+        ":websecurityscanner_java_gapic",
+        ":websecurityscanner_java_grpc",
+        ":websecurityscanner_java_proto",
+        ":websecurityscanner_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "websecurityscanner_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta",
+    protos = [":websecurityscanner_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "websecurityscanner_go_gapic",
+    srcs = [":websecurityscanner_proto_with_info"],
+    grpc_service_config = "websecurityscanner_grpc_service_config.json",
+    importpath = "cloud.google.com/go/websecurityscanner/apiv1beta;websecurityscanner",
+    service_yaml = "websecurityscanner_v1beta.yaml",
+    deps = [
+        ":websecurityscanner_go_proto",
+    ],
+)
+
+go_test(
+    name = "websecurityscanner_go_gapic_test",
+    srcs = [":websecurityscanner_go_gapic_srcjar_test"],
+    embed = [":websecurityscanner_go_gapic"],
+    importpath = "cloud.google.com/go/websecurityscanner/apiv1beta",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-websecurityscanner-v1beta-go",
+    deps = [
+        ":websecurityscanner_go_gapic",
+        ":websecurityscanner_go_gapic_srcjar-test.srcjar",
+        ":websecurityscanner_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "websecurityscanner_moved_proto",
+    srcs = [":websecurityscanner_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "websecurityscanner_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":websecurityscanner_moved_proto"],
+)
+
+py_grpc_library(
+    name = "websecurityscanner_py_grpc",
+    srcs = [":websecurityscanner_moved_proto"],
+    deps = [":websecurityscanner_py_proto"],
+)
+
+py_gapic_library(
+    name = "websecurityscanner_py_gapic",
+    src = ":websecurityscanner_proto_with_info",
+    gapic_yaml = "websecurityscanner_gapic.yaml",
+    package = "google.cloud.websecurityscanner.v1beta",
+    service_yaml = "websecurityscanner_v1beta.yaml",
+    deps = [
+        ":websecurityscanner_py_grpc",
+        ":websecurityscanner_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "websecurityscanner-v1beta-py",
+    deps = [
+        ":websecurityscanner_py_gapic",
+        ":websecurityscanner_py_grpc",
+        ":websecurityscanner_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "websecurityscanner_php_proto",
+    deps = [":websecurityscanner_proto"],
+)
+
+php_grpc_library(
+    name = "websecurityscanner_php_grpc",
+    srcs = [":websecurityscanner_proto"],
+    deps = [":websecurityscanner_php_proto"],
+)
+
+php_gapic_library(
+    name = "websecurityscanner_php_gapic",
+    src = ":websecurityscanner_proto_with_info",
+    gapic_yaml = "websecurityscanner_gapic.yaml",
+    package = "google.cloud.websecurityscanner.v1beta",
+    service_yaml = "websecurityscanner_v1beta.yaml",
+    deps = [
+        ":websecurityscanner_php_grpc",
+        ":websecurityscanner_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-websecurityscanner-v1beta-php",
+    deps = [
+        ":websecurityscanner_php_gapic",
+        ":websecurityscanner_php_grpc",
+        ":websecurityscanner_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "websecurityscanner_nodejs_gapic",
+    src = ":websecurityscanner_proto_with_info",
+    gapic_yaml = "websecurityscanner_gapic.yaml",
+    package = "google.cloud.websecurityscanner.v1beta",
+    service_yaml = "websecurityscanner_v1beta.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "websecurityscanner-v1beta-nodejs",
+    deps = [
+        ":websecurityscanner_nodejs_gapic",
+        ":websecurityscanner_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "websecurityscanner_ruby_proto",
+    deps = [":websecurityscanner_proto"],
+)
+
+ruby_grpc_library(
+    name = "websecurityscanner_ruby_grpc",
+    srcs = [":websecurityscanner_proto"],
+    deps = [":websecurityscanner_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "websecurityscanner_ruby_gapic",
+    src = ":websecurityscanner_proto_with_info",
+    gapic_yaml = "websecurityscanner_gapic.yaml",
+    package = "google.cloud.websecurityscanner.v1beta",
+    service_yaml = "websecurityscanner_v1beta.yaml",
+    deps = [
+        ":websecurityscanner_ruby_grpc",
+        ":websecurityscanner_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-websecurityscanner-v1beta-ruby",
+    deps = [
+        ":websecurityscanner_ruby_gapic",
+        ":websecurityscanner_ruby_grpc",
+        ":websecurityscanner_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "websecurityscanner_csharp_proto",
+    deps = [":websecurityscanner_proto"],
+)
+
+csharp_grpc_library(
+    name = "websecurityscanner_csharp_grpc",
+    srcs = [":websecurityscanner_proto"],
+    deps = [":websecurityscanner_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "websecurityscanner_csharp_gapic",
+    src = ":websecurityscanner_proto_with_info",
+    gapic_yaml = "websecurityscanner_gapic.yaml",
+    package = "google.cloud.websecurityscanner.v1beta",
+    service_yaml = "websecurityscanner_v1beta.yaml",
+    deps = [
+        ":websecurityscanner_csharp_grpc",
+        ":websecurityscanner_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-websecurityscanner-v1beta-csharp",
+    deps = [
+        ":websecurityscanner_csharp_gapic",
+        ":websecurityscanner_csharp_grpc",
+        ":websecurityscanner_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1beta/crawled_url.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/crawled_url.proto
index 92a0dc663..9316f8b2a 100644
--- a/third_party/googleapis/google/cloud/websecurityscanner/v1beta/crawled_url.proto
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/crawled_url.proto
@@ -17,8 +17,6 @@ syntax = "proto3";
 
 package google.cloud.websecurityscanner.v1beta;
 
-import "google/api/annotations.proto";
-
 option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner";
 option java_multiple_files = true;
 option java_outer_classname = "CrawledUrlProto";
@@ -29,16 +27,13 @@ option php_namespace = "Google\\Cloud\\WebSecurityScanner\\V1beta";
 // Security Scanner Service crawls the web applications, following all links
 // within the scope of sites, to find the URLs to test against.
 message CrawledUrl {
-  // Output only.
   // The http method of the request that was used to visit the URL, in
   // uppercase.
   string http_method = 1;
 
-  // Output only.
   // The URL that was crawled.
   string url = 2;
 
-  // Output only.
   // The body of the request that was used to visit the URL.
   string body = 3;
 }
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1beta/finding.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/finding.proto
index 5e25abb5d..5f86c9c71 100644
--- a/third_party/googleapis/google/cloud/websecurityscanner/v1beta/finding.proto
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/finding.proto
@@ -17,7 +17,7 @@ syntax = "proto3";
 
 package google.cloud.websecurityscanner.v1beta;
 
-import "google/api/annotations.proto";
+import "google/api/resource.proto";
 import "google/cloud/websecurityscanner/v1beta/finding_addon.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner";
@@ -29,79 +29,68 @@ option php_namespace = "Google\\Cloud\\WebSecurityScanner\\V1beta";
 // A Finding resource represents a vulnerability instance identified during a
 // ScanRun.
 message Finding {
-  // Output only.
+  option (google.api.resource) = {
+    type: "websecurityscanner.googleapis.com/Finding"
+    pattern: "projects/{project}/scanConfigs/{scan_config}/scanRuns/{scan_run}/findings/{finding}"
+  };
+
   // The resource name of the Finding. The name follows the format of
   // 'projects/{projectId}/scanConfigs/{scanConfigId}/scanruns/{scanRunId}/findings/{findingId}'.
   // The finding IDs are generated by the system.
   string name = 1;
 
-  // Output only.
   // The type of the Finding.
   // Detailed and up-to-date information on findings can be found here:
   // https://cloud.google.com/security-scanner/docs/scan-result-details
   string finding_type = 2;
 
-  // Output only.
   // The http method of the request that triggered the vulnerability, in
   // uppercase.
   string http_method = 3;
 
-  // Output only.
   // The URL produced by the server-side fuzzer and used in the request that
   // triggered the vulnerability.
   string fuzzed_url = 4;
 
-  // Output only.
   // The body of the request that triggered the vulnerability.
   string body = 5;
 
-  // Output only.
   // The description of the vulnerability.
   string description = 6;
 
-  // Output only.
   // The URL containing human-readable payload that user can leverage to
   // reproduce the vulnerability.
   string reproduction_url = 7;
 
-  // Output only.
   // If the vulnerability was originated from nested IFrame, the immediate
   // parent IFrame is reported.
   string frame_url = 8;
 
-  // Output only.
   // The URL where the browser lands when the vulnerability is detected.
   string final_url = 9;
 
-  // Output only.
   // The tracking ID uniquely identifies a vulnerability instance across
   // multiple ScanRuns.
   string tracking_id = 10;
 
-  // Output only.
   // An addon containing information reported for a vulnerability with an HTML
   // form, if any.
   Form form = 16;
 
-  // Output only.
   // An addon containing information about outdated libraries.
   OutdatedLibrary outdated_library = 11;
 
-  // Output only.
   // An addon containing detailed information regarding any resource causing the
   // vulnerability such as JavaScript sources, image, audio files, etc.
   ViolatingResource violating_resource = 12;
 
-  // Output only.
   // An addon containing information about vulnerable or missing HTTP headers.
   VulnerableHeaders vulnerable_headers = 15;
 
-  // Output only.
   // An addon containing information about request parameters which were found
   // to be vulnerable.
   VulnerableParameters vulnerable_parameters = 13;
 
-  // Output only.
   // An addon containing information reported for an XSS, if any.
   Xss xss = 14;
 }
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1beta/finding_addon.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/finding_addon.proto
index d2759b831..ea5989a13 100644
--- a/third_party/googleapis/google/cloud/websecurityscanner/v1beta/finding_addon.proto
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/finding_addon.proto
@@ -17,8 +17,6 @@ syntax = "proto3";
 
 package google.cloud.websecurityscanner.v1beta;
 
-import "google/api/annotations.proto";
-
 option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner";
 option java_multiple_files = true;
 option java_outer_classname = "FindingAddonProto";
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1beta/finding_type_stats.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/finding_type_stats.proto
index cbace23d3..97f4882d1 100644
--- a/third_party/googleapis/google/cloud/websecurityscanner/v1beta/finding_type_stats.proto
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/finding_type_stats.proto
@@ -17,8 +17,6 @@ syntax = "proto3";
 
 package google.cloud.websecurityscanner.v1beta;
 
-import "google/api/annotations.proto";
-
 option go_package = "google.golang.org/genproto/googleapis/cloud/websecurityscanner/v1beta;websecurityscanner";
 option java_multiple_files = true;
 option java_outer_classname = "FindingTypeStatsProto";
@@ -28,11 +26,9 @@ option php_namespace = "Google\\Cloud\\WebSecurityScanner\\V1beta";
 // A FindingTypeStats resource represents stats regarding a specific FindingType
 // of Findings under a given ScanRun.
 message FindingTypeStats {
-  // Output only.
   // The finding type associated with the stats.
   string finding_type = 1;
 
-  // Output only.
   // The count of findings belonging to this finding type.
   int32 finding_count = 2;
 }
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1beta/scan_config.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/scan_config.proto
index d698bb4f8..c2b7dcb31 100644
--- a/third_party/googleapis/google/cloud/websecurityscanner/v1beta/scan_config.proto
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/scan_config.proto
@@ -17,7 +17,8 @@ syntax = "proto3";
 
 package google.cloud.websecurityscanner.v1beta;
 
-import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/websecurityscanner/v1beta/scan_run.proto";
 import "google/protobuf/timestamp.proto";
 
@@ -29,36 +30,40 @@ option php_namespace = "Google\\Cloud\\WebSecurityScanner\\V1beta";
 
 // A ScanConfig resource contains the configurations to launch a scan.
 message ScanConfig {
+  option (google.api.resource) = {
+    type: "websecurityscanner.googleapis.com/ScanConfig"
+    pattern: "projects/{project}/scanConfigs/{scan_config}"
+  };
+
   // Scan authentication configuration.
   message Authentication {
     // Describes authentication configuration that uses a Google account.
     message GoogleAccount {
-      // Required.
-      // The user name of the Google account.
-      string username = 1;
+      // Required. The user name of the Google account.
+      string username = 1 [(google.api.field_behavior) = REQUIRED];
 
-      // Input only.
-      // Required.
-      // The password of the Google account. The credential is stored encrypted
+      // Required. Input only. The password of the Google account. The credential is stored encrypted
       // and not returned in any response nor included in audit logs.
-      string password = 2;
+      string password = 2 [
+        (google.api.field_behavior) = REQUIRED,
+        (google.api.field_behavior) = INPUT_ONLY
+      ];
     }
 
     // Describes authentication configuration that uses a custom account.
     message CustomAccount {
-      // Required.
-      // The user name of the custom account.
-      string username = 1;
+      // Required. The user name of the custom account.
+      string username = 1 [(google.api.field_behavior) = REQUIRED];
 
-      // Input only.
-      // Required.
-      // The password of the custom account. The credential is stored encrypted
+      // Required. Input only. The password of the custom account. The credential is stored encrypted
       // and not returned in any response nor included in audit logs.
-      string password = 2;
+      string password = 2 [
+        (google.api.field_behavior) = REQUIRED,
+        (google.api.field_behavior) = INPUT_ONLY
+      ];
 
-      // Required.
-      // The login form URL of the website.
-      string login_url = 3;
+      // Required. The login form URL of the website.
+      string login_url = 3 [(google.api.field_behavior) = REQUIRED];
     }
 
     // Required.
@@ -80,9 +85,8 @@ message ScanConfig {
     // immediately.
     google.protobuf.Timestamp schedule_time = 1;
 
-    // Required.
-    // The duration of time between executions in days.
-    int32 interval_duration_days = 2;
+    // Required. The duration of time between executions in days.
+    int32 interval_duration_days = 2 [(google.api.field_behavior) = REQUIRED];
   }
 
   // Type of user agents used for scanning.
@@ -145,9 +149,8 @@ message ScanConfig {
   // generated by the system.
   string name = 1;
 
-  // Required.
-  // The user provided display name of the ScanConfig.
-  string display_name = 2;
+  // Required. The user provided display name of the ScanConfig.
+  string display_name = 2 [(google.api.field_behavior) = REQUIRED];
 
   // The maximum QPS during scanning. A valid value ranges from 5 to 20
   // inclusively. If the field is unspecified or its value is set 0, server will
@@ -155,9 +158,8 @@ message ScanConfig {
   // INVALID_ARGUMENT error.
   int32 max_qps = 3;
 
-  // Required.
-  // The starting URLs from which the scanner finds site pages.
-  repeated string starting_urls = 4;
+  // Required. The starting URLs from which the scanner finds site pages.
+  repeated string starting_urls = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The authentication configuration. If specified, service will use the
   // authentication configuration during scanning.
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1beta/scan_config_error.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/scan_config_error.proto
index c55c744c6..a50bdcaf3 100644
--- a/third_party/googleapis/google/cloud/websecurityscanner/v1beta/scan_config_error.proto
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/scan_config_error.proto
@@ -30,7 +30,7 @@ option php_namespace = "Google\\Cloud\\WebSecurityScanner\\V1beta";
 message ScanConfigError {
   // Output only.
   // Defines an error reason code.
-  // Next id: 43
+  // Next id: 44
   enum Code {
     option allow_alias = true;
 
@@ -106,6 +106,9 @@ message ScanConfigError {
     // Google Compute Engine Scanning Alpha access.
     FORBIDDEN_TO_SCAN_COMPUTE = 21;
 
+    // User tries to update managed scan
+    FORBIDDEN_UPDATE_TO_MANAGED_SCAN = 43;
+
     // The supplied filter is malformed. For example, it can not be parsed, does
     // not have a filter type in expression, or the same filter type appears
     // more than once.
@@ -174,11 +177,9 @@ message ScanConfigError {
     UNSUPPORTED_URL_SCHEME = 42;
   }
 
-  // Output only.
   // Indicates the reason code for a configuration failure.
   Code code = 1;
 
-  // Output only.
   // Indicates the full name of the ScanConfig field that triggers this error,
   // for example "scan_config.max_qps". This field is provided for
   // troubleshooting purposes only and its actual value can change in the
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1beta/scan_run.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/scan_run.proto
index 497edc39b..84564c6e2 100644
--- a/third_party/googleapis/google/cloud/websecurityscanner/v1beta/scan_run.proto
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/scan_run.proto
@@ -17,7 +17,7 @@ syntax = "proto3";
 
 package google.cloud.websecurityscanner.v1beta;
 
-import "google/api/annotations.proto";
+import "google/api/resource.proto";
 import "google/cloud/websecurityscanner/v1beta/scan_run_error_trace.proto";
 import "google/cloud/websecurityscanner/v1beta/scan_run_warning_trace.proto";
 import "google/protobuf/timestamp.proto";
@@ -31,6 +31,11 @@ option php_namespace = "Google\\Cloud\\WebSecurityScanner\\V1beta";
 // A ScanRun is a output-only resource representing an actual run of the scan.
 // Next id: 12
 message ScanRun {
+  option (google.api.resource) = {
+    type: "websecurityscanner.googleapis.com/ScanRun"
+    pattern: "projects/{project}/scanConfigs/{scan_config}/scanRuns/{scan_run}"
+  };
+
   // Types of ScanRun execution state.
   enum ExecutionState {
     // Represents an invalid state caused by internal server error. This value
@@ -63,59 +68,48 @@ message ScanRun {
     KILLED = 3;
   }
 
-  // Output only.
   // The resource name of the ScanRun. The name follows the format of
   // 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
   // The ScanRun IDs are generated by the system.
   string name = 1;
 
-  // Output only.
   // The execution state of the ScanRun.
   ExecutionState execution_state = 2;
 
-  // Output only.
   // The result state of the ScanRun. This field is only available after the
   // execution state reaches "FINISHED".
   ResultState result_state = 3;
 
-  // Output only.
   // The time at which the ScanRun started.
   google.protobuf.Timestamp start_time = 4;
 
-  // Output only.
   // The time at which the ScanRun reached termination state - that the ScanRun
   // is either finished or stopped by user.
   google.protobuf.Timestamp end_time = 5;
 
-  // Output only.
   // The number of URLs crawled during this ScanRun. If the scan is in progress,
   // the value represents the number of URLs crawled up to now.
   int64 urls_crawled_count = 6;
 
-  // Output only.
   // The number of URLs tested during this ScanRun. If the scan is in progress,
   // the value represents the number of URLs tested up to now. The number of
   // URLs tested is usually larger than the number URLS crawled because
   // typically a crawled URL is tested with multiple test payloads.
   int64 urls_tested_count = 7;
 
-  // Output only.
   // Whether the scan run has found any vulnerabilities.
   bool has_vulnerabilities = 8;
 
-  // Output only.
   // The percentage of total completion ranging from 0 to 100.
   // If the scan is in queue, the value is 0.
   // If the scan is running, the value ranges from 0 to 100.
   // If the scan is finished, the value is 100.
   int32 progress_percent = 9;
 
-  // Output only.
   // If result_state is an ERROR, this field provides the primary reason for
   // scan's termination and more details, if such are available.
   ScanRunErrorTrace error_trace = 10;
 
-  // Output only.
   // A list of warnings, if such are encountered during this scan run.
   repeated ScanRunWarningTrace warning_traces = 11;
 }
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1beta/scan_run_error_trace.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/scan_run_error_trace.proto
index 3d1a391dc..248967d24 100644
--- a/third_party/googleapis/google/cloud/websecurityscanner/v1beta/scan_run_error_trace.proto
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/scan_run_error_trace.proto
@@ -55,21 +55,18 @@ message ScanRunErrorTrace {
 
     // Indicates that a scan encountered numerous errors from the web site
     // pages. When available, most_common_http_error_code field indicates the
-    // the most common HTTP error code encountered during the scan.
+    // most common HTTP error code encountered during the scan.
     TOO_MANY_HTTP_ERRORS = 6;
   }
 
-  // Output only.
   // Indicates the error reason code.
   Code code = 1;
 
-  // Output only.
   // If the scan encounters SCAN_CONFIG_ISSUE error, this field has the error
   // message encountered during scan configuration validation that is performed
   // before each scan run.
   ScanConfigError scan_config_error = 2;
 
-  // Output only.
   // If the scan encounters TOO_MANY_HTTP_ERRORS, this field indicates the most
   // common HTTP error code, if such is available. For example, if this code is
   // 404, the scan has encountered too many NOT_FOUND responses.
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1beta/scan_run_warning_trace.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/scan_run_warning_trace.proto
index e461ad0b5..8207a0290 100644
--- a/third_party/googleapis/google/cloud/websecurityscanner/v1beta/scan_run_warning_trace.proto
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/scan_run_warning_trace.proto
@@ -29,7 +29,7 @@ option php_namespace = "Google\\Cloud\\WebSecurityScanner\\V1beta";
 message ScanRunWarningTrace {
   // Output only.
   // Defines a warning message code.
-  // Next id: 5
+  // Next id: 6
   enum Code {
     // Default value is never used.
     CODE_UNSPECIFIED = 0;
@@ -52,7 +52,6 @@ message ScanRunWarningTrace {
     BLOCKED_BY_IAP = 4;
   }
 
-  // Output only.
   // Indicates the warning code.
   Code code = 1;
 }
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1beta/web_security_scanner.proto b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/web_security_scanner.proto
index d328a2860..9ea6207c2 100644
--- a/third_party/googleapis/google/cloud/websecurityscanner/v1beta/web_security_scanner.proto
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/web_security_scanner.proto
@@ -18,6 +18,9 @@ syntax = "proto3";
 package google.cloud.websecurityscanner.v1beta;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/websecurityscanner/v1beta/crawled_url.proto";
 import "google/cloud/websecurityscanner/v1beta/finding.proto";
 import "google/cloud/websecurityscanner/v1beta/finding_type_stats.proto";
@@ -36,12 +39,16 @@ option php_namespace = "Google\\Cloud\\WebSecurityScanner\\V1beta";
 // applications hosted on Google Cloud Platform. It crawls your application, and
 // attempts to exercise as many user inputs and event handlers as possible.
 service WebSecurityScanner {
+  option (google.api.default_host) = "websecurityscanner.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Creates a new ScanConfig.
   rpc CreateScanConfig(CreateScanConfigRequest) returns (ScanConfig) {
     option (google.api.http) = {
       post: "/v1beta/{parent=projects/*}/scanConfigs"
       body: "scan_config"
     };
+    option (google.api.method_signature) = "parent,scan_config";
   }
 
   // Deletes an existing ScanConfig and its child resources.
@@ -49,6 +56,7 @@ service WebSecurityScanner {
     option (google.api.http) = {
       delete: "/v1beta/{name=projects/*/scanConfigs/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Gets a ScanConfig.
@@ -56,6 +64,7 @@ service WebSecurityScanner {
     option (google.api.http) = {
       get: "/v1beta/{name=projects/*/scanConfigs/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists ScanConfigs under a given project.
@@ -63,6 +72,7 @@ service WebSecurityScanner {
     option (google.api.http) = {
       get: "/v1beta/{parent=projects/*}/scanConfigs"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Updates a ScanConfig. This method support partial update of a ScanConfig.
@@ -71,6 +81,7 @@ service WebSecurityScanner {
       patch: "/v1beta/{scan_config.name=projects/*/scanConfigs/*}"
       body: "scan_config"
     };
+    option (google.api.method_signature) = "scan_config,update_mask";
   }
 
   // Start a ScanRun according to the given ScanConfig.
@@ -79,6 +90,7 @@ service WebSecurityScanner {
       post: "/v1beta/{name=projects/*/scanConfigs/*}:start"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Gets a ScanRun.
@@ -86,6 +98,7 @@ service WebSecurityScanner {
     option (google.api.http) = {
       get: "/v1beta/{name=projects/*/scanConfigs/*/scanRuns/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists ScanRuns under a given ScanConfig, in descending order of ScanRun
@@ -94,6 +107,7 @@ service WebSecurityScanner {
     option (google.api.http) = {
       get: "/v1beta/{parent=projects/*/scanConfigs/*}/scanRuns"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Stops a ScanRun. The stopped ScanRun is returned.
@@ -102,6 +116,7 @@ service WebSecurityScanner {
       post: "/v1beta/{name=projects/*/scanConfigs/*/scanRuns/*}:stop"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // List CrawledUrls under a given ScanRun.
@@ -109,6 +124,7 @@ service WebSecurityScanner {
     option (google.api.http) = {
       get: "/v1beta/{parent=projects/*/scanConfigs/*/scanRuns/*}/crawledUrls"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets a Finding.
@@ -116,6 +132,7 @@ service WebSecurityScanner {
     option (google.api.http) = {
       get: "/v1beta/{name=projects/*/scanConfigs/*/scanRuns/*/findings/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // List Findings under a given ScanRun.
@@ -123,6 +140,7 @@ service WebSecurityScanner {
     option (google.api.http) = {
       get: "/v1beta/{parent=projects/*/scanConfigs/*/scanRuns/*}/findings"
     };
+    option (google.api.method_signature) = "parent,filter";
   }
 
   // List all FindingTypeStats under a given ScanRun.
@@ -130,43 +148,59 @@ service WebSecurityScanner {
     option (google.api.http) = {
       get: "/v1beta/{parent=projects/*/scanConfigs/*/scanRuns/*}/findingTypeStats"
     };
+    option (google.api.method_signature) = "parent";
   }
 }
 
 // Request for the `CreateScanConfig` method.
 message CreateScanConfigRequest {
-  // Required.
-  // The parent resource name where the scan is created, which should be a
+  // Required. The parent resource name where the scan is created, which should be a
   // project resource name in the format 'projects/{projectId}'.
-  string parent = 1;
-
-  // Required.
-  // The ScanConfig to be created.
-  ScanConfig scan_config = 2;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
+
+  // Required. The ScanConfig to be created.
+  ScanConfig scan_config = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for the `DeleteScanConfig` method.
 message DeleteScanConfigRequest {
-  // Required.
-  // The resource name of the ScanConfig to be deleted. The name follows the
+  // Required. The resource name of the ScanConfig to be deleted. The name follows the
   // format of 'projects/{projectId}/scanConfigs/{scanConfigId}'.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "websecurityscanner.googleapis.com/ScanConfig"
+    }
+  ];
 }
 
 // Request for the `GetScanConfig` method.
 message GetScanConfigRequest {
-  // Required.
-  // The resource name of the ScanConfig to be returned. The name follows the
+  // Required. The resource name of the ScanConfig to be returned. The name follows the
   // format of 'projects/{projectId}/scanConfigs/{scanConfigId}'.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "websecurityscanner.googleapis.com/ScanConfig"
+    }
+  ];
 }
 
 // Request for the `ListScanConfigs` method.
 message ListScanConfigsRequest {
-  // Required.
-  // The parent resource name, which should be a project resource name in the
+  // Required. The parent resource name, which should be a project resource name in the
   // format 'projects/{projectId}'.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
   // A token identifying a page of results to be returned. This should be a
   // `next_page_token` value returned from a previous List request.
@@ -181,17 +215,15 @@ message ListScanConfigsRequest {
 
 // Request for the `UpdateScanConfigRequest` method.
 message UpdateScanConfigRequest {
-  // Required.
-  // The ScanConfig to be updated. The name field must be set to identify the
+  // Required. The ScanConfig to be updated. The name field must be set to identify the
   // resource to be updated. The values of fields not covered by the mask
   // will be ignored.
-  ScanConfig scan_config = 2;
+  ScanConfig scan_config = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Required.
-  // The update mask applies to the resource. For the `FieldMask` definition,
+  // Required. The update mask applies to the resource. For the `FieldMask` definition,
   // see
   // https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask
-  google.protobuf.FieldMask update_mask = 3;
+  google.protobuf.FieldMask update_mask = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response for the `ListScanConfigs` method.
@@ -206,27 +238,39 @@ message ListScanConfigsResponse {
 
 // Request for the `StartScanRun` method.
 message StartScanRunRequest {
-  // Required.
-  // The resource name of the ScanConfig to be used. The name follows the
+  // Required. The resource name of the ScanConfig to be used. The name follows the
   // format of 'projects/{projectId}/scanConfigs/{scanConfigId}'.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "websecurityscanner.googleapis.com/ScanConfig"
+    }
+  ];
 }
 
 // Request for the `GetScanRun` method.
 message GetScanRunRequest {
-  // Required.
-  // The resource name of the ScanRun to be returned. The name follows the
+  // Required. The resource name of the ScanRun to be returned. The name follows the
   // format of
   // 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "websecurityscanner.googleapis.com/ScanRun"
+    }
+  ];
 }
 
 // Request for the `ListScanRuns` method.
 message ListScanRunsRequest {
-  // Required.
-  // The parent resource name, which should be a scan resource name in the
+  // Required. The parent resource name, which should be a scan resource name in the
   // format 'projects/{projectId}/scanConfigs/{scanConfigId}'.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "websecurityscanner.googleapis.com/ScanConfig"
+    }
+  ];
 
   // A token identifying a page of results to be returned. This should be a
   // `next_page_token` value returned from a previous List request.
@@ -251,20 +295,28 @@ message ListScanRunsResponse {
 
 // Request for the `StopScanRun` method.
 message StopScanRunRequest {
-  // Required.
-  // The resource name of the ScanRun to be stopped. The name follows the
+  // Required. The resource name of the ScanRun to be stopped. The name follows the
   // format of
   // 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "websecurityscanner.googleapis.com/ScanRun"
+    }
+  ];
 }
 
 // Request for the `ListCrawledUrls` method.
 message ListCrawledUrlsRequest {
-  // Required.
-  // The parent resource name, which should be a scan run resource name in the
+  // Required. The parent resource name, which should be a scan run resource name in the
   // format
   // 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "websecurityscanner.googleapis.com/ScanRun"
+    }
+  ];
 
   // A token identifying a page of results to be returned. This should be a
   // `next_page_token` value returned from a previous List request.
@@ -289,26 +341,34 @@ message ListCrawledUrlsResponse {
 
 // Request for the `GetFinding` method.
 message GetFindingRequest {
-  // Required.
-  // The resource name of the Finding to be returned. The name follows the
+  // Required. The resource name of the Finding to be returned. The name follows the
   // format of
   // 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}/findings/{findingId}'.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "websecurityscanner.googleapis.com/Finding"
+    }
+  ];
 }
 
 // Request for the `ListFindings` method.
 message ListFindingsRequest {
-  // Required.
-  // The parent resource name, which should be a scan run resource name in the
+  // Required. The parent resource name, which should be a scan run resource name in the
   // format
   // 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
-  string parent = 1;
-
-  // The filter expression. The expression must be in the format: 
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "websecurityscanner.googleapis.com/ScanRun"
+    }
+  ];
+
+  // Required. The filter expression. The expression must be in the format: 
   //  .
   // Supported field: 'finding_type'.
   // Supported operator: '='.
-  string filter = 2;
+  string filter = 2 [(google.api.field_behavior) = REQUIRED];
 
   // A token identifying a page of results to be returned. This should be a
   // `next_page_token` value returned from a previous List request.
@@ -333,11 +393,15 @@ message ListFindingsResponse {
 
 // Request for the `ListFindingTypeStats` method.
 message ListFindingTypeStatsRequest {
-  // Required.
-  // The parent resource name, which should be a scan run resource name in the
+  // Required. The parent resource name, which should be a scan run resource name in the
   // format
   // 'projects/{projectId}/scanConfigs/{scanConfigId}/scanRuns/{scanRunId}'.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "websecurityscanner.googleapis.com/ScanRun"
+    }
+  ];
 }
 
 // Response for the `ListFindingTypeStats` method.
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1beta/websecurityscanner_gapic.legacy.yaml b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/websecurityscanner_gapic.legacy.yaml
new file mode 100644
index 000000000..89cfd29f0
--- /dev/null
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/websecurityscanner_gapic.legacy.yaml
@@ -0,0 +1,294 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.websecurityscanner.v1beta
+  python:
+    package_name: google.cloud.websecurityscanner_v1beta.gapic
+  go:
+    package_name: cloud.google.com/go/websecurityscanner/apiv1beta
+  csharp:
+    package_name: Google.Cloud.Websecurityscanner.V1beta
+  ruby:
+    package_name: Google::Cloud::Websecurityscanner::V1beta
+  php:
+    package_name: Google\Cloud\WebSecurityScanner\V1beta
+  nodejs:
+    package_name: websecurityscanner.v1beta
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: google.cloud.websecurityscanner.v1beta.WebSecurityScanner
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}
+    entity_name: project
+  - name_pattern: projects/{project}/scanConfigs/{scan_config}
+    entity_name: scan_config
+  - name_pattern: projects/{project}/scanConfigs/{scan_config}/scanRuns/{scan_run}
+    entity_name: scan_run
+  - name_pattern: projects/{project}/scanConfigs/{scan_config}/scanRuns/{scan_run}/findings/{finding}
+    entity_name: finding
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: CreateScanConfig
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - scan_config
+    required_fields:
+    - parent
+    - scan_config
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 60000
+  - name: DeleteScanConfig
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: scan_config
+    timeout_millis: 60000
+  - name: GetScanConfig
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: scan_config
+    timeout_millis: 60000
+  - name: ListScanConfigs
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: scan_configs
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 60000
+  - name: UpdateScanConfig
+    flattening:
+      groups:
+      - parameters:
+        - scan_config
+        - update_mask
+    required_fields:
+    - scan_config
+    - update_mask
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      scan_config.name: scan_config
+    timeout_millis: 60000
+  - name: StartScanRun
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: scan_config
+    timeout_millis: 60000
+  - name: GetScanRun
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: scan_run
+    timeout_millis: 60000
+  - name: ListScanRuns
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: scan_runs
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: scan_config
+    timeout_millis: 60000
+  - name: StopScanRun
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: scan_run
+    timeout_millis: 60000
+  - name: ListCrawledUrls
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: crawled_urls
+    retry_params_name: default
+    field_name_patterns:
+      parent: scan_run
+    timeout_millis: 60000
+  - name: GetFinding
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: finding
+    timeout_millis: 60000
+  - name: ListFindings
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - filter
+    required_fields:
+    - parent
+    - filter
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: findings
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: scan_run
+    timeout_millis: 60000
+  - name: ListFindingTypeStats
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: scan_run
+    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1beta/websecurityscanner_gapic.yaml b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/websecurityscanner_gapic.yaml
index 89cfd29f0..13033ded3 100644
--- a/third_party/googleapis/google/cloud/websecurityscanner/v1beta/websecurityscanner_gapic.yaml
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/websecurityscanner_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -16,279 +16,8 @@ language_settings:
     package_name: Google\Cloud\WebSecurityScanner\V1beta
   nodejs:
     package_name: websecurityscanner.v1beta
-# A list of API interface configurations.
 interfaces:
-# The fully qualified name of the API interface.
 - name: google.cloud.websecurityscanner.v1beta.WebSecurityScanner
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections:
-  - name_pattern: projects/{project}
-    entity_name: project
-  - name_pattern: projects/{project}/scanConfigs/{scan_config}
-    entity_name: scan_config
-  - name_pattern: projects/{project}/scanConfigs/{scan_config}/scanRuns/{scan_run}
-    entity_name: scan_run
-  - name_pattern: projects/{project}/scanConfigs/{scan_config}/scanRuns/{scan_run}/findings/{finding}
-    entity_name: finding
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
   methods:
-  - name: CreateScanConfig
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - scan_config
-    required_fields:
-    - parent
-    - scan_config
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: project
-    timeout_millis: 60000
   - name: DeleteScanConfig
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: scan_config
-    timeout_millis: 60000
-  - name: GetScanConfig
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: scan_config
-    timeout_millis: 60000
-  - name: ListScanConfigs
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: scan_configs
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: project
-    timeout_millis: 60000
-  - name: UpdateScanConfig
-    flattening:
-      groups:
-      - parameters:
-        - scan_config
-        - update_mask
-    required_fields:
-    - scan_config
-    - update_mask
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      scan_config.name: scan_config
-    timeout_millis: 60000
-  - name: StartScanRun
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: scan_config
-    timeout_millis: 60000
-  - name: GetScanRun
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: scan_run
-    timeout_millis: 60000
-  - name: ListScanRuns
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: scan_runs
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: scan_config
-    timeout_millis: 60000
-  - name: StopScanRun
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: scan_run
-    timeout_millis: 60000
-  - name: ListCrawledUrls
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: crawled_urls
-    retry_params_name: default
-    field_name_patterns:
-      parent: scan_run
-    timeout_millis: 60000
-  - name: GetFinding
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: finding
-    timeout_millis: 60000
-  - name: ListFindings
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - filter
-    required_fields:
-    - parent
-    - filter
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: findings
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: scan_run
-    timeout_millis: 60000
-  - name: ListFindingTypeStats
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: scan_run
-    timeout_millis: 60000
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/v1beta/websecurityscanner_grpc_service_config.json b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/websecurityscanner_grpc_service_config.json
new file mode 100755
index 000000000..09e52474f
--- /dev/null
+++ b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/websecurityscanner_grpc_service_config.json
@@ -0,0 +1,75 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.cloud.websecurityscanner.v1beta.WebSecurityScanner",
+          "method": "CreateScanConfig"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1beta.WebSecurityScanner",
+          "method": "UpdateScanConfig"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1beta.WebSecurityScanner",
+          "method": "StartScanRun"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1beta.WebSecurityScanner",
+          "method": "StopScanRun"
+        }
+      ],
+      "timeout": "600s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.cloud.websecurityscanner.v1beta.WebSecurityScanner",
+          "method": "DeleteScanConfig"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1beta.WebSecurityScanner",
+          "method": "GetScanConfig"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1beta.WebSecurityScanner",
+          "method": "ListScanConfigs"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1beta.WebSecurityScanner",
+          "method": "GetScanRun"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1beta.WebSecurityScanner",
+          "method": "ListScanRuns"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1beta.WebSecurityScanner",
+          "method": "GetFinding"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1beta.WebSecurityScanner",
+          "method": "ListFindings"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1beta.WebSecurityScanner",
+          "method": "ListFindingTypeStats"
+        },
+        {
+          "service": "google.cloud.websecurityscanner.v1beta.WebSecurityScanner",
+          "method": "ListCrawledUrls"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/cloud/websecurityscanner/websecurityscanner_v1beta.yaml b/third_party/googleapis/google/cloud/websecurityscanner/v1beta/websecurityscanner_v1beta.yaml
similarity index 100%
rename from third_party/googleapis/google/cloud/websecurityscanner/websecurityscanner_v1beta.yaml
rename to third_party/googleapis/google/cloud/websecurityscanner/v1beta/websecurityscanner_v1beta.yaml
diff --git a/third_party/googleapis/google/container/artman_container_v1.yaml b/third_party/googleapis/google/container/artman_container_v1.yaml
index fc01e9631..30121e141 100644
--- a/third_party/googleapis/google/container/artman_container_v1.yaml
+++ b/third_party/googleapis/google/container/artman_container_v1.yaml
@@ -3,11 +3,12 @@ common:
   api_version: v1
   organization_name: google-cloud
   proto_deps:
-    - name: google-common-protos
+  - name: google-common-protos
   src_proto_paths:
   - v1
-  service_yaml: container_v1.yaml
+  service_yaml: v1/container_v1.yaml
   gapic_yaml: v1/container_gapic.yaml
+  proto_package: google.container.v1
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/container/artman_container_v1beta1.yaml b/third_party/googleapis/google/container/artman_container_v1beta1.yaml
index 9a81ab4b2..befe0780a 100644
--- a/third_party/googleapis/google/container/artman_container_v1beta1.yaml
+++ b/third_party/googleapis/google/container/artman_container_v1beta1.yaml
@@ -3,11 +3,12 @@ common:
   api_version: v1beta1
   organization_name: google-cloud
   proto_deps:
-    - name: google-common-protos
+  - name: google-common-protos
   src_proto_paths:
   - v1beta1
-  service_yaml: container_v1beta1.yaml
+  service_yaml: v1beta1/container_v1beta1.yaml
   gapic_yaml: v1beta1/container_gapic.yaml
+  proto_package: google.container.v1beta1
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/container/container_v1.yaml b/third_party/googleapis/google/container/container_v1.yaml
deleted file mode 100644
index 65e5001bd..000000000
--- a/third_party/googleapis/google/container/container_v1.yaml
+++ /dev/null
@@ -1,82 +0,0 @@
-type: google.api.Service
-config_version: 3
-name: container.googleapis.com
-title: Kubernetes Engine API
-
-apis:
-- name: google.container.v1.ClusterManager
-
-documentation:
-  summary: |-
-    The Google Kubernetes Engine API is used for building and managing container
-    based applications, powered by the open source Kubernetes technology.
-
-backend:
-  rules:
-  - selector: google.container.v1.ClusterManager.ListClusters
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.GetCluster
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.CreateCluster
-    deadline: 45.0
-  - selector: google.container.v1.ClusterManager.UpdateCluster
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.UpdateNodePool
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.SetNodePoolAutoscaling
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.SetLoggingService
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.SetMonitoringService
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.SetAddonsConfig
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.SetLocations
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.UpdateMaster
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.SetMasterAuth
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.DeleteCluster
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.ListOperations
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.GetOperation
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.CancelOperation
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.GetServerConfig
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.ListNodePools
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.GetNodePool
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.CreateNodePool
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.DeleteNodePool
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.RollbackNodePoolUpgrade
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.SetNodePoolManagement
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.SetLabels
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.SetLegacyAbac
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.StartIPRotation
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.CompleteIPRotation
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.SetNodePoolSize
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.SetNetworkPolicy
-    deadline: 20.0
-  - selector: google.container.v1.ClusterManager.SetMaintenancePolicy
-    deadline: 20.0
-
-authentication:
-  rules:
-  - selector: '*'
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/container/container_v1beta1.yaml b/third_party/googleapis/google/container/container_v1beta1.yaml
deleted file mode 100644
index 223e518be..000000000
--- a/third_party/googleapis/google/container/container_v1beta1.yaml
+++ /dev/null
@@ -1,86 +0,0 @@
-type: google.api.Service
-config_version: 3
-name: container.googleapis.com
-title: Kubernetes Engine API
-
-apis:
-- name: google.container.v1beta1.ClusterManager
-
-documentation:
-  summary: |-
-    Builds and manages container-based applications, powered by the open source
-    Kubernetes technology.
-
-backend:
-  rules:
-  - selector: google.container.v1beta1.ClusterManager.ListClusters
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.GetCluster
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.CreateCluster
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.UpdateCluster
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.UpdateNodePool
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.SetNodePoolAutoscaling
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.SetLoggingService
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.SetMonitoringService
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.SetAddonsConfig
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.SetLocations
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.UpdateMaster
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.SetMasterAuth
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.DeleteCluster
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.ListOperations
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.GetOperation
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.CancelOperation
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.GetServerConfig
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.ListNodePools
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.GetNodePool
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.CreateNodePool
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.DeleteNodePool
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.RollbackNodePoolUpgrade
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.SetNodePoolManagement
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.SetLabels
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.SetLegacyAbac
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.StartIPRotation
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.CompleteIPRotation
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.SetNodePoolSize
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.SetNetworkPolicy
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.SetMaintenancePolicy
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.ListUsableSubnetworks
-    deadline: 20.0
-  - selector: google.container.v1beta1.ClusterManager.ListLocations
-    deadline: 20.0
-
-authentication:
-  rules:
-  - selector: '*'
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/container/v1/BUILD.bazel b/third_party/googleapis/google/container/v1/BUILD.bazel
index 810fe713b..9d0e279d9 100644
--- a/third_party/googleapis/google/container/v1/BUILD.bazel
+++ b/third_party/googleapis/google/container/v1/BUILD.bazel
@@ -1,23 +1,34 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
     name = "container_proto",
-    srcs = ["cluster_service.proto"],
+    srcs = [
+        "cluster_service.proto",
+    ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
         "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:timestamp_proto",
     ],
 )
 
 proto_library_with_info(
     name = "container_proto_with_info",
-    deps = [":container_proto"],
+    deps = [
+        ":container_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -25,17 +36,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
     name = "container_java_proto",
     deps = [":container_proto"],
@@ -44,39 +51,40 @@ java_proto_library(
 java_grpc_library(
     name = "container_java_grpc",
     srcs = [":container_proto"],
-    deps = [":container_java_proto"] + _JAVA_GRPC_DEPS,
+    deps = [":container_java_proto"],
 )
 
 java_gapic_library(
     name = "container_java_gapic",
     src = ":container_proto_with_info",
     gapic_yaml = "container_gapic.yaml",
-    service_yaml = "//google/container:container_v1.yaml",
-    test_deps = [":container_java_grpc"],
-    deps = [":container_java_proto"] + _JAVA_GRPC_DEPS,
+    package = "google.container.v1",
+    service_yaml = "container_v1.yaml",
+    test_deps = [
+        ":container_java_grpc",
+    ],
+    deps = [
+        ":container_java_proto",
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
+java_gapic_test(
+    name = "container_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.container.v1.ClusterManagerClientTest",
+    ],
     runtime_deps = [":container_java_gapic_test"],
-) for test_name in [
-    "com.google.cloud.container.v1.ClusterManagerClientTest",
-]]
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-container-v1-java",
-    client_deps = [":container_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":container_java_gapic_test"],
-    grpc_deps = [":container_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":container_java_gapic",
+        ":container_java_grpc",
         ":container_java_proto",
         ":container_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -84,10 +92,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -95,16 +103,20 @@ go_proto_library(
     compilers = ["@io_bazel_rules_go//proto:go_grpc"],
     importpath = "google.golang.org/genproto/googleapis/container/v1",
     protos = [":container_proto"],
-    deps = ["//google/api:annotations_go_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
 )
 
 go_gapic_library(
     name = "container_go_gapic",
-    src = ":container_proto_with_info",
-    gapic_yaml = "container_gapic.yaml",
-    importpath = "cloud.google.com/go/container/apiv1",
-    service_yaml = "//google/container:container_v1.yaml",
-    deps = [":container_go_proto"],
+    srcs = [":container_proto_with_info"],
+    grpc_service_config = "container_grpc_service_config.json",
+    importpath = "cloud.google.com/go/container/apiv1;container",
+    service_yaml = "container_v1.yaml",
+    deps = [
+        ":container_go_proto",
+    ],
 )
 
 go_test(
@@ -114,13 +126,233 @@ go_test(
     importpath = "cloud.google.com/go/container/apiv1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-container-v1-go",
     deps = [
         ":container_go_gapic",
-        ":container_go_gapic_srcjar-smoke-test.srcjar",
         ":container_go_gapic_srcjar-test.srcjar",
         ":container_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "container_moved_proto",
+    srcs = [":container_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "container_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":container_moved_proto"],
+)
+
+py_grpc_library(
+    name = "container_py_grpc",
+    srcs = [":container_moved_proto"],
+    deps = [":container_py_proto"],
+)
+
+py_gapic_library(
+    name = "container_py_gapic",
+    src = ":container_proto_with_info",
+    gapic_yaml = "container_gapic.yaml",
+    package = "google.container.v1",
+    service_yaml = "container_v1.yaml",
+    deps = [
+        ":container_py_grpc",
+        ":container_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "container-v1-py",
+    deps = [
+        ":container_py_gapic",
+        ":container_py_grpc",
+        ":container_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "container_php_proto",
+    deps = [":container_proto"],
+)
+
+php_grpc_library(
+    name = "container_php_grpc",
+    srcs = [":container_proto"],
+    deps = [":container_php_proto"],
+)
+
+php_gapic_library(
+    name = "container_php_gapic",
+    src = ":container_proto_with_info",
+    gapic_yaml = "container_gapic.yaml",
+    package = "google.container.v1",
+    service_yaml = "container_v1.yaml",
+    deps = [
+        ":container_php_grpc",
+        ":container_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-container-v1-php",
+    deps = [
+        ":container_php_gapic",
+        ":container_php_grpc",
+        ":container_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "container_nodejs_gapic",
+    src = ":container_proto_with_info",
+    gapic_yaml = "container_gapic.yaml",
+    package = "google.container.v1",
+    service_yaml = "container_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "container-v1-nodejs",
+    deps = [
+        ":container_nodejs_gapic",
+        ":container_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "container_ruby_proto",
+    deps = [":container_proto"],
+)
+
+ruby_grpc_library(
+    name = "container_ruby_grpc",
+    srcs = [":container_proto"],
+    deps = [":container_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "container_ruby_gapic",
+    src = ":container_proto_with_info",
+    gapic_yaml = "container_gapic.yaml",
+    package = "google.container.v1",
+    service_yaml = "container_v1.yaml",
+    deps = [
+        ":container_ruby_grpc",
+        ":container_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-container-v1-ruby",
+    deps = [
+        ":container_ruby_gapic",
+        ":container_ruby_grpc",
+        ":container_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "container_csharp_proto",
+    deps = [":container_proto"],
+)
+
+csharp_grpc_library(
+    name = "container_csharp_grpc",
+    srcs = [":container_proto"],
+    deps = [":container_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "container_csharp_gapic",
+    src = ":container_proto_with_info",
+    gapic_yaml = "container_gapic.yaml",
+    package = "google.container.v1",
+    service_yaml = "container_v1.yaml",
+    deps = [
+        ":container_csharp_grpc",
+        ":container_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-container-v1-csharp",
+    deps = [
+        ":container_csharp_gapic",
+        ":container_csharp_grpc",
+        ":container_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/container/v1/cluster_service.proto b/third_party/googleapis/google/container/v1/cluster_service.proto
index db7744d04..3a798ca12 100644
--- a/third_party/googleapis/google/container/v1/cluster_service.proto
+++ b/third_party/googleapis/google/container/v1/cluster_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,18 +18,24 @@ syntax = "proto3";
 package google.container.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/protobuf/empty.proto";
+import "google/protobuf/timestamp.proto";
 
+option csharp_namespace = "Google.Cloud.Container.V1";
 option go_package = "google.golang.org/genproto/googleapis/container/v1;container";
 option java_multiple_files = true;
 option java_outer_classname = "ClusterServiceProto";
 option java_package = "com.google.container.v1";
-option csharp_namespace = "Google.Cloud.Container.V1";
 option php_namespace = "Google\\Cloud\\Container\\V1";
-
+option ruby_package = "Google::Cloud::Container::V1";
 
 // Google Kubernetes Engine Cluster Manager v1
 service ClusterManager {
+  option (google.api.default_host) = "container.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Lists all clusters owned by a project in either the specified zone or all
   // zones.
   rpc ListClusters(ListClustersRequest) returns (ListClustersResponse) {
@@ -39,6 +45,8 @@ service ClusterManager {
         get: "/v1/projects/{project_id}/zones/{zone}/clusters"
       }
     };
+    option (google.api.method_signature) = "project_id,zone";
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets the details of a specific cluster.
@@ -49,21 +57,23 @@ service ClusterManager {
         get: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id";
+    option (google.api.method_signature) = "name";
   }
 
   // Creates a cluster, consisting of the specified number and type of Google
   // Compute Engine instances.
   //
   // By default, the cluster is created in the project's
-  // [default network](/compute/docs/networks-and-firewalls#networks).
+  // [default network](https://cloud.google.com/compute/docs/networks-and-firewalls#networks).
   //
   // One firewall is added for the cluster. After cluster creation,
-  // the cluster creates routes for each node to allow the containers
+  // the Kubelet creates routes for each node to allow the containers
   // on that node to communicate with all other instances in the
   // cluster.
   //
   // Finally, an entry is added to the project's global metadata indicating
-  // which CIDR range is being used by the cluster.
+  // which CIDR range the cluster is using.
   rpc CreateCluster(CreateClusterRequest) returns (Operation) {
     option (google.api.http) = {
       post: "/v1/{parent=projects/*/locations/*}/clusters"
@@ -73,6 +83,8 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster";
+    option (google.api.method_signature) = "parent,cluster";
   }
 
   // Updates the settings of a specific cluster.
@@ -85,9 +97,11 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,update";
+    option (google.api.method_signature) = "name,update";
   }
 
-  // Updates the version and/or image type for a specific node pool.
+  // Updates the version and/or image type for the specified node pool.
   rpc UpdateNodePool(UpdateNodePoolRequest) returns (Operation) {
     option (google.api.http) = {
       put: "/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}"
@@ -99,7 +113,7 @@ service ClusterManager {
     };
   }
 
-  // Sets the autoscaling settings for a specific node pool.
+  // Sets the autoscaling settings for the specified node pool.
   rpc SetNodePoolAutoscaling(SetNodePoolAutoscalingRequest) returns (Operation) {
     option (google.api.http) = {
       post: "/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}:setAutoscaling"
@@ -121,6 +135,8 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,logging_service";
+    option (google.api.method_signature) = "name,logging_service";
   }
 
   // Sets the monitoring service for a specific cluster.
@@ -133,6 +149,8 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,monitoring_service";
+    option (google.api.method_signature) = "name,monitoring_service";
   }
 
   // Sets the addons for a specific cluster.
@@ -145,6 +163,8 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,addons_config";
+    option (google.api.method_signature) = "name,addons_config";
   }
 
   // Sets the locations for a specific cluster.
@@ -157,6 +177,8 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,locations";
+    option (google.api.method_signature) = "name,locations";
   }
 
   // Updates the master for a specific cluster.
@@ -169,11 +191,13 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,master_version";
+    option (google.api.method_signature) = "name,master_version";
   }
 
-  // Used to set master auth materials. Currently supports :-
-  // Changing the admin password for a specific cluster.
-  // This can be either via password generation or explicitly set the password.
+  // Sets master auth materials. Currently supports changing the admin password
+  // or a specific cluster, either via password generation or explicitly setting
+  // the password.
   rpc SetMasterAuth(SetMasterAuthRequest) returns (Operation) {
     option (google.api.http) = {
       post: "/v1/{name=projects/*/locations/*/clusters/*}:setMasterAuth"
@@ -191,9 +215,9 @@ service ClusterManager {
   // Firewalls and routes that were configured during cluster creation
   // are also deleted.
   //
-  // Other Google Compute Engine resources that might be in use by the cluster
-  // (e.g. load balancer resources) will not be deleted if they weren't present
-  // at the initial create time.
+  // Other Google Compute Engine resources that might be in use by the cluster,
+  // such as load balancer resources, are not deleted if they weren't present
+  // when the cluster was initially created.
   rpc DeleteCluster(DeleteClusterRequest) returns (Operation) {
     option (google.api.http) = {
       delete: "/v1/{name=projects/*/locations/*/clusters/*}"
@@ -201,6 +225,8 @@ service ClusterManager {
         delete: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id";
+    option (google.api.method_signature) = "name";
   }
 
   // Lists all operations in a project in a specific zone or all zones.
@@ -211,6 +237,7 @@ service ClusterManager {
         get: "/v1/projects/{project_id}/zones/{zone}/operations"
       }
     };
+    option (google.api.method_signature) = "project_id,zone";
   }
 
   // Gets the specified operation.
@@ -221,6 +248,7 @@ service ClusterManager {
         get: "/v1/projects/{project_id}/zones/{zone}/operations/{operation_id}"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,operation_id";
   }
 
   // Cancels the specified operation.
@@ -233,9 +261,11 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,operation_id";
+    option (google.api.method_signature) = "name";
   }
 
-  // Returns configuration info about the Kubernetes Engine service.
+  // Returns configuration info about the Google Kubernetes Engine service.
   rpc GetServerConfig(GetServerConfigRequest) returns (ServerConfig) {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/locations/*}/serverConfig"
@@ -243,6 +273,8 @@ service ClusterManager {
         get: "/v1/projects/{project_id}/zones/{zone}/serverconfig"
       }
     };
+    option (google.api.method_signature) = "project_id,zone";
+    option (google.api.method_signature) = "name";
   }
 
   // Lists the node pools for a cluster.
@@ -253,9 +285,11 @@ service ClusterManager {
         get: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id";
+    option (google.api.method_signature) = "parent";
   }
 
-  // Retrieves the node pool requested.
+  // Retrieves the requested node pool.
   rpc GetNodePool(GetNodePoolRequest) returns (NodePool) {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}"
@@ -263,6 +297,8 @@ service ClusterManager {
         get: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,node_pool_id";
+    option (google.api.method_signature) = "name";
   }
 
   // Creates a node pool for a cluster.
@@ -275,6 +311,8 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,node_pool";
+    option (google.api.method_signature) = "parent,node_pool";
   }
 
   // Deletes a node pool from a cluster.
@@ -285,10 +323,12 @@ service ClusterManager {
         delete: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,node_pool_id";
+    option (google.api.method_signature) = "name";
   }
 
-  // Roll back the previously Aborted or Failed NodePool upgrade.
-  // This will be an no-op if the last upgrade successfully completed.
+  // Rolls back a previously Aborted or Failed NodePool upgrade.
+  // This makes no changes if the last upgrade successfully completed.
   rpc RollbackNodePoolUpgrade(RollbackNodePoolUpgradeRequest) returns (Operation) {
     option (google.api.http) = {
       post: "/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}:rollback"
@@ -298,6 +338,8 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,node_pool_id";
+    option (google.api.method_signature) = "name";
   }
 
   // Sets the NodeManagement options for a node pool.
@@ -334,9 +376,11 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,enabled";
+    option (google.api.method_signature) = "name,enabled";
   }
 
-  // Start master IP rotation.
+  // Starts master IP rotation.
   rpc StartIPRotation(StartIPRotationRequest) returns (Operation) {
     option (google.api.http) = {
       post: "/v1/{name=projects/*/locations/*/clusters/*}:startIpRotation"
@@ -346,6 +390,8 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id";
+    option (google.api.method_signature) = "name";
   }
 
   // Completes master IP rotation.
@@ -358,6 +404,8 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id";
+    option (google.api.method_signature) = "name";
   }
 
   // Sets the size for a specific node pool.
@@ -372,7 +420,7 @@ service ClusterManager {
     };
   }
 
-  // Enables/Disables Network Policy for a cluster.
+  // Enables or disables Network Policy for a cluster.
   rpc SetNetworkPolicy(SetNetworkPolicyRequest) returns (Operation) {
     option (google.api.http) = {
       post: "/v1/{name=projects/*/locations/*/clusters/*}:setNetworkPolicy"
@@ -382,6 +430,8 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,network_policy";
+    option (google.api.method_signature) = "name,network_policy";
   }
 
   // Sets the maintenance policy for a cluster.
@@ -394,13 +444,22 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,maintenance_policy";
+    option (google.api.method_signature) = "name,maintenance_policy";
+  }
+
+  // Lists subnetworks that are usable for creating clusters in a project.
+  rpc ListUsableSubnetworks(ListUsableSubnetworksRequest) returns (ListUsableSubnetworksResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*}/aggregated/usableSubnetworks"
+    };
   }
 }
 
 // Parameters that describe the nodes in a cluster.
 message NodeConfig {
   // The name of a Google Compute Engine [machine
-  // type](/compute/docs/machine-types) (e.g.
+  // type](https://cloud.google.com/compute/docs/machine-types) (e.g.
   // `n1-standard-1`).
   //
   // If unspecified, the default machine type is
@@ -423,7 +482,7 @@ message NodeConfig {
   // persistent storage on your nodes.
   // * `https://www.googleapis.com/auth/devstorage.read_only` is required for
   // communicating with **gcr.io**
-  // (the [Google Container Registry](/container-registry/)).
+  // (the [Google Container Registry](https://cloud.google.com/container-registry/)).
   //
   // If unspecified, no scopes are added, unless Cloud Logging or Cloud
   // Monitoring are enabled, in which case their required scopes will be added.
@@ -443,6 +502,7 @@ message NodeConfig {
   //  "cluster-name"
   //  "cluster-uid"
   //  "configure-sh"
+  //  "containerd-configure-sh"
   //  "enable-os-login"
   //  "gci-update-strategy"
   //  "gci-ensure-gke-docker"
@@ -450,6 +510,13 @@ message NodeConfig {
   //  "kube-env"
   //  "startup-script"
   //  "user-data"
+  //  "disable-address-manager"
+  //  "windows-startup-script-ps1"
+  //  "common-psm1"
+  //  "k8s-node-setup-psm1"
+  //  "install-ssh-psm1"
+  //  "user-profile-psm1"
+  //  "serial-port-logging-enable"
   //
   // Values are free-form strings, and only have meaning as interpreted by
   // the image running in the instance. The only restriction placed on them is
@@ -474,9 +541,9 @@ message NodeConfig {
 
   // The number of local SSD disks to be attached to the node.
   //
-  // The limit for this value is dependant upon the maximum number of
+  // The limit for this value is dependent upon the maximum number of
   // disks available on a machine per zone. See:
-  // https://cloud.google.com/compute/docs/disks/local-ssd#local_ssd_limits
+  // https://cloud.google.com/compute/docs/disks/local-ssd
   // for more information.
   int32 local_ssd_count = 7;
 
@@ -509,6 +576,64 @@ message NodeConfig {
   // information, read [how to specify min CPU
   // platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
   string min_cpu_platform = 13;
+
+  // List of kubernetes taints to be applied to each node.
+  //
+  // For more information, including usage and the valid values, see:
+  // https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/
+  repeated NodeTaint taints = 15;
+
+  // Shielded Instance options.
+  ShieldedInstanceConfig shielded_instance_config = 20;
+}
+
+// A set of Shielded Instance options.
+message ShieldedInstanceConfig {
+  // Defines whether the instance has Secure Boot enabled.
+  //
+  // Secure Boot helps ensure that the system only runs authentic software by
+  // verifying the digital signature of all boot components, and halting the
+  // boot process if signature verification fails.
+  bool enable_secure_boot = 1;
+
+  // Defines whether the instance has integrity monitoring enabled.
+  //
+  // Enables monitoring and attestation of the boot integrity of the instance.
+  // The attestation is performed against the integrity policy baseline. This
+  // baseline is initially derived from the implicitly trusted boot image when
+  // the instance is created.
+  bool enable_integrity_monitoring = 2;
+}
+
+// Kubernetes taint is comprised of three fields: key, value, and effect. Effect
+// can only be one of three types:  NoSchedule, PreferNoSchedule or NoExecute.
+//
+// For more information, including usage and the valid values, see:
+// https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/
+message NodeTaint {
+  // Possible values for Effect in taint.
+  enum Effect {
+    // Not set
+    EFFECT_UNSPECIFIED = 0;
+
+    // NoSchedule
+    NO_SCHEDULE = 1;
+
+    // PreferNoSchedule
+    PREFER_NO_SCHEDULE = 2;
+
+    // NoExecute
+    NO_EXECUTE = 3;
+  }
+
+  // Key for taint.
+  string key = 1;
+
+  // Value for taint.
+  string value = 2;
+
+  // Effect for taint.
+  Effect effect = 3;
 }
 
 // The authentication information for accessing the master endpoint.
@@ -516,8 +641,8 @@ message NodeConfig {
 // certificates.
 message MasterAuth {
   // The username to use for HTTP basic authentication to the master endpoint.
-  // For clusters v1.6.0 and later, you can disable basic authentication by
-  // providing an empty username.
+  // For clusters v1.6.0 and later, basic authentication can be disabled by
+  // leaving username unspecified (or setting it to the empty string).
   string username = 1;
 
   // The password to use for HTTP basic authentication to the master endpoint.
@@ -563,12 +688,20 @@ message AddonsConfig {
   HorizontalPodAutoscaling horizontal_pod_autoscaling = 2;
 
   // Configuration for the Kubernetes Dashboard.
-  KubernetesDashboard kubernetes_dashboard = 3;
+  // This addon is deprecated, and will be disabled in 1.15. It is recommended
+  // to use the Cloud Console to manage and monitor your Kubernetes clusters,
+  // workloads and applications. For more information, see:
+  // https://cloud.google.com/kubernetes-engine/docs/concepts/dashboards
+  KubernetesDashboard kubernetes_dashboard = 3 [deprecated = true];
 
   // Configuration for NetworkPolicy. This only tracks whether the addon
   // is enabled or not on the Master, it does not track whether network policy
   // is enabled for the nodes.
   NetworkPolicyConfig network_policy_config = 4;
+
+  // Configuration for the Cloud Run addon, which allows the user to use a
+  // managed Knative service.
+  CloudRunConfig cloud_run_config = 7;
 }
 
 // Configuration options for the HTTP (L7) load balancing controller addon,
@@ -627,6 +760,23 @@ message PrivateClusterConfig {
   string public_endpoint = 5;
 }
 
+// Configuration for returning group information from authenticators.
+message AuthenticatorGroupsConfig {
+  // Whether this cluster should return group membership lookups
+  // during authentication using a group of security groups.
+  bool enabled = 1;
+
+  // The name of the security group-of-groups to be used. Only relevant
+  // if enabled = true.
+  string security_group = 2;
+}
+
+// Configuration options for the Cloud Run feature.
+message CloudRunConfig {
+  // Whether Cloud Run addon is enabled for this cluster.
+  bool disabled = 1;
+}
+
 // Configuration options for the master authorized networks feature. Enabled
 // master authorized networks will disallow all external traffic to access
 // Kubernetes master through HTTPS except traffic from the given CIDR blocks,
@@ -644,7 +794,7 @@ message MasterAuthorizedNetworksConfig {
   // Whether or not master authorized networks is enabled.
   bool enabled = 1;
 
-  // cidr_blocks define up to 10 external networks that could access
+  // cidr_blocks define up to 50 external networks that could access
   // Kubernetes master through HTTPS.
   repeated CidrBlock cidr_blocks = 2;
 }
@@ -678,6 +828,13 @@ message NetworkPolicy {
   bool enabled = 2;
 }
 
+// Configuration for Binary Authorization.
+message BinaryAuthorization {
+  // Enable Binary Authorization for this cluster. If enabled, all container
+  // images will be validated by Binary Authorization.
+  bool enabled = 1;
+}
+
 // Configuration for controlling how IPs are allocated in the cluster.
 message IPAllocationPolicy {
   // Whether alias IPs will be used for pod IPs in the cluster.
@@ -769,6 +926,23 @@ message IPAllocationPolicy {
   // `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
   // to use.
   string services_ipv4_cidr_block = 11;
+
+  // The IP address range of the Cloud TPUs in this cluster. If unspecified, a
+  // range will be automatically chosen with the default size.
+  //
+  // This field is only applicable when `use_ip_aliases` is true.
+  //
+  // If unspecified, the range will use the default size.
+  //
+  // Set to /netmask (e.g. `/14`) to have a range chosen with a specific
+  // netmask.
+  //
+  // Set to a
+  // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+  // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
+  // `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
+  // to use.
+  string tpu_ipv4_cidr_block = 13;
 }
 
 // A Google Kubernetes Engine cluster.
@@ -803,7 +977,8 @@ message Cluster {
   }
 
   // The name of this cluster. The name must be unique within this project
-  // and zone, and can be up to 40 characters with the following restrictions:
+  // and location (e.g. zone or region), and can be up to 40 characters with
+  // the following restrictions:
   //
   // * Lowercase letters, numbers, and hyphens only.
   // * Must start with a letter.
@@ -821,26 +996,35 @@ message Cluster {
   // "node_pool" object, since this configuration (along with the
   // "node_config") will be used to create a "NodePool" object with an
   // auto-generated name. Do not use this and a node_pool at the same time.
-  int32 initial_node_count = 3;
+  //
+  // This field is deprecated, use node_pool.initial_node_count instead.
+  int32 initial_node_count = 3 [deprecated = true];
 
   // Parameters used in creating the cluster's nodes.
-  // See `nodeConfig` for the description of its properties.
   // For requests, this field should only be used in lieu of a
   // "node_pool" object, since this configuration (along with the
   // "initial_node_count") will be used to create a "NodePool" object with an
   // auto-generated name. Do not use this and a node_pool at the same time.
   // For responses, this field will be populated with the node configuration of
-  // the first node pool.
+  // the first node pool. (For configuration of each node pool, see
+  // `node_pool.config`)
   //
   // If unspecified, the defaults are used.
-  NodeConfig node_config = 4;
+  // This field is deprecated, use node_pool.config instead.
+  NodeConfig node_config = 4 [deprecated = true];
 
   // The authentication information for accessing the master endpoint.
+  // If unspecified, the defaults are used:
+  // For clusters before v1.12, if master_auth is unspecified, `username` will
+  // be set to "admin", a random password will be generated, and a client
+  // certificate will be issued.
   MasterAuth master_auth = 5;
 
   // The logging service the cluster should use to write logs.
   // Currently available options:
   //
+  // * "logging.googleapis.com/kubernetes" - the Google Cloud Logging
+  // service with Kubernetes-native resource model
   // * `logging.googleapis.com` - the Google Cloud Logging service.
   // * `none` - no logs will be exported from the cluster.
   // * if left as an empty string,`logging.googleapis.com` will be used.
@@ -855,7 +1039,7 @@ message Cluster {
   string monitoring_service = 7;
 
   // The name of the Google Compute Engine
-  // [network](/compute/docs/networks-and-firewalls#networks) to which the
+  // [network](https://cloud.google.com/compute/docs/networks-and-firewalls#networks) to which the
   // cluster is connected. If left unspecified, the `default` network
   // will be used.
   string network = 8;
@@ -870,7 +1054,7 @@ message Cluster {
   AddonsConfig addons_config = 10;
 
   // The name of the Google Compute Engine
-  // [subnetwork](/compute/docs/subnetworks) to which the
+  // [subnetwork](https://cloud.google.com/compute/docs/subnetworks) to which the
   // cluster is connected.
   string subnetwork = 11;
 
@@ -880,7 +1064,7 @@ message Cluster {
   repeated NodePool node_pools = 12;
 
   // The list of Google Compute Engine
-  // [locations](/compute/docs/zones#available) in which the cluster's nodes
+  // [zones](https://cloud.google.com/compute/docs/zones#available) in which the cluster's nodes
   // should be located.
   repeated string locations = 13;
 
@@ -914,17 +1098,41 @@ message Cluster {
   // Configure the maintenance policy for this cluster.
   MaintenancePolicy maintenance_policy = 23;
 
+  // Configuration for Binary Authorization.
+  BinaryAuthorization binary_authorization = 24;
+
+  // Cluster-level autoscaling configuration.
+  ClusterAutoscaling autoscaling = 26;
+
   // Configuration for cluster networking.
   NetworkConfig network_config = 27;
 
+  // The default constraint on the maximum number of pods that can be run
+  // simultaneously on a node in the node pool of this cluster. Only honored
+  // if cluster created with IP Alias support.
+  MaxPodsConstraint default_max_pods_constraint = 30;
+
+  // Configuration for exporting resource usages. Resource usage export is
+  // disabled when this config is unspecified.
+  ResourceUsageExportConfig resource_usage_export_config = 33;
+
+  // Configuration controlling RBAC group membership information.
+  AuthenticatorGroupsConfig authenticator_groups_config = 34;
+
   // Configuration for private cluster.
   PrivateClusterConfig private_cluster_config = 37;
 
+  // Configuration of etcd encryption.
+  DatabaseEncryption database_encryption = 38;
+
+  // Cluster-level Vertical Pod Autoscaling configuration.
+  VerticalPodAutoscaling vertical_pod_autoscaling = 39;
+
   // [Output only] Server-defined URL for the resource.
   string self_link = 100;
 
   // [Output only] The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field is deprecated, use location instead.
   string zone = 101 [deprecated = true];
@@ -956,7 +1164,7 @@ message Cluster {
   string current_master_version = 104;
 
   // [Output only] Deprecated, use
-  // [NodePool.version](/kubernetes-engine/docs/reference/rest/v1/projects.zones.clusters.nodePool)
+  // [NodePools.version](https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1/projects.zones.clusters.nodePools)
   // instead. The current version of the node software components. If they are
   // currently at multiple versions because they're in the process of being
   // upgraded, this reflects the minimum version of all nodes.
@@ -975,7 +1183,8 @@ message Cluster {
 
   // [Output only] The size of the address space on each node for hosting
   // containers. This is provisioned from within the `container_ipv4_cidr`
-  // range.
+  // range. This field will only be set when cluster is in route-based network
+  // mode.
   int32 node_ipv4_cidr_size = 109;
 
   // [Output only] The IP address range of the Kubernetes services in
@@ -988,18 +1197,30 @@ message Cluster {
   // Deprecated. Use node_pools.instance_group_urls.
   repeated string instance_group_urls = 111 [deprecated = true];
 
-  // [Output only] The number of nodes currently in the cluster.
-  int32 current_node_count = 112;
+  // [Output only]  The number of nodes currently in the cluster. Deprecated.
+  // Call Kubernetes API directly to retrieve node information.
+  int32 current_node_count = 112 [deprecated = true];
 
   // [Output only] The time the cluster will be automatically
   // deleted in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
   string expire_time = 113;
 
   // [Output only] The name of the Google Compute Engine
-  // [zone](/compute/docs/regions-zones/regions-zones#available) or
-  // [region](/compute/docs/regions-zones/regions-zones#available) in which
+  // [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available) or
+  // [region](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available) in which
   // the cluster resides.
   string location = 114;
+
+  // Enable the ability to use Cloud TPUs in this cluster.
+  bool enable_tpu = 115;
+
+  // [Output only] The IP address range of the Cloud TPUs in this cluster, in
+  // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+  // notation (e.g. `1.2.3.4/29`).
+  string tpu_ipv4_cidr_block = 116;
+
+  // Which conditions caused the current cluster state.
+  repeated StatusCondition conditions = 118;
 }
 
 // ClusterUpdate describes an update to the cluster. Exactly one update can
@@ -1022,6 +1243,8 @@ message ClusterUpdate {
   // The monitoring service the cluster should use to write metrics.
   // Currently available options:
   //
+  // * "monitoring.googleapis.com/kubernetes" - the Google Cloud Monitoring
+  // service with Kubernetes-native resource model
   // * "monitoring.googleapis.com" - the Google Cloud Monitoring service
   // * "none" - no metrics will be exported from the cluster
   string desired_monitoring_service = 5;
@@ -1039,6 +1262,9 @@ message ClusterUpdate {
   // NOTE: Set the "desired_node_pool" field as well.
   string desired_image_type = 8;
 
+  // Configuration of etcd encryption.
+  DatabaseEncryption desired_database_encryption = 46;
+
   // Autoscaler configuration for the node pool specified in
   // desired_node_pool_id. If there is only one pool in the
   // cluster and desired_node_pool_id is not provided then
@@ -1046,7 +1272,7 @@ message ClusterUpdate {
   NodePoolAutoscaling desired_node_pool_autoscaling = 9;
 
   // The desired list of Google Compute Engine
-  // [locations](/compute/docs/zones#available) in which the cluster's nodes
+  // [zones](https://cloud.google.com/compute/docs/zones#available) in which the cluster's nodes
   // should be located. Changing the locations a cluster is in will result
   // in nodes being either created or removed from the cluster, depending on
   // whether locations are being added or removed.
@@ -1057,6 +1283,30 @@ message ClusterUpdate {
   // The desired configuration options for master authorized networks feature.
   MasterAuthorizedNetworksConfig desired_master_authorized_networks_config = 12;
 
+  // Cluster-level autoscaling configuration.
+  ClusterAutoscaling desired_cluster_autoscaling = 15;
+
+  // The desired configuration options for the Binary Authorization feature.
+  BinaryAuthorization desired_binary_authorization = 16;
+
+  // The logging service the cluster should use to write logs.
+  // Currently available options:
+  //
+  // * "logging.googleapis.com/kubernetes" - the Google Cloud Logging
+  // service with Kubernetes-native resource model
+  // * "logging.googleapis.com" - the Google Cloud Logging service
+  // * "none" - no logs will be exported from the cluster
+  string desired_logging_service = 19;
+
+  // The desired configuration for exporting resource usage.
+  ResourceUsageExportConfig desired_resource_usage_export_config = 21;
+
+  // Cluster-level Vertical Pod Autoscaling configuration.
+  VerticalPodAutoscaling desired_vertical_pod_autoscaling = 22;
+
+  // The desired config of Intra-node visibility.
+  IntraNodeVisibilityConfig desired_intra_node_visibility_config = 26;
+
   // The Kubernetes version to change the master to.
   //
   // Users may specify either explicit versions offered by
@@ -1149,7 +1399,7 @@ message Operation {
   string name = 1;
 
   // The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the operation
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the operation
   // is taking place.
   // This field is deprecated, use location instead.
   string zone = 2 [deprecated = true];
@@ -1173,8 +1423,8 @@ message Operation {
   string target_link = 7;
 
   // [Output only] The name of the Google Compute Engine
-  // [zone](/compute/docs/regions-zones/regions-zones#available) or
-  // [region](/compute/docs/regions-zones/regions-zones#available) in which
+  // [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available) or
+  // [region](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available) in which
   // the cluster resides.
   string location = 9;
 
@@ -1185,6 +1435,12 @@ message Operation {
   // [Output only] The time the operation completed, in
   // [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
   string end_time = 11;
+
+  // Which conditions caused the current cluster state.
+  repeated StatusCondition cluster_conditions = 13;
+
+  // Which conditions caused the current node pool state.
+  repeated StatusCondition nodepool_conditions = 14;
 }
 
 // CreateClusterRequest creates a cluster.
@@ -1195,17 +1451,17 @@ message CreateClusterRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the parent field.
   string zone = 2 [deprecated = true];
 
-  // A [cluster
-  // resource](/container-engine/reference/rest/v1/projects.zones.clusters)
-  Cluster cluster = 3;
+  // Required. A [cluster
+  // resource](https://cloud.google.com/container-engine/reference/rest/v1/projects.zones.clusters)
+  Cluster cluster = 3 [(google.api.field_behavior) = REQUIRED];
 
   // The parent (project and location) where the cluster will be created.
-  // Specified in the format 'projects/*/locations/*'.
+  // Specified in the format `projects/*/locations/*`.
   string parent = 5;
 }
 
@@ -1217,7 +1473,7 @@ message GetClusterRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
   string zone = 2 [deprecated = true];
@@ -1227,7 +1483,7 @@ message GetClusterRequest {
   string cluster_id = 3 [deprecated = true];
 
   // The name (project, location, cluster) of the cluster to retrieve.
-  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 5;
 }
 
@@ -1239,7 +1495,7 @@ message UpdateClusterRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
   string zone = 2 [deprecated = true];
@@ -1248,11 +1504,11 @@ message UpdateClusterRequest {
   // This field has been deprecated and replaced by the name field.
   string cluster_id = 3 [deprecated = true];
 
-  // A description of the update.
-  ClusterUpdate update = 4;
+  // Required. A description of the update.
+  ClusterUpdate update = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster) of the cluster to update.
-  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 5;
 }
 
@@ -1264,7 +1520,7 @@ message UpdateNodePoolRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
   string zone = 2 [deprecated = true];
@@ -1277,7 +1533,7 @@ message UpdateNodePoolRequest {
   // This field has been deprecated and replaced by the name field.
   string node_pool_id = 4 [deprecated = true];
 
-  // The Kubernetes version to change the nodes to (typically an
+  // Required. The Kubernetes version to change the nodes to (typically an
   // upgrade).
   //
   // Users may specify either explicit versions offered by Kubernetes Engine or
@@ -1288,14 +1544,14 @@ message UpdateNodePoolRequest {
   // - "1.X.Y": picks the highest valid gke.N patch in the 1.X.Y version
   // - "1.X.Y-gke.N": picks an explicit Kubernetes version
   // - "-": picks the Kubernetes master version
-  string node_version = 5;
+  string node_version = 5 [(google.api.field_behavior) = REQUIRED];
 
-  // The desired image type for the node pool.
-  string image_type = 6;
+  // Required. The desired image type for the node pool.
+  string image_type = 6 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster, node pool) of the node pool to
   // update. Specified in the format
-  // 'projects/*/locations/*/clusters/*/nodePools/*'.
+  // `projects/*/locations/*/clusters/*/nodePools/*`.
   string name = 8;
 }
 
@@ -1307,7 +1563,7 @@ message SetNodePoolAutoscalingRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
   string zone = 2 [deprecated = true];
@@ -1320,12 +1576,12 @@ message SetNodePoolAutoscalingRequest {
   // This field has been deprecated and replaced by the name field.
   string node_pool_id = 4 [deprecated = true];
 
-  // Autoscaling configuration for the node pool.
-  NodePoolAutoscaling autoscaling = 5;
+  // Required. Autoscaling configuration for the node pool.
+  NodePoolAutoscaling autoscaling = 5 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster, node pool) of the node pool to set
   // autoscaler settings. Specified in the format
-  // 'projects/*/locations/*/clusters/*/nodePools/*'.
+  // `projects/*/locations/*/clusters/*/nodePools/*`.
   string name = 6;
 }
 
@@ -1337,24 +1593,24 @@ message SetLoggingServiceRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
-  string zone = 2;
+  string zone = 2 [deprecated = true];
 
   // Deprecated. The name of the cluster to upgrade.
   // This field has been deprecated and replaced by the name field.
   string cluster_id = 3 [deprecated = true];
 
-  // The logging service the cluster should use to write metrics.
+  // Required. The logging service the cluster should use to write metrics.
   // Currently available options:
   //
   // * "logging.googleapis.com" - the Google Cloud Logging service
   // * "none" - no metrics will be exported from the cluster
-  string logging_service = 4;
+  string logging_service = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster) of the cluster to set logging.
-  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 5;
 }
 
@@ -1366,7 +1622,7 @@ message SetMonitoringServiceRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
   string zone = 2 [deprecated = true];
@@ -1375,15 +1631,17 @@ message SetMonitoringServiceRequest {
   // This field has been deprecated and replaced by the name field.
   string cluster_id = 3 [deprecated = true];
 
-  // The monitoring service the cluster should use to write metrics.
+  // Required. The monitoring service the cluster should use to write metrics.
   // Currently available options:
   //
+  // * "monitoring.googleapis.com/kubernetes" - the Google Cloud Monitoring
+  // service with Kubernetes-native resource model
   // * "monitoring.googleapis.com" - the Google Cloud Monitoring service
   // * "none" - no metrics will be exported from the cluster
-  string monitoring_service = 4;
+  string monitoring_service = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster) of the cluster to set monitoring.
-  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 6;
 }
 
@@ -1395,7 +1653,7 @@ message SetAddonsConfigRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
   string zone = 2 [deprecated = true];
@@ -1404,12 +1662,12 @@ message SetAddonsConfigRequest {
   // This field has been deprecated and replaced by the name field.
   string cluster_id = 3 [deprecated = true];
 
-  // The desired configurations for the various addons available to run in the
+  // Required. The desired configurations for the various addons available to run in the
   // cluster.
-  AddonsConfig addons_config = 4;
+  AddonsConfig addons_config = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster) of the cluster to set addons.
-  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 6;
 }
 
@@ -1421,7 +1679,7 @@ message SetLocationsRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
   string zone = 2 [deprecated = true];
@@ -1430,17 +1688,17 @@ message SetLocationsRequest {
   // This field has been deprecated and replaced by the name field.
   string cluster_id = 3 [deprecated = true];
 
-  // The desired list of Google Compute Engine
-  // [locations](/compute/docs/zones#available) in which the cluster's nodes
+  // Required. The desired list of Google Compute Engine
+  // [zones](https://cloud.google.com/compute/docs/zones#available) in which the cluster's nodes
   // should be located. Changing the locations a cluster is in will result
   // in nodes being either created or removed from the cluster, depending on
   // whether locations are being added or removed.
   //
   // This list must always include the cluster's primary zone.
-  repeated string locations = 4;
+  repeated string locations = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster) of the cluster to set locations.
-  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 6;
 }
 
@@ -1452,7 +1710,7 @@ message UpdateMasterRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
   string zone = 2 [deprecated = true];
@@ -1461,7 +1719,7 @@ message UpdateMasterRequest {
   // This field has been deprecated and replaced by the name field.
   string cluster_id = 3 [deprecated = true];
 
-  // The Kubernetes version to change the master to.
+  // Required. The Kubernetes version to change the master to.
   //
   // Users may specify either explicit versions offered by Kubernetes Engine or
   // version aliases, which have the following behavior:
@@ -1471,10 +1729,10 @@ message UpdateMasterRequest {
   // - "1.X.Y": picks the highest valid gke.N patch in the 1.X.Y version
   // - "1.X.Y-gke.N": picks an explicit Kubernetes version
   // - "-": picks the default Kubernetes version
-  string master_version = 4;
+  string master_version = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster) of the cluster to update.
-  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 7;
 }
 
@@ -1504,7 +1762,7 @@ message SetMasterAuthRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
   string zone = 2 [deprecated = true];
@@ -1513,14 +1771,14 @@ message SetMasterAuthRequest {
   // This field has been deprecated and replaced by the name field.
   string cluster_id = 3 [deprecated = true];
 
-  // The exact form of action to be taken on the master auth.
-  Action action = 4;
+  // Required. The exact form of action to be taken on the master auth.
+  Action action = 4 [(google.api.field_behavior) = REQUIRED];
 
-  // A description of the update.
-  MasterAuth update = 5;
+  // Required. A description of the update.
+  MasterAuth update = 5 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster) of the cluster to set auth.
-  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 7;
 }
 
@@ -1532,7 +1790,7 @@ message DeleteClusterRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
   string zone = 2 [deprecated = true];
@@ -1542,7 +1800,7 @@ message DeleteClusterRequest {
   string cluster_id = 3 [deprecated = true];
 
   // The name (project, location, cluster) of the cluster to delete.
-  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 4;
 }
 
@@ -1554,13 +1812,13 @@ message ListClustersRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides, or "-" for all zones.
   // This field has been deprecated and replaced by the parent field.
   string zone = 2 [deprecated = true];
 
   // The parent (project and location) where the clusters will be listed.
-  // Specified in the format 'projects/*/locations/*'.
+  // Specified in the format `projects/*/locations/*`.
   // Location "-" matches all zones and all regions.
   string parent = 4;
 }
@@ -1584,7 +1842,7 @@ message GetOperationRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
   string zone = 2 [deprecated = true];
@@ -1594,7 +1852,7 @@ message GetOperationRequest {
   string operation_id = 3 [deprecated = true];
 
   // The name (project, location, operation id) of the operation to get.
-  // Specified in the format 'projects/*/locations/*/operations/*'.
+  // Specified in the format `projects/*/locations/*/operations/*`.
   string name = 5;
 }
 
@@ -1606,12 +1864,12 @@ message ListOperationsRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) to return operations for, or `-` for
+  // [zone](https://cloud.google.com/compute/docs/zones#available) to return operations for, or `-` for
   // all zones. This field has been deprecated and replaced by the parent field.
   string zone = 2 [deprecated = true];
 
   // The parent (project and location) where the operations will be listed.
-  // Specified in the format 'projects/*/locations/*'.
+  // Specified in the format `projects/*/locations/*`.
   // Location "-" matches all zones and all regions.
   string parent = 4;
 }
@@ -1624,7 +1882,7 @@ message CancelOperationRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the operation resides.
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the operation resides.
   // This field has been deprecated and replaced by the name field.
   string zone = 2 [deprecated = true];
 
@@ -1633,7 +1891,7 @@ message CancelOperationRequest {
   string operation_id = 3 [deprecated = true];
 
   // The name (project, location, operation id) of the operation to cancel.
-  // Specified in the format 'projects/*/locations/*/operations/*'.
+  // Specified in the format `projects/*/locations/*/operations/*`.
   string name = 4;
 }
 
@@ -1655,12 +1913,12 @@ message GetServerConfigRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) to return operations for.
+  // [zone](https://cloud.google.com/compute/docs/zones#available) to return operations for.
   // This field has been deprecated and replaced by the name field.
   string zone = 2 [deprecated = true];
 
-  // The name (project and location) of the server config to get
-  // Specified in the format 'projects/*/locations/*'.
+  // The name (project and location) of the server config to get,
+  // specified in the format `projects/*/locations/*`.
   string name = 4;
 }
 
@@ -1690,7 +1948,7 @@ message CreateNodePoolRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the parent field.
   string zone = 2 [deprecated = true];
@@ -1699,12 +1957,12 @@ message CreateNodePoolRequest {
   // This field has been deprecated and replaced by the parent field.
   string cluster_id = 3 [deprecated = true];
 
-  // The node pool to create.
-  NodePool node_pool = 4;
+  // Required. The node pool to create.
+  NodePool node_pool = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The parent (project, location, cluster id) where the node pool will be
   // created. Specified in the format
-  // 'projects/*/locations/*/clusters/*'.
+  // `projects/*/locations/*/clusters/*`.
   string parent = 6;
 }
 
@@ -1716,7 +1974,7 @@ message DeleteNodePoolRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
   string zone = 2 [deprecated = true];
@@ -1731,7 +1989,7 @@ message DeleteNodePoolRequest {
 
   // The name (project, location, cluster, node pool id) of the node pool to
   // delete. Specified in the format
-  // 'projects/*/locations/*/clusters/*/nodePools/*'.
+  // `projects/*/locations/*/clusters/*/nodePools/*`.
   string name = 6;
 }
 
@@ -1743,7 +2001,7 @@ message ListNodePoolsRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the parent field.
   string zone = 2 [deprecated = true];
@@ -1753,7 +2011,7 @@ message ListNodePoolsRequest {
   string cluster_id = 3 [deprecated = true];
 
   // The parent (project, location, cluster id) where the node pools will be
-  // listed. Specified in the format 'projects/*/locations/*/clusters/*'.
+  // listed. Specified in the format `projects/*/locations/*/clusters/*`.
   string parent = 5;
 }
 
@@ -1765,7 +2023,7 @@ message GetNodePoolRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
   string zone = 2 [deprecated = true];
@@ -1780,7 +2038,7 @@ message GetNodePoolRequest {
 
   // The name (project, location, cluster, node pool id) of the node pool to
   // get. Specified in the format
-  // 'projects/*/locations/*/clusters/*/nodePools/*'.
+  // `projects/*/locations/*/clusters/*/nodePools/*`.
   string name = 6;
 }
 
@@ -1841,7 +2099,7 @@ message NodePool {
   string version = 101;
 
   // [Output only] The resource URLs of the [managed instance
-  // groups](/compute/docs/instance-groups/creating-groups-of-managed-instances)
+  // groups](https://cloud.google.com/compute/docs/instance-groups/creating-groups-of-managed-instances)
   // associated with this node pool.
   repeated string instance_group_urls = 102;
 
@@ -1858,6 +2116,16 @@ message NodePool {
 
   // NodeManagement configuration for this NodePool.
   NodeManagement management = 5;
+
+  // The constraint on the maximum number of pods that can be run
+  // simultaneously on a node in the node pool.
+  MaxPodsConstraint max_pods_constraint = 6;
+
+  // Which conditions caused the current node pool state.
+  repeated StatusCondition conditions = 105;
+
+  // [Output only] The pod CIDR block size per node in this node pool.
+  int32 pod_ipv4_cidr_size = 7;
 }
 
 // NodeManagement defines the set of node management services turned on for the
@@ -1895,6 +2163,13 @@ message AutoUpgradeOptions {
 message MaintenancePolicy {
   // Specifies the maintenance window in which maintenance may be performed.
   MaintenanceWindow window = 1;
+
+  // A hash identifying the version of this policy, so that updates to fields of
+  // the policy won't accidentally undo intermediate changes (and so that users
+  // of the API unaware of some fields won't accidentally remove other fields).
+  // Make a get() request to the cluster to get the current
+  // resource version and include it with requests to set the policy.
+  string resource_version = 3;
 }
 
 // MaintenanceWindow defines the maintenance window to be used for the cluster.
@@ -1902,14 +2177,68 @@ message MaintenanceWindow {
   oneof policy {
     // DailyMaintenanceWindow specifies a daily maintenance operation window.
     DailyMaintenanceWindow daily_maintenance_window = 2;
+
+    // RecurringWindow specifies some number of recurring time periods for
+    // maintenance to occur. The time windows may be overlapping. If no
+    // maintenance windows are set, maintenance can occur at any time.
+    RecurringTimeWindow recurring_window = 3;
   }
+
+  // Exceptions to maintenance window. Non-emergency maintenance should not
+  // occur in these windows.
+  map maintenance_exclusions = 4;
+}
+
+// Represents an arbitrary window of time.
+message TimeWindow {
+  // The time that the window first starts.
+  google.protobuf.Timestamp start_time = 1;
+
+  // The time that the window ends. The end time should take place after the
+  // start time.
+  google.protobuf.Timestamp end_time = 2;
+}
+
+// Represents an arbitrary window of time that recurs.
+message RecurringTimeWindow {
+  // The window of the first recurrence.
+  TimeWindow window = 1;
+
+  // An RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) for how
+  // this window reccurs. They go on for the span of time between the start and
+  // end time.
+  //
+  // For example, to have something repeat every weekday, you'd use:
+  //   FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR
+  // To repeat some window daily (equivalent to the DailyMaintenanceWindow):
+  //   FREQ=DAILY
+  // For the first weekend of every month:
+  //   FREQ=MONTHLY;BYSETPOS=1;BYDAY=SA,SU
+  // This specifies how frequently the window starts. Eg, if you wanted to have
+  // a 9-5 UTC-4 window every weekday, you'd use something like:
+  // 
+  //   start time = 2019-01-01T09:00:00-0400
+  //   end time = 2019-01-01T17:00:00-0400
+  //   recurrence = FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR
+  // 
+  // Windows can span multiple days. Eg, to make the window encompass every
+  // weekend from midnight Saturday till the last minute of Sunday UTC:
+  // 
+  //   start time = 2019-01-05T00:00:00Z
+  //   end time = 2019-01-07T23:59:00Z
+  //   recurrence = FREQ=WEEKLY;BYDAY=SA
+  // 
+  // Note the start and end time's specific dates are largely arbitrary except
+  // to specify duration of the window and when it first starts.
+  // The FREQ values of HOURLY, MINUTELY, and SECONDLY are not supported.
+  string recurrence = 2;
 }
 
 // Time window specified for daily maintenance operations.
 message DailyMaintenanceWindow {
   // Time within the maintenance window to start the maintenance operations.
   // Time format should be in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)
-  // format "HH:MM”, where HH : [00-23] and MM : [00-59] GMT.
+  // format "HH:MM", where HH : [00-23] and MM : [00-59] GMT.
   string start_time = 2;
 
   // [Output only] Duration of the time window, automatically chosen to be
@@ -1928,7 +2257,7 @@ message SetNodePoolManagementRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
   string zone = 2 [deprecated = true];
@@ -1941,12 +2270,12 @@ message SetNodePoolManagementRequest {
   // This field has been deprecated and replaced by the name field.
   string node_pool_id = 4 [deprecated = true];
 
-  // NodeManagement configuration for the node pool.
-  NodeManagement management = 5;
+  // Required. NodeManagement configuration for the node pool.
+  NodeManagement management = 5 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster, node pool id) of the node pool to set
   // management properties. Specified in the format
-  // 'projects/*/locations/*/clusters/*/nodePools/*'.
+  // `projects/*/locations/*/clusters/*/nodePools/*`.
   string name = 7;
 }
 
@@ -1959,7 +2288,7 @@ message SetNodePoolSizeRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
   string zone = 2 [deprecated = true];
@@ -1972,12 +2301,12 @@ message SetNodePoolSizeRequest {
   // This field has been deprecated and replaced by the name field.
   string node_pool_id = 4 [deprecated = true];
 
-  // The desired node count for the pool.
-  int32 node_count = 5;
+  // Required. The desired node count for the pool.
+  int32 node_count = 5 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster, node pool id) of the node pool to set
   // size.
-  // Specified in the format 'projects/*/locations/*/clusters/*/nodePools/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*/nodePools/*`.
   string name = 7;
 }
 
@@ -1991,7 +2320,7 @@ message RollbackNodePoolUpgradeRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
   string zone = 2 [deprecated = true];
@@ -2006,7 +2335,7 @@ message RollbackNodePoolUpgradeRequest {
 
   // The name (project, location, cluster, node pool id) of the node poll to
   // rollback upgrade.
-  // Specified in the format 'projects/*/locations/*/clusters/*/nodePools/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*/nodePools/*`.
   string name = 6;
 }
 
@@ -2016,6 +2345,52 @@ message ListNodePoolsResponse {
   repeated NodePool node_pools = 1;
 }
 
+// ClusterAutoscaling contains global, per-cluster information
+// required by Cluster Autoscaler to automatically adjust
+// the size of the cluster and create/delete
+// node pools based on the current needs.
+message ClusterAutoscaling {
+  // Enables automatic node pool creation and deletion.
+  bool enable_node_autoprovisioning = 1;
+
+  // Contains global constraints regarding minimum and maximum
+  // amount of resources in the cluster.
+  repeated ResourceLimit resource_limits = 2;
+
+  // AutoprovisioningNodePoolDefaults contains defaults for a node pool
+  // created by NAP.
+  AutoprovisioningNodePoolDefaults autoprovisioning_node_pool_defaults = 4;
+
+  // The list of Google Compute Engine [zones](https://cloud.google.com/compute/docs/zones#available)
+  // in which the NodePool's nodes can be created by NAP.
+  repeated string autoprovisioning_locations = 5;
+}
+
+// AutoprovisioningNodePoolDefaults contains defaults for a node pool created
+// by NAP.
+message AutoprovisioningNodePoolDefaults {
+  // Scopes that are used by NAP when creating node pools. If oauth_scopes are
+  // specified, service_account should be empty.
+  repeated string oauth_scopes = 1;
+
+  // The Google Cloud Platform Service Account to be used by the node VMs. If
+  // service_account is specified, scopes should be empty.
+  string service_account = 2;
+}
+
+// Contains information about amount of some resource in the cluster.
+// For memory, value should be in GB.
+message ResourceLimit {
+  // Resource name "cpu", "memory" or gpu-specific string.
+  string resource_type = 1;
+
+  // Minimum amount of the resource in the cluster.
+  int64 minimum = 2;
+
+  // Maximum amount of the resource in the cluster.
+  int64 maximum = 3;
+}
+
 // NodePoolAutoscaling contains information required by cluster autoscaler to
 // adjust the size of the node pool to the current cluster usage.
 message NodePoolAutoscaling {
@@ -2029,6 +2404,9 @@ message NodePoolAutoscaling {
   // Maximum number of nodes in the NodePool. Must be >= min_node_count. There
   // has to enough quota to scale up the cluster.
   int32 max_node_count = 3;
+
+  // Can this node pool be deleted automatically.
+  bool autoprovisioned = 4;
 }
 
 // SetLabelsRequest sets the Google Cloud Platform labels on a Google Container
@@ -2041,7 +2419,7 @@ message SetLabelsRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
   string zone = 2 [deprecated = true];
@@ -2050,19 +2428,19 @@ message SetLabelsRequest {
   // This field has been deprecated and replaced by the name field.
   string cluster_id = 3 [deprecated = true];
 
-  // The labels to set for that cluster.
-  map resource_labels = 4;
+  // Required. The labels to set for that cluster.
+  map resource_labels = 4 [(google.api.field_behavior) = REQUIRED];
 
-  // The fingerprint of the previous set of labels for this resource,
+  // Required. The fingerprint of the previous set of labels for this resource,
   // used to detect conflicts. The fingerprint is initially generated by
   // Kubernetes Engine and changes after every request to modify or update
   // labels. You must always provide an up-to-date fingerprint hash when
   // updating or changing labels. Make a get() request to the
   // resource to get the latest fingerprint.
-  string label_fingerprint = 5;
+  string label_fingerprint = 5 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster id) of the cluster to set labels.
-  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 7;
 }
 
@@ -2075,7 +2453,7 @@ message SetLegacyAbacRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
   string zone = 2 [deprecated = true];
@@ -2084,11 +2462,11 @@ message SetLegacyAbacRequest {
   // This field has been deprecated and replaced by the name field.
   string cluster_id = 3 [deprecated = true];
 
-  // Whether ABAC authorization will be enabled in the cluster.
-  bool enabled = 4;
+  // Required. Whether ABAC authorization will be enabled in the cluster.
+  bool enabled = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster id) of the cluster to set legacy abac.
-  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 6;
 }
 
@@ -2101,7 +2479,7 @@ message StartIPRotationRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
   string zone = 2 [deprecated = true];
@@ -2111,7 +2489,7 @@ message StartIPRotationRequest {
   string cluster_id = 3 [deprecated = true];
 
   // The name (project, location, cluster id) of the cluster to start IP
-  // rotation. Specified in the format 'projects/*/locations/*/clusters/*'.
+  // rotation. Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 6;
 
   // Whether to rotate credentials during IP rotation.
@@ -2126,7 +2504,7 @@ message CompleteIPRotationRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
   string zone = 2 [deprecated = true];
@@ -2136,7 +2514,7 @@ message CompleteIPRotationRequest {
   string cluster_id = 3 [deprecated = true];
 
   // The name (project, location, cluster id) of the cluster to complete IP
-  // rotation. Specified in the format 'projects/*/locations/*/clusters/*'.
+  // rotation. Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 7;
 }
 
@@ -2146,7 +2524,7 @@ message AcceleratorConfig {
   int64 accelerator_count = 1;
 
   // The accelerator type resource name. List of supported accelerators
-  // [here](/compute/docs/gpus/#Introduction)
+  // [here](https://cloud.google.com/compute/docs/gpus)
   string accelerator_type = 2;
 }
 
@@ -2158,7 +2536,7 @@ message SetNetworkPolicyRequest {
   string project_id = 1 [deprecated = true];
 
   // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
   string zone = 2 [deprecated = true];
@@ -2167,48 +2545,253 @@ message SetNetworkPolicyRequest {
   // This field has been deprecated and replaced by the name field.
   string cluster_id = 3 [deprecated = true];
 
-  // Configuration options for the NetworkPolicy feature.
-  NetworkPolicy network_policy = 4;
+  // Required. Configuration options for the NetworkPolicy feature.
+  NetworkPolicy network_policy = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster id) of the cluster to set networking
-  // policy. Specified in the format 'projects/*/locations/*/clusters/*'.
+  // policy. Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 6;
 }
 
 // SetMaintenancePolicyRequest sets the maintenance policy for a cluster.
 message SetMaintenancePolicyRequest {
-  // The Google Developers Console [project ID or project
+  // Required. The Google Developers Console [project ID or project
   // number](https://support.google.com/cloud/answer/6158840).
-  string project_id = 1;
+  string project_id = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
-  string zone = 2;
+  string zone = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // The name of the cluster to update.
-  string cluster_id = 3;
+  // Required. The name of the cluster to update.
+  string cluster_id = 3 [(google.api.field_behavior) = REQUIRED];
 
-  // The maintenance policy to be set for the cluster. An empty field
+  // Required. The maintenance policy to be set for the cluster. An empty field
   // clears the existing maintenance policy.
-  MaintenancePolicy maintenance_policy = 4;
+  MaintenancePolicy maintenance_policy = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster id) of the cluster to set maintenance
   // policy.
-  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 5;
 }
 
+// StatusCondition describes why a cluster or a node pool has a certain status
+// (e.g., ERROR or DEGRADED).
+message StatusCondition {
+  // Code for each condition
+  enum Code {
+    // UNKNOWN indicates a generic condition.
+    UNKNOWN = 0;
+
+    // GCE_STOCKOUT indicates a Google Compute Engine stockout.
+    GCE_STOCKOUT = 1;
+
+    // GKE_SERVICE_ACCOUNT_DELETED indicates that the user deleted their robot
+    // service account.
+    GKE_SERVICE_ACCOUNT_DELETED = 2;
+
+    // Google Compute Engine quota was exceeded.
+    GCE_QUOTA_EXCEEDED = 3;
+
+    // Cluster state was manually changed by an SRE due to a system logic error.
+    SET_BY_OPERATOR = 4;
+
+    // Unable to perform an encrypt operation against the CloudKMS key used for
+    // etcd level encryption.
+    // More codes TBA
+    CLOUD_KMS_KEY_ERROR = 7;
+  }
+
+  // Machine-friendly representation of the condition
+  Code code = 1;
+
+  // Human-friendly representation of the condition
+  string message = 2;
+}
+
 // NetworkConfig reports the relative names of network & subnetwork.
 message NetworkConfig {
   // Output only. The relative name of the Google Compute Engine
-  // [network][google.container.v1.NetworkConfig.network](/compute/docs/networks-and-firewalls#networks) to which
+  // [network][google.container.v1.NetworkConfig.network](https://cloud.google.com/compute/docs/networks-and-firewalls#networks) to which
   // the cluster is connected.
   // Example: projects/my-project/global/networks/my-network
   string network = 1;
 
   // Output only. The relative name of the Google Compute Engine
-  // [subnetwork](/compute/docs/vpc) to which the cluster is connected.
+  // [subnetwork](https://cloud.google.com/compute/docs/vpc) to which the cluster is connected.
   // Example: projects/my-project/regions/us-central1/subnetworks/my-subnet
   string subnetwork = 2;
+
+  // Whether Intra-node visibility is enabled for this cluster.
+  // This makes same node pod to pod traffic visible for VPC network.
+  bool enable_intra_node_visibility = 5;
+}
+
+// IntraNodeVisibilityConfig contains the desired config of the intra-node
+// visibility on this cluster.
+message IntraNodeVisibilityConfig {
+  // Enables intra node visibility for this cluster.
+  bool enabled = 1;
+}
+
+// Constraints applied to pods.
+message MaxPodsConstraint {
+  // Constraint enforced on the max num of pods per node.
+  int64 max_pods_per_node = 1;
+}
+
+// Configuration of etcd encryption.
+message DatabaseEncryption {
+  // State of etcd encryption.
+  enum State {
+    // Should never be set
+    UNKNOWN = 0;
+
+    // Secrets in etcd are encrypted.
+    ENCRYPTED = 1;
+
+    // Secrets in etcd are stored in plain text (at etcd level) - this is
+    // unrelated to GCE level full disk encryption.
+    DECRYPTED = 2;
+  }
+
+  // Denotes the state of etcd encryption.
+  State state = 2;
+
+  // Name of CloudKMS key to use for the encryption of secrets in etcd.
+  // Ex. projects/my-project/locations/global/keyRings/my-ring/cryptoKeys/my-key
+  string key_name = 1;
+}
+
+// ListUsableSubnetworksRequest requests the list of usable subnetworks
+// available to a user for creating clusters.
+message ListUsableSubnetworksRequest {
+  // The parent project where subnetworks are usable.
+  // Specified in the format `projects/*`.
+  string parent = 1;
+
+  // Filtering currently only supports equality on the networkProjectId and must
+  // be in the form: "networkProjectId=[PROJECTID]", where `networkProjectId`
+  // is the project which owns the listed subnetworks. This defaults to the
+  // parent project ID.
+  string filter = 2;
+
+  // The max number of results per page that should be returned. If the number
+  // of available results is larger than `page_size`, a `next_page_token` is
+  // returned which can be used to get the next page of results in subsequent
+  // requests. Acceptable values are 0 to 500, inclusive. (Default: 500)
+  int32 page_size = 3;
+
+  // Specifies a page token to use. Set this to the nextPageToken returned by
+  // previous list requests to get the next page of results.
+  string page_token = 4;
+}
+
+// ListUsableSubnetworksResponse is the response of
+// ListUsableSubnetworksRequest.
+message ListUsableSubnetworksResponse {
+  // A list of usable subnetworks in the specified network project.
+  repeated UsableSubnetwork subnetworks = 1;
+
+  // This token allows you to get the next page of results for list requests.
+  // If the number of results is larger than `page_size`, use the
+  // `next_page_token` as a value for the query parameter `page_token` in the
+  // next request. The value will become empty when there are no more pages.
+  string next_page_token = 2;
+}
+
+// Secondary IP range of a usable subnetwork.
+message UsableSubnetworkSecondaryRange {
+  // Status shows the current usage of a secondary IP range.
+  enum Status {
+    // UNKNOWN is the zero value of the Status enum. It's not a valid status.
+    UNKNOWN = 0;
+
+    // UNUSED denotes that this range is unclaimed by any cluster.
+    UNUSED = 1;
+
+    // IN_USE_SERVICE denotes that this range is claimed by a cluster for
+    // services. It cannot be used for other clusters.
+    IN_USE_SERVICE = 2;
+
+    // IN_USE_SHAREABLE_POD denotes this range was created by the network admin
+    // and is currently claimed by a cluster for pods. It can only be used by
+    // other clusters as a pod range.
+    IN_USE_SHAREABLE_POD = 3;
+
+    // IN_USE_MANAGED_POD denotes this range was created by GKE and is claimed
+    // for pods. It cannot be used for other clusters.
+    IN_USE_MANAGED_POD = 4;
+  }
+
+  // The name associated with this subnetwork secondary range, used when adding
+  // an alias IP range to a VM instance.
+  string range_name = 1;
+
+  // The range of IP addresses belonging to this subnetwork secondary range.
+  string ip_cidr_range = 2;
+
+  // This field is to determine the status of the secondary range programmably.
+  Status status = 3;
+}
+
+// UsableSubnetwork resource returns the subnetwork name, its associated network
+// and the primary CIDR range.
+message UsableSubnetwork {
+  // Subnetwork Name.
+  // Example: projects/my-project/regions/us-central1/subnetworks/my-subnet
+  string subnetwork = 1;
+
+  // Network Name.
+  // Example: projects/my-project/global/networks/my-network
+  string network = 2;
+
+  // The range of internal addresses that are owned by this subnetwork.
+  string ip_cidr_range = 3;
+
+  // Secondary IP ranges.
+  repeated UsableSubnetworkSecondaryRange secondary_ip_ranges = 4;
+
+  // A human readable status message representing the reasons for cases where
+  // the caller cannot use the secondary ranges under the subnet. For example if
+  // the secondary_ip_ranges is empty due to a permission issue, an insufficient
+  // permission message will be given by status_message.
+  string status_message = 5;
+}
+
+// Configuration for exporting cluster resource usages.
+message ResourceUsageExportConfig {
+  // Parameters for using BigQuery as the destination of resource usage export.
+  message BigQueryDestination {
+    // The ID of a BigQuery Dataset.
+    string dataset_id = 1;
+  }
+
+  // Parameters for controlling consumption metering.
+  message ConsumptionMeteringConfig {
+    // Whether to enable consumption metering for this cluster. If enabled, a
+    // second BigQuery table will be created to hold resource consumption
+    // records.
+    bool enabled = 1;
+  }
+
+  // Configuration to use BigQuery as usage export destination.
+  BigQueryDestination bigquery_destination = 1;
+
+  // Whether to enable network egress metering for this cluster. If enabled, a
+  // daemonset will be created in the cluster to meter network egress traffic.
+  bool enable_network_egress_metering = 2;
+
+  // Configuration to enable resource consumption metering.
+  ConsumptionMeteringConfig consumption_metering_config = 3;
+}
+
+// VerticalPodAutoscaling contains global, per-cluster information
+// required by Vertical Pod Autoscaler to automatically adjust
+// the resources of pods controlled by it.
+message VerticalPodAutoscaling {
+  // Enables vertical pod autoscaling.
+  bool enabled = 1;
 }
diff --git a/third_party/googleapis/google/container/v1/container_gapic.legacy.yaml b/third_party/googleapis/google/container/v1/container_gapic.legacy.yaml
new file mode 100644
index 000000000..17d5d60ec
--- /dev/null
+++ b/third_party/googleapis/google/container/v1/container_gapic.legacy.yaml
@@ -0,0 +1,524 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.container.v1
+  python:
+    package_name: google.cloud.container_v1.gapic
+  go:
+    package_name: cloud.google.com/go/container/apiv1
+  csharp:
+    package_name: Google.Cloud.Container.V1
+  ruby:
+    package_name: Google::Cloud::Container::V1
+    release_level: BETA
+  php:
+    package_name: Google\Cloud\Container\V1
+  nodejs:
+    package_name: container.v1
+    domain_layer_location: google-cloud
+# A list of API interface configurations.
+interfaces:
+- name: google.container.v1.ClusterManager
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections: []
+  # Definition for smoke test
+  smoke_test:
+    method: ListClusters
+    init_fields:
+    - project_id=$PROJECT_ID
+    - zone="us-central1-a"
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #   name - The simple name of the method.
+  #   flattening - Specifies the configuration for parameter flattening.
+  #       Describes the parameter groups for which a generator should produce
+  #       method overloads which allow a client to directly pass request message
+  #       fields as method parameters. This information may or may not be used,
+  #       depending on the target language.
+  #       Consists of groups, which each represent a list of parameters to be
+  #       flattened. Each parameter listed must be a field of the request
+  #       message.
+  #   required_fields - Fields that are always required for a request to be
+  #       valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the
+  #       resource name formats defined in the field_name_patterns
+  #       and response_field_name_patterns fields.
+  #       UNSET: default value
+  #       NONE: the collection configs will not be used by the generated code.
+  #       VALIDATE: string fields will be validated by the client against the
+  #           specified resource name formats.
+  #       STATIC_TYPES: the client will use generated types for resource names.
+  #   page_streaming - Specifies the configuration for paging.
+  #       Describes information for generating a method which transforms a
+  #       paging list RPC into a stream of resources.
+  #       Consists of a request and a response.
+  #       The request specifies request information of the list method. It
+  #       defines which fields match the paging pattern in the request. The
+  #       request consists of a page_size_field and a token_field. The
+  #       page_size_field is the name of the optional field specifying the
+  #       maximum number of elements to be returned in the response. The
+  #       token_field is the name of the field in the request containing the
+  #       page token.
+  #       The response specifies response information of the list method. It
+  #       defines which fields match the paging pattern in the response. The
+  #       response consists of a token_field and a resources_field. The
+  #       token_field is the name of the field in the response containing the
+  #       next page token. The resources_field is the name of the field in the
+  #       response containing the list of resources belonging to the page.
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #       name must be defined in interfaces.retry_codes_def.
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #       parameters. The name must be defined in interfaces.retry_params_def.
+  #   field_name_patterns - Maps the field name of the request type to
+  #       entity_name of interfaces.collections.
+  #       Specifies the string pattern that the field must follow.
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #       the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ListClusters
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+    required_fields:
+    - project_id
+    - zone
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: GetCluster
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: CreateCluster
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster
+    required_fields:
+    - project_id
+    - zone
+    - cluster
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 45000
+  - name: UpdateCluster
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - update
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - update
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: UpdateNodePool
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - node_pool_id
+    - node_version
+    - image_type
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: SetNodePoolAutoscaling
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - node_pool_id
+    - autoscaling
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: SetLoggingService
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - logging_service
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - logging_service
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: SetMonitoringService
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - monitoring_service
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - monitoring_service
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: SetAddonsConfig
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - addons_config
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - addons_config
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: SetLocations
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - locations
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - locations
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: UpdateMaster
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - master_version
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - master_version
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: SetMasterAuth
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - action
+    - update
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: DeleteCluster
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: ListOperations
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+    required_fields:
+    - project_id
+    - zone
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: GetOperation
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - operation_id
+    required_fields:
+    - project_id
+    - zone
+    - operation_id
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: CancelOperation
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - operation_id
+    required_fields:
+    - project_id
+    - zone
+    - operation_id
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: GetServerConfig
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+    required_fields:
+    - project_id
+    - zone
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: ListNodePools
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: GetNodePool
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - node_pool_id
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - node_pool_id
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: CreateNodePool
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - node_pool
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - node_pool
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: DeleteNodePool
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - node_pool_id
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - node_pool_id
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: RollbackNodePoolUpgrade
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - node_pool_id
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - node_pool_id
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: SetNodePoolManagement
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - node_pool_id
+    - management
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: SetLabels
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - resource_labels
+    - label_fingerprint
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: SetLegacyAbac
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - enabled
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - enabled
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: StartIPRotation
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: CompleteIPRotation
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: SetNodePoolSize
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - node_pool_id
+    - node_count
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: SetNetworkPolicy
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - network_policy
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - network_policy
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: SetMaintenancePolicy
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - maintenance_policy
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - maintenance_policy
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
diff --git a/third_party/googleapis/google/container/v1/container_gapic.yaml b/third_party/googleapis/google/container/v1/container_gapic.yaml
index 020cd74c9..4af278964 100644
--- a/third_party/googleapis/google/container/v1/container_gapic.yaml
+++ b/third_party/googleapis/google/container/v1/container_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -20,506 +20,14 @@ language_settings:
     domain_layer_location: google-cloud
 # A list of API interface configurations.
 interfaces:
-  # The fully qualified name of the API interface.
 - name: google.container.v1.ClusterManager
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections: []
-  # Definition for smoke test
   smoke_test:
     method: ListClusters
     init_fields:
     - project_id=$PROJECT_ID
     - zone="us-central1-a"
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #   name - The simple name of the method.
-  #   flattening - Specifies the configuration for parameter flattening.
-  #       Describes the parameter groups for which a generator should produce
-  #       method overloads which allow a client to directly pass request message
-  #       fields as method parameters. This information may or may not be used,
-  #       depending on the target language.
-  #       Consists of groups, which each represent a list of parameters to be
-  #       flattened. Each parameter listed must be a field of the request
-  #       message.
-  #   required_fields - Fields that are always required for a request to be
-  #       valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the
-  #       resource name formats defined in the field_name_patterns
-  #       and response_field_name_patterns fields.
-  #       UNSET: default value
-  #       NONE: the collection configs will not be used by the generated code.
-  #       VALIDATE: string fields will be validated by the client against the
-  #           specified resource name formats.
-  #       STATIC_TYPES: the client will use generated types for resource names.
-  #   page_streaming - Specifies the configuration for paging.
-  #       Describes information for generating a method which transforms a
-  #       paging list RPC into a stream of resources.
-  #       Consists of a request and a response.
-  #       The request specifies request information of the list method. It
-  #       defines which fields match the paging pattern in the request. The
-  #       request consists of a page_size_field and a token_field. The
-  #       page_size_field is the name of the optional field specifying the
-  #       maximum number of elements to be returned in the response. The
-  #       token_field is the name of the field in the request containing the
-  #       page token.
-  #       The response specifies response information of the list method. It
-  #       defines which fields match the paging pattern in the response. The
-  #       response consists of a token_field and a resources_field. The
-  #       token_field is the name of the field in the response containing the
-  #       next page token. The resources_field is the name of the field in the
-  #       response containing the list of resources belonging to the page.
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #       name must be defined in interfaces.retry_codes_def.
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #       parameters. The name must be defined in interfaces.retry_params_def.
-  #   field_name_patterns - Maps the field name of the request type to
-  #       entity_name of interfaces.collections.
-  #       Specifies the string pattern that the field must follow.
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #       the call is retrying, refer to retry_params_name instead.
   methods:
-  - name: ListClusters
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-    required_fields:
-    - project_id
-    - zone
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: GetCluster
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: CreateCluster
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster
-    required_fields:
-    - project_id
-    - zone
-    - cluster
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 45000
-  - name: UpdateCluster
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - update
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - update
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: UpdateNodePool
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - node_pool_id
-    - node_version
-    - image_type
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: SetNodePoolAutoscaling
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - node_pool_id
-    - autoscaling
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: SetLoggingService
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - logging_service
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - logging_service
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: SetMonitoringService
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - monitoring_service
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - monitoring_service
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: SetAddonsConfig
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - addons_config
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - addons_config
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: SetLocations
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - locations
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - locations
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: UpdateMaster
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - master_version
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - master_version
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: SetMasterAuth
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - action
-    - update
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
   - name: DeleteCluster
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: ListOperations
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-    required_fields:
-    - project_id
-    - zone
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: GetOperation
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - operation_id
-    required_fields:
-    - project_id
-    - zone
-    - operation_id
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: CancelOperation
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - operation_id
-    required_fields:
-    - project_id
-    - zone
-    - operation_id
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: GetServerConfig
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-    required_fields:
-    - project_id
-    - zone
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: ListNodePools
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: GetNodePool
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - node_pool_id
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - node_pool_id
     retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: CreateNodePool
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - node_pool
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - node_pool
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
   - name: DeleteNodePool
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - node_pool_id
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - node_pool_id
     retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: RollbackNodePoolUpgrade
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - node_pool_id
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - node_pool_id
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: SetNodePoolManagement
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - node_pool_id
-    - management
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: SetLabels
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - resource_labels
-    - label_fingerprint
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: SetLegacyAbac
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - enabled
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - enabled
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: StartIPRotation
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: CompleteIPRotation
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: SetNodePoolSize
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - node_pool_id
-    - node_count
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: SetNetworkPolicy
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - network_policy
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - network_policy
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: SetMaintenancePolicy
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - maintenance_policy
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - maintenance_policy
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
diff --git a/third_party/googleapis/google/container/v1/container_grpc_service_config.json b/third_party/googleapis/google/container/v1/container_grpc_service_config.json
new file mode 100755
index 000000000..29f4a3502
--- /dev/null
+++ b/third_party/googleapis/google/container/v1/container_grpc_service_config.json
@@ -0,0 +1,143 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "ListClusters"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "GetCluster"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "DeleteCluster"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "ListOperations"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "GetOperation"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "GetServerConfig"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "ListNodePools"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "GetNodePool"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "DeleteNodePool"
+        }
+      ],
+      "timeout": "20s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "CreateCluster"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "UpdateCluster"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "UpdateNodePool"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "SetNodePoolAutoscaling"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "SetLoggingService"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "SetMonitoringService"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "SetAddonsConfig"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "SetLocations"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "UpdateMaster"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "SetMasterAuth"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "CancelOperation"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "CreateNodePool"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "RollbackNodePoolUpgrade"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "SetNodePoolManagement"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "SetLabels"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "SetLegacyAbac"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "StartIPRotation"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "CompleteIPRotation"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "SetNodePoolSize"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "SetNetworkPolicy"
+        },
+        {
+          "service": "google.container.v1.ClusterManager",
+          "method": "SetMaintenancePolicy"
+        }
+      ],
+      "timeout": "45s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/container/v1/container_v1.yaml b/third_party/googleapis/google/container/v1/container_v1.yaml
new file mode 100644
index 000000000..fae84fcd2
--- /dev/null
+++ b/third_party/googleapis/google/container/v1/container_v1.yaml
@@ -0,0 +1,26 @@
+type: google.api.Service
+config_version: 3
+name: container.googleapis.com
+title: Kubernetes Engine API
+
+apis:
+- name: google.container.v1.ClusterManager
+
+documentation:
+  summary: |-
+    Builds and manages container-based applications, powered by the open source
+    Kubernetes technology.
+
+backend:
+  rules:
+  - selector: 'google.container.v1.ClusterManager.*'
+    deadline: 20.0
+  - selector: google.container.v1.ClusterManager.CreateCluster
+    deadline: 45.0
+
+authentication:
+  rules:
+  - selector: 'google.container.v1.ClusterManager.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/container/v1beta1/BUILD.bazel b/third_party/googleapis/google/container/v1beta1/BUILD.bazel
new file mode 100644
index 000000000..113720e78
--- /dev/null
+++ b/third_party/googleapis/google/container/v1beta1/BUILD.bazel
@@ -0,0 +1,358 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "container_proto",
+    srcs = [
+        "cluster_service.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "container_proto_with_info",
+    deps = [
+        ":container_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "container_java_proto",
+    deps = [":container_proto"],
+)
+
+java_grpc_library(
+    name = "container_java_grpc",
+    srcs = [":container_proto"],
+    deps = [":container_java_proto"],
+)
+
+java_gapic_library(
+    name = "container_java_gapic",
+    src = ":container_proto_with_info",
+    gapic_yaml = "container_gapic.yaml",
+    package = "google.container.v1beta1",
+    service_yaml = "container_v1beta1.yaml",
+    test_deps = [
+        ":container_java_grpc",
+    ],
+    deps = [
+        ":container_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "container_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.container.v1beta1.ClusterManagerClientTest",
+    ],
+    runtime_deps = [":container_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-container-v1beta1-java",
+    deps = [
+        ":container_java_gapic",
+        ":container_java_grpc",
+        ":container_java_proto",
+        ":container_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "container_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/container/v1beta1",
+    protos = [":container_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "container_go_gapic",
+    srcs = [":container_proto_with_info"],
+    grpc_service_config = "container_grpc_service_config.json",
+    importpath = "cloud.google.com/go/container/apiv1beta1;container",
+    service_yaml = "container_v1beta1.yaml",
+    deps = [
+        ":container_go_proto",
+    ],
+)
+
+go_test(
+    name = "container_go_gapic_test",
+    srcs = [":container_go_gapic_srcjar_test"],
+    embed = [":container_go_gapic"],
+    importpath = "cloud.google.com/go/container/apiv1beta1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-container-v1beta1-go",
+    deps = [
+        ":container_go_gapic",
+        ":container_go_gapic_srcjar-test.srcjar",
+        ":container_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "container_moved_proto",
+    srcs = [":container_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "container_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":container_moved_proto"],
+)
+
+py_grpc_library(
+    name = "container_py_grpc",
+    srcs = [":container_moved_proto"],
+    deps = [":container_py_proto"],
+)
+
+py_gapic_library(
+    name = "container_py_gapic",
+    src = ":container_proto_with_info",
+    gapic_yaml = "container_gapic.yaml",
+    package = "google.container.v1beta1",
+    service_yaml = "container_v1beta1.yaml",
+    deps = [
+        ":container_py_grpc",
+        ":container_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "container-v1beta1-py",
+    deps = [
+        ":container_py_gapic",
+        ":container_py_grpc",
+        ":container_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "container_php_proto",
+    deps = [":container_proto"],
+)
+
+php_grpc_library(
+    name = "container_php_grpc",
+    srcs = [":container_proto"],
+    deps = [":container_php_proto"],
+)
+
+php_gapic_library(
+    name = "container_php_gapic",
+    src = ":container_proto_with_info",
+    gapic_yaml = "container_gapic.yaml",
+    package = "google.container.v1beta1",
+    service_yaml = "container_v1beta1.yaml",
+    deps = [
+        ":container_php_grpc",
+        ":container_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-container-v1beta1-php",
+    deps = [
+        ":container_php_gapic",
+        ":container_php_grpc",
+        ":container_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "container_nodejs_gapic",
+    src = ":container_proto_with_info",
+    gapic_yaml = "container_gapic.yaml",
+    package = "google.container.v1beta1",
+    service_yaml = "container_v1beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "container-v1beta1-nodejs",
+    deps = [
+        ":container_nodejs_gapic",
+        ":container_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "container_ruby_proto",
+    deps = [":container_proto"],
+)
+
+ruby_grpc_library(
+    name = "container_ruby_grpc",
+    srcs = [":container_proto"],
+    deps = [":container_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "container_ruby_gapic",
+    src = ":container_proto_with_info",
+    gapic_yaml = "container_gapic.yaml",
+    package = "google.container.v1beta1",
+    service_yaml = "container_v1beta1.yaml",
+    deps = [
+        ":container_ruby_grpc",
+        ":container_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-container-v1beta1-ruby",
+    deps = [
+        ":container_ruby_gapic",
+        ":container_ruby_grpc",
+        ":container_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "container_csharp_proto",
+    deps = [":container_proto"],
+)
+
+csharp_grpc_library(
+    name = "container_csharp_grpc",
+    srcs = [":container_proto"],
+    deps = [":container_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "container_csharp_gapic",
+    src = ":container_proto_with_info",
+    gapic_yaml = "container_gapic.yaml",
+    package = "google.container.v1beta1",
+    service_yaml = "container_v1beta1.yaml",
+    deps = [
+        ":container_csharp_grpc",
+        ":container_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-container-v1beta1-csharp",
+    deps = [
+        ":container_csharp_gapic",
+        ":container_csharp_grpc",
+        ":container_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/container/v1beta1/cluster_service.proto b/third_party/googleapis/google/container/v1beta1/cluster_service.proto
index 37918d7c1..711ea2a9b 100644
--- a/third_party/googleapis/google/container/v1beta1/cluster_service.proto
+++ b/third_party/googleapis/google/container/v1beta1/cluster_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,9 +18,10 @@ syntax = "proto3";
 package google.container.v1beta1;
 
 import "google/api/annotations.proto";
-import "google/iam/v1/iam_policy.proto";
-import "google/iam/v1/policy.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/protobuf/empty.proto";
+import "google/protobuf/timestamp.proto";
 
 option csharp_namespace = "Google.Cloud.Container.V1Beta1";
 option go_package = "google.golang.org/genproto/googleapis/container/v1beta1;container";
@@ -28,10 +29,13 @@ option java_multiple_files = true;
 option java_outer_classname = "ClusterServiceProto";
 option java_package = "com.google.container.v1beta1";
 option php_namespace = "Google\\Cloud\\Container\\V1beta1";
-
+option ruby_package = "Google::Cloud::Container::V1beta1";
 
 // Google Kubernetes Engine Cluster Manager v1beta1
 service ClusterManager {
+  option (google.api.default_host) = "container.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Lists all clusters owned by a project in either the specified zone or all
   // zones.
   rpc ListClusters(ListClustersRequest) returns (ListClustersResponse) {
@@ -41,6 +45,7 @@ service ClusterManager {
         get: "/v1beta1/projects/{project_id}/zones/{zone}/clusters"
       }
     };
+    option (google.api.method_signature) = "project_id,zone";
   }
 
   // Gets the details for a specific cluster.
@@ -51,21 +56,22 @@ service ClusterManager {
         get: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id";
   }
 
   // Creates a cluster, consisting of the specified number and type of Google
   // Compute Engine instances.
   //
   // By default, the cluster is created in the project's
-  // [default network](/compute/docs/networks-and-firewalls#networks).
+  // [default network](https://cloud.google.com/compute/docs/networks-and-firewalls#networks).
   //
   // One firewall is added for the cluster. After cluster creation,
-  // the cluster creates routes for each node to allow the containers
+  // the Kubelet creates routes for each node to allow the containers
   // on that node to communicate with all other instances in the
   // cluster.
   //
   // Finally, an entry is added to the project's global metadata indicating
-  // which CIDR range is being used by the cluster.
+  // which CIDR range the cluster is using.
   rpc CreateCluster(CreateClusterRequest) returns (Operation) {
     option (google.api.http) = {
       post: "/v1beta1/{parent=projects/*/locations/*}/clusters"
@@ -75,6 +81,7 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster";
   }
 
   // Updates the settings for a specific cluster.
@@ -87,6 +94,7 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,update";
   }
 
   // Updates the version and/or image type of a specific node pool.
@@ -123,6 +131,7 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,logging_service";
   }
 
   // Sets the monitoring service for a specific cluster.
@@ -135,6 +144,7 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,monitoring_service";
   }
 
   // Sets the addons for a specific cluster.
@@ -147,6 +157,7 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,addons_config";
   }
 
   // Sets the locations for a specific cluster.
@@ -159,6 +170,7 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,locations";
   }
 
   // Updates the master for a specific cluster.
@@ -171,12 +183,12 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,master_version";
   }
 
-  // Used to set master auth materials. Currently supports :-
-  // Changing the admin password for a specific cluster.
-  // This can be either via password generation or explicitly set.
-  // Modify basic_auth.csv and reset the K8S API server.
+  // Sets master auth materials. Currently supports changing the admin password
+  // or a specific cluster, either via password generation or explicitly setting
+  // the password.
   rpc SetMasterAuth(SetMasterAuthRequest) returns (Operation) {
     option (google.api.http) = {
       post: "/v1beta1/{name=projects/*/locations/*/clusters/*}:setMasterAuth"
@@ -194,9 +206,9 @@ service ClusterManager {
   // Firewalls and routes that were configured during cluster creation
   // are also deleted.
   //
-  // Other Google Compute Engine resources that might be in use by the cluster
-  // (e.g. load balancer resources) will not be deleted if they weren't present
-  // at the initial create time.
+  // Other Google Compute Engine resources that might be in use by the cluster,
+  // such as load balancer resources, are not deleted if they weren't present
+  // when the cluster was initially created.
   rpc DeleteCluster(DeleteClusterRequest) returns (Operation) {
     option (google.api.http) = {
       delete: "/v1beta1/{name=projects/*/locations/*/clusters/*}"
@@ -204,9 +216,10 @@ service ClusterManager {
         delete: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id";
   }
 
-  // Lists all operations in a project in a specific zone or all zones.
+  // Lists all operations in a project in the specified zone or all zones.
   rpc ListOperations(ListOperationsRequest) returns (ListOperationsResponse) {
     option (google.api.http) = {
       get: "/v1beta1/{parent=projects/*/locations/*}/operations"
@@ -214,6 +227,7 @@ service ClusterManager {
         get: "/v1beta1/projects/{project_id}/zones/{zone}/operations"
       }
     };
+    option (google.api.method_signature) = "project_id,zone";
   }
 
   // Gets the specified operation.
@@ -224,6 +238,7 @@ service ClusterManager {
         get: "/v1beta1/projects/{project_id}/zones/{zone}/operations/{operation_id}"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,operation_id";
   }
 
   // Cancels the specified operation.
@@ -236,9 +251,10 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,operation_id";
   }
 
-  // Returns configuration info about the Kubernetes Engine service.
+  // Returns configuration info about the Google Kubernetes Engine service.
   rpc GetServerConfig(GetServerConfigRequest) returns (ServerConfig) {
     option (google.api.http) = {
       get: "/v1beta1/{name=projects/*/locations/*}/serverConfig"
@@ -246,6 +262,7 @@ service ClusterManager {
         get: "/v1beta1/projects/{project_id}/zones/{zone}/serverconfig"
       }
     };
+    option (google.api.method_signature) = "project_id,zone";
   }
 
   // Lists the node pools for a cluster.
@@ -256,9 +273,10 @@ service ClusterManager {
         get: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id";
   }
 
-  // Retrieves the node pool requested.
+  // Retrieves the requested node pool.
   rpc GetNodePool(GetNodePoolRequest) returns (NodePool) {
     option (google.api.http) = {
       get: "/v1beta1/{name=projects/*/locations/*/clusters/*/nodePools/*}"
@@ -266,6 +284,7 @@ service ClusterManager {
         get: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,node_pool_id";
   }
 
   // Creates a node pool for a cluster.
@@ -278,6 +297,7 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,node_pool";
   }
 
   // Deletes a node pool from a cluster.
@@ -288,10 +308,11 @@ service ClusterManager {
         delete: "/v1beta1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,node_pool_id";
   }
 
-  // Roll back the previously Aborted or Failed NodePool upgrade.
-  // This will be an no-op if the last upgrade successfully completed.
+  // Rolls back a previously Aborted or Failed NodePool upgrade.
+  // This makes no changes if the last upgrade successfully completed.
   rpc RollbackNodePoolUpgrade(RollbackNodePoolUpgradeRequest) returns (Operation) {
     option (google.api.http) = {
       post: "/v1beta1/{name=projects/*/locations/*/clusters/*/nodePools/*}:rollback"
@@ -301,6 +322,7 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,node_pool_id";
   }
 
   // Sets the NodeManagement options for a node pool.
@@ -313,6 +335,7 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,node_pool_id,management";
   }
 
   // Sets labels on a cluster.
@@ -325,6 +348,7 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,resource_labels,label_fingerprint";
   }
 
   // Enables or disables the ABAC authorization mechanism on a cluster.
@@ -337,9 +361,10 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,enabled";
   }
 
-  // Start master IP rotation.
+  // Starts master IP rotation.
   rpc StartIPRotation(StartIPRotationRequest) returns (Operation) {
     option (google.api.http) = {
       post: "/v1beta1/{name=projects/*/locations/*/clusters/*}:startIpRotation"
@@ -349,6 +374,7 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id";
   }
 
   // Completes master IP rotation.
@@ -361,6 +387,7 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id";
   }
 
   // Sets the size for a specific node pool.
@@ -375,7 +402,7 @@ service ClusterManager {
     };
   }
 
-  // Enables/Disables Network Policy for a cluster.
+  // Enables or disables Network Policy for a cluster.
   rpc SetNetworkPolicy(SetNetworkPolicyRequest) returns (Operation) {
     option (google.api.http) = {
       post: "/v1beta1/{name=projects/*/locations/*/clusters/*}:setNetworkPolicy"
@@ -385,6 +412,7 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,network_policy";
   }
 
   // Sets the maintenance policy for a cluster.
@@ -397,27 +425,30 @@ service ClusterManager {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "project_id,zone,cluster_id,maintenance_policy";
   }
 
-  // Lists subnetworks that are usable for creating clusters in a project.
+  // Lists subnetworks that can be used for creating clusters in a project.
   rpc ListUsableSubnetworks(ListUsableSubnetworksRequest) returns (ListUsableSubnetworksResponse) {
     option (google.api.http) = {
       get: "/v1beta1/{parent=projects/*}/aggregated/usableSubnetworks"
     };
+    option (google.api.method_signature) = "parent";
   }
 
-  // Used to fetch locations that offer GKE.
+  // Fetches locations that offer Google Kubernetes Engine.
   rpc ListLocations(ListLocationsRequest) returns (ListLocationsResponse) {
     option (google.api.http) = {
       get: "/v1beta1/{parent=projects/*}/locations"
     };
+    option (google.api.method_signature) = "parent";
   }
 }
 
 // Parameters that describe the nodes in a cluster.
 message NodeConfig {
   // The name of a Google Compute Engine [machine
-  // type](/compute/docs/machine-types) (e.g.
+  // type](https://cloud.google.com/compute/docs/machine-types) (e.g.
   // `n1-standard-1`).
   //
   // If unspecified, the default machine type is
@@ -440,7 +471,7 @@ message NodeConfig {
   // persistent storage on your nodes.
   // * `https://www.googleapis.com/auth/devstorage.read_only` is required for
   // communicating with **gcr.io**
-  // (the [Google Container Registry](/container-registry/)).
+  // (the [Google Container Registry](https://cloud.google.com/container-registry/)).
   //
   // If unspecified, no scopes are added, unless Cloud Logging or Cloud
   // Monitoring are enabled, in which case their required scopes will be added.
@@ -460,14 +491,22 @@ message NodeConfig {
   //  "cluster-name"
   //  "cluster-uid"
   //  "configure-sh"
+  //  "containerd-configure-sh"
   //  "enable-oslogin"
   //  "gci-ensure-gke-docker"
+  //  "gci-metrics-enabled"
   //  "gci-update-strategy"
   //  "instance-template"
   //  "kube-env"
   //  "startup-script"
   //  "user-data"
-  //
+  //  "disable-address-manager"
+  //  "windows-startup-script-ps1"
+  //  "common-psm1"
+  //  "k8s-node-setup-psm1"
+  //  "install-ssh-psm1"
+  //  "user-profile-psm1"
+  //  "serial-port-logging-enable"
   // Values are free-form strings, and only have meaning as interpreted by
   // the image running in the instance. The only restriction placed on them is
   // that each value's size must be less than or equal to 32 KB.
@@ -491,9 +530,9 @@ message NodeConfig {
 
   // The number of local SSD disks to be attached to the node.
   //
-  // The limit for this value is dependant upon the maximum number of
+  // The limit for this value is dependent upon the maximum number of
   // disks available on a machine per zone. See:
-  // https://cloud.google.com/compute/docs/disks/local-ssd#local_ssd_limits
+  // https://cloud.google.com/compute/docs/disks/local-ssd
   // for more information.
   int32 local_ssd_count = 7;
 
@@ -525,6 +564,7 @@ message NodeConfig {
   // minCpuPlatform: "Intel Sandy Bridge". For more
   // information, read [how to specify min CPU
   // platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
+  // To unset the min cpu platform field pass "automatic" as field value.
   string min_cpu_platform = 13;
 
   // The workload metadata configuration for this node.
@@ -535,6 +575,27 @@ message NodeConfig {
   // For more information, including usage and the valid values, see:
   // https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/
   repeated NodeTaint taints = 15;
+
+  // Shielded Instance options.
+  ShieldedInstanceConfig shielded_instance_config = 20;
+}
+
+// A set of Shielded Instance options.
+message ShieldedInstanceConfig {
+  // Defines whether the instance has Secure Boot enabled.
+  //
+  // Secure Boot helps ensure that the system only runs authentic software by
+  // verifying the digital signature of all boot components, and halting the
+  // boot process if signature verification fails.
+  bool enable_secure_boot = 1;
+
+  // Defines whether the instance has integrity monitoring enabled.
+  //
+  // Enables monitoring and attestation of the boot integrity of the instance.
+  // The attestation is performed against the integrity policy baseline. This
+  // baseline is initially derived from the implicitly trusted boot image when
+  // the instance is created.
+  bool enable_integrity_monitoring = 2;
 }
 
 // Kubernetes taint is comprised of three fields: key, value, and effect. Effect
@@ -620,7 +681,11 @@ message AddonsConfig {
   HorizontalPodAutoscaling horizontal_pod_autoscaling = 2;
 
   // Configuration for the Kubernetes Dashboard.
-  KubernetesDashboard kubernetes_dashboard = 3;
+  // This addon is deprecated, and will be disabled in 1.15. It is recommended
+  // to use the Cloud Console to manage and monitor your Kubernetes clusters,
+  // workloads and applications. For more information, see:
+  // https://cloud.google.com/kubernetes-engine/docs/concepts/dashboards
+  KubernetesDashboard kubernetes_dashboard = 3 [deprecated = true];
 
   // Configuration for NetworkPolicy. This only tracks whether the addon
   // is enabled or not on the Master, it does not track whether network policy
@@ -906,6 +971,17 @@ message PodSecurityPolicyConfig {
   bool enabled = 1;
 }
 
+// Configuration for returning group information from authenticators.
+message AuthenticatorGroupsConfig {
+  // Whether this cluster should return group membership lookups
+  // during authentication using a group of security groups.
+  bool enabled = 1;
+
+  // The name of the security group-of-groups to be used. Only relevant
+  // if enabled = true.
+  string security_group = 2;
+}
+
 // A Google Kubernetes Engine cluster.
 message Cluster {
   // The current status of the cluster.
@@ -938,7 +1014,8 @@ message Cluster {
   }
 
   // The name of this cluster. The name must be unique within this project
-  // and zone, and can be up to 40 characters with the following restrictions:
+  // and location (e.g. zone or region), and can be up to 40 characters with
+  // the following restrictions:
   //
   // * Lowercase letters, numbers, and hyphens only.
   // * Must start with a letter.
@@ -956,19 +1033,22 @@ message Cluster {
   // "node_pool" object, since this configuration (along with the
   // "node_config") will be used to create a "NodePool" object with an
   // auto-generated name. Do not use this and a node_pool at the same time.
-  int32 initial_node_count = 3;
+  //
+  // This field is deprecated, use node_pool.initial_node_count instead.
+  int32 initial_node_count = 3 [deprecated = true];
 
   // Parameters used in creating the cluster's nodes.
-  // See `nodeConfig` for the description of its properties.
   // For requests, this field should only be used in lieu of a
   // "node_pool" object, since this configuration (along with the
   // "initial_node_count") will be used to create a "NodePool" object with an
   // auto-generated name. Do not use this and a node_pool at the same time.
   // For responses, this field will be populated with the node configuration of
-  // the first node pool.
+  // the first node pool. (For configuration of each node pool, see
+  // `node_pool.config`)
   //
   // If unspecified, the defaults are used.
-  NodeConfig node_config = 4;
+  // This field is deprecated, use node_pool.config instead.
+  NodeConfig node_config = 4 [deprecated = true];
 
   // The authentication information for accessing the master endpoint.
   // If unspecified, the defaults are used:
@@ -994,7 +1074,7 @@ message Cluster {
   string monitoring_service = 7;
 
   // The name of the Google Compute Engine
-  // [network](/compute/docs/networks-and-firewalls#networks) to which the
+  // [network](https://cloud.google.com/compute/docs/networks-and-firewalls#networks) to which the
   // cluster is connected. If left unspecified, the `default` network
   // will be used. On output this shows the network ID instead of
   // the name.
@@ -1010,7 +1090,7 @@ message Cluster {
   AddonsConfig addons_config = 10;
 
   // The name of the Google Compute Engine
-  // [subnetwork](/compute/docs/subnetworks) to which the
+  // [subnetwork](https://cloud.google.com/compute/docs/subnetworks) to which the
   // cluster is connected. On output this shows the subnetwork ID instead of
   // the name.
   string subnetwork = 11;
@@ -1021,7 +1101,7 @@ message Cluster {
   repeated NodePool node_pools = 12;
 
   // The list of Google Compute Engine
-  // [zones](/compute/docs/zones#available) in which the cluster's nodes
+  // [zones](https://cloud.google.com/compute/docs/zones#available) in which the cluster's nodes
   // should be located.
   repeated string locations = 13;
 
@@ -1090,6 +1170,9 @@ message Cluster {
   // disabled when this config unspecified.
   ResourceUsageExportConfig resource_usage_export_config = 33;
 
+  // Configuration controlling RBAC group membership information.
+  AuthenticatorGroupsConfig authenticator_groups_config = 34;
+
   // Configuration for private cluster.
   PrivateClusterConfig private_cluster_config = 37;
 
@@ -1100,7 +1183,7 @@ message Cluster {
   string self_link = 100;
 
   // [Output only] The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field is deprecated, use location instead.
   string zone = 101 [deprecated = true];
@@ -1132,7 +1215,7 @@ message Cluster {
   string current_master_version = 104;
 
   // [Output only] Deprecated, use
-  // [NodePool.version](/kubernetes-engine/docs/reference/rest/v1beta1/projects.zones.clusters.nodePool)
+  // [NodePool.version](https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1beta1/projects.locations.clusters.nodePools)
   // instead. The current version of the node software components.
   // If they are currently at multiple versions because they're in the process
   // of being upgraded, this reflects the minimum version of all nodes.
@@ -1147,11 +1230,12 @@ message Cluster {
 
   // [Output only] Additional information about the current status of this
   // cluster, if available.
-  string status_message = 108;
+  string status_message = 108 [deprecated = true];
 
   // [Output only] The size of the address space on each node for hosting
   // containers. This is provisioned from within the `container_ipv4_cidr`
-  // range.
+  // range. This field will only be set when cluster is in route-based network
+  // mode.
   int32 node_ipv4_cidr_size = 109;
 
   // [Output only] The IP address range of the Kubernetes services in
@@ -1173,8 +1257,8 @@ message Cluster {
   string expire_time = 113;
 
   // [Output only] The name of the Google Compute Engine
-  // [zone](/compute/docs/regions-zones/regions-zones#available) or
-  // [region](/compute/docs/regions-zones/regions-zones#available) in which
+  // [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available) or
+  // [region](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available) in which
   // the cluster resides.
   string location = 114;
 
@@ -1186,6 +1270,9 @@ message Cluster {
   // notation (e.g. `1.2.3.4/29`).
   string tpu_ipv4_cidr_block = 116;
 
+  // Configuration of etcd encryption.
+  DatabaseEncryption database_encryption = 38;
+
   // Which conditions caused the current cluster state.
   repeated StatusCondition conditions = 118;
 }
@@ -1211,7 +1298,7 @@ message ClusterUpdate {
   // Currently available options:
   //
   // * "monitoring.googleapis.com/kubernetes" - the Google Cloud Monitoring
-  // service with Kubernetes-native resource model in Stackdriver
+  // service with Kubernetes-native resource model
   // * "monitoring.googleapis.com" - the Google Cloud Monitoring service
   // * "none" - no metrics will be exported from the cluster
   string desired_monitoring_service = 5;
@@ -1220,9 +1307,9 @@ message ClusterUpdate {
   AddonsConfig desired_addons_config = 6;
 
   // The node pool to be upgraded. This field is mandatory if
-  // "desired_node_version", "desired_image_family" or
-  // "desired_node_pool_autoscaling" is specified and there is more than one
-  // node pool on the cluster.
+  // "desired_node_version", "desired_image_family",
+  // "desired_node_pool_autoscaling", or "desired_workload_metadata_config"
+  // is specified and there is more than one node pool on the cluster.
   string desired_node_pool_id = 7;
 
   // The desired image type for the node pool.
@@ -1236,7 +1323,7 @@ message ClusterUpdate {
   NodePoolAutoscaling desired_node_pool_autoscaling = 9;
 
   // The desired list of Google Compute Engine
-  // [zones](/compute/docs/zones#available) in which the cluster's nodes
+  // [zones](https://cloud.google.com/compute/docs/zones#available) in which the cluster's nodes
   // should be located. Changing the locations a cluster is in will result
   // in nodes being either created or removed from the cluster, depending on
   // whether locations are being added or removed.
@@ -1260,7 +1347,7 @@ message ClusterUpdate {
   // Currently available options:
   //
   // * "logging.googleapis.com/kubernetes" - the Google Cloud Logging
-  // service with Kubernetes-native resource model in Stackdriver
+  // service with Kubernetes-native resource model
   // * "logging.googleapis.com" - the Google Cloud Logging service
   // * "none" - no logs will be exported from the cluster
   string desired_logging_service = 19;
@@ -1271,6 +1358,9 @@ message ClusterUpdate {
   // Cluster-level Vertical Pod Autoscaling configuration.
   VerticalPodAutoscaling desired_vertical_pod_autoscaling = 22;
 
+  // The desired config of Intra-node visibility.
+  IntraNodeVisibilityConfig desired_intra_node_visibility_config = 26;
+
   // The Kubernetes version to change the master to. The only valid value is the
   // latest supported version.
   //
@@ -1364,7 +1454,7 @@ message Operation {
   string name = 1;
 
   // The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the operation
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the operation
   // is taking place.
   // This field is deprecated, use location instead.
   string zone = 2 [deprecated = true];
@@ -1379,7 +1469,7 @@ message Operation {
   string detail = 8;
 
   // If an error has occurred, a textual description of the error.
-  string status_message = 5;
+  string status_message = 5 [deprecated = true];
 
   // Server-defined URL for the resource.
   string self_link = 6;
@@ -1388,8 +1478,8 @@ message Operation {
   string target_link = 7;
 
   // [Output only] The name of the Google Compute Engine
-  // [zone](/compute/docs/regions-zones/regions-zones#available) or
-  // [region](/compute/docs/regions-zones/regions-zones#available) in which
+  // [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available) or
+  // [region](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available) in which
   // the cluster resides.
   string location = 9;
 
@@ -1454,95 +1544,131 @@ message OperationProgress {
 
 // CreateClusterRequest creates a cluster.
 message CreateClusterRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://support.google.com/cloud/answer/6158840).
   // This field has been deprecated and replaced by the parent field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the parent field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // A [cluster
-  // resource](/container-engine/reference/rest/v1beta1/projects.zones.clusters)
-  Cluster cluster = 3;
+  // Required. A [cluster
+  // resource](https://cloud.google.com/container-engine/reference/rest/v1beta1/projects.zones.clusters)
+  Cluster cluster = 3 [(google.api.field_behavior) = REQUIRED];
 
   // The parent (project and location) where the cluster will be created.
-  // Specified in the format 'projects/*/locations/*'.
+  // Specified in the format `projects/*/locations/*`.
   string parent = 5;
 }
 
 // GetClusterRequest gets the settings of a cluster.
 message GetClusterRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://support.google.com/cloud/answer/6158840).
   // This field has been deprecated and replaced by the name field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the cluster to retrieve.
+  // Required. Deprecated. The name of the cluster to retrieve.
   // This field has been deprecated and replaced by the name field.
-  string cluster_id = 3 [deprecated = true];
+  string cluster_id = 3 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
   // The name (project, location, cluster) of the cluster to retrieve.
-  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 5;
 }
 
 // UpdateClusterRequest updates the settings of a cluster.
 message UpdateClusterRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://support.google.com/cloud/answer/6158840).
   // This field has been deprecated and replaced by the name field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the cluster to upgrade.
+  // Required. Deprecated. The name of the cluster to upgrade.
   // This field has been deprecated and replaced by the name field.
-  string cluster_id = 3 [deprecated = true];
+  string cluster_id = 3 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // A description of the update.
-  ClusterUpdate update = 4;
+  // Required. A description of the update.
+  ClusterUpdate update = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster) of the cluster to update.
-  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 5;
 }
 
 // SetNodePoolVersionRequest updates the version of a node pool.
 message UpdateNodePoolRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://support.google.com/cloud/answer/6158840).
   // This field has been deprecated and replaced by the name field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the cluster to upgrade.
+  // Required. Deprecated. The name of the cluster to upgrade.
   // This field has been deprecated and replaced by the name field.
-  string cluster_id = 3 [deprecated = true];
+  string cluster_id = 3 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the node pool to upgrade.
+  // Required. Deprecated. The name of the node pool to upgrade.
   // This field has been deprecated and replaced by the name field.
-  string node_pool_id = 4 [deprecated = true];
+  string node_pool_id = 4 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // The Kubernetes version to change the nodes to (typically an
+  // Required. The Kubernetes version to change the nodes to (typically an
   // upgrade).
   //
   // Users may specify either explicit versions offered by Kubernetes Engine or
@@ -1553,180 +1679,240 @@ message UpdateNodePoolRequest {
   // - "1.X.Y": picks the highest valid gke.N patch in the 1.X.Y version
   // - "1.X.Y-gke.N": picks an explicit Kubernetes version
   // - "-": picks the Kubernetes master version
-  string node_version = 5;
+  string node_version = 5 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The desired image type for the node pool.
+  string image_type = 6 [(google.api.field_behavior) = REQUIRED];
 
   // The desired image type for the node pool.
-  string image_type = 6;
+  WorkloadMetadataConfig workload_metadata_config = 14;
 
   // The name (project, location, cluster, node pool) of the node pool to
   // update. Specified in the format
-  // 'projects/*/locations/*/clusters/*/nodePools/*'.
+  // `projects/*/locations/*/clusters/*/nodePools/*`.
   string name = 8;
 }
 
 // SetNodePoolAutoscalingRequest sets the autoscaler settings of a node pool.
 message SetNodePoolAutoscalingRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://support.google.com/cloud/answer/6158840).
   // This field has been deprecated and replaced by the name field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the cluster to upgrade.
+  // Required. Deprecated. The name of the cluster to upgrade.
   // This field has been deprecated and replaced by the name field.
-  string cluster_id = 3 [deprecated = true];
+  string cluster_id = 3 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the node pool to upgrade.
+  // Required. Deprecated. The name of the node pool to upgrade.
   // This field has been deprecated and replaced by the name field.
-  string node_pool_id = 4 [deprecated = true];
+  string node_pool_id = 4 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Autoscaling configuration for the node pool.
-  NodePoolAutoscaling autoscaling = 5;
+  // Required. Autoscaling configuration for the node pool.
+  NodePoolAutoscaling autoscaling = 5 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster, node pool) of the node pool to set
   // autoscaler settings. Specified in the format
-  // 'projects/*/locations/*/clusters/*/nodePools/*'.
+  // `projects/*/locations/*/clusters/*/nodePools/*`.
   string name = 6;
 }
 
 // SetLoggingServiceRequest sets the logging service of a cluster.
 message SetLoggingServiceRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://support.google.com/cloud/answer/6158840).
   // This field has been deprecated and replaced by the name field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
-  string zone = 2;
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the cluster to upgrade.
+  // Required. Deprecated. The name of the cluster to upgrade.
   // This field has been deprecated and replaced by the name field.
-  string cluster_id = 3 [deprecated = true];
+  string cluster_id = 3 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // The logging service the cluster should use to write metrics.
+  // Required. The logging service the cluster should use to write metrics.
   // Currently available options:
   //
   // * "logging.googleapis.com" - the Google Cloud Logging service
   // * "none" - no metrics will be exported from the cluster
-  string logging_service = 4;
+  string logging_service = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster) of the cluster to set logging.
-  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 5;
 }
 
 // SetMonitoringServiceRequest sets the monitoring service of a cluster.
 message SetMonitoringServiceRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://support.google.com/cloud/answer/6158840).
   // This field has been deprecated and replaced by the name field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the cluster to upgrade.
+  // Required. Deprecated. The name of the cluster to upgrade.
   // This field has been deprecated and replaced by the name field.
-  string cluster_id = 3 [deprecated = true];
+  string cluster_id = 3 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // The monitoring service the cluster should use to write metrics.
+  // Required. The monitoring service the cluster should use to write metrics.
   // Currently available options:
   //
   // * "monitoring.googleapis.com" - the Google Cloud Monitoring service
   // * "none" - no metrics will be exported from the cluster
-  string monitoring_service = 4;
+  string monitoring_service = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster) of the cluster to set monitoring.
-  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 6;
 }
 
 // SetAddonsRequest sets the addons associated with the cluster.
 message SetAddonsConfigRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://support.google.com/cloud/answer/6158840).
   // This field has been deprecated and replaced by the name field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the cluster to upgrade.
+  // Required. Deprecated. The name of the cluster to upgrade.
   // This field has been deprecated and replaced by the name field.
-  string cluster_id = 3 [deprecated = true];
+  string cluster_id = 3 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // The desired configurations for the various addons available to run in the
+  // Required. The desired configurations for the various addons available to run in the
   // cluster.
-  AddonsConfig addons_config = 4;
+  AddonsConfig addons_config = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster) of the cluster to set addons.
-  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 6;
 }
 
 // SetLocationsRequest sets the locations of the cluster.
 message SetLocationsRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://support.google.com/cloud/answer/6158840).
   // This field has been deprecated and replaced by the name field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the cluster to upgrade.
+  // Required. Deprecated. The name of the cluster to upgrade.
   // This field has been deprecated and replaced by the name field.
-  string cluster_id = 3 [deprecated = true];
+  string cluster_id = 3 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // The desired list of Google Compute Engine
-  // [zones](/compute/docs/zones#available) in which the cluster's nodes
+  // Required. The desired list of Google Compute Engine
+  // [zones](https://cloud.google.com/compute/docs/zones#available) in which the cluster's nodes
   // should be located. Changing the locations a cluster is in will result
   // in nodes being either created or removed from the cluster, depending on
   // whether locations are being added or removed.
   //
   // This list must always include the cluster's primary zone.
-  repeated string locations = 4;
+  repeated string locations = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster) of the cluster to set locations.
-  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 6;
 }
 
 // UpdateMasterRequest updates the master of the cluster.
 message UpdateMasterRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://support.google.com/cloud/answer/6158840).
   // This field has been deprecated and replaced by the name field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the cluster to upgrade.
+  // Required. Deprecated. The name of the cluster to upgrade.
   // This field has been deprecated and replaced by the name field.
-  string cluster_id = 3 [deprecated = true];
+  string cluster_id = 3 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // The Kubernetes version to change the master to.
+  // Required. The Kubernetes version to change the master to.
   //
   // Users may specify either explicit versions offered by
   // Kubernetes Engine or version aliases, which have the following behavior:
@@ -1736,10 +1922,10 @@ message UpdateMasterRequest {
   // - "1.X.Y": picks the highest valid gke.N patch in the 1.X.Y version
   // - "1.X.Y-gke.N": picks an explicit Kubernetes version
   // - "-": picks the default Kubernetes version
-  string master_version = 4;
+  string master_version = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster) of the cluster to update.
-  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 7;
 }
 
@@ -1763,69 +1949,93 @@ message SetMasterAuthRequest {
     SET_USERNAME = 3;
   }
 
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://support.google.com/cloud/answer/6158840).
   // This field has been deprecated and replaced by the name field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the cluster to upgrade.
+  // Required. Deprecated. The name of the cluster to upgrade.
   // This field has been deprecated and replaced by the name field.
-  string cluster_id = 3 [deprecated = true];
+  string cluster_id = 3 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // The exact form of action to be taken on the master auth.
-  Action action = 4;
+  // Required. The exact form of action to be taken on the master auth.
+  Action action = 4 [(google.api.field_behavior) = REQUIRED];
 
-  // A description of the update.
-  MasterAuth update = 5;
+  // Required. A description of the update.
+  MasterAuth update = 5 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster) of the cluster to set auth.
-  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 7;
 }
 
 // DeleteClusterRequest deletes a cluster.
 message DeleteClusterRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://support.google.com/cloud/answer/6158840).
   // This field has been deprecated and replaced by the name field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the cluster to delete.
+  // Required. Deprecated. The name of the cluster to delete.
   // This field has been deprecated and replaced by the name field.
-  string cluster_id = 3 [deprecated = true];
+  string cluster_id = 3 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
   // The name (project, location, cluster) of the cluster to delete.
-  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 4;
 }
 
 // ListClustersRequest lists clusters.
 message ListClustersRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://support.google.com/cloud/answer/6158840).
   // This field has been deprecated and replaced by the parent field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides, or "-" for all zones.
   // This field has been deprecated and replaced by the parent field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
   // The parent (project and location) where the clusters will be listed.
-  // Specified in the format 'projects/*/locations/*'.
+  // Specified in the format `projects/*/locations/*`.
   // Location "-" matches all zones and all regions.
   string parent = 4;
 }
@@ -1843,62 +2053,86 @@ message ListClustersResponse {
 
 // GetOperationRequest gets a single operation.
 message GetOperationRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://support.google.com/cloud/answer/6158840).
   // This field has been deprecated and replaced by the name field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The server-assigned `name` of the operation.
+  // Required. Deprecated. The server-assigned `name` of the operation.
   // This field has been deprecated and replaced by the name field.
-  string operation_id = 3 [deprecated = true];
+  string operation_id = 3 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
   // The name (project, location, operation id) of the operation to get.
-  // Specified in the format 'projects/*/locations/*/operations/*'.
+  // Specified in the format `projects/*/locations/*/operations/*`.
   string name = 5;
 }
 
 // ListOperationsRequest lists operations.
 message ListOperationsRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://support.google.com/cloud/answer/6158840).
   // This field has been deprecated and replaced by the parent field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) to return operations for, or `-` for
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) to return operations for, or `-` for
   // all zones. This field has been deprecated and replaced by the parent field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
   // The parent (project and location) where the operations will be listed.
-  // Specified in the format 'projects/*/locations/*'.
+  // Specified in the format `projects/*/locations/*`.
   // Location "-" matches all zones and all regions.
   string parent = 4;
 }
 
 // CancelOperationRequest cancels a single operation.
 message CancelOperationRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://support.google.com/cloud/answer/6158840).
   // This field has been deprecated and replaced by the name field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the operation resides.
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the operation resides.
   // This field has been deprecated and replaced by the name field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The server-assigned `name` of the operation.
+  // Required. Deprecated. The server-assigned `name` of the operation.
   // This field has been deprecated and replaced by the name field.
-  string operation_id = 3 [deprecated = true];
+  string operation_id = 3 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
   // The name (project, location, operation id) of the operation to cancel.
-  // Specified in the format 'projects/*/locations/*/operations/*'.
+  // Specified in the format `projects/*/locations/*/operations/*`.
   string name = 4;
 }
 
@@ -1914,18 +2148,24 @@ message ListOperationsResponse {
 
 // Gets the current Kubernetes Engine service configuration.
 message GetServerConfigRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://support.google.com/cloud/answer/6158840).
   // This field has been deprecated and replaced by the name field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) to return operations for.
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) to return operations for.
   // This field has been deprecated and replaced by the name field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // The name (project and location) of the server config to get
-  // Specified in the format 'projects/*/locations/*'.
+  // The name (project and location) of the server config to get,
+  // specified in the format `projects/*/locations/*`.
   string name = 4;
 }
 
@@ -1949,103 +2189,145 @@ message ServerConfig {
 
 // CreateNodePoolRequest creates a node pool for a cluster.
 message CreateNodePoolRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://developers.google.com/console/help/new/#projectnumber).
   // This field has been deprecated and replaced by the parent field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the parent field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the cluster.
+  // Required. Deprecated. The name of the cluster.
   // This field has been deprecated and replaced by the parent field.
-  string cluster_id = 3 [deprecated = true];
+  string cluster_id = 3 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // The node pool to create.
-  NodePool node_pool = 4;
+  // Required. The node pool to create.
+  NodePool node_pool = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The parent (project, location, cluster id) where the node pool will be
   // created. Specified in the format
-  // 'projects/*/locations/*/clusters/*'.
+  // `projects/*/locations/*/clusters/*`.
   string parent = 6;
 }
 
 // DeleteNodePoolRequest deletes a node pool for a cluster.
 message DeleteNodePoolRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://developers.google.com/console/help/new/#projectnumber).
   // This field has been deprecated and replaced by the name field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the cluster.
+  // Required. Deprecated. The name of the cluster.
   // This field has been deprecated and replaced by the name field.
-  string cluster_id = 3 [deprecated = true];
+  string cluster_id = 3 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the node pool to delete.
+  // Required. Deprecated. The name of the node pool to delete.
   // This field has been deprecated and replaced by the name field.
-  string node_pool_id = 4 [deprecated = true];
+  string node_pool_id = 4 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
   // The name (project, location, cluster, node pool id) of the node pool to
   // delete. Specified in the format
-  // 'projects/*/locations/*/clusters/*/nodePools/*'.
+  // `projects/*/locations/*/clusters/*/nodePools/*`.
   string name = 6;
 }
 
 // ListNodePoolsRequest lists the node pool(s) for a cluster.
 message ListNodePoolsRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://developers.google.com/console/help/new/#projectnumber).
   // This field has been deprecated and replaced by the parent field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the parent field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the cluster.
+  // Required. Deprecated. The name of the cluster.
   // This field has been deprecated and replaced by the parent field.
-  string cluster_id = 3 [deprecated = true];
+  string cluster_id = 3 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
   // The parent (project, location, cluster id) where the node pools will be
-  // listed. Specified in the format 'projects/*/locations/*/clusters/*'.
+  // listed. Specified in the format `projects/*/locations/*/clusters/*`.
   string parent = 5;
 }
 
 // GetNodePoolRequest retrieves a node pool for a cluster.
 message GetNodePoolRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://developers.google.com/console/help/new/#projectnumber).
   // This field has been deprecated and replaced by the name field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the cluster.
+  // Required. Deprecated. The name of the cluster.
   // This field has been deprecated and replaced by the name field.
-  string cluster_id = 3 [deprecated = true];
+  string cluster_id = 3 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the node pool.
+  // Required. Deprecated. The name of the node pool.
   // This field has been deprecated and replaced by the name field.
-  string node_pool_id = 4 [deprecated = true];
+  string node_pool_id = 4 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
   // The name (project, location, cluster, node pool id) of the node pool to
   // get. Specified in the format
-  // 'projects/*/locations/*/clusters/*/nodePools/*'.
+  // `projects/*/locations/*/clusters/*/nodePools/*`.
   string name = 6;
 }
 
@@ -2106,7 +2388,7 @@ message NodePool {
   string version = 101;
 
   // [Output only] The resource URLs of the [managed instance
-  // groups](/compute/docs/instance-groups/creating-groups-of-managed-instances)
+  // groups](https://cloud.google.com/compute/docs/instance-groups/creating-groups-of-managed-instances)
   // associated with this node pool.
   repeated string instance_group_urls = 102;
 
@@ -2115,7 +2397,7 @@ message NodePool {
 
   // [Output only] Additional information about the current status of this
   // node pool instance, if available.
-  string status_message = 104;
+  string status_message = 104 [deprecated = true];
 
   // Autoscaler configuration for this NodePool. Autoscaler is enabled
   // only if a valid configuration is present.
@@ -2130,6 +2412,9 @@ message NodePool {
 
   // Which conditions caused the current node pool state.
   repeated StatusCondition conditions = 105;
+
+  // [Output only] The pod CIDR block size per node in this node pool.
+  int32 pod_ipv4_cidr_size = 7;
 }
 
 // NodeManagement defines the set of node management services turned on for the
@@ -2162,6 +2447,13 @@ message AutoUpgradeOptions {
 message MaintenancePolicy {
   // Specifies the maintenance window in which maintenance may be performed.
   MaintenanceWindow window = 1;
+
+  // A hash identifying the version of this policy, so that updates to fields of
+  // the policy won't accidentally undo intermediate changes (and so that users
+  // of the API unaware of some fields won't accidentally remove other fields).
+  // Make a get() request to the cluster to get the current
+  // resource version and include it with requests to set the policy.
+  string resource_version = 3;
 }
 
 // MaintenanceWindow defines the maintenance window to be used for the cluster.
@@ -2171,13 +2463,67 @@ message MaintenanceWindow {
   oneof policy {
     // DailyMaintenanceWindow specifies a daily maintenance operation window.
     DailyMaintenanceWindow daily_maintenance_window = 2;
+
+    // RecurringWindow specifies some number of recurring time periods for
+    // maintenance to occur. The time windows may be overlapping. If no
+    // maintenance windows are set, maintenance can occur at any time.
+    RecurringTimeWindow recurring_window = 3;
   }
+
+  // Exceptions to maintenance window. Non-emergency maintenance should not
+  // occur in these windows.
+  map maintenance_exclusions = 4;
+}
+
+// Represents an arbitrary window of time.
+message TimeWindow {
+  // The time that the window first starts.
+  google.protobuf.Timestamp start_time = 1;
+
+  // The time that the window ends. The end time should take place after the
+  // start time.
+  google.protobuf.Timestamp end_time = 2;
+}
+
+// Represents an arbitrary window of time that recurs.
+message RecurringTimeWindow {
+  // The window of the first recurrence.
+  TimeWindow window = 1;
+
+  // An RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) for how
+  // this window reccurs. They go on for the span of time between the start and
+  // end time.
+  //
+  // For example, to have something repeat every weekday, you'd use:
+  //   FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR
+  // To repeat some window daily (equivalent to the DailyMaintenanceWindow):
+  //   FREQ=DAILY
+  // For the first weekend of every month:
+  //   FREQ=MONTHLY;BYSETPOS=1;BYDAY=SA,SU
+  // This specifies how frequently the window starts. Eg, if you wanted to have
+  // a 9-5 UTC-4 window every weekday, you'd use something like:
+  // 
+  //   start time = 2019-01-01T09:00:00-0400
+  //   end time = 2019-01-01T17:00:00-0400
+  //   recurrence = FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR
+  // 
+  // Windows can span multiple days. Eg, to make the window encompass every
+  // weekend from midnight Saturday till the last minute of Sunday UTC:
+  // 
+  //   start time = 2019-01-05T00:00:00Z
+  //   end time = 2019-01-07T23:59:00Z
+  //   recurrence = FREQ=WEEKLY;BYDAY=SA
+  // 
+  // Note the start and end time's specific dates are largely arbitrary except
+  // to specify duration of the window and when it first starts.
+  // The FREQ values of HOURLY, MINUTELY, and SECONDLY are not supported.
+  string recurrence = 2;
 }
 
 // Time window specified for daily maintenance operations.
 message DailyMaintenanceWindow {
   // Time within the maintenance window to start the maintenance operations.
-  // It must be in format "HH:MM”, where HH : [00-23] and MM : [00-59] GMT.
+  // It must be in format "HH:MM", where HH : [00-23] and MM : [00-59] GMT.
   string start_time = 2;
 
   // [Output only] Duration of the time window, automatically chosen to be
@@ -2188,62 +2534,86 @@ message DailyMaintenanceWindow {
 // SetNodePoolManagementRequest sets the node management properties of a node
 // pool.
 message SetNodePoolManagementRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://support.google.com/cloud/answer/6158840).
   // This field has been deprecated and replaced by the name field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the cluster to update.
+  // Required. Deprecated. The name of the cluster to update.
   // This field has been deprecated and replaced by the name field.
-  string cluster_id = 3 [deprecated = true];
+  string cluster_id = 3 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the node pool to update.
+  // Required. Deprecated. The name of the node pool to update.
   // This field has been deprecated and replaced by the name field.
-  string node_pool_id = 4 [deprecated = true];
+  string node_pool_id = 4 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // NodeManagement configuration for the node pool.
-  NodeManagement management = 5;
+  // Required. NodeManagement configuration for the node pool.
+  NodeManagement management = 5 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster, node pool id) of the node pool to set
   // management properties. Specified in the format
-  // 'projects/*/locations/*/clusters/*/nodePools/*'.
+  // `projects/*/locations/*/clusters/*/nodePools/*`.
   string name = 7;
 }
 
 // SetNodePoolSizeRequest sets the size a node
 // pool.
 message SetNodePoolSizeRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://support.google.com/cloud/answer/6158840).
   // This field has been deprecated and replaced by the name field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the cluster to update.
+  // Required. Deprecated. The name of the cluster to update.
   // This field has been deprecated and replaced by the name field.
-  string cluster_id = 3 [deprecated = true];
+  string cluster_id = 3 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the node pool to update.
+  // Required. Deprecated. The name of the node pool to update.
   // This field has been deprecated and replaced by the name field.
-  string node_pool_id = 4 [deprecated = true];
+  string node_pool_id = 4 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // The desired node count for the pool.
-  int32 node_count = 5;
+  // Required. The desired node count for the pool.
+  int32 node_count = 5 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster, node pool id) of the node pool to set
   // size.
-  // Specified in the format 'projects/*/locations/*/clusters/*/nodePools/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*/nodePools/*`.
   string name = 7;
 }
 
@@ -2251,28 +2621,40 @@ message SetNodePoolSizeRequest {
 // NodePool upgrade. This will be an no-op if the last upgrade successfully
 // completed.
 message RollbackNodePoolUpgradeRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://support.google.com/cloud/answer/6158840).
   // This field has been deprecated and replaced by the name field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the cluster to rollback.
+  // Required. Deprecated. The name of the cluster to rollback.
   // This field has been deprecated and replaced by the name field.
-  string cluster_id = 3 [deprecated = true];
+  string cluster_id = 3 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the node pool to rollback.
+  // Required. Deprecated. The name of the node pool to rollback.
   // This field has been deprecated and replaced by the name field.
-  string node_pool_id = 4 [deprecated = true];
+  string node_pool_id = 4 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
   // The name (project, location, cluster, node pool id) of the node poll to
   // rollback upgrade.
-  // Specified in the format 'projects/*/locations/*/clusters/*/nodePools/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*/nodePools/*`.
   string name = 6;
 }
 
@@ -2293,6 +2675,26 @@ message ClusterAutoscaling {
   // Contains global constraints regarding minimum and maximum
   // amount of resources in the cluster.
   repeated ResourceLimit resource_limits = 2;
+
+  // AutoprovisioningNodePoolDefaults contains defaults for a node pool
+  // created by NAP.
+  AutoprovisioningNodePoolDefaults autoprovisioning_node_pool_defaults = 4;
+
+  // The list of Google Compute Engine [zones](https://cloud.google.com/compute/docs/zones#available)
+  // in which the NodePool's nodes can be created by NAP.
+  repeated string autoprovisioning_locations = 5;
+}
+
+// AutoprovisioningNodePoolDefaults contains defaults for a node pool created
+// by NAP.
+message AutoprovisioningNodePoolDefaults {
+  // Scopes that are used by NAP when creating node pools. If oauth_scopes are
+  // specified, service_account should be empty.
+  repeated string oauth_scopes = 1;
+
+  // The Google Cloud Platform Service Account to be used by the node VMs. If
+  // service_account is specified, scopes should be empty.
+  string service_account = 2;
 }
 
 // Contains information about amount of some resource in the cluster.
@@ -2330,83 +2732,110 @@ message NodePoolAutoscaling {
 // Engine cluster, which will in turn set them for Google Compute Engine
 // resources used by that cluster
 message SetLabelsRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://developers.google.com/console/help/new/#projectnumber).
   // This field has been deprecated and replaced by the name field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the cluster.
+  // Required. Deprecated. The name of the cluster.
   // This field has been deprecated and replaced by the name field.
-  string cluster_id = 3 [deprecated = true];
+  string cluster_id = 3 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // The labels to set for that cluster.
-  map resource_labels = 4;
+  // Required. The labels to set for that cluster.
+  map resource_labels = 4 [(google.api.field_behavior) = REQUIRED];
 
-  // The fingerprint of the previous set of labels for this resource,
+  // Required. The fingerprint of the previous set of labels for this resource,
   // used to detect conflicts. The fingerprint is initially generated by
   // Kubernetes Engine and changes after every request to modify or update
   // labels. You must always provide an up-to-date fingerprint hash when
   // updating or changing labels. Make a get() request to the
   // resource to get the latest fingerprint.
-  string label_fingerprint = 5;
+  string label_fingerprint = 5 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster id) of the cluster to set labels.
-  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 7;
 }
 
 // SetLegacyAbacRequest enables or disables the ABAC authorization mechanism for
 // a cluster.
 message SetLegacyAbacRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://support.google.com/cloud/answer/6158840).
   // This field has been deprecated and replaced by the name field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the cluster to update.
+  // Required. Deprecated. The name of the cluster to update.
   // This field has been deprecated and replaced by the name field.
-  string cluster_id = 3 [deprecated = true];
+  string cluster_id = 3 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Whether ABAC authorization will be enabled in the cluster.
-  bool enabled = 4;
+  // Required. Whether ABAC authorization will be enabled in the cluster.
+  bool enabled = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster id) of the cluster to set legacy abac.
-  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 6;
 }
 
 // StartIPRotationRequest creates a new IP for the cluster and then performs
 // a node upgrade on each node pool to point to the new IP.
 message StartIPRotationRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://developers.google.com/console/help/new/#projectnumber).
   // This field has been deprecated and replaced by the name field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the cluster.
+  // Required. Deprecated. The name of the cluster.
   // This field has been deprecated and replaced by the name field.
-  string cluster_id = 3 [deprecated = true];
+  string cluster_id = 3 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
   // The name (project, location, cluster id) of the cluster to start IP
-  // rotation. Specified in the format 'projects/*/locations/*/clusters/*'.
+  // rotation. Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 6;
 
   // Whether to rotate credentials during IP rotation.
@@ -2415,23 +2844,32 @@ message StartIPRotationRequest {
 
 // CompleteIPRotationRequest moves the cluster master back into single-IP mode.
 message CompleteIPRotationRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://developers.google.com/console/help/new/#projectnumber).
   // This field has been deprecated and replaced by the name field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the cluster.
+  // Required. Deprecated. The name of the cluster.
   // This field has been deprecated and replaced by the name field.
-  string cluster_id = 3 [deprecated = true];
+  string cluster_id = 3 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
   // The name (project, location, cluster id) of the cluster to complete IP
-  // rotation. Specified in the format 'projects/*/locations/*/clusters/*'.
+  // rotation. Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 7;
 }
 
@@ -2441,7 +2879,7 @@ message AcceleratorConfig {
   int64 accelerator_count = 1;
 
   // The accelerator type resource name. List of supported accelerators
-  // [here](/compute/docs/gpus/#Introduction)
+  // [here](https://cloud.google.com/compute/docs/gpus)
   string accelerator_type = 2;
 }
 
@@ -2468,65 +2906,74 @@ message WorkloadMetadataConfig {
     EXPOSE = 2;
   }
 
-  // NodeMetadata is the configuration for how to expose the node metadata to
-  // the workload running on the node.
+  // NodeMetadata is the configuration for how to expose metadata to the
+  // workloads running on the node.
   NodeMetadata node_metadata = 1;
 }
 
 // SetNetworkPolicyRequest enables/disables network policy for a cluster.
 message SetNetworkPolicyRequest {
-  // Deprecated. The Google Developers Console [project ID or project
+  // Required. Deprecated. The Google Developers Console [project ID or project
   // number](https://developers.google.com/console/help/new/#projectnumber).
   // This field has been deprecated and replaced by the name field.
-  string project_id = 1 [deprecated = true];
+  string project_id = 1 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. Deprecated. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
   // This field has been deprecated and replaced by the name field.
-  string zone = 2 [deprecated = true];
+  string zone = 2 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Deprecated. The name of the cluster.
+  // Required. Deprecated. The name of the cluster.
   // This field has been deprecated and replaced by the name field.
-  string cluster_id = 3 [deprecated = true];
+  string cluster_id = 3 [
+    deprecated = true,
+    (google.api.field_behavior) = REQUIRED
+  ];
 
-  // Configuration options for the NetworkPolicy feature.
-  NetworkPolicy network_policy = 4;
+  // Required. Configuration options for the NetworkPolicy feature.
+  NetworkPolicy network_policy = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster id) of the cluster to set networking
-  // policy. Specified in the format 'projects/*/locations/*/clusters/*'.
+  // policy. Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 6;
 }
 
 // SetMaintenancePolicyRequest sets the maintenance policy for a cluster.
 message SetMaintenancePolicyRequest {
-  // The Google Developers Console [project ID or project
+  // Required. The Google Developers Console [project ID or project
   // number](https://support.google.com/cloud/answer/6158840).
-  string project_id = 1;
+  string project_id = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // The name of the Google Compute Engine
-  // [zone](/compute/docs/zones#available) in which the cluster
+  // Required. The name of the Google Compute Engine
+  // [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster
   // resides.
-  string zone = 2;
+  string zone = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // The name of the cluster to update.
-  string cluster_id = 3;
+  // Required. The name of the cluster to update.
+  string cluster_id = 3 [(google.api.field_behavior) = REQUIRED];
 
-  // The maintenance policy to be set for the cluster. An empty field
+  // Required. The maintenance policy to be set for the cluster. An empty field
   // clears the existing maintenance policy.
-  MaintenancePolicy maintenance_policy = 4;
+  MaintenancePolicy maintenance_policy = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The name (project, location, cluster id) of the cluster to set maintenance
   // policy.
-  // Specified in the format 'projects/*/locations/*/clusters/*'.
+  // Specified in the format `projects/*/locations/*/clusters/*`.
   string name = 5;
 }
 
 // ListLocationsRequest is used to request the locations that offer GKE.
 message ListLocationsRequest {
-  // Contains the name of the resource requested.
-  // Specified in the format 'projects/*'.
-  string parent = 1;
+  // Required. Contains the name of the resource requested.
+  // Specified in the format `projects/*`.
+  string parent = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
 // ListLocationsResponse returns the list of all GKE locations and their
@@ -2562,7 +3009,7 @@ message Location {
   LocationType type = 1;
 
   // Contains the name of the resource requested.
-  // Specified in the format 'projects/*/locations/*'.
+  // Specified in the format `projects/*/locations/*`.
   string name = 2;
 
   // Whether the location is recomended for GKE cluster scheduling.
@@ -2588,8 +3035,12 @@ message StatusCondition {
     GCE_QUOTA_EXCEEDED = 3;
 
     // Cluster state was manually changed by an SRE due to a system logic error.
-    // More codes TBA
     SET_BY_OPERATOR = 4;
+
+    // Unable to perform an encrypt operation against the CloudKMS key used for
+    // etcd level encryption.
+    // More codes TBA
+    CLOUD_KMS_KEY_ERROR = 7;
   }
 
   // Machine-friendly representation of the condition
@@ -2602,23 +3053,27 @@ message StatusCondition {
 // NetworkConfig reports the relative names of network & subnetwork.
 message NetworkConfig {
   // Output only. The relative name of the Google Compute Engine
-  // [network][google.container.v1beta1.NetworkConfig.network](/compute/docs/networks-and-firewalls#networks) to which
+  // [network][google.container.v1beta1.NetworkConfig.network](https://cloud.google.com/compute/docs/networks-and-firewalls#networks) to which
   // the cluster is connected.
   // Example: projects/my-project/global/networks/my-network
   string network = 1;
 
   // Output only. The relative name of the Google Compute Engine
-  // [subnetwork](/compute/docs/vpc) to which the cluster is connected.
+  // [subnetwork](https://cloud.google.com/compute/docs/vpc) to which the cluster is connected.
   // Example: projects/my-project/regions/us-central1/subnetworks/my-subnet
   string subnetwork = 2;
+
+  // Whether Intra-node visibility is enabled for this cluster.
+  // This makes same node pod to pod traffic visible for VPC network.
+  bool enable_intra_node_visibility = 5;
 }
 
 // ListUsableSubnetworksRequest requests the list of usable subnetworks.
 // available to a user for creating clusters.
 message ListUsableSubnetworksRequest {
-  // The parent project where subnetworks are usable.
-  // Specified in the format 'projects/*'.
-  string parent = 1;
+  // Required. The parent project where subnetworks are usable.
+  // Specified in the format `projects/*`.
+  string parent = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Filtering currently only supports equality on the networkProjectId and must
   // be in the form: "networkProjectId=[PROJECTID]", where `networkProjectId`
@@ -2717,12 +3172,42 @@ message VerticalPodAutoscaling {
   bool enabled = 1;
 }
 
+// IntraNodeVisibilityConfig contains the desired config of the intra-node
+// visibility on this cluster.
+message IntraNodeVisibilityConfig {
+  // Enables intra node visibility for this cluster.
+  bool enabled = 1;
+}
+
 // Constraints applied to pods.
 message MaxPodsConstraint {
   // Constraint enforced on the max num of pods per node.
   int64 max_pods_per_node = 1;
 }
 
+// Configuration of etcd encryption.
+message DatabaseEncryption {
+  // State of etcd encryption.
+  enum State {
+    // Should never be set
+    UNKNOWN = 0;
+
+    // Secrets in etcd are encrypted.
+    ENCRYPTED = 1;
+
+    // Secrets in etcd are stored in plain text (at etcd level) - this is
+    // unrelated to Google Compute Engine level full disk encryption.
+    DECRYPTED = 2;
+  }
+
+  // Denotes the state of etcd encryption.
+  State state = 2;
+
+  // Name of CloudKMS key to use for the encryption of secrets in etcd.
+  // Ex. projects/my-project/locations/global/keyRings/my-ring/cryptoKeys/my-key
+  string key_name = 1;
+}
+
 // Configuration for exporting cluster resource usages.
 message ResourceUsageExportConfig {
   // Parameters for using BigQuery as the destination of resource usage export.
@@ -2731,10 +3216,21 @@ message ResourceUsageExportConfig {
     string dataset_id = 1;
   }
 
+  // Parameters for controlling consumption metering.
+  message ConsumptionMeteringConfig {
+    // Whether to enable consumption metering for this cluster. If enabled, a
+    // second BigQuery table will be created to hold resource consumption
+    // records.
+    bool enabled = 1;
+  }
+
   // Configuration to use BigQuery as usage export destination.
   BigQueryDestination bigquery_destination = 1;
 
   // Whether to enable network egress metering for this cluster. If enabled, a
   // daemonset will be created in the cluster to meter network egress traffic.
   bool enable_network_egress_metering = 2;
+
+  // Configuration to enable resource consumption metering.
+  ConsumptionMeteringConfig consumption_metering_config = 3;
 }
diff --git a/third_party/googleapis/google/container/v1beta1/container_gapic.legacy.yaml b/third_party/googleapis/google/container/v1beta1/container_gapic.legacy.yaml
new file mode 100644
index 000000000..f3e63dd0a
--- /dev/null
+++ b/third_party/googleapis/google/container/v1beta1/container_gapic.legacy.yaml
@@ -0,0 +1,551 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.container.v1beta1
+  python:
+    package_name: google.cloud.container_v1beta1.gapic
+  go:
+    package_name: cloud.google.com/go/container/apiv1beta1
+  csharp:
+    package_name: Google.Cloud.Container.V1beta1
+  ruby:
+    package_name: Google::Cloud::Container::V1beta1
+    release_level: BETA
+  php:
+    package_name: Google\Cloud\Container\V1beta1
+  nodejs:
+    package_name: container.v1beta1
+    domain_layer_location: google-cloud
+# A list of API interface configurations.
+interfaces:
+- name: google.container.v1beta1.ClusterManager
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections: []
+  # Definition for smoke test
+  smoke_test:
+    method: ListClusters
+    init_fields:
+    - project_id=$PROJECT_ID
+    - zone="us-central1-a"
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #   name - The simple name of the method.
+  #   flattening - Specifies the configuration for parameter flattening.
+  #       Describes the parameter groups for which a generator should produce
+  #       method overloads which allow a client to directly pass request message
+  #       fields as method parameters. This information may or may not be used,
+  #       depending on the target language.
+  #       Consists of groups, which each represent a list of parameters to be
+  #       flattened. Each parameter listed must be a field of the request
+  #       message.
+  #   required_fields - Fields that are always required for a request to be
+  #       valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the
+  #       resource name formats defined in the field_name_patterns
+  #       and response_field_name_patterns fields.
+  #       UNSET: default value
+  #       NONE: the collection configs will not be used by the generated code.
+  #       VALIDATE: string fields will be validated by the client against the
+  #           specified resource name formats.
+  #       STATIC_TYPES: the client will use generated types for resource names.
+  #   page_streaming - Specifies the configuration for paging.
+  #       Describes information for generating a method which transforms a
+  #       paging list RPC into a stream of resources.
+  #       Consists of a request and a response.
+  #       The request specifies request information of the list method. It
+  #       defines which fields match the paging pattern in the request. The
+  #       request consists of a page_size_field and a token_field. The
+  #       page_size_field is the name of the optional field specifying the
+  #       maximum number of elements to be returned in the response. The
+  #       token_field is the name of the field in the request containing the
+  #       page token.
+  #       The response specifies response information of the list method. It
+  #       defines which fields match the paging pattern in the response. The
+  #       response consists of a token_field and a resources_field. The
+  #       token_field is the name of the field in the response containing the
+  #       next page token. The resources_field is the name of the field in the
+  #       response containing the list of resources belonging to the page.
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #       name must be defined in interfaces.retry_codes_def.
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #       parameters. The name must be defined in interfaces.retry_params_def.
+  #   field_name_patterns - Maps the field name of the request type to
+  #       entity_name of interfaces.collections.
+  #       Specifies the string pattern that the field must follow.
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #       the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ListClusters
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+    required_fields:
+    - project_id
+    - zone
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: GetCluster
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: CreateCluster
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster
+    required_fields:
+    - project_id
+    - zone
+    - cluster
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: UpdateCluster
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - update
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - update
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: UpdateNodePool
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - node_pool_id
+    - node_version
+    - image_type
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: SetNodePoolAutoscaling
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - node_pool_id
+    - autoscaling
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: SetLoggingService
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - logging_service
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - logging_service
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: SetMonitoringService
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - monitoring_service
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - monitoring_service
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: SetAddonsConfig
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - addons_config
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - addons_config
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: SetLocations
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - locations
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - locations
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: UpdateMaster
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - master_version
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - master_version
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: SetMasterAuth
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - action
+    - update
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: DeleteCluster
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: ListOperations
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+    required_fields:
+    - project_id
+    - zone
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: GetOperation
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - operation_id
+    required_fields:
+    - project_id
+    - zone
+    - operation_id
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: CancelOperation
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - operation_id
+    required_fields:
+    - project_id
+    - zone
+    - operation_id
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: GetServerConfig
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+    required_fields:
+    - project_id
+    - zone
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: ListNodePools
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: GetNodePool
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - node_pool_id
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - node_pool_id
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: CreateNodePool
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - node_pool
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - node_pool
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: DeleteNodePool
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - node_pool_id
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - node_pool_id
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: RollbackNodePoolUpgrade
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - node_pool_id
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - node_pool_id
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: SetNodePoolManagement
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - node_pool_id
+    - management
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: SetLabels
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - resource_labels
+    - label_fingerprint
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: SetLegacyAbac
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - enabled
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - enabled
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: StartIPRotation
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: CompleteIPRotation
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: SetNodePoolSize
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - node_pool_id
+    - node_count
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: SetNetworkPolicy
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - network_policy
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - network_policy
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: SetMaintenancePolicy
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - zone
+        - cluster_id
+        - maintenance_policy
+    required_fields:
+    - project_id
+    - zone
+    - cluster_id
+    - maintenance_policy
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: ListUsableSubnetworks
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: subnetworks
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 20000
+  - name: ListLocations
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 20000
diff --git a/third_party/googleapis/google/container/v1beta1/container_gapic.yaml b/third_party/googleapis/google/container/v1beta1/container_gapic.yaml
index 20dcd1511..725f78bcb 100644
--- a/third_party/googleapis/google/container/v1beta1/container_gapic.yaml
+++ b/third_party/googleapis/google/container/v1beta1/container_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -20,533 +20,9 @@ language_settings:
     domain_layer_location: google-cloud
 # A list of API interface configurations.
 interfaces:
-  # The fully qualified name of the API interface.
 - name: google.container.v1beta1.ClusterManager
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections: []
-  # Definition for smoke test
   smoke_test:
     method: ListClusters
     init_fields:
     - project_id=$PROJECT_ID
     - zone="us-central1-a"
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #   name - The simple name of the method.
-  #   flattening - Specifies the configuration for parameter flattening.
-  #       Describes the parameter groups for which a generator should produce
-  #       method overloads which allow a client to directly pass request message
-  #       fields as method parameters. This information may or may not be used,
-  #       depending on the target language.
-  #       Consists of groups, which each represent a list of parameters to be
-  #       flattened. Each parameter listed must be a field of the request
-  #       message.
-  #   required_fields - Fields that are always required for a request to be
-  #       valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the
-  #       resource name formats defined in the field_name_patterns
-  #       and response_field_name_patterns fields.
-  #       UNSET: default value
-  #       NONE: the collection configs will not be used by the generated code.
-  #       VALIDATE: string fields will be validated by the client against the
-  #           specified resource name formats.
-  #       STATIC_TYPES: the client will use generated types for resource names.
-  #   page_streaming - Specifies the configuration for paging.
-  #       Describes information for generating a method which transforms a
-  #       paging list RPC into a stream of resources.
-  #       Consists of a request and a response.
-  #       The request specifies request information of the list method. It
-  #       defines which fields match the paging pattern in the request. The
-  #       request consists of a page_size_field and a token_field. The
-  #       page_size_field is the name of the optional field specifying the
-  #       maximum number of elements to be returned in the response. The
-  #       token_field is the name of the field in the request containing the
-  #       page token.
-  #       The response specifies response information of the list method. It
-  #       defines which fields match the paging pattern in the response. The
-  #       response consists of a token_field and a resources_field. The
-  #       token_field is the name of the field in the response containing the
-  #       next page token. The resources_field is the name of the field in the
-  #       response containing the list of resources belonging to the page.
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #       name must be defined in interfaces.retry_codes_def.
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #       parameters. The name must be defined in interfaces.retry_params_def.
-  #   field_name_patterns - Maps the field name of the request type to
-  #       entity_name of interfaces.collections.
-  #       Specifies the string pattern that the field must follow.
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #       the call is retrying, refer to retry_params_name instead.
-  methods:
-  - name: ListClusters
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-    required_fields:
-    - project_id
-    - zone
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: GetCluster
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: CreateCluster
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster
-    required_fields:
-    - project_id
-    - zone
-    - cluster
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: UpdateCluster
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - update
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - update
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: UpdateNodePool
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - node_pool_id
-    - node_version
-    - image_type
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: SetNodePoolAutoscaling
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - node_pool_id
-    - autoscaling
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: SetLoggingService
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - logging_service
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - logging_service
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: SetMonitoringService
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - monitoring_service
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - monitoring_service
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: SetAddonsConfig
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - addons_config
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - addons_config
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: SetLocations
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - locations
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - locations
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: UpdateMaster
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - master_version
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - master_version
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: SetMasterAuth
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - action
-    - update
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: DeleteCluster
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: ListOperations
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-    required_fields:
-    - project_id
-    - zone
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: GetOperation
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - operation_id
-    required_fields:
-    - project_id
-    - zone
-    - operation_id
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: CancelOperation
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - operation_id
-    required_fields:
-    - project_id
-    - zone
-    - operation_id
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: GetServerConfig
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-    required_fields:
-    - project_id
-    - zone
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: ListNodePools
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: GetNodePool
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - node_pool_id
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - node_pool_id
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: CreateNodePool
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - node_pool
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - node_pool
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: DeleteNodePool
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - node_pool_id
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - node_pool_id
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: RollbackNodePoolUpgrade
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - node_pool_id
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - node_pool_id
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: SetNodePoolManagement
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - node_pool_id
-    - management
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: SetLabels
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - resource_labels
-    - label_fingerprint
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: SetLegacyAbac
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - enabled
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - enabled
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: StartIPRotation
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: CompleteIPRotation
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: SetNodePoolSize
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - node_pool_id
-    - node_count
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: SetNetworkPolicy
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - network_policy
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - network_policy
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: SetMaintenancePolicy
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - zone
-        - cluster_id
-        - maintenance_policy
-    required_fields:
-    - project_id
-    - zone
-    - cluster_id
-    - maintenance_policy
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: ListUsableSubnetworks
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: subnetworks
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 20000
-  - name: ListLocations
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 20000
diff --git a/third_party/googleapis/google/container/v1beta1/container_grpc_service_config.json b/third_party/googleapis/google/container/v1beta1/container_grpc_service_config.json
new file mode 100755
index 000000000..38dbefdb0
--- /dev/null
+++ b/third_party/googleapis/google/container/v1beta1/container_grpc_service_config.json
@@ -0,0 +1,152 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "ListClusters"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "GetCluster"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "DeleteCluster"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "ListOperations"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "GetOperation"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "GetServerConfig"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "ListNodePools"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "GetNodePool"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "DeleteNodePool"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "ListUsableSubnetworks"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "ListLocations"
+        }
+      ],
+      "timeout": "20s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "CreateCluster"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "UpdateCluster"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "UpdateNodePool"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "SetNodePoolAutoscaling"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "SetLoggingService"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "SetMonitoringService"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "SetAddonsConfig"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "SetLocations"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "UpdateMaster"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "SetMasterAuth"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "CancelOperation"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "CreateNodePool"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "RollbackNodePoolUpgrade"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "SetNodePoolManagement"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "SetLabels"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "SetLegacyAbac"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "StartIPRotation"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "CompleteIPRotation"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "SetNodePoolSize"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "SetNetworkPolicy"
+        },
+        {
+          "service": "google.container.v1beta1.ClusterManager",
+          "method": "SetMaintenancePolicy"
+        }
+      ],
+      "timeout": "45s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/container/v1beta1/container_v1beta1.yaml b/third_party/googleapis/google/container/v1beta1/container_v1beta1.yaml
new file mode 100644
index 000000000..ca2ecfa05
--- /dev/null
+++ b/third_party/googleapis/google/container/v1beta1/container_v1beta1.yaml
@@ -0,0 +1,24 @@
+type: google.api.Service
+config_version: 3
+name: container.googleapis.com
+title: Kubernetes Engine API
+
+apis:
+- name: google.container.v1beta1.ClusterManager
+
+documentation:
+  summary: |-
+    Builds and manages container-based applications, powered by the open source
+    Kubernetes technology.
+
+backend:
+  rules:
+  - selector: 'google.container.v1beta1.ClusterManager.*'
+    deadline: 20.0
+
+authentication:
+  rules:
+  - selector: 'google.container.v1beta1.ClusterManager.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/datastore/BUILD.bazel b/third_party/googleapis/google/datastore/BUILD.bazel
index 1e5b8c2af..a87c57fec 100644
--- a/third_party/googleapis/google/datastore/BUILD.bazel
+++ b/third_party/googleapis/google/datastore/BUILD.bazel
@@ -1 +1 @@
-exports_files(glob(["*.yaml"]))
\ No newline at end of file
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/datastore/admin/BUILD.bazel b/third_party/googleapis/google/datastore/admin/BUILD.bazel
new file mode 100644
index 000000000..a87c57fec
--- /dev/null
+++ b/third_party/googleapis/google/datastore/admin/BUILD.bazel
@@ -0,0 +1 @@
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/datastore/admin/artman_datastore_admin.yaml b/third_party/googleapis/google/datastore/admin/artman_datastore_admin.yaml
index 78048169a..c0a4c9e5f 100644
--- a/third_party/googleapis/google/datastore/admin/artman_datastore_admin.yaml
+++ b/third_party/googleapis/google/datastore/admin/artman_datastore_admin.yaml
@@ -3,11 +3,12 @@ common:
   api_version: v1
   organization_name: google-cloud
   proto_deps:
-    - name: google-common-protos
+  - name: google-common-protos
   src_proto_paths:
   - v1
-  service_yaml: datastore_admin.yaml
+  service_yaml: v1/datastore_admin_v1.yaml
   gapic_yaml: v1/datastore_admin_gapic.yaml
+  proto_package: google.datastore.admin.v1
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/datastore/admin/v1/BUILD.bazel b/third_party/googleapis/google/datastore/admin/v1/BUILD.bazel
new file mode 100644
index 000000000..9f001d168
--- /dev/null
+++ b/third_party/googleapis/google/datastore/admin/v1/BUILD.bazel
@@ -0,0 +1,364 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "admin_proto",
+    srcs = [
+        "datastore_admin.proto",
+        "index.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "admin_proto_with_info",
+    deps = [
+        ":admin_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "admin_java_proto",
+    deps = [":admin_proto"],
+)
+
+java_grpc_library(
+    name = "admin_java_grpc",
+    srcs = [":admin_proto"],
+    deps = [":admin_java_proto"],
+)
+
+java_gapic_library(
+    name = "admin_java_gapic",
+    src = ":admin_proto_with_info",
+    gapic_yaml = "datastore_admin_gapic.yaml",
+    package = "google.datastore.admin.v1",
+    service_yaml = "datastore_admin_v1.yaml",
+    test_deps = [
+        ":admin_java_grpc",
+    ],
+    deps = [
+        ":admin_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "admin_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.datastore.admin.v1.DatastoreAdminClientTest",
+    ],
+    runtime_deps = [":admin_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-datastore-admin-v1-java",
+    deps = [
+        ":admin_java_gapic",
+        ":admin_java_grpc",
+        ":admin_java_proto",
+        ":admin_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "admin_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/datastore/admin/v1",
+    protos = [":admin_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/longrunning:longrunning_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "admin_go_gapic",
+    srcs = [":admin_proto_with_info"],
+    grpc_service_config = "datastore_admin_grpc_service_config.json",
+    importpath = "cloud.google.com/go/datastore/admin/apiv1;admin",
+    service_yaml = "datastore_admin_v1.yaml",
+    deps = [
+        ":admin_go_proto",
+        "//google/longrunning:longrunning_go_gapic",
+        "//google/longrunning:longrunning_go_proto",
+        "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
+    ],
+)
+
+go_test(
+    name = "admin_go_gapic_test",
+    srcs = [":admin_go_gapic_srcjar_test"],
+    embed = [":admin_go_gapic"],
+    importpath = "cloud.google.com/go/datastore/admin/apiv1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-datastore-admin-v1-go",
+    deps = [
+        ":admin_go_gapic",
+        ":admin_go_gapic_srcjar-test.srcjar",
+        ":admin_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "admin_moved_proto",
+    srcs = [":admin_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "admin_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":admin_moved_proto"],
+)
+
+py_grpc_library(
+    name = "admin_py_grpc",
+    srcs = [":admin_moved_proto"],
+    deps = [":admin_py_proto"],
+)
+
+py_gapic_library(
+    name = "admin_py_gapic",
+    src = ":admin_proto_with_info",
+    gapic_yaml = "datastore_admin_gapic.yaml",
+    package = "google.datastore.admin.v1",
+    service_yaml = "datastore_admin_v1.yaml",
+    deps = [
+        ":admin_py_grpc",
+        ":admin_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "datastore-admin-v1-py",
+    deps = [
+        ":admin_py_gapic",
+        ":admin_py_grpc",
+        ":admin_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "admin_php_proto",
+    deps = [":admin_proto"],
+)
+
+php_grpc_library(
+    name = "admin_php_grpc",
+    srcs = [":admin_proto"],
+    deps = [":admin_php_proto"],
+)
+
+php_gapic_library(
+    name = "admin_php_gapic",
+    src = ":admin_proto_with_info",
+    gapic_yaml = "datastore_admin_gapic.yaml",
+    package = "google.datastore.admin.v1",
+    service_yaml = "datastore_admin_v1.yaml",
+    deps = [
+        ":admin_php_grpc",
+        ":admin_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-datastore-admin-v1-php",
+    deps = [
+        ":admin_php_gapic",
+        ":admin_php_grpc",
+        ":admin_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "admin_nodejs_gapic",
+    src = ":admin_proto_with_info",
+    gapic_yaml = "datastore_admin_gapic.yaml",
+    package = "google.datastore.admin.v1",
+    service_yaml = "datastore_admin_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "datastore-admin-v1-nodejs",
+    deps = [
+        ":admin_nodejs_gapic",
+        ":admin_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "admin_ruby_proto",
+    deps = [":admin_proto"],
+)
+
+ruby_grpc_library(
+    name = "admin_ruby_grpc",
+    srcs = [":admin_proto"],
+    deps = [":admin_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "admin_ruby_gapic",
+    src = ":admin_proto_with_info",
+    gapic_yaml = "datastore_admin_gapic.yaml",
+    package = "google.datastore.admin.v1",
+    service_yaml = "datastore_admin_v1.yaml",
+    deps = [
+        ":admin_ruby_grpc",
+        ":admin_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-datastore-admin-v1-ruby",
+    deps = [
+        ":admin_ruby_gapic",
+        ":admin_ruby_grpc",
+        ":admin_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "admin_csharp_proto",
+    deps = [":admin_proto"],
+)
+
+csharp_grpc_library(
+    name = "admin_csharp_grpc",
+    srcs = [":admin_proto"],
+    deps = [":admin_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "admin_csharp_gapic",
+    src = ":admin_proto_with_info",
+    gapic_yaml = "datastore_admin_gapic.yaml",
+    package = "google.datastore.admin.v1",
+    service_yaml = "datastore_admin_v1.yaml",
+    deps = [
+        ":admin_csharp_grpc",
+        ":admin_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-datastore-admin-v1-csharp",
+    deps = [
+        ":admin_csharp_gapic",
+        ":admin_csharp_grpc",
+        ":admin_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/datastore/admin/v1/datastore_admin.proto b/third_party/googleapis/google/datastore/admin/v1/datastore_admin.proto
index ffcdc00fb..849b1453d 100644
--- a/third_party/googleapis/google/datastore/admin/v1/datastore_admin.proto
+++ b/third_party/googleapis/google/datastore/admin/v1/datastore_admin.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -17,6 +17,8 @@ syntax = "proto3";
 package google.datastore.admin.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/datastore/admin/v1/index.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/timestamp.proto";
@@ -29,6 +31,7 @@ option java_package = "com.google.datastore.admin.v1";
 
 // Google Cloud Datastore Admin API
 //
+//
 // The Datastore Admin API provides several admin services for Cloud Datastore.
 //
 // -----------------------------------------------------------------------------
@@ -88,6 +91,11 @@ option java_package = "com.google.datastore.admin.v1";
 // Operations are created by service DatastoreAdmin,
 // but are accessed via service google.longrunning.Operations.
 service DatastoreAdmin {
+  option (google.api.default_host) = "datastore.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/datastore";
+
   // Exports a copy of all or a subset of entities from Google Cloud Datastore
   // to another storage system, such as Google Cloud Storage. Recent updates to
   // entities may not be reflected in the export. The export occurs in the
@@ -96,12 +104,16 @@ service DatastoreAdmin {
   // used once the associated operation is done. If an export operation is
   // cancelled before completion it may leave partial data behind in Google
   // Cloud Storage.
-  rpc ExportEntities(ExportEntitiesRequest)
-      returns (google.longrunning.Operation) {
+  rpc ExportEntities(ExportEntitiesRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v1/projects/{project_id}:export"
       body: "*"
     };
+    option (google.api.method_signature) = "project_id,labels,entity_filter,output_url_prefix";
+    option (google.longrunning.operation_info) = {
+      response_type: "ExportEntitiesResponse"
+      metadata_type: "ExportEntitiesMetadata"
+    };
   }
 
   // Imports entities into Google Cloud Datastore. Existing entities with the
@@ -109,12 +121,16 @@ service DatastoreAdmin {
   // progress can be monitored and managed via the Operation resource that is
   // created. If an ImportEntities operation is cancelled, it is possible
   // that a subset of the data has already been imported to Cloud Datastore.
-  rpc ImportEntities(ImportEntitiesRequest)
-      returns (google.longrunning.Operation) {
+  rpc ImportEntities(ImportEntitiesRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v1/projects/{project_id}:import"
       body: "*"
     };
+    option (google.api.method_signature) = "project_id,labels,input_url,entity_filter";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.protobuf.Empty"
+      metadata_type: "ImportEntitiesMetadata"
+    };
   }
 
   // Gets an index.
@@ -183,6 +199,24 @@ message CommonMetadata {
   State state = 5;
 }
 
+// Operation types.
+enum OperationType {
+  // Unspecified.
+  OPERATION_TYPE_UNSPECIFIED = 0;
+
+  // ExportEntities.
+  EXPORT_ENTITIES = 1;
+
+  // ImportEntities.
+  IMPORT_ENTITIES = 2;
+
+  // CreateIndex.
+  CREATE_INDEX = 3;
+
+  // DeleteIndex.
+  DELETE_INDEX = 4;
+}
+
 // Measures the progress of a particular metric.
 message Progress {
   // The amount of work that has been completed. Note that this may be greater
@@ -197,8 +231,8 @@ message Progress {
 // The request for
 // [google.datastore.admin.v1.DatastoreAdmin.ExportEntities][google.datastore.admin.v1.DatastoreAdmin.ExportEntities].
 message ExportEntitiesRequest {
-  // Project ID against which to make the request.
-  string project_id = 1;
+  // Required. Project ID against which to make the request.
+  string project_id = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Client-assigned labels.
   map labels = 2;
@@ -206,7 +240,7 @@ message ExportEntitiesRequest {
   // Description of what data from the project is included in the export.
   EntityFilter entity_filter = 3;
 
-  // Location for the export metadata and data files.
+  // Required. Location for the export metadata and data files.
   //
   // The full resource URL of the external storage location. Currently, only
   // Google Cloud Storage is supported. So output_url_prefix should be of the
@@ -219,24 +253,24 @@ message ExportEntitiesRequest {
   //
   // The resulting files will be nested deeper than the specified URL prefix.
   // The final output URL will be provided in the
-  // [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url]
-  // field. That value should be used for subsequent ImportEntities operations.
+  // [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field. That
+  // value should be used for subsequent ImportEntities operations.
   //
   // By nesting the data files deeper, the same Cloud Storage bucket can be used
   // in multiple ExportEntities operations without conflict.
-  string output_url_prefix = 4;
+  string output_url_prefix = 4 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The request for
 // [google.datastore.admin.v1.DatastoreAdmin.ImportEntities][google.datastore.admin.v1.DatastoreAdmin.ImportEntities].
 message ImportEntitiesRequest {
-  // Project ID against which to make the request.
-  string project_id = 1;
+  // Required. Project ID against which to make the request.
+  string project_id = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Client-assigned labels.
   map labels = 2;
 
-  // The full resource URL of the external storage location. Currently, only
+  // Required. The full resource URL of the external storage location. Currently, only
   // Google Cloud Storage is supported. So input_url should be of the form:
   // `gs://BUCKET_NAME[/NAMESPACE_PATH]/OVERALL_EXPORT_METADATA_FILE`, where
   // `BUCKET_NAME` is the name of the Cloud Storage bucket, `NAMESPACE_PATH` is
@@ -249,7 +283,7 @@ message ImportEntitiesRequest {
   //
   // For more information, see
   // [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url].
-  string input_url = 3;
+  string input_url = 3 [(google.api.field_behavior) = REQUIRED];
 
   // Optionally specify which kinds/namespaces are to be imported. If provided,
   // the list must be a subset of the EntityFilter used in creating the export,
@@ -305,9 +339,7 @@ message ImportEntitiesMetadata {
   EntityFilter entity_filter = 4;
 
   // The location of the import metadata file. This will be the same value as
-  // the
-  // [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url]
-  // field.
+  // the [google.datastore.admin.v1.ExportEntitiesResponse.output_url][google.datastore.admin.v1.ExportEntitiesResponse.output_url] field.
   string input_url = 5;
 }
 
@@ -344,8 +376,7 @@ message EntityFilter {
   repeated string namespace_ids = 2;
 }
 
-// The request for
-// [google.datastore.admin.v1.DatastoreAdmin.GetIndex][google.datastore.admin.v1.DatastoreAdmin.GetIndex].
+// The request for [google.datastore.admin.v1.DatastoreAdmin.GetIndex][google.datastore.admin.v1.DatastoreAdmin.GetIndex].
 message GetIndexRequest {
   // Project ID against which to make the request.
   string project_id = 1;
@@ -391,21 +422,3 @@ message IndexOperationMetadata {
   // The index resource ID that this operation is acting on.
   string index_id = 3;
 }
-
-// Operation types.
-enum OperationType {
-  // Unspecified.
-  OPERATION_TYPE_UNSPECIFIED = 0;
-
-  // ExportEntities.
-  EXPORT_ENTITIES = 1;
-
-  // ImportEntities.
-  IMPORT_ENTITIES = 2;
-
-  // CreateIndex.
-  CREATE_INDEX = 3;
-
-  // DeleteIndex.
-  DELETE_INDEX = 4;
-}
diff --git a/third_party/googleapis/google/datastore/admin/v1/datastore_admin_gapic.legacy.yaml b/third_party/googleapis/google/datastore/admin/v1/datastore_admin_gapic.legacy.yaml
new file mode 100644
index 000000000..b56eeb0ad
--- /dev/null
+++ b/third_party/googleapis/google/datastore/admin/v1/datastore_admin_gapic.legacy.yaml
@@ -0,0 +1,133 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.datastore.admin.v1
+  python:
+    package_name: google.cloud.datastore.admin_v1.gapic
+  go:
+    package_name: cloud.google.com/go/datastore/admin/apiv1
+  csharp:
+    package_name: Google.Datastore.Admin.V1
+  ruby:
+    package_name: Google::Cloud::Datastore::Admin::V1
+  php:
+    package_name: Google\Cloud\Datastore\Admin\V1
+  nodejs:
+    package_name: admin.v1
+# A list of API interface configurations.
+interfaces:
+- name: google.datastore.admin.v1.DatastoreAdmin
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections: []
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ExportEntities
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - labels
+        - entity_filter
+        - output_url_prefix
+    required_fields:
+    - project_id
+    - output_url_prefix
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 295000
+  - name: ImportEntities
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - labels
+        - input_url
+        - entity_filter
+    required_fields:
+    - project_id
+    - input_url
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 295000
diff --git a/third_party/googleapis/google/datastore/admin/v1/datastore_admin_gapic.yaml b/third_party/googleapis/google/datastore/admin/v1/datastore_admin_gapic.yaml
index 9d3ad8f88..4febad26a 100644
--- a/third_party/googleapis/google/datastore/admin/v1/datastore_admin_gapic.yaml
+++ b/third_party/googleapis/google/datastore/admin/v1/datastore_admin_gapic.yaml
@@ -1,11 +1,11 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
     package_name: com.google.cloud.datastore.admin.v1
   python:
-    package_name: google.cloud.datastore.admin_v1.gapic
+    package_name: google.cloud.datastore_admin_v1.gapic
   go:
     package_name: cloud.google.com/go/datastore/admin/apiv1
   csharp:
@@ -16,119 +16,3 @@ language_settings:
     package_name: Google\Cloud\Datastore\Admin\V1
   nodejs:
     package_name: admin.v1
-# A list of API interface configurations.
-interfaces:
-  # The fully qualified name of the API interface.
-- name: google.datastore.admin.v1.DatastoreAdmin
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections: []
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
-  methods:
-  - name: ExportEntities
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - labels
-        - entity_filter
-        - output_url_prefix
-    required_fields:
-    - project_id
-    - output_url_prefix
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 295000
-  - name: ImportEntities
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - labels
-        - input_url
-        - entity_filter
-    required_fields:
-    - project_id
-    - input_url
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 295000
diff --git a/third_party/googleapis/google/datastore/admin/v1/datastore_admin_grpc_service_config.json b/third_party/googleapis/google/datastore/admin/v1/datastore_admin_grpc_service_config.json
new file mode 100755
index 000000000..af05db143
--- /dev/null
+++ b/third_party/googleapis/google/datastore/admin/v1/datastore_admin_grpc_service_config.json
@@ -0,0 +1,48 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.datastore.admin.v1.DatastoreAdmin",
+          "method": "ExportEntities"
+        },
+        {
+          "service": "google.datastore.admin.v1.DatastoreAdmin",
+          "method": "ImportEntities"
+        },
+        {
+          "service": "google.datastore.admin.v1.DatastoreAdmin",
+          "method": "CreateIndex"
+        },
+        {
+          "service": "google.datastore.admin.v1.DatastoreAdmin",
+          "method": "DeleteIndex"
+        }
+      ],
+      "timeout": "60s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.datastore.admin.v1.DatastoreAdmin",
+          "method": "GetIndex"
+        },
+        {
+          "service": "google.datastore.admin.v1.DatastoreAdmin",
+          "method": "ListIndexes"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/datastore/admin/datastore_admin.yaml b/third_party/googleapis/google/datastore/admin/v1/datastore_admin_v1.yaml
similarity index 71%
rename from third_party/googleapis/google/datastore/admin/datastore_admin.yaml
rename to third_party/googleapis/google/datastore/admin/v1/datastore_admin_v1.yaml
index 112229c5d..836385ebd 100644
--- a/third_party/googleapis/google/datastore/admin/datastore_admin.yaml
+++ b/third_party/googleapis/google/datastore/admin/v1/datastore_admin_v1.yaml
@@ -1,7 +1,7 @@
 type: google.api.Service
 config_version: 3
 name: datastore.googleapis.com
-title: Google Cloud Datastore Admin API
+title: Cloud Datastore API
 
 apis:
 - name: google.datastore.admin.v1.DatastoreAdmin
@@ -17,23 +17,32 @@ documentation:
     Accesses the schemaless NoSQL database to provide fully managed, robust,
     scalable storage for your application.
 
-http:
+backend:
   rules:
-  - selector: google.longrunning.Operations.ListOperations
-    get: '/v1/{name=projects/*}/operations'
-
-  - selector: google.longrunning.Operations.GetOperation
-    get: '/v1/{name=projects/*/operations/*}'
-
-  - selector: google.longrunning.Operations.DeleteOperation
-    delete: '/v1/{name=projects/*/operations/*}'
+  - selector: 'google.datastore.admin.v1.DatastoreAdmin.*'
+    deadline: 295.0
+  - selector: 'google.longrunning.Operations.*'
+    deadline: 295.0
 
+http:
+  rules:
   - selector: google.longrunning.Operations.CancelOperation
     post: '/v1/{name=projects/*/operations/*}:cancel'
+  - selector: google.longrunning.Operations.DeleteOperation
+    delete: '/v1/{name=projects/*/operations/*}'
+  - selector: google.longrunning.Operations.GetOperation
+    get: '/v1/{name=projects/*/operations/*}'
+  - selector: google.longrunning.Operations.ListOperations
+    get: '/v1/{name=projects/*}/operations'
 
 authentication:
   rules:
-  - selector: '*'
+  - selector: 'google.datastore.admin.v1.DatastoreAdmin.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/datastore
+  - selector: 'google.longrunning.Operations.*'
     oauth:
       canonical_scopes: |-
         https://www.googleapis.com/auth/cloud-platform,
diff --git a/third_party/googleapis/google/datastore/admin/v1/index.proto b/third_party/googleapis/google/datastore/admin/v1/index.proto
index 15013d557..8907ae0b1 100644
--- a/third_party/googleapis/google/datastore/admin/v1/index.proto
+++ b/third_party/googleapis/google/datastore/admin/v1/index.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -16,6 +16,7 @@ syntax = "proto3";
 
 package google.datastore.admin.v1;
 
+import "google/api/field_behavior.proto";
 import "google/api/annotations.proto";
 
 option csharp_namespace = "Google.Cloud.Datastore.Admin.V1";
@@ -25,17 +26,14 @@ option java_outer_classname = "IndexProto";
 option java_package = "com.google.datastore.admin.v1";
 
 // A minimal index definition.
-// Next tag: 8
 message Index {
-  // Next tag: 3
+  // A property of an index.
   message IndexedProperty {
-    // The property name to index.
-    // Required.
-    string name = 1;
+    // Required. The property name to index.
+    string name = 1 [(google.api.field_behavior) = REQUIRED];
 
-    // The indexed property's direction.  Must not be DIRECTION_UNSPECIFIED.
-    // Required.
-    Direction direction = 2;
+    // Required. The indexed property's direction.  Must not be DIRECTION_UNSPECIFIED.
+    Direction direction = 2 [(google.api.field_behavior) = REQUIRED];
   }
 
   // For an ordered index, specifies whether each of the entity's ancestors
@@ -96,27 +94,21 @@ message Index {
     ERROR = 4;
   }
 
-  // Project ID.
-  // Output only.
-  string project_id = 1;
+  // Output only. Project ID.
+  string project_id = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // The resource ID of the index.
-  // Output only.
-  string index_id = 3;
+  // Output only. The resource ID of the index.
+  string index_id = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // The entity kind to which this index applies.
-  // Required.
-  string kind = 4;
+  // Required. The entity kind to which this index applies.
+  string kind = 4 [(google.api.field_behavior) = REQUIRED];
 
-  // The index's ancestor mode.  Must not be ANCESTOR_MODE_UNSPECIFIED.
-  // Required.
-  AncestorMode ancestor = 5;
+  // Required. The index's ancestor mode.  Must not be ANCESTOR_MODE_UNSPECIFIED.
+  AncestorMode ancestor = 5 [(google.api.field_behavior) = REQUIRED];
 
-  // An ordered sequence of property names and their index attributes.
-  // Required.
-  repeated IndexedProperty properties = 6;
+  // Required. An ordered sequence of property names and their index attributes.
+  repeated IndexedProperty properties = 6 [(google.api.field_behavior) = REQUIRED];
 
-  // The state of the index.
-  // Output only.
-  State state = 7;
+  // Output only. The state of the index.
+  State state = 7 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
diff --git a/third_party/googleapis/google/datastore/artman_datastore.legacy.yaml b/third_party/googleapis/google/datastore/artman_datastore.legacy.yaml
new file mode 100644
index 000000000..67c0775eb
--- /dev/null
+++ b/third_party/googleapis/google/datastore/artman_datastore.legacy.yaml
@@ -0,0 +1,36 @@
+common:
+  api_name: datastore
+  api_version: v1
+  organization_name: google-cloud
+  service_yaml: v1/datastore_v1.yaml
+  gapic_yaml: v1/datastore_gapic.legacy.yaml
+  proto_package: google.datastore.v1
+  src_proto_paths:
+  - v1
+  proto_deps:
+  - name: google-common-protos
+artifacts:
+- name: java_proto
+  type: PROTOBUF
+  language: JAVA
+- name: python_gapic
+  type: GAPIC
+  language: PYTHON
+  release_level: BETA
+- name: php_gapic
+  type: GAPIC
+  language: PHP
+- name: ruby_gapic
+  type: GAPIC
+  language: RUBY
+- name: go_gapic
+  type: GAPIC
+  language: GO
+- name: csharp_gapic
+  type: GAPIC
+  language: CSHARP
+- name: nodejs_gapic
+  type: GAPIC
+  language: NODEJS
+- name: gapic_config
+  type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/datastore/artman_datastore.yaml b/third_party/googleapis/google/datastore/artman_datastore.yaml
index 787c8fd97..9f5629ba5 100644
--- a/third_party/googleapis/google/datastore/artman_datastore.yaml
+++ b/third_party/googleapis/google/datastore/artman_datastore.yaml
@@ -2,8 +2,9 @@ common:
   api_name: datastore
   api_version: v1
   organization_name: google-cloud
-  service_yaml: datastore.yaml
+  service_yaml: v1/datastore_v1.yaml
   gapic_yaml: v1/datastore_gapic.yaml
+  proto_package: google.datastore.v1
   src_proto_paths:
   - v1
   proto_deps:
diff --git a/third_party/googleapis/google/datastore/datastore.yaml b/third_party/googleapis/google/datastore/datastore.yaml
deleted file mode 100644
index 26822278f..000000000
--- a/third_party/googleapis/google/datastore/datastore.yaml
+++ /dev/null
@@ -1,20 +0,0 @@
-type: google.api.Service
-config_version: 3
-name: datastore.googleapis.com
-title: Google Cloud Datastore API
-
-apis:
-- name: google.datastore.v1.Datastore
-
-documentation:
-  summary: |-
-    Accesses the schemaless NoSQL database to provide fully managed, robust,
-    scalable storage for your application.
-
-authentication:
-  rules:
-  - selector: '*'
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform,
-        https://www.googleapis.com/auth/datastore
diff --git a/third_party/googleapis/google/datastore/v1/BUILD.bazel b/third_party/googleapis/google/datastore/v1/BUILD.bazel
index 30f787ba9..e7a5111c9 100644
--- a/third_party/googleapis/google/datastore/v1/BUILD.bazel
+++ b/third_party/googleapis/google/datastore/v1/BUILD.bazel
@@ -1,9 +1,12 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
@@ -15,6 +18,8 @@ proto_library(
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
         "//google/type:latlng_proto",
         "@com_google_protobuf//:struct_proto",
         "@com_google_protobuf//:timestamp_proto",
@@ -24,7 +29,10 @@ proto_library(
 
 proto_library_with_info(
     name = "datastore_proto_with_info",
-    deps = [":datastore_proto"],
+    deps = [
+        ":datastore_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -32,18 +40,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
     name = "datastore_java_proto",
     deps = [":datastore_proto"],
@@ -52,51 +55,40 @@ java_proto_library(
 java_grpc_library(
     name = "datastore_java_grpc",
     srcs = [":datastore_proto"],
-    deps = [":datastore_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "datastore_resource_name_java_proto",
-    gapic_yaml = "datastore_gapic.yaml",
-    deps = [":datastore_proto"],
+    deps = [":datastore_java_proto"],
 )
 
 java_gapic_library(
     name = "datastore_java_gapic",
     src = ":datastore_proto_with_info",
     gapic_yaml = "datastore_gapic.yaml",
-    service_yaml = "//google/datastore:datastore.yaml",
-    test_deps = [":datastore_java_grpc"],
+    package = "google.datastore.v1",
+    service_yaml = "datastore_v1.yaml",
+    test_deps = [
+        ":datastore_java_grpc",
+    ],
     deps = [
         ":datastore_java_proto",
-        ":datastore_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":datastore_java_gapic_test",
+java_gapic_test(
+    name = "datastore_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.datastore.v1.DatastoreClientTest",
     ],
-) for test_name in [
-    "com.google.cloud.datastore.v1.DatastoreClientTest",
-]]
+    runtime_deps = [":datastore_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-datastore-v1-java",
-    client_deps = [":datastore_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":datastore_java_gapic_test"],
-    grpc_deps = [":datastore_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":datastore_java_gapic",
+        ":datastore_java_grpc",
         ":datastore_java_proto",
         ":datastore_proto",
-        ":datastore_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -104,10 +96,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -123,10 +115,10 @@ go_proto_library(
 
 go_gapic_library(
     name = "datastore_go_gapic",
-    src = ":datastore_proto_with_info",
-    gapic_yaml = "datastore_gapic.yaml",
-    importpath = "cloud.google.com/go/datastore/apiv1",
-    service_yaml = "//google/datastore:datastore.yaml",
+    srcs = [":datastore_proto_with_info"],
+    grpc_service_config = "datastore_grpc_service_config.json",
+    importpath = "cloud.google.com/go/datastore/apiv1;datastore",
+    service_yaml = "datastore_v1.yaml",
     deps = [
         ":datastore_go_proto",
     ],
@@ -139,13 +131,235 @@ go_test(
     importpath = "cloud.google.com/go/datastore/apiv1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-datastore-v1-go",
     deps = [
         ":datastore_go_gapic",
-        ":datastore_go_gapic_srcjar-smoke-test.srcjar",
         ":datastore_go_gapic_srcjar-test.srcjar",
         ":datastore_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "datastore_moved_proto",
+    srcs = [":datastore_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/type:latlng_proto",
+        "@com_google_protobuf//:struct_proto",
+        "@com_google_protobuf//:timestamp_proto",
+        "@com_google_protobuf//:wrappers_proto",
+    ],
+)
+
+py_proto_library(
+    name = "datastore_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":datastore_moved_proto"],
+)
+
+py_grpc_library(
+    name = "datastore_py_grpc",
+    srcs = [":datastore_moved_proto"],
+    deps = [":datastore_py_proto"],
+)
+
+py_gapic_library(
+    name = "datastore_py_gapic",
+    src = ":datastore_proto_with_info",
+    gapic_yaml = "datastore_gapic.yaml",
+    package = "google.datastore.v1",
+    service_yaml = "datastore_v1.yaml",
+    deps = [
+        ":datastore_py_grpc",
+        ":datastore_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "datastore-v1-py",
+    deps = [
+        ":datastore_py_gapic",
+        ":datastore_py_grpc",
+        ":datastore_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "datastore_php_proto",
+    deps = [":datastore_proto"],
+)
+
+php_grpc_library(
+    name = "datastore_php_grpc",
+    srcs = [":datastore_proto"],
+    deps = [":datastore_php_proto"],
+)
+
+php_gapic_library(
+    name = "datastore_php_gapic",
+    src = ":datastore_proto_with_info",
+    gapic_yaml = "datastore_gapic.legacy.yaml",
+    package = "google.datastore.v1",
+    service_yaml = "datastore_v1.yaml",
+    deps = [
+        ":datastore_php_grpc",
+        ":datastore_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-datastore-v1-php",
+    deps = [
+        ":datastore_php_gapic",
+        ":datastore_php_grpc",
+        ":datastore_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "datastore_nodejs_gapic",
+    src = ":datastore_proto_with_info",
+    gapic_yaml = "datastore_gapic.yaml",
+    package = "google.datastore.v1",
+    service_yaml = "datastore_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "datastore-v1-nodejs",
+    deps = [
+        ":datastore_nodejs_gapic",
+        ":datastore_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "datastore_ruby_proto",
+    deps = [":datastore_proto"],
+)
+
+ruby_grpc_library(
+    name = "datastore_ruby_grpc",
+    srcs = [":datastore_proto"],
+    deps = [":datastore_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "datastore_ruby_gapic",
+    src = ":datastore_proto_with_info",
+    gapic_yaml = "datastore_gapic.yaml",
+    package = "google.datastore.v1",
+    service_yaml = "datastore_v1.yaml",
+    deps = [
+        ":datastore_ruby_grpc",
+        ":datastore_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-datastore-v1-ruby",
+    deps = [
+        ":datastore_ruby_gapic",
+        ":datastore_ruby_grpc",
+        ":datastore_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "datastore_csharp_proto",
+    deps = [":datastore_proto"],
+)
+
+csharp_grpc_library(
+    name = "datastore_csharp_grpc",
+    srcs = [":datastore_proto"],
+    deps = [":datastore_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "datastore_csharp_gapic",
+    src = ":datastore_proto_with_info",
+    gapic_yaml = "datastore_gapic.yaml",
+    package = "google.datastore.v1",
+    service_yaml = "datastore_v1.yaml",
+    deps = [
+        ":datastore_csharp_grpc",
+        ":datastore_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-datastore-v1-csharp",
+    deps = [
+        ":datastore_csharp_gapic",
+        ":datastore_csharp_grpc",
+        ":datastore_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/datastore/v1/datastore.proto b/third_party/googleapis/google/datastore/v1/datastore.proto
index 51d69acb9..0df65c447 100644
--- a/third_party/googleapis/google/datastore/v1/datastore.proto
+++ b/third_party/googleapis/google/datastore/v1/datastore.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -17,6 +17,8 @@ syntax = "proto3";
 package google.datastore.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/datastore/v1/entity.proto";
 import "google/datastore/v1/query.proto";
 
@@ -35,12 +37,18 @@ option php_namespace = "Google\\Cloud\\Datastore\\V1";
 // the request.
 //
 service Datastore {
+  option (google.api.default_host) = "datastore.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/datastore";
+
   // Looks up entities by key.
   rpc Lookup(LookupRequest) returns (LookupResponse) {
     option (google.api.http) = {
       post: "/v1/projects/{project_id}:lookup"
       body: "*"
     };
+    option (google.api.method_signature) = "project_id,read_options,keys";
   }
 
   // Queries for entities.
@@ -52,12 +60,12 @@ service Datastore {
   }
 
   // Begins a new transaction.
-  rpc BeginTransaction(BeginTransactionRequest)
-      returns (BeginTransactionResponse) {
+  rpc BeginTransaction(BeginTransactionRequest) returns (BeginTransactionResponse) {
     option (google.api.http) = {
       post: "/v1/projects/{project_id}:beginTransaction"
       body: "*"
     };
+    option (google.api.method_signature) = "project_id";
   }
 
   // Commits a transaction, optionally creating, deleting or modifying some
@@ -67,6 +75,8 @@ service Datastore {
       post: "/v1/projects/{project_id}:commit"
       body: "*"
     };
+    option (google.api.method_signature) = "project_id,mode,transaction,mutations";
+    option (google.api.method_signature) = "project_id,mode,mutations";
   }
 
   // Rolls back a transaction.
@@ -75,6 +85,7 @@ service Datastore {
       post: "/v1/projects/{project_id}:rollback"
       body: "*"
     };
+    option (google.api.method_signature) = "project_id,transaction";
   }
 
   // Allocates IDs for the given keys, which is useful for referencing an entity
@@ -84,6 +95,7 @@ service Datastore {
       post: "/v1/projects/{project_id}:allocateIds"
       body: "*"
     };
+    option (google.api.method_signature) = "project_id,keys";
   }
 
   // Prevents the supplied keys' IDs from being auto-allocated by Cloud
@@ -93,19 +105,20 @@ service Datastore {
       post: "/v1/projects/{project_id}:reserveIds"
       body: "*"
     };
+    option (google.api.method_signature) = "project_id,keys";
   }
 }
 
 // The request for [Datastore.Lookup][google.datastore.v1.Datastore.Lookup].
 message LookupRequest {
-  // The ID of the project against which to make the request.
-  string project_id = 8;
+  // Required. The ID of the project against which to make the request.
+  string project_id = 8 [(google.api.field_behavior) = REQUIRED];
 
   // The options for this lookup request.
   ReadOptions read_options = 1;
 
-  // Keys of entities to look up.
-  repeated Key keys = 3;
+  // Required. Keys of entities to look up.
+  repeated Key keys = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The response for [Datastore.Lookup][google.datastore.v1.Datastore.Lookup].
@@ -128,8 +141,8 @@ message LookupResponse {
 
 // The request for [Datastore.RunQuery][google.datastore.v1.Datastore.RunQuery].
 message RunQueryRequest {
-  // The ID of the project against which to make the request.
-  string project_id = 8;
+  // Required. The ID of the project against which to make the request.
+  string project_id = 8 [(google.api.field_behavior) = REQUIRED];
 
   // Entities are partitioned into subsets, identified by a partition ID.
   // Queries are scoped to a single partition.
@@ -150,8 +163,7 @@ message RunQueryRequest {
   }
 }
 
-// The response for
-// [Datastore.RunQuery][google.datastore.v1.Datastore.RunQuery].
+// The response for [Datastore.RunQuery][google.datastore.v1.Datastore.RunQuery].
 message RunQueryResponse {
   // A batch of query results (always present).
   QueryResultBatch batch = 1;
@@ -160,18 +172,16 @@ message RunQueryResponse {
   Query query = 2;
 }
 
-// The request for
-// [Datastore.BeginTransaction][google.datastore.v1.Datastore.BeginTransaction].
+// The request for [Datastore.BeginTransaction][google.datastore.v1.Datastore.BeginTransaction].
 message BeginTransactionRequest {
-  // The ID of the project against which to make the request.
-  string project_id = 8;
+  // Required. The ID of the project against which to make the request.
+  string project_id = 8 [(google.api.field_behavior) = REQUIRED];
 
   // Options for a new transaction.
   TransactionOptions transaction_options = 10;
 }
 
-// The response for
-// [Datastore.BeginTransaction][google.datastore.v1.Datastore.BeginTransaction].
+// The response for [Datastore.BeginTransaction][google.datastore.v1.Datastore.BeginTransaction].
 message BeginTransactionResponse {
   // The transaction identifier (always present).
   bytes transaction = 1;
@@ -179,18 +189,19 @@ message BeginTransactionResponse {
 
 // The request for [Datastore.Rollback][google.datastore.v1.Datastore.Rollback].
 message RollbackRequest {
-  // The ID of the project against which to make the request.
-  string project_id = 8;
+  // Required. The ID of the project against which to make the request.
+  string project_id = 8 [(google.api.field_behavior) = REQUIRED];
 
-  // The transaction identifier, returned by a call to
+  // Required. The transaction identifier, returned by a call to
   // [Datastore.BeginTransaction][google.datastore.v1.Datastore.BeginTransaction].
-  bytes transaction = 1;
+  bytes transaction = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
-// The response for
-// [Datastore.Rollback][google.datastore.v1.Datastore.Rollback]. (an empty
-// message).
-message RollbackResponse {}
+// The response for [Datastore.Rollback][google.datastore.v1.Datastore.Rollback].
+// (an empty message).
+message RollbackResponse {
+
+}
 
 // The request for [Datastore.Commit][google.datastore.v1.Datastore.Commit].
 message CommitRequest {
@@ -208,8 +219,8 @@ message CommitRequest {
     NON_TRANSACTIONAL = 2;
   }
 
-  // The ID of the project against which to make the request.
-  string project_id = 8;
+  // Required. The ID of the project against which to make the request.
+  string project_id = 8 [(google.api.field_behavior) = REQUIRED];
 
   // The type of commit to perform. Defaults to `TRANSACTIONAL`.
   Mode mode = 5;
@@ -249,42 +260,40 @@ message CommitResponse {
   int32 index_updates = 4;
 }
 
-// The request for
-// [Datastore.AllocateIds][google.datastore.v1.Datastore.AllocateIds].
+// The request for [Datastore.AllocateIds][google.datastore.v1.Datastore.AllocateIds].
 message AllocateIdsRequest {
-  // The ID of the project against which to make the request.
-  string project_id = 8;
+  // Required. The ID of the project against which to make the request.
+  string project_id = 8 [(google.api.field_behavior) = REQUIRED];
 
-  // A list of keys with incomplete key paths for which to allocate IDs.
+  // Required. A list of keys with incomplete key paths for which to allocate IDs.
   // No key may be reserved/read-only.
-  repeated Key keys = 1;
+  repeated Key keys = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
-// The response for
-// [Datastore.AllocateIds][google.datastore.v1.Datastore.AllocateIds].
+// The response for [Datastore.AllocateIds][google.datastore.v1.Datastore.AllocateIds].
 message AllocateIdsResponse {
   // The keys specified in the request (in the same order), each with
   // its key path completed with a newly allocated ID.
   repeated Key keys = 1;
 }
 
-// The request for
-// [Datastore.ReserveIds][google.datastore.v1.Datastore.ReserveIds].
+// The request for [Datastore.ReserveIds][google.datastore.v1.Datastore.ReserveIds].
 message ReserveIdsRequest {
-  // The ID of the project against which to make the request.
-  string project_id = 8;
+  // Required. The ID of the project against which to make the request.
+  string project_id = 8 [(google.api.field_behavior) = REQUIRED];
 
   // If not empty, the ID of the database against which to make the request.
   string database_id = 9;
 
-  // A list of keys with complete key paths whose numeric IDs should not be
+  // Required. A list of keys with complete key paths whose numeric IDs should not be
   // auto-allocated.
-  repeated Key keys = 1;
+  repeated Key keys = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
-// The response for
-// [Datastore.ReserveIds][google.datastore.v1.Datastore.ReserveIds].
-message ReserveIdsResponse {}
+// The response for [Datastore.ReserveIds][google.datastore.v1.Datastore.ReserveIds].
+message ReserveIdsResponse {
+
+}
 
 // A mutation to apply to an entity.
 message Mutation {
@@ -374,10 +383,8 @@ message ReadOptions {
 // Options for beginning a new transaction.
 //
 // Transactions can be created explicitly with calls to
-// [Datastore.BeginTransaction][google.datastore.v1.Datastore.BeginTransaction]
-// or implicitly by setting
-// [ReadOptions.new_transaction][google.datastore.v1.ReadOptions.new_transaction]
-// in read requests.
+// [Datastore.BeginTransaction][google.datastore.v1.Datastore.BeginTransaction] or implicitly by setting
+// [ReadOptions.new_transaction][google.datastore.v1.ReadOptions.new_transaction] in read requests.
 message TransactionOptions {
   // Options specific to read / write transactions.
   message ReadWrite {
@@ -386,7 +393,9 @@ message TransactionOptions {
   }
 
   // Options specific to read-only transactions.
-  message ReadOnly {}
+  message ReadOnly {
+
+  }
 
   // The `mode` of the transaction, indicating whether write operations are
   // supported.
diff --git a/third_party/googleapis/google/datastore/v1/datastore_gapic.legacy.yaml b/third_party/googleapis/google/datastore/v1/datastore_gapic.legacy.yaml
new file mode 100644
index 000000000..bbdf7200e
--- /dev/null
+++ b/third_party/googleapis/google/datastore/v1/datastore_gapic.legacy.yaml
@@ -0,0 +1,126 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.datastore.v1
+  python:
+    package_name: google.cloud.datastore_v1.gapic
+  go:
+    package_name: cloud.google.com/go/datastore/apiv1
+  csharp:
+    package_name: Google.Cloud.Datastore.V1
+    release_level: GA
+  ruby:
+    package_name: Google::Cloud::Datastore::V1
+    release_level: GA
+  php:
+    package_name: Google\Cloud\Datastore\V1
+  nodejs:
+    package_name: datastore.v1
+    domain_layer_location: google-cloud
+interfaces:
+- name: google.datastore.v1.Datastore
+  collections: []
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 60000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 60000
+    total_timeout_millis: 600000
+  methods:
+  - name: Lookup
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - read_options
+        - keys
+    required_fields:
+    - project_id
+    - keys
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: RunQuery
+    # NOTE: Add flattening with oneof when oneofs implemented
+    required_fields:
+    - project_id
+    - partition_id
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: BeginTransaction
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+    required_fields:
+    - project_id
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: Commit
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - mode
+        - transaction
+        - mutations
+      - parameters:
+        - project_id
+        - mode
+        - mutations
+    required_fields:
+    - project_id
+    - mode
+    - mutations
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: Rollback
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - transaction
+    required_fields:
+    - project_id
+    - transaction
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: AllocateIds
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - keys
+    required_fields:
+    - project_id
+    - keys
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: ReserveIds
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - keys
+    required_fields:
+    - project_id
+    - keys
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
diff --git a/third_party/googleapis/google/datastore/v1/datastore_gapic.yaml b/third_party/googleapis/google/datastore/v1/datastore_gapic.yaml
index bbdf7200e..e9860d5ef 100644
--- a/third_party/googleapis/google/datastore/v1/datastore_gapic.yaml
+++ b/third_party/googleapis/google/datastore/v1/datastore_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.datastore.v1
@@ -20,14 +20,6 @@ language_settings:
     domain_layer_location: google-cloud
 interfaces:
 - name: google.datastore.v1.Datastore
-  collections: []
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 100
@@ -39,88 +31,8 @@ interfaces:
     total_timeout_millis: 600000
   methods:
   - name: Lookup
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - read_options
-        - keys
-    required_fields:
-    - project_id
-    - keys
     retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 60000
   - name: RunQuery
-    # NOTE: Add flattening with oneof when oneofs implemented
-    required_fields:
-    - project_id
-    - partition_id
     retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-  - name: BeginTransaction
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-    required_fields:
-    - project_id
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-  - name: Commit
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - mode
-        - transaction
-        - mutations
-      - parameters:
-        - project_id
-        - mode
-        - mutations
-    required_fields:
-    - project_id
-    - mode
-    - mutations
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-  - name: Rollback
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - transaction
-    required_fields:
-    - project_id
-    - transaction
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-  - name: AllocateIds
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - keys
-    required_fields:
-    - project_id
-    - keys
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
   - name: ReserveIds
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - keys
-    required_fields:
-    - project_id
-    - keys
     retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 60000
diff --git a/third_party/googleapis/google/datastore/v1/datastore_grpc_service_config.json b/third_party/googleapis/google/datastore/v1/datastore_grpc_service_config.json
new file mode 100755
index 000000000..48a210a8e
--- /dev/null
+++ b/third_party/googleapis/google/datastore/v1/datastore_grpc_service_config.json
@@ -0,0 +1,51 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.datastore.v1.Datastore",
+          "method": "Lookup"
+        },
+        {
+          "service": "google.datastore.v1.Datastore",
+          "method": "RunQuery"
+        },
+        {
+          "service": "google.datastore.v1.Datastore",
+          "method": "ReserveIds"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.datastore.v1.Datastore",
+          "method": "BeginTransaction"
+        },
+        {
+          "service": "google.datastore.v1.Datastore",
+          "method": "Commit"
+        },
+        {
+          "service": "google.datastore.v1.Datastore",
+          "method": "Rollback"
+        },
+        {
+          "service": "google.datastore.v1.Datastore",
+          "method": "AllocateIds"
+        }
+      ],
+      "timeout": "60s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/datastore/v1/datastore_v1.yaml b/third_party/googleapis/google/datastore/v1/datastore_v1.yaml
new file mode 100644
index 000000000..bd26ed778
--- /dev/null
+++ b/third_party/googleapis/google/datastore/v1/datastore_v1.yaml
@@ -0,0 +1,43 @@
+type: google.api.Service
+config_version: 3
+name: datastore.googleapis.com
+title: Cloud Datastore API
+
+apis:
+- name: google.datastore.v1.Datastore
+
+documentation:
+  summary: |-
+    Accesses the schemaless NoSQL database to provide fully managed, robust,
+    scalable storage for your application.
+
+backend:
+  rules:
+  - selector: 'google.datastore.v1.Datastore.*'
+    deadline: 295.0
+  - selector: 'google.longrunning.Operations.*'
+    deadline: 295.0
+
+http:
+  rules:
+  - selector: google.longrunning.Operations.CancelOperation
+    post: '/v1/{name=projects/*/operations/*}:cancel'
+  - selector: google.longrunning.Operations.DeleteOperation
+    delete: '/v1/{name=projects/*/operations/*}'
+  - selector: google.longrunning.Operations.GetOperation
+    get: '/v1/{name=projects/*/operations/*}'
+  - selector: google.longrunning.Operations.ListOperations
+    get: '/v1/{name=projects/*}/operations'
+
+authentication:
+  rules:
+  - selector: 'google.datastore.v1.Datastore.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/datastore
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/datastore
diff --git a/third_party/googleapis/google/datastore/v1/entity.proto b/third_party/googleapis/google/datastore/v1/entity.proto
index 9decd2b53..dc3a60120 100644
--- a/third_party/googleapis/google/datastore/v1/entity.proto
+++ b/third_party/googleapis/google/datastore/v1/entity.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -114,8 +114,8 @@ message Key {
 // An array value.
 message ArrayValue {
   // Values in the array.
-  // The order of this array may not be preserved if it contains a mix of
-  // indexed and unindexed values.
+  // The order of values in an array is preserved as long as all values have
+  // identical settings for 'exclude_from_indexes'.
   repeated Value values = 1;
 }
 
@@ -145,8 +145,8 @@ message Value {
     Key key_value = 5;
 
     // A UTF-8 encoded string value.
-    // When `exclude_from_indexes` is false (it is indexed) , may have at most
-    // 1500 bytes. Otherwise, may be set to at least 1,000,000 bytes.
+    // When `exclude_from_indexes` is false (it is indexed), may have at most
+    // 1500 bytes. Otherwise, may be set to at most 1,000,000 bytes.
     string string_value = 17;
 
     // A blob value.
diff --git a/third_party/googleapis/google/datastore/v1/query.proto b/third_party/googleapis/google/datastore/v1/query.proto
index 872612c5d..ef9f1c658 100644
--- a/third_party/googleapis/google/datastore/v1/query.proto
+++ b/third_party/googleapis/google/datastore/v1/query.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -55,12 +55,12 @@ message EntityResult {
   // The version of the entity, a strictly positive number that monotonically
   // increases with changes to the entity.
   //
-  // This field is set for
-  // [`FULL`][google.datastore.v1.EntityResult.ResultType.FULL] entity results.
+  // This field is set for [`FULL`][google.datastore.v1.EntityResult.ResultType.FULL] entity
+  // results.
   //
-  // For [missing][google.datastore.v1.LookupResponse.missing] entities in
-  // `LookupResponse`, this is the version of the snapshot that was used to look
-  // up the entity, and it is always set except for eventually consistent reads.
+  // For [missing][google.datastore.v1.LookupResponse.missing] entities in `LookupResponse`, this
+  // is the version of the snapshot that was used to look up the entity, and it
+  // is always set except for eventually consistent reads.
   int64 version = 4;
 
   // A cursor that points to the position after the result entity.
diff --git a/third_party/googleapis/google/datastore/v1beta3/entity.proto b/third_party/googleapis/google/datastore/v1beta3/entity.proto
index 65863236a..070036e3f 100644
--- a/third_party/googleapis/google/datastore/v1beta3/entity.proto
+++ b/third_party/googleapis/google/datastore/v1beta3/entity.proto
@@ -145,8 +145,8 @@ message Value {
     Key key_value = 5;
 
     // A UTF-8 encoded string value.
-    // When `exclude_from_indexes` is false (it is indexed) , may have at most
-    // 1500 bytes. Otherwise, may be set to at least 1,000,000 bytes.
+    // When `exclude_from_indexes` is false (it is indexed), may have at most
+    // 1500 bytes. Otherwise, may be set to at most 1,000,000 bytes.
     string string_value = 17;
 
     // A blob value.
diff --git a/third_party/googleapis/google/devtools/artman_clouddebugger.yaml b/third_party/googleapis/google/devtools/artman_clouddebugger.yaml
index 8dee0080f..42a0825d2 100644
--- a/third_party/googleapis/google/devtools/artman_clouddebugger.yaml
+++ b/third_party/googleapis/google/devtools/artman_clouddebugger.yaml
@@ -2,13 +2,14 @@ common:
   api_name: debugger
   api_version: v2
   organization_name: google-cloud
-  service_yaml: clouddebugger/clouddebugger.yaml
+  service_yaml: clouddebugger/v2/clouddebugger_v2.yaml
   gapic_yaml: clouddebugger/v2/clouddebugger_gapic.yaml
   src_proto_paths:
   - clouddebugger/v2
   - source/v1
   proto_deps:
   - name: google-common-protos
+  proto_package: google.devtools.clouddebugger.v2
 artifacts:
 - name: java_gapic
   type: GAPIC
diff --git a/third_party/googleapis/google/devtools/build/BUILD.bazel b/third_party/googleapis/google/devtools/build/BUILD.bazel
new file mode 100644
index 000000000..a87c57fec
--- /dev/null
+++ b/third_party/googleapis/google/devtools/build/BUILD.bazel
@@ -0,0 +1 @@
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/devtools/build/v1/BUILD.bazel b/third_party/googleapis/google/devtools/build/v1/BUILD.bazel
new file mode 100644
index 000000000..b2b2c88be
--- /dev/null
+++ b/third_party/googleapis/google/devtools/build/v1/BUILD.bazel
@@ -0,0 +1,367 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "build_proto",
+    srcs = [
+        "build_events.proto",
+        "build_status.proto",
+        "publish_build_event.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "@com_google_protobuf//:any_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:timestamp_proto",
+        "@com_google_protobuf//:wrappers_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "build_proto_with_info",
+    deps = [
+        ":build_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "build_java_proto",
+    deps = [":build_proto"],
+)
+
+java_grpc_library(
+    name = "build_java_grpc",
+    srcs = [":build_proto"],
+    deps = [":build_java_proto"],
+)
+
+java_gapic_library(
+    name = "build_java_gapic",
+    src = ":build_proto_with_info",
+    gapic_yaml = "buildeventservice_gapic.yaml",
+    package = "google.devtools.build.v1",
+    service_yaml = "buildeventservice_v1.yaml",
+    test_deps = [
+        ":build_java_grpc",
+    ],
+    deps = [
+        ":build_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "build_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.devtools.build.v1.PublishBuildEventClientTest",
+    ],
+    runtime_deps = [":build_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-devtools-build-v1-java",
+    deps = [
+        ":build_java_gapic",
+        ":build_java_grpc",
+        ":build_java_proto",
+        ":build_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "build_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/devtools/build/v1",
+    protos = [":build_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "build_go_gapic",
+    srcs = [":build_proto_with_info"],
+    grpc_service_config = "buildeventservice_grpc_service_config.json",
+    importpath = "cloud.google.com/go/devtools/build/apiv1;build",
+    service_yaml = "buildeventservice_v1.yaml",
+    deps = [
+        ":build_go_proto",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
+    ],
+)
+
+go_test(
+    name = "build_go_gapic_test",
+    srcs = [":build_go_gapic_srcjar_test"],
+    embed = [":build_go_gapic"],
+    importpath = "cloud.google.com/go/devtools/build/apiv1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-devtools-build-v1-go",
+    deps = [
+        ":build_go_gapic",
+        ":build_go_gapic_srcjar-test.srcjar",
+        ":build_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "build_moved_proto",
+    srcs = [":build_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "@com_google_protobuf//:any_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:timestamp_proto",
+        "@com_google_protobuf//:wrappers_proto",
+    ],
+)
+
+py_proto_library(
+    name = "build_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":build_moved_proto"],
+)
+
+py_grpc_library(
+    name = "build_py_grpc",
+    srcs = [":build_moved_proto"],
+    deps = [":build_py_proto"],
+)
+
+py_gapic_library(
+    name = "build_py_gapic",
+    src = ":build_proto_with_info",
+    gapic_yaml = "buildeventservice_gapic.yaml",
+    package = "google.devtools.build.v1",
+    service_yaml = "buildeventservice_v1.yaml",
+    deps = [
+        ":build_py_grpc",
+        ":build_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "devtools-build-v1-py",
+    deps = [
+        ":build_py_gapic",
+        ":build_py_grpc",
+        ":build_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "build_php_proto",
+    deps = [":build_proto"],
+)
+
+php_grpc_library(
+    name = "build_php_grpc",
+    srcs = [":build_proto"],
+    deps = [":build_php_proto"],
+)
+
+php_gapic_library(
+    name = "build_php_gapic",
+    src = ":build_proto_with_info",
+    gapic_yaml = "buildeventservice_gapic.yaml",
+    package = "google.devtools.build.v1",
+    service_yaml = "buildeventservice_v1.yaml",
+    deps = [
+        ":build_php_grpc",
+        ":build_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-devtools-build-v1-php",
+    deps = [
+        ":build_php_gapic",
+        ":build_php_grpc",
+        ":build_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "build_nodejs_gapic",
+    src = ":build_proto_with_info",
+    gapic_yaml = "buildeventservice_gapic.yaml",
+    package = "google.devtools.build.v1",
+    service_yaml = "buildeventservice_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "devtools-build-v1-nodejs",
+    deps = [
+        ":build_nodejs_gapic",
+        ":build_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "build_ruby_proto",
+    deps = [":build_proto"],
+)
+
+ruby_grpc_library(
+    name = "build_ruby_grpc",
+    srcs = [":build_proto"],
+    deps = [":build_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "build_ruby_gapic",
+    src = ":build_proto_with_info",
+    gapic_yaml = "buildeventservice_gapic.yaml",
+    package = "google.devtools.build.v1",
+    service_yaml = "buildeventservice_v1.yaml",
+    deps = [
+        ":build_ruby_grpc",
+        ":build_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-devtools-build-v1-ruby",
+    deps = [
+        ":build_ruby_gapic",
+        ":build_ruby_grpc",
+        ":build_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "build_csharp_proto",
+    deps = [":build_proto"],
+)
+
+csharp_grpc_library(
+    name = "build_csharp_grpc",
+    srcs = [":build_proto"],
+    deps = [":build_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "build_csharp_gapic",
+    src = ":build_proto_with_info",
+    gapic_yaml = "buildeventservice_gapic.yaml",
+    package = "google.devtools.build.v1",
+    service_yaml = "buildeventservice_v1.yaml",
+    deps = [
+        ":build_csharp_grpc",
+        ":build_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-devtools-build-v1-csharp",
+    deps = [
+        ":build_csharp_gapic",
+        ":build_csharp_grpc",
+        ":build_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/devtools/build/v1/build_events.proto b/third_party/googleapis/google/devtools/build/v1/build_events.proto
index 8b29a4521..35615136b 100644
--- a/third_party/googleapis/google/devtools/build/v1/build_events.proto
+++ b/third_party/googleapis/google/devtools/build/v1/build_events.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,11 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.devtools.build.v1;
 
-import "google/api/annotations.proto";
 import "google/devtools/build/v1/build_status.proto";
 import "google/protobuf/any.proto";
 import "google/protobuf/timestamp.proto";
@@ -38,7 +36,7 @@ message BuildEvent {
     // invocation attempt replacing the current one a client is processing.
     int64 attempt_number = 1;
 
-    // Additional details about the invocation.
+    // Arbitrary details about the invocation attempt.
     google.protobuf.Any details = 2;
   }
 
@@ -46,6 +44,9 @@ message BuildEvent {
   message InvocationAttemptFinished {
     // Final status of the invocation.
     BuildStatus invocation_status = 3;
+
+    // Arbitrary details about the invocation attempt.
+    google.protobuf.Any details = 4;
   }
 
   // Notification that the build request is enqueued.
@@ -60,6 +61,9 @@ message BuildEvent {
   message BuildFinished {
     // Final status of the build.
     BuildStatus status = 1;
+
+    // Additional details about the Build.
+    google.protobuf.Any details = 2;
   }
 
   // Textual output written to standard output or standard error.
@@ -112,8 +116,7 @@ message BuildEvent {
     // An invocation attempt has finished.
     InvocationAttemptFinished invocation_attempt_finished = 52;
 
-    // The build is enqueued (just inserted to the build queue or put back
-    // into the build queue due to a previous build failure).
+    // The build is enqueued.
     BuildEnqueued build_enqueued = 53;
 
     // The build has finished. Set when the build is terminated.
diff --git a/third_party/googleapis/google/devtools/build/v1/build_status.proto b/third_party/googleapis/google/devtools/build/v1/build_status.proto
index 8d108e36c..8de104816 100644
--- a/third_party/googleapis/google/devtools/build/v1/build_status.proto
+++ b/third_party/googleapis/google/devtools/build/v1/build_status.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,12 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.devtools.build.v1;
 
-import "google/api/annotations.proto";
+import "google/protobuf/wrappers.proto";
 import "google/protobuf/any.proto";
 
 option cc_enable_arenas = true;
@@ -61,6 +60,14 @@ message BuildStatus {
   // The end result.
   Result result = 1;
 
+  // Final invocation ID of the build, if there was one.
+  // This field is only set on a status in BuildFinished event.
+  string final_invocation_id = 3;
+
+  // Build tool exit code. Integer value returned by the executed build tool.
+  // Might not be available in some cases, e.g., a build timeout.
+  google.protobuf.Int32Value build_tool_exit_code = 4;
+
   // Fine-grained diagnostic information to complement the status.
   google.protobuf.Any details = 2;
 }
diff --git a/third_party/googleapis/google/devtools/build/v1/buildeventservice_gapic.legacy.yaml b/third_party/googleapis/google/devtools/build/v1/buildeventservice_gapic.legacy.yaml
new file mode 100644
index 000000000..cabd6db30
--- /dev/null
+++ b/third_party/googleapis/google/devtools/build/v1/buildeventservice_gapic.legacy.yaml
@@ -0,0 +1,126 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.devtools.build.v1
+  python:
+    package_name: google.cloud.devtools.build_v1.gapic
+  go:
+    package_name: cloud.google.com/go/devtools/build/apiv1
+  csharp:
+    package_name: Google.Devtools.Build.V1
+  ruby:
+    package_name: Google::Cloud::Devtools::Build::V1
+  php:
+    package_name: Google\Cloud\Devtools\Build\V1
+  nodejs:
+    package_name: build.v1
+# A list of API interface configurations.
+interfaces:
+  # The fully qualified name of the API interface.
+- name: google.devtools.build.v1.PublishBuildEvent
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections: []
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: PublishLifecycleEvent
+    required_fields:
+    - build_event
+    - project_id
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: PublishBuildToolEventStream
+    flattening:
+      groups:
+      - parameters:
+        - ordered_build_event
+        - notification_keywords
+        - project_id
+    required_fields:
+    - ordered_build_event
+    - project_id
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
diff --git a/third_party/googleapis/google/devtools/build/v1/buildeventservice_gapic.yaml b/third_party/googleapis/google/devtools/build/v1/buildeventservice_gapic.yaml
index cabd6db30..99b3a8152 100644
--- a/third_party/googleapis/google/devtools/build/v1/buildeventservice_gapic.yaml
+++ b/third_party/googleapis/google/devtools/build/v1/buildeventservice_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -20,107 +20,3 @@ language_settings:
 interfaces:
   # The fully qualified name of the API interface.
 - name: google.devtools.build.v1.PublishBuildEvent
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections: []
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - DEADLINE_EXCEEDED
-    - UNAVAILABLE
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
-  methods:
-  - name: PublishLifecycleEvent
-    required_fields:
-    - build_event
-    - project_id
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-  - name: PublishBuildToolEventStream
-    flattening:
-      groups:
-      - parameters:
-        - ordered_build_event
-        - notification_keywords
-        - project_id
-    required_fields:
-    - ordered_build_event
-    - project_id
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
diff --git a/third_party/googleapis/google/devtools/build/v1/buildeventservice_grpc_service_config.json b/third_party/googleapis/google/devtools/build/v1/buildeventservice_grpc_service_config.json
new file mode 100755
index 000000000..b56183daf
--- /dev/null
+++ b/third_party/googleapis/google/devtools/build/v1/buildeventservice_grpc_service_config.json
@@ -0,0 +1,17 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.devtools.build.v1.PublishBuildEvent",
+          "method": "PublishLifecycleEvent"
+        },
+        {
+          "service": "google.devtools.build.v1.PublishBuildEvent",
+          "method": "PublishBuildToolEventStream"
+        }
+      ],
+      "timeout": "600s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/devtools/build/v1/buildeventservice_v1.yaml b/third_party/googleapis/google/devtools/build/v1/buildeventservice_v1.yaml
new file mode 100644
index 000000000..b92d5223e
--- /dev/null
+++ b/third_party/googleapis/google/devtools/build/v1/buildeventservice_v1.yaml
@@ -0,0 +1,21 @@
+type: google.api.Service
+config_version: 3
+name: buildeventservice.googleapis.com
+title: Build Event Service Backend API
+
+apis:
+- name: google.devtools.build.v1.PublishBuildEvent
+
+documentation:
+  summary: Handles build events from tools such as bazel.
+
+authentication:
+  rules:
+  - selector: google.devtools.build.v1.PublishBuildEvent.PublishBuildToolEventStream
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: google.devtools.build.v1.PublishBuildEvent.PublishLifecycleEvent
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/devtools/build/v1/publish_build_event.proto b/third_party/googleapis/google/devtools/build/v1/publish_build_event.proto
index 5e483d679..df63a01f2 100644
--- a/third_party/googleapis/google/devtools/build/v1/publish_build_event.proto
+++ b/third_party/googleapis/google/devtools/build/v1/publish_build_event.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,14 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.devtools.build.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/devtools/build/v1/build_events.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/empty.proto";
@@ -44,6 +45,9 @@ option java_package = "com.google.devtools.build.v1";
 // target objects produced via compilation, tests run, et cetera. There could be
 // more than one build tool stream for an invocation attempt of a build.
 service PublishBuildEvent {
+  option (google.api.default_host) = "buildeventservice.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Publish a build event stating the new state of a build (typically from the
   // build queue). The BuildEnqueued event must be publishd before all other
   // events for the same build ID.
@@ -54,24 +58,29 @@ service PublishBuildEvent {
   // The commit status of the request is reported by the RPC's util_status()
   // function. The error code is the canoncial error code defined in
   // //util/task/codes.proto.
-  rpc PublishLifecycleEvent(PublishLifecycleEventRequest)
-      returns (google.protobuf.Empty) {
+  rpc PublishLifecycleEvent(PublishLifecycleEventRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       post: "/v1/projects/{project_id=*}/lifecycleEvents:publish"
       body: "*"
-      additional_bindings { post: "/v1/lifecycleEvents:publish" body: "*" }
+      additional_bindings {
+        post: "/v1/lifecycleEvents:publish"
+        body: "*"
+      }
     };
   }
 
   // Publish build tool events belonging to the same stream to a backend job
   // using bidirectional streaming.
-  rpc PublishBuildToolEventStream(stream PublishBuildToolEventStreamRequest)
-      returns (stream PublishBuildToolEventStreamResponse) {
+  rpc PublishBuildToolEventStream(stream PublishBuildToolEventStreamRequest) returns (stream PublishBuildToolEventStreamResponse) {
     option (google.api.http) = {
       post: "/v1/projects/{project_id=*}/events:publish"
       body: "*"
-      additional_bindings { post: "/v1/events:publish" body: "*" }
+      additional_bindings {
+        post: "/v1/events:publish"
+        body: "*"
+      }
     };
+    option (google.api.method_signature) = "ordered_build_event,notification_keywords,project_id";
   }
 }
 
@@ -97,9 +106,9 @@ message PublishLifecycleEventRequest {
   // The interactivity of this build.
   ServiceLevel service_level = 1;
 
-  // The lifecycle build event. If this is a build tool event, the RPC will fail
+  // Required. The lifecycle build event. If this is a build tool event, the RPC will fail
   // with INVALID_REQUEST.
-  OrderedBuildEvent build_event = 2;
+  OrderedBuildEvent build_event = 2 [(google.api.field_behavior) = REQUIRED];
 
   // If the next event for this build or invocation (depending on the event
   // type) hasn't been published after this duration from when {build_event}
@@ -114,10 +123,10 @@ message PublishLifecycleEventRequest {
   // BuildEnqueued/InvocationAttemptStarted.
   repeated string notification_keywords = 4;
 
-  // The project this build is associated with.
+  // Required. The project this build is associated with.
   // This should match the project used for the initial call to
   // PublishLifecycleEvent (containing a BuildEnqueued message).
-  string project_id = 6;
+  string project_id = 6 [(google.api.field_behavior) = REQUIRED];
 }
 
 // States which event has been committed. Any failure to commit will cause
@@ -147,9 +156,9 @@ message OrderedBuildEvent {
 
 // Streaming request message for PublishBuildToolEventStream.
 message PublishBuildToolEventStreamRequest {
-  // The build event with position info.
+  // Required. The build event with position info.
   // New publishing clients should use this field rather than the 3 above.
-  OrderedBuildEvent ordered_build_event = 4;
+  OrderedBuildEvent ordered_build_event = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The keywords to be attached to the notification which notifies the start
   // of a new build event stream. BES only reads this field when sequence_number
@@ -157,8 +166,8 @@ message PublishBuildToolEventStreamRequest {
   // is empty, BES will not publish notification messages for this stream.
   repeated string notification_keywords = 5;
 
-  // The project this build is associated with.
+  // Required. The project this build is associated with.
   // This should match the project used for the initial call to
   // PublishLifecycleEvent (containing a BuildEnqueued message).
-  string project_id = 6;
+  string project_id = 6 [(google.api.field_behavior) = REQUIRED];
 }
diff --git a/third_party/googleapis/google/devtools/cloudbuild/v1/BUILD.bazel b/third_party/googleapis/google/devtools/cloudbuild/v1/BUILD.bazel
new file mode 100644
index 000000000..789f14f84
--- /dev/null
+++ b/third_party/googleapis/google/devtools/cloudbuild/v1/BUILD.bazel
@@ -0,0 +1,369 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "cloudbuild_proto",
+    srcs = [
+        "cloudbuild.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "cloudbuild_proto_with_info",
+    deps = [
+        ":cloudbuild_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "cloudbuild_java_proto",
+    deps = [":cloudbuild_proto"],
+)
+
+java_grpc_library(
+    name = "cloudbuild_java_grpc",
+    srcs = [":cloudbuild_proto"],
+    deps = [":cloudbuild_java_proto"],
+)
+
+java_gapic_library(
+    name = "cloudbuild_java_gapic",
+    src = ":cloudbuild_proto_with_info",
+    gapic_yaml = "cloudbuild_gapic.yaml",
+    package = "google.devtools.cloudbuild.v1",
+    service_yaml = "cloudbuild_v1.yaml",
+    test_deps = [
+        ":cloudbuild_java_grpc",
+    ],
+    deps = [
+        ":cloudbuild_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "cloudbuild_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.devtools.cloudbuild.v1.CloudBuildClientTest",
+    ],
+    runtime_deps = [":cloudbuild_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-devtools-cloudbuild-v1-java",
+    deps = [
+        ":cloudbuild_java_gapic",
+        ":cloudbuild_java_grpc",
+        ":cloudbuild_java_proto",
+        ":cloudbuild_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "cloudbuild_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/devtools/cloudbuild/v1",
+    protos = [":cloudbuild_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/longrunning:longrunning_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "cloudbuild_go_gapic",
+    srcs = [":cloudbuild_proto_with_info"],
+    grpc_service_config = "cloudbuild_grpc_service_config.json",
+    importpath = "cloud.google.com/go/cloudbuild/apiv1;cloudbuild",
+    service_yaml = "cloudbuild_v1.yaml",
+    deps = [
+        ":cloudbuild_go_proto",
+        "//google/longrunning:longrunning_go_gapic",
+        "//google/longrunning:longrunning_go_proto",
+        "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
+    ],
+)
+
+go_test(
+    name = "cloudbuild_go_gapic_test",
+    srcs = [":cloudbuild_go_gapic_srcjar_test"],
+    embed = [":cloudbuild_go_gapic"],
+    importpath = "cloud.google.com/go/cloudbuild/apiv1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-devtools-cloudbuild-v1-go",
+    deps = [
+        ":cloudbuild_go_gapic",
+        ":cloudbuild_go_gapic_srcjar-test.srcjar",
+        ":cloudbuild_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "cloudbuild_moved_proto",
+    srcs = [":cloudbuild_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "cloudbuild_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":cloudbuild_moved_proto"],
+)
+
+py_grpc_library(
+    name = "cloudbuild_py_grpc",
+    srcs = [":cloudbuild_moved_proto"],
+    deps = [":cloudbuild_py_proto"],
+)
+
+py_gapic_library(
+    name = "cloudbuild_py_gapic",
+    src = ":cloudbuild_proto_with_info",
+    gapic_yaml = "cloudbuild_gapic.yaml",
+    package = "google.devtools.cloudbuild.v1",
+    service_yaml = "cloudbuild_v1.yaml",
+    deps = [
+        ":cloudbuild_py_grpc",
+        ":cloudbuild_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "devtools-cloudbuild-v1-py",
+    deps = [
+        ":cloudbuild_py_gapic",
+        ":cloudbuild_py_grpc",
+        ":cloudbuild_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "cloudbuild_php_proto",
+    deps = [":cloudbuild_proto"],
+)
+
+php_grpc_library(
+    name = "cloudbuild_php_grpc",
+    srcs = [":cloudbuild_proto"],
+    deps = [":cloudbuild_php_proto"],
+)
+
+# Add api.http options to all RPCs in the services to enable PHP GAPIC
+#php_gapic_library(
+#    name = "cloudbuild_php_gapic",
+#    src = ":cloudbuild_proto_with_info",
+#    gapic_yaml = "cloudbuild_gapic.yaml",
+#    package = "google.devtools.cloudbuild.v1",
+#    service_yaml = "cloudbuild_v1.yaml",
+#    deps = [
+#        ":cloudbuild_php_grpc",
+#        ":cloudbuild_php_proto",
+#    ],
+#)
+#
+## Open Source Packages
+#php_gapic_assembly_pkg(
+#    name = "google-cloud-devtools-cloudbuild-v1-php",
+#    deps = [
+#        ":cloudbuild_php_gapic",
+#        ":cloudbuild_php_grpc",
+#        ":cloudbuild_php_proto",
+#    ],
+#)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "cloudbuild_nodejs_gapic",
+    src = ":cloudbuild_proto_with_info",
+    gapic_yaml = "cloudbuild_gapic.yaml",
+    package = "google.devtools.cloudbuild.v1",
+    service_yaml = "cloudbuild_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "devtools-cloudbuild-v1-nodejs",
+    deps = [
+        ":cloudbuild_nodejs_gapic",
+        ":cloudbuild_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "cloudbuild_ruby_proto",
+    deps = [":cloudbuild_proto"],
+)
+
+ruby_grpc_library(
+    name = "cloudbuild_ruby_grpc",
+    srcs = [":cloudbuild_proto"],
+    deps = [":cloudbuild_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "cloudbuild_ruby_gapic",
+    src = ":cloudbuild_proto_with_info",
+    gapic_yaml = "cloudbuild_gapic.yaml",
+    package = "google.devtools.cloudbuild.v1",
+    service_yaml = "cloudbuild_v1.yaml",
+    deps = [
+        ":cloudbuild_ruby_grpc",
+        ":cloudbuild_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-devtools-cloudbuild-v1-ruby",
+    deps = [
+        ":cloudbuild_ruby_gapic",
+        ":cloudbuild_ruby_grpc",
+        ":cloudbuild_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "cloudbuild_csharp_proto",
+    deps = [":cloudbuild_proto"],
+)
+
+csharp_grpc_library(
+    name = "cloudbuild_csharp_grpc",
+    srcs = [":cloudbuild_proto"],
+    deps = [":cloudbuild_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "cloudbuild_csharp_gapic",
+    src = ":cloudbuild_proto_with_info",
+    gapic_yaml = "cloudbuild_gapic.yaml",
+    package = "google.devtools.cloudbuild.v1",
+    service_yaml = "cloudbuild_v1.yaml",
+    deps = [
+        ":cloudbuild_csharp_grpc",
+        ":cloudbuild_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-devtools-cloudbuild-v1-csharp",
+    deps = [
+        ":cloudbuild_csharp_gapic",
+        ":cloudbuild_csharp_grpc",
+        ":cloudbuild_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/devtools/cloudbuild/v1/cloudbuild.proto b/third_party/googleapis/google/devtools/cloudbuild/v1/cloudbuild.proto
index e3adace15..aedf05478 100644
--- a/third_party/googleapis/google/devtools/cloudbuild/v1/cloudbuild.proto
+++ b/third_party/googleapis/google/devtools/cloudbuild/v1/cloudbuild.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,19 +11,17 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.devtools.cloudbuild.v1;
 
 import "google/api/annotations.proto";
-import "google/api/httpbody.proto";
-import "google/cloud/audit/audit_log.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/empty.proto";
-import "google/protobuf/field_mask.proto";
 import "google/protobuf/timestamp.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/devtools/cloudbuild/v1;cloudbuild";
@@ -31,7 +29,6 @@ option java_multiple_files = true;
 option java_package = "com.google.cloudbuild.v1";
 option objc_class_prefix = "GCB";
 
-
 // Creates and manages builds on Google Cloud Platform.
 //
 // The main concept used by this API is a `Build`, which describes the location
@@ -41,6 +38,10 @@ option objc_class_prefix = "GCB";
 // A user can list previously-requested builds or get builds by their ID to
 // determine the status of the build.
 service CloudBuild {
+  option (google.api.default_host) = "cloudbuild.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform";
+
   // Starts a build with the specified configuration.
   //
   // This method returns a long-running `Operation`, which includes the build
@@ -51,6 +52,11 @@ service CloudBuild {
       post: "/v1/projects/{project_id}/builds"
       body: "build"
     };
+    option (google.api.method_signature) = "project_id,build";
+    option (google.longrunning.operation_info) = {
+      response_type: "Build"
+      metadata_type: "BuildOperationMetadata"
+    };
   }
 
   // Returns information about a previously requested build.
@@ -61,6 +67,7 @@ service CloudBuild {
     option (google.api.http) = {
       get: "/v1/projects/{project_id}/builds/{id}"
     };
+    option (google.api.method_signature) = "project_id,id";
   }
 
   // Lists previously requested builds.
@@ -71,6 +78,7 @@ service CloudBuild {
     option (google.api.http) = {
       get: "/v1/projects/{project_id}/builds"
     };
+    option (google.api.method_signature) = "project_id,filter";
   }
 
   // Cancels a build in progress.
@@ -79,6 +87,7 @@ service CloudBuild {
       post: "/v1/projects/{project_id}/builds/{id}:cancel"
       body: "*"
     };
+    option (google.api.method_signature) = "project_id,id";
   }
 
   // Creates a new build based on the specified build.
@@ -113,6 +122,11 @@ service CloudBuild {
       post: "/v1/projects/{project_id}/builds/{id}:retry"
       body: "*"
     };
+    option (google.api.method_signature) = "project_id,id";
+    option (google.longrunning.operation_info) = {
+      response_type: "Build"
+      metadata_type: "BuildOperationMetadata"
+    };
   }
 
   // Creates a new `BuildTrigger`.
@@ -123,6 +137,7 @@ service CloudBuild {
       post: "/v1/projects/{project_id}/triggers"
       body: "trigger"
     };
+    option (google.api.method_signature) = "project_id,trigger";
   }
 
   // Returns information about a `BuildTrigger`.
@@ -132,24 +147,29 @@ service CloudBuild {
     option (google.api.http) = {
       get: "/v1/projects/{project_id}/triggers/{trigger_id}"
     };
+    option (google.api.method_signature) = "project_id,trigger_id";
   }
 
   // Lists existing `BuildTrigger`s.
   //
   // This API is experimental.
-  rpc ListBuildTriggers(ListBuildTriggersRequest) returns (ListBuildTriggersResponse) {
+  rpc ListBuildTriggers(ListBuildTriggersRequest)
+      returns (ListBuildTriggersResponse) {
     option (google.api.http) = {
       get: "/v1/projects/{project_id}/triggers"
     };
+    option (google.api.method_signature) = "project_id";
   }
 
   // Deletes a `BuildTrigger` by its project ID and trigger ID.
   //
   // This API is experimental.
-  rpc DeleteBuildTrigger(DeleteBuildTriggerRequest) returns (google.protobuf.Empty) {
+  rpc DeleteBuildTrigger(DeleteBuildTriggerRequest)
+      returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v1/projects/{project_id}/triggers/{trigger_id}"
     };
+    option (google.api.method_signature) = "project_id,trigger_id";
   }
 
   // Updates a `BuildTrigger` by its project ID and trigger ID.
@@ -160,36 +180,70 @@ service CloudBuild {
       patch: "/v1/projects/{project_id}/triggers/{trigger_id}"
       body: "trigger"
     };
+    option (google.api.method_signature) = "project_id,trigger_id,trigger";
   }
 
   // Runs a `BuildTrigger` at a particular source revision.
-  rpc RunBuildTrigger(RunBuildTriggerRequest) returns (google.longrunning.Operation) {
+  rpc RunBuildTrigger(RunBuildTriggerRequest)
+      returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v1/projects/{project_id}/triggers/{trigger_id}:run"
       body: "source"
     };
+    option (google.api.method_signature) = "project_id,trigger_id,source";
+    option (google.longrunning.operation_info) = {
+      response_type: "Build"
+      metadata_type: "BuildOperationMetadata"
+    };
   }
+
+  // Creates a `WorkerPool` to run the builds, and returns the new worker pool.
+  //
+  // This API is experimental.
+  rpc CreateWorkerPool(CreateWorkerPoolRequest) returns (WorkerPool) {}
+
+  // Returns information about a `WorkerPool`.
+  //
+  // This API is experimental.
+  rpc GetWorkerPool(GetWorkerPoolRequest) returns (WorkerPool) {}
+
+  // Deletes a `WorkerPool` by its project ID and WorkerPool name.
+  //
+  // This API is experimental.
+  rpc DeleteWorkerPool(DeleteWorkerPoolRequest)
+      returns (google.protobuf.Empty) {}
+
+  // Update a `WorkerPool`.
+  //
+  // This API is experimental.
+  rpc UpdateWorkerPool(UpdateWorkerPoolRequest) returns (WorkerPool) {}
+
+  // List project's `WorkerPool`s.
+  //
+  // This API is experimental.
+  rpc ListWorkerPools(ListWorkerPoolsRequest)
+      returns (ListWorkerPoolsResponse) {}
 }
 
 // Specifies a build to retry.
 message RetryBuildRequest {
-  // ID of the project.
-  string project_id = 1;
+  // Required. ID of the project.
+  string project_id = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Build ID of the original build.
-  string id = 2;
+  // Required. Build ID of the original build.
+  string id = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Specifies a build trigger to run and the source to use.
 message RunBuildTriggerRequest {
-  // ID of the project.
-  string project_id = 1;
+  // Required. ID of the project.
+  string project_id = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // ID of the trigger.
-  string trigger_id = 2;
+  // Required. ID of the trigger.
+  string trigger_id = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Source to build against this trigger.
-  RepoSource source = 3;
+  // Required. Source to build against this trigger.
+  RepoSource source = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Location of the source in an archive file in Google Cloud Storage.
@@ -216,17 +270,22 @@ message RepoSource {
   // project ID requesting the build is assumed.
   string project_id = 1;
 
-  // Name of the Cloud Source Repository. If omitted, the name "default" is
-  // assumed.
+  // Required. Name of the Cloud Source Repository.
   string repo_name = 2;
 
   // A revision within the Cloud Source Repository must be specified in
   // one of these ways.
   oneof revision {
-    // Name of the branch to build.
+    // Regex matching branches to build.
+    //
+    // The syntax of the regular expressions accepted is the syntax accepted by
+    // RE2 and described at https://github.com/google/re2/wiki/Syntax
     string branch_name = 3;
 
-    // Name of the tag to build.
+    // Regex matching tags to build.
+    //
+    // The syntax of the regular expressions accepted is the syntax accepted by
+    // RE2 and described at https://github.com/google/re2/wiki/Syntax
     string tag_name = 4;
 
     // Explicit commit SHA to build.
@@ -238,6 +297,14 @@ message RepoSource {
   // This must be a relative path. If a step's `dir` is specified and is an
   // absolute path, this value is ignored for that step's execution.
   string dir = 7;
+
+  // Only trigger a build if the revision regex does NOT match the revision
+  // regex.
+  bool invert_regex = 8;
+
+  // Substitutions to use in a triggered build.
+  // Should only be used with RunBuildTrigger
+  map substitutions = 9;
 }
 
 // Location of the source in a supported storage service.
@@ -263,7 +330,7 @@ message BuiltImage {
   string digest = 3;
 
   // Output only. Stores timing information for pushing the specified image.
-  TimeSpan push_timing = 4;
+  TimeSpan push_timing = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // A step in the build pipeline.
@@ -344,7 +411,7 @@ message BuildStep {
   repeated Volume volumes = 9;
 
   // Output only. Stores timing information for executing this build step.
-  TimeSpan timing = 10;
+  TimeSpan timing = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Stores timing information for pulling this build step's
   // builder image only.
@@ -399,6 +466,9 @@ message Results {
   // can produce this output by writing to `$BUILDER_OUTPUT/output`.
   // Only the first 4KB of data is stored.
   repeated bytes build_step_outputs = 6;
+
+  // Time to push all non-container artifacts.
+  TimeSpan artifact_timing = 7;
 }
 
 // An artifact that was uploaded during a build. This
@@ -456,13 +526,16 @@ message Build {
 
     // Build or step was canceled by a user.
     CANCELLED = 7;
+
+    // Build was enqueued for longer than the value of `queue_ttl`.
+    EXPIRED = 9;
   }
 
   // Output only. Unique identifier of the build.
-  string id = 1;
+  string id = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. ID of the project.
-  string project_id = 16;
+  string project_id = 16 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Status of the build.
   Status status = 2;
@@ -477,19 +550,22 @@ message Build {
   repeated BuildStep steps = 11;
 
   // Output only. Results of the build.
-  Results results = 10;
+  Results results = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Time at which the request to create the build was received.
-  google.protobuf.Timestamp create_time = 6;
+  google.protobuf.Timestamp create_time = 6
+      [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Time at which execution of the build was started.
-  google.protobuf.Timestamp start_time = 7;
+  google.protobuf.Timestamp start_time = 7
+      [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Time at which execution of the build was finished.
   //
   // The difference between finish_time and start_time is the duration of the
   // build's execution.
-  google.protobuf.Timestamp finish_time = 8;
+  google.protobuf.Timestamp finish_time = 8
+      [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Amount of time that this build should be allowed to run, to second
   // granularity. If this amount of time elapses, work on the build will cease
@@ -510,6 +586,13 @@ message Build {
   // `FAILURE`.
   repeated string images = 13;
 
+  // TTL in queue for this build. If provided and the build is enqueued longer
+  // than this value, the build will expire and the build status will be
+  // `EXPIRED`.
+  //
+  // The TTL starts ticking from create_time.
+  google.protobuf.Duration queue_ttl = 40;
+
   // Artifacts produced by the build that should be uploaded upon
   // successful completion of all build steps.
   Artifacts artifacts = 37;
@@ -531,7 +614,7 @@ message Build {
   BuildOptions options = 23;
 
   // Output only. URL to logs for this build in Google Cloud Console.
-  string log_url = 25;
+  string log_url = 25 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Substitutions data for `Build` resource.
   map substitutions = 29;
@@ -551,7 +634,7 @@ message Build {
   //
   // If the build does not specify source or images,
   // these keys will not be included.
-  map timing = 33;
+  map timing = 33 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Artifacts produced by a build that should be uploaded upon
@@ -627,8 +710,8 @@ message SourceProvenance {
   RepoSource resolved_repo_source = 6;
 
   // Output only. Hash(es) of the build source, which can be used to verify that
-  // the originalsource integrity was maintained in the build. Note that
-  // `FileHashes` willonly be populated if `BuildOptions` has requested a
+  // the original source integrity was maintained in the build. Note that
+  // `FileHashes` will only be populated if `BuildOptions` has requested a
   // `SourceProvenanceHash`.
   //
   // The keys to this map are file paths used as build source and the values
@@ -636,7 +719,8 @@ message SourceProvenance {
   //
   // If the build source came in a single package such as a gzipped tarfile
   // (`.tar.gz`), the `FileHash` will be for the single path to that file.
-  map file_hashes = 4;
+  map file_hashes = 4
+      [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Container message for hashes of byte content of files, used in
@@ -684,26 +768,26 @@ message Secret {
 
 // Request to create a new build.
 message CreateBuildRequest {
-  // ID of the project.
-  string project_id = 1;
+  // Required. ID of the project.
+  string project_id = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Build resource to create.
-  Build build = 2;
+  // Required. Build resource to create.
+  Build build = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request to get a build.
 message GetBuildRequest {
-  // ID of the project.
-  string project_id = 1;
+  // Required. ID of the project.
+  string project_id = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // ID of the build.
-  string id = 2;
+  // Required. ID of the build.
+  string id = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request to list builds.
 message ListBuildsRequest {
-  // ID of the project.
-  string project_id = 1;
+  // Required. ID of the project.
+  string project_id = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Number of results to return in the list.
   int32 page_size = 2;
@@ -726,29 +810,48 @@ message ListBuildsResponse {
 
 // Request to cancel an ongoing build.
 message CancelBuildRequest {
-  // ID of the project.
-  string project_id = 1;
+  // Required. ID of the project.
+  string project_id = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // ID of the build.
-  string id = 2;
+  // Required. ID of the build.
+  string id = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Configuration for an automated build in response to source repository
 // changes.
 message BuildTrigger {
   // Output only. Unique identifier of the trigger.
-  string id = 1;
+  string id = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Human-readable description of this trigger.
   string description = 10;
 
+  // User-assigned name of the trigger. Must be unique within the project.
+  // Trigger names must meet the following requirements:
+  //
+  // + They must contain only alphanumeric characters and dashes.
+  // + They can be 1-64 characters long.
+  // + They must begin and end with an alphanumeric character.
+  string name = 21;
+
+  // Tags for annotation of a `BuildTrigger`
+  repeated string tags = 19;
+
   // Template describing the types of source changes to trigger a build.
   //
   // Branch and tag names in trigger templates are interpreted as regular
   // expressions. Any branch or tag change that matches that regular expression
   // will trigger a build.
+  //
+  // Mutually exclusive with `github`.
   RepoSource trigger_template = 7;
 
+  // GitHubEventsConfig describes the configuration of a trigger that creates
+  // a build whenever a GitHub event is received.
+  //
+  // Mutually exclusive with `trigger_template`.
+  GitHubEventsConfig github = 13;
+
   // Template describing the Build request to make when the trigger is matched.
   oneof build_template {
     // Contents of the build template.
@@ -760,16 +863,19 @@ message BuildTrigger {
   }
 
   // Output only. Time when the trigger was created.
-  google.protobuf.Timestamp create_time = 5;
+  google.protobuf.Timestamp create_time = 5
+      [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // If true, the trigger will never result in a build.
   bool disabled = 9;
 
-  // Substitutions data for Build resource.
+  // Substitutions for Build resource. The keys must match the following
+  // regular expression: `^_[A-Z0-9_]+$`.The keys cannot conflict with the
+  // keys in bindings.
   map substitutions = 11;
 
   // ignored_files and included_files are file glob matches using
-  // http://godoc/pkg/path/filepath#Match extended with support for "**".
+  // https://golang.org/pkg/path/filepath/#Match extended with support for "**".
   //
   // If ignored_files and changed files are both empty, then they are
   // not used to determine whether or not to trigger a build.
@@ -790,55 +896,146 @@ message BuildTrigger {
   repeated string included_files = 16;
 }
 
+// GitHubEventsConfig describes the configuration of a trigger that creates a
+// build whenever a GitHub event is received.
+//
+// This message is experimental.
+message GitHubEventsConfig {
+  // The installationID that emits the GitHub event.
+  int64 installation_id = 1 [deprecated = true];
+
+  // Owner of the repository. For example: The owner for
+  // https://github.com/googlecloudplatform/cloud-builders is
+  // "googlecloudplatform".
+  string owner = 6;
+
+  // Name of the repository. For example: The name for
+  // https://github.com/googlecloudplatform/cloud-builders is "cloud-builders".
+  string name = 7;
+
+  // Filter describing the types of events to trigger a build.
+  // Currently supported event types: push, pull_request.
+  oneof event {
+    // filter to match changes in pull requests.
+    PullRequestFilter pull_request = 4;
+
+    // filter to match changes in refs like branches, tags.
+    PushFilter push = 5;
+  }
+}
+
+// PullRequestFilter contains filter properties for matching GitHub Pull
+// Requests.
+message PullRequestFilter {
+  // Controls behavior of Pull Request comments.
+  enum CommentControl {
+    // Do not require comments on Pull Requests before builds are triggered.
+    COMMENTS_DISABLED = 0;
+
+    // Enforce that repository owners or collaborators must comment on Pull
+    // Requests before builds are triggered.
+    COMMENTS_ENABLED = 1;
+  }
+
+  // Target refs to match.
+  // A target ref is the git reference where the pull request will be applied.
+  oneof git_ref {
+    // Regex of branches to match.
+    //
+    // The syntax of the regular expressions accepted is the syntax accepted by
+    // RE2 and described at https://github.com/google/re2/wiki/Syntax
+    string branch = 2;
+  }
+
+  // Whether to block builds on a "/gcbrun" comment from a repository admin or
+  // collaborator.
+  CommentControl comment_control = 5;
+
+  // If true, branches that do NOT match the git_ref will trigger a build.
+  bool invert_regex = 6;
+}
+
+// Push contains filter properties for matching GitHub git pushes.
+message PushFilter {
+  // Modified refs to match.
+  // A modified refs are the refs modified by a git push operation.
+  oneof git_ref {
+    // Regexes matching branches to build.
+    //
+    // The syntax of the regular expressions accepted is the syntax accepted by
+    // RE2 and described at https://github.com/google/re2/wiki/Syntax
+    string branch = 2;
+
+    // Regexes matching tags to build.
+    //
+    // The syntax of the regular expressions accepted is the syntax accepted by
+    // RE2 and described at https://github.com/google/re2/wiki/Syntax
+    string tag = 3;
+  }
+
+  // When true, only trigger a build if the revision regex does NOT match the
+  // git_ref regex.
+  bool invert_regex = 4;
+}
+
 // Request to create a new `BuildTrigger`.
 message CreateBuildTriggerRequest {
-  // ID of the project for which to configure automatic builds.
-  string project_id = 1;
+  // Required. ID of the project for which to configure automatic builds.
+  string project_id = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // `BuildTrigger` to create.
-  BuildTrigger trigger = 2;
+  // Required. `BuildTrigger` to create.
+  BuildTrigger trigger = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Returns the `BuildTrigger` with the specified ID.
 message GetBuildTriggerRequest {
-  // ID of the project that owns the trigger.
-  string project_id = 1;
+  // Required. ID of the project that owns the trigger.
+  string project_id = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // ID of the `BuildTrigger` to get.
-  string trigger_id = 2;
+  // Required. Identifier (`id` or `name`) of the `BuildTrigger` to get.
+  string trigger_id = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request to list existing `BuildTriggers`.
 message ListBuildTriggersRequest {
-  // ID of the project for which to list BuildTriggers.
-  string project_id = 1;
+  // Required. ID of the project for which to list BuildTriggers.
+  string project_id = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Number of results to return in the list.
+  int32 page_size = 2;
+
+  // Token to provide to skip to a particular spot in the list.
+  string page_token = 3;
 }
 
 // Response containing existing `BuildTriggers`.
 message ListBuildTriggersResponse {
   // `BuildTriggers` for the project, sorted by `create_time` descending.
   repeated BuildTrigger triggers = 1;
+
+  // Token to receive the next page of results.
+  string next_page_token = 2;
 }
 
 // Request to delete a `BuildTrigger`.
 message DeleteBuildTriggerRequest {
-  // ID of the project that owns the trigger.
-  string project_id = 1;
+  // Required. ID of the project that owns the trigger.
+  string project_id = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // ID of the `BuildTrigger` to delete.
-  string trigger_id = 2;
+  // Required. ID of the `BuildTrigger` to delete.
+  string trigger_id = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request to update an existing `BuildTrigger`.
 message UpdateBuildTriggerRequest {
-  // ID of the project that owns the trigger.
-  string project_id = 1;
+  // Required. ID of the project that owns the trigger.
+  string project_id = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // ID of the `BuildTrigger` to update.
-  string trigger_id = 2;
+  // Required. ID of the `BuildTrigger` to update.
+  string trigger_id = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // `BuildTrigger` to update.
-  BuildTrigger trigger = 3;
+  // Required. `BuildTrigger` to update.
+  BuildTrigger trigger = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Optional arguments to enable specific features of builds.
@@ -925,9 +1122,10 @@ message BuildOptions {
   // Storage.
   LogStreamingOption log_streaming_option = 5;
 
-  // Option to specify a `WorkerPool` for the build. User specifies the pool
-  // with the format "[WORKERPOOL_PROJECT_ID]/[WORKERPOOL_NAME]".
-  // This is an experimental field.
+  // Option to specify a `WorkerPool` for the build.
+  // Format: projects/{project}/workerPools/{workerPool}
+  //
+  // This field is experimental.
   string worker_pool = 7;
 
   // Option to specify the logging mode, which determines where the logs are
@@ -959,3 +1157,184 @@ message BuildOptions {
   // it is indicative of a build request with an incorrect configuration.
   repeated Volume volumes = 14;
 }
+
+// Configuration for a WorkerPool to run the builds.
+//
+// Workers are machines that Cloud Build uses to run your builds. By default,
+// all workers run in a project owned by Cloud Build. To have full control over
+// the workers that execute your builds -- such as enabling them to access
+// private resources on your private network -- you can request Cloud Build to
+// run the workers in your own project by creating a custom workers pool.
+message WorkerPool {
+  // Supported GCP regions to create the `WorkerPool`.
+  enum Region {
+    // no region
+    REGION_UNSPECIFIED = 0;
+
+    // us-central1 region
+    US_CENTRAL1 = 1;
+
+    // us-west1 region
+    US_WEST1 = 2;
+
+    // us-east1 region
+    US_EAST1 = 3;
+
+    // us-east4 region
+    US_EAST4 = 4;
+  }
+
+  // `WorkerPool` status
+  enum Status {
+    // Status of the `WorkerPool` is unknown.
+    STATUS_UNSPECIFIED = 0;
+
+    // `WorkerPool` is being created.
+    CREATING = 1;
+
+    // `WorkerPool` is running.
+    RUNNING = 2;
+
+    // `WorkerPool` is being deleted: cancelling builds and draining workers.
+    DELETING = 3;
+
+    // `WorkerPool` is deleted.
+    DELETED = 4;
+  }
+
+  // User-defined name of the `WorkerPool`.
+  string name = 14;
+
+  // The project ID of the GCP project for which the `WorkerPool` is created.
+  string project_id = 2;
+
+  // Output only. The service account used to manage the `WorkerPool`. The
+  // service account must have the Compute Instance Admin (Beta) permission at
+  // the project level.
+  string service_account_email = 3;
+
+  // Total number of workers to be created across all requested regions.
+  int64 worker_count = 4;
+
+  // Configuration to be used for a creating workers in the `WorkerPool`.
+  WorkerConfig worker_config = 16;
+
+  // List of regions to create the `WorkerPool`. Regions can't be empty.
+  // If Cloud Build adds a new GCP region in the future, the existing
+  // `WorkerPool` will not be enabled in the new region automatically;
+  // you must add the new region to the `regions` field to enable the
+  // `WorkerPool` in that region.
+  repeated Region regions = 9;
+
+  // Output only. Time at which the request to create the `WorkerPool` was
+  // received.
+  google.protobuf.Timestamp create_time = 11;
+
+  // Output only. Time at which the request to update the `WorkerPool` was
+  // received.
+  google.protobuf.Timestamp update_time = 17;
+
+  // Output only. Time at which the request to delete the `WorkerPool` was
+  // received.
+  google.protobuf.Timestamp delete_time = 12;
+
+  // Output only. WorkerPool Status.
+  Status status = 13;
+}
+
+// WorkerConfig defines the configuration to be used for a creating workers in
+// the pool.
+message WorkerConfig {
+  // Machine Type of the worker, such as n1-standard-1.
+  // See https://cloud.google.com/compute/docs/machine-types.
+  // If left blank, Cloud Build will use a standard unspecified machine to
+  // create the worker pool.
+  // `machine_type` is overridden if you specify a different machine type in
+  // `build_options`. In this case, the VM specified in the `build_options`
+  // will be created on demand at build time. For more information see
+  // https://cloud.google.com/cloud-build/docs/speeding-up-builds#using_custom_virtual_machine_sizes
+  string machine_type = 1;
+
+  // Size of the disk attached to the worker, in GB.
+  // See https://cloud.google.com/compute/docs/disks/
+  // If `0` is specified, Cloud Build will use a standard disk size.
+  // `disk_size` is overridden if you specify a different disk size in
+  // `build_options`. In this case, a VM with a disk size specified in the
+  // `build_options` will be created on demand at build time. For more
+  // information see
+  // https://cloud.google.com/cloud-build/docs/api/reference/rest/v1/projects.builds#buildoptions
+  int64 disk_size_gb = 2;
+
+  // The network definition used to create the worker.
+  // If this section is left empty, the workers will be created in
+  // WorkerPool.project_id on the default network.
+  Network network = 3;
+
+  // The tag applied to the worker, and the same tag used by the firewall rule.
+  // It is used to identify the Cloud Build workers among other VMs.
+  // The default value for tag is `worker`.
+  string tag = 4;
+}
+
+// Network describes the GCP network used to create workers in.
+message Network {
+  // Project id containing the defined network and subnetwork. For a peered VPC,
+  // this will be the same as the project_id in which the workers are created.
+  // For a shared VPC, this will be the project sharing the network with the
+  // project_id project in which workers will be created. For custom workers
+  // with no VPC, this will be the same as project_id.
+  string project_id = 1;
+
+  // Network on which the workers are created.
+  // "default" network is used if empty.
+  string network = 2;
+
+  // Subnetwork on which the workers are created.
+  // "default" subnetwork is used if empty.
+  string subnetwork = 3;
+}
+
+// Request to create a new `WorkerPool`.
+message CreateWorkerPoolRequest {
+  // ID of the parent project.
+  string parent = 1;
+
+  // `WorkerPool` resource to create.
+  WorkerPool worker_pool = 2;
+}
+
+// Request to get a `WorkerPool` with the specified name.
+message GetWorkerPoolRequest {
+  // The field will contain name of the resource requested, for example:
+  // "projects/project-1/workerPools/workerpool-name"
+  string name = 1;
+}
+
+// Request to delete a `WorkerPool`.
+message DeleteWorkerPoolRequest {
+  // The field will contain name of the resource requested, for example:
+  // "projects/project-1/workerPools/workerpool-name"
+  string name = 1;
+}
+
+// Request to update a `WorkerPool`.
+message UpdateWorkerPoolRequest {
+  // The field will contain name of the resource requested, for example:
+  // "projects/project-1/workerPools/workerpool-name"
+  string name = 2;
+
+  // `WorkerPool` resource to update.
+  WorkerPool worker_pool = 3;
+}
+
+// Request to list `WorkerPool`s.
+message ListWorkerPoolsRequest {
+  // ID of the parent project.
+  string parent = 1;
+}
+
+// Response containing existing `WorkerPools`.
+message ListWorkerPoolsResponse {
+  // `WorkerPools` for the project.
+  repeated WorkerPool worker_pools = 1;
+}
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1alpha1/containeranalysis_gapic.yaml b/third_party/googleapis/google/devtools/cloudbuild/v1/cloudbuild_gapic.legacy.yaml
similarity index 61%
rename from third_party/googleapis/google/devtools/containeranalysis/v1alpha1/containeranalysis_gapic.yaml
rename to third_party/googleapis/google/devtools/cloudbuild/v1/cloudbuild_gapic.legacy.yaml
index 30c5abc92..69c9bbf13 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1alpha1/containeranalysis_gapic.yaml
+++ b/third_party/googleapis/google/devtools/cloudbuild/v1/cloudbuild_gapic.legacy.yaml
@@ -3,23 +3,25 @@ config_schema_version: 1.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
-    package_name: com.google.cloud.devtools.containeranalysis.v1alpha1
+    package_name: com.google.cloud.devtools.cloudbuild.v1
   python:
-    package_name: google.cloud.devtools.containeranalysis_v1alpha1.gapic
+    package_name: google.cloud.devtools.cloudbuild_v1.gapic
   go:
-    package_name: cloud.google.com/go/devtools/containeranalysis/apiv1alpha1
+    package_name: cloud.google.com/go/cloudbuild/apiv1
+    release_level: GA
   csharp:
-    package_name: Google.Devtools.Containeranalysis.V1Alpha1
+    package_name: Google.Devtools.Cloudbuild.V1
   ruby:
-    package_name: Google::Cloud::Devtools::Containeranalysis::V1alpha1
+    package_name: Google::Cloud::Devtools::Cloudbuild::V1
   php:
-    package_name: Google\Cloud\Devtools\Containeranalysis\V1alpha1
+    package_name: Google\Cloud\Devtools\Cloudbuild\V1
   nodejs:
-    package_name: containeranalysis.v1alpha1
+    package_name: cloudbuild.v1
+    domain_layer_location: google-cloud
 # A list of API interface configurations.
 interfaces:
-# The fully qualified name of the API interface.
-- name: google.devtools.containeranalysis.v1alpha1.ContainerAnalysis
+  # The fully qualified name of the API interface.
+- name: google.devtools.cloudbuild.v1.CloudBuild
   # A list of resource collection configurations.
   # Consists of a name_pattern and an entity_name.
   # The name_pattern is a pattern to describe the names of the resources of this
@@ -30,16 +32,7 @@ interfaces:
   # methods. If empty, no name methods are generated.
   # The entity_name is the name to be used as a basis for generated methods and
   # classes.
-  collections:
-  - name_pattern: projects/{project}
-    entity_name: project
-    language_overrides:
-    - language: csharp
-      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
-  - name_pattern: projects/{project}/notes/{note}
-    entity_name: note
-  - name_pattern: projects/{project}/occurrences/{occurrence}
-    entity_name: occurrence
+  collections: []
   # Definition for retryable codes.
   retry_codes_def:
   - name: idempotent
@@ -107,230 +100,143 @@ interfaces:
   #   timeout_millis - Specifies the default timeout for a non-retrying call. If
   #       the call is retrying, refer to retry_params_name instead.
   methods:
-  - name: GetOccurrence
+  - name: CreateBuild
     flattening:
       groups:
       - parameters:
-        - name
+        - project_id
+        - build
     required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: occurrence
-    timeout_millis: 60000
-  - name: ListOccurrences
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: occurrences
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: project
-    timeout_millis: 60000
-  - name: DeleteOccurrence
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: occurrence
-    timeout_millis: 60000
-  - name: CreateOccurrence
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - occurrence
-    required_fields:
-    - parent
-    - occurrence
+    - project_id
+    - build
     retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      parent: project
     timeout_millis: 60000
-  - name: UpdateOccurrence
+  - name: GetBuild
     flattening:
       groups:
       - parameters:
-        - name
-        - occurrence
+        - project_id
+        - id
     required_fields:
-    - name
-    - occurrence
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: occurrence
-    timeout_millis: 60000
-  - name: GetOccurrenceNote
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
+    - project_id
+    - id
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: occurrence
     timeout_millis: 60000
-  - name: GetNote
+  - name: ListBuilds
     flattening:
       groups:
       - parameters:
-        - name
+        - project_id
+        - filter
     required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: note
-    timeout_millis: 60000
-  - name: ListNotes
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
+    - project_id
     page_streaming:
       request:
         page_size_field: page_size
         token_field: page_token
       response:
         token_field: next_page_token
-        resources_field: notes
+        resources_field: builds
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      parent: project
     timeout_millis: 60000
-  - name: DeleteNote
+  - name: CancelBuild
     flattening:
       groups:
       - parameters:
-        - name
+        - project_id
+        - id
     required_fields:
-    - name
-    retry_codes_name: idempotent
+    - project_id
+    - id
+    retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: note
     timeout_millis: 60000
-  - name: CreateNote
+  - name: CreateBuildTrigger
     flattening:
       groups:
       - parameters:
-        - parent
-        - note_id
-        - note
+        - project_id
+        - trigger
     required_fields:
-    - parent
-    - note_id
-    - note
+    - project_id
+    - trigger
     retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      parent: project
     timeout_millis: 60000
-  - name: UpdateNote
+  - name: GetBuildTrigger
     flattening:
       groups:
       - parameters:
-        - name
-        - note
+        - project_id
+        - trigger_id
     required_fields:
-    - name
-    - note
-    retry_codes_name: non_idempotent
+    - project_id
+    - trigger_id
+    retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: note
     timeout_millis: 60000
-  - name: ListNoteOccurrences
+  - name: ListBuildTriggers
     flattening:
       groups:
       - parameters:
-        - name
+        - project_id
     required_fields:
-    - name
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: occurrences
+    - project_id
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: note
     timeout_millis: 60000
-  - name: GetVulnzOccurrencesSummary
+  - name: DeleteBuildTrigger
     flattening:
       groups:
       - parameters:
-        - parent
+        - project_id
+        - trigger_id
     required_fields:
-    - parent
+    - project_id
+    - trigger_id
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      parent: project
     timeout_millis: 60000
-  - name: SetIamPolicy
+  - name: UpdateBuildTrigger
     flattening:
       groups:
       - parameters:
-        - resource
-        - policy
+        - project_id
+        - trigger_id
+        - trigger
     required_fields:
-    - resource
-    - policy
+    - project_id
+    - trigger_id
+    - trigger
     retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      resource: note
     timeout_millis: 60000
-  - name: GetIamPolicy
+  - name: RunBuildTrigger
     flattening:
       groups:
       - parameters:
-        - resource
+        - project_id
+        - trigger_id
+        - source
     required_fields:
-    - resource
+    - project_id
+    - trigger_id
+    - source
     retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      resource: note
     timeout_millis: 60000
-  - name: TestIamPermissions
+  - name: RetryBuild
     flattening:
       groups:
       - parameters:
-        - resource
-        - permissions
+        - project_id
+        - id
     required_fields:
-    - resource
-    - permissions
+    - project_id
+    - id
     retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      resource: note
     timeout_millis: 60000
diff --git a/third_party/googleapis/google/devtools/cloudbuild/v1/cloudbuild_gapic.yaml b/third_party/googleapis/google/devtools/cloudbuild/v1/cloudbuild_gapic.yaml
index 7b7d8c00c..7224ee027 100644
--- a/third_party/googleapis/google/devtools/cloudbuild/v1/cloudbuild_gapic.yaml
+++ b/third_party/googleapis/google/devtools/cloudbuild/v1/cloudbuild_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -7,7 +7,8 @@ language_settings:
   python:
     package_name: google.cloud.devtools.cloudbuild_v1.gapic
   go:
-    package_name: cloud.google.com/go/devtools/cloudbuild/apiv1
+    package_name: cloud.google.com/go/cloudbuild/apiv1
+    release_level: GA
   csharp:
     package_name: Google.Devtools.Cloudbuild.V1
   ruby:
@@ -16,120 +17,13 @@ language_settings:
     package_name: Google\Cloud\Devtools\Cloudbuild\V1
   nodejs:
     package_name: cloudbuild.v1
+    domain_layer_location: google-cloud
 # A list of API interface configurations.
 interfaces:
   # The fully qualified name of the API interface.
 - name: google.devtools.cloudbuild.v1.CloudBuild
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections: []
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #   name - The simple name of the method.
-  #   flattening - Specifies the configuration for parameter flattening.
-  #       Describes the parameter groups for which a generator should produce
-  #       method overloads which allow a client to directly pass request message
-  #       fields as method parameters. This information may or may not be used,
-  #       depending on the target language.
-  #       Consists of groups, which each represent a list of parameters to be
-  #       flattened. Each parameter listed must be a field of the request
-  #       message.
-  #   required_fields - Fields that are always required for a request to be
-  #       valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the
-  #       resource name formats defined in the field_name_patterns
-  #       and response_field_name_patterns fields.
-  #       UNSET: default value
-  #       NONE: the collection configs will not be used by the generated code.
-  #       VALIDATE: string fields will be validated by the client against the
-  #           specified resource name formats.
-  #       STATIC_TYPES: the client will use generated types for resource names.
-  #   page_streaming - Specifies the configuration for paging.
-  #       Describes information for generating a method which transforms a
-  #       paging list RPC into a stream of resources.
-  #       Consists of a request and a response.
-  #       The request specifies request information of the list method. It
-  #       defines which fields match the paging pattern in the request. The
-  #       request consists of a page_size_field and a token_field. The
-  #       page_size_field is the name of the optional field specifying the
-  #       maximum number of elements to be returned in the response. The
-  #       token_field is the name of the field in the request containing the
-  #       page token.
-  #       The response specifies response information of the list method. It
-  #       defines which fields match the paging pattern in the response. The
-  #       response consists of a token_field and a resources_field. The
-  #       token_field is the name of the field in the response containing the
-  #       next page token. The resources_field is the name of the field in the
-  #       response containing the list of resources belonging to the page.
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #       name must be defined in interfaces.retry_codes_def.
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #       parameters. The name must be defined in interfaces.retry_params_def.
-  #   field_name_patterns - Maps the field name of the request type to
-  #       entity_name of interfaces.collections.
-  #       Specifies the string pattern that the field must follow.
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #       the call is retrying, refer to retry_params_name instead.
   methods:
-  - name: CreateBuild
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - build
-    required_fields:
-    - project_id
-    - build
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-  - name: GetBuild
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - id
-    required_fields:
-    - project_id
-    - id
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 60000
   - name: ListBuilds
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - filter
-    required_fields:
-    - project_id
     page_streaming:
       request:
         page_size_field: page_size
@@ -137,104 +31,5 @@ interfaces:
       response:
         token_field: next_page_token
         resources_field: builds
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-  - name: CancelBuild
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - id
-    required_fields:
-    - project_id
-    - id
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-  - name: CreateBuildTrigger
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - trigger
-    required_fields:
-    - project_id
-    - trigger
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-  - name: GetBuildTrigger
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - trigger_id
-    required_fields:
-    - project_id
-    - trigger_id
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-  - name: ListBuildTriggers
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-    required_fields:
-    - project_id
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 60000
   - name: DeleteBuildTrigger
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - trigger_id
-    required_fields:
-    - project_id
-    - trigger_id
     retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-  - name: UpdateBuildTrigger
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - trigger_id
-        - trigger
-    required_fields:
-    - project_id
-    - trigger_id
-    - trigger
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-  - name: RunBuildTrigger
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - trigger_id
-        - source
-    required_fields:
-    - project_id
-    - trigger_id
-    - source
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-  - name: RetryBuild
-    flattening:
-      groups:
-      - parameters:
-        - project_id
-        - id
-    required_fields:
-    - project_id
-    - id
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
diff --git a/third_party/googleapis/google/devtools/cloudbuild/v1/cloudbuild_grpc_service_config.json b/third_party/googleapis/google/devtools/cloudbuild/v1/cloudbuild_grpc_service_config.json
new file mode 100755
index 000000000..30032d00a
--- /dev/null
+++ b/third_party/googleapis/google/devtools/cloudbuild/v1/cloudbuild_grpc_service_config.json
@@ -0,0 +1,67 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.devtools.cloudbuild.v1.CloudBuild",
+          "method": "GetBuild"
+        },
+        {
+          "service": "google.devtools.cloudbuild.v1.CloudBuild",
+          "method": "ListBuilds"
+        },
+        {
+          "service": "google.devtools.cloudbuild.v1.CloudBuild",
+          "method": "GetBuildTrigger"
+        },
+        {
+          "service": "google.devtools.cloudbuild.v1.CloudBuild",
+          "method": "ListBuildTriggers"
+        },
+        {
+          "service": "google.devtools.cloudbuild.v1.CloudBuild",
+          "method": "DeleteBuildTrigger"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.devtools.cloudbuild.v1.CloudBuild",
+          "method": "CreateBuild"
+        },
+        {
+          "service": "google.devtools.cloudbuild.v1.CloudBuild",
+          "method": "CancelBuild"
+        },
+        {
+          "service": "google.devtools.cloudbuild.v1.CloudBuild",
+          "method": "CreateBuildTrigger"
+        },
+        {
+          "service": "google.devtools.cloudbuild.v1.CloudBuild",
+          "method": "UpdateBuildTrigger"
+        },
+        {
+          "service": "google.devtools.cloudbuild.v1.CloudBuild",
+          "method": "RunBuildTrigger"
+        },
+        {
+          "service": "google.devtools.cloudbuild.v1.CloudBuild",
+          "method": "RetryBuild"
+        }
+      ],
+      "timeout": "600s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/devtools/cloudbuild/v1/cloudbuild_v1.yaml b/third_party/googleapis/google/devtools/cloudbuild/v1/cloudbuild_v1.yaml
new file mode 100644
index 000000000..12efdd2a5
--- /dev/null
+++ b/third_party/googleapis/google/devtools/cloudbuild/v1/cloudbuild_v1.yaml
@@ -0,0 +1,54 @@
+type: google.api.Service
+config_version: 3
+name: cloudbuild.googleapis.com
+title: Cloud Build API
+
+apis:
+- name: google.devtools.cloudbuild.v1.CloudBuild
+
+types:
+- name: google.devtools.cloudbuild.v1.ArtifactResult
+- name: google.devtools.cloudbuild.v1.BuildOperationMetadata
+
+documentation:
+  summary: Creates and manages builds on Google Cloud Platform.
+  overview: |-
+    The Cloud Build API lets you to build an application or part of an
+    application from source code stored in Cloud Storage, Cloud Source
+    Repository, or GitHub, and package it into container images or artifacts.
+    The images are then stored in Container Registry and the artifacts are
+    stored in Cloud Storage.
+
+backend:
+  rules:
+  - selector: 'google.devtools.cloudbuild.v1.CloudBuild.*'
+    deadline: 5.0
+  - selector: google.devtools.cloudbuild.v1.CloudBuild.CreateBuild
+    deadline: 60.0
+  - selector: google.devtools.cloudbuild.v1.CloudBuild.CreateBuildTrigger
+    deadline: 60.0
+  - selector: google.devtools.cloudbuild.v1.CloudBuild.CreateWorkerPool
+    deadline: 320.0
+  - selector: google.devtools.cloudbuild.v1.CloudBuild.DeleteWorkerPool
+    deadline: 320.0
+  - selector: google.devtools.cloudbuild.v1.CloudBuild.ListBuilds
+    deadline: 20.0
+  - selector: google.devtools.cloudbuild.v1.CloudBuild.RetryBuild
+    deadline: 60.0
+  - selector: google.devtools.cloudbuild.v1.CloudBuild.RunBuildTrigger
+    deadline: 180.0
+  - selector: google.devtools.cloudbuild.v1.CloudBuild.UpdateWorkerPool
+    deadline: 20.0
+  - selector: 'google.longrunning.Operations.*'
+    deadline: 5.0
+
+authentication:
+  rules:
+  - selector: 'google.devtools.cloudbuild.v1.CloudBuild.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/devtools/clouddebugger/BUILD.bazel b/third_party/googleapis/google/devtools/clouddebugger/BUILD.bazel
index 1e5b8c2af..a87c57fec 100644
--- a/third_party/googleapis/google/devtools/clouddebugger/BUILD.bazel
+++ b/third_party/googleapis/google/devtools/clouddebugger/BUILD.bazel
@@ -1 +1 @@
-exports_files(glob(["*.yaml"]))
\ No newline at end of file
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/devtools/clouddebugger/clouddebugger.yaml b/third_party/googleapis/google/devtools/clouddebugger/clouddebugger.yaml
deleted file mode 100644
index be75bd23f..000000000
--- a/third_party/googleapis/google/devtools/clouddebugger/clouddebugger.yaml
+++ /dev/null
@@ -1,40 +0,0 @@
-type: google.api.Service
-config_version: 2
-name: clouddebugger.googleapis.com
-title: Stackdriver Debugger API
-
-apis:
-- name: google.devtools.clouddebugger.v2.Controller2
-- name: google.devtools.clouddebugger.v2.Debugger2
-
-documentation:
-  summary: |-
-    Examines the call stack and variables of a running application without
-    stopping or slowing it down.
-
-backend:
-  rules:
-  - selector: google.devtools.clouddebugger.v2.Controller2.RegisterDebuggee
-    deadline: 300.0
-  - selector: google.devtools.clouddebugger.v2.Controller2.ListActiveBreakpoints
-    deadline: 300.0
-  - selector: google.devtools.clouddebugger.v2.Controller2.UpdateActiveBreakpoint
-    deadline: 300.0
-  - selector: google.devtools.clouddebugger.v2.Debugger2.SetBreakpoint
-    deadline: 300.0
-  - selector: google.devtools.clouddebugger.v2.Debugger2.GetBreakpoint
-    deadline: 300.0
-  - selector: google.devtools.clouddebugger.v2.Debugger2.DeleteBreakpoint
-    deadline: 300.0
-  - selector: google.devtools.clouddebugger.v2.Debugger2.ListBreakpoints
-    deadline: 300.0
-  - selector: google.devtools.clouddebugger.v2.Debugger2.ListDebuggees
-    deadline: 300.0
-
-authentication:
-  rules:
-  - selector: '*'
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform,
-        https://www.googleapis.com/auth/cloud_debugger
diff --git a/third_party/googleapis/google/devtools/clouddebugger/v2/BUILD.bazel b/third_party/googleapis/google/devtools/clouddebugger/v2/BUILD.bazel
index 6b33ee4df..7be200131 100644
--- a/third_party/googleapis/google/devtools/clouddebugger/v2/BUILD.bazel
+++ b/third_party/googleapis/google/devtools/clouddebugger/v2/BUILD.bazel
@@ -1,13 +1,16 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
-    name = "debugger_proto",
+    name = "clouddebugger_proto",
     srcs = [
         "controller.proto",
         "data.proto",
@@ -15,8 +18,9 @@ proto_library(
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
         "//google/devtools/source/v1:source_proto",
-        "@com_google_protobuf//:duration_proto",
         "@com_google_protobuf//:empty_proto",
         "@com_google_protobuf//:timestamp_proto",
         "@com_google_protobuf//:wrappers_proto",
@@ -24,8 +28,11 @@ proto_library(
 )
 
 proto_library_with_info(
-    name = "debugger_proto_with_info",
-    deps = [":debugger_proto"],
+    name = "clouddebugger_proto_with_info",
+    deps = [
+        ":clouddebugger_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -33,74 +40,56 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
-    name = "debugger_java_proto",
-    deps = [":debugger_proto"],
+    name = "clouddebugger_java_proto",
+    deps = [":clouddebugger_proto"],
 )
 
 java_grpc_library(
-    name = "debugger_java_grpc",
-    srcs = [":debugger_proto"],
-    deps = [":debugger_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "debugger_resource_name_java_proto",
-    gapic_yaml = "clouddebugger_gapic.yaml",
-    deps = [":debugger_proto"],
+    name = "clouddebugger_java_grpc",
+    srcs = [":clouddebugger_proto"],
+    deps = [":clouddebugger_java_proto"],
 )
 
 java_gapic_library(
-    name = "debugger_java_gapic",
-    src = ":debugger_proto_with_info",
+    name = "clouddebugger_java_gapic",
+    src = ":clouddebugger_proto_with_info",
     gapic_yaml = "clouddebugger_gapic.yaml",
-    service_yaml = "//google/devtools/clouddebugger:clouddebugger.yaml",
-    test_deps = [":debugger_java_grpc"],
+    package = "google.devtools.clouddebugger.v2",
+    service_yaml = "clouddebugger_v2.yaml",
+    test_deps = [
+        ":clouddebugger_java_grpc",
+    ],
     deps = [
-        ":debugger_java_proto",
-        ":debugger_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+        ":clouddebugger_java_proto",
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":debugger_java_gapic_test",
+java_gapic_test(
+    name = "clouddebugger_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.debugger.v2.Controller2ClientTest",
+        "com.google.cloud.debugger.v2.Debugger2ClientTest",
     ],
-) for test_name in [
-    "com.google.cloud.debugger.v2.Debugger2ClientTest",
-    "com.google.cloud.debugger.v2.Controller2ClientTest",
-]]
+    runtime_deps = [":clouddebugger_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
-    name = "google-cloud-debugger-v2-java",
-    client_deps = [":debugger_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":debugger_java_gapic_test"],
-    grpc_deps = [":debugger_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
-        "//google/devtools/source/v1:source_java_proto",
-        "//google/devtools/source/v1:source_proto",
-        ":debugger_java_proto",
-        ":debugger_proto",
-        ":debugger_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    name = "google-cloud-devtools-clouddebugger-v2-java",
+    deps = [
+        ":clouddebugger_java_gapic",
+        ":clouddebugger_java_grpc",
+        ":clouddebugger_java_proto",
+        ":clouddebugger_proto",
+    ],
 )
 
 ##############################################################################
@@ -108,17 +97,17 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
-    name = "debugger_go_proto",
+    name = "clouddebugger_go_proto",
     compilers = ["@io_bazel_rules_go//proto:go_grpc"],
     importpath = "google.golang.org/genproto/googleapis/devtools/clouddebugger/v2",
-    protos = [":debugger_proto"],
+    protos = [":clouddebugger_proto"],
     deps = [
         "//google/api:annotations_go_proto",
         "//google/devtools/source/v1:source_go_proto",
@@ -126,28 +115,269 @@ go_proto_library(
 )
 
 go_gapic_library(
-    name = "debugger_go_gapic",
-    src = ":debugger_proto_with_info",
-    gapic_yaml = "clouddebugger_gapic.yaml",
-    importpath = "cloud.google.com/go/debugger/apiv2",
-    service_yaml = "//google/devtools/clouddebugger:clouddebugger.yaml",
-    deps = [":debugger_go_proto"],
+    name = "clouddebugger_go_gapic",
+    srcs = [":clouddebugger_proto_with_info"],
+    grpc_service_config = "clouddebugger_grpc_service_config.json",
+    importpath = "cloud.google.com/go/debugger/apiv2;clouddebugger",
+    service_yaml = "clouddebugger_v2.yaml",
+    deps = [
+        ":clouddebugger_go_proto",
+    ],
 )
 
 go_test(
-    name = "debugger_go_gapic_test",
-    srcs = [":debugger_go_gapic_srcjar_test"],
-    embed = [":debugger_go_gapic"],
+    name = "clouddebugger_go_gapic_test",
+    srcs = [":clouddebugger_go_gapic_srcjar_test"],
+    embed = [":clouddebugger_go_gapic"],
     importpath = "cloud.google.com/go/debugger/apiv2",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
-    name = "gapi-cloud-debugger-v2-go",
+    name = "gapi-cloud-devtools-clouddebugger-v2-go",
+    deps = [
+        ":clouddebugger_go_gapic",
+        ":clouddebugger_go_gapic_srcjar-test.srcjar",
+        ":clouddebugger_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "clouddebugger_moved_proto",
+    srcs = [":clouddebugger_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/devtools/source/v1:source_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:timestamp_proto",
+        "@com_google_protobuf//:wrappers_proto",
+    ],
+)
+
+py_proto_library(
+    name = "clouddebugger_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":clouddebugger_moved_proto"],
+)
+
+py_grpc_library(
+    name = "clouddebugger_py_grpc",
+    srcs = [":clouddebugger_moved_proto"],
+    deps = [":clouddebugger_py_proto"],
+)
+
+py_gapic_library(
+    name = "clouddebugger_py_gapic",
+    src = ":clouddebugger_proto_with_info",
+    gapic_yaml = "clouddebugger_gapic.yaml",
+    package = "google.devtools.clouddebugger.v2",
+    service_yaml = "clouddebugger_v2.yaml",
+    deps = [
+        ":clouddebugger_py_grpc",
+        ":clouddebugger_py_proto",
+        "//google/devtools/source/v1:source_py_grpc",
+        "//google/devtools/source/v1:source_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "devtools-clouddebugger-v2-py",
     deps = [
-        ":debugger_go_gapic",
-        ":debugger_go_gapic_srcjar-smoke-test.srcjar",
-        ":debugger_go_gapic_srcjar-test.srcjar",
-        ":debugger_go_proto",
+        ":clouddebugger_py_gapic",
+        ":clouddebugger_py_grpc",
+        ":clouddebugger_py_proto",
+        "//google/devtools/source/v1:source_py_grpc",
+        "//google/devtools/source/v1:source_py_proto",
     ],
 )
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "clouddebugger_php_proto",
+    deps = [":clouddebugger_proto"],
+)
+
+php_grpc_library(
+    name = "clouddebugger_php_grpc",
+    srcs = [":clouddebugger_proto"],
+    deps = [":clouddebugger_php_proto"],
+)
+
+php_gapic_library(
+    name = "clouddebugger_php_gapic",
+    src = ":clouddebugger_proto_with_info",
+    gapic_yaml = "clouddebugger_gapic.yaml",
+    package = "google.devtools.clouddebugger.v2",
+    service_yaml = "clouddebugger_v2.yaml",
+    deps = [
+        ":clouddebugger_php_grpc",
+        ":clouddebugger_php_proto",
+        "//google/devtools/source/v1:source_php_grpc",
+        "//google/devtools/source/v1:source_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-devtools-clouddebugger-v2-php",
+    deps = [
+        ":clouddebugger_php_gapic",
+        ":clouddebugger_php_grpc",
+        ":clouddebugger_php_proto",
+        "//google/devtools/source/v1:source_php_grpc",
+        "//google/devtools/source/v1:source_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "clouddebugger_nodejs_gapic",
+    src = ":clouddebugger_proto_with_info",
+    gapic_yaml = "clouddebugger_gapic.yaml",
+    package = "google.devtools.clouddebugger.v2",
+    service_yaml = "clouddebugger_v2.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "devtools-clouddebugger-v2-nodejs",
+    deps = [
+        ":clouddebugger_nodejs_gapic",
+        ":clouddebugger_proto",
+        "//google/devtools/source/v1:source_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "clouddebugger_ruby_proto",
+    deps = [":clouddebugger_proto"],
+)
+
+ruby_grpc_library(
+    name = "clouddebugger_ruby_grpc",
+    srcs = [":clouddebugger_proto"],
+    deps = [":clouddebugger_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "clouddebugger_ruby_gapic",
+    src = ":clouddebugger_proto_with_info",
+    gapic_yaml = "clouddebugger_gapic.yaml",
+    package = "google.devtools.clouddebugger.v2",
+    service_yaml = "clouddebugger_v2.yaml",
+    deps = [
+        ":clouddebugger_ruby_grpc",
+        ":clouddebugger_ruby_proto",
+        "//google/devtools/source/v1:source_ruby_grpc",
+        "//google/devtools/source/v1:source_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-devtools-clouddebugger-v2-ruby",
+    deps = [
+        ":clouddebugger_ruby_gapic",
+        ":clouddebugger_ruby_grpc",
+        ":clouddebugger_ruby_proto",
+        "//google/devtools/source/v1:source_ruby_grpc",
+        "//google/devtools/source/v1:source_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "clouddebugger_csharp_proto",
+    deps = [":clouddebugger_proto"],
+)
+
+csharp_grpc_library(
+    name = "clouddebugger_csharp_grpc",
+    srcs = [":clouddebugger_proto"],
+    deps = [":clouddebugger_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "clouddebugger_csharp_gapic",
+    src = ":clouddebugger_proto_with_info",
+    gapic_yaml = "clouddebugger_gapic.yaml",
+    package = "google.devtools.clouddebugger.v2",
+    service_yaml = "clouddebugger_v2.yaml",
+    deps = [
+        ":clouddebugger_csharp_grpc",
+        ":clouddebugger_csharp_proto",
+        "//google/devtools/source/v1:source_csharp_grpc",
+        "//google/devtools/source/v1:source_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-devtools-clouddebugger-v2-csharp",
+    deps = [
+        ":clouddebugger_csharp_gapic",
+        ":clouddebugger_csharp_grpc",
+        ":clouddebugger_csharp_proto",
+        "//google/devtools/source/v1:source_csharp_grpc",
+        "//google/devtools/source/v1:source_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/devtools/clouddebugger/v2/clouddebugger_gapic.legacy.yaml b/third_party/googleapis/google/devtools/clouddebugger/v2/clouddebugger_gapic.legacy.yaml
new file mode 100644
index 000000000..1e910b192
--- /dev/null
+++ b/third_party/googleapis/google/devtools/clouddebugger/v2/clouddebugger_gapic.legacy.yaml
@@ -0,0 +1,156 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.debugger.v2
+  python:
+    package_name: google.cloud.debugger_v2.gapic
+  go:
+    package_name: cloud.google.com/go/debugger/apiv2
+    domain_layer_location: cloud.google.com/go/cmd/go-cloud-debug-agent
+  csharp:
+    package_name: Google.Cloud.Debugger.V2
+  ruby:
+    package_name: Google::Cloud::Debugger::V2
+  php:
+    package_name: Google\Cloud\Debugger\V2
+  nodejs:
+    package_name: debugger.v2
+    domain_layer_location: google-cloud
+interfaces:
+- name: google.devtools.clouddebugger.v2.Debugger2
+  collections: []
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 60000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 60000
+    total_timeout_millis: 600000
+  methods:
+  - name: SetBreakpoint
+    required_fields:
+    - debuggee_id
+    - breakpoint
+    - client_version
+    flattening:
+      groups:
+      - parameters:
+        - debuggee_id
+        - breakpoint
+        - client_version
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: GetBreakpoint
+    required_fields:
+    - debuggee_id
+    - breakpoint_id
+    - client_version
+    flattening:
+      groups:
+      - parameters:
+        - debuggee_id
+        - breakpoint_id
+        - client_version
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: DeleteBreakpoint
+    required_fields:
+    - debuggee_id
+    - breakpoint_id
+    - client_version
+    flattening:
+      groups:
+      - parameters:
+        - debuggee_id
+        - breakpoint_id
+        - client_version
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: ListBreakpoints
+    required_fields:
+    - debuggee_id
+    - client_version
+    flattening:
+      groups:
+      - parameters:
+        - debuggee_id
+        - client_version
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: ListDebuggees
+    required_fields:
+    - project
+    - client_version
+    flattening:
+      groups:
+      - parameters:
+        - project
+        - client_version
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+- name: google.devtools.clouddebugger.v2.Controller2
+  collections: []
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 60000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 60000
+    total_timeout_millis: 600000
+  methods:
+  - name: RegisterDebuggee
+    required_fields:
+    - debuggee
+    flattening:
+      groups:
+      - parameters:
+        - debuggee
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: ListActiveBreakpoints
+    required_fields:
+    - debuggee_id
+    flattening:
+      groups:
+      - parameters:
+        - debuggee_id
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: UpdateActiveBreakpoint
+    required_fields:
+    - debuggee_id
+    - breakpoint
+    flattening:
+      groups:
+      - parameters:
+        - debuggee_id
+        - breakpoint
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
diff --git a/third_party/googleapis/google/devtools/clouddebugger/v2/clouddebugger_gapic.yaml b/third_party/googleapis/google/devtools/clouddebugger/v2/clouddebugger_gapic.yaml
index 1e910b192..2c4d3717e 100644
--- a/third_party/googleapis/google/devtools/clouddebugger/v2/clouddebugger_gapic.yaml
+++ b/third_party/googleapis/google/devtools/clouddebugger/v2/clouddebugger_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.debugger.v2
@@ -19,14 +19,6 @@ language_settings:
     domain_layer_location: google-cloud
 interfaces:
 - name: google.devtools.clouddebugger.v2.Debugger2
-  collections: []
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 100
@@ -37,81 +29,10 @@ interfaces:
     max_rpc_timeout_millis: 60000
     total_timeout_millis: 600000
   methods:
-  - name: SetBreakpoint
-    required_fields:
-    - debuggee_id
-    - breakpoint
-    - client_version
-    flattening:
-      groups:
-      - parameters:
-        - debuggee_id
-        - breakpoint
-        - client_version
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-  - name: GetBreakpoint
-    required_fields:
-    - debuggee_id
-    - breakpoint_id
-    - client_version
-    flattening:
-      groups:
-      - parameters:
-        - debuggee_id
-        - breakpoint_id
-        - client_version
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 60000
   - name: DeleteBreakpoint
-    required_fields:
-    - debuggee_id
-    - breakpoint_id
-    - client_version
-    flattening:
-      groups:
-      - parameters:
-        - debuggee_id
-        - breakpoint_id
-        - client_version
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-  - name: ListBreakpoints
-    required_fields:
-    - debuggee_id
-    - client_version
-    flattening:
-      groups:
-      - parameters:
-        - debuggee_id
-        - client_version
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
-  - name: ListDebuggees
-    required_fields:
-    - project
-    - client_version
-    flattening:
-      groups:
-      - parameters:
-        - project
-        - client_version
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 60000
 - name: google.devtools.clouddebugger.v2.Controller2
-  collections: []
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 100
@@ -122,35 +43,6 @@ interfaces:
     max_rpc_timeout_millis: 60000
     total_timeout_millis: 600000
   methods:
-  - name: RegisterDebuggee
-    required_fields:
-    - debuggee
-    flattening:
-      groups:
-      - parameters:
-        - debuggee
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-  - name: ListActiveBreakpoints
-    required_fields:
-    - debuggee_id
-    flattening:
-      groups:
-      - parameters:
-        - debuggee_id
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 60000
   - name: UpdateActiveBreakpoint
-    required_fields:
-    - debuggee_id
-    - breakpoint
-    flattening:
-      groups:
-      - parameters:
-        - debuggee_id
-        - breakpoint
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
diff --git a/third_party/googleapis/google/devtools/clouddebugger/v2/clouddebugger_grpc_service_config.json b/third_party/googleapis/google/devtools/clouddebugger/v2/clouddebugger_grpc_service_config.json
new file mode 100755
index 000000000..01f991354
--- /dev/null
+++ b/third_party/googleapis/google/devtools/clouddebugger/v2/clouddebugger_grpc_service_config.json
@@ -0,0 +1,74 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.devtools.clouddebugger.v2.Debugger2",
+          "method": "SetBreakpoint"
+        }
+      ],
+      "timeout": "600s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.devtools.clouddebugger.v2.Debugger2",
+          "method": "GetBreakpoint"
+        },
+        {
+          "service": "google.devtools.clouddebugger.v2.Debugger2",
+          "method": "DeleteBreakpoint"
+        },
+        {
+          "service": "google.devtools.clouddebugger.v2.Debugger2",
+          "method": "ListBreakpoints"
+        },
+        {
+          "service": "google.devtools.clouddebugger.v2.Debugger2",
+          "method": "ListDebuggees"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.devtools.clouddebugger.v2.Controller2",
+          "method": "RegisterDebuggee"
+        }
+      ],
+      "timeout": "600s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.devtools.clouddebugger.v2.Controller2",
+          "method": "ListActiveBreakpoints"
+        },
+        {
+          "service": "google.devtools.clouddebugger.v2.Controller2",
+          "method": "UpdateActiveBreakpoint"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/devtools/clouddebugger/v2/clouddebugger_v2.yaml b/third_party/googleapis/google/devtools/clouddebugger/v2/clouddebugger_v2.yaml
new file mode 100644
index 000000000..b1ad712d5
--- /dev/null
+++ b/third_party/googleapis/google/devtools/clouddebugger/v2/clouddebugger_v2.yaml
@@ -0,0 +1,33 @@
+type: google.api.Service
+config_version: 2
+name: clouddebugger.googleapis.com
+title: Stackdriver Debugger API
+
+apis:
+- name: google.devtools.clouddebugger.v2.Controller2
+- name: google.devtools.clouddebugger.v2.Debugger2
+
+documentation:
+  summary: |-
+    Examines the call stack and variables of a running application without
+    stopping or slowing it down.
+
+backend:
+  rules:
+  - selector: 'google.devtools.clouddebugger.v2.Controller2.*'
+    deadline: 300.0
+  - selector: 'google.devtools.clouddebugger.v2.Debugger2.*'
+    deadline: 300.0
+
+authentication:
+  rules:
+  - selector: 'google.devtools.clouddebugger.v2.Controller2.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud_debugger
+  - selector: 'google.devtools.clouddebugger.v2.Debugger2.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud_debugger
diff --git a/third_party/googleapis/google/devtools/clouddebugger/v2/controller.proto b/third_party/googleapis/google/devtools/clouddebugger/v2/controller.proto
index 3c9da584d..8cb5fd0c6 100644
--- a/third_party/googleapis/google/devtools/clouddebugger/v2/controller.proto
+++ b/third_party/googleapis/google/devtools/clouddebugger/v2/controller.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,6 +18,8 @@ syntax = "proto3";
 package google.devtools.clouddebugger.v2;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/devtools/clouddebugger/v2/data.proto";
 import "google/protobuf/empty.proto";
 
@@ -49,6 +51,11 @@ option php_namespace = "Google\\Cloud\\Debugger\\V2";
 // a completed breakpoint. This functionality is available using the Debugger
 // service.
 service Controller2 {
+  option (google.api.default_host) = "clouddebugger.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/cloud_debugger";
+
   // Registers the debuggee with the controller service.
   //
   // All agents attached to the same application must call this method with
@@ -59,12 +66,12 @@ service Controller2 {
   // This protocol allows the controller service to disable debuggees, recover
   // from data loss, or change the `debuggee_id` format. Agents must handle
   // `debuggee_id` value changing upon re-registration.
-  rpc RegisterDebuggee(RegisterDebuggeeRequest)
-      returns (RegisterDebuggeeResponse) {
+  rpc RegisterDebuggee(RegisterDebuggeeRequest) returns (RegisterDebuggeeResponse) {
     option (google.api.http) = {
       post: "/v2/controller/debuggees/register"
       body: "*"
     };
+    option (google.api.method_signature) = "debuggee";
   }
 
   // Returns the list of all active breakpoints for the debuggee.
@@ -80,11 +87,11 @@ service Controller2 {
   // Moreover, an agent should remember the breakpoints that are completed
   // until the controller removes them from the active list to avoid
   // setting those breakpoints again.
-  rpc ListActiveBreakpoints(ListActiveBreakpointsRequest)
-      returns (ListActiveBreakpointsResponse) {
+  rpc ListActiveBreakpoints(ListActiveBreakpointsRequest) returns (ListActiveBreakpointsResponse) {
     option (google.api.http) = {
       get: "/v2/controller/debuggees/{debuggee_id}/breakpoints"
     };
+    option (google.api.method_signature) = "debuggee_id";
   }
 
   // Updates the breakpoint state or mutable fields.
@@ -95,21 +102,21 @@ service Controller2 {
   // `condition` and `expressions` fields should not alter the breakpoint
   // semantics. These may only make changes such as canonicalizing a value
   // or snapping the location to the correct line of code.
-  rpc UpdateActiveBreakpoint(UpdateActiveBreakpointRequest)
-      returns (UpdateActiveBreakpointResponse) {
+  rpc UpdateActiveBreakpoint(UpdateActiveBreakpointRequest) returns (UpdateActiveBreakpointResponse) {
     option (google.api.http) = {
       put: "/v2/controller/debuggees/{debuggee_id}/breakpoints/{breakpoint.id}"
       body: "*"
     };
+    option (google.api.method_signature) = "debuggee_id,breakpoint";
   }
 }
 
 // Request to register a debuggee.
 message RegisterDebuggeeRequest {
-  // Debuggee information to register.
+  // Required. Debuggee information to register.
   // The fields `project`, `uniquifier`, `description` and `agent_version`
   // of the debuggee must be set.
-  Debuggee debuggee = 1;
+  Debuggee debuggee = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response for registering a debuggee.
@@ -124,8 +131,8 @@ message RegisterDebuggeeResponse {
 
 // Request to list active breakpoints.
 message ListActiveBreakpointsRequest {
-  // Identifies the debuggee.
-  string debuggee_id = 1;
+  // Required. Identifies the debuggee.
+  string debuggee_id = 1 [(google.api.field_behavior) = REQUIRED];
 
   // A token that, if specified, blocks the method call until the list
   // of active breakpoints has changed, or a server-selected timeout has
@@ -160,15 +167,17 @@ message ListActiveBreakpointsResponse {
 
 // Request to update an active breakpoint.
 message UpdateActiveBreakpointRequest {
-  // Identifies the debuggee being debugged.
-  string debuggee_id = 1;
+  // Required. Identifies the debuggee being debugged.
+  string debuggee_id = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Updated breakpoint information.
+  // Required. Updated breakpoint information.
   // The field `id` must be set.
   // The agent must echo all Breakpoint specification fields in the update.
-  Breakpoint breakpoint = 2;
+  Breakpoint breakpoint = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response for updating an active breakpoint.
 // The message is defined to allow future extensions.
-message UpdateActiveBreakpointResponse {}
+message UpdateActiveBreakpointResponse {
+
+}
diff --git a/third_party/googleapis/google/devtools/clouddebugger/v2/data.proto b/third_party/googleapis/google/devtools/clouddebugger/v2/data.proto
index c2659a9fa..863385717 100644
--- a/third_party/googleapis/google/devtools/clouddebugger/v2/data.proto
+++ b/third_party/googleapis/google/devtools/clouddebugger/v2/data.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -17,11 +17,10 @@ syntax = "proto3";
 
 package google.devtools.clouddebugger.v2;
 
-import "google/api/annotations.proto";
 import "google/devtools/source/v1/source_context.proto";
-import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
 import "google/protobuf/wrappers.proto";
+import "google/api/annotations.proto";
 
 option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.Debugger.V2";
@@ -445,8 +444,7 @@ message Debuggee {
 
   // References to the locations and revisions of the source code used in the
   // deployed application.
-  repeated google.devtools.source.v1.ExtendedSourceContext ext_source_contexts =
-      13 [deprecated = true];
+  repeated google.devtools.source.v1.ExtendedSourceContext ext_source_contexts = 13 [deprecated = true];
 
   // A set of custom debuggee properties, populated by the agent, to be
   // displayed to the user.
diff --git a/third_party/googleapis/google/devtools/clouddebugger/v2/debugger.proto b/third_party/googleapis/google/devtools/clouddebugger/v2/debugger.proto
index 046f77076..546570e73 100644
--- a/third_party/googleapis/google/devtools/clouddebugger/v2/debugger.proto
+++ b/third_party/googleapis/google/devtools/clouddebugger/v2/debugger.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -17,9 +17,11 @@ syntax = "proto3";
 
 package google.devtools.clouddebugger.v2;
 
-import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/devtools/clouddebugger/v2/data.proto";
 import "google/protobuf/empty.proto";
+import "google/api/annotations.proto";
 
 option csharp_namespace = "Google.Cloud.Debugger.V2";
 option go_package = "google.golang.org/genproto/googleapis/devtools/clouddebugger/v2;clouddebugger";
@@ -41,12 +43,18 @@ option php_namespace = "Google\\Cloud\\Debugger\\V2";
 // The Debugger service enables the client to set one or more Breakpoints on a
 // Debuggee and collect the results of the set Breakpoints.
 service Debugger2 {
+  option (google.api.default_host) = "clouddebugger.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/cloud_debugger";
+
   // Sets the breakpoint to the debuggee.
   rpc SetBreakpoint(SetBreakpointRequest) returns (SetBreakpointResponse) {
     option (google.api.http) = {
       post: "/v2/debugger/debuggees/{debuggee_id}/breakpoints/set"
       body: "breakpoint"
     };
+    option (google.api.method_signature) = "debuggee_id,breakpoint,client_version";
   }
 
   // Gets breakpoint information.
@@ -54,22 +62,23 @@ service Debugger2 {
     option (google.api.http) = {
       get: "/v2/debugger/debuggees/{debuggee_id}/breakpoints/{breakpoint_id}"
     };
+    option (google.api.method_signature) = "debuggee_id,breakpoint_id,client_version";
   }
 
   // Deletes the breakpoint from the debuggee.
-  rpc DeleteBreakpoint(DeleteBreakpointRequest)
-      returns (google.protobuf.Empty) {
+  rpc DeleteBreakpoint(DeleteBreakpointRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v2/debugger/debuggees/{debuggee_id}/breakpoints/{breakpoint_id}"
     };
+    option (google.api.method_signature) = "debuggee_id,breakpoint_id,client_version";
   }
 
   // Lists all breakpoints for the debuggee.
-  rpc ListBreakpoints(ListBreakpointsRequest)
-      returns (ListBreakpointsResponse) {
+  rpc ListBreakpoints(ListBreakpointsRequest) returns (ListBreakpointsResponse) {
     option (google.api.http) = {
       get: "/v2/debugger/debuggees/{debuggee_id}/breakpoints"
     };
+    option (google.api.method_signature) = "debuggee_id,client_version";
   }
 
   // Lists all the debuggees that the user has access to.
@@ -77,21 +86,22 @@ service Debugger2 {
     option (google.api.http) = {
       get: "/v2/debugger/debuggees"
     };
+    option (google.api.method_signature) = "project,client_version";
   }
 }
 
 // Request to set a breakpoint
 message SetBreakpointRequest {
-  // ID of the debuggee where the breakpoint is to be set.
-  string debuggee_id = 1;
+  // Required. ID of the debuggee where the breakpoint is to be set.
+  string debuggee_id = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Breakpoint specification to set.
+  // Required. Breakpoint specification to set.
   // The field `location` of the breakpoint must be set.
-  Breakpoint breakpoint = 2;
+  Breakpoint breakpoint = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // The client version making the call.
+  // Required. The client version making the call.
   // Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
-  string client_version = 4;
+  string client_version = 4 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response for setting a breakpoint.
@@ -103,15 +113,15 @@ message SetBreakpointResponse {
 
 // Request to get breakpoint information.
 message GetBreakpointRequest {
-  // ID of the debuggee whose breakpoint to get.
-  string debuggee_id = 1;
+  // Required. ID of the debuggee whose breakpoint to get.
+  string debuggee_id = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // ID of the breakpoint to get.
-  string breakpoint_id = 2;
+  // Required. ID of the breakpoint to get.
+  string breakpoint_id = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // The client version making the call.
+  // Required. The client version making the call.
   // Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
-  string client_version = 4;
+  string client_version = 4 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response for getting breakpoint information.
@@ -123,15 +133,15 @@ message GetBreakpointResponse {
 
 // Request to delete a breakpoint.
 message DeleteBreakpointRequest {
-  // ID of the debuggee whose breakpoint to delete.
-  string debuggee_id = 1;
+  // Required. ID of the debuggee whose breakpoint to delete.
+  string debuggee_id = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // ID of the breakpoint to delete.
-  string breakpoint_id = 2;
+  // Required. ID of the breakpoint to delete.
+  string breakpoint_id = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // The client version making the call.
+  // Required. The client version making the call.
   // Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
-  string client_version = 3;
+  string client_version = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request to list breakpoints.
@@ -143,8 +153,8 @@ message ListBreakpointsRequest {
     Breakpoint.Action value = 1;
   }
 
-  // ID of the debuggee whose breakpoints to list.
-  string debuggee_id = 1;
+  // Required. ID of the debuggee whose breakpoints to list.
+  string debuggee_id = 1 [(google.api.field_behavior) = REQUIRED];
 
   // When set to `true`, the response includes the list of breakpoints set by
   // any user. Otherwise, it includes only breakpoints set by the caller.
@@ -168,9 +178,9 @@ message ListBreakpointsRequest {
   // should be called again with the same `wait_token`.
   string wait_token = 6;
 
-  // The client version making the call.
+  // Required. The client version making the call.
   // Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
-  string client_version = 8;
+  string client_version = 8 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response for listing breakpoints.
@@ -188,16 +198,16 @@ message ListBreakpointsResponse {
 
 // Request to list debuggees.
 message ListDebuggeesRequest {
-  // Project number of a Google Cloud project whose debuggees to list.
-  string project = 2;
+  // Required. Project number of a Google Cloud project whose debuggees to list.
+  string project = 2 [(google.api.field_behavior) = REQUIRED];
 
   // When set to `true`, the result includes all debuggees. Otherwise, the
   // result includes only debuggees that are active.
   bool include_inactive = 3;
 
-  // The client version making the call.
+  // Required. The client version making the call.
   // Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
-  string client_version = 4;
+  string client_version = 4 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response for listing debuggees.
diff --git a/third_party/googleapis/google/devtools/clouderrorreporting/BUILD.bazel b/third_party/googleapis/google/devtools/clouderrorreporting/BUILD.bazel
index 1e5b8c2af..a87c57fec 100644
--- a/third_party/googleapis/google/devtools/clouderrorreporting/BUILD.bazel
+++ b/third_party/googleapis/google/devtools/clouderrorreporting/BUILD.bazel
@@ -1 +1 @@
-exports_files(glob(["*.yaml"]))
\ No newline at end of file
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/devtools/clouderrorreporting/artman_errorreporting.legacy.yaml b/third_party/googleapis/google/devtools/clouderrorreporting/artman_errorreporting.legacy.yaml
new file mode 100644
index 000000000..6493aa47a
--- /dev/null
+++ b/third_party/googleapis/google/devtools/clouderrorreporting/artman_errorreporting.legacy.yaml
@@ -0,0 +1,34 @@
+common:
+  api_name: error-reporting
+  api_version: v1beta1
+  organization_name: google-cloud
+  service_yaml: v1beta1/clouderrorreporting_v1beta1.yaml
+  gapic_yaml: v1beta1/errorreporting_gapic.legacy.yaml
+  src_proto_paths:
+  - v1beta1
+  proto_deps:
+  - name: google-common-protos
+artifacts:
+- name: java_gapic
+  type: GAPIC
+  language: JAVA
+- name: python_gapic
+  type: GAPIC
+  language: PYTHON
+- name: php_gapic
+  type: GAPIC
+  language: PHP
+- name: ruby_gapic
+  type: GAPIC
+  language: RUBY
+- name: go_gapic
+  type: GAPIC
+  language: GO
+- name: csharp_gapic
+  type: GAPIC
+  language: CSHARP
+- name: nodejs_gapic
+  type: GAPIC
+  language: NODEJS
+- name: gapic_config
+  type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/devtools/clouderrorreporting/artman_errorreporting.yaml b/third_party/googleapis/google/devtools/clouderrorreporting/artman_errorreporting.yaml
index 0e5a573a4..a4dd9f0c8 100644
--- a/third_party/googleapis/google/devtools/clouderrorreporting/artman_errorreporting.yaml
+++ b/third_party/googleapis/google/devtools/clouderrorreporting/artman_errorreporting.yaml
@@ -2,7 +2,7 @@ common:
   api_name: error-reporting
   api_version: v1beta1
   organization_name: google-cloud
-  service_yaml: errorreporting.yaml
+  service_yaml: v1beta1/clouderrorreporting_v1beta1.yaml
   gapic_yaml: v1beta1/errorreporting_gapic.yaml
   src_proto_paths:
   - v1beta1
diff --git a/third_party/googleapis/google/devtools/clouderrorreporting/errorreporting.yaml b/third_party/googleapis/google/devtools/clouderrorreporting/errorreporting.yaml
deleted file mode 100644
index 75df65ced..000000000
--- a/third_party/googleapis/google/devtools/clouderrorreporting/errorreporting.yaml
+++ /dev/null
@@ -1,24 +0,0 @@
-type: google.api.Service
-config_version: 3
-title: Stackdriver Error Reporting API
-name: clouderrorreporting.googleapis.com
-
-documentation:
-  summary: >-
-    
-    Stackdriver Error Reporting groups and counts similar errors
-    from cloud services.
-    The Stackdriver Error Reporting API provides a way to report new errors and
-    read access to error groups and their associated errors.
-
-apis:
-- name: google.devtools.clouderrorreporting.v1beta1.ErrorGroupService
-- name: google.devtools.clouderrorreporting.v1beta1.ErrorStatsService
-- name: google.devtools.clouderrorreporting.v1beta1.ReportErrorsService
-
-authentication:
-  rules:
-    - selector: '*'
-      oauth:
-        canonical_scopes:
-          https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/BUILD.bazel b/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/BUILD.bazel
index 4b912abfb..d78bcd0f3 100644
--- a/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/BUILD.bazel
+++ b/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/BUILD.bazel
@@ -1,9 +1,12 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
@@ -16,7 +19,9 @@ proto_library(
     ],
     deps = [
         "//google/api:annotations_proto",
-        "//google/api:monitored_resource_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
         "@com_google_protobuf//:duration_proto",
         "@com_google_protobuf//:timestamp_proto",
     ],
@@ -24,7 +29,10 @@ proto_library(
 
 proto_library_with_info(
     name = "clouderrorreporting_proto_with_info",
-    deps = [":clouderrorreporting_proto"],
+    deps = [
+        ":clouderrorreporting_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -32,18 +40,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
     name = "clouderrorreporting_java_proto",
     deps = [":clouderrorreporting_proto"],
@@ -52,53 +55,42 @@ java_proto_library(
 java_grpc_library(
     name = "clouderrorreporting_java_grpc",
     srcs = [":clouderrorreporting_proto"],
-    deps = [":clouderrorreporting_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "clouderrorreporting_resource_name_java_proto",
-    gapic_yaml = "errorreporting_gapic.yaml",
-    deps = [":clouderrorreporting_proto"],
+    deps = [":clouderrorreporting_java_proto"],
 )
 
 java_gapic_library(
     name = "clouderrorreporting_java_gapic",
     src = ":clouderrorreporting_proto_with_info",
     gapic_yaml = "errorreporting_gapic.yaml",
-    service_yaml = "//google/devtools/clouderrorreporting:errorreporting.yaml",
-    test_deps = [":clouderrorreporting_java_grpc"],
+    package = "google.devtools.clouderrorreporting.v1beta1",
+    service_yaml = "clouderrorreporting_v1beta1.yaml",
+    test_deps = [
+        ":clouderrorreporting_java_grpc",
+    ],
     deps = [
         ":clouderrorreporting_java_proto",
-        ":clouderrorreporting_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":clouderrorreporting_java_gapic_test",
+java_gapic_test(
+    name = "clouderrorreporting_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.errorreporting.v1beta1.ErrorGroupServiceClientTest",
+        "com.google.cloud.errorreporting.v1beta1.ErrorStatsServiceClientTest",
+        "com.google.cloud.errorreporting.v1beta1.ReportErrorsServiceClientTest",
     ],
-) for test_name in [
-    "com.google.cloud.errorreporting.v1beta1.ErrorGroupServiceClientTest",
-    "com.google.cloud.errorreporting.v1beta1.ErrorStatsServiceClientTest",
-    "com.google.cloud.errorreporting.v1beta1.ReportErrorsServiceClientTest",
-]]
+    runtime_deps = [":clouderrorreporting_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
-    name = "google-cloud-error-reporting-v1beta1-java",
-    client_deps = [":clouderrorreporting_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":clouderrorreporting_java_gapic_test"],
-    grpc_deps = [":clouderrorreporting_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    name = "google-cloud-devtools-clouderrorreporting-v1beta1-java",
+    deps = [
+        ":clouderrorreporting_java_gapic",
+        ":clouderrorreporting_java_grpc",
         ":clouderrorreporting_java_proto",
         ":clouderrorreporting_proto",
-        ":clouderrorreporting_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -106,10 +98,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -119,17 +111,19 @@ go_proto_library(
     protos = [":clouderrorreporting_proto"],
     deps = [
         "//google/api:annotations_go_proto",
-        "//google/api:monitoredres_go_proto",
     ],
 )
 
 go_gapic_library(
     name = "clouderrorreporting_go_gapic",
-    src = ":clouderrorreporting_proto_with_info",
-    gapic_yaml = "errorreporting_gapic.yaml",
-    importpath = "cloud.google.com/go/errorreporting/apiv1beta1",
-    service_yaml = "//google/devtools/clouderrorreporting:errorreporting.yaml",
-    deps = [":clouderrorreporting_go_proto"],
+    srcs = [":clouderrorreporting_proto_with_info"],
+    grpc_service_config = "errorreporting_grpc_service_config.json",
+    importpath = "cloud.google.com/go/errorreporting/apiv1beta1;clouderrorreporting",
+    service_yaml = "clouderrorreporting_v1beta1.yaml",
+    deps = [
+        ":clouderrorreporting_go_proto",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
+    ],
 )
 
 go_test(
@@ -139,13 +133,234 @@ go_test(
     importpath = "cloud.google.com/go/errorreporting/apiv1beta1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
-    name = "gapi-cloud-error-reporting-v1beta1-go",
+    name = "gapi-cloud-devtools-clouderrorreporting-v1beta1-go",
     deps = [
         ":clouderrorreporting_go_gapic",
-        ":clouderrorreporting_go_gapic_srcjar-smoke-test.srcjar",
         ":clouderrorreporting_go_gapic_srcjar-test.srcjar",
         ":clouderrorreporting_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "clouderrorreporting_moved_proto",
+    srcs = [":clouderrorreporting_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "clouderrorreporting_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":clouderrorreporting_moved_proto"],
+)
+
+py_grpc_library(
+    name = "clouderrorreporting_py_grpc",
+    srcs = [":clouderrorreporting_moved_proto"],
+    deps = [":clouderrorreporting_py_proto"],
+)
+
+py_gapic_library(
+    name = "clouderrorreporting_py_gapic",
+    src = ":clouderrorreporting_proto_with_info",
+    gapic_yaml = "errorreporting_gapic.yaml",
+    package = "google.devtools.clouderrorreporting.v1beta1",
+    service_yaml = "clouderrorreporting_v1beta1.yaml",
+    deps = [
+        ":clouderrorreporting_py_grpc",
+        ":clouderrorreporting_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "devtools-clouderrorreporting-v1beta1-py",
+    deps = [
+        ":clouderrorreporting_py_gapic",
+        ":clouderrorreporting_py_grpc",
+        ":clouderrorreporting_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "clouderrorreporting_php_proto",
+    deps = [":clouderrorreporting_proto"],
+)
+
+php_grpc_library(
+    name = "clouderrorreporting_php_grpc",
+    srcs = [":clouderrorreporting_proto"],
+    deps = [":clouderrorreporting_php_proto"],
+)
+
+php_gapic_library(
+    name = "clouderrorreporting_php_gapic",
+    src = ":clouderrorreporting_proto_with_info",
+    gapic_yaml = "errorreporting_gapic.yaml",
+    package = "google.devtools.clouderrorreporting.v1beta1",
+    service_yaml = "clouderrorreporting_v1beta1.yaml",
+    deps = [
+        ":clouderrorreporting_php_grpc",
+        ":clouderrorreporting_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-devtools-clouderrorreporting-v1beta1-php",
+    deps = [
+        ":clouderrorreporting_php_gapic",
+        ":clouderrorreporting_php_grpc",
+        ":clouderrorreporting_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "clouderrorreporting_nodejs_gapic",
+    src = ":clouderrorreporting_proto_with_info",
+    gapic_yaml = "errorreporting_gapic.yaml",
+    package = "google.devtools.clouderrorreporting.v1beta1",
+    service_yaml = "clouderrorreporting_v1beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "devtools-clouderrorreporting-v1beta1-nodejs",
+    deps = [
+        ":clouderrorreporting_nodejs_gapic",
+        ":clouderrorreporting_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "clouderrorreporting_ruby_proto",
+    deps = [":clouderrorreporting_proto"],
+)
+
+ruby_grpc_library(
+    name = "clouderrorreporting_ruby_grpc",
+    srcs = [":clouderrorreporting_proto"],
+    deps = [":clouderrorreporting_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "clouderrorreporting_ruby_gapic",
+    src = ":clouderrorreporting_proto_with_info",
+    gapic_yaml = "errorreporting_gapic.yaml",
+    package = "google.devtools.clouderrorreporting.v1beta1",
+    service_yaml = "clouderrorreporting_v1beta1.yaml",
+    deps = [
+        ":clouderrorreporting_ruby_grpc",
+        ":clouderrorreporting_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-devtools-clouderrorreporting-v1beta1-ruby",
+    deps = [
+        ":clouderrorreporting_ruby_gapic",
+        ":clouderrorreporting_ruby_grpc",
+        ":clouderrorreporting_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "clouderrorreporting_csharp_proto",
+    deps = [":clouderrorreporting_proto"],
+)
+
+csharp_grpc_library(
+    name = "clouderrorreporting_csharp_grpc",
+    srcs = [":clouderrorreporting_proto"],
+    deps = [":clouderrorreporting_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "clouderrorreporting_csharp_gapic",
+    src = ":clouderrorreporting_proto_with_info",
+    gapic_yaml = "errorreporting_gapic.yaml",
+    package = "google.devtools.clouderrorreporting.v1beta1",
+    service_yaml = "clouderrorreporting_v1beta1.yaml",
+    deps = [
+        ":clouderrorreporting_csharp_grpc",
+        ":clouderrorreporting_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-devtools-clouderrorreporting-v1beta1-csharp",
+    deps = [
+        ":clouderrorreporting_csharp_gapic",
+        ":clouderrorreporting_csharp_grpc",
+        ":clouderrorreporting_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/clouderrorreporting_v1beta1.yaml b/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/clouderrorreporting_v1beta1.yaml
new file mode 100644
index 000000000..7c311cc23
--- /dev/null
+++ b/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/clouderrorreporting_v1beta1.yaml
@@ -0,0 +1,34 @@
+type: google.api.Service
+config_version: 3
+name: clouderrorreporting.googleapis.com
+title: Stackdriver Error Reporting API
+
+apis:
+- name: google.devtools.clouderrorreporting.v1beta1.ErrorGroupService
+- name: google.devtools.clouderrorreporting.v1beta1.ErrorStatsService
+- name: google.devtools.clouderrorreporting.v1beta1.ReportErrorsService
+
+documentation:
+  summary: |-
+    Groups and counts similar errors from cloud services and applications,
+    reports new errors, and provides access to error groups and their
+    associated errors.
+
+authentication:
+  rules:
+  - selector: google.devtools.clouderrorreporting.v1beta1.ErrorGroupService.GetGroup
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: google.devtools.clouderrorreporting.v1beta1.ErrorGroupService.UpdateGroup
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.devtools.clouderrorreporting.v1beta1.ErrorStatsService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: google.devtools.clouderrorreporting.v1beta1.ReportErrorsService.ReportErrorEvent
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/common.proto b/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/common.proto
index 132f1a646..5a4f02523 100644
--- a/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/common.proto
+++ b/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/common.proto
@@ -1,4 +1,4 @@
-// Copyright 2016 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -17,9 +17,10 @@ syntax = "proto3";
 package google.devtools.clouderrorreporting.v1beta1;
 
 import "google/api/annotations.proto";
-import "google/api/monitored_resource.proto";
+import "google/api/resource.proto";
 import "google/protobuf/timestamp.proto";
 
+option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.ErrorReporting.V1Beta1";
 option go_package = "google.golang.org/genproto/googleapis/devtools/clouderrorreporting/v1beta1;clouderrorreporting";
 option java_multiple_files = true;
@@ -29,6 +30,11 @@ option php_namespace = "Google\\Cloud\\ErrorReporting\\V1beta1";
 
 // Description of a group of similar error events.
 message ErrorGroup {
+  option (google.api.resource) = {
+    type: "clouderrorreporting.googleapis.com/ErrorGroup"
+    pattern: "projects/{project}/groups/{group}"
+  };
+
   // The group resource name.
   // Example: projects/my-project-123/groups/my-groupid
   string name = 1;
@@ -79,6 +85,8 @@ message ServiceContext {
 
   // Represents the source code version that the developer provided,
   // which could represent a version label or a Git SHA-1 hash, for example.
+  // For App Engine standard environment, the version is set to the version of
+  // the app.
   string version = 3;
 
   // Type of the MonitoredResource. List of possible values:
@@ -112,8 +120,7 @@ message ErrorContext {
   // report the error, usually the place where it was logged.
   // For a logged exception this would be the source line where the
   // exception is logged, usually close to the place where it was
-  // caught. This value is in contrast to `Exception.cause_location`,
-  // which describes the source line where the exception was thrown.
+  // caught.
   SourceLocation report_location = 3;
 }
 
@@ -144,11 +151,10 @@ message HttpRequestContext {
   string remote_ip = 6;
 }
 
-// Indicates a location in the source code of the service for which
-// errors are reported.
-// This data should be provided by the application when reporting an error,
-// unless the error report has been generated automatically from Google App
-// Engine logs. All fields are optional.
+// Indicates a location in the source code of the service for which errors are
+// reported. `functionName` must be provided by the application when reporting
+// an error, unless the error report contains a `message` with a supported
+// exception stack trace. All fields are optional for the later case.
 message SourceLocation {
   // The source code filename, which can include a truncated relative
   // path, or a full path from a production machine.
diff --git a/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/error_group_service.proto b/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/error_group_service.proto
index 15086a9ea..ab14ab316 100644
--- a/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/error_group_service.proto
+++ b/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/error_group_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2016 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,14 +11,19 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.devtools.clouderrorreporting.v1beta1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/devtools/clouderrorreporting/v1beta1/common.proto";
 
+option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.ErrorReporting.V1Beta1";
 option go_package = "google.golang.org/genproto/googleapis/devtools/clouderrorreporting/v1beta1;clouderrorreporting";
 option java_multiple_files = true;
@@ -28,11 +33,15 @@ option php_namespace = "Google\\Cloud\\ErrorReporting\\V1beta1";
 
 // Service for retrieving and updating individual error groups.
 service ErrorGroupService {
+  option (google.api.default_host) = "clouderrorreporting.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Get the specified group.
   rpc GetGroup(GetGroupRequest) returns (ErrorGroup) {
     option (google.api.http) = {
       get: "/v1beta1/{group_name=projects/*/groups/*}"
     };
+    option (google.api.method_signature) = "group_name";
   }
 
   // Replace the data for the specified group.
@@ -42,12 +51,13 @@ service ErrorGroupService {
       put: "/v1beta1/{group.name=projects/*/groups/*}"
       body: "group"
     };
+    option (google.api.method_signature) = "group";
   }
 }
 
 // A request to return an individual group.
 message GetGroupRequest {
-  // [Required] The group resource name. Written as
+  // Required. The group resource name. Written as
   // projects/projectID/groups/group_name.
   // Call
   // 
@@ -55,11 +65,16 @@ message GetGroupRequest {
   // this project.
   //
   // Example: projects/my-project-123/groups/my-group
-  string group_name = 1;
+  string group_name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "clouderrorreporting.googleapis.com/ErrorGroup"
+    }
+  ];
 }
 
 // A request to replace the existing data for the given group.
 message UpdateGroupRequest {
-  // [Required] The group which replaces the resource on the server.
-  ErrorGroup group = 1;
+  // Required. The group which replaces the resource on the server.
+  ErrorGroup group = 1 [(google.api.field_behavior) = REQUIRED];
 }
diff --git a/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/error_stats_service.proto b/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/error_stats_service.proto
index ffb25b2b8..8f4c909e2 100644
--- a/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/error_stats_service.proto
+++ b/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/error_stats_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2016 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,16 +11,21 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.devtools.clouderrorreporting.v1beta1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/devtools/clouderrorreporting/v1beta1/common.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
 
+option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.ErrorReporting.V1Beta1";
 option go_package = "google.golang.org/genproto/googleapis/devtools/clouderrorreporting/v1beta1;clouderrorreporting";
 option java_multiple_files = true;
@@ -31,11 +36,15 @@ option php_namespace = "Google\\Cloud\\ErrorReporting\\V1beta1";
 // An API for retrieving and managing error statistics as well as data for
 // individual events.
 service ErrorStatsService {
+  option (google.api.default_host) = "clouderrorreporting.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Lists the specified groups.
   rpc ListGroupStats(ListGroupStatsRequest) returns (ListGroupStatsResponse) {
     option (google.api.http) = {
       get: "/v1beta1/{project_name=projects/*}/groupStats"
     };
+    option (google.api.method_signature) = "project_name,time_range";
   }
 
   // Lists the specified events.
@@ -43,6 +52,7 @@ service ErrorStatsService {
     option (google.api.http) = {
       get: "/v1beta1/{project_name=projects/*}/events"
     };
+    option (google.api.method_signature) = "project_name,group_id";
   }
 
   // Deletes all error events of a given project.
@@ -50,60 +60,67 @@ service ErrorStatsService {
     option (google.api.http) = {
       delete: "/v1beta1/{project_name=projects/*}/events"
     };
+    option (google.api.method_signature) = "project_name";
   }
 }
 
 // Specifies a set of `ErrorGroupStats` to return.
 message ListGroupStatsRequest {
-  // [Required] The resource name of the Google Cloud Platform project. Written
+  // Required. The resource name of the Google Cloud Platform project. Written
   // as projects/ plus the
   // Google Cloud
   // Platform project ID.
   //
   // Example: projects/my-project-123.
-  string project_name = 1;
+  string project_name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
-  // [Optional] List all ErrorGroupStats with these IDs.
-  repeated string group_id = 2;
+  // Optional. List all ErrorGroupStats with these IDs.
+  repeated string group_id = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // [Optional] List only ErrorGroupStats which belong to a service
+  // Optional. List only ErrorGroupStats which belong to a service
   // context that matches the filter.
   // Data for all service contexts is returned if this field is not specified.
-  ServiceContextFilter service_filter = 3;
+  ServiceContextFilter service_filter = 3 [(google.api.field_behavior) = OPTIONAL];
 
-  // [Optional] List data for the given time range.
-  // If not set a default time range is used. The field time_range_begin
-  // in the response will specify the beginning of this time range.
+  // Optional. List data for the given time range.
+  // If not set, a default time range is used. The field
+  // time_range_begin in the response will specify the beginning
+  // of this time range.
   // Only ErrorGroupStats with a non-zero count in the given time
-  // range are returned, unless the request contains an explicit group_id list.
-  // If a group_id list is given, also ErrorGroupStats with zero
-  // occurrences are returned.
-  QueryTimeRange time_range = 5;
+  // range are returned, unless the request contains an explicit
+  // group_id list. If a group_id list is given, also
+  // ErrorGroupStats with zero occurrences are returned.
+  QueryTimeRange time_range = 5 [(google.api.field_behavior) = OPTIONAL];
 
-  // [Optional] The preferred duration for a single returned `TimedCount`.
+  // Optional. The preferred duration for a single returned `TimedCount`.
   // If not set, no timed counts are returned.
-  google.protobuf.Duration timed_count_duration = 6;
+  google.protobuf.Duration timed_count_duration = 6 [(google.api.field_behavior) = OPTIONAL];
 
-  // [Optional] The alignment of the timed counts to be returned.
+  // Optional. The alignment of the timed counts to be returned.
   // Default is `ALIGNMENT_EQUAL_AT_END`.
-  TimedCountAlignment alignment = 7;
+  TimedCountAlignment alignment = 7 [(google.api.field_behavior) = OPTIONAL];
 
-  // [Optional] Time where the timed counts shall be aligned if rounded
+  // Optional. Time where the timed counts shall be aligned if rounded
   // alignment is chosen. Default is 00:00 UTC.
-  google.protobuf.Timestamp alignment_time = 8;
+  google.protobuf.Timestamp alignment_time = 8 [(google.api.field_behavior) = OPTIONAL];
 
-  // [Optional] The sort order in which the results are returned.
+  // Optional. The sort order in which the results are returned.
   // Default is `COUNT_DESC`.
-  ErrorGroupOrder order = 9;
+  ErrorGroupOrder order = 9 [(google.api.field_behavior) = OPTIONAL];
 
-  // [Optional] The maximum number of results to return per response.
+  // Optional. The maximum number of results to return per response.
   // Default is 20.
-  int32 page_size = 11;
+  int32 page_size = 11 [(google.api.field_behavior) = OPTIONAL];
 
-  // [Optional] A `next_page_token` provided by a previous response. To view
+  // Optional. A `next_page_token` provided by a previous response. To view
   // additional results, pass this token along with the identical query
   // parameters as the first request.
-  string page_token = 12;
+  string page_token = 12 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Contains a set of requested error group stats.
@@ -196,33 +213,79 @@ message TimedCount {
   google.protobuf.Timestamp end_time = 3;
 }
 
+// Specifies how the time periods of error group counts are aligned.
+enum TimedCountAlignment {
+  // No alignment specified.
+  ERROR_COUNT_ALIGNMENT_UNSPECIFIED = 0;
+
+  // The time periods shall be consecutive, have width equal to the
+  // requested duration, and be aligned at the `alignment_time` provided in
+  // the request.
+  // The `alignment_time` does not have to be inside the query period but
+  // even if it is outside, only time periods are returned which overlap
+  // with the query period.
+  // A rounded alignment will typically result in a
+  // different size of the first or the last time period.
+  ALIGNMENT_EQUAL_ROUNDED = 1;
+
+  // The time periods shall be consecutive, have width equal to the
+  // requested duration, and be aligned at the end of the requested time
+  // period. This can result in a different size of the
+  // first time period.
+  ALIGNMENT_EQUAL_AT_END = 2;
+}
+
+// A sorting order of error groups.
+enum ErrorGroupOrder {
+  // No group order specified.
+  GROUP_ORDER_UNSPECIFIED = 0;
+
+  // Total count of errors in the given time window in descending order.
+  COUNT_DESC = 1;
+
+  // Timestamp when the group was last seen in the given time window
+  // in descending order.
+  LAST_SEEN_DESC = 2;
+
+  // Timestamp when the group was created in descending order.
+  CREATED_DESC = 3;
+
+  // Number of affected users in the given time window in descending order.
+  AFFECTED_USERS_DESC = 4;
+}
+
 // Specifies a set of error events to return.
 message ListEventsRequest {
-  // [Required] The resource name of the Google Cloud Platform project. Written
+  // Required. The resource name of the Google Cloud Platform project. Written
   // as `projects/` plus the
   // [Google Cloud Platform project
   // ID](https://support.google.com/cloud/answer/6158840).
   // Example: `projects/my-project-123`.
-  string project_name = 1;
+  string project_name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
-  // [Required] The group for which events shall be returned.
-  string group_id = 2;
+  // Required. The group for which events shall be returned.
+  string group_id = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // [Optional] List only ErrorGroups which belong to a service context that
+  // Optional. List only ErrorGroups which belong to a service context that
   // matches the filter.
   // Data for all service contexts is returned if this field is not specified.
-  ServiceContextFilter service_filter = 3;
+  ServiceContextFilter service_filter = 3 [(google.api.field_behavior) = OPTIONAL];
 
-  // [Optional] List only data for the given time range.
+  // Optional. List only data for the given time range.
   // If not set a default time range is used. The field time_range_begin
   // in the response will specify the beginning of this time range.
-  QueryTimeRange time_range = 4;
+  QueryTimeRange time_range = 4 [(google.api.field_behavior) = OPTIONAL];
 
-  // [Optional] The maximum number of results to return per response.
-  int32 page_size = 6;
+  // Optional. The maximum number of results to return per response.
+  int32 page_size = 6 [(google.api.field_behavior) = OPTIONAL];
 
-  // [Optional] A `next_page_token` provided by a previous response.
-  string page_token = 7;
+  // Optional. A `next_page_token` provided by a previous response.
+  string page_token = 7 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Contains a set of requested error events.
@@ -277,69 +340,35 @@ message QueryTimeRange {
 // Only exact, case-sensitive matches are supported.
 // If a field is unset or empty, it matches arbitrary values.
 message ServiceContextFilter {
-  // [Optional] The exact value to match against
+  // Optional. The exact value to match against
   // [`ServiceContext.service`](/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.service).
-  string service = 2;
+  string service = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // [Optional] The exact value to match against
+  // Optional. The exact value to match against
   // [`ServiceContext.version`](/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.version).
-  string version = 3;
+  string version = 3 [(google.api.field_behavior) = OPTIONAL];
 
-  // [Optional] The exact value to match against
+  // Optional. The exact value to match against
   // [`ServiceContext.resource_type`](/error-reporting/reference/rest/v1beta1/ServiceContext#FIELDS.resource_type).
-  string resource_type = 4;
+  string resource_type = 4 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Deletes all events in the project.
 message DeleteEventsRequest {
-  // [Required] The resource name of the Google Cloud Platform project. Written
+  // Required. The resource name of the Google Cloud Platform project. Written
   // as `projects/` plus the
   // [Google Cloud Platform project
   // ID](https://support.google.com/cloud/answer/6158840).
   // Example: `projects/my-project-123`.
-  string project_name = 1;
+  string project_name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 }
 
 // Response message for deleting error events.
-message DeleteEventsResponse {}
-
-// Specifies how the time periods of error group counts are aligned.
-enum TimedCountAlignment {
-  // No alignment specified.
-  ERROR_COUNT_ALIGNMENT_UNSPECIFIED = 0;
-
-  // The time periods shall be consecutive, have width equal to the
-  // requested duration, and be aligned at the `alignment_time` provided in
-  // the request.
-  // The `alignment_time` does not have to be inside the query period but
-  // even if it is outside, only time periods are returned which overlap
-  // with the query period.
-  // A rounded alignment will typically result in a
-  // different size of the first or the last time period.
-  ALIGNMENT_EQUAL_ROUNDED = 1;
-
-  // The time periods shall be consecutive, have width equal to the
-  // requested duration, and be aligned at the end of the requested time
-  // period. This can result in a different size of the
-  // first time period.
-  ALIGNMENT_EQUAL_AT_END = 2;
-}
+message DeleteEventsResponse {
 
-// A sorting order of error groups.
-enum ErrorGroupOrder {
-  // No group order specified.
-  GROUP_ORDER_UNSPECIFIED = 0;
-
-  // Total count of errors in the given time window in descending order.
-  COUNT_DESC = 1;
-
-  // Timestamp when the group was last seen in the given time window
-  // in descending order.
-  LAST_SEEN_DESC = 2;
-
-  // Timestamp when the group was created in descending order.
-  CREATED_DESC = 3;
-
-  // Number of affected users in the given time window in descending order.
-  AFFECTED_USERS_DESC = 4;
 }
diff --git a/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/errorreporting_gapic.legacy.yaml b/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/errorreporting_gapic.legacy.yaml
new file mode 100644
index 000000000..32e70a5b9
--- /dev/null
+++ b/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/errorreporting_gapic.legacy.yaml
@@ -0,0 +1,223 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.errorreporting.v1beta1
+  python:
+    package_name: google.cloud.errorreporting_v1beta1.gapic
+  go:
+    package_name: cloud.google.com/go/errorreporting/apiv1beta1
+    domain_layer_location: cloud.google.com/go/errorreporting
+  csharp:
+    package_name: Google.Cloud.ErrorReporting.V1Beta1
+  ruby:
+    package_name: Google::Cloud::ErrorReporting::V1beta1
+  php:
+    package_name: Google\Cloud\ErrorReporting\V1beta1
+  nodejs:
+    package_name: errorreporting.v1beta1
+    domain_layer_location: google-cloud
+collections:
+- name_pattern: projects/{project}
+  entity_name: project
+  language_overrides:
+  - language: csharp
+    common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
+- name_pattern: projects/{project}/groups/{group}
+  entity_name: group
+interfaces:
+- name: google.devtools.clouderrorreporting.v1beta1.ErrorGroupService
+  collections:
+  - name_pattern: projects/{project}/groups/{group}
+    entity_name: group
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  methods:
+  - name: GetGroup
+    flattening:
+      groups:
+      - parameters:
+        - group_name
+    required_fields:
+    - group_name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      group_name: group
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: UpdateGroup
+    flattening:
+      groups:
+      - parameters:
+        - group
+    required_fields:
+    - group
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      group.name: group
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+- name: google.devtools.clouderrorreporting.v1beta1.ReportErrorsService
+  smoke_test:
+    method: ReportErrorEvent
+    init_fields:
+    - project_name%project=$PROJECT_ID
+    - event.message="[MESSAGE]"
+    - event.service_context.service="[SERVICE]"
+    - event.context.report_location.file_path="path/to/file.lang"
+    - event.context.report_location.line_number=42
+    - event.context.report_location.function_name="meaningOfLife"
+  collections:
+  - name_pattern: projects/{project}
+    entity_name: project
+    language_overrides:
+    - language: csharp
+      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  methods:
+  - name: ReportErrorEvent
+    flattening:
+      groups:
+      - parameters:
+        - project_name
+        - event
+    required_fields:
+    - project_name
+    - event
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      project_name: project
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+- name: google.devtools.clouderrorreporting.v1beta1.ErrorStatsService
+  collections:
+  - name_pattern: projects/{project}
+    entity_name: project
+    language_overrides:
+    - language: csharp
+      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  methods:
+  - name: ListGroupStats
+    flattening:
+      groups:
+      - parameters:
+        - project_name
+        - time_range
+    required_fields:
+    - project_name
+    - time_range
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: error_group_stats
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      project_name: project
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: ListEvents
+    flattening:
+      groups:
+      - parameters:
+        - project_name
+        - group_id
+    required_fields:
+    - project_name
+    - group_id
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: error_events
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      project_name: project
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: DeleteEvents
+    flattening:
+      groups:
+      - parameters:
+        - project_name
+    required_fields:
+    - project_name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      project_name: project
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+resource_name_generation:
+- message_name: ErrorGroup
+  field_entity_map:
+    name: group
+- message_name: GetGroupRequest
+  field_entity_map:
+    group_name: group
+- message_name: ListGroupStatsRequest
+  field_entity_map:
+    project_name: project
+- message_name: ListEventsRequest
+  field_entity_map:
+    project_name: project
+- message_name: DeleteEventsRequest
+  field_entity_map:
+    project_name: project
+- message_name: ReportErrorEventRequest
+  field_entity_map:
+    project_name: project
diff --git a/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/errorreporting_gapic.yaml b/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/errorreporting_gapic.yaml
index c373fa8d9..4b2f20899 100644
--- a/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/errorreporting_gapic.yaml
+++ b/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/errorreporting_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.errorreporting.v1beta1
@@ -17,62 +17,7 @@ language_settings:
   nodejs:
     package_name: errorreporting.v1beta1
     domain_layer_location: google-cloud
-collections:
-- name_pattern: projects/{project}
-  entity_name: project
-  language_overrides:
-  - language: csharp
-    common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
-- name_pattern: projects/{project}/groups/{group}
-  entity_name: group
 interfaces:
-- name: google.devtools.clouderrorreporting.v1beta1.ErrorGroupService
-  collections:
-  - name_pattern: projects/{project}/groups/{group}
-    entity_name: group
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  methods:
-  - name: GetGroup
-    flattening:
-      groups:
-      - parameters:
-        - group_name
-    required_fields:
-    - group_name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      group_name: group
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: UpdateGroup
-    flattening:
-      groups:
-      - parameters:
-        - group
-    required_fields:
-    - group
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      group.name: group
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
 - name: google.devtools.clouderrorreporting.v1beta1.ReportErrorsService
   smoke_test:
     method: ReportErrorEvent
@@ -83,141 +28,11 @@ interfaces:
     - event.context.report_location.file_path="path/to/file.lang"
     - event.context.report_location.line_number=42
     - event.context.report_location.function_name="meaningOfLife"
-  collections:
-  - name_pattern: projects/{project}
-    entity_name: project
-    language_overrides:
-    - language: csharp
-      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
+- name: google.devtools.clouderrorreporting.v1beta1.ErrorGroupService
   methods:
-  - name: ReportErrorEvent
-    flattening:
-      groups:
-      - parameters:
-        - project_name
-        - event
-    required_fields:
-    - project_name
-    - event
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      project_name: project
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+  - name: UpdateGroup
+    retry_codes_name: idempotent
 - name: google.devtools.clouderrorreporting.v1beta1.ErrorStatsService
-  collections:
-  - name_pattern: projects/{project}
-    entity_name: project
-    language_overrides:
-    - language: csharp
-      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
   methods:
-  - name: ListGroupStats
-    flattening:
-      groups:
-        - parameters:
-          - project_name
-          - time_range
-    required_fields:
-    - project_name
-    - time_range
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: error_group_stats
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      project_name: project
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: ListEvents
-    flattening:
-      groups:
-      - parameters:
-        - project_name
-        - group_id
-    required_fields:
-    - project_name
-    - group_id
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: error_events
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      project_name: project
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
   - name: DeleteEvents
-    flattening:
-      groups:
-      - parameters:
-        - project_name
-    required_fields:
-    - project_name
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      project_name: project
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-resource_name_generation:
-- message_name: ErrorGroup
-  field_entity_map:
-    name: group
-- message_name: GetGroupRequest
-  field_entity_map:
-    group_name: group
-- message_name: ListGroupStatsRequest
-  field_entity_map:
-    project_name: project
-- message_name: ListEventsRequest
-  field_entity_map:
-    project_name: project
-- message_name: DeleteEventsRequest
-  field_entity_map:
-    project_name: project
-- message_name: ReportErrorEventRequest
-  field_entity_map:
-    project_name: project
diff --git a/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/errorreporting_grpc_service_config.json b/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/errorreporting_grpc_service_config.json
new file mode 100755
index 000000000..d2515bba6
--- /dev/null
+++ b/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/errorreporting_grpc_service_config.json
@@ -0,0 +1,32 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.devtools.clouderrorreporting.v1beta1.ErrorStatsService"
+        },
+        {
+          "service": "google.devtools.clouderrorreporting.v1beta1.ErrorGroupService"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.devtools.clouderrorreporting.v1beta1.ReportErrorsService"
+        }
+      ],
+      "timeout": "600s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/report_errors_service.proto b/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/report_errors_service.proto
index d77f646ce..fe80fcef0 100644
--- a/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/report_errors_service.proto
+++ b/third_party/googleapis/google/devtools/clouderrorreporting/v1beta1/report_errors_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2016 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,15 +11,20 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.devtools.clouderrorreporting.v1beta1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/devtools/clouderrorreporting/v1beta1/common.proto";
 import "google/protobuf/timestamp.proto";
 
+option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.ErrorReporting.V1Beta1";
 option go_package = "google.golang.org/genproto/googleapis/devtools/clouderrorreporting/v1beta1;clouderrorreporting";
 option java_multiple_files = true;
@@ -29,57 +34,87 @@ option php_namespace = "Google\\Cloud\\ErrorReporting\\V1beta1";
 
 // An API for reporting error events.
 service ReportErrorsService {
+  option (google.api.default_host) = "clouderrorreporting.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Report an individual error event.
   //
-  // This endpoint accepts either an OAuth token,
-  // or an
-  // API key
+  // This endpoint accepts **either** an OAuth token,
+  // **or** an [API key](https://support.google.com/cloud/answer/6158862)
   // for authentication. To use an API key, append it to the URL as the value of
   // a `key` parameter. For example:
-  // 
POST
-  // https://clouderrorreporting.googleapis.com/v1beta1/projects/example-project/events:report?key=123ABC456

-  rpc ReportErrorEvent(ReportErrorEventRequest)
-      returns (ReportErrorEventResponse) {
+  //
+  // `POST
+  // https://clouderrorreporting.googleapis.com/v1beta1/projects/example-project/events:report?key=123ABC456`
+  rpc ReportErrorEvent(ReportErrorEventRequest) returns (ReportErrorEventResponse) {
     option (google.api.http) = {
       post: "/v1beta1/{project_name=projects/*}/events:report"
       body: "event"
     };
+    option (google.api.method_signature) = "project_name,event";
   }
 }
 
 // A request for reporting an individual error event.
 message ReportErrorEventRequest {
-  // [Required] The resource name of the Google Cloud Platform project. Written
+  // Required. The resource name of the Google Cloud Platform project. Written
   // as `projects/` plus the
   // [Google Cloud Platform project
   // ID](https://support.google.com/cloud/answer/6158840). Example:
   // `projects/my-project-123`.
-  string project_name = 1;
+  string project_name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
-  // [Required] The error event to be reported.
-  ReportedErrorEvent event = 2;
+  // Required. The error event to be reported.
+  ReportedErrorEvent event = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response for reporting an individual error event.
 // Data may be added to this message in the future.
-message ReportErrorEventResponse {}
+message ReportErrorEventResponse {
+
+}
 
 // An error event which is reported to the Error Reporting system.
 message ReportedErrorEvent {
-  // [Optional] Time when the event occurred.
+  // Optional. Time when the event occurred.
   // If not provided, the time when the event was received by the
   // Error Reporting system will be used.
-  google.protobuf.Timestamp event_time = 1;
+  google.protobuf.Timestamp event_time = 1 [(google.api.field_behavior) = OPTIONAL];
 
-  // [Required] The service context in which this error has occurred.
-  ServiceContext service_context = 2;
+  // Required. The service context in which this error has occurred.
+  ServiceContext service_context = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // [Required] A message describing the error. The message can contain an
-  // exception stack in one of the supported programming languages and formats.
-  // In that case, the message is parsed and detailed exception information
-  // is returned when retrieving the error event again.
-  string message = 3;
+  // Required. The error message.
+  // If no `context.reportLocation` is provided, the message must contain a
+  // header (typically consisting of the exception type name and an error
+  // message) and an exception stack trace in one of the supported programming
+  // languages and formats.
+  // Supported languages are Java, Python, JavaScript, Ruby, C#, PHP, and Go.
+  // Supported stack trace formats are:
+  //
+  // * **Java**: Must be the return value of
+  // [`Throwable.printStackTrace()`](https://docs.oracle.com/javase/7/docs/api/java/lang/Throwable.html#printStackTrace%28%29).
+  // * **Python**: Must be the return value of
+  // [`traceback.format_exc()`](https://docs.python.org/2/library/traceback.html#traceback.format_exc).
+  // * **JavaScript**: Must be the value of
+  // [`error.stack`](https://github.com/v8/v8/wiki/Stack-Trace-API) as returned
+  // by V8.
+  // * **Ruby**: Must contain frames returned by
+  // [`Exception.backtrace`](https://ruby-doc.org/core-2.2.0/Exception.html#method-i-backtrace).
+  // * **C#**: Must be the return value of
+  // [`Exception.ToString()`](https://msdn.microsoft.com/en-us/library/system.exception.tostring.aspx).
+  // * **PHP**: Must start with `PHP (Notice|Parse error|Fatal error|Warning)`
+  // and contain the result of
+  // [`(string)$exception`](http://php.net/manual/en/exception.tostring.php).
+  // * **Go**: Must be the return value of
+  // [`runtime.Stack()`](https://golang.org/pkg/runtime/debug/#Stack).
+  string message = 3 [(google.api.field_behavior) = REQUIRED];
 
-  // [Optional] A description of the context in which the error occurred.
-  ErrorContext context = 4;
+  // Optional. A description of the context in which the error occurred.
+  ErrorContext context = 4 [(google.api.field_behavior) = OPTIONAL];
 }
diff --git a/third_party/googleapis/google/devtools/cloudtrace/BUILD.bazel b/third_party/googleapis/google/devtools/cloudtrace/BUILD.bazel
index 1e5b8c2af..a87c57fec 100644
--- a/third_party/googleapis/google/devtools/cloudtrace/BUILD.bazel
+++ b/third_party/googleapis/google/devtools/cloudtrace/BUILD.bazel
@@ -1 +1 @@
-exports_files(glob(["*.yaml"]))
\ No newline at end of file
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/devtools/cloudtrace/artman_cloudtrace_v1.yaml b/third_party/googleapis/google/devtools/cloudtrace/artman_cloudtrace_v1.yaml
index 595cf1040..d607933df 100644
--- a/third_party/googleapis/google/devtools/cloudtrace/artman_cloudtrace_v1.yaml
+++ b/third_party/googleapis/google/devtools/cloudtrace/artman_cloudtrace_v1.yaml
@@ -3,11 +3,12 @@ common:
   api_version: v1
   organization_name: google-cloud
   proto_deps:
-    - name: google-common-protos
+  - name: google-common-protos
   src_proto_paths:
   - v1
-  service_yaml: cloudtrace_v1.yaml
+  service_yaml: v1/cloudtrace_v1.yaml
   gapic_yaml: v1/cloudtrace_gapic.yaml
+  proto_package: google.devtools.cloudtrace.v1
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/devtools/cloudtrace/artman_cloudtrace_v2.yaml b/third_party/googleapis/google/devtools/cloudtrace/artman_cloudtrace_v2.yaml
index c4fad37fe..c58bf9ee4 100644
--- a/third_party/googleapis/google/devtools/cloudtrace/artman_cloudtrace_v2.yaml
+++ b/third_party/googleapis/google/devtools/cloudtrace/artman_cloudtrace_v2.yaml
@@ -3,11 +3,12 @@ common:
   api_version: v2
   organization_name: google-cloud
   proto_deps:
-    - name: google-common-protos
+  - name: google-common-protos
   src_proto_paths:
   - v2
-  service_yaml: cloudtrace_v2.yaml
+  service_yaml: v2/cloudtrace_v2.yaml
   gapic_yaml: v2/cloudtrace_gapic.yaml
+  proto_package: google.devtools.cloudtrace.v2
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/devtools/cloudtrace/v1/BUILD.bazel b/third_party/googleapis/google/devtools/cloudtrace/v1/BUILD.bazel
index 1626d051a..fd43a7575 100644
--- a/third_party/googleapis/google/devtools/cloudtrace/v1/BUILD.bazel
+++ b/third_party/googleapis/google/devtools/cloudtrace/v1/BUILD.bazel
@@ -1,26 +1,35 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
-    name = "trace_proto",
+    name = "cloudtrace_proto",
     srcs = [
         "trace.proto",
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
         "@com_google_protobuf//:empty_proto",
         "@com_google_protobuf//:timestamp_proto",
     ],
 )
 
 proto_library_with_info(
-    name = "trace_proto_with_info",
-    deps = [":trace_proto"],
+    name = "cloudtrace_proto_with_info",
+    deps = [
+        ":cloudtrace_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -28,69 +37,55 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
-    name = "trace_java_proto",
-    deps = [":trace_proto"],
+    name = "cloudtrace_java_proto",
+    deps = [":cloudtrace_proto"],
 )
 
 java_grpc_library(
-    name = "trace_java_grpc",
-    srcs = [":trace_proto"],
-    deps = [":trace_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "trace_resource_name_java_proto",
-    gapic_yaml = "cloudtrace_gapic.yaml",
-    deps = [":trace_proto"],
+    name = "cloudtrace_java_grpc",
+    srcs = [":cloudtrace_proto"],
+    deps = [":cloudtrace_java_proto"],
 )
 
 java_gapic_library(
-    name = "trace_java_gapic",
-    src = ":trace_proto_with_info",
+    name = "cloudtrace_java_gapic",
+    src = ":cloudtrace_proto_with_info",
     gapic_yaml = "cloudtrace_gapic.yaml",
-    service_yaml = "//google/devtools/cloudtrace:cloudtrace_v1.yaml",
-    test_deps = [":trace_java_grpc"],
+    package = "google.devtools.cloudtrace.v1",
+    service_yaml = "cloudtrace_v1.yaml",
+    test_deps = [
+        ":cloudtrace_java_grpc",
+    ],
     deps = [
-        ":trace_java_proto",
-        ":trace_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+        ":cloudtrace_java_proto",
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [":trace_java_gapic_test"],
-) for test_name in [
-    "com.google.cloud.trace.v1.TraceServiceClientTest",
-]]
+java_gapic_test(
+    name = "cloudtrace_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.trace.v1.TraceServiceClientTest",
+    ],
+    runtime_deps = [":cloudtrace_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
-    name = "google-cloud-trace-v1-java",
-    client_deps = [":trace_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":trace_java_gapic_test"],
-    grpc_deps = [":trace_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
-        ":trace_java_proto",
-        ":trace_proto",
-        ":trace_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    name = "google-cloud-devtools-cloudtrace-v1-java",
+    deps = [
+        ":cloudtrace_java_gapic",
+        ":cloudtrace_java_grpc",
+        ":cloudtrace_java_proto",
+        ":cloudtrace_proto",
+    ],
 )
 
 ##############################################################################
@@ -98,43 +93,286 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
-    name = "trace_go_proto",
+    name = "cloudtrace_go_proto",
     compilers = ["@io_bazel_rules_go//proto:go_grpc"],
     importpath = "google.golang.org/genproto/googleapis/devtools/cloudtrace/v1",
-    protos = [":trace_proto"],
-    deps = ["//google/api:annotations_go_proto"],
+    protos = [":cloudtrace_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
 )
 
 go_gapic_library(
-    name = "trace_go_gapic",
-    src = ":trace_proto_with_info",
-    gapic_yaml = "cloudtrace_gapic.yaml",
-    importpath = "cloud.google.com/go/trace/apiv1",
-    service_yaml = "//google/devtools/cloudtrace:cloudtrace_v1.yaml",
-    deps = [":trace_go_proto"],
+    name = "cloudtrace_go_gapic",
+    srcs = [":cloudtrace_proto_with_info"],
+    grpc_service_config = "cloudtrace_grpc_service_config.json",
+    importpath = "cloud.google.com/go/trace/apiv1;trace",
+    service_yaml = "cloudtrace_v1.yaml",
+    deps = [
+        ":cloudtrace_go_proto",
+    ],
 )
 
 go_test(
-    name = "trace_go_gapic_test",
-    srcs = [":trace_go_gapic_srcjar_test"],
-    embed = [":trace_go_gapic"],
+    name = "cloudtrace_go_gapic_test",
+    srcs = [":cloudtrace_go_gapic_srcjar_test"],
+    embed = [":cloudtrace_go_gapic"],
     importpath = "cloud.google.com/go/trace/apiv1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
-    name = "gapi-cloud-trace-v1-go",
+    name = "gapi-cloud-devtools-cloudtrace-v1-go",
+    deps = [
+        ":cloudtrace_go_gapic",
+        ":cloudtrace_go_gapic_srcjar-test.srcjar",
+        ":cloudtrace_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "cloudtrace_moved_proto",
+    srcs = [":cloudtrace_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "cloudtrace_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":cloudtrace_moved_proto"],
+)
+
+py_grpc_library(
+    name = "cloudtrace_py_grpc",
+    srcs = [":cloudtrace_moved_proto"],
+    deps = [":cloudtrace_py_proto"],
+)
+
+py_gapic_library(
+    name = "cloudtrace_py_gapic",
+    src = ":cloudtrace_proto_with_info",
+    gapic_yaml = "cloudtrace_gapic.yaml",
+    package = "google.devtools.cloudtrace.v1",
+    service_yaml = "cloudtrace_v1.yaml",
+    deps = [
+        ":cloudtrace_py_grpc",
+        ":cloudtrace_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "devtools-cloudtrace-v1-py",
+    deps = [
+        ":cloudtrace_py_gapic",
+        ":cloudtrace_py_grpc",
+        ":cloudtrace_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "cloudtrace_php_proto",
+    deps = [":cloudtrace_proto"],
+)
+
+php_grpc_library(
+    name = "cloudtrace_php_grpc",
+    srcs = [":cloudtrace_proto"],
+    deps = [":cloudtrace_php_proto"],
+)
+
+php_gapic_library(
+    name = "cloudtrace_php_gapic",
+    src = ":cloudtrace_proto_with_info",
+    gapic_yaml = "cloudtrace_gapic.yaml",
+    package = "google.devtools.cloudtrace.v1",
+    service_yaml = "cloudtrace_v1.yaml",
+    deps = [
+        ":cloudtrace_php_grpc",
+        ":cloudtrace_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-devtools-cloudtrace-v1-php",
+    deps = [
+        ":cloudtrace_php_gapic",
+        ":cloudtrace_php_grpc",
+        ":cloudtrace_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "cloudtrace_nodejs_gapic",
+    src = ":cloudtrace_proto_with_info",
+    gapic_yaml = "cloudtrace_gapic.yaml",
+    package = "google.devtools.cloudtrace.v1",
+    service_yaml = "cloudtrace_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "devtools-cloudtrace-v1-nodejs",
     deps = [
-        ":trace_go_gapic",
-        ":trace_go_gapic_srcjar-smoke-test.srcjar",
-        ":trace_go_gapic_srcjar-test.srcjar",
-        ":trace_go_proto",
+        ":cloudtrace_nodejs_gapic",
+        ":cloudtrace_proto",
     ],
 )
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "cloudtrace_ruby_proto",
+    deps = [":cloudtrace_proto"],
+)
+
+ruby_grpc_library(
+    name = "cloudtrace_ruby_grpc",
+    srcs = [":cloudtrace_proto"],
+    deps = [":cloudtrace_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "cloudtrace_ruby_gapic",
+    src = ":cloudtrace_proto_with_info",
+    gapic_yaml = "cloudtrace_gapic.yaml",
+    package = "google.devtools.cloudtrace.v1",
+    service_yaml = "cloudtrace_v1.yaml",
+    deps = [
+        ":cloudtrace_ruby_grpc",
+        ":cloudtrace_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-devtools-cloudtrace-v1-ruby",
+    deps = [
+        ":cloudtrace_ruby_gapic",
+        ":cloudtrace_ruby_grpc",
+        ":cloudtrace_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "cloudtrace_csharp_proto",
+    deps = [":cloudtrace_proto"],
+)
+
+csharp_grpc_library(
+    name = "cloudtrace_csharp_grpc",
+    srcs = [":cloudtrace_proto"],
+    deps = [":cloudtrace_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "cloudtrace_csharp_gapic",
+    src = ":cloudtrace_proto_with_info",
+    gapic_yaml = "cloudtrace_gapic.yaml",
+    package = "google.devtools.cloudtrace.v1",
+    service_yaml = "cloudtrace_v1.yaml",
+    deps = [
+        ":cloudtrace_csharp_grpc",
+        ":cloudtrace_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-devtools-cloudtrace-v1-csharp",
+    deps = [
+        ":cloudtrace_csharp_gapic",
+        ":cloudtrace_csharp_grpc",
+        ":cloudtrace_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "cc_grpc_library",
+    "cc_proto_library",
+)
+
+cc_proto_library(
+    name = "cloudtrace_cc_proto",
+    deps = [":cloudtrace_proto"],
+)
+
+cc_grpc_library(
+    name = "cloudtrace_cc_grpc",
+    srcs = [":cloudtrace_proto"],
+    generate_mocks = True,
+    grpc_only = True,
+    deps = [":cloudtrace_cc_proto"],
+)
+
diff --git a/third_party/googleapis/google/devtools/cloudtrace/v1/cloudtrace_gapic.legacy.yaml b/third_party/googleapis/google/devtools/cloudtrace/v1/cloudtrace_gapic.legacy.yaml
new file mode 100644
index 000000000..df4df5eb4
--- /dev/null
+++ b/third_party/googleapis/google/devtools/cloudtrace/v1/cloudtrace_gapic.legacy.yaml
@@ -0,0 +1,84 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.trace.v1
+  python:
+    package_name: google.cloud.trace_v1.gapic
+  ruby:
+    package_name: Google::Cloud::Trace::V1
+  php:
+    package_name: Google\Cloud\Trace\V1
+  nodejs:
+    package_name: trace.v1
+    domain_layer_location: google-cloud
+  go:
+    package_name: cloud.google.com/go/trace/apiv1
+    domain_layer_location: cloud.google.com/go/trace
+  csharp:
+    package_name: Google.Cloud.Trace.V1
+    release_level: GA
+interfaces:
+- name: google.devtools.cloudtrace.v1.TraceService
+  smoke_test:
+    method: ListTraces
+    init_fields:
+    - project_id=$PROJECT_ID
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.2
+    max_retry_delay_millis: 1000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1.5
+    max_rpc_timeout_millis: 30000
+    total_timeout_millis: 45000
+  methods:
+  - name: PatchTraces
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - traces
+    required_fields:
+    - project_id
+    - traces
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 30000
+  - name: GetTrace
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+        - trace_id
+    required_fields:
+    - project_id
+    - trace_id
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 30000
+  - name: ListTraces
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: traces
+    flattening:
+      groups:
+      - parameters:
+        - project_id
+    required_fields:
+    - project_id
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 30000
diff --git a/third_party/googleapis/google/devtools/cloudtrace/v1/cloudtrace_gapic.yaml b/third_party/googleapis/google/devtools/cloudtrace/v1/cloudtrace_gapic.yaml
index aba476351..0fbe03a80 100644
--- a/third_party/googleapis/google/devtools/cloudtrace/v1/cloudtrace_gapic.yaml
+++ b/third_party/googleapis/google/devtools/cloudtrace/v1/cloudtrace_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.trace.v1
@@ -24,13 +24,6 @@ interfaces:
     method: ListTraces
     init_fields:
     - project_id=$PROJECT_ID
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 100
@@ -42,43 +35,4 @@ interfaces:
     total_timeout_millis: 45000
   methods:
   - name: PatchTraces
-    flattening:
-      groups:
-        - parameters:
-          - project_id
-          - traces
-    required_fields:
-      - project_id
-      - traces
     retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 30000
-  - name: GetTrace
-    flattening:
-      groups:
-        - parameters:
-          - project_id
-          - trace_id
-    required_fields:
-      - project_id
-      - trace_id
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 30000
-  - name: ListTraces
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: traces
-    flattening:
-      groups:
-        - parameters:
-          - project_id
-    required_fields:
-      - project_id
-    retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 30000
diff --git a/third_party/googleapis/google/devtools/cloudtrace/v1/cloudtrace_grpc_service_config.json b/third_party/googleapis/google/devtools/cloudtrace/v1/cloudtrace_grpc_service_config.json
new file mode 100755
index 000000000..b2158e7d6
--- /dev/null
+++ b/third_party/googleapis/google/devtools/cloudtrace/v1/cloudtrace_grpc_service_config.json
@@ -0,0 +1,30 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.devtools.cloudtrace.v1.TraceService",
+          "method": "PatchTraces"
+        },
+        {
+          "service": "google.devtools.cloudtrace.v1.TraceService",
+          "method": "GetTrace"
+        },
+        {
+          "service": "google.devtools.cloudtrace.v1.TraceService",
+          "method": "ListTraces"
+        }
+      ],
+      "timeout": "45s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "1s",
+        "backoffMultiplier": 1.2,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/devtools/cloudtrace/cloudtrace_v1.yaml b/third_party/googleapis/google/devtools/cloudtrace/v1/cloudtrace_v1.yaml
similarity index 60%
rename from third_party/googleapis/google/devtools/cloudtrace/cloudtrace_v1.yaml
rename to third_party/googleapis/google/devtools/cloudtrace/v1/cloudtrace_v1.yaml
index 6bbe06460..a913f7988 100644
--- a/third_party/googleapis/google/devtools/cloudtrace/cloudtrace_v1.yaml
+++ b/third_party/googleapis/google/devtools/cloudtrace/v1/cloudtrace_v1.yaml
@@ -8,30 +8,31 @@ apis:
 
 documentation:
   summary: |-
-    Sends application trace data to Stackdriver Trace for viewing. Trace data is
-    collected for all App Engine applications by default. Trace data from other
-    applications can be provided using this API.
+    Sends application trace data to Stackdriver Trace for viewing. Trace data
+    is collected for all App Engine applications by default. Trace data from
+    other applications can be provided using this API. This library is used to
+    interact with the Trace API directly. If you are looking to instrument
+    your application for Stackdriver Trace, we recommend using OpenCensus.
 
 backend:
   rules:
-  - selector: google.devtools.cloudtrace.v1.TraceService.ListTraces
-    deadline: 60.0
-  - selector: google.devtools.cloudtrace.v1.TraceService.GetTrace
-    deadline: 60.0
-  - selector: google.devtools.cloudtrace.v1.TraceService.PatchTraces
+  - selector: 'google.devtools.cloudtrace.v1.TraceService.*'
     deadline: 60.0
 
 authentication:
   rules:
-  - selector: '*'
+  - selector: google.devtools.cloudtrace.v1.TraceService.GetTrace
     oauth:
       canonical_scopes: |-
         https://www.googleapis.com/auth/cloud-platform,
-        https://www.googleapis.com/auth/trace.append
-  - selector: |-
-      google.devtools.cloudtrace.v1.TraceService.GetTrace,
-      google.devtools.cloudtrace.v1.TraceService.ListTraces
+        https://www.googleapis.com/auth/trace.readonly
+  - selector: google.devtools.cloudtrace.v1.TraceService.ListTraces
     oauth:
       canonical_scopes: |-
         https://www.googleapis.com/auth/cloud-platform,
         https://www.googleapis.com/auth/trace.readonly
+  - selector: google.devtools.cloudtrace.v1.TraceService.PatchTraces
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/trace.append
diff --git a/third_party/googleapis/google/devtools/cloudtrace/v1/trace.proto b/third_party/googleapis/google/devtools/cloudtrace/v1/trace.proto
index 16af3a6ec..00cc14db3 100644
--- a/third_party/googleapis/google/devtools/cloudtrace/v1/trace.proto
+++ b/third_party/googleapis/google/devtools/cloudtrace/v1/trace.proto
@@ -1,4 +1,4 @@
-// Copyright 2017 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -17,6 +17,9 @@ syntax = "proto3";
 package google.devtools.cloudtrace.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/timestamp.proto";
 
@@ -33,11 +36,18 @@ option php_namespace = "Google\\Cloud\\Trace\\V1";
 // timed event which forms a node of the trace tree. Spans for a single trace
 // may span multiple services.
 service TraceService {
+  option (google.api.default_host) = "cloudtrace.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/trace.append,"
+      "https://www.googleapis.com/auth/trace.readonly";
+
   // Returns of a list of traces that match the specified filter conditions.
   rpc ListTraces(ListTracesRequest) returns (ListTracesResponse) {
     option (google.api.http) = {
       get: "/v1/projects/{project_id}/traces"
     };
+    option (google.api.method_signature) = "project_id";
   }
 
   // Gets a single trace by its ID.
@@ -45,6 +55,7 @@ service TraceService {
     option (google.api.http) = {
       get: "/v1/projects/{project_id}/traces/{trace_id}"
     };
+    option (google.api.method_signature) = "project_id,trace_id";
   }
 
   // Sends new traces to Stackdriver Trace or updates existing traces. If the ID
@@ -57,6 +68,7 @@ service TraceService {
       patch: "/v1/projects/{project_id}/traces"
       body: "traces"
     };
+    option (google.api.method_signature) = "project_id,traces";
   }
 }
 
@@ -68,7 +80,8 @@ message Trace {
   string project_id = 1;
 
   // Globally unique identifier for the trace. This identifier is a 128-bit
-  // numeric value formatted as a 32-byte hex string.
+  // numeric value formatted as a 32-byte hex string. For example,
+  // `382d4f4c6b7bb2f4a972559d9085001d`.
   string trace_id = 2;
 
   // Collection of spans in the trace.
@@ -103,7 +116,7 @@ message TraceSpan {
   }
 
   // Identifier for the span. Must be a 64-bit integer other than 0 and
-  // unique within a trace.
+  // unique within a trace. For example, `2205310701640571284`.
   fixed64 span_id = 1;
 
   // Distinguishes between spans generated in a particular context. For example,
@@ -113,7 +126,7 @@ message TraceSpan {
 
   // Name of the span. Must be less than 128 bytes. The span name is sanitized
   // and displayed in the Stackdriver Trace tool in the
-  // {% dynamic print site_values.console_name %}.
+  // Google Cloud Platform Console.
   // The name may be a method name or some other per-call site name.
   // For the same executable and the same call point, a best practice is
   // to use a consistent name, which makes it easier to correlate
@@ -126,8 +139,8 @@ message TraceSpan {
   // End time of the span in nanoseconds from the UNIX epoch.
   google.protobuf.Timestamp end_time = 5;
 
-  // ID of the parent span, if any. Optional.
-  fixed64 parent_span_id = 6;
+  // Optional. ID of the parent span, if any.
+  fixed64 parent_span_id = 6 [(google.api.field_behavior) = OPTIONAL];
 
   // Collection of labels associated with the span. Label keys must be less than
   // 128 bytes. Label values must be less than 16 kilobytes (10MB for
@@ -189,20 +202,20 @@ message ListTracesRequest {
     COMPLETE = 3;
   }
 
-  // ID of the Cloud project where the trace data is stored.
-  string project_id = 1;
+  // Required. ID of the Cloud project where the trace data is stored.
+  string project_id = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Type of data returned for traces in the list. Optional. Default is
+  // Optional. Type of data returned for traces in the list. Default is
   // `MINIMAL`.
-  ViewType view = 2;
+  ViewType view = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // Maximum number of traces to return. If not specified or <= 0, the
+  // Optional. Maximum number of traces to return. If not specified or <= 0, the
   // implementation selects a reasonable value.  The implementation may
-  // return fewer traces than the requested page size. Optional.
-  int32 page_size = 3;
+  // return fewer traces than the requested page size.
+  int32 page_size = 3 [(google.api.field_behavior) = OPTIONAL];
 
   // Token identifying the page of results to return. If provided, use the
-  // value of the `next_page_token` field from a previous request. Optional.
+  // value of the `next_page_token` field from a previous request.
   string page_token = 4;
 
   // Start of the time interval (inclusive) during which the trace data was
@@ -213,7 +226,7 @@ message ListTracesRequest {
   // collected from the application.
   google.protobuf.Timestamp end_time = 6;
 
-  // An optional filter against labels for the request.
+  // Optional. A filter against labels for the request.
   //
   // By default, searches use prefix matching. To specify exact match, prepend
   // a plus symbol (`+`) to the search term.
@@ -243,9 +256,9 @@ message ListTracesRequest {
   //     specified.
   // *   `method:VALUE`: Equivalent to `/http/method:VALUE`.
   // *   `url:VALUE`: Equivalent to `/http/url:VALUE`.
-  string filter = 7;
+  string filter = 7 [(google.api.field_behavior) = OPTIONAL];
 
-  // Field used to sort the returned traces. Optional.
+  // Optional. Field used to sort the returned traces.
   // Can be one of the following:
   //
   // *   `trace_id`
@@ -258,12 +271,12 @@ message ListTracesRequest {
   // (for example, `name desc`).
   //
   // Only one sort field is permitted.
-  string order_by = 8;
+  string order_by = 8 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // The response message for the `ListTraces` method.
 message ListTracesResponse {
-  // List of trace records returned.
+  // List of trace records as specified by the view parameter.
   repeated Trace traces = 1;
 
   // If defined, indicates that there are more traces that match the request
@@ -274,18 +287,18 @@ message ListTracesResponse {
 
 // The request message for the `GetTrace` method.
 message GetTraceRequest {
-  // ID of the Cloud project where the trace data is stored.
-  string project_id = 1;
+  // Required. ID of the Cloud project where the trace data is stored.
+  string project_id = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // ID of the trace to return.
-  string trace_id = 2;
+  // Required. ID of the trace to return.
+  string trace_id = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The request message for the `PatchTraces` method.
 message PatchTracesRequest {
-  // ID of the Cloud project where the trace data is stored.
-  string project_id = 1;
+  // Required. ID of the Cloud project where the trace data is stored.
+  string project_id = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // The body of the message.
-  Traces traces = 2;
+  // Required. The body of the message.
+  Traces traces = 2 [(google.api.field_behavior) = REQUIRED];
 }
diff --git a/third_party/googleapis/google/devtools/cloudtrace/v2/BUILD.bazel b/third_party/googleapis/google/devtools/cloudtrace/v2/BUILD.bazel
index 7b0b77dcb..0006efaf1 100644
--- a/third_party/googleapis/google/devtools/cloudtrace/v2/BUILD.bazel
+++ b/third_party/googleapis/google/devtools/cloudtrace/v2/BUILD.bazel
@@ -1,19 +1,25 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
-    name = "trace_proto",
+    name = "cloudtrace_proto",
     srcs = [
         "trace.proto",
         "tracing.proto",
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
         "//google/rpc:status_proto",
         "@com_google_protobuf//:empty_proto",
         "@com_google_protobuf//:timestamp_proto",
@@ -22,8 +28,11 @@ proto_library(
 )
 
 proto_library_with_info(
-    name = "trace_proto_with_info",
-    deps = [":trace_proto"],
+    name = "cloudtrace_proto_with_info",
+    deps = [
+        ":cloudtrace_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -31,69 +40,55 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
-    name = "trace_java_proto",
-    deps = [":trace_proto"],
+    name = "cloudtrace_java_proto",
+    deps = [":cloudtrace_proto"],
 )
 
 java_grpc_library(
-    name = "trace_java_grpc",
-    srcs = [":trace_proto"],
-    deps = [":trace_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "trace_resource_name_java_proto",
-    gapic_yaml = "cloudtrace_gapic.yaml",
-    deps = [":trace_proto"],
+    name = "cloudtrace_java_grpc",
+    srcs = [":cloudtrace_proto"],
+    deps = [":cloudtrace_java_proto"],
 )
 
 java_gapic_library(
-    name = "trace_java_gapic",
-    src = ":trace_proto_with_info",
+    name = "cloudtrace_java_gapic",
+    src = ":cloudtrace_proto_with_info",
     gapic_yaml = "cloudtrace_gapic.yaml",
-    service_yaml = "//google/devtools/cloudtrace:cloudtrace_v2.yaml",
-    test_deps = [":trace_java_grpc"],
+    package = "google.devtools.cloudtrace.v2",
+    service_yaml = "cloudtrace_v2.yaml",
+    test_deps = [
+        ":cloudtrace_java_grpc",
+    ],
     deps = [
-        ":trace_java_proto",
-        ":trace_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+        ":cloudtrace_java_proto",
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [":trace_java_gapic_test"],
-) for test_name in [
-    "com.google.cloud.trace.v2.TraceServiceClientTest",
-]]
+java_gapic_test(
+    name = "cloudtrace_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.trace.v2.TraceServiceClientTest",
+    ],
+    runtime_deps = [":cloudtrace_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
-    name = "google-cloud-trace-v2-java",
-    client_deps = [":trace_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":trace_java_gapic_test"],
-    grpc_deps = [":trace_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
-        ":trace_java_proto",
-        ":trace_proto",
-        ":trace_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    name = "google-cloud-devtools-cloudtrace-v2-java",
+    deps = [
+        ":cloudtrace_java_gapic",
+        ":cloudtrace_java_grpc",
+        ":cloudtrace_java_proto",
+        ":cloudtrace_proto",
+    ],
 )
 
 ##############################################################################
@@ -101,17 +96,17 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
-    name = "trace_go_proto",
+    name = "cloudtrace_go_proto",
     compilers = ["@io_bazel_rules_go//proto:go_grpc"],
     importpath = "google.golang.org/genproto/googleapis/devtools/cloudtrace/v2",
-    protos = [":trace_proto"],
+    protos = [":cloudtrace_proto"],
     deps = [
         "//google/api:annotations_go_proto",
         "//google/rpc:status_go_proto",
@@ -119,29 +114,249 @@ go_proto_library(
 )
 
 go_gapic_library(
-    name = "trace_go_gapic",
-    src = ":trace_proto_with_info",
-    gapic_yaml = "cloudtrace_gapic.yaml",
-    importpath = "cloud.google.com/go/trace/apiv2",
-    service_yaml = "//google/devtools/cloudtrace:cloudtrace_v2.yaml",
-    deps = [":trace_go_proto"],
+    name = "cloudtrace_go_gapic",
+    srcs = [":cloudtrace_proto_with_info"],
+    grpc_service_config = "cloudtrace_grpc_service_config.json",
+    importpath = "cloud.google.com/go/trace/apiv2;trace",
+    service_yaml = "cloudtrace_v2.yaml",
+    deps = [
+        ":cloudtrace_go_proto",
+    ],
 )
 
 go_test(
-    name = "trace_go_gapic_test",
-    srcs = [":trace_go_gapic_srcjar_test"],
-    embed = [":trace_go_gapic"],
+    name = "cloudtrace_go_gapic_test",
+    srcs = [":cloudtrace_go_gapic_srcjar_test"],
+    embed = [":cloudtrace_go_gapic"],
     importpath = "cloud.google.com/go/trace/apiv2",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
-    name = "gapi-cloud-trace-v2-go",
+    name = "gapi-cloud-devtools-cloudtrace-v2-go",
+    deps = [
+        ":cloudtrace_go_gapic",
+        ":cloudtrace_go_gapic_srcjar-test.srcjar",
+        ":cloudtrace_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "cloudtrace_moved_proto",
+    srcs = [":cloudtrace_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/rpc:status_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:timestamp_proto",
+        "@com_google_protobuf//:wrappers_proto",
+    ],
+)
+
+py_proto_library(
+    name = "cloudtrace_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":cloudtrace_moved_proto"],
+)
+
+py_grpc_library(
+    name = "cloudtrace_py_grpc",
+    srcs = [":cloudtrace_moved_proto"],
+    deps = [":cloudtrace_py_proto"],
+)
+
+py_gapic_library(
+    name = "cloudtrace_py_gapic",
+    src = ":cloudtrace_proto_with_info",
+    gapic_yaml = "cloudtrace_gapic.yaml",
+    package = "google.devtools.cloudtrace.v2",
+    service_yaml = "cloudtrace_v2.yaml",
+    deps = [
+        ":cloudtrace_py_grpc",
+        ":cloudtrace_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "devtools-cloudtrace-v2-py",
+    deps = [
+        ":cloudtrace_py_gapic",
+        ":cloudtrace_py_grpc",
+        ":cloudtrace_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "cloudtrace_php_proto",
+    deps = [":cloudtrace_proto"],
+)
+
+php_grpc_library(
+    name = "cloudtrace_php_grpc",
+    srcs = [":cloudtrace_proto"],
+    deps = [":cloudtrace_php_proto"],
+)
+
+php_gapic_library(
+    name = "cloudtrace_php_gapic",
+    src = ":cloudtrace_proto_with_info",
+    gapic_yaml = "cloudtrace_gapic.yaml",
+    package = "google.devtools.cloudtrace.v2",
+    service_yaml = "cloudtrace_v2.yaml",
+    deps = [
+        ":cloudtrace_php_grpc",
+        ":cloudtrace_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-devtools-cloudtrace-v2-php",
+    deps = [
+        ":cloudtrace_php_gapic",
+        ":cloudtrace_php_grpc",
+        ":cloudtrace_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "cloudtrace_nodejs_gapic",
+    src = ":cloudtrace_proto_with_info",
+    gapic_yaml = "cloudtrace_gapic.yaml",
+    package = "google.devtools.cloudtrace.v2",
+    service_yaml = "cloudtrace_v2.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "devtools-cloudtrace-v2-nodejs",
+    deps = [
+        ":cloudtrace_nodejs_gapic",
+        ":cloudtrace_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "cloudtrace_ruby_proto",
+    deps = [":cloudtrace_proto"],
+)
+
+ruby_grpc_library(
+    name = "cloudtrace_ruby_grpc",
+    srcs = [":cloudtrace_proto"],
+    deps = [":cloudtrace_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "cloudtrace_ruby_gapic",
+    src = ":cloudtrace_proto_with_info",
+    gapic_yaml = "cloudtrace_gapic.yaml",
+    package = "google.devtools.cloudtrace.v2",
+    service_yaml = "cloudtrace_v2.yaml",
+    deps = [
+        ":cloudtrace_ruby_grpc",
+        ":cloudtrace_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-devtools-cloudtrace-v2-ruby",
+    deps = [
+        ":cloudtrace_ruby_gapic",
+        ":cloudtrace_ruby_grpc",
+        ":cloudtrace_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "cloudtrace_csharp_proto",
+    deps = [":cloudtrace_proto"],
+)
+
+csharp_grpc_library(
+    name = "cloudtrace_csharp_grpc",
+    srcs = [":cloudtrace_proto"],
+    deps = [":cloudtrace_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "cloudtrace_csharp_gapic",
+    src = ":cloudtrace_proto_with_info",
+    gapic_yaml = "cloudtrace_gapic.yaml",
+    package = "google.devtools.cloudtrace.v2",
+    service_yaml = "cloudtrace_v2.yaml",
+    deps = [
+        ":cloudtrace_csharp_grpc",
+        ":cloudtrace_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-devtools-cloudtrace-v2-csharp",
     deps = [
-        ":trace_go_gapic",
-        ":trace_go_gapic_srcjar-smoke-test.srcjar",
-        ":trace_go_gapic_srcjar-test.srcjar",
-        ":trace_go_proto",
+        ":cloudtrace_csharp_gapic",
+        ":cloudtrace_csharp_grpc",
+        ":cloudtrace_csharp_proto",
     ],
 )
 
@@ -155,13 +370,14 @@ load(
 )
 
 cc_proto_library(
-    name = "trace_cc_proto",
-    deps = [":trace_proto"],
+    name = "cloudtrace_cc_proto",
+    deps = [":cloudtrace_proto"],
 )
 
 cc_grpc_library(
-    name = "trace_cc_grpc",
-    srcs = [":trace_proto"],
-    deps = [":trace_cc_proto"],
+    name = "cloudtrace_cc_grpc",
+    srcs = [":cloudtrace_proto"],
+    generate_mocks = True,
     grpc_only = True,
+    deps = [":cloudtrace_cc_proto"],
 )
diff --git a/third_party/googleapis/google/devtools/cloudtrace/v2/cloudtrace_gapic.legacy.yaml b/third_party/googleapis/google/devtools/cloudtrace/v2/cloudtrace_gapic.legacy.yaml
new file mode 100644
index 000000000..e910ce446
--- /dev/null
+++ b/third_party/googleapis/google/devtools/cloudtrace/v2/cloudtrace_gapic.legacy.yaml
@@ -0,0 +1,141 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.trace.v2
+  python:
+    package_name: google.cloud.trace_v2.gapic
+  ruby:
+    package_name: Google::Cloud::Trace::V2
+    release_level: BETA
+  php:
+    package_name: Google\Cloud\Trace\V2
+  nodejs:
+    package_name: trace.v2
+    domain_layer_location: google-cloud
+  go:
+    package_name: cloud.google.com/go/trace/apiv2
+  csharp:
+    package_name: Google.Cloud.Trace.V2
+# A list of API interface configurations.
+interfaces:
+- name: google.devtools.cloudtrace.v2.TraceService
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}
+    entity_name: project
+    language_overrides:
+    - language: csharp
+      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
+  - name_pattern: projects/{project}/traces/{trace}/spans/{span}
+    entity_name: span
+  # Definition for smoke test.
+  smoke_test:
+    method: BatchWriteSpans
+    init_fields:
+    - name%project=$PROJECT_ID
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.2
+    max_retry_delay_millis: 1000
+    initial_rpc_timeout_millis: 30000
+    rpc_timeout_multiplier: 1.5
+    max_rpc_timeout_millis: 60000
+    total_timeout_millis: 120000
+
+  # A list of method configurations.
+  # Common properties:
+  #   name - The simple name of the method.
+  #   flattening - Specifies the configuration for parameter flattening.
+  #       Describes the parameter groups for which a generator should produce
+  #       method overloads which allow a client to directly pass request message
+  #       fields as method parameters. This information may or may not be used,
+  #       depending on the target language.
+  #       Consists of groups, which each represent a list of parameters to be
+  #       flattened. Each parameter listed must be a field of the request
+  #       message.
+  #   required_fields - Fields that are always required for a request to be
+  #       valid.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #       Describes information for generating a method which transforms a
+  #       paging list RPC into a stream of resources.
+  #       Consists of a request and a response.
+  #       The request specifies request information of the list method. It
+  #       defines which fields match the paging pattern in the request. The
+  #       request consists of a page_size_field and a token_field. The
+  #       page_size_field is the name of the optional field specifying the
+  #       maximum number of elements to be returned in the response. The
+  #       token_field is the name of the field in the request containing the
+  #       page token.
+  #       The response specifies response information of the list method. It
+  #       defines which fields match the paging pattern in the response. The
+  #       response consists of a token_field and a resources_field. The
+  #       token_field is the name of the field in the response containing the
+  #       next page token. The resources_field is the name of the field in the
+  #       response containing the list of resources belonging to the page.
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #       name must be defined in interfaces.retry_codes_def.
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #       parameters. The name must be defined in interfaces.retry_params_def.
+  #   field_name_patterns - Maps the field name of the request type to
+  #       entity_name of interfaces.collections.
+  #       Specifies the string pattern that the field must follow.
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #       the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: BatchWriteSpans
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - spans
+    required_fields:
+    - name
+    - spans
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: project
+    timeout_millis: 30000
+    resource_name_treatment: STATIC_TYPES
+  - name: CreateSpan
+    required_fields:
+    - name
+    - span_id
+    - display_name
+    - start_time
+    - end_time
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: span
+    timeout_millis: 30000
+    resource_name_treatment: STATIC_TYPES
+resource_name_generation:
+- message_name: BatchWriteSpansRequest
+  field_entity_map:
+    name: project
+- message_name: Span
+  field_entity_map:
+    name: span
diff --git a/third_party/googleapis/google/devtools/cloudtrace/v2/cloudtrace_gapic.yaml b/third_party/googleapis/google/devtools/cloudtrace/v2/cloudtrace_gapic.yaml
index ec5e02a20..b76bb7b2e 100644
--- a/third_party/googleapis/google/devtools/cloudtrace/v2/cloudtrace_gapic.yaml
+++ b/third_party/googleapis/google/devtools/cloudtrace/v2/cloudtrace_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -20,40 +20,11 @@ language_settings:
     package_name: Google.Cloud.Trace.V2
 # A list of API interface configurations.
 interfaces:
-  # The fully qualified name of the API interface.
 - name: google.devtools.cloudtrace.v2.TraceService
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections:
-  - name_pattern: projects/{project}
-    entity_name: project
-    language_overrides:
-    - language: csharp
-      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
-  - name_pattern: projects/{project}/traces/{trace}/spans/{span}
-    entity_name: span
-  # Definition for smoke test.
   smoke_test:
     method: BatchWriteSpans
     init_fields:
     - name%project=$PROJECT_ID
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 100
@@ -63,80 +34,6 @@ interfaces:
     rpc_timeout_multiplier: 1.5
     max_rpc_timeout_millis: 60000
     total_timeout_millis: 120000
-
-  # A list of method configurations.
-  # Common properties:
-  #   name - The simple name of the method.
-  #   flattening - Specifies the configuration for parameter flattening.
-  #       Describes the parameter groups for which a generator should produce
-  #       method overloads which allow a client to directly pass request message
-  #       fields as method parameters. This information may or may not be used,
-  #       depending on the target language.
-  #       Consists of groups, which each represent a list of parameters to be
-  #       flattened. Each parameter listed must be a field of the request
-  #       message.
-  #   required_fields - Fields that are always required for a request to be
-  #       valid.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #       Describes information for generating a method which transforms a
-  #       paging list RPC into a stream of resources.
-  #       Consists of a request and a response.
-  #       The request specifies request information of the list method. It
-  #       defines which fields match the paging pattern in the request. The
-  #       request consists of a page_size_field and a token_field. The
-  #       page_size_field is the name of the optional field specifying the
-  #       maximum number of elements to be returned in the response. The
-  #       token_field is the name of the field in the request containing the
-  #       page token.
-  #       The response specifies response information of the list method. It
-  #       defines which fields match the paging pattern in the response. The
-  #       response consists of a token_field and a resources_field. The
-  #       token_field is the name of the field in the response containing the
-  #       next page token. The resources_field is the name of the field in the
-  #       response containing the list of resources belonging to the page.
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #       name must be defined in interfaces.retry_codes_def.
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #       parameters. The name must be defined in interfaces.retry_params_def.
-  #   field_name_patterns - Maps the field name of the request type to
-  #       entity_name of interfaces.collections.
-  #       Specifies the string pattern that the field must follow.
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #       the call is retrying, refer to retry_params_name instead.
   methods:
-  - name: BatchWriteSpans
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - spans
-    required_fields:
-    - name
-    - spans
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: project
-    timeout_millis: 30000
-    resource_name_treatment: STATIC_TYPES
   - name: CreateSpan
-    required_fields:
-    - name
-    - span_id
-    - display_name
-    - start_time
-    - end_time
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: span
-    timeout_millis: 30000
-    resource_name_treatment: STATIC_TYPES
-resource_name_generation:
-- message_name: BatchWriteSpansRequest
-  field_entity_map:
-    name: project
-- message_name: Span
-  field_entity_map:
-    name: span
diff --git a/third_party/googleapis/google/devtools/cloudtrace/v2/cloudtrace_grpc_service_config.json b/third_party/googleapis/google/devtools/cloudtrace/v2/cloudtrace_grpc_service_config.json
new file mode 100755
index 000000000..5cc9b15ae
--- /dev/null
+++ b/third_party/googleapis/google/devtools/cloudtrace/v2/cloudtrace_grpc_service_config.json
@@ -0,0 +1,31 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.devtools.cloudtrace.v2.TraceService",
+          "method": "BatchWriteSpans"
+        }
+      ],
+      "timeout": "120s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.devtools.cloudtrace.v2.TraceService",
+          "method": "CreateSpan"
+        }
+      ],
+      "timeout": "120s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "1s",
+        "backoffMultiplier": 1.2,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/devtools/cloudtrace/cloudtrace_v2.yaml b/third_party/googleapis/google/devtools/cloudtrace/v2/cloudtrace_v2.yaml
similarity index 50%
rename from third_party/googleapis/google/devtools/cloudtrace/cloudtrace_v2.yaml
rename to third_party/googleapis/google/devtools/cloudtrace/v2/cloudtrace_v2.yaml
index 91cffdfee..6adad6520 100644
--- a/third_party/googleapis/google/devtools/cloudtrace/cloudtrace_v2.yaml
+++ b/third_party/googleapis/google/devtools/cloudtrace/v2/cloudtrace_v2.yaml
@@ -8,9 +8,11 @@ apis:
 
 documentation:
   summary: |-
-    Sends application trace data to Stackdriver Trace for viewing. Trace data is
-    collected for all App Engine applications by default. Trace data from other
-    applications can be provided using this API.
+    Sends application trace data to Stackdriver Trace for viewing. Trace data
+    is collected for all App Engine applications by default. Trace data from
+    other applications can be provided using this API. This library is used to
+    interact with the Trace API directly. If you are looking to instrument
+    your application for Stackdriver Trace, we recommend using OpenCensus.
 
 backend:
   rules:
@@ -21,7 +23,12 @@ backend:
 
 authentication:
   rules:
-  - selector: '*'
+  - selector: google.devtools.cloudtrace.v2.TraceService.BatchWriteSpans
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/trace.append
+  - selector: google.devtools.cloudtrace.v2.TraceService.CreateSpan
     oauth:
       canonical_scopes: |-
         https://www.googleapis.com/auth/cloud-platform,
diff --git a/third_party/googleapis/google/devtools/cloudtrace/v2/trace.proto b/third_party/googleapis/google/devtools/cloudtrace/v2/trace.proto
index d9fbe663b..f5e628329 100644
--- a/third_party/googleapis/google/devtools/cloudtrace/v2/trace.proto
+++ b/third_party/googleapis/google/devtools/cloudtrace/v2/trace.proto
@@ -1,4 +1,4 @@
-// Copyright 2017 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -17,6 +17,8 @@ syntax = "proto3";
 package google.devtools.cloudtrace.v2;
 
 import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/protobuf/timestamp.proto";
 import "google/protobuf/wrappers.proto";
 import "google/rpc/status.proto";
@@ -35,11 +37,16 @@ option php_namespace = "Google\\Cloud\\Trace\\V2";
 // or none at all. Spans do not need to be contiguous—there may be
 // gaps or overlaps between spans in a trace.
 message Span {
+  option (google.api.resource) = {
+    type: "cloudtrace.googleapis.com/Span"
+    pattern: "projects/{project}/traces/{trace}/spans/{span}"
+  };
+
   // A set of attributes, each in the format `[KEY]:[VALUE]`.
   message Attributes {
     // The set of attributes. Each attribute's key can be up to 128 bytes
-    // long. The value can be a string up to 256 bytes, an integer, or the
-    // Boolean values `true` and `false`. For example:
+    // long. The value can be a string up to 256 bytes, a signed 64-bit integer,
+    // or the Boolean values `true` and `false`. For example:
     //
     //     "/instance_id": "my-instance"
     //     "/http/user_agent": ""
@@ -179,10 +186,10 @@ message Span {
   //
   // [SPAN_ID] is a unique identifier for a span within a trace; it
   // is a 16-character hexadecimal encoding of an 8-byte array.
-  string name = 1;
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The [SPAN_ID] portion of the span's resource name.
-  string span_id = 2;
+  string span_id = 2 [(google.api.field_behavior) = REQUIRED];
 
   // The [SPAN_ID] of this span's parent span. If this is a root span,
   // then this field must be empty.
@@ -190,22 +197,24 @@ message Span {
 
   // A description of the span's operation (up to 128 bytes).
   // Stackdriver Trace displays the description in the
-  // {% dynamic print site_values.console_name %}.
+  // Google Cloud Platform Console.
   // For example, the display name can be a qualified method name or a file name
   // and a line number where the operation is called. A best practice is to use
   // the same display name within an application and at the same call point.
   // This makes it easier to correlate spans in different traces.
-  TruncatableString display_name = 4;
+  TruncatableString display_name = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The start time of the span. On the client side, this is the time kept by
   // the local machine where the span execution starts. On the server side, this
   // is the time when the server's application handler starts running.
-  google.protobuf.Timestamp start_time = 5;
+  google.protobuf.Timestamp start_time = 5
+    [(google.api.field_behavior) = REQUIRED];
 
   // The end time of the span. On the client side, this is the time kept by
   // the local machine where the span execution ends. On the server side, this
   // is the time when the server application handler stops running.
-  google.protobuf.Timestamp end_time = 6;
+  google.protobuf.Timestamp end_time = 6
+    [(google.api.field_behavior) = REQUIRED];
 
   // A set of attributes on the span. You can have up to 32 attributes per
   // span.
@@ -221,18 +230,18 @@ message Span {
   // Links associated with the span. You can have up to 128 links per Span.
   Links links = 10;
 
-  // An optional final status for this span.
-  google.rpc.Status status = 11;
+  // Optional. The final status for this span.
+  google.rpc.Status status = 11 [(google.api.field_behavior) = OPTIONAL];
 
-  // (Optional) Set this parameter to indicate whether this span is in
+  // Optional. Set this parameter to indicate whether this span is in
   // the same process as its parent. If you do not set this parameter,
   // Stackdriver Trace is unable to take advantage of this helpful
   // information.
-  google.protobuf.BoolValue same_process_as_parent_span = 12;
+  google.protobuf.BoolValue same_process_as_parent_span = 12 [(google.api.field_behavior) = OPTIONAL];
 
-  // An optional number of child spans that were generated while this span
+  // Optional. The number of child spans that were generated while this span
   // was active. If set, allows implementation to detect missing child spans.
-  google.protobuf.Int32Value child_span_count = 13;
+  google.protobuf.Int32Value child_span_count = 13 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // The allowed types for [VALUE] in a `[KEY]:[VALUE]` attribute.
diff --git a/third_party/googleapis/google/devtools/cloudtrace/v2/tracing.proto b/third_party/googleapis/google/devtools/cloudtrace/v2/tracing.proto
index 2990d4606..966a81791 100644
--- a/third_party/googleapis/google/devtools/cloudtrace/v2/tracing.proto
+++ b/third_party/googleapis/google/devtools/cloudtrace/v2/tracing.proto
@@ -1,4 +1,4 @@
-// Copyright 2017 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,12 +11,16 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.devtools.cloudtrace.v2;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/devtools/cloudtrace/v2/trace.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/timestamp.proto";
@@ -34,6 +38,11 @@ option php_namespace = "Google\\Cloud\\Trace\\V2";
 // timed event which forms a node of the trace tree. A single trace may
 // contain span(s) from multiple services.
 service TraceService {
+  option (google.api.default_host) = "cloudtrace.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/trace.append";
+
   // Sends new spans to new or existing traces. You cannot update
   // existing spans.
   rpc BatchWriteSpans(BatchWriteSpansRequest) returns (google.protobuf.Empty) {
@@ -41,12 +50,13 @@ service TraceService {
       post: "/v2/{name=projects/*}/traces:batchWrite"
       body: "*"
     };
+    option (google.api.method_signature) = "name,spans";
   }
 
   // Creates a new span.
   rpc CreateSpan(Span) returns (Span) {
     option (google.api.http) = {
-      post: "/v2/{name=projects/*/traces/*}/spans"
+      post: "/v2/{name=projects/*/traces/*/spans/*}"
       body: "*"
     };
   }
@@ -56,9 +66,14 @@ service TraceService {
 message BatchWriteSpansRequest {
   // Required. The name of the project where the spans belong. The format is
   // `projects/[PROJECT_ID]`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
-  // A list of new spans. The span names must not match existing
+  // Required. A list of new spans. The span names must not match existing
   // spans, or the results are undefined.
-  repeated Span spans = 2;
+  repeated Span spans = 2 [(google.api.field_behavior) = REQUIRED];
 }
diff --git a/third_party/googleapis/google/devtools/containeranalysis/BUILD.bazel b/third_party/googleapis/google/devtools/containeranalysis/BUILD.bazel
index 1e5b8c2af..a87c57fec 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/BUILD.bazel
+++ b/third_party/googleapis/google/devtools/containeranalysis/BUILD.bazel
@@ -1 +1 @@
-exports_files(glob(["*.yaml"]))
\ No newline at end of file
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/devtools/containeranalysis/artman_containeranalysis_v1.yaml b/third_party/googleapis/google/devtools/containeranalysis/artman_containeranalysis_v1.yaml
index 4de2d28e8..1b24b227d 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/artman_containeranalysis_v1.yaml
+++ b/third_party/googleapis/google/devtools/containeranalysis/artman_containeranalysis_v1.yaml
@@ -7,8 +7,9 @@ common:
   - name: google-iam-v1
   src_proto_paths:
   - v1
-  service_yaml: containeranalysis_v1.yaml
+  service_yaml: v1/containeranalysis_v1.yaml
   gapic_yaml: v1/containeranalysis_gapic.yaml
+  proto_package: google.devtools.containeranalysis.v1
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/devtools/containeranalysis/containeranalysis.yaml b/third_party/googleapis/google/devtools/containeranalysis/containeranalysis.yaml
deleted file mode 100644
index 352192422..000000000
--- a/third_party/googleapis/google/devtools/containeranalysis/containeranalysis.yaml
+++ /dev/null
@@ -1,25 +0,0 @@
-type: google.api.Service
-config_version: 3
-name: containeranalysis.googleapis.com
-title: Container Analysis API
-
-apis:
-- name: google.devtools.containeranalysis.v1alpha1.ContainerAnalysis
-
-types:
-- name: google.devtools.containeranalysis.v1alpha1.OperationMetadata
-
-documentation:
-  summary: |-
-    An implementation of the Grafeas API, which stores, and enables querying and
-    retrieval of critical metadata about all of your software artifacts.
-  overview: |-
-    The Container Analysis API allows you to store and retrieve metadata for a
-    container resource.
-
-authentication:
-  rules:
-  - selector: '*'
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1/BUILD.bazel b/third_party/googleapis/google/devtools/containeranalysis/v1/BUILD.bazel
new file mode 100644
index 000000000..ee1615f37
--- /dev/null
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1/BUILD.bazel
@@ -0,0 +1,365 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "containeranalysis_proto",
+    srcs = [
+        "containeranalysis.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/iam/v1:iam_policy_proto",
+        "//google/iam/v1:policy_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "containeranalysis_proto_with_info",
+    deps = [
+        ":containeranalysis_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "containeranalysis_java_proto",
+    deps = [":containeranalysis_proto"],
+)
+
+java_grpc_library(
+    name = "containeranalysis_java_grpc",
+    srcs = [":containeranalysis_proto"],
+    deps = [":containeranalysis_java_proto"],
+)
+
+java_gapic_library(
+    name = "containeranalysis_java_gapic",
+    src = ":containeranalysis_proto_with_info",
+    gapic_yaml = "containeranalysis_gapic.yaml",
+    package = "google.devtools.containeranalysis.v1",
+    service_yaml = "containeranalysis_v1.yaml",
+    test_deps = [
+        ":containeranalysis_java_grpc",
+        "//google/iam/v1:iam_java_grpc",
+    ],
+    deps = [
+        ":containeranalysis_java_proto",
+        "//google/iam/v1:iam_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "containeranalysis_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.devtools.containeranalysis.v1.ContainerAnalysisClientTest",
+    ],
+    runtime_deps = [":containeranalysis_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-devtools-containeranalysis-v1-java",
+    deps = [
+        ":containeranalysis_java_gapic",
+        ":containeranalysis_java_grpc",
+        ":containeranalysis_java_proto",
+        ":containeranalysis_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "containeranalysis_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/devtools/containeranalysis/v1",
+    protos = [":containeranalysis_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/iam/v1:iam_go_proto",
+    ],
+)
+# Fix compilation error
+#  cloud.google.com/go/containeranalysis/apiv1/container_analysis_client.go:66:9: undefined: containeranalysispb
+#go_gapic_library(
+#    name = "containeranalysis_go_gapic",
+#    src = ":containeranalysis_proto_with_info",
+#    gapic_yaml = "containeranalysis_gapic.yaml",
+#    importpath = "cloud.google.com/go/containeranalysis/apiv1",
+#    package = "google.devtools.containeranalysis.v1",
+#    service_yaml = "//google/devtools/containeranalysis:containeranalysis_v1.yaml",
+#    deps = [
+#        ":containeranalysis_go_proto",
+#        "//google/iam/v1:iam_go_proto",
+#    ],
+#)
+#
+#go_test(
+#    name = "containeranalysis_go_gapic_test",
+#    srcs = [":containeranalysis_go_gapic_srcjar_test"],
+#    embed = [":containeranalysis_go_gapic"],
+#    importpath = "cloud.google.com/go/containeranalysis/apiv1",
+#)
+#
+## Open Source Packages
+#go_gapic_assembly_pkg(
+#    name = "gapi-cloud-devtools-containeranalysis-v1-go",
+#    deps = [
+#        ":containeranalysis_go_gapic",
+#        ":containeranalysis_go_gapic_srcjar-smoke-test.srcjar",
+#        ":containeranalysis_go_gapic_srcjar-test.srcjar",
+#        ":containeranalysis_go_proto",
+#    ],
+#)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "containeranalysis_moved_proto",
+    srcs = [":containeranalysis_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/iam/v1:iam_policy_proto",
+        "//google/iam/v1:policy_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "containeranalysis_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":containeranalysis_moved_proto"],
+)
+
+py_grpc_library(
+    name = "containeranalysis_py_grpc",
+    srcs = [":containeranalysis_moved_proto"],
+    deps = [":containeranalysis_py_proto"],
+)
+
+py_gapic_library(
+    name = "containeranalysis_py_gapic",
+    src = ":containeranalysis_proto_with_info",
+    gapic_yaml = "containeranalysis_gapic.yaml",
+    package = "google.devtools.containeranalysis.v1",
+    service_yaml = "containeranalysis_v1.yaml",
+    deps = [
+        ":containeranalysis_py_grpc",
+        ":containeranalysis_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "devtools-containeranalysis-v1-py",
+    deps = [
+        ":containeranalysis_py_gapic",
+        ":containeranalysis_py_grpc",
+        ":containeranalysis_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "containeranalysis_php_proto",
+    deps = [":containeranalysis_proto"],
+)
+
+php_grpc_library(
+    name = "containeranalysis_php_grpc",
+    srcs = [":containeranalysis_proto"],
+    deps = [":containeranalysis_php_proto"],
+)
+
+php_gapic_library(
+    name = "containeranalysis_php_gapic",
+    src = ":containeranalysis_proto_with_info",
+    gapic_yaml = "containeranalysis_gapic.yaml",
+    package = "google.devtools.containeranalysis.v1",
+    service_yaml = "containeranalysis_v1.yaml",
+    deps = [
+        ":containeranalysis_php_grpc",
+        ":containeranalysis_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-devtools-containeranalysis-v1-php",
+    deps = [
+        ":containeranalysis_php_gapic",
+        ":containeranalysis_php_grpc",
+        ":containeranalysis_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "containeranalysis_nodejs_gapic",
+    src = ":containeranalysis_proto_with_info",
+    gapic_yaml = "containeranalysis_gapic.yaml",
+    package = "google.devtools.containeranalysis.v1",
+    service_yaml = "containeranalysis_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "devtools-containeranalysis-v1-nodejs",
+    deps = [
+        ":containeranalysis_nodejs_gapic",
+        ":containeranalysis_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "containeranalysis_ruby_proto",
+    deps = [":containeranalysis_proto"],
+)
+
+ruby_grpc_library(
+    name = "containeranalysis_ruby_grpc",
+    srcs = [":containeranalysis_proto"],
+    deps = [":containeranalysis_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "containeranalysis_ruby_gapic",
+    src = ":containeranalysis_proto_with_info",
+    gapic_yaml = "containeranalysis_gapic.yaml",
+    package = "google.devtools.containeranalysis.v1",
+    service_yaml = "containeranalysis_v1.yaml",
+    deps = [
+        ":containeranalysis_ruby_grpc",
+        ":containeranalysis_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-devtools-containeranalysis-v1-ruby",
+    deps = [
+        ":containeranalysis_ruby_gapic",
+        ":containeranalysis_ruby_grpc",
+        ":containeranalysis_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "containeranalysis_csharp_proto",
+    deps = [":containeranalysis_proto"],
+)
+
+csharp_grpc_library(
+    name = "containeranalysis_csharp_grpc",
+    srcs = [":containeranalysis_proto"],
+    deps = [":containeranalysis_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "containeranalysis_csharp_gapic",
+    src = ":containeranalysis_proto_with_info",
+    gapic_yaml = "containeranalysis_gapic.yaml",
+    package = "google.devtools.containeranalysis.v1",
+    service_yaml = "containeranalysis_v1.yaml",
+    deps = [
+        ":containeranalysis_csharp_grpc",
+        ":containeranalysis_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-devtools-containeranalysis-v1-csharp",
+    deps = [
+        ":containeranalysis_csharp_gapic",
+        ":containeranalysis_csharp_grpc",
+        ":containeranalysis_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1/containeranalysis.proto b/third_party/googleapis/google/devtools/containeranalysis/v1/containeranalysis.proto
index 0a54ccc6e..55b842a00 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1/containeranalysis.proto
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1/containeranalysis.proto
@@ -18,6 +18,7 @@ syntax = "proto3";
 package google.devtools.containeranalysis.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
 import "google/iam/v1/iam_policy.proto";
 import "google/iam/v1/policy.proto";
 import "google/protobuf/timestamp.proto";
@@ -43,6 +44,9 @@ option ruby_package = "Google::Cloud::ContainerAnalysis::V1";
 // there would be one note for the vulnerability and an occurrence for each
 // image with the vulnerability referring to that note.
 service ContainerAnalysis {
+  option (google.api.default_host) = "containeranalysis.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Sets the access control policy on the specified note or occurrence.
   // Requires `containeranalysis.notes.setIamPolicy` or
   // `containeranalysis.occurrences.setIamPolicy` permission if the resource is
@@ -60,6 +64,7 @@ service ContainerAnalysis {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "resource,policy";
   }
 
   // Gets the access control policy for a note or an occurrence resource.
@@ -79,6 +84,7 @@ service ContainerAnalysis {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "resource";
   }
 
   // Returns the permissions that a caller has on the specified note or
@@ -97,5 +103,6 @@ service ContainerAnalysis {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "resource,permissions";
   }
 }
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1/containeranalysis_gapic.legacy.yaml b/third_party/googleapis/google/devtools/containeranalysis/v1/containeranalysis_gapic.legacy.yaml
new file mode 100644
index 000000000..bed399c30
--- /dev/null
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1/containeranalysis_gapic.legacy.yaml
@@ -0,0 +1,181 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.devtools.containeranalysis.v1
+  python:
+    package_name: google.cloud.devtools.containeranalysis_v1.gapic
+  go:
+    package_name: cloud.google.com/go/containeranalysis/apiv1
+    release_level: BETA
+  csharp:
+    package_name: Google.Cloud.DevTools.ContainerAnalysis.V1
+  ruby:
+    package_name: Google::Cloud::ContainerAnalysis::V1
+  php:
+    package_name: Google\Cloud\Devtools\Containeranalysis\V1
+  nodejs:
+    package_name: containeranalysis.v1
+    domain_layer_location: google-cloud
+# A list of resource collection configurations.
+# Consists of a name_pattern and an entity_name.
+# The name_pattern is a pattern to describe the names of the resources of this
+# collection, using the platform's conventions for URI patterns. A generator
+# may use this to generate methods to compose and decompose such names. The
+# pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+# those will be taken as hints for the parameter names of the generated
+# methods. If empty, no name methods are generated.
+# The entity_name is the name to be used as a basis for generated methods and
+# classes.
+collections:
+- name_pattern: projects/{project}
+  entity_name: project
+  language_overrides:
+  - language: csharp
+    common_resource_name: Grafeas.V1.ProjectName
+- name_pattern: projects/{project}/notes/{note}
+  entity_name: note
+  language_overrides:
+  - language: csharp
+    common_resource_name: Grafeas.V1.NoteName
+- name_pattern: projects/{project}/occurrences/{occurrence}
+  entity_name: occurrence
+  language_overrides:
+  - language: csharp
+    common_resource_name: Grafeas.V1.OccurrenceName
+collection_oneofs:
+- oneof_name: iam_resource_oneof
+  collection_names:
+  - note
+  - occurrence
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: google.devtools.containeranalysis.v1.ContainerAnalysis
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: SetIamPolicy
+    flattening:
+      groups:
+      - parameters:
+        - resource
+        - policy
+    required_fields:
+    - resource
+    - policy
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: iam_resource_oneof
+    timeout_millis: 30000
+  - name: GetIamPolicy
+    flattening:
+      groups:
+      - parameters:
+        - resource
+    required_fields:
+    - resource
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: iam_resource_oneof
+    timeout_millis: 30000
+  - name: TestIamPermissions
+    flattening:
+      groups:
+      - parameters:
+        - resource
+        - permissions
+    required_fields:
+    - resource
+    - permissions
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: iam_resource_oneof
+    timeout_millis: 30000
+resource_name_generation:
+- message_name: google.iam.v1.SetIamPolicyRequest
+  field_entity_map:
+    resource: '*'
+- message_name: google.iam.v1.GetIamPolicyRequest
+  field_entity_map:
+    resource: '*'
+- message_name: google.iam.v1.TestIamPermissionsRequest
+  field_entity_map:
+    resource: '*'
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1/containeranalysis_gapic.yaml b/third_party/googleapis/google/devtools/containeranalysis/v1/containeranalysis_gapic.yaml
index bed399c30..5666f96d6 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1/containeranalysis_gapic.yaml
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1/containeranalysis_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -18,164 +18,3 @@ language_settings:
   nodejs:
     package_name: containeranalysis.v1
     domain_layer_location: google-cloud
-# A list of resource collection configurations.
-# Consists of a name_pattern and an entity_name.
-# The name_pattern is a pattern to describe the names of the resources of this
-# collection, using the platform's conventions for URI patterns. A generator
-# may use this to generate methods to compose and decompose such names. The
-# pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-# those will be taken as hints for the parameter names of the generated
-# methods. If empty, no name methods are generated.
-# The entity_name is the name to be used as a basis for generated methods and
-# classes.
-collections:
-- name_pattern: projects/{project}
-  entity_name: project
-  language_overrides:
-  - language: csharp
-    common_resource_name: Grafeas.V1.ProjectName
-- name_pattern: projects/{project}/notes/{note}
-  entity_name: note
-  language_overrides:
-  - language: csharp
-    common_resource_name: Grafeas.V1.NoteName
-- name_pattern: projects/{project}/occurrences/{occurrence}
-  entity_name: occurrence
-  language_overrides:
-  - language: csharp
-    common_resource_name: Grafeas.V1.OccurrenceName
-collection_oneofs:
-- oneof_name: iam_resource_oneof
-  collection_names:
-  - note
-  - occurrence
-# A list of API interface configurations.
-interfaces:
-# The fully qualified name of the API interface.
-- name: google.devtools.containeranalysis.v1.ContainerAnalysis
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
-  methods:
-  - name: SetIamPolicy
-    flattening:
-      groups:
-      - parameters:
-        - resource
-        - policy
-    required_fields:
-    - resource
-    - policy
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      resource: iam_resource_oneof
-    timeout_millis: 30000
-  - name: GetIamPolicy
-    flattening:
-      groups:
-      - parameters:
-        - resource
-    required_fields:
-    - resource
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      resource: iam_resource_oneof
-    timeout_millis: 30000
-  - name: TestIamPermissions
-    flattening:
-      groups:
-      - parameters:
-        - resource
-        - permissions
-    required_fields:
-    - resource
-    - permissions
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      resource: iam_resource_oneof
-    timeout_millis: 30000
-resource_name_generation:
-- message_name: google.iam.v1.SetIamPolicyRequest
-  field_entity_map:
-    resource: '*'
-- message_name: google.iam.v1.GetIamPolicyRequest
-  field_entity_map:
-    resource: '*'
-- message_name: google.iam.v1.TestIamPermissionsRequest
-  field_entity_map:
-    resource: '*'
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1/containeranalysis_grpc_service_config.json b/third_party/googleapis/google/devtools/containeranalysis/v1/containeranalysis_grpc_service_config.json
new file mode 100755
index 000000000..ee15e6efa
--- /dev/null
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1/containeranalysis_grpc_service_config.json
@@ -0,0 +1,21 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.devtools.containeranalysis.v1.ContainerAnalysis",
+          "method": "SetIamPolicy"
+        },
+        {
+          "service": "google.devtools.containeranalysis.v1.ContainerAnalysis",
+          "method": "GetIamPolicy"
+        },
+        {
+          "service": "google.devtools.containeranalysis.v1.ContainerAnalysis",
+          "method": "TestIamPermissions"
+        }
+      ],
+      "timeout": "30s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/devtools/containeranalysis/containeranalysis_v1.yaml b/third_party/googleapis/google/devtools/containeranalysis/v1/containeranalysis_v1.yaml
similarity index 79%
rename from third_party/googleapis/google/devtools/containeranalysis/containeranalysis_v1.yaml
rename to third_party/googleapis/google/devtools/containeranalysis/v1/containeranalysis_v1.yaml
index c59b10186..e1015739f 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/containeranalysis_v1.yaml
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1/containeranalysis_v1.yaml
@@ -18,6 +18,8 @@ backend:
   rules:
   - selector: 'google.devtools.containeranalysis.v1.ContainerAnalysis.*'
     deadline: 30.0
+  - selector: 'google.longrunning.Operations.*'
+    deadline: 30.0
 
 authentication:
   rules:
@@ -25,3 +27,7 @@ authentication:
     oauth:
       canonical_scopes: |-
         https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1alpha1/bill_of_materials.proto b/third_party/googleapis/google/devtools/containeranalysis/v1alpha1/bill_of_materials.proto
deleted file mode 100644
index 0cd60f053..000000000
--- a/third_party/googleapis/google/devtools/containeranalysis/v1alpha1/bill_of_materials.proto
+++ /dev/null
@@ -1,102 +0,0 @@
-// Copyright 2018 Google Inc.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-syntax = "proto3";
-
-package google.devtools.containeranalysis.v1alpha1;
-
-import "google/api/annotations.proto";
-import "google/devtools/containeranalysis/v1alpha1/package_vulnerability.proto";
-
-option go_package = "google.golang.org/genproto/googleapis/devtools/containeranalysis/v1alpha1;containeranalysis";
-option java_multiple_files = true;
-option java_package = "com.google.containeranalysis.v1alpha1";
-option objc_class_prefix = "GCA";
-
-// PackageManager provides metadata about available / installed packages.
-message PackageManager {
-  // This represents a particular channel of distribution for a given package.
-  // e.g. Debian's jessie-backports dpkg mirror
-  message Distribution {
-    // The cpe_uri in [cpe format](https://cpe.mitre.org/specification/)
-    // denoting the package manager version distributing a package.
-    string cpe_uri = 1;
-
-    // The CPU architecture for which packages in this distribution
-    // channel were built
-    Architecture architecture = 2;
-
-    // The latest available version of this package in
-    // this distribution channel.
-    VulnerabilityType.Version latest_version = 3;
-
-    // A freeform string denoting the maintainer of this package.
-    string maintainer = 4;
-
-    // The distribution channel-specific homepage for this package.
-    string url = 6;
-
-    // The distribution channel-specific description of this package.
-    string description = 7;
-  }
-
-  // An occurrence of a particular package installation found within a
-  // system's filesystem.
-  // e.g. glibc was found in /var/lib/dpkg/status
-  message Location {
-    // The cpe_uri in [cpe format](https://cpe.mitre.org/specification/)
-    // denoting the package manager version distributing a package.
-    string cpe_uri = 1;
-
-    // The version installed at this location.
-    VulnerabilityType.Version version = 2;
-
-    // The path from which we gathered that this package/version is installed.
-    string path = 3;
-  }
-
-  // This represents a particular package that is distributed over
-  // various channels.
-  // e.g. glibc (aka libc6) is distributed by many, at various versions.
-  message Package {
-    // The name of the package.
-    string name = 1;
-
-    // The various channels by which a package is distributed.
-    repeated Distribution distribution = 10;
-  }
-
-  // This represents how a particular software package may be installed on
-  // a system.
-  message Installation {
-    // Output only. The name of the installed package.
-    string name = 1;
-
-    // All of the places within the filesystem versions of this package
-    // have been found.
-    repeated Location location = 2;
-  }
-
-  // Instruction set architectures supported by various package managers.
-  enum Architecture {
-    // Unknown architecture
-    ARCHITECTURE_UNSPECIFIED = 0;
-
-    // X86 architecture
-    X86 = 1;
-
-    // X64 architecture
-    X64 = 2;
-  }
-}
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1alpha1/containeranalysis.proto b/third_party/googleapis/google/devtools/containeranalysis/v1alpha1/containeranalysis.proto
deleted file mode 100644
index c94aed7c8..000000000
--- a/third_party/googleapis/google/devtools/containeranalysis/v1alpha1/containeranalysis.proto
+++ /dev/null
@@ -1,994 +0,0 @@
-// Copyright 2018 Google Inc.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-syntax = "proto3";
-
-package google.devtools.containeranalysis.v1alpha1;
-
-import "google/api/annotations.proto";
-import "google/devtools/containeranalysis/v1alpha1/bill_of_materials.proto";
-import "google/devtools/containeranalysis/v1alpha1/image_basis.proto";
-import "google/devtools/containeranalysis/v1alpha1/package_vulnerability.proto";
-import "google/devtools/containeranalysis/v1alpha1/provenance.proto";
-import "google/iam/v1/iam_policy.proto";
-import "google/iam/v1/policy.proto";
-import "google/longrunning/operations.proto";
-import "google/protobuf/any.proto";
-import "google/protobuf/empty.proto";
-import "google/protobuf/field_mask.proto";
-import "google/protobuf/timestamp.proto";
-import "google/rpc/status.proto";
-
-option go_package = "google.golang.org/genproto/googleapis/devtools/containeranalysis/v1alpha1;containeranalysis";
-option java_multiple_files = true;
-option java_package = "com.google.containeranalysis.v1alpha1";
-option objc_class_prefix = "GCA";
-
-// Retrieves the results of vulnerability scanning of cloud components such as
-// container images. The Container Analysis API is an implementation of the
-// [Grafeas](grafeas.io) API.
-//
-// The vulnerability results are stored as a series of Occurrences.
-// An `Occurrence` contains information about a specific vulnerability in a
-// resource. An `Occurrence` references a `Note`. A `Note` contains details
-// about the vulnerability and is stored in a stored in a separate project.
-// Multiple `Occurrences` can reference the same `Note`. For example, an SSL
-// vulnerability could affect multiple packages in an image. In this case,
-// there would be one `Note` for the vulnerability and an `Occurrence` for
-// each package with the vulnerability referencing that `Note`.
-service ContainerAnalysis {
-  // Returns the requested `Occurrence`.
-  rpc GetOccurrence(GetOccurrenceRequest) returns (Occurrence) {
-    option (google.api.http) = {
-      get: "/v1alpha1/{name=projects/*/occurrences/*}"
-    };
-  }
-
-  // Lists active `Occurrences` for a given project matching the filters.
-  rpc ListOccurrences(ListOccurrencesRequest)
-      returns (ListOccurrencesResponse) {
-    option (google.api.http) = {
-      get: "/v1alpha1/{parent=projects/*}/occurrences"
-    };
-  }
-
-  // Deletes the given `Occurrence` from the system. Use this when
-  // an `Occurrence` is no longer applicable for the given resource.
-  rpc DeleteOccurrence(DeleteOccurrenceRequest)
-      returns (google.protobuf.Empty) {
-    option (google.api.http) = {
-      delete: "/v1alpha1/{name=projects/*/occurrences/*}"
-    };
-  }
-
-  // Creates a new `Occurrence`. Use this method to create `Occurrences`
-  // for a resource.
-  rpc CreateOccurrence(CreateOccurrenceRequest) returns (Occurrence) {
-    option (google.api.http) = {
-      post: "/v1alpha1/{parent=projects/*}/occurrences"
-      body: "occurrence"
-    };
-  }
-
-  // Updates an existing occurrence.
-  rpc UpdateOccurrence(UpdateOccurrenceRequest) returns (Occurrence) {
-    option (google.api.http) = {
-      patch: "/v1alpha1/{name=projects/*/occurrences/*}"
-      body: "occurrence"
-    };
-  }
-
-  // Gets the `Note` attached to the given `Occurrence`.
-  rpc GetOccurrenceNote(GetOccurrenceNoteRequest) returns (Note) {
-    option (google.api.http) = {
-      get: "/v1alpha1/{name=projects/*/occurrences/*}/notes"
-    };
-  }
-
-  // Returns the requested `Note`.
-  rpc GetNote(GetNoteRequest) returns (Note) {
-    option (google.api.http) = {
-      get: "/v1alpha1/{name=projects/*/notes/*}"
-    };
-  }
-
-  // Lists all `Notes` for a given project.
-  rpc ListNotes(ListNotesRequest) returns (ListNotesResponse) {
-    option (google.api.http) = {
-      get: "/v1alpha1/{parent=projects/*}/notes"
-    };
-  }
-
-  // Deletes the given `Note` from the system.
-  rpc DeleteNote(DeleteNoteRequest) returns (google.protobuf.Empty) {
-    option (google.api.http) = {
-      delete: "/v1alpha1/{name=projects/*/notes/*}"
-    };
-  }
-
-  // Creates a new `Note`.
-  rpc CreateNote(CreateNoteRequest) returns (Note) {
-    option (google.api.http) = {
-      post: "/v1alpha1/{parent=projects/*}/notes"
-      body: "note"
-    };
-  }
-
-  // Updates an existing `Note`.
-  rpc UpdateNote(UpdateNoteRequest) returns (Note) {
-    option (google.api.http) = {
-      patch: "/v1alpha1/{name=projects/*/notes/*}"
-      body: "note"
-    };
-  }
-
-  // Lists `Occurrences` referencing the specified `Note`. Use this method to
-  // get all occurrences referencing your `Note` across all your customer
-  // projects.
-  rpc ListNoteOccurrences(ListNoteOccurrencesRequest)
-      returns (ListNoteOccurrencesResponse) {
-    option (google.api.http) = {
-      get: "/v1alpha1/{name=projects/*/notes/*}/occurrences"
-    };
-  }
-
-  // Gets a summary of the number and severity of occurrences.
-  rpc GetVulnzOccurrencesSummary(GetVulnzOccurrencesSummaryRequest)
-      returns (GetVulnzOccurrencesSummaryResponse) {
-    option (google.api.http) = {
-      get: "/v1alpha1/{parent=projects/*}/occurrences:vulnerabilitySummary"
-    };
-  }
-
-  // Sets the access control policy on the specified `Note` or `Occurrence`.
-  // Requires `containeranalysis.notes.setIamPolicy` or
-  // `containeranalysis.occurrences.setIamPolicy` permission if the resource is
-  // a `Note` or an `Occurrence`, respectively.
-  // Attempting to call this method without these permissions will result in a `
-  // `PERMISSION_DENIED` error.
-  // Attempting to call this method on a non-existent resource will result in a
-  // `NOT_FOUND` error if the user has `containeranalysis.notes.list` permission
-  // on a `Note` or `containeranalysis.occurrences.list` on an `Occurrence`, or
-  // a `PERMISSION_DENIED` error otherwise. The resource takes the following
-  // formats: `projects/{projectid}/occurrences/{occurrenceid}` for occurrences
-  // and projects/{projectid}/notes/{noteid} for notes
-  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest)
-      returns (google.iam.v1.Policy) {
-    option (google.api.http) = {
-      post: "/v1alpha1/{resource=projects/*/notes/*}:setIamPolicy"
-      body: "*"
-      additional_bindings {
-        post: "/v1alpha1/{resource=projects/*/occurrences/*}:setIamPolicy"
-        body: "*"
-      }
-    };
-  }
-
-  // Gets the access control policy for a note or an `Occurrence` resource.
-  // Requires `containeranalysis.notes.setIamPolicy` or
-  // `containeranalysis.occurrences.setIamPolicy` permission if the resource is
-  // a note or occurrence, respectively.
-  // Attempting to call this method on a resource without the required
-  // permission will result in a `PERMISSION_DENIED` error. Attempting to call
-  // this method on a non-existent resource will result in a `NOT_FOUND` error
-  // if the user has list permission on the project, or a `PERMISSION_DENIED`
-  // error otherwise. The resource takes the following formats:
-  // `projects/{PROJECT_ID}/occurrences/{OCCURRENCE_ID}` for occurrences and
-  // projects/{PROJECT_ID}/notes/{NOTE_ID} for notes
-  rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest)
-      returns (google.iam.v1.Policy) {
-    option (google.api.http) = {
-      post: "/v1alpha1/{resource=projects/*/notes/*}:getIamPolicy"
-      body: "*"
-      additional_bindings {
-        post: "/v1alpha1/{resource=projects/*/occurrences/*}:getIamPolicy"
-        body: "*"
-      }
-    };
-  }
-
-  // Returns the permissions that a caller has on the specified note or
-  // occurrence resource. Requires list permission on the project (for example,
-  // "storage.objects.list" on the containing bucket for testing permission of
-  // an object). Attempting to call this method on a non-existent resource will
-  // result in a `NOT_FOUND` error if the user has list permission on the
-  // project, or a `PERMISSION_DENIED` error otherwise. The resource takes the
-  // following formats: `projects/{PROJECT_ID}/occurrences/{OCCURRENCE_ID}` for
-  // `Occurrences` and `projects/{PROJECT_ID}/notes/{NOTE_ID}` for `Notes`
-  rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest)
-      returns (google.iam.v1.TestIamPermissionsResponse) {
-    option (google.api.http) = {
-      post: "/v1alpha1/{resource=projects/*/notes/*}:testIamPermissions"
-      body: "*"
-      additional_bindings {
-        post: "/v1alpha1/{resource=projects/*/occurrences/*}:testIamPermissions"
-        body: "*"
-      }
-    };
-  }
-
-  // Creates a new `Operation`.
-  rpc CreateOperation(CreateOperationRequest)
-      returns (google.longrunning.Operation) {
-    option (google.api.http) = {
-      post: "/v1alpha1/{parent=projects/*}/operations"
-      body: "*"
-    };
-  }
-
-  // Updates an existing operation returns an error if operation
-  //  does not exist. The only valid operations are to update mark the done bit
-  // change the result.
-  rpc UpdateOperation(UpdateOperationRequest)
-      returns (google.longrunning.Operation) {
-    option (google.api.http) = {
-      patch: "/v1alpha1/{name=projects/*/operations/*}"
-      body: "*"
-    };
-  }
-
-  // Gets a specific scan configuration for a project.
-  rpc GetScanConfig(GetScanConfigRequest) returns (ScanConfig) {
-    option (google.api.http) = {
-      get: "/v1alpha1/{name=projects/*/scan_configs/*}"
-    };
-  }
-
-  // Lists scan configurations for a project.
-  rpc ListScanConfigs(ListScanConfigsRequest)
-      returns (ListScanConfigsResponse) {
-    option (google.api.http) = {
-      get: "/v1alpha1/{parent=projects/*}/scan_configs"
-    };
-  }
-
-  // Updates the scan configuration to a new value.
-  rpc UpdateScanConfig(UpdateScanConfigRequest) returns (ScanConfig) {
-    option (google.api.http) = {
-      patch: "/v1alpha1/{name=projects/*/scan_configs/*}"
-      body: "scan_config"
-    };
-  }
-}
-
-// `Occurrence` includes information about analysis occurrences for an image.
-message Occurrence {
-  // Output only. The name of the `Occurrence` in the form
-  // "projects/{project_id}/occurrences/{OCCURRENCE_ID}"
-  string name = 1;
-
-  // The unique URL of the image or the container for which the `Occurrence`
-  // applies. For example, https://gcr.io/project/image@sha256:foo This field
-  // can be used as a filter in list requests.
-  string resource_url = 2;
-
-  // The resource for which the `Occurrence` applies.
-  Resource resource = 17;
-
-  // An analysis note associated with this image, in the form
-  // "providers/{provider_id}/notes/{NOTE_ID}"
-  // This field can be used as a filter in list requests.
-  string note_name = 3;
-
-  // Output only. This explicitly denotes which of the `Occurrence` details are
-  // specified. This field can be used as a filter in list requests.
-  Note.Kind kind = 6;
-
-  // Describes the details of the vulnerability `Note` found in this resource.
-  oneof details {
-    // Details of a security vulnerability note.
-    VulnerabilityType.VulnerabilityDetails vulnerability_details = 8;
-
-    // Build details for a verifiable build.
-    BuildDetails build_details = 7;
-
-    // Describes how this resource derives from the basis
-    // in the associated note.
-    DockerImage.Derived derived_image = 11;
-
-    // Describes the installation of a package on the linked resource.
-    PackageManager.Installation installation = 12;
-
-    // Describes the deployment of an artifact on a runtime.
-    Deployable.Deployment deployment = 14;
-
-    // Describes the initial scan status for this resource.
-    Discovery.Discovered discovered = 15;
-
-    // Describes an attestation of an artifact.
-    AttestationAuthority.Attestation attestation = 16;
-  }
-
-  // A description of actions that can be taken to remedy the `Note`
-  string remediation = 5;
-
-  // Output only. The time this `Occurrence` was created.
-  google.protobuf.Timestamp create_time = 9;
-
-  // Output only. The time this `Occurrence` was last updated.
-  google.protobuf.Timestamp update_time = 10;
-}
-
-// Resource is an entity that can have metadata. E.g., a Docker image.
-message Resource {
-  // The name of the resource. E.g., the name of a Docker image - "Debian".
-  string name = 1;
-
-  // The unique URI of the resource. E.g.,
-  // "https://gcr.io/project/image@sha256:foo" for a Docker image.
-  string uri = 2;
-
-  // The hash of the resource content. E.g., the Docker digest.
-  Hash content_hash = 3;
-}
-
-// Provides a detailed description of a `Note`.
-message Note {
-  // Metadata for any related URL information
-  message RelatedUrl {
-    // Specific URL to associate with the note
-    string url = 1;
-
-    // Label to describe usage of the URL
-    string label = 2;
-  }
-
-  // This must be 1:1 with members of our oneofs, it can be used for filtering
-  // Note and Occurrence on their kind.
-  enum Kind {
-    // Unknown
-    KIND_UNSPECIFIED = 0;
-
-    // The note and occurrence represent a package vulnerability.
-    PACKAGE_VULNERABILITY = 2;
-
-    // The note and occurrence assert build provenance.
-    BUILD_DETAILS = 3;
-
-    // This represents an image basis relationship.
-    IMAGE_BASIS = 4;
-
-    // This represents a package installed via a package manager.
-    PACKAGE_MANAGER = 5;
-
-    // The note and occurrence track deployment events.
-    DEPLOYABLE = 6;
-
-    // The note and occurrence track the initial discovery status of a resource.
-    DISCOVERY = 7;
-
-    // This represents a logical "role" that can attest to artifacts.
-    ATTESTATION_AUTHORITY = 8;
-  }
-
-  // The name of the note in the form
-  // "providers/{provider_id}/notes/{NOTE_ID}"
-  string name = 1;
-
-  // A one sentence description of this `Note`.
-  string short_description = 3;
-
-  // A detailed description of this `Note`.
-  string long_description = 4;
-
-  // Output only. This explicitly denotes which kind of note is specified. This
-  // field can be used as a filter in list requests.
-  Kind kind = 9;
-
-  // The type of note.
-  oneof note_type {
-    // A package vulnerability type of note.
-    VulnerabilityType vulnerability_type = 6;
-
-    // Build provenance type for a verifiable build.
-    BuildType build_type = 8;
-
-    // A note describing a base image.
-    DockerImage.Basis base_image = 13;
-
-    // A note describing a package hosted by various package managers.
-    PackageManager.Package package = 14;
-
-    // A note describing something that can be deployed.
-    Deployable deployable = 17;
-
-    // A note describing a provider/analysis type.
-    Discovery discovery = 18;
-
-    // A note describing an attestation role.
-    AttestationAuthority attestation_authority = 19;
-  }
-
-  // URLs associated with this note
-  repeated RelatedUrl related_url = 7;
-
-  // Time of expiration for this note, null if note does not expire.
-  google.protobuf.Timestamp expiration_time = 10;
-
-  // Output only. The time this note was created. This field can be used as a
-  // filter in list requests.
-  google.protobuf.Timestamp create_time = 11;
-
-  // Output only. The time this note was last updated. This field can be used as
-  // a filter in list requests.
-  google.protobuf.Timestamp update_time = 12;
-}
-
-// An artifact that can be deployed in some runtime.
-message Deployable {
-  // The period during which some deployable was active in a runtime.
-  message Deployment {
-    // Types of platforms.
-    enum Platform {
-      // Unknown
-      PLATFORM_UNSPECIFIED = 0;
-
-      // Google Container Engine
-      GKE = 1;
-
-      // Google App Engine: Flexible Environment
-      FLEX = 2;
-
-      // Custom user-defined platform
-      CUSTOM = 3;
-    }
-
-    // Identity of the user that triggered this deployment.
-    string user_email = 1;
-
-    // Beginning of the lifetime of this deployment.
-    google.protobuf.Timestamp deploy_time = 2;
-
-    // End of the lifetime of this deployment.
-    google.protobuf.Timestamp undeploy_time = 3;
-
-    // Configuration used to create this deployment.
-    string config = 8;
-
-    // Address of the runtime element hosting this deployment.
-    string address = 5;
-
-    // Output only. Resource URI for the artifact being deployed taken from the
-    // deployable field with the same name.
-    repeated string resource_uri = 6;
-
-    // Platform hosting this deployment.
-    Platform platform = 7;
-  }
-
-  // Resource URI for the artifact being deployed.
-  repeated string resource_uri = 1;
-}
-
-// A note that indicates a type of analysis a provider would perform. This note
-// exists in a provider's project. A `Discovery` occurrence is created in a
-// consumer's project at the start of analysis. The occurrence's operation will
-// indicate the status of the analysis. Absence of an occurrence linked to this
-// note for a resource indicates that analysis hasn't started.
-message Discovery {
-  // Provides information about the scan status of a discovered resource.
-  message Discovered {
-    // Analysis status for a resource.
-    enum AnalysisStatus {
-      // Unknown
-      ANALYSIS_STATUS_UNSPECIFIED = 0;
-
-      // Resource is known but no action has been taken yet.
-      PENDING = 1;
-
-      // Resource is being analyzed.
-      SCANNING = 2;
-
-      // Analysis has finished successfully.
-      FINISHED_SUCCESS = 3;
-
-      // Analysis has finished unsuccessfully, the analysis itself is in a bad
-      // state.
-      FINISHED_FAILED = 4;
-
-      // Analysis will not happen, the resource is not supported.
-      UNSUPPORTED_RESOURCE = 5;
-    }
-
-    // Output only. An operation that indicates the status of the current scan.
-    google.longrunning.Operation operation = 1;
-
-    // The status of discovery for the resource.
-    AnalysisStatus analysis_status = 5;
-
-    // When an error is encountered this will contain a LocalizedMessage under
-    // details to show to the user. The LocalizedMessage output only and
-    // populated by the API.
-    google.rpc.Status analysis_status_error = 6;
-  }
-
-  // The kind of analysis that is handled by this discovery.
-  Note.Kind analysis_kind = 1;
-}
-
-// Note holding the version of the provider's builder and the signature of
-// the provenance message in linked BuildDetails.
-message BuildType {
-  // Version of the builder which produced this Note.
-  string builder_version = 1;
-
-  // Signature of the build in Occurrences pointing to the Note containing this
-  // `BuilderDetails`.
-  BuildSignature signature = 2;
-}
-
-// Message encapsulating the signature of the verified build.
-message BuildSignature {
-  // Public key formats
-  enum KeyType {
-    // `KeyType` is not set.
-    KEY_TYPE_UNSPECIFIED = 0;
-
-    // `PGP ASCII Armored` public key.
-    PGP_ASCII_ARMORED = 1;
-
-    // `PKIX PEM` public key.
-    PKIX_PEM = 2;
-  }
-
-  // Public key of the builder which can be used to verify that the related
-  // findings are valid and unchanged. If `key_type` is empty, this defaults
-  // to PEM encoded public keys.
-  //
-  // This field may be empty if `key_id` references an external key.
-  //
-  // For Cloud Build based signatures, this is a PEM encoded public
-  // key. To verify the Cloud Build signature, place the contents of
-  // this field into a file (public.pem). The signature field is base64-decoded
-  // into its binary representation in signature.bin, and the provenance bytes
-  // from `BuildDetails` are base64-decoded into a binary representation in
-  // signed.bin. OpenSSL can then verify the signature:
-  // `openssl sha256 -verify public.pem -signature signature.bin signed.bin`
-  string public_key = 1;
-
-  // Signature of the related `BuildProvenance`, encoded in a base64 string.
-  string signature = 2;
-
-  // An Id for the key used to sign. This could be either an Id for the key
-  // stored in `public_key` (such as the Id or fingerprint for a PGP key, or the
-  // CN for a cert), or a reference to an external key (such as a reference to a
-  // key in Cloud Key Management Service).
-  string key_id = 3;
-
-  // The type of the key, either stored in `public_key` or referenced in
-  // `key_id`
-  KeyType key_type = 4;
-}
-
-// An attestation wrapper with a PGP-compatible signature.
-// This message only supports `ATTACHED` signatures, where the payload that is
-// signed is included alongside the signature itself in the same file.
-message PgpSignedAttestation {
-  // Type (for example schema) of the attestation payload that was signed.
-  enum ContentType {
-    // `ContentType` is not set.
-    CONTENT_TYPE_UNSPECIFIED = 0;
-
-    // Atomic format attestation signature. See
-    // https://github.com/containers/image/blob/8a5d2f82a6e3263290c8e0276c3e0f64e77723e7/docs/atomic-signature.md
-    // The payload extracted from `signature` is a JSON blob conforming to the
-    // linked schema.
-    SIMPLE_SIGNING_JSON = 1;
-  }
-
-  // The raw content of the signature, as output by GNU Privacy Guard (GPG) or
-  // equivalent.  Since this message only supports attached signatures, the
-  // payload that was signed must be attached. While the signature format
-  // supported is dependent on the verification implementation, currently only
-  // ASCII-armored (`--armor` to gpg), non-clearsigned (`--sign` rather than
-  // `--clearsign` to gpg) are supported. Concretely, `gpg --sign --armor
-  // --output=signature.gpg payload.json` will create the signature content
-  // expected in this field in `signature.gpg` for the `payload.json`
-  // attestation payload.
-  string signature = 1;
-
-  // Type (for example schema) of the attestation payload that was signed.
-  // The verifier must ensure that the provided type is one that the verifier
-  // supports, and that the attestation payload is a valid instantiation of that
-  // type (for example by validating a JSON schema).
-  ContentType content_type = 3;
-
-  // This field is used by verifiers to select the public key used to validate
-  // the signature.  Note that the policy of the verifier ultimately determines
-  // which public keys verify a signature based on the context of the
-  // verification.  There is no guarantee validation will succeed if the
-  // verifier has no key matching this ID, even if it has a key under a
-  // different ID that would verify the signature. Note that this ID should also
-  // be present in the signature content above, but that is not expected to be
-  // used by the verifier.
-  oneof key_id {
-    // The cryptographic fingerprint of the key used to generate the signature,
-    // as output by, e.g. `gpg --list-keys`. This should be the version 4, full
-    // 160-bit fingerprint, expressed as a 40 character hexadecimal string. See
-    // https://tools.ietf.org/html/rfc4880#section-12.2 for details.
-    // Implementations may choose to acknowledge "LONG", "SHORT", or other
-    // abbreviated key IDs, but only the full fingerprint is guaranteed to work.
-    // In gpg, the full fingerprint can be retrieved from the `fpr` field
-    // returned when calling --list-keys with --with-colons.  For example:
-    // ```
-    // gpg --with-colons --with-fingerprint --force-v4-certs \
-    //     --list-keys attester@example.com
-    // tru::1:1513631572:0:3:1:5
-    // pub:......
-    // fpr:::::::::24FF6481B76AC91E66A00AC657A93A81EF3AE6FB:
-    // ```
-    // Above, the fingerprint is `24FF6481B76AC91E66A00AC657A93A81EF3AE6FB`.
-    string pgp_key_id = 2;
-  }
-}
-
-// Note kind that represents a logical attestation "role" or "authority".  For
-// example, an organization might have one `AttestationAuthority` for "QA" and
-// one for "build".  This Note is intended to act strictly as a grouping
-// mechanism for the attached Occurrences (Attestations).  This grouping
-// mechanism also provides a security boundary, since IAM ACLs gate the ability
-// for a principle to attach an Occurrence to a given Note.  It also provides a
-// single point of lookup to find all attached Attestation Occurrences, even if
-// they don't all live in the same project.
-message AttestationAuthority {
-  // This submessage provides human-readable hints about the purpose of the
-  // AttestationAuthority.  Because the name of a Note acts as its resource
-  // reference, it is important to disambiguate the canonical name of the Note
-  // (which might be a UUID for security purposes) from "readable" names more
-  // suitable for debug output.  Note that these hints should NOT be used to
-  // look up AttestationAuthorities in security sensitive contexts, such as when
-  // looking up Attestations to verify.
-  message AttestationAuthorityHint {
-    // The human readable name of this Attestation Authority, for example "qa".
-    string human_readable_name = 1;
-  }
-
-  // Occurrence that represents a single "attestation".  The authenticity of an
-  // Attestation can be verified using the attached signature. If the verifier
-  // trusts the public key of the signer, then verifying the signature is
-  // sufficient to establish trust.  In this circumstance, the
-  // AttestationAuthority to which this Attestation is attached is primarily
-  // useful for look-up (how to find this Attestation if you already know the
-  // Authority and artifact to be verified) and intent (which authority was this
-  // attestation intended to sign for).
-  message Attestation {
-    // The signature, generally over the `resource_url`, that verifies this
-    // attestation.  The semantics of the signature veracity are ultimately
-    // determined by the verification engine.
-    oneof signature {
-      PgpSignedAttestation pgp_signed_attestation = 1;
-    }
-  }
-
-  AttestationAuthorityHint hint = 1;
-}
-
-// Message encapsulating build provenance details.
-message BuildDetails {
-  // The actual provenance
-  BuildProvenance provenance = 1;
-
-  // Serialized JSON representation of the provenance, used in generating the
-  // `BuildSignature` in the corresponding Result. After verifying the
-  // signature, `provenance_bytes` can be unmarshalled and compared to the
-  // provenance to confirm that it is unchanged. A base64-encoded string
-  // representation of the provenance bytes is used for the signature in order
-  // to interoperate with openssl which expects this format for signature
-  // verification.
-  //
-  // The serialized form is captured both to avoid ambiguity in how the
-  // provenance is marshalled to json as well to prevent incompatibilities with
-  // future changes.
-  string provenance_bytes = 2;
-}
-
-// Indicates various scans and whether they are turned on or off.
-message ScanConfig {
-  // Output only. The name of the ScanConfig in the form
-  // “projects/{project_id}/ScanConfigs/{ScanConfig_id}".
-  string name = 1;
-
-  // Output only. A human-readable description of what the `ScanConfig` does.
-  string description = 2;
-
-  // Indicates whether the Scan is enabled.
-  bool enabled = 3;
-}
-
-// Request to get a Occurrence.
-message GetOccurrenceRequest {
-  // The name of the occurrence of the form
-  // "projects/{project_id}/occurrences/{OCCURRENCE_ID}"
-  string name = 1;
-}
-
-// Request to list occurrences.
-message ListOccurrencesRequest {
-  // The name field contains the project Id. For example:
-  // "projects/{project_id}
-  // @Deprecated
-  string name = 1;
-
-  // This contains the project Id for example: projects/{project_id}.
-  string parent = 5;
-
-  // The filter expression.
-  string filter = 2;
-
-  // Number of occurrences to return in the list.
-  int32 page_size = 3;
-
-  // Token to provide to skip to a particular spot in the list.
-  string page_token = 4;
-
-  // The kind of occurrences to filter on.
-  Note.Kind kind = 6;
-}
-
-// Response including listed active occurrences.
-message ListOccurrencesResponse {
-  // The occurrences requested.
-  repeated Occurrence occurrences = 1;
-
-  // The next pagination token in the list response. It should be used as
-  // `page_token` for the following request. An empty value means no more
-  // results.
-  string next_page_token = 2;
-}
-
-// Request to delete a occurrence
-message DeleteOccurrenceRequest {
-  // The name of the occurrence in the form of
-  // "projects/{project_id}/occurrences/{OCCURRENCE_ID}"
-  string name = 1;
-}
-
-// Request to insert a new occurrence.
-message CreateOccurrenceRequest {
-  // The name of the project.  Should be of the form "projects/{project_id}".
-  // @Deprecated
-  string name = 1;
-
-  // This field contains the project Id for example: "projects/{project_id}"
-  string parent = 3;
-
-  // The occurrence to be inserted
-  Occurrence occurrence = 2;
-}
-
-// Request to update an existing occurrence
-message UpdateOccurrenceRequest {
-  // The name of the occurrence.
-  // Should be of the form "projects/{project_id}/occurrences/{OCCURRENCE_ID}".
-  string name = 1;
-
-  // The updated occurrence.
-  Occurrence occurrence = 2;
-
-  // The fields to update.
-  google.protobuf.FieldMask update_mask = 3;
-}
-
-// Request to get a Note.
-message GetNoteRequest {
-  // The name of the note in the form of
-  // "providers/{provider_id}/notes/{NOTE_ID}"
-  string name = 1;
-}
-
-// Request to get the note to which this occurrence is attached.
-message GetOccurrenceNoteRequest {
-  // The name of the occurrence in the form
-  // "projects/{project_id}/occurrences/{OCCURRENCE_ID}"
-  string name = 1;
-}
-
-// Request to list notes.
-message ListNotesRequest {
-  // The name field will contain the project Id for example:
-  // "providers/{provider_id}
-  // @Deprecated
-  string name = 1;
-
-  // This field contains the project Id for example: "projects/{PROJECT_ID}".
-  string parent = 5;
-
-  // The filter expression.
-  string filter = 2;
-
-  // Number of notes to return in the list.
-  int32 page_size = 3;
-
-  // Token to provide to skip to a particular spot in the list.
-  string page_token = 4;
-}
-
-// Response including listed notes.
-message ListNotesResponse {
-  // The occurrences requested
-  repeated Note notes = 1;
-
-  // The next pagination token in the list response. It should be used as
-  // page_token for the following request. An empty value means no more result.
-  string next_page_token = 2;
-}
-
-// Request to delete a note
-message DeleteNoteRequest {
-  // The name of the note in the form of
-  // "providers/{provider_id}/notes/{NOTE_ID}"
-  string name = 1;
-}
-
-// Request to insert a new note
-message CreateNoteRequest {
-  // The name of the project.
-  // Should be of the form "providers/{provider_id}".
-  // @Deprecated
-  string name = 1;
-
-  // This field contains the project Id for example:
-  // "projects/{project_id}
-  string parent = 4;
-
-  // The ID to use for this note.
-  string note_id = 2;
-
-  // The Note to be inserted
-  Note note = 3;
-}
-
-// Request to update an existing note
-message UpdateNoteRequest {
-  // The name of the note.
-  // Should be of the form "projects/{provider_id}/notes/{note_id}".
-  string name = 1;
-
-  // The updated note.
-  Note note = 2;
-
-  // The fields to update.
-  google.protobuf.FieldMask update_mask = 3;
-}
-
-// Request to list occurrences.
-message ListNoteOccurrencesRequest {
-  // The name field will contain the note name for example:
-  //   "provider/{provider_id}/notes/{note_id}"
-  string name = 1;
-
-  // The filter expression.
-  string filter = 2;
-
-  // Number of notes to return in the list.
-  int32 page_size = 3;
-
-  // Token to provide to skip to a particular spot in the list.
-  string page_token = 4;
-}
-
-// Response including listed occurrences for a note.
-message ListNoteOccurrencesResponse {
-  // The occurrences attached to the specified note.
-  repeated Occurrence occurrences = 1;
-
-  // Token to receive the next page of notes.
-  string next_page_token = 2;
-}
-
-// Request for creating an operation
-message CreateOperationRequest {
-  // The project Id that this operation should be created under.
-  string parent = 1;
-
-  // The ID to use for this operation.
-  string operation_id = 2;
-
-  // The operation to create.
-  google.longrunning.Operation operation = 3;
-}
-
-// Request for updating an existing operation
-message UpdateOperationRequest {
-  // The name of the Operation.
-  // Should be of the form "projects/{provider_id}/operations/{operation_id}".
-  string name = 1;
-
-  // The operation to create.
-  google.longrunning.Operation operation = 3;
-
-  google.protobuf.FieldMask update_mask = 4;
-}
-
-// Metadata for all operations used and required for all operations
-// that created by Container Analysis Providers
-message OperationMetadata {
-  // Output only. The time this operation was created.
-  google.protobuf.Timestamp create_time = 1;
-
-  // Output only. The time that this operation was marked completed or failed.
-  google.protobuf.Timestamp end_time = 2;
-}
-
-// Request to get the vulnz summary for some set of vulnerability Occurrences.
-message GetVulnzOccurrencesSummaryRequest {
-  // This contains the project Id for example: projects/{project_id}
-  string parent = 1;
-
-  // The filter expression.
-  string filter = 2;
-}
-
-// A summary of how many vulnz occurrences there are per severity type.
-// counts by groups, or if we should have different summary messages
-// like this.
-message GetVulnzOccurrencesSummaryResponse {
-  // The number of occurrences created for a specific severity.
-  message SeverityCount {
-    // The severity of the occurrences.
-    VulnerabilityType.Severity severity = 1;
-
-    // The number of occurrences with the severity.
-    int64 count = 2;
-  }
-
-  // A map of how many occurrences were found for each severity.
-  repeated SeverityCount counts = 1;
-}
-
-// Request to get a ScanConfig.
-message GetScanConfigRequest {
-  // The name of the ScanConfig in the form
-  // projects/{project_id}/scan_configs/{ScanConfig_id}
-  // instead.
-  string name = 1;
-}
-
-// Request to list the available scan configurations.
-message ListScanConfigsRequest {
-  // This containers the project Id i.e.: projects/{project_id}
-  // instead.
-  string parent = 1;
-
-  // The filter expression.
-  string filter = 2;
-
-  // The number of items to return.
-  int32 page_size = 3;
-
-  // The page token to use for the next request.
-  string page_token = 4;
-}
-
-// A list of ScanConfigs for the project.
-message ListScanConfigsResponse {
-  // The set of scan configs
-  repeated ScanConfig scan_configs = 1;
-
-  // A page token to pass in order to get more scans.
-  string next_page_token = 2;
-}
-
-// A request to update a ScanConfig.
-message UpdateScanConfigRequest {
-  // The scan config to update of the form
-  // projects/{project_id}/scan_configs/{ScanConfig_id}
-  // instead.
-  string name = 1;
-
-  // The new scan configuration
-  ScanConfig scan_config = 2;
-
-  google.protobuf.FieldMask update_mask = 3;
-}
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1alpha1/image_basis.proto b/third_party/googleapis/google/devtools/containeranalysis/v1alpha1/image_basis.proto
deleted file mode 100644
index f97296969..000000000
--- a/third_party/googleapis/google/devtools/containeranalysis/v1alpha1/image_basis.proto
+++ /dev/null
@@ -1,147 +0,0 @@
-// Copyright 2018 Google Inc.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-syntax = "proto3";
-
-package google.devtools.containeranalysis.v1alpha1;
-
-import "google/api/annotations.proto";
-
-option go_package = "google.golang.org/genproto/googleapis/devtools/containeranalysis/v1alpha1;containeranalysis";
-option java_multiple_files = true;
-option java_package = "com.google.containeranalysis.v1alpha1";
-option objc_class_prefix = "GCA";
-
-// DockerImage holds types defining base image notes
-// and derived image occurrences.
-message DockerImage {
-  // Layer holds metadata specific to a layer of a Docker image.
-  message Layer {
-    // Instructions from dockerfile
-    enum Directive {
-      // Default value for unsupported/missing directive
-      DIRECTIVE_UNSPECIFIED = 0;
-
-      // https://docs.docker.com/reference/builder/#maintainer
-      MAINTAINER = 1;
-
-      // https://docs.docker.com/reference/builder/#run
-      RUN = 2;
-
-      // https://docs.docker.com/reference/builder/#cmd
-      CMD = 3;
-
-      // https://docs.docker.com/reference/builder/#label
-      LABEL = 4;
-
-      // https://docs.docker.com/reference/builder/#expose
-      EXPOSE = 5;
-
-      // https://docs.docker.com/reference/builder/#env
-      ENV = 6;
-
-      // https://docs.docker.com/reference/builder/#add
-      ADD = 7;
-
-      // https://docs.docker.com/reference/builder/#copy
-      COPY = 8;
-
-      // https://docs.docker.com/reference/builder/#entrypoint
-      ENTRYPOINT = 9;
-
-      // https://docs.docker.com/reference/builder/#volume
-      VOLUME = 10;
-
-      // https://docs.docker.com/reference/builder/#user
-      USER = 11;
-
-      // https://docs.docker.com/reference/builder/#workdir
-      WORKDIR = 12;
-
-      // https://docs.docker.com/reference/builder/#arg
-      ARG = 13;
-
-      // https://docs.docker.com/reference/builder/#onbuild
-      ONBUILD = 14;
-
-      // https://docs.docker.com/reference/builder/#stopsignal
-      STOPSIGNAL = 15;
-
-      // https://docs.docker.com/reference/builder/#healthcheck
-      HEALTHCHECK = 16;
-
-      // https://docs.docker.com/reference/builder/#shell
-      SHELL = 17;
-    }
-
-    // The recovered Dockerfile directive used to construct this layer.
-    Directive directive = 1;
-
-    // The recovered arguments to the Dockerfile directive.
-    string arguments = 2;
-  }
-
-  // A set of properties that uniquely identify a given Docker image.
-  message Fingerprint {
-    // The layer-id of the final layer in the Docker image's v1
-    // representation.
-    // This field can be used as a filter in list requests.
-    string v1_name = 1;
-
-    // The ordered list of v2 blobs that represent a given image.
-    repeated string v2_blob = 2;
-
-    // Output only. The name of the image's v2 blobs computed via:
-    //   [bottom] := v2_blob[bottom]
-    //   [N] := sha256(v2_blob[N] + " " + v2_name[N+1])
-    // Only the name of the final blob is kept.
-    // This field can be used as a filter in list requests.
-    string v2_name = 3;
-  }
-
-  // Basis describes the base image portion (Note) of the DockerImage
-  // relationship.  Linked occurrences are derived from this or an
-  // equivalent image via:
-  //   FROM 
-  // Or an equivalent reference, e.g. a tag of the resource_url.
-  message Basis {
-    // The resource_url for the resource representing the basis of
-    // associated occurrence images.
-    string resource_url = 1;
-
-    // The fingerprint of the base image.
-    Fingerprint fingerprint = 2;
-  }
-
-  // Derived describes the derived image portion (Occurrence) of the
-  // DockerImage relationship.  This image would be produced from a Dockerfile
-  // with FROM .
-  message Derived {
-    // The fingerprint of the derived image.
-    Fingerprint fingerprint = 1;
-
-    // Output only. The number of layers by which this image differs from the
-    // associated image basis.
-    uint32 distance = 2;
-
-    // This contains layer-specific metadata, if populated it has length
-    // "distance" and is ordered with [distance] being the layer immediately
-    // following the base image and [1] being the final layer.
-    repeated Layer layer_info = 3;
-
-    // Output only. This contains the base image URL for the derived image
-    // occurrence.
-    string base_resource_url = 4;
-  }
-}
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1alpha1/package_vulnerability.proto b/third_party/googleapis/google/devtools/containeranalysis/v1alpha1/package_vulnerability.proto
deleted file mode 100644
index e56dd6c38..000000000
--- a/third_party/googleapis/google/devtools/containeranalysis/v1alpha1/package_vulnerability.proto
+++ /dev/null
@@ -1,181 +0,0 @@
-// Copyright 2018 Google Inc.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-syntax = "proto3";
-
-package google.devtools.containeranalysis.v1alpha1;
-
-import "google/api/annotations.proto";
-
-option go_package = "google.golang.org/genproto/googleapis/devtools/containeranalysis/v1alpha1;containeranalysis";
-option java_multiple_files = true;
-option java_package = "com.google.containeranalysis.v1alpha1";
-option objc_class_prefix = "GCA";
-
-// VulnerabilityType provides metadata about a security vulnerability.
-message VulnerabilityType {
-  // Version contains structured information about the version of the package.
-  // For a discussion of this in Debian/Ubuntu:
-  // http://serverfault.com/questions/604541/debian-packages-version-convention
-  // For a discussion of this in Redhat/Fedora/Centos:
-  // http://blog.jasonantman.com/2014/07/how-yum-and-rpm-compare-versions/
-  message Version {
-    // Whether this is an ordinary package version or a
-    // sentinel MIN/MAX version.
-    enum VersionKind {
-      // A standard package version, defined by the other fields.
-      NORMAL = 0;
-
-      // A special version representing negative infinity,
-      // other fields are ignored.
-      MINIMUM = 1;
-
-      // A special version representing positive infinity,
-      // other fields are ignored.
-      MAXIMUM = 2;
-    }
-
-    // Used to correct mistakes in the version numbering scheme.
-    int32 epoch = 1;
-
-    // The main part of the version name.
-    string name = 2;
-
-    // The iteration of the package build from the above version.
-    string revision = 3;
-
-    // Distinguish between sentinel MIN/MAX versions and normal versions.
-    // If kind is not NORMAL, then the other fields are ignored.
-    VersionKind kind = 5;
-  }
-
-  // Identifies all occurrences of this vulnerability in the package for a
-  // specific distro/location
-  // For example: glibc in cpe:/o:debian:debian_linux:8 for versions 2.1 - 2.2
-  message Detail {
-    // The cpe_uri in [cpe format] (https://cpe.mitre.org/specification/) in
-    // which the vulnerability manifests.  Examples include distro or storage
-    // location for vulnerable jar.
-    // This field can be used as a filter in list requests.
-    string cpe_uri = 1;
-
-    // The name of the package where the vulnerability was found.
-    // This field can be used as a filter in list requests.
-    string package = 8;
-
-    // The min version of the package in which the vulnerability exists.
-    Version min_affected_version = 6;
-
-    // The max version of the package in which the vulnerability exists.
-    // This field can be used as a filter in list requests.
-    Version max_affected_version = 7;
-
-    // The severity (eg: distro assigned severity) for this vulnerability.
-    string severity_name = 4;
-
-    // A vendor-specific description of this note.
-    string description = 9;
-
-    // The fix for this specific package version.
-    VulnerabilityLocation fixed_location = 5;
-
-    // The type of package; whether native or non native(ruby gems,
-    // node.js packages etc)
-    string package_type = 10;
-
-    // Whether this Detail is obsolete. Occurrences are expected not to point to
-    // obsolete details.
-    bool is_obsolete = 11;
-  }
-
-  // Used by Occurrence to point to where the vulnerability exists and how
-  // to fix it.
-  message VulnerabilityDetails {
-    // The type of package; whether native or non native(ruby gems,
-    // node.js packages etc)
-    string type = 3;
-
-    // Output only. The note provider assigned Severity of the vulnerability.
-    Severity severity = 4;
-
-    // Output only. The CVSS score of this vulnerability. CVSS score is on a
-    // scale of 0-10 where 0 indicates low severity and 10 indicates high
-    // severity.
-    float cvss_score = 5;
-
-    // The set of affected locations and their fixes (if available) within
-    // the associated resource.
-    repeated PackageIssue package_issue = 6;
-  }
-
-  // This message wraps a location affected by a vulnerability and its
-  // associated fix (if one is available).
-  message PackageIssue {
-    // The location of the vulnerability.
-    VulnerabilityLocation affected_location = 1;
-
-    // The location of the available fix for vulnerability.
-    VulnerabilityLocation fixed_location = 2;
-
-    // The severity (eg: distro assigned severity) for this vulnerability.
-    string severity_name = 3;
-  }
-
-  // The location of the vulnerability
-  message VulnerabilityLocation {
-    // The cpe_uri in [cpe format] (https://cpe.mitre.org/specification/)
-    // format. Examples include distro or storage location for vulnerable jar.
-    // This field can be used as a filter in list requests.
-    string cpe_uri = 1;
-
-    // The package being described.
-    string package = 2;
-
-    // The version of the package being described.
-    // This field can be used as a filter in list requests.
-    Version version = 4;
-  }
-
-  // Note provider-assigned severity/impact ranking
-  enum Severity {
-    // Unknown Impact
-    SEVERITY_UNSPECIFIED = 0;
-
-    // Minimal Impact
-    MINIMAL = 1;
-
-    // Low Impact
-    LOW = 2;
-
-    // Medium Impact
-    MEDIUM = 3;
-
-    // High Impact
-    HIGH = 4;
-
-    // Critical Impact
-    CRITICAL = 5;
-  }
-
-  // The CVSS score for this Vulnerability.
-  float cvss_score = 2;
-
-  // Note provider assigned impact of the vulnerability
-  Severity severity = 3;
-
-  // All information about the package to specifically identify this
-  // vulnerability. One entry per (version range and cpe_uri) the
-  // package vulnerability has manifested in.
-  repeated Detail details = 4;
-}
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1alpha1/provenance.proto b/third_party/googleapis/google/devtools/containeranalysis/v1alpha1/provenance.proto
deleted file mode 100644
index ce2b53202..000000000
--- a/third_party/googleapis/google/devtools/containeranalysis/v1alpha1/provenance.proto
+++ /dev/null
@@ -1,223 +0,0 @@
-// Copyright 2018 Google Inc.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-syntax = "proto3";
-
-package google.devtools.containeranalysis.v1alpha1;
-
-import "google/api/annotations.proto";
-import "google/devtools/containeranalysis/v1alpha1/source_context.proto";
-import "google/protobuf/timestamp.proto";
-
-option go_package = "google.golang.org/genproto/googleapis/devtools/containeranalysis/v1alpha1;containeranalysis";
-option java_multiple_files = true;
-option java_package = "com.google.containeranalysis.v1alpha1";
-option objc_class_prefix = "GCA";
-
-// Provenance of a build. Contains all information needed to verify the full
-// details about the build from source to completion.
-message BuildProvenance {
-  // Unique identifier of the build.
-  string id = 1;
-
-  // ID of the project.
-  string project_id = 2;
-
-  // Commands requested by the build.
-  repeated Command commands = 5;
-
-  // Output of the build.
-  repeated Artifact built_artifacts = 6;
-
-  // Time at which the build was created.
-  google.protobuf.Timestamp create_time = 7;
-
-  // Time at which execution of the build was started.
-  google.protobuf.Timestamp start_time = 8;
-
-  // Time at which execution of the build was finished.
-  google.protobuf.Timestamp finish_time = 9;
-
-  // E-mail address of the user who initiated this build. Note that this was the
-  // user's e-mail address at the time the build was initiated; this address may
-  // not represent the same end-user for all time.
-  string creator = 11;
-
-  // Google Cloud Storage bucket where logs were written.
-  string logs_bucket = 13;
-
-  // Details of the Source input to the build.
-  Source source_provenance = 14;
-
-  // Trigger identifier if the build was triggered automatically; empty if not.
-  string trigger_id = 15;
-
-  // Special options applied to this build. This is a catch-all field where
-  // build providers can enter any desired additional details.
-  map build_options = 16;
-
-  // Version string of the builder at the time this build was executed.
-  string builder_version = 17;
-}
-
-// Source describes the location of the source used for the build.
-message Source {
-  // Source location information.
-  oneof source {
-    // If provided, get the source from this location in in Google Cloud
-    // Storage.
-    StorageSource storage_source = 1;
-
-    // If provided, get source from this location in a Cloud Repo.
-    RepoSource repo_source = 2;
-  }
-
-  // If provided, the input binary artifacts for the build came from this
-  // location.
-  StorageSource artifact_storage_source = 4;
-
-  // Hash(es) of the build source, which can be used to verify that the original
-  // source integrity was maintained in the build.
-  //
-  // The keys to this map are file paths used as build source and the values
-  // contain the hash values for those files.
-  //
-  // If the build source came in a single package such as a gzipped tarfile
-  // (.tar.gz), the FileHash will be for the single path to that file.
-  map file_hashes = 3;
-
-  // If provided, the source code used for the build came from this location.
-  SourceContext context = 7;
-
-  // If provided, some of the source code used for the build may be found in
-  // these locations, in the case where the source repository had multiple
-  // remotes or submodules. This list will not include the context specified in
-  // the context field.
-  repeated SourceContext additional_contexts = 8;
-}
-
-// Container message for hashes of byte content of files, used in Source
-// messages to verify integrity of source input to the build.
-message FileHashes {
-  // Collection of file hashes.
-  repeated Hash file_hash = 1;
-}
-
-// Container message for hash values.
-message Hash {
-  // Specifies the hash algorithm, if any.
-  enum HashType {
-    // No hash requested.
-    NONE = 0;
-
-    // A sha256 hash.
-    SHA256 = 1;
-  }
-
-  // The type of hash that was performed.
-  HashType type = 1;
-
-  // The hash value.
-  bytes value = 2;
-}
-
-// StorageSource describes the location of the source in an archive file in
-// Google Cloud Storage.
-message StorageSource {
-  // Google Cloud Storage bucket containing source (see [Bucket Name
-  // Requirements]
-  // (https://cloud.google.com/storage/docs/bucket-naming#requirements)).
-  string bucket = 1;
-
-  // Google Cloud Storage object containing source.
-  string object = 2;
-
-  // Google Cloud Storage generation for the object.
-  int64 generation = 3;
-}
-
-// RepoSource describes the location of the source in a Google Cloud Source
-// Repository.
-message RepoSource {
-  // ID of the project that owns the repo.
-  string project_id = 1;
-
-  // Name of the repo.
-  string repo_name = 2;
-
-  // A revision within the source repository must be specified in
-  // one of these ways.
-  oneof revision {
-    // Name of the branch to build.
-    string branch_name = 3;
-
-    // Name of the tag to build.
-    string tag_name = 4;
-
-    // Explicit commit SHA to build.
-    string commit_sha = 5;
-  }
-}
-
-// Command describes a step performed as part of the build pipeline.
-message Command {
-  // Name of the command, as presented on the command line, or if the command is
-  // packaged as a Docker container, as presented to `docker pull`.
-  string name = 1;
-
-  // Environment variables set before running this Command.
-  repeated string env = 2;
-
-  // Command-line arguments used when executing this Command.
-  repeated string args = 3;
-
-  // Working directory (relative to project source root) used when running
-  // this Command.
-  string dir = 4;
-
-  // Optional unique identifier for this Command, used in wait_for to reference
-  // this Command as a dependency.
-  string id = 5;
-
-  // The ID(s) of the Command(s) that this Command depends on.
-  repeated string wait_for = 6;
-}
-
-// Artifact describes a build product.
-message Artifact {
-  // Name of the artifact. This may be the path to a binary or jar file, or in
-  // the case of a container build, the name used to push the container image to
-  // Google Container Registry, as presented to `docker push`.
-  //
-  // This field is deprecated in favor of the plural `names` field; it continues
-  // to exist here to allow existing BuildProvenance serialized to json in
-  // google.devtools.containeranalysis.v1alpha1.BuildDetails.provenance_bytes to
-  // deserialize back into proto.
-  string name = 1;
-
-  // Hash or checksum value of a binary, or Docker Registry 2.0 digest of a
-  // container.
-  string checksum = 2;
-
-  // Artifact ID, if any; for container images, this will be a URL by digest
-  // like gcr.io/projectID/imagename@sha256:123456
-  string id = 3;
-
-  // Related artifact names. This may be the path to a binary or jar file, or in
-  // the case of a container build, the name used to push the container image to
-  // Google Container Registry, as presented to `docker push`. Note that a
-  // single Artifact ID can have multiple names, for example if two tags are
-  // applied to one image.
-  repeated string names = 4;
-}
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1alpha1/source_context.proto b/third_party/googleapis/google/devtools/containeranalysis/v1alpha1/source_context.proto
deleted file mode 100644
index e9d16643d..000000000
--- a/third_party/googleapis/google/devtools/containeranalysis/v1alpha1/source_context.proto
+++ /dev/null
@@ -1,140 +0,0 @@
-// Copyright 2018 Google Inc.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-syntax = "proto3";
-
-package google.devtools.containeranalysis.v1alpha1;
-
-import "google/api/annotations.proto";
-
-option go_package = "google.golang.org/genproto/googleapis/devtools/containeranalysis/v1alpha1;containeranalysis";
-option java_multiple_files = true;
-option java_package = "com.google.containeranalysis.v1alpha1";
-option objc_class_prefix = "GCA";
-
-// A SourceContext is a reference to a tree of files. A SourceContext together
-// with a path point to a unique revision of a single file or directory.
-message SourceContext {
-  // A SourceContext can refer any one of the following types of repositories.
-  oneof context {
-    // A SourceContext referring to a revision in a Google Cloud Source Repo.
-    CloudRepoSourceContext cloud_repo = 1;
-
-    // A SourceContext referring to a Gerrit project.
-    GerritSourceContext gerrit = 2;
-
-    // A SourceContext referring to any third party Git repo (e.g., GitHub).
-    GitSourceContext git = 3;
-  }
-
-  // Labels with user defined metadata.
-  map labels = 4;
-}
-
-// An alias to a repo revision.
-message AliasContext {
-  // The type of an alias.
-  enum Kind {
-    // Unknown.
-    KIND_UNSPECIFIED = 0;
-
-    // Git tag.
-    FIXED = 1;
-
-    // Git branch.
-    MOVABLE = 2;
-
-    // Used to specify non-standard aliases. For example, if a Git repo has a
-    // ref named "refs/foo/bar".
-    OTHER = 4;
-  }
-
-  // The alias kind.
-  Kind kind = 1;
-
-  // The alias name.
-  string name = 2;
-}
-
-// A CloudRepoSourceContext denotes a particular revision in a Google Cloud
-// Source Repo.
-message CloudRepoSourceContext {
-  // The ID of the repo.
-  RepoId repo_id = 1;
-
-  // A revision in a Cloud Repo can be identified by either its revision ID or
-  // its alias.
-  oneof revision {
-    // A revision ID.
-    string revision_id = 2;
-
-    // An alias, which may be a branch or tag.
-    AliasContext alias_context = 3;
-  }
-}
-
-// A SourceContext referring to a Gerrit project.
-message GerritSourceContext {
-  // The URI of a running Gerrit instance.
-  string host_uri = 1;
-
-  // The full project name within the host. Projects may be nested, so
-  // "project/subproject" is a valid project name. The "repo name" is
-  // the hostURI/project.
-  string gerrit_project = 2;
-
-  // A revision in a Gerrit project can be identified by either its revision ID
-  // or its alias.
-  oneof revision {
-    // A revision (commit) ID.
-    string revision_id = 3;
-
-    // An alias, which may be a branch or tag.
-    AliasContext alias_context = 4;
-  }
-}
-
-// A GitSourceContext denotes a particular revision in a third party Git
-// repository (e.g., GitHub).
-message GitSourceContext {
-  // Git repository URL.
-  string url = 1;
-
-  // Required.
-  // Git commit hash.
-  string revision_id = 2;
-}
-
-// A unique identifier for a Cloud Repo.
-message RepoId {
-  // A cloud repo can be identified by either its project ID and repository name
-  // combination, or its globally unique identifier.
-  oneof id {
-    // A combination of a project ID and a repo name.
-    ProjectRepoId project_repo_id = 1;
-
-    // A server-assigned, globally unique identifier.
-    string uid = 2;
-  }
-}
-
-// Selects a repo using a Google Cloud Platform project ID (e.g.,
-// winged-cargo-31) and a repo name within that project.
-message ProjectRepoId {
-  // The ID of the project.
-  string project_id = 1;
-
-  // The name of the repo. Leave empty for the default repo.
-  string repo_name = 2;
-}
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/BUILD.bazel b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/BUILD.bazel
index b5133a10f..992f053c0 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/BUILD.bazel
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/BUILD.bazel
@@ -1,3 +1,5 @@
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
@@ -27,6 +29,9 @@ proto_library(
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
         "//google/iam/v1:iam_policy_proto",
         "//google/iam/v1:policy_proto",
         "@com_google_protobuf//:timestamp_proto",
@@ -36,6 +41,7 @@ proto_library(
 proto_library_with_info(
     name = "containeranalysis_proto_with_info",
     deps = [
+        "//google/cloud:common_resources_proto",
         ":containeranalysis_proto",
     ] + _PROTO_SUBPACKAGE_DEPS,
 )
@@ -47,19 +53,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-    "@com_google_api_grpc_proto_google_iam_v1//jar",
-]
-
 _JAVA_PROTO_SUBPACKAGE_DEPS = [
     "//google/devtools/containeranalysis/v1beta1/attestation:attestation_java_proto",
     "//google/devtools/containeranalysis/v1beta1/build:build_java_proto",
@@ -88,20 +88,6 @@ _JAVA_GRPC_SUBPACKAGE_DEPS = [
     "//google/devtools/containeranalysis/v1beta1/vulnerability:vulnerability_java_grpc",
 ]
 
-_RESOURCE_NAME_JAVA_PROTO_SUBPACKAGE_DEPS = [
-    "//google/devtools/containeranalysis/v1beta1/attestation:attestation_resource_name_java_proto",
-    "//google/devtools/containeranalysis/v1beta1/build:build_resource_name_java_proto",
-    "//google/devtools/containeranalysis/v1beta1/common:common_resource_name_java_proto",
-    "//google/devtools/containeranalysis/v1beta1/deployment:deployment_resource_name_java_proto",
-    "//google/devtools/containeranalysis/v1beta1/discovery:discovery_resource_name_java_proto",
-    "//google/devtools/containeranalysis/v1beta1/grafeas:grafeas_resource_name_java_proto",
-    "//google/devtools/containeranalysis/v1beta1/image:image_resource_name_java_proto",
-    "//google/devtools/containeranalysis/v1beta1/package:package_resource_name_java_proto",
-    "//google/devtools/containeranalysis/v1beta1/provenance:provenance_resource_name_java_proto",
-    "//google/devtools/containeranalysis/v1beta1/source:source_resource_name_java_proto",
-    "//google/devtools/containeranalysis/v1beta1/vulnerability:vulnerability_resource_name_java_proto",
-]
-
 java_proto_library(
     name = "containeranalysis_java_proto",
     deps = [":containeranalysis_proto"],
@@ -110,13 +96,7 @@ java_proto_library(
 java_grpc_library(
     name = "containeranalysis_java_grpc",
     srcs = [":containeranalysis_proto"],
-    deps = [":containeranalysis_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "containeranalysis_resource_name_java_proto",
-    gapic_yaml = "containeranalysis_gapic.yaml",
-    deps = [":containeranalysis_proto"],
+    deps = [":containeranalysis_java_proto"],
 )
 
 java_gapic_library(
@@ -129,33 +109,28 @@ java_gapic_library(
     ] + _JAVA_GRPC_SUBPACKAGE_DEPS,
     deps = [
         ":containeranalysis_java_proto",
-        ":containeranalysis_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS + _JAVA_PROTO_SUBPACKAGE_DEPS,
+        "//google/iam/v1:iam_java_proto",
+    ] + _JAVA_PROTO_SUBPACKAGE_DEPS,
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [":containeranalysis_java_gapic_test"],
-) for test_name in [
-    "com.google.cloud.devtools.containeranalysis.v1beta1.ContainerAnalysisV1Beta1ClientTest",
-    "com.google.cloud.devtools.containeranalysis.v1beta1.GrafeasV1Beta1ClientTest",
-]]
+java_gapic_test(
+    name = "containeranalysis_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.devtools.containeranalysis.v1beta1.ContainerAnalysisV1Beta1ClientTest",
+        "com.google.cloud.devtools.containeranalysis.v1beta1.GrafeasV1Beta1ClientTest",
+    ],
+    runtime_deps = ["containeranalysis_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
-    name = "google-cloud-containeranalysis-v1-java",
-    client_deps = [":containeranalysis_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":containeranalysis_java_gapic_test"],
-    grpc_deps = [":containeranalysis_java_grpc"] + _JAVA_GRPC_SUBPACKAGE_DEPS,
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    name = "google-cloud-devtools-containeranalysis-v1beta1-java",
+    deps = [
+        ":containeranalysis_java_gapic",
+        ":containeranalysis_java_grpc",
         ":containeranalysis_java_proto",
         ":containeranalysis_proto",
-        ":containeranalysis_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS + _JAVA_PROTO_SUBPACKAGE_DEPS + _PROTO_SUBPACKAGE_DEPS + _RESOURCE_NAME_JAVA_PROTO_SUBPACKAGE_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ] + _JAVA_GRPC_SUBPACKAGE_DEPS + _JAVA_PROTO_SUBPACKAGE_DEPS + _PROTO_SUBPACKAGE_DEPS,
 )
 
 ##############################################################################
@@ -163,10 +138,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -182,9 +157,9 @@ go_proto_library(
 
 go_gapic_library(
     name = "containeranalysis_go_gapic",
-    src = ":containeranalysis_proto_with_info",
-    gapic_yaml = "containeranalysis_gapic.yaml",
-    importpath = "cloud.google.com/go/containeranalysis/apiv1beta1",
+    srcs = [":containeranalysis_proto_with_info"],
+    grpc_service_config = "containeranalysis_grpc_service_config.json",
+    importpath = "cloud.google.com/go/containeranalysis/apiv1beta1;containeranalysis",
     service_yaml = "//google/devtools/containeranalysis:containeranalysis_v1beta1.yaml",
     deps = [
         ":containeranalysis_go_proto",
@@ -210,12 +185,11 @@ go_test(
     importpath = "cloud.google.com/go/containeranalysis/apiv1beta1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
-    name = "gapi-cloud-containeranalysis-v1-go",
+    name = "gapi-cloud-devtools-containeranalysis-v1beta1-go",
     deps = [
         ":containeranalysis_go_gapic",
-        ":containeranalysis_go_gapic_srcjar-smoke-test.srcjar",
         ":containeranalysis_go_gapic_srcjar-test.srcjar",
         ":containeranalysis_go_proto",
         "//google/devtools/containeranalysis/v1beta1/attestation:attestation_go_proto",
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/attestation/BUILD.bazel b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/attestation/BUILD.bazel
index 05e1086f5..347abf1a5 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/attestation/BUILD.bazel
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/attestation/BUILD.bazel
@@ -1,3 +1,5 @@
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
@@ -11,7 +13,9 @@ proto_library(
     srcs = [
         "attestation.proto",
     ],
-    deps = [],
+    deps = [
+        "//google/devtools/containeranalysis/v1beta1/common:common_proto",
+    ],
 )
 
 proto_library_with_info(
@@ -26,7 +30,6 @@ load(
     "@com_google_googleapis_imports//:imports.bzl",
     "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
 )
 
 java_proto_library(
@@ -40,12 +43,6 @@ java_grpc_library(
     deps = [":attestation_java_proto"],
 )
 
-java_resource_name_proto_library(
-    name = "attestation_resource_name_java_proto",
-    gapic_yaml = "//google/devtools/containeranalysis/v1beta1:containeranalysis_gapic.yaml",
-    deps = [":attestation_proto"],
-)
-
 ##############################################################################
 # Go
 ##############################################################################
@@ -56,5 +53,7 @@ go_proto_library(
     compilers = ["@io_bazel_rules_go//proto:go_grpc"],
     importpath = "google.golang.org/genproto/googleapis/devtools/containeranalysis/v1beta1/attestation",
     protos = [":attestation_proto"],
-    deps = [],
+    deps = [
+        "//google/devtools/containeranalysis/v1beta1/common:common_go_proto",
+    ],
 )
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/attestation/attestation.proto b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/attestation/attestation.proto
index e60b6e91a..0d3d6c9fd 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/attestation/attestation.proto
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/attestation/attestation.proto
@@ -16,6 +16,8 @@ syntax = "proto3";
 
 package grafeas.v1beta1.attestation;
 
+import "google/devtools/containeranalysis/v1beta1/common/common.proto";
+
 option go_package = "google.golang.org/genproto/googleapis/devtools/containeranalysis/v1beta1/attestation;attestation";
 option java_multiple_files = true;
 option java_package = "io.grafeas.v1beta1.attestation";
@@ -25,9 +27,9 @@ option objc_class_prefix = "GRA";
 // supports `ATTACHED` signatures, where the payload that is signed is included
 // alongside the signature itself in the same file.
 message PgpSignedAttestation {
-  // The raw content of the signature, as output by GNU Privacy Guard (GPG) or
-  // equivalent.  Since this message only supports attached signatures, the
-  // payload that was signed must be attached. While the signature format
+  // Required. The raw content of the signature, as output by GNU Privacy Guard
+  // (GPG) or equivalent. Since this message only supports attached signatures,
+  // the payload that was signed must be attached. While the signature format
   // supported is dependent on the verification implementation, currently only
   // ASCII-armored (`--armor` to gpg), non-clearsigned (`--sign` rather than
   // `--clearsign` to gpg) are supported. Concretely, `gpg --sign --armor
@@ -54,9 +56,9 @@ message PgpSignedAttestation {
   ContentType content_type = 3;
 
   // This field is used by verifiers to select the public key used to validate
-  // the signature.  Note that the policy of the verifier ultimately determines
+  // the signature. Note that the policy of the verifier ultimately determines
   // which public keys verify a signature based on the context of the
-  // verification.  There is no guarantee validation will succeed if the
+  // verification. There is no guarantee validation will succeed if the
   // verifier has no key matching this ID, even if it has a key under a
   // different ID that would verify the signature. Note that this ID should also
   // be present in the signature content above, but that is not expected to be
@@ -82,24 +84,59 @@ message PgpSignedAttestation {
   }
 }
 
+// An attestation wrapper that uses the Grafeas `Signature` message.
+// This attestation must define the `serialized_payload` that the `signatures`
+// verify and any metadata necessary to interpret that plaintext.  The
+// signatures should always be over the `serialized_payload` bytestring.
+message GenericSignedAttestation {
+  // Type of the attestation plaintext that was signed.
+  enum ContentType {
+    // `ContentType` is not set.
+    CONTENT_TYPE_UNSPECIFIED = 0;
+    // Atomic format attestation signature. See
+    // https://github.com/containers/image/blob/8a5d2f82a6e3263290c8e0276c3e0f64e77723e7/docs/atomic-signature.md
+    // The payload extracted in `plaintext` is a JSON blob conforming to the
+    // linked schema.
+    SIMPLE_SIGNING_JSON = 1;
+  }
+
+  // Type (for example schema) of the attestation payload that was signed.
+  // The verifier must ensure that the provided type is one that the verifier
+  // supports, and that the attestation payload is a valid instantiation of that
+  // type (for example by validating a JSON schema).
+  ContentType content_type = 1;
+
+  // The serialized payload that is verified by one or more `signatures`.
+  // The encoding and semantic meaning of this payload must match what is set in
+  // `content_type`.
+  bytes serialized_payload = 2;
+
+  // One or more signatures over `serialized_payload`.  Verifier implementations
+  // should consider this attestation message verified if at least one
+  // `signature` verifies `serialized_payload`.  See `Signature` in common.proto
+  // for more details on signature structure and verification.
+  repeated Signature signatures = 3;
+}
+
 // Note kind that represents a logical attestation "role" or "authority". For
 // example, an organization might have one `Authority` for "QA" and one for
-// "build". This Note is intended to act strictly as a grouping mechanism for
-// the attached Occurrences (Attestations). This grouping mechanism also
+// "build". This note is intended to act strictly as a grouping mechanism for
+// the attached occurrences (Attestations). This grouping mechanism also
 // provides a security boundary, since IAM ACLs gate the ability for a principle
-// to attach an Occurrence to a given Note. It also provides a single point of
-// lookup to find all attached Attestation Occurrences, even if they don't all
+// to attach an occurrence to a given note. It also provides a single point of
+// lookup to find all attached attestation occurrences, even if they don't all
 // live in the same project.
 message Authority {
   // This submessage provides human-readable hints about the purpose of the
-  // Authority. Because the name of a Note acts as its resource reference, it is
+  // authority. Because the name of a note acts as its resource reference, it is
   // important to disambiguate the canonical name of the Note (which might be a
   // UUID for security purposes) from "readable" names more suitable for debug
-  // output. Note that these hints should NOT be used to look up authorities in
-  // security sensitive contexts, such as when looking up Attestations to
+  // output. Note that these hints should not be used to look up authorities in
+  // security sensitive contexts, such as when looking up attestations to
   // verify.
   message Hint {
-    // The human readable name of this Attestation Authority, for example "qa".
+    // Required. The human readable name of this attestation authority, for
+    // example "qa".
     string human_readable_name = 1;
   }
 
@@ -109,24 +146,25 @@ message Authority {
 
 // Details of an attestation occurrence.
 message Details {
-  // Attestation for the resource.
+  // Required. Attestation for the resource.
   Attestation attestation = 1;
 }
 
 // Occurrence that represents a single "attestation". The authenticity of an
-// Attestation can be verified using the attached signature. If the verifier
+// attestation can be verified using the attached signature. If the verifier
 // trusts the public key of the signer, then verifying the signature is
-// sufficient to establish trust. In this circumstance, the Authority to which
-// this Attestation is attached is primarily useful for look-up (how to find
-// this Attestation if you already know the Authority and artifact to be
+// sufficient to establish trust. In this circumstance, the authority to which
+// this attestation is attached is primarily useful for look-up (how to find
+// this attestation if you already know the authority and artifact to be
 // verified) and intent (which authority was this attestation intended to sign
 // for).
 message Attestation {
-  // The signature, generally over the `resource_url`, that verifies this
-  // attestation. The semantics of the signature veracity are ultimately
+  // Required. The signature, generally over the `resource_url`, that verifies
+  // this attestation. The semantics of the signature veracity are ultimately
   // determined by the verification engine.
   oneof signature {
     // A PGP signed attestation.
     PgpSignedAttestation pgp_signed_attestation = 1;
+    GenericSignedAttestation generic_signed_attestation = 2;
   }
 }
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/build/BUILD.bazel b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/build/BUILD.bazel
index fda8cda8b..7d478fa5d 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/build/BUILD.bazel
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/build/BUILD.bazel
@@ -1,3 +1,5 @@
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
@@ -27,7 +29,6 @@ proto_library_with_info(
 load(
     "@com_google_googleapis_imports//:imports.bzl",
     "java_grpc_library",
-    "java_resource_name_proto_library",
 )
 
 java_proto_library(
@@ -41,12 +42,6 @@ java_grpc_library(
     deps = [":build_java_proto"],
 )
 
-java_resource_name_proto_library(
-    name = "build_resource_name_java_proto",
-    gapic_yaml = "//google/devtools/containeranalysis/v1beta1:containeranalysis_gapic.yaml",
-    deps = [":build_proto"],
-)
-
 ##############################################################################
 # Go
 ##############################################################################
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/build/build.proto b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/build/build.proto
index 32b357f00..0a5a2950b 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/build/build.proto
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/build/build.proto
@@ -24,13 +24,13 @@ option java_package = "io.grafeas.v1beta1.build";
 option objc_class_prefix = "GRA";
 
 // Note holding the version of the provider's builder and the signature of the
-// provenance message in linked BuildDetails.
+// provenance message in the build details occurrence.
 message Build {
-  // Version of the builder which produced this Note.
+  // Required. Immutable. Version of the builder which produced this build.
   string builder_version = 1;
 
-  // Signature of the build in Occurrences pointing to the Note containing this
-  // `BuilderDetails`.
+  // Signature of the build in occurrences pointing to this build note
+  // containing build details.
   BuildSignature signature = 2;
 }
 
@@ -42,8 +42,8 @@ message BuildSignature {
   //
   // This field may be empty if `key_id` references an external key.
   //
-  // For Cloud Container Builder based signatures, this is a PEM encoded public
-  // key. To verify the Cloud Container Builder signature, place the contents of
+  // For Cloud Build based signatures, this is a PEM encoded public
+  // key. To verify the Cloud Build signature, place the contents of
   // this field into a file (public.pem). The signature field is base64-decoded
   // into its binary representation in signature.bin, and the provenance bytes
   // from `BuildDetails` are base64-decoded into a binary representation in
@@ -51,17 +51,17 @@ message BuildSignature {
   // `openssl sha256 -verify public.pem -signature signature.bin signed.bin`
   string public_key = 1;
 
-  // Signature of the related `BuildProvenance`. In JSON, this is base-64
-  // encoded.
+  // Required. Signature of the related `BuildProvenance`. In JSON, this is
+  // base-64 encoded.
   bytes signature = 2;
 
-  // An ID for the key used to sign. This could be either an Id for the key
-  // stored in `public_key` (such as the Id or fingerprint for a PGP key, or the
+  // An ID for the key used to sign. This could be either an ID for the key
+  // stored in `public_key` (such as the ID or fingerprint for a PGP key, or the
   // CN for a cert), or a reference to an external key (such as a reference to a
   // key in Cloud Key Management Service).
   string key_id = 3;
 
-  // Public key formats
+  // Public key formats.
   enum KeyType {
     // `KeyType` is not set.
     KEY_TYPE_UNSPECIFIED = 0;
@@ -72,17 +72,17 @@ message BuildSignature {
   }
 
   // The type of the key, either stored in `public_key` or referenced in
-  // `key_id`
+  // `key_id`.
   KeyType key_type = 4;
 }
 
 // Details of a build occurrence.
 message Details {
-  // The actual provenance for the build.
+  // Required. The actual provenance for the build.
   grafeas.v1beta1.provenance.BuildProvenance provenance = 1;
 
   // Serialized JSON representation of the provenance, used in generating the
-  // `BuildSignature` in the corresponding Result. After verifying the
+  // build signature in the corresponding build note. After verifying the
   // signature, `provenance_bytes` can be unmarshalled and compared to the
   // provenance to confirm that it is unchanged. A base64-encoded string
   // representation of the provenance bytes is used for the signature in order
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/common/BUILD.bazel b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/common/BUILD.bazel
index 55758bb99..8654a536d 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/common/BUILD.bazel
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/common/BUILD.bazel
@@ -1,3 +1,5 @@
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
@@ -26,7 +28,6 @@ load(
     "@com_google_googleapis_imports//:imports.bzl",
     "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
 )
 
 java_proto_library(
@@ -40,12 +41,6 @@ java_grpc_library(
     deps = [":common_java_proto"],
 )
 
-java_resource_name_proto_library(
-    name = "common_resource_name_java_proto",
-    gapic_yaml = "//google/devtools/containeranalysis/v1beta1:containeranalysis_gapic.yaml",
-    deps = [":common_proto"],
-)
-
 ##############################################################################
 # Go
 ##############################################################################
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/common/common.proto b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/common/common.proto
index a8a2ddad2..bb97a3175 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/common/common.proto
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/common/common.proto
@@ -48,3 +48,54 @@ message RelatedUrl {
   // Label to describe usage of the URL.
   string label = 2;
 }
+
+// Verifiers (e.g. Kritis implementations) MUST verify signatures
+// with respect to the trust anchors defined in policy (e.g. a Kritis policy).
+// Typically this means that the verifier has been configured with a map from
+// `public_key_id` to public key material (and any required parameters, e.g.
+// signing algorithm).
+//
+// In particular, verification implementations MUST NOT treat the signature
+// `public_key_id` as anything more than a key lookup hint. The `public_key_id`
+// DOES NOT validate or authenticate a public key; it only provides a mechanism
+// for quickly selecting a public key ALREADY CONFIGURED on the verifier through
+// a trusted channel. Verification implementations MUST reject signatures in any
+// of the following circumstances:
+//   * The `public_key_id` is not recognized by the verifier.
+//   * The public key that `public_key_id` refers to does not verify the
+//     signature with respect to the payload.
+//
+// The `signature` contents SHOULD NOT be "attached" (where the payload is
+// included with the serialized `signature` bytes). Verifiers MUST ignore any
+// "attached" payload and only verify signatures with respect to explicitly
+// provided payload (e.g. a `payload` field on the proto message that holds
+// this Signature, or the canonical serialization of the proto message that
+// holds this signature).
+message Signature {
+  // The content of the signature, an opaque bytestring.
+  // The payload that this signature verifies MUST be unambiguously provided
+  // with the Signature during verification. A wrapper message might provide
+  // the payload explicitly. Alternatively, a message might have a canonical
+  // serialization that can always be unambiguously computed to derive the
+  // payload.
+  bytes signature = 1;
+
+  // The identifier for the public key that verifies this signature.
+  //   * The `public_key_id` is required.
+  //   * The `public_key_id` MUST be an RFC3986 conformant URI.
+  //   * When possible, the `public_key_id` SHOULD be an immutable reference,
+  //     such as a cryptographic digest.
+  //
+  // Examples of valid `public_key_id`s:
+  //
+  // OpenPGP V4 public key fingerprint:
+  //   * "openpgp4fpr:74FAF3B861BDA0870C7B6DEF607E48D2A663AEEA"
+  // See https://www.iana.org/assignments/uri-schemes/prov/openpgp4fpr for more
+  // details on this scheme.
+  //
+  // RFC6920 digest-named SubjectPublicKeyInfo (digest of the DER
+  // serialization):
+  //   * "ni:///sha-256;cD9o9Cq6LG3jD0iKXqEi_vdjJGecm_iXkbqVoScViaU"
+  //   * "nih:///sha-256;703f68f42aba2c6de30f488a5ea122fef76324679c9bf89791ba95a1271589a5"
+  string public_key_id = 2;
+}
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/containeranalysis.proto b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/containeranalysis.proto
index b15153384..59f3ecd94 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/containeranalysis.proto
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/containeranalysis.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,12 +11,16 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.devtools.containeranalysis.v1beta1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/iam/v1/iam_policy.proto";
 import "google/iam/v1/policy.proto";
 import "google/protobuf/timestamp.proto";
@@ -40,6 +44,9 @@ option objc_class_prefix = "GCA";
 // there would be one note for the vulnerability and an occurrence for each
 // image with the vulnerability referring to that note.
 service ContainerAnalysisV1Beta1 {
+  option (google.api.default_host) = "containeranalysis.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Sets the access control policy on the specified note or occurrence.
   // Requires `containeranalysis.notes.setIamPolicy` or
   // `containeranalysis.occurrences.setIamPolicy` permission if the resource is
@@ -48,8 +55,7 @@ service ContainerAnalysisV1Beta1 {
   // The resource takes the format `projects/[PROJECT_ID]/notes/[NOTE_ID]` for
   // notes and `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]` for
   // occurrences.
-  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest)
-      returns (google.iam.v1.Policy) {
+  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) returns (google.iam.v1.Policy) {
     option (google.api.http) = {
       post: "/v1beta1/{resource=projects/*/notes/*}:setIamPolicy"
       body: "*"
@@ -58,6 +64,7 @@ service ContainerAnalysisV1Beta1 {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "resource,policy";
   }
 
   // Gets the access control policy for a note or an occurrence resource.
@@ -68,8 +75,7 @@ service ContainerAnalysisV1Beta1 {
   // The resource takes the format `projects/[PROJECT_ID]/notes/[NOTE_ID]` for
   // notes and `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]` for
   // occurrences.
-  rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest)
-      returns (google.iam.v1.Policy) {
+  rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) returns (google.iam.v1.Policy) {
     option (google.api.http) = {
       post: "/v1beta1/{resource=projects/*/notes/*}:getIamPolicy"
       body: "*"
@@ -78,6 +84,7 @@ service ContainerAnalysisV1Beta1 {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "resource";
   }
 
   // Returns the permissions that a caller has on the specified note or
@@ -87,8 +94,7 @@ service ContainerAnalysisV1Beta1 {
   // The resource takes the format `projects/[PROJECT_ID]/notes/[NOTE_ID]` for
   // notes and `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]` for
   // occurrences.
-  rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest)
-      returns (google.iam.v1.TestIamPermissionsResponse) {
+  rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest) returns (google.iam.v1.TestIamPermissionsResponse) {
     option (google.api.http) = {
       post: "/v1beta1/{resource=projects/*/notes/*}:testIamPermissions"
       body: "*"
@@ -97,6 +103,7 @@ service ContainerAnalysisV1Beta1 {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "resource,permissions";
   }
 
   // Gets the specified scan configuration.
@@ -104,14 +111,15 @@ service ContainerAnalysisV1Beta1 {
     option (google.api.http) = {
       get: "/v1beta1/{name=projects/*/scanConfigs/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists scan configurations for the specified project.
-  rpc ListScanConfigs(ListScanConfigsRequest)
-      returns (ListScanConfigsResponse) {
+  rpc ListScanConfigs(ListScanConfigsRequest) returns (ListScanConfigsResponse) {
     option (google.api.http) = {
       get: "/v1beta1/{parent=projects/*}/scanConfigs"
     };
+    option (google.api.method_signature) = "parent,filter";
   }
 
   // Updates the specified scan configuration.
@@ -120,6 +128,7 @@ service ContainerAnalysisV1Beta1 {
       put: "/v1beta1/{name=projects/*/scanConfigs/*}"
       body: "scan_config"
     };
+    option (google.api.method_signature) = "name,scan_config";
   }
 }
 
@@ -127,6 +136,11 @@ service ContainerAnalysisV1Beta1 {
 // particular type of analysis being run. For example, it can configure whether
 // vulnerability scanning is being done on Docker images or not.
 message ScanConfig {
+  option (google.api.resource) = {
+    type: "containeranalysis.googleapis.com/ScanConfig"
+    pattern: "projects/{project}/scanConfigs/{scan_config}"
+  };
+
   // Output only. The name of the scan configuration in the form of
   // `projects/[PROJECT_ID]/scanConfigs/[SCAN_CONFIG_ID]`.
   string name = 1;
@@ -147,19 +161,29 @@ message ScanConfig {
 
 // Request to get a scan configuration.
 message GetScanConfigRequest {
-  // The name of the scan configuration in the form of
+  // Required. The name of the scan configuration in the form of
   // `projects/[PROJECT_ID]/scanConfigs/[SCAN_CONFIG_ID]`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "containeranalysis.googleapis.com/ScanConfig"
+    }
+  ];
 }
 
 // Request to list scan configurations.
 message ListScanConfigsRequest {
-  // The name of the project to list scan configurations for in the form of
+  // Required. The name of the project to list scan configurations for in the form of
   // `projects/[PROJECT_ID]`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
-  // The filter expression.
-  string filter = 2;
+  // Required. The filter expression.
+  string filter = 2 [(google.api.field_behavior) = REQUIRED];
 
   // The number of scan configs to return in the list.
   int32 page_size = 3;
@@ -181,10 +205,15 @@ message ListScanConfigsResponse {
 
 // A request to update a scan configuration.
 message UpdateScanConfigRequest {
-  // The name of the scan configuration in the form of
+  // Required. The name of the scan configuration in the form of
   // `projects/[PROJECT_ID]/scanConfigs/[SCAN_CONFIG_ID]`.
-  string name = 1;
-
-  // The updated scan configuration.
-  ScanConfig scan_config = 2;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "containeranalysis.googleapis.com/ScanConfig"
+    }
+  ];
+
+  // Required. The updated scan configuration.
+  ScanConfig scan_config = 2 [(google.api.field_behavior) = REQUIRED];
 }
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/containeranalysis_grpc_service_config.json b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/containeranalysis_grpc_service_config.json
new file mode 100755
index 000000000..fb50770fc
--- /dev/null
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/containeranalysis_grpc_service_config.json
@@ -0,0 +1,128 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.devtools.containeranalysis.v1beta1.ContainerAnalysisV1Beta1",
+          "method": "SetIamPolicy"
+        },
+        {
+          "service": "google.devtools.containeranalysis.v1beta1.ContainerAnalysisV1Beta1",
+          "method": "GetIamPolicy"
+        },
+        {
+          "service": "google.devtools.containeranalysis.v1beta1.ContainerAnalysisV1Beta1",
+          "method": "TestIamPermissions"
+        },
+        {
+          "service": "google.devtools.containeranalysis.v1beta1.ContainerAnalysisV1Beta1",
+          "method": "UpdateScanConfig"
+        }
+      ],
+      "timeout": "30s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.devtools.containeranalysis.v1beta1.ContainerAnalysisV1Beta1",
+          "method": "GetScanConfig"
+        },
+        {
+          "service": "google.devtools.containeranalysis.v1beta1.ContainerAnalysisV1Beta1",
+          "method": "ListScanConfigs"
+        }
+      ],
+      "timeout": "30s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "grafeas.v1beta1.GrafeasV1Beta1",
+          "method": "GetOccurrence"
+        },
+        {
+          "service": "grafeas.v1beta1.GrafeasV1Beta1",
+          "method": "ListOccurrences"
+        },
+        {
+          "service": "grafeas.v1beta1.GrafeasV1Beta1",
+          "method": "DeleteOccurrence"
+        },
+        {
+          "service": "grafeas.v1beta1.GrafeasV1Beta1",
+          "method": "GetOccurrenceNote"
+        },
+        {
+          "service": "grafeas.v1beta1.GrafeasV1Beta1",
+          "method": "GetNote"
+        },
+        {
+          "service": "grafeas.v1beta1.GrafeasV1Beta1",
+          "method": "ListNotes"
+        },
+        {
+          "service": "grafeas.v1beta1.GrafeasV1Beta1",
+          "method": "DeleteNote"
+        },
+        {
+          "service": "grafeas.v1beta1.GrafeasV1Beta1",
+          "method": "ListNoteOccurrences"
+        },
+        {
+          "service": "grafeas.v1beta1.GrafeasV1Beta1",
+          "method": "GetVulnerabilityOccurrencesSummary"
+        }
+      ],
+      "timeout": "30s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "grafeas.v1beta1.GrafeasV1Beta1",
+          "method": "CreateOccurrence"
+        },
+        {
+          "service": "grafeas.v1beta1.GrafeasV1Beta1",
+          "method": "BatchCreateOccurrences"
+        },
+        {
+          "service": "grafeas.v1beta1.GrafeasV1Beta1",
+          "method": "UpdateOccurrence"
+        },
+        {
+          "service": "grafeas.v1beta1.GrafeasV1Beta1",
+          "method": "CreateNote"
+        },
+        {
+          "service": "grafeas.v1beta1.GrafeasV1Beta1",
+          "method": "BatchCreateNotes"
+        },
+        {
+          "service": "grafeas.v1beta1.GrafeasV1Beta1",
+          "method": "UpdateNote"
+        }
+      ],
+      "timeout": "30s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/containeranalysis_v1beta1.yaml b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/containeranalysis_v1beta1.yaml
new file mode 100644
index 000000000..d07177f86
--- /dev/null
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/containeranalysis_v1beta1.yaml
@@ -0,0 +1,33 @@
+type: google.api.Service
+config_version: 3
+name: containeranalysis.googleapis.com
+title: Container Analysis API
+
+apis:
+- name: google.devtools.containeranalysis.v1beta1.ContainerAnalysisV1Beta1
+
+documentation:
+  summary: |-
+    An implementation of the Grafeas API, which stores, and enables querying
+    and retrieval of critical metadata about all of your software artifacts.
+  overview: |-
+    The Container Analysis API allows you to store and retrieve metadata for a
+    container resource.
+
+backend:
+  rules:
+  - selector: 'google.devtools.containeranalysis.v1beta1.ContainerAnalysisV1Beta1.*'
+    deadline: 30.0
+  - selector: 'google.longrunning.Operations.*'
+    deadline: 30.0
+
+authentication:
+  rules:
+  - selector: 'google.devtools.containeranalysis.v1beta1.ContainerAnalysisV1Beta1.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/cvss/BUILD.bazel b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/cvss/BUILD.bazel
new file mode 100644
index 000000000..4422f237e
--- /dev/null
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/cvss/BUILD.bazel
@@ -0,0 +1,55 @@
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "cvss_proto",
+    srcs = [
+        "cvss.proto",
+    ],
+    deps = [],
+)
+
+proto_library_with_info(
+    name = "cvss_proto_with_info",
+    deps = [":cvss_proto"],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "cvss_java_proto",
+    deps = [":cvss_proto"],
+)
+
+java_grpc_library(
+    name = "cvss_java_grpc",
+    srcs = [":cvss_proto"],
+    deps = [":cvss_java_proto"],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load("@com_google_googleapis_imports//:imports.bzl", "go_proto_library")
+
+go_proto_library(
+    name = "cvss_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/devtools/containeranalysis/v1beta1/cvss",
+    protos = [":cvss_proto"],
+    deps = [],
+)
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/cvss/cvss.proto b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/cvss/cvss.proto
new file mode 100644
index 000000000..348444161
--- /dev/null
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/cvss/cvss.proto
@@ -0,0 +1,85 @@
+// Copyright 2018 The Grafeas Authors. All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package grafeas.v1beta1.vulnerability;
+
+option go_package = "google.golang.org/genproto/googleapis/devtools/containeranalysis/v1beta1/cvss;cvss";
+option java_multiple_files = true;
+option java_package = "io.grafeas.v1beta1.vulnerability";
+option objc_class_prefix = "GRA";
+
+// Common Vulnerability Scoring System version 3.
+// For details, see https://www.first.org/cvss/specification-document
+message CVSSv3 {
+  // The base score is a function of the base metric scores.
+  float base_score = 1;
+
+  float exploitability_score = 2;
+
+  float impact_score = 3;
+
+  // Base Metrics
+  // Represents the intrinsic characteristics of a vulnerability that are
+  // constant over time and across user environments.
+  AttackVector attack_vector = 5;
+  AttackComplexity attack_complexity = 6;
+  PrivilegesRequired privileges_required = 7;
+  UserInteraction user_interaction = 8;
+  Scope scope = 9;
+  Impact confidentiality_impact = 10;
+  Impact integrity_impact = 11;
+  Impact availability_impact = 12;
+
+  enum AttackVector {
+    ATTACK_VECTOR_UNSPECIFIED = 0;
+    ATTACK_VECTOR_NETWORK = 1;
+    ATTACK_VECTOR_ADJACENT = 2;
+    ATTACK_VECTOR_LOCAL = 3;
+    ATTACK_VECTOR_PHYSICAL = 4;
+  }
+
+  enum AttackComplexity {
+    ATTACK_COMPLEXITY_UNSPECIFIED = 0;
+    ATTACK_COMPLEXITY_LOW = 1;
+    ATTACK_COMPLEXITY_HIGH = 2;
+  }
+
+  enum PrivilegesRequired {
+    PRIVILEGES_REQUIRED_UNSPECIFIED = 0;
+    PRIVILEGES_REQUIRED_NONE = 1;
+    PRIVILEGES_REQUIRED_LOW = 2;
+    PRIVILEGES_REQUIRED_HIGH = 3;
+  }
+
+  enum UserInteraction {
+    USER_INTERACTION_UNSPECIFIED = 0;
+    USER_INTERACTION_NONE = 1;
+    USER_INTERACTION_REQUIRED = 2;
+  }
+
+  enum Scope {
+    SCOPE_UNSPECIFIED = 0;
+    SCOPE_UNCHANGED = 1;
+    SCOPE_CHANGED = 2;
+  }
+
+  enum Impact {
+    IMPACT_UNSPECIFIED = 0;
+    IMPACT_HIGH = 1;
+    IMPACT_LOW = 2;
+    IMPACT_NONE = 3;
+  }
+}
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/deployment/BUILD.bazel b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/deployment/BUILD.bazel
index 670c8c763..921d48921 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/deployment/BUILD.bazel
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/deployment/BUILD.bazel
@@ -1,3 +1,5 @@
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
@@ -27,7 +29,6 @@ proto_library_with_info(
 load(
     "@com_google_googleapis_imports//:imports.bzl",
     "java_grpc_library",
-    "java_resource_name_proto_library",
 )
 
 java_proto_library(
@@ -41,12 +42,6 @@ java_grpc_library(
     deps = [":deployment_java_proto"],
 )
 
-java_resource_name_proto_library(
-    name = "deployment_resource_name_java_proto",
-    gapic_yaml = "//google/devtools/containeranalysis/v1beta1:containeranalysis_gapic.yaml",
-    deps = [":deployment_proto"],
-)
-
 ##############################################################################
 # Go
 ##############################################################################
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/deployment/deployment.proto b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/deployment/deployment.proto
index 96a81aeb3..7bc8dc897 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/deployment/deployment.proto
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/deployment/deployment.proto
@@ -25,13 +25,13 @@ option objc_class_prefix = "GRA";
 
 // An artifact that can be deployed in some runtime.
 message Deployable {
-  // Resource URI for the artifact being deployed.
+  // Required. Resource URI for the artifact being deployed.
   repeated string resource_uri = 1;
 }
 
 // Details of a deployment occurrence.
 message Details {
-  // Deployment history for the resource.
+  // Required. Deployment history for the resource.
   Deployment deployment = 1;
 }
 
@@ -40,7 +40,7 @@ message Deployment {
   // Identity of the user that triggered this deployment.
   string user_email = 1;
 
-  // Beginning of the lifetime of this deployment.
+  // Required. Beginning of the lifetime of this deployment.
   google.protobuf.Timestamp deploy_time = 2;
 
   // End of the lifetime of this deployment.
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/discovery/BUILD.bazel b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/discovery/BUILD.bazel
index dfe0bae7c..58a4b6cb5 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/discovery/BUILD.bazel
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/discovery/BUILD.bazel
@@ -1,3 +1,5 @@
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
@@ -29,7 +31,6 @@ proto_library_with_info(
 load(
     "@com_google_googleapis_imports//:imports.bzl",
     "java_grpc_library",
-    "java_resource_name_proto_library",
 )
 
 java_proto_library(
@@ -43,12 +44,6 @@ java_grpc_library(
     deps = [":discovery_java_proto"],
 )
 
-java_resource_name_proto_library(
-    name = "discovery_resource_name_java_proto",
-    gapic_yaml = "//google/devtools/containeranalysis/v1beta1:containeranalysis_gapic.yaml",
-    deps = [":discovery_proto"],
-)
-
 ##############################################################################
 # Go
 ##############################################################################
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/discovery/discovery.proto b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/discovery/discovery.proto
index 4ed5aeba6..edfa043bc 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/discovery/discovery.proto
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/discovery/discovery.proto
@@ -29,13 +29,14 @@ option objc_class_prefix = "GRA";
 // exists in a provider's project. A `Discovery` occurrence is created in a
 // consumer's project at the start of analysis.
 message Discovery {
-  // The kind of analysis that is handled by this discovery.
+  // Required. Immutable. The kind of analysis that is handled by this
+  // discovery.
   grafeas.v1beta1.NoteKind analysis_kind = 1;
 }
 
 // Details of a discovery occurrence.
 message Details {
-  // Analysis status for the discovered resource.
+  // Required. Analysis status for the discovered resource.
   Discovered discovered = 1;
 }
 
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/grafeas/BUILD.bazel b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/grafeas/BUILD.bazel
index 41e0d234f..dccc9ec49 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/grafeas/BUILD.bazel
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/grafeas/BUILD.bazel
@@ -1,3 +1,5 @@
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
@@ -13,6 +15,7 @@ proto_library(
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
         "//google/devtools/containeranalysis/v1beta1/attestation:attestation_proto",
         "//google/devtools/containeranalysis/v1beta1/build:build_proto",
         "//google/devtools/containeranalysis/v1beta1/common:common_proto",
@@ -41,7 +44,6 @@ load(
     "@com_google_googleapis_imports//:imports.bzl",
     "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
 )
 
 java_proto_library(
@@ -55,12 +57,6 @@ java_grpc_library(
     deps = [":grafeas_java_proto"],
 )
 
-java_resource_name_proto_library(
-    name = "grafeas_resource_name_java_proto",
-    gapic_yaml = "//google/devtools/containeranalysis/v1beta1:containeranalysis_gapic.yaml",
-    deps = [":grafeas_proto"],
-)
-
 ##############################################################################
 # Go
 ##############################################################################
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/grafeas/grafeas.proto b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/grafeas/grafeas.proto
index 9c2ac8b0b..8952164eb 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/grafeas/grafeas.proto
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/grafeas/grafeas.proto
@@ -17,6 +17,7 @@ syntax = "proto3";
 package grafeas.v1beta1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
 import "google/devtools/containeranalysis/v1beta1/attestation/attestation.proto";
 import "google/devtools/containeranalysis/v1beta1/build/build.proto";
 import "google/devtools/containeranalysis/v1beta1/common/common.proto";
@@ -50,6 +51,9 @@ option objc_class_prefix = "GRA";
 // there would be one note for the vulnerability and an occurrence for each
 // image with the vulnerability referring to that note.
 service GrafeasV1Beta1 {
+  option (google.api.default_host) = "containeranalysis.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Gets the specified occurrence.
   rpc GetOccurrence(GetOccurrenceRequest) returns (Occurrence) {
     option (google.api.http) = {
@@ -184,8 +188,8 @@ message Occurrence {
   Resource resource = 2;
 
   // Required. Immutable. The analysis note associated with this occurrence, in
-  // the form of `projects[PROVIDER_ID]/notes/[NOTE_ID]`. This field can be used
-  // as a filter in list requests.
+  // the form of `projects/[PROVIDER_ID]/notes/[NOTE_ID]`. This field can be
+  // used as a filter in list requests.
   string note_name = 3;
 
   // Output only. This explicitly denotes which of the occurrence details are
@@ -229,7 +233,7 @@ message Resource {
   // The name of the resource. For example, the name of a Docker image -
   // "Debian".
   string name = 1;
-  // The unique URI of the resource. For example,
+  // Required. The unique URI of the resource. For example,
   // `https://gcr.io/project/image@sha256:foo` for a Docker image.
   string uri = 2;
   // The hash of the resource content. For example, the Docker digest.
@@ -487,7 +491,7 @@ message VulnerabilityOccurrencesSummary {
   // A listing by resource of the number of fixable and total vulnerabilities.
   repeated FixableTotalByDigest counts = 1;
 
-  // Per resource and severity counts of fixable and total vulnerabilites.
+  // Per resource and severity counts of fixable and total vulnerabilities.
   message FixableTotalByDigest {
     // The affected resource.
     Resource resource = 1;
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/image/BUILD.bazel b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/image/BUILD.bazel
index 99737d9dd..7fbc648f8 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/image/BUILD.bazel
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/image/BUILD.bazel
@@ -1,3 +1,5 @@
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
@@ -25,7 +27,6 @@ proto_library_with_info(
 load(
     "@com_google_googleapis_imports//:imports.bzl",
     "java_grpc_library",
-    "java_resource_name_proto_library",
 )
 
 java_proto_library(
@@ -39,12 +40,6 @@ java_grpc_library(
     deps = [":image_java_proto"],
 )
 
-java_resource_name_proto_library(
-    name = "image_resource_name_java_proto",
-    gapic_yaml = "//google/devtools/containeranalysis/v1beta1:containeranalysis_gapic.yaml",
-    deps = [":image_proto"],
-)
-
 ##############################################################################
 # Go
 ##############################################################################
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/image/image.proto b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/image/image.proto
index 01f5305a5..91ee33e05 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/image/image.proto
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/image/image.proto
@@ -28,59 +28,59 @@ message Layer {
     // Default value for unsupported/missing directive.
     DIRECTIVE_UNSPECIFIED = 0;
 
-    // https://docs.docker.com/reference/builder/#maintainer
+    // https://docs.docker.com/engine/reference/builder/
     MAINTAINER = 1;
 
-    // https://docs.docker.com/reference/builder/#run
+    // https://docs.docker.com/engine/reference/builder/
     RUN = 2;
 
-    // https://docs.docker.com/reference/builder/#cmd
+    // https://docs.docker.com/engine/reference/builder/
     CMD = 3;
 
-    // https://docs.docker.com/reference/builder/#label
+    // https://docs.docker.com/engine/reference/builder/
     LABEL = 4;
 
-    // https://docs.docker.com/reference/builder/#expose
+    // https://docs.docker.com/engine/reference/builder/
     EXPOSE = 5;
 
-    // https://docs.docker.com/reference/builder/#env
+    // https://docs.docker.com/engine/reference/builder/
     ENV = 6;
 
-    // https://docs.docker.com/reference/builder/#add
+    // https://docs.docker.com/engine/reference/builder/
     ADD = 7;
 
-    // https://docs.docker.com/reference/builder/#copy
+    // https://docs.docker.com/engine/reference/builder/
     COPY = 8;
 
-    // https://docs.docker.com/reference/builder/#entrypoint
+    // https://docs.docker.com/engine/reference/builder/
     ENTRYPOINT = 9;
 
-    // https://docs.docker.com/reference/builder/#volume
+    // https://docs.docker.com/engine/reference/builder/
     VOLUME = 10;
 
-    // https://docs.docker.com/reference/builder/#user
+    // https://docs.docker.com/engine/reference/builder/
     USER = 11;
 
-    // https://docs.docker.com/reference/builder/#workdir
+    // https://docs.docker.com/engine/reference/builder/
     WORKDIR = 12;
 
-    // https://docs.docker.com/reference/builder/#arg
+    // https://docs.docker.com/engine/reference/builder/
     ARG = 13;
 
-    // https://docs.docker.com/reference/builder/#onbuild
+    // https://docs.docker.com/engine/reference/builder/
     ONBUILD = 14;
 
-    // https://docs.docker.com/reference/builder/#stopsignal
+    // https://docs.docker.com/engine/reference/builder/
     STOPSIGNAL = 15;
 
-    // https://docs.docker.com/reference/builder/#healthcheck
+    // https://docs.docker.com/engine/reference/builder/
     HEALTHCHECK = 16;
 
-    // https://docs.docker.com/reference/builder/#shell
+    // https://docs.docker.com/engine/reference/builder/
     SHELL = 17;
   }
 
-  // The recovered Dockerfile directive used to construct this layer.
+  // Required. The recovered Dockerfile directive used to construct this layer.
   Directive directive = 1;
 
   // The recovered arguments to the Dockerfile directive.
@@ -89,10 +89,11 @@ message Layer {
 
 // A set of properties that uniquely identify a given Docker image.
 message Fingerprint {
-  // The layer-id of the final layer in the Docker image's v1 representation.
+  // Required. The layer ID of the final layer in the Docker image's v1
+  // representation.
   string v1_name = 1;
 
-  // The ordered list of v2 blobs that represent a given image.
+  // Required. The ordered list of v2 blobs that represent a given image.
   repeated string v2_blob = 2;
 
   // Output only. The name of the image's v2 blobs computed via:
@@ -108,17 +109,17 @@ message Fingerprint {
 //   FROM 
 // Or an equivalent reference, e.g. a tag of the resource_url.
 message Basis {
-  // The resource_url for the resource representing the basis of
-  // associated occurrence images.
+  // Required. Immutable. The resource_url for the resource representing the
+  // basis of associated occurrence images.
   string resource_url = 1;
 
-  // The fingerprint of the base image.
+  // Required. Immutable. The fingerprint of the base image.
   Fingerprint fingerprint = 2;
 }
 
 // Details of an image occurrence.
 message Details {
-  // The child image derived from the base image.
+  // Required. Immutable. The child image derived from the base image.
   Derived derived_image = 1;
 }
 
@@ -126,7 +127,7 @@ message Details {
 // relationship. This image would be produced from a Dockerfile with FROM
 // .
 message Derived {
-  // The fingerprint of the derived image.
+  // Required. The fingerprint of the derived image.
   Fingerprint fingerprint = 1;
 
   // Output only. The number of layers by which this image differs from the
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/package/BUILD.bazel b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/package/BUILD.bazel
index e3e3e0013..93d7e02f9 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/package/BUILD.bazel
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/package/BUILD.bazel
@@ -1,3 +1,5 @@
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
@@ -26,7 +28,6 @@ load(
     "@com_google_googleapis_imports//:imports.bzl",
     "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
 )
 
 java_proto_library(
@@ -40,12 +41,6 @@ java_grpc_library(
     deps = [":package_java_proto"],
 )
 
-java_resource_name_proto_library(
-    name = "package_resource_name_java_proto",
-    gapic_yaml = "//google/devtools/containeranalysis/v1beta1:containeranalysis_gapic.yaml",
-    deps = [":package_proto"],
-)
-
 ##############################################################################
 # Go
 ##############################################################################
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/package/package.proto b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/package/package.proto
index 07031d500..88f288d4f 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/package/package.proto
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/package/package.proto
@@ -34,7 +34,7 @@ enum Architecture {
 // This represents a particular channel of distribution for a given package.
 // E.g., Debian's jessie-backports dpkg mirror.
 message Distribution {
-  // The cpe_uri in [cpe format](https://cpe.mitre.org/specification/)
+  // Required. The cpe_uri in [CPE format](https://cpe.mitre.org/specification/)
   // denoting the package manager version distributing a package.
   string cpe_uri = 1;
 
@@ -42,8 +42,7 @@ message Distribution {
   // built.
   Architecture architecture = 2;
 
-  // The latest available version of this package in this distribution
-  // channel.
+  // The latest available version of this package in this distribution channel.
   Version latest_version = 3;
 
   // A freeform string denoting the maintainer of this package.
@@ -57,9 +56,9 @@ message Distribution {
 }
 
 // An occurrence of a particular package installation found within a system's
-// filesystem. E.g., glibc was found in /var/lib/dpkg/status.
+// filesystem. E.g., glibc was found in `/var/lib/dpkg/status`.
 message Location {
-  // The cpe_uri in [cpe format](https://cpe.mitre.org/specification/)
+  // Required. The CPE URI in [CPE format](https://cpe.mitre.org/specification/)
   // denoting the package manager version distributing a package.
   string cpe_uri = 1;
 
@@ -74,7 +73,7 @@ message Location {
 // channels. E.g., glibc (aka libc6) is distributed by many, at various
 // versions.
 message Package {
-  // The name of the package.
+  // Required. Immutable. The name of the package.
   string name = 1;
 
   // The various channels by which a package is distributed.
@@ -83,7 +82,7 @@ message Package {
 
 // Details of a package occurrence.
 message Details {
-  // Where the package was installed.
+  // Required. Where the package was installed.
   Installation installation = 1;
 }
 
@@ -93,7 +92,7 @@ message Installation {
   // Output only. The name of the installed package.
   string name = 1;
 
-  // All of the places within the filesystem versions of this package
+  // Required. All of the places within the filesystem versions of this package
   // have been found.
   repeated Location location = 2;
 }
@@ -102,8 +101,11 @@ message Installation {
 message Version {
   // Used to correct mistakes in the version numbering scheme.
   int32 epoch = 1;
-  // The main part of the version name.
+
+  // Required only when version kind is NORMAL. The main part of the version
+  // name.
   string name = 2;
+
   // The iteration of the package build from the above version.
   string revision = 3;
 
@@ -111,17 +113,15 @@ message Version {
   enum VersionKind {
     // Unknown.
     VERSION_KIND_UNSPECIFIED = 0;
-    // A standard package version, defined by the other fields.
+    // A standard package version.
     NORMAL = 1;
-    // A special version representing negative infinity, other fields are
-    // ignored.
+    // A special version representing negative infinity.
     MINIMUM = 2;
-    // A special version representing positive infinity, other fields are
-    // ignored.
+    // A special version representing positive infinity.
     MAXIMUM = 3;
   };
 
-  // Distinguish between sentinel MIN/MAX versions and normal versions. If
-  // kind is not NORMAL, then the other fields are ignored.
+  // Required. Distinguishes between sentinel MIN/MAX versions and normal
+  // versions.
   VersionKind kind = 4;
 }
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/provenance/BUILD.bazel b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/provenance/BUILD.bazel
index a4fbdff49..acb9f6946 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/provenance/BUILD.bazel
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/provenance/BUILD.bazel
@@ -1,3 +1,5 @@
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
@@ -29,7 +31,6 @@ load(
     "@com_google_googleapis_imports//:imports.bzl",
     "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
 )
 
 java_proto_library(
@@ -43,12 +44,6 @@ java_grpc_library(
     deps = [":provenance_java_proto"],
 )
 
-java_resource_name_proto_library(
-    name = "provenance_resource_name_java_proto",
-    gapic_yaml = "//google/devtools/containeranalysis/v1beta1:containeranalysis_gapic.yaml",
-    deps = [":provenance_proto"],
-)
-
 ##############################################################################
 # Go
 ##############################################################################
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/provenance/provenance.proto b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/provenance/provenance.proto
index 3d3342845..761877cdb 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/provenance/provenance.proto
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/provenance/provenance.proto
@@ -27,7 +27,7 @@ option objc_class_prefix = "GRA";
 // Provenance of a build. Contains all information needed to verify the full
 // details about the build from source to completion.
 message BuildProvenance {
-  // Unique identifier of the build.
+  // Required. Unique identifier of the build.
   string id = 1;
 
   // ID of the project.
@@ -98,16 +98,16 @@ message Source {
   repeated grafeas.v1beta1.source.SourceContext additional_contexts = 4;
 }
 
-// Container message for hashes of byte content of files, used in Source
+// Container message for hashes of byte content of files, used in source
 // messages to verify integrity of source input to the build.
 message FileHashes {
-  // Collection of file hashes.
+  // Required. Collection of file hashes.
   repeated Hash file_hash = 1;
 }
 
 // Container message for hash values.
 message Hash {
-  // Specifies the hash algorithm, if any.
+  // Specifies the hash algorithm.
   enum HashType {
     // Unknown.
     HASH_TYPE_UNSPECIFIED = 0;
@@ -115,16 +115,16 @@ message Hash {
     SHA256 = 1;
   }
 
-  // The type of hash that was performed.
+  // Required. The type of hash that was performed.
   HashType type = 1;
-  // The hash value.
+  // Required. The hash value.
   bytes value = 2;
 }
 
 // Command describes a step performed as part of the build pipeline.
 message Command {
-  // Name of the command, as presented on the command line, or if the command is
-  // packaged as a Docker container, as presented to `docker pull`.
+  // Required. Name of the command, as presented on the command line, or if the
+  // command is packaged as a Docker container, as presented to `docker pull`.
   string name = 1;
 
   // Environment variables set before running this command.
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/source/BUILD.bazel b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/source/BUILD.bazel
index 3e0b9c554..4369b3ce9 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/source/BUILD.bazel
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/source/BUILD.bazel
@@ -1,3 +1,5 @@
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
@@ -26,7 +28,6 @@ load(
     "@com_google_googleapis_imports//:imports.bzl",
     "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
 )
 
 java_proto_library(
@@ -40,12 +41,6 @@ java_grpc_library(
     deps = [":source_java_proto"],
 )
 
-java_resource_name_proto_library(
-    name = "source_resource_name_java_proto",
-    gapic_yaml = "//google/devtools/containeranalysis/v1beta1:containeranalysis_gapic.yaml",
-    deps = [":source_proto"],
-)
-
 ##############################################################################
 # Go
 ##############################################################################
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/vulnerability/BUILD.bazel b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/vulnerability/BUILD.bazel
index dcb12c536..a72146480 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/vulnerability/BUILD.bazel
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/vulnerability/BUILD.bazel
@@ -1,3 +1,5 @@
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
@@ -13,7 +15,9 @@ proto_library(
     ],
     deps = [
         "//google/devtools/containeranalysis/v1beta1/common:common_proto",
+        "//google/devtools/containeranalysis/v1beta1/cvss:cvss_proto",
         "//google/devtools/containeranalysis/v1beta1/package:package_proto",
+        "@com_google_protobuf//:timestamp_proto",
     ],
 )
 
@@ -29,7 +33,6 @@ load(
     "@com_google_googleapis_imports//:imports.bzl",
     "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
 )
 
 java_proto_library(
@@ -43,12 +46,6 @@ java_grpc_library(
     deps = [":vulnerability_java_proto"],
 )
 
-java_resource_name_proto_library(
-    name = "vulnerability_resource_name_java_proto",
-    gapic_yaml = "//google/devtools/containeranalysis/v1beta1:containeranalysis_gapic.yaml",
-    deps = [":vulnerability_proto"],
-)
-
 ##############################################################################
 # Go
 ##############################################################################
@@ -61,6 +58,7 @@ go_proto_library(
     protos = [":vulnerability_proto"],
     deps = [
         "//google/devtools/containeranalysis/v1beta1/common:common_go_proto",
+        "//google/devtools/containeranalysis/v1beta1/cvss:cvss_go_proto",
         "//google/devtools/containeranalysis/v1beta1/package:package_go_proto",
     ],
 )
diff --git a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/vulnerability/vulnerability.proto b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/vulnerability/vulnerability.proto
index aef35c4e2..d83c7e4c5 100644
--- a/third_party/googleapis/google/devtools/containeranalysis/v1beta1/vulnerability/vulnerability.proto
+++ b/third_party/googleapis/google/devtools/containeranalysis/v1beta1/vulnerability/vulnerability.proto
@@ -16,7 +16,9 @@ syntax = "proto3";
 
 package grafeas.v1beta1.vulnerability;
 
+import "google/protobuf/timestamp.proto";
 import "google/devtools/containeranalysis/v1beta1/common/common.proto";
+import "google/devtools/containeranalysis/v1beta1/cvss/cvss.proto";
 import "google/devtools/containeranalysis/v1beta1/package/package.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/devtools/containeranalysis/v1beta1/vulnerability;vulnerability";
@@ -40,7 +42,7 @@ enum Severity {
   CRITICAL = 5;
 }
 
-// Vulnerability provides metadata about a security vulnerability.
+// Vulnerability provides metadata about a security vulnerability in a Note.
 message Vulnerability {
   // The CVSS score for this vulnerability.
   float cvss_score = 1;
@@ -53,16 +55,17 @@ message Vulnerability {
   // vulnerability has manifested in.
   repeated Detail details = 3;
 
-  // Identifies all occurrences of this vulnerability in the package for a
+  // Identifies all appearances of this vulnerability in the package for a
   // specific distro/location. For example: glibc in
   // cpe:/o:debian:debian_linux:8 for versions 2.1 - 2.2
   message Detail {
-    // The cpe_uri in [cpe format] (https://cpe.mitre.org/specification/) in
-    // which the vulnerability manifests.  Examples include distro or storage
-    // location for vulnerable jar.
+    // Required. The CPE URI in
+    // [cpe format](https://cpe.mitre.org/specification/) in which the
+    // vulnerability manifests. Examples include distro or storage location for
+    // vulnerable jar.
     string cpe_uri = 1;
 
-    // The name of the package where the vulnerability was found.
+    // Required. The name of the package where the vulnerability was found.
     string package = 2;
 
     // The min version of the package in which the vulnerability exists.
@@ -87,10 +90,59 @@ message Vulnerability {
     // Whether this detail is obsolete. Occurrences are expected not to point to
     // obsolete details.
     bool is_obsolete = 9;
+
+    // The time this information was last changed at the source. This is an
+    // upstream timestamp from the underlying information source - e.g. Ubuntu
+    // security tracker.
+    google.protobuf.Timestamp source_update_time = 10;
+  }
+
+  // The full description of the CVSSv3.
+  CVSSv3 cvss_v3 = 4;
+
+  // Windows details get their own format because the information format and
+  // model don't match a normal detail. Specifically Windows updates are done as
+  // patches, thus Windows vulnerabilities really are a missing package, rather
+  // than a package being at an incorrect version.
+  repeated WindowsDetail windows_details = 5;
+
+  message WindowsDetail {
+    // Required. The CPE URI in
+    // [cpe format](https://cpe.mitre.org/specification/) in which the
+    // vulnerability manifests. Examples include distro or storage location for
+    // vulnerable jar.
+    string cpe_uri = 1;
+
+    // Required. The name of the vulnerability.
+    string name = 2;
+
+    // The description of the vulnerability.
+    string description = 3;
+
+    // Required. The names of the KBs which have hotfixes to mitigate this
+    // vulnerability. Note that there may be multiple hotfixes (and thus
+    // multiple KBs) that mitigate a given vulnerability. Currently any listed
+    // kb's presence is considered a fix.
+    repeated KnowledgeBase fixing_kbs = 4;
+
+    message KnowledgeBase {
+      // The KB name (generally of the form KB[0-9]+ i.e. KB123456).
+      string name = 1;
+      // A link to the KB in the Windows update catalog -
+      // https://www.catalog.update.microsoft.com/
+      string url = 2;
+    }
   }
+
+  // The time this information was last changed at the source. This is an
+  // upstream timestamp from the underlying information source - e.g. Ubuntu
+  // security tracker.
+  google.protobuf.Timestamp source_update_time = 6;
+
+  // Next free ID is 7.
 }
 
-// Details of a vulnerability occurrence.
+// Details of a vulnerability Occurrence.
 message Details {
   // The type of package; whether native or non native(ruby gems, node.js
   // packages etc)
@@ -104,8 +156,8 @@ message Details {
   // severity.
   float cvss_score = 3;
 
-  // The set of affected locations and their fixes (if available) within the
-  // associated resource.
+  // Required. The set of affected locations and their fixes (if available)
+  // within the associated resource.
   repeated PackageIssue package_issue = 4;
 
   // Output only. A one sentence description of this vulnerability.
@@ -116,30 +168,36 @@ message Details {
 
   // Output only. URLs related to this vulnerability.
   repeated grafeas.v1beta1.RelatedUrl related_urls = 7;
+
+  // The distro assigned severity for this vulnerability when it is
+  // available, and note provider assigned severity when distro has not yet
+  // assigned a severity for this vulnerability.
+  Severity effective_severity = 8;
 }
 
 // This message wraps a location affected by a vulnerability and its
 // associated fix (if one is available).
 message PackageIssue {
-  // The location of the vulnerability.
+  // Required. The location of the vulnerability.
   VulnerabilityLocation affected_location = 1;
 
   // The location of the available fix for vulnerability.
   VulnerabilityLocation fixed_location = 2;
 
+  // Deprecated, use Details.effective_severity instead
   // The severity (e.g., distro assigned severity) for this vulnerability.
   string severity_name = 3;
 }
 
 // The location of the vulnerability.
 message VulnerabilityLocation {
-  // The cpe_uri in [cpe format] (https://cpe.mitre.org/specification/)
+  // Required. The CPE URI in [cpe format](https://cpe.mitre.org/specification/)
   // format. Examples include distro or storage location for vulnerable jar.
   string cpe_uri = 1;
 
-  // The package being described.
+  // Required. The package being described.
   string package = 2;
 
-  // The version of the package being described.
+  // Required. The version of the package being described.
   grafeas.v1beta1.package.Version version = 3;
 }
diff --git a/third_party/googleapis/google/devtools/remoteexecution/v1test/remote_execution.proto b/third_party/googleapis/google/devtools/remoteexecution/v1test/remote_execution.proto
deleted file mode 100644
index 578040fbd..000000000
--- a/third_party/googleapis/google/devtools/remoteexecution/v1test/remote_execution.proto
+++ /dev/null
@@ -1,1044 +0,0 @@
-// Copyright 2017 Google Inc.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-syntax = "proto3";
-
-package google.devtools.remoteexecution.v1test;
-
-import "google/api/annotations.proto";
-import "google/longrunning/operations.proto";
-import "google/protobuf/duration.proto";
-import "google/rpc/status.proto";
-
-option csharp_namespace = "Google.RemoteExecution.V1Test";
-option go_package = "google.golang.org/genproto/googleapis/devtools/remoteexecution/v1test;remoteexecution";
-option java_multiple_files = true;
-option java_outer_classname = "RemoteExecutionProto";
-option java_package = "com.google.devtools.remoteexecution.v1test";
-option objc_class_prefix = "REX";
-
-// The Remote Execution API is used to execute an
-// [Action][google.devtools.remoteexecution.v1test.Action] on the remote
-// workers.
-//
-// As with other services in the Remote Execution API, any call may return an
-// error with a [RetryInfo][google.rpc.RetryInfo] error detail providing
-// information about when the client should retry the request; clients SHOULD
-// respect the information provided.
-service Execution {
-  // Execute an action remotely.
-  //
-  // In order to execute an action, the client must first upload all of the
-  // inputs, as well as the
-  // [Command][google.devtools.remoteexecution.v1test.Command] to run, into the
-  // [ContentAddressableStorage][google.devtools.remoteexecution.v1test.ContentAddressableStorage].
-  // It then calls `Execute` with an
-  // [Action][google.devtools.remoteexecution.v1test.Action] referring to them.
-  // The server will run the action and eventually return the result.
-  //
-  // The input `Action`'s fields MUST meet the various canonicalization
-  // requirements specified in the documentation for their types so that it has
-  // the same digest as other logically equivalent `Action`s. The server MAY
-  // enforce the requirements and return errors if a non-canonical input is
-  // received. It MAY also proceed without verifying some or all of the
-  // requirements, such as for performance reasons. If the server does not
-  // verify the requirement, then it will treat the `Action` as distinct from
-  // another logically equivalent action if they hash differently.
-  //
-  // Returns a [google.longrunning.Operation][google.longrunning.Operation]
-  // describing the resulting execution, with eventual `response`
-  // [ExecuteResponse][google.devtools.remoteexecution.v1test.ExecuteResponse].
-  // The `metadata` on the operation is of type
-  // [ExecuteOperationMetadata][google.devtools.remoteexecution.v1test.ExecuteOperationMetadata].
-  //
-  // To query the operation, you can use the
-  // [Operations API][google.longrunning.Operations.GetOperation]. If you wish
-  // to allow the server to stream operations updates, rather than requiring
-  // client polling, you can use the
-  // [Watcher API][google.watcher.v1.Watcher.Watch] with the Operation's `name`
-  // as the `target`.
-  //
-  // When using the Watcher API, the initial `data` will be the `Operation` at
-  // the time of the request. Updates will be provided periodically by the
-  // server until the `Operation` completes, at which point the response message
-  // will (assuming no error) be at `data.response`.
-  //
-  // The server NEED NOT implement other methods or functionality of the
-  // Operation and Watcher APIs.
-  //
-  // Errors discovered during creation of the `Operation` will be reported
-  // as gRPC Status errors, while errors that occurred while running the
-  // action will be reported in the `status` field of the `ExecuteResponse`. The
-  // server MUST NOT set the `error` field of the `Operation` proto.
-  // The possible errors include:
-  // * `INVALID_ARGUMENT`: One or more arguments are invalid.
-  // * `FAILED_PRECONDITION`: One or more errors occurred in setting up the
-  //   action requested, such as a missing input or command or no worker being
-  //   available. The client may be able to fix the errors and retry.
-  // * `RESOURCE_EXHAUSTED`: There is insufficient quota of some resource to run
-  //   the action.
-  // * `UNAVAILABLE`: Due to a transient condition, such as all workers being
-  //   occupied (and the server does not support a queue), the action could not
-  //   be started. The client should retry.
-  // * `INTERNAL`: An internal error occurred in the execution engine or the
-  //   worker.
-  // * `DEADLINE_EXCEEDED`: The execution timed out.
-  //
-  // In the case of a missing input or command, the server SHOULD additionally
-  // send a [PreconditionFailure][google.rpc.PreconditionFailure] error detail
-  // where, for each requested blob not present in the CAS, there is a
-  // `Violation` with a `type` of `MISSING` and a `subject` of
-  // `"blobs/{hash}/{size}"` indicating the digest of the missing blob.
-  rpc Execute(ExecuteRequest) returns (google.longrunning.Operation) {
-    option (google.api.http) = {
-      post: "/v1test/{instance_name=**}/actions:execute"
-      body: "*"
-    };
-  }
-}
-
-// The action cache API is used to query whether a given action has already been
-// performed and, if so, retrieve its result. Unlike the
-// [ContentAddressableStorage][google.devtools.remoteexecution.v1test.ContentAddressableStorage],
-// which addresses blobs by their own content, the action cache addresses the
-// [ActionResult][google.devtools.remoteexecution.v1test.ActionResult] by a
-// digest of the encoded [Action][google.devtools.remoteexecution.v1test.Action]
-// which produced them.
-//
-// The lifetime of entries in the action cache is implementation-specific, but
-// the server SHOULD assume that more recently used entries are more likely to
-// be used again. Additionally, action cache implementations SHOULD ensure that
-// any blobs referenced in the
-// [ContentAddressableStorage][google.devtools.remoteexecution.v1test.ContentAddressableStorage]
-// are still valid when returning a result.
-//
-// As with other services in the Remote Execution API, any call may return an
-// error with a [RetryInfo][google.rpc.RetryInfo] error detail providing
-// information about when the client should retry the request; clients SHOULD
-// respect the information provided.
-service ActionCache {
-  // Retrieve a cached execution result.
-  //
-  // Errors:
-  // * `NOT_FOUND`: The requested `ActionResult` is not in the cache.
-  rpc GetActionResult(GetActionResultRequest) returns (ActionResult) {
-    option (google.api.http) = {
-      get: "/v1test/{instance_name=**}/actionResults/{action_digest.hash}/{action_digest.size_bytes}"
-    };
-  }
-
-  // Upload a new execution result.
-  //
-  // This method is intended for servers which implement the distributed cache
-  // independently of the
-  // [Execution][google.devtools.remoteexecution.v1test.Execution] API. As a
-  // result, it is OPTIONAL for servers to implement.
-  //
-  // Errors:
-  // * `NOT_IMPLEMENTED`: This method is not supported by the server.
-  // * `RESOURCE_EXHAUSTED`: There is insufficient storage space to add the
-  //   entry to the cache.
-  rpc UpdateActionResult(UpdateActionResultRequest) returns (ActionResult) {
-    option (google.api.http) = {
-      put: "/v1test/{instance_name=**}/actionResults/{action_digest.hash}/{action_digest.size_bytes}"
-      body: "action_result"
-    };
-  }
-}
-
-// The CAS (content-addressable storage) is used to store the inputs to and
-// outputs from the execution service. Each piece of content is addressed by the
-// digest of its binary data.
-//
-// Most of the binary data stored in the CAS is opaque to the execution engine,
-// and is only used as a communication medium. In order to build an
-// [Action][google.devtools.remoteexecution.v1test.Action],
-// however, the client will need to also upload the
-// [Command][google.devtools.remoteexecution.v1test.Command] and input root
-// [Directory][google.devtools.remoteexecution.v1test.Directory] for the Action.
-// The Command and Directory messages must be marshalled to wire format and then
-// uploaded under the hash as with any other piece of content. In practice, the
-// input root directory is likely to refer to other Directories in its
-// hierarchy, which must also each be uploaded on their own.
-//
-// For small file uploads the client should group them together and call
-// [BatchUpdateBlobs][google.devtools.remoteexecution.v1test.ContentAddressableStorage.BatchUpdateBlobs]
-// on chunks of no more than 10 MiB. For large uploads, the client must use the
-// [Write method][google.bytestream.ByteStream.Write] of the ByteStream API. The
-// `resource_name` is `{instance_name}/uploads/{uuid}/blobs/{hash}/{size}`,
-// where `instance_name` is as described in the next paragraph, `uuid` is a
-// version 4 UUID generated by the client, and `hash` and `size` are the
-// [Digest][google.devtools.remoteexecution.v1test.Digest] of the blob. The
-// `uuid` is used only to avoid collisions when multiple clients try to upload
-// the same file (or the same client tries to upload the file multiple times at
-// once on different threads), so the client MAY reuse the `uuid` for uploading
-// different blobs. The `resource_name` may optionally have a trailing filename
-// (or other metadata) for a client to use if it is storing URLs, as in
-// `{instance}/uploads/{uuid}/blobs/{hash}/{size}/foo/bar/baz.cc`. Anything
-// after the `size` is ignored.
-//
-// A single server MAY support multiple instances of the execution system, each
-// with their own workers, storage, cache, etc. The exact relationship between
-// instances is up to the server. If the server does, then the `instance_name`
-// is an identifier, possibly containing multiple path segments, used to
-// distinguish between the various instances on the server, in a manner defined
-// by the server. For servers which do not support multiple instances, then the
-// `instance_name` is the empty path and the leading slash is omitted, so that
-// the `resource_name` becomes `uploads/{uuid}/blobs/{hash}/{size}`.
-//
-// When attempting an upload, if another client has already completed the upload
-// (which may occur in the middle of a single upload if another client uploads
-// the same blob concurrently), the request will terminate immediately with
-// a response whose `committed_size` is the full size of the uploaded file
-// (regardless of how much data was transmitted by the client). If the client
-// completes the upload but the
-// [Digest][google.devtools.remoteexecution.v1test.Digest] does not match, an
-// `INVALID_ARGUMENT` error will be returned. In either case, the client should
-// not attempt to retry the upload.
-//
-// For downloading blobs, the client must use the
-// [Read method][google.bytestream.ByteStream.Read] of the ByteStream API, with
-// a `resource_name` of `"{instance_name}/blobs/{hash}/{size}"`, where
-// `instance_name` is the instance name (see above), and `hash` and `size` are
-// the [Digest][google.devtools.remoteexecution.v1test.Digest] of the blob.
-//
-// The lifetime of entries in the CAS is implementation specific, but it SHOULD
-// be long enough to allow for newly-added and recently looked-up entries to be
-// used in subsequent calls (e.g. to
-// [Execute][google.devtools.remoteexecution.v1test.Execution.Execute]).
-//
-// As with other services in the Remote Execution API, any call may return an
-// error with a [RetryInfo][google.rpc.RetryInfo] error detail providing
-// information about when the client should retry the request; clients SHOULD
-// respect the information provided.
-service ContentAddressableStorage {
-  // Determine if blobs are present in the CAS.
-  //
-  // Clients can use this API before uploading blobs to determine which ones are
-  // already present in the CAS and do not need to be uploaded again.
-  //
-  // There are no method-specific errors.
-  rpc FindMissingBlobs(FindMissingBlobsRequest)
-      returns (FindMissingBlobsResponse) {
-    option (google.api.http) = {
-      post: "/v1test/{instance_name=**}/blobs:findMissing"
-      body: "*"
-    };
-  }
-
-  // Upload many blobs at once.
-  //
-  // The client MUST NOT upload blobs with a combined total size of more than 10
-  // MiB using this API. Such requests should either be split into smaller
-  // chunks or uploaded using the
-  // [ByteStream API][google.bytestream.ByteStream], as appropriate.
-  //
-  // This request is equivalent to calling [UpdateBlob][] on each individual
-  // blob, in parallel. The requests may succeed or fail independently.
-  //
-  // Errors:
-  // * `INVALID_ARGUMENT`: The client attempted to upload more than 10 MiB of
-  //   data.
-  //
-  // Individual requests may return the following errors, additionally:
-  // * `RESOURCE_EXHAUSTED`: There is insufficient disk quota to store the blob.
-  // * `INVALID_ARGUMENT`: The
-  // [Digest][google.devtools.remoteexecution.v1test.Digest] does not match the
-  // provided data.
-  rpc BatchUpdateBlobs(BatchUpdateBlobsRequest)
-      returns (BatchUpdateBlobsResponse) {
-    option (google.api.http) = {
-      post: "/v1test/{instance_name=**}/blobs:batchUpdate"
-      body: "*"
-    };
-  }
-
-  // Fetch the entire directory tree rooted at a node.
-  //
-  // This request must be targeted at a
-  // [Directory][google.devtools.remoteexecution.v1test.Directory] stored in the
-  // [ContentAddressableStorage][google.devtools.remoteexecution.v1test.ContentAddressableStorage]
-  // (CAS). The server will enumerate the `Directory` tree recursively and
-  // return every node descended from the root.
-  // The exact traversal order is unspecified and, unless retrieving subsequent
-  // pages from an earlier request, is not guaranteed to be stable across
-  // multiple invocations of `GetTree`.
-  //
-  // If part of the tree is missing from the CAS, the server will return the
-  // portion present and omit the rest.
-  //
-  // * `NOT_FOUND`: The requested tree root is not present in the CAS.
-  rpc GetTree(GetTreeRequest) returns (GetTreeResponse) {
-    option (google.api.http) = {
-      get: "/v1test/{instance_name=**}/blobs/{root_digest.hash}/{root_digest.size_bytes}:getTree"
-    };
-  }
-}
-
-// An `Action` captures all the information about an execution which is required
-// to reproduce it.
-//
-// `Action`s are the core component of the [Execution] service. A single
-// `Action` represents a repeatable action that can be performed by the
-// execution service. `Action`s can be succinctly identified by the digest of
-// their wire format encoding and, once an `Action` has been executed, will be
-// cached in the action cache. Future requests can then use the cached result
-// rather than needing to run afresh.
-//
-// When a server completes execution of an
-// [Action][google.devtools.remoteexecution.v1test.Action], it MAY choose to
-// cache the [result][google.devtools.remoteexecution.v1test.ActionResult] in
-// the [ActionCache][google.devtools.remoteexecution.v1test.ActionCache] unless
-// `do_not_cache` is `true`. Clients SHOULD expect the server to do so. By
-// default, future calls to [Execute][] the same `Action` will also serve their
-// results from the cache. Clients must take care to understand the caching
-// behaviour. Ideally, all `Action`s will be reproducible so that serving a
-// result from cache is always desirable and correct.
-message Action {
-  // The digest of the [Command][google.devtools.remoteexecution.v1test.Command]
-  // to run, which MUST be present in the
-  // [ContentAddressableStorage][google.devtools.remoteexecution.v1test.ContentAddressableStorage].
-  Digest command_digest = 1;
-
-  // The digest of the root
-  // [Directory][google.devtools.remoteexecution.v1test.Directory] for the input
-  // files. The files in the directory tree are available in the correct
-  // location on the build machine before the command is executed. The root
-  // directory, as well as every subdirectory and content blob referred to, MUST
-  // be in the
-  // [ContentAddressableStorage][google.devtools.remoteexecution.v1test.ContentAddressableStorage].
-  Digest input_root_digest = 2;
-
-  // A list of the output files that the client expects to retrieve from the
-  // action. Only the listed files, as well as directories listed in
-  // `output_directories`, will be returned to the client as output.
-  // Other files that may be created during command execution are discarded.
-  //
-  // The paths are relative to the working directory of the action execution.
-  // The paths are specified using a single forward slash (`/`) as a path
-  // separator, even if the execution platform natively uses a different
-  // separator. The path MUST NOT include a trailing slash, nor a leading slash,
-  // being a relative path.
-  //
-  // In order to ensure consistent hashing of the same Action, the output paths
-  // MUST be sorted lexicographically by code point (or, equivalently, by UTF-8
-  // bytes).
-  repeated string output_files = 3;
-
-  // A list of the output directories that the client expects to retrieve from
-  // the action. Only the contents of the indicated directories (recursively
-  // including the contents of their subdirectories) will be
-  // returned, as well as files listed in `output_files`. Other files that may
-  // be created during command execution are discarded.
-  //
-  // The paths are relative to the working directory of the action execution.
-  // The paths are specified using a single forward slash (`/`) as a path
-  // separator, even if the execution platform natively uses a different
-  // separator. The path MUST NOT include a trailing slash, nor a leading slash,
-  // being a relative path.
-  // The special value of empty string is allowed, although not recommended, and
-  // can be used to capture the entire working directory tree, including inputs.
-  //
-  // In order to ensure consistent hashing of the same Action, the output paths
-  // MUST be sorted lexicographically by code point (or, equivalently, by UTF-8
-  // bytes).
-  repeated string output_directories = 4;
-
-  // The platform requirements for the execution environment. The server MAY
-  // choose to execute the action on any worker satisfying the requirements, so
-  // the client SHOULD ensure that running the action on any such worker will
-  // have the same result.
-  Platform platform = 5;
-
-  // A timeout after which the execution should be killed. If the timeout is
-  // absent, then the client is specifying that the execution should continue
-  // as long as the server will let it. The server SHOULD impose a timeout if
-  // the client does not specify one, however, if the client does specify a
-  // timeout that is longer than the server's maximum timeout, the server MUST
-  // reject the request.
-  //
-  // The timeout is a part of the
-  // [Action][google.devtools.remoteexecution.v1test.Action] message, and
-  // therefore two `Actions` with different timeouts are different, even if they
-  // are otherwise identical. This is because, if they were not, running an
-  // `Action` with a lower timeout than is required might result in a cache hit
-  // from an execution run with a longer timeout, hiding the fact that the
-  // timeout is too short. By encoding it directly in the `Action`, a lower
-  // timeout will result in a cache miss and the execution timeout will fail
-  // immediately, rather than whenever the cache entry gets evicted.
-  google.protobuf.Duration timeout = 6;
-
-  // If true, then the `Action`'s result cannot be cached.
-  bool do_not_cache = 7;
-}
-
-// A `Command` is the actual command executed by a worker running an
-// [Action][google.devtools.remoteexecution.v1test.Action].
-//
-// Except as otherwise required, the environment (such as which system
-// libraries or binaries are available, and what filesystems are mounted where)
-// is defined by and specific to the implementation of the remote execution API.
-message Command {
-  // An `EnvironmentVariable` is one variable to set in the running program's
-  // environment.
-  message EnvironmentVariable {
-    // The variable name.
-    string name = 1;
-
-    // The variable value.
-    string value = 2;
-  }
-
-  // The arguments to the command. The first argument must be the path to the
-  // executable, which must be either a relative path, in which case it is
-  // evaluated with respect to the input root, or an absolute path.
-  //
-  // The working directory will always be the input root.
-  repeated string arguments = 1;
-
-  // The environment variables to set when running the program. The worker may
-  // provide its own default environment variables; these defaults can be
-  // overridden using this field. Additional variables can also be specified.
-  //
-  // In order to ensure that equivalent `Command`s always hash to the same
-  // value, the environment variables MUST be lexicographically sorted by name.
-  // Sorting of strings is done by code point, equivalently, by the UTF-8 bytes.
-  repeated EnvironmentVariable environment_variables = 2;
-}
-
-// A `Platform` is a set of requirements, such as hardware, operating system, or
-// compiler toolchain, for an
-// [Action][google.devtools.remoteexecution.v1test.Action]'s execution
-// environment. A `Platform` is represented as a series of key-value pairs
-// representing the properties that are required of the platform.
-//
-// This message is currently being redeveloped since it is an overly simplistic
-// model of platforms.
-message Platform {
-  // A single property for the environment. The server is responsible for
-  // specifying the property `name`s that it accepts. If an unknown `name` is
-  // provided in the requirements for an
-  // [Action][google.devtools.remoteexecution.v1test.Action], the server SHOULD
-  // reject the execution request. If permitted by the server, the same `name`
-  // may occur multiple times.
-  //
-  // The server is also responsible for specifying the interpretation of
-  // property `value`s. For instance, a property describing how much RAM must be
-  // available may be interpreted as allowing a worker with 16GB to fulfill a
-  // request for 8GB, while a property describing the OS environment on which
-  // the action must be performed may require an exact match with the worker's
-  // OS.
-  //
-  // The server MAY use the `value` of one or more properties to determine how
-  // it sets up the execution environment, such as by making specific system
-  // files available to the worker.
-  message Property {
-    // The property name.
-    string name = 1;
-
-    // The property value.
-    string value = 2;
-  }
-
-  // The properties that make up this platform. In order to ensure that
-  // equivalent `Platform`s always hash to the same value, the properties MUST
-  // be lexicographically sorted by name, and then by value. Sorting of strings
-  // is done by code point, equivalently, by the UTF-8 bytes.
-  repeated Property properties = 1;
-}
-
-// A `Directory` represents a directory node in a file tree, containing zero or
-// more children [FileNodes][google.devtools.remoteexecution.v1test.FileNode]
-// and [DirectoryNodes][google.devtools.remoteexecution.v1test.DirectoryNode].
-// Each `Node` contains its name in the directory, the digest of its content
-// (either a file blob or a `Directory` proto), as well as possibly some
-// metadata about the file or directory.
-//
-// In order to ensure that two equivalent directory trees hash to the same
-// value, the following restrictions MUST be obeyed when constructing a
-// a `Directory`:
-//   - Every child in the directory must have a path of exactly one segment.
-//     Multiple levels of directory hierarchy may not be collapsed.
-//   - Each child in the directory must have a unique path segment (file name).
-//   - The files and directories in the directory must each be sorted in
-//     lexicographical order by path. The path strings must be sorted by code
-//     point, equivalently, by UTF-8 bytes.
-//
-// A `Directory` that obeys the restrictions is said to be in canonical form.
-//
-// As an example, the following could be used for a file named `bar` and a
-// directory named `foo` with an executable file named `baz` (hashes shortened
-// for readability):
-//
-// ```json
-// // (Directory proto)
-// {
-//   files: [
-//     {
-//       name: "bar",
-//       digest: {
-//         hash: "4a73bc9d03...",
-//         size: 65534
-//       }
-//     }
-//   ],
-//   directories: [
-//     {
-//       name: "foo",
-//       digest: {
-//         hash: "4cf2eda940...",
-//         size: 43
-//       }
-//     }
-//   ]
-// }
-//
-// // (Directory proto with hash "4cf2eda940..." and size 43)
-// {
-//   files: [
-//     {
-//       name: "baz",
-//       digest: {
-//         hash: "b2c941073e...",
-//         size: 1294,
-//       },
-//       is_executable: true
-//     }
-//   ]
-// }
-// ```
-message Directory {
-  // The files in the directory.
-  repeated FileNode files = 1;
-
-  // The subdirectories in the directory.
-  repeated DirectoryNode directories = 2;
-}
-
-// A `FileNode` represents a single file and associated metadata.
-message FileNode {
-  // The name of the file.
-  string name = 1;
-
-  // The digest of the file's content.
-  Digest digest = 2;
-
-  // True if file is executable, false otherwise.
-  bool is_executable = 4;
-}
-
-// A `DirectoryNode` represents a child of a
-// [Directory][google.devtools.remoteexecution.v1test.Directory] which is itself
-// a `Directory` and its associated metadata.
-message DirectoryNode {
-  // The name of the directory.
-  string name = 1;
-
-  // The digest of the
-  // [Directory][google.devtools.remoteexecution.v1test.Directory] object
-  // represented. See [Digest][google.devtools.remoteexecution.v1test.Digest]
-  // for information about how to take the digest of a proto message.
-  Digest digest = 2;
-}
-
-// A content digest. A digest for a given blob consists of the size of the blob
-// and its hash. The hash algorithm to use is defined by the server, but servers
-// SHOULD use SHA-256.
-//
-// The size is considered to be an integral part of the digest and cannot be
-// separated. That is, even if the `hash` field is correctly specified but
-// `size_bytes` is not, the server MUST reject the request.
-//
-// The reason for including the size in the digest is as follows: in a great
-// many cases, the server needs to know the size of the blob it is about to work
-// with prior to starting an operation with it, such as flattening Merkle tree
-// structures or streaming it to a worker. Technically, the server could
-// implement a separate metadata store, but this results in a significantly more
-// complicated implementation as opposed to having the client specify the size
-// up-front (or storing the size along with the digest in every message where
-// digests are embedded). This does mean that the API leaks some implementation
-// details of (what we consider to be) a reasonable server implementation, but
-// we consider this to be a worthwhile tradeoff.
-//
-// When a `Digest` is used to refer to a proto message, it always refers to the
-// message in binary encoded form. To ensure consistent hashing, clients and
-// servers MUST ensure that they serialize messages according to the following
-// rules, even if there are alternate valid encodings for the same message.
-// - Fields are serialized in tag order.
-// - There are no unknown fields.
-// - There are no duplicate fields.
-// - Fields are serialized according to the default semantics for their type.
-//
-// Most protocol buffer implementations will always follow these rules when
-// serializing, but care should be taken to avoid shortcuts. For instance,
-// concatenating two messages to merge them may produce duplicate fields.
-message Digest {
-  // The hash. In the case of SHA-256, it will always be a lowercase hex string
-  // exactly 64 characters long.
-  string hash = 1;
-
-  // The size of the blob, in bytes.
-  int64 size_bytes = 2;
-}
-
-// An ActionResult represents the result of an
-// [Action][google.devtools.remoteexecution.v1test.Action] being run.
-message ActionResult {
-  // The output files of the action. For each output file requested in the
-  // `output_files` field of the Action, if the corresponding file existed after
-  // the action completed, a single entry will be present in the output list.
-  //
-  // If the action does not produce the requested output, or produces a
-  // directory where a regular file is expected or vice versa, then that output
-  // will be omitted from the list. The server is free to arrange the output
-  // list as desired; clients MUST NOT assume that the output list is sorted.
-  repeated OutputFile output_files = 2;
-
-  // The output directories of the action. For each output directory requested
-  // in the `output_directories` field of the Action, if the corresponding
-  // directory existed after the action completed, a single entry will be
-  // present in the output list, which will contain the digest of
-  // a [Tree][google.devtools.remoteexecution.v1test.Tree] message containing
-  // the directory tree, and the path equal exactly to the corresponding Action
-  // output_directories member.
-  // As an example, suppose the Action had an output directory `a/b/dir` and the
-  // execution produced the following contents in `a/b/dir`: a file named `bar`
-  // and a directory named `foo` with an executable file named `baz`. Then,
-  // output_directory will contain (hashes shortened for readability):
-  //
-  // ```json
-  // // OutputDirectory proto:
-  // {
-  //   path: "a/b/dir"
-  //   tree_digest: {
-  //     hash: "4a73bc9d03...",
-  //     size: 55
-  //   }
-  // }
-  // // Tree proto with hash "4a73bc9d03..." and size 55:
-  // {
-  //   root: {
-  //     files: [
-  //       {
-  //         name: "bar",
-  //         digest: {
-  //           hash: "4a73bc9d03...",
-  //           size: 65534
-  //         }
-  //       }
-  //     ],
-  //     directories: [
-  //       {
-  //         name: "foo",
-  //         digest: {
-  //           hash: "4cf2eda940...",
-  //           size: 43
-  //         }
-  //       }
-  //     ]
-  //   }
-  //   children : {
-  //     // (Directory proto with hash "4cf2eda940..." and size 43)
-  //     files: [
-  //       {
-  //         name: "baz",
-  //         digest: {
-  //           hash: "b2c941073e...",
-  //           size: 1294,
-  //         },
-  //         is_executable: true
-  //       }
-  //     ]
-  //   }
-  // }
-  // ```
-  repeated OutputDirectory output_directories = 3;
-
-  // The exit code of the command.
-  int32 exit_code = 4;
-
-  // The standard output buffer of the action. The server will determine, based
-  // on the size of the buffer, whether to return it in raw form or to return
-  // a digest in `stdout_digest` that points to the buffer. If neither is set,
-  // then the buffer is empty. The client SHOULD NOT assume it will get one of
-  // the raw buffer or a digest on any given request and should be prepared to
-  // handle either.
-  bytes stdout_raw = 5;
-
-  // The digest for a blob containing the standard output of the action, which
-  // can be retrieved from the
-  // [ContentAddressableStorage][google.devtools.remoteexecution.v1test.ContentAddressableStorage].
-  // See `stdout_raw` for when this will be set.
-  Digest stdout_digest = 6;
-
-  // The standard error buffer of the action. The server will determine, based
-  // on the size of the buffer, whether to return it in raw form or to return
-  // a digest in `stderr_digest` that points to the buffer. If neither is set,
-  // then the buffer is empty. The client SHOULD NOT assume it will get one of
-  // the raw buffer or a digest on any given request and should be prepared to
-  // handle either.
-  bytes stderr_raw = 7;
-
-  // The digest for a blob containing the standard error of the action, which
-  // can be retrieved from the
-  // [ContentAddressableStorage][google.devtools.remoteexecution.v1test.ContentAddressableStorage].
-  // See `stderr_raw` for when this will be set.
-  Digest stderr_digest = 8;
-}
-
-// An `OutputFile` is similar to a
-// [FileNode][google.devtools.remoteexecution.v1test.FileNode], but it is
-// tailored for output as part of an `ActionResult`. It allows a full file path
-// rather than only a name, and allows the server to include content inline.
-//
-// `OutputFile` is binary-compatible with `FileNode`.
-message OutputFile {
-  // The full path of the file relative to the input root, including the
-  // filename. The path separator is a forward slash `/`. Since this is a
-  // relative path, it MUST NOT begin with a leading forward slash.
-  string path = 1;
-
-  // The digest of the file's content.
-  Digest digest = 2;
-
-  // The raw content of the file.
-  //
-  // This field may be used by the server to provide the content of a file
-  // inline in an
-  // [ActionResult][google.devtools.remoteexecution.v1test.ActionResult] and
-  // avoid requiring that the client make a separate call to
-  // [ContentAddressableStorage.GetBlob] to retrieve it.
-  //
-  // The client SHOULD NOT assume that it will get raw content with any request,
-  // and always be prepared to retrieve it via `digest`.
-  bytes content = 3;
-
-  // True if file is executable, false otherwise.
-  bool is_executable = 4;
-}
-
-// A `Tree` contains all the
-// [Directory][google.devtools.remoteexecution.v1test.Directory] protos in a
-// single directory Merkle tree, compressed into one message.
-message Tree {
-  // The root directory in the tree.
-  Directory root = 1;
-
-  // All the child directories: the directories referred to by the root and,
-  // recursively, all its children. In order to reconstruct the directory tree,
-  // the client must take the digests of each of the child directories and then
-  // build up a tree starting from the `root`.
-  repeated Directory children = 2;
-}
-
-// An `OutputDirectory` is the output in an `ActionResult` corresponding to a
-// directory's full contents rather than a single file.
-message OutputDirectory {
-  // The full path of the directory relative to the working directory. The path
-  // separator is a forward slash `/`. Since this is a relative path, it MUST
-  // NOT begin with a leading forward slash. The empty string value is allowed,
-  // and it denotes the entire working directory.
-  string path = 1;
-
-  // DEPRECATED: This field is deprecated and should no longer be used.
-  Digest digest = 2;
-
-  // The digest of the encoded
-  // [Tree][google.devtools.remoteexecution.v1test.Tree] proto containing the
-  // directory's contents.
-  Digest tree_digest = 3;
-}
-
-// A request message for
-// [Execution.Execute][google.devtools.remoteexecution.v1test.Execution.Execute].
-message ExecuteRequest {
-  // The instance of the execution system to operate against. A server may
-  // support multiple instances of the execution system (with their own workers,
-  // storage, caches, etc.). The server MAY require use of this field to select
-  // between them in an implementation-defined fashion, otherwise it can be
-  // omitted.
-  string instance_name = 1;
-
-  // The action to be performed.
-  Action action = 2;
-
-  // If true, the action will be executed anew even if its result was already
-  // present in the cache. If false, the result may be served from the
-  // [ActionCache][google.devtools.remoteexecution.v1test.ActionCache].
-  bool skip_cache_lookup = 3;
-
-  // DEPRECATED: This field should be ignored by clients and servers and will be
-  // removed.
-  int32 total_input_file_count = 4;
-
-  // DEPRECATED: This field should be ignored by clients and servers and will be
-  // removed.
-  int64 total_input_file_bytes = 5;
-}
-
-// A `LogFile` is a log stored in the CAS.
-message LogFile {
-  // The digest of the log contents.
-  Digest digest = 1;
-
-  // This is a hint as to the purpose of the log, and is set to true if the log
-  // is human-readable text that can be usefully displayed to a user, and false
-  // otherwise. For instance, if a command-line client wishes to print the
-  // server logs to the terminal for a failed action, this allows it to avoid
-  // displaying a binary file.
-  bool human_readable = 2;
-}
-
-// The response message for
-// [Execution.Execute][google.devtools.remoteexecution.v1test.Execution.Execute],
-// which will be contained in the [response
-// field][google.longrunning.Operation.response] of the
-// [Operation][google.longrunning.Operation].
-message ExecuteResponse {
-  // The result of the action.
-  ActionResult result = 1;
-
-  // True if the result was served from cache, false if it was executed.
-  bool cached_result = 2;
-
-  // If the status has a code other than `OK`, it indicates that the action did
-  // not finish execution. For example, if the operation times out during
-  // execution, the status will have a `DEADLINE_EXCEEDED` code. Servers MUST
-  // use this field for errors in execution, rather than the error field on the
-  // `Operation` object.
-  //
-  // If the status code is other than `OK`, then the result MUST NOT be cached.
-  // For an error status, the `result` field is optional; the server may
-  // populate the output-, stdout-, and stderr-related fields if it has any
-  // information available, such as the stdout and stderr of a timed-out action.
-  google.rpc.Status status = 3;
-
-  // An optional list of additional log outputs the server wishes to provide. A
-  // server can use this to return execution-specific logs however it wishes.
-  // This is intended primarily to make it easier for users to debug issues that
-  // may be outside of the actual job execution, such as by identifying the
-  // worker executing the action or by providing logs from the worker's setup
-  // phase. The keys SHOULD be human readable so that a client can display them
-  // to a user.
-  map server_logs = 4;
-}
-
-// Metadata about an ongoing
-// [execution][google.devtools.remoteexecution.v1test.Execution.Execute], which
-// will be contained in the [metadata
-// field][google.longrunning.Operation.response] of the
-// [Operation][google.longrunning.Operation].
-message ExecuteOperationMetadata {
-  // The current stage of execution.
-  enum Stage {
-    UNKNOWN = 0;
-
-    // Checking the result against the cache.
-    CACHE_CHECK = 1;
-
-    // Currently idle, awaiting a free machine to execute.
-    QUEUED = 2;
-
-    // Currently being executed by a worker.
-    EXECUTING = 3;
-
-    // Finished execution.
-    COMPLETED = 4;
-  }
-
-  Stage stage = 1;
-
-  // The digest of the [Action][google.devtools.remoteexecution.v1test.Action]
-  // being executed.
-  Digest action_digest = 2;
-
-  // If set, the client can use this name with
-  // [ByteStream.Read][google.bytestream.ByteStream.Read] to stream the
-  // standard output.
-  string stdout_stream_name = 3;
-
-  // If set, the client can use this name with
-  // [ByteStream.Read][google.bytestream.ByteStream.Read] to stream the
-  // standard error.
-  string stderr_stream_name = 4;
-}
-
-// A request message for
-// [ActionCache.GetActionResult][google.devtools.remoteexecution.v1test.ActionCache.GetActionResult].
-message GetActionResultRequest {
-  // The instance of the execution system to operate against. A server may
-  // support multiple instances of the execution system (with their own workers,
-  // storage, caches, etc.). The server MAY require use of this field to select
-  // between them in an implementation-defined fashion, otherwise it can be
-  // omitted.
-  string instance_name = 1;
-
-  // The digest of the [Action][google.devtools.remoteexecution.v1test.Action]
-  // whose result is requested.
-  Digest action_digest = 2;
-}
-
-// A request message for
-// [ActionCache.UpdateActionResult][google.devtools.remoteexecution.v1test.ActionCache.UpdateActionResult].
-message UpdateActionResultRequest {
-  // The instance of the execution system to operate against. A server may
-  // support multiple instances of the execution system (with their own workers,
-  // storage, caches, etc.). The server MAY require use of this field to select
-  // between them in an implementation-defined fashion, otherwise it can be
-  // omitted.
-  string instance_name = 1;
-
-  // The digest of the [Action][google.devtools.remoteexecution.v1test.Action]
-  // whose result is being uploaded.
-  Digest action_digest = 2;
-
-  // The [ActionResult][google.devtools.remoteexecution.v1test.ActionResult]
-  // to store in the cache.
-  ActionResult action_result = 3;
-}
-
-// A request message for
-// [ContentAddressableStorage.FindMissingBlobs][google.devtools.remoteexecution.v1test.ContentAddressableStorage.FindMissingBlobs].
-message FindMissingBlobsRequest {
-  // The instance of the execution system to operate against. A server may
-  // support multiple instances of the execution system (with their own workers,
-  // storage, caches, etc.). The server MAY require use of this field to select
-  // between them in an implementation-defined fashion, otherwise it can be
-  // omitted.
-  string instance_name = 1;
-
-  // A list of the blobs to check.
-  repeated Digest blob_digests = 2;
-}
-
-// A response message for
-// [ContentAddressableStorage.FindMissingBlobs][google.devtools.remoteexecution.v1test.ContentAddressableStorage.FindMissingBlobs].
-message FindMissingBlobsResponse {
-  // A list of the blobs requested *not* present in the storage.
-  repeated Digest missing_blob_digests = 2;
-}
-
-// A single request message for
-// [ContentAddressableStorage.BatchUpdateBlobs][google.devtools.remoteexecution.v1test.ContentAddressableStorage.BatchUpdateBlobs].
-message UpdateBlobRequest {
-  // The digest of the blob. This MUST be the digest of `data`.
-  Digest content_digest = 1;
-
-  // The raw binary data.
-  bytes data = 2;
-}
-
-// A request message for
-// [ContentAddressableStorage.BatchUpdateBlobs][google.devtools.remoteexecution.v1test.ContentAddressableStorage.BatchUpdateBlobs].
-message BatchUpdateBlobsRequest {
-  // The instance of the execution system to operate against. A server may
-  // support multiple instances of the execution system (with their own workers,
-  // storage, caches, etc.). The server MAY require use of this field to select
-  // between them in an implementation-defined fashion, otherwise it can be
-  // omitted.
-  string instance_name = 1;
-
-  // The individual upload requests.
-  repeated UpdateBlobRequest requests = 2;
-}
-
-// A response message for
-// [ContentAddressableStorage.BatchUpdateBlobs][google.devtools.remoteexecution.v1test.ContentAddressableStorage.BatchUpdateBlobs].
-message BatchUpdateBlobsResponse {
-  // A response corresponding to a single blob that the client tried to upload.
-  message Response {
-    // The digest to which this response corresponds.
-    Digest blob_digest = 1;
-
-    // The result of attempting to upload that blob.
-    google.rpc.Status status = 2;
-  }
-
-  // The responses to the requests.
-  repeated Response responses = 1;
-}
-
-// A request message for
-// [ContentAddressableStorage.GetTree][google.devtools.remoteexecution.v1test.ContentAddressableStorage.GetTree].
-message GetTreeRequest {
-  // The instance of the execution system to operate against. A server may
-  // support multiple instances of the execution system (with their own workers,
-  // storage, caches, etc.). The server MAY require use of this field to select
-  // between them in an implementation-defined fashion, otherwise it can be
-  // omitted.
-  string instance_name = 1;
-
-  // The digest of the root, which must be an encoded
-  // [Directory][google.devtools.remoteexecution.v1test.Directory] message
-  // stored in the
-  // [ContentAddressableStorage][google.devtools.remoteexecution.v1test.ContentAddressableStorage].
-  Digest root_digest = 2;
-
-  // A maximum page size to request. If present, the server will request no more
-  // than this many items. Regardless of whether a page size is specified, the
-  // server may place its own limit on the number of items to be returned and
-  // require the client to retrieve more items using a subsequent request.
-  int32 page_size = 3;
-
-  // A page token, which must be a value received in a previous
-  // [GetTreeResponse][google.devtools.remoteexecution.v1test.GetTreeResponse].
-  // If present, the server will use it to return the following page of results.
-  string page_token = 4;
-}
-
-// A response message for
-// [ContentAddressableStorage.GetTree][google.devtools.remoteexecution.v1test.ContentAddressableStorage.GetTree].
-message GetTreeResponse {
-  // The directories descended from the requested root.
-  repeated Directory directories = 1;
-
-  // If present, signifies that there are more results which the client can
-  // retrieve by passing this as the page_token in a subsequent
-  // [request][google.devtools.remoteexecution.v1test.GetTreeRequest].
-  // If empty, signifies that this is the last page of results.
-  string next_page_token = 2;
-}
-
-// Details for the tool used to call the API.
-message ToolDetails {
-  // Name of the tool, e.g. bazel.
-  string tool_name = 1;
-
-  // Version of the tool used for the request, e.g. 5.0.3.
-  string tool_version = 2;
-}
-
-// An optional Metadata to attach to any RPC request to tell the server about an
-// external context of the request. The server may use this for logging or other
-// purposes. To use it, the client attaches the header to the call using the
-// canonical proto serialization:
-// name: google.devtools.remoteexecution.v1test.requestmetadata-bin
-// contents: the base64 encoded binary RequestMetadata message.
-message RequestMetadata {
-  // The details for the tool invoking the requests.
-  ToolDetails tool_details = 1;
-
-  // An identifier that ties multiple requests to the same action.
-  // For example, multiple requests to the CAS, Action Cache, and Execution
-  // API are used in order to compile foo.cc.
-  string action_id = 2;
-
-  // An identifier that ties multiple actions together to a final result.
-  // For example, multiple actions are required to build and run foo_test.
-  string tool_invocation_id = 3;
-
-  // An identifier to tie multiple tool invocations together. For example,
-  // runs of foo_test, bar_test and baz_test on a post-submit of a given patch.
-  string correlated_invocations_id = 4;
-}
diff --git a/third_party/googleapis/google/devtools/remoteexecution/v1test/remote_execution.yaml b/third_party/googleapis/google/devtools/remoteexecution/v1test/remote_execution.yaml
deleted file mode 100644
index 3d4503bba..000000000
--- a/third_party/googleapis/google/devtools/remoteexecution/v1test/remote_execution.yaml
+++ /dev/null
@@ -1,19 +0,0 @@
-type: google.api.Service
-config_version: 3
-name: remoteexecution.googleapis.com
-title: Remote Execution API
-
-apis:
-- name: google.bytestream.ByteStream
-- name: google.devtools.remoteexecution.v1test.ActionCache
-- name: google.devtools.remoteexecution.v1test.ContentAddressableStorage
-- name: google.devtools.remoteexecution.v1test.Execution
-- name: google.longrunning.Operations
-- name: google.watcher.v1.Watcher
-
-types:
-- name: google.devtools.remoteexecution.v1test.Command
-- name: google.devtools.remoteexecution.v1test.ExecuteResponse
-- name: google.devtools.remoteexecution.v1test.ExecuteOperationMetadata
-- name: google.devtools.remoteexecution.v1test.RequestMetadata
-- name: google.devtools.remoteexecution.v1test.Tree
diff --git a/third_party/googleapis/google/devtools/remoteworkers/v1test2/BUILD.bazel b/third_party/googleapis/google/devtools/remoteworkers/v1test2/BUILD.bazel
new file mode 100644
index 000000000..91497a257
--- /dev/null
+++ b/third_party/googleapis/google/devtools/remoteworkers/v1test2/BUILD.bazel
@@ -0,0 +1,372 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "remoteworkers_proto",
+    srcs = [
+        "bots.proto",
+        "command.proto",
+        "tasks.proto",
+        "worker.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/rpc:status_proto",
+        "@com_google_protobuf//:any_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "remoteworkers_proto_with_info",
+    deps = [
+        ":remoteworkers_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "remoteworkers_java_proto",
+    deps = [":remoteworkers_proto"],
+)
+
+java_grpc_library(
+    name = "remoteworkers_java_grpc",
+    srcs = [":remoteworkers_proto"],
+    deps = [":remoteworkers_java_proto"],
+)
+
+java_gapic_library(
+    name = "remoteworkers_java_gapic",
+    src = ":remoteworkers_proto_with_info",
+    gapic_yaml = "remoteworkers_gapic.yaml",
+    package = "google.devtools.remoteworkers.v1test2",
+    service_yaml = "remoteworkers.yaml",
+    test_deps = [
+        ":remoteworkers_java_grpc",
+    ],
+    deps = [
+        ":remoteworkers_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "remoteworkers_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.devtools.remoteworkers.v1test2.BotsClientTest",
+        "com.google.cloud.devtools.remoteworkers.v1test2.TasksClientTest",
+    ],
+    runtime_deps = [":remoteworkers_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-devtools-remoteworkers-v1test2-java",
+    deps = [
+        ":remoteworkers_java_gapic",
+        ":remoteworkers_java_grpc",
+        ":remoteworkers_java_proto",
+        ":remoteworkers_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "remoteworkers_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/devtools/remoteworkers/v1test2",
+    protos = [":remoteworkers_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/rpc:status_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "remoteworkers_go_gapic",
+    srcs = [":remoteworkers_proto_with_info"],
+    grpc_service_config = "remoteworkers_grpc_service_config.json",
+    importpath = "cloud.google.com/go/devtools/remoteworkers/apiv1test2;remoteworkers",
+    service_yaml = "remoteworkers.yaml",
+    deps = [
+        ":remoteworkers_go_proto",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
+    ],
+)
+
+go_test(
+    name = "remoteworkers_go_gapic_test",
+    srcs = [":remoteworkers_go_gapic_srcjar_test"],
+    embed = [":remoteworkers_go_gapic"],
+    importpath = "cloud.google.com/go/devtools/remoteworkers/apiv1test2",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-devtools-remoteworkers-v1test2-go",
+    deps = [
+        ":remoteworkers_go_gapic",
+        ":remoteworkers_go_gapic_srcjar-test.srcjar",
+        ":remoteworkers_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "remoteworkers_moved_proto",
+    srcs = [":remoteworkers_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/rpc:status_proto",
+        "@com_google_protobuf//:any_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "remoteworkers_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":remoteworkers_moved_proto"],
+)
+
+py_grpc_library(
+    name = "remoteworkers_py_grpc",
+    srcs = [":remoteworkers_moved_proto"],
+    deps = [":remoteworkers_py_proto"],
+)
+
+py_gapic_library(
+    name = "remoteworkers_py_gapic",
+    src = ":remoteworkers_proto_with_info",
+    gapic_yaml = "remoteworkers_gapic.yaml",
+    package = "google.devtools.remoteworkers.v1test2",
+    service_yaml = "remoteworkers.yaml",
+    deps = [
+        ":remoteworkers_py_grpc",
+        ":remoteworkers_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "devtools-remoteworkers-v1test2-py",
+    deps = [
+        ":remoteworkers_py_gapic",
+        ":remoteworkers_py_grpc",
+        ":remoteworkers_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "remoteworkers_php_proto",
+    deps = [":remoteworkers_proto"],
+)
+
+php_grpc_library(
+    name = "remoteworkers_php_grpc",
+    srcs = [":remoteworkers_proto"],
+    deps = [":remoteworkers_php_proto"],
+)
+
+php_gapic_library(
+    name = "remoteworkers_php_gapic",
+    src = ":remoteworkers_proto_with_info",
+    gapic_yaml = "remoteworkers_gapic.yaml",
+    package = "google.devtools.remoteworkers.v1test2",
+    service_yaml = "remoteworkers.yaml",
+    deps = [
+        ":remoteworkers_php_grpc",
+        ":remoteworkers_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-devtools-remoteworkers-v1test2-php",
+    deps = [
+        ":remoteworkers_php_gapic",
+        ":remoteworkers_php_grpc",
+        ":remoteworkers_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "remoteworkers_nodejs_gapic",
+    src = ":remoteworkers_proto_with_info",
+    gapic_yaml = "remoteworkers_gapic.yaml",
+    package = "google.devtools.remoteworkers.v1test2",
+    service_yaml = "remoteworkers.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "devtools-remoteworkers-v1test2-nodejs",
+    deps = [
+        ":remoteworkers_nodejs_gapic",
+        ":remoteworkers_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "remoteworkers_ruby_proto",
+    deps = [":remoteworkers_proto"],
+)
+
+ruby_grpc_library(
+    name = "remoteworkers_ruby_grpc",
+    srcs = [":remoteworkers_proto"],
+    deps = [":remoteworkers_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "remoteworkers_ruby_gapic",
+    src = ":remoteworkers_proto_with_info",
+    gapic_yaml = "remoteworkers_gapic.yaml",
+    package = "google.devtools.remoteworkers.v1test2",
+    service_yaml = "remoteworkers.yaml",
+    deps = [
+        ":remoteworkers_ruby_grpc",
+        ":remoteworkers_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-devtools-remoteworkers-v1test2-ruby",
+    deps = [
+        ":remoteworkers_ruby_gapic",
+        ":remoteworkers_ruby_grpc",
+        ":remoteworkers_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "remoteworkers_csharp_proto",
+    deps = [":remoteworkers_proto"],
+)
+
+csharp_grpc_library(
+    name = "remoteworkers_csharp_grpc",
+    srcs = [":remoteworkers_proto"],
+    deps = [":remoteworkers_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "remoteworkers_csharp_gapic",
+    src = ":remoteworkers_proto_with_info",
+    gapic_yaml = "remoteworkers_gapic.yaml",
+    package = "google.devtools.remoteworkers.v1test2",
+    service_yaml = "remoteworkers.yaml",
+    deps = [
+        ":remoteworkers_csharp_grpc",
+        ":remoteworkers_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-devtools-remoteworkers-v1test2-csharp",
+    deps = [
+        ":remoteworkers_csharp_gapic",
+        ":remoteworkers_csharp_grpc",
+        ":remoteworkers_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/devtools/remoteworkers/v1test2/bots.proto b/third_party/googleapis/google/devtools/remoteworkers/v1test2/bots.proto
index fbad1bf4f..662cc10a2 100644
--- a/third_party/googleapis/google/devtools/remoteworkers/v1test2/bots.proto
+++ b/third_party/googleapis/google/devtools/remoteworkers/v1test2/bots.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,15 +11,18 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.devtools.remoteworkers.v1test2;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/devtools/remoteworkers/v1test2/worker.proto";
 import "google/protobuf/any.proto";
-import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
 import "google/protobuf/timestamp.proto";
 import "google/rpc/status.proto";
@@ -59,6 +62,8 @@ option objc_class_prefix = "RW";
 // take the form "projects/{project_id}". This is referred to below as "the farm
 // resource."
 service Bots {
+  option (google.api.default_host) = "remoteworkers.googleapis.com";
+
   // CreateBotSession is called when the bot first joins the farm, and
   // establishes a session ID to ensure that multiple machines do not register
   // using the same name accidentally.
@@ -67,6 +72,7 @@ service Bots {
       post: "/v1test2/{parent=**}/botSessions"
       body: "bot_session"
     };
+    option (google.api.method_signature) = "parent,bot_session";
   }
 
   // UpdateBotSession must be called periodically by the bot (on a schedule
@@ -77,18 +83,7 @@ service Bots {
       patch: "/v1test2/{name=**/botSessions/*}"
       body: "bot_session"
     };
-  }
-
-  // PostBotEventTemp may be called by the bot to indicate that some exceptional
-  // event has occurred. This method is subject to change or removal in future
-  // revisions of this API; we may simply want to replace it with StackDriver or
-  // some other common interface.
-  rpc PostBotEventTemp(PostBotEventTempRequest)
-      returns (google.protobuf.Empty) {
-    option (google.api.http) = {
-      post: "/v1test2/{name=**/botSessions/*}:postEvent"
-      body: "*"
-    };
+    option (google.api.method_signature) = "name,bot_session,update_mask";
   }
 }
 
@@ -100,6 +95,11 @@ service Bots {
 // of the view of this API, which communicates solely with the bot and not
 // directly with the underlying worker.
 message BotSession {
+  option (google.api.resource) = {
+    type: "remoteworkers.googleapis.com/BotSession"
+    pattern: "{unknown_path=**}/botSessions/{bot_session}"
+  };
+
   // The bot session name, as selected by the server. Output only during a call
   // to CreateBotSession.
   string name = 1;
@@ -253,52 +253,6 @@ message AdminTemp {
   string arg = 2;
 }
 
-// Request message for CreateBotSession.
-message CreateBotSessionRequest {
-  // The farm resource.
-  string parent = 1;
-
-  // The bot session to create. Server-assigned fields like name must be unset.
-  BotSession bot_session = 2;
-}
-
-// Request message for UpdateBotSession.
-message UpdateBotSessionRequest {
-  // The bot session name. Must match bot_session.name.
-  string name = 1;
-
-  // The bot session resource to update.
-  BotSession bot_session = 2;
-
-  // The fields on the bot that should be updated. See the BotSession resource
-  // for which fields are updatable by which caller.
-  google.protobuf.FieldMask update_mask = 3;
-}
-
-// Request message for PostBotEventTemp
-message PostBotEventTempRequest {
-  // Types of bot events.
-  enum Type {
-    // Illegal value.
-    UNSPECIFIED = 0;
-
-    // Interesting but harmless event.
-    INFO = 1;
-
-    // Error condition.
-    ERROR = 2;
-  }
-
-  // The bot session name.
-  string name = 1;
-
-  // The type of bot event.
-  Type type = 2;
-
-  // A human-readable message.
-  string msg = 3;
-}
-
 // A coarse description of the status of the bot that the server uses to
 // determine whether to assign the bot new leases.
 enum BotStatus {
@@ -326,6 +280,9 @@ enum BotStatus {
   // Bots are typically only asked to shut down if its host computer will be
   // modified in some way, such as deleting a VM.
   BOT_TERMINATING = 4;
+
+  // The bot is initializing and is not ready to accept leases.
+  INITIALIZING = 5;
 }
 
 // The state of the lease. All leases start in the PENDING state. A bot can
@@ -352,3 +309,30 @@ enum LeaseState {
   // the lease. This may only be set by the server.
   CANCELLED = 5;
 }
+
+// Request message for CreateBotSession.
+message CreateBotSessionRequest {
+  // Required. The farm resource.
+  string parent = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The bot session to create. Server-assigned fields like name must be unset.
+  BotSession bot_session = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Request message for UpdateBotSession.
+message UpdateBotSessionRequest {
+  // Required. The bot session name. Must match bot_session.name.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "remoteworkers.googleapis.com/BotSession"
+    }
+  ];
+
+  // Required. The bot session resource to update.
+  BotSession bot_session = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The fields on the bot that should be updated. See the BotSession resource
+  // for which fields are updatable by which caller.
+  google.protobuf.FieldMask update_mask = 3 [(google.api.field_behavior) = REQUIRED];
+}
diff --git a/third_party/googleapis/google/devtools/remoteworkers/v1test2/command.proto b/third_party/googleapis/google/devtools/remoteworkers/v1test2/command.proto
index 9d5befec7..933b9cf9f 100644
--- a/third_party/googleapis/google/devtools/remoteworkers/v1test2/command.proto
+++ b/third_party/googleapis/google/devtools/remoteworkers/v1test2/command.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,6 +11,7 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
@@ -64,8 +65,22 @@ message CommandTask {
     // that don't (eg, standard header files).
     repeated Digest files = 2;
 
+    // Inline contents for blobs expected to be needed by the bot to execute the
+    // task. For example, contents of entries in `files` or blobs that are
+    // indirectly referenced by an entry there.
+    //
+    // The bot should check against this list before downloading required task
+    // inputs to reduce the number of communications between itself and the
+    // remote CAS server.
+    repeated Blob inline_blobs = 4;
+
     // All environment variables required by the task.
     repeated EnvironmentVariable environment_variables = 3;
+
+    // Directory from which a command is executed. It is a relative directory
+    // with respect to the bot's working directory (i.e., "./"). If it is
+    // non-empty, then it must exist under "./". Otherwise, "./" will be used.
+    string working_directory = 5;
   }
 
   // Describes the expected outputs of the command.
@@ -182,13 +197,13 @@ message CommandResult {
   // uploading/downloading files).
   google.protobuf.Duration overhead = 5 [deprecated = true];
 
-  // Implementation-dependent statistics about the task. Both servers and bots
+  // Implementation-dependent metadata about the task. Both servers and bots
   // may define messages which can be encoded here; bots are free to provide
-  // statistics in multiple formats, and servers are free to choose one or more
+  // metadata in multiple formats, and servers are free to choose one or more
   // of the values to process and ignore others. In particular, it is *not*
   // considered an error for the bot to provide the server with a field that it
   // doesn't know about.
-  repeated google.protobuf.Any statistics = 6;
+  repeated google.protobuf.Any metadata = 6;
 }
 
 // The metadata for a file. Similar to the equivalent message in the Remote
@@ -216,8 +231,7 @@ message FileMetadata {
 // The metadata for a directory. Similar to the equivalent message in the Remote
 // Execution API.
 message DirectoryMetadata {
-  // The path of the directory, as in
-  // [FileMetadata.path][google.devtools.remoteworkers.v1test2.FileMetadata.path].
+  // The path of the directory, as in [FileMetadata.path][google.devtools.remoteworkers.v1test2.FileMetadata.path].
   string path = 1;
 
   // A pointer to the contents of the directory, in the form of a marshalled
@@ -246,6 +260,15 @@ message Digest {
   int64 size_bytes = 2;
 }
 
+// Describes a blob of binary content with its digest.
+message Blob {
+  // The digest of the blob. This should be verified by the receiver.
+  Digest digest = 1;
+
+  // The contents of the blob.
+  bytes contents = 2;
+}
+
 // The contents of a directory. Similar to the equivalent message in the Remote
 // Execution API.
 message Directory {
diff --git a/third_party/googleapis/google/devtools/remoteworkers/v1test2/remoteworkers.yaml b/third_party/googleapis/google/devtools/remoteworkers/v1test2/remoteworkers.yaml
new file mode 100644
index 000000000..ea05361d9
--- /dev/null
+++ b/third_party/googleapis/google/devtools/remoteworkers/v1test2/remoteworkers.yaml
@@ -0,0 +1,18 @@
+type: google.api.Service
+config_version: 3
+name: remoteworkers.googleapis.com
+title: Remote Workers API
+
+apis:
+- name: google.devtools.remoteworkers.v1test2.Bots
+- name: google.devtools.remoteworkers.v1test2.Tasks
+
+types:
+- name: google.devtools.remoteworkers.v1test2.AdminTemp
+- name: google.devtools.remoteworkers.v1test2.CommandOutputs
+- name: google.devtools.remoteworkers.v1test2.CommandOverhead
+- name: google.devtools.remoteworkers.v1test2.CommandResult
+- name: google.devtools.remoteworkers.v1test2.CommandTask
+- name: google.devtools.remoteworkers.v1test2.Directory
+- name: google.devtools.remoteworkers.v1test2.DirectoryMetadata
+- name: google.devtools.remoteworkers.v1test2.FileMetadata
diff --git a/third_party/googleapis/google/api/expr/v1alpha1/cel_gapic.yaml b/third_party/googleapis/google/devtools/remoteworkers/v1test2/remoteworkers_gapic.legacy.yaml
similarity index 85%
rename from third_party/googleapis/google/api/expr/v1alpha1/cel_gapic.yaml
rename to third_party/googleapis/google/devtools/remoteworkers/v1test2/remoteworkers_gapic.legacy.yaml
index d2213fc7e..07a21813e 100644
--- a/third_party/googleapis/google/api/expr/v1alpha1/cel_gapic.yaml
+++ b/third_party/googleapis/google/devtools/remoteworkers/v1test2/remoteworkers_gapic.legacy.yaml
@@ -3,23 +3,23 @@ config_schema_version: 1.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
-    package_name: com.google.cloud.api.expr.v1alpha1
+    package_name: com.google.cloud.devtools.remoteworkers.v1test2
   python:
-    package_name: google.cloud.api.expr_v1alpha1.gapic
+    package_name: google.cloud.devtools.remoteworkers.v1test2.gapic
   go:
-    package_name: cloud.google.com/go/expr/apiv1alpha1
+    package_name: cloud.google.com/go/devtools/remoteworkers/apiv1test2
   csharp:
-    package_name: Google.Api.Expr.V1alpha1
+    package_name: Google.Devtools.Remoteworkers.V1test2
   ruby:
-    package_name: Google::Cloud::Api::Expr::V1alpha1
+    package_name: Google::Cloud::Devtools::Remoteworkers::V1test2
   php:
-    package_name: Google\Cloud\Api\Expr\V1alpha1
+    package_name: Google\Cloud\Devtools\Remoteworkers\V1test2
   nodejs:
-    package_name: expr.v1alpha1
+    package_name: remoteworkers.v1test2
 # A list of API interface configurations.
 interfaces:
   # The fully qualified name of the API interface.
-- name: google.api.expr.v1alpha1.CelService
+- name: google.devtools.remoteworkers.v1test2.Bots
   # A list of resource collection configurations.
   # Consists of a name_pattern and an entity_name.
   # The name_pattern is a pattern to describe the names of the resources of this
@@ -30,7 +30,9 @@ interfaces:
   # methods. If empty, no name methods are generated.
   # The entity_name is the name to be used as a basis for generated methods and
   # classes.
-  collections: []
+  collections:
+  - name_pattern: "{unknown_path=**}/botSessions/{bot_session}"
+    entity_name: bot_session
   # Definition for retryable codes.
   retry_codes_def:
   - name: idempotent
@@ -104,36 +106,36 @@ interfaces:
   #   timeout_millis - Specifies the default timeout for a non-retrying call. If
   #   the call is retrying, refer to retry_params_name instead.
   methods:
-  - name: Parse
+  - name: CreateBotSession
     flattening:
       groups:
       - parameters:
-        - cel_source
+        - parent
+        - bot_session
     required_fields:
-    - cel_source
+    - parent
+    - bot_session
     retry_codes_name: non_idempotent
     retry_params_name: default
     timeout_millis: 60000
-  - name: Check
-    flattening:
-      groups:
-      - parameters:
-        - parsed_expr
-    required_fields:
-    - parsed_expr
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-  - name: Eval
+  - name: UpdateBotSession
     flattening:
       groups:
       - parameters:
+        - name
+        - bot_session
+        - update_mask
     required_fields:
+    - name
+    - bot_session
+    - update_mask
     retry_codes_name: non_idempotent
     retry_params_name: default
+    field_name_patterns:
+      name: bot_session
     timeout_millis: 60000
   # The fully qualified name of the API interface.
-- name: google.api.expr.v1alpha1.ConformanceService
+- name: google.devtools.remoteworkers.v1test2.Tasks
   # A list of resource collection configurations.
   # Consists of a name_pattern and an entity_name.
   # The name_pattern is a pattern to describe the names of the resources of this
@@ -144,7 +146,11 @@ interfaces:
   # methods. If empty, no name methods are generated.
   # The entity_name is the name to be used as a basis for generated methods and
   # classes.
-  collections: []
+  collections:
+  - name_pattern: "{unknown_path=**}/tasks/{task}"
+    entity_name: task
+  - name_pattern: "{unknown_path=**}/tasks/{task}/result"
+    entity_name: task_2
   # Definition for retryable codes.
   retry_codes_def:
   - name: idempotent
@@ -218,31 +224,48 @@ interfaces:
   #   timeout_millis - Specifies the default timeout for a non-retrying call. If
   #   the call is retrying, refer to retry_params_name instead.
   methods:
-  - name: Parse
+  - name: GetTask
     flattening:
       groups:
       - parameters:
-        - cel_source
+        - name
     required_fields:
-    - cel_source
-    retry_codes_name: non_idempotent
+    - name
+    retry_codes_name: idempotent
     retry_params_name: default
+    field_name_patterns:
+      name: task
     timeout_millis: 60000
-  - name: Check
+  - name: UpdateTaskResult
     flattening:
       groups:
       - parameters:
-        - parsed_expr
+        - name
+        - result
+        - update_mask
+        - source
     required_fields:
-    - parsed_expr
+    - name
+    - result
+    - update_mask
+    - source
     retry_codes_name: non_idempotent
     retry_params_name: default
+    field_name_patterns:
+      name: task_2
     timeout_millis: 60000
-  - name: Eval
+  - name: AddTaskLog
+    # params.
     flattening:
       groups:
       - parameters:
+        - name
+        - log_id
     required_fields:
+    - name
+    - log_id
     retry_codes_name: non_idempotent
     retry_params_name: default
+    field_name_patterns:
+      name: task
     timeout_millis: 60000
diff --git a/third_party/googleapis/google/devtools/remoteworkers/v1test2/remoteworkers_gapic.yaml b/third_party/googleapis/google/devtools/remoteworkers/v1test2/remoteworkers_gapic.yaml
index 1ee027d48..171d05a3d 100644
--- a/third_party/googleapis/google/devtools/remoteworkers/v1test2/remoteworkers_gapic.yaml
+++ b/third_party/googleapis/google/devtools/remoteworkers/v1test2/remoteworkers_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -20,268 +20,5 @@ language_settings:
 interfaces:
   # The fully qualified name of the API interface.
 - name: google.devtools.remoteworkers.v1test2.Bots
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections:
-  - name_pattern: "{unknown_path=**}/botSessions/{bot_session}"
-    entity_name: bot_session
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
-  methods:
-  - name: CreateBotSession
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - bot_session
-    required_fields:
-    - parent
-    - bot_session
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-  - name: UpdateBotSession
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - bot_session
-        - update_mask
-    required_fields:
-    - name
-    - bot_session
-    - update_mask
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: bot_session
-    timeout_millis: 60000
-  - name: PostBotEventTemp
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - type
-        - msg
-    required_fields:
-    - name
-    - type
-    - msg
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: bot_session
-    timeout_millis: 60000
-  # The fully qualified name of the API interface.
+
 - name: google.devtools.remoteworkers.v1test2.Tasks
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections:
-  - name_pattern: "{unknown_path=**}/tasks/{task}"
-    entity_name: task
-  - name_pattern: "{unknown_path=**}/tasks/{task}/result"
-    entity_name: task_2
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
-  methods:
-  - name: GetTask
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: task
-    timeout_millis: 60000
-  - name: UpdateTaskResult
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - result
-        - update_mask
-        - source
-    required_fields:
-    - name
-    - result
-    - update_mask
-    - source
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: task_2
-    timeout_millis: 60000
-  - name: AddTaskLog
-    # params.
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - log_id
-    required_fields:
-    - name
-    - log_id
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: task
-    timeout_millis: 60000
diff --git a/third_party/googleapis/google/devtools/remoteworkers/v1test2/remoteworkers_grpc_service_config.json b/third_party/googleapis/google/devtools/remoteworkers/v1test2/remoteworkers_grpc_service_config.json
new file mode 100755
index 000000000..351621275
--- /dev/null
+++ b/third_party/googleapis/google/devtools/remoteworkers/v1test2/remoteworkers_grpc_service_config.json
@@ -0,0 +1,52 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.devtools.remoteworkers.v1test2.Bots",
+          "method": "CreateBotSession"
+        },
+        {
+          "service": "google.devtools.remoteworkers.v1test2.Bots",
+          "method": "UpdateBotSession"
+        },
+        {
+          "service": "google.devtools.remoteworkers.v1test2.Bots",
+          "method": "PostBotEventTemp"
+        }
+      ],
+      "timeout": "600s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.devtools.remoteworkers.v1test2.Tasks",
+          "method": "GetTask"
+        }
+      ],
+      "timeout": "600s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.devtools.remoteworkers.v1test2.Tasks",
+          "method": "UpdateTaskResult"
+        },
+        {
+          "service": "google.devtools.remoteworkers.v1test2.Tasks",
+          "method": "AddTaskLog"
+        }
+      ],
+      "timeout": "600s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/devtools/remoteworkers/v1test2/tasks.proto b/third_party/googleapis/google/devtools/remoteworkers/v1test2/tasks.proto
index 236112aa5..f2e85fd6c 100644
--- a/third_party/googleapis/google/devtools/remoteworkers/v1test2/tasks.proto
+++ b/third_party/googleapis/google/devtools/remoteworkers/v1test2/tasks.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,12 +11,16 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.devtools.remoteworkers.v1test2;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/protobuf/any.proto";
 import "google/protobuf/field_mask.proto";
 import "google/rpc/status.proto";
@@ -32,6 +36,8 @@ option objc_class_prefix = "RW";
 // Lease.result and logs should be precreated prior to sending to the bot (eg,
 // via CommandTask.expected_outputs.stdout_destination).
 service Tasks {
+  option (google.api.default_host) = "remoteworkers.googleapis.com";
+
   // DEPRECATED - use Lease.payload instead.
   // GetTask reads the current state of the task. Tasks must be created through
   // some other interface, and should be immutable once created and exposed to
@@ -40,6 +46,7 @@ service Tasks {
     option (google.api.http) = {
       get: "/v1test2/{name=**/tasks/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // DEPRECATED - use Lease.result instead.
@@ -49,6 +56,7 @@ service Tasks {
       patch: "/v1test2/{name=**/tasks/*/result}"
       body: "result"
     };
+    option (google.api.method_signature) = "name,result,update_mask,source";
   }
 
   // DEPRECATED - precreate logs prior to sending to bot.
@@ -61,6 +69,7 @@ service Tasks {
       post: "/v1test2/{name=**/tasks/*}:addLog"
       body: "*"
     };
+    option (google.api.method_signature) = "name,log_id";
   }
 }
 
@@ -75,6 +84,11 @@ service Tasks {
 // servers should implement partial responses in order to reduce unnecessry
 // overhead.
 message Task {
+  option (google.api.resource) = {
+    type: "remoteworkers.googleapis.com/Task"
+    pattern: "{unknown_path=**}/tasks/{task}"
+  };
+
   // The name of this task. Output only.
   string name = 1;
 
@@ -94,8 +108,11 @@ message Task {
 // DEPRECATED - use Lease.assignment_result instead.
 // The result and metadata of the task.
 message TaskResult {
-  // The name of the task result; must be a name of a `Task` followed by
-  // `/result`.
+  option (google.api.resource) = {
+    type: "remoteworkers.googleapis.com/TaskResult"
+    pattern: "{unknown_path=**}/tasks/{task}/result"
+  };
+
   string name = 1;
 
   // The result may be updated several times; the client must only set
@@ -123,34 +140,49 @@ message TaskResult {
 
 // Request message for `GetTask`.
 message GetTaskRequest {
-  // The task name.
-  string name = 1;
+  // Required. The task name.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "remoteworkers.googleapis.com/Task"
+    }
+  ];
 }
 
 // Request message for `UpdateTaskResult`.
 message UpdateTaskResultRequest {
-  // The task result name; must match `result.name`.
-  string name = 1;
+  // Required. The task result name; must match `result.name`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "remoteworkers.googleapis.com/TaskResult"
+    }
+  ];
 
-  // The result being updated.
-  TaskResult result = 2;
+  // Required. The result being updated.
+  TaskResult result = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // The fields within `result` that are specified.
-  google.protobuf.FieldMask update_mask = 3;
+  // Required. The fields within `result` that are specified.
+  google.protobuf.FieldMask update_mask = 3 [(google.api.field_behavior) = REQUIRED];
 
-  // If this is being updated by a bot from BotManager, the source should be
+  // Required. If this is being updated by a bot from BotManager, the source should be
   // bot.session_id. That way, if two bots accidentally get the same name, we'll
   // know to reject updates from the older one.
-  string source = 4;
+  string source = 4 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request message for `AddTaskLog`.
 message AddTaskLogRequest {
-  // The name of the task that will own the new log.
-  string name = 1;
-
-  // The human-readable name of the log, like `stdout` or a relative file path.
-  string log_id = 2;
+  // Required. The name of the task that will own the new log.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "remoteworkers.googleapis.com/Task"
+    }
+  ];
+
+  // Required. The human-readable name of the log, like `stdout` or a relative file path.
+  string log_id = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response message for `AddTaskLog`.
diff --git a/third_party/googleapis/google/devtools/remoteworkers/v1test2/worker.proto b/third_party/googleapis/google/devtools/remoteworkers/v1test2/worker.proto
index 747226066..b7553382b 100644
--- a/third_party/googleapis/google/devtools/remoteworkers/v1test2/worker.proto
+++ b/third_party/googleapis/google/devtools/remoteworkers/v1test2/worker.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,6 +11,7 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
diff --git a/third_party/googleapis/google/devtools/resultstore/resultstore-service.yaml b/third_party/googleapis/google/devtools/resultstore/resultstore-service.yaml
deleted file mode 100644
index 8f79a90ff..000000000
--- a/third_party/googleapis/google/devtools/resultstore/resultstore-service.yaml
+++ /dev/null
@@ -1,20 +0,0 @@
-type: google.api.Service
-config_version: 3
-name: resultstore.googleapis.com
-title: Result Store API
-
-apis:
-- name: google.devtools.resultstore.v2.ResultStoreDownload
-- name: google.devtools.resultstore.v2.ResultStoreFileDownload
-- name: google.devtools.resultstore.v2.ResultStoreUpload
-
-documentation:
-  summary: The Result Store API v2.
-  overview: An API for reading Invocation results from previous runs.
-
-authentication:
-  rules:
-  - selector: '*'
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/devtools/resultstore/v2/action.proto b/third_party/googleapis/google/devtools/resultstore/v2/action.proto
index 1b4659ef3..18faa32fe 100644
--- a/third_party/googleapis/google/devtools/resultstore/v2/action.proto
+++ b/third_party/googleapis/google/devtools/resultstore/v2/action.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -20,6 +20,7 @@ package google.devtools.resultstore.v2;
 import "google/devtools/resultstore/v2/common.proto";
 import "google/devtools/resultstore/v2/coverage.proto";
 import "google/devtools/resultstore/v2/file.proto";
+import "google/devtools/resultstore/v2/file_processing_error.proto";
 import "google/devtools/resultstore/v2/test_suite.proto";
 import "google/protobuf/duration.proto";
 
@@ -28,12 +29,14 @@ option java_multiple_files = true;
 option java_package = "com.google.devtools.resultstore.v2";
 
 // An action that happened as part of a configured target. This action could be
-// a build, a test, or another type of action.
+// a build, a test, or another type of action, as specified in action_type
+// oneof.
+//
 // Each parent ConfiguredTarget resource should have at least one Action as its
-// child resource before the invocation is finalized. ResultStore is a tool to
-// store build & test results. ConfiguredTarget proto by itself does not contain
-// enough fields to fully represent such results. For a simple build, at least
-// one build action is required to represent the build result.
+// child resource before the invocation is finalized. For a simple build, at
+// least one build action should be created to represent the build result, and
+// at at least one test action should be created to represent the test result,
+// if any.
 message Action {
   // The resource ID components that identify the Action.
   message Id {
@@ -51,7 +54,9 @@ message Action {
   }
 
   // The resource name.  Its format must be:
-  // invocations/${INVOCATION_ID}/targets/${TARGET_ID}/configuredTargets/${CONFIG_ID}/actions/${ACTION_ID}
+  // invocations/${INVOCATION_ID}/targets/${url_encode(TARGET_ID)}/configuredTargets/url_encode(${CONFIG_ID})/actions/${url_encode(ACTION_ID)}
+  //
+  // See CreateActionRequest proto for more information.
   string name = 1;
 
   // The resource ID components that identify the Action. They must match the
@@ -95,8 +100,10 @@ message Action {
   // A list of file references for action level files.
   // The file IDs must be unique within this list. Duplicate file IDs will
   // result in an error. Files will be returned in lexicographical order by ID.
+  //
   // Files with the following reserved file IDs cause specific post-processing
-  // or have special handling:
+  // or have special handling. These files must be immediately available to
+  // ResultStore for processing when the reference is uploaded.
   //
   // For build actions:
   // stdout: The stdout of the action
@@ -113,6 +120,11 @@ message Action {
   //     http://ltp.sourceforge.net/coverage/lcov/geninfo.1.php
   repeated File files = 8;
 
+  // List of names of file sets that are referenced from this Action.
+  // Each name must point to a file set under the same Invocation. The name
+  // format must be: invocations/${INVOCATION_ID}/fileSets/${FILE_SET_ID}
+  repeated string file_sets = 15;
+
   // Coverage data was collected while running the build or test action. This
   // usually includes line coverage, and may also include branch coverage.
   // For test actions, this is usually only for the source files which were
@@ -300,24 +312,6 @@ message TestWarning {
   string warning_message = 1;
 }
 
-// Stores errors reading or parsing a file during post-processing.
-message FileProcessingErrors {
-  // The uid of the File being read or parsed.
-  string file_uid = 1;
-
-  // What went wrong.
-  repeated FileProcessingError file_processing_errors = 3;
-}
-
-// Stores an error reading or parsing a file during post-processing.
-message FileProcessingError {
-  // The type of error that occurred.
-  FileProcessingErrorType type = 1;
-
-  // Error message describing the problem.
-  string message = 2;
-}
-
 // Indicates how/where this Action was executed.
 enum ExecutionStrategy {
   // The action did not indicate how it was executed.
@@ -352,30 +346,3 @@ enum TestCaching {
   // The test result was not found in any cache, so it had to be run again.
   CACHE_MISS = 3;
 }
-
-// Errors in file post-processing are categorized using this enum.
-enum FileProcessingErrorType {
-  // Type unspecified or not listed here.
-  FILE_PROCESSING_ERROR_TYPE_UNSPECIFIED = 0;
-
-  // A read error occurred trying to read the file.
-  GENERIC_READ_ERROR = 1;
-
-  // There was an error trying to parse the file.
-  GENERIC_PARSE_ERROR = 2;
-
-  // File is exceeds size limit.
-  FILE_TOO_LARGE = 3;
-
-  // The result of parsing the file exceeded size limit.
-  OUTPUT_TOO_LARGE = 4;
-
-  // Read access to the file was denied by file system.
-  ACCESS_DENIED = 5;
-
-  // Deadline exceeded trying to read the file.
-  DEADLINE_EXCEEDED = 6;
-
-  // File not found.
-  NOT_FOUND = 7;
-}
diff --git a/third_party/googleapis/google/devtools/resultstore/v2/common.proto b/third_party/googleapis/google/devtools/resultstore/v2/common.proto
index ea962c91d..1a77f2369 100644
--- a/third_party/googleapis/google/devtools/resultstore/v2/common.proto
+++ b/third_party/googleapis/google/devtools/resultstore/v2/common.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -61,17 +61,17 @@ message Dependency {
   // Action.
   oneof resource {
     // The name of a target.  Its format must be:
-    // invocations/${INVOCATION_ID}/targets/${TARGET_ID}
+    // invocations/${INVOCATION_ID}/targets/${url_encode(TARGET_ID)}
     // This must point to an target under the same invocation.
     string target = 1;
 
     // The name of a configured target.  Its format must be:
-    // invocations/${INVOCATION_ID}/targets/${TARGET_ID}/configuredTargets/${CONFIG_ID}
+    // invocations/${INVOCATION_ID}/targets/${url_encode(TARGET_ID)}/configuredTargets/${url_encode(CONFIG_ID)}
     // This must point to an configured target under the same invocation.
     string configured_target = 2;
 
     // The name of an action.  Its format must be:
-    // invocations/${INVOCATION_ID}/targets/${TARGET_ID}/configuredTargets/${CONFIG_ID}/actions/${ACTION_ID}
+    // invocations/${INVOCATION_ID}/targets/${url_encode(TARGET_ID)}/configuredTargets/${url_encode(CONFIG_ID)}/actions/${url_encode(ACTION_ID)}
     // This must point to an action under the same invocation.
     string action = 3;
   }
@@ -146,6 +146,9 @@ enum Language {
 
   // Protocol Buffer
   PROTO = 21;
+
+  // Extensible Markup Language
+  XML = 22;
 }
 
 // Status of a resource.
@@ -202,3 +205,20 @@ enum Status {
   // (E.g. Restricted to a different configuration.)
   SKIPPED = 13;
 }
+
+// Indicates the upload status of the invocation, whether it is
+// post-processing, or immutable, etc.
+enum UploadStatus {
+  // The implicit default enum value. Should never be set.
+  UPLOAD_STATUS_UNSPECIFIED = 0;
+
+  // The invocation is still uploading to the ResultStore.
+  UPLOADING = 1;
+
+  // The invocation upload is complete. The ResultStore is still post-processing
+  // the invocation.
+  POST_PROCESSING = 2;
+
+  // All post-processing is complete, and the invocation is now immutable.
+  IMMUTABLE = 3;
+}
diff --git a/third_party/googleapis/google/devtools/resultstore/v2/configuration.proto b/third_party/googleapis/google/devtools/resultstore/v2/configuration.proto
index eb3068625..ba37d16d9 100644
--- a/third_party/googleapis/google/devtools/resultstore/v2/configuration.proto
+++ b/third_party/googleapis/google/devtools/resultstore/v2/configuration.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -37,7 +37,7 @@ message Configuration {
   }
 
   // The format of this Configuration resource name must be:
-  // invocations/${INVOCATION_ID}/configs/${CONFIG_ID}
+  // invocations/${INVOCATION_ID}/configs/${url_encode(CONFIG_ID)}
   // The configuration ID of "default" should be preferred for the default
   // configuration in a single-config invocation.
   string name = 1;
@@ -56,6 +56,11 @@ message Configuration {
   // This is implemented as a multi-map. Multiple properties are allowed with
   // the same key. Properties will be returned in lexicographical order by key.
   repeated Property properties = 6;
+
+  // A human-readable name for Configuration.
+  // It is recommended that this name be unique.
+  // If omitted, the configuration_id should be used as display_name instead.
+  string display_name = 8;
 }
 
 // Attributes that apply only to the configuration.
diff --git a/third_party/googleapis/google/devtools/resultstore/v2/configured_target.proto b/third_party/googleapis/google/devtools/resultstore/v2/configured_target.proto
index 39d2e1d93..a7c337ccd 100644
--- a/third_party/googleapis/google/devtools/resultstore/v2/configured_target.proto
+++ b/third_party/googleapis/google/devtools/resultstore/v2/configured_target.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -44,7 +44,7 @@ message ConfiguredTarget {
   }
 
   // The resource name.  Its format must be:
-  // invocations/${INVOCATION_ID}/targets/${TARGET_ID}/configuredTargets/${CONFIG_ID}
+  // invocations/${INVOCATION_ID}/targets/${url_encode(TARGET_ID)}/configuredTargets/${url_encode(CONFIG_ID)}
   // where ${CONFIG_ID} must match the ID of an existing Configuration under
   // this Invocation.
   string name = 1;
diff --git a/third_party/googleapis/google/devtools/resultstore/v2/coverage.proto b/third_party/googleapis/google/devtools/resultstore/v2/coverage.proto
index 50415a9b0..786f8afb3 100644
--- a/third_party/googleapis/google/devtools/resultstore/v2/coverage.proto
+++ b/third_party/googleapis/google/devtools/resultstore/v2/coverage.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -66,9 +66,9 @@ message BranchCoverage {
   // As each branch can have any one of the following three states: not
   // executed, executed but not taken, executed and taken.
   //
-  // This is a bitfield where i-th bit corresponds to the i-th line. Divide line
-  // number by 8 to get index into byte array. Mod line number by 8 to get bit
-  // number (0 = LSB, 7 = MSB).
+  // This is a bitfield where i-th bit corresponds to the i-th branch. Divide
+  // branch number by 8 to get index into byte array. Mod branch number by 8 to
+  // get bit number (0 = LSB, 7 = MSB).
   //
   // i-th bit of the following two byte arrays are used to denote the above
   // mentioned states.
@@ -100,3 +100,11 @@ message ActionCoverage {
   // List of coverage info for all source files that the TestResult covers.
   repeated FileCoverage file_coverages = 2;
 }
+
+// Describes aggregate code coverage for a collection of build or test Actions.
+// A line or branch is covered if and only if it is covered in any of the build
+// or test actions.
+message AggregateCoverage {
+  // Aggregated coverage info for all source files that the actions cover.
+  repeated FileCoverage file_coverages = 1;
+}
diff --git a/third_party/googleapis/google/devtools/resultstore/v2/coverage_summary.proto b/third_party/googleapis/google/devtools/resultstore/v2/coverage_summary.proto
index 16f84e3bc..69c599f4d 100644
--- a/third_party/googleapis/google/devtools/resultstore/v2/coverage_summary.proto
+++ b/third_party/googleapis/google/devtools/resultstore/v2/coverage_summary.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/third_party/googleapis/google/devtools/resultstore/v2/download_metadata.proto b/third_party/googleapis/google/devtools/resultstore/v2/download_metadata.proto
new file mode 100644
index 000000000..7ace7e989
--- /dev/null
+++ b/third_party/googleapis/google/devtools/resultstore/v2/download_metadata.proto
@@ -0,0 +1,35 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.devtools.resultstore.v2;
+
+import "google/devtools/resultstore/v2/common.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/devtools/resultstore/v2;resultstore";
+option java_multiple_files = true;
+option java_package = "com.google.devtools.resultstore.v2";
+
+// The download metadata for an invocation
+message DownloadMetadata {
+  // The name of the download metadata.  Its format will be:
+  // invocations/${INVOCATION_ID}/downloadMetadata
+  string name = 1;
+
+  // Indicates the upload status of the invocation, whether it is
+  // post-processing, or immutable, etc.
+  UploadStatus upload_status = 2;
+}
diff --git a/third_party/googleapis/google/devtools/resultstore/v2/file.proto b/third_party/googleapis/google/devtools/resultstore/v2/file.proto
index 93217dc97..b10cdfc6a 100644
--- a/third_party/googleapis/google/devtools/resultstore/v2/file.proto
+++ b/third_party/googleapis/google/devtools/resultstore/v2/file.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/third_party/googleapis/google/devtools/resultstore/v2/file_processing_error.proto b/third_party/googleapis/google/devtools/resultstore/v2/file_processing_error.proto
new file mode 100644
index 000000000..0b137169b
--- /dev/null
+++ b/third_party/googleapis/google/devtools/resultstore/v2/file_processing_error.proto
@@ -0,0 +1,70 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.devtools.resultstore.v2;
+
+option go_package = "google.golang.org/genproto/googleapis/devtools/resultstore/v2;resultstore";
+option java_multiple_files = true;
+option java_package = "com.google.devtools.resultstore.v2";
+
+// Stores errors reading or parsing a file during post-processing.
+message FileProcessingErrors {
+  // The uid of the File being read or parsed.
+  string file_uid = 1;
+
+  // What went wrong.
+  repeated FileProcessingError file_processing_errors = 3;
+}
+
+// Stores an error reading or parsing a file during post-processing.
+message FileProcessingError {
+  // The type of error that occurred.
+  FileProcessingErrorType type = 1;
+
+  // Error message describing the problem.
+  string message = 2;
+}
+
+// Errors in file post-processing are categorized using this enum.
+enum FileProcessingErrorType {
+  // Type unspecified or not listed here.
+  FILE_PROCESSING_ERROR_TYPE_UNSPECIFIED = 0;
+
+  // A read error occurred trying to read the file.
+  GENERIC_READ_ERROR = 1;
+
+  // There was an error trying to parse the file.
+  GENERIC_PARSE_ERROR = 2;
+
+  // File is exceeds size limit.
+  FILE_TOO_LARGE = 3;
+
+  // The result of parsing the file exceeded size limit.
+  OUTPUT_TOO_LARGE = 4;
+
+  // Read access to the file was denied by file system.
+  ACCESS_DENIED = 5;
+
+  // Deadline exceeded trying to read the file.
+  DEADLINE_EXCEEDED = 6;
+
+  // File not found.
+  NOT_FOUND = 7;
+
+  // File is empty but was expected to have content.
+  FILE_EMPTY = 8;
+}
diff --git a/third_party/googleapis/google/devtools/resultstore/v2/file_set.proto b/third_party/googleapis/google/devtools/resultstore/v2/file_set.proto
index d46307fc7..06a584377 100644
--- a/third_party/googleapis/google/devtools/resultstore/v2/file_set.proto
+++ b/third_party/googleapis/google/devtools/resultstore/v2/file_set.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -23,7 +23,18 @@ option go_package = "google.golang.org/genproto/googleapis/devtools/resultstore/
 option java_multiple_files = true;
 option java_package = "com.google.devtools.resultstore.v2";
 
-// Represents a set of files within an Invocation. Can contain other file sets.
+// This resource represents a set of Files and other (nested) FileSets.
+// A FileSet is a node in the graph, and the file_sets field represents the
+// outgoing edges. A resource may reference various nodes in the graph to
+// represent the transitive closure of all files from those nodes.
+// The FileSets must form a directed acyclic graph. The Upload API is unable to
+// enforce that the graph is acyclic at write time, and if cycles are written,
+// it may cause issues at read time.
+//
+// A FileSet may be referenced by other resources in conjunction with Files. A
+// File is preferred for something that can only be ever referenced by one
+// resource, and a FileSet is preferred if it can be reference by multiple
+// resources.
 message FileSet {
   // The resource ID components that identify the FileSet.
   message Id {
@@ -35,7 +46,7 @@ message FileSet {
   }
 
   // The format of this FileSet resource name must be:
-  // invocations/${INVOCATION_ID}/fileSets/${FILE_SET_ID}
+  // invocations/${INVOCATION_ID}/fileSets/${url_encode(FILE_SET_ID)}
   string name = 1;
 
   // The resource ID components that identify the file set. They must match the
@@ -48,5 +59,6 @@ message FileSet {
   repeated string file_sets = 3;
 
   // Files that are contained within this file set.
+  // The uid field in the file should be unique for the Invocation.
   repeated File files = 4;
 }
diff --git a/third_party/googleapis/google/devtools/resultstore/v2/invocation.proto b/third_party/googleapis/google/devtools/resultstore/v2/invocation.proto
index d26266789..253b6daa1 100644
--- a/third_party/googleapis/google/devtools/resultstore/v2/invocation.proto
+++ b/third_party/googleapis/google/devtools/resultstore/v2/invocation.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,8 +18,10 @@ syntax = "proto3";
 package google.devtools.resultstore.v2;
 
 import "google/devtools/resultstore/v2/common.proto";
+import "google/devtools/resultstore/v2/coverage.proto";
 import "google/devtools/resultstore/v2/coverage_summary.proto";
 import "google/devtools/resultstore/v2/file.proto";
+import "google/devtools/resultstore/v2/file_processing_error.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/devtools/resultstore/v2;resultstore";
 option java_multiple_files = true;
@@ -64,15 +66,40 @@ message Invocation {
   // The file IDs must be unique within this list. Duplicate file IDs will
   // result in an error. Files will be returned in lexicographical order by ID.
   // Use this field to specify build logs, and other invocation level logs.
+  //
+  // Files with the following reserved file IDs cause specific post-processing
+  // or have special handling. These files must be immediately available to
+  // ResultStore for processing when the reference is uploaded.
+  //
+  // build.log: The primary log for the Invocation.
+  // coverage_report.lcov: Aggregate coverage report for the invocation.
   repeated File files = 8;
 
   // Summary of aggregate coverage across all Actions in this Invocation.
-  // the server populates this for you in the post-processing phase.
+  // If missing, this data will be populated by the server from the
+  // coverage_report.lcov file or the union of all ActionCoverages under this
+  // invocation (in that order).
   repeated LanguageCoverageSummary coverage_summaries = 9;
+
+  // Aggregate code coverage for all build and test Actions within this
+  // Invocation. If missing, this data will be populated by the server
+  // from the coverage_report.lcov file or the union of all ActionCoverages
+  // under this invocation (in that order).
+  AggregateCoverage aggregate_coverage = 10;
+
+  // NOT IMPLEMENTED.
+  // ResultStore will read and parse Files with reserved IDs listed above. Read
+  // and parse errors for all these Files are reported here.
+  // This is implemented as a map, with one FileProcessingErrors for each file.
+  // Typically produced when parsing Files, but may also be provided directly
+  // by clients.
+  repeated FileProcessingErrors file_processing_errors = 11;
 }
 
 // If known, represents the state of the user/build-system workspace.
-message WorkspaceContext {}
+message WorkspaceContext {
+
+}
 
 // Describes the workspace under which the tool was invoked, this includes
 // information that was fed into the command, the source code referenced, and
@@ -115,22 +142,25 @@ message CommandLine {
 
 // Attributes that apply to all invocations.
 message InvocationAttributes {
-  // The project ID this invocation is associated with. This must be
-  // set in the CreateInvocation call, and can't be changed.
+  // Immutable. The Cloud Project that owns this invocation (this is different than the
+  // Consumer Cloud Project that calls this API).
+  // This must be set in the CreateInvocation call, and can't be changed.
   string project_id = 1;
 
   // The list of users in the command chain.  The first user in this sequence
-  // is the one who instigated the first command in the chain.
+  // is the one who instigated the first command in the chain. For example,
+  // this might contain just the user that ran a Bazel command, or a robot
+  // that tested a change as part of a CI system. It could also contain the user
+  // that manually triggered a CI test, then the robot that ran the test.
   repeated string users = 2;
 
   // Labels to categorize this invocation.
   // This is implemented as a set. All labels will be unique. Any duplicate
   // labels added will be ignored. Labels will be returned in lexicographical
-  // order. Labels should be short, easy to read, and you
-  // shouldn't have more than a handful.
-  // Labels should match regex \w([- \w]*\w)?
-  // Labels should not be used for unique properties such as unique IDs.
-  // Use properties in cases that don't meet these conditions.
+  // order. Labels should be a list of words describing the Invocation. Labels
+  // should be short, easy to read, and you shouldn't have more than a handful.
+  // Labels should not be used for unique properties such as unique IDs. Use
+  // properties in cases that don't meet these conditions.
   repeated string labels = 3;
 
   // This field describes the overall context or purpose of this invocation.
diff --git a/third_party/googleapis/google/devtools/resultstore/v2/resultstore_download.proto b/third_party/googleapis/google/devtools/resultstore/v2/resultstore_download.proto
index 23f86d754..902f32445 100644
--- a/third_party/googleapis/google/devtools/resultstore/v2/resultstore_download.proto
+++ b/third_party/googleapis/google/devtools/resultstore/v2/resultstore_download.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -19,24 +19,27 @@ package google.devtools.resultstore.v2;
 
 import "google/api/annotations.proto";
 import "google/devtools/resultstore/v2/action.proto";
-import "google/devtools/resultstore/v2/common.proto";
 import "google/devtools/resultstore/v2/configuration.proto";
 import "google/devtools/resultstore/v2/configured_target.proto";
+import "google/devtools/resultstore/v2/download_metadata.proto";
 import "google/devtools/resultstore/v2/file_set.proto";
 import "google/devtools/resultstore/v2/invocation.proto";
 import "google/devtools/resultstore/v2/target.proto";
+import "google/api/client.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/devtools/resultstore/v2;resultstore";
 option java_multiple_files = true;
 option java_package = "com.google.devtools.resultstore.v2";
 
-// This is the interface used to download information from the database.
+// This is the interface used to download information from the ResultStore
+// database.
 //
 // Most APIs require setting a response FieldMask via the 'fields' URL query
 // parameter or the X-Goog-FieldMask HTTP/gRPC header.
-// Each resource in this interface carries a name field that
-// identifies the resource.
 service ResultStoreDownload {
+  option (google.api.default_host) = "resultstore.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Retrieves the invocation with the given name.
   //
   // An error will be reported in the following cases:
@@ -49,19 +52,32 @@ service ResultStoreDownload {
     };
   }
 
-  // Searches for invocations matching the given query parameters.
+  // Searches for invocations matching the given query parameters. Results will
+  // be ordered by timing.start_time with most recent first, but total ordering
+  // of results is not guaranteed when difference in timestamps is very small.
+  // Results may be stale.
   //
   //
   // An error will be reported in the following cases:
   // - If a query string is not provided
   // - If no field mask was given.
-  rpc SearchInvocations(SearchInvocationsRequest)
-      returns (SearchInvocationsResponse) {
+  rpc SearchInvocations(SearchInvocationsRequest) returns (SearchInvocationsResponse) {
     option (google.api.http) = {
       get: "/v2/invocations:search"
     };
   }
 
+  // Retrieves the metadata for an invocation with the given name.
+  //
+  // An error will be reported in the following cases:
+  // - If the invocation is not found.
+  // - If the given invocation name is badly formatted.
+  rpc GetInvocationDownloadMetadata(GetInvocationDownloadMetadataRequest) returns (DownloadMetadata) {
+    option (google.api.http) = {
+      get: "/v2/{name=invocations/*/downloadMetadata}"
+    };
+  }
+
   // Retrieves the configuration with the given name.
   //
   // An error will be reported in the following cases:
@@ -77,13 +93,13 @@ service ResultStoreDownload {
   // Retrieves all configurations for a parent invocation.
   // This might be limited by user or server,
   // in which case a continuation token is provided.
+  // The order in which results are returned is undefined, but stable.
   //
   // An error will be reported in the following cases:
   // - If the parent invocation is not found.
   // - If the given parent invocation name is badly formatted.
   // - If no field mask was given.
-  rpc ListConfigurations(ListConfigurationsRequest)
-      returns (ListConfigurationsResponse) {
+  rpc ListConfigurations(ListConfigurationsRequest) returns (ListConfigurationsResponse) {
     option (google.api.http) = {
       get: "/v2/{parent=invocations/*}/configs"
     };
@@ -103,6 +119,7 @@ service ResultStoreDownload {
 
   // Retrieves all targets for a parent invocation.  This might be limited by
   // user or server, in which case a continuation token is provided.
+  // The order in which results are returned is undefined, but stable.
   //
   // An error will be reported in the following cases:
   // - If the parent is not found.
@@ -120,8 +137,7 @@ service ResultStoreDownload {
   // - If the configured target is not found.
   // - If the given name is badly formatted.
   // - If no field mask was given.
-  rpc GetConfiguredTarget(GetConfiguredTargetRequest)
-      returns (ConfiguredTarget) {
+  rpc GetConfiguredTarget(GetConfiguredTargetRequest) returns (ConfiguredTarget) {
     option (google.api.http) = {
       get: "/v2/{name=invocations/*/targets/*/configuredTargets/*}"
     };
@@ -130,13 +146,13 @@ service ResultStoreDownload {
   // Retrieves all configured targets for a parent invocation/target.
   // This might be limited by user or server, in which case a continuation
   // token is provided.  Supports '-' for targetId meaning all targets.
+  // The order in which results are returned is undefined, but stable.
   //
   // An error will be reported in the following cases:
   // - If the parent is not found.
   // - If the given parent name is badly formatted.
   // - If no field mask was given.
-  rpc ListConfiguredTargets(ListConfiguredTargetsRequest)
-      returns (ListConfiguredTargetsResponse) {
+  rpc ListConfiguredTargets(ListConfiguredTargetsRequest) returns (ListConfiguredTargetsResponse) {
     option (google.api.http) = {
       get: "/v2/{parent=invocations/*/targets/*}/configuredTargets"
     };
@@ -160,6 +176,7 @@ service ResultStoreDownload {
   // actions for all configurations for a target, or '-' for targetId and
   // configurationId to mean all actions for all configurations and all targets.
   // Does not support targetId '-' with a specified configuration.
+  // The order in which results are returned is undefined, but stable.
   //
   // An error will be reported in the following cases:
   // - If the parent is not found.
@@ -186,6 +203,7 @@ service ResultStoreDownload {
   // Retrieves all file sets for a parent invocation.
   // This might be limited by user or server,
   // in which case a continuation token is provided.
+  // The order in which results are returned is undefined, but stable.
   //
   // An error will be reported in the following cases:
   // - If the parent invocation is not found.
@@ -196,6 +214,24 @@ service ResultStoreDownload {
       get: "/v2/{parent=invocations/*}/fileSets"
     };
   }
+
+  // Returns the transitive closure of FileSets. This might be limited by user
+  // or server, in which case a continuation token is provided.
+  // The order in which results are returned is undefined, and unstable.
+  //
+  // An error will be reported in the following cases:
+  // - If page_token is too large to continue the calculation.
+  // - If the resource is not found.
+  // - If the given resource name is badly formatted.
+  // - If no field mask was given.
+  rpc TraverseFileSets(TraverseFileSetsRequest) returns (TraverseFileSetsResponse) {
+    option (google.api.http) = {
+      get: "/v2/{name=invocations/*/fileSets/*}:traverseFileSets"
+      additional_bindings {
+        get: "/v2/{name=invocations/*/targets/*/configuredTargets/*/actions/*}:traverseFileSets"
+      }
+    };
+  }
 }
 
 // Request passed into GetInvocation
@@ -218,15 +254,42 @@ message SearchInvocationsRequest {
     // any.
     string page_token = 2;
 
-    // Absolute number of results to skip.
+    // Absolute number of results to skip. May be rejected if too high.
     int64 offset = 3;
   }
 
   // A filtering query string.
+  //
+  // Only a limited number of fields and operators are supported. Not every
+  // field supports every operator.
+  //
+  // Fields that support equals ("=") restrictions:
+  //
+  // name
+  // status_attributes.status
+  // workspace_info.hostname
+  //
+  // Fields that support contains (":") restrictions:
+  //
+  // invocation_attributes.users
+  // invocation_attributes.labels
+  //
+  // Fields that support comparison ("<", "<=", ">", ">=") restrictions;
+  //
+  // timing.start_time
+  //
+  // Supported custom function global restrictions:
+  //
+  // propertyEquals("key", "value")
   string query = 4;
 
   // The project id to search under.
   string project_id = 5;
+
+  // If true, all equals or contains restrictions on string fields in query will
+  // require exact match. Otherwise, a string field restriction may ignore case
+  // and punctuation.
+  bool exact_match = 7;
 }
 
 // Response from calling SearchInvocations
@@ -240,10 +303,18 @@ message SearchInvocationsResponse {
   string next_page_token = 2;
 }
 
+// Request passed into GetInvocationDownloadMetadata
+message GetInvocationDownloadMetadataRequest {
+  // The name of the download metadata to retrieve. It must match this format:
+  // invocations/${INVOCATION_ID}/downloadMetadata
+  // where INVOCATION_ID must be an RFC 4122-compliant random UUID.
+  string name = 1;
+}
+
 // Request passed into GetConfiguration
 message GetConfigurationRequest {
   // The name of the configuration to retrieve. It must match this format:
-  // invocations/${INVOCATION_ID}/configs/${CONFIGURATION_ID}
+  // invocations/${INVOCATION_ID}/configs/${url_encode(CONFIGURATION_ID)}
   string name = 1;
 }
 
@@ -265,6 +336,11 @@ message ListConfigurationsRequest {
     // Absolute number of results to skip.
     int64 offset = 4;
   }
+
+  // A filter to return only resources that match it.
+  // Any fields used in the filter must be also specified in the field mask.
+  // May cause pages with 0 results and a next_page_token to be returned.
+  string filter = 5;
 }
 
 // Response from calling ListConfigurations
@@ -281,7 +357,7 @@ message ListConfigurationsResponse {
 // Request passed into GetTarget
 message GetTargetRequest {
   // The name of the target to retrieve. It must match this format:
-  // invocations/${INVOCATION_ID}/targets/${TARGET_ID}
+  // invocations/${INVOCATION_ID}/targets/${url_encode(TARGET_ID)}
   string name = 1;
 }
 
@@ -303,6 +379,11 @@ message ListTargetsRequest {
     // Absolute number of results to skip.
     int64 offset = 4;
   }
+
+  // A filter to return only resources that match it.
+  // Any fields used in the filter must be also specified in the field mask.
+  // May cause pages with 0 results and a next_page_token to be returned.
+  string filter = 5;
 }
 
 // Response from calling ListTargetsResponse
@@ -319,7 +400,7 @@ message ListTargetsResponse {
 // Request passed into GetConfiguredTarget
 message GetConfiguredTargetRequest {
   // The name of the configured target to retrieve. It must match this format:
-  // invocations/${INVOCATION_ID}/targets/${TARGET_ID}/configuredTargets/${CONFIGURATION_ID}
+  // invocations/${INVOCATION_ID}/targets/${url_encode(TARGET_ID)}/configuredTargets/${url_encode(CONFIGURATION_ID)}
   string name = 1;
 }
 
@@ -327,7 +408,8 @@ message GetConfiguredTargetRequest {
 message ListConfiguredTargetsRequest {
   // The invocation and target name of the configured targets to retrieve.
   // It must match this format:
-  // invocations/${INVOCATION_ID}/targets/${TARGET_ID}
+  // invocations/${INVOCATION_ID}/targets/${url_encode(TARGET_ID)}
+  // Supports '-' for ${TARGET_ID} meaning all targets.
   string parent = 1;
 
   // The maximum number of items to return.
@@ -342,6 +424,11 @@ message ListConfiguredTargetsRequest {
     // Absolute number of results to skip.
     int64 offset = 4;
   }
+
+  // A filter to return only resources that match it.
+  // Any fields used in the filter must be also specified in the field mask.
+  // May cause pages with 0 results and a next_page_token to be returned.
+  string filter = 5;
 }
 
 // Response from calling ListConfiguredTargets
@@ -358,7 +445,7 @@ message ListConfiguredTargetsResponse {
 // Request passed into GetAction
 message GetActionRequest {
   // The name of the action to retrieve. It must match this format:
-  // invocations/${INVOCATION_ID}/targets/${TARGET_ID}/configuredTargets/${CONFIGURATION_ID}/actions/${ACTION_ID}
+  // invocations/${INVOCATION_ID}/targets/${url_encode(TARGET_ID)}/configuredTargets/${url_encode(CONFIGURATION_ID)}/actions/${url_encode(ACTION_ID)}
   string name = 1;
 }
 
@@ -366,7 +453,11 @@ message GetActionRequest {
 message ListActionsRequest {
   // The invocation, target, and configuration name of the action to retrieve.
   // It must match this format:
-  // invocations/${INVOCATION_ID}/targets/${TARGET_ID}/configuredTargets/${CONFIGURATION_ID}
+  // invocations/${INVOCATION_ID}/targets/${url_encode(TARGET_ID)}/configuredTargets/${url_encode(CONFIGURATION_ID)}
+  // Supports '-' for ${CONFIGURATION_ID} to mean all Actions for all
+  // Configurations for a Target, or '-' for ${TARGET_ID} and
+  // ${CONFIGURATION_ID} to mean all Actions for all Configurations and all
+  // Targets. Does not support ${TARGET_ID} '-' with a specified configuration.
   string parent = 1;
 
   // The maximum number of items to return.
@@ -381,6 +472,11 @@ message ListActionsRequest {
     // Absolute number of results to skip.
     int64 offset = 4;
   }
+
+  // A filter to return only resources that match it.
+  // Any fields used in the filter must be also specified in the field mask.
+  // May cause pages with 0 results and a next_page_token to be returned.
+  string filter = 5;
 }
 
 // Response from calling ListActions
@@ -397,7 +493,7 @@ message ListActionsResponse {
 // Request passed into GetFileSet
 message GetFileSetRequest {
   // The name of the file set to retrieve. It must match this format:
-  // invocations/${INVOCATION_ID}/fileSets/${FILE_SET_ID}
+  // invocations/${INVOCATION_ID}/fileSets/${url_encode(FILE_SET_ID)}
   string name = 1;
 }
 
@@ -419,6 +515,11 @@ message ListFileSetsRequest {
     // Absolute number of results to skip.
     int64 offset = 4;
   }
+
+  // A filter to return only resources that match it.
+  // Any fields used in the filter must be also specified in the field mask.
+  // May cause pages with 0 results and a next_page_token to be returned.
+  string filter = 5;
 }
 
 // Response from calling ListFileSets
@@ -431,3 +532,49 @@ message ListFileSetsResponse {
   // more results in the list.
   string next_page_token = 2;
 }
+
+// Request passed into TraverseFileSets
+message TraverseFileSetsRequest {
+  // The name of the resource to traverse.
+  // It must match one of the following formats:
+  //
+  // invocations/${INVOCATION_ID}/fileSets/${url_encode(FILE_SET_ID)}
+  // This returns the transitive closure of FileSets referenced by the given
+  // FileSet, including itself.
+  //
+  // invocations/${INVOCATION_ID}/targets/${url_encode(TARGET_ID)}/configuredTargets/${url_encode(CONFIGURATION_ID)}/actions/${url_encode(ACTION_ID)}
+  // This returns the transitive closure of FileSets referenced by the given
+  // Action. If ${ACTION_ID} is "-", this returns the transitive closure of
+  // FileSets referenced by all Actions under the given ConfiguredTarget.
+  string name = 1;
+
+  // The maximum number of items to return.
+  // Zero means all, but may be capped by the server.
+  int32 page_size = 2;
+
+  // Options for pagination.
+  oneof page_start {
+    // The next_page_token value returned from a previous List request, if any.
+    // Page tokens will become larger with every page returned, and if a page
+    // token becomes too large, it will no longer be possible to continue to
+    // calculate the transitive dependencies. The API will return a 400
+    // Bad request (HTTPS), or a INVALID_ARGUMENT (gRPC ) when
+    // this happens.
+    string page_token = 3;
+
+    // Absolute number of results to skip.
+    // Not yet implemented. 0 for default.
+    int64 offset = 4;
+  }
+}
+
+// Response from calling TraverseFileSets
+message TraverseFileSetsResponse {
+  // File sets matching the request.
+  // The order in which results are returned is undefined, but stable.
+  repeated FileSet file_sets = 1;
+
+  // Token to retrieve the next page of results, or empty if there are no
+  // more results in the list.
+  string next_page_token = 2;
+}
diff --git a/third_party/googleapis/google/devtools/resultstore/v2/resultstore_file_download.proto b/third_party/googleapis/google/devtools/resultstore/v2/resultstore_file_download.proto
index 5d2c5ec5c..184813eb0 100644
--- a/third_party/googleapis/google/devtools/resultstore/v2/resultstore_file_download.proto
+++ b/third_party/googleapis/google/devtools/resultstore/v2/resultstore_file_download.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,6 +18,7 @@ syntax = "proto3";
 package google.devtools.resultstore.v2;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/devtools/resultstore/v2;resultstore";
 option java_multiple_files = true;
@@ -26,6 +27,9 @@ option java_package = "com.google.devtools.resultstore.v2";
 // This API allows download of File messages referenced in
 // ResultStore resources.
 service ResultStoreFileDownload {
+  option (google.api.default_host) = "resultstore.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Retrieves the File with the given uri.
   // returns a stream of bytes to be stitched together in order.
   //
@@ -70,6 +74,11 @@ message GetFileRequest {
   // error occurred, the stream includes all data from the `read_offset` to the
   // end of the resource.
   int64 read_limit = 3;
+
+  // Only applies if the referenced file is a known archive type (ar, jar, zip)
+  // The above read_offset and read_limit fields are applied to this entry.
+  // If this file is not an archive, INVALID_ARGUMENT is thrown.
+  string archive_entry = 4;
 }
 
 // Response object for GetFile
@@ -96,6 +105,11 @@ message GetFileTailRequest {
   // A `read_limit` of zero indicates that there is no limit, and a negative
   // `read_limit` will cause an error.
   int64 read_limit = 3;
+
+  // Only applies if the referenced file is a known archive type (ar, jar, zip)
+  // The above read_offset and read_limit fields are applied to this entry.
+  // If this file is not an archive, INVALID_ARGUMENT is thrown.
+  string archive_entry = 4;
 }
 
 // Response object for GetFileTail
diff --git a/third_party/googleapis/google/devtools/resultstore/v2/resultstore_upload.proto b/third_party/googleapis/google/devtools/resultstore/v2/resultstore_upload.proto
index 685f17782..85367283c 100644
--- a/third_party/googleapis/google/devtools/resultstore/v2/resultstore_upload.proto
+++ b/third_party/googleapis/google/devtools/resultstore/v2/resultstore_upload.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -24,8 +24,11 @@ import "google/devtools/resultstore/v2/configured_target.proto";
 import "google/devtools/resultstore/v2/file_set.proto";
 import "google/devtools/resultstore/v2/invocation.proto";
 import "google/devtools/resultstore/v2/target.proto";
+import "google/devtools/resultstore/v2/upload_metadata.proto";
+import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
 import "google/protobuf/timestamp.proto";
+import "google/api/client.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/devtools/resultstore/v2;resultstore";
 option java_multiple_files = true;
@@ -33,12 +36,20 @@ option java_package = "com.google.devtools.resultstore.v2";
 
 // This is the interface used to upload information to the ResultStore database,
 // to update that information as necessary, and to make it immutable at the end.
-// Every Update and Append method supports an update_mask field for restricting
-// the affected fields.
+//
+// This interface intentionally does not support user read-modify-write
+// operations. They may corrupt data, and are too expensive. For the same
+// reason, all upload RPCs will return no resource fields except name and ID. An
+// uploader should hold as little state as possible in memory to avoid running
+// out of memory.
 service ResultStoreUpload {
-  // Creates the given invocation. Generally, a unique ID will be assigned to
-  // the invocation's name field by the server. This is not an implicitly
-  // idempotent API, so a request id is required to make it idempotent.
+  option (google.api.default_host) = "resultstore.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
+  // Creates the given invocation.
+  //
+  // This is not an implicitly idempotent API, so a request id is required to
+  // make it idempotent.
   //
   // Returns an empty Invocation proto with only the name and ID fields
   // populated.
@@ -63,7 +74,7 @@ service ResultStoreUpload {
   //
   // An error will be reported in the following cases:
   // - If the invocation does not exist.
-  // - If the invocation is finished.
+  // - If the invocation is finalized.
   // - If no field mask was given.
   rpc UpdateInvocation(UpdateInvocationRequest) returns (Invocation) {
     option (google.api.http) = {
@@ -72,22 +83,73 @@ service ResultStoreUpload {
     };
   }
 
-  // Declares the invocation with the given name as finished and immutable.
-  // This is an implicitly idempotent API.
+  // Applies a merge update to the invocation identified by the given proto's
+  // name.  For primitive and message fields, replaces them with the ones in
+  // the given proto if they are covered under the field mask paths.  For
+  // repeated fields, merges to them with the given ones if they are covered
+  // under the field mask paths. This is not an implicitly idempotent API, so a
+  // request id is required to make it idempotent.
+  //
+  // Returns an empty Invocation proto with only the name and ID fields
+  // populated.
+  //
+  //
+  // An error will be reported in the following cases:
+  // - If the invocation does not exist.
+  // - If the invocation is finalized.
+  // - If no field mask was given.
+  rpc MergeInvocation(MergeInvocationRequest) returns (Invocation) {
+    option (google.api.http) = {
+      post: "/v2/{invocation.name=invocations/*}:merge"
+      body: "*"
+    };
+  }
+
+  // Touches the invocation identified by the given proto's name.
+  //
+  // This is useful when you need to notify ResultStore that you haven't
+  // abandoned the upload, since abandoned uploads will be automatically
+  // finalized after a set period.
+  //
+  // An error will be reported in the following cases:
+  // - If the invocation does not exist.
+  // - If the invocation is finalized.
+  rpc TouchInvocation(TouchInvocationRequest) returns (TouchInvocationResponse) {
+    option (google.api.http) = {
+      post: "/v2/{name=invocations/*}:touch"
+      body: "*"
+    };
+  }
+
+  // Declares the invocation with the given name as finalized and immutable by
+  // the user. It may still be mutated by post-processing. This is an implicitly
+  // idempotent API.
   //
   // If an Invocation is not updated for 24 hours, some time after that
   // this will be called automatically.
   //
   // An error will be reported in the following cases:
   // - If the invocation does not exist.
-  rpc FinishInvocation(FinishInvocationRequest)
-      returns (FinishInvocationResponse) {
+  rpc FinalizeInvocation(FinalizeInvocationRequest) returns (FinalizeInvocationResponse) {
     option (google.api.http) = {
-      post: "/v2/{name=invocations/*}:finish"
+      post: "/v2/{name=invocations/*}:finalize"
       body: "*"
     };
   }
 
+  // Deletes an immutable invocation (permanently)
+  // Note: this does not delete indirect data, e.g. files stored in other
+  // services.
+  //
+  // An error will be reported in the following cases:
+  // - If the invocation does not exist.
+  // - If the invocation is not finalized.  This can be retried until it is.
+  rpc DeleteInvocation(DeleteInvocationRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v2/{name=invocations/*}"
+    };
+  }
+
   // Creates the given target under the given parent invocation. The given
   // target ID is URL encoded, converted to the full resource name, and assigned
   // to the target's name field. This is not an implicitly idempotent API, so a
@@ -98,7 +160,7 @@ service ResultStoreUpload {
   // An error will be reported in the following cases:
   // - If no target ID is provided.
   // - If the parent invocation does not exist.
-  // - If the parent invocation is finished.
+  // - If the parent invocation is finalized.
   // - If a target with the same name already exists.
   rpc CreateTarget(CreateTargetRequest) returns (Target) {
     option (google.api.http) = {
@@ -117,7 +179,7 @@ service ResultStoreUpload {
   //
   // An error will be reported in the following cases:
   // - If the target does not exist.
-  // - If the target or parent invocation is finished.
+  // - If the target or parent invocation is finalized.
   // - If no field mask was given.
   rpc UpdateTarget(UpdateTargetRequest) returns (Target) {
     option (google.api.http) = {
@@ -126,14 +188,36 @@ service ResultStoreUpload {
     };
   }
 
-  // Declares the target with the given name as finished and immutable.
-  // This is an implicitly idempotent API.
+  // Applies a merge update to the target identified by the given proto's
+  // name. For primitive and message fields, replaces them with the ones in the
+  // given proto if they are covered under the field mask paths.  For repeated
+  // fields, merges to them with the given ones if they are covered under the
+  // field mask paths. This is not an implicitly idempotent API, so a request
+  // id is required to make it idempotent.
+  //
+  // Returns an empty Target proto with only the name and ID fields populated.
+  //
+  //
+  // An error will be reported in the following cases:
+  // - If the target does not exist.
+  // - If the target or parent invocation is finalized.
+  // - If no field mask was given.
+  rpc MergeTarget(MergeTargetRequest) returns (Target) {
+    option (google.api.http) = {
+      post: "/v2/{target.name=invocations/*/targets/*}:merge"
+      body: "*"
+    };
+  }
+
+  // Declares the target with the given name as finalized and immutable by the
+  // user. It may still be mutated by post-processing. This is an implicitly
+  // idempotent API.
   //
   // An error will be reported in the following cases:
   // - If the target does not exist.
-  rpc FinishTarget(FinishTargetRequest) returns (FinishTargetResponse) {
+  rpc FinalizeTarget(FinalizeTargetRequest) returns (FinalizeTargetResponse) {
     option (google.api.http) = {
-      post: "/v2/{name=invocations/*/targets/*}:finish"
+      post: "/v2/{name=invocations/*/targets/*}:finalize"
       body: "*"
     };
   }
@@ -151,9 +235,8 @@ service ResultStoreUpload {
   // - If no config ID is provided.
   // - If a configured target with the same ID already exists.
   // - If the parent target does not exist.
-  // - If the parent target or invocation is finished.
-  rpc CreateConfiguredTarget(CreateConfiguredTargetRequest)
-      returns (ConfiguredTarget) {
+  // - If the parent target or invocation is finalized.
+  rpc CreateConfiguredTarget(CreateConfiguredTargetRequest) returns (ConfiguredTarget) {
     option (google.api.http) = {
       post: "/v2/{parent=invocations/*/targets/*}/configuredTargets"
       body: "configured_target"
@@ -171,25 +254,46 @@ service ResultStoreUpload {
   //
   // An error will be reported in the following cases:
   // - If the configured target does not exist.
-  // - If the parent target or invocation is finished.
+  // - If the parent target or invocation is finalized.
   // - If no field mask was given.
-  rpc UpdateConfiguredTarget(UpdateConfiguredTargetRequest)
-      returns (ConfiguredTarget) {
+  rpc UpdateConfiguredTarget(UpdateConfiguredTargetRequest) returns (ConfiguredTarget) {
     option (google.api.http) = {
       patch: "/v2/{configured_target.name=invocations/*/targets/*/configuredTargets/*}"
       body: "configured_target"
     };
   }
 
-  // Declares the configured target with the given name as finished and
-  // immutable. This is an implicitly idempotent API.
+  // Applies a merge update to the configured target identified by the given
+  // proto's name. For primitive and message fields, replaces them with the
+  // ones in the given proto if they are covered under the field mask paths.
+  // For repeated fields, merges to them with the given ones if they are
+  // covered under the field mask paths. This is not an implicitly idempotent
+  // API, so a request id is required to make it idempotent.
+  //
+  // Returns an empty ConfiguredTarget proto with only the name and ID fields
+  // populated.
+  //
+  //
+  // An error will be reported in the following cases:
+  // - If the configured target does not exist.
+  // - If the parent target or invocation is finalized.
+  // - If no field mask was given.
+  rpc MergeConfiguredTarget(MergeConfiguredTargetRequest) returns (ConfiguredTarget) {
+    option (google.api.http) = {
+      post: "/v2/{configured_target.name=invocations/*/targets/*/configuredTargets/*}:merge"
+      body: "*"
+    };
+  }
+
+  // Declares the configured target with the given name as finalized and
+  // immutable by the user. It may still be mutated by post-processing. This is
+  // an implicitly idempotent API.
   //
   // An error will be reported in the following cases:
   // - If the configured target does not exist.
-  rpc FinishConfiguredTarget(FinishConfiguredTargetRequest)
-      returns (FinishConfiguredTargetResponse) {
+  rpc FinalizeConfiguredTarget(FinalizeConfiguredTargetRequest) returns (FinalizeConfiguredTargetResponse) {
     option (google.api.http) = {
-      post: "/v2/{name=invocations/*/targets/*/configuredTargets/*}:finish"
+      post: "/v2/{name=invocations/*/targets/*/configuredTargets/*}:finalize"
       body: "*"
     };
   }
@@ -204,7 +308,7 @@ service ResultStoreUpload {
   // An error will be reported in the following cases:
   // - If no action ID provided.
   // - If the parent configured target does not exist.
-  // - If the parent target or invocation is finished.
+  // - If the parent target or invocation is finalized.
   // - If an action  with the same name already exists.
   rpc CreateAction(CreateActionRequest) returns (Action) {
     option (google.api.http) = {
@@ -223,7 +327,7 @@ service ResultStoreUpload {
   //
   // An error will be reported in the following cases:
   // - If the action does not exist.
-  // - If the parent target or invocation is finished.
+  // - If the parent target or invocation is finalized.
   // - If no field mask was given.
   rpc UpdateAction(UpdateActionRequest) returns (Action) {
     option (google.api.http) = {
@@ -232,6 +336,27 @@ service ResultStoreUpload {
     };
   }
 
+  // Applies a merge update to the action identified by the given
+  // proto's name.  For primitive and message fields, replaces them with the
+  // ones in the given proto if they are covered under the field mask paths.
+  // For repeated fields, merges to them with the given ones if they are
+  // covered under the field mask paths. This is not an implicitly idempotent
+  // API, so a request id is required to make it idempotent.
+  //
+  // Returns an empty Action proto with only the name and ID fields populated.
+  //
+  //
+  // An error will be reported in the following cases:
+  // - If the action does not exist.
+  // - If the parent target or invocation is finalized.
+  // - If no field mask was given.
+  rpc MergeAction(MergeActionRequest) returns (Action) {
+    option (google.api.http) = {
+      post: "/v2/{action.name=invocations/*/targets/*/configuredTargets/*/actions/*}:merge"
+      body: "*"
+    };
+  }
+
   // Creates the given configuration under the given parent invocation. The
   // given configuration ID is URL encoded, converted to the full resource name,
   // and assigned to the configuration's name field. The configuration ID of
@@ -245,7 +370,7 @@ service ResultStoreUpload {
   // An error will be reported in the following cases:
   // - If no configuration ID is provided.
   // - If the parent invocation does not exist.
-  // - If the parent invocation is finished.
+  // - If the parent invocation is finalized.
   // - If a configuration with the same name already exists.
   rpc CreateConfiguration(CreateConfigurationRequest) returns (Configuration) {
     option (google.api.http) = {
@@ -265,7 +390,7 @@ service ResultStoreUpload {
   //
   // An error will be reported in the following cases:
   // - If the configuration does not exist.
-  // - If the parent invocation is finished.
+  // - If the parent invocation is finalized.
   // - If no field mask was given.
   // - If a given field mask path is not valid.
   rpc UpdateConfiguration(UpdateConfigurationRequest) returns (Configuration) {
@@ -286,7 +411,7 @@ service ResultStoreUpload {
   // - If no file set ID is provided.
   // - If a file set with the same name already exists.
   // - If the parent invocation does not exist.
-  // - If the parent invocation is finished.
+  // - If the parent invocation is finalized.
   rpc CreateFileSet(CreateFileSetRequest) returns (FileSet) {
     option (google.api.http) = {
       post: "/v2/{parent=invocations/*}/fileSets"
@@ -304,7 +429,7 @@ service ResultStoreUpload {
   //
   // An error will be reported in the following cases:
   // - If the file set does not exist.
-  // - If the parent invocation is finished.
+  // - If the parent invocation is finalized.
   // - If no field mask was given.
   // - If a given field mask path is not valid.
   rpc UpdateFileSet(UpdateFileSetRequest) returns (FileSet) {
@@ -313,6 +438,61 @@ service ResultStoreUpload {
       body: "file_set"
     };
   }
+
+  // Applies a merge update to the file set identified by the given proto's
+  // name. For primitive and message fields, updates them with the ones in the
+  // given proto if they are covered under the field mask paths. For repeated
+  // fields, merges to them with the given ones if they are covered under the
+  // field mask paths. This is not an implicitly idempotent API, so a request
+  // id is required to make it idempotent.
+  //
+  // Returns an empty FileSet proto with only the name and ID fields populated.
+  //
+  //
+  // An error will be reported in the following cases:
+  // - If the file set does not exist.
+  // - If the parent invocation is finalized.
+  // - If a given field mask path is not valid.
+  // - If no field mask was given.
+  rpc MergeFileSet(MergeFileSetRequest) returns (FileSet) {
+    option (google.api.http) = {
+      post: "/v2/{file_set.name=invocations/*/fileSets/*}:merge"
+      body: "*"
+    };
+  }
+
+  // This is the RPC used for batch upload. It supports uploading multiple
+  // resources for an invocation in a transaction safe manner.
+  //
+  // To use this RPC, the CreateInvocationRequest must have been provided a
+  // resume_token.
+  //
+  // Combining batch upload with normal upload on a single Invocation is not
+  // supported. If an Invocation is created with a resume_token, all further
+  // calls must be through UploadBatch. If an Invocation is created without
+  // resume_token normal upload, all further upload calls must be through normal
+  // upload RPCs.
+  rpc UploadBatch(UploadBatchRequest) returns (UploadBatchResponse) {
+    option (google.api.http) = {
+      post: "/v2/{parent=invocations/*}/batch:upload"
+      body: "*"
+    };
+  }
+
+  // Provides a way to read the metadata for an invocation.
+  // The UploadMetadata could still be retrieved by this RPC even the Invocation
+  // has been finalized.
+  // This API requires setting a response FieldMask via 'fields' URL query
+  // parameter or X-Goog-FieldMask HTTP/gRPC header.
+  //
+  // An error will be reported in the following case:
+  // - If the invocation does not exist.
+  // - If no field mask was given.
+  rpc GetInvocationUploadMetadata(GetInvocationUploadMetadataRequest) returns (UploadMetadata) {
+    option (google.api.http) = {
+      get: "/v2/{name=invocations/*/uploadMetadata}"
+    };
+  }
 }
 
 // Request passed into CreateInvocation
@@ -322,12 +502,14 @@ message CreateInvocationRequest {
   // for the operation to be idempotent. This is achieved by ignoring this
   // request if the last successful operation on the resource had the same
   // request ID. If set, invocation_id must also be provided.
-  // Restricted to 36 utf-8 bytes.
+  // Restricted to 36 Unicode characters.
   string request_id = 1;
 
-  // The invocation ID.  If left empty then a new unique ID will be
-  // assigned by the server. If populated, a RFC 4122-compliant v4 UUID is
-  // preferred, but v3 or v5 UUIDs are allowed too.
+  // The invocation ID. It is optional, but strongly recommended.
+  //
+  // If left empty then a new unique ID will be assigned by the server. If
+  // populated, a RFC 4122-compliant v4 UUID is preferred, but v3 or v5 UUIDs
+  // are allowed too.
   string invocation_id = 2;
 
   // The invocation to create.  Its name field will be ignored, since the name
@@ -348,10 +530,42 @@ message CreateInvocationRequest {
   // a "password" to the invocation.
   string authorization_token = 4;
 
-  // By default, Invocations are auto-finished if they are not modified for 24
-  // hours. If you need auto-finish to happen sooner, set this field to the time
-  // you'd like auto-finish to occur.
-  google.protobuf.Timestamp auto_finish_time = 5;
+  // By default, Invocations are auto-finalized if they are not modified for 24
+  // hours. If you need auto-finalize to happen sooner, set this field to the
+  // time you'd like auto-finalize to occur.
+  google.protobuf.Timestamp auto_finalize_time = 6;
+
+  // Client provided unique token for batch upload to ensure data integrity and
+  // to provide a way to resume batch upload in case of a distributed failure on
+  // the client side. The standard uploading client is presumed to have many
+  // machines uploading to ResultStore, and that any given machine could process
+  // any given Invocation at any time. This field is used to coordinate between
+  // the client's machines, resolve concurrency issues, and enforce "exactly
+  // once" semantics on each batch within the upload.
+  //
+  // The typical usage of the resume_token is that it should contain a "key"
+  // indicating to the client where it is in the upload process, so that the
+  // client can use it to resume the upload by reconstructing the state of
+  // upload from the point where it was interrupted.
+  //
+  // If this matches the previously uploaded resume_token, then this request
+  // will silently do nothing, making CreateInvocation idempotent.
+  // If this token is provided, all further upload RPCs must be done through
+  // UploadBatch. This token must not be combined with request_id.
+  // Must be web safe Base64 encoded bytes.
+  string initial_resume_token = 7;
+
+  // Client-specific data used to resume batch upload if an error occurs and
+  // retry is needed. This serves a role closely related to resume_token, as
+  // both fields may be used to provide state required to restore a Batch
+  // Upload, but they differ in two important aspects:
+  //  - it is not compared to previous values, and as such does not provide
+  //    concurrency control;
+  //  - it allows for a larger payload, since the contents are never
+  //    inspected/compared;
+  // The size of the message must be within 1 MiB. Too large requests will be
+  // rejected.
+  bytes uploader_state = 8;
 }
 
 // Request passed into UpdateInvocation
@@ -368,8 +582,57 @@ message UpdateInvocationRequest {
   string authorization_token = 5;
 }
 
-// Request passed into FinishInvocation
-message FinishInvocationRequest {
+// Request passed into MergeInvocation
+message MergeInvocationRequest {
+  // A unique identifier for this request. Must be set to a different value for
+  // each request that affects a given resource (eg. a random UUID). Required
+  // for the operation to be idempotent. This is achieved by ignoring this
+  // request if the last successful operation on the resource had the same
+  // request ID.  Restricted to 36 Unicode characters.
+  string request_id = 1;
+
+  // Contains the name and the fields of the invocation to be merged.  The
+  // name format must be: invocations/${INVOCATION_ID}
+  Invocation invocation = 3;
+
+  // Indicates which fields to merge.
+  google.protobuf.FieldMask update_mask = 4;
+
+  // This is a token to authorize access to this invocation. It must be set to
+  // the same value that was provided in the CreateInvocationRequest.
+  string authorization_token = 5;
+}
+
+// Request passed into TouchInvocation
+message TouchInvocationRequest {
+  // The name of the invocation.  Its format must be:
+  // invocations/${INVOCATION_ID}
+  string name = 1;
+
+  // This is a token to authorize access to this invocation. It must be set to
+  // the same value that was provided in the CreateInvocationRequest.
+  string authorization_token = 2;
+}
+
+// Response returned from TouchInvocation
+message TouchInvocationResponse {
+  // The name of the invocation.  Its format will be:
+  // invocations/${INVOCATION_ID}
+  string name = 1;
+
+  // The resource ID components that identify the Invocation.
+  Invocation.Id id = 2;
+}
+
+// Request passed into DeleteInvocation
+message DeleteInvocationRequest {
+  // The name of the invocation.  Its format must be:
+  // invocations/${INVOCATION_ID}
+  string name = 1;
+}
+
+// Request passed into FinalizeInvocation
+message FinalizeInvocationRequest {
   // The name of the invocation.  Its format must be:
   // invocations/${INVOCATION_ID}
   string name = 1;
@@ -379,8 +642,8 @@ message FinishInvocationRequest {
   string authorization_token = 3;
 }
 
-// Response returned from FinishInvocation
-message FinishInvocationResponse {
+// Response returned from FinalizeInvocation
+message FinalizeInvocationResponse {
   // The name of the invocation.  Its format will be:
   // invocations/${INVOCATION_ID}
   string name = 1;
@@ -395,15 +658,15 @@ message CreateTargetRequest {
   // each request that affects a given resource (eg. a random UUID). Required
   // for the operation to be idempotent. This is achieved by ignoring this
   // request if the last successful operation on the resource had the same
-  // request ID.  Restricted to 36 utf-8 bytes.
+  // request ID.  Restricted to 36 Unicode characters.
   string request_id = 1;
 
   // The name of the parent invocation in which the target is created.
   // Its format must be invocations/${INVOCATION_ID}
   string parent = 2;
 
-  // The target identifier.  It can be any UTF-8 string up to 1024 bytes long
-  // except for the reserved id '-'.
+  // The target identifier.  It can be any string up to 1024 Unicode characters
+  // long except for the reserved id '-'.
   string target_id = 3;
 
   // The target to create.  Its name field will be ignored, since the name will
@@ -418,7 +681,8 @@ message CreateTargetRequest {
 // Request passed into UpdateTarget
 message UpdateTargetRequest {
   // Contains the name and the fields of the target to be updated.  The name
-  // format must be: invocations/${INVOCATION_ID}/targets/${TARGET_ID}
+  // format must be:
+  // invocations/${INVOCATION_ID}/targets/${url_encode(TARGET_ID)}
   Target target = 3;
 
   // Indicates which fields to update.
@@ -427,12 +691,42 @@ message UpdateTargetRequest {
   // This is a token to authorize access to this invocation. It must be set to
   // the same value that was provided in the CreateInvocationRequest.
   string authorization_token = 5;
+
+  // If true then the Update operation will become a Create operation if the
+  // Target is NOT_FOUND.
+  bool create_if_not_found = 6;
 }
 
-// Request passed into FinishTarget
-message FinishTargetRequest {
+// Request passed into MergeTarget
+message MergeTargetRequest {
+  // A unique identifier for this request. Must be set to a different value for
+  // each request that affects a given resource (eg. a random UUID). Required
+  // for the operation to be idempotent. This is achieved by ignoring this
+  // request if the last successful operation on the resource had the same
+  // request ID.  Restricted to 36 Unicode characters.
+  string request_id = 1;
+
+  // Contains the name and the fields of the target to be merged.  The name
+  // format must be:
+  // invocations/${INVOCATION_ID}/targets/${url_encode(TARGET_ID)}
+  Target target = 3;
+
+  // Indicates which fields to merge.
+  google.protobuf.FieldMask update_mask = 4;
+
+  // This is a token to authorize access to this invocation. It must be set to
+  // the same value that was provided in the CreateInvocationRequest.
+  string authorization_token = 5;
+
+  // If true then the Merge operation will become a Create operation if the
+  // Target is NOT_FOUND.
+  bool create_if_not_found = 6;
+}
+
+// Request passed into FinalizeTarget
+message FinalizeTargetRequest {
   // The name of the target.  Its format must be:
-  // invocations/${INVOCATION_ID}/targets/${TARGET_ID}
+  // invocations/${INVOCATION_ID}/targets/${url_encode(TARGET_ID)}
   string name = 1;
 
   // This is a token to authorize access to this invocation. It must be set to
@@ -440,10 +734,10 @@ message FinishTargetRequest {
   string authorization_token = 3;
 }
 
-// Response returned from FinishTarget
-message FinishTargetResponse {
+// Response returned from FinalizeTarget
+message FinalizeTargetResponse {
   // The name of the target.  Its format will be:
-  // invocations/${INVOCATION_ID}/targets/${TARGET_ID}
+  // invocations/${INVOCATION_ID}/targets/${url_encode(TARGET_ID)}
   string name = 1;
 
   // The resource ID components that identify the Target.
@@ -456,12 +750,12 @@ message CreateConfiguredTargetRequest {
   // each request that affects a given resource (eg. a random UUID). Required
   // for the operation to be idempotent. This is achieved by ignoring this
   // request if the last successful operation on the resource had the same
-  // request ID.  Restricted to 36 utf-8 bytes.
+  // request ID.  Restricted to 36 Unicode characters.
   string request_id = 1;
 
   // The name of the parent target in which the configured target is created.
   // Its format must be:
-  // invocations/${INVOCATION_ID}/targets/${TARGET_ID}
+  // invocations/${INVOCATION_ID}/targets/${url_encode(TARGET_ID)}
   string parent = 2;
 
   // The configuration identifier. This must match the ID of an existing
@@ -481,7 +775,7 @@ message CreateConfiguredTargetRequest {
 message UpdateConfiguredTargetRequest {
   // Contains the name and the fields of the configured target to be updated.
   // The name format must be:
-  // invocations/${INVOCATION_ID}/targets/${TARGET_ID}/configuredTargets/${CONFIG_ID}
+  // invocations/${INVOCATION_ID}/targets/${url_encode(TARGET_ID)}/configuredTargets/${url_encode(CONFIG_ID)}
   ConfiguredTarget configured_target = 3;
 
   // Indicates which fields to update.
@@ -490,12 +784,42 @@ message UpdateConfiguredTargetRequest {
   // This is a token to authorize access to this invocation. It must be set to
   // the same value that was provided in the CreateInvocationRequest.
   string authorization_token = 5;
+
+  // If true then the Update operation will become a Create operation if the
+  // ConfiguredTarget is NOT_FOUND.
+  bool create_if_not_found = 6;
 }
 
-// Request passed into FinishConfiguredTarget
-message FinishConfiguredTargetRequest {
+// Request passed into MergeConfiguredTarget
+message MergeConfiguredTargetRequest {
+  // A unique identifier for this request. Must be set to a different value for
+  // each request that affects a given resource (eg. a random UUID). Required
+  // for the operation to be idempotent. This is achieved by ignoring this
+  // request if the last successful operation on the resource had the same
+  // request ID.  Restricted to 36 Unicode characters.
+  string request_id = 1;
+
+  // Contains the name and the fields of the configured target to be merged.
+  // The name format must be:
+  // invocations/${INVOCATION_ID}/targets/${url_encode(TARGET_ID)}/configuredTargets/${url_encode(CONFIG_ID)}
+  ConfiguredTarget configured_target = 3;
+
+  // Indicates which fields to merge.
+  google.protobuf.FieldMask update_mask = 4;
+
+  // This is a token to authorize access to this invocation. It must be set to
+  // the same value that was provided in the CreateInvocationRequest.
+  string authorization_token = 5;
+
+  // If true then the Merge operation will become a Create operation if the
+  // ConfiguredTarget is NOT_FOUND.
+  bool create_if_not_found = 6;
+}
+
+// Request passed into FinalizeConfiguredTarget
+message FinalizeConfiguredTargetRequest {
   // The name of the configured target. Its format must be:
-  // invocations/${INVOCATION_ID}/targets/${TARGET_ID}/configuredTargets/${CONFIG_ID}
+  // invocations/${INVOCATION_ID}/targets/${url_encode(TARGET_ID)}/configuredTargets/${url_encode(CONFIG_ID)}
   string name = 1;
 
   // This is a token to authorize access to this invocation. It must be set to
@@ -503,10 +827,10 @@ message FinishConfiguredTargetRequest {
   string authorization_token = 3;
 }
 
-// Response returned from FinishConfiguredTarget
-message FinishConfiguredTargetResponse {
+// Response returned from FinalizeConfiguredTarget
+message FinalizeConfiguredTargetResponse {
   // The name of the configured target. Its format must be:
-  // invocations/${INVOCATION_ID}/targets/${TARGET_ID}/configuredTargets/${CONFIG_ID}
+  // invocations/${INVOCATION_ID}/targets/${url_encode(TARGET_ID)}/configuredTargets/${url_encode(CONFIG_ID)}
   string name = 1;
 
   // The resource ID components that identify the ConfiguredTarget.
@@ -519,16 +843,24 @@ message CreateActionRequest {
   // each request that affects a given resource (eg. a random UUID). Required
   // for the operation to be idempotent. This is achieved by ignoring this
   // request if the last successful operation on the resource had the same
-  // request ID.  Restricted to 36 utf-8 bytes.
+  // request ID.  Restricted to 36 Unicode characters.
   string request_id = 1;
 
   // The name of the parent configured target in which the action is created.
   // Its format must be:
-  // invocations/${INVOCATION_ID}/targets/${TARGET_ID}/configuredTargets/${CONFIG_ID}
+  // invocations/${INVOCATION_ID}/targets/${url_encode(TARGET_ID)}/configuredTargets/${url_encode(CONFIG_ID)}
   string parent = 2;
 
-  // The action identifier. It can be any UTF-8 string up to 512 bytes long,
-  // except for the reserved id '-'.
+  // The action identifier. It can be any string up to 512 Unicode characters
+  // long, except for the reserved id '-'.
+  //
+  // Recommended IDs for Test Actions:
+  // "test": For a single test action.
+  // "test_shard0_run0_attempt0" ... "test_shard9_run9_attempt9": For tests with
+  //  shard/run/attempts.
+  //
+  // Recommended IDs for Build Actions:
+  // "build": If you only have a single build action.
   string action_id = 3;
 
   // The action to create.  Its name field will be ignored, since the
@@ -544,7 +876,7 @@ message CreateActionRequest {
 message UpdateActionRequest {
   // Contains the name and the fields of the action to be updated.  The
   // name format must be:
-  // invocations/${INVOCATION_ID}/targets/${TARGET_ID}/configuredTargets/${CONFIG_ID}/actions/${ACTION_ID}
+  // invocations/${INVOCATION_ID}/targets/${url_encode(TARGET_ID)}/configuredTargets/${url_encode(CONFIG_ID)}/actions/${url_encode(ACTION_ID)}
   Action action = 3;
 
   // Indicates which fields to update.
@@ -553,6 +885,36 @@ message UpdateActionRequest {
   // This is a token to authorize access to this invocation. It must be set to
   // the same value that was provided in the CreateInvocationRequest.
   string authorization_token = 5;
+
+  // If true then the Update operation will become a Create operation if the
+  // Action is NOT_FOUND.
+  bool create_if_not_found = 6;
+}
+
+// Request passed into MergeAction
+message MergeActionRequest {
+  // A unique identifier for this request. Must be set to a different value for
+  // each request that affects a given resource (eg. a random UUID). Required
+  // for the operation to be idempotent. This is achieved by ignoring this
+  // request if the last successful operation on the resource had the same
+  // request ID.  Restricted to 36 Unicode characters.
+  string request_id = 1;
+
+  // Contains the name and the fields of the action to be merged.  The
+  // name format must be:
+  // invocations/${INVOCATION_ID}/targets/${url_encode(TARGET_ID)}/configuredTargets/${url_encode(CONFIG_ID)}/actions/${url_encode(ACTION_ID)}
+  Action action = 3;
+
+  // Indicates which fields to merge.
+  google.protobuf.FieldMask update_mask = 4;
+
+  // This is a token to authorize access to this invocation. It must be set to
+  // the same value that was provided in the CreateInvocationRequest.
+  string authorization_token = 5;
+
+  // If true then the Merge operation will become a Create operation if the
+  // Action is NOT_FOUND.
+  bool create_if_not_found = 6;
 }
 
 // Request passed into CreateConfiguration
@@ -561,16 +923,17 @@ message CreateConfigurationRequest {
   // each request that affects a given resource (eg. a random UUID). Required
   // for the operation to be idempotent. This is achieved by ignoring this
   // request if the last successful operation on the resource had the same
-  // request ID.  Restricted to 36 utf-8 bytes.
+  // request ID.  Restricted to 36 Unicode characters.
   string request_id = 1;
 
   // The name of the parent invocation in which the configuration is created.
   // Its format must be invocations/${INVOCATION_ID}
   string parent = 2;
 
-  // The configuration identifier. It can be any UTF-8 string up to 256 bytes
-  // long. The configuration ID of "default" should be preferred for the default
-  // configuration in a single-config invocation. Cannot be the reserved id '-'.
+  // The configuration identifier. It can be any string up to 256 Unicode
+  // characters long. The configuration ID of "default" should be preferred for
+  // the default configuration in a single-config invocation. Cannot be the
+  // reserved id '-'.
   string config_id = 3;
 
   // The configuration to create. Its name field will be ignored, since the name
@@ -585,7 +948,8 @@ message CreateConfigurationRequest {
 // Request passed into UpdateConfiguration
 message UpdateConfigurationRequest {
   // Contains the name and fields of the configuration to be updated. The name
-  // format must be: invocations/${INVOCATION_ID}/configs/${CONFIG_ID}
+  // format must be:
+  // invocations/${INVOCATION_ID}/configs/${url_encode(CONFIG_ID)}
   Configuration configuration = 3;
 
   // Indicates which fields to update.
@@ -594,6 +958,10 @@ message UpdateConfigurationRequest {
   // This is a token to authorize access to this invocation. It must be set to
   // the same value that was provided in the CreateInvocationRequest.
   string authorization_token = 5;
+
+  // If true then the Update operation will become a Create operation if the
+  // Configuration is NOT_FOUND.
+  bool create_if_not_found = 6;
 }
 
 // Request passed into CreateFileSet
@@ -602,14 +970,15 @@ message CreateFileSetRequest {
   // each request that affects a given resource (eg. a random UUID). Required
   // for the operation to be idempotent. This is achieved by ignoring this
   // request if the last successful operation on the resource had the same
-  // request ID.  Restricted to 36 utf-8 bytes.
+  // request ID.  Restricted to 36 Unicode characters.
   string request_id = 1;
 
   // The name of the parent invocation in which the file set is created.
   // Its format must be invocations/${INVOCATION_ID}
   string parent = 2;
 
-  // The file set identifier. It can be any UTF-8 string up to 256 bytes long.
+  // The file set identifier. It can be any string up to 256 Unicode characters
+  // long.
   string file_set_id = 3;
 
   // The file set to create. Its name field will be ignored, since the name will
@@ -624,7 +993,7 @@ message CreateFileSetRequest {
 // Request passed into UpdateFileSet
 message UpdateFileSetRequest {
   // Contains the name and fields of the file set to be updated. The name format
-  // must be: invocations/${INVOCATION_ID}/fileSets/${FILE_SET_ID}
+  // must be: invocations/${INVOCATION_ID}/fileSets/${url_encode(FILE_SET_ID)}
   FileSet file_set = 1;
 
   // Indicates which fields to update.
@@ -633,4 +1002,195 @@ message UpdateFileSetRequest {
   // This is a token to authorize access to this invocation. It must be set to
   // the same value that was provided in the CreateInvocationRequest.
   string authorization_token = 3;
+
+  // If true then the Update operation will become a Create operation if the
+  // FileSet is NOT_FOUND.
+  bool create_if_not_found = 4;
+}
+
+// Request passed into MergeFileSet
+message MergeFileSetRequest {
+  // A unique identifier for this request. Must be set to a different value for
+  // each request that affects a given resource (eg. a random UUID). Required
+  // for the operation to be idempotent. This is achieved by ignoring this
+  // request if the last successful operation on the resource had the same
+  // request ID.  Restricted to 36 Unicode characters.
+  string request_id = 1;
+
+  // Contains the name and fields of the file set to be merged. The name
+  // format must be:
+  // invocations/${INVOCATION_ID}/fileSets/${url_encode(FILE_SET_ID)}
+  FileSet file_set = 2;
+
+  // Indicates which fields to merge.
+  google.protobuf.FieldMask update_mask = 3;
+
+  // This is a token to authorize access to this invocation. It must be set to
+  // the same value that was provided in the CreateInvocationRequest.
+  string authorization_token = 4;
+
+  // If true then the Merge operation will become a Create operation if the
+  // FileSet is NOT_FOUND.
+  bool create_if_not_found = 5;
+}
+
+// Request passed into UploadBatch
+message UploadBatchRequest {
+  // Required. The name of the invocation being modified.
+  // The name format must be: invocations/${INVOCATION_ID}
+  string parent = 1;
+
+  // Required. A UUID that must match the value provided in CreateInvocationRequest.
+  string authorization_token = 2;
+
+  // Required. The token of this batch, that will be committed in this UploadBatchRequest.
+  // If this matches the previously uploaded resume_token, then this request
+  // will silently do nothing.
+  // See CreateInvocationRequest.initial_resume_token for more information.
+  // Must be web safe Base64 encoded bytes.
+  string next_resume_token = 3;
+
+  // Required. The token of the previous batch that was committed in a UploadBatchRequest.
+  // This will be checked after next_resume_token match is checked. If this does
+  // not match the previously uploaded resume_token, a 409 Conflict (HTTPS) or
+  // ABORTED (gRPC ) error code indicating a concurrency
+  // failure will be returned, and that the user should call
+  // GetInvocationUploadMetadata to fetch the current resume_token to
+  // reconstruct the state of the upload to resume it.
+  // See CreateInvocationRequest.initial_resume_token for more information.
+  // Must be web safe Base64 encoded bytes.
+  string resume_token = 4;
+
+  // Client-specific data used to resume batch upload if an error occurs and
+  // retry is needed. This serves a role closely related to resume_token, as
+  // both fields may be used to provide state required to restore a Batch
+  // Upload, but they differ in two important aspects:
+  //  - it is not compared to previous values, and as such does not provide
+  //    concurrency control;
+  //  - it allows for a larger payload, since the contents are never
+  //    inspected/compared;
+  // The size of the message must be within 1 MiB. Too large requests will be
+  // rejected.
+  bytes uploader_state = 6;
+
+  // The individual upload requests for this batch.
+  // The recommend total size for a batch is 10 MiB. Too large requests may be
+  // rejected.
+  // This field may be empty, allowing this RPC to be used like TouchInvocation.
+  repeated UploadRequest upload_requests = 5;
+}
+
+// Response for UploadBatch
+message UploadBatchResponse {
+
+}
+
+// The individual upload requests for this batch.
+message UploadRequest {
+  // The resource ID components that identify the resource being uploaded.
+  message Id {
+    // Required for Target, ConfiguredTarget, or Action.
+    // The Target ID.
+    string target_id = 1;
+
+    // Required for Configuration, ConfiguredTarget, or Action.
+    // The Configuration ID.
+    string configuration_id = 2;
+
+    // Required for Action.
+    // The Action ID.
+    string action_id = 3;
+
+    // Required for FileSet.
+    // The FileSet ID.
+    string file_set_id = 4;
+  }
+
+  // The operation for the request (e.g. Create(), Update(), etc.)
+  enum UploadOperation {
+    // Unspecified
+    UPLOAD_OPERATION_UNSPECIFIED = 0;
+
+    // Create the given resources.
+    // For more information, check the Create APIs.
+    CREATE = 1;
+
+    // Applies a standard update to the resource identified by the given
+    // proto's name. For more information, see the Update APIs.
+    // UploadBatch does not support arbitrary field masks. The list of allowed
+    // field masks can be found below.
+    UPDATE = 2;
+
+    // Applies an merge update to the resource identified by the given
+    // proto's name. For more information, see the Merge APIs.
+    // Currently, only the "files" and "file_processing_errors" fields are
+    // supported by this operation.
+    MERGE = 3;
+
+    // Declares the resource with the given name as finalized and immutable by
+    // the uploader. Only supported for Invocation, Target, ConfiguredTarget.
+    // There must be no operation on child resources after parent resource is
+    // Finalized. If there is a Finalize of Invocation, it must be the final
+    // UploadRequest. For more information, see the Finalize APIs.
+    // An empty resource should be provided below.
+    FINALIZE = 4;
+  }
+
+  // The resource ID components that identify the resource being uploaded.
+  Id id = 1;
+
+  // The operation for the request (e.g. Create(), Update(), etc.)
+  UploadOperation upload_operation = 2;
+
+  // Required for Update and Merge operations.
+  // Ignored for Create and Finalize operations.
+  // Masks the fields of the resource being uploaded. Provides support for a
+  // more granular upload.
+  // FieldMask must match one of the follow patterns, where * means any single
+  // field name:
+  // Invocation: [*, status_attributes.*, timing.*, invocation_attributes.*,
+  // workspace_info.*].
+  // Target: [*, status_attributes.*, timing.*].
+  // Configuration: [*, status_attributes.*].
+  // ConfiguredTarget: [*, status_attributes.*].
+  // Action: [*, status_attributes.*, timing.*, test_action.test_suite,
+  // test_action.infrastructure_failure_info].
+  // FileSet: [*].
+  google.protobuf.FieldMask update_mask = 3;
+
+  // If true then the Update, Merge operation will become a Create operation if
+  // the resource is NOT_FOUND. Not supported for Invocation resource.
+  bool create_if_not_found = 10;
+
+  // The proto of the resource being uploaded.
+  oneof resource {
+    // The Invocation Resource
+    Invocation invocation = 4;
+
+    // The Target Resource
+    Target target = 5;
+
+    // The Configuration Resource
+    Configuration configuration = 6;
+
+    // The ConfiguredTarget Resource
+    ConfiguredTarget configured_target = 7;
+
+    // The Action Resource
+    Action action = 8;
+
+    // The FileSet Resource
+    FileSet file_set = 9;
+  }
+}
+
+// Request passed into GetInvocationUploadMetadata
+message GetInvocationUploadMetadataRequest {
+  // Required
+  // The name of the UploadMetadata being requested.
+  // The name format must be: invocations/${INVOCATION_ID}/uploadMetadata
+  string name = 1;
+
+  // Required. A UUID that must match the value provided in CreateInvocationRequest.
+  string authorization_token = 2;
 }
diff --git a/third_party/googleapis/google/devtools/resultstore/v2/resultstore_v2.yaml b/third_party/googleapis/google/devtools/resultstore/v2/resultstore_v2.yaml
new file mode 100644
index 000000000..a22bba1b3
--- /dev/null
+++ b/third_party/googleapis/google/devtools/resultstore/v2/resultstore_v2.yaml
@@ -0,0 +1,32 @@
+type: google.api.Service
+config_version: 3
+name: resultstore.googleapis.com
+title: Result Store API
+
+apis:
+- name: google.devtools.resultstore.v2.ResultStoreDownload
+- name: google.devtools.resultstore.v2.ResultStoreFileDownload
+- name: google.devtools.resultstore.v2.ResultStoreUpload
+
+documentation:
+  summary: The Result Store API v2.
+  overview: An API for reading Invocation results from previous runs.
+
+authentication:
+  rules:
+  - selector: 'google.devtools.resultstore.v2.ResultStoreDownload.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: google.devtools.resultstore.v2.ResultStoreFileDownload.GetFile
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: google.devtools.resultstore.v2.ResultStoreFileDownload.GetFileTail
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
+  - selector: 'google.devtools.resultstore.v2.ResultStoreUpload.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/devtools/resultstore/v2/target.proto b/third_party/googleapis/google/devtools/resultstore/v2/target.proto
index dac53d949..721994b9c 100644
--- a/third_party/googleapis/google/devtools/resultstore/v2/target.proto
+++ b/third_party/googleapis/google/devtools/resultstore/v2/target.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -38,7 +38,7 @@ message Target {
   }
 
   // The resource name.  Its format must be:
-  // invocations/${INVOCATION_ID}/targets/${TARGET_ID}
+  // invocations/${INVOCATION_ID}/targets/${url_encode(TARGET_ID)}
   string name = 1;
 
   // The resource ID components that identify the Target. They must match the
diff --git a/third_party/googleapis/google/devtools/resultstore/v2/test_suite.proto b/third_party/googleapis/google/devtools/resultstore/v2/test_suite.proto
index c892f906d..c1084544b 100644
--- a/third_party/googleapis/google/devtools/resultstore/v2/test_suite.proto
+++ b/third_party/googleapis/google/devtools/resultstore/v2/test_suite.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/third_party/googleapis/google/devtools/resultstore/v2/upload_metadata.proto b/third_party/googleapis/google/devtools/resultstore/v2/upload_metadata.proto
new file mode 100644
index 000000000..d9b35fbf7
--- /dev/null
+++ b/third_party/googleapis/google/devtools/resultstore/v2/upload_metadata.proto
@@ -0,0 +1,39 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.devtools.resultstore.v2;
+
+option go_package = "google.golang.org/genproto/googleapis/devtools/resultstore/v2;resultstore";
+option java_multiple_files = true;
+option java_package = "com.google.devtools.resultstore.v2";
+
+// The upload metadata for an invocation
+message UploadMetadata {
+  // The name of the upload metadata.  Its format will be:
+  // invocations/${INVOCATION_ID}/uploadMetadata
+  string name = 1;
+
+  // The resume token of the last batch that was committed in the most recent
+  // batch upload.
+  // More information with resume_token could be found in
+  // resultstore_upload.proto
+  string resume_token = 2;
+
+  // Client-specific data used to resume batch upload if an error occurs and
+  // retry action is needed.
+  bytes uploader_state = 3;
+}
diff --git a/third_party/googleapis/google/devtools/source/v1/BUILD.bazel b/third_party/googleapis/google/devtools/source/v1/BUILD.bazel
index c94106fb9..9ee0c0a78 100644
--- a/third_party/googleapis/google/devtools/source/v1/BUILD.bazel
+++ b/third_party/googleapis/google/devtools/source/v1/BUILD.bazel
@@ -1,3 +1,5 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
@@ -8,7 +10,9 @@ load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
     name = "source_proto",
-    srcs = ["source_context.proto"],
+    srcs = [
+        "source_context.proto",
+    ],
     deps = [
         "//google/api:annotations_proto",
     ],
@@ -16,19 +20,29 @@ proto_library(
 
 proto_library_with_info(
     name = "source_proto_with_info",
-    deps = [":source_proto"],
+    deps = [
+      ":source_proto",
+    ],
 )
 
 ##############################################################################
 # Java
 ##############################################################################
-load("@com_google_googleapis_imports//:imports.bzl", "java_proto_library")
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_grpc_library",
+    "java_proto_library",
+)
 
 java_proto_library(
     name = "source_java_proto",
-    deps = [
-        ":source_proto",
-    ],
+    deps = [":source_proto"],
+)
+
+java_grpc_library(
+    name = "source_java_grpc",
+    srcs = [":source_proto"],
+    deps = [":source_java_proto"],
 )
 
 ##############################################################################
@@ -37,11 +51,11 @@ java_proto_library(
 load(
     "@com_google_googleapis_imports//:imports.bzl",
     "go_proto_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
     name = "source_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
     importpath = "google.golang.org/genproto/googleapis/devtools/source/v1",
     protos = [":source_proto"],
     deps = [
@@ -49,10 +63,107 @@ go_proto_library(
     ],
 )
 
-# Opensource Packages
-go_gapic_assembly_pkg(
-    name = "gapi-cloud-source-v1-go",
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "source_moved_proto",
+    srcs = [":source_proto"],
     deps = [
-        ":source_go_proto",
+        "//google/api:annotations_proto",
     ],
 )
+
+py_proto_library(
+    name = "source_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":source_moved_proto"],
+)
+
+py_grpc_library(
+    name = "source_py_grpc",
+    srcs = [":source_moved_proto"],
+    deps = [":source_py_proto"],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "source_php_proto",
+    deps = [":source_proto"],
+)
+
+php_grpc_library(
+    name = "source_php_grpc",
+    srcs = [":source_proto"],
+    deps = [":source_php_proto"],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "source_ruby_proto",
+    deps = [":source_proto"],
+)
+
+ruby_grpc_library(
+    name = "source_ruby_grpc",
+    srcs = [":source_proto"],
+    deps = [":source_ruby_proto"],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "source_csharp_proto",
+    deps = [":source_proto"],
+)
+
+csharp_grpc_library(
+    name = "source_csharp_grpc",
+    srcs = [":source_proto"],
+    deps = [":source_csharp_proto"],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ code here
diff --git a/third_party/googleapis/google/devtools/source/v1/source_context.proto b/third_party/googleapis/google/devtools/source/v1/source_context.proto
index 6d6a4dedd..90b02c928 100644
--- a/third_party/googleapis/google/devtools/source/v1/source_context.proto
+++ b/third_party/googleapis/google/devtools/source/v1/source_context.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
diff --git a/third_party/googleapis/google/example/library/artman_library_example_v1.yaml b/third_party/googleapis/google/example/library/artman_library_example_v1.yaml
index 3bc2fffb3..8217d9467 100644
--- a/third_party/googleapis/google/example/library/artman_library_example_v1.yaml
+++ b/third_party/googleapis/google/example/library/artman_library_example_v1.yaml
@@ -1,3 +1,4 @@
+---
 common:
   api_name: library_example
   api_version: v1
diff --git a/third_party/googleapis/google/example/library/v1/BUILD.bazel b/third_party/googleapis/google/example/library/v1/BUILD.bazel
index d5f2b8c90..d3bdfe61f 100644
--- a/third_party/googleapis/google/example/library/v1/BUILD.bazel
+++ b/third_party/googleapis/google/example/library/v1/BUILD.bazel
@@ -1,14 +1,19 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
     name = "library_proto",
-    srcs = ["library.proto"],
+    srcs = [
+        "library.proto",
+    ],
     deps = [
         "//google/api:annotations_proto",
         "//google/api:client_proto",
@@ -20,7 +25,10 @@ proto_library(
 
 proto_library_with_info(
     name = "library_proto_with_info",
-    deps = [":library_proto"],
+    deps = [
+        ":library_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -28,18 +36,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
     name = "library_java_proto",
     deps = [":library_proto"],
@@ -48,49 +51,40 @@ java_proto_library(
 java_grpc_library(
     name = "library_java_grpc",
     srcs = [":library_proto"],
-    deps = [":library_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "library_resource_name_java_proto",
-    gapic_yaml = "library_example_gapic.yaml",
-    deps = [":library_proto"],
+    deps = [":library_java_proto"],
 )
 
 java_gapic_library(
     name = "library_java_gapic",
     src = ":library_proto_with_info",
     gapic_yaml = "library_example_gapic.yaml",
+    package = "google.example.library.v1",
     service_yaml = "//google/example/library:library_example_v1.yaml",
-    test_deps = [":library_java_grpc"],
+    test_deps = [
+        ":library_java_grpc",
+    ],
     deps = [
         ":library_java_proto",
-        ":library_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
+java_gapic_test(
+    name = "library_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.example.library.v1.LibraryServiceClientTest",
+    ],
     runtime_deps = [":library_java_gapic_test"],
-) for test_name in [
-    "com.google.cloud.example.library.v1.LibraryServiceClientTest",
-]]
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
-    name = "google-cloud-library-v1-java",
-    client_deps = [":library_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":library_java_gapic_test"],
-    grpc_deps = [":library_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    name = "google-cloud-example-library-v1-java",
+    deps = [
+        ":library_java_gapic",
+        ":library_java_grpc",
         ":library_java_proto",
         ":library_proto",
-        ":library_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -98,10 +92,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -109,16 +103,20 @@ go_proto_library(
     compilers = ["@io_bazel_rules_go//proto:go_grpc"],
     importpath = "google.golang.org/genproto/googleapis/example/library/v1",
     protos = [":library_proto"],
-    deps = ["//google/api:annotations_go_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
 )
 
 go_gapic_library(
     name = "library_go_gapic",
-    src = ":library_proto_with_info",
-    gapic_yaml = "library_example_gapic.yaml",
-    importpath = "cloud.google.com/go/example/library/apiv1",
+    srcs = [":library_proto_with_info"],
+    grpc_service_config = "",
+    importpath = "cloud.google.com/go/example/library/apiv1;library",
     service_yaml = "//google/example/library:library_example_v1.yaml",
-    deps = [":library_go_proto"],
+    deps = [
+        ":library_go_proto",
+    ],
 )
 
 go_test(
@@ -128,13 +126,233 @@ go_test(
     importpath = "cloud.google.com/go/example/library/apiv1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
-    name = "gapi-cloud-library-v1-go",
+    name = "gapi-cloud-example-library-v1-go",
     deps = [
         ":library_go_gapic",
-        ":library_go_gapic_srcjar-smoke-test.srcjar",
         ":library_go_gapic_srcjar-test.srcjar",
         ":library_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "library_moved_proto",
+    srcs = [":library_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:empty_proto",
+    ],
+)
+
+py_proto_library(
+    name = "library_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":library_moved_proto"],
+)
+
+py_grpc_library(
+    name = "library_py_grpc",
+    srcs = [":library_moved_proto"],
+    deps = [":library_py_proto"],
+)
+
+py_gapic_library(
+    name = "library_py_gapic",
+    src = ":library_proto_with_info",
+    gapic_yaml = "library_example_gapic.yaml",
+    package = "google.example.library.v1",
+    service_yaml = "//google/example/library:library_example_v1.yaml",
+    deps = [
+        ":library_py_grpc",
+        ":library_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "example-library-v1-py",
+    deps = [
+        ":library_py_gapic",
+        ":library_py_grpc",
+        ":library_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "library_php_proto",
+    deps = [":library_proto"],
+)
+
+php_grpc_library(
+    name = "library_php_grpc",
+    srcs = [":library_proto"],
+    deps = [":library_php_proto"],
+)
+
+php_gapic_library(
+    name = "library_php_gapic",
+    src = ":library_proto_with_info",
+    gapic_yaml = "library_example_gapic.yaml",
+    package = "google.example.library.v1",
+    service_yaml = "//google/example/library:library_example_v1.yaml",
+    deps = [
+        ":library_php_grpc",
+        ":library_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-example-library-v1-php",
+    deps = [
+        ":library_php_gapic",
+        ":library_php_grpc",
+        ":library_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "library_nodejs_gapic",
+    src = ":library_proto_with_info",
+    gapic_yaml = "library_example_gapic.yaml",
+    package = "google.example.library.v1",
+    service_yaml = "//google/example/library:library_example_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "example-library-v1-nodejs",
+    deps = [
+        ":library_nodejs_gapic",
+        ":library_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "library_ruby_proto",
+    deps = [":library_proto"],
+)
+
+ruby_grpc_library(
+    name = "library_ruby_grpc",
+    srcs = [":library_proto"],
+    deps = [":library_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "library_ruby_gapic",
+    src = ":library_proto_with_info",
+    gapic_yaml = "library_example_gapic.yaml",
+    package = "google.example.library.v1",
+    service_yaml = "//google/example/library:library_example_v1.yaml",
+    deps = [
+        ":library_ruby_grpc",
+        ":library_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-example-library-v1-ruby",
+    deps = [
+        ":library_ruby_gapic",
+        ":library_ruby_grpc",
+        ":library_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "library_csharp_proto",
+    deps = [":library_proto"],
+)
+
+csharp_grpc_library(
+    name = "library_csharp_grpc",
+    srcs = [":library_proto"],
+    deps = [":library_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "library_csharp_gapic",
+    src = ":library_proto_with_info",
+    gapic_yaml = "library_example_gapic.yaml",
+    package = "google.example.library.v1",
+    service_yaml = "//google/example/library:library_example_v1.yaml",
+    deps = [
+        ":library_csharp_grpc",
+        ":library_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-example-library-v1-csharp",
+    deps = [
+        ":library_csharp_gapic",
+        ":library_csharp_grpc",
+        ":library_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/example/library/v1/library.proto b/third_party/googleapis/google/example/library/v1/library.proto
index bc36c31d1..80912cf64 100644
--- a/third_party/googleapis/google/example/library/v1/library.proto
+++ b/third_party/googleapis/google/example/library/v1/library.proto
@@ -38,6 +38,8 @@ option java_package = "com.google.example.library.v1";
 // - Each Shelf has a collection of [Book][google.example.library.v1.Book]
 //   resources, named `shelves/*/books/*`
 service LibraryService {
+  option (google.api.default_host) = "library-example.googleapis.com";
+
   // Creates a shelf, and returns the new Shelf.
   rpc CreateShelf(CreateShelfRequest) returns (Shelf) {
     option (google.api.http) = {
diff --git a/third_party/googleapis/google/firestore/BUILD.bazel b/third_party/googleapis/google/firestore/BUILD.bazel
index 1e5b8c2af..a87c57fec 100644
--- a/third_party/googleapis/google/firestore/BUILD.bazel
+++ b/third_party/googleapis/google/firestore/BUILD.bazel
@@ -1 +1 @@
-exports_files(glob(["*.yaml"]))
\ No newline at end of file
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/firestore/admin/BUILD.bazel b/third_party/googleapis/google/firestore/admin/BUILD.bazel
new file mode 100644
index 000000000..a87c57fec
--- /dev/null
+++ b/third_party/googleapis/google/firestore/admin/BUILD.bazel
@@ -0,0 +1 @@
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/firestore/admin/v1/BUILD.bazel b/third_party/googleapis/google/firestore/admin/v1/BUILD.bazel
new file mode 100644
index 000000000..46291191f
--- /dev/null
+++ b/third_party/googleapis/google/firestore/admin/v1/BUILD.bazel
@@ -0,0 +1,376 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "admin_proto",
+    srcs = [
+        "field.proto",
+        "firestore_admin.proto",
+        "index.proto",
+        "location.proto",
+        "operation.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/longrunning:operations_proto",
+        "//google/type:latlng_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "admin_proto_with_info",
+    deps = [
+        ":admin_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "admin_java_proto",
+    deps = [":admin_proto"],
+)
+
+java_grpc_library(
+    name = "admin_java_grpc",
+    srcs = [":admin_proto"],
+    deps = [":admin_java_proto"],
+)
+
+java_gapic_library(
+    name = "admin_java_gapic",
+    src = ":admin_proto_with_info",
+    gapic_yaml = "firestore_gapic.yaml",
+    package = "google.firestore.admin.v1",
+    service_yaml = "//google/firestore/admin:firestore_admin_v1.yaml",
+    test_deps = [
+        ":admin_java_grpc",
+    ],
+    deps = [
+        ":admin_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "admin_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.firestore.v1.FirestoreAdminClientTest",
+    ],
+    runtime_deps = [":admin_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-firestore-admin-v1-java",
+    deps = [
+        ":admin_java_gapic",
+        ":admin_java_grpc",
+        ":admin_java_proto",
+        ":admin_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "admin_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/firestore/admin/v1",
+    protos = [":admin_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/longrunning:longrunning_go_proto",
+        "//google/type:latlng_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "admin_go_gapic",
+    srcs = [":admin_proto_with_info"],
+    grpc_service_config = "firestore_admin_grpc_service_config.json",
+    importpath = "cloud.google.com/go/firestore/apiv1/admin;admin",
+    service_yaml = "//google/firestore/admin:firestore_admin_v1.yaml",
+    deps = [
+        ":admin_go_proto",
+        "//google/longrunning:longrunning_go_gapic",
+        "//google/longrunning:longrunning_go_proto",
+        "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
+    ],
+)
+
+go_test(
+    name = "admin_go_gapic_test",
+    srcs = [":admin_go_gapic_srcjar_test"],
+    embed = [":admin_go_gapic"],
+    importpath = "cloud.google.com/go/firestore/apiv1/admin",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-firestore-admin-v1-go",
+    deps = [
+        ":admin_go_gapic",
+        ":admin_go_gapic_srcjar-test.srcjar",
+        ":admin_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "admin_moved_proto",
+    srcs = [":admin_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/longrunning:operations_proto",
+        "//google/type:latlng_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "admin_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":admin_moved_proto"],
+)
+
+py_grpc_library(
+    name = "admin_py_grpc",
+    srcs = [":admin_moved_proto"],
+    deps = [":admin_py_proto"],
+)
+
+py_gapic_library(
+    name = "admin_py_gapic",
+    src = ":admin_proto_with_info",
+    gapic_yaml = "firestore_gapic.yaml",
+    package = "google.firestore.admin.v1",
+    service_yaml = "//google/firestore/admin:firestore_admin_v1.yaml",
+    deps = [
+        ":admin_py_grpc",
+        ":admin_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "firestore-admin-v1-py",
+    deps = [
+        ":admin_py_gapic",
+        ":admin_py_grpc",
+        ":admin_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "admin_php_proto",
+    deps = [":admin_proto"],
+)
+
+php_grpc_library(
+    name = "admin_php_grpc",
+    srcs = [":admin_proto"],
+    deps = [":admin_php_proto"],
+)
+
+php_gapic_library(
+    name = "admin_php_gapic",
+    src = ":admin_proto_with_info",
+    gapic_yaml = "firestore_gapic.legacy.yaml",
+    package = "google.firestore.admin.v1",
+    service_yaml = "//google/firestore/admin:firestore_admin_v1.yaml",
+    deps = [
+        ":admin_php_grpc",
+        ":admin_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-firestore-admin-v1-php",
+    deps = [
+        ":admin_php_gapic",
+        ":admin_php_grpc",
+        ":admin_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "admin_nodejs_gapic",
+    src = ":admin_proto_with_info",
+    gapic_yaml = "firestore_gapic.yaml",
+    package = "google.firestore.admin.v1",
+    service_yaml = "//google/firestore/admin:firestore_admin_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "firestore-admin-v1-nodejs",
+    deps = [
+        ":admin_nodejs_gapic",
+        ":admin_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "admin_ruby_proto",
+    deps = [":admin_proto"],
+)
+
+ruby_grpc_library(
+    name = "admin_ruby_grpc",
+    srcs = [":admin_proto"],
+    deps = [":admin_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "admin_ruby_gapic",
+    src = ":admin_proto_with_info",
+    gapic_yaml = "firestore_gapic.yaml",
+    package = "google.firestore.admin.v1",
+    service_yaml = "//google/firestore/admin:firestore_admin_v1.yaml",
+    deps = [
+        ":admin_ruby_grpc",
+        ":admin_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-firestore-admin-v1-ruby",
+    deps = [
+        ":admin_ruby_gapic",
+        ":admin_ruby_grpc",
+        ":admin_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "admin_csharp_proto",
+    deps = [":admin_proto"],
+)
+
+csharp_grpc_library(
+    name = "admin_csharp_grpc",
+    srcs = [":admin_proto"],
+    deps = [":admin_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "admin_csharp_gapic",
+    src = ":admin_proto_with_info",
+    gapic_yaml = "firestore_gapic.yaml",
+    package = "google.firestore.admin.v1",
+    service_yaml = "//google/firestore/admin:firestore_admin_v1.yaml",
+    deps = [
+        ":admin_csharp_grpc",
+        ":admin_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-firestore-admin-v1-csharp",
+    deps = [
+        ":admin_csharp_gapic",
+        ":admin_csharp_grpc",
+        ":admin_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/firestore/admin/v1/field.proto b/third_party/googleapis/google/firestore/admin/v1/field.proto
index a24e1aaf1..48430d87c 100644
--- a/third_party/googleapis/google/firestore/admin/v1/field.proto
+++ b/third_party/googleapis/google/firestore/admin/v1/field.proto
@@ -17,6 +17,7 @@ syntax = "proto3";
 
 package google.firestore.admin.v1;
 
+import "google/api/resource.proto";
 import "google/firestore/admin/v1/index.proto";
 import "google/api/annotations.proto";
 
@@ -28,25 +29,27 @@ option java_package = "com.google.firestore.admin.v1";
 option objc_class_prefix = "GCFS";
 option php_namespace = "Google\\Cloud\\Firestore\\Admin\\V1";
 
-
 // Represents a single field in the database.
 //
 // Fields are grouped by their "Collection Group", which represent all
 // collections in the database with the same id.
 message Field {
+  option (google.api.resource) = {
+    type: "firestore.googleapis.com/Field"
+    pattern: "projects/{project}/databases/{database}/collectionGroups/{collection}/fields/{field}"
+  };
+
   // The index configuration for this field.
   message IndexConfig {
     // The indexes supported for this field.
     repeated Index indexes = 1;
 
-    // Output only.
-    // When true, the `Field`'s index configuration is set from the
+    // Output only. When true, the `Field`'s index configuration is set from the
     // configuration specified by the `ancestor_field`.
     // When false, the `Field`'s index configuration is defined explicitly.
     bool uses_ancestor_config = 2;
 
-    // Output only.
-    // Specifies the resource name of the `Field` from which this field's
+    // Output only. Specifies the resource name of the `Field` from which this field's
     // index configuration is set (when `uses_ancestor_config` is true),
     // or from which it *would* be set if this field had no index configuration
     // (when `uses_ancestor_config` is false).
diff --git a/third_party/googleapis/google/firestore/admin/v1/firestore_admin.proto b/third_party/googleapis/google/firestore/admin/v1/firestore_admin.proto
index e753686b2..75dd2d311 100644
--- a/third_party/googleapis/google/firestore/admin/v1/firestore_admin.proto
+++ b/third_party/googleapis/google/firestore/admin/v1/firestore_admin.proto
@@ -18,6 +18,9 @@ syntax = "proto3";
 package google.firestore.admin.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/firestore/admin/v1/field.proto";
 import "google/firestore/admin/v1/index.proto";
 import "google/longrunning/operations.proto";
@@ -31,11 +34,23 @@ option java_outer_classname = "FirestoreAdminProto";
 option java_package = "com.google.firestore.admin.v1";
 option objc_class_prefix = "GCFS";
 option php_namespace = "Google\\Cloud\\Firestore\\Admin\\V1";
-
+option (google.api.resource_definition) = {
+  type: "firestore.googleapis.com/Database"
+  pattern: "projects/{project}/databases/{database}"
+};
+option (google.api.resource_definition) = {
+  type: "firestore.googleapis.com/CollectionGroup"
+  pattern: "projects/{project}/databases/{database}/collectionGroups/{collection}"
+};
 
 // Operations are created by service `FirestoreAdmin`, but are accessed via
 // service `google.longrunning.Operations`.
 service FirestoreAdmin {
+  option (google.api.default_host) = "firestore.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/datastore";
+
   // Creates a composite index. This returns a [google.longrunning.Operation][google.longrunning.Operation]
   // which may be used to track the status of the creation. The metadata for
   // the operation will be the type [IndexOperationMetadata][google.firestore.admin.v1.IndexOperationMetadata].
@@ -44,6 +59,11 @@ service FirestoreAdmin {
       post: "/v1/{parent=projects/*/databases/*/collectionGroups/*}/indexes"
       body: "index"
     };
+    option (google.api.method_signature) = "parent,index";
+    option (google.longrunning.operation_info) = {
+      response_type: "Index"
+      metadata_type: "IndexOperationMetadata"
+    };
   }
 
   // Lists composite indexes.
@@ -51,6 +71,7 @@ service FirestoreAdmin {
     option (google.api.http) = {
       get: "/v1/{parent=projects/*/databases/*/collectionGroups/*}/indexes"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets a composite index.
@@ -58,6 +79,7 @@ service FirestoreAdmin {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/databases/*/collectionGroups/*/indexes/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Deletes a composite index.
@@ -65,6 +87,7 @@ service FirestoreAdmin {
     option (google.api.http) = {
       delete: "/v1/{name=projects/*/databases/*/collectionGroups/*/indexes/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Gets the metadata and configuration for a Field.
@@ -72,6 +95,7 @@ service FirestoreAdmin {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/databases/*/collectionGroups/*/fields/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Updates a field configuration. Currently, field updates apply only to
@@ -92,6 +116,11 @@ service FirestoreAdmin {
       patch: "/v1/{field.name=projects/*/databases/*/collectionGroups/*/fields/*}"
       body: "field"
     };
+    option (google.api.method_signature) = "field";
+    option (google.longrunning.operation_info) = {
+      response_type: "Field"
+      metadata_type: "FieldOperationMetadata"
+    };
   }
 
   // Lists the field configuration and metadata for this database.
@@ -104,6 +133,7 @@ service FirestoreAdmin {
     option (google.api.http) = {
       get: "/v1/{parent=projects/*/databases/*/collectionGroups/*}/fields"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Exports a copy of all or a subset of documents from Google Cloud Firestore
@@ -119,6 +149,11 @@ service FirestoreAdmin {
       post: "/v1/{name=projects/*/databases/*}:exportDocuments"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
+    option (google.longrunning.operation_info) = {
+      response_type: "ExportDocumentsResponse"
+      metadata_type: "ExportDocumentsMetadata"
+    };
   }
 
   // Imports documents into Google Cloud Firestore. Existing documents with the
@@ -131,24 +166,39 @@ service FirestoreAdmin {
       post: "/v1/{name=projects/*/databases/*}:importDocuments"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.protobuf.Empty"
+      metadata_type: "ImportDocumentsMetadata"
+    };
   }
 }
 
 // The request for [FirestoreAdmin.CreateIndex][google.firestore.admin.v1.FirestoreAdmin.CreateIndex].
 message CreateIndexRequest {
-  // A parent name of the form
+  // Required. A parent name of the form
   // `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}`
-  string parent = 1;
-
-  // The composite index to create.
-  Index index = 2;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "firestore.googleapis.com/CollectionGroup"
+    }
+  ];
+
+  // Required. The composite index to create.
+  Index index = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The request for [FirestoreAdmin.ListIndexes][google.firestore.admin.v1.FirestoreAdmin.ListIndexes].
 message ListIndexesRequest {
-  // A parent name of the form
+  // Required. A parent name of the form
   // `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}`
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "firestore.googleapis.com/CollectionGroup"
+    }
+  ];
 
   // The filter to apply to list results.
   string filter = 2;
@@ -174,22 +224,32 @@ message ListIndexesResponse {
 
 // The request for [FirestoreAdmin.GetIndex][google.firestore.admin.v1.FirestoreAdmin.GetIndex].
 message GetIndexRequest {
-  // A name of the form
+  // Required. A name of the form
   // `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/indexes/{index_id}`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "firestore.googleapis.com/Index"
+    }
+  ];
 }
 
 // The request for [FirestoreAdmin.DeleteIndex][google.firestore.admin.v1.FirestoreAdmin.DeleteIndex].
 message DeleteIndexRequest {
-  // A name of the form
+  // Required. A name of the form
   // `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/indexes/{index_id}`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "firestore.googleapis.com/Index"
+    }
+  ];
 }
 
 // The request for [FirestoreAdmin.UpdateField][google.firestore.admin.v1.FirestoreAdmin.UpdateField].
 message UpdateFieldRequest {
-  // The field to be updated.
-  Field field = 1;
+  // Required. The field to be updated.
+  Field field = 1 [(google.api.field_behavior) = REQUIRED];
 
   // A mask, relative to the field. If specified, only configuration specified
   // by this field_mask will be updated in the field.
@@ -198,16 +258,26 @@ message UpdateFieldRequest {
 
 // The request for [FirestoreAdmin.GetField][google.firestore.admin.v1.FirestoreAdmin.GetField].
 message GetFieldRequest {
-  // A name of the form
+  // Required. A name of the form
   // `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/fields/{field_id}`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "firestore.googleapis.com/Field"
+    }
+  ];
 }
 
 // The request for [FirestoreAdmin.ListFields][google.firestore.admin.v1.FirestoreAdmin.ListFields].
 message ListFieldsRequest {
-  // A parent name of the form
+  // Required. A parent name of the form
   // `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}`
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "firestore.googleapis.com/CollectionGroup"
+    }
+  ];
 
   // The filter to apply to list results. Currently,
   // [FirestoreAdmin.ListFields][google.firestore.admin.v1.FirestoreAdmin.ListFields] only supports listing fields
@@ -237,9 +307,14 @@ message ListFieldsResponse {
 
 // The request for [FirestoreAdmin.ExportDocuments][google.firestore.admin.v1.FirestoreAdmin.ExportDocuments].
 message ExportDocumentsRequest {
-  // Database to export. Should be of the form:
+  // Required. Database to export. Should be of the form:
   // `projects/{project_id}/databases/{database_id}`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "firestore.googleapis.com/Database"
+    }
+  ];
 
   // Which collection ids to export. Unspecified means all collections.
   repeated string collection_ids = 2;
@@ -257,9 +332,14 @@ message ExportDocumentsRequest {
 
 // The request for [FirestoreAdmin.ImportDocuments][google.firestore.admin.v1.FirestoreAdmin.ImportDocuments].
 message ImportDocumentsRequest {
-  // Database to import into. Should be of the form:
+  // Required. Database to import into. Should be of the form:
   // `projects/{project_id}/databases/{database_id}`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "firestore.googleapis.com/Database"
+    }
+  ];
 
   // Which collection ids to import. Unspecified means all collections included
   // in the import.
diff --git a/third_party/googleapis/google/firestore/admin/v1/firestore_admin_grpc_service_config.json b/third_party/googleapis/google/firestore/admin/v1/firestore_admin_grpc_service_config.json
new file mode 100755
index 000000000..1460a8b7c
--- /dev/null
+++ b/third_party/googleapis/google/firestore/admin/v1/firestore_admin_grpc_service_config.json
@@ -0,0 +1,61 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.firestore.admin.v1.FirestoreAdmin",
+          "method": "ListIndexes"
+        },
+        {
+          "service": "google.firestore.admin.v1.FirestoreAdmin",
+          "method": "GetIndex"
+        },
+        {
+          "service": "google.firestore.admin.v1.FirestoreAdmin",
+          "method": "DeleteIndex"
+        },
+        {
+          "service": "google.firestore.admin.v1.FirestoreAdmin",
+          "method": "GetField"
+        },
+        {
+          "service": "google.firestore.admin.v1.FirestoreAdmin",
+          "method": "ListFields"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "INTERNAL",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.firestore.admin.v1.FirestoreAdmin",
+          "method": "CreateIndex"
+        },
+        {
+          "service": "google.firestore.admin.v1.FirestoreAdmin",
+          "method": "ImportDocuments"
+        },
+        {
+          "service": "google.firestore.admin.v1.FirestoreAdmin",
+          "method": "ExportDocuments"
+        },
+        {
+          "service": "google.firestore.admin.v1.FirestoreAdmin",
+          "method": "UpdateField"
+        }
+      ],
+      "timeout": "60s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/firestore/admin/v1/firestore_gapic.legacy.yaml b/third_party/googleapis/google/firestore/admin/v1/firestore_gapic.legacy.yaml
new file mode 100644
index 000000000..6ebcee036
--- /dev/null
+++ b/third_party/googleapis/google/firestore/admin/v1/firestore_gapic.legacy.yaml
@@ -0,0 +1,199 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.firestore.v1
+  python:
+    package_name: google.cloud.firestore_admin_v1.gapic
+  go:
+    package_name: cloud.google.com/go/firestore/apiv1/admin
+  csharp:
+    package_name: Google.Cloud.Firestore.Admin.V1
+  ruby:
+    package_name: Google::Cloud::Firestore::Admin::V1
+  php:
+    package_name: Google\Cloud\Firestore\Admin\V1
+  nodejs:
+    package_name: firestore.v1
+    domain_layer_location: google-cloud
+interfaces:
+- name: google.firestore.admin.v1.FirestoreAdmin
+  collections:
+  - name_pattern: projects/{project}/databases/{database}
+    entity_name: database
+  - name_pattern: projects/{project}/databases/{database}/collectionGroups/{collection_id}
+    entity_name: parent
+  - name_pattern: projects/{project}/databases/{database}/collectionGroups/{collection_id}/indexes/{index_id}
+    entity_name: index
+  - name_pattern: projects/{project}/databases/{database}/collectionGroups/{collection_id}/fields/{field_id}
+    entity_name: field
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - INTERNAL
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 60000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 60000
+    total_timeout_millis: 600000
+  methods:
+  - name: CreateIndex
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - index
+    required_fields:
+    - parent
+    - index
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: parent
+    timeout_millis: 60000
+  - name: ListIndexes
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: indexes
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: parent
+    timeout_millis: 60000
+  - name: GetIndex
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: index
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+  - name: DeleteIndex
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: index
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+  - name: ImportDocuments
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: database
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+  - name: ExportDocuments
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: database
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+  - name: GetField
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: field
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+  - name: ListFields
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: fields
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: parent
+    timeout_millis: 60000
+  - name: UpdateField
+    flattening:
+      groups:
+      - parameters:
+        - field
+    required_fields:
+    - field
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+resource_name_generation:
+- message_name: CreateIndexRequest
+  field_entity_map:
+    parent: parent
+- message_name: GetIndexRequest
+  field_entity_map:
+    name: index
+- message_name: DeleteIndexRequest
+  field_entity_map:
+    name: index
+- message_name: ImportDocumentsRequest
+  field_entity_map:
+    name: database
+- message_name: ExportDocumentsRequest
+  field_entity_map:
+    name: database
+- message_name: GetFieldRequest
+  field_entity_map:
+    name: field
+- message_name: ListFieldsRequest
+  field_entity_map:
+    parent: parent
+- message_name: ListIndexesRequest
+  field_entity_map:
+    parent: parent
diff --git a/third_party/googleapis/google/firestore/admin/v1/firestore_gapic.yaml b/third_party/googleapis/google/firestore/admin/v1/firestore_gapic.yaml
index bda86e4e5..55522c0c1 100644
--- a/third_party/googleapis/google/firestore/admin/v1/firestore_gapic.yaml
+++ b/third_party/googleapis/google/firestore/admin/v1/firestore_gapic.yaml
@@ -1,16 +1,16 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.firestore.v1
   python:
-    package_name: google.cloud.firestore_v1.gapic
+    package_name: google.cloud.firestore_admin_v1.gapic
   go:
     package_name: cloud.google.com/go/firestore/apiv1/admin
   csharp:
     package_name: Google.Cloud.Firestore.Admin.V1
   ruby:
-    package_name: Google::Cloud::Firestore::V1
+    package_name: Google::Cloud::Firestore::Admin::V1
   php:
     package_name: Google\Cloud\Firestore\Admin\V1
   nodejs:
@@ -18,181 +18,23 @@ language_settings:
     domain_layer_location: google-cloud
 interfaces:
 - name: google.firestore.admin.v1.FirestoreAdmin
-  collections:
-  - name_pattern: projects/{project}/databases/{database}
-    entity_name: database
-  - name_pattern: projects/{project}/databases/{database}/collectionGroups/{collection_id}
-    entity_name: parent
-  - name_pattern: projects/{project}/databases/{database}/collectionGroups/{collection_id}/indexes/{index_id}
-    entity_name: index
-  - name_pattern: projects/{project}/databases/{database}/collectionGroups/{collection_id}/fields/{field_id}
-    entity_name: field
   retry_codes_def:
   - name: idempotent
     retry_codes:
     - UNAVAILABLE
+    - INTERNAL
     - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 100
     retry_delay_multiplier: 1.3
     max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
+    initial_rpc_timeout_millis: 60000
     rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
+    max_rpc_timeout_millis: 60000
     total_timeout_millis: 600000
   methods:
-  - name: CreateIndex
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - index
-    required_fields:
-    - parent
-    - index
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: parent
-    timeout_millis: 60000
-  - name: ListIndexes
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: indexes
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: parent
-    timeout_millis: 60000
-  - name: GetIndex
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: index
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
   - name: DeleteIndex
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: index
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
-  - name: ImportDocuments
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: database
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
-  - name: ExportDocuments
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: database
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
-  - name: GetField
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: field
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
-  - name: ListFields
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: fields
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: parent
-    timeout_millis: 60000
   - name: UpdateField
-    flattening:
-      groups:
-      - parameters:
-        - field
-    required_fields:
-    - field
     retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-resource_name_generation:
-- message_name: CreateIndexRequest
-  field_entity_map:
-    parent: parent
-- message_name: GetIndexRequest
-  field_entity_map:
-    name: index
-- message_name: DeleteIndexRequest
-  field_entity_map:
-    name: index
-- message_name: ImportDocumentsRequest
-  field_entity_map:
-    name: database
-- message_name: ExportDocumentsRequest
-  field_entity_map:
-    name: database
-- message_name: GetFieldRequest
-  field_entity_map:
-    name: field
-- message_name: ListFieldsRequest
-  field_entity_map:
-    parent: parent
-- message_name: ListIndexesRequest
-  field_entity_map:
-    parent: parent
diff --git a/third_party/googleapis/google/firestore/admin/v1/firestore_v1.yaml b/third_party/googleapis/google/firestore/admin/v1/firestore_v1.yaml
new file mode 100644
index 000000000..030118d40
--- /dev/null
+++ b/third_party/googleapis/google/firestore/admin/v1/firestore_v1.yaml
@@ -0,0 +1,52 @@
+type: google.api.Service
+config_version: 3
+name: firestore.googleapis.com
+title: Cloud Firestore API
+
+apis:
+- name: google.firestore.admin.v1.FirestoreAdmin
+
+types:
+- name: google.firestore.admin.v1.ExportDocumentsMetadata
+- name: google.firestore.admin.v1.ExportDocumentsResponse
+- name: google.firestore.admin.v1.FieldOperationMetadata
+- name: google.firestore.admin.v1.ImportDocumentsMetadata
+- name: google.firestore.admin.v1.IndexOperationMetadata
+- name: google.firestore.admin.v1.LocationMetadata
+
+documentation:
+  summary: |-
+    Accesses the NoSQL document database built for automatic scaling, high
+    performance, and ease of application development.
+
+backend:
+  rules:
+  - selector: 'google.firestore.admin.v1.FirestoreAdmin.*'
+    deadline: 295.0
+  - selector: 'google.longrunning.Operations.*'
+    deadline: 295.0
+
+http:
+  rules:
+  - selector: google.longrunning.Operations.CancelOperation
+    post: '/v1/{name=projects/*/databases/*/operations/*}:cancel'
+    body: '*'
+  - selector: google.longrunning.Operations.DeleteOperation
+    delete: '/v1/{name=projects/*/databases/*/operations/*}'
+  - selector: google.longrunning.Operations.GetOperation
+    get: '/v1/{name=projects/*/databases/*/operations/*}'
+  - selector: google.longrunning.Operations.ListOperations
+    get: '/v1/{name=projects/*/databases/*}/operations'
+
+authentication:
+  rules:
+  - selector: 'google.firestore.admin.v1.FirestoreAdmin.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/datastore
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/datastore
diff --git a/third_party/googleapis/google/firestore/admin/v1/index.proto b/third_party/googleapis/google/firestore/admin/v1/index.proto
index 94941d3a0..4b9c6e35b 100644
--- a/third_party/googleapis/google/firestore/admin/v1/index.proto
+++ b/third_party/googleapis/google/firestore/admin/v1/index.proto
@@ -17,6 +17,7 @@ syntax = "proto3";
 
 package google.firestore.admin.v1;
 
+import "google/api/resource.proto";
 import "google/api/annotations.proto";
 
 option csharp_namespace = "Google.Cloud.Firestore.Admin.V1";
@@ -27,10 +28,14 @@ option java_package = "com.google.firestore.admin.v1";
 option objc_class_prefix = "GCFS";
 option php_namespace = "Google\\Cloud\\Firestore\\Admin\\V1";
 
-
 // Cloud Firestore indexes enable simple and complex queries against
 // documents in a database.
 message Index {
+  option (google.api.resource) = {
+    type: "firestore.googleapis.com/Index"
+    pattern: "projects/{project}/databases/{database}/collectionGroups/{collection}/indexes/{index}"
+  };
+
   // A field in an index.
   // The field_path describes which field is indexed, the value_mode describes
   // how the field value is indexed.
@@ -82,6 +87,11 @@ message Index {
     // against a collection that is the child of a specific document, specified
     // at query time, and that has the collection id specified by the index.
     COLLECTION = 1;
+
+    // Indexes with a collection group query scope specified allow queries
+    // against all collections that has the collection id specified by the
+    // index.
+    COLLECTION_GROUP = 2;
   }
 
   // The state of an index. During index creation, an index will be in the
@@ -114,8 +124,7 @@ message Index {
     NEEDS_REPAIR = 3;
   }
 
-  // Output only.
-  // A server defined name for this index.
+  // Output only. A server defined name for this index.
   // The form of this name for composite indexes will be:
   // `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/indexes/{composite_index_id}`
   // For single field indexes, this field will be empty.
@@ -143,7 +152,6 @@ message Index {
   // field path equal to the field path of the associated field.
   repeated IndexField fields = 3;
 
-  // Output only.
-  // The serving state of the index.
+  // Output only. The serving state of the index.
   State state = 4;
 }
diff --git a/third_party/googleapis/google/firestore/admin/v1/location.proto b/third_party/googleapis/google/firestore/admin/v1/location.proto
index 7b56051a5..d9dc6f9b9 100644
--- a/third_party/googleapis/google/firestore/admin/v1/location.proto
+++ b/third_party/googleapis/google/firestore/admin/v1/location.proto
@@ -28,7 +28,6 @@ option java_package = "com.google.firestore.admin.v1";
 option objc_class_prefix = "GCFS";
 option php_namespace = "Google\\Cloud\\Firestore\\Admin\\V1";
 
-
 // The metadata message for [google.cloud.location.Location.metadata][google.cloud.location.Location.metadata].
 message LocationMetadata {
 
diff --git a/third_party/googleapis/google/firestore/admin/v1/operation.proto b/third_party/googleapis/google/firestore/admin/v1/operation.proto
index d333d9b7d..08194fe09 100644
--- a/third_party/googleapis/google/firestore/admin/v1/operation.proto
+++ b/third_party/googleapis/google/firestore/admin/v1/operation.proto
@@ -29,7 +29,6 @@ option java_package = "com.google.firestore.admin.v1";
 option objc_class_prefix = "GCFS";
 option php_namespace = "Google\\Cloud\\Firestore\\Admin\\V1";
 
-
 // Metadata for [google.longrunning.Operation][google.longrunning.Operation] results from
 // [FirestoreAdmin.CreateIndex][google.firestore.admin.v1.FirestoreAdmin.CreateIndex].
 message IndexOperationMetadata {
@@ -163,6 +162,17 @@ message ExportDocumentsResponse {
   string output_uri_prefix = 1;
 }
 
+// Describes the progress of the operation.
+// Unit of work is generic and must be interpreted based on where [Progress][google.firestore.admin.v1.Progress]
+// is used.
+message Progress {
+  // The amount of work estimated.
+  int64 estimated_work = 1;
+
+  // The amount of work completed.
+  int64 completed_work = 2;
+}
+
 // Describes the state of the operation.
 enum OperationState {
   // Unspecified.
@@ -191,14 +201,3 @@ enum OperationState {
   // google.longrunning.Operations.CancelOperation.
   CANCELLED = 7;
 }
-
-// Describes the progress of the operation.
-// Unit of work is generic and must be interpreted based on where [Progress][google.firestore.admin.v1.Progress]
-// is used.
-message Progress {
-  // The amount of work estimated.
-  int64 estimated_work = 1;
-
-  // The amount of work completed.
-  int64 completed_work = 2;
-}
diff --git a/third_party/googleapis/google/firestore/admin/v1beta1/firestore_admin.proto b/third_party/googleapis/google/firestore/admin/v1beta1/firestore_admin.proto
index 505872259..5d7908b93 100644
--- a/third_party/googleapis/google/firestore/admin/v1beta1/firestore_admin.proto
+++ b/third_party/googleapis/google/firestore/admin/v1beta1/firestore_admin.proto
@@ -22,6 +22,7 @@ import "google/firestore/admin/v1beta1/index.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/timestamp.proto";
+import "google/api/client.proto";
 
 option csharp_namespace = "Google.Cloud.Firestore.Admin.V1Beta1";
 option go_package = "google.golang.org/genproto/googleapis/firestore/admin/v1beta1;admin";
@@ -30,7 +31,6 @@ option java_outer_classname = "FirestoreAdminProto";
 option java_package = "com.google.firestore.admin.v1beta1";
 option objc_class_prefix = "GCFS";
 
-
 // The Cloud Firestore Admin API.
 //
 // This API provides several administrative services for Cloud Firestore.
@@ -75,6 +75,11 @@ option objc_class_prefix = "GCFS";
 // Operations are created by service `FirestoreAdmin`, but are accessed via
 // service `google.longrunning.Operations`.
 service FirestoreAdmin {
+  option (google.api.default_host) = "firestore.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/datastore";
+
   // Creates the specified index.
   // A newly created index's initial state is `CREATING`. On completion of the
   // returned [google.longrunning.Operation][google.longrunning.Operation], the state will be `READY`.
diff --git a/third_party/googleapis/google/firestore/admin/v1beta1/index.proto b/third_party/googleapis/google/firestore/admin/v1beta1/index.proto
index 285e0a533..0ca95985b 100644
--- a/third_party/googleapis/google/firestore/admin/v1beta1/index.proto
+++ b/third_party/googleapis/google/firestore/admin/v1beta1/index.proto
@@ -26,7 +26,6 @@ option java_outer_classname = "IndexProto";
 option java_package = "com.google.firestore.admin.v1beta1";
 option objc_class_prefix = "GCFS";
 
-
 // A field of an index.
 message IndexField {
   // The mode determines how a field is indexed.
diff --git a/third_party/googleapis/google/firestore/admin/v1beta1/location.proto b/third_party/googleapis/google/firestore/admin/v1beta1/location.proto
index 2e6dff1b9..2201b07dd 100644
--- a/third_party/googleapis/google/firestore/admin/v1beta1/location.proto
+++ b/third_party/googleapis/google/firestore/admin/v1beta1/location.proto
@@ -27,7 +27,6 @@ option java_outer_classname = "LocationProto";
 option java_package = "com.google.firestore.admin.v1beta1";
 option objc_class_prefix = "GCFS";
 
-
 // The metadata message for [google.cloud.location.Location.metadata][google.cloud.location.Location.metadata].
 message LocationMetadata {
 
diff --git a/third_party/googleapis/google/firestore/admin/v1beta2/field.proto b/third_party/googleapis/google/firestore/admin/v1beta2/field.proto
index 8b2599caf..cec355190 100644
--- a/third_party/googleapis/google/firestore/admin/v1beta2/field.proto
+++ b/third_party/googleapis/google/firestore/admin/v1beta2/field.proto
@@ -27,7 +27,6 @@ option java_outer_classname = "FieldProto";
 option java_package = "com.google.firestore.admin.v1beta2";
 option objc_class_prefix = "GCFS";
 
-
 // Represents a single field in the database.
 //
 // Fields are grouped by their "Collection Group", which represent all
@@ -38,14 +37,12 @@ message Field {
     // The indexes supported for this field.
     repeated Index indexes = 1;
 
-    // Output only.
-    // When true, the `Field`'s index configuration is set from the
+    // Output only. When true, the `Field`'s index configuration is set from the
     // configuration specified by the `ancestor_field`.
     // When false, the `Field`'s index configuration is defined explicitly.
     bool uses_ancestor_config = 2;
 
-    // Output only.
-    // Specifies the resource name of the `Field` from which this field's
+    // Output only. Specifies the resource name of the `Field` from which this field's
     // index configuration is set (when `uses_ancestor_config` is true),
     // or from which it *would* be set if this field had no index configuration
     // (when `uses_ancestor_config` is false).
diff --git a/third_party/googleapis/google/firestore/admin/v1beta2/firestore_admin.proto b/third_party/googleapis/google/firestore/admin/v1beta2/firestore_admin.proto
index a1ec525c6..56ca764bd 100644
--- a/third_party/googleapis/google/firestore/admin/v1beta2/firestore_admin.proto
+++ b/third_party/googleapis/google/firestore/admin/v1beta2/firestore_admin.proto
@@ -23,6 +23,7 @@ import "google/firestore/admin/v1beta2/index.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
+import "google/api/client.proto";
 
 option csharp_namespace = "Google.Cloud.Firestore.Admin.V1Beta2";
 option go_package = "google.golang.org/genproto/googleapis/firestore/admin/v1beta2;admin";
@@ -31,10 +32,14 @@ option java_outer_classname = "FirestoreAdminProto";
 option java_package = "com.google.firestore.admin.v1beta2";
 option objc_class_prefix = "GCFS";
 
-
 // Operations are created by service `FirestoreAdmin`, but are accessed via
 // service `google.longrunning.Operations`.
 service FirestoreAdmin {
+  option (google.api.default_host) = "firestore.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/datastore";
+
   // Creates a composite index. This returns a [google.longrunning.Operation][google.longrunning.Operation]
   // which may be used to track the status of the creation. The metadata for
   // the operation will be the type [IndexOperationMetadata][google.firestore.admin.v1beta2.IndexOperationMetadata].
diff --git a/third_party/googleapis/google/firestore/admin/v1beta2/index.proto b/third_party/googleapis/google/firestore/admin/v1beta2/index.proto
index d6c738d87..c5dc6b982 100644
--- a/third_party/googleapis/google/firestore/admin/v1beta2/index.proto
+++ b/third_party/googleapis/google/firestore/admin/v1beta2/index.proto
@@ -26,7 +26,6 @@ option java_outer_classname = "IndexProto";
 option java_package = "com.google.firestore.admin.v1beta2";
 option objc_class_prefix = "GCFS";
 
-
 // Cloud Firestore indexes enable simple and complex queries against
 // documents in a database.
 message Index {
@@ -81,6 +80,11 @@ message Index {
     // against a collection that is the child of a specific document, specified
     // at query time, and that has the collection id specified by the index.
     COLLECTION = 1;
+
+    // Indexes with a collection group query scope specified allow queries
+    // against all collections that has the collection id specified by the
+    // index.
+    COLLECTION_GROUP = 2;
   }
 
   // The state of an index. During index creation, an index will be in the
@@ -113,8 +117,7 @@ message Index {
     NEEDS_REPAIR = 3;
   }
 
-  // Output only.
-  // A server defined name for this index.
+  // Output only. A server defined name for this index.
   // The form of this name for composite indexes will be:
   // `projects/{project_id}/databases/{database_id}/collectionGroups/{collection_id}/indexes/{composite_index_id}`
   // For single field indexes, this field will be empty.
@@ -142,7 +145,6 @@ message Index {
   // field path equal to the field path of the associated field.
   repeated IndexField fields = 3;
 
-  // Output only.
-  // The serving state of the index.
+  // Output only. The serving state of the index.
   State state = 4;
 }
diff --git a/third_party/googleapis/google/firestore/admin/v1beta2/operation.proto b/third_party/googleapis/google/firestore/admin/v1beta2/operation.proto
index 871f1c16f..d9a1f84ee 100644
--- a/third_party/googleapis/google/firestore/admin/v1beta2/operation.proto
+++ b/third_party/googleapis/google/firestore/admin/v1beta2/operation.proto
@@ -28,7 +28,6 @@ option java_outer_classname = "OperationProto";
 option java_package = "com.google.firestore.admin.v1beta2";
 option objc_class_prefix = "GCFS";
 
-
 // Metadata for [google.longrunning.Operation][google.longrunning.Operation] results from
 // [FirestoreAdmin.CreateIndex][google.firestore.admin.v1beta2.FirestoreAdmin.CreateIndex].
 message IndexOperationMetadata {
diff --git a/third_party/googleapis/google/firestore/v1/BUILD.bazel b/third_party/googleapis/google/firestore/v1/BUILD.bazel
new file mode 100644
index 000000000..185854651
--- /dev/null
+++ b/third_party/googleapis/google/firestore/v1/BUILD.bazel
@@ -0,0 +1,372 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "firestore_proto",
+    srcs = [
+        "common.proto",
+        "document.proto",
+        "firestore.proto",
+        "query.proto",
+        "write.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/rpc:status_proto",
+        "//google/type:latlng_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:struct_proto",
+        "@com_google_protobuf//:timestamp_proto",
+        "@com_google_protobuf//:wrappers_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "firestore_proto_with_info",
+    deps = [
+        ":firestore_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "firestore_java_proto",
+    deps = [":firestore_proto"],
+)
+
+java_grpc_library(
+    name = "firestore_java_grpc",
+    srcs = [":firestore_proto"],
+    deps = [":firestore_java_proto"],
+)
+
+java_gapic_library(
+    name = "firestore_java_gapic",
+    src = ":firestore_proto_with_info",
+    gapic_yaml = "firestore_gapic.yaml",
+    package = "google.firestore.v1",
+    service_yaml = "//google/firestore:firestore_v1.yaml",
+    test_deps = [
+        ":firestore_java_grpc",
+    ],
+    deps = [
+        ":firestore_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "firestore_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.firestore.v1.FirestoreClientTest",
+    ],
+    runtime_deps = [":firestore_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-firestore-v1-java",
+    deps = [
+        ":firestore_java_gapic",
+        ":firestore_java_grpc",
+        ":firestore_java_proto",
+        ":firestore_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "firestore_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/firestore/v1",
+    protos = [":firestore_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/rpc:status_go_proto",
+        "//google/type:latlng_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "firestore_go_gapic",
+    srcs = [":firestore_proto_with_info"],
+    grpc_service_config = "firestore_grpc_service_config.json",
+    importpath = "cloud.google.com/go/firestore/apiv1;firestore",
+    service_yaml = "//google/firestore:firestore_v1.yaml",
+    deps = [
+        ":firestore_go_proto",
+    ],
+)
+
+go_test(
+    name = "firestore_go_gapic_test",
+    srcs = [":firestore_go_gapic_srcjar_test"],
+    embed = [":firestore_go_gapic"],
+    importpath = "cloud.google.com/go/firestore/apiv1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-firestore-v1-go",
+    deps = [
+        ":firestore_go_gapic",
+        ":firestore_go_gapic_srcjar-test.srcjar",
+        ":firestore_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "firestore_moved_proto",
+    srcs = [":firestore_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/rpc:status_proto",
+        "//google/type:latlng_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:struct_proto",
+        "@com_google_protobuf//:timestamp_proto",
+        "@com_google_protobuf//:wrappers_proto",
+    ],
+)
+
+py_proto_library(
+    name = "firestore_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":firestore_moved_proto"],
+)
+
+py_grpc_library(
+    name = "firestore_py_grpc",
+    srcs = [":firestore_moved_proto"],
+    deps = [":firestore_py_proto"],
+)
+
+py_gapic_library(
+    name = "firestore_py_gapic",
+    src = ":firestore_proto_with_info",
+    gapic_yaml = "firestore_gapic.yaml",
+    package = "google.firestore.v1",
+    service_yaml = "//google/firestore:firestore_v1.yaml",
+    deps = [
+        ":firestore_py_grpc",
+        ":firestore_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "firestore-v1-py",
+    deps = [
+        ":firestore_py_gapic",
+        ":firestore_py_grpc",
+        ":firestore_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "firestore_php_proto",
+    deps = [":firestore_proto"],
+)
+
+php_grpc_library(
+    name = "firestore_php_grpc",
+    srcs = [":firestore_proto"],
+    deps = [":firestore_php_proto"],
+)
+
+php_gapic_library(
+    name = "firestore_php_gapic",
+    src = ":firestore_proto_with_info",
+    gapic_yaml = "firestore_gapic.legacy.yaml",
+    package = "google.firestore.v1",
+    service_yaml = "//google/firestore:firestore_v1.yaml",
+    deps = [
+        ":firestore_php_grpc",
+        ":firestore_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-firestore-v1-php",
+    deps = [
+        ":firestore_php_gapic",
+        ":firestore_php_grpc",
+        ":firestore_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "firestore_nodejs_gapic",
+    src = ":firestore_proto_with_info",
+    gapic_yaml = "firestore_gapic.yaml",
+    package = "google.firestore.v1",
+    service_yaml = "//google/firestore:firestore_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "firestore-v1-nodejs",
+    deps = [
+        ":firestore_nodejs_gapic",
+        ":firestore_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "firestore_ruby_proto",
+    deps = [":firestore_proto"],
+)
+
+ruby_grpc_library(
+    name = "firestore_ruby_grpc",
+    srcs = [":firestore_proto"],
+    deps = [":firestore_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "firestore_ruby_gapic",
+    src = ":firestore_proto_with_info",
+    gapic_yaml = "firestore_gapic.yaml",
+    package = "google.firestore.v1",
+    service_yaml = "//google/firestore:firestore_v1.yaml",
+    deps = [
+        ":firestore_ruby_grpc",
+        ":firestore_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-firestore-v1-ruby",
+    deps = [
+        ":firestore_ruby_gapic",
+        ":firestore_ruby_grpc",
+        ":firestore_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "firestore_csharp_proto",
+    deps = [":firestore_proto"],
+)
+
+csharp_grpc_library(
+    name = "firestore_csharp_grpc",
+    srcs = [":firestore_proto"],
+    deps = [":firestore_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "firestore_csharp_gapic",
+    src = ":firestore_proto_with_info",
+    gapic_yaml = "firestore_gapic.yaml",
+    package = "google.firestore.v1",
+    service_yaml = "//google/firestore:firestore_v1.yaml",
+    deps = [
+        ":firestore_csharp_grpc",
+        ":firestore_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-firestore-v1-csharp",
+    deps = [
+        ":firestore_csharp_gapic",
+        ":firestore_csharp_grpc",
+        ":firestore_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/firestore/v1/common.proto b/third_party/googleapis/google/firestore/v1/common.proto
index 59c62997a..b6de070a5 100644
--- a/third_party/googleapis/google/firestore/v1/common.proto
+++ b/third_party/googleapis/google/firestore/v1/common.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -28,7 +27,6 @@ option java_package = "com.google.firestore.v1";
 option objc_class_prefix = "GCFS";
 option php_namespace = "Google\\Cloud\\Firestore\\V1";
 
-
 // A set of field paths on a document.
 // Used to restrict a get or update operation on a document to a subset of its
 // fields.
diff --git a/third_party/googleapis/google/firestore/v1/document.proto b/third_party/googleapis/google/firestore/v1/document.proto
index d3d9c11c7..43f69478e 100644
--- a/third_party/googleapis/google/firestore/v1/document.proto
+++ b/third_party/googleapis/google/firestore/v1/document.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -30,7 +29,6 @@ option java_package = "com.google.firestore.v1";
 option objc_class_prefix = "GCFS";
 option php_namespace = "Google\\Cloud\\Firestore\\V1";
 
-
 // A Firestore document.
 //
 // Must not exceed 1 MiB - 4 bytes.
diff --git a/third_party/googleapis/google/firestore/v1/firestore.proto b/third_party/googleapis/google/firestore/v1/firestore.proto
index 5dc9667e2..5f9b6d732 100644
--- a/third_party/googleapis/google/firestore/v1/firestore.proto
+++ b/third_party/googleapis/google/firestore/v1/firestore.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,14 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.firestore.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/firestore/v1/common.proto";
 import "google/firestore/v1/document.proto";
 import "google/firestore/v1/query.proto";
@@ -33,25 +34,23 @@ option java_outer_classname = "FirestoreProto";
 option java_package = "com.google.firestore.v1";
 option objc_class_prefix = "GCFS";
 option php_namespace = "Google\\Cloud\\Firestore\\V1";
+
 // Specification of the Firestore API.
 
 // The Cloud Firestore service.
 //
-// This service exposes several types of comparable timestamps:
-//
-// *    `create_time` - The time at which a document was created. Changes only
-//      when a document is deleted, then re-created. Increases in a strict
-//       monotonic fashion.
-// *    `update_time` - The time at which a document was last updated. Changes
-//      every time a document is modified. Does not change when a write results
-//      in no modifications. Increases in a strict monotonic fashion.
-// *    `read_time` - The time at which a particular state was observed. Used
-//      to denote a consistent snapshot of the database or the time at which a
-//      Document was observed to not exist.
-// *    `commit_time` - The time at which the writes in a transaction were
-//      committed. Any read with an equal or greater `read_time` is guaranteed
-//      to see the effects of the transaction.
+// Cloud Firestore is a fast, fully managed, serverless, cloud-native NoSQL
+// document database that simplifies storing, syncing, and querying data for
+// your mobile, web, and IoT apps at global scale. Its client libraries provide
+// live synchronization and offline support, while its security features and
+// integrations with Firebase and Google Cloud Platform (GCP) accelerate
+// building truly serverless apps.
 service Firestore {
+  option (google.api.default_host) = "firestore.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/datastore";
+
   // Gets a single document.
   rpc GetDocument(GetDocumentRequest) returns (Document) {
     option (google.api.http) = {
@@ -66,20 +65,13 @@ service Firestore {
     };
   }
 
-  // Creates a new document.
-  rpc CreateDocument(CreateDocumentRequest) returns (Document) {
-    option (google.api.http) = {
-      post: "/v1/{parent=projects/*/databases/*/documents/**}/{collection_id}"
-      body: "document"
-    };
-  }
-
   // Updates or inserts a document.
   rpc UpdateDocument(UpdateDocumentRequest) returns (Document) {
     option (google.api.http) = {
       patch: "/v1/{document.name=projects/*/databases/*/documents/*/**}"
       body: "document"
     };
+    option (google.api.method_signature) = "document,update_mask";
   }
 
   // Deletes a document.
@@ -87,6 +79,7 @@ service Firestore {
     option (google.api.http) = {
       delete: "/v1/{name=projects/*/databases/*/documents/*/**}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Gets multiple documents.
@@ -106,6 +99,7 @@ service Firestore {
       post: "/v1/{database=projects/*/databases/*}/documents:beginTransaction"
       body: "*"
     };
+    option (google.api.method_signature) = "database";
   }
 
   // Commits a transaction, while optionally updating documents.
@@ -114,6 +108,7 @@ service Firestore {
       post: "/v1/{database=projects/*/databases/*}/documents:commit"
       body: "*"
     };
+    option (google.api.method_signature) = "database,writes";
   }
 
   // Rolls back a transaction.
@@ -122,6 +117,7 @@ service Firestore {
       post: "/v1/{database=projects/*/databases/*}/documents:rollback"
       body: "*"
     };
+    option (google.api.method_signature) = "database,transaction";
   }
 
   // Runs a query.
@@ -162,14 +158,23 @@ service Firestore {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Creates a new document.
+  rpc CreateDocument(CreateDocumentRequest) returns (Document) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/databases/*/documents/**}/{collection_id}"
+      body: "document"
+    };
   }
 }
 
 // The request for [Firestore.GetDocument][google.firestore.v1.Firestore.GetDocument].
 message GetDocumentRequest {
-  // The resource name of the Document to get. In the format:
+  // Required. The resource name of the Document to get. In the format:
   // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
-  string name = 1;
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The fields to return. If not set, returns all fields.
   //
@@ -191,17 +196,17 @@ message GetDocumentRequest {
 
 // The request for [Firestore.ListDocuments][google.firestore.v1.Firestore.ListDocuments].
 message ListDocumentsRequest {
-  // The parent resource name. In the format:
+  // Required. The parent resource name. In the format:
   // `projects/{project_id}/databases/{database_id}/documents` or
   // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
   // For example:
   // `projects/my-project/databases/my-database/documents` or
   // `projects/my-project/databases/my-database/documents/chatrooms/my-chatroom`
-  string parent = 1;
+  string parent = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // The collection ID, relative to `parent`, to list. For example: `chatrooms`
+  // Required. The collection ID, relative to `parent`, to list. For example: `chatrooms`
   // or `messages`.
-  string collection_id = 2;
+  string collection_id = 2 [(google.api.field_behavior) = REQUIRED];
 
   // The maximum number of documents to return.
   int32 page_size = 3;
@@ -250,21 +255,21 @@ message ListDocumentsResponse {
 
 // The request for [Firestore.CreateDocument][google.firestore.v1.Firestore.CreateDocument].
 message CreateDocumentRequest {
-  // The parent resource. For example:
+  // Required. The parent resource. For example:
   // `projects/{project_id}/databases/{database_id}/documents` or
   // `projects/{project_id}/databases/{database_id}/documents/chatrooms/{chatroom_id}`
-  string parent = 1;
+  string parent = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // The collection ID, relative to `parent`, to list. For example: `chatrooms`.
-  string collection_id = 2;
+  // Required. The collection ID, relative to `parent`, to list. For example: `chatrooms`.
+  string collection_id = 2 [(google.api.field_behavior) = REQUIRED];
 
   // The client-assigned document ID to use for this document.
   //
   // Optional. If not specified, an ID will be assigned by the service.
   string document_id = 3;
 
-  // The document to create. `name` must not be set.
-  Document document = 4;
+  // Required. The document to create. `name` must not be set.
+  Document document = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The fields to return. If not set, returns all fields.
   //
@@ -275,9 +280,9 @@ message CreateDocumentRequest {
 
 // The request for [Firestore.UpdateDocument][google.firestore.v1.Firestore.UpdateDocument].
 message UpdateDocumentRequest {
-  // The updated document.
+  // Required. The updated document.
   // Creates the document if it does not already exist.
-  Document document = 1;
+  Document document = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The fields to update.
   // None of the field paths in the mask may contain a reserved name.
@@ -301,9 +306,9 @@ message UpdateDocumentRequest {
 
 // The request for [Firestore.DeleteDocument][google.firestore.v1.Firestore.DeleteDocument].
 message DeleteDocumentRequest {
-  // The resource name of the Document to delete. In the format:
+  // Required. The resource name of the Document to delete. In the format:
   // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
-  string name = 1;
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
 
   // An optional precondition on the document.
   // The request will fail if this is set and not met by the target document.
@@ -312,9 +317,9 @@ message DeleteDocumentRequest {
 
 // The request for [Firestore.BatchGetDocuments][google.firestore.v1.Firestore.BatchGetDocuments].
 message BatchGetDocumentsRequest {
-  // The database name. In the format:
+  // Required. The database name. In the format:
   // `projects/{project_id}/databases/{database_id}`.
-  string database = 1;
+  string database = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The names of the documents to retrieve. In the format:
   // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
@@ -373,9 +378,9 @@ message BatchGetDocumentsResponse {
 
 // The request for [Firestore.BeginTransaction][google.firestore.v1.Firestore.BeginTransaction].
 message BeginTransactionRequest {
-  // The database name. In the format:
+  // Required. The database name. In the format:
   // `projects/{project_id}/databases/{database_id}`.
-  string database = 1;
+  string database = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The options for the transaction.
   // Defaults to a read-write transaction.
@@ -390,9 +395,9 @@ message BeginTransactionResponse {
 
 // The request for [Firestore.Commit][google.firestore.v1.Firestore.Commit].
 message CommitRequest {
-  // The database name. In the format:
+  // Required. The database name. In the format:
   // `projects/{project_id}/databases/{database_id}`.
-  string database = 1;
+  string database = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The writes to apply.
   //
@@ -411,29 +416,30 @@ message CommitResponse {
   // request.
   repeated WriteResult write_results = 1;
 
-  // The time at which the commit occurred.
+  // The time at which the commit occurred. Any read with an equal or greater
+  // `read_time` is guaranteed to see the effects of the commit.
   google.protobuf.Timestamp commit_time = 2;
 }
 
 // The request for [Firestore.Rollback][google.firestore.v1.Firestore.Rollback].
 message RollbackRequest {
-  // The database name. In the format:
+  // Required. The database name. In the format:
   // `projects/{project_id}/databases/{database_id}`.
-  string database = 1;
+  string database = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // The transaction to roll back.
-  bytes transaction = 2;
+  // Required. The transaction to roll back.
+  bytes transaction = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The request for [Firestore.RunQuery][google.firestore.v1.Firestore.RunQuery].
 message RunQueryRequest {
-  // The parent resource name. In the format:
+  // Required. The parent resource name. In the format:
   // `projects/{project_id}/databases/{database_id}/documents` or
   // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
   // For example:
   // `projects/my-project/databases/my-database/documents` or
   // `projects/my-project/databases/my-database/documents/chatrooms/my-chatroom`
-  string parent = 1;
+  string parent = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The query to run.
   oneof query_type {
@@ -496,10 +502,10 @@ message RunQueryResponse {
 // given token, then a response containing only an up-to-date token, to use in
 // the next request.
 message WriteRequest {
-  // The database name. In the format:
+  // Required. The database name. In the format:
   // `projects/{project_id}/databases/{database_id}`.
   // This is only required in the first message.
-  string database = 1;
+  string database = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The ID of the write stream to resume.
   // This may only be set in the first message. When left empty, a new write
@@ -552,15 +558,16 @@ message WriteResponse {
   // request.
   repeated WriteResult write_results = 3;
 
-  // The time at which the commit occurred.
+  // The time at which the commit occurred. Any read with an equal or greater
+  // `read_time` is guaranteed to see the effects of the write.
   google.protobuf.Timestamp commit_time = 4;
 }
 
 // A request for [Firestore.Listen][google.firestore.v1.Firestore.Listen]
 message ListenRequest {
-  // The database name. In the format:
+  // Required. The database name. In the format:
   // `projects/{project_id}/databases/{database_id}`.
-  string database = 1;
+  string database = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The supported target changes.
   oneof target_change {
@@ -654,14 +661,8 @@ message Target {
     google.protobuf.Timestamp read_time = 11;
   }
 
-  // A client provided target ID.
-  //
-  // If not set, the server will assign an ID for the target.
-  //
-  // Used for resuming a target without changing IDs. The IDs can either be
-  // client-assigned or be server-assigned in a previous stream. All targets
-  // with client provided IDs must be added before adding a target that needs
-  // a server-assigned id.
+  // The target ID that identifies the target on the stream. Must be a positive
+  // number and non-zero.
   int32 target_id = 5;
 
   // If the target should be removed once it is current and consistent.
@@ -706,11 +707,7 @@ message TargetChange {
   //
   // If empty, the change applies to all targets.
   //
-  // For `target_change_type=ADD`, the order of the target IDs matches the order
-  // of the requests to add the targets. This allows clients to unambiguously
-  // associate server-assigned target IDs with added targets.
-  //
-  // For other states, the order of the target IDs is not defined.
+  // The order of the target IDs is not defined.
   repeated int32 target_ids = 2;
 
   // The error that resulted in this change, if applicable.
@@ -737,11 +734,11 @@ message TargetChange {
 
 // The request for [Firestore.ListCollectionIds][google.firestore.v1.Firestore.ListCollectionIds].
 message ListCollectionIdsRequest {
-  // The parent document. In the format:
+  // Required. The parent document. In the format:
   // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
   // For example:
   // `projects/my-project/databases/my-database/documents/chatrooms/my-chatroom`
-  string parent = 1;
+  string parent = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The maximum number of results to return.
   int32 page_size = 2;
diff --git a/third_party/googleapis/google/firestore/v1/firestore_gapic.legacy.yaml b/third_party/googleapis/google/firestore/v1/firestore_gapic.legacy.yaml
new file mode 100644
index 000000000..6200c7bfa
--- /dev/null
+++ b/third_party/googleapis/google/firestore/v1/firestore_gapic.legacy.yaml
@@ -0,0 +1,232 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.firestore.v1
+    release_level: GA
+  python:
+    package_name: google.cloud.firestore_v1.gapic
+    release_level: BETA
+  go:
+    package_name: cloud.google.com/go/firestore/apiv1
+    domain_layer_location: cloud.google.com/go/firestore
+    release_level: GA
+  csharp:
+    package_name: Google.Cloud.Firestore.V1
+    release_level: GA
+  ruby:
+    package_name: Google::Cloud::Firestore::V1
+    release_level: GA
+  php:
+    package_name: Google\Cloud\Firestore\V1
+    release_level: GA
+  nodejs:
+    package_name: firestore.v1
+    domain_layer_location: google-cloud
+    release_level: GA
+interfaces:
+- name: google.firestore.v1.Firestore
+  collections:
+  - name_pattern: projects/{project}/databases/{database}
+    entity_name: database_root
+  - name_pattern: projects/{project}/databases/{database}/documents
+    entity_name: document_root
+  - name_pattern: projects/{project}/databases/{database}/documents/{document_path=**}
+    entity_name: document_path
+  - name_pattern: projects/{project}/databases/{database}/documents/{document}/{any_path=**}
+    entity_name: any_path
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - INTERNAL
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 60000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 60000
+    total_timeout_millis: 600000
+  - name: streaming
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 60000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 60000
+    total_timeout_millis: 600000
+  methods:
+  - name: GetDocument
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: any_path
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+  - name: ListDocuments
+    required_fields:
+    - parent
+    - collection_id
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: documents
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: document_root
+      parent: any_path
+    timeout_millis: 60000
+  - name: CreateDocument
+    required_fields:
+    - parent
+    - collection_id
+    - document_id
+    - document
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: document_root
+      parent: any_path
+    timeout_millis: 60000
+  - name: UpdateDocument
+    flattening:
+      groups:
+      - parameters:
+        - document
+        - update_mask
+    required_fields:
+    - document
+    - update_mask
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      document.name: any_path
+    timeout_millis: 60000
+  - name: DeleteDocument
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: any_path
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+  - name: BatchGetDocuments
+    required_fields:
+    - database
+    - documents
+    retry_codes_name: idempotent
+    retry_params_name: streaming
+    field_name_patterns:
+      database: database_root
+    # Five minutes
+    timeout_millis: 300000
+  - name: BeginTransaction
+    flattening:
+      groups:
+      - parameters:
+        - database
+    required_fields:
+    - database
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      database: database_root
+    timeout_millis: 60000
+  - name: Commit
+    flattening:
+      groups:
+      - parameters:
+        - database
+        - writes
+    required_fields:
+    - database
+    - writes
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      database: database_root
+    timeout_millis: 60000
+  - name: Rollback
+    flattening:
+      groups:
+      - parameters:
+        - database
+        - transaction
+    required_fields:
+    - database
+    - transaction
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      database: database_root
+    timeout_millis: 60000
+  - name: RunQuery
+    required_fields:
+    - parent
+    retry_codes_name: idempotent
+    retry_params_name: streaming
+    field_name_patterns:
+      parent: document_root
+      parent: any_path
+    timeout_millis: 60000
+  - name: Write
+    required_fields:
+    - database
+    retry_codes_name: non_idempotent
+    retry_params_name: streaming
+    field_name_patterns:
+      database: database_root
+    # One day
+    timeout_millis: 86400000
+  - name: Listen
+    required_fields:
+    - database
+    retry_codes_name: idempotent
+    retry_params_name: streaming
+    field_name_patterns:
+      database: database_root
+    # One day
+    timeout_millis: 86400000
+  - name: ListCollectionIds
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: collection_ids
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: document_root
+      parent: any_path
+    timeout_millis: 60000
+resource_name_generation:
+- message_name: GetDocumentRequest
+  field_entity_map:
+    name: any_path
+- message_name: DeleteDocumentRequest
+  field_entity_map:
+    name: any_path
diff --git a/third_party/googleapis/google/firestore/v1/firestore_gapic.yaml b/third_party/googleapis/google/firestore/v1/firestore_gapic.yaml
index a15408c10..7c7e24527 100644
--- a/third_party/googleapis/google/firestore/v1/firestore_gapic.yaml
+++ b/third_party/googleapis/google/firestore/v1/firestore_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.firestore.v1
@@ -26,207 +26,60 @@ language_settings:
     release_level: GA
 interfaces:
 - name: google.firestore.v1.Firestore
-  collections:
-  - name_pattern: projects/{project}/databases/{database}
-    entity_name: database_root
-  - name_pattern: projects/{project}/databases/{database}/documents
-    entity_name: document_root
-  - name_pattern: projects/{project}/databases/{database}/documents/{document_path=**}
-    entity_name: document_path
-  - name_pattern: projects/{project}/databases/{database}/documents/{document}/{any_path=**}
-    entity_name: any_path
   retry_codes_def:
   - name: idempotent
     retry_codes:
     - UNAVAILABLE
+    - INTERNAL
     - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 100
     retry_delay_multiplier: 1.3
     max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
+    initial_rpc_timeout_millis: 60000
     rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
+    max_rpc_timeout_millis: 60000
     total_timeout_millis: 600000
   - name: streaming
     initial_retry_delay_millis: 100
     retry_delay_multiplier: 1.3
     max_retry_delay_millis: 60000
-    # Five minutes
-    initial_rpc_timeout_millis: 300000
+    initial_rpc_timeout_millis: 60000
     rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 300000
+    max_rpc_timeout_millis: 60000
     total_timeout_millis: 600000
   methods:
   - name: GetDocument
-    required_fields:
-    - name
-    retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: any_path
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
   - name: ListDocuments
-    required_fields:
-    - parent
-    - collection_id
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: documents
-    retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      parent: document_root
-      parent: any_path
-    timeout_millis: 60000
   - name: CreateDocument
-    required_fields:
-    - parent
-    - collection_id
-    - document_id
-    - document
-    retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      parent: document_root
-      parent: any_path
-    timeout_millis: 60000
   - name: UpdateDocument
-    flattening:
-      groups:
-      - parameters:
-        - document
-        - update_mask
-    required_fields:
-    - document
-    - update_mask
-    retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      document.name: any_path
-    timeout_millis: 60000
   - name: DeleteDocument
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: any_path
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
   - name: BatchGetDocuments
-    required_fields:
-    - database
-    - documents
     retry_codes_name: idempotent
     retry_params_name: streaming
-    field_name_patterns:
-      database: database_root
-    # Five minutes
-    timeout_millis: 300000
   - name: BeginTransaction
-    flattening:
-      groups:
-      - parameters:
-        - database
-    required_fields:
-    - database
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      database: database_root
-    timeout_millis: 60000
   - name: Commit
-    flattening:
-      groups:
-      - parameters:
-        - database
-        - writes
-    required_fields:
-    - database
-    - writes
-    retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      database: database_root
-    timeout_millis: 60000
   - name: Rollback
-    flattening:
-      groups:
-      - parameters:
-        - database
-        - transaction
-    required_fields:
-    - database
-    - transaction
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      database: database_root
-    timeout_millis: 60000
   - name: RunQuery
-    required_fields:
-    - parent
     retry_codes_name: idempotent
     retry_params_name: streaming
-    field_name_patterns:
-      parent: document_root
-      parent: any_path
-    timeout_millis: 60000
   - name: Write
-    required_fields:
-    - database
-    retry_codes_name: non_idempotent
     retry_params_name: streaming
-    field_name_patterns:
-      database: database_root
-    # One day
-    timeout_millis: 86400000
   - name: Listen
-    required_fields:
-    - database
     retry_codes_name: idempotent
     retry_params_name: streaming
-    field_name_patterns:
-      database: database_root
-    # One day
-    timeout_millis: 86400000
   - name: ListCollectionIds
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: collection_ids
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      parent: document_root
-      parent: any_path
-    timeout_millis: 60000
-resource_name_generation:
-- message_name: GetDocumentRequest
-  field_entity_map:
-    name: any_path
-- message_name: DeleteDocumentRequest
-  field_entity_map:
-    name: any_path
diff --git a/third_party/googleapis/google/firestore/v1/firestore_grpc_service_config.json b/third_party/googleapis/google/firestore/v1/firestore_grpc_service_config.json
new file mode 100755
index 000000000..0c6f86d9c
--- /dev/null
+++ b/third_party/googleapis/google/firestore/v1/firestore_grpc_service_config.json
@@ -0,0 +1,114 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.firestore.v1.Firestore",
+          "method": "CreateDocument"
+        },
+        {
+          "service": "google.firestore.v1.Firestore",
+          "method": "UpdateDocument"
+        },
+        {
+          "service": "google.firestore.v1.Firestore",
+          "method": "Commit"
+        }
+      ],
+      "timeout": "60s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.firestore.v1.Firestore",
+          "method": "BatchGetDocuments"
+        },
+        {
+          "service": "google.firestore.v1.Firestore",
+          "method": "RunQuery"
+        }
+      ],
+      "timeout": "300s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "INTERNAL",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.firestore.v1.Firestore",
+          "method": "Listen"
+        }
+      ],
+      "timeout": "86400s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "INTERNAL",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.firestore.v1.Firestore",
+          "method": "Write"
+        }
+      ],
+      "timeout": "86400s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.firestore.v1.Firestore",
+          "method": "GetDocument"
+        },
+        {
+          "service": "google.firestore.v1.Firestore",
+          "method": "ListDocuments"
+        },
+        {
+          "service": "google.firestore.v1.Firestore",
+          "method": "DeleteDocument"
+        },
+        {
+          "service": "google.firestore.v1.Firestore",
+          "method": "BeginTransaction"
+        },
+        {
+          "service": "google.firestore.v1.Firestore",
+          "method": "Rollback"
+        },
+        {
+          "service": "google.firestore.v1.Firestore",
+          "method": "ListCollectionIds"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "INTERNAL",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/firestore/v1/firestore_v1.yaml b/third_party/googleapis/google/firestore/v1/firestore_v1.yaml
new file mode 100644
index 000000000..e3e6409bc
--- /dev/null
+++ b/third_party/googleapis/google/firestore/v1/firestore_v1.yaml
@@ -0,0 +1,44 @@
+type: google.api.Service
+config_version: 3
+name: firestore.googleapis.com
+title: Cloud Firestore API
+
+apis:
+- name: google.firestore.v1.Firestore
+
+documentation:
+  summary: |-
+    Accesses the NoSQL document database built for automatic scaling, high
+    performance, and ease of application development.
+
+backend:
+  rules:
+  - selector: 'google.firestore.v1.Firestore.*'
+    deadline: 295.0
+  - selector: 'google.longrunning.Operations.*'
+    deadline: 295.0
+
+http:
+  rules:
+  - selector: google.longrunning.Operations.CancelOperation
+    post: '/v1/{name=projects/*/databases/*/operations/*}:cancel'
+    body: '*'
+  - selector: google.longrunning.Operations.DeleteOperation
+    delete: '/v1/{name=projects/*/databases/*/operations/*}'
+  - selector: google.longrunning.Operations.GetOperation
+    get: '/v1/{name=projects/*/databases/*/operations/*}'
+  - selector: google.longrunning.Operations.ListOperations
+    get: '/v1/{name=projects/*/databases/*}/operations'
+
+authentication:
+  rules:
+  - selector: 'google.firestore.v1.Firestore.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/datastore
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/datastore
diff --git a/third_party/googleapis/google/firestore/v1/query.proto b/third_party/googleapis/google/firestore/v1/query.proto
index 48684c060..226d32418 100644
--- a/third_party/googleapis/google/firestore/v1/query.proto
+++ b/third_party/googleapis/google/firestore/v1/query.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -29,7 +28,6 @@ option java_package = "com.google.firestore.v1";
 option objc_class_prefix = "GCFS";
 option php_namespace = "Google\\Cloud\\Firestore\\V1";
 
-
 // A Firestore query.
 message StructuredQuery {
   // A selection of a collection, such as `messages as m1`.
@@ -103,6 +101,14 @@ message StructuredQuery {
 
       // Contains. Requires that the field is an array.
       ARRAY_CONTAINS = 7;
+
+      // In. Requires that `value` is a non-empty ArrayValue with at most 10
+      // values.
+      IN = 8;
+
+      // Contains any. Requires that the field is an array and
+      // `value` is a non-empty ArrayValue with at most 10 values.
+      ARRAY_CONTAINS_ANY = 9;
     }
 
     // The field to filter by.
@@ -115,6 +121,15 @@ message StructuredQuery {
     Value value = 3;
   }
 
+  // The projection of document's fields to return.
+  message Projection {
+    // The fields to return.
+    //
+    // If empty, all fields are returned. To only return the name
+    // of the document, use `['__name__']`.
+    repeated FieldReference fields = 2;
+  }
+
   // A filter with a single operand.
   message UnaryFilter {
     // A unary operator.
@@ -125,7 +140,7 @@ message StructuredQuery {
       // Test if a field is equal to NaN.
       IS_NAN = 2;
 
-      // Test if an exprestion evaluates to Null.
+      // Test if an expression evaluates to Null.
       IS_NULL = 3;
     }
 
@@ -153,15 +168,6 @@ message StructuredQuery {
     Direction direction = 2;
   }
 
-  // The projection of document's fields to return.
-  message Projection {
-    // The fields to return.
-    //
-    // If empty, all fields are returned. To only return the name
-    // of the document, use `['__name__']`.
-    repeated FieldReference fields = 2;
-  }
-
   // A sort direction.
   enum Direction {
     // Unspecified.
diff --git a/third_party/googleapis/google/firestore/v1/write.proto b/third_party/googleapis/google/firestore/v1/write.proto
index 4ab5d833e..403c80f81 100644
--- a/third_party/googleapis/google/firestore/v1/write.proto
+++ b/third_party/googleapis/google/firestore/v1/write.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -30,7 +29,6 @@ option java_package = "com.google.firestore.v1";
 option objc_class_prefix = "GCFS";
 option php_namespace = "Google\\Cloud\\Firestore\\V1";
 
-
 // A write on a document.
 message Write {
   // The operation to execute.
@@ -43,9 +41,6 @@ message Write {
     string delete = 2;
 
     // Applies a transformation to a document.
-    // At most one `transform` per document is allowed in a given request.
-    // An `update` cannot follow a `transform` on the same document in a given
-    // request.
     DocumentTransform transform = 6;
   }
 
@@ -61,6 +56,13 @@ message Write {
   // The field paths in this mask must not contain a reserved field name.
   DocumentMask update_mask = 3;
 
+  // The transforms to perform after update.
+  //
+  // This field can be set only when the operation is `update`. If present, this
+  // write is equivalent to performing `update` and `transform` to the same
+  // document atomically and in order.
+  repeated DocumentTransform.FieldTransform update_transforms = 7;
+
   // An optional precondition on the document.
   //
   // The write will fail if this is set and not met by the target document.
diff --git a/third_party/googleapis/google/firestore/v1beta1/BUILD.bazel b/third_party/googleapis/google/firestore/v1beta1/BUILD.bazel
index 8d4aa5895..d7036fbc0 100644
--- a/third_party/googleapis/google/firestore/v1beta1/BUILD.bazel
+++ b/third_party/googleapis/google/firestore/v1beta1/BUILD.bazel
@@ -1,9 +1,12 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
@@ -17,6 +20,8 @@ proto_library(
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
         "//google/rpc:status_proto",
         "//google/type:latlng_proto",
         "@com_google_protobuf//:empty_proto",
@@ -28,7 +33,10 @@ proto_library(
 
 proto_library_with_info(
     name = "firestore_proto_with_info",
-    deps = [":firestore_proto"],
+    deps = [
+        ":firestore_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -36,18 +44,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
     name = "firestore_java_proto",
     deps = [":firestore_proto"],
@@ -56,51 +59,40 @@ java_proto_library(
 java_grpc_library(
     name = "firestore_java_grpc",
     srcs = [":firestore_proto"],
-    deps = [":firestore_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "firestore_resource_name_java_proto",
-    gapic_yaml = "firestore_gapic.yaml",
-    deps = [":firestore_proto"],
+    deps = [":firestore_java_proto"],
 )
 
 java_gapic_library(
     name = "firestore_java_gapic",
     src = ":firestore_proto_with_info",
     gapic_yaml = "firestore_gapic.yaml",
+    package = "google.firestore.v1beta1",
     service_yaml = "//google/firestore:firestore_v1beta1.yaml",
-    test_deps = [":firestore_java_grpc"],
+    test_deps = [
+        ":firestore_java_grpc",
+    ],
     deps = [
         ":firestore_java_proto",
-        ":firestore_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":firestore_java_gapic_test",
+java_gapic_test(
+    name = "firestore_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.firestore.v1beta1.FirestoreClientTest",
     ],
-) for test_name in [
-    "com.google.cloud.firestore.v1beta1.FirestoreClientTest",
-]]
+    runtime_deps = [":firestore_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-firestore-v1beta1-java",
-    client_deps = [":firestore_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":firestore_java_gapic_test"],
-    grpc_deps = [":firestore_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":firestore_java_gapic",
+        ":firestore_java_grpc",
         ":firestore_java_proto",
         ":firestore_proto",
-        ":firestore_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -108,10 +100,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -128,11 +120,13 @@ go_proto_library(
 
 go_gapic_library(
     name = "firestore_go_gapic",
-    src = ":firestore_proto_with_info",
-    gapic_yaml = "firestore_gapic.yaml",
-    importpath = "cloud.google.com/go/firestore/apiv1beta1",
+    srcs = [":firestore_proto_with_info"],
+    grpc_service_config = "firestore_grpc_service_config.json",
+    importpath = "cloud.google.com/go/firestore/apiv1beta1;firestore",
     service_yaml = "//google/firestore:firestore_v1beta1.yaml",
-    deps = [":firestore_go_proto"],
+    deps = [
+        ":firestore_go_proto",
+    ],
 )
 
 go_test(
@@ -142,13 +136,237 @@ go_test(
     importpath = "cloud.google.com/go/firestore/apiv1beta1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-firestore-v1beta1-go",
     deps = [
         ":firestore_go_gapic",
-        ":firestore_go_gapic_srcjar-smoke-test.srcjar",
         ":firestore_go_gapic_srcjar-test.srcjar",
         ":firestore_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "firestore_moved_proto",
+    srcs = [":firestore_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/rpc:status_proto",
+        "//google/type:latlng_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:struct_proto",
+        "@com_google_protobuf//:timestamp_proto",
+        "@com_google_protobuf//:wrappers_proto",
+    ],
+)
+
+py_proto_library(
+    name = "firestore_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":firestore_moved_proto"],
+)
+
+py_grpc_library(
+    name = "firestore_py_grpc",
+    srcs = [":firestore_moved_proto"],
+    deps = [":firestore_py_proto"],
+)
+
+py_gapic_library(
+    name = "firestore_py_gapic",
+    src = ":firestore_proto_with_info",
+    gapic_yaml = "firestore_gapic.yaml",
+    package = "google.firestore.v1beta1",
+    service_yaml = "//google/firestore:firestore_v1beta1.yaml",
+    deps = [
+        ":firestore_py_grpc",
+        ":firestore_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "firestore-v1beta1-py",
+    deps = [
+        ":firestore_py_gapic",
+        ":firestore_py_grpc",
+        ":firestore_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "firestore_php_proto",
+    deps = [":firestore_proto"],
+)
+
+php_grpc_library(
+    name = "firestore_php_grpc",
+    srcs = [":firestore_proto"],
+    deps = [":firestore_php_proto"],
+)
+
+php_gapic_library(
+    name = "firestore_php_gapic",
+    src = ":firestore_proto_with_info",
+    gapic_yaml = "firestore_gapic.yaml",
+    package = "google.firestore.v1beta1",
+    service_yaml = "//google/firestore:firestore_v1beta1.yaml",
+    deps = [
+        ":firestore_php_grpc",
+        ":firestore_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-firestore-v1beta1-php",
+    deps = [
+        ":firestore_php_gapic",
+        ":firestore_php_grpc",
+        ":firestore_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "firestore_nodejs_gapic",
+    src = ":firestore_proto_with_info",
+    gapic_yaml = "firestore_gapic.yaml",
+    package = "google.firestore.v1beta1",
+    service_yaml = "//google/firestore:firestore_v1beta1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "firestore-v1beta1-nodejs",
+    deps = [
+        ":firestore_nodejs_gapic",
+        ":firestore_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "firestore_ruby_proto",
+    deps = [":firestore_proto"],
+)
+
+ruby_grpc_library(
+    name = "firestore_ruby_grpc",
+    srcs = [":firestore_proto"],
+    deps = [":firestore_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "firestore_ruby_gapic",
+    src = ":firestore_proto_with_info",
+    gapic_yaml = "firestore_gapic.yaml",
+    package = "google.firestore.v1beta1",
+    service_yaml = "//google/firestore:firestore_v1beta1.yaml",
+    deps = [
+        ":firestore_ruby_grpc",
+        ":firestore_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-firestore-v1beta1-ruby",
+    deps = [
+        ":firestore_ruby_gapic",
+        ":firestore_ruby_grpc",
+        ":firestore_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "firestore_csharp_proto",
+    deps = [":firestore_proto"],
+)
+
+csharp_grpc_library(
+    name = "firestore_csharp_grpc",
+    srcs = [":firestore_proto"],
+    deps = [":firestore_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "firestore_csharp_gapic",
+    src = ":firestore_proto_with_info",
+    gapic_yaml = "firestore_gapic.yaml",
+    package = "google.firestore.v1beta1",
+    service_yaml = "//google/firestore:firestore_v1beta1.yaml",
+    deps = [
+        ":firestore_csharp_grpc",
+        ":firestore_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-firestore-v1beta1-csharp",
+    deps = [
+        ":firestore_csharp_gapic",
+        ":firestore_csharp_grpc",
+        ":firestore_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/firestore/v1beta1/common.proto b/third_party/googleapis/google/firestore/v1beta1/common.proto
index 87c88a3be..2eaa18347 100644
--- a/third_party/googleapis/google/firestore/v1beta1/common.proto
+++ b/third_party/googleapis/google/firestore/v1beta1/common.proto
@@ -28,7 +28,6 @@ option java_package = "com.google.firestore.v1beta1";
 option objc_class_prefix = "GCFS";
 option php_namespace = "Google\\Cloud\\Firestore\\V1beta1";
 
-
 // A set of field paths on a document.
 // Used to restrict a get or update operation on a document to a subset of its
 // fields.
diff --git a/third_party/googleapis/google/firestore/v1beta1/document.proto b/third_party/googleapis/google/firestore/v1beta1/document.proto
index 8a043df59..7caae4688 100644
--- a/third_party/googleapis/google/firestore/v1beta1/document.proto
+++ b/third_party/googleapis/google/firestore/v1beta1/document.proto
@@ -30,7 +30,6 @@ option java_package = "com.google.firestore.v1beta1";
 option objc_class_prefix = "GCFS";
 option php_namespace = "Google\\Cloud\\Firestore\\V1beta1";
 
-
 // A Firestore document.
 //
 // Must not exceed 1 MiB - 4 bytes.
diff --git a/third_party/googleapis/google/firestore/v1beta1/firestore.proto b/third_party/googleapis/google/firestore/v1beta1/firestore.proto
index b7ba79075..c2b15b048 100644
--- a/third_party/googleapis/google/firestore/v1beta1/firestore.proto
+++ b/third_party/googleapis/google/firestore/v1beta1/firestore.proto
@@ -18,6 +18,8 @@ syntax = "proto3";
 package google.firestore.v1beta1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/firestore/v1beta1/common.proto";
 import "google/firestore/v1beta1/document.proto";
 import "google/firestore/v1beta1/query.proto";
@@ -33,6 +35,7 @@ option java_outer_classname = "FirestoreProto";
 option java_package = "com.google.firestore.v1beta1";
 option objc_class_prefix = "GCFS";
 option php_namespace = "Google\\Cloud\\Firestore\\V1beta1";
+
 // Specification of the Firestore API.
 
 // The Cloud Firestore service.
@@ -52,6 +55,11 @@ option php_namespace = "Google\\Cloud\\Firestore\\V1beta1";
 //      committed. Any read with an equal or greater `read_time` is guaranteed
 //      to see the effects of the transaction.
 service Firestore {
+  option (google.api.default_host) = "firestore.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/datastore";
+
   // Gets a single document.
   rpc GetDocument(GetDocumentRequest) returns (Document) {
     option (google.api.http) = {
@@ -80,6 +88,7 @@ service Firestore {
       patch: "/v1beta1/{document.name=projects/*/databases/*/documents/*/**}"
       body: "document"
     };
+    option (google.api.method_signature) = "document,update_mask";
   }
 
   // Deletes a document.
@@ -87,6 +96,7 @@ service Firestore {
     option (google.api.http) = {
       delete: "/v1beta1/{name=projects/*/databases/*/documents/*/**}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Gets multiple documents.
@@ -106,6 +116,7 @@ service Firestore {
       post: "/v1beta1/{database=projects/*/databases/*}/documents:beginTransaction"
       body: "*"
     };
+    option (google.api.method_signature) = "database";
   }
 
   // Commits a transaction, while optionally updating documents.
@@ -114,6 +125,7 @@ service Firestore {
       post: "/v1beta1/{database=projects/*/databases/*}/documents:commit"
       body: "*"
     };
+    option (google.api.method_signature) = "database,writes";
   }
 
   // Rolls back a transaction.
@@ -122,6 +134,7 @@ service Firestore {
       post: "/v1beta1/{database=projects/*/databases/*}/documents:rollback"
       body: "*"
     };
+    option (google.api.method_signature) = "database,transaction";
   }
 
   // Runs a query.
@@ -162,14 +175,15 @@ service Firestore {
         body: "*"
       }
     };
+    option (google.api.method_signature) = "parent";
   }
 }
 
 // The request for [Firestore.GetDocument][google.firestore.v1beta1.Firestore.GetDocument].
 message GetDocumentRequest {
-  // The resource name of the Document to get. In the format:
+  // Required. The resource name of the Document to get. In the format:
   // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
-  string name = 1;
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The fields to return. If not set, returns all fields.
   //
@@ -191,17 +205,17 @@ message GetDocumentRequest {
 
 // The request for [Firestore.ListDocuments][google.firestore.v1beta1.Firestore.ListDocuments].
 message ListDocumentsRequest {
-  // The parent resource name. In the format:
+  // Required. The parent resource name. In the format:
   // `projects/{project_id}/databases/{database_id}/documents` or
   // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
   // For example:
   // `projects/my-project/databases/my-database/documents` or
   // `projects/my-project/databases/my-database/documents/chatrooms/my-chatroom`
-  string parent = 1;
+  string parent = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // The collection ID, relative to `parent`, to list. For example: `chatrooms`
+  // Required. The collection ID, relative to `parent`, to list. For example: `chatrooms`
   // or `messages`.
-  string collection_id = 2;
+  string collection_id = 2 [(google.api.field_behavior) = REQUIRED];
 
   // The maximum number of documents to return.
   int32 page_size = 3;
@@ -250,21 +264,21 @@ message ListDocumentsResponse {
 
 // The request for [Firestore.CreateDocument][google.firestore.v1beta1.Firestore.CreateDocument].
 message CreateDocumentRequest {
-  // The parent resource. For example:
+  // Required. The parent resource. For example:
   // `projects/{project_id}/databases/{database_id}/documents` or
   // `projects/{project_id}/databases/{database_id}/documents/chatrooms/{chatroom_id}`
-  string parent = 1;
+  string parent = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // The collection ID, relative to `parent`, to list. For example: `chatrooms`.
-  string collection_id = 2;
+  // Required. The collection ID, relative to `parent`, to list. For example: `chatrooms`.
+  string collection_id = 2 [(google.api.field_behavior) = REQUIRED];
 
   // The client-assigned document ID to use for this document.
   //
   // Optional. If not specified, an ID will be assigned by the service.
   string document_id = 3;
 
-  // The document to create. `name` must not be set.
-  Document document = 4;
+  // Required. The document to create. `name` must not be set.
+  Document document = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The fields to return. If not set, returns all fields.
   //
@@ -275,9 +289,9 @@ message CreateDocumentRequest {
 
 // The request for [Firestore.UpdateDocument][google.firestore.v1beta1.Firestore.UpdateDocument].
 message UpdateDocumentRequest {
-  // The updated document.
+  // Required. The updated document.
   // Creates the document if it does not already exist.
-  Document document = 1;
+  Document document = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The fields to update.
   // None of the field paths in the mask may contain a reserved name.
@@ -301,9 +315,9 @@ message UpdateDocumentRequest {
 
 // The request for [Firestore.DeleteDocument][google.firestore.v1beta1.Firestore.DeleteDocument].
 message DeleteDocumentRequest {
-  // The resource name of the Document to delete. In the format:
+  // Required. The resource name of the Document to delete. In the format:
   // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
-  string name = 1;
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
 
   // An optional precondition on the document.
   // The request will fail if this is set and not met by the target document.
@@ -312,9 +326,9 @@ message DeleteDocumentRequest {
 
 // The request for [Firestore.BatchGetDocuments][google.firestore.v1beta1.Firestore.BatchGetDocuments].
 message BatchGetDocumentsRequest {
-  // The database name. In the format:
+  // Required. The database name. In the format:
   // `projects/{project_id}/databases/{database_id}`.
-  string database = 1;
+  string database = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The names of the documents to retrieve. In the format:
   // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
@@ -373,9 +387,9 @@ message BatchGetDocumentsResponse {
 
 // The request for [Firestore.BeginTransaction][google.firestore.v1beta1.Firestore.BeginTransaction].
 message BeginTransactionRequest {
-  // The database name. In the format:
+  // Required. The database name. In the format:
   // `projects/{project_id}/databases/{database_id}`.
-  string database = 1;
+  string database = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The options for the transaction.
   // Defaults to a read-write transaction.
@@ -390,9 +404,9 @@ message BeginTransactionResponse {
 
 // The request for [Firestore.Commit][google.firestore.v1beta1.Firestore.Commit].
 message CommitRequest {
-  // The database name. In the format:
+  // Required. The database name. In the format:
   // `projects/{project_id}/databases/{database_id}`.
-  string database = 1;
+  string database = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The writes to apply.
   //
@@ -417,23 +431,23 @@ message CommitResponse {
 
 // The request for [Firestore.Rollback][google.firestore.v1beta1.Firestore.Rollback].
 message RollbackRequest {
-  // The database name. In the format:
+  // Required. The database name. In the format:
   // `projects/{project_id}/databases/{database_id}`.
-  string database = 1;
+  string database = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // The transaction to roll back.
-  bytes transaction = 2;
+  // Required. The transaction to roll back.
+  bytes transaction = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The request for [Firestore.RunQuery][google.firestore.v1beta1.Firestore.RunQuery].
 message RunQueryRequest {
-  // The parent resource name. In the format:
+  // Required. The parent resource name. In the format:
   // `projects/{project_id}/databases/{database_id}/documents` or
   // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
   // For example:
   // `projects/my-project/databases/my-database/documents` or
   // `projects/my-project/databases/my-database/documents/chatrooms/my-chatroom`
-  string parent = 1;
+  string parent = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The query to run.
   oneof query_type {
@@ -496,10 +510,10 @@ message RunQueryResponse {
 // given token, then a response containing only an up-to-date token, to use in
 // the next request.
 message WriteRequest {
-  // The database name. In the format:
+  // Required. The database name. In the format:
   // `projects/{project_id}/databases/{database_id}`.
   // This is only required in the first message.
-  string database = 1;
+  string database = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The ID of the write stream to resume.
   // This may only be set in the first message. When left empty, a new write
@@ -558,9 +572,9 @@ message WriteResponse {
 
 // A request for [Firestore.Listen][google.firestore.v1beta1.Firestore.Listen]
 message ListenRequest {
-  // The database name. In the format:
+  // Required. The database name. In the format:
   // `projects/{project_id}/databases/{database_id}`.
-  string database = 1;
+  string database = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The supported target changes.
   oneof target_change {
@@ -654,14 +668,8 @@ message Target {
     google.protobuf.Timestamp read_time = 11;
   }
 
-  // A client provided target ID.
-  //
-  // If not set, the server will assign an ID for the target.
-  //
-  // Used for resuming a target without changing IDs. The IDs can either be
-  // client-assigned or be server-assigned in a previous stream. All targets
-  // with client provided IDs must be added before adding a target that needs
-  // a server-assigned id.
+  // The target ID that identifies the target on the stream. Must be a positive
+  // number and non-zero.
   int32 target_id = 5;
 
   // If the target should be removed once it is current and consistent.
@@ -706,11 +714,7 @@ message TargetChange {
   //
   // If empty, the change applies to all targets.
   //
-  // For `target_change_type=ADD`, the order of the target IDs matches the order
-  // of the requests to add the targets. This allows clients to unambiguously
-  // associate server-assigned target IDs with added targets.
-  //
-  // For other states, the order of the target IDs is not defined.
+  // The order of the target IDs is not defined.
   repeated int32 target_ids = 2;
 
   // The error that resulted in this change, if applicable.
@@ -737,11 +741,11 @@ message TargetChange {
 
 // The request for [Firestore.ListCollectionIds][google.firestore.v1beta1.Firestore.ListCollectionIds].
 message ListCollectionIdsRequest {
-  // The parent document. In the format:
+  // Required. The parent document. In the format:
   // `projects/{project_id}/databases/{database_id}/documents/{document_path}`.
   // For example:
   // `projects/my-project/databases/my-database/documents/chatrooms/my-chatroom`
-  string parent = 1;
+  string parent = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The maximum number of results to return.
   int32 page_size = 2;
diff --git a/third_party/googleapis/google/firestore/v1beta1/firestore_gapic.legacy.yaml b/third_party/googleapis/google/firestore/v1beta1/firestore_gapic.legacy.yaml
new file mode 100644
index 000000000..257e0e247
--- /dev/null
+++ b/third_party/googleapis/google/firestore/v1beta1/firestore_gapic.legacy.yaml
@@ -0,0 +1,228 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.firestore.v1beta1
+  python:
+    package_name: google.cloud.firestore_v1beta1.gapic
+    release_level: ALPHA
+  go:
+    package_name: cloud.google.com/go/firestore/apiv1beta1
+    domain_layer_location: cloud.google.com/go/firestore
+    release_level: BETA
+  csharp:
+    package_name: Google.Cloud.Firestore.V1Beta1
+  ruby:
+    package_name: Google::Cloud::Firestore::V1beta1
+    release_level: GA
+  php:
+    package_name: Google\Cloud\Firestore\V1beta1
+  nodejs:
+    package_name: firestore.v1beta1
+    domain_layer_location: google-cloud
+interfaces:
+- name: google.firestore.v1beta1.Firestore
+  collections:
+  - name_pattern: projects/{project}/databases/{database}
+    entity_name: database_root
+  - name_pattern: projects/{project}/databases/{database}/documents
+    entity_name: document_root
+  - name_pattern: projects/{project}/databases/{database}/documents/{document_path=**}
+    entity_name: document_path
+  - name_pattern: projects/{project}/databases/{database}/documents/{document}/{any_path=**}
+    entity_name: any_path
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  - name: streaming
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    # Five minutes
+    initial_rpc_timeout_millis: 300000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 300000
+    total_timeout_millis: 600000
+  methods:
+  - name: GetDocument
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: any_path
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+  - name: ListDocuments
+    required_fields:
+    - parent
+    - collection_id
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: documents
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: document_root
+      parent: any_path
+    timeout_millis: 60000
+  - name: CreateDocument
+    required_fields:
+    - parent
+    - collection_id
+    - document_id
+    - document
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: document_root
+      parent: any_path
+    timeout_millis: 60000
+  - name: UpdateDocument
+    flattening:
+      groups:
+      - parameters:
+        - document
+        - update_mask
+    required_fields:
+    - document
+    - update_mask
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      document.name: any_path
+    timeout_millis: 60000
+  - name: DeleteDocument
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: any_path
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+  - name: BatchGetDocuments
+    required_fields:
+    - database
+    - documents
+    retry_codes_name: idempotent
+    retry_params_name: streaming
+    field_name_patterns:
+      database: database_root
+    # Five minutes
+    timeout_millis: 300000
+  - name: BeginTransaction
+    flattening:
+      groups:
+      - parameters:
+        - database
+    required_fields:
+    - database
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      database: database_root
+    timeout_millis: 60000
+  - name: Commit
+    flattening:
+      groups:
+      - parameters:
+        - database
+        - writes
+    required_fields:
+    - database
+    - writes
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      database: database_root
+    timeout_millis: 60000
+  - name: Rollback
+    flattening:
+      groups:
+      - parameters:
+        - database
+        - transaction
+    required_fields:
+    - database
+    - transaction
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      database: database_root
+    timeout_millis: 60000
+  - name: RunQuery
+    required_fields:
+    - parent
+    retry_codes_name: idempotent
+    retry_params_name: streaming
+    field_name_patterns:
+      parent: document_root
+      parent: any_path
+    timeout_millis: 60000
+  - name: Write
+    required_fields:
+    - database
+    retry_codes_name: non_idempotent
+    retry_params_name: streaming
+    field_name_patterns:
+      database: database_root
+    # One day
+    timeout_millis: 86400000
+  - name: Listen
+    required_fields:
+    - database
+    retry_codes_name: idempotent
+    retry_params_name: streaming
+    field_name_patterns:
+      database: database_root
+    # One day
+    timeout_millis: 86400000
+  - name: ListCollectionIds
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: collection_ids
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: document_root
+      parent: any_path
+    timeout_millis: 60000
+resource_name_generation:
+- message_name: GetDocumentRequest
+  field_entity_map:
+    name: any_path
+- message_name: DeleteDocumentRequest
+  field_entity_map:
+    name: any_path
diff --git a/third_party/googleapis/google/firestore/v1beta1/firestore_gapic.yaml b/third_party/googleapis/google/firestore/v1beta1/firestore_gapic.yaml
index 9f4f05aaa..ffa1b0da6 100644
--- a/third_party/googleapis/google/firestore/v1beta1/firestore_gapic.yaml
+++ b/third_party/googleapis/google/firestore/v1beta1/firestore_gapic.yaml
@@ -1,10 +1,11 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.firestore.v1beta1
   python:
     package_name: google.cloud.firestore_v1beta1.gapic
+    release_level: ALPHA
   go:
     package_name: cloud.google.com/go/firestore/apiv1beta1
     domain_layer_location: cloud.google.com/go/firestore
@@ -13,7 +14,7 @@ language_settings:
     package_name: Google.Cloud.Firestore.V1Beta1
   ruby:
     package_name: Google::Cloud::Firestore::V1beta1
-    release_level: BETA
+    release_level: GA
   php:
     package_name: Google\Cloud\Firestore\V1beta1
   nodejs:
@@ -21,22 +22,6 @@ language_settings:
     domain_layer_location: google-cloud
 interfaces:
 - name: google.firestore.v1beta1.Firestore
-  collections:
-  - name_pattern: projects/{project}/databases/{database}
-    entity_name: database_root
-  - name_pattern: projects/{project}/databases/{database}/documents
-    entity_name: document_root
-  - name_pattern: projects/{project}/databases/{database}/documents/{document_path=**}
-    entity_name: document_path
-  - name_pattern: projects/{project}/databases/{database}/documents/{document}/{any_path=**}
-    entity_name: any_path
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 100
@@ -56,172 +41,22 @@ interfaces:
     max_rpc_timeout_millis: 300000
     total_timeout_millis: 600000
   methods:
-  - name: GetDocument
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: any_path
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
-  - name: ListDocuments
-    required_fields:
-    - parent
-    - collection_id
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: documents
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: document_root
-      parent: any_path
-    timeout_millis: 60000
-  - name: CreateDocument
-    required_fields:
-    - parent
-    - collection_id
-    - document_id
-    - document
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: document_root
-      parent: any_path
-    timeout_millis: 60000
-  - name: UpdateDocument
-    flattening:
-      groups:
-      - parameters:
-        - document
-        - update_mask
-    required_fields:
-    - document
-    - update_mask
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      document.name: any_path
-    timeout_millis: 60000
   - name: DeleteDocument
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: any_path
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
   - name: BatchGetDocuments
-    required_fields:
-    - database
-    - documents
     retry_codes_name: idempotent
     retry_params_name: streaming
-    field_name_patterns:
-      database: database_root
-    # Five minutes
-    timeout_millis: 300000
   - name: BeginTransaction
-    flattening:
-      groups:
-      - parameters:
-        - database
-    required_fields:
-    - database
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      database: database_root
-    timeout_millis: 60000
-  - name: Commit
-    flattening:
-      groups:
-      - parameters:
-        - database
-        - writes
-    required_fields:
-    - database
-    - writes
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      database: database_root
-    timeout_millis: 60000
   - name: Rollback
-    flattening:
-      groups:
-      - parameters:
-        - database
-        - transaction
-    required_fields:
-    - database
-    - transaction
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      database: database_root
-    timeout_millis: 60000
   - name: RunQuery
-    required_fields:
-    - parent
     retry_codes_name: idempotent
     retry_params_name: streaming
-    field_name_patterns:
-      parent: document_root
-      parent: any_path
-    timeout_millis: 60000
   - name: Write
-    required_fields:
-    - database
-    retry_codes_name: non_idempotent
     retry_params_name: streaming
-    field_name_patterns:
-      database: database_root
-    # One day
-    timeout_millis: 86400000
   - name: Listen
-    required_fields:
-    - database
     retry_codes_name: idempotent
     retry_params_name: streaming
-    field_name_patterns:
-      database: database_root
-    # One day
-    timeout_millis: 86400000
   - name: ListCollectionIds
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: collection_ids
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: document_root
-      parent: any_path
-    timeout_millis: 60000
-resource_name_generation:
-- message_name: GetDocumentRequest
-  field_entity_map:
-    name: any_path
-- message_name: DeleteDocumentRequest
-  field_entity_map:
-    name: any_path
diff --git a/third_party/googleapis/google/firestore/v1beta1/firestore_grpc_service_config.json b/third_party/googleapis/google/firestore/v1beta1/firestore_grpc_service_config.json
new file mode 100755
index 000000000..8f435df8f
--- /dev/null
+++ b/third_party/googleapis/google/firestore/v1beta1/firestore_grpc_service_config.json
@@ -0,0 +1,111 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.firestore.v1beta1.Firestore",
+          "method": "GetDocument"
+        },
+        {
+          "service": "google.firestore.v1beta1.Firestore",
+          "method": "ListDocuments"
+        },
+        {
+          "service": "google.firestore.v1beta1.Firestore",
+          "method": "DeleteDocument"
+        },
+        {
+          "service": "google.firestore.v1beta1.Firestore",
+          "method": "BeginTransaction"
+        },
+        {
+          "service": "google.firestore.v1beta1.Firestore",
+          "method": "Rollback"
+        },
+        {
+          "service": "google.firestore.v1beta1.Firestore",
+          "method": "ListCollectionIds"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.firestore.v1beta1.Firestore",
+          "method": "CreateDocument"
+        },
+        {
+          "service": "google.firestore.v1beta1.Firestore",
+          "method": "UpdateDocument"
+        },
+        {
+          "service": "google.firestore.v1beta1.Firestore",
+          "method": "Commit"
+        }
+      ],
+      "timeout": "60s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.firestore.v1beta1.Firestore",
+          "method": "BatchGetDocuments"
+        },
+        {
+          "service": "google.firestore.v1beta1.Firestore",
+          "method": "RunQuery"
+        }
+      ],
+      "timeout": "300s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.firestore.v1beta1.Firestore",
+          "method": "Listen"
+        }
+      ],
+      "timeout": "86400s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.firestore.v1beta1.Firestore",
+          "method": "Write"
+        }
+      ],
+      "timeout": "86400s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/firestore/v1beta1/firestore_v1beta1.yaml b/third_party/googleapis/google/firestore/v1beta1/firestore_v1beta1.yaml
new file mode 100644
index 000000000..819b0d6d3
--- /dev/null
+++ b/third_party/googleapis/google/firestore/v1beta1/firestore_v1beta1.yaml
@@ -0,0 +1,32 @@
+type: google.api.Service
+config_version: 3
+name: firestore.googleapis.com
+title: Cloud Firestore API
+
+apis:
+- name: google.firestore.v1beta1.Firestore
+
+documentation:
+  summary: |-
+    Accesses the NoSQL document database built for automatic scaling, high
+    performance, and ease of application development.
+
+backend:
+  rules:
+  - selector: 'google.firestore.v1beta1.Firestore.*'
+    deadline: 295.0
+  - selector: 'google.longrunning.Operations.*'
+    deadline: 295.0
+
+authentication:
+  rules:
+  - selector: 'google.firestore.v1beta1.Firestore.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/datastore
+  - selector: 'google.longrunning.Operations.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/datastore
diff --git a/third_party/googleapis/google/firestore/v1beta1/query.proto b/third_party/googleapis/google/firestore/v1beta1/query.proto
index 94eec9cbb..4f515fabe 100644
--- a/third_party/googleapis/google/firestore/v1beta1/query.proto
+++ b/third_party/googleapis/google/firestore/v1beta1/query.proto
@@ -29,7 +29,6 @@ option java_package = "com.google.firestore.v1beta1";
 option objc_class_prefix = "GCFS";
 option php_namespace = "Google\\Cloud\\Firestore\\V1beta1";
 
-
 // A Firestore query.
 message StructuredQuery {
   // A selection of a collection, such as `messages as m1`.
@@ -103,6 +102,14 @@ message StructuredQuery {
 
       // Contains. Requires that the field is an array.
       ARRAY_CONTAINS = 7;
+
+      // In. Requires that `value` is a non-empty ArrayValue with at most 10
+      // values.
+      IN = 8;
+
+      // Contains any. Requires that the field is an array and
+      // `value` is a non-empty ArrayValue with at most 10 values.
+      ARRAY_CONTAINS_ANY = 9;
     }
 
     // The field to filter by.
@@ -115,15 +122,6 @@ message StructuredQuery {
     Value value = 3;
   }
 
-  // The projection of document's fields to return.
-  message Projection {
-    // The fields to return.
-    //
-    // If empty, all fields are returned. To only return the name
-    // of the document, use `['__name__']`.
-    repeated FieldReference fields = 2;
-  }
-
   // A filter with a single operand.
   message UnaryFilter {
     // A unary operator.
@@ -134,7 +132,7 @@ message StructuredQuery {
       // Test if a field is equal to NaN.
       IS_NAN = 2;
 
-      // Test if an exprestion evaluates to Null.
+      // Test if an expression evaluates to Null.
       IS_NULL = 3;
     }
 
@@ -157,6 +155,20 @@ message StructuredQuery {
     Direction direction = 2;
   }
 
+  // A reference to a field, such as `max(messages.time) as max_time`.
+  message FieldReference {
+    string field_path = 2;
+  }
+
+  // The projection of document's fields to return.
+  message Projection {
+    // The fields to return.
+    //
+    // If empty, all fields are returned. To only return the name
+    // of the document, use `['__name__']`.
+    repeated FieldReference fields = 2;
+  }
+
   // A sort direction.
   enum Direction {
     // Unspecified.
@@ -169,11 +181,6 @@ message StructuredQuery {
     DESCENDING = 2;
   }
 
-  // A reference to a field, such as `max(messages.time) as max_time`.
-  message FieldReference {
-    string field_path = 2;
-  }
-
   // The projection to return.
   Projection select = 1;
 
diff --git a/third_party/googleapis/google/firestore/v1beta1/write.proto b/third_party/googleapis/google/firestore/v1beta1/write.proto
index 4e58cc121..c02a2a8a1 100644
--- a/third_party/googleapis/google/firestore/v1beta1/write.proto
+++ b/third_party/googleapis/google/firestore/v1beta1/write.proto
@@ -30,7 +30,6 @@ option java_package = "com.google.firestore.v1beta1";
 option objc_class_prefix = "GCFS";
 option php_namespace = "Google\\Cloud\\Firestore\\V1beta1";
 
-
 // A write on a document.
 message Write {
   // The operation to execute.
diff --git a/third_party/googleapis/google/geo/type/BUILD.bazel b/third_party/googleapis/google/geo/type/BUILD.bazel
new file mode 100644
index 000000000..125d37de2
--- /dev/null
+++ b/third_party/googleapis/google/geo/type/BUILD.bazel
@@ -0,0 +1,41 @@
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "cc_proto_library", "go_proto_library", "java_proto_library")
+
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+proto_library(
+    name = "viewport_proto",
+    srcs = ["viewport.proto"],
+    deps = ["//google/type:latlng_proto"],
+)
+
+##############################################################################
+# Java
+##############################################################################
+java_proto_library(
+    name = "viewport_java_proto",
+    deps = [
+        ":viewport_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+go_proto_library(
+    name = "viewport_go_proto",
+    importpath = "google.golang.org/genproto/googleapis/geo/type",
+    protos = [":viewport_proto"],
+    deps = ["//google/type:latlng_go_proto"],
+)
+
+##############################################################################
+# C++
+##############################################################################
+cc_proto_library(
+    name = "viewport_cc_proto",
+    deps = [":viewport_proto"],
+)
diff --git a/third_party/googleapis/google/geo/type/type_geo.yaml b/third_party/googleapis/google/geo/type/type_geo.yaml
new file mode 100644
index 000000000..f39f9dcc1
--- /dev/null
+++ b/third_party/googleapis/google/geo/type/type_geo.yaml
@@ -0,0 +1,18 @@
+type: google.api.Service
+config_version: 1
+name: type.geo.googleapis.com
+title: Common Geo Types
+
+types:
+- name: google.geo.type.Viewport
+
+documentation:
+  summary: Defines common types for Google Geo APIs.
+  overview: |-
+    # Google Common Geo Types
+
+    This package contains definitions of common types for Google Geo APIs. All
+    types defined in this package are suitable for different APIs to exchange
+    data, and will never break binary compatibility. They should have design
+    quality
+    comparable to major programming languages like Java and C#.
diff --git a/third_party/googleapis/google/geo/type/viewport.proto b/third_party/googleapis/google/geo/type/viewport.proto
new file mode 100644
index 000000000..ad5029f83
--- /dev/null
+++ b/third_party/googleapis/google/geo/type/viewport.proto
@@ -0,0 +1,69 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.geo.type;
+
+import "google/type/latlng.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/geo/type/viewport;viewport";
+option java_multiple_files = true;
+option java_outer_classname = "ViewportProto";
+option java_package = "com.google.geo.type";
+option objc_class_prefix = "GGTP";
+
+// A latitude-longitude viewport, represented as two diagonally opposite `low`
+// and `high` points. A viewport is considered a closed region, i.e. it includes
+// its boundary. The latitude bounds must range between -90 to 90 degrees
+// inclusive, and the longitude bounds must range between -180 to 180 degrees
+// inclusive. Various cases include:
+//
+//  - If `low` = `high`, the viewport consists of that single point.
+//
+//  - If `low.longitude` > `high.longitude`, the longitude range is inverted
+//    (the viewport crosses the 180 degree longitude line).
+//
+//  - If `low.longitude` = -180 degrees and `high.longitude` = 180 degrees,
+//    the viewport includes all longitudes.
+//
+//  - If `low.longitude` = 180 degrees and `high.longitude` = -180 degrees,
+//    the longitude range is empty.
+//
+//  - If `low.latitude` > `high.latitude`, the latitude range is empty.
+//
+// Both `low` and `high` must be populated, and the represented box cannot be
+// empty (as specified by the definitions above). An empty viewport will result
+// in an error.
+//
+// For example, this viewport fully encloses New York City:
+//
+// {
+//     "low": {
+//         "latitude": 40.477398,
+//         "longitude": -74.259087
+//     },
+//     "high": {
+//         "latitude": 40.91618,
+//         "longitude": -73.70018
+//     }
+// }
+message Viewport {
+  // Required. The low point of the viewport.
+  google.type.LatLng low = 1;
+
+  // Required. The high point of the viewport.
+  google.type.LatLng high = 2;
+}
diff --git a/third_party/googleapis/google/home/graph/BUILD.bazel b/third_party/googleapis/google/home/graph/BUILD.bazel
new file mode 100644
index 000000000..a87c57fec
--- /dev/null
+++ b/third_party/googleapis/google/home/graph/BUILD.bazel
@@ -0,0 +1 @@
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/home/graph/v1/BUILD.bazel b/third_party/googleapis/google/home/graph/v1/BUILD.bazel
new file mode 100644
index 000000000..a6829a35d
--- /dev/null
+++ b/third_party/googleapis/google/home/graph/v1/BUILD.bazel
@@ -0,0 +1,361 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "graph_proto",
+    srcs = [
+        "device.proto",
+        "homegraph.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:struct_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "graph_proto_with_info",
+    deps = [
+        ":graph_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "graph_java_proto",
+    deps = [":graph_proto"],
+)
+
+java_grpc_library(
+    name = "graph_java_grpc",
+    srcs = [":graph_proto"],
+    deps = [":graph_java_proto"],
+)
+
+java_gapic_library(
+    name = "graph_java_gapic",
+    src = ":graph_proto_with_info",
+    gapic_yaml = "homegraph_gapic.yaml",
+    package = "google.home.graph.v1",
+    service_yaml = "homegraph_v1.yaml",
+    test_deps = [
+        ":graph_java_grpc",
+    ],
+    deps = [
+        ":graph_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "graph_java_gapic_test_suite",
+    test_classes = [
+        "com.google.home.graph.v1.HomeGraphApiServiceClientTest",
+    ],
+    runtime_deps = [":graph_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-home-graph-v1-java",
+    deps = [
+        ":graph_java_gapic",
+        ":graph_java_grpc",
+        ":graph_java_proto",
+        ":graph_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "graph_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/home/graph/v1",
+    protos = [":graph_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "graph_go_gapic",
+    srcs = [":graph_proto_with_info"],
+    grpc_service_config = "homegraph_grpc_service_config.json",
+    importpath = "google.golang.org/api/homegraph/v1;graph",
+    service_yaml = "homegraph_v1.yaml",
+    deps = [
+        ":graph_go_proto",
+    ],
+)
+
+go_test(
+    name = "graph_go_gapic_test",
+    srcs = [":graph_go_gapic_srcjar_test"],
+    embed = [":graph_go_gapic"],
+    importpath = "google.golang.org/api/homegraph/v1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-home-graph-v1-go",
+    deps = [
+        ":graph_go_gapic",
+        ":graph_go_gapic_srcjar-test.srcjar",
+        ":graph_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "graph_moved_proto",
+    srcs = [":graph_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:struct_proto",
+    ],
+)
+
+py_proto_library(
+    name = "graph_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":graph_moved_proto"],
+)
+
+py_grpc_library(
+    name = "graph_py_grpc",
+    srcs = [":graph_moved_proto"],
+    deps = [":graph_py_proto"],
+)
+
+py_gapic_library(
+    name = "graph_py_gapic",
+    src = ":graph_proto_with_info",
+    gapic_yaml = "homegraph_gapic.yaml",
+    package = "google.home.graph.v1",
+    service_yaml = "homegraph_v1.yaml",
+    deps = [
+        ":graph_py_grpc",
+        ":graph_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "home-graph-v1-py",
+    deps = [
+        ":graph_py_gapic",
+        ":graph_py_grpc",
+        ":graph_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "graph_php_proto",
+    deps = [":graph_proto"],
+)
+
+php_grpc_library(
+    name = "graph_php_grpc",
+    srcs = [":graph_proto"],
+    deps = [":graph_php_proto"],
+)
+
+php_gapic_library(
+    name = "graph_php_gapic",
+    src = ":graph_proto_with_info",
+    gapic_yaml = "homegraph_gapic.yaml",
+    package = "google.home.graph.v1",
+    service_yaml = "homegraph_v1.yaml",
+    deps = [
+        ":graph_php_grpc",
+        ":graph_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-home-graph-v1-php",
+    deps = [
+        ":graph_php_gapic",
+        ":graph_php_grpc",
+        ":graph_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "graph_nodejs_gapic",
+    src = ":graph_proto_with_info",
+    gapic_yaml = "homegraph_gapic.yaml",
+    package = "google.home.graph.v1",
+    service_yaml = "homegraph_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "home-graph-v1-nodejs",
+    deps = [
+        ":graph_nodejs_gapic",
+        ":graph_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "graph_ruby_proto",
+    deps = [":graph_proto"],
+)
+
+ruby_grpc_library(
+    name = "graph_ruby_grpc",
+    srcs = [":graph_proto"],
+    deps = [":graph_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "graph_ruby_gapic",
+    src = ":graph_proto_with_info",
+    gapic_yaml = "homegraph_gapic.yaml",
+    package = "google.home.graph.v1",
+    service_yaml = "homegraph_v1.yaml",
+    deps = [
+        ":graph_ruby_grpc",
+        ":graph_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-home-graph-v1-ruby",
+    deps = [
+        ":graph_ruby_gapic",
+        ":graph_ruby_grpc",
+        ":graph_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "graph_csharp_proto",
+    deps = [":graph_proto"],
+)
+
+csharp_grpc_library(
+    name = "graph_csharp_grpc",
+    srcs = [":graph_proto"],
+    deps = [":graph_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "graph_csharp_gapic",
+    src = ":graph_proto_with_info",
+    gapic_yaml = "homegraph_gapic.yaml",
+    package = "google.home.graph.v1",
+    service_yaml = "homegraph_v1.yaml",
+    deps = [
+        ":graph_csharp_grpc",
+        ":graph_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-home-graph-v1-csharp",
+    deps = [
+        ":graph_csharp_gapic",
+        ":graph_csharp_grpc",
+        ":graph_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/home/graph/v1/device.proto b/third_party/googleapis/google/home/graph/v1/device.proto
index 78a480ec5..336c378b7 100644
--- a/third_party/googleapis/google/home/graph/v1/device.proto
+++ b/third_party/googleapis/google/home/graph/v1/device.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google Inc.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -22,31 +22,35 @@ option go_package = "google.golang.org/genproto/googleapis/home/graph/v1;graph";
 option java_outer_classname = "DeviceProto";
 option java_package = "com.google.home.graph.v1";
 
-// Third-party partner's device definition.
+// Third-party device definition.
 message Device {
-  // Third-party partner's device ID.
+  // Third-party device ID.
   string id = 1;
 
-  // Hardware type of the device (e.g. light, outlet, etc).
+  // Hardware type of the device.
+  // See [device
+  // types](https://developers.google.com/assistant/smarthome/guides).
   string type = 2;
 
   // Traits supported by the device.
+  // See [device
+  // traits](https://developers.google.com/assistant/smarthome/traits).
   repeated string traits = 3;
 
-  // Name of the device given by the third party. This includes names given to
-  // the device via third party device manufacturer's app, model names for the
-  // device, etc.
+  // Names given to this device by your smart home Action.
   DeviceNames name = 4;
 
-  // Indicates whether the state of this device is being reported to Google
-  // through ReportStateAndNotification call.
+  // Indicates whether your smart home Action will report state of this device
+  // to Google via
+  // [ReportStateAndNotification][google.home.graph.v1.HomeGraphApiService.ReportStateAndNotification].
   bool will_report_state = 5;
 
-  // If the third-party partner's cloud configuration includes placing devices
-  // in rooms, the name of the room can be provided here.
+  // Suggested name for the room where this device is installed.
+  // Google attempts to use this value during user setup.
   string room_hint = 6;
 
-  // As in roomHint, for structures that users set up in the partner's system.
+  // Suggested name for the structure where this device is installed.
+  // Google attempts to use this value during user setup.
   string structure_hint = 7;
 
   // Device manufacturer, model, hardware version, and software version.
@@ -55,21 +59,30 @@ message Device {
   // Attributes for the traits supported by the device.
   google.protobuf.Struct attributes = 9;
 
-  // Custom JSON data provided by the manufacturer and attached to QUERY and
-  // EXECUTE requests in AoG.
-  string custom_data = 10;
+  // Custom device attributes stored in Home Graph and provided to your
+  // smart home Action in each
+  // [QUERY](https://developers.google.com/assistant/smarthome/reference/intent/query)
+  // and
+  // [EXECUTE](https://developers.google.com/assistant/smarthome/reference/intent/execute)
+  // intent.
+  google.protobuf.Struct custom_data = 10;
+
+  // Alternate IDs associated with this device.
+  // This is used to identify cloud synced devices enabled for [local
+  // fulfillment](https://developers.google.com/assistant/smarthome/concepts/local).
+  repeated AgentOtherDeviceId other_device_ids = 11;
 
-  // IDs of other devices associated with this device. This is used to
-  // represent a device group (e.g. bonded zone) or "facets" synced
-  // through different flows (e.g. Google Nest Hub Max with a Nest Camera).
+  // Indicates whether your smart home Action will report notifications
+  // to Google for this device via
+  // [ReportStateAndNotification][google.home.graph.v1.HomeGraphApiService.ReportStateAndNotification].
   //
-  // This may also be used to pass in alternate IDs used to identify a cloud
-  // synced device for local execution (i.e. local verification). If used for
-  // local verification, this field is synced from the cloud.
-  repeated AgentOtherDeviceId other_device_ids = 11;
+  // If your smart home Action enables users to control device notifications,
+  // you should update this field and call
+  // [RequestSyncDevices][google.home.graph.v1.HomeGraphApiService.RequestSyncDevices].
+  bool notification_supported_by_agent = 12;
 }
 
-// Different names for the device.
+// Identifiers used to describe the device.
 message DeviceNames {
   // Primary name of the device, generally provided by the user.
   string name = 1;
@@ -77,8 +90,8 @@ message DeviceNames {
   // Additional names provided by the user for the device.
   repeated string nicknames = 2;
 
-  // List of names provided by the partner rather than the user, often
-  // manufacturer names, SKUs, etc.
+  // List of names provided by the manufacturer rather than the user, such as
+  // serial numbers, SKUs, etc.
   repeated string default_names = 3;
 }
 
@@ -97,11 +110,11 @@ message DeviceInfo {
   string sw_version = 4;
 }
 
-// Identifies a device in the third party or first party system.
+// Alternate third-party device ID.
 message AgentOtherDeviceId {
-  // The agent's ID. Generally it is the agent's AoG project id.
+  // Project ID for your smart home Action.
   string agent_id = 1;
 
-  // Device ID defined by the agent. The device_id must be unique.
+  // Unique third-party device ID.
   string device_id = 2;
 }
diff --git a/third_party/googleapis/google/home/graph/v1/homegraph.proto b/third_party/googleapis/google/home/graph/v1/homegraph.proto
index b8b277add..57638d14b 100644
--- a/third_party/googleapis/google/home/graph/v1/homegraph.proto
+++ b/third_party/googleapis/google/home/graph/v1/homegraph.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google Inc.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -17,6 +17,9 @@ syntax = "proto3";
 package google.home.graph.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/home/graph/v1/device.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/struct.proto";
@@ -24,114 +27,145 @@ import "google/protobuf/struct.proto";
 option go_package = "google.golang.org/genproto/googleapis/home/graph/v1;graph";
 option java_outer_classname = "HomeGraphApiServiceProto";
 option java_package = "com.google.home.graph.v1";
-
-// Google HomeGraph API. HomeGraph Service provides the support for storing
-// and querying first-party and third-party devices, rooms and structures,
-// the relationships among them and their state in the home. It stores
-// entities and their relationships in the home.
+option (google.api.resource_definition) = {
+  type: "homegraph.googleapis.com/AgentUserPath"
+  pattern: "agentUsers/{agent_user_path=**}"
+};
+
+// Google Home Graph API service. The Home Graph service provides support for
+// accessing first-party and third-party devices stored in Google's Home Graph.
+// The Home Graph database provides contextual data about the relationships
+// between devices and the home.
+//
+// For more details, see the [Home Graph developer
+// guide](https://developers.google.com/assistant/smarthome/concepts/homegraph).
 service HomeGraphApiService {
-  // Requests a Sync call from Google to a 3p partner's home control agent for
-  // a user.
+  option (google.api.default_host) = "homegraph.googleapis.com";
+
+  // Requests Google to send an `action.devices.SYNC`
+  // [intent](https://developers.google.com/assistant/smarthome/reference/intent/sync)
+  // to your smart home Action to update device metadata for the given user.
   //
   //
-  // Third-party user's identity is passed in as agent_user_id.
+  // The third-party user's identity is passed via the `agent_user_id`
   // (see
-  // [RequestSyncDevicesRequest][google.home.graph.v1.RequestSyncDevicesRequest])
-  // and forwarded back to the agent. Agent is identified by the API key or JWT
-  // signed by the partner's service account.
+  // [RequestSyncDevicesRequest][google.home.graph.v1.RequestSyncDevicesRequest]).
+  // This request must be authorized using service account credentials from your
+  // Actions console project.
   rpc RequestSyncDevices(RequestSyncDevicesRequest)
       returns (RequestSyncDevicesResponse) {
     option (google.api.http) = {
       post: "/v1/devices:requestSync"
       body: "*"
     };
+    option (google.api.method_signature) = "agent_user_id";
   }
 
-  // Reports device state and optionally sends device notifications. Called by
-  // an agent when the device state of a third-party changes or the agent wants
-  // to send a notification about the device.
-  // This method updates a predefined set of States for a device, which all
-  // devices have (for example a light will have OnOff, Color, Brightness).
-  // A new State may not be created and an INVALID_ARGUMENT code will be thrown
-  // if so. It also optionally takes in a list of Notifications that may be
-  // created, which are associated to this State change.
+  // Reports device state and optionally sends device notifications.
+  // Called by your smart home Action when the state of a third-party device
+  // changes or you need to send a notification about the device.
+  // See [Implement Report
+  // State](https://developers.google.com/assistant/smarthome/develop/report-state)
+  // for more information.
   //
-  // Third-party user's identity is passed in as agent_user_id.
-  // Agent is identified by the JWT signed by the partner's service account.
+  // This method updates the device state according to its declared
+  // [traits](https://developers.google.com/assistant/smarthome/concepts/devices-traits).
+  // Publishing a new state value outside of these traits will result in an
+  // `INVALID_ARGUMENT` error response.
+  //
+  // The third-party user's identity is passed in via the `agent_user_id`
+  // (see
+  // [ReportStateAndNotificationRequest][google.home.graph.v1.ReportStateAndNotificationRequest]).
+  // This request must be authorized using service account credentials from your
+  // Actions console project.
   rpc ReportStateAndNotification(ReportStateAndNotificationRequest)
       returns (ReportStateAndNotificationResponse) {
     option (google.api.http) = {
       post: "/v1/devices:reportStateAndNotification"
       body: "*"
     };
+    option (google.api.method_signature) =
+        "request_id,event_id,agent_user_id,payload";
   }
 
-  // Unlink an agent user from Google. As result, all data related to this user
-  // will be deleted.
+  // Unlinks the given third-party user from your smart home Action.
+  // All data related to this user will be deleted.
   //
-  // Here is how the agent user is created in Google:
-  // When users open their Google Home App, they can begin linking a 3p
-  // partner. User is guided through the OAuth process. After entering the 3p
-  // credentials, Google gets the 3p OAuth token, and uses it to make a
-  // Sync call to the 3p partner and gets back all the user's data, including
-  // agent_user_id and devices.
-  // Google then creates the agent user and stores a mapping from the
-  // agent_user_id -> Google ID mapping. Google also stores all user's devices
-  // under that Google ID.
-  // The mapping from agent_user_id -> Google ID is many to many, since one
-  // Google user can have multiple 3p accounts, and multiple Google users can
-  // map to one agent_user_id (e.g. husband and wife share one Nest account
-  // username/password).
+  // For more details on how users link their accounts, see
+  // [fulfillment and
+  // authentication](https://developers.google.com/assistant/smarthome/concepts/fulfillment-authentication).
   //
-  // Third-party user's identity is passed in as agent_user_id
-  // Agent is identified by the JWT signed by the partner's service account.
-  //
-  // Note: Special characters (except "/") in agent_user_id must be URL encoded.
+  // The third-party user's identity is passed in via the `agent_user_id`
+  // (see
+  // [DeleteAgentUserRequest][google.home.graph.v1.DeleteAgentUserRequest]).
+  // This request must be authorized using service account credentials from your
+  // Actions console project.
   rpc DeleteAgentUser(DeleteAgentUserRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v1/{agent_user_id=agentUsers/**}"
     };
+    option (google.api.method_signature) = "request_id,agent_user_id";
   }
 
-  // Gets the device states for the devices in QueryRequest.
-  // Third-party user's identity is passed in as agent_user_id. Agent is
-  // identified by the JWT signed by the third-party partner's service account.
+  // Gets the current states in Home Graph for the given set of the third-party
+  // user's devices.
+  //
+  // The third-party user's identity is passed in via the `agent_user_id`
+  // (see [QueryRequest][google.home.graph.v1.QueryRequest]).
+  // This request must be authorized using service account credentials from your
+  // Actions console project.
   rpc Query(QueryRequest) returns (QueryResponse) {
     option (google.api.http) = {
       post: "/v1/devices:query"
       body: "*"
     };
+    option (google.api.method_signature) = "request_id,agent_user_id,inputs";
   }
 
   // Gets all the devices associated with the given third-party user.
-  // Third-party user's identity is passed in as agent_user_id. Agent is
-  // identified by the JWT signed by the third-party partner's service account.
+  //
+  // The third-party user's identity is passed in via the `agent_user_id`
+  // (see [SyncRequest][google.home.graph.v1.SyncRequest]).
+  // This request must be authorized using service account credentials from your
+  // Actions console project.
   rpc Sync(SyncRequest) returns (SyncResponse) {
     option (google.api.http) = {
       post: "/v1/devices:sync"
       body: "*"
     };
+    option (google.api.method_signature) = "request_id,agent_user_id";
   }
 }
 
-// Request type for RequestSyncDevices call.
+// Request type for the
+// [`RequestSyncDevices`](#google.home.graph.v1.HomeGraphApiService.RequestSyncDevices)
+// call.
 message RequestSyncDevicesRequest {
-  // Required. Third-party user id issued by agent's third-party identity
-  // provider.
-  string agent_user_id = 1;
+  // Required. Third-party user ID.
+  string agent_user_id = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Optional. If set, the request will be added to a queue and a response will
-  // be returned immediately. The queue allows for de-duplication of
-  // simultaneous requests.
-  bool async = 2;
+  // be returned immediately. This enables concurrent requests for the given
+  // `agent_user_id`, but the caller will not receive any error responses.
+  bool async = 2 [(google.api.field_behavior) = OPTIONAL];
 }
 
-// Response type for RequestSyncDevices call. Intentionally empty upon success.
-// An HTTP response code is returned with more details upon failure.
+// Response type for the
+// [`RequestSyncDevices`](#google.home.graph.v1.HomeGraphApiService.RequestSyncDevices)
+// call.
+//
+// Intentionally empty upon success. An HTTP response code is returned
+// with more details upon failure.
 message RequestSyncDevicesResponse {}
 
-// Sample ReportStateAndNotificationRequest, with states and notifications
-// defined per device_id (eg: "123" and "456" in the following example):
+// Request type for the
+// [`ReportStateAndNotification`](#google.home.graph.v1.HomeGraphApiService.ReportStateAndNotification)
+// call. It may include states, notifications, or both. States and notifications
+// are defined per `device_id` (for example, "123" and "456" in the following
+// example).
+// # Example
+//
+// ```json
 // {
 //   "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
 //   "agentUserId": "1234",
@@ -146,130 +180,137 @@ message RequestSyncDevicesResponse {}
 //           "brightness": 10
 //         }
 //       },
-//       "notifications": {
-//         "123": {
-//           "ObjectDetected": {
-//             "priority": 0,
-//             "objects": {
-//               "NAMED": ["Alice", "Bob", "Carol", "Eve"]
-//             }
-//           },
-//           "DoorUnlocked": {
-//             "priority": 0,
-//             "keyUsed": {
-//               "keyName": "Wife's key"
-//             }
-//           }
-//         },
-//         "456": {
-//           "SprinklersOn": {
-//             "priority": 0,
-//             "timeStarted": "1513792702"
-//           }
-//         }
-//       }
 //     }
 //   }
 // }
-// Request type for ReportStateAndNotification call. It may include States,
-// Notifications, or both. This request uses globally unique flattened state
-// names instead of namespaces based on traits to align with the existing QUERY
-// and EXECUTE APIs implemented by 90+ Smart Home partners.
-// Next tag: 6.
+// ```
 message ReportStateAndNotificationRequest {
-  // Request id used for debugging.
+  // Request ID used for debugging.
   string request_id = 1;
 
-  // Unique identifier per event (eg: doorbell press).
+  // Unique identifier per event (for example, a doorbell press).
   string event_id = 4;
 
-  // Required. Third-party user id.
-  string agent_user_id = 2;
+  // Required. Third-party user ID.
+  string agent_user_id = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Token to maintain state in the follow up notification response.
-  string follow_up_token = 5;
-
-  // State of devices to update and notification metadata for devices. For
-  // example, if a user turns a light on manually, a State update should be
-  // sent so that the information is always the current status of the device.
-  // Notifications are independent from the state and its piece of the payload
-  // should contain everything necessary to notify the user. Although it may be
-  // related to a state change, it does not need to be. For example, if a
-  // device can turn on/off and change temperature, the states reported would
-  // include both "on" and "70 degrees" but the 3p may choose not to send any
-  // notification for that, or to only say that the "the room is heating up",
-  // keeping state and notification independent.
-  StateAndNotificationPayload payload = 3;
+  // Deprecated. See the [notifications
+  // guide](https://developers.google.com/assistant/smarthome/develop/notifications)
+  // for details on implementing follow up notifications.
+  string follow_up_token = 5 [deprecated = true];
+
+  // Required. State of devices to update and notification metadata for devices.
+  StateAndNotificationPayload payload = 3
+      [(google.api.field_behavior) = REQUIRED];
 }
 
-// Response type for ReportStateAndNotification call.
+// Response type for the
+// [`ReportStateAndNotification`](#google.home.graph.v1.HomeGraphApiService.ReportStateAndNotification)
+// call.
 message ReportStateAndNotificationResponse {
-  // Request id copied from ReportStateAndNotificationRequest.
+  // Request ID copied from
+  // [ReportStateAndNotificationRequest][google.home.graph.v1.ReportStateAndNotificationRequest].
   string request_id = 1;
 }
 
-// Payload containing the State and Notification information for devices.
+// Payload containing the state and notification information for devices.
 message StateAndNotificationPayload {
-  // The devices for updating State and sending Notifications.
+  // The devices for updating state and sending notifications.
   ReportStateAndNotificationDevice devices = 1;
 }
 
-// The States and Notifications specific to a device.
+// The states and notifications specific to a device.
 message ReportStateAndNotificationDevice {
-  // States of devices to update.
+  // States of devices to update. See the **Device STATES** section
+  // of the individual trait [reference
+  // guides](https://developers.google.com/assistant/smarthome/traits).
   google.protobuf.Struct states = 1;
 
-  // Notifications metadata for devices.
+  // Notifications metadata for devices. See the **Device NOTIFICATIONS**
+  // section of the individual trait [reference
+  // guides](https://developers.google.com/assistant/smarthome/traits).
   google.protobuf.Struct notifications = 2;
 }
 
-// Request type for DeleteAgentUser call.
+// Request type for the
+// [`DeleteAgentUser`](#google.home.graph.v1.HomeGraphApiService.DeleteAgentUser)
+// call.
 message DeleteAgentUserRequest {
-  // Request id used for debugging.
+  // Request ID used for debugging.
   string request_id = 1;
 
-  // Required. Third-party user id.
-  string agent_user_id = 2;
+  // Required. Third-party user ID.
+  string agent_user_id = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "homegraph.googleapis.com/AgentUserPath"
+    }
+  ];
 }
 
-// Request type for Query call. This should be the same format as the AoG
-// action.devices.QUERY request
-// (https://developers.google.com/actions/smarthome/create-app#actiondevicesquery)
-// with the exception of the extra "agent_user_id" and no "intent" and
-// "customData" field.
+// Request type for the
+// [`Query`](#google.home.graph.v1.HomeGraphApiService.Query) call.
 message QueryRequest {
   // Request ID used for debugging.
   string request_id = 1;
 
   // Required. Third-party user ID.
-  string agent_user_id = 2;
+  string agent_user_id = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Required. Inputs containing third-party partner's device IDs for which to
+  // Required. Inputs containing third-party device IDs for which to
   // get the device states.
-  repeated QueryRequestInput inputs = 3;
+  repeated QueryRequestInput inputs = 3
+      [(google.api.field_behavior) = REQUIRED];
 }
 
-// Device ID inputs to QueryRequest.
+// Device ID inputs to [QueryRequest][google.home.graph.v1.QueryRequest].
 message QueryRequestInput {
-  // Payload containing third-party partner's device IDs.
+  // Payload containing third-party device IDs.
   QueryRequestPayload payload = 1;
 }
 
 // Payload containing device IDs.
 message QueryRequestPayload {
-  // Third-party partner's device IDs to get device states for.
+  // Third-party device IDs for which to get the device states.
   repeated AgentDeviceId devices = 1;
 }
 
-// Third-party partner's device ID for one device.
+// Third-party device ID for one device.
 message AgentDeviceId {
-  // Third-party partner's device ID.
+  // Third-party device ID.
   string id = 1;
 }
 
-// Response type for Query call. This should follow the same format as AoG
-// action.devices.QUERY response
-// (https://developers.google.com/actions/smarthome/create-app#actiondevicesquery).
+// Response type for the
+// [`Query`](#google.home.graph.v1.HomeGraphApiService.Query) call.
+// This should follow the same format as the Google smart home
+// `action.devices.QUERY`
+// [response](https://developers.google.com/assistant/smarthome/reference/intent/query).
+// # Example
+//
+// ```json
+// {
+//   "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
+//   "payload": {
+//     "devices": {
+//       "123": {
+//         "on": true,
+//         "online": true
+//       },
+//       "456": {
+//         "on": true,
+//         "online": true,
+//         "brightness": 80,
+//         "color": {
+//           "name": "cerulean",
+//           "spectrumRGB": 31655
+//         }
+//       }
+//     }
+//   }
+// }
+// ```
 message QueryResponse {
   // Request ID used for debugging. Copied from the request.
   string request_id = 1;
@@ -285,19 +326,24 @@ message QueryResponsePayload {
   map devices = 1;
 }
 
-// Request type for Sync call. This should follow the same format as AoG
-// action.devices.SYNC request
-// (https://developers.google.com/actions/smarthome/create-app#actiondevicessync)
-// with the exception of the extra "agent_user_id" and no "intent" field.
+// Request type for the [`Sync`](#google.home.graph.v1.HomeGraphApiService.Sync)
+// call.
 message SyncRequest {
   // Request ID used for debugging.
   string request_id = 1;
 
   // Required. Third-party user ID.
-  string agent_user_id = 2;
+  string agent_user_id = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
-// Example SyncResponse:
+// Response type for the
+// [`Sync`](#google.home.graph.v1.HomeGraphApiService.Sync) call.
+// This should follow the same format as the Google smart home
+// `action.devices.SYNC`
+// [response](https://developers.google.com/assistant/smarthome/reference/intent/sync).
+// # Example
+//
+// ```json
 // {
 //   "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
 //   "payload": {
@@ -328,10 +374,7 @@ message SyncRequest {
 //     }]
 //   }
 // }
-//
-// Response type for Sync call. This should follow the same format as AoG
-// action.devices.SYNC response
-// (https://developers.google.com/actions/smarthome/create-app#actiondevicessync).
+// ```
 message SyncResponse {
   // Request ID used for debugging. Copied from the request.
   string request_id = 1;
@@ -346,5 +389,5 @@ message SyncResponsePayload {
   string agent_user_id = 1;
 
   // Devices associated with the third-party user.
-  repeated google.home.graph.v1.Device devices = 2;
+  repeated Device devices = 2;
 }
diff --git a/third_party/googleapis/google/home/graph/v1/homegraph_grpc_service_config.json b/third_party/googleapis/google/home/graph/v1/homegraph_grpc_service_config.json
new file mode 100755
index 000000000..32b4eadbb
--- /dev/null
+++ b/third_party/googleapis/google/home/graph/v1/homegraph_grpc_service_config.json
@@ -0,0 +1,44 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.home.graph.v1.HomeGraphApiService",
+          "method": "RequestSyncDevices"
+        },
+        {
+          "service": "google.home.graph.v1.HomeGraphApiService",
+          "method": "ReportStateAndNotification"
+        }
+      ],
+      "timeout": "10s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.home.graph.v1.HomeGraphApiService",
+          "method": "DeleteAgentUser"
+        },
+        {
+          "service": "google.home.graph.v1.HomeGraphApiService",
+          "method": "Query"
+        },
+        {
+          "service": "google.home.graph.v1.HomeGraphApiService",
+          "method": "Sync"
+        }
+      ],
+      "timeout": "10s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/home/graph/v1/homegraph_v1.yaml b/third_party/googleapis/google/home/graph/v1/homegraph_v1.yaml
new file mode 100644
index 000000000..ae04cedc6
--- /dev/null
+++ b/third_party/googleapis/google/home/graph/v1/homegraph_v1.yaml
@@ -0,0 +1,12 @@
+type: google.api.Service
+config_version: 3
+name: homegraph.googleapis.com
+title: HomeGraph API
+
+apis:
+- name: google.home.graph.v1.HomeGraphApiService
+
+backend:
+  rules:
+  - selector: 'google.home.graph.v1.HomeGraphApiService.*'
+    deadline: 60.0
diff --git a/third_party/googleapis/google/iam/BUILD.bazel b/third_party/googleapis/google/iam/BUILD.bazel
index 1e5b8c2af..a87c57fec 100644
--- a/third_party/googleapis/google/iam/BUILD.bazel
+++ b/third_party/googleapis/google/iam/BUILD.bazel
@@ -1 +1 @@
-exports_files(glob(["*.yaml"]))
\ No newline at end of file
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/iam/admin/v1/BUILD.bazel b/third_party/googleapis/google/iam/admin/v1/BUILD.bazel
index 9ca130dd5..2e6a2cde8 100644
--- a/third_party/googleapis/google/iam/admin/v1/BUILD.bazel
+++ b/third_party/googleapis/google/iam/admin/v1/BUILD.bazel
@@ -1,16 +1,24 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
-    name = "iam_admin_proto",
-    srcs = ["iam.proto"],
+    name = "admin_proto",
+    srcs = [
+        "iam.proto",
+    ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
         "//google/iam/v1:iam_policy_proto",
         "//google/iam/v1:policy_proto",
         "@com_google_protobuf//:empty_proto",
@@ -20,8 +28,69 @@ proto_library(
 )
 
 proto_library_with_info(
-    name = "iam_admin_proto_with_info",
-    deps = [":iam_admin_proto"],
+    name = "admin_proto_with_info",
+    deps = [
+        ":admin_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "admin_java_proto",
+    deps = [":admin_proto"],
+)
+
+java_grpc_library(
+    name = "admin_java_grpc",
+    srcs = [":admin_proto"],
+    deps = [":admin_java_proto"],
+)
+
+java_gapic_library(
+    name = "admin_java_gapic",
+    src = ":admin_proto_with_info",
+    gapic_yaml = "iam_gapic.yaml",
+    package = "google.iam.admin.v1",
+    service_yaml = "iam.yaml",
+    test_deps = [
+        ":admin_java_grpc",
+        "//google/iam/v1:iam_java_grpc",
+    ],
+    deps = [
+        ":admin_java_proto",
+        "//google/iam/v1:iam_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "admin_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.iam.admin.v1.IamClientTest",
+    ],
+    runtime_deps = [":admin_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-iam-admin-v1-java",
+    deps = [
+        ":admin_java_gapic",
+        ":admin_java_grpc",
+        ":admin_java_proto",
+        ":admin_proto",
+    ],
 )
 
 ##############################################################################
@@ -29,17 +98,17 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
-    name = "iam_admin_go_proto",
+    name = "admin_go_proto",
     compilers = ["@io_bazel_rules_go//proto:go_grpc"],
     importpath = "google.golang.org/genproto/googleapis/iam/admin/v1",
-    protos = [":iam_admin_proto"],
+    protos = [":admin_proto"],
     deps = [
         "//google/api:annotations_go_proto",
         "//google/iam/v1:iam_go_proto",
@@ -47,32 +116,270 @@ go_proto_library(
 )
 
 go_gapic_library(
-    name = "iam_admin_go_gapic",
-    src = ":iam_admin_proto_with_info",
-    gapic_yaml = "iam_gapic.yaml",
-    importpath = "cloud.google.com/go/iam/admin/apiv1",
-    service_yaml = "//google/iam:iam.yaml",
+    name = "admin_go_gapic",
+    srcs = [":admin_proto_with_info"],
+    grpc_service_config = "iam_grpc_service_config.json",
+    importpath = "cloud.google.com/go/iam/admin/apiv1;admin",
+    service_yaml = "iam.yaml",
     deps = [
-        ":iam_admin_go_proto",
+        ":admin_go_proto",
         "//google/iam/v1:iam_go_proto",
     ],
 )
 
 go_test(
-    name = "iam_admin_go_gapic_test",
-    srcs = [":iam_admin_go_gapic_srcjar_test"],
-    embed = [":iam_admin_go_gapic"],
+    name = "admin_go_gapic_test",
+    srcs = [":admin_go_gapic_srcjar_test"],
+    embed = [":admin_go_gapic"],
     importpath = "cloud.google.com/go/iam/admin/apiv1",
-    deps = ["//google/iam/v1:iam_go_proto"],
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-iam-admin-v1-go",
     deps = [
-        ":iam_admin_go_gapic",
-        ":iam_admin_go_gapic_srcjar-smoke-test.srcjar",
-        ":iam_admin_go_gapic_srcjar-test.srcjar",
-        ":iam_admin_go_proto",
+        ":admin_go_gapic",
+        ":admin_go_gapic_srcjar-test.srcjar",
+        ":admin_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "admin_moved_proto",
+    srcs = [":admin_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/iam/v1:iam_policy_proto",
+        "//google/iam/v1:policy_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "admin_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":admin_moved_proto"],
+)
+
+py_grpc_library(
+    name = "admin_py_grpc",
+    srcs = [":admin_moved_proto"],
+    deps = [":admin_py_proto"],
+)
+
+py_gapic_library(
+    name = "admin_py_gapic",
+    src = ":admin_proto_with_info",
+    gapic_yaml = "iam_gapic.yaml",
+    package = "google.iam.admin.v1",
+    service_yaml = "iam.yaml",
+    deps = [
+        ":admin_py_grpc",
+        ":admin_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "iam-admin-v1-py",
+    deps = [
+        ":admin_py_gapic",
+        ":admin_py_grpc",
+        ":admin_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "admin_php_proto",
+    deps = [":admin_proto"],
+)
+
+php_grpc_library(
+    name = "admin_php_grpc",
+    srcs = [":admin_proto"],
+    deps = [":admin_php_proto"],
+)
+
+php_gapic_library(
+    name = "admin_php_gapic",
+    src = ":admin_proto_with_info",
+    gapic_yaml = "iam_gapic.yaml",
+    package = "google.iam.admin.v1",
+    service_yaml = "iam.yaml",
+    deps = [
+        ":admin_php_grpc",
+        ":admin_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-iam-admin-v1-php",
+    deps = [
+        ":admin_php_gapic",
+        ":admin_php_grpc",
+        ":admin_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "admin_nodejs_gapic",
+    src = ":admin_proto_with_info",
+    gapic_yaml = "iam_gapic.yaml",
+    package = "google.iam.admin.v1",
+    service_yaml = "iam.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "iam-admin-v1-nodejs",
+    deps = [
+        ":admin_nodejs_gapic",
+        ":admin_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "admin_ruby_proto",
+    deps = [":admin_proto"],
+)
+
+ruby_grpc_library(
+    name = "admin_ruby_grpc",
+    srcs = [":admin_proto"],
+    deps = [":admin_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "admin_ruby_gapic",
+    src = ":admin_proto_with_info",
+    gapic_yaml = "iam_gapic.yaml",
+    package = "google.iam.admin.v1",
+    service_yaml = "iam.yaml",
+    deps = [
+        ":admin_ruby_grpc",
+        ":admin_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-iam-admin-v1-ruby",
+    deps = [
+        ":admin_ruby_gapic",
+        ":admin_ruby_grpc",
+        ":admin_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "admin_csharp_proto",
+    deps = [":admin_proto"],
+)
+
+csharp_grpc_library(
+    name = "admin_csharp_grpc",
+    srcs = [":admin_proto"],
+    deps = [":admin_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "admin_csharp_gapic",
+    src = ":admin_proto_with_info",
+    gapic_yaml = "iam_gapic.yaml",
+    package = "google.iam.admin.v1",
+    service_yaml = "iam.yaml",
+    deps = [
+        ":admin_csharp_grpc",
+        ":admin_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-iam-admin-v1-csharp",
+    deps = [
+        ":admin_csharp_gapic",
+        ":admin_csharp_grpc",
+        ":admin_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "cc_proto_library",
+    "cc_grpc_library")
+
+cc_proto_library(
+    name = "admin_cc_proto",
+    deps = [":admin_proto"],
+)
+
+cc_grpc_library(
+    name = "admin_cc_grpc",
+    srcs = [":admin_proto"],
+    grpc_only = True,
+    deps = [":admin_cc_proto"],
+)
diff --git a/third_party/googleapis/google/iam/admin/v1/iam.proto b/third_party/googleapis/google/iam/admin/v1/iam.proto
index 174e79bd4..804162a41 100644
--- a/third_party/googleapis/google/iam/admin/v1/iam.proto
+++ b/third_party/googleapis/google/iam/admin/v1/iam.proto
@@ -1,4 +1,4 @@
-// Copyright 2017 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -17,6 +17,9 @@ syntax = "proto3";
 package google.iam.admin.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/iam/v1/iam_policy.proto";
 import "google/iam/v1/policy.proto";
 import "google/protobuf/empty.proto";
@@ -41,17 +44,20 @@ option java_package = "com.google.iam.admin.v1";
 // `unique_id`.
 //
 // All other methods can identify accounts using the format
-// `projects/{PROJECT_ID}/serviceAccounts/{SERVICE_ACCOUNT_EMAIL}`.
-// Using `-` as a wildcard for the project will infer the project from
-// the account. The `account` value can be the `email` address or the
+// `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`.
+// Using `-` as a wildcard for the `PROJECT_ID` will infer the project from
+// the account. The `ACCOUNT` value can be the `email` address or the
 // `unique_id` of the service account.
 service IAM {
+  option (google.api.default_host) = "iam.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Lists [ServiceAccounts][google.iam.admin.v1.ServiceAccount] for a project.
-  rpc ListServiceAccounts(ListServiceAccountsRequest)
-      returns (ListServiceAccountsResponse) {
+  rpc ListServiceAccounts(ListServiceAccountsRequest) returns (ListServiceAccountsResponse) {
     option (google.api.http) = {
       get: "/v1/{name=projects/*}/serviceAccounts"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Gets a [ServiceAccount][google.iam.admin.v1.ServiceAccount].
@@ -59,23 +65,23 @@ service IAM {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/serviceAccounts/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates a [ServiceAccount][google.iam.admin.v1.ServiceAccount]
   // and returns it.
-  rpc CreateServiceAccount(CreateServiceAccountRequest)
-      returns (ServiceAccount) {
+  rpc CreateServiceAccount(CreateServiceAccountRequest) returns (ServiceAccount) {
     option (google.api.http) = {
       post: "/v1/{name=projects/*}/serviceAccounts"
       body: "*"
     };
+    option (google.api.method_signature) = "name,account_id,service_account";
   }
 
   // Updates a [ServiceAccount][google.iam.admin.v1.ServiceAccount].
   //
   // Currently, only the following fields are updatable:
-  // `display_name` .
-  // The `etag` is mandatory.
+  // `display_name` and `description`.
   rpc UpdateServiceAccount(ServiceAccount) returns (ServiceAccount) {
     option (google.api.http) = {
       put: "/v1/{name=projects/*/serviceAccounts/*}"
@@ -84,46 +90,46 @@ service IAM {
   }
 
   // Deletes a [ServiceAccount][google.iam.admin.v1.ServiceAccount].
-  rpc DeleteServiceAccount(DeleteServiceAccountRequest)
-      returns (google.protobuf.Empty) {
+  rpc DeleteServiceAccount(DeleteServiceAccountRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v1/{name=projects/*/serviceAccounts/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists [ServiceAccountKeys][google.iam.admin.v1.ServiceAccountKey].
-  rpc ListServiceAccountKeys(ListServiceAccountKeysRequest)
-      returns (ListServiceAccountKeysResponse) {
+  rpc ListServiceAccountKeys(ListServiceAccountKeysRequest) returns (ListServiceAccountKeysResponse) {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/serviceAccounts/*}/keys"
     };
+    option (google.api.method_signature) = "name,key_types";
   }
 
   // Gets the [ServiceAccountKey][google.iam.admin.v1.ServiceAccountKey]
   // by key id.
-  rpc GetServiceAccountKey(GetServiceAccountKeyRequest)
-      returns (ServiceAccountKey) {
+  rpc GetServiceAccountKey(GetServiceAccountKeyRequest) returns (ServiceAccountKey) {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/serviceAccounts/*/keys/*}"
     };
+    option (google.api.method_signature) = "name,public_key_type";
   }
 
   // Creates a [ServiceAccountKey][google.iam.admin.v1.ServiceAccountKey]
   // and returns it.
-  rpc CreateServiceAccountKey(CreateServiceAccountKeyRequest)
-      returns (ServiceAccountKey) {
+  rpc CreateServiceAccountKey(CreateServiceAccountKeyRequest) returns (ServiceAccountKey) {
     option (google.api.http) = {
       post: "/v1/{name=projects/*/serviceAccounts/*}/keys"
       body: "*"
     };
+    option (google.api.method_signature) = "name,private_key_type,key_algorithm";
   }
 
   // Deletes a [ServiceAccountKey][google.iam.admin.v1.ServiceAccountKey].
-  rpc DeleteServiceAccountKey(DeleteServiceAccountKeyRequest)
-      returns (google.protobuf.Empty) {
+  rpc DeleteServiceAccountKey(DeleteServiceAccountKeyRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v1/{name=projects/*/serviceAccounts/*/keys/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Signs a blob using a service account's system-managed private key.
@@ -132,6 +138,7 @@ service IAM {
       post: "/v1/{name=projects/*/serviceAccounts/*}:signBlob"
       body: "*"
     };
+    option (google.api.method_signature) = "name,bytes_to_sign";
   }
 
   // Signs a JWT using a service account's system-managed private key.
@@ -144,53 +151,86 @@ service IAM {
       post: "/v1/{name=projects/*/serviceAccounts/*}:signJwt"
       body: "*"
     };
+    option (google.api.method_signature) = "name,payload";
   }
 
-  // Returns the IAM access control policy for a
+  // Returns the Cloud IAM access control policy for a
   // [ServiceAccount][google.iam.admin.v1.ServiceAccount].
-  rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest)
-      returns (google.iam.v1.Policy) {
+  //
+  // Note: Service accounts are both
+  // [resources and
+  // identities](/iam/docs/service-accounts#service_account_permissions). This
+  // method treats the service account as a resource. It returns the Cloud IAM
+  // policy that reflects what members have access to the service account.
+  //
+  // This method does not return what resources the service account has access
+  // to. To see if a service account has access to a resource, call the
+  // `getIamPolicy` method on the target resource. For example, to view grants
+  // for a project, call the
+  // [projects.getIamPolicy](/resource-manager/reference/rest/v1/projects/getIamPolicy)
+  // method.
+  rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) returns (google.iam.v1.Policy) {
     option (google.api.http) = {
       post: "/v1/{resource=projects/*/serviceAccounts/*}:getIamPolicy"
-      body: ""
     };
+    option (google.api.method_signature) = "resource";
   }
 
-  // Sets the IAM access control policy for a
+  // Sets the Cloud IAM access control policy for a
   // [ServiceAccount][google.iam.admin.v1.ServiceAccount].
-  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest)
-      returns (google.iam.v1.Policy) {
+  //
+  // Note: Service accounts are both
+  // [resources and
+  // identities](/iam/docs/service-accounts#service_account_permissions). This
+  // method treats the service account as a resource. Use it to grant members
+  // access to the service account, such as when they need to impersonate it.
+  //
+  // This method does not grant the service account access to other resources,
+  // such as projects. To grant a service account access to resources, include
+  // the service account in the Cloud IAM policy for the desired resource, then
+  // call the appropriate `setIamPolicy` method on the target resource. For
+  // example, to grant a service account access to a project, call the
+  // [projects.setIamPolicy](/resource-manager/reference/rest/v1/projects/setIamPolicy)
+  // method.
+  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) returns (google.iam.v1.Policy) {
     option (google.api.http) = {
       post: "/v1/{resource=projects/*/serviceAccounts/*}:setIamPolicy"
       body: "*"
     };
+    option (google.api.method_signature) = "resource,policy";
   }
 
   // Tests the specified permissions against the IAM access control policy
   // for a [ServiceAccount][google.iam.admin.v1.ServiceAccount].
-  rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest)
-      returns (google.iam.v1.TestIamPermissionsResponse) {
+  rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest) returns (google.iam.v1.TestIamPermissionsResponse) {
     option (google.api.http) = {
       post: "/v1/{resource=projects/*/serviceAccounts/*}:testIamPermissions"
       body: "*"
     };
+    option (google.api.method_signature) = "resource,permissions";
   }
 
   // Queries roles that can be granted on a particular resource.
   // A role is grantable if it can be used as the role in a binding for a policy
   // for that resource.
-  rpc QueryGrantableRoles(QueryGrantableRolesRequest)
-      returns (QueryGrantableRolesResponse) {
+  rpc QueryGrantableRoles(QueryGrantableRolesRequest) returns (QueryGrantableRolesResponse) {
     option (google.api.http) = {
       post: "/v1/roles:queryGrantableRoles"
       body: "*"
     };
+    option (google.api.method_signature) = "full_resource_name";
   }
 
   // Lists the Roles defined on a resource.
   rpc ListRoles(ListRolesRequest) returns (ListRolesResponse) {
     option (google.api.http) = {
       get: "/v1/roles"
+      additional_bindings {
+        get: "/v1/{parent=organizations/*}/roles"
+      }
+      additional_bindings {
+        get: "/v1/{parent=projects/*}/roles"
+      }
     };
   }
 
@@ -198,6 +238,12 @@ service IAM {
   rpc GetRole(GetRoleRequest) returns (Role) {
     option (google.api.http) = {
       get: "/v1/{name=roles/*}"
+      additional_bindings {
+        get: "/v1/{name=organizations/*/roles/*}"
+      }
+      additional_bindings {
+        get: "/v1/{name=projects/*/roles/*}"
+      }
     };
   }
 
@@ -206,6 +252,10 @@ service IAM {
     option (google.api.http) = {
       post: "/v1/{parent=organizations/*}/roles"
       body: "*"
+      additional_bindings {
+        post: "/v1/{parent=projects/*}/roles"
+        body: "*"
+      }
     };
   }
 
@@ -214,6 +264,10 @@ service IAM {
     option (google.api.http) = {
       patch: "/v1/{name=organizations/*/roles/*}"
       body: "role"
+      additional_bindings {
+        patch: "/v1/{name=projects/*/roles/*}"
+        body: "role"
+      }
     };
   }
 
@@ -227,6 +281,9 @@ service IAM {
   rpc DeleteRole(DeleteRoleRequest) returns (Role) {
     option (google.api.http) = {
       delete: "/v1/{name=organizations/*/roles/*}"
+      additional_bindings {
+        delete: "/v1/{name=projects/*/roles/*}"
+      }
     };
   }
 
@@ -235,13 +292,16 @@ service IAM {
     option (google.api.http) = {
       post: "/v1/{name=organizations/*/roles/*}:undelete"
       body: "*"
+      additional_bindings {
+        post: "/v1/{name=projects/*/roles/*}:undelete"
+        body: "*"
+      }
     };
   }
 
   // Lists the permissions testable on a resource.
   // A permission is testable if it can be tested for an identity on a resource.
-  rpc QueryTestablePermissions(QueryTestablePermissionsRequest)
-      returns (QueryTestablePermissionsResponse) {
+  rpc QueryTestablePermissions(QueryTestablePermissionsRequest) returns (QueryTestablePermissionsResponse) {
     option (google.api.http) = {
       post: "/v1/permissions:queryTestablePermissions"
       body: "*"
@@ -257,25 +317,29 @@ service IAM {
 // `unique_id`.
 //
 // If the account already exists, the account's resource name is returned
-// in util::Status's ResourceInfo.resource_name in the format of
-// projects/{PROJECT_ID}/serviceAccounts/{SERVICE_ACCOUNT_EMAIL}. The caller can
-// use the name in other methods to access the account.
+// in the format of projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}. The caller
+// can use the name in other methods to access the account.
 //
 // All other methods can identify the service account using the format
-// `projects/{PROJECT_ID}/serviceAccounts/{SERVICE_ACCOUNT_EMAIL}`.
-// Using `-` as a wildcard for the project will infer the project from
-// the account. The `account` value can be the `email` address or the
+// `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`.
+// Using `-` as a wildcard for the `PROJECT_ID` will infer the project from
+// the account. The `ACCOUNT` value can be the `email` address or the
 // `unique_id` of the service account.
 message ServiceAccount {
+  option (google.api.resource) = {
+    type: "iam.googleapis.com/ServiceAccount"
+    pattern: "projects/{project}/serviceAccounts/{service_account}"
+  };
+
   // The resource name of the service account in the following format:
-  // `projects/{PROJECT_ID}/serviceAccounts/{SERVICE_ACCOUNT_EMAIL}`.
+  // `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`.
   //
-  // Requests using `-` as a wildcard for the project will infer the project
-  // from the `account` and the `account` value can be the `email` address or
-  // the `unique_id` of the service account.
+  // Requests using `-` as a wildcard for the `PROJECT_ID` will infer the
+  // project from the `account` and the `ACCOUNT` value can be the `email`
+  // address or the `unique_id` of the service account.
   //
   // In responses the resource name will always be in the format
-  // `projects/{PROJECT_ID}/serviceAccounts/{SERVICE_ACCOUNT_EMAIL}`.
+  // `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`.
   string name = 1;
 
   // @OutputOnly The id of the project that owns the service account.
@@ -287,11 +351,12 @@ message ServiceAccount {
   // @OutputOnly The email address of the service account.
   string email = 5;
 
-  // Optional. A user-specified description of the service account.  Must be
-  // fewer than 100 UTF-8 bytes.
+  // Optional. A user-specified name for the service account.
+  // Must be less than or equal to 100 UTF-8 bytes.
   string display_name = 6;
 
-  // Used to perform a consistent read-modify-write.
+  // Optional. Note: `etag` is an inoperable legacy field that is only returned
+  // for backwards compatibility.
   bytes etag = 7;
 
   // @OutputOnly. The OAuth2 client id for the service account.
@@ -304,17 +369,22 @@ message ServiceAccount {
 message CreateServiceAccountRequest {
   // Required. The resource name of the project associated with the service
   // accounts, such as `projects/my-project-123`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
   // Required. The account id that is used to generate the service account
   // email address and a stable unique id. It is unique within a project,
   // must be 6-30 characters long, and match the regular expression
   // `[a-z]([-a-z0-9]*[a-z0-9])` to comply with RFC1035.
-  string account_id = 2;
+  string account_id = 2 [(google.api.field_behavior) = REQUIRED];
 
   // The [ServiceAccount][google.iam.admin.v1.ServiceAccount] resource to
   // create. Currently, only the following values are user assignable:
-  // `display_name` .
+  // `display_name` and `description`.
   ServiceAccount service_account = 3;
 }
 
@@ -322,7 +392,12 @@ message CreateServiceAccountRequest {
 message ListServiceAccountsRequest {
   // Required. The resource name of the project associated with the service
   // accounts, such as `projects/my-project-123`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
   // Optional limit on the number of service accounts to include in the
   // response. Further accounts can subsequently be obtained by including the
@@ -348,22 +423,32 @@ message ListServiceAccountsResponse {
 
 // The service account get request.
 message GetServiceAccountRequest {
-  // The resource name of the service account in the following format:
-  // `projects/{PROJECT_ID}/serviceAccounts/{SERVICE_ACCOUNT_EMAIL}`.
-  // Using `-` as a wildcard for the project will infer the project from
-  // the account. The `account` value can be the `email` address or the
+  // Required. The resource name of the service account in the following format:
+  // `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`.
+  // Using `-` as a wildcard for the `PROJECT_ID` will infer the project from
+  // the account. The `ACCOUNT` value can be the `email` address or the
   // `unique_id` of the service account.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "iam.googleapis.com/ServiceAccount"
+    }
+  ];
 }
 
 // The service account delete request.
 message DeleteServiceAccountRequest {
-  // The resource name of the service account in the following format:
-  // `projects/{PROJECT_ID}/serviceAccounts/{SERVICE_ACCOUNT_EMAIL}`.
-  // Using `-` as a wildcard for the project will infer the project from
-  // the account. The `account` value can be the `email` address or the
+  // Required. The resource name of the service account in the following format:
+  // `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`.
+  // Using `-` as a wildcard for the `PROJECT_ID` will infer the project from
+  // the account. The `ACCOUNT` value can be the `email` address or the
   // `unique_id` of the service account.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "iam.googleapis.com/ServiceAccount"
+    }
+  ];
 }
 
 // The service account keys list request.
@@ -382,13 +467,18 @@ message ListServiceAccountKeysRequest {
     SYSTEM_MANAGED = 2;
   }
 
-  // The resource name of the service account in the following format:
-  // `projects/{PROJECT_ID}/serviceAccounts/{SERVICE_ACCOUNT_EMAIL}`.
+  // Required. The resource name of the service account in the following format:
+  // `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`.
   //
-  // Using `-` as a wildcard for the project, will infer the project from
-  // the account. The `account` value can be the `email` address or the
+  // Using `-` as a wildcard for the `PROJECT_ID`, will infer the project from
+  // the account. The `ACCOUNT` value can be the `email` address or the
   // `unique_id` of the service account.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "iam.googleapis.com/ServiceAccount"
+    }
+  ];
 
   // Filters the types of keys the user wants to include in the list
   // response. Duplicate key types are not allowed. If no key type
@@ -404,13 +494,18 @@ message ListServiceAccountKeysResponse {
 
 // The service account key get by id request.
 message GetServiceAccountKeyRequest {
-  // The resource name of the service account key in the following format:
-  // `projects/{PROJECT_ID}/serviceAccounts/{SERVICE_ACCOUNT_EMAIL}/keys/{key}`.
+  // Required. The resource name of the service account key in the following format:
+  // `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}`.
   //
-  // Using `-` as a wildcard for the project will infer the project from
-  // the account. The `account` value can be the `email` address or the
+  // Using `-` as a wildcard for the `PROJECT_ID` will infer the project from
+  // the account. The `ACCOUNT` value can be the `email` address or the
   // `unique_id` of the service account.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "iam.googleapis.com/Key"
+    }
+  ];
 
   // The output format of the public key requested.
   // X509_PEM is the default output format.
@@ -427,15 +522,22 @@ message GetServiceAccountKeyRequest {
 // their service accounts.  Users retain the private key of these key-pairs,
 // and Google retains ONLY the public key.
 //
-// System-managed key-pairs are managed automatically by Google, and rotated
-// daily without user intervention.  The private key never leaves Google's
-// servers to maximize security.
+// System-managed keys are automatically rotated by Google, and are used for
+// signing for a maximum of two weeks. The rotation process is probabilistic,
+// and usage of the new key will gradually ramp up and down over the key's
+// lifetime. We recommend caching the public key set for a service account for
+// no more than 24 hours to ensure you have access to the latest keys.
 //
 // Public keys for all service accounts are also published at the OAuth2
 // Service Account API.
 message ServiceAccountKey {
+  option (google.api.resource) = {
+    type: "iam.googleapis.com/Key"
+    pattern: "projects/{project}/serviceAccounts/{service_account}/keys/{key}"
+  };
+
   // The resource name of the service account key in the following format
-  // `projects/{PROJECT_ID}/serviceAccounts/{SERVICE_ACCOUNT_EMAIL}/keys/{key}`.
+  // `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}`.
   string name = 1;
 
   // The output format for the private key.
@@ -452,7 +554,7 @@ message ServiceAccountKey {
   // The private key data. Only provided in `CreateServiceAccountKey`
   // responses. Make sure to keep the private key data secure because it
   // allows for the assertion of the service account identity.
-  // When decoded, the private key data can be used to authenticate with
+  // When base64 decoded, the private key data can be used to authenticate with
   // Google API client libraries and with
   // gcloud
   // auth activate-service-account.
@@ -465,20 +567,29 @@ message ServiceAccountKey {
   google.protobuf.Timestamp valid_after_time = 4;
 
   // The key can be used before this timestamp.
+  // For system-managed key pairs, this timestamp is the end time for the
+  // private key signing operation. The public key could still be used
+  // for verification for a few hours after this time.
   google.protobuf.Timestamp valid_before_time = 5;
 }
 
 // The service account key create request.
 message CreateServiceAccountKeyRequest {
-  // The resource name of the service account in the following format:
-  // `projects/{PROJECT_ID}/serviceAccounts/{SERVICE_ACCOUNT_EMAIL}`.
-  // Using `-` as a wildcard for the project will infer the project from
-  // the account. The `account` value can be the `email` address or the
+  // Required. The resource name of the service account in the following format:
+  // `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`.
+  // Using `-` as a wildcard for the `PROJECT_ID` will infer the project from
+  // the account. The `ACCOUNT` value can be the `email` address or the
   // `unique_id` of the service account.
-  string name = 1;
-
-  // The output format of the private key. `GOOGLE_CREDENTIALS_FILE` is the
-  // default output format.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "iam.googleapis.com/ServiceAccount"
+    }
+  ];
+
+  // The output format of the private key. The default value is
+  // `TYPE_GOOGLE_CREDENTIALS_FILE`, which is the Google Credentials File
+  // format.
   ServiceAccountPrivateKeyType private_key_type = 2;
 
   // Which type of key and algorithm to use for the key.
@@ -489,25 +600,35 @@ message CreateServiceAccountKeyRequest {
 
 // The service account key delete request.
 message DeleteServiceAccountKeyRequest {
-  // The resource name of the service account key in the following format:
-  // `projects/{PROJECT_ID}/serviceAccounts/{SERVICE_ACCOUNT_EMAIL}/keys/{key}`.
-  // Using `-` as a wildcard for the project will infer the project from
-  // the account. The `account` value can be the `email` address or the
+  // Required. The resource name of the service account key in the following format:
+  // `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}/keys/{key}`.
+  // Using `-` as a wildcard for the `PROJECT_ID` will infer the project from
+  // the account. The `ACCOUNT` value can be the `email` address or the
   // `unique_id` of the service account.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "iam.googleapis.com/Key"
+    }
+  ];
 }
 
 // The service account sign blob request.
 message SignBlobRequest {
-  // The resource name of the service account in the following format:
-  // `projects/{PROJECT_ID}/serviceAccounts/{SERVICE_ACCOUNT_EMAIL}`.
-  // Using `-` as a wildcard for the project will infer the project from
-  // the account. The `account` value can be the `email` address or the
+  // Required. The resource name of the service account in the following format:
+  // `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`.
+  // Using `-` as a wildcard for the `PROJECT_ID` will infer the project from
+  // the account. The `ACCOUNT` value can be the `email` address or the
   // `unique_id` of the service account.
-  string name = 1;
-
-  // The bytes to sign.
-  bytes bytes_to_sign = 2;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "iam.googleapis.com/ServiceAccount"
+    }
+  ];
+
+  // Required. The bytes to sign.
+  bytes bytes_to_sign = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The service account sign blob response.
@@ -521,15 +642,20 @@ message SignBlobResponse {
 
 // The service account sign JWT request.
 message SignJwtRequest {
-  // The resource name of the service account in the following format:
-  // `projects/{PROJECT_ID}/serviceAccounts/{SERVICE_ACCOUNT_EMAIL}`.
-  // Using `-` as a wildcard for the project will infer the project from
-  // the account. The `account` value can be the `email` address or the
+  // Required. The resource name of the service account in the following format:
+  // `projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}`.
+  // Using `-` as a wildcard for the `PROJECT_ID` will infer the project from
+  // the account. The `ACCOUNT` value can be the `email` address or the
   // `unique_id` of the service account.
-  string name = 1;
-
-  // The JWT payload to sign, a JSON JWT Claim set.
-  string payload = 2;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "iam.googleapis.com/ServiceAccount"
+    }
+  ];
+
+  // Required. The JWT payload to sign, a JSON JWT Claim set.
+  string payload = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The service account sign JWT response.
@@ -545,10 +671,12 @@ message SignJwtResponse {
 message Role {
   // A stage representing a role's lifecycle phase.
   enum RoleLaunchStage {
-    // The user has indicated this role is currently in an alpha phase.
+    // The user has indicated this role is currently in an Alpha phase. If this
+    // launch stage is selected, the `stage` field will not be included when
+    // requesting the definition for a given role.
     ALPHA = 0;
 
-    // The user has indicated this role is currently in a beta phase.
+    // The user has indicated this role is currently in a Beta phase.
     BETA = 1;
 
     // The user has indicated this role is generally available.
@@ -561,7 +689,7 @@ message Role {
     // it is granted to in policies.
     DISABLED = 5;
 
-    // The user has indicated this role is currently in an eap phase.
+    // The user has indicated this role is currently in an EAP phase.
     EAP = 6;
   }
 
@@ -570,21 +698,23 @@ message Role {
   // When Role is used in CreateRole, the role name must not be set.
   //
   // When Role is used in output and other input such as UpdateRole, the role
-  // name is the complete path, e.g., roles/logging.viewer for curated roles
+  // name is the complete path, e.g., roles/logging.viewer for predefined roles
   // and organizations/{ORGANIZATION_ID}/roles/logging.viewer for custom roles.
   string name = 1;
 
-  // Optional.  A human-readable title for the role.  Typically this
+  // Optional. A human-readable title for the role.  Typically this
   // is limited to 100 UTF-8 bytes.
   string title = 2;
 
-  // Optional.  A human-readable description for the role.
+  // Optional. A human-readable description for the role.
   string description = 3;
 
   // The names of the permissions this role grants when bound in an IAM policy.
   repeated string included_permissions = 7;
 
-  // The current launch stage of the role.
+  // The current launch stage of the role. If the `ALPHA` launch stage has been
+  // selected for a role, the `stage` field will not be included in the
+  // returned definition for the role.
   RoleLaunchStage stage = 8;
 
   // Used to perform a consistent read-modify-write.
@@ -602,7 +732,7 @@ message QueryGrantableRolesRequest {
   // The name follows the Google Cloud Platform resource format.
   // For example, a Cloud Platform project with id `my-project` will be named
   // `//cloudresourcemanager.googleapis.com/projects/my-project`.
-  string full_resource_name = 1;
+  string full_resource_name = 1 [(google.api.field_behavior) = REQUIRED];
 
   RoleView view = 2;
 
@@ -626,11 +756,34 @@ message QueryGrantableRolesResponse {
 
 // The request to get all roles defined under a resource.
 message ListRolesRequest {
-  // The resource name of the parent resource in one of the following formats:
-  // `` (empty string) -- this refers to curated roles.
-  // `organizations/{ORGANIZATION_ID}`
-  // `projects/{PROJECT_ID}`
-  string parent = 1;
+  // The `parent` parameter's value depends on the target resource for the
+  // request, namely
+  // [`roles`](/iam/reference/rest/v1/roles),
+  // [`projects`](/iam/reference/rest/v1/projects.roles), or
+  // [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
+  // resource type's `parent` value format is described below:
+  //
+  // * [`roles.list()`](/iam/reference/rest/v1/roles/list): An empty string.
+  //   This method doesn't require a resource; it simply returns all
+  //   [predefined roles](/iam/docs/understanding-roles#predefined_roles) in
+  //   Cloud IAM. Example request URL:
+  //   `https://iam.googleapis.com/v1/roles`
+  //
+  // * [`projects.roles.list()`](/iam/reference/rest/v1/projects.roles/list):
+  //   `projects/{PROJECT_ID}`. This method lists all project-level
+  //   [custom roles](/iam/docs/understanding-custom-roles).
+  //   Example request URL:
+  //   `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles`
+  //
+  // * [`organizations.roles.list()`](/iam/reference/rest/v1/organizations.roles/list):
+  //   `organizations/{ORGANIZATION_ID}`. This method lists all
+  //   organization-level [custom roles](/iam/docs/understanding-custom-roles).
+  //   Example request URL:
+  //   `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles`
+  //
+  // Note: Wildcard (*) values are invalid; you must specify a complete project
+  // ID or organization ID.
+  string parent = 1 [(google.api.resource_reference).type = "*"];
 
   // Optional limit on the number of roles to include in the response.
   int32 page_size = 2;
@@ -638,7 +791,10 @@ message ListRolesRequest {
   // Optional pagination token returned in an earlier ListRolesResponse.
   string page_token = 3;
 
-  // Optional view for the returned Role objects.
+  // Optional view for the returned Role objects. When `FULL` is specified,
+  // the `includedPermissions` field is returned, which includes a list of all
+  // permissions in the role. The default value is `BASIC`, which does not
+  // return the `includedPermissions` field.
   RoleView view = 4;
 
   // Include Roles that have been deleted.
@@ -657,21 +813,61 @@ message ListRolesResponse {
 
 // The request to get the definition of an existing role.
 message GetRoleRequest {
-  // The resource name of the role in one of the following formats:
-  // `roles/{ROLE_NAME}`
-  // `organizations/{ORGANIZATION_ID}/roles/{ROLE_NAME}`
-  // `projects/{PROJECT_ID}/roles/{ROLE_NAME}`
-  string name = 1;
+  // The `name` parameter's value depends on the target resource for the
+  // request, namely
+  // [`roles`](/iam/reference/rest/v1/roles),
+  // [`projects`](/iam/reference/rest/v1/projects.roles), or
+  // [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
+  // resource type's `name` value format is described below:
+  //
+  // * [`roles.get()`](/iam/reference/rest/v1/roles/get): `roles/{ROLE_NAME}`.
+  //   This method returns results from all
+  //   [predefined roles](/iam/docs/understanding-roles#predefined_roles) in
+  //   Cloud IAM. Example request URL:
+  //   `https://iam.googleapis.com/v1/roles/{ROLE_NAME}`
+  //
+  // * [`projects.roles.get()`](/iam/reference/rest/v1/projects.roles/get):
+  //   `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method returns only
+  //   [custom roles](/iam/docs/understanding-custom-roles) that have been
+  //   created at the project level. Example request URL:
+  //   `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`
+  //
+  // * [`organizations.roles.get()`](/iam/reference/rest/v1/organizations.roles/get):
+  //   `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method
+  //   returns only [custom roles](/iam/docs/understanding-custom-roles) that
+  //   have been created at the organization level. Example request URL:
+  //   `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`
+  //
+  // Note: Wildcard (*) values are invalid; you must specify a complete project
+  // ID or organization ID.
+  string name = 1 [(google.api.resource_reference).type = "*"];
 }
 
 // The request to create a new role.
 message CreateRoleRequest {
-  // The resource name of the parent resource in one of the following formats:
-  // `organizations/{ORGANIZATION_ID}`
-  // `projects/{PROJECT_ID}`
-  string parent = 1;
+  // The `parent` parameter's value depends on the target resource for the
+  // request, namely
+  // [`projects`](/iam/reference/rest/v1/projects.roles) or
+  // [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
+  // resource type's `parent` value format is described below:
+  //
+  // * [`projects.roles.create()`](/iam/reference/rest/v1/projects.roles/create):
+  //   `projects/{PROJECT_ID}`. This method creates project-level
+  //   [custom roles](/iam/docs/understanding-custom-roles).
+  //   Example request URL:
+  //   `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles`
+  //
+  // * [`organizations.roles.create()`](/iam/reference/rest/v1/organizations.roles/create):
+  //   `organizations/{ORGANIZATION_ID}`. This method creates organization-level
+  //   [custom roles](/iam/docs/understanding-custom-roles). Example request
+  //   URL:
+  //   `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles`
+  //
+  // Note: Wildcard (*) values are invalid; you must specify a complete project
+  // ID or organization ID.
+  string parent = 1 [(google.api.resource_reference).type = "*"];
 
-  // The role id to use for this role.
+  // The role ID to use for this role.
   string role_id = 2;
 
   // The Role resource to create.
@@ -680,11 +876,27 @@ message CreateRoleRequest {
 
 // The request to update a role.
 message UpdateRoleRequest {
-  // The resource name of the role in one of the following formats:
-  // `roles/{ROLE_NAME}`
-  // `organizations/{ORGANIZATION_ID}/roles/{ROLE_NAME}`
-  // `projects/{PROJECT_ID}/roles/{ROLE_NAME}`
-  string name = 1;
+  // The `name` parameter's value depends on the target resource for the
+  // request, namely
+  // [`projects`](/iam/reference/rest/v1/projects.roles) or
+  // [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
+  // resource type's `name` value format is described below:
+  //
+  // * [`projects.roles.patch()`](/iam/reference/rest/v1/projects.roles/patch):
+  //   `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method updates only
+  //   [custom roles](/iam/docs/understanding-custom-roles) that have been
+  //   created at the project level. Example request URL:
+  //   `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`
+  //
+  // * [`organizations.roles.patch()`](/iam/reference/rest/v1/organizations.roles/patch):
+  //   `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method
+  //   updates only [custom roles](/iam/docs/understanding-custom-roles) that
+  //   have been created at the organization level. Example request URL:
+  //   `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`
+  //
+  // Note: Wildcard (*) values are invalid; you must specify a complete project
+  // ID or organization ID.
+  string name = 1 [(google.api.resource_reference).type = "*"];
 
   // The updated role.
   Role role = 2;
@@ -695,10 +907,27 @@ message UpdateRoleRequest {
 
 // The request to delete an existing role.
 message DeleteRoleRequest {
-  // The resource name of the role in one of the following formats:
-  // `organizations/{ORGANIZATION_ID}/roles/{ROLE_NAME}`
-  // `projects/{PROJECT_ID}/roles/{ROLE_NAME}`
-  string name = 1;
+  // The `name` parameter's value depends on the target resource for the
+  // request, namely
+  // [`projects`](/iam/reference/rest/v1/projects.roles) or
+  // [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
+  // resource type's `name` value format is described below:
+  //
+  // * [`projects.roles.delete()`](/iam/reference/rest/v1/projects.roles/delete):
+  //   `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method deletes only
+  //   [custom roles](/iam/docs/understanding-custom-roles) that have been
+  //   created at the project level. Example request URL:
+  //   `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`
+  //
+  // * [`organizations.roles.delete()`](/iam/reference/rest/v1/organizations.roles/delete):
+  //   `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method
+  //   deletes only [custom roles](/iam/docs/understanding-custom-roles) that
+  //   have been created at the organization level. Example request URL:
+  //   `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`
+  //
+  // Note: Wildcard (*) values are invalid; you must specify a complete project
+  // ID or organization ID.
+  string name = 1 [(google.api.resource_reference).type = "*"];
 
   // Used to perform a consistent read-modify-write.
   bytes etag = 2;
@@ -706,10 +935,27 @@ message DeleteRoleRequest {
 
 // The request to undelete an existing role.
 message UndeleteRoleRequest {
-  // The resource name of the role in one of the following formats:
-  // `organizations/{ORGANIZATION_ID}/roles/{ROLE_NAME}`
-  // `projects/{PROJECT_ID}/roles/{ROLE_NAME}`
-  string name = 1;
+  // The `name` parameter's value depends on the target resource for the
+  // request, namely
+  // [`projects`](/iam/reference/rest/v1/projects.roles) or
+  // [`organizations`](/iam/reference/rest/v1/organizations.roles). Each
+  // resource type's `name` value format is described below:
+  //
+  // * [`projects.roles.undelete()`](/iam/reference/rest/v1/projects.roles/undelete):
+  //   `projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`. This method undeletes
+  //   only [custom roles](/iam/docs/understanding-custom-roles) that have been
+  //   created at the project level. Example request URL:
+  //   `https://iam.googleapis.com/v1/projects/{PROJECT_ID}/roles/{CUSTOM_ROLE_ID}`
+  //
+  // * [`organizations.roles.undelete()`](/iam/reference/rest/v1/organizations.roles/undelete):
+  //   `organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`. This method
+  //   undeletes only [custom roles](/iam/docs/understanding-custom-roles) that
+  //   have been created at the organization level. Example request URL:
+  //   `https://iam.googleapis.com/v1/organizations/{ORGANIZATION_ID}/roles/{CUSTOM_ROLE_ID}`
+  //
+  // Note: Wildcard (*) values are invalid; you must specify a complete project
+  // ID or organization ID.
+  string name = 1 [(google.api.resource_reference).type = "*"];
 
   // Used to perform a consistent read-modify-write.
   bytes etag = 2;
@@ -751,6 +997,7 @@ message Permission {
   string title = 2;
 
   // A brief description of what this Permission is used for.
+  // This permission can ONLY be used in predefined roles.
   string description = 3;
 
   // This permission can ONLY be used in predefined roles.
diff --git a/third_party/googleapis/google/iam/admin/v1/iam.yaml b/third_party/googleapis/google/iam/admin/v1/iam.yaml
new file mode 100644
index 000000000..df0851e3f
--- /dev/null
+++ b/third_party/googleapis/google/iam/admin/v1/iam.yaml
@@ -0,0 +1,20 @@
+type: google.api.Service
+config_version: 2
+name: iam.googleapis.com
+title: Identity and Access Management (IAM) API
+
+apis:
+- name: google.iam.admin.v1.IAM
+
+documentation:
+  summary: |-
+    Manages identity and access control for Google Cloud Platform resources,
+    including the creation of service accounts, which you can use to
+    authenticate to Google and make API calls.
+
+authentication:
+  rules:
+  - selector: 'google.iam.admin.v1.IAM.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/iam/admin/v1/iam_gapic.legacy.yaml b/third_party/googleapis/google/iam/admin/v1/iam_gapic.legacy.yaml
new file mode 100644
index 000000000..4c568c2f9
--- /dev/null
+++ b/third_party/googleapis/google/iam/admin/v1/iam_gapic.legacy.yaml
@@ -0,0 +1,249 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.iam.admin.v1
+  python:
+    package_name: google.cloud.iam_admin_v1.gapic
+  go:
+    package_name: cloud.google.com/go/iam/admin/apiv1
+  csharp:
+    package_name: Google.Iam.Admin.V1
+  ruby:
+    package_name: Google::Cloud::Iam::Admin::V1
+  php:
+    package_name: Google\Cloud\Iam\Admin\V1
+  nodejs:
+    package_name: iam.v1
+    domain_layer_location: google-cloud
+interfaces:
+- name: google.iam.admin.v1.IAM
+  collections:
+  - name_pattern: projects/{project}
+    entity_name: project
+    language_overrides:
+    - language: csharp
+      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
+  - name_pattern: projects/{project}/serviceAccounts/{service_account}
+    entity_name: service_account
+  - name_pattern: projects/{project}/serviceAccounts/{service_account}/keys/{key}
+    entity_name: key
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  methods:
+  - name: ListServiceAccounts
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: accounts
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: project
+    timeout_millis: 60000
+  - name: GetServiceAccount
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: service_account
+    timeout_millis: 60000
+  - name: CreateServiceAccount
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - account_id
+        - service_account
+    required_fields:
+    - name
+    - account_id
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: project
+    timeout_millis: 60000
+  - name: UpdateServiceAccount
+    required_fields:
+    - etag
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: service_account
+    timeout_millis: 60000
+  - name: DeleteServiceAccount
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: service_account
+    timeout_millis: 60000
+  - name: ListServiceAccountKeys
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - key_types
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: service_account
+    timeout_millis: 60000
+  - name: GetServiceAccountKey
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - public_key_type
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: key
+    timeout_millis: 60000
+  - name: CreateServiceAccountKey
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - private_key_type
+        - key_algorithm
+    required_fields:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: service_account
+    timeout_millis: 60000
+  - name: DeleteServiceAccountKey
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: key
+    timeout_millis: 60000
+  - name: SignBlob
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - bytes_to_sign
+    required_fields:
+    - name
+    - bytes_to_sign
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: service_account
+    timeout_millis: 60000
+  - name: GetIamPolicy
+    flattening:
+      groups:
+      - parameters:
+        - resource
+    required_fields:
+    - resource
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: service_account
+    timeout_millis: 60000
+    surface_treatments:
+    - include_languages:
+      - go
+      visibility: PRIVATE
+  - name: SetIamPolicy
+    flattening:
+      groups:
+      - parameters:
+        - resource
+        - policy
+    required_fields:
+    - resource
+    - policy
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: service_account
+    timeout_millis: 60000
+    surface_treatments:
+    - include_languages:
+      - go
+      visibility: PRIVATE
+  - name: TestIamPermissions
+    flattening:
+      groups:
+      - parameters:
+        - resource
+        - permissions
+    required_fields:
+    - resource
+    - permissions
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: service_account
+    timeout_millis: 60000
+  - name: QueryGrantableRoles
+    flattening:
+      groups:
+      - parameters:
+        - full_resource_name
+    required_fields:
+    - full_resource_name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: SignJwt
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - payload
+    required_fields:
+    - name
+    - payload
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
diff --git a/third_party/googleapis/google/iam/admin/v1/iam_gapic.yaml b/third_party/googleapis/google/iam/admin/v1/iam_gapic.yaml
index cf122127a..5f63acb7b 100644
--- a/third_party/googleapis/google/iam/admin/v1/iam_gapic.yaml
+++ b/third_party/googleapis/google/iam/admin/v1/iam_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.iam.admin.v1
@@ -16,234 +16,3 @@ language_settings:
   nodejs:
     package_name: iam.v1
     domain_layer_location: google-cloud
-interfaces:
-- name: google.iam.admin.v1.IAM
-  collections:
-  - name_pattern: projects/{project}
-    entity_name: project
-    language_overrides:
-    - language: csharp
-      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
-  - name_pattern: projects/{project}/serviceAccounts/{service_account}
-    entity_name: service_account
-  - name_pattern: projects/{project}/serviceAccounts/{service_account}/keys/{key}
-    entity_name: key
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  methods:
-  - name: ListServiceAccounts
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: accounts
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: project
-    timeout_millis: 60000
-  - name: GetServiceAccount
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: service_account
-    timeout_millis: 60000
-  - name: CreateServiceAccount
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - account_id
-        - service_account
-    required_fields:
-    - name
-    - account_id
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: project
-    timeout_millis: 60000
-  - name: UpdateServiceAccount
-    required_fields:
-      - etag
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: service_account
-    timeout_millis: 60000
-  - name: DeleteServiceAccount
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: service_account
-    timeout_millis: 60000
-  - name: ListServiceAccountKeys
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - key_types
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: service_account
-    timeout_millis: 60000
-  - name: GetServiceAccountKey
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - public_key_type
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: key
-    timeout_millis: 60000
-  - name: CreateServiceAccountKey
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - private_key_type
-        - key_algorithm
-    required_fields:
-    - name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: service_account
-    timeout_millis: 60000
-  - name: DeleteServiceAccountKey
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: key
-    timeout_millis: 60000
-  - name: SignBlob
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - bytes_to_sign
-    required_fields:
-    - name
-    - bytes_to_sign
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: service_account
-    timeout_millis: 60000
-  - name: GetIamPolicy
-    flattening:
-      groups:
-      - parameters:
-        - resource
-    required_fields:
-    - resource
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      resource: service_account
-    timeout_millis: 60000
-    surface_treatments:
-    - include_languages:
-      - go
-      visibility: PRIVATE
-  - name: SetIamPolicy
-    flattening:
-      groups:
-      - parameters:
-        - resource
-        - policy
-    required_fields:
-    - resource
-    - policy
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      resource: service_account
-    timeout_millis: 60000
-    surface_treatments:
-    - include_languages:
-      - go
-      visibility: PRIVATE
-  - name: TestIamPermissions
-    flattening:
-      groups:
-      - parameters:
-        - resource
-        - permissions
-    required_fields:
-    - resource
-    - permissions
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      resource: service_account
-    timeout_millis: 60000
-  - name: QueryGrantableRoles
-    flattening:
-      groups:
-      - parameters:
-        - full_resource_name
-    required_fields:
-    - full_resource_name
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-  - name: SignJwt
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - payload
-    required_fields:
-    - name
-    - payload
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
diff --git a/third_party/googleapis/google/iam/admin/v1/iam_grpc_service_config.json b/third_party/googleapis/google/iam/admin/v1/iam_grpc_service_config.json
new file mode 100755
index 000000000..deff5a716
--- /dev/null
+++ b/third_party/googleapis/google/iam/admin/v1/iam_grpc_service_config.json
@@ -0,0 +1,84 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.iam.admin.v1.IAM",
+          "method": "ListServiceAccounts"
+        },
+        {
+          "service": "google.iam.admin.v1.IAM",
+          "method": "GetServiceAccount"
+        },
+        {
+          "service": "google.iam.admin.v1.IAM",
+          "method": "UpdateServiceAccount"
+        },
+        {
+          "service": "google.iam.admin.v1.IAM",
+          "method": "DeleteServiceAccount"
+        },
+        {
+          "service": "google.iam.admin.v1.IAM",
+          "method": "ListServiceAccountKeys"
+        },
+        {
+          "service": "google.iam.admin.v1.IAM",
+          "method": "GetServiceAccountKey"
+        },
+        {
+          "service": "google.iam.admin.v1.IAM",
+          "method": "DeleteServiceAccountKey"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.iam.admin.v1.IAM",
+          "method": "CreateServiceAccount"
+        },
+        {
+          "service": "google.iam.admin.v1.IAM",
+          "method": "CreateServiceAccountKey"
+        },
+        {
+          "service": "google.iam.admin.v1.IAM",
+          "method": "SignBlob"
+        },
+        {
+          "service": "google.iam.admin.v1.IAM",
+          "method": "GetIamPolicy"
+        },
+        {
+          "service": "google.iam.admin.v1.IAM",
+          "method": "SetIamPolicy"
+        },
+        {
+          "service": "google.iam.admin.v1.IAM",
+          "method": "TestIamPermissions"
+        },
+        {
+          "service": "google.iam.admin.v1.IAM",
+          "method": "QueryGrantableRoles"
+        },
+        {
+          "service": "google.iam.admin.v1.IAM",
+          "method": "SignJwt"
+        }
+      ],
+      "timeout": "60s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/iam/artman_iam.yaml b/third_party/googleapis/google/iam/artman_iam.yaml
index 7ef4e85a5..01eac1011 100644
--- a/third_party/googleapis/google/iam/artman_iam.yaml
+++ b/third_party/googleapis/google/iam/artman_iam.yaml
@@ -2,7 +2,7 @@ common:
   api_name: iam
   api_version: v1
   organization_name: google
-  gapic_yaml: v1/iam_gapic.yaml
+  gapic_yaml: v1/iam_gapic.legacy.yaml
   src_proto_paths:
   - v1
   proto_deps:
diff --git a/third_party/googleapis/google/iam/artman_iam_admin.yaml b/third_party/googleapis/google/iam/artman_iam_admin.yaml
index a973d6c6a..fea9d9d06 100644
--- a/third_party/googleapis/google/iam/artman_iam_admin.yaml
+++ b/third_party/googleapis/google/iam/artman_iam_admin.yaml
@@ -2,8 +2,9 @@ common:
   api_name: iam-admin
   api_version: v1
   organization_name: google
-  service_yaml: iam.yaml
+  service_yaml: admin/v1/iam.yaml
   gapic_yaml: admin/v1/iam_gapic.yaml
+  proto_package: google.iam.admin.v1
   src_proto_paths:
   - admin/v1
   proto_deps:
diff --git a/third_party/googleapis/google/iam/artman_iam_meta_api.yaml b/third_party/googleapis/google/iam/artman_iam_meta_api.yaml
index 5d8c9a83c..a3356ae26 100644
--- a/third_party/googleapis/google/iam/artman_iam_meta_api.yaml
+++ b/third_party/googleapis/google/iam/artman_iam_meta_api.yaml
@@ -7,7 +7,7 @@ common:
   src_proto_paths:
   - v1
   service_yaml: iam_meta_api.yaml
-  gapic_yaml: v1/iam_meta_api_gapic.yaml
+  gapic_yaml: v1/iam_meta_api_gapic.legacy.yaml
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/iam/credentials/BUILD.bazel b/third_party/googleapis/google/iam/credentials/BUILD.bazel
index 1e5b8c2af..a87c57fec 100644
--- a/third_party/googleapis/google/iam/credentials/BUILD.bazel
+++ b/third_party/googleapis/google/iam/credentials/BUILD.bazel
@@ -1 +1 @@
-exports_files(glob(["*.yaml"]))
\ No newline at end of file
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/iam/credentials/v1/BUILD.bazel b/third_party/googleapis/google/iam/credentials/v1/BUILD.bazel
index d3ac16d3c..70878c684 100644
--- a/third_party/googleapis/google/iam/credentials/v1/BUILD.bazel
+++ b/third_party/googleapis/google/iam/credentials/v1/BUILD.bazel
@@ -1,27 +1,36 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
-    name = "iamcredentials_proto",
+    name = "credentials_proto",
     srcs = [
         "common.proto",
         "iamcredentials.proto",
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
         "@com_google_protobuf//:duration_proto",
         "@com_google_protobuf//:timestamp_proto",
     ],
 )
 
 proto_library_with_info(
-    name = "iamcredentials_proto_with_info",
-    deps = [":iamcredentials_proto"],
+    name = "credentials_proto_with_info",
+    deps = [
+        ":credentials_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -29,69 +38,55 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
-    name = "iamcredentials_java_proto",
-    deps = [":iamcredentials_proto"],
+    name = "credentials_java_proto",
+    deps = [":credentials_proto"],
 )
 
 java_grpc_library(
-    name = "iamcredentials_java_grpc",
-    srcs = [":iamcredentials_proto"],
-    deps = [":iamcredentials_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "iamcredentials_resource_name_java_proto",
-    gapic_yaml = "iamcredentials_gapic.yaml",
-    deps = [":iamcredentials_proto"],
+    name = "credentials_java_grpc",
+    srcs = [":credentials_proto"],
+    deps = [":credentials_java_proto"],
 )
 
 java_gapic_library(
-    name = "iamcredentials_java_gapic",
-    src = ":iamcredentials_proto_with_info",
+    name = "credentials_java_gapic",
+    src = ":credentials_proto_with_info",
     gapic_yaml = "iamcredentials_gapic.yaml",
+    package = "google.iam.credentials.v1",
     service_yaml = "//google/iam/credentials:iamcredentials_v1.yaml",
-    test_deps = [":iamcredentials_java_grpc"],
+    test_deps = [
+        ":credentials_java_grpc",
+    ],
     deps = [
-        ":iamcredentials_java_proto",
-        ":iamcredentials_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+        ":credentials_java_proto",
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [":iamcredentials_java_gapic_test"],
-) for test_name in [
-    "com.google.cloud.iam.credentials.v1.IamCredentialsClientTest",
-]]
+java_gapic_test(
+    name = "credentials_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.iam.credentials.v1.IamCredentialsClientTest",
+    ],
+    runtime_deps = [":credentials_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
-    name = "google-cloud-iamcredentials-v1-java",
-    client_deps = [":iamcredentials_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":iamcredentials_java_gapic_test"],
-    grpc_deps = [":iamcredentials_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
-        ":iamcredentials_resource_name_java_proto",
-        ":iamcredentials_java_proto",
-        ":iamcredentials_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    name = "google-cloud-iam-credentials-v1-java",
+    deps = [
+        ":credentials_java_gapic",
+        ":credentials_java_grpc",
+        ":credentials_java_proto",
+        ":credentials_proto",
+    ],
 )
 
 ##############################################################################
@@ -99,43 +94,284 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
-    name = "iamcredentials_go_proto",
+    name = "credentials_go_proto",
     compilers = ["@io_bazel_rules_go//proto:go_grpc"],
     importpath = "google.golang.org/genproto/googleapis/iam/credentials/v1",
-    protos = [":iamcredentials_proto"],
-    deps = ["//google/api:annotations_go_proto"],
+    protos = [":credentials_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
 )
 
 go_gapic_library(
-    name = "iamcredentials_go_gapic",
-    src = ":iamcredentials_proto_with_info",
-    gapic_yaml = "iamcredentials_gapic.yaml",
-    importpath = "cloud.google.com/go/iam/credentials/apiv1",
+    name = "credentials_go_gapic",
+    srcs = [":credentials_proto_with_info"],
+    grpc_service_config = "iamcredentials_grpc_service_config.json",
+    importpath = "cloud.google.com/go/iam/credentials/apiv1;credentials",
     service_yaml = "//google/iam/credentials:iamcredentials_v1.yaml",
-    deps = [":iamcredentials_go_proto"],
+    deps = [
+        ":credentials_go_proto",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
+    ],
 )
 
 go_test(
-    name = "iamcredentials_go_gapic_test",
-    srcs = [":iamcredentials_go_gapic_srcjar_test"],
-    embed = [":iamcredentials_go_gapic"],
+    name = "credentials_go_gapic_test",
+    srcs = [":credentials_go_gapic_srcjar_test"],
+    embed = [":credentials_go_gapic"],
     importpath = "cloud.google.com/go/iam/credentials/apiv1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
-    name = "gapi-cloud-iamcredentials-v1-go",
+    name = "gapi-cloud-iam-credentials-v1-go",
     deps = [
-        ":iamcredentials_go_gapic",
-        ":iamcredentials_go_gapic_srcjar-smoke-test.srcjar",
-        ":iamcredentials_go_gapic_srcjar-test.srcjar",
-        ":iamcredentials_go_proto",
+        ":credentials_go_gapic",
+        ":credentials_go_gapic_srcjar-test.srcjar",
+        ":credentials_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "credentials_moved_proto",
+    srcs = [":credentials_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "credentials_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":credentials_moved_proto"],
+)
+
+py_grpc_library(
+    name = "credentials_py_grpc",
+    srcs = [":credentials_moved_proto"],
+    deps = [":credentials_py_proto"],
+)
+
+py_gapic_library(
+    name = "credentials_py_gapic",
+    src = ":credentials_proto_with_info",
+    gapic_yaml = "iamcredentials_gapic.yaml",
+    package = "google.iam.credentials.v1",
+    service_yaml = "//google/iam/credentials:iamcredentials_v1.yaml",
+    deps = [
+        ":credentials_py_grpc",
+        ":credentials_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "iam-credentials-v1-py",
+    deps = [
+        ":credentials_py_gapic",
+        ":credentials_py_grpc",
+        ":credentials_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "credentials_php_proto",
+    deps = [":credentials_proto"],
+)
+
+php_grpc_library(
+    name = "credentials_php_grpc",
+    srcs = [":credentials_proto"],
+    deps = [":credentials_php_proto"],
+)
+
+php_gapic_library(
+    name = "credentials_php_gapic",
+    src = ":credentials_proto_with_info",
+    gapic_yaml = "iamcredentials_gapic.yaml",
+    package = "google.iam.credentials.v1",
+    service_yaml = "//google/iam/credentials:iamcredentials_v1.yaml",
+    deps = [
+        ":credentials_php_grpc",
+        ":credentials_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-iam-credentials-v1-php",
+    deps = [
+        ":credentials_php_gapic",
+        ":credentials_php_grpc",
+        ":credentials_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "credentials_nodejs_gapic",
+    src = ":credentials_proto_with_info",
+    gapic_yaml = "iamcredentials_gapic.yaml",
+    package = "google.iam.credentials.v1",
+    service_yaml = "//google/iam/credentials:iamcredentials_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "iam-credentials-v1-nodejs",
+    deps = [
+        ":credentials_nodejs_gapic",
+        ":credentials_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "credentials_ruby_proto",
+    deps = [":credentials_proto"],
+)
+
+ruby_grpc_library(
+    name = "credentials_ruby_grpc",
+    srcs = [":credentials_proto"],
+    deps = [":credentials_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "credentials_ruby_gapic",
+    src = ":credentials_proto_with_info",
+    gapic_yaml = "iamcredentials_gapic.yaml",
+    package = "google.iam.credentials.v1",
+    service_yaml = "//google/iam/credentials:iamcredentials_v1.yaml",
+    deps = [
+        ":credentials_ruby_grpc",
+        ":credentials_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-iam-credentials-v1-ruby",
+    deps = [
+        ":credentials_ruby_gapic",
+        ":credentials_ruby_grpc",
+        ":credentials_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "credentials_csharp_proto",
+    deps = [":credentials_proto"],
+)
+
+csharp_grpc_library(
+    name = "credentials_csharp_grpc",
+    srcs = [":credentials_proto"],
+    deps = [":credentials_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "credentials_csharp_gapic",
+    src = ":credentials_proto_with_info",
+    gapic_yaml = "iamcredentials_gapic.yaml",
+    package = "google.iam.credentials.v1",
+    service_yaml = "//google/iam/credentials:iamcredentials_v1.yaml",
+    deps = [
+        ":credentials_csharp_grpc",
+        ":credentials_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-iam-credentials-v1-csharp",
+    deps = [
+        ":credentials_csharp_gapic",
+        ":credentials_csharp_grpc",
+        ":credentials_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "cc_proto_library",
+    "cc_grpc_library")
+
+cc_proto_library(
+    name = "credentials_cc_proto",
+    deps = [":credentials_proto"],
+)
+
+cc_grpc_library(
+    name = "credentials_cc_grpc",
+    srcs = [":credentials_proto"],
+    grpc_only = True,
+    deps = [":credentials_cc_proto"],
+)
diff --git a/third_party/googleapis/google/iam/credentials/v1/common.proto b/third_party/googleapis/google/iam/credentials/v1/common.proto
index 6ba010199..361f2e90c 100644
--- a/third_party/googleapis/google/iam/credentials/v1/common.proto
+++ b/third_party/googleapis/google/iam/credentials/v1/common.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,11 +11,14 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.iam.credentials.v1;
 
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
 
@@ -24,12 +27,22 @@ option go_package = "google.golang.org/genproto/googleapis/iam/credentials/v1;cr
 option java_multiple_files = true;
 option java_outer_classname = "IAMCredentialsCommonProto";
 option java_package = "com.google.cloud.iam.credentials.v1";
+option (google.api.resource_definition) = {
+  type: "iam.googleapis.com/ServiceAccount"
+  pattern: "projects/{project}/serviceAccounts/{service_account}"
+};
 
 message GenerateAccessTokenRequest {
-  // The resource name of the service account for which the credentials
+  // Required. The resource name of the service account for which the credentials
   // are requested, in the following format:
-  // `projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}`.
-  string name = 1;
+  // `projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}`. The `-` wildcard
+  // character is required; replacing it with a project ID is invalid.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "iam.googleapis.com/ServiceAccount"
+    }
+  ];
 
   // The sequence of service accounts in a delegation chain. Each service
   // account must be granted the `roles/iam.serviceAccountTokenCreator` role
@@ -39,14 +52,15 @@ message GenerateAccessTokenRequest {
   // request.
   //
   // The delegates must have the following format:
-  // `projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}`
+  // `projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}`. The `-` wildcard
+  // character is required; replacing it with a project ID is invalid.
   repeated string delegates = 2;
 
-  // Code to identify the scopes to be included in the OAuth 2.0 access token.
+  // Required. Code to identify the scopes to be included in the OAuth 2.0 access token.
   // See https://developers.google.com/identity/protocols/googlescopes for more
   // information.
   // At least one value required.
-  repeated string scope = 4;
+  repeated string scope = 4 [(google.api.field_behavior) = REQUIRED];
 
   // The desired lifetime duration of the access token in seconds.
   // Must be set to a value less than or equal to 3600 (1 hour). If a value is
@@ -65,10 +79,16 @@ message GenerateAccessTokenResponse {
 }
 
 message SignBlobRequest {
-  // The resource name of the service account for which the credentials
+  // Required. The resource name of the service account for which the credentials
   // are requested, in the following format:
-  // `projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}`.
-  string name = 1;
+  // `projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}`. The `-` wildcard
+  // character is required; replacing it with a project ID is invalid.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "iam.googleapis.com/ServiceAccount"
+    }
+  ];
 
   // The sequence of service accounts in a delegation chain. Each service
   // account must be granted the `roles/iam.serviceAccountTokenCreator` role
@@ -78,11 +98,12 @@ message SignBlobRequest {
   // request.
   //
   // The delegates must have the following format:
-  // `projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}`
+  // `projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}`. The `-` wildcard
+  // character is required; replacing it with a project ID is invalid.
   repeated string delegates = 3;
 
-  // The bytes to sign.
-  bytes payload = 5;
+  // Required. The bytes to sign.
+  bytes payload = 5 [(google.api.field_behavior) = REQUIRED];
 }
 
 message SignBlobResponse {
@@ -94,10 +115,16 @@ message SignBlobResponse {
 }
 
 message SignJwtRequest {
-  // The resource name of the service account for which the credentials
+  // Required. The resource name of the service account for which the credentials
   // are requested, in the following format:
-  // `projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}`.
-  string name = 1;
+  // `projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}`. The `-` wildcard
+  // character is required; replacing it with a project ID is invalid.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "iam.googleapis.com/ServiceAccount"
+    }
+  ];
 
   // The sequence of service accounts in a delegation chain. Each service
   // account must be granted the `roles/iam.serviceAccountTokenCreator` role
@@ -107,11 +134,12 @@ message SignJwtRequest {
   // request.
   //
   // The delegates must have the following format:
-  // `projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}`
+  // `projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}`. The `-` wildcard
+  // character is required; replacing it with a project ID is invalid.
   repeated string delegates = 3;
 
-  // The JWT payload to sign: a JSON object that contains a JWT Claims Set.
-  string payload = 5;
+  // Required. The JWT payload to sign: a JSON object that contains a JWT Claims Set.
+  string payload = 5 [(google.api.field_behavior) = REQUIRED];
 }
 
 message SignJwtResponse {
@@ -123,10 +151,16 @@ message SignJwtResponse {
 }
 
 message GenerateIdTokenRequest {
-  // The resource name of the service account for which the credentials
+  // Required. The resource name of the service account for which the credentials
   // are requested, in the following format:
-  // `projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}`.
-  string name = 1;
+  // `projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}`. The `-` wildcard
+  // character is required; replacing it with a project ID is invalid.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "iam.googleapis.com/ServiceAccount"
+    }
+  ];
 
   // The sequence of service accounts in a delegation chain. Each service
   // account must be granted the `roles/iam.serviceAccountTokenCreator` role
@@ -136,12 +170,13 @@ message GenerateIdTokenRequest {
   // request.
   //
   // The delegates must have the following format:
-  // `projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}`
+  // `projects/-/serviceAccounts/{ACCOUNT_EMAIL_OR_UNIQUEID}`. The `-` wildcard
+  // character is required; replacing it with a project ID is invalid.
   repeated string delegates = 2;
 
-  // The audience for the token, such as the API or account that this token
+  // Required. The audience for the token, such as the API or account that this token
   // grants access to.
-  string audience = 3;
+  string audience = 3 [(google.api.field_behavior) = REQUIRED];
 
   // Include the service account email in the token. If set to `true`, the
   // token will contain `email` and `email_verified` claims.
diff --git a/third_party/googleapis/google/iam/credentials/v1/iamcredentials.proto b/third_party/googleapis/google/iam/credentials/v1/iamcredentials.proto
index 3308d63a4..29554c567 100644
--- a/third_party/googleapis/google/iam/credentials/v1/iamcredentials.proto
+++ b/third_party/googleapis/google/iam/credentials/v1/iamcredentials.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,12 +11,14 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.iam.credentials.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
 import "google/iam/credentials/v1/common.proto";
 
 option cc_enable_arenas = true;
@@ -35,22 +37,25 @@ option java_package = "com.google.cloud.iam.credentials.v1";
 // tokens, OpenID Connect ID tokens, self-signed JSON Web Tokens (JWTs), and
 // more.
 service IAMCredentials {
+  option (google.api.default_host) = "iamcredentials.googleapis.com";
+  option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform";
+
   // Generates an OAuth 2.0 access token for a service account.
-  rpc GenerateAccessToken(GenerateAccessTokenRequest)
-      returns (GenerateAccessTokenResponse) {
+  rpc GenerateAccessToken(GenerateAccessTokenRequest) returns (GenerateAccessTokenResponse) {
     option (google.api.http) = {
       post: "/v1/{name=projects/*/serviceAccounts/*}:generateAccessToken"
       body: "*"
     };
+    option (google.api.method_signature) = "name,delegates,scope,lifetime";
   }
 
   // Generates an OpenID Connect ID token for a service account.
-  rpc GenerateIdToken(GenerateIdTokenRequest)
-      returns (GenerateIdTokenResponse) {
+  rpc GenerateIdToken(GenerateIdTokenRequest) returns (GenerateIdTokenResponse) {
     option (google.api.http) = {
       post: "/v1/{name=projects/*/serviceAccounts/*}:generateIdToken"
       body: "*"
     };
+    option (google.api.method_signature) = "name,delegates,audience,include_email";
   }
 
   // Signs a blob using a service account's system-managed private key.
@@ -59,6 +64,7 @@ service IAMCredentials {
       post: "/v1/{name=projects/*/serviceAccounts/*}:signBlob"
       body: "*"
     };
+    option (google.api.method_signature) = "name,delegates,payload";
   }
 
   // Signs a JWT using a service account's system-managed private key.
@@ -67,5 +73,6 @@ service IAMCredentials {
       post: "/v1/{name=projects/*/serviceAccounts/*}:signJwt"
       body: "*"
     };
+    option (google.api.method_signature) = "name,delegates,payload";
   }
 }
diff --git a/third_party/googleapis/google/iam/credentials/v1/iamcredentials_gapic.legacy.yaml b/third_party/googleapis/google/iam/credentials/v1/iamcredentials_gapic.legacy.yaml
new file mode 100644
index 000000000..7524a1853
--- /dev/null
+++ b/third_party/googleapis/google/iam/credentials/v1/iamcredentials_gapic.legacy.yaml
@@ -0,0 +1,133 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.iam.credentials.v1
+  python:
+    package_name: google.cloud.iam_credentials_v1.gapic
+  go:
+    package_name: cloud.google.com/go/iam/credentials/apiv1
+  csharp:
+    package_name: Google.Iam.Credentials.V1
+  ruby:
+    package_name: Google::Cloud::Iam::Credentials::V1
+  php:
+    package_name: Google\Cloud\Iam\Credentials\V1
+  nodejs:
+    package_name: credentials.v1
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: google.iam.credentials.v1.IAMCredentials
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}/serviceAccounts/{service_account}
+    entity_name: service_account
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  methods:
+  - name: GenerateAccessToken
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - delegates
+        - scope
+        - lifetime
+    required_fields:
+    - name
+    - scope
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: service_account
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+  - name: GenerateIdToken
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - delegates
+        - audience
+        - include_email
+    required_fields:
+    - name
+    - audience
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: service_account
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+  - name: SignBlob
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - delegates
+        - payload
+    required_fields:
+    - name
+    - payload
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: service_account
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+  - name: SignJwt
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - delegates
+        - payload
+    required_fields:
+    - name
+    - payload
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: service_account
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+resource_name_generation:
+- message_name: GenerateAccessTokenRequest
+  field_entity_map:
+    name: service_account
+- message_name: GenerateIdTokenRequest
+  field_entity_map:
+    name: service_account
+- message_name: SignBlobRequest
+  field_entity_map:
+    name: service_account
+- message_name: SignJwtRequest
+  field_entity_map:
+    name: service_account
diff --git a/third_party/googleapis/google/iam/credentials/v1/iamcredentials_gapic.yaml b/third_party/googleapis/google/iam/credentials/v1/iamcredentials_gapic.yaml
index 7524a1853..6368f96b5 100644
--- a/third_party/googleapis/google/iam/credentials/v1/iamcredentials_gapic.yaml
+++ b/third_party/googleapis/google/iam/credentials/v1/iamcredentials_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 # The settings of generated code in a specific language.
 language_settings:
   java:
@@ -20,114 +20,12 @@ language_settings:
 interfaces:
 # The fully qualified name of the API interface.
 - name: google.iam.credentials.v1.IAMCredentials
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections:
-  - name_pattern: projects/{project}/serviceAccounts/{service_account}
-    entity_name: service_account
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
   methods:
   - name: GenerateAccessToken
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - delegates
-        - scope
-        - lifetime
-    required_fields:
-    - name
-    - scope
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: service_account
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
   - name: GenerateIdToken
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - delegates
-        - audience
-        - include_email
-    required_fields:
-    - name
-    - audience
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: service_account
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
   - name: SignBlob
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - delegates
-        - payload
-    required_fields:
-    - name
-    - payload
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: service_account
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
   - name: SignJwt
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - delegates
-        - payload
-    required_fields:
-    - name
-    - payload
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: service_account
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
-resource_name_generation:
-- message_name: GenerateAccessTokenRequest
-  field_entity_map:
-    name: service_account
-- message_name: GenerateIdTokenRequest
-  field_entity_map:
-    name: service_account
-- message_name: SignBlobRequest
-  field_entity_map:
-    name: service_account
-- message_name: SignJwtRequest
-  field_entity_map:
-    name: service_account
diff --git a/third_party/googleapis/google/iam/credentials/v1/iamcredentials_grpc_service_config.json b/third_party/googleapis/google/iam/credentials/v1/iamcredentials_grpc_service_config.json
new file mode 100755
index 000000000..360bca92d
--- /dev/null
+++ b/third_party/googleapis/google/iam/credentials/v1/iamcredentials_grpc_service_config.json
@@ -0,0 +1,35 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.iam.credentials.v1.IAMCredentials",
+          "method": "GenerateAccessToken"
+        },
+        {
+          "service": "google.iam.credentials.v1.IAMCredentials",
+          "method": "GenerateIdToken"
+        },
+        {
+          "service": "google.iam.credentials.v1.IAMCredentials",
+          "method": "SignBlob"
+        },
+        {
+          "service": "google.iam.credentials.v1.IAMCredentials",
+          "method": "SignJwt"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/iam/credentials/v1/iamcredentials_v1.yaml b/third_party/googleapis/google/iam/credentials/v1/iamcredentials_v1.yaml
new file mode 100644
index 000000000..51b504b70
--- /dev/null
+++ b/third_party/googleapis/google/iam/credentials/v1/iamcredentials_v1.yaml
@@ -0,0 +1,17 @@
+type: google.api.Service
+config_version: 3
+name: iamcredentials.googleapis.com
+title: IAM Service Account Credentials API
+
+apis:
+- name: google.iam.credentials.v1.IAMCredentials
+
+documentation:
+  summary: 'Creates short-lived, limited-privilege credentials for IAM service accounts.'
+
+authentication:
+  rules:
+  - selector: 'google.iam.credentials.v1.IAMCredentials.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/iam/iam.yaml b/third_party/googleapis/google/iam/iam.yaml
deleted file mode 100644
index ccff586b8..000000000
--- a/third_party/googleapis/google/iam/iam.yaml
+++ /dev/null
@@ -1,21 +0,0 @@
-# The IAM API Definition.
-
-type: google.api.Service
-config_version: 2
-name: iam.googleapis.com
-
-title: Google Identity and Access Management (IAM) API
-
-documentation:
-  summary:
-   Manages identity and access control for Google Cloud Platform resources, including the creation of service accounts, which you can use to authenticate to Google and make API calls.
-
-apis:
-- name: google.iam.admin.v1.IAM
-
-authentication:
-  rules:
-    - selector: '*'
-      oauth:
-        canonical_scopes: https://www.googleapis.com/auth/iam,
-                          https://www.googleapis.com/auth/cloud-platform
diff --git a/third_party/googleapis/google/iam/v1/BUILD.bazel b/third_party/googleapis/google/iam/v1/BUILD.bazel
index 2a00de815..0053d05f4 100644
--- a/third_party/googleapis/google/iam/v1/BUILD.bazel
+++ b/third_party/googleapis/google/iam/v1/BUILD.bazel
@@ -1,3 +1,5 @@
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
@@ -10,8 +12,11 @@ proto_library(
     name = "iam_policy_proto",
     srcs = ["iam_policy.proto"],
     deps = [
+        ":options_proto",
         ":policy_proto",
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
         "//google/api:resource_proto",
     ],
 )
@@ -25,10 +30,19 @@ proto_library(
     ],
 )
 
+proto_library(
+    name = "options_proto",
+    srcs = ["options.proto"],
+    deps = [
+        "//google/api:annotations_proto",
+    ],
+)
+
 proto_library_with_info(
     name = "iam_proto_with_info",
     deps = [
         ":iam_policy_proto",
+        ":options_proto",
         ":policy_proto",
     ],
 )
@@ -36,13 +50,14 @@ proto_library_with_info(
 ##############################################################################
 # Java
 ##############################################################################
-load("@com_google_googleapis_imports//:imports.bzl", "java_proto_library", "java_grpc_library")
+load("@com_google_googleapis_imports//:imports.bzl", "java_grpc_library", "java_proto_library")
 
 java_proto_library(
     name = "iam_java_proto",
     deps = [
         ":iam_policy_proto",
         ":policy_proto",
+        ":options_proto",
     ],
 )
 
@@ -57,8 +72,8 @@ java_grpc_library(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "go_proto_library",
     "go_gapic_assembly_pkg",
+    "go_proto_library",
 )
 
 go_proto_library(
@@ -67,6 +82,7 @@ go_proto_library(
     importpath = "google.golang.org/genproto/googleapis/iam/v1",
     protos = [
         ":iam_policy_proto",
+        ":options_proto",
         ":policy_proto",
     ],
     deps = [
@@ -81,3 +97,33 @@ go_gapic_assembly_pkg(
         ":iam_go_proto",
     ],
 )
+
+##############################################################################
+# C++
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "cc_proto_library",
+    "cc_grpc_library")
+
+cc_proto_library(
+    name = "iam_policy_cc_proto",
+    deps = [":iam_policy_proto"],
+)
+
+cc_proto_library(
+    name = "options_cc_proto",
+    deps = [":options_proto"],
+)
+
+cc_proto_library(
+    name = "policy_cc_proto",
+    deps = [":policy_proto"],
+)
+
+cc_grpc_library(
+    name = "iam_cc_grpc",
+    srcs = [":iam_policy_proto"],
+    grpc_only = True,
+    deps = [":iam_policy_cc_proto"],
+)
diff --git a/third_party/googleapis/google/iam/v1/iam_gapic.yaml b/third_party/googleapis/google/iam/v1/iam_gapic.legacy.yaml
similarity index 100%
rename from third_party/googleapis/google/iam/v1/iam_gapic.yaml
rename to third_party/googleapis/google/iam/v1/iam_gapic.legacy.yaml
diff --git a/third_party/googleapis/google/iam/v1/iam_meta_api.yaml b/third_party/googleapis/google/iam/v1/iam_meta_api.yaml
new file mode 100644
index 000000000..939856790
--- /dev/null
+++ b/third_party/googleapis/google/iam/v1/iam_meta_api.yaml
@@ -0,0 +1,85 @@
+type: google.api.Service
+config_version: 2
+name: iam-meta-api.googleapis.com
+title: IAM Meta API
+
+apis:
+- name: google.iam.v1.IAMPolicy
+
+types:
+- name: google.iam.v1.PolicyDelta
+
+documentation:
+  summary: Manages access control for Google Cloud Platform resources.
+  overview: |-
+    # Google Identity and Access Management (IAM) API
+
+    Documentation of the access control API that will be implemented by all
+    1st party services provided by the Google Cloud Platform (like Cloud
+    Storage, Compute Engine, App Engine).
+
+    Any implementation of an API that offers access control features
+    will implement the google.iam.v1.IAMPolicy interface.
+
+    ## Data model
+
+    Access control is applied when a principal (user or service account),
+    takes some action on a resource exposed by a service. Resources,
+    identified by
+    URI-like names, are the unit of access control specification. It is up to
+    the service implementations to choose what granularity of access control
+    to support and what set of actions (permissions) to support for the
+    resources
+    they provide. For example one database service may allow access control to
+    be specified only at the Table level, whereas another might allow access
+    control to also be specified at the Column level.
+
+    This is intentionally not a CRUD style API because access control policies
+    are created and deleted implicitly with the resources to which they are
+    attached.
+
+    ## Policy
+
+    A `Policy` consists of a list of bindings. A `Binding` binds a set of
+    members to a role, where the members can include user accounts, user
+    groups, user
+    domains, and service accounts. A role is a named set of permissions,
+    defined by the IAM system. The definition of a role is outside the
+    policy.
+
+    A permission check involves determining the roles that include the
+    specified permission, and then determining if the principal specified by
+    the check is a member of a binding to at least one of these roles. The
+    membership check is recursive when a group is bound to a role.
+  rules:
+  - selector: google.iam.v1.IAMPolicy.GetIamPolicy
+    description: |-
+      Gets the access control policy for a resource. Returns an empty policy
+      if the resource exists and does not have a policy set.
+
+  - selector: google.iam.v1.IAMPolicy.SetIamPolicy
+    description: |-
+      Sets the access control policy on the specified resource. Replaces
+      any existing policy.
+
+  - selector: google.iam.v1.IAMPolicy.TestIamPermissions
+    description: |-
+      Returns permissions that a caller has on the specified resource. If the
+      resource does not exist, this will return an empty set of
+      permissions, not a NOT_FOUND error.
+
+      Note: This operation is designed to be used for building
+      permission-aware UIs and command-line tools, not for authorization
+      checking. This operation may "fail open" without warning.
+
+http:
+  rules:
+  - selector: google.iam.v1.IAMPolicy.GetIamPolicy
+    post: '/v1/{resource=**}:getIamPolicy'
+    body: '*'
+  - selector: google.iam.v1.IAMPolicy.SetIamPolicy
+    post: '/v1/{resource=**}:setIamPolicy'
+    body: '*'
+  - selector: google.iam.v1.IAMPolicy.TestIamPermissions
+    post: '/v1/{resource=**}:testIamPermissions'
+    body: '*'
diff --git a/third_party/googleapis/google/iam/v1/iam_meta_api_gapic.yaml b/third_party/googleapis/google/iam/v1/iam_meta_api_gapic.legacy.yaml
similarity index 100%
rename from third_party/googleapis/google/iam/v1/iam_meta_api_gapic.yaml
rename to third_party/googleapis/google/iam/v1/iam_meta_api_gapic.legacy.yaml
diff --git a/third_party/googleapis/google/iam/v1/iam_policy.proto b/third_party/googleapis/google/iam/v1/iam_policy.proto
index 7fee0c39b..7072854e4 100644
--- a/third_party/googleapis/google/iam/v1/iam_policy.proto
+++ b/third_party/googleapis/google/iam/v1/iam_policy.proto
@@ -21,6 +21,8 @@ import "google/iam/v1/options.proto";
 import "google/iam/v1/policy.proto";
 import "google/api/annotations.proto";
 import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 
 option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.Iam.V1";
@@ -96,20 +98,24 @@ service IAMPolicy {
 message SetIamPolicyRequest {
   // REQUIRED: The resource for which the policy is being specified.
   // See the operation documentation for the appropriate value for this field.
-  string resource = 1;
+  string resource = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference).type = "*"];
 
   // REQUIRED: The complete policy to be applied to the `resource`. The size of
   // the policy is limited to a few 10s of KB. An empty policy is a
   // valid policy but certain Cloud Platform services (such as Projects)
   // might reject them.
-  Policy policy = 2;
+  Policy policy = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request message for `GetIamPolicy` method.
 message GetIamPolicyRequest {
   // REQUIRED: The resource for which the policy is being requested.
   // See the operation documentation for the appropriate value for this field.
-  string resource = 1;
+  string resource = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference).type = "*"];
 
   // OPTIONAL: A `GetPolicyOptions` object for specifying options to
   // `GetIamPolicy`. This field is only used by Cloud IAM.
@@ -120,13 +126,15 @@ message GetIamPolicyRequest {
 message TestIamPermissionsRequest {
   // REQUIRED: The resource for which the policy detail is being requested.
   // See the operation documentation for the appropriate value for this field.
-  string resource = 1;
+  string resource = 1[
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference).type = "*"];
 
   // The set of permissions to check for the `resource`. Permissions with
   // wildcards (such as '*' or 'storage.*') are not allowed. For more
   // information see
   // [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
-  repeated string permissions = 2;
+  repeated string permissions = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response message for `TestIamPermissions` method.
diff --git a/third_party/googleapis/google/iam/v1/logging/BUILD.bazel b/third_party/googleapis/google/iam/v1/logging/BUILD.bazel
index 0824cdbdf..cf95b5c37 100644
--- a/third_party/googleapis/google/iam/v1/logging/BUILD.bazel
+++ b/third_party/googleapis/google/iam/v1/logging/BUILD.bazel
@@ -1,3 +1,5 @@
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
@@ -37,8 +39,8 @@ java_proto_library(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "go_proto_library",
     "go_gapic_assembly_pkg",
+    "go_proto_library",
 )
 
 go_proto_library(
diff --git a/third_party/googleapis/google/iam/v1/options.proto b/third_party/googleapis/google/iam/v1/options.proto
index 24e886366..a4e17e588 100644
--- a/third_party/googleapis/google/iam/v1/options.proto
+++ b/third_party/googleapis/google/iam/v1/options.proto
@@ -30,8 +30,12 @@ option php_namespace = "Google\\Cloud\\Iam\\V1";
 // Encapsulates settings provided to GetIamPolicy.
 message GetPolicyOptions {
   // Optional. The policy format version to be returned.
-  // Acceptable values are 0 and 1.
-  // If the value is 0, or the field is omitted, policy format version 1 will be
-  // returned.
+  //
+  // Valid values are 0, 1, and 3. Requests specifying an invalid value will be
+  // rejected.
+  //
+  // Requests for policies with any conditional bindings must specify version 3.
+  // Policies without any conditional bindings may specify any valid value or
+  // leave the field unset.
   int32 requested_policy_version = 1;
 }
diff --git a/third_party/googleapis/google/iam/v1/policy.proto b/third_party/googleapis/google/iam/v1/policy.proto
index e0d2e331f..e3aba47e8 100644
--- a/third_party/googleapis/google/iam/v1/policy.proto
+++ b/third_party/googleapis/google/iam/v1/policy.proto
@@ -32,27 +32,36 @@ option php_namespace = "Google\\Cloud\\Iam\\V1";
 // specify access control policies for Cloud Platform resources.
 //
 //
-// A `Policy` consists of a list of `bindings`. A `binding` binds a list of
-// `members` to a `role`, where the members can be user accounts, Google groups,
-// Google domains, and service accounts. A `role` is a named list of permissions
-// defined by IAM.
+// A `Policy` is a collection of `bindings`. A `binding` binds one or more
+// `members` to a single `role`. Members can be user accounts, service accounts,
+// Google groups, and domains (such as G Suite). A `role` is a named list of
+// permissions (defined by IAM or configured by users). A `binding` can
+// optionally specify a `condition`, which is a logic expression that further
+// constrains the role binding based on attributes about the request and/or
+// target resource.
 //
 // **JSON Example**
 //
 //     {
 //       "bindings": [
 //         {
-//           "role": "roles/owner",
+//           "role": "roles/resourcemanager.organizationAdmin",
 //           "members": [
 //             "user:mike@example.com",
 //             "group:admins@example.com",
 //             "domain:google.com",
-//             "serviceAccount:my-other-app@appspot.gserviceaccount.com"
+//             "serviceAccount:my-project-id@appspot.gserviceaccount.com"
 //           ]
 //         },
 //         {
-//           "role": "roles/viewer",
-//           "members": ["user:sean@example.com"]
+//           "role": "roles/resourcemanager.organizationViewer",
+//           "members": ["user:eve@example.com"],
+//           "condition": {
+//             "title": "expirable access",
+//             "description": "Does not grant access after Sep 2020",
+//             "expression": "request.time <
+//             timestamp('2020-10-01T00:00:00.000Z')",
+//           }
 //         }
 //       ]
 //     }
@@ -64,20 +73,37 @@ option php_namespace = "Google\\Cloud\\Iam\\V1";
 //       - user:mike@example.com
 //       - group:admins@example.com
 //       - domain:google.com
-//       - serviceAccount:my-other-app@appspot.gserviceaccount.com
-//       role: roles/owner
+//       - serviceAccount:my-project-id@appspot.gserviceaccount.com
+//       role: roles/resourcemanager.organizationAdmin
 //     - members:
-//       - user:sean@example.com
-//       role: roles/viewer
-//
+//       - user:eve@example.com
+//       role: roles/resourcemanager.organizationViewer
+//       condition:
+//         title: expirable access
+//         description: Does not grant access after Sep 2020
+//         expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
 //
 // For a description of IAM and its features, see the
 // [IAM developer's guide](https://cloud.google.com/iam/docs).
 message Policy {
-  // Deprecated.
+  // Specifies the format of the policy.
+  //
+  // Valid values are 0, 1, and 3. Requests specifying an invalid value will be
+  // rejected.
+  //
+  // Operations affecting conditional bindings must specify version 3. This can
+  // be either setting a conditional policy, modifying a conditional binding,
+  // or removing a binding (conditional or unconditional) from the stored
+  // conditional policy.
+  // Operations on non-conditional policies may specify any valid value or
+  // leave the field unset.
+  //
+  // If no etag is provided in the call to `setIamPolicy`, version compliance
+  // checks against the stored policy is skipped.
   int32 version = 1;
 
-  // Associates a list of `members` to a `role`.
+  // Associates a list of `members` to a `role`. Optionally may specify a
+  // `condition` that determines when binding is in effect.
   // `bindings` with no members will result in an error.
   repeated Binding bindings = 4;
 
@@ -90,7 +116,9 @@ message Policy {
   // ensure that their change will be applied to the same version of the policy.
   //
   // If no `etag` is provided in the call to `setIamPolicy`, then the existing
-  // policy is overwritten blindly.
+  // policy is overwritten. Due to blind-set semantics of an etag-less policy,
+  // 'setIamPolicy' will not fail even if the incoming policy version does not
+  // meet the requirements for modifying the stored policy.
   bytes etag = 3;
 }
 
@@ -110,7 +138,7 @@ message Binding {
   //    who is authenticated with a Google account or a service account.
   //
   // * `user:{emailid}`: An email address that represents a specific Google
-  //    account. For example, `alice@gmail.com` .
+  //    account. For example, `alice@example.com` .
   //
   //
   // * `serviceAccount:{emailid}`: An email address that represents a service
@@ -171,8 +199,7 @@ message BindingDelta {
   // Required
   string member = 3;
 
-  // Unimplemented. The condition that is associated with this binding.
-  // This field is logged only for Cloud Audit Logging.
+  // The condition that is associated with this binding.
   google.type.Expr condition = 4;
 }
 
diff --git a/third_party/googleapis/google/identity/accesscontextmanager/type/BUILD.bazel b/third_party/googleapis/google/identity/accesscontextmanager/type/BUILD.bazel
new file mode 100644
index 000000000..51d7bc6f9
--- /dev/null
+++ b/third_party/googleapis/google/identity/accesscontextmanager/type/BUILD.bazel
@@ -0,0 +1,173 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
+proto_library(
+    name = "type_proto",
+    srcs = [
+        "device_resources.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_grpc_library",
+    "java_proto_library",
+    "java_gapic_assembly_gradle_pkg",
+)
+
+java_proto_library(
+    name = "type_java_proto",
+    deps = [":type_proto"],
+)
+
+java_grpc_library(
+    name = "type_java_grpc",
+    srcs = [":type_proto"],
+    deps = [":type_java_proto"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-accesscontextmanager-type-java",
+    deps = [
+        ":type_java_grpc",
+        ":type_java_proto",
+        ":type_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_proto_library",
+)
+
+go_proto_library(
+    name = "type_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/identity/accesscontextmanager/type",
+    protos = [":type_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "type_moved_proto",
+    srcs = [":type_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+    ],
+)
+
+py_proto_library(
+    name = "type_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":type_moved_proto"],
+)
+
+py_grpc_library(
+    name = "type_py_grpc",
+    srcs = [":type_moved_proto"],
+    deps = [":type_py_proto"],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "type_php_proto",
+    deps = [":type_proto"],
+)
+
+php_grpc_library(
+    name = "type_php_grpc",
+    srcs = [":type_proto"],
+    deps = [":type_php_proto"],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "type_ruby_proto",
+    deps = [":type_proto"],
+)
+
+ruby_grpc_library(
+    name = "type_ruby_grpc",
+    srcs = [":type_proto"],
+    deps = [":type_ruby_proto"],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "type_csharp_proto",
+    deps = [":type_proto"],
+)
+
+csharp_grpc_library(
+    name = "type_csharp_grpc",
+    srcs = [":type_proto"],
+    deps = [":type_csharp_proto"],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ code here
diff --git a/third_party/googleapis/google/identity/accesscontextmanager/type/device_resources.proto b/third_party/googleapis/google/identity/accesscontextmanager/type/device_resources.proto
new file mode 100644
index 000000000..f05791033
--- /dev/null
+++ b/third_party/googleapis/google/identity/accesscontextmanager/type/device_resources.proto
@@ -0,0 +1,85 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.identity.accesscontextmanager.type;
+
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Identity.AccessContextManager.Type";
+option go_package = "google.golang.org/genproto/googleapis/identity/accesscontextmanager/type;type";
+option java_package = "com.google.identity.accesscontextmanager.type";
+option java_multiple_files = true;
+option java_outer_classname = "TypeProto";
+option php_namespace = "Google\\Identity\\AccessContextManager\\Type";
+option ruby_package = "Google::Identity::AccessContextManager::Type";
+
+// The encryption state of the device.
+enum DeviceEncryptionStatus {
+  // The encryption status of the device is not specified or not known.
+  ENCRYPTION_UNSPECIFIED = 0;
+
+  // The device does not support encryption.
+  ENCRYPTION_UNSUPPORTED = 1;
+
+  // The device supports encryption, but is currently unencrypted.
+  UNENCRYPTED = 2;
+
+  // The device is encrypted.
+  ENCRYPTED = 3;
+}
+
+// The operating system type of the device.
+// Next id: 7
+enum OsType {
+  // The operating system of the device is not specified or not known.
+  OS_UNSPECIFIED = 0;
+
+  // A desktop Mac operating system.
+  DESKTOP_MAC = 1;
+
+  // A desktop Windows operating system.
+  DESKTOP_WINDOWS = 2;
+
+  // A desktop Linux operating system.
+  DESKTOP_LINUX = 3;
+
+  // A desktop ChromeOS operating system.
+  DESKTOP_CHROME_OS = 6;
+
+  // An Android operating system.
+  ANDROID = 4;
+
+  // An iOS operating system.
+  IOS = 5;
+}
+
+// The degree to which the device is managed by the Cloud organization.
+enum DeviceManagementLevel {
+  // The device's management level is not specified or not known.
+  MANAGEMENT_UNSPECIFIED = 0;
+
+  // The device is not managed.
+  NONE = 1;
+
+  // Basic management is enabled, which is generally limited to monitoring and
+  // wiping the corporate account.
+  BASIC = 2;
+
+  // Complete device management. This includes more thorough monitoring and the
+  // ability to directly manage the device (such as remote wiping). This can be
+  // enabled through the Android Enterprise Platform.
+  COMPLETE = 3;
+}
diff --git a/third_party/googleapis/google/identity/accesscontextmanager/v1/BUILD.bazel b/third_party/googleapis/google/identity/accesscontextmanager/v1/BUILD.bazel
new file mode 100644
index 000000000..b4feecca9
--- /dev/null
+++ b/third_party/googleapis/google/identity/accesscontextmanager/v1/BUILD.bazel
@@ -0,0 +1,182 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
+proto_library(
+    name = "accesscontextmanager_proto",
+    srcs = [
+        "access_level.proto",
+        "access_policy.proto",
+        "service_perimeter.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/identity/accesscontextmanager/type:type_proto",
+        "//google/type:expr_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_grpc_library",
+    "java_proto_library",
+    "java_gapic_assembly_gradle_pkg",
+)
+
+java_proto_library(
+    name = "accesscontextmanager_java_proto",
+    deps = [":accesscontextmanager_proto"],
+)
+
+java_grpc_library(
+    name = "accesscontextmanager_java_grpc",
+    srcs = [":accesscontextmanager_proto"],
+    deps = [":accesscontextmanager_java_proto"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-accesscontextmanager-v1-java",
+    deps = [
+        ":accesscontextmanager_java_grpc",
+        ":accesscontextmanager_java_proto",
+        ":accesscontextmanager_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_proto_library",
+)
+
+go_proto_library(
+    name = "accesscontextmanager_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/identity/accesscontextmanager/v1",
+    protos = [":accesscontextmanager_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/identity/accesscontextmanager/type:type_go_proto",
+        "//google/type:expr_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "accesscontextmanager_moved_proto",
+    srcs = [":accesscontextmanager_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/identity/accesscontextmanager/type:type_proto",
+        "//google/type:expr_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "accesscontextmanager_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":accesscontextmanager_moved_proto"],
+)
+
+py_grpc_library(
+    name = "accesscontextmanager_py_grpc",
+    srcs = [":accesscontextmanager_moved_proto"],
+    deps = [":accesscontextmanager_py_proto"],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "accesscontextmanager_php_proto",
+    deps = [":accesscontextmanager_proto"],
+)
+
+php_grpc_library(
+    name = "accesscontextmanager_php_grpc",
+    srcs = [":accesscontextmanager_proto"],
+    deps = [":accesscontextmanager_php_proto"],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "accesscontextmanager_ruby_proto",
+    deps = [":accesscontextmanager_proto"],
+)
+
+ruby_grpc_library(
+    name = "accesscontextmanager_ruby_grpc",
+    srcs = [":accesscontextmanager_proto"],
+    deps = [":accesscontextmanager_ruby_proto"],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "accesscontextmanager_csharp_proto",
+    deps = [":accesscontextmanager_proto"],
+)
+
+csharp_grpc_library(
+    name = "accesscontextmanager_csharp_grpc",
+    srcs = [":accesscontextmanager_proto"],
+    deps = [":accesscontextmanager_csharp_proto"],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ code here
diff --git a/third_party/googleapis/google/identity/accesscontextmanager/v1/access_level.proto b/third_party/googleapis/google/identity/accesscontextmanager/v1/access_level.proto
new file mode 100644
index 000000000..0ebd1936c
--- /dev/null
+++ b/third_party/googleapis/google/identity/accesscontextmanager/v1/access_level.proto
@@ -0,0 +1,187 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.identity.accesscontextmanager.v1;
+
+import "google/identity/accesscontextmanager/type/device_resources.proto";
+import "google/protobuf/timestamp.proto";
+import "google/type/expr.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Identity.AccessContextManager.V1";
+option go_package = "google.golang.org/genproto/googleapis/identity/accesscontextmanager/v1;accesscontextmanager";
+option java_multiple_files = true;
+option java_outer_classname = "AccessLevelProto";
+option java_package = "com.google.identity.accesscontextmanager.v1";
+option php_namespace = "Google\\Identity\\AccessContextManager\\V1";
+option ruby_package = "Google::Identity::AccessContextManager::V1";
+option objc_class_prefix = "GACM";
+
+// An `AccessLevel` is a label that can be applied to requests to Google Cloud
+// services, along with a list of requirements necessary for the label to be
+// applied.
+message AccessLevel {
+  // Required. Resource name for the Access Level. The `short_name` component
+  // must begin with a letter and only include alphanumeric and '_'. Format:
+  // `accessPolicies/{policy_id}/accessLevels/{short_name}`. The maximum length
+  // of the `short_name` component is 50 characters.
+  string name = 1;
+
+  // Human readable title. Must be unique within the Policy.
+  string title = 2;
+
+  // Description of the `AccessLevel` and its use. Does not affect behavior.
+  string description = 3;
+
+  // Required. Describes the necessary conditions for the level to apply.
+  oneof level {
+    // A `BasicLevel` composed of `Conditions`.
+    BasicLevel basic = 4;
+
+    // A `CustomLevel` written in the Common Expression Language.
+    CustomLevel custom = 5;
+  }
+
+  // Output only. Time the `AccessLevel` was created in UTC.
+  google.protobuf.Timestamp create_time = 6;
+
+  // Output only. Time the `AccessLevel` was updated in UTC.
+  google.protobuf.Timestamp update_time = 7;
+}
+
+// `BasicLevel` is an `AccessLevel` using a set of recommended features.
+message BasicLevel {
+  // Options for how the `conditions` list should be combined to determine if
+  // this `AccessLevel` is applied. Default is AND.
+  enum ConditionCombiningFunction {
+    // All `Conditions` must be true for the `BasicLevel` to be true.
+    AND = 0;
+
+    // If at least one `Condition` is true, then the `BasicLevel` is true.
+    OR = 1;
+  }
+
+  // Required. A list of requirements for the `AccessLevel` to be granted.
+  repeated Condition conditions = 1;
+
+  // How the `conditions` list should be combined to determine if a request is
+  // granted this `AccessLevel`. If AND is used, each `Condition` in
+  // `conditions` must be satisfied for the `AccessLevel` to be applied. If OR
+  // is used, at least one `Condition` in `conditions` must be satisfied for the
+  // `AccessLevel` to be applied. Default behavior is AND.
+  ConditionCombiningFunction combining_function = 2;
+}
+
+// A condition necessary for an `AccessLevel` to be granted. The Condition is an
+// AND over its fields. So a Condition is true if: 1) the request IP is from one
+// of the listed subnetworks AND 2) the originating device complies with the
+// listed device policy AND 3) all listed access levels are granted AND 4) the
+// request was sent at a time allowed by the DateTimeRestriction.
+message Condition {
+  // CIDR block IP subnetwork specification. May be IPv4 or IPv6. Note that for
+  // a CIDR IP address block, the specified IP address portion must be properly
+  // truncated (i.e. all the host bits must be zero) or the input is considered
+  // malformed. For example, "192.0.2.0/24" is accepted but "192.0.2.1/24" is
+  // not. Similarly, for IPv6, "2001:db8::/32" is accepted whereas
+  // "2001:db8::1/32" is not. The originating IP of a request must be in one of
+  // the listed subnets in order for this Condition to be true. If empty, all IP
+  // addresses are allowed.
+  repeated string ip_subnetworks = 1;
+
+  // Device specific restrictions, all restrictions must hold for the
+  // Condition to be true. If not specified, all devices are allowed.
+  DevicePolicy device_policy = 2;
+
+  // A list of other access levels defined in the same `Policy`, referenced by
+  // resource name. Referencing an `AccessLevel` which does not exist is an
+  // error. All access levels listed must be granted for the Condition
+  // to be true. Example:
+  // "`accessPolicies/MY_POLICY/accessLevels/LEVEL_NAME"`
+  repeated string required_access_levels = 3;
+
+  // Whether to negate the Condition. If true, the Condition becomes a NAND over
+  // its non-empty fields, each field must be false for the Condition overall to
+  // be satisfied. Defaults to false.
+  bool negate = 5;
+
+  // The request must be made by one of the provided user or service
+  // accounts. Groups are not supported.
+  // Syntax:
+  // `user:{emailid}`
+  // `serviceAccount:{emailid}`
+  // If not specified, a request may come from any user.
+  repeated string members = 6;
+
+  // The request must originate from one of the provided countries/regions.
+  // Must be valid ISO 3166-1 alpha-2 codes.
+  repeated string regions = 7;
+}
+
+// `CustomLevel` is an `AccessLevel` using the Cloud Common Expression Language
+// to represent the necessary conditions for the level to apply to a request.
+// See CEL spec at: https://github.com/google/cel-spec
+message CustomLevel {
+  // Required. A Cloud CEL expression evaluating to a boolean.
+  google.type.Expr expr = 1;
+}
+
+// `DevicePolicy` specifies device specific restrictions necessary to acquire a
+// given access level. A `DevicePolicy` specifies requirements for requests from
+// devices to be granted access levels, it does not do any enforcement on the
+// device. `DevicePolicy` acts as an AND over all specified fields, and each
+// repeated field is an OR over its elements. Any unset fields are ignored. For
+// example, if the proto is { os_type : DESKTOP_WINDOWS, os_type :
+// DESKTOP_LINUX, encryption_status: ENCRYPTED}, then the DevicePolicy will be
+// true for requests originating from encrypted Linux desktops and encrypted
+// Windows desktops.
+message DevicePolicy {
+  // Whether or not screenlock is required for the DevicePolicy to be true.
+  // Defaults to `false`.
+  bool require_screenlock = 1;
+
+  // Allowed encryptions statuses, an empty list allows all statuses.
+  repeated google.identity.accesscontextmanager.type.DeviceEncryptionStatus allowed_encryption_statuses = 2;
+
+  // Allowed OS versions, an empty list allows all types and all versions.
+  repeated OsConstraint os_constraints = 3;
+
+  // Allowed device management levels, an empty list allows all management
+  // levels.
+  repeated google.identity.accesscontextmanager.type.DeviceManagementLevel allowed_device_management_levels = 6;
+
+  // Whether the device needs to be approved by the customer admin.
+  bool require_admin_approval = 7;
+
+  // Whether the device needs to be corp owned.
+  bool require_corp_owned = 8;
+}
+
+// A restriction on the OS type and version of devices making requests.
+message OsConstraint {
+  // Required. The allowed OS type.
+  google.identity.accesscontextmanager.type.OsType os_type = 1;
+
+  // The minimum allowed OS version. If not set, any version of this OS
+  // satisfies the constraint. Format: `"major.minor.patch"`.
+  // Examples: `"10.5.301"`, `"9.2.1"`.
+  string minimum_version = 2;
+
+  // Only allows requests from devices with a verified Chrome OS.
+  // Verifications includes requirements that the device is enterprise-managed,
+  // conformant to domain policies, and the caller has permission to call
+  // the API targeted by the request.
+  bool require_verified_chrome_os = 3;
+}
diff --git a/third_party/googleapis/google/identity/accesscontextmanager/v1/access_policy.proto b/third_party/googleapis/google/identity/accesscontextmanager/v1/access_policy.proto
new file mode 100644
index 000000000..9ec59d1c1
--- /dev/null
+++ b/third_party/googleapis/google/identity/accesscontextmanager/v1/access_policy.proto
@@ -0,0 +1,60 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.identity.accesscontextmanager.v1;
+
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Identity.AccessContextManager.V1";
+option go_package = "google.golang.org/genproto/googleapis/identity/accesscontextmanager/v1;accesscontextmanager";
+option java_multiple_files = true;
+option java_outer_classname = "PolicyProto";
+option java_package = "com.google.identity.accesscontextmanager.v1";
+option php_namespace = "Google\\Identity\\AccessContextManager\\V1";
+option ruby_package = "Google::Identity::AccessContextManager::V1";
+option objc_class_prefix = "GACM";
+
+// `AccessPolicy` is a container for `AccessLevels` (which define the necessary
+// attributes to use Google Cloud services) and `ServicePerimeters` (which
+// define regions of services able to freely pass data within a perimeter). An
+// access policy is globally visible within an organization, and the
+// restrictions it specifies apply to all projects within an organization.
+message AccessPolicy {
+  // Output only. Resource name of the `AccessPolicy`. Format:
+  // `accessPolicies/{policy_id}`
+  string name = 1;
+
+  // Required. The parent of this `AccessPolicy` in the Cloud Resource
+  // Hierarchy. Currently immutable once created. Format:
+  // `organizations/{organization_id}`
+  string parent = 2;
+
+  // Required. Human readable title. Does not affect behavior.
+  string title = 3;
+
+  // Output only. Time the `AccessPolicy` was created in UTC.
+  google.protobuf.Timestamp create_time = 4;
+
+  // Output only. Time the `AccessPolicy` was updated in UTC.
+  google.protobuf.Timestamp update_time = 5;
+
+  // Output only. An opaque identifier for the current version of the
+  // `AccessPolicy`. This will always be a strongly validated etag, meaning that
+  // two Access Polices will be identical if and only if their etags are
+  // identical. Clients should not expect this to be in any specific format.
+  string etag = 6;
+}
diff --git a/third_party/googleapis/google/identity/accesscontextmanager/v1/service_perimeter.proto b/third_party/googleapis/google/identity/accesscontextmanager/v1/service_perimeter.proto
new file mode 100644
index 000000000..89d76818d
--- /dev/null
+++ b/third_party/googleapis/google/identity/accesscontextmanager/v1/service_perimeter.proto
@@ -0,0 +1,152 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.identity.accesscontextmanager.v1;
+
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Identity.AccessContextManager.V1";
+option go_package = "google.golang.org/genproto/googleapis/identity/accesscontextmanager/v1;accesscontextmanager";
+option java_multiple_files = true;
+option java_outer_classname = "ServicePerimeterProto";
+option java_package = "com.google.identity.accesscontextmanager.v1";
+option php_namespace = "Google\\Identity\\AccessContextManager\\V1";
+option ruby_package = "Google::Identity::AccessContextManager::V1";
+option objc_class_prefix = "GACM";
+
+// `ServicePerimeter` describes a set of Google Cloud resources which can freely
+// import and export data amongst themselves, but not export outside of the
+// `ServicePerimeter`. If a request with a source within this `ServicePerimeter`
+// has a target outside of the `ServicePerimeter`, the request will be blocked.
+// Otherwise the request is allowed. There are two types of Service Perimeter -
+// Regular and Bridge. Regular Service Perimeters cannot overlap, a single
+// Google Cloud project can only belong to a single regular Service Perimeter.
+// Service Perimeter Bridges can contain only Google Cloud projects as members,
+// a single Google Cloud project may belong to multiple Service Perimeter
+// Bridges.
+message ServicePerimeter {
+  // Specifies the type of the Perimeter. There are two types: regular and
+  // bridge. Regular Service Perimeter contains resources, access levels, and
+  // restricted services. Every resource can be in at most ONE
+  // regular Service Perimeter.
+  //
+  // In addition to being in a regular service perimeter, a resource can also
+  // be in zero or more perimeter bridges.  A perimeter bridge only contains
+  // resources.  Cross project operations are permitted if all effected
+  // resources share some perimeter (whether bridge or regular). Perimeter
+  // Bridge does not contain access levels or services: those are governed
+  // entirely by the regular perimeter that resource is in.
+  //
+  // Perimeter Bridges are typically useful when building more complex toplogies
+  // with many independent perimeters that need to share some data with a common
+  // perimeter, but should not be able to share data among themselves.
+  enum PerimeterType {
+    // Regular Perimeter.
+    PERIMETER_TYPE_REGULAR = 0;
+
+    // Perimeter Bridge.
+    PERIMETER_TYPE_BRIDGE = 1;
+  }
+
+  // Required. Resource name for the ServicePerimeter.  The `short_name`
+  // component must begin with a letter and only include alphanumeric and '_'.
+  // Format: `accessPolicies/{policy_id}/servicePerimeters/{short_name}`
+  string name = 1;
+
+  // Human readable title. Must be unique within the Policy.
+  string title = 2;
+
+  // Description of the `ServicePerimeter` and its use. Does not affect
+  // behavior.
+  string description = 3;
+
+  // Output only. Time the `ServicePerimeter` was created in UTC.
+  google.protobuf.Timestamp create_time = 4;
+
+  // Output only. Time the `ServicePerimeter` was updated in UTC.
+  google.protobuf.Timestamp update_time = 5;
+
+  // Perimeter type indicator. A single project is
+  // allowed to be a member of single regular perimeter, but multiple service
+  // perimeter bridges. A project cannot be a included in a perimeter bridge
+  // without being included in regular perimeter. For perimeter bridges,
+  // the restricted service list as well as access level lists must be
+  // empty.
+  PerimeterType perimeter_type = 6;
+
+  // Current ServicePerimeter configuration. Specifies sets of resources,
+  // restricted services and access levels that determine perimeter
+  // content and boundaries.
+  ServicePerimeterConfig status = 7;
+
+  // Proposed (or dry run) ServicePerimeter configuration. This configuration
+  // allows to specify and test ServicePerimeter configuration without enforcing
+  // actual access restrictions. Only allowed to be set when the
+  // "use_explicit_dry_run_spec" flag is set.
+  ServicePerimeterConfig spec = 8;
+
+  // Use explicit dry run spec flag. Ordinarily, a dry-run spec implicitly
+  // exists  for all Service Perimeters, and that spec is identical to the
+  // status for those Service Perimeters. When this flag is set, it inhibits the
+  // generation of the implicit spec, thereby allowing the user to explicitly
+  // provide a configuration ("spec") to use in a dry-run version of the Service
+  // Perimeter. This allows the user to test changes to the enforced config
+  // ("status") without actually enforcing them. This testing is done through
+  // analyzing the differences between currently enforced and suggested
+  // restrictions. use_explicit_dry_run_spec must bet set to True if any of the
+  // fields in the spec are set to non-default values.
+  bool use_explicit_dry_run_spec = 9;
+}
+
+// `ServicePerimeterConfig` specifies a set of Google Cloud resources that
+// describe specific Service Perimeter configuration.
+message ServicePerimeterConfig {
+  // Specifies how APIs are allowed to communicate within the Service
+  // Perimeter.
+  message VpcAccessibleServices {
+    // Whether to restrict API calls within the Service Perimeter to the list of
+    // APIs specified in 'allowed_services'.
+    bool enable_restriction = 1;
+
+    // The list of APIs usable within the Service Perimeter. Must be empty
+    // unless 'enable_restriction' is True.
+    repeated string allowed_services = 2;
+  }
+
+  // A list of Google Cloud resources that are inside of the service perimeter.
+  // Currently only projects are allowed. Format: `projects/{project_number}`
+  repeated string resources = 1;
+
+  // A list of `AccessLevel` resource names that allow resources within the
+  // `ServicePerimeter` to be accessed from the internet. `AccessLevels` listed
+  // must be in the same policy as this `ServicePerimeter`. Referencing a
+  // nonexistent `AccessLevel` is a syntax error. If no `AccessLevel` names are
+  // listed, resources within the perimeter can only be accessed via Google
+  // Cloud calls with request origins within the perimeter. Example:
+  // `"accessPolicies/MY_POLICY/accessLevels/MY_LEVEL"`.
+  // For Service Perimeter Bridge, must be empty.
+  repeated string access_levels = 2;
+
+  // Google Cloud services that are subject to the Service Perimeter
+  // restrictions. For example, if `storage.googleapis.com` is specified, access
+  // to the storage buckets inside the perimeter must meet the perimeter's
+  // access restrictions.
+  repeated string restricted_services = 4;
+
+  // Configuration for APIs allowed within Perimeter.
+  VpcAccessibleServices vpc_accessible_services = 10;
+}
diff --git a/third_party/googleapis/google/logging/BUILD.bazel b/third_party/googleapis/google/logging/BUILD.bazel
index 1e5b8c2af..a87c57fec 100644
--- a/third_party/googleapis/google/logging/BUILD.bazel
+++ b/third_party/googleapis/google/logging/BUILD.bazel
@@ -1 +1 @@
-exports_files(glob(["*.yaml"]))
\ No newline at end of file
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/logging/artman_logging.yaml b/third_party/googleapis/google/logging/artman_logging.yaml
index d99387d32..78a26ab37 100644
--- a/third_party/googleapis/google/logging/artman_logging.yaml
+++ b/third_party/googleapis/google/logging/artman_logging.yaml
@@ -3,11 +3,13 @@ common:
   api_version: v2
   organization_name: google-cloud
   proto_deps:
-    - name: google-common-protos
+  - name: google-common-protos
   src_proto_paths:
+  - type
   - v2
-  service_yaml: logging.yaml
+  service_yaml: v2/logging.yaml
   gapic_yaml: v2/logging_gapic.yaml
+  proto_package: google.logging.v2
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
@@ -29,6 +31,3 @@ artifacts:
 - name: ruby_gapic
   type: GAPIC
   language: RUBY
-- name: csharp_gapic
-  type: GAPIC
-  language: CSHARP
diff --git a/third_party/googleapis/google/logging/logging.yaml b/third_party/googleapis/google/logging/logging.yaml
deleted file mode 100644
index d84a57a80..000000000
--- a/third_party/googleapis/google/logging/logging.yaml
+++ /dev/null
@@ -1,100 +0,0 @@
-type: google.api.Service
-config_version: 3
-name: logging.googleapis.com
-title: Stackdriver Logging API
-
-apis:
-- name: google.logging.v2.LoggingServiceV2
-- name: google.logging.v2.ConfigServiceV2
-- name: google.logging.v2.MetricsServiceV2
-
-documentation:
-  summary: Writes log entries and manages your Logging configuration.
-  overview: |-
-    # Introduction
-
-    The Stackdriver Logging service.
-
-backend:
-  rules:
-  - selector: google.logging.v2.LoggingServiceV2.DeleteLog
-    deadline: 60.0
-  - selector: google.logging.v2.LoggingServiceV2.WriteLogEntries
-    deadline: 60.0
-  - selector: google.logging.v2.LoggingServiceV2.ListLogEntries
-    deadline: 10.0
-  - selector: google.logging.v2.LoggingServiceV2.ListMonitoredResourceDescriptors
-    deadline: 60.0
-  - selector: google.logging.v2.LoggingServiceV2.ListLogs
-    deadline: 60.0
-  - selector: google.logging.v2.ConfigServiceV2.ListSinks
-    deadline: 60.0
-  - selector: google.logging.v2.ConfigServiceV2.GetSink
-    deadline: 60.0
-  - selector: google.logging.v2.ConfigServiceV2.CreateSink
-    deadline: 120.0
-  - selector: google.logging.v2.ConfigServiceV2.UpdateSink
-    deadline: 120.0
-  - selector: google.logging.v2.ConfigServiceV2.DeleteSink
-    deadline: 60.0
-  - selector: google.logging.v2.ConfigServiceV2.ListExclusions
-    deadline: 60.0
-  - selector: google.logging.v2.ConfigServiceV2.GetExclusion
-    deadline: 60.0
-  - selector: google.logging.v2.ConfigServiceV2.CreateExclusion
-    deadline: 60.0
-  - selector: google.logging.v2.ConfigServiceV2.UpdateExclusion
-    deadline: 60.0
-  - selector: google.logging.v2.ConfigServiceV2.DeleteExclusion
-    deadline: 60.0
-  - selector: google.logging.v2.MetricsServiceV2.ListLogMetrics
-    deadline: 60.0
-  - selector: google.logging.v2.MetricsServiceV2.GetLogMetric
-    deadline: 60.0
-  - selector: google.logging.v2.MetricsServiceV2.CreateLogMetric
-    deadline: 60.0
-  - selector: google.logging.v2.MetricsServiceV2.UpdateLogMetric
-    deadline: 60.0
-  - selector: google.logging.v2.MetricsServiceV2.DeleteLogMetric
-    deadline: 60.0
-
-authentication:
-  rules:
-  - selector: '*'
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform,
-        https://www.googleapis.com/auth/cloud-platform.read-only,
-        https://www.googleapis.com/auth/logging.admin,
-        https://www.googleapis.com/auth/logging.read
-  - selector: |-
-      google.logging.v2.ConfigServiceV2.CreateExclusion,
-      google.logging.v2.ConfigServiceV2.CreateSink,
-      google.logging.v2.ConfigServiceV2.DeleteExclusion,
-      google.logging.v2.ConfigServiceV2.DeleteSink,
-      google.logging.v2.ConfigServiceV2.UpdateExclusion,
-      google.logging.v2.ConfigServiceV2.UpdateSink
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform,
-        https://www.googleapis.com/auth/logging.admin
-  - selector: |-
-      google.logging.v2.MetricsServiceV2.CreateLogMetric,
-      google.logging.v2.MetricsServiceV2.DeleteLogMetric,
-      google.logging.v2.MetricsServiceV2.UpdateLogMetric
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform,
-        https://www.googleapis.com/auth/logging.admin,
-        https://www.googleapis.com/auth/logging.write
-  - selector: google.logging.v2.LoggingServiceV2.DeleteLog
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform,
-        https://www.googleapis.com/auth/logging.admin
-  - selector: google.logging.v2.LoggingServiceV2.WriteLogEntries
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform,
-        https://www.googleapis.com/auth/logging.admin,
-        https://www.googleapis.com/auth/logging.write
diff --git a/third_party/googleapis/google/logging/type/BUILD.bazel b/third_party/googleapis/google/logging/type/BUILD.bazel
index 641e02392..9bfcc10cd 100644
--- a/third_party/googleapis/google/logging/type/BUILD.bazel
+++ b/third_party/googleapis/google/logging/type/BUILD.bazel
@@ -1,74 +1,165 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
-load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+load("@rules_proto//proto:defs.bzl", "proto_library")
 
 proto_library(
-    name = "http_request_proto",
-    srcs = ["http_request.proto"],
-    deps = [
-        "//google/api:annotations_proto",
-        "@com_google_protobuf//:duration_proto",
+    name = "type_proto",
+    srcs = [
+        "http_request.proto",
+        "log_severity.proto",
     ],
-)
-
-proto_library(
-    name = "log_severity_proto",
-    srcs = ["log_severity.proto"],
     deps = [
         "//google/api:annotations_proto",
         "@com_google_protobuf//:duration_proto",
     ],
 )
 
-proto_library_with_info(
-    name = "type_proto_with_info",
-    deps = [
-        ":http_request_proto",
-        ":log_severity_proto",
-    ],
-)
-
 ##############################################################################
 # Java
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
 )
 
 java_proto_library(
     name = "type_java_proto",
-    deps = [
-        ":http_request_proto",
-        ":log_severity_proto",
-    ],
+    deps = [":type_proto"],
 )
 
-java_resource_name_proto_library(
-    name = "type_resource_name_java_proto",
-    gapic_yaml = "//google/logging/v2:logging_gapic.yaml",
-    deps = [
-        ":http_request_proto",
-        ":log_severity_proto",
-    ],
+java_grpc_library(
+    name = "type_java_grpc",
+    srcs = [":type_proto"],
+    deps = [":type_java_proto"],
 )
 
 ##############################################################################
 # Go
 ##############################################################################
-load("@com_google_googleapis_imports//:imports.bzl", "go_proto_library")
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_proto_library",
+)
 
 go_proto_library(
-    name = "ltype_go_proto",
+    name = "type_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
     importpath = "google.golang.org/genproto/googleapis/logging/type",
-    protos = [
-        ":http_request_proto",
-        ":log_severity_proto",
+    protos = [":type_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
     ],
-    deps = ["//google/api:annotations_go_proto"],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "type_moved_proto",
+    srcs = [":type_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "@com_google_protobuf//:duration_proto",
+    ],
+)
+
+py_proto_library(
+    name = "type_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":type_moved_proto"],
+)
+
+py_grpc_library(
+    name = "type_py_grpc",
+    srcs = [":type_moved_proto"],
+    deps = [":type_py_proto"],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "type_php_proto",
+    deps = [":type_proto"],
+)
+
+php_grpc_library(
+    name = "type_php_grpc",
+    srcs = [":type_proto"],
+    deps = [":type_php_proto"],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "type_ruby_proto",
+    deps = [":type_proto"],
+)
+
+ruby_grpc_library(
+    name = "type_ruby_grpc",
+    srcs = [":type_proto"],
+    deps = [":type_ruby_proto"],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "type_csharp_proto",
+    deps = [":type_proto"],
+)
+
+csharp_grpc_library(
+    name = "type_csharp_grpc",
+    srcs = [":type_proto"],
+    deps = [":type_csharp_proto"],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ code here
diff --git a/third_party/googleapis/google/logging/type/http_request.proto b/third_party/googleapis/google/logging/type/http_request.proto
index 974fdf71f..f5002062f 100644
--- a/third_party/googleapis/google/logging/type/http_request.proto
+++ b/third_party/googleapis/google/logging/type/http_request.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,14 +11,13 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.logging.type;
 
-import "google/api/annotations.proto";
 import "google/protobuf/duration.proto";
+import "google/api/annotations.proto";
 
 option csharp_namespace = "Google.Cloud.Logging.Type";
 option go_package = "google.golang.org/genproto/googleapis/logging/type;ltype";
diff --git a/third_party/googleapis/google/logging/type/log_severity.proto b/third_party/googleapis/google/logging/type/log_severity.proto
index e6556dddc..108cd7c73 100644
--- a/third_party/googleapis/google/logging/type/log_severity.proto
+++ b/third_party/googleapis/google/logging/type/log_severity.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
diff --git a/third_party/googleapis/google/logging/v2/BUILD.bazel b/third_party/googleapis/google/logging/v2/BUILD.bazel
index 7a6ae416f..f972727d5 100644
--- a/third_party/googleapis/google/logging/v2/BUILD.bazel
+++ b/third_party/googleapis/google/logging/v2/BUILD.bazel
@@ -1,16 +1,14 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
-_PROTO_SUBPACKAGE_DEPS = [
-    "//google/logging/type:http_request_proto",
-    "//google/logging/type:log_severity_proto",
-]
-
 proto_library(
     name = "logging_proto",
     srcs = [
@@ -21,57 +19,43 @@ proto_library(
     ],
     deps = [
         "//google/api:annotations_proto",
-        "//google/api:monitored_resource_proto",
+        "//google/api:client_proto",
         "//google/api:distribution_proto",
+        "//google/api:field_behavior_proto",
         "//google/api:metric_proto",
+        "//google/api:monitored_resource_proto",
+        "//google/api:resource_proto",
+        "//google/logging/type:type_proto",
         "//google/rpc:status_proto",
         "@com_google_protobuf//:any_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
         "@com_google_protobuf//:struct_proto",
         "@com_google_protobuf//:timestamp_proto",
-        "@com_google_protobuf//:field_mask_proto",
-        "@com_google_protobuf//:empty_proto",
-        "@com_google_protobuf//:duration_proto",
-    ] + _PROTO_SUBPACKAGE_DEPS,
+    ],
 )
 
 proto_library_with_info(
     name = "logging_proto_with_info",
     deps = [
         ":logging_proto",
-    ] + _PROTO_SUBPACKAGE_DEPS,
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
-"//google/devtools/logging/v1beta1/attestation:_proto"
-
 ##############################################################################
 # Java
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
-_JAVA_PROTO_SUBPACKAGE_DEPS = [
-    "//google/logging/type:type_java_proto",
-]
-
-_JAVA_GRPC_SUBPACKAGE_DEPS = [
-    #    "//google/logging/type:type_java_grpc",
-]
-
-_RESOURCE_NAME_JAVA_PROTO_SUBPACKAGE_DEPS = [
-    "//google/logging/type:type_resource_name_java_proto",
-]
-
 java_proto_library(
     name = "logging_java_proto",
     deps = [":logging_proto"],
@@ -80,53 +64,43 @@ java_proto_library(
 java_grpc_library(
     name = "logging_java_grpc",
     srcs = [":logging_proto"],
-    deps = [":logging_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "logging_resource_name_java_proto",
-    gapic_yaml = "logging_gapic.yaml",
-    deps = [":logging_proto"],
+    deps = [":logging_java_proto"],
 )
 
 java_gapic_library(
     name = "logging_java_gapic",
     src = ":logging_proto_with_info",
     gapic_yaml = "logging_gapic.yaml",
-    service_yaml = "//google/logging:logging.yaml",
+    package = "google.logging.v2",
+    service_yaml = "logging.yaml",
     test_deps = [
         ":logging_java_grpc",
-    ] + _JAVA_GRPC_SUBPACKAGE_DEPS,
+    ],
     deps = [
         ":logging_java_proto",
-        ":logging_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS + _JAVA_PROTO_SUBPACKAGE_DEPS,
+        "//google/api:api_java_proto",
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
+java_gapic_test(
+    name = "logging_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.logging.v2.ConfigClientTest",
+        "com.google.cloud.logging.v2.LoggingClientTest",
+        "com.google.cloud.logging.v2.MetricsClientTest",
+    ],
     runtime_deps = [":logging_java_gapic_test"],
-) for test_name in [
-    "com.google.cloud.logging.v2.LoggingClientTest",
-    "com.google.cloud.logging.v2.ConfigClientTest",
-    "com.google.cloud.logging.v2.MetricsClientTest",
-]]
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-logging-v2-java",
-    client_deps = [":logging_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":logging_java_gapic_test"],
-    grpc_deps = [":logging_java_grpc"] + _JAVA_GRPC_SUBPACKAGE_DEPS,
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":logging_java_gapic",
+        ":logging_java_grpc",
         ":logging_java_proto",
         ":logging_proto",
-        ":logging_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS + _JAVA_PROTO_SUBPACKAGE_DEPS + _PROTO_SUBPACKAGE_DEPS + _RESOURCE_NAME_JAVA_PROTO_SUBPACKAGE_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -134,10 +108,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -150,20 +124,21 @@ go_proto_library(
         "//google/api:distribution_go_proto",
         "//google/api:metric_go_proto",
         "//google/api:monitoredres_go_proto",
-        "//google/logging/type:ltype_go_proto",
+        "//google/logging/type:type_go_proto",
         "//google/rpc:status_go_proto",
     ],
 )
 
 go_gapic_library(
     name = "logging_go_gapic",
-    src = ":logging_proto_with_info",
-    gapic_yaml = "logging_gapic.yaml",
-    importpath = "cloud.google.com/go/logging/apiv2",
-    service_yaml = "//google/logging:logging.yaml",
+    srcs = [":logging_proto_with_info"],
+    grpc_service_config = "logging_grpc_service_config.json",
+    importpath = "cloud.google.com/go/logging/apiv2;logging",
+    service_yaml = "logging.yaml",
     deps = [
-        ":logging_go_proto",
         "//google/api:monitoredres_go_proto",
+        ":logging_go_proto",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
     ],
 )
 
@@ -174,14 +149,243 @@ go_test(
     importpath = "cloud.google.com/go/logging/apiv2",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-logging-v2-go",
     deps = [
         ":logging_go_gapic",
-        ":logging_go_gapic_srcjar-smoke-test.srcjar",
         ":logging_go_gapic_srcjar-test.srcjar",
         ":logging_go_proto",
-        "//google/logging/type:ltype_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "logging_moved_proto",
+    srcs = [":logging_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:distribution_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:metric_proto",
+        "//google/api:monitored_resource_proto",
+        "//google/api:resource_proto",
+        "//google/logging/type:type_proto",
+        "//google/rpc:status_proto",
+        "@com_google_protobuf//:any_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:struct_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "logging_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":logging_moved_proto"],
+)
+
+py_grpc_library(
+    name = "logging_py_grpc",
+    srcs = [":logging_moved_proto"],
+    deps = [":logging_py_proto"],
+)
+
+py_gapic_library(
+    name = "logging_py_gapic",
+    src = ":logging_proto_with_info",
+    gapic_yaml = "logging_gapic.yaml",
+    package = "google.logging.v2",
+    service_yaml = "logging.yaml",
+    deps = [
+        ":logging_py_grpc",
+        ":logging_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "logging-v2-py",
+    deps = [
+        ":logging_py_gapic",
+        ":logging_py_grpc",
+        ":logging_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "logging_php_proto",
+    deps = [":logging_proto"],
+)
+
+php_grpc_library(
+    name = "logging_php_grpc",
+    srcs = [":logging_proto"],
+    deps = [":logging_php_proto"],
+)
+
+php_gapic_library(
+    name = "logging_php_gapic",
+    src = ":logging_proto_with_info",
+    gapic_yaml = "logging_gapic.yaml",
+    package = "google.logging.v2",
+    service_yaml = "logging.yaml",
+    deps = [
+        ":logging_php_grpc",
+        ":logging_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-logging-v2-php",
+    deps = [
+        ":logging_php_gapic",
+        ":logging_php_grpc",
+        ":logging_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "logging_nodejs_gapic",
+    src = ":logging_proto_with_info",
+    gapic_yaml = "logging_gapic.yaml",
+    package = "google.logging.v2",
+    service_yaml = "logging.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "logging-v2-nodejs",
+    deps = [
+        ":logging_nodejs_gapic",
+        ":logging_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "logging_ruby_proto",
+    deps = [":logging_proto"],
+)
+
+ruby_grpc_library(
+    name = "logging_ruby_grpc",
+    srcs = [":logging_proto"],
+    deps = [":logging_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "logging_ruby_gapic",
+    src = ":logging_proto_with_info",
+    gapic_yaml = "logging_gapic.yaml",
+    package = "google.logging.v2",
+    service_yaml = "logging.yaml",
+    deps = [
+        ":logging_ruby_grpc",
+        ":logging_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-logging-v2-ruby",
+    deps = [
+        ":logging_ruby_gapic",
+        ":logging_ruby_grpc",
+        ":logging_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "logging_csharp_proto",
+    deps = [":logging_proto"],
+)
+
+csharp_grpc_library(
+    name = "logging_csharp_grpc",
+    srcs = [":logging_proto"],
+    deps = [":logging_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "logging_csharp_gapic",
+    src = ":logging_proto_with_info",
+    gapic_yaml = "logging_gapic.yaml",
+    package = "google.logging.v2",
+    service_yaml = "logging.yaml",
+    deps = [
+        ":logging_csharp_grpc",
+        ":logging_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-logging-v2-csharp",
+    deps = [
+        ":logging_csharp_gapic",
+        ":logging_csharp_grpc",
+        ":logging_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/logging/v2/log_entry.proto b/third_party/googleapis/google/logging/v2/log_entry.proto
index de9786daf..351f9e632 100644
--- a/third_party/googleapis/google/logging/v2/log_entry.proto
+++ b/third_party/googleapis/google/logging/v2/log_entry.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,19 +11,21 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.logging.v2;
 
-import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
 import "google/api/monitored_resource.proto";
+import "google/api/resource.proto";
 import "google/logging/type/http_request.proto";
 import "google/logging/type/log_severity.proto";
 import "google/protobuf/any.proto";
 import "google/protobuf/struct.proto";
 import "google/protobuf/timestamp.proto";
+import "google/rpc/status.proto";
+import "google/api/annotations.proto";
 
 option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.Logging.V2";
@@ -34,7 +36,18 @@ option java_package = "com.google.logging.v2";
 option php_namespace = "Google\\Cloud\\Logging\\V2";
 
 // An individual entry in a log.
+//
+//
 message LogEntry {
+  option (google.api.resource) = {
+    type: "logging.googleapis.com/Log"
+    pattern: "projects/{project}/logs/{log}"
+    pattern: "organizations/{organization}/logs/{log}"
+    pattern: "folders/{folder}/logs/{log}"
+    pattern: "billingAccounts/{billing_account}/logs/{log}"
+    name_field: "log_name"
+  };
+
   // Required. The resource name of the log to which this log entry belongs:
   //
   //     "projects/[PROJECT_ID]/logs/[LOG_ID]"
@@ -42,9 +55,9 @@ message LogEntry {
   //     "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
   //     "folders/[FOLDER_ID]/logs/[LOG_ID]"
   //
-  //  A project number may optionally be used in place of PROJECT_ID. The
-  //  project number is translated to its corresponding PROJECT_ID internally
-  //  and the `log_name` field will contain PROJECT_ID in queries and exports.
+  // A project number may be used in place of PROJECT_ID. The project number is
+  // translated to its corresponding PROJECT_ID internally and the `log_name`
+  // field will contain PROJECT_ID in queries and exports.
   //
   // `[LOG_ID]` must be URL-encoded within `log_name`. Example:
   // `"organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"`.
@@ -57,19 +70,25 @@ message LogEntry {
   // forward-slash is removed. Listing the log entry will not show the leading
   // slash and filtering for a log name with a leading slash will never return
   // any results.
-  string log_name = 12;
+  string log_name = 12 [(google.api.field_behavior) = REQUIRED];
 
-  // Required. The primary monitored resource associated with this log entry.
-  // Example: a log entry that reports a database error would be
-  // associated with the monitored resource designating the particular
-  // database that reported the error.
-  google.api.MonitoredResource resource = 8;
+  // Required. The monitored resource that produced this log entry.
+  //
+  // Example: a log entry that reports a database error would be associated with
+  // the monitored resource designating the particular database that reported
+  // the error.
+  google.api.MonitoredResource resource = 8 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional. The log entry payload, which can be one of multiple types.
+  // The log entry payload, which can be one of multiple types.
   oneof payload {
-    // The log entry payload, represented as a protocol buffer.  Some
-    // Google Cloud Platform services use this field for their log
-    // entry payloads.
+    // The log entry payload, represented as a protocol buffer. Some Google
+    // Cloud Platform services use this field for their log entry payloads.
+    //
+    // The following protocol buffer types are supported; user-defined types
+    // are not supported:
+    //
+    //   "type.googleapis.com/google.cloud.audit.AuditLog"
+    //   "type.googleapis.com/google.appengine.logging.v1.RequestLog"
     google.protobuf.Any proto_payload = 2;
 
     // The log entry payload, represented as a Unicode string (UTF-8).
@@ -80,95 +99,93 @@ message LogEntry {
     google.protobuf.Struct json_payload = 6;
   }
 
-  // Optional. The time the event described by the log entry occurred.
-  // This time is used to compute the log entry's age and to enforce
-  // the logs retention period. If this field is omitted in a new log
-  // entry, then Logging assigns it the current time.
-  // Timestamps have nanosecond accuracy, but trailing zeros in the fractional
-  // seconds might be omitted when the timestamp is displayed.
+  // Optional. The time the event described by the log entry occurred. This time is used
+  // to compute the log entry's age and to enforce the logs retention period.
+  // If this field is omitted in a new log entry, then Logging assigns it the
+  // current time. Timestamps have nanosecond accuracy, but trailing zeros in
+  // the fractional seconds might be omitted when the timestamp is displayed.
   //
-  // Incoming log entries should have timestamps that are no more than
-  // the [logs retention period](/logging/quotas) in the past,
-  // and no more than 24 hours in the future. Log entries outside those time
-  // boundaries will not be available when calling `entries.list`, but
-  // those log entries can still be exported with
-  // [LogSinks](/logging/docs/api/tasks/exporting-logs).
-  google.protobuf.Timestamp timestamp = 9;
+  // Incoming log entries should have timestamps that are no more than the [logs
+  // retention period](https://cloud.google.com/logging/quotas) in the past, and no more than 24 hours
+  // in the future. Log entries outside those time boundaries will not be
+  // available when calling `entries.list`, but those log entries can still be
+  // [exported with LogSinks](https://cloud.google.com/logging/docs/api/tasks/exporting-logs).
+  google.protobuf.Timestamp timestamp = 9 [(google.api.field_behavior) = OPTIONAL];
 
   // Output only. The time the log entry was received by Logging.
-  google.protobuf.Timestamp receive_timestamp = 24;
+  google.protobuf.Timestamp receive_timestamp = 24 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // Optional. The severity of the log entry. The default value is
-  // `LogSeverity.DEFAULT`.
-  google.logging.type.LogSeverity severity = 10;
+  // Optional. The severity of the log entry. The default value is `LogSeverity.DEFAULT`.
+  google.logging.type.LogSeverity severity = 10 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. A unique identifier for the log entry. If you provide a value,
-  // then Logging considers other log entries in the same project,
-  // with the same `timestamp`, and with the same `insert_id` to be duplicates
-  // which can be removed.  If omitted in new log entries, then
-  // Logging assigns its own unique identifier. The `insert_id` is also used
-  // to order log entries that have the same `timestamp` value.
-  string insert_id = 4;
+  // Optional. A unique identifier for the log entry. If you provide a value, then
+  // Logging considers other log entries in the same project, with the same
+  // `timestamp`, and with the same `insert_id` to be duplicates which are
+  // removed in a single query result. However, there are no guarantees of
+  // de-duplication in the export of logs.
+  //
+  // If the `insert_id` is omitted when writing a log entry, the Logging API
+  //  assigns its own unique identifier in this field.
+  //
+  // In queries, the `insert_id` is also used to order log entries that have
+  // the same `log_name` and `timestamp` values.
+  string insert_id = 4 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. Information about the HTTP request associated with this
-  // log entry, if applicable.
-  google.logging.type.HttpRequest http_request = 7;
+  // Optional. Information about the HTTP request associated with this log entry, if
+  // applicable.
+  google.logging.type.HttpRequest http_request = 7 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. A set of user-defined (key, value) data that provides additional
   // information about the log entry.
-  map labels = 11;
-
-  // Output only. Additional metadata about the monitored resource.
-  // Only `k8s_container`, `k8s_pod`, and `k8s_node` MonitoredResources have
-  // this field populated.
-  google.api.MonitoredResourceMetadata metadata = 25;
+  map labels = 11 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Information about an operation associated with the log entry, if
   // applicable.
-  LogEntryOperation operation = 15;
+  LogEntryOperation operation = 15 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. Resource name of the trace associated with the log entry, if any.
-  // If it contains a relative resource name, the name is assumed to be relative
-  // to `//tracing.googleapis.com`. Example:
+  // Optional. Resource name of the trace associated with the log entry, if any. If it
+  // contains a relative resource name, the name is assumed to be relative to
+  // `//tracing.googleapis.com`. Example:
   // `projects/my-projectid/traces/06796866738c859f2f19b7cfb3214824`
-  string trace = 22;
+  string trace = 22 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The span ID within the trace associated with the log entry.
-  // For Trace spans, this is the same format that the Trace
-  // API v2 uses: a 16-character hexadecimal encoding of an 8-byte array, such
-  // as "000000000000004a".
-  string span_id = 27;
+  //
+  // For Trace spans, this is the same format that the Trace API v2 uses: a
+  // 16-character hexadecimal encoding of an 8-byte array, such as
+  // `000000000000004a`.
+  string span_id = 27 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The sampling decision of the trace associated with the log entry.
+  //
   // True means that the trace resource name in the `trace` field was sampled
   // for storage in a trace backend. False means that the trace was not sampled
   // for storage when this log entry was written, or the sampling decision was
   // unknown at the time. A non-sampled `trace` value is still useful as a
   // request correlation identifier. The default is False.
-  bool trace_sampled = 30;
+  bool trace_sampled = 30 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. Source code location information associated with the log entry,
-  // if any.
-  LogEntrySourceLocation source_location = 23;
+  // Optional. Source code location information associated with the log entry, if any.
+  LogEntrySourceLocation source_location = 23 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Additional information about a potentially long-running operation with which
 // a log entry is associated.
 message LogEntryOperation {
-  // Optional. An arbitrary operation identifier. Log entries with the
-  // same identifier are assumed to be part of the same operation.
-  string id = 1;
+  // Optional. An arbitrary operation identifier. Log entries with the same
+  // identifier are assumed to be part of the same operation.
+  string id = 1 [(google.api.field_behavior) = OPTIONAL];
 
-  // Optional. An arbitrary producer identifier. The combination of
-  // `id` and `producer` must be globally unique.  Examples for `producer`:
+  // Optional. An arbitrary producer identifier. The combination of `id` and
+  // `producer` must be globally unique. Examples for `producer`:
   // `"MyDivision.MyBigCompany.com"`, `"github.com/MyProject/MyApplication"`.
-  string producer = 2;
+  string producer = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Set this to True if this is the first log entry in the operation.
-  bool first = 3;
+  bool first = 3 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Set this to True if this is the last log entry in the operation.
-  bool last = 4;
+  bool last = 4 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Additional information about the source code location that produced the log
@@ -176,11 +193,11 @@ message LogEntryOperation {
 message LogEntrySourceLocation {
   // Optional. Source file name. Depending on the runtime environment, this
   // might be a simple name or a fully-qualified name.
-  string file = 1;
+  string file = 1 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Line within the source file. 1-based; 0 indicates no line number
   // available.
-  int64 line = 2;
+  int64 line = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Human-readable name of the function or method being invoked, with
   // optional context such as the class or package name. This information may be
@@ -188,5 +205,5 @@ message LogEntrySourceLocation {
   // less meaningful. The format can vary by language. For example:
   // `qual.if.ied.Class.method` (Java), `dir/package.func` (Go), `function`
   // (Python).
-  string function = 3;
+  string function = 3 [(google.api.field_behavior) = OPTIONAL];
 }
diff --git a/third_party/googleapis/google/logging/v2/logging.proto b/third_party/googleapis/google/logging/v2/logging.proto
index d04cd5c03..36a81dcc2 100644
--- a/third_party/googleapis/google/logging/v2/logging.proto
+++ b/third_party/googleapis/google/logging/v2/logging.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,19 +11,22 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.logging.v2;
 
-import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/api/monitored_resource.proto";
+import "google/api/resource.proto";
 import "google/logging/v2/log_entry.proto";
+import "google/logging/v2/logging_config.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/timestamp.proto";
 import "google/rpc/status.proto";
+import "google/api/annotations.proto";
 
 option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.Logging.V2";
@@ -35,17 +38,35 @@ option php_namespace = "Google\\Cloud\\Logging\\V2";
 
 // Service for ingesting and querying logs.
 service LoggingServiceV2 {
-  // Deletes all the log entries in a log.
-  // The log reappears if it receives new entries.
-  // Log entries written shortly before the delete operation might not be
-  // deleted.
+  option (google.api.default_host) = "logging.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/cloud-platform.read-only,"
+      "https://www.googleapis.com/auth/logging.admin,"
+      "https://www.googleapis.com/auth/logging.read,"
+      "https://www.googleapis.com/auth/logging.write";
+
+  // Deletes all the log entries in a log. The log reappears if it receives new
+  // entries. Log entries written shortly before the delete operation might not
+  // be deleted. Entries received after the delete operation with a timestamp
+  // before the operation will be deleted.
   rpc DeleteLog(DeleteLogRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v2/{log_name=projects/*/logs/*}"
-      additional_bindings { delete: "/v2/{log_name=organizations/*/logs/*}" }
-      additional_bindings { delete: "/v2/{log_name=folders/*/logs/*}" }
-      additional_bindings { delete: "/v2/{log_name=billingAccounts/*/logs/*}" }
+      additional_bindings {
+        delete: "/v2/{log_name=*/*/logs/*}"
+      }
+      additional_bindings {
+        delete: "/v2/{log_name=organizations/*/logs/*}"
+      }
+      additional_bindings {
+        delete: "/v2/{log_name=folders/*/logs/*}"
+      }
+      additional_bindings {
+        delete: "/v2/{log_name=billingAccounts/*/logs/*}"
+      }
     };
+    option (google.api.method_signature) = "log_name";
   }
 
   // Writes log entries to Logging. This API method is the
@@ -55,27 +76,27 @@ service LoggingServiceV2 {
   // A single request may contain log entries for a maximum of 1000
   // different resources (projects, organizations, billing accounts or
   // folders)
-  rpc WriteLogEntries(WriteLogEntriesRequest)
-      returns (WriteLogEntriesResponse) {
+  rpc WriteLogEntries(WriteLogEntriesRequest) returns (WriteLogEntriesResponse) {
     option (google.api.http) = {
       post: "/v2/entries:write"
       body: "*"
     };
+    option (google.api.method_signature) = "log_name,resource,labels,entries";
   }
 
-  // Lists log entries.  Use this method to retrieve log entries from
-  // Logging.  For ways to export log entries, see
-  // [Exporting Logs](/logging/docs/export).
+  // Lists log entries.  Use this method to retrieve log entries that originated
+  // from a project/folder/organization/billing account.  For ways to export log
+  // entries, see [Exporting Logs](https://cloud.google.com/logging/docs/export).
   rpc ListLogEntries(ListLogEntriesRequest) returns (ListLogEntriesResponse) {
     option (google.api.http) = {
       post: "/v2/entries:list"
       body: "*"
     };
+    option (google.api.method_signature) = "resource_names,filter,order_by";
   }
 
   // Lists the descriptors for monitored resource types used by Logging.
-  rpc ListMonitoredResourceDescriptors(ListMonitoredResourceDescriptorsRequest)
-      returns (ListMonitoredResourceDescriptorsResponse) {
+  rpc ListMonitoredResourceDescriptors(ListMonitoredResourceDescriptorsRequest) returns (ListMonitoredResourceDescriptorsResponse) {
     option (google.api.http) = {
       get: "/v2/monitoredResourceDescriptors"
     };
@@ -86,11 +107,20 @@ service LoggingServiceV2 {
   rpc ListLogs(ListLogsRequest) returns (ListLogsResponse) {
     option (google.api.http) = {
       get: "/v2/{parent=*/*}/logs"
-      additional_bindings { get: "/v2/{parent=projects/*}/logs" }
-      additional_bindings { get: "/v2/{parent=organizations/*}/logs" }
-      additional_bindings { get: "/v2/{parent=folders/*}/logs" }
-      additional_bindings { get: "/v2/{parent=billingAccounts/*}/logs" }
+      additional_bindings {
+        get: "/v2/{parent=projects/*}/logs"
+      }
+      additional_bindings {
+        get: "/v2/{parent=organizations/*}/logs"
+      }
+      additional_bindings {
+        get: "/v2/{parent=folders/*}/logs"
+      }
+      additional_bindings {
+        get: "/v2/{parent=billingAccounts/*}/logs"
+      }
     };
+    option (google.api.method_signature) = "parent";
   }
 }
 
@@ -108,7 +138,12 @@ message DeleteLogRequest {
   // `"organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"`.
   // For more information about log names, see
   // [LogEntry][google.logging.v2.LogEntry].
-  string log_name = 1;
+  string log_name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "logging.googleapis.com/Log"
+    }
+  ];
 }
 
 // The parameters to WriteLogEntries.
@@ -126,11 +161,16 @@ message WriteLogEntriesRequest {
   //     "projects/my-project-id/logs/syslog"
   //     "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"
   //
-  // The permission logging.logEntries.create is needed on each
-  // project, organization, billing account, or folder that is receiving
-  // new log entries, whether the resource is specified in
-  // logName or in an individual log entry.
-  string log_name = 1;
+  // The permission `logging.logEntries.create` is needed on each project,
+  // organization, billing account, or folder that is receiving new log
+  // entries, whether the resource is specified in `logName` or in an
+  // individual log entry.
+  string log_name = 1 [
+    (google.api.field_behavior) = OPTIONAL,
+    (google.api.resource_reference) = {
+      type: "logging.googleapis.com/Log"
+    }
+  ];
 
   // Optional. A default monitored resource object that is assigned to all log
   // entries in `entries` that do not specify a value for `resource`. Example:
@@ -140,13 +180,13 @@ message WriteLogEntriesRequest {
   //         "zone": "us-central1-a", "instance_id": "00000000000000000000" }}
   //
   // See [LogEntry][google.logging.v2.LogEntry].
-  google.api.MonitoredResource resource = 2;
+  google.api.MonitoredResource resource = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Default labels that are added to the `labels` field of all log
   // entries in `entries`. If a log entry already has a label with the same key
   // as a label in this parameter, then the log entry's label is not changed.
   // See [LogEntry][google.logging.v2.LogEntry].
-  map labels = 3;
+  map labels = 3 [(google.api.field_behavior) = OPTIONAL];
 
   // Required. The log entries to send to Logging. The order of log
   // entries in this list does not matter. Values supplied in this method's
@@ -162,32 +202,31 @@ message WriteLogEntriesRequest {
   // the entries later in the list. See the `entries.list` method.
   //
   // Log entries with timestamps that are more than the
-  // [logs retention period](/logging/quota-policy) in the past or more than
+  // [logs retention period](https://cloud.google.com/logging/quota-policy) in the past or more than
   // 24 hours in the future will not be available when calling `entries.list`.
-  // However, those log entries can still be exported with
-  // [LogSinks](/logging/docs/api/tasks/exporting-logs).
+  // However, those log entries can still be
+  // [exported with LogSinks](https://cloud.google.com/logging/docs/api/tasks/exporting-logs).
   //
   // To improve throughput and to avoid exceeding the
-  // [quota limit](/logging/quota-policy) for calls to `entries.write`,
+  // [quota limit](https://cloud.google.com/logging/quota-policy) for calls to `entries.write`,
   // you should try to include several log entries in this list,
   // rather than calling this method for each individual log entry.
-  repeated LogEntry entries = 4;
+  repeated LogEntry entries = 4 [(google.api.field_behavior) = REQUIRED];
 
   // Optional. Whether valid entries should be written even if some other
   // entries fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any
   // entry is not written, then the response status is the error associated
   // with one of the failed entries and the response includes error details
   // keyed by the entries' zero-based index in the `entries.write` method.
-  bool partial_success = 5;
+  bool partial_success = 5 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. If true, the request should expect normal response, but the
   // entries won't be persisted nor exported. Useful for checking whether the
   // logging API endpoints are working properly before sending valuable data.
-  bool dry_run = 6;
+  bool dry_run = 6 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Result returned from WriteLogEntries.
-// empty
 message WriteLogEntriesResponse {}
 
 // Error details for WriteLogEntries with partial success.
@@ -203,13 +242,6 @@ message WriteLogEntriesPartialErrors {
 
 // The parameters to `ListLogEntries`.
 message ListLogEntriesRequest {
-  // Deprecated. Use `resource_names` instead.  One or more project identifiers
-  // or project numbers from which to retrieve log entries.  Example:
-  // `"my-project-1A"`. If present, these project identifiers are converted to
-  // resource name format and added to the list of resources in
-  // `resource_names`.
-  repeated string project_ids = 1 [deprecated = true];
-
   // Required. Names of one or more parent resources from which to
   // retrieve log entries:
   //
@@ -218,17 +250,23 @@ message ListLogEntriesRequest {
   //     "billingAccounts/[BILLING_ACCOUNT_ID]"
   //     "folders/[FOLDER_ID]"
   //
+  //
   // Projects listed in the `project_ids` field are added to this list.
-  repeated string resource_names = 8;
+  repeated string resource_names = 8 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "logging.googleapis.com/Log"
+    }
+  ];
 
   // Optional. A filter that chooses which log entries to return.  See [Advanced
-  // Logs Filters](/logging/docs/view/advanced_filters).  Only log entries that
+  // Logs Queries](https://cloud.google.com/logging/docs/view/advanced-queries).  Only log entries that
   // match the filter are returned.  An empty filter matches all log entries in
   // the resources listed in `resource_names`. Referencing a parent resource
   // that is not listed in `resource_names` will cause the filter to return no
   // results.
   // The maximum length of the filter is 20000 characters.
-  string filter = 2;
+  string filter = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. How the results should be sorted.  Presently, the only permitted
   // values are `"timestamp asc"` (default) and `"timestamp desc"`. The first
@@ -236,18 +274,18 @@ message ListLogEntriesRequest {
   // `LogEntry.timestamp` (oldest first), and the second option returns entries
   // in order of decreasing timestamps (newest first).  Entries with equal
   // timestamps are returned in order of their `insert_id` values.
-  string order_by = 3;
+  string order_by = 3 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The maximum number of results to return from this request.
   // Non-positive values are ignored.  The presence of `next_page_token` in the
   // response indicates that more results might be available.
-  int32 page_size = 4;
+  int32 page_size = 4 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. If present, then retrieve the next batch of results from the
   // preceding call to this method.  `page_token` must be the value of
   // `next_page_token` from the previous response.  The values of other method
   // parameters should be identical to those in the previous call.
-  string page_token = 5;
+  string page_token = 5 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Result returned from `ListLogEntries`.
@@ -275,13 +313,13 @@ message ListMonitoredResourceDescriptorsRequest {
   // Optional. The maximum number of results to return from this request.
   // Non-positive values are ignored.  The presence of `nextPageToken` in the
   // response indicates that more results might be available.
-  int32 page_size = 1;
+  int32 page_size = 1 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. If present, then retrieve the next batch of results from the
   // preceding call to this method.  `pageToken` must be the value of
   // `nextPageToken` from the previous response.  The values of other method
   // parameters should be identical to those in the previous call.
-  string page_token = 2;
+  string page_token = 2 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Result returned from ListMonitoredResourceDescriptors.
@@ -303,25 +341,30 @@ message ListLogsRequest {
   //     "organizations/[ORGANIZATION_ID]"
   //     "billingAccounts/[BILLING_ACCOUNT_ID]"
   //     "folders/[FOLDER_ID]"
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "logging.googleapis.com/Log"
+    }
+  ];
 
   // Optional. The maximum number of results to return from this request.
   // Non-positive values are ignored.  The presence of `nextPageToken` in the
   // response indicates that more results might be available.
-  int32 page_size = 2;
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. If present, then retrieve the next batch of results from the
   // preceding call to this method.  `pageToken` must be the value of
   // `nextPageToken` from the previous response.  The values of other method
   // parameters should be identical to those in the previous call.
-  string page_token = 3;
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Result returned from ListLogs.
 message ListLogsResponse {
   // A list of log names. For example,
-  // `"projects/my-project/syslog"` or
-  // `"organizations/123/cloudresourcemanager.googleapis.com%2Factivity"`.
+  // `"projects/my-project/logs/syslog"` or
+  // `"organizations/123/logs/cloudresourcemanager.googleapis.com%2Factivity"`.
   repeated string log_names = 3;
 
   // If there might be more results than those appearing in this response, then
diff --git a/third_party/googleapis/google/logging/v2/logging.yaml b/third_party/googleapis/google/logging/v2/logging.yaml
new file mode 100644
index 000000000..5d04a82e9
--- /dev/null
+++ b/third_party/googleapis/google/logging/v2/logging.yaml
@@ -0,0 +1,126 @@
+type: google.api.Service
+config_version: 3
+name: logging.googleapis.com
+title: Stackdriver Logging API
+
+apis:
+- name: google.logging.v2.ConfigServiceV2
+- name: google.logging.v2.LoggingServiceV2
+- name: google.logging.v2.MetricsServiceV2
+
+documentation:
+  summary: |-
+    Writes log entries and manages your Stackdriver Logging configuration. The
+    table entries below are presented in alphabetical order, not in order of
+    common use. For explanations of the concepts found in the table entries,
+    read the Stackdriver Logging
+    documentation.
+  overview: '# Introduction
+
+The Stackdriver Logging service.'
+
+backend:
+  rules:
+  - selector: 'google.logging.v2.ConfigServiceV2.*'
+    deadline: 60.0
+  - selector: 'google.logging.v2.LoggingServiceV2.*'
+    deadline: 60.0
+  - selector: google.logging.v2.LoggingServiceV2.ListLogEntries
+    deadline: 10.0
+  - selector: 'google.logging.v2.MetricsServiceV2.*'
+    deadline: 60.0
+
+authentication:
+  rules:
+  - selector: 'google.logging.v2.ConfigServiceV2.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/logging.admin
+  - selector: google.logging.v2.ConfigServiceV2.GetBucket
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-platform.read-only,
+        https://www.googleapis.com/auth/logging.admin,
+        https://www.googleapis.com/auth/logging.read
+  - selector: google.logging.v2.ConfigServiceV2.GetCmekSettings
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-platform.read-only,
+        https://www.googleapis.com/auth/logging.admin,
+        https://www.googleapis.com/auth/logging.read
+  - selector: google.logging.v2.ConfigServiceV2.GetExclusion
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-platform.read-only,
+        https://www.googleapis.com/auth/logging.admin,
+        https://www.googleapis.com/auth/logging.read
+  - selector: google.logging.v2.ConfigServiceV2.GetSink
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-platform.read-only,
+        https://www.googleapis.com/auth/logging.admin,
+        https://www.googleapis.com/auth/logging.read
+  - selector: google.logging.v2.ConfigServiceV2.ListBuckets
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-platform.read-only,
+        https://www.googleapis.com/auth/logging.admin,
+        https://www.googleapis.com/auth/logging.read
+  - selector: google.logging.v2.ConfigServiceV2.ListExclusions
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-platform.read-only,
+        https://www.googleapis.com/auth/logging.admin,
+        https://www.googleapis.com/auth/logging.read
+  - selector: google.logging.v2.ConfigServiceV2.ListSinks
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-platform.read-only,
+        https://www.googleapis.com/auth/logging.admin,
+        https://www.googleapis.com/auth/logging.read
+  - selector: 'google.logging.v2.LoggingServiceV2.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-platform.read-only,
+        https://www.googleapis.com/auth/logging.admin,
+        https://www.googleapis.com/auth/logging.read
+  - selector: google.logging.v2.LoggingServiceV2.DeleteLog
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/logging.admin
+  - selector: google.logging.v2.LoggingServiceV2.WriteLogEntries
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/logging.admin,
+        https://www.googleapis.com/auth/logging.write
+  - selector: 'google.logging.v2.MetricsServiceV2.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/logging.admin,
+        https://www.googleapis.com/auth/logging.write
+  - selector: google.logging.v2.MetricsServiceV2.GetLogMetric
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-platform.read-only,
+        https://www.googleapis.com/auth/logging.admin,
+        https://www.googleapis.com/auth/logging.read
+  - selector: google.logging.v2.MetricsServiceV2.ListLogMetrics
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-platform.read-only,
+        https://www.googleapis.com/auth/logging.admin,
+        https://www.googleapis.com/auth/logging.read
diff --git a/third_party/googleapis/google/logging/v2/logging_config.proto b/third_party/googleapis/google/logging/v2/logging_config.proto
index 2afea1062..b7cb9c94a 100644
--- a/third_party/googleapis/google/logging/v2/logging_config.proto
+++ b/third_party/googleapis/google/logging/v2/logging_config.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,16 +11,19 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.logging.v2;
 
-import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/protobuf/duration.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
 import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
 
 option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.Logging.V2";
@@ -29,55 +32,172 @@ option java_multiple_files = true;
 option java_outer_classname = "LoggingConfigProto";
 option java_package = "com.google.logging.v2";
 option php_namespace = "Google\\Cloud\\Logging\\V2";
+option (google.api.resource_definition) = {
+  type: "logging.googleapis.com/OrganizationLocation"
+  pattern: "organizations/{organization}/locations/{location}"
+};
+option (google.api.resource_definition) = {
+  type: "logging.googleapis.com/FolderLocation"
+  pattern: "folders/{folder}/locations/{location}"
+};
+option (google.api.resource_definition) = {
+  type: "logging.googleapis.com/BillingAccountLocation"
+  pattern: "billingAccounts/{billing_account}/locations/{location}"
+};
 
-// Service for configuring sinks used to export log entries out of
-// Logging.
+// Service for configuring sinks used to route log entries.
 service ConfigServiceV2 {
+  option (google.api.default_host) = "logging.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/cloud-platform.read-only,"
+      "https://www.googleapis.com/auth/logging.admin,"
+      "https://www.googleapis.com/auth/logging.read";
+
+  // Lists buckets (Beta).
+  rpc ListBuckets(ListBucketsRequest) returns (ListBucketsResponse) {
+    option (google.api.http) = {
+      get: "/v2/{parent=*/*/locations/*}/buckets"
+      additional_bindings {
+        get: "/v2/{parent=projects/*/locations/*}/buckets"
+      }
+      additional_bindings {
+        get: "/v2/{parent=organizations/*/locations/*}/buckets"
+      }
+      additional_bindings {
+        get: "/v2/{parent=folders/*/locations/*}/buckets"
+      }
+      additional_bindings {
+        get: "/v2/{parent=billingAccounts/*/locations/*}/buckets"
+      }
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Gets a bucket (Beta).
+  rpc GetBucket(GetBucketRequest) returns (LogBucket) {
+    option (google.api.http) = {
+      get: "/v2/{name=*/*/locations/*/buckets/*}"
+      additional_bindings {
+        get: "/v2/{name=projects/*/locations/*/buckets/*}"
+      }
+      additional_bindings {
+        get: "/v2/{name=organizations/*/locations/*/buckets/*}"
+      }
+      additional_bindings {
+        get: "/v2/{name=folders/*/locations/*/buckets/*}"
+      }
+      additional_bindings {
+        get: "/v2/{name=billingAccounts/*/buckets/*}"
+      }
+    };
+  }
+
+  // Updates a bucket. This method replaces the following fields in the
+  // existing bucket with values from the new bucket: `retention_period`
+  //
+  // If the retention period is decreased and the bucket is locked,
+  // FAILED_PRECONDITION will be returned.
+  //
+  // If the bucket has a LifecycleState of DELETE_REQUESTED, FAILED_PRECONDITION
+  // will be returned.
+  //
+  // A buckets region may not be modified after it is created.
+  // This method is in Beta.
+  rpc UpdateBucket(UpdateBucketRequest) returns (LogBucket) {
+    option (google.api.http) = {
+      patch: "/v2/{name=*/*/locations/*/buckets/*}"
+      body: "bucket"
+      additional_bindings {
+        patch: "/v2/{name=projects/*/locations/*/buckets/*}"
+        body: "bucket"
+      }
+      additional_bindings {
+        patch: "/v2/{name=organizations/*/locations/*/buckets/*}"
+        body: "bucket"
+      }
+      additional_bindings {
+        patch: "/v2/{name=folders/*/locations/*/buckets/*}"
+        body: "bucket"
+      }
+      additional_bindings {
+        patch: "/v2/{name=billingAccounts/*/locations/*/buckets/*}"
+        body: "bucket"
+      }
+    };
+  }
+
   // Lists sinks.
   rpc ListSinks(ListSinksRequest) returns (ListSinksResponse) {
     option (google.api.http) = {
       get: "/v2/{parent=*/*}/sinks"
-      additional_bindings { get: "/v2/{parent=projects/*}/sinks" }
-      additional_bindings { get: "/v2/{parent=organizations/*}/sinks" }
-      additional_bindings { get: "/v2/{parent=folders/*}/sinks" }
-      additional_bindings { get: "/v2/{parent=billingAccounts/*}/sinks" }
+      additional_bindings {
+        get: "/v2/{parent=projects/*}/sinks"
+      }
+      additional_bindings {
+        get: "/v2/{parent=organizations/*}/sinks"
+      }
+      additional_bindings {
+        get: "/v2/{parent=folders/*}/sinks"
+      }
+      additional_bindings {
+        get: "/v2/{parent=billingAccounts/*}/sinks"
+      }
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets a sink.
   rpc GetSink(GetSinkRequest) returns (LogSink) {
     option (google.api.http) = {
       get: "/v2/{sink_name=*/*/sinks/*}"
-      additional_bindings { get: "/v2/{sink_name=projects/*/sinks/*}" }
-      additional_bindings { get: "/v2/{sink_name=organizations/*/sinks/*}" }
-      additional_bindings { get: "/v2/{sink_name=folders/*/sinks/*}" }
-      additional_bindings { get: "/v2/{sink_name=billingAccounts/*/sinks/*}" }
+      additional_bindings {
+        get: "/v2/{sink_name=projects/*/sinks/*}"
+      }
+      additional_bindings {
+        get: "/v2/{sink_name=organizations/*/sinks/*}"
+      }
+      additional_bindings {
+        get: "/v2/{sink_name=folders/*/sinks/*}"
+      }
+      additional_bindings {
+        get: "/v2/{sink_name=billingAccounts/*/sinks/*}"
+      }
     };
+    option (google.api.method_signature) = "sink_name";
   }
 
-  // Creates a sink that exports specified log entries to a destination.  The
+  // Creates a sink that exports specified log entries to a destination. The
   // export of newly-ingested log entries begins immediately, unless the sink's
-  // `writer_identity` is not permitted to write to the destination.  A sink can
+  // `writer_identity` is not permitted to write to the destination. A sink can
   // export log entries only from the resource owning the sink.
   rpc CreateSink(CreateSinkRequest) returns (LogSink) {
     option (google.api.http) = {
       post: "/v2/{parent=*/*}/sinks"
       body: "sink"
-      additional_bindings { post: "/v2/{parent=projects/*}/sinks" body: "sink" }
+      additional_bindings {
+        post: "/v2/{parent=projects/*}/sinks"
+        body: "sink"
+      }
       additional_bindings {
         post: "/v2/{parent=organizations/*}/sinks"
         body: "sink"
       }
-      additional_bindings { post: "/v2/{parent=folders/*}/sinks" body: "sink" }
+      additional_bindings {
+        post: "/v2/{parent=folders/*}/sinks"
+        body: "sink"
+      }
       additional_bindings {
         post: "/v2/{parent=billingAccounts/*}/sinks"
         body: "sink"
       }
     };
+    option (google.api.method_signature) = "parent,sink";
   }
 
-  // Updates a sink.  This method replaces the following fields in the existing
+  // Updates a sink. This method replaces the following fields in the existing
   // sink with values from the new sink: `destination`, and `filter`.
+  //
   // The updated sink might also have a new `writer_identity`; see the
   // `unique_writer_identity` field.
   rpc UpdateSink(UpdateSinkRequest) returns (LogSink) {
@@ -117,6 +237,8 @@ service ConfigServiceV2 {
         body: "sink"
       }
     };
+    option (google.api.method_signature) = "sink_name,sink,update_mask";
+    option (google.api.method_signature) = "sink_name,sink";
   }
 
   // Deletes a sink. If the sink has a unique `writer_identity`, then that
@@ -124,35 +246,60 @@ service ConfigServiceV2 {
   rpc DeleteSink(DeleteSinkRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v2/{sink_name=*/*/sinks/*}"
-      additional_bindings { delete: "/v2/{sink_name=projects/*/sinks/*}" }
-      additional_bindings { delete: "/v2/{sink_name=organizations/*/sinks/*}" }
-      additional_bindings { delete: "/v2/{sink_name=folders/*/sinks/*}" }
+      additional_bindings {
+        delete: "/v2/{sink_name=projects/*/sinks/*}"
+      }
+      additional_bindings {
+        delete: "/v2/{sink_name=organizations/*/sinks/*}"
+      }
+      additional_bindings {
+        delete: "/v2/{sink_name=folders/*/sinks/*}"
+      }
       additional_bindings {
         delete: "/v2/{sink_name=billingAccounts/*/sinks/*}"
       }
     };
+    option (google.api.method_signature) = "sink_name";
   }
 
   // Lists all the exclusions in a parent resource.
   rpc ListExclusions(ListExclusionsRequest) returns (ListExclusionsResponse) {
     option (google.api.http) = {
       get: "/v2/{parent=*/*}/exclusions"
-      additional_bindings { get: "/v2/{parent=projects/*}/exclusions" }
-      additional_bindings { get: "/v2/{parent=organizations/*}/exclusions" }
-      additional_bindings { get: "/v2/{parent=folders/*}/exclusions" }
-      additional_bindings { get: "/v2/{parent=billingAccounts/*}/exclusions" }
+      additional_bindings {
+        get: "/v2/{parent=projects/*}/exclusions"
+      }
+      additional_bindings {
+        get: "/v2/{parent=organizations/*}/exclusions"
+      }
+      additional_bindings {
+        get: "/v2/{parent=folders/*}/exclusions"
+      }
+      additional_bindings {
+        get: "/v2/{parent=billingAccounts/*}/exclusions"
+      }
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets the description of an exclusion.
   rpc GetExclusion(GetExclusionRequest) returns (LogExclusion) {
     option (google.api.http) = {
       get: "/v2/{name=*/*/exclusions/*}"
-      additional_bindings { get: "/v2/{name=projects/*/exclusions/*}" }
-      additional_bindings { get: "/v2/{name=organizations/*/exclusions/*}" }
-      additional_bindings { get: "/v2/{name=folders/*/exclusions/*}" }
-      additional_bindings { get: "/v2/{name=billingAccounts/*/exclusions/*}" }
+      additional_bindings {
+        get: "/v2/{name=projects/*/exclusions/*}"
+      }
+      additional_bindings {
+        get: "/v2/{name=organizations/*/exclusions/*}"
+      }
+      additional_bindings {
+        get: "/v2/{name=folders/*/exclusions/*}"
+      }
+      additional_bindings {
+        get: "/v2/{name=billingAccounts/*/exclusions/*}"
+      }
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates a new exclusion in a specified parent resource.
@@ -179,6 +326,7 @@ service ConfigServiceV2 {
         body: "exclusion"
       }
     };
+    option (google.api.method_signature) = "parent,exclusion";
   }
 
   // Changes one or more properties of an existing exclusion.
@@ -203,28 +351,128 @@ service ConfigServiceV2 {
         body: "exclusion"
       }
     };
+    option (google.api.method_signature) = "name,exclusion,update_mask";
   }
 
   // Deletes an exclusion.
   rpc DeleteExclusion(DeleteExclusionRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v2/{name=*/*/exclusions/*}"
-      additional_bindings { delete: "/v2/{name=projects/*/exclusions/*}" }
-      additional_bindings { delete: "/v2/{name=organizations/*/exclusions/*}" }
-      additional_bindings { delete: "/v2/{name=folders/*/exclusions/*}" }
+      additional_bindings {
+        delete: "/v2/{name=projects/*/exclusions/*}"
+      }
+      additional_bindings {
+        delete: "/v2/{name=organizations/*/exclusions/*}"
+      }
+      additional_bindings {
+        delete: "/v2/{name=folders/*/exclusions/*}"
+      }
       additional_bindings {
         delete: "/v2/{name=billingAccounts/*/exclusions/*}"
       }
     };
+    option (google.api.method_signature) = "name";
   }
+
+  // Gets the Logs Router CMEK settings for the given resource.
+  //
+  // Note: CMEK for the Logs Router can currently only be configured for GCP
+  // organizations. Once configured, it applies to all projects and folders in
+  // the GCP organization.
+  //
+  // See [Enabling CMEK for Logs
+  // Router](https://cloud.google.com/logging/docs/routing/managed-encryption) for more information.
+  rpc GetCmekSettings(GetCmekSettingsRequest) returns (CmekSettings) {
+    option (google.api.http) = {
+      get: "/v2/{name=*/*}/cmekSettings"
+      additional_bindings {
+        get: "/v2/{name=organizations/*}/cmekSettings"
+      }
+    };
+  }
+
+  // Updates the Logs Router CMEK settings for the given resource.
+  //
+  // Note: CMEK for the Logs Router can currently only be configured for GCP
+  // organizations. Once configured, it applies to all projects and folders in
+  // the GCP organization.
+  //
+  // [UpdateCmekSettings][google.logging.v2.ConfigServiceV2.UpdateCmekSettings]
+  // will fail if 1) `kms_key_name` is invalid, or 2) the associated service
+  // account does not have the required
+  // `roles/cloudkms.cryptoKeyEncrypterDecrypter` role assigned for the key, or
+  // 3) access to the key is disabled.
+  //
+  // See [Enabling CMEK for Logs
+  // Router](https://cloud.google.com/logging/docs/routing/managed-encryption) for more information.
+  rpc UpdateCmekSettings(UpdateCmekSettingsRequest) returns (CmekSettings) {
+    option (google.api.http) = {
+      patch: "/v2/{name=*/*}/cmekSettings"
+      body: "cmek_settings"
+      additional_bindings {
+        patch: "/v2/{name=organizations/*}/cmekSettings"
+        body: "cmek_settings"
+      }
+    };
+  }
+}
+
+// Describes a repository of logs (Beta).
+message LogBucket {
+  option (google.api.resource) = {
+    type: "logging.googleapis.com/LogBucket"
+    pattern: "projects/{project}/locations/{location}/buckets/{bucket}"
+    pattern: "organizations/{organization}/locations/{location}/buckets/{bucket}"
+    pattern: "folders/{folder}/locations/{location}/buckets/{bucket}"
+    pattern: "billingAccounts/{billing_account}/locations/{location}/buckets/{bucket}"
+  };
+
+  // The resource name of the bucket.
+  // For example:
+  // "projects/my-project-id/locations/my-location/buckets/my-bucket-id The
+  // supported locations are:
+  //   "global"
+  //   "us-central1"
+  //
+  // For the location of `global` it is unspecified where logs are actually
+  // stored.
+  // Once a bucket has been created, the location can not be changed.
+  string name = 1;
+
+  // Describes this bucket.
+  string description = 3;
+
+  // Output only. The creation timestamp of the bucket. This is not set for any of the
+  // default buckets.
+  google.protobuf.Timestamp create_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The last update timestamp of the bucket.
+  google.protobuf.Timestamp update_time = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Logs will be retained by default for this amount of time, after which they
+  // will automatically be deleted. The minimum retention period is 1 day.
+  // If this value is set to zero at bucket creation time, the default time of
+  // 30 days will be used.
+  int32 retention_days = 11;
+
+  // Output only. The bucket lifecycle state.
+  LifecycleState lifecycle_state = 12 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Describes a sink used to export log entries to one of the following
 // destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a
-// Cloud Pub/Sub topic.  A logs filter controls which log entries are
-// exported. The sink must be created within a project, organization, billing
-// account, or folder.
+// Cloud Pub/Sub topic. A logs filter controls which log entries are exported.
+// The sink must be created within a project, organization, billing account, or
+// folder.
 message LogSink {
+  option (google.api.resource) = {
+    type: "logging.googleapis.com/LogSink"
+    pattern: "projects/{project}/sinks/{sink}"
+    pattern: "organizations/{organization}/sinks/{sink}"
+    pattern: "folders/{folder}/sinks/{sink}"
+    pattern: "billingAccounts/{billing_account}/sinks/{sink}"
+  };
+
   // Available log entry formats. Log entries can be written to
   // Logging in either format and can be exported in either format.
   // Version 2 is the preferred format.
@@ -239,12 +487,12 @@ message LogSink {
     V1 = 2;
   }
 
-  // Required. The client-assigned sink identifier, unique within the
-  // project. Example: `"my-syslog-errors-to-pubsub"`.  Sink identifiers are
-  // limited to 100 characters and can include only the following characters:
-  // upper and lower-case alphanumeric characters, underscores, hyphens, and
-  // periods.
-  string name = 1;
+  // Required. The client-assigned sink identifier, unique within the project. Example:
+  // `"my-syslog-errors-to-pubsub"`. Sink identifiers are limited to 100
+  // characters and can include only the following characters: upper and
+  // lower-case alphanumeric characters, underscores, hyphens, and periods.
+  // First character has to be alphanumeric.
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Required. The export destination:
   //
@@ -254,37 +502,47 @@ message LogSink {
   //
   // The sink's `writer_identity`, set when the sink is created, must
   // have permission to write to the destination or else the log
-  // entries are not exported.  For more information, see
-  // [Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs).
-  string destination = 3;
+  // entries are not exported. For more information, see
+  // [Exporting Logs with Sinks](https://cloud.google.com/logging/docs/api/tasks/exporting-logs).
+  string destination = 3 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "*"
+    }
+  ];
 
-  // Optional.
-  // An [advanced logs filter](/logging/docs/view/advanced_filters).  The only
+  // Optional. An [advanced logs filter](https://cloud.google.com/logging/docs/view/advanced-queries). The only
   // exported log entries are those that are in the resource owning the sink and
-  // that match the filter.  For example:
+  // that match the filter. For example:
   //
   //     logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
-  string filter = 5;
+  string filter = 5 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A description of this sink.
+  // The maximum length of the description is 8000 characters.
+  string description = 18 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. If set to True, then this sink is disabled and it does not
+  // export any log entries.
+  bool disabled = 19 [(google.api.field_behavior) = OPTIONAL];
 
   // Deprecated. The log entry format to use for this sink's exported log
-  // entries.  The v2 format is used by default and cannot be changed.
+  // entries. The v2 format is used by default and cannot be changed.
   VersionFormat output_version_format = 6 [deprecated = true];
 
-  // Output only. An IAM identity—a service account or group—under
-  // which Logging writes the exported log entries to the sink's
-  // destination.  This field is set by
-  // [sinks.create](/logging/docs/api/reference/rest/v2/projects.sinks/create)
-  // and
-  // [sinks.update](/logging/docs/api/reference/rest/v2/projects.sinks/update),
-  // based on the setting of `unique_writer_identity` in those methods.
+  // Output only. An IAM identity–a service account or group—under which Logging
+  // writes the exported log entries to the sink's destination. This field is
+  // set by [sinks.create][google.logging.v2.ConfigServiceV2.CreateSink] and
+  // [sinks.update][google.logging.v2.ConfigServiceV2.UpdateSink] based on the
+  // value of `unique_writer_identity` in those methods.
   //
   // Until you grant this identity write-access to the destination, log entry
   // exports from this sink will fail. For more information,
-  // see [Granting access for a
-  // resource](/iam/docs/granting-roles-to-service-accounts#granting_access_to_a_service_account_for_a_resource).
+  // see [Granting Access for a
+  // Resource](https://cloud.google.com/iam/docs/granting-roles-to-service-accounts#granting_access_to_a_service_account_for_a_resource).
   // Consult the destination service's documentation to determine the
   // appropriate IAM roles to assign to the identity.
-  string writer_identity = 8;
+  string writer_identity = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Optional. This field applies only to sinks owned by organizations and
   // folders. If the field is false, the default, only the logs owned by the
@@ -299,13 +557,150 @@ message LogSink {
   //
   //     logName:("projects/test-project1/" OR "projects/test-project2/") AND
   //     resource.type=gce_instance
-  bool include_children = 9;
+  bool include_children = 9 [(google.api.field_behavior) = OPTIONAL];
+
+  // Destination dependent options.
+  oneof options {
+    // Optional. Options that affect sinks exporting data to BigQuery.
+    BigQueryOptions bigquery_options = 12 [(google.api.field_behavior) = OPTIONAL];
+  }
+
+  // Output only. The creation timestamp of the sink.
+  //
+  // This field may not be present for older sinks.
+  google.protobuf.Timestamp create_time = 13 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The last update timestamp of the sink.
+  //
+  // This field may not be present for older sinks.
+  google.protobuf.Timestamp update_time = 14 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// Options that change functionality of a sink exporting data to BigQuery.
+message BigQueryOptions {
+  // Optional. Whether to use [BigQuery's partition
+  // tables](https://cloud.google.com/bigquery/docs/partitioned-tables). By default, Logging
+  // creates dated tables based on the log entries' timestamps, e.g.
+  // syslog_20170523. With partitioned tables the date suffix is no longer
+  // present and [special query
+  // syntax](https://cloud.google.com/bigquery/docs/querying-partitioned-tables) has to be used instead.
+  // In both cases, tables are sharded based on UTC timezone.
+  bool use_partitioned_tables = 1 [(google.api.field_behavior) = OPTIONAL];
+
+  // Output only. True if new timestamp column based partitioning is in use,
+  // false if legacy ingestion-time partitioning is in use.
+  // All new sinks will have this field set true and will use timestamp column
+  // based partitioning. If use_partitioned_tables is false, this value has no
+  // meaning and will be false. Legacy sinks using partitioned tables will have
+  // this field set to false.
+  bool uses_timestamp_column_partitioning = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// LogBucket lifecycle states (Beta).
+enum LifecycleState {
+  // Unspecified state.  This is only used/useful for distinguishing
+  // unset values.
+  LIFECYCLE_STATE_UNSPECIFIED = 0;
+
+  // The normal and active state.
+  ACTIVE = 1;
+
+  // The bucket has been marked for deletion by the user.
+  DELETE_REQUESTED = 2;
+}
+
+// The parameters to `ListBuckets` (Beta).
+message ListBucketsRequest {
+  // Required. The parent resource whose buckets are to be listed:
+  //
+  //     "projects/[PROJECT_ID]/locations/[LOCATION_ID]"
+  //     "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]"
+  //     "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]"
+  //     "folders/[FOLDER_ID]/locations/[LOCATION_ID]"
+  //
+  // Note: The locations portion of the resource must be specified, but
+  // supplying the character `-` in place of [LOCATION_ID] will return all
+  // buckets.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "logging.googleapis.com/LogBucket"
+    }];
+
+  // Optional. If present, then retrieve the next batch of results from the
+  // preceding call to this method. `pageToken` must be the value of
+  // `nextPageToken` from the previous response. The values of other method
+  // parameters should be identical to those in the previous call.
+  string page_token = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The maximum number of results to return from this request.
+  // Non-positive values are ignored. The presence of `nextPageToken` in the
+  // response indicates that more results might be available.
+  int32 page_size = 3 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// The response from ListBuckets (Beta).
+message ListBucketsResponse {
+  // A list of buckets.
+  repeated LogBucket buckets = 1;
+
+  // If there might be more results than appear in this response, then
+  // `nextPageToken` is included. To get the next set of results, call the same
+  // method again using the value of `nextPageToken` as `pageToken`.
+  string next_page_token = 2;
+}
+
+// The parameters to `UpdateBucket` (Beta).
+message UpdateBucketRequest {
+  // Required. The full resource name of the bucket to update.
+  //
+  //     "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
+  //     "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
+  //     "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
+  //     "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
+  //
+  // Example:
+  // `"projects/my-project-id/locations/my-location/buckets/my-bucket-id"`. Also
+  // requires permission "resourcemanager.projects.updateLiens" to set the
+  // locked property
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "logging.googleapis.com/LogBucket"
+    }
+  ];
 
-  // Deprecated. This field is ignored when creating or updating sinks.
-  google.protobuf.Timestamp start_time = 10 [deprecated = true];
+  // Required. The updated bucket.
+  LogBucket bucket = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Deprecated. This field is ignored when creating or updating sinks.
-  google.protobuf.Timestamp end_time = 11 [deprecated = true];
+  // Required. Field mask that specifies the fields in `bucket` that need an update. A
+  // bucket field will be overwritten if, and only if, it is in the update
+  // mask. `name` and output only fields cannot be updated.
+  //
+  // For a detailed `FieldMask` definition, see
+  // https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask
+  //
+  // Example: `updateMask=retention_days`.
+  google.protobuf.FieldMask update_mask = 4 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The parameters to `GetBucket` (Beta).
+message GetBucketRequest {
+  // Required. The resource name of the bucket:
+  //
+  //     "projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
+  //     "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
+  //     "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
+  //     "folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]"
+  //
+  // Example:
+  // `"projects/my-project-id/locations/my-location/buckets/my-bucket-id"`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "logging.googleapis.com/LogBucket"
+    }
+  ];
 }
 
 // The parameters to `ListSinks`.
@@ -316,18 +711,23 @@ message ListSinksRequest {
   //     "organizations/[ORGANIZATION_ID]"
   //     "billingAccounts/[BILLING_ACCOUNT_ID]"
   //     "folders/[FOLDER_ID]"
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "logging.googleapis.com/LogSink"
+    }
+  ];
 
   // Optional. If present, then retrieve the next batch of results from the
-  // preceding call to this method.  `pageToken` must be the value of
-  // `nextPageToken` from the previous response.  The values of other method
+  // preceding call to this method. `pageToken` must be the value of
+  // `nextPageToken` from the previous response. The values of other method
   // parameters should be identical to those in the previous call.
-  string page_token = 2;
+  string page_token = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The maximum number of results to return from this request.
-  // Non-positive values are ignored.  The presence of `nextPageToken` in the
+  // Non-positive values are ignored. The presence of `nextPageToken` in the
   // response indicates that more results might be available.
-  int32 page_size = 3;
+  int32 page_size = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Result returned from `ListSinks`.
@@ -336,7 +736,7 @@ message ListSinksResponse {
   repeated LogSink sinks = 1;
 
   // If there might be more results than appear in this response, then
-  // `nextPageToken` is included.  To get the next set of results, call the same
+  // `nextPageToken` is included. To get the next set of results, call the same
   // method again using the value of `nextPageToken` as `pageToken`.
   string next_page_token = 2;
 }
@@ -351,7 +751,12 @@ message GetSinkRequest {
   //     "folders/[FOLDER_ID]/sinks/[SINK_ID]"
   //
   // Example: `"projects/my-project-id/sinks/my-sink-id"`.
-  string sink_name = 1;
+  string sink_name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "logging.googleapis.com/LogSink"
+    }
+  ];
 }
 
 // The parameters to `CreateSink`.
@@ -364,31 +769,35 @@ message CreateSinkRequest {
   //     "folders/[FOLDER_ID]"
   //
   // Examples: `"projects/my-logging-project"`, `"organizations/123456789"`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "logging.googleapis.com/LogSink"
+    }
+  ];
 
   // Required. The new sink, whose `name` parameter is a sink identifier that
   // is not already in use.
-  LogSink sink = 2;
+  LogSink sink = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Optional. Determines the kind of IAM identity returned as `writer_identity`
-  // in the new sink.  If this value is omitted or set to false, and if the
+  // in the new sink. If this value is omitted or set to false, and if the
   // sink's parent is a project, then the value returned as `writer_identity` is
-  // the same group or service account used by Logging before the
-  // addition of writer identities to this API. The sink's destination must be
-  // in the same project as the sink itself.
+  // the same group or service account used by Logging before the addition of
+  // writer identities to this API. The sink's destination must be in the same
+  // project as the sink itself.
   //
   // If this field is set to true, or if the sink is owned by a non-project
   // resource such as an organization, then the value of `writer_identity` will
-  // be a unique service account used only for exports from the new sink.  For
-  // more information, see `writer_identity` in
-  // [LogSink][google.logging.v2.LogSink].
-  bool unique_writer_identity = 3;
+  // be a unique service account used only for exports from the new sink. For
+  // more information, see `writer_identity` in [LogSink][google.logging.v2.LogSink].
+  bool unique_writer_identity = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // The parameters to `UpdateSink`.
 message UpdateSinkRequest {
-  // Required. The full resource name of the sink to update, including the
-  // parent resource and the sink identifier:
+  // Required. The full resource name of the sink to update, including the parent
+  // resource and the sink identifier:
   //
   //     "projects/[PROJECT_ID]/sinks/[SINK_ID]"
   //     "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
@@ -396,15 +805,19 @@ message UpdateSinkRequest {
   //     "folders/[FOLDER_ID]/sinks/[SINK_ID]"
   //
   // Example: `"projects/my-project-id/sinks/my-sink-id"`.
-  string sink_name = 1;
+  string sink_name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "logging.googleapis.com/LogSink"
+    }
+  ];
 
-  // Required. The updated sink, whose name is the same identifier that appears
-  // as part of `sink_name`.
-  LogSink sink = 2;
+  // Required. The updated sink, whose name is the same identifier that appears as part
+  // of `sink_name`.
+  LogSink sink = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional. See
-  // [sinks.create](/logging/docs/api/reference/rest/v2/projects.sinks/create)
-  // for a description of this field.  When updating a sink, the effect of this
+  // Optional. See [sinks.create][google.logging.v2.ConfigServiceV2.CreateSink]
+  // for a description of this field. When updating a sink, the effect of this
   // field on the value of `writer_identity` in the updated sink depends on both
   // the old and new values of this field:
   //
@@ -414,11 +827,11 @@ message UpdateSinkRequest {
   //     `writer_identity` is changed to a unique service account.
   // +   It is an error if the old value is true and the new value is
   //     set to false or defaulted to false.
-  bool unique_writer_identity = 3;
+  bool unique_writer_identity = 3 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Field mask that specifies the fields in `sink` that need
   // an update. A sink field will be overwritten if, and only if, it is
-  // in the update mask.  `name` and output only fields cannot be updated.
+  // in the update mask. `name` and output only fields cannot be updated.
   //
   // An empty updateMask is temporarily treated as using the following mask
   // for backwards compatibility purposes:
@@ -430,13 +843,13 @@ message UpdateSinkRequest {
   // https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask
   //
   // Example: `updateMask=filter`.
-  google.protobuf.FieldMask update_mask = 4;
+  google.protobuf.FieldMask update_mask = 4 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // The parameters to `DeleteSink`.
 message DeleteSinkRequest {
-  // Required. The full resource name of the sink to delete, including the
-  // parent resource and the sink identifier:
+  // Required. The full resource name of the sink to delete, including the parent
+  // resource and the sink identifier:
   //
   //     "projects/[PROJECT_ID]/sinks/[SINK_ID]"
   //     "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
@@ -444,40 +857,63 @@ message DeleteSinkRequest {
   //     "folders/[FOLDER_ID]/sinks/[SINK_ID]"
   //
   // Example: `"projects/my-project-id/sinks/my-sink-id"`.
-  string sink_name = 1;
+  string sink_name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "logging.googleapis.com/LogSink"
+    }
+  ];
 }
 
 // Specifies a set of log entries that are not to be stored in
-// Logging. If your project receives a large volume of logs, you might be able
-// to use exclusions to reduce your chargeable logs. Exclusions are processed
-// after log sinks, so you can export log entries before they are excluded.
-// Audit log entries and log entries from Amazon Web Services are never
-// excluded.
+// Logging. If your GCP resource receives a large volume of logs, you can
+// use exclusions to reduce your chargeable logs. Exclusions are
+// processed after log sinks, so you can export log entries before they are
+// excluded. Note that organization-level and folder-level exclusions don't
+// apply to child resources, and that you can't exclude audit log entries.
 message LogExclusion {
-  // Required. A client-assigned identifier, such as
-  // `"load-balancer-exclusion"`. Identifiers are limited to 100 characters and
-  // can include only letters, digits, underscores, hyphens, and periods.
-  string name = 1;
+  option (google.api.resource) = {
+    type: "logging.googleapis.com/LogExclusion"
+    pattern: "projects/{project}/exclusions/{exclusion}"
+    pattern: "organizations/{organization}/exclusions/{exclusion}"
+    pattern: "folders/{folder}/exclusions/{exclusion}"
+    pattern: "billingAccounts/{billing_account}/exclusions/{exclusion}"
+  };
+
+  // Required. A client-assigned identifier, such as `"load-balancer-exclusion"`.
+  // Identifiers are limited to 100 characters and can include only letters,
+  // digits, underscores, hyphens, and periods. First character has to be
+  // alphanumeric.
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Optional. A description of this exclusion.
-  string description = 2;
+  string description = 2 [(google.api.field_behavior) = OPTIONAL];
 
-  // Required.
-  // An [advanced logs filter](/logging/docs/view/advanced_filters)
+  // Required. An [advanced logs filter](https://cloud.google.com/logging/docs/view/advanced-queries)
   // that matches the log entries to be excluded. By using the
-  // [sample function](/logging/docs/view/advanced_filters#sample),
+  // [sample function](https://cloud.google.com/logging/docs/view/advanced-queries#sample),
   // you can exclude less than 100% of the matching log entries.
-  // For example, the following filter matches 99% of low-severity log
-  // entries from load balancers:
+  // For example, the following query matches 99% of low-severity log
+  // entries from Google Cloud Storage buckets:
   //
-  // `"resource.type=http_load_balancer severity=ERROR"
   //
   // The maximum length of the filter is 20000 characters.
-  string filter = 3;
+  string filter = 3 [(google.api.field_behavior) = REQUIRED];
 
   // Optional. The metric descriptor associated with the logs-based metric.
   // If unspecified, it uses a default metric descriptor with a DELTA metric
@@ -139,7 +159,7 @@ message LogMetric {
   // be updated once initially configured. New labels can be added in the
   // `metric_descriptor`, but existing labels cannot be modified except for
   // their description.
-  google.api.MetricDescriptor metric_descriptor = 5;
+  google.api.MetricDescriptor metric_descriptor = 5 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. A `value_extractor` is required when using a distribution
   // logs-based metric to extract the values to record from a log entry.
@@ -160,7 +180,7 @@ message LogMetric {
   // distribution.
   //
   // Example: `REGEXP_EXTRACT(jsonPayload.request, ".*quantity=(\d+).*")`
-  string value_extractor = 6;
+  string value_extractor = 6 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. A map from a label key string to an extractor expression which is
   // used to extract data from a log entry field and assign as the label value.
@@ -176,12 +196,22 @@ message LogMetric {
   //
   // Note that there are upper bounds on the maximum number of labels and the
   // number of active time series that are allowed in a project.
-  map label_extractors = 7;
+  map label_extractors = 7 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The `bucket_options` are required when the logs-based metric is
   // using a DISTRIBUTION value type and it describes the bucket boundaries
   // used to create a histogram of the extracted values.
-  google.api.Distribution.BucketOptions bucket_options = 8;
+  google.api.Distribution.BucketOptions bucket_options = 8 [(google.api.field_behavior) = OPTIONAL];
+
+  // Output only. The creation timestamp of the metric.
+  //
+  // This field may not be present for older metrics.
+  google.protobuf.Timestamp create_time = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The last update timestamp of the metric.
+  //
+  // This field may not be present for older metrics.
+  google.protobuf.Timestamp update_time = 10 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Deprecated. The API version that created or updated this metric.
   // The v2 format is used by default and cannot be changed.
@@ -193,18 +223,23 @@ message ListLogMetricsRequest {
   // Required. The name of the project containing the metrics:
   //
   //     "projects/[PROJECT_ID]"
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
   // Optional. If present, then retrieve the next batch of results from the
-  // preceding call to this method.  `pageToken` must be the value of
-  // `nextPageToken` from the previous response.  The values of other method
+  // preceding call to this method. `pageToken` must be the value of
+  // `nextPageToken` from the previous response. The values of other method
   // parameters should be identical to those in the previous call.
-  string page_token = 2;
+  string page_token = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The maximum number of results to return from this request.
-  // Non-positive values are ignored.  The presence of `nextPageToken` in the
+  // Non-positive values are ignored. The presence of `nextPageToken` in the
   // response indicates that more results might be available.
-  int32 page_size = 3;
+  int32 page_size = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Result returned from ListLogMetrics.
@@ -213,52 +248,72 @@ message ListLogMetricsResponse {
   repeated LogMetric metrics = 1;
 
   // If there might be more results than appear in this response, then
-  // `nextPageToken` is included.  To get the next set of results, call this
+  // `nextPageToken` is included. To get the next set of results, call this
   // method again using the value of `nextPageToken` as `pageToken`.
   string next_page_token = 2;
 }
 
 // The parameters to GetLogMetric.
 message GetLogMetricRequest {
-  // The resource name of the desired metric:
+  // Required. The resource name of the desired metric:
   //
   //     "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
-  string metric_name = 1;
+  string metric_name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "logging.googleapis.com/LogMetric"
+    }
+  ];
 }
 
 // The parameters to CreateLogMetric.
 message CreateLogMetricRequest {
-  // The resource name of the project in which to create the metric:
+  // Required. The resource name of the project in which to create the metric:
   //
   //     "projects/[PROJECT_ID]"
   //
   // The new metric must be provided in the request.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "logging.googleapis.com/LogMetric"
+    }
+  ];
 
-  // The new logs-based metric, which must not have an identifier that
+  // Required. The new logs-based metric, which must not have an identifier that
   // already exists.
-  LogMetric metric = 2;
+  LogMetric metric = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The parameters to UpdateLogMetric.
 message UpdateLogMetricRequest {
-  // The resource name of the metric to update:
+  // Required. The resource name of the metric to update:
   //
   //     "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
   //
   // The updated metric must be provided in the request and it's
   // `name` field must be the same as `[METRIC_ID]` If the metric
   // does not exist in `[PROJECT_ID]`, then a new metric is created.
-  string metric_name = 1;
+  string metric_name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "logging.googleapis.com/LogMetric"
+    }
+  ];
 
-  // The updated metric.
-  LogMetric metric = 2;
+  // Required. The updated metric.
+  LogMetric metric = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The parameters to DeleteLogMetric.
 message DeleteLogMetricRequest {
-  // The resource name of the metric to delete:
+  // Required. The resource name of the metric to delete:
   //
   //     "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
-  string metric_name = 1;
+  string metric_name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "logging.googleapis.com/LogMetric"
+    }
+  ];
 }
diff --git a/third_party/googleapis/google/longrunning/BUILD.bazel b/third_party/googleapis/google/longrunning/BUILD.bazel
index c9d7ff4ed..2ae3ccff0 100644
--- a/third_party/googleapis/google/longrunning/BUILD.bazel
+++ b/third_party/googleapis/google/longrunning/BUILD.bazel
@@ -1,3 +1,5 @@
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
@@ -11,6 +13,7 @@ proto_library(
     srcs = ["operations.proto"],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
         "//google/rpc:status_proto",
         "@com_google_protobuf//:any_proto",
         "@com_google_protobuf//:descriptor_proto",
@@ -27,7 +30,7 @@ proto_library_with_info(
 ##############################################################################
 # Java
 ##############################################################################
-load("@com_google_googleapis_imports//:imports.bzl", "java_proto_library", "java_grpc_library")
+load("@com_google_googleapis_imports//:imports.bzl", "java_grpc_library", "java_proto_library")
 
 java_proto_library(
     name = "longrunning_java_proto",
@@ -45,10 +48,10 @@ java_grpc_library(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -65,9 +68,9 @@ go_proto_library(
 
 go_gapic_library(
     name = "longrunning_go_gapic",
-    src = ":longrunning_proto_with_info",
-    gapic_yaml = "longrunning_gapic.yaml",
-    importpath = "cloud.google.com/go/longrunning/autogen",
+    srcs = [":longrunning_proto_with_info"],
+    grpc_service_config = "longrunning_grpc_service_config.json",
+    importpath = "cloud.google.com/go/longrunning/autogen;longrunning",
     service_yaml = "//google/longrunning:longrunning.yaml",
     deps = [":longrunning_go_proto"],
 )
@@ -79,12 +82,11 @@ go_test(
     importpath = "cloud.google.com/go/longrunning/autogen",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-longrunning-go",
     deps = [
         ":longrunning_go_gapic",
-        ":longrunning_go_gapic_srcjar-smoke-test.srcjar",
         ":longrunning_go_gapic_srcjar-test.srcjar",
         ":longrunning_go_proto",
     ],
@@ -107,6 +109,6 @@ cc_proto_library(
 cc_grpc_library(
     name = "longrunning_cc_grpc",
     srcs = [":operations_proto"],
-    deps = [":longrunning_cc_proto"],
     grpc_only = True,
+    deps = [":longrunning_cc_proto"],
 )
diff --git a/third_party/googleapis/google/longrunning/artman_longrunning.yaml b/third_party/googleapis/google/longrunning/artman_longrunning.yaml
index ddda18b02..1b93f4510 100644
--- a/third_party/googleapis/google/longrunning/artman_longrunning.yaml
+++ b/third_party/googleapis/google/longrunning/artman_longrunning.yaml
@@ -8,6 +8,7 @@ common:
   - .
   proto_deps:
   - name: google-common-protos
+  proto_package: google.longrunning
 artifacts:
 - name: java_gapic
   type: GAPIC_ONLY
diff --git a/third_party/googleapis/google/longrunning/longrunning.yaml b/third_party/googleapis/google/longrunning/longrunning.yaml
index ff8fccf06..ffb6bf3b0 100644
--- a/third_party/googleapis/google/longrunning/longrunning.yaml
+++ b/third_party/googleapis/google/longrunning/longrunning.yaml
@@ -4,10 +4,10 @@ name: longrunning.googleapis.com
 title: Long Running Operations API
 
 apis:
-  - name: google.longrunning.Operations
+- name: google.longrunning.Operations
 
 types:
-  - name: google.longrunning.OperationInfo
+- name: google.longrunning.OperationInfo
 
 documentation:
   overview: |-
@@ -20,11 +20,11 @@ documentation:
     ## What are Long Running Operations?
 
     A Long Running Operation (LRO) is a way of representing an action that may
-    take a significant amount of time to complete. For example, an API call that
-    starts exporting a large amount of data could take quite a while to complete
-    and is therefore best represented as an LRO. A common rule of thumb is to
-    think of LROs as "API promises" that represent the result of some on-going
-    action.
+    take a significant amount of time to complete. For example, an API call
+    that starts exporting a large amount of data could take quite a while to
+    complete and is therefore best represented as an LRO. A common rule of
+    thumb is to think of LROs as "API promises" that represent the result of
+    some on-going action.
 
     ## Using LROs
 
@@ -32,31 +32,33 @@ documentation:
     should return a long running operation instead of a direct response. This
     means that even if there are situations where the response could be
     immediate, the API should still return an LRO -- it just may be already
-    marked as completed. For example, if a data export operation is called on an
-    empty resource, the operation itself may be possible to execute immediately,
-    and would result in an already completed LRO.
+    marked as completed.
+    For example, if a data export operation is called on an empty resource,
+    the operation itself may be possible to execute immediately, and would
+    result in an already completed LRO.
 
-    Additionally, the operation should be managed using the LRO interface, which
-    allows clients to poll the operation for status updates or cancel it
+    Additionally, the operation should be managed using the LRO interface,
+    which allows clients to poll the operation for status updates or cancel it
     entirely.
 
     Finally, an LRO represents an action and as a result, the operation is not
     created directly. Instead, the operation comes into existence as a
     side-effect of the action it represents. For example, an RPC called
-    `ExportData` would create and return an LRO. This means that there should
-    never be an RPC called `CreateOperation`.
+    `ExportData` would
+    create and return an LRO. This means that there should never be an RPC
+    called `CreateOperation`.
 
     This also means that any permissions on the operation would be based on
     action it represents. Any immediate side effects of starting the operation
-    must be visible in the service as soon as the LRO is returned. For example,
-    if an LRO is returned when creating a resource, that resource should be
-    visible in the API immediately, but be in a non-final state until the LRO is
-    completed.
+    must be visible in the service as soon as the LRO is returned. For
+    example, if an LRO is returned when creating a resource, that resource
+    should be visible in the API immediately, but be in a non-final state
+    until the LRO is completed.
 
     ## LROs versus Jobs
 
-    A job is a common design pattern often used in data processing that tends to
-    be used to represent some contained piece of work that would be stored,
+    A job is a common design pattern often used in data processing that tends
+    to be used to represent some contained piece of work that would be stored,
     re-run, and modified over time. Jobs also typically interact with multiple
     resources and are created, deleted, and updated directly as independent
     resources.
@@ -67,6 +69,6 @@ documentation:
 
     In general, if an action may take a while but it represents a single piece
     of work, it's best to represent the response as an LRO. If the action is
-    something more complex (for example, it involves lots of resources and can't
-    be created as a byproduct of a single action), it may make more sense to
-    represent it as a job.
+    something more complex (for example, it involves lots of resources and
+    can't be created as a byproduct of a single action), it may make more
+    sense to represent it as a job.
diff --git a/third_party/googleapis/google/longrunning/longrunning_gapic.legacy.yaml b/third_party/googleapis/google/longrunning/longrunning_gapic.legacy.yaml
new file mode 100644
index 000000000..acd110f63
--- /dev/null
+++ b/third_party/googleapis/google/longrunning/longrunning_gapic.legacy.yaml
@@ -0,0 +1,100 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.longrunning
+  python:
+    package_name: google.longrunning.gapic
+  go:
+    package_name: cloud.google.com/go/longrunning/autogen
+    domain_layer_location: cloud.google.com/go/longrunning
+  csharp:
+    package_name: Google.LongRunning
+  ruby:
+    package_name: Google::Longrunning
+  php:
+    package_name: Google\ApiCore\LongRunning
+  nodejs:
+    package_name: longrunning
+interfaces:
+- name: google.longrunning.Operations
+  required_constructor_params:
+  - service_address
+  - scopes
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 90000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 90000
+    total_timeout_millis: 600000
+  methods:
+  - name: GetOperation
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: ListOperations
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - filter
+    required_fields:
+    - name
+    - filter
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: operations
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: CancelOperation
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: DeleteOperation
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: WaitOperation
+    surface_treatments:
+    - include_languages:
+      - go
+      - java
+      - csharp
+      - ruby
+      - nodejs
+      - python
+      - php
+      visibility: DISABLED
diff --git a/third_party/googleapis/google/longrunning/longrunning_gapic.yaml b/third_party/googleapis/google/longrunning/longrunning_gapic.yaml
index acd110f63..ce7fbf4aa 100644
--- a/third_party/googleapis/google/longrunning/longrunning_gapic.yaml
+++ b/third_party/googleapis/google/longrunning/longrunning_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.longrunning
@@ -21,13 +21,6 @@ interfaces:
   required_constructor_params:
   - service_address
   - scopes
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 100
@@ -39,54 +32,15 @@ interfaces:
     total_timeout_millis: 600000
   methods:
   - name: GetOperation
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
   - name: ListOperations
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - filter
-    required_fields:
-    - name
-    - filter
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: operations
-    retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
   - name: CancelOperation
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
   - name: DeleteOperation
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
     retry_codes_name: idempotent
     retry_params_name: default
-    timeout_millis: 60000
   - name: WaitOperation
     surface_treatments:
     - include_languages:
diff --git a/third_party/googleapis/google/longrunning/longrunning_grpc_service_config.json b/third_party/googleapis/google/longrunning/longrunning_grpc_service_config.json
new file mode 100644
index 000000000..a5a9ae95d
--- /dev/null
+++ b/third_party/googleapis/google/longrunning/longrunning_grpc_service_config.json
@@ -0,0 +1,34 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.longrunning.Operations",
+          "method": "GetOperation"
+        },
+        {
+          "service": "google.longrunning.Operations",
+          "method": "ListOperations"
+        },
+        {
+          "service": "google.longrunning.Operations",
+          "method": "CancelOperation"
+        },
+        {
+          "service": "google.longrunning.Operations",
+          "method": "DeleteOperation"
+        }
+      ],
+      "timeout": "10s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.5s",
+        "maxBackoff": "10s",
+        "backoffMultiplier": 2.0,
+        "retryableStatusCodes": [
+          "UNAVAILABLE"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/longrunning/operations.proto b/third_party/googleapis/google/longrunning/operations.proto
index 90778e03e..299eefb2e 100644
--- a/third_party/googleapis/google/longrunning/operations.proto
+++ b/third_party/googleapis/google/longrunning/operations.proto
@@ -11,13 +11,13 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.longrunning;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
 import "google/protobuf/any.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/empty.proto";
@@ -52,6 +52,8 @@ extend google.protobuf.MethodOptions {
 // returns long-running operations should implement the `Operations` interface
 // so developers can have a consistent client experience.
 service Operations {
+  option (google.api.default_host) = "longrunning.googleapis.com";
+
   // Lists operations that match the specified filter in the request. If the
   // server doesn't support this method, it returns `UNIMPLEMENTED`.
   //
@@ -66,6 +68,7 @@ service Operations {
     option (google.api.http) = {
       get: "/v1/{name=operations}"
     };
+    option (google.api.method_signature) = "name,filter";
   }
 
   // Gets the latest state of a long-running operation.  Clients can use this
@@ -75,6 +78,7 @@ service Operations {
     option (google.api.http) = {
       get: "/v1/{name=operations/**}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Deletes a long-running operation. This method indicates that the client is
@@ -85,6 +89,7 @@ service Operations {
     option (google.api.http) = {
       delete: "/v1/{name=operations/**}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Starts asynchronous cancellation on a long-running operation.  The server
@@ -102,6 +107,7 @@ service Operations {
       post: "/v1/{name=operations/**}:cancel"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Waits for the specified long-running operation until it is done or reaches
@@ -122,7 +128,7 @@ service Operations {
 message Operation {
   // The server-assigned name, which is only unique within the same service that
   // originally returns it. If you use the default HTTP mapping, the
-  // `name` should have the format of `operations/some/unique/name`.
+  // `name` should be a resource name ending with `operations/{unique_id}`.
   string name = 1;
 
   // Service-specific metadata associated with the operation.  It typically
diff --git a/third_party/googleapis/google/maps/BUILD.bazel b/third_party/googleapis/google/maps/BUILD.bazel
new file mode 100644
index 000000000..d796eca1d
--- /dev/null
+++ b/third_party/googleapis/google/maps/BUILD.bazel
@@ -0,0 +1,11 @@
+package(default_visibility = ["//google/maps:__subpackages__"])
+
+sh_binary(
+    name = "postprocessing_java",
+    srcs = ["postprocessing_java.sh"],
+)
+
+sh_binary(
+    name = "postprocessing_py",
+    srcs = ["postprocessing_py.sh"],
+)
diff --git a/third_party/googleapis/google/maps/playablelocations/v3/playablelocations.proto b/third_party/googleapis/google/maps/playablelocations/v3/playablelocations.proto
new file mode 100644
index 000000000..1f3328edd
--- /dev/null
+++ b/third_party/googleapis/google/maps/playablelocations/v3/playablelocations.proto
@@ -0,0 +1,178 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.maps.playablelocations.v3;
+
+import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/maps/playablelocations/v3/resources.proto";
+import "google/maps/playablelocations/v3/sample/resources.proto";
+import "google/maps/unity/clientinfo.proto";
+import "google/protobuf/duration.proto";
+import "google/api/client.proto";
+
+option csharp_namespace = "Google.Maps.PlayableLocations.V3";
+option go_package = "google.golang.org/genproto/googleapis/maps/playablelocations/v3;playablelocations";
+option java_multiple_files = true;
+option java_outer_classname = "PlayableLocationsProto";
+option java_package = "com.google.maps.playablelocations.v3";
+option objc_class_prefix = "GMPL";
+
+// The Playable Locations API for v3.
+service PlayableLocations {
+  option (google.api.default_host) = "playablelocations.googleapis.com";
+
+  // Returns a set of playable locations that lie within a specified area,
+  // that satisfy optional filter criteria.
+  //
+  // Note: Identical `SamplePlayableLocations` requests can return different
+  // results as the state of the world changes over time.
+  rpc SamplePlayableLocations(SamplePlayableLocationsRequest) returns (SamplePlayableLocationsResponse) {
+    option (google.api.http) = {
+      post: "/v3:samplePlayableLocations"
+      body: "*"
+    };
+  }
+
+  // Logs bad playable location reports submitted by players.
+  //
+  // Reports are not partially saved; either all reports are saved and this
+  // request succeeds, or no reports are saved, and this request fails.
+  rpc LogPlayerReports(LogPlayerReportsRequest) returns (LogPlayerReportsResponse) {
+    option (google.api.http) = {
+      post: "/v3:logPlayerReports"
+      body: "*"
+    };
+  }
+
+  // Logs new events when playable locations are displayed, and when they are
+  // interacted with.
+  //
+  // Impressions are not partially saved; either all impressions are saved and
+  // this request succeeds, or no impressions are saved, and this request fails.
+  rpc LogImpressions(LogImpressionsRequest) returns (LogImpressionsResponse) {
+    option (google.api.http) = {
+      post: "/v3:logImpressions"
+      body: "*"
+    };
+  }
+}
+
+//
+// Life of a query:
+//
+// - When a game starts in a new location, your game server issues a
+// [SamplePlayableLocations][google.maps.playablelocations.v3.PlayableLocations.SamplePlayableLocations]
+// request. The request specifies the S2 cell, and contains one or more
+// "criteria" for filtering:
+//
+// - Criterion 0: i locations for long-lived bases, or level 0 monsters, or...
+// - Criterion 1: j locations for short-lived bases, or level 1 monsters, ...
+// - Criterion 2: k locations for random objects.
+// - etc (up to 5 criterion may be specified).
+//
+// `PlayableLocationList` will then contain mutually
+// exclusive lists of `PlayableLocation` objects that satisfy each of
+// the criteria. Think of it as a collection of real-world locations that you
+// can then associate with your game state.
+//
+// Note: These points are impermanent in nature. E.g, parks can close, and
+// places can be removed.
+//
+// The response specifies how long you can expect the playable locations to
+// last. Once they expire, you should query the `samplePlayableLocations` API
+// again to get a fresh view of the real world.
+message SamplePlayableLocationsRequest {
+  // Required. Specifies the area to search within for playable locations.
+  google.maps.playablelocations.v3.sample.AreaFilter area_filter = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Specifies one or more (up to 5) criteria for filtering the
+  // returned playable locations.
+  repeated google.maps.playablelocations.v3.sample.Criterion criteria = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+//
+// Response for the
+// [SamplePlayableLocations][google.maps.playablelocations.v3.PlayableLocations.SamplePlayableLocations]
+// method.
+message SamplePlayableLocationsResponse {
+  // Each PlayableLocation object corresponds to a game_object_type specified
+  // in the request.
+  map locations_per_game_object_type = 1;
+
+  // Required. Specifies the "time-to-live" for the set of playable locations. You can use
+  // this value to determine how long to cache the set of playable locations.
+  // After this length of time, your back-end game server should issue a new
+  // [SamplePlayableLocations][google.maps.playablelocations.v3.PlayableLocations.SamplePlayableLocations]
+  // request to get a fresh set of playable locations (because for example, they
+  // might have been removed, a park might have closed for the day, a
+  // business might have closed permanently).
+  google.protobuf.Duration ttl = 9;
+}
+
+// A request for logging your player's bad location reports.
+message LogPlayerReportsRequest {
+  // Required. Player reports. The maximum number of player reports that you can log at
+  // once is 50.
+  repeated PlayerReport player_reports = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. A string that uniquely identifies the log player reports request. This
+  // allows you to detect duplicate requests. We recommend that you use UUIDs
+  // for this value. The value must not exceed 50 characters.
+  //
+  // You should reuse the `request_id` only when retrying a request in the case
+  // of a failure. In that case, the request must be identical to the one that
+  // failed.
+  string request_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Information about the client device (for example, device model and
+  // operating system).
+  google.maps.unity.ClientInfo client_info = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// A response for the [LogPlayerReports][google.maps.playablelocations.v3.PlayableLocations.LogPlayerReports]
+// method.
+//
+// This method returns no data upon success.
+message LogPlayerReportsResponse {
+
+}
+
+// A request for logging impressions.
+message LogImpressionsRequest {
+  // Required. Impression event details. The maximum number of impression reports that you
+  // can log at once is 50.
+  repeated Impression impressions = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. A string that uniquely identifies the log impressions request. This allows
+  // you to detect duplicate requests. We recommend that you use UUIDs for this
+  // value. The value must not exceed 50 characters.
+  //
+  // You should reuse the `request_id` only when retrying a request in case of
+  // failure. In this case, the request must be identical to the one that
+  // failed.
+  string request_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Information about the client device. For example, device model and
+  // operating system.
+  google.maps.unity.ClientInfo client_info = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// A response for the [LogImpressions][google.maps.playablelocations.v3.PlayableLocations.LogImpressions] method.
+// This method returns no data upon success.
+message LogImpressionsResponse {
+
+}
diff --git a/third_party/googleapis/google/maps/playablelocations/v3/playablelocations_grpc_service_config.json b/third_party/googleapis/google/maps/playablelocations/v3/playablelocations_grpc_service_config.json
new file mode 100644
index 000000000..60c475959
--- /dev/null
+++ b/third_party/googleapis/google/maps/playablelocations/v3/playablelocations_grpc_service_config.json
@@ -0,0 +1,14 @@
+{
+  "methodConfig": [{
+    "name": [{ "service": "google.maps.roads.v3.PlayableLocations" }],
+    "timeout": "60s",
+    "retryPolicy": {
+      "maxAttempts": 5,
+      "initialBackoff": "1s",
+      "maxBackoff": "60s",
+      "backoffMultiplier": 1.3,
+      "retryableStatusCodes": ["UNAVAILABLE", "UNKNOWN"]
+    }
+  }
+ ]
+}
diff --git a/third_party/googleapis/google/maps/playablelocations/v3/playablelocations_v3.yaml b/third_party/googleapis/google/maps/playablelocations/v3/playablelocations_v3.yaml
new file mode 100644
index 000000000..e2df611bd
--- /dev/null
+++ b/third_party/googleapis/google/maps/playablelocations/v3/playablelocations_v3.yaml
@@ -0,0 +1,12 @@
+type: google.api.Service
+config_version: 3
+name: playablelocations.googleapis.com
+title: Playable Locations API
+
+apis:
+- name: google.maps.playablelocations.v3.PlayableLocations
+
+backend:
+  rules:
+  - selector: 'google.maps.playablelocations.v3.PlayableLocations.*'
+    deadline: 60.0
diff --git a/third_party/googleapis/google/maps/playablelocations/v3/resources.proto b/third_party/googleapis/google/maps/playablelocations/v3/resources.proto
new file mode 100644
index 000000000..5fe0a4151
--- /dev/null
+++ b/third_party/googleapis/google/maps/playablelocations/v3/resources.proto
@@ -0,0 +1,106 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.maps.playablelocations.v3;
+
+import "google/api/field_behavior.proto";
+import "google/protobuf/field_mask.proto";
+import "google/type/latlng.proto";
+
+option csharp_namespace = "Google.Maps.PlayableLocations.V3";
+option go_package = "google.golang.org/genproto/googleapis/maps/playablelocations/v3;playablelocations";
+option java_multiple_files = true;
+option java_outer_classname = "ResourcesProto";
+option java_package = "com.google.maps.playablelocations.v3";
+option objc_class_prefix = "GMPL";
+
+// A report submitted by a player about a playable location that is considered
+// inappropriate for use in the game.
+message PlayerReport {
+  // The reason why the playable location is considered bad.
+  enum BadLocationReason {
+    // Unspecified reason. Do not use.
+    BAD_LOCATION_REASON_UNSPECIFIED = 0;
+
+    // The reason isn't one of the reasons in this enumeration.
+    OTHER = 1;
+
+    // The playable location isn't accessible to pedestrians. For example, if
+    // it's in the middle of a highway.
+    NOT_PEDESTRIAN_ACCESSIBLE = 2;
+
+    // The playable location isn't open to the public. For example, a private
+    // office building.
+    NOT_OPEN_TO_PUBLIC = 4;
+
+    // The playable location is permanently closed. For example, when a business
+    // has been shut down.
+    PERMANENTLY_CLOSED = 5;
+
+    // The playable location is temporarily inaccessible. For example, when a
+    // business has closed for renovations.
+    TEMPORARILY_INACCESSIBLE = 6;
+  }
+
+  // Required. The name of the playable location.
+  string location_name = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. One or more reasons why this playable location is considered bad.
+  repeated BadLocationReason reasons = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. A free-form description detailing why the playable location is
+  // considered bad.
+  string reason_details = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Language code (in BCP-47 format) indicating the language of the freeform
+  // description provided in `reason_details`. Examples are "en", "en-US" or
+  // "ja-Latn". For more information, see
+  // http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
+  string language_code = 4;
+}
+
+// Encapsulates impression event details.
+message Impression {
+  // The type of impression event.
+  enum ImpressionType {
+    // Unspecified type. Do not use.
+    IMPRESSION_TYPE_UNSPECIFIED = 0;
+
+    // The playable location was presented to a player.
+    PRESENTED = 1;
+
+    // A player interacted with the playable location.
+    INTERACTED = 2;
+  }
+
+  // Required. The name of the playable location.
+  string location_name = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The type of impression event.
+  ImpressionType impression_type = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // An arbitrary, developer-defined type identifier for each type of game
+  // object used in your game.
+  //
+  // Since players interact with differ types of game objects in different ways,
+  // this field allows you to segregate impression data by type for analysis.
+  //
+  // You should assign a unique `game_object_type` ID to represent a distinct
+  // type of game object in your game.
+  //
+  // For example, 1=monster location, 2=powerup location.
+  int32 game_object_type = 4;
+}
diff --git a/third_party/googleapis/google/maps/playablelocations/v3/sample/resources.proto b/third_party/googleapis/google/maps/playablelocations/v3/sample/resources.proto
new file mode 100644
index 000000000..6a8f8b2c6
--- /dev/null
+++ b/third_party/googleapis/google/maps/playablelocations/v3/sample/resources.proto
@@ -0,0 +1,206 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.maps.playablelocations.v3.sample;
+
+import "google/api/field_behavior.proto";
+import "google/protobuf/field_mask.proto";
+import "google/type/latlng.proto";
+
+option csharp_namespace = "Google.Maps.PlayableLocations.V3.Sample";
+option go_package = "google.golang.org/genproto/googleapis/maps/playablelocations/v3/sample;sample";
+option java_multiple_files = true;
+option java_outer_classname = "ResourcesProto";
+option java_package = "com.google.maps.playablelocations.v3.sample";
+option objc_class_prefix = "GMPL";
+
+// A geographical point suitable for placing game objects in location-based
+// games.
+message PlayableLocation {
+  // Required. The name of this playable location.
+  string name = 1;
+
+  // Required.
+  // Each location has one of the following identifiers:
+  oneof location_id {
+    // A [place ID] (https://developers.google.com/places/place-id)
+    string place_id = 2;
+
+    // A [plus code] (http://openlocationcode.com)
+    string plus_code = 3;
+  }
+
+  // A collection of [Playable Location Types](/maps/tt/games/types) for this
+  // playable location. The first type in the collection is the primary type.
+  //
+  // Type information might not be available for all playable locations.
+  repeated string types = 4;
+
+  // Required. The latitude and longitude associated with the center of the playable
+  // location.
+  //
+  // By default, the set of playable locations returned from
+  // [SamplePlayableLocations][google.maps.playablelocations.v3.PlayableLocations.SamplePlayableLocations] use
+  // center-point coordinates.
+  google.type.LatLng center_point = 5;
+
+  // The playable location's coordinates, snapped to the sidewalk of the
+  // nearest road, if a nearby road exists.
+  google.type.LatLng snapped_point = 6;
+}
+
+// A set of options that specifies the separation between playable locations.
+message SpacingOptions {
+  // Specifies whether the playable location's geographic coordinates (latitude
+  // and longitude) correspond to its center-point, or to its location snapped
+  // to the sidewalk of the nearest road.
+  enum PointType {
+    // Unspecified point type. Do not use this value.
+    POINT_TYPE_UNSPECIFIED = 0;
+
+    // The geographic coordinates correspond to the center of the location.
+    CENTER_POINT = 1;
+
+    // The geographic coordinates correspond to the location snapped to the
+    // sidewalk of the nearest road (when a nearby road exists).
+    SNAPPED_POINT = 2;
+  }
+
+  // Required. The minimum spacing between any two playable locations, measured in meters.
+  // The minimum value is 200.
+  // The maximum value is 1000.
+  //
+  // Inputs will be rounded up to the next 10 meter interval.
+  //
+  // The default value is 200m.
+  //
+  // Set this field to remove tight clusters of playable locations.
+  //
+  // Note:
+  //
+  // The spacing is a greedy algorithm. It optimizes for selecting the highest
+  // ranking locations first, not to maximize the number of locations selected.
+  // Consider the following scenario:
+  //
+  //   * Rank: A: 2, B: 1, C: 3.
+  //   * Distance: A--200m--B--200m--C
+  //
+  // If spacing=250, it will pick the highest ranked location [B], not [A, C].
+  //
+  //
+  // Note:
+  //
+  // Spacing works within the game object type itself, as well as the previous
+  // ones.
+  // Suppose three game object types, each with the following spacing:
+  //
+  //   * X: 400m, Y: undefined, Z: 200m.
+  //
+  // 1. Add locations for X, within 400m of each other.
+  // 2. Add locations for Y, without any spacing.
+  // 3. Finally, add locations for Z within 200m of each other as well X and Y.
+  //
+  // The distance diagram between those locations end up as:
+  //
+  //   * From->To.
+  //   * X->X: 400m
+  //   * Y->X, Y->Y: unspecified.
+  //   * Z->X, Z->Y, Z->Z: 200m.
+  double min_spacing_meters = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Specifies whether the minimum spacing constraint applies to the
+  // center-point or to the snapped point of playable locations. The default
+  // value is `CENTER_POINT`.
+  //
+  // If a snapped point is not available for a playable location, its
+  // center-point is used instead.
+  //
+  // Set this to the point type used in your game.
+  PointType point_type = 2;
+}
+
+// Specifies the filters to use when searching for playable locations.
+message Filter {
+  // Specifies the maximum number of playable locations to return. This value
+  // must not be greater than 500. The default value is 100.
+  //
+  // Only the top-ranking playable locations are returned.
+  int32 max_location_count = 1;
+
+  // A set of options that control the spacing between playable locations. By
+  // default the minimum distance between locations is 200m.
+  SpacingOptions spacing = 2;
+
+  // Restricts the set of playable locations to just the
+  // [types](/maps/tt/games/types) that you want.
+  repeated string included_types = 3;
+}
+
+// Encapsulates a filter criterion for searching for a set of playable
+// locations.
+message Criterion {
+  // Required. An arbitrary, developer-defined identifier of the type of game object that
+  // the playable location is used for. This field allows you to specify
+  // criteria per game object type when searching for playable locations.
+  //
+  // You should assign a unique `game_object_type` ID across all
+  // `request_criteria` to represent a distinct type of game object. For
+  // example, 1=monster location, 2=powerup location.
+  //
+  // The response contains a map.
+  int32 game_object_type = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Specifies filtering options, and specifies what will be included in the
+  // result set.
+  Filter filter = 2;
+
+  // Specifies which `PlayableLocation` fields are returned.
+  //
+  // `name` (which is used for logging impressions), `center_point` and
+  // `place_id` (or `plus_code`) are always returned.
+  //
+  // The following fields are omitted unless you specify them here:
+  //
+  //   * snapped_point
+  //   * types
+  //
+  // Note: The more fields you include, the more expensive in terms of data and
+  // associated latency your query will be.
+  google.protobuf.FieldMask fields_to_return = 3;
+}
+
+// Specifies the area to search for playable locations.
+message AreaFilter {
+  // Required. The S2 cell ID of the area you want. This must be between cell level 11 and
+  // 14 (inclusive).
+  //
+  // S2 cells are 64-bit integers that identify areas on the Earth. They are
+  // hierarchical, and can therefore be used for spatial indexing.
+  //
+  // The S2 geometry library is available in a number of languages:
+  //
+  //   * [C++](https://github.com/google/s2geometry)
+  //   * [Java](https://github.com/google/s2-geometry-library-java)
+  //   * [Go](https://github.com/golang/geo)
+  //   * [Python](https://github.com/google/s2geometry/tree/master/src/python)
+  fixed64 s2_cell_id = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// A list of PlayableLocation objects that satisfies a single Criterion.
+message PlayableLocationList {
+  // A list of playable locations for this game object type.
+  repeated PlayableLocation locations = 1;
+}
diff --git a/third_party/googleapis/google/maps/postprocessing.bzl b/third_party/googleapis/google/maps/postprocessing.bzl
new file mode 100644
index 000000000..b2a1b7f7c
--- /dev/null
+++ b/third_party/googleapis/google/maps/postprocessing.bzl
@@ -0,0 +1,58 @@
+"""
+Defines the postprocessing build rule for the Google Maps APIs.
+"""
+
+def maps_assembly_pkg(name, srcs, language, visibility = None):
+    """Target to build a post-processed ads-specific GAPIC assembly package.
+
+    Explodes a GAPIC assembly package, runs language-specific post-processing, and repackages.
+
+    This macro assumes srcs contains in a single input, namely a {{language}}_assembly_pkg target
+    produced by a gapic-generator build target.
+
+    There must be a corresponding postprocessing_{language}.sh script to invoke.
+
+    Args:
+      name: defines the name of the main target
+      srcs: collection containing exactly 1 build target, namely a
+        {{language}}_assembly_pkg target produced by gapic-generator
+      language: the programming language to post-process
+        (e.g., "java", "csharp", "php", etc.); there must be a matching
+        post-processin script of the form `postprocessing_{language}.sh
+        in this package
+      visibility (optional): marco visibility setting;
+        (see https://docs.bazel.build/versions/master/skylark/macros.html)
+    """
+    cmd = """
+    set -eu
+
+    tar xzf $(SRCS);
+    $(location //google/maps:postprocessing_%s) %s;
+    tar czf $@ %s
+    """
+    dir_name = _extract_path(srcs)
+
+    native.genrule(
+        name = name,
+        srcs = srcs,
+        outs = ["%s.tar.gz" % name],
+        cmd = cmd % (language, dir_name, dir_name),
+        tools = ["//google/maps:postprocessing_%s" % language],
+        visibility = visibility,
+    )
+
+def _extract_path(srcs):
+    """Takes the first label in srcs and returns its target name.
+
+    Args:
+      srcs: a collection of build labels of the form "//package/name:target"
+
+    Returns:
+      The first element's target (i.e.- the part after the ":"), else None if empty.
+    """
+
+    for s in srcs:
+        toks = s.split(":")
+        if len(toks) == 2:
+            return toks[1]
+    return None
diff --git a/third_party/googleapis/google/maps/postprocessing_java.sh b/third_party/googleapis/google/maps/postprocessing_java.sh
new file mode 100755
index 000000000..eb0ccccea
--- /dev/null
+++ b/third_party/googleapis/google/maps/postprocessing_java.sh
@@ -0,0 +1,49 @@
+#!/bin/bash
+
+set -eu
+
+# Performs Maps-specific post-processing on a .tar.gz archive produced by rule
+# java_gapic_assembly_gradle_pkg
+
+# Add gradle publish plugin
+#
+# Arguments:
+#   postprocess_dir: The directory that contains the Java files to postprocess.
+add_gradle_publish() {
+  postprocess_dir="${1}"
+  cat >> "${postprocess_dir}/build.gradle" < "${f}.new" && mv "${f}.new" "${f}"
+    sed -e "s/= 'com\.google\.api\.grpc'/= 'com\.google\.maps'/g" "${f}" > "${f}.new" && mv "${f}.new" "${f}"
+done
+}
+
+# Main entry point
+#
+# Arguments:
+#   postprocess_dir: The directory that contains the Java files to postprocess.
+main() {
+  postprocess_dir="$1"
+
+  if [ "${postprocess_dir}" = "" ]; then
+    echo "postprocess_dir is required"
+    exit 1
+  fi
+
+  add_gradle_publish "${postprocess_dir}"
+  change_group "${postprocess_dir}"
+}
+
+main "$@"
diff --git a/third_party/googleapis/google/maps/postprocessing_py.sh b/third_party/googleapis/google/maps/postprocessing_py.sh
new file mode 100755
index 000000000..ad903bc18
--- /dev/null
+++ b/third_party/googleapis/google/maps/postprocessing_py.sh
@@ -0,0 +1,43 @@
+#!/bin/bash
+
+set -eu
+
+# Performs Maps specific post-processing on a .tar.gz archive
+
+use_map_namespace() {
+  f="${1}/setup.py"
+  sed -e "s/google.cloud/google.maps/g" "${f}" > "${f}.new" && mv "${f}.new" "${f}"
+}
+
+use_markdown_readme() {
+  f="${1}/setup.py"
+  sed -e "s/README.rst/README.md/g" "${f}" > "${f}.new" && mv "${f}.new" "${f}"
+  rm -f "${1}/README.rst"
+}
+
+update_python_versions() {
+  f="${1}/setup.py"
+  sed -e "/Python :: 2/d" "${f}" > "${f}.new" && mv "${f}.new" "${f}"
+  sed -e "/Python :: 3.4/d" "${f}" > "${f}.new" && mv "${f}.new" "${f}"
+  sed -e "/enum34/d" "${f}" > "${f}.new" && mv "${f}.new" "${f}"
+  sed -e "s/'Programming Language :: Python :: 3.6',/'Programming Language :: Python :: 3.6',\n        'Programming Language :: Python :: 3.7',/g" "${f}" > "${f}.new" && mv "${f}.new" "${f}"
+}
+
+# Main entry point
+#
+# Arguments:
+#   postprocess_dir: The directory that contains the Java files to postprocess.
+main() {
+  postprocess_dir="$1"
+
+  if [ "${postprocess_dir}" = "" ]; then
+    echo "postprocess_dir is required"
+    exit 1
+  fi
+
+  use_markdown_readme "${postprocess_dir}"
+  update_python_versions "${postprocess_dir}"
+  use_map_namespace "${postprocess_dir}"
+}
+
+main "$@"
diff --git a/third_party/googleapis/google/maps/postprocessing_python.sh b/third_party/googleapis/google/maps/postprocessing_python.sh
new file mode 100755
index 000000000..91c9b8e70
--- /dev/null
+++ b/third_party/googleapis/google/maps/postprocessing_python.sh
@@ -0,0 +1,50 @@
+#!/bin/bash
+#!/bin/bash
+
+set -eu
+
+# Performs Maps-specific post-processing on a .tar.gz archive produced by rule
+# java_gapic_assembly_gradle_pkg
+
+# Add gradle publish plugin
+#
+# Arguments:
+#   postprocess_dir: The directory that contains the Java files to postprocess.
+add_gradle_publish() {
+  postprocess_dir="${1}"
+  cat >> "${postprocess_dir}/build.gradle" < "${f}.new" && mv "${f}.new" "${f}"
+    sed -e "s/= 'com\.google\.api\.grpc'/= 'com\.google\.maps'/g" "${f}" > "${f}.new" && mv "${f}.new" "${f}"
+done
+}
+
+# Main entry point
+#
+# Arguments:
+#   postprocess_dir: The directory that contains the Java files to postprocess.
+main() {
+  postprocess_dir="$1"
+
+  if [ "${postprocess_dir}" = "" ]; then
+    echo "postprocess_dir is required"
+    exit 1
+  fi
+
+  add_gradle_publish "${postprocess_dir}"
+  change_group "${postprocess_dir}"
+}
+
+main "$@"
diff --git a/third_party/googleapis/google/maps/roads/v1op/BUILD.bazel b/third_party/googleapis/google/maps/roads/v1op/BUILD.bazel
new file mode 100644
index 000000000..c1705d08d
--- /dev/null
+++ b/third_party/googleapis/google/maps/roads/v1op/BUILD.bazel
@@ -0,0 +1,379 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+load("//google/maps:postprocessing.bzl", "maps_assembly_pkg")
+
+proto_library(
+    name = "roads_proto",
+    srcs = [
+        "roads.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:resource_proto",
+        "//google/type:latlng_proto",
+        "@com_google_protobuf//:wrappers_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "roads_proto_with_info",
+    deps = [
+        ":roads_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "roads_java_proto",
+    deps = [":roads_proto"],
+)
+
+java_grpc_library(
+    name = "roads_java_grpc",
+    srcs = [":roads_proto"],
+    deps = [":roads_java_proto"],
+)
+
+java_gapic_library(
+    name = "roads_java_gapic",
+    src = ":roads_proto_with_info",
+    gapic_yaml = "roads_gapic.yaml",
+    package = "google.maps.roads.v1op",
+    service_yaml = "roads_v1op.yaml",
+    test_deps = [
+        ":roads_java_grpc",
+    ],
+    deps = [
+        ":roads_java_proto",
+    ],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-maps-roads-v1op-java",
+    deps = [
+        ":roads_java_gapic",
+        ":roads_java_grpc",
+        ":roads_java_proto",
+        ":roads_proto",
+    ],
+)
+
+maps_assembly_pkg(
+    name = "google-maps-roads-v1op-java-postprocess",
+    srcs = [":google-maps-roads-v1op-java"],
+    language = "java",
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "roads_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/maps/roads/v1op",
+    protos = [":roads_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/type:latlng_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "roads_go_gapic",
+    srcs = [":roads_proto_with_info"],
+    grpc_service_config = "roads_grpc_service_config.json",
+    importpath = "developers.google.com/maps/go/roads/v1op;roads",
+    service_yaml = "roads_v1op.yaml",
+    deps = [
+        ":roads_go_proto",
+    ],
+)
+
+go_test(
+    name = "roads_go_gapic_test",
+    srcs = [":roads_go_gapic_srcjar_test"],
+    embed = [":roads_go_gapic"],
+    importpath = "developers.google.com/maps/go/roads/v1op",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapic-maps-roads-v1op-go",
+    deps = [
+        ":roads_go_gapic",
+        ":roads_go_gapic_srcjar-test.srcjar",
+        ":roads_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+py_proto_library(
+    name = "roads_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":roads_proto"],
+)
+
+py_grpc_library(
+    name = "roads_py_grpc",
+    srcs = [":roads_proto"],
+    deps = [":roads_py_proto"],
+)
+
+py_gapic_library(
+    name = "roads_py_gapic",
+    src = ":roads_proto_with_info",
+    gapic_yaml = "roads_gapic.yaml",
+    package = "google.maps.roads.v1op",
+    service_yaml = "roads_v1op.yaml",
+    deps = [
+        ":roads_py_grpc",
+        ":roads_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "roads-v1op-py",
+    deps = [
+        ":roads_py_gapic",
+        ":roads_py_grpc",
+        ":roads_py_proto",
+    ],
+)
+
+maps_assembly_pkg(
+    name = "roads-v1op-py-postprocess",
+    srcs = [":roads-v1op-py"],
+    language = "py",
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "roads_php_proto",
+    deps = [":roads_proto"],
+)
+
+php_grpc_library(
+    name = "roads_php_grpc",
+    srcs = [":roads_proto"],
+    deps = [":roads_php_proto"],
+)
+# A HttpRule option must be defined
+# php_gapic_library(
+#     name = "roads_php_gapic",
+#     src = ":roads_proto_with_info",
+#     gapic_yaml = "roads_gapic.yaml",
+#     package = "google.maps.roads.v1op",
+#     service_yaml = "roads_v1op.yaml",
+#     deps = [
+#         ":roads_php_grpc",
+#         ":roads_php_proto",
+#     ],
+# )
+
+# # Open Source Packages
+# php_gapic_assembly_pkg(
+#     name = "google-maps-roads-v1op-php",
+#     deps = [
+#         ":roads_php_gapic",
+#         ":roads_php_grpc",
+#         ":roads_php_proto",
+#     ],
+# )
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "roads_nodejs_gapic",
+    src = ":roads_proto_with_info",
+    gapic_yaml = "roads_gapic.yaml",
+    package = "google.maps.roads.v1op",
+    service_yaml = "roads_v1op.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "roads-v1op-nodejs",
+    deps = [
+        ":roads_nodejs_gapic",
+        ":roads_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "roads_ruby_proto",
+    deps = [":roads_proto"],
+)
+
+ruby_grpc_library(
+    name = "roads_ruby_grpc",
+    srcs = [":roads_proto"],
+    deps = [":roads_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "roads_ruby_gapic",
+    src = ":roads_proto_with_info",
+    gapic_yaml = "roads_gapic.yaml",
+    package = "google.maps.roads.v1op",
+    service_yaml = "roads_v1op.yaml",
+    deps = [
+        ":roads_ruby_grpc",
+        ":roads_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-maps-roads-v1op-ruby",
+    deps = [
+        ":roads_ruby_gapic",
+        ":roads_ruby_grpc",
+        ":roads_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "roads_csharp_proto",
+    deps = [":roads_proto"],
+)
+
+csharp_grpc_library(
+    name = "roads_csharp_grpc",
+    srcs = [":roads_proto"],
+    deps = [":roads_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "roads_csharp_gapic",
+    src = ":roads_proto_with_info",
+    gapic_yaml = "roads_gapic.yaml",
+    package = "google.maps.roads.v1op",
+    service_yaml = "roads_v1op.yaml",
+    deps = [
+        ":roads_csharp_grpc",
+        ":roads_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-maps-roads-v1op-csharp",
+    deps = [
+        ":roads_csharp_gapic",
+        ":roads_csharp_grpc",
+        ":roads_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "cc_gapic_library",
+    "cc_grpc_library",
+    "cc_proto_library",
+)
+
+cc_proto_library(
+    name = "roads_cc_proto",
+    deps = [":roads_proto"],
+)
+
+cc_grpc_library(
+    name = "roads_cc_grpc",
+    srcs = [":roads_proto"],
+    generate_mocks = True,
+    grpc_only = True,
+    deps = [":roads_cc_proto"],
+)
+
+cc_gapic_library(
+    name = "roads_cc_gapic",
+    src = ":roads_proto_with_info",
+    package = "google.maps.roads.v1op",
+    deps = [
+        ":roads_cc_grpc",
+        ":roads_cc_proto",
+    ],
+)
diff --git a/third_party/googleapis/google/maps/roads/v1op/roads.proto b/third_party/googleapis/google/maps/roads/v1op/roads.proto
new file mode 100644
index 000000000..fd019e1e4
--- /dev/null
+++ b/third_party/googleapis/google/maps/roads/v1op/roads.proto
@@ -0,0 +1,115 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.maps.roads.v1op;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/protobuf/wrappers.proto";
+import "google/type/latlng.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/maps/roads/v1op;roads";
+option java_multiple_files = true;
+option java_outer_classname = "RoadsProto";
+option java_package = "com.google.maps.roads.v1op";
+
+service RoadsService {
+  option (google.api.default_host) = "roads.googleapis.com";
+
+  // This method takes a sequence of latitude,longitude points and snaps them to
+  // the most likely road segments. Optionally returns additional points giving
+  // the full road geometry. Also returns a place ID for each snapped point.
+  rpc SnapToRoads(SnapToRoadsRequest) returns (SnapToRoadsResponse) {}
+
+  // This method takes a list of latitude,longitude points and snaps them each
+  // to their nearest road. Also returns a place ID for each snapped point.
+  rpc ListNearestRoads(ListNearestRoadsRequest)
+      returns (ListNearestRoadsResponse) {}
+}
+
+// A request to the SnapToRoads method, requesting that a sequence of points be
+// snapped to road segments.
+message SnapToRoadsRequest {
+  // The path to be snapped as a series of lat, lng points. Specified as
+  // a string of the format: lat,lng|lat,lng|...
+  string path = 1;
+
+  // Whether to interpolate the points to return full road geometry.
+  bool interpolate = 2;
+
+  // The asset ID of the asset to which this path relates. This is used for
+  // abuse detection purposes for clients with asset-based SKUs.
+  string asset_id = 3;
+
+  // The type of travel being tracked. This will constrain the paths we snap to.
+  TravelMode travel_mode = 4;
+}
+
+// An enum representing the mode of travel used for snapping.
+enum TravelMode {
+  TRAVEL_MODE_UNSPECIFIED = 0;
+
+  DRIVING = 1;
+
+  CYCLING = 2;
+
+  WALKING = 3;
+}
+
+// A snapped point object, representing the result of snapping.
+message SnappedPoint {
+  // The lat,lng of the snapped location.
+  google.type.LatLng location = 1;
+
+  // The index into the original path of the equivalent pre-snapped point.
+  // This allows for identification of points which have been interpolated if
+  // this index is missing.
+  google.protobuf.UInt32Value original_index = 2;
+
+  // The place ID for this snapped location (road segment). These are the same
+  // as are currently used by the Places API.
+  string place_id = 3;
+}
+
+// The response from the SnapToRoads method, returning a sequence of snapped
+// points.
+message SnapToRoadsResponse {
+  // A list of snapped points.
+  repeated SnappedPoint snapped_points = 1;
+
+  // User-visible warning message, if any, which can be shown alongside a valid
+  // result.
+  string warning_message = 2;
+}
+
+// A request to the ListNearestRoads method, requesting that a sequence of
+// points be snapped individually to the road segment that each is closest to.
+message ListNearestRoadsRequest {
+  // The points to be snapped as a series of lat, lng points. Specified as
+  // a string of the format: lat,lng|lat,lng|...
+  string points = 1;
+
+  // The type of travel being tracked. This will constrain the roads we snap to.
+  TravelMode travel_mode = 2;
+}
+
+// The response from the ListNearestRoads method, returning a list of snapped
+// points.
+message ListNearestRoadsResponse {
+  // A list of snapped points.
+  repeated SnappedPoint snapped_points = 1;
+}
diff --git a/third_party/googleapis/google/maps/roads/v1op/roads_gapic.yaml b/third_party/googleapis/google/maps/roads/v1op/roads_gapic.yaml
new file mode 100644
index 000000000..d7ff6a249
--- /dev/null
+++ b/third_party/googleapis/google/maps/roads/v1op/roads_gapic.yaml
@@ -0,0 +1,50 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.maps.roads.v1op
+  python:
+    package_name: google.maps.roads.v1op.gapic
+  go:
+    package_name: developers.google.com/maps/go/roads/v1op
+  csharp:
+    package_name: Google.Maps.Roads.V1
+  ruby:
+    package_name: Google::Maps::Roads::V1
+  php:
+    package_name: Google\Maps\Roads\V1
+  nodejs:
+    package_name: roads.v1op
+    domain_layer_location: googlemaps  # becomes @googlemaps/roads
+interfaces:
+- name: google.maps.roads.v1op.RoadsService
+  collections: []
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 60000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 60000
+    total_timeout_millis: 600000
+  methods:
+  - name: SnapToRoads
+    required_fields:
+    - path
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: ListNearestRoads
+    required_fields:
+    - points
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
diff --git a/third_party/googleapis/google/maps/roads/v1op/roads_grpc_service_config.json b/third_party/googleapis/google/maps/roads/v1op/roads_grpc_service_config.json
new file mode 100644
index 000000000..7fd7579fc
--- /dev/null
+++ b/third_party/googleapis/google/maps/roads/v1op/roads_grpc_service_config.json
@@ -0,0 +1,14 @@
+{
+  "methodConfig": [{
+    "name": [{ "service": "google.maps.roads.v1op.RoadsService" }],
+    "timeout": "60s",
+    "retryPolicy": {
+      "maxAttempts": 5,
+      "initialBackoff": "1s",
+      "maxBackoff": "60s",
+      "backoffMultiplier": 1.3,
+      "retryableStatusCodes": ["UNAVAILABLE", "UNKNOWN"]
+    }
+  }
+ ]
+}
diff --git a/third_party/googleapis/google/maps/roads/v1op/roads_v1op.yaml b/third_party/googleapis/google/maps/roads/v1op/roads_v1op.yaml
new file mode 100644
index 000000000..abd1ec1e3
--- /dev/null
+++ b/third_party/googleapis/google/maps/roads/v1op/roads_v1op.yaml
@@ -0,0 +1,12 @@
+type: google.api.Service
+config_version: 3
+name: roads.googleapis.com
+title: Roads API
+
+apis:
+- name: google.maps.roads.v1op.RoadsService  # must stay as v1op
+
+documentation:
+  summary: |-
+    Snap GPS points to roads to identify the roads a vehicle was traveling
+    along, making up for GPS error.
diff --git a/third_party/googleapis/google/maps/routes/v1/BUILD.bazel b/third_party/googleapis/google/maps/routes/v1/BUILD.bazel
new file mode 100644
index 000000000..e2fc7c328
--- /dev/null
+++ b/third_party/googleapis/google/maps/routes/v1/BUILD.bazel
@@ -0,0 +1,226 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+load("//google/maps:postprocessing.bzl", "maps_assembly_pkg")
+
+proto_library(
+    name = "routes_proto",
+    srcs = [
+        "compute_route_matrix_request.proto",
+        "compute_routes_request.proto",
+        "compute_routes_response.proto",
+        "fallback_info.proto",
+        "polyline.proto",
+        "route.proto",
+        "route_matrix_element.proto",
+        "route_service.proto",
+        "toll_passes.proto",
+        "vehicle_emission_type.proto",
+        "waypoint.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/geo/type:viewport_proto",
+        "//google/rpc:status_proto",
+        "//google/type:latlng_proto",
+        "//google/type:money_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:timestamp_proto",
+        "@com_google_protobuf//:wrappers_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "routes_proto_with_info",
+    deps = [
+        ":routes_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "routes_java_proto",
+    deps = [":routes_proto"],
+)
+
+java_grpc_library(
+    name = "routes_java_grpc",
+    srcs = [":routes_proto"],
+    deps = [":routes_java_proto"],
+)
+
+java_gapic_assembly_gradle_pkg(
+    name = "google-maps-routes-v1-java",
+    deps = [
+        "//google/maps/routes/v1:routes_java_grpc",
+        "//google/maps/routes/v1:routes_java_proto",
+        "//google/maps/routes/v1:routes_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "routes_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/maps/routes/v1",
+    protos = [":routes_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/geo/type:viewport_go_proto",
+        "//google/rpc:status_go_proto",
+        "//google/type:latlng_go_proto",
+        "//google/type:money_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "routes_moved_proto",
+    srcs = [":routes_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/geo/type:viewport_proto",
+        "//google/rpc:status_proto",
+        "//google/type:latlng_proto",
+        "//google/type:money_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:timestamp_proto",
+        "@com_google_protobuf//:wrappers_proto",
+    ],
+)
+
+py_proto_library(
+    name = "routes_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":routes_moved_proto"],
+)
+
+py_grpc_library(
+    name = "routes_py_grpc",
+    srcs = [":routes_moved_proto"],
+    deps = [":routes_py_proto"],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "routes_php_proto",
+    deps = [":routes_proto"],
+)
+
+php_grpc_library(
+    name = "routes_php_grpc",
+    srcs = [":routes_proto"],
+    deps = [":routes_php_proto"],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "routes_ruby_proto",
+    deps = [":routes_proto"],
+)
+
+ruby_grpc_library(
+    name = "routes_ruby_grpc",
+    srcs = [":routes_proto"],
+    deps = [":routes_ruby_proto"],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "routes_csharp_proto",
+    deps = [":routes_proto"],
+)
+
+csharp_grpc_library(
+    name = "routes_csharp_grpc",
+    srcs = [":routes_proto"],
+    deps = [":routes_csharp_proto"],
+)
+
+##############################################################################
+# C++
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "cc_grpc_library",
+    "cc_proto_library",
+)
+
+cc_proto_library(
+    name = "routes_cc_proto",
+    deps = [":routes_proto"],
+)
+
+cc_grpc_library(
+    name = "routes_cc_grpc",
+    srcs = [":routes_proto"],
+    generate_mocks = True,
+    grpc_only = True,
+    deps = [":routes_cc_proto"],
+)
diff --git a/third_party/googleapis/google/maps/routes/v1/compute_route_matrix_request.proto b/third_party/googleapis/google/maps/routes/v1/compute_route_matrix_request.proto
new file mode 100644
index 000000000..e9a60fe89
--- /dev/null
+++ b/third_party/googleapis/google/maps/routes/v1/compute_route_matrix_request.proto
@@ -0,0 +1,72 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.maps.routes.v1;
+
+import "google/api/field_behavior.proto";
+import "google/maps/routes/v1/compute_routes_request.proto";
+import "google/maps/routes/v1/waypoint.proto";
+import "google/protobuf/timestamp.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Maps.Routes.V1";
+option go_package = "google.golang.org/genproto/googleapis/maps/routes/v1;routes";
+option java_multiple_files = true;
+option java_outer_classname = "ComputeRouteMatrixRequestProto";
+option java_package = "com.google.maps.routes.v1";
+option objc_class_prefix = "GMRS";
+option php_namespace = "Google\\Maps\\Routes\\V1";
+
+// ComputeRouteMatrix request message
+message ComputeRouteMatrixRequest {
+  // Required. Array of origins, which determines the rows of the response matrix.
+  repeated RouteMatrixOrigin origins = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Array of destinations, which determines the columns of the response matrix.
+  repeated RouteMatrixDestination destinations = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Specifies the mode of transportation.
+  RouteTravelMode travel_mode = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Specifies how to compute the route. The server attempts to use the selected
+  // routing preference to compute the route. If the routing preference results
+  // in an error or an extra long latency, an error is returned. In the future,
+  // we might implement a fallback mechanism to use a different option when the
+  // preferred option does not give a valid result. You can specify this option
+  // only when the `travel_mode` is `DRIVE` or `TWO_WHEELER`, otherwise the
+  // request fails.
+  RoutingPreference routing_preference = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The departure time. If you don't set this value, this defaults to the time
+  // that you made the request. If you set this value to a time that has already
+  // occurred, the request fails.
+  google.protobuf.Timestamp departure_time = 5 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// A single origin for ComputeRouteMatrixRequest
+message RouteMatrixOrigin {
+  // Required. Origin waypoint
+  Waypoint waypoint = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. Modifiers for every route that takes this as the origin
+  RouteModifiers route_modifiers = 2 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// A single destination for ComputeRouteMatrixRequest
+message RouteMatrixDestination {
+  // Required. Destination waypoint
+  Waypoint waypoint = 1 [(google.api.field_behavior) = REQUIRED];
+}
diff --git a/third_party/googleapis/google/maps/routes/v1/compute_routes_request.proto b/third_party/googleapis/google/maps/routes/v1/compute_routes_request.proto
new file mode 100644
index 000000000..058599080
--- /dev/null
+++ b/third_party/googleapis/google/maps/routes/v1/compute_routes_request.proto
@@ -0,0 +1,180 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.maps.routes.v1;
+
+import "google/maps/routes/v1/polyline.proto";
+import "google/maps/routes/v1/toll_passes.proto";
+import "google/maps/routes/v1/vehicle_emission_type.proto";
+import "google/maps/routes/v1/waypoint.proto";
+import "google/protobuf/timestamp.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Maps.Routes.V1";
+option go_package = "google.golang.org/genproto/googleapis/maps/routes/v1;routes";
+option java_multiple_files = true;
+option java_outer_classname = "ComputeRoutesRequestProto";
+option java_package = "com.google.maps.routes.v1";
+option objc_class_prefix = "GMRS";
+option php_namespace = "Google\\Maps\\Routes\\V1";
+
+// ComputeRoutes request message.
+message ComputeRoutesRequest {
+  // Required. Origin waypoint.
+  Waypoint origin = 1;
+
+  // Required. Destination waypoint.
+  Waypoint destination = 2;
+
+  // Optional. A set of waypoints along the route (excluding terminal points),
+  // for either stopping at or passing by.
+  repeated Waypoint intermediates = 3;
+
+  // Optional. Specifies the mode of transportation.
+  RouteTravelMode travel_mode = 4;
+
+  // Optional. Specifies how to compute the route. The server
+  // attempts to use the selected routing preference to compute the route. If
+  //  the routing preference results in an error or an extra long latency, then
+  // an error is returned. In the future, we might implement a fallback
+  // mechanism to use a different option when the preferred option does not give
+  // a valid result. You can specify this option only when the `travel_mode` is
+  // `DRIVE` or `TWO_WHEELER`, otherwise the request fails.
+  RoutingPreference routing_preference = 5;
+
+  // Optional. Specifies your preference for the quality of the polyline.
+  PolylineQuality polyline_quality = 6;
+
+  // Optional. The departure time. If you don't set this value, then this value
+  // defaults to the time that you made the request. If you set this value to a
+  // time that has already occurred, then the request fails.
+  google.protobuf.Timestamp departure_time = 7;
+
+  // Specifies whether to calculate alternate routes in addition to the route.
+  bool compute_alternative_routes = 8;
+
+  // Optional. A set of conditions to satisfy that affect the way routes are
+  // calculated.
+  RouteModifiers route_modifiers = 9;
+
+  // Optional. The BCP-47 language code, such as "en-US" or "sr-Latn". For more
+  // information, see
+  // http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. See
+  // [Language Support](https://developers.google.com/maps/faq#languagesupport)
+  // for the list of supported languages. When you don't provide this value, the
+  // display language is inferred from the location of the route request.
+  string language_code = 10;
+
+  // Optional. Specifies the units of measure for the display fields. This
+  // includes the `instruction` field in `NavigationInstruction`. The units of
+  // measure used for the route, leg, step distance, and duration are not
+  // affected by this value. If you don't provide this value, then the display
+  // units are inferred from the location of the request.
+  Units units = 11;
+}
+
+// A set of values used to specify the mode of travel.
+enum RouteTravelMode {
+  // No travel mode specified. Defaults to `DRIVE`.
+  TRAVEL_MODE_UNSPECIFIED = 0;
+
+  // Travel by passenger car.
+  DRIVE = 1;
+
+  // Travel by bicycle.
+  BICYCLE = 2;
+
+  // Travel by walking.
+  WALK = 3;
+
+  // Two-wheeled, motorized vehicle. For example, motorcycle. Note that this
+  // differs from the `BICYCLE` travel mode which covers human-powered mode.
+  TWO_WHEELER = 4;
+}
+
+// A set of values that specify factors to take into consideration when
+// calculating the route.
+enum RoutingPreference {
+  // No routing preference specified. Default to `TRAFFIC_AWARE`.
+  ROUTING_PREFERENCE_UNSPECIFIED = 0;
+
+  // Computes routes without taking traffic conditions into consideration.
+  // Suitable when traffic conditions don't matter. Using this value produces
+  // the lowest latency.
+  TRAFFIC_UNAWARE = 1;
+
+  // Calculates routes taking traffic conditions into consideration. In contrast
+  // to `TRAFFIC_AWARE_OPTIMAL`, some optimizations are applied to significantly
+  // reduce latency.
+  TRAFFIC_AWARE = 2;
+
+  // Calculates the routes taking traffic conditions into consideration,
+  // without applying most performance optimizations. Using this value produces
+  // the highest latency.
+  TRAFFIC_AWARE_OPTIMAL = 3;
+}
+
+// Encapsulates a set of optional conditions to satisfy when calculating the
+// routes.
+message RouteModifiers {
+  // Specifies whether to avoid toll roads. Applies only to the `DRIVE` and
+  // `TWO_WHEELER` travel modes.
+  bool avoid_tolls = 1;
+
+  // Specifies whether to avoid highways. Applies only to the `DRIVE` and
+  // `TWO_WHEELER` travel modes.
+  bool avoid_highways = 2;
+
+  // Specifies whether to avoid ferries. Applies only to the `DRIVE` and
+  // `TWO_WHEELER` travel modes.
+  bool avoid_ferries = 3;
+
+  // Specifies whether to avoid navigating indoors. Applies only to the `WALK`
+  // travel mode.
+  bool avoid_indoor = 4;
+
+  // Optional. Specifies the vehicle information.
+  VehicleInfo vehicle_info = 5;
+
+  // Encapsulates information about toll passes.
+  // TollPass is unset means no available pass.
+  // Applies only to the DRIVE and TWO_WHEELER travel modes.
+  repeated TollPass toll_passes = 6;
+}
+
+// Encapsulates the vehicle information, such as the license plate last
+// character.
+message VehicleInfo {
+  // Specifies the license plate last character. Could be a digit or a letter.
+  string license_plate_last_character = 1;
+
+  // Describes the vehicle's emission type.
+  // Applies only to the DRIVE travel mode.
+  VehicleEmissionType emission_type = 2;
+}
+
+// A set of values that specify the unit of measure used in the display.
+enum Units {
+  // Units of measure not specified. Defaults to the unit of measure inferred
+  // from the request.
+  UNITS_UNSPECIFIED = 0;
+
+  // Metric units of measure.
+  METRIC = 1;
+
+  // Imperial (English) units of measure.
+  IMPERIAL = 2;
+}
diff --git a/third_party/googleapis/google/maps/routes/v1/compute_routes_response.proto b/third_party/googleapis/google/maps/routes/v1/compute_routes_response.proto
new file mode 100644
index 000000000..cf74d8389
--- /dev/null
+++ b/third_party/googleapis/google/maps/routes/v1/compute_routes_response.proto
@@ -0,0 +1,45 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.maps.routes.v1;
+
+import "google/maps/routes/v1/fallback_info.proto";
+import "google/maps/routes/v1/route.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Maps.Routes.V1";
+option go_package = "google.golang.org/genproto/googleapis/maps/routes/v1;routes";
+option java_multiple_files = true;
+option java_outer_classname = "ComputeRoutesResponseProto";
+option java_package = "com.google.maps.routes.v1";
+option objc_class_prefix = "GMRS";
+option php_namespace = "Google\\Maps\\Routes\\V1";
+
+// ComputeRoutes the response message.
+message ComputeRoutesResponse {
+  // Contains an array of computed routes (up to three) when you specify
+  // compute_alternatives_routes, and contains just one route when you don't.
+  // When this array contains multiple entries, the first one is the most
+  // recommended route. If the array is empty, then it means no route could be
+  // found.
+  repeated Route routes = 1;
+
+  // In some cases when the server is not able to compute the route results with
+  // all of the input preferences, it may fallback to using a different way of
+  // computation. When fallback mode is used, this field contains detailed info
+  // about the fallback response. Otherwise this field is unset.
+  FallbackInfo fallback_info = 2;
+}
diff --git a/third_party/googleapis/google/maps/routes/v1/fallback_info.proto b/third_party/googleapis/google/maps/routes/v1/fallback_info.proto
new file mode 100644
index 000000000..6a00d5333
--- /dev/null
+++ b/third_party/googleapis/google/maps/routes/v1/fallback_info.proto
@@ -0,0 +1,71 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.maps.routes.v1;
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Maps.Routes.V1";
+option go_package = "google.golang.org/genproto/googleapis/maps/routes/v1;routes";
+option java_multiple_files = true;
+option java_outer_classname = "FallbackInfoProto";
+option java_package = "com.google.maps.routes.v1";
+option objc_class_prefix = "GMRS";
+option php_namespace = "Google\\Maps\\Routes\\V1";
+
+// Information related to how and why a fallback result was used. If this field
+// is set, then it means the server used a different routing mode from your
+// preferred mode as fallback.
+message FallbackInfo {
+  // Routing mode used for the response. If fallback was triggered, the mode
+  // may be different from routing preference set in the original client
+  // request.
+  FallbackRoutingMode routing_mode = 1;
+
+  // The reason why fallback response was used instead of the original response.
+  // This field is only populated when the fallback mode is triggered and the
+  // fallback response is returned.
+  FallbackReason reason = 2;
+}
+
+// Reasons for using fallback response.
+enum FallbackReason {
+  // No fallback reason specified.
+  FALLBACK_REASON_UNSPECIFIED = 0;
+
+  // A server error happened while calculating routes with your preferred
+  // routing mode, but we were able to return a result calculated by an
+  // alternative mode.
+  SERVER_ERROR = 1;
+
+  // We were not able to finish the calculation with your preferred routing mode
+  // on time, but we were able to return a result calculated by an alternative
+  // mode.
+  LATENCY_EXCEEDED = 2;
+}
+
+// Actual routing mode used for returned fallback response.
+enum FallbackRoutingMode {
+  // Not used.
+  FALLBACK_ROUTING_MODE_UNSPECIFIED = 0;
+
+  // Indicates the "TRAFFIC_UNAWARE" routing mode was used to compute the
+  // response.
+  FALLBACK_TRAFFIC_UNAWARE = 1;
+
+  // Indicates the "TRAFFIC_AWARE" routing mode was used to compute the
+  // response.
+  FALLBACK_TRAFFIC_AWARE = 2;
+}
diff --git a/third_party/googleapis/google/maps/routes/v1/polyline.proto b/third_party/googleapis/google/maps/routes/v1/polyline.proto
new file mode 100644
index 000000000..53806b4b0
--- /dev/null
+++ b/third_party/googleapis/google/maps/routes/v1/polyline.proto
@@ -0,0 +1,53 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.maps.routes.v1;
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Maps.Routes.V1";
+option go_package = "google.golang.org/genproto/googleapis/maps/routes/v1;routes";
+option java_multiple_files = true;
+option java_outer_classname = "PolylineProto";
+option java_package = "com.google.maps.routes.v1";
+option objc_class_prefix = "GMRS";
+option php_namespace = "Google\\Maps\\Routes\\V1";
+
+// Encapsulates an encoded polyline.
+message Polyline {
+  // Encapsulates the type of polyline. Defaults to encoded_polyline.
+  oneof polyline_type {
+    // The string encoding of the polyline using the [polyline encoding
+    // algorithm](https://developers.google.com/maps/documentation/utilities/polylinealgorithm)
+    string encoded_polyline = 1;
+  }
+}
+
+// A set of values that specify the quality of the polyline.
+enum PolylineQuality {
+  // No polyline quality preference specified. Defaults to `OVERVIEW`.
+  POLYLINE_QUALITY_UNSPECIFIED = 0;
+
+  // Specifies a high-quality polyline - which is composed using more points
+  // than `OVERVIEW`, at the cost of increased response size. Use this value
+  // when you need more precision.
+  HIGH_QUALITY = 1;
+
+  // Specifies an overview polyline - which is composed using a small number of
+  // points. Use this value when displaying an overview of the route. Using this
+  // option has a lower request latency compared to using the
+  // `HIGH_QUALITY` option.
+  OVERVIEW = 2;
+}
diff --git a/third_party/googleapis/google/maps/routes/v1/route.proto b/third_party/googleapis/google/maps/routes/v1/route.proto
new file mode 100644
index 000000000..119853adb
--- /dev/null
+++ b/third_party/googleapis/google/maps/routes/v1/route.proto
@@ -0,0 +1,263 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.maps.routes.v1;
+
+import "google/geo/type/viewport.proto";
+import "google/maps/routes/v1/polyline.proto";
+import "google/maps/routes/v1/waypoint.proto";
+import "google/protobuf/duration.proto";
+import "google/type/money.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Maps.Routes.V1";
+option go_package = "google.golang.org/genproto/googleapis/maps/routes/v1;routes";
+option java_multiple_files = true;
+option java_outer_classname = "RouteProto";
+option java_package = "com.google.maps.routes.v1";
+option objc_class_prefix = "GMRS";
+option php_namespace = "Google\\Maps\\Routes\\V1";
+
+// Encapsulates a route, which consists of a series of connected road segments
+// that join beginning, ending, and intermediate waypoints.
+message Route {
+  // A collection of legs (path segments between waypoints) that make-up the
+  // route. Each leg corresponds to the trip between two non-`via` Waypoints.
+  // For example, a route with no intermediate waypoints has only one leg. A
+  // route that includes one non-`via` intermediate waypoint has two legs. A
+  // route that includes one `via` intermediate waypoint has one leg. The order
+  // of the legs matches the order of Waypoints from `origin` to `intermediates`
+  // to `destination`.
+  repeated RouteLeg legs = 1;
+
+  // The travel distance of the route, in meters.
+  int32 distance_meters = 2;
+
+  // The length of time needed to navigate the route. If you set the
+  // `route_preference` to `TRAFFIC_UNAWARE`, then this value is the same as
+  // `static_duration`. If you set the `route_preference` to either
+  // `TRAFFIC_AWARE` or `TRAFFIC_AWARE_OPTIMAL`, then this value is calculated
+  // taking traffic conditions into account.
+  google.protobuf.Duration duration = 3;
+
+  // The duration of traveling through the route without taking traffic
+  // conditions into consideration.
+  google.protobuf.Duration static_duration = 4;
+
+  // The overall route polyline. This polyline will be the combined polyline of
+  // all `legs`.
+  Polyline polyline = 5;
+
+  // A description of the route.
+  string description = 6;
+
+  // An array of warnings to show when displaying the route.
+  repeated string warnings = 7;
+
+  // The viewport bounding box of the polyline.
+  google.geo.type.Viewport viewport = 8;
+
+  // Additional information about the route.
+  RouteTravelAdvisory travel_advisory = 9;
+}
+
+// Encapsulates the additional information that the user should be informed
+// about, such as possible traffic zone restriction etc.
+message RouteTravelAdvisory {
+  // The traffic restriction that applies to the route. A vehicle that is
+  // subject to the restriction is not allowed to travel on the route. As of
+  // October 2019, only Jakarta, Indonesia takes into consideration.
+  TrafficRestriction traffic_restriction = 1;
+
+  // Encapsulates information about tolls on the Route.
+  // This field is only populated if we expect there are tolls on the Route.
+  // If this field is set but the estimated_price subfield is not populated,
+  // we expect that road contains tolls but we do not know an estimated price.
+  // If this field is not set, then we expect there is no toll on the Route.
+  TollInfo toll_info = 2;
+}
+
+// Encapsulates the additional information that the user should be informed
+// about, such as possible traffic zone restriction etc. on a route leg.
+message RouteLegTravelAdvisory {
+  // Encapsulates information about tolls on the specific RouteLeg.
+  // This field is only populated if we expect there are tolls on the RouteLeg.
+  // If this field is set but the estimated_price subfield is not populated,
+  // we expect that road contains tolls but we do not know an estimated price.
+  // If this field does not exist, then there is no toll on the RouteLeg.
+  TollInfo toll_info = 1;
+}
+
+// Encapsulates the traffic restriction applied to the route. As of October
+// 2019, only Jakarta, Indonesia takes into consideration.
+message TrafficRestriction {
+  // The restriction based on the vehicle's license plate last character. If
+  // this field does not exist, then no restriction on route.
+  LicensePlateLastCharacterRestriction license_plate_last_character_restriction = 1;
+}
+
+// Encapsulates the license plate last character restriction.
+message LicensePlateLastCharacterRestriction {
+  // The allowed last character of a license plate of a vehicle. Only vehicles
+  // whose license plate's last characters match these are allowed to travel on
+  // the route. If empty, no vehicle is allowed.
+  repeated string allowed_last_characters = 1;
+}
+
+// Encapsulates a segment between non-`via` waypoints.
+message RouteLeg {
+  // The travel distance of the route leg, in meters.
+  int32 distance_meters = 1;
+
+  // The length of time needed to navigate the leg. If the `route_preference`
+  // is set to `TRAFFIC_UNAWARE`, then this value is the same as
+  // `static_duration`. If the `route_preference` is either `TRAFFIC_AWARE` or
+  // `TRAFFIC_AWARE_OPTIMAL`, then this value is calculated taking traffic
+  // conditions into account.
+  google.protobuf.Duration duration = 2;
+
+  // The duration of traveling through the leg, calculated without taking
+  // traffic conditions into consideration.
+  google.protobuf.Duration static_duration = 3;
+
+  // The overall polyline for this leg. This includes that each `step`'s
+  // polyline.
+  Polyline polyline = 4;
+
+  // The start location of this leg. This might be different from the provided
+  // `origin`. For example, when the provided `origin` is not near a road, this
+  // is a point on the road.
+  Location start_location = 5;
+
+  // The end location of this leg. This might be different from the provided
+  // `destination`. For example, when the provided `destination` is not near a
+  // road, this is a point on the road.
+  Location end_location = 6;
+
+  // An array of steps denoting segments within this leg. Each step represents
+  // one navigation instruction.
+  repeated RouteLegStep steps = 7;
+
+  // Encapsulates the additional information that the user should be informed
+  // about, such as possible traffic zone restriction etc. on a route leg.
+  RouteLegTravelAdvisory travel_advisory = 8;
+}
+
+// Encapsulates toll information on a `Route` or on a `RouteLeg`.
+message TollInfo {
+  // The monetary amount of tolls for the corresponding Route or RouteLeg.
+  // This list contains a money amount for each currency that is expected
+  // to be charged by the toll stations. Typically this list will contain only
+  // one item for routes with tolls in one currency. For international trips,
+  // this list may contain multiple items to reflect tolls in different
+  // currencies.
+  repeated google.type.Money estimated_price = 1;
+}
+
+// Encapsulates a segment of a `RouteLeg`. A step corresponds to a single
+// navigation instruction. Route legs are made up of steps.
+message RouteLegStep {
+  // The travel distance of this step, in meters. In some circumstances, this
+  // field might not have a value.
+  int32 distance_meters = 1;
+
+  // The duration of travel through this step without taking traffic conditions
+  // into consideration. In some circumstances, this field might not have a
+  // value.
+  google.protobuf.Duration static_duration = 2;
+
+  // The polyline associated with this step.
+  Polyline polyline = 3;
+
+  // The start location of this step.
+  Location start_location = 4;
+
+  // The end location of this step.
+  Location end_location = 5;
+
+  // Navigation instructions.
+  NavigationInstruction navigation_instruction = 6;
+}
+
+message NavigationInstruction {
+  // Encapsulates the navigation instructions for the current step (e.g., turn
+  // left, merge, straight, etc.). This field determines which icon to display.
+  Maneuver maneuver = 1;
+
+  // Instructions for navigating this step.
+  string instructions = 2;
+}
+
+// A set of values that specify the navigation action to take for the current
+// step (e.g., turn left, merge, straight, etc.).
+enum Maneuver {
+  // Not used.
+  MANEUVER_UNSPECIFIED = 0;
+
+  // Turn slightly to the left.
+  TURN_SLIGHT_LEFT = 1;
+
+  // Turn sharply to the left.
+  TURN_SHARP_LEFT = 2;
+
+  // Make a left u-turn.
+  UTURN_LEFT = 3;
+
+  // Turn left.
+  TURN_LEFT = 4;
+
+  // Turn slightly to the right.
+  TURN_SLIGHT_RIGHT = 5;
+
+  // Turn sharply to the right.
+  TURN_SHARP_RIGHT = 6;
+
+  // Make a right u-turn.
+  UTURN_RIGHT = 7;
+
+  // Turn right.
+  TURN_RIGHT = 8;
+
+  // Go straight.
+  STRAIGHT = 9;
+
+  // Take the left ramp.
+  RAMP_LEFT = 10;
+
+  // Take the right ramp.
+  RAMP_RIGHT = 11;
+
+  // Merge into traffic.
+  MERGE = 12;
+
+  // Take the left fork.
+  FORK_LEFT = 13;
+
+  // Take the right fork.
+  FORK_RIGHT = 14;
+
+  // Take the ferry.
+  FERRY = 15;
+
+  // Take the train leading onto the ferry.
+  FERRY_TRAIN = 16;
+
+  // Turn left at the roundabout.
+  ROUNDABOUT_LEFT = 17;
+
+  // Turn right at the roundabout.
+  ROUNDABOUT_RIGHT = 18;
+}
diff --git a/third_party/googleapis/google/maps/routes/v1/route_matrix_element.proto b/third_party/googleapis/google/maps/routes/v1/route_matrix_element.proto
new file mode 100644
index 000000000..66211ebaa
--- /dev/null
+++ b/third_party/googleapis/google/maps/routes/v1/route_matrix_element.proto
@@ -0,0 +1,69 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.maps.routes.v1;
+
+import "google/maps/routes/v1/fallback_info.proto";
+import "google/maps/routes/v1/route.proto";
+import "google/protobuf/duration.proto";
+import "google/rpc/status.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Maps.Routes.V1";
+option go_package = "google.golang.org/genproto/googleapis/maps/routes/v1;routes";
+option java_multiple_files = true;
+option java_outer_classname = "ComputeRouteMatrixElementProto";
+option java_package = "com.google.maps.routes.v1";
+option objc_class_prefix = "GMRS";
+option php_namespace = "Google\\Maps\\Routes\\V1";
+
+// Encapsulates route information computed for an origin/destination pair in the
+// ComputeRouteMatrix API. This proto can be streamed to the client.
+message RouteMatrixElement {
+  // Zero-based index of the origin in the request.
+  int32 origin_index = 1;
+
+  // Zero-based index of the destination in the request.
+  int32 destination_index = 2;
+
+  // Error status code for this element.
+  google.rpc.Status status = 3;
+
+  // The travel distance of the route, in meters.
+  int32 distance_meters = 4;
+
+  // The length of time needed to navigate the route. If you set the
+  // `route_preference` to `TRAFFIC_UNAWARE`, then this value is the same as
+  // `static_duration`. If you set the `route_preference` to either
+  // `TRAFFIC_AWARE` or `TRAFFIC_AWARE_OPTIMAL`, then this value is calculated
+  // taking traffic conditions into account.
+  google.protobuf.Duration duration = 5;
+
+  // The duration of traveling through the route without taking traffic
+  // conditions into consideration.
+  google.protobuf.Duration static_duration = 6;
+
+  // Additional information about the route. For example: restriction
+  // information and toll information
+  RouteTravelAdvisory travel_advisory = 7;
+
+  // In some cases when the server is not able to compute the route with the
+  // given preferences for this particular origin/destination pair, it may
+  // fall back to using a different mode of computation. When fallback mode is
+  // used, this field contains detailed information about the fallback response.
+  // Otherwise this field is unset.
+  FallbackInfo fallback_info = 8;
+}
diff --git a/third_party/googleapis/google/maps/routes/v1/route_service.proto b/third_party/googleapis/google/maps/routes/v1/route_service.proto
new file mode 100644
index 000000000..602ba9280
--- /dev/null
+++ b/third_party/googleapis/google/maps/routes/v1/route_service.proto
@@ -0,0 +1,78 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.maps.routes.v1;
+
+import "google/api/annotations.proto";
+import "google/maps/routes/v1/compute_routes_request.proto";
+import "google/maps/routes/v1/compute_routes_response.proto";
+import "google/api/client.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Maps.Routes.V1";
+option go_package = "google.golang.org/genproto/googleapis/maps/routes/v1;routes";
+option java_multiple_files = true;
+option java_outer_classname = "RoutesServiceProto";
+option java_package = "com.google.maps.routes.v1";
+option objc_class_prefix = "GMRS";
+option php_namespace = "Google\\Maps\\Routes\\V1";
+
+// The Routes Preferred API.
+service RoutesPreferred {
+  option (google.api.default_host) = "routespreferred.googleapis.com";
+
+  // Returns the primary route along with optional alternate routes, given a set
+  // of terminal and intermediate waypoints.
+  //
+  // **NOTE:** This method requires that you specify a response field mask in
+  // the input. You can provide the response field mask by using URL parameter
+  // `$fields` or `fields`, or by using an HTTP/gRPC header `X-Goog-FieldMask`
+  // (see the [available URL parameters and
+  // headers](https://cloud.google.com/apis/docs/system-parameters). The value
+  // is a comma separated list of field paths. See detailed documentation about
+  // [how to construct the field
+  // paths](https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/field_mask.proto).
+  //
+  // For example, in this method:
+  //
+  // * Field mask of all available fields (for manual inspection):
+  //   `X-Goog-FieldMask: *`
+  // * Field mask of Route-level duration, distance, and polyline (an example
+  // production setup):
+  //   `X-Goog-FieldMask:
+  //   routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline`
+  //
+  // Google discourage the use of the wildcard (`*`) response field mask, or
+  // specifying the field mask at the top level (`routes`), because:
+  //
+  // * Selecting only the fields that you need helps our server save computation
+  // cycles, allowing us to return the result to you with a lower latency.
+  // * Selecting only the fields that you need
+  // in your production job ensures stable latency performance. We might add
+  // more response fields in the future, and those new fields might require
+  // extra computation time. If you select all fields, or if you select all
+  // fields at the top level, then you might experience performance degradation
+  // because any new field we add will be automatically included in the
+  // response.
+  // * Selecting only the fields that you need results in a smaller response
+  // size, and thus higher network throughput.
+  rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse) {
+    option (google.api.http) = {
+      post: "/v1:computeRoutes"
+      body: "*"
+    };
+  }
+}
diff --git a/third_party/googleapis/google/maps/routes/v1/toll_passes.proto b/third_party/googleapis/google/maps/routes/v1/toll_passes.proto
new file mode 100644
index 000000000..f823e9d63
--- /dev/null
+++ b/third_party/googleapis/google/maps/routes/v1/toll_passes.proto
@@ -0,0 +1,39 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.maps.routes.v1;
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Maps.Routes.V1";
+option go_package = "google.golang.org/genproto/googleapis/maps/routes/v1;routes";
+option java_multiple_files = true;
+option java_outer_classname = "TollPassesProto";
+option java_package = "com.google.maps.routes.v1";
+option objc_class_prefix = "GMRS";
+option php_namespace = "Google\\Maps\\Routes\\V1";
+
+// List of toll passes around the world that we support.
+enum TollPass {
+  // Not used. If this value is used, then the request fails.
+  TOLL_PASS_UNSPECIFIED = 0;
+
+  // State pass of the Washington state, United States.
+  US_WA_GOOD_TO_GO = 1;
+
+  // Australia-wide toll pass.
+  // See additional details at https://www.linkt.com.au/.
+  AU_LINKT = 2;
+}
diff --git a/third_party/googleapis/google/maps/routes/v1/vehicle_emission_type.proto b/third_party/googleapis/google/maps/routes/v1/vehicle_emission_type.proto
new file mode 100644
index 000000000..79f578909
--- /dev/null
+++ b/third_party/googleapis/google/maps/routes/v1/vehicle_emission_type.proto
@@ -0,0 +1,42 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.maps.routes.v1;
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Maps.Routes.V1";
+option go_package = "google.golang.org/genproto/googleapis/maps/routes/v1;routes";
+option java_multiple_files = true;
+option java_outer_classname = "VehicleEmissionTypeProto";
+option java_package = "com.google.maps.routes.v1";
+option objc_class_prefix = "GMRS";
+option php_namespace = "Google\\Maps\\Routes\\V1";
+
+// A set of values describing the vehicle's emission type.
+// Applies only to the DRIVE travel mode.
+enum VehicleEmissionType {
+  // No emission type specified. Default to GASOLINE.
+  VEHICLE_EMISSION_TYPE_UNSPECIFIED = 0;
+
+  // Gasoline/petrol fueled vehicle.
+  GASOLINE = 1;
+
+  // Electricity powered vehicle.
+  ELECTRIC = 2;
+
+  // Hybrid fuel (such as gasoline + electric) vehicle.
+  HYBRID = 3;
+}
diff --git a/third_party/googleapis/google/maps/routes/v1/waypoint.proto b/third_party/googleapis/google/maps/routes/v1/waypoint.proto
new file mode 100644
index 000000000..df606f4e1
--- /dev/null
+++ b/third_party/googleapis/google/maps/routes/v1/waypoint.proto
@@ -0,0 +1,81 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.maps.routes.v1;
+
+import "google/protobuf/wrappers.proto";
+import "google/type/latlng.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Maps.Routes.V1";
+option go_package = "google.golang.org/genproto/googleapis/maps/routes/v1;routes";
+option java_multiple_files = true;
+option java_outer_classname = "WaypointProto";
+option java_package = "com.google.maps.routes.v1";
+option objc_class_prefix = "GMRS";
+option php_namespace = "Google\\Maps\\Routes\\V1";
+
+// Encapsulates a waypoint. Waypoints mark both the beginning and end of a
+// route, and include intermediate stops along the route.
+message Waypoint {
+  // Different ways to represent a location.
+  oneof location_type {
+    // A point specified using geographic coordinates, including an optional
+    // heading.
+    Location location = 1;
+
+    // The POI Place ID associated with the waypoint.
+    string place_id = 2;
+  }
+
+  // Marks this waypoint as a milestone, as opposed to a stopping point. For
+  // each non-via waypoint in the request, the response appends an entry to the
+  // `legs` array to provide the details for stopovers on that leg of the
+  // trip. Set this value to true when you want the route to pass through this
+  // waypoint without stopping over. Via waypoints don't cause an entry to be
+  // added to the `legs` array, but they do route the journey through the
+  // waypoint. You can only set this value on waypoints that are intermediates.
+  // If you set this field on terminal waypoints, then the request fails.
+  bool via = 3;
+
+  // Indicates that the waypoint is meant for vehicles to stop at, where the
+  // intention is to either pickup or drop-off. When you set this value, the
+  // calculated route won't include non-`via` waypoints on roads that are
+  // unsuitable for pickup and drop-off. This option works only for `DRIVE` and
+  // `TWO_WHEELER` travel modes, and when the `location_type` is `location`.
+  bool vehicle_stopover = 4;
+
+  // Indicates that the location of this waypoint is meant to have a preference
+  // for the vehicle to stop at a particular side of road. When you set this
+  // value, the route will pass through the location so that the vehicle can
+  // stop at the side of road that the location is biased towards from the
+  // center of the road. This option works only for 'DRIVE' and 'TWO_WHEELER'
+  // travel modes, and when the 'location_type' is set to 'location'.
+  bool side_of_road = 5;
+}
+
+// Encapsulates a location (a geographic point, and an optional heading).
+message Location {
+  // The waypoint's geographic coordinates.
+  google.type.LatLng lat_lng = 1;
+
+  // The compass heading associated with the direction of the flow of traffic.
+  // This value is used to specify the side of the road to use for pickup and
+  // drop-off. Heading values can be from 0 to 360, where 0 specifies a heading
+  // of due North, 90 specifies a heading of due East, etc. You can use this
+  // field only for `DRIVE` and `TWO_WHEELER` travel modes.
+  google.protobuf.Int32Value heading = 2;
+}
diff --git a/third_party/googleapis/google/maps/routes/v1alpha/BUILD.bazel b/third_party/googleapis/google/maps/routes/v1alpha/BUILD.bazel
new file mode 100644
index 000000000..fd5a46c28
--- /dev/null
+++ b/third_party/googleapis/google/maps/routes/v1alpha/BUILD.bazel
@@ -0,0 +1,167 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
+proto_library(
+    name = "routes_proto",
+    srcs = [
+        "route_service.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/maps/routes/v1:routes_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "routes_java_proto",
+    deps = [":routes_proto"],
+)
+
+java_grpc_library(
+    name = "routes_java_grpc",
+    srcs = [":routes_proto"],
+    deps = [":routes_java_proto"],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_proto_library",
+)
+
+go_proto_library(
+    name = "routes_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/maps/routes/v1alpha",
+    protos = [":routes_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/maps/routes/v1:routes_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "routes_moved_proto",
+    srcs = [":routes_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/maps/routes/v1:routes_proto",
+    ],
+)
+
+py_proto_library(
+    name = "routes_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":routes_moved_proto"],
+)
+
+py_grpc_library(
+    name = "routes_py_grpc",
+    srcs = [":routes_moved_proto"],
+    deps = [":routes_py_proto"],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "routes_php_proto",
+    deps = [":routes_proto"],
+)
+
+php_grpc_library(
+    name = "routes_php_grpc",
+    srcs = [":routes_proto"],
+    deps = [":routes_php_proto"],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "routes_ruby_proto",
+    deps = [":routes_proto"],
+)
+
+ruby_grpc_library(
+    name = "routes_ruby_grpc",
+    srcs = [":routes_proto"],
+    deps = [":routes_ruby_proto"],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "routes_csharp_proto",
+    deps = [":routes_proto"],
+)
+
+csharp_grpc_library(
+    name = "routes_csharp_grpc",
+    srcs = [":routes_proto"],
+    deps = [":routes_csharp_proto"],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ code here
diff --git a/third_party/googleapis/google/maps/routes/v1alpha/route_service.proto b/third_party/googleapis/google/maps/routes/v1alpha/route_service.proto
new file mode 100644
index 000000000..00858c7f6
--- /dev/null
+++ b/third_party/googleapis/google/maps/routes/v1alpha/route_service.proto
@@ -0,0 +1,89 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.maps.routes.v1alpha;
+
+import "google/api/annotations.proto";
+import "google/maps/routes/v1/compute_route_matrix_request.proto";
+import "google/maps/routes/v1/compute_routes_request.proto";
+import "google/maps/routes/v1/compute_routes_response.proto";
+import "google/maps/routes/v1/route_matrix_element.proto";
+import "google/api/client.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Maps.Routes.V1Alpha";
+option go_package = "google.golang.org/genproto/googleapis/maps/routes/v1alpha;routes";
+option java_multiple_files = true;
+option java_outer_classname = "RoutesServiceAlphaProto";
+option java_package = "com.google.maps.routes.v1alpha";
+option objc_class_prefix = "GMRS";
+option php_namespace = "Google\\Maps\\Routes\\V1alpha";
+
+// The Routes Preferred API.
+service RoutesAlpha {
+  option (google.api.default_host) = "routespreferred.googleapis.com";
+
+  // Returns the primary route along with optional alternate routes, given a set
+  // of terminal and intermediate waypoints.
+  //
+  // **NOTE:** This method requires that you specify a response field mask in
+  // the input. You can provide the response field mask by using URL parameter
+  // `$fields` or `fields`, or by using an HTTP/gRPC header `X-Goog-FieldMask`
+  // (see the [available URL parameters and
+  // headers](https://cloud.google.com/apis/docs/system-parameters). The value
+  // is a comma separated list of field paths. See detailed documentation about
+  // [how to construct the field
+  // paths](https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/field_mask.proto).
+  //
+  // For example, in this method:
+  //
+  // * Field mask of all available fields (for manual inspection):
+  //   `X-Goog-FieldMask: *`
+  // * Field mask of Route-level duration, distance, and polyline (an example
+  // production setup):
+  //   `X-Goog-FieldMask:
+  //   routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline`
+  //
+  // Google discourage the use of the wildcard (`*`) response field mask, or
+  // specifying the field mask at the top level (`routes`), because:
+  //
+  // * Selecting only the fields that you need helps our server save computation
+  // cycles, allowing us to return the result to you with a lower latency.
+  // * Selecting only the fields that you need
+  // in your production job ensures stable latency performance. We might add
+  // more response fields in the future, and those new fields might require
+  // extra computation time. If you select all fields, or if you select all
+  // fields at the top level, then you might experience performance degradation
+  // because any new field we add will be automatically included in the
+  // response.
+  // * Selecting only the fields that you need results in a smaller response
+  // size, and thus higher network throughput.
+  rpc ComputeRoutes(google.maps.routes.v1.ComputeRoutesRequest) returns (google.maps.routes.v1.ComputeRoutesResponse) {
+    option (google.api.http) = {
+      post: "/v1alpha:computeRoutes"
+      body: "*"
+    };
+  }
+
+  // Takes in a list of origins and destinations and returns a stream containing
+  // route information for each combination of origin and destination.
+  rpc ComputeRouteMatrix(google.maps.routes.v1.ComputeRouteMatrixRequest) returns (stream google.maps.routes.v1.RouteMatrixElement) {
+    option (google.api.http) = {
+      post: "/v1alpha:computeRouteMatrix"
+      body: "*"
+    };
+  }
+}
diff --git a/third_party/googleapis/google/maps/routes/v1alpha/routespreferred_v1alpha.yaml b/third_party/googleapis/google/maps/routes/v1alpha/routespreferred_v1alpha.yaml
new file mode 100644
index 000000000..6d87f361c
--- /dev/null
+++ b/third_party/googleapis/google/maps/routes/v1alpha/routespreferred_v1alpha.yaml
@@ -0,0 +1,7 @@
+type: google.api.Service
+config_version: 3
+name: routespreferred.googleapis.com
+title: Routes Preferred API
+
+apis:
+- name: google.maps.routes.v1alpha.RoutesAlpha
diff --git a/third_party/googleapis/google/maps/routespreferred/v1/BUILD.bazel b/third_party/googleapis/google/maps/routespreferred/v1/BUILD.bazel
new file mode 100644
index 000000000..3f063176f
--- /dev/null
+++ b/third_party/googleapis/google/maps/routespreferred/v1/BUILD.bazel
@@ -0,0 +1,109 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+load("//google/maps:postprocessing.bzl", "maps_assembly_pkg")
+
+alias(
+    name = "routes_proto",
+    actual = "//google/maps/routes/v1:routes_proto",
+)
+
+alias(
+    name = "routes_proto_with_info",
+    actual = "//google/maps/routes/v1:routes_proto_with_info",
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_gapic_library(
+    name = "routespreferred_java_gapic",
+    src = ":routes_proto_with_info",
+    gapic_yaml = "routespreferred_gapic.yaml",
+    package = "google.maps.routespreferred.v1",
+    service_yaml = "routespreferred_v1.yaml",
+    test_deps = [
+        "//google/maps/routes/v1:routes_java_grpc",
+    ],
+    deps = [
+        "//google/maps/routes/v1:routes_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "routespreferred_java_gapic_test_suite",
+    test_classes = [
+        "com.google.maps.routespreferred.v1.RoutesPreferredClientTest",
+    ],
+    runtime_deps = [":routespreferred_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-maps-routespreferred-v1-java",
+    deps = [
+        ":routespreferred_java_gapic",
+        "//google/maps/routes/v1:routes_java_grpc",  # needed for test mocks
+    ],
+)
+
+maps_assembly_pkg(
+    name = "google-maps-routespreferred-v1-java-postprocess",
+    srcs = [":google-maps-routespreferred-v1-java"],
+    language = "java",
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_gapic_library(
+    name = "routespreferred_go_gapic",
+    srcs = [":routes_proto_with_info"],
+    grpc_service_config = "",
+    importpath = "developers.google.com/maps/go/routespreferred/v1;routes",
+    service_yaml = "routespreferred_v1.yaml",
+    deps = [
+        "//google/maps/routes/v1:routes_go_proto",
+    ],
+)
+
+go_test(
+    name = "routespreferred_go_gapic_test",
+    srcs = [":routespreferred_go_gapic_srcjar_test"],
+    embed = [":routespreferred_go_gapic"],
+    importpath = "developers.google.com/maps/go/routespreferred/v1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapic-maps-routespreferred-v1-go",
+    deps = [
+        ":routespreferred_go_gapic",
+        ":routespreferred_go_gapic_srcjar-test.srcjar",
+        "//google/maps/routes/v1:routes_go_proto",
+    ],
+)
diff --git a/third_party/googleapis/google/maps/routespreferred/v1/routespreferred_gapic.yaml b/third_party/googleapis/google/maps/routespreferred/v1/routespreferred_gapic.yaml
new file mode 100644
index 000000000..1d2a10060
--- /dev/null
+++ b/third_party/googleapis/google/maps/routespreferred/v1/routespreferred_gapic.yaml
@@ -0,0 +1,33 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.maps.routespreferred.v1
+  go:
+    package_name: developers.google.com/maps/go/routespreferred/v1
+interfaces:
+- name: google.maps.routes.v1.RoutesPreferred
+  collections: []
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 30000
+    initial_rpc_timeout_millis: 30000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 30000
+    total_timeout_millis: 300000
+  methods:
+  - name: ComputeRoutes
+    required_fields:
+    - origin
+    - destination
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 30000
diff --git a/third_party/googleapis/google/maps/routespreferred/v1/routespreferred_v1.yaml b/third_party/googleapis/google/maps/routespreferred/v1/routespreferred_v1.yaml
new file mode 100644
index 000000000..a365ce2e9
--- /dev/null
+++ b/third_party/googleapis/google/maps/routespreferred/v1/routespreferred_v1.yaml
@@ -0,0 +1,7 @@
+type: google.api.Service
+config_version: 3
+name: routespreferred.googleapis.com
+title: Routes Preferred API
+
+apis:
+- name: google.maps.routes.v1.RoutesPreferred
diff --git a/third_party/googleapis/google/maps/unity/clientinfo.proto b/third_party/googleapis/google/maps/unity/clientinfo.proto
new file mode 100644
index 000000000..a6c3010da
--- /dev/null
+++ b/third_party/googleapis/google/maps/unity/clientinfo.proto
@@ -0,0 +1,87 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.maps.unity;
+
+option csharp_namespace = "Google.Maps.Unity";
+option go_package = "google.golang.org/genproto/googleapis/maps/unity;unity";
+option java_multiple_files = true;
+option java_outer_classname = "ClientInfoProto";
+option java_package = "com.google.maps.unity";
+option objc_class_prefix = "GMU";
+
+// Client information.
+message ClientInfo {
+  // Platform enum.
+  enum Platform {
+    // Unspecified or unknown OS.
+    PLATFORM_UNSPECIFIED = 0;
+
+    // Development environment.
+    EDITOR = 1;
+
+    // macOS.
+    MAC_OS = 2;
+
+    // Windows.
+    WINDOWS = 3;
+
+    // Linux
+    LINUX = 4;
+
+    // Android
+    ANDROID = 5;
+
+    // iOS
+    IOS = 6;
+
+    // WebGL.
+    WEB_GL = 7;
+  }
+
+  // Application ID, such as the package name on Android and the bundle
+  // identifier on iOS platforms.
+  string application_id = 1;
+
+  // Application version number, such as "1.2.3". The exact format is
+  // application-dependent.
+  string application_version = 2;
+
+  // Platform where the application is running.
+  Platform platform = 3;
+
+  // Operating system name and version as reported by the OS. For example,
+  // "Mac OS X 10.10.4". The exact format is platform-dependent.
+  string operating_system = 4;
+
+  // API client name and version. For example, the SDK calling the API. The
+  // exact format is up to the client.
+  string api_client = 5;
+
+  // Device model as reported by the device. The exact format is
+  // platform-dependent.
+  string device_model = 6;
+
+  // Language code (in BCP-47 format) indicating the UI language of the client.
+  // Examples are "en", "en-US" or "ja-Latn". For more information, see
+  // http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
+  string language_code = 7;
+
+  // Build number/version of the operating system. e.g., the contents of
+  // android.os.Build.ID in Android, or the contents of sysctl "kern.osversion"
+  // in iOS.
+  string operating_system_build = 8;
+}
diff --git a/third_party/googleapis/google/monitoring/BUILD.bazel b/third_party/googleapis/google/monitoring/BUILD.bazel
index 1e5b8c2af..a87c57fec 100644
--- a/third_party/googleapis/google/monitoring/BUILD.bazel
+++ b/third_party/googleapis/google/monitoring/BUILD.bazel
@@ -1 +1 @@
-exports_files(glob(["*.yaml"]))
\ No newline at end of file
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/monitoring/artman_monitoring.yaml b/third_party/googleapis/google/monitoring/artman_monitoring.yaml
index 8ff5101ac..096ace1d0 100644
--- a/third_party/googleapis/google/monitoring/artman_monitoring.yaml
+++ b/third_party/googleapis/google/monitoring/artman_monitoring.yaml
@@ -2,8 +2,8 @@ common:
   api_name: monitoring
   api_version: v3
   organization_name: google-cloud
-  service_yaml: monitoring.yaml
-  gapic_yaml: v3/monitoring_gapic.yaml
+  service_yaml: v3/monitoring.yaml
+  gapic_yaml: v3/monitoring_gapic.legacy.yaml
   src_proto_paths:
   - v3
   proto_deps:
diff --git a/third_party/googleapis/google/monitoring/dashboard/v1/BUILD.bazel b/third_party/googleapis/google/monitoring/dashboard/v1/BUILD.bazel
new file mode 100644
index 000000000..31164b6a8
--- /dev/null
+++ b/third_party/googleapis/google/monitoring/dashboard/v1/BUILD.bazel
@@ -0,0 +1,388 @@
+# This file was created manually
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "dashboard_proto",
+    srcs = [
+        "common.proto",
+        "dashboard.proto",
+        "dashboards_service.proto",
+        "drilldowns.proto",
+        "layouts.proto",
+        "metrics.proto",
+        "scorecard.proto",
+        "service.proto",
+        "text.proto",
+        "widget.proto",
+        "xychart.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "dashboard_proto_with_info",
+    deps = [
+        ":dashboard_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "dashboard_java_proto",
+    deps = [":dashboard_proto"],
+)
+
+java_grpc_library(
+    name = "dashboard_java_grpc",
+    srcs = [":dashboard_proto"],
+    deps = [":dashboard_java_proto"],
+)
+
+java_gapic_library(
+    name = "dashboard_java_gapic",
+    src = ":dashboard_proto_with_info",
+    gapic_yaml = "monitoring_gapic.yaml",
+    package = "google.monitoring.dashboard.v1",
+    service_yaml = "monitoring.yaml",
+    test_deps = [
+        ":dashboard_java_grpc",
+    ],
+    deps = [
+        ":dashboard_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "dashboard_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.monitoring.dashboard.v1.DashboardsServiceClientTest",
+    ],
+    runtime_deps = [":dashboard_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-monitoring-dashboard-v1-java",
+    deps = [
+        ":dashboard_java_gapic",
+        ":dashboard_java_grpc",
+        ":dashboard_java_proto",
+        ":dashboard_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "dashboard_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/monitoring/dashboard/v1",
+    protos = [":dashboard_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "dashboard_go_gapic",
+    srcs = [":dashboard_proto_with_info"],
+    grpc_service_config = "",
+    importpath = "cloud.google.com/go/monitoring/dashboard/apiv1;dashboard",
+    service_yaml = "monitoring.yaml",
+    deps = [
+        ":dashboard_go_proto",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
+    ],
+)
+
+go_test(
+    name = "dashboard_go_gapic_test",
+    srcs = [":dashboard_go_gapic_srcjar_test"],
+    embed = [":dashboard_go_gapic"],
+    importpath = "cloud.google.com/go/monitoring/dashboard/apiv1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-monitoring-dashboard-v1-go",
+    deps = [
+        ":dashboard_go_gapic",
+        ":dashboard_go_gapic_srcjar-test.srcjar",
+        ":dashboard_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "dashboard_moved_proto",
+    srcs = [":dashboard_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+    ],
+)
+
+py_proto_library(
+    name = "dashboard_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":dashboard_moved_proto"],
+)
+
+py_grpc_library(
+    name = "dashboard_py_grpc",
+    srcs = [":dashboard_moved_proto"],
+    deps = [":dashboard_py_proto"],
+)
+
+py_gapic_library(
+    name = "dashboard_py_gapic",
+    src = ":dashboard_proto_with_info",
+    gapic_yaml = "monitoring_gapic.yaml",
+    package = "google.monitoring.dashboard.v1",
+    service_yaml = "monitoring.yaml",
+    deps = [
+        ":dashboard_py_grpc",
+        ":dashboard_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "monitoring-dashboard-v1-py",
+    deps = [
+        ":dashboard_py_gapic",
+        ":dashboard_py_grpc",
+        ":dashboard_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "dashboard_php_proto",
+    deps = [":dashboard_proto"],
+)
+
+php_grpc_library(
+    name = "dashboard_php_grpc",
+    srcs = [":dashboard_proto"],
+    deps = [":dashboard_php_proto"],
+)
+
+php_gapic_library(
+    name = "dashboard_php_gapic",
+    src = ":dashboard_proto_with_info",
+    gapic_yaml = "monitoring_gapic.yaml",
+    package = "google.monitoring.dashboard.v1",
+    service_yaml = "monitoring.yaml",
+    deps = [
+        ":dashboard_php_grpc",
+        ":dashboard_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-monitoring-dashboard-v1-php",
+    deps = [
+        ":dashboard_php_gapic",
+        ":dashboard_php_grpc",
+        ":dashboard_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "dashboard_nodejs_gapic",
+    src = ":dashboard_proto_with_info",
+    gapic_yaml = "monitoring_gapic.yaml",
+    package = "google.monitoring.dashboard.v1",
+    service_yaml = "monitoring.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "monitoring-dashboard-v1-nodejs",
+    deps = [
+        ":dashboard_nodejs_gapic",
+        ":dashboard_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "dashboard_ruby_proto",
+    deps = [":dashboard_proto"],
+)
+
+ruby_grpc_library(
+    name = "dashboard_ruby_grpc",
+    srcs = [":dashboard_proto"],
+    deps = [":dashboard_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "dashboard_ruby_gapic",
+    src = ":dashboard_proto_with_info",
+    gapic_yaml = "monitoring_gapic.yaml",
+    package = "google.monitoring.dashboard.v1",
+    service_yaml = "monitoring.yaml",
+    deps = [
+        ":dashboard_ruby_grpc",
+        ":dashboard_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-monitoring-dashboard-v1-ruby",
+    deps = [
+        ":dashboard_ruby_gapic",
+        ":dashboard_ruby_grpc",
+        ":dashboard_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "dashboard_csharp_proto",
+    deps = [":dashboard_proto"],
+)
+
+csharp_grpc_library(
+    name = "dashboard_csharp_grpc",
+    srcs = [":dashboard_proto"],
+    deps = [":dashboard_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "dashboard_csharp_gapic",
+    src = ":dashboard_proto_with_info",
+    gapic_yaml = "monitoring_gapic.yaml",
+    package = "google.monitoring.dashboard.v1",
+    service_yaml = "monitoring.yaml",
+    deps = [
+        ":dashboard_csharp_grpc",
+        ":dashboard_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-monitoring-dashboard-v1-csharp",
+    deps = [
+        ":dashboard_csharp_gapic",
+        ":dashboard_csharp_grpc",
+        ":dashboard_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "cc_grpc_library",
+    "cc_proto_library",
+)
+
+cc_proto_library(
+    name = "dashboard_cc_proto",
+    deps = [":dashboard_proto"],
+)
+
+cc_grpc_library(
+    name = "dashboard_cc_grpc",
+    srcs = [":dashboard_proto"],
+    generate_mocks = True,
+    grpc_only = True,
+    deps = [":dashboard_cc_proto"],
+)
diff --git a/third_party/googleapis/google/monitoring/dashboard/v1/artman_monitoring.yaml b/third_party/googleapis/google/monitoring/dashboard/v1/artman_monitoring.yaml
new file mode 100644
index 000000000..8ddee16bb
--- /dev/null
+++ b/third_party/googleapis/google/monitoring/dashboard/v1/artman_monitoring.yaml
@@ -0,0 +1,36 @@
+common:
+  api_name: monitoring
+  api_version: v1
+  organization_name: google-cloud
+  service_yaml: monitoring.yaml
+  gapic_yaml: monitoring_gapic.yaml
+  src_proto_paths:
+  - .
+  proto_deps:
+  - name: google-common-protos
+artifacts:
+- name: java_gapic
+  type: GAPIC
+  language: JAVA
+  release_level: GA
+- name: python_gapic
+  type: GAPIC
+  language: PYTHON
+- name: php_gapic
+  type: GAPIC
+  language: PHP
+- name: ruby_gapic
+  type: GAPIC
+  language: RUBY
+- name: go_gapic
+  type: GAPIC
+  language: GO
+- name: csharp_gapic
+  type: GAPIC
+  language: CSHARP
+- name: nodejs_gapic
+  type: GAPIC
+  language: NODEJS
+  release_level: BETA
+- name: gapic_config
+  type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/monitoring/dashboard/v1/common.proto b/third_party/googleapis/google/monitoring/dashboard/v1/common.proto
new file mode 100644
index 000000000..4ab3f5312
--- /dev/null
+++ b/third_party/googleapis/google/monitoring/dashboard/v1/common.proto
@@ -0,0 +1,398 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.monitoring.dashboard.v1;
+
+import "google/protobuf/duration.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/monitoring/dashboard/v1;dashboard";
+option ruby_package = "Google::Cloud::Monitoring::Dashboard::V1";
+option java_multiple_files = true;
+option java_outer_classname = "CommonProto";
+option java_package = "com.google.monitoring.dashboard.v1";
+
+// Describes how to combine multiple time series to provide different views of
+// the data.  Aggregation consists of an alignment step on individual time
+// series (`alignment_period` and `per_series_aligner`) followed by an optional
+// reduction step of the data across the aligned time series
+// (`cross_series_reducer` and `group_by_fields`).  For more details, see
+// [Aggregation](/monitoring/api/learn_more#aggregation).
+message Aggregation {
+  // The Aligner describes how to bring the data points in a single
+  // time series into temporal alignment.
+  enum Aligner {
+    // No alignment. Raw data is returned. Not valid if cross-time
+    // series reduction is requested. The value type of the result is
+    // the same as the value type of the input.
+    ALIGN_NONE = 0;
+
+    // Align and convert to delta metric type. This alignment is valid
+    // for cumulative metrics and delta metrics. Aligning an existing
+    // delta metric to a delta metric requires that the alignment
+    // period be increased. The value type of the result is the same
+    // as the value type of the input.
+    //
+    // One can think of this aligner as a rate but without time units; that
+    // is, the output is conceptually (second_point - first_point).
+    ALIGN_DELTA = 1;
+
+    // Align and convert to a rate. This alignment is valid for
+    // cumulative metrics and delta metrics with numeric values. The output is a
+    // gauge metric with value type
+    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE].
+    //
+    // One can think of this aligner as conceptually providing the slope of
+    // the line that passes through the value at the start and end of the
+    // window. In other words, this is conceptually ((y1 - y0)/(t1 - t0)),
+    // and the output unit is one that has a "/time" dimension.
+    //
+    // If, by rate, you are looking for percentage change, see the
+    // `ALIGN_PERCENT_CHANGE` aligner option.
+    ALIGN_RATE = 2;
+
+    // Align by interpolating between adjacent points around the
+    // period boundary. This alignment is valid for gauge
+    // metrics with numeric values. The value type of the result is the same
+    // as the value type of the input.
+    ALIGN_INTERPOLATE = 3;
+
+    // Align by shifting the oldest data point before the period
+    // boundary to the boundary. This alignment is valid for gauge
+    // metrics. The value type of the result is the same as the
+    // value type of the input.
+    ALIGN_NEXT_OLDER = 4;
+
+    // Align time series via aggregation. The resulting data point in
+    // the alignment period is the minimum of all data points in the
+    // period. This alignment is valid for gauge and delta metrics with numeric
+    // values. The value type of the result is the same as the value
+    // type of the input.
+    ALIGN_MIN = 10;
+
+    // Align time series via aggregation. The resulting data point in
+    // the alignment period is the maximum of all data points in the
+    // period. This alignment is valid for gauge and delta metrics with numeric
+    // values. The value type of the result is the same as the value
+    // type of the input.
+    ALIGN_MAX = 11;
+
+    // Align time series via aggregation. The resulting data point in
+    // the alignment period is the average or arithmetic mean of all
+    // data points in the period. This alignment is valid for gauge and delta
+    // metrics with numeric values. The value type of the output is
+    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE].
+    ALIGN_MEAN = 12;
+
+    // Align time series via aggregation. The resulting data point in
+    // the alignment period is the count of all data points in the
+    // period. This alignment is valid for gauge and delta metrics with numeric
+    // or Boolean values. The value type of the output is
+    // [INT64][google.api.MetricDescriptor.ValueType.INT64].
+    ALIGN_COUNT = 13;
+
+    // Align time series via aggregation. The resulting data point in
+    // the alignment period is the sum of all data points in the
+    // period. This alignment is valid for gauge and delta metrics with numeric
+    // and distribution values. The value type of the output is the
+    // same as the value type of the input.
+    ALIGN_SUM = 14;
+
+    // Align time series via aggregation. The resulting data point in
+    // the alignment period is the standard deviation of all data
+    // points in the period. This alignment is valid for gauge and delta metrics
+    // with numeric values. The value type of the output is
+    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE].
+    ALIGN_STDDEV = 15;
+
+    // Align time series via aggregation. The resulting data point in
+    // the alignment period is the count of True-valued data points in the
+    // period. This alignment is valid for gauge metrics with
+    // Boolean values. The value type of the output is
+    // [INT64][google.api.MetricDescriptor.ValueType.INT64].
+    ALIGN_COUNT_TRUE = 16;
+
+    // Align time series via aggregation. The resulting data point in
+    // the alignment period is the count of False-valued data points in the
+    // period. This alignment is valid for gauge metrics with
+    // Boolean values. The value type of the output is
+    // [INT64][google.api.MetricDescriptor.ValueType.INT64].
+    ALIGN_COUNT_FALSE = 24;
+
+    // Align time series via aggregation. The resulting data point in
+    // the alignment period is the fraction of True-valued data points in the
+    // period. This alignment is valid for gauge metrics with Boolean values.
+    // The output value is in the range [0, 1] and has value type
+    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE].
+    ALIGN_FRACTION_TRUE = 17;
+
+    // Align time series via aggregation. The resulting data point in
+    // the alignment period is the 99th percentile of all data
+    // points in the period. This alignment is valid for gauge and delta metrics
+    // with distribution values. The output is a gauge metric with value type
+    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE].
+    ALIGN_PERCENTILE_99 = 18;
+
+    // Align time series via aggregation. The resulting data point in
+    // the alignment period is the 95th percentile of all data
+    // points in the period. This alignment is valid for gauge and delta metrics
+    // with distribution values. The output is a gauge metric with value type
+    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE].
+    ALIGN_PERCENTILE_95 = 19;
+
+    // Align time series via aggregation. The resulting data point in
+    // the alignment period is the 50th percentile of all data
+    // points in the period. This alignment is valid for gauge and delta metrics
+    // with distribution values. The output is a gauge metric with value type
+    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE].
+    ALIGN_PERCENTILE_50 = 20;
+
+    // Align time series via aggregation. The resulting data point in
+    // the alignment period is the 5th percentile of all data
+    // points in the period. This alignment is valid for gauge and delta metrics
+    // with distribution values. The output is a gauge metric with value type
+    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE].
+    ALIGN_PERCENTILE_05 = 21;
+
+    // Align and convert to a percentage change. This alignment is valid for
+    // gauge and delta metrics with numeric values. This alignment conceptually
+    // computes the equivalent of "((current - previous)/previous)*100"
+    // where previous value is determined based on the alignmentPeriod.
+    // In the event that previous is 0 the calculated value is infinity with the
+    // exception that if both (current - previous) and previous are 0 the
+    // calculated value is 0.
+    // A 10 minute moving mean is computed at each point of the time window
+    // prior to the above calculation to smooth the metric and prevent false
+    // positives from very short lived spikes.
+    // Only applicable for data that is >= 0. Any values < 0 are treated as
+    // no data. While delta metrics are accepted by this alignment special care
+    // should be taken that the values for the metric will always be positive.
+    // The output is a gauge metric with value type
+    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE].
+    ALIGN_PERCENT_CHANGE = 23;
+  }
+
+  // A Reducer describes how to aggregate data points from multiple
+  // time series into a single time series.
+  enum Reducer {
+    // No cross-time series reduction. The output of the aligner is
+    // returned.
+    REDUCE_NONE = 0;
+
+    // Reduce by computing the mean across time series for each
+    // alignment period. This reducer is valid for delta and
+    // gauge metrics with numeric or distribution values. The value type of the
+    // output is [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE].
+    REDUCE_MEAN = 1;
+
+    // Reduce by computing the minimum across time series for each
+    // alignment period. This reducer is valid for delta and
+    // gauge metrics with numeric values. The value type of the output
+    // is the same as the value type of the input.
+    REDUCE_MIN = 2;
+
+    // Reduce by computing the maximum across time series for each
+    // alignment period. This reducer is valid for delta and
+    // gauge metrics with numeric values. The value type of the output
+    // is the same as the value type of the input.
+    REDUCE_MAX = 3;
+
+    // Reduce by computing the sum across time series for each
+    // alignment period. This reducer is valid for delta and
+    // gauge metrics with numeric and distribution values. The value type of
+    // the output is the same as the value type of the input.
+    REDUCE_SUM = 4;
+
+    // Reduce by computing the standard deviation across time series
+    // for each alignment period. This reducer is valid for delta
+    // and gauge metrics with numeric or distribution values. The value type of
+    // the output is [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE].
+    REDUCE_STDDEV = 5;
+
+    // Reduce by computing the count of data points across time series
+    // for each alignment period. This reducer is valid for delta
+    // and gauge metrics of numeric, Boolean, distribution, and string value
+    // type. The value type of the output is
+    // [INT64][google.api.MetricDescriptor.ValueType.INT64].
+    REDUCE_COUNT = 6;
+
+    // Reduce by computing the count of True-valued data points across time
+    // series for each alignment period. This reducer is valid for delta
+    // and gauge metrics of Boolean value type. The value type of
+    // the output is [INT64][google.api.MetricDescriptor.ValueType.INT64].
+    REDUCE_COUNT_TRUE = 7;
+
+    // Reduce by computing the count of False-valued data points across time
+    // series for each alignment period. This reducer is valid for delta
+    // and gauge metrics of Boolean value type. The value type of
+    // the output is [INT64][google.api.MetricDescriptor.ValueType.INT64].
+    REDUCE_COUNT_FALSE = 15;
+
+    // Reduce by computing the fraction of True-valued data points across time
+    // series for each alignment period. This reducer is valid for delta
+    // and gauge metrics of Boolean value type. The output value is in the
+    // range [0, 1] and has value type
+    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE].
+    REDUCE_FRACTION_TRUE = 8;
+
+    // Reduce by computing 99th percentile of data points across time series
+    // for each alignment period. This reducer is valid for gauge and delta
+    // metrics of numeric and distribution type. The value of the output is
+    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE]
+    REDUCE_PERCENTILE_99 = 9;
+
+    // Reduce by computing 95th percentile of data points across time series
+    // for each alignment period. This reducer is valid for gauge and delta
+    // metrics of numeric and distribution type. The value of the output is
+    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE]
+    REDUCE_PERCENTILE_95 = 10;
+
+    // Reduce by computing 50th percentile of data points across time series
+    // for each alignment period. This reducer is valid for gauge and delta
+    // metrics of numeric and distribution type. The value of the output is
+    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE]
+    REDUCE_PERCENTILE_50 = 11;
+
+    // Reduce by computing 5th percentile of data points across time series
+    // for each alignment period. This reducer is valid for gauge and delta
+    // metrics of numeric and distribution type. The value of the output is
+    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE]
+    REDUCE_PERCENTILE_05 = 12;
+  }
+
+  // The alignment period for per-[time series][TimeSeries]
+  // alignment. If present, `alignmentPeriod` must be at least 60
+  // seconds.  After per-time series alignment, each time series will
+  // contain data points only on the period boundaries. If
+  // `perSeriesAligner` is not specified or equals `ALIGN_NONE`, then
+  // this field is ignored. If `perSeriesAligner` is specified and
+  // does not equal `ALIGN_NONE`, then this field must be defined;
+  // otherwise an error is returned.
+  google.protobuf.Duration alignment_period = 1;
+
+  // The approach to be used to align individual time series. Not all
+  // alignment functions may be applied to all time series, depending
+  // on the metric type and value type of the original time
+  // series. Alignment may change the metric type or the value type of
+  // the time series.
+  //
+  // Time series data must be aligned in order to perform cross-time
+  // series reduction. If `crossSeriesReducer` is specified, then
+  // `perSeriesAligner` must be specified and not equal `ALIGN_NONE`
+  // and `alignmentPeriod` must be specified; otherwise, an error is
+  // returned.
+  Aligner per_series_aligner = 2;
+
+  // The approach to be used to combine time series. Not all reducer
+  // functions may be applied to all time series, depending on the
+  // metric type and the value type of the original time
+  // series. Reduction may change the metric type of value type of the
+  // time series.
+  //
+  // Time series data must be aligned in order to perform cross-time
+  // series reduction. If `crossSeriesReducer` is specified, then
+  // `perSeriesAligner` must be specified and not equal `ALIGN_NONE`
+  // and `alignmentPeriod` must be specified; otherwise, an error is
+  // returned.
+  Reducer cross_series_reducer = 4;
+
+  // The set of fields to preserve when `crossSeriesReducer` is
+  // specified. The `groupByFields` determine how the time series are
+  // partitioned into subsets prior to applying the aggregation
+  // function. Each subset contains time series that have the same
+  // value for each of the grouping fields. Each individual time
+  // series is a member of exactly one subset. The
+  // `crossSeriesReducer` is applied to each subset of time series.
+  // It is not possible to reduce across different resource types, so
+  // this field implicitly contains `resource.type`.  Fields not
+  // specified in `groupByFields` are aggregated away.  If
+  // `groupByFields` is not specified and all the time series have
+  // the same resource type, then the time series are aggregated into
+  // a single output time series. If `crossSeriesReducer` is not
+  // defined, this field is ignored.
+  repeated string group_by_fields = 5;
+}
+
+// Describes a ranking-based time series filter. Each input time series is
+// ranked with an aligner. The filter lets through up to `num_time_series` time
+// series, selecting them based on the relative ranking.
+message PickTimeSeriesFilter {
+  // The value reducers that can be applied to a PickTimeSeriesFilter.
+  enum Method {
+    // Not allowed in well-formed requests.
+    METHOD_UNSPECIFIED = 0;
+
+    // Select the mean of all values.
+    METHOD_MEAN = 1;
+
+    // Select the maximum value.
+    METHOD_MAX = 2;
+
+    // Select the minimum value.
+    METHOD_MIN = 3;
+
+    // Compute the sum of all values.
+    METHOD_SUM = 4;
+
+    // Select the most recent value.
+    METHOD_LATEST = 5;
+  }
+
+  // Describes the ranking directions.
+  enum Direction {
+    // Not allowed in well-formed requests.
+    DIRECTION_UNSPECIFIED = 0;
+
+    // Pass the highest ranking inputs.
+    TOP = 1;
+
+    // Pass the lowest ranking inputs.
+    BOTTOM = 2;
+  }
+
+  // `rankingMethod` is applied to each time series independently to produce the
+  // value which will be used to compare the time series to other time series.
+  Method ranking_method = 1;
+
+  // How many time series to return.
+  int32 num_time_series = 2;
+
+  // How to use the ranking to select time series that pass through the filter.
+  Direction direction = 3;
+}
+
+// A filter that ranks streams based on their statistical relation to other
+// streams in a request.
+message StatisticalTimeSeriesFilter {
+  // The filter methods that can be applied to a stream.
+  enum Method {
+    // Not allowed in well-formed requests.
+    METHOD_UNSPECIFIED = 0;
+
+    // Compute the outlier score of each stream.
+    METHOD_CLUSTER_OUTLIER = 1;
+  }
+
+  // `rankingMethod` is applied to a set of time series, and then the produced
+  // value for each individual time series is used to compare a given time
+  // series to others.
+  // These are methods that cannot be applied stream-by-stream, but rather
+  // require the full context of a request to evaluate time series.
+  Method ranking_method = 1;
+
+  // How many time series to output.
+  int32 num_time_series = 2;
+}
diff --git a/third_party/googleapis/google/monitoring/dashboard/v1/dashboard.proto b/third_party/googleapis/google/monitoring/dashboard/v1/dashboard.proto
new file mode 100644
index 000000000..b973f4e47
--- /dev/null
+++ b/third_party/googleapis/google/monitoring/dashboard/v1/dashboard.proto
@@ -0,0 +1,60 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.monitoring.dashboard.v1;
+
+import "google/monitoring/dashboard/v1/layouts.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/monitoring/dashboard/v1;dashboard";
+option ruby_package = "Google::Cloud::Monitoring::Dashboard::V1";
+option java_multiple_files = true;
+option java_outer_classname = "DashboardsProto";
+option java_package = "com.google.monitoring.dashboard.v1";
+
+// A Google Stackdriver dashboard. Dashboards define the content and layout
+// of pages in the Stackdriver web application.
+message Dashboard {
+  // The resource name of the dashboard.
+  string name = 1;
+
+  // The mutable, human-readable name.
+  string display_name = 2;
+
+  // `etag` is used for optimistic concurrency control as a way to help
+  // prevent simultaneous updates of a policy from overwriting each other.
+  // An `etag` is returned in the response to `GetDashboard`, and
+  // users are expected to put that etag in the request to `UpdateDashboard` to
+  // ensure that their change will be applied to the same version of the
+  // Dashboard configuration. The field should not be passed during
+  // dashboard creation.
+  string etag = 4;
+
+  // A dashboard's root container element that defines the layout style.
+  oneof layout {
+    // Content is arranged with a basic layout that re-flows a simple list of
+    // informational elements like widgets or tiles.
+    GridLayout grid_layout = 5;
+
+    // The content is divided into equally spaced rows and the widgets are
+    // arranged horizontally.
+    RowLayout row_layout = 8;
+
+    // The content is divided into equally spaced columns and the widgets are
+    // arranged vertically.
+    ColumnLayout column_layout = 9;
+  }
+}
diff --git a/third_party/googleapis/google/monitoring/dashboard/v1/dashboards_service.proto b/third_party/googleapis/google/monitoring/dashboard/v1/dashboards_service.proto
new file mode 100644
index 000000000..83dbc2149
--- /dev/null
+++ b/third_party/googleapis/google/monitoring/dashboard/v1/dashboards_service.proto
@@ -0,0 +1,159 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.monitoring.dashboard.v1;
+
+import "google/api/annotations.proto";
+import "google/api/field_behavior.proto";
+import "google/monitoring/dashboard/v1/dashboard.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+import "google/api/client.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/monitoring/dashboard/v1;dashboard";
+option ruby_package = "Google::Cloud::Monitoring::Dashboard::V1";
+option java_multiple_files = true;
+option java_outer_classname = "DashboardsServiceProto";
+option java_package = "com.google.monitoring.dashboard.v1";
+
+// Manages Stackdriver dashboards. A dashboard is an arrangement of data display
+// widgets in a specific layout.
+service DashboardsService {
+  option (google.api.default_host) = "monitoring.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/monitoring,"
+      "https://www.googleapis.com/auth/monitoring.read,"
+      "https://www.googleapis.com/auth/monitoring.write";
+
+  // Creates a new custom dashboard.
+  //
+  // This method requires the `monitoring.dashboards.create` permission
+  // on the specified project. For more information, see
+  // [Google Cloud IAM](https://cloud.google.com/iam).
+  rpc CreateDashboard(CreateDashboardRequest) returns (Dashboard) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*}/dashboards"
+      body: "dashboard"
+    };
+  }
+
+  // Lists the existing dashboards.
+  //
+  // This method requires the `monitoring.dashboards.list` permission
+  // on the specified project. For more information, see
+  // [Google Cloud IAM](https://cloud.google.com/iam).
+  rpc ListDashboards(ListDashboardsRequest) returns (ListDashboardsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*}/dashboards"
+    };
+  }
+
+  // Fetches a specific dashboard.
+  //
+  // This method requires the `monitoring.dashboards.get` permission
+  // on the specified dashboard. For more information, see
+  // [Google Cloud IAM](https://cloud.google.com/iam).
+  rpc GetDashboard(GetDashboardRequest) returns (Dashboard) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/dashboards/*}"
+    };
+  }
+
+  // Deletes an existing custom dashboard.
+  //
+  // This method requires the `monitoring.dashboards.delete` permission
+  // on the specified dashboard. For more information, see
+  // [Google Cloud IAM](https://cloud.google.com/iam).
+  rpc DeleteDashboard(DeleteDashboardRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/dashboards/*}"
+    };
+  }
+
+  // Replaces an existing custom dashboard with a new definition.
+  //
+  // This method requires the `monitoring.dashboards.update` permission
+  // on the specified dashboard. For more information, see
+  // [Google Cloud IAM](https://cloud.google.com/iam).
+  rpc UpdateDashboard(UpdateDashboardRequest) returns (Dashboard) {
+    option (google.api.http) = {
+      patch: "/v1/{dashboard.name=projects/*/dashboards/*}"
+      body: "dashboard"
+    };
+  }
+}
+
+// The `CreateDashboard` request.
+message CreateDashboardRequest {
+  // Required. The project on which to execute the request. The format is
+  // `"projects/{project_id_or_number}"`. The {project_id_or_number} must match
+  // the dashboard resource name.
+  string parent = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The initial dashboard specification.
+  Dashboard dashboard = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The `ListDashboards` request.
+message ListDashboardsRequest {
+  // Required. The scope of the dashboards to list. A project scope must be
+  // specified in the form of `"projects/{project_id_or_number}"`.
+  string parent = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // A positive number that is the maximum number of results to return.
+  // If unspecified, a default of 1000 is used.
+  int32 page_size = 2;
+
+  // If this field is not empty then it must contain the `nextPageToken` value
+  // returned by a previous call to this method.  Using this field causes the
+  // method to return additional results from the previous method call.
+  string page_token = 3;
+}
+
+// The `ListDashboards` request.
+message ListDashboardsResponse {
+  // The list of requested dashboards.
+  repeated Dashboard dashboards = 1;
+
+  // If there are more results than have been returned, then this field is set
+  // to a non-empty value.  To see the additional results,
+  // use that value as `pageToken` in the next call to this method.
+  string next_page_token = 2;
+}
+
+// The `GetDashboard` request.
+message GetDashboardRequest {
+  // Required. The resource name of the Dashboard. The format is one of
+  // `"dashboards/{dashboard_id}"` (for system dashboards) or
+  // `"projects/{project_id_or_number}/dashboards/{dashboard_id}"`
+  // (for custom dashboards).
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The `DeleteDashboard` request.
+message DeleteDashboardRequest {
+  // Required. The resource name of the Dashboard. The format is
+  // `"projects/{project_id_or_number}/dashboards/{dashboard_id}"`.
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The `UpdateDashboard` request.
+message UpdateDashboardRequest {
+  // Required. The dashboard that will replace the existing dashboard.
+  Dashboard dashboard = 1 [(google.api.field_behavior) = REQUIRED];
+}
diff --git a/third_party/googleapis/google/monitoring/dashboard/v1/drilldowns.proto b/third_party/googleapis/google/monitoring/dashboard/v1/drilldowns.proto
new file mode 100644
index 000000000..d551b48d0
--- /dev/null
+++ b/third_party/googleapis/google/monitoring/dashboard/v1/drilldowns.proto
@@ -0,0 +1,24 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.monitoring.dashboard.v1;
+
+option go_package = "google.golang.org/genproto/googleapis/monitoring/dashboard/v1;dashboard";
+option ruby_package = "Google::Cloud::Monitoring::Dashboard::V1";
+option java_multiple_files = true;
+option java_outer_classname = "DrilldownsProto";
+option java_package = "com.google.monitoring.dashboard.v1";
diff --git a/third_party/googleapis/google/monitoring/dashboard/v1/layouts.proto b/third_party/googleapis/google/monitoring/dashboard/v1/layouts.proto
new file mode 100644
index 000000000..278c77050
--- /dev/null
+++ b/third_party/googleapis/google/monitoring/dashboard/v1/layouts.proto
@@ -0,0 +1,75 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.monitoring.dashboard.v1;
+
+import "google/monitoring/dashboard/v1/widget.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/monitoring/dashboard/v1;dashboard";
+option ruby_package = "Google::Cloud::Monitoring::Dashboard::V1";
+option java_multiple_files = true;
+option java_outer_classname = "LayoutsProto";
+option java_package = "com.google.monitoring.dashboard.v1";
+
+// A basic layout divides the available space into vertical columns of equal
+// width and arranges a list of widgets using a row-first strategy.
+message GridLayout {
+  // The number of columns into which the view's width is divided. If omitted
+  // or set to zero, a system default will be used while rendering.
+  int64 columns = 1;
+
+  // The informational elements that are arranged into the columns row-first.
+  repeated Widget widgets = 2;
+}
+
+// A simplified layout that divides the available space into rows
+// and arranges a set of widgets horizontally in each row.
+message RowLayout {
+  // Defines the layout properties and content for a row.
+  message Row {
+    // The relative weight of this row. The row weight is used to adjust the
+    // height of rows on the screen (relative to peers). Greater the weight,
+    // greater the height of the row on the screen. If omitted, a value
+    // of 1 is used while rendering.
+    int64 weight = 1;
+
+    // The display widgets arranged horizontally in this row.
+    repeated Widget widgets = 2;
+  }
+
+  // The rows of content to display.
+  repeated Row rows = 1;
+}
+
+// A simplified layout that divides the available space into vertical columns
+// and arranges a set of widgets vertically in each column.
+message ColumnLayout {
+  // Defines the layout properties and content for a column.
+  message Column {
+    // The relative weight of this column. The column weight is used to adjust
+    // the width of columns on the screen (relative to peers).
+    // Greater the weight, greater the width of the column on the screen.
+    // If omitted, a value of 1 is used while rendering.
+    int64 weight = 1;
+
+    // The display widgets arranged vertically in this column.
+    repeated Widget widgets = 2;
+  }
+
+  // The columns of content to display.
+  repeated Column columns = 1;
+}
diff --git a/third_party/googleapis/google/monitoring/dashboard/v1/metrics.proto b/third_party/googleapis/google/monitoring/dashboard/v1/metrics.proto
new file mode 100644
index 000000000..1487c3003
--- /dev/null
+++ b/third_party/googleapis/google/monitoring/dashboard/v1/metrics.proto
@@ -0,0 +1,166 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.monitoring.dashboard.v1;
+
+import "google/api/field_behavior.proto";
+import "google/monitoring/dashboard/v1/common.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/monitoring/dashboard/v1;dashboard";
+option ruby_package = "Google::Cloud::Monitoring::Dashboard::V1";
+option java_multiple_files = true;
+option java_outer_classname = "MetricsProto";
+option java_package = "com.google.monitoring.dashboard.v1";
+
+// TimeSeriesQuery collects the set of supported methods for querying time
+// series data from the Stackdriver metrics API.
+message TimeSeriesQuery {
+  // Parameters needed to obtain data for the chart.
+  oneof source {
+    // Filter parameters to fetch time series.
+    TimeSeriesFilter time_series_filter = 1;
+
+    // Parameters to fetch a ratio between two time series filters.
+    TimeSeriesFilterRatio time_series_filter_ratio = 2;
+  }
+
+  // The unit of data contained in fetched time series. If non-empty, this
+  // unit will override any unit that accompanies fetched data. The format is
+  // the same as the
+  // [`unit`](/monitoring/api/ref_v3/rest/v3/projects.metricDescriptors)
+  // field in `MetricDescriptor`.
+  string unit_override = 5;
+}
+
+// A filter that defines a subset of time series data that is displayed in a
+// widget. Time series data is fetched using the
+// [`ListTimeSeries`](/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list)
+// method.
+message TimeSeriesFilter {
+  // Required. The [monitoring filter](/monitoring/api/v3/filters) that identifies the
+  // metric types, resources, and projects to query.
+  string filter = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // By default, the raw time series data is returned.
+  // Use this field to combine multiple time series for different views of the
+  // data.
+  Aggregation aggregation = 2;
+
+  // Selects an optional time series filter.
+  oneof output_filter {
+    // Ranking based time series filter.
+    PickTimeSeriesFilter pick_time_series_filter = 4;
+
+    // Statistics based time series filter.
+    StatisticalTimeSeriesFilter statistical_time_series_filter = 5;
+  }
+}
+
+// A pair of time series filters that define a ratio computation. The output
+// time series is the pair-wise division of each aligned element from the
+// numerator and denominator time series.
+message TimeSeriesFilterRatio {
+  // Describes a query to build the numerator or denominator of a
+  // TimeSeriesFilterRatio.
+  message RatioPart {
+    // Required. The [monitoring filter](/monitoring/api/v3/filters) that identifies the
+    // metric types, resources, and projects to query.
+    string filter = 1 [(google.api.field_behavior) = REQUIRED];
+
+    // By default, the raw time series data is returned.
+    // Use this field to combine multiple time series for different views of the
+    // data.
+    Aggregation aggregation = 2;
+  }
+
+  // The numerator of the ratio.
+  RatioPart numerator = 1;
+
+  // The denominator of the ratio.
+  RatioPart denominator = 2;
+
+  // Apply a second aggregation after the ratio is computed.
+  Aggregation secondary_aggregation = 3;
+
+  // Selects an optional filter that is applied to the time series after
+  // computing the ratio.
+  oneof output_filter {
+    // Ranking based time series filter.
+    PickTimeSeriesFilter pick_time_series_filter = 4;
+
+    // Statistics based time series filter.
+    StatisticalTimeSeriesFilter statistical_time_series_filter = 5;
+  }
+}
+
+// Defines a threshold for categorizing time series values.
+message Threshold {
+  // The color suggests an interpretation to the viewer when actual values cross
+  // the threshold. Comments on each color provide UX guidance on how users can
+  // be expected to interpret a given state color.
+  enum Color {
+    // Color is unspecified. Not allowed in well-formed requests.
+    COLOR_UNSPECIFIED = 0;
+
+    // Crossing the threshold is "concerning" behavior.
+    YELLOW = 4;
+
+    // Crossing the threshold is "emergency" behavior.
+    RED = 6;
+  }
+
+  // Whether the threshold is considered crossed by an actual value above or
+  // below its threshold value.
+  enum Direction {
+    // Not allowed in well-formed requests.
+    DIRECTION_UNSPECIFIED = 0;
+
+    // The threshold will be considered crossed if the actual value is above
+    // the threshold value.
+    ABOVE = 1;
+
+    // The threshold will be considered crossed if the actual value is below
+    // the threshold value.
+    BELOW = 2;
+  }
+
+  // A label for the threshold.
+  string label = 1;
+
+  // The value of the threshold. The value should be defined in the native scale
+  // of the metric.
+  double value = 2;
+
+  // The state color for this threshold. Color is not allowed in a XyChart.
+  Color color = 3;
+
+  // The direction for the current threshold. Direction is not allowed in a
+  // XyChart.
+  Direction direction = 4;
+}
+
+// Defines the possible types of spark chart supported by the `Scorecard`.
+enum SparkChartType {
+  // Not allowed in well-formed requests.
+  SPARK_CHART_TYPE_UNSPECIFIED = 0;
+
+  // The sparkline will be rendered as a small line chart.
+  SPARK_LINE = 1;
+
+  // The sparkbar will be rendered as a small bar chart.
+  SPARK_BAR = 2;
+}
diff --git a/third_party/googleapis/google/monitoring/dashboard/v1/monitoring.yaml b/third_party/googleapis/google/monitoring/dashboard/v1/monitoring.yaml
new file mode 100644
index 000000000..25f31317f
--- /dev/null
+++ b/third_party/googleapis/google/monitoring/dashboard/v1/monitoring.yaml
@@ -0,0 +1,32 @@
+type: google.api.Service
+config_version: 3
+name: monitoring.googleapis.com
+title: Stackdriver Monitoring Dashboards API
+
+apis:
+- name: google.monitoring.dashboard.v1.DashboardsService
+
+documentation:
+  summary: |-
+   Manages dashboard configurations used in the Stackdriver UI.
+
+authentication:
+  rules:
+  - selector: 'google.monitoring.dashboard.v1.DashboardsService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring,
+        https://www.googleapis.com/auth/monitoring.write
+  - selector: google.monitoring.dashboard.v1.DashboardsService.GetDashboard
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring,
+        https://www.googleapis.com/auth/monitoring.read
+  - selector: google.monitoring.dashboard.v1.DashboardsService.ListDashboards
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring,
+        https://www.googleapis.com/auth/monitoring.read
diff --git a/third_party/googleapis/google/monitoring/dashboard/v1/monitoring_gapic.yaml b/third_party/googleapis/google/monitoring/dashboard/v1/monitoring_gapic.yaml
new file mode 100644
index 000000000..d6d185985
--- /dev/null
+++ b/third_party/googleapis/google/monitoring/dashboard/v1/monitoring_gapic.yaml
@@ -0,0 +1,20 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 2.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.monitoring.dashboard.v1
+  python:
+    package_name: google.cloud.monitoring_dashboard.v1.gapic
+  go:
+    package_name: cloud.google.com/go/monitoring/dashboard/apiv1
+  csharp:
+    package_name: Google.Cloud.Monitoring.Dashboard.V1
+  ruby:
+    package_name: Google::Cloud::Monitoring::Dashboard::V1
+  php:
+    package_name: Google\Cloud\Monitoring\Dashboard\V1
+  nodejs:
+    package_name: monitoring-dashboard.v1
+    domain_layer_location: google-cloud
+interfaces:
+- name: google.monitoring.dashboard.v1.DashboardsService
diff --git a/third_party/googleapis/google/monitoring/dashboard/v1/scorecard.proto b/third_party/googleapis/google/monitoring/dashboard/v1/scorecard.proto
new file mode 100644
index 000000000..dd2633bec
--- /dev/null
+++ b/third_party/googleapis/google/monitoring/dashboard/v1/scorecard.proto
@@ -0,0 +1,111 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.monitoring.dashboard.v1;
+
+import "google/monitoring/dashboard/v1/metrics.proto";
+import "google/protobuf/duration.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/monitoring/dashboard/v1;dashboard";
+option ruby_package = "Google::Cloud::Monitoring::Dashboard::V1";
+option java_multiple_files = true;
+option java_outer_classname = "ScorecardProto";
+option java_package = "com.google.monitoring.dashboard.v1";
+
+// A widget showing the latest value of a metric, and how this value relates to
+// one or more thresholds.
+message Scorecard {
+  // A gauge chart shows where the current value sits within a pre-defined
+  // range. The upper and lower bounds should define the possible range of
+  // values for the scorecard's query (inclusive).
+  message GaugeView {
+    // The lower bound for this gauge chart. The value of the chart should
+    // always be greater than or equal to this.
+    double lower_bound = 1;
+
+    // The upper bound for this gauge chart. The value of the chart should
+    // always be less than or equal to this.
+    double upper_bound = 2;
+  }
+
+  // A sparkChart is a small chart suitable for inclusion in a table-cell or
+  // inline in text. This message contains the configuration for a sparkChart
+  // to show up on a Scorecard, showing recent trends of the scorecard's
+  // timeseries.
+  message SparkChartView {
+    // The type of sparkchart to show in this chartView.
+    SparkChartType spark_chart_type = 1;
+
+    // The lower bound on data point frequency in the chart implemented by
+    // specifying the minimum alignment period to use in a time series query.
+    // For example, if the data is published once every 10 minutes it would not
+    // make sense to fetch and align data at one minute intervals. This field is
+    // optional and exists only as a hint.
+    google.protobuf.Duration min_alignment_period = 2;
+  }
+
+  // Fields for querying time series data from the
+  // Stackdriver metrics API.
+  TimeSeriesQuery time_series_query = 1;
+
+  // Defines the optional additional chart shown on the scorecard. If
+  // neither is included - then a default scorecard is shown.
+  oneof data_view {
+    // Will cause the scorecard to show a gauge chart.
+    GaugeView gauge_view = 4;
+
+    // Will cause the scorecard to show a spark chart.
+    SparkChartView spark_chart_view = 5;
+  }
+
+  // The thresholds used to determine the state of the scorecard given the
+  // time series' current value. For an actual value x, the scorecard is in a
+  // danger state if x is less than or equal to a danger threshold that triggers
+  // below, or greater than or equal to a danger threshold that triggers above.
+  // Similarly, if x is above/below a warning threshold that triggers
+  // above/below, then the scorecard is in a warning state - unless x also puts
+  // it in a danger state. (Danger trumps warning.)
+  //
+  // As an example, consider a scorecard with the following four thresholds:
+  // {
+  //   value: 90,
+  //   category: 'DANGER',
+  //   trigger: 'ABOVE',
+  // },
+  // {
+  //   value: 70,
+  //   category: 'WARNING',
+  //   trigger: 'ABOVE',
+  // },
+  // {
+  //   value: 10,
+  //   category: 'DANGER',
+  //   trigger: 'BELOW',
+  // },
+  // {
+  //   value: 20,
+  //   category: 'WARNING',
+  //   trigger: 'BELOW',
+  // }
+  //
+  // Then: values less than or equal to 10 would put the scorecard in a DANGER
+  // state, values greater than 10 but less than or equal to 20 a WARNING state,
+  // values strictly between 20 and 70 an OK state, values greater than or equal
+  // to 70 but less than 90 a WARNING state, and values greater than or equal to
+  // 90 a DANGER state.
+  repeated Threshold thresholds = 6;
+}
diff --git a/third_party/googleapis/google/monitoring/dashboard/v1/service.proto b/third_party/googleapis/google/monitoring/dashboard/v1/service.proto
new file mode 100644
index 000000000..1d2151077
--- /dev/null
+++ b/third_party/googleapis/google/monitoring/dashboard/v1/service.proto
@@ -0,0 +1,24 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.monitoring.dashboard.v1;
+
+option go_package = "google.golang.org/genproto/googleapis/monitoring/dashboard/v1;dashboard";
+option ruby_package = "Google::Cloud::Monitoring::Dashboard::V1";
+option java_multiple_files = true;
+option java_outer_classname = "ServiceMonitoringProto";
+option java_package = "com.google.monitoring.dashboard.v1";
diff --git a/third_party/googleapis/google/monitoring/dashboard/v1/text.proto b/third_party/googleapis/google/monitoring/dashboard/v1/text.proto
new file mode 100644
index 000000000..537daeacb
--- /dev/null
+++ b/third_party/googleapis/google/monitoring/dashboard/v1/text.proto
@@ -0,0 +1,45 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.monitoring.dashboard.v1;
+
+option go_package = "google.golang.org/genproto/googleapis/monitoring/dashboard/v1;dashboard";
+option ruby_package = "Google::Cloud::Monitoring::Dashboard::V1";
+option java_multiple_files = true;
+option java_outer_classname = "TextProto";
+option java_package = "com.google.monitoring.dashboard.v1";
+
+// A widget that displays textual content.
+message Text {
+  // The format type of the text content.
+  enum Format {
+    // Format is unspecified. Defaults to MARKDOWN.
+    FORMAT_UNSPECIFIED = 0;
+
+    // The text contains Markdown formatting.
+    MARKDOWN = 1;
+
+    // The text contains no special formatting.
+    RAW = 2;
+  }
+
+  // The text content to be displayed.
+  string content = 1;
+
+  // How the text content is formatted.
+  Format format = 2;
+}
diff --git a/third_party/googleapis/google/monitoring/dashboard/v1/widget.proto b/third_party/googleapis/google/monitoring/dashboard/v1/widget.proto
new file mode 100644
index 000000000..cb9282af8
--- /dev/null
+++ b/third_party/googleapis/google/monitoring/dashboard/v1/widget.proto
@@ -0,0 +1,52 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.monitoring.dashboard.v1;
+
+import "google/api/field_behavior.proto";
+import "google/monitoring/dashboard/v1/scorecard.proto";
+import "google/monitoring/dashboard/v1/text.proto";
+import "google/monitoring/dashboard/v1/xychart.proto";
+import "google/protobuf/empty.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/monitoring/dashboard/v1;dashboard";
+option ruby_package = "Google::Cloud::Monitoring::Dashboard::V1";
+option java_multiple_files = true;
+option java_outer_classname = "WidgetProto";
+option java_package = "com.google.monitoring.dashboard.v1";
+
+// Widget contains a single dashboard component and configuration of how to
+// present the component in the dashboard.
+message Widget {
+  // Optional. The title of the widget.
+  string title = 1 [(google.api.field_behavior) = OPTIONAL];
+
+  // Content defines the component used to populate the widget.
+  oneof content {
+    // A chart of time series data.
+    XyChart xy_chart = 2;
+
+    // A scorecard summarizing time series data.
+    Scorecard scorecard = 3;
+
+    // A raw string or markdown displaying textual content.
+    Text text = 4;
+
+    // A blank space.
+    google.protobuf.Empty blank = 5;
+  }
+}
diff --git a/third_party/googleapis/google/monitoring/dashboard/v1/xychart.proto b/third_party/googleapis/google/monitoring/dashboard/v1/xychart.proto
new file mode 100644
index 000000000..3d768b7bc
--- /dev/null
+++ b/third_party/googleapis/google/monitoring/dashboard/v1/xychart.proto
@@ -0,0 +1,147 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.monitoring.dashboard.v1;
+
+import "google/api/field_behavior.proto";
+import "google/monitoring/dashboard/v1/metrics.proto";
+import "google/protobuf/duration.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/monitoring/dashboard/v1;dashboard";
+option ruby_package = "Google::Cloud::Monitoring::Dashboard::V1";
+option java_multiple_files = true;
+option java_outer_classname = "XyChartProto";
+option java_package = "com.google.monitoring.dashboard.v1";
+
+// A chart that displays data on a 2D (X and Y axes) plane.
+message XyChart {
+  // Groups a time series query definition with charting options.
+  message DataSet {
+    // The types of plotting strategies for data sets.
+    enum PlotType {
+      // Plot type is unspecified. The view will default to `LINE`.
+      PLOT_TYPE_UNSPECIFIED = 0;
+
+      // The data is plotted as a set of lines (one line per series).
+      LINE = 1;
+
+      // The data is plotted as a set of filled areas (one area per series),
+      // with the areas stacked vertically (the base of each area is the top of
+      // its predecessor, and the base of the first area is the X axis). Since
+      // the areas do not overlap, each is filled with a different opaque color.
+      STACKED_AREA = 2;
+
+      // The data is plotted as a set of rectangular boxes (one box per series),
+      // with the boxes stacked vertically (the base of each box is the top of
+      // its predecessor, and the base of the first box is the X axis). Since
+      // the boxes do not overlap, each is filled with a different opaque color.
+      STACKED_BAR = 3;
+
+      // The data is plotted as a heatmap. The series being plotted must have a
+      // `DISTRIBUTION` value type. The value of each bucket in the distribution
+      // is displayed as a color. This type is not currently available in the
+      // Stackdriver Monitoring application.
+      HEATMAP = 4;
+    }
+
+    // Fields for querying time series data from the
+    // Stackdriver metrics API.
+    TimeSeriesQuery time_series_query = 1;
+
+    // How this data should be plotted on the chart.
+    PlotType plot_type = 2;
+
+    // A template string for naming `TimeSeries` in the resulting data set.
+    // This should be a string with interpolations of the form ${label_name},
+    // which will resolve to the label's value.
+    string legend_template = 3;
+
+    // Optional. The lower bound on data point frequency for this data set, implemented by
+    // specifying the minimum alignment period to use in a time series query
+    // For example, if the data is published once every 10 minutes, the
+    // `min_alignment_period` should be at least 10 minutes. It would not
+    // make sense to fetch and align data at one minute intervals.
+    google.protobuf.Duration min_alignment_period = 4 [(google.api.field_behavior) = OPTIONAL];
+  }
+
+  // A chart axis.
+  message Axis {
+    // Types of scales used in axes.
+    enum Scale {
+      // Scale is unspecified. The view will default to `LINEAR`.
+      SCALE_UNSPECIFIED = 0;
+
+      // Linear scale.
+      LINEAR = 1;
+
+      // Logarithmic scale (base 10).
+      LOG10 = 2;
+    }
+
+    // The label of the axis.
+    string label = 1;
+
+    // The axis scale. By default, a linear scale is used.
+    Scale scale = 2;
+  }
+
+  // The data displayed in this chart.
+  repeated DataSet data_sets = 1;
+
+  // The duration used to display a comparison chart. A comparison chart
+  // simultaneously shows values from two similar-length time periods
+  // (e.g., week-over-week metrics).
+  // The duration must be positive, and it can only be applied to charts with
+  // data sets of LINE plot type.
+  google.protobuf.Duration timeshift_duration = 4;
+
+  // Threshold lines drawn horizontally across the chart.
+  repeated Threshold thresholds = 5;
+
+  // The properties applied to the X axis.
+  Axis x_axis = 6;
+
+  // The properties applied to the Y axis.
+  Axis y_axis = 7;
+
+  // Display options for the chart.
+  ChartOptions chart_options = 8;
+}
+
+// Options to control visual rendering of a chart.
+message ChartOptions {
+  // Chart mode options.
+  enum Mode {
+    // Mode is unspecified. The view will default to `COLOR`.
+    MODE_UNSPECIFIED = 0;
+
+    // The chart distinguishes data series using different color. Line
+    // colors may get reused when there are many lines in the chart.
+    COLOR = 1;
+
+    // The chart uses the Stackdriver x-ray mode, in which each
+    // data set is plotted using the same semi-transparent color.
+    X_RAY = 2;
+
+    // The chart displays statistics such as average, median, 95th percentile,
+    // and more.
+    STATS = 3;
+  }
+
+  // The chart mode.
+  Mode mode = 1;
+}
diff --git a/third_party/googleapis/google/monitoring/monitoring.yaml b/third_party/googleapis/google/monitoring/monitoring.yaml
deleted file mode 100644
index 026a6b3ee..000000000
--- a/third_party/googleapis/google/monitoring/monitoring.yaml
+++ /dev/null
@@ -1,159 +0,0 @@
-type: google.api.Service
-config_version: 3
-name: monitoring.googleapis.com
-title: Stackdriver Monitoring API
-
-apis:
-- name: google.monitoring.v3.AlertPolicyService
-- name: google.monitoring.v3.GroupService
-- name: google.monitoring.v3.MetricService
-- name: google.monitoring.v3.NotificationChannelService
-- name: google.monitoring.v3.UptimeCheckService
-
-types:
-- name: google.monitoring.v3.DroppedLabels
-- name: google.monitoring.v3.SpanContext
-
-documentation:
-  summary: |-
-    Manages your Stackdriver Monitoring data and configurations. Most projects
-    must be associated with a Stackdriver account, with a few exceptions as
-    noted on the individual method pages.
-
-backend:
-  rules:
-  - selector: google.monitoring.v3.AgentTranslationService.CreateCollectdTimeSeries
-    deadline: 30.0
-  - selector: google.monitoring.v3.AlertPolicyService.ListAlertPolicies
-    deadline: 30.0
-  - selector: google.monitoring.v3.AlertPolicyService.GetAlertPolicy
-    deadline: 30.0
-  - selector: google.monitoring.v3.AlertPolicyService.CreateAlertPolicy
-    deadline: 30.0
-  - selector: google.monitoring.v3.AlertPolicyService.DeleteAlertPolicy
-    deadline: 30.0
-  - selector: google.monitoring.v3.AlertPolicyService.UpdateAlertPolicy
-    deadline: 30.0
-  - selector: google.monitoring.v3.GroupService.ListGroups
-    deadline: 30.0
-  - selector: google.monitoring.v3.GroupService.GetGroup
-    deadline: 30.0
-  - selector: google.monitoring.v3.GroupService.CreateGroup
-    deadline: 30.0
-  - selector: google.monitoring.v3.GroupService.UpdateGroup
-    deadline: 30.0
-  - selector: google.monitoring.v3.GroupService.DeleteGroup
-    deadline: 30.0
-  - selector: google.monitoring.v3.GroupService.ListGroupMembers
-    deadline: 30.0
-  - selector: google.monitoring.v3.MetricService.ListMonitoredResourceDescriptors
-    deadline: 30.0
-  - selector: google.monitoring.v3.MetricService.GetMonitoredResourceDescriptor
-    deadline: 30.0
-  - selector: google.monitoring.v3.MetricService.ListMetricDescriptors
-    deadline: 30.0
-  - selector: google.monitoring.v3.MetricService.GetMetricDescriptor
-    deadline: 30.0
-  - selector: google.monitoring.v3.MetricService.CreateMetricDescriptor
-    deadline: 30.0
-  - selector: google.monitoring.v3.MetricService.DeleteMetricDescriptor
-    deadline: 30.0
-  - selector: google.monitoring.v3.MetricService.ListTimeSeries
-    deadline: 30.0
-  - selector: google.monitoring.v3.MetricService.CreateTimeSeries
-    deadline: 12.0
-  - selector: google.monitoring.v3.NotificationChannelService.ListNotificationChannelDescriptors
-    deadline: 30.0
-  - selector: google.monitoring.v3.NotificationChannelService.GetNotificationChannelDescriptor
-    deadline: 30.0
-  - selector: google.monitoring.v3.NotificationChannelService.ListNotificationChannels
-    deadline: 30.0
-  - selector: google.monitoring.v3.NotificationChannelService.GetNotificationChannel
-    deadline: 30.0
-  - selector: google.monitoring.v3.NotificationChannelService.CreateNotificationChannel
-    deadline: 30.0
-  - selector: google.monitoring.v3.NotificationChannelService.UpdateNotificationChannel
-    deadline: 30.0
-  - selector: google.monitoring.v3.NotificationChannelService.DeleteNotificationChannel
-    deadline: 30.0
-  - selector: google.monitoring.v3.NotificationChannelService.SendNotificationChannelVerificationCode
-    deadline: 30.0
-  - selector: google.monitoring.v3.NotificationChannelService.GetNotificationChannelVerificationCode
-    deadline: 30.0
-  - selector: google.monitoring.v3.NotificationChannelService.VerifyNotificationChannel
-    deadline: 30.0
-
-authentication:
-  rules:
-  - selector: '*'
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform,
-        https://www.googleapis.com/auth/monitoring
-  - selector: |-
-      google.monitoring.v3.MetricService.GetMetricDescriptor,
-      google.monitoring.v3.MetricService.GetMonitoredResourceDescriptor,
-      google.monitoring.v3.MetricService.ListMetricDescriptors,
-      google.monitoring.v3.MetricService.ListMonitoredResourceDescriptors
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform,
-        https://www.googleapis.com/auth/monitoring,
-        https://www.googleapis.com/auth/monitoring.read,
-        https://www.googleapis.com/auth/monitoring.write
-  - selector: |-
-      google.monitoring.v3.NotificationChannelService.GetNotificationChannel,
-      google.monitoring.v3.NotificationChannelService.GetNotificationChannelDescriptor,
-      google.monitoring.v3.NotificationChannelService.ListNotificationChannelDescriptors,
-      google.monitoring.v3.NotificationChannelService.ListNotificationChannels
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform,
-        https://www.googleapis.com/auth/monitoring,
-        https://www.googleapis.com/auth/monitoring.read
-  - selector: |-
-      google.monitoring.v3.GroupService.GetGroup,
-      google.monitoring.v3.GroupService.ListGroupMembers,
-      google.monitoring.v3.GroupService.ListGroups
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform,
-        https://www.googleapis.com/auth/monitoring,
-        https://www.googleapis.com/auth/monitoring.read
-  - selector: |-
-      google.monitoring.v3.UptimeCheckService.GetUptimeCheckConfig,
-      google.monitoring.v3.UptimeCheckService.ListUptimeCheckConfigs,
-      google.monitoring.v3.UptimeCheckService.ListUptimeCheckIps
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform,
-        https://www.googleapis.com/auth/monitoring,
-        https://www.googleapis.com/auth/monitoring.read
-  - selector: |-
-      google.monitoring.v3.AlertPolicyService.GetAlertPolicy,
-      google.monitoring.v3.AlertPolicyService.ListAlertPolicies
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform,
-        https://www.googleapis.com/auth/monitoring,
-        https://www.googleapis.com/auth/monitoring.read
-  - selector: |-
-      google.monitoring.v3.MetricService.CreateMetricDescriptor,
-      google.monitoring.v3.MetricService.CreateTimeSeries
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform,
-        https://www.googleapis.com/auth/monitoring,
-        https://www.googleapis.com/auth/monitoring.write
-  - selector: google.monitoring.v3.AgentTranslationService.CreateCollectdTimeSeries
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform,
-        https://www.googleapis.com/auth/monitoring,
-        https://www.googleapis.com/auth/monitoring.write
-  - selector: google.monitoring.v3.MetricService.ListTimeSeries
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform,
-        https://www.googleapis.com/auth/monitoring,
-        https://www.googleapis.com/auth/monitoring.read
diff --git a/third_party/googleapis/google/monitoring/v3/BUILD.bazel b/third_party/googleapis/google/monitoring/v3/BUILD.bazel
index 8294d5250..1808da10d 100644
--- a/third_party/googleapis/google/monitoring/v3/BUILD.bazel
+++ b/third_party/googleapis/google/monitoring/v3/BUILD.bazel
@@ -1,9 +1,12 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
@@ -20,18 +23,24 @@ proto_library(
         "mutation_record.proto",
         "notification.proto",
         "notification_service.proto",
+        "service.proto",
+        "service_service.proto",
         "span_context.proto",
         "uptime.proto",
         "uptime_service.proto",
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
         "//google/api:distribution_proto",
         "//google/api:label_proto",
+        "//google/api:launch_stage_proto",
         "//google/api:metric_proto",
         "//google/api:monitored_resource_proto",
-        "//google/longrunning:operations_proto",
         "//google/rpc:status_proto",
+        "//google/type:calendar_period_proto",
         "@com_google_protobuf//:duration_proto",
         "@com_google_protobuf//:empty_proto",
         "@com_google_protobuf//:field_mask_proto",
@@ -43,7 +52,10 @@ proto_library(
 
 proto_library_with_info(
     name = "monitoring_proto_with_info",
-    deps = [":monitoring_proto"],
+    deps = [
+        ":monitoring_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -51,18 +63,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
     name = "monitoring_java_proto",
     deps = [":monitoring_proto"],
@@ -71,55 +78,46 @@ java_proto_library(
 java_grpc_library(
     name = "monitoring_java_grpc",
     srcs = [":monitoring_proto"],
-    deps = [":monitoring_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "monitoring_resource_name_java_proto",
-    gapic_yaml = "monitoring_gapic.yaml",
-    deps = [":monitoring_proto"],
+    deps = [":monitoring_java_proto"],
 )
 
 java_gapic_library(
     name = "monitoring_java_gapic",
     src = ":monitoring_proto_with_info",
     gapic_yaml = "monitoring_gapic.yaml",
-    service_yaml = "//google/monitoring:monitoring.yaml",
-    test_deps = [":monitoring_java_grpc"],
+    package = "google.monitoring.v3",
+    service_yaml = "monitoring.yaml",
+    test_deps = [
+        ":monitoring_java_grpc",
+    ],
     deps = [
         ":monitoring_java_proto",
-        ":monitoring_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+        "//google/api:api_java_proto",
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":monitoring_java_gapic_test",
+java_gapic_test(
+    name = "monitoring_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.monitoring.v3.AlertPolicyServiceClientTest",
+        "com.google.cloud.monitoring.v3.GroupServiceClientTest",
+        "com.google.cloud.monitoring.v3.MetricServiceClientTest",
+        "com.google.cloud.monitoring.v3.NotificationChannelServiceClientTest",
+        "com.google.cloud.monitoring.v3.ServiceMonitoringServiceClientTest",
+        "com.google.cloud.monitoring.v3.UptimeCheckServiceClientTest",
     ],
-) for test_name in [
-    "com.google.cloud.monitoring.v3.AlertPolicyServiceClientTest",
-    "com.google.cloud.monitoring.v3.GroupServiceClientTest",
-    "com.google.cloud.monitoring.v3.MetricServiceClientTest",
-    "com.google.cloud.monitoring.v3.NotificationChannelServiceClientTest",
-    "com.google.cloud.monitoring.v3.UptimeCheckServiceClientTest",
-]]
+    runtime_deps = [":monitoring_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-monitoring-v3-java",
-    client_deps = [":monitoring_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":monitoring_java_gapic_test"],
-    grpc_deps = [":monitoring_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":monitoring_java_gapic",
+        ":monitoring_java_grpc",
         ":monitoring_java_proto",
         ":monitoring_proto",
-        ":monitoring_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -127,10 +125,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -140,21 +138,23 @@ go_proto_library(
     protos = [":monitoring_proto"],
     deps = [
         "//google/api:annotations_go_proto",
+        "//google/api:api_go_proto",
         "//google/api:distribution_go_proto",
         "//google/api:label_go_proto",
         "//google/api:metric_go_proto",
         "//google/api:monitoredres_go_proto",
         "//google/longrunning:longrunning_go_proto",
         "//google/rpc:status_go_proto",
+        "//google/type:calendar_period_go_proto",
     ],
 )
 
 go_gapic_library(
     name = "monitoring_go_gapic",
-    src = ":monitoring_proto_with_info",
-    gapic_yaml = "monitoring_gapic.yaml",
-    importpath = "cloud.google.com/go/monitoring/apiv3",
-    service_yaml = "//google/monitoring:monitoring.yaml",
+    srcs = [":monitoring_proto_with_info"],
+    grpc_service_config = "monitoring_grpc_service_config.json",
+    importpath = "cloud.google.com/go/monitoring/apiv3;monitoring",
+    service_yaml = "monitoring.yaml",
     deps = [
         ":monitoring_go_proto",
         "//google/api:metric_go_proto",
@@ -169,17 +169,244 @@ go_test(
     importpath = "cloud.google.com/go/monitoring/apiv3",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-monitoring-v3-go",
     deps = [
         ":monitoring_go_gapic",
-        ":monitoring_go_gapic_srcjar-smoke-test.srcjar",
         ":monitoring_go_gapic_srcjar-test.srcjar",
         ":monitoring_go_proto",
     ],
 )
 
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "monitoring_moved_proto",
+    srcs = [":monitoring_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/api:distribution_proto",
+        "//google/api:label_proto",
+        "//google/api:launch_stage_proto",
+        "//google/api:metric_proto",
+        "//google/api:monitored_resource_proto",
+        "//google/rpc:status_proto",
+        "//google/type:calendar_period_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:struct_proto",
+        "@com_google_protobuf//:timestamp_proto",
+        "@com_google_protobuf//:wrappers_proto",
+    ],
+)
+
+py_proto_library(
+    name = "monitoring_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":monitoring_moved_proto"],
+)
+
+py_grpc_library(
+    name = "monitoring_py_grpc",
+    srcs = [":monitoring_moved_proto"],
+    deps = [":monitoring_py_proto"],
+)
+
+py_gapic_library(
+    name = "monitoring_py_gapic",
+    src = ":monitoring_proto_with_info",
+    gapic_yaml = "monitoring_gapic.yaml",
+    package = "google.monitoring.v3",
+    service_yaml = "monitoring.yaml",
+    deps = [
+        ":monitoring_py_grpc",
+        ":monitoring_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "monitoring-v3-py",
+    deps = [
+        ":monitoring_py_gapic",
+        ":monitoring_py_grpc",
+        ":monitoring_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "monitoring_php_proto",
+    deps = [":monitoring_proto"],
+)
+
+php_grpc_library(
+    name = "monitoring_php_grpc",
+    srcs = [":monitoring_proto"],
+    deps = [":monitoring_php_proto"],
+)
+
+php_gapic_library(
+    name = "monitoring_php_gapic",
+    src = ":monitoring_proto_with_info",
+    gapic_yaml = "monitoring_gapic.yaml",
+    package = "google.monitoring.v3",
+    service_yaml = "monitoring.yaml",
+    deps = [
+        ":monitoring_php_grpc",
+        ":monitoring_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-monitoring-v3-php",
+    deps = [
+        ":monitoring_php_gapic",
+        ":monitoring_php_grpc",
+        ":monitoring_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "monitoring_nodejs_gapic",
+    src = ":monitoring_proto_with_info",
+    gapic_yaml = "monitoring_gapic.yaml",
+    package = "google.monitoring.v3",
+    service_yaml = "monitoring.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "monitoring-v3-nodejs",
+    deps = [
+        ":monitoring_nodejs_gapic",
+        ":monitoring_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "monitoring_ruby_proto",
+    deps = [":monitoring_proto"],
+)
+
+ruby_grpc_library(
+    name = "monitoring_ruby_grpc",
+    srcs = [":monitoring_proto"],
+    deps = [":monitoring_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "monitoring_ruby_gapic",
+    src = ":monitoring_proto_with_info",
+    gapic_yaml = "monitoring_gapic.yaml",
+    package = "google.monitoring.v3",
+    service_yaml = "monitoring.yaml",
+    deps = [
+        ":monitoring_ruby_grpc",
+        ":monitoring_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-monitoring-v3-ruby",
+    deps = [
+        ":monitoring_ruby_gapic",
+        ":monitoring_ruby_grpc",
+        ":monitoring_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "monitoring_csharp_proto",
+    deps = [":monitoring_proto"],
+)
+
+csharp_grpc_library(
+    name = "monitoring_csharp_grpc",
+    srcs = [":monitoring_proto"],
+    deps = [":monitoring_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "monitoring_csharp_gapic",
+    src = ":monitoring_proto_with_info",
+    gapic_yaml = "monitoring_gapic.yaml",
+    package = "google.monitoring.v3",
+    service_yaml = "monitoring.yaml",
+    deps = [
+        ":monitoring_csharp_grpc",
+        ":monitoring_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-monitoring-v3-csharp",
+    deps = [
+        ":monitoring_csharp_gapic",
+        ":monitoring_csharp_grpc",
+        ":monitoring_csharp_proto",
+    ],
+)
+
 ##############################################################################
 # C++
 ##############################################################################
@@ -197,6 +424,8 @@ cc_proto_library(
 cc_grpc_library(
     name = "monitoring_cc_grpc",
     srcs = [":monitoring_proto"],
-    deps = [":monitoring_cc_proto"],
+    generate_mocks = True,
     grpc_only = True,
+    deps = [":monitoring_cc_proto"],
 )
+
diff --git a/third_party/googleapis/google/monitoring/v3/alert.proto b/third_party/googleapis/google/monitoring/v3/alert.proto
index 3b3e1dca2..6662304d7 100644
--- a/third_party/googleapis/google/monitoring/v3/alert.proto
+++ b/third_party/googleapis/google/monitoring/v3/alert.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,17 +11,17 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.monitoring.v3;
 
-import "google/api/annotations.proto";
+import "google/api/resource.proto";
 import "google/monitoring/v3/common.proto";
 import "google/monitoring/v3/mutation_record.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/wrappers.proto";
+import "google/rpc/status.proto";
 
 option csharp_namespace = "Google.Cloud.Monitoring.V3";
 option go_package = "google.golang.org/genproto/googleapis/monitoring/v3;monitoring";
@@ -29,12 +29,21 @@ option java_multiple_files = true;
 option java_outer_classname = "AlertProto";
 option java_package = "com.google.monitoring.v3";
 option php_namespace = "Google\\Cloud\\Monitoring\\V3";
+option ruby_package = "Google::Cloud::Monitoring::V3";
 
 // A description of the conditions under which some aspect of your system is
 // considered to be "unhealthy" and the ways to notify people or services about
 // this state. For an overview of alert policies, see
-// [Introduction to Alerting](/monitoring/alerts/).
+// [Introduction to Alerting](https://cloud.google.com/monitoring/alerts/).
 message AlertPolicy {
+  option (google.api.resource) = {
+    type: "monitoring.googleapis.com/AlertPolicy"
+    pattern: "projects/{project}/alertPolicies/{alert_policy}"
+    pattern: "organizations/{organization}/alertPolicies/{alert_policy}"
+    pattern: "folders/{folder}/alertPolicies/{alert_policy}"
+    pattern: "*"
+  };
+
   // A content string and a MIME type that describes the content string's
   // format.
   message Documentation {
@@ -54,6 +63,14 @@ message AlertPolicy {
   // should open an incident. If a condition evaluates to true, it signifies
   // that something is wrong.
   message Condition {
+    option (google.api.resource) = {
+      type: "monitoring.googleapis.com/AlertPolicyCondition"
+      pattern: "projects/{project}/alertPolicies/{alert_policy}/conditions/{condition}"
+      pattern: "organizations/{organization}/alertPolicies/{alert_policy}/conditions/{condition}"
+      pattern: "folders/{folder}/alertPolicies/{alert_policy}/conditions/{condition}"
+      pattern: "*"
+    };
+
     // Specifies how many time series must fail a predicate to trigger a
     // condition. If not specified, then a `{count: 1}` trigger is used.
     message Trigger {
@@ -72,13 +89,13 @@ message AlertPolicy {
     // A condition type that compares a collection of time series
     // against a threshold.
     message MetricThreshold {
-      // A [filter](/monitoring/api/v3/filters) that
+      // A [filter](https://cloud.google.com/monitoring/api/v3/filters) that
       // identifies which time series should be compared with the threshold.
       //
       // The filter is similar to the one that is specified in the
-      // [`MetricService.ListTimeSeries`
-      // request](/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list) (that
-      // call is useful to verify the time series that will be retrieved /
+      // [`ListTimeSeries`
+      // request](https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list)
+      // (that call is useful to verify the time series that will be retrieved /
       // processed) and must specify the metric type and optionally may contain
       // restrictions on resource type, resource labels, and metric labels.
       // This field may not exceed 2048 Unicode characters in length.
@@ -91,24 +108,19 @@ message AlertPolicy {
       // members of a group of resrouces). Multiple aggregations
       // are applied in the order specified.
       //
-      // This field is similar to the one in the
-      // [`MetricService.ListTimeSeries`
-      // request](/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list). It
-      // is advisable to use the `ListTimeSeries` method when debugging this
+      // This field is similar to the one in the [`ListTimeSeries`
+      // request](https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list).
+      // It is advisable to use the `ListTimeSeries` method when debugging this
       // field.
       repeated Aggregation aggregations = 8;
 
-      // A [filter](/monitoring/api/v3/filters) that identifies a time
-      // series that should be used as the denominator of a ratio that will be
-      // compared with the threshold. If a `denominator_filter` is specified,
-      // the time series specified by the `filter` field will be used as the
-      // numerator.
+      // A [filter](https://cloud.google.com/monitoring/api/v3/filters) that
+      // identifies a time series that should be used as the denominator of a
+      // ratio that will be compared with the threshold. If a
+      // `denominator_filter` is specified, the time series specified by the
+      // `filter` field will be used as the numerator.
       //
-      // The filter is similar to the one that is specified in the
-      // [`MetricService.ListTimeSeries`
-      // request](/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list) (that
-      // call is useful to verify the time series that will be retrieved /
-      // processed) and must specify the metric type and optionally may contain
+      // The filter must specify the metric type and optionally may contain
       // restrictions on resource type, resource labels, and metric labels.
       // This field may not exceed 2048 Unicode characters in length.
       string denominator_filter = 9;
@@ -123,12 +135,6 @@ message AlertPolicy {
       // When computing ratios, the `aggregations` and
       // `denominator_aggregations` fields must use the same alignment period
       // and produce time series that have the same periodicity and labels.
-      //
-      // This field is similar to the one in the
-      // [`MetricService.ListTimeSeries`
-      // request](/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list). It
-      // is advisable to use the `ListTimeSeries` method when debugging this
-      // field.
       repeated Aggregation denominator_aggregations = 10;
 
       // The comparison to apply between the time series (indicated by `filter`
@@ -169,13 +175,13 @@ message AlertPolicy {
     // when a time series for the specified metric of a monitored
     // resource does not include any data in the specified `duration`.
     message MetricAbsence {
-      // A [filter](/monitoring/api/v3/filters) that
+      // A [filter](https://cloud.google.com/monitoring/api/v3/filters) that
       // identifies which time series should be compared with the threshold.
       //
       // The filter is similar to the one that is specified in the
-      // [`MetricService.ListTimeSeries`
-      // request](/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list) (that
-      // call is useful to verify the time series that will be retrieved /
+      // [`ListTimeSeries`
+      // request](https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list)
+      // (that call is useful to verify the time series that will be retrieved /
       // processed) and must specify the metric type and optionally may contain
       // restrictions on resource type, resource labels, and metric labels.
       // This field may not exceed 2048 Unicode characters in length.
@@ -188,10 +194,9 @@ message AlertPolicy {
       // members of a group of resrouces). Multiple aggregations
       // are applied in the order specified.
       //
-      // This field is similar to the
-      // one in the [`MetricService.ListTimeSeries`
-      // request](/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list). It
-      // is advisable to use the `ListTimeSeries` method when debugging this
+      // This field is similar to the one in the [`ListTimeSeries`
+      // request](https://cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list).
+      // It is advisable to use the `ListTimeSeries` method when debugging this
       // field.
       repeated Aggregation aggregations = 5;
 
@@ -211,9 +216,9 @@ message AlertPolicy {
     }
 
     // Required if the condition exists. The unique resource name for this
-    // condition. Its syntax is:
+    // condition. Its format is:
     //
-    //     projects/[PROJECT_ID]/alertPolicies/[POLICY_ID]/conditions/[CONDITION_ID]
+    //     projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[POLICY_ID]/conditions/[CONDITION_ID]
     //
     // `[CONDITION_ID]` is assigned by Stackdriver Monitoring when the
     // condition is created as part of a new or updated alerting policy.
@@ -259,7 +264,7 @@ message AlertPolicy {
     COMBINE_UNSPECIFIED = 0;
 
     // Combine conditions using the logical `AND` operator. An
-    // incident is created only if all conditions are met
+    // incident is created only if all the conditions are met
     // simultaneously. This combiner is satisfied if all conditions are
     // met, even if they are met on completely different resources.
     AND = 1;
@@ -275,9 +280,9 @@ message AlertPolicy {
   }
 
   // Required if the policy exists. The resource name for this policy. The
-  // syntax is:
+  // format is:
   //
-  //     projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]
+  //     projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID]
   //
   // `[ALERT_POLICY_ID]` is assigned by Stackdriver Monitoring when the policy
   // is created.  When calling the
@@ -312,10 +317,14 @@ message AlertPolicy {
   // OR according to the `combiner` field. If the combined conditions evaluate
   // to true, then an incident is created. A policy can have from one to six
   // conditions.
+  // If `condition_time_series_query_language` is present, it must be the only
+  // `condition`.
   repeated Condition conditions = 12;
 
-  // How to combine the results of multiple conditions
-  // to determine if an incident should be opened.
+  // How to combine the results of multiple conditions to determine if an
+  // incident should be opened.
+  // If `condition_time_series_query_language` is present, this must be
+  // `COMBINE_UNSPECIFIED`.
   ConditionCombinerType combiner = 6;
 
   // Whether or not the policy is enabled. On write, the default interpretation
@@ -325,6 +334,10 @@ message AlertPolicy {
   // a field projection has been specified that strips it out.
   google.protobuf.BoolValue enabled = 17;
 
+  // Read-only description of how the alert policy is invalid. OK if the alert
+  // policy is valid. If not OK, the alert policy will not generate incidents.
+  google.rpc.Status validity = 18;
+
   // Identifies the notification channels to which notifications should be sent
   // when incidents are opened or closed or when new violations occur on
   // an already opened incident. Each element of this array corresponds to
@@ -332,9 +345,9 @@ message AlertPolicy {
   // [`NotificationChannel`][google.monitoring.v3.NotificationChannel]
   // objects that are returned from the [`ListNotificationChannels`]
   // [google.monitoring.v3.NotificationChannelService.ListNotificationChannels]
-  // method. The syntax of the entries in this field is:
+  // method. The format of the entries in this field is:
   //
-  //     projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]
+  //     projects/[PROJECT_ID_OR_NUMBER]/notificationChannels/[CHANNEL_ID]
   repeated string notification_channels = 14;
 
   // A read-only record of the creation of the alerting policy. If provided
diff --git a/third_party/googleapis/google/monitoring/v3/alert_service.proto b/third_party/googleapis/google/monitoring/v3/alert_service.proto
index 0dedca113..ea0c5ada3 100644
--- a/third_party/googleapis/google/monitoring/v3/alert_service.proto
+++ b/third_party/googleapis/google/monitoring/v3/alert_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,15 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.monitoring.v3;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/monitoring/v3/alert.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
@@ -28,6 +30,7 @@ option java_multiple_files = true;
 option java_outer_classname = "AlertServiceProto";
 option java_package = "com.google.monitoring.v3";
 option php_namespace = "Google\\Cloud\\Monitoring\\V3";
+option ruby_package = "Google::Cloud::Monitoring::V3";
 
 // The AlertPolicyService API is used to manage (list, create, delete,
 // edit) alert policies in Stackdriver Monitoring. An alerting policy is
@@ -39,12 +42,18 @@ option php_namespace = "Google\\Cloud\\Monitoring\\V3";
 // which can be reached by clicking the "Monitoring" tab in
 // [Cloud Console](https://console.cloud.google.com/).
 service AlertPolicyService {
+  option (google.api.default_host) = "monitoring.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/monitoring,"
+      "https://www.googleapis.com/auth/monitoring.read";
+
   // Lists the existing alerting policies for the project.
-  rpc ListAlertPolicies(ListAlertPoliciesRequest)
-      returns (ListAlertPoliciesResponse) {
+  rpc ListAlertPolicies(ListAlertPoliciesRequest) returns (ListAlertPoliciesResponse) {
     option (google.api.http) = {
       get: "/v3/{name=projects/*}/alertPolicies"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Gets a single alerting policy.
@@ -52,6 +61,7 @@ service AlertPolicyService {
     option (google.api.http) = {
       get: "/v3/{name=projects/*/alertPolicies/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates a new alerting policy.
@@ -60,14 +70,15 @@ service AlertPolicyService {
       post: "/v3/{name=projects/*}/alertPolicies"
       body: "alert_policy"
     };
+    option (google.api.method_signature) = "name,alert_policy";
   }
 
   // Deletes an alerting policy.
-  rpc DeleteAlertPolicy(DeleteAlertPolicyRequest)
-      returns (google.protobuf.Empty) {
+  rpc DeleteAlertPolicy(DeleteAlertPolicyRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v3/{name=projects/*/alertPolicies/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Updates an alerting policy. You can either replace the entire policy with
@@ -79,53 +90,71 @@ service AlertPolicyService {
       patch: "/v3/{alert_policy.name=projects/*/alertPolicies/*}"
       body: "alert_policy"
     };
+    option (google.api.method_signature) = "update_mask,alert_policy";
   }
 }
 
 // The protocol for the `CreateAlertPolicy` request.
 message CreateAlertPolicyRequest {
-  // The project in which to create the alerting policy. The format is
-  // `projects/[PROJECT_ID]`.
+  // Required. The project in which to create the alerting policy. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]
   //
   // Note that this field names the parent container in which the alerting
   // policy will be written, not the name of the created policy. The alerting
   // policy that is returned will have a name that contains a normalized
   // representation of this name as a prefix but adds a suffix of the form
-  // `/alertPolicies/[POLICY_ID]`, identifying the policy in the container.
-  string name = 3;
-
-  // The requested alerting policy. You should omit the `name` field in this
+  // `/alertPolicies/[ALERT_POLICY_ID]`, identifying the policy in the
+  // container.
+  string name = 3 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "monitoring.googleapis.com/AlertPolicy"
+    }
+  ];
+
+  // Required. The requested alerting policy. You should omit the `name` field in this
   // policy. The name will be returned in the new policy, including
-  // a new [ALERT_POLICY_ID] value.
-  AlertPolicy alert_policy = 2;
+  // a new `[ALERT_POLICY_ID]` value.
+  AlertPolicy alert_policy = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The protocol for the `GetAlertPolicy` request.
 message GetAlertPolicyRequest {
-  // The alerting policy to retrieve. The format is
+  // Required. The alerting policy to retrieve. The format is:
   //
-  //     projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]
-  string name = 3;
+  //     projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID]
+  string name = 3 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "monitoring.googleapis.com/AlertPolicy"
+    }
+  ];
 }
 
 // The protocol for the `ListAlertPolicies` request.
 message ListAlertPoliciesRequest {
-  // The project whose alert policies are to be listed. The format is
+  // Required. The project whose alert policies are to be listed. The format is:
   //
-  //     projects/[PROJECT_ID]
+  //     projects/[PROJECT_ID_OR_NUMBER]
   //
   // Note that this field names the parent container in which the alerting
   // policies to be listed are stored. To retrieve a single alerting policy
   // by name, use the
   // [GetAlertPolicy][google.monitoring.v3.AlertPolicyService.GetAlertPolicy]
   // operation, instead.
-  string name = 4;
+  string name = 4 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "monitoring.googleapis.com/AlertPolicy"
+    }
+  ];
 
   // If provided, this field specifies the criteria that must be met by
   // alert policies to be included in the response.
   //
   // For more details, see [sorting and
-  // filtering](/monitoring/api/v3/sorting-and-filtering).
+  // filtering](https://cloud.google.com/monitoring/api/v3/sorting-and-filtering).
   string filter = 5;
 
   // A comma-separated list of fields by which to sort the result. Supports
@@ -133,7 +162,7 @@ message ListAlertPoliciesRequest {
   // prefixed with a minus sign to sort by the field in descending order.
   //
   // For more details, see [sorting and
-  // filtering](/monitoring/api/v3/sorting-and-filtering).
+  // filtering](https://cloud.google.com/monitoring/api/v3/sorting-and-filtering).
   string order_by = 6;
 
   // The maximum number of results to return in a single response.
@@ -152,7 +181,7 @@ message ListAlertPoliciesResponse {
 
   // If there might be more results than were returned, then this field is set
   // to a non-empty value. To see the additional results,
-  // use that value as `pageToken` in the next call to this method.
+  // use that value as `page_token` in the next call to this method.
   string next_page_token = 2;
 }
 
@@ -185,15 +214,20 @@ message UpdateAlertPolicyRequest {
   // fields listed in `update_mask`.
   // If `update_mask` is not empty, any fields in this policy that are
   // not in `update_mask` are ignored.
-  AlertPolicy alert_policy = 3;
+  AlertPolicy alert_policy = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The protocol for the `DeleteAlertPolicy` request.
 message DeleteAlertPolicyRequest {
-  // The alerting policy to delete. The format is:
+  // Required. The alerting policy to delete. The format is:
   //
-  //     projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]
+  //     projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID]
   //
   // For more information, see [AlertPolicy][google.monitoring.v3.AlertPolicy].
-  string name = 3;
+  string name = 3 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "monitoring.googleapis.com/AlertPolicy"
+    }
+  ];
 }
diff --git a/third_party/googleapis/google/monitoring/v3/artman_monitoring.yaml b/third_party/googleapis/google/monitoring/v3/artman_monitoring.yaml
new file mode 100644
index 000000000..4bc176dd1
--- /dev/null
+++ b/third_party/googleapis/google/monitoring/v3/artman_monitoring.yaml
@@ -0,0 +1,34 @@
+common:
+  api_name: monitoring
+  api_version: v3
+  organization_name: google-cloud
+  proto_deps:
+  - name: google-common-protos
+  src_proto_paths:
+  - .
+  service_yaml: monitoring.yaml
+  gapic_yaml: monitoring_gapic.yaml
+artifacts:
+- name: gapic_config
+  type: GAPIC_CONFIG
+- name: java_gapic
+  type: GAPIC
+  language: JAVA
+- name: python_gapic
+  type: GAPIC
+  language: PYTHON
+- name: nodejs_gapic
+  type: GAPIC
+  language: NODEJS
+- name: php_gapic
+  type: GAPIC
+  language: PHP
+- name: go_gapic
+  type: GAPIC
+  language: GO
+- name: ruby_gapic
+  type: GAPIC
+  language: RUBY
+- name: csharp_gapic
+  type: GAPIC
+  language: CSHARP
diff --git a/third_party/googleapis/google/monitoring/v3/common.proto b/third_party/googleapis/google/monitoring/v3/common.proto
index 73ca2c4ad..f1b38c234 100644
--- a/third_party/googleapis/google/monitoring/v3/common.proto
+++ b/third_party/googleapis/google/monitoring/v3/common.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,11 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.monitoring.v3;
 
-import "google/api/annotations.proto";
 import "google/api/distribution.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
@@ -28,6 +26,7 @@ option java_multiple_files = true;
 option java_outer_classname = "CommonProto";
 option java_package = "com.google.monitoring.v3";
 option php_namespace = "Google\\Cloud\\Monitoring\\V3";
+option ruby_package = "Google::Cloud::Monitoring::V3";
 
 // A single strongly-typed value.
 message TypedValue {
@@ -52,9 +51,24 @@ message TypedValue {
   }
 }
 
-// A time interval extending just after a start time through an end time.
-// If the start time is the same as the end time, then the interval
-// represents a single point in time.
+// A closed time interval. It extends from the start time to the end time, and includes both: `[startTime, endTime]`. Valid time intervals depend on the [`MetricKind`](/monitoring/api/ref_v3/rest/v3/projects.metricDescriptors#MetricKind) of the metric value. In no case can the end time be earlier than the start time.
+//
+// * For a `GAUGE` metric, the `startTime` value is technically optional; if
+//   no value is specified, the start time defaults to the value of the
+//   end time, and the interval represents a single point in time. If both
+//   start and end times are specified, they must be identical. Such an
+//   interval is valid only for `GAUGE` metrics, which are point-in-time
+//   measurements.
+//
+// * For `DELTA` and `CUMULATIVE` metrics, the start time must be earlier
+//   than the end time.
+//
+// * In all cases, the start time of the next interval must be
+//   at least a millisecond after the end time of the previous interval.
+//   Because the interval is closed, if the start time of a new interval
+//   is the same as the end time of the previous interval, data written
+//   at the new start time could overwrite data written at the previous
+//   end time.
 message TimeInterval {
   // Required. The end of the time interval.
   google.protobuf.Timestamp end_time = 2;
@@ -65,329 +79,372 @@ message TimeInterval {
   google.protobuf.Timestamp start_time = 1;
 }
 
-// Describes how to combine multiple time series to provide different views of
-// the data.  Aggregation consists of an alignment step on individual time
-// series (`alignment_period` and `per_series_aligner`) followed by an optional
-// reduction step of the data across the aligned time series
-// (`cross_series_reducer` and `group_by_fields`).  For more details, see
-// [Aggregation](/monitoring/api/learn_more#aggregation).
+// Describes how to combine multiple time series to provide a different view of
+// the data.  Aggregation of time series is done in two steps. First, each time
+// series in the set is _aligned_ to the same time interval boundaries, then the
+// set of time series is optionally _reduced_ in number.
+//
+// Alignment consists of applying the `per_series_aligner` operation
+// to each time series after its data has been divided into regular
+// `alignment_period` time intervals. This process takes _all_ of the data
+// points in an alignment period, applies a mathematical transformation such as
+// averaging, minimum, maximum, delta, etc., and converts them into a single
+// data point per period.
+//
+// Reduction is when the aligned and transformed time series can optionally be
+// combined, reducing the number of time series through similar mathematical
+// transformations. Reduction involves applying a `cross_series_reducer` to
+// all the time series, optionally sorting the time series into subsets with
+// `group_by_fields`, and applying the reducer to each subset.
+//
+// The raw time series data can contain a huge amount of information from
+// multiple sources. Alignment and reduction transforms this mass of data into
+// a more manageable and representative collection of data, for example "the
+// 95% latency across the average of all tasks in a cluster". This
+// representative data can be more easily graphed and comprehended, and the
+// individual time series data is still available for later drilldown. For more
+// details, see [Filtering and
+// aggregation](https://cloud.google.com/monitoring/api/v3/aggregation).
 message Aggregation {
-  // The Aligner describes how to bring the data points in a single
-  // time series into temporal alignment.
+  // The `Aligner` specifies the operation that will be applied to the data
+  // points in each alignment period in a time series. Except for
+  // `ALIGN_NONE`, which specifies that no operation be applied, each alignment
+  // operation replaces the set of data values in each alignment period with
+  // a single value: the result of applying the operation to the data values.
+  // An aligned time series has a single data value at the end of each
+  // `alignment_period`.
+  //
+  // An alignment operation can change the data type of the values, too. For
+  // example, if you apply a counting operation to boolean values, the data
+  // `value_type` in the original time series is `BOOLEAN`, but the `value_type`
+  // in the aligned result is `INT64`.
   enum Aligner {
-    // No alignment. Raw data is returned. Not valid if cross-time
-    // series reduction is requested. The value type of the result is
-    // the same as the value type of the input.
+    // No alignment. Raw data is returned. Not valid if cross-series reduction
+    // is requested. The `value_type` of the result is the same as the
+    // `value_type` of the input.
     ALIGN_NONE = 0;
 
-    // Align and convert to delta metric type. This alignment is valid
-    // for cumulative metrics and delta metrics. Aligning an existing
-    // delta metric to a delta metric requires that the alignment
-    // period be increased. The value type of the result is the same
-    // as the value type of the input.
+    // Align and convert to
+    // [DELTA][google.api.MetricDescriptor.MetricKind.DELTA].
+    // The output is `delta = y1 - y0`.
     //
-    // One can think of this aligner as a rate but without time units; that
-    // is, the output is conceptually (second_point - first_point).
+    // This alignment is valid for
+    // [CUMULATIVE][google.api.MetricDescriptor.MetricKind.CUMULATIVE] and
+    // `DELTA` metrics. If the selected alignment period results in periods
+    // with no data, then the aligned value for such a period is created by
+    // interpolation. The `value_type`  of the aligned result is the same as
+    // the `value_type` of the input.
     ALIGN_DELTA = 1;
 
-    // Align and convert to a rate. This alignment is valid for
-    // cumulative metrics and delta metrics with numeric values. The output is a
-    // gauge metric with value type
-    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE].
+    // Align and convert to a rate. The result is computed as
+    // `rate = (y1 - y0)/(t1 - t0)`, or "delta over time".
+    // Think of this aligner as providing the slope of the line that passes
+    // through the value at the start and at the end of the `alignment_period`.
     //
-    // One can think of this aligner as conceptually providing the slope of
-    // the line that passes through the value at the start and end of the
-    // window. In other words, this is conceptually ((y1 - y0)/(t1 - t0)),
-    // and the output unit is one that has a "/time" dimension.
+    // This aligner is valid for `CUMULATIVE`
+    // and `DELTA` metrics with numeric values. If the selected alignment
+    // period results in periods with no data, then the aligned value for
+    // such a period is created by interpolation. The output is a `GAUGE`
+    // metric with `value_type` `DOUBLE`.
     //
-    // If, by rate, you are looking for percentage change, see the
-    // `ALIGN_PERCENT_CHANGE` aligner option.
+    // If, by "rate", you mean "percentage change", see the
+    // `ALIGN_PERCENT_CHANGE` aligner instead.
     ALIGN_RATE = 2;
 
-    // Align by interpolating between adjacent points around the
-    // period boundary. This alignment is valid for gauge
-    // metrics with numeric values. The value type of the result is the same
-    // as the value type of the input.
+    // Align by interpolating between adjacent points around the alignment
+    // period boundary. This aligner is valid for `GAUGE` metrics with
+    // numeric values. The `value_type` of the aligned result is the same as the
+    // `value_type` of the input.
     ALIGN_INTERPOLATE = 3;
 
-    // Align by shifting the oldest data point before the period
-    // boundary to the boundary. This alignment is valid for gauge
-    // metrics. The value type of the result is the same as the
-    // value type of the input.
+    // Align by moving the most recent data point before the end of the
+    // alignment period to the boundary at the end of the alignment
+    // period. This aligner is valid for `GAUGE` metrics. The `value_type` of
+    // the aligned result is the same as the `value_type` of the input.
     ALIGN_NEXT_OLDER = 4;
 
-    // Align time series via aggregation. The resulting data point in
-    // the alignment period is the minimum of all data points in the
-    // period. This alignment is valid for gauge and delta metrics with numeric
-    // values. The value type of the result is the same as the value
-    // type of the input.
+    // Align the time series by returning the minimum value in each alignment
+    // period. This aligner is valid for `GAUGE` and `DELTA` metrics with
+    // numeric values. The `value_type` of the aligned result is the same as
+    // the `value_type` of the input.
     ALIGN_MIN = 10;
 
-    // Align time series via aggregation. The resulting data point in
-    // the alignment period is the maximum of all data points in the
-    // period. This alignment is valid for gauge and delta metrics with numeric
-    // values. The value type of the result is the same as the value
-    // type of the input.
+    // Align the time series by returning the maximum value in each alignment
+    // period. This aligner is valid for `GAUGE` and `DELTA` metrics with
+    // numeric values. The `value_type` of the aligned result is the same as
+    // the `value_type` of the input.
     ALIGN_MAX = 11;
 
-    // Align time series via aggregation. The resulting data point in
-    // the alignment period is the average or arithmetic mean of all
-    // data points in the period. This alignment is valid for gauge and delta
-    // metrics with numeric values. The value type of the output is
-    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE].
+    // Align the time series by returning the mean value in each alignment
+    // period. This aligner is valid for `GAUGE` and `DELTA` metrics with
+    // numeric values. The `value_type` of the aligned result is `DOUBLE`.
     ALIGN_MEAN = 12;
 
-    // Align time series via aggregation. The resulting data point in
-    // the alignment period is the count of all data points in the
-    // period. This alignment is valid for gauge and delta metrics with numeric
-    // or Boolean values. The value type of the output is
-    // [INT64][google.api.MetricDescriptor.ValueType.INT64].
+    // Align the time series by returning the number of values in each alignment
+    // period. This aligner is valid for `GAUGE` and `DELTA` metrics with
+    // numeric or Boolean values. The `value_type` of the aligned result is
+    // `INT64`.
     ALIGN_COUNT = 13;
 
-    // Align time series via aggregation. The resulting data point in
-    // the alignment period is the sum of all data points in the
-    // period. This alignment is valid for gauge and delta metrics with numeric
-    // and distribution values. The value type of the output is the
-    // same as the value type of the input.
+    // Align the time series by returning the sum of the values in each
+    // alignment period. This aligner is valid for `GAUGE` and `DELTA`
+    // metrics with numeric and distribution values. The `value_type` of the
+    // aligned result is the same as the `value_type` of the input.
     ALIGN_SUM = 14;
 
-    // Align time series via aggregation. The resulting data point in
-    // the alignment period is the standard deviation of all data
-    // points in the period. This alignment is valid for gauge and delta metrics
-    // with numeric values. The value type of the output is
-    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE].
+    // Align the time series by returning the standard deviation of the values
+    // in each alignment period. This aligner is valid for `GAUGE` and
+    // `DELTA` metrics with numeric values. The `value_type` of the output is
+    // `DOUBLE`.
     ALIGN_STDDEV = 15;
 
-    // Align time series via aggregation. The resulting data point in
-    // the alignment period is the count of True-valued data points in the
-    // period. This alignment is valid for gauge metrics with
-    // Boolean values. The value type of the output is
-    // [INT64][google.api.MetricDescriptor.ValueType.INT64].
+    // Align the time series by returning the number of `True` values in
+    // each alignment period. This aligner is valid for `GAUGE` metrics with
+    // Boolean values. The `value_type` of the output is `INT64`.
     ALIGN_COUNT_TRUE = 16;
 
-    // Align time series via aggregation. The resulting data point in
-    // the alignment period is the count of False-valued data points in the
-    // period. This alignment is valid for gauge metrics with
-    // Boolean values. The value type of the output is
-    // [INT64][google.api.MetricDescriptor.ValueType.INT64].
+    // Align the time series by returning the number of `False` values in
+    // each alignment period. This aligner is valid for `GAUGE` metrics with
+    // Boolean values. The `value_type` of the output is `INT64`.
     ALIGN_COUNT_FALSE = 24;
 
-    // Align time series via aggregation. The resulting data point in
-    // the alignment period is the fraction of True-valued data points in the
-    // period. This alignment is valid for gauge metrics with Boolean values.
-    // The output value is in the range [0, 1] and has value type
-    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE].
+    // Align the time series by returning the ratio of the number of `True`
+    // values to the total number of values in each alignment period. This
+    // aligner is valid for `GAUGE` metrics with Boolean values. The output
+    // value is in the range [0.0, 1.0] and has `value_type` `DOUBLE`.
     ALIGN_FRACTION_TRUE = 17;
 
-    // Align time series via aggregation. The resulting data point in
-    // the alignment period is the 99th percentile of all data
-    // points in the period. This alignment is valid for gauge and delta metrics
-    // with distribution values. The output is a gauge metric with value type
-    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE].
+    // Align the time series by using [percentile
+    // aggregation](https://en.wikipedia.org/wiki/Percentile). The resulting
+    // data point in each alignment period is the 99th percentile of all data
+    // points in the period. This aligner is valid for `GAUGE` and `DELTA`
+    // metrics with distribution values. The output is a `GAUGE` metric with
+    // `value_type` `DOUBLE`.
     ALIGN_PERCENTILE_99 = 18;
 
-    // Align time series via aggregation. The resulting data point in
-    // the alignment period is the 95th percentile of all data
-    // points in the period. This alignment is valid for gauge and delta metrics
-    // with distribution values. The output is a gauge metric with value type
-    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE].
+    // Align the time series by using [percentile
+    // aggregation](https://en.wikipedia.org/wiki/Percentile). The resulting
+    // data point in each alignment period is the 95th percentile of all data
+    // points in the period. This aligner is valid for `GAUGE` and `DELTA`
+    // metrics with distribution values. The output is a `GAUGE` metric with
+    // `value_type` `DOUBLE`.
     ALIGN_PERCENTILE_95 = 19;
 
-    // Align time series via aggregation. The resulting data point in
-    // the alignment period is the 50th percentile of all data
-    // points in the period. This alignment is valid for gauge and delta metrics
-    // with distribution values. The output is a gauge metric with value type
-    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE].
+    // Align the time series by using [percentile
+    // aggregation](https://en.wikipedia.org/wiki/Percentile). The resulting
+    // data point in each alignment period is the 50th percentile of all data
+    // points in the period. This aligner is valid for `GAUGE` and `DELTA`
+    // metrics with distribution values. The output is a `GAUGE` metric with
+    // `value_type` `DOUBLE`.
     ALIGN_PERCENTILE_50 = 20;
 
-    // Align time series via aggregation. The resulting data point in
-    // the alignment period is the 5th percentile of all data
-    // points in the period. This alignment is valid for gauge and delta metrics
-    // with distribution values. The output is a gauge metric with value type
-    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE].
+    // Align the time series by using [percentile
+    // aggregation](https://en.wikipedia.org/wiki/Percentile). The resulting
+    // data point in each alignment period is the 5th percentile of all data
+    // points in the period. This aligner is valid for `GAUGE` and `DELTA`
+    // metrics with distribution values. The output is a `GAUGE` metric with
+    // `value_type` `DOUBLE`.
     ALIGN_PERCENTILE_05 = 21;
 
-    // Align and convert to a percentage change. This alignment is valid for
-    // gauge and delta metrics with numeric values. This alignment conceptually
-    // computes the equivalent of "((current - previous)/previous)*100"
-    // where previous value is determined based on the alignmentPeriod.
-    // In the event that previous is 0 the calculated value is infinity with the
-    // exception that if both (current - previous) and previous are 0 the
-    // calculated value is 0.
-    // A 10 minute moving mean is computed at each point of the time window
+    // Align and convert to a percentage change. This aligner is valid for
+    // `GAUGE` and `DELTA` metrics with numeric values. This alignment returns
+    // `((current - previous)/previous) * 100`, where the value of `previous` is
+    // determined based on the `alignment_period`.
+    //
+    // If the values of `current` and `previous` are both 0, then the returned
+    // value is 0. If only `previous` is 0, the returned value is infinity.
+    //
+    // A 10-minute moving mean is computed at each point of the alignment period
     // prior to the above calculation to smooth the metric and prevent false
-    // positives from very short lived spikes.
-    // Only applicable for data that is >= 0. Any values < 0 are treated as
-    // no data. While delta metrics are accepted by this alignment special care
-    // should be taken that the values for the metric will always be positive.
-    // The output is a gauge metric with value type
-    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE].
+    // positives from very short-lived spikes. The moving mean is only
+    // applicable for data whose values are `>= 0`. Any values `< 0` are
+    // treated as a missing datapoint, and are ignored. While `DELTA`
+    // metrics are accepted by this alignment, special care should be taken that
+    // the values for the metric will always be positive. The output is a
+    // `GAUGE` metric with `value_type` `DOUBLE`.
     ALIGN_PERCENT_CHANGE = 23;
   }
 
-  // A Reducer describes how to aggregate data points from multiple
-  // time series into a single time series.
+  // A Reducer operation describes how to aggregate data points from multiple
+  // time series into a single time series, where the value of each data point
+  // in the resulting series is a function of all the already aligned values in
+  // the input time series.
   enum Reducer {
-    // No cross-time series reduction. The output of the aligner is
+    // No cross-time series reduction. The output of the `Aligner` is
     // returned.
     REDUCE_NONE = 0;
 
-    // Reduce by computing the mean across time series for each
-    // alignment period. This reducer is valid for delta and
-    // gauge metrics with numeric or distribution values. The value type of the
-    // output is [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE].
+    // Reduce by computing the mean value across time series for each
+    // alignment period. This reducer is valid for
+    // [DELTA][google.api.MetricDescriptor.MetricKind.DELTA] and
+    // [GAUGE][google.api.MetricDescriptor.MetricKind.GAUGE] metrics with
+    // numeric or distribution values. The `value_type` of the output is
+    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE].
     REDUCE_MEAN = 1;
 
-    // Reduce by computing the minimum across time series for each
-    // alignment period. This reducer is valid for delta and
-    // gauge metrics with numeric values. The value type of the output
-    // is the same as the value type of the input.
+    // Reduce by computing the minimum value across time series for each
+    // alignment period. This reducer is valid for `DELTA` and `GAUGE` metrics
+    // with numeric values. The `value_type` of the output is the same as the
+    // `value_type` of the input.
     REDUCE_MIN = 2;
 
-    // Reduce by computing the maximum across time series for each
-    // alignment period. This reducer is valid for delta and
-    // gauge metrics with numeric values. The value type of the output
-    // is the same as the value type of the input.
+    // Reduce by computing the maximum value across time series for each
+    // alignment period. This reducer is valid for `DELTA` and `GAUGE` metrics
+    // with numeric values. The `value_type` of the output is the same as the
+    // `value_type` of the input.
     REDUCE_MAX = 3;
 
     // Reduce by computing the sum across time series for each
-    // alignment period. This reducer is valid for delta and
-    // gauge metrics with numeric and distribution values. The value type of
-    // the output is the same as the value type of the input.
+    // alignment period. This reducer is valid for `DELTA` and `GAUGE` metrics
+    // with numeric and distribution values. The `value_type` of the output is
+    // the same as the `value_type` of the input.
     REDUCE_SUM = 4;
 
     // Reduce by computing the standard deviation across time series
-    // for each alignment period. This reducer is valid for delta
-    // and gauge metrics with numeric or distribution values. The value type of
-    // the output is [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE].
+    // for each alignment period. This reducer is valid for `DELTA` and
+    // `GAUGE` metrics with numeric or distribution values. The `value_type`
+    // of the output is `DOUBLE`.
     REDUCE_STDDEV = 5;
 
-    // Reduce by computing the count of data points across time series
-    // for each alignment period. This reducer is valid for delta
-    // and gauge metrics of numeric, Boolean, distribution, and string value
-    // type. The value type of the output is
-    // [INT64][google.api.MetricDescriptor.ValueType.INT64].
+    // Reduce by computing the number of data points across time series
+    // for each alignment period. This reducer is valid for `DELTA` and
+    // `GAUGE` metrics of numeric, Boolean, distribution, and string
+    // `value_type`. The `value_type` of the output is `INT64`.
     REDUCE_COUNT = 6;
 
-    // Reduce by computing the count of True-valued data points across time
-    // series for each alignment period. This reducer is valid for delta
-    // and gauge metrics of Boolean value type. The value type of
-    // the output is [INT64][google.api.MetricDescriptor.ValueType.INT64].
+    // Reduce by computing the number of `True`-valued data points across time
+    // series for each alignment period. This reducer is valid for `DELTA` and
+    // `GAUGE` metrics of Boolean `value_type`. The `value_type` of the output
+    // is `INT64`.
     REDUCE_COUNT_TRUE = 7;
 
-    // Reduce by computing the count of False-valued data points across time
-    // series for each alignment period. This reducer is valid for delta
-    // and gauge metrics of Boolean value type. The value type of
-    // the output is [INT64][google.api.MetricDescriptor.ValueType.INT64].
+    // Reduce by computing the number of `False`-valued data points across time
+    // series for each alignment period. This reducer is valid for `DELTA` and
+    // `GAUGE` metrics of Boolean `value_type`. The `value_type` of the output
+    // is `INT64`.
     REDUCE_COUNT_FALSE = 15;
 
-    // Reduce by computing the fraction of True-valued data points across time
-    // series for each alignment period. This reducer is valid for delta
-    // and gauge metrics of Boolean value type. The output value is in the
-    // range [0, 1] and has value type
-    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE].
+    // Reduce by computing the ratio of the number of `True`-valued data points
+    // to the total number of data points for each alignment period. This
+    // reducer is valid for `DELTA` and `GAUGE` metrics of Boolean `value_type`.
+    // The output value is in the range [0.0, 1.0] and has `value_type`
+    // `DOUBLE`.
     REDUCE_FRACTION_TRUE = 8;
 
-    // Reduce by computing 99th percentile of data points across time series
-    // for each alignment period. This reducer is valid for gauge and delta
-    // metrics of numeric and distribution type. The value of the output is
-    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE]
+    // Reduce by computing the [99th
+    // percentile](https://en.wikipedia.org/wiki/Percentile) of data points
+    // across time series for each alignment period. This reducer is valid for
+    // `GAUGE` and `DELTA` metrics of numeric and distribution type. The value
+    // of the output is `DOUBLE`.
     REDUCE_PERCENTILE_99 = 9;
 
-    // Reduce by computing 95th percentile of data points across time series
-    // for each alignment period. This reducer is valid for gauge and delta
-    // metrics of numeric and distribution type. The value of the output is
-    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE]
+    // Reduce by computing the [95th
+    // percentile](https://en.wikipedia.org/wiki/Percentile) of data points
+    // across time series for each alignment period. This reducer is valid for
+    // `GAUGE` and `DELTA` metrics of numeric and distribution type. The value
+    // of the output is `DOUBLE`.
     REDUCE_PERCENTILE_95 = 10;
 
-    // Reduce by computing 50th percentile of data points across time series
-    // for each alignment period. This reducer is valid for gauge and delta
-    // metrics of numeric and distribution type. The value of the output is
-    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE]
+    // Reduce by computing the [50th
+    // percentile](https://en.wikipedia.org/wiki/Percentile) of data points
+    // across time series for each alignment period. This reducer is valid for
+    // `GAUGE` and `DELTA` metrics of numeric and distribution type. The value
+    // of the output is `DOUBLE`.
     REDUCE_PERCENTILE_50 = 11;
 
-    // Reduce by computing 5th percentile of data points across time series
-    // for each alignment period. This reducer is valid for gauge and delta
-    // metrics of numeric and distribution type. The value of the output is
-    // [DOUBLE][google.api.MetricDescriptor.ValueType.DOUBLE]
+    // Reduce by computing the [5th
+    // percentile](https://en.wikipedia.org/wiki/Percentile) of data points
+    // across time series for each alignment period. This reducer is valid for
+    // `GAUGE` and `DELTA` metrics of numeric and distribution type. The value
+    // of the output is `DOUBLE`.
     REDUCE_PERCENTILE_05 = 12;
   }
 
-  // The alignment period for per-[time series][google.monitoring.v3.TimeSeries]
-  // alignment. If present, `alignmentPeriod` must be at least 60
-  // seconds.  After per-time series alignment, each time series will
-  // contain data points only on the period boundaries. If
-  // `perSeriesAligner` is not specified or equals `ALIGN_NONE`, then
-  // this field is ignored. If `perSeriesAligner` is specified and
-  // does not equal `ALIGN_NONE`, then this field must be defined;
-  // otherwise an error is returned.
+  // The `alignment_period` specifies a time interval, in seconds, that is used
+  // to divide the data in all the
+  // [time series][google.monitoring.v3.TimeSeries] into consistent blocks of
+  // time. This will be done before the per-series aligner can be applied to
+  // the data.
+  //
+  // The value must be at least 60 seconds. If a per-series aligner other than
+  // `ALIGN_NONE` is specified, this field is required or an error is returned.
+  // If no per-series aligner is specified, or the aligner `ALIGN_NONE` is
+  // specified, then this field is ignored.
   google.protobuf.Duration alignment_period = 1;
 
-  // The approach to be used to align individual time series. Not all
-  // alignment functions may be applied to all time series, depending
-  // on the metric type and value type of the original time
-  // series. Alignment may change the metric type or the value type of
+  // An `Aligner` describes how to bring the data points in a single
+  // time series into temporal alignment. Except for `ALIGN_NONE`, all
+  // alignments cause all the data points in an `alignment_period` to be
+  // mathematically grouped together, resulting in a single data point for
+  // each `alignment_period` with end timestamp at the end of the period.
+  //
+  // Not all alignment operations may be applied to all time series. The valid
+  // choices depend on the `metric_kind` and `value_type` of the original time
+  // series. Alignment can change the `metric_kind` or the `value_type` of
   // the time series.
   //
   // Time series data must be aligned in order to perform cross-time
-  // series reduction. If `crossSeriesReducer` is specified, then
-  // `perSeriesAligner` must be specified and not equal `ALIGN_NONE`
-  // and `alignmentPeriod` must be specified; otherwise, an error is
+  // series reduction. If `cross_series_reducer` is specified, then
+  // `per_series_aligner` must be specified and not equal to `ALIGN_NONE`
+  // and `alignment_period` must be specified; otherwise, an error is
   // returned.
   Aligner per_series_aligner = 2;
 
-  // The approach to be used to combine time series. Not all reducer
-  // functions may be applied to all time series, depending on the
-  // metric type and the value type of the original time
-  // series. Reduction may change the metric type of value type of the
-  // time series.
+  // The reduction operation to be used to combine time series into a single
+  // time series, where the value of each data point in the resulting series is
+  // a function of all the already aligned values in the input time series.
   //
-  // Time series data must be aligned in order to perform cross-time
-  // series reduction. If `crossSeriesReducer` is specified, then
-  // `perSeriesAligner` must be specified and not equal `ALIGN_NONE`
-  // and `alignmentPeriod` must be specified; otherwise, an error is
-  // returned.
+  // Not all reducer operations can be applied to all time series. The valid
+  // choices depend on the `metric_kind` and the `value_type` of the original
+  // time series. Reduction can yield a time series with a different
+  // `metric_kind` or `value_type` than the input time series.
+  //
+  // Time series data must first be aligned (see `per_series_aligner`) in order
+  // to perform cross-time series reduction. If `cross_series_reducer` is
+  // specified, then `per_series_aligner` must be specified, and must not be
+  // `ALIGN_NONE`. An `alignment_period` must also be specified; otherwise, an
+  // error is returned.
   Reducer cross_series_reducer = 4;
 
-  // The set of fields to preserve when `crossSeriesReducer` is
-  // specified. The `groupByFields` determine how the time series are
+  // The set of fields to preserve when `cross_series_reducer` is
+  // specified. The `group_by_fields` determine how the time series are
   // partitioned into subsets prior to applying the aggregation
-  // function. Each subset contains time series that have the same
+  // operation. Each subset contains time series that have the same
   // value for each of the grouping fields. Each individual time
   // series is a member of exactly one subset. The
-  // `crossSeriesReducer` is applied to each subset of time series.
+  // `cross_series_reducer` is applied to each subset of time series.
   // It is not possible to reduce across different resource types, so
   // this field implicitly contains `resource.type`.  Fields not
-  // specified in `groupByFields` are aggregated away.  If
-  // `groupByFields` is not specified and all the time series have
+  // specified in `group_by_fields` are aggregated away.  If
+  // `group_by_fields` is not specified and all the time series have
   // the same resource type, then the time series are aggregated into
-  // a single output time series. If `crossSeriesReducer` is not
+  // a single output time series. If `cross_series_reducer` is not
   // defined, this field is ignored.
   repeated string group_by_fields = 5;
 }
 
-// Specifies an ordering relationship on two arguments, here called left and
-// right.
+// Specifies an ordering relationship on two arguments, called `left` and
+// `right`.
 enum ComparisonType {
   // No ordering relationship is specified.
   COMPARISON_UNSPECIFIED = 0;
 
-  // The left argument is greater than the right argument.
+  // True if the left argument is greater than the right argument.
   COMPARISON_GT = 1;
 
-  // The left argument is greater than or equal to the right argument.
+  // True if the left argument is greater than or equal to the right argument.
   COMPARISON_GE = 2;
 
-  // The left argument is less than the right argument.
+  // True if the left argument is less than the right argument.
   COMPARISON_LT = 3;
 
-  // The left argument is less than or equal to the right argument.
+  // True if the left argument is less than or equal to the right argument.
   COMPARISON_LE = 4;
 
-  // The left argument is equal to the right argument.
+  // True if the left argument is equal to the right argument.
   COMPARISON_EQ = 5;
 
-  // The left argument is not equal to the right argument.
+  // True if the left argument is not equal to the right argument.
   COMPARISON_NE = 6;
 }
 
diff --git a/third_party/googleapis/google/monitoring/v3/dropped_labels.proto b/third_party/googleapis/google/monitoring/v3/dropped_labels.proto
index acbe8cf25..ce6e46e1f 100644
--- a/third_party/googleapis/google/monitoring/v3/dropped_labels.proto
+++ b/third_party/googleapis/google/monitoring/v3/dropped_labels.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,18 +11,18 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.monitoring.v3;
 
-import "google/api/annotations.proto";
-
+option csharp_namespace = "Google.Cloud.Monitoring.V3";
 option go_package = "google.golang.org/genproto/googleapis/monitoring/v3;monitoring";
 option java_multiple_files = true;
 option java_outer_classname = "DroppedLabelsProto";
 option java_package = "com.google.monitoring.v3";
+option php_namespace = "Google\\Cloud\\Monitoring\\V3";
+option ruby_package = "Google::Cloud::Monitoring::V3";
 
 // A set of (label, value) pairs which were dropped during aggregation, attached
 // to google.api.Distribution.Exemplars in google.api.Distribution values during
diff --git a/third_party/googleapis/google/monitoring/v3/group.proto b/third_party/googleapis/google/monitoring/v3/group.proto
index ca46a0c0d..2d1ffbb61 100644
--- a/third_party/googleapis/google/monitoring/v3/group.proto
+++ b/third_party/googleapis/google/monitoring/v3/group.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,18 +11,20 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.monitoring.v3;
 
+import "google/api/resource.proto";
+
 option csharp_namespace = "Google.Cloud.Monitoring.V3";
 option go_package = "google.golang.org/genproto/googleapis/monitoring/v3;monitoring";
 option java_multiple_files = true;
 option java_outer_classname = "GroupProto";
 option java_package = "com.google.monitoring.v3";
 option php_namespace = "Google\\Cloud\\Monitoring\\V3";
+option ruby_package = "Google::Cloud::Monitoring::V3";
 
 // The description of a dynamic collection of monitored resources. Each group
 // has a filter that is matched against monitored resources and their associated
@@ -51,19 +53,31 @@ option php_namespace = "Google\\Cloud\\Monitoring\\V3";
 // depending on what resources exist and what filters are associated with the
 // group and its ancestors.
 message Group {
-  // Output only. The name of this group. The format is
-  // `"projects/{project_id_or_number}/groups/{group_id}"`.
+  option (google.api.resource) = {
+    type: "monitoring.googleapis.com/Group"
+    pattern: "projects/{project}/groups/{group}"
+    pattern: "organizations/{organization}/groups/{group}"
+    pattern: "folders/{folder}/groups/{group}"
+    pattern: "*"
+  };
+
+  // Output only. The name of this group. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/groups/[GROUP_ID]
+  //
   // When creating a group, this field is ignored and a new name is created
   // consisting of the project specified in the call to `CreateGroup`
-  // and a unique `{group_id}` that is generated automatically.
+  // and a unique `[GROUP_ID]` that is generated automatically.
   string name = 1;
 
   // A user-assigned name for this group, used only for display purposes.
   string display_name = 2;
 
-  // The name of the group's parent, if it has one.
-  // The format is `"projects/{project_id_or_number}/groups/{group_id}"`.
-  // For groups with no parent, `parentName` is the empty string, `""`.
+  // The name of the group's parent, if it has one. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/groups/[GROUP_ID]
+  //
+  // For groups with no parent, `parent_name` is the empty string, `""`.
   string parent_name = 3;
 
   // The filter used to determine which monitored resources belong to this
diff --git a/third_party/googleapis/google/monitoring/v3/group_service.proto b/third_party/googleapis/google/monitoring/v3/group_service.proto
index 34e1d9e99..0163ab36e 100644
--- a/third_party/googleapis/google/monitoring/v3/group_service.proto
+++ b/third_party/googleapis/google/monitoring/v3/group_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,14 +11,16 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.monitoring.v3;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/api/monitored_resource.proto";
+import "google/api/resource.proto";
 import "google/monitoring/v3/common.proto";
 import "google/monitoring/v3/group.proto";
 import "google/protobuf/empty.proto";
@@ -29,6 +31,7 @@ option java_multiple_files = true;
 option java_outer_classname = "GroupServiceProto";
 option java_package = "com.google.monitoring.v3";
 option php_namespace = "Google\\Cloud\\Monitoring\\V3";
+option ruby_package = "Google::Cloud::Monitoring::V3";
 
 // The Group API lets you inspect and manage your
 // [groups](#google.monitoring.v3.Group).
@@ -43,11 +46,18 @@ option php_namespace = "Google\\Cloud\\Monitoring\\V3";
 // updated automatically as monitored resources are added and removed
 // from the infrastructure.
 service GroupService {
+  option (google.api.default_host) = "monitoring.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/monitoring,"
+      "https://www.googleapis.com/auth/monitoring.read";
+
   // Lists the existing groups.
   rpc ListGroups(ListGroupsRequest) returns (ListGroupsResponse) {
     option (google.api.http) = {
       get: "/v3/{name=projects/*}/groups"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Gets a single group.
@@ -55,6 +65,7 @@ service GroupService {
     option (google.api.http) = {
       get: "/v3/{name=projects/*/groups/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates a new group.
@@ -63,6 +74,7 @@ service GroupService {
       post: "/v3/{name=projects/*}/groups"
       body: "group"
     };
+    option (google.api.method_signature) = "name,group";
   }
 
   // Updates an existing group.
@@ -72,6 +84,7 @@ service GroupService {
       put: "/v3/{group.name=projects/*/groups/*}"
       body: "group"
     };
+    option (google.api.method_signature) = "group";
   }
 
   // Deletes an existing group.
@@ -79,50 +92,72 @@ service GroupService {
     option (google.api.http) = {
       delete: "/v3/{name=projects/*/groups/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists the monitored resources that are members of a group.
-  rpc ListGroupMembers(ListGroupMembersRequest)
-      returns (ListGroupMembersResponse) {
+  rpc ListGroupMembers(ListGroupMembersRequest) returns (ListGroupMembersResponse) {
     option (google.api.http) = {
       get: "/v3/{name=projects/*/groups/*}/members"
     };
+    option (google.api.method_signature) = "name";
   }
 }
 
 // The `ListGroup` request.
 message ListGroupsRequest {
-  // The project whose groups are to be listed. The format is
-  // `"projects/{project_id_or_number}"`.
-  string name = 7;
+  // Required. The project whose groups are to be listed. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]
+  string name = 7 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "monitoring.googleapis.com/Group"
+    }
+  ];
 
   // An optional filter consisting of a single group name.  The filters limit
   // the groups returned based on their parent-child relationship with the
   // specified group. If no filter is specified, all groups are returned.
   oneof filter {
-    // A group name: `"projects/{project_id_or_number}/groups/{group_id}"`.
-    // Returns groups whose `parentName` field contains the group
+    // A group name. The format is:
+    //
+    //     projects/[PROJECT_ID_OR_NUMBER]/groups/[GROUP_ID]
+    //
+    // Returns groups whose `parent_name` field contains the group
     // name.  If no groups have this parent, the results are empty.
-    string children_of_group = 2;
-
-    // A group name: `"projects/{project_id_or_number}/groups/{group_id}"`.
+    string children_of_group = 2 [(google.api.resource_reference) = {
+                                    type: "monitoring.googleapis.com/Group"
+                                  }];
+
+    // A group name. The format is:
+    //
+    //     projects/[PROJECT_ID_OR_NUMBER]/groups/[GROUP_ID]
+    //
     // Returns groups that are ancestors of the specified group.
     // The groups are returned in order, starting with the immediate parent and
     // ending with the most distant ancestor.  If the specified group has no
     // immediate parent, the results are empty.
-    string ancestors_of_group = 3;
-
-    // A group name: `"projects/{project_id_or_number}/groups/{group_id}"`.
+    string ancestors_of_group = 3 [(google.api.resource_reference) = {
+                                     type: "monitoring.googleapis.com/Group"
+                                   }];
+
+    // A group name. The format is:
+    //
+    //     projects/[PROJECT_ID_OR_NUMBER]/groups/[GROUP_ID]
+    //
     // Returns the descendants of the specified group.  This is a superset of
-    // the results returned by the `childrenOfGroup` filter, and includes
+    // the results returned by the `children_of_group` filter, and includes
     // children-of-children, and so forth.
-    string descendants_of_group = 4;
+    string descendants_of_group = 4 [(google.api.resource_reference) = {
+                                       type: "monitoring.googleapis.com/Group"
+                                     }];
   }
 
   // A positive number that is the maximum number of results to return.
   int32 page_size = 5;
 
-  // If this field is not empty then it must contain the `nextPageToken` value
+  // If this field is not empty then it must contain the `next_page_token` value
   // returned by a previous call to this method.  Using this field causes the
   // method to return additional results from the previous method call.
   string page_token = 6;
@@ -135,26 +170,38 @@ message ListGroupsResponse {
 
   // If there are more results than have been returned, then this field is set
   // to a non-empty value.  To see the additional results,
-  // use that value as `pageToken` in the next call to this method.
+  // use that value as `page_token` in the next call to this method.
   string next_page_token = 2;
 }
 
 // The `GetGroup` request.
 message GetGroupRequest {
-  // The group to retrieve. The format is
-  // `"projects/{project_id_or_number}/groups/{group_id}"`.
-  string name = 3;
+  // Required. The group to retrieve. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/groups/[GROUP_ID]
+  string name = 3 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "monitoring.googleapis.com/Group"
+    }
+  ];
 }
 
 // The `CreateGroup` request.
 message CreateGroupRequest {
-  // The project in which to create the group. The format is
-  // `"projects/{project_id_or_number}"`.
-  string name = 4;
-
-  // A group definition. It is an error to define the `name` field because
+  // Required. The project in which to create the group. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]
+  string name = 4 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "monitoring.googleapis.com/Group"
+    }
+  ];
+
+  // Required. A group definition. It is an error to define the `name` field because
   // the system assigns the name.
-  Group group = 2;
+  Group group = 2 [(google.api.field_behavior) = REQUIRED];
 
   // If true, validate this request but do not create the group.
   bool validate_only = 3;
@@ -162,42 +209,61 @@ message CreateGroupRequest {
 
 // The `UpdateGroup` request.
 message UpdateGroupRequest {
-  // The new definition of the group.  All fields of the existing group,
+  // Required. The new definition of the group.  All fields of the existing group,
   // excepting `name`, are replaced with the corresponding fields of this group.
-  Group group = 2;
+  Group group = 2 [(google.api.field_behavior) = REQUIRED];
 
   // If true, validate this request but do not update the existing group.
   bool validate_only = 3;
 }
 
-// The `DeleteGroup` request. You can only delete a group if it has no children.
+// The `DeleteGroup` request. The default behavior is to be able to delete a
+// single group without any descendants.
 message DeleteGroupRequest {
-  // The group to delete. The format is
-  // `"projects/{project_id_or_number}/groups/{group_id}"`.
-  string name = 3;
+  // Required. The group to delete. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/groups/[GROUP_ID]
+  string name = 3 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "monitoring.googleapis.com/Group"
+    }
+  ];
+
+  // If this field is true, then the request means to delete a group with all
+  // its descendants. Otherwise, the request means to delete a group only when
+  // it has no descendants. The default value is false.
+  bool recursive = 4;
 }
 
 // The `ListGroupMembers` request.
 message ListGroupMembersRequest {
-  // The group whose members are listed. The format is
-  // `"projects/{project_id_or_number}/groups/{group_id}"`.
-  string name = 7;
+  // Required. The group whose members are listed. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/groups/[GROUP_ID]
+  string name = 7 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "monitoring.googleapis.com/Group"
+    }
+  ];
 
   // A positive number that is the maximum number of results to return.
   int32 page_size = 3;
 
-  // If this field is not empty then it must contain the `nextPageToken` value
+  // If this field is not empty then it must contain the `next_page_token` value
   // returned by a previous call to this method.  Using this field causes the
   // method to return additional results from the previous method call.
   string page_token = 4;
 
-  // An optional [list filter](/monitoring/api/learn_more#filtering) describing
-  // the members to be returned.  The filter may reference the type, labels, and
-  // metadata of monitored resources that comprise the group.
-  // For example, to return only resources representing Compute Engine VM
-  // instances, use this filter:
+  // An optional [list
+  // filter](https://cloud.google.com/monitoring/api/learn_more#filtering)
+  // describing the members to be returned.  The filter may reference the type,
+  // labels, and metadata of monitored resources that comprise the group. For
+  // example, to return only resources representing Compute Engine VM instances,
+  // use this filter:
   //
-  //     resource.type = "gce_instance"
+  //     `resource.type = "gce_instance"`
   string filter = 5;
 
   // An optional time interval for which results should be returned. Only
@@ -214,7 +280,7 @@ message ListGroupMembersResponse {
 
   // If there are more results than have been returned, then this field is
   // set to a non-empty value.  To see the additional results, use that value as
-  // `pageToken` in the next call to this method.
+  // `page_token` in the next call to this method.
   string next_page_token = 2;
 
   // The total number of elements matching this request.
diff --git a/third_party/googleapis/google/monitoring/v3/metric.proto b/third_party/googleapis/google/monitoring/v3/metric.proto
index c111d4fb4..5a4833b19 100644
--- a/third_party/googleapis/google/monitoring/v3/metric.proto
+++ b/third_party/googleapis/google/monitoring/v3/metric.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,17 +11,17 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.monitoring.v3;
 
-import "google/api/annotations.proto";
+import "google/api/distribution.proto";
 import "google/api/label.proto";
 import "google/api/metric.proto";
 import "google/api/monitored_resource.proto";
 import "google/monitoring/v3/common.proto";
+import "google/protobuf/duration.proto";
 
 option csharp_namespace = "Google.Cloud.Monitoring.V3";
 option go_package = "google.golang.org/genproto/googleapis/monitoring/v3;monitoring";
@@ -29,11 +29,13 @@ option java_multiple_files = true;
 option java_outer_classname = "MetricProto";
 option java_package = "com.google.monitoring.v3";
 option php_namespace = "Google\\Cloud\\Monitoring\\V3";
+option ruby_package = "Google::Cloud::Monitoring::V3";
 
 // A single data point in a time series.
 message Point {
   // The time interval to which the data point applies.  For `GAUGE` metrics,
-  // only the end time of the interval is used.  For `DELTA` metrics, the start
+  // the start time is optional, but if it is supplied, it must equal the
+  // end time.  For `DELTA` metrics, the start
   // and end time should specify a non-zero interval, with subsequent points
   // specifying contiguous and non-overlapping intervals.  For `CUMULATIVE`
   // metrics, the start and end time should specify a non-zero interval, with
@@ -93,3 +95,134 @@ message TimeSeries {
   // must be `BOOL`, `INT64`, `DOUBLE`, or `DISTRIBUTION`.
   repeated Point points = 5;
 }
+
+// A descriptor for the labels and points in a timeseries.
+message TimeSeriesDescriptor {
+  // A descriptor for the value columns in a data point.
+  message ValueDescriptor {
+    // The value key.
+    string key = 1;
+
+    // The value type.
+    google.api.MetricDescriptor.ValueType value_type = 2;
+
+    // The value stream kind.
+    google.api.MetricDescriptor.MetricKind metric_kind = 3;
+  }
+
+  // Descriptors for the labels.
+  repeated google.api.LabelDescriptor label_descriptors = 1;
+
+  // Descriptors for the point data value columns.
+  repeated ValueDescriptor point_descriptors = 5;
+}
+
+// Represents the values of a time series associated with a
+// TimeSeriesDescriptor.
+message TimeSeriesData {
+  // A point's value columns and time interval. Each point has one or more
+  // point values corresponding to the entries in `point_descriptors` field in
+  // the TimeSeriesDescriptor associated with this object.
+  message PointData {
+    // The values that make up the point.
+    repeated TypedValue values = 1;
+
+    // The time interval associated with the point.
+    TimeInterval time_interval = 2;
+  }
+
+  // The values of the labels in the time series identifier, given in the same
+  // order as the `label_descriptors` field of the TimeSeriesDescriptor
+  // associated with this object. Each value must have a value of the type
+  // given in the corresponding entry of `label_descriptors`.
+  repeated LabelValue label_values = 1;
+
+  // The points in the time series.
+  repeated PointData point_data = 2;
+}
+
+// A label value.
+message LabelValue {
+  // The label value can be a bool, int64, or string.
+  oneof value {
+    // A bool label value.
+    bool bool_value = 1;
+
+    // An int64 label value.
+    int64 int64_value = 2;
+
+    // A string label value.
+    string string_value = 3;
+  }
+}
+
+// An error associated with a query in the time series query language format.
+message QueryError {
+  // The location of the time series query language text that this error applies
+  // to.
+  TextLocator locator = 1;
+
+  // The error message.
+  string message = 2;
+}
+
+// A locator for text. Indicates a particular part of the text of a request or
+// of an object referenced in the request.
+//
+// For example, suppose the request field `text` contains:
+//
+//   text: "The quick brown fox jumps over the lazy dog."
+//
+// Then the locator:
+//
+//   source: "text"
+//   start_position {
+//     line: 1
+//     column: 17
+//   }
+//   end_position {
+//     line: 1
+//     column: 19
+//   }
+//
+// refers to the part of the text: "fox".
+message TextLocator {
+  // The position of a byte within the text.
+  message Position {
+    // The line, starting with 1, where the byte is positioned.
+    int32 line = 1;
+
+    // The column within the line, starting with 1, where the byte is
+    // positioned. This is a byte index even though the text is UTF-8.
+    int32 column = 2;
+  }
+
+  // The source of the text. The source may be a field in the request, in which
+  // case its format is the format of the
+  // google.rpc.BadRequest.FieldViolation.field field in
+  // https://cloud.google.com/apis/design/errors#error_details. It may also be
+  // be a source other than the request field (e.g. a macro definition
+  // referenced in the text of the query), in which case this is the name of
+  // the source (e.g. the macro name).
+  string source = 1;
+
+  // The position of the first byte within the text.
+  Position start_position = 2;
+
+  // The position of the last byte within the text.
+  Position end_position = 3;
+
+  // If `source`, `start_position`, and `end_position` describe a call on
+  // some object (e.g. a macro in the time series query language text) and a
+  // location is to be designated in that object's text, `nested_locator`
+  // identifies the location within that object.
+  TextLocator nested_locator = 4;
+
+  // When `nested_locator` is set, this field gives the reason for the nesting.
+  // Usually, the reason is a macro invocation. In that case, the macro name
+  // (including the leading '@') signals the location of the macro call
+  // in the text and a macro argument name (including the leading '$') signals
+  // the location of the macro argument inside the macro body that got
+  // substituted away.
+  string nesting_reason = 5;
+}
diff --git a/third_party/googleapis/google/monitoring/v3/metric_service.proto b/third_party/googleapis/google/monitoring/v3/metric_service.proto
index febd3f7b5..119990358 100644
--- a/third_party/googleapis/google/monitoring/v3/metric_service.proto
+++ b/third_party/googleapis/google/monitoring/v3/metric_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,15 +11,18 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.monitoring.v3;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/api/metric.proto";
 import "google/api/monitored_resource.proto";
+import "google/api/resource.proto";
+import "google/monitoring/v3/alert.proto";
 import "google/monitoring/v3/common.proto";
 import "google/monitoring/v3/metric.proto";
 import "google/protobuf/duration.proto";
@@ -32,98 +35,124 @@ option java_multiple_files = true;
 option java_outer_classname = "MetricServiceProto";
 option java_package = "com.google.monitoring.v3";
 option php_namespace = "Google\\Cloud\\Monitoring\\V3";
+option ruby_package = "Google::Cloud::Monitoring::V3";
+option (google.api.resource_definition) = {
+  type: "monitoring.googleapis.com/MetricDescriptor"
+  pattern: "projects/{project}/metricDescriptors/{metric_descriptor=**}"
+  pattern: "organizations/{organization}/metricDescriptors/{metric_descriptor=**}"
+  pattern: "folders/{folder}/metricDescriptors/{metric_descriptor=**}"
+  pattern: "*"
+  history: ORIGINALLY_SINGLE_PATTERN
+};
+option (google.api.resource_definition) = {
+  type: "monitoring.googleapis.com/MonitoredResourceDescriptor"
+  pattern: "projects/{project}/monitoredResourceDescriptors/{monitored_resource_descriptor}"
+  pattern: "organizations/{organization}/monitoredResourceDescriptors/{monitored_resource_descriptor}"
+  pattern: "folders/{folder}/monitoredResourceDescriptors/{monitored_resource_descriptor}"
+  pattern: "*"
+  history: ORIGINALLY_SINGLE_PATTERN
+};
 
 // Manages metric descriptors, monitored resource descriptors, and
 // time series data.
 service MetricService {
-  // Lists monitored resource descriptors that match a filter. This method does
-  // not require a Stackdriver account.
-  rpc ListMonitoredResourceDescriptors(ListMonitoredResourceDescriptorsRequest)
-      returns (ListMonitoredResourceDescriptorsResponse) {
+  option (google.api.default_host) = "monitoring.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/monitoring,"
+      "https://www.googleapis.com/auth/monitoring.read,"
+      "https://www.googleapis.com/auth/monitoring.write";
+
+  // Lists monitored resource descriptors that match a filter. This method does not require a Workspace.
+  rpc ListMonitoredResourceDescriptors(ListMonitoredResourceDescriptorsRequest) returns (ListMonitoredResourceDescriptorsResponse) {
     option (google.api.http) = {
       get: "/v3/{name=projects/*}/monitoredResourceDescriptors"
     };
+    option (google.api.method_signature) = "name";
   }
 
-  // Gets a single monitored resource descriptor. This method does not require a
-  // Stackdriver account.
-  rpc GetMonitoredResourceDescriptor(GetMonitoredResourceDescriptorRequest)
-      returns (google.api.MonitoredResourceDescriptor) {
+  // Gets a single monitored resource descriptor. This method does not require a Workspace.
+  rpc GetMonitoredResourceDescriptor(GetMonitoredResourceDescriptorRequest) returns (google.api.MonitoredResourceDescriptor) {
     option (google.api.http) = {
-      get: "/v3/{name=projects/*/monitoredResourceDescriptors/*}"
+      get: "/v3/{name=projects/*/monitoredResourceDescriptors/**}"
     };
+    option (google.api.method_signature) = "name";
   }
 
-  // Lists metric descriptors that match a filter. This method does not require
-  // a Stackdriver account.
-  rpc ListMetricDescriptors(ListMetricDescriptorsRequest)
-      returns (ListMetricDescriptorsResponse) {
+  // Lists metric descriptors that match a filter. This method does not require a Workspace.
+  rpc ListMetricDescriptors(ListMetricDescriptorsRequest) returns (ListMetricDescriptorsResponse) {
     option (google.api.http) = {
       get: "/v3/{name=projects/*}/metricDescriptors"
     };
+    option (google.api.method_signature) = "name";
   }
 
-  // Gets a single metric descriptor. This method does not require a Stackdriver
-  // account.
-  rpc GetMetricDescriptor(GetMetricDescriptorRequest)
-      returns (google.api.MetricDescriptor) {
+  // Gets a single metric descriptor. This method does not require a Workspace.
+  rpc GetMetricDescriptor(GetMetricDescriptorRequest) returns (google.api.MetricDescriptor) {
     option (google.api.http) = {
       get: "/v3/{name=projects/*/metricDescriptors/**}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates a new metric descriptor.
   // User-created metric descriptors define
-  // [custom metrics](/monitoring/custom-metrics).
-  rpc CreateMetricDescriptor(CreateMetricDescriptorRequest)
-      returns (google.api.MetricDescriptor) {
+  // [custom metrics](https://cloud.google.com/monitoring/custom-metrics).
+  rpc CreateMetricDescriptor(CreateMetricDescriptorRequest) returns (google.api.MetricDescriptor) {
     option (google.api.http) = {
       post: "/v3/{name=projects/*}/metricDescriptors"
       body: "metric_descriptor"
     };
+    option (google.api.method_signature) = "name,metric_descriptor";
   }
 
   // Deletes a metric descriptor. Only user-created
-  // [custom metrics](/monitoring/custom-metrics) can be deleted.
-  rpc DeleteMetricDescriptor(DeleteMetricDescriptorRequest)
-      returns (google.protobuf.Empty) {
+  // [custom metrics](https://cloud.google.com/monitoring/custom-metrics) can be
+  // deleted.
+  rpc DeleteMetricDescriptor(DeleteMetricDescriptorRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v3/{name=projects/*/metricDescriptors/**}"
     };
+    option (google.api.method_signature) = "name";
   }
 
-  // Lists time series that match a filter. This method does not require a
-  // Stackdriver account.
+  // Lists time series that match a filter. This method does not require a Workspace.
   rpc ListTimeSeries(ListTimeSeriesRequest) returns (ListTimeSeriesResponse) {
     option (google.api.http) = {
       get: "/v3/{name=projects/*}/timeSeries"
     };
+    option (google.api.method_signature) = "name,filter,interval,view";
   }
 
   // Creates or adds data to one or more time series.
   // The response is empty if all time series in the request were written.
   // If any time series could not be written, a corresponding failure message is
   // included in the error response.
-  rpc CreateTimeSeries(CreateTimeSeriesRequest)
-      returns (google.protobuf.Empty) {
+  rpc CreateTimeSeries(CreateTimeSeriesRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       post: "/v3/{name=projects/*}/timeSeries"
       body: "*"
     };
+    option (google.api.method_signature) = "name,time_series";
   }
 }
 
 // The `ListMonitoredResourceDescriptors` request.
 message ListMonitoredResourceDescriptorsRequest {
-  // The project on which to execute the request. The format is
-  // `"projects/{project_id_or_number}"`.
-  string name = 5;
-
-  // An optional [filter](/monitoring/api/v3/filters) describing
-  // the descriptors to be returned.  The filter can reference
-  // the descriptor's type and labels. For example, the
-  // following filter returns only Google Compute Engine descriptors
-  // that have an `id` label:
+  // Required. The project on which to execute the request. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]
+  string name = 5 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "monitoring.googleapis.com/MonitoredResourceDescriptor"
+    }
+  ];
+
+  // An optional [filter](https://cloud.google.com/monitoring/api/v3/filters)
+  // describing the descriptors to be returned.  The filter can reference the
+  // descriptor's type and labels. For example, the following filter returns
+  // only Google Compute Engine descriptors that have an `id` label:
   //
   //     resource.type = starts_with("gce_") AND resource.label:id
   string filter = 2;
@@ -145,31 +174,44 @@ message ListMonitoredResourceDescriptorsResponse {
 
   // If there are more results than have been returned, then this field is set
   // to a non-empty value.  To see the additional results,
-  // use that value as `pageToken` in the next call to this method.
+  // use that value as `page_token` in the next call to this method.
   string next_page_token = 2;
 }
 
 // The `GetMonitoredResourceDescriptor` request.
 message GetMonitoredResourceDescriptorRequest {
-  // The monitored resource descriptor to get.  The format is
-  // `"projects/{project_id_or_number}/monitoredResourceDescriptors/{resource_type}"`.
-  // The `{resource_type}` is a predefined type, such as
+  // Required. The monitored resource descriptor to get.  The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/monitoredResourceDescriptors/[RESOURCE_TYPE]
+  //
+  // The `[RESOURCE_TYPE]` is a predefined type, such as
   // `cloudsql_database`.
-  string name = 3;
+  string name = 3 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "monitoring.googleapis.com/MonitoredResourceDescriptor"
+    }
+  ];
 }
 
 // The `ListMetricDescriptors` request.
 message ListMetricDescriptorsRequest {
-  // The project on which to execute the request. The format is
-  // `"projects/{project_id_or_number}"`.
-  string name = 5;
+  // Required. The project on which to execute the request. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]
+  string name = 5 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "monitoring.googleapis.com/MetricDescriptor"
+    }
+  ];
 
   // If this field is empty, all custom and
   // system-defined metric descriptors are returned.
-  // Otherwise, the [filter](/monitoring/api/v3/filters)
+  // Otherwise, the [filter](https://cloud.google.com/monitoring/api/v3/filters)
   // specifies which metric descriptors are to be
   // returned. For example, the following filter matches all
-  // [custom metrics](/monitoring/custom-metrics):
+  // [custom metrics](https://cloud.google.com/monitoring/custom-metrics):
   //
   //     metric.type = starts_with("custom.googleapis.com/")
   string filter = 2;
@@ -191,37 +233,57 @@ message ListMetricDescriptorsResponse {
 
   // If there are more results than have been returned, then this field is set
   // to a non-empty value.  To see the additional results,
-  // use that value as `pageToken` in the next call to this method.
+  // use that value as `page_token` in the next call to this method.
   string next_page_token = 2;
 }
 
 // The `GetMetricDescriptor` request.
 message GetMetricDescriptorRequest {
-  // The metric descriptor on which to execute the request. The format is
-  // `"projects/{project_id_or_number}/metricDescriptors/{metric_id}"`.
-  // An example value of `{metric_id}` is
+  // Required. The metric descriptor on which to execute the request. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/metricDescriptors/[METRIC_ID]
+  //
+  // An example value of `[METRIC_ID]` is
   // `"compute.googleapis.com/instance/disk/read_bytes_count"`.
-  string name = 3;
+  string name = 3 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "monitoring.googleapis.com/MetricDescriptor"
+    }
+  ];
 }
 
 // The `CreateMetricDescriptor` request.
 message CreateMetricDescriptorRequest {
-  // The project on which to execute the request. The format is
-  // `"projects/{project_id_or_number}"`.
-  string name = 3;
-
-  // The new [custom metric](/monitoring/custom-metrics)
+  // Required. The project on which to execute the request. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]
+  string name = 3 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "monitoring.googleapis.com/MetricDescriptor"
+    }
+  ];
+
+  // Required. The new [custom metric](https://cloud.google.com/monitoring/custom-metrics)
   // descriptor.
-  google.api.MetricDescriptor metric_descriptor = 2;
+  google.api.MetricDescriptor metric_descriptor = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The `DeleteMetricDescriptor` request.
 message DeleteMetricDescriptorRequest {
-  // The metric descriptor on which to execute the request. The format is
-  // `"projects/{project_id_or_number}/metricDescriptors/{metric_id}"`.
-  // An example of `{metric_id}` is:
+  // Required. The metric descriptor on which to execute the request. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/metricDescriptors/[METRIC_ID]
+  //
+  // An example of `[METRIC_ID]` is:
   // `"custom.googleapis.com/my_test_metric"`.
-  string name = 3;
+  string name = 3 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "monitoring.googleapis.com/MetricDescriptor"
+    }
+  ];
 }
 
 // The `ListTimeSeries` request.
@@ -237,35 +299,43 @@ message ListTimeSeriesRequest {
     HEADERS = 1;
   }
 
-  // The project on which to execute the request. The format is
-  // "projects/{project_id_or_number}".
-  string name = 10;
-
-  // A [monitoring filter](/monitoring/api/v3/filters) that specifies which time
-  // series should be returned.  The filter must specify a single metric type,
-  // and can additionally specify metric labels and other information. For
-  // example:
+  // Required. The project on which to execute the request. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]
+  string name = 10 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
+
+  // Required. A [monitoring filter](https://cloud.google.com/monitoring/api/v3/filters)
+  // that specifies which time series should be returned.  The filter must
+  // specify a single metric type, and can additionally specify metric labels
+  // and other information. For example:
   //
   //     metric.type = "compute.googleapis.com/instance/cpu/usage_time" AND
-  //         metric.label.instance_name = "my-instance-name"
-  string filter = 2;
+  //         metric.labels.instance_name = "my-instance-name"
+  string filter = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // The time interval for which results should be returned. Only time series
+  // Required. The time interval for which results should be returned. Only time series
   // that contain data points in the specified interval are included
   // in the response.
-  TimeInterval interval = 4;
+  TimeInterval interval = 4 [(google.api.field_behavior) = REQUIRED];
 
-  // By default, the raw time series data is returned.
-  // Use this field to combine multiple time series for different
-  // views of the data.
+  // Specifies the alignment of data points in individual time series as
+  // well as how to combine the retrieved time series across specified labels.
+  //
+  // By default (if no `aggregation` is explicitly specified), the raw time
+  // series data is returned.
   Aggregation aggregation = 5;
 
   // Unsupported: must be left blank. The points in each time series are
-  // returned in reverse time order.
+  // currently returned in reverse time order (most recent to oldest).
   string order_by = 6;
 
-  // Specifies which information is returned about the time series.
-  TimeSeriesView view = 7;
+  // Required. Specifies which information is returned about the time series.
+  TimeSeriesView view = 7 [(google.api.field_behavior) = REQUIRED];
 
   // A positive number that is the maximum number of results to return. If
   // `page_size` is empty or more than 100,000 results, the effective
@@ -287,7 +357,7 @@ message ListTimeSeriesResponse {
 
   // If there are more results than have been returned, then this field is set
   // to a non-empty value.  To see the additional results,
-  // use that value as `pageToken` in the next call to this method.
+  // use that value as `page_token` in the next call to this method.
   string next_page_token = 2;
 
   // Query execution errors that may have caused the time series data returned
@@ -297,26 +367,101 @@ message ListTimeSeriesResponse {
 
 // The `CreateTimeSeries` request.
 message CreateTimeSeriesRequest {
-  // The project on which to execute the request. The format is
-  // `"projects/{project_id_or_number}"`.
-  string name = 3;
-
-  // The new data to be added to a list of time series.
+  // Required. The project on which to execute the request. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]
+  string name = 3 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
+
+  // Required. The new data to be added to a list of time series.
   // Adds at most one data point to each of several time series.  The new data
   // point must be more recent than any other point in its time series.  Each
   // `TimeSeries` value must fully specify a unique time series by supplying
   // all label values for the metric and the monitored resource.
-  repeated TimeSeries time_series = 2;
+  //
+  // The maximum number of `TimeSeries` objects per `Create` request is 200.
+  repeated TimeSeries time_series = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
-// Describes the result of a failed request to write data to a time series.
+// DEPRECATED. Used to hold per-time-series error status.
 message CreateTimeSeriesError {
-  // The time series, including the `Metric`, `MonitoredResource`,
-  // and `Point`s (including timestamp and value) that resulted
-  // in the error. This field provides all of the context that
-  // would be needed to retry the operation.
-  TimeSeries time_series = 1;
-
-  // The status of the requested write operation.
-  google.rpc.Status status = 2;
+  // DEPRECATED. Time series ID that resulted in the `status` error.
+  TimeSeries time_series = 1 [deprecated = true];
+
+  // DEPRECATED. The status of the requested write operation for `time_series`.
+  google.rpc.Status status = 2 [deprecated = true];
+}
+
+// Summary of the result of a failed request to write data to a time series.
+message CreateTimeSeriesSummary {
+  // Detailed information about an error category.
+  message Error {
+    // The status of the requested write operation.
+    google.rpc.Status status = 1;
+
+    // The number of points that couldn't be written because of `status`.
+    int32 point_count = 2;
+  }
+
+  // The number of points in the request.
+  int32 total_point_count = 1;
+
+  // The number of points that were successfully written.
+  int32 success_point_count = 2;
+
+  // The number of points that failed to be written. Order is not guaranteed.
+  repeated Error errors = 3;
+}
+
+// The `QueryTimeSeries` request.
+message QueryTimeSeriesRequest {
+  // Required. The project on which to execute the request. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]
+  string name = 1;
+
+  // Required. The query in the monitoring query language format. The default
+  // time zone is in UTC.
+  string query = 7;
+
+  // A positive number that is the maximum number of time_series_data to return.
+  int32 page_size = 9;
+
+  // If this field is not empty then it must contain the `nextPageToken` value
+  // returned by a previous call to this method.  Using this field causes the
+  // method to return additional results from the previous method call.
+  string page_token = 10;
+}
+
+// The `QueryTimeSeries` response.
+message QueryTimeSeriesResponse {
+  // The descriptor for the time series data.
+  TimeSeriesDescriptor time_series_descriptor = 8;
+
+  // The time series data.
+  repeated TimeSeriesData time_series_data = 9;
+
+  // If there are more results than have been returned, then this field is set
+  // to a non-empty value.  To see the additional results, use that value as
+  // `page_token` in the next call to this method.
+  string next_page_token = 10;
+
+  // Query execution errors that may have caused the time series data returned
+  // to be incomplete. The available data will be available in the
+  // response.
+  repeated google.rpc.Status partial_errors = 11;
+}
+
+// This is an error detail intended to be used with INVALID_ARGUMENT errors.
+message QueryErrorList {
+  // Errors in parsing the time series query language text. The number of errors
+  // in the response may be limited.
+  repeated QueryError errors = 1;
+
+  // A summary of all the errors.
+  string error_summary = 2;
 }
diff --git a/third_party/googleapis/google/monitoring/v3/monitoring.yaml b/third_party/googleapis/google/monitoring/v3/monitoring.yaml
new file mode 100644
index 000000000..4513a0cb0
--- /dev/null
+++ b/third_party/googleapis/google/monitoring/v3/monitoring.yaml
@@ -0,0 +1,190 @@
+type: google.api.Service
+config_version: 3
+name: monitoring.googleapis.com
+title: Cloud Monitoring API
+
+apis:
+- name: google.monitoring.v3.AlertPolicyService
+- name: google.monitoring.v3.GroupService
+- name: google.monitoring.v3.MetricService
+- name: google.monitoring.v3.NotificationChannelService
+- name: google.monitoring.v3.ServiceMonitoringService
+- name: google.monitoring.v3.UptimeCheckService
+
+types:
+- name: google.monitoring.v3.DroppedLabels
+- name: google.monitoring.v3.SpanContext
+
+documentation:
+  summary: |-
+    Manages your Cloud Monitoring data and configurations. Most projects must
+    be associated with a Workspace, with a few exceptions as noted on the
+    individual method pages. The table entries below are presented in
+    alphabetical order, not in order of common use. For explanations of the
+    concepts found in the table entries, read the [Cloud Monitoring
+    documentation](https://cloud.google.com/monitoring/docs).
+
+backend:
+  rules:
+  - selector: 'google.monitoring.v3.AlertPolicyService.*'
+    deadline: 30.0
+  - selector: 'google.monitoring.v3.GroupService.*'
+    deadline: 30.0
+  - selector: 'google.monitoring.v3.MetricService.*'
+    deadline: 30.0
+  - selector: google.monitoring.v3.MetricService.CreateTimeSeries
+    deadline: 12.0
+  - selector: google.monitoring.v3.MetricService.ListTimeSeries
+    deadline: 90.0
+  - selector: 'google.monitoring.v3.NotificationChannelService.*'
+    deadline: 30.0
+
+authentication:
+  rules:
+  - selector: 'google.monitoring.v3.AlertPolicyService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring
+  - selector: google.monitoring.v3.AlertPolicyService.GetAlertPolicy
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring,
+        https://www.googleapis.com/auth/monitoring.read
+  - selector: google.monitoring.v3.AlertPolicyService.ListAlertPolicies
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring,
+        https://www.googleapis.com/auth/monitoring.read
+  - selector: 'google.monitoring.v3.GroupService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring,
+        https://www.googleapis.com/auth/monitoring.read
+  - selector: google.monitoring.v3.GroupService.CreateGroup
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring
+  - selector: google.monitoring.v3.GroupService.DeleteGroup
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring
+  - selector: google.monitoring.v3.GroupService.UpdateGroup
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring
+  - selector: 'google.monitoring.v3.MetricService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring,
+        https://www.googleapis.com/auth/monitoring.read,
+        https://www.googleapis.com/auth/monitoring.write
+  - selector: google.monitoring.v3.MetricService.CreateMetricDescriptor
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring,
+        https://www.googleapis.com/auth/monitoring.write
+  - selector: google.monitoring.v3.MetricService.CreateTimeSeries
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring,
+        https://www.googleapis.com/auth/monitoring.write
+  - selector: google.monitoring.v3.MetricService.DeleteMetricDescriptor
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring
+  - selector: google.monitoring.v3.MetricService.ListTimeSeries
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring,
+        https://www.googleapis.com/auth/monitoring.read
+  - selector: 'google.monitoring.v3.NotificationChannelService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring
+  - selector: google.monitoring.v3.NotificationChannelService.GetNotificationChannel
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring,
+        https://www.googleapis.com/auth/monitoring.read
+  - selector: google.monitoring.v3.NotificationChannelService.GetNotificationChannelDescriptor
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring,
+        https://www.googleapis.com/auth/monitoring.read
+  - selector: google.monitoring.v3.NotificationChannelService.ListNotificationChannelDescriptors
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring,
+        https://www.googleapis.com/auth/monitoring.read
+  - selector: google.monitoring.v3.NotificationChannelService.ListNotificationChannels
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring,
+        https://www.googleapis.com/auth/monitoring.read
+  - selector: 'google.monitoring.v3.ServiceMonitoringService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring
+  - selector: google.monitoring.v3.ServiceMonitoringService.GetService
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring,
+        https://www.googleapis.com/auth/monitoring.read
+  - selector: google.monitoring.v3.ServiceMonitoringService.GetServiceLevelObjective
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring,
+        https://www.googleapis.com/auth/monitoring.read
+  - selector: google.monitoring.v3.ServiceMonitoringService.ListServiceLevelObjectives
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring,
+        https://www.googleapis.com/auth/monitoring.read
+  - selector: google.monitoring.v3.ServiceMonitoringService.ListServices
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring,
+        https://www.googleapis.com/auth/monitoring.read
+  - selector: 'google.monitoring.v3.UptimeCheckService.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring,
+        https://www.googleapis.com/auth/monitoring.read
+  - selector: google.monitoring.v3.UptimeCheckService.CreateUptimeCheckConfig
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring
+  - selector: google.monitoring.v3.UptimeCheckService.DeleteUptimeCheckConfig
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring
+  - selector: google.monitoring.v3.UptimeCheckService.UpdateUptimeCheckConfig
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/monitoring
diff --git a/third_party/googleapis/google/monitoring/v3/monitoring_gapic.legacy.yaml b/third_party/googleapis/google/monitoring/v3/monitoring_gapic.legacy.yaml
new file mode 100644
index 000000000..2d869f505
--- /dev/null
+++ b/third_party/googleapis/google/monitoring/v3/monitoring_gapic.legacy.yaml
@@ -0,0 +1,1336 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: com.google.cloud.monitoring.v3
+    release_level: GA
+  python:
+    package_name: google.cloud.monitoring_v3.gapic
+  go:
+    package_name: cloud.google.com/go/monitoring/apiv3
+  csharp:
+    package_name: Google.Cloud.Monitoring.V3
+    release_level: GA
+  ruby:
+    package_name: Google::Cloud::Monitoring::V3
+    release_level: BETA
+  php:
+    package_name: Google\Cloud\Monitoring\V3
+  nodejs:
+    package_name: monitoring.v3
+    domain_layer_location: google-cloud
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: google.monitoring.v3.AlertPolicyService
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}
+    entity_name: project
+    # C#: Already GA, do not use common resource name for 'project'
+  - name_pattern: projects/{project}/alertPolicies/{alert_policy}
+    entity_name: alert_policy
+  - name_pattern: projects/{project}/alertPolicies/{alert_policy}/conditions/{condition}
+    entity_name: alert_policy_condition
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ListAlertPolicies
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: alert_policies
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: project
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: GetAlertPolicy
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: alert_policy
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: CreateAlertPolicy
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - alert_policy
+    required_fields:
+    - name
+    - alert_policy
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: project
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: DeleteAlertPolicy
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: alert_policy
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: UpdateAlertPolicy
+    flattening:
+      groups:
+      - parameters:
+        - update_mask
+        - alert_policy
+    required_fields:
+    - alert_policy
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      alert_policy.name: alert_policy
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+# The fully qualified name of the API interface.
+- name: google.monitoring.v3.GroupService
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}
+    entity_name: project
+    # C#: Already GA, do not use common resource name for 'project'
+  - name_pattern: projects/{project}/groups/{group}
+    entity_name: group
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ListGroups
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: group
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: project
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: GetGroup
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: group
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: CreateGroup
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - group
+    required_fields:
+    - name
+    - group
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: project
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: UpdateGroup
+    flattening:
+      groups:
+      - parameters:
+        - group
+    required_fields:
+    - group
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      group.name: group
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: DeleteGroup
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: group
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: ListGroupMembers
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: members
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: group
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+# The fully qualified name of the API interface.
+- name: google.monitoring.v3.MetricService
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  smoke_test:
+    method: ListMonitoredResourceDescriptors
+    init_fields:
+    - name%project=$PROJECT_ID
+  collections:
+  - name_pattern: projects/{project}
+    entity_name: project
+    # C#: Already GA, do not use common resource name for 'project'
+  - name_pattern: projects/{project}/metricDescriptors/{metric_descriptor=**}
+    entity_name: metric_descriptor
+  - name_pattern: projects/{project}/monitoredResourceDescriptors/{monitored_resource_descriptor}
+    entity_name: monitored_resource_descriptor
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 30000
+    rpc_timeout_multiplier: 1.3
+    max_rpc_timeout_millis: 90000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ListMonitoredResourceDescriptors
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: resource_descriptors
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: project
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: GetMonitoredResourceDescriptor
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: monitored_resource_descriptor
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: ListMetricDescriptors
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: metric_descriptors
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: project
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: GetMetricDescriptor
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: metric_descriptor
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: CreateMetricDescriptor
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - metric_descriptor
+    required_fields:
+    - name
+    - metric_descriptor
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: project
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: DeleteMetricDescriptor
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: metric_descriptor
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: ListTimeSeries
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - filter
+        - interval
+        - view
+    required_fields:
+    - name
+    - filter
+    - interval
+    - view
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: time_series
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: project
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: CreateTimeSeries
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - time_series
+    required_fields:
+    - name
+    - time_series
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: project
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+# The fully qualified name of the API interface.
+- name: google.monitoring.v3.NotificationChannelService
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}
+    entity_name: project
+  - name_pattern: projects/{project}/notificationChannelDescriptors/{channel_descriptor}
+    entity_name: notification_channel_descriptor
+    # C#: Already GA, do not use common resource name for 'project'
+  - name_pattern: projects/{project}/notificationChannels/{notification_channel}
+    entity_name: notification_channel
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ListNotificationChannelDescriptors
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: channel_descriptors
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: project
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: GetNotificationChannelDescriptor
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: notification_channel_descriptor
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: ListNotificationChannels
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: notification_channels
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: project
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: GetNotificationChannel
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: notification_channel
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: CreateNotificationChannel
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - notification_channel
+    required_fields:
+    - name
+    - notification_channel
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: project
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: UpdateNotificationChannel
+    flattening:
+      groups:
+      - parameters:
+        - update_mask
+        - notification_channel
+    required_fields:
+    - notification_channel
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      notification_channel.name: notification_channel
+    timeout_millis: 60000
+  - name: DeleteNotificationChannel
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - force
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: notification_channel
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: SendNotificationChannelVerificationCode
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: notification_channel
+    timeout_millis: 60000
+  - name: GetNotificationChannelVerificationCode
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: notification_channel
+    timeout_millis: 60000
+  - name: VerifyNotificationChannel
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - code
+    required_fields:
+    - name
+    - code
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: notification_channel
+    timeout_millis: 60000
+# The fully qualified name of the API interface.
+- name: google.monitoring.v3.ServiceMonitoringService
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}
+    entity_name: project
+  - name_pattern: projects/{project}/services/{service}
+    entity_name: service
+  - name_pattern: projects/{project}/services/{service}/serviceLevelObjectives/{service_level_objective}
+    entity_name: service_level_objective
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: CreateService
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - service
+    required_fields:
+    - parent
+    - service
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: GetService
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: service
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: ListServices
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: services
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: UpdateService
+    flattening:
+      groups:
+      - parameters:
+        - service
+    required_fields:
+    - service
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      service.name: service
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: DeleteService
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: service
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: CreateServiceLevelObjective
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - service_level_objective
+    required_fields:
+    - parent
+    - service_level_objective
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: service
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: GetServiceLevelObjective
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: service_level_objective
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: ListServiceLevelObjectives
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: service_level_objectives
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: service
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: UpdateServiceLevelObjective
+    flattening:
+      groups:
+      - parameters:
+        - service_level_objective
+    required_fields:
+    - service_level_objective
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      service_level_objective.name: service_level_objective
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+  - name: DeleteServiceLevelObjective
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: service_level_objective
+    resource_name_treatment: STATIC_TYPES
+    timeout_millis: 60000
+# The fully qualified name of the API interface.
+- name: google.monitoring.v3.UptimeCheckService
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: projects/{project}
+    entity_name: project
+    # C#: Already GA, do not use common resource name for 'project'
+  - name_pattern: projects/{project}/uptimeCheckConfigs/{uptime_check_config}
+    entity_name: uptime_check_config
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: ListUptimeCheckConfigs
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: uptime_check_configs
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 60000
+  - name: GetUptimeCheckConfig
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: uptime_check_config
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+  - name: CreateUptimeCheckConfig
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - uptime_check_config
+    required_fields:
+    - parent
+    - uptime_check_config
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 60000
+  - name: UpdateUptimeCheckConfig
+    flattening:
+      groups:
+      - parameters:
+        - uptime_check_config
+    required_fields:
+    - uptime_check_config
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      uptime_check_config.name: uptime_check_config
+    timeout_millis: 60000
+  - name: DeleteUptimeCheckConfig
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: uptime_check_config
+    timeout_millis: 60000
+    resource_name_treatment: STATIC_TYPES
+  - name: ListUptimeCheckIps
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: uptime_check_ips
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+
+resource_name_generation:
+- message_name: Group
+  field_entity_map:
+    name: group
+    parent_name: group
+- message_name: ListGroupsRequest
+  field_entity_map:
+    name: project
+    children_of_group: group
+    ancestors_of_group: group
+    descendants_of_group: group
+- message_name: GetGroupRequest
+  field_entity_map:
+    name: group
+- message_name: CreateGroupRequest
+  field_entity_map:
+    name: project
+- message_name: DeleteGroupRequest
+  field_entity_map:
+    name: group
+- message_name: ListGroupMembersRequest
+  field_entity_map:
+    name: group
+- message_name: ListMonitoredResourceDescriptorsRequest
+  field_entity_map:
+    name: project
+- message_name: GetMonitoredResourceDescriptorRequest
+  field_entity_map:
+    name: monitored_resource_descriptor
+- message_name: ListMetricDescriptorsRequest
+  field_entity_map:
+    name: project
+- message_name: GetMetricDescriptorRequest
+  field_entity_map:
+    name: metric_descriptor
+- message_name: CreateMetricDescriptorRequest
+  field_entity_map:
+    name: project
+- message_name: DeleteMetricDescriptorRequest
+  field_entity_map:
+    name: metric_descriptor
+- message_name: ListTimeSeriesRequest
+  field_entity_map:
+    name: project
+- message_name: CreateTimeSeriesRequest
+  field_entity_map:
+    name: project
+- message_name: ListAlertPoliciesRequest
+  field_entity_map:
+    name: project
+- message_name: GetAlertPolicyRequest
+  field_entity_map:
+    name: alert_policy
+- message_name: CreateAlertPolicyRequest
+  field_entity_map:
+    name: project
+- message_name: DeleteAlertPolicyRequest
+  field_entity_map:
+    name: alert_policy
+- message_name: GetNotificationChannelDescriptorRequest
+  field_entity_map:
+    name: notification_channel_descriptor
+- message_name: ListNotificationChannelDescriptorsRequest
+  field_entity_map:
+    name: project
+- message_name: ListNotificationChannelsRequest
+  field_entity_map:
+    name: project
+- message_name: GetNotificationChannelRequest
+  field_entity_map:
+    name: notification_channel
+- message_name: CreateNotificationChannelRequest
+  field_entity_map:
+    name: project
+- message_name: DeleteNotificationChannelRequest
+  field_entity_map:
+    name: notification_channel
+- message_name: SendNotificationChannelVerificationCodeRequest
+  field_entity_map:
+    name: notification_channel
+- message_name: GetNotificationChannelVerificationCodeRequest
+  field_entity_map:
+    name: notification_channel
+- message_name: VerifyNotificationChannelRequest
+  field_entity_map:
+    name: notification_channel
+- message_name: GetUptimeCheckConfigRequest
+  field_entity_map:
+    name: uptime_check_config
+- message_name: DeleteUptimeCheckConfigRequest
+  field_entity_map:
+    name: uptime_check_config
+- message_name: Service
+  field_entity_map:
+    name: service
+- message_name: ServiceLevelObjective
+  field_entity_map:
+    name: service_level_objective
+- message_name: CreateServiceRequest
+  field_entity_map:
+    parent: project
+- message_name: GetServiceRequest
+  field_entity_map:
+    name: service
+- message_name: ListServicesRequest
+  field_entity_map:
+    parent: project
+- message_name: UpdateServiceRequest
+  field_entity_map:
+    name: service
+- message_name: DeleteServiceRequest
+  field_entity_map:
+    name: service
+- message_name: CreateServiceLevelObjectiveRequest
+  field_entity_map:
+    parent: service
+- message_name: GetServiceLevelObjectiveRequest
+  field_entity_map:
+    name: service_level_objective
+- message_name: ListServiceLevelObjectivesRequest
+  field_entity_map:
+    parent: service
+- message_name: UpdateServiceLevelObjectiveRequest
+  field_entity_map:
+    name: service_level_objective
+- message_name: DeleteServiceLevelObjectiveRequest
+  field_entity_map:
+    name: service_level_objective
diff --git a/third_party/googleapis/google/monitoring/v3/monitoring_gapic.yaml b/third_party/googleapis/google/monitoring/v3/monitoring_gapic.yaml
index c046ff042..dc3832b1f 100644
--- a/third_party/googleapis/google/monitoring/v3/monitoring_gapic.yaml
+++ b/third_party/googleapis/google/monitoring/v3/monitoring_gapic.yaml
@@ -1,5 +1,6 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
+# The settings of generated code in a specific language.
 language_settings:
   java:
     package_name: com.google.cloud.monitoring.v3
@@ -19,750 +20,71 @@ language_settings:
   nodejs:
     package_name: monitoring.v3
     domain_layer_location: google-cloud
+# A list of API interface configurations.
 interfaces:
+# The fully qualified name of the API interface.
 - name: google.monitoring.v3.AlertPolicyService
-  collections:
-  - name_pattern: projects/{project}
-    entity_name: project
-    # C#: Already GA, do not use common resource name for 'project'
-  - name_pattern: projects/{project}/alertPolicies/{alert_policy}
-    entity_name: alert_policy
-  - name_pattern: projects/{project}/alertPolicies/{alert_policy}/conditions/{condition}
-    entity_name: alert_policy_condition
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
   methods:
-  - name: ListAlertPolicies
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: alert_policies
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: project
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: GetAlertPolicy
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: alert_policy
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: CreateAlertPolicy
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - alert_policy
-    required_fields:
-    - name
-    - alert_policy
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: project
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
   - name: DeleteAlertPolicy
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: alert_policy
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: UpdateAlertPolicy
-    flattening:
-      groups:
-      - parameters:
-        - update_mask
-        - alert_policy
-    required_fields:
-    - alert_policy
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      alert_policy.name: alert_policy
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+
 - name: google.monitoring.v3.GroupService
-  collections:
-  - name_pattern: projects/{project}
-    entity_name: project
-    # C#: Already GA, do not use common resource name for 'project'
-  - name_pattern: projects/{project}/groups/{group}
-    entity_name: group
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
   methods:
-  - name: ListGroups
-    # Removing flattening until we figure out how to deal with oneof
-    required_fields:
-    - name
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: group
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: project
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: GetGroup
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: group
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: CreateGroup
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - group
-    required_fields:
-    - name
-    - group
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: project
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
   - name: UpdateGroup
-    flattening:
-      groups:
-      - parameters:
-        - group
-    required_fields:
-    - group
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      group.name: group
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
   - name: DeleteGroup
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: group
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: ListGroupMembers
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: members
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: group
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+
 - name: google.monitoring.v3.MetricService
   smoke_test:
     method: ListMonitoredResourceDescriptors
     init_fields:
     - name%project=$PROJECT_ID
-  collections:
-  - name_pattern: projects/{project}
-    entity_name: project
-    # C#: Already GA, do not use common resource name for 'project'
-  - name_pattern: projects/{project}/metricDescriptors/{metric_descriptor=**}
-    entity_name: metric_descriptor
-  - name_pattern: projects/{project}/monitoredResourceDescriptors/{monitored_resource_descriptor}
-    entity_name: monitored_resource_descriptor
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 100
     retry_delay_multiplier: 1.3
     max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
+    initial_rpc_timeout_millis: 30000
+    rpc_timeout_multiplier: 1.3
+    max_rpc_timeout_millis: 90000
     total_timeout_millis: 600000
   methods:
   - name: ListMonitoredResourceDescriptors
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: resource_descriptors
-    retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: project
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
   - name: GetMonitoredResourceDescriptor
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: monitored_resource_descriptor
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
   - name: ListMetricDescriptors
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: metric_descriptors
-    retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: project
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
   - name: GetMetricDescriptor
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: metric_descriptor
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
   - name: CreateMetricDescriptor
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - metric_descriptor
-    required_fields:
-    - name
-    - metric_descriptor
-    retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: project
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
   - name: DeleteMetricDescriptor
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: metric_descriptor
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
   - name: ListTimeSeries
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - filter
-        - interval
-        - view
-    required_fields:
-    - name
-    - filter
-    - interval
-    - view
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: time_series
-    retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: project
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
   - name: CreateTimeSeries
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - time_series
-    required_fields:
-    - name
-    - time_series
-    retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: project
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
+
 - name: google.monitoring.v3.NotificationChannelService
-  collections:
-  - name_pattern: projects/{project}
-    entity_name: project
-    # C#: Already GA, do not use common resource name for 'project'
-  - name_pattern: projects/{project}/notificationChannels/{notification_channel}
-    entity_name: notification_channel
-  - name_pattern: projects/{project}/notificationChannelDescriptors/{channel_descriptor}
-    entity_name: notification_channel_descriptor
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
   methods:
-  - name: ListNotificationChannelDescriptors
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: channel_descriptors
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: project
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: GetNotificationChannelDescriptor
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: notification_channel_descriptor
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: ListNotificationChannels
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: notification_channels
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: project
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: GetNotificationChannel
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: notification_channel
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: CreateNotificationChannel
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - notification_channel
-    required_fields:
-    - name
-    - notification_channel
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: project
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: UpdateNotificationChannel
-    flattening:
-      groups:
-      - parameters:
-        - update_mask
-        - notification_channel
-    required_fields:
-    - notification_channel
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      notification_channel.name: notification_channel
-    timeout_millis: 60000
   - name: DeleteNotificationChannel
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - force
-    required_fields:
-    - name
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: notification_channel
-    resource_name_treatment: STATIC_TYPES
-    timeout_millis: 60000
-  - name: SendNotificationChannelVerificationCode
-    surface_treatments:
-    - include_languages:
-      - go
-      - java
-      - csharp
-      - ruby
-      - nodejs
-      - python
-      - php
-      visibility: DISABLED
   - name: GetNotificationChannelVerificationCode
-    surface_treatments:
-    - include_languages:
-      - go
-      - java
-      - csharp
-      - ruby
-      - nodejs
-      - python
-      - php
-      visibility: DISABLED
+    retry_codes_name: idempotent
   - name: VerifyNotificationChannel
-    surface_treatments:
-    - include_languages:
-      - go
-      - java
-      - csharp
-      - ruby
-      - nodejs
-      - python
-      - php
-      visibility: DISABLED
-- name: google.monitoring.v3.UptimeCheckService
-  collections:
-  - name_pattern: projects/{project}
-    entity_name: project
-    # C#: Already GA, do not use common resource name for 'project'
-  - name_pattern: projects/{project}/uptimeCheckConfigs/{uptime_check_config}
-    entity_name: uptime_check_config
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
+    retry_codes_name: idempotent
+
+- name: google.monitoring.v3.ServiceMonitoringService
   methods:
-  - name: ListUptimeCheckConfigs
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: uptime_check_configs
+  - name: DeleteService
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: project
-    timeout_millis: 60000
-  - name: GetUptimeCheckConfig
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
+  - name: DeleteServiceLevelObjective
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: uptime_check_config
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
-  - name: CreateUptimeCheckConfig
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - uptime_check_config
-    required_fields:
-    - parent
-    - uptime_check_config
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: project
-    timeout_millis: 60000
-  - name: UpdateUptimeCheckConfig
-    flattening:
-      groups:
-      - parameters:
-        - uptime_check_config
-    required_fields:
-    - uptime_check_config
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      uptime_check_config.name: uptime_check_config
-    timeout_millis: 60000
+
+- name: google.monitoring.v3.UptimeCheckService
+  methods:
   - name: DeleteUptimeCheckConfig
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: uptime_check_config
-    timeout_millis: 60000
-    resource_name_treatment: STATIC_TYPES
-  - name: ListUptimeCheckIps
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: uptime_check_ips
     retry_codes_name: idempotent
-    retry_params_name: default
-    timeout_millis: 60000
-resource_name_generation:
-- message_name: Group
-  field_entity_map:
-    name: group
-    parent_name: group
-- message_name: ListGroupsRequest
-  field_entity_map:
-    name: project
-    children_of_group: group
-    ancestors_of_group: group
-    descendants_of_group: group
-- message_name: GetGroupRequest
-  field_entity_map:
-    name: group
-- message_name: CreateGroupRequest
-  field_entity_map:
-    name: project
-- message_name: DeleteGroupRequest
-  field_entity_map:
-    name: group
-- message_name: ListGroupMembersRequest
-  field_entity_map:
-    name: group
-- message_name: ListMonitoredResourceDescriptorsRequest
-  field_entity_map:
-    name: project
-- message_name: GetMonitoredResourceDescriptorRequest
-  field_entity_map:
-    name: monitored_resource_descriptor
-- message_name: ListMetricDescriptorsRequest
-  field_entity_map:
-    name: project
-- message_name: GetMetricDescriptorRequest
-  field_entity_map:
-    name: metric_descriptor
-- message_name: CreateMetricDescriptorRequest
-  field_entity_map:
-    name: project
-- message_name: DeleteMetricDescriptorRequest
-  field_entity_map:
-    name: metric_descriptor
-- message_name: ListTimeSeriesRequest
-  field_entity_map:
-    name: project
-- message_name: CreateTimeSeriesRequest
-  field_entity_map:
-    name: project
-- message_name: ListAlertPoliciesRequest
-  field_entity_map:
-    name: project
-- message_name: GetAlertPolicyRequest
-  field_entity_map:
-    name: alert_policy
-- message_name: CreateAlertPolicyRequest
-  field_entity_map:
-    name: project
-- message_name: DeleteAlertPolicyRequest
-  field_entity_map:
-    name: alert_policy
-- message_name: GetNotificationChannelDescriptorRequest
-  field_entity_map:
-    name: notification_channel_descriptor
-- message_name: ListNotificationChannelDescriptorsRequest
-  field_entity_map:
-    name: project
-- message_name: ListNotificationChannelsRequest
-  field_entity_map:
-    name: project
-- message_name: GetNotificationChannelRequest
-  field_entity_map:
-    name: notification_channel
-- message_name: CreateNotificationChannelRequest
-  field_entity_map:
-    name: project
-- message_name: DeleteNotificationChannelRequest
-  field_entity_map:
-    name: notification_channel
-- message_name: SendNotificationChannelVerificationCodeRequest
-  field_entity_map:
-    name: notification_channel
-- message_name: GetNotificationChannelVerificationCodeRequest
-  field_entity_map:
-    name: notification_channel
-- message_name: VerifyNotificationChannelRequest
-  field_entity_map:
-    name: notification_channel
-- message_name: GetUptimeCheckConfigRequest
-  field_entity_map:
-    name: uptime_check_config
-- message_name: DeleteUptimeCheckConfigRequest
-  field_entity_map:
-    name: uptime_check_config
diff --git a/third_party/googleapis/google/monitoring/v3/monitoring_grpc_service_config.json b/third_party/googleapis/google/monitoring/v3/monitoring_grpc_service_config.json
new file mode 100755
index 000000000..8dd8b829e
--- /dev/null
+++ b/third_party/googleapis/google/monitoring/v3/monitoring_grpc_service_config.json
@@ -0,0 +1,304 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.monitoring.v3.AlertPolicyService",
+          "method": "CreateAlertPolicy"
+        },
+        {
+          "service": "google.monitoring.v3.AlertPolicyService",
+          "method": "UpdateAlertPolicy"
+        }
+      ],
+      "timeout": "30s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.monitoring.v3.GroupService",
+          "method": "ListGroups"
+        },
+        {
+          "service": "google.monitoring.v3.GroupService",
+          "method": "GetGroup"
+        },
+        {
+          "service": "google.monitoring.v3.GroupService",
+          "method": "UpdateGroup"
+        },
+        {
+          "service": "google.monitoring.v3.GroupService",
+          "method": "DeleteGroup"
+        },
+        {
+          "service": "google.monitoring.v3.GroupService",
+          "method": "ListGroupMembers"
+        }
+      ],
+      "timeout": "30s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "30s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.monitoring.v3.GroupService",
+          "method": "CreateGroup"
+        }
+      ],
+      "timeout": "30s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.monitoring.v3.MetricService",
+          "method": "CreateMetricDescriptor"
+        },
+        {
+          "service": "google.monitoring.v3.MetricService",
+          "method": "CreateTimeSeries"
+        }
+      ],
+      "timeout": "12s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.monitoring.v3.NotificationChannelService",
+          "method": "ListNotificationChannelDescriptors"
+        },
+        {
+          "service": "google.monitoring.v3.NotificationChannelService",
+          "method": "GetNotificationChannelDescriptor"
+        },
+        {
+          "service": "google.monitoring.v3.NotificationChannelService",
+          "method": "ListNotificationChannels"
+        },
+        {
+          "service": "google.monitoring.v3.NotificationChannelService",
+          "method": "GetNotificationChannel"
+        },
+        {
+          "service": "google.monitoring.v3.NotificationChannelService",
+          "method": "DeleteNotificationChannel"
+        },
+        {
+          "service": "google.monitoring.v3.NotificationChannelService",
+          "method": "GetNotificationChannelVerificationCode"
+        },
+        {
+          "service": "google.monitoring.v3.NotificationChannelService",
+          "method": "VerifyNotificationChannel"
+        }
+      ],
+      "timeout": "30s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "30s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.monitoring.v3.ServiceMonitoringService",
+          "method": "CreateService"
+        },
+        {
+          "service": "google.monitoring.v3.ServiceMonitoringService",
+          "method": "UpdateService"
+        },
+        {
+          "service": "google.monitoring.v3.ServiceMonitoringService",
+          "method": "CreateServiceLevelObjective"
+        },
+        {
+          "service": "google.monitoring.v3.ServiceMonitoringService",
+          "method": "UpdateServiceLevelObjective"
+        }
+      ],
+      "timeout": "30s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.monitoring.v3.ServiceMonitoringService",
+          "method": "GetService"
+        },
+        {
+          "service": "google.monitoring.v3.ServiceMonitoringService",
+          "method": "ListServices"
+        },
+        {
+          "service": "google.monitoring.v3.ServiceMonitoringService",
+          "method": "DeleteService"
+        },
+        {
+          "service": "google.monitoring.v3.ServiceMonitoringService",
+          "method": "GetServiceLevelObjective"
+        },
+        {
+          "service": "google.monitoring.v3.ServiceMonitoringService",
+          "method": "ListServiceLevelObjectives"
+        },
+        {
+          "service": "google.monitoring.v3.ServiceMonitoringService",
+          "method": "DeleteServiceLevelObjective"
+        }
+      ],
+      "timeout": "30s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "30s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.monitoring.v3.UptimeCheckService",
+          "method": "ListUptimeCheckConfigs"
+        },
+        {
+          "service": "google.monitoring.v3.UptimeCheckService",
+          "method": "GetUptimeCheckConfig"
+        },
+        {
+          "service": "google.monitoring.v3.UptimeCheckService",
+          "method": "DeleteUptimeCheckConfig"
+        },
+        {
+          "service": "google.monitoring.v3.UptimeCheckService",
+          "method": "ListUptimeCheckIps"
+        }
+      ],
+      "timeout": "30s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "30s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.monitoring.v3.AlertPolicyService",
+          "method": "ListAlertPolicies"
+        },
+        {
+          "service": "google.monitoring.v3.AlertPolicyService",
+          "method": "GetAlertPolicy"
+        },
+        {
+          "service": "google.monitoring.v3.AlertPolicyService",
+          "method": "DeleteAlertPolicy"
+        }
+      ],
+      "timeout": "30s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "30s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.monitoring.v3.MetricService",
+          "method": "ListMonitoredResourceDescriptors"
+        },
+        {
+          "service": "google.monitoring.v3.MetricService",
+          "method": "GetMonitoredResourceDescriptor"
+        },
+        {
+          "service": "google.monitoring.v3.MetricService",
+          "method": "ListMetricDescriptors"
+        },
+        {
+          "service": "google.monitoring.v3.MetricService",
+          "method": "GetMetricDescriptor"
+        },
+        {
+          "service": "google.monitoring.v3.MetricService",
+          "method": "DeleteMetricDescriptor"
+        },
+        {
+          "service": "google.monitoring.v3.MetricService",
+          "method": "ListTimeSeries"
+        }
+      ],
+      "timeout": "30s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "30s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.monitoring.v3.NotificationChannelService",
+          "method": "CreateNotificationChannel"
+        },
+        {
+          "service": "google.monitoring.v3.NotificationChannelService",
+          "method": "UpdateNotificationChannel"
+        },
+        {
+          "service": "google.monitoring.v3.NotificationChannelService",
+          "method": "SendNotificationChannelVerificationCode"
+        }
+      ],
+      "timeout": "30s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.monitoring.v3.UptimeCheckService",
+          "method": "CreateUptimeCheckConfig"
+        },
+        {
+          "service": "google.monitoring.v3.UptimeCheckService",
+          "method": "UpdateUptimeCheckConfig"
+        }
+      ],
+      "timeout": "30s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/monitoring/v3/mutation_record.proto b/third_party/googleapis/google/monitoring/v3/mutation_record.proto
index c87e2ebcc..b830eb626 100644
--- a/third_party/googleapis/google/monitoring/v3/mutation_record.proto
+++ b/third_party/googleapis/google/monitoring/v3/mutation_record.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -25,6 +24,7 @@ option java_multiple_files = true;
 option java_outer_classname = "MutationRecordProto";
 option java_package = "com.google.monitoring.v3";
 option php_namespace = "Google\\Cloud\\Monitoring\\V3";
+option ruby_package = "Google::Cloud::Monitoring::V3";
 
 // Describes a change made to a configuration.
 message MutationRecord {
diff --git a/third_party/googleapis/google/monitoring/v3/notification.proto b/third_party/googleapis/google/monitoring/v3/notification.proto
index f2812548e..897a14c04 100644
--- a/third_party/googleapis/google/monitoring/v3/notification.proto
+++ b/third_party/googleapis/google/monitoring/v3/notification.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,14 +11,14 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.monitoring.v3;
 
-import "google/api/annotations.proto";
 import "google/api/label.proto";
+import "google/api/launch_stage.proto";
+import "google/api/resource.proto";
 import "google/monitoring/v3/common.proto";
 import "google/protobuf/wrappers.proto";
 
@@ -28,14 +28,23 @@ option java_multiple_files = true;
 option java_outer_classname = "NotificationProto";
 option java_package = "com.google.monitoring.v3";
 option php_namespace = "Google\\Cloud\\Monitoring\\V3";
+option ruby_package = "Google::Cloud::Monitoring::V3";
 
 // A description of a notification channel. The descriptor includes
 // the properties of the channel and the set of labels or fields that
 // must be specified to configure channels of a given type.
 message NotificationChannelDescriptor {
-  // The full REST resource name for this descriptor. The syntax is:
+  option (google.api.resource) = {
+    type: "monitoring.googleapis.com/NotificationChannelDescriptor"
+    pattern: "projects/{project}/notificationChannelDescriptors/{channel_descriptor}"
+    pattern: "organizations/{organization}/notificationChannelDescriptors/{channel_descriptor}"
+    pattern: "folders/{folder}/notificationChannelDescriptors/{channel_descriptor}"
+    pattern: "*"
+  };
+
+  // The full REST resource name for this descriptor. The format is:
   //
-  //     projects/[PROJECT_ID]/notificationChannelDescriptors/[TYPE]
+  //     projects/[PROJECT_ID_OR_NUMBER]/notificationChannelDescriptors/[TYPE]
   //
   // In the above, `[TYPE]` is the value of the `type` field.
   string name = 6;
@@ -61,6 +70,9 @@ message NotificationChannelDescriptor {
   // The tiers that support this notification channel; the project service tier
   // must be one of the supported_tiers.
   repeated ServiceTier supported_tiers = 5 [deprecated = true];
+
+  // The product launch stage for channels of this type.
+  google.api.LaunchStage launch_stage = 7;
 }
 
 // A `NotificationChannel` is a medium through which an alert is
@@ -69,6 +81,14 @@ message NotificationChannelDescriptor {
 // containing sensitive information like authentication tokens or
 // contact info are only partially populated on retrieval.
 message NotificationChannel {
+  option (google.api.resource) = {
+    type: "monitoring.googleapis.com/NotificationChannel"
+    pattern: "projects/{project}/notificationChannels/{notification_channel}"
+    pattern: "organizations/{organization}/notificationChannels/{notification_channel}"
+    pattern: "folders/{folder}/notificationChannels/{notification_channel}"
+    pattern: "*"
+  };
+
   // Indicates whether the channel has been verified or not. It is illegal
   // to specify this field in a
   // [`CreateNotificationChannel`][google.monitoring.v3.NotificationChannelService.CreateNotificationChannel]
@@ -94,14 +114,12 @@ message NotificationChannel {
   }
 
   // The type of the notification channel. This field matches the
-  // value of the
-  // [NotificationChannelDescriptor.type][google.monitoring.v3.NotificationChannelDescriptor.type]
-  // field.
+  // value of the [NotificationChannelDescriptor.type][google.monitoring.v3.NotificationChannelDescriptor.type] field.
   string type = 1;
 
-  // The full REST resource name for this channel. The syntax is:
+  // The full REST resource name for this channel. The format is:
   //
-  //     projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]
+  //     projects/[PROJECT_ID_OR_NUMBER]/notificationChannels/[CHANNEL_ID]
   //
   // The `[CHANNEL_ID]` is automatically assigned by the server on creation.
   string name = 6;
@@ -114,13 +132,13 @@ message NotificationChannel {
 
   // An optional human-readable description of this notification channel. This
   // description may provide additional details, beyond the display
-  // name, for the channel. This may not exceeed 1024 Unicode characters.
+  // name, for the channel. This may not exceed 1024 Unicode characters.
   string description = 4;
 
   // Configuration fields that define the channel and its behavior. The
   // permissible and required labels are specified in the
-  // [NotificationChannelDescriptor.labels][google.monitoring.v3.NotificationChannelDescriptor.labels]
-  // of the `NotificationChannelDescriptor` corresponding to the `type` field.
+  // [NotificationChannelDescriptor.labels][google.monitoring.v3.NotificationChannelDescriptor.labels] of the
+  // `NotificationChannelDescriptor` corresponding to the `type` field.
   map labels = 5;
 
   // User-supplied key/value data that does not need to conform to
diff --git a/third_party/googleapis/google/monitoring/v3/notification_service.proto b/third_party/googleapis/google/monitoring/v3/notification_service.proto
index e178e0cad..20c9a8e9b 100644
--- a/third_party/googleapis/google/monitoring/v3/notification_service.proto
+++ b/third_party/googleapis/google/monitoring/v3/notification_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,15 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.monitoring.v3;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/monitoring/v3/notification.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
@@ -30,35 +32,41 @@ option java_multiple_files = true;
 option java_outer_classname = "NotificationServiceProto";
 option java_package = "com.google.monitoring.v3";
 option php_namespace = "Google\\Cloud\\Monitoring\\V3";
+option ruby_package = "Google::Cloud::Monitoring::V3";
 
 // The Notification Channel API provides access to configuration that
 // controls how messages related to incidents are sent.
 service NotificationChannelService {
+  option (google.api.default_host) = "monitoring.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/monitoring,"
+      "https://www.googleapis.com/auth/monitoring.read";
+
   // Lists the descriptors for supported channel types. The use of descriptors
   // makes it possible for new channel types to be dynamically added.
-  rpc ListNotificationChannelDescriptors(
-      ListNotificationChannelDescriptorsRequest)
-      returns (ListNotificationChannelDescriptorsResponse) {
+  rpc ListNotificationChannelDescriptors(ListNotificationChannelDescriptorsRequest) returns (ListNotificationChannelDescriptorsResponse) {
     option (google.api.http) = {
       get: "/v3/{name=projects/*}/notificationChannelDescriptors"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Gets a single channel descriptor. The descriptor indicates which fields
   // are expected / permitted for a notification channel of the given type.
-  rpc GetNotificationChannelDescriptor(GetNotificationChannelDescriptorRequest)
-      returns (NotificationChannelDescriptor) {
+  rpc GetNotificationChannelDescriptor(GetNotificationChannelDescriptorRequest) returns (NotificationChannelDescriptor) {
     option (google.api.http) = {
       get: "/v3/{name=projects/*/notificationChannelDescriptors/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists the notification channels that have been created for the project.
-  rpc ListNotificationChannels(ListNotificationChannelsRequest)
-      returns (ListNotificationChannelsResponse) {
+  rpc ListNotificationChannels(ListNotificationChannelsRequest) returns (ListNotificationChannelsResponse) {
     option (google.api.http) = {
       get: "/v3/{name=projects/*}/notificationChannels"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Gets a single notification channel. The channel includes the relevant
@@ -66,50 +74,49 @@ service NotificationChannelService {
   // response may truncate or omit passwords, API keys, or other private key
   // matter and thus the response may not be 100% identical to the information
   // that was supplied in the call to the create method.
-  rpc GetNotificationChannel(GetNotificationChannelRequest)
-      returns (NotificationChannel) {
+  rpc GetNotificationChannel(GetNotificationChannelRequest) returns (NotificationChannel) {
     option (google.api.http) = {
       get: "/v3/{name=projects/*/notificationChannels/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates a new notification channel, representing a single notification
   // endpoint such as an email address, SMS number, or PagerDuty service.
-  rpc CreateNotificationChannel(CreateNotificationChannelRequest)
-      returns (NotificationChannel) {
+  rpc CreateNotificationChannel(CreateNotificationChannelRequest) returns (NotificationChannel) {
     option (google.api.http) = {
       post: "/v3/{name=projects/*}/notificationChannels"
       body: "notification_channel"
     };
+    option (google.api.method_signature) = "name,notification_channel";
   }
 
   // Updates a notification channel. Fields not specified in the field mask
   // remain unchanged.
-  rpc UpdateNotificationChannel(UpdateNotificationChannelRequest)
-      returns (NotificationChannel) {
+  rpc UpdateNotificationChannel(UpdateNotificationChannelRequest) returns (NotificationChannel) {
     option (google.api.http) = {
       patch: "/v3/{notification_channel.name=projects/*/notificationChannels/*}"
       body: "notification_channel"
     };
+    option (google.api.method_signature) = "update_mask,notification_channel";
   }
 
   // Deletes a notification channel.
-  rpc DeleteNotificationChannel(DeleteNotificationChannelRequest)
-      returns (google.protobuf.Empty) {
+  rpc DeleteNotificationChannel(DeleteNotificationChannelRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v3/{name=projects/*/notificationChannels/*}"
     };
+    option (google.api.method_signature) = "name,force";
   }
 
   // Causes a verification code to be delivered to the channel. The code
   // can then be supplied in `VerifyNotificationChannel` to verify the channel.
-  rpc SendNotificationChannelVerificationCode(
-      SendNotificationChannelVerificationCodeRequest)
-      returns (google.protobuf.Empty) {
+  rpc SendNotificationChannelVerificationCode(SendNotificationChannelVerificationCodeRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       post: "/v3/{name=projects/*/notificationChannels/*}:sendVerificationCode"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Requests a verification code for an already verified channel that can then
@@ -133,39 +140,43 @@ service NotificationChannelService {
   // have a shorter expiration (e.g. codes such as "G-123456") whereas
   // GetVerificationCode() will typically return a much longer, websafe base
   // 64 encoded string that has a longer expiration time.
-  rpc GetNotificationChannelVerificationCode(
-      GetNotificationChannelVerificationCodeRequest)
-      returns (GetNotificationChannelVerificationCodeResponse) {
+  rpc GetNotificationChannelVerificationCode(GetNotificationChannelVerificationCodeRequest) returns (GetNotificationChannelVerificationCodeResponse) {
     option (google.api.http) = {
       post: "/v3/{name=projects/*/notificationChannels/*}:getVerificationCode"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Verifies a `NotificationChannel` by proving receipt of the code
   // delivered to the channel as a result of calling
   // `SendNotificationChannelVerificationCode`.
-  rpc VerifyNotificationChannel(VerifyNotificationChannelRequest)
-      returns (NotificationChannel) {
+  rpc VerifyNotificationChannel(VerifyNotificationChannelRequest) returns (NotificationChannel) {
     option (google.api.http) = {
       post: "/v3/{name=projects/*/notificationChannels/*}:verify"
       body: "*"
     };
+    option (google.api.method_signature) = "name,code";
   }
 }
 
 // The `ListNotificationChannelDescriptors` request.
 message ListNotificationChannelDescriptorsRequest {
-  // The REST resource name of the parent from which to retrieve
+  // Required. The REST resource name of the parent from which to retrieve
   // the notification channel descriptors. The expected syntax is:
   //
-  //     projects/[PROJECT_ID]
+  //     projects/[PROJECT_ID_OR_NUMBER]
   //
   // Note that this names the parent container in which to look for the
   // descriptors; to retrieve a single descriptor by name, use the
   // [GetNotificationChannelDescriptor][google.monitoring.v3.NotificationChannelService.GetNotificationChannelDescriptor]
   // operation, instead.
-  string name = 4;
+  string name = 4 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "monitoring.googleapis.com/NotificationChannelDescriptor"
+    }
+  ];
 
   // The maximum number of results to return in a single response. If
   // not set to a positive number, a reasonable value will be chosen by the
@@ -193,43 +204,62 @@ message ListNotificationChannelDescriptorsResponse {
 
 // The `GetNotificationChannelDescriptor` response.
 message GetNotificationChannelDescriptorRequest {
-  // The channel type for which to execute the request. The format is
-  // `projects/[PROJECT_ID]/notificationChannelDescriptors/{channel_type}`.
-  string name = 3;
+  // Required. The channel type for which to execute the request. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/notificationChannelDescriptors/[CHANNEL_TYPE]
+  string name = 3 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "monitoring.googleapis.com/NotificationChannelDescriptor"
+    }
+  ];
 }
 
 // The `CreateNotificationChannel` request.
 message CreateNotificationChannelRequest {
-  // The project on which to execute the request. The format is:
+  // Required. The project on which to execute the request. The format is:
   //
-  //     projects/[PROJECT_ID]
+  //     projects/[PROJECT_ID_OR_NUMBER]
   //
-  // Note that this names the container into which the channel will be
-  // written. This does not name the newly created channel. The resulting
+  // This names the container into which the channel will be
+  // written, this does not name the newly created channel. The resulting
   // channel's name will have a normalized version of this field as a prefix,
   // but will add `/notificationChannels/[CHANNEL_ID]` to identify the channel.
-  string name = 3;
-
-  // The definition of the `NotificationChannel` to create.
-  NotificationChannel notification_channel = 2;
+  string name = 3 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "monitoring.googleapis.com/NotificationChannel"
+    }
+  ];
+
+  // Required. The definition of the `NotificationChannel` to create.
+  NotificationChannel notification_channel = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The `ListNotificationChannels` request.
 message ListNotificationChannelsRequest {
-  // The project on which to execute the request. The format is
-  // `projects/[PROJECT_ID]`. That is, this names the container
+  // Required. The project on which to execute the request. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]
+  //
+  // This names the container
   // in which to look for the notification channels; it does not name a
   // specific channel. To query a specific channel by REST resource name, use
   // the
   // [`GetNotificationChannel`][google.monitoring.v3.NotificationChannelService.GetNotificationChannel]
   // operation.
-  string name = 5;
+  string name = 5 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "monitoring.googleapis.com/NotificationChannel"
+    }
+  ];
 
   // If provided, this field specifies the criteria that must be met by
   // notification channels to be included in the response.
   //
   // For more details, see [sorting and
-  // filtering](/monitoring/api/v3/sorting-and-filtering).
+  // filtering](https://cloud.google.com/monitoring/api/v3/sorting-and-filtering).
   string filter = 6;
 
   // A comma-separated list of fields by which to sort the result. Supports
@@ -237,7 +267,7 @@ message ListNotificationChannelsRequest {
   // a minus sign to sort in descending rather than ascending order.
   //
   // For more details, see [sorting and
-  // filtering](/monitoring/api/v3/sorting-and-filtering).
+  // filtering](https://cloud.google.com/monitoring/api/v3/sorting-and-filtering).
   string order_by = 7;
 
   // The maximum number of results to return in a single response. If
@@ -265,9 +295,15 @@ message ListNotificationChannelsResponse {
 
 // The `GetNotificationChannel` request.
 message GetNotificationChannelRequest {
-  // The channel for which to execute the request. The format is
-  // `projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]`.
-  string name = 3;
+  // Required. The channel for which to execute the request. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/notificationChannels/[CHANNEL_ID]
+  string name = 3 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "monitoring.googleapis.com/NotificationChannel"
+    }
+  ];
 }
 
 // The `UpdateNotificationChannel` request.
@@ -275,18 +311,24 @@ message UpdateNotificationChannelRequest {
   // The fields to update.
   google.protobuf.FieldMask update_mask = 2;
 
-  // A description of the changes to be applied to the specified
+  // Required. A description of the changes to be applied to the specified
   // notification channel. The description must provide a definition for
   // fields to be updated; the names of these fields should also be
   // included in the `update_mask`.
-  NotificationChannel notification_channel = 3;
+  NotificationChannel notification_channel = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The `DeleteNotificationChannel` request.
 message DeleteNotificationChannelRequest {
-  // The channel for which to execute the request. The format is
-  // `projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]`.
-  string name = 3;
+  // Required. The channel for which to execute the request. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/notificationChannels/[CHANNEL_ID]
+  string name = 3 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "monitoring.googleapis.com/NotificationChannel"
+    }
+  ];
 
   // If true, the notification channel will be deleted regardless of its
   // use in alert policies (the policies will be updated to remove the
@@ -297,16 +339,26 @@ message DeleteNotificationChannelRequest {
 
 // The `SendNotificationChannelVerificationCode` request.
 message SendNotificationChannelVerificationCodeRequest {
-  // The notification channel to which to send a verification code.
-  string name = 1;
+  // Required. The notification channel to which to send a verification code.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "monitoring.googleapis.com/NotificationChannel"
+    }
+  ];
 }
 
 // The `GetNotificationChannelVerificationCode` request.
 message GetNotificationChannelVerificationCodeRequest {
-  // The notification channel for which a verification code is to be generated
+  // Required. The notification channel for which a verification code is to be generated
   // and retrieved. This must name a channel that is already verified; if
   // the specified channel is not verified, the request will fail.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "monitoring.googleapis.com/NotificationChannel"
+    }
+  ];
 
   // The desired expiration time. If specified, the API will guarantee that
   // the returned code will not be valid after the specified timestamp;
@@ -336,15 +388,20 @@ message GetNotificationChannelVerificationCodeResponse {
 
 // The `VerifyNotificationChannel` request.
 message VerifyNotificationChannelRequest {
-  // The notification channel to verify.
-  string name = 1;
-
-  // The verification code that was delivered to the channel as
+  // Required. The notification channel to verify.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "monitoring.googleapis.com/NotificationChannel"
+    }
+  ];
+
+  // Required. The verification code that was delivered to the channel as
   // a result of invoking the `SendNotificationChannelVerificationCode` API
   // method or that was retrieved from a verified channel via
   // `GetNotificationChannelVerificationCode`. For example, one might have
   // "G-123456" or "TKNZGhhd2EyN3I1MnRnMjRv" (in general, one is only
   // guaranteed that the code is valid UTF-8; one should not
   // make any assumptions regarding the structure or format of the code).
-  string code = 2;
+  string code = 2 [(google.api.field_behavior) = REQUIRED];
 }
diff --git a/third_party/googleapis/google/monitoring/v3/service.proto b/third_party/googleapis/google/monitoring/v3/service.proto
new file mode 100644
index 000000000..a89c007c9
--- /dev/null
+++ b/third_party/googleapis/google/monitoring/v3/service.proto
@@ -0,0 +1,419 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.monitoring.v3;
+
+import "google/api/monitored_resource.proto";
+import "google/api/resource.proto";
+import "google/protobuf/duration.proto";
+import "google/protobuf/timestamp.proto";
+import "google/type/calendar_period.proto";
+
+option csharp_namespace = "Google.Cloud.Monitoring.V3";
+option go_package = "google.golang.org/genproto/googleapis/monitoring/v3;monitoring";
+option java_multiple_files = true;
+option java_outer_classname = "ServiceMonitoringProto";
+option java_package = "com.google.monitoring.v3";
+option php_namespace = "Google\\Cloud\\Monitoring\\V3";
+option ruby_package = "Google::Cloud::Monitoring::V3";
+
+// A `Service` is a discrete, autonomous, and network-accessible unit, designed
+// to solve an individual concern
+// ([Wikipedia](https://en.wikipedia.org/wiki/Service-orientation)). In
+// Cloud Monitoring, a `Service` acts as the root resource under which
+// operational aspects of the service are accessible.
+message Service {
+  option (google.api.resource) = {
+    type: "monitoring.googleapis.com/Service"
+    pattern: "projects/{project}/services/{service}"
+    pattern: "organizations/{organization}/services/{service}"
+    pattern: "folders/{folder}/services/{service}"
+    pattern: "*"
+  };
+
+  // Custom view of service telemetry. Currently a place-holder pending final
+  // design.
+  message Custom {
+
+  }
+
+  // App Engine service. Learn more at https://cloud.google.com/appengine.
+  message AppEngine {
+    // The ID of the App Engine module underlying this service. Corresponds to
+    // the `module_id` resource label in the `gae_app` monitored resource:
+    // https://cloud.google.com/monitoring/api/resources#tag_gae_app
+    string module_id = 1;
+  }
+
+  // Cloud Endpoints service. Learn more at https://cloud.google.com/endpoints.
+  message CloudEndpoints {
+    // The name of the Cloud Endpoints service underlying this service.
+    // Corresponds to the `service` resource label in the `api` monitored
+    // resource: https://cloud.google.com/monitoring/api/resources#tag_api
+    string service = 1;
+  }
+
+  // Istio service scoped to a single Kubernetes cluster. Learn more at
+  // http://istio.io.
+  message ClusterIstio {
+    option deprecated = true;
+
+    // The location of the Kubernetes cluster in which this Istio service is
+    // defined. Corresponds to the `location` resource label in `k8s_cluster`
+    // resources.
+    string location = 1;
+
+    // The name of the Kubernetes cluster in which this Istio service is
+    // defined. Corresponds to the `cluster_name` resource label in
+    // `k8s_cluster` resources.
+    string cluster_name = 2;
+
+    // The namespace of the Istio service underlying this service. Corresponds
+    // to the `destination_service_namespace` metric label in Istio metrics.
+    string service_namespace = 3;
+
+    // The name of the Istio service underlying this service. Corresponds to the
+    // `destination_service_name` metric label in Istio metrics.
+    string service_name = 4;
+  }
+
+  // Istio service scoped to an Istio mesh
+  message MeshIstio {
+    // Identifier for the mesh in which this Istio service is defined.
+    // Corresponds to the `mesh_uid` metric label in Istio metrics.
+    string mesh_uid = 1;
+
+    // The namespace of the Istio service underlying this service. Corresponds
+    // to the `destination_service_namespace` metric label in Istio metrics.
+    string service_namespace = 3;
+
+    // The name of the Istio service underlying this service. Corresponds to the
+    // `destination_service_name` metric label in Istio metrics.
+    string service_name = 4;
+  }
+
+  // Configuration for how to query telemetry on a Service.
+  message Telemetry {
+    // The full name of the resource that defines this service. Formatted as
+    // described in https://cloud.google.com/apis/design/resource_names.
+    string resource_name = 1;
+  }
+
+  // Resource name for this Service. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID]
+  string name = 1;
+
+  // Name used for UI elements listing this Service.
+  string display_name = 2;
+
+  // REQUIRED. Service-identifying atoms specifying the underlying service.
+  oneof identifier {
+    // Custom service type.
+    Custom custom = 6;
+
+    // Type used for App Engine services.
+    AppEngine app_engine = 7;
+
+    // Type used for Cloud Endpoints services.
+    CloudEndpoints cloud_endpoints = 8;
+
+    // Type used for Istio services that live in a Kubernetes cluster.
+    ClusterIstio cluster_istio = 9 [deprecated = true];
+
+    // Type used for Istio services scoped to an Istio mesh.
+    MeshIstio mesh_istio = 10;
+  }
+
+  // Configuration for how to query telemetry on a Service.
+  Telemetry telemetry = 13;
+}
+
+// A Service-Level Objective (SLO) describes a level of desired good service. It
+// consists of a service-level indicator (SLI), a performance goal, and a period
+// over which the objective is to be evaluated against that goal. The SLO can
+// use SLIs defined in a number of different manners. Typical SLOs might include
+// "99% of requests in each rolling week have latency below 200 milliseconds" or
+// "99.5% of requests in each calendar month return successfully."
+message ServiceLevelObjective {
+  option (google.api.resource) = {
+    type: "monitoring.googleapis.com/ServiceLevelObjective"
+    pattern: "projects/{project}/services/{service}/serviceLevelObjectives/{service_level_objective}"
+    pattern: "organizations/{organization}/services/{service}/serviceLevelObjectives/{service_level_objective}"
+    pattern: "folders/{folder}/services/{service}/serviceLevelObjectives/{service_level_objective}"
+    pattern: "*"
+    history: ORIGINALLY_SINGLE_PATTERN
+  };
+
+  // `ServiceLevelObjective.View` determines what form of
+  // `ServiceLevelObjective` is returned from `GetServiceLevelObjective`,
+  // `ListServiceLevelObjectives`, and `ListServiceLevelObjectiveVersions` RPCs.
+  enum View {
+    // Same as FULL.
+    VIEW_UNSPECIFIED = 0;
+
+    // Return the embedded `ServiceLevelIndicator` in the form in which it was
+    // defined. If it was defined using a `BasicSli`, return that `BasicSli`.
+    FULL = 2;
+
+    // For `ServiceLevelIndicator`s using `BasicSli` articulation, instead
+    // return the `ServiceLevelIndicator` with its mode of computation fully
+    // spelled out as a `RequestBasedSli`. For `ServiceLevelIndicator`s using
+    // `RequestBasedSli` or `WindowsBasedSli`, return the
+    // `ServiceLevelIndicator` as it was provided.
+    EXPLICIT = 1;
+  }
+
+  // Resource name for this `ServiceLevelObjective`. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID]/serviceLevelObjectives/[SLO_NAME]
+  string name = 1;
+
+  // Name used for UI elements listing this SLO.
+  string display_name = 11;
+
+  // The definition of good service, used to measure and calculate the quality
+  // of the `Service`'s performance with respect to a single aspect of service
+  // quality.
+  ServiceLevelIndicator service_level_indicator = 3;
+
+  // The fraction of service that must be good in order for this objective to be
+  // met. `0 < goal <= 0.999`.
+  double goal = 4;
+
+  // The time period over which the objective will be evaluated.
+  oneof period {
+    // A rolling time period, semantically "in the past ``".
+    // Must be an integer multiple of 1 day no larger than 30 days.
+    google.protobuf.Duration rolling_period = 5;
+
+    // A calendar period, semantically "since the start of the current
+    // ``". At this time, only `DAY`, `WEEK`, `FORTNIGHT`, and
+    // `MONTH` are supported.
+    google.type.CalendarPeriod calendar_period = 6;
+  }
+}
+
+// A Service-Level Indicator (SLI) describes the "performance" of a service. For
+// some services, the SLI is well-defined. In such cases, the SLI can be
+// described easily by referencing the well-known SLI and providing the needed
+// parameters. Alternatively, a "custom" SLI can be defined with a query to the
+// underlying metric store. An SLI is defined to be `good_service /
+// total_service` over any queried time interval. The value of performance
+// always falls into the range `0 <= performance <= 1`. A custom SLI describes
+// how to compute this ratio, whether this is by dividing values from a pair of
+// time series, cutting a `Distribution` into good and bad counts, or counting
+// time windows in which the service complies with a criterion. For separation
+// of concerns, a single Service-Level Indicator measures performance for only
+// one aspect of service quality, such as fraction of successful queries or
+// fast-enough queries.
+message ServiceLevelIndicator {
+  // Service level indicators can be grouped by whether the "unit" of service
+  // being measured is based on counts of good requests or on counts of good
+  // time windows
+  oneof type {
+    // Basic SLI on a well-known service type.
+    BasicSli basic_sli = 4;
+
+    // Request-based SLIs
+    RequestBasedSli request_based = 1;
+
+    // Windows-based SLIs
+    WindowsBasedSli windows_based = 2;
+  }
+}
+
+// An SLI measuring performance on a well-known service type. Performance will
+// be computed on the basis of pre-defined metrics. The type of the
+// `service_resource` determines the metrics to use and the
+// `service_resource.labels` and `metric_labels` are used to construct a
+// monitoring filter to filter that metric down to just the data relevant to
+// this service.
+message BasicSli {
+  // Future parameters for the availability SLI.
+  message AvailabilityCriteria {
+
+  }
+
+  // Parameters for a latency threshold SLI.
+  message LatencyCriteria {
+    // Good service is defined to be the count of requests made to this service
+    // that return in no more than `threshold`.
+    google.protobuf.Duration threshold = 3;
+  }
+
+  // OPTIONAL: The set of RPCs to which this SLI is relevant. Telemetry from
+  // other methods will not be used to calculate performance for this SLI. If
+  // omitted, this SLI applies to all the Service's methods. For service types
+  // that don't support breaking down by method, setting this field will result
+  // in an error.
+  repeated string method = 7;
+
+  // OPTIONAL: The set of locations to which this SLI is relevant. Telemetry
+  // from other locations will not be used to calculate performance for this
+  // SLI. If omitted, this SLI applies to all locations in which the Service has
+  // activity. For service types that don't support breaking down by location,
+  // setting this field will result in an error.
+  repeated string location = 8;
+
+  // OPTIONAL: The set of API versions to which this SLI is relevant. Telemetry
+  // from other API versions will not be used to calculate performance for this
+  // SLI. If omitted, this SLI applies to all API versions. For service types
+  // that don't support breaking down by version, setting this field will result
+  // in an error.
+  repeated string version = 9;
+
+  // This SLI can be evaluated on the basis of availability or latency.
+  oneof sli_criteria {
+    // Good service is defined to be the count of requests made to this service
+    // that return successfully.
+    AvailabilityCriteria availability = 2;
+
+    // Good service is defined to be the count of requests made to this service
+    // that are fast enough with respect to `latency.threshold`.
+    LatencyCriteria latency = 3;
+  }
+}
+
+// Range of numerical values, inclusive of `min` and exclusive of `max`. If the
+// open range "< range.max" is desired, set `range.min = -infinity`. If the open
+// range ">= range.min" is desired, set `range.max = infinity`.
+message Range {
+  // Range minimum.
+  double min = 1;
+
+  // Range maximum.
+  double max = 2;
+}
+
+// Service Level Indicators for which atomic units of service are counted
+// directly.
+message RequestBasedSli {
+  // The means to compute a ratio of `good_service` to `total_service`.
+  oneof method {
+    // `good_total_ratio` is used when the ratio of `good_service` to
+    // `total_service` is computed from two `TimeSeries`.
+    TimeSeriesRatio good_total_ratio = 1;
+
+    // `distribution_cut` is used when `good_service` is a count of values
+    // aggregated in a `Distribution` that fall into a good range. The
+    // `total_service` is the total count of all values aggregated in the
+    // `Distribution`.
+    DistributionCut distribution_cut = 3;
+  }
+}
+
+// A `TimeSeriesRatio` specifies two `TimeSeries` to use for computing the
+// `good_service / total_service` ratio. The specified `TimeSeries` must have
+// `ValueType = DOUBLE` or `ValueType = INT64` and must have `MetricKind =
+// DELTA` or `MetricKind = CUMULATIVE`. The `TimeSeriesRatio` must specify
+// exactly two of good, bad, and total, and the relationship `good_service +
+// bad_service = total_service` will be assumed.
+message TimeSeriesRatio {
+  // A [monitoring filter](https://cloud.google.com/monitoring/api/v3/filters)
+  // specifying a `TimeSeries` quantifying good service provided. Must have
+  // `ValueType = DOUBLE` or `ValueType = INT64` and must have `MetricKind =
+  // DELTA` or `MetricKind = CUMULATIVE`.
+  string good_service_filter = 4;
+
+  // A [monitoring filter](https://cloud.google.com/monitoring/api/v3/filters)
+  // specifying a `TimeSeries` quantifying bad service, either demanded service
+  // that was not provided or demanded service that was of inadequate quality.
+  // Must have `ValueType = DOUBLE` or `ValueType = INT64` and must have
+  // `MetricKind = DELTA` or `MetricKind = CUMULATIVE`.
+  string bad_service_filter = 5;
+
+  // A [monitoring filter](https://cloud.google.com/monitoring/api/v3/filters)
+  // specifying a `TimeSeries` quantifying total demanded service. Must have
+  // `ValueType = DOUBLE` or `ValueType = INT64` and must have `MetricKind =
+  // DELTA` or `MetricKind = CUMULATIVE`.
+  string total_service_filter = 6;
+}
+
+// A `DistributionCut` defines a `TimeSeries` and thresholds used for measuring
+// good service and total service. The `TimeSeries` must have `ValueType =
+// DISTRIBUTION` and `MetricKind = DELTA` or `MetricKind = CUMULATIVE`. The
+// computed `good_service` will be the count of values x in the `Distribution`
+// such that `range.min <= x < range.max`.
+message DistributionCut {
+  // A [monitoring filter](https://cloud.google.com/monitoring/api/v3/filters)
+  // specifying a `TimeSeries` aggregating values. Must have `ValueType =
+  // DISTRIBUTION` and `MetricKind = DELTA` or `MetricKind = CUMULATIVE`.
+  string distribution_filter = 4;
+
+  // Range of values considered "good." For a one-sided range, set one bound to
+  // an infinite value.
+  Range range = 5;
+}
+
+// A `WindowsBasedSli` defines `good_service` as the count of time windows for
+// which the provided service was of good quality. Criteria for determining
+// if service was good are embedded in the `window_criterion`.
+message WindowsBasedSli {
+  // A `PerformanceThreshold` is used when each window is good when that window
+  // has a sufficiently high `performance`.
+  message PerformanceThreshold {
+    // The means, either a request-based SLI or a basic SLI, by which to compute
+    // performance over a window.
+    oneof type {
+      // `RequestBasedSli` to evaluate to judge window quality.
+      RequestBasedSli performance = 1;
+
+      // `BasicSli` to evaluate to judge window quality.
+      BasicSli basic_sli_performance = 3;
+    }
+
+    // If window `performance >= threshold`, the window is counted as good.
+    double threshold = 2;
+  }
+
+  // A `MetricRange` is used when each window is good when the value x of a
+  // single `TimeSeries` satisfies `range.min <= x < range.max`. The provided
+  // `TimeSeries` must have `ValueType = INT64` or `ValueType = DOUBLE` and
+  // `MetricKind = GAUGE`.
+  message MetricRange {
+    // A [monitoring filter](https://cloud.google.com/monitoring/api/v3/filters)
+    // specifying the `TimeSeries` to use for evaluating window quality.
+    string time_series = 1;
+
+    // Range of values considered "good." For a one-sided range, set one bound
+    // to an infinite value.
+    Range range = 4;
+  }
+
+  // The criterion to use for evaluating window goodness.
+  oneof window_criterion {
+    // A [monitoring filter](https://cloud.google.com/monitoring/api/v3/filters)
+    // specifying a `TimeSeries` with `ValueType = BOOL`. The window is good if
+    // any `true` values appear in the window.
+    string good_bad_metric_filter = 5;
+
+    // A window is good if its `performance` is high enough.
+    PerformanceThreshold good_total_ratio_threshold = 2;
+
+    // A window is good if the metric's value is in a good range, averaged
+    // across returned streams.
+    MetricRange metric_mean_in_range = 6;
+
+    // A window is good if the metric's value is in a good range, summed across
+    // returned streams.
+    MetricRange metric_sum_in_range = 7;
+  }
+
+  // Duration over which window quality is evaluated. Must be an integer
+  // fraction of a day and at least `60s`.
+  google.protobuf.Duration window_period = 4;
+}
diff --git a/third_party/googleapis/google/monitoring/v3/service_service.proto b/third_party/googleapis/google/monitoring/v3/service_service.proto
new file mode 100644
index 000000000..cd5f7db67
--- /dev/null
+++ b/third_party/googleapis/google/monitoring/v3/service_service.proto
@@ -0,0 +1,346 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.monitoring.v3;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/monitoring/v3/service.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+
+option csharp_namespace = "Google.Cloud.Monitoring.V3";
+option go_package = "google.golang.org/genproto/googleapis/monitoring/v3;monitoring";
+option java_multiple_files = true;
+option java_outer_classname = "ServiceMonitoringServiceProto";
+option java_package = "com.google.monitoring.v3";
+option php_namespace = "Google\\Cloud\\Monitoring\\V3";
+option ruby_package = "Google::Cloud::Monitoring::V3";
+
+// The Cloud Monitoring Service-Oriented Monitoring API has endpoints for
+// managing and querying aspects of a workspace's services. These include the
+// `Service`'s monitored resources, its Service-Level Objectives, and a taxonomy
+// of categorized Health Metrics.
+service ServiceMonitoringService {
+  option (google.api.default_host) = "monitoring.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/monitoring,"
+      "https://www.googleapis.com/auth/monitoring.read";
+
+  // Create a `Service`.
+  rpc CreateService(CreateServiceRequest) returns (Service) {
+    option (google.api.http) = {
+      post: "/v3/{parent=*/*}/services"
+      body: "service"
+    };
+    option (google.api.method_signature) = "parent,service";
+  }
+
+  // Get the named `Service`.
+  rpc GetService(GetServiceRequest) returns (Service) {
+    option (google.api.http) = {
+      get: "/v3/{name=*/*/services/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // List `Service`s for this workspace.
+  rpc ListServices(ListServicesRequest) returns (ListServicesResponse) {
+    option (google.api.http) = {
+      get: "/v3/{parent=*/*}/services"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Update this `Service`.
+  rpc UpdateService(UpdateServiceRequest) returns (Service) {
+    option (google.api.http) = {
+      patch: "/v3/{service.name=*/*/services/*}"
+      body: "service"
+    };
+    option (google.api.method_signature) = "service";
+  }
+
+  // Soft delete this `Service`.
+  rpc DeleteService(DeleteServiceRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v3/{name=*/*/services/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Create a `ServiceLevelObjective` for the given `Service`.
+  rpc CreateServiceLevelObjective(CreateServiceLevelObjectiveRequest) returns (ServiceLevelObjective) {
+    option (google.api.http) = {
+      post: "/v3/{parent=*/*/services/*}/serviceLevelObjectives"
+      body: "service_level_objective"
+    };
+    option (google.api.method_signature) = "parent,service_level_objective";
+  }
+
+  // Get a `ServiceLevelObjective` by name.
+  rpc GetServiceLevelObjective(GetServiceLevelObjectiveRequest) returns (ServiceLevelObjective) {
+    option (google.api.http) = {
+      get: "/v3/{name=*/*/services/*/serviceLevelObjectives/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // List the `ServiceLevelObjective`s for the given `Service`.
+  rpc ListServiceLevelObjectives(ListServiceLevelObjectivesRequest) returns (ListServiceLevelObjectivesResponse) {
+    option (google.api.http) = {
+      get: "/v3/{parent=*/*/services/*}/serviceLevelObjectives"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Update the given `ServiceLevelObjective`.
+  rpc UpdateServiceLevelObjective(UpdateServiceLevelObjectiveRequest) returns (ServiceLevelObjective) {
+    option (google.api.http) = {
+      patch: "/v3/{service_level_objective.name=*/*/services/*/serviceLevelObjectives/*}"
+      body: "service_level_objective"
+    };
+    option (google.api.method_signature) = "service_level_objective";
+  }
+
+  // Delete the given `ServiceLevelObjective`.
+  rpc DeleteServiceLevelObjective(DeleteServiceLevelObjectiveRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v3/{name=*/*/services/*/serviceLevelObjectives/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+}
+
+// The `CreateService` request.
+message CreateServiceRequest {
+  // Required. Resource name of the parent workspace. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "monitoring.googleapis.com/Service"
+    }
+  ];
+
+  // Optional. The Service id to use for this Service. If omitted, an id will be
+  // generated instead. Must match the pattern `[a-z0-9\-]+`
+  string service_id = 3;
+
+  // Required. The `Service` to create.
+  Service service = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The `GetService` request.
+message GetServiceRequest {
+  // Required. Resource name of the `Service`. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID]
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "monitoring.googleapis.com/Service"
+    }
+  ];
+}
+
+// The `ListServices` request.
+message ListServicesRequest {
+  // Required. Resource name of the parent containing the listed services, either a
+  // project or a Monitoring Workspace. The formats are:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]
+  //     workspaces/[HOST_PROJECT_ID_OR_NUMBER]
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "monitoring.googleapis.com/Service"
+    }
+  ];
+
+  // A filter specifying what `Service`s to return. The filter currently
+  // supports the following fields:
+  //
+  //     - `identifier_case`
+  //     - `app_engine.module_id`
+  //     - `cloud_endpoints.service`
+  //     - `cluster_istio.location`
+  //     - `cluster_istio.cluster_name`
+  //     - `cluster_istio.service_namespace`
+  //     - `cluster_istio.service_name`
+  //
+  // `identifier_case` refers to which option in the identifier oneof is
+  // populated. For example, the filter `identifier_case = "CUSTOM"` would match
+  // all services with a value for the `custom` field. Valid options are
+  // "CUSTOM", "APP_ENGINE", "CLOUD_ENDPOINTS", and "CLUSTER_ISTIO".
+  string filter = 2;
+
+  // A non-negative number that is the maximum number of results to return.
+  // When 0, use default page size.
+  int32 page_size = 3;
+
+  // If this field is not empty then it must contain the `nextPageToken` value
+  // returned by a previous call to this method.  Using this field causes the
+  // method to return additional results from the previous method call.
+  string page_token = 4;
+}
+
+// The `ListServices` response.
+message ListServicesResponse {
+  // The `Service`s matching the specified filter.
+  repeated Service services = 1;
+
+  // If there are more results than have been returned, then this field is set
+  // to a non-empty value.  To see the additional results,
+  // use that value as `page_token` in the next call to this method.
+  string next_page_token = 2;
+}
+
+// The `UpdateService` request.
+message UpdateServiceRequest {
+  // Required. The `Service` to draw updates from.
+  // The given `name` specifies the resource to update.
+  Service service = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // A set of field paths defining which fields to use for the update.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// The `DeleteService` request.
+message DeleteServiceRequest {
+  // Required. Resource name of the `Service` to delete. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID]
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "monitoring.googleapis.com/Service"
+    }
+  ];
+}
+
+// The `CreateServiceLevelObjective` request.
+message CreateServiceLevelObjectiveRequest {
+  // Required. Resource name of the parent `Service`. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID]
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "monitoring.googleapis.com/Service"
+    }
+  ];
+
+  // Optional. The ServiceLevelObjective id to use for this
+  // ServiceLevelObjective. If omitted, an id will be generated instead. Must
+  // match the pattern `[a-z0-9\-]+`
+  string service_level_objective_id = 3;
+
+  // Required. The `ServiceLevelObjective` to create.
+  // The provided `name` will be respected if no `ServiceLevelObjective` exists
+  // with this name.
+  ServiceLevelObjective service_level_objective = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The `GetServiceLevelObjective` request.
+message GetServiceLevelObjectiveRequest {
+  // Required. Resource name of the `ServiceLevelObjective` to get. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID]/serviceLevelObjectives/[SLO_NAME]
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "monitoring.googleapis.com/ServiceLevelObjective"
+    }
+  ];
+
+  // View of the `ServiceLevelObjective` to return. If `DEFAULT`, return the
+  // `ServiceLevelObjective` as originally defined. If `EXPLICIT` and the
+  // `ServiceLevelObjective` is defined in terms of a `BasicSli`, replace the
+  // `BasicSli` with a `RequestBasedSli` spelling out how the SLI is computed.
+  ServiceLevelObjective.View view = 2;
+}
+
+// The `ListServiceLevelObjectives` request.
+message ListServiceLevelObjectivesRequest {
+  // Required. Resource name of the parent containing the listed SLOs, either a
+  // project or a Monitoring Workspace. The formats are:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID]
+  //     workspaces/[HOST_PROJECT_ID_OR_NUMBER]/services/-
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "monitoring.googleapis.com/Service"
+    }
+  ];
+
+  // A filter specifying what `ServiceLevelObjective`s to return.
+  string filter = 2;
+
+  // A non-negative number that is the maximum number of results to return.
+  // When 0, use default page size.
+  int32 page_size = 3;
+
+  // If this field is not empty then it must contain the `nextPageToken` value
+  // returned by a previous call to this method.  Using this field causes the
+  // method to return additional results from the previous method call.
+  string page_token = 4;
+
+  // View of the `ServiceLevelObjective`s to return. If `DEFAULT`, return each
+  // `ServiceLevelObjective` as originally defined. If `EXPLICIT` and the
+  // `ServiceLevelObjective` is defined in terms of a `BasicSli`, replace the
+  // `BasicSli` with a `RequestBasedSli` spelling out how the SLI is computed.
+  ServiceLevelObjective.View view = 5;
+}
+
+// The `ListServiceLevelObjectives` response.
+message ListServiceLevelObjectivesResponse {
+  // The `ServiceLevelObjective`s matching the specified filter.
+  repeated ServiceLevelObjective service_level_objectives = 1;
+
+  // If there are more results than have been returned, then this field is set
+  // to a non-empty value.  To see the additional results,
+  // use that value as `page_token` in the next call to this method.
+  string next_page_token = 2;
+}
+
+// The `UpdateServiceLevelObjective` request.
+message UpdateServiceLevelObjectiveRequest {
+  // Required. The `ServiceLevelObjective` to draw updates from.
+  // The given `name` specifies the resource to update.
+  ServiceLevelObjective service_level_objective = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // A set of field paths defining which fields to use for the update.
+  google.protobuf.FieldMask update_mask = 2;
+}
+
+// The `DeleteServiceLevelObjective` request.
+message DeleteServiceLevelObjectiveRequest {
+  // Required. Resource name of the `ServiceLevelObjective` to delete. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/services/[SERVICE_ID]/serviceLevelObjectives/[SLO_NAME]
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "monitoring.googleapis.com/ServiceLevelObjective"
+    }
+  ];
+}
diff --git a/third_party/googleapis/google/monitoring/v3/span_context.proto b/third_party/googleapis/google/monitoring/v3/span_context.proto
index f7977c288..72cce35f1 100644
--- a/third_party/googleapis/google/monitoring/v3/span_context.proto
+++ b/third_party/googleapis/google/monitoring/v3/span_context.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -23,21 +22,24 @@ option java_multiple_files = true;
 option java_outer_classname = "SpanContextProto";
 option java_package = "com.google.monitoring.v3";
 option php_namespace = "Google\\Cloud\\Monitoring\\V3";
+option ruby_package = "Google::Cloud::Monitoring::V3";
 
-// The context of a span, attached to google.api.Distribution.Exemplars
-// in google.api.Distribution values during aggregation.
+// The context of a span, attached to
+// [Exemplars][google.api.Distribution.Exemplars]
+// in [Distribution][google.api.Distribution] values during aggregation.
 //
 // It contains the name of a span with format:
-//     projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]
+//
+//     projects/[PROJECT_ID_OR_NUMBER]/traces/[TRACE_ID]/spans/[SPAN_ID]
 message SpanContext {
-  // The resource name of the span in the following format:
+  // The resource name of the span. The format is:
   //
-  //     projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]
+  //     projects/[PROJECT_ID_OR_NUMBER]/traces/[TRACE_ID]/spans/[SPAN_ID]
   //
-  // [TRACE_ID] is a unique identifier for a trace within a project;
+  // `[TRACE_ID]` is a unique identifier for a trace within a project;
   // it is a 32-character hexadecimal encoding of a 16-byte array.
   //
-  // [SPAN_ID] is a unique identifier for a span within a trace; it
+  // `[SPAN_ID]` is a unique identifier for a span within a trace; it
   // is a 16-character hexadecimal encoding of an 8-byte array.
   string span_name = 1;
 }
diff --git a/third_party/googleapis/google/monitoring/v3/uptime.proto b/third_party/googleapis/google/monitoring/v3/uptime.proto
index 2850301ac..54a9b11e1 100644
--- a/third_party/googleapis/google/monitoring/v3/uptime.proto
+++ b/third_party/googleapis/google/monitoring/v3/uptime.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,13 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.monitoring.v3;
 
 import "google/api/monitored_resource.proto";
+import "google/api/resource.proto";
 import "google/protobuf/duration.proto";
 
 option csharp_namespace = "Google.Cloud.Monitoring.V3";
@@ -26,17 +26,41 @@ option java_multiple_files = true;
 option java_outer_classname = "UptimeProto";
 option java_package = "com.google.monitoring.v3";
 option php_namespace = "Google\\Cloud\\Monitoring\\V3";
+option ruby_package = "Google::Cloud::Monitoring::V3";
 
-// An internal checker allows uptime checks to run on private/internal GCP
+// An internal checker allows Uptime checks to run on private/internal GCP
 // resources.
 message InternalChecker {
+  option deprecated = true;
+
+  // Operational states for an internal checker.
+  enum State {
+    // An internal checker should never be in the unspecified state.
+    UNSPECIFIED = 0;
+
+    // The checker is being created, provisioned, and configured. A checker in
+    // this state can be returned by `ListInternalCheckers` or
+    // `GetInternalChecker`, as well as by examining the [long running
+    // Operation](https://cloud.google.com/apis/design/design_patterns#long_running_operations)
+    // that created it.
+    CREATING = 1;
+
+    // The checker is running and available for use. A checker in this state
+    // can be returned by `ListInternalCheckers` or `GetInternalChecker` as
+    // well as by examining the [long running
+    // Operation](https://cloud.google.com/apis/design/design_patterns#long_running_operations)
+    // that created it.
+    // If a checker is being torn down, it is neither visible nor usable, so
+    // there is no "deleting" or "down" state.
+    RUNNING = 2;
+  }
+
   // A unique resource name for this InternalChecker. The format is:
   //
+  //     projects/[PROJECT_ID_OR_NUMBER]/internalCheckers/[INTERNAL_CHECKER_ID]
   //
-  //   `projects/[PROJECT_ID]/internalCheckers/[INTERNAL_CHECKER_ID]`.
-  //
-  // PROJECT_ID is the stackdriver workspace project for the
-  // uptime check config associated with the internal checker.
+  // `[PROJECT_ID_OR_NUMBER]` is the Stackdriver Workspace project for the
+  // Uptime check config associated with the internal checker.
   string name = 1;
 
   // The checker's human-readable name. The display name
@@ -48,53 +72,118 @@ message InternalChecker {
   // internal resource lives (ex: "default").
   string network = 3;
 
-  // The GCP zone the uptime check should egress from. Only respected for
-  // internal uptime checks, where internal_network is specified.
+  // The GCP zone the Uptime check should egress from. Only respected for
+  // internal Uptime checks, where internal_network is specified.
   string gcp_zone = 4;
 
-  // The GCP project_id where the internal checker lives. Not necessary
-  // the same as the workspace project.
+  // The GCP project ID where the internal checker lives. Not necessary
+  // the same as the Workspace project.
   string peer_project_id = 6;
+
+  // The current operational state of the internal checker.
+  State state = 7;
+}
+
+// The regions from which an Uptime check can be run.
+enum UptimeCheckRegion {
+  // Default value if no region is specified. Will result in Uptime checks
+  // running from all regions.
+  REGION_UNSPECIFIED = 0;
+
+  // Allows checks to run from locations within the United States of America.
+  USA = 1;
+
+  // Allows checks to run from locations within the continent of Europe.
+  EUROPE = 2;
+
+  // Allows checks to run from locations within the continent of South
+  // America.
+  SOUTH_AMERICA = 3;
+
+  // Allows checks to run from locations within the Asia Pacific area (ex:
+  // Singapore).
+  ASIA_PACIFIC = 4;
 }
 
 // This message configures which resources and services to monitor for
 // availability.
 message UptimeCheckConfig {
+  option (google.api.resource) = {
+    type: "monitoring.googleapis.com/UptimeCheckConfig"
+    pattern: "projects/{project}/uptimeCheckConfigs/{uptime_check_config}"
+    pattern: "organizations/{organization}/uptimeCheckConfigs/{uptime_check_config}"
+    pattern: "folders/{folder}/uptimeCheckConfigs/{uptime_check_config}"
+    pattern: "*"
+  };
+
   // The resource submessage for group checks. It can be used instead of a
   // monitored resource, when multiple resources are being monitored.
   message ResourceGroup {
-    // The group of resources being monitored. Should be only the
-    // group_id, not projects//groups/.
+    // The group of resources being monitored. Should be only the `[GROUP_ID]`,
+    // and not the full-path
+    // `projects/[PROJECT_ID_OR_NUMBER]/groups/[GROUP_ID]`.
     string group_id = 1;
 
     // The resource type of the group members.
     GroupResourceType resource_type = 2;
   }
 
-  // Information involved in an HTTP/HTTPS uptime check request.
+  // Information involved in an HTTP/HTTPS Uptime check request.
   message HttpCheck {
-    // A type of authentication to perform against the specified resource or URL
-    // that uses username and password.
-    // Currently, only Basic authentication is supported in Uptime Monitoring.
+    // The authentication parameters to provide to the specified resource or
+    // URL that requires a username and password. Currently, only
+    // [Basic HTTP authentication](https://tools.ietf.org/html/rfc7617) is
+    // supported in Uptime checks.
     message BasicAuthentication {
-      // The username to authenticate.
+      // The username to use when authenticating with the HTTP server.
       string username = 1;
 
-      // The password to authenticate.
+      // The password to use when authenticating with the HTTP server.
       string password = 2;
     }
 
-    // If true, use HTTPS instead of HTTP to run the check.
+    // The HTTP request method options.
+    enum RequestMethod {
+      // No request method specified.
+      METHOD_UNSPECIFIED = 0;
+
+      // GET request.
+      GET = 1;
+
+      // POST request.
+      POST = 2;
+    }
+
+    // Header options corresponding to the Content-Type of the body in HTTP
+    // requests. Note that a `Content-Type` header cannot be present in the
+    // `headers` field if this field is specified.
+    enum ContentType {
+      // No content type specified. If the request method is POST, an
+      // unspecified content type results in a check creation rejection.
+      TYPE_UNSPECIFIED = 0;
+
+      // `body` is in URL-encoded form. Equivalent to setting the `Content-Type`
+      // to `application/x-www-form-urlencoded` in the HTTP request.
+      URL_ENCODED = 1;
+    }
+
+    // The HTTP request method to use for the check.
+    RequestMethod request_method = 8;
+
+    // If `true`, use HTTPS instead of HTTP to run the check.
     bool use_ssl = 1;
 
-    // The path to the page to run the check against. Will be combined with the
-    // host (specified within the MonitoredResource) and port to construct the
-    // full URL. Optional (defaults to "/").
+    // Optional (defaults to "/"). The path to the page against which to run
+    // the check. Will be combined with the `host` (specified within the
+    // `monitored_resource`) and `port` to construct the full URL. If the
+    // provided path does not begin with "/", a "/" will be prepended
+    // automatically.
     string path = 2;
 
-    // The port to the page to run the check against. Will be combined with host
-    // (specified within the MonitoredResource) and path to construct the full
-    // URL. Optional (defaults to 80 without SSL, or 443 with SSL).
+    // Optional (defaults to 80 when `use_ssl` is `false`, and 443 when
+    // `use_ssl` is `true`). The TCP port on the HTTP server against which to
+    // run the check. Will be combined with host (specified within the
+    // `monitored_resource`) and `path` to construct the full URL.
     int32 port = 3;
 
     // The authentication information. Optional when creating an HTTP check;
@@ -105,11 +194,11 @@ message UptimeCheckConfig {
     // Encryption should be specified for any headers related to authentication
     // that you do not wish to be seen when retrieving the configuration. The
     // server will be responsible for encrypting the headers.
-    // On Get/List calls, if mask_headers is set to True then the headers
-    // will be obscured with ******.
+    // On Get/List calls, if `mask_headers` is set to `true` then the headers
+    // will be obscured with `******.`
     bool mask_headers = 5;
 
-    // The list of headers to send as part of the uptime check request.
+    // The list of headers to send as part of the Uptime check request.
     // If two headers have the same key and different values, they should
     // be entered as a single header, with the value being a comma-separated
     // list of all the desired values as described at
@@ -118,34 +207,84 @@ message UptimeCheckConfig {
     // cause the first to be overwritten by the second.
     // The maximum number of headers allowed is 100.
     map headers = 6;
+
+    // The content type to use for the check.
+    ContentType content_type = 9;
+
+    // Boolean specifying whether to include SSL certificate validation as a
+    // part of the Uptime check. Only applies to checks where
+    // `monitored_resource` is set to `uptime_url`. If `use_ssl` is `false`,
+    // setting `validate_ssl` to `true` has no effect.
+    bool validate_ssl = 7;
+
+    // The request body associated with the HTTP request. If `content_type` is
+    // `URL_ENCODED`, the body passed in must be URL-encoded. Users can provide
+    // a `Content-Length` header via the `headers` field or the API will do
+    // so. The maximum byte size is 1 megabyte. Note: As with all `bytes` fields
+    // JSON representations are base64 encoded.
+    bytes body = 10;
   }
 
-  // Information required for a TCP uptime check request.
+  // Information required for a TCP Uptime check request.
   message TcpCheck {
-    // The port to the page to run the check against. Will be combined with host
-    // (specified within the MonitoredResource) to construct the full URL.
-    // Required.
+    // The TCP port on the server against which to run the check. Will be
+    // combined with host (specified within the `monitored_resource`) to
+    // construct the full URL. Required.
     int32 port = 1;
   }
 
-  // Used to perform string matching. It allows substring and regular
-  // expressions, together with their negations.
+  // Optional. Used to perform content matching. This allows matching based on
+  // substrings and regular expressions, together with their negations. Only the
+  // first 4 MB of an HTTP or HTTPS check's response (and the first
+  // 1 MB of a TCP check's response) are examined for purposes of content
+  // matching.
   message ContentMatcher {
-    // String or regex content to match (max 1024 bytes)
+    // Options to perform content matching.
+    enum ContentMatcherOption {
+      // No content matcher type specified (maintained for backward
+      // compatibility, but deprecated for future use).
+      // Treated as `CONTAINS_STRING`.
+      CONTENT_MATCHER_OPTION_UNSPECIFIED = 0;
+
+      // Selects substring matching. The match succeeds if the output contains
+      // the `content` string.  This is the default value for checks without
+      // a `matcher` option, or where the value of `matcher` is
+      // `CONTENT_MATCHER_OPTION_UNSPECIFIED`.
+      CONTAINS_STRING = 1;
+
+      // Selects negation of substring matching. The match succeeds if the
+      // output does _NOT_ contain the `content` string.
+      NOT_CONTAINS_STRING = 2;
+
+      // Selects regular-expression matching. The match succeeds of the output
+      // matches the regular expression specified in the `content` string.
+      MATCHES_REGEX = 3;
+
+      // Selects negation of regular-expression matching. The match succeeds if
+      // the output does _NOT_ match the regular expression specified in the
+      // `content` string.
+      NOT_MATCHES_REGEX = 4;
+    }
+
+    // String or regex content to match. Maximum 1024 bytes. An empty `content`
+    // string indicates no content matching is to be performed.
     string content = 1;
+
+    // The type of content matcher that will be applied to the server output,
+    // compared to the `content` string when the check is run.
+    ContentMatcherOption matcher = 2;
   }
 
-  // A unique resource name for this UptimeCheckConfig. The format is:
-  //
+  // A unique resource name for this Uptime check configuration. The format is:
   //
-  //   `projects/[PROJECT_ID]/uptimeCheckConfigs/[UPTIME_CHECK_ID]`.
+  //      projects/[PROJECT_ID_OR_NUMBER]/uptimeCheckConfigs/[UPTIME_CHECK_ID]
   //
-  // This field should be omitted when creating the uptime check configuration;
+  // This field should be omitted when creating the Uptime check configuration;
   // on create, the resource name is assigned by the server and included in the
   // response.
   string name = 1;
 
-  // A human-friendly name for the uptime check configuration. The display name
+  // A human-friendly name for the Uptime check configuration. The display name
   // should be unique within a Stackdriver Workspace in order to make it easier
   // to identify; however, uniqueness is not enforced. Required.
   string display_name = 2;
@@ -155,19 +294,19 @@ message UptimeCheckConfig {
     // The [monitored
     // resource](https://cloud.google.com/monitoring/api/resources) associated
     // with the configuration.
-    // The following monitored resource types are supported for uptime checks:
-    //   uptime_url
-    //   gce_instance
-    //   gae_app
-    //   aws_ec2_instance
-    //   aws_elb_load_balancer
+    // The following monitored resource types are supported for Uptime checks:
+    //   `uptime_url`,
+    //   `gce_instance`,
+    //   `gae_app`,
+    //   `aws_ec2_instance`,
+    //   `aws_elb_load_balancer`
     google.api.MonitoredResource monitored_resource = 3;
 
     // The group resource associated with the configuration.
     ResourceGroup resource_group = 4;
   }
 
-  // The type of uptime check request.
+  // The type of Uptime check request.
   oneof check_request_type {
     // Contains information needed to make an HTTP or HTTPS check.
     HttpCheck http_check = 5;
@@ -176,41 +315,41 @@ message UptimeCheckConfig {
     TcpCheck tcp_check = 6;
   }
 
-  // How often, in seconds, the uptime check is performed.
+  // How often, in seconds, the Uptime check is performed.
   // Currently, the only supported values are `60s` (1 minute), `300s`
   // (5 minutes), `600s` (10 minutes), and `900s` (15 minutes). Optional,
-  // defaults to `300s`.
+  // defaults to `60s`.
   google.protobuf.Duration period = 7;
 
   // The maximum amount of time to wait for the request to complete (must be
   // between 1 and 60 seconds). Required.
   google.protobuf.Duration timeout = 8;
 
-  // The expected content on the page the check is run against.
-  // Currently, only the first entry in the list is supported, and other entries
-  // will be ignored. The server will look for an exact match of the string in
-  // the page response's content. This field is optional and should only be
-  // specified if a content match is required.
+  // The content that is expected to appear in the data returned by the target
+  // server against which the check is run.  Currently, only the first entry
+  // in the `content_matchers` list is supported, and additional entries will
+  // be ignored. This field is optional and should only be specified if a
+  // content match is required as part of the/ Uptime check.
   repeated ContentMatcher content_matchers = 9;
 
   // The list of regions from which the check will be run.
   // Some regions contain one location, and others contain more than one.
-  // If this field is specified, enough regions to include a minimum of
-  // 3 locations must be provided, or an error message is returned.
-  // Not specifying this field will result in uptime checks running from all
-  // regions.
+  // If this field is specified, enough regions must be provided to include a
+  // minimum of 3 locations.  Not specifying this field will result in Uptime
+  // checks running from all available regions.
   repeated UptimeCheckRegion selected_regions = 10;
 
-  // If this is true, then checks are made only from the 'internal_checkers'.
-  // If it is false, then checks are made only from the 'selected_regions'.
-  // It is an error to provide 'selected_regions' when is_internal is true,
-  // or to provide 'internal_checkers' when is_internal is false.
-  bool is_internal = 15;
+  // If this is `true`, then checks are made only from the 'internal_checkers'.
+  // If it is `false`, then checks are made only from the 'selected_regions'.
+  // It is an error to provide 'selected_regions' when is_internal is `true`,
+  // or to provide 'internal_checkers' when is_internal is `false`.
+  bool is_internal = 15 [deprecated = true];
 
   // The internal checkers that this check will egress from. If `is_internal` is
-  // true and this list is empty, the check will egress from all the
-  // InternalCheckers configured for the project that owns this CheckConfig.
-  repeated InternalChecker internal_checkers = 14;
+  // `true` and this list is empty, the check will egress from all the
+  // InternalCheckers configured for the project that owns this
+  // `UptimeCheckConfig`.
+  repeated InternalChecker internal_checkers = 14 [deprecated = true];
 }
 
 // Contains the region, location, and list of IP
@@ -224,35 +363,14 @@ message UptimeCheckIp {
   // within the broader umbrella region category.
   string location = 2;
 
-  // The IP address from which the uptime check originates. This is a full
-  // IP address (not an IP address range). Most IP addresses, as of this
-  // publication, are in IPv4 format; however, one should not rely on the
-  // IP addresses being in IPv4 format indefinitely and should support
+  // The IP address from which the Uptime check originates. This is a fully
+  // specified IP address (not an IP address range). Most IP addresses, as of
+  // this publication, are in IPv4 format; however, one should not rely on the
+  // IP addresses being in IPv4 format indefinitely, and should support
   // interpreting this field in either IPv4 or IPv6 format.
   string ip_address = 3;
 }
 
-// The regions from which an uptime check can be run.
-enum UptimeCheckRegion {
-  // Default value if no region is specified. Will result in uptime checks
-  // running from all regions.
-  REGION_UNSPECIFIED = 0;
-
-  // Allows checks to run from locations within the United States of America.
-  USA = 1;
-
-  // Allows checks to run from locations within the continent of Europe.
-  EUROPE = 2;
-
-  // Allows checks to run from locations within the continent of South
-  // America.
-  SOUTH_AMERICA = 3;
-
-  // Allows checks to run from locations within the Asia Pacific area (ex:
-  // Singapore).
-  ASIA_PACIFIC = 4;
-}
-
 // The supported resource types that can be used as values of
 // `group_resource.resource_type`.
 // `INSTANCE` includes `gce_instance` and `aws_ec2_instance` resource types.
diff --git a/third_party/googleapis/google/monitoring/v3/uptime_service.proto b/third_party/googleapis/google/monitoring/v3/uptime_service.proto
index ed59114d0..5e53934ed 100644
--- a/third_party/googleapis/google/monitoring/v3/uptime_service.proto
+++ b/third_party/googleapis/google/monitoring/v3/uptime_service.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,14 +11,17 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.monitoring.v3;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/monitoring/v3/uptime.proto";
+import "google/protobuf/duration.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
 
@@ -28,9 +31,10 @@ option java_multiple_files = true;
 option java_outer_classname = "UptimeServiceProto";
 option java_package = "com.google.monitoring.v3";
 option php_namespace = "Google\\Cloud\\Monitoring\\V3";
+option ruby_package = "Google::Cloud::Monitoring::V3";
 
 // The UptimeCheckService API is used to manage (list, create, delete, edit)
-// uptime check configurations in the Stackdriver Monitoring product. An uptime
+// Uptime check configurations in the Stackdriver Monitoring product. An Uptime
 // check is a piece of configuration that determines which resources and
 // services to monitor for availability. These configurations can also be
 // configured interactively by navigating to the [Cloud Console]
@@ -38,57 +42,62 @@ option php_namespace = "Google\\Cloud\\Monitoring\\V3";
 // clicking on "Monitoring" on the left-hand side to navigate to Stackdriver,
 // and then clicking on "Uptime".
 service UptimeCheckService {
-  // Lists the existing valid uptime check configurations for the project,
-  // leaving out any invalid configurations.
-  rpc ListUptimeCheckConfigs(ListUptimeCheckConfigsRequest)
-      returns (ListUptimeCheckConfigsResponse) {
+  option (google.api.default_host) = "monitoring.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/monitoring,"
+      "https://www.googleapis.com/auth/monitoring.read";
+
+  // Lists the existing valid Uptime check configurations for the project
+  // (leaving out any invalid configurations).
+  rpc ListUptimeCheckConfigs(ListUptimeCheckConfigsRequest) returns (ListUptimeCheckConfigsResponse) {
     option (google.api.http) = {
       get: "/v3/{parent=projects/*}/uptimeCheckConfigs"
     };
+    option (google.api.method_signature) = "parent";
   }
 
-  // Gets a single uptime check configuration.
-  rpc GetUptimeCheckConfig(GetUptimeCheckConfigRequest)
-      returns (UptimeCheckConfig) {
+  // Gets a single Uptime check configuration.
+  rpc GetUptimeCheckConfig(GetUptimeCheckConfigRequest) returns (UptimeCheckConfig) {
     option (google.api.http) = {
       get: "/v3/{name=projects/*/uptimeCheckConfigs/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
-  // Creates a new uptime check configuration.
-  rpc CreateUptimeCheckConfig(CreateUptimeCheckConfigRequest)
-      returns (UptimeCheckConfig) {
+  // Creates a new Uptime check configuration.
+  rpc CreateUptimeCheckConfig(CreateUptimeCheckConfigRequest) returns (UptimeCheckConfig) {
     option (google.api.http) = {
       post: "/v3/{parent=projects/*}/uptimeCheckConfigs"
       body: "uptime_check_config"
     };
+    option (google.api.method_signature) = "parent,uptime_check_config";
   }
 
-  // Updates an uptime check configuration. You can either replace the entire
+  // Updates an Uptime check configuration. You can either replace the entire
   // configuration with a new one or replace only certain fields in the current
-  // configuration by specifying the fields to be updated via `"updateMask"`.
+  // configuration by specifying the fields to be updated via `updateMask`.
   // Returns the updated configuration.
-  rpc UpdateUptimeCheckConfig(UpdateUptimeCheckConfigRequest)
-      returns (UptimeCheckConfig) {
+  rpc UpdateUptimeCheckConfig(UpdateUptimeCheckConfigRequest) returns (UptimeCheckConfig) {
     option (google.api.http) = {
       patch: "/v3/{uptime_check_config.name=projects/*/uptimeCheckConfigs/*}"
       body: "uptime_check_config"
     };
+    option (google.api.method_signature) = "uptime_check_config";
   }
 
-  // Deletes an uptime check configuration. Note that this method will fail
-  // if the uptime check configuration is referenced by an alert policy or
+  // Deletes an Uptime check configuration. Note that this method will fail
+  // if the Uptime check configuration is referenced by an alert policy or
   // other dependent configs that would be rendered invalid by the deletion.
-  rpc DeleteUptimeCheckConfig(DeleteUptimeCheckConfigRequest)
-      returns (google.protobuf.Empty) {
+  rpc DeleteUptimeCheckConfig(DeleteUptimeCheckConfigRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v3/{name=projects/*/uptimeCheckConfigs/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
-  // Returns the list of IPs that checkers run from
-  rpc ListUptimeCheckIps(ListUptimeCheckIpsRequest)
-      returns (ListUptimeCheckIpsResponse) {
+  // Returns the list of IP addresses that checkers run from
+  rpc ListUptimeCheckIps(ListUptimeCheckIpsRequest) returns (ListUptimeCheckIpsResponse) {
     option (google.api.http) = {
       get: "/v3/uptimeCheckIps"
     };
@@ -97,9 +106,15 @@ service UptimeCheckService {
 
 // The protocol for the `ListUptimeCheckConfigs` request.
 message ListUptimeCheckConfigsRequest {
-  // The project whose uptime check configurations are listed. The format
-  //   is `projects/[PROJECT_ID]`.
-  string parent = 1;
+  // Required. The project whose Uptime check configurations are listed. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "monitoring.googleapis.com/UptimeCheckConfig"
+    }
+  ];
 
   // The maximum number of results to return in a single response. The server
   // may further constrain the maximum number of results returned in a single
@@ -115,7 +130,7 @@ message ListUptimeCheckConfigsRequest {
 
 // The protocol for the `ListUptimeCheckConfigs` response.
 message ListUptimeCheckConfigsResponse {
-  // The returned uptime check configurations.
+  // The returned Uptime check configurations.
   repeated UptimeCheckConfig uptime_check_configs = 1;
 
   // This field represents the pagination token to retrieve the next page of
@@ -125,55 +140,73 @@ message ListUptimeCheckConfigsResponse {
   // request message's page_token field).
   string next_page_token = 2;
 
-  // The total number of uptime check configurations for the project,
+  // The total number of Uptime check configurations for the project,
   // irrespective of any pagination.
   int32 total_size = 3;
 }
 
 // The protocol for the `GetUptimeCheckConfig` request.
 message GetUptimeCheckConfigRequest {
-  // The uptime check configuration to retrieve. The format
-  //   is `projects/[PROJECT_ID]/uptimeCheckConfigs/[UPTIME_CHECK_ID]`.
-  string name = 1;
+  // Required. The Uptime check configuration to retrieve. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/uptimeCheckConfigs/[UPTIME_CHECK_ID]
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "monitoring.googleapis.com/UptimeCheckConfig"
+    }
+  ];
 }
 
 // The protocol for the `CreateUptimeCheckConfig` request.
 message CreateUptimeCheckConfigRequest {
-  // The project in which to create the uptime check. The format
-  //   is `projects/[PROJECT_ID]`.
-  string parent = 1;
-
-  // The new uptime check configuration.
-  UptimeCheckConfig uptime_check_config = 2;
+  // Required. The project in which to create the Uptime check. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "monitoring.googleapis.com/UptimeCheckConfig"
+    }
+  ];
+
+  // Required. The new Uptime check configuration.
+  UptimeCheckConfig uptime_check_config = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The protocol for the `UpdateUptimeCheckConfig` request.
 message UpdateUptimeCheckConfigRequest {
-  // Optional. If present, only the listed fields in the current uptime check
+  // Optional. If present, only the listed fields in the current Uptime check
   // configuration are updated with values from the new configuration. If this
   // field is empty, then the current configuration is completely replaced with
   // the new configuration.
   google.protobuf.FieldMask update_mask = 2;
 
-  // Required. If an `"updateMask"` has been specified, this field gives
-  // the values for the set of fields mentioned in the `"updateMask"`. If an
-  // `"updateMask"` has not been given, this uptime check configuration replaces
-  // the current configuration. If a field is mentioned in `"updateMask"` but
-  // the corresonding field is omitted in this partial uptime check
+  // Required. If an `updateMask` has been specified, this field gives
+  // the values for the set of fields mentioned in the `updateMask`. If an
+  // `updateMask` has not been given, this Uptime check configuration replaces
+  // the current configuration. If a field is mentioned in `updateMask` but
+  // the corresonding field is omitted in this partial Uptime check
   // configuration, it has the effect of deleting/clearing the field from the
   // configuration on the server.
   //
   // The following fields can be updated: `display_name`,
   // `http_check`, `tcp_check`, `timeout`, `content_matchers`, and
   // `selected_regions`.
-  UptimeCheckConfig uptime_check_config = 3;
+  UptimeCheckConfig uptime_check_config = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The protocol for the `DeleteUptimeCheckConfig` request.
 message DeleteUptimeCheckConfigRequest {
-  // The uptime check configuration to delete. The format
-  //   is `projects/[PROJECT_ID]/uptimeCheckConfigs/[UPTIME_CHECK_ID]`.
-  string name = 1;
+  // Required. The Uptime check configuration to delete. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/uptimeCheckConfigs/[UPTIME_CHECK_ID]
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "monitoring.googleapis.com/UptimeCheckConfig"
+    }
+  ];
 }
 
 // The protocol for the `ListUptimeCheckIps` request.
diff --git a/third_party/googleapis/google/privacy/dlp/BUILD.bazel b/third_party/googleapis/google/privacy/dlp/BUILD.bazel
index 1e5b8c2af..a87c57fec 100644
--- a/third_party/googleapis/google/privacy/dlp/BUILD.bazel
+++ b/third_party/googleapis/google/privacy/dlp/BUILD.bazel
@@ -1 +1 @@
-exports_files(glob(["*.yaml"]))
\ No newline at end of file
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/privacy/dlp/artman_dlp_v2.yaml b/third_party/googleapis/google/privacy/dlp/artman_dlp_v2.yaml
index 03e4a2335..dbdd03381 100644
--- a/third_party/googleapis/google/privacy/dlp/artman_dlp_v2.yaml
+++ b/third_party/googleapis/google/privacy/dlp/artman_dlp_v2.yaml
@@ -6,8 +6,9 @@ common:
     - name: google-common-protos
   src_proto_paths:
   - v2
-  service_yaml: dlp_v2.yaml
+  service_yaml: v2/dlp_v2.yaml
   gapic_yaml: v2/dlp_gapic.yaml
+  proto_package: google.privacy.dlp.v2
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/privacy/dlp/v2/BUILD.bazel b/third_party/googleapis/google/privacy/dlp/v2/BUILD.bazel
index 68d9e7cc9..d58be0fb9 100644
--- a/third_party/googleapis/google/privacy/dlp/v2/BUILD.bazel
+++ b/third_party/googleapis/google/privacy/dlp/v2/BUILD.bazel
@@ -1,9 +1,12 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
@@ -15,6 +18,7 @@ proto_library(
     deps = [
         "//google/api:annotations_proto",
         "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
         "//google/api:resource_proto",
         "//google/rpc:status_proto",
         "//google/type:date_proto",
@@ -31,6 +35,7 @@ proto_library_with_info(
     name = "dlp_proto_with_info",
     deps = [
         ":dlp_proto",
+        "//google/cloud:common_resources_proto",
     ],
 )
 
@@ -39,18 +44,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
     name = "dlp_java_proto",
     deps = [":dlp_proto"],
@@ -59,51 +59,40 @@ java_proto_library(
 java_grpc_library(
     name = "dlp_java_grpc",
     srcs = [":dlp_proto"],
-    deps = [":dlp_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "dlp_resource_name_java_proto",
-    gapic_yaml = "dlp_gapic.yaml",
-    deps = [":dlp_proto"],
+    deps = [":dlp_java_proto"],
 )
 
 java_gapic_library(
     name = "dlp_java_gapic",
     src = ":dlp_proto_with_info",
     gapic_yaml = "dlp_gapic.yaml",
-    service_yaml = "//google/privacy/dlp:dlp_v2.yaml",
+    package = "google.privacy.dlp.v2",
+    service_yaml = "dlp_v2.yaml",
     test_deps = [
         ":dlp_java_grpc",
     ],
     deps = [
         ":dlp_java_proto",
-        ":dlp_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
+java_gapic_test(
+    name = "dlp_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.dlp.v2.DlpServiceClientTest",
+    ],
     runtime_deps = [":dlp_java_gapic_test"],
-) for test_name in [
-    #    "com.google.cloud.dlp.v2.DlpServiceClientTest",
-]]
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
-    name = "google-cloud-dlp-v2-java",
-    client_deps = [":dlp_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":dlp_java_gapic_test"],
-    grpc_deps = [":dlp_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    name = "google-cloud-privacy-dlp-v2-java",
+    deps = [
+        ":dlp_java_gapic",
+        ":dlp_java_grpc",
         ":dlp_java_proto",
         ":dlp_proto",
-        ":dlp_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -111,10 +100,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -133,11 +122,14 @@ go_proto_library(
 
 go_gapic_library(
     name = "dlp_go_gapic",
-    src = ":dlp_proto_with_info",
-    gapic_yaml = "dlp_gapic.yaml",
-    importpath = "cloud.google.com/go/dlp/apiv2",
-    service_yaml = "//google/privacy/dlp:dlp_v2.yaml",
-    deps = [":dlp_go_proto"],
+    srcs = [":dlp_proto_with_info"],
+    grpc_service_config = "dlp_grpc_service_config.json",
+    importpath = "cloud.google.com/go/dlp/apiv2;dlp",
+    service_yaml = "dlp_v2.yaml",
+    deps = [
+        ":dlp_go_proto",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
+    ],
 )
 
 go_test(
@@ -147,13 +139,240 @@ go_test(
     importpath = "cloud.google.com/go/dlp/apiv2",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
-    name = "gapi-cloud-dlp-v2-go",
+    name = "gapi-cloud-privacy-dlp-v2-go",
     deps = [
         ":dlp_go_gapic",
-        ":dlp_go_gapic_srcjar-smoke-test.srcjar",
         ":dlp_go_gapic_srcjar-test.srcjar",
         ":dlp_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "dlp_moved_proto",
+    srcs = [":dlp_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/rpc:status_proto",
+        "//google/type:date_proto",
+        "//google/type:dayofweek_proto",
+        "//google/type:timeofday_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "dlp_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":dlp_moved_proto"],
+)
+
+py_grpc_library(
+    name = "dlp_py_grpc",
+    srcs = [":dlp_moved_proto"],
+    deps = [":dlp_py_proto"],
+)
+
+py_gapic_library(
+    name = "dlp_py_gapic",
+    src = ":dlp_proto_with_info",
+    gapic_yaml = "dlp_gapic.yaml",
+    package = "google.privacy.dlp.v2",
+    service_yaml = "dlp_v2.yaml",
+    deps = [
+        ":dlp_py_grpc",
+        ":dlp_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "privacy-dlp-v2-py",
+    deps = [
+        ":dlp_py_gapic",
+        ":dlp_py_grpc",
+        ":dlp_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "dlp_php_proto",
+    deps = [":dlp_proto"],
+)
+
+php_grpc_library(
+    name = "dlp_php_grpc",
+    srcs = [":dlp_proto"],
+    deps = [":dlp_php_proto"],
+)
+
+php_gapic_library(
+    name = "dlp_php_gapic",
+    src = ":dlp_proto_with_info",
+    gapic_yaml = "dlp_gapic.yaml",
+    package = "google.privacy.dlp.v2",
+    service_yaml = "dlp_v2.yaml",
+    deps = [
+        ":dlp_php_grpc",
+        ":dlp_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-privacy-dlp-v2-php",
+    deps = [
+        ":dlp_php_gapic",
+        ":dlp_php_grpc",
+        ":dlp_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "dlp_nodejs_gapic",
+    src = ":dlp_proto_with_info",
+    gapic_yaml = "dlp_gapic.yaml",
+    package = "google.privacy.dlp.v2",
+    service_yaml = "dlp_v2.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "privacy-dlp-v2-nodejs",
+    deps = [
+        ":dlp_nodejs_gapic",
+        ":dlp_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "dlp_ruby_proto",
+    deps = [":dlp_proto"],
+)
+
+ruby_grpc_library(
+    name = "dlp_ruby_grpc",
+    srcs = [":dlp_proto"],
+    deps = [":dlp_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "dlp_ruby_gapic",
+    src = ":dlp_proto_with_info",
+    gapic_yaml = "dlp_gapic.yaml",
+    package = "google.privacy.dlp.v2",
+    service_yaml = "dlp_v2.yaml",
+    deps = [
+        ":dlp_ruby_grpc",
+        ":dlp_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-privacy-dlp-v2-ruby",
+    deps = [
+        ":dlp_ruby_gapic",
+        ":dlp_ruby_grpc",
+        ":dlp_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "dlp_csharp_proto",
+    deps = [":dlp_proto"],
+)
+
+csharp_grpc_library(
+    name = "dlp_csharp_grpc",
+    srcs = [":dlp_proto"],
+    deps = [":dlp_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "dlp_csharp_gapic",
+    src = ":dlp_proto_with_info",
+    gapic_yaml = "dlp_gapic.yaml",
+    package = "google.privacy.dlp.v2",
+    service_yaml = "dlp_v2.yaml",
+    deps = [
+        ":dlp_csharp_grpc",
+        ":dlp_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-privacy-dlp-v2-csharp",
+    deps = [
+        ":dlp_csharp_gapic",
+        ":dlp_csharp_grpc",
+        ":dlp_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/devtools/resultstore/artman_resultstore.yaml b/third_party/googleapis/google/privacy/dlp/v2/artman_dlp_v2.yaml
similarity index 77%
rename from third_party/googleapis/google/devtools/resultstore/artman_resultstore.yaml
rename to third_party/googleapis/google/privacy/dlp/v2/artman_dlp_v2.yaml
index 6c3106964..22ae0fd4a 100644
--- a/third_party/googleapis/google/devtools/resultstore/artman_resultstore.yaml
+++ b/third_party/googleapis/google/privacy/dlp/v2/artman_dlp_v2.yaml
@@ -1,13 +1,13 @@
 common:
-  api_name: resultstore
+  api_name: dlp
   api_version: v2
   organization_name: google-cloud
   proto_deps:
-    - name: google-common-protos
+  - name: google-common-protos
   src_proto_paths:
-  - v2
-  service_yaml: resultstore-service.yaml
-  gapic_yaml: v2/resultstore_gapic.yaml
+  - .
+  service_yaml: dlp_v2.yaml
+  gapic_yaml: dlp_gapic.yaml
 artifacts:
 - name: gapic_config
   type: GAPIC_CONFIG
diff --git a/third_party/googleapis/google/privacy/dlp/v2/dlp.proto b/third_party/googleapis/google/privacy/dlp/v2/dlp.proto
index b138c3b59..29291fa5a 100644
--- a/third_party/googleapis/google/privacy/dlp/v2/dlp.proto
+++ b/third_party/googleapis/google/privacy/dlp/v2/dlp.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,15 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.privacy.dlp.v2;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/privacy/dlp/v2/storage.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/empty.proto";
@@ -27,7 +29,6 @@ import "google/rpc/status.proto";
 import "google/type/date.proto";
 import "google/type/dayofweek.proto";
 import "google/type/timeofday.proto";
-import "google/api/client.proto";
 
 option csharp_namespace = "Google.Cloud.Dlp.V2";
 option go_package = "google.golang.org/genproto/googleapis/privacy/dlp/v2;dlp";
@@ -35,6 +36,11 @@ option java_multiple_files = true;
 option java_outer_classname = "DlpProto";
 option java_package = "com.google.privacy.dlp.v2";
 option php_namespace = "Google\\Cloud\\Dlp\\V2";
+option ruby_package = "Google::Cloud::Dlp::V2";
+option (google.api.resource_definition) = {
+  type: "dlp.googleapis.com/OrganizationLocation"
+  pattern: "organizations/{organization}/locations/{location}"
+};
 
 // The Cloud Data Loss Prevention (DLP) API is a service that allows clients
 // to detect the presence of Personally Identifiable Information (PII) and other
@@ -62,6 +68,10 @@ service DlpService {
     option (google.api.http) = {
       post: "/v2/{parent=projects/*}/content:inspect"
       body: "*"
+      additional_bindings {
+        post: "/v2/{parent=projects/*/locations/*}/content:inspect"
+        body: "*"
+      }
     };
   }
 
@@ -77,6 +87,10 @@ service DlpService {
     option (google.api.http) = {
       post: "/v2/{parent=projects/*}/image:redact"
       body: "*"
+      additional_bindings {
+        post: "/v2/{parent=projects/*/locations/*}/image:redact"
+        body: "*"
+      }
     };
   }
 
@@ -92,6 +106,10 @@ service DlpService {
     option (google.api.http) = {
       post: "/v2/{parent=projects/*}/content:deidentify"
       body: "*"
+      additional_bindings {
+        post: "/v2/{parent=projects/*/locations/*}/content:deidentify"
+        body: "*"
+      }
     };
   }
 
@@ -103,6 +121,10 @@ service DlpService {
     option (google.api.http) = {
       post: "/v2/{parent=projects/*}/content:reidentify"
       body: "*"
+      additional_bindings {
+        post: "/v2/{parent=projects/*/locations/*}/content:reidentify"
+        body: "*"
+      }
     };
   }
 
@@ -112,7 +134,11 @@ service DlpService {
   rpc ListInfoTypes(ListInfoTypesRequest) returns (ListInfoTypesResponse) {
     option (google.api.http) = {
       get: "/v2/infoTypes"
+      additional_bindings {
+        get: "/v2/{parent=locations/*}/infoTypes"
+      }
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Creates an InspectTemplate for re-using frequently used configuration
@@ -122,11 +148,20 @@ service DlpService {
     option (google.api.http) = {
       post: "/v2/{parent=organizations/*}/inspectTemplates"
       body: "*"
+      additional_bindings {
+        post: "/v2/{parent=organizations/*/locations/*}/inspectTemplates"
+        body: "*"
+      }
       additional_bindings {
         post: "/v2/{parent=projects/*}/inspectTemplates"
         body: "*"
       }
+      additional_bindings {
+        post: "/v2/{parent=projects/*/locations/*}/inspectTemplates"
+        body: "*"
+      }
     };
+    option (google.api.method_signature) = "parent,inspect_template";
   }
 
   // Updates the InspectTemplate.
@@ -135,11 +170,20 @@ service DlpService {
     option (google.api.http) = {
       patch: "/v2/{name=organizations/*/inspectTemplates/*}"
       body: "*"
+      additional_bindings {
+        patch: "/v2/{name=organizations/*/locations/*/inspectTemplates/*}"
+        body: "*"
+      }
       additional_bindings {
         patch: "/v2/{name=projects/*/inspectTemplates/*}"
         body: "*"
       }
+      additional_bindings {
+        patch: "/v2/{name=projects/*/locations/*/inspectTemplates/*}"
+        body: "*"
+      }
     };
+    option (google.api.method_signature) = "name,inspect_template,update_mask";
   }
 
   // Gets an InspectTemplate.
@@ -147,10 +191,17 @@ service DlpService {
   rpc GetInspectTemplate(GetInspectTemplateRequest) returns (InspectTemplate) {
     option (google.api.http) = {
       get: "/v2/{name=organizations/*/inspectTemplates/*}"
+      additional_bindings {
+        get: "/v2/{name=organizations/*/locations/*/inspectTemplates/*}"
+      }
       additional_bindings {
         get: "/v2/{name=projects/*/inspectTemplates/*}"
       }
+      additional_bindings {
+        get: "/v2/{name=projects/*/locations/*/inspectTemplates/*}"
+      }
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists InspectTemplates.
@@ -158,10 +209,17 @@ service DlpService {
   rpc ListInspectTemplates(ListInspectTemplatesRequest) returns (ListInspectTemplatesResponse) {
     option (google.api.http) = {
       get: "/v2/{parent=organizations/*}/inspectTemplates"
+      additional_bindings {
+        get: "/v2/{parent=organizations/*/locations/*}/inspectTemplates"
+      }
       additional_bindings {
         get: "/v2/{parent=projects/*}/inspectTemplates"
       }
+      additional_bindings {
+        get: "/v2/{parent=projects/*/locations/*}/inspectTemplates"
+      }
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Deletes an InspectTemplate.
@@ -169,10 +227,17 @@ service DlpService {
   rpc DeleteInspectTemplate(DeleteInspectTemplateRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v2/{name=organizations/*/inspectTemplates/*}"
+      additional_bindings {
+        delete: "/v2/{name=organizations/*/locations/*/inspectTemplates/*}"
+      }
       additional_bindings {
         delete: "/v2/{name=projects/*/inspectTemplates/*}"
       }
+      additional_bindings {
+        delete: "/v2/{name=projects/*/locations/*/inspectTemplates/*}"
+      }
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates a DeidentifyTemplate for re-using frequently used configuration
@@ -183,11 +248,20 @@ service DlpService {
     option (google.api.http) = {
       post: "/v2/{parent=organizations/*}/deidentifyTemplates"
       body: "*"
+      additional_bindings {
+        post: "/v2/{parent=organizations/*/locations/*}/deidentifyTemplates"
+        body: "*"
+      }
       additional_bindings {
         post: "/v2/{parent=projects/*}/deidentifyTemplates"
         body: "*"
       }
+      additional_bindings {
+        post: "/v2/{parent=projects/*/locations/*}/deidentifyTemplates"
+        body: "*"
+      }
     };
+    option (google.api.method_signature) = "parent,deidentify_template";
   }
 
   // Updates the DeidentifyTemplate.
@@ -197,11 +271,20 @@ service DlpService {
     option (google.api.http) = {
       patch: "/v2/{name=organizations/*/deidentifyTemplates/*}"
       body: "*"
+      additional_bindings {
+        patch: "/v2/{name=organizations/*/locations/*/deidentifyTemplates/*}"
+        body: "*"
+      }
       additional_bindings {
         patch: "/v2/{name=projects/*/deidentifyTemplates/*}"
         body: "*"
       }
+      additional_bindings {
+        patch: "/v2/{name=projects/*/locations/*/deidentifyTemplates/*}"
+        body: "*"
+      }
     };
+    option (google.api.method_signature) = "name,deidentify_template,update_mask";
   }
 
   // Gets a DeidentifyTemplate.
@@ -210,10 +293,17 @@ service DlpService {
   rpc GetDeidentifyTemplate(GetDeidentifyTemplateRequest) returns (DeidentifyTemplate) {
     option (google.api.http) = {
       get: "/v2/{name=organizations/*/deidentifyTemplates/*}"
+      additional_bindings {
+        get: "/v2/{name=organizations/*/locations/*/deidentifyTemplates/*}"
+      }
       additional_bindings {
         get: "/v2/{name=projects/*/deidentifyTemplates/*}"
       }
+      additional_bindings {
+        get: "/v2/{name=projects/*/locations/*/deidentifyTemplates/*}"
+      }
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists DeidentifyTemplates.
@@ -222,10 +312,17 @@ service DlpService {
   rpc ListDeidentifyTemplates(ListDeidentifyTemplatesRequest) returns (ListDeidentifyTemplatesResponse) {
     option (google.api.http) = {
       get: "/v2/{parent=organizations/*}/deidentifyTemplates"
+      additional_bindings {
+        get: "/v2/{parent=organizations/*/locations/*}/deidentifyTemplates"
+      }
       additional_bindings {
         get: "/v2/{parent=projects/*}/deidentifyTemplates"
       }
+      additional_bindings {
+        get: "/v2/{parent=projects/*/locations/*}/deidentifyTemplates"
+      }
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Deletes a DeidentifyTemplate.
@@ -234,10 +331,17 @@ service DlpService {
   rpc DeleteDeidentifyTemplate(DeleteDeidentifyTemplateRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v2/{name=organizations/*/deidentifyTemplates/*}"
+      additional_bindings {
+        delete: "/v2/{name=organizations/*/locations/*/deidentifyTemplates/*}"
+      }
       additional_bindings {
         delete: "/v2/{name=projects/*/deidentifyTemplates/*}"
       }
+      additional_bindings {
+        delete: "/v2/{name=projects/*/locations/*/deidentifyTemplates/*}"
+      }
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates a job trigger to run DLP actions such as scanning storage for
@@ -247,7 +351,12 @@ service DlpService {
     option (google.api.http) = {
       post: "/v2/{parent=projects/*}/jobTriggers"
       body: "*"
+      additional_bindings {
+        post: "/v2/{parent=projects/*/locations/*}/jobTriggers"
+        body: "*"
+      }
     };
+    option (google.api.method_signature) = "parent,job_trigger";
   }
 
   // Updates a job trigger.
@@ -256,7 +365,26 @@ service DlpService {
     option (google.api.http) = {
       patch: "/v2/{name=projects/*/jobTriggers/*}"
       body: "*"
+      additional_bindings {
+        patch: "/v2/{name=projects/*/locations/*/jobTriggers/*}"
+        body: "*"
+      }
     };
+    option (google.api.method_signature) = "name,job_trigger,update_mask";
+  }
+
+  // Inspect hybrid content and store findings to a trigger. The inspection
+  // will be processed asynchronously. To review the findings monitor the
+  // jobs within the trigger.
+  // Early access feature is in a pre-release state and might change or have
+  // limited support. For more information, see
+  // https://cloud.google.com/products#product-launch-stages.
+  rpc HybridInspectJobTrigger(HybridInspectJobTriggerRequest) returns (HybridInspectResponse) {
+    option (google.api.http) = {
+      post: "/v2/{name=projects/*/locations/*/jobTriggers/*}:hybridInspect"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name";
   }
 
   // Gets a job trigger.
@@ -264,7 +392,11 @@ service DlpService {
   rpc GetJobTrigger(GetJobTriggerRequest) returns (JobTrigger) {
     option (google.api.http) = {
       get: "/v2/{name=projects/*/jobTriggers/*}"
+      additional_bindings {
+        get: "/v2/{name=projects/*/locations/*/jobTriggers/*}"
+      }
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists job triggers.
@@ -272,7 +404,11 @@ service DlpService {
   rpc ListJobTriggers(ListJobTriggersRequest) returns (ListJobTriggersResponse) {
     option (google.api.http) = {
       get: "/v2/{parent=projects/*}/jobTriggers"
+      additional_bindings {
+        get: "/v2/{parent=projects/*/locations/*}/jobTriggers"
+      }
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Deletes a job trigger.
@@ -280,7 +416,11 @@ service DlpService {
   rpc DeleteJobTrigger(DeleteJobTriggerRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v2/{name=projects/*/jobTriggers/*}"
+      additional_bindings {
+        delete: "/v2/{name=projects/*/locations/*/jobTriggers/*}"
+      }
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Activate a job trigger. Causes the immediate execute of a trigger
@@ -289,6 +429,10 @@ service DlpService {
     option (google.api.http) = {
       post: "/v2/{name=projects/*/jobTriggers/*}:activate"
       body: "*"
+      additional_bindings {
+        post: "/v2/{name=projects/*/locations/*/jobTriggers/*}:activate"
+        body: "*"
+      }
     };
   }
 
@@ -303,7 +447,13 @@ service DlpService {
     option (google.api.http) = {
       post: "/v2/{parent=projects/*}/dlpJobs"
       body: "*"
+      additional_bindings {
+        post: "/v2/{parent=projects/*/locations/*}/dlpJobs"
+        body: "*"
+      }
     };
+    option (google.api.method_signature) = "parent,inspect_job";
+    option (google.api.method_signature) = "parent,risk_job";
   }
 
   // Lists DlpJobs that match the specified filter in the request.
@@ -312,7 +462,11 @@ service DlpService {
   rpc ListDlpJobs(ListDlpJobsRequest) returns (ListDlpJobsResponse) {
     option (google.api.http) = {
       get: "/v2/{parent=projects/*}/dlpJobs"
+      additional_bindings {
+        get: "/v2/{parent=projects/*/locations/*}/dlpJobs"
+      }
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets the latest state of a long-running DlpJob.
@@ -321,7 +475,11 @@ service DlpService {
   rpc GetDlpJob(GetDlpJobRequest) returns (DlpJob) {
     option (google.api.http) = {
       get: "/v2/{name=projects/*/dlpJobs/*}"
+      additional_bindings {
+        get: "/v2/{name=projects/*/locations/*/dlpJobs/*}"
+      }
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Deletes a long-running DlpJob. This method indicates that the client is
@@ -332,7 +490,11 @@ service DlpService {
   rpc DeleteDlpJob(DeleteDlpJobRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v2/{name=projects/*/dlpJobs/*}"
+      additional_bindings {
+        delete: "/v2/{name=projects/*/locations/*/dlpJobs/*}"
+      }
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Starts asynchronous cancellation on a long-running DlpJob. The server
@@ -344,6 +506,10 @@ service DlpService {
     option (google.api.http) = {
       post: "/v2/{name=projects/*/dlpJobs/*}:cancel"
       body: "*"
+      additional_bindings {
+        post: "/v2/{name=projects/*/locations/*/dlpJobs/*}:cancel"
+        body: "*"
+      }
     };
   }
 
@@ -354,11 +520,20 @@ service DlpService {
     option (google.api.http) = {
       post: "/v2/{parent=organizations/*}/storedInfoTypes"
       body: "*"
+      additional_bindings {
+        post: "/v2/{parent=organizations/*/locations/*}/storedInfoTypes"
+        body: "*"
+      }
       additional_bindings {
         post: "/v2/{parent=projects/*}/storedInfoTypes"
         body: "*"
       }
+      additional_bindings {
+        post: "/v2/{parent=projects/*/locations/*}/storedInfoTypes"
+        body: "*"
+      }
     };
+    option (google.api.method_signature) = "parent,config";
   }
 
   // Updates the stored infoType by creating a new version. The existing version
@@ -369,11 +544,20 @@ service DlpService {
     option (google.api.http) = {
       patch: "/v2/{name=organizations/*/storedInfoTypes/*}"
       body: "*"
+      additional_bindings {
+        patch: "/v2/{name=organizations/*/locations/*/storedInfoTypes/*}"
+        body: "*"
+      }
       additional_bindings {
         patch: "/v2/{name=projects/*/storedInfoTypes/*}"
         body: "*"
       }
+      additional_bindings {
+        patch: "/v2/{name=projects/*/locations/*/storedInfoTypes/*}"
+        body: "*"
+      }
     };
+    option (google.api.method_signature) = "name,config,update_mask";
   }
 
   // Gets a stored infoType.
@@ -382,10 +566,17 @@ service DlpService {
   rpc GetStoredInfoType(GetStoredInfoTypeRequest) returns (StoredInfoType) {
     option (google.api.http) = {
       get: "/v2/{name=organizations/*/storedInfoTypes/*}"
+      additional_bindings {
+        get: "/v2/{name=organizations/*/locations/*/storedInfoTypes/*}"
+      }
       additional_bindings {
         get: "/v2/{name=projects/*/storedInfoTypes/*}"
       }
+      additional_bindings {
+        get: "/v2/{name=projects/*/locations/*/storedInfoTypes/*}"
+      }
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists stored infoTypes.
@@ -394,10 +585,17 @@ service DlpService {
   rpc ListStoredInfoTypes(ListStoredInfoTypesRequest) returns (ListStoredInfoTypesResponse) {
     option (google.api.http) = {
       get: "/v2/{parent=organizations/*}/storedInfoTypes"
+      additional_bindings {
+        get: "/v2/{parent=organizations/*/locations/*}/storedInfoTypes"
+      }
       additional_bindings {
         get: "/v2/{parent=projects/*}/storedInfoTypes"
       }
+      additional_bindings {
+        get: "/v2/{parent=projects/*/locations/*}/storedInfoTypes"
+      }
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Deletes a stored infoType.
@@ -406,9 +604,42 @@ service DlpService {
   rpc DeleteStoredInfoType(DeleteStoredInfoTypeRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v2/{name=organizations/*/storedInfoTypes/*}"
+      additional_bindings {
+        delete: "/v2/{name=organizations/*/locations/*/storedInfoTypes/*}"
+      }
       additional_bindings {
         delete: "/v2/{name=projects/*/storedInfoTypes/*}"
       }
+      additional_bindings {
+        delete: "/v2/{name=projects/*/locations/*/storedInfoTypes/*}"
+      }
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Inspect hybrid content and store findings to a job.
+  // To review the findings inspect the job. Inspection will occur
+  // asynchronously.
+  // Early access feature is in a pre-release state and might change or have
+  // limited support. For more information, see
+  // https://cloud.google.com/products#product-launch-stages.
+  rpc HybridInspectDlpJob(HybridInspectDlpJobRequest) returns (HybridInspectResponse) {
+    option (google.api.http) = {
+      post: "/v2/{name=projects/*/locations/*/dlpJobs/*}:hybridInspect"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Finish a running hybrid DlpJob. Triggers the finalization steps and running
+  // of any enabled actions that have not yet run.
+  // Early access feature is in a pre-release state and might change or have
+  // limited support. For more information, see
+  // https://cloud.google.com/products#product-launch-stages.
+  rpc FinishDlpJob(FinishDlpJobRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/v2/{name=projects/*/locations/*/dlpJobs/*}:finish"
+      body: "*"
     };
   }
 }
@@ -426,21 +657,10 @@ message ExcludeInfoTypes {
   repeated InfoType info_types = 1;
 }
 
-// Options describing which parts of the provided content should be scanned.
-enum ContentOption {
-  // Includes entire content of a file or a data stream.
-  CONTENT_UNSPECIFIED = 0;
-
-  // Text content within the data, excluding any metadata.
-  CONTENT_TEXT = 1;
-
-  // Images found in the data.
-  CONTENT_IMAGE = 2;
-}
-
 // The rule that specifies conditions when findings of infoTypes specified in
 // `InspectionRuleSet` are removed from results.
 message ExclusionRule {
+  // Exclusion rule types.
   oneof type {
     // Dictionary which defines the rule.
     CustomInfoType.Dictionary dictionary = 1;
@@ -459,6 +679,7 @@ message ExclusionRule {
 // A single inspection rule to be applied to infoTypes, specified in
 // `InspectionRuleSet`.
 message InspectionRule {
+  // Inspection rule types.
   oneof type {
     // Hotword-based detection rule.
     CustomInfoType.DetectionRule.HotwordRule hotword_rule = 1;
@@ -482,6 +703,7 @@ message InspectionRuleSet {
 // When used with redactContent only info_types and min_likelihood are currently
 // used.
 message InspectConfig {
+  // Configuration to control the number of findings returned.
   message FindingLimits {
     // Max findings configuration per infoType, per content item or long
     // running DlpJob.
@@ -497,7 +719,7 @@ message InspectConfig {
     }
 
     // Max number of findings that will be returned for each item scanned.
-    // When set within `InspectDataSourceRequest`,
+    // When set within `InspectJobConfig`,
     // the maximum returned is 2000 regardless if this is set higher.
     // When set within `InspectContentRequest`, this field is ignored.
     int32 max_findings_per_item = 1;
@@ -519,10 +741,9 @@ message InspectConfig {
   // system may automatically choose what detectors to run. By default this may
   // be all types, but may change over time as detectors are updated.
   //
-  // The special InfoType name "ALL_BASIC" can be used to trigger all detectors,
-  // but may change over time as new InfoTypes are added. If you need precise
-  // control and predictability as to what detectors are run you should specify
-  // specific InfoTypes listed in the reference.
+  // If you need precise control and predictability as to what detectors are
+  // run you should specify specific InfoTypes listed in the reference,
+  // otherwise a default list will be used, which may change over time.
   repeated InfoType info_types = 1;
 
   // Only returns findings equal or above this threshold. The default is
@@ -530,6 +751,7 @@ message InspectConfig {
   // See https://cloud.google.com/dlp/docs/likelihood to learn more.
   Likelihood min_likelihood = 2;
 
+  // Configuration to control the number of findings returned.
   FindingLimits limits = 3;
 
   // When true, a contextual quote from the data that triggered a finding is
@@ -555,21 +777,36 @@ message InspectConfig {
 
 // Container for bytes to inspect or redact.
 message ByteContentItem {
+  // The type of data being sent for inspection.
   enum BytesType {
+    // Unused
     BYTES_TYPE_UNSPECIFIED = 0;
 
+    // Any image type.
     IMAGE = 6;
 
+    // jpeg
     IMAGE_JPEG = 1;
 
+    // bmp
     IMAGE_BMP = 2;
 
+    // png
     IMAGE_PNG = 3;
 
+    // svg
     IMAGE_SVG = 4;
 
+    // plain text
     TEXT_UTF8 = 5;
 
+    // docx, docm, dotx, dotm
+    WORD_DOCUMENT = 7;
+
+    // pdf
+    PDF = 8;
+
+    // avro
     AVRO = 11;
   }
 
@@ -601,12 +838,16 @@ message ContentItem {
 // See https://cloud.google.com/dlp/docs/inspecting-text#inspecting_a_table to
 // learn more.
 message Table {
+  // Values of the row.
   message Row {
+    // Individual cells.
     repeated Value values = 1;
   }
 
+  // Headers of the table.
   repeated FieldId headers = 1;
 
+  // Rows of the table.
   repeated Row rows = 2;
 }
 
@@ -626,6 +867,16 @@ message InspectResult {
 
 // Represents a piece of potentially sensitive content.
 message Finding {
+  option (google.api.resource) = {
+    type: "dlp.googleapis.com/Finding"
+    pattern: "projects/{project}/locations/{location}/findings/{finding}"
+  };
+
+  // Resource name in format
+  // projects/{project}/locations/{location}/findings/{finding}
+  // Populated only when viewing persisted findings.
+  string name = 14;
+
   // The content that was found. Even if the content is not textual, it
   // may be converted to a textual representation here.
   // Provided if `include_quote` is true and the finding is
@@ -650,6 +901,39 @@ message Finding {
   // to true and a supported infoType was requested. Currently supported
   // infoTypes: DATE, DATE_OF_BIRTH and TIME.
   QuoteInfo quote_info = 7;
+
+  // The job that stored the finding.
+  string resource_name = 8 [(google.api.resource_reference) = {
+                              type: "dlp.googleapis.com/DlpJob"
+                            }];
+
+  // Job trigger name, if applicable, for this finding.
+  string trigger_name = 9 [(google.api.resource_reference) = {
+                             type: "dlp.googleapis.com/JobTrigger"
+                           }];
+
+  // The labels associated with this `Finding`.
+  //
+  // Label keys must be between 1 and 63 characters long and must conform
+  // to the following regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?`.
+  //
+  // Label values must be between 0 and 63 characters long and must conform
+  // to the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`.
+  //
+  // No more than 10 labels can be associated with a given finding.
+  //
+  // Examples:
+  // * `"environment" : "production"`
+  // * `"pipeline" : "etl"`
+  map labels = 10;
+
+  // Time the job started that produced this finding.
+  google.protobuf.Timestamp job_create_time = 11;
+
+  // The job that stored the finding.
+  string job_name = 13 [(google.api.resource_reference) = {
+                          type: "dlp.googleapis.com/DlpJob"
+                        }];
 }
 
 // Specifies the location of the finding.
@@ -669,46 +953,21 @@ message Location {
   // List of nested objects pointing to the precise location of the finding
   // within the file or record.
   repeated ContentLocation content_locations = 7;
-}
 
-// Type of the match which can be applied to different ways of matching, like
-// Dictionary, regular expression and intersecting with findings of another
-// info type.
-enum MatchingType {
-  // Invalid.
-  MATCHING_TYPE_UNSPECIFIED = 0;
-
-  // Full match.
-  //
-  // - Dictionary: join of Dictionary results matched complete finding quote
-  // - Regex: all regex matches fill a finding quote start to end
-  // - Exclude info type: completely inside affecting info types findings
-  MATCHING_TYPE_FULL_MATCH = 1;
-
-  // Partial match.
-  //
-  // - Dictionary: at least one of the tokens in the finding matches
-  // - Regex: substring of the finding matches
-  // - Exclude info type: intersects with affecting info types findings
-  MATCHING_TYPE_PARTIAL_MATCH = 2;
-
-  // Inverse match.
-  //
-  // - Dictionary: no tokens in the finding match the dictionary
-  // - Regex: finding doesn't match the regex
-  // - Exclude info type: no intersection with affecting info types findings
-  MATCHING_TYPE_INVERSE_MATCH = 3;
+  // Information about the container where this finding occurred, if available.
+  Container container = 8;
 }
 
-// Findings container location data.
+// Precise location of the finding within a document, record, image, or metadata
+// container.
 message ContentLocation {
   // Name of the container where the finding is located.
   // The top level name is the source file name or table name. Names of some
   // common storage containers are formatted as follows:
   //
-  // * BigQuery tables:  `:.`
-  // * Cloud Storage files: `gs:///`
-  // * Datastore namespace: 
+  // * BigQuery tables:  `{project_id}:{dataset_id}.{table_id}`
+  // * Cloud Storage files: `gs://{bucket}/{path}`
+  // * Datastore namespace: {namespace}
   //
   // Nested names could be absent if the embedded object has no string
   // identifier (for an example an image contained within a document).
@@ -724,6 +983,9 @@ message ContentLocation {
 
     // Location data for document files.
     DocumentLocation document_location = 5;
+
+    // Location within the metadata for inspected content.
+    MetadataLocation metadata_location = 8;
   }
 
   // Findings container modification timestamp, if applicable.
@@ -737,6 +999,24 @@ message ContentLocation {
   string container_version = 7;
 }
 
+// Metadata Location
+message MetadataLocation {
+  // Type of metadata containing the finding.
+  MetadataType type = 1;
+
+  // Label of the piece of metadata containing the finding, for example -
+  // latitude, author, caption.
+  oneof label {
+    // Storage metadata.
+    StorageMetadataLabel storage_label = 3;
+  }
+}
+
+// Storage metadata label to indicate which metadata entry contains findings.
+message StorageMetadataLabel {
+  string key = 1;
+}
+
 // Location of a finding within a document.
 message DocumentLocation {
   // Offset of the line, from the beginning of the file, where the finding
@@ -758,10 +1038,58 @@ message RecordLocation {
 
 // Location of a finding within a table.
 message TableLocation {
-  // The zero-based index of the row where the finding is located.
+  // The zero-based index of the row where the finding is located. Only
+  // populated for resources that have a natural ordering, not BigQuery. In
+  // BigQuery, to identify the row a finding came from, populate
+  // BigQueryOptions.identifying_fields with your primary key column names and
+  // when you store the findings the value of those columns will be stored
+  // inside of Finding.
   int64 row_index = 1;
 }
 
+// Represents a container that may contain DLP findings.
+// Examples of a container include a file, table, or database record.
+message Container {
+  // Container type, for example BigQuery or Google Cloud Storage.
+  string type = 1;
+
+  // Project where the finding was found.
+  // Can be different from the project that owns the finding.
+  string project_id = 2;
+
+  // A string representation of the full container name.
+  // Examples:
+  // - BigQuery: 'Project:DataSetId.TableId'
+  // - Google Cloud Storage: 'gs://Bucket/folders/filename.txt'
+  string full_path = 3;
+
+  // The root of the container.
+  // Examples:
+  // - For BigQuery table `project_id:dataset_id.table_id`, the root is
+  //  `dataset_id`
+  // - For Google Cloud Storage file `gs://bucket/folder/filename.txt`, the root
+  //  is `gs://bucket`
+  string root_path = 4;
+
+  // The rest of the path after the root.
+  // Examples:
+  // - For BigQuery table `project_id:dataset_id.table_id`, the relative path is
+  //  `table_id`
+  // - Google Cloud Storage file `gs://bucket/folder/filename.txt`, the relative
+  //  path is `folder/filename.txt`
+  string relative_path = 5;
+
+  // Findings container modification timestamp, if applicable.
+  // For Google Cloud Storage contains last file modification timestamp.
+  // For BigQuery table contains last_modified_time property.
+  // For Datastore - not populated.
+  google.protobuf.Timestamp update_time = 6;
+
+  // Findings container version, if available
+  // ("generation" for Google Cloud Storage).
+  string version = 7;
+}
+
 // Generic half-open interval [start, end)
 message Range {
   // Index of the first character of the range (inclusive).
@@ -815,8 +1143,14 @@ message RedactImageRequest {
     Color redaction_color = 3;
   }
 
-  // The parent resource name, for example projects/my-project-id.
-  string parent = 1;
+  // The parent resource name, for example projects/my-project-id
+  // or projects/my-project-id/locations/{location_id}.
+  string parent = 1 [(google.api.resource_reference) = {
+    type: "cloudresourcemanager.googleapis.com/Project"
+  }];
+
+  // Deprecated. This field has no effect.
+  string location_id = 8;
 
   // Configuration for the inspector.
   InspectConfig inspect_config = 2;
@@ -860,8 +1194,11 @@ message RedactImageResponse {
 
 // Request to de-identify a list of items.
 message DeidentifyContentRequest {
-  // The parent resource name, for example projects/my-project-id.
-  string parent = 1;
+  // The parent resource name, for example projects/my-project-id
+  // or projects/my-project-id/locations/{location_id}.
+  string parent = 1 [(google.api.resource_reference) = {
+    type: "cloudresourcemanager.googleapis.com/Project"
+  }];
 
   // Configuration for the de-identification of the content item.
   // Items specified here will override the template referenced by the
@@ -876,19 +1213,22 @@ message DeidentifyContentRequest {
   // The item to de-identify. Will be treated as text.
   ContentItem item = 4;
 
-  // Optional template to use. Any configuration directly specified in
+  // Template to use. Any configuration directly specified in
   // inspect_config will override those set in the template. Singular fields
   // that are set in this request will replace their corresponding fields in the
   // template. Repeated fields are appended. Singular sub-messages and groups
   // are recursively merged.
   string inspect_template_name = 5;
 
-  // Optional template to use. Any configuration directly specified in
+  // Template to use. Any configuration directly specified in
   // deidentify_config will override those set in the template. Singular fields
   // that are set in this request will replace their corresponding fields in the
   // template. Repeated fields are appended. Singular sub-messages and groups
   // are recursively merged.
   string deidentify_template_name = 6;
+
+  // Deprecated. This field has no effect.
+  string location_id = 7;
 }
 
 // Results of de-identifying a ContentItem.
@@ -902,8 +1242,13 @@ message DeidentifyContentResponse {
 
 // Request to re-identify an item.
 message ReidentifyContentRequest {
-  // The parent resource name.
-  string parent = 1;
+  // Required. The parent resource name.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
   // Configuration for the re-identification of the content item.
   // This field shares the same proto message type that is used for
@@ -913,6 +1258,7 @@ message ReidentifyContentRequest {
   // reverse. This requires that only reversible transformations
   // be provided here. The reversible transformations are:
   //
+  //  - `CryptoDeterministicConfig`
   //  - `CryptoReplaceFfxFpeConfig`
   DeidentifyConfig reidentify_config = 2;
 
@@ -922,20 +1268,23 @@ message ReidentifyContentRequest {
   // The item to re-identify. Will be treated as text.
   ContentItem item = 4;
 
-  // Optional template to use. Any configuration directly specified in
+  // Template to use. Any configuration directly specified in
   // `inspect_config` will override those set in the template. Singular fields
   // that are set in this request will replace their corresponding fields in the
   // template. Repeated fields are appended. Singular sub-messages and groups
   // are recursively merged.
   string inspect_template_name = 5;
 
-  // Optional template to use. References an instance of `DeidentifyTemplate`.
+  // Template to use. References an instance of `DeidentifyTemplate`.
   // Any configuration directly specified in `reidentify_config` or
   // `inspect_config` will override those set in the template. Singular fields
   // that are set in this request will replace their corresponding fields in the
   // template. Repeated fields are appended. Singular sub-messages and groups
   // are recursively merged.
   string reidentify_template_name = 6;
+
+  // Deprecated. This field has no effect.
+  string location_id = 7;
 }
 
 // Results of re-identifying a item.
@@ -949,8 +1298,11 @@ message ReidentifyContentResponse {
 
 // Request to search for potentially sensitive info in a ContentItem.
 message InspectContentRequest {
-  // The parent resource name, for example projects/my-project-id.
-  string parent = 1;
+  // The parent resource name, for example projects/my-project-id
+  // or projects/my-project-id/locations/{location_id}
+  string parent = 1 [(google.api.resource_reference) = {
+    type: "cloudresourcemanager.googleapis.com/Project"
+  }];
 
   // Configuration for the inspector. What specified here will override
   // the template referenced by the inspect_template_name argument.
@@ -959,12 +1311,15 @@ message InspectContentRequest {
   // The item to inspect.
   ContentItem item = 3;
 
-  // Optional template to use. Any configuration directly specified in
+  // Template to use. Any configuration directly specified in
   // inspect_config will override those set in the template. Singular fields
   // that are set in this request will replace their corresponding fields in the
   // template. Repeated fields are appended. Singular sub-messages and groups
   // are recursively merged.
   string inspect_template_name = 4;
+
+  // Deprecated. This field has no effect.
+  string location_id = 5;
 }
 
 // Results of inspecting an item.
@@ -976,7 +1331,9 @@ message InspectContentResponse {
 // Cloud repository for storing output.
 message OutputStorageConfig {
   // Predefined schemas for storing findings.
+  // Only for use with external storage.
   enum OutputSchema {
+    // Unused.
     OUTPUT_SCHEMA_UNSPECIFIED = 0;
 
     // Basic schema including only `info_type`, `quote`, `certainty`, and
@@ -996,6 +1353,7 @@ message OutputStorageConfig {
     ALL_COLUMNS = 5;
   }
 
+  // Output storage types.
   oneof type {
     // Store findings in an existing table or a new table in an existing
     // dataset. If table_id is not set a new one will be generated
@@ -1023,6 +1381,7 @@ message OutputStorageConfig {
   // If unspecified, then all available columns will be used for a new table or
   // an (existing) table with no schema, and no changes will be made to an
   // existing table that has a schema.
+  // Only for use with external storage.
   OutputSchema output_schema = 3;
 }
 
@@ -1037,11 +1396,13 @@ message InfoTypeStats {
 
 // The results of an inspect DataSource job.
 message InspectDataSourceDetails {
+  // Snapshot of the inspection configuration.
   message RequestedOptions {
     // If run with an InspectTemplate, a snapshot of its state at the time of
     // this run.
     InspectTemplate snapshot_inspect_template = 1;
 
+    // Inspect config.
     InspectJobConfig job_config = 3;
   }
 
@@ -1056,6 +1417,12 @@ message InspectDataSourceDetails {
     // Statistics of how many instances of each info type were found during
     // inspect job.
     repeated InfoTypeStats info_type_stats = 3;
+
+    // Statistics related to the processing of hybrid inspect.
+    // Early access feature is in a pre-release state and might change or have
+    // limited support. For more information, see
+    // https://cloud.google.com/products#product-launch-stages.
+    HybridInspectStatistics hybrid_stats = 7;
   }
 
   // The configuration used for this job.
@@ -1065,6 +1432,23 @@ message InspectDataSourceDetails {
   Result result = 3;
 }
 
+// Statistics related to processing hybrid inspect requests.s
+message HybridInspectStatistics {
+  // The number of hybrid inspection requests processed within this job.
+  int64 processed_count = 1;
+
+  // The number of hybrid inspection requests aborted because the job ran
+  // out of quota or was ended before they could be processed.
+  int64 aborted_count = 2;
+
+  // The number of hybrid requests currently being processed. Only populated
+  // when called via method `getDlpJob`.
+  // A burst of traffic may cause hybrid inspect requests to be enqueued.
+  // Processing will take place as quickly as possible, but resource limitations
+  // may impact how long a request is enqueued for.
+  int64 pending_count = 3;
+}
+
 // InfoType description.
 message InfoTypeDescription {
   // Internal name of the infoType.
@@ -1083,14 +1467,19 @@ message InfoTypeDescription {
 
 // Request for the list of infoTypes.
 message ListInfoTypesRequest {
-  // Optional BCP-47 language code for localized infoType friendly
+  // The parent resource name, for example locations/{location_id}
+  string parent = 4;
+  // BCP-47 language code for localized infoType friendly
   // names. If omitted, or if localized strings are not available,
   // en-US strings will be returned.
   string language_code = 1;
 
-  // Optional filter to only return infoTypes supported by certain parts of the
+  // filter to only return infoTypes supported by certain parts of the
   // API. Defaults to supported_by=INSPECT.
   string filter = 2;
+
+  // Deprecated. This field has no effect.
+  string location_id = 3;
 }
 
 // Response to the ListInfoTypes request.
@@ -1115,8 +1504,8 @@ message RiskAnalysisJobConfig {
 
 // A column with a semantic tag attached.
 message QuasiId {
-  // Identifies the column. [required]
-  FieldId field = 1;
+  // Required. Identifies the column.
+  FieldId field = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Semantic tag that identifies what a column contains, to determine which
   // statistical model to use to estimate the reidentifiability of each
@@ -1151,21 +1540,25 @@ message StatisticalTable {
   // A quasi-identifier column has a custom_tag, used to know which column
   // in the data corresponds to which column in the statistical model.
   message QuasiIdentifierField {
+    // Identifies the column.
     FieldId field = 1;
 
+    // A column can be tagged with a custom tag. In this case, the user must
+    // indicate an auxiliary table that contains statistical information on
+    // the possible values of this column (below).
     string custom_tag = 2;
   }
 
-  // Auxiliary table location. [required]
-  BigQueryTable table = 3;
+  // Required. Auxiliary table location.
+  BigQueryTable table = 3 [(google.api.field_behavior) = REQUIRED];
 
-  // Quasi-identifier columns. [required]
-  repeated QuasiIdentifierField quasi_ids = 1;
+  // Required. Quasi-identifier columns.
+  repeated QuasiIdentifierField quasi_ids = 1
+      [(google.api.field_behavior) = REQUIRED];
 
-  // The relative frequency column must contain a floating-point number
-  // between 0 and 1 (inclusive). Null values are assumed to be zero.
-  // [required]
-  FieldId relative_frequency = 2;
+  // Required. The relative frequency column must contain a floating-point
+  // number between 0 and 1 (inclusive). Null values are assumed to be zero.
+  FieldId relative_frequency = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Privacy metric to compute for reidentification risk analysis.
@@ -1197,7 +1590,7 @@ message PrivacyMetric {
     // a repeated field.
     repeated FieldId quasi_ids = 1;
 
-    // Optional message indicating that multiple rows might be associated to a
+    // Message indicating that multiple rows might be associated to a
     // single individual. If the same entity_id is associated to multiple
     // quasi-identifier tuples over distinct rows, we consider the entire
     // collection of tuples as the composite quasi-identifier. This collection
@@ -1227,11 +1620,11 @@ message PrivacyMetric {
   // using publicly available data (like the US Census), or using a custom
   // statistical model (indicated as one or several BigQuery tables), or by
   // extrapolating from the distribution of values in the input dataset.
-  // A column with a semantic tag attached.
   message KMapEstimationConfig {
+    // A column with a semantic tag attached.
     message TaggedField {
-      // Identifies the column. [required]
-      FieldId field = 1;
+      // Required. Identifies the column.
+      FieldId field = 1 [(google.api.field_behavior) = REQUIRED];
 
       // Semantic tag that identifies what a column contains, to determine which
       // statistical model to use to estimate the reidentifiability of each
@@ -1266,29 +1659,31 @@ message PrivacyMetric {
       // A quasi-identifier column has a custom_tag, used to know which column
       // in the data corresponds to which column in the statistical model.
       message QuasiIdField {
+        // Identifies the column.
         FieldId field = 1;
 
+        // A auxiliary field.
         string custom_tag = 2;
       }
 
-      // Auxiliary table location. [required]
-      BigQueryTable table = 3;
+      // Required. Auxiliary table location.
+      BigQueryTable table = 3 [(google.api.field_behavior) = REQUIRED];
 
-      // Quasi-identifier columns. [required]
-      repeated QuasiIdField quasi_ids = 1;
+      // Required. Quasi-identifier columns.
+      repeated QuasiIdField quasi_ids = 1
+          [(google.api.field_behavior) = REQUIRED];
 
-      // The relative frequency column must contain a floating-point number
-      // between 0 and 1 (inclusive). Null values are assumed to be zero.
-      // [required]
-      FieldId relative_frequency = 2;
+      // Required. The relative frequency column must contain a floating-point
+      // number between 0 and 1 (inclusive). Null values are assumed to be zero.
+      FieldId relative_frequency = 2 [(google.api.field_behavior) = REQUIRED];
     }
 
-    // Fields considered to be quasi-identifiers. No two columns can have the
-    // same tag. [required]
-    repeated TaggedField quasi_ids = 1;
+    // Required. Fields considered to be quasi-identifiers. No two columns can
+    // have the same tag.
+    repeated TaggedField quasi_ids = 1 [(google.api.field_behavior) = REQUIRED];
 
     // ISO 3166-1 alpha-2 region code to use in the statistical modeling.
-    // Required if no column is tagged with a region-specific InfoType (like
+    // Set if no column is tagged with a region-specific InfoType (like
     // US_ZIP_5) or a region code.
     string region_code = 2;
 
@@ -1303,12 +1698,12 @@ message PrivacyMetric {
   // Similarly to the k-map metric, we cannot compute δ-presence exactly without
   // knowing the attack dataset, so we use a statistical model instead.
   message DeltaPresenceEstimationConfig {
-    // Fields considered to be quasi-identifiers. No two fields can have the
-    // same tag. [required]
-    repeated QuasiId quasi_ids = 1;
+    // Required. Fields considered to be quasi-identifiers. No two fields can
+    // have the same tag.
+    repeated QuasiId quasi_ids = 1 [(google.api.field_behavior) = REQUIRED];
 
     // ISO 3166-1 alpha-2 region code to use in the statistical modeling.
-    // Required if no column is tagged with a region-specific InfoType (like
+    // Set if no column is tagged with a region-specific InfoType (like
     // US_ZIP_5) or a region code.
     string region_code = 2;
 
@@ -1318,17 +1713,24 @@ message PrivacyMetric {
     repeated StatisticalTable auxiliary_tables = 3;
   }
 
+  // Types of analysis.
   oneof type {
+    // Numerical stats
     NumericalStatsConfig numerical_stats_config = 1;
 
+    // Categorical stats
     CategoricalStatsConfig categorical_stats_config = 2;
 
+    // K-anonymity
     KAnonymityConfig k_anonymity_config = 3;
 
+    // l-diversity
     LDiversityConfig l_diversity_config = 4;
 
+    // k-map
     KMapEstimationConfig k_map_estimation_config = 5;
 
+    // delta-presence
     DeltaPresenceEstimationConfig delta_presence_estimation_config = 6;
   }
 }
@@ -1350,6 +1752,7 @@ message AnalyzeDataSourceRiskDetails {
 
   // Result of the categorical stats computation.
   message CategoricalStatsResult {
+    // Histogram of value frequencies in the column.
     message CategoricalStatsHistogramBucket {
       // Lower bound on the value frequency of the values in this bucket.
       int64 value_frequency_lower_bound = 1;
@@ -1369,7 +1772,8 @@ message AnalyzeDataSourceRiskDetails {
     }
 
     // Histogram of value frequencies in the column.
-    repeated CategoricalStatsHistogramBucket value_frequency_histogram_buckets = 5;
+    repeated CategoricalStatsHistogramBucket value_frequency_histogram_buckets =
+        5;
   }
 
   // Result of the k-anonymity computation.
@@ -1386,6 +1790,7 @@ message AnalyzeDataSourceRiskDetails {
       int64 equivalence_class_size = 2;
     }
 
+    // Histogram of k-anonymity equivalence classes.
     message KAnonymityHistogramBucket {
       // Lower bound on the size of the equivalence classes in this bucket.
       int64 equivalence_class_size_lower_bound = 1;
@@ -1426,6 +1831,7 @@ message AnalyzeDataSourceRiskDetails {
       repeated ValueFrequency top_sensitive_values = 4;
     }
 
+    // Histogram of l-diversity equivalence class sensitive value frequencies.
     message LDiversityHistogramBucket {
       // Lower bound on the sensitive value frequencies of the equivalence
       // classes in this bucket.
@@ -1447,7 +1853,8 @@ message AnalyzeDataSourceRiskDetails {
     }
 
     // Histogram of l-diversity equivalence class sensitive value frequencies.
-    repeated LDiversityHistogramBucket sensitive_value_frequency_histogram_buckets = 5;
+    repeated LDiversityHistogramBucket
+        sensitive_value_frequency_histogram_buckets = 5;
   }
 
   // Result of the reidentifiability analysis. Note that these results are an
@@ -1564,16 +1971,22 @@ message AnalyzeDataSourceRiskDetails {
 
   // Values associated with this metric.
   oneof result {
+    // Numerical stats result
     NumericalStatsResult numerical_stats_result = 3;
 
+    // Categorical stats result
     CategoricalStatsResult categorical_stats_result = 4;
 
+    // K-anonymity result
     KAnonymityResult k_anonymity_result = 5;
 
+    // L-divesity result
     LDiversityResult l_diversity_result = 6;
 
+    // K-map result
     KMapEstimationResult k_map_estimation_result = 7;
 
+    // Delta-presence result
     DeltaPresenceEstimationResult delta_presence_estimation_result = 9;
   }
 }
@@ -1594,21 +2007,30 @@ message ValueFrequency {
 // 123456789, the number of bytes would be counted as 9, even though an
 // int64 only holds up to 8 bytes of data.
 message Value {
+  // Value types
   oneof type {
+    // integer
     int64 integer_value = 1;
 
+    // float
     double float_value = 2;
 
+    // string
     string string_value = 3;
 
+    // boolean
     bool boolean_value = 4;
 
+    // timestamp
     google.protobuf.Timestamp timestamp_value = 5;
 
+    // time of day
     google.type.TimeOfDay time_value = 6;
 
+    // date
     google.type.Date date_value = 7;
 
+    // day of week
     google.type.DayOfWeek day_of_week_value = 8;
   }
 }
@@ -1625,20 +2047,24 @@ message QuoteInfo {
 // Message for a date time object.
 // e.g. 2018-01-01, 5th August.
 message DateTime {
+  // Time zone of the date time object.
   message TimeZone {
     // Set only if the offset can be determined. Positive for time ahead of UTC.
     // E.g. For "UTC-9", this value is -540.
     int32 offset_minutes = 1;
   }
 
-  // One or more of the following must be set. All fields are optional, but
-  // when set must be valid date or time values.
+  // One or more of the following must be set.
+  // Must be a valid date or time value.
   google.type.Date date = 1;
 
+  // Day of week
   google.type.DayOfWeek day_of_week = 2;
 
+  // Time of day
   google.type.TimeOfDay time = 3;
 
+  // Time zone
   TimeZone time_zone = 4;
 }
 
@@ -1654,31 +2080,78 @@ message DeidentifyConfig {
     // a column within a table.
     RecordTransformations record_transformations = 2;
   }
+
+  // Mode for handling transformation errors. If left unspecified, the default
+  // mode is `TransformationErrorHandling.ThrowError`.
+  TransformationErrorHandling transformation_error_handling = 3;
+}
+
+// How to handle transformation errors during de-identification. A
+// transformation error occurs when the requested transformation is incompatible
+// with the data. For example, trying to de-identify an IP address using a
+// `DateShift` transformation would result in a transformation error, since date
+// info cannot be extracted from an IP address.
+// Information about any incompatible transformations, and how they were
+// handled, is returned in the response as part of the
+// `TransformationOverviews`.
+message TransformationErrorHandling {
+  // Throw an error and fail the request when a transformation error occurs.
+  message ThrowError {
+
+  }
+
+  // Skips the data without modifying it if the requested transformation would
+  // cause an error. For example, if a `DateShift` transformation were applied
+  // an an IP address, this mode would leave the IP address unchanged in the
+  // response.
+  message LeaveUntransformed {
+
+  }
+
+  // How transformation errors should be handled.
+  oneof mode {
+    // Throw an error
+    ThrowError throw_error = 1;
+
+    // Ignore errors
+    LeaveUntransformed leave_untransformed = 2;
+  }
 }
 
 // A rule for transforming a value.
 message PrimitiveTransformation {
   oneof transformation {
+    // Replace
     ReplaceValueConfig replace_config = 1;
 
+    // Redact
     RedactConfig redact_config = 2;
 
+    // Mask
     CharacterMaskConfig character_mask_config = 3;
 
+    // Ffx-Fpe
     CryptoReplaceFfxFpeConfig crypto_replace_ffx_fpe_config = 4;
 
+    // Fixed size bucketing
     FixedSizeBucketingConfig fixed_size_bucketing_config = 5;
 
+    // Bucketing
     BucketingConfig bucketing_config = 6;
 
+    // Replace with infotype
     ReplaceWithInfoTypeConfig replace_with_info_type_config = 7;
 
+    // Time extraction
     TimePartConfig time_part_config = 8;
 
+    // Crypto
     CryptoHashConfig crypto_hash_config = 9;
 
+    // Date Shift
     DateShiftConfig date_shift_config = 11;
 
+    // Deterministic Crypto
     CryptoDeterministicConfig crypto_deterministic_config = 12;
   }
 }
@@ -1686,7 +2159,9 @@ message PrimitiveTransformation {
 // For use with `Date`, `Timestamp`, and `TimeOfDay`, extract or preserve a
 // portion of the value.
 message TimePartConfig {
+  // Components that make up time.
   enum TimePart {
+    // Unused
     TIME_PART_UNSPECIFIED = 0;
 
     // [0-9999]
@@ -1701,13 +2176,14 @@ message TimePartConfig {
     // [1-7]
     DAY_OF_WEEK = 4;
 
-    // [1-52]
+    // [1-53]
     WEEK_OF_YEAR = 5;
 
     // [0-23]
     HOUR_OF_DAY = 6;
   }
 
+  // The part of the time to keep.
   TimePart part_to_extract = 1;
 }
 
@@ -1734,7 +2210,7 @@ message CryptoDeterministicConfig {
   // This annotation will be applied to the surrogate by prefixing it with
   // the name of the custom info type followed by the number of
   // characters comprising the surrogate. The following scheme defines the
-  // format: ():
+  // format: {info type name}({surrogate character count}):{surrogate}
   //
   // For example, if the name of custom info type is 'MY_TOKEN_INFO_TYPE' and
   // the surrogate is 'abc', the full replacement value
@@ -1744,6 +2220,11 @@ message CryptoDeterministicConfig {
   // custom info type 'Surrogate'. This facilitates reversal of the
   // surrogate when it occurs in free text.
   //
+  // Note: For record transformations where the entire cell in a table is being
+  // transformed, surrogates are not mandatory. Surrogates are used to denote
+  // the location of the token and are necessary for re-identification in free
+  // form text.
+  //
   // In order for inspection to work properly, the name of this info type must
   // not occur naturally anywhere in your data; otherwise, inspection may either
   //
@@ -1756,10 +2237,10 @@ message CryptoDeterministicConfig {
   // that are highly improbable to exist in your data.
   // For example, assuming your data is entered from a regular ASCII keyboard,
   // the symbol with the hex code point 29DD might be used like so:
-  // ⧝MY_TOKEN_TYPE
+  // ⧝MY_TOKEN_TYPE.
   InfoType surrogate_info_type = 2;
 
-  // Optional. A context may be used for higher security and maintaining
+  // A context may be used for higher security and maintaining
   // referential integrity such that the same identifier in two different
   // contexts will be given a distinct surrogate. The context is appended to
   // plaintext value being encrypted. On decryption the provided context is
@@ -1787,21 +2268,19 @@ message ReplaceValueConfig {
 }
 
 // Replace each matching finding with the name of the info_type.
-message ReplaceWithInfoTypeConfig {
-
-}
+message ReplaceWithInfoTypeConfig {}
 
 // Redact a given value. For example, if used with an `InfoTypeTransformation`
 // transforming PHONE_NUMBER, and input 'My phone number is 206-555-0123', the
 // output would be 'My phone number is '.
-message RedactConfig {
-
-}
+message RedactConfig {}
 
 // Characters to skip when doing deidentification of a value. These will be left
 // alone and skipped.
 message CharsToIgnore {
+  // Convenience enum for indication common characters to not transform.
   enum CommonCharsToIgnore {
+    // Unused.
     COMMON_CHARS_TO_IGNORE_UNSPECIFIED = 0;
 
     // 0-9
@@ -1821,8 +2300,11 @@ message CharsToIgnore {
   }
 
   oneof characters {
+    // Characters to not transform when masking.
     string characters_to_skip = 1;
 
+    // Common characters to not transform when masking. Useful to avoid removing
+    // punctuation.
     CommonCharsToIgnore common_characters_to_ignore = 2;
   }
 }
@@ -1834,10 +2316,10 @@ message CharsToIgnore {
 // type. (This allows you to take a long like 123 and modify it to a string like
 // **3.
 message CharacterMaskConfig {
-  // Character to mask the sensitive values—for example, "*" for an
-  // alphabetic string such as name, or "0" for a numeric string such as ZIP
-  // code or credit card number. String must have length 1. If not supplied, we
-  // will default to "*" for strings, 0 for digits.
+  // Character to use to mask the sensitive values—for example, `*` for an
+  // alphabetic string such as a name, or `0` for a numeric string such as ZIP
+  // code or credit card number. This string must have a length of 1. If not
+  // supplied, this value defaults to `*` for strings, and `0` for digits.
   string masking_character = 1;
 
   // Number of characters to mask. If not set, all matching chars will be
@@ -1845,15 +2327,16 @@ message CharacterMaskConfig {
   int32 number_to_mask = 2;
 
   // Mask characters in reverse order. For example, if `masking_character` is
-  // '0', number_to_mask is 14, and `reverse_order` is false, then
-  // 1234-5678-9012-3456 -> 00000000000000-3456
-  // If `masking_character` is '*', `number_to_mask` is 3, and `reverse_order`
-  // is true, then 12345 -> 12***
+  // `0`, `number_to_mask` is `14`, and `reverse_order` is `false`, then the
+  // input string `1234-5678-9012-3456` is masked as `00000000000000-3456`.
+  // If `masking_character` is `*`, `number_to_mask` is `3`, and `reverse_order`
+  // is `true`, then the string `12345` is masked as `12***`.
   bool reverse_order = 3;
 
-  // When masking a string, items in this list will be skipped when replacing.
-  // For example, if your string is 555-555-5555 and you ask us to skip `-` and
-  // mask 5 chars with * we would produce ***-*55-5555.
+  // When masking a string, items in this list will be skipped when replacing
+  // characters. For example, if the input string is `555-555-5555` and you
+  // instruct Cloud DLP to skip `-` and mask 5 characters with `*`, Cloud DLP
+  // returns `***-**5-5555`.
   repeated CharsToIgnore characters_to_ignore = 4;
 }
 
@@ -1863,7 +2346,7 @@ message CharacterMaskConfig {
 // the user for simple bucketing strategies.
 //
 // The transformed value will be a hyphenated string of
-// -, i.e if lower_bound = 10 and upper_bound = 20
+// {lower_bound}-{upper_bound}, i.e if lower_bound = 10 and upper_bound = 20
 // all values that are within this bucket will be replaced with "10-20".
 //
 // This can be used on data of type: double, long.
@@ -1874,22 +2357,21 @@ message CharacterMaskConfig {
 //
 // See https://cloud.google.com/dlp/docs/concepts-bucketing to learn more.
 message FixedSizeBucketingConfig {
-  // Lower bound value of buckets. All values less than `lower_bound` are
-  // grouped together into a single bucket; for example if `lower_bound` = 10,
-  // then all values less than 10 are replaced with the value “-10”. [Required].
-  Value lower_bound = 1;
-
-  // Upper bound value of buckets. All values greater than upper_bound are
-  // grouped together into a single bucket; for example if `upper_bound` = 89,
-  // then all values greater than 89 are replaced with the value “89+”.
-  // [Required].
-  Value upper_bound = 2;
-
-  // Size of each bucket (except for minimum and maximum buckets). So if
-  // `lower_bound` = 10, `upper_bound` = 89, and `bucket_size` = 10, then the
+  // Required. Lower bound value of buckets. All values less than `lower_bound`
+  // are grouped together into a single bucket; for example if `lower_bound` =
+  // 10, then all values less than 10 are replaced with the value “-10”.
+  Value lower_bound = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Upper bound value of buckets. All values greater than upper_bound
+  // are grouped together into a single bucket; for example if `upper_bound` =
+  // 89, then all values greater than 89 are replaced with the value “89+”.
+  Value upper_bound = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Size of each bucket (except for minimum and maximum buckets). So
+  // if `lower_bound` = 10, `upper_bound` = 89, and `bucket_size` = 10, then the
   // following buckets would be used: -10, 10-20, 20-30, 30-40, 40-50, 50-60,
-  // 60-70, 70-80, 80-89, 89+. Precision up to 2 decimals works. [Required].
-  double bucket_size = 3;
+  // 60-70, 70-80, 80-89, 89+. Precision up to 2 decimals works.
+  double bucket_size = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Generalization function that buckets values based on ranges. The ranges and
@@ -1938,6 +2420,7 @@ message CryptoReplaceFfxFpeConfig {
   // natively supports. In the algorithm, the alphabet is selected using
   // the "radix". Therefore each corresponds to particular radix.
   enum FfxCommonNativeAlphabet {
+    // Unused.
     FFX_COMMON_NATIVE_ALPHABET_UNSPECIFIED = 0;
 
     // [0-9] (radix of 10)
@@ -1953,8 +2436,8 @@ message CryptoReplaceFfxFpeConfig {
     ALPHA_NUMERIC = 4;
   }
 
-  // The key used by the encryption algorithm. [required]
-  CryptoKey crypto_key = 1;
+  // Required. The key used by the encryption algorithm.
+  CryptoKey crypto_key = 1 [(google.api.field_behavior) = REQUIRED];
 
   // The 'tweak', a context may be used for higher security since the same
   // identifier in two different contexts won't be given the same surrogate. If
@@ -1978,19 +2461,21 @@ message CryptoReplaceFfxFpeConfig {
   // - a string is encoded in UTF-8 format followed by a single byte of value 2
   FieldId context = 2;
 
+  // Choose an alphabet which the data being transformed will be made up of.
   oneof alphabet {
+    // Common alphabets.
     FfxCommonNativeAlphabet common_alphabet = 4;
 
     // This is supported by mapping these to the alphanumeric characters
     // that the FFX mode natively supports. This happens before/after
     // encryption/decryption.
     // Each character listed must appear only once.
-    // Number of characters must be in the range [2, 62].
+    // Number of characters must be in the range [2, 95].
     // This must be encoded as ASCII.
     // The order of characters does not matter.
     string custom_alphabet = 5;
 
-    // The native way to select the alphabet. Must be in the range [2, 62].
+    // The native way to select the alphabet. Must be in the range [2, 95].
     int32 radix = 6;
   }
 
@@ -2028,11 +2513,15 @@ message CryptoReplaceFfxFpeConfig {
 // IAM policy on the KMS CryptoKey (KEK) to ensure an attacker cannot
 // unwrap the data crypto key.
 message CryptoKey {
+  // Sources of crypto keys.
   oneof source {
+    // Transient crypto key
     TransientCryptoKey transient = 1;
 
+    // Unwrapped crypto key
     UnwrappedCryptoKey unwrapped = 2;
 
+    // Kms wrapped key
     KmsWrappedCryptoKey kms_wrapped = 3;
   }
 }
@@ -2040,31 +2529,20 @@ message CryptoKey {
 // Use this to have a random data crypto key generated.
 // It will be discarded after the request finishes.
 message TransientCryptoKey {
-  // Name of the key. [required]
+  // Required. Name of the key.
   // This is an arbitrary string used to differentiate different keys.
   // A unique key is generated per name: two separate `TransientCryptoKey`
   // protos share the same generated key if their names are the same.
   // When the data crypto key is generated, this name is not used in any way
   // (repeating the api call will result in a different key being generated).
-  string name = 1;
-}
-
-// Parts of the APIs which use certain infoTypes.
-enum InfoTypeSupportedBy {
-  ENUM_TYPE_UNSPECIFIED = 0;
-
-  // Supported by the inspect operations.
-  INSPECT = 1;
-
-  // Supported by the risk analysis operations.
-  RISK_ANALYSIS = 2;
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Using raw keys is prone to security risks due to accidentally
 // leaking the key. Choose another type of key if possible.
 message UnwrappedCryptoKey {
-  // A 128/192/256 bit key. [required]
-  bytes key = 1;
+  // Required. A 128/192/256 bit key.
+  bytes key = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Include to use an existing data crypto key wrapped by KMS.
@@ -2073,31 +2551,30 @@ message UnwrappedCryptoKey {
 // to perform a crypto transformation using a kms-wrapped crypto key:
 // dlp.kms.encrypt
 message KmsWrappedCryptoKey {
-  // The wrapped data crypto key. [required]
-  bytes wrapped_key = 1;
+  // Required. The wrapped data crypto key.
+  bytes wrapped_key = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // The resource name of the KMS CryptoKey to use for unwrapping. [required]
-  string crypto_key_name = 2;
+  // Required. The resource name of the KMS CryptoKey to use for unwrapping.
+  string crypto_key_name = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Shifts dates by random number of days, with option to be consistent for the
 // same context. See https://cloud.google.com/dlp/docs/concepts-date-shifting
 // to learn more.
 message DateShiftConfig {
-  // Range of shift in days. Actual shift will be selected at random within this
-  // range (inclusive ends). Negative means shift to earlier in time. Must not
-  // be more than 365250 days (1000 years) each direction.
+  // Required. Range of shift in days. Actual shift will be selected at random
+  // within this range (inclusive ends). Negative means shift to earlier in
+  // time. Must not be more than 365250 days (1000 years) each direction.
   //
   // For example, 3 means shift date to at most 3 days into the future.
-  // [Required]
-  int32 upper_bound_days = 1;
+  int32 upper_bound_days = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // For example, -5 means shift date to at most 5 days back in the past.
-  // [Required]
-  int32 lower_bound_days = 2;
+  // Required. For example, -5 means shift date to at most 5 days back in the
+  // past.
+  int32 lower_bound_days = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Points to the field that contains the context, for example, an entity id.
-  // If set, must also set method. If set, shift will be consistent for the
+  // If set, must also set cryptoKey. If set, shift will be consistent for the
   // given context.
   FieldId context = 3;
 
@@ -2105,7 +2582,8 @@ message DateShiftConfig {
   // set, must also set context. Can only be applied to table items.
   oneof method {
     // Causes the shift to be computed based on this key and the context. This
-    // results in the same shift for the same context and crypto_key.
+    // results in the same shift for the same context and crypto_key. If
+    // set, must also set context. Can only be applied to table items.
     CryptoKey crypto_key = 4;
   }
 }
@@ -2123,23 +2601,23 @@ message InfoTypeTransformations {
     // infoTypes that were requested in `InspectConfig`.
     repeated InfoType info_types = 1;
 
-    // Primitive transformation to apply to the infoType. [required]
-    PrimitiveTransformation primitive_transformation = 2;
+    // Required. Primitive transformation to apply to the infoType.
+    PrimitiveTransformation primitive_transformation = 2 [(google.api.field_behavior) = REQUIRED];
   }
 
-  // Transformation for each infoType. Cannot specify more than one
-  // for a given infoType. [required]
-  repeated InfoTypeTransformation transformations = 1;
+  // Required. Transformation for each infoType. Cannot specify more than one
+  // for a given infoType.
+  repeated InfoTypeTransformation transformations = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The transformation to apply to the field.
 message FieldTransformation {
-  // Input field(s) to apply the transformation to. [required]
-  repeated FieldId fields = 1;
+  // Required. Input field(s) to apply the transformation to.
+  repeated FieldId fields = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Only apply the transformation if the condition evaluates to true for the
   // given `RecordCondition`. The conditions are allowed to reference fields
-  // that are not used in the actual transformation. [optional]
+  // that are not used in the actual transformation.
   //
   // Example Use Cases:
   //
@@ -2166,7 +2644,7 @@ message RecordTransformations {
   repeated FieldTransformation field_transformations = 1;
 
   // Configuration defining which records get suppressed entirely. Records that
-  // match any suppression rule are omitted from the output [optional].
+  // match any suppression rule are omitted from the output.
   repeated RecordSuppression record_suppressions = 2;
 }
 
@@ -2201,26 +2679,30 @@ message RecordCondition {
   // If we fail to compare do to type mismatch, a warning will be given and
   // the condition will evaluate to false.
   message Condition {
-    // Field within the record this condition is evaluated against. [required]
-    FieldId field = 1;
+    // Required. Field within the record this condition is evaluated against.
+    FieldId field = 1 [(google.api.field_behavior) = REQUIRED];
 
-    // Operator used to compare the field or infoType to the value. [required]
-    RelationalOperator operator = 3;
+    // Required. Operator used to compare the field or infoType to the value.
+    RelationalOperator operator = 3 [(google.api.field_behavior) = REQUIRED];
 
-    // Value to compare against. [Required, except for `EXISTS` tests.]
+    // Value to compare against. [Mandatory, except for `EXISTS` tests.]
     Value value = 4;
   }
 
   // A collection of conditions.
   message Conditions {
+    // A collection of conditions.
     repeated Condition conditions = 1;
   }
 
   // An expression, consisting or an operator and conditions.
   message Expressions {
+    // Logical operators for conditional checks.
     enum LogicalOperator {
+      // Unused
       LOGICAL_OPERATOR_UNSPECIFIED = 0;
 
+      // Conditional AND
       AND = 1;
     }
 
@@ -2228,7 +2710,9 @@ message RecordCondition {
     // only supported value is `AND`.
     LogicalOperator logical_operator = 1;
 
+    // Expression types.
     oneof type {
+      // Conditions to apply to the expression.
       Conditions conditions = 3;
     }
   }
@@ -2253,8 +2737,10 @@ message TransformationSummary {
   // A collection that informs the user the number of times a particular
   // `TransformationResultCode` and error details occurred.
   message SummaryResult {
+    // Number of transformations counted by this result.
     int64 count = 1;
 
+    // Outcome of the transformation.
     TransformationResultCode code = 2;
 
     // A place for warnings or errors to show up if a transformation didn't
@@ -2264,10 +2750,13 @@ message TransformationSummary {
 
   // Possible outcomes of transformations.
   enum TransformationResultCode {
+    // Unused
     TRANSFORMATION_RESULT_CODE_UNSPECIFIED = 0;
 
+    // Transformation completed without an error.
     SUCCESS = 1;
 
+    // Transformation had an error.
     ERROR = 2;
   }
 
@@ -2288,6 +2777,7 @@ message TransformationSummary {
   // The specific suppression option these stats apply to.
   RecordSuppression record_suppress = 6;
 
+  // Collection of all transformations that took place or had an error.
   repeated SummaryResult results = 4;
 
   // Total size in bytes that were transformed in some way.
@@ -2309,17 +2799,31 @@ message Schedule {
   }
 }
 
+// Job trigger option for hybrid jobs. Jobs must be manually created
+// and finished.
+message Manual {
+
+}
+
 // The inspectTemplate contains a configuration (set of types of sensitive data
 // to be detected) to be used anywhere you otherwise would normally specify
 // InspectConfig. See https://cloud.google.com/dlp/docs/concepts-templates
 // to learn more.
 message InspectTemplate {
-  // The template name. Output only.
+  option (google.api.resource) = {
+    type: "dlp.googleapis.com/InspectTemplate"
+    pattern: "organizations/{organization}/inspectTemplates/{inspect_template}"
+    pattern: "projects/{project}/inspectTemplates/{inspect_template}"
+    pattern: "organizations/{organization}/locations/{location}/inspectTemplates/{inspect_template}"
+    pattern: "projects/{project}/locations/{location}/inspectTemplates/{inspect_template}"
+  };
+
+  // Output only. The template name.
   //
   // The template will have one of the following formats:
   // `projects/PROJECT_ID/inspectTemplates/TEMPLATE_ID` OR
-  // `organizations/ORGANIZATION_ID/inspectTemplates/TEMPLATE_ID`
-  string name = 1;
+  // `organizations/ORGANIZATION_ID/inspectTemplates/TEMPLATE_ID`;
+  string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Display name (max 256 chars).
   string display_name = 2;
@@ -2327,25 +2831,33 @@ message InspectTemplate {
   // Short description (max 256 chars).
   string description = 3;
 
-  // The creation timestamp of a inspectTemplate, output only field.
-  google.protobuf.Timestamp create_time = 4;
+  // Output only. The creation timestamp of an inspectTemplate.
+  google.protobuf.Timestamp create_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // The last update timestamp of a inspectTemplate, output only field.
-  google.protobuf.Timestamp update_time = 5;
+  // Output only. The last update timestamp of an inspectTemplate.
+  google.protobuf.Timestamp update_time = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // The core content of the template. Configuration of the scanning process.
   InspectConfig inspect_config = 6;
 }
 
-// The DeidentifyTemplates contains instructions on how to deidentify content.
+// DeidentifyTemplates contains instructions on how to de-identify content.
 // See https://cloud.google.com/dlp/docs/concepts-templates to learn more.
 message DeidentifyTemplate {
-  // The template name. Output only.
+  option (google.api.resource) = {
+    type: "dlp.googleapis.com/DeidentifyTemplate"
+    pattern: "organizations/{organization}/deidentifyTemplates/{deidentify_template}"
+    pattern: "projects/{project}/deidentifyTemplates/{deidentify_template}"
+    pattern: "organizations/{organization}/locations/{location}/deidentifyTemplates/{deidentify_template}"
+    pattern: "projects/{project}/locations/{location}/deidentifyTemplates/{deidentify_template}"
+  };
+
+  // Output only. The template name.
   //
   // The template will have one of the following formats:
   // `projects/PROJECT_ID/deidentifyTemplates/TEMPLATE_ID` OR
   // `organizations/ORGANIZATION_ID/deidentifyTemplates/TEMPLATE_ID`
-  string name = 1;
+  string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Display name (max 256 chars).
   string display_name = 2;
@@ -2353,11 +2865,11 @@ message DeidentifyTemplate {
   // Short description (max 256 chars).
   string description = 3;
 
-  // The creation timestamp of a inspectTemplate, output only field.
-  google.protobuf.Timestamp create_time = 4;
+  // Output only. The creation timestamp of an inspectTemplate.
+  google.protobuf.Timestamp create_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // The last update timestamp of a inspectTemplate, output only field.
-  google.protobuf.Timestamp update_time = 5;
+  // Output only. The last update timestamp of an inspectTemplate.
+  google.protobuf.Timestamp update_time = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // ///////////// // The core content of the template  // ///////////////
   DeidentifyConfig deidentify_config = 6;
@@ -2365,8 +2877,8 @@ message DeidentifyTemplate {
 
 // Details information about an error encountered during job execution or
 // the results of an unsuccessful activation of the JobTrigger.
-// Output only field.
 message Error {
+  // Detailed error codes and messages.
   google.rpc.Status details = 1;
 
   // The times the error occurred.
@@ -2376,11 +2888,23 @@ message Error {
 // Contains a configuration to make dlp api calls on a repeating basis.
 // See https://cloud.google.com/dlp/docs/concepts-job-triggers to learn more.
 message JobTrigger {
+  option (google.api.resource) = {
+    type: "dlp.googleapis.com/JobTrigger"
+    pattern: "projects/{project}/jobTriggers/{job_trigger}"
+    pattern: "projects/{project}/locations/{location}/jobTriggers/{job_trigger}"
+  };
+
   // What event needs to occur for a new job to be started.
   message Trigger {
     oneof trigger {
       // Create a job on a repeating basis based on the elapse of time.
       Schedule schedule = 1;
+
+      // For use with hybrid jobs. Jobs must be manually created and finished.
+      // Early access feature is in a pre-release state and might change or have
+      // limited support. For more information, see
+      // https://cloud.google.com/products#product-launch-stages.
+      Manual manual = 2;
     }
   }
 
@@ -2389,6 +2913,7 @@ message JobTrigger {
   // pause triggers experiencing frequent errors. To restart a job, set the
   // status to HEALTHY after correcting user errors.
   enum Status {
+    // Unused.
     STATUS_UNSPECIFIED = 0;
 
     // Trigger is healthy.
@@ -2403,7 +2928,7 @@ message JobTrigger {
 
   // Unique resource name for the triggeredJob, assigned by the service when the
   // triggeredJob is created, for example
-  // `projects/dlp-test-project/triggeredJobs/53234423`.
+  // `projects/dlp-test-project/jobTriggers/53234423`.
   string name = 1;
 
   // Display name (max 100 chars)
@@ -2414,6 +2939,7 @@ message JobTrigger {
 
   // The configuration details for the specific type of job to run.
   oneof job {
+    // For inspect jobs, a snapshot of the configuration.
     InspectJobConfig inspect_job = 4;
   }
 
@@ -2422,23 +2948,23 @@ message JobTrigger {
   // a single Schedule trigger and must have at least one object.
   repeated Trigger triggers = 5;
 
-  // A stream of errors encountered when the trigger was activated. Repeated
+  // Output only. A stream of errors encountered when the trigger was activated. Repeated
   // errors may result in the JobTrigger automatically being paused.
   // Will return the last 100 errors. Whenever the JobTrigger is modified
-  // this list will be cleared. Output only field.
-  repeated Error errors = 6;
+  // this list will be cleared.
+  repeated Error errors = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // The creation timestamp of a triggeredJob, output only field.
-  google.protobuf.Timestamp create_time = 7;
+  // Output only. The creation timestamp of a triggeredJob.
+  google.protobuf.Timestamp create_time = 7 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // The last update timestamp of a triggeredJob, output only field.
-  google.protobuf.Timestamp update_time = 8;
+  // Output only. The last update timestamp of a triggeredJob.
+  google.protobuf.Timestamp update_time = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // The timestamp of the last time this trigger executed, output only field.
-  google.protobuf.Timestamp last_run_time = 9;
+  // Output only. The timestamp of the last time this trigger executed.
+  google.protobuf.Timestamp last_run_time = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // A status for this trigger. [required]
-  Status status = 10;
+  // Required. A status for this trigger.
+  Status status = 10 [(google.api.field_behavior) = REQUIRED];
 }
 
 // A task to execute on the completion of a job.
@@ -2449,6 +2975,7 @@ message Action {
   // specified.
   // Compatible with: Inspect, Risk
   message SaveFindings {
+    // Location to store findings outside of DLP.
     OutputStorageConfig output_config = 1;
   }
 
@@ -2499,6 +3026,14 @@ message Action {
 
   }
 
+  // Enable Stackdriver metric dlp.googleapis.com/finding_count. This
+  // will publish a metric to stack driver on each infotype requested and
+  // how many findings were found for it. CustomDetectors will be bucketed
+  // as 'Custom' under the Stackdriver label 'info_type'.
+  message PublishToStackdriver {
+
+  }
+
   oneof action {
     // Save resulting findings in a provided location.
     SaveFindings save_findings = 1;
@@ -2512,34 +3047,50 @@ message Action {
     // Publish findings to Cloud Datahub.
     PublishFindingsToCloudDataCatalog publish_findings_to_cloud_data_catalog = 5;
 
-    // Enable email notification to project owners and editors on job's
+    // Enable email notification for project owners and editors on job's
     // completion/failure.
     JobNotificationEmails job_notification_emails = 8;
+
+    // Enable Stackdriver metric dlp.googleapis.com/finding_count.
+    PublishToStackdriver publish_to_stackdriver = 9;
   }
 }
 
 // Request message for CreateInspectTemplate.
 message CreateInspectTemplateRequest {
-  // The parent resource name, for example projects/my-project-id or
-  // organizations/my-org-id.
-  string parent = 1;
+  // Required. The parent resource name, for example projects/my-project-id or
+  // organizations/my-org-id or projects/my-project-id/locations/{location-id}.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "dlp.googleapis.com/InspectTemplate"
+    }
+  ];
 
-  // The InspectTemplate to create.
-  InspectTemplate inspect_template = 2;
+  // Required. The InspectTemplate to create.
+  InspectTemplate inspect_template = 2 [(google.api.field_behavior) = REQUIRED];
 
   // The template id can contain uppercase and lowercase letters,
   // numbers, and hyphens; that is, it must match the regular
   // expression: `[a-zA-Z\\d-_]+`. The maximum length is 100
   // characters. Can be empty to allow the system to generate one.
   string template_id = 3;
+
+  // Deprecated. This field has no effect.
+  string location_id = 4;
 }
 
 // Request message for UpdateInspectTemplate.
 message UpdateInspectTemplateRequest {
-  // Resource name of organization and inspectTemplate to be updated, for
-  // example `organizations/433245324/inspectTemplates/432452342` or
+  // Required. Resource name of organization and inspectTemplate to be updated,
+  // for example `organizations/433245324/inspectTemplates/432452342` or
   // projects/project-id/inspectTemplates/432452342.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "dlp.googleapis.com/InspectTemplate"
+    }
+  ];
 
   // New InspectTemplate value.
   InspectTemplate inspect_template = 2;
@@ -2550,27 +3101,37 @@ message UpdateInspectTemplateRequest {
 
 // Request message for GetInspectTemplate.
 message GetInspectTemplateRequest {
-  // Resource name of the organization and inspectTemplate to be read, for
-  // example `organizations/433245324/inspectTemplates/432452342` or
+  // Required. Resource name of the organization and inspectTemplate to be read,
+  // for example `organizations/433245324/inspectTemplates/432452342` or
   // projects/project-id/inspectTemplates/432452342.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "dlp.googleapis.com/InspectTemplate"
+    }
+  ];
 }
 
 // Request message for ListInspectTemplates.
 message ListInspectTemplatesRequest {
-  // The parent resource name, for example projects/my-project-id or
-  // organizations/my-org-id.
-  string parent = 1;
+  // Required. The parent resource name, for example projects/my-project-id or
+  // organizations/my-org-id or projects/my-project-id/locations/{location_id}.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "dlp.googleapis.com/InspectTemplate"
+    }
+  ];
 
-  // Optional page token to continue retrieval. Comes from previous call
+  // Page token to continue retrieval. Comes from previous call
   // to `ListInspectTemplates`.
   string page_token = 2;
 
-  // Optional size of the page, can be limited by server. If zero server returns
+  // Size of the page, can be limited by server. If zero server returns
   // a page of max size 100.
   int32 page_size = 3;
 
-  // Optional comma separated list of fields to order by,
+  // Comma separated list of fields to order by,
   // followed by `asc` or `desc` postfix. This list is case-insensitive,
   // default sorting order is ascending, redundant space characters are
   // insignificant.
@@ -2584,6 +3145,9 @@ message ListInspectTemplatesRequest {
   // - `name`: corresponds to template's name.
   // - `display_name`: corresponds to template's display name.
   string order_by = 4;
+
+  // Deprecated. This field has no effect.
+  string location_id = 5;
 }
 
 // Response message for ListInspectTemplates.
@@ -2598,39 +3162,59 @@ message ListInspectTemplatesResponse {
 
 // Request message for DeleteInspectTemplate.
 message DeleteInspectTemplateRequest {
-  // Resource name of the organization and inspectTemplate to be deleted, for
-  // example `organizations/433245324/inspectTemplates/432452342` or
-  // projects/project-id/inspectTemplates/432452342.
-  string name = 1;
+  // Required. Resource name of the organization and inspectTemplate to be
+  // deleted, for example `organizations/433245324/inspectTemplates/432452342`
+  // or projects/project-id/inspectTemplates/432452342.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "dlp.googleapis.com/InspectTemplate"
+    }
+  ];
 }
 
 // Request message for CreateJobTrigger.
 message CreateJobTriggerRequest {
-  // The parent resource name, for example projects/my-project-id.
-  string parent = 1;
+  // Required. The parent resource name, for example projects/my-project-id
+  // or projects/my-project-id/locations/{location_id}.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
-  // The JobTrigger to create.
-  JobTrigger job_trigger = 2;
+  // Required. The JobTrigger to create.
+  JobTrigger job_trigger = 2 [(google.api.field_behavior) = REQUIRED];
 
   // The trigger id can contain uppercase and lowercase letters,
   // numbers, and hyphens; that is, it must match the regular
   // expression: `[a-zA-Z\\d-_]+`. The maximum length is 100
   // characters. Can be empty to allow the system to generate one.
   string trigger_id = 3;
+
+  // Deprecated. This field has no effect.
+  string location_id = 4;
 }
 
 // Request message for ActivateJobTrigger.
 message ActivateJobTriggerRequest {
-  // Resource name of the trigger to activate, for example
+  // Required. Resource name of the trigger to activate, for example
   // `projects/dlp-test-project/jobTriggers/53234423`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "dlp.googleapis.com/JobTrigger" }
+  ];
 }
 
 // Request message for UpdateJobTrigger.
 message UpdateJobTriggerRequest {
-  // Resource name of the project and the triggeredJob, for example
+  // Required. Resource name of the project and the triggeredJob, for example
   // `projects/dlp-test-project/jobTriggers/53234423`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "dlp.googleapis.com/JobTrigger" }
+  ];
 
   // New JobTrigger value.
   JobTrigger job_trigger = 2;
@@ -2641,22 +3225,33 @@ message UpdateJobTriggerRequest {
 
 // Request message for GetJobTrigger.
 message GetJobTriggerRequest {
-  // Resource name of the project and the triggeredJob, for example
+  // Required. Resource name of the project and the triggeredJob, for example
   // `projects/dlp-test-project/jobTriggers/53234423`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "dlp.googleapis.com/JobTrigger" }
+  ];
 }
 
 // Request message for CreateDlpJobRequest. Used to initiate long running
 // jobs such as calculating risk metrics or inspecting Google Cloud
 // Storage.
 message CreateDlpJobRequest {
-  // The parent resource name, for example projects/my-project-id.
-  string parent = 1;
+  // Required. The parent resource name, for example projects/my-project-id
+  // or projects/my-project-id/locations/{location_id}.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
   // The configuration details for the specific type of job to run.
   oneof job {
+    // Set to control what and how to inspect.
     InspectJobConfig inspect_job = 2;
 
+    // Set to choose what metric to calculate.
     RiskAnalysisJobConfig risk_job = 3;
   }
 
@@ -2665,22 +3260,31 @@ message CreateDlpJobRequest {
   // expression: `[a-zA-Z\\d-_]+`. The maximum length is 100
   // characters. Can be empty to allow the system to generate one.
   string job_id = 4;
+
+  // Deprecated. This field has no effect.
+  string location_id = 5;
 }
 
 // Request message for ListJobTriggers.
 message ListJobTriggersRequest {
-  // The parent resource name, for example `projects/my-project-id`.
-  string parent = 1;
+  // Required. The parent resource name, for example `projects/my-project-id`
+  // or projects/my-project-id/locations/{location_id}.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
-  // Optional page token to continue retrieval. Comes from previous call
+  // Page token to continue retrieval. Comes from previous call
   // to ListJobTriggers. `order_by` field must not
   // change for subsequent calls.
   string page_token = 2;
 
-  // Optional size of the page, can be limited by a server.
+  // Size of the page, can be limited by a server.
   int32 page_size = 3;
 
-  // Optional comma separated list of triggeredJob fields to order by,
+  // Comma separated list of triggeredJob fields to order by,
   // followed by `asc` or `desc` postfix. This list is case-insensitive,
   // default sorting order is ascending, redundant space characters are
   // insignificant.
@@ -2697,14 +3301,14 @@ message ListJobTriggersRequest {
   // - `status`: corresponds to JobTrigger's status.
   string order_by = 4;
 
-  // Optional. Allows filtering.
+  // Allows filtering.
   //
   // Supported syntax:
   //
   // * Filter expressions are made up of one or more restrictions.
   // * Restrictions can be combined by `AND` or `OR` logical operators. A
   // sequence of restrictions implicitly uses `AND`.
-  // * A restriction has the form of `  `.
+  // * A restriction has the form of `{field} {operator} {value}`.
   // * Supported fields/values for inspect jobs:
   //     - `status` - HEALTHY|PAUSED|CANCELLED
   //     - `inspected_storage` - DATASTORE|CLOUD_STORAGE|BIGQUERY
@@ -2722,6 +3326,9 @@ message ListJobTriggersRequest {
   //
   // The length of this field should be no more than 500 characters.
   string filter = 5;
+
+  // Deprecated. This field has no effect.
+  string location_id = 7;
 }
 
 // Response message for ListJobTriggers.
@@ -2736,11 +3343,15 @@ message ListJobTriggersResponse {
 
 // Request message for DeleteJobTrigger.
 message DeleteJobTriggerRequest {
-  // Resource name of the project and the triggeredJob, for example
+  // Required. Resource name of the project and the triggeredJob, for example
   // `projects/dlp-test-project/jobTriggers/53234423`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "dlp.googleapis.com/JobTrigger" }
+  ];
 }
 
+// Controls what and how to inspect for findings.
 message InspectJobConfig {
   // The data to scan.
   StorageConfig storage_config = 1;
@@ -2759,13 +3370,22 @@ message InspectJobConfig {
 
 // Combines all of the information about a DLP job.
 message DlpJob {
+  option (google.api.resource) = {
+    type: "dlp.googleapis.com/DlpJob"
+    pattern: "projects/{project}/dlpJobs/{dlp_job}"
+    pattern: "projects/{project}/locations/{location}/dlpJobs/{dlp_job}"
+  };
+
+  // Possible states of a job. New items may be added.
   enum JobState {
+    // Unused.
     JOB_STATE_UNSPECIFIED = 0;
 
     // The job has not yet started.
     PENDING = 1;
 
-    // The job is currently running.
+    // The job is currently running. Once a job has finished it will transition
+    // to FAILED or DONE.
     RUNNING = 2;
 
     // The job is no longer running.
@@ -2776,6 +3396,12 @@ message DlpJob {
 
     // The job had an error and did not complete.
     FAILED = 5;
+
+    // The job is currently accepting findings via hybridInspect.
+    // A hybrid job in ACTIVE state may continue to have findings added to it
+    // through calling of hybridInspect. After the job has finished no more
+    // calls to hybridInspect may be made. ACTIVE jobs can transition to DONE.
+    ACTIVE = 6;
   }
 
   // The server-assigned name.
@@ -2812,51 +3438,34 @@ message DlpJob {
   repeated Error errors = 11;
 }
 
-// Operators available for comparing the value of fields.
-enum RelationalOperator {
-  RELATIONAL_OPERATOR_UNSPECIFIED = 0;
-
-  // Equal. Attempts to match even with incompatible types.
-  EQUAL_TO = 1;
-
-  // Not equal to. Attempts to match even with incompatible types.
-  NOT_EQUAL_TO = 2;
-
-  // Greater than.
-  GREATER_THAN = 3;
-
-  // Less than.
-  LESS_THAN = 4;
-
-  // Greater than or equals.
-  GREATER_THAN_OR_EQUALS = 5;
-
-  // Less than or equals.
-  LESS_THAN_OR_EQUALS = 6;
-
-  // Exists
-  EXISTS = 7;
-}
-
 // The request message for [DlpJobs.GetDlpJob][].
 message GetDlpJobRequest {
-  // The name of the DlpJob resource.
-  string name = 1;
+  // Required. The name of the DlpJob resource.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "dlp.googleapis.com/DlpJob" }
+  ];
 }
 
 // The request message for listing DLP jobs.
 message ListDlpJobsRequest {
-  // The parent resource name, for example projects/my-project-id.
-  string parent = 4;
+  // Required. The parent resource name, for example projects/my-project-id
+  // or projects/my-project-id/locations/{location_id}.
+  string parent = 4 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
-  // Optional. Allows filtering.
+  // Allows filtering.
   //
   // Supported syntax:
   //
   // * Filter expressions are made up of one or more restrictions.
   // * Restrictions can be combined by `AND` or `OR` logical operators. A
   // sequence of restrictions implicitly uses `AND`.
-  // * A restriction has the form of `  `.
+  // * A restriction has the form of `{field} {operator} {value}`.
   // * Supported fields/values for inspect jobs:
   //     - `state` - PENDING|RUNNING|CANCELED|FINISHED|FAILED
   //     - `inspected_storage` - DATASTORE|CLOUD_STORAGE|BIGQUERY
@@ -2888,7 +3497,7 @@ message ListDlpJobsRequest {
   // The type of job. Defaults to `DlpJobType.INSPECT`
   DlpJobType type = 5;
 
-  // Optional comma separated list of fields to order by,
+  // Comma separated list of fields to order by,
   // followed by `asc` or `desc` postfix. This list is case-insensitive,
   // default sorting order is ascending, redundant space characters are
   // insignificant.
@@ -2902,6 +3511,9 @@ message ListDlpJobsRequest {
   // - `name`: corresponds to job's name.
   // - `state`: corresponds to `state`
   string order_by = 6;
+
+  // Deprecated. This field has no effect.
+  string location_id = 7;
 }
 
 // The response message for listing DLP jobs.
@@ -2915,38 +3527,68 @@ message ListDlpJobsResponse {
 
 // The request message for canceling a DLP job.
 message CancelDlpJobRequest {
-  // The name of the DlpJob resource to be cancelled.
-  string name = 1;
+  // Required. The name of the DlpJob resource to be cancelled.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "dlp.googleapis.com/DlpJob" }
+  ];
+}
+
+// The request message for finishing a DLP hybrid job.
+message FinishDlpJobRequest {
+  // Required. The name of the DlpJob resource to be cancelled.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "dlp.googleapis.com/DlpJob" }
+  ];
 }
 
 // The request message for deleting a DLP job.
 message DeleteDlpJobRequest {
-  // The name of the DlpJob resource to be deleted.
-  string name = 1;
+  // Required. The name of the DlpJob resource to be deleted.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "dlp.googleapis.com/DlpJob" }
+  ];
 }
 
 // Request message for CreateDeidentifyTemplate.
 message CreateDeidentifyTemplateRequest {
-  // The parent resource name, for example projects/my-project-id or
-  // organizations/my-org-id.
-  string parent = 1;
+  // Required. The parent resource name, for example projects/my-project-id or
+  // organizations/my-org-id or projects/my-project-id/locations/{location_id}.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "dlp.googleapis.com/DeidentifyTemplate"
+    }
+  ];
 
-  // The DeidentifyTemplate to create.
-  DeidentifyTemplate deidentify_template = 2;
+  // Required. The DeidentifyTemplate to create.
+  DeidentifyTemplate deidentify_template = 2
+      [(google.api.field_behavior) = REQUIRED];
 
   // The template id can contain uppercase and lowercase letters,
   // numbers, and hyphens; that is, it must match the regular
   // expression: `[a-zA-Z\\d-_]+`. The maximum length is 100
   // characters. Can be empty to allow the system to generate one.
   string template_id = 3;
+
+  // Deprecated. This field has no effect.
+  string location_id = 4;
 }
 
 // Request message for UpdateDeidentifyTemplate.
 message UpdateDeidentifyTemplateRequest {
-  // Resource name of organization and deidentify template to be updated, for
-  // example `organizations/433245324/deidentifyTemplates/432452342` or
+  // Required. Resource name of organization and deidentify template to be
+  // updated, for example
+  // `organizations/433245324/deidentifyTemplates/432452342` or
   // projects/project-id/deidentifyTemplates/432452342.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "dlp.googleapis.com/DeidentifyTemplate"
+    }
+  ];
 
   // New DeidentifyTemplate value.
   DeidentifyTemplate deidentify_template = 2;
@@ -2957,27 +3599,37 @@ message UpdateDeidentifyTemplateRequest {
 
 // Request message for GetDeidentifyTemplate.
 message GetDeidentifyTemplateRequest {
-  // Resource name of the organization and deidentify template to be read, for
-  // example `organizations/433245324/deidentifyTemplates/432452342` or
-  // projects/project-id/deidentifyTemplates/432452342.
-  string name = 1;
+  // Required. Resource name of the organization and deidentify template to be
+  // read, for example `organizations/433245324/deidentifyTemplates/432452342`
+  // or projects/project-id/deidentifyTemplates/432452342.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "dlp.googleapis.com/DeidentifyTemplate"
+    }
+  ];
 }
 
 // Request message for ListDeidentifyTemplates.
 message ListDeidentifyTemplatesRequest {
-  // The parent resource name, for example projects/my-project-id or
-  // organizations/my-org-id.
-  string parent = 1;
+  // Required. The parent resource name, for example projects/my-project-id or
+  // organizations/my-org-id or projects/my-project-id/locations/{location_id}.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "dlp.googleapis.com/DeidentifyTemplate"
+    }
+  ];
 
-  // Optional page token to continue retrieval. Comes from previous call
+  // Page token to continue retrieval. Comes from previous call
   // to `ListDeidentifyTemplates`.
   string page_token = 2;
 
-  // Optional size of the page, can be limited by server. If zero server returns
+  // Size of the page, can be limited by server. If zero server returns
   // a page of max size 100.
   int32 page_size = 3;
 
-  // Optional comma separated list of fields to order by,
+  // Comma separated list of fields to order by,
   // followed by `asc` or `desc` postfix. This list is case-insensitive,
   // default sorting order is ascending, redundant space characters are
   // insignificant.
@@ -2991,6 +3643,9 @@ message ListDeidentifyTemplatesRequest {
   // - `name`: corresponds to template's name.
   // - `display_name`: corresponds to template's display name.
   string order_by = 4;
+
+  // Deprecated. This field has no effect.
+  string location_id = 5;
 }
 
 // Response message for ListDeidentifyTemplates.
@@ -3006,10 +3661,16 @@ message ListDeidentifyTemplatesResponse {
 
 // Request message for DeleteDeidentifyTemplate.
 message DeleteDeidentifyTemplateRequest {
-  // Resource name of the organization and deidentify template to be deleted,
-  // for example `organizations/433245324/deidentifyTemplates/432452342` or
+  // Required. Resource name of the organization and deidentify template to be
+  // deleted, for example
+  // `organizations/433245324/deidentifyTemplates/432452342` or
   // projects/project-id/deidentifyTemplates/432452342.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "dlp.googleapis.com/DeidentifyTemplate"
+    }
+  ];
 }
 
 // Configuration for a custom dictionary created from a data source of any size
@@ -3040,7 +3701,9 @@ message LargeCustomDictionaryStats {
   int64 approx_num_phrases = 1;
 }
 
-// Configuration for a StoredInfoType.
+// Configuration for stored infoTypes. All fields and subfield are provided
+// by the user. For more information, see
+// https://cloud.google.com/dlp/docs/creating-custom-infotypes.
 message StoredInfoTypeConfig {
   // Display name of the StoredInfoType (max 256 characters).
   string display_name = 1;
@@ -3048,14 +3711,22 @@ message StoredInfoTypeConfig {
   // Description of the StoredInfoType (max 256 characters).
   string description = 2;
 
+  // Stored infotype types.
   oneof type {
     // StoredInfoType where findings are defined by a dictionary of phrases.
     LargeCustomDictionaryConfig large_custom_dictionary = 3;
+
+    // Store dictionary-based CustomInfoType.
+    CustomInfoType.Dictionary dictionary = 4;
+
+    // Store regular expression-based StoredInfoType.
+    CustomInfoType.Regex regex = 5;
   }
 }
 
 // Statistics for a StoredInfoType.
 message StoredInfoTypeStats {
+  // Stat types
   oneof type {
     // StoredInfoType where findings are defined by a dictionary of phrases.
     LargeCustomDictionaryStats large_custom_dictionary = 1;
@@ -3080,10 +3751,12 @@ message StoredInfoTypeVersion {
   // anomalies detected in the storedInfoType data that render it unusable. Only
   // the five most recent errors will be displayed, with the most recent error
   // appearing first.
-  // 
For example, some of the data for stored custom dictionaries is put in
+  //
+  // For example, some of the data for stored custom dictionaries is put in
   // the user's Google Cloud Storage bucket, and if this data is modified or
   // deleted by the user or another system, the dictionary becomes invalid.
-  // 
If any errors occur, fix the problem indicated by the error message and
+  //
+  // If any errors occur, fix the problem indicated by the error message and
   // use the UpdateStoredInfoType API method to create another version of the
   // storedInfoType to continue using it, reusing the same `config` if it was
   // not the source of the error.
@@ -3096,6 +3769,14 @@ message StoredInfoTypeVersion {
 // StoredInfoType resource message that contains information about the current
 // version and any pending updates.
 message StoredInfoType {
+  option (google.api.resource) = {
+    type: "dlp.googleapis.com/StoredInfoType"
+    pattern: "organizations/{organization}/storedInfoTypes/{stored_info_type}"
+    pattern: "projects/{project}/storedInfoTypes/{stored_info_type}"
+    pattern: "organizations/{organization}/locations/{location}/storedInfoTypes/{stored_info_type}"
+    pattern: "projects/{project}/locations/{location}/storedInfoTypes/{stored_info_type}"
+  };
+
   // Resource name.
   string name = 1;
 
@@ -3109,26 +3790,39 @@ message StoredInfoType {
 
 // Request message for CreateStoredInfoType.
 message CreateStoredInfoTypeRequest {
-  // The parent resource name, for example projects/my-project-id or
-  // organizations/my-org-id.
-  string parent = 1;
+  // Required. The parent resource name, for example projects/my-project-id or
+  // organizations/my-org-id or projects/my-project-id/locations/{location_id}
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "dlp.googleapis.com/StoredInfoType"
+    }
+  ];
 
-  // Configuration of the storedInfoType to create.
-  StoredInfoTypeConfig config = 2;
+  // Required. Configuration of the storedInfoType to create.
+  StoredInfoTypeConfig config = 2 [(google.api.field_behavior) = REQUIRED];
 
   // The storedInfoType ID can contain uppercase and lowercase letters,
   // numbers, and hyphens; that is, it must match the regular
   // expression: `[a-zA-Z\\d-_]+`. The maximum length is 100
   // characters. Can be empty to allow the system to generate one.
   string stored_info_type_id = 3;
+
+  // Deprecated. This field has no effect.
+  string location_id = 4;
 }
 
 // Request message for UpdateStoredInfoType.
 message UpdateStoredInfoTypeRequest {
-  // Resource name of organization and storedInfoType to be updated, for
+  // Required. Resource name of organization and storedInfoType to be updated, for
   // example `organizations/433245324/storedInfoTypes/432452342` or
   // projects/project-id/storedInfoTypes/432452342.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "dlp.googleapis.com/StoredInfoType"
+    }
+  ];
 
   // Updated configuration for the storedInfoType. If not provided, a new
   // version of the storedInfoType will be created with the existing
@@ -3141,27 +3835,37 @@ message UpdateStoredInfoTypeRequest {
 
 // Request message for GetStoredInfoType.
 message GetStoredInfoTypeRequest {
-  // Resource name of the organization and storedInfoType to be read, for
-  // example `organizations/433245324/storedInfoTypes/432452342` or
+  // Required. Resource name of the organization and storedInfoType to be read,
+  // for example `organizations/433245324/storedInfoTypes/432452342` or
   // projects/project-id/storedInfoTypes/432452342.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "dlp.googleapis.com/StoredInfoType"
+    }
+  ];
 }
 
 // Request message for ListStoredInfoTypes.
 message ListStoredInfoTypesRequest {
-  // The parent resource name, for example projects/my-project-id or
-  // organizations/my-org-id.
-  string parent = 1;
+  // Required. The parent resource name, for example projects/my-project-id or
+  // organizations/my-org-id or projects/my-project-id/locations/{location_id}.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "dlp.googleapis.com/StoredInfoType"
+    }
+  ];
 
-  // Optional page token to continue retrieval. Comes from previous call
+  // Page token to continue retrieval. Comes from previous call
   // to `ListStoredInfoTypes`.
   string page_token = 2;
 
-  // Optional size of the page, can be limited by server. If zero server returns
+  // Size of the page, can be limited by server. If zero server returns
   // a page of max size 100.
   int32 page_size = 3;
 
-  // Optional comma separated list of fields to order by,
+  // Comma separated list of fields to order by,
   // followed by `asc` or `desc` postfix. This list is case-insensitive,
   // default sorting order is ascending, redundant space characters are
   // insignificant.
@@ -3176,6 +3880,9 @@ message ListStoredInfoTypesRequest {
   // - `name`: corresponds to resource name.
   // - `display_name`: corresponds to info type's display name.
   string order_by = 4;
+
+  // Deprecated. This field has no effect.
+  string location_id = 5;
 }
 
 // Response message for ListStoredInfoTypes.
@@ -3190,14 +3897,192 @@ message ListStoredInfoTypesResponse {
 
 // Request message for DeleteStoredInfoType.
 message DeleteStoredInfoTypeRequest {
-  // Resource name of the organization and storedInfoType to be deleted, for
-  // example `organizations/433245324/storedInfoTypes/432452342` or
+  // Required. Resource name of the organization and storedInfoType to be
+  // deleted, for example `organizations/433245324/storedInfoTypes/432452342` or
   // projects/project-id/storedInfoTypes/432452342.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "dlp.googleapis.com/StoredInfoType"
+    }
+  ];
+}
+
+// Request to search for potentially sensitive info in a custom location.
+message HybridInspectJobTriggerRequest {
+  // Required. Resource name of the trigger to execute a hybrid inspect on, for
+  // example `projects/dlp-test-project/jobTriggers/53234423`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "dlp.googleapis.com/JobTrigger" }
+  ];
+
+  // The item to inspect.
+  HybridContentItem hybrid_item = 3;
+}
+
+// Request to search for potentially sensitive info in a custom location.
+message HybridInspectDlpJobRequest {
+  // Required. Resource name of the job to execute a hybrid inspect on, for
+  // example `projects/dlp-test-project/dlpJob/53234423`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "dlp.googleapis.com/DlpJob" }
+  ];
+
+  // The item to inspect.
+  HybridContentItem hybrid_item = 3;
+}
+
+// An individual hybrid item to inspect. Will be stored temporarily during
+// processing.
+message HybridContentItem {
+  // The item to inspect.
+  ContentItem item = 1;
+
+  // Supplementary information that will be added to each finding.
+  HybridFindingDetails finding_details = 2;
+}
+
+// Populate to associate additional data with each finding.
+message HybridFindingDetails {
+  // Details about the container where the content being inspected is from.
+  Container container_details = 1;
+
+  // Offset in bytes of the line, from the beginning of the file, where the
+  // finding  is located. Populate if the item being scanned is only part of a
+  // bigger item, such as a shard of a file and you want to track the absolute
+  // position of the finding.
+  int64 file_offset = 2;
+
+  // Offset of the row for tables. Populate if the row(s) being scanned are
+  // part of a bigger dataset and you want to keep track of their absolute
+  // position.
+  int64 row_offset = 3;
+
+  // If the container is a table, additional information to make findings
+  // meaningful such as the columns that are primary keys. If not known ahead
+  // of time, can also be set within each inspect hybrid call and the two
+  // will be merged. Note that identifying_fields will only be stored to
+  // BigQuery, and only if the BigQuery action has been included.
+  TableOptions table_options = 4;
+
+  // Labels to represent user provided metadata about the data being inspected.
+  // If configured by the job, some key values may be required.
+  // The labels associated with `Finding`'s produced by hybrid
+  // inspection.
+  //
+  // Label keys must be between 1 and 63 characters long and must conform
+  // to the following regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?`.
+  //
+  // Label values must be between 0 and 63 characters long and must conform
+  // to the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`.
+  //
+  // No more than 10 labels can be associated with a given finding.
+  //
+  // Examples:
+  // * `"environment" : "production"`
+  // * `"pipeline" : "etl"`
+  map labels = 5;
+}
+
+// Quota exceeded errors will be thrown once quota has been met.
+message HybridInspectResponse {
+
+}
+
+// Operators available for comparing the value of fields.
+enum RelationalOperator {
+  // Unused
+  RELATIONAL_OPERATOR_UNSPECIFIED = 0;
+
+  // Equal. Attempts to match even with incompatible types.
+  EQUAL_TO = 1;
+
+  // Not equal to. Attempts to match even with incompatible types.
+  NOT_EQUAL_TO = 2;
+
+  // Greater than.
+  GREATER_THAN = 3;
+
+  // Less than.
+  LESS_THAN = 4;
+
+  // Greater than or equals.
+  GREATER_THAN_OR_EQUALS = 5;
+
+  // Less than or equals.
+  LESS_THAN_OR_EQUALS = 6;
+
+  // Exists
+  EXISTS = 7;
+}
+
+// Type of the match which can be applied to different ways of matching, like
+// Dictionary, regular expression and intersecting with findings of another
+// info type.
+enum MatchingType {
+  // Invalid.
+  MATCHING_TYPE_UNSPECIFIED = 0;
+
+  // Full match.
+  //
+  // - Dictionary: join of Dictionary results matched complete finding quote
+  // - Regex: all regex matches fill a finding quote start to end
+  // - Exclude info type: completely inside affecting info types findings
+  MATCHING_TYPE_FULL_MATCH = 1;
+
+  // Partial match.
+  //
+  // - Dictionary: at least one of the tokens in the finding matches
+  // - Regex: substring of the finding matches
+  // - Exclude info type: intersects with affecting info types findings
+  MATCHING_TYPE_PARTIAL_MATCH = 2;
+
+  // Inverse match.
+  //
+  // - Dictionary: no tokens in the finding match the dictionary
+  // - Regex: finding doesn't match the regex
+  // - Exclude info type: no intersection with affecting info types findings
+  MATCHING_TYPE_INVERSE_MATCH = 3;
+}
+
+// Options describing which parts of the provided content should be scanned.
+enum ContentOption {
+  // Includes entire content of a file or a data stream.
+  CONTENT_UNSPECIFIED = 0;
+
+  // Text content within the data, excluding any metadata.
+  CONTENT_TEXT = 1;
+
+  // Images found in the data.
+  CONTENT_IMAGE = 2;
+}
+
+// Type of metadata containing the finding.
+enum MetadataType {
+  // Unused
+  METADATATYPE_UNSPECIFIED = 0;
+
+  // General file metadata provided by GCS.
+  STORAGE_METADATA = 2;
+}
+
+// Parts of the APIs which use certain infoTypes.
+enum InfoTypeSupportedBy {
+  // Unused.
+  ENUM_TYPE_UNSPECIFIED = 0;
+
+  // Supported by the inspect operations.
+  INSPECT = 1;
+
+  // Supported by the risk analysis operations.
+  RISK_ANALYSIS = 2;
 }
 
-// An enum to represent the various type of DLP jobs.
+// An enum to represent the various types of DLP jobs.
 enum DlpJobType {
+  // Unused
   DLP_JOB_TYPE_UNSPECIFIED = 0;
 
   // The job inspected Google Cloud for sensitive data.
@@ -3209,6 +4094,7 @@ enum DlpJobType {
 
 // State of a StoredInfoType version.
 enum StoredInfoTypeState {
+  // Unused
   STORED_INFO_TYPE_STATE_UNSPECIFIED = 0;
 
   // StoredInfoType version is being created.
diff --git a/third_party/googleapis/google/privacy/dlp/v2/dlp_gapic.legacy.yaml b/third_party/googleapis/google/privacy/dlp/v2/dlp_gapic.legacy.yaml
new file mode 100644
index 000000000..9357709f2
--- /dev/null
+++ b/third_party/googleapis/google/privacy/dlp/v2/dlp_gapic.legacy.yaml
@@ -0,0 +1,566 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.dlp.v2
+  python:
+    package_name: google.cloud.dlp_v2.gapic
+  go:
+    package_name: cloud.google.com/go/dlp/apiv2
+    release_level: GA
+  csharp:
+    package_name: Google.Cloud.Dlp.V2
+  ruby:
+    package_name: Google::Cloud::Dlp::V2
+  php:
+    package_name: Google\Cloud\Dlp\V2
+  nodejs:
+    package_name: dlp.v2
+    domain_layer_location: google-cloud
+collection_oneofs:
+- oneof_name: deidentify_template_oneof
+  collection_names:
+  - organization_deidentify_template
+  - project_deidentify_template
+- oneof_name: inspect_template_oneof
+  collection_names:
+  - organization_inspect_template
+  - project_inspect_template
+- oneof_name: stored_info_type_oneof
+  collection_names:
+  - organization_stored_info_type
+  - project_stored_info_type
+# A list of API interface configurations.
+interfaces:
+- name: google.privacy.dlp.v2.DlpService
+  # A list of resource collection configurations.
+  # Consists of a name_pattern and an entity_name.
+  # The name_pattern is a pattern to describe the names of the resources of this
+  # collection, using the platform's conventions for URI patterns. A generator
+  # may use this to generate methods to compose and decompose such names. The
+  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+  # those will be taken as hints for the parameter names of the generated
+  # methods. If empty, no name methods are generated.
+  # The entity_name is the name to be used as a basis for generated methods and
+  # classes.
+  collections:
+  - name_pattern: organizations/{organization}
+    entity_name: organization
+    language_overrides:
+    - language: csharp
+      common_resource_name: Google.Api.Gax.ResourceNames.OrganizationName
+  - name_pattern: organizations/{organization}/deidentifyTemplates/{deidentify_template}
+    entity_name: organization_deidentify_template
+  - name_pattern: projects/{project}/deidentifyTemplates/{deidentify_template}
+    entity_name: project_deidentify_template
+  - name_pattern: organizations/{organization}/inspectTemplates/{inspect_template}
+    entity_name: organization_inspect_template
+  - name_pattern: projects/{project}/inspectTemplates/{inspect_template}
+    entity_name: project_inspect_template
+  - name_pattern: projects/{project}/jobTriggers/{job_trigger}
+    entity_name: project_job_trigger
+  - name_pattern: projects/{project}
+    entity_name: project
+    language_overrides:
+    - language: csharp
+      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
+  - name_pattern: projects/{project}/dlpJobs/{dlp_job}
+    entity_name: dlp_job
+  - name_pattern: organizations/{organization}/storedInfoTypes/{stored_info_type}
+    entity_name: organization_stored_info_type
+  - name_pattern: projects/{project}/storedInfoTypes/{stored_info_type}
+    entity_name: project_stored_info_type
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: InspectContent
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 300000
+  - name: RedactImage
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 300000
+  - name: DeidentifyContent
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 300000
+  - name: ReidentifyContent
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 300000
+  - name: ListInfoTypes
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 300000
+  - name: CreateInspectTemplate
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: organization
+    timeout_millis: 300000
+  - name: UpdateInspectTemplate
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: inspect_template_oneof
+    timeout_millis: 300000
+  - name: GetInspectTemplate
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: inspect_template_oneof
+    timeout_millis: 300000
+  - name: ListInspectTemplates
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: inspect_templates
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: organization
+    timeout_millis: 300000
+  - name: DeleteInspectTemplate
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: inspect_template_oneof
+    timeout_millis: 300000
+  - name: CreateDeidentifyTemplate
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: organization
+    timeout_millis: 300000
+  - name: UpdateDeidentifyTemplate
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: deidentify_template_oneof
+    timeout_millis: 300000
+  - name: GetDeidentifyTemplate
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: deidentify_template_oneof
+    timeout_millis: 300000
+  - name: ListDeidentifyTemplates
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: deidentify_templates
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: organization
+    timeout_millis: 300000
+  - name: DeleteDeidentifyTemplate
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: deidentify_template_oneof
+    timeout_millis: 300000
+  - name: CreateDlpJob
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 300000
+  - name: ListDlpJobs
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: jobs
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 300000
+  - name: GetDlpJob
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: dlp_job
+    timeout_millis: 300000
+  - name: DeleteDlpJob
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: dlp_job
+    timeout_millis: 300000
+  - name: CancelDlpJob
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: dlp_job
+    timeout_millis: 300000
+  - name: FinishDlpJob
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: dlp_job
+    timeout_millis: 300000
+  - name: HybridInspectDlpJob
+    required_fields:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 300000
+  - name: ListJobTriggers
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: job_triggers
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 300000
+  - name: GetJobTrigger
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: project_job_trigger
+    timeout_millis: 300000
+  - name: DeleteJobTrigger
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 300000
+  - name: ActivateJobTrigger
+    surface_treatments:
+    - include_languages:
+      - go
+      - java
+      - csharp
+      - ruby
+      - nodejs
+      - python
+      - php
+      visibility: DISABLED
+  - name: HybridInspectJobTrigger
+    required_fields:
+    - name
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 300000
+  - name: UpdateJobTrigger
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: project_job_trigger
+    timeout_millis: 300000
+  - name: CreateJobTrigger
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 300000
+
+  - name: CreateStoredInfoType
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: organization
+    timeout_millis: 300000
+  - name: UpdateStoredInfoType
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: stored_info_type_oneof
+    timeout_millis: 300000
+  - name: GetStoredInfoType
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: stored_info_type_oneof
+    timeout_millis: 300000
+  - name: ListStoredInfoTypes
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: stored_info_types
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: organization
+    timeout_millis: 300000
+  - name: DeleteStoredInfoType
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: stored_info_type_oneof
+    timeout_millis: 300000
+
+resource_name_generation:
+- message_name: InspectContentRequest
+  field_entity_map:
+    parent: project
+- message_name: RedactImageRequest
+  field_entity_map:
+    parent: project
+- message_name: DeidentifyContentRequest
+  field_entity_map:
+    parent: project
+- message_name: ReidentifyContentRequest
+  field_entity_map:
+    parent: project
+- message_name: CreateInspectTemplateRequest
+  field_entity_map:
+    parent: organization
+- message_name: UpdateInspectTemplateRequest
+  field_entity_map:
+    name: inspect_template_oneof
+- message_name: GetInspectTemplateRequest
+  field_entity_map:
+    name: inspect_template_oneof
+- message_name: ListInspectTemplatesRequest
+  field_entity_map:
+    parent: organization
+- message_name: DeleteInspectTemplateRequest
+  field_entity_map:
+    name: inspect_template_oneof
+- message_name: CreateDeidentifyTemplateRequest
+  field_entity_map:
+    parent: organization
+- message_name: UpdateDeidentifyTemplateRequest
+  field_entity_map:
+    name: deidentify_template_oneof
+- message_name: GetDeidentifyTemplateRequest
+  field_entity_map:
+    name: deidentify_template_oneof
+- message_name: ListDeidentifyTemplatesRequest
+  field_entity_map:
+    parent: organization
+- message_name: DeleteDeidentifyTemplateRequest
+  field_entity_map:
+    name: deidentify_template_oneof
+- message_name: CreateJobTriggerRequest
+  field_entity_map:
+    parent: project
+- message_name: UpdateJobTriggerRequest
+  field_entity_map:
+    name: project_job_trigger
+- message_name: GetJobTriggerRequest
+  field_entity_map:
+    name: project_job_trigger
+- message_name: ListJobTriggersRequest
+  field_entity_map:
+    parent: project
+- message_name: DeleteJobTriggerRequest
+  field_entity_map:
+    name: project_job_trigger
+- message_name: CreateDlpJobRequest
+  field_entity_map:
+    parent: project
+- message_name: ListDlpJobsRequest
+  field_entity_map:
+    parent: project
+- message_name: GetDlpJobRequest
+  field_entity_map:
+    name: dlp_job
+- message_name: DeleteDlpJobRequest
+  field_entity_map:
+    name: dlp_job
+- message_name: CancelDlpJobRequest
+  field_entity_map:
+    name: dlp_job
+- message_name: FinishDlpJobRequest
+  field_entity_map:
+    name: dlp_job
+- message_name: CreateStoredInfoTypeRequest
+  field_entity_map:
+    parent: organization
+- message_name: UpdateStoredInfoTypeRequest
+  field_entity_map:
+    name: stored_info_type_oneof
+- message_name: GetStoredInfoTypeRequest
+  field_entity_map:
+    name: stored_info_type_oneof
+- message_name: ListStoredInfoTypesRequest
+  field_entity_map:
+    parent: organization
+- message_name: DeleteStoredInfoTypeRequest
+  field_entity_map:
+    name: stored_info_type_oneof
diff --git a/third_party/googleapis/google/privacy/dlp/v2/dlp_gapic.yaml b/third_party/googleapis/google/privacy/dlp/v2/dlp_gapic.yaml
index 12b514849..8eaa16599 100644
--- a/third_party/googleapis/google/privacy/dlp/v2/dlp_gapic.yaml
+++ b/third_party/googleapis/google/privacy/dlp/v2/dlp_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.dlp.v2
@@ -17,38 +17,9 @@ language_settings:
   nodejs:
     package_name: dlp.v2
     domain_layer_location: google-cloud
-collection_oneofs:
-- oneof_name: deidentify_template_oneof
-  collection_names:
-  - organization_deidentify_template
-  - project_deidentify_template
-- oneof_name: inspect_template_oneof
-  collection_names:
-  - organization_inspect_template
-  - project_inspect_template
-- oneof_name: stored_info_type_oneof
-  collection_names:
-  - organization_stored_info_type
-  - project_stored_info_type
-# A list of API interface configurations.
 interfaces:
 - name: google.privacy.dlp.v2.DlpService
-  # A list of resource collection configurations.
-  # Consists of a name_pattern and an entity_name.
-  # The name_pattern is a pattern to describe the names of the resources of this
-  # collection, using the platform's conventions for URI patterns. A generator
-  # may use this to generate methods to compose and decompose such names. The
-  # pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-  # those will be taken as hints for the parameter names of the generated
-  # methods. If empty, no name methods are generated.
-  # The entity_name is the name to be used as a basis for generated methods and
-  # classes.
-  collections:
-  - name_pattern: organizations/{organization}
-    entity_name: organization
-    language_overrides:
-    - language: csharp
-      common_resource_name: Google.Api.Gax.ResourceNames.OrganizationName
+  deprecated_collections:
   - name_pattern: organizations/{organization}/deidentifyTemplates/{deidentify_template}
     entity_name: organization_deidentify_template
   - name_pattern: projects/{project}/deidentifyTemplates/{deidentify_template}
@@ -57,315 +28,110 @@ interfaces:
     entity_name: organization_inspect_template
   - name_pattern: projects/{project}/inspectTemplates/{inspect_template}
     entity_name: project_inspect_template
-  - name_pattern: projects/{project}/jobTriggers/{job_trigger}
-    entity_name: project_job_trigger
-  - name_pattern: projects/{project}
-    entity_name: project
-    language_overrides:
-    - language: csharp
-      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
-  - name_pattern: projects/{project}/dlpJobs/{dlp_job}
-    entity_name: dlp_job
   - name_pattern: organizations/{organization}/storedInfoTypes/{stored_info_type}
     entity_name: organization_stored_info_type
   - name_pattern: projects/{project}/storedInfoTypes/{stored_info_type}
     entity_name: project_stored_info_type
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
+  - name_pattern: projects/{project}/jobTriggers/{job_trigger}
+    entity_name: project_job_trigger
   methods:
   - name: InspectContent
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      parent: project
     timeout_millis: 300000
   - name: RedactImage
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      parent: project
     timeout_millis: 300000
   - name: DeidentifyContent
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      parent: project
     timeout_millis: 300000
   - name: ReidentifyContent
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      parent: project
     timeout_millis: 300000
   - name: ListInfoTypes
     retry_codes_name: idempotent
     retry_params_name: default
     timeout_millis: 300000
   - name: CreateInspectTemplate
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      parent: organization
     timeout_millis: 300000
   - name: UpdateInspectTemplate
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: inspect_template_oneof
     timeout_millis: 300000
   - name: GetInspectTemplate
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: inspect_template_oneof
     timeout_millis: 300000
   - name: ListInspectTemplates
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: inspect_templates
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      parent: organization
     timeout_millis: 300000
   - name: DeleteInspectTemplate
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: inspect_template_oneof
     timeout_millis: 300000
   - name: CreateDeidentifyTemplate
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      parent: organization
     timeout_millis: 300000
   - name: UpdateDeidentifyTemplate
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: deidentify_template_oneof
     timeout_millis: 300000
   - name: GetDeidentifyTemplate
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: deidentify_template_oneof
     timeout_millis: 300000
   - name: ListDeidentifyTemplates
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: deidentify_templates
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      parent: organization
     timeout_millis: 300000
   - name: DeleteDeidentifyTemplate
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: deidentify_template_oneof
     timeout_millis: 300000
   - name: CreateDlpJob
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      parent: project
     timeout_millis: 300000
   - name: ListDlpJobs
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: jobs
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      parent: project
     timeout_millis: 300000
   - name: GetDlpJob
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: dlp_job
     timeout_millis: 300000
   - name: DeleteDlpJob
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: dlp_job
     timeout_millis: 300000
   - name: CancelDlpJob
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: dlp_job
+    timeout_millis: 300000
+  - name: FinishDlpJob
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 300000
+  - name: HybridInspectDlpJob
+    retry_codes_name: non_idempotent
+    retry_params_name: default
     timeout_millis: 300000
   - name: ListJobTriggers
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: job_triggers
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      parent: project
     timeout_millis: 300000
   - name: GetJobTrigger
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: project_job_trigger
     timeout_millis: 300000
   - name: DeleteJobTrigger
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
     timeout_millis: 300000
@@ -380,163 +146,35 @@ interfaces:
       - python
       - php
       visibility: DISABLED
+  - name: HybridInspectJobTrigger
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 300000
   - name: UpdateJobTrigger
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: project_job_trigger
     timeout_millis: 300000
   - name: CreateJobTrigger
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      parent: project
     timeout_millis: 300000
-
   - name: CreateStoredInfoType
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      parent: organization
     timeout_millis: 300000
   - name: UpdateStoredInfoType
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: stored_info_type_oneof
     timeout_millis: 300000
   - name: GetStoredInfoType
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: stored_info_type_oneof
     timeout_millis: 300000
   - name: ListStoredInfoTypes
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: stored_info_types
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      parent: organization
     timeout_millis: 300000
   - name: DeleteStoredInfoType
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: stored_info_type_oneof
-    timeout_millis: 300000
-
-resource_name_generation:
-- message_name: InspectContentRequest
-  field_entity_map:
-    parent: project
-- message_name: RedactImageRequest
-  field_entity_map:
-    parent: project
-- message_name: DeidentifyContentRequest
-  field_entity_map:
-    parent: project
-- message_name: ReidentifyContentRequest
-  field_entity_map:
-    parent: project
-- message_name: CreateInspectTemplateRequest
-  field_entity_map:
-    parent: organization
-- message_name: UpdateInspectTemplateRequest
-  field_entity_map:
-    name: inspect_template_oneof
-- message_name: GetInspectTemplateRequest
-  field_entity_map:
-    name: inspect_template_oneof
-- message_name: ListInspectTemplatesRequest
-  field_entity_map:
-    parent: organization
-- message_name: DeleteInspectTemplateRequest
-  field_entity_map:
-    name: inspect_template_oneof
-- message_name: CreateDeidentifyTemplateRequest
-  field_entity_map:
-    parent: organization
-- message_name: UpdateDeidentifyTemplateRequest
-  field_entity_map:
-    name: deidentify_template_oneof
-- message_name: GetDeidentifyTemplateRequest
-  field_entity_map:
-    name: deidentify_template_oneof
-- message_name: ListDeidentifyTemplatesRequest
-  field_entity_map:
-    parent: organization
-- message_name: DeleteDeidentifyTemplateRequest
-  field_entity_map:
-    name: deidentify_template_oneof
-- message_name: CreateJobTriggerRequest
-  field_entity_map:
-    parent: project
-- message_name: UpdateJobTriggerRequest
-  field_entity_map:
-    name: project_job_trigger
-- message_name: GetJobTriggerRequest
-  field_entity_map:
-    name: project_job_trigger
-- message_name: ListJobTriggersRequest
-  field_entity_map:
-    parent: project
-- message_name: DeleteJobTriggerRequest
-  field_entity_map:
-    name: project_job_trigger
-- message_name: CreateDlpJobRequest
-  field_entity_map:
-    parent: project
-- message_name: ListDlpJobsRequest
-  field_entity_map:
-    parent: project
-- message_name: GetDlpJobRequest
-  field_entity_map:
-    name: dlp_job
-- message_name: DeleteDlpJobRequest
-  field_entity_map:
-    name: dlp_job
-- message_name: CancelDlpJobRequest
-  field_entity_map:
-    name: dlp_job
-- message_name: CreateStoredInfoTypeRequest
-  field_entity_map:
-    parent: organization
-- message_name: UpdateStoredInfoTypeRequest
-  field_entity_map:
-    name: stored_info_type_oneof
-- message_name: GetStoredInfoTypeRequest
-  field_entity_map:
-    name: stored_info_type_oneof
-- message_name: ListStoredInfoTypesRequest
-  field_entity_map:
-    parent: organization
-- message_name: DeleteStoredInfoTypeRequest
-  field_entity_map:
-    name: stored_info_type_oneof
+    timeout_millis: 300000
diff --git a/third_party/googleapis/google/privacy/dlp/v2/dlp_grpc_service_config.json b/third_party/googleapis/google/privacy/dlp/v2/dlp_grpc_service_config.json
new file mode 100755
index 000000000..e2017e244
--- /dev/null
+++ b/third_party/googleapis/google/privacy/dlp/v2/dlp_grpc_service_config.json
@@ -0,0 +1,160 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "InspectContent"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "RedactImage"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "DeidentifyContent"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "ReidentifyContent"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "ListInfoTypes"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "GetInspectTemplate"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "ListInspectTemplates"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "DeleteInspectTemplate"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "GetDeidentifyTemplate"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "ListDeidentifyTemplates"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "DeleteDeidentifyTemplate"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "ListDlpJobs"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "GetDlpJob"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "DeleteDlpJob"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "ListJobTriggers"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "GetJobTrigger"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "DeleteJobTrigger"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "GetStoredInfoType"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "ListStoredInfoTypes"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "DeleteStoredInfoType"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "FinishDlpJob"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "HybridInspectDlpJob"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "HybridInspectJobTrigger"
+        }
+      ],
+      "timeout": "300s",
+      "retryPolicy": {
+        "initialBackoff": "0.100s",
+        "maxAttempts": 5,
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "CreateInspectTemplate"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "UpdateInspectTemplate"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "CreateDeidentifyTemplate"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "UpdateDeidentifyTemplate"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "CreateDlpJob"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "CancelDlpJob"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "UpdateJobTrigger"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "CreateJobTrigger"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "CreateStoredInfoType"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "UpdateStoredInfoType"
+        },
+        {
+          "service": "google.privacy.dlp.v2.DlpService",
+          "method": "ActivateJobTrigger"
+        }
+      ],
+      "timeout": "300s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/privacy/dlp/dlp_v2.yaml b/third_party/googleapis/google/privacy/dlp/v2/dlp_v2.yaml
similarity index 100%
rename from third_party/googleapis/google/privacy/dlp/dlp_v2.yaml
rename to third_party/googleapis/google/privacy/dlp/v2/dlp_v2.yaml
diff --git a/third_party/googleapis/google/privacy/dlp/v2/storage.proto b/third_party/googleapis/google/privacy/dlp/v2/storage.proto
index c2f38a613..9408d6de7 100644
--- a/third_party/googleapis/google/privacy/dlp/v2/storage.proto
+++ b/third_party/googleapis/google/privacy/dlp/v2/storage.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,12 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.privacy.dlp.v2;
 
-import "google/api/annotations.proto";
+import "google/api/resource.proto";
 import "google/protobuf/timestamp.proto";
 
 option csharp_namespace = "Google.Cloud.Dlp.V2";
@@ -26,6 +25,7 @@ option java_multiple_files = true;
 option java_outer_classname = "DlpStorage";
 option java_package = "com.google.privacy.dlp.v2";
 option php_namespace = "Google\\Cloud\\Dlp\\V2";
+option ruby_package = "Google::Cloud::Dlp::V2";
 
 // Type of information detected by the API.
 message InfoType {
@@ -33,7 +33,7 @@ message InfoType {
   // creating a CustomInfoType, or one of the names listed
   // at https://cloud.google.com/dlp/docs/infotypes-reference when specifying
   // a built-in type. InfoType names should conform to the pattern
-  // [a-zA-Z0-9_]{1,64}.
+  // `[a-zA-Z0-9_]{1,64}`.
   string name = 1;
 }
 
@@ -393,6 +393,9 @@ message CloudStorageOptions {
   // If empty, all files are scanned and available data format processors
   // are applied. In addition, the binary content of the selected files
   // is always scanned as well.
+  // Images are scanned only as binary if the specified region
+  // does not support image inspection and no file_types were specified.
+  // Image inspection is restricted to 'global', 'us', 'asia', and 'europe'.
   repeated FileType file_types = 5;
 
   SampleMethod sample_method = 6;
@@ -435,8 +438,11 @@ message BigQueryOptions {
   // Complete BigQuery table reference.
   BigQueryTable table_reference = 1;
 
-  // References to fields uniquely identifying rows within the table.
-  // Nested fields in the format, like `person.birthdate.year`, are allowed.
+  // Table fields that may uniquely identify a row within the table. When
+  // `actions.saveFindings.outputConfig.table` is specified, the values of
+  // columns specified here are available in the output table under
+  // `location.content_locations.record_location.record_key.id_values`. Nested
+  // fields such as `person.birthdate.year` are allowed.
   repeated FieldId identifying_fields = 2;
 
   // Max number of rows to scan. If the table has more rows than this value, the
@@ -472,14 +478,19 @@ message StorageConfig {
     google.protobuf.Timestamp end_time = 2;
 
     // Specification of the field containing the timestamp of scanned items.
-    // Used for data sources like Datastore or BigQuery.
-    // If not specified for BigQuery, table last modification timestamp
-    // is checked against given time span.
-    // The valid data types of the timestamp field are:
-    // for BigQuery - timestamp, date, datetime;
-    // for Datastore - timestamp.
-    // Datastore entity will be scanned if the timestamp property does not exist
-    // or its value is empty or invalid.
+    // Used for data sources like Datastore and BigQuery.
+    //
+    // For BigQuery:
+    // Required to filter out rows based on the given start and
+    // end times. If not specified and the table was modified between the given
+    // start and end times, the entire table will be scanned.
+    // The valid data types of the timestamp field are: `INTEGER`, `DATE`,
+    // `TIMESTAMP`, or `DATETIME` BigQuery column.
+    //
+    // For Datastore.
+    // Valid data types of the timestamp field are: `TIMESTAMP`.
+    // Datastore entity will be scanned if the timestamp property does not
+    // exist or its value is empty or invalid.
     FieldId timestamp_field = 3;
 
     // When the job is started by a JobTrigger we will automatically figure out
@@ -490,14 +501,20 @@ message StorageConfig {
   }
 
   oneof type {
-    // Google Cloud Datastore options specification.
+    // Google Cloud Datastore options.
     DatastoreOptions datastore_options = 2;
 
-    // Google Cloud Storage options specification.
+    // Google Cloud Storage options.
     CloudStorageOptions cloud_storage_options = 3;
 
-    // BigQuery options specification.
+    // BigQuery options.
     BigQueryOptions big_query_options = 4;
+
+    // Hybrid inspection options.
+    // Early access feature is in a pre-release state and might change or have
+    // limited support. For more information, see
+    // https://cloud.google.com/products#product-launch-stages.
+    HybridOptions hybrid_options = 9;
   }
 
   TimespanConfig timespan_config = 6;
@@ -522,20 +539,69 @@ enum FileType {
   // Included file extensions:
   //   bmp, gif, jpg, jpeg, jpe, png.
   // bytes_limit_per_file has no effect on image files.
+  // Image inspection is restricted to 'global', 'us', 'asia', and 'europe'.
   IMAGE = 3;
 
+  // Included file extensions:
+  //   docx, dotx, docm, dotm
+  WORD = 5;
+
+  // Included file extensions:
+  //   pdf
+  PDF = 6;
+
   // Included file extensions:
   //   avro
   AVRO = 7;
 }
 
+// Configuration to control jobs where the content being inspected is outside
+// of Google Cloud Platform.
+message HybridOptions {
+  // A short description of where the data is coming from. Will be stored once
+  // in the job. 256 max length.
+  string description = 1;
+
+  // These are labels that each inspection request must include within their
+  // 'finding_labels' map. Request may contain others, but any missing one of
+  // these will be rejected.
+  //
+  // Label keys must be between 1 and 63 characters long and must conform
+  // to the following regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?`.
+  //
+  // No more than 10 keys can be required.
+  repeated string required_finding_label_keys = 2;
+
+  // To organize findings, these labels will be added to each finding.
+  //
+  // Label keys must be between 1 and 63 characters long and must conform
+  // to the following regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?`.
+  //
+  // Label values must be between 0 and 63 characters long and must conform
+  // to the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`.
+  //
+  // No more than 10 labels can be associated with a given finding.
+  //
+  // Examples:
+  // * `"environment" : "production"`
+  // * `"pipeline" : "etl"`
+  map labels = 3;
+
+  // If the container is a table, additional information to make findings
+  // meaningful such as the columns that are primary keys.
+  TableOptions table_options = 4;
+}
+
 // Row key for identifying a record in BigQuery table.
 message BigQueryKey {
   // Complete BigQuery table reference.
   BigQueryTable table_reference = 1;
 
-  // Absolute number of the row from the beginning of the table at the time
-  // of scanning.
+  // Row number inferred at the time the table was scanned. This value is
+  // nondeterministic, cannot be queried, and may be null for inspection
+  // jobs. To locate findings within a table, specify
+  // `inspect_job.storage_config.big_query_options.identifying_fields` in
+  // `CreateDlpJobRequest`.
   int64 row_number = 2;
 }
 
@@ -602,7 +668,7 @@ message RecordKey {
   }
 
   // Values of identifying columns in the given row. Order of values matches
-  // the order of field identifiers specified in the scanning request.
+  // the order of `identifying_fields` specified in the scanning request.
   repeated string id_values = 5;
 }
 
@@ -641,3 +707,12 @@ message EntityId {
   // Composite key indicating which field contains the entity identifier.
   FieldId field = 1;
 }
+
+// Instructions regarding the table content being inspected.
+message TableOptions {
+  // The columns that are the primary keys for table objects included in
+  // ContentItem. A copy of this cell's value will stored alongside alongside
+  // each finding so that the finding can be traced to the specific row it came
+  // from. No more than 3 may be provided.
+  repeated FieldId identifying_fields = 1;
+}
diff --git a/third_party/googleapis/google/pubsub/artman_pubsub.yaml b/third_party/googleapis/google/pubsub/artman_pubsub.yaml
index 5ca885a93..0d354412c 100644
--- a/third_party/googleapis/google/pubsub/artman_pubsub.yaml
+++ b/third_party/googleapis/google/pubsub/artman_pubsub.yaml
@@ -2,7 +2,7 @@ common:
   api_name: pubsub
   api_version: v1
   organization_name: google-cloud
-  service_yaml: pubsub.yaml
+  service_yaml: v1/pubsub_v1.yaml
   gapic_yaml: v1/pubsub_gapic.yaml
   src_proto_paths:
   - v1
diff --git a/third_party/googleapis/google/pubsub/pubsub.yaml b/third_party/googleapis/google/pubsub/pubsub.yaml
deleted file mode 100644
index 77cc84c4b..000000000
--- a/third_party/googleapis/google/pubsub/pubsub.yaml
+++ /dev/null
@@ -1,67 +0,0 @@
-type: google.api.Service
-config_version: 3
-name: pubsub.googleapis.com
-title: Google Cloud Pub/Sub API
-
-apis:
-- name: google.pubsub.v1.Publisher
-- name: google.pubsub.v1.Subscriber
-
-documentation:
-  summary: |-
-    Provides reliable, many-to-many, asynchronous messaging between
-    applications.
-  rules:
-    - selector: >
-        google.pubsub.v1.Topic.name,
-      description: |
-          The name of the topic. It must have the format
-          `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter,
-          and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`),
-          underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent
-          signs (`%`). It must be between 3 and 255 characters in length, and it
-          must not start with `"goog"`.
-    - selector: >
-        google.pubsub.v1.Subscription.name,
-      description: |
-          The name of the subscription. It must have the format
-          `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
-          start with a letter, and contain only letters (`[A-Za-z]`), numbers
-          (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
-          plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
-          in length, and it must not start with `"goog"`
-
-http:
-  rules:
-  - selector: google.iam.v1.IAMPolicy.SetIamPolicy
-    post: '/v1/{resource=projects/*/topics/*}:setIamPolicy'
-    body: '*'
-    additional_bindings:
-    - post: '/v1/{resource=projects/*/subscriptions/*}:setIamPolicy'
-      body: '*'
-    - post: '/v1/{resource=projects/*/snapshots/*}:setIamPolicy'
-      body: '*'
-
-  - selector: google.iam.v1.IAMPolicy.GetIamPolicy
-    get: '/v1/{resource=projects/*/topics/*}:getIamPolicy'
-    additional_bindings:
-    - get: '/v1/{resource=projects/*/subscriptions/*}:getIamPolicy'
-    - get: '/v1/{resource=projects/*/snapshots/*}:getIamPolicy'
-
-  - selector: google.iam.v1.IAMPolicy.TestIamPermissions
-    post: '/v1/{resource=projects/*/subscriptions/*}:testIamPermissions'
-    body: '*'
-    additional_bindings:
-    - post: '/v1/{resource=projects/*/topics/*}:testIamPermissions'
-      body: '*'
-    - post: '/v1/{resource=projects/*/snapshots/*}:testIamPermissions'
-      body: '*'
-
-
-authentication:
-  rules:
-  - selector: '*'
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform,
-        https://www.googleapis.com/auth/pubsub
diff --git a/third_party/googleapis/google/pubsub/v1/BUILD.bazel b/third_party/googleapis/google/pubsub/v1/BUILD.bazel
index acd485b0f..0185b6853 100644
--- a/third_party/googleapis/google/pubsub/v1/BUILD.bazel
+++ b/third_party/googleapis/google/pubsub/v1/BUILD.bazel
@@ -1,3 +1,5 @@
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
@@ -11,6 +13,8 @@ proto_library(
     srcs = ["pubsub.proto"],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
         "//google/api:resource_proto",
         "@com_google_protobuf//:duration_proto",
         "@com_google_protobuf//:empty_proto",
@@ -23,6 +27,7 @@ proto_library_with_info(
     name = "pubsub_proto_with_info",
     deps = [
         ":pubsub_proto",
+        "//google/cloud:common_resources_proto",
         "//google/iam/v1:iam_policy_proto",
         "//google/iam/v1:policy_proto",
     ],
@@ -33,19 +38,14 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
     "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-    "@com_google_api_grpc_proto_google_iam_v1//jar",
-]
-
 java_proto_library(
     name = "pubsub_java_proto",
     deps = [":pubsub_proto"],
@@ -54,53 +54,113 @@ java_proto_library(
 java_grpc_library(
     name = "pubsub_java_grpc",
     srcs = [":pubsub_proto"],
-    deps = [":pubsub_java_proto"] + _JAVA_GRPC_DEPS,
+    deps = [":pubsub_java_proto"],
 )
 
 java_resource_name_proto_library(
-    name = "pubsub_resource_name_java_proto",
+    name = "pubsub_java_gapic_resource_name",
     gapic_yaml = "pubsub_gapic.yaml",
-    deps = [":pubsub_proto"],
+    deps = [
+        ":pubsub_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 java_gapic_library(
     name = "pubsub_java_gapic",
     src = ":pubsub_proto_with_info",
     gapic_yaml = "pubsub_gapic.yaml",
-    service_yaml = "//google/pubsub:pubsub.yaml",
+    gen_resource_name = False,
+    service_yaml = ":pubsub_v1.yaml",
     test_deps = [
         ":pubsub_java_grpc",
-        "@com_google_api_grpc_grpc_google_iam_v1//jar",
+        "//google/iam/v1:iam_java_grpc",
     ],
     deps = [
+        ":pubsub_java_gapic_resource_name",
         ":pubsub_java_proto",
-        ":pubsub_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+        "//google/iam/v1:iam_java_proto",
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
+java_gapic_test(
+    name = "pubsub_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.pubsub.v1.SubscriptionAdminClientTest",
+        "com.google.cloud.pubsub.v1.TopicAdminClientTest",
+    ],
     runtime_deps = [":pubsub_java_gapic_test"],
-) for test_name in [
-    "com.google.cloud.pubsub.v1.SubscriptionAdminClientTest",
-    "com.google.cloud.pubsub.v1.TopicAdminClientTest",
-]]
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-pubsub-v1-java",
-    client_deps = [":pubsub_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":pubsub_java_gapic_test"],
-    grpc_deps = [":pubsub_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":pubsub_java_gapic",
+        ":pubsub_java_gapic_resource_name",
+        ":pubsub_java_grpc",
         ":pubsub_java_proto",
         ":pubsub_proto",
-        ":pubsub_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_proto_library",
+    "py_grpc_library",
+    "py_gapic_library",
+    "py_gapic_assembly_pkg",
+)
+
+moved_proto_library(
+    name = "pubsub_moved_proto",
+    srcs = [":pubsub_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "pubsub_py_proto",
+    deps = [":pubsub_moved_proto"],
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+)
+
+py_grpc_library(
+    name = "pubsub_py_grpc",
+    srcs = [":pubsub_moved_proto"],
+    deps = [":pubsub_py_proto"],
+)
+
+py_gapic_library(
+    name = "pubsub_py_gapic",
+    src = ":pubsub_proto_with_info",
+    gapic_yaml = "pubsub_gapic.yaml",
+    service_yaml = ":pubsub_v1.yaml",
+    deps = [
+        ":pubsub_py_proto",
+        ":pubsub_py_grpc"
+    ],
+)
+
+py_gapic_assembly_pkg(
+    name = "pubsub-v1-py",
+    deps = [
+        ":pubsub_py_gapic",
+        ":pubsub_py_grpc",
+        ":pubsub_py_proto",
+    ],
 )
 
 ##############################################################################
@@ -108,10 +168,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -124,11 +184,14 @@ go_proto_library(
 
 go_gapic_library(
     name = "pubsub_go_gapic",
-    src = ":pubsub_proto_with_info",
-    gapic_yaml = "pubsub_gapic.yaml",
-    importpath = "cloud.google.com/go/pubsub/apiv1",
-    service_yaml = "//google/pubsub:pubsub.yaml",
-    deps = [":pubsub_go_proto"],
+    srcs = [":pubsub_proto_with_info"],
+    grpc_service_config = "pubsub_grpc_service_config.json",
+    importpath = "cloud.google.com/go/pubsub/apiv1;pubsub",
+    service_yaml = ":pubsub_v1.yaml",
+    deps = [
+        ":pubsub_go_proto",
+        "//google/iam/v1:iam_go_proto",
+    ],
 )
 
 go_test(
@@ -139,12 +202,11 @@ go_test(
     deps = ["//google/iam/v1:iam_go_proto"],
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-pubsub-v1-go",
     deps = [
         ":pubsub_go_gapic",
-        ":pubsub_go_gapic_srcjar-smoke-test.srcjar",
         ":pubsub_go_gapic_srcjar-test.srcjar",
         ":pubsub_go_proto",
     ],
@@ -155,10 +217,10 @@ go_gapic_assembly_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "php_proto_library",
-    "php_grpc_library",
-    "php_gapic_library",
     "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
 )
 
 php_proto_library(
@@ -176,14 +238,14 @@ php_gapic_library(
     name = "pubsub_php_gapic",
     src = ":pubsub_proto_with_info",
     gapic_yaml = "pubsub_gapic.yaml",
-    service_yaml = "//google/pubsub:pubsub.yaml",
+    service_yaml = ":pubsub_v1.yaml",
     deps = [
         ":pubsub_php_grpc",
         ":pubsub_php_proto",
     ],
 )
 
-# Opensource Packages
+# Open Source Packages
 php_gapic_assembly_pkg(
     name = "google-cloud-pubsub-v1-php",
     deps = [
@@ -198,15 +260,15 @@ php_gapic_assembly_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "nodejs_gapic_library",
     "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
 )
 
 nodejs_gapic_library(
     name = "pubsub_nodejs_gapic",
     src = ":pubsub_proto_with_info",
     gapic_yaml = "pubsub_gapic.yaml",
-    service_yaml = "//google/pubsub:pubsub.yaml",
+    service_yaml = ":pubsub_v1.yaml",
     deps = [],
 )
 
@@ -217,3 +279,110 @@ nodejs_gapic_assembly_pkg(
         ":pubsub_proto",
     ],
 )
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "pubsub_ruby_proto",
+    deps = [":pubsub_proto"],
+)
+
+ruby_grpc_library(
+    name = "pubsub_ruby_grpc",
+    srcs = [":pubsub_proto"],
+    deps = [":pubsub_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "pubsub_ruby_gapic",
+    src = ":pubsub_proto_with_info",
+    gapic_yaml = "pubsub_gapic.yaml",
+    service_yaml = ":pubsub_v1.yaml",
+    deps = [
+        ":pubsub_ruby_grpc",
+        ":pubsub_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-pubsub-v1-ruby",
+    deps = [
+        ":pubsub_ruby_gapic",
+        ":pubsub_ruby_grpc",
+        ":pubsub_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "pubsub_csharp_proto",
+    deps = [":pubsub_proto"],
+)
+
+csharp_grpc_library(
+    name = "pubsub_csharp_grpc",
+    srcs = [":pubsub_proto"],
+    deps = [":pubsub_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "pubsub_csharp_gapic",
+    src = ":pubsub_proto_with_info",
+    gapic_yaml = "pubsub_gapic.yaml",
+    service_yaml = ":pubsub_v1.yaml",
+    deps = [
+        ":pubsub_csharp_grpc",
+        ":pubsub_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-pubsub-v1-csharp",
+    deps = [
+        ":pubsub_csharp_gapic",
+        ":pubsub_csharp_grpc",
+        ":pubsub_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "cc_grpc_library",
+    "cc_proto_library",
+)
+
+cc_proto_library(
+    name = "pubsub_cc_proto",
+    deps = [":pubsub_proto"],
+)
+
+cc_grpc_library(
+    name = "pubsub_cc_grpc",
+    srcs = [":pubsub_proto"],
+    grpc_only = True,
+    deps = [":pubsub_cc_proto"],
+)
diff --git a/third_party/googleapis/google/pubsub/v1/pubsub.proto b/third_party/googleapis/google/pubsub/v1/pubsub.proto
index 7cea47b1e..a42d03220 100644
--- a/third_party/googleapis/google/pubsub/v1/pubsub.proto
+++ b/third_party/googleapis/google/pubsub/v1/pubsub.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,14 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.pubsub.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/empty.proto";
@@ -36,6 +37,11 @@ option ruby_package = "Google::Cloud::PubSub::V1";
 // The service that an application uses to manipulate topics, and to send
 // messages to a topic.
 service Publisher {
+  option (google.api.default_host) = "pubsub.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/pubsub";
+
   // Creates the given topic with the given name. See the
   // 
   // resource name rules.
@@ -44,6 +50,7 @@ service Publisher {
       put: "/v1/{name=projects/*/topics/*}"
       body: "*"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Updates an existing topic. Note that certain properties of a
@@ -62,6 +69,7 @@ service Publisher {
       post: "/v1/{topic=projects/*/topics/*}:publish"
       body: "*"
     };
+    option (google.api.method_signature) = "topic,messages";
   }
 
   // Gets the configuration of a topic.
@@ -69,6 +77,7 @@ service Publisher {
     option (google.api.http) = {
       get: "/v1/{topic=projects/*/topics/*}"
     };
+    option (google.api.method_signature) = "topic";
   }
 
   // Lists matching topics.
@@ -76,6 +85,7 @@ service Publisher {
     option (google.api.http) = {
       get: "/v1/{project=projects/*}/topics"
     };
+    option (google.api.method_signature) = "project";
   }
 
   // Lists the names of the subscriptions on this topic.
@@ -84,6 +94,7 @@ service Publisher {
     option (google.api.http) = {
       get: "/v1/{topic=projects/*/topics/*}/subscriptions"
     };
+    option (google.api.method_signature) = "topic";
   }
 
   // Lists the names of the snapshots on this topic. Snapshots are used in
@@ -97,6 +108,7 @@ service Publisher {
     option (google.api.http) = {
       get: "/v1/{topic=projects/*/topics/*}/snapshots"
     };
+    option (google.api.method_signature) = "topic";
   }
 
   // Deletes the topic with the given name. Returns `NOT_FOUND` if the topic
@@ -108,48 +120,48 @@ service Publisher {
     option (google.api.http) = {
       delete: "/v1/{topic=projects/*/topics/*}"
     };
+    option (google.api.method_signature) = "topic";
   }
 }
 
 message MessageStoragePolicy {
-  // The list of GCP region IDs where messages that are published to the topic
+  // A list of IDs of GCP regions where messages that are published to the topic
   // may be persisted in storage. Messages published by publishers running in
   // non-allowed GCP regions (or running outside of GCP altogether) will be
-  // routed for storage in one of the allowed regions. An empty list indicates a
-  // misconfiguration at the project or organization level, which will result in
-  // all Publish operations failing.
+  // routed for storage in one of the allowed regions. An empty list means that
+  // no regions are allowed, and is not a valid configuration.
   repeated string allowed_persistence_regions = 1;
 }
 
 // A topic resource.
 message Topic {
-  // The name of the topic. It must have the format
+  option (google.api.resource) = {
+    type: "pubsub.googleapis.com/Topic"
+    pattern: "projects/{project}/topics/{topic}"
+    pattern: "_deleted-topic_"
+  };
+
+  // Required. The name of the topic. It must have the format
   // `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter,
   // and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`),
   // underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent
   // signs (`%`). It must be between 3 and 255 characters in length, and it
   // must not start with `"goog"`.
-  string name = 1;
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
 
   // See  Creating and
   // managing labels.
   map labels = 2;
 
-  // Policy constraining how messages published to the topic may be stored. It
-  // is determined when the topic is created based on the policy configured at
-  // the project level. It must not be set by the caller in the request to
-  // CreateTopic or to UpdateTopic. This field will be populated in the
-  // responses for GetTopic, CreateTopic, and UpdateTopic: if not present in the
-  // response, then no constraints are in effect.
+  // Policy constraining the set of Google Cloud Platform regions where messages
+  // published to the topic may be stored. If not present, then no constraints
+  // are in effect.
   MessageStoragePolicy message_storage_policy = 3;
 
   // The resource name of the Cloud KMS CryptoKey to be used to protect access
   // to messages published on this topic.
   //
   // The expected format is `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
-  // EXPERIMENTAL: This feature is part of a closed alpha release. This
-  // API might be changed in backward-incompatible ways and is not recommended
-  // for production use. It is not subject to any SLA or deprecation policy.
   string kms_key_name = 5;
 }
 
@@ -166,7 +178,8 @@ message PubsubMessage {
   // at least one attribute.
   bytes data = 1;
 
-  // Optional attributes for this message.
+  // Attributes for this message. If this field is empty, the message must
+  // contain non-empty data.
   map attributes = 2;
 
   // ID of this message, assigned by the server when the message is published.
@@ -180,10 +193,12 @@ message PubsubMessage {
   // publisher in a `Publish` call.
   google.protobuf.Timestamp publish_time = 4;
 
-  // Identifies related messages for which publish order should be respected.
-  // If a `Subscription` has `enable_message_ordering` set to `true`, messages
-  // published with the same `ordering_key` value will be delivered to
-  // subscribers in the order in which they are received by the Pub/Sub system.
+  // If non-empty, identifies related messages for which publish order should be
+  // respected. If a `Subscription` has `enable_message_ordering` set to `true`,
+  // messages published with the same non-empty `ordering_key` value will be
+  // delivered to subscribers in the order in which they are received by the
+  // Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
+  // must specify the same `ordering_key` value.
   // EXPERIMENTAL: This feature is part of a closed alpha release. This
   // API might be changed in backward-incompatible ways and is not recommended
   // for production use. It is not subject to any SLA or deprecation policy.
@@ -192,32 +207,39 @@ message PubsubMessage {
 
 // Request for the GetTopic method.
 message GetTopicRequest {
-  // The name of the topic to get.
+  // Required. The name of the topic to get.
   // Format is `projects/{project}/topics/{topic}`.
-  string topic = 1;
+  string topic = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "pubsub.googleapis.com/Topic" }
+  ];
 }
 
 // Request for the UpdateTopic method.
 message UpdateTopicRequest {
-  // The updated topic object.
-  Topic topic = 1;
-
-  // Indicates which fields in the provided topic to update. Must be specified
-  // and non-empty. Note that if `update_mask` contains
-  // "message_storage_policy" then the new value will be determined based on the
-  // policy configured at the project or organization level. The
-  // `message_storage_policy` must not be set in the `topic` provided above.
-  google.protobuf.FieldMask update_mask = 2;
+  // Required. The updated topic object.
+  Topic topic = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Indicates which fields in the provided topic to update. Must be
+  // specified and non-empty. Note that if `update_mask` contains
+  // "message_storage_policy" but the `message_storage_policy` is not set in
+  // the `topic` provided above, then the updated value is determined by the
+  // policy configured at the project or organization level.
+  google.protobuf.FieldMask update_mask = 2
+      [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for the Publish method.
 message PublishRequest {
-  // The messages in the request will be published on this topic.
+  // Required. The messages in the request will be published on this topic.
   // Format is `projects/{project}/topics/{topic}`.
-  string topic = 1;
+  string topic = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "pubsub.googleapis.com/Topic" }
+  ];
 
-  // The messages to publish.
-  repeated PubsubMessage messages = 2;
+  // Required. The messages to publish.
+  repeated PubsubMessage messages = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response for the `Publish` method.
@@ -230,9 +252,14 @@ message PublishResponse {
 
 // Request for the `ListTopics` method.
 message ListTopicsRequest {
-  // The name of the project in which to list topics.
+  // Required. The name of the project in which to list topics.
   // Format is `projects/{project-id}`.
-  string project = 1;
+  string project = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
   // Maximum number of topics to return.
   int32 page_size = 2;
@@ -255,9 +282,12 @@ message ListTopicsResponse {
 
 // Request for the `ListTopicSubscriptions` method.
 message ListTopicSubscriptionsRequest {
-  // The name of the topic that subscriptions are attached to.
+  // Required. The name of the topic that subscriptions are attached to.
   // Format is `projects/{project}/topics/{topic}`.
-  string topic = 1;
+  string topic = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "pubsub.googleapis.com/Topic" }
+  ];
 
   // Maximum number of subscription names to return.
   int32 page_size = 2;
@@ -271,7 +301,9 @@ message ListTopicSubscriptionsRequest {
 // Response for the `ListTopicSubscriptions` method.
 message ListTopicSubscriptionsResponse {
   // The names of the subscriptions that match the request.
-  repeated string subscriptions = 1;
+  repeated string subscriptions = 1 [(google.api.resource_reference) = {
+    type: "pubsub.googleapis.com/Subscription"
+  }];
 
   // If not empty, indicates that there may be more subscriptions that match
   // the request; this value should be passed in a new
@@ -281,9 +313,12 @@ message ListTopicSubscriptionsResponse {
 
 // Request for the `ListTopicSnapshots` method.
 message ListTopicSnapshotsRequest {
-  // The name of the topic that snapshots are attached to.
+  // Required. The name of the topic that snapshots are attached to.
   // Format is `projects/{project}/topics/{topic}`.
-  string topic = 1;
+  string topic = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "pubsub.googleapis.com/Topic" }
+  ];
 
   // Maximum number of snapshot names to return.
   int32 page_size = 2;
@@ -307,15 +342,23 @@ message ListTopicSnapshotsResponse {
 
 // Request for the `DeleteTopic` method.
 message DeleteTopicRequest {
-  // Name of the topic to delete.
+  // Required. Name of the topic to delete.
   // Format is `projects/{project}/topics/{topic}`.
-  string topic = 1;
+  string topic = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "pubsub.googleapis.com/Topic" }
+  ];
 }
 
 // The service that an application uses to manipulate subscriptions and to
 // consume messages from a subscription via the `Pull` method or by
 // establishing a bi-directional stream using the `StreamingPull` method.
 service Subscriber {
+  option (google.api.default_host) = "pubsub.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/pubsub";
+
   // Creates a subscription to a given topic. See the
   // 
   // resource name rules.
@@ -334,6 +377,8 @@ service Subscriber {
       put: "/v1/{name=projects/*/subscriptions/*}"
       body: "*"
     };
+    option (google.api.method_signature) =
+        "name,topic,push_config,ack_deadline_seconds";
   }
 
   // Gets the configuration details of a subscription.
@@ -341,6 +386,7 @@ service Subscriber {
     option (google.api.http) = {
       get: "/v1/{subscription=projects/*/subscriptions/*}"
     };
+    option (google.api.method_signature) = "subscription";
   }
 
   // Updates an existing subscription. Note that certain properties of a
@@ -358,6 +404,7 @@ service Subscriber {
     option (google.api.http) = {
       get: "/v1/{project=projects/*}/subscriptions"
     };
+    option (google.api.method_signature) = "project";
   }
 
   // Deletes an existing subscription. All messages retained in the subscription
@@ -370,6 +417,7 @@ service Subscriber {
     option (google.api.http) = {
       delete: "/v1/{subscription=projects/*/subscriptions/*}"
     };
+    option (google.api.method_signature) = "subscription";
   }
 
   // Modifies the ack deadline for a specific message. This method is useful
@@ -383,6 +431,8 @@ service Subscriber {
       post: "/v1/{subscription=projects/*/subscriptions/*}:modifyAckDeadline"
       body: "*"
     };
+    option (google.api.method_signature) =
+        "subscription,ack_ids,ack_deadline_seconds";
   }
 
   // Acknowledges the messages associated with the `ack_ids` in the
@@ -397,6 +447,7 @@ service Subscriber {
       post: "/v1/{subscription=projects/*/subscriptions/*}:acknowledge"
       body: "*"
     };
+    option (google.api.method_signature) = "subscription,ack_ids";
   }
 
   // Pulls messages from the server. The server may return `UNAVAILABLE` if
@@ -407,6 +458,8 @@ service Subscriber {
       post: "/v1/{subscription=projects/*/subscriptions/*}:pull"
       body: "*"
     };
+    option (google.api.method_signature) =
+        "subscription,return_immediately,max_messages";
   }
 
   // Establishes a stream with the server, which sends messages down to the
@@ -431,6 +484,7 @@ service Subscriber {
       post: "/v1/{subscription=projects/*/subscriptions/*}:modifyPushConfig"
       body: "*"
     };
+    option (google.api.method_signature) = "subscription,push_config";
   }
 
   // Gets the configuration details of a snapshot. Snapshots are used in
@@ -442,6 +496,7 @@ service Subscriber {
     option (google.api.http) = {
       get: "/v1/{snapshot=projects/*/snapshots/*}"
     };
+    option (google.api.method_signature) = "snapshot";
   }
 
   // Lists the existing snapshots. Snapshots are used in
@@ -454,6 +509,7 @@ service Subscriber {
     option (google.api.http) = {
       get: "/v1/{project=projects/*}/snapshots"
     };
+    option (google.api.method_signature) = "project";
   }
 
   // Creates a snapshot from the requested subscription. Snapshots are used in
@@ -479,6 +535,7 @@ service Subscriber {
       put: "/v1/{name=projects/*/snapshots/*}"
       body: "*"
     };
+    option (google.api.method_signature) = "name,subscription";
   }
 
   // Updates an existing snapshot. Snapshots are used in
@@ -508,6 +565,7 @@ service Subscriber {
     option (google.api.http) = {
       delete: "/v1/{snapshot=projects/*/snapshots/*}"
     };
+    option (google.api.method_signature) = "snapshot";
   }
 
   // Seeks an existing subscription to a point in time or to a given snapshot,
@@ -528,19 +586,26 @@ service Subscriber {
 
 // A subscription resource.
 message Subscription {
-  // The name of the subscription. It must have the format
+  option (google.api.resource) = {
+    type: "pubsub.googleapis.com/Subscription"
+    pattern: "projects/{project}/subscriptions/{subscription}"
+  };
+
+  // Required. The name of the subscription. It must have the format
   // `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
   // start with a letter, and contain only letters (`[A-Za-z]`), numbers
   // (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
   // plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
   // in length, and it must not start with `"goog"`.
-  string name = 1;
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // The name of the topic from which this subscription is receiving messages.
-  // Format is `projects/{project}/topics/{topic}`.
-  // The value of this field will be `_deleted-topic_` if the topic has been
-  // deleted.
-  string topic = 2;
+  // Required. The name of the topic from which this subscription is receiving
+  // messages. Format is `projects/{project}/topics/{topic}`. The value of this
+  // field will be `_deleted-topic_` if the topic has been deleted.
+  string topic = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "pubsub.googleapis.com/Topic" }
+  ];
 
   // If push delivery is used with this subscription, this field is
   // used to configure it. An empty `pushConfig` signifies that the subscriber
@@ -606,6 +671,91 @@ message Subscription {
   // *default policy* with `ttl` of 31 days will be used. The minimum allowed
   // value for `expiration_policy.ttl` is 1 day.
   ExpirationPolicy expiration_policy = 11;
+
+  // An expression written in the Cloud Pub/Sub filter language. If non-empty,
+  // then only `PubsubMessage`s whose `attributes` field matches the filter are
+  // delivered on this subscription. If empty, then no messages are filtered
+  // out.
+  // EXPERIMENTAL: This feature is part of a closed alpha release. This
+  // API might be changed in backward-incompatible ways and is not recommended
+  // for production use. It is not subject to any SLA or deprecation policy.
+  string filter = 12;
+
+  // A policy that specifies the conditions for dead lettering messages in
+  // this subscription. If dead_letter_policy is not set, dead lettering
+  // is disabled.
+  //
+  // The Cloud Pub/Sub service account associated with this subscriptions's
+  // parent project (i.e.,
+  // service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
+  // permission to Acknowledge() messages on this subscription.
+  DeadLetterPolicy dead_letter_policy = 13;
+
+  // A policy that specifies how Cloud Pub/Sub retries message delivery for this
+  // subscription.
+  //
+  // If not set, the default retry policy is applied. This generally implies
+  // that messages will be retried as soon as possible for healthy subscribers.
+  // RetryPolicy will be triggered on NACKs or acknowledgement deadline
+  // exceeded events for a given message.
+  // EXPERIMENTAL: This API might be changed in backward-incompatible
+  // ways and is not recommended for production use. It is not subject to any
+  // SLA or deprecation policy.
+  RetryPolicy retry_policy = 14;
+}
+
+// A policy that specifies how Cloud Pub/Sub retries message delivery.
+//
+// Retry delay will be exponential based on provided minimum and maximum
+// backoffs. https://en.wikipedia.org/wiki/Exponential_backoff.
+//
+// RetryPolicy will be triggered on NACKs or acknowledgement deadline exceeded
+// events for a given message.
+//
+// Retry Policy is implemented on a best effort basis. At times, the delay
+// between consecutive deliveries may not match the configuration. That is,
+// delay can be more or less than configured backoff.
+message RetryPolicy {
+  // The minimum delay between consecutive deliveries of a given message.
+  // Value should be between 0 and 600 seconds. Defaults to 10 seconds.
+  google.protobuf.Duration minimum_backoff = 1;
+
+  // The maximum delay between consecutive deliveries of a given message.
+  // Value should be between 0 and 600 seconds. Defaults to 600 seconds.
+  google.protobuf.Duration maximum_backoff = 2;
+}
+
+// Dead lettering is done on a best effort basis. The same message might be
+// dead lettered multiple times.
+//
+// If validation on any of the fields fails at subscription creation/updation,
+// the create/update subscription request will fail.
+message DeadLetterPolicy {
+  // The name of the topic to which dead letter messages should be published.
+  // Format is `projects/{project}/topics/{topic}`.The Cloud Pub/Sub service
+  // account associated with the enclosing subscription's parent project (i.e.,
+  // service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
+  // permission to Publish() to this topic.
+  //
+  // The operation will fail if the topic does not exist.
+  // Users should ensure that there is a subscription attached to this topic
+  // since messages published to a topic with no subscriptions are lost.
+  string dead_letter_topic = 1;
+
+  // The maximum number of delivery attempts for any message. The value must be
+  // between 5 and 100.
+  //
+  // The number of delivery attempts is defined as 1 + (the sum of number of
+  // NACKs and number of times the acknowledgement deadline has been exceeded
+  // for the message).
+  //
+  // A NACK is any call to ModifyAckDeadline with a 0 deadline. Note that
+  // client libraries may automatically extend ack_deadlines.
+  //
+  // This field will be honored on a best effort basis.
+  //
+  // If this parameter is 0, a default value of 5 is used.
+  int32 max_delivery_attempts = 2;
 }
 
 // A policy that specifies the conditions for resource expiration (i.e.,
@@ -643,30 +793,30 @@ message PushConfig {
   }
 
   // A URL locating the endpoint to which messages should be pushed.
-  // For example, a Webhook endpoint might use "https://example.com/push".
+  // For example, a Webhook endpoint might use `https://example.com/push`.
   string push_endpoint = 1;
 
-  // Endpoint configuration attributes.
+  // Endpoint configuration attributes that can be used to control different
+  // aspects of the message delivery.
   //
-  // Every endpoint has a set of API supported attributes that can be used to
-  // control different aspects of the message delivery.
-  //
-  // The currently supported attribute is `x-goog-version`, which you can
+  // The only currently supported attribute is `x-goog-version`, which you can
   // use to change the format of the pushed message. This attribute
   // indicates the version of the data expected by the endpoint. This
   // controls the shape of the pushed message (i.e., its fields and metadata).
-  // The endpoint version is based on the version of the Pub/Sub API.
   //
   // If not present during the `CreateSubscription` call, it will default to
-  // the version of the API used to make such call. If not present during a
+  // the version of the Pub/Sub API used to make such call. If not present in a
   // `ModifyPushConfig` call, its value will not be changed. `GetSubscription`
   // calls will always return a valid version, even if the subscription was
   // created without this attribute.
   //
-  // The possible values for this attribute are:
+  // The only supported values for the `x-goog-version` attribute are:
   //
   // * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API.
   // * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
+  //
+  // For example:
+  // 
attributes { "x-goog-version": "v1" } 

   map attributes = 2;
 
   // An authentication method used by push endpoints to verify the source of
@@ -688,30 +838,59 @@ message ReceivedMessage {
 
   // The message.
   PubsubMessage message = 2;
+
+  // The approximate number of times that Cloud Pub/Sub has attempted to deliver
+  // the associated message to a subscriber.
+  //
+  // More precisely, this is 1 + (number of NACKs) +
+  // (number of ack_deadline exceeds) for this message.
+  //
+  // A NACK is any call to ModifyAckDeadline with a 0 deadline. An ack_deadline
+  // exceeds event is whenever a message is not acknowledged within
+  // ack_deadline. Note that ack_deadline is initially
+  // Subscription.ackDeadlineSeconds, but may get extended automatically by
+  // the client library.
+  //
+  // Upon the first delivery of a given message, `delivery_attempt` will have a
+  // value of 1. The value is calculated at best effort and is approximate.
+  //
+  // If a DeadLetterPolicy is not set on the subscription, this will be 0.
+  int32 delivery_attempt = 3;
 }
 
 // Request for the GetSubscription method.
 message GetSubscriptionRequest {
-  // The name of the subscription to get.
+  // Required. The name of the subscription to get.
   // Format is `projects/{project}/subscriptions/{sub}`.
-  string subscription = 1;
+  string subscription = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "pubsub.googleapis.com/Subscription"
+    }
+  ];
 }
 
 // Request for the UpdateSubscription method.
 message UpdateSubscriptionRequest {
-  // The updated subscription object.
-  Subscription subscription = 1;
+  // Required. The updated subscription object.
+  Subscription subscription = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Indicates which fields in the provided subscription to update.
+  // Required. Indicates which fields in the provided subscription to update.
   // Must be specified and non-empty.
-  google.protobuf.FieldMask update_mask = 2;
+  google.protobuf.FieldMask update_mask = 2
+      [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for the `ListSubscriptions` method.
 message ListSubscriptionsRequest {
-  // The name of the project in which to list subscriptions.
+  // Required. The name of the project in which to list subscriptions.
   // Format is `projects/{project-id}`.
-  string project = 1;
+  string project = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
   // Maximum number of subscriptions to return.
   int32 page_size = 2;
@@ -735,41 +914,61 @@ message ListSubscriptionsResponse {
 
 // Request for the DeleteSubscription method.
 message DeleteSubscriptionRequest {
-  // The subscription to delete.
+  // Required. The subscription to delete.
   // Format is `projects/{project}/subscriptions/{sub}`.
-  string subscription = 1;
+  string subscription = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "pubsub.googleapis.com/Subscription"
+    }
+  ];
 }
 
 // Request for the ModifyPushConfig method.
 message ModifyPushConfigRequest {
-  // The name of the subscription.
+  // Required. The name of the subscription.
   // Format is `projects/{project}/subscriptions/{sub}`.
-  string subscription = 1;
-
-  // The push configuration for future deliveries.
+  string subscription = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "pubsub.googleapis.com/Subscription"
+    }
+  ];
+
+  // Required. The push configuration for future deliveries.
   //
   // An empty `pushConfig` indicates that the Pub/Sub system should
   // stop pushing messages from the given subscription and allow
   // messages to be pulled and acknowledged - effectively pausing
   // the subscription if `Pull` or `StreamingPull` is not called.
-  PushConfig push_config = 2;
+  PushConfig push_config = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for the `Pull` method.
 message PullRequest {
-  // The subscription from which messages should be pulled.
+  // Required. The subscription from which messages should be pulled.
   // Format is `projects/{project}/subscriptions/{sub}`.
-  string subscription = 1;
-
-  // If this field set to true, the system will respond immediately even if
-  // it there are no messages available to return in the `Pull` response.
-  // Otherwise, the system may wait (for a bounded amount of time) until at
-  // least one message is available, rather than returning no messages.
-  bool return_immediately = 2;
-
-  // The maximum number of messages returned for this request. The Pub/Sub
-  // system may return fewer than the number specified.
-  int32 max_messages = 3;
+  string subscription = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "pubsub.googleapis.com/Subscription"
+    }
+  ];
+
+  // Optional. If this field set to true, the system will respond immediately
+  // even if it there are no messages available to return in the `Pull`
+  // response. Otherwise, the system may wait (for a bounded amount of time)
+  // until at least one message is available, rather than returning no messages.
+  // Warning: setting this field to `true` is discouraged because it adversely
+  // impacts the performance of `Pull` operations. We recommend that users do
+  // not set this field.
+  bool return_immediately = 2
+      [deprecated = true, (google.api.field_behavior) = OPTIONAL];
+
+  // Required. The maximum number of messages to return for this request. Must
+  // be a positive integer. The Pub/Sub system may return fewer than the number
+  // specified.
+  int32 max_messages = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response for the `Pull` method.
@@ -783,44 +982,60 @@ message PullResponse {
 
 // Request for the ModifyAckDeadline method.
 message ModifyAckDeadlineRequest {
-  // The name of the subscription.
+  // Required. The name of the subscription.
   // Format is `projects/{project}/subscriptions/{sub}`.
-  string subscription = 1;
-
-  // List of acknowledgment IDs.
-  repeated string ack_ids = 4;
-
-  // The new ack deadline with respect to the time this request was sent to
-  // the Pub/Sub system. For example, if the value is 10, the new
-  // ack deadline will expire 10 seconds after the `ModifyAckDeadline` call
-  // was made. Specifying zero might immediately make the message available for
+  string subscription = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "pubsub.googleapis.com/Subscription"
+    }
+  ];
+
+  // Required. List of acknowledgment IDs.
+  repeated string ack_ids = 4 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The new ack deadline with respect to the time this request was
+  // sent to the Pub/Sub system. For example, if the value is 10, the new ack
+  // deadline will expire 10 seconds after the `ModifyAckDeadline` call was
+  // made. Specifying zero might immediately make the message available for
   // delivery to another subscriber client. This typically results in an
   // increase in the rate of message redeliveries (that is, duplicates).
   // The minimum deadline you can specify is 0 seconds.
   // The maximum deadline you can specify is 600 seconds (10 minutes).
-  int32 ack_deadline_seconds = 3;
+  int32 ack_deadline_seconds = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for the Acknowledge method.
 message AcknowledgeRequest {
-  // The subscription whose message is being acknowledged.
+  // Required. The subscription whose message is being acknowledged.
   // Format is `projects/{project}/subscriptions/{sub}`.
-  string subscription = 1;
-
-  // The acknowledgment ID for the messages being acknowledged that was returned
-  // by the Pub/Sub system in the `Pull` response. Must not be empty.
-  repeated string ack_ids = 2;
+  string subscription = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "pubsub.googleapis.com/Subscription"
+    }
+  ];
+
+  // Required. The acknowledgment ID for the messages being acknowledged that
+  // was returned by the Pub/Sub system in the `Pull` response. Must not be
+  // empty.
+  repeated string ack_ids = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request for the `StreamingPull` streaming RPC method. This request is used to
 // establish the initial stream as well as to stream acknowledgements and ack
 // deadline modifications from the client to the server.
 message StreamingPullRequest {
-  // The subscription for which to initialize the new stream. This must be
-  // provided in the first request on the stream, and must not be set in
+  // Required. The subscription for which to initialize the new stream. This
+  // must be provided in the first request on the stream, and must not be set in
   // subsequent requests from client to server.
   // Format is `projects/{project}/subscriptions/{sub}`.
-  string subscription = 1;
+  string subscription = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "pubsub.googleapis.com/Subscription"
+    }
+  ];
 
   // List of acknowledgement IDs for acknowledging previously received messages
   // (received on this stream or a different stream). If an ack ID has expired,
@@ -849,11 +1064,20 @@ message StreamingPullRequest {
   // processing was interrupted.
   repeated string modify_deadline_ack_ids = 4;
 
-  // The ack deadline to use for the stream. This must be provided in the
-  // first request on the stream, but it can also be updated on subsequent
+  // Required. The ack deadline to use for the stream. This must be provided in
+  // the first request on the stream, but it can also be updated on subsequent
   // requests from client to server. The minimum deadline you can specify is 10
   // seconds. The maximum deadline you can specify is 600 seconds (10 minutes).
-  int32 stream_ack_deadline_seconds = 5;
+  int32 stream_ack_deadline_seconds = 5
+      [(google.api.field_behavior) = REQUIRED];
+
+  // A unique identifier that is used to distinguish client instances from each
+  // other. Only needs to be provided on the initial request. When a stream
+  // disconnects and reconnects for the same stream, the client_id should be set
+  // to the same value so that state associated with the old stream can be
+  // transferred to the new stream. The same client_id should not be used for
+  // different client instances.
+  string client_id = 6;
 }
 
 // Response for the `StreamingPull` method. This response is used to stream
@@ -865,16 +1089,18 @@ message StreamingPullResponse {
 
 // Request for the `CreateSnapshot` method.
 message CreateSnapshotRequest {
-  // Optional user-provided name for this snapshot.
-  // If the name is not provided in the request, the server will assign a random
-  // name for this snapshot on the same project as the subscription.
-  // Note that for REST API requests, you must specify a name.  See the
-  // 
-  // resource name rules.
-  // Format is `projects/{project}/snapshots/{snap}`.
-  string name = 1;
-
-  // The subscription whose backlog the snapshot retains.
+  // Required. User-provided name for this snapshot. If the name is not provided
+  // in the request, the server will assign a random name for this snapshot on
+  // the same project as the subscription. Note that for REST API requests, you
+  // must specify a name.  See the  resource
+  // name rules. Format is `projects/{project}/snapshots/{snap}`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "pubsub.googleapis.com/Snapshot" }
+  ];
+
+  // Required. The subscription whose backlog the snapshot retains.
   // Specifically, the created snapshot is guaranteed to retain:
   //  (a) The existing backlog on the subscription. More precisely, this is
   //      defined as the messages in the subscription's backlog that are
@@ -883,7 +1109,12 @@ message CreateSnapshotRequest {
   //  (b) Any messages published to the subscription's topic following the
   //      successful completion of the CreateSnapshot request.
   // Format is `projects/{project}/subscriptions/{sub}`.
-  string subscription = 2;
+  string subscription = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "pubsub.googleapis.com/Subscription"
+    }
+  ];
 
   // See  Creating and
   // managing labels.
@@ -892,12 +1123,13 @@ message CreateSnapshotRequest {
 
 // Request for the UpdateSnapshot method.
 message UpdateSnapshotRequest {
-  // The updated snapshot object.
-  Snapshot snapshot = 1;
+  // Required. The updated snapshot object.
+  Snapshot snapshot = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // Indicates which fields in the provided snapshot to update.
+  // Required. Indicates which fields in the provided snapshot to update.
   // Must be specified and non-empty.
-  google.protobuf.FieldMask update_mask = 2;
+  google.protobuf.FieldMask update_mask = 2
+      [(google.api.field_behavior) = REQUIRED];
 }
 
 // A snapshot resource. Snapshots are used in
@@ -907,11 +1139,18 @@ message UpdateSnapshotRequest {
 // acknowledgment state of messages in an existing subscription to the state
 // captured by a snapshot.
 message Snapshot {
+  option (google.api.resource) = {
+    type: "pubsub.googleapis.com/Snapshot"
+    pattern: "projects/{project}/snapshots/{snapshot}"
+  };
+
   // The name of the snapshot.
   string name = 1;
 
   // The name of the topic from which this snapshot is retaining messages.
-  string topic = 2;
+  string topic = 2 [
+    (google.api.resource_reference) = { type: "pubsub.googleapis.com/Topic" }
+  ];
 
   // The snapshot is guaranteed to exist up until this time.
   // A newly-created snapshot expires no later than 7 days from the time of its
@@ -932,16 +1171,24 @@ message Snapshot {
 
 // Request for the GetSnapshot method.
 message GetSnapshotRequest {
-  // The name of the snapshot to get.
+  // Required. The name of the snapshot to get.
   // Format is `projects/{project}/snapshots/{snap}`.
-  string snapshot = 1;
+  string snapshot = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "pubsub.googleapis.com/Snapshot" }
+  ];
 }
 
 // Request for the `ListSnapshots` method.
 message ListSnapshotsRequest {
-  // The name of the project in which to list snapshots.
+  // Required. The name of the project in which to list snapshots.
   // Format is `projects/{project-id}`.
-  string project = 1;
+  string project = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
   // Maximum number of snapshots to return.
   int32 page_size = 2;
@@ -964,15 +1211,23 @@ message ListSnapshotsResponse {
 
 // Request for the `DeleteSnapshot` method.
 message DeleteSnapshotRequest {
-  // The name of the snapshot to delete.
+  // Required. The name of the snapshot to delete.
   // Format is `projects/{project}/snapshots/{snap}`.
-  string snapshot = 1;
+  string snapshot = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = { type: "pubsub.googleapis.com/Snapshot" }
+  ];
 }
 
 // Request for the `Seek` method.
 message SeekRequest {
-  // The subscription to affect.
-  string subscription = 1;
+  // Required. The subscription to affect.
+  string subscription = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "pubsub.googleapis.com/Subscription"
+    }
+  ];
 
   oneof target {
     // The time to seek to.
@@ -991,7 +1246,9 @@ message SeekRequest {
     // The snapshot to seek to. The snapshot's topic must be the same as that of
     // the provided subscription.
     // Format is `projects/{project}/snapshots/{snap}`.
-    string snapshot = 3;
+    string snapshot = 3 [(google.api.resource_reference) = {
+      type: "pubsub.googleapis.com/Snapshot"
+    }];
   }
 }
 
diff --git a/third_party/googleapis/google/pubsub/v1/pubsub_gapic.legacy.yaml b/third_party/googleapis/google/pubsub/v1/pubsub_gapic.legacy.yaml
new file mode 100644
index 000000000..5ce808d51
--- /dev/null
+++ b/third_party/googleapis/google/pubsub/v1/pubsub_gapic.legacy.yaml
@@ -0,0 +1,706 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.pubsub.v1
+    interface_names:
+      google.pubsub.v1.Publisher: TopicAdmin
+      google.pubsub.v1.Subscriber: SubscriptionAdmin
+    release_level: GA
+  python:
+    package_name: google.cloud.pubsub_v1.gapic
+    release_level: GA
+  go:
+    package_name: cloud.google.com/go/pubsub/apiv1
+    domain_layer_location: cloud.google.com/go/pubsub
+    release_level: GA
+  csharp:
+    package_name: Google.Cloud.PubSub.V1
+    interface_names:
+      google.pubsub.v1.Publisher: PublisherServiceApi
+      google.pubsub.v1.Subscriber: SubscriberServiceApi
+    release_level: GA
+  ruby:
+    package_name: Google::Cloud::PubSub::V1
+    release_level: BETA
+  php:
+    package_name: Google\Cloud\PubSub\V1
+    release_level: GA
+  nodejs:
+    package_name: pubsub.v1
+    domain_layer_location: google-cloud
+    release_level: GA
+collection_oneofs:
+- oneof_name: topic_oneof
+  collection_names:
+  - topic
+  - deleted_topic
+collections:
+- name_pattern: projects/{project}
+  entity_name: project
+  language_overrides:
+  - language: csharp
+    common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
+- name_pattern: projects/{project}/snapshots/{snapshot}
+  entity_name: snapshot
+  language_overrides:
+  - language: java
+    entity_name: project_snapshot
+- name_pattern: projects/{project}/subscriptions/{subscription}
+  entity_name: subscription
+  language_overrides:
+  - language: java
+    entity_name: project_subscription
+- name_pattern: projects/{project}/topics/{topic}
+  entity_name: topic
+  language_overrides:
+  - language: java
+    entity_name: project_topic
+- name_pattern: _deleted-topic_
+  entity_name: deleted_topic
+interfaces:
+- name: google.pubsub.v1.Subscriber
+  lang_doc:
+    java: To retrieve messages from a subscription, see the Subscriber class.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNKNOWN
+    - ABORTED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes:
+    - UNAVAILABLE
+  - name: streaming_pull
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - RESOURCE_EXHAUSTED
+    - ABORTED
+    - INTERNAL
+    - UNAVAILABLE
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000  # 60 seconds
+    initial_rpc_timeout_millis: 60000  # 60 seconds
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 60000  # 60 seconds
+    total_timeout_millis: 600000  # 10 minutes
+  - name: messaging
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000  # 60 seconds
+    initial_rpc_timeout_millis: 25000  # 25 seconds
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 25000  # 25 seconds
+    total_timeout_millis: 600000  # 10 minutes
+  - name: streaming_messaging
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000  # 60 seconds
+    initial_rpc_timeout_millis: 600000  # 10 minutes
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 600000  # 10 minutes
+    total_timeout_millis: 600000  # 10 minutes
+  methods:
+  - name: CreateSubscription
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - topic
+        - push_config
+        - ack_deadline_seconds
+    required_fields:
+    - name
+    - topic
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: subscription
+      topic: topic
+    timeout_millis: 60000
+  - name: GetSubscription
+    flattening:
+      groups:
+      - parameters:
+        - subscription
+    required_fields:
+    - subscription
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      subscription: subscription
+    timeout_millis: 60000
+  - name: UpdateSubscription
+    required_fields:
+    - subscription
+    - update_mask
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    sample_code_init_fields:
+    - update_mask.paths[0]="ack_deadline_seconds"
+    - subscription.ack_deadline_seconds=42
+  - name: ListSubscriptions
+    flattening:
+      groups:
+      - parameters:
+        - project
+    required_fields:
+    - project
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: subscriptions
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      project: project
+    timeout_millis: 60000
+  - name: DeleteSubscription
+    flattening:
+      groups:
+      - parameters:
+        - subscription
+    required_fields:
+    - subscription
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      subscription: subscription
+    timeout_millis: 60000
+  - name: GetSnapshot
+    surface_treatments:
+    - include_languages:
+      - go
+      - java
+      - csharp
+      - ruby
+      - nodejs
+      - python
+      - php
+      visibility: DISABLED
+  - name: ModifyAckDeadline
+    flattening:
+      groups:
+      - parameters:
+        - subscription
+        - ack_ids
+        - ack_deadline_seconds
+    required_fields:
+    - subscription
+    - ack_ids
+    - ack_deadline_seconds
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      subscription: subscription
+    timeout_millis: 60000
+    surface_treatments:
+    - include_languages:
+      - java
+      visibility: PACKAGE
+  - name: Acknowledge
+    flattening:
+      groups:
+      - parameters:
+        - subscription
+        - ack_ids
+    required_fields:
+    - subscription
+    - ack_ids
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: messaging
+    field_name_patterns:
+      subscription: subscription
+    timeout_millis: 60000
+    surface_treatments:
+    - include_languages:
+      - java
+      visibility: PACKAGE
+  - name: Pull
+    flattening:
+      groups:
+      - parameters:
+        - subscription
+        - return_immediately
+        - max_messages
+    required_fields:
+    - subscription
+    - max_messages
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: messaging
+    field_name_patterns:
+      subscription: subscription
+    timeout_millis: 60000
+    surface_treatments:
+    - include_languages:
+      - java
+      visibility: PACKAGE
+  - name: StreamingPull
+    required_fields:
+    - subscription
+    - stream_ack_deadline_seconds
+    grpc_streaming:
+      response:
+        resources_field: received_messages
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: streaming_pull
+    retry_params_name: streaming_messaging
+    field_name_patterns:
+      subscription: subscription
+    timeout_millis: 900000
+    surface_treatments:
+    - include_languages:
+      - java
+      visibility: PACKAGE
+  - name: ModifyPushConfig
+    flattening:
+      groups:
+      - parameters:
+        - subscription
+        - push_config
+    required_fields:
+    - subscription
+    - push_config
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      subscription: subscription
+    timeout_millis: 60000
+  - name: ListSnapshots
+    flattening:
+      groups:
+      - parameters:
+        - project
+    required_fields:
+    - project
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: snapshots
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      project: project
+    timeout_millis: 60000
+  - name: CreateSnapshot
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - subscription
+    required_fields:
+    - name
+    - subscription
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: snapshot
+      subscription: subscription
+    timeout_millis: 60000
+  - name: UpdateSnapshot
+    required_fields:
+    - snapshot
+    - update_mask
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+    sample_code_init_fields:
+    - update_mask.paths[0]="expire_time"
+    - snapshot.expire_time.seconds=123456
+  - name: DeleteSnapshot
+    flattening:
+      groups:
+      - parameters:
+        - snapshot
+    required_fields:
+    - snapshot
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      snapshot: snapshot
+    timeout_millis: 60000
+  - name: Seek
+    # Not including flattening until oneof support.
+    # https://github.com/googleapis/toolkit/issues/1057
+    required_fields:
+    - subscription
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      subscription: subscription
+    timeout_millis: 60000
+  - name: SetIamPolicy
+    flattening:
+      groups:
+      - parameters:
+        - resource
+        - policy
+    required_fields:
+    - resource
+    - policy
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: subscription
+    timeout_millis: 60000
+    reroute_to_grpc_interface: google.iam.v1.IAMPolicy
+    surface_treatments:
+    - include_languages:
+      - go
+      visibility: DISABLED
+  - name: GetIamPolicy
+    flattening:
+      groups:
+      - parameters:
+        - resource
+    required_fields:
+    - resource
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: subscription
+    timeout_millis: 60000
+    reroute_to_grpc_interface: google.iam.v1.IAMPolicy
+    surface_treatments:
+    - include_languages:
+      - go
+      visibility: DISABLED
+  - name: TestIamPermissions
+    flattening:
+      groups:
+      - parameters:
+        - resource
+        - permissions
+    required_fields:
+    - resource
+    - permissions
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: subscription
+    timeout_millis: 60000
+    reroute_to_grpc_interface: google.iam.v1.IAMPolicy
+    surface_treatments:
+    - include_languages:
+      - go
+      visibility: DISABLED
+- name: google.pubsub.v1.Publisher
+  lang_doc:
+    java: To publish messages to a topic, see the Publisher class.
+  smoke_test:
+    method: ListTopics
+    init_fields:
+    - project%project=$PROJECT_ID
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNKNOWN
+    - ABORTED
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes:
+    - UNAVAILABLE
+  - name: none
+    retry_codes: []
+  - name: publish
+    retry_codes:
+    - ABORTED
+    - CANCELLED
+    - INTERNAL
+    - RESOURCE_EXHAUSTED
+    - UNKNOWN
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000  # 60 seconds
+    initial_rpc_timeout_millis: 60000  # 60 seconds
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 60000  # 60 seconds
+    total_timeout_millis: 600000  # 10 minutes
+  - name: messaging
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000  # 60 seconds
+    initial_rpc_timeout_millis: 5000  # 5 seconds
+    rpc_timeout_multiplier: 1.3
+    max_rpc_timeout_millis: 60000  # 60 seconds
+    total_timeout_millis: 60000  # 60 seconds
+  methods:
+  - name: CreateTopic
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: topic
+    timeout_millis: 60000
+  - name: UpdateTopic
+    required_fields:
+    - topic
+    - update_mask
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 60000
+  - name: Publish
+    flattening:
+      groups:
+      - parameters:
+        - topic
+        - messages
+    required_fields:
+    - topic
+    - messages
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: publish
+    retry_params_name: messaging
+    batching:
+      thresholds:
+        element_count_threshold: 100
+        element_count_limit: 1000     # TO BE REMOVED LATER
+        request_byte_threshold: 1048576  # 1 MiB
+        request_byte_limit: 10485760  # TO BE REMOVED LATER
+        delay_threshold_millis: 10
+      batch_descriptor:
+        batched_field: messages
+        discriminator_fields:
+        - topic
+        subresponse_field: message_ids
+    field_name_patterns:
+      topic: topic
+    sample_code_init_fields:
+    - messages[0].data
+    timeout_millis: 60000
+    surface_treatments:
+    - include_languages:
+      - java
+      visibility: PACKAGE
+  - name: GetTopic
+    flattening:
+      groups:
+      - parameters:
+        - topic
+    required_fields:
+    - topic
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      topic: topic
+    timeout_millis: 60000
+  - name: ListTopics
+    flattening:
+      groups:
+      - parameters:
+        - project
+    required_fields:
+    - project
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: topics
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      project: project
+    timeout_millis: 60000
+  - name: ListTopicSubscriptions
+    flattening:
+      groups:
+      - parameters:
+        - topic
+    required_fields:
+    - topic
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: subscriptions
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      topic: topic
+    timeout_millis: 60000
+  - name: ListTopicSnapshots
+    surface_treatments:
+    - include_languages:
+      - go
+      - java
+      - csharp
+      - ruby
+      - nodejs
+      - python
+      - php
+      visibility: DISABLED
+  - name: DeleteTopic
+    flattening:
+      groups:
+      - parameters:
+        - topic
+    required_fields:
+    - topic
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      topic: topic
+    timeout_millis: 60000
+  - name: SetIamPolicy
+    flattening:
+      groups:
+      - parameters:
+        - resource
+        - policy
+    required_fields:
+    - resource
+    - policy
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: topic
+    timeout_millis: 60000
+    reroute_to_grpc_interface: google.iam.v1.IAMPolicy
+    surface_treatments:
+    - include_languages:
+      - go
+      visibility: DISABLED
+  - name: GetIamPolicy
+    flattening:
+      groups:
+      - parameters:
+        - resource
+    required_fields:
+    - resource
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: topic
+    timeout_millis: 60000
+    reroute_to_grpc_interface: google.iam.v1.IAMPolicy
+    surface_treatments:
+    - include_languages:
+      - go
+      visibility: DISABLED
+  - name: TestIamPermissions
+    flattening:
+      groups:
+      - parameters:
+        - resource
+        - permissions
+    required_fields:
+    - resource
+    - permissions
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: topic
+    timeout_millis: 60000
+    reroute_to_grpc_interface: google.iam.v1.IAMPolicy
+    surface_treatments:
+    - include_languages:
+      - go
+      visibility: DISABLED
+resource_name_generation:
+- message_name: Topic
+  field_entity_map:
+    name: topic
+- message_name: GetTopicRequest
+  field_entity_map:
+    topic: topic
+- message_name: PublishRequest
+  field_entity_map:
+    topic: topic
+- message_name: ListTopicsRequest
+  field_entity_map:
+    project: project
+- message_name: ListTopicSubscriptionsRequest
+  field_entity_map:
+    topic: topic
+- message_name: ListTopicSubscriptionsResponse
+  field_entity_map:
+    subscriptions: subscription
+- message_name: DeleteTopicRequest
+  field_entity_map:
+    topic: topic
+- message_name: Subscription
+  field_entity_map:
+    name: subscription
+    topic: topic_oneof
+- message_name: GetSubscriptionRequest
+  field_entity_map:
+    subscription: subscription
+- message_name: ListSubscriptionsRequest
+  field_entity_map:
+    project: project
+- message_name: DeleteSubscriptionRequest
+  field_entity_map:
+    subscription: subscription
+- message_name: ModifyPushConfigRequest
+  field_entity_map:
+    subscription: subscription
+- message_name: PullRequest
+  field_entity_map:
+    subscription: subscription
+- message_name: ModifyAckDeadlineRequest
+  field_entity_map:
+    subscription: subscription
+- message_name: AcknowledgeRequest
+  field_entity_map:
+    subscription: subscription
+- message_name: StreamingPullRequest
+  field_entity_map:
+    subscription: subscription
+- message_name: Snapshot
+  field_entity_map:
+    name: snapshot
+    topic: topic
+- message_name: CreateSnapshotRequest
+  field_entity_map:
+    name: snapshot
+    subscription: subscription
+- message_name: ListSnapshotsRequest
+  field_entity_map:
+    project: project
+- message_name: DeleteSnapshotRequest
+  field_entity_map:
+    snapshot: snapshot
+- message_name: SeekRequest
+  field_entity_map:
+    subscription: subscription
+    snapshot: snapshot
diff --git a/third_party/googleapis/google/pubsub/v1/pubsub_gapic.yaml b/third_party/googleapis/google/pubsub/v1/pubsub_gapic.yaml
index 59354746e..e26d535fa 100644
--- a/third_party/googleapis/google/pubsub/v1/pubsub_gapic.yaml
+++ b/third_party/googleapis/google/pubsub/v1/pubsub_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.pubsub.v1
@@ -30,36 +30,23 @@ language_settings:
     package_name: pubsub.v1
     domain_layer_location: google-cloud
     release_level: GA
-collection_oneofs:
-- oneof_name: topic_oneof
-  collection_names:
-  - topic
-  - deleted_topic
 collections:
-- name_pattern: projects/{project}
-  entity_name: project
-  language_overrides:
-  - language: csharp
-    common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
-- name_pattern: projects/{project}/snapshots/{snapshot}
-  entity_name: snapshot
+# Language overrides are for backward-compatibility in Java.
+- entity_name: snapshot
   language_overrides:
   - language: java
     entity_name: project_snapshot
-- name_pattern: projects/{project}/subscriptions/{subscription}
-  entity_name: subscription
+# Language overrides are for backward-compatibility in Java.
+- entity_name: subscription
   language_overrides:
   - language: java
     entity_name: project_subscription
-- name_pattern: projects/{project}/topics/{topic}
-  entity_name: topic
-  language_overrides:
-  - language: java
-    entity_name: project_topic
-- name_pattern: _deleted-topic_
-  entity_name: deleted_topic
 interfaces:
 - name: google.pubsub.v1.Subscriber
+  # Deprecated collections are for backward-compatibility in Ruby, PHP and Python
+  deprecated_collections:
+  - name_pattern: "projects/{project}/topics/{topic}"
+    entity_name: topic
   lang_doc:
     java: To retrieve messages from a subscription, see the Subscriber class.
   retry_codes_def:
@@ -71,8 +58,13 @@ interfaces:
   - name: non_idempotent
     retry_codes:
     - UNAVAILABLE
-  - name: none
-    retry_codes: []
+  - name: streaming_pull
+    retry_codes:
+    - DEADLINE_EXCEEDED
+    - RESOURCE_EXHAUSTED
+    - ABORTED
+    - INTERNAL
+    - UNAVAILABLE
   retry_params_def:
   - name: default
     initial_retry_delay_millis: 100
@@ -99,80 +91,22 @@ interfaces:
     max_rpc_timeout_millis: 600000  # 10 minutes
     total_timeout_millis: 600000  # 10 minutes
   methods:
+  # TODO: remove the per method retry_codes_name field once
+  # https://github.com/googleapis/gapic-generator/issues/3137
+  # is fixed
   - name: CreateSubscription
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - topic
-        - push_config
-        - ack_deadline_seconds
-    required_fields:
-    - name
-    - topic
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: subscription
-      topic: topic
-    timeout_millis: 60000
   - name: GetSubscription
-    flattening:
-      groups:
-      - parameters:
-        - subscription
-    required_fields:
-    - subscription
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      subscription: subscription
-    timeout_millis: 60000
   - name: UpdateSubscription
-    required_fields:
-    - subscription
-    - update_mask
     retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
     sample_code_init_fields:
     - update_mask.paths[0]="ack_deadline_seconds"
     - subscription.ack_deadline_seconds=42
   - name: ListSubscriptions
-    flattening:
-      groups:
-      - parameters:
-        - project
-    required_fields:
-    - project
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: subscriptions
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      project: project
-    timeout_millis: 60000
   - name: DeleteSubscription
-    flattening:
-      groups:
-      - parameters:
-        - subscription
-    required_fields:
-    - subscription
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      subscription: subscription
-    timeout_millis: 60000
   - name: GetSnapshot
     surface_treatments:
     - include_languages:
@@ -183,219 +117,66 @@ interfaces:
       - nodejs
       - python
       - php
-      visibility: DISABLED
+      visibility: PACKAGE
   - name: ModifyAckDeadline
-    flattening:
-      groups:
-      - parameters:
-        - subscription
-        - ack_ids
-        - ack_deadline_seconds
-    required_fields:
-    - subscription
-    - ack_ids
-    - ack_deadline_seconds
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      subscription: subscription
-    timeout_millis: 60000
     surface_treatments:
     - include_languages:
       - java
       visibility: PACKAGE
   - name: Acknowledge
-    flattening:
-      groups:
-      - parameters:
-        - subscription
-        - ack_ids
-    required_fields:
-    - subscription
-    - ack_ids
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: non_idempotent
     retry_params_name: messaging
-    field_name_patterns:
-      subscription: subscription
-    timeout_millis: 60000
     surface_treatments:
     - include_languages:
       - java
       visibility: PACKAGE
   - name: Pull
-    flattening:
-      groups:
-      - parameters:
-        - subscription
-        - return_immediately
-        - max_messages
-    required_fields:
-    - subscription
-    - max_messages
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: messaging
-    field_name_patterns:
-      subscription: subscription
-    timeout_millis: 60000
     surface_treatments:
     - include_languages:
       - java
       visibility: PACKAGE
   - name: StreamingPull
-    required_fields:
-    - subscription
-    - stream_ack_deadline_seconds
-    grpc_streaming:
-      response:
-        resources_field: received_messages
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: none
+    retry_codes_name: streaming_pull
     retry_params_name: streaming_messaging
-    field_name_patterns:
-      subscription: subscription
     timeout_millis: 900000
     surface_treatments:
     - include_languages:
       - java
       visibility: PACKAGE
   - name: ModifyPushConfig
-    flattening:
-      groups:
-      - parameters:
-        - subscription
-        - push_config
-    required_fields:
-    - subscription
-    - push_config
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      subscription: subscription
-    timeout_millis: 60000
   - name: ListSnapshots
-    flattening:
-      groups:
-      - parameters:
-        - project
-    required_fields:
-    - project
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: snapshots
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      project: project
-    timeout_millis: 60000
   - name: CreateSnapshot
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - subscription
-    required_fields:
-    - name
-    - subscription
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: snapshot
-      subscription: subscription
-    timeout_millis: 60000
   - name: UpdateSnapshot
-    required_fields:
-    - snapshot
-    - update_mask
     retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
     sample_code_init_fields:
     - update_mask.paths[0]="expire_time"
     - snapshot.expire_time.seconds=123456
   - name: DeleteSnapshot
-    flattening:
-      groups:
-      - parameters:
-        - snapshot
-    required_fields:
-    - snapshot
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      snapshot: snapshot
-    timeout_millis: 60000
   - name: Seek
-    # Not including flattening until oneof support.
-    # https://github.com/googleapis/toolkit/issues/1057
-    required_fields:
-    - subscription
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      subscription: subscription
-    timeout_millis: 60000
   - name: SetIamPolicy
-    flattening:
-      groups:
-      - parameters:
-        - resource
-        - policy
-    required_fields:
-    - resource
-    - policy
     retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      resource: subscription
-    timeout_millis: 60000
     reroute_to_grpc_interface: google.iam.v1.IAMPolicy
     surface_treatments:
     - include_languages:
       - go
       visibility: DISABLED
   - name: GetIamPolicy
-    flattening:
-      groups:
-      - parameters:
-        - resource
-    required_fields:
-    - resource
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      resource: subscription
-    timeout_millis: 60000
     reroute_to_grpc_interface: google.iam.v1.IAMPolicy
     surface_treatments:
     - include_languages:
       - go
       visibility: DISABLED
   - name: TestIamPermissions
-    flattening:
-      groups:
-      - parameters:
-        - resource
-        - permissions
-    required_fields:
-    - resource
-    - permissions
     retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      resource: subscription
-    timeout_millis: 60000
     reroute_to_grpc_interface: google.iam.v1.IAMPolicy
     surface_treatments:
     - include_languages:
@@ -441,117 +222,42 @@ interfaces:
     initial_retry_delay_millis: 100
     retry_delay_multiplier: 1.3
     max_retry_delay_millis: 60000  # 60 seconds
-    initial_rpc_timeout_millis: 25000  # 25 seconds
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 30000  # 30 seconds
-    total_timeout_millis: 600000  # 10 minutes
+    initial_rpc_timeout_millis: 5000  # 5 seconds
+    rpc_timeout_multiplier: 1.3
+    max_rpc_timeout_millis: 60000  # 60 seconds
+    total_timeout_millis: 60000  # 60 seconds
   methods:
   - name: CreateTopic
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: topic
-    timeout_millis: 60000
   - name: UpdateTopic
-    required_fields:
-    - topic
-    - update_mask
     retry_codes_name: non_idempotent
-    retry_params_name: default
-    timeout_millis: 60000
   - name: Publish
-    flattening:
-      groups:
-      - parameters:
-        - topic
-        - messages
-    required_fields:
-    - topic
-    - messages
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: publish
     retry_params_name: messaging
     batching:
       thresholds:
-        element_count_threshold: 10
-        element_count_limit: 1000 # TO BE REMOVED LATER
-        request_byte_threshold: 1024 # 1 Kb
-        request_byte_limit: 10485760 # TO BE REMOVED LATER
+        element_count_threshold: 100
+        element_count_limit: 1000     # TO BE REMOVED LATER
+        request_byte_threshold: 1048576  # 1 MiB
+        request_byte_limit: 10485760  # TO BE REMOVED LATER
         delay_threshold_millis: 10
       batch_descriptor:
         batched_field: messages
         discriminator_fields:
         - topic
         subresponse_field: message_ids
-    field_name_patterns:
-      topic: topic
     sample_code_init_fields:
     - messages[0].data
-    timeout_millis: 60000
     surface_treatments:
     - include_languages:
       - java
       visibility: PACKAGE
   - name: GetTopic
-    flattening:
-      groups:
-      - parameters:
-        - topic
-    required_fields:
-    - topic
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      topic: topic
-    timeout_millis: 60000
   - name: ListTopics
-    flattening:
-      groups:
-      - parameters:
-        - project
-    required_fields:
-    - project
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: topics
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      project: project
-    timeout_millis: 60000
   - name: ListTopicSubscriptions
-    flattening:
-      groups:
-      - parameters:
-        - topic
-    required_fields:
-    - topic
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: subscriptions
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      topic: topic
-    timeout_millis: 60000
   - name: ListTopicSnapshots
     surface_treatments:
     - include_languages:
@@ -562,140 +268,29 @@ interfaces:
       - nodejs
       - python
       - php
-      visibility: DISABLED
+      visibility: PACKAGE
   - name: DeleteTopic
-    flattening:
-      groups:
-      - parameters:
-        - topic
-    required_fields:
-    - topic
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      topic: topic
-    timeout_millis: 60000
   - name: SetIamPolicy
-    flattening:
-      groups:
-      - parameters:
-        - resource
-        - policy
-    required_fields:
-    - resource
-    - policy
     retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      resource: topic
-    timeout_millis: 60000
     reroute_to_grpc_interface: google.iam.v1.IAMPolicy
+    # TODO: surface_treatments are here only to make bazel presubmit pass
+    # they can be removed once presubmit starts using gapic-generator-go
     surface_treatments:
     - include_languages:
       - go
       visibility: DISABLED
   - name: GetIamPolicy
-    flattening:
-      groups:
-      - parameters:
-        - resource
-    required_fields:
-    - resource
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      resource: topic
-    timeout_millis: 60000
     reroute_to_grpc_interface: google.iam.v1.IAMPolicy
     surface_treatments:
     - include_languages:
       - go
       visibility: DISABLED
   - name: TestIamPermissions
-    flattening:
-      groups:
-      - parameters:
-        - resource
-        - permissions
-    required_fields:
-    - resource
-    - permissions
     retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      resource: topic
-    timeout_millis: 60000
     reroute_to_grpc_interface: google.iam.v1.IAMPolicy
     surface_treatments:
     - include_languages:
       - go
       visibility: DISABLED
-resource_name_generation:
-- message_name: Topic
-  field_entity_map:
-    name: topic
-- message_name: GetTopicRequest
-  field_entity_map:
-    topic: topic
-- message_name: PublishRequest
-  field_entity_map:
-    topic: topic
-- message_name: ListTopicsRequest
-  field_entity_map:
-    project: project
-- message_name: ListTopicSubscriptionsRequest
-  field_entity_map:
-    topic: topic
-- message_name: ListTopicSubscriptionsResponse
-  field_entity_map:
-    subscriptions: subscription
-- message_name: DeleteTopicRequest
-  field_entity_map:
-    topic: topic
-- message_name: Subscription
-  field_entity_map:
-    name: subscription
-    topic: topic_oneof
-- message_name: GetSubscriptionRequest
-  field_entity_map:
-    subscription: subscription
-- message_name: ListSubscriptionsRequest
-  field_entity_map:
-    project: project
-- message_name: DeleteSubscriptionRequest
-  field_entity_map:
-    subscription: subscription
-- message_name: ModifyPushConfigRequest
-  field_entity_map:
-    subscription: subscription
-- message_name: PullRequest
-  field_entity_map:
-    subscription: subscription
-- message_name: ModifyAckDeadlineRequest
-  field_entity_map:
-    subscription: subscription
-- message_name: AcknowledgeRequest
-  field_entity_map:
-    subscription: subscription
-- message_name: StreamingPullRequest
-  field_entity_map:
-    subscription: subscription
-- message_name: Snapshot
-  field_entity_map:
-    name: snapshot
-    topic: topic
-- message_name: CreateSnapshotRequest
-  field_entity_map:
-    name: snapshot
-    subscription: subscription
-- message_name: ListSnapshotsRequest
-  field_entity_map:
-    project: project
-- message_name: DeleteSnapshotRequest
-  field_entity_map:
-    snapshot: snapshot
-- message_name: SeekRequest
-  field_entity_map:
-    subscription: subscription
-    snapshot: snapshot
diff --git a/third_party/googleapis/google/pubsub/v1/pubsub_grpc_service_config.json b/third_party/googleapis/google/pubsub/v1/pubsub_grpc_service_config.json
new file mode 100755
index 000000000..15abf6f93
--- /dev/null
+++ b/third_party/googleapis/google/pubsub/v1/pubsub_grpc_service_config.json
@@ -0,0 +1,222 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.pubsub.v1.Publisher",
+          "method": "CreateTopic"
+        },
+        {
+          "service": "google.pubsub.v1.Publisher",
+          "method": "UpdateTopic"
+        },
+        {
+          "service": "google.pubsub.v1.Publisher",
+          "method": "DeleteTopic"
+        },
+        {
+          "service": "google.pubsub.v1.Publisher",
+          "method": "SetIamPolicy"
+        },
+        {
+          "service": "google.pubsub.v1.Publisher",
+          "method": "TestIamPermissions"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.pubsub.v1.Publisher",
+          "method": "Publish"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "ABORTED",
+          "CANCELLED",
+          "INTERNAL",
+          "RESOURCE_EXHAUSTED",
+          "UNKNOWN",
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.pubsub.v1.Publisher",
+          "method": "GetTopic"
+        },
+        {
+          "service": "google.pubsub.v1.Publisher",
+          "method": "ListTopics"
+        },
+        {
+          "service": "google.pubsub.v1.Publisher",
+          "method": "ListTopicSubscriptions"
+        },
+        {
+          "service": "google.pubsub.v1.Publisher",
+          "method": "ListTopicSnapshots"
+        },
+        {
+          "service": "google.pubsub.v1.Publisher",
+          "method": "GetIamPolicy"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNKNOWN",
+          "ABORTED",
+          "UNAVAILABLE"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.pubsub.v1.Subscriber",
+          "method": "StreamingPull"
+        }
+      ],
+      "timeout": "900s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "DEADLINE_EXCEEDED",
+          "RESOURCE_EXHAUSTED",
+          "ABORTED",
+          "INTERNAL",
+          "UNAVAILABLE"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.pubsub.v1.Subscriber",
+          "method": "CreateSubscription"
+        },
+        {
+          "service": "google.pubsub.v1.Subscriber",
+          "method": "GetSubscription"
+        },
+        {
+          "service": "google.pubsub.v1.Subscriber",
+          "method": "ListSubscriptions"
+        },
+        {
+          "service": "google.pubsub.v1.Subscriber",
+          "method": "ListSnapshots"
+        },
+        {
+          "service": "google.pubsub.v1.Subscriber",
+          "method": "GetSnapshot"
+        },
+        {
+          "service": "google.pubsub.v1.Subscriber",
+          "method": "Seek"
+        },
+        {
+          "service": "google.pubsub.v1.Subscriber",
+          "method": "Pull"
+        },
+        {
+          "service": "google.pubsub.v1.Subscriber",
+          "method": "GetIamPolicy"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNKNOWN",
+          "ABORTED",
+          "UNAVAILABLE"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.pubsub.v1.Subscriber",
+          "method": "UpdateSubscription"
+        },
+        {
+          "service": "google.pubsub.v1.Subscriber",
+          "method": "DeleteSubscription"
+        },
+        {
+          "service": "google.pubsub.v1.Subscriber",
+          "method": "ModifyAckDeadline"
+        },
+        {
+          "service": "google.pubsub.v1.Subscriber",
+          "method": "ModifyPushConfig"
+        },
+        {
+          "service": "google.pubsub.v1.Subscriber",
+          "method": "CreateSnapshot"
+        },
+        {
+          "service": "google.pubsub.v1.Subscriber",
+          "method": "UpdateSnapshot"
+        },
+        {
+          "service": "google.pubsub.v1.Subscriber",
+          "method": "DeleteSnapshot"
+        },
+        {
+          "service": "google.pubsub.v1.Subscriber",
+          "method": "Acknowledge"
+        },
+        {
+          "service": "google.pubsub.v1.Subscriber",
+          "method": "SetIamPolicy"
+        },
+        {
+          "service": "google.pubsub.v1.Subscriber",
+          "method": "TestIamPermissions"
+        }
+      ],
+      "timeout": "60s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/pubsub/v1/pubsub_v1.yaml b/third_party/googleapis/google/pubsub/v1/pubsub_v1.yaml
new file mode 100644
index 000000000..0178f428d
--- /dev/null
+++ b/third_party/googleapis/google/pubsub/v1/pubsub_v1.yaml
@@ -0,0 +1,87 @@
+type: google.api.Service
+config_version: 3
+name: pubsub.googleapis.com
+title: Cloud Pub/Sub API
+
+apis:
+- name: google.pubsub.v1.Publisher
+- name: google.pubsub.v1.Subscriber
+
+documentation:
+  summary: |-
+    Provides reliable, many-to-many, asynchronous messaging between
+    applications.
+  rules:
+  - selector: google.iam.v1.IAMPolicy.GetIamPolicy
+    description: |-
+      Gets the access control policy for a resource. Returns an empty policy
+      if the resource exists and does not have a policy set.
+
+  - selector: google.iam.v1.IAMPolicy.SetIamPolicy
+    description: |-
+      Sets the access control policy on the specified resource. Replaces
+      any existing policy.
+
+      Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED`
+      errors.
+
+  - selector: google.iam.v1.IAMPolicy.TestIamPermissions
+    description: |-
+      Returns permissions that a caller has on the specified resource. If the
+      resource does not exist, this will return an empty set of
+      permissions, not a `NOT_FOUND` error.
+
+      Note: This operation is designed to be used for building
+      permission-aware UIs and command-line tools, not for authorization
+      checking. This operation may "fail open" without warning.
+
+backend:
+  rules:
+  - selector: 'google.pubsub.v1.Publisher.*'
+    deadline: 120.0
+  - selector: google.pubsub.v1.Publisher.Publish
+    deadline: 20.0
+  - selector: 'google.pubsub.v1.Subscriber.*'
+    deadline: 120.0
+
+http:
+  rules:
+  - selector: google.iam.v1.IAMPolicy.GetIamPolicy
+    get: '/v1/{resource=projects/*/topics/*}:getIamPolicy'
+    additional_bindings:
+    - get: '/v1/{resource=projects/*/subscriptions/*}:getIamPolicy'
+    - get: '/v1/{resource=projects/*/snapshots/*}:getIamPolicy'
+  - selector: google.iam.v1.IAMPolicy.SetIamPolicy
+    post: '/v1/{resource=projects/*/topics/*}:setIamPolicy'
+    body: '*'
+    additional_bindings:
+    - post: '/v1/{resource=projects/*/subscriptions/*}:setIamPolicy'
+      body: '*'
+    - post: '/v1/{resource=projects/*/snapshots/*}:setIamPolicy'
+      body: '*'
+  - selector: google.iam.v1.IAMPolicy.TestIamPermissions
+    post: '/v1/{resource=projects/*/subscriptions/*}:testIamPermissions'
+    body: '*'
+    additional_bindings:
+    - post: '/v1/{resource=projects/*/topics/*}:testIamPermissions'
+      body: '*'
+    - post: '/v1/{resource=projects/*/snapshots/*}:testIamPermissions'
+      body: '*'
+
+authentication:
+  rules:
+  - selector: 'google.iam.v1.IAMPolicy.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/pubsub
+  - selector: 'google.pubsub.v1.Publisher.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/pubsub
+  - selector: 'google.pubsub.v1.Subscriber.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/pubsub
diff --git a/third_party/googleapis/google/rpc/BUILD.bazel b/third_party/googleapis/google/rpc/BUILD.bazel
index 1daaf649d..645f329f3 100644
--- a/third_party/googleapis/google/rpc/BUILD.bazel
+++ b/third_party/googleapis/google/rpc/BUILD.bazel
@@ -1,3 +1,5 @@
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
@@ -85,3 +87,23 @@ cc_proto_library(
     name = "status_cc_proto",
     deps = [":status_proto"],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load("@com_google_googleapis_imports//:imports.bzl", "py_proto_library")
+
+py_proto_library(
+    name = "code_py_proto",
+    deps = [":code_proto"],
+)
+
+py_proto_library(
+    name = "error_details_py_proto",
+    deps = [":error_details_proto"],
+)
+
+py_proto_library(
+    name = "status_py_proto",
+    deps = [":status_proto"],
+)
diff --git a/third_party/googleapis/google/rpc/README.md b/third_party/googleapis/google/rpc/README.md
index 509881429..164bc8098 100644
--- a/third_party/googleapis/google/rpc/README.md
+++ b/third_party/googleapis/google/rpc/README.md
@@ -1,5 +1,5 @@
 # Google RPC
 
 This package contains type definitions for general RPC systems. While
-[gRPC](https://github.com/grpc) is using these defintions, they
+[gRPC](https://github.com/grpc) is using these definitions, they
 are not designed specifically to support gRPC.
diff --git a/third_party/googleapis/google/rpc/code.proto b/third_party/googleapis/google/rpc/code.proto
index 142e28d30..98ae0ac18 100644
--- a/third_party/googleapis/google/rpc/code.proto
+++ b/third_party/googleapis/google/rpc/code.proto
@@ -1,4 +1,4 @@
-// Copyright 2017 Google Inc.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -22,7 +22,7 @@ option java_outer_classname = "CodeProto";
 option java_package = "com.google.rpc";
 option objc_class_prefix = "RPC";
 
-// The canonical error codes for Google APIs.
+// The canonical error codes for gRPC APIs.
 //
 //
 // Sometimes multiple error codes may apply.  Services should return
@@ -170,7 +170,8 @@ enum Code {
 
   // The service is currently unavailable.  This is most likely a
   // transient condition, which can be corrected by retrying with
-  // a backoff.
+  // a backoff. Note that it is not always safe to retry
+  // non-idempotent operations.
   //
   // See the guidelines above for deciding between `FAILED_PRECONDITION`,
   // `ABORTED`, and `UNAVAILABLE`.
diff --git a/third_party/googleapis/google/rpc/context/BUILD.bazel b/third_party/googleapis/google/rpc/context/BUILD.bazel
new file mode 100644
index 000000000..bc584e867
--- /dev/null
+++ b/third_party/googleapis/google/rpc/context/BUILD.bazel
@@ -0,0 +1,129 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
+proto_library(
+    name = "attribute_context_proto",
+    srcs = [
+        "attribute_context.proto",
+    ],
+    deps = [
+        "@com_google_protobuf//:struct_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "attribute_context_java_proto",
+    deps = [":attribute_context_proto"],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_proto_library",
+)
+
+go_proto_library(
+    name = "attribute_context_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/rpc/context/attribute_context",
+    protos = [":attribute_context_proto"],
+    deps = [
+
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "attribute_context_moved_proto",
+    srcs = [":attribute_context_proto"],
+    deps = [
+        "@com_google_protobuf//:struct_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "attribute_context_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":attribute_context_moved_proto"],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "attribute_context_php_proto",
+    deps = [":attribute_context_proto"],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "attribute_context_ruby_proto",
+    deps = [":attribute_context_proto"],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "attribute_context_csharp_proto",
+    deps = [":attribute_context_proto"],
+)
+
+##############################################################################
+# C++
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "cc_proto_library",
+)
+
+cc_proto_library(
+    name = "attribute_context_cc_proto",
+    deps = [":attribute_context_proto"],
+)
+
+
diff --git a/third_party/googleapis/google/rpc/context/attribute_context.proto b/third_party/googleapis/google/rpc/context/attribute_context.proto
new file mode 100644
index 000000000..e60a5ae94
--- /dev/null
+++ b/third_party/googleapis/google/rpc/context/attribute_context.proto
@@ -0,0 +1,287 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.rpc.context;
+
+import "google/protobuf/struct.proto";
+import "google/protobuf/timestamp.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/rpc/context/attribute_context;attribute_context";
+option java_multiple_files = true;
+option java_outer_classname = "AttributeContextProto";
+option java_package = "com.google.rpc.context";
+
+// This message defines the standard attribute vocabulary for Google APIs.
+//
+// An attribute is a piece of metadata that describes an activity on a network
+// service. For example, the size of an HTTP request, or the status code of
+// an HTTP response.
+//
+// Each attribute has a type and a name, which is logically defined as
+// a proto message field in `AttributeContext`. The field type becomes the
+// attribute type, and the field path becomes the attribute name. For example,
+// the attribute `source.ip` maps to field `AttributeContext.source.ip`.
+//
+// This message definition is guaranteed not to have any wire breaking change.
+// So you can use it directly for passing attributes across different systems.
+//
+// NOTE: Different system may generate different subset of attributes. Please
+// verify the system specification before relying on an attribute generated
+// a system.
+message AttributeContext {
+  // This message defines attributes for a node that handles a network request.
+  // The node can be either a service or an application that sends, forwards,
+  // or receives the request. Service peers should fill in
+  // `principal` and `labels` as appropriate.
+  message Peer {
+    // The IP address of the peer.
+    string ip = 1;
+
+    // The network port of the peer.
+    int64 port = 2;
+
+    // The labels associated with the peer.
+    map labels = 6;
+
+    // The identity of this peer. Similar to `Request.auth.principal`, but
+    // relative to the peer instead of the request. For example, the
+    // idenity associated with a load balancer that forwared the request.
+    string principal = 7;
+
+    // The CLDR country/region code associated with the above IP address.
+    // If the IP address is private, the `region_code` should reflect the
+    // physical location where this peer is running.
+    string region_code = 8;
+  }
+
+  // This message defines attributes associated with API operations, such as
+  // a network API request. The terminology is based on the conventions used
+  // by Google APIs, Istio, and OpenAPI.
+  message Api {
+    // The API service name. It is a logical identifier for a networked API,
+    // such as "pubsub.googleapis.com". The naming syntax depends on the
+    // API management system being used for handling the request.
+    string service = 1;
+
+    // The API operation name. For gRPC requests, it is the fully qualified API
+    // method name, such as "google.pubsub.v1.Publisher.Publish". For OpenAPI
+    // requests, it is the `operationId`, such as "getPet".
+    string operation = 2;
+
+    // The API protocol used for sending the request, such as "http", "https",
+    // "grpc", or "internal".
+    string protocol = 3;
+
+    // The API version associated with the API operation above, such as "v1" or
+    // "v1alpha1".
+    string version = 4;
+  }
+
+  // This message defines request authentication attributes. Terminology is
+  // based on the JSON Web Token (JWT) standard, but the terms also
+  // correlate to concepts in other standards.
+  message Auth {
+    // The authenticated principal. Reflects the issuer (`iss`) and subject
+    // (`sub`) claims within a JWT. The issuer and subject should be `/`
+    // delimited, with `/` percent-encoded within the subject fragment. For
+    // Google accounts, the principal format is:
+    // "https://accounts.google.com/{id}"
+    string principal = 1;
+
+    // The intended audience(s) for this authentication information. Reflects
+    // the audience (`aud`) claim within a JWT. The audience
+    // value(s) depends on the `issuer`, but typically include one or more of
+    // the following pieces of information:
+    //
+    // *  The services intended to receive the credential such as
+    //    ["pubsub.googleapis.com", "storage.googleapis.com"]
+    // *  A set of service-based scopes. For example,
+    //    ["https://www.googleapis.com/auth/cloud-platform"]
+    // *  The client id of an app, such as the Firebase project id for JWTs
+    //    from Firebase Auth.
+    //
+    // Consult the documentation for the credential issuer to determine the
+    // information provided.
+    repeated string audiences = 2;
+
+    // The authorized presenter of the credential. Reflects the optional
+    // Authorized Presenter (`azp`) claim within a JWT or the
+    // OAuth client id. For example, a Google Cloud Platform client id looks
+    // as follows: "123456789012.apps.googleusercontent.com".
+    string presenter = 3;
+
+    // Structured claims presented with the credential. JWTs include
+    // `{key: value}` pairs for standard and private claims. The following
+    // is a subset of the standard required and optional claims that would
+    // typically be presented for a Google-based JWT:
+    //
+    //    {'iss': 'accounts.google.com',
+    //     'sub': '113289723416554971153',
+    //     'aud': ['123456789012', 'pubsub.googleapis.com'],
+    //     'azp': '123456789012.apps.googleusercontent.com',
+    //     'email': 'jsmith@example.com',
+    //     'iat': 1353601026,
+    //     'exp': 1353604926}
+    //
+    // SAML assertions are similarly specified, but with an identity provider
+    // dependent structure.
+    google.protobuf.Struct claims = 4;
+
+    // A list of access level resource names that allow resources to be
+    // accessed by authenticated requester. It is part of Secure GCP processing
+    // for the incoming request. An access level string has the format:
+    // "//{api_service_name}/accessPolicies/{policy_id}/accessLevels/{short_name}"
+    //
+    // Example:
+    // "//accesscontextmanager.googleapis.com/accessPolicies/MY_POLICY_ID/accessLevels/MY_LEVEL"
+    repeated string access_levels = 5;
+  }
+
+  // This message defines attributes for an HTTP request. If the actual
+  // request is not an HTTP request, the runtime system should try to map
+  // the actual request to an equivalent HTTP request.
+  message Request {
+    // The unique ID for a request, which can be propagated to downstream
+    // systems. The ID should have low probability of collision
+    // within a single day for a specific service.
+    string id = 1;
+
+    // The HTTP request method, such as `GET`, `POST`.
+    string method = 2;
+
+    // The HTTP request headers. If multiple headers share the same key, they
+    // must be merged according to the HTTP spec. All header keys must be
+    // lowercased, because HTTP header keys are case-insensitive.
+    map headers = 3;
+
+    // The HTTP URL path.
+    string path = 4;
+
+    // The HTTP request `Host` header value.
+    string host = 5;
+
+    // The HTTP URL scheme, such as `http` and `https`.
+    string scheme = 6;
+
+    // The HTTP URL query in the format of `name1=value1&name2=value2`, as it
+    // appears in the first line of the HTTP request. No decoding is performed.
+    string query = 7;
+
+    // The timestamp when the `destination` service receives the first byte of
+    // the request.
+    google.protobuf.Timestamp time = 9;
+
+    // The HTTP request size in bytes. If unknown, it must be -1.
+    int64 size = 10;
+
+    // The network protocol used with the request, such as "http/1.1",
+    // "spdy/3", "h2", "h2c", "webrtc", "tcp", "udp", "quic". See
+    // https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids
+    // for details.
+    string protocol = 11;
+
+    // A special parameter for request reason. It is used by security systems
+    // to associate auditing information with a request.
+    string reason = 12;
+
+    // The request authentication. May be absent for unauthenticated requests.
+    // Derived from the HTTP request `Authorization` header or equivalent.
+    Auth auth = 13;
+  }
+
+  // This message defines attributes for a typical network response. It
+  // generally models semantics of an HTTP response.
+  message Response {
+    // The HTTP response status code, such as `200` and `404`.
+    int64 code = 1;
+
+    // The HTTP response size in bytes. If unknown, it must be -1.
+    int64 size = 2;
+
+    // The HTTP response headers. If multiple headers share the same key, they
+    // must be merged according to HTTP spec. All header keys must be
+    // lowercased, because HTTP header keys are case-insensitive.
+    map headers = 3;
+
+    // The timestamp when the `destination` service generates the first byte of
+    // the response.
+    google.protobuf.Timestamp time = 4;
+  }
+
+  // This message defines core attributes for a resource. A resource is an
+  // addressable (named) entity provided by the destination service. For
+  // example, a file stored on a network storage service.
+  message Resource {
+    // The name of the service that this resource belongs to, such as
+    // `pubsub.googleapis.com`. The service may be different from the DNS
+    // hostname that actually serves the request.
+    string service = 1;
+
+    // The stable identifier (name) of a resource on the `service`. A resource
+    // can be logically identified as "//{resource.service}/{resource.name}".
+    // The differences between a resource name and a URI are:
+    //
+    // *   Resource name is a logical identifier, independent of network
+    //     protocol and API version. For example,
+    //     `//pubsub.googleapis.com/projects/123/topics/news-feed`.
+    // *   URI often includes protocol and version information, so it can
+    //     be used directly by applications. For example,
+    //     `https://pubsub.googleapis.com/v1/projects/123/topics/news-feed`.
+    //
+    // See https://cloud.google.com/apis/design/resource_names for details.
+    string name = 2;
+
+    // The type of the resource. The syntax is platform-specific because
+    // different platforms define their resources differently.
+    //
+    // For Google APIs, the type format must be "{service}/{kind}".
+    string type = 3;
+
+    // The labels or tags on the resource, such as AWS resource tags and
+    // Kubernetes resource labels.
+    map labels = 4;
+  }
+
+  // The origin of a network activity. In a multi hop network activity,
+  // the origin represents the sender of the first hop. For the first hop,
+  // the `source` and the `origin` must have the same content.
+  Peer origin = 7;
+
+  // The source of a network activity, such as starting a TCP connection.
+  // In a multi hop network activity, the source represents the sender of the
+  // last hop.
+  Peer source = 1;
+
+  // The destination of a network activity, such as accepting a TCP connection.
+  // In a multi hop network activity, the destination represents the receiver of
+  // the last hop.
+  Peer destination = 2;
+
+  // Represents a network request, such as an HTTP request.
+  Request request = 3;
+
+  // Represents a network response, such as an HTTP response.
+  Response response = 4;
+
+  // Represents a target resource that is involved with a network activity.
+  // If multiple resources are involved with an activity, this must be the
+  // primary one.
+  Resource resource = 5;
+
+  // Represents an API operation that is involved to a network activity.
+  Api api = 6;
+}
diff --git a/third_party/googleapis/google/rpc/error_details.proto b/third_party/googleapis/google/rpc/error_details.proto
index 1f9ad5314..fd9361a0c 100644
--- a/third_party/googleapis/google/rpc/error_details.proto
+++ b/third_party/googleapis/google/rpc/error_details.proto
@@ -1,4 +1,4 @@
-// Copyright 2017 Google Inc.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -35,7 +35,7 @@ option objc_class_prefix = "RPC";
 // receiving the error response before retrying.  If retrying requests also
 // fail, clients should use an exponential backoff scheme to gradually increase
 // the delay between retries based on `retry_delay`, until either a maximum
-// number of retires have been reached or a maximum retry delay cap has been
+// number of retries have been reached or a maximum retry delay cap has been
 // reached.
 message RetryInfo {
   // Clients should wait at least this long between retrying the same request.
@@ -60,7 +60,7 @@ message DebugInfo {
 // a service could respond with the project id and set `service_disabled`
 // to true.
 //
-// Also see RetryDetail and Help types for other details about handling a
+// Also see RetryInfo and Help types for other details about handling a
 // quota failure.
 message QuotaFailure {
   // A message type used to describe a single quota violation.  For example, a
@@ -85,6 +85,53 @@ message QuotaFailure {
   repeated Violation violations = 1;
 }
 
+// Describes the cause of the error with structured details.
+//
+// Example of an error when contacting the "pubsub.googleapis.com" API when it
+// is not enabled:
+//     { "reason": "API_DISABLED"
+//       "domain": "googleapis.com"
+//       "metadata": {
+//         "resource": "projects/123",
+//         "service": "pubsub.googleapis.com"
+//       }
+//     }
+// This response indicates that the pubsub.googleapis.com API is not enabled.
+//
+// Example of an error that is returned when attempting to create a Spanner
+// instance in a region that is out of stock:
+//     { "reason": "STOCKOUT"
+//       "domain": "spanner.googleapis.com",
+//       "metadata": {
+//         "availableRegions": "us-central1,us-east2"
+//       }
+//     }
+//
+message ErrorInfo {
+  // The reason of the error. This is a constant value that identifies the
+  // proximate cause of the error. Error reasons are unique within a particular
+  // domain of errors. This should be at most 63 characters and match
+  // /[A-Z0-9_]+/.
+  string reason = 1;
+
+  // The logical grouping to which the "reason" belongs.  Often "domain" will
+  // contain the registered service name of the tool or product that is the
+  // source of the error. Example: "pubsub.googleapis.com". If the error is
+  // common across many APIs, the first segment of the example above will be
+  // omitted.  The value will be, "googleapis.com".
+  string domain = 2;
+
+  // Additional structured details about this error.
+  //
+  // Keys should match /[a-zA-Z0-9-_]/ and be limited to 64 characters in
+  // length. When identifying the current value of an exceeded limit, the units
+  // should be contained in the key, not the value.  For example, rather than
+  // {"instanceLimit": "100/request"}, should be returned as,
+  // {"instanceLimitPerRequest": "100"}, if the client exceeds the number of
+  // instances that can be created in a single (batch) request.
+  map metadata = 3;
+}
+
 // Describes what preconditions have failed.
 //
 // For example, if an RPC failed because it required the Terms of Service to be
@@ -94,13 +141,13 @@ message PreconditionFailure {
   // A message type used to describe a single precondition failure.
   message Violation {
     // The type of PreconditionFailure. We recommend using a service-specific
-    // enum type to define the supported precondition violation types. For
+    // enum type to define the supported precondition violation subjects. For
     // example, "TOS" for "Terms of Service violation".
     string type = 1;
 
     // The subject, relative to the type, that failed.
-    // For example, "google.com/cloud" relative to the "TOS" type would
-    // indicate which terms of service is being referenced.
+    // For example, "google.com/cloud" relative to the "TOS" type would indicate
+    // which terms of service is being referenced.
     string subject = 2;
 
     // A description of how the precondition failed. Developers can use this
@@ -153,8 +200,7 @@ message ResourceInfo {
 
   // The name of the resource being accessed.  For example, a shared calendar
   // name: "example.com_4fghdhgsrgh@group.calendar.google.com", if the current
-  // error is
-  // [google.rpc.Code.PERMISSION_DENIED][google.rpc.Code.PERMISSION_DENIED].
+  // error is [google.rpc.Code.PERMISSION_DENIED][google.rpc.Code.PERMISSION_DENIED].
   string resource_name = 2;
 
   // The owner of the resource (optional).
diff --git a/third_party/googleapis/google/rpc/rpc_publish.yaml b/third_party/googleapis/google/rpc/rpc_publish.yaml
index ea91204fb..90a91e07d 100644
--- a/third_party/googleapis/google/rpc/rpc_publish.yaml
+++ b/third_party/googleapis/google/rpc/rpc_publish.yaml
@@ -1,5 +1,5 @@
 type: google.api.Service
-config_version: 0
+config_version: 1
 name: rpc.googleapis.com
 title: Google RPC Types
 
diff --git a/third_party/googleapis/google/rpc/status.proto b/third_party/googleapis/google/rpc/status.proto
index b0daa3695..3b1f7a932 100644
--- a/third_party/googleapis/google/rpc/status.proto
+++ b/third_party/googleapis/google/rpc/status.proto
@@ -1,4 +1,4 @@
-// Copyright 2017 Google Inc.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,6 +18,7 @@ package google.rpc;
 
 import "google/protobuf/any.proto";
 
+option cc_enable_arenas = true;
 option go_package = "google.golang.org/genproto/googleapis/rpc/status;status";
 option java_multiple_files = true;
 option java_outer_classname = "StatusProto";
@@ -26,66 +27,18 @@ option objc_class_prefix = "RPC";
 
 // The `Status` type defines a logical error model that is suitable for
 // different programming environments, including REST APIs and RPC APIs. It is
-// used by [gRPC](https://github.com/grpc). The error model is designed to be:
+// used by [gRPC](https://github.com/grpc). Each `Status` message contains
+// three pieces of data: error code, error message, and error details.
 //
-// - Simple to use and understand for most users
-// - Flexible enough to meet unexpected needs
-//
-// # Overview
-//
-// The `Status` message contains three pieces of data: error code, error
-// message, and error details. The error code should be an enum value of
-// [google.rpc.Code][google.rpc.Code], but it may accept additional error codes
-// if needed.  The error message should be a developer-facing English message
-// that helps developers *understand* and *resolve* the error. If a localized
-// user-facing error message is needed, put the localized message in the error
-// details or localize it in the client. The optional error details may contain
-// arbitrary information about the error. There is a predefined set of error
-// detail types in the package `google.rpc` that can be used for common error
-// conditions.
-//
-// # Language mapping
-//
-// The `Status` message is the logical representation of the error model, but it
-// is not necessarily the actual wire format. When the `Status` message is
-// exposed in different client libraries and different wire protocols, it can be
-// mapped differently. For example, it will likely be mapped to some exceptions
-// in Java, but more likely mapped to some error codes in C.
-//
-// # Other uses
-//
-// The error model and the `Status` message can be used in a variety of
-// environments, either with or without APIs, to provide a
-// consistent developer experience across different environments.
-//
-// Example uses of this error model include:
-//
-// - Partial errors. If a service needs to return partial errors to the client,
-//     it may embed the `Status` in the normal response to indicate the partial
-//     errors.
-//
-// - Workflow errors. A typical workflow has multiple steps. Each step may
-//     have a `Status` message for error reporting.
-//
-// - Batch operations. If a client uses batch request and batch response, the
-//     `Status` message should be used directly inside batch response, one for
-//     each error sub-response.
-//
-// - Asynchronous operations. If an API call embeds asynchronous operation
-//     results in its response, the status of those operations should be
-//     represented directly using the `Status` message.
-//
-// - Logging. If some API errors are stored in logs, the message `Status` could
-//     be used directly after any stripping needed for security/privacy reasons.
+// You can find out more about this error model and how to work with it in the
+// [API Design Guide](https://cloud.google.com/apis/design/errors).
 message Status {
-  // The status code, which should be an enum value of
-  // [google.rpc.Code][google.rpc.Code].
+  // The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
   int32 code = 1;
 
   // A developer-facing error message, which should be in English. Any
   // user-facing error message should be localized and sent in the
-  // [google.rpc.Status.details][google.rpc.Status.details] field, or localized
-  // by the client.
+  // [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
   string message = 2;
 
   // A list of messages that carry the error details.  There is a common set of
diff --git a/third_party/googleapis/google/search/partnerdataingestion/logging/v1/BUILD.bazel b/third_party/googleapis/google/search/partnerdataingestion/logging/v1/BUILD.bazel
new file mode 100644
index 000000000..4599fe856
--- /dev/null
+++ b/third_party/googleapis/google/search/partnerdataingestion/logging/v1/BUILD.bazel
@@ -0,0 +1,162 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
+proto_library(
+    name = "logging_proto",
+    srcs = [
+        "platformlog.proto",
+    ],
+    deps = [
+        
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "logging_java_proto",
+    deps = [":logging_proto"],
+)
+
+java_grpc_library(
+    name = "logging_java_grpc",
+    srcs = [":logging_proto"],
+    deps = [":logging_java_proto"],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_proto_library",
+)
+
+go_proto_library(
+    name = "logging_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/search/partnerdataingestion/logging/v1",
+    protos = [":logging_proto"],
+    deps = [
+        
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "logging_moved_proto",
+    srcs = [":logging_proto"],
+    deps = [
+        
+    ],
+)
+
+py_proto_library(
+    name = "logging_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":logging_moved_proto"],
+)
+
+py_grpc_library(
+    name = "logging_py_grpc",
+    srcs = [":logging_moved_proto"],
+    deps = [":logging_py_proto"],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "logging_php_proto",
+    deps = [":logging_proto"],
+)
+
+php_grpc_library(
+    name = "logging_php_grpc",
+    srcs = [":logging_proto"],
+    deps = [":logging_php_proto"],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "logging_ruby_proto",
+    deps = [":logging_proto"],
+)
+
+ruby_grpc_library(
+    name = "logging_ruby_grpc",
+    srcs = [":logging_proto"],
+    deps = [":logging_ruby_proto"],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "logging_csharp_proto",
+    deps = [":logging_proto"],
+)
+
+csharp_grpc_library(
+    name = "logging_csharp_grpc",
+    srcs = [":logging_proto"],
+    deps = [":logging_csharp_proto"],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ code here
diff --git a/third_party/googleapis/google/search/partnerdataingestion/logging/v1/platformlog.proto b/third_party/googleapis/google/search/partnerdataingestion/logging/v1/platformlog.proto
new file mode 100644
index 000000000..917a32495
--- /dev/null
+++ b/third_party/googleapis/google/search/partnerdataingestion/logging/v1/platformlog.proto
@@ -0,0 +1,32 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.search.partnerdataingestion.logging.v1;
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/search/partnerdataingestion/logging/v1;logging";
+option java_multiple_files = true;
+option java_outer_classname = "PlatformLogProto";
+option java_package = "com.google.search.partnerdataingestion.logging.v1";
+
+// Log message used to send to Platform Logging.
+message IngestDetailsLog {
+  // Identification of the successfully accepted request.
+  string ingestion_tracking_id = 1;
+
+  // The message content will be sent to Platform Logging.
+  string content = 2;
+}
diff --git a/third_party/googleapis/google/spanner/BUILD.bazel b/third_party/googleapis/google/spanner/BUILD.bazel
index 1e5b8c2af..a87c57fec 100644
--- a/third_party/googleapis/google/spanner/BUILD.bazel
+++ b/third_party/googleapis/google/spanner/BUILD.bazel
@@ -1 +1 @@
-exports_files(glob(["*.yaml"]))
\ No newline at end of file
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/spanner/admin/database/BUILD.bazel b/third_party/googleapis/google/spanner/admin/database/BUILD.bazel
index 1e5b8c2af..a87c57fec 100644
--- a/third_party/googleapis/google/spanner/admin/database/BUILD.bazel
+++ b/third_party/googleapis/google/spanner/admin/database/BUILD.bazel
@@ -1 +1 @@
-exports_files(glob(["*.yaml"]))
\ No newline at end of file
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/spanner/admin/database/artman_spanner_admin_database.legacy.yaml b/third_party/googleapis/google/spanner/admin/database/artman_spanner_admin_database.legacy.yaml
new file mode 100644
index 000000000..10a63652f
--- /dev/null
+++ b/third_party/googleapis/google/spanner/admin/database/artman_spanner_admin_database.legacy.yaml
@@ -0,0 +1,20 @@
+common:
+  api_name: spanner-admin-database
+  api_version: v1
+  organization_name: google-cloud
+  service_yaml: v1/spanner_admin_database.yaml
+  gapic_yaml: v1/spanner_admin_database_gapic.legacy.yaml
+  proto_package: google.spanner.admin.database.v1
+  src_proto_paths:
+  - v1
+  proto_deps:
+  - name: google-common-protos
+  - name: google-iam-v1
+    proto_path: google/iam/v1
+artifacts:
+- name: php_gapic
+  type: GAPIC
+  language: PHP
+- name: ruby_gapic
+  type: GAPIC
+  language: RUBY
diff --git a/third_party/googleapis/google/spanner/admin/database/artman_spanner_admin_database.yaml b/third_party/googleapis/google/spanner/admin/database/artman_spanner_admin_database.yaml
index dddb18d9a..07c22170f 100644
--- a/third_party/googleapis/google/spanner/admin/database/artman_spanner_admin_database.yaml
+++ b/third_party/googleapis/google/spanner/admin/database/artman_spanner_admin_database.yaml
@@ -2,8 +2,9 @@ common:
   api_name: spanner-admin-database
   api_version: v1
   organization_name: google-cloud
-  service_yaml: spanner_admin_database.yaml
+  service_yaml: v1/spanner_admin_database.yaml
   gapic_yaml: v1/spanner_admin_database_gapic.yaml
+  proto_package: google.spanner.admin.database.v1
   src_proto_paths:
   - v1
   proto_deps:
@@ -17,12 +18,6 @@ artifacts:
 - name: python_gapic
   type: GAPIC
   language: PYTHON
-- name: php_gapic
-  type: GAPIC
-  language: PHP
-- name: ruby_gapic
-  type: GAPIC
-  language: RUBY
 - name: go_gapic
   type: GAPIC
   language: GO
diff --git a/third_party/googleapis/google/spanner/admin/database/v1/BUILD.bazel b/third_party/googleapis/google/spanner/admin/database/v1/BUILD.bazel
index ff2e6e98a..2acb01f60 100644
--- a/third_party/googleapis/google/spanner/admin/database/v1/BUILD.bazel
+++ b/third_party/googleapis/google/spanner/admin/database/v1/BUILD.bazel
@@ -1,115 +1,99 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
-    name = "spanner_admin_database_proto",
+    name = "database_proto",
     srcs = [
+        "backup.proto",
+        "common.proto",
         "spanner_database_admin.proto",
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
         "//google/iam/v1:iam_policy_proto",
         "//google/iam/v1:policy_proto",
         "//google/longrunning:operations_proto",
         "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
         "@com_google_protobuf//:timestamp_proto",
     ],
 )
 
 proto_library_with_info(
-    name = "spanner_admin_database_proto_with_info",
-    deps = [":spanner_admin_database_proto"],
+    name = "database_proto_with_info",
+    deps = [
+        ":database_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
-#proto_library(
-#    name = "spanner_admin_database_proto_with_info",
-#    deps = [
-#        ":spanner_admin_database_proto",
-#        "//google/api:annotations_proto",
-#        "//google/iam/v1:iam_policy_proto",
-#        "//google/iam/v1:policy_proto",
-#        "//google/longrunning:operations_proto",
-#        "@com_google_protobuf//:empty_proto",
-#        "@com_google_protobuf//:timestamp_proto",
-#    ],
-#)
-
 ##############################################################################
 # Java
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-    "@com_google_api_grpc_proto_google_iam_v1//jar",
-]
-
 java_proto_library(
-    name = "spanner_admin_database_java_proto",
-    deps = [":spanner_admin_database_proto"],
+    name = "database_java_proto",
+    deps = [":database_proto"],
 )
 
 java_grpc_library(
-    name = "spanner_admin_database_java_grpc",
-    srcs = [":spanner_admin_database_proto"],
-    deps = [":spanner_admin_database_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "spanner_admin_database_resource_name_java_proto",
-    gapic_yaml = "spanner_admin_database_gapic.yaml",
-    deps = [":spanner_admin_database_proto"],
+    name = "database_java_grpc",
+    srcs = [":database_proto"],
+    deps = [":database_java_proto"],
 )
 
 java_gapic_library(
-    name = "spanner_admin_database_java_gapic",
-    src = ":spanner_admin_database_proto_with_info",
+    name = "database_java_gapic",
+    src = ":database_proto_with_info",
     gapic_yaml = "spanner_admin_database_gapic.yaml",
-    service_yaml = "//google/spanner/admin/database:spanner_admin_database.yaml",
-    test_deps = [":spanner_admin_database_java_grpc"],
+    package = "google.spanner.admin.database.v1",
+    service_yaml = "spanner_admin_database.yaml",
+    test_deps = [
+        ":database_java_grpc",
+        "//google/iam/v1:iam_java_grpc",
+    ],
     deps = [
-        ":spanner_admin_database_java_proto",
-        ":spanner_admin_database_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+        ":database_java_proto",
+        "//google/iam/v1:iam_java_proto",
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":spanner_admin_database_java_gapic_test",
+java_gapic_test(
+    name = "database_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.spanner.admin.database.v1.DatabaseAdminClientTest",
     ],
-) for test_name in [
-    "com.google.cloud.spanner.admin.database.v1.DatabaseAdminClientTest",
-]]
+    runtime_deps = [":database_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
-    name = "google-cloud-spanner-admin-database-v1-java",
-    client_deps = [":spanner_admin_database_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":spanner_admin_database_java_gapic_test"],
-    grpc_deps = [":spanner_admin_database_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
-        ":spanner_admin_database_java_proto",
-        ":spanner_admin_database_proto",
-        ":spanner_admin_database_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    name = "google-cloud-admin-database-v1-java",
+    deps = [
+        ":database_java_gapic",
+        ":database_java_grpc",
+        ":database_java_proto",
+        ":database_proto",
+    ],
 )
 
 ##############################################################################
@@ -117,17 +101,17 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
-    name = "spanner_admin_database_go_proto",
+    name = "database_go_proto",
     compilers = ["@io_bazel_rules_go//proto:go_grpc"],
     importpath = "google.golang.org/genproto/googleapis/spanner/admin/database/v1",
-    protos = [":spanner_admin_database_proto"],
+    protos = [":database_proto"],
     deps = [
         "//google/api:annotations_go_proto",
         "//google/iam/v1:iam_go_proto",
@@ -136,34 +120,275 @@ go_proto_library(
 )
 
 go_gapic_library(
-    name = "spanner_admin_database_go_gapic",
-    src = ":spanner_admin_database_proto_with_info",
-    gapic_yaml = "spanner_admin_database_gapic.yaml",
-    importpath = "cloud.google.com/go/spanner/admin/database/apiv1",
-    service_yaml = "//google/spanner/admin/database:spanner_admin_database.yaml",
+    name = "database_go_gapic",
+    srcs = [":database_proto_with_info"],
+    grpc_service_config = "spanner_admin_database_grpc_service_config.json",
+    importpath = "cloud.google.com/go/spanner/admin/database/apiv1;database",
+    service_yaml = "spanner_admin_database.yaml",
     deps = [
-        ":spanner_admin_database_go_proto",
+        ":database_go_proto",
         "//google/iam/v1:iam_go_proto",
         "//google/longrunning:longrunning_go_gapic",
         "//google/longrunning:longrunning_go_proto",
         "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
     ],
 )
 
 go_test(
-    name = "spanner_admin_database_go_gapic_test",
-    srcs = [":spanner_admin_database_go_gapic_srcjar_test"],
-    embed = [":spanner_admin_database_go_gapic"],
+    name = "database_go_gapic_test",
+    srcs = [":database_go_gapic_srcjar_test"],
+    embed = [":database_go_gapic"],
     importpath = "cloud.google.com/go/spanner/admin/database/apiv1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
-    name = "gapi-cloud-spanner-admin-database-v1-go",
+    name = "gapi-cloud-admin-database-v1-go",
+    deps = [
+        ":database_go_gapic",
+        ":database_go_gapic_srcjar-test.srcjar",
+        ":database_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "database_moved_proto",
+    srcs = [":database_proto"],
     deps = [
-        ":spanner_admin_database_go_gapic",
-        ":spanner_admin_database_go_gapic_srcjar-smoke-test.srcjar",
-        ":spanner_admin_database_go_gapic_srcjar-test.srcjar",
-        ":spanner_admin_database_go_proto",
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/iam/v1:iam_policy_proto",
+        "//google/iam/v1:policy_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
     ],
 )
+
+py_proto_library(
+    name = "database_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":database_moved_proto"],
+)
+
+py_grpc_library(
+    name = "database_py_grpc",
+    srcs = [":database_moved_proto"],
+    deps = [":database_py_proto"],
+)
+
+py_gapic_library(
+    name = "database_py_gapic",
+    src = ":database_proto_with_info",
+    gapic_yaml = "spanner_admin_database_gapic.yaml",
+    package = "google.spanner.admin.database.v1",
+    service_yaml = "spanner_admin_database.yaml",
+    deps = [
+        ":database_py_grpc",
+        ":database_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "admin-database-v1-py",
+    deps = [
+        ":database_py_gapic",
+        ":database_py_grpc",
+        ":database_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "database_php_proto",
+    deps = [":database_proto"],
+)
+
+php_grpc_library(
+    name = "database_php_grpc",
+    srcs = [":database_proto"],
+    deps = [":database_php_proto"],
+)
+
+php_gapic_library(
+    name = "database_php_gapic",
+    src = ":database_proto_with_info",
+    gapic_yaml = "spanner_admin_database_gapic.yaml",
+    package = "google.spanner.admin.database.v1",
+    service_yaml = "spanner_admin_database.yaml",
+    deps = [
+        ":database_php_grpc",
+        ":database_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-admin-database-v1-php",
+    deps = [
+        ":database_php_gapic",
+        ":database_php_grpc",
+        ":database_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "database_nodejs_gapic",
+    src = ":database_proto_with_info",
+    gapic_yaml = "spanner_admin_database_gapic.yaml",
+    package = "google.spanner.admin.database.v1",
+    service_yaml = "spanner_admin_database.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "admin-database-v1-nodejs",
+    deps = [
+        ":database_nodejs_gapic",
+        ":database_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "database_ruby_proto",
+    deps = [":database_proto"],
+)
+
+ruby_grpc_library(
+    name = "database_ruby_grpc",
+    srcs = [":database_proto"],
+    deps = [":database_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "database_ruby_gapic",
+    src = ":database_proto_with_info",
+    gapic_yaml = "spanner_admin_database_gapic.yaml",
+    package = "google.spanner.admin.database.v1",
+    service_yaml = "spanner_admin_database.yaml",
+    deps = [
+        ":database_ruby_grpc",
+        ":database_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-admin-database-v1-ruby",
+    deps = [
+        ":database_ruby_gapic",
+        ":database_ruby_grpc",
+        ":database_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "database_csharp_proto",
+    deps = [":database_proto"],
+)
+
+csharp_grpc_library(
+    name = "database_csharp_grpc",
+    srcs = [":database_proto"],
+    deps = [":database_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "database_csharp_gapic",
+    src = ":database_proto_with_info",
+    gapic_yaml = "spanner_admin_database_gapic.yaml",
+    package = "google.spanner.admin.database.v1",
+    service_yaml = "spanner_admin_database.yaml",
+    deps = [
+        ":database_csharp_grpc",
+        ":database_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-admin-database-v1-csharp",
+    deps = [
+        ":database_csharp_gapic",
+        ":database_csharp_grpc",
+        ":database_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "cc_grpc_library",
+    "cc_proto_library")
+
+cc_proto_library(
+    name = "database_cc_proto",
+    deps = [":database_proto"],
+)
+
+cc_grpc_library(
+    name = "database_cc_grpc",
+    srcs = [":database_proto"],
+    grpc_only = True,
+    deps = [":database_cc_proto"],
+)
diff --git a/third_party/googleapis/google/spanner/admin/database/v1/backup.proto b/third_party/googleapis/google/spanner/admin/database/v1/backup.proto
new file mode 100644
index 000000000..b883adf34
--- /dev/null
+++ b/third_party/googleapis/google/spanner/admin/database/v1/backup.proto
@@ -0,0 +1,365 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.spanner.admin.database.v1;
+
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/timestamp.proto";
+import "google/spanner/admin/database/v1/common.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.Spanner.Admin.Database.V1";
+option go_package = "google.golang.org/genproto/googleapis/spanner/admin/database/v1;database";
+option java_multiple_files = true;
+option java_outer_classname = "BackupProto";
+option java_package = "com.google.spanner.admin.database.v1";
+option php_namespace = "Google\\Cloud\\Spanner\\Admin\\Database\\V1";
+
+// A backup of a Cloud Spanner database.
+message Backup {
+  option (google.api.resource) = {
+    type: "spanner.googleapis.com/Backup"
+    pattern: "projects/{project}/instances/{instance}/backups/{backup}"
+  };
+
+  // Indicates the current state of the backup.
+  enum State {
+    // Not specified.
+    STATE_UNSPECIFIED = 0;
+
+    // The pending backup is still being created. Operations on the
+    // backup may fail with `FAILED_PRECONDITION` in this state.
+    CREATING = 1;
+
+    // The backup is complete and ready for use.
+    READY = 2;
+  }
+
+  // Required for the [CreateBackup][google.spanner.admin.database.v1.DatabaseAdmin.CreateBackup] operation.
+  // Name of the database from which this backup was
+  // created. This needs to be in the same instance as the backup.
+  // Values are of the form
+  // `projects//instances//databases/`.
+  string database = 2 [(google.api.resource_reference) = {
+                         type: "spanner.googleapis.com/Database"
+                       }];
+
+  // Required for the [CreateBackup][google.spanner.admin.database.v1.DatabaseAdmin.CreateBackup]
+  // operation. The expiration time of the backup, with microseconds
+  // granularity that must be at least 6 hours and at most 366 days
+  // from the time the CreateBackup request is processed. Once the `expire_time`
+  // has passed, the backup is eligible to be automatically deleted by Cloud
+  // Spanner to free the resources used by the backup.
+  google.protobuf.Timestamp expire_time = 3;
+
+  // Output only for the [CreateBackup][google.spanner.admin.database.v1.DatabaseAdmin.CreateBackup] operation.
+  // Required for the [UpdateBackup][google.spanner.admin.database.v1.DatabaseAdmin.UpdateBackup] operation.
+  //
+  // A globally unique identifier for the backup which cannot be
+  // changed. Values are of the form
+  // `projects//instances//backups/[a-z][a-z0-9_\-]*[a-z0-9]`
+  // The final segment of the name must be between 2 and 60 characters
+  // in length.
+  //
+  // The backup is stored in the location(s) specified in the instance
+  // configuration of the instance containing the backup, identified
+  // by the prefix of the backup name of the form
+  // `projects//instances/`.
+  string name = 1;
+
+  // Output only. The backup will contain an externally consistent
+  // copy of the database at the timestamp specified by
+  // `create_time`. `create_time` is approximately the time the
+  // [CreateBackup][google.spanner.admin.database.v1.DatabaseAdmin.CreateBackup] request is received.
+  google.protobuf.Timestamp create_time = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Size of the backup in bytes.
+  int64 size_bytes = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The current state of the backup.
+  State state = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The names of the restored databases that reference the backup.
+  // The database names are of
+  // the form `projects//instances//databases/`.
+  // Referencing databases may exist in different instances. The existence of
+  // any referencing database prevents the backup from being deleted. When a
+  // restored database from the backup enters the `READY` state, the reference
+  // to the backup is removed.
+  repeated string referencing_databases = 7 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// The request for [CreateBackup][google.spanner.admin.database.v1.DatabaseAdmin.CreateBackup].
+message CreateBackupRequest {
+  // Required. The name of the instance in which the backup will be
+  // created. This must be the same instance that contains the database the
+  // backup will be created from. The backup will be stored in the
+  // location(s) specified in the instance configuration of this
+  // instance. Values are of the form
+  // `projects//instances/`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Instance"
+    }
+  ];
+
+  // Required. The id of the backup to be created. The `backup_id` appended to
+  // `parent` forms the full backup name of the form
+  // `projects//instances//backups/`.
+  string backup_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The backup to create.
+  Backup backup = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Metadata type for the operation returned by
+// [CreateBackup][google.spanner.admin.database.v1.DatabaseAdmin.CreateBackup].
+message CreateBackupMetadata {
+  // The name of the backup being created.
+  string name = 1;
+
+  // The name of the database the backup is created from.
+  string database = 2;
+
+  // The progress of the
+  // [CreateBackup][google.spanner.admin.database.v1.DatabaseAdmin.CreateBackup] operation.
+  OperationProgress progress = 3;
+
+  // The time at which cancellation of this operation was received.
+  // [Operations.CancelOperation][google.longrunning.Operations.CancelOperation]
+  // starts asynchronous cancellation on a long-running operation. The server
+  // makes a best effort to cancel the operation, but success is not guaranteed.
+  // Clients can use
+  // [Operations.GetOperation][google.longrunning.Operations.GetOperation] or
+  // other methods to check whether the cancellation succeeded or whether the
+  // operation completed despite cancellation. On successful cancellation,
+  // the operation is not deleted; instead, it becomes an operation with
+  // an [Operation.error][] value with a [google.rpc.Status.code][google.rpc.Status.code] of 1,
+  // corresponding to `Code.CANCELLED`.
+  google.protobuf.Timestamp cancel_time = 4;
+}
+
+// The request for [UpdateBackup][google.spanner.admin.database.v1.DatabaseAdmin.UpdateBackup].
+message UpdateBackupRequest {
+  // Required. The backup to update. `backup.name`, and the fields to be updated
+  // as specified by `update_mask` are required. Other fields are ignored.
+  // Update is only supported for the following fields:
+  //  * `backup.expire_time`.
+  Backup backup = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. A mask specifying which fields (e.g. `expire_time`) in the
+  // Backup resource should be updated. This mask is relative to the Backup
+  // resource, not to the request message. The field mask must always be
+  // specified; this prevents any future fields from being erased accidentally
+  // by clients that do not know about them.
+  google.protobuf.FieldMask update_mask = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The request for [GetBackup][google.spanner.admin.database.v1.DatabaseAdmin.GetBackup].
+message GetBackupRequest {
+  // Required. Name of the backup.
+  // Values are of the form
+  // `projects//instances//backups/`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Backup"
+    }
+  ];
+}
+
+// The request for [DeleteBackup][google.spanner.admin.database.v1.DatabaseAdmin.DeleteBackup].
+message DeleteBackupRequest {
+  // Required. Name of the backup to delete.
+  // Values are of the form
+  // `projects//instances//backups/`.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Backup"
+    }
+  ];
+}
+
+// The request for [ListBackups][google.spanner.admin.database.v1.DatabaseAdmin.ListBackups].
+message ListBackupsRequest {
+  // Required. The instance to list backups from.  Values are of the
+  // form `projects//instances/`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Instance"
+    }
+  ];
+
+  // An expression that filters the list of returned backups.
+  //
+  // A filter expression consists of a field name, a comparison operator, and a
+  // value for filtering.
+  // The value must be a string, a number, or a boolean. The comparison operator
+  // must be one of: `<`, `>`, `<=`, `>=`, `!=`, `=`, or `:`.
+  // Colon `:` is the contains operator. Filter rules are not case sensitive.
+  //
+  // The following fields in the [Backup][google.spanner.admin.database.v1.Backup] are eligible for filtering:
+  //
+  //   * `name`
+  //   * `database`
+  //   * `state`
+  //   * `create_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ)
+  //   * `expire_time` (and values are of the format YYYY-MM-DDTHH:MM:SSZ)
+  //   * `size_bytes`
+  //
+  // You can combine multiple expressions by enclosing each expression in
+  // parentheses. By default, expressions are combined with AND logic, but
+  // you can specify AND, OR, and NOT logic explicitly.
+  //
+  // Here are a few examples:
+  //
+  //   * `name:Howl` - The backup's name contains the string "howl".
+  //   * `database:prod`
+  //          - The database's name contains the string "prod".
+  //   * `state:CREATING` - The backup is pending creation.
+  //   * `state:READY` - The backup is fully created and ready for use.
+  //   * `(name:howl) AND (create_time < \"2018-03-28T14:50:00Z\")`
+  //          - The backup name contains the string "howl" and `create_time`
+  //              of the backup is before 2018-03-28T14:50:00Z.
+  //   * `expire_time < \"2018-03-28T14:50:00Z\"`
+  //          - The backup `expire_time` is before 2018-03-28T14:50:00Z.
+  //   * `size_bytes > 10000000000` - The backup's size is greater than 10GB
+  string filter = 2;
+
+  // Number of backups to be returned in the response. If 0 or
+  // less, defaults to the server's maximum allowed page size.
+  int32 page_size = 3;
+
+  // If non-empty, `page_token` should contain a
+  // [next_page_token][google.spanner.admin.database.v1.ListBackupsResponse.next_page_token] from a
+  // previous [ListBackupsResponse][google.spanner.admin.database.v1.ListBackupsResponse] to the same `parent` and with the same
+  // `filter`.
+  string page_token = 4;
+}
+
+// The response for [ListBackups][google.spanner.admin.database.v1.DatabaseAdmin.ListBackups].
+message ListBackupsResponse {
+  // The list of matching backups. Backups returned are ordered by `create_time`
+  // in descending order, starting from the most recent `create_time`.
+  repeated Backup backups = 1;
+
+  // `next_page_token` can be sent in a subsequent
+  // [ListBackups][google.spanner.admin.database.v1.DatabaseAdmin.ListBackups] call to fetch more
+  // of the matching backups.
+  string next_page_token = 2;
+}
+
+// The request for
+// [ListBackupOperations][google.spanner.admin.database.v1.DatabaseAdmin.ListBackupOperations].
+message ListBackupOperationsRequest {
+  // Required. The instance of the backup operations. Values are of
+  // the form `projects//instances/`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Instance"
+    }
+  ];
+
+  // An expression that filters the list of returned backup operations.
+  //
+  // A filter expression consists of a field name, a
+  // comparison operator, and a value for filtering.
+  // The value must be a string, a number, or a boolean. The comparison operator
+  // must be one of: `<`, `>`, `<=`, `>=`, `!=`, `=`, or `:`.
+  // Colon `:` is the contains operator. Filter rules are not case sensitive.
+  //
+  // The following fields in the [operation][google.longrunning.Operation]
+  // are eligible for filtering:
+  //
+  //   * `name` - The name of the long-running operation
+  //   * `done` - False if the operation is in progress, else true.
+  //   * `metadata.@type` - the type of metadata. For example, the type string
+  //      for [CreateBackupMetadata][google.spanner.admin.database.v1.CreateBackupMetadata] is
+  //      `type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata`.
+  //   * `metadata.` - any field in metadata.value.
+  //   * `error` - Error associated with the long-running operation.
+  //   * `response.@type` - the type of response.
+  //   * `response.` - any field in response.value.
+  //
+  // You can combine multiple expressions by enclosing each expression in
+  // parentheses. By default, expressions are combined with AND logic, but
+  // you can specify AND, OR, and NOT logic explicitly.
+  //
+  // Here are a few examples:
+  //
+  //   * `done:true` - The operation is complete.
+  //   * `metadata.database:prod` - The database the backup was taken from has
+  //      a name containing the string "prod".
+  //   * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.CreateBackupMetadata) AND` 

+  //     `(metadata.name:howl) AND` 

+  //     `(metadata.progress.start_time < \"2018-03-28T14:50:00Z\") AND` 

+  //     `(error:*)` - Returns operations where:
+  //     * The operation's metadata type is [CreateBackupMetadata][google.spanner.admin.database.v1.CreateBackupMetadata].
+  //     * The backup name contains the string "howl".
+  //     * The operation started before 2018-03-28T14:50:00Z.
+  //     * The operation resulted in an error.
+  string filter = 2;
+
+  // Number of operations to be returned in the response. If 0 or
+  // less, defaults to the server's maximum allowed page size.
+  int32 page_size = 3;
+
+  // If non-empty, `page_token` should contain a
+  // [next_page_token][google.spanner.admin.database.v1.ListBackupOperationsResponse.next_page_token]
+  // from a previous [ListBackupOperationsResponse][google.spanner.admin.database.v1.ListBackupOperationsResponse] to the
+  // same `parent` and with the same `filter`.
+  string page_token = 4;
+}
+
+// The response for
+// [ListBackupOperations][google.spanner.admin.database.v1.DatabaseAdmin.ListBackupOperations].
+message ListBackupOperationsResponse {
+  // The list of matching backup [long-running
+  // operations][google.longrunning.Operation]. Each operation's name will be
+  // prefixed by the backup's name and the operation's
+  // [metadata][google.longrunning.Operation.metadata] will be of type
+  // [CreateBackupMetadata][google.spanner.admin.database.v1.CreateBackupMetadata]. Operations returned include those that are
+  // pending or have completed/failed/canceled within the last 7 days.
+  // Operations returned are ordered by
+  // `operation.metadata.value.progress.start_time` in descending order starting
+  // from the most recently started operation.
+  repeated google.longrunning.Operation operations = 1;
+
+  // `next_page_token` can be sent in a subsequent
+  // [ListBackupOperations][google.spanner.admin.database.v1.DatabaseAdmin.ListBackupOperations]
+  // call to fetch more of the matching metadata.
+  string next_page_token = 2;
+}
+
+// Information about a backup.
+message BackupInfo {
+  // Name of the backup.
+  string backup = 1;
+
+  // The backup contains an externally consistent copy of `source_database` at
+  // the timestamp specified by `create_time`.
+  google.protobuf.Timestamp create_time = 2;
+
+  // Name of the database the backup was created from.
+  string source_database = 3;
+}
diff --git a/third_party/googleapis/google/spanner/admin/database/v1/common.proto b/third_party/googleapis/google/spanner/admin/database/v1/common.proto
new file mode 100644
index 000000000..4914cb8ac
--- /dev/null
+++ b/third_party/googleapis/google/spanner/admin/database/v1/common.proto
@@ -0,0 +1,43 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.spanner.admin.database.v1;
+
+import "google/api/field_behavior.proto";
+import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
+
+option csharp_namespace = "Google.Cloud.Spanner.Admin.Database.V1";
+option go_package = "google.golang.org/genproto/googleapis/spanner/admin/database/v1;database";
+option java_multiple_files = true;
+option java_outer_classname = "CommonProto";
+option java_package = "com.google.spanner.admin.database.v1";
+option php_namespace = "Google\\Cloud\\Spanner\\Admin\\Database\\V1";
+
+// Encapsulates progress related information for a Cloud Spanner long
+// running operation.
+message OperationProgress {
+  // Percent completion of the operation.
+  // Values are between 0 and 100 inclusive.
+  int32 progress_percent = 1;
+
+  // Time the request was received.
+  google.protobuf.Timestamp start_time = 2;
+
+  // If set, the time at which this operation failed or was completed
+  // successfully.
+  google.protobuf.Timestamp end_time = 3;
+}
diff --git a/third_party/googleapis/google/spanner/admin/database/spanner_admin_database.yaml b/third_party/googleapis/google/spanner/admin/database/v1/spanner_admin_database.yaml
similarity index 100%
rename from third_party/googleapis/google/spanner/admin/database/spanner_admin_database.yaml
rename to third_party/googleapis/google/spanner/admin/database/v1/spanner_admin_database.yaml
diff --git a/third_party/googleapis/google/spanner/admin/database/v1/spanner_admin_database_gapic.legacy.yaml b/third_party/googleapis/google/spanner/admin/database/v1/spanner_admin_database_gapic.legacy.yaml
new file mode 100644
index 000000000..6155bfda8
--- /dev/null
+++ b/third_party/googleapis/google/spanner/admin/database/v1/spanner_admin_database_gapic.legacy.yaml
@@ -0,0 +1,396 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.spanner.admin.database.v1
+  python:
+    package_name: google.cloud.spanner_admin_database_v1.gapic
+  go:
+    package_name: cloud.google.com/go/spanner/admin/database/apiv1
+  csharp:
+    package_name: Google.Cloud.Spanner.Admin.Database.V1
+  ruby:
+    package_name: Google::Cloud::Spanner::Admin::Database::V1
+  php:
+    package_name: Google\Cloud\Spanner\Admin\Database\V1
+  nodejs:
+    package_name: spanner.v1
+    domain_layer_location: google-cloud
+interfaces:
+- name: google.spanner.admin.database.v1.DatabaseAdmin
+  collections:
+  - name_pattern: projects/{project}/instances/{instance}
+    entity_name: instance
+    language_overrides:
+    - language: csharp
+      common_resource_name: Google.Cloud.Spanner.Common.V1.InstanceName
+  - name_pattern: projects/{project}/instances/{instance}/backups/{backup}
+    entity_name: backup
+  - name_pattern: projects/{project}/instances/{instance}/databases/{database}
+    entity_name: database
+    language_overrides:
+    - language: csharp
+      common_resource_name: Google.Cloud.Spanner.Common.V1.DatabaseName
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 1000
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 32000
+    initial_rpc_timeout_millis: 60000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 60000
+    total_timeout_millis: 600000
+  methods:
+  - name: ListDatabases
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: databases
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: instance
+    timeout_millis: 30000
+  - name: CreateDatabase
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - create_statement
+    required_fields:
+    - parent
+    - create_statement
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: instance
+    timeout_millis: 3600000
+    long_running:
+      return_type: google.spanner.admin.database.v1.Database
+      metadata_type: google.spanner.admin.database.v1.CreateDatabaseMetadata
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+  - name: GetDatabase
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: database
+    timeout_millis: 30000
+  - name: UpdateDatabaseDdl
+    flattening:
+      groups:
+      - parameters:
+        - database
+        - statements
+    required_fields:
+    - database
+    - statements
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      database: database
+    timeout_millis: 3600000
+    long_running:
+      return_type: google.protobuf.Empty
+      metadata_type: google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+  - name: DropDatabase
+    flattening:
+      groups:
+      - parameters:
+        - database
+    required_fields:
+    - database
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      database: database
+    timeout_millis: 3600000
+  - name: GetDatabaseDdl
+    flattening:
+      groups:
+      - parameters:
+        - database
+    required_fields:
+    - database
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      database: database
+    timeout_millis: 30000
+  - name: SetIamPolicy
+    flattening:
+      groups:
+      - parameters:
+        - resource
+        - policy
+    required_fields:
+    - resource
+    - policy
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: database
+    timeout_millis: 30000
+  - name: GetIamPolicy
+    flattening:
+      groups:
+      - parameters:
+        - resource
+    required_fields:
+    - resource
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: database
+    timeout_millis: 30000
+  - name: TestIamPermissions
+    flattening:
+      groups:
+      - parameters:
+        - resource
+        - permissions
+    required_fields:
+    - resource
+    - permissions
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: database
+    timeout_millis: 30000
+  - name: CreateBackup
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - backup_id
+        - backup
+    required_fields:
+    - parent
+    - backup_id
+    - backup
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: instance
+    long_running:
+      return_type: google.spanner.admin.database.v1.Backup
+      metadata_type: google.spanner.admin.database.v1.CreateBackupMetadata
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 172800000
+    timeout_millis: 3600000
+  - name: GetBackup
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: backup
+    timeout_millis: 600000
+  - name: UpdateBackup
+    flattening:
+      groups:
+      - parameters:
+        - backup
+        - update_mask
+    required_fields:
+    - backup
+    - update_mask
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      backup.name: backup
+    timeout_millis: 600000
+  - name: DeleteBackup
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: backup
+    timeout_millis: 3600000
+  - name: ListBackups
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - filter
+    required_fields:
+    - parent
+    - filter
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: backups
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: instance
+    timeout_millis: 600000
+  - name: RestoreDatabase
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - database_id
+    required_fields:
+    - parent
+    - database_id
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: instance
+    long_running:
+      return_type: google.spanner.admin.database.v1.Database
+      metadata_type: google.spanner.admin.database.v1.RestoreDatabaseMetadata
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+    timeout_millis: 3600000
+  - name: ListDatabaseOperations
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - filter
+    required_fields:
+    - parent
+    - filter
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: operations
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: instance
+    timeout_millis: 600000
+  - name: ListBackupOperations
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - filter
+    required_fields:
+    - parent
+    - filter
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: operations
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: instance
+    timeout_millis: 600000
+resource_name_generation:
+- message_name: ListDatabasesRequest
+  field_entity_map:
+    parent: instance
+- message_name: CreateDatabaseRequest
+  field_entity_map:
+    parent: instance
+- message_name: CreateDatabaseMetadata
+  field_entity_map:
+    database: database
+- message_name: GetDatabaseRequest
+  field_entity_map:
+    name: database
+- message_name: UpdateDatabaseDdlRequest
+  field_entity_map:
+    database: database
+- message_name: UpdateDatabaseDdlMetadata
+  field_entity_map:
+    database: database
+- message_name: DropDatabaseRequest
+  field_entity_map:
+    database: database
+- message_name: GetDatabaseDdlRequest
+  field_entity_map:
+    database: database
+- message_name: Database
+  field_entity_map:
+    name: database
+- message_name: Backup
+  field_entity_map:
+    name: backup
+- message_name: CreateBackupRequest
+  field_entity_map:
+    parent: instance
+- message_name: CreateBackupMetadata
+  field_entity_map:
+    name: backup
+    database: database
+- message_name: UpdateBackupRequest
+- message_name: GetBackupRequest
+  field_entity_map:
+    name: backup
+- message_name: DeleteBackupRequest
+  field_entity_map:
+    name: backup
+- message_name: ListBackupsRequest
+  field_entity_map:
+    parent: instance
+- message_name: ListBackupsResponse
+- message_name: ListDatabaseOperationsRequest
+  field_entity_map:
+    parent: instance
+- message_name: ListDatabaseOperationsResponse
+- message_name: RestoreDatabaseRequest
+  field_entity_map:
+    parent: instance
+    database_id: database
+- message_name: RestoreDatabaseMetadata
diff --git a/third_party/googleapis/google/spanner/admin/database/v1/spanner_admin_database_gapic.yaml b/third_party/googleapis/google/spanner/admin/database/v1/spanner_admin_database_gapic.yaml
index 719839491..0df2c7710 100644
--- a/third_party/googleapis/google/spanner/admin/database/v1/spanner_admin_database_gapic.yaml
+++ b/third_party/googleapis/google/spanner/admin/database/v1/spanner_admin_database_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.spanner.admin.database.v1
@@ -18,17 +18,6 @@ language_settings:
     domain_layer_location: google-cloud
 interfaces:
 - name: google.spanner.admin.database.v1.DatabaseAdmin
-  collections:
-  - name_pattern: projects/{project}/instances/{instance}
-    entity_name: instance
-    language_overrides:
-    - language: csharp
-      common_resource_name: Google.Cloud.Spanner.Common.V1.InstanceName
-  - name_pattern: projects/{project}/instances/{instance}/databases/{database}
-    entity_name: database
-    language_overrides:
-    - language: csharp
-      common_resource_name: Google.Cloud.Spanner.Common.V1.DatabaseName
   retry_codes_def:
   - name: idempotent
     retry_codes:
@@ -46,174 +35,77 @@ interfaces:
     max_rpc_timeout_millis: 60000
     total_timeout_millis: 600000
   methods:
-  - name: ListDatabases
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: databases
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: instance
-    timeout_millis: 30000
   - name: CreateDatabase
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - create_statement
-    required_fields:
-    - parent
-    - create_statement
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: instance
-    timeout_millis: 3600000
     long_running:
-      return_type: google.spanner.admin.database.v1.Database
-      metadata_type: google.spanner.admin.database.v1.CreateDatabaseMetadata
       initial_poll_delay_millis: 20000
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 45000
       total_poll_timeout_millis: 86400000
+    timeout_millis: 3600000
   - name: GetDatabase
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: database
     timeout_millis: 30000
   - name: UpdateDatabaseDdl
-    flattening:
-      groups:
-      - parameters:
-        - database
-        - statements
-    required_fields:
-    - database
-    - statements
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      database: database
-    timeout_millis: 3600000
     long_running:
-      return_type: google.protobuf.Empty
-      metadata_type: google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata
       initial_poll_delay_millis: 20000
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 45000
       total_poll_timeout_millis: 86400000
+    timeout_millis: 3600000
   - name: DropDatabase
-    flattening:
-      groups:
-      - parameters:
-        - database
-    required_fields:
-    - database
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      database: database
     timeout_millis: 3600000
   - name: GetDatabaseDdl
-    flattening:
-      groups:
-      - parameters:
-        - database
-    required_fields:
-    - database
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      database: database
     timeout_millis: 30000
   - name: SetIamPolicy
-    flattening:
-      groups:
-      - parameters:
-        - resource
-        - policy
-    required_fields:
-    - resource
-    - policy
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      resource: database
     timeout_millis: 30000
   - name: GetIamPolicy
-    flattening:
-      groups:
-      - parameters:
-        - resource
-    required_fields:
-    - resource
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      resource: database
     timeout_millis: 30000
   - name: TestIamPermissions
-    flattening:
-      groups:
-      - parameters:
-        - resource
-        - permissions
-    required_fields:
-    - resource
-    - permissions
+    timeout_millis: 30000
+  - name: CreateBackup
     retry_codes_name: non_idempotent
     retry_params_name: default
-    field_name_patterns:
-      resource: database
-    timeout_millis: 30000
-resource_name_generation:
-- message_name: ListDatabasesRequest
-  field_entity_map:
-    parent: instance
-- message_name: CreateDatabaseRequest
-  field_entity_map:
-    parent: instance
-- message_name: CreateDatabaseMetadata
-  field_entity_map:
-    database: database
-- message_name: GetDatabaseRequest
-  field_entity_map:
-    name: database
-- message_name: UpdateDatabaseDdlRequest
-  field_entity_map:
-    database: database
-- message_name: UpdateDatabaseDdlMetadata
-  field_entity_map:
-    database: database
-- message_name: DropDatabaseRequest
-  field_entity_map:
-    database: database
-- message_name: GetDatabaseDdlRequest
-  field_entity_map:
-    database: database
-- message_name: Database
-  field_entity_map:
-    name: database
+    long_running:
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 172800000
+    timeout_millis: 3600000
+  - name: GetBackup
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 600000
+  - name: UpdateBackup
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    timeout_millis: 600000
+  - name: DeleteBackup
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 3600000
+  - name: ListBackups
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 600000
+  - name: RestoreDatabase
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    long_running:
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+    timeout_millis: 3600000
+  - name: ListDatabaseOperations
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 600000
+  - name: ListBackupOperations
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 600000
diff --git a/third_party/googleapis/google/spanner/admin/database/v1/spanner_admin_database_grpc_service_config.json b/third_party/googleapis/google/spanner/admin/database/v1/spanner_admin_database_grpc_service_config.json
new file mode 100755
index 000000000..e19bb95b9
--- /dev/null
+++ b/third_party/googleapis/google/spanner/admin/database/v1/spanner_admin_database_grpc_service_config.json
@@ -0,0 +1,91 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.spanner.admin.database.v1.DatabaseAdmin",
+          "method": "ListDatabases"
+        },
+        {
+          "service": "google.spanner.admin.database.v1.DatabaseAdmin",
+          "method": "GetDatabase"
+        },
+        {
+          "service": "google.spanner.admin.database.v1.DatabaseAdmin",
+          "method": "UpdateDatabaseDdl"
+        },
+        {
+          "service": "google.spanner.admin.database.v1.DatabaseAdmin",
+          "method": "DropDatabase"
+        },
+        {
+          "service": "google.spanner.admin.database.v1.DatabaseAdmin",
+          "method": "GetDatabaseDdl"
+        },
+        {
+          "service": "google.spanner.admin.database.v1.DatabaseAdmin",
+          "method": "GetIamPolicy"
+        },
+        {
+          "service": "google.spanner.admin.database.v1.DatabaseAdmin",
+          "method": "GetBackup"
+        },
+        {
+          "service": "google.spanner.admin.database.v1.DatabaseAdmin",
+          "method": "UpdateBackup"
+        },
+        {
+          "service": "google.spanner.admin.database.v1.DatabaseAdmin",
+          "method": "DeleteBackup"
+        },
+        {
+          "service": "google.spanner.admin.database.v1.DatabaseAdmin",
+          "method": "ListBackups"
+        },
+        {
+          "service": "google.spanner.admin.database.v1.DatabaseAdmin",
+          "method": "RestoreDatabase"
+        },
+        {
+          "service": "google.spanner.admin.database.v1.DatabaseAdmin",
+          "method": "ListDatabaseOperations"
+        },
+        {
+          "service": "google.spanner.admin.database.v1.DatabaseAdmin",
+          "method": "ListBackupOperations"
+        }
+      ],
+      "timeout": "3600s",
+      "retryPolicy": {
+        "initialBackoff": "1s",
+        "maxBackoff": "32s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.spanner.admin.database.v1.DatabaseAdmin",
+          "method": "CreateDatabase"
+        },
+        {
+          "service": "google.spanner.admin.database.v1.DatabaseAdmin",
+          "method": "SetIamPolicy"
+        },
+        {
+          "service": "google.spanner.admin.database.v1.DatabaseAdmin",
+          "method": "TestIamPermissions"
+        },
+        {
+          "service": "google.spanner.admin.database.v1.DatabaseAdmin",
+          "method": "CreateBackup"
+        }
+      ],
+      "timeout": "3600s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/spanner/admin/database/v1/spanner_database_admin.proto b/third_party/googleapis/google/spanner/admin/database/v1/spanner_database_admin.proto
index 491606e6f..d48adc8ab 100644
--- a/third_party/googleapis/google/spanner/admin/database/v1/spanner_database_admin.proto
+++ b/third_party/googleapis/google/spanner/admin/database/v1/spanner_database_admin.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -17,11 +17,16 @@ syntax = "proto3";
 package google.spanner.admin.database.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/iam/v1/iam_policy.proto";
 import "google/iam/v1/policy.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/timestamp.proto";
+import "google/spanner/admin/database/v1/backup.proto";
+import "google/spanner/admin/database/v1/common.proto";
 
 option csharp_namespace = "Google.Cloud.Spanner.Admin.Database.V1";
 option go_package = "google.golang.org/genproto/googleapis/spanner/admin/database/v1;database";
@@ -29,18 +34,29 @@ option java_multiple_files = true;
 option java_outer_classname = "SpannerDatabaseAdminProto";
 option java_package = "com.google.spanner.admin.database.v1";
 option php_namespace = "Google\\Cloud\\Spanner\\Admin\\Database\\V1";
+option (google.api.resource_definition) = {
+  type: "spanner.googleapis.com/Instance"
+  pattern: "projects/{project}/instances/{instance}"
+};
 
 // Cloud Spanner Database Admin API
 //
 // The Cloud Spanner Database Admin API can be used to create, drop, and
 // list databases. It also enables updating the schema of pre-existing
-// databases.
+// databases. It can be also used to create, delete and list backups for a
+// database and to restore from an existing backup.
 service DatabaseAdmin {
+  option (google.api.default_host) = "spanner.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/spanner.admin";
+
   // Lists Cloud Spanner databases.
   rpc ListDatabases(ListDatabasesRequest) returns (ListDatabasesResponse) {
     option (google.api.http) = {
       get: "/v1/{parent=projects/*/instances/*}/databases"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Creates a new Cloud Spanner database and starts to prepare it for serving.
@@ -48,15 +64,19 @@ service DatabaseAdmin {
   // have a name of the format `/operations/` and
   // can be used to track preparation of the database. The
   // [metadata][google.longrunning.Operation.metadata] field type is
-  // [CreateDatabaseMetadata][google.spanner.admin.database.v1.CreateDatabaseMetadata].
-  // The [response][google.longrunning.Operation.response] field type is
+  // [CreateDatabaseMetadata][google.spanner.admin.database.v1.CreateDatabaseMetadata]. The
+  // [response][google.longrunning.Operation.response] field type is
   // [Database][google.spanner.admin.database.v1.Database], if successful.
-  rpc CreateDatabase(CreateDatabaseRequest)
-      returns (google.longrunning.Operation) {
+  rpc CreateDatabase(CreateDatabaseRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v1/{parent=projects/*/instances/*}/databases"
       body: "*"
     };
+    option (google.api.method_signature) = "parent,create_statement";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.spanner.admin.database.v1.Database"
+      metadata_type: "google.spanner.admin.database.v1.CreateDatabaseMetadata"
+    };
   }
 
   // Gets the state of a Cloud Spanner database.
@@ -64,6 +84,7 @@ service DatabaseAdmin {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/instances/*/databases/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Updates the schema of a Cloud Spanner database by
@@ -72,21 +93,27 @@ service DatabaseAdmin {
   // the format `/operations/` and can be used to
   // track execution of the schema change(s). The
   // [metadata][google.longrunning.Operation.metadata] field type is
-  // [UpdateDatabaseDdlMetadata][google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata].
-  // The operation has no response.
-  rpc UpdateDatabaseDdl(UpdateDatabaseDdlRequest)
-      returns (google.longrunning.Operation) {
+  // [UpdateDatabaseDdlMetadata][google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata].  The operation has no response.
+  rpc UpdateDatabaseDdl(UpdateDatabaseDdlRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       patch: "/v1/{database=projects/*/instances/*/databases/*}/ddl"
       body: "*"
     };
+    option (google.api.method_signature) = "database,statements";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.protobuf.Empty"
+      metadata_type: "google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata"
+    };
   }
 
   // Drops (aka deletes) a Cloud Spanner database.
+  // Completed backups for the database will be retained according to their
+  // `expire_time`.
   rpc DropDatabase(DropDatabaseRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v1/{database=projects/*/instances/*/databases/*}"
     };
+    option (google.api.method_signature) = "database";
   }
 
   // Returns the schema of a Cloud Spanner database as a list of formatted
@@ -96,51 +123,211 @@ service DatabaseAdmin {
     option (google.api.http) = {
       get: "/v1/{database=projects/*/instances/*/databases/*}/ddl"
     };
+    option (google.api.method_signature) = "database";
   }
 
-  // Sets the access control policy on a database resource. Replaces any
-  // existing policy.
+  // Sets the access control policy on a database or backup resource.
+  // Replaces any existing policy.
   //
-  // Authorization requires `spanner.databases.setIamPolicy` permission on
-  // [resource][google.iam.v1.SetIamPolicyRequest.resource].
-  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest)
-      returns (google.iam.v1.Policy) {
+  // Authorization requires `spanner.databases.setIamPolicy`
+  // permission on [resource][google.iam.v1.SetIamPolicyRequest.resource].
+  // For backups, authorization requires `spanner.backups.setIamPolicy`
+  // permission on [resource][google.iam.v1.SetIamPolicyRequest.resource].
+  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) returns (google.iam.v1.Policy) {
     option (google.api.http) = {
       post: "/v1/{resource=projects/*/instances/*/databases/*}:setIamPolicy"
       body: "*"
+      additional_bindings {
+        post: "/v1/{resource=projects/*/instances/*/backups/*}:setIamPolicy"
+        body: "*"
+      }
     };
+    option (google.api.method_signature) = "resource,policy";
   }
 
-  // Gets the access control policy for a database resource. Returns an empty
-  // policy if a database exists but does not have a policy set.
+  // Gets the access control policy for a database or backup resource.
+  // Returns an empty policy if a database or backup exists but does not have a
+  // policy set.
   //
   // Authorization requires `spanner.databases.getIamPolicy` permission on
   // [resource][google.iam.v1.GetIamPolicyRequest.resource].
-  rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest)
-      returns (google.iam.v1.Policy) {
+  // For backups, authorization requires `spanner.backups.getIamPolicy`
+  // permission on [resource][google.iam.v1.GetIamPolicyRequest.resource].
+  rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) returns (google.iam.v1.Policy) {
     option (google.api.http) = {
       post: "/v1/{resource=projects/*/instances/*/databases/*}:getIamPolicy"
       body: "*"
+      additional_bindings {
+        post: "/v1/{resource=projects/*/instances/*/backups/*}:getIamPolicy"
+        body: "*"
+      }
     };
+    option (google.api.method_signature) = "resource";
   }
 
-  // Returns permissions that the caller has on the specified database resource.
+  // Returns permissions that the caller has on the specified database or backup
+  // resource.
   //
-  // Attempting this RPC on a non-existent Cloud Spanner database will result in
-  // a NOT_FOUND error if the user has `spanner.databases.list` permission on
-  // the containing Cloud Spanner instance. Otherwise returns an empty set of
-  // permissions.
-  rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest)
-      returns (google.iam.v1.TestIamPermissionsResponse) {
+  // Attempting this RPC on a non-existent Cloud Spanner database will
+  // result in a NOT_FOUND error if the user has
+  // `spanner.databases.list` permission on the containing Cloud
+  // Spanner instance. Otherwise returns an empty set of permissions.
+  // Calling this method on a backup that does not exist will
+  // result in a NOT_FOUND error if the user has
+  // `spanner.backups.list` permission on the containing instance.
+  rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest) returns (google.iam.v1.TestIamPermissionsResponse) {
     option (google.api.http) = {
       post: "/v1/{resource=projects/*/instances/*/databases/*}:testIamPermissions"
       body: "*"
+      additional_bindings {
+        post: "/v1/{resource=projects/*/instances/*/backups/*}:testIamPermissions"
+        body: "*"
+      }
+    };
+    option (google.api.method_signature) = "resource,permissions";
+  }
+
+  // Starts creating a new Cloud Spanner Backup.
+  // The returned backup [long-running operation][google.longrunning.Operation]
+  // will have a name of the format
+  // `projects//instances//backups//operations/`
+  // and can be used to track creation of the backup. The
+  // [metadata][google.longrunning.Operation.metadata] field type is
+  // [CreateBackupMetadata][google.spanner.admin.database.v1.CreateBackupMetadata]. The
+  // [response][google.longrunning.Operation.response] field type is
+  // [Backup][google.spanner.admin.database.v1.Backup], if successful. Cancelling the returned operation will stop the
+  // creation and delete the backup.
+  // There can be only one pending backup creation per database. Backup creation
+  // of different databases can run concurrently.
+  rpc CreateBackup(CreateBackupRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/instances/*}/backups"
+      body: "backup"
+    };
+    option (google.api.method_signature) = "parent,backup,backup_id";
+    option (google.longrunning.operation_info) = {
+      response_type: "Backup"
+      metadata_type: "google.spanner.admin.database.v1.CreateBackupMetadata"
+    };
+  }
+
+  // Gets metadata on a pending or completed [Backup][google.spanner.admin.database.v1.Backup].
+  rpc GetBackup(GetBackupRequest) returns (Backup) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/instances/*/backups/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Updates a pending or completed [Backup][google.spanner.admin.database.v1.Backup].
+  rpc UpdateBackup(UpdateBackupRequest) returns (Backup) {
+    option (google.api.http) = {
+      patch: "/v1/{backup.name=projects/*/instances/*/backups/*}"
+      body: "backup"
+    };
+    option (google.api.method_signature) = "backup,update_mask";
+  }
+
+  // Deletes a pending or completed [Backup][google.spanner.admin.database.v1.Backup].
+  rpc DeleteBackup(DeleteBackupRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/instances/*/backups/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Lists completed and pending backups.
+  // Backups returned are ordered by `create_time` in descending order,
+  // starting from the most recent `create_time`.
+  rpc ListBackups(ListBackupsRequest) returns (ListBackupsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/instances/*}/backups"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Create a new database by restoring from a completed backup. The new
+  // database must be in the same project and in an instance with the same
+  // instance configuration as the instance containing
+  // the backup. The returned database [long-running
+  // operation][google.longrunning.Operation] has a name of the format
+  // `projects//instances//databases//operations/`,
+  // and can be used to track the progress of the operation, and to cancel it.
+  // The [metadata][google.longrunning.Operation.metadata] field type is
+  // [RestoreDatabaseMetadata][google.spanner.admin.database.v1.RestoreDatabaseMetadata].
+  // The [response][google.longrunning.Operation.response] type
+  // is [Database][google.spanner.admin.database.v1.Database], if
+  // successful. Cancelling the returned operation will stop the restore and
+  // delete the database.
+  // There can be only one database being restored into an instance at a time.
+  // Once the restore operation completes, a new restore operation can be
+  // initiated, without waiting for the optimize operation associated with the
+  // first restore to complete.
+  rpc RestoreDatabase(RestoreDatabaseRequest) returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/instances/*}/databases:restore"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent,database_id,backup";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.spanner.admin.database.v1.Database"
+      metadata_type: "google.spanner.admin.database.v1.RestoreDatabaseMetadata"
+    };
+  }
+
+  // Lists database [longrunning-operations][google.longrunning.Operation].
+  // A database operation has a name of the form
+  // `projects//instances//databases//operations/`.
+  // The long-running operation
+  // [metadata][google.longrunning.Operation.metadata] field type
+  // `metadata.type_url` describes the type of the metadata. Operations returned
+  // include those that have completed/failed/canceled within the last 7 days,
+  // and pending operations.
+  rpc ListDatabaseOperations(ListDatabaseOperationsRequest) returns (ListDatabaseOperationsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/instances/*}/databaseOperations"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Lists the backup [long-running operations][google.longrunning.Operation] in
+  // the given instance. A backup operation has a name of the form
+  // `projects//instances//backups//operations/`.
+  // The long-running operation
+  // [metadata][google.longrunning.Operation.metadata] field type
+  // `metadata.type_url` describes the type of the metadata. Operations returned
+  // include those that have completed/failed/canceled within the last 7 days,
+  // and pending operations. Operations returned are ordered by
+  // `operation.metadata.value.progress.start_time` in descending order starting
+  // from the most recently started operation.
+  rpc ListBackupOperations(ListBackupOperationsRequest) returns (ListBackupOperationsResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/instances/*}/backupOperations"
     };
+    option (google.api.method_signature) = "parent";
+  }
+}
+
+// Information about the database restore.
+message RestoreInfo {
+  // The type of the restore source.
+  RestoreSourceType source_type = 1;
+
+  // Information about the source used to restore the database.
+  oneof source_info {
+    // Information about the backup used to restore the database. The backup
+    // may no longer exist.
+    BackupInfo backup_info = 2;
   }
 }
 
 // A Cloud Spanner database.
 message Database {
+  option (google.api.resource) = {
+    type: "spanner.googleapis.com/Database"
+    pattern: "projects/{project}/instances/{instance}/databases/{database}"
+  };
+
   // Indicates the current state of the database.
   enum State {
     // Not specified.
@@ -152,6 +339,16 @@ message Database {
 
     // The database is fully created and ready for use.
     READY = 2;
+
+    // The database is fully created and ready for use, but is still
+    // being optimized for performance and cannot handle full load.
+    //
+    // In this state, the database still references the backup
+    // it was restore from, preventing the backup
+    // from being deleted. When optimizations are complete, the full performance
+    // of the database will be restored, and the database will transition to
+    // `READY` state.
+    READY_OPTIMIZING = 3;
   }
 
   // Required. The name of the database. Values are of the form
@@ -159,76 +356,95 @@ message Database {
   // where `` is as specified in the `CREATE DATABASE`
   // statement. This name can be passed to other API methods to
   // identify the database.
-  string name = 1;
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Output only. The current database state.
-  State state = 2;
+  State state = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. If exists, the time at which the database creation started.
+  google.protobuf.Timestamp create_time = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Applicable only for restored databases. Contains information
+  // about the restore source.
+  RestoreInfo restore_info = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
-// The request for
-// [ListDatabases][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases].
+// The request for [ListDatabases][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases].
 message ListDatabasesRequest {
   // Required. The instance whose databases should be listed.
   // Values are of the form `projects//instances/`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Instance"
+    }
+  ];
 
   // Number of databases to be returned in the response. If 0 or less,
   // defaults to the server's maximum allowed page size.
   int32 page_size = 3;
 
   // If non-empty, `page_token` should contain a
-  // [next_page_token][google.spanner.admin.database.v1.ListDatabasesResponse.next_page_token]
-  // from a previous
-  // [ListDatabasesResponse][google.spanner.admin.database.v1.ListDatabasesResponse].
+  // [next_page_token][google.spanner.admin.database.v1.ListDatabasesResponse.next_page_token] from a
+  // previous [ListDatabasesResponse][google.spanner.admin.database.v1.ListDatabasesResponse].
   string page_token = 4;
 }
 
-// The response for
-// [ListDatabases][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases].
+// The response for [ListDatabases][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases].
 message ListDatabasesResponse {
   // Databases that matched the request.
   repeated Database databases = 1;
 
   // `next_page_token` can be sent in a subsequent
-  // [ListDatabases][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases]
-  // call to fetch more of the matching databases.
+  // [ListDatabases][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases] call to fetch more
+  // of the matching databases.
   string next_page_token = 2;
 }
 
-// The request for
-// [CreateDatabase][google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase].
+// The request for [CreateDatabase][google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase].
 message CreateDatabaseRequest {
   // Required. The name of the instance that will serve the new database.
   // Values are of the form `projects//instances/`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Instance"
+    }
+  ];
 
   // Required. A `CREATE DATABASE` statement, which specifies the ID of the
   // new database.  The database ID must conform to the regular expression
   // `[a-z][a-z0-9_\-]*[a-z0-9]` and be between 2 and 30 characters in length.
   // If the database ID is a reserved word or if it contains a hyphen, the
   // database ID must be enclosed in backticks (`` ` ``).
-  string create_statement = 2;
+  string create_statement = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // An optional list of DDL statements to run inside the newly created
+  // Optional. A list of DDL statements to run inside the newly created
   // database. Statements can create tables, indexes, etc. These
   // statements execute atomically with the creation of the database:
   // if there is an error in any statement, the database is not created.
-  repeated string extra_statements = 3;
+  repeated string extra_statements = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Metadata type for the operation returned by
 // [CreateDatabase][google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase].
 message CreateDatabaseMetadata {
   // The database being created.
-  string database = 1;
+  string database = 1 [(google.api.resource_reference) = {
+                         type: "spanner.googleapis.com/Database"
+                       }];
 }
 
-// The request for
-// [GetDatabase][google.spanner.admin.database.v1.DatabaseAdmin.GetDatabase].
+// The request for [GetDatabase][google.spanner.admin.database.v1.DatabaseAdmin.GetDatabase].
 message GetDatabaseRequest {
   // Required. The name of the requested database. Values are of the form
   // `projects//instances//databases/`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Database"
+    }
+  ];
 }
 
 // Enqueues the given DDL statements to be applied, in order but not
@@ -245,14 +461,19 @@ message GetDatabaseRequest {
 // Each batch of statements is assigned a name which can be used with
 // the [Operations][google.longrunning.Operations] API to monitor
 // progress. See the
-// [operation_id][google.spanner.admin.database.v1.UpdateDatabaseDdlRequest.operation_id]
-// field for more details.
+// [operation_id][google.spanner.admin.database.v1.UpdateDatabaseDdlRequest.operation_id] field for more
+// details.
 message UpdateDatabaseDdlRequest {
   // Required. The database to update.
-  string database = 1;
+  string database = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Database"
+    }
+  ];
 
-  // DDL statements to be applied to the database.
-  repeated string statements = 2;
+  // Required. DDL statements to be applied to the database.
+  repeated string statements = 2 [(google.api.field_behavior) = REQUIRED];
 
   // If empty, the new update request is assigned an
   // automatically-generated operation ID. Otherwise, `operation_id`
@@ -261,20 +482,18 @@ message UpdateDatabaseDdlRequest {
   //
   // Specifying an explicit operation ID simplifies determining
   // whether the statements were executed in the event that the
-  // [UpdateDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl]
-  // call is replayed, or the return value is otherwise lost: the
-  // [database][google.spanner.admin.database.v1.UpdateDatabaseDdlRequest.database]
-  // and `operation_id` fields can be combined to form the
+  // [UpdateDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl] call is replayed,
+  // or the return value is otherwise lost: the [database][google.spanner.admin.database.v1.UpdateDatabaseDdlRequest.database] and
+  // `operation_id` fields can be combined to form the
   // [name][google.longrunning.Operation.name] of the resulting
-  // [longrunning.Operation][google.longrunning.Operation]:
-  // `/operations/`.
+  // [longrunning.Operation][google.longrunning.Operation]: `/operations/`.
   //
   // `operation_id` should be unique within the database, and must be
   // a valid identifier: `[a-z][a-z0-9_]*`. Note that
   // automatically-generated operation IDs always begin with an
   // underscore. If the named operation already exists,
-  // [UpdateDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl]
-  // returns `ALREADY_EXISTS`.
+  // [UpdateDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl] returns
+  // `ALREADY_EXISTS`.
   string operation_id = 3;
 }
 
@@ -282,7 +501,9 @@ message UpdateDatabaseDdlRequest {
 // [UpdateDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl].
 message UpdateDatabaseDdlMetadata {
   // The database being modified.
-  string database = 1;
+  string database = 1 [(google.api.resource_reference) = {
+                         type: "spanner.googleapis.com/Database"
+                       }];
 
   // For an update this list contains all the statements. For an
   // individual statement, this list contains only that statement.
@@ -294,24 +515,212 @@ message UpdateDatabaseDdlMetadata {
   repeated google.protobuf.Timestamp commit_timestamps = 3;
 }
 
-// The request for
-// [DropDatabase][google.spanner.admin.database.v1.DatabaseAdmin.DropDatabase].
+// The request for [DropDatabase][google.spanner.admin.database.v1.DatabaseAdmin.DropDatabase].
 message DropDatabaseRequest {
   // Required. The database to be dropped.
-  string database = 1;
+  string database = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Database"
+    }
+  ];
 }
 
-// The request for
-// [GetDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDdl].
+// The request for [GetDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDdl].
 message GetDatabaseDdlRequest {
   // Required. The database whose schema we wish to get.
-  string database = 1;
+  string database = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Database"
+    }
+  ];
 }
 
-// The response for
-// [GetDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDdl].
+// The response for [GetDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDdl].
 message GetDatabaseDdlResponse {
   // A list of formatted DDL statements defining the schema of the database
   // specified in the request.
   repeated string statements = 1;
 }
+
+// The request for
+// [ListDatabaseOperations][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabaseOperations].
+message ListDatabaseOperationsRequest {
+  // Required. The instance of the database operations.
+  // Values are of the form `projects//instances/`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Instance"
+    }
+  ];
+
+  // An expression that filters the list of returned operations.
+  //
+  // A filter expression consists of a field name, a
+  // comparison operator, and a value for filtering.
+  // The value must be a string, a number, or a boolean. The comparison operator
+  // must be one of: `<`, `>`, `<=`, `>=`, `!=`, `=`, or `:`.
+  // Colon `:` is the contains operator. Filter rules are not case sensitive.
+  //
+  // The following fields in the [Operation][google.longrunning.Operation]
+  // are eligible for filtering:
+  //
+  //   * `name` - The name of the long-running operation
+  //   * `done` - False if the operation is in progress, else true.
+  //   * `metadata.@type` - the type of metadata. For example, the type string
+  //      for [RestoreDatabaseMetadata][google.spanner.admin.database.v1.RestoreDatabaseMetadata] is
+  //      `type.googleapis.com/google.spanner.admin.database.v1.RestoreDatabaseMetadata`.
+  //   * `metadata.` - any field in metadata.value.
+  //   * `error` - Error associated with the long-running operation.
+  //   * `response.@type` - the type of response.
+  //   * `response.` - any field in response.value.
+  //
+  // You can combine multiple expressions by enclosing each expression in
+  // parentheses. By default, expressions are combined with AND logic. However,
+  // you can specify AND, OR, and NOT logic explicitly.
+  //
+  // Here are a few examples:
+  //
+  //   * `done:true` - The operation is complete.
+  //   * `(metadata.@type=type.googleapis.com/google.spanner.admin.database.v1.RestoreDatabaseMetadata) AND` 

+  //     `(metadata.source_type:BACKUP) AND` 

+  //     `(metadata.backup_info.backup:backup_howl) AND` 

+  //     `(metadata.name:restored_howl) AND` 

+  //     `(metadata.progress.start_time < \"2018-03-28T14:50:00Z\") AND` 

+  //     `(error:*)` - Return operations where:
+  //     * The operation's metadata type is [RestoreDatabaseMetadata][google.spanner.admin.database.v1.RestoreDatabaseMetadata].
+  //     * The database is restored from a backup.
+  //     * The backup name contains "backup_howl".
+  //     * The restored database's name contains "restored_howl".
+  //     * The operation started before 2018-03-28T14:50:00Z.
+  //     * The operation resulted in an error.
+  string filter = 2;
+
+  // Number of operations to be returned in the response. If 0 or
+  // less, defaults to the server's maximum allowed page size.
+  int32 page_size = 3;
+
+  // If non-empty, `page_token` should contain a
+  // [next_page_token][google.spanner.admin.database.v1.ListDatabaseOperationsResponse.next_page_token]
+  // from a previous [ListDatabaseOperationsResponse][google.spanner.admin.database.v1.ListDatabaseOperationsResponse] to the
+  // same `parent` and with the same `filter`.
+  string page_token = 4;
+}
+
+// The response for
+// [ListDatabaseOperations][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabaseOperations].
+message ListDatabaseOperationsResponse {
+  // The list of matching database [long-running
+  // operations][google.longrunning.Operation]. Each operation's name will be
+  // prefixed by the database's name. The operation's
+  // [metadata][google.longrunning.Operation.metadata] field type
+  // `metadata.type_url` describes the type of the metadata.
+  repeated google.longrunning.Operation operations = 1;
+
+  // `next_page_token` can be sent in a subsequent
+  // [ListDatabaseOperations][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabaseOperations]
+  // call to fetch more of the matching metadata.
+  string next_page_token = 2;
+}
+
+// The request for
+// [RestoreDatabase][google.spanner.admin.database.v1.DatabaseAdmin.RestoreDatabase].
+message RestoreDatabaseRequest {
+  // Required. The name of the instance in which to create the
+  // restored database. This instance must be in the same project and
+  // have the same instance configuration as the instance containing
+  // the source backup. Values are of the form
+  // `projects//instances/`.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Instance"
+    }
+  ];
+
+  // Required. The id of the database to create and restore to. This
+  // database must not already exist. The `database_id` appended to
+  // `parent` forms the full database name of the form
+  // `projects//instances//databases/`.
+  string database_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The source from which to restore.
+  oneof source {
+    // Name of the backup from which to restore.  Values are of the form
+    // `projects//instances//backups/`.
+    string backup = 3 [(google.api.resource_reference) = {
+                         type: "spanner.googleapis.com/Backup"
+                       }];
+  }
+}
+
+// Metadata type for the long-running operation returned by
+// [RestoreDatabase][google.spanner.admin.database.v1.DatabaseAdmin.RestoreDatabase].
+message RestoreDatabaseMetadata {
+  // Name of the database being created and restored to.
+  string name = 1;
+
+  // The type of the restore source.
+  RestoreSourceType source_type = 2;
+
+  // Information about the source used to restore the database, as specified by
+  // `source` in [RestoreDatabaseRequest][google.spanner.admin.database.v1.RestoreDatabaseRequest].
+  oneof source_info {
+    // Information about the backup used to restore the database.
+    BackupInfo backup_info = 3;
+  }
+
+  // The progress of the
+  // [RestoreDatabase][google.spanner.admin.database.v1.DatabaseAdmin.RestoreDatabase]
+  // operation.
+  OperationProgress progress = 4;
+
+  // The time at which cancellation of this operation was received.
+  // [Operations.CancelOperation][google.longrunning.Operations.CancelOperation]
+  // starts asynchronous cancellation on a long-running operation. The server
+  // makes a best effort to cancel the operation, but success is not guaranteed.
+  // Clients can use
+  // [Operations.GetOperation][google.longrunning.Operations.GetOperation] or
+  // other methods to check whether the cancellation succeeded or whether the
+  // operation completed despite cancellation. On successful cancellation,
+  // the operation is not deleted; instead, it becomes an operation with
+  // an [Operation.error][google.longrunning.Operation.error] value with a
+  // [google.rpc.Status.code][google.rpc.Status.code] of 1, corresponding to `Code.CANCELLED`.
+  google.protobuf.Timestamp cancel_time = 5;
+
+  // If exists, the name of the long-running operation that will be used to
+  // track the post-restore optimization process to optimize the performance of
+  // the restored database, and remove the dependency on the restore source.
+  // The name is of the form
+  // `projects//instances//databases//operations/`
+  // where the  is the name of database being created and restored to.
+  // The metadata type of the  long-running operation is
+  // [OptimizeRestoredDatabaseMetadata][google.spanner.admin.database.v1.OptimizeRestoredDatabaseMetadata]. This long-running operation will be
+  // automatically created by the system after the RestoreDatabase long-running
+  // operation completes successfully. This operation will not be created if the
+  // restore was not successful.
+  string optimize_database_operation_name = 6;
+}
+
+// Metadata type for the long-running operation used to track the progress
+// of optimizations performed on a newly restored database. This long-running
+// operation is automatically created by the system after the successful
+// completion of a database restore, and cannot be cancelled.
+message OptimizeRestoredDatabaseMetadata {
+  // Name of the restored database being optimized.
+  string name = 1;
+
+  // The progress of the post-restore optimizations.
+  OperationProgress progress = 2;
+}
+
+// Indicates the type of the restore source.
+enum RestoreSourceType {
+  // No restore associated.
+  TYPE_UNSPECIFIED = 0;
+
+  // A backup was used as the source of the restore.
+  BACKUP = 1;
+}
diff --git a/third_party/googleapis/google/spanner/admin/instance/BUILD.bazel b/third_party/googleapis/google/spanner/admin/instance/BUILD.bazel
index 1e5b8c2af..a87c57fec 100644
--- a/third_party/googleapis/google/spanner/admin/instance/BUILD.bazel
+++ b/third_party/googleapis/google/spanner/admin/instance/BUILD.bazel
@@ -1 +1 @@
-exports_files(glob(["*.yaml"]))
\ No newline at end of file
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/spanner/admin/instance/artman_spanner_admin_instance.legacy.yaml b/third_party/googleapis/google/spanner/admin/instance/artman_spanner_admin_instance.legacy.yaml
new file mode 100644
index 000000000..daed7dc29
--- /dev/null
+++ b/third_party/googleapis/google/spanner/admin/instance/artman_spanner_admin_instance.legacy.yaml
@@ -0,0 +1,20 @@
+common:
+  api_name: spanner-admin-instance
+  api_version: v1
+  organization_name: google-cloud
+  service_yaml: v1/spanner_admin_instance.yaml
+  gapic_yaml: v1/spanner_admin_instance_gapic.legacy.yaml
+  proto_package: google.spanner.admin.instance.v1
+  src_proto_paths:
+  - v1
+  proto_deps:
+  - name: google-common-protos
+  - name: google-iam-v1
+    proto_path: google/iam/v1
+artifacts:
+- name: php_gapic
+  type: GAPIC
+  language: PHP
+- name: ruby_gapic
+  type: GAPIC
+  language: RUBY
diff --git a/third_party/googleapis/google/spanner/admin/instance/artman_spanner_admin_instance.yaml b/third_party/googleapis/google/spanner/admin/instance/artman_spanner_admin_instance.yaml
index 7317d92a4..23ae80aaa 100644
--- a/third_party/googleapis/google/spanner/admin/instance/artman_spanner_admin_instance.yaml
+++ b/third_party/googleapis/google/spanner/admin/instance/artman_spanner_admin_instance.yaml
@@ -2,8 +2,9 @@ common:
   api_name: spanner-admin-instance
   api_version: v1
   organization_name: google-cloud
-  service_yaml: spanner_admin_instance.yaml
+  service_yaml: v1/spanner_admin_instance.yaml
   gapic_yaml: v1/spanner_admin_instance_gapic.yaml
+  proto_package: google.spanner.admin.instance.v1
   src_proto_paths:
   - v1
   proto_deps:
@@ -17,12 +18,6 @@ artifacts:
 - name: python_gapic
   type: GAPIC
   language: PYTHON
-- name: php_gapic
-  type: GAPIC
-  language: PHP
-- name: ruby_gapic
-  type: GAPIC
-  language: RUBY
 - name: go_gapic
   type: GAPIC
   language: GO
diff --git a/third_party/googleapis/google/spanner/admin/instance/v1/BUILD.bazel b/third_party/googleapis/google/spanner/admin/instance/v1/BUILD.bazel
index 9736c7aa1..41bcb7d1f 100644
--- a/third_party/googleapis/google/spanner/admin/instance/v1/BUILD.bazel
+++ b/third_party/googleapis/google/spanner/admin/instance/v1/BUILD.bazel
@@ -1,18 +1,24 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
-    name = "spanner_admin_instance_proto",
+    name = "instance_proto",
     srcs = [
         "spanner_instance_admin.proto",
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
         "//google/iam/v1:iam_policy_proto",
         "//google/iam/v1:policy_proto",
         "//google/longrunning:operations_proto",
@@ -23,8 +29,11 @@ proto_library(
 )
 
 proto_library_with_info(
-    name = "spanner_admin_instance_proto_with_info",
-    deps = [":spanner_admin_instance_proto"],
+    name = "instance_proto_with_info",
+    deps = [
+        ":instance_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -32,72 +41,57 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-    "@com_google_api_grpc_proto_google_iam_v1//jar",
-]
-
 java_proto_library(
-    name = "spanner_admin_instance_java_proto",
-    deps = [":spanner_admin_instance_proto"],
+    name = "instance_java_proto",
+    deps = [":instance_proto"],
 )
 
 java_grpc_library(
-    name = "spanner_admin_instance_java_grpc",
-    srcs = [":spanner_admin_instance_proto"],
-    deps = [":spanner_admin_instance_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "spanner_admin_instance_resource_name_java_proto",
-    gapic_yaml = "spanner_admin_instance_gapic.yaml",
-    deps = [":spanner_admin_instance_proto"],
+    name = "instance_java_grpc",
+    srcs = [":instance_proto"],
+    deps = [":instance_java_proto"],
 )
 
 java_gapic_library(
-    name = "spanner_admin_instance_java_gapic",
-    src = ":spanner_admin_instance_proto_with_info",
+    name = "instance_java_gapic",
+    src = ":instance_proto_with_info",
     gapic_yaml = "spanner_admin_instance_gapic.yaml",
-    service_yaml = "//google/spanner/admin/instance:spanner_admin_instance.yaml",
-    test_deps = [":spanner_admin_instance_java_grpc"],
+    package = "google.spanner.admin.instance.v1",
+    service_yaml = "spanner_admin_instance.yaml",
+    test_deps = [
+        ":instance_java_grpc",
+        "//google/iam/v1:iam_java_grpc",
+    ],
     deps = [
-        ":spanner_admin_instance_java_proto",
-        ":spanner_admin_instance_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+        ":instance_java_proto",
+        "//google/iam/v1:iam_java_proto",
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":spanner_admin_instance_java_gapic_test",
+java_gapic_test(
+    name = "instance_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.spanner.admin.instance.v1.InstanceAdminClientTest",
     ],
-) for test_name in [
-    "com.google.cloud.spanner.admin.instance.v1.InstanceAdminClientTest",
-]]
+    runtime_deps = [":instance_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
-    name = "google-cloud-spanner-admin-instance-v1-java",
-    client_deps = [":spanner_admin_instance_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":spanner_admin_instance_java_gapic_test"],
-    grpc_deps = [":spanner_admin_instance_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
-        ":spanner_admin_instance_java_proto",
-        ":spanner_admin_instance_proto",
-        ":spanner_admin_instance_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    name = "google-cloud-admin-instance-v1-java",
+    deps = [
+        ":instance_java_gapic",
+        ":instance_java_grpc",
+        ":instance_java_proto",
+        ":instance_proto",
+    ],
 )
 
 ##############################################################################
@@ -105,17 +99,17 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
-    name = "spanner_admin_instance_go_proto",
+    name = "instance_go_proto",
     compilers = ["@io_bazel_rules_go//proto:go_grpc"],
     importpath = "google.golang.org/genproto/googleapis/spanner/admin/instance/v1",
-    protos = [":spanner_admin_instance_proto"],
+    protos = [":instance_proto"],
     deps = [
         "//google/api:annotations_go_proto",
         "//google/iam/v1:iam_go_proto",
@@ -124,34 +118,275 @@ go_proto_library(
 )
 
 go_gapic_library(
-    name = "spanner_admin_instance_go_gapic",
-    src = ":spanner_admin_instance_proto_with_info",
-    gapic_yaml = "spanner_admin_instance_gapic.yaml",
-    importpath = "cloud.google.com/go/spanner/admin/instance/apiv1",
-    service_yaml = "//google/spanner/admin/instance:spanner_admin_instance.yaml",
+    name = "instance_go_gapic",
+    srcs = [":instance_proto_with_info"],
+    grpc_service_config = "spanner_admin_instance_grpc_service_config.json",
+    importpath = "cloud.google.com/go/spanner/admin/instance/apiv1;instance",
+    service_yaml = "spanner_admin_instance.yaml",
     deps = [
-        ":spanner_admin_instance_go_proto",
+        ":instance_go_proto",
         "//google/iam/v1:iam_go_proto",
         "//google/longrunning:longrunning_go_gapic",
         "//google/longrunning:longrunning_go_proto",
         "@com_google_cloud_go//longrunning:go_default_library",
+        "@com_google_cloud_go//longrunning/autogen:go_default_library",
     ],
 )
 
 go_test(
-    name = "spanner_admin_instance_go_gapic_test",
-    srcs = [":spanner_admin_instance_go_gapic_srcjar_test"],
-    embed = [":spanner_admin_instance_go_gapic"],
+    name = "instance_go_gapic_test",
+    srcs = [":instance_go_gapic_srcjar_test"],
+    embed = [":instance_go_gapic"],
     importpath = "cloud.google.com/go/spanner/admin/instance/apiv1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
-    name = "gapi-cloud-spanner-admin-instance-v1-go",
+    name = "gapi-cloud-admin-instance-v1-go",
+    deps = [
+        ":instance_go_gapic",
+        ":instance_go_gapic_srcjar-test.srcjar",
+        ":instance_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "instance_moved_proto",
+    srcs = [":instance_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/iam/v1:iam_policy_proto",
+        "//google/iam/v1:policy_proto",
+        "//google/longrunning:operations_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "instance_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":instance_moved_proto"],
+)
+
+py_grpc_library(
+    name = "instance_py_grpc",
+    srcs = [":instance_moved_proto"],
+    deps = [":instance_py_proto"],
+)
+
+py_gapic_library(
+    name = "instance_py_gapic",
+    src = ":instance_proto_with_info",
+    gapic_yaml = "spanner_admin_instance_gapic.yaml",
+    package = "google.spanner.admin.instance.v1",
+    service_yaml = "spanner_admin_instance.yaml",
     deps = [
-        ":spanner_admin_instance_go_gapic",
-        ":spanner_admin_instance_go_gapic_srcjar-smoke-test.srcjar",
-        ":spanner_admin_instance_go_gapic_srcjar-test.srcjar",
-        ":spanner_admin_instance_go_proto",
+        ":instance_py_grpc",
+        ":instance_py_proto",
     ],
 )
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "admin-instance-v1-py",
+    deps = [
+        ":instance_py_gapic",
+        ":instance_py_grpc",
+        ":instance_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "instance_php_proto",
+    deps = [":instance_proto"],
+)
+
+php_grpc_library(
+    name = "instance_php_grpc",
+    srcs = [":instance_proto"],
+    deps = [":instance_php_proto"],
+)
+
+php_gapic_library(
+    name = "instance_php_gapic",
+    src = ":instance_proto_with_info",
+    gapic_yaml = "spanner_admin_instance_gapic.yaml",
+    package = "google.spanner.admin.instance.v1",
+    service_yaml = "spanner_admin_instance.yaml",
+    deps = [
+        ":instance_php_grpc",
+        ":instance_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-admin-instance-v1-php",
+    deps = [
+        ":instance_php_gapic",
+        ":instance_php_grpc",
+        ":instance_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "instance_nodejs_gapic",
+    src = ":instance_proto_with_info",
+    gapic_yaml = "spanner_admin_instance_gapic.yaml",
+    package = "google.spanner.admin.instance.v1",
+    service_yaml = "spanner_admin_instance.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "admin-instance-v1-nodejs",
+    deps = [
+        ":instance_nodejs_gapic",
+        ":instance_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "instance_ruby_proto",
+    deps = [":instance_proto"],
+)
+
+ruby_grpc_library(
+    name = "instance_ruby_grpc",
+    srcs = [":instance_proto"],
+    deps = [":instance_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "instance_ruby_gapic",
+    src = ":instance_proto_with_info",
+    gapic_yaml = "spanner_admin_instance_gapic.yaml",
+    package = "google.spanner.admin.instance.v1",
+    service_yaml = "spanner_admin_instance.yaml",
+    deps = [
+        ":instance_ruby_grpc",
+        ":instance_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-admin-instance-v1-ruby",
+    deps = [
+        ":instance_ruby_gapic",
+        ":instance_ruby_grpc",
+        ":instance_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "instance_csharp_proto",
+    deps = [":instance_proto"],
+)
+
+csharp_grpc_library(
+    name = "instance_csharp_grpc",
+    srcs = [":instance_proto"],
+    deps = [":instance_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "instance_csharp_gapic",
+    src = ":instance_proto_with_info",
+    gapic_yaml = "spanner_admin_instance_gapic.yaml",
+    package = "google.spanner.admin.instance.v1",
+    service_yaml = "spanner_admin_instance.yaml",
+    deps = [
+        ":instance_csharp_grpc",
+        ":instance_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-admin-instance-v1-csharp",
+    deps = [
+        ":instance_csharp_gapic",
+        ":instance_csharp_grpc",
+        ":instance_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "cc_grpc_library",
+    "cc_proto_library")
+
+cc_proto_library(
+    name = "instance_cc_proto",
+    deps = [":instance_proto"],
+)
+
+cc_grpc_library(
+    name = "instance_cc_grpc",
+    srcs = [":instance_proto"],
+    grpc_only = True,
+    deps = [":instance_cc_proto"],
+)
diff --git a/third_party/googleapis/google/spanner/admin/instance/spanner_admin_instance.yaml b/third_party/googleapis/google/spanner/admin/instance/v1/spanner_admin_instance.yaml
similarity index 100%
rename from third_party/googleapis/google/spanner/admin/instance/spanner_admin_instance.yaml
rename to third_party/googleapis/google/spanner/admin/instance/v1/spanner_admin_instance.yaml
diff --git a/third_party/googleapis/google/spanner/admin/instance/v1/spanner_admin_instance_gapic.legacy.yaml b/third_party/googleapis/google/spanner/admin/instance/v1/spanner_admin_instance_gapic.legacy.yaml
new file mode 100644
index 000000000..1c0358db5
--- /dev/null
+++ b/third_party/googleapis/google/spanner/admin/instance/v1/spanner_admin_instance_gapic.legacy.yaml
@@ -0,0 +1,242 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.spanner.admin.instance.v1
+  python:
+    package_name: google.cloud.spanner_admin_instance_v1.gapic
+  go:
+    package_name: cloud.google.com/go/spanner/admin/instance/apiv1
+  csharp:
+    package_name: Google.Cloud.Spanner.Admin.Instance.V1
+  ruby:
+    package_name: Google::Cloud::Spanner::Admin::Instance::V1
+  php:
+    package_name: Google\Cloud\Spanner\Admin\Instance\V1
+  nodejs:
+    package_name: spanner.v1
+    domain_layer_location: google-cloud
+interfaces:
+- name: google.spanner.admin.instance.v1.InstanceAdmin
+  collections:
+  - name_pattern: projects/{project}
+    entity_name: project
+    language_overrides:
+    - language: csharp
+      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
+  - name_pattern: projects/{project}/instanceConfigs/{instance_config}
+    entity_name: instance_config
+  - name_pattern: projects/{project}/instances/{instance}
+    entity_name: instance
+    language_overrides:
+    - language: csharp
+      common_resource_name: Google.Cloud.Spanner.Common.V1.InstanceName
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 1000
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 32000
+    initial_rpc_timeout_millis: 60000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 60000
+    total_timeout_millis: 600000
+  methods:
+  - name: ListInstanceConfigs
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: instance_configs
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 30000
+  - name: GetInstanceConfig
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: instance_config
+    timeout_millis: 30000
+  - name: ListInstances
+    flattening:
+      groups:
+      - parameters:
+        - parent
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: instances
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 30000
+  - name: GetInstance
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: instance
+    timeout_millis: 30000
+  - name: CreateInstance
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - instance_id
+        - instance
+    required_fields:
+    - parent
+    - instance_id
+    - instance
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 30000
+    long_running:
+      return_type: google.spanner.admin.instance.v1.Instance
+      metadata_type: google.spanner.admin.instance.v1.CreateInstanceMetadata
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+  - name: UpdateInstance
+    flattening:
+      groups:
+      - parameters:
+        - instance
+        - field_mask
+    required_fields:
+    - instance
+    - field_mask
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      instance.name: instance
+    timeout_millis: 30000
+    long_running:
+      return_type: google.spanner.admin.instance.v1.Instance
+      metadata_type: google.spanner.admin.instance.v1.UpdateInstanceMetadata
+      initial_poll_delay_millis: 20000
+      poll_delay_multiplier: 1.5
+      max_poll_delay_millis: 45000
+      total_poll_timeout_millis: 86400000
+  - name: DeleteInstance
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: instance
+    timeout_millis: 30000
+  - name: SetIamPolicy
+    flattening:
+      groups:
+      - parameters:
+        - resource
+        - policy
+    required_fields:
+    - resource
+    - policy
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: instance
+    timeout_millis: 30000
+  - name: GetIamPolicy
+    flattening:
+      groups:
+      - parameters:
+        - resource
+    required_fields:
+    - resource
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: instance
+    timeout_millis: 30000
+  - name: TestIamPermissions
+    flattening:
+      groups:
+      - parameters:
+        - resource
+        - permissions
+    required_fields:
+    - resource
+    - permissions
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      resource: instance
+    timeout_millis: 30000
+resource_name_generation:
+- message_name: InstanceConfig
+  field_entity_map:
+    name: instance_config
+- message_name: Instance
+  field_entity_map:
+    name: instance
+    config: instance_config
+- message_name: ListInstanceConfigsRequest
+  field_entity_map:
+    parent: project
+- message_name: GetInstanceConfigRequest
+  field_entity_map:
+    name: instance_config
+- message_name: GetInstanceRequest
+  field_entity_map:
+    name: instance
+- message_name: CreateInstanceRequest
+  field_entity_map:
+    parent: project
+    instance_id: instance
+- message_name: ListInstancesRequest
+  field_entity_map:
+    parent: project
+- message_name: DeleteInstanceRequest
+  field_entity_map:
+    name: instance
diff --git a/third_party/googleapis/google/spanner/admin/instance/v1/spanner_admin_instance_gapic.yaml b/third_party/googleapis/google/spanner/admin/instance/v1/spanner_admin_instance_gapic.yaml
index 1c0358db5..0bfc10cdf 100644
--- a/third_party/googleapis/google/spanner/admin/instance/v1/spanner_admin_instance_gapic.yaml
+++ b/third_party/googleapis/google/spanner/admin/instance/v1/spanner_admin_instance_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.spanner.admin.instance.v1
@@ -18,19 +18,6 @@ language_settings:
     domain_layer_location: google-cloud
 interfaces:
 - name: google.spanner.admin.instance.v1.InstanceAdmin
-  collections:
-  - name_pattern: projects/{project}
-    entity_name: project
-    language_overrides:
-    - language: csharp
-      common_resource_name: Google.Api.Gax.ResourceNames.ProjectName
-  - name_pattern: projects/{project}/instanceConfigs/{instance_config}
-    entity_name: instance_config
-  - name_pattern: projects/{project}/instances/{instance}
-    entity_name: instance
-    language_overrides:
-    - language: csharp
-      common_resource_name: Google.Cloud.Spanner.Common.V1.InstanceName
   retry_codes_def:
   - name: idempotent
     retry_codes:
@@ -49,194 +36,36 @@ interfaces:
     total_timeout_millis: 600000
   methods:
   - name: ListInstanceConfigs
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: instance_configs
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: project
     timeout_millis: 30000
   - name: GetInstanceConfig
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: instance_config
     timeout_millis: 30000
   - name: ListInstances
-    flattening:
-      groups:
-      - parameters:
-        - parent
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: instances
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: project
     timeout_millis: 30000
   - name: GetInstance
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: instance
     timeout_millis: 30000
   - name: CreateInstance
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - instance_id
-        - instance
-    required_fields:
-    - parent
-    - instance_id
-    - instance
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: project
-    timeout_millis: 30000
     long_running:
-      return_type: google.spanner.admin.instance.v1.Instance
-      metadata_type: google.spanner.admin.instance.v1.CreateInstanceMetadata
       initial_poll_delay_millis: 20000
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 45000
       total_poll_timeout_millis: 86400000
-  - name: UpdateInstance
-    flattening:
-      groups:
-      - parameters:
-        - instance
-        - field_mask
-    required_fields:
-    - instance
-    - field_mask
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      instance.name: instance
     timeout_millis: 30000
+  - name: UpdateInstance
     long_running:
-      return_type: google.spanner.admin.instance.v1.Instance
-      metadata_type: google.spanner.admin.instance.v1.UpdateInstanceMetadata
       initial_poll_delay_millis: 20000
       poll_delay_multiplier: 1.5
       max_poll_delay_millis: 45000
       total_poll_timeout_millis: 86400000
+    timeout_millis: 30000
   - name: DeleteInstance
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: instance
     timeout_millis: 30000
   - name: SetIamPolicy
-    flattening:
-      groups:
-      - parameters:
-        - resource
-        - policy
-    required_fields:
-    - resource
-    - policy
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      resource: instance
     timeout_millis: 30000
   - name: GetIamPolicy
-    flattening:
-      groups:
-      - parameters:
-        - resource
-    required_fields:
-    - resource
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      resource: instance
     timeout_millis: 30000
   - name: TestIamPermissions
-    flattening:
-      groups:
-      - parameters:
-        - resource
-        - permissions
-    required_fields:
-    - resource
-    - permissions
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      resource: instance
     timeout_millis: 30000
-resource_name_generation:
-- message_name: InstanceConfig
-  field_entity_map:
-    name: instance_config
-- message_name: Instance
-  field_entity_map:
-    name: instance
-    config: instance_config
-- message_name: ListInstanceConfigsRequest
-  field_entity_map:
-    parent: project
-- message_name: GetInstanceConfigRequest
-  field_entity_map:
-    name: instance_config
-- message_name: GetInstanceRequest
-  field_entity_map:
-    name: instance
-- message_name: CreateInstanceRequest
-  field_entity_map:
-    parent: project
-    instance_id: instance
-- message_name: ListInstancesRequest
-  field_entity_map:
-    parent: project
-- message_name: DeleteInstanceRequest
-  field_entity_map:
-    name: instance
diff --git a/third_party/googleapis/google/spanner/admin/instance/v1/spanner_admin_instance_grpc_service_config.json b/third_party/googleapis/google/spanner/admin/instance/v1/spanner_admin_instance_grpc_service_config.json
new file mode 100755
index 000000000..e44367443
--- /dev/null
+++ b/third_party/googleapis/google/spanner/admin/instance/v1/spanner_admin_instance_grpc_service_config.json
@@ -0,0 +1,63 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.spanner.admin.instance.v1.InstanceAdmin",
+          "method": "ListInstanceConfigs"
+        },
+        {
+          "service": "google.spanner.admin.instance.v1.InstanceAdmin",
+          "method": "GetInstanceConfig"
+        },
+        {
+          "service": "google.spanner.admin.instance.v1.InstanceAdmin",
+          "method": "ListInstances"
+        },
+        {
+          "service": "google.spanner.admin.instance.v1.InstanceAdmin",
+          "method": "GetInstance"
+        },
+        {
+          "service": "google.spanner.admin.instance.v1.InstanceAdmin",
+          "method": "DeleteInstance"
+        },
+        {
+          "service": "google.spanner.admin.instance.v1.InstanceAdmin",
+          "method": "GetIamPolicy"
+        }
+      ],
+      "timeout": "3600s",
+      "retryPolicy": {
+        "initialBackoff": "1s",
+        "maxBackoff": "32s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.spanner.admin.instance.v1.InstanceAdmin",
+          "method": "CreateInstance"
+        },
+        {
+          "service": "google.spanner.admin.instance.v1.InstanceAdmin",
+          "method": "UpdateInstance"
+        },
+        {
+          "service": "google.spanner.admin.instance.v1.InstanceAdmin",
+          "method": "SetIamPolicy"
+        },
+        {
+          "service": "google.spanner.admin.instance.v1.InstanceAdmin",
+          "method": "TestIamPermissions"
+        }
+      ],
+      "timeout": "3600s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/spanner/admin/instance/v1/spanner_instance_admin.proto b/third_party/googleapis/google/spanner/admin/instance/v1/spanner_instance_admin.proto
index c6ca85c9c..6a068baca 100644
--- a/third_party/googleapis/google/spanner/admin/instance/v1/spanner_instance_admin.proto
+++ b/third_party/googleapis/google/spanner/admin/instance/v1/spanner_instance_admin.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -17,6 +17,9 @@ syntax = "proto3";
 package google.spanner.admin.instance.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/iam/v1/iam_policy.proto";
 import "google/iam/v1/policy.proto";
 import "google/longrunning/operations.proto";
@@ -53,12 +56,17 @@ option php_namespace = "Google\\Cloud\\Spanner\\Admin\\Instance\\V1";
 // instance resources, fewer resources are available for other
 // databases in that instance, and their performance may suffer.
 service InstanceAdmin {
+  option (google.api.default_host) = "spanner.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/spanner.admin";
+
   // Lists the supported instance configurations for a given project.
-  rpc ListInstanceConfigs(ListInstanceConfigsRequest)
-      returns (ListInstanceConfigsResponse) {
+  rpc ListInstanceConfigs(ListInstanceConfigsRequest) returns (ListInstanceConfigsResponse) {
     option (google.api.http) = {
       get: "/v1/{parent=projects/*}/instanceConfigs"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets information about a particular instance configuration.
@@ -66,6 +74,7 @@ service InstanceAdmin {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/instanceConfigs/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists all instances in the given project.
@@ -73,6 +82,7 @@ service InstanceAdmin {
     option (google.api.http) = {
       get: "/v1/{parent=projects/*}/instances"
     };
+    option (google.api.method_signature) = "parent";
   }
 
   // Gets information about a particular instance.
@@ -80,6 +90,7 @@ service InstanceAdmin {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/instances/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates an instance and begins preparing it to begin serving. The
@@ -116,12 +127,16 @@ service InstanceAdmin {
   // [CreateInstanceMetadata][google.spanner.admin.instance.v1.CreateInstanceMetadata].
   // The [response][google.longrunning.Operation.response] field type is
   // [Instance][google.spanner.admin.instance.v1.Instance], if successful.
-  rpc CreateInstance(CreateInstanceRequest)
-      returns (google.longrunning.Operation) {
+  rpc CreateInstance(CreateInstanceRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v1/{parent=projects/*}/instances"
       body: "*"
     };
+    option (google.api.method_signature) = "parent,instance_id,instance";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.spanner.admin.instance.v1.Instance"
+      metadata_type: "google.spanner.admin.instance.v1.CreateInstanceMetadata"
+    };
   }
 
   // Updates an instance, and begins allocating or releasing resources
@@ -138,9 +153,9 @@ service InstanceAdmin {
   // Until completion of the returned operation:
   //
   //   * Cancelling the operation sets its metadata's
-  //     [cancel_time][google.spanner.admin.instance.v1.UpdateInstanceMetadata.cancel_time],
-  //     and begins restoring resources to their pre-request values. The
-  //     operation is guaranteed to succeed at undoing all resource changes,
+  //     [cancel_time][google.spanner.admin.instance.v1.UpdateInstanceMetadata.cancel_time], and begins
+  //     restoring resources to their pre-request values. The operation
+  //     is guaranteed to succeed at undoing all resource changes,
   //     after which point it terminates with a `CANCELLED` status.
   //   * All other attempts to modify the instance are rejected.
   //   * Reading the instance via the API continues to give the pre-request
@@ -164,12 +179,16 @@ service InstanceAdmin {
   //
   // Authorization requires `spanner.instances.update` permission on
   // resource [name][google.spanner.admin.instance.v1.Instance.name].
-  rpc UpdateInstance(UpdateInstanceRequest)
-      returns (google.longrunning.Operation) {
+  rpc UpdateInstance(UpdateInstanceRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       patch: "/v1/{instance.name=projects/*/instances/*}"
       body: "*"
     };
+    option (google.api.method_signature) = "instance,field_mask";
+    option (google.longrunning.operation_info) = {
+      response_type: "google.spanner.admin.instance.v1.Instance"
+      metadata_type: "google.spanner.admin.instance.v1.UpdateInstanceMetadata"
+    };
   }
 
   // Deletes an instance.
@@ -187,6 +206,7 @@ service InstanceAdmin {
     option (google.api.http) = {
       delete: "/v1/{name=projects/*/instances/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Sets the access control policy on an instance resource. Replaces any
@@ -194,12 +214,12 @@ service InstanceAdmin {
   //
   // Authorization requires `spanner.instances.setIamPolicy` on
   // [resource][google.iam.v1.SetIamPolicyRequest.resource].
-  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest)
-      returns (google.iam.v1.Policy) {
+  rpc SetIamPolicy(google.iam.v1.SetIamPolicyRequest) returns (google.iam.v1.Policy) {
     option (google.api.http) = {
       post: "/v1/{resource=projects/*/instances/*}:setIamPolicy"
       body: "*"
     };
+    option (google.api.method_signature) = "resource,policy";
   }
 
   // Gets the access control policy for an instance resource. Returns an empty
@@ -207,12 +227,12 @@ service InstanceAdmin {
   //
   // Authorization requires `spanner.instances.getIamPolicy` on
   // [resource][google.iam.v1.GetIamPolicyRequest.resource].
-  rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest)
-      returns (google.iam.v1.Policy) {
+  rpc GetIamPolicy(google.iam.v1.GetIamPolicyRequest) returns (google.iam.v1.Policy) {
     option (google.api.http) = {
       post: "/v1/{resource=projects/*/instances/*}:getIamPolicy"
       body: "*"
     };
+    option (google.api.method_signature) = "resource";
   }
 
   // Returns permissions that the caller has on the specified instance resource.
@@ -221,18 +241,71 @@ service InstanceAdmin {
   // result in a NOT_FOUND error if the user has `spanner.instances.list`
   // permission on the containing Google Cloud Project. Otherwise returns an
   // empty set of permissions.
-  rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest)
-      returns (google.iam.v1.TestIamPermissionsResponse) {
+  rpc TestIamPermissions(google.iam.v1.TestIamPermissionsRequest) returns (google.iam.v1.TestIamPermissionsResponse) {
     option (google.api.http) = {
       post: "/v1/{resource=projects/*/instances/*}:testIamPermissions"
       body: "*"
     };
+    option (google.api.method_signature) = "resource,permissions";
   }
 }
 
+message ReplicaInfo {
+  // Indicates the type of replica.  See the [replica types
+  // documentation](https://cloud.google.com/spanner/docs/replication#replica_types)
+  // for more details.
+  enum ReplicaType {
+    // Not specified.
+    TYPE_UNSPECIFIED = 0;
+
+    // Read-write replicas support both reads and writes. These replicas:
+    //
+    // * Maintain a full copy of your data.
+    // * Serve reads.
+    // * Can vote whether to commit a write.
+    // * Participate in leadership election.
+    // * Are eligible to become a leader.
+    READ_WRITE = 1;
+
+    // Read-only replicas only support reads (not writes). Read-only replicas:
+    //
+    // * Maintain a full copy of your data.
+    // * Serve reads.
+    // * Do not participate in voting to commit writes.
+    // * Are not eligible to become a leader.
+    READ_ONLY = 2;
+
+    // Witness replicas don't support reads but do participate in voting to
+    // commit writes. Witness replicas:
+    //
+    // * Do not maintain a full copy of data.
+    // * Do not serve reads.
+    // * Vote whether to commit writes.
+    // * Participate in leader election but are not eligible to become leader.
+    WITNESS = 3;
+  }
+
+  // The location of the serving resources, e.g. "us-central1".
+  string location = 1;
+
+  // The type of replica.
+  ReplicaType type = 2;
+
+  // If true, this location is designated as the default leader location where
+  // leader replicas are placed. See the [region types
+  // documentation](https://cloud.google.com/spanner/docs/instances#region_types)
+  // for more details.
+  bool default_leader_location = 3;
+}
+
 // A possible configuration for a Cloud Spanner instance. Configurations
 // define the geographic placement of nodes and their replication.
 message InstanceConfig {
+  option (google.api.resource) = {
+    type: "spanner.googleapis.com/InstanceConfig"
+    pattern: "projects/{project}/instanceConfigs/{instance_config}"
+  };
+
   // A unique identifier for the instance configuration.  Values
   // are of the form
   // `projects//instanceConfigs/[a-z][-a-z0-9]*`
@@ -240,10 +313,19 @@ message InstanceConfig {
 
   // The name of this instance configuration as it appears in UIs.
   string display_name = 2;
+
+  // The geographic placement of nodes in this instance configuration and their
+  // replication properties.
+  repeated ReplicaInfo replicas = 3;
 }
 
 // An isolated set of Cloud Spanner resources on which databases can be hosted.
 message Instance {
+  option (google.api.resource) = {
+    type: "spanner.googleapis.com/Instance"
+    pattern: "projects/{project}/instances/{instance}"
+  };
+
   // Indicates the current state of the instance.
   enum State {
     // Not specified.
@@ -262,14 +344,16 @@ message Instance {
   // Required. A unique identifier for the instance, which cannot be changed
   // after the instance is created. Values are of the form
   // `projects//instances/[a-z][-a-z0-9]*[a-z0-9]`. The final
-  // segment of the name must be between 6 and 30 characters in length.
+  // segment of the name must be between 2 and 64 characters in length.
   string name = 1;
 
   // Required. The name of the instance's configuration. Values are of the form
   // `projects//instanceConfigs/`. See
   // also [InstanceConfig][google.spanner.admin.instance.v1.InstanceConfig] and
   // [ListInstanceConfigs][google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs].
-  string config = 2;
+  string config = 2 [(google.api.resource_reference) = {
+                       type: "spanner.googleapis.com/InstanceConfig"
+                     }];
 
   // Required. The descriptive name for this instance as it appears in UIs.
   // Must be unique per project and between 4 and 30 characters in length.
@@ -284,10 +368,10 @@ message Instance {
   int32 node_count = 5;
 
   // Output only. The current instance state. For
-  // [CreateInstance][google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance],
-  // the state must be either omitted or set to `CREATING`. For
-  // [UpdateInstance][google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance],
-  // the state must be either omitted or set to `READY`.
+  // [CreateInstance][google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance], the state must be
+  // either omitted or set to `CREATING`. For
+  // [UpdateInstance][google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance], the state must be
+  // either omitted or set to `READY`.
   State state = 6;
 
   // Cloud Labels are a flexible and lightweight mechanism for organizing cloud
@@ -312,15 +396,22 @@ message Instance {
   // as the string:  name + "_" + value  would prove problematic if we were to
   // allow "_" in a future release.
   map labels = 7;
+
+  // Deprecated. This field is not populated.
+  repeated string endpoint_uris = 8;
 }
 
-// The request for
-// [ListInstanceConfigs][google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs].
+// The request for [ListInstanceConfigs][google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs].
 message ListInstanceConfigsRequest {
   // Required. The name of the project for which a list of supported instance
   // configurations is requested. Values are of the form
   // `projects/`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
   // Number of instance configurations to be returned in the response. If 0 or
   // less, defaults to the server's maximum allowed page size.
@@ -328,20 +419,18 @@ message ListInstanceConfigsRequest {
 
   // If non-empty, `page_token` should contain a
   // [next_page_token][google.spanner.admin.instance.v1.ListInstanceConfigsResponse.next_page_token]
-  // from a previous
-  // [ListInstanceConfigsResponse][google.spanner.admin.instance.v1.ListInstanceConfigsResponse].
+  // from a previous [ListInstanceConfigsResponse][google.spanner.admin.instance.v1.ListInstanceConfigsResponse].
   string page_token = 3;
 }
 
-// The response for
-// [ListInstanceConfigs][google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs].
+// The response for [ListInstanceConfigs][google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs].
 message ListInstanceConfigsResponse {
   // The list of requested instance configurations.
   repeated InstanceConfig instance_configs = 1;
 
   // `next_page_token` can be sent in a subsequent
-  // [ListInstanceConfigs][google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs]
-  // call to fetch more of the matching instance configurations.
+  // [ListInstanceConfigs][google.spanner.admin.instance.v1.InstanceAdmin.ListInstanceConfigs] call to
+  // fetch more of the matching instance configurations.
   string next_page_token = 2;
 }
 
@@ -350,49 +439,70 @@ message ListInstanceConfigsResponse {
 message GetInstanceConfigRequest {
   // Required. The name of the requested instance configuration. Values are of
   // the form `projects//instanceConfigs/`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/InstanceConfig"
+    }
+  ];
 }
 
-// The request for
-// [GetInstance][google.spanner.admin.instance.v1.InstanceAdmin.GetInstance].
+// The request for [GetInstance][google.spanner.admin.instance.v1.InstanceAdmin.GetInstance].
 message GetInstanceRequest {
   // Required. The name of the requested instance. Values are of the form
   // `projects//instances/`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Instance"
+    }
+  ];
+
+  // If field_mask is present, specifies the subset of [Instance][google.spanner.admin.instance.v1.Instance] fields that
+  // should be returned.
+  // If absent, all [Instance][google.spanner.admin.instance.v1.Instance] fields are returned.
+  google.protobuf.FieldMask field_mask = 2;
 }
 
-// The request for
-// [CreateInstance][google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance].
+// The request for [CreateInstance][google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance].
 message CreateInstanceRequest {
   // Required. The name of the project in which to create the instance. Values
   // are of the form `projects/`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
   // Required. The ID of the instance to create.  Valid identifiers are of the
-  // form `[a-z][-a-z0-9]*[a-z0-9]` and must be between 6 and 30 characters in
+  // form `[a-z][-a-z0-9]*[a-z0-9]` and must be between 2 and 64 characters in
   // length.
-  string instance_id = 2;
+  string instance_id = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Required. The instance to create.  The name may be omitted, but if
   // specified must be `/instances/`.
-  Instance instance = 3;
+  Instance instance = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
-// The request for
-// [ListInstances][google.spanner.admin.instance.v1.InstanceAdmin.ListInstances].
+// The request for [ListInstances][google.spanner.admin.instance.v1.InstanceAdmin.ListInstances].
 message ListInstancesRequest {
   // Required. The name of the project for which a list of instances is
   // requested. Values are of the form `projects/`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
+  ];
 
   // Number of instances to be returned in the response. If 0 or less, defaults
   // to the server's maximum allowed page size.
   int32 page_size = 2;
 
   // If non-empty, `page_token` should contain a
-  // [next_page_token][google.spanner.admin.instance.v1.ListInstancesResponse.next_page_token]
-  // from a previous
-  // [ListInstancesResponse][google.spanner.admin.instance.v1.ListInstancesResponse].
+  // [next_page_token][google.spanner.admin.instance.v1.ListInstancesResponse.next_page_token] from a
+  // previous [ListInstancesResponse][google.spanner.admin.instance.v1.ListInstancesResponse].
   string page_token = 3;
 
   // An expression for filtering the results of the request. Filter rules are
@@ -417,42 +527,40 @@ message ListInstancesRequest {
   string filter = 4;
 }
 
-// The response for
-// [ListInstances][google.spanner.admin.instance.v1.InstanceAdmin.ListInstances].
+// The response for [ListInstances][google.spanner.admin.instance.v1.InstanceAdmin.ListInstances].
 message ListInstancesResponse {
   // The list of requested instances.
   repeated Instance instances = 1;
 
   // `next_page_token` can be sent in a subsequent
-  // [ListInstances][google.spanner.admin.instance.v1.InstanceAdmin.ListInstances]
-  // call to fetch more of the matching instances.
+  // [ListInstances][google.spanner.admin.instance.v1.InstanceAdmin.ListInstances] call to fetch more
+  // of the matching instances.
   string next_page_token = 2;
 }
 
-// The request for
-// [UpdateInstance][google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance].
+// The request for [UpdateInstance][google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance].
 message UpdateInstanceRequest {
   // Required. The instance to update, which must always include the instance
-  // name.  Otherwise, only fields mentioned in
-  // [][google.spanner.admin.instance.v1.UpdateInstanceRequest.field_mask] need
-  // be included.
-  Instance instance = 1;
-
-  // Required. A mask specifying which fields in
-  // [][google.spanner.admin.instance.v1.UpdateInstanceRequest.instance] should
-  // be updated. The field mask must always be specified; this prevents any
-  // future fields in
-  // [][google.spanner.admin.instance.v1.Instance] from being erased
-  // accidentally by clients that do not know about them.
-  google.protobuf.FieldMask field_mask = 2;
+  // name.  Otherwise, only fields mentioned in [field_mask][google.spanner.admin.instance.v1.UpdateInstanceRequest.field_mask] need be included.
+  Instance instance = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. A mask specifying which fields in [Instance][google.spanner.admin.instance.v1.Instance] should be updated.
+  // The field mask must always be specified; this prevents any future fields in
+  // [Instance][google.spanner.admin.instance.v1.Instance] from being erased accidentally by clients that do not know
+  // about them.
+  google.protobuf.FieldMask field_mask = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
-// The request for
-// [DeleteInstance][google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstance].
+// The request for [DeleteInstance][google.spanner.admin.instance.v1.InstanceAdmin.DeleteInstance].
 message DeleteInstanceRequest {
   // Required. The name of the instance to be deleted. Values are of the form
   // `projects//instances/`
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Instance"
+    }
+  ];
 }
 
 // Metadata type for the operation returned by
@@ -462,8 +570,8 @@ message CreateInstanceMetadata {
   Instance instance = 1;
 
   // The time at which the
-  // [CreateInstance][google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance]
-  // request was received.
+  // [CreateInstance][google.spanner.admin.instance.v1.InstanceAdmin.CreateInstance] request was
+  // received.
   google.protobuf.Timestamp start_time = 2;
 
   // The time at which this operation was cancelled. If set, this operation is
@@ -481,8 +589,7 @@ message UpdateInstanceMetadata {
   // The desired end state of the update.
   Instance instance = 1;
 
-  // The time at which
-  // [UpdateInstance][google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance]
+  // The time at which [UpdateInstance][google.spanner.admin.instance.v1.InstanceAdmin.UpdateInstance]
   // request was received.
   google.protobuf.Timestamp start_time = 2;
 
diff --git a/third_party/googleapis/google/spanner/artman_spanner.legacy.yaml b/third_party/googleapis/google/spanner/artman_spanner.legacy.yaml
new file mode 100644
index 000000000..77a976066
--- /dev/null
+++ b/third_party/googleapis/google/spanner/artman_spanner.legacy.yaml
@@ -0,0 +1,20 @@
+common:
+  api_name: spanner
+  api_version: v1
+  organization_name: google-cloud
+  service_yaml: v1/spanner.yaml
+  gapic_yaml: v1/spanner_gapic.legacy.yaml
+  proto_package: google.spanner.v1
+  src_proto_paths:
+  - v1
+  proto_deps:
+  - name: google-common-protos
+artifacts:
+- name: php_gapic
+  type: GAPIC
+  language: PHP
+  release_level: GA
+- name: ruby_gapic
+  type: GAPIC
+  language: RUBY
+  release_level: GA
diff --git a/third_party/googleapis/google/spanner/artman_spanner.yaml b/third_party/googleapis/google/spanner/artman_spanner.yaml
index c5c417530..5b90a1257 100644
--- a/third_party/googleapis/google/spanner/artman_spanner.yaml
+++ b/third_party/googleapis/google/spanner/artman_spanner.yaml
@@ -2,8 +2,9 @@ common:
   api_name: spanner
   api_version: v1
   organization_name: google-cloud
-  service_yaml: spanner.yaml
+  service_yaml: v1/spanner.yaml
   gapic_yaml: v1/spanner_gapic.yaml
+  proto_package: google.spanner.v1
   src_proto_paths:
   - v1
   proto_deps:
@@ -17,14 +18,6 @@ artifacts:
   type: GAPIC
   language: PYTHON
   release_level: GA
-- name: php_gapic
-  type: GAPIC
-  language: PHP
-  release_level: GA
-- name: ruby_gapic
-  type: GAPIC
-  language: RUBY
-  release_level: GA
 - name: go_gapic
   type: GAPIC
   language: GO
diff --git a/third_party/googleapis/google/spanner/v1/BUILD.bazel b/third_party/googleapis/google/spanner/v1/BUILD.bazel
index dee071b7a..ad2819e47 100644
--- a/third_party/googleapis/google/spanner/v1/BUILD.bazel
+++ b/third_party/googleapis/google/spanner/v1/BUILD.bazel
@@ -1,9 +1,12 @@
+# This file was automatically generated by BuildFileGenerator
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
 ##############################################################################
 # Common
 ##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
 load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
 
 proto_library(
@@ -19,6 +22,9 @@ proto_library(
     ],
     deps = [
         "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
         "//google/rpc:status_proto",
         "@com_google_protobuf//:duration_proto",
         "@com_google_protobuf//:empty_proto",
@@ -29,7 +35,10 @@ proto_library(
 
 proto_library_with_info(
     name = "spanner_proto_with_info",
-    deps = [":spanner_proto"],
+    deps = [
+        ":spanner_proto",
+        "//google/cloud:common_resources_proto",
+    ],
 )
 
 ##############################################################################
@@ -37,18 +46,13 @@ proto_library_with_info(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
-    "java_grpc_library",
-    "java_gapic_library",
     "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
     "java_proto_library",
-    "java_resource_name_proto_library",
-    "java_test",
 )
 
-_JAVA_GRPC_DEPS = [
-    "@com_google_api_grpc_proto_google_common_protos//jar",
-]
-
 java_proto_library(
     name = "spanner_java_proto",
     deps = [":spanner_proto"],
@@ -57,51 +61,40 @@ java_proto_library(
 java_grpc_library(
     name = "spanner_java_grpc",
     srcs = [":spanner_proto"],
-    deps = [":spanner_java_proto"] + _JAVA_GRPC_DEPS,
-)
-
-java_resource_name_proto_library(
-    name = "spanner_resource_name_java_proto",
-    gapic_yaml = "spanner_gapic.yaml",
-    deps = [":spanner_proto"],
+    deps = [":spanner_java_proto"],
 )
 
 java_gapic_library(
     name = "spanner_java_gapic",
     src = ":spanner_proto_with_info",
     gapic_yaml = "spanner_gapic.yaml",
-    service_yaml = "//google/spanner:spanner.yaml",
-    test_deps = [":spanner_java_grpc"],
+    package = "google.spanner.v1",
+    service_yaml = "spanner.yaml",
+    test_deps = [
+        ":spanner_java_grpc",
+    ],
     deps = [
         ":spanner_java_proto",
-        ":spanner_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
+    ],
 )
 
-[java_test(
-    name = test_name,
-    test_class = test_name,
-    runtime_deps = [
-        ":spanner_java_gapic_test",
+java_gapic_test(
+    name = "spanner_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.spanner.v1.SpannerClientTest",
     ],
-) for test_name in [
-    "com.google.cloud.spanner.v1.SpannerClientTest",
-]]
+    runtime_deps = [":spanner_java_gapic_test"],
+)
 
-# Opensource Packages
+# Open Source Packages
 java_gapic_assembly_gradle_pkg(
     name = "google-cloud-spanner-v1-java",
-    client_deps = [":spanner_java_gapic"],
-    client_group = "com.google.cloud",
-    client_test_deps = [":spanner_java_gapic_test"],
-    grpc_deps = [":spanner_java_grpc"],
-    grpc_group = "com.google.api.grpc",
-    proto_deps = [
+    deps = [
+        ":spanner_java_gapic",
+        ":spanner_java_grpc",
         ":spanner_java_proto",
         ":spanner_proto",
-        ":spanner_resource_name_java_proto",
-    ] + _JAVA_GRPC_DEPS,
-    version = "0.0.0-SNAPSHOT",
+    ],
 )
 
 ##############################################################################
@@ -109,10 +102,10 @@ java_gapic_assembly_gradle_pkg(
 ##############################################################################
 load(
     "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
     "go_proto_library",
     "go_test",
-    "go_gapic_library",
-    "go_gapic_assembly_pkg",
 )
 
 go_proto_library(
@@ -128,11 +121,14 @@ go_proto_library(
 
 go_gapic_library(
     name = "spanner_go_gapic",
-    src = ":spanner_proto_with_info",
-    gapic_yaml = "spanner_gapic.yaml",
-    importpath = "cloud.google.com/go/spanner/apiv1",
-    service_yaml = "//google/spanner:spanner.yaml",
-    deps = [":spanner_go_proto"],
+    srcs = [":spanner_proto_with_info"],
+    grpc_service_config = "spanner_grpc_service_config.json",
+    importpath = "cloud.google.com/go/spanner/apiv1;spanner",
+    service_yaml = "spanner.yaml",
+    deps = [
+        ":spanner_go_proto",
+        "@io_bazel_rules_go//proto/wkt:duration_go_proto",
+    ],
 )
 
 go_test(
@@ -142,13 +138,252 @@ go_test(
     importpath = "cloud.google.com/go/spanner/apiv1",
 )
 
-# Opensource Packages
+# Open Source Packages
 go_gapic_assembly_pkg(
     name = "gapi-cloud-spanner-v1-go",
     deps = [
         ":spanner_go_gapic",
-        ":spanner_go_gapic_srcjar-smoke-test.srcjar",
         ":spanner_go_gapic_srcjar-test.srcjar",
         ":spanner_go_proto",
     ],
 )
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "spanner_moved_proto",
+    srcs = [":spanner_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/rpc:status_proto",
+        "@com_google_protobuf//:duration_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:struct_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "spanner_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":spanner_moved_proto"],
+)
+
+py_grpc_library(
+    name = "spanner_py_grpc",
+    srcs = [":spanner_moved_proto"],
+    deps = [":spanner_py_proto"],
+)
+
+py_gapic_library(
+    name = "spanner_py_gapic",
+    src = ":spanner_proto_with_info",
+    gapic_yaml = "spanner_gapic.yaml",
+    package = "google.spanner.v1",
+    service_yaml = "spanner.yaml",
+    deps = [
+        ":spanner_py_grpc",
+        ":spanner_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "spanner-v1-py",
+    deps = [
+        ":spanner_py_gapic",
+        ":spanner_py_grpc",
+        ":spanner_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "spanner_php_proto",
+    deps = [":spanner_proto"],
+)
+
+php_grpc_library(
+    name = "spanner_php_grpc",
+    srcs = [":spanner_proto"],
+    deps = [":spanner_php_proto"],
+)
+
+php_gapic_library(
+    name = "spanner_php_gapic",
+    src = ":spanner_proto_with_info",
+    gapic_yaml = "spanner_gapic.yaml",
+    package = "google.spanner.v1",
+    service_yaml = "spanner.yaml",
+    deps = [
+        ":spanner_php_grpc",
+        ":spanner_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-spanner-v1-php",
+    deps = [
+        ":spanner_php_gapic",
+        ":spanner_php_grpc",
+        ":spanner_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "spanner_nodejs_gapic",
+    src = ":spanner_proto_with_info",
+    gapic_yaml = "spanner_gapic.yaml",
+    package = "google.spanner.v1",
+    service_yaml = "spanner.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "spanner-v1-nodejs",
+    deps = [
+        ":spanner_nodejs_gapic",
+        ":spanner_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "spanner_ruby_proto",
+    deps = [":spanner_proto"],
+)
+
+ruby_grpc_library(
+    name = "spanner_ruby_grpc",
+    srcs = [":spanner_proto"],
+    deps = [":spanner_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "spanner_ruby_gapic",
+    src = ":spanner_proto_with_info",
+    gapic_yaml = "spanner_gapic.yaml",
+    package = "google.spanner.v1",
+    service_yaml = "spanner.yaml",
+    deps = [
+        ":spanner_ruby_grpc",
+        ":spanner_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-spanner-v1-ruby",
+    deps = [
+        ":spanner_ruby_gapic",
+        ":spanner_ruby_grpc",
+        ":spanner_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "spanner_csharp_proto",
+    deps = [":spanner_proto"],
+)
+
+csharp_grpc_library(
+    name = "spanner_csharp_grpc",
+    srcs = [":spanner_proto"],
+    deps = [":spanner_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "spanner_csharp_gapic",
+    src = ":spanner_proto_with_info",
+    gapic_yaml = "spanner_gapic.yaml",
+    package = "google.spanner.v1",
+    service_yaml = "spanner.yaml",
+    deps = [
+        ":spanner_csharp_grpc",
+        ":spanner_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-spanner-v1-csharp",
+    deps = [
+        ":spanner_csharp_gapic",
+        ":spanner_csharp_grpc",
+        ":spanner_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "cc_grpc_library",
+    "cc_proto_library")
+
+cc_proto_library(
+    name = "spanner_cc_proto",
+    deps = [":spanner_proto"],
+)
+
+cc_grpc_library(
+    name = "spanner_cc_grpc",
+    srcs = [":spanner_proto"],
+    grpc_only = True,
+    deps = [":spanner_cc_proto"],
+)
diff --git a/third_party/googleapis/google/spanner/v1/keys.proto b/third_party/googleapis/google/spanner/v1/keys.proto
index 1ae957493..d129255c4 100644
--- a/third_party/googleapis/google/spanner/v1/keys.proto
+++ b/third_party/googleapis/google/spanner/v1/keys.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -16,8 +16,8 @@ syntax = "proto3";
 
 package google.spanner.v1;
 
-import "google/api/annotations.proto";
 import "google/protobuf/struct.proto";
+import "google/api/annotations.proto";
 
 option csharp_namespace = "Google.Cloud.Spanner.V1";
 option go_package = "google.golang.org/genproto/googleapis/spanner/v1;spanner";
@@ -152,8 +152,8 @@ message KeySet {
   // encoded as described [here][google.spanner.v1.TypeCode].
   repeated google.protobuf.ListValue keys = 1;
 
-  // A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more
-  // information about key range specifications.
+  // A list of key ranges. See [KeyRange][google.spanner.v1.KeyRange] for more information about
+  // key range specifications.
   repeated KeyRange ranges = 2;
 
   // For convenience `all` can be set to `true` to indicate that this
diff --git a/third_party/googleapis/google/spanner/v1/mutation.proto b/third_party/googleapis/google/spanner/v1/mutation.proto
index 901e6cfe0..2c675830f 100644
--- a/third_party/googleapis/google/spanner/v1/mutation.proto
+++ b/third_party/googleapis/google/spanner/v1/mutation.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -16,9 +16,9 @@ syntax = "proto3";
 
 package google.spanner.v1;
 
-import "google/api/annotations.proto";
 import "google/protobuf/struct.proto";
 import "google/spanner/v1/keys.proto";
+import "google/api/annotations.proto";
 
 option csharp_namespace = "Google.Cloud.Spanner.V1";
 option go_package = "google.golang.org/genproto/googleapis/spanner/v1;spanner";
@@ -31,16 +31,13 @@ option php_namespace = "Google\\Cloud\\Spanner\\V1";
 // applied to a Cloud Spanner database by sending them in a
 // [Commit][google.spanner.v1.Spanner.Commit] call.
 message Mutation {
-  // Arguments to [insert][google.spanner.v1.Mutation.insert],
-  // [update][google.spanner.v1.Mutation.update],
-  // [insert_or_update][google.spanner.v1.Mutation.insert_or_update], and
+  // Arguments to [insert][google.spanner.v1.Mutation.insert], [update][google.spanner.v1.Mutation.update], [insert_or_update][google.spanner.v1.Mutation.insert_or_update], and
   // [replace][google.spanner.v1.Mutation.replace] operations.
   message Write {
     // Required. The table whose rows will be written.
     string table = 1;
 
-    // The names of the columns in
-    // [table][google.spanner.v1.Mutation.Write.table] to be written.
+    // The names of the columns in [table][google.spanner.v1.Mutation.Write.table] to be written.
     //
     // The list of columns must contain enough columns to allow
     // Cloud Spanner to derive values for all primary key columns in the
@@ -50,13 +47,11 @@ message Mutation {
     // The values to be written. `values` can contain more than one
     // list of values. If it does, then multiple rows are written, one
     // for each entry in `values`. Each list in `values` must have
-    // exactly as many entries as there are entries in
-    // [columns][google.spanner.v1.Mutation.Write.columns] above. Sending
-    // multiple lists is equivalent to sending multiple `Mutation`s, each
-    // containing one `values` entry and repeating
-    // [table][google.spanner.v1.Mutation.Write.table] and
-    // [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in
-    // each list are encoded as described [here][google.spanner.v1.TypeCode].
+    // exactly as many entries as there are entries in [columns][google.spanner.v1.Mutation.Write.columns]
+    // above. Sending multiple lists is equivalent to sending multiple
+    // `Mutation`s, each containing one `values` entry and repeating
+    // [table][google.spanner.v1.Mutation.Write.table] and [columns][google.spanner.v1.Mutation.Write.columns]. Individual values in each list are
+    // encoded as described [here][google.spanner.v1.TypeCode].
     repeated google.protobuf.ListValue values = 3;
   }
 
@@ -65,10 +60,12 @@ message Mutation {
     // Required. The table whose rows will be deleted.
     string table = 1;
 
-    // Required. The primary keys of the rows within
-    // [table][google.spanner.v1.Mutation.Delete.table] to delete. Delete is
-    // idempotent. The transaction will succeed even if some or all rows do not
-    // exist.
+    // Required. The primary keys of the rows within [table][google.spanner.v1.Mutation.Delete.table] to delete.  The
+    // primary keys must be specified in the order in which they appear in the
+    // `PRIMARY KEY()` clause of the table's equivalent DDL statement (the DDL
+    // statement used to create the table).
+    // Delete is idempotent. The transaction will succeed even if some or all
+    // rows do not exist.
     KeySet key_set = 2;
   }
 
@@ -82,16 +79,24 @@ message Mutation {
     // already exist, the transaction fails with error `NOT_FOUND`.
     Write update = 2;
 
-    // Like [insert][google.spanner.v1.Mutation.insert], except that if the row
-    // already exists, then its column values are overwritten with the ones
-    // provided. Any column values not explicitly written are preserved.
+    // Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, then
+    // its column values are overwritten with the ones provided. Any
+    // column values not explicitly written are preserved.
+    //
+    // When using [insert_or_update][google.spanner.v1.Mutation.insert_or_update], just as when using [insert][google.spanner.v1.Mutation.insert], all `NOT
+    // NULL` columns in the table must be given a value. This holds true
+    // even when the row already exists and will therefore actually be updated.
     Write insert_or_update = 3;
 
-    // Like [insert][google.spanner.v1.Mutation.insert], except that if the row
-    // already exists, it is deleted, and the column values provided are
-    // inserted instead. Unlike
-    // [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this
-    // means any values not explicitly written become `NULL`.
+    // Like [insert][google.spanner.v1.Mutation.insert], except that if the row already exists, it is
+    // deleted, and the column values provided are inserted
+    // instead. Unlike [insert_or_update][google.spanner.v1.Mutation.insert_or_update], this means any values not
+    // explicitly written become `NULL`.
+    //
+    // In an interleaved table, if you create the child table with the
+    // `ON DELETE CASCADE` annotation, then replacing a parent row
+    // also deletes the child rows. Otherwise, you must delete the
+    // child rows before you replace the parent row.
     Write replace = 4;
 
     // Delete rows from a table. Succeeds whether or not the named
diff --git a/third_party/googleapis/google/spanner/v1/query_plan.proto b/third_party/googleapis/google/spanner/v1/query_plan.proto
index 3f3fe6733..6ad13a77b 100644
--- a/third_party/googleapis/google/spanner/v1/query_plan.proto
+++ b/third_party/googleapis/google/spanner/v1/query_plan.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -16,8 +16,8 @@ syntax = "proto3";
 
 package google.spanner.v1;
 
-import "google/api/annotations.proto";
 import "google/protobuf/struct.proto";
+import "google/api/annotations.proto";
 
 option csharp_namespace = "Google.Cloud.Spanner.V1";
 option go_package = "google.golang.org/genproto/googleapis/spanner/v1;spanner";
@@ -26,8 +26,7 @@ option java_outer_classname = "QueryPlanProto";
 option java_package = "com.google.spanner.v1";
 option php_namespace = "Google\\Cloud\\Spanner\\V1";
 
-// Node information for nodes appearing in a
-// [QueryPlan.plan_nodes][google.spanner.v1.QueryPlan.plan_nodes].
+// Node information for nodes appearing in a [QueryPlan.plan_nodes][google.spanner.v1.QueryPlan.plan_nodes].
 message PlanNode {
   // Metadata associated with a parent-child relationship appearing in a
   // [PlanNode][google.spanner.v1.PlanNode].
@@ -41,14 +40,14 @@ message PlanNode {
     // with the output variable.
     string type = 2;
 
-    // Only present if the child node is
-    // [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] and corresponds to an
-    // output variable of the parent node. The field carries the name of the
-    // output variable. For example, a `TableScan` operator that reads rows from
-    // a table will have child links to the `SCALAR` nodes representing the
-    // output variables created for each column that is read by the operator.
-    // The corresponding `variable` fields will be set to the variable names
-    // assigned to the columns.
+    // Only present if the child node is [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] and corresponds
+    // to an output variable of the parent node. The field carries the name of
+    // the output variable.
+    // For example, a `TableScan` operator that reads rows from a table will
+    // have child links to the `SCALAR` nodes representing the output variables
+    // created for each column that is read by the operator. The corresponding
+    // `variable` fields will be set to the variable names assigned to the
+    // columns.
     string variable = 3;
   }
 
@@ -66,8 +65,8 @@ message PlanNode {
     map subqueries = 2;
   }
 
-  // The kind of [PlanNode][google.spanner.v1.PlanNode]. Distinguishes between
-  // the two different kinds of nodes that can appear in a query plan.
+  // The kind of [PlanNode][google.spanner.v1.PlanNode]. Distinguishes between the two different kinds of
+  // nodes that can appear in a query plan.
   enum Kind {
     // Not specified.
     KIND_UNSPECIFIED = 0;
@@ -84,15 +83,14 @@ message PlanNode {
     SCALAR = 2;
   }
 
-  // The `PlanNode`'s index in [node
-  // list][google.spanner.v1.QueryPlan.plan_nodes].
+  // The `PlanNode`'s index in [node list][google.spanner.v1.QueryPlan.plan_nodes].
   int32 index = 1;
 
   // Used to determine the type of node. May be needed for visualizing
   // different kinds of nodes differently. For example, If the node is a
-  // [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] node, it will have a
-  // condensed representation which can be used to directly embed a description
-  // of the node in its parent.
+  // [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] node, it will have a condensed representation
+  // which can be used to directly embed a description of the node in its
+  // parent.
   Kind kind = 2;
 
   // The display name for the node.
@@ -101,8 +99,7 @@ message PlanNode {
   // List of child node `index`es and their relationship to this parent.
   repeated ChildLink child_links = 4;
 
-  // Condensed representation for
-  // [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
+  // Condensed representation for [SCALAR][google.spanner.v1.PlanNode.Kind.SCALAR] nodes.
   ShortRepresentation short_representation = 5;
 
   // Attributes relevant to the node contained in a group of key-value pairs.
@@ -125,7 +122,7 @@ message PlanNode {
 // Contains an ordered list of nodes appearing in the query plan.
 message QueryPlan {
   // The nodes in the query plan. Plan nodes are returned in pre-order starting
-  // with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id`
-  // corresponds to its index in `plan_nodes`.
+  // with the plan root. Each [PlanNode][google.spanner.v1.PlanNode]'s `id` corresponds to its index in
+  // `plan_nodes`.
   repeated PlanNode plan_nodes = 1;
 }
diff --git a/third_party/googleapis/google/spanner/v1/result_set.proto b/third_party/googleapis/google/spanner/v1/result_set.proto
index 55f612f1b..e24a35aaf 100644
--- a/third_party/googleapis/google/spanner/v1/result_set.proto
+++ b/third_party/googleapis/google/spanner/v1/result_set.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -16,11 +16,11 @@ syntax = "proto3";
 
 package google.spanner.v1;
 
-import "google/api/annotations.proto";
 import "google/protobuf/struct.proto";
 import "google/spanner/v1/query_plan.proto";
 import "google/spanner/v1/transaction.proto";
 import "google/spanner/v1/type.proto";
+import "google/api/annotations.proto";
 
 option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.Spanner.V1";
@@ -37,10 +37,11 @@ message ResultSet {
   ResultSetMetadata metadata = 1;
 
   // Each element in `rows` is a row whose format is defined by
-  // [metadata.row_type][google.spanner.v1.ResultSetMetadata.row_type]. The ith
-  // element in each row matches the ith field in
-  // [metadata.row_type][google.spanner.v1.ResultSetMetadata.row_type]. Elements
-  // are encoded based on type as described [here][google.spanner.v1.TypeCode].
+  // [metadata.row_type][google.spanner.v1.ResultSetMetadata.row_type]. The ith element
+  // in each row matches the ith field in
+  // [metadata.row_type][google.spanner.v1.ResultSetMetadata.row_type]. Elements are
+  // encoded based on type as described
+  // [here][google.spanner.v1.TypeCode].
   repeated google.protobuf.ListValue rows = 2;
 
   // Query plan and execution statistics for the SQL statement that
@@ -48,8 +49,7 @@ message ResultSet {
   // [ExecuteSqlRequest.query_mode][google.spanner.v1.ExecuteSqlRequest.query_mode].
   // DML statements always produce stats containing the number of rows
   // modified, unless executed using the
-  // [ExecuteSqlRequest.QueryMode.PLAN][google.spanner.v1.ExecuteSqlRequest.QueryMode.PLAN]
-  // [ExecuteSqlRequest.query_mode][google.spanner.v1.ExecuteSqlRequest.query_mode].
+  // [ExecuteSqlRequest.QueryMode.PLAN][google.spanner.v1.ExecuteSqlRequest.QueryMode.PLAN] [ExecuteSqlRequest.query_mode][google.spanner.v1.ExecuteSqlRequest.query_mode].
   // Other fields may or may not be populated, based on the
   // [ExecuteSqlRequest.query_mode][google.spanner.v1.ExecuteSqlRequest.query_mode].
   ResultSetStats stats = 3;
@@ -74,10 +74,9 @@ message PartialResultSet {
   //
   // It is possible that the last value in values is "chunked",
   // meaning that the rest of the value is sent in subsequent
-  // `PartialResultSet`(s). This is denoted by the
-  // [chunked_value][google.spanner.v1.PartialResultSet.chunked_value] field.
-  // Two or more chunked values can be merged to form a complete value as
-  // follows:
+  // `PartialResultSet`(s). This is denoted by the [chunked_value][google.spanner.v1.PartialResultSet.chunked_value]
+  // field. Two or more chunked values can be merged to form a
+  // complete value as follows:
   //
   //   * `bool/number/null`: cannot be chunked
   //   * `string`: concatenate the strings
@@ -139,10 +138,9 @@ message PartialResultSet {
   // field value `"World" = "W" + "orl" + "d"`.
   repeated google.protobuf.Value values = 2;
 
-  // If true, then the final value in
-  // [values][google.spanner.v1.PartialResultSet.values] is chunked, and must be
-  // combined with more values from subsequent `PartialResultSet`s to obtain a
-  // complete field value.
+  // If true, then the final value in [values][google.spanner.v1.PartialResultSet.values] is chunked, and must
+  // be combined with more values from subsequent `PartialResultSet`s
+  // to obtain a complete field value.
   bool chunked_value = 3;
 
   // Streaming calls might be interrupted for a variety of reasons, such
@@ -154,14 +152,14 @@ message PartialResultSet {
 
   // Query plan and execution statistics for the statement that produced this
   // streaming result set. These can be requested by setting
-  // [ExecuteSqlRequest.query_mode][google.spanner.v1.ExecuteSqlRequest.query_mode]
-  // and are sent only once with the last response in the stream. This field
-  // will also be present in the last response for DML statements.
+  // [ExecuteSqlRequest.query_mode][google.spanner.v1.ExecuteSqlRequest.query_mode] and are sent
+  // only once with the last response in the stream.
+  // This field will also be present in the last response for DML
+  // statements.
   ResultSetStats stats = 5;
 }
 
-// Metadata about a [ResultSet][google.spanner.v1.ResultSet] or
-// [PartialResultSet][google.spanner.v1.PartialResultSet].
+// Metadata about a [ResultSet][google.spanner.v1.ResultSet] or [PartialResultSet][google.spanner.v1.PartialResultSet].
 message ResultSetMetadata {
   // Indicates the field names and types for the rows in the result
   // set.  For example, a SQL query like `"SELECT UserId, UserName FROM
@@ -178,11 +176,9 @@ message ResultSetMetadata {
   Transaction transaction = 2;
 }
 
-// Additional statistics about a [ResultSet][google.spanner.v1.ResultSet] or
-// [PartialResultSet][google.spanner.v1.PartialResultSet].
+// Additional statistics about a [ResultSet][google.spanner.v1.ResultSet] or [PartialResultSet][google.spanner.v1.PartialResultSet].
 message ResultSetStats {
-  // [QueryPlan][google.spanner.v1.QueryPlan] for the query associated with this
-  // result.
+  // [QueryPlan][google.spanner.v1.QueryPlan] for the query associated with this result.
   QueryPlan query_plan = 1;
 
   // Aggregated statistics from the execution of the query. Only present when
diff --git a/third_party/googleapis/google/spanner/v1/spanner.proto b/third_party/googleapis/google/spanner/v1/spanner.proto
index b2091c92f..0c7da37c7 100644
--- a/third_party/googleapis/google/spanner/v1/spanner.proto
+++ b/third_party/googleapis/google/spanner/v1/spanner.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,13 +11,15 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.spanner.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/struct.proto";
 import "google/protobuf/timestamp.proto";
@@ -34,12 +36,21 @@ option java_multiple_files = true;
 option java_outer_classname = "SpannerProto";
 option java_package = "com.google.spanner.v1";
 option php_namespace = "Google\\Cloud\\Spanner\\V1";
+option (google.api.resource_definition) = {
+  type: "spanner.googleapis.com/Database"
+  pattern: "projects/{project}/instances/{instance}/databases/{database}"
+};
 
 // Cloud Spanner API
 //
 // The Cloud Spanner API can be used to manage sessions and execute
 // transactions on data stored in Cloud Spanner databases.
 service Spanner {
+  option (google.api.default_host) = "spanner.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/spanner.data";
+
   // Creates a new session. A session can be used to perform
   // transactions that read and/or modify data in a Cloud Spanner database.
   // Sessions are meant to be reused for many consecutive
@@ -51,9 +62,9 @@ service Spanner {
   // transaction internally, and count toward the one transaction
   // limit.
   //
-  // Cloud Spanner limits the number of sessions that can exist at any given
-  // time; thus, it is a good idea to delete idle and/or unneeded sessions.
-  // Aside from explicit deletes, Cloud Spanner can delete sessions for which no
+  // Active sessions use additional server resources, so it is a good idea to
+  // delete idle and unneeded sessions.
+  // Aside from explicit deletes, Cloud Spanner may delete sessions for which no
   // operations are sent for more than an hour. If a session is deleted,
   // requests to it return `NOT_FOUND`.
   //
@@ -64,6 +75,19 @@ service Spanner {
       post: "/v1/{database=projects/*/instances/*/databases/*}/sessions"
       body: "*"
     };
+    option (google.api.method_signature) = "database";
+  }
+
+  // Creates multiple new sessions.
+  //
+  // This API can be used to initialize a session cache on the clients.
+  // See https://goo.gl/TgSFN2 for best practices on session cache management.
+  rpc BatchCreateSessions(BatchCreateSessionsRequest) returns (BatchCreateSessionsResponse) {
+    option (google.api.http) = {
+      post: "/v1/{database=projects/*/instances/*/databases/*}/sessions:batchCreate"
+      body: "*"
+    };
+    option (google.api.method_signature) = "database,session_count";
   }
 
   // Gets a session. Returns `NOT_FOUND` if the session does not exist.
@@ -73,6 +97,7 @@ service Spanner {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/instances/*/databases/*/sessions/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists all sessions in a given database.
@@ -80,6 +105,7 @@ service Spanner {
     option (google.api.http) = {
       get: "/v1/{database=projects/*/instances/*/databases/*}/sessions"
     };
+    option (google.api.method_signature) = "database";
   }
 
   // Ends a session, releasing server resources associated with it. This will
@@ -89,6 +115,7 @@ service Spanner {
     option (google.api.http) = {
       delete: "/v1/{name=projects/*/instances/*/databases/*/sessions/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Executes an SQL statement, returning all results in a single reply. This
@@ -98,12 +125,10 @@ service Spanner {
   //
   // Operations inside read-write transactions might return `ABORTED`. If
   // this occurs, the application should restart the transaction from
-  // the beginning. See [Transaction][google.spanner.v1.Transaction] for more
-  // details.
+  // the beginning. See [Transaction][google.spanner.v1.Transaction] for more details.
   //
   // Larger result sets can be fetched in streaming fashion by calling
-  // [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql]
-  // instead.
+  // [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] instead.
   rpc ExecuteSql(ExecuteSqlRequest) returns (ResultSet) {
     option (google.api.http) = {
       post: "/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeSql"
@@ -111,11 +136,11 @@ service Spanner {
     };
   }
 
-  // Like [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql], except returns the
-  // result set as a stream. Unlike
-  // [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql], there is no limit on
-  // the size of the returned result set. However, no individual row in the
-  // result set can exceed 100 MiB, and no column value can exceed 10 MiB.
+  // Like [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql], except returns the result
+  // set as a stream. Unlike [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql], there
+  // is no limit on the size of the returned result set. However, no
+  // individual row in the result set can exceed 100 MiB, and no
+  // column value can exceed 10 MiB.
   rpc ExecuteStreamingSql(ExecuteSqlRequest) returns (stream PartialResultSet) {
     option (google.api.http) = {
       post: "/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeStreamingSql"
@@ -127,21 +152,13 @@ service Spanner {
   // to be run with lower latency than submitting them sequentially with
   // [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql].
   //
-  // Statements are executed in order, sequentially.
-  // [ExecuteBatchDmlResponse][Spanner.ExecuteBatchDmlResponse] will contain a
-  // [ResultSet][google.spanner.v1.ResultSet] for each DML statement that has successfully executed. If a
-  // statement fails, its error status will be returned as part of the
-  // [ExecuteBatchDmlResponse][Spanner.ExecuteBatchDmlResponse]. Execution will
-  // stop at the first failed statement; the remaining statements will not run.
-  //
-  // ExecuteBatchDml is expected to return an OK status with a response even if
-  // there was an error while processing one of the DML statements. Clients must
-  // inspect response.status to determine if there were any errors while
-  // processing the request.
-  //
-  // See more details in
-  // [ExecuteBatchDmlRequest][Spanner.ExecuteBatchDmlRequest] and
-  // [ExecuteBatchDmlResponse][Spanner.ExecuteBatchDmlResponse].
+  // Statements are executed in sequential order. A request can succeed even if
+  // a statement fails. The [ExecuteBatchDmlResponse.status][google.spanner.v1.ExecuteBatchDmlResponse.status] field in the
+  // response provides information about the statement that failed. Clients must
+  // inspect this field to determine whether an error occurred.
+  //
+  // Execution stops after the first failed statement; the remaining statements
+  // are not executed.
   rpc ExecuteBatchDml(ExecuteBatchDmlRequest) returns (ExecuteBatchDmlResponse) {
     option (google.api.http) = {
       post: "/v1/{session=projects/*/instances/*/databases/*/sessions/*}:executeBatchDml"
@@ -151,15 +168,14 @@ service Spanner {
 
   // Reads rows from the database using key lookups and scans, as a
   // simple key/value style alternative to
-  // [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql].  This method cannot be
-  // used to return a result set larger than 10 MiB; if the read matches more
+  // [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql].  This method cannot be used to
+  // return a result set larger than 10 MiB; if the read matches more
   // data than that, the read fails with a `FAILED_PRECONDITION`
   // error.
   //
   // Reads inside read-write transactions might return `ABORTED`. If
   // this occurs, the application should restart the transaction from
-  // the beginning. See [Transaction][google.spanner.v1.Transaction] for more
-  // details.
+  // the beginning. See [Transaction][google.spanner.v1.Transaction] for more details.
   //
   // Larger result sets can be yielded in streaming fashion by calling
   // [StreamingRead][google.spanner.v1.Spanner.StreamingRead] instead.
@@ -170,9 +186,9 @@ service Spanner {
     };
   }
 
-  // Like [Read][google.spanner.v1.Spanner.Read], except returns the result set
-  // as a stream. Unlike [Read][google.spanner.v1.Spanner.Read], there is no
-  // limit on the size of the returned result set. However, no individual row in
+  // Like [Read][google.spanner.v1.Spanner.Read], except returns the result set as a
+  // stream. Unlike [Read][google.spanner.v1.Spanner.Read], there is no limit on the
+  // size of the returned result set. However, no individual row in
   // the result set can exceed 100 MiB, and no column value can exceed
   // 10 MiB.
   rpc StreamingRead(ReadRequest) returns (stream PartialResultSet) {
@@ -183,8 +199,7 @@ service Spanner {
   }
 
   // Begins a new transaction. This step can often be skipped:
-  // [Read][google.spanner.v1.Spanner.Read],
-  // [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] and
+  // [Read][google.spanner.v1.Spanner.Read], [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] and
   // [Commit][google.spanner.v1.Spanner.Commit] can begin a new transaction as a
   // side-effect.
   rpc BeginTransaction(BeginTransactionRequest) returns (Transaction) {
@@ -192,6 +207,7 @@ service Spanner {
       post: "/v1/{session=projects/*/instances/*/databases/*/sessions/*}:beginTransaction"
       body: "*"
     };
+    option (google.api.method_signature) = "session,options";
   }
 
   // Commits a transaction. The request includes the mutations to be
@@ -207,13 +223,14 @@ service Spanner {
       post: "/v1/{session=projects/*/instances/*/databases/*/sessions/*}:commit"
       body: "*"
     };
+    option (google.api.method_signature) = "session,transaction_id,mutations";
+    option (google.api.method_signature) = "session,single_use_transaction,mutations";
   }
 
   // Rolls back a transaction, releasing any locks it holds. It is a good
   // idea to call this for any transaction that includes one or more
-  // [Read][google.spanner.v1.Spanner.Read] or
-  // [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] requests and ultimately
-  // decides not to commit.
+  // [Read][google.spanner.v1.Spanner.Read] or [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] requests and
+  // ultimately decides not to commit.
   //
   // `Rollback` returns `OK` if it successfully aborts the transaction, the
   // transaction was already aborted, or the transaction is not
@@ -223,15 +240,15 @@ service Spanner {
       post: "/v1/{session=projects/*/instances/*/databases/*/sessions/*}:rollback"
       body: "*"
     };
+    option (google.api.method_signature) = "session,transaction_id";
   }
 
   // Creates a set of partition tokens that can be used to execute a query
   // operation in parallel.  Each of the returned partition tokens can be used
-  // by [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] to
-  // specify a subset of the query result to read.  The same session and
-  // read-only transaction must be used by the PartitionQueryRequest used to
-  // create the partition tokens and the ExecuteSqlRequests that use the
-  // partition tokens.
+  // by [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] to specify a subset
+  // of the query result to read.  The same session and read-only transaction
+  // must be used by the PartitionQueryRequest used to create the
+  // partition tokens and the ExecuteSqlRequests that use the partition tokens.
   //
   // Partition tokens become invalid when the session used to create them
   // is deleted, is idle for too long, begins a new transaction, or becomes too
@@ -246,13 +263,12 @@ service Spanner {
 
   // Creates a set of partition tokens that can be used to execute a read
   // operation in parallel.  Each of the returned partition tokens can be used
-  // by [StreamingRead][google.spanner.v1.Spanner.StreamingRead] to specify a
-  // subset of the read result to read.  The same session and read-only
-  // transaction must be used by the PartitionReadRequest used to create the
-  // partition tokens and the ReadRequests that use the partition tokens.  There
-  // are no ordering guarantees on rows returned among the returned partition
-  // tokens, or even within each individual StreamingRead call issued with a
-  // partition_token.
+  // by [StreamingRead][google.spanner.v1.Spanner.StreamingRead] to specify a subset of the read
+  // result to read.  The same session and read-only transaction must be used by
+  // the PartitionReadRequest used to create the partition tokens and the
+  // ReadRequests that use the partition tokens.  There are no ordering
+  // guarantees on rows returned among the returned partition tokens, or even
+  // within each individual StreamingRead call issued with a partition_token.
   //
   // Partition tokens become invalid when the session used to create them
   // is deleted, is idle for too long, begins a new transaction, or becomes too
@@ -269,14 +285,51 @@ service Spanner {
 // The request for [CreateSession][google.spanner.v1.Spanner.CreateSession].
 message CreateSessionRequest {
   // Required. The database in which the new session is created.
-  string database = 1;
+  string database = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Database"
+    }
+  ];
 
   // The session to create.
   Session session = 2;
 }
 
+// The request for [BatchCreateSessions][google.spanner.v1.Spanner.BatchCreateSessions].
+message BatchCreateSessionsRequest {
+  // Required. The database in which the new sessions are created.
+  string database = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Database"
+    }
+  ];
+
+  // Parameters to be applied to each created session.
+  Session session_template = 2;
+
+  // Required. The number of sessions to be created in this batch call.
+  // The API may return fewer than the requested number of sessions. If a
+  // specific number of sessions are desired, the client can make additional
+  // calls to BatchCreateSessions (adjusting
+  // [session_count][google.spanner.v1.BatchCreateSessionsRequest.session_count] as necessary).
+  int32 session_count = 3 [(google.api.field_behavior) = REQUIRED];
+}
+
+// The response for [BatchCreateSessions][google.spanner.v1.Spanner.BatchCreateSessions].
+message BatchCreateSessionsResponse {
+  // The freshly created sessions.
+  repeated Session session = 1;
+}
+
 // A session in the Cloud Spanner API.
 message Session {
+  option (google.api.resource) = {
+    type: "spanner.googleapis.com/Session"
+    pattern: "projects/{project}/instances/{instance}/databases/{database}/sessions/{session}"
+  };
+
   // The name of the session. This is always system-assigned; values provided
   // when creating a session are ignored.
   string name = 1;
@@ -303,21 +356,30 @@ message Session {
 // The request for [GetSession][google.spanner.v1.Spanner.GetSession].
 message GetSessionRequest {
   // Required. The name of the session to retrieve.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Session"
+    }
+  ];
 }
 
 // The request for [ListSessions][google.spanner.v1.Spanner.ListSessions].
 message ListSessionsRequest {
   // Required. The database in which to list sessions.
-  string database = 1;
+  string database = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Database"
+    }
+  ];
 
   // Number of sessions to be returned in the response. If 0 or less, defaults
   // to the server's maximum allowed page size.
   int32 page_size = 2;
 
   // If non-empty, `page_token` should contain a
-  // [next_page_token][google.spanner.v1.ListSessionsResponse.next_page_token]
-  // from a previous
+  // [next_page_token][google.spanner.v1.ListSessionsResponse.next_page_token] from a previous
   // [ListSessionsResponse][google.spanner.v1.ListSessionsResponse].
   string page_token = 3;
 
@@ -340,20 +402,46 @@ message ListSessionsResponse {
   repeated Session sessions = 1;
 
   // `next_page_token` can be sent in a subsequent
-  // [ListSessions][google.spanner.v1.Spanner.ListSessions] call to fetch more
-  // of the matching sessions.
+  // [ListSessions][google.spanner.v1.Spanner.ListSessions] call to fetch more of the matching
+  // sessions.
   string next_page_token = 2;
 }
 
 // The request for [DeleteSession][google.spanner.v1.Spanner.DeleteSession].
 message DeleteSessionRequest {
   // Required. The name of the session to delete.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Session"
+    }
+  ];
 }
 
 // The request for [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] and
 // [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql].
 message ExecuteSqlRequest {
+  // Query optimizer configuration.
+  message QueryOptions {
+    // An option to control the selection of optimizer version.
+    //
+    // This parameter allows individual queries to pick different query
+    // optimizer versions.
+    //
+    // Specifying "latest" as a value instructs Cloud Spanner to use the
+    // latest supported query optimizer version. If not specified, Cloud Spanner
+    // uses optimizer version set at the database level options. Any other
+    // positive integer (from the list of supported optimizer versions)
+    // overrides the default optimizer version for query execution.
+    // The list of supported optimizer versions can be queried from
+    // SPANNER_SYS.SUPPORTED_OPTIMIZER_VERSIONS. Executing a SQL statement
+    // with an invalid optimizer version will fail with a syntax error
+    // (`INVALID_ARGUMENT`) status.
+    //
+    // The `optimizer_version` statement hint has precedence over this setting.
+    string optimizer_version = 1;
+  }
+
   // Mode in which the statement must be processed.
   enum QueryMode {
     // The default mode. Only the statement results are returned.
@@ -369,46 +457,45 @@ message ExecuteSqlRequest {
   }
 
   // Required. The session in which the SQL query should be performed.
-  string session = 1;
+  string session = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Session"
+    }
+  ];
 
-  // The transaction to use. If none is provided, the default is a
-  // temporary read-only transaction with strong concurrency.
-  //
   // The transaction to use.
   //
   // For queries, if none is provided, the default is a temporary read-only
   // transaction with strong concurrency.
   //
-  // Standard DML statements require a ReadWrite transaction. Single-use
-  // transactions are not supported (to avoid replay).  The caller must
-  // either supply an existing transaction ID or begin a new transaction.
+  // Standard DML statements require a read-write transaction. To protect
+  // against replays, single-use transactions are not supported.  The caller
+  // must either supply an existing transaction ID or begin a new transaction.
   //
-  // Partitioned DML requires an existing PartitionedDml transaction ID.
+  // Partitioned DML requires an existing Partitioned DML transaction ID.
   TransactionSelector transaction = 2;
 
   // Required. The SQL string.
-  string sql = 3;
+  string sql = 3 [(google.api.field_behavior) = REQUIRED];
 
-  // The SQL string can contain parameter placeholders. A parameter
-  // placeholder consists of `'@'` followed by the parameter
-  // name. Parameter names consist of any combination of letters,
-  // numbers, and underscores.
+  // Parameter names and values that bind to placeholders in the SQL string.
+  //
+  // A parameter placeholder consists of the `@` character followed by the
+  // parameter name (for example, `@firstName`). Parameter names can contain
+  // letters, numbers, and underscores.
   //
   // Parameters can appear anywhere that a literal value is expected.  The same
   // parameter name can be used more than once, for example:
-  //   `"WHERE id > @msg_id AND id < @msg_id + 100"`
   //
-  // It is an error to execute an SQL statement with unbound parameters.
+  // `"WHERE id > @msg_id AND id < @msg_id + 100"`
   //
-  // Parameter values are specified using `params`, which is a JSON
-  // object whose keys are parameter names, and whose values are the
-  // corresponding parameter values.
+  // It is an error to execute a SQL statement with unbound parameters.
   google.protobuf.Struct params = 4;
 
   // It is not always possible for Cloud Spanner to infer the right SQL type
   // from a JSON value.  For example, values of type `BYTES` and values
-  // of type `STRING` both appear in
-  // [params][google.spanner.v1.ExecuteSqlRequest.params] as JSON strings.
+  // of type `STRING` both appear in [params][google.spanner.v1.ExecuteSqlRequest.params] as JSON strings.
   //
   // In these cases, `param_types` can be used to specify the exact
   // SQL type for some or all of the SQL statement parameters. See the
@@ -418,18 +505,15 @@ message ExecuteSqlRequest {
 
   // If this request is resuming a previously interrupted SQL statement
   // execution, `resume_token` should be copied from the last
-  // [PartialResultSet][google.spanner.v1.PartialResultSet] yielded before the
-  // interruption. Doing this enables the new SQL statement execution to resume
-  // where the last one left off. The rest of the request parameters must
-  // exactly match the request that yielded this token.
+  // [PartialResultSet][google.spanner.v1.PartialResultSet] yielded before the interruption. Doing this
+  // enables the new SQL statement execution to resume where the last one left
+  // off. The rest of the request parameters must exactly match the
+  // request that yielded this token.
   bytes resume_token = 6;
 
   // Used to control the amount of debugging information returned in
-  // [ResultSetStats][google.spanner.v1.ResultSetStats]. If
-  // [partition_token][google.spanner.v1.ExecuteSqlRequest.partition_token] is
-  // set, [query_mode][google.spanner.v1.ExecuteSqlRequest.query_mode] can only
-  // be set to
-  // [QueryMode.NORMAL][google.spanner.v1.ExecuteSqlRequest.QueryMode.NORMAL].
+  // [ResultSetStats][google.spanner.v1.ResultSetStats]. If [partition_token][google.spanner.v1.ExecuteSqlRequest.partition_token] is set, [query_mode][google.spanner.v1.ExecuteSqlRequest.query_mode] can only
+  // be set to [QueryMode.NORMAL][google.spanner.v1.ExecuteSqlRequest.QueryMode.NORMAL].
   QueryMode query_mode = 7;
 
   // If present, results will be restricted to the specified partition
@@ -438,7 +522,7 @@ message ExecuteSqlRequest {
   // PartitionQueryRequest message used to create this partition_token.
   bytes partition_token = 8;
 
-  // A per-transaction sequence number used to identify this request. This
+  // A per-transaction sequence number used to identify this request. This field
   // makes each request idempotent such that if the request is received multiple
   // times, at most one will succeed.
   //
@@ -449,29 +533,30 @@ message ExecuteSqlRequest {
   //
   // Required for DML statements. Ignored for queries.
   int64 seqno = 9;
+
+  // Query optimizer configuration to use for the given query.
+  QueryOptions query_options = 10;
 }
 
-// The request for [ExecuteBatchDml][google.spanner.v1.Spanner.ExecuteBatchDml]
+// The request for [ExecuteBatchDml][google.spanner.v1.Spanner.ExecuteBatchDml].
 message ExecuteBatchDmlRequest {
   // A single DML statement.
   message Statement {
     // Required. The DML string.
     string sql = 1;
 
-    // The DML string can contain parameter placeholders. A parameter
-    // placeholder consists of `'@'` followed by the parameter
-    // name. Parameter names consist of any combination of letters,
-    // numbers, and underscores.
+    // Parameter names and values that bind to placeholders in the DML string.
+    //
+    // A parameter placeholder consists of the `@` character followed by the
+    // parameter name (for example, `@firstName`). Parameter names can contain
+    // letters, numbers, and underscores.
     //
     // Parameters can appear anywhere that a literal value is expected.  The
     // same parameter name can be used more than once, for example:
-    //   `"WHERE id > @msg_id AND id < @msg_id + 100"`
     //
-    // It is an error to execute an SQL statement with unbound parameters.
+    // `"WHERE id > @msg_id AND id < @msg_id + 100"`
     //
-    // Parameter values are specified using `params`, which is a JSON
-    // object whose keys are parameter names, and whose values are the
-    // corresponding parameter values.
+    // It is an error to execute a SQL statement with unbound parameters.
     google.protobuf.Struct params = 2;
 
     // It is not always possible for Cloud Spanner to infer the right SQL type
@@ -486,58 +571,74 @@ message ExecuteBatchDmlRequest {
   }
 
   // Required. The session in which the DML statements should be performed.
-  string session = 1;
+  string session = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Session"
+    }
+  ];
 
-  // The transaction to use. A ReadWrite transaction is required. Single-use
-  // transactions are not supported (to avoid replay).  The caller must either
-  // supply an existing transaction ID or begin a new transaction.
-  TransactionSelector transaction = 2;
+  // Required. The transaction to use. Must be a read-write transaction.
+  //
+  // To protect against replays, single-use transactions are not supported. The
+  // caller must either supply an existing transaction ID or begin a new
+  // transaction.
+  TransactionSelector transaction = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // The list of statements to execute in this batch. Statements are executed
-  // serially, such that the effects of statement i are visible to statement
-  // i+1. Each statement must be a DML statement. Execution will stop at the
-  // first failed statement; the remaining statements will not run.
+  // Required. The list of statements to execute in this batch. Statements are executed
+  // serially, such that the effects of statement `i` are visible to statement
+  // `i+1`. Each statement must be a DML statement. Execution stops at the
+  // first failed statement; the remaining statements are not executed.
   //
-  // REQUIRES: statements_size() > 0.
-  repeated Statement statements = 3;
+  // Callers must provide at least one statement.
+  repeated Statement statements = 3 [(google.api.field_behavior) = REQUIRED];
 
-  // A per-transaction sequence number used to identify this request. This is
-  // used in the same space as the seqno in
-  // [ExecuteSqlRequest][Spanner.ExecuteSqlRequest]. See more details
-  // in [ExecuteSqlRequest][Spanner.ExecuteSqlRequest].
-  int64 seqno = 4;
+  // Required. A per-transaction sequence number used to identify this request. This field
+  // makes each request idempotent such that if the request is received multiple
+  // times, at most one will succeed.
+  //
+  // The sequence number must be monotonically increasing within the
+  // transaction. If a request arrives for the first time with an out-of-order
+  // sequence number, the transaction may be aborted. Replays of previously
+  // handled requests will yield the same response as the first execution.
+  int64 seqno = 4 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The response for [ExecuteBatchDml][google.spanner.v1.Spanner.ExecuteBatchDml]. Contains a list
-// of [ResultSet][google.spanner.v1.ResultSet], one for each DML statement that has successfully executed.
-// If a statement fails, the error is returned as part of the response payload.
-// Clients can determine whether all DML statements have run successfully, or if
-// a statement failed, using one of the following approaches:
+// of [ResultSet][google.spanner.v1.ResultSet] messages, one for each DML statement that has successfully
+// executed, in the same order as the statements in the request. If a statement
+// fails, the status in the response body identifies the cause of the failure.
+//
+// To check for DML statements that failed, use the following approach:
+//
+// 1. Check the status in the response message. The [google.rpc.Code][google.rpc.Code] enum
+//    value `OK` indicates that all statements were executed successfully.
+// 2. If the status was not `OK`, check the number of result sets in the
+//    response. If the response contains `N` [ResultSet][google.spanner.v1.ResultSet] messages, then
+//    statement `N+1` in the request failed.
+//
+// Example 1:
 //
-//   1. Check if 'status' field is OkStatus.
-//   2. Check if result_sets_size() equals the number of statements in
-//      [ExecuteBatchDmlRequest][Spanner.ExecuteBatchDmlRequest].
+// * Request: 5 DML statements, all executed successfully.
+// * Response: 5 [ResultSet][google.spanner.v1.ResultSet] messages, with the status `OK`.
 //
-// Example 1: A request with 5 DML statements, all executed successfully.
-// Result: A response with 5 ResultSets, one for each statement in the same
-// order, and an OK status.
+// Example 2:
 //
-// Example 2: A request with 5 DML statements. The 3rd statement has a syntax
-// error.
-// Result: A response with 2 ResultSets, for the first 2 statements that
-// run successfully, and a syntax error (INVALID_ARGUMENT) status. From
-// result_set_size() client can determine that the 3rd statement has failed.
+// * Request: 5 DML statements. The third statement has a syntax error.
+// * Response: 2 [ResultSet][google.spanner.v1.ResultSet] messages, and a syntax error (`INVALID_ARGUMENT`)
+//   status. The number of [ResultSet][google.spanner.v1.ResultSet] messages indicates that the third
+//   statement failed, and the fourth and fifth statements were not executed.
 message ExecuteBatchDmlResponse {
-  // ResultSets, one for each statement in the request that ran successfully, in
-  // the same order as the statements in the request. Each [ResultSet][google.spanner.v1.ResultSet] will
-  // not contain any rows. The [ResultSetStats][google.spanner.v1.ResultSetStats] in each [ResultSet][google.spanner.v1.ResultSet] will
-  // contain the number of rows modified by the statement.
+  // One [ResultSet][google.spanner.v1.ResultSet] for each statement in the request that ran successfully,
+  // in the same order as the statements in the request. Each [ResultSet][google.spanner.v1.ResultSet] does
+  // not contain any rows. The [ResultSetStats][google.spanner.v1.ResultSetStats] in each [ResultSet][google.spanner.v1.ResultSet] contain
+  // the number of rows modified by the statement.
   //
-  // Only the first ResultSet in the response contains a valid
+  // Only the first [ResultSet][google.spanner.v1.ResultSet] in the response contains valid
   // [ResultSetMetadata][google.spanner.v1.ResultSetMetadata].
   repeated ResultSet result_sets = 1;
 
-  // If all DML statements are executed successfully, status will be OK.
+  // If all DML statements are executed successfully, the status is `OK`.
   // Otherwise, the error status of the first failed statement.
   google.rpc.Status status = 2;
 }
@@ -567,13 +668,18 @@ message PartitionOptions {
 // The request for [PartitionQuery][google.spanner.v1.Spanner.PartitionQuery]
 message PartitionQueryRequest {
   // Required. The session used to create the partitions.
-  string session = 1;
+  string session = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Session"
+    }
+  ];
 
   // Read only snapshot transactions are supported, read/write and single use
   // transactions are not.
   TransactionSelector transaction = 2;
 
-  // The query request to generate partitions for. The request will fail if
+  // Required. The query request to generate partitions for. The request will fail if
   // the query is not root partitionable. The query plan of a root
   // partitionable query has a single distributed union operator. A distributed
   // union operator conceptually divides one or more tables into multiple
@@ -581,31 +687,27 @@ message PartitionQueryRequest {
   // then unions all results.
   //
   // This must not contain DML commands, such as INSERT, UPDATE, or
-  // DELETE. Use
-  // [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] with a
+  // DELETE. Use [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] with a
   // PartitionedDml transaction for large, partition-friendly DML operations.
-  string sql = 3;
+  string sql = 3 [(google.api.field_behavior) = REQUIRED];
 
-  // The SQL query string can contain parameter placeholders. A parameter
-  // placeholder consists of `'@'` followed by the parameter
-  // name. Parameter names consist of any combination of letters,
-  // numbers, and underscores.
+  // Parameter names and values that bind to placeholders in the SQL string.
+  //
+  // A parameter placeholder consists of the `@` character followed by the
+  // parameter name (for example, `@firstName`). Parameter names can contain
+  // letters, numbers, and underscores.
   //
   // Parameters can appear anywhere that a literal value is expected.  The same
   // parameter name can be used more than once, for example:
-  //   `"WHERE id > @msg_id AND id < @msg_id + 100"`
   //
-  // It is an error to execute an SQL query with unbound parameters.
+  // `"WHERE id > @msg_id AND id < @msg_id + 100"`
   //
-  // Parameter values are specified using `params`, which is a JSON
-  // object whose keys are parameter names, and whose values are the
-  // corresponding parameter values.
+  // It is an error to execute a SQL statement with unbound parameters.
   google.protobuf.Struct params = 4;
 
   // It is not always possible for Cloud Spanner to infer the right SQL type
   // from a JSON value.  For example, values of type `BYTES` and values
-  // of type `STRING` both appear in
-  // [params][google.spanner.v1.PartitionQueryRequest.params] as JSON strings.
+  // of type `STRING` both appear in [params][google.spanner.v1.PartitionQueryRequest.params] as JSON strings.
   //
   // In these cases, `param_types` can be used to specify the exact
   // SQL type for some or all of the SQL query parameters. See the
@@ -620,38 +722,37 @@ message PartitionQueryRequest {
 // The request for [PartitionRead][google.spanner.v1.Spanner.PartitionRead]
 message PartitionReadRequest {
   // Required. The session used to create the partitions.
-  string session = 1;
+  string session = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Session"
+    }
+  ];
 
   // Read only snapshot transactions are supported, read/write and single use
   // transactions are not.
   TransactionSelector transaction = 2;
 
   // Required. The name of the table in the database to be read.
-  string table = 3;
-
-  // If non-empty, the name of an index on
-  // [table][google.spanner.v1.PartitionReadRequest.table]. This index is used
-  // instead of the table primary key when interpreting
-  // [key_set][google.spanner.v1.PartitionReadRequest.key_set] and sorting
-  // result rows. See [key_set][google.spanner.v1.PartitionReadRequest.key_set]
-  // for further information.
+  string table = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // If non-empty, the name of an index on [table][google.spanner.v1.PartitionReadRequest.table]. This index is
+  // used instead of the table primary key when interpreting [key_set][google.spanner.v1.PartitionReadRequest.key_set]
+  // and sorting result rows. See [key_set][google.spanner.v1.PartitionReadRequest.key_set] for further information.
   string index = 4;
 
-  // The columns of [table][google.spanner.v1.PartitionReadRequest.table] to be
-  // returned for each row matching this request.
+  // The columns of [table][google.spanner.v1.PartitionReadRequest.table] to be returned for each row matching
+  // this request.
   repeated string columns = 5;
 
   // Required. `key_set` identifies the rows to be yielded. `key_set` names the
-  // primary keys of the rows in
-  // [table][google.spanner.v1.PartitionReadRequest.table] to be yielded, unless
-  // [index][google.spanner.v1.PartitionReadRequest.index] is present. If
-  // [index][google.spanner.v1.PartitionReadRequest.index] is present, then
-  // [key_set][google.spanner.v1.PartitionReadRequest.key_set] instead names
+  // primary keys of the rows in [table][google.spanner.v1.PartitionReadRequest.table] to be yielded, unless [index][google.spanner.v1.PartitionReadRequest.index]
+  // is present. If [index][google.spanner.v1.PartitionReadRequest.index] is present, then [key_set][google.spanner.v1.PartitionReadRequest.key_set] instead names
   // index keys in [index][google.spanner.v1.PartitionReadRequest.index].
   //
   // It is not an error for the `key_set` to name rows that do not
   // exist in the database. Read yields nothing for nonexistent rows.
-  KeySet key_set = 6;
+  KeySet key_set = 6 [(google.api.field_behavior) = REQUIRED];
 
   // Additional options that affect how many partitions are created.
   PartitionOptions partition_options = 9;
@@ -680,44 +781,42 @@ message PartitionResponse {
 // [StreamingRead][google.spanner.v1.Spanner.StreamingRead].
 message ReadRequest {
   // Required. The session in which the read should be performed.
-  string session = 1;
+  string session = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Session"
+    }
+  ];
 
   // The transaction to use. If none is provided, the default is a
   // temporary read-only transaction with strong concurrency.
   TransactionSelector transaction = 2;
 
   // Required. The name of the table in the database to be read.
-  string table = 3;
-
-  // If non-empty, the name of an index on
-  // [table][google.spanner.v1.ReadRequest.table]. This index is used instead of
-  // the table primary key when interpreting
-  // [key_set][google.spanner.v1.ReadRequest.key_set] and sorting result rows.
-  // See [key_set][google.spanner.v1.ReadRequest.key_set] for further
-  // information.
+  string table = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // If non-empty, the name of an index on [table][google.spanner.v1.ReadRequest.table]. This index is
+  // used instead of the table primary key when interpreting [key_set][google.spanner.v1.ReadRequest.key_set]
+  // and sorting result rows. See [key_set][google.spanner.v1.ReadRequest.key_set] for further information.
   string index = 4;
 
-  // The columns of [table][google.spanner.v1.ReadRequest.table] to be returned
-  // for each row matching this request.
-  repeated string columns = 5;
+  // Required. The columns of [table][google.spanner.v1.ReadRequest.table] to be returned for each row matching
+  // this request.
+  repeated string columns = 5 [(google.api.field_behavior) = REQUIRED];
 
   // Required. `key_set` identifies the rows to be yielded. `key_set` names the
-  // primary keys of the rows in [table][google.spanner.v1.ReadRequest.table] to
-  // be yielded, unless [index][google.spanner.v1.ReadRequest.index] is present.
-  // If [index][google.spanner.v1.ReadRequest.index] is present, then
-  // [key_set][google.spanner.v1.ReadRequest.key_set] instead names index keys
-  // in [index][google.spanner.v1.ReadRequest.index].
-  //
-  // If the [partition_token][google.spanner.v1.ReadRequest.partition_token]
-  // field is empty, rows are yielded in table primary key order (if
-  // [index][google.spanner.v1.ReadRequest.index] is empty) or index key order
-  // (if [index][google.spanner.v1.ReadRequest.index] is non-empty).  If the
-  // [partition_token][google.spanner.v1.ReadRequest.partition_token] field is
-  // not empty, rows will be yielded in an unspecified order.
+  // primary keys of the rows in [table][google.spanner.v1.ReadRequest.table] to be yielded, unless [index][google.spanner.v1.ReadRequest.index]
+  // is present. If [index][google.spanner.v1.ReadRequest.index] is present, then [key_set][google.spanner.v1.ReadRequest.key_set] instead names
+  // index keys in [index][google.spanner.v1.ReadRequest.index].
+  //
+  // If the [partition_token][google.spanner.v1.ReadRequest.partition_token] field is empty, rows are yielded
+  // in table primary key order (if [index][google.spanner.v1.ReadRequest.index] is empty) or index key order
+  // (if [index][google.spanner.v1.ReadRequest.index] is non-empty).  If the [partition_token][google.spanner.v1.ReadRequest.partition_token] field is not
+  // empty, rows will be yielded in an unspecified order.
   //
   // It is not an error for the `key_set` to name rows that do not
   // exist in the database. Read yields nothing for nonexistent rows.
-  KeySet key_set = 6;
+  KeySet key_set = 6 [(google.api.field_behavior) = REQUIRED];
 
   // If greater than zero, only the first `limit` rows are yielded. If `limit`
   // is zero, the default is no limit. A limit cannot be specified if
@@ -726,9 +825,9 @@ message ReadRequest {
 
   // If this request is resuming a previously interrupted read,
   // `resume_token` should be copied from the last
-  // [PartialResultSet][google.spanner.v1.PartialResultSet] yielded before the
-  // interruption. Doing this enables the new read to resume where the last read
-  // left off. The rest of the request parameters must exactly match the request
+  // [PartialResultSet][google.spanner.v1.PartialResultSet] yielded before the interruption. Doing this
+  // enables the new read to resume where the last read left off. The
+  // rest of the request parameters must exactly match the request
   // that yielded this token.
   bytes resume_token = 9;
 
@@ -739,20 +838,29 @@ message ReadRequest {
   bytes partition_token = 10;
 }
 
-// The request for
-// [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction].
+// The request for [BeginTransaction][google.spanner.v1.Spanner.BeginTransaction].
 message BeginTransactionRequest {
   // Required. The session in which the transaction runs.
-  string session = 1;
+  string session = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Session"
+    }
+  ];
 
   // Required. Options for the new transaction.
-  TransactionOptions options = 2;
+  TransactionOptions options = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The request for [Commit][google.spanner.v1.Spanner.Commit].
 message CommitRequest {
   // Required. The session in which the transaction to be committed is running.
-  string session = 1;
+  string session = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Session"
+    }
+  ];
 
   // Required. The transaction in which to commit.
   oneof transaction {
@@ -786,8 +894,13 @@ message CommitResponse {
 // The request for [Rollback][google.spanner.v1.Spanner.Rollback].
 message RollbackRequest {
   // Required. The session in which the transaction to roll back is running.
-  string session = 1;
+  string session = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "spanner.googleapis.com/Session"
+    }
+  ];
 
   // Required. The transaction to roll back.
-  bytes transaction_id = 2;
+  bytes transaction_id = 2 [(google.api.field_behavior) = REQUIRED];
 }
diff --git a/third_party/googleapis/google/spanner/spanner.yaml b/third_party/googleapis/google/spanner/v1/spanner.yaml
similarity index 100%
rename from third_party/googleapis/google/spanner/spanner.yaml
rename to third_party/googleapis/google/spanner/v1/spanner.yaml
diff --git a/third_party/googleapis/google/spanner/v1/spanner_gapic.legacy.yaml b/third_party/googleapis/google/spanner/v1/spanner_gapic.legacy.yaml
new file mode 100644
index 000000000..c274a40c2
--- /dev/null
+++ b/third_party/googleapis/google/spanner/v1/spanner_gapic.legacy.yaml
@@ -0,0 +1,309 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.spanner.v1
+    release_level: GA
+  python:
+    package_name: google.cloud.spanner_v1.gapic
+    release_level: GA
+  go:
+    package_name: cloud.google.com/go/spanner/apiv1
+    domain_layer_location: cloud.google.com/go/spanner
+    release_level: GA
+  csharp:
+    package_name: Google.Cloud.Spanner.V1
+    release_level: GA
+  ruby:
+    package_name: Google::Cloud::Spanner::V1
+    release_level: GA
+  php:
+    package_name: Google\Cloud\Spanner\V1
+    release_level: GA
+  nodejs:
+    package_name: spanner.v1
+    domain_layer_location: google-cloud
+    release_level: GA
+interfaces:
+- name: google.spanner.v1.Spanner
+  collections:
+  - name_pattern: projects/{project}/instances/{instance}/databases/{database}
+    entity_name: database
+    language_overrides:
+    - language: csharp
+      common_resource_name: Google.Cloud.Spanner.Common.V1.DatabaseName
+  - name_pattern: projects/{project}/instances/{instance}/databases/{database}/sessions/{session}
+    entity_name: session
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+  - name: non_idempotent
+    retry_codes: []
+  - name: long_running
+    retry_codes:
+    - UNAVAILABLE
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 250
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 32000
+    initial_rpc_timeout_millis: 360000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 360000
+    total_timeout_millis: 3600000
+  - name: streaming
+    initial_retry_delay_millis: 250
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 32000
+    initial_rpc_timeout_millis: 360000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 360000
+    total_timeout_millis: 3600000
+  - name: long_running
+    initial_retry_delay_millis: 250
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 32000
+    initial_rpc_timeout_millis: 3600000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 3600000
+    total_timeout_millis: 3600000
+  methods:
+  - name: CreateSession
+    flattening:
+      groups:
+      - parameters:
+        - database
+    required_fields:
+    - database
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      database: database
+    timeout_millis: 30000
+  - name: BatchCreateSessions
+    flattening:
+      groups:
+      - parameters:
+        - database
+        - session_count
+    required_fields:
+    - database
+    - session_count
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      database: database
+    timeout_millis: 60000
+  - name: GetSession
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: session
+    timeout_millis: 30000
+  - name: ListSessions
+    flattening:
+      groups:
+      - parameters:
+        - database
+    required_fields:
+    - database
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: sessions
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      database: database
+    timeout_millis: 3600000
+  - name: DeleteSession
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: session
+    timeout_millis: 30000
+  - name: ExecuteSql
+    required_fields:
+    - session
+    - sql
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      session: session
+    timeout_millis: 30000
+  - name: ExecuteStreamingSql
+    required_fields:
+    - session
+    - sql
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: streaming
+    field_name_patterns:
+      session: session
+    timeout_millis: 3600000
+  - name: ExecuteBatchDml
+    required_fields:
+    - session
+    - transaction
+    - statements
+    - seqno
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      session: session
+    timeout_millis: 30000
+  - name: Read
+    required_fields:
+    - session
+    - table
+    - columns
+    - key_set
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      session: session
+    timeout_millis: 30000
+  - name: StreamingRead
+    required_fields:
+    - session
+    - table
+    - columns
+    - key_set
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: streaming
+    field_name_patterns:
+      session: session
+    timeout_millis: 3600000
+  - name: BeginTransaction
+    flattening:
+      groups:
+      - parameters:
+        - session
+        - options
+    required_fields:
+    - session
+    - options
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      session: session
+    timeout_millis: 30000
+  - name: Commit
+    flattening:
+      groups:
+      - parameters:
+        - session
+        - transaction_id
+        - mutations
+      - parameters:
+        - session
+        - single_use_transaction
+        - mutations
+    required_fields:
+    - session
+    - mutations
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: long_running
+    retry_params_name: long_running
+    field_name_patterns:
+      session: session
+    timeout_millis: 3600000
+  - name: Rollback
+    flattening:
+      groups:
+      - parameters:
+        - session
+        - transaction_id
+    required_fields:
+    - session
+    - transaction_id
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      session: session
+    timeout_millis: 30000
+  - name: PartitionQuery
+    required_fields:
+    - session
+    - sql
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      session: session
+    timeout_millis: 30000
+  - name: PartitionRead
+    required_fields:
+    - session
+    - table
+    - key_set
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      session: session
+    timeout_millis: 30000
+resource_name_generation:
+- message_name: CreateSessionRequest
+  field_entity_map:
+    database: database
+- message_name: BatchCreateSessionsRequest
+  field_entity_map:
+    database: database
+- message_name: Session
+  field_entity_map:
+    name: session
+- message_name: GetSessionRequest
+  field_entity_map:
+    name: session
+- message_name: DeleteSessionRequest
+  field_entity_map:
+    name: session
+- message_name: ExecuteSqlRequest
+  field_entity_map:
+    session: session
+- message_name: ExecuteBatchDmlRequest
+  field_entity_map:
+    session: session
+- message_name: ReadRequest
+  field_entity_map:
+    session: session
+- message_name: BeginTransactionRequest
+  field_entity_map:
+    session: session
+- message_name: CommitRequest
+  field_entity_map:
+    session: session
+- message_name: RollbackRequest
+  field_entity_map:
+    session: session
+- message_name: PartitionReadRequest
+  field_entity_map:
+    session: session
+- message_name: PartitionQueryRequest
+  field_entity_map:
+    session: session
diff --git a/third_party/googleapis/google/spanner/v1/spanner_gapic.yaml b/third_party/googleapis/google/spanner/v1/spanner_gapic.yaml
index a09c021c6..38a02706a 100644
--- a/third_party/googleapis/google/spanner/v1/spanner_gapic.yaml
+++ b/third_party/googleapis/google/spanner/v1/spanner_gapic.yaml
@@ -1,5 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: com.google.cloud.spanner.v1
@@ -26,14 +26,6 @@ language_settings:
     release_level: GA
 interfaces:
 - name: google.spanner.v1.Spanner
-  collections:
-  - name_pattern: projects/{project}/instances/{instance}/databases/{database}
-    entity_name: database
-    language_overrides:
-    - language: csharp
-      common_resource_name: Google.Cloud.Spanner.Common.V1.DatabaseName
-  - name_pattern: projects/{project}/instances/{instance}/databases/{database}/sessions/{session}
-    entity_name: session
   retry_codes_def:
   - name: idempotent
     retry_codes:
@@ -48,18 +40,18 @@ interfaces:
     initial_retry_delay_millis: 250
     retry_delay_multiplier: 1.3
     max_retry_delay_millis: 32000
-    initial_rpc_timeout_millis: 60000
+    initial_rpc_timeout_millis: 3600000
     rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 60000
-    total_timeout_millis: 600000
+    max_rpc_timeout_millis: 3600000
+    total_timeout_millis: 3600000
   - name: streaming
     initial_retry_delay_millis: 250
     retry_delay_multiplier: 1.3
     max_retry_delay_millis: 32000
-    initial_rpc_timeout_millis: 120000
+    initial_rpc_timeout_millis: 3600000
     rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 120000
-    total_timeout_millis: 1200000
+    max_rpc_timeout_millis: 3600000
+    total_timeout_millis: 3600000
   - name: long_running
     initial_retry_delay_millis: 250
     retry_delay_multiplier: 1.3
@@ -70,222 +62,62 @@ interfaces:
     total_timeout_millis: 3600000
   methods:
   - name: CreateSession
-    flattening:
-      groups:
-      - parameters:
-        - database
-    required_fields:
-    - database
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      database: database
     timeout_millis: 30000
+  - name: BatchCreateSessions
+    retry_codes_name: idempotent
+    retry_params_name: default
+    timeout_millis: 60000
   - name: GetSession
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: session
     timeout_millis: 30000
   - name: ListSessions
-    flattening:
-      groups:
-      - parameters:
-        - database
-    required_fields:
-    - database
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: sessions
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      database: database
     timeout_millis: 3600000
   - name: DeleteSession
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      name: session
     timeout_millis: 30000
   - name: ExecuteSql
-    required_fields:
-    - session
-    - sql
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      session: session
     timeout_millis: 30000
   - name: ExecuteStreamingSql
-    required_fields:
-    - session
-    - sql
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: non_idempotent
     retry_params_name: streaming
-    field_name_patterns:
-      session: session
     timeout_millis: 3600000
   - name: ExecuteBatchDml
-    required_fields:
-    - session
-    - transaction
-    - statements
-    - seqno
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      session: session
     timeout_millis: 30000
   - name: Read
-    required_fields:
-    - session
-    - table
-    - columns
-    - key_set
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      session: session
     timeout_millis: 30000
   - name: StreamingRead
-    required_fields:
-    - session
-    - table
-    - columns
-    - key_set
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: non_idempotent
     retry_params_name: streaming
-    field_name_patterns:
-      session: session
     timeout_millis: 3600000
   - name: BeginTransaction
-    flattening:
-      groups:
-      - parameters:
-        - session
-        - options
-    required_fields:
-    - session
-    - options
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      session: session
     timeout_millis: 30000
   - name: Commit
-    flattening:
-      groups:
-      - parameters:
-        - session
-        - transaction_id
-        - mutations
-      - parameters:
-        - session
-        - single_use_transaction
-        - mutations
-    required_fields:
-    - session
-    - mutations
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: long_running
     retry_params_name: long_running
-    field_name_patterns:
-      session: session
     timeout_millis: 3600000
   - name: Rollback
-    flattening:
-      groups:
-      - parameters:
-        - session
-        - transaction_id
-    required_fields:
-    - session
-    - transaction_id
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      session: session
     timeout_millis: 30000
   - name: PartitionQuery
-    required_fields:
-    - session
-    - sql
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      session: session
     timeout_millis: 30000
   - name: PartitionRead
-    required_fields:
-    - session
-    - table
-    - key_set
     retry_codes_name: idempotent
     retry_params_name: default
-    field_name_patterns:
-      session: session
     timeout_millis: 30000
-resource_name_generation:
-- message_name: CreateSessionRequest
-  field_entity_map:
-    database: database
-- message_name: Session
-  field_entity_map:
-    name: session
-- message_name: GetSessionRequest
-  field_entity_map:
-    name: session
-- message_name: DeleteSessionRequest
-  field_entity_map:
-    name: session
-- message_name: ExecuteSqlRequest
-  field_entity_map:
-    session: session
-- message_name: ExecuteBatchDmlRequest
-  field_entity_map:
-    session: session
-- message_name: ReadRequest
-  field_entity_map:
-    session: session
-- message_name: BeginTransactionRequest
-  field_entity_map:
-    session: session
-- message_name: CommitRequest
-  field_entity_map:
-    session: session
-- message_name: RollbackRequest
-  field_entity_map:
-    session: session
-- message_name: PartitionReadRequest
-  field_entity_map:
-    session: session
-- message_name: PartitionQueryRequest
-  field_entity_map:
-    session: session
diff --git a/third_party/googleapis/google/spanner/v1/spanner_grpc_service_config.json b/third_party/googleapis/google/spanner/v1/spanner_grpc_service_config.json
new file mode 100755
index 000000000..8602c9425
--- /dev/null
+++ b/third_party/googleapis/google/spanner/v1/spanner_grpc_service_config.json
@@ -0,0 +1,95 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "google.spanner.v1.Spanner",
+          "method": "ExecuteStreamingSql"
+        },
+        {
+          "service": "google.spanner.v1.Spanner",
+          "method": "StreamingRead"
+        }
+      ],
+      "timeout": "3600s"
+    },
+    {
+      "name": [
+        {
+          "service": "google.spanner.v1.Spanner",
+          "method": "Commit"
+        }
+      ],
+      "timeout": "3600s",
+      "retryPolicy": {
+        "initialBackoff": "0.250s",
+        "maxBackoff": "32s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "google.spanner.v1.Spanner",
+          "method": "CreateSession"
+        },
+        {
+          "service": "google.spanner.v1.Spanner",
+          "method": "BatchCreateSessions"
+        },
+        {
+          "service": "google.spanner.v1.Spanner",
+          "method": "GetSession"
+        },
+        {
+          "service": "google.spanner.v1.Spanner",
+          "method": "ListSessions"
+        },
+        {
+          "service": "google.spanner.v1.Spanner",
+          "method": "DeleteSession"
+        },
+        {
+          "service": "google.spanner.v1.Spanner",
+          "method": "ExecuteSql"
+        },
+        {
+          "service": "google.spanner.v1.Spanner",
+          "method": "ExecuteBatchDml"
+        },
+        {
+          "service": "google.spanner.v1.Spanner",
+          "method": "Read"
+        },
+        {
+          "service": "google.spanner.v1.Spanner",
+          "method": "BeginTransaction"
+        },
+        {
+          "service": "google.spanner.v1.Spanner",
+          "method": "Rollback"
+        },
+        {
+          "service": "google.spanner.v1.Spanner",
+          "method": "PartitionQuery"
+        },
+        {
+          "service": "google.spanner.v1.Spanner",
+          "method": "PartitionRead"
+        }
+      ],
+      "timeout": "30s",
+      "retryPolicy": {
+        "initialBackoff": "0.250s",
+        "maxBackoff": "32s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE"
+        ]
+      }
+    }
+  ]
+}
diff --git a/third_party/googleapis/google/spanner/v1/transaction.proto b/third_party/googleapis/google/spanner/v1/transaction.proto
index 7253bcbe0..6a429f5d4 100644
--- a/third_party/googleapis/google/spanner/v1/transaction.proto
+++ b/third_party/googleapis/google/spanner/v1/transaction.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -16,9 +16,9 @@ syntax = "proto3";
 
 package google.spanner.v1;
 
-import "google/api/annotations.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
+import "google/api/annotations.proto";
 
 option csharp_namespace = "Google.Cloud.Spanner.V1";
 option go_package = "google.golang.org/genproto/googleapis/spanner/v1;spanner";
@@ -184,8 +184,7 @@ option php_namespace = "Google\\Cloud\\Spanner\\V1";
 // reads should be executed within a transaction or at an exact read
 // timestamp.
 //
-// See
-// [TransactionOptions.ReadOnly.strong][google.spanner.v1.TransactionOptions.ReadOnly.strong].
+// See [TransactionOptions.ReadOnly.strong][google.spanner.v1.TransactionOptions.ReadOnly.strong].
 //
 // ### Exact Staleness
 //
@@ -206,9 +205,7 @@ option php_namespace = "Google\\Cloud\\Spanner\\V1";
 // equivalent boundedly stale concurrency modes. On the other hand,
 // boundedly stale reads usually return fresher results.
 //
-// See
-// [TransactionOptions.ReadOnly.read_timestamp][google.spanner.v1.TransactionOptions.ReadOnly.read_timestamp]
-// and
+// See [TransactionOptions.ReadOnly.read_timestamp][google.spanner.v1.TransactionOptions.ReadOnly.read_timestamp] and
 // [TransactionOptions.ReadOnly.exact_staleness][google.spanner.v1.TransactionOptions.ReadOnly.exact_staleness].
 //
 // ### Bounded Staleness
@@ -238,9 +235,7 @@ option php_namespace = "Google\\Cloud\\Spanner\\V1";
 // which rows will be read, it can only be used with single-use
 // read-only transactions.
 //
-// See
-// [TransactionOptions.ReadOnly.max_staleness][google.spanner.v1.TransactionOptions.ReadOnly.max_staleness]
-// and
+// See [TransactionOptions.ReadOnly.max_staleness][google.spanner.v1.TransactionOptions.ReadOnly.max_staleness] and
 // [TransactionOptions.ReadOnly.min_read_timestamp][google.spanner.v1.TransactionOptions.ReadOnly.min_read_timestamp].
 //
 // ### Old Read Timestamps and Garbage Collection
@@ -312,10 +307,14 @@ option php_namespace = "Google\\Cloud\\Spanner\\V1";
 message TransactionOptions {
   // Message type to initiate a read-write transaction. Currently this
   // transaction type has no options.
-  message ReadWrite {}
+  message ReadWrite {
+
+  }
 
   // Message type to initiate a Partitioned DML transaction.
-  message PartitionedDml {}
+  message PartitionedDml {
+
+  }
 
   // Message type to initiate a read-only transaction.
   message ReadOnly {
@@ -381,8 +380,7 @@ message TransactionOptions {
     }
 
     // If true, the Cloud Spanner-selected read timestamp is included in
-    // the [Transaction][google.spanner.v1.Transaction] message that describes
-    // the transaction.
+    // the [Transaction][google.spanner.v1.Transaction] message that describes the transaction.
     bool return_read_timestamp = 6;
   }
 
@@ -436,8 +434,7 @@ message Transaction {
 // [Read][google.spanner.v1.Spanner.Read] or
 // [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] call runs.
 //
-// See [TransactionOptions][google.spanner.v1.TransactionOptions] for more
-// information about transactions.
+// See [TransactionOptions][google.spanner.v1.TransactionOptions] for more information about transactions.
 message TransactionSelector {
   // If no fields are set, the default is a single use transaction
   // with strong concurrency.
@@ -452,8 +449,7 @@ message TransactionSelector {
 
     // Begin a new transaction and execute this read or SQL query in
     // it. The transaction ID of the new transaction is returned in
-    // [ResultSetMetadata.transaction][google.spanner.v1.ResultSetMetadata.transaction],
-    // which is a [Transaction][google.spanner.v1.Transaction].
+    // [ResultSetMetadata.transaction][google.spanner.v1.ResultSetMetadata.transaction], which is a [Transaction][google.spanner.v1.Transaction].
     TransactionOptions begin = 3;
   }
 }
diff --git a/third_party/googleapis/google/spanner/v1/type.proto b/third_party/googleapis/google/spanner/v1/type.proto
index 1ddbd62be..b749d5084 100644
--- a/third_party/googleapis/google/spanner/v1/type.proto
+++ b/third_party/googleapis/google/spanner/v1/type.proto
@@ -1,4 +1,4 @@
-// Copyright 2018 Google LLC
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -25,50 +25,6 @@ option java_outer_classname = "TypeProto";
 option java_package = "com.google.spanner.v1";
 option php_namespace = "Google\\Cloud\\Spanner\\V1";
 
-// `Type` indicates the type of a Cloud Spanner value, as might be stored in a
-// table cell or returned from an SQL query.
-message Type {
-  // Required. The [TypeCode][google.spanner.v1.TypeCode] for this type.
-  TypeCode code = 1;
-
-  // If [code][google.spanner.v1.Type.code] ==
-  // [ARRAY][google.spanner.v1.TypeCode.ARRAY], then `array_element_type` is the
-  // type of the array elements.
-  Type array_element_type = 2;
-
-  // If [code][google.spanner.v1.Type.code] ==
-  // [STRUCT][google.spanner.v1.TypeCode.STRUCT], then `struct_type` provides
-  // type information for the struct's fields.
-  StructType struct_type = 3;
-}
-
-// `StructType` defines the fields of a
-// [STRUCT][google.spanner.v1.TypeCode.STRUCT] type.
-message StructType {
-  // Message representing a single field of a struct.
-  message Field {
-    // The name of the field. For reads, this is the column name. For
-    // SQL queries, it is the column alias (e.g., `"Word"` in the
-    // query `"SELECT 'hello' AS Word"`), or the column name (e.g.,
-    // `"ColName"` in the query `"SELECT ColName FROM Table"`). Some
-    // columns might have an empty name (e.g., !"SELECT
-    // UPPER(ColName)"`). Note that a query result can contain
-    // multiple fields with the same name.
-    string name = 1;
-
-    // The type of the field.
-    Type type = 2;
-  }
-
-  // The list of fields that make up this struct. Order is
-  // significant, because values of this struct type are represented as
-  // lists, where the order of field values matches the order of
-  // fields in the [StructType][google.spanner.v1.StructType]. In turn, the
-  // order of fields matches the order of columns in a read request, or the
-  // order of fields in the `SELECT` clause of a query.
-  repeated Field fields = 1;
-}
-
 // `TypeCode` is used as part of [Type][google.spanner.v1.Type] to
 // indicate the type of a Cloud Spanner value.
 //
@@ -119,3 +75,44 @@ enum TypeCode {
   // to [struct_type.fields[i]][google.spanner.v1.StructType.fields].
   STRUCT = 9;
 }
+
+// `Type` indicates the type of a Cloud Spanner value, as might be stored in a
+// table cell or returned from an SQL query.
+message Type {
+  // Required. The [TypeCode][google.spanner.v1.TypeCode] for this type.
+  TypeCode code = 1;
+
+  // If [code][google.spanner.v1.Type.code] == [ARRAY][google.spanner.v1.TypeCode.ARRAY], then `array_element_type`
+  // is the type of the array elements.
+  Type array_element_type = 2;
+
+  // If [code][google.spanner.v1.Type.code] == [STRUCT][google.spanner.v1.TypeCode.STRUCT], then `struct_type`
+  // provides type information for the struct's fields.
+  StructType struct_type = 3;
+}
+
+// `StructType` defines the fields of a [STRUCT][google.spanner.v1.TypeCode.STRUCT] type.
+message StructType {
+  // Message representing a single field of a struct.
+  message Field {
+    // The name of the field. For reads, this is the column name. For
+    // SQL queries, it is the column alias (e.g., `"Word"` in the
+    // query `"SELECT 'hello' AS Word"`), or the column name (e.g.,
+    // `"ColName"` in the query `"SELECT ColName FROM Table"`). Some
+    // columns might have an empty name (e.g., !"SELECT
+    // UPPER(ColName)"`). Note that a query result can contain
+    // multiple fields with the same name.
+    string name = 1;
+
+    // The type of the field.
+    Type type = 2;
+  }
+
+  // The list of fields that make up this struct. Order is
+  // significant, because values of this struct type are represented as
+  // lists, where the order of field values matches the order of
+  // fields in the [StructType][google.spanner.v1.StructType]. In turn, the order of fields
+  // matches the order of columns in a read request, or the order of
+  // fields in the `SELECT` clause of a query.
+  repeated Field fields = 1;
+}
diff --git a/third_party/googleapis/google/storage/v1/BUILD.bazel b/third_party/googleapis/google/storage/v1/BUILD.bazel
new file mode 100644
index 000000000..a098c0e52
--- /dev/null
+++ b/third_party/googleapis/google/storage/v1/BUILD.bazel
@@ -0,0 +1,392 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "storage_proto",
+    srcs = [
+        "storage.proto",
+        "storage_resources.proto",
+    ],
+    deps = [
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/iam/v1:iam_policy_proto",
+        "//google/iam/v1:policy_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+        "@com_google_protobuf//:wrappers_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "storage_proto_with_info",
+    deps = [
+        ":storage_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "storage_java_proto",
+    deps = [":storage_proto"],
+)
+
+java_grpc_library(
+    name = "storage_java_grpc",
+    srcs = [":storage_proto"],
+    deps = [":storage_java_proto"],
+)
+
+java_gapic_library(
+    name = "storage_java_gapic",
+    src = ":storage_proto_with_info",
+    gapic_yaml = "storage_gapic.yaml",
+    package = "google.storage.v1",
+    service_yaml = "storage_v1.yaml",
+    test_deps = [
+        ":storage_java_grpc",
+        "//google/iam/v1:iam_java_grpc",
+    ],
+    deps = [
+        ":storage_java_proto",
+        "//google/iam/v1:iam_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "storage_java_gapic_test_suite",
+    test_classes = [
+        "com.google.cloud.google.storage.v1.StorageClientTest",
+    ],
+    runtime_deps = [":storage_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-storage-v1-java",
+    deps = [
+        ":storage_java_gapic",
+        ":storage_java_grpc",
+        ":storage_java_proto",
+        ":storage_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "storage_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/storage/v1",
+    protos = [":storage_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/iam/v1:iam_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "storage_go_gapic",
+    srcs = [":storage_proto_with_info"],
+    grpc_service_config = "storage_service_config.json",
+    importpath = "cloud.google.com/go/storage/apiv1;storage",
+    service_yaml = "storage_v1.yaml",
+    deps = [
+        ":storage_go_proto",
+        "//google/iam/v1:iam_go_proto",
+    ],
+)
+
+go_test(
+    name = "storage_go_gapic_test",
+    srcs = [":storage_go_gapic_srcjar_test"],
+    embed = [":storage_go_gapic"],
+    importpath = "cloud.google.com/go/storage/apiv1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-storage-v1-go",
+    deps = [
+        ":storage_go_gapic",
+        ":storage_go_gapic_srcjar-test.srcjar",
+        ":storage_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "storage_moved_proto",
+    srcs = [":storage_proto"],
+    deps = [
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/iam/v1:iam_policy_proto",
+        "//google/iam/v1:policy_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+        "@com_google_protobuf//:wrappers_proto",
+    ],
+)
+
+py_proto_library(
+    name = "storage_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":storage_moved_proto"],
+)
+
+py_grpc_library(
+    name = "storage_py_grpc",
+    srcs = [":storage_moved_proto"],
+    deps = [":storage_py_proto"],
+)
+
+py_gapic_library(
+    name = "storage_py_gapic",
+    src = ":storage_proto_with_info",
+    gapic_yaml = "storage_gapic.yaml",
+    package = "google.storage.v1",
+    service_yaml = "storage_v1.yaml",
+    deps = [
+        ":storage_py_grpc",
+        ":storage_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "storage-v1-py",
+    deps = [
+        ":storage_py_gapic",
+        ":storage_py_grpc",
+        ":storage_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+# Note: The GCS gRPC API is launching without PHP client library support (see
+# https://buganizer.corp.google.com/issues/118459221#comment3), but we need to
+# generate Bazel build rules for all languages must be present else the
+# build_gen step will fail with NPE. We further needed to comment out the
+# PHP lines here because building PHP clients requires all RPCs in the service
+# definitions to contain http_rule annotations.
+#load(
+#    "@com_google_googleapis_imports//:imports.bzl",
+#    "php_gapic_assembly_pkg",
+#    "php_gapic_library",
+#    "php_grpc_library",
+#    "php_proto_library",
+#)
+#
+#php_proto_library(
+#    name = "storage_php_proto",
+#    deps = [":storage_proto"],
+#)
+#
+#php_grpc_library(
+#    name = "storage_php_grpc",
+#    srcs = [":storage_proto"],
+#    deps = [":storage_php_proto"],
+#)
+#
+#php_gapic_library(
+#    name = "storage_php_gapic",
+#    src = ":storage_proto_with_info",
+#    gapic_yaml = "storage_gapic.yaml",
+#    package = "google.storage.v1",
+#    service_yaml = "storage_v1.yaml",
+#    deps = [
+#        ":storage_php_grpc",
+#        ":storage_php_proto",
+#    ],
+#)
+#
+## Open Source Packages
+#php_gapic_assembly_pkg(
+#    name = "google-cloud-storage-v1-php",
+#    deps = [
+#        ":storage_php_gapic",
+#        ":storage_php_grpc",
+#        ":storage_php_proto",
+#    ],
+#)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "storage_nodejs_gapic",
+    src = ":storage_proto_with_info",
+    gapic_yaml = "storage_gapic.yaml",
+    package = "google.storage.v1",
+    service_yaml = "storage_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "storage-v1-nodejs",
+    deps = [
+        ":storage_nodejs_gapic",
+        ":storage_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "storage_ruby_proto",
+    deps = [":storage_proto"],
+)
+
+ruby_grpc_library(
+    name = "storage_ruby_grpc",
+    srcs = [":storage_proto"],
+    deps = [":storage_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "storage_ruby_gapic",
+    src = ":storage_proto_with_info",
+    gapic_yaml = "storage_gapic.yaml",
+    package = "google.storage.v1",
+    service_yaml = "storage_v1.yaml",
+    deps = [
+        ":storage_ruby_grpc",
+        ":storage_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-storage-v1-ruby",
+    deps = [
+        ":storage_ruby_gapic",
+        ":storage_ruby_grpc",
+        ":storage_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "storage_csharp_proto",
+    deps = [":storage_proto"],
+)
+
+csharp_grpc_library(
+    name = "storage_csharp_grpc",
+    srcs = [":storage_proto"],
+    deps = [":storage_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "storage_csharp_gapic",
+    src = ":storage_proto_with_info",
+    gapic_yaml = "storage_gapic.yaml",
+    package = "google.storage.v1",
+    service_yaml = "storage_v1.yaml",
+    deps = [
+        ":storage_csharp_grpc",
+        ":storage_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-storage-v1-csharp",
+    deps = [
+        ":storage_csharp_gapic",
+        ":storage_csharp_grpc",
+        ":storage_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "cc_grpc_library",
+    "cc_proto_library",
+)
+
+cc_proto_library(
+    name = "storage_cc_proto",
+    deps = [":storage_proto"],
+)
+
+cc_grpc_library(
+    name = "storage_cc_grpc",
+    srcs = [":storage_proto"],
+    generate_mocks = True,
+    grpc_only = True,
+    deps = [":storage_cc_proto"],
+)
diff --git a/third_party/googleapis/google/storage/v1/storage.proto b/third_party/googleapis/google/storage/v1/storage.proto
new file mode 100644
index 000000000..7ba34bffe
--- /dev/null
+++ b/third_party/googleapis/google/storage/v1/storage.proto
@@ -0,0 +1,1981 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.storage.v1;
+
+import "google/api/field_behavior.proto";
+import "google/iam/v1/iam_policy.proto";
+import "google/iam/v1/policy.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/wrappers.proto";
+import "google/storage/v1/storage_resources.proto";
+import "google/api/client.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/storage/v1;storage";
+option java_multiple_files = true;
+option java_package = "com.google.storage.v1";
+
+// Manages Google Cloud Storage resources.
+service Storage {
+  option (google.api.default_host) = "storage.googleapis.com";
+  option (google.api.oauth_scopes) =
+      "https://www.googleapis.com/auth/cloud-platform,"
+      "https://www.googleapis.com/auth/cloud-platform.read-only,"
+      "https://www.googleapis.com/auth/devstorage.full_control,"
+      "https://www.googleapis.com/auth/devstorage.read_only,"
+      "https://www.googleapis.com/auth/devstorage.read_write";
+
+  // Permanently deletes the ACL entry for the specified entity on the specified
+  // bucket.
+  rpc DeleteBucketAccessControl(DeleteBucketAccessControlRequest) returns (google.protobuf.Empty) {
+  }
+
+  // Returns the ACL entry for the specified entity on the specified bucket.
+  rpc GetBucketAccessControl(GetBucketAccessControlRequest) returns (BucketAccessControl) {
+  }
+
+  // Creates a new ACL entry on the specified bucket.
+  rpc InsertBucketAccessControl(InsertBucketAccessControlRequest) returns (BucketAccessControl) {
+  }
+
+  // Retrieves ACL entries on the specified bucket.
+  rpc ListBucketAccessControls(ListBucketAccessControlsRequest) returns (ListBucketAccessControlsResponse) {
+  }
+
+  // Updates an ACL entry on the specified bucket. Equivalent to
+  // PatchBucketAccessControl, but all unspecified fields will be
+  // reset to their default values.
+  rpc UpdateBucketAccessControl(UpdateBucketAccessControlRequest) returns (BucketAccessControl) {
+  }
+
+  // Updates an ACL entry on the specified bucket.
+  rpc PatchBucketAccessControl(PatchBucketAccessControlRequest) returns (BucketAccessControl) {
+  }
+
+  // Permanently deletes an empty bucket.
+  rpc DeleteBucket(DeleteBucketRequest) returns (google.protobuf.Empty) {
+  }
+
+  // Returns metadata for the specified bucket.
+  rpc GetBucket(GetBucketRequest) returns (Bucket) {
+  }
+
+  // Creates a new bucket.
+  rpc InsertBucket(InsertBucketRequest) returns (Bucket) {
+  }
+
+  // List active object change notification channels for this bucket.
+  rpc ListChannels(ListChannelsRequest) returns (ListChannelsResponse) {
+  }
+
+  // Retrieves a list of buckets for a given project.
+  rpc ListBuckets(ListBucketsRequest) returns (ListBucketsResponse) {
+  }
+
+  // Locks retention policy on a bucket.
+  rpc LockBucketRetentionPolicy(LockRetentionPolicyRequest) returns (Bucket) {
+  }
+
+  // Gets the IAM policy for the specified bucket.
+  rpc GetBucketIamPolicy(GetIamPolicyRequest) returns (google.iam.v1.Policy) {
+  }
+
+  // Updates an IAM policy for the specified bucket.
+  rpc SetBucketIamPolicy(SetIamPolicyRequest) returns (google.iam.v1.Policy) {
+  }
+
+  // Tests a set of permissions on the given bucket to see which, if
+  // any, are held by the caller.
+  rpc TestBucketIamPermissions(TestIamPermissionsRequest) returns (google.iam.v1.TestIamPermissionsResponse) {
+  }
+
+  // Updates a bucket. Changes to the bucket will be readable immediately after
+  // writing, but configuration changes may take time to propagate.
+  rpc PatchBucket(PatchBucketRequest) returns (Bucket) {
+  }
+
+  // Updates a bucket. Equivalent to PatchBucket, but always replaces all
+  // mutatable fields of the bucket with new values, reverting all
+  // unspecified fields to their default values.
+  // Like PatchBucket, Changes to the bucket will be readable immediately after
+  // writing, but configuration changes may take time to propagate.
+  rpc UpdateBucket(UpdateBucketRequest) returns (Bucket) {
+  }
+
+  // Halts "Object Change Notification" push messagages.
+  // See https://cloud.google.com/storage/docs/object-change-notification
+  // Note: this is not related to the newer "Notifications" resource, which
+  // are stopped using DeleteNotification.
+  rpc StopChannel(StopChannelRequest) returns (google.protobuf.Empty) {
+  }
+
+  // Permanently deletes the default object ACL entry for the specified entity
+  // on the specified bucket.
+  rpc DeleteDefaultObjectAccessControl(DeleteDefaultObjectAccessControlRequest) returns (google.protobuf.Empty) {
+  }
+
+  // Returns the default object ACL entry for the specified entity on the
+  // specified bucket.
+  rpc GetDefaultObjectAccessControl(GetDefaultObjectAccessControlRequest) returns (ObjectAccessControl) {
+  }
+
+  // Creates a new default object ACL entry on the specified bucket.
+  rpc InsertDefaultObjectAccessControl(InsertDefaultObjectAccessControlRequest) returns (ObjectAccessControl) {
+  }
+
+  // Retrieves default object ACL entries on the specified bucket.
+  rpc ListDefaultObjectAccessControls(ListDefaultObjectAccessControlsRequest) returns (ListObjectAccessControlsResponse) {
+  }
+
+  // Updates a default object ACL entry on the specified bucket.
+  rpc PatchDefaultObjectAccessControl(PatchDefaultObjectAccessControlRequest) returns (ObjectAccessControl) {
+  }
+
+  // Updates a default object ACL entry on the specified bucket. Equivalent to
+  // PatchDefaultObjectAccessControl, but modifies all unspecified fields to
+  // their default values.
+  rpc UpdateDefaultObjectAccessControl(UpdateDefaultObjectAccessControlRequest) returns (ObjectAccessControl) {
+  }
+
+  // Permanently deletes a notification subscription.
+  // Note: Older, "Object Change Notification" push subscriptions should be
+  // deleted using StopChannel instead.
+  rpc DeleteNotification(DeleteNotificationRequest) returns (google.protobuf.Empty) {
+  }
+
+  // View a notification configuration.
+  rpc GetNotification(GetNotificationRequest) returns (Notification) {
+  }
+
+  // Creates a notification subscription for a given bucket.
+  // These notifications, when triggered, publish messages to the specified
+  // Cloud Pub/Sub topics.
+  // See https://cloud.google.com/storage/docs/pubsub-notifications.
+  rpc InsertNotification(InsertNotificationRequest) returns (Notification) {
+  }
+
+  // Retrieves a list of notification subscriptions for a given bucket.
+  rpc ListNotifications(ListNotificationsRequest) returns (ListNotificationsResponse) {
+  }
+
+  // Permanently deletes the ACL entry for the specified entity on the specified
+  // object.
+  rpc DeleteObjectAccessControl(DeleteObjectAccessControlRequest) returns (google.protobuf.Empty) {
+  }
+
+  // Returns the ACL entry for the specified entity on the specified object.
+  rpc GetObjectAccessControl(GetObjectAccessControlRequest) returns (ObjectAccessControl) {
+  }
+
+  // Creates a new ACL entry on the specified object.
+  rpc InsertObjectAccessControl(InsertObjectAccessControlRequest) returns (ObjectAccessControl) {
+  }
+
+  // Retrieves ACL entries on the specified object.
+  rpc ListObjectAccessControls(ListObjectAccessControlsRequest) returns (ListObjectAccessControlsResponse) {
+  }
+
+  // Patches an ACL entry on the specified object.  Patch is similar to update,
+  // but only applies or appends the specified fields in the
+  // object_access_control object.  Other fields are unaffected.
+  rpc PatchObjectAccessControl(PatchObjectAccessControlRequest) returns (ObjectAccessControl) {
+  }
+
+  // Updates an ACL entry on the specified object.
+  rpc UpdateObjectAccessControl(UpdateObjectAccessControlRequest) returns (ObjectAccessControl) {
+  }
+
+  // Concatenates a list of existing objects into a new object in the same
+  // bucket.
+  rpc ComposeObject(ComposeObjectRequest) returns (Object) {
+  }
+
+  // Copies a source object to a destination object. Optionally overrides
+  // metadata.
+  rpc CopyObject(CopyObjectRequest) returns (Object) {
+  }
+
+  // Deletes an object and its metadata. Deletions are permanent if versioning
+  // is not enabled for the bucket, or if the `generation` parameter
+  // is used.
+  rpc DeleteObject(DeleteObjectRequest) returns (google.protobuf.Empty) {
+  }
+
+  // Retrieves an object's metadata.
+  rpc GetObject(GetObjectRequest) returns (Object) {
+  }
+
+  // Reads an object's data.
+  rpc GetObjectMedia(GetObjectMediaRequest) returns (stream GetObjectMediaResponse) {
+  }
+
+  // Stores a new object and metadata.
+  //
+  // An object can be written either in a single message stream or in a
+  // resumable sequence of message streams. To write using a single stream,
+  // the client should include in the first message of the stream an
+  // `InsertObjectSpec` describing the destination bucket, object, and any
+  // preconditions. Additionally, the final message must set 'finish_write' to
+  // true, or else it is an error.
+  //
+  // For a resumable write, the client should instead call
+  // `StartResumableWrite()` and provide that method an `InsertObjectSpec.`
+  // They should then attach the returned `upload_id` to the first message of
+  // each following call to `Insert`. If there is an error or the connection is
+  // broken during the resumable `Insert()`, the client should check the status
+  // of the `Insert()` by calling `QueryWriteStatus()` and continue writing from
+  // the returned `committed_size`. This may be less than the amount of data the
+  // client previously sent.
+  //
+  // The service will not view the object as complete until the client has
+  // sent an `Insert` with `finish_write` set to `true`. Sending any
+  // requests on a stream after sending a request with `finish_write` set to
+  // `true` will cause an error. The client **should** check the
+  // `Object` it receives to determine how much data the service was
+  // able to commit and whether the service views the object as complete.
+  rpc InsertObject(stream InsertObjectRequest) returns (Object) {
+  }
+
+  // Retrieves a list of objects matching the criteria.
+  rpc ListObjects(ListObjectsRequest) returns (ListObjectsResponse) {
+  }
+
+  // Rewrites a source object to a destination object. Optionally overrides
+  // metadata.
+  rpc RewriteObject(RewriteObjectRequest) returns (RewriteResponse) {
+  }
+
+  // Starts a resumable write. How long the write operation remains valid, and
+  // what happens when the write operation becomes invalid, are
+  // service-dependent.
+  rpc StartResumableWrite(StartResumableWriteRequest) returns (StartResumableWriteResponse) {
+  }
+
+  // Determines the `committed_size` for an object that is being written, which
+  // can then be used as the `write_offset` for the next `Write()` call.
+  //
+  // If the object does not exist (i.e., the object has been deleted, or the
+  // first `Write()` has not yet reached the service), this method returns the
+  // error `NOT_FOUND`.
+  //
+  // The client **may** call `QueryWriteStatus()` at any time to determine how
+  // much data has been processed for this object. This is useful if the
+  // client is buffering data and needs to know which data can be safely
+  // evicted. For any sequence of `QueryWriteStatus()` calls for a given
+  // object name, the sequence of returned `committed_size` values will be
+  // non-decreasing.
+  rpc QueryWriteStatus(QueryWriteStatusRequest) returns (QueryWriteStatusResponse) {
+  }
+
+  // Updates an object's metadata.
+  rpc PatchObject(PatchObjectRequest) returns (Object) {
+  }
+
+  // Updates an object's metadata. Equivalent to PatchObject, but always
+  // replaces all mutatable fields of the bucket with new values, reverting all
+  // unspecified fields to their default values.
+  rpc UpdateObject(UpdateObjectRequest) returns (Object) {
+  }
+
+  // Gets the IAM policy for the specified object.
+  rpc GetObjectIamPolicy(GetIamPolicyRequest) returns (google.iam.v1.Policy) {
+  }
+
+  // Updates an IAM policy for the specified object.
+  rpc SetObjectIamPolicy(SetIamPolicyRequest) returns (google.iam.v1.Policy) {
+  }
+
+  // Tests a set of permissions on the given object to see which, if
+  // any, are held by the caller.
+  rpc TestObjectIamPermissions(TestIamPermissionsRequest) returns (google.iam.v1.TestIamPermissionsResponse) {
+  }
+
+  // Watch for changes on all objects in a bucket.
+  rpc WatchAllObjects(WatchAllObjectsRequest) returns (Channel) {
+  }
+
+  // Retrieves the name of a project's Google Cloud Storage service account.
+  rpc GetServiceAccount(GetProjectServiceAccountRequest) returns (ServiceAccount) {
+  }
+
+  // Creates a new HMAC key for the given service account.
+  rpc CreateHmacKey(CreateHmacKeyRequest) returns (CreateHmacKeyResponse) {
+  }
+
+  // Deletes a given HMAC key.  Key must be in an INACTIVE state.
+  rpc DeleteHmacKey(DeleteHmacKeyRequest) returns (google.protobuf.Empty) {
+  }
+
+  // Gets an existing HMAC key metadata for the given id.
+  rpc GetHmacKey(GetHmacKeyRequest) returns (HmacKeyMetadata) {
+  }
+
+  // Lists HMAC keys under a given project with the additional filters provided.
+  rpc ListHmacKeys(ListHmacKeysRequest) returns (ListHmacKeysResponse) {
+  }
+
+  // Updates a given HMAC key state between ACTIVE and INACTIVE.
+  rpc UpdateHmacKey(UpdateHmacKeyRequest) returns (HmacKeyMetadata) {
+  }
+}
+
+// Request message for DeleteBucketAccessControl.
+message DeleteBucketAccessControlRequest {
+  // Required. Name of a bucket.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The entity holding the permission. Can be one of:
+  // * `user-`*userId*
+  // * `user-`*emailAddress*
+  // * `group-`*groupId*
+  // * `group-`*emailAddress*
+  // * `allUsers`
+  // * `allAuthenticatedUsers`
+  string entity = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 4;
+}
+
+// Request message for GetBucketAccessControl.
+message GetBucketAccessControlRequest {
+  // Required. Name of a bucket.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The entity holding the permission. Can be one of:
+  // * `user-`*userId*
+  // * `user-`*emailAddress*
+  // * `group-`*groupId*
+  // * `group-`*emailAddress*
+  // * `allUsers`
+  // * `allAuthenticatedUsers`
+  string entity = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 4;
+}
+
+// Request message for InsertBucketAccessControl.
+message InsertBucketAccessControlRequest {
+  // Required. Name of a bucket.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Properties of the new bucket access control being inserted.
+  BucketAccessControl bucket_access_control = 3;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 4;
+}
+
+// Request message for ListBucketAccessControl.
+message ListBucketAccessControlsRequest {
+  // Required. Name of a bucket.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 3;
+}
+
+// Request for PatchBucketAccessControl.
+message PatchBucketAccessControlRequest {
+  // Required. Name of a bucket.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The entity holding the permission. Can be one of:
+  // * `user-`*userId*
+  // * `user-`*emailAddress*
+  // * `group-`*groupId*
+  // * `group-`*emailAddress*
+  // * `allUsers`
+  // * `allAuthenticatedUsers`
+  string entity = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // The BucketAccessControl for updating.
+  BucketAccessControl bucket_access_control = 4;
+
+  // List of fields to be updated.
+  //
+  // To specify ALL fields, equivalent to the JSON API's "update" function,
+  // specify a single field with the value `*`.
+  //
+  //
+  // Not specifying any fields is an error.
+  // Not specifying a field while setting that field to a non-default value is
+  // an error.
+  google.protobuf.FieldMask update_mask = 5;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 6;
+}
+
+// Request for UpdateBucketAccessControl.
+message UpdateBucketAccessControlRequest {
+  // Required. Name of a bucket.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The entity holding the permission. Can be one of:
+  // * `user-`*userId*
+  // * `user-`*emailAddress*
+  // * `group-`*groupId*
+  // * `group-`*emailAddress*
+  // * `allUsers`
+  // * `allAuthenticatedUsers`
+  string entity = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // The BucketAccessControl for updating.
+  BucketAccessControl bucket_access_control = 4;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 5;
+}
+
+// Request message for DeleteBucket.
+message DeleteBucketRequest {
+  // Required. Name of a bucket.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // If set, only deletes the bucket if its metageneration matches this value.
+  google.protobuf.Int64Value if_metageneration_match = 2;
+
+  // If set, only deletes the bucket if its metageneration does not match this
+  // value.
+  google.protobuf.Int64Value if_metageneration_not_match = 3;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 5;
+}
+
+// Request message for GetBucket.
+message GetBucketRequest {
+  // Required. Name of a bucket.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Makes the return of the bucket metadata conditional on whether the bucket's
+  // current metageneration matches the given value.
+  google.protobuf.Int64Value if_metageneration_match = 2;
+
+  // Makes the return of the bucket metadata conditional on whether the bucket's
+  // current metageneration does not match the given value.
+  google.protobuf.Int64Value if_metageneration_not_match = 3;
+
+  // Set of properties to return. Defaults to `NO_ACL`.
+  CommonEnums.Projection projection = 4;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 6;
+}
+
+// Request message for InsertBucket.
+message InsertBucketRequest {
+  // Apply a predefined set of access controls to this bucket.
+  CommonEnums.PredefinedBucketAcl predefined_acl = 1;
+
+  // Apply a predefined set of default object access controls to this bucket.
+  CommonEnums.PredefinedObjectAcl predefined_default_object_acl = 2;
+
+  // Required. A valid API project identifier.
+  string project = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Set of properties to return. Defaults to `NO_ACL`, unless the
+  // bucket resource specifies `acl` or `defaultObjectAcl`
+  // properties, when it defaults to `FULL`.
+  CommonEnums.Projection projection = 4;
+
+  // Properties of the new bucket being inserted, including its name.
+  Bucket bucket = 6;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 7;
+}
+
+// Request message for ListChannels.
+message ListChannelsRequest {
+  // Required. Name of a bucket.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 3;
+}
+
+// Request message for ListBuckets.
+message ListBucketsRequest {
+  // Maximum number of buckets to return in a single response. The service will
+  // use this parameter or 1,000 items, whichever is smaller.
+  int32 max_results = 1;
+
+  // A previously-returned page token representing part of the larger set of
+  // results to view.
+  string page_token = 2;
+
+  // Filter results to buckets whose names begin with this prefix.
+  string prefix = 3;
+
+  // Required. A valid API project identifier.
+  string project = 4 [(google.api.field_behavior) = REQUIRED];
+
+  // Set of properties to return. Defaults to `NO_ACL`.
+  CommonEnums.Projection projection = 5;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 7;
+}
+
+// Request message for LockRetentionPolicy.
+message LockRetentionPolicyRequest {
+  // Required. Name of a bucket.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Makes the operation conditional on whether bucket's current metageneration
+  // matches the given value. Must be positive.
+  int64 if_metageneration_match = 2;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 4;
+}
+
+// Request for PatchBucket method.
+message PatchBucketRequest {
+  // Required. Name of a bucket.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Makes the return of the bucket metadata conditional on whether the bucket's
+  // current metageneration matches the given value.
+  google.protobuf.Int64Value if_metageneration_match = 2;
+
+  // Makes the return of the bucket metadata conditional on whether the bucket's
+  // current metageneration does not match the given value.
+  google.protobuf.Int64Value if_metageneration_not_match = 3;
+
+  // Apply a predefined set of access controls to this bucket.
+  CommonEnums.PredefinedBucketAcl predefined_acl = 4;
+
+  // Apply a predefined set of default object access controls to this bucket.
+  CommonEnums.PredefinedObjectAcl predefined_default_object_acl = 5;
+
+  // Set of properties to return. Defaults to `FULL`.
+  CommonEnums.Projection projection = 6;
+
+  // The Bucket metadata for updating.
+  Bucket metadata = 8;
+
+  // List of fields to be updated.
+  //
+  // To specify ALL fields, equivalent to the JSON API's "update" function,
+  // specify a single field with the value `*`. Note: not recommended. If a new
+  // field is introduced at a later time, an older client updating with the `*`
+  // may accidentally reset the new field's value.
+  //
+  // Not specifying any fields is an error.
+  // Not specifying a field while setting that field to a non-default value is
+  // an error.
+  google.protobuf.FieldMask update_mask = 9;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 10;
+}
+
+// Request for UpdateBucket method.
+message UpdateBucketRequest {
+  // Required. Name of a bucket.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Makes the return of the bucket metadata conditional on whether the bucket's
+  // current metageneration matches the given value.
+  google.protobuf.Int64Value if_metageneration_match = 2;
+
+  // Makes the return of the bucket metadata conditional on whether the bucket's
+  // current metageneration does not match the given value.
+  google.protobuf.Int64Value if_metageneration_not_match = 3;
+
+  // Apply a predefined set of access controls to this bucket.
+  CommonEnums.PredefinedBucketAcl predefined_acl = 4;
+
+  // Apply a predefined set of default object access controls to this bucket.
+  CommonEnums.PredefinedObjectAcl predefined_default_object_acl = 5;
+
+  // Set of properties to return. Defaults to `FULL`.
+  CommonEnums.Projection projection = 6;
+
+  // The Bucket metadata for updating.
+  Bucket metadata = 8;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 9;
+}
+
+// Request message for StopChannel.
+message StopChannelRequest {
+  // The channel to be stopped.
+  Channel channel = 1;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 2;
+}
+
+// Request message for DeleteDefaultObjectAccessControl.
+message DeleteDefaultObjectAccessControlRequest {
+  // Required. Name of a bucket.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The entity holding the permission. Can be one of:
+  // * `user-`*userId*
+  // * `user-`*emailAddress*
+  // * `group-`*groupId*
+  // * `group-`*emailAddress*
+  // * `allUsers`
+  // * `allAuthenticatedUsers`
+  string entity = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 4;
+}
+
+// Request message for GetDefaultObjectAccessControl.
+message GetDefaultObjectAccessControlRequest {
+  // Required. Name of a bucket.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The entity holding the permission. Can be one of:
+  // * `user-`*userId*
+  // * `user-`*emailAddress*
+  // * `group-`*groupId*
+  // * `group-`*emailAddress*
+  // * `allUsers`
+  // * `allAuthenticatedUsers`
+  string entity = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 4;
+}
+
+// Request message for InsertDefaultObjectAccessControl.
+message InsertDefaultObjectAccessControlRequest {
+  // Required. Name of a bucket.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Properties of the object access control being inserted.
+  ObjectAccessControl object_access_control = 3;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 4;
+}
+
+// Request message for ListDefaultObjectAccessControls.
+message ListDefaultObjectAccessControlsRequest {
+  // Required. Name of a bucket.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // If present, only return default ACL listing if the bucket's current
+  // metageneration matches this value.
+  google.protobuf.Int64Value if_metageneration_match = 2;
+
+  // If present, only return default ACL listing if the bucket's current
+  // metageneration does not match the given value.
+  google.protobuf.Int64Value if_metageneration_not_match = 3;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 5;
+}
+
+// Request message for PatchDefaultObjectAccessControl.
+message PatchDefaultObjectAccessControlRequest {
+  // Required. Name of a bucket.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The entity holding the permission. Can be one of:
+  // * `user-`*userId*
+  // * `user-`*emailAddress*
+  // * `group-`*groupId*
+  // * `group-`*emailAddress*
+  // * `allUsers`
+  // * `allAuthenticatedUsers`
+  string entity = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // The ObjectAccessControl for updating.
+  ObjectAccessControl object_access_control = 4;
+
+  // List of fields to be updated.
+  //
+  // To specify ALL fields, equivalent to the JSON API's "update" function,
+  // specify a single field with the value `*`. Note: not recommended. If a new
+  // field is introduced at a later time, an older client updating with the `*`
+  // may accidentally reset the new field's value.
+  //
+  // Not specifying any fields is an error.
+  // Not specifying a field while setting that field to a non-default value is
+  // an error.
+  google.protobuf.FieldMask update_mask = 5;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 6;
+}
+
+// Request message for UpdateDefaultObjectAccessControl.
+message UpdateDefaultObjectAccessControlRequest {
+  // Required. Name of a bucket.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The entity holding the permission. Can be one of:
+  // * `user-`*userId*
+  // * `user-`*emailAddress*
+  // * `group-`*groupId*
+  // * `group-`*emailAddress*
+  // * `allUsers`
+  // * `allAuthenticatedUsers`
+  string entity = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // The ObjectAccessControl for updating.
+  ObjectAccessControl object_access_control = 4;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 5;
+}
+
+// Request message for DeleteNotification.
+message DeleteNotificationRequest {
+  // Required. The parent bucket of the notification.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. ID of the notification to delete.
+  string notification = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 4;
+}
+
+// Request message for GetNotification.
+message GetNotificationRequest {
+  // Required. The parent bucket of the notification.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Notification ID.
+  // Required.
+  string notification = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 4;
+}
+
+// Request message for InsertNotification.
+message InsertNotificationRequest {
+  // Required. The parent bucket of the notification.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Properties of the notification to be inserted.
+  Notification notification = 3;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 4;
+}
+
+// Request message for ListNotifications.
+message ListNotificationsRequest {
+  // Required. Name of a Google Cloud Storage bucket.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 3;
+}
+
+// Request message for DeleteObjectAccessControl.
+message DeleteObjectAccessControlRequest {
+  // Required. Name of a bucket.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The entity holding the permission. Can be one of:
+  // * `user-`*userId*
+  // * `user-`*emailAddress*
+  // * `group-`*groupId*
+  // * `group-`*emailAddress*
+  // * `allUsers`
+  // * `allAuthenticatedUsers`
+  string entity = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Name of the object.
+  string object = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // If present, selects a specific revision of this object (as opposed to the
+  // latest version, the default).
+  int64 generation = 4;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 6;
+}
+
+// Request message for GetObjectAccessControl.
+message GetObjectAccessControlRequest {
+  // Required. Name of a bucket.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The entity holding the permission. Can be one of:
+  // * `user-`*userId*
+  // * `user-`*emailAddress*
+  // * `group-`*groupId*
+  // * `group-`*emailAddress*
+  // * `allUsers`
+  // * `allAuthenticatedUsers`
+  string entity = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Name of the object.
+  string object = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // If present, selects a specific revision of this object (as opposed to the
+  // latest version, the default).
+  int64 generation = 4;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 6;
+}
+
+// Request message for InsertObjectAccessControl.
+message InsertObjectAccessControlRequest {
+  // Required. Name of a bucket.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Name of the object.
+  string object = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // If present, selects a specific revision of this object (as opposed to the
+  // latest version, the default).
+  int64 generation = 3;
+
+  // Properties of the object access control to be inserted.
+  ObjectAccessControl object_access_control = 5;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 6;
+}
+
+// Request message for ListObjectAccessControls.
+message ListObjectAccessControlsRequest {
+  // Required. Name of a bucket.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Name of the object.
+  string object = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // If present, selects a specific revision of this object (as opposed to the
+  // latest version, the default).
+  int64 generation = 3;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 5;
+}
+
+// Request message for PatchObjectAccessControl.
+message PatchObjectAccessControlRequest {
+  // Required. Name of a bucket.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The entity holding the permission. Can be one of:
+  // * `user-`*userId*
+  // * `user-`*emailAddress*
+  // * `group-`*groupId*
+  // * `group-`*emailAddress*
+  // * `allUsers`
+  // * `allAuthenticatedUsers`
+  string entity = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Name of the object.
+  // Required.
+  string object = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // If present, selects a specific revision of this object (as opposed to the
+  // latest version, the default).
+  int64 generation = 4;
+
+  // The ObjectAccessControl for updating.
+  ObjectAccessControl object_access_control = 5;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 6;
+
+  // List of fields to be updated.
+  //
+  // To specify ALL fields, equivalent to the JSON API's "update" function,
+  // specify a single field with the value `*`. Note: not recommended. If a new
+  // field is introduced at a later time, an older client updating with the `*`
+  // may accidentally reset the new field's value.
+  //
+  // Not specifying any fields is an error.
+  // Not specifying a field while setting that field to a non-default value is
+  // an error.
+  google.protobuf.FieldMask update_mask = 7;
+}
+
+// Request message for UpdateObjectAccessControl.
+message UpdateObjectAccessControlRequest {
+  // Required. Name of a bucket.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The entity holding the permission. Can be one of:
+  // * `user-`*userId*
+  // * `user-`*emailAddress*
+  // * `group-`*groupId*
+  // * `group-`*emailAddress*
+  // * `allUsers`
+  // * `allAuthenticatedUsers`
+  string entity = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Name of the object.
+  // Required.
+  string object = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // If present, selects a specific revision of this object (as opposed to the
+  // latest version, the default).
+  int64 generation = 4;
+
+  // The ObjectAccessControl for updating.
+  ObjectAccessControl object_access_control = 6;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 7;
+
+  // List of fields to be updated.
+  //
+  // To specify ALL fields, equivalent to the JSON API's "update" function,
+  // specify a single field with the value `*`. Note: not recommended. If a new
+  // field is introduced at a later time, an older client updating with the `*`
+  // may accidentally reset the new field's value.
+  //
+  // Not specifying any fields is an error.
+  // Not specifying a field while setting that field to a non-default value is
+  // an error.
+  google.protobuf.FieldMask update_mask = 8;
+}
+
+// Request message for ComposeObject.
+message ComposeObjectRequest {
+  // Description of a source object for a composition request.
+  message SourceObjects {
+    // Preconditions for a source object of a composition request.
+    message ObjectPreconditions {
+      // Only perform the composition if the generation of the source object
+      // that would be used matches this value.  If this value and a generation
+      // are both specified, they must be the same value or the call will fail.
+      google.protobuf.Int64Value if_generation_match = 1;
+    }
+
+    // The source object's name. All source objects must reside in the same
+    // bucket.
+    string name = 1;
+
+    // The generation of this object to use as the source.
+    int64 generation = 2;
+
+    // Conditions that must be met for this operation to execute.
+    ObjectPreconditions object_preconditions = 3;
+  }
+
+  // Required. Name of the bucket containing the source objects. The destination object is
+  // stored in this bucket.
+  string destination_bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Name of the new object.
+  string destination_object = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Apply a predefined set of access controls to the destination object.
+  CommonEnums.PredefinedObjectAcl destination_predefined_acl = 3;
+
+  // Properties of the resulting object.
+  Object destination = 11;
+
+  // The list of source objects that will be concatenated into a single object.
+  repeated SourceObjects source_objects = 12;
+
+  // Makes the operation conditional on whether the object's current generation
+  // matches the given value. Setting to 0 makes the operation succeed only if
+  // there are no live versions of the object.
+  google.protobuf.Int64Value if_generation_match = 4;
+
+  // Makes the operation conditional on whether the object's current
+  // metageneration matches the given value.
+  google.protobuf.Int64Value if_metageneration_match = 5;
+
+  // Resource name of the Cloud KMS key, of the form
+  // `projects/my-project/locations/my-location/keyRings/my-kr/cryptoKeys/my-key`,
+  // that will be used to encrypt the object. Overrides the object
+  // metadata's `kms_key_name` value, if any.
+  string kms_key_name = 6;
+
+  // A set of parameters common to Storage API requests concerning an object.
+  CommonObjectRequestParams common_object_request_params = 9;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 10;
+}
+
+// Request message for CopyObject.
+message CopyObjectRequest {
+  // Required. Name of the bucket in which to store the new object. Overrides the provided
+  // object
+  // metadata's `bucket` value, if any.
+  string destination_bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Name of the new object.
+  // Required when the object metadata is not otherwise provided. Overrides the
+  // object metadata's `name` value, if any.
+  string destination_object = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Apply a predefined set of access controls to the destination object.
+  CommonEnums.PredefinedObjectAcl destination_predefined_acl = 3;
+
+  // Makes the operation conditional on whether the destination object's current
+  // generation matches the given value. Setting to 0 makes the operation
+  // succeed only if there are no live versions of the object.
+  google.protobuf.Int64Value if_generation_match = 4;
+
+  // Makes the operation conditional on whether the destination object's current
+  // generation does not match the given value. If no live object exists, the
+  // precondition fails. Setting to 0 makes the operation succeed only if there
+  // is a live version of the object.
+  google.protobuf.Int64Value if_generation_not_match = 5;
+
+  // Makes the operation conditional on whether the destination object's current
+  // metageneration matches the given value.
+  google.protobuf.Int64Value if_metageneration_match = 6;
+
+  // Makes the operation conditional on whether the destination object's current
+  // metageneration does not match the given value.
+  google.protobuf.Int64Value if_metageneration_not_match = 7;
+
+  // Makes the operation conditional on whether the source object's current
+  // generation matches the given value.
+  google.protobuf.Int64Value if_source_generation_match = 8;
+
+  // Makes the operation conditional on whether the source object's current
+  // generation does not match the given value.
+  google.protobuf.Int64Value if_source_generation_not_match = 9;
+
+  // Makes the operation conditional on whether the source object's current
+  // metageneration matches the given value.
+  google.protobuf.Int64Value if_source_metageneration_match = 10;
+
+  // Makes the operation conditional on whether the source object's current
+  // metageneration does not match the given value.
+  google.protobuf.Int64Value if_source_metageneration_not_match = 11;
+
+  // Set of properties to return. Defaults to `NO_ACL`, unless the
+  // object resource specifies the `acl` property, when it defaults
+  // to `full`.
+  CommonEnums.Projection projection = 12;
+
+  // Required. Name of the bucket in which to find the source object.
+  string source_bucket = 13 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Name of the source object.
+  string source_object = 14 [(google.api.field_behavior) = REQUIRED];
+
+  // If present, selects a specific revision of the source object (as opposed to
+  // the latest version, the default).
+  int64 source_generation = 15;
+
+  // Properties of the resulting object. If not set, duplicate properties of
+  // source object.
+  Object destination = 17;
+
+  // Resource name of the Cloud KMS key, of the form
+  // `projects/my-project/locations/my-location/keyRings/my-kr/cryptoKeys/my-key`,
+  // that will be used to encrypt the object. Overrides the object
+  // metadata's `kms_key_name` value, if any.
+  string destination_kms_key_name = 20;
+
+  // A set of parameters common to Storage API requests concerning an object.
+  CommonObjectRequestParams common_object_request_params = 18;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 19;
+}
+
+// Message for deleting an object.
+// Either `bucket` and `object` *or* `upload_id` **must** be set (but not both).
+message DeleteObjectRequest {
+  // Required. Name of the bucket in which the object resides.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The name of the object to delete (when not using a resumable write).
+  string object = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // The resumable upload_id of the object to delete (when using a
+  // resumable write). This should be copied from the `upload_id` field of
+  // `StartResumableWriteResponse`.
+  string upload_id = 3;
+
+  // If present, permanently deletes a specific revision of this object (as
+  // opposed to the latest version, the default).
+  int64 generation = 4;
+
+  // Makes the operation conditional on whether the object's current generation
+  // matches the given value. Setting to 0 makes the operation succeed only if
+  // there are no live versions of the object.
+  google.protobuf.Int64Value if_generation_match = 5;
+
+  // Makes the operation conditional on whether the object's current generation
+  // does not match the given value. If no live object exists, the precondition
+  // fails. Setting to 0 makes the operation succeed only if there is a live
+  // version of the object.
+  google.protobuf.Int64Value if_generation_not_match = 6;
+
+  // Makes the operation conditional on whether the object's current
+  // metageneration matches the given value.
+  google.protobuf.Int64Value if_metageneration_match = 7;
+
+  // Makes the operation conditional on whether the object's current
+  // metageneration does not match the given value.
+  google.protobuf.Int64Value if_metageneration_not_match = 8;
+
+  // A set of parameters common to Storage API requests concerning an object.
+  CommonObjectRequestParams common_object_request_params = 10;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 11;
+}
+
+// Request message for GetObjectMedia.
+message GetObjectMediaRequest {
+  // The name of the bucket containing the object to read.
+  string bucket = 1;
+
+  // The name of the object to read.
+  string object = 2;
+
+  // If present, selects a specific revision of this object (as opposed
+  // to the latest version, the default).
+  int64 generation = 3;
+
+  // The offset for the first byte to return in the read, relative to the start
+  // of the object.
+  //
+  // A negative `read_offset` value will be interpreted as the number of bytes
+  // back from the end of the object to be returned. For example, if an object's
+  // length is 15 bytes, a GetObjectMediaRequest with `read_offset` = -5 and
+  // `read_limit` = 3 would return bytes 10 through 12 of the object.
+  int64 read_offset = 4;
+
+  // The maximum number of `data` bytes the server is allowed to return in the
+  // sum of all `Object` messages. A `read_limit` of zero indicates that there
+  // is no limit, and a negative `read_limit` will cause an error.
+  //
+  // If the stream returns fewer bytes than allowed by the `read_limit` and no
+  // error occurred, the stream includes all data from the `read_offset` to the
+  // end of the resource.
+  int64 read_limit = 5;
+
+  // Makes the operation conditional on whether the object's current generation
+  // matches the given value. Setting to 0 makes the operation succeed only if
+  // there are no live versions of the object.
+  google.protobuf.Int64Value if_generation_match = 6;
+
+  // Makes the operation conditional on whether the object's current generation
+  // does not match the given value. If no live object exists, the precondition
+  // fails. Setting to 0 makes the operation succeed only if there is a live
+  // version of the object.
+  google.protobuf.Int64Value if_generation_not_match = 7;
+
+  // Makes the operation conditional on whether the object's current
+  // metageneration matches the given value.
+  google.protobuf.Int64Value if_metageneration_match = 8;
+
+  // Makes the operation conditional on whether the object's current
+  // metageneration does not match the given value.
+  google.protobuf.Int64Value if_metageneration_not_match = 9;
+
+  // A set of parameters common to Storage API requests concerning an object.
+  CommonObjectRequestParams common_object_request_params = 11;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 12;
+}
+
+// Request message for GetObject.
+message GetObjectRequest {
+  // Required. Name of the bucket in which the object resides.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Name of the object.
+  string object = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // If present, selects a specific revision of this object (as opposed to the
+  // latest version, the default).
+  int64 generation = 3;
+
+  // Makes the operation conditional on whether the object's current generation
+  // matches the given value. Setting to 0 makes the operation succeed only if
+  // there are no live versions of the object.
+  google.protobuf.Int64Value if_generation_match = 4;
+
+  // Makes the operation conditional on whether the object's current generation
+  // does not match the given value. If no live object exists, the precondition
+  // fails. Setting to 0 makes the operation succeed only if there is a live
+  // version of the object.
+  google.protobuf.Int64Value if_generation_not_match = 5;
+
+  // Makes the operation conditional on whether the object's current
+  // metageneration matches the given value.
+  google.protobuf.Int64Value if_metageneration_match = 6;
+
+  // Makes the operation conditional on whether the object's current
+  // metageneration does not match the given value.
+  google.protobuf.Int64Value if_metageneration_not_match = 7;
+
+  // Set of properties to return. Defaults to `NO_ACL`.
+  CommonEnums.Projection projection = 8;
+
+  // A set of parameters common to Storage API requests concerning an object.
+  CommonObjectRequestParams common_object_request_params = 10;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 11;
+}
+
+// Response message for GetObject.
+message GetObjectMediaResponse {
+  // A portion of the data for the object. The service **may** leave `data`
+  // empty for any given `ReadResponse`. This enables the service to inform the
+  // client that the request is still live while it is running an operation to
+  // generate more data.
+  ChecksummedData checksummed_data = 1;
+
+  // The checksums of the complete object. The client should compute one of
+  // these checksums over the downloaded object and compare it against the value
+  // provided here.
+  ObjectChecksums object_checksums = 2;
+
+  // If read_offset and or read_limit was specified on the
+  // GetObjectMediaRequest, ContentRange will be populated on the first
+  // GetObjectMediaResponse message of the read stream.
+  ContentRange content_range = 3;
+
+  // Metadata of the object whose media is being returned.
+  // Only populated in the first response in the stream.
+  Object metadata = 4;
+}
+
+// Describes an attempt to insert an object, possibly over multiple requests.
+message InsertObjectSpec {
+  // Destination object, including its name and its metadata.
+  Object resource = 1;
+
+  // Apply a predefined set of access controls to this object.
+  CommonEnums.PredefinedObjectAcl predefined_acl = 2;
+
+  // Makes the operation conditional on whether the object's current
+  // generation matches the given value. Setting to 0 makes the operation
+  // succeed only if there are no live versions of the object.
+  google.protobuf.Int64Value if_generation_match = 3;
+
+  // Makes the operation conditional on whether the object's current
+  // generation does not match the given value. If no live object exists, the
+  // precondition fails. Setting to 0 makes the operation succeed only if
+  // there is a live version of the object.
+  google.protobuf.Int64Value if_generation_not_match = 4;
+
+  // Makes the operation conditional on whether the object's current
+  // metageneration matches the given value.
+  google.protobuf.Int64Value if_metageneration_match = 5;
+
+  // Makes the operation conditional on whether the object's current
+  // metageneration does not match the given value.
+  google.protobuf.Int64Value if_metageneration_not_match = 6;
+
+  // Set of properties to return. Defaults to `NO_ACL`, unless the
+  // object resource specifies the `acl` property, when it defaults
+  // to `full`.
+  CommonEnums.Projection projection = 7;
+}
+
+// Message for writing an object.
+message InsertObjectRequest {
+  // The first message of each stream should set one of the following.
+  oneof first_message {
+    // For resumable uploads. This should be the `upload_id` returned from a
+    // call to `StartResumableWriteResponse`.
+    string upload_id = 1;
+
+    // For non-resumable uploads. Describes the overall upload, including the
+    // destination bucket and object name, preconditions, etc.
+    InsertObjectSpec insert_object_spec = 2;
+  }
+
+  // Required. The offset from the beginning of the object at which the data should be
+  // written.
+  //
+  // In the first `InsertObjectRequest` of a `InsertObject()` action, it
+  // indicates the initial offset for the `Insert()` call. The value **must** be
+  // equal to the `committed_size` that a call to `QueryWriteStatus()` would
+  // return (0 if this is the first write to the object).
+  //
+  // On subsequent calls, this value **must** be no larger than the sum of the
+  // first `write_offset` and the sizes of all `data` chunks sent previously on
+  // this stream.
+  //
+  // An incorrect value will cause an error.
+  int64 write_offset = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // A portion of the data for the object.
+  oneof data {
+    // The data to insert. If a crc32c checksum is provided that doesn't match
+    // the checksum computed by the service, the request will fail.
+    ChecksummedData checksummed_data = 4;
+
+    // A reference to an existing object. This can be used to support
+    // several use cases:
+    //   - Writing a sequence of data buffers supports the basic use case of
+    //     uploading a complete object, chunk by chunk.
+    //   - Writing a sequence of references to existing objects allows an
+    //     object to be composed from a collection of objects, which can be
+    //     used to support parallel object writes.
+    //   - Writing a single reference with a given offset and size can be used
+    //     to create an object from a slice of an existing object.
+    //   - Writing an object referencing a object slice (created as noted
+    //     above) followed by a data buffer followed by another object
+    //     slice can be used to support delta upload functionality.
+    GetObjectMediaRequest reference = 5;
+  }
+
+  // Checksums for the complete object. If the checksums computed by the service
+  // don't match the specifified checksums the call will fail. May only be
+  // provided in the first or last request (either with first_message, or
+  // finish_write set).
+  ObjectChecksums object_checksums = 6;
+
+  // If `true`, this indicates that the write is complete. Sending any
+  // `InsertObjectRequest`s subsequent to one in which `finish_write` is `true`
+  // will cause an error.
+  // For a non-resumable write (where the upload_id was not set in the first
+  // message), it is an error not to set this field in the final message of the
+  // stream.
+  bool finish_write = 7;
+
+  // A set of parameters common to Storage API requests concerning an object.
+  CommonObjectRequestParams common_object_request_params = 8;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 9;
+}
+
+// Request message for ListObjects.
+message ListObjectsRequest {
+  // Required. Name of the bucket in which to look for objects.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Returns results in a directory-like mode. `items` will contain
+  // only objects whose names, aside from the `prefix`, do not
+  // contain `delimiter`. Objects whose names, aside from the
+  // `prefix`, contain `delimiter` will have their name,
+  // truncated after the `delimiter`, returned in
+  // `prefixes`. Duplicate `prefixes` are omitted.
+  string delimiter = 2;
+
+  // If true, objects that end in exactly one instance of `delimiter`
+  // will have their metadata included in `items` in addition to
+  // `prefixes`.
+  bool include_trailing_delimiter = 3;
+
+  // Maximum number of `items` plus `prefixes` to return
+  // in a single page of responses. As duplicate `prefixes` are
+  // omitted, fewer total results may be returned than requested. The service
+  // will use this parameter or 1,000 items, whichever is smaller.
+  int32 max_results = 4;
+
+  // A previously-returned page token representing part of the larger set of
+  // results to view.
+  string page_token = 5;
+
+  // Filter results to objects whose names begin with this prefix.
+  string prefix = 6;
+
+  // Set of properties to return. Defaults to `NO_ACL`.
+  CommonEnums.Projection projection = 7;
+
+  // If `true`, lists all versions of an object as distinct results.
+  // The default is `false`. For more information, see
+  // [Object
+  // Versioning](https://cloud.google.com/storage/docs/object-versioning).
+  bool versions = 9;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 10;
+}
+
+// Request object for `ByteStream.QueryWriteStatus`.
+message QueryWriteStatusRequest {
+  // Required. The name of the resume token for the object whose write status is being
+  // requested.
+  string upload_id = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // A set of parameters common to Storage API requests concerning an object.
+  CommonObjectRequestParams common_object_request_params = 2;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 3;
+}
+
+// Response object for `ByteStream.QueryWriteStatus`.
+message QueryWriteStatusResponse {
+  // The number of bytes that have been processed for the given object.
+  int64 committed_size = 1;
+
+  // `complete` is `true` only if the client has sent a `InsertObjectRequest`
+  // with `finish_write` set to true, and the server has processed that request.
+  bool complete = 2;
+}
+
+// Request message for RewriteObject.
+message RewriteObjectRequest {
+  // Required. Name of the bucket in which to store the new object. Overrides the provided
+  // object metadata's `bucket` value, if any.
+  string destination_bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Name of the new object.
+  // Required when the object metadata is not otherwise provided. Overrides the
+  // object metadata's `name` value, if any.
+  string destination_object = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Resource name of the Cloud KMS key, of the form
+  // `projects/my-project/locations/my-location/keyRings/my-kr/cryptoKeys/my-key`,
+  // that will be used to encrypt the object. Overrides the object
+  // metadata's `kms_key_name` value, if any.
+  string destination_kms_key_name = 3;
+
+  // Apply a predefined set of access controls to the destination object.
+  CommonEnums.PredefinedObjectAcl destination_predefined_acl = 4;
+
+  // Makes the operation conditional on whether the object's current generation
+  // matches the given value. Setting to 0 makes the operation succeed only if
+  // there are no live versions of the object.
+  google.protobuf.Int64Value if_generation_match = 5;
+
+  // Makes the operation conditional on whether the object's current generation
+  // does not match the given value. If no live object exists, the precondition
+  // fails. Setting to 0 makes the operation succeed only if there is a live
+  // version of the object.
+  google.protobuf.Int64Value if_generation_not_match = 6;
+
+  // Makes the operation conditional on whether the destination object's current
+  // metageneration matches the given value.
+  google.protobuf.Int64Value if_metageneration_match = 7;
+
+  // Makes the operation conditional on whether the destination object's current
+  // metageneration does not match the given value.
+  google.protobuf.Int64Value if_metageneration_not_match = 8;
+
+  // Makes the operation conditional on whether the source object's current
+  // generation matches the given value.
+  google.protobuf.Int64Value if_source_generation_match = 9;
+
+  // Makes the operation conditional on whether the source object's current
+  // generation does not match the given value.
+  google.protobuf.Int64Value if_source_generation_not_match = 10;
+
+  // Makes the operation conditional on whether the source object's current
+  // metageneration matches the given value.
+  google.protobuf.Int64Value if_source_metageneration_match = 11;
+
+  // Makes the operation conditional on whether the source object's current
+  // metageneration does not match the given value.
+  google.protobuf.Int64Value if_source_metageneration_not_match = 12;
+
+  // The maximum number of bytes that will be rewritten per rewrite request.
+  // Most callers
+  // shouldn't need to specify this parameter - it is primarily in place to
+  // support testing. If specified the value must be an integral multiple of
+  // 1 MiB (1048576). Also, this only applies to requests where the source and
+  // destination span locations and/or storage classes. Finally, this value must
+  // not change across rewrite calls else you'll get an error that the
+  // `rewriteToken` is invalid.
+  int64 max_bytes_rewritten_per_call = 13;
+
+  // Set of properties to return. Defaults to `NO_ACL`, unless the
+  // object resource specifies the `acl` property, when it defaults
+  // to `full`.
+  CommonEnums.Projection projection = 14;
+
+  // Include this field (from the previous rewrite response) on each rewrite
+  // request after the first one, until the rewrite response 'done' flag is
+  // true. Calls that provide a rewriteToken can omit all other request fields,
+  // but if included those fields must match the values provided in the first
+  // rewrite request.
+  string rewrite_token = 15;
+
+  // Required. Name of the bucket in which to find the source object.
+  string source_bucket = 16 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Name of the source object.
+  string source_object = 17 [(google.api.field_behavior) = REQUIRED];
+
+  // If present, selects a specific revision of the source object (as opposed to
+  // the latest version, the default).
+  int64 source_generation = 18;
+
+  // Properties of the destination, post-rewrite object.
+  Object object = 20;
+
+  // The algorithm used to encrypt the source object, if any.
+  string copy_source_encryption_algorithm = 21;
+
+  // The encryption key used to encrypt the source object, if any.
+  string copy_source_encryption_key = 22;
+
+  // The SHA-256 hash of the key used to encrypt the source object, if any.
+  string copy_source_encryption_key_sha256 = 23;
+
+  // A set of parameters common to Storage API requests concerning an object.
+  CommonObjectRequestParams common_object_request_params = 24;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 25;
+}
+
+// A rewrite response.
+message RewriteResponse {
+  // The total bytes written so far, which can be used to provide a waiting user
+  // with a progress indicator. This property is always present in the response.
+  int64 total_bytes_rewritten = 1;
+
+  // The total size of the object being copied in bytes. This property is always
+  // present in the response.
+  int64 object_size = 2;
+
+  // `true` if the copy is finished; otherwise, `false` if
+  // the copy is in progress. This property is always present in the response.
+  bool done = 3;
+
+  // A token to use in subsequent requests to continue copying data. This token
+  // is present in the response only when there is more data to copy.
+  string rewrite_token = 4;
+
+  // A resource containing the metadata for the copied-to object. This property
+  // is present in the response only when copying completes.
+  Object resource = 5;
+}
+
+// Request message StartResumableWrite.
+message StartResumableWriteRequest {
+  // The destination bucket, object, and metadata, as well as any preconditions.
+  InsertObjectSpec insert_object_spec = 1;
+
+  // A set of parameters common to Storage API requests concerning an object.
+  CommonObjectRequestParams common_object_request_params = 3;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 4;
+}
+
+// Response object for ByteStream.StartResumableWrite.
+message StartResumableWriteResponse {
+  // The upload_id of the newly started resumable write operation. This
+  // value should be copied into the `InsertObjectRequest.upload_id` field.
+  string upload_id = 1;
+}
+
+// Request message for PatchObject.
+message PatchObjectRequest {
+  // Required. Name of the bucket in which the object resides.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Name of the object.
+  string object = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // If present, selects a specific revision of this object (as opposed to the
+  // latest version, the default).
+  int64 generation = 3;
+
+  // Makes the operation conditional on whether the object's current generation
+  // matches the given value. Setting to 0 makes the operation succeed only if
+  // there are no live versions of the object.
+  google.protobuf.Int64Value if_generation_match = 4;
+
+  // Makes the operation conditional on whether the object's current generation
+  // does not match the given value. If no live object exists, the precondition
+  // fails. Setting to 0 makes the operation succeed only if there is a live
+  // version of the object.
+  google.protobuf.Int64Value if_generation_not_match = 5;
+
+  // Makes the operation conditional on whether the object's current
+  // metageneration matches the given value.
+  google.protobuf.Int64Value if_metageneration_match = 6;
+
+  // Makes the operation conditional on whether the object's current
+  // metageneration does not match the given value.
+  google.protobuf.Int64Value if_metageneration_not_match = 7;
+
+  // Apply a predefined set of access controls to this object.
+  CommonEnums.PredefinedObjectAcl predefined_acl = 8;
+
+  // Set of properties to return. Defaults to `FULL`.
+  CommonEnums.Projection projection = 9;
+
+  // The Object metadata for updating.
+  Object metadata = 11;
+
+  // List of fields to be updated.
+  //
+  // To specify ALL fields, equivalent to the JSON API's "update" function,
+  // specify a single field with the value `*`. Note: not recommended. If a new
+  // field is introduced at a later time, an older client updating with the `*`
+  // may accidentally reset the new field's value.
+  //
+  // Not specifying any fields is an error.
+  // Not specifying a field while setting that field to a non-default value is
+  // an error.
+  google.protobuf.FieldMask update_mask = 12;
+
+  // A set of parameters common to Storage API requests concerning an object.
+  CommonObjectRequestParams common_object_request_params = 13;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 14;
+}
+
+// Request message for UpdateObject.
+message UpdateObjectRequest {
+  // Required. Name of the bucket in which the object resides.
+  string bucket = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Name of the object.
+  string object = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // If present, selects a specific revision of this object (as opposed to the
+  // latest version, the default).
+  int64 generation = 3;
+
+  // Makes the operation conditional on whether the object's current generation
+  // matches the given value. Setting to 0 makes the operation succeed only if
+  // there are no live versions of the object.
+  google.protobuf.Int64Value if_generation_match = 4;
+
+  // Makes the operation conditional on whether the object's current generation
+  // does not match the given value. If no live object exists, the precondition
+  // fails. Setting to 0 makes the operation succeed only if there is a live
+  // version of the object.
+  google.protobuf.Int64Value if_generation_not_match = 5;
+
+  // Makes the operation conditional on whether the object's current
+  // metageneration matches the given value.
+  google.protobuf.Int64Value if_metageneration_match = 6;
+
+  // Makes the operation conditional on whether the object's current
+  // metageneration does not match the given value.
+  google.protobuf.Int64Value if_metageneration_not_match = 7;
+
+  // Apply a predefined set of access controls to this object.
+  CommonEnums.PredefinedObjectAcl predefined_acl = 8;
+
+  // Set of properties to return. Defaults to `FULL`.
+  CommonEnums.Projection projection = 9;
+
+  // The Object metadata for updating.
+  Object metadata = 11;
+
+  // A set of parameters common to Storage API requests concerning an object.
+  CommonObjectRequestParams common_object_request_params = 12;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 13;
+}
+
+// Request message for WatchAllObjects.
+message WatchAllObjectsRequest {
+  // Name of the bucket in which to look for objects.
+  string bucket = 1;
+
+  // If `true`, lists all versions of an object as distinct results.
+  // The default is `false`. For more information, see
+  // [Object
+  // Versioning](https://cloud.google.com/storage/docs/object-versioning).
+  bool versions = 2;
+
+  // Returns results in a directory-like mode. `items` will contain
+  // only objects whose names, aside from the `prefix`, do not
+  // contain `delimiter`. Objects whose names, aside from the
+  // `prefix`, contain `delimiter` will have their name,
+  // truncated after the `delimiter`, returned in
+  // `prefixes`. Duplicate `prefixes` are omitted.
+  string delimiter = 3;
+
+  // Maximum number of `items` plus `prefixes` to return
+  // in a single page of responses. As duplicate `prefixes` are
+  // omitted, fewer total results may be returned than requested. The service
+  // will use this parameter or 1,000 items, whichever is smaller.
+  int32 max_results = 4;
+
+  // Filter results to objects whose names begin with this prefix.
+  string prefix = 5;
+
+  // If true, objects that end in exactly one instance of `delimiter`
+  // will have their metadata included in `items` in addition to
+  // `prefixes`.
+  bool include_trailing_delimiter = 6;
+
+  // A previously-returned page token representing part of the larger set of
+  // results to view.
+  string page_token = 7;
+
+  // Set of properties to return. Defaults to `NO_ACL`.
+  CommonEnums.Projection projection = 8;
+
+  // Properties of the channel to be inserted.
+  Channel channel = 10;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 11;
+}
+
+// Request message for GetProjectServiceAccount.
+message GetProjectServiceAccountRequest {
+  // Required. Project ID.
+  string project_id = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 3;
+}
+
+message CreateHmacKeyRequest {
+  // Required. The project that the HMAC-owning service account lives in.
+  string project_id = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The service account to create the HMAC for.
+  string service_account_email = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 3;
+}
+
+// Create hmac response.  The only time the secret for an HMAC will be returned.
+message CreateHmacKeyResponse {
+  // Key metadata.
+  HmacKeyMetadata metadata = 1;
+
+  // HMAC key secret material.
+  string secret = 2;
+}
+
+// Request object to delete a given HMAC key.
+message DeleteHmacKeyRequest {
+  // Required. The identifying key for the HMAC to delete.
+  string access_id = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The project id the HMAC key lies in.
+  string project_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 3;
+}
+
+// Request object to get metadata on a given HMAC key.
+message GetHmacKeyRequest {
+  // Required. The identifying key for the HMAC to delete.
+  string access_id = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The project id the HMAC key lies in.
+  string project_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 3;
+}
+
+// Request to fetch a list of HMAC keys under a given project.
+message ListHmacKeysRequest {
+  // Required. The project id to list HMAC keys for.
+  string project_id = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // An optional filter to only return HMAC keys for one service account.
+  string service_account_email = 2;
+
+  // An optional bool to return deleted keys that have not been wiped out yet.
+  bool show_deleted_keys = 3;
+
+  // The maximum number of keys to return.
+  int32 max_results = 4;
+
+  // A previously returned token from ListHmacKeysResponse to get the next page.
+  string page_token = 5;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 6;
+}
+
+// Hmac key list response with next page information.
+message ListHmacKeysResponse {
+  // The continuation token, used to page through large result sets. Provide
+  // this value in a subsequent request to return the next page of results.
+  string next_page_token = 1;
+
+  // The list of items.
+  repeated HmacKeyMetadata items = 2;
+}
+
+// Request object to update an HMAC key state.
+message UpdateHmacKeyRequest {
+  // Required. The id of the HMAC key.
+  string access_id = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The project id the HMAC's service account lies in.
+  string project_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The service account owner of the HMAC key.
+  HmacKeyMetadata metadata = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 5;
+}
+
+// A wrapper around the IAM get policy request to support our
+// common_request_params.
+message GetIamPolicyRequest {
+  // The request sent to IAM.
+  google.iam.v1.GetIamPolicyRequest iam_request = 1;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 2;
+}
+
+// A wrapper around the IAM set policy request to support our
+// common_request_params.
+message SetIamPolicyRequest {
+  // The request sent to IAM.
+  google.iam.v1.SetIamPolicyRequest iam_request = 1;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 2;
+}
+
+// A wrapper around the IAM test iam permissions request to support our
+// common_request_params.
+message TestIamPermissionsRequest {
+  // The request sent to IAM.
+  google.iam.v1.TestIamPermissionsRequest iam_request = 1;
+
+  // A set of parameters common to all Storage API requests.
+  CommonRequestParams common_request_params = 2;
+}
+
+// Parameters that can be passed to any object request.
+message CommonObjectRequestParams {
+  // Encryption algorithm used with Customer-Supplied Encryption Keys feature.
+  string encryption_algorithm = 1;
+
+  // Encryption key used with Customer-Supplied Encryption Keys feature.
+  string encryption_key = 2;
+
+  // SHA256 hash of encryption key used with Customer-Supplied Encryption Keys
+  // feature.
+  string encryption_key_sha256 = 3;
+}
+
+// Parameters that can be passed to any request.
+message CommonRequestParams {
+  // Required. Required when using buckets with Requestor Pays feature enabled.
+  string user_project = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Lets you enforce per-user quotas from a server-side application even in
+  // cases when the user's IP address is unknown. This can occur, for example,
+  // with applications that run cron jobs on App Engine on a user's behalf.
+  // You can choose any arbitrary string that uniquely identifies a user, but it
+  // is limited to 40 characters.
+  // Overrides user_ip if both are provided.
+  string quota_user = 2;
+
+  // Subset of fields to include in the response.
+  google.protobuf.FieldMask fields = 4;
+}
+
+// Shared constants.
+message ServiceConstants {
+  // A collection of constant values meaningful to the Storage API.
+  enum Values {
+    option allow_alias = true;
+
+    // Unused. Proto3 requires first enum to be 0.
+    VALUES_UNSPECIFIED = 0;
+
+    // The maximum size chunk that can will be returned in a single
+    // ReadRequest.
+    // 2 MiB.
+    MAX_READ_CHUNK_BYTES = 2097152;
+
+    // The maximum size chunk that can be sent in a single InsertObjectRequest.
+    // 2 MiB.
+    MAX_WRITE_CHUNK_BYTES = 2097152;
+
+    // The maximum size of an object in MB - whether written in a single stream
+    // or composed from multiple other objects.
+    // 5 TiB.
+    MAX_OBJECT_SIZE_MB = 5242880;
+
+    // The maximum length field name that can be sent in a single
+    // custom metadata field.
+    // 1 KiB.
+    MAX_CUSTOM_METADATA_FIELD_NAME_BYTES = 1024;
+
+    // The maximum length field value that can be sent in a single
+    // custom_metadata field.
+    // 4 KiB.
+    MAX_CUSTOM_METADATA_FIELD_VALUE_BYTES = 4096;
+
+    // The maximum total bytes that can be populated into all field names and
+    // values of the custom_metadata for one object.
+    // 8 KiB.
+    MAX_CUSTOM_METADATA_TOTAL_SIZE_BYTES = 8192;
+
+    // The maximum total bytes that can be populated into all bucket metadata
+    // fields.
+    // 20 KiB.
+    MAX_BUCKET_METADATA_TOTAL_SIZE_BYTES = 20480;
+
+    // The maximum number of NotificationConfigurations that can be registered
+    // for a given bucket.
+    MAX_NOTIFICATION_CONFIGS_PER_BUCKET = 100;
+
+    // The maximum number of LifecycleRules that can be registered for a given
+    // bucket.
+    MAX_LIFECYCLE_RULES_PER_BUCKET = 100;
+
+    // The maximum number of custom attributes per NotificationConfig.
+    MAX_NOTIFICATION_CUSTOM_ATTRIBUTES = 5;
+
+    // The maximum length of a custom attribute key included in
+    // NotificationConfig.
+    MAX_NOTIFICATION_CUSTOM_ATTRIBUTE_KEY_LENGTH = 256;
+
+    // The maximum length of a custom attribute value included in a
+    // NotificationConfig.
+    MAX_NOTIFICATION_CUSTOM_ATTRIBUTE_VALUE_LENGTH = 1024;
+
+    // The maximum number of key/value entries per bucket label.
+    MAX_LABELS_ENTRIES_COUNT = 64;
+
+    // The maximum character length of the key or value in a bucket
+    // label map.
+    MAX_LABELS_KEY_VALUE_LENGTH = 63;
+
+    // The maximum byte size of the key or value in a bucket label
+    // map.
+    MAX_LABELS_KEY_VALUE_BYTES = 128;
+
+    // The maximum number of object IDs that can be included in a
+    // DeleteObjectsRequest.
+    MAX_OBJECT_IDS_PER_DELETE_OBJECTS_REQUEST = 1000;
+
+    // The maximum number of days for which a token returned by the
+    // GetListObjectsSplitPoints RPC is valid.
+    SPLIT_TOKEN_MAX_VALID_DAYS = 14;
+  }
+
+
+}
diff --git a/third_party/googleapis/google/storage/v1/storage_gapic.yaml b/third_party/googleapis/google/storage/v1/storage_gapic.yaml
new file mode 100644
index 000000000..e8e4de287
--- /dev/null
+++ b/third_party/googleapis/google/storage/v1/storage_gapic.yaml
@@ -0,0 +1,21 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 2.0.0
+language_settings:
+  java:
+    package_name: com.google.cloud.google.storage.v1
+  # Note: We are launching the GCS gRPC API with only C++ and Java support, but
+  # settings for the other languages still must be present else the build_gen
+  # step will fail with NPE.
+  python:
+    package_name: google.cloud.storage_v1
+  go:
+    package_name: cloud.google.com/go/storage/apiv1
+  csharp:
+    package_name: Google.Cloud.Storage.V1
+  ruby:
+    package_name: Google::Cloud::Storage::V1
+  php:
+    package_name: Google\Cloud\Storage\V1
+  nodejs:
+    package_name: storage.v1
+    domain_layer_location: google-cloud
diff --git a/third_party/googleapis/google/storage/v1/storage_resources.proto b/third_party/googleapis/google/storage/v1/storage_resources.proto
new file mode 100644
index 000000000..45c0ce6ad
--- /dev/null
+++ b/third_party/googleapis/google/storage/v1/storage_resources.proto
@@ -0,0 +1,872 @@
+// Copyright 2020 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.storage.v1;
+
+import "google/protobuf/timestamp.proto";
+import "google/protobuf/wrappers.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/storage/v1;storage";
+option java_multiple_files = true;
+option java_outer_classname = "CloudStorageResourcesProto";
+option java_package = "com.google.storage.v1";
+
+// A bucket.
+message Bucket {
+  // Billing properties of a bucket.
+  message Billing {
+    // When set to true, Requester Pays is enabled for this bucket.
+    bool requester_pays = 1;
+  }
+
+  // Cross-Origin Response sharing (CORS) properties for a bucket.
+  // For more on GCS and CORS, see
+  // https://cloud.google.com/storage/docs/cross-origin.
+  // For more on CORS in general, see https://tools.ietf.org/html/rfc6454.
+  message Cors {
+    // The list of Origins eligible to receive CORS response headers. See
+    // [https://tools.ietf.org/html/rfc6454][RFC 6454] for more on origins.
+    // Note: "*" is permitted in the list of origins, and means "any Origin".
+    repeated string origin = 1;
+
+    // The list of HTTP methods on which to include CORS response headers,
+    // (`GET`, `OPTIONS`, `POST`, etc) Note: "*" is permitted in the list of
+    // methods, and means "any method".
+    repeated string method = 2;
+
+    // The list of HTTP headers other than the
+    // [https://www.w3.org/TR/cors/#simple-response-header][simple response
+    // headers] to give permission for the user-agent to share across domains.
+    repeated string response_header = 3;
+
+    // The value, in seconds, to return in the
+    // [https://www.w3.org/TR/cors/#access-control-max-age-response-header][Access-Control-Max-Age
+    // header] used in preflight responses.
+    int32 max_age_seconds = 4;
+  }
+
+  // Encryption properties of a bucket.
+  message Encryption {
+    // A Cloud KMS key that will be used to encrypt objects inserted into this
+    // bucket, if no encryption method is specified.
+    string default_kms_key_name = 1;
+  }
+
+  // Bucket restriction options currently enforced on the bucket.
+  message IamConfiguration {
+    message UniformBucketLevelAccess {
+      // If set, access checks only use bucket-level IAM policies or above.
+      bool enabled = 1;
+
+      // The deadline time for changing
+      // iamConfiguration.uniformBucketLevelAccess.enabled from
+      // true to false in [https://tools.ietf.org/html/rfc3339][RFC 3339]. After
+      // the deadline is passed the field is immutable.
+      google.protobuf.Timestamp locked_time = 2;
+    }
+
+    UniformBucketLevelAccess uniform_bucket_level_access = 1;
+  }
+
+  // Lifecycle properties of a bucket.
+  // For more information, see https://cloud.google.com/storage/docs/lifecycle.
+  message Lifecycle {
+    // A lifecycle Rule, combining an action to take on an object and a
+    // condition which will trigger that action.
+    message Rule {
+      // An action to take on an object.
+      message Action {
+        // Type of the action. Currently, only `Delete` and
+        // `SetStorageClass` are supported.
+        string type = 1;
+
+        // Target storage class. Required iff the type of the action is
+        // SetStorageClass.
+        string storage_class = 2;
+      }
+
+      // A condition of an object which triggers some action.
+      message Condition {
+        // Age of an object (in days). This condition is satisfied when an
+        // object reaches the specified age.
+        int32 age = 1;
+
+        // A date in [RFC 3339][1] format with only the date part (for
+        // instance, "2013-01-15"). This condition is satisfied when an
+        // object is created before midnight of the specified date in UTC.
+        // [1]: https://tools.ietf.org/html/rfc3339
+        google.protobuf.Timestamp created_before = 2;
+
+        // Relevant only for versioned objects. If the value is
+        // `true`, this condition matches live objects; if the value
+        // is `false`, it matches archived objects.
+        google.protobuf.BoolValue is_live = 3;
+
+        // Relevant only for versioned objects. If the value is N, this
+        // condition is satisfied when there are at least N versions (including
+        // the live version) newer than this version of the object.
+        int32 num_newer_versions = 4;
+
+        // Objects having any of the storage classes specified by this condition
+        // will be matched. Values include `MULTI_REGIONAL`, `REGIONAL`,
+        // `NEARLINE`, `COLDLINE`, `STANDARD`, and
+        // `DURABLE_REDUCED_AVAILABILITY`.
+        repeated string matches_storage_class = 5;
+
+        // A regular expression that satisfies the RE2 syntax. This condition is
+        // satisfied when the name of the object matches the RE2 pattern.  Note:
+        // This feature is currently in the "Early Access" launch stage and is
+        // only available to a whitelisted set of users; that means that this
+        // feature may be changed in backward-incompatible ways and that it is
+        // not guaranteed to be released.
+        string matches_pattern = 6;
+      }
+
+      // The action to take.
+      Action action = 1;
+
+      // The condition(s) under which the action will be taken.
+      Condition condition = 2;
+    }
+
+    // A lifecycle management rule, which is made of an action to take and the
+    // condition(s) under which the action will be taken.
+    repeated Rule rule = 1;
+  }
+
+  // Logging-related properties of a bucket.
+  message Logging {
+    // The destination bucket where the current bucket's logs should be placed.
+    string log_bucket = 1;
+
+    // A prefix for log object names.
+    string log_object_prefix = 2;
+  }
+
+  // Retention policy properties of a bucket.
+  message RetentionPolicy {
+    // Server-determined value that indicates the time from which policy was
+    // enforced and effective. This value is in
+    // [https://tools.ietf.org/html/rfc3339][RFC 3339] format.
+    google.protobuf.Timestamp effective_time = 1;
+
+    // Once locked, an object retention policy cannot be modified.
+    bool is_locked = 2;
+
+    // The duration in seconds that objects need to be retained. Retention
+    // duration must be greater than zero and less than 100 years. Note that
+    // enforcement of retention periods less than a day is not guaranteed. Such
+    // periods should only be used for testing purposes.
+    int64 retention_period = 3;
+  }
+
+  // Properties of a bucket related to versioning.
+  // For more on GCS versioning, see
+  // https://cloud.google.com/storage/docs/object-versioning.
+  message Versioning {
+    // While set to true, versioning is fully enabled for this bucket.
+    bool enabled = 1;
+  }
+
+  // Properties of a bucket related to accessing the contents as a static
+  // website. For more on hosting a static website via GCS, see
+  // https://cloud.google.com/storage/docs/hosting-static-website.
+  message Website {
+    // If the requested object path is missing, the service will ensure the path
+    // has a trailing '/', append this suffix, and attempt to retrieve the
+    // resulting object. This allows the creation of `index.html`
+    // objects to represent directory pages.
+    string main_page_suffix = 1;
+
+    // If the requested object path is missing, and any
+    // `mainPageSuffix` object is missing, if applicable, the service
+    // will return the named object from this bucket as the content for a
+    // [https://tools.ietf.org/html/rfc7231#section-6.5.4][404 Not Found]
+    // result.
+    string not_found_page = 2;
+  }
+
+  // Access controls on the bucket.
+  repeated BucketAccessControl acl = 1;
+
+  // Default access controls to apply to new objects when no ACL is provided.
+  repeated ObjectAccessControl default_object_acl = 2;
+
+  // The bucket's lifecycle configuration. See
+  // [https://developers.google.com/storage/docs/lifecycle]Lifecycle Management]
+  // for more information.
+  Lifecycle lifecycle = 3;
+
+  // The creation time of the bucket in
+  // [https://tools.ietf.org/html/rfc3339][RFC 3339] format.
+  // Attempting to set this field will result in an error.
+  google.protobuf.Timestamp time_created = 4;
+
+  // The ID of the bucket. For buckets, the `id` and `name` properties are the
+  // same.
+  // Attempting to update this field after the bucket is created will result in
+  // an error.
+  string id = 5;
+
+  // The name of the bucket.
+  // Attempting to update this field after the bucket is created will result in
+  // an error.
+  string name = 6;
+
+  // The project number of the project the bucket belongs to.
+  // Attempting to set this field will result in an error.
+  int64 project_number = 7;
+
+  // The metadata generation of this bucket.
+  // Attempting to set this field will result in an error.
+  int64 metageneration = 8;
+
+  // The bucket's [https://www.w3.org/TR/cors/][Cross-Origin Resource Sharing]
+  // (CORS) configuration.
+  repeated Cors cors = 9;
+
+  // The location of the bucket. Object data for objects in the bucket resides
+  // in physical storage within this region.  Defaults to `US`. See the
+  // [https://developers.google.com/storage/docs/concepts-techniques#specifyinglocations"][developer's
+  // guide] for the authoritative list. Attempting to update this field after
+  // the bucket is created will result in an error.
+  string location = 10;
+
+  // The bucket's default storage class, used whenever no storageClass is
+  // specified for a newly-created object. This defines how objects in the
+  // bucket are stored and determines the SLA and the cost of storage.
+  // If this value is not specified when the bucket is created, it will default
+  // to `STANDARD`. For more information, see
+  // https://developers.google.com/storage/docs/storage-classes.
+  string storage_class = 11;
+
+  // HTTP 1.1 [https://tools.ietf.org/html/rfc7232#section-2.3"]Entity tag]
+  // for the bucket.
+  // Attempting to set this field will result in an error.
+  string etag = 12;
+
+  // The modification time of the bucket.
+  // Attempting to set this field will result in an error.
+  google.protobuf.Timestamp updated = 13;
+
+  // The default value for event-based hold on newly created objects in this
+  // bucket.  Event-based hold is a way to retain objects indefinitely until an
+  // event occurs, signified by the
+  // hold's release. After being released, such objects will be subject to
+  // bucket-level retention (if any).  One sample use case of this flag is for
+  // banks to hold loan documents for at least 3 years after loan is paid in
+  // full. Here, bucket-level retention is 3 years and the event is loan being
+  // paid in full. In this example, these objects will be held intact for any
+  // number of years until the event has occurred (event-based hold on the
+  // object is released) and then 3 more years after that. That means retention
+  // duration of the objects begins from the moment event-based hold
+  // transitioned from true to false.  Objects under event-based hold cannot be
+  // deleted, overwritten or archived until the hold is removed.
+  bool default_event_based_hold = 14;
+
+  // User-provided labels, in key/value pairs.
+  map labels = 15;
+
+  // The bucket's website configuration, controlling how the service behaves
+  // when accessing bucket contents as a web site. See the
+  // [https://cloud.google.com/storage/docs/static-website][Static Website
+  // Examples] for more information.
+  Website website = 16;
+
+  // The bucket's versioning configuration.
+  Versioning versioning = 17;
+
+  // The bucket's logging configuration, which defines the destination bucket
+  // and optional name prefix for the current bucket's logs.
+  Logging logging = 18;
+
+  // The owner of the bucket. This is always the project team's owner group.
+  Owner owner = 19;
+
+  // Encryption configuration for a bucket.
+  Encryption encryption = 20;
+
+  // The bucket's billing configuration.
+  Billing billing = 21;
+
+  // The bucket's retention policy. The retention policy enforces a minimum
+  // retention time for all objects contained in the bucket, based on their
+  // creation time. Any attempt to overwrite or delete objects younger than the
+  // retention period will result in a PERMISSION_DENIED error.  An unlocked
+  // retention policy can be modified or removed from the bucket via a
+  // storage.buckets.update operation. A locked retention policy cannot be
+  // removed or shortened in duration for the lifetime of the bucket.
+  // Attempting to remove or decrease period of a locked retention policy will
+  // result in a PERMISSION_DENIED error.
+  RetentionPolicy retention_policy = 22;
+
+  // The location type of the bucket (region, dual-region, multi-region, etc).
+  string location_type = 23;
+
+  // The bucket's IAM configuration.
+  IamConfiguration iam_configuration = 24;
+
+  // The zone or zones from which the bucket is intended to use zonal quota.
+  // Requests for data from outside the specified affinities are still allowed
+  // but won’t be able to use zonal quota. The values are case-insensitive.
+  // Attempting to update this field after bucket is created will result in an
+  // error.
+  repeated string zone_affinity = 25;
+}
+
+// An access-control entry.
+message BucketAccessControl {
+  // The access permission for the entity.
+  string role = 1;
+
+  // HTTP 1.1 ["https://tools.ietf.org/html/rfc7232#section-2.3][Entity tag]
+  // for the access-control entry.
+  string etag = 2;
+
+  // The ID of the access-control entry.
+  string id = 3;
+
+  // The name of the bucket.
+  string bucket = 4;
+
+  // The entity holding the permission, in one of the following forms:
+  // * `user-{userid}`
+  // * `user-{email}`
+  // * `group-{groupid}`
+  // * `group-{email}`
+  // * `domain-{domain}`
+  // * `project-{team-projectid}`
+  // * `allUsers`
+  // * `allAuthenticatedUsers`
+  // Examples:
+  // * The user `liz@example.com` would be `user-liz@example.com`.
+  // * The group `example@googlegroups.com` would be
+  // `group-example@googlegroups.com`
+  // * All members of the Google Apps for Business domain `example.com` would be
+  // `domain-example.com`
+  string entity = 6;
+
+  // The ID for the entity, if any.
+  string entity_id = 7;
+
+  // The email address associated with the entity, if any.
+  string email = 8;
+
+  // The domain associated with the entity, if any.
+  string domain = 9;
+
+  // The project team associated with the entity, if any.
+  ProjectTeam project_team = 10;
+}
+
+// The response to a call to BucketAccessControls.ListBucketAccessControls.
+message ListBucketAccessControlsResponse {
+  // The list of items.
+  repeated BucketAccessControl items = 1;
+}
+
+// The result of a call to Buckets.ListBuckets
+message ListBucketsResponse {
+  // The list of items.
+  repeated Bucket items = 1;
+
+  // The continuation token, used to page through large result sets. Provide
+  // this value in a subsequent request to return the next page of results.
+  string next_page_token = 2;
+}
+
+// An notification channel used to watch for resource changes.
+message Channel {
+  // A UUID or similar unique string that identifies this channel.
+  string id = 1;
+
+  // An opaque ID that identifies the resource being watched on this channel.
+  // Stable across different API versions.
+  string resource_id = 2;
+
+  // A version-specific identifier for the watched resource.
+  string resource_uri = 3;
+
+  // An arbitrary string delivered to the target address with each notification
+  // delivered over this channel. Optional.
+  string token = 4;
+
+  // Date and time of notification channel expiration. Optional.
+  google.protobuf.Timestamp expiration = 5;
+
+  // The type of delivery mechanism used for this channel.
+  string type = 6;
+
+  // The address where notifications are delivered for this channel.
+  string address = 7;
+
+  // Additional parameters controlling delivery channel behavior. Optional.
+  map params = 8;
+
+  // A Boolean value to indicate whether payload is wanted. Optional.
+  bool payload = 9;
+}
+
+// The result of a call to Channels.ListChannels
+message ListChannelsResponse {
+  message Items {
+    // User-specified name for a channel. Needed to unsubscribe.
+    string channel_id = 1;
+
+    // Opaque value generated by GCS representing a bucket. Needed to
+    // unsubscribe.
+    string resource_id = 2;
+
+    // Url used to identify where notifications are sent to.
+    string push_url = 3;
+
+    // Email address of the subscriber.
+    string subscriber_email = 4;
+
+    // Time when the channel was created.
+    google.protobuf.Timestamp creation_time = 5;
+  }
+
+  // The list of notification channels for a bucket.
+  repeated Items items = 1;
+}
+
+// Message used to convey content being read or written, along with its
+// checksum.
+message ChecksummedData {
+  // The data.
+  bytes content = 1;
+
+  // CRC32C digest of the contents.
+  google.protobuf.UInt32Value crc32c = 2;
+}
+
+// Message used for storing full (not subrange) object checksums.
+message ObjectChecksums {
+  // CRC32C digest of the object data. Computed by the GCS service for
+  // all written objects, and validated by the GCS service against
+  // client-supplied values if present in an InsertObjectRequest.
+  google.protobuf.UInt32Value crc32c = 1;
+
+  // Hex-encoded MD5 hash of the object data (hexdigest). Whether/how this
+  // checksum is provided and validated is service-dependent.
+  string md5_hash = 2;
+}
+
+// A collection of enums used in multiple places throughout the API.
+message CommonEnums {
+  // A set of properties to return in a response.
+  enum Projection {
+    // No specified projection.
+    PROJECTION_UNSPECIFIED = 0;
+
+    // Omit `owner`, `acl`, and `defaultObjectAcl` properties.
+    NO_ACL = 1;
+
+    // Include all properties.
+    FULL = 2;
+  }
+
+  // Predefined or "canned" aliases for sets of specific bucket ACL entries.
+  enum PredefinedBucketAcl {
+    // No predefined ACL.
+    PREDEFINED_BUCKET_ACL_UNSPECIFIED = 0;
+
+    // Project team owners get `OWNER` access, and
+    // `allAuthenticatedUsers` get `READER` access.
+    BUCKET_ACL_AUTHENTICATED_READ = 1;
+
+    // Project team owners get `OWNER` access.
+    BUCKET_ACL_PRIVATE = 2;
+
+    // Project team members get access according to their roles.
+    BUCKET_ACL_PROJECT_PRIVATE = 3;
+
+    // Project team owners get `OWNER` access, and
+    // `allUsers` get `READER` access.
+    BUCKET_ACL_PUBLIC_READ = 4;
+
+    // Project team owners get `OWNER` access, and
+    // `allUsers` get `WRITER` access.
+    BUCKET_ACL_PUBLIC_READ_WRITE = 5;
+  }
+
+  // Predefined or "canned" aliases for sets of specific object ACL entries.
+  enum PredefinedObjectAcl {
+    // No predefined ACL.
+    PREDEFINED_OBJECT_ACL_UNSPECIFIED = 0;
+
+    // Object owner gets `OWNER` access, and
+    // `allAuthenticatedUsers` get `READER` access.
+    OBJECT_ACL_AUTHENTICATED_READ = 1;
+
+    // Object owner gets `OWNER` access, and project team owners get
+    // `OWNER` access.
+    OBJECT_ACL_BUCKET_OWNER_FULL_CONTROL = 2;
+
+    // Object owner gets `OWNER` access, and project team owners get
+    // `READER` access.
+    OBJECT_ACL_BUCKET_OWNER_READ = 3;
+
+    // Object owner gets `OWNER` access.
+    OBJECT_ACL_PRIVATE = 4;
+
+    // Object owner gets `OWNER` access, and project team members get
+    // access according to their roles.
+    OBJECT_ACL_PROJECT_PRIVATE = 5;
+
+    // Object owner gets `OWNER` access, and `allUsers`
+    // get `READER` access.
+    OBJECT_ACL_PUBLIC_READ = 6;
+  }
+
+
+}
+
+// Specifies a requested range of bytes to download.
+message ContentRange {
+  // The starting offset of the object data.
+  int64 start = 1;
+
+  // The ending offset of the object data.
+  int64 end = 2;
+
+  // The complete length of the object data.
+  int64 complete_length = 3;
+}
+
+// Hmac Key Metadata, which includes all information other than the secret.
+message HmacKeyMetadata {
+  // Resource name ID of the key in the format /.
+  string id = 1;
+
+  // Globally unique id for keys.
+  string access_id = 2;
+
+  // The project ID that the hmac key is contained in.
+  string project_id = 3;
+
+  // Email of the service account the key authenticates as.
+  string service_account_email = 4;
+
+  // State of the key. One of ACTIVE, INACTIVE, or DELETED.
+  string state = 5;
+
+  // The creation time of the HMAC key in RFC 3339 format.
+  google.protobuf.Timestamp time_created = 6;
+
+  // The last modification time of the HMAC key metadata in RFC 3339 format.
+  google.protobuf.Timestamp updated = 7;
+
+  // Tag updated with each key update.
+  string etag = 8;
+}
+
+// A subscription to receive Google PubSub notifications.
+message Notification {
+  // The Cloud PubSub topic to which this subscription publishes. Formatted as:
+  // '//pubsub.googleapis.com/projects/{project-identifier}/topics/{my-topic}'
+  string topic = 1;
+
+  // If present, only send notifications about listed event types. If empty,
+  // sent notifications for all event types.
+  repeated string event_types = 2;
+
+  // An optional list of additional attributes to attach to each Cloud PubSub
+  // message published for this notification subscription.
+  map custom_attributes = 3;
+
+  // HTTP 1.1 [https://tools.ietf.org/html/rfc7232#section-2.3][Entity tag]
+  // for this subscription notification.
+  string etag = 4;
+
+  // If present, only apply this notification configuration to object names that
+  // begin with this prefix.
+  string object_name_prefix = 5;
+
+  // The desired content of the Payload.
+  string payload_format = 6;
+
+  // The ID of the notification.
+  string id = 7;
+}
+
+// The result of a call to Notifications.ListNotifications
+message ListNotificationsResponse {
+  // The list of items.
+  repeated Notification items = 1;
+}
+
+// An object.
+message Object {
+  // Describes the customer-specified mechanism used to store the data at rest.
+  message CustomerEncryption {
+    // The encryption algorithm.
+    string encryption_algorithm = 1;
+
+    // SHA256 hash value of the encryption key.
+    string key_sha256 = 2;
+  }
+
+  // Content-Encoding of the object data, matching
+  // [https://tools.ietf.org/html/rfc7231#section-3.1.2.2][RFC 7231 §3.1.2.2]
+  string content_encoding = 1;
+
+  // Content-Disposition of the object data, matching
+  // [https://tools.ietf.org/html/rfc6266][RFC 6266].
+  string content_disposition = 2;
+
+  // Cache-Control directive for the object data, matching
+  // [https://tools.ietf.org/html/rfc7234#section-5.2"][RFC 7234 §5.2].
+  // If omitted, and the object is accessible to all anonymous users, the
+  // default will be `public, max-age=3600`.
+  string cache_control = 3;
+
+  // Access controls on the object.
+  repeated ObjectAccessControl acl = 4;
+
+  // Content-Language of the object data, matching
+  // [https://tools.ietf.org/html/rfc7231#section-3.1.3.2][RFC 7231 §3.1.3.2].
+  string content_language = 5;
+
+  // The version of the metadata for this object at this generation. Used for
+  // preconditions and for detecting changes in metadata. A metageneration
+  // number is only meaningful in the context of a particular generation of a
+  // particular object.
+  // Attempting to set this field will result in an error.
+  int64 metageneration = 6;
+
+  // The deletion time of the object. Will be returned if and only if this
+  // version of the object has been deleted.
+  // Attempting to set this field will result in an error.
+  google.protobuf.Timestamp time_deleted = 7;
+
+  // Content-Type of the object data, matching
+  // [https://tools.ietf.org/html/rfc7231#section-3.1.1.5][RFC 7231 §3.1.1.5].
+  // If an object is stored without a Content-Type, it is served as
+  // `application/octet-stream`.
+  string content_type = 8;
+
+  // Content-Length of the object data in bytes, matching
+  // [https://tools.ietf.org/html/rfc7230#section-3.3.2][RFC 7230 §3.3.2].
+  // Attempting to set this field will result in an error.
+  int64 size = 9;
+
+  // The creation time of the object.
+  // Attempting to set this field will result in an error.
+  google.protobuf.Timestamp time_created = 10;
+
+  // CRC32c checksum. For more information about using the CRC32c
+  // checksum, see
+  // [https://cloud.google.com/storage/docs/hashes-etags#_JSONAPI][Hashes and
+  // ETags: Best Practices]. This is a server determined value and should not be
+  // supplied by the user when sending an Object. The server will ignore any
+  // value provided. Users should instead use the object_checksums field on the
+  // InsertObjectRequest when uploading an object.
+  google.protobuf.UInt32Value crc32c = 11;
+
+  // Number of underlying components that make up this object. Components are
+  // accumulated by compose operations.
+  // Attempting to set this field will result in an error.
+  int32 component_count = 12;
+
+  // MD5 hash of the data; encoded using base64 as per
+  // [https://tools.ietf.org/html/rfc4648#section-4][RFC 4648 §4]. For more
+  // information about using the MD5 hash, see
+  // [https://cloud.google.com/storage/docs/hashes-etags#_JSONAPI][Hashes and
+  // ETags: Best Practices]. This is a server determined value and should not be
+  // supplied by the user when sending an Object. The server will ignore any
+  // value provided. Users should instead use the object_checksums field on the
+  // InsertObjectRequest when uploading an object.
+  string md5_hash = 13;
+
+  // HTTP 1.1 Entity tag for the object. See
+  // [https://tools.ietf.org/html/rfc7232#section-2.3][RFC 7232 §2.3].
+  // Attempting to set this field will result in an error.
+  string etag = 14;
+
+  // The modification time of the object metadata.
+  // Attempting to set this field will result in an error.
+  google.protobuf.Timestamp updated = 15;
+
+  // Storage class of the object.
+  string storage_class = 16;
+
+  // Cloud KMS Key used to encrypt this object, if the object is encrypted by
+  // such a key.
+  string kms_key_name = 17;
+
+  // The time at which the object's storage class was last changed. When the
+  // object is initially created, it will be set to time_created.
+  // Attempting to set this field will result in an error.
+  google.protobuf.Timestamp time_storage_class_updated = 18;
+
+  // Whether an object is under temporary hold. While this flag is set to true,
+  // the object is protected against deletion and overwrites.  A common use case
+  // of this flag is regulatory investigations where objects need to be retained
+  // while the investigation is ongoing. Note that unlike event-based hold,
+  // temporary hold does not impact retention expiration time of an object.
+  bool temporary_hold = 19;
+
+  // A server-determined value that specifies the earliest time that the
+  // object's retention period expires. This value is in
+  // [https://tools.ietf.org/html/rfc3339][RFC 3339] format.
+  // Note 1: This field is not provided for objects with an active event-based
+  // hold, since retention expiration is unknown until the hold is removed.
+  // Note 2: This value can be provided even when temporary hold is set (so that
+  // the user can reason about policy without having to first unset the
+  // temporary hold).
+  google.protobuf.Timestamp retention_expiration_time = 20;
+
+  // User-provided metadata, in key/value pairs.
+  map metadata = 21;
+
+  // Whether an object is under event-based hold. Event-based hold is a way to
+  // retain objects until an event occurs, which is signified by the
+  // hold's release (i.e. this value is set to false). After being released (set
+  // to false), such objects will be subject to bucket-level retention (if any).
+  // One sample use case of this flag is for banks to hold loan documents for at
+  // least 3 years after loan is paid in full. Here, bucket-level retention is 3
+  // years and the event is the loan being paid in full. In this example, these
+  // objects will be held intact for any number of years until the event has
+  // occurred (event-based hold on the object is released) and then 3 more years
+  // after that. That means retention duration of the objects begins from the
+  // moment event-based hold transitioned from true to false.
+  google.protobuf.BoolValue event_based_hold = 29;
+
+  // The name of the object.
+  // Attempting to update this field after the object is created will result in
+  // an error.
+  string name = 23;
+
+  // The ID of the object, including the bucket name, object name, and
+  // generation number.
+  // Attempting to update this field after the object is created will result in
+  // an error.
+  string id = 24;
+
+  // The name of the bucket containing this object.
+  // Attempting to update this field after the object is created will result in
+  // an error.
+  string bucket = 25;
+
+  // The content generation of this object. Used for object versioning.
+  // Attempting to set this field will result in an error.
+  int64 generation = 26;
+
+  // The owner of the object. This will always be the uploader of the object.
+  // Attempting to set this field will result in an error.
+  Owner owner = 27;
+
+  // Metadata of customer-supplied encryption key, if the object is encrypted by
+  // such a key.
+  CustomerEncryption customer_encryption = 28;
+}
+
+// An access-control entry.
+message ObjectAccessControl {
+  // The access permission for the entity.
+  string role = 1;
+
+  // HTTP 1.1 Entity tag for the access-control entry.
+  // See [https://tools.ietf.org/html/rfc7232#section-2.3][RFC 7232 §2.3].
+  string etag = 2;
+
+  // The ID of the access-control entry.
+  string id = 3;
+
+  // The name of the bucket.
+  string bucket = 4;
+
+  // The name of the object, if applied to an object.
+  string object = 5;
+
+  // The content generation of the object, if applied to an object.
+  int64 generation = 6;
+
+  // The entity holding the permission, in one of the following forms:
+  // * `user-{userid}`
+  // * `user-{email}`
+  // * `group-{groupid}`
+  // * `group-{email}`
+  // * `domain-{domain}`
+  // * `project-{team-projectid}`
+  // * `allUsers`
+  // * `allAuthenticatedUsers`
+  // Examples:
+  // * The user `liz@example.com` would be `user-liz@example.com`.
+  // * The group `example@googlegroups.com` would be
+  // `group-example@googlegroups.com`.
+  // * All members of the Google Apps for Business domain `example.com` would be
+  // `domain-example.com`.
+  string entity = 7;
+
+  // The ID for the entity, if any.
+  string entity_id = 8;
+
+  // The email address associated with the entity, if any.
+  string email = 9;
+
+  // The domain associated with the entity, if any.
+  string domain = 10;
+
+  // The project team associated with the entity, if any.
+  ProjectTeam project_team = 11;
+}
+
+// The result of a call to ObjectAccessControls.ListObjectAccessControls.
+message ListObjectAccessControlsResponse {
+  // The list of items.
+  repeated ObjectAccessControl items = 1;
+}
+
+// The result of a call to Objects.ListObjects
+message ListObjectsResponse {
+  // The list of prefixes of objects matching-but-not-listed up to and including
+  // the requested delimiter.
+  repeated string prefixes = 1;
+
+  // The list of items.
+  repeated Object items = 2;
+
+  // The continuation token, used to page through large result sets. Provide
+  // this value in a subsequent request to return the next page of results.
+  string next_page_token = 3;
+}
+
+// Represents the Viewers, Editors, or Owners of a given project.
+message ProjectTeam {
+  // The project number.
+  string project_number = 1;
+
+  // The team.
+  string team = 2;
+}
+
+// A subscription to receive Google PubSub notifications.
+message ServiceAccount {
+  // The ID of the notification.
+  string email_address = 1;
+}
+
+// The owner of a specific resource.
+message Owner {
+  // The entity, in the form `user-`*userId*.
+  string entity = 1;
+
+  // The ID for the entity.
+  string entity_id = 2;
+}
diff --git a/third_party/googleapis/google/storage/v1/storage_service_config.json b/third_party/googleapis/google/storage/v1/storage_service_config.json
new file mode 100644
index 000000000..75ee215d7
--- /dev/null
+++ b/third_party/googleapis/google/storage/v1/storage_service_config.json
@@ -0,0 +1,15 @@
+{
+  "methodConfig": [{
+    "name": [{ "service": "google.storage.v1.Storage"}],
+    "timeout": "60s",
+    "retryPolicy": {
+      "maxAttempts": 5,
+      "initialBackoff": "1s",
+      "maxBackoff": "60s",
+      "backoffMultiplier": 2,
+      "retryableStatusCodes": [
+        "DEADLINE_EXCEEDED", "UNAVAILABLE"
+      ]
+    }
+  }]
+}
diff --git a/third_party/googleapis/google/storage/v1/storage_v1.yaml b/third_party/googleapis/google/storage/v1/storage_v1.yaml
new file mode 100644
index 000000000..95c36ab19
--- /dev/null
+++ b/third_party/googleapis/google/storage/v1/storage_v1.yaml
@@ -0,0 +1,32 @@
+type: google.api.Service
+config_version: 3
+name: storage.googleapis.com
+title: Cloud Storage API
+
+apis:
+- name: google.storage.v1.Storage
+
+enums:
+- name: google.storage.v1.ServiceConstants.Values
+
+documentation:
+  summary: 'Lets you store and retrieve potentially-large, immutable data objects.'
+  overview: |-
+    The Google Cloud Storage API allows applications to read and write data
+    through the abstractions of buckets and objects, which are similar to
+    directories and files except that buckets cannot contain other buckets,
+    and directory-level operations (like directory rename) are not supported.
+    Buckets share a single global namespace, and each bucket belongs to a
+    specific project that has an associated owner that pays for the data
+    stored in the bucket. This API is accessed using standard gRPC requests.
+
+authentication:
+  rules:
+  - selector: 'google.storage.v1.Storage.*'
+    oauth:
+      canonical_scopes: |-
+        https://www.googleapis.com/auth/cloud-platform,
+        https://www.googleapis.com/auth/cloud-platform.read-only,
+        https://www.googleapis.com/auth/devstorage.full_control,
+        https://www.googleapis.com/auth/devstorage.read_only,
+        https://www.googleapis.com/auth/devstorage.read_write
diff --git a/third_party/googleapis/google/streetview/publish/BUILD.bazel b/third_party/googleapis/google/streetview/publish/BUILD.bazel
new file mode 100644
index 000000000..a87c57fec
--- /dev/null
+++ b/third_party/googleapis/google/streetview/publish/BUILD.bazel
@@ -0,0 +1 @@
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/google/streetview/publish/v1/BUILD.bazel b/third_party/googleapis/google/streetview/publish/v1/BUILD.bazel
new file mode 100644
index 000000000..13abbcdcc
--- /dev/null
+++ b/third_party/googleapis/google/streetview/publish/v1/BUILD.bazel
@@ -0,0 +1,366 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "publish_proto",
+    srcs = [
+        "resources.proto",
+        "rpcmessages.proto",
+        "streetview_publish.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/rpc:status_proto",
+        "//google/type:latlng_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "publish_proto_with_info",
+    deps = [
+        ":publish_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "publish_java_proto",
+    deps = [":publish_proto"],
+)
+
+java_grpc_library(
+    name = "publish_java_grpc",
+    srcs = [":publish_proto"],
+    deps = [":publish_java_proto"],
+)
+
+java_gapic_library(
+    name = "publish_java_gapic",
+    src = ":publish_proto_with_info",
+    gapic_yaml = "//google/streetview/publish:streetview_publish_gapic.yaml",
+    package = "google.streetview.publish.v1",
+    service_yaml = "//google/streetview/publish:streetview_publish.yaml",
+    test_deps = [
+        ":publish_java_grpc",
+    ],
+    deps = [
+        ":publish_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "publish_java_gapic_test_suite",
+    test_classes = [
+        "com.google.streetview.publish.v1.StreetViewPublishServiceClientTest",
+    ],
+    runtime_deps = [":publish_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-streetview-publish-v1-java",
+    deps = [
+        ":publish_java_gapic",
+        ":publish_java_grpc",
+        ":publish_java_proto",
+        ":publish_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "publish_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/streetview/publish/v1",
+    protos = [":publish_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/rpc:status_go_proto",
+        "//google/type:latlng_go_proto",
+    ],
+)
+
+#go_gapic_library(
+#    name = "publish_go_gapic",
+#    src = ":publish_proto_with_info",
+#    gapic_yaml = "//google/streetview/publish:streetview_publish_gapic.yaml",
+#    importpath = "google.golang.org/api/streetviewpublish/v1",
+#    package = "google.streetview.publish.v1",
+#    service_yaml = "//google/streetview/publish:streetview_publish.yaml",
+#    deps = [
+#        ":publish_go_proto",
+#    ],
+#)
+#
+#go_test(
+#    name = "publish_go_gapic_test",
+#    srcs = [":publish_go_gapic_srcjar_test"],
+#    embed = [":publish_go_gapic"],
+#    importpath = "google.golang.org/api/streetviewpublish/v1",
+#)
+#
+## Open Source Packages
+#go_gapic_assembly_pkg(
+#    name = "gapi-cloud-streetview-publish-v1-go",
+#    deps = [
+#        ":publish_go_gapic",
+#        ":publish_go_gapic_srcjar-smoke-test.srcjar",
+#        ":publish_go_gapic_srcjar-test.srcjar",
+#        ":publish_go_proto",
+#    ],
+#)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "publish_moved_proto",
+    srcs = [":publish_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/rpc:status_proto",
+        "//google/type:latlng_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "publish_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":publish_moved_proto"],
+)
+
+py_grpc_library(
+    name = "publish_py_grpc",
+    srcs = [":publish_moved_proto"],
+    deps = [":publish_py_proto"],
+)
+
+py_gapic_library(
+    name = "publish_py_gapic",
+    src = ":publish_proto_with_info",
+    gapic_yaml = "//google/streetview/publish:streetview_publish_gapic.yaml",
+    package = "google.streetview.publish.v1",
+    service_yaml = "//google/streetview/publish:streetview_publish.yaml",
+    deps = [
+        ":publish_py_grpc",
+        ":publish_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "streetview-publish-v1-py",
+    deps = [
+        ":publish_py_gapic",
+        ":publish_py_grpc",
+        ":publish_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "publish_php_proto",
+    deps = [":publish_proto"],
+)
+
+php_grpc_library(
+    name = "publish_php_grpc",
+    srcs = [":publish_proto"],
+    deps = [":publish_php_proto"],
+)
+
+php_gapic_library(
+    name = "publish_php_gapic",
+    src = ":publish_proto_with_info",
+    gapic_yaml = "//google/streetview/publish:streetview_publish_gapic.yaml",
+    package = "google.streetview.publish.v1",
+    service_yaml = "//google/streetview/publish:streetview_publish.yaml",
+    deps = [
+        ":publish_php_grpc",
+        ":publish_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-streetview-publish-v1-php",
+    deps = [
+        ":publish_php_gapic",
+        ":publish_php_grpc",
+        ":publish_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "publish_nodejs_gapic",
+    src = ":publish_proto_with_info",
+    gapic_yaml = "//google/streetview/publish:streetview_publish_gapic.yaml",
+    package = "google.streetview.publish.v1",
+    service_yaml = "//google/streetview/publish:streetview_publish.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "streetview-publish-v1-nodejs",
+    deps = [
+        ":publish_nodejs_gapic",
+        ":publish_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "publish_ruby_proto",
+    deps = [":publish_proto"],
+)
+
+ruby_grpc_library(
+    name = "publish_ruby_grpc",
+    srcs = [":publish_proto"],
+    deps = [":publish_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "publish_ruby_gapic",
+    src = ":publish_proto_with_info",
+    gapic_yaml = "//google/streetview/publish:streetview_publish_gapic.yaml",
+    package = "google.streetview.publish.v1",
+    service_yaml = "//google/streetview/publish:streetview_publish.yaml",
+    deps = [
+        ":publish_ruby_grpc",
+        ":publish_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-streetview-publish-v1-ruby",
+    deps = [
+        ":publish_ruby_gapic",
+        ":publish_ruby_grpc",
+        ":publish_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "publish_csharp_proto",
+    deps = [":publish_proto"],
+)
+
+csharp_grpc_library(
+    name = "publish_csharp_grpc",
+    srcs = [":publish_proto"],
+    deps = [":publish_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "publish_csharp_gapic",
+    src = ":publish_proto_with_info",
+    gapic_yaml = "//google/streetview/publish:streetview_publish_gapic.yaml",
+    package = "google.streetview.publish.v1",
+    service_yaml = "//google/streetview/publish:streetview_publish.yaml",
+    deps = [
+        ":publish_csharp_grpc",
+        ":publish_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-streetview-publish-v1-csharp",
+    deps = [
+        ":publish_csharp_gapic",
+        ":publish_csharp_grpc",
+        ":publish_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/google/type/BUILD.bazel b/third_party/googleapis/google/type/BUILD.bazel
index df40256a1..3a870be66 100644
--- a/third_party/googleapis/google/type/BUILD.bazel
+++ b/third_party/googleapis/google/type/BUILD.bazel
@@ -1,3 +1,5 @@
+load("@rules_proto//proto:defs.bzl", "proto_library")
+
 # This is an API workspace, having public visibility by default makes perfect sense.
 package(default_visibility = ["//visibility:public"])
 
@@ -22,6 +24,14 @@ proto_library(
     srcs = ["date.proto"],
 )
 
+proto_library(
+    name = "datetime_proto",
+    srcs = ["datetime.proto"],
+    deps = [
+        "@com_google_protobuf//:duration_proto",
+    ],
+)
+
 proto_library(
     name = "dayofweek_proto",
     srcs = ["dayofweek.proto"],
@@ -107,6 +117,12 @@ go_proto_library(
     protos = [":date_proto"],
 )
 
+go_proto_library(
+    name = "datetime_go_proto",
+    importpath = "google.golang.org/genproto/googleapis/type/date",
+    protos = [":datetime_proto"],
+)
+
 go_proto_library(
     name = "dayofweek_go_proto",
     importpath = "google.golang.org/genproto/googleapis/type/dayofweek",
diff --git a/third_party/googleapis/google/type/calendar_period.proto b/third_party/googleapis/google/type/calendar_period.proto
index 455b4c364..a91d0c35c 100644
--- a/third_party/googleapis/google/type/calendar_period.proto
+++ b/third_party/googleapis/google/type/calendar_period.proto
@@ -23,7 +23,6 @@ option java_outer_classname = "CalendarPeriodProto";
 option java_package = "com.google.type";
 option objc_class_prefix = "GTP";
 
-
 // A `CalendarPeriod` represents the abstract concept of a time period that has
 // a canonical start. Grammatically, "the start of the current
 // `CalendarPeriod`." All calendar times begin at midnight UTC.
diff --git a/third_party/googleapis/google/type/color.proto b/third_party/googleapis/google/type/color.proto
index 7982c8b05..417f1c4b1 100644
--- a/third_party/googleapis/google/type/color.proto
+++ b/third_party/googleapis/google/type/color.proto
@@ -26,7 +26,6 @@ option java_outer_classname = "ColorProto";
 option java_package = "com.google.type";
 option objc_class_prefix = "GTP";
 
-
 // Represents a color in the RGBA color space. This representation is designed
 // for simplicity of conversion to/from color representations in various
 // languages over compactness; for example, the fields of this representation
diff --git a/third_party/googleapis/google/type/date.proto b/third_party/googleapis/google/type/date.proto
index 630f620be..b958feeba 100644
--- a/third_party/googleapis/google/type/date.proto
+++ b/third_party/googleapis/google/type/date.proto
@@ -24,7 +24,6 @@ option java_outer_classname = "DateProto";
 option java_package = "com.google.type";
 option objc_class_prefix = "GTP";
 
-
 // Represents a whole or partial calendar date, e.g. a birthday. The time of day
 // and time zone are either specified elsewhere or are not significant. The date
 // is relative to the Proleptic Gregorian Calendar. This can represent:
diff --git a/third_party/googleapis/google/type/datetime.proto b/third_party/googleapis/google/type/datetime.proto
new file mode 100644
index 000000000..5aebc4b97
--- /dev/null
+++ b/third_party/googleapis/google/type/datetime.proto
@@ -0,0 +1,97 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.type;
+
+import "google/protobuf/duration.proto";
+
+option cc_enable_arenas = true;
+option go_package = "google.golang.org/genproto/googleapis/type/datetime;datetime";
+option java_multiple_files = true;
+option java_outer_classname = "DateTimeProto";
+option java_package = "com.google.type";
+option objc_class_prefix = "GTP";
+
+// Represents civil time in one of a few possible ways:
+//
+//  * When utc_offset is set and time_zone is unset: a civil time on a calendar
+//    day with a particular offset from UTC.
+//  * When time_zone is set and utc_offset is unset: a civil time on a calendar
+//    day in a particular time zone.
+//  * When neither time_zone nor utc_offset is set: a civil time on a calendar
+//    day in local time.
+//
+// The date is relative to the Proleptic Gregorian Calendar.
+//
+// If year is 0, the DateTime is considered not to have a specific year. month
+// and day must have valid, non-zero values.
+//
+// This type is more flexible than some applications may want. Make sure to
+// document and validate your application's limitations.
+message DateTime {
+  // Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a
+  // datetime without a year.
+  int32 year = 1;
+
+  // Required. Month of year. Must be from 1 to 12.
+  int32 month = 2;
+
+  // Required. Day of month. Must be from 1 to 31 and valid for the year and
+  // month.
+  int32 day = 3;
+
+  // Required. Hours of day in 24 hour format. Should be from 0 to 23. An API
+  // may choose to allow the value "24:00:00" for scenarios like business
+  // closing time.
+  int32 hours = 4;
+
+  // Required. Minutes of hour of day. Must be from 0 to 59.
+  int32 minutes = 5;
+
+  // Required. Seconds of minutes of the time. Must normally be from 0 to 59. An
+  // API may allow the value 60 if it allows leap-seconds.
+  int32 seconds = 6;
+
+  // Required. Fractions of seconds in nanoseconds. Must be from 0 to
+  // 999,999,999.
+  int32 nanos = 7;
+
+  // Optional. Specifies either the UTC offset or the time zone of the DateTime.
+  // Choose carefully between them, considering that time zone data may change
+  // in the future (for example, a country modifies their DST start/end dates,
+  // and future DateTimes in the affected range had already been stored).
+  // If omitted, the DateTime is considered to be in local time.
+  oneof time_offset {
+    // UTC offset. Must be whole seconds, between -18 hours and +18 hours.
+    // For example, a UTC offset of -4:00 would be represented as
+    // { seconds: -14400 }.
+    google.protobuf.Duration utc_offset = 8;
+
+    // Time zone.
+    TimeZone time_zone = 9;
+  }
+}
+
+// Represents a time zone from the
+// [IANA Time Zone Database](https://www.iana.org/time-zones).
+message TimeZone {
+  // IANA Time Zone Database time zone, e.g. "America/New_York".
+  string id = 1;
+
+  // Optional. IANA Time Zone Database version number, e.g. "2019a".
+  string version = 2;
+}
diff --git a/third_party/googleapis/google/type/dayofweek.proto b/third_party/googleapis/google/type/dayofweek.proto
index 951ec247e..7544e1516 100644
--- a/third_party/googleapis/google/type/dayofweek.proto
+++ b/third_party/googleapis/google/type/dayofweek.proto
@@ -23,7 +23,6 @@ option java_outer_classname = "DayOfWeekProto";
 option java_package = "com.google.type";
 option objc_class_prefix = "GTP";
 
-
 // Represents a day of week.
 enum DayOfWeek {
   // The unspecified day-of-week.
diff --git a/third_party/googleapis/google/type/expr.proto b/third_party/googleapis/google/type/expr.proto
index 444742513..5d4f2f71b 100644
--- a/third_party/googleapis/google/type/expr.proto
+++ b/third_party/googleapis/google/type/expr.proto
@@ -23,7 +23,6 @@ option java_outer_classname = "ExprProto";
 option java_package = "com.google.type";
 option objc_class_prefix = "GTP";
 
-
 // Represents an expression text. Example:
 //
 //     title: "User account presence"
diff --git a/third_party/googleapis/google/type/fraction.proto b/third_party/googleapis/google/type/fraction.proto
index 031518884..8ad008dda 100644
--- a/third_party/googleapis/google/type/fraction.proto
+++ b/third_party/googleapis/google/type/fraction.proto
@@ -23,7 +23,6 @@ option java_outer_classname = "FractionProto";
 option java_package = "com.google.type";
 option objc_class_prefix = "GTP";
 
-
 // Represents a fraction in terms of a numerator divided by a denominator.
 message Fraction {
   // The portion of the denominator in the faction, e.g. 2 in 2/3.
diff --git a/third_party/googleapis/google/type/latlng.proto b/third_party/googleapis/google/type/latlng.proto
index 8aec8c0a0..e5d45f1eb 100644
--- a/third_party/googleapis/google/type/latlng.proto
+++ b/third_party/googleapis/google/type/latlng.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -24,7 +23,6 @@ option java_outer_classname = "LatLngProto";
 option java_package = "com.google.type";
 option objc_class_prefix = "GTP";
 
-
 // An object representing a latitude/longitude pair. This is expressed as a pair
 // of doubles representing degrees latitude and degrees longitude. Unless
 // specified otherwise, this must conform to the
diff --git a/third_party/googleapis/google/type/money.proto b/third_party/googleapis/google/type/money.proto
index dd39c540c..ef41f1089 100644
--- a/third_party/googleapis/google/type/money.proto
+++ b/third_party/googleapis/google/type/money.proto
@@ -24,7 +24,6 @@ option java_outer_classname = "MoneyProto";
 option java_package = "com.google.type";
 option objc_class_prefix = "GTP";
 
-
 // Represents an amount of money with its currency type.
 message Money {
   // The 3-letter currency code defined in ISO 4217.
diff --git a/third_party/googleapis/google/type/month.proto b/third_party/googleapis/google/type/month.proto
new file mode 100644
index 000000000..54b7865f4
--- /dev/null
+++ b/third_party/googleapis/google/type/month.proto
@@ -0,0 +1,66 @@
+// Copyright 2019 Google LLC.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+syntax = "proto3";
+
+package google.type;
+
+option go_package = "google.golang.org/genproto/googleapis/type/month;month";
+option java_multiple_files = true;
+option java_outer_classname = "MonthProto";
+option java_package = "com.google.type";
+option objc_class_prefix = "GTP";
+
+// Represents a month in the Gregorian calendar.
+enum Month {
+  // The unspecifed month.
+  MONTH_UNSPECIFIED = 0;
+
+  // The month of January.
+  JANUARY = 1;
+
+  // The month of February.
+  FEBRUARY = 2;
+
+  // The month of March.
+  MARCH = 3;
+
+  // The month of April.
+  APRIL = 4;
+
+  // The month of May.
+  MAY = 5;
+
+  // The month of June.
+  JUNE = 6;
+
+  // The month of July.
+  JULY = 7;
+
+  // The month of August.
+  AUGUST = 8;
+
+  // The month of September.
+  SEPTEMBER = 9;
+
+  // The month of October.
+  OCTOBER = 10;
+
+  // The month of November.
+  NOVEMBER = 11;
+
+  // The month of December.
+  DECEMBER = 12;
+}
diff --git a/third_party/googleapis/google/type/postal_address.proto b/third_party/googleapis/google/type/postal_address.proto
index f36150501..688af8a1b 100644
--- a/third_party/googleapis/google/type/postal_address.proto
+++ b/third_party/googleapis/google/type/postal_address.proto
@@ -1,4 +1,4 @@
-// Copyright 2016 Google Inc.
+// Copyright 2019 Google LLC.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,11 +11,13 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
+//
 
 syntax = "proto3";
 
 package google.type;
 
+option cc_enable_arenas = true;
 option go_package = "google.golang.org/genproto/googleapis/type/postaladdress;postaladdress";
 option java_multiple_files = true;
 option java_outer_classname = "PostalAddressProto";
@@ -40,7 +42,9 @@ option objc_class_prefix = "GTP";
 // For more guidance on how to use this schema, please see:
 // https://support.google.com/business/answer/6397478
 message PostalAddress {
-  // The schema revision of the `PostalAddress`.
+  // The schema revision of the `PostalAddress`. This must be set to 0, which is
+  // the latest revision.
+  //
   // All new revisions **must** be backward compatible with old revisions.
   int32 revision = 1;
 
diff --git a/third_party/googleapis/google/type/quaternion.proto b/third_party/googleapis/google/type/quaternion.proto
index 9d0d98e00..7ab5dc728 100644
--- a/third_party/googleapis/google/type/quaternion.proto
+++ b/third_party/googleapis/google/type/quaternion.proto
@@ -24,7 +24,6 @@ option java_outer_classname = "QuaternionProto";
 option java_package = "com.google.type";
 option objc_class_prefix = "GTP";
 
-
 // A quaternion is defined as the quotient of two directed lines in a
 // three-dimensional space or equivalently as the quotient of two Euclidean
 // vectors (https://en.wikipedia.org/wiki/Quaternion).
@@ -37,35 +36,35 @@ option objc_class_prefix = "GTP";
 //
 // Quaternions are generally represented in this form:
 //
-//   w + xi + yj + zk
+//     w + xi + yj + zk
 //
 // where x, y, z, and w are real numbers, and i, j, and k are three imaginary
 // numbers.
 //
-// Our naming choice (x, y, z, w) comes from the desire to avoid confusion for
+// Our naming choice `(x, y, z, w)` comes from the desire to avoid confusion for
 // those interested in the geometric properties of the quaternion in the 3D
 // Cartesian space. Other texts often use alternative names or subscripts, such
-// as (a, b, c, d), (1, i, j, k), or (0, 1, 2, 3), which are perhaps better
-// suited for mathematical interpretations.
+// as `(a, b, c, d)`, `(1, i, j, k)`, or `(0, 1, 2, 3)`, which are perhaps
+// better suited for mathematical interpretations.
 //
 // To avoid any confusion, as well as to maintain compatibility with a large
 // number of software libraries, the quaternions represented using the protocol
-// buffer below *must* follow the Hamilton convention, which defines ij = k
+// buffer below *must* follow the Hamilton convention, which defines `ij = k`
 // (i.e. a right-handed algebra), and therefore:
 //
-//   i^2 = j^2 = k^2 = ijk = −1
-//   ij = −ji = k
-//   jk = −kj = i
-//   ki = −ik = j
+//     i^2 = j^2 = k^2 = ijk = −1
+//     ij = −ji = k
+//     jk = −kj = i
+//     ki = −ik = j
 //
 // Please DO NOT use this to represent quaternions that follow the JPL
 // convention, or any of the other quaternion flavors out there.
 //
 // Definitions:
 //
-//   - Quaternion norm (or magnitude): sqrt(x^2 + y^2 + z^2 + w^2).
+//   - Quaternion norm (or magnitude): `sqrt(x^2 + y^2 + z^2 + w^2)`.
 //   - Unit (or normalized) quaternion: a quaternion whose norm is 1.
-//   - Pure quaternion: a quaternion whose scalar component (w) is 0.
+//   - Pure quaternion: a quaternion whose scalar component (`w`) is 0.
 //   - Rotation quaternion: a unit quaternion used to represent rotation.
 //   - Orientation quaternion: a unit quaternion used to represent orientation.
 //
@@ -75,13 +74,12 @@ option objc_class_prefix = "GTP";
 // quaternions, to avoid rounding errors:
 // https://en.wikipedia.org/wiki/Rotation_formalisms_in_three_dimensions
 //
-// Note that (x, y, z, w) and (-x, -y, -z, -w) represent the same rotation, but
-// normalization would be even more useful, e.g. for comparison purposes, if it
-// would produce a unique representation. It is thus recommended that w be kept
-// positive, which can be achieved by changing all the signs when w is negative.
-//
+// Note that `(x, y, z, w)` and `(-x, -y, -z, -w)` represent the same rotation,
+// but normalization would be even more useful, e.g. for comparison purposes, if
+// it would produce a unique representation. It is thus recommended that `w` be
+// kept positive, which can be achieved by changing all the signs when `w` is
+// negative.
 //
-// Next available tag: 5
 message Quaternion {
   // The x component.
   double x = 1;
diff --git a/third_party/googleapis/google/type/timeofday.proto b/third_party/googleapis/google/type/timeofday.proto
index b8d43122b..b609a4879 100644
--- a/third_party/googleapis/google/type/timeofday.proto
+++ b/third_party/googleapis/google/type/timeofday.proto
@@ -24,7 +24,6 @@ option java_outer_classname = "TimeOfDayProto";
 option java_package = "com.google.type";
 option objc_class_prefix = "GTP";
 
-
 // Represents a time of day. The date and time zone are either not significant
 // or are specified elsewhere. An API may choose to allow leap seconds. Related
 // types are [google.type.Date][google.type.Date] and `google.protobuf.Timestamp`.
diff --git a/third_party/googleapis/google/type/type.yaml b/third_party/googleapis/google/type/type.yaml
index 726216cbf..3c2e20e67 100644
--- a/third_party/googleapis/google/type/type.yaml
+++ b/third_party/googleapis/google/type/type.yaml
@@ -4,30 +4,34 @@ name: type.googleapis.com
 title: Common Types
 
 types:
-  - name: google.type.Color
-  - name: google.type.Date
-  - name: google.type.Expr
-  - name: google.type.Fraction
-  - name: google.type.LatLng
-  - name: google.type.Money
-  - name: google.type.PostalAddress
-  - name: google.type.Quaternion
-  - name: google.type.TimeOfDay
+- name: google.type.Color
+- name: google.type.Date
+- name: google.type.DateTime
+- name: google.type.Expr
+- name: google.type.Fraction
+- name: google.type.LatLng
+- name: google.type.Money
+- name: google.type.PostalAddress
+- name: google.type.Quaternion
+- name: google.type.TimeOfDay
+- name: google.type.TimeZone
 
 enums:
-  - name: google.type.CalendarPeriod
-  - name: google.type.DayOfWeek
+- name: google.type.CalendarPeriod
+- name: google.type.DayOfWeek
+- name: google.type.Month
 
 documentation:
   summary: Defines common types for Google APIs.
   overview: |-
     # Google Common Types
 
-    This package contains definitions of common types for Google APIs. All types
-    defined in this package are suitable for different APIs to exchange data,
-    and will never break binary compatibility. They should have design quality
-    comparable to major programming languages like Java and C#.
+    This package contains definitions of common types for Google APIs.
+    All types defined in this package are suitable for different APIs to
+    exchange data, and will never break binary compatibility. They should
+    have design quality comparable to major programming languages like
+    Java and C#.
 
-    NOTE: Some common types are defined in the package `google.protobuf` as they
-    are directly supported by Protocol Buffers compiler and runtime. Those types
-    are called Well-Known Types.
+    NOTE: Some common types are defined in the package `google.protobuf`
+    as they are directly supported by Protocol Buffers compiler and
+    runtime. Those types are called Well-Known Types.
diff --git a/third_party/googleapis/grafeas/BUILD.bazel b/third_party/googleapis/grafeas/BUILD.bazel
new file mode 100644
index 000000000..a87c57fec
--- /dev/null
+++ b/third_party/googleapis/grafeas/BUILD.bazel
@@ -0,0 +1 @@
+exports_files(glob(["*.yaml"]))
diff --git a/third_party/googleapis/grafeas/v1/BUILD.bazel b/third_party/googleapis/grafeas/v1/BUILD.bazel
new file mode 100644
index 000000000..125d8adc8
--- /dev/null
+++ b/third_party/googleapis/grafeas/v1/BUILD.bazel
@@ -0,0 +1,376 @@
+# This file was automatically generated by BuildFileGenerator
+
+# This is an API workspace, having public visibility by default makes perfect sense.
+package(default_visibility = ["//visibility:public"])
+
+##############################################################################
+# Common
+##############################################################################
+load("@rules_proto//proto:defs.bzl", "proto_library")
+load("@com_google_googleapis_imports//:imports.bzl", "proto_library_with_info")
+
+proto_library(
+    name = "grafeas_proto",
+    srcs = [
+        "attestation.proto",
+        "build.proto",
+        "common.proto",
+        "cvss.proto",
+        "deployment.proto",
+        "discovery.proto",
+        "grafeas.proto",
+        "image.proto",
+        "package.proto",
+        "provenance.proto",
+        "upgrade.proto",
+        "vulnerability.proto",
+    ],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/rpc:status_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+proto_library_with_info(
+    name = "grafeas_proto_with_info",
+    deps = [
+        ":grafeas_proto",
+        "//google/cloud:common_resources_proto",
+    ],
+)
+
+##############################################################################
+# Java
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "java_gapic_assembly_gradle_pkg",
+    "java_gapic_library",
+    "java_gapic_test",
+    "java_grpc_library",
+    "java_proto_library",
+)
+
+java_proto_library(
+    name = "grafeas_java_proto",
+    deps = [":grafeas_proto"],
+)
+
+java_grpc_library(
+    name = "grafeas_java_grpc",
+    srcs = [":grafeas_proto"],
+    deps = [":grafeas_java_proto"],
+)
+
+java_gapic_library(
+    name = "grafeas_java_gapic",
+    src = ":grafeas_proto_with_info",
+    gapic_yaml = "grafeas_gapic.yaml",
+    package = "grafeas.v1",
+    service_yaml = "//grafeas:grafeas_v1.yaml",
+    test_deps = [
+        ":grafeas_java_grpc",
+    ],
+    deps = [
+        ":grafeas_java_proto",
+    ],
+)
+
+java_gapic_test(
+    name = "grafeas_java_gapic_test_suite",
+    test_classes = [
+        "io.grafeas.v1.GrafeasClientTest",
+    ],
+    runtime_deps = [":grafeas_java_gapic_test"],
+)
+
+# Open Source Packages
+java_gapic_assembly_gradle_pkg(
+    name = "google-cloud-grafeas-v1-java",
+    deps = [
+        ":grafeas_java_gapic",
+        ":grafeas_java_grpc",
+        ":grafeas_java_proto",
+        ":grafeas_proto",
+    ],
+)
+
+##############################################################################
+# Go
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "go_gapic_assembly_pkg",
+    "go_gapic_library",
+    "go_proto_library",
+    "go_test",
+)
+
+go_proto_library(
+    name = "grafeas_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:go_grpc"],
+    importpath = "google.golang.org/genproto/googleapis/grafeas/v1",
+    protos = [":grafeas_proto"],
+    deps = [
+        "//google/api:annotations_go_proto",
+        "//google/rpc:status_go_proto",
+    ],
+)
+
+go_gapic_library(
+    name = "grafeas_go_gapic",
+    srcs = [":grafeas_proto_with_info"],
+    grpc_service_config = "grafeas_grpc_service_config.json",
+    importpath = "cloud.google.com/go/grafeas/apiv1;grafeas",
+    service_yaml = "//grafeas:grafeas_v1.yaml",
+    deps = [
+        ":grafeas_go_proto",
+    ],
+)
+
+go_test(
+    name = "grafeas_go_gapic_test",
+    srcs = [":grafeas_go_gapic_srcjar_test"],
+    embed = [":grafeas_go_gapic"],
+    importpath = "cloud.google.com/go/grafeas/apiv1",
+)
+
+# Open Source Packages
+go_gapic_assembly_pkg(
+    name = "gapi-cloud-grafeas-v1-go",
+    deps = [
+        ":grafeas_go_gapic",
+        ":grafeas_go_gapic_srcjar-test.srcjar",
+        ":grafeas_go_proto",
+    ],
+)
+
+##############################################################################
+# Python
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "moved_proto_library",
+    "py_gapic_assembly_pkg",
+    "py_gapic_library",
+    "py_grpc_library",
+    "py_proto_library",
+)
+
+moved_proto_library(
+    name = "grafeas_moved_proto",
+    srcs = [":grafeas_proto"],
+    deps = [
+        "//google/api:annotations_proto",
+        "//google/api:client_proto",
+        "//google/api:field_behavior_proto",
+        "//google/api:resource_proto",
+        "//google/rpc:status_proto",
+        "@com_google_protobuf//:empty_proto",
+        "@com_google_protobuf//:field_mask_proto",
+        "@com_google_protobuf//:timestamp_proto",
+    ],
+)
+
+py_proto_library(
+    name = "grafeas_py_proto",
+    plugin = "@protoc_docs_plugin//:docs_plugin",
+    deps = [":grafeas_moved_proto"],
+)
+
+py_grpc_library(
+    name = "grafeas_py_grpc",
+    srcs = [":grafeas_moved_proto"],
+    deps = [":grafeas_py_proto"],
+)
+
+py_gapic_library(
+    name = "grafeas_py_gapic",
+    src = ":grafeas_proto_with_info",
+    gapic_yaml = "grafeas_gapic.yaml",
+    package = "grafeas.v1",
+    service_yaml = "//grafeas:grafeas_v1.yaml",
+    deps = [
+        ":grafeas_py_grpc",
+        ":grafeas_py_proto",
+    ],
+)
+
+# Open Source Packages
+py_gapic_assembly_pkg(
+    name = "grafeas-v1-py",
+    deps = [
+        ":grafeas_py_gapic",
+        ":grafeas_py_grpc",
+        ":grafeas_py_proto",
+    ],
+)
+
+##############################################################################
+# PHP
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "php_gapic_assembly_pkg",
+    "php_gapic_library",
+    "php_grpc_library",
+    "php_proto_library",
+)
+
+php_proto_library(
+    name = "grafeas_php_proto",
+    deps = [":grafeas_proto"],
+)
+
+php_grpc_library(
+    name = "grafeas_php_grpc",
+    srcs = [":grafeas_proto"],
+    deps = [":grafeas_php_proto"],
+)
+
+php_gapic_library(
+    name = "grafeas_php_gapic",
+    src = ":grafeas_proto_with_info",
+    gapic_yaml = "grafeas_gapic.yaml",
+    package = "grafeas.v1",
+    service_yaml = "//grafeas:grafeas_v1.yaml",
+    deps = [
+        ":grafeas_php_grpc",
+        ":grafeas_php_proto",
+    ],
+)
+
+# Open Source Packages
+php_gapic_assembly_pkg(
+    name = "google-cloud-grafeas-v1-php",
+    deps = [
+        ":grafeas_php_gapic",
+        ":grafeas_php_grpc",
+        ":grafeas_php_proto",
+    ],
+)
+
+##############################################################################
+# Node.js
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "nodejs_gapic_assembly_pkg",
+    "nodejs_gapic_library",
+)
+
+nodejs_gapic_library(
+    name = "grafeas_nodejs_gapic",
+    src = ":grafeas_proto_with_info",
+    gapic_yaml = "grafeas_gapic.yaml",
+    package = "grafeas.v1",
+    service_yaml = "//grafeas:grafeas_v1.yaml",
+    deps = [],
+)
+
+nodejs_gapic_assembly_pkg(
+    name = "grafeas-v1-nodejs",
+    deps = [
+        ":grafeas_nodejs_gapic",
+        ":grafeas_proto",
+    ],
+)
+
+##############################################################################
+# Ruby
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "ruby_gapic_assembly_pkg",
+    "ruby_gapic_library",
+    "ruby_grpc_library",
+    "ruby_proto_library",
+)
+
+ruby_proto_library(
+    name = "grafeas_ruby_proto",
+    deps = [":grafeas_proto"],
+)
+
+ruby_grpc_library(
+    name = "grafeas_ruby_grpc",
+    srcs = [":grafeas_proto"],
+    deps = [":grafeas_ruby_proto"],
+)
+
+ruby_gapic_library(
+    name = "grafeas_ruby_gapic",
+    src = ":grafeas_proto_with_info",
+    gapic_yaml = "grafeas_gapic.yaml",
+    package = "grafeas.v1",
+    service_yaml = "//grafeas:grafeas_v1.yaml",
+    deps = [
+        ":grafeas_ruby_grpc",
+        ":grafeas_ruby_proto",
+    ],
+)
+
+# Open Source Packages
+ruby_gapic_assembly_pkg(
+    name = "google-cloud-grafeas-v1-ruby",
+    deps = [
+        ":grafeas_ruby_gapic",
+        ":grafeas_ruby_grpc",
+        ":grafeas_ruby_proto",
+    ],
+)
+
+##############################################################################
+# C#
+##############################################################################
+load(
+    "@com_google_googleapis_imports//:imports.bzl",
+    "csharp_gapic_assembly_pkg",
+    "csharp_gapic_library",
+    "csharp_grpc_library",
+    "csharp_proto_library",
+)
+
+csharp_proto_library(
+    name = "grafeas_csharp_proto",
+    deps = [":grafeas_proto"],
+)
+
+csharp_grpc_library(
+    name = "grafeas_csharp_grpc",
+    srcs = [":grafeas_proto"],
+    deps = [":grafeas_csharp_proto"],
+)
+
+csharp_gapic_library(
+    name = "grafeas_csharp_gapic",
+    src = ":grafeas_proto_with_info",
+    gapic_yaml = "grafeas_gapic.yaml",
+    package = "grafeas.v1",
+    service_yaml = "//grafeas:grafeas_v1.yaml",
+    deps = [
+        ":grafeas_csharp_grpc",
+        ":grafeas_csharp_proto",
+    ],
+)
+
+# Open Source Packages
+csharp_gapic_assembly_pkg(
+    name = "google-cloud-grafeas-v1-csharp",
+    deps = [
+        ":grafeas_csharp_gapic",
+        ":grafeas_csharp_grpc",
+        ":grafeas_csharp_proto",
+    ],
+)
+
+##############################################################################
+# C++
+##############################################################################
+# Put your C++ rules here
diff --git a/third_party/googleapis/grafeas/v1/common.proto b/third_party/googleapis/grafeas/v1/common.proto
index 846948a52..db780bb62 100644
--- a/third_party/googleapis/grafeas/v1/common.proto
+++ b/third_party/googleapis/grafeas/v1/common.proto
@@ -39,6 +39,8 @@ enum NoteKind {
   DISCOVERY = 6;
   // This represents a logical "role" that can attest to artifacts.
   ATTESTATION = 7;
+  // This represents an available package upgrade.
+  UPGRADE = 8;
 }
 
 // Metadata for any related URL information.
diff --git a/third_party/googleapis/grafeas/v1/discovery.proto b/third_party/googleapis/grafeas/v1/discovery.proto
index ba8034d38..e07992557 100644
--- a/third_party/googleapis/grafeas/v1/discovery.proto
+++ b/third_party/googleapis/grafeas/v1/discovery.proto
@@ -16,6 +16,7 @@ syntax = "proto3";
 
 package grafeas.v1;
 
+import "google/protobuf/timestamp.proto";
 import "google/rpc/status.proto";
 import "grafeas/v1/common.proto";
 
@@ -73,4 +74,10 @@ message DiscoveryOccurrence {
   // details to show to the user. The LocalizedMessage is output only and
   // populated by the API.
   google.rpc.Status analysis_status_error = 3;
+
+  // The CPE of the resource being scanned.
+  string cpe = 4;
+
+  // The last time this resource was scanned.
+  google.protobuf.Timestamp last_scan_time = 5;
 }
diff --git a/third_party/googleapis/grafeas/v1/grafeas.proto b/third_party/googleapis/grafeas/v1/grafeas.proto
index 1364b2aae..57b2fc23e 100644
--- a/third_party/googleapis/grafeas/v1/grafeas.proto
+++ b/third_party/googleapis/grafeas/v1/grafeas.proto
@@ -17,6 +17,9 @@ syntax = "proto3";
 package grafeas.v1;
 
 import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
 import "google/protobuf/timestamp.proto";
@@ -27,13 +30,17 @@ import "grafeas/v1/deployment.proto";
 import "grafeas/v1/discovery.proto";
 import "grafeas/v1/image.proto";
 import "grafeas/v1/package.proto";
-import "grafeas/v1/provenance.proto";
+import "grafeas/v1/upgrade.proto";
 import "grafeas/v1/vulnerability.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/grafeas/v1;grafeas";
 option java_multiple_files = true;
 option java_package = "io.grafeas.v1";
 option objc_class_prefix = "GRA";
+option (google.api.resource_definition) = {
+  type: "grafeas.io/Project"
+  pattern: "projects/{project}"
+};
 
 // [Grafeas](https://grafeas.io) API.
 //
@@ -50,11 +57,14 @@ option objc_class_prefix = "GRA";
 // there would be one note for the vulnerability and an occurrence for each
 // image with the vulnerability referring to that note.
 service Grafeas {
+  option (google.api.default_host) = "containeranalysis.googleapis.com";
+
   // Gets the specified occurrence.
   rpc GetOccurrence(GetOccurrenceRequest) returns (Occurrence) {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/occurrences/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists occurrences for the specified project.
@@ -63,6 +73,7 @@ service Grafeas {
     option (google.api.http) = {
       get: "/v1/{parent=projects/*}/occurrences"
     };
+    option (google.api.method_signature) = "parent,filter";
   }
 
   // Deletes the specified occurrence. For example, use this method to delete an
@@ -73,6 +84,7 @@ service Grafeas {
     option (google.api.http) = {
       delete: "/v1/{name=projects/*/occurrences/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates a new occurrence.
@@ -81,6 +93,7 @@ service Grafeas {
       post: "/v1/{parent=projects/*}/occurrences"
       body: "occurrence"
     };
+    option (google.api.method_signature) = "parent,occurrence";
   }
 
   // Creates new occurrences in batch.
@@ -90,6 +103,7 @@ service Grafeas {
       post: "/v1/{parent=projects/*}/occurrences:batchCreate"
       body: "*"
     };
+    option (google.api.method_signature) = "parent,occurrences";
   }
 
   // Updates the specified occurrence.
@@ -98,6 +112,7 @@ service Grafeas {
       patch: "/v1/{name=projects/*/occurrences/*}"
       body: "occurrence"
     };
+    option (google.api.method_signature) = "name,occurrence,update_mask";
   }
 
   // Gets the note attached to the specified occurrence. Consumer projects can
@@ -106,6 +121,7 @@ service Grafeas {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/occurrences/*}/notes"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Gets the specified note.
@@ -113,6 +129,7 @@ service Grafeas {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/notes/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Lists notes for the specified project.
@@ -120,6 +137,7 @@ service Grafeas {
     option (google.api.http) = {
       get: "/v1/{parent=projects/*}/notes"
     };
+    option (google.api.method_signature) = "parent,filter";
   }
 
   // Deletes the specified note.
@@ -127,6 +145,7 @@ service Grafeas {
     option (google.api.http) = {
       delete: "/v1/{name=projects/*/notes/*}"
     };
+    option (google.api.method_signature) = "name";
   }
 
   // Creates a new note.
@@ -135,6 +154,7 @@ service Grafeas {
       post: "/v1/{parent=projects/*}/notes"
       body: "note"
     };
+    option (google.api.method_signature) = "parent,note_id,note";
   }
 
   // Creates new notes in batch.
@@ -144,6 +164,7 @@ service Grafeas {
       post: "/v1/{parent=projects/*}/notes:batchCreate"
       body: "*"
     };
+    option (google.api.method_signature) = "parent,notes";
   }
 
   // Updates the specified note.
@@ -152,6 +173,7 @@ service Grafeas {
       patch: "/v1/{name=projects/*/notes/*}"
       body: "note"
     };
+    option (google.api.method_signature) = "name,note,update_mask";
   }
 
   // Lists occurrences referencing the specified note. Provider projects can use
@@ -162,11 +184,17 @@ service Grafeas {
     option (google.api.http) = {
       get: "/v1/{name=projects/*/notes/*}/occurrences"
     };
+    option (google.api.method_signature) = "name,filter";
   }
 }
 
 // An instance of an analysis type that has been found on a resource.
 message Occurrence {
+  option (google.api.resource) = {
+    type: "grafeas.io/Occurrence"
+    pattern: "projects/{project}/occurrences/{occurrence}"
+  };
+
   // Output only. The name of the occurrence in the form of
   // `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]`.
   string name = 1;
@@ -212,11 +240,18 @@ message Occurrence {
     grafeas.v1.DiscoveryOccurrence discovery = 13;
     // Describes an attestation of an artifact.
     grafeas.v1.AttestationOccurrence attestation = 14;
+    // Describes an available package upgrade on the linked resource.
+    grafeas.v1.UpgradeOccurrence upgrade = 15;
   }
 }
 
 // A type of analysis that can be done for a resource.
 message Note {
+  option (google.api.resource) = {
+    type: "grafeas.io/Note"
+    pattern: "projects/{project}/notes/{note}"
+  };
+
   // Output only. The name of the note in the form of
   // `projects/[PROVIDER_ID]/notes/[NOTE_ID]`.
   string name = 1;
@@ -264,6 +299,8 @@ message Note {
     grafeas.v1.DiscoveryNote discovery = 15;
     // A note describing an attestation role.
     grafeas.v1.AttestationNote attestation = 16;
+    // A note describing available package upgrades.
+    grafeas.v1.UpgradeNote upgrade = 17;
   }
 }
 
@@ -271,14 +308,20 @@ message Note {
 message GetOccurrenceRequest {
   // The name of the occurrence in the form of
   // `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference).type = "grafeas.io/Occurrence"
+  ];
 }
 
 // Request to list occurrences.
 message ListOccurrencesRequest {
   // The name of the project to list occurrences for in the form of
   // `projects/[PROJECT_ID]`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference).type = "grafeas.io/Project"
+  ];
 
   // The filter expression.
   string filter = 2;
@@ -301,29 +344,38 @@ message ListOccurrencesResponse {
   string next_page_token = 2;
 }
 
-// Request to delete a occurrence.
+// Request to delete an occurrence.
 message DeleteOccurrenceRequest {
   // The name of the occurrence in the form of
   // `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference).type = "grafeas.io/Occurrence"
+  ];
 }
 
 // Request to create a new occurrence.
 message CreateOccurrenceRequest {
   // The name of the project in the form of `projects/[PROJECT_ID]`, under which
   // the occurrence is to be created.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference).type = "grafeas.io/Project"
+  ];
   // The occurrence to create.
-  Occurrence occurrence = 2;
+  Occurrence occurrence = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request to update an occurrence.
 message UpdateOccurrenceRequest {
   // The name of the occurrence in the form of
   // `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference).type = "grafeas.io/Occurrence"
+  ];
   // The updated occurrence.
-  Occurrence occurrence = 2;
+  Occurrence occurrence = 2 [(google.api.field_behavior) = REQUIRED];
   // The fields to update.
   google.protobuf.FieldMask update_mask = 3;
 }
@@ -332,21 +384,30 @@ message UpdateOccurrenceRequest {
 message GetNoteRequest {
   // The name of the note in the form of
   // `projects/[PROVIDER_ID]/notes/[NOTE_ID]`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference).type = "grafeas.io/Note"
+  ];
 }
 
 // Request to get the note to which the specified occurrence is attached.
 message GetOccurrenceNoteRequest {
   // The name of the occurrence in the form of
   // `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference).type = "grafeas.io/Occurrence"
+  ];
 }
 
 // Request to list notes.
 message ListNotesRequest {
   // The name of the project to list notes for in the form of
   // `projects/[PROJECT_ID]`.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference).type = "grafeas.io/Project"
+  ];
 
   // The filter expression.
   string filter = 2;
@@ -373,27 +434,36 @@ message ListNotesResponse {
 message DeleteNoteRequest {
   // The name of the note in the form of
   // `projects/[PROVIDER_ID]/notes/[NOTE_ID]`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference).type = "grafeas.io/Note"
+  ];
 }
 
 // Request to create a new note.
 message CreateNoteRequest {
   // The name of the project in the form of `projects/[PROJECT_ID]`, under which
   // the note is to be created.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference).type = "grafeas.io/Project"
+  ];
   // The ID to use for this note.
-  string note_id = 2;
+  string note_id = 2 [(google.api.field_behavior) = REQUIRED];
   // The note to create.
-  Note note = 3;
+  Note note = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request to update a note.
 message UpdateNoteRequest {
   // The name of the note in the form of
   // `projects/[PROVIDER_ID]/notes/[NOTE_ID]`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference).type = "grafeas.io/Note"
+  ];
   // The updated note.
-  Note note = 2;
+  Note note = 2 [(google.api.field_behavior) = REQUIRED];
   // The fields to update.
   google.protobuf.FieldMask update_mask = 3;
 }
@@ -402,7 +472,10 @@ message UpdateNoteRequest {
 message ListNoteOccurrencesRequest {
   // The name of the note to list occurrences for in the form of
   // `projects/[PROVIDER_ID]/notes/[NOTE_ID]`.
-  string name = 1;
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference).type = "grafeas.io/Note"
+  ];
   // The filter expression.
   string filter = 2;
   // Number of occurrences to return in the list.
@@ -423,10 +496,13 @@ message ListNoteOccurrencesResponse {
 message BatchCreateNotesRequest {
   // The name of the project in the form of `projects/[PROJECT_ID]`, under which
   // the notes are to be created.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference).type = "grafeas.io/Project"
+  ];
 
   // The notes to create. Max allowed length is 1000.
-  map notes = 2;
+  map notes = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response for creating notes in batch.
@@ -439,10 +515,13 @@ message BatchCreateNotesResponse {
 message BatchCreateOccurrencesRequest {
   // The name of the project in the form of `projects/[PROJECT_ID]`, under which
   // the occurrences are to be created.
-  string parent = 1;
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference).type = "grafeas.io/Project"
+  ];
 
   // The occurrences to create. Max allowed length is 1000.
-  repeated Occurrence occurrences = 2;
+  repeated Occurrence occurrences = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Response for creating occurrences in batch.
diff --git a/third_party/googleapis/grafeas/v1/grafeas_gapic.legacy.yaml b/third_party/googleapis/grafeas/v1/grafeas_gapic.legacy.yaml
new file mode 100644
index 000000000..af61e33eb
--- /dev/null
+++ b/third_party/googleapis/grafeas/v1/grafeas_gapic.legacy.yaml
@@ -0,0 +1,384 @@
+type: com.google.api.codegen.ConfigProto
+config_schema_version: 1.0.0
+# The settings of generated code in a specific language.
+language_settings:
+  java:
+    package_name: io.grafeas.v1
+  python:
+    package_name: grafeas.grafeas_v1.gapic
+  go:
+    package_name: cloud.google.com/go/grafeas/apiv1
+  csharp:
+    package_name: Grafeas.V1
+  ruby:
+    package_name: Grafeas::V1
+  php:
+    package_name: Grafeas\V1
+  nodejs:
+    package_name: grafeas.v1
+    domain_layer_location: google-cloud
+# A list of resource collection configurations.
+# Consists of a name_pattern and an entity_name.
+# The name_pattern is a pattern to describe the names of the resources of this
+# collection, using the platform's conventions for URI patterns. A generator
+# may use this to generate methods to compose and decompose such names. The
+# pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
+# those will be taken as hints for the parameter names of the generated
+# methods. If empty, no name methods are generated.
+# The entity_name is the name to be used as a basis for generated methods and
+# classes.
+collections:
+- name_pattern: projects/{project}
+  entity_name: project
+- name_pattern: projects/{project}/notes/{note}
+  entity_name: note
+- name_pattern: projects/{project}/occurrences/{occurrence}
+  entity_name: occurrence
+# A list of API interface configurations.
+interfaces:
+# The fully qualified name of the API interface.
+- name: grafeas.v1.Grafeas
+  # Definition for retryable codes.
+  retry_codes_def:
+  - name: idempotent
+    retry_codes:
+    - UNAVAILABLE
+    - DEADLINE_EXCEEDED
+  - name: non_idempotent
+    retry_codes: []
+  # Definition for retry/backoff parameters.
+  retry_params_def:
+  - name: default
+    initial_retry_delay_millis: 100
+    retry_delay_multiplier: 1.3
+    max_retry_delay_millis: 60000
+    initial_rpc_timeout_millis: 20000
+    rpc_timeout_multiplier: 1
+    max_rpc_timeout_millis: 20000
+    total_timeout_millis: 600000
+  # A list of method configurations.
+  # Common properties:
+  #
+  #   name - The simple name of the method.
+  #
+  #   flattening - Specifies the configuration for parameter flattening.
+  #   Describes the parameter groups for which a generator should produce method
+  #   overloads which allow a client to directly pass request message fields as
+  #   method parameters. This information may or may not be used, depending on
+  #   the target language.
+  #   Consists of groups, which each represent a list of parameters to be
+  #   flattened. Each parameter listed must be a field of the request message.
+  #
+  #   required_fields - Fields that are always required for a request to be
+  #   valid.
+  #
+  #   resource_name_treatment - An enum that specifies how to treat the resource
+  #   name formats defined in the field_name_patterns and
+  #   response_field_name_patterns fields.
+  #   UNSET: default value
+  #   NONE: the collection configs will not be used by the generated code.
+  #   VALIDATE: string fields will be validated by the client against the
+  #   specified resource name formats.
+  #   STATIC_TYPES: the client will use generated types for resource names.
+  #
+  #   page_streaming - Specifies the configuration for paging.
+  #   Describes information for generating a method which transforms a paging
+  #   list RPC into a stream of resources.
+  #   Consists of a request and a response.
+  #   The request specifies request information of the list method. It defines
+  #   which fields match the paging pattern in the request. The request consists
+  #   of a page_size_field and a token_field. The page_size_field is the name of
+  #   the optional field specifying the maximum number of elements to be
+  #   returned in the response. The token_field is the name of the field in the
+  #   request containing the page token.
+  #   The response specifies response information of the list method. It defines
+  #   which fields match the paging pattern in the response. The response
+  #   consists of a token_field and a resources_field. The token_field is the
+  #   name of the field in the response containing the next page token. The
+  #   resources_field is the name of the field in the response containing the
+  #   list of resources belonging to the page.
+  #
+  #   retry_codes_name - Specifies the configuration for retryable codes. The
+  #   name must be defined in interfaces.retry_codes_def.
+  #
+  #   retry_params_name - Specifies the configuration for retry/backoff
+  #   parameters. The name must be defined in interfaces.retry_params_def.
+  #
+  #   field_name_patterns - Maps the field name of the request type to
+  #   entity_name of interfaces.collections.
+  #   Specifies the string pattern that the field must follow.
+  #
+  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
+  #   the call is retrying, refer to retry_params_name instead.
+  methods:
+  - name: GetOccurrence
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: occurrence
+    timeout_millis: 30000
+  - name: ListOccurrences
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - filter
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: occurrences
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 30000
+  - name: DeleteOccurrence
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: occurrence
+    timeout_millis: 30000
+  - name: CreateOccurrence
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - occurrence
+    required_fields:
+    - parent
+    - occurrence
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 30000
+  - name: BatchCreateOccurrences
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - occurrences
+    required_fields:
+    - parent
+    - occurrences
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 30000
+  - name: UpdateOccurrence
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - occurrence
+        - update_mask
+    required_fields:
+    - name
+    - occurrence
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: occurrence
+    timeout_millis: 30000
+  - name: GetOccurrenceNote
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: occurrence
+    timeout_millis: 30000
+  - name: GetNote
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: note
+    timeout_millis: 30000
+  - name: ListNotes
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - filter
+    required_fields:
+    - parent
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: notes
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 30000
+  - name: DeleteNote
+    flattening:
+      groups:
+      - parameters:
+        - name
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: note
+    timeout_millis: 30000
+  - name: CreateNote
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - note_id
+        - note
+    required_fields:
+    - parent
+    - note_id
+    - note
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 30000
+  - name: BatchCreateNotes
+    flattening:
+      groups:
+      - parameters:
+        - parent
+        - notes
+    required_fields:
+    - parent
+    - notes
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      parent: project
+    timeout_millis: 30000
+  - name: UpdateNote
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - note
+        - update_mask
+    required_fields:
+    - name
+    - note
+    resource_name_treatment: STATIC_TYPES
+    retry_codes_name: non_idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: note
+    timeout_millis: 30000
+  - name: ListNoteOccurrences
+    flattening:
+      groups:
+      - parameters:
+        - name
+        - filter
+    required_fields:
+    - name
+    resource_name_treatment: STATIC_TYPES
+    page_streaming:
+      request:
+        page_size_field: page_size
+        token_field: page_token
+      response:
+        token_field: next_page_token
+        resources_field: occurrences
+    retry_codes_name: idempotent
+    retry_params_name: default
+    field_name_patterns:
+      name: note
+    timeout_millis: 30000
+resource_name_generation:
+- message_name: grafeas.v1.Occurrence
+  field_entity_map:
+    name: occurrence
+- message_name: grafeas.v1.GetOccurrenceRequest
+  field_entity_map:
+    name: occurrence
+- message_name: grafeas.v1.ListOccurrencesRequest
+  field_entity_map:
+    parent: project
+- message_name: grafeas.v1.DeleteOccurrenceRequest
+  field_entity_map:
+    name: occurrence
+- message_name: grafeas.v1.CreateOccurrenceRequest
+  field_entity_map:
+    parent: project
+- message_name: grafeas.v1.UpdateOccurrenceRequest
+  field_entity_map:
+    name: occurrence
+- message_name: grafeas.v1.BatchCreateOccurrencesRequest
+  field_entity_map:
+    parent: project
+- message_name: grafeas.v1.Note
+  field_entity_map:
+    name: note
+- message_name: grafeas.v1.GetNoteRequest
+  field_entity_map:
+    name: note
+- message_name: grafeas.v1.ListNotesRequest
+  field_entity_map:
+    parent: project
+- message_name: grafeas.v1.DeleteNoteRequest
+  field_entity_map:
+    name: note
+- message_name: grafeas.v1.CreateNoteRequest
+  field_entity_map:
+    parent: project
+- message_name: grafeas.v1.UpdateNoteRequest
+  field_entity_map:
+    name: note
+- message_name: grafeas.v1.BatchCreateNotesRequest
+  field_entity_map:
+    parent: project
+- message_name: grafeas.v1.GetOccurrenceNoteRequest
+  field_entity_map:
+    name: occurrence
+- message_name: grafeas.v1.ListNoteOccurrencesRequest
+  field_entity_map:
+    name: note
diff --git a/third_party/googleapis/grafeas/v1/grafeas_gapic.yaml b/third_party/googleapis/grafeas/v1/grafeas_gapic.yaml
index af61e33eb..9f0f087d8 100644
--- a/third_party/googleapis/grafeas/v1/grafeas_gapic.yaml
+++ b/third_party/googleapis/grafeas/v1/grafeas_gapic.yaml
@@ -1,6 +1,5 @@
 type: com.google.api.codegen.ConfigProto
-config_schema_version: 1.0.0
-# The settings of generated code in a specific language.
+config_schema_version: 2.0.0
 language_settings:
   java:
     package_name: io.grafeas.v1
@@ -17,368 +16,10 @@ language_settings:
   nodejs:
     package_name: grafeas.v1
     domain_layer_location: google-cloud
-# A list of resource collection configurations.
-# Consists of a name_pattern and an entity_name.
-# The name_pattern is a pattern to describe the names of the resources of this
-# collection, using the platform's conventions for URI patterns. A generator
-# may use this to generate methods to compose and decompose such names. The
-# pattern should use named placeholders as in `shelves/{shelf}/books/{book}`;
-# those will be taken as hints for the parameter names of the generated
-# methods. If empty, no name methods are generated.
-# The entity_name is the name to be used as a basis for generated methods and
-# classes.
-collections:
-- name_pattern: projects/{project}
-  entity_name: project
-- name_pattern: projects/{project}/notes/{note}
-  entity_name: note
-- name_pattern: projects/{project}/occurrences/{occurrence}
-  entity_name: occurrence
-# A list of API interface configurations.
 interfaces:
-# The fully qualified name of the API interface.
 - name: grafeas.v1.Grafeas
-  # Definition for retryable codes.
-  retry_codes_def:
-  - name: idempotent
-    retry_codes:
-    - UNAVAILABLE
-    - DEADLINE_EXCEEDED
-  - name: non_idempotent
-    retry_codes: []
-  # Definition for retry/backoff parameters.
-  retry_params_def:
-  - name: default
-    initial_retry_delay_millis: 100
-    retry_delay_multiplier: 1.3
-    max_retry_delay_millis: 60000
-    initial_rpc_timeout_millis: 20000
-    rpc_timeout_multiplier: 1
-    max_rpc_timeout_millis: 20000
-    total_timeout_millis: 600000
-  # A list of method configurations.
-  # Common properties:
-  #
-  #   name - The simple name of the method.
-  #
-  #   flattening - Specifies the configuration for parameter flattening.
-  #   Describes the parameter groups for which a generator should produce method
-  #   overloads which allow a client to directly pass request message fields as
-  #   method parameters. This information may or may not be used, depending on
-  #   the target language.
-  #   Consists of groups, which each represent a list of parameters to be
-  #   flattened. Each parameter listed must be a field of the request message.
-  #
-  #   required_fields - Fields that are always required for a request to be
-  #   valid.
-  #
-  #   resource_name_treatment - An enum that specifies how to treat the resource
-  #   name formats defined in the field_name_patterns and
-  #   response_field_name_patterns fields.
-  #   UNSET: default value
-  #   NONE: the collection configs will not be used by the generated code.
-  #   VALIDATE: string fields will be validated by the client against the
-  #   specified resource name formats.
-  #   STATIC_TYPES: the client will use generated types for resource names.
-  #
-  #   page_streaming - Specifies the configuration for paging.
-  #   Describes information for generating a method which transforms a paging
-  #   list RPC into a stream of resources.
-  #   Consists of a request and a response.
-  #   The request specifies request information of the list method. It defines
-  #   which fields match the paging pattern in the request. The request consists
-  #   of a page_size_field and a token_field. The page_size_field is the name of
-  #   the optional field specifying the maximum number of elements to be
-  #   returned in the response. The token_field is the name of the field in the
-  #   request containing the page token.
-  #   The response specifies response information of the list method. It defines
-  #   which fields match the paging pattern in the response. The response
-  #   consists of a token_field and a resources_field. The token_field is the
-  #   name of the field in the response containing the next page token. The
-  #   resources_field is the name of the field in the response containing the
-  #   list of resources belonging to the page.
-  #
-  #   retry_codes_name - Specifies the configuration for retryable codes. The
-  #   name must be defined in interfaces.retry_codes_def.
-  #
-  #   retry_params_name - Specifies the configuration for retry/backoff
-  #   parameters. The name must be defined in interfaces.retry_params_def.
-  #
-  #   field_name_patterns - Maps the field name of the request type to
-  #   entity_name of interfaces.collections.
-  #   Specifies the string pattern that the field must follow.
-  #
-  #   timeout_millis - Specifies the default timeout for a non-retrying call. If
-  #   the call is retrying, refer to retry_params_name instead.
   methods:
-  - name: GetOccurrence
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: occurrence
-    timeout_millis: 30000
-  - name: ListOccurrences
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - filter
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: occurrences
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: project
-    timeout_millis: 30000
   - name: DeleteOccurrence
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: occurrence
-    timeout_millis: 30000
-  - name: CreateOccurrence
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - occurrence
-    required_fields:
-    - parent
-    - occurrence
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: project
-    timeout_millis: 30000
-  - name: BatchCreateOccurrences
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - occurrences
-    required_fields:
-    - parent
-    - occurrences
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: project
-    timeout_millis: 30000
-  - name: UpdateOccurrence
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - occurrence
-        - update_mask
-    required_fields:
-    - name
-    - occurrence
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: occurrence
-    timeout_millis: 30000
-  - name: GetOccurrenceNote
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: occurrence
-    timeout_millis: 30000
-  - name: GetNote
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: note
-    timeout_millis: 30000
-  - name: ListNotes
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - filter
-    required_fields:
-    - parent
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: notes
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: project
-    timeout_millis: 30000
   - name: DeleteNote
-    flattening:
-      groups:
-      - parameters:
-        - name
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: note
-    timeout_millis: 30000
-  - name: CreateNote
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - note_id
-        - note
-    required_fields:
-    - parent
-    - note_id
-    - note
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: project
-    timeout_millis: 30000
-  - name: BatchCreateNotes
-    flattening:
-      groups:
-      - parameters:
-        - parent
-        - notes
-    required_fields:
-    - parent
-    - notes
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      parent: project
-    timeout_millis: 30000
-  - name: UpdateNote
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - note
-        - update_mask
-    required_fields:
-    - name
-    - note
-    resource_name_treatment: STATIC_TYPES
-    retry_codes_name: non_idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: note
-    timeout_millis: 30000
-  - name: ListNoteOccurrences
-    flattening:
-      groups:
-      - parameters:
-        - name
-        - filter
-    required_fields:
-    - name
-    resource_name_treatment: STATIC_TYPES
-    page_streaming:
-      request:
-        page_size_field: page_size
-        token_field: page_token
-      response:
-        token_field: next_page_token
-        resources_field: occurrences
     retry_codes_name: idempotent
-    retry_params_name: default
-    field_name_patterns:
-      name: note
-    timeout_millis: 30000
-resource_name_generation:
-- message_name: grafeas.v1.Occurrence
-  field_entity_map:
-    name: occurrence
-- message_name: grafeas.v1.GetOccurrenceRequest
-  field_entity_map:
-    name: occurrence
-- message_name: grafeas.v1.ListOccurrencesRequest
-  field_entity_map:
-    parent: project
-- message_name: grafeas.v1.DeleteOccurrenceRequest
-  field_entity_map:
-    name: occurrence
-- message_name: grafeas.v1.CreateOccurrenceRequest
-  field_entity_map:
-    parent: project
-- message_name: grafeas.v1.UpdateOccurrenceRequest
-  field_entity_map:
-    name: occurrence
-- message_name: grafeas.v1.BatchCreateOccurrencesRequest
-  field_entity_map:
-    parent: project
-- message_name: grafeas.v1.Note
-  field_entity_map:
-    name: note
-- message_name: grafeas.v1.GetNoteRequest
-  field_entity_map:
-    name: note
-- message_name: grafeas.v1.ListNotesRequest
-  field_entity_map:
-    parent: project
-- message_name: grafeas.v1.DeleteNoteRequest
-  field_entity_map:
-    name: note
-- message_name: grafeas.v1.CreateNoteRequest
-  field_entity_map:
-    parent: project
-- message_name: grafeas.v1.UpdateNoteRequest
-  field_entity_map:
-    name: note
-- message_name: grafeas.v1.BatchCreateNotesRequest
-  field_entity_map:
-    parent: project
-- message_name: grafeas.v1.GetOccurrenceNoteRequest
-  field_entity_map:
-    name: occurrence
-- message_name: grafeas.v1.ListNoteOccurrencesRequest
-  field_entity_map:
-    name: note
diff --git a/third_party/googleapis/grafeas/v1/grafeas_grpc_service_config.json b/third_party/googleapis/grafeas/v1/grafeas_grpc_service_config.json
new file mode 100755
index 000000000..1e53813bc
--- /dev/null
+++ b/third_party/googleapis/grafeas/v1/grafeas_grpc_service_config.json
@@ -0,0 +1,80 @@
+{
+  "methodConfig": [
+    {
+      "name": [
+        {
+          "service": "grafeas.v1.Grafeas",
+          "method": "GetOccurrence"
+        },
+        {
+          "service": "grafeas.v1.Grafeas",
+          "method": "ListOccurrences"
+        },
+        {
+          "service": "grafeas.v1.Grafeas",
+          "method": "DeleteOccurrence"
+        },
+        {
+          "service": "grafeas.v1.Grafeas",
+          "method": "GetOccurrenceNote"
+        },
+        {
+          "service": "grafeas.v1.Grafeas",
+          "method": "GetNote"
+        },
+        {
+          "service": "grafeas.v1.Grafeas",
+          "method": "ListNotes"
+        },
+        {
+          "service": "grafeas.v1.Grafeas",
+          "method": "DeleteNote"
+        },
+        {
+          "service": "grafeas.v1.Grafeas",
+          "method": "ListNoteOccurrences"
+        }
+      ],
+      "timeout": "30s",
+      "retryPolicy": {
+        "maxAttempts": 5,
+        "initialBackoff": "0.100s",
+        "maxBackoff": "60s",
+        "backoffMultiplier": 1.3,
+        "retryableStatusCodes": [
+          "UNAVAILABLE",
+          "DEADLINE_EXCEEDED"
+        ]
+      }
+    },
+    {
+      "name": [
+        {
+          "service": "grafeas.v1.Grafeas",
+          "method": "CreateOccurrence"
+        },
+        {
+          "service": "grafeas.v1.Grafeas",
+          "method": "BatchCreateOccurrences"
+        },
+        {
+          "service": "grafeas.v1.Grafeas",
+          "method": "UpdateOccurrence"
+        },
+        {
+          "service": "grafeas.v1.Grafeas",
+          "method": "CreateNote"
+        },
+        {
+          "service": "grafeas.v1.Grafeas",
+          "method": "BatchCreateNotes"
+        },
+        {
+          "service": "grafeas.v1.Grafeas",
+          "method": "UpdateNote"
+        }
+      ],
+      "timeout": "30s"
+    }
+  ]
+}
diff --git a/third_party/googleapis/grafeas/v1/upgrade.proto b/third_party/googleapis/grafeas/v1/upgrade.proto
new file mode 100644
index 000000000..89d389299
--- /dev/null
+++ b/third_party/googleapis/grafeas/v1/upgrade.proto
@@ -0,0 +1,114 @@
+// Copyright 2019 The Grafeas Authors. All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package grafeas.v1;
+
+import "google/protobuf/timestamp.proto";
+import "grafeas/v1/package.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/grafeas/v1;grafeas";
+option java_multiple_files = true;
+option java_package = "io.grafeas.v1";
+option objc_class_prefix = "GRA";
+
+// An Upgrade Note represents a potential upgrade of a package to a given
+// version. For each package version combination (i.e. bash 4.0, bash 4.1,
+// bash 4.1.2), there will be an Upgrade Note. For Windows, windows_update field
+// represents the information related to the update.
+message UpgradeNote {
+  // Required for non-Windows OS. The package this Upgrade is for.
+  string package = 1;
+  // Required for non-Windows OS. The version of the package in machine + human
+  // readable form.
+  grafeas.v1.Version version = 2;
+  // Metadata about the upgrade for each specific operating system.
+  repeated UpgradeDistribution distributions = 3;
+  // Required for Windows OS. Represents the metadata about the Windows update.
+  WindowsUpdate windows_update = 4;
+}
+
+// The Upgrade Distribution represents metadata about the Upgrade for each
+// operating system (CPE). Some distributions have additional metadata around
+// updates, classifying them into various categories and severities.
+message UpgradeDistribution {
+  // Required - The specific operating system this metadata applies to. See
+  // https://cpe.mitre.org/specification/.
+  string cpe_uri = 1;
+  // The operating system classification of this Upgrade, as specified by the
+  // upstream operating system upgrade feed. For Windows the classification is
+  // one of the category_ids listed at
+  // https://docs.microsoft.com/en-us/previous-versions/windows/desktop/ff357803(v=vs.85)
+  string classification = 2;
+  // The severity as specified by the upstream operating system.
+  string severity = 3;
+  // The cve tied to this Upgrade.
+  repeated string cve = 4;
+}
+
+// Windows Update represents the metadata about the update for the Windows
+// operating system. The fields in this message come from the Windows Update API
+// documented at
+// https://docs.microsoft.com/en-us/windows/win32/api/wuapi/nn-wuapi-iupdate.
+message WindowsUpdate {
+  // The unique identifier of the update.
+  message Identity {
+    // The revision independent identifier of the update.
+    string update_id = 1;
+    // The revision number of the update.
+    int32 revision = 2;
+  }
+  // Required - The unique identifier for the update.
+  Identity identity = 1;
+  // The localized title of the update.
+  string title = 2;
+  // The localized description of the update.
+  string description = 3;
+  // The category to which the update belongs.
+  message Category {
+    // The identifier of the category.
+    string category_id = 1;
+    // The localized name of the category.
+    string name = 2;
+  }
+  // The list of categories to which the update belongs.
+  repeated Category categories = 4;
+  // The Microsoft Knowledge Base article IDs that are associated with the
+  // update.
+  repeated string kb_article_ids = 5;
+  // The hyperlink to the support information for the update.
+  string support_url = 6;
+  // The last published timestamp of the update.
+  google.protobuf.Timestamp last_published_timestamp = 7;
+}
+
+// An Upgrade Occurrence represents that a specific resource_url could install a
+// specific upgrade. This presence is supplied via local sources (i.e. it is
+// present in the mirror and the running system has noticed its availability).
+// For Windows, both distribution and windows_update contain information for the
+// Windows update.
+message UpgradeOccurrence {
+  // Required for non-Windows OS. The package this Upgrade is for.
+  string package = 1;
+  // Required for non-Windows OS. The version of the package in a machine +
+  // human readable form.
+  grafeas.v1.Version parsed_version = 3;
+  // Metadata about the upgrade for available for the specific operating system
+  // for the resource_url. This allows efficient filtering, as well as
+  // making it easier to use the occurrence.
+  UpgradeDistribution distribution = 4;
+  // Required for Windows OS. Represents the metadata about the Windows update.
+  WindowsUpdate windows_update = 5;
+}
diff --git a/third_party/googleapis/grafeas/v1/vulnerability.proto b/third_party/googleapis/grafeas/v1/vulnerability.proto
index 27a5d238b..6c94cdf05 100644
--- a/third_party/googleapis/grafeas/v1/vulnerability.proto
+++ b/third_party/googleapis/grafeas/v1/vulnerability.proto
@@ -16,6 +16,7 @@ syntax = "proto3";
 
 package grafeas.v1;
 
+import "google/protobuf/timestamp.proto";
 import "grafeas/v1/common.proto";
 import "grafeas/v1/cvss.proto";
 import "grafeas/v1/package.proto";
@@ -109,6 +110,11 @@ message VulnerabilityNote {
     // Whether this detail is obsolete. Occurrences are expected not to point to
     // obsolete details.
     bool is_obsolete = 11;
+
+    // The time this information was last changed at the source. This is an
+    // upstream timestamp from the underlying information source - e.g. Ubuntu
+    // security tracker.
+    google.protobuf.Timestamp source_update_time = 12;
   }
 
   // The full description of the CVSSv3 for this vulnerability.
@@ -145,6 +151,11 @@ message VulnerabilityNote {
       string url = 2;
     }
   }
+
+  // The time this information was last changed at the source. This is an
+  // upstream timestamp from the underlying information source - e.g. Ubuntu
+  // security tracker.
+  google.protobuf.Timestamp source_update_time = 6;
 }
 
 // An occurrence of a severity vulnerability on a resource.
@@ -206,8 +217,7 @@ message VulnerabilityOccurrence {
   repeated grafeas.v1.RelatedUrl related_urls = 7;
 
   // The distro assigned severity for this vulnerability when it is available,
-  // and note provider assigned severity when distro has not yet assigned a
-  // severity for this vulnerability.
+  // otherwise this is the note provider assigned severity.
   Severity effective_severity = 8;
 
   // Output only. Whether at least one of the affected packages has a fix
diff --git a/third_party/googleapis/repository_rules.bzl b/third_party/googleapis/repository_rules.bzl
index e75ea9160..32d461e24 100644
--- a/third_party/googleapis/repository_rules.bzl
+++ b/third_party/googleapis/repository_rules.bzl
@@ -11,7 +11,7 @@ def {rule_name}(**kwargs):
 {rule_name} = {native_rule_name}
 """
     enabled_rule_script = """
-load("{file_label}", _{rule_name} = "{rule_name}")
+load("{file_label}", _{rule_name} = "{loaded_rule_name}")
 """
     elabled_rule_scrip_alias = """
 {rule_name} = _{rule_name}
@@ -19,11 +19,18 @@ load("{file_label}", _{rule_name} = "{rule_name}")
     load_rules = []  # load() must go before everythin else in .bzl files since Bazel 0.25.0
     rules = []
 
-    for rule_name, value in ctx.attr.rules.items():
+    for rule_name, value_and_name in ctx.attr.rules.items():
+        value = value_and_name[0]
+        loaded_rule_name = value_and_name[1] if value_and_name[1] else rule_name
+
         if not value:
             rules.append(disabled_rule_script.format(rule_name = rule_name))
         elif value.startswith("@"):
-            load_rules.append(enabled_rule_script.format(file_label = value, rule_name = rule_name))
+            load_rules.append(enabled_rule_script.format(
+                file_label = value,
+                rule_name = rule_name,
+                loaded_rule_name = loaded_rule_name,
+            ))
             rules.append(elabled_rule_scrip_alias.format(rule_name = rule_name))
         elif value.startswith("native."):
             rules.append(
@@ -38,7 +45,7 @@ load("{file_label}", _{rule_name} = "{rule_name}")
 switched_rules = repository_rule(
     implementation = _switched_rules_impl,
     attrs = {
-        "rules": attr.string_dict(
+        "rules": attr.string_list_dict(
             allow_empty = True,
             mandatory = False,
             default = {},
@@ -92,12 +99,13 @@ def switched_rules_by_language(
             this rule. False by default.
         java (bool): Enable Java specific rules. False by default.
         go (bool): Enable Go specific rules. False by default.
-        cc (bool): Enable C++ specific rules. False by default. Partially implemented.
+        cc (bool): Enable C++ specific rules. False by default. Partially implemented (no GAPIC
+            support).
         php (bool): Enable PHP specific rules. False by default.
         nodejs (bool): Enable Node.js specific rules. False by default.
-        ruby (bool): Enable Ruby specific rules. False by default. Not implemented yet.
-        python (bool): Enable Python-specific rules. False by default. Not implemented yet.
-        csharp (bool): Enable C# specific rules. False by default. Not implemented yet.
+        ruby (bool): Enable Ruby specific rules. False by default.
+        python (bool): Enable Python-specific rules. False by default.
+        csharp (bool): Enable C# specific rules. False by default.
         rules_override (dict): Custom rule overrides (for advanced usage).
     """
 
@@ -110,6 +118,10 @@ def switched_rules_by_language(
         gapic,
         "@com_google_api_codegen//rules_gapic:gapic.bzl",
     )
+    rules["moved_proto_library"] = _switch(
+        gapic,
+        "@com_google_api_codegen//rules_gapic:gapic.bzl",
+    )
 
     #
     # Java
@@ -130,13 +142,43 @@ def switched_rules_by_language(
         java and grpc and gapic,
         "@com_google_api_codegen//rules_gapic/java:java_gapic.bzl",
     )
+    rules["java_gapic_test"] = _switch(
+        java and grpc and gapic,
+        "@com_google_api_codegen//rules_gapic/java:java_gapic.bzl",
+    )
     rules["java_gapic_assembly_gradle_pkg"] = _switch(
         java and grpc and gapic,
         "@com_google_api_codegen//rules_gapic/java:java_gapic_pkg.bzl",
     )
-    rules["java_test"] = _switch(
-        java and grpc and gapic,
-        "native.java_test",
+
+    #
+    # Python
+    #
+    rules["py_proto_library"] = _switch(
+        python,
+        "@com_github_grpc_grpc//bazel:python_rules.bzl",
+    )
+    rules["py_grpc_library"] = _switch(
+        python and grpc,
+        "@com_github_grpc_grpc//bazel:python_rules.bzl",
+    )
+    rules["py_gapic_library"] = _switch(
+        python and grpc and gapic,
+        "@com_google_api_codegen//rules_gapic/python:py_gapic.bzl",
+    )
+    rules["py_gapic_assembly_pkg"] = _switch(
+        python and grpc and gapic,
+        "@com_google_api_codegen//rules_gapic/python:py_gapic_pkg.bzl",
+    )
+    rules["py_gapic_library2"] = _switch(
+        python and grpc and gapic,
+        "@gapic_generator_python//rules_python_gapic:py_gapic.bzl",
+        "py_gapic_library",
+    )
+    rules["py_gapic_assembly_pkg2"] = _switch(
+        python and grpc and gapic,
+        "@gapic_generator_python//rules_python_gapic:py_gapic_pkg.bzl",
+        "py_gapic_assembly_pkg",
     )
 
     #
@@ -156,11 +198,11 @@ def switched_rules_by_language(
     )
     rules["go_gapic_library"] = _switch(
         go and grpc and gapic,
-        "@com_google_api_codegen//rules_gapic/go:go_gapic.bzl",
+        "@com_googleapis_gapic_generator_go//rules_go_gapic:go_gapic.bzl",
     )
     rules["go_gapic_assembly_pkg"] = _switch(
         go and grpc and gapic,
-        "@com_google_api_codegen//rules_gapic/go:go_gapic_pkg.bzl",
+        "@com_googleapis_gapic_generator_go//rules_go_gapic:go_gapic_pkg.bzl",
     )
 
     #
@@ -174,10 +216,7 @@ def switched_rules_by_language(
         cc and grpc,
         "@com_github_grpc_grpc//bazel:cc_grpc_library.bzl",
     )
-    rules["cc_gapic_library"] = _switch(
-        cc and grpc and gapic,
-        "@com_google_gapic_generator_cpp//rules_gapic/cpp:cc_gapic.bzl",
-    )
+    rules["cc_gapic_library"] = _switch(False)
 
     #
     # PHP
@@ -211,6 +250,46 @@ def switched_rules_by_language(
         "@com_google_api_codegen//rules_gapic/nodejs:nodejs_gapic_pkg.bzl",
     )
 
+    #
+    # Ruby
+    #
+    rules["ruby_proto_library"] = _switch(
+        ruby,
+        "@com_google_api_codegen//rules_gapic/ruby:ruby_gapic.bzl",
+    )
+    rules["ruby_grpc_library"] = _switch(
+        ruby and grpc,
+        "@com_google_api_codegen//rules_gapic/ruby:ruby_gapic.bzl",
+    )
+    rules["ruby_gapic_library"] = _switch(
+        ruby and grpc and gapic,
+        "@com_google_api_codegen//rules_gapic/ruby:ruby_gapic.bzl",
+    )
+    rules["ruby_gapic_assembly_pkg"] = _switch(
+        ruby and grpc and gapic,
+        "@com_google_api_codegen//rules_gapic/ruby:ruby_gapic_pkg.bzl",
+    )
+
+    #
+    # C#
+    #
+    rules["csharp_proto_library"] = _switch(
+        csharp,
+        "@com_google_api_codegen//rules_gapic/csharp:csharp_gapic.bzl",
+    )
+    rules["csharp_grpc_library"] = _switch(
+        csharp and grpc,
+        "@com_google_api_codegen//rules_gapic/csharp:csharp_gapic.bzl",
+    )
+    rules["csharp_gapic_library"] = _switch(
+        csharp and grpc and gapic,
+        "@com_google_api_codegen//rules_gapic/csharp:csharp_gapic.bzl",
+    )
+    rules["csharp_gapic_assembly_pkg"] = _switch(
+        csharp and grpc and gapic,
+        "@com_google_api_codegen//rules_gapic/csharp:csharp_gapic_pkg.bzl",
+    )
+
     rules.update(rules_override)
 
     switched_rules(
@@ -218,5 +297,8 @@ def switched_rules_by_language(
         rules = rules,
     )
 
-def _switch(enabled, enabled_value):
-    return enabled_value if enabled else ""
+def _switch(enabled, enabled_value = "", actual_name = ""):
+    if enabled:
+        return [enabled_value, actual_name]
+    else:
+        return ["", actual_name]